@punica/editor 1.6.5 → 1.6.6

package/package.json

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

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

@@ -430,6 +430,78 @@ 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;
       }
 
       namespace Theme {