@semiont/react-ui 0.2.33 → 0.2.34-build.89

package/dist/EventBusContext-BmzEcGHZ.d.mts

@@ -0,0 +1,177 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { EventBus } from '@semiont/core';
+
+/**
+ * Open Resources Manager Interface
+ *
+ * Manages a list of open resources (documents/files) with persistence.
+ * This interface allows apps to provide their own implementation of resource management
+ * (localStorage, sessionStorage, database, etc.) while components remain framework-agnostic.
+ *
+ * Components accept this manager as a prop instead of consuming from Context.
+ *
+ * @example
+ * ```tsx
+ * // In app (e.g., frontend/src/hooks/useOpenResourcesManager.ts)
+ * export function useOpenResourcesManager(): OpenResourcesManager {
+ *   const [openResources, setOpenResources] = useState<OpenResource[]>([]);
+ *
+ *   // Implementation details...
+ *
+ *   return {
+ *     openResources,
+ *     addResource,
+ *     removeResource,
+ *     updateResourceName,
+ *     reorderResources
+ *   };
+ * }
+ *
+ * // Pass to components as props
+ * <KnowledgeNavigation openResourcesManager={openResourcesManager} />
+ * ```
+ */
+interface OpenResource {
+    /** Unique identifier for the resource */
+    id: string;
+    /** Display name of the resource */
+    name: string;
+    /** Timestamp when the resource was opened */
+    openedAt: number;
+    /** Order/position for manual sorting (optional for backward compatibility) */
+    order?: number;
+    /** Media type for icon display (e.g., 'application/pdf', 'text/plain') */
+    mediaType?: string;
+}
+interface OpenResourcesManager {
+    /** List of currently open resources */
+    openResources: OpenResource[];
+    /**
+     * Add a new resource to the open list or update if already exists
+     * @param id - Unique resource identifier
+     * @param name - Display name of the resource
+     * @param mediaType - Optional media type for icon display
+     */
+    addResource: (id: string, name: string, mediaType?: string) => void;
+    /**
+     * Remove a resource from the open list
+     * @param id - Resource identifier to remove
+     */
+    removeResource: (id: string) => void;
+    /**
+     * Update the display name of an open resource
+     * @param id - Resource identifier
+     * @param name - New display name
+     */
+    updateResourceName: (id: string, name: string) => void;
+    /**
+     * Reorder resources by moving from one index to another
+     * @param oldIndex - Current position index
+     * @param newIndex - Desired position index
+     */
+    reorderResources: (oldIndex: number, newIndex: number) => void;
+}
+
+/**
+ * Session management interface for handling authentication state and session expiry
+ * Apps implement this interface and pass it to SessionProvider
+ */
+interface SessionState {
+    /** Whether the user is currently authenticated */
+    isAuthenticated: boolean;
+    /** When the session expires (null if not authenticated) */
+    expiresAt: Date | null;
+    /** Time in milliseconds until session expires (null if not authenticated) */
+    timeUntilExpiry: number | null;
+    /** Whether the session is expiring soon (< 5 minutes) */
+    isExpiringSoon: boolean;
+}
+interface SessionManager extends SessionState {
+}
+
+/**
+ * Translation management interface
+ * Apps implement this to provide translations using their preferred i18n library
+ */
+interface TranslationManager {
+    /**
+     * Translate a key within a namespace
+     * @param namespace - Translation namespace (e.g., 'Toolbar', 'ResourceViewer')
+     * @param key - Translation key within the namespace
+     * @param params - Optional parameters for interpolation
+     * @returns Translated string
+     */
+    t: (namespace: string, key: string, params?: Record<string, any>) => string;
+}
+
+/**
+ * Reset the global event bus - FOR TESTING ONLY.
+ *
+ * Call this in test setup (beforeEach) to ensure test isolation.
+ * Each test gets a fresh event bus with no lingering subscriptions.
+ *
+ * @returns The new EventBus instance
+ *
+ * @example
+ * ```typescript
+ * beforeEach(() => {
+ *   const eventBus = resetEventBusForTesting();
+ * });
+ * ```
+ */
+declare function resetEventBusForTesting(): EventBus;
+interface EventBusProviderProps {
+    children: ReactNode;
+}
+/**
+ * Unified event bus provider for all application events
+ *
+ * Consolidates three previous event buses:
+ * - MakeMeaningEventBus (document/annotation operations)
+ * - NavigationEventBus (navigation and sidebar UI)
+ * - GlobalSettingsEventBus (app-wide settings)
+ *
+ * Benefits:
+ * - Single import: useEventBus()
+ * - No decision fatigue about which bus to use
+ * - Easier cross-domain coordination
+ * - Simpler provider hierarchy
+ *
+ * NOTE: This provider uses a global singleton event bus to ensure all components
+ * share the same instance. Multiple providers in the tree will all reference the
+ * same global bus.
+ *
+ * Operation handlers (API calls triggered by events) are set up separately via
+ * the useResolutionFlow hook, which should be called at the resource page level.
+ */
+declare function EventBusProvider({ children }: EventBusProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the unified event bus
+ *
+ * Use this everywhere instead of:
+ * - useMakeMeaningEvents()
+ * - useNavigationEvents()
+ * - useGlobalSettingsEvents()
+ *
+ * @example
+ * ```typescript
+ * const eventBus = useEventBus();
+ *
+ * // Emit any event
+ * eventBus.get('annotation:hover').next({ annotationId: '123' });
+ * eventBus.get('navigation:sidebar-toggle').next(undefined);
+ * eventBus.get('settings:theme-changed').next({ theme: 'dark' });
+ *
+ * // Subscribe to any event
+ * useEffect(() => {
+ *   const unsubscribe = eventBus.on('annotation:hover', ({ annotationId }) => {
+ *     console.log(annotationId);
+ *   });
+ *   return () => unsubscribe();
+ * }, []);
+ * ```
+ */
+declare function useEventBus(): EventBus;
+
+export { type EventBusProviderProps as E, type OpenResourcesManager as O, type SessionManager as S, type TranslationManager as T, type OpenResource as a, type SessionState as b, EventBusProvider as c, resetEventBusForTesting as r, useEventBus as u };

package/dist/{PdfAnnotationCanvas.client-FGV33CWN.mjs → PdfAnnotationCanvas.client-VLNA5O5M.mjs}

@@ -2,8 +2,8 @@
 "use client";
 import {
   createHoverHandlers
-} from "./chunk-FC6SGLLT.mjs";
-import "./chunk-XS27QKGP.mjs";
+} from "./chunk-M7SZRRIE.mjs";
+import "./chunk-ULIET3MW.mjs";
 import "./chunk-3JTO27MH.mjs";
 
 // src/components/pdf-annotation/PdfAnnotationCanvas.tsx
@@ -304,7 +304,7 @@ function PdfAnnotationCanvas({
           return selection.endX >= displayX && selection.endX <= displayX + displayWidth && selection.endY >= displayY && selection.endY <= displayY + displayHeight;
         });
         if (clickedAnnotation) {
-          eventBus?.emit("annotation:click", { annotationId: clickedAnnotation.id, motivation: clickedAnnotation.motivation });
+          eventBus?.get("annotation:click").next({ annotationId: clickedAnnotation.id, motivation: clickedAnnotation.motivation });
           setIsDrawing(false);
           setSelection(null);
           return;
@@ -332,7 +332,7 @@ function PdfAnnotationCanvas({
     );
     const fragmentSelector = createFragmentSelector(pdfCoord);
     if (selectedMotivation) {
-      eventBus.emit("annotation:requested", {
+      eventBus.get("annotation:requested").next({
         selector: {
           type: "FragmentSelector",
           conformsTo: "http://tools.ietf.org/rfc/rfc3778",
@@ -358,7 +358,7 @@ function PdfAnnotationCanvas({
     return page === pageNumber;
   });
   const { handleMouseEnter, handleMouseLeave } = useMemo(
-    () => createHoverHandlers((annotationId) => eventBus?.emit("annotation:hover", { annotationId })),
+    () => createHoverHandlers((annotationId) => eventBus?.get("annotation:hover").next({ annotationId })),
     [eventBus]
   );
   const { stroke, fill } = getMotivationColor(selectedMotivation ?? null);
@@ -441,7 +441,7 @@ function PdfAnnotationCanvas({
                         cursor: "pointer",
                         opacity: isSelected ? 1 : isHovered ? 0.9 : 0.7
                       },
-                      onClick: () => eventBus?.emit("annotation:click", { annotationId: ann.id, motivation: ann.motivation }),
+                      onClick: () => eventBus?.get("annotation:click").next({ annotationId: ann.id, motivation: ann.motivation }),
                       onMouseEnter: () => handleMouseEnter(ann.id),
                       onMouseLeave: handleMouseLeave
                     },
@@ -505,4 +505,4 @@ function PdfAnnotationCanvas({
 export {
   PdfAnnotationCanvas
 };
-//# sourceMappingURL=PdfAnnotationCanvas.client-FGV33CWN.mjs.map
+//# sourceMappingURL=PdfAnnotationCanvas.client-VLNA5O5M.mjs.map

package/dist/PdfAnnotationCanvas.client-VLNA5O5M.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/pdf-annotation/PdfAnnotationCanvas.tsx","../src/lib/pdf-coordinates.ts","../src/lib/browser-pdfjs.ts"],"sourcesContent":["'use client';\n\nimport React, { useRef, useState, useCallback, useEffect, useMemo } from 'react';\nimport { createHoverHandlers } from '../../hooks/useAttentionFlow';\nimport type { components, ResourceUri } from '@semiont/core';\nimport { getTargetSelector } from '@semiont/api-client';\nimport type { SelectionMotivation } from '../annotation/AnnotateToolbar';\nimport type { EventBus } from \"@semiont/core\"\nimport {\n  canvasToPdfCoordinates,\n  pdfToCanvasCoordinates,\n  createFragmentSelector,\n  parseFragmentSelector,\n  getPageFromFragment,\n  type CanvasRectangle\n} from '../../lib/pdf-coordinates';\nimport {\n  loadPdfDocument,\n  renderPdfPageToDataUrl,\n  type PDFDocumentProxy\n} from '../../lib/browser-pdfjs';\nimport './PdfAnnotationCanvas.css';\n\ntype Annotation = components['schemas']['Annotation'];\n\nexport type DrawingMode = 'rectangle' | 'circle' | 'polygon' | null;\n\n/**\n * Get color for annotation based on motivation\n */\nfunction getMotivationColor(motivation: SelectionMotivation | null): { stroke: string; fill: string } {\n  if (!motivation) {\n    return { stroke: 'rgb(156, 163, 175)', fill: 'rgba(156, 163, 175, 0.2)' };\n  }\n\n  switch (motivation) {\n    case 'highlighting':\n      return { stroke: 'rgb(250, 204, 21)', fill: 'rgba(250, 204, 21, 0.3)' };\n    case 'linking':\n      return { stroke: 'rgb(59, 130, 246)', fill: 'rgba(59, 130, 246, 0.2)' };\n    case 'assessing':\n      return { stroke: 'rgb(239, 68, 68)', fill: 'rgba(239, 68, 68, 0.2)' };\n    case 'commenting':\n      return { stroke: 'rgb(255, 255, 255)', fill: 'rgba(255, 255, 255, 0.2)' };\n    default:\n      return { stroke: 'rgb(156, 163, 175)', fill: 'rgba(156, 163, 175, 0.2)' };\n  }\n}\n\ninterface PdfAnnotationCanvasProps {\n  resourceUri: ResourceUri;\n  existingAnnotations?: Annotation[];\n  drawingMode: DrawingMode;\n  selectedMotivation?: SelectionMotivation | null;\n  eventBus?: EventBus;\n  hoveredAnnotationId?: string | null;\n  selectedAnnotationId?: string | null;\n}\n\n/**\n * PDF annotation canvas with page navigation and rectangle drawing\n *\n * @emits annotation:click - Annotation clicked on PDF. Payload: { annotationId: string, motivation: Motivation }\n * @emits annotation:requested - New annotation drawn on PDF. Payload: { selector: FragmentSelector, motivation: SelectionMotivation }\n * @emits annotation:hover - Annotation hovered or unhovered. Payload: { annotationId: string | null }\n */\nexport function PdfAnnotationCanvas({\n  resourceUri,\n  existingAnnotations = [],\n  drawingMode,\n  selectedMotivation,\n  eventBus,\n  hoveredAnnotationId,\n  selectedAnnotationId\n}: PdfAnnotationCanvasProps) {\n  const pdfUrl = useMemo(() => {\n    const resourceId = resourceUri.split('/').pop();\n    return `/api/resources/${resourceId}`;\n  }, [resourceUri]);\n\n  // Removed excessive logging\n\n  // PDF state\n  const [pdfDoc, setPdfDoc] = useState<PDFDocumentProxy | null>(null);\n  const [numPages, setNumPages] = useState<number>(0);\n  const [pageNumber, setPageNumber] = useState(1);\n  const [pageImageUrl, setPageImageUrl] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n  const [pageDimensions, setPageDimensions] = useState<{ width: number; height: number } | null>(null);\n  const [displayDimensions, setDisplayDimensions] = useState<{ width: number; height: number } | null>(null);\n  const [scale] = useState(1.5); // Fixed scale for better quality\n\n  // Drawing state\n  const [isDrawing, setIsDrawing] = useState(false);\n  const [selection, setSelection] = useState<CanvasRectangle | null>(null);\n\n  const containerRef = useRef<HTMLDivElement>(null);\n  const imageRef = useRef<HTMLImageElement>(null);\n\n  // Load PDF document on mount\n  useEffect(() => {\n    let cancelled = false;\n\n    async function loadPdf() {\n      try {\n        setIsLoading(true);\n        setError(null);\n\n        const doc = await loadPdfDocument(pdfUrl);\n\n        if (cancelled) return;\n\n        setPdfDoc(doc);\n        setNumPages(doc.numPages);\n        setIsLoading(false);\n      } catch (err) {\n        if (cancelled) return;\n\n        console.error('Error loading PDF:', err);\n        setError('Failed to load PDF');\n        setIsLoading(false);\n      }\n    }\n\n    loadPdf();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [pdfUrl]);\n\n  // Load current page when page number changes\n  useEffect(() => {\n    if (!pdfDoc) return;\n\n    let cancelled = false;\n    const doc = pdfDoc;\n\n    async function loadPage() {\n      try {\n        const page = await doc.getPage(pageNumber);\n\n        if (cancelled) return;\n\n        // Get page dimensions (at scale 1.0)\n        const viewport = page.getViewport({ scale: 1.0 });\n        setPageDimensions({\n          width: viewport.width,\n          height: viewport.height\n        });\n\n        // Render page to image\n        const { dataUrl } = await renderPdfPageToDataUrl(page, scale);\n\n        if (cancelled) return;\n\n        setPageImageUrl(dataUrl);\n      } catch (err) {\n        if (cancelled) return;\n\n        console.error('Error loading page:', err);\n        setError('Failed to load page');\n      }\n    }\n\n    loadPage();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [pdfDoc, pageNumber, scale]);\n\n  // Update display dimensions on resize\n  useEffect(() => {\n    const updateDisplayDimensions = () => {\n      if (imageRef.current) {\n        setDisplayDimensions({\n          width: imageRef.current.clientWidth,\n          height: imageRef.current.clientHeight\n        });\n      }\n    };\n\n    updateDisplayDimensions();\n\n    // Use ResizeObserver to detect image element size changes\n    // This catches: sidebar open/close, window resize, font size changes, etc.\n    let resizeObserver: ResizeObserver | null = null;\n\n    try {\n      resizeObserver = new ResizeObserver(updateDisplayDimensions);\n      if (imageRef.current) {\n        resizeObserver.observe(imageRef.current);\n      }\n    } catch (error) {\n      // Fallback for browsers without ResizeObserver support\n      console.warn('ResizeObserver not supported, falling back to window resize listener');\n      window.addEventListener('resize', updateDisplayDimensions);\n    }\n\n    return () => {\n      if (resizeObserver) {\n        resizeObserver.disconnect();\n      } else {\n        window.removeEventListener('resize', updateDisplayDimensions);\n      }\n    };\n  }, [pageImageUrl]);\n\n  // Mouse event handlers for drawing\n  const handleMouseDown = useCallback((e: React.MouseEvent) => {\n    if (!drawingMode) return;\n    if (!imageRef.current) return;\n\n    const rect = imageRef.current.getBoundingClientRect();\n    const x = e.clientX - rect.left;\n    const y = e.clientY - rect.top;\n\n    // Clear any previous selection when starting new drawing\n    setIsDrawing(true);\n    setSelection({\n      startX: x,\n      startY: y,\n      endX: x,\n      endY: y\n    });\n  }, [drawingMode]);\n\n  const handleMouseMove = useCallback((e: React.MouseEvent) => {\n    if (!isDrawing || !selection || !imageRef.current) return;\n\n    const rect = imageRef.current.getBoundingClientRect();\n\n    setSelection({\n      ...selection,\n      endX: e.clientX - rect.left,\n      endY: e.clientY - rect.top\n    });\n  }, [isDrawing, selection]);\n\n  const handleMouseUp = useCallback(() => {\n    if (!isDrawing || !selection || !pageDimensions || !displayDimensions || !eventBus) {\n      setIsDrawing(false);\n      setSelection(null);\n      return;\n    }\n\n    // Calculate drag distance\n    const dragDistance = Math.sqrt(\n      Math.pow(selection.endX - selection.startX, 2) +\n      Math.pow(selection.endY - selection.startY, 2)\n    );\n\n    // Minimum drag threshold in pixels (10px)\n    const MIN_DRAG_DISTANCE = 10;\n\n    if (dragDistance < MIN_DRAG_DISTANCE) {\n      // This was a click, not a drag - check if we clicked an existing annotation\n      if (existingAnnotations.length > 0) {\n        const clickedAnnotation = pageAnnotations.find(ann => {\n          const fragmentSel = getFragmentSelector(ann.target);\n          if (!fragmentSel) return false;\n\n          const pdfCoord = parseFragmentSelector(fragmentSel.value);\n          if (!pdfCoord) return false;\n\n          const rect = pdfToCanvasCoordinates(pdfCoord, pageDimensions.height, 1.0);\n\n          // Scale to display coordinates\n          const scaleX = displayDimensions.width / pageDimensions.width;\n          const scaleY = displayDimensions.height / pageDimensions.height;\n\n          const displayX = rect.x * scaleX;\n          const displayY = rect.y * scaleY;\n          const displayWidth = rect.width * scaleX;\n          const displayHeight = rect.height * scaleY;\n\n          return (\n            selection.endX >= displayX &&\n            selection.endX <= displayX + displayWidth &&\n            selection.endY >= displayY &&\n            selection.endY <= displayY + displayHeight\n          );\n        });\n\n        if (clickedAnnotation) {\n          eventBus?.get('annotation:click').next({ annotationId: clickedAnnotation.id, motivation: clickedAnnotation.motivation });\n          setIsDrawing(false);\n          setSelection(null);\n          return;\n        }\n      }\n\n      // Click on empty space - do nothing\n      setIsDrawing(false);\n      setSelection(null);\n      return;\n    }\n\n    // This was a drag - create new annotation\n    // Scale selection from display coordinates to native page coordinates\n    const scaleX = pageDimensions.width / displayDimensions.width;\n    const scaleY = pageDimensions.height / displayDimensions.height;\n\n    const nativeSelection: CanvasRectangle = {\n      startX: selection.startX * scaleX,\n      startY: selection.startY * scaleY,\n      endX: selection.endX * scaleX,\n      endY: selection.endY * scaleY\n    };\n\n    // Convert canvas coordinates to PDF coordinates\n    const pdfCoord = canvasToPdfCoordinates(\n      nativeSelection,\n      pageNumber,\n      pageDimensions.width,\n      pageDimensions.height,\n      1.0 // Use scale 1.0 since we already scaled to native coords\n    );\n\n    // Create FragmentSelector\n    const fragmentSelector = createFragmentSelector(pdfCoord);\n\n    // Emit annotation:requested event with FragmentSelector\n    if (selectedMotivation) {\n      eventBus.get('annotation:requested').next({\n        selector: {\n          type: 'FragmentSelector',\n          conformsTo: 'http://tools.ietf.org/rfc/rfc3778',\n          value: fragmentSelector\n        },\n        motivation: selectedMotivation\n      });\n    }\n\n    // Keep drawing state active to show preview until annotation is persisted\n    // The parent component should clear this by changing drawingMode after save\n    setIsDrawing(false);\n    // Note: We keep selection so the preview remains visible\n    // It will be cleared when drawingMode changes or user starts new selection\n  }, [isDrawing, selection, pageNumber, pageDimensions, displayDimensions, selectedMotivation, existingAnnotations]);\n\n  // Helper to get FragmentSelector from annotation target\n  const getFragmentSelector = (target: Annotation['target']) => {\n    const selector = getTargetSelector(target);\n    if (!selector) return null;\n    const selectors = Array.isArray(selector) ? selector : [selector];\n\n    const found = selectors.find(s => s.type === 'FragmentSelector');\n    if (!found || found.type !== 'FragmentSelector') return null;\n    return found as { type: 'FragmentSelector'; value: string; conformsTo?: string };\n  };\n\n  // Filter annotations for current page\n  const pageAnnotations = existingAnnotations.filter(ann => {\n    const fragmentSel = getFragmentSelector(ann.target);\n    if (!fragmentSel) return false;\n    const page = getPageFromFragment(fragmentSel.value);\n    return page === pageNumber;\n  });\n\n  // Hover handlers with currentHover guard and dwell delay\n  const { handleMouseEnter, handleMouseLeave } = useMemo(\n    () => createHoverHandlers((annotationId) => eventBus?.get('annotation:hover').next({ annotationId })),\n    [eventBus]\n  );\n\n  // Calculate motivation color\n  const { stroke, fill } = getMotivationColor(selectedMotivation ?? null);\n\n  if (error) {\n    return <div className=\"semiont-pdf-annotation-canvas__error\">{error}</div>;\n  }\n\n  return (\n    <div className=\"semiont-pdf-annotation-canvas\">\n      {isLoading && <div className=\"semiont-pdf-annotation-canvas__loading\">Loading PDF...</div>}\n\n      <div\n        ref={containerRef}\n        className=\"semiont-pdf-annotation-canvas__container\"\n        style={{ display: isLoading ? 'none' : undefined }}\n        onMouseDown={handleMouseDown}\n        onMouseMove={handleMouseMove}\n        onMouseUp={handleMouseUp}\n        onMouseLeave={() => {\n          if (isDrawing) {\n            setIsDrawing(false);\n            setSelection(null);\n          }\n        }}\n        data-drawing-mode={drawingMode || 'none'}\n      >\n        {/* PDF page rendered as image */}\n        {pageImageUrl && (\n          <img\n            ref={imageRef}\n            src={pageImageUrl}\n            alt={`PDF page ${pageNumber}`}\n            className=\"semiont-pdf-annotation-canvas__image\"\n            draggable={false}\n            style={{ pointerEvents: 'none' }}\n            onLoad={() => {\n              // Use double RAF to ensure layout is complete even in onLoad\n              requestAnimationFrame(() => {\n                requestAnimationFrame(() => {\n                  if (imageRef.current) {\n                    setDisplayDimensions({\n                      width: imageRef.current.clientWidth,\n                      height: imageRef.current.clientHeight\n                    });\n                  }\n                });\n              });\n            }}\n          />\n        )}\n\n        {/* SVG overlay for annotations */}\n        {displayDimensions && pageDimensions && (\n          <div className=\"semiont-pdf-annotation-canvas__overlay-container\">\n            <div className=\"semiont-pdf-annotation-canvas__overlay\">\n              <svg\n                className=\"semiont-pdf-annotation-canvas__svg\"\n                width={displayDimensions.width}\n                height={displayDimensions.height}\n              >\n                {/* Render existing annotations for this page */}\n                {pageAnnotations.map(ann => {\n                  const fragmentSel = getFragmentSelector(ann.target);\n                  if (!fragmentSel) return null;\n\n                  const pdfCoord = parseFragmentSelector(fragmentSel.value);\n                  if (!pdfCoord) return null;\n\n                  const rect = pdfToCanvasCoordinates(pdfCoord, pageDimensions.height, 1.0);\n\n                  // Scale to display coordinates\n                  const scaleX = displayDimensions.width / pageDimensions.width;\n                  const scaleY = displayDimensions.height / pageDimensions.height;\n\n                  const isHovered = ann.id === hoveredAnnotationId;\n                  const isSelected = ann.id === selectedAnnotationId;\n\n                  // Get color for this annotation's motivation (not the selected motivation)\n                  const annMotivation = ann.motivation as SelectionMotivation | null;\n                  const { stroke: annStroke, fill: annFill } = getMotivationColor(annMotivation);\n\n                  return (\n                    <rect\n                      key={ann.id}\n                      x={rect.x * scaleX}\n                      y={rect.y * scaleY}\n                      width={rect.width * scaleX}\n                      height={rect.height * scaleY}\n                      stroke={annStroke}\n                      strokeWidth={isSelected ? 4 : isHovered ? 3 : 2}\n                      fill={annFill}\n                      style={{\n                        pointerEvents: 'auto',\n                        cursor: 'pointer',\n                        opacity: isSelected ? 1 : isHovered ? 0.9 : 0.7\n                      }}\n                      onClick={() => eventBus?.get('annotation:click').next({ annotationId: ann.id, motivation: ann.motivation })}\n                      onMouseEnter={() => handleMouseEnter(ann.id)}\n                      onMouseLeave={handleMouseLeave}\n                    />\n                  );\n                })}\n\n                {/* Render current selection while drawing or awaiting save */}\n                {selection && (() => {\n                  const rectX = Math.min(selection.startX, selection.endX);\n                  const rectY = Math.min(selection.startY, selection.endY);\n                  const rectWidth = Math.abs(selection.endX - selection.startX);\n                  const rectHeight = Math.abs(selection.endY - selection.startY);\n\n                  // PDF only supports rectangle shapes (FragmentSelector with viewrect)\n                  // Circle/polygon are disabled in the UI for PDF media types\n                  return (\n                    <rect\n                      x={rectX}\n                      y={rectY}\n                      width={rectWidth}\n                      height={rectHeight}\n                      stroke={stroke}\n                      strokeWidth={2}\n                      strokeDasharray=\"5,5\"\n                      fill={fill}\n                      pointerEvents=\"none\"\n                    />\n                  );\n                })()}\n              </svg>\n            </div>\n          </div>\n        )}\n      </div>\n\n      {/* Page navigation controls */}\n      {numPages > 0 && (\n        <div className=\"semiont-pdf-annotation-canvas__controls\">\n          <button\n            disabled={pageNumber <= 1}\n            onClick={() => setPageNumber(pageNumber - 1)}\n            className=\"semiont-pdf-annotation-canvas__button\"\n          >\n            Previous\n          </button>\n          <span className=\"semiont-pdf-annotation-canvas__page-info\">\n            Page {pageNumber} of {numPages}\n          </span>\n          <button\n            disabled={pageNumber >= numPages}\n            onClick={() => setPageNumber(pageNumber + 1)}\n            className=\"semiont-pdf-annotation-canvas__button\"\n          >\n            Next\n          </button>\n        </div>\n      )}\n    </div>\n  );\n}\n","/**\n * PDF Coordinate Utilities\n *\n * Handles coordinate transformations between:\n * - Canvas space (pixels, top-left origin, Y increases downward)\n * - PDF space (points, bottom-left origin, Y increases upward)\n *\n * Based on RFC 3778 PDF Fragment Identifiers:\n * https://tools.ietf.org/html/rfc3778\n */\n\nexport interface Rectangle {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface PdfCoordinate {\n  page: number;\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface CanvasRectangle {\n  startX: number;\n  startY: number;\n  endX: number;\n  endY: number;\n}\n\n/**\n * Convert canvas coordinates to PDF coordinates\n *\n * Canvas: Origin at top-left, Y increases downward\n * PDF: Origin at bottom-left, Y increases upward\n *\n * @param canvasRect - Rectangle in canvas pixel coordinates\n * @param page - PDF page number (1-indexed)\n * @param pageWidth - PDF page width in points\n * @param pageHeight - PDF page height in points\n * @param scale - Current canvas scale factor\n */\nexport function canvasToPdfCoordinates(\n  canvasRect: CanvasRectangle,\n  page: number,\n  _pageWidth: number,\n  pageHeight: number,\n  scale: number = 1\n): PdfCoordinate {\n  // Normalize rectangle (handle drag in any direction)\n  const x1 = Math.min(canvasRect.startX, canvasRect.endX);\n  const y1 = Math.min(canvasRect.startY, canvasRect.endY);\n  const x2 = Math.max(canvasRect.startX, canvasRect.endX);\n  const y2 = Math.max(canvasRect.startY, canvasRect.endY);\n\n  // Convert from canvas pixels to PDF points\n  const pdfX = x1 / scale;\n  const pdfWidth = (x2 - x1) / scale;\n\n  // Flip Y coordinate (canvas top-left to PDF bottom-left)\n  const pdfY = pageHeight - (y2 / scale);\n  const pdfHeight = (y2 - y1) / scale;\n\n  return {\n    page,\n    x: Math.round(pdfX),\n    y: Math.round(pdfY),\n    width: Math.round(pdfWidth),\n    height: Math.round(pdfHeight)\n  };\n}\n\n/**\n * Convert PDF coordinates to canvas coordinates\n *\n * @param pdfCoord - Coordinates in PDF space\n * @param pageHeight - PDF page height in points\n * @param scale - Current canvas scale factor\n */\nexport function pdfToCanvasCoordinates(\n  pdfCoord: PdfCoordinate,\n  pageHeight: number,\n  scale: number = 1\n): Rectangle {\n  // Convert from PDF points to canvas pixels\n  const canvasX = pdfCoord.x * scale;\n  const canvasWidth = pdfCoord.width * scale;\n\n  // Flip Y coordinate (PDF bottom-left to canvas top-left)\n  const canvasY = (pageHeight - pdfCoord.y - pdfCoord.height) * scale;\n  const canvasHeight = pdfCoord.height * scale;\n\n  return {\n    x: canvasX,\n    y: canvasY,\n    width: canvasWidth,\n    height: canvasHeight\n  };\n}\n\n/**\n * Generate RFC 3778 FragmentSelector value\n *\n * Format: page=N&viewrect=left,top,width,height\n * All coordinates in PDF points\n */\nexport function createFragmentSelector(coord: PdfCoordinate): string {\n  return `page=${coord.page}&viewrect=${coord.x},${coord.y},${coord.width},${coord.height}`;\n}\n\n/**\n * Parse RFC 3778 FragmentSelector value\n *\n * @param fragment - Fragment string like \"page=5&viewrect=100,200,300,400\"\n * @returns Parsed PDF coordinates or null if invalid\n */\nexport function parseFragmentSelector(fragment: string): PdfCoordinate | null {\n  try {\n    // Parse page number\n    const pageMatch = fragment.match(/page=(\\d+)/);\n    if (!pageMatch) return null;\n    const page = parseInt(pageMatch[1], 10);\n\n    // Parse viewrect coordinates\n    const viewrectMatch = fragment.match(/viewrect=([\\d.]+),([\\d.]+),([\\d.]+),([\\d.]+)/);\n    if (!viewrectMatch) return null;\n\n    return {\n      page,\n      x: parseFloat(viewrectMatch[1]),\n      y: parseFloat(viewrectMatch[2]),\n      width: parseFloat(viewrectMatch[3]),\n      height: parseFloat(viewrectMatch[4])\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract page number from FragmentSelector\n */\nexport function getPageFromFragment(fragment: string): number | null {\n  const match = fragment.match(/page=(\\d+)/);\n  return match ? parseInt(match[1], 10) : null;\n}\n","/**\n * Browser PDF.js utilities\n *\n * Uses native browser PDF.js when available, falls back to CDN.\n * Zero npm dependencies - no webpack bundling issues.\n */\n\n// Type definitions for PDF.js API\nexport interface PDFDocumentProxy {\n  numPages: number;\n  getPage(pageNumber: number): Promise<PDFPageProxy>;\n}\n\nexport interface PDFPageProxy {\n  getViewport(params: { scale: number; rotation?: number }): PDFViewport;\n  render(params: PDFRenderParams): PDFRenderTask;\n  getTextContent(): Promise<TextContent>;\n}\n\nexport interface PDFViewport {\n  width: number;\n  height: number;\n  scale: number;\n  rotation: number;\n}\n\nexport interface PDFRenderParams {\n  canvasContext: CanvasRenderingContext2D;\n  viewport: PDFViewport;\n}\n\nexport interface PDFRenderTask {\n  promise: Promise<void>;\n  cancel(): void;\n}\n\nexport interface PDFLib {\n  getDocument(params: { data: ArrayBuffer } | { url: string }): PDFLoadingTask;\n  GlobalWorkerOptions: {\n    workerSrc: string;\n  };\n  version: string;\n}\n\nexport interface PDFLoadingTask {\n  promise: Promise<PDFDocumentProxy>;\n  destroy(): void;\n}\n\n/**\n * Text content types (for Phase 2)\n */\nexport interface TextItem {\n  str: string;\n  dir: string;\n  transform: number[]; // [scaleX, skewX, skewY, scaleY, x, y]\n  width: number;\n  height: number;\n  fontName: string;\n  hasEOL: boolean;\n}\n\nexport interface TextContent {\n  items: TextItem[];\n  styles: Record<string, any>;\n}\n\n/**\n * Ensure PDF.js is available, loading from local public folder if needed\n */\nexport async function ensurePdfJs(): Promise<PDFLib> {\n  // Check if already available (browser native or already loaded)\n  if (typeof window !== 'undefined' && (window as any).pdfjsLib) {\n    return (window as any).pdfjsLib as PDFLib;\n  }\n\n  // Load from local public folder (staged during build)\n  return new Promise((resolve, reject) => {\n    const script = document.createElement('script');\n    script.src = '/pdfjs/pdf.min.mjs';\n    script.type = 'module';\n\n    script.onload = () => {\n      const pdfjsLib = (window as any).pdfjsLib as PDFLib;\n\n      if (!pdfjsLib) {\n        reject(new Error('PDF.js loaded but pdfjsLib not available'));\n        return;\n      }\n\n      // Configure worker (also served from local public folder)\n      pdfjsLib.GlobalWorkerOptions.workerSrc = '/pdfjs/pdf.worker.min.mjs';\n\n      resolve(pdfjsLib);\n    };\n\n    script.onerror = () => {\n      reject(new Error('Failed to load PDF.js from /pdfjs/pdf.min.mjs'));\n    };\n\n    document.head.appendChild(script);\n  });\n}\n\n/**\n * Load PDF document from URL or ArrayBuffer\n *\n * When given a URL string, fetches the PDF as ArrayBuffer with credentials\n * to ensure authentication cookies are included in the request.\n */\nexport async function loadPdfDocument(\n  source: string | ArrayBuffer\n): Promise<PDFDocumentProxy> {\n  const pdfjsLib = await ensurePdfJs();\n\n  if (typeof source === 'string') {\n    // Fetch as ArrayBuffer first to include authentication cookies\n    const response = await fetch(source, {\n      credentials: 'include',\n      headers: {\n        'Accept': 'application/pdf',\n      },\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch PDF: ${response.status} ${response.statusText}`);\n    }\n\n    const arrayBuffer = await response.arrayBuffer();\n    const loadingTask = pdfjsLib.getDocument({ data: arrayBuffer });\n    return loadingTask.promise;\n  } else {\n    const loadingTask = pdfjsLib.getDocument({ data: source });\n    return loadingTask.promise;\n  }\n}\n\n/**\n * Render PDF page to canvas and return as data URL\n */\nexport async function renderPdfPageToDataUrl(\n  page: PDFPageProxy,\n  scale = 1.0\n): Promise<{ dataUrl: string; width: number; height: number }> {\n  const viewport = page.getViewport({ scale });\n\n  // Create canvas\n  const canvas = document.createElement('canvas');\n  const context = canvas.getContext('2d');\n  if (!context) {\n    throw new Error('Failed to get 2D context');\n  }\n\n  canvas.width = viewport.width;\n  canvas.height = viewport.height;\n\n  // Render PDF page to canvas\n  const renderTask = page.render({\n    canvasContext: context,\n    viewport: viewport\n  });\n\n  await renderTask.promise;\n\n  // Convert to data URL\n  return {\n    dataUrl: canvas.toDataURL('image/png'),\n    width: viewport.width,\n    height: viewport.height\n  };\n}\n\n/**\n * Render PDF page with text content extraction (Phase 2)\n *\n * This function extracts text in parallel with rendering for future\n * text layer support. Currently the text content is available but not used.\n */\nexport async function renderPdfPageWithText(\n  page: PDFPageProxy,\n  scale = 1.0\n): Promise<{\n  dataUrl: string;\n  width: number;\n  height: number;\n  textContent: TextContent;\n}> {\n  const viewport = page.getViewport({ scale });\n\n  // Create canvas for rendering\n  const canvas = document.createElement('canvas');\n  const context = canvas.getContext('2d');\n  if (!context) {\n    throw new Error('Failed to get 2D context');\n  }\n\n  canvas.width = viewport.width;\n  canvas.height = viewport.height;\n\n  // Render PDF page to canvas\n  const renderTask = page.render({\n    canvasContext: context,\n    viewport: viewport\n  });\n\n  // Extract text content in parallel (for future text layer support)\n  const [, textContent] = await Promise.all([\n    renderTask.promise,\n    page.getTextContent()\n  ]);\n\n  // Convert to data URL\n  return {\n    dataUrl: canvas.toDataURL('image/png'),\n    width: viewport.width,\n    height: viewport.height,\n    textContent\n  };\n}\n"],"mappings":"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","names":["error","pdfCoord","scaleX","scaleY"]}

package/dist/{chunk-YPYLOBA2.mjs → chunk-C63BARI7.mjs}

@@ -8,7 +8,8 @@ import {
 
 // src/contexts/ApiClientContext.tsx
 import { createContext, useContext, useMemo } from "react";
-import { SemiontApiClient, baseUrl } from "@semiont/api-client";
+import { baseUrl } from "@semiont/core";
+import { SemiontApiClient } from "@semiont/api-client";
 import { jsx } from "react/jsx-runtime";
 var ApiClientContext = createContext(void 0);
 function ApiClientProvider({
@@ -440,4 +441,4 @@ export {
   useTranslations,
   usePreloadTranslations
 };
-//# sourceMappingURL=chunk-YPYLOBA2.mjs.map
+//# sourceMappingURL=chunk-C63BARI7.mjs.map

package/dist/chunk-C63BARI7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/ApiClientContext.tsx","../src/contexts/SessionContext.tsx","../src/components/Toast.tsx","../src/contexts/OpenResourcesContext.tsx","../src/contexts/TranslationContext.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, 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":["createContext","useContext","jsx","jsx","createContext","useContext","jsx","createContext","useContext","useState","useEffect","useMemo","jsx","createContext","useState","useEffect","useMemo","jsx","useContext"]}

package/dist/{chunk-FC6SGLLT.mjs → chunk-M7SZRRIE.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import {
   useEventBus
-} from "./chunk-XS27QKGP.mjs";
+} from "./chunk-ULIET3MW.mjs";
 
 // src/contexts/useEventSubscription.ts
 import { useEffect, useRef, useMemo } from "react";
@@ -15,11 +15,11 @@ function useEventSubscription(eventName, handler) {
     const stableHandler = (payload) => {
       handlerRef.current(payload);
     };
-    eventBus.on(eventName, stableHandler);
+    const subscription = eventBus.get(eventName).subscribe(stableHandler);
     return () => {
-      eventBus.off(eventName, stableHandler);
+      subscription.unsubscribe();
     };
-  }, [eventName]);
+  }, [eventName, eventBus]);
 }
 function useEventSubscriptions(subscriptions) {
   const eventBus = useEventBus();
@@ -33,7 +33,7 @@ function useEventSubscriptions(subscriptions) {
     [Object.keys(subscriptions).sort().join(",")]
   );
   useEffect(() => {
-    const stableHandlers = /* @__PURE__ */ new Map();
+    const subscriptions2 = [];
     for (const eventName of eventNames) {
       const stableHandler = (payload) => {
         const currentHandler = handlersRef.current[eventName];
@@ -43,30 +43,30 @@ function useEventSubscriptions(subscriptions) {
           console.warn("[useEventSubscriptions] No current handler found for:", eventName);
         }
       };
-      stableHandlers.set(eventName, stableHandler);
-      eventBus.on(eventName, stableHandler);
+      const subscription = eventBus.get(eventName).subscribe(stableHandler);
+      subscriptions2.push(subscription);
     }
     return () => {
-      for (const [eventName, stableHandler] of stableHandlers) {
-        eventBus.off(eventName, stableHandler);
+      for (const subscription of subscriptions2) {
+        subscription.unsubscribe();
       }
     };
-  }, [eventNames]);
+  }, [eventNames, eventBus]);
 }
 
 // src/hooks/useAttentionFlow.ts
-import { useState, useRef as useRef2, useCallback } from "react";
+import { useState, useRef as useRef2, useCallback, useEffect as useEffect2 } from "react";
 function useAttentionFlow() {
   const eventBus = useEventBus();
   const [hoveredAnnotationId, setHoveredAnnotationId] = useState(null);
   const handleAnnotationHover = useCallback(({ annotationId }) => {
     setHoveredAnnotationId(annotationId);
     if (annotationId) {
-      eventBus.emit("annotation:sparkle", { annotationId });
+      eventBus.get("annotation:sparkle").next({ annotationId });
     }
   }, []);
   const handleAnnotationClick = useCallback(({ annotationId }) => {
-    eventBus.emit("annotation:focus", { annotationId });
+    eventBus.get("annotation:focus").next({ annotationId });
   }, []);
   useEventSubscriptions({
     "annotation:hover": handleAnnotationHover,
@@ -114,7 +114,7 @@ function useHoverEmitter(annotationId) {
     timerRef.current = setTimeout(() => {
       timerRef.current = null;
       currentHoverRef.current = annotationId;
-      eventBus.emit("annotation:hover", { annotationId });
+      eventBus.get("annotation:hover").next({ annotationId });
     }, HOVER_DELAY_MS);
   }, [annotationId]);
   const onMouseLeave = useCallback(() => {
@@ -124,9 +124,17 @@ function useHoverEmitter(annotationId) {
     }
     if (currentHoverRef.current !== null) {
       currentHoverRef.current = null;
-      eventBus.emit("annotation:hover", { annotationId: null });
+      eventBus.get("annotation:hover").next({ annotationId: null });
     }
   }, []);
+  useEffect2(() => {
+    return () => {
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, []);
   return { onMouseEnter, onMouseLeave };
 }
 
@@ -138,4 +146,4 @@ export {
   createHoverHandlers,
   useHoverEmitter
 };
-//# sourceMappingURL=chunk-FC6SGLLT.mjs.map
+//# sourceMappingURL=chunk-M7SZRRIE.mjs.map

package/dist/chunk-M7SZRRIE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/useEventSubscription.ts","../src/hooks/useAttentionFlow.ts"],"sourcesContent":["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('annotation: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 *   'annotation:created': ({ annotation }) => setNewAnnotation(annotation),\n *   'annotation: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 * useAttentionFlow — 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: annotation:sparkle visual effect (triggerSparkleAnimation) is owned by\n * ResourceViewerPage, which subscribes to annotation:sparkle and delegates to\n * ResourceAnnotationsContext. This hook emits the signal; it does not render the effect.\n *\n * @subscribes annotation:hover - Sets hoveredAnnotationId; emits annotation:sparkle\n * @subscribes annotation:click - Emits annotation:focus (attention relay only)\n * @emits      annotation:sparkle\n * @emits      annotation: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 *    annotation: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 { useEventBus } from '../contexts/EventBusContext';\nimport { useEventSubscriptions } from '../contexts/useEventSubscription';\n\n// ─── useAttentionFlow ─────────────────────────────────────────────────────────\n\nexport interface AttentionFlowState {\n  hoveredAnnotationId: string | null;\n}\n\nexport function useAttentionFlow(): AttentionFlowState {\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('annotation:sparkle').next({ annotationId });\n    }\n  }, []); // eventBus is stable singleton - never in deps\n\n  const handleAnnotationClick = useCallback(({ annotationId }: { annotationId: string }) => {\n    eventBus.get('annotation:focus').next({ annotationId });\n    // Scroll to annotation handled by BrowseView via annotation:focus subscription\n  }, []); // eventBus is stable singleton - never in deps\n\n  useEventSubscriptions({\n    'annotation:hover': handleAnnotationHover,\n    'annotation:click': handleAnnotationClick,\n  });\n\n  return { hoveredAnnotationId };\n}\n\n// ─── createHoverHandlers (use inside useEffect / imperative setup) ────────────\n\n/** Milliseconds the mouse must dwell before annotation: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\nexport function createHoverHandlers(emit: EmitHover): 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    }, HOVER_DELAY_MS);\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 */\nexport function useHoverEmitter(annotationId: string): 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('annotation:hover').next({ annotationId });\n    }, HOVER_DELAY_MS);\n  }, [annotationId]); // 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('annotation: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"],"mappings":"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","names":["subscriptions","useRef","useEffect","useRef","useEffect"]}

package/dist/chunk-ULIET3MW.mjs

@@ -0,0 +1,31 @@
+'use client';
+
+// src/contexts/EventBusContext.tsx
+import { createContext, useContext, useMemo } from "react";
+import { EventBus } from "@semiont/core";
+import { jsx } from "react/jsx-runtime";
+var EventBusContext = createContext(null);
+var globalEventBus = new EventBus();
+function resetEventBusForTesting() {
+  globalEventBus.destroy();
+  globalEventBus = new EventBus();
+  return globalEventBus;
+}
+function EventBusProvider({ children }) {
+  const eventBus = useMemo(() => globalEventBus, []);
+  return /* @__PURE__ */ jsx(EventBusContext.Provider, { value: eventBus, children });
+}
+function useEventBus() {
+  const eventBus = useContext(EventBusContext);
+  if (!eventBus) {
+    throw new Error("useEventBus must be used within EventBusProvider");
+  }
+  return eventBus;
+}
+
+export {
+  resetEventBusForTesting,
+  EventBusProvider,
+  useEventBus
+};
+//# sourceMappingURL=chunk-ULIET3MW.mjs.map

package/dist/chunk-ULIET3MW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contexts/EventBusContext.tsx"],"sourcesContent":["'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 useResolutionFlow 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('annotation:hover').next({ annotationId: '123' });\n * eventBus.get('navigation: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('annotation: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,YAAY,eAA+B;AACnE,SAAS,gBAAgB;AAuFrB;AArFJ,IAAM,kBAAkB,cAA+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,WAAW,QAAQ,MAAM,gBAAgB,CAAC,CAAC;AAEjD,SACE,oBAAC,gBAAgB,UAAhB,EAAyB,OAAO,UAC9B,UACH;AAEJ;AA4BO,SAAS,cAAwB;AACtC,QAAM,WAAW,WAAW,eAAe;AAC3C,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AACA,SAAO;AACT;","names":[]}