@punica/editor 1.6.6 → 1.6.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.6.6",
+  "version": "1.6.8",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.shell.view.d.ts

@@ -502,6 +502,61 @@ declare module 'punica' {
           buildItems: (row: HTMLElement) => MenuItemSpec[];
           onSelect: (value: string, row: HTMLElement) => void;
         }): () => void;
+
+        /**
+         * A capability definition, loosely typed so any surface (extension
+         * viewer, llms viewer, ivy-node explorer, capability catalog) can pass
+         * its own record shape. Only the fields the detail renderer reads are
+         * named; the index signature carries everything else through to the
+         * raw-definition block.
+         */
+        interface CapabilityDefinitionLike {
+          id?: string;
+          title?: string;
+          description?: string;
+          version?: string;
+          inputs?: { schema?: unknown };
+          outputs?: {
+            kind?: string;
+            resultEvent?: string;
+            errorEvent?: string;
+            schema?: unknown;
+          };
+          policy?: { risk?: string; approval?: string };
+          tags?: string[];
+          sideEffects?: string[];
+          [key: string]: unknown;
+        }
+
+        interface CapabilityDetailOptions {
+          /** Meta-line "source:" label (extension name / "ivy-node" / "core"). */
+          source?: string;
+          /**
+           * true → a click-to-expand row with a chevron (for lists). Omit or
+           * false → the detail body is rendered directly, always visible (for a
+           * single-capability tab).
+           */
+          collapsible?: boolean;
+          /** Initial expanded state when `collapsible`. */
+          open?: boolean;
+          /**
+           * Consumer-specific sections appended after Tags and before the raw
+           * block (e.g. an instruction class's Execution Defaults / System
+           * Prompt).
+           */
+          extraSections?: HTMLElement[];
+        }
+
+        /**
+         * Render one capability's detail in the shared catalog look: bold title
+         * + mono id, risk/approval pills, a source·id·version·approval meta
+         * line, Inputs/Outputs schema blocks, Tags, and a collapsed
+         * "Show raw definition" toggle. CSS is injected once (theme-aware).
+         */
+        function createCapabilityDetail(
+          def: CapabilityDefinitionLike,
+          options?: CapabilityDetailOptions
+        ): HTMLElement;
       }
 
       namespace Theme {