@flanksource/clicky-ui 0.2.13 → 0.2.15

package/dist/rpc/classify.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify.js","sources":["../../src/rpc/classify.ts"],"sourcesContent":["import { isPositionalParam, type ExecutionResponse, type ResolvedOperation } from \"./types\";\n\n// findListEndpoint picks the canonical list operation for a set of\n// entities. Clicky-rpc auto-registers `<entity> list` commands and mints\n// operationIds of the form `<entity>_list`. Matching exactly on that form\n// keeps the default table view deterministic — a non-list GET never gets\n// promoted to list by accident.\nexport function findListEndpoint(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation | undefined {\n  const wanted = new Set(entities.map((e) => `${e}_list`));\n  if (wanted.size === 0) return undefined;\n  return operations.find(\n    (op) =>\n      op.method === \"get\" && !!op.operation.operationId && wanted.has(op.operation.operationId),\n  );\n}\n\nexport function findDetailEndpoint(operations: ResolvedOperation[]): ResolvedOperation | undefined {\n  return operations.find(\n    (op) =>\n      op.method === \"get\" &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n}\n\nfunction splitPath(path: string) {\n  return path.split(\"/\").filter(Boolean);\n}\n\n// findDetailEndpointForList prefers the detail GET that belongs to the\n// resolved list route. This keeps sibling surfaces that share tags\n// (for example `stack_*` and `admin_stack_*`) from cross-contaminating\n// default entity-detail routing.\nexport function findDetailEndpointForList(\n  operations: ResolvedOperation[],\n  listEndpoint: ResolvedOperation | undefined,\n): ResolvedOperation | undefined {\n  if (!listEndpoint) {\n    return findDetailEndpoint(operations);\n  }\n\n  const baseSegments = splitPath(listEndpoint.path);\n  const candidates = operations.filter(\n    (op) =>\n      op.method === \"get\" &&\n      op.path !== listEndpoint.path &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n\n  const exactChild = candidates.find((op) => {\n    const segments = splitPath(op.path);\n    if (segments.length !== baseSegments.length + 1) {\n      return false;\n    }\n    return baseSegments.every((segment, index) => segments[index] === segment);\n  });\n\n  if (exactChild) {\n    return exactChild;\n  }\n\n  const descendant = candidates.find((op) => op.path.startsWith(`${listEndpoint.path}/`));\n  return descendant ?? findDetailEndpoint(operations);\n}\n\nexport function parseJsonBody(response: ExecutionResponse | undefined): unknown {\n  if (!response) return null;\n  const text = response.stdout || response.output || \"\";\n  if (!text.trim()) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return null;\n  }\n}\n\nexport function normalizeRows(data: unknown): Record<string, unknown>[] {\n  if (Array.isArray(data)) return data as Record<string, unknown>[];\n  if (data && typeof data === \"object\") {\n    for (const value of Object.values(data)) {\n      if (Array.isArray(value)) return value as Record<string, unknown>[];\n    }\n  }\n  return [];\n}\n\n// filterOperationsByDomain returns operations whose OpenAPI `tags` intersect\n// the given entity list. Clicky-rpc's converter stamps the parent command\n// name into `op.tags`, so passing the entities that belong to a domain\n// yields that domain's operations.\nexport function filterOperationsByDomain(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation[] {\n  if (entities.length === 0) return [];\n  const wanted = new Set(entities);\n  return operations.filter((op) => (op.operation.tags ?? []).some((tag) => wanted.has(tag)));\n}\n"],"names":[],"mappings":";AAOO,SAAS,iBACd,YACA,UAC+B;AAC/B,QAAM,SAAS,IAAI,IAAI,SAAS,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC;AACvD,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,SAAO,WAAW;AAAA,IAChB,CAAC,OACC,GAAG,WAAW,SAAS,CAAC,CAAC,GAAG,UAAU,eAAe,OAAO,IAAI,GAAG,UAAU,WAAW;AAAA,EAAA;AAE9F;AAEO,SAAS,mBAAmB,YAAgE;AACjG,SAAO,WAAW;AAAA,IAChB,CAAC,OAAA;;AACC,gBAAG,WAAW,WACd,QAAG,UAAU,eAAb,mBAAyB,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU,kBAAkB,CAAC;AAAA;AAAA,EAAC;AAElF;AAEA,SAAS,UAAU,MAAc;AAC/B,SAAO,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AACvC;AAMO,SAAS,0BACd,YACA,cAC+B;AAC/B,MAAI,CAAC,cAAc;AACjB,WAAO,mBAAmB,UAAU;AAAA,EACtC;AAEA,QAAM,eAAe,UAAU,aAAa,IAAI;AAChD,QAAM,aAAa,WAAW;AAAA,IAC5B,CAAC;;AACC,gBAAG,WAAW,SACd,GAAG,SAAS,aAAa,UACzB,QAAG,UAAU,eAAb,mBAAyB,KAAK,CAAC,MAAM,EAAE,OAAO,UAAU,kBAAkB,CAAC;AAAA;AAAA,EAAC;AAGhF,QAAM,aAAa,WAAW,KAAK,CAAC,OAAO;AACzC,UAAM,WAAW,UAAU,GAAG,IAAI;AAClC,QAAI,SAAS,WAAW,aAAa,SAAS,GAAG;AAC/C,aAAO;AAAA,IACT;AACA,WAAO,aAAa,MAAM,CAAC,SAAS,UAAU,SAAS,KAAK,MAAM,OAAO;AAAA,EAC3E,CAAC;AAED,MAAI,YAAY;AACd,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,WAAW,KAAK,CAAC,OAAO,GAAG,KAAK,WAAW,GAAG,aAAa,IAAI,GAAG,CAAC;AACtF,SAAO,cAAc,mBAAmB,UAAU;AACpD;AAEO,SAAS,cAAc,UAAkD;AAC9E,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,OAAO,SAAS,UAAU,SAAS,UAAU;AACnD,MAAI,CAAC,KAAK,KAAA,EAAQ,QAAO;AACzB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,cAAc,MAA0C;AACtE,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO;AAChC,MAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,eAAW,SAAS,OAAO,OAAO,IAAI,GAAG;AACvC,UAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AAAA,IACnC;AAAA,EACF;AACA,SAAO,CAAA;AACT;AAMO,SAAS,yBACd,YACA,UACqB;AACrB,MAAI,SAAS,WAAW,EAAG,QAAO,CAAA;AAClC,QAAM,SAAS,IAAI,IAAI,QAAQ;AAC/B,SAAO,WAAW,OAAO,CAAC,QAAQ,GAAG,UAAU,QAAQ,CAAA,GAAI,KAAK,CAAC,QAAQ,OAAO,IAAI,GAAG,CAAC,CAAC;AAC3F;"}
+{"version":3,"file":"classify.js","sources":["../../src/rpc/classify.ts"],"sourcesContent":["import { isPositionalParam, type ExecutionResponse, type ResolvedOperation } from \"./types\";\n\n// findListEndpoint picks the canonical list operation for a set of\n// entities. Clicky-rpc auto-registers `<entity> list` commands and mints\n// operationIds of the form `<entity>_list`. Matching exactly on that form\n// keeps the default table view deterministic — a non-list GET never gets\n// promoted to list by accident.\n//\n// When a `<entity> list` command is promoted onto the bare entity-root\n// (clicky's promoteListToEntityRoot), the collection is exposed instead as\n// `GET /api/v1/<entity>` with operationId `<entity>` and no `_list` suffix.\n// Fall back to that promoted root when no explicit `<entity>_list` exists.\n// A path/positional parameter disqualifies it, so a `<entity>/{id}` detail\n// GET can never be mistaken for the listing.\nexport function findListEndpoint(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation | undefined {\n  if (entities.length === 0) return undefined;\n  const listIds = new Set(entities.map((e) => `${e}_list`));\n  const explicit = operations.find(\n    (op) =>\n      op.method === \"get\" && !!op.operation.operationId && listIds.has(op.operation.operationId),\n  );\n  if (explicit) return explicit;\n\n  const rootIds = new Set(entities);\n  return operations.find(\n    (op) =>\n      op.method === \"get\" &&\n      rootIds.has(op.operation.operationId ?? \"\") &&\n      !op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n}\n\nexport function findDetailEndpoint(operations: ResolvedOperation[]): ResolvedOperation | undefined {\n  return operations.find(\n    (op) =>\n      op.method === \"get\" &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n}\n\nfunction splitPath(path: string) {\n  return path.split(\"/\").filter(Boolean);\n}\n\n// findDetailEndpointForList prefers the detail GET that belongs to the\n// resolved list route. This keeps sibling surfaces that share tags\n// (for example `stack_*` and `admin_stack_*`) from cross-contaminating\n// default entity-detail routing.\nexport function findDetailEndpointForList(\n  operations: ResolvedOperation[],\n  listEndpoint: ResolvedOperation | undefined,\n): ResolvedOperation | undefined {\n  if (!listEndpoint) {\n    return findDetailEndpoint(operations);\n  }\n\n  const baseSegments = splitPath(listEndpoint.path);\n  const candidates = operations.filter(\n    (op) =>\n      op.method === \"get\" &&\n      op.path !== listEndpoint.path &&\n      op.operation.parameters?.some((p) => p.in === \"path\" || isPositionalParam(p)),\n  );\n\n  const exactChild = candidates.find((op) => {\n    const segments = splitPath(op.path);\n    if (segments.length !== baseSegments.length + 1) {\n      return false;\n    }\n    return baseSegments.every((segment, index) => segments[index] === segment);\n  });\n\n  if (exactChild) {\n    return exactChild;\n  }\n\n  const descendant = candidates.find((op) => op.path.startsWith(`${listEndpoint.path}/`));\n  return descendant ?? findDetailEndpoint(operations);\n}\n\nexport function parseJsonBody(response: ExecutionResponse | undefined): unknown {\n  if (!response) return null;\n  const text = response.stdout || response.output || \"\";\n  if (!text.trim()) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return null;\n  }\n}\n\nexport function normalizeRows(data: unknown): Record<string, unknown>[] {\n  if (Array.isArray(data)) return data as Record<string, unknown>[];\n  if (data && typeof data === \"object\") {\n    for (const value of Object.values(data)) {\n      if (Array.isArray(value)) return value as Record<string, unknown>[];\n    }\n  }\n  return [];\n}\n\n// filterOperationsByDomain returns operations whose OpenAPI `tags` intersect\n// the given entity list. Clicky-rpc's converter stamps the parent command\n// name into `op.tags`, so passing the entities that belong to a domain\n// yields that domain's operations.\nexport function filterOperationsByDomain(\n  operations: ResolvedOperation[],\n  entities: string[],\n): ResolvedOperation[] {\n  if (entities.length === 0) return [];\n  const wanted = new Set(entities);\n  return operations.filter((op) => {\n    if ((op.operation.tags ?? []).some((tag) => wanted.has(tag))) return true;\n    // clicky promotes a collection to a bare entity-root GET (operationId\n    // `<entity>`, no tag). Include it so the catalog can resolve the listing.\n    return op.method === \"get\" && wanted.has(op.operation.operationId ?? \"\");\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/clickyMetadata.cjs

@@ -39,12 +39,21 @@ function findSurfaceDetailOperation(operations, surfaceKey) {
     (meta) => meta.verb === "get" && meta.scope === "entity"
   );
 }
-function findSurfaceCollectionActions(operations, surfaceKey) {
+function findSurfaceActions(operations, surfaceKey) {
   return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
     const meta = getOperationClickyMeta(operation);
-    return meta != null && meta.scope === "collection" && meta.verb !== "list";
+    return meta != null && meta.verb !== "list" && meta.verb !== "get";
   });
 }
+function surfaceActionLabel(operation) {
+  var _a, _b;
+  const meta = getOperationClickyMeta(operation);
+  const short = ((_a = meta == null ? void 0 : meta.actionName) == null ? void 0 : _a.trim()) || ((_b = meta == null ? void 0 : meta.verb) == null ? void 0 : _b.trim());
+  if (short && short !== "action") {
+    return short.charAt(0).toUpperCase() + short.slice(1);
+  }
+  return operation.operation.operationId || operation.path;
+}
 function findSurfaceEntityActions(operations, surfaceKey) {
   return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
     const meta = getOperationClickyMeta(operation);
@@ -59,7 +68,7 @@ function makeSurfaceDefinition(surface) {
   };
 }
 exports.filterOperationsBySurface = filterOperationsBySurface;
-exports.findSurfaceCollectionActions = findSurfaceCollectionActions;
+exports.findSurfaceActions = findSurfaceActions;
 exports.findSurfaceDetailOperation = findSurfaceDetailOperation;
 exports.findSurfaceEntityActions = findSurfaceEntityActions;
 exports.findSurfaceListOperation = findSurfaceListOperation;
@@ -68,4 +77,5 @@ exports.getClickySpecMeta = getClickySpecMeta;
 exports.getClickySurfaces = getClickySurfaces;
 exports.getOperationClickyMeta = getOperationClickyMeta;
 exports.makeSurfaceDefinition = makeSurfaceDefinition;
+exports.surfaceActionLabel = surfaceActionLabel;
 //# sourceMappingURL=clickyMetadata.cjs.map

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\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;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// findSurfaceActions returns every runnable action on a surface — both\n// collection-scoped (e.g. create) and entity-scoped (e.g. update/delete, and\n// custom Actions which clicky always annotates scope:\"entity\"). The action bar\n// surfaces these as buttons that open the execution dialog (the dialog collects\n// any id the entity-scoped action needs). Only the list and the entity get are\n// excluded — they drive the table and the row click-through respectively.\nexport function findSurfaceActions(\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.verb !== \"list\" && meta.verb !== \"get\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized)\n// over the OpenAPI summary, which is often a full sentence. Falls back to 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.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;AAkBO,SAAS,mBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,SAAS,UAAU,KAAK,SAAS;AAAA,EAC/D,CAAC;AACH;AAKO,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,eAAe,UAAU;AACtD;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;;;;;;;;;;;;"}

package/dist/rpc/clickyMetadata.d.ts

@@ -7,6 +7,8 @@ export declare function findSurfaceOperation(operations: ResolvedOperation[], su
 export declare function findSurfaceListOperation(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation | undefined;
 export declare function findSurfaceDetailOperation(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation | undefined;
 export declare function findSurfaceCollectionActions(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
+export declare function findSurfaceActions(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
+export declare function surfaceActionLabel(operation: ResolvedOperation): string;
 export declare function findSurfaceEntityActions(operations: ResolvedOperation[], surfaceKey: string | undefined): ResolvedOperation[];
 export declare function makeSurfaceDefinition(surface: ClickySurface): DomainDefinition;
 //# sourceMappingURL=clickyMetadata.d.ts.map

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;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;AAQD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,iBAAiB,EAAE,CAKrB;AAKD,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"}

package/dist/rpc/clickyMetadata.js

@@ -37,12 +37,21 @@ function findSurfaceDetailOperation(operations, surfaceKey) {
     (meta) => meta.verb === "get" && meta.scope === "entity"
   );
 }
-function findSurfaceCollectionActions(operations, surfaceKey) {
+function findSurfaceActions(operations, surfaceKey) {
   return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
     const meta = getOperationClickyMeta(operation);
-    return meta != null && meta.scope === "collection" && meta.verb !== "list";
+    return meta != null && meta.verb !== "list" && meta.verb !== "get";
   });
 }
+function surfaceActionLabel(operation) {
+  var _a, _b;
+  const meta = getOperationClickyMeta(operation);
+  const short = ((_a = meta == null ? void 0 : meta.actionName) == null ? void 0 : _a.trim()) || ((_b = meta == null ? void 0 : meta.verb) == null ? void 0 : _b.trim());
+  if (short && short !== "action") {
+    return short.charAt(0).toUpperCase() + short.slice(1);
+  }
+  return operation.operation.operationId || operation.path;
+}
 function findSurfaceEntityActions(operations, surfaceKey) {
   return filterOperationsBySurface(operations, surfaceKey).filter((operation) => {
     const meta = getOperationClickyMeta(operation);
@@ -58,7 +67,7 @@ function makeSurfaceDefinition(surface) {
 }
 export {
   filterOperationsBySurface,
-  findSurfaceCollectionActions,
+  findSurfaceActions,
   findSurfaceDetailOperation,
   findSurfaceEntityActions,
   findSurfaceListOperation,
@@ -66,6 +75,7 @@ export {
   getClickySpecMeta,
   getClickySurfaces,
   getOperationClickyMeta,
-  makeSurfaceDefinition
+  makeSurfaceDefinition,
+  surfaceActionLabel
 };
 //# sourceMappingURL=clickyMetadata.js.map

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\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;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// findSurfaceActions returns every runnable action on a surface — both\n// collection-scoped (e.g. create) and entity-scoped (e.g. update/delete, and\n// custom Actions which clicky always annotates scope:\"entity\"). The action bar\n// surfaces these as buttons that open the execution dialog (the dialog collects\n// any id the entity-scoped action needs). Only the list and the entity get are\n// excluded — they drive the table and the row click-through respectively.\nexport function findSurfaceActions(\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.verb !== \"list\" && meta.verb !== \"get\";\n  });\n}\n\n// surfaceActionLabel prefers the short clicky actionName/verb (capitalized)\n// over the OpenAPI summary, which is often a full sentence. Falls back to 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.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;AAkBO,SAAS,mBACd,YACA,YACqB;AACrB,SAAO,0BAA0B,YAAY,UAAU,EAAE,OAAO,CAAC,cAAc;AAC7E,UAAM,OAAO,uBAAuB,SAAS;AAC7C,WAAO,QAAQ,QAAQ,KAAK,SAAS,UAAU,KAAK,SAAS;AAAA,EAC/D,CAAC;AACH;AAKO,SAAS,mBAAmB,WAAsC;AAtFlE;AAuFL,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,eAAe,UAAU;AACtD;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;"}

package/dist/rpc.cjs

@@ -3,6 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const OperationCatalog = require("./rpc/OperationCatalog.cjs");
 const EntityExplorerApp = require("./rpc/EntityExplorerApp.cjs");
 const AcceptPicker = require("./rpc/AcceptPicker.cjs");
+const acceptOptions = require("./rpc/accept-options.cjs");
 const CommandForm = require("./rpc/CommandForm.cjs");
 const CommandOutput = require("./rpc/CommandOutput.cjs");
 const FilterForm = require("./rpc/FilterForm.cjs");
@@ -17,9 +18,9 @@ const classify = require("./rpc/classify.cjs");
 const types = require("./rpc/types.cjs");
 exports.OperationCatalog = OperationCatalog.OperationCatalog;
 exports.EntityExplorerApp = EntityExplorerApp.EntityExplorerApp;
-exports.ACCEPT_OPTIONS = AcceptPicker.ACCEPT_OPTIONS;
 exports.AcceptPicker = AcceptPicker.AcceptPicker;
-exports.VIEW_OPTIONS = AcceptPicker.VIEW_OPTIONS;
+exports.ACCEPT_OPTIONS = acceptOptions.ACCEPT_OPTIONS;
+exports.VIEW_OPTIONS = acceptOptions.VIEW_OPTIONS;
 exports.CommandForm = CommandForm.CommandForm;
 exports.CommandOutput = CommandOutput.CommandOutput;
 exports.FilterForm = FilterForm.FilterForm;

package/dist/rpc.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/rpc.d.ts

@@ -1,6 +1,7 @@
 export { OperationCatalog, type OperationCatalogProps } from './rpc/OperationCatalog';
 export { EntityExplorerApp, type EntityExplorerAppProps } from './rpc/EntityExplorerApp';
-export { ACCEPT_OPTIONS, AcceptPicker, VIEW_OPTIONS, type AcceptOption, type AcceptPickerProps, type AcceptValue, type OperationPreviewMode, } from './rpc/AcceptPicker';
+export { AcceptPicker, type AcceptPickerProps } from './rpc/AcceptPicker';
+export { ACCEPT_OPTIONS, VIEW_OPTIONS, type AcceptOption, type AcceptValue, type OperationPreviewMode, } from './rpc/accept-options';
 export { CommandForm, type CommandFormProps } from './rpc/CommandForm';
 export { CommandOutput, type CommandOutputProps } from './rpc/CommandOutput';
 export { FilterForm, type FilterFormProps } from './rpc/FilterForm';

package/dist/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}

package/dist/rpc.js

@@ -1,6 +1,7 @@
 import { OperationCatalog } from "./rpc/OperationCatalog.js";
 import { EntityExplorerApp } from "./rpc/EntityExplorerApp.js";
-import { ACCEPT_OPTIONS, AcceptPicker, VIEW_OPTIONS } from "./rpc/AcceptPicker.js";
+import { AcceptPicker } from "./rpc/AcceptPicker.js";
+import { ACCEPT_OPTIONS, VIEW_OPTIONS } from "./rpc/accept-options.js";
 import { CommandForm } from "./rpc/CommandForm.js";
 import { CommandOutput } from "./rpc/CommandOutput.js";
 import { FilterForm } from "./rpc/FilterForm.js";

package/dist/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}
+{"version":3,"file":"rpc.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}