@flanksource/clicky-ui 0.2.21 → 0.3.2

package/dist/rpc/EntityExplorerApp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.cjs","sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport {\n  findSurfaceListOperation,\n  getClickySurfaces,\n  makeSurfaceDefinition,\n} from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport { OperationEntityPage } from \"./OperationEntityPage\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  // surfaceIcons maps a ClickySurface.parent slug to a ReactNode rendered next\n  // to the group label. Lets the host app drop in brand SVGs (e.g. Xero,\n  // Takealot) without coupling clicky-ui to any specific iconography.\n  surfaceIcons?: Record<string, ReactNode>;\n};\n\n// SURFACE_GROUP_STATE_KEY persists open/closed state of sidebar groups across\n// reloads. Single localStorage entry, not per-user — operator UI only.\nconst SURFACE_GROUP_STATE_KEY = \"clicky-ui:sidebar:groupCollapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  surfaceIcons,\n}: EntityExplorerAppProps) {\n  const { pathname, renderLink, navigate } = useRouter();\n  const { operations, spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const listHrefBySurface = useMemo(() => {\n    const out: Record<string, string> = {};\n    for (const surface of surfaces) {\n      const listOp = findSurfaceListOperation(operations, surface.key);\n      if (!listOp?.operation.operationId) continue;\n      const href = buildCommandHref(basePath, {\n        operation: listOp,\n        request: { command: listOp.operation.operationId, autoRun: true },\n      });\n      if (href) out[surface.key] = href;\n    }\n    return out;\n  }, [basePath, operations, surfaces]);\n  const [collapsedGroups, setCollapsedGroups] = useState<Record<string, boolean>>(() =>\n    readCollapsedGroups(),\n  );\n  const toggleGroup = useCallback((parent: string) => {\n    setCollapsedGroups((prev) => {\n      const next = { ...prev, [parent]: !prev[parent] };\n      writeCollapsedGroups(next);\n      return next;\n    });\n  }, []);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <div className=\"flex h-full\">\n      <aside className=\"flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4\">\n        <div className=\"mb-6\">\n          <div className=\"text-sm font-semibold\">{spec?.info.title ?? \"Clicky Explorer\"}</div>\n          <div className=\"text-xs text-muted-foreground\">Metadata-driven entity explorer</div>\n        </div>\n        <nav className=\"flex flex-col gap-2\">\n          {surfaceGroups.map((group) => {\n            const collapsed = collapsedGroups[group.parent] ?? false;\n            return (\n              <div key={group.parent} className=\"flex flex-col\">\n                <button\n                  type=\"button\"\n                  onClick={() => toggleGroup(group.parent)}\n                  aria-expanded={!collapsed}\n                  className=\"flex items-center gap-2 rounded-md px-2 py-1.5 text-xs font-semibold uppercase tracking-wide text-muted-foreground transition-colors hover:bg-accent/40\"\n                >\n                  {surfaceIcons?.[group.parent] != null && (\n                    <span className=\"flex h-4 w-4 items-center justify-center text-current\">\n                      {surfaceIcons[group.parent]}\n                    </span>\n                  )}\n                  <span className=\"flex-1 text-left\">{group.label}</span>\n                  <span aria-hidden className=\"text-[0.65rem] opacity-60\">\n                    {collapsed ? \"▸\" : \"▾\"}\n                  </span>\n                </button>\n                {!collapsed && (\n                  <div className=\"ml-2 mt-1 flex flex-col gap-1 border-l border-border/60 pl-2\">\n                    {group.surfaces.map((surface) =>\n                      renderLink({\n                        key: surface.key,\n                        to:\n                          listHrefBySurface[surface.key] ??\n                          withBasePath(basePath, `/${surface.key}`),\n                        className: navLinkClassName(\n                          isSurfaceRouteActive(resolvedRoute, surface.key),\n                        ),\n                        children: surface.title,\n                      }),\n                    )}\n                  </div>\n                )}\n              </div>\n            );\n          })}\n          {showApiExplorer &&\n            renderLink({\n              key: explorerDefinition.key,\n              to: withBasePath(basePath, \"/explorer\"),\n              className: navLinkClassName(\n                resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n              ),\n              children: explorerDefinition.title,\n            })}\n        </nav>\n        <div className=\"mt-auto pt-4\">\n          <ThemeSwitcher />\n        </div>\n      </aside>\n\n      <main className=\"flex-1 overflow-auto p-6\">\n        {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n      </main>\n    </div>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction navLinkClassName(active: boolean) {\n  return [\n    \"rounded-md px-2 py-1.5 text-sm transition-colors\",\n    active ? \"bg-accent text-accent-foreground\" : \"text-foreground hover:bg-accent\",\n  ].join(\" \");\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCollapsedGroups(): Record<string, boolean> {\n  if (typeof window === \"undefined\") return {};\n  try {\n    const raw = window.localStorage.getItem(SURFACE_GROUP_STATE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw);\n    return parsed && typeof parsed === \"object\" ? (parsed as Record<string, boolean>) : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction writeCollapsedGroups(state: Record<string, boolean>) {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(SURFACE_GROUP_STATE_KEY, JSON.stringify(state));\n  } catch {\n    // Quota / private-mode failures are safe to swallow — sidebar state is\n    // purely a UX nicety, not a correctness signal.\n  }\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"names":["useRouter","useOperations","useMemo","getClickySurfaces","findSurfaceListOperation","buildCommandHref","useState","useCallback","useEffect","withBasePath","jsxs","jsx","ThemeSwitcher","OperationCatalog","makeSurfaceDefinition","OperationEntityPage","OperationCommandPage","trimTrailingSlash","AUTORUN_QUERY_PARAM","ARG_QUERY_PREFIX"],"mappings":"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"}
+{"version":3,"file":"EntityExplorerApp.cjs","sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useEffect, useMemo, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport { OperationEntityPage } from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { resolveSurfaceIcon } from \"./surfaceIconMap\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  formExtensions,\n  formActions,\n  resultRenderer,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) => ({\n      label: group.label,\n      items: group.surfaces.map((surface) => {\n        const icon = resolveSurfaceIcon(surface.icon);\n        return {\n          key: surface.key,\n          label: surface.title,\n          ...(icon ? { icon } : {}),\n          active: isSurfaceRouteActive(resolvedRoute, surface.key),\n          to: withBasePath(basePath, `/${surface.key}`),\n        };\n      }),\n    }));\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n              {...(formPost ? { formPost } : {})}\n              {...(formActions ? { formActions } : {})}\n              {...(resultRenderer ? { resultRenderer } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n              {...(formPost ? { formPost } : {})}\n              {...(formActions ? { formActions } : {})}\n              {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"names":["useRouter","useOperations","useMemo","getClickySurfaces","buildCommandHref","resolveSurfaceIcon","withBasePath","useEffect","jsx","AppShell","jsxs","ThemeSwitcher","OperationCatalog","makeSurfaceDefinition","OperationEntityPage","OperationCommandPage","trimTrailingSlash","AUTORUN_QUERY_PARAM","ARG_QUERY_PREFIX"],"mappings":"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"}

package/dist/rpc/EntityExplorerApp.d.ts

@@ -1,10 +1,43 @@
 import { ReactNode } from 'react';
+import { PreExtension, PostExtension } from '../components/json-schema-form-types';
+import { ResultRenderer } from './OperationResultView';
+import { FormActionsRenderer } from './SchemaActionForm';
 import { OperationsApiClient } from './useOperations';
 export type EntityExplorerAppProps = {
     client: OperationsApiClient;
     basePath?: string;
     showApiExplorer?: boolean;
+    /**
+     * Custom JsonSchemaForm field extensions applied to every create/edit form the
+     * explorer renders — e.g. a SecretKeySelector widget keyed on an
+     * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`
+     * can replace the rendered value node with a custom component.
+     */
+    formExtensions?: {
+        pre?: PreExtension[];
+        post?: PostExtension[];
+    };
+    /**
+     * Optional extra footer actions added to every create/edit form (e.g. a
+     * connection "Test" split-button). The renderer receives the live form value
+     * and the action it submits to, so it can scope itself to a given entity.
+     */
+    formActions?: FormActionsRenderer;
+    /**
+     * @deprecated Superseded by per-surface icons emitted by the backend
+     * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain
+     * strings, so this group-header icon map is no longer rendered. Kept for
+     * source-compatibility only.
+     */
     surfaceIcons?: Record<string, ReactNode>;
+    /**
+     * Optional host override for the result surface. Called where an entity's
+     * result table renders, with the current surface key, the raw response, and
+     * the default OperationResultView element. Return `defaultView` to keep the
+     * standard table, or a custom node (e.g. a LogsTable for trace/log profiles
+     * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.
+     */
+    resultRenderer?: ResultRenderer;
 };
-export declare function EntityExplorerApp({ client, basePath, showApiExplorer, surfaceIcons, }: EntityExplorerAppProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntityExplorerApp({ client, basePath, showApiExplorer, formExtensions, formActions, resultRenderer, }: EntityExplorerAppProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=EntityExplorerApp.d.ts.map

package/dist/rpc/EntityExplorerApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.d.ts","sourceRoot":"","sources":["../../src/rpc/EntityExplorerApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAoBlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAI1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC1C,CAAC;AAMF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAa,EACb,eAAsB,EACtB,YAAY,GACb,EAAE,sBAAsB,2CA8LxB"}
+{"version":3,"file":"EntityExplorerApp.d.ts","sourceRoot":"","sources":["../../src/rpc/EntityExplorerApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAaxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAClE;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAKF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAa,EACb,eAAsB,EACtB,cAAc,EACd,WAAW,EACX,cAAc,GACf,EAAE,sBAAsB,2CA6JxB"}

package/dist/rpc/EntityExplorerApp.js

@@ -1,47 +1,30 @@
-import { jsxs, jsx } from "react/jsx-runtime";
-import { useMemo, useState, useCallback, useEffect } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo, useEffect } from "react";
 import { ThemeSwitcher } from "../components/theme-switcher.js";
-import { getClickySurfaces, findSurfaceListOperation, makeSurfaceDefinition } from "./clickyMetadata.js";
+import { AppShell } from "../layout/AppShell.js";
+import { getClickySurfaces, makeSurfaceDefinition } from "./clickyMetadata.js";
 import { buildCommandHref, withBasePath, trimTrailingSlash, AUTORUN_QUERY_PARAM, ARG_QUERY_PREFIX } from "./commandHref.js";
 import { useRouter } from "./router.js";
 import { OperationCatalog } from "./OperationCatalog.js";
 import { OperationCommandPage } from "./OperationCommandPage.js";
 import { OperationEntityPage } from "./OperationEntityPage.js";
+import { resolveSurfaceIcon } from "./surfaceIconMap.js";
 import { useOperations } from "./useOperations.js";
-const SURFACE_GROUP_STATE_KEY = "clicky-ui:sidebar:groupCollapsed";
+const SIDEBAR_COLLAPSED_KEY = "clicky-ui:sidebar:collapsed";
 function EntityExplorerApp({
   client,
   basePath = "",
   showApiExplorer = true,
-  surfaceIcons
+  formExtensions,
+  formActions,
+  resultRenderer
 }) {
+  const formPre = formExtensions == null ? void 0 : formExtensions.pre;
+  const formPost = formExtensions == null ? void 0 : formExtensions.post;
   const { pathname, renderLink, navigate } = useRouter();
-  const { operations, spec } = useOperations(client);
+  const { spec } = useOperations(client);
   const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);
   const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);
-  const listHrefBySurface = useMemo(() => {
-    const out = {};
-    for (const surface of surfaces) {
-      const listOp = findSurfaceListOperation(operations, surface.key);
-      if (!(listOp == null ? void 0 : listOp.operation.operationId)) continue;
-      const href = buildCommandHref(basePath, {
-        operation: listOp,
-        request: { command: listOp.operation.operationId, autoRun: true }
-      });
-      if (href) out[surface.key] = href;
-    }
-    return out;
-  }, [basePath, operations, surfaces]);
-  const [collapsedGroups, setCollapsedGroups] = useState(
-    () => readCollapsedGroups()
-  );
-  const toggleGroup = useCallback((parent) => {
-    setCollapsedGroups((prev) => {
-      const next = { ...prev, [parent]: !prev[parent] };
-      writeCollapsedGroups(next);
-      return next;
-    });
-  }, []);
   const defaultSurface = useMemo(
     () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],
     [surfaces]
@@ -73,104 +56,104 @@ function EntityExplorerApp({
     }),
     []
   );
+  const navSections = useMemo(() => {
+    const sections = surfaceGroups.map((group) => ({
+      label: group.label,
+      items: group.surfaces.map((surface) => {
+        const icon = resolveSurfaceIcon(surface.icon);
+        return {
+          key: surface.key,
+          label: surface.title,
+          ...icon ? { icon } : {},
+          active: isSurfaceRouteActive(resolvedRoute, surface.key),
+          to: withBasePath(basePath, `/${surface.key}`)
+        };
+      })
+    }));
+    if (showApiExplorer) {
+      sections.push({
+        items: [
+          {
+            key: explorerDefinition.key,
+            label: explorerDefinition.title,
+            active: resolvedRoute.kind === "explorer" || resolvedRoute.kind === "command",
+            to: withBasePath(basePath, "/explorer")
+          }
+        ]
+      });
+    }
+    return sections;
+  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);
   useEffect(() => {
     if (defaultSurface == null || relativePath !== "/") return;
     navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });
   }, [basePath, defaultSurface, relativePath, navigate]);
-  const content = /* @__PURE__ */ jsxs("div", { className: "flex h-full", children: [
-    /* @__PURE__ */ jsxs("aside", { className: "flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4", children: [
-      /* @__PURE__ */ jsxs("div", { className: "mb-6", children: [
-        /* @__PURE__ */ jsx("div", { className: "text-sm font-semibold", children: (spec == null ? void 0 : spec.info.title) ?? "Clicky Explorer" }),
-        /* @__PURE__ */ jsx("div", { className: "text-xs text-muted-foreground", children: "Metadata-driven entity explorer" })
+  const content = /* @__PURE__ */ jsx(
+    AppShell,
+    {
+      brand: /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+        /* @__PURE__ */ jsx("div", { className: "truncate text-sm font-semibold", children: (spec == null ? void 0 : spec.info.title) ?? "Clicky Explorer" }),
+        /* @__PURE__ */ jsx("div", { className: "truncate text-xs text-sidebar-foreground/60", children: "Metadata-driven entity explorer" })
       ] }),
-      /* @__PURE__ */ jsxs("nav", { className: "flex flex-col gap-2", children: [
-        surfaceGroups.map((group) => {
-          const collapsed = collapsedGroups[group.parent] ?? false;
-          return /* @__PURE__ */ jsxs("div", { className: "flex flex-col", children: [
-            /* @__PURE__ */ jsxs(
-              "button",
-              {
-                type: "button",
-                onClick: () => toggleGroup(group.parent),
-                "aria-expanded": !collapsed,
-                className: "flex items-center gap-2 rounded-md px-2 py-1.5 text-xs font-semibold uppercase tracking-wide text-muted-foreground transition-colors hover:bg-accent/40",
-                children: [
-                  (surfaceIcons == null ? void 0 : surfaceIcons[group.parent]) != null && /* @__PURE__ */ jsx("span", { className: "flex h-4 w-4 items-center justify-center text-current", children: surfaceIcons[group.parent] }),
-                  /* @__PURE__ */ jsx("span", { className: "flex-1 text-left", children: group.label }),
-                  /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "text-[0.65rem] opacity-60", children: collapsed ? "▸" : "▾" })
-                ]
-              }
-            ),
-            !collapsed && /* @__PURE__ */ jsx("div", { className: "ml-2 mt-1 flex flex-col gap-1 border-l border-border/60 pl-2", children: group.surfaces.map(
-              (surface) => renderLink({
-                key: surface.key,
-                to: listHrefBySurface[surface.key] ?? withBasePath(basePath, `/${surface.key}`),
-                className: navLinkClassName(
-                  isSurfaceRouteActive(resolvedRoute, surface.key)
-                ),
-                children: surface.title
-              })
-            ) })
-          ] }, group.parent);
-        }),
-        showApiExplorer && renderLink({
-          key: explorerDefinition.key,
-          to: withBasePath(basePath, "/explorer"),
-          className: navLinkClassName(
-            resolvedRoute.kind === "explorer" || resolvedRoute.kind === "command"
-          ),
-          children: explorerDefinition.title
-        })
-      ] }),
-      /* @__PURE__ */ jsx("div", { className: "mt-auto pt-4", children: /* @__PURE__ */ jsx(ThemeSwitcher, {}) })
-    ] }),
-    /* @__PURE__ */ jsx("main", { className: "flex-1 overflow-auto p-6", children: resolvedRoute.kind === "surface" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
-      OperationCatalog,
-      {
-        definition: makeSurfaceDefinition(resolvedRoute.surface),
-        entities: [resolvedRoute.surface.entity],
-        client,
-        renderLink,
-        surfaceKey: resolvedRoute.surface.key,
-        commandRuntime
-      }
-    ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
-      OperationEntityPage,
-      {
-        definition: makeSurfaceDefinition(resolvedRoute.surface),
-        entities: [resolvedRoute.surface.entity],
-        client,
-        renderLink,
-        surfaceKey: resolvedRoute.surface.key,
-        backHref: withBasePath(basePath, `/${resolvedRoute.surface.key}`),
-        backLabel: `Back to ${resolvedRoute.surface.title}`,
-        commandRuntime,
-        ...resolvedRoute.id ? { id: resolvedRoute.id } : {}
-      }
-    ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "command" ? /* @__PURE__ */ jsx(
-      OperationCommandPage,
-      {
-        client,
-        backHref: withBasePath(basePath, "/explorer"),
-        backLabel: "Back to API Explorer",
-        renderLink,
-        commandRuntime,
-        initialValues: commandInitialValues,
-        autoRun: true,
-        ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
-      }
-    ) : resolvedRoute.kind === "explorer" ? /* @__PURE__ */ jsx(
-      OperationCatalog,
-      {
-        definition: explorerDefinition,
-        entities: [],
-        allOperations: true,
-        client,
-        renderLink,
-        commandRuntime
-      }
-    ) : defaultSurface == null ? /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading surfaces…" }) : /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Redirecting…" }) })
-  ] });
+      navSections,
+      sidebarFooter: /* @__PURE__ */ jsx(ThemeSwitcher, {}),
+      collapsedStorageKey: SIDEBAR_COLLAPSED_KEY,
+      contentClassName: "p-6",
+      children: resolvedRoute.kind === "surface" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
+        OperationCatalog,
+        {
+          definition: makeSurfaceDefinition(resolvedRoute.surface),
+          entities: [resolvedRoute.surface.entity],
+          client,
+          renderLink,
+          surfaceKey: resolvedRoute.surface.key,
+          commandRuntime,
+          ...formPre ? { formPre } : {},
+          ...formPost ? { formPost } : {},
+          ...formActions ? { formActions } : {},
+          ...resultRenderer ? { resultRenderer } : {}
+        }
+      ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(
+        OperationEntityPage,
+        {
+          definition: makeSurfaceDefinition(resolvedRoute.surface),
+          entities: [resolvedRoute.surface.entity],
+          client,
+          renderLink,
+          surfaceKey: resolvedRoute.surface.key,
+          backHref: withBasePath(basePath, `/${resolvedRoute.surface.key}`),
+          backLabel: `Back to ${resolvedRoute.surface.title}`,
+          commandRuntime,
+          ...formPre ? { formPre } : {},
+          ...formPost ? { formPost } : {},
+          ...formActions ? { formActions } : {},
+          ...resolvedRoute.id ? { id: resolvedRoute.id } : {}
+        }
+      ) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "command" ? /* @__PURE__ */ jsx(
+        OperationCommandPage,
+        {
+          client,
+          backHref: withBasePath(basePath, "/explorer"),
+          backLabel: "Back to API Explorer",
+          renderLink,
+          commandRuntime,
+          initialValues: commandInitialValues,
+          autoRun: true,
+          ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
+        }
+      ) : resolvedRoute.kind === "explorer" ? /* @__PURE__ */ jsx(
+        OperationCatalog,
+        {
+          definition: explorerDefinition,
+          entities: [],
+          allOperations: true,
+          client,
+          renderLink,
+          commandRuntime
+        }
+      ) : defaultSurface == null ? /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Loading surfaces…" }) : /* @__PURE__ */ jsx("div", { className: "text-sm text-muted-foreground", children: "Redirecting…" })
+    }
+  );
   return content;
 }
 function parseExplorerRoute(pathname) {
@@ -205,12 +188,6 @@ function resolveRouteSurface(route, surfaces) {
 function isSurfaceRouteActive(route, surfaceKey) {
   return route.kind === "surface" && route.surfaceKey === surfaceKey || route.kind === "entity" && route.surfaceKey === surfaceKey;
 }
-function navLinkClassName(active) {
-  return [
-    "rounded-md px-2 py-1.5 text-sm transition-colors",
-    active ? "bg-accent text-accent-foreground" : "text-foreground hover:bg-accent"
-  ].join(" ");
-}
 function stripBasePath(pathname, basePath) {
   const base = trimTrailingSlash(basePath);
   if (!base || base === "/") {
@@ -252,24 +229,6 @@ function titleCase(value) {
   if (!value) return value;
   return value.charAt(0).toUpperCase() + value.slice(1);
 }
-function readCollapsedGroups() {
-  if (typeof window === "undefined") return {};
-  try {
-    const raw = window.localStorage.getItem(SURFACE_GROUP_STATE_KEY);
-    if (!raw) return {};
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
-    return {};
-  }
-}
-function writeCollapsedGroups(state) {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.setItem(SURFACE_GROUP_STATE_KEY, JSON.stringify(state));
-  } catch {
-  }
-}
 function readCommandQueryParams() {
   if (typeof window === "undefined") {
     return { initialValues: {}, autoRun: false };

package/dist/rpc/EntityExplorerApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.js","sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport {\n  findSurfaceListOperation,\n  getClickySurfaces,\n  makeSurfaceDefinition,\n} from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport { OperationEntityPage } from \"./OperationEntityPage\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  // surfaceIcons maps a ClickySurface.parent slug to a ReactNode rendered next\n  // to the group label. Lets the host app drop in brand SVGs (e.g. Xero,\n  // Takealot) without coupling clicky-ui to any specific iconography.\n  surfaceIcons?: Record<string, ReactNode>;\n};\n\n// SURFACE_GROUP_STATE_KEY persists open/closed state of sidebar groups across\n// reloads. Single localStorage entry, not per-user — operator UI only.\nconst SURFACE_GROUP_STATE_KEY = \"clicky-ui:sidebar:groupCollapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  surfaceIcons,\n}: EntityExplorerAppProps) {\n  const { pathname, renderLink, navigate } = useRouter();\n  const { operations, spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const listHrefBySurface = useMemo(() => {\n    const out: Record<string, string> = {};\n    for (const surface of surfaces) {\n      const listOp = findSurfaceListOperation(operations, surface.key);\n      if (!listOp?.operation.operationId) continue;\n      const href = buildCommandHref(basePath, {\n        operation: listOp,\n        request: { command: listOp.operation.operationId, autoRun: true },\n      });\n      if (href) out[surface.key] = href;\n    }\n    return out;\n  }, [basePath, operations, surfaces]);\n  const [collapsedGroups, setCollapsedGroups] = useState<Record<string, boolean>>(() =>\n    readCollapsedGroups(),\n  );\n  const toggleGroup = useCallback((parent: string) => {\n    setCollapsedGroups((prev) => {\n      const next = { ...prev, [parent]: !prev[parent] };\n      writeCollapsedGroups(next);\n      return next;\n    });\n  }, []);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <div className=\"flex h-full\">\n      <aside className=\"flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4\">\n        <div className=\"mb-6\">\n          <div className=\"text-sm font-semibold\">{spec?.info.title ?? \"Clicky Explorer\"}</div>\n          <div className=\"text-xs text-muted-foreground\">Metadata-driven entity explorer</div>\n        </div>\n        <nav className=\"flex flex-col gap-2\">\n          {surfaceGroups.map((group) => {\n            const collapsed = collapsedGroups[group.parent] ?? false;\n            return (\n              <div key={group.parent} className=\"flex flex-col\">\n                <button\n                  type=\"button\"\n                  onClick={() => toggleGroup(group.parent)}\n                  aria-expanded={!collapsed}\n                  className=\"flex items-center gap-2 rounded-md px-2 py-1.5 text-xs font-semibold uppercase tracking-wide text-muted-foreground transition-colors hover:bg-accent/40\"\n                >\n                  {surfaceIcons?.[group.parent] != null && (\n                    <span className=\"flex h-4 w-4 items-center justify-center text-current\">\n                      {surfaceIcons[group.parent]}\n                    </span>\n                  )}\n                  <span className=\"flex-1 text-left\">{group.label}</span>\n                  <span aria-hidden className=\"text-[0.65rem] opacity-60\">\n                    {collapsed ? \"▸\" : \"▾\"}\n                  </span>\n                </button>\n                {!collapsed && (\n                  <div className=\"ml-2 mt-1 flex flex-col gap-1 border-l border-border/60 pl-2\">\n                    {group.surfaces.map((surface) =>\n                      renderLink({\n                        key: surface.key,\n                        to:\n                          listHrefBySurface[surface.key] ??\n                          withBasePath(basePath, `/${surface.key}`),\n                        className: navLinkClassName(\n                          isSurfaceRouteActive(resolvedRoute, surface.key),\n                        ),\n                        children: surface.title,\n                      }),\n                    )}\n                  </div>\n                )}\n              </div>\n            );\n          })}\n          {showApiExplorer &&\n            renderLink({\n              key: explorerDefinition.key,\n              to: withBasePath(basePath, \"/explorer\"),\n              className: navLinkClassName(\n                resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n              ),\n              children: explorerDefinition.title,\n            })}\n        </nav>\n        <div className=\"mt-auto pt-4\">\n          <ThemeSwitcher />\n        </div>\n      </aside>\n\n      <main className=\"flex-1 overflow-auto p-6\">\n        {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n      </main>\n    </div>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction navLinkClassName(active: boolean) {\n  return [\n    \"rounded-md px-2 py-1.5 text-sm transition-colors\",\n    active ? \"bg-accent text-accent-foreground\" : \"text-foreground hover:bg-accent\",\n  ].join(\" \");\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCollapsedGroups(): Record<string, boolean> {\n  if (typeof window === \"undefined\") return {};\n  try {\n    const raw = window.localStorage.getItem(SURFACE_GROUP_STATE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw);\n    return parsed && typeof parsed === \"object\" ? (parsed as Record<string, boolean>) : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction writeCollapsedGroups(state: Record<string, boolean>) {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(SURFACE_GROUP_STATE_KEY, JSON.stringify(state));\n  } catch {\n    // Quota / private-mode failures are safe to swallow — sidebar state is\n    // purely a UX nicety, not a correctness signal.\n  }\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntityExplorerApp.js","sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useEffect, useMemo, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport { OperationEntityPage } from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { resolveSurfaceIcon } from \"./surfaceIconMap\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  formExtensions,\n  formActions,\n  resultRenderer,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) => ({\n      label: group.label,\n      items: group.surfaces.map((surface) => {\n        const icon = resolveSurfaceIcon(surface.icon);\n        return {\n          key: surface.key,\n          label: surface.title,\n          ...(icon ? { icon } : {}),\n          active: isSurfaceRouteActive(resolvedRoute, surface.key),\n          to: withBasePath(basePath, `/${surface.key}`),\n        };\n      }),\n    }));\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n              {...(formPost ? { formPost } : {})}\n              {...(formActions ? { formActions } : {})}\n              {...(resultRenderer ? { resultRenderer } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n              {...(formPost ? { formPost } : {})}\n              {...(formActions ? { formActions } : {})}\n              {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"names":[],"mappings":"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"}