@punica/editor 1.46.0 → 1.47.0

package/package.json

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

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

@@ -597,7 +597,7 @@ declare module 'punica' {
         // 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).
+        // a ⋯ menu on the row (`menu:`, or attachRowMenu for a whole list).
 
         /**
          * The one status-glyph vocabulary in the shell: a card dot, a
@@ -647,6 +647,54 @@ declare module 'punica' {
           data?: Record<string, string>;
           /** Native hover tooltip. */
           title?: string;
+          /**
+           * Per-row actions behind a ⋯ at the row's right edge, shown under
+           * the pointer and on keyboard focus. Since 2026-09-29 this is the
+           * only door to a row's actions: a right-click opens nothing.
+           */
+          menu?: RowMenuSpec;
+          /**
+           * The row's ONE visible button (Install, Download, Pause). A second
+           * action goes in `menu`; a destructive one always does.
+           */
+          action?: RowActionSpec;
+          /**
+           * The row cannot be clicked: default cursor, no hover step. A row
+           * that only has a menu is `static: true` with `menu` set.
+           */
+          static?: boolean;
+        }
+
+        interface RowMenuSpec {
+          /** Rebuilt every time the menu opens, from the row it opens on. */
+          buildItems: (row: HTMLElement) => MenuItemSpec[];
+          onSelect: (value: string, row: HTMLElement) => void;
+        }
+
+        interface RowActionSpec {
+          label: string;
+          onClick: (row: HTMLElement) => void;
+          disabled?: boolean;
+          /** Native title on the button. */
+          title?: string;
+        }
+
+        interface PanelHeaderAction {
+          /** FontAwesome classes, `fa-light` weight like the reference. */
+          icon: string;
+          /** Native title; the fleet has no tooltip system and passes it anyway. */
+          title: string;
+          onClick: () => void;
+          disabled?: boolean;
+        }
+
+        interface PanelHeaderOptions {
+          /** Drawn uppercase, extra-bold. */
+          title: string;
+          /** Small `fa-light` icon buttons pushed to the right edge. */
+          actions?: PanelHeaderAction[];
+          /** Extra attributes on the header element. */
+          attrs?: Record<string, string>;
         }
 
         interface GroupHeaderOptions {
@@ -740,10 +788,27 @@ declare module 'punica' {
         function createEmptyState(options: EmptyStateOptions): 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.
+         * Give every `[data-node-id]` row in a list a ⋯ menu, card or not.
+         * The button is injected the first time the pointer or the focus
+         * reaches a row; a row built with `createSidebarCard({ menu })` keeps
+         * its own. Items are rebuilt per open from that row. Listens to no
+         * `contextmenu`. Returns a disposer that removes the buttons.
+         */
+        function attachRowMenu(options: {
+          listEl: HTMLElement;
+          buildItems: (row: HTMLElement) => MenuItemSpec[];
+          onSelect: (value: string, row: HTMLElement) => void;
+          /**
+           * `button` (default): a ⋯ on every row. `contextmenu`: the same
+           * menu on a right-click at the pointer and no ⋯ — for a tree only
+           * (Explorer, tests, a dataset folder); a card list never passes it.
+           */
+          trigger?: 'button' | 'contextmenu';
+        }): () => void;
+
+        /**
+         * @deprecated Since 2026-09-29 this is `attachRowMenu` under its old
+         * name: the same items behind a ⋯ on every row, and no right-click.
          */
         function attachContextMenu(options: {
           listEl: HTMLElement;
@@ -752,6 +817,30 @@ declare module 'punica' {
           onSelect: (value: string, row: HTMLElement) => void;
         }): () => void;
 
+        /**
+         * The standard panel header (docs/panel-anatomy.md): a sticky column
+         * with a 12px gutter, a dense gutterless toolbar, an extra-bold
+         * uppercase title that grows, small icon actions at the right edge and
+         * a flush divider. One element; append it ahead of the body.
+         */
+        function createPanelHeader(options: PanelHeaderOptions): HTMLElement;
+
+        /**
+         * The scrolling body under the header: `padding: 8px 12px 12px`,
+         * `overflow-y: auto`, `flex: 1 1 auto; min-height: 0`. Its 12px sides
+         * are the header's, so the title and the first row line up.
+         */
+        function createPanelBody(options?: {
+          attrs?: Record<string, string>;
+          children?: HTMLElement[];
+        }): HTMLElement;
+
+        /** A column of rows with the 4px gap between them. */
+        function createList(options?: {
+          attrs?: Record<string, string>;
+          children?: HTMLElement[];
+        }): HTMLElement;
+
         /**
          * A capability definition, loosely typed so any surface (extension
          * viewer, llms viewer, ivy-node explorer, capability catalog) can pass