@punica/editor 1.0.7 → 1.1.0

package/package.json

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

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

@@ -15,6 +15,24 @@ declare module 'punica' {
       capability?: string;
     }
 
+    /**
+     * A single icon-button action shown in the panel tab bar's toolbar
+     * area while the owning view is the active panel view. Clicking the
+     * button dispatches `command` through the kernel command manager
+     * (the single command choke point — lazy-activates the owning
+     * extension when needed).
+     */
+    interface PanelToolbarAction {
+      /** Unique within the owning view. */
+      id: string;
+      /** Tooltip / aria-label. */
+      title: string;
+      /** Raw HTML icon markup, e.g. '<i class="fa-solid fa-plus"></i>'. */
+      icon?: string;
+      /** Command id dispatched on click. */
+      command: string;
+    }
+
     interface Views {
       primarySidebar?: BaseView;
       secondarySidebar?: BaseView;
@@ -31,7 +49,15 @@ declare module 'punica' {
        * only on reveal — via the extension's ViewProvider, or, for
        * pre-migration extensions, via the bound `capability` command.
        */
-      panel?: BaseView & { order?: number };
+      panel?: BaseView & {
+        order?: number;
+        /**
+         * Toolbar actions rendered in the panel tab bar's right-side
+         * toolbar area, visible only while this view is the active
+         * panel view. Ignored by older cores.
+         */
+        toolbar?: PanelToolbarAction[];
+      };
       activityBar?: Pick<BaseView, 'id' | 'name'> &
         Required<Pick<BaseView, 'title' | 'icon' | 'alignment'>>;
       statusBar?: Pick<BaseView, 'id' | 'name'> &
@@ -473,6 +499,20 @@ declare module 'punica' {
        */
       deactivate(extensionName: string): Promise<void>;
 
+      /**
+       * Unload an extension — the inverse of `load()`. Removes all
+       * analysis-phase registrations (metadata, runtime state, capability
+       * index, instruction classes, command-activation map, startup sets)
+       * so the manager fully forgets the name.
+       *
+       * Does NOT run runtime disposal — call `deactivate()` first.
+       * Precondition: runtime state is `loaded` or `failed` (unknown names
+       * are a no-op); rejects while `active`/`activating`/`deactivating`.
+       * The dynamically imported ES module is not evicted (inert until the
+       * next restart).
+       */
+      unload(extensionName: string): Promise<void>;
+
       /**
        * Current runtime state of an extension, or undefined when not
        * loaded.

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

@@ -1,5 +1,23 @@
 declare module 'punica' {
   export namespace shell {
+    /**
+     * A single icon-button action shown in the panel tab bar's toolbar
+     * area while the owning view is the active panel view. Clicking the
+     * button dispatches `command` through
+     * `punica.kernel.Commands.manager.executeCommand` (the single command
+     * choke point — lazy-activates the owning extension when needed).
+     */
+    export interface PanelToolbarAction {
+      /** Unique within the owning view. */
+      id: string;
+      /** Tooltip / aria-label. */
+      title: string;
+      /** Raw HTML icon markup, e.g. '<i class="fa-solid fa-plus"></i>'. */
+      icon?: string;
+      /** Command id dispatched on click. */
+      command: string;
+    }
+
     /**
      * Panel tab management for the bottom panel area (problems, terminals, etc.).
      */
@@ -14,6 +32,11 @@ declare module 'punica' {
          * When false, the panel tab is added but not activated.
          */
         autoActivate?: boolean;
+        /**
+         * Toolbar actions rendered in the tab bar's right-side toolbar
+         * area, visible only while this view is the active panel view.
+         */
+        toolbar?: PanelToolbarAction[];
       }): void;
 
       close(id: string): void;