@punica/editor 1.6.9 → 1.6.11

package/package.json

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

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

@@ -10,6 +10,13 @@ declare module 'punica' {
         alignment: Alignment;
         title: string;
         icon: string;
+        /**
+         * Live state of whatever the item reflects, drawn as a status dot in
+         * front of the icon (`running`/`busy` pulse). Put the state here rather
+         * than spelling it out in `label` — a ▶/▷ character is indistinguishable
+         * at this size and font-dependent.
+         */
+        status?: View.Helpers.StatusDotState;
         /** Command (or capability) id executed when the item is clicked. */
         command?: string;
         capability?: string;

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

@@ -437,6 +437,33 @@ declare module 'punica' {
         // right-aligned meta, and no inline buttons — per-row actions live in
         // a right-click context menu (attachContextMenu).
 
+        /**
+         * The one status-glyph vocabulary in the shell: a card dot, a
+         * status-bar item's state and a server row all speak it, so "running"
+         * looks the same everywhere. `busy` covers work with a known end
+         * (an engine download); `success` is a finished run, not a live one.
+         */
+        type StatusDotState =
+          | 'running'
+          | 'busy'
+          | 'paused'
+          | 'stopped'
+          | 'idle'
+          | 'error'
+          | 'success'
+          | 'warning';
+
+        interface StatusDotOptions {
+          /**
+           * Animate the dot. Reserved for surfaces showing a single subject —
+           * a list of blinking rows is noise. Ignored under
+           * `prefers-reduced-motion`.
+           */
+          pulse?: boolean;
+          /** Extra class names appended to the dot. */
+          className?: string;
+        }
+
         interface SidebarCardOptions {
           /** Stable row id → data-node-id; the context-menu row resolver key. */
           id: string;
@@ -445,14 +472,7 @@ declare module 'punica' {
           /** Muted subtitle under the title. */
           sub?: string;
           /** Status dot variant; takes precedence over `icon`. */
-          dot?:
-            | 'running'
-            | 'paused'
-            | 'stopped'
-            | 'idle'
-            | 'error'
-            | 'success'
-            | 'warning';
+          dot?: StatusDotState;
           /** FontAwesome icon class for the left glyph when there is no dot. */
           icon?: string;
           /** Optional right-aligned monospace meta (ports, size, …). */
@@ -485,6 +505,15 @@ declare module 'punica' {
         /** Build one standard sidebar/panel list card. */
         function createSidebarCard(options: SidebarCardOptions): HTMLElement;
 
+        /**
+         * Build one status dot. Use this rather than a hand-rolled circle (or a
+         * ▶/▷ character in a label) so every surface reports state identically.
+         */
+        function createStatusDot(
+          state: StatusDotState,
+          options?: StatusDotOptions
+        ): HTMLElement;
+
         /** Build an uppercase section header with a trailing divider rule. */
         function createGroupHeader(
           options: GroupHeaderOptions | string