@semiont/react-ui 0.2.35-build.95 → 0.2.35-build.97

package/dist/index.d.mts

@@ -11,23 +11,20 @@ import { SemiontApiClient, ValidationResult } from '@semiont/api-client';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { Root } from 'hast';
-import { Root as Root$1 } from 'mdast';
-import { VFile } from 'vfile';
 import { TagSchema } from '@semiont/ontology';
 export { TAG_SCHEMAS, TagCategory, TagSchema, getAllTagSchemas, getSchemaCategory as getTagCategory, getTagSchema, getTagSchemasByDomain, isValidCategory } from '@semiont/ontology';
 
-type Annotation$m = components['schemas']['Annotation'];
+type Annotation$n = components['schemas']['Annotation'];
 /**
  * Collection of all annotation types for a resource.
  * Replaces separate highlights, references, assessments, comments, tags props.
  */
 interface AnnotationsCollection {
-    highlights: Annotation$m[];
-    references: Annotation$m[];
-    assessments: Annotation$m[];
-    comments: Annotation$m[];
-    tags: Annotation$m[];
+    highlights: Annotation$n[];
+    references: Annotation$n[];
+    assessments: Annotation$n[];
+    comments: Annotation$n[];
+    tags: Annotation$n[];
 }
 /**
  * Event handlers for annotation interactions.
@@ -35,7 +32,7 @@ interface AnnotationsCollection {
  */
 interface AnnotationHandlers {
     /** Unified click handler - routes based on annotation type and current mode */
-    onClick?: (annotation: Annotation$m, event?: React.MouseEvent) => void;
+    onClick?: (annotation: Annotation$n, event?: React.MouseEvent) => void;
     /** Unified hover handler for all annotation types */
     onHover?: (annotationId: string | null) => void;
     /** Hover handler specifically for comment panel highlighting */
@@ -84,7 +81,7 @@ interface UICreateAnnotationParams {
  * - linking: Shows Quick Reference popup FIRST, creates when user confirms
  */
 interface AnnotationCreationHandler {
-    onCreate?: (params: UICreateAnnotationParams) => void | Promise<void> | Promise<Annotation$m | undefined>;
+    onCreate?: (params: UICreateAnnotationParams) => void | Promise<void> | Promise<Annotation$n | undefined>;
 }
 /**
  * UI state for annotation toolbar and interactions.
@@ -119,7 +116,7 @@ interface AnnotationConfig {
     annotateMode?: boolean;
 }
 
-type Annotation$l = components['schemas']['Annotation'];
+type Annotation$m = components['schemas']['Annotation'];
 /**
  * Parameters for creating an annotation
  */
@@ -166,7 +163,7 @@ interface AnnotationManager {
      * @param params - Creation parameters (rUri, motivation, selector, body)
      * @returns Promise resolving to the created annotation, or undefined if creation fails
      */
-    createAnnotation: (params: CreateAnnotationParams) => Promise<Annotation$l | undefined>;
+    createAnnotation: (params: CreateAnnotationParams) => Promise<Annotation$m | undefined>;
     /**
      * Delete an annotation
      * @param params - Deletion parameters (annotationId, rUri)
@@ -270,7 +267,7 @@ interface NavigationProps {
  */
 
 type SemiontResource$4 = components['schemas']['ResourceDescriptor'];
-type Annotation$k = components['schemas']['Annotation'];
+type Annotation$l = components['schemas']['Annotation'];
 type Motivation$8 = components['schemas']['Motivation'];
 /**
  * Selection for creating annotations
@@ -298,7 +295,7 @@ interface TextSelection {
  * No aliasing, wrappers, or compatibility layers elsewhere.
  */
 
-type Annotation$j = components['schemas']['Annotation'];
+type Annotation$k = components['schemas']['Annotation'];
 type Motivation$7 = components['schemas']['Motivation'];
 /**
  * Detection configuration for SSE-based annotation detection
@@ -335,7 +332,7 @@ interface Annotator {
     isClickable: boolean;
     hasHoverInteraction: boolean;
     hasSidePanel: boolean;
-    matchesAnnotation: (annotation: Annotation$j) => boolean;
+    matchesAnnotation: (annotation: Annotation$k) => boolean;
     announceOnCreate: string;
     detection?: DetectionConfig;
     create: CreateConfig;
@@ -794,17 +791,17 @@ declare const jsonLightHighlightStyle: HighlightStyle;
  * - Entity type badges
  */
 
-type Annotation$i = components['schemas']['Annotation'];
+type Annotation$j = components['schemas']['Annotation'];
 /**
  * Reference Resolution Widget
  * Shows a small indicator next to references with hover preview
  */
 declare class ReferenceResolutionWidget extends WidgetType {
-    readonly annotation: Annotation$i;
+    readonly annotation: Annotation$j;
     readonly targetDocumentName?: string | undefined;
     readonly eventBus?: EventBus | undefined;
     readonly isGenerating?: boolean | undefined;
-    constructor(annotation: Annotation$i, targetDocumentName?: string | undefined, eventBus?: EventBus | undefined, isGenerating?: boolean | undefined);
+    constructor(annotation: Annotation$j, targetDocumentName?: string | undefined, eventBus?: EventBus | undefined, isGenerating?: boolean | undefined);
     eq(other: ReferenceResolutionWidget): boolean;
     toDOM(): HTMLSpanElement;
     private showPreview;
@@ -936,14 +933,22 @@ declare const QUERY_KEYS: {
     };
 };
 
-declare function rehypeRenderAnnotations(): (tree: Root, file: any) => void;
-
 /**
- * Simplified annotation format for remark plugin.
- * This is NOT the W3C Annotation - it's a pre-processed format with offset/length
- * for efficient markdown text processing.
+ * Annotation overlay: decouples annotation highlighting from markdown rendering.
+ *
+ * Instead of weaving annotations into the markdown AST via remark/rehype plugins
+ * (which forces O(ASTnodes × annotations) work on every render), this module:
+ *
+ * 1. Builds a source→rendered offset map once after the markdown DOM paints
+ * 2. Resolves W3C TextPositionSelector offsets to DOM Ranges via binary search
+ * 3. Wraps matched ranges with <span> elements carrying data-annotation-* attributes
+ *
+ * Markdown renders once (cached by React.memo). Annotation changes only touch
+ * the overlay spans — no markdown re-parse, no AST walk.
  */
-interface PreparedAnnotation {
+
+type Annotation$i = components['schemas']['Annotation'];
+interface OverlayAnnotation {
     id: string;
     exact: string;
     offset: number;
@@ -951,10 +956,53 @@ interface PreparedAnnotation {
     type: string;
     source: string | null;
 }
-interface RemarkAnnotationsOptions {
-    annotations: PreparedAnnotation[];
+interface TextNodeEntry {
+    node: Text;
+    start: number;
+    end: number;
 }
-declare function remarkAnnotations(options: RemarkAnnotationsOptions): (tree: Root$1, _file: VFile) => void;
+/**
+ * Build a map from markdown source offsets to rendered text offsets.
+ * Character-by-character alignment: walks source and rendered text in parallel,
+ * matching characters and skipping markdown syntax in the source.
+ *
+ * Complexity: O(sourceLength) — runs once per content change.
+ */
+declare function buildSourceToRenderedMap(markdownSource: string, container: HTMLElement): Map<number, number>;
+/**
+ * Build a sorted array of text nodes with cumulative rendered offsets
+ * for efficient offset→node lookups via binary search.
+ *
+ * Complexity: O(textNodes) — runs once per overlay application.
+ */
+declare function buildTextNodeIndex(container: HTMLElement): TextNodeEntry[];
+/**
+ * Resolve annotations to DOM Ranges using the cached offset map.
+ *
+ * Complexity: O(annotations × log(textNodes)).
+ */
+declare function resolveAnnotationRanges(annotations: OverlayAnnotation[], offsetMap: Map<number, number>, textNodeIndex: TextNodeEntry[]): Map<string, {
+    range: Range;
+    annotation: OverlayAnnotation;
+}>;
+/**
+ * Wrap annotation Ranges with styled <span> elements.
+ * Handles cross-element ranges by splitting into per-text-node segments.
+ */
+declare function applyHighlights(ranges: Map<string, {
+    range: Range;
+    annotation: OverlayAnnotation;
+}>): void;
+/**
+ * Remove all annotation highlight spans, restoring the original DOM.
+ * Unwraps spans and merges adjacent text nodes.
+ */
+declare function clearHighlights(container: HTMLElement): void;
+/**
+ * Convert W3C Annotations to the simplified overlay format.
+ * Extracts TextPositionSelector offsets and annotation type.
+ */
+declare function toOverlayAnnotations(annotations: Annotation$i[]): OverlayAnnotation[];
 
 /**
  * Resource utilities
@@ -2008,7 +2056,11 @@ interface Props$6 {
     hoverDelayMs?: number;
 }
 /**
- * View component for browsing annotated resources in read-only mode
+ * View component for browsing annotated resources in read-only mode.
+ *
+ * Two-layer rendering:
+ * - Layer 1: Markdown renders once (MemoizedMarkdown, cached by content)
+ * - Layer 2: Annotation overlay applied via DOM Range API after paint
  *
  * @emits attend:click - User clicked on annotation. Payload: { annotationId: string, motivation: Motivation }
  * @emits attend:hover - User hovered over annotation. Payload: { annotationId: string | null }
@@ -2016,7 +2068,7 @@ interface Props$6 {
  * @subscribes attend:hover - Highlight annotation on hover. Payload: { annotationId: string | null }
  * @subscribes attend:focus - Scroll to and highlight annotation. Payload: { annotationId: string }
  */
-declare function BrowseView({ content, mimeType, resourceUri, annotations, selectedClick, annotateMode, hoverDelayMs }: Props$6): react_jsx_runtime.JSX.Element;
+declare const BrowseView: React$1.NamedExoticComponent<Props$6>;
 
 type TranslateFn$4 = (key: string, params?: Record<string, string | number>) => string;
 interface Props$5 {
@@ -3893,4 +3945,4 @@ interface ResolutionFlowState {
  */
 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, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationFlowState, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AssistSection, 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 ContextCorrelationFlowConfig, type ContextCorrelationFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, Footer, type GenerationFlowState, type GenerationOptions, 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, createHoverHandlers, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, rehypeRenderAnnotations, remarkAnnotations, sanitizeImageURL, saveSelectedShapeForSelectorType, supportsDetection, tokens, useAdmin, useAnnotationFlow, useAnnotationManager, useAnnotations, useApiClient, useAttentionFlow, useAuthApi, useAuthToken, useCacheManager, useContextCorrelationFlow, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGenerationFlow, useHealth, useHoverDelay, 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 };
+export { ANNOTATORS, AUTH_EVENTS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type Annotation$l as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationFlowState, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AssistSection, 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 ContextCorrelationFlowConfig, type ContextCorrelationFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, Footer, type GenerationFlowState, type GenerationOptions, 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, type OverlayAnnotation, PageLayout, PanelHeader, type PanelNavigationState, PopupContainer, PopupHeader, 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, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createHoverHandlers, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, supportsDetection, toOverlayAnnotations, tokens, useAdmin, useAnnotationFlow, useAnnotationManager, useAnnotations, useApiClient, useAttentionFlow, useAuthApi, useAuthToken, useCacheManager, useContextCorrelationFlow, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGenerationFlow, useHealth, useHoverDelay, 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 };