hubg-app-shell 0.1.2 → 0.1.3

package/dist/components/AppShell.d.ts

@@ -8,14 +8,28 @@ export interface AppShellProps {
     navigationConfig: NavigationConfig;
     /** Content rendered inside the main area. The host app owns routing. */
     children?: React.ReactNode;
-    /** Initial active route. Defaults to window.location.pathname. */
+    /**
+     * The currently active route. Kept in sync: changes to this prop update
+     * the shell's active-route state without remounting.
+     */
     activeRoute?: string;
-    /** Called when the user clicks a nav item so the host app can update its router. */
+    /**
+     * Called when the user clicks a nav item.
+     *
+     * When provided, the shell assumes the host app's router manages history
+     * and does NOT call `window.history.pushState`.
+     * When omitted, the shell manages history itself.
+     */
     onNavigate?: (path: string) => void;
     /** Background color for the tenant logo tile in the sidebar. */
     tenantBrandColor?: string;
-    /** Items pinned at the bottom of the sidebar (e.g. Hub Settings, Help, Shortcuts). */
+    /** Items pinned at the bottom of the sidebar (e.g. Hub Settings). */
     footerNavItems?: NavItem[];
+    /**
+     * Called when an unhandled error is caught by the top-level error boundary.
+     * Use to wire up Sentry, Datadog RUM, or any other telemetry sink.
+     */
+    onError?: (error: Error, info: React.ErrorInfo) => void;
 }
-export declare function AppShell(props: AppShellProps): React.JSX.Element;
+export declare function AppShell({ onError, ...props }: AppShellProps): React.JSX.Element;
 //# sourceMappingURL=AppShell.d.ts.map

package/dist/components/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/components/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAIxE,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,EAAE,aAAa,CAAC;IACvB,0CAA0C;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B;AAyFD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAU5C"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/components/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAIxE,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,EAAE,aAAa,CAAC;IACvB,0CAA0C;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;CACzD;AAqJD,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,qBAY5D"}

package/dist/components/Header.d.ts

@@ -5,9 +5,28 @@ export interface HeaderProps {
     tenant: TenantContext;
     /**
      * Extra controls injected between the utility icons and the user avatar.
-     * Use for app-specific buttons (notifications counter, feedback, etc.).
+     * Used for app-specific buttons (notifications badge, feedback widget, etc.).
      */
     rightSlot?: React.ReactNode;
+    /**
+     * URL for the "Settings" menu item. Defaults to "/settings/profile".
+     * Override this for apps with a different profile settings route.
+     */
+    settingsHref?: string;
+    /**
+     * URL for the "Log out" action. Defaults to "/member/logout".
+     */
+    logoutHref?: string;
+    /**
+     * Called when the "Members online" icon is clicked.
+     * Omit to hide the button (stub buttons are an accessibility anti-pattern).
+     */
+    onMembersOnlineClick?: React.MouseEventHandler<HTMLButtonElement>;
+    /**
+     * Called when the "Notifications" icon is clicked.
+     * Omit to hide the button.
+     */
+    onNotificationsClick?: React.MouseEventHandler<HTMLButtonElement>;
 }
 export declare const Header: React.NamedExoticComponent<HeaderProps>;
 //# sourceMappingURL=Header.d.ts.map

package/dist/components/Header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/components/Header.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAyGtE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED,eAAO,MAAM,MAAM,yCA+BjB,CAAC"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../src/components/Header.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAc/B,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAkHtE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAClE;;;OAGG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;CACnE;AAED,eAAO,MAAM,MAAM,yCAkDjB,CAAC"}

package/dist/components/ModuleHost.d.ts

@@ -2,12 +2,15 @@ import type { ApplicationModule } from "../types/module.js";
 import type { ModuleContext } from "../types/context.js";
 import type { PlatformAPI } from "../types/platform.js";
 export interface ModuleHostProps {
-    /** Resolved module implementation. Null while being loaded by the caller. */
+    /** Resolved module implementation. Pass null while loading. */
     module: ApplicationModule | null;
     moduleId: string;
     context: ModuleContext;
     platform: PlatformAPI;
     className?: string;
+    /** Called when an error is caught by the surrounding error boundary. */
+    onError?: (error: Error, info: React.ErrorInfo) => void;
 }
-export declare function ModuleHost({ module, moduleId, context, platform, className, }: ModuleHostProps): import("react").JSX.Element;
+import type React from "react";
+export declare function ModuleHost({ module, moduleId, context, platform, className, onError, }: ModuleHostProps): React.JSX.Element;
 //# sourceMappingURL=ModuleHost.d.ts.map

package/dist/components/ModuleHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModuleHost.d.ts","sourceRoot":"","sources":["../../src/components/ModuleHost.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsHxD,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE,eAAe,+BAwCjB"}
+{"version":3,"file":"ModuleHost.d.ts","sourceRoot":"","sources":["../../src/components/ModuleHost.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAwC,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA0HxD,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;CACzD;AAGD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,GACR,EAAE,eAAe,qBA8CjB"}

package/dist/components/ShellErrorBoundary.d.ts

@@ -5,21 +5,21 @@ interface ErrorBoundaryState {
 }
 interface ShellErrorBoundaryProps {
     children: React.ReactNode;
-    /** Called when an error is caught — use for logging/telemetry. */
+    /** Called when an error is caught — wire up Sentry, Datadog RUM, etc. */
     onError?: (error: Error, info: React.ErrorInfo) => void;
-    /** Custom fallback; receives the error and a retry handler. */
+    /** Custom fallback UI. Receives the error and a retry callback. */
     fallback?: (error: Error, retry: () => void) => React.ReactNode;
 }
 /**
- * React class-based error boundary scoped to a single module slot.
- * A failure inside a module's render tree is caught here and presented
- * as an isolated error state — the rest of the shell remains functional.
+ * React class-based error boundary that isolates a module slot or the
+ * entire shell. A crash inside the tree is caught here, logged, and shown
+ * as an isolated error state so the rest of the application stays alive.
  */
 export declare class ShellErrorBoundary extends React.Component<ShellErrorBoundaryProps, ErrorBoundaryState> {
     constructor(props: ShellErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
     componentDidCatch(error: Error, info: React.ErrorInfo): void;
-    private handleRetry;
+    private readonly handleRetry;
     render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
 }
 export {};

package/dist/components/ShellErrorBoundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShellErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ShellErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;CACjE;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK,CAAC,SAAS,CACrD,uBAAuB,EACvB,kBAAkB,CACnB;gBACa,KAAK,EAAE,uBAAuB;IAK1C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAI5D,OAAO,CAAC,WAAW,CAEjB;IAEF,MAAM;CASP"}
+{"version":3,"file":"ShellErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ShellErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IACxD,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;CACjE;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK,CAAC,SAAS,CACrD,uBAAuB,EACvB,kBAAkB,CACnB;gBACa,KAAK,EAAE,uBAAuB;IAK1C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAM5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,MAAM;CAWP"}

package/dist/components/SideNavigation.d.ts

@@ -6,9 +6,7 @@ export interface SideNavigationProps {
     permissions: string[];
     onNavigate: (route: string) => void;
     tenant: TenantContext;
-    /** Background color for the tenant logo tile */
     tenantBrandColor?: string;
-    /** Items pinned at the bottom (e.g. Hub Settings, Help, Shortcuts) */
     footerNavItems?: NavItem[];
 }
 export declare const SideNavigation: React.NamedExoticComponent<SideNavigationProps>;

package/dist/components/SideNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SideNavigation.d.ts","sourceRoot":"","sources":["../../src/components/SideNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAc/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkQzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,iDAqFzB,CAAC"}
+{"version":3,"file":"SideNavigation.d.ts","sourceRoot":"","sources":["../../src/components/SideNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmRzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,iDAqGzB,CAAC"}

package/dist/components/ui/accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../../src/components/ui/accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAIhE,QAAA,MAAM,SAAS,8JAA0B,CAAC;AAE1C,QAAA,MAAM,aAAa,iKAKjB,CAAC;AAGH,QAAA,MAAM,gBAAgB;kBAGJ,OAAO;2CAmBvB,CAAC;AAGH,QAAA,MAAM,gBAAgB,oKAWpB,CAAC;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"accordion.d.ts","sourceRoot":"","sources":["../../../src/components/ui/accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAIhE,QAAA,MAAM,SAAS,8JAA0B,CAAC;AAE1C,QAAA,MAAM,aAAa,iKAKjB,CAAC;AAGH,QAAA,MAAM,gBAAgB;kBAGJ,OAAO;2CAyBvB,CAAC;AAGH,QAAA,MAAM,gBAAgB,oKAWpB,CAAC;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/ui/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/ui/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,cAAc;;;8EAkCnB,CAAC;AAEF,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,QAAA,MAAM,MAAM,uFAWX,CAAC;AAGF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/ui/button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,QAAA,MAAM,cAAc;;;8EAkCnB,CAAC;AAEF,MAAM,WAAW,WACf,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EACnD,YAAY,CAAC,OAAO,cAAc,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,QAAA,MAAM,MAAM,uFAaX,CAAC;AAGF,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/context/ShellContext.d.ts

@@ -1,14 +1,11 @@
 import React from "react";
-interface ShellContextValue {
+export interface ShellContextValue {
     /** Whether the side navigation is collapsed to icon-only mode. */
     navCollapsed: boolean;
-    setNavCollapsed: (collapsed: boolean | ((prev: boolean) => boolean)) => void;
-    /** Title shown in the header, set by the shell when a nav item activates. */
-    pageTitle: string | undefined;
-    setPageTitle: (title: string | undefined) => void;
+    setNavCollapsed: React.Dispatch<React.SetStateAction<boolean>>;
     /** The currently active route, owned by the shell. */
     activeRoute: string;
-    setActiveRoute: (route: string) => void;
+    setActiveRoute: React.Dispatch<React.SetStateAction<string>>;
 }
 export declare function useShell(): ShellContextValue;
 interface ShellProviderProps {

package/dist/context/ShellContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShellContext.d.ts","sourceRoot":"","sources":["../../src/context/ShellContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoE,MAAM,OAAO,CAAC;AAEzF,UAAU,iBAAiB;IACzB,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,CAAC,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7E,6EAA6E;IAC7E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAID,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,kBAAkB,qBAyB3E"}
+{"version":3,"file":"ShellContext.d.ts","sourceRoot":"","sources":["../../src/context/ShellContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuD,MAAM,OAAO,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CAC9D;AAID,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,kBAAkB,qBAW3E"}

package/dist/events/EventBus.d.ts

@@ -1,16 +1,21 @@
 import type { EventHandler, PlatformEvent } from "../types/platform.js";
 /**
  * Lightweight pub/sub bus shared across the shell and all mounted modules.
- * Modules receive a scoped view via `createPlatformAPI` — they can only
- * publish and subscribe, never clear the bus or inspect other handlers.
+ * Modules interact through a scoped view created by `createPlatformAPI` —
+ * they can only publish and subscribe, not clear or inspect the bus.
  */
 export declare class EventBus {
     private readonly handlers;
+    /** Optional telemetry hook for handler errors. */
+    onHandlerError?: (error: unknown, event: PlatformEvent) => void;
     publish(event: PlatformEvent): void;
     subscribe(eventType: string, handler: EventHandler): () => void;
-    /** Publish a context-update event for a specific field. */
+    /**
+     * Remove all handlers registered by a specific module.
+     * Call this when a module is unmounted to prevent orphaned subscribers.
+     */
+    clearModule(handlers: Set<() => void>): void;
     publishContextUpdate(field: string, value: unknown): void;
-    /** Publish a theme-change event. */
     publishThemeUpdate(payload: unknown): void;
 }
 //# sourceMappingURL=EventBus.d.ts.map

package/dist/events/EventBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAYnC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAa/D,2DAA2D;IAC3D,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzD,oCAAoC;IACpC,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAG3C"}
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/events/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;GAIG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,kDAAkD;IAClD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAEhE,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAcnC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAa/D;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAM5C,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIzD,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAG3C"}