@flanksource/clicky-ui 0.2.19 → 0.2.20

package/dist/rpc/EntityExplorerApp.cjs

@@ -4,6 +4,8 @@ const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
 const themeSwitcher = require("../components/theme-switcher.cjs");
 const clickyMetadata = require("./clickyMetadata.cjs");
+const commandHref = require("./commandHref.cjs");
+const router = require("./router.cjs");
 const OperationCatalog = require("./OperationCatalog.cjs");
 const OperationCommandPage = require("./OperationCommandPage.cjs");
 const OperationEntityPage = require("./OperationEntityPage.cjs");
@@ -11,12 +13,11 @@ const useOperations = require("./useOperations.cjs");
 const SURFACE_GROUP_STATE_KEY = "clicky-ui:sidebar:groupCollapsed";
 function EntityExplorerApp({
   client,
-  pathname,
-  renderLink,
   basePath = "",
   showApiExplorer = true,
   surfaceIcons
 }) {
+  const { pathname, renderLink, navigate } = router.useRouter();
   const { operations, spec } = useOperations.useOperations(client);
   const surfaces = react.useMemo(() => clickyMetadata.getClickySurfaces(spec), [spec]);
   const surfaceGroups = react.useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);
@@ -25,7 +26,7 @@ function EntityExplorerApp({
     for (const surface of surfaces) {
       const listOp = clickyMetadata.findSurfaceListOperation(operations, surface.key);
       if (!(listOp == null ? void 0 : listOp.operation.operationId)) continue;
-      const href = buildCommandHref(basePath, {
+      const href = commandHref.buildCommandHref(basePath, {
         operation: listOp,
         request: { command: listOp.operation.operationId, autoRun: true }
       });
@@ -53,17 +54,16 @@ function EntityExplorerApp({
   const commandRuntime = react.useMemo(
     () => ({
       client,
-      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),
+      hrefForCommand: (resolved) => commandHref.buildCommandHref(basePath, resolved),
       onNavigate: (resolved) => {
-        const href = buildCommandHref(basePath, resolved);
-        if (!href || typeof window === "undefined") return;
-        window.history.pushState(window.history.state, "", href);
-        window.dispatchEvent(new PopStateEvent("popstate"));
+        const href = commandHref.buildCommandHref(basePath, resolved);
+        if (!href) return;
+        navigate(href);
       }
     }),
-    [basePath, client]
+    [basePath, client, navigate]
   );
-  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = react.useMemo(
+  const { initialValues: commandInitialValues } = react.useMemo(
     () => resolvedRoute.kind === "command" ? readCommandQueryParams() : { initialValues: {}, autoRun: false },
     [resolvedRoute.kind, pathname]
   );
@@ -76,14 +76,10 @@ function EntityExplorerApp({
     []
   );
   react.useEffect(() => {
-    if (typeof window === "undefined" || defaultSurface == null || relativePath !== "/" || window.location.pathname !== withBasePath(basePath, "/")) {
-      return;
-    }
-    const target = withBasePath(basePath, `/${defaultSurface.key}`);
-    window.history.replaceState(window.history.state, "", target);
-    window.dispatchEvent(new PopStateEvent("popstate"));
-  }, [basePath, defaultSurface, relativePath]);
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex h-full", children: [
+    if (defaultSurface == null || relativePath !== "/") return;
+    navigate(commandHref.withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });
+  }, [basePath, defaultSurface, relativePath, navigate]);
+  const content = /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex h-full", children: [
     /* @__PURE__ */ jsxRuntime.jsxs("aside", { className: "flex w-64 shrink-0 flex-col border-r border-border bg-muted/30 p-4", children: [
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-6", children: [
         /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm font-semibold", children: (spec == null ? void 0 : spec.info.title) ?? "Clicky Explorer" }),
@@ -110,7 +106,7 @@ function EntityExplorerApp({
             !collapsed && /* @__PURE__ */ jsxRuntime.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}`),
+                to: listHrefBySurface[surface.key] ?? commandHref.withBasePath(basePath, `/${surface.key}`),
                 className: navLinkClassName(
                   isSurfaceRouteActive(resolvedRoute, surface.key)
                 ),
@@ -121,7 +117,7 @@ function EntityExplorerApp({
         }),
         showApiExplorer && renderLink({
           key: explorerDefinition.key,
-          to: withBasePath(basePath, "/explorer"),
+          to: commandHref.withBasePath(basePath, "/explorer"),
           className: navLinkClassName(
             resolvedRoute.kind === "explorer" || resolvedRoute.kind === "command"
           ),
@@ -148,7 +144,7 @@ function EntityExplorerApp({
         client,
         renderLink,
         surfaceKey: resolvedRoute.surface.key,
-        backHref: withBasePath(basePath, `/${resolvedRoute.surface.key}`),
+        backHref: commandHref.withBasePath(basePath, `/${resolvedRoute.surface.key}`),
         backLabel: `Back to ${resolvedRoute.surface.title}`,
         commandRuntime,
         ...resolvedRoute.id ? { id: resolvedRoute.id } : {}
@@ -157,12 +153,12 @@ function EntityExplorerApp({
       OperationCommandPage.OperationCommandPage,
       {
         client,
-        backHref: withBasePath(basePath, "/explorer"),
+        backHref: commandHref.withBasePath(basePath, "/explorer"),
         backLabel: "Back to API Explorer",
         renderLink,
         commandRuntime,
         initialValues: commandInitialValues,
-        autoRun: commandAutoRun,
+        autoRun: true,
         ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
       }
     ) : resolvedRoute.kind === "explorer" ? /* @__PURE__ */ jsxRuntime.jsx(
@@ -177,9 +173,10 @@ function EntityExplorerApp({
       }
     ) : defaultSurface == null ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm text-muted-foreground", children: "Loading surfaces…" }) : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-sm text-muted-foreground", children: "Redirecting…" }) })
   ] });
+  return content;
 }
 function parseExplorerRoute(pathname) {
-  const normalized = trimTrailingSlash(pathname) || "/";
+  const normalized = commandHref.trimTrailingSlash(pathname) || "/";
   if (normalized === "/") {
     return { kind: "root" };
   }
@@ -217,28 +214,17 @@ function navLinkClassName(active) {
   ].join(" ");
 }
 function stripBasePath(pathname, basePath) {
-  const base = trimTrailingSlash(basePath);
+  const base = commandHref.trimTrailingSlash(basePath);
   if (!base || base === "/") {
-    return trimTrailingSlash(pathname) || "/";
+    return commandHref.trimTrailingSlash(pathname) || "/";
   }
   if (pathname === base) {
     return "/";
   }
   if (pathname.startsWith(`${base}/`)) {
-    return trimTrailingSlash(pathname.slice(base.length)) || "/";
-  }
-  return trimTrailingSlash(pathname) || "/";
-}
-function withBasePath(basePath, pathname) {
-  const base = trimTrailingSlash(basePath);
-  if (!base || base === "/") {
-    return pathname;
+    return commandHref.trimTrailingSlash(pathname.slice(base.length)) || "/";
   }
-  return `${base}${pathname}`;
-}
-function trimTrailingSlash(value) {
-  if (!value) return "";
-  return value.length > 1 ? value.replace(/\/+$/, "") : value;
+  return commandHref.trimTrailingSlash(pathname) || "/";
 }
 function UnknownSurface({ surfaceKey }) {
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-6 text-sm text-muted-foreground", children: [
@@ -246,48 +232,7 @@ function UnknownSurface({ surfaceKey }) {
     /* @__PURE__ */ jsxRuntime.jsx("code", { children: surfaceKey })
   ] });
 }
-const AUTORUN_QUERY_PARAM = "autoRun";
 const LEGACY_AUTORUN_QUERY_PARAM = "__autoRun";
-const ARG_QUERY_PREFIX = "__arg";
-function buildCommandHref(basePath, resolved) {
-  var _a, _b;
-  const commandId = ((_a = resolved.operation) == null ? void 0 : _a.operation.operationId) ?? resolved.request.command;
-  if (!commandId) return void 0;
-  const meta = (_b = resolved.operation) == null ? void 0 : _b.operation["x-clicky"];
-  const args = resolved.request.args ?? [];
-  const flags = resolved.request.flags ?? {};
-  if ((meta == null ? void 0 : meta.verb) === "get" && (meta == null ? void 0 : meta.scope) === "entity" && meta.surface && args[0]) {
-    const search2 = new URLSearchParams();
-    for (const [key, value] of Object.entries(flags)) {
-      if (value !== void 0 && value !== "") {
-        search2.set(key, value);
-      }
-    }
-    const query2 = search2.toString();
-    const suffix2 = query2 ? `?${query2}` : "";
-    return withBasePath(
-      basePath,
-      `/${encodeURIComponent(meta.surface)}/${encodeURIComponent(args[0])}${suffix2}`
-    );
-  }
-  const search = new URLSearchParams();
-  args.forEach((value, index) => {
-    if (value !== void 0 && value !== "") {
-      search.set(`${ARG_QUERY_PREFIX}${index}`, value);
-    }
-  });
-  for (const [key, value] of Object.entries(flags)) {
-    if (value !== void 0 && value !== "") {
-      search.set(key, value);
-    }
-  }
-  if (resolved.request.autoRun) {
-    search.set(AUTORUN_QUERY_PARAM, "1");
-  }
-  const query = search.toString();
-  const suffix = query ? `?${query}` : "";
-  return withBasePath(basePath, `/commands/${encodeURIComponent(commandId)}${suffix}`);
-}
 function groupSurfacesByParent(surfaces) {
   const order = [];
   const buckets = /* @__PURE__ */ new Map();
@@ -336,12 +281,12 @@ function readCommandQueryParams() {
   let autoRun = false;
   const positional = [];
   for (const [key, value] of search.entries()) {
-    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {
+    if (key === commandHref.AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {
       autoRun = value === "1" || value === "true";
       continue;
     }
-    if (key.startsWith(ARG_QUERY_PREFIX)) {
-      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);
+    if (key.startsWith(commandHref.ARG_QUERY_PREFIX)) {
+      const index = Number.parseInt(key.slice(commandHref.ARG_QUERY_PREFIX.length), 10);
       if (Number.isFinite(index) && index >= 0) {
         positional[index] = value;
       }

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, ClickyResolvedCommand } from \"../data/Clicky\";\nimport {\n  findSurfaceListOperation,\n  getClickySurfaces,\n  makeSurfaceDefinition,\n} from \"./clickyMetadata\";\nimport type { RenderLink } from \"./EndpointList\";\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  pathname: string;\n  renderLink: RenderLink;\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  pathname,\n  renderLink,\n  basePath = \"\",\n  showApiExplorer = true,\n  surfaceIcons,\n}: EntityExplorerAppProps) {\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 || typeof window === \"undefined\") return;\n        window.history.pushState(window.history.state, \"\", href);\n        window.dispatchEvent(new PopStateEvent(\"popstate\"));\n      },\n    }),\n    [basePath, client],\n  );\n  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = 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 (\n      typeof window === \"undefined\" ||\n      defaultSurface == null ||\n      relativePath !== \"/\" ||\n      window.location.pathname !== withBasePath(basePath, \"/\")\n    ) {\n      return;\n    }\n\n    const target = withBasePath(basePath, `/${defaultSurface.key}`);\n    window.history.replaceState(window.history.state, \"\", target);\n    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n  }, [basePath, defaultSurface, relativePath]);\n\n  return (\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={commandAutoRun}\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\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 withBasePath(basePath: string, pathname: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return pathname;\n  }\n  return `${base}${pathname}`;\n}\n\nfunction trimTrailingSlash(value: string) {\n  if (!value) return \"\";\n  return value.length > 1 ? value.replace(/\\/+$/, \"\") : value;\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 AUTORUN_QUERY_PARAM = \"autoRun\";\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\nconst ARG_QUERY_PREFIX = \"__arg\";\n\nfunction buildCommandHref(basePath: string, resolved: ClickyResolvedCommand): string | undefined {\n  const commandId = resolved.operation?.operation.operationId ?? resolved.request.command;\n  if (!commandId) return undefined;\n\n  const meta = resolved.operation?.operation[\"x-clicky\"];\n  const args = resolved.request.args ?? [];\n  const flags = resolved.request.flags ?? {};\n\n  // Entity `get` commands route to the surface detail URL: /<surface>/<id>?<flags>\n  if (meta?.verb === \"get\" && meta?.scope === \"entity\" && meta.surface && args[0]) {\n    const search = new URLSearchParams();\n    for (const [key, value] of Object.entries(flags)) {\n      if (value !== undefined && value !== \"\") {\n        search.set(key, value);\n      }\n    }\n    const query = search.toString();\n    const suffix = query ? `?${query}` : \"\";\n    return withBasePath(\n      basePath,\n      `/${encodeURIComponent(meta.surface)}/${encodeURIComponent(args[0])}${suffix}`,\n    );\n  }\n\n  const search = new URLSearchParams();\n  args.forEach((value, index) => {\n    if (value !== undefined && value !== \"\") {\n      search.set(`${ARG_QUERY_PREFIX}${index}`, value);\n    }\n  });\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined && value !== \"\") {\n      search.set(key, value);\n    }\n  }\n  if (resolved.request.autoRun) {\n    search.set(AUTORUN_QUERY_PARAM, \"1\");\n  }\n\n  const query = search.toString();\n  const suffix = query ? `?${query}` : \"\";\n  return withBasePath(basePath, `/commands/${encodeURIComponent(commandId)}${suffix}`);\n}\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":["useOperations","useMemo","getClickySurfaces","findSurfaceListOperation","useState","useCallback","useEffect","jsxs","jsx","ThemeSwitcher","OperationCatalog","makeSurfaceDefinition","OperationEntityPage","OperationCommandPage","search","query","suffix"],"mappings":"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"}
+{"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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"}

package/dist/rpc/EntityExplorerApp.d.ts

@@ -1,13 +1,10 @@
 import { ReactNode } from 'react';
-import { RenderLink } from './EndpointList';
 import { OperationsApiClient } from './useOperations';
 export type EntityExplorerAppProps = {
     client: OperationsApiClient;
-    pathname: string;
-    renderLink: RenderLink;
     basePath?: string;
     showApiExplorer?: boolean;
     surfaceIcons?: Record<string, ReactNode>;
 };
-export declare function EntityExplorerApp({ client, pathname, renderLink, basePath, showApiExplorer, surfaceIcons, }: EntityExplorerAppProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntityExplorerApp({ client, basePath, showApiExplorer, surfaceIcons, }: 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;AAQlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,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,QAAQ,EACR,UAAU,EACV,QAAa,EACb,eAAsB,EACtB,YAAY,GACb,EAAE,sBAAsB,2CAsMxB"}
+{"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"}

package/dist/rpc/EntityExplorerApp.js

@@ -2,6 +2,8 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import { useMemo, useState, useCallback, useEffect } from "react";
 import { ThemeSwitcher } from "../components/theme-switcher.js";
 import { getClickySurfaces, findSurfaceListOperation, 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";
@@ -9,12 +11,11 @@ import { useOperations } from "./useOperations.js";
 const SURFACE_GROUP_STATE_KEY = "clicky-ui:sidebar:groupCollapsed";
 function EntityExplorerApp({
   client,
-  pathname,
-  renderLink,
   basePath = "",
   showApiExplorer = true,
   surfaceIcons
 }) {
+  const { pathname, renderLink, navigate } = useRouter();
   const { operations, spec } = useOperations(client);
   const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);
   const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);
@@ -54,14 +55,13 @@ function EntityExplorerApp({
       hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),
       onNavigate: (resolved) => {
         const href = buildCommandHref(basePath, resolved);
-        if (!href || typeof window === "undefined") return;
-        window.history.pushState(window.history.state, "", href);
-        window.dispatchEvent(new PopStateEvent("popstate"));
+        if (!href) return;
+        navigate(href);
       }
     }),
-    [basePath, client]
+    [basePath, client, navigate]
   );
-  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = useMemo(
+  const { initialValues: commandInitialValues } = useMemo(
     () => resolvedRoute.kind === "command" ? readCommandQueryParams() : { initialValues: {}, autoRun: false },
     [resolvedRoute.kind, pathname]
   );
@@ -74,14 +74,10 @@ function EntityExplorerApp({
     []
   );
   useEffect(() => {
-    if (typeof window === "undefined" || defaultSurface == null || relativePath !== "/" || window.location.pathname !== withBasePath(basePath, "/")) {
-      return;
-    }
-    const target = withBasePath(basePath, `/${defaultSurface.key}`);
-    window.history.replaceState(window.history.state, "", target);
-    window.dispatchEvent(new PopStateEvent("popstate"));
-  }, [basePath, defaultSurface, relativePath]);
-  return /* @__PURE__ */ jsxs("div", { className: "flex h-full", children: [
+    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" }),
@@ -160,7 +156,7 @@ function EntityExplorerApp({
         renderLink,
         commandRuntime,
         initialValues: commandInitialValues,
-        autoRun: commandAutoRun,
+        autoRun: true,
         ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
       }
     ) : resolvedRoute.kind === "explorer" ? /* @__PURE__ */ jsx(
@@ -175,6 +171,7 @@ function EntityExplorerApp({
       }
     ) : 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) {
   const normalized = trimTrailingSlash(pathname) || "/";
@@ -227,65 +224,13 @@ function stripBasePath(pathname, basePath) {
   }
   return trimTrailingSlash(pathname) || "/";
 }
-function withBasePath(basePath, pathname) {
-  const base = trimTrailingSlash(basePath);
-  if (!base || base === "/") {
-    return pathname;
-  }
-  return `${base}${pathname}`;
-}
-function trimTrailingSlash(value) {
-  if (!value) return "";
-  return value.length > 1 ? value.replace(/\/+$/, "") : value;
-}
 function UnknownSurface({ surfaceKey }) {
   return /* @__PURE__ */ jsxs("div", { className: "p-6 text-sm text-muted-foreground", children: [
     "Unknown surface: ",
     /* @__PURE__ */ jsx("code", { children: surfaceKey })
   ] });
 }
-const AUTORUN_QUERY_PARAM = "autoRun";
 const LEGACY_AUTORUN_QUERY_PARAM = "__autoRun";
-const ARG_QUERY_PREFIX = "__arg";
-function buildCommandHref(basePath, resolved) {
-  var _a, _b;
-  const commandId = ((_a = resolved.operation) == null ? void 0 : _a.operation.operationId) ?? resolved.request.command;
-  if (!commandId) return void 0;
-  const meta = (_b = resolved.operation) == null ? void 0 : _b.operation["x-clicky"];
-  const args = resolved.request.args ?? [];
-  const flags = resolved.request.flags ?? {};
-  if ((meta == null ? void 0 : meta.verb) === "get" && (meta == null ? void 0 : meta.scope) === "entity" && meta.surface && args[0]) {
-    const search2 = new URLSearchParams();
-    for (const [key, value] of Object.entries(flags)) {
-      if (value !== void 0 && value !== "") {
-        search2.set(key, value);
-      }
-    }
-    const query2 = search2.toString();
-    const suffix2 = query2 ? `?${query2}` : "";
-    return withBasePath(
-      basePath,
-      `/${encodeURIComponent(meta.surface)}/${encodeURIComponent(args[0])}${suffix2}`
-    );
-  }
-  const search = new URLSearchParams();
-  args.forEach((value, index) => {
-    if (value !== void 0 && value !== "") {
-      search.set(`${ARG_QUERY_PREFIX}${index}`, value);
-    }
-  });
-  for (const [key, value] of Object.entries(flags)) {
-    if (value !== void 0 && value !== "") {
-      search.set(key, value);
-    }
-  }
-  if (resolved.request.autoRun) {
-    search.set(AUTORUN_QUERY_PARAM, "1");
-  }
-  const query = search.toString();
-  const suffix = query ? `?${query}` : "";
-  return withBasePath(basePath, `/commands/${encodeURIComponent(commandId)}${suffix}`);
-}
 function groupSurfacesByParent(surfaces) {
   const order = [];
   const buckets = /* @__PURE__ */ new Map();