lumiverse-spindle-types 0.5.23 → 0.5.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -2944,6 +2944,8 @@ export type HostToWorker =
     }
   | {
       type: "permission_changed";
+      /** Extension identifier for the worker receiving this scoped change */
+      extensionId?: string;
       permission: string;
       granted: boolean;
       allGranted: string[];

package/src/dom.ts

@@ -212,6 +212,13 @@ export interface SpindleDockPanelHandle {
   onVisibilityChange(handler: (visible: boolean) => void): () => void;
 }
 
+// ── Tab Mobility ──
+
+/** Where a built-in drawer tab currently lives. */
+export type SpindleTabLocation =
+  | { kind: "main-drawer" }
+  | { kind: "container"; containerId: string };
+
 // ── App Mount ──
 
 export interface SpindleAppMountOptions {
@@ -752,6 +759,12 @@ export interface SpindleFrontendContext {
      * ```
      */
     showConfirm(options: SpindleConfirmOptions): Promise<SpindleConfirmResult>;
+    /** Request a tab move to a specific drawer location. */
+    requestTabLocation(tabId: string, location: SpindleTabLocation): void;
+    /** Get the display title of a built-in drawer tab by its id. */
+    getBuiltInTabTitle(tabId: string): string | undefined;
+    /** Get the root HTMLElement of a built-in drawer tab by its id, or undefined if not mounted. */
+    getBuiltInTabRoot(tabId: string): HTMLElement | undefined;
   };
   /**
    * Mount instances of Lumiverse's first-party shared UI components (form
@@ -761,6 +774,13 @@ export interface SpindleFrontendContext {
    * {@link SpindleComponentsHelper} for the full surface.
    */
   components: SpindleComponentsHelper;
+  /** Register or unregister passive DOM containers that can receive tab roots. */
+  containers: {
+    /** Register a container element with a stable id. Tabs routed to this id via `requestTabLocation` will be reparented into `element`. Idempotent on id collision. */
+    registerContainer(entry: { id: string; side: 'left' | 'right' | 'top' | 'bottom'; element: HTMLElement }): void;
+    /** Remove a previously registered container. Tabs still pointing to this id will fall back to the main drawer. */
+    unregisterContainer(id: string): void;
+  };
   uploads: {
     pickFile(options?: {
       accept?: string[];

package/src/index.ts

@@ -233,7 +233,8 @@ export type {
     SpindleDisplayScriptsArgs,
     SpindleDisplayResolveResult,
     SpindleDisplayTemplatesResult,
- } from "./dom";
+    SpindleTabLocation,
+  } from "./dom";
 
 export type {
   SpindleMountedComponent,

package/src/spindle-api.ts

@@ -224,6 +224,12 @@ export interface SpindlePromptRegex {
 
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
+  /**
+   * Subscribe to permission grant/revoke changes for this extension only.
+   * This is delivered directly by the worker host and does not subscribe to
+   * the global backend event bus.
+   */
+  on(event: "PERMISSION_CHANGED", handler: (payload: PermissionChangedDetail) => void): () => void;
   /** Subscribe to generation-started events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */
   on(event: "GENERATION_STARTED", handler: (payload: GenerationStartedPayloadDTO, userId?: string) => void): () => void;
   /** Subscribe to streamed token events (requires `generation` permission). The optional `userId` identifies which user triggered the event. */