@semiont/react-ui 0.2.33-build.81 → 0.2.33-build.83

package/dist/index.d.mts

@@ -1482,27 +1482,6 @@ declare function CacheProvider({ cacheManager, children }: CacheProviderProps):
  */
 declare function useCacheManager(): CacheManager;
 
-interface ResolutionFlowConfig {
-    client: SemiontApiClient;
-    resourceUri: ResourceUri;
-}
-interface ResolutionFlowState {
-    searchModalOpen: boolean;
-    pendingReferenceId: string | null;
-    onCloseSearchModal: () => void;
-}
-/**
- * Hook that handles the Resolution capability: resolving reference annotations
- * to existing resources (search) or new resources (manual creation).
- *
- * Handles: annotation:update-body, reference:link, resolution:search-requested
- *
- * @param emitter - The mitt event bus instance
- * @param config - Configuration including API client and resource URI
- * @returns Resolution flow state (search modal open state and close handler)
- */
-declare function useResolutionFlow(emitter: Emitter<EventMap>, config: ResolutionFlowConfig): ResolutionFlowState;
-
 /**
  * Subscribe to an event bus event with automatic cleanup.
  *
@@ -3686,13 +3665,60 @@ interface ResourceViewerPageProps {
  */
 declare function ResourceViewerPage({ resource, rUri, locale, cacheManager, Link, routes, ToolbarPanels, SearchResourcesModal, GenerationConfigModal, refetchDocument, }: ResourceViewerPageProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * useAttentionFlow — Annotation attention / pointer coordination hook
+ *
+ * Manages which annotation currently has the user's attention:
+ * - Hover state (hoveredAnnotationId)
+ * - Hover → sparkle relay
+ * - Click → focus relay
+ *
+ * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
+ * subscribes to events and pushes values into React state.
+ *
+ * Note: annotation:sparkle visual effect (triggerSparkleAnimation) is owned by
+ * ResourceViewerPage, which subscribes to annotation:sparkle and delegates to
+ * ResourceAnnotationsContext. This hook emits the signal; it does not render the effect.
+ *
+ * @subscribes annotation:hover - Sets hoveredAnnotationId; emits annotation:sparkle
+ * @subscribes annotation:click - Emits annotation:focus (attention relay only)
+ * @emits      annotation:sparkle
+ * @emits      annotation:focus
+ */
+interface AttentionFlowState {
+    hoveredAnnotationId: string | null;
+}
+declare function useAttentionFlow(): AttentionFlowState;
+/** Milliseconds the mouse must dwell before annotation:hover is emitted. */
+declare const HOVER_DELAY_MS = 150;
+type EmitHover = (annotationId: string | null) => void;
+interface HoverHandlers {
+    /** Call with the annotation ID when the mouse enters an annotation element. */
+    handleMouseEnter: (annotationId: string) => void;
+    /** Call when the mouse leaves the annotation element. */
+    handleMouseLeave: () => void;
+    /** Cancel any pending timer — call in the useEffect cleanup. */
+    cleanup: () => void;
+}
+declare function createHoverHandlers(emit: EmitHover): HoverHandlers;
+interface HoverEmitterProps {
+    onMouseEnter: () => void;
+    onMouseLeave: () => void;
+}
+/**
+ * React hook that returns onMouseEnter / onMouseLeave props for a single
+ * annotation entry element.
+ *
+ * @param annotationId - The ID of the annotation this element represents.
+ */
+declare function useHoverEmitter(annotationId: string): HoverEmitterProps;
+
 /**
  * useDetectionFlow - Detection state management hook
  *
  * Manages all annotation detection (manual and AI-driven):
  * - Pending annotation state (user selected text, waiting for confirmation)
  * - Selection events → pending annotation conversion
- * - Annotation interaction (hover, click)
  * - Annotation request routing to appropriate panel
  * - Tracking currently detecting motivation (AI-driven detection)
  * - Detection progress updates from SSE
@@ -3715,7 +3741,6 @@ interface PendingAnnotation {
 }
 interface DetectionFlowState {
     pendingAnnotation: PendingAnnotation | null;
-    hoveredAnnotationId: string | null;
     detectingMotivation: Motivation$9 | null;
     detectionProgress: DetectionProgress | null;
     detectionStreamRef: React.MutableRefObject<AbortController | null>;
@@ -3725,8 +3750,6 @@ interface DetectionFlowState {
  *
  * @param rUri - Resource URI being detected
  * @emits panel:open - Open the annotations panel when annotation is requested
- * @emits annotation:sparkle - Trigger sparkle animation on hovered annotation
- * @emits annotation:focus - Focus/scroll to clicked annotation
  * @emits annotation:created - Annotation successfully created
  * @emits annotation:create-failed - Annotation creation failed
  * @emits annotation:deleted - Annotation successfully deleted
@@ -3743,8 +3766,6 @@ interface DetectionFlowState {
  * @subscribes selection:assessment-requested - User selected text for an assessment
  * @subscribes selection:reference-requested - User selected text for a reference
  * @subscribes annotation:cancel-pending - Cancel pending annotation creation
- * @subscribes annotation:hover - Annotation hover state change
- * @subscribes annotation:click - Annotation clicked
  * @subscribes detection:start - Trigger AI detection SSE stream
  * @subscribes job:cancel-requested - Cancels in-flight detection stream (detection half only)
  * @subscribes detection:progress - Progress update during detection
@@ -3869,4 +3890,25 @@ interface ContextRetrievalFlowState {
 }
 declare function useContextRetrievalFlow(emitter: Emitter<EventMap>, config: ContextRetrievalFlowConfig): ContextRetrievalFlowState;
 
-export { ANNOTATORS, AUTH_EVENTS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AuthEventDetail, type AuthEventType, AuthTokenProvider, type AuthTokenProviderProps, type AvailableLocale, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CacheManager, CacheProvider, type CacheProviderProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ContextRetrievalFlowConfig, type ContextRetrievalFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, DetectSection, type DetectionConfig, type DetectionFlowState, DetectionProgress, DetectionProgressWidget, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, EventBus, EventMap, Footer, type GenerationFlowState, type GenerationOptions, GenerationProgress, HighlightEntry, HighlightPanel, HistoryEvent, ImageURLSchema, ImageViewer, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LiveRegionProvider, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, type OpenResource, OpenResourcesManager, OpenResourcesProvider, PageLayout, PanelHeader, type PanelNavigationState, PopupContainer, PopupHeader, type PreparedAnnotation, ProposeEntitiesModal, QUERY_KEYS, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferencesPanel, ResizeHandle, type ResolutionFlowConfig, type ResolutionFlowState, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, type SaveResourceParams, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, type SemiontResource$4 as SemiontResource, SessionExpiryBanner, SessionManager, SessionProvider, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, type StreamStatus, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WelcomePage, type WelcomePageProps, buttonStyles, createCancelDetectionHandler, createDetectionHandler, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, rehypeRenderAnnotations, remarkAnnotations, sanitizeImageURL, saveSelectedShapeForSelectorType, supportsDetection, tokens, useAdmin, useAnnotationManager, useAnnotations, useApiClient, useAuthApi, useAuthToken, useCacheManager, useContextRetrievalFlow, useDebounce, useDebouncedCallback, useDetectionFlow, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGenerationFlow, useHealth, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useObservableExternalNavigation, useObservableRouter, useOpenResources, usePanelNavigation, usePanelWidth, usePreloadTranslations, useResolutionFlow, useResourceAnnotations, useResourceContent, useResourceEvents, useResourceLoadingAnnouncements, useResources, useRovingTabIndex, useSearchAnnouncements, useSessionContext, useSessionExpiry, useTheme, useToast, useTranslations };
+interface ResolutionFlowState {
+    searchModalOpen: boolean;
+    pendingReferenceId: string | null;
+    onCloseSearchModal: () => void;
+}
+/**
+ * Hook that handles the Resolution capability: resolving reference annotations
+ * to existing resources (search) or new resources (manual creation).
+ *
+ * @param rUri - Resource URI being viewed
+ * @returns Resolution flow state (search modal open state and close handler)
+ *
+ * @emits annotation:body-updated - Annotation body successfully updated
+ * @emits annotation:body-update-failed - Annotation body update failed
+ * @emits resolution:search-requested - Search modal requested
+ * @subscribes annotation:update-body - Update annotation body via API
+ * @subscribes reference:link - User clicked "Link Document"; opens search modal
+ * @subscribes resolution:search-requested - Opens search modal with pending reference
+ */
+declare function useResolutionFlow(rUri: ResourceUri): ResolutionFlowState;
+
+export { ANNOTATORS, AUTH_EVENTS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AsyncErrorBoundary, type AttentionFlowState, AuthErrorDisplay, type AuthErrorDisplayProps, type AuthEventDetail, type AuthEventType, AuthTokenProvider, type AuthTokenProviderProps, type AvailableLocale, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CacheManager, CacheProvider, type CacheProviderProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ContextRetrievalFlowConfig, type ContextRetrievalFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, DetectSection, type DetectionConfig, type DetectionFlowState, DetectionProgress, DetectionProgressWidget, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, EventBus, EventMap, Footer, type GenerationFlowState, type GenerationOptions, GenerationProgress, HOVER_DELAY_MS, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, type HoverHandlers, ImageURLSchema, ImageViewer, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LiveRegionProvider, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, type OpenResource, OpenResourcesManager, OpenResourcesProvider, PageLayout, PanelHeader, type PanelNavigationState, PopupContainer, PopupHeader, type PreparedAnnotation, ProposeEntitiesModal, QUERY_KEYS, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferencesPanel, ResizeHandle, type ResolutionFlowState, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, type SaveResourceParams, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, type SemiontResource$4 as SemiontResource, SessionExpiryBanner, SessionManager, SessionProvider, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, type StreamStatus, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WelcomePage, type WelcomePageProps, buttonStyles, createCancelDetectionHandler, createDetectionHandler, createHoverHandlers, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, rehypeRenderAnnotations, remarkAnnotations, sanitizeImageURL, saveSelectedShapeForSelectorType, supportsDetection, tokens, useAdmin, useAnnotationManager, useAnnotations, useApiClient, useAttentionFlow, useAuthApi, useAuthToken, useCacheManager, useContextRetrievalFlow, useDebounce, useDebouncedCallback, useDetectionFlow, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGenerationFlow, useHealth, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useObservableExternalNavigation, useObservableRouter, useOpenResources, usePanelNavigation, usePanelWidth, usePreloadTranslations, useResolutionFlow, useResourceAnnotations, useResourceContent, useResourceEvents, useResourceLoadingAnnouncements, useResources, useRovingTabIndex, useSearchAnnouncements, useSessionContext, useSessionExpiry, useTheme, useToast, useTranslations };