@burdenoff/fe-libs 2026.510.126

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

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

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