@burdenoff/fe-libs 2026.528.10 → 2026.528.11

package/dist/shared/plugins/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * UI Plugin Architecture — public API.
+ *
+ * This module provides the core infrastructure for building extensible
+ * frontend applications with a VSCode/Backstage-inspired plugin system.
+ *
+ * @module @burdenoff/fe-libs/shared/plugins
+ *
+ * @example
+ * ```tsx
+ * // In an app shell:
+ * import { PluginRuntimeProvider, type UIPlugin } from '@burdenoff/fe-libs/shared/plugins';
+ *
+ * // In a plugin/MFE:
+ * import type { UIPlugin, PluginContext } from '@burdenoff/fe-libs/shared/plugins';
+ *
+ * export const myPlugin: UIPlugin = {
+ *   manifest: { id: 'my-plugin', name: 'My Plugin', version: '1.0.0' },
+ *   activate(ctx) {
+ *     ctx.nav.register({ id: 'mp', pluginId: 'my-plugin', label: 'My Plugin', path: '/my-plugin' });
+ *   },
+ * };
+ * ```
+ */
+export type { UIPlugin, UIPluginManifest, PluginContributions, PluginContext, ActivationEvent, ExtensionPointDeclaration, ContributionBase, NavContribution, FooterContribution, CommandContribution, RouteContribution, PanelContribution, PanelProps, StatusBarContribution, SettingsContribution, WidgetContribution, ToolbarContribution, ContextMenuContribution, ContextMenuItem, RegistryAPI, PluginStatus, ToastType, } from './types';
+export { DisposableCollection, type Disposable } from './disposable';
+export { EventBus, usePluginEvent, type CoreEventMap, type VibeControlsEventMap, type EventMiddleware, } from './event-bus';
+export { PluginRuntime, type PluginRuntimeConfig } from './runtime';
+export { createPluginContext, type ShellServices, type RegistryRefs, type PluginActiveContext, type PluginAuthSnapshot, } from './context';
+export { PluginRuntimeProvider, usePluginRuntime, type PluginRuntimeProviderProps, type PluginRuntimeObservedState, } from './PluginRuntimeProvider';
+export { createContributionRegistry, type RegistryItem, type ContributionRegistryStore, } from './registries/createContributionRegistry';
+export { useCommandRegistryStore } from './registries/useCommandRegistry';
+export { useRouteRegistryStore } from './registries/useRouteRegistry';
+export { usePanelRegistryStore } from './registries/usePanelRegistry';
+export { useStatusBarRegistryStore } from './registries/useStatusBarRegistry';
+export { useSettingsRegistryStore } from './registries/useSettingsRegistry';
+export { useWidgetRegistryStore } from './registries/useWidgetRegistry';
+export { useToolbarRegistryStore } from './registries/useToolbarRegistry';
+export { useContextMenuRegistryStore } from './registries/useContextMenuRegistry';
+export * from './iframe-mount';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,oBAAoB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,0BAA0B,EAC1B,KAAK,YAAY,EACjB,KAAK,yBAAyB,GAC/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAKlF,cAAc,gBAAgB,CAAC"}

package/dist/shared/plugins/panels/usePanelManagerStore.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Panel state management store.
+ *
+ * Tracks visibility, size, and active tab for each panel area.
+ *
+ * @module @burdenoff/fe-libs/shared/plugins/panels/usePanelManagerStore
+ */
+export interface PanelState {
+    id: string;
+    position: 'bottom' | 'left' | 'right';
+    visible: boolean;
+    size: number;
+    minimized: boolean;
+    maximized: boolean;
+}
+interface PanelManagerStore {
+    panels: Record<string, PanelState>;
+    /** Active panel ID per position */
+    activePanels: Record<string, string | undefined>;
+    initPanel(id: string, position: string, defaultSize: number): void;
+    openPanel(id: string): void;
+    closePanel(id: string): void;
+    togglePanel(id: string): void;
+    resizePanel(id: string, size: number): void;
+    minimizePanel(id: string): void;
+    maximizePanel(id: string): void;
+    restorePanel(id: string): void;
+    setActivePanel(position: string, panelId: string): void;
+}
+export declare const usePanelManagerStore: import('zustand').UseBoundStore<Omit<import('zustand').StoreApi<PanelManagerStore>, "setState" | "persist"> & {
+    setState(partial: PanelManagerStore | Partial<PanelManagerStore> | ((state: PanelManagerStore) => PanelManagerStore | Partial<PanelManagerStore>), replace?: false | undefined): unknown;
+    setState(state: PanelManagerStore | ((state: PanelManagerStore) => PanelManagerStore), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import('zustand/middleware').PersistOptions<PanelManagerStore, {
+            panels: {
+                [k: string]: {
+                    visible: boolean;
+                    minimized: boolean;
+                    maximized: boolean;
+                    id: string;
+                    position: "bottom" | "left" | "right";
+                    size: number;
+                };
+            };
+            activePanels: {};
+        }, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: PanelManagerStore) => void) => () => void;
+        onFinishHydration: (fn: (state: PanelManagerStore) => void) => () => void;
+        getOptions: () => Partial<import('zustand/middleware').PersistOptions<PanelManagerStore, {
+            panels: {
+                [k: string]: {
+                    visible: boolean;
+                    minimized: boolean;
+                    maximized: boolean;
+                    id: string;
+                    position: "bottom" | "left" | "right";
+                    size: number;
+                };
+            };
+            activePanels: {};
+        }, unknown>>;
+    };
+}>;
+export {};
+//# sourceMappingURL=usePanelManagerStore.d.ts.map

package/dist/shared/plugins/panels/usePanelManagerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelManagerStore.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/panels/usePanelManagerStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAEjD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACnE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;wBAxB3B,MAAM;8BACA,QAAQ,GAAG,MAAM,GAAG,OAAO;0BAE/B,MAAM;;;;;;;;;;;;;;;;wBAHR,MAAM;8BACA,QAAQ,GAAG,MAAM,GAAG,OAAO;0BAE/B,MAAM;;;;;;EA4Lb,CAAC"}

package/dist/shared/plugins/registries/createContributionRegistry.d.ts

@@ -0,0 +1,16 @@
+import { Disposable } from '../disposable';
+export interface RegistryItem {
+    id: string;
+    pluginId: string;
+    order?: number;
+    visible?: boolean;
+}
+export interface ContributionRegistryStore<T extends RegistryItem> {
+    items: T[];
+    register: (item: T) => Disposable;
+    unregister: (id: string) => void;
+    clear: () => void;
+    getByPlugin: (pluginId: string) => T[];
+}
+export declare function createContributionRegistry<T extends RegistryItem>(): import('zustand').UseBoundStore<import('zustand').StoreApi<ContributionRegistryStore<T>>>;
+//# sourceMappingURL=createContributionRegistry.d.ts.map

package/dist/shared/plugins/registries/createContributionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContributionRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/createContributionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,YAAY;IAC/D,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,UAAU,CAAC;IAClC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;CACxC;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,YAAY,+FA2BhE"}

package/dist/shared/plugins/registries/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Plugin contribution registries.
+ *
+ * @module @burdenoff/fe-libs/shared/plugins/registries
+ */
+export { createContributionRegistry, type RegistryItem, type ContributionRegistryStore, } from './createContributionRegistry';
+export { useCommandRegistryStore } from './useCommandRegistry';
+export { useRouteRegistryStore } from './useRouteRegistry';
+export { usePanelRegistryStore } from './usePanelRegistry';
+export { useStatusBarRegistryStore } from './useStatusBarRegistry';
+export { useSettingsRegistryStore } from './useSettingsRegistry';
+export { useWidgetRegistryStore } from './useWidgetRegistry';
+export { useToolbarRegistryStore } from './useToolbarRegistry';
+export { useContextMenuRegistryStore } from './useContextMenuRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/plugins/registries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,0BAA0B,EAC1B,KAAK,YAAY,EACjB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/plugins/registries/useCommandRegistry.d.ts

@@ -0,0 +1,3 @@
+import { CommandContribution } from '../types';
+export declare const useCommandRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<CommandContribution>>>;
+//# sourceMappingURL=useCommandRegistry.d.ts.map

package/dist/shared/plugins/registries/useCommandRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommandRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useCommandRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,uBAAuB,oJAAoD,CAAC"}

package/dist/shared/plugins/registries/useContextMenuRegistry.d.ts

@@ -0,0 +1,3 @@
+import { ContextMenuContribution } from '../types';
+export declare const useContextMenuRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<ContextMenuContribution>>>;
+//# sourceMappingURL=useContextMenuRegistry.d.ts.map

package/dist/shared/plugins/registries/useContextMenuRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContextMenuRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useContextMenuRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,2BAA2B,wJAAwD,CAAC"}

package/dist/shared/plugins/registries/usePanelRegistry.d.ts

@@ -0,0 +1,3 @@
+import { PanelContribution } from '../types';
+export declare const usePanelRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<PanelContribution>>>;
+//# sourceMappingURL=usePanelRegistry.d.ts.map

package/dist/shared/plugins/registries/usePanelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/usePanelRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,eAAO,MAAM,qBAAqB,kJAAkD,CAAC"}

package/dist/shared/plugins/registries/useRouteRegistry.d.ts

@@ -0,0 +1,3 @@
+import { RouteContribution } from '../types';
+export declare const useRouteRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<RouteContribution>>>;
+//# sourceMappingURL=useRouteRegistry.d.ts.map

package/dist/shared/plugins/registries/useRouteRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouteRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useRouteRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,eAAO,MAAM,qBAAqB,kJAAkD,CAAC"}

package/dist/shared/plugins/registries/useSettingsRegistry.d.ts

@@ -0,0 +1,3 @@
+import { SettingsContribution } from '../types';
+export declare const useSettingsRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<SettingsContribution>>>;
+//# sourceMappingURL=useSettingsRegistry.d.ts.map

package/dist/shared/plugins/registries/useSettingsRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettingsRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useSettingsRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,eAAO,MAAM,wBAAwB,qJAAqD,CAAC"}

package/dist/shared/plugins/registries/useStatusBarRegistry.d.ts

@@ -0,0 +1,3 @@
+import { StatusBarContribution } from '../types';
+export declare const useStatusBarRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<StatusBarContribution>>>;
+//# sourceMappingURL=useStatusBarRegistry.d.ts.map

package/dist/shared/plugins/registries/useStatusBarRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStatusBarRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useStatusBarRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,eAAO,MAAM,yBAAyB,sJAAsD,CAAC"}

package/dist/shared/plugins/registries/useToolbarRegistry.d.ts

@@ -0,0 +1,3 @@
+import { ToolbarContribution } from '../types';
+export declare const useToolbarRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<ToolbarContribution>>>;
+//# sourceMappingURL=useToolbarRegistry.d.ts.map

package/dist/shared/plugins/registries/useToolbarRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useToolbarRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,uBAAuB,oJAAoD,CAAC"}

package/dist/shared/plugins/registries/useWidgetRegistry.d.ts

@@ -0,0 +1,3 @@
+import { WidgetContribution } from '../types';
+export declare const useWidgetRegistryStore: import('zustand').UseBoundStore<import('zustand').StoreApi<import('./createContributionRegistry').ContributionRegistryStore<WidgetContribution>>>;
+//# sourceMappingURL=useWidgetRegistry.d.ts.map

package/dist/shared/plugins/registries/useWidgetRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWidgetRegistry.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/registries/useWidgetRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,eAAO,MAAM,sBAAsB,mJAAmD,CAAC"}

package/dist/shared/plugins/runtime.d.ts

@@ -0,0 +1,68 @@
+import { EventBus, CoreEventMap } from './event-bus';
+import { RegistryRefs, ShellServices } from './context';
+import { UIPlugin, PluginStatus } from './types';
+export interface PluginRuntimeConfig {
+    registries: RegistryRefs;
+    shell: ShellServices;
+}
+export declare class PluginRuntime {
+    private plugins;
+    readonly eventBus: EventBus<CoreEventMap>;
+    private config;
+    private currentPath?;
+    constructor(config: PluginRuntimeConfig);
+    /**
+     * Load a plugin into the runtime. Activation depends on its activation events.
+     */
+    loadPlugin(plugin: UIPlugin): Promise<void>;
+    /**
+     * Load multiple plugins in dependency order.
+     */
+    loadPlugins(plugins: UIPlugin[]): Promise<void>;
+    /**
+     * Record route changes so onRoute activation events can activate plugins.
+     */
+    handleRouteChange(path: string): void;
+    /**
+     * Activate any pending plugins waiting on a command.
+     */
+    handleCommandInvocation(commandId: string): Promise<void>;
+    /**
+     * Deactivate and unload a plugin, cleaning up all its contributions.
+     */
+    unloadPlugin(pluginId: string): Promise<void>;
+    /**
+     * Unload all plugins.
+     */
+    unloadAll(): Promise<void>;
+    /**
+     * Get a loaded plugin's status.
+     */
+    getPluginStatus(pluginId: string): PluginStatus | undefined;
+    /**
+     * Get all loaded plugin IDs.
+     */
+    getLoadedPlugins(): string[];
+    /**
+     * Check if a plugin is loaded and active.
+     */
+    isActive(pluginId: string): boolean;
+    /**
+     * Register static contributions declared in the plugin manifest.
+     */
+    private processStaticContributions;
+    /**
+     * Topological sort of plugins by their dependency graph.
+     * Plugins with no dependencies come first.
+     */
+    private topologicalSort;
+    private registerPlugin;
+    private activateIfNeeded;
+    private activatePlugin;
+    private registerDeferredActivation;
+    private getActivationEvents;
+    private matchesCurrentRoute;
+    private routePatternMatches;
+    private wrapStaticCommandContribution;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/shared/plugins/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/shared/plugins/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAuB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAEvF,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAC;AASrE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,YAAY,CAAC;IACzB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,MAAM,EAAE,mBAAmB;IAKvC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAcrC;;OAEG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/D;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3D;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQnC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAoDlC;;;OAGG;IACH,OAAO,CAAC,eAAe;IA8BvB,OAAO,CAAC,cAAc;YAqCR,gBAAgB;YAgBhB,cAAc;IA2B5B,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,6BAA6B;CAmCtC"}

package/dist/shared/plugins/types.d.ts

@@ -0,0 +1,228 @@
+import { ComponentType, LazyExoticComponent } from 'react';
+import { Disposable, DisposableCollection } from './disposable';
+import { CoreEventMap } from './event-bus';
+import { NavItem } from '../hooks/shell/useNavRegistry';
+import { FooterItem } from '../hooks/shell/useFooterRegistry';
+export type ActivationEvent = {
+    type: 'eager';
+} | {
+    type: 'onRoute';
+    pattern: string;
+} | {
+    type: 'onCommand';
+    commandId: string;
+} | {
+    type: 'onEvent';
+    eventType: string;
+};
+export interface ExtensionPointDeclaration {
+    id: string;
+    description?: string;
+}
+/** Base fields shared by all contribution items. */
+export interface ContributionBase {
+    id: string;
+    pluginId: string;
+    order?: number;
+    visible?: boolean;
+}
+/** Navigation item contribution (extends existing NavItem). */
+export type NavContribution = NavItem & {
+    pluginId: string;
+};
+/** Footer item contribution (extends existing FooterItem). */
+export type FooterContribution = FooterItem & {
+    pluginId: string;
+};
+/** Command palette command contribution. */
+export interface CommandContribution extends ContributionBase {
+    label: string;
+    description?: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    keywords?: string[];
+    shortcut?: string;
+    section?: string;
+    /** Context expression for when this command is available, e.g. "route:/vibecontrols/*" */
+    when?: string;
+    execute: () => void | Promise<void>;
+}
+/** Route contribution — plugin-owned page. */
+export interface RouteContribution extends ContributionBase {
+    path: string;
+    component: LazyExoticComponent<ComponentType<unknown>> | ComponentType<unknown>;
+    /** Which API gateway this route's data comes from. */
+    gateway?: 'workspace' | 'global';
+    /** Layout mode for the route. */
+    layout?: 'default' | 'full' | 'none';
+}
+/** Panel props passed to panel components. */
+export interface PanelProps {
+    panelId: string;
+    visible: boolean;
+    onClose: () => void;
+}
+/** Panel/view contribution. */
+export interface PanelContribution extends ContributionBase {
+    title: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    position: 'bottom' | 'left' | 'right';
+    component: ComponentType<PanelProps>;
+    /** Default size in pixels. */
+    defaultSize?: number;
+    minSize?: number;
+    maxSize?: number;
+    defaultVisible?: boolean;
+}
+/** Status bar item contribution. */
+export interface StatusBarContribution extends ContributionBase {
+    section: 'left' | 'center' | 'right';
+    priority: number;
+    component: ComponentType<Record<string, never>>;
+    tooltip?: string;
+    onClick?: () => void;
+}
+/** Settings page/section contribution. */
+export interface SettingsContribution extends ContributionBase {
+    category: string;
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    component: ComponentType<Record<string, never>>;
+}
+/** Dashboard widget contribution. */
+export interface WidgetContribution extends ContributionBase {
+    title: string;
+    description?: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    component: ComponentType<{
+        widgetId: string;
+    }>;
+    defaultSize: {
+        cols: number;
+        rows: number;
+    };
+    minSize?: {
+        cols: number;
+        rows: number;
+    };
+    maxSize?: {
+        cols: number;
+        rows: number;
+    };
+    category?: string;
+}
+/** Header toolbar item contribution. */
+export interface ToolbarContribution extends ContributionBase {
+    position: 'left' | 'center' | 'right';
+    component: ComponentType<Record<string, never>>;
+    tooltip?: string;
+}
+/** Context menu item. */
+export interface ContextMenuItem {
+    id: string;
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    shortcut?: string;
+    disabled?: boolean;
+    execute: () => void;
+}
+/** Context menu contribution. */
+export interface ContextMenuContribution extends ContributionBase {
+    /** Target element/zone this menu attaches to. */
+    target: string;
+    items: ContextMenuItem[];
+}
+export interface PluginContributions {
+    nav?: NavContribution[];
+    footer?: FooterContribution[];
+    commands?: CommandContribution[];
+    routes?: RouteContribution[];
+    panels?: PanelContribution[];
+    statusBar?: StatusBarContribution[];
+    settings?: SettingsContribution[];
+    widgets?: WidgetContribution[];
+    toolbar?: ToolbarContribution[];
+    contextMenus?: ContextMenuContribution[];
+}
+export interface UIPluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    dependencies?: string[];
+    activationEvents?: ActivationEvent[];
+    contributes?: PluginContributions;
+    extensionPoints?: ExtensionPointDeclaration[];
+}
+export interface RegistryAPI<T extends ContributionBase> {
+    register(item: T): Disposable;
+    unregister(id: string): void;
+    getAll(): T[];
+    getByPlugin(pluginId: string): T[];
+}
+export type ToastType = 'info' | 'success' | 'warning' | 'error';
+export interface PluginContext {
+    pluginId: string;
+    nav: {
+        register(items: NavContribution | NavContribution[]): Disposable;
+        unregister(id: string): void;
+    };
+    footer: {
+        register(items: FooterContribution | FooterContribution[]): Disposable;
+        unregister(id: string): void;
+    };
+    commands: RegistryAPI<CommandContribution>;
+    routes: RegistryAPI<RouteContribution>;
+    panels: RegistryAPI<PanelContribution>;
+    statusBar: RegistryAPI<StatusBarContribution>;
+    settings: RegistryAPI<SettingsContribution>;
+    widgets: RegistryAPI<WidgetContribution>;
+    toolbar: RegistryAPI<ToolbarContribution>;
+    contextMenus: RegistryAPI<ContextMenuContribution>;
+    events: {
+        on<K extends keyof CoreEventMap & string>(event: K, handler: (payload: CoreEventMap[K]) => void): Disposable;
+        on(event: string, handler: (payload: unknown) => void): Disposable;
+        once<K extends keyof CoreEventMap & string>(event: K, handler: (payload: CoreEventMap[K]) => void): Disposable;
+        once(event: string, handler: (payload: unknown) => void): Disposable;
+        emit<K extends keyof CoreEventMap & string>(event: K, payload: CoreEventMap[K]): void;
+        emit(event: string, payload: unknown): void;
+    };
+    subscriptions: DisposableCollection;
+    shell: {
+        navigate(path: string): void;
+        showToast(message: string, type?: ToastType): void;
+        getActiveContext(): {
+            workspaceId?: string;
+            tenantId?: string;
+            projectId?: string;
+        };
+        /**
+         * Returns the active user identity. Bearer tokens are intentionally
+         * redacted (`token` is always `undefined`) — plugins must use shell
+         * gateway clients for authenticated requests, not read tokens here.
+         */
+        getAuth(): {
+            user?: unknown;
+            token?: undefined;
+        };
+        getTheme(): {
+            colorMode: 'light' | 'dark';
+        };
+    };
+}
+export interface UIPlugin {
+    manifest: UIPluginManifest;
+    activate(context: PluginContext): void | Promise<void>;
+    deactivate?(): void | Promise<void>;
+}
+export type PluginStatus = 'pending' | 'activating' | 'active' | 'error';
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/plugins/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/providers/AppShellProvider.d.ts

@@ -0,0 +1,96 @@
+import { ReactNode } from 'react';
+import { Brand } from './shell/ThemeProvider';
+import { TranslationDictionary } from './shell/I18nProvider';
+import { BurdenoffEventName } from '../events';
+export interface AppShellConfig {
+    /** Product display name (e.g., "VibeControls", "FluidGrids") */
+    productName: string;
+    /** Product slug (e.g., "vibecontrols", "fluidgrids") */
+    productSlug?: string;
+    /** Product tagline */
+    tagline?: string;
+    /** Product domain (e.g., "vibecontrols.com") */
+    domain?: string;
+    /** Product ID for i18n translations service */
+    i18nProductId: string;
+    /** Resolved gateway URLs */
+    gatewayUrls: {
+        workspaceBaseUrl: string;
+        globalBaseUrl: string;
+    };
+    /** Auth bridge configuration */
+    authBridge?: {
+        url?: string;
+        allowedOrigins?: string;
+        debug?: boolean;
+    };
+    /** Default theme brand */
+    defaultBrand?: Brand;
+    /** Enable PWA install banner */
+    enablePWA?: boolean;
+    /** Brand initial for PWA banner icon */
+    brandInitial?: string;
+    /** Default gateway for top-level ApolloProvider */
+    defaultGateway?: "workspace" | "global";
+    /** Enable GraphQL subscriptions */
+    enableSubscriptions?: boolean;
+    /** Static fallback translations (keyed by locale) */
+    fallbackTranslations?: Record<string, TranslationDictionary>;
+    /** QueryClient options override */
+    queryClientOptions?: {
+        staleTime?: number;
+        retry?: number | false;
+        refetchOnWindowFocus?: boolean;
+    };
+    /** Toaster position */
+    toasterPosition?: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
+    /** Frontend telemetry sinks. MFEs emit to the shell event bus only. */
+    observability?: AppShellObservabilityConfig;
+}
+export interface AppShellObservabilityConfig {
+    enabled?: boolean;
+    appVersion?: string;
+    appEnv?: "dev" | "alpha" | "prod";
+    devtools?: boolean;
+    broadcast?: boolean;
+    rybbit?: {
+        enabled?: boolean;
+        siteId?: string;
+        scriptUrl?: string;
+        allowlist?: BurdenoffEventName[];
+        identifyOn?: BurdenoffEventName;
+        rename?: Partial<Record<BurdenoffEventName, string>>;
+    };
+    otel?: {
+        enabled?: boolean;
+        endpoint?: string;
+        serviceName?: string;
+        flushInterval?: number;
+    };
+    backendAudit?: {
+        enabled?: boolean;
+        endpoint?: string;
+    };
+}
+export interface AppShellObservabilityEnv {
+    DEV?: boolean;
+    PROD?: boolean;
+    MODE?: string;
+    VITE_DEPLOY_ENV?: string;
+    VITE_APP_VERSION?: string;
+    VITE_ENABLE_ANALYTICS?: string;
+    VITE_DISABLE_ANALYTICS?: string;
+    VITE_RYBBIT_SITE_ID?: string;
+    VITE_RYBBIT_SCRIPT_URL?: string;
+    VITE_OTEL_HTTP_ENDPOINT?: string;
+    VITE_BACKEND_AUDIT_ENDPOINT?: string;
+}
+export declare function resolveAppShellObservabilityConfig(productSlug: string, env: AppShellObservabilityEnv): AppShellObservabilityConfig;
+export interface AppShellProviderProps {
+    config: AppShellConfig;
+    children: ReactNode;
+    /** Optional callback to clear external auth stores (e.g., microfe-auth's zustand store) */
+    clearAuthStore?: () => void;
+}
+export declare function AppShellProvider({ config, children, clearAuthStore, }: AppShellProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AppShellProvider.d.ts.map