@flanksource/clicky-ui 0.3.14 → 0.3.16

package/dist/rpc/OperationCatalog.js

@@ -1,5 +1,6 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import { useState, useMemo, useEffect } from "react";
+import { createPortal } from "react-dom";
 import { useQuery, keepPreviousData } from "@tanstack/react-query";
 import { Button } from "../components/button.js";
 import { Icon } from "../data/Icon.js";
@@ -31,13 +32,14 @@ function OperationCatalog({
   filterPre,
   getCommandHref = defaultCommandHref,
   renderError = defaultRenderError,
-  kind,
   commandRuntime,
   formPre,
   formPost,
   formActions,
   actionLabels,
-  resultRenderer
+  resultRenderer,
+  actionsContainer,
+  viewToggleContainer
 }) {
   const { operations, isLoading } = useOperations(client);
   const [view, setView] = useState("table");
@@ -145,7 +147,6 @@ function OperationCatalog({
   );
   const hasTable = !!listEndpoint;
   const showTable = hasTable && view === "table";
-  const sectionLabel = kind === "configuration" || definition.key.startsWith("config-") ? "Configuration" : "Operations";
   function getActionLockedValues(op) {
     const meta = getOperationClickyMeta(op);
     if (meta == null || !meta.supportsFilterMode) {
@@ -173,61 +174,57 @@ function OperationCatalog({
       Array.from({ length: 5 }).map((_, i) => /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-12" }, i))
     ] });
   }
+  const viewToggle = hasTable ? /* @__PURE__ */ jsxs("div", { "data-slot": "operation-catalog-view-toggle", className: "flex gap-1 rounded-lg border p-1", children: [
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        type: "button",
+        variant: view === "table" ? "secondary" : "ghost",
+        size: "sm",
+        className: "h-7 w-7 p-0",
+        "aria-label": "Table view",
+        "aria-pressed": view === "table",
+        onClick: () => setView("table"),
+        children: /* @__PURE__ */ jsx(Icon, { icon: UiTable })
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        type: "button",
+        variant: view === "endpoints" ? "secondary" : "ghost",
+        size: "sm",
+        className: "h-7 w-7 p-0",
+        "aria-label": "Endpoint list view",
+        "aria-pressed": view === "endpoints",
+        onClick: () => setView("endpoints"),
+        children: /* @__PURE__ */ jsx(Icon, { icon: UiListFlat })
+      }
+    )
+  ] }) : null;
+  const actionBar = /* @__PURE__ */ jsx(
+    OperationActionBar,
+    {
+      actions: actionOps,
+      client,
+      getLockedValues: getActionLockedValues,
+      onExecuted: () => void listQuery.refetch(),
+      ...commandRuntime ? { commandRuntime } : {},
+      ...formPre ? { formPre } : {},
+      ...formPost ? { formPost } : {},
+      ...formActions ? { formActions } : {},
+      ...actionLabels ? { actionLabels } : {}
+    }
+  );
   return /* @__PURE__ */ jsxs(
     "div",
     {
       className: "flex h-full min-h-0 flex-col gap-6",
       "data-slot": "operation-catalog",
       children: [
-        /* @__PURE__ */ jsxs("div", { className: "flex items-start justify-between gap-4", children: [
-          /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
-            /* @__PURE__ */ jsx("p", { className: "text-xs uppercase tracking-[0.18em] text-muted-foreground", children: sectionLabel }),
-            /* @__PURE__ */ jsx("h1", { className: "text-2xl font-semibold tracking-tight", children: definition.title }),
-            /* @__PURE__ */ jsx("p", { className: "mt-1 max-w-2xl text-sm text-muted-foreground", children: definition.description })
-          ] }),
-          hasTable && /* @__PURE__ */ jsxs("div", { className: "flex gap-1 rounded-lg border p-1", children: [
-            /* @__PURE__ */ jsx(
-              Button,
-              {
-                type: "button",
-                variant: view === "table" ? "secondary" : "ghost",
-                size: "sm",
-                className: "h-7 w-7 p-0",
-                "aria-label": "Table view",
-                "aria-pressed": view === "table",
-                onClick: () => setView("table"),
-                children: /* @__PURE__ */ jsx(Icon, { icon: UiTable })
-              }
-            ),
-            /* @__PURE__ */ jsx(
-              Button,
-              {
-                type: "button",
-                variant: view === "endpoints" ? "secondary" : "ghost",
-                size: "sm",
-                className: "h-7 w-7 p-0",
-                "aria-label": "Endpoint list view",
-                "aria-pressed": view === "endpoints",
-                onClick: () => setView("endpoints"),
-                children: /* @__PURE__ */ jsx(Icon, { icon: UiListFlat })
-              }
-            )
-          ] })
-        ] }),
-        /* @__PURE__ */ jsx(
-          OperationActionBar,
-          {
-            actions: actionOps,
-            client,
-            getLockedValues: getActionLockedValues,
-            onExecuted: () => void listQuery.refetch(),
-            ...commandRuntime ? { commandRuntime } : {},
-            ...formPre ? { formPre } : {},
-            ...formPost ? { formPost } : {},
-            ...formActions ? { formActions } : {},
-            ...actionLabels ? { actionLabels } : {}
-          }
-        ),
+        viewToggle && !viewToggleContainer && /* @__PURE__ */ jsx("div", { className: "flex items-start justify-end gap-4", children: viewToggle }),
+        viewToggle && viewToggleContainer && createPortal(viewToggle, viewToggleContainer),
+        actionsContainer ? createPortal(actionBar, actionsContainer) : actionBar,
         showTable ? /* @__PURE__ */ jsx(
           "div",
           {

package/dist/rpc/OperationCatalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"OperationCatalog.js","sources":["../../src/rpc/OperationCatalog.tsx"],"sourcesContent":["import { useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { Button } from \"../components/button\";\nimport { Icon } from \"../data/Icon\";\nimport { UiListFlat, UiTable } from \"../icons\";\nimport { filterOperationsByDomain } from \"./classify\";\nimport {\n  filterOperationsBySurface,\n  findSurfaceCollectionActions,\n  findSurfaceDetailOperation,\n  findSurfaceListOperation,\n  getOperationClickyMeta,\n} from \"./clickyMetadata\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n  ClickyRemoteFormat,\n} from \"../data/Clicky\";\nimport { EndpointList, type RenderLink } from \"./EndpointList\";\nimport { OperationActionBar } from \"./OperationActionBar\";\nimport {\n  OperationResultView,\n  type ResultRenderer,\n} from \"./OperationResultView\";\nimport { type FormActionsRenderer } from \"./SchemaActionForm\";\nimport {\n  applyFilterExtensions,\n  type FilterExtension,\n} from \"../components/filter-bar-utils\";\nimport type {\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport {\n  type DomainDefinition,\n  type ExecutionResponse,\n  type OperationLookupResponse,\n  type ResolvedOperation,\n} from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\nimport {\n  dataTablePaginationFromForm,\n  packParameterValues,\n  parametersToFormConfig,\n  type ParameterFormOptions,\n} from \"./formMetadata\";\n\nexport type OperationCatalogProps = {\n  definition: DomainDefinition;\n  entities: string[];\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  // Override to return all operations (e.g. for an \"API explorer\" domain\n  // that shouldn't be filtered by entity tags).\n  allOperations?: boolean;\n  surfaceKey?: string;\n  // Domain-specific filter decorators (e.g. stamp an entity icon by filter\n  // name). Composed in array order; mirrors JsonSchemaForm's `pre`.\n  filterPre?: FilterExtension[];\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n  renderError?: (err: unknown, title: string) => ReactNode;\n  kind?: \"operations\" | \"configuration\";\n  commandRuntime?: ClickyCommandRuntime;\n  // Custom JsonSchemaForm field extensions forwarded to the create/edit form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions for the create/edit form (e.g. a connection\n  // \"Test\" button).\n  formActions?: FormActionsRenderer;\n  actionLabels?: Record<string, string>;\n  // Optional host override for the result surface, keyed off the current surface.\n  // Receives the default OperationResultView so non-overridden surfaces render\n  // unchanged.\n  resultRenderer?: ResultRenderer;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nfunction defaultRenderError(err: unknown, title: string) {\n  const message = err instanceof Error ? err.message : String(err ?? \"\");\n  return (\n    <div className=\"rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive\">\n      <div className=\"font-medium\">{title}</div>\n      {message && (\n        <div className=\"mt-1 whitespace-pre-wrap text-xs opacity-80\">\n          {message}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function OperationCatalog({\n  definition,\n  entities,\n  client,\n  renderLink,\n  allOperations = false,\n  surfaceKey,\n  filterPre,\n  getCommandHref = defaultCommandHref,\n  renderError = defaultRenderError,\n  kind,\n  commandRuntime,\n  formPre,\n  formPost,\n  formActions,\n  actionLabels,\n  resultRenderer,\n}: OperationCatalogProps) {\n  const { operations, isLoading } = useOperations(client);\n  const [view, setView] = useState<\"table\" | \"endpoints\">(\"table\");\n\n  const surfaceOps = useMemo(\n    () => filterOperationsBySurface(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const useSurfaceMetadata = surfaceOps.length > 0;\n\n  // domainOps are the operations scoped to this domain: a surface's operations\n  // when surfaceKey resolves, otherwise the entity-tagged operations — used only\n  // to render the generic operation-page fallback, never to guess a table.\n  const domainOps = useMemo(() => {\n    if (useSurfaceMetadata) return surfaceOps;\n    return allOperations\n      ? operations\n      : filterOperationsByDomain(operations, entities);\n  }, [allOperations, entities, operations, surfaceOps, useSurfaceMetadata]);\n\n  // The list table is driven solely by x-clicky surface metadata. Without a\n  // surface there is no authoritative list op, so listEndpoint stays undefined\n  // and the catalog renders the generic EndpointList fallback instead of\n  // guessing a table from operationId/path conventions.\n  const listEndpoint = useMemo(() => {\n    if (!useSurfaceMetadata) return undefined;\n    return findSurfaceListOperation(domainOps, surfaceKey);\n  }, [domainOps, surfaceKey, useSurfaceMetadata]);\n  // The detail op turns each list row into a link to /<surface>/<id>; absent it\n  // (no surface metadata) rows stay non-navigable.\n  const detailOperation = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceDetailOperation(domainOps, surfaceKey)\n        : undefined,\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n  const [filters, setFilters] = useState<Record<string, string>>(() =>\n    readFiltersFromUrl(),\n  );\n  const listParameters = listEndpoint?.operation.parameters ?? [];\n  const download = useMemo<ClickyDownloadOptions | undefined>(() => {\n    const meta = listEndpoint?.operation[\"x-clicky\"]?.export;\n    if (!meta) return undefined;\n    return {\n      label: definition.title,\n      ...(meta.formats\n        ? { formats: meta.formats as ClickyRemoteFormat[] }\n        : {}),\n      ...(meta.scopes ? { scopes: meta.scopes } : {}),\n      ...(meta.allRowsMode ? { allRowsMode: meta.allRowsMode } : {}),\n      ...(meta.formatMaxRows\n        ? {\n            formatMaxRows: meta.formatMaxRows as Partial<\n              Record<ClickyRemoteFormat, number>\n            >,\n          }\n        : {}),\n    };\n  }, [definition.title, listEndpoint]);\n\n  useEffect(() => {\n    writeFiltersToUrl(filters);\n  }, [filters]);\n\n  const listQuery = useQuery<ExecutionResponse>({\n    queryKey: [\n      \"operation-list\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: () =>\n      client.executeCommand(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listEndpoint!.operation.parameters ?? []),\n        {\n          Accept: \"application/json+clicky\",\n        },\n      ),\n    enabled: !!listEndpoint && view === \"table\",\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const lookupQuery = useQuery<OperationLookupResponse>({\n    queryKey: [\n      \"operation-lookup\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: async () =>\n      (await client.lookupFilters?.(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listParameters),\n        { Accept: \"application/json+clicky\" },\n      )) ?? { filters: {} },\n    enabled: !!listEndpoint && view === \"table\" && !!client.lookupFilters,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // The list action bar shows only collection-scoped actions (create + bulk\n  // actions that operate on the filtered set). Entity-scoped actions\n  // (update/delete and per-id custom actions) need an {id}, so they live on the\n  // detail page (OperationEntityPage) instead. In the generic fallback the\n  // EndpointList already exposes every operation as a runnable card, so there is\n  // no separate action bar to guess at.\n  const actionOps = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceCollectionActions(domainOps, surfaceKey)\n        : [],\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n\n  const filterBarConfig = useMemo(() => {\n    const options: ParameterFormOptions = {\n      includeLocations: [\"query\"],\n    };\n    if (lookupQuery.data != null) {\n      options.lookup = lookupQuery.data;\n    }\n    return parametersToFormConfig(listParameters, filters, setFilters, options);\n  }, [filters, listParameters, lookupQuery.data]);\n  const dataTablePagination = useMemo(\n    () =>\n      dataTablePaginationFromForm(filterBarConfig.pagination, listQuery.data),\n    [filterBarConfig.pagination, listQuery.data],\n  );\n  const decoratedFilters = useMemo(\n    () =>\n      filterBarConfig.filters.map((filter) =>\n        applyFilterExtensions(filter, filterPre),\n      ),\n    [filterBarConfig.filters, filterPre],\n  );\n\n  const hasTable = !!listEndpoint;\n  const showTable = hasTable && view === \"table\";\n  const sectionLabel =\n    kind === \"configuration\" || definition.key.startsWith(\"config-\")\n      ? \"Configuration\"\n      : \"Operations\";\n  // Lock the current list filters into a bulk action (supportsFilterMode), so a\n  // collection action like \"pause\" runs against the same set the table shows.\n  // Entity-scoped actions never reach here (they live on the detail page).\n  function getActionLockedValues(\n    op: ResolvedOperation,\n  ): Record<string, string> {\n    const meta = getOperationClickyMeta(op);\n    if (meta == null || !meta.supportsFilterMode) {\n      return {};\n    }\n\n    const locked: Record<string, string> = {};\n    for (const param of op.operation.parameters ?? []) {\n      const value = filters[param.name];\n      if (param.in === \"query\" && value) {\n        locked[param.name] = value;\n      }\n    }\n\n    if (meta.idParam) {\n      locked[meta.idParam] = \"all\";\n    }\n\n    if (\n      (op.operation.parameters ?? []).some((param) => param.name === \"filter\")\n    ) {\n      locked.filter =\n        Object.entries(filters)\n          .filter(([, value]) => value)\n          .map(([key, value]) => `${key}=${value}`)\n          .join(\", \") || \"current list filters\";\n    }\n\n    return locked;\n  }\n\n  if (isLoading) {\n    return (\n      <div className=\"space-y-3\">\n        <SkeletonBlock className=\"h-10 w-72\" />\n        <SkeletonBlock className=\"h-4 w-[32rem]\" />\n        {Array.from({ length: 5 }).map((_, i) => (\n          <SkeletonBlock key={i} className=\"h-12\" />\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <div\n      className=\"flex h-full min-h-0 flex-col gap-6\"\n      data-slot=\"operation-catalog\"\n    >\n      <div className=\"flex items-start justify-between gap-4\">\n        <div className=\"min-w-0\">\n          <p className=\"text-xs uppercase tracking-[0.18em] text-muted-foreground\">\n            {sectionLabel}\n          </p>\n          <h1 className=\"text-2xl font-semibold tracking-tight\">\n            {definition.title}\n          </h1>\n          <p className=\"mt-1 max-w-2xl text-sm text-muted-foreground\">\n            {definition.description}\n          </p>\n        </div>\n        {hasTable && (\n          <div className=\"flex gap-1 rounded-lg border p-1\">\n            <Button\n              type=\"button\"\n              variant={view === \"table\" ? \"secondary\" : \"ghost\"}\n              size=\"sm\"\n              className=\"h-7 w-7 p-0\"\n              aria-label=\"Table view\"\n              aria-pressed={view === \"table\"}\n              onClick={() => setView(\"table\")}\n            >\n              <Icon icon={UiTable} />\n            </Button>\n            <Button\n              type=\"button\"\n              variant={view === \"endpoints\" ? \"secondary\" : \"ghost\"}\n              size=\"sm\"\n              className=\"h-7 w-7 p-0\"\n              aria-label=\"Endpoint list view\"\n              aria-pressed={view === \"endpoints\"}\n              onClick={() => setView(\"endpoints\")}\n            >\n              <Icon icon={UiListFlat} />\n            </Button>\n          </div>\n        )}\n      </div>\n\n      <OperationActionBar\n        actions={actionOps}\n        client={client}\n        getLockedValues={getActionLockedValues}\n        onExecuted={() => void listQuery.refetch()}\n        {...(commandRuntime ? { commandRuntime } : {})}\n        {...(formPre ? { formPre } : {})}\n        {...(formPost ? { formPost } : {})}\n        {...(formActions ? { formActions } : {})}\n        {...(actionLabels ? { actionLabels } : {})}\n      />\n\n      {showTable ? (\n        <div\n          className=\"min-h-0 flex-1\"\n          data-slot=\"operation-catalog-results\"\n        >\n          {listQuery.isError && !listQuery.data\n            ? renderError(\n                listQuery.error,\n                `Failed to load ${listEndpoint?.path ?? \"\"}`,\n              )\n            : (() => {\n                const defaultView = (\n                  <OperationResultView\n                    response={listQuery.data ?? null}\n                    loading={listQuery.isFetching}\n                    loadingMessage={`Loading ${definition.title} results…`}\n                    emptyMessage=\"No records returned\"\n                    ariaLabel={`${definition.title} results`}\n                    className=\"mt-0 h-full min-h-0\"\n                    detailOperation={detailOperation}\n                    filterConfig={{\n                      filters: decoratedFilters,\n                      ...(filterBarConfig.search\n                        ? { search: filterBarConfig.search }\n                        : {}),\n                      ...(filterBarConfig.timeRange\n                        ? { timeRange: filterBarConfig.timeRange }\n                        : {}),\n                    }}\n                    {...(commandRuntime ? { commandRuntime } : {})}\n                    {...(dataTablePagination\n                      ? { pagination: dataTablePagination }\n                      : {})}\n                    {...(download ? { download } : {})}\n                  />\n                );\n                return resultRenderer\n                  ? resultRenderer({\n                      response: listQuery.data ?? null,\n                      defaultView,\n                      ...(surfaceKey ? { surfaceKey } : {}),\n                    })\n                  : defaultView;\n              })()}\n        </div>\n      ) : (\n        <EndpointList\n          operations={domainOps}\n          definition={definition}\n          renderLink={renderLink}\n          getCommandHref={getCommandHref}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction readFiltersFromUrl(): Record<string, string> {\n  if (typeof window === \"undefined\") return {};\n  const search = new URLSearchParams(window.location.search);\n  const values: Record<string, string> = {};\n  for (const [key, value] of search.entries()) {\n    if (key.startsWith(\"__\")) continue;\n    if (value !== \"\") values[key] = value;\n  }\n  return values;\n}\n\nfunction SkeletonBlock({ className }: { className?: string }) {\n  return (\n    <div\n      className={`animate-pulse rounded-md bg-muted ${className ?? \"\"}`.trim()}\n    />\n  );\n}\n\nfunction writeFiltersToUrl(filters: Record<string, string>) {\n  if (typeof window === \"undefined\") return;\n  const search = reservedSearchParamsFromUrl();\n  for (const [key, value] of Object.entries(filters)) {\n    if (value !== \"\") search.set(key, value);\n  }\n  const query = search.toString();\n  const next = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`;\n  if (\n    next !==\n    `${window.location.pathname}${window.location.search}${window.location.hash}`\n  ) {\n    window.history.replaceState(window.history.state, \"\", next);\n  }\n}\n\nfunction reservedSearchParamsFromUrl() {\n  const current = new URLSearchParams(window.location.search);\n  const next = new URLSearchParams();\n  for (const [key, value] of current.entries()) {\n    if (!key.startsWith(\"__\")) continue;\n    if (key === \"__autoRun\" || key.startsWith(\"__arg\")) continue;\n    next.append(key, value);\n  }\n  return next;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"OperationCatalog.js","sources":["../../src/rpc/OperationCatalog.tsx"],"sourcesContent":["import { useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { Button } from \"../components/button\";\nimport { Icon } from \"../data/Icon\";\nimport { UiListFlat, UiTable } from \"../icons\";\nimport { filterOperationsByDomain } from \"./classify\";\nimport {\n  filterOperationsBySurface,\n  findSurfaceCollectionActions,\n  findSurfaceDetailOperation,\n  findSurfaceListOperation,\n  getOperationClickyMeta,\n} from \"./clickyMetadata\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n  ClickyRemoteFormat,\n} from \"../data/Clicky\";\nimport { EndpointList, type RenderLink } from \"./EndpointList\";\nimport { OperationActionBar } from \"./OperationActionBar\";\nimport {\n  OperationResultView,\n  type ResultRenderer,\n} from \"./OperationResultView\";\nimport { type FormActionsRenderer } from \"./SchemaActionForm\";\nimport {\n  applyFilterExtensions,\n  type FilterExtension,\n} from \"../components/filter-bar-utils\";\nimport type {\n  PreExtension,\n  PostExtension,\n} from \"../components/json-schema-form-types\";\nimport {\n  type DomainDefinition,\n  type ExecutionResponse,\n  type OperationLookupResponse,\n  type ResolvedOperation,\n} from \"./types\";\nimport { useOperations, type OperationsApiClient } from \"./useOperations\";\nimport {\n  dataTablePaginationFromForm,\n  packParameterValues,\n  parametersToFormConfig,\n  type ParameterFormOptions,\n} from \"./formMetadata\";\n\nexport type OperationCatalogProps = {\n  definition: DomainDefinition;\n  entities: string[];\n  client: OperationsApiClient;\n  renderLink: RenderLink;\n  // Override to return all operations (e.g. for an \"API explorer\" domain\n  // that shouldn't be filtered by entity tags).\n  allOperations?: boolean;\n  surfaceKey?: string;\n  // Domain-specific filter decorators (e.g. stamp an entity icon by filter\n  // name). Composed in array order; mirrors JsonSchemaForm's `pre`.\n  filterPre?: FilterExtension[];\n  getCommandHref?: (operationId: string, op: ResolvedOperation) => string;\n  renderError?: (err: unknown, title: string) => ReactNode;\n  commandRuntime?: ClickyCommandRuntime;\n  // Custom JsonSchemaForm field extensions forwarded to the create/edit form.\n  formPre?: PreExtension[];\n  formPost?: PostExtension[];\n  // Optional extra footer actions for the create/edit form (e.g. a connection\n  // \"Test\" button).\n  formActions?: FormActionsRenderer;\n  actionLabels?: Record<string, string>;\n  // Optional host override for the result surface, keyed off the current surface.\n  // Receives the default OperationResultView so non-overridden surfaces render\n  // unchanged.\n  resultRenderer?: ResultRenderer;\n  /**\n   * Portal target for the collection action bar (Create, bulk actions). When\n   * set, the bar renders into this element — typically an app shell's\n   * `bodyActions` slot — instead of inline under the catalog header.\n   *\n   * A portal rather than a render-prop because the bar owns its own dialog\n   * state and closes over the catalog's live filters and list query; moving the\n   * element would sever both. Falls back to inline rendering when null, so\n   * existing consumers are unaffected.\n   */\n  actionsContainer?: Element | null;\n  /**\n   * Portal target for the table/endpoint-list view switcher — typically an app\n   * shell's top-bar `actions` slot. Falls back to inline rendering when null.\n   */\n  viewToggleContainer?: Element | null;\n};\n\nconst defaultCommandHref = (operationId: string) => `/commands/${operationId}`;\n\nfunction defaultRenderError(err: unknown, title: string) {\n  const message = err instanceof Error ? err.message : String(err ?? \"\");\n  return (\n    <div className=\"rounded-xl border border-destructive/40 bg-destructive/5 p-4 text-sm text-destructive\">\n      <div className=\"font-medium\">{title}</div>\n      {message && (\n        <div className=\"mt-1 whitespace-pre-wrap text-xs opacity-80\">\n          {message}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function OperationCatalog({\n  definition,\n  entities,\n  client,\n  renderLink,\n  allOperations = false,\n  surfaceKey,\n  filterPre,\n  getCommandHref = defaultCommandHref,\n  renderError = defaultRenderError,\n  commandRuntime,\n  formPre,\n  formPost,\n  formActions,\n  actionLabels,\n  resultRenderer,\n  actionsContainer,\n  viewToggleContainer,\n}: OperationCatalogProps) {\n  const { operations, isLoading } = useOperations(client);\n  const [view, setView] = useState<\"table\" | \"endpoints\">(\"table\");\n\n  const surfaceOps = useMemo(\n    () => filterOperationsBySurface(operations, surfaceKey),\n    [operations, surfaceKey],\n  );\n  const useSurfaceMetadata = surfaceOps.length > 0;\n\n  // domainOps are the operations scoped to this domain: a surface's operations\n  // when surfaceKey resolves, otherwise the entity-tagged operations — used only\n  // to render the generic operation-page fallback, never to guess a table.\n  const domainOps = useMemo(() => {\n    if (useSurfaceMetadata) return surfaceOps;\n    return allOperations\n      ? operations\n      : filterOperationsByDomain(operations, entities);\n  }, [allOperations, entities, operations, surfaceOps, useSurfaceMetadata]);\n\n  // The list table is driven solely by x-clicky surface metadata. Without a\n  // surface there is no authoritative list op, so listEndpoint stays undefined\n  // and the catalog renders the generic EndpointList fallback instead of\n  // guessing a table from operationId/path conventions.\n  const listEndpoint = useMemo(() => {\n    if (!useSurfaceMetadata) return undefined;\n    return findSurfaceListOperation(domainOps, surfaceKey);\n  }, [domainOps, surfaceKey, useSurfaceMetadata]);\n  // The detail op turns each list row into a link to /<surface>/<id>; absent it\n  // (no surface metadata) rows stay non-navigable.\n  const detailOperation = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceDetailOperation(domainOps, surfaceKey)\n        : undefined,\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n  const [filters, setFilters] = useState<Record<string, string>>(() =>\n    readFiltersFromUrl(),\n  );\n  const listParameters = listEndpoint?.operation.parameters ?? [];\n  const download = useMemo<ClickyDownloadOptions | undefined>(() => {\n    const meta = listEndpoint?.operation[\"x-clicky\"]?.export;\n    if (!meta) return undefined;\n    return {\n      label: definition.title,\n      ...(meta.formats\n        ? { formats: meta.formats as ClickyRemoteFormat[] }\n        : {}),\n      ...(meta.scopes ? { scopes: meta.scopes } : {}),\n      ...(meta.allRowsMode ? { allRowsMode: meta.allRowsMode } : {}),\n      ...(meta.formatMaxRows\n        ? {\n            formatMaxRows: meta.formatMaxRows as Partial<\n              Record<ClickyRemoteFormat, number>\n            >,\n          }\n        : {}),\n    };\n  }, [definition.title, listEndpoint]);\n\n  useEffect(() => {\n    writeFiltersToUrl(filters);\n  }, [filters]);\n\n  const listQuery = useQuery<ExecutionResponse>({\n    queryKey: [\n      \"operation-list\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: () =>\n      client.executeCommand(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listEndpoint!.operation.parameters ?? []),\n        {\n          Accept: \"application/json+clicky\",\n        },\n      ),\n    enabled: !!listEndpoint && view === \"table\",\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const lookupQuery = useQuery<OperationLookupResponse>({\n    queryKey: [\n      \"operation-lookup\",\n      listEndpoint?.method,\n      listEndpoint?.path,\n      filters,\n    ],\n    queryFn: async () =>\n      (await client.lookupFilters?.(\n        listEndpoint!.path,\n        listEndpoint!.method,\n        packParameterValues(filters, listParameters),\n        { Accept: \"application/json+clicky\" },\n      )) ?? { filters: {} },\n    enabled: !!listEndpoint && view === \"table\" && !!client.lookupFilters,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // The list action bar shows only collection-scoped actions (create + bulk\n  // actions that operate on the filtered set). Entity-scoped actions\n  // (update/delete and per-id custom actions) need an {id}, so they live on the\n  // detail page (OperationEntityPage) instead. In the generic fallback the\n  // EndpointList already exposes every operation as a runnable card, so there is\n  // no separate action bar to guess at.\n  const actionOps = useMemo(\n    () =>\n      useSurfaceMetadata\n        ? findSurfaceCollectionActions(domainOps, surfaceKey)\n        : [],\n    [domainOps, surfaceKey, useSurfaceMetadata],\n  );\n\n  const filterBarConfig = useMemo(() => {\n    const options: ParameterFormOptions = {\n      includeLocations: [\"query\"],\n    };\n    if (lookupQuery.data != null) {\n      options.lookup = lookupQuery.data;\n    }\n    return parametersToFormConfig(listParameters, filters, setFilters, options);\n  }, [filters, listParameters, lookupQuery.data]);\n  const dataTablePagination = useMemo(\n    () =>\n      dataTablePaginationFromForm(filterBarConfig.pagination, listQuery.data),\n    [filterBarConfig.pagination, listQuery.data],\n  );\n  const decoratedFilters = useMemo(\n    () =>\n      filterBarConfig.filters.map((filter) =>\n        applyFilterExtensions(filter, filterPre),\n      ),\n    [filterBarConfig.filters, filterPre],\n  );\n\n  const hasTable = !!listEndpoint;\n  const showTable = hasTable && view === \"table\";\n  // Lock the current list filters into a bulk action (supportsFilterMode), so a\n  // collection action like \"pause\" runs against the same set the table shows.\n  // Entity-scoped actions never reach here (they live on the detail page).\n  function getActionLockedValues(\n    op: ResolvedOperation,\n  ): Record<string, string> {\n    const meta = getOperationClickyMeta(op);\n    if (meta == null || !meta.supportsFilterMode) {\n      return {};\n    }\n\n    const locked: Record<string, string> = {};\n    for (const param of op.operation.parameters ?? []) {\n      const value = filters[param.name];\n      if (param.in === \"query\" && value) {\n        locked[param.name] = value;\n      }\n    }\n\n    if (meta.idParam) {\n      locked[meta.idParam] = \"all\";\n    }\n\n    if (\n      (op.operation.parameters ?? []).some((param) => param.name === \"filter\")\n    ) {\n      locked.filter =\n        Object.entries(filters)\n          .filter(([, value]) => value)\n          .map(([key, value]) => `${key}=${value}`)\n          .join(\", \") || \"current list filters\";\n    }\n\n    return locked;\n  }\n\n  if (isLoading) {\n    return (\n      <div className=\"space-y-3\">\n        <SkeletonBlock className=\"h-10 w-72\" />\n        <SkeletonBlock className=\"h-4 w-[32rem]\" />\n        {Array.from({ length: 5 }).map((_, i) => (\n          <SkeletonBlock key={i} className=\"h-12\" />\n        ))}\n      </div>\n    );\n  }\n\n  // Both clusters are built here — they depend on catalog-local state (`view`,\n  // `filters`, `listQuery`) — but a host may relocate either into an app shell\n  // slot by supplying a portal target.\n  const viewToggle = hasTable ? (\n    <div data-slot=\"operation-catalog-view-toggle\" className=\"flex gap-1 rounded-lg border p-1\">\n      <Button\n        type=\"button\"\n        variant={view === \"table\" ? \"secondary\" : \"ghost\"}\n        size=\"sm\"\n        className=\"h-7 w-7 p-0\"\n        aria-label=\"Table view\"\n        aria-pressed={view === \"table\"}\n        onClick={() => setView(\"table\")}\n      >\n        <Icon icon={UiTable} />\n      </Button>\n      <Button\n        type=\"button\"\n        variant={view === \"endpoints\" ? \"secondary\" : \"ghost\"}\n        size=\"sm\"\n        className=\"h-7 w-7 p-0\"\n        aria-label=\"Endpoint list view\"\n        aria-pressed={view === \"endpoints\"}\n        onClick={() => setView(\"endpoints\")}\n      >\n        <Icon icon={UiListFlat} />\n      </Button>\n    </div>\n  ) : null;\n\n  const actionBar = (\n    <OperationActionBar\n      actions={actionOps}\n      client={client}\n      getLockedValues={getActionLockedValues}\n      onExecuted={() => void listQuery.refetch()}\n      {...(commandRuntime ? { commandRuntime } : {})}\n      {...(formPre ? { formPre } : {})}\n      {...(formPost ? { formPost } : {})}\n      {...(formActions ? { formActions } : {})}\n      {...(actionLabels ? { actionLabels } : {})}\n    />\n  );\n\n  return (\n    <div\n      className=\"flex h-full min-h-0 flex-col gap-6\"\n      data-slot=\"operation-catalog\"\n    >\n      {/* No title/description here by design: page headers and breadcrumbs are\n          the host's to define (e.g. an app shell's bodyHeader), so the catalog\n          never invents chrome the consumer would have to fight or duplicate. */}\n      {viewToggle && !viewToggleContainer && (\n        <div className=\"flex items-start justify-end gap-4\">{viewToggle}</div>\n      )}\n      {viewToggle && viewToggleContainer && createPortal(viewToggle, viewToggleContainer)}\n      {actionsContainer ? createPortal(actionBar, actionsContainer) : actionBar}\n\n      {showTable ? (\n        <div\n          className=\"min-h-0 flex-1\"\n          data-slot=\"operation-catalog-results\"\n        >\n          {listQuery.isError && !listQuery.data\n            ? renderError(\n                listQuery.error,\n                `Failed to load ${listEndpoint?.path ?? \"\"}`,\n              )\n            : (() => {\n                const defaultView = (\n                  <OperationResultView\n                    response={listQuery.data ?? null}\n                    loading={listQuery.isFetching}\n                    loadingMessage={`Loading ${definition.title} results…`}\n                    emptyMessage=\"No records returned\"\n                    ariaLabel={`${definition.title} results`}\n                    className=\"mt-0 h-full min-h-0\"\n                    detailOperation={detailOperation}\n                    filterConfig={{\n                      filters: decoratedFilters,\n                      ...(filterBarConfig.search\n                        ? { search: filterBarConfig.search }\n                        : {}),\n                      ...(filterBarConfig.timeRange\n                        ? { timeRange: filterBarConfig.timeRange }\n                        : {}),\n                    }}\n                    {...(commandRuntime ? { commandRuntime } : {})}\n                    {...(dataTablePagination\n                      ? { pagination: dataTablePagination }\n                      : {})}\n                    {...(download ? { download } : {})}\n                  />\n                );\n                return resultRenderer\n                  ? resultRenderer({\n                      response: listQuery.data ?? null,\n                      defaultView,\n                      ...(surfaceKey ? { surfaceKey } : {}),\n                    })\n                  : defaultView;\n              })()}\n        </div>\n      ) : (\n        <EndpointList\n          operations={domainOps}\n          definition={definition}\n          renderLink={renderLink}\n          getCommandHref={getCommandHref}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction readFiltersFromUrl(): Record<string, string> {\n  if (typeof window === \"undefined\") return {};\n  const search = new URLSearchParams(window.location.search);\n  const values: Record<string, string> = {};\n  for (const [key, value] of search.entries()) {\n    if (key.startsWith(\"__\")) continue;\n    if (value !== \"\") values[key] = value;\n  }\n  return values;\n}\n\nfunction SkeletonBlock({ className }: { className?: string }) {\n  return (\n    <div\n      className={`animate-pulse rounded-md bg-muted ${className ?? \"\"}`.trim()}\n    />\n  );\n}\n\nfunction writeFiltersToUrl(filters: Record<string, string>) {\n  if (typeof window === \"undefined\") return;\n  const search = reservedSearchParamsFromUrl();\n  for (const [key, value] of Object.entries(filters)) {\n    if (value !== \"\") search.set(key, value);\n  }\n  const query = search.toString();\n  const next = `${window.location.pathname}${query ? `?${query}` : \"\"}${window.location.hash}`;\n  if (\n    next !==\n    `${window.location.pathname}${window.location.search}${window.location.hash}`\n  ) {\n    window.history.replaceState(window.history.state, \"\", next);\n  }\n}\n\nfunction reservedSearchParamsFromUrl() {\n  const current = new URLSearchParams(window.location.search);\n  const next = new URLSearchParams();\n  for (const [key, value] of current.entries()) {\n    if (!key.startsWith(\"__\")) continue;\n    if (key === \"__autoRun\" || key.startsWith(\"__arg\")) continue;\n    next.append(key, value);\n  }\n  return next;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA4FA,MAAM,qBAAqB,CAAC,gBAAwB,aAAa,WAAW;AAE5E,SAAS,mBAAmB,KAAc,OAAe;AACvD,QAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,OAAO,EAAE;AACrE,SACE,qBAAC,OAAA,EAAI,WAAU,yFACb,UAAA;AAAA,IAAA,oBAAC,OAAA,EAAI,WAAU,eAAe,UAAA,OAAM;AAAA,IACnC,WACC,oBAAC,OAAA,EAAI,WAAU,+CACZ,UAAA,QAAA,CACH;AAAA,EAAA,GAEJ;AAEJ;AAEO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,gBAAgB;AAAA,EAChB;AAAA,EACA;AAAA,EACA,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0B;AACxB,QAAM,EAAE,YAAY,cAAc,cAAc,MAAM;AACtD,QAAM,CAAC,MAAM,OAAO,IAAI,SAAgC,OAAO;AAE/D,QAAM,aAAa;AAAA,IACjB,MAAM,0BAA0B,YAAY,UAAU;AAAA,IACtD,CAAC,YAAY,UAAU;AAAA,EAAA;AAEzB,QAAM,qBAAqB,WAAW,SAAS;AAK/C,QAAM,YAAY,QAAQ,MAAM;AAC9B,QAAI,mBAAoB,QAAO;AAC/B,WAAO,gBACH,aACA,yBAAyB,YAAY,QAAQ;AAAA,EACnD,GAAG,CAAC,eAAe,UAAU,YAAY,YAAY,kBAAkB,CAAC;AAMxE,QAAM,eAAe,QAAQ,MAAM;AACjC,QAAI,CAAC,mBAAoB,QAAO;AAChC,WAAO,yBAAyB,WAAW,UAAU;AAAA,EACvD,GAAG,CAAC,WAAW,YAAY,kBAAkB,CAAC;AAG9C,QAAM,kBAAkB;AAAA,IACtB,MACE,qBACI,2BAA2B,WAAW,UAAU,IAChD;AAAA,IACN,CAAC,WAAW,YAAY,kBAAkB;AAAA,EAAA;AAE5C,QAAM,CAAC,SAAS,UAAU,IAAI;AAAA,IAAiC,MAC7D,mBAAA;AAAA,EAAmB;AAErB,QAAM,kBAAiB,6CAAc,UAAU,eAAc,CAAA;AAC7D,QAAM,WAAW,QAA2C,MAAM;;AAChE,UAAM,QAAO,kDAAc,UAAU,gBAAxB,mBAAqC;AAClD,QAAI,CAAC,KAAM,QAAO;AAClB,WAAO;AAAA,MACL,OAAO,WAAW;AAAA,MAClB,GAAI,KAAK,UACL,EAAE,SAAS,KAAK,QAAA,IAChB,CAAA;AAAA,MACJ,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAA,IAAW,CAAA;AAAA,MAC5C,GAAI,KAAK,cAAc,EAAE,aAAa,KAAK,YAAA,IAAgB,CAAA;AAAA,MAC3D,GAAI,KAAK,gBACL;AAAA,QACE,eAAe,KAAK;AAAA,MAAA,IAItB,CAAA;AAAA,IAAC;AAAA,EAET,GAAG,CAAC,WAAW,OAAO,YAAY,CAAC;AAEnC,YAAU,MAAM;AACd,sBAAkB,OAAO;AAAA,EAC3B,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,YAAY,SAA4B;AAAA,IAC5C,UAAU;AAAA,MACR;AAAA,MACA,6CAAc;AAAA,MACd,6CAAc;AAAA,MACd;AAAA,IAAA;AAAA,IAEF,SAAS,MACP,OAAO;AAAA,MACL,aAAc;AAAA,MACd,aAAc;AAAA,MACd,oBAAoB,SAAS,aAAc,UAAU,cAAc,CAAA,CAAE;AAAA,MACrE;AAAA,QACE,QAAQ;AAAA,MAAA;AAAA,IACV;AAAA,IAEJ,SAAS,CAAC,CAAC,gBAAgB,SAAS;AAAA,IACpC,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,OAAO;AAAA,EAAA,CACR;AAED,QAAM,cAAc,SAAkC;AAAA,IACpD,UAAU;AAAA,MACR;AAAA,MACA,6CAAc;AAAA,MACd,6CAAc;AAAA,MACd;AAAA,IAAA;AAAA,IAEF,SAAS,YAAA;;AACN,qBAAM,YAAO,kBAAP;AAAA;AAAA,QACL,aAAc;AAAA,QACd,aAAc;AAAA,QACd,oBAAoB,SAAS,cAAc;AAAA,QAC3C,EAAE,QAAQ,0BAAA;AAAA,YACN,EAAE,SAAS,GAAC;AAAA;AAAA,IACpB,SAAS,CAAC,CAAC,gBAAgB,SAAS,WAAW,CAAC,CAAC,OAAO;AAAA,IACxD,WAAW;AAAA,IACX,OAAO;AAAA,EAAA,CACR;AAQD,QAAM,YAAY;AAAA,IAChB,MACE,qBACI,6BAA6B,WAAW,UAAU,IAClD,CAAA;AAAA,IACN,CAAC,WAAW,YAAY,kBAAkB;AAAA,EAAA;AAG5C,QAAM,kBAAkB,QAAQ,MAAM;AACpC,UAAM,UAAgC;AAAA,MACpC,kBAAkB,CAAC,OAAO;AAAA,IAAA;AAE5B,QAAI,YAAY,QAAQ,MAAM;AAC5B,cAAQ,SAAS,YAAY;AAAA,IAC/B;AACA,WAAO,uBAAuB,gBAAgB,SAAS,YAAY,OAAO;AAAA,EAC5E,GAAG,CAAC,SAAS,gBAAgB,YAAY,IAAI,CAAC;AAC9C,QAAM,sBAAsB;AAAA,IAC1B,MACE,4BAA4B,gBAAgB,YAAY,UAAU,IAAI;AAAA,IACxE,CAAC,gBAAgB,YAAY,UAAU,IAAI;AAAA,EAAA;AAE7C,QAAM,mBAAmB;AAAA,IACvB,MACE,gBAAgB,QAAQ;AAAA,MAAI,CAAC,WAC3B,sBAAsB,QAAQ,SAAS;AAAA,IAAA;AAAA,IAE3C,CAAC,gBAAgB,SAAS,SAAS;AAAA,EAAA;AAGrC,QAAM,WAAW,CAAC,CAAC;AACnB,QAAM,YAAY,YAAY,SAAS;AAIvC,WAAS,sBACP,IACwB;AACxB,UAAM,OAAO,uBAAuB,EAAE;AACtC,QAAI,QAAQ,QAAQ,CAAC,KAAK,oBAAoB;AAC5C,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,SAAiC,CAAA;AACvC,eAAW,SAAS,GAAG,UAAU,cAAc,CAAA,GAAI;AACjD,YAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,UAAI,MAAM,OAAO,WAAW,OAAO;AACjC,eAAO,MAAM,IAAI,IAAI;AAAA,MACvB;AAAA,IACF;AAEA,QAAI,KAAK,SAAS;AAChB,aAAO,KAAK,OAAO,IAAI;AAAA,IACzB;AAEA,SACG,GAAG,UAAU,cAAc,CAAA,GAAI,KAAK,CAAC,UAAU,MAAM,SAAS,QAAQ,GACvE;AACA,aAAO,SACL,OAAO,QAAQ,OAAO,EACnB,OAAO,CAAC,CAAA,EAAG,KAAK,MAAM,KAAK,EAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,EACvC,KAAK,IAAI,KAAK;AAAA,IACrB;AAEA,WAAO;AAAA,EACT;AAEA,MAAI,WAAW;AACb,WACE,qBAAC,OAAA,EAAI,WAAU,aACb,UAAA;AAAA,MAAA,oBAAC,eAAA,EAAc,WAAU,YAAA,CAAY;AAAA,MACrC,oBAAC,eAAA,EAAc,WAAU,gBAAA,CAAgB;AAAA,MACxC,MAAM,KAAK,EAAE,QAAQ,EAAA,CAAG,EAAE,IAAI,CAAC,GAAG,MACjC,oBAAC,eAAA,EAAsB,WAAU,OAAA,GAAb,CAAoB,CACzC;AAAA,IAAA,GACH;AAAA,EAEJ;AAKA,QAAM,aAAa,WACjB,qBAAC,SAAI,aAAU,iCAAgC,WAAU,oCACvD,UAAA;AAAA,IAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,SAAS,UAAU,cAAc;AAAA,QAC1C,MAAK;AAAA,QACL,WAAU;AAAA,QACV,cAAW;AAAA,QACX,gBAAc,SAAS;AAAA,QACvB,SAAS,MAAM,QAAQ,OAAO;AAAA,QAE9B,UAAA,oBAAC,MAAA,EAAK,MAAM,QAAA,CAAS;AAAA,MAAA;AAAA,IAAA;AAAA,IAEvB;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,SAAS,cAAc,cAAc;AAAA,QAC9C,MAAK;AAAA,QACL,WAAU;AAAA,QACV,cAAW;AAAA,QACX,gBAAc,SAAS;AAAA,QACvB,SAAS,MAAM,QAAQ,WAAW;AAAA,QAElC,UAAA,oBAAC,MAAA,EAAK,MAAM,WAAA,CAAY;AAAA,MAAA;AAAA,IAAA;AAAA,EAC1B,EAAA,CACF,IACE;AAEJ,QAAM,YACJ;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,SAAS;AAAA,MACT;AAAA,MACA,iBAAiB;AAAA,MACjB,YAAY,MAAM,KAAK,UAAU,QAAA;AAAA,MAChC,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,MAC1C,GAAI,UAAU,EAAE,QAAA,IAAY,CAAA;AAAA,MAC5B,GAAI,WAAW,EAAE,SAAA,IAAa,CAAA;AAAA,MAC9B,GAAI,cAAc,EAAE,YAAA,IAAgB,CAAA;AAAA,MACpC,GAAI,eAAe,EAAE,iBAAiB,CAAA;AAAA,IAAC;AAAA,EAAA;AAI5C,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAU;AAAA,MACV,aAAU;AAAA,MAKT,UAAA;AAAA,QAAA,cAAc,CAAC,uBACd,oBAAC,OAAA,EAAI,WAAU,sCAAsC,UAAA,YAAW;AAAA,QAEjE,cAAc,uBAAuB,aAAa,YAAY,mBAAmB;AAAA,QACjF,mBAAmB,aAAa,WAAW,gBAAgB,IAAI;AAAA,QAE/D,YACC;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,WAAU;AAAA,YACV,aAAU;AAAA,YAET,UAAA,UAAU,WAAW,CAAC,UAAU,OAC7B;AAAA,cACE,UAAU;AAAA,cACV,mBAAkB,6CAAc,SAAQ,EAAE;AAAA,YAAA,KAE3C,MAAM;AACL,oBAAM,cACJ;AAAA,gBAAC;AAAA,gBAAA;AAAA,kBACC,UAAU,UAAU,QAAQ;AAAA,kBAC5B,SAAS,UAAU;AAAA,kBACnB,gBAAgB,WAAW,WAAW,KAAK;AAAA,kBAC3C,cAAa;AAAA,kBACb,WAAW,GAAG,WAAW,KAAK;AAAA,kBAC9B,WAAU;AAAA,kBACV;AAAA,kBACA,cAAc;AAAA,oBACZ,SAAS;AAAA,oBACT,GAAI,gBAAgB,SAChB,EAAE,QAAQ,gBAAgB,OAAA,IAC1B,CAAA;AAAA,oBACJ,GAAI,gBAAgB,YAChB,EAAE,WAAW,gBAAgB,UAAA,IAC7B,CAAA;AAAA,kBAAC;AAAA,kBAEN,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,kBAC1C,GAAI,sBACD,EAAE,YAAY,oBAAA,IACd,CAAA;AAAA,kBACH,GAAI,WAAW,EAAE,aAAa,CAAA;AAAA,gBAAC;AAAA,cAAA;AAGpC,qBAAO,iBACH,eAAe;AAAA,gBACb,UAAU,UAAU,QAAQ;AAAA,gBAC5B;AAAA,gBACA,GAAI,aAAa,EAAE,eAAe,CAAA;AAAA,cAAC,CACpC,IACD;AAAA,YACN,GAAA;AAAA,UAAG;AAAA,QAAA,IAGT;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,YAAY;AAAA,YACZ;AAAA,YACA;AAAA,YACA;AAAA,UAAA;AAAA,QAAA;AAAA,MACF;AAAA,IAAA;AAAA,EAAA;AAIR;AAEA,SAAS,qBAA6C;AACpD,MAAI,OAAO,WAAW,YAAa,QAAO,CAAA;AAC1C,QAAM,SAAS,IAAI,gBAAgB,OAAO,SAAS,MAAM;AACzD,QAAM,SAAiC,CAAA;AACvC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,WAAW;AAC3C,QAAI,IAAI,WAAW,IAAI,EAAG;AAC1B,QAAI,UAAU,GAAI,QAAO,GAAG,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAEA,SAAS,cAAc,EAAE,aAAqC;AAC5D,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW,qCAAqC,aAAa,EAAE,GAAG,KAAA;AAAA,IAAK;AAAA,EAAA;AAG7E;AAEA,SAAS,kBAAkB,SAAiC;AAC1D,MAAI,OAAO,WAAW,YAAa;AACnC,QAAM,SAAS,4BAAA;AACf,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,GAAG;AAClD,QAAI,UAAU,GAAI,QAAO,IAAI,KAAK,KAAK;AAAA,EACzC;AACA,QAAM,QAAQ,OAAO,SAAA;AACrB,QAAM,OAAO,GAAG,OAAO,SAAS,QAAQ,GAAG,QAAQ,IAAI,KAAK,KAAK,EAAE,GAAG,OAAO,SAAS,IAAI;AAC1F,MACE,SACA,GAAG,OAAO,SAAS,QAAQ,GAAG,OAAO,SAAS,MAAM,GAAG,OAAO,SAAS,IAAI,IAC3E;AACA,WAAO,QAAQ,aAAa,OAAO,QAAQ,OAAO,IAAI,IAAI;AAAA,EAC5D;AACF;AAEA,SAAS,8BAA8B;AACrC,QAAM,UAAU,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC1D,QAAM,OAAO,IAAI,gBAAA;AACjB,aAAW,CAAC,KAAK,KAAK,KAAK,QAAQ,WAAW;AAC5C,QAAI,CAAC,IAAI,WAAW,IAAI,EAAG;AAC3B,QAAI,QAAQ,eAAe,IAAI,WAAW,OAAO,EAAG;AACpD,SAAK,OAAO,KAAK,KAAK;AAAA,EACxB;AACA,SAAO;AACT;"}

package/dist/rpc/clickyMetadata.cjs

@@ -64,7 +64,8 @@ function makeSurfaceDefinition(surface) {
   return {
     key: surface.key,
     title: surface.title,
-    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`
+    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,
+    ...surface.icon ? { icon: surface.icon } : {}
   };
 }
 exports.filterOperationsBySurface = filterOperationsBySurface;

package/dist/rpc/clickyMetadata.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"clickyMetadata.cjs","sources":["../../src/rpc/clickyMetadata.ts"],"sourcesContent":["import type {\n  ClickyOperationMeta,\n  ClickySpecMeta,\n  ClickySurface,\n  DomainDefinition,\n  OpenAPISpec,\n  ResolvedOperation,\n} from \"./types\";\n\nexport function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined {\n  return spec?.[\"x-clicky\"];\n}\n\nexport function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[] {\n  return getClickySpecMeta(spec)?.surfaces ?? [];\n}\n\nexport function getOperationClickyMeta(\n  operation: Pick<ResolvedOperation, \"operation\">,\n): ClickyOperationMeta | undefined {\n  return operation.operation[\"x-clicky\"];\n}\n\nexport function filterOperationsBySurface(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  if (!surfaceKey) return [];\n  return operations.filter(\n    (operation) => getOperationClickyMeta(operation)?.surface === surfaceKey,\n  );\n}\n\nexport function findSurfaceOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n  predicate: (meta: ClickyOperationMeta) => boolean,\n): ResolvedOperation | undefined {\n  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && predicate(meta);\n  });\n}\n\nexport function findSurfaceListOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"list\" && meta.scope === \"collection\",\n  );\n}\n\nexport function findSurfaceDetailOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"get\" && meta.scope === \"entity\",\n  );\n}\n\nexport function findSurfaceCollectionActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"collection\" && meta.verb !== \"list\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized) over\n// the OpenAPI summary, which is often a full sentence. Without surface metadata\n// (a non-surface operation) it falls back to the summary, then the\n// operationId/path, so a button always has a label.\nexport function surfaceActionLabel(operation: ResolvedOperation): string {\n  const meta = getOperationClickyMeta(operation);\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  return operation.operation.summary || operation.operation.operationId || operation.path;\n}\n\nexport function findSurfaceEntityActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"entity\" && meta.verb !== \"get\";\n  });\n}\n\nexport function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition {\n  return {\n    key: surface.key,\n    title: surface.title,\n    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,\n  };\n}\n"],"names":[],"mappings":";;AASO,SAAS,kBAAkB,MAA2D;AAC3F,SAAO,6BAAO;AAChB;AAEO,SAAS,kBAAkB,MAAgD;;AAChF,WAAO,uBAAkB,IAAI,MAAtB,mBAAyB,aAAY,CAAA;AAC9C;AAEO,SAAS,uBACd,WACiC;AACjC,SAAO,UAAU,UAAU,UAAU;AACvC;AAEO,SAAS,0BACd,YACA,YACqB;AACrB,MAAI,CAAC,WAAY,QAAO,CAAA;AACxB,SAAO,WAAW;AAAA,IAChB,CAAC,cAAA;;AAAc,2CAAuB,SAAS,MAAhC,mBAAmC,aAAY;AAAA;AAAA,EAAA;AAElE;AAEO,SAAS,qBACd,YACA,YACA,WAC+B;AAC/B,SAAO,0BAA0B,YAAY,UAAU,EAAE,KAAK,CAAC,cAAc;AAC3E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,UAAU,IAAI;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU;AAAA,EAAA;AAErD;AAEO,SAAS,2BACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,SAAS,KAAK,UAAU;AAAA,EAAA;AAEpD;AAEO,SAAS,6BACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,gBAAgB,KAAK,SAAS;AAAA,EACtE,CAAC;AACH;AAMO,SAAS,mBAAmB,WAAsC;;AACvE,QAAM,OAAO,uBAAuB,SAAS;AAC7C,QAAM,UAAQ,kCAAM,eAAN,mBAAkB,aAAU,kCAAM,SAAN,mBAAY;AACtD,MAAI,SAAS,UAAU,UAAU;AAC/B,WAAO,MAAM,OAAO,CAAC,EAAE,gBAAgB,MAAM,MAAM,CAAC;AAAA,EACtD;AACA,SAAO,UAAU,UAAU,WAAW,UAAU,UAAU,eAAe,UAAU;AACrF;AAEO,SAAS,yBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,YAAY,KAAK,SAAS;AAAA,EAClE,CAAC;AACH;AAEO,SAAS,sBAAsB,SAA0C;AAC9E,SAAO;AAAA,IACL,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ,eAAe,UAAU,QAAQ,MAAM,aAAa;AAAA,EAAA;AAE7E;;;;;;;;;;;;"}
+{"version":3,"file":"clickyMetadata.cjs","sources":["../../src/rpc/clickyMetadata.ts"],"sourcesContent":["import type {\n  ClickyOperationMeta,\n  ClickySpecMeta,\n  ClickySurface,\n  DomainDefinition,\n  OpenAPISpec,\n  ResolvedOperation,\n} from \"./types\";\n\nexport function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined {\n  return spec?.[\"x-clicky\"];\n}\n\nexport function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[] {\n  return getClickySpecMeta(spec)?.surfaces ?? [];\n}\n\nexport function getOperationClickyMeta(\n  operation: Pick<ResolvedOperation, \"operation\">,\n): ClickyOperationMeta | undefined {\n  return operation.operation[\"x-clicky\"];\n}\n\nexport function filterOperationsBySurface(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  if (!surfaceKey) return [];\n  return operations.filter(\n    (operation) => getOperationClickyMeta(operation)?.surface === surfaceKey,\n  );\n}\n\nexport function findSurfaceOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n  predicate: (meta: ClickyOperationMeta) => boolean,\n): ResolvedOperation | undefined {\n  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && predicate(meta);\n  });\n}\n\nexport function findSurfaceListOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"list\" && meta.scope === \"collection\",\n  );\n}\n\nexport function findSurfaceDetailOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"get\" && meta.scope === \"entity\",\n  );\n}\n\nexport function findSurfaceCollectionActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"collection\" && meta.verb !== \"list\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized) over\n// the OpenAPI summary, which is often a full sentence. Without surface metadata\n// (a non-surface operation) it falls back to the summary, then the\n// operationId/path, so a button always has a label.\nexport function surfaceActionLabel(operation: ResolvedOperation): string {\n  const meta = getOperationClickyMeta(operation);\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  return operation.operation.summary || operation.operation.operationId || operation.path;\n}\n\nexport function findSurfaceEntityActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"entity\" && meta.verb !== \"get\";\n  });\n}\n\nexport function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition {\n  return {\n    key: surface.key,\n    title: surface.title,\n    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,\n    ...(surface.icon ? { icon: surface.icon } : {}),\n  };\n}\n"],"names":[],"mappings":";;AASO,SAAS,kBAAkB,MAA2D;AAC3F,SAAO,6BAAO;AAChB;AAEO,SAAS,kBAAkB,MAAgD;;AAChF,WAAO,uBAAkB,IAAI,MAAtB,mBAAyB,aAAY,CAAA;AAC9C;AAEO,SAAS,uBACd,WACiC;AACjC,SAAO,UAAU,UAAU,UAAU;AACvC;AAEO,SAAS,0BACd,YACA,YACqB;AACrB,MAAI,CAAC,WAAY,QAAO,CAAA;AACxB,SAAO,WAAW;AAAA,IAChB,CAAC,cAAA;;AAAc,2CAAuB,SAAS,MAAhC,mBAAmC,aAAY;AAAA;AAAA,EAAA;AAElE;AAEO,SAAS,qBACd,YACA,YACA,WAC+B;AAC/B,SAAO,0BAA0B,YAAY,UAAU,EAAE,KAAK,CAAC,cAAc;AAC3E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,UAAU,IAAI;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU;AAAA,EAAA;AAErD;AAEO,SAAS,2BACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,SAAS,KAAK,UAAU;AAAA,EAAA;AAEpD;AAEO,SAAS,6BACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,gBAAgB,KAAK,SAAS;AAAA,EACtE,CAAC;AACH;AAMO,SAAS,mBAAmB,WAAsC;;AACvE,QAAM,OAAO,uBAAuB,SAAS;AAC7C,QAAM,UAAQ,kCAAM,eAAN,mBAAkB,aAAU,kCAAM,SAAN,mBAAY;AACtD,MAAI,SAAS,UAAU,UAAU;AAC/B,WAAO,MAAM,OAAO,CAAC,EAAE,gBAAgB,MAAM,MAAM,CAAC;AAAA,EACtD;AACA,SAAO,UAAU,UAAU,WAAW,UAAU,UAAU,eAAe,UAAU;AACrF;AAEO,SAAS,yBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,YAAY,KAAK,SAAS;AAAA,EAClE,CAAC;AACH;AAEO,SAAS,sBAAsB,SAA0C;AAC9E,SAAO;AAAA,IACL,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ,eAAe,UAAU,QAAQ,MAAM,aAAa;AAAA,IACzE,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAA,IAAS,CAAA;AAAA,EAAC;AAEjD;;;;;;;;;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"clickyMetadata.d.ts","sourceRoot":"","sources":["../../src/rpc/clickyMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,EAAE,CAEhF;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC9C,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,GAChD,iBAAiB,GAAG,SAAS,CAK/B;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAM9E"}
+{"version":3,"file":"clickyMetadata.d.ts","sourceRoot":"","sources":["../../src/rpc/clickyMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAE3F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,EAAE,CAEhF;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAC9C,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,GAChD,iBAAiB,GAAG,SAAS,CAK/B;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAOvE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAO9E"}

package/dist/rpc/clickyMetadata.js

@@ -62,7 +62,8 @@ function makeSurfaceDefinition(surface) {
   return {
     key: surface.key,
     title: surface.title,
-    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`
+    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,
+    ...surface.icon ? { icon: surface.icon } : {}
   };
 }
 export {

package/dist/rpc/clickyMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"clickyMetadata.js","sources":["../../src/rpc/clickyMetadata.ts"],"sourcesContent":["import type {\n  ClickyOperationMeta,\n  ClickySpecMeta,\n  ClickySurface,\n  DomainDefinition,\n  OpenAPISpec,\n  ResolvedOperation,\n} from \"./types\";\n\nexport function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined {\n  return spec?.[\"x-clicky\"];\n}\n\nexport function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[] {\n  return getClickySpecMeta(spec)?.surfaces ?? [];\n}\n\nexport function getOperationClickyMeta(\n  operation: Pick<ResolvedOperation, \"operation\">,\n): ClickyOperationMeta | undefined {\n  return operation.operation[\"x-clicky\"];\n}\n\nexport function filterOperationsBySurface(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  if (!surfaceKey) return [];\n  return operations.filter(\n    (operation) => getOperationClickyMeta(operation)?.surface === surfaceKey,\n  );\n}\n\nexport function findSurfaceOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n  predicate: (meta: ClickyOperationMeta) => boolean,\n): ResolvedOperation | undefined {\n  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && predicate(meta);\n  });\n}\n\nexport function findSurfaceListOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"list\" && meta.scope === \"collection\",\n  );\n}\n\nexport function findSurfaceDetailOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"get\" && meta.scope === \"entity\",\n  );\n}\n\nexport function findSurfaceCollectionActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"collection\" && meta.verb !== \"list\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized) over\n// the OpenAPI summary, which is often a full sentence. Without surface metadata\n// (a non-surface operation) it falls back to the summary, then the\n// operationId/path, so a button always has a label.\nexport function surfaceActionLabel(operation: ResolvedOperation): string {\n  const meta = getOperationClickyMeta(operation);\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  return operation.operation.summary || operation.operation.operationId || operation.path;\n}\n\nexport function findSurfaceEntityActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"entity\" && meta.verb !== \"get\";\n  });\n}\n\nexport function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition {\n  return {\n    key: surface.key,\n    title: surface.title,\n    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,\n  };\n}\n"],"names":[],"mappings":"AASO,SAAS,kBAAkB,MAA2D;AAC3F,SAAO,6BAAO;AAChB;AAEO,SAAS,kBAAkB,MAAgD;AAJ3E;AAKL,WAAO,uBAAkB,IAAI,MAAtB,mBAAyB,aAAY,CAAA;AAC9C;AAEO,SAAS,uBACd,WACiC;AACjC,SAAO,UAAU,UAAU,UAAU;AACvC;AAEO,SAAS,0BACd,YACA,YACqB;AACrB,MAAI,CAAC,WAAY,QAAO,CAAA;AACxB,SAAO,WAAW;AAAA,IAChB,CAAC,cAAA;AApBE;AAoBY,2CAAuB,SAAS,MAAhC,mBAAmC,aAAY;AAAA;AAAA,EAAA;AAElE;AAEO,SAAS,qBACd,YACA,YACA,WAC+B;AAC/B,SAAO,0BAA0B,YAAY,UAAU,EAAE,KAAK,CAAC,cAAc;AAC3E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,UAAU,IAAI;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU;AAAA,EAAA;AAErD;AAEO,SAAS,2BACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,SAAS,KAAK,UAAU;AAAA,EAAA;AAEpD;AAEO,SAAS,6BACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,gBAAgB,KAAK,SAAS;AAAA,EACtE,CAAC;AACH;AAMO,SAAS,mBAAmB,WAAsC;AAvElE;AAwEL,QAAM,OAAO,uBAAuB,SAAS;AAC7C,QAAM,UAAQ,kCAAM,eAAN,mBAAkB,aAAU,kCAAM,SAAN,mBAAY;AACtD,MAAI,SAAS,UAAU,UAAU;AAC/B,WAAO,MAAM,OAAO,CAAC,EAAE,gBAAgB,MAAM,MAAM,CAAC;AAAA,EACtD;AACA,SAAO,UAAU,UAAU,WAAW,UAAU,UAAU,eAAe,UAAU;AACrF;AAEO,SAAS,yBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,YAAY,KAAK,SAAS;AAAA,EAClE,CAAC;AACH;AAEO,SAAS,sBAAsB,SAA0C;AAC9E,SAAO;AAAA,IACL,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ,eAAe,UAAU,QAAQ,MAAM,aAAa;AAAA,EAAA;AAE7E;"}
+{"version":3,"file":"clickyMetadata.js","sources":["../../src/rpc/clickyMetadata.ts"],"sourcesContent":["import type {\n  ClickyOperationMeta,\n  ClickySpecMeta,\n  ClickySurface,\n  DomainDefinition,\n  OpenAPISpec,\n  ResolvedOperation,\n} from \"./types\";\n\nexport function getClickySpecMeta(spec: OpenAPISpec | undefined): ClickySpecMeta | undefined {\n  return spec?.[\"x-clicky\"];\n}\n\nexport function getClickySurfaces(spec: OpenAPISpec | undefined): ClickySurface[] {\n  return getClickySpecMeta(spec)?.surfaces ?? [];\n}\n\nexport function getOperationClickyMeta(\n  operation: Pick<ResolvedOperation, \"operation\">,\n): ClickyOperationMeta | undefined {\n  return operation.operation[\"x-clicky\"];\n}\n\nexport function filterOperationsBySurface(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  if (!surfaceKey) return [];\n  return operations.filter(\n    (operation) => getOperationClickyMeta(operation)?.surface === surfaceKey,\n  );\n}\n\nexport function findSurfaceOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n  predicate: (meta: ClickyOperationMeta) => boolean,\n): ResolvedOperation | undefined {\n  return filterOperationsBySurface(operations, surfaceKey).find((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && predicate(meta);\n  });\n}\n\nexport function findSurfaceListOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"list\" && meta.scope === \"collection\",\n  );\n}\n\nexport function findSurfaceDetailOperation(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation | undefined {\n  return findSurfaceOperation(\n    operations,\n    surfaceKey,\n    (meta) => meta.verb === \"get\" && meta.scope === \"entity\",\n  );\n}\n\nexport function findSurfaceCollectionActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"collection\" && meta.verb !== \"list\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized) over\n// the OpenAPI summary, which is often a full sentence. Without surface metadata\n// (a non-surface operation) it falls back to the summary, then the\n// operationId/path, so a button always has a label.\nexport function surfaceActionLabel(operation: ResolvedOperation): string {\n  const meta = getOperationClickyMeta(operation);\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  return operation.operation.summary || operation.operation.operationId || operation.path;\n}\n\nexport function findSurfaceEntityActions(\n  operations: ResolvedOperation[],\n  surfaceKey: string | undefined,\n): ResolvedOperation[] {\n  return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {\n    const meta = getOperationClickyMeta(operation);\n    return meta != null && meta.scope === \"entity\" && meta.verb !== \"get\";\n  });\n}\n\nexport function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition {\n  return {\n    key: surface.key,\n    title: surface.title,\n    description: surface.description || `Manage ${surface.title.toLowerCase()} resources.`,\n    ...(surface.icon ? { icon: surface.icon } : {}),\n  };\n}\n"],"names":[],"mappings":"AASO,SAAS,kBAAkB,MAA2D;AAC3F,SAAO,6BAAO;AAChB;AAEO,SAAS,kBAAkB,MAAgD;AAJ3E;AAKL,WAAO,uBAAkB,IAAI,MAAtB,mBAAyB,aAAY,CAAA;AAC9C;AAEO,SAAS,uBACd,WACiC;AACjC,SAAO,UAAU,UAAU,UAAU;AACvC;AAEO,SAAS,0BACd,YACA,YACqB;AACrB,MAAI,CAAC,WAAY,QAAO,CAAA;AACxB,SAAO,WAAW;AAAA,IAChB,CAAC,cAAA;AApBE;AAoBY,2CAAuB,SAAS,MAAhC,mBAAmC,aAAY;AAAA;AAAA,EAAA;AAElE;AAEO,SAAS,qBACd,YACA,YACA,WAC+B;AAC/B,SAAO,0BAA0B,YAAY,UAAU,EAAE,KAAK,CAAC,cAAc;AAC3E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,UAAU,IAAI;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,yBACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,UAAU;AAAA,EAAA;AAErD;AAEO,SAAS,2BACd,YACA,YAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,CAAC,SAAS,KAAK,SAAS,SAAS,KAAK,UAAU;AAAA,EAAA;AAEpD;AAEO,SAAS,6BACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,gBAAgB,KAAK,SAAS;AAAA,EACtE,CAAC;AACH;AAMO,SAAS,mBAAmB,WAAsC;AAvElE;AAwEL,QAAM,OAAO,uBAAuB,SAAS;AAC7C,QAAM,UAAQ,kCAAM,eAAN,mBAAkB,aAAU,kCAAM,SAAN,mBAAY;AACtD,MAAI,SAAS,UAAU,UAAU;AAC/B,WAAO,MAAM,OAAO,CAAC,EAAE,gBAAgB,MAAM,MAAM,CAAC;AAAA,EACtD;AACA,SAAO,UAAU,UAAU,WAAW,UAAU,UAAU,eAAe,UAAU;AACrF;AAEO,SAAS,yBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,UAAU,YAAY,KAAK,SAAS;AAAA,EAClE,CAAC;AACH;AAEO,SAAS,sBAAsB,SAA0C;AAC9E,SAAO;AAAA,IACL,KAAK,QAAQ;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ,eAAe,UAAU,QAAQ,MAAM,aAAa;AAAA,IACzE,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAA,IAAS,CAAA;AAAA,EAAC;AAEjD;"}

package/dist/rpc/rpc-story-fixtures/orders.fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orders.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/orders.fixture.ts"],"names":[],"mappings":"AAKA,OAAO,EAUL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAgH3B,eAAO,MAAM,cAAc,EAAE,cAW5B,CAAC"}
+{"version":3,"file":"orders.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/orders.fixture.ts"],"names":[],"mappings":"AAQA,OAAO,EAUL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAgI3B,eAAO,MAAM,cAAc,EAAE,cAY5B,CAAC"}

package/dist/rpc/rpc-story-fixtures/services.fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/services.fixture.ts"],"names":[],"mappings":"AAKA,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAmG3B,eAAO,MAAM,gBAAgB,EAAE,cAW9B,CAAC"}
+{"version":3,"file":"services.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/services.fixture.ts"],"names":[],"mappings":"AAQA,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AA0H3B,eAAO,MAAM,gBAAgB,EAAE,cAY9B,CAAC"}

package/dist/rpc/rpc-story-fixtures/surface-fixture.d.ts

@@ -1,14 +1,37 @@
 import { ClickyColumn, ClickyField, ClickyNode, ClickyRow, ClickyStyle } from '../../data/Clicky';
 import { ClickySurface, ExecutionResponse, OpenAPIOperation } from '../types';
+/** Page size used when an operation declares no `limit` value. Mirrors the
+ *  `dataTablePaginationFromForm` fallback so the footer and the fake backend
+ *  agree on the first page. */
+export declare const DEFAULT_PAGE_LIMIT = 25;
 export type SurfaceFixture = {
     surface: ClickySurface;
     /** Spec paths contributed by this surface; merged into SAMPLE_SPEC.paths. */
     paths: Record<string, Record<string, OpenAPIOperation>>;
-    /** The collection list response (a Clicky `table` document). */
-    listResponse: ExecutionResponse;
+    /** Columns of the collection list table. */
+    listColumns: ClickyColumn[];
+    /**
+     * The full server-side row set. The fake client slices this per the request's
+     * `limit`/`offset` rather than returning it whole, so stories exercise the
+     * same remote-pagination path as a real clicky-rpc backend.
+     */
+    listRows: ClickyRow[];
     /** Per-entity-id detail responses (Clicky `map` documents). */
     detailById: Record<string, ExecutionResponse>;
 };
+/**
+ * Builds the Clicky list document for a single page plus the pagination
+ * envelope. A real backend reports these as `X-Total-Count` / `X-Page-Limit` /
+ * `X-Page-Offset` headers, which `createOperationsApiClient` parses into
+ * `ExecutionResponse.pagination`; the fake client sets the field directly.
+ */
+export declare function listPage(fixture: Pick<SurfaceFixture, "listColumns" | "listRows">, limit: number, offset: number): ExecutionResponse;
+/** Cyclic pick that satisfies `noUncheckedIndexedAccess`; throws on an empty list
+ *  rather than returning a silent placeholder. */
+export declare function pick<T>(values: readonly T[], index: number): T;
+/** Deterministic ISO timestamp `steps` slots after a fixed base — fixtures must
+ *  never depend on the wall clock or a story would re-render differently. */
+export declare function fixtureTimestamp(steps: number): string;
 export declare function text(value: string, style?: ClickyStyle): ClickyNode;
 /** Monospace text — for ids, amounts, versions. */
 export declare function mono(value: string): ClickyNode;

package/dist/rpc/rpc-story-fixtures/surface-fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/surface-fixture.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEnF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,gEAAgE;IAChE,YAAY,EAAE,iBAAiB,CAAC;IAChC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C,CAAC;AAEF,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,UAAU,CAEnE;AAED,mDAAmD;AACnD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE9C;AAeD,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAGhD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAE7E;AAED,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAK9D;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CASrF;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,UAAU,CAE5E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAO7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAElE"}
+{"version":3,"file":"surface-fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/surface-fixture.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEnF;;+BAE+B;AAC/B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,4CAA4C;IAC5C,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,UAAU,CAAC,EACzD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,CAQnB;AAED;kDACkD;AAClD,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAI9D;AAED;6EAC6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,UAAU,CAEnE;AAED,mDAAmD;AACnD,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE9C;AAeD,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAGhD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAE7E;AAED,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAK9D;AAKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CASrF;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,UAAU,CAE5E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAO7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAElE"}

package/dist/rpc/rpc-story-fixtures/widgets.fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgets.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/widgets.fixture.ts"],"names":[],"mappings":"AAIA,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAkG3B,eAAO,MAAM,eAAe,EAAE,cAW7B,CAAC"}
+{"version":3,"file":"widgets.fixture.d.ts","sourceRoot":"","sources":["../../../src/rpc/rpc-story-fixtures/widgets.fixture.ts"],"names":[],"mappings":"AAQA,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAoI3B,eAAO,MAAM,eAAe,EAAE,cAY7B,CAAC"}

package/dist/rpc/rpc-story.fixtures.d.ts

@@ -7,7 +7,8 @@ export declare const FAKE_CLIENT: OperationsApiClient;
 /** The spec's operations flattened to the ResolvedOperation list components use. */
 export declare const SAMPLE_OPERATIONS: ResolvedOperation[];
 /** Widgets list/detail responses — kept as named exports for the focused stories
- *  (CommandOutput, OperationEntityPage) that render a single document. */
+ *  (CommandOutput, OperationEntityPage) that render a single document. The list
+ *  export is the first page, matching what an unparameterised request returns. */
 export declare const SAMPLE_LIST_RESPONSE: ExecutionResponse;
 export declare const SAMPLE_DETAIL_RESPONSE: ExecutionResponse;
 export declare const WIDGET_DEFINITION: DomainDefinition;

package/dist/rpc/rpc-story.fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-story.fixtures.d.ts","sourceRoot":"","sources":["../../src/rpc/rpc-story.fixtures.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAQnG,eAAO,MAAM,WAAW,EAAE,WAKzB,CAAC;AAaF,eAAO,MAAM,WAAW,EAAE,mBAsBzB,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAGhD,CAAC;AAEF;0EAC0E;AAC1E,eAAO,MAAM,oBAAoB,EAAE,iBAAgD,CAAC;AAGpF,eAAO,MAAM,sBAAsB,EAAE,iBAAgC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,EAAE,gBAM/B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,YAAY,CAE3F"}
+{"version":3,"file":"rpc-story.fixtures.d.ts","sourceRoot":"","sources":["../../src/rpc/rpc-story.fixtures.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAYnG,eAAO,MAAM,WAAW,EAAE,WAKzB,CAAC;AAsBF,eAAO,MAAM,WAAW,EAAE,mBAgCzB,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAGhD,CAAC;AAEF;;kFAEkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,iBAIlC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,iBAAgC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,EAAE,gBAM/B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,YAAY,CAE3F"}

package/dist/rpc/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":";;AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoHO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}
+{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  icon?: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":";;AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAqHO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}

package/dist/rpc/types.d.ts

@@ -97,6 +97,7 @@ export interface DomainDefinition {
     key: string;
     title: string;
     description: string;
+    icon?: string;
     emptyTitle?: string;
     emptyDescription?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}

package/dist/rpc/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoHO,SAAS,kBAAkB,GAA8B;AAxHzD;AAyHL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}
+{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  icon?: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AAmFO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAqHO,SAAS,kBAAkB,GAA8B;AAzHzD;AA0HL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}