import { Link, useSearchParams } from 'react-router'; import { Lock } from 'lucide-react'; import { DEFAULT_SECTION, SECTIONS, isSectionKey, sectionOpen, type SectionKey } from './sections'; import { useReady } from './useReady'; /** * The left column: which part of the fofos site the detail panel is showing. * * ── Selection is in the URL ── * * `?section=…`, per `docs/navigation-audit.md`: what is on screen is addressable, so it survives a * reload, can be linked, and the detail panel reads it directly. The two panels are siblings in a * workspace and never speak to each other. * * ── Real links, not buttons ── * * `AGENTS.md`: "Rows and nav items are real links." `plugins/proxy-manager/web/NavPanel.tsx` uses * buttons calling `setParams`, which keeps the URL correct but gives up anchor semantics — no * cmd-click into a new tab, no middle-click, not link-focusable. That is the older pattern and the * file that documents it says not to copy it. * * `` rather than `` because active state here is a QUERY parameter and NavLink's * `isActive` compares paths — every section would light up at once. So the active class is computed * from the same value the detail panel reads, which is the one place it can come from. * * ── Locked until `useReady` ── * * Until the plugin is ready, the site's sections are not links at all — a `
`, dimmed, with no * href to cmd-click and nothing to focus. Rendering a `` and swallowing the click would leave a * row that looks navigable, offers a URL on hover and opens in a new tab perfectly happily. * * The nav only declines to OFFER the door. `DetailPanel` holds the lock, because a typed URL never * comes through here. */ /** * The nav has a FOOT. * * Everything above it is a part of the client's site, in sitemap order. Below the divider is this * plugin's own machinery, which is not a page and does not belong in a list of them — the same split * the plugins nav makes with Update-all, and the reason it sits at the bottom of the panel rather than * at the bottom of the list. `mt-auto` pins it there whether there are ten sections or two. */ const rowClass = (active: boolean) => `flex w-full items-start gap-2.5 border-b border-border px-3 py-2.5 text-left transition-colors ${ active ? 'bg-muted' : 'hover:bg-muted/50' }`; export const NavPanel = () => { const [params] = useSearchParams(); const raw = params.get('section'); const active: SectionKey = isSectionKey(raw) ? raw : DEFAULT_SECTION; const { ready, rootSet } = useReady(); const renderRow = (section: (typeof SECTIONS)[number]) => { const Icon = section.icon; // Each section asks its own question now — Media wants a root location, the site's pages want a // connection, Administration wants nothing because it is the way out of both. const locked = !sectionOpen(section, { ready, rootSet }); // Everything else in the URL is preserved. This is one screen of a workspace, and the global // query string carries state that belongs to the shell rather than to this panel. const search = new URLSearchParams(params); search.set('section', section.key); /* `media` is Media's own folder, and it goes when you leave. It survived every navigation, so `?section=home&media=GALLERY/CALAVERA+1` was an ordinary URL — a parameter naming a folder in a section that is not open, carried into every link, and shared or bookmarked that way. It is scoped to one section, so it is that section's to keep and nobody else's to inherit. */ if (section.key !== 'media') search.delete('media'); const body = ( <> {section.label} {/* Dimmed and labelled rather than hidden. A nav that shows only what is finished gives no sense of what the thing is for — see sections.ts. */} {!section.built && ( soon )} {section.hint} {locked && } ); if (locked) { return (
{body}
); } return ( {body} ); }; return ( ); };