/* This file is for your main application CSS */

/* ── Sidebar (OpenAgents layout with OpenAgents color tokens) ───────────── */

.sidebar {

/* One rule rather than two kept identical by hand. The previous pair carried a

   comment asserting they matched while they had already drifted on gap and

   padding, so the docs rail sat 12px lower with 8px more between its parts

   than the application rail. A shared selector cannot drift. */

.sidebar,

.docs-sidebar {

  display: flex;

  min-height: 0;

  flex: none;

  flex-direction: column;

  width: 280px;

  height: 100%;

  overflow: hidden;

  /* Identical to .docs-sidebar. Two sidebars in one application that differ by

     a surface rung and a border colour read as two applications. */

  border-right: 1px solid var(--line);

  background: var(--ink-void);

}

  overflow: hidden;

}

.docs-sidebar {

  display: flex;

  width: 280px;

  flex: none;

  flex-direction: column;

  gap: 8px;

  border-right: 1px solid var(--line);

  background: var(--ink-void);

  padding: 12px 0;

}

.docs-sidebar__header {

  display: flex;

  display: flex;

  flex: 1;

  flex-direction: column;

  gap: 2px;

  /* The same rhythm as .sidebar-nav. These two rails differ in exactly one

     way -- this one scrolls -- and nothing else about them should. */

  gap: 1px;

  padding-block: 2px;

  overflow-y: auto;

  overscroll-behavior: none;

}

  def feature_enabled?(%__MODULE__{features: features}, feature),

    do: Map.fetch!(features, feature)

  @doc """

  Whether surfaces built for people working on the application are advertised.

  The component library documents the parts a page is assembled from rather

  than anything a visitor came for, so production does not link to it. This

  hides the link, not the route: `/components` still resolves, because a

  surface that is reachable but unadvertised is honest, while a route that

  disappears between environments is a difference that only shows up in

  production.

  """

  @spec internal_surfaces_visible?() :: boolean()

  def internal_surfaces_visible?, do: internal_surfaces_visible?(current!())

  @spec internal_surfaces_visible?(t()) :: boolean()

  def internal_surfaces_visible?(%__MODULE__{environment: environment}),

    do: environment != :production

  @spec fetch_secret(:openai_api_key) :: {:ok, String.t()} | {:error, :not_configured}

  def fetch_secret(:openai_api_key) do

    case Application.fetch_env(:openagents, :openai_api_key) do

  @doc """

  The secondary links at the foot of a sidebar.

  Every sidebar carries the same two, so a reader who finds the component

  Every sidebar carries the same set, so a reader who finds the component

  library from the application can get back to the docs from either, and does

  not have to remember which shell they are in.

  The component library is advertised outside production only. It documents

  the parts a page is built from rather than anything a visitor came for.

  """

  def sidebar_footer(assigns) do

    assigns =

      assign(assigns, :components_link?, OpenAgents.RuntimeConfig.internal_surfaces_visible?())

    ~H"""

    <footer class="sidebar-footer">

      <.link navigate={~p"/components"} class="sidebar-footer__link">

      <.link :if={@components_link?} navigate={~p"/components"} class="sidebar-footer__link">

        <UI.icon name="widget" /> Components

      </.link>

      <.link navigate={~p"/docs"} class="sidebar-footer__link">

      <div class="docs-header__controls">

        <Layouts.theme_toggle />

        <UI.copy_button

          :if={assigns[:item]}

          id="copy-component-source"

          text={@item.source}

          label="Copy source"

          copied_label="Copied"

        />

      </div>

    </header>

      <div class="docs-header__controls">

        <Layouts.theme_toggle />

        <%!-- The Markdown source, not the URL. A reader copying from a docs

        page is nearly always taking it somewhere that renders Markdown -- an

        issue, a model prompt, a note -- and a link makes them fetch and strip

        the page themselves. --%>

        <UI.copy_button

          :if={assigns[:page]}

          id="copy-docs-link"

          text={"#{OpenAgentsWeb.Endpoint.url()}/docs/#{@page.item.slug}"}

          label="Copy link"

          id="copy-docs-page"

          text={@page.markdown}

          label="Copy page"

          copied_label="Copied"

        />

      </div>

  @doc """

  Read and render one page.

  Returns the rendered HTML and the headings found in it, so a page and its

  table of contents come from one parse rather than two that can disagree.

  Returns the rendered HTML, the headings found in it, and the Markdown source

  it came from, so a page, its table of contents, and the text the copy button

  hands over all come from one read rather than several that can disagree.

  """

  def render(slug) do

    with %{} = item <- fetch(slug),

      toc = headings(markdown)

      html = markdown |> OpenAgents.Markdown.to_html() |> anchor_headings(toc)

      {:ok, %{item: item, html: html, toc: toc}}

      {:ok, %{item: item, html: html, toc: toc, markdown: markdown}}

    else

      _ -> :error

    end

  defp put_endpoint(settings, key, value) do

    Map.update!(settings, OpenAgentsWeb.Endpoint, &Keyword.put(&1, key, value))

  end

  describe "internal_surfaces_visible?/1" do

    test "production does not advertise the component library" do

      refute RuntimeConfig.internal_surfaces_visible?(%RuntimeConfig{

               environment: :production,

               staging_gate: 0,

               features: %{},

               groups: %{}

             })

    end

    test "every other environment does" do

      for environment <- [:development, :test, :staging] do

        assert RuntimeConfig.internal_surfaces_visible?(%RuntimeConfig{

                 environment: environment,

                 staging_gate: 0,

                 features: %{},

                 groups: %{}

               }),

               "expected #{environment} to advertise the component library"

      end

    end

  end

end