@punica/editor 1.6.5 → 1.6.7

package/package.json

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

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

@@ -430,6 +430,133 @@ declare module 'punica' {
         function createLink(text: string, options: LinkOptions): HTMLElement;
 
         function createToolbar(options?: ToolbarOptions): HTMLElement;
+
+        // ── Sidebar card standard ──────────────────────────────────────
+        // One card design for every list-based sidebar/panel view: a status
+        // dot or type icon, a bold title over a muted subtitle, optional
+        // right-aligned meta, and no inline buttons — per-row actions live in
+        // a right-click context menu (attachContextMenu).
+
+        interface SidebarCardOptions {
+          /** Stable row id → data-node-id; the context-menu row resolver key. */
+          id: string;
+          /** Bold title (rendered as a plain div so card CSS controls size). */
+          name: string;
+          /** Muted subtitle under the title. */
+          sub?: string;
+          /** Status dot variant; takes precedence over `icon`. */
+          dot?:
+            | 'running'
+            | 'paused'
+            | 'stopped'
+            | 'idle'
+            | 'error'
+            | 'success'
+            | 'warning';
+          /** FontAwesome icon class for the left glyph when there is no dot. */
+          icon?: string;
+          /** Optional right-aligned monospace meta (ports, size, …). */
+          meta?: string;
+          /** Dims the row (e.g. stopped/disabled). */
+          inactive?: boolean;
+          /** Marks the row selected. */
+          selected?: boolean;
+          /** Extra data-* attributes (e.g. kind, state) read by buildItems. */
+          data?: Record<string, string>;
+          /** Native hover tooltip. */
+          title?: string;
+        }
+
+        interface GroupHeaderOptions {
+          label: string;
+          /** Appended after a middot, e.g. "0/1 running". */
+          count?: string;
+        }
+
+        interface MenuItemSpec {
+          label: string;
+          value: string;
+          /** Raw HTML for the item icon (typically a FontAwesome <i>). */
+          icon?: string;
+          /** Insert a separator before this item. */
+          separatorBefore?: boolean;
+        }
+
+        /** Build one standard sidebar/panel list card. */
+        function createSidebarCard(options: SidebarCardOptions): HTMLElement;
+
+        /** Build an uppercase section header with a trailing divider rule. */
+        function createGroupHeader(
+          options: GroupHeaderOptions | string
+        ): HTMLElement;
+
+        /**
+         * Wire a right-click context menu on a list container. Items are
+         * rebuilt per right-click (state-aware) from the row under the cursor
+         * (resolved via the nearest `[data-node-id]`). Returns a disposer that
+         * removes the listeners and the menu element.
+         */
+        function attachContextMenu(options: {
+          listEl: HTMLElement;
+          menuId: string;
+          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 {