@flanksource/clicky-ui 0.2.2 → 0.2.4

package/dist/rpc/EndpointList.cjs

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const MethodBadge = require("../data/MethodBadge.cjs");
+const defaultCommandHref = (operationId) => `/commands/${operationId}`;
+function EndpointList({
+  operations,
+  definition,
+  renderLink,
+  getCommandHref = defaultCommandHref
+}) {
+  const [search, setSearch] = react.useState("");
+  const filtered = react.useMemo(() => {
+    if (!search) return operations;
+    const q = search.toLowerCase();
+    return operations.filter(
+      (op) => {
+        var _a, _b;
+        return op.path.toLowerCase().includes(q) || ((_a = op.operation.summary) == null ? void 0 : _a.toLowerCase().includes(q)) || ((_b = op.operation.operationId) == null ? void 0 : _b.toLowerCase().includes(q));
+      }
+    );
+  }, [operations, search]);
+  if (operations.length === 0) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "rounded-xl border border-dashed p-8", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "text-lg font-medium", children: definition.emptyTitle || `No ${definition.title} endpoints found` }),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mt-2 max-w-2xl text-sm text-muted-foreground", children: definition.emptyDescription || "This area is reserved in the information architecture, but the current OpenAPI surface does not expose matching operations yet." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-4", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        placeholder: `Search ${definition.title.toLowerCase()}...`,
+        value: search,
+        onChange: (e) => setSearch(e.target.value),
+        className: "w-full max-w-lg rounded-lg border bg-background px-3 py-2 text-sm outline-none placeholder:text-muted-foreground focus:ring-2 focus:ring-ring"
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "space-y-2", children: filtered.map((op) => {
+      const operationId = op.operation.operationId ?? `${op.method}:${op.path}`;
+      return renderLink({
+        key: `${op.method}:${op.path}`,
+        to: getCommandHref(operationId, op),
+        className: "flex items-center gap-3 rounded-xl border bg-card p-3 transition-colors hover:border-emerald-200 hover:bg-emerald-50/50",
+        children: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(MethodBadge.MethodBadge, { method: op.method }),
+          /* @__PURE__ */ jsxRuntime.jsx("code", { className: "text-sm", children: op.path }),
+          op.operation.summary && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-auto text-xs text-muted-foreground", children: op.operation.summary })
+        ] })
+      });
+    }) })
+  ] });
+}
+exports.EndpointList = EndpointList;
+//# sourceMappingURL=EndpointList.cjs.map

package/dist/rpc/EndpointList.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointList.cjs","sources":["../../src/rpc/EndpointList.tsx"],"sourcesContent":["import { useMemo, useState, type ReactElement, type ReactNode } from \"react\";\nimport { MethodBadge } from \"../data/MethodBadge\";\nimport type { DomainDefinition, ResolvedOperation } from \"./types\";\n\nexport type RenderLinkArgs = {\n  to: string;\n  className?: string;\n  children: ReactNode;\n  title?: string;\n  key?: string;\n};\n\n// Render-prop form lets callers pass react-router's Link, a plain <a>, or\n// any custom navigation component without relying on React type equality\n// across nested type installs.\nexport type RenderLink = (args: RenderLinkArgs) => ReactElement;\n\nexport type EndpointListProps = {\n  operations: ResolvedOperation[];\n  definition: Pick<DomainDefinition, \"title\" | \"emptyTitle\" | \"emptyDescription\">;\n  renderLink: RenderLink;\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nexport function EndpointList({\n  operations,\n  definition,\n  renderLink,\n  getCommandHref = defaultCommandHref,\n}: EndpointListProps) {\n  const [search, setSearch] = useState(\"\");\n\n  const filtered = useMemo(() => {\n    if (!search) return operations;\n    const q = search.toLowerCase();\n    return operations.filter(\n      (op) =>\n        op.path.toLowerCase().includes(q) ||\n        op.operation.summary?.toLowerCase().includes(q) ||\n        op.operation.operationId?.toLowerCase().includes(q),\n    );\n  }, [operations, search]);\n\n  if (operations.length === 0) {\n    return (\n      <div className=\"rounded-xl border border-dashed p-8\">\n        <h2 className=\"text-lg font-medium\">\n          {definition.emptyTitle || `No ${definition.title} endpoints found`}\n        </h2>\n        <p className=\"mt-2 max-w-2xl text-sm text-muted-foreground\">\n          {definition.emptyDescription ||\n            \"This area is reserved in the information architecture, but the current OpenAPI surface does not expose matching operations yet.\"}\n        </p>\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"space-y-4\">\n      <input\n        placeholder={`Search ${definition.title.toLowerCase()}...`}\n        value={search}\n        onChange={(e) => setSearch(e.target.value)}\n        className=\"w-full max-w-lg rounded-lg border bg-background px-3 py-2 text-sm outline-none placeholder:text-muted-foreground focus:ring-2 focus:ring-ring\"\n      />\n      <div className=\"space-y-2\">\n        {filtered.map((op) => {\n          const operationId = op.operation.operationId ?? `${op.method}:${op.path}`;\n          return renderLink({\n            key: `${op.method}:${op.path}`,\n            to: getCommandHref(operationId, op),\n            className:\n              \"flex items-center gap-3 rounded-xl border bg-card p-3 transition-colors hover:border-emerald-200 hover:bg-emerald-50/50\",\n            children: (\n              <>\n                <MethodBadge method={op.method} />\n                <code className=\"text-sm\">{op.path}</code>\n                {op.operation.summary && (\n                  <span className=\"ml-auto text-xs text-muted-foreground\">\n                    {op.operation.summary}\n                  </span>\n                )}\n              </>\n            ),\n          });\n        })}\n      </div>\n    </div>\n  );\n}\n"],"names":["useState","useMemo","jsxs","jsx","Fragment","MethodBadge"],"mappings":";;;;;AAwBA,MAAM,qBAAqB,CAAC,gBAAwB,aAAa,WAAW;AAErE,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB,GAAsB;AACpB,QAAM,CAAC,QAAQ,SAAS,IAAIA,MAAAA,SAAS,EAAE;AAEvC,QAAM,WAAWC,MAAAA,QAAQ,MAAM;AAC7B,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,IAAI,OAAO,YAAA;AACjB,WAAO,WAAW;AAAA,MAChB,CAAC;;AACC,kBAAG,KAAK,cAAc,SAAS,CAAC,OAChC,QAAG,UAAU,YAAb,mBAAsB,cAAc,SAAS,SAC7C,QAAG,UAAU,gBAAb,mBAA0B,cAAc,SAAS;AAAA;AAAA,IAAC;AAAA,EAExD,GAAG,CAAC,YAAY,MAAM,CAAC;AAEvB,MAAI,WAAW,WAAW,GAAG;AAC3B,WACEC,2BAAAA,KAAC,OAAA,EAAI,WAAU,uCACb,UAAA;AAAA,MAAAC,2BAAAA,IAAC,MAAA,EAAG,WAAU,uBACX,UAAA,WAAW,cAAc,MAAM,WAAW,KAAK,mBAAA,CAClD;AAAA,qCACC,KAAA,EAAE,WAAU,gDACV,UAAA,WAAW,oBACV,kIAAA,CACJ;AAAA,IAAA,GACF;AAAA,EAEJ;AAEA,SACED,2BAAAA,KAAC,OAAA,EAAI,WAAU,aACb,UAAA;AAAA,IAAAC,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC,aAAa,UAAU,WAAW,MAAM,aAAa;AAAA,QACrD,OAAO;AAAA,QACP,UAAU,CAAC,MAAM,UAAU,EAAE,OAAO,KAAK;AAAA,QACzC,WAAU;AAAA,MAAA;AAAA,IAAA;AAAA,mCAEX,OAAA,EAAI,WAAU,aACZ,UAAA,SAAS,IAAI,CAAC,OAAO;AACpB,YAAM,cAAc,GAAG,UAAU,eAAe,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AACvE,aAAO,WAAW;AAAA,QAChB,KAAK,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI;AAAA,QAC5B,IAAI,eAAe,aAAa,EAAE;AAAA,QAClC,WACE;AAAA,QACF,UACED,2BAAAA,KAAAE,qBAAA,EACE,UAAA;AAAA,UAAAD,2BAAAA,IAACE,YAAAA,aAAA,EAAY,QAAQ,GAAG,OAAA,CAAQ;AAAA,UAChCF,2BAAAA,IAAC,QAAA,EAAK,WAAU,WAAW,aAAG,MAAK;AAAA,UAClC,GAAG,UAAU,WACZA,2BAAAA,IAAC,UAAK,WAAU,yCACb,UAAA,GAAG,UAAU,QAAA,CAChB;AAAA,QAAA,EAAA,CAEJ;AAAA,MAAA,CAEH;AAAA,IACH,CAAC,EAAA,CACH;AAAA,EAAA,GACF;AAEJ;;"}

package/dist/rpc/EntityExplorerApp.cjs

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const themeSwitcher = require("../components/theme-switcher.cjs");
+const clickyMetadata = require("./clickyMetadata.cjs");
+const OperationCatalog = require("./OperationCatalog.cjs");
+const OperationCommandPage = require("./OperationCommandPage.cjs");
+const OperationEntityPage = require("./OperationEntityPage.cjs");
+const useOperations = require("./useOperations.cjs");
+const SURFACE_GROUP_STATE_KEY = "clicky-ui:sidebar:groupCollapsed";
+function EntityExplorerApp({
+  client,
+  pathname,
+  renderLink,
+  basePath = "",
+  showApiExplorer = true,
+  surfaceIcons
+}) {
+  const { operations, spec } = useOperations.useOperations(client);
+  const surfaces = react.useMemo(() => clickyMetadata.getClickySurfaces(spec), [spec]);
+  const surfaceGroups = react.useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);
+  const listHrefBySurface = react.useMemo(() => {
+    const out = {};
+    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, {
+        operation: listOp,
+        request: { command: listOp.operation.operationId, autoRun: true }
+      });
+      if (href) out[surface.key] = href;
+    }
+    return out;
+  }, [basePath, operations, surfaces]);
+  const [collapsedGroups, setCollapsedGroups] = react.useState(
+    () => readCollapsedGroups()
+  );
+  const toggleGroup = react.useCallback((parent) => {
+    setCollapsedGroups((prev) => {
+      const next = { ...prev, [parent]: !prev[parent] };
+      writeCollapsedGroups(next);
+      return next;
+    });
+  }, []);
+  const defaultSurface = react.useMemo(
+    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],
+    [surfaces]
+  );
+  const relativePath = react.useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);
+  const route = react.useMemo(() => parseExplorerRoute(relativePath), [relativePath]);
+  const resolvedRoute = react.useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);
+  const commandRuntime = react.useMemo(
+    () => ({
+      client,
+      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"));
+      }
+    }),
+    [basePath, client]
+  );
+  const { initialValues: commandInitialValues, autoRun: commandAutoRun } = react.useMemo(
+    () => resolvedRoute.kind === "command" ? readCommandQueryParams() : { initialValues: {}, autoRun: false },
+    [resolvedRoute.kind, pathname]
+  );
+  const explorerDefinition = react.useMemo(
+    () => ({
+      key: "explorer",
+      title: "API Explorer",
+      description: "Every operation exposed by the current OpenAPI spec."
+    }),
+    []
+  );
+  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: [
+    /* @__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" }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-xs text-muted-foreground", children: "Metadata-driven entity explorer" })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("nav", { className: "flex flex-col gap-2", children: [
+        surfaceGroups.map((group) => {
+          const collapsed = collapsedGroups[group.parent] ?? false;
+          return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col", children: [
+            /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("span", { className: "flex h-4 w-4 items-center justify-center text-current", children: surfaceIcons[group.parent] }),
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-1 text-left", children: group.label }),
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-hidden": true, className: "text-[0.65rem] opacity-60", children: collapsed ? "▸" : "▾" })
+                ]
+              }
+            ),
+            !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}`),
+                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__ */ jsxRuntime.jsx("div", { className: "mt-auto pt-4", children: /* @__PURE__ */ jsxRuntime.jsx(themeSwitcher.ThemeSwitcher, {}) })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("main", { className: "flex-1 overflow-auto p-6", children: resolvedRoute.kind === "surface" ? resolvedRoute.surface ? /* @__PURE__ */ jsxRuntime.jsx(
+      OperationCatalog.OperationCatalog,
+      {
+        definition: clickyMetadata.makeSurfaceDefinition(resolvedRoute.surface),
+        entities: [resolvedRoute.surface.entity],
+        client,
+        renderLink,
+        surfaceKey: resolvedRoute.surface.key,
+        commandRuntime
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ jsxRuntime.jsx(
+      OperationEntityPage.OperationEntityPage,
+      {
+        definition: clickyMetadata.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__ */ jsxRuntime.jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "command" ? /* @__PURE__ */ jsxRuntime.jsx(
+      OperationCommandPage.OperationCommandPage,
+      {
+        client,
+        backHref: withBasePath(basePath, "/explorer"),
+        backLabel: "Back to API Explorer",
+        renderLink,
+        commandRuntime,
+        initialValues: commandInitialValues,
+        autoRun: commandAutoRun,
+        ...resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {}
+      }
+    ) : resolvedRoute.kind === "explorer" ? /* @__PURE__ */ jsxRuntime.jsx(
+      OperationCatalog.OperationCatalog,
+      {
+        definition: explorerDefinition,
+        entities: [],
+        allOperations: true,
+        client,
+        renderLink,
+        commandRuntime
+      }
+    ) : 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…" }) })
+  ] });
+}
+function parseExplorerRoute(pathname) {
+  const normalized = trimTrailingSlash(pathname) || "/";
+  if (normalized === "/") {
+    return { kind: "root" };
+  }
+  const segments = normalized.replace(/^\/+/, "").split("/");
+  if (segments[0] === "explorer") {
+    return { kind: "explorer" };
+  }
+  if (segments[0] === "commands") {
+    return segments[1] ? { kind: "command", operationId: segments[1] } : { kind: "command" };
+  }
+  const surfaceKey = segments[0] ?? "";
+  if (segments[1]) {
+    return {
+      kind: "entity",
+      surfaceKey,
+      id: decodeURIComponent(segments[1])
+    };
+  }
+  return { kind: "surface", surfaceKey };
+}
+function resolveRouteSurface(route, surfaces) {
+  if (route.kind !== "surface" && route.kind !== "entity") {
+    return route;
+  }
+  const surface = surfaces.find((item) => item.key === route.surfaceKey);
+  return surface ? { ...route, surface } : route;
+}
+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 === "/") {
+    return 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 `${base}${pathname}`;
+}
+function trimTrailingSlash(value) {
+  if (!value) return "";
+  return value.length > 1 ? value.replace(/\/+$/, "") : value;
+}
+function UnknownSurface({ surfaceKey }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "p-6 text-sm text-muted-foreground", children: [
+    "Unknown surface: ",
+    /* @__PURE__ */ jsxRuntime.jsx("code", { children: surfaceKey })
+  ] });
+}
+const 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();
+  for (const surface of surfaces) {
+    const parent = surface.parent ?? "";
+    if (!buckets.has(parent)) {
+      buckets.set(parent, []);
+      order.push(parent);
+    }
+    buckets.get(parent).push(surface);
+  }
+  return order.map((parent) => ({
+    parent,
+    label: parent === "" ? "Other" : titleCase(parent),
+    surfaces: buckets.get(parent)
+  }));
+}
+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 };
+  }
+  const search = new URLSearchParams(window.location.search);
+  const initialValues = {};
+  let autoRun = false;
+  const positional = [];
+  for (const [key, value] of search.entries()) {
+    if (key === 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 (Number.isFinite(index) && index >= 0) {
+        positional[index] = value;
+      }
+      continue;
+    }
+    initialValues[key] = value;
+  }
+  const packedArgs = positional.filter((value) => value !== void 0).join(" ");
+  if (packedArgs !== "") {
+    initialValues.args = packedArgs;
+  }
+  return { initialValues, autoRun };
+}
+exports.EntityExplorerApp = EntityExplorerApp;
+//# sourceMappingURL=EntityExplorerApp.cjs.map

package/dist/rpc/EntityExplorerApp.cjs.map

@@ -0,0 +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 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) {\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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"}

package/dist/rpc/EntityExplorerApp.d.ts

@@ -1,4 +1,4 @@
-import { AnyApiReferenceConfiguration } from '@scalar/api-reference-react';
+import { ReactNode } from 'react';
 import { RenderLink } from './EndpointList';
 import { OperationsApiClient } from './useOperations';
 export type EntityExplorerAppProps = {
@@ -7,9 +7,7 @@ export type EntityExplorerAppProps = {
     renderLink: RenderLink;
     basePath?: string;
     showApiExplorer?: boolean;
-    apiExplorerMode?: "scalar" | "operations";
-    apiExplorerUrl?: string;
-    apiExplorerConfiguration?: AnyApiReferenceConfiguration;
+    surfaceIcons?: Record<string, ReactNode>;
 };
-export declare function EntityExplorerApp({ client, pathname, renderLink, basePath, showApiExplorer, apiExplorerMode, apiExplorerUrl, apiExplorerConfiguration, }: EntityExplorerAppProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntityExplorerApp({ client, pathname, renderLink, 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":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAKhF,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;IAC1B,eAAe,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,4BAA4B,CAAC;CACzD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAa,EACb,eAAsB,EACtB,eAA0B,EAC1B,cAAc,EACd,wBAAwB,GACzB,EAAE,sBAAsB,2CAsJxB"}
+{"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"}