@burdenoff/fe-libs 2026.528.10 → 2026.529.1

package/dist/shared/plugins/iframe-mount/types.d.ts

@@ -0,0 +1,64 @@
+import { PluginCapabilities, PluginContribution, PluginRuntime } from './protocol/index.js';
+/**
+ * A "tunnel" the host page can query for contributions and from which
+ * iframe-mounted plugins are served. For VibeControls this is the
+ * vibecontrols-agent's Cloudflare tunnel + the current profile name;
+ * other products map to whatever serves their plugins.
+ */
+export interface MountTunnel {
+    /** Base URL — used for both fetch + iframe src. */
+    tunnelUrl: string;
+    /** Profile or scope segment the agent uses to namespace plugins. */
+    profile: string;
+    /** Optional human-readable label for picker UIs / errors. */
+    label?: string;
+    /**
+     * Factory that mints a fresh iframe token scoped to a contribution's
+     * capability `restPaths`. Called once on first mount + on each
+     * scheduled refresh. The host supplies this so the SDK stays
+     * transport-agnostic.
+     */
+    mintIframeToken: (input: {
+        pathPrefixes: string[];
+    }) => Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+}
+/**
+ * What `usePluginContributions` returns per-contribution after
+ * fetching from one or more tunnels. The `tunnel` is the source the
+ * contribution came from; multiple tunnels' results are unioned (last
+ * wins on id collisions).
+ */
+export interface DiscoveredContribution {
+    pluginKey: string;
+    pluginPackageName?: string;
+    contribution: PluginContribution;
+    capabilities: PluginCapabilities;
+    /**
+     * Relative URL — the host concatenates with `tunnel.tunnelUrl` to
+     * mount the iframe. Returned by the agent as e.g. `/ui/<pluginKey>`.
+     */
+    url: string;
+    tunnel: MountTunnel;
+}
+export type RuntimePreference = PluginRuntime | 'auto';
+export interface InProcessPluginEntry {
+    /**
+     * Plugin package key (matches `DiscoveredContribution.pluginKey`).
+     * Required to disambiguate when two different plugins contribute
+     * the same local `id` at the same `mountPoint` — without this, the
+     * later registration silently overwrites the earlier one.
+     */
+    pluginKey: string;
+    /** Matches `contribution.id`. */
+    id: string;
+    /** Matches `contribution.mountPoint`. */
+    mountPoint: string;
+    /** React component to render. Receives the same context object the iframe would. */
+    Component: React.ComponentType<{
+        context: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/plugins/iframe-mount/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/iframe-mount/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEjG;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QAC9D,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,kBAAkB,CAAC;IACjC,YAAY,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACtE"}

package/dist/shared/plugins/iframe-mount/useFetchContributions.d.ts

@@ -0,0 +1,31 @@
+import { DiscoveredContribution, MountTunnel } from './types';
+export interface UsePluginContributionsOptions {
+    /**
+     * Filter to a single mount point. When omitted, the hook returns the
+     * union of every contribution across every mount point so the host
+     * can seed multiple tab strips from one request.
+     */
+    mountPoint?: string;
+    /**
+     * Polling cadence. Defaults to 60s. Set to `false` to disable; the
+     * hook will only refetch on tunnel reconnect / focus.
+     */
+    refetchIntervalMs?: number | false;
+    enabled?: boolean;
+}
+/**
+ * Fetch plugin contributions from every supplied tunnel. Results are
+ * unioned; if two tunnels report contributions with the same `id`, the
+ * one whose tunnel.label is lexicographically smaller wins (stable,
+ * deterministic, debuggable). Authors should pick unique ids anyway.
+ */
+export declare function usePluginContributions(tunnels: MountTunnel[], opts?: UsePluginContributionsOptions): {
+    data: DiscoveredContribution[];
+    isFetching: boolean;
+    errors: Array<{
+        tunnel: MountTunnel;
+        error: unknown;
+    }>;
+    refetch: () => void;
+};
+//# sourceMappingURL=useFetchContributions.d.ts.map

package/dist/shared/plugins/iframe-mount/useFetchContributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFetchContributions.d.ts","sourceRoot":"","sources":["../../../../src/shared/plugins/iframe-mount/useFetchContributions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAwCnE,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,GAAE,6BAAkC,GACvC;IACD,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAsEA"}

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