@flanksource/clicky-ui 0.3.15 → 0.3.17

package/dist/rpc/OperationResultView.js

@@ -1,8 +1,21 @@
 import { jsx } from "react/jsx-runtime";
+import { DataTable } from "../data/DataTable.js";
+import { cn } from "../lib/utils.js";
 import { ExecutionResult } from "./ExecutionResult.js";
 import { useRowDetailNavigation } from "./rowNavigation.js";
+const ERROR_RESULT_COLUMNS = [
+  {
+    key: "error",
+    label: "Error",
+    grow: true,
+    sortable: false,
+    resizable: false,
+    hideable: false
+  }
+];
 function OperationResultView({
   response,
+  error,
   loading,
   loadingMessage,
   emptyMessage,
@@ -16,6 +29,35 @@ function OperationResultView({
 }) {
   const rowNav = useRowDetailNavigation(detailOperation);
   const filters = filterConfig == null ? void 0 : filterConfig.filters;
+  if (error != null) {
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: ariaLabel ? "region" : void 0,
+        "aria-label": ariaLabel,
+        className: cn("mt-3 flex min-h-0 flex-col", className),
+        children: /* @__PURE__ */ jsx(
+          DataTable,
+          {
+            data: [],
+            columns: ERROR_RESULT_COLUMNS,
+            error,
+            className: "h-full",
+            showGlobalFilter: false,
+            showDensityControl: false,
+            hideableColumns: false,
+            resizableColumns: false,
+            persistColumnWidths: false,
+            persistColumnVisibility: false,
+            persistDensity: false,
+            ...filters && filters.length > 0 ? { externalFilters: filters } : {},
+            ...(filterConfig == null ? void 0 : filterConfig.search) ? { externalSearch: filterConfig.search } : {},
+            ...(filterConfig == null ? void 0 : filterConfig.timeRange) ? { externalTimeRange: filterConfig.timeRange } : {}
+          }
+        )
+      }
+    );
+  }
   return /* @__PURE__ */ jsx(
     ExecutionResult,
     {

package/dist/rpc/OperationResultView.js.map

@@ -1 +1 @@
-{"version":3,"file":"OperationResultView.js","sources":["../../src/rpc/OperationResultView.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarRangeProps,\n  FilterBarSearchProps,\n} from \"../components/FilterBar\";\nimport type { DataTablePagination } from \"../data/DataTable\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n} from \"../data/Clicky\";\nimport { ExecutionResult } from \"./ExecutionResult\";\nimport { useRowDetailNavigation } from \"./rowNavigation\";\nimport type { ExecutionResponse, ResolvedOperation } from \"./types\";\n\n// ResultRenderContext is handed to a host-supplied resultRenderer so it can\n// replace the default result surface for selected entities (e.g. render a\n// LogsTable for trace/log profiles). `defaultView` is the standard\n// OperationResultView element; return it unchanged to keep the default.\nexport type ResultRenderContext = {\n  surfaceKey?: string;\n  response: ExecutionResponse | null;\n  defaultView: ReactNode;\n};\n\n// ResultRenderer lets the host app swap the result presentation per surface. It\n// receives the current surface key, the raw response, and the default view, and\n// returns whatever node should render in its place.\nexport type ResultRenderer = (ctx: ResultRenderContext) => ReactNode;\n\n// In-table filter inputs for the result table — mirrors what\n// parametersToFormConfig produces, surfaced through the DataTable's own\n// FilterBar so the filter UI renders identically on every result surface.\nexport type OperationResultFilterConfig = {\n  filters?: FilterBarFilter[];\n  search?: FilterBarSearchProps;\n  timeRange?: FilterBarRangeProps;\n};\n\nexport type OperationResultViewProps = {\n  response: ExecutionResponse | null;\n  loading?: boolean;\n  loadingMessage?: string;\n  emptyMessage?: string;\n  ariaLabel?: string;\n  className?: string;\n  commandRuntime?: ClickyCommandRuntime;\n  // When set, rows navigate to the entity detail page (/<surface>/<id>).\n  detailOperation?: ResolvedOperation | undefined;\n  filterConfig?: OperationResultFilterConfig;\n  pagination?: DataTablePagination;\n  download?: ClickyDownloadOptions;\n};\n\n// OperationResultView is the single result surface rendered by both the entity\n// list catalog and the operation runner. It renders the clicky result table\n// with its in-table FilterBar, the View/Download menu (automatic via the\n// response's requestUrl), pagination, and row→detail navigation — so the\n// surface looks and behaves identically wherever a result is shown.\nexport function OperationResultView({\n  response,\n  loading,\n  loadingMessage,\n  emptyMessage,\n  ariaLabel,\n  className,\n  commandRuntime,\n  detailOperation,\n  filterConfig,\n  pagination,\n  download,\n}: OperationResultViewProps) {\n  const rowNav = useRowDetailNavigation(detailOperation);\n  const filters = filterConfig?.filters;\n\n  return (\n    <ExecutionResult\n      response={response}\n      {...(loading !== undefined ? { loading } : {})}\n      {...(loadingMessage ? { loadingMessage } : {})}\n      {...(emptyMessage ? { emptyMessage } : {})}\n      {...(ariaLabel ? { ariaLabel } : {})}\n      {...(className ? { className } : {})}\n      {...(commandRuntime ? { commandRuntime } : {})}\n      {...(detailOperation\n        ? {\n            getTableRowHref: rowNav.getRowHref,\n            onTableRowClick: rowNav.onRowClick,\n            isTableRowClickable: rowNav.isRowClickable,\n          }\n        : {})}\n      {...(filters && filters.length > 0 ? { externalFilters: filters } : {})}\n      {...(filterConfig?.search ? { search: filterConfig.search } : {})}\n      {...(filterConfig?.timeRange\n        ? { timeRange: filterConfig.timeRange }\n        : {})}\n      {...(pagination ? { pagination } : {})}\n      {...(download ? { download } : {})}\n    />\n  );\n}\n"],"names":[],"mappings":";;;AA2DO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6B;AAC3B,QAAM,SAAS,uBAAuB,eAAe;AACrD,QAAM,UAAU,6CAAc;AAE9B,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAA,IAAY,CAAA;AAAA,MAC1C,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,MAC1C,GAAI,eAAe,EAAE,aAAA,IAAiB,CAAA;AAAA,MACtC,GAAI,YAAY,EAAE,UAAA,IAAc,CAAA;AAAA,MAChC,GAAI,YAAY,EAAE,UAAA,IAAc,CAAA;AAAA,MAChC,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,MAC1C,GAAI,kBACD;AAAA,QACE,iBAAiB,OAAO;AAAA,QACxB,iBAAiB,OAAO;AAAA,QACxB,qBAAqB,OAAO;AAAA,MAAA,IAE9B,CAAA;AAAA,MACH,GAAI,WAAW,QAAQ,SAAS,IAAI,EAAE,iBAAiB,QAAA,IAAY,CAAA;AAAA,MACnE,IAAI,6CAAc,UAAS,EAAE,QAAQ,aAAa,OAAA,IAAW,CAAA;AAAA,MAC7D,IAAI,6CAAc,aACf,EAAE,WAAW,aAAa,UAAA,IAC1B,CAAA;AAAA,MACH,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,MAClC,GAAI,WAAW,EAAE,aAAa,CAAA;AAAA,IAAC;AAAA,EAAA;AAGtC;"}
+{"version":3,"file":"OperationResultView.js","sources":["../../src/rpc/OperationResultView.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarRangeProps,\n  FilterBarSearchProps,\n} from \"../components/FilterBar\";\nimport {\n  DataTable,\n  type DataTableColumn,\n  type DataTablePagination,\n} from \"../data/DataTable\";\nimport type {\n  ClickyCommandRuntime,\n  ClickyDownloadOptions,\n} from \"../data/Clicky\";\nimport { cn } from \"../lib/utils\";\nimport { ExecutionResult } from \"./ExecutionResult\";\nimport { useRowDetailNavigation } from \"./rowNavigation\";\nimport type { ExecutionResponse, ResolvedOperation } from \"./types\";\n\n// ResultRenderContext is handed to a host-supplied resultRenderer so it can\n// replace the default result surface for selected entities (e.g. render a\n// LogsTable for trace/log profiles). `defaultView` is the standard\n// OperationResultView element; return it unchanged to keep the default.\nexport type ResultRenderContext = {\n  surfaceKey?: string;\n  response: ExecutionResponse | null;\n  defaultView: ReactNode;\n};\n\n// ResultRenderer lets the host app swap the result presentation per surface. It\n// receives the current surface key, the raw response, and the default view, and\n// returns whatever node should render in its place.\nexport type ResultRenderer = (ctx: ResultRenderContext) => ReactNode;\n\n// In-table filter inputs for the result table — mirrors what\n// parametersToFormConfig produces, surfaced through the DataTable's own\n// FilterBar so the filter UI renders identically on every result surface.\nexport type OperationResultFilterConfig = {\n  filters?: FilterBarFilter[];\n  search?: FilterBarSearchProps;\n  timeRange?: FilterBarRangeProps;\n};\n\nexport type OperationResultViewProps = {\n  response: ExecutionResponse | null;\n  error?: ReactNode;\n  loading?: boolean;\n  loadingMessage?: string;\n  emptyMessage?: string;\n  ariaLabel?: string;\n  className?: string;\n  commandRuntime?: ClickyCommandRuntime;\n  // When set, rows navigate to the entity detail page (/<surface>/<id>).\n  detailOperation?: ResolvedOperation | undefined;\n  filterConfig?: OperationResultFilterConfig;\n  pagination?: DataTablePagination;\n  download?: ClickyDownloadOptions;\n};\n\ntype ErrorResultRow = {\n  error: string;\n};\n\nconst ERROR_RESULT_COLUMNS: DataTableColumn<ErrorResultRow>[] = [\n  {\n    key: \"error\",\n    label: \"Error\",\n    grow: true,\n    sortable: false,\n    resizable: false,\n    hideable: false,\n  },\n];\n\n// OperationResultView is the single result surface rendered by both the entity\n// list catalog and the operation runner. It renders the clicky result table\n// with its in-table FilterBar, the View/Download menu (automatic via the\n// response's requestUrl), pagination, and row→detail navigation — so the\n// surface looks and behaves identically wherever a result is shown.\nexport function OperationResultView({\n  response,\n  error,\n  loading,\n  loadingMessage,\n  emptyMessage,\n  ariaLabel,\n  className,\n  commandRuntime,\n  detailOperation,\n  filterConfig,\n  pagination,\n  download,\n}: OperationResultViewProps) {\n  const rowNav = useRowDetailNavigation(detailOperation);\n  const filters = filterConfig?.filters;\n\n  if (error != null) {\n    return (\n      <div\n        role={ariaLabel ? \"region\" : undefined}\n        aria-label={ariaLabel}\n        className={cn(\"mt-3 flex min-h-0 flex-col\", className)}\n      >\n        <DataTable<ErrorResultRow>\n          data={[]}\n          columns={ERROR_RESULT_COLUMNS}\n          error={error}\n          className=\"h-full\"\n          showGlobalFilter={false}\n          showDensityControl={false}\n          hideableColumns={false}\n          resizableColumns={false}\n          persistColumnWidths={false}\n          persistColumnVisibility={false}\n          persistDensity={false}\n          {...(filters && filters.length > 0\n            ? { externalFilters: filters }\n            : {})}\n          {...(filterConfig?.search\n            ? { externalSearch: filterConfig.search }\n            : {})}\n          {...(filterConfig?.timeRange\n            ? { externalTimeRange: filterConfig.timeRange }\n            : {})}\n        />\n      </div>\n    );\n  }\n\n  return (\n    <ExecutionResult\n      response={response}\n      {...(loading !== undefined ? { loading } : {})}\n      {...(loadingMessage ? { loadingMessage } : {})}\n      {...(emptyMessage ? { emptyMessage } : {})}\n      {...(ariaLabel ? { ariaLabel } : {})}\n      {...(className ? { className } : {})}\n      {...(commandRuntime ? { commandRuntime } : {})}\n      {...(detailOperation\n        ? {\n            getTableRowHref: rowNav.getRowHref,\n            onTableRowClick: rowNav.onRowClick,\n            isTableRowClickable: rowNav.isRowClickable,\n          }\n        : {})}\n      {...(filters && filters.length > 0 ? { externalFilters: filters } : {})}\n      {...(filterConfig?.search ? { search: filterConfig.search } : {})}\n      {...(filterConfig?.timeRange\n        ? { timeRange: filterConfig.timeRange }\n        : {})}\n      {...(pagination ? { pagination } : {})}\n      {...(download ? { download } : {})}\n    />\n  );\n}\n"],"names":[],"mappings":";;;;;AAgEA,MAAM,uBAA0D;AAAA,EAC9D;AAAA,IACE,KAAK;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,IACN,UAAU;AAAA,IACV,WAAW;AAAA,IACX,UAAU;AAAA,EAAA;AAEd;AAOO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6B;AAC3B,QAAM,SAAS,uBAAuB,eAAe;AACrD,QAAM,UAAU,6CAAc;AAE9B,MAAI,SAAS,MAAM;AACjB,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAM,YAAY,WAAW;AAAA,QAC7B,cAAY;AAAA,QACZ,WAAW,GAAG,8BAA8B,SAAS;AAAA,QAErD,UAAA;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAM,CAAA;AAAA,YACN,SAAS;AAAA,YACT;AAAA,YACA,WAAU;AAAA,YACV,kBAAkB;AAAA,YAClB,oBAAoB;AAAA,YACpB,iBAAiB;AAAA,YACjB,kBAAkB;AAAA,YAClB,qBAAqB;AAAA,YACrB,yBAAyB;AAAA,YACzB,gBAAgB;AAAA,YACf,GAAI,WAAW,QAAQ,SAAS,IAC7B,EAAE,iBAAiB,QAAA,IACnB,CAAA;AAAA,YACH,IAAI,6CAAc,UACf,EAAE,gBAAgB,aAAa,OAAA,IAC/B,CAAA;AAAA,YACH,IAAI,6CAAc,aACf,EAAE,mBAAmB,aAAa,UAAA,IAClC,CAAA;AAAA,UAAC;AAAA,QAAA;AAAA,MACP;AAAA,IAAA;AAAA,EAGN;AAEA,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAA,IAAY,CAAA;AAAA,MAC1C,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,MAC1C,GAAI,eAAe,EAAE,aAAA,IAAiB,CAAA;AAAA,MACtC,GAAI,YAAY,EAAE,UAAA,IAAc,CAAA;AAAA,MAChC,GAAI,YAAY,EAAE,UAAA,IAAc,CAAA;AAAA,MAChC,GAAI,iBAAiB,EAAE,eAAA,IAAmB,CAAA;AAAA,MAC1C,GAAI,kBACD;AAAA,QACE,iBAAiB,OAAO;AAAA,QACxB,iBAAiB,OAAO;AAAA,QACxB,qBAAqB,OAAO;AAAA,MAAA,IAE9B,CAAA;AAAA,MACH,GAAI,WAAW,QAAQ,SAAS,IAAI,EAAE,iBAAiB,QAAA,IAAY,CAAA;AAAA,MACnE,IAAI,6CAAc,UAAS,EAAE,QAAQ,aAAa,OAAA,IAAW,CAAA;AAAA,MAC7D,IAAI,6CAAc,aACf,EAAE,WAAW,aAAa,UAAA,IAC1B,CAAA;AAAA,MACH,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,MAClC,GAAI,WAAW,EAAE,aAAa,CAAA;AAAA,IAAC;AAAA,EAAA;AAGtC;"}

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;"}