@punica/editor 1.10.11 → 1.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.10.11",
+  "version": "1.11.1",
   "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.runtime.fs.d.ts

@@ -16,7 +16,11 @@ declare module 'punica' {
      *
      *  - 'streaming'         : opt-in chunked read/write for large files
      *  - 'binary'            : ranged binary reads via `readBytes` (e.g.
-     *                          Parquet); text-only providers omit this
+     *                          Parquet); text-only providers omit this.
+     *                          READS ONLY — binary WRITE support is not
+     *                          implied, because both shipped hosts declared
+     *                          this flag before either could write bytes.
+     *                          Feature-detect `writeBytes` directly instead
      *  - 'watch'             : path-scoped change notifications
      *  - 'versioning'        : per-path history + time-travel reads
      *  - 'encrypted-at-rest' : payloads stored encrypted by the host
@@ -253,6 +257,17 @@ declare module 'punica' {
         length: number
       ): Promise<ArrayBuffer>;
 
+      /**
+       * Write raw bytes to a workspace file, creating it when absent and
+       * replacing it wholesale when present. Optional/capability-gated:
+       * present on hosts with a binary bridge, absent on text-only providers
+       * — feature-detect with `typeof fs.writeBytes === 'function'` rather
+       * than the `'binary'` flag, which speaks only for reads. Use for
+       * binary content (a pasted screenshot, a copied image) that
+       * `createFileWithContent` would corrupt by encoding it as UTF-8.
+       */
+      writeBytes?(path: string, data: ArrayBuffer): Promise<void>;
+
       /**
        * Create a new file with the given textual content.
        */

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