@semiont/react-ui 0.5.5 → 0.5.6

package/dist/index.d.ts

@@ -1,14 +1,13 @@
 import * as _semiont_react_ui from '@semiont/react-ui';
-import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, EventMap, AnnotationId, StoredEventLike, ConnectionState, GatheredContext, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
+import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, EventMap, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, GatheredContext, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
 export { Annotation } from '@semiont/core';
 import * as React$1 from 'react';
 import React__default, { ComponentType, ReactNode, KeyboardEvent as KeyboardEvent$1, Component, ErrorInfo, Ref } from 'react';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { StateUnit, SemiontBrowser, SessionStorage, SessionFactory, SemiontSession, OpenResource, TagSchema, UploadProgress, SemiontClient, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry, SearchPipeline } from '@semiont/sdk';
-export { BeckonStateUnit, GatherStateUnit, GenerateDocumentOptions, HOVER_DELAY_MS, HoverHandlers, MarkStateUnit, MatchStateUnit, PendingAnnotation, SearchPipeline, SearchPipelineOptions, SearchState, YieldStateUnit, createBeckonStateUnit, createGatherStateUnit, createHoverHandlers, createMarkStateUnit, createMatchStateUnit, createSearchPipeline, createYieldStateUnit } from '@semiont/sdk';
+import { StateUnit, SemiontBrowser, SessionStorage, SessionFactory, SemiontSession, OpenResource, TagSchema, UploadProgress, SemiontClient, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry } from '@semiont/sdk';
+export { BeckonStateUnit, GatherStateUnit, GenerateDocumentOptions, HOVER_DELAY_MS, HoverHandlers, MarkStateUnit, MatchStateUnit, PendingAnnotation, SearchPipeline, SearchPipelineOptions, SearchState, TagSchema, YieldStateUnit, createBeckonStateUnit, createGatherStateUnit, createHoverHandlers, createMarkStateUnit, createMatchStateUnit, createSearchPipeline, createYieldStateUnit } from '@semiont/sdk';
 import { Observable } from 'rxjs';
 
 /**
@@ -379,7 +378,7 @@ interface AnnotateToolbarProps {
  * @emits mark:shape-changed - Drawing shape changed. Payload: { shape: ShapeType }
  * @emits mark:mode-toggled - View mode toggled between browse and annotate. Payload: undefined
  */
-declare function AnnotateToolbar({ selectedMotivation, selectedClick, showSelectionGroup, showDeleteButton, showShapeGroup, selectedShape, mediaType, annotateMode, annotators }: AnnotateToolbarProps): react_jsx_runtime.JSX.Element;
+declare function AnnotateToolbar({ selectedMotivation, selectedClick, showSelectionGroup, showDeleteButton, showShapeGroup, selectedShape, mediaType, annotateMode, annotators }: AnnotateToolbarProps): React__default.JSX.Element;
 
 /**
  * Media Type Shape Support
@@ -785,7 +784,7 @@ interface ThemeContextValue {
 }
 declare function ThemeProvider({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React$1.JSX.Element;
 declare function useTheme(): ThemeContextValue;
 
 /**
@@ -827,7 +826,7 @@ interface SemiontProviderProps {
     sessionFactory?: SessionFactory;
     children: ReactNode;
 }
-declare function SemiontProvider({ browser, storage, sessionFactory, children }: SemiontProviderProps): react_jsx_runtime.JSX.Element;
+declare function SemiontProvider({ browser, storage, sessionFactory, children }: SemiontProviderProps): React$1.JSX.Element;
 declare function useSemiont(): SemiontBrowser;
 
 /**
@@ -884,7 +883,7 @@ interface AnnotationProviderProps {
  * </AnnotationProvider>
  * ```
  */
-declare function AnnotationProvider({ annotationManager, children }: AnnotationProviderProps): react_jsx_runtime.JSX.Element;
+declare function AnnotationProvider({ annotationManager, children }: AnnotationProviderProps): React__default.JSX.Element;
 /**
  * Hook to access the AnnotationManager
  *
@@ -941,7 +940,7 @@ interface ResourceAnnotationsContextType {
 }
 declare function ResourceAnnotationsProvider({ children }: {
     children: React__default.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React__default.JSX.Element;
 declare function useResourceAnnotations(): ResourceAnnotationsContextType;
 
 /**
@@ -1029,7 +1028,7 @@ interface TranslationProviderProps {
  * 2. With locale prop: Dynamically loads translations for that locale
  * 3. With translationManager: Use custom translation implementation
  */
-declare function TranslationProvider({ translationManager, locale, loadingComponent, children, }: TranslationProviderProps): react_jsx_runtime.JSX.Element;
+declare function TranslationProvider({ translationManager, locale, loadingComponent, children, }: TranslationProviderProps): React$1.JSX.Element;
 /**
  * Hook to access translations within a namespace
  *
@@ -1063,6 +1062,13 @@ interface TextSegment {
     annotation?: Annotation;
     start: number;
     end: number;
+    /** How `segmentTextWithAnnotations` resolved the anchor. Present only on
+     *  annotated segments — background text has no strategy. */
+    strategy?: AnchorStrategy;
+    /** Confidence of the anchor classification. `'high'` is the no-ambiguity
+     *  path; `'medium'` / `'low'` warrant the visual affordance and a one-
+     *  shot warning log. */
+    confidence?: AnchorConfidence;
 }
 
 interface Props$b {
@@ -1085,7 +1091,7 @@ interface Props$b {
     generatingReferenceId?: string | null;
     hoverDelayMs: number;
 }
-declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$b): react_jsx_runtime.JSX.Element;
+declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$b): React$1.JSX.Element;
 
 type Motivation$6 = components['schemas']['Motivation'];
 type JobProgress$7 = components['schemas']['JobProgress'];
@@ -1098,7 +1104,7 @@ interface AnnotateReferencesProgressWidgetProps {
  *
  * @emits job:cancel-requested - User requested to cancel annotation job. Payload: { jobType: string }
  */
-declare function AnnotateReferencesProgressWidget({ progress, annotationType }: AnnotateReferencesProgressWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function AnnotateReferencesProgressWidget({ progress, annotationType }: AnnotateReferencesProgressWidgetProps): React$1.JSX.Element | null;
 
 interface Props$a {
     children: ReactNode;
@@ -1108,7 +1114,6 @@ interface Props$a {
 interface State {
     hasError: boolean;
     error: Error | null;
-    errorInfo: ErrorInfo | null;
 }
 /**
  * Generic Error Boundary component that catches JavaScript errors
@@ -1119,14 +1124,14 @@ declare class ErrorBoundary extends Component<Props$a, State> {
     static getDerivedStateFromError(error: Error): State;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
     handleReset: () => void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | React$1.JSX.Element | null | undefined;
 }
 /**
  * Specialized error boundary for async components
  */
 declare function AsyncErrorBoundary({ children }: {
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React$1.JSX.Element;
 
 interface ProtectedErrorBoundaryProps {
     children: React__default.ReactNode;
@@ -1151,7 +1156,7 @@ interface ProtectedErrorBoundaryProps {
  * The optional `resetKeys` prop lets callers wire automatic recovery on
  * navigation (e.g. `resetKeys={[location.pathname]}`).
  */
-declare function ProtectedErrorBoundary({ children, resetKeys, }: ProtectedErrorBoundaryProps): react_jsx_runtime.JSX.Element;
+declare function ProtectedErrorBoundary({ children, resetKeys, }: ProtectedErrorBoundaryProps): React__default.JSX.Element;
 
 interface LiveRegionContextType {
     announce: (message: string, priority?: 'polite' | 'assertive') => void;
@@ -1160,7 +1165,7 @@ declare function useLiveRegion(): LiveRegionContextType;
 interface LiveRegionProviderProps {
     children: React__default.ReactNode;
 }
-declare function LiveRegionProvider({ children }: LiveRegionProviderProps): react_jsx_runtime.JSX.Element;
+declare function LiveRegionProvider({ children }: LiveRegionProviderProps): React__default.JSX.Element;
 declare function useSearchAnnouncements(): {
     announceSearchResults: (count: number, query: string) => void;
     announceSearching: () => void;
@@ -1225,7 +1230,7 @@ interface ResizeHandleProps {
  * </div>
  * ```
  */
-declare function ResizeHandle({ onResize, minWidth, maxWidth, position, ariaLabel }: ResizeHandleProps): react_jsx_runtime.JSX.Element;
+declare function ResizeHandle({ onResize, minWidth, maxWidth, position, ariaLabel }: ResizeHandleProps): React__default.JSX.Element;
 
 interface ResourceTagsInlineProps {
     resourceId: string;
@@ -1234,7 +1239,7 @@ interface ResourceTagsInlineProps {
     onUpdate: (tags: string[]) => Promise<void>;
     disabled?: boolean;
 }
-declare function ResourceTagsInline({ tags }: ResourceTagsInlineProps): react_jsx_runtime.JSX.Element | null;
+declare function ResourceTagsInline({ tags }: ResourceTagsInlineProps): React$1.JSX.Element | null;
 
 type ToastType = 'success' | 'error' | 'info' | 'warning';
 interface ToastMessage {
@@ -1257,7 +1262,7 @@ interface ToastContextType {
 }
 declare function ToastProvider({ children }: {
     children: React__default.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React__default.JSX.Element;
 declare function useToast(): ToastContextType;
 
 type ToolbarContext = 'document' | 'simple';
@@ -1271,7 +1276,7 @@ interface Props$9<T extends string = string> {
  *
  * @emits panel:toggle - Toggle panel visibility. Payload: { panel: string }
  */
-declare function Toolbar<T extends string = string>({ context, activePanel, isArchived }: Props$9<T>): react_jsx_runtime.JSX.Element;
+declare function Toolbar<T extends string = string>({ context, activePanel, isArchived }: Props$9<T>): React$1.JSX.Element;
 
 interface SettingsPanelProps {
     showLineNumbers: boolean;
@@ -1288,28 +1293,28 @@ interface SettingsPanelProps {
  * @emits settings:theme-changed - Theme changed by user. Payload: { theme: 'light' | 'dark' | 'system' }
  * @emits settings:hover-delay-changed - Hover delay changed by user. Payload: { hoverDelayMs: number }
  */
-declare function SettingsPanel({ showLineNumbers, theme, locale, isPendingLocaleChange, hoverDelayMs }: SettingsPanelProps): react_jsx_runtime.JSX.Element;
+declare function SettingsPanel({ showLineNumbers, theme, locale, isPendingLocaleChange, hoverDelayMs }: SettingsPanelProps): React__default.JSX.Element;
 
 interface JsonLdViewProps {
     annotation: Annotation;
     onBack: () => void;
 }
-declare function JsonLdView({ annotation, onBack }: JsonLdViewProps): react_jsx_runtime.JSX.Element;
+declare function JsonLdView({ annotation, onBack }: JsonLdViewProps): React$1.JSX.Element;
 
 interface SelectedTextDisplayProps {
     exact: string;
 }
-declare function SelectedTextDisplay({ exact }: SelectedTextDisplayProps): react_jsx_runtime.JSX.Element;
+declare function SelectedTextDisplay({ exact }: SelectedTextDisplayProps): React__default.JSX.Element;
 interface EntityTypeBadgesProps {
     entityTypes: string;
 }
-declare function EntityTypeBadges({ entityTypes }: EntityTypeBadgesProps): react_jsx_runtime.JSX.Element | null;
+declare function EntityTypeBadges({ entityTypes }: EntityTypeBadgesProps): React__default.JSX.Element | null;
 interface PopupHeaderProps {
     title: string;
     selectedText?: string;
     onClose: () => void;
 }
-declare function PopupHeader({ title, selectedText, onClose }: PopupHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PopupHeader({ title, selectedText, onClose }: PopupHeaderProps): React__default.JSX.Element;
 interface PopupContainerProps {
     children: React__default.ReactNode;
     position: {
@@ -1320,7 +1325,7 @@ interface PopupContainerProps {
     isOpen: boolean;
     wide?: boolean;
 }
-declare function PopupContainer({ children, position, onClose, isOpen, wide }: PopupContainerProps): react_jsx_runtime.JSX.Element;
+declare function PopupContainer({ children, position, onClose, isOpen, wide }: PopupContainerProps): React__default.JSX.Element;
 
 interface AnnotationOverlayProps {
     annotations: Annotation[];
@@ -1339,7 +1344,7 @@ interface AnnotationOverlayProps {
  * @emits beckon:hover - Annotation hovered or unhovered. Payload: { annotationId: string | null }
  * @emits browse:click - Annotation clicked. Payload: { annotationId: string, motivation: Motivation }
  */
-declare function AnnotationOverlay({ annotations, imageWidth, imageHeight, displayWidth, displayHeight, session, hoveredAnnotationId, selectedAnnotationId, hoverDelayMs }: AnnotationOverlayProps): react_jsx_runtime.JSX.Element;
+declare function AnnotationOverlay({ annotations, imageWidth, imageHeight, displayWidth, displayHeight, session, hoveredAnnotationId, selectedAnnotationId, hoverDelayMs }: AnnotationOverlayProps): React$1.JSX.Element;
 
 type DrawingMode = 'rectangle' | 'polygon' | 'circle' | 'freeform' | null;
 interface SvgDrawingCanvasProps {
@@ -1358,13 +1363,13 @@ interface SvgDrawingCanvasProps {
  * @emits browse:click - Annotation clicked on canvas. Payload: { annotationId: string, motivation: Motivation }
  * @emits mark:requested - New annotation drawn on canvas. Payload: { selector: SvgSelector, motivation: SelectionMotivation }
  */
-declare function SvgDrawingCanvas({ imageUrl, existingAnnotations, drawingMode, selectedMotivation, session, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): react_jsx_runtime.JSX.Element;
+declare function SvgDrawingCanvas({ imageUrl, existingAnnotations, drawingMode, selectedMotivation, session, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): React__default.JSX.Element;
 
 interface KeyboardShortcutsHelpModalProps {
     isOpen: boolean;
     onClose: () => void;
 }
-declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcutsHelpModalProps): react_jsx_runtime.JSX.Element;
+declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcutsHelpModalProps): React__default.JSX.Element;
 
 /**
  * Modal that surfaces when a 403 forbidden error is reported via
@@ -1376,7 +1381,7 @@ declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcu
  * signals (not the session itself) so headless sessions
  * (workers/CLIs) don't carry dead observables.
  */
-declare function PermissionDeniedModal(): react_jsx_runtime.JSX.Element;
+declare function PermissionDeniedModal(): React$1.JSX.Element;
 
 /**
  * Modal that surfaces when the active KB's session expires (a 401
@@ -1388,7 +1393,7 @@ declare function PermissionDeniedModal(): react_jsx_runtime.JSX.Element;
  * flag. Modal state lives on signals (not the session itself) so
  * headless sessions (workers/CLIs) don't carry dead observables.
  */
-declare function SessionExpiredModal(): react_jsx_runtime.JSX.Element;
+declare function SessionExpiredModal(): React$1.JSX.Element;
 
 interface Props$8 {
     content: string;
@@ -1414,7 +1419,7 @@ interface Props$8 {
  * @subscribes mark:shape-changed - Toolbar shape changed. Payload: { shape: string }
  * @subscribes beckon:hover - Annotation hovered. Payload: { annotationId: string | null }
  */
-declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode }: Props$8): react_jsx_runtime.JSX.Element;
+declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode }: Props$8): React$1.JSX.Element;
 
 interface Props$7 {
     rUri: ResourceId;
@@ -1424,7 +1429,7 @@ interface Props$7 {
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
 }
-declare function AnnotationHistory({ rUri, hoveredAnnotationId, onEventHover, onEventClick, Link, routes }: Props$7): react_jsx_runtime.JSX.Element | null;
+declare function AnnotationHistory({ rUri, hoveredAnnotationId, onEventHover, onEventClick, Link, routes }: Props$7): React__default.JSX.Element | null;
 
 interface Props$6 {
     content: string;
@@ -1449,7 +1454,7 @@ interface Props$6 {
  * @subscribes beckon:hover - Highlight annotation on hover. Payload: { annotationId: string | null }
  * @subscribes beckon:focus - Scroll to and highlight annotation. Payload: { annotationId: string }
  */
-declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, annotateMode, hoverDelayMs }: Props$6) => react_jsx_runtime.JSX.Element>;
+declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, annotateMode, hoverDelayMs }: Props$6) => React$1.JSX.Element>;
 
 type TranslateFn$4 = (key: string, params?: Record<string, string | number>) => string;
 interface Props$5 {
@@ -1464,7 +1469,7 @@ interface Props$5 {
     onEventClick?: (annotationId: string | null) => void;
     onEventHover?: (annotationId: string | null) => void;
 }
-declare function HistoryEvent({ event, annotations, allEvents, isRelated, t, Link, routes, onEventRef, onEventClick, onEventHover }: Props$5): react_jsx_runtime.JSX.Element;
+declare function HistoryEvent({ event, annotations, allEvents, isRelated, t, Link, routes, onEventRef, onEventClick, onEventHover }: Props$5): React__default.JSX.Element;
 
 /**
  * ResourceViewer - Display and interact with resource content and annotations
@@ -1507,7 +1512,7 @@ interface Props$4 {
  * @subscribes mark:shape-changed - Drawing shape changed. Payload: { shape: string }
  * @subscribes browse:click - User clicked on annotation. Payload: { annotationId: string }
  */
-declare function ResourceViewer({ resource, annotations, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp }: Props$4): react_jsx_runtime.JSX.Element;
+declare function ResourceViewer({ resource, annotations, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp }: Props$4): React__default.JSX.Element;
 
 interface AssessmentEntryProps {
     assessment: Annotation;
@@ -1515,7 +1520,7 @@ interface AssessmentEntryProps {
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function AssessmentEntry({ assessment, isFocused, isHovered, ref, }: AssessmentEntryProps): react_jsx_runtime.JSX.Element;
+declare function AssessmentEntry({ assessment, isFocused, isHovered, ref, }: AssessmentEntryProps): React$1.JSX.Element;
 
 type Motivation$5 = components['schemas']['Motivation'];
 type JobProgress$6 = components['schemas']['JobProgress'];
@@ -1543,7 +1548,7 @@ interface AssessmentPanelProps {
  * @emits mark:cancel-pending - Cancel pending assessment annotation. Payload: undefined
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function AssessmentPanel({ annotations, pendingAnnotation, isAssisting, progress, locale, sourceLanguage, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: AssessmentPanelProps): react_jsx_runtime.JSX.Element;
+declare function AssessmentPanel({ annotations, pendingAnnotation, isAssisting, progress, locale, sourceLanguage, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: AssessmentPanelProps): React$1.JSX.Element;
 
 interface Props$3 {
     /**
@@ -1568,7 +1573,7 @@ interface Props$3 {
     lastEventTimestamp?: string;
     knowledgeBaseName?: string;
 }
-declare function CollaborationPanel({ state, eventCount, lastEventTimestamp, knowledgeBaseName }: Props$3): react_jsx_runtime.JSX.Element;
+declare function CollaborationPanel({ state, eventCount, lastEventTimestamp, knowledgeBaseName }: Props$3): React$1.JSX.Element;
 
 interface CommentEntryProps {
     comment: Annotation;
@@ -1577,7 +1582,7 @@ interface CommentEntryProps {
     annotateMode?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function CommentEntry({ comment, isFocused, isHovered, annotateMode, ref, }: CommentEntryProps): react_jsx_runtime.JSX.Element;
+declare function CommentEntry({ comment, isFocused, isHovered, annotateMode, ref, }: CommentEntryProps): React$1.JSX.Element;
 
 type Motivation$4 = components['schemas']['Motivation'];
 type JobProgress$5 = components['schemas']['JobProgress'];
@@ -1605,7 +1610,7 @@ interface CommentsPanelProps {
  * @emits mark:cancel-pending - Cancel pending comment annotation. Payload: undefined
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function CommentsPanel({ annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, sourceLanguage, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): react_jsx_runtime.JSX.Element;
+declare function CommentsPanel({ annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, sourceLanguage, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): React$1.JSX.Element;
 
 type JobProgress$4 = components['schemas']['JobProgress'];
 interface AssistSectionProps {
@@ -1629,7 +1634,7 @@ interface AssistSectionProps {
  * @emits mark:assist-request - Start assist for annotation type. Payload: { motivation: Motivation, options: { instructions?: string, tone?: string, density?: number } }
  * @emits mark:progress-dismiss - Dismiss the annotation progress display
  */
-declare function AssistSection({ annotationType, isAssisting, locale, sourceLanguage, progress, }: AssistSectionProps): react_jsx_runtime.JSX.Element;
+declare function AssistSection({ annotationType, isAssisting, locale, sourceLanguage, progress, }: AssistSectionProps): React$1.JSX.Element;
 
 interface HighlightEntryProps {
     highlight: Annotation;
@@ -1637,7 +1642,7 @@ interface HighlightEntryProps {
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function HighlightEntry({ highlight, isFocused, isHovered, ref, }: HighlightEntryProps): react_jsx_runtime.JSX.Element;
+declare function HighlightEntry({ highlight, isFocused, isHovered, ref, }: HighlightEntryProps): React$1.JSX.Element;
 
 type Motivation$3 = components['schemas']['Motivation'];
 type JobProgress$3 = components['schemas']['JobProgress'];
@@ -1663,13 +1668,13 @@ interface HighlightPanelProps {
  * @emits mark:create - Create new highlight annotation (auto-triggered). Payload: { motivation: 'highlighting', selector: Selector | Selector[], body: Body[] }
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function HighlightPanel({ annotations, pendingAnnotation, isAssisting, progress, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, sourceLanguage, }: HighlightPanelProps): react_jsx_runtime.JSX.Element;
+declare function HighlightPanel({ annotations, pendingAnnotation, isAssisting, progress, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, sourceLanguage, }: HighlightPanelProps): React$1.JSX.Element;
 
 type SemiontResource$1 = components['schemas']['ResourceDescriptor'];
 interface Props$2 {
     resource: SemiontResource$1;
 }
-declare function JsonLdPanel({ resource: semiontResource }: Props$2): react_jsx_runtime.JSX.Element;
+declare function JsonLdPanel({ resource: semiontResource }: Props$2): React$1.JSX.Element;
 
 interface PanelHeaderProps {
     annotationType: 'highlight' | 'reference' | 'assessment' | 'comment' | 'tag';
@@ -1681,7 +1686,7 @@ interface PanelHeaderProps {
  *
  * Displays the annotation icon, translated title, and count in a consistent format
  */
-declare function PanelHeader({ count, title }: PanelHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PanelHeader({ count, title }: PanelHeaderProps): React$1.JSX.Element;
 
 interface ReferenceEntryProps {
     reference: Annotation;
@@ -1692,7 +1697,7 @@ interface ReferenceEntryProps {
     isGenerating?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function ReferenceEntry({ reference, isFocused, isHovered, routes, annotateMode, isGenerating, ref, }: ReferenceEntryProps): react_jsx_runtime.JSX.Element;
+declare function ReferenceEntry({ reference, isFocused, isHovered, routes, annotateMode, isGenerating, ref, }: ReferenceEntryProps): React$1.JSX.Element;
 
 type JobProgress$2 = components['schemas']['JobProgress'];
 
@@ -1730,7 +1735,7 @@ interface Props$1 {
  * @emits mark:cancel-pending - Cancel pending reference annotation. Payload: undefined
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function ReferencesPanel({ annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, generatingReferenceId, referencedBy, referencedByLoading, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: Props$1): react_jsx_runtime.JSX.Element;
+declare function ReferencesPanel({ annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, generatingReferenceId, referencedBy, referencedByLoading, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: Props$1): React__default.JSX.Element;
 
 type Agent = components['schemas']['Agent'];
 interface Props {
@@ -1754,7 +1759,7 @@ interface Props {
  * @emits mark:unarchive - Unarchive this resource
  * @emits mark:archive - Archive this resource
  */
-declare function ResourceInfoPanel({ resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, }: Props): react_jsx_runtime.JSX.Element;
+declare function ResourceInfoPanel({ resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, }: Props): React$1.JSX.Element;
 
 interface StatisticsPanelProps {
     highlights: Annotation[];
@@ -1763,7 +1768,7 @@ interface StatisticsPanelProps {
     references: Annotation[];
     tags: Annotation[];
 }
-declare function StatisticsPanel({ highlights, comments, assessments, references, tags }: StatisticsPanelProps): react_jsx_runtime.JSX.Element;
+declare function StatisticsPanel({ highlights, comments, assessments, references, tags }: StatisticsPanelProps): React$1.JSX.Element;
 
 interface TagEntryProps {
     tag: Annotation;
@@ -1771,7 +1776,7 @@ interface TagEntryProps {
     isHovered?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function TagEntry({ tag, isFocused, isHovered, ref, }: TagEntryProps): react_jsx_runtime.JSX.Element;
+declare function TagEntry({ tag, isFocused, isHovered, ref, }: TagEntryProps): React$1.JSX.Element;
 
 type Motivation$1 = components['schemas']['Motivation'];
 type JobProgress$1 = components['schemas']['JobProgress'];
@@ -1801,7 +1806,7 @@ interface TaggingPanelProps {
  * @emits mark:create - Create new tag annotation. Payload: { motivation: 'tagging', selector: Selector | Selector[], body: Body[] }
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function TaggingPanel({ annotations, annotateMode, isAssisting, progress, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: TaggingPanelProps): react_jsx_runtime.JSX.Element;
+declare function TaggingPanel({ annotations, annotateMode, isAssisting, progress, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: TaggingPanelProps): React$1.JSX.Element;
 
 type JobProgress = components['schemas']['JobProgress'];
 
@@ -1847,14 +1852,14 @@ interface UnifiedAnnotationsPanelProps {
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
 }
-declare function UnifiedAnnotationsPanel(props: UnifiedAnnotationsPanelProps): react_jsx_runtime.JSX.Element;
+declare function UnifiedAnnotationsPanel(props: UnifiedAnnotationsPanelProps): React__default.JSX.Element;
 
 interface ImageViewerProps {
     imageUrl: string;
     mimeType: string;
     alt?: string;
 }
-declare function ImageViewer({ imageUrl, alt }: ImageViewerProps): react_jsx_runtime.JSX.Element;
+declare function ImageViewer({ imageUrl, alt }: ImageViewerProps): React$1.JSX.Element;
 
 type TranslateFn$3 = (key: string, params?: Record<string, any>) => string;
 interface FooterProps {
@@ -1870,12 +1875,12 @@ interface FooterProps {
     /** Show About, Privacy Policy, Terms of Service, Cookie Preferences links. False for desktop apps. */
     showPolicyLinks?: boolean;
 }
-declare function Footer({ Link, routes, t, CookiePreferences, onOpenKeyboardHelp, sourceCodeUrl, showPolicyLinks, }: FooterProps): react_jsx_runtime.JSX.Element;
+declare function Footer({ Link, routes, t, CookiePreferences, onOpenKeyboardHelp, sourceCodeUrl, showPolicyLinks, }: FooterProps): React__default.JSX.Element;
 
 type TranslateFn$2 = (key: string, params?: Record<string, any>) => string;
 interface NavigationMenuProps {
     Link: React__default.ComponentType<LinkComponentProps>;
-    routes: RouteBuilder;
+    routes: Partial<RouteBuilder>;
     t: TranslateFn$2;
     isAdmin?: boolean;
     isModerator?: boolean;
@@ -1884,7 +1889,7 @@ interface NavigationMenuProps {
     className?: string;
     currentPath?: string;
 }
-declare function NavigationMenu({ Link, routes, t, isAdmin, isModerator, onItemClick, className, currentPath }: NavigationMenuProps): react_jsx_runtime.JSX.Element;
+declare function NavigationMenu({ Link, routes, t, isAdmin, isModerator, onItemClick, className, currentPath }: NavigationMenuProps): React__default.JSX.Element;
 
 /**
  * Props for ObservableLink component
@@ -1935,7 +1940,7 @@ interface ObservableLinkProps extends React__default.AnchorHTMLAttributes<HTMLAn
  *
  * @emits nav:link-clicked - Link clicked by user. Payload: { href: string, label?: string }
  */
-declare function ObservableLink({ href, label, onClick, children, ...anchorProps }: ObservableLinkProps): react_jsx_runtime.JSX.Element;
+declare function ObservableLink({ href, label, onClick, children, ...anchorProps }: ObservableLinkProps): React__default.JSX.Element;
 
 interface SimpleNavigationItem$1 {
     name: string;
@@ -1969,7 +1974,7 @@ interface SimpleNavigationProps$1 {
  *
  * @emits shell:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
  */
-declare function SimpleNavigation({ title, items, currentPath, LinkComponent, dropdownContent, isCollapsed, icons, collapseSidebarLabel, expandSidebarLabel }: SimpleNavigationProps$1): react_jsx_runtime.JSX.Element;
+declare function SimpleNavigation({ title, items, currentPath, LinkComponent, dropdownContent, isCollapsed, icons, collapseSidebarLabel, expandSidebarLabel }: SimpleNavigationProps$1): React__default.JSX.Element;
 
 /**
  * Props for the sortable resource tab component
@@ -2037,13 +2042,13 @@ interface CollapsibleResourceNavigationProps {
  * @emits tabs:close - Resource tab closed. Payload: { resourceId: string }
  * @emits shell:sidebar-toggle - Toggle sidebar collapsed/expanded state. Payload: undefined
  */
-declare function CollapsibleResourceNavigation({ fixedItems, resources, isCollapsed, currentPath, LinkComponent, onNavigate, getResourceHref, className, translations, icons, navigationMenu }: CollapsibleResourceNavigationProps): react_jsx_runtime.JSX.Element;
+declare function CollapsibleResourceNavigation({ fixedItems, resources, isCollapsed, currentPath, LinkComponent, onNavigate, getResourceHref, className, translations, icons, navigationMenu }: CollapsibleResourceNavigationProps): React__default.JSX.Element;
 
 /**
  * A sortable tab for an open resource in the navigation sidebar.
  * Supports drag and drop when expanded, and compact icon-only view when collapsed.
  */
-declare function SortableResourceTab({ resource, isCollapsed, isActive, href, onClose, onReorder, index, totalCount, LinkComponent, translations, isDragging }: SortableResourceTabProps): react_jsx_runtime.JSX.Element;
+declare function SortableResourceTab({ resource, isCollapsed, isActive, href, onClose, onReorder, index, totalCount, LinkComponent, translations, isDragging }: SortableResourceTabProps): React__default.JSX.Element;
 
 interface SimpleNavigationItem {
     name: string;
@@ -2129,7 +2134,7 @@ interface ReferenceWizardModalProps {
         semanticScoringHelp: string;
     };
 }
-declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, }: ReferenceWizardModalProps): react_jsx_runtime.JSX.Element;
+declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, }: ReferenceWizardModalProps): React$1.JSX.Element;
 
 interface SearchModalProps$1 {
     isOpen: boolean;
@@ -2147,7 +2152,7 @@ interface SearchModalProps$1 {
         esc?: string;
     };
 }
-declare function SearchModal({ isOpen, onClose, onNavigate, translations }: SearchModalProps$1): react_jsx_runtime.JSX.Element;
+declare function SearchModal({ isOpen, onClose, onNavigate, translations }: SearchModalProps$1): React__default.JSX.Element;
 
 interface ResourceSearchModalProps$1 {
     isOpen: boolean;
@@ -2162,7 +2167,7 @@ interface ResourceSearchModalProps$1 {
         close?: string;
     };
 }
-declare function ResourceSearchModal({ isOpen, onClose, onSelect, searchTerm, translations }: ResourceSearchModalProps$1): react_jsx_runtime.JSX.Element;
+declare function ResourceSearchModal({ isOpen, onClose, onSelect, searchTerm, translations }: ResourceSearchModalProps$1): React$1.JSX.Element;
 
 /**
  * Base modal props that all modals share
@@ -2219,20 +2224,20 @@ interface ResourceSearchModalProps extends BaseModalProps {
  * These links are visually hidden but become visible when focused
  * They allow keyboard users to quickly jump to main content areas
  */
-declare function SkipLinks(): react_jsx_runtime.JSX.Element;
+declare function SkipLinks(): React$1.JSX.Element;
 
 interface StatusDisplayProps {
     isFullyAuthenticated?: boolean;
     isAuthenticated?: boolean;
     hasValidBackendToken?: boolean;
 }
-declare function StatusDisplay({ isFullyAuthenticated, isAuthenticated, hasValidBackendToken }: StatusDisplayProps): react_jsx_runtime.JSX.Element;
+declare function StatusDisplay({ isFullyAuthenticated, isAuthenticated, hasValidBackendToken }: StatusDisplayProps): React$1.JSX.Element;
 
-declare function SessionTimer(): react_jsx_runtime.JSX.Element | null;
+declare function SessionTimer(): React$1.JSX.Element | null;
 
-declare function SessionExpiryBanner(): react_jsx_runtime.JSX.Element | null;
+declare function SessionExpiryBanner(): React$1.JSX.Element | null;
 
-declare function UserMenuSkeleton(): react_jsx_runtime.JSX.Element;
+declare function UserMenuSkeleton(): React$1.JSX.Element;
 
 type TranslateFn$1 = (key: string) => string;
 interface SemiontBrandingProps {
@@ -2243,7 +2248,7 @@ interface SemiontBrandingProps {
     animated?: boolean;
     compactTagline?: boolean;
 }
-declare function SemiontBranding({ t, className, size, showTagline, animated, compactTagline }: SemiontBrandingProps): react_jsx_runtime.JSX.Element;
+declare function SemiontBranding({ t, className, size, showTagline, animated, compactTagline }: SemiontBrandingProps): React$1.JSX.Element;
 
 /**
  * Translation function type for framework-agnostic components
@@ -2264,7 +2269,7 @@ interface UnifiedHeaderProps {
     isModerator?: boolean;
     currentPath?: string;
 }
-declare function UnifiedHeader({ Link, routes, t, tHome, showBranding, brandingLink, variant, isAuthenticated, isAdmin, isModerator, currentPath }: UnifiedHeaderProps): react_jsx_runtime.JSX.Element;
+declare function UnifiedHeader({ Link, routes, t, tHome, showBranding, brandingLink, variant, isAuthenticated, isAdmin, isModerator, currentPath }: UnifiedHeaderProps): React__default.JSX.Element;
 
 interface NavigationMenuHelper {
     (onClose: () => void): React__default.ReactNode;
@@ -2283,7 +2288,7 @@ interface LeftSidebarProps {
     isModerator?: boolean;
     currentPath?: string;
 }
-declare function LeftSidebar({ Link, routes, t, tHome, children, brandingLink, collapsible, storageKey, isAdmin, isModerator, currentPath }: LeftSidebarProps): react_jsx_runtime.JSX.Element;
+declare function LeftSidebar({ Link, routes, t, tHome, children, brandingLink, collapsible, storageKey, isAdmin, isModerator, currentPath }: LeftSidebarProps): React__default.JSX.Element;
 
 interface PageLayoutProps {
     Link: React__default.ComponentType<LinkComponentProps>;
@@ -2300,7 +2305,7 @@ interface PageLayoutProps {
     }>;
     onOpenKeyboardHelp?: () => void;
 }
-declare function PageLayout({ Link, routes, t, tNav, tHome, children, className, showAuthLinks, CookiePreferences, onOpenKeyboardHelp }: PageLayoutProps): react_jsx_runtime.JSX.Element;
+declare function PageLayout({ Link, routes, t, tNav, tHome, children, className, showAuthLinks, CookiePreferences, onOpenKeyboardHelp }: PageLayoutProps): React__default.JSX.Element;
 
 interface SemiontFaviconProps {
     size?: number;
@@ -2308,7 +2313,7 @@ interface SemiontFaviconProps {
     variant?: 'gradient' | 'solid' | 'outline';
     background?: boolean;
 }
-declare function SemiontFavicon({ size, className, variant, background }: SemiontFaviconProps): react_jsx_runtime.JSX.Element;
+declare function SemiontFavicon({ size, className, variant, background }: SemiontFaviconProps): React$1.JSX.Element;
 
 declare const faviconPaths: {
     readonly ico: "/favicons/favicon.ico";
@@ -2321,6 +2326,13 @@ declare const faviconPaths: {
     readonly manifest: "/favicons/site.webmanifest";
 };
 
+/**
+ * CSS-Agnostic Button Component
+ *
+ * This button uses data attributes instead of hardcoded Tailwind classes,
+ * allowing users to style it with any CSS solution.
+ */
+
 interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
     /**
      * Ref forwarded to the underlying button element
@@ -2359,7 +2371,7 @@ interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElem
      */
     active?: boolean;
 }
-declare function Button({ variant, size, fullWidth, loading, leftIcon, rightIcon, iconOnly, active, className, disabled, children, type, ref, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
+declare function Button({ variant, size, fullWidth, loading, leftIcon, rightIcon, iconOnly, active, className, disabled, children, type, ref, ...props }: ButtonProps): React__default.JSX.Element;
 /**
  * Button Group Component
  *
@@ -2569,14 +2581,14 @@ type TransitionToken = keyof typeof tokens.transitions;
 interface ComposeLoadingStateProps {
     message: string;
 }
-declare function ComposeLoadingState({ message }: ComposeLoadingStateProps): react_jsx_runtime.JSX.Element;
+declare function ComposeLoadingState({ message }: ComposeLoadingStateProps): React$1.JSX.Element;
 
 /**
  * ResourceLoadingState - Loading state component for resource viewer
  *
  * Pure React component - no Next.js dependencies.
  */
-declare function ResourceLoadingState(): react_jsx_runtime.JSX.Element;
+declare function ResourceLoadingState(): React$1.JSX.Element;
 
 /**
  * ResourceErrorState - Error state component for resource viewer
@@ -2587,7 +2599,14 @@ interface ResourceErrorStateProps {
     error: unknown;
     onRetry: () => void;
 }
-declare function ResourceErrorState({ error, onRetry }: ResourceErrorStateProps): react_jsx_runtime.JSX.Element;
+declare function ResourceErrorState({ error, onRetry }: ResourceErrorStateProps): React$1.JSX.Element;
+
+/**
+ * AdminDevOpsPage Component
+ *
+ * Pure React component for the admin devops page.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface DevOpsFeature {
     title: string;
@@ -2613,7 +2632,7 @@ interface AdminDevOpsPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function AdminDevOpsPage({ suggestedFeatures, theme, showLineNumbers, activePanel, translations: t, StatusDisplay, ToolbarPanels, Toolbar, }: AdminDevOpsPageProps): react_jsx_runtime.JSX.Element;
+declare function AdminDevOpsPage({ suggestedFeatures, theme, showLineNumbers, activePanel, translations: t, StatusDisplay, ToolbarPanels, Toolbar, }: AdminDevOpsPageProps): React__default.JSX.Element;
 
 /**
  * ExportCard — Backup trigger
@@ -2631,7 +2650,7 @@ interface ExportCardProps {
     isExporting: boolean;
     translations: ExportCardTranslations;
 }
-declare function ExportCard({ onExport, isExporting, translations: t }: ExportCardProps): react_jsx_runtime.JSX.Element;
+declare function ExportCard({ onExport, isExporting, translations: t }: ExportCardProps): React$1.JSX.Element;
 
 /**
  * ShellStateUnit — app-shell state: which toolbar panel is open, tab-bar
@@ -2691,6 +2710,12 @@ declare function createExchangeStateUnit(browse: ShellStateUnit, exportFn: (para
     includeArchived?: boolean;
 }) => Promise<BackendDownload>, importFn: (file: File) => Observable<ProgressEvent>): ExchangeStateUnit;
 
+/**
+ * ImportCard — File drop zone, preview, and import trigger
+ *
+ * Pure React component. All state and handlers passed as props.
+ */
+
 interface ImportCardTranslations {
     title: string;
     description: string;
@@ -2714,7 +2739,7 @@ interface ImportCardProps {
     isImporting: boolean;
     translations: ImportCardTranslations;
 }
-declare function ImportCard({ onFileSelected, onImport, onCancel, selectedFile, preview, isImporting, translations: t, }: ImportCardProps): react_jsx_runtime.JSX.Element;
+declare function ImportCard({ onFileSelected, onImport, onCancel, selectedFile, preview, isImporting, translations: t, }: ImportCardProps): React__default.JSX.Element;
 
 /**
  * ImportProgress — Shows SSE-driven progress during restore
@@ -2740,7 +2765,13 @@ interface ImportProgressProps {
     result?: Record<string, unknown>;
     translations: ImportProgressTranslations;
 }
-declare function ImportProgress({ phase, message, result, translations: t }: ImportProgressProps): react_jsx_runtime.JSX.Element;
+declare function ImportProgress({ phase, message, result, translations: t }: ImportProgressProps): React$1.JSX.Element;
+
+/**
+ * AdminExchangePage — Backup/Restore admin page
+ *
+ * Pure React component. All state and handlers passed as props.
+ */
 
 interface AdminExchangePageTranslations {
     title: string;
@@ -2768,7 +2799,14 @@ interface AdminExchangePageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function AdminExchangePage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminExchangePageProps): react_jsx_runtime.JSX.Element;
+declare function AdminExchangePage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminExchangePageProps): React__default.JSX.Element;
+
+/**
+ * AdminSecurityPage Component
+ *
+ * Pure React component for the admin security configuration page.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface OAuthProvider {
     name: string;
@@ -2803,7 +2841,14 @@ interface AdminSecurityPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function AdminSecurityPage({ providers, allowedDomains, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminSecurityPageProps): react_jsx_runtime.JSX.Element;
+declare function AdminSecurityPage({ providers, allowedDomains, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminSecurityPageProps): React__default.JSX.Element;
+
+/**
+ * LinkedDataPage — JSON-LD Export/Import moderation page
+ *
+ * Pure React component. All state and handlers passed as props.
+ * Reuses ExportCard, ImportCard, and ImportProgress from admin-exchange.
+ */
 
 interface LinkedDataPageTranslations {
     title: string;
@@ -2831,7 +2876,14 @@ interface LinkedDataPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function LinkedDataPage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: LinkedDataPageProps): react_jsx_runtime.JSX.Element;
+declare function LinkedDataPage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: LinkedDataPageProps): React__default.JSX.Element;
+
+/**
+ * AdminUsersPage Component
+ *
+ * Pure React component for the admin users management page.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface AdminUser {
     id: string;
@@ -2912,7 +2964,17 @@ interface AdminUsersPageProps {
         };
     };
 }
-declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingStats, onUpdateUser, onDeleteUser, onAddUser, onExportUsers, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, buttonStyles, }: AdminUsersPageProps): react_jsx_runtime.JSX.Element;
+declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingStats, onUpdateUser, onDeleteUser, onAddUser, onExportUsers, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, buttonStyles, }: AdminUsersPageProps): React__default.JSX.Element;
+
+/**
+ * SignInForm - Pure React component for authentication
+ *
+ * Supports both Google OAuth and email/password credentials.
+ * No Next.js dependencies - all data via props.
+ *
+ * When backendUrl is provided it is shown as a locked read-only field.
+ * When backendUrl is omitted the user must enter a backend URL to connect to.
+ */
 
 interface SignInFormProps {
     /**
@@ -2981,7 +3043,14 @@ interface SignInFormProps {
  * When backendUrl is provided (re-auth to known workspace) the URL field is locked.
  * When backendUrl is omitted (new connection) the user enters the URL themselves.
  */
-declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, backendUrl, error, showCredentialsAuth, isLoading, translations: t, }: SignInFormProps): react_jsx_runtime.JSX.Element;
+declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, backendUrl, error, showCredentialsAuth, isLoading, translations: t, }: SignInFormProps): React__default.JSX.Element;
+
+/**
+ * SignUpForm - Pure React component for Google OAuth sign-up
+ *
+ * This component is extracted from the page to enable easy testing.
+ * It has no Next.js dependencies and receives all data via props.
+ */
 
 interface SignUpFormProps {
     /**
@@ -3013,7 +3082,13 @@ interface SignUpFormProps {
  * Renders the sign-up form with Google OAuth button.
  * Manages loading state internally.
  */
-declare function SignUpForm({ onSignUp, Link, translations: t }: SignUpFormProps): react_jsx_runtime.JSX.Element;
+declare function SignUpForm({ onSignUp, Link, translations: t }: SignUpFormProps): React__default.JSX.Element;
+
+/**
+ * AuthErrorDisplay - Pure React component for displaying authentication errors
+ *
+ * No Next.js dependencies - receives error type and translations via props.
+ */
 
 interface AuthErrorDisplayProps {
     /**
@@ -3041,7 +3116,14 @@ interface AuthErrorDisplayProps {
  *
  * Displays authentication error messages with a link to try again.
  */
-declare function AuthErrorDisplay({ errorType, Link, translations: t }: AuthErrorDisplayProps): react_jsx_runtime.JSX.Element;
+declare function AuthErrorDisplay({ errorType, Link, translations: t }: AuthErrorDisplayProps): React__default.JSX.Element;
+
+/**
+ * WelcomePage Component
+ *
+ * Pure React component for the welcome/terms acceptance page.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface WelcomePageProps {
     userName?: string;
@@ -3096,7 +3178,14 @@ interface WelcomePageProps {
     PageLayout: React__default.ComponentType<any>;
     Link: React__default.ComponentType<any>;
 }
-declare function WelcomePage({ userName, status, isProcessing, onAccept, onDecline, translations: t, PageLayout, Link, }: WelcomePageProps): react_jsx_runtime.JSX.Element;
+declare function WelcomePage({ userName, status, isProcessing, onAccept, onDecline, translations: t, PageLayout, Link, }: WelcomePageProps): React__default.JSX.Element;
+
+/**
+ * EntityTagsPage Component
+ *
+ * Pure React component for managing entity tags.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface EntityTagsPageProps {
     entityTypes: string[];
@@ -3121,7 +3210,14 @@ interface EntityTagsPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function EntityTagsPage({ entityTypes, error, newTag, onNewTagChange, onAddTag, isAddingTag, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: EntityTagsPageProps): react_jsx_runtime.JSX.Element;
+declare function EntityTagsPage({ entityTypes, error, newTag, onNewTagChange, onAddTag, isAddingTag, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: EntityTagsPageProps): React__default.JSX.Element;
+
+/**
+ * RecentDocumentsPage Component
+ *
+ * Pure React component for viewing recent documents.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface RecentDocumentsPageProps {
     hasDocuments: boolean;
@@ -3141,7 +3237,14 @@ interface RecentDocumentsPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function RecentDocumentsPage({ isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: RecentDocumentsPageProps): react_jsx_runtime.JSX.Element;
+declare function RecentDocumentsPage({ isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: RecentDocumentsPageProps): React__default.JSX.Element;
+
+/**
+ * TagSchemasPage Component
+ *
+ * Pure React component for viewing tag schemas.
+ * All dependencies passed as props - no Next.js hooks!
+ */
 
 interface TagSchemasPageProps {
     schemas: TagSchema[];
@@ -3158,7 +3261,7 @@ interface TagSchemasPageProps {
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
-declare function TagSchemasPage({ schemas, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): react_jsx_runtime.JSX.Element;
+declare function TagSchemasPage({ schemas, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): React__default.JSX.Element;
 
 type ComposeMode = 'new' | 'clone' | 'reference';
 interface ComposeParams {
@@ -3213,6 +3316,14 @@ interface ComposePageStateUnit extends StateUnit {
 }
 declare function createComposePageStateUnit(client: SemiontClient, browse: ShellStateUnit, params: ComposeParams, auth?: AccessToken): ComposePageStateUnit;
 
+/**
+ * ResourceComposePage Component
+ *
+ * Pure React component for creating and editing resources.
+ * Supports three modes: new resource, clone, and reference completion.
+ * All dependencies passed as props - no Next.js hooks!
+ */
+
 interface ResourceComposePageProps {
     mode: 'new' | 'clone' | 'reference';
     cloneData?: CloneData | null;
@@ -3283,7 +3394,7 @@ interface SaveResourceParams {
     annotationUri?: string;
     sourceDocumentId?: string;
 }
-declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, showLineNumbers, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): react_jsx_runtime.JSX.Element;
+declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, showLineNumbers, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): React__default.JSX.Element;
 
 /**
  * Inline upload-progress affordance for the compose page.
@@ -3307,6 +3418,13 @@ interface UploadProgressBarProps {
 }
 declare function UploadProgressBar({ progress, label }: UploadProgressBarProps): React__default.ReactElement | null;
 
+/**
+ * ResourceDiscoveryPage Component
+ *
+ * Pure React component for resource discovery and search.
+ * All dependencies passed as props - no Next.js hooks!
+ */
+
 interface ResourceDiscoveryPageProps {
     recentDocuments: ResourceDescriptor[];
     searchDocuments: ResourceDescriptor[];
@@ -3315,6 +3433,8 @@ interface ResourceDiscoveryPageProps {
     isSearching: boolean;
     searchQuery: string;
     onSearchQueryChange: (query: string) => void;
+    selectedEntityType: string;
+    onSelectedEntityTypeChange: (entityType: string) => void;
     theme: 'light' | 'dark';
     showLineNumbers: boolean;
     activePanel: string | null;
@@ -3340,7 +3460,14 @@ interface ResourceDiscoveryPageProps {
     };
     ToolbarPanels: React__default.ComponentType<any>;
 }
-declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, isSearching, searchQuery, onSearchQueryChange, theme, showLineNumbers, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): react_jsx_runtime.JSX.Element;
+declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, isSearching, searchQuery, onSearchQueryChange, selectedEntityType, onSelectedEntityTypeChange, theme, showLineNumbers, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): React__default.JSX.Element;
+
+/**
+ * ResourceCard Component
+ *
+ * Pure component for displaying a single resource in the discovery grid.
+ * Handles keyboard navigation and accessibility.
+ */
 
 interface ResourceCardProps {
     resource: ResourceDescriptor;
@@ -3349,7 +3476,14 @@ interface ResourceCardProps {
     archivedLabel: string;
     createdLabel: string;
 }
-declare const ResourceCard: React__default.MemoExoticComponent<({ resource, onOpen, tabIndex, archivedLabel, createdLabel }: ResourceCardProps) => react_jsx_runtime.JSX.Element>;
+declare const ResourceCard: React__default.MemoExoticComponent<({ resource, onOpen, tabIndex, archivedLabel, createdLabel }: ResourceCardProps) => React__default.JSX.Element>;
+
+/**
+ * ResourceViewerPage - Self-contained resource viewer component
+ *
+ * Handles all data loading, event subscriptions, and side effects internally.
+ * Only requires minimal props from the framework layer (routing, modals).
+ */
 
 type SemiontResource = ResourceDescriptor;
 interface ResourceViewerPageProps {
@@ -3419,7 +3553,7 @@ interface ResourceViewerPageProps {
  * @subscribes browse:reference-navigate - Navigate to a referenced document
  * @subscribes browse:entity-type-clicked - Navigate filtered by entity type
  */
-declare function ResourceViewerPage({ resource, rUri, locale, Link, routes, ToolbarPanels, refetchDocument, streamStatus, knowledgeBaseName, }: ResourceViewerPageProps): react_jsx_runtime.JSX.Element;
+declare function ResourceViewerPage({ resource, rUri, locale, Link, routes, ToolbarPanels, refetchDocument, streamStatus, knowledgeBaseName, }: ResourceViewerPageProps): React__default.JSX.Element;
 
 interface HoverEmitterProps {
     onMouseEnter: () => void;
@@ -3506,12 +3640,22 @@ interface WelcomeStateUnit extends StateUnit {
 }
 declare function createWelcomeStateUnit(client: SemiontClient): WelcomeStateUnit;
 
+interface DiscoverSearchPipeline {
+    query$: Observable<string>;
+    state$: Observable<{
+        results: ResourceDescriptor[];
+        isSearching: boolean;
+    }>;
+    setQuery(value: string): void;
+}
 interface DiscoverStateUnit extends StateUnit {
     browse: ShellStateUnit;
-    search: SearchPipeline<ResourceDescriptor>;
+    search: DiscoverSearchPipeline;
     recentResources$: Observable<ResourceDescriptor[]>;
     entityTypes$: Observable<string[]>;
     isLoadingRecent$: Observable<boolean>;
+    selectedEntityType$: Observable<string>;
+    setSelectedEntityType(value: string): void;
 }
 declare function createDiscoverStateUnit(client: SemiontClient, browse: ShellStateUnit): DiscoverStateUnit;