@punica/editor 1.10.11 → 1.11.0

package/package.json

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

package/types/punica.module.extensions.api.d.ts

@@ -450,6 +450,14 @@ declare module 'punica' {
          * Escape) goes through here, never through direct DOM removal.
          */
         hide(viewId: string): Promise<void>;
+
+        /**
+         * Publish what this extension's view is holding, so the shell can tint
+         * its tab icon (`level: 'none'` clears it). PASSIVE: it shows nothing
+         * and reveals nothing — the same rule a status-bar counter follows.
+         * Only views this extension declared may be decorated.
+         */
+        setViewStatus(viewId: string, status: shell.Views.ViewStatus): void;
       };
     }
 

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

@@ -50,6 +50,14 @@ declare module 'punica' {
       /** Returns the id of the currently active panel tab, or null. */
       getActiveId(): string | null;
 
+      /**
+       * Paint a tab's passive indicator: the icon takes the status color and
+       * the tooltip / accessible name carries `detail`. Called by the
+       * ViewRegistry, which owns the status — extensions publish through
+       * `context.ui.setViewStatus`, never here. `null` clears it.
+       */
+      setTabStatus(id: string, status: Views.ViewStatus | null): void;
+
       /**
        * Activate a tab and execute its bound command (legacy render
        * path). Blocked during headless extension activation — a

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

@@ -91,6 +91,34 @@ declare module 'punica' {
         focus?: boolean;
       }
 
+      /**
+       * How bad is the worst thing a view is currently holding. `none` means
+       * empty — the view's own resting state, not an absence of information.
+       */
+      export type ViewStatusLevel =
+        | 'none'
+        | 'info'
+        | 'success'
+        | 'warning'
+        | 'error';
+
+      /**
+       * A view's passive indicator: what its list holds right now, published by
+       * the owning extension so the shell can tint the view's tab icon.
+       *
+       * Deliberately not a count. The number belongs to whatever surface the
+       * extension already renders it on (a status-bar counter, a bell badge);
+       * a third copy in the tab strip would widen the strip and say nothing new.
+       * `detail` carries the words instead, and reaches the tab's accessible
+       * name — the icon-only strips have no label to fall back on, so the color
+       * must never be the only channel.
+       */
+      export interface ViewStatus {
+        level: ViewStatusLevel;
+        /** Human phrasing, e.g. "2 warnings, 1 info". */
+        detail?: string;
+      }
+
       export interface ViewInfo {
         viewId: string;
         slot: ViewSlotId;
@@ -142,6 +170,24 @@ declare module 'punica' {
          */
         hide(viewId: string, source: RevealSource): void;
 
+        /**
+         * Publish a view's passive indicator (see `ViewStatus`) and push it to
+         * whichever tabbed container currently holds the view — so the tint
+         * follows the view when it is relocated between the bottom panel and
+         * the right sidebar.
+         *
+         * PASSIVE: this never reveals a view, never activates an extension and
+         * never changes the active tab. `owner` (the calling extension's name,
+         * supplied by `context.ui.setViewStatus`) is checked against the
+         * placement, so one extension cannot decorate another's tab.
+         *
+         * `level: 'none'` clears the status.
+         */
+        setViewStatus(viewId: string, status: ViewStatus, owner?: string): void;
+
+        /** The last published status, or undefined when the view is at rest. */
+        getViewStatus(viewId: string): ViewStatus | undefined;
+
         /**
          * Relocate a view to another dock area (relocation primitive).
          * Validates `targetSlot ∈ placement.allowedSlots`, tears down the