@semiont/react-ui 0.4.1 → 0.4.3

package/dist/{PdfAnnotationCanvas.client-PVTVPDBQ.mjs → PdfAnnotationCanvas.client-LF6DDTCV.mjs}

@@ -2,8 +2,8 @@
 "use client";
 import {
   createHoverHandlers
-} from "./chunk-ZPV43WN2.mjs";
-import "./chunk-2HGWOLVN.mjs";
+} from "./chunk-XMCUHQ2Y.mjs";
+import "./chunk-5JZFKRLW.mjs";
 import "./chunk-D4GAAQMM.mjs";
 
 // src/components/pdf-annotation/PdfAnnotationCanvas.tsx
@@ -505,4 +505,4 @@ function PdfAnnotationCanvas({
 export {
   PdfAnnotationCanvas
 };
-//# sourceMappingURL=PdfAnnotationCanvas.client-PVTVPDBQ.mjs.map
+//# sourceMappingURL=PdfAnnotationCanvas.client-LF6DDTCV.mjs.map

package/dist/chunk-5JZFKRLW.mjs

@@ -0,0 +1,62 @@
+'use client';
+
+// src/contexts/ApiClientContext.tsx
+import { createContext, useContext, useMemo } from "react";
+import { baseUrl } from "@semiont/core";
+import { SemiontApiClient } from "@semiont/api-client";
+import { jsx } from "react/jsx-runtime";
+var ApiClientContext = createContext(void 0);
+function ApiClientProvider({
+  baseUrl: url,
+  children
+}) {
+  const client = useMemo(
+    () => new SemiontApiClient({
+      baseUrl: baseUrl(url),
+      // Use no timeout in test environment to avoid AbortController issues with ky + vitest
+      ...process.env.NODE_ENV !== "test" && { timeout: 3e4 }
+    }),
+    [url]
+    // Only baseUrl in deps, token removed
+  );
+  return /* @__PURE__ */ jsx(ApiClientContext.Provider, { value: client, children });
+}
+function useApiClient() {
+  const context = useContext(ApiClientContext);
+  if (context === void 0) {
+    throw new Error("useApiClient must be used within an ApiClientProvider");
+  }
+  return context;
+}
+
+// src/contexts/EventBusContext.tsx
+import { createContext as createContext2, useContext as useContext2, useMemo as useMemo2 } from "react";
+import { EventBus } from "@semiont/core";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var EventBusContext = createContext2(null);
+var globalEventBus = new EventBus();
+function resetEventBusForTesting() {
+  globalEventBus.destroy();
+  globalEventBus = new EventBus();
+  return globalEventBus;
+}
+function EventBusProvider({ children }) {
+  const eventBus = useMemo2(() => globalEventBus, []);
+  return /* @__PURE__ */ jsx2(EventBusContext.Provider, { value: eventBus, children });
+}
+function useEventBus() {
+  const eventBus = useContext2(EventBusContext);
+  if (!eventBus) {
+    throw new Error("useEventBus must be used within EventBusProvider");
+  }
+  return eventBus;
+}
+
+export {
+  ApiClientProvider,
+  useApiClient,
+  resetEventBusForTesting,
+  EventBusProvider,
+  useEventBus
+};
+//# sourceMappingURL=chunk-5JZFKRLW.mjs.map

package/dist/chunk-5JZFKRLW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/ApiClientContext.tsx","../src/contexts/EventBusContext.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, ReactNode, useMemo } from 'react';\nimport { baseUrl } from '@semiont/core';\nimport { SemiontApiClient } from '@semiont/api-client';\n\nconst ApiClientContext = createContext<SemiontApiClient | undefined>(undefined);\n\nexport interface ApiClientProviderProps {\n  baseUrl: string;\n  children: ReactNode;\n}\n\n/**\n * Provider for API client - creates a stateless singleton client\n * The client instance never changes (no token dependency)\n * Auth tokens are passed per-request via useAuthToken() in calling code\n */\nexport function ApiClientProvider({\n  baseUrl: url,\n  children,\n}: ApiClientProviderProps) {\n  // Client created once and never recreated (no token dependency)\n  const client = useMemo(\n    () => new SemiontApiClient({\n      baseUrl: baseUrl(url),\n      // Use no timeout in test environment to avoid AbortController issues with ky + vitest\n      ...(process.env.NODE_ENV !== 'test' && { timeout: 30000 }),\n    }),\n    [url] // Only baseUrl in deps, token removed\n  );\n\n  return (\n    <ApiClientContext.Provider value={client}>\n      {children}\n    </ApiClientContext.Provider>\n  );\n}\n\n/**\n * Hook to access the stateless API client singleton\n * Must be used within an ApiClientProvider\n * @returns Stateless SemiontApiClient instance\n */\nexport function useApiClient(): SemiontApiClient {\n  const context = useContext(ApiClientContext);\n\n  if (context === undefined) {\n    throw new Error('useApiClient must be used within an ApiClientProvider');\n  }\n\n  return context;\n}\n","'use client';\n\nimport { createContext, useContext, useMemo, type ReactNode } from 'react';\nimport { EventBus } from '@semiont/core';\n\nconst EventBusContext = createContext<EventBus | null>(null);\n\n/**\n * Global singleton event bus.\n *\n * Uses RxJS-based EventBus from @semiont/core for framework-agnostic event routing.\n *\n * This ensures all components in the application share the same event bus instance,\n * which is critical for cross-component communication (e.g., hovering an annotation\n * in one component scrolls the panel in another component).\n *\n * FUTURE: Multi-Window Support\n * When we need to support multiple document windows (e.g., pop-out resource viewers),\n * we'll need to transition to a per-window event bus architecture:\n *\n * Option 1: Window-scoped event bus\n *   - Create a new event bus for each window/portal\n *   - Pass windowId or documentId to EventBusProvider\n *   - Store Map<windowId, EventBus> instead of single global\n *   - Components use useEventBus(windowId) to get correct bus\n *\n * Option 2: Event bus hierarchy\n *   - Global event bus for app-wide events (settings, navigation)\n *   - Per-document event bus for document-specific events (annotation hover)\n *   - Components subscribe to both buses as needed\n *\n * Option 3: Cross-window event bridge\n *   - Keep per-window buses isolated\n *   - Use BroadcastChannel or postMessage for cross-window events\n *   - Bridge pattern to sync certain events across windows\n *\n * For now, single global bus is correct for single-window app.\n */\nlet globalEventBus = new EventBus();\n\n/**\n * Reset the global event bus - FOR TESTING ONLY.\n *\n * Call this in test setup (beforeEach) to ensure test isolation.\n * Each test gets a fresh event bus with no lingering subscriptions.\n *\n * @returns The new EventBus instance\n *\n * @example\n * ```typescript\n * beforeEach(() => {\n *   const eventBus = resetEventBusForTesting();\n * });\n * ```\n */\nexport function resetEventBusForTesting(): EventBus {\n  globalEventBus.destroy();\n  globalEventBus = new EventBus();\n  return globalEventBus;\n}\n\nexport interface EventBusProviderProps {\n  children: ReactNode;\n}\n\n/**\n * Unified event bus provider for all application events\n *\n * Consolidates three previous event buses:\n * - MakeMeaningEventBus (document/annotation operations)\n * - NavigationEventBus (navigation and sidebar UI)\n * - GlobalSettingsEventBus (app-wide settings)\n *\n * Benefits:\n * - Single import: useEventBus()\n * - No decision fatigue about which bus to use\n * - Easier cross-domain coordination\n * - Simpler provider hierarchy\n *\n * NOTE: This provider uses a global singleton event bus to ensure all components\n * share the same instance. Multiple providers in the tree will all reference the\n * same global bus.\n *\n * Operation handlers (API calls triggered by events) are set up separately via\n * the useBindFlow hook, which should be called at the resource page level.\n */\nexport function EventBusProvider({ children }: EventBusProviderProps) {\n  const eventBus = useMemo(() => globalEventBus, []);\n\n  return (\n    <EventBusContext.Provider value={eventBus}>\n      {children}\n    </EventBusContext.Provider>\n  );\n}\n\n/**\n * Hook to access the unified event bus\n *\n * Use this everywhere instead of:\n * - useMakeMeaningEvents()\n * - useNavigationEvents()\n * - useGlobalSettingsEvents()\n *\n * @example\n * ```typescript\n * const eventBus = useEventBus();\n *\n * // Emit any event\n * eventBus.get('beckon:hover').next({ annotationId: '123' });\n * eventBus.get('browse:sidebar-toggle').next(undefined);\n * eventBus.get('settings:theme-changed').next({ theme: 'dark' });\n *\n * // Subscribe to any event\n * useEffect(() => {\n *   const unsubscribe = eventBus.on('beckon:hover', ({ annotationId }) => {\n *     console.log(annotationId);\n *   });\n *   return () => unsubscribe();\n * }, []);\n * ```\n */\nexport function useEventBus(): EventBus {\n  const eventBus = useContext(EventBusContext);\n  if (!eventBus) {\n    throw new Error('useEventBus must be used within EventBusProvider');\n  }\n  return eventBus;\n}\n"],"mappings":";;;AAEA,SAAS,eAAe,YAAuB,eAAe;AAC9D,SAAS,eAAe;AACxB,SAAS,wBAAwB;AA6B7B;AA3BJ,IAAM,mBAAmB,cAA4C,MAAS;AAYvE,SAAS,kBAAkB;AAAA,EAChC,SAAS;AAAA,EACT;AACF,GAA2B;AAEzB,QAAM,SAAS;AAAA,IACb,MAAM,IAAI,iBAAiB;AAAA,MACzB,SAAS,QAAQ,GAAG;AAAA;AAAA,MAEpB,GAAI,QAAQ,IAAI,aAAa,UAAU,EAAE,SAAS,IAAM;AAAA,IAC1D,CAAC;AAAA,IACD,CAAC,GAAG;AAAA;AAAA,EACN;AAEA,SACE,oBAAC,iBAAiB,UAAjB,EAA0B,OAAO,QAC/B,UACH;AAEJ;AAOO,SAAS,eAAiC;AAC/C,QAAM,UAAU,WAAW,gBAAgB;AAE3C,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACzE;AAEA,SAAO;AACT;;;AClDA,SAAS,iBAAAA,gBAAe,cAAAC,aAAY,WAAAC,gBAA+B;AACnE,SAAS,gBAAgB;AAuFrB,gBAAAC,YAAA;AArFJ,IAAM,kBAAkBH,eAA+B,IAAI;AAiC3D,IAAI,iBAAiB,IAAI,SAAS;AAiB3B,SAAS,0BAAoC;AAClD,iBAAe,QAAQ;AACvB,mBAAiB,IAAI,SAAS;AAC9B,SAAO;AACT;AA2BO,SAAS,iBAAiB,EAAE,SAAS,GAA0B;AACpE,QAAM,WAAWE,SAAQ,MAAM,gBAAgB,CAAC,CAAC;AAEjD,SACE,gBAAAC,KAAC,gBAAgB,UAAhB,EAAyB,OAAO,UAC9B,UACH;AAEJ;AA4BO,SAAS,cAAwB;AACtC,QAAM,WAAWF,YAAW,eAAe;AAC3C,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AACA,SAAO;AACT;","names":["createContext","useContext","useMemo","jsx"]}

package/dist/{chunk-PFQYNPQJ.mjs → chunk-F74ZQJMA.mjs}

@@ -6,47 +6,18 @@ import {
   __glob
 } from "./chunk-D4GAAQMM.mjs";
 
-// src/contexts/ApiClientContext.tsx
-import { createContext, useContext, useMemo } from "react";
-import { baseUrl } from "@semiont/core";
-import { SemiontApiClient } from "@semiont/api-client";
-import { jsx } from "react/jsx-runtime";
-var ApiClientContext = createContext(void 0);
-function ApiClientProvider({
-  baseUrl: url,
-  children
-}) {
-  const client = useMemo(
-    () => new SemiontApiClient({
-      baseUrl: baseUrl(url),
-      // Use no timeout in test environment to avoid AbortController issues with ky + vitest
-      ...process.env.NODE_ENV !== "test" && { timeout: 3e4 }
-    }),
-    [url]
-    // Only baseUrl in deps, token removed
-  );
-  return /* @__PURE__ */ jsx(ApiClientContext.Provider, { value: client, children });
-}
-function useApiClient() {
-  const context = useContext(ApiClientContext);
-  if (context === void 0) {
-    throw new Error("useApiClient must be used within an ApiClientProvider");
-  }
-  return context;
-}
-
 // src/contexts/SessionContext.tsx
-import { createContext as createContext2, useContext as useContext2 } from "react";
-import { jsx as jsx2 } from "react/jsx-runtime";
-var SessionContext = createContext2(null);
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var SessionContext = createContext(null);
 function SessionProvider({
   sessionManager,
   children
 }) {
-  return /* @__PURE__ */ jsx2(SessionContext.Provider, { value: sessionManager, children });
+  return /* @__PURE__ */ jsx(SessionContext.Provider, { value: sessionManager, children });
 }
 function useSessionContext() {
-  const context = useContext2(SessionContext);
+  const context = useContext(SessionContext);
   if (!context) {
     throw new Error("useSessionContext must be used within SessionProvider");
   }
@@ -56,12 +27,12 @@ function useSessionContext() {
 // src/components/Toast.tsx
 import React, { useEffect, useState } from "react";
 import { createPortal } from "react-dom";
-import { jsx as jsx3, jsxs } from "react/jsx-runtime";
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
 var icons = {
-  success: /* @__PURE__ */ jsx3("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx3("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M5 13l4 4L19 7" }) }),
-  error: /* @__PURE__ */ jsx3("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx3("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }),
-  warning: /* @__PURE__ */ jsx3("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx3("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" }) }),
-  info: /* @__PURE__ */ jsx3("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx3("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) })
+  success: /* @__PURE__ */ jsx2("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M5 13l4 4L19 7" }) }),
+  error: /* @__PURE__ */ jsx2("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }),
+  warning: /* @__PURE__ */ jsx2("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" }) }),
+  info: /* @__PURE__ */ jsx2("svg", { className: "semiont-toast-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) })
 };
 function Toast({ toast, onClose }) {
   useEffect(() => {
@@ -77,15 +48,15 @@ function Toast({ toast, onClose }) {
       "data-variant": toast.type,
       role: "alert",
       children: [
-        /* @__PURE__ */ jsx3("div", { className: "semiont-toast-icon-wrapper", children: icons[toast.type] }),
-        /* @__PURE__ */ jsx3("p", { className: "semiont-toast-message", children: toast.message }),
-        /* @__PURE__ */ jsx3(
+        /* @__PURE__ */ jsx2("div", { className: "semiont-toast-icon-wrapper", children: icons[toast.type] }),
+        /* @__PURE__ */ jsx2("p", { className: "semiont-toast-message", children: toast.message }),
+        /* @__PURE__ */ jsx2(
           "button",
           {
             onClick: () => onClose(toast.id),
             className: "semiont-toast-close",
             "aria-label": "Close",
-            children: /* @__PURE__ */ jsx3("svg", { className: "semiont-toast-close-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx3("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) })
+            children: /* @__PURE__ */ jsx2("svg", { className: "semiont-toast-close-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: /* @__PURE__ */ jsx2("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) })
           }
         )
       ]
@@ -100,7 +71,7 @@ function ToastContainer({ toasts, onClose }) {
   }, []);
   if (!mounted) return null;
   return createPortal(
-    /* @__PURE__ */ jsx3("div", { className: "semiont-toast-container", children: toasts.map((toast) => /* @__PURE__ */ jsx3(Toast, { toast, onClose }, toast.id)) }),
+    /* @__PURE__ */ jsx2("div", { className: "semiont-toast-container", children: toasts.map((toast) => /* @__PURE__ */ jsx2(Toast, { toast, onClose }, toast.id)) }),
     document.body
   );
 }
@@ -125,7 +96,7 @@ function ToastProvider({ children }) {
   );
   return /* @__PURE__ */ jsxs(ToastContext.Provider, { value: contextValue, children: [
     children,
-    /* @__PURE__ */ jsx3(ToastContainer, { toasts, onClose: handleClose })
+    /* @__PURE__ */ jsx2(ToastContainer, { toasts, onClose: handleClose })
   ] });
 }
 function useToast() {
@@ -137,17 +108,17 @@ function useToast() {
 }
 
 // src/contexts/OpenResourcesContext.tsx
-import { createContext as createContext3, useContext as useContext3 } from "react";
-import { jsx as jsx4 } from "react/jsx-runtime";
-var OpenResourcesContext = createContext3(void 0);
+import { createContext as createContext2, useContext as useContext2 } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var OpenResourcesContext = createContext2(void 0);
 function OpenResourcesProvider({
   openResourcesManager,
   children
 }) {
-  return /* @__PURE__ */ jsx4(OpenResourcesContext.Provider, { value: openResourcesManager, children });
+  return /* @__PURE__ */ jsx3(OpenResourcesContext.Provider, { value: openResourcesManager, children });
 }
 function useOpenResources() {
-  const context = useContext3(OpenResourcesContext);
+  const context = useContext2(OpenResourcesContext);
   if (context === void 0) {
     throw new Error("useOpenResources must be used within an OpenResourcesProvider");
   }
@@ -155,8 +126,8 @@ function useOpenResources() {
 }
 
 // src/contexts/TranslationContext.tsx
-import { createContext as createContext4, useContext as useContext4, useState as useState2, useEffect as useEffect2, useMemo as useMemo2 } from "react";
-import { Fragment, jsx as jsx5 } from "react/jsx-runtime";
+import { createContext as createContext3, useContext as useContext3, useState as useState2, useEffect as useEffect2, useMemo } from "react";
+import { Fragment, jsx as jsx4 } from "react/jsx-runtime";
 
 // import("../../translations/**/*.json") in src/contexts/TranslationContext.tsx
 var globImport_translations_json = __glob({
@@ -192,7 +163,7 @@ var globImport_translations_json = __glob({
 });
 
 // src/contexts/TranslationContext.tsx
-var TranslationContext = createContext4(null);
+var TranslationContext = createContext3(null);
 var translationCache = /* @__PURE__ */ new Map();
 function processPluralFormat(text, params) {
   const pluralMatch = text.match(/\{(\w+),\s*plural,\s*/);
@@ -356,7 +327,7 @@ function TranslationProvider({
       });
     }
   }, [locale, translationManager]);
-  const localeManager = useMemo2(() => {
+  const localeManager = useMemo(() => {
     if (!loadedTranslations) return null;
     return {
       t: (namespace, key, params) => {
@@ -378,18 +349,18 @@ function TranslationProvider({
     };
   }, [loadedTranslations, locale]);
   if (translationManager) {
-    return /* @__PURE__ */ jsx5(TranslationContext.Provider, { value: translationManager, children });
+    return /* @__PURE__ */ jsx4(TranslationContext.Provider, { value: translationManager, children });
   }
   if (locale && isLoading) {
-    return /* @__PURE__ */ jsx5(Fragment, { children: loadingComponent });
+    return /* @__PURE__ */ jsx4(Fragment, { children: loadingComponent });
   }
   if (locale && localeManager) {
-    return /* @__PURE__ */ jsx5(TranslationContext.Provider, { value: localeManager, children });
+    return /* @__PURE__ */ jsx4(TranslationContext.Provider, { value: localeManager, children });
   }
-  return /* @__PURE__ */ jsx5(TranslationContext.Provider, { value: defaultTranslationManager, children });
+  return /* @__PURE__ */ jsx4(TranslationContext.Provider, { value: defaultTranslationManager, children });
 }
 function useTranslations(namespace) {
-  const context = useContext4(TranslationContext);
+  const context = useContext3(TranslationContext);
   if (!context) {
     return (key, params) => {
       const translations = en_default;
@@ -427,8 +398,6 @@ function usePreloadTranslations() {
 }
 
 export {
-  ApiClientProvider,
-  useApiClient,
   SessionProvider,
   useSessionContext,
   ToastContainer,
@@ -441,4 +410,4 @@ export {
   useTranslations,
   usePreloadTranslations
 };
-//# sourceMappingURL=chunk-PFQYNPQJ.mjs.map
+//# sourceMappingURL=chunk-F74ZQJMA.mjs.map

package/dist/chunk-F74ZQJMA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/SessionContext.tsx","../src/components/Toast.tsx","../src/contexts/OpenResourcesContext.tsx","../src/contexts/TranslationContext.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, useContext, ReactNode } from 'react';\nimport type { SessionManager } from '../types/SessionManager';\n\nconst SessionContext = createContext<SessionManager | null>(null);\n\n/**\n * Provider Pattern: Accepts SessionManager implementation as prop\n * and makes it available to child components via Context.\n *\n * Apps provide their own implementation (next-auth, custom auth, etc.)\n * and pass it to this provider at the root level.\n *\n * @example\n * ```tsx\n * // In app root\n * const sessionManager = useSessionManager(); // App's implementation\n *\n * <SessionProvider sessionManager={sessionManager}>\n *   <App />\n * </SessionProvider>\n * ```\n */\nexport function SessionProvider({\n  sessionManager,\n  children\n}: {\n  sessionManager: SessionManager;\n  children: ReactNode;\n}) {\n  return (\n    <SessionContext.Provider value={sessionManager}>\n      {children}\n    </SessionContext.Provider>\n  );\n}\n\n/**\n * Hook to access SessionManager from Context\n * Components use this hook to access session state and expiry information\n */\nexport function useSessionContext() {\n  const context = useContext(SessionContext);\n  if (!context) {\n    throw new Error('useSessionContext must be used within SessionProvider');\n  }\n  return context;\n}","'use client';\n\nimport React, { useEffect, useState } from 'react';\nimport { createPortal } from 'react-dom';\nimport './Toast.css';\n\nexport type ToastType = 'success' | 'error' | 'info' | 'warning';\n\nexport interface ToastMessage {\n  id: string;\n  message: string;\n  type: ToastType;\n  duration?: number;\n}\n\ninterface ToastProps {\n  toast: ToastMessage;\n  onClose: (id: string) => void;\n}\n\nconst icons = {\n  success: (\n    <svg className=\"semiont-toast-icon\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n      <path strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth={2} d=\"M5 13l4 4L19 7\" />\n    </svg>\n  ),\n  error: (\n    <svg className=\"semiont-toast-icon\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n      <path strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth={2} d=\"M6 18L18 6M6 6l12 12\" />\n    </svg>\n  ),\n  warning: (\n    <svg className=\"semiont-toast-icon\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n      <path strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth={2} d=\"M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z\" />\n    </svg>\n  ),\n  info: (\n    <svg className=\"semiont-toast-icon\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n      <path strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth={2} d=\"M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z\" />\n    </svg>\n  ),\n};\n\nfunction Toast({ toast, onClose }: ToastProps) {\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      onClose(toast.id);\n    }, toast.duration || 3000);\n\n    return () => clearTimeout(timer);\n  }, [toast, onClose]);\n\n  return (\n    <div\n      className=\"semiont-toast\"\n      data-variant={toast.type}\n      role=\"alert\"\n    >\n      <div className=\"semiont-toast-icon-wrapper\">{icons[toast.type]}</div>\n      <p className=\"semiont-toast-message\">{toast.message}</p>\n      <button\n        onClick={() => onClose(toast.id)}\n        className=\"semiont-toast-close\"\n        aria-label=\"Close\"\n      >\n        <svg className=\"semiont-toast-close-icon\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n          <path strokeLinecap=\"round\" strokeLinejoin=\"round\" strokeWidth={2} d=\"M6 18L18 6M6 6l12 12\" />\n        </svg>\n      </button>\n    </div>\n  );\n}\n\ninterface ToastContainerProps {\n  toasts: ToastMessage[];\n  onClose: (id: string) => void;\n}\n\nexport function ToastContainer({ toasts, onClose }: ToastContainerProps) {\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => {\n    setMounted(true);\n    return () => setMounted(false);\n  }, []);\n\n  if (!mounted) return null;\n\n  return createPortal(\n    <div className=\"semiont-toast-container\">\n      {toasts.map((toast) => (\n        <Toast key={toast.id} toast={toast} onClose={onClose} />\n      ))}\n    </div>,\n    document.body\n  );\n}\n\n// Toast context and hook for global toast management\ninterface ToastContextType {\n  showToast: (message: string, type?: ToastType, duration?: number) => void;\n  showSuccess: (message: string, duration?: number) => void;\n  showError: (message: string, duration?: number) => void;\n  showWarning: (message: string, duration?: number) => void;\n  showInfo: (message: string, duration?: number) => void;\n}\n\nconst ToastContext = React.createContext<ToastContextType | undefined>(undefined);\n\nexport function ToastProvider({ children }: { children: React.ReactNode }) {\n  const [toasts, setToasts] = useState<ToastMessage[]>([]);\n\n  const showToast = React.useCallback((message: string, type: ToastType = 'info', duration?: number) => {\n    const id = Date.now().toString();\n    const newToast: ToastMessage = duration !== undefined\n      ? { id, message, type, duration }\n      : { id, message, type };\n    setToasts((prev) => [...prev, newToast]);\n  }, []);\n\n  const showSuccess = React.useCallback((message: string, duration?: number) => showToast(message, 'success', duration), [showToast]);\n  const showError = React.useCallback((message: string, duration?: number) => showToast(message, 'error', duration), [showToast]);\n  const showWarning = React.useCallback((message: string, duration?: number) => showToast(message, 'warning', duration), [showToast]);\n  const showInfo = React.useCallback((message: string, duration?: number) => showToast(message, 'info', duration), [showToast]);\n\n  const handleClose = React.useCallback((id: string) => {\n    setToasts((prev) => prev.filter((toast) => toast.id !== id));\n  }, []);\n\n  const contextValue = React.useMemo(\n    () => ({ showToast, showSuccess, showError, showWarning, showInfo }),\n    [showToast, showSuccess, showError, showWarning, showInfo]\n  );\n\n  return (\n    <ToastContext.Provider value={contextValue}>\n      {children}\n      <ToastContainer toasts={toasts} onClose={handleClose} />\n    </ToastContext.Provider>\n  );\n}\n\nexport function useToast() {\n  const context = React.useContext(ToastContext);\n  if (context === undefined) {\n    throw new Error('useToast must be used within a ToastProvider');\n  }\n  return context;\n}","'use client';\n\nimport React, { createContext, useContext } from 'react';\nimport type { OpenResourcesManager } from '../types/OpenResourcesManager';\n\nconst OpenResourcesContext = createContext<OpenResourcesManager | undefined>(undefined);\n\n/**\n * Provider Pattern: Accepts OpenResourcesManager implementation as prop\n * and makes it available to child components via Context.\n *\n * Apps provide their own implementation (localStorage, sessionStorage, database, etc.)\n * and pass it to this provider at the root level.\n *\n * @example\n * ```tsx\n * // In app root\n * const openResourcesManager = useOpenResourcesManager(); // App's implementation\n *\n * <OpenResourcesProvider openResourcesManager={openResourcesManager}>\n *   <App />\n * </OpenResourcesProvider>\n * ```\n */\nexport function OpenResourcesProvider({\n  openResourcesManager,\n  children\n}: {\n  openResourcesManager: OpenResourcesManager;\n  children: React.ReactNode;\n}) {\n  return (\n    <OpenResourcesContext.Provider value={openResourcesManager}>\n      {children}\n    </OpenResourcesContext.Provider>\n  );\n}\n\n/**\n * Hook to access OpenResourcesManager from Context\n * Components use this hook to access open resources functionality\n */\nexport function useOpenResources(): OpenResourcesManager {\n  const context = useContext(OpenResourcesContext);\n  if (context === undefined) {\n    throw new Error('useOpenResources must be used within an OpenResourcesProvider');\n  }\n  return context;\n}","'use client';\n\nimport { createContext, useContext, ReactNode, useState, useEffect, useMemo } from 'react';\nimport type { TranslationManager } from '../types/TranslationManager';\n\n// Static import for default English only - always needed as fallback\nimport enTranslations from '../../translations/en.json';\n\nconst TranslationContext = createContext<TranslationManager | null>(null);\n\n// Cache for dynamically loaded translations\nconst translationCache = new Map<string, any>();\n\n/**\n * Process ICU MessageFormat plural syntax\n * Supports: {count, plural, =0 {text} =1 {text} other {text}}\n */\nfunction processPluralFormat(text: string, params: Record<string, any>): string {\n  // Match {paramName, plural, ...} with proper brace counting\n  const pluralMatch = text.match(/\\{(\\w+),\\s*plural,\\s*/);\n  if (!pluralMatch) {\n    return text;\n  }\n\n  const paramName = pluralMatch[1];\n  const count = params[paramName];\n  if (count === undefined) {\n    return text;\n  }\n\n  // Find the matching closing brace by counting\n  let startPos = pluralMatch[0].length;\n  let braceCount = 1; // We're inside the first {\n  let endPos = startPos;\n\n  for (let i = startPos; i < text.length; i++) {\n    if (text[i] === '{') braceCount++;\n    else if (text[i] === '}') {\n      braceCount--;\n      if (braceCount === 0) {\n        endPos = i;\n        break;\n      }\n    }\n  }\n\n  const pluralCases = text.substring(startPos, endPos);\n\n  // Parse plural cases: =0 {text} =1 {text} other {text}\n  const cases: Record<string, string> = {};\n  const caseRegex = /(?:=(\\d+)|(\\w+))\\s*\\{([^}]+)\\}/g;\n  let caseMatch;\n\n  while ((caseMatch = caseRegex.exec(pluralCases)) !== null) {\n    const [, exactNumber, keyword, textContent] = caseMatch;\n    const key = exactNumber !== undefined ? `=${exactNumber}` : keyword;\n    cases[key] = textContent;\n  }\n\n  // Select appropriate case\n  const exactMatch = cases[`=${count}`];\n  if (exactMatch !== undefined) {\n    const result = exactMatch.replace(/#/g, String(count));\n    return text.substring(0, pluralMatch.index!) + result + text.substring(endPos + 1);\n  }\n\n  const otherCase = cases['other'];\n  if (otherCase !== undefined) {\n    const result = otherCase.replace(/#/g, String(count));\n    return text.substring(0, pluralMatch.index!) + result + text.substring(endPos + 1);\n  }\n\n  return text;\n}\n\n// List of available locales (can be extended without importing all files)\nexport const AVAILABLE_LOCALES = [\n  'ar', // Arabic\n  'bn', // Bengali\n  'cs', // Czech\n  'da', // Danish\n  'de', // German\n  'el', // Greek\n  'en', // English\n  'es', // Spanish\n  'fa', // Persian/Farsi\n  'fi', // Finnish\n  'fr', // French\n  'he', // Hebrew\n  'hi', // Hindi\n  'id', // Indonesian\n  'it', // Italian\n  'ja', // Japanese\n  'ko', // Korean\n  'ms', // Malay\n  'nl', // Dutch\n  'no', // Norwegian\n  'pl', // Polish\n  'pt', // Portuguese\n  'ro', // Romanian\n  'sv', // Swedish\n  'th', // Thai\n  'tr', // Turkish\n  'uk', // Ukrainian\n  'vi', // Vietnamese\n  'zh', // Chinese\n] as const;\nexport type AvailableLocale = typeof AVAILABLE_LOCALES[number];\n\n// Lazy load translations for a specific locale\nasync function loadTranslations(locale: string): Promise<any> {\n  // Check cache first\n  if (translationCache.has(locale)) {\n    return translationCache.get(locale);\n  }\n\n  // English is already loaded statically\n  if (locale === 'en') {\n    translationCache.set('en', enTranslations);\n    return enTranslations;\n  }\n\n  try {\n    // Dynamic import for all other locales\n    const translations = await import(`../../translations/${locale}.json`);\n    const translationData = translations.default || translations;\n    translationCache.set(locale, translationData);\n    return translationData;\n  } catch (error) {\n    console.error(`Failed to load translations for locale: ${locale}`, error);\n    // Fall back to English\n    return enTranslations;\n  }\n}\n\n// Default English translation manager (using static import)\nconst defaultTranslationManager: TranslationManager = {\n  t: (namespace: string, key: string, params?: Record<string, any>) => {\n    const translations = enTranslations as Record<string, Record<string, string>>;\n    const translation = translations[namespace]?.[key];\n\n    if (!translation) {\n      console.warn(`Translation not found for ${namespace}.${key}`);\n      return `${namespace}.${key}`;\n    }\n\n    // Handle parameter interpolation and plural format\n    if (params && typeof translation === 'string') {\n      let result = translation;\n      // First process plural format\n      result = processPluralFormat(result, params);\n      // Then handle simple parameter interpolation\n      Object.entries(params).forEach(([paramKey, paramValue]) => {\n        result = result.replace(new RegExp(`\\\\{${paramKey}\\\\}`, 'g'), String(paramValue));\n      });\n      return result;\n    }\n\n    return translation;\n  },\n};\n\nexport interface TranslationProviderProps {\n  /**\n   * Option 1: Provide a complete TranslationManager implementation\n   */\n  translationManager?: TranslationManager;\n\n  /**\n   * Option 2: Use built-in translations by specifying a locale\n   * When adding new locales, just add the JSON file and update AVAILABLE_LOCALES\n   */\n  locale?: string;\n\n  /**\n   * Loading component to show while translations are being loaded\n   * Only relevant when using dynamic locale loading\n   */\n  loadingComponent?: ReactNode;\n\n  children: ReactNode;\n}\n\n/**\n * Provider for translation management with dynamic loading\n *\n * Three modes of operation:\n * 1. No provider: Components use default English strings\n * 2. With locale prop: Dynamically loads translations for that locale\n * 3. With translationManager: Use custom translation implementation\n */\nexport function TranslationProvider({\n  translationManager,\n  locale,\n  loadingComponent = null,\n  children,\n}: TranslationProviderProps) {\n  const [loadedTranslations, setLoadedTranslations] = useState<any>(null);\n  const [isLoading, setIsLoading] = useState(false);\n\n  // Load translations when locale changes\n  useEffect(() => {\n    if (locale && !translationManager) {\n      setIsLoading(true);\n      loadTranslations(locale)\n        .then(translations => {\n          setLoadedTranslations(translations);\n          setIsLoading(false);\n        })\n        .catch(error => {\n          console.error('Failed to load translations:', error);\n          setLoadedTranslations(enTranslations); // Fall back to English\n          setIsLoading(false);\n        });\n    }\n  }, [locale, translationManager]);\n\n  // Create translation manager from loaded translations\n  const localeManager = useMemo<TranslationManager | null>(() => {\n    if (!loadedTranslations) return null;\n\n    return {\n      t: (namespace: string, key: string, params?: Record<string, any>) => {\n        const translation = loadedTranslations[namespace]?.[key];\n\n        if (!translation) {\n          console.warn(`Translation not found for ${namespace}.${key} in locale ${locale}`);\n          return `${namespace}.${key}`;\n        }\n\n        // Handle parameter interpolation and plural format\n        if (params && typeof translation === 'string') {\n          let result = translation;\n          // First process plural format\n          result = processPluralFormat(result, params);\n          // Then handle simple parameter interpolation\n          Object.entries(params).forEach(([paramKey, paramValue]) => {\n            result = result.replace(new RegExp(`\\\\{${paramKey}\\\\}`, 'g'), String(paramValue));\n          });\n          return result;\n        }\n\n        return translation;\n      },\n    };\n  }, [loadedTranslations, locale]);\n\n  // If custom translation manager provided, use it\n  if (translationManager) {\n    return (\n      <TranslationContext.Provider value={translationManager}>\n        {children}\n      </TranslationContext.Provider>\n    );\n  }\n\n  // If locale provided and still loading, show loading component\n  if (locale && isLoading) {\n    return <>{loadingComponent}</>;\n  }\n\n  // If locale provided and translations loaded, use them\n  if (locale && localeManager) {\n    return (\n      <TranslationContext.Provider value={localeManager}>\n        {children}\n      </TranslationContext.Provider>\n    );\n  }\n\n  // Default: use English translations\n  return (\n    <TranslationContext.Provider value={defaultTranslationManager}>\n      {children}\n    </TranslationContext.Provider>\n  );\n}\n\n/**\n * Hook to access translations within a namespace\n *\n * Works in three modes:\n * 1. Without provider: Returns default English translations\n * 2. With provider using locale: Returns dynamically loaded translations for that locale\n * 3. With custom provider: Uses the custom translation manager\n *\n * @param namespace - Translation namespace (e.g., 'Toolbar', 'ResourceViewer')\n * @returns Function to translate keys within the namespace\n */\nexport function useTranslations(namespace: string) {\n  const context = useContext(TranslationContext);\n\n  // If no context (no provider), use default English translations\n  if (!context) {\n    return (key: string, params?: Record<string, any>) => {\n      const translations = enTranslations as Record<string, Record<string, string>>;\n      const translation = translations[namespace]?.[key];\n\n      if (!translation) {\n        console.warn(`Translation not found for ${namespace}.${key}`);\n        return `${namespace}.${key}`;\n      }\n\n      // Handle parameter interpolation and plural format\n      if (params && typeof translation === 'string') {\n        let result = translation;\n        // First process plural format\n        result = processPluralFormat(result, params);\n        // Then handle simple parameter interpolation\n        Object.entries(params).forEach(([paramKey, paramValue]) => {\n          result = result.replace(new RegExp(`\\\\{${paramKey}\\\\}`, 'g'), String(paramValue));\n        });\n        return result;\n      }\n\n      return translation;\n    };\n  }\n\n  // Return a function that translates keys within this namespace\n  return (key: string, params?: Record<string, any>) => context.t(namespace, key, params);\n}\n\n/**\n * Hook to preload translations for a locale\n * Useful for preloading translations before navigation\n */\nexport function usePreloadTranslations() {\n  return {\n    preload: async (locale: string) => {\n      try {\n        await loadTranslations(locale);\n        return true;\n      } catch (error) {\n        console.error(`Failed to preload translations for ${locale}:`, error);\n        return false;\n      }\n    },\n    isLoaded: (locale: string) => translationCache.has(locale),\n  };\n}"],"mappings":"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","names":["jsx","createContext","useContext","jsx","createContext","useContext","useState","useEffect","jsx","createContext","useState","useEffect","jsx","useContext"]}

package/dist/{chunk-ZPV43WN2.mjs → chunk-XMCUHQ2Y.mjs}

@@ -1,7 +1,26 @@
 'use client';
 import {
+  useApiClient,
   useEventBus
-} from "./chunk-2HGWOLVN.mjs";
+} from "./chunk-5JZFKRLW.mjs";
+
+// src/contexts/AuthTokenContext.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var AuthTokenContext = createContext(void 0);
+function AuthTokenProvider({
+  token,
+  children
+}) {
+  return /* @__PURE__ */ jsx(AuthTokenContext.Provider, { value: token, children });
+}
+function useAuthToken() {
+  const context = useContext(AuthTokenContext);
+  if (context === void 0) {
+    throw new Error("useAuthToken must be used within an AuthTokenProvider");
+  }
+  return context;
+}
 
 // src/contexts/useEventSubscription.ts
 import { useEffect, useRef, useMemo } from "react";
@@ -56,6 +75,7 @@ function useEventSubscriptions(subscriptions) {
 
 // src/hooks/useBeckonFlow.ts
 import { useState, useRef as useRef2, useCallback, useEffect as useEffect2 } from "react";
+import { accessToken } from "@semiont/core";
 function useBeckonFlow() {
   const eventBus = useEventBus();
   const [hoveredAnnotationId, setHoveredAnnotationId] = useState(null);
@@ -137,13 +157,62 @@ function useHoverEmitter(annotationId, hoverDelayMs = HOVER_DELAY_MS) {
   }, []);
   return { onMouseEnter, onMouseLeave };
 }
+function useAttentionStream() {
+  const client = useApiClient();
+  const token = useAuthToken();
+  const eventBus = useEventBus();
+  const [status, setStatus] = useState("disconnected");
+  const streamRef = useRef2(null);
+  const connectingRef = useRef2(false);
+  const connect = useCallback(async () => {
+    if (connectingRef.current || streamRef.current) return;
+    connectingRef.current = true;
+    if (!client) {
+      setStatus("error");
+      connectingRef.current = false;
+      return;
+    }
+    setStatus("connecting");
+    try {
+      const stream = client.sse.attentionStream({
+        ...token ? { auth: accessToken(token) } : {},
+        eventBus
+      });
+      streamRef.current = stream;
+      setStatus("connected");
+      connectingRef.current = false;
+    } catch (error) {
+      console.error("[AttentionStream] Failed to connect:", error);
+      setStatus("error");
+      connectingRef.current = false;
+    }
+  }, [client, token, eventBus]);
+  const disconnect = useCallback(() => {
+    if (streamRef.current) {
+      streamRef.current.close();
+      streamRef.current = null;
+    }
+    setStatus("disconnected");
+    connectingRef.current = false;
+  }, []);
+  useEffect2(() => {
+    if (client) {
+      connect();
+    }
+    return () => disconnect();
+  }, [client]);
+  return { status };
+}
 
 export {
+  AuthTokenProvider,
+  useAuthToken,
   useEventSubscription,
   useEventSubscriptions,
   useBeckonFlow,
   HOVER_DELAY_MS,
   createHoverHandlers,
-  useHoverEmitter
+  useHoverEmitter,
+  useAttentionStream
 };
-//# sourceMappingURL=chunk-ZPV43WN2.mjs.map
+//# sourceMappingURL=chunk-XMCUHQ2Y.mjs.map

package/dist/chunk-XMCUHQ2Y.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/AuthTokenContext.tsx","../src/contexts/useEventSubscription.ts","../src/hooks/useBeckonFlow.ts"],"sourcesContent":["'use client';\n\n/**\n * Auth Token Context - Manages authentication token lifecycle\n *\n * Simple approach: Just pass the token value through context.\n * When the token changes, context updates, components re-render.\n * No complex machinery needed.\n */\n\nimport { createContext, useContext, ReactNode } from 'react';\n\nconst AuthTokenContext = createContext<string | null | undefined>(undefined);\n\nexport interface AuthTokenProviderProps {\n  token: string | null;\n  children: ReactNode;\n}\n\n/**\n * Provider for auth token\n * Pass the current token value - React handles the rest\n */\nexport function AuthTokenProvider({\n  token,\n  children,\n}: AuthTokenProviderProps) {\n  return (\n    <AuthTokenContext.Provider value={token}>\n      {children}\n    </AuthTokenContext.Provider>\n  );\n}\n\n/**\n * Hook to get current auth token\n *\n * Returns the current token value from context.\n * Re-renders automatically when token changes (normal React behavior).\n *\n * @returns Current access token (null if not authenticated)\n * @throws Error if used outside AuthTokenProvider\n */\nexport function useAuthToken(): string | null {\n  const context = useContext(AuthTokenContext);\n\n  if (context === undefined) {\n    throw new Error('useAuthToken must be used within an AuthTokenProvider');\n  }\n\n  return context;\n}\n","import { useEffect, useRef, useMemo } from 'react';\nimport type { EventMap } from '@semiont/core';\nimport { useEventBus } from './EventBusContext';\n\n/**\n * Subscribe to an event bus event with automatic cleanup.\n *\n * This hook solves the \"stale closure\" problem by always using the latest\n * version of the handler without re-subscribing.\n *\n * @example\n * ```tsx\n * useEventSubscription('mark:created', ({ annotation }) => {\n *   // This always uses the latest props/state\n *   triggerSparkleAnimation(annotation.id);\n * });\n * ```\n */\nexport function useEventSubscription<K extends keyof EventMap>(\n  eventName: K,\n  handler: (payload: EventMap[K]) => void\n): void {\n  const eventBus = useEventBus();\n\n  // Store the latest handler in a ref to avoid stale closures\n  const handlerRef = useRef(handler);\n\n  // Update ref on every render (no re-subscription needed)\n  useEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  // Subscribe once, using a stable wrapper that calls the current handler\n  useEffect(() => {\n    const stableHandler = (payload: EventMap[K]) => {\n      handlerRef.current(payload);\n    };\n\n    // RxJS EventBus.get() returns Subject, subscribe returns Subscription\n    const subscription = eventBus.get(eventName).subscribe(stableHandler);\n\n    return () => {\n      subscription.unsubscribe();\n    };\n  }, [eventName, eventBus]); // eventBus is stable, only re-subscribe if event name changes\n}\n\n/**\n * Subscribe to multiple events at once.\n *\n * @example\n * ```tsx\n * useEventSubscriptions({\n *   'mark:created': ({ annotation }) => setNewAnnotation(annotation),\n *   'mark:deleted': ({ annotationId }) => removeAnnotation(annotationId),\n * });\n * ```\n */\nexport function useEventSubscriptions(\n  subscriptions: {\n    [K in keyof EventMap]?: (payload: EventMap[K]) => void;\n  }\n): void {\n  const eventBus = useEventBus();\n\n  // Store the latest handlers in refs\n  const handlersRef = useRef(subscriptions);\n\n  // Update refs on every render\n  useEffect(() => {\n    handlersRef.current = subscriptions;\n  });\n\n  // Get stable list of event names to subscribe to\n  const eventNames = useMemo(\n    () => Object.keys(subscriptions).sort(),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [Object.keys(subscriptions).sort().join(',')]\n  );\n\n  // Subscribe once per event - only re-subscribe if event names actually change\n  useEffect(() => {\n    const subscriptions: Array<{ unsubscribe: () => void }> = [];\n\n    // Create stable wrappers for each subscription\n    for (const eventName of eventNames) {\n      const stableHandler = (payload: any) => {\n        const currentHandler = handlersRef.current[eventName as keyof EventMap];\n        if (currentHandler) {\n          currentHandler(payload);\n        } else {\n          console.warn('[useEventSubscriptions] No current handler found for:', eventName);\n        }\n      };\n\n      // RxJS EventBus.get() returns Subject, subscribe returns Subscription\n      const subscription = eventBus.get(eventName as keyof EventMap).subscribe(stableHandler);\n      subscriptions.push(subscription);\n    }\n\n    // Cleanup: unsubscribe from all subscriptions\n    return () => {\n      for (const subscription of subscriptions) {\n        subscription.unsubscribe();\n      }\n    };\n  }, [eventNames, eventBus]); // eventBus is stable singleton - never in deps; only re-subscribe if event names change\n}\n","/**\n * useBeckonFlow — Annotation attention / pointer coordination hook\n *\n * Manages which annotation currently has the user's attention:\n * - Hover state (hoveredAnnotationId)\n * - Hover → sparkle relay\n * - Click → focus relay\n *\n * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that\n * subscribes to events and pushes values into React state.\n *\n * Note: beckon:sparkle visual effect (triggerSparkleAnimation) is owned by\n * ResourceViewerPage, which subscribes to beckon:sparkle and delegates to\n * ResourceAnnotationsContext. This hook emits the signal; it does not render the effect.\n *\n * @subscribes beckon:hover - Sets hoveredAnnotationId; emits beckon:sparkle\n * @subscribes browse:click - Emits beckon:focus (attention relay only)\n * @emits      beckon:sparkle\n * @emits      beckon:focus\n */\n\n/**\n * useHoverEmitter / createHoverHandlers — annotation hover emission utilities\n *\n * Centralises two hover quality-of-life behaviours:\n *\n * 1. currentHover guard — suppresses redundant emissions when the mouse\n *    moves within the same annotation element (prevents event bus noise).\n *\n * 2. Debounce delay (HOVER_DELAY_MS) — a short timer before emitting\n *    beckon:hover, so that transient pass-through movements (user dragging\n *    the mouse across the panel to reach a button elsewhere) do not trigger\n *    sparkle animations or cross-highlight effects.\n *    The delay is cancelled immediately on mouseLeave, so leaving is always instant.\n *\n * Two forms are provided:\n *\n * useHoverEmitter(annotationId)\n *   React hook. Returns { onMouseEnter, onMouseLeave } props for JSX elements.\n *   Use in panel entries (HighlightEntry, CommentEntry, …).\n *\n * createHoverHandlers(emit)\n *   Plain factory. Returns { handleMouseEnter(id), handleMouseLeave(), cleanup }.\n *   Use inside useEffect / imperative setup code where hooks cannot be called\n *   (BrowseView, CodeMirrorRenderer, AnnotationOverlay, PdfAnnotationCanvas).\n */\n\nimport { useState, useRef, useCallback, useEffect } from 'react';\nimport type { SSEStream } from '@semiont/api-client';\nimport { accessToken } from '@semiont/core';\nimport { useEventBus } from '../contexts/EventBusContext';\nimport { useEventSubscriptions } from '../contexts/useEventSubscription';\nimport { useApiClient } from '../contexts/ApiClientContext';\nimport { useAuthToken } from '../contexts/AuthTokenContext';\nimport type { StreamStatus } from './useResourceEvents';\n\n// ─── useBeckonFlow ─────────────────────────────────────────────────────────\n\nexport interface BeckonFlowState {\n  hoveredAnnotationId: string | null;\n}\n\nexport function useBeckonFlow(): BeckonFlowState {\n  const eventBus = useEventBus();\n  const [hoveredAnnotationId, setHoveredAnnotationId] = useState<string | null>(null);\n\n  const handleAnnotationHover = useCallback(({ annotationId }: { annotationId: string | null }) => {\n    setHoveredAnnotationId(annotationId);\n    if (annotationId) {\n      eventBus.get('beckon:sparkle').next({ annotationId });\n    }\n  }, []); // eventBus is stable singleton - never in deps\n\n  const handleAnnotationClick = useCallback(({ annotationId }: { annotationId: string }) => {\n    eventBus.get('beckon:focus').next({ annotationId });\n    // Scroll to annotation handled by BrowseView via beckon:focus subscription\n  }, []); // eventBus is stable singleton - never in deps\n\n  useEventSubscriptions({\n    'beckon:hover': handleAnnotationHover,\n    'browse:click': handleAnnotationClick,\n  });\n\n  return { hoveredAnnotationId };\n}\n\n// ─── createHoverHandlers (use inside useEffect / imperative setup) ────────────\n\n/** Default milliseconds the mouse must dwell before beckon:hover is emitted. */\nexport const HOVER_DELAY_MS = 150;\n\ntype EmitHover = (annotationId: string | null) => void;\n\nexport interface HoverHandlers {\n  /** Call with the annotation ID when the mouse enters an annotation element. */\n  handleMouseEnter: (annotationId: string) => void;\n  /** Call when the mouse leaves the annotation element. */\n  handleMouseLeave: () => void;\n  /** Cancel any pending timer — call in the useEffect cleanup. */\n  cleanup: () => void;\n}\n\n/**\n * Creates hover handlers for imperative code (non-hook contexts).\n * @param emit - Callback to emit hover events\n * @param delayMs - Hover delay in milliseconds\n */\nexport function createHoverHandlers(emit: EmitHover, delayMs: number): HoverHandlers {\n  let currentHover: string | null = null;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n\n  const cancelTimer = () => {\n    if (timer !== null) {\n      clearTimeout(timer);\n      timer = null;\n    }\n  };\n\n  const handleMouseEnter = (annotationId: string) => {\n    if (currentHover === annotationId) return; // already hovering this one\n    cancelTimer();\n    timer = setTimeout(() => {\n      timer = null;\n      currentHover = annotationId;\n      emit(annotationId);\n    }, delayMs);\n  };\n\n  const handleMouseLeave = () => {\n    cancelTimer();\n    if (currentHover !== null) {\n      currentHover = null;\n      emit(null);\n    }\n  };\n\n  return { handleMouseEnter, handleMouseLeave, cleanup: cancelTimer };\n}\n\n// ─── useHoverEmitter (use in JSX onMouseEnter / onMouseLeave props) ───────────\n\nexport interface HoverEmitterProps {\n  onMouseEnter: () => void;\n  onMouseLeave: () => void;\n}\n\n/**\n * React hook that returns onMouseEnter / onMouseLeave props for a single\n * annotation entry element.\n *\n * @param annotationId - The ID of the annotation this element represents.\n * @param hoverDelayMs - Hover delay in milliseconds (defaults to HOVER_DELAY_MS for panel entries)\n */\nexport function useHoverEmitter(annotationId: string, hoverDelayMs: number = HOVER_DELAY_MS): HoverEmitterProps {\n  const eventBus = useEventBus();\n  const currentHoverRef = useRef<string | null>(null);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const onMouseEnter = useCallback(() => {\n    if (currentHoverRef.current === annotationId) return;\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n    }\n    timerRef.current = setTimeout(() => {\n      timerRef.current = null;\n      currentHoverRef.current = annotationId;\n      eventBus.get('beckon:hover').next({ annotationId });\n    }, hoverDelayMs);\n  }, [annotationId, hoverDelayMs]); // eventBus is stable singleton - never in deps\n\n  const onMouseLeave = useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n    if (currentHoverRef.current !== null) {\n      currentHoverRef.current = null;\n      eventBus.get('beckon:hover').next({ annotationId: null });\n    }\n  }, []); // eventBus is stable singleton - never in deps\n\n  // Cleanup timer on unmount\n  useEffect(() => {\n    return () => {\n      if (timerRef.current !== null) {\n        clearTimeout(timerRef.current);\n        timerRef.current = null;\n      }\n    };\n  }, []);\n\n  return { onMouseEnter, onMouseLeave };\n}\n\n// ─── useAttentionStream ───────────────────────────────────────────────────────\n\n/**\n * Opens a participant-scoped SSE connection to receive cross-participant\n * beckon signals. Each incoming signal is emitted as beckon:focus on the\n * EventBus — the existing scroll/highlight machinery handles it automatically.\n *\n * Signals are ephemeral: delivered if connected, silently dropped if not.\n *\n * @example\n * ```tsx\n * // In your layout (render-nothing connector):\n * useAttentionStream();\n * ```\n */\nexport function useAttentionStream(): { status: StreamStatus } {\n  const client = useApiClient();\n  const token = useAuthToken();\n  const eventBus = useEventBus();\n  const [status, setStatus] = useState<StreamStatus>('disconnected');\n  const streamRef = useRef<SSEStream | null>(null);\n  const connectingRef = useRef(false);\n\n  const connect = useCallback(async () => {\n    if (connectingRef.current || streamRef.current) return;\n    connectingRef.current = true;\n\n    if (!client) {\n      setStatus('error');\n      connectingRef.current = false;\n      return;\n    }\n\n    setStatus('connecting');\n\n    try {\n      const stream = client.sse.attentionStream({\n        ...(token ? { auth: accessToken(token) } : {}),\n        eventBus,\n      });\n      streamRef.current = stream;\n      setStatus('connected');\n      connectingRef.current = false;\n    } catch (error) {\n      console.error('[AttentionStream] Failed to connect:', error);\n      setStatus('error');\n      connectingRef.current = false;\n    }\n  }, [client, token, eventBus]);\n\n  const disconnect = useCallback(() => {\n    if (streamRef.current) {\n      streamRef.current.close();\n      streamRef.current = null;\n    }\n    setStatus('disconnected');\n    connectingRef.current = false;\n  }, []);\n\n  useEffect(() => {\n    if (client) {\n      connect();\n    }\n    return () => disconnect();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [client]);\n\n  return { status };\n}\n"],"mappings":"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","names":["subscriptions","useRef","useEffect","useRef","useEffect"]}