@semiont/react-ui 0.5.23 → 0.5.25

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import React__default, { ComponentType, ReactNode, KeyboardEvent as KeyboardEven
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { SemiontSession, SemiontClient, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, OpenResource, TagSchema, UploadProgress, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry } from '@semiont/sdk';
+import { SemiontClient, SemiontSession, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, OpenResource, TagSchema, UploadProgress, 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';
 
@@ -599,6 +599,27 @@ declare function getSelectedShapeForSelectorType(selectorType: SelectorType): Sh
  */
 declare function saveSelectedShapeForSelectorType(selectorType: SelectorType, shape: ShapeType): void;
 
+/**
+ * The URL for a resource's raw bytes — the one shape `GET /api/resources/:id`
+ * accepts from a browser. Pair with `useMediaToken`, which mints (and keeps
+ * refreshing) the token.
+ *
+ * Two things a hand-written `/api/resources/${id}` gets wrong, both of them
+ * silent until the byte never arrives:
+ *
+ * - **It must carry `?token=`.** That route is the browser-facing alias of the
+ *   pipe, and exists only as the auth affordance for `<img>`, PDF.js and
+ *   `<a download>` — none of which can attach an Authorization header. Auth is
+ *   bearer + `?token=` only, no cookie, so a bare URL 401s.
+ * - **It must be absolute.** react-ui embeds into a host app with its own
+ *   origin, so a relative path resolves against the HOST, not the backend.
+ *
+ * Returns `undefined` when either input is missing — no client, or a token
+ * that has not landed yet. There is no partially-correct URL worth rendering;
+ * callers show a not-yet-ready affordance instead of a known-bad link.
+ */
+declare function mediaUrl(client: SemiontClient | null | undefined, id: ResourceId, token: string | undefined): string | undefined;
+
 /**
  * Annotation overlay: decouples annotation highlighting from markdown rendering.
  *
@@ -857,13 +878,14 @@ declare function getShortcutDisplay(shortcut: KeyboardShortcut): string;
  */
 declare function useIsTyping(): boolean;
 
-/**
- * Hook to manage line numbers display setting with localStorage persistence
- */
-declare function useLineNumbers(): {
+interface LineNumbersContextValue {
     showLineNumbers: boolean;
     toggleLineNumbers: () => void;
-};
+}
+declare function LineNumbersProvider({ children }: {
+    children: ReactNode;
+}): React$1.JSX.Element;
+declare function useLineNumbers(): LineNumbersContextValue;
 
 /**
  * Hook to manage hover delay setting with localStorage persistence
@@ -1444,7 +1466,7 @@ interface TextSegment {
     confidence?: AnchorConfidence;
 }
 
-interface Props$b {
+interface Props$c {
     content: string;
     segments?: TextSegment[];
     onTextSelect?: (exact: string, position: {
@@ -1464,26 +1486,37 @@ 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$1.JSX.Element;
+declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$c): React$1.JSX.Element;
 
 type JobProgress$8 = components['schemas']['JobProgress'];
+/**
+ * Every string this component renders. Required by default and with NO
+ * English fallbacks (ASSIST-SURFACE-WARTS Lane A): a `tr.x || 'X'` default
+ * turns a forgotten key into English text in a Japanese UI, silently and
+ * only at runtime. Required keys make the same mistake a type error at the
+ * call site. Only genuinely conditional copy is optional.
+ */
 interface AssistProgressTranslations {
     /** Header title (e.g. "Annotating Entity References" / "Generating Resource"). Omit for the headerless inline style. */
     title?: string;
     /** Cancel-button title attribute. */
-    cancel?: string;
+    cancel: string;
     /** Default in-progress status message (used when the job sends no `message`). */
-    inProgress?: string;
+    inProgress: string;
     /** Status copy for the terminal 'complete' stage. */
-    complete?: string;
+    complete: string;
     /** Fallback status copy for the terminal 'error' stage. */
-    failed?: string;
-    /** Completed entity-type log line (reference flow). */
+    failed: string;
+    /** Request-parameters block heading. */
+    paramsTitle: string;
+    /** Current-work detail line — the generic form, used by every flow. */
+    processing: (label: string) => string;
+    /** Completed entity-type log line (reference flow only). */
     found?: (count: number) => string;
-    /** Current-work detail line (reference flow). */
+    /** Current-work detail line, reference-flow wording; falls back to `processing`. */
     current?: (label: string) => string;
     /** Dismiss-button label. */
-    close?: string;
+    close: string;
 }
 interface AssistProgressProps {
     progress: JobProgress$8;
@@ -1499,7 +1532,7 @@ interface AssistProgressProps {
     onDismiss?: () => void;
     /** Render the percentage bar (tag flow's visual; percentage itself comes from `progress`). */
     showPercentBar?: boolean;
-    translations?: AssistProgressTranslations;
+    translations: AssistProgressTranslations;
 }
 /**
  * The one job-progress renderer (#7) — unifies the three previous shapes
@@ -1526,8 +1559,12 @@ interface AssistShellProps {
      * Pass-through config for the progress renderer (cancel/dismiss wiring,
      * translations, percent bar). Dismiss policy lives HERE: the shell forwards
      * `onDismiss` only once the assist is no longer running.
+     *
+     * Required because `translations` is: the shell renders the progress display
+     * itself, so a caller that omitted this would render untranslated chrome —
+     * the failure Lane A exists to make impossible.
      */
-    progressProps?: Omit<AssistProgressProps, 'progress' | 'dataType'>;
+    progressProps: Omit<AssistProgressProps, 'progress' | 'dataType'>;
 }
 /**
  * The one assist-section chrome (#7): collapsible header with persisted expand
@@ -1538,7 +1575,7 @@ interface AssistShellProps {
  */
 declare function AssistShell({ assistType, title, isAssisting, progress, form, progressProps }: AssistShellProps): React$1.JSX.Element;
 
-interface Props$a {
+interface Props$b {
     children: ReactNode;
     fallback?: (error: Error, reset: () => void) => ReactNode;
     onError?: (error: Error, errorInfo: ErrorInfo) => void;
@@ -1551,8 +1588,8 @@ interface State {
  * Generic Error Boundary component that catches JavaScript errors
  * in child components and displays a fallback UI.
  */
-declare class ErrorBoundary extends Component<Props$a, State> {
-    constructor(props: Props$a);
+declare class ErrorBoundary extends Component<Props$b, State> {
+    constructor(props: Props$b);
     static getDerivedStateFromError(error: Error): State;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
     handleReset: () => void;
@@ -1711,7 +1748,7 @@ declare function ToastProvider({ children }: {
 declare function useToast(): ToastContextType;
 
 type ToolbarContext = 'document' | 'simple';
-interface Props$9<T extends string = string> {
+interface Props$a<T extends string = string> {
     context: ToolbarContext;
     activePanel: T | null;
     isArchived?: boolean;
@@ -1721,10 +1758,9 @@ 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$1.JSX.Element;
+declare function Toolbar<T extends string = string>({ context, activePanel, isArchived }: Props$a<T>): React$1.JSX.Element;
 
 interface SettingsPanelProps {
-    showLineNumbers: boolean;
     theme: 'light' | 'dark' | 'system';
     locale: string;
     isPendingLocaleChange?: boolean;
@@ -1738,7 +1774,7 @@ 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__default.JSX.Element;
+declare function SettingsPanel({ theme, locale, isPendingLocaleChange, hoverDelayMs }: SettingsPanelProps): React__default.JSX.Element;
 
 interface JsonLdViewProps {
     annotation: Annotation;
@@ -1885,7 +1921,7 @@ declare function PdfAnnotateRenderer({ content, resourceUri, annotations, sessio
  */
 declare const defaultAnnotateRenderers: Record<'text' | 'image' | 'pdf', ComponentType<AnnotateMediaRendererProps>>;
 
-interface Props$8 {
+interface Props$9 {
     content: string;
     mimeType?: string;
     /** The '@id' of the shown resource — stamped as `source` on mark:requested (multi-viewer routing). */
@@ -1916,10 +1952,11 @@ interface Props$8 {
  *
  * @emits mark:requested - User requested to create annotation. Payload: { selector: Selector | Selector[], motivation: SelectionMotivation }
  * @subscribes beckon:hover - Annotation hovered. Payload: { annotationId: string | null }
+ * @subscribes beckon:focus - Scroll to and highlight annotation. Payload: { annotationId: string }
  */
-declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode, session, newAnnotationIds, onModeChange, showToolbar, renderers, }: Props$8): React$1.JSX.Element;
+declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode, session, newAnnotationIds, onModeChange, showToolbar, renderers, }: Props$9): React$1.JSX.Element;
 
-interface Props$7 {
+interface Props$8 {
     /**
      * The resource's stored events, and how their load is going. Supplied by the
      * owner (which already holds them on its state unit) rather than fetched
@@ -1940,7 +1977,7 @@ interface Props$7 {
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
 }
-declare function AnnotationHistory({ events: eventsData, eventsLoading, eventsError, onRetryEvents, annotations, hoveredAnnotationId, onEventHover, onEventClick, Link, routes, }: Props$7): React__default.JSX.Element | null;
+declare function AnnotationHistory({ events: eventsData, eventsLoading, eventsError, onRetryEvents, annotations, hoveredAnnotationId, onEventHover, onEventClick, Link, routes, }: Props$8): React__default.JSX.Element | null;
 
 /**
  * Common props for a read-only ("browse") media renderer. `content` is decoded
@@ -1972,7 +2009,7 @@ declare function PdfBrowseRenderer({ content, resourceUri, annotations, session
  */
 declare const defaultBrowseRenderers: Record<'text' | 'image' | 'pdf', ComponentType<MediaRendererProps>>;
 
-interface Props$6 {
+interface Props$7 {
     content: string;
     mimeType: string;
     resourceUri: string;
@@ -2025,7 +2062,31 @@ interface ReferenceHover {
  * @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, onModeChange, onClickActionChange, showToolbar, annotateMode, hoverDelayMs, session, newAnnotationIds, renderers, onLinkClick, onReferenceHover, inline, }: Props$6) => React$1.JSX.Element>;
+declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, onModeChange, onClickActionChange, showToolbar, annotateMode, hoverDelayMs, session, newAnnotationIds, renderers, onLinkClick, onReferenceHover, inline, }: Props$7) => React$1.JSX.Element>;
+
+interface Props$6 {
+    /** The '@id' of the resource whose bytes to offer. */
+    resourceUri: string;
+    /** Session for that resource — its client mints the media token and supplies the backend origin. */
+    session: SemiontSession | null;
+}
+/**
+ * The "Download File" affordance on the unsupported-media fallback, shared by
+ * the browse and annotate views.
+ *
+ * Its own component rather than inline markup for two reasons. The token is a
+ * hook, and this fallback is a branch — mounting the component only in that
+ * branch keeps every text/image/PDF view from minting a media token it will
+ * never use. And the URL rule (absolute + `?token=`) lives in `mediaUrl`,
+ * where both views and the viewer page read the same one.
+ *
+ * Before the token lands the anchor renders as a disabled button: a tokenless
+ * URL is a guaranteed 401, and a link that silently fails is worse than one
+ * visibly not ready yet. A client with no `auth` namespace (a host on a bare
+ * transport) stays in that state permanently, which is the honest answer —
+ * it cannot mint tokens at all.
+ */
+declare function DownloadFileLink({ resourceUri, session }: Props$6): React$1.JSX.Element;
 
 type TranslateFn$4 = (key: string, params?: Record<string, string | number>) => string;
 interface Props$5 {
@@ -3384,7 +3445,6 @@ interface DevOpsFeature {
 interface AdminDevOpsPageProps {
     suggestedFeatures: DevOpsFeature[];
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         title: string;
@@ -3399,7 +3459,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__default.JSX.Element;
+declare function AdminDevOpsPage({ suggestedFeatures, theme, activePanel, translations: t, StatusDisplay, ToolbarPanels, Toolbar, }: AdminDevOpsPageProps): React__default.JSX.Element;
 
 /**
  * ExportCard — Backup trigger
@@ -3556,13 +3616,12 @@ interface AdminExchangePageProps {
     importMessage?: string | undefined;
     importResult?: Record<string, unknown> | undefined;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: AdminExchangePageTranslations;
     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__default.JSX.Element;
+declare function AdminExchangePage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminExchangePageProps): React__default.JSX.Element;
 
 /**
  * AdminSecurityPage Component
@@ -3580,7 +3639,6 @@ interface AdminSecurityPageProps {
     allowedDomains: string[];
     isLoading: boolean;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         title: string;
@@ -3604,7 +3662,7 @@ 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__default.JSX.Element;
+declare function AdminSecurityPage({ providers, allowedDomains, isLoading, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminSecurityPageProps): React__default.JSX.Element;
 
 /**
  * LinkedDataPage — JSON-LD Export/Import moderation page
@@ -3633,13 +3691,12 @@ interface LinkedDataPageProps {
     importMessage?: string | undefined;
     importResult?: Record<string, unknown> | undefined;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: LinkedDataPageTranslations;
     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__default.JSX.Element;
+declare function LinkedDataPage({ onExport, isExporting, onFileSelected, onImport, onCancelImport, selectedFile, preview, isImporting, importPhase, importMessage, importResult, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: LinkedDataPageProps): React__default.JSX.Element;
 
 /**
  * AdminUsersPage Component
@@ -3677,7 +3734,6 @@ interface AdminUsersPageProps {
     onAddUser: () => void;
     onExportUsers: () => void;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         title: string;
@@ -3727,7 +3783,7 @@ interface AdminUsersPageProps {
         };
     };
 }
-declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingStats, onUpdateUser, onDeleteUser, onAddUser, onExportUsers, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, buttonStyles, }: AdminUsersPageProps): React__default.JSX.Element;
+declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingStats, onUpdateUser, onDeleteUser, onAddUser, onExportUsers, theme, activePanel, translations: t, ToolbarPanels, Toolbar, buttonStyles, }: AdminUsersPageProps): React__default.JSX.Element;
 
 /**
  * SignInForm - Pure React component for authentication
@@ -3959,7 +4015,6 @@ interface EntityTagsPageProps {
     onAddTag: () => void;
     isAddingTag: boolean;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         pageTitle: string;
@@ -3973,7 +4028,7 @@ 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__default.JSX.Element;
+declare function EntityTagsPage({ entityTypes, error, newTag, onNewTagChange, onAddTag, isAddingTag, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: EntityTagsPageProps): React__default.JSX.Element;
 
 /**
  * RecentDocumentsPage Component
@@ -3986,7 +4041,6 @@ interface RecentDocumentsPageProps {
     hasDocuments: boolean;
     isLoading: boolean;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         pageTitle: string;
@@ -4000,7 +4054,7 @@ 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__default.JSX.Element;
+declare function RecentDocumentsPage({ isLoading, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: RecentDocumentsPageProps): React__default.JSX.Element;
 
 /**
  * TagSchemasPage Component
@@ -4013,7 +4067,6 @@ interface TagSchemasPageProps {
     schemas: TagSchema[];
     isLoading: boolean;
     theme: 'light' | 'dark' | 'system';
-    showLineNumbers: boolean;
     activePanel: string | null;
     translations: {
         pageTitle: string;
@@ -4024,7 +4077,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__default.JSX.Element;
+declare function TagSchemasPage({ schemas, isLoading, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): React__default.JSX.Element;
 
 /**
  * A cache-backed list in its real states.
@@ -4132,7 +4185,6 @@ interface ResourceComposePageProps {
     availableEntityTypes: string[];
     initialLocale: string;
     theme: 'light' | 'dark';
-    showLineNumbers: boolean;
     hoverDelayMs: number;
     activePanel: string | null;
     onSaveResource: (params: SaveResourceParams) => Promise<void>;
@@ -4194,7 +4246,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__default.JSX.Element;
+declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): React__default.JSX.Element;
 
 /**
  * Inline upload-progress affordance for the compose page.
@@ -4243,7 +4295,6 @@ interface ResourceDiscoveryPageProps {
     selectedEntityType: string;
     onSelectedEntityTypeChange: (entityType: string) => void;
     theme: 'light' | 'dark';
-    showLineNumbers: boolean;
     activePanel: string | null;
     onNavigateToResource: (resourceId: string) => void;
     onNavigateToCompose: () => void;
@@ -4269,7 +4320,7 @@ interface ResourceDiscoveryPageProps {
     };
     ToolbarPanels: React__default.ComponentType<any>;
 }
-declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, recentError, onRetryRecent, isSearching, searchQuery, onSearchQueryChange, selectedEntityType, onSelectedEntityTypeChange, theme, showLineNumbers, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): React__default.JSX.Element;
+declare function ResourceDiscoveryPage({ recentDocuments, searchDocuments, entityTypes, isLoadingRecent, recentError, onRetryRecent, isSearching, searchQuery, onSearchQueryChange, selectedEntityType, onSelectedEntityTypeChange, theme, activePanel, onNavigateToResource, onNavigateToCompose, translations: t, ToolbarPanels, }: ResourceDiscoveryPageProps): React__default.JSX.Element;
 
 /**
  * ResourceCard Component
@@ -4355,8 +4406,6 @@ interface ResourceViewerPageProps {
  * @subscribes yield:clone - Clone the current resource
  * @subscribes beckon:sparkle - Trigger sparkle animation
  * @subscribes mark:added - Annotation was created (sparkle)
- * @subscribes settings:theme-changed - UI theme changed
- * @subscribes settings:line-numbers-toggled - Line numbers display toggled
  * @subscribes browse:reference-navigate - Navigate to a referenced document
  * @subscribes browse:entity-type-clicked - Navigate filtered by entity type
  *
@@ -4534,5 +4583,5 @@ declare function useShellStateUnit(): ShellStateUnit;
  */
 declare function useObservable<T>(obs$: Observable<T> | null | undefined): T | undefined;
 
-export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, AdminExchangePage, AdminSecurityPage, AdminUsersPage, AnnotateToolbar, AnnotateView, AnnotationHistory, AnnotationOverlay, AnnotationProvider, AssessmentEntry, AssessmentPanel, AssistProgress, AssistSection, AssistShell, AsyncErrorBoundary, AuthErrorDisplay, BrowseView, Button, ButtonGroup, COMMON_PANELS, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, CommentEntry, CommentsPanel, ComposeLoadingState, EntityTagsPage, EntityTypeBadges, ErrorBoundary, ExportCard, Footer, HighlightEntry, HighlightPanel, HistoryEvent, ImageAnnotateRenderer, ImageBrowseRenderer, ImageURLSchema, ImageViewer, ImportCard, ImportProgress, JsonLdPanel, JsonLdView, KeyboardShortcutsHelpModal, LeftSidebar, LinkedDataPage, LiveRegionProvider, NavigationMenu, OAuthUserSchema, ObservableLink, PageLayout, PanelHeader, PdfAnnotateRenderer, PdfBrowseRenderer, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RESOURCE_PANELS, RecentDocumentsPage, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, ReferencesPanel, ResizeHandle, ResourceAnnotationsProvider, ResourceCard, ResourceComposePage, ResourceDiscoveryPage, ResourceErrorState, ResourceGenerateModal, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, ResourceTagsInline, ResourceViewer, ResourceViewerPage, SearchModal, SelectedTextDisplay, SemiontBranding, SemiontFavicon, SemiontProvider, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, SignInForm, SignUpForm, SimpleNavigation, SkipLinks, SortableResourceTab, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, TaggingPanel, TextAnnotateRenderer, TextBrowseRenderer, ThemeProvider, ToastContainer, ToastProvider, Toolbar, TranslationProvider, UnifiedAnnotationsPanel, UnifiedHeader, UploadProgressBar, UserMenuSkeleton, WebBrowserStorage, WelcomePage, annotatorKeyForMotivation, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createAdminSecurityStateUnit, createAdminUsersStateUnit, createComposePageStateUnit, createDiscoverStateUnit, createEntityTagsStateUnit, createExchangeStateUnit, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, defaultAnnotateRenderers, defaultBrowseRenderers, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, setPdfWorkerSrc, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKBDiscovery, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMediaToken, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePendingCreation, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceGather, useResourceLoader, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionEventSubscriptions, useSessionExpiry, useSessionStateUnit, useShellStateUnit, useStateUnit, useTheme, useToast, useToolbarPrefs, useTranslations };
+export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, AdminExchangePage, AdminSecurityPage, AdminUsersPage, AnnotateToolbar, AnnotateView, AnnotationHistory, AnnotationOverlay, AnnotationProvider, AssessmentEntry, AssessmentPanel, AssistProgress, AssistSection, AssistShell, AsyncErrorBoundary, AuthErrorDisplay, BrowseView, Button, ButtonGroup, COMMON_PANELS, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, CommentEntry, CommentsPanel, ComposeLoadingState, DownloadFileLink, EntityTagsPage, EntityTypeBadges, ErrorBoundary, ExportCard, Footer, HighlightEntry, HighlightPanel, HistoryEvent, ImageAnnotateRenderer, ImageBrowseRenderer, ImageURLSchema, ImageViewer, ImportCard, ImportProgress, JsonLdPanel, JsonLdView, KeyboardShortcutsHelpModal, LeftSidebar, LineNumbersProvider, LinkedDataPage, LiveRegionProvider, NavigationMenu, OAuthUserSchema, ObservableLink, PageLayout, PanelHeader, PdfAnnotateRenderer, PdfBrowseRenderer, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RESOURCE_PANELS, RecentDocumentsPage, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, ReferencesPanel, ResizeHandle, ResourceAnnotationsProvider, ResourceCard, ResourceComposePage, ResourceDiscoveryPage, ResourceErrorState, ResourceGenerateModal, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, ResourceTagsInline, ResourceViewer, ResourceViewerPage, SearchModal, SelectedTextDisplay, SemiontBranding, SemiontFavicon, SemiontProvider, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, SignInForm, SignUpForm, SimpleNavigation, SkipLinks, SortableResourceTab, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, TaggingPanel, TextAnnotateRenderer, TextBrowseRenderer, ThemeProvider, ToastContainer, ToastProvider, Toolbar, TranslationProvider, UnifiedAnnotationsPanel, UnifiedHeader, UploadProgressBar, UserMenuSkeleton, WebBrowserStorage, WelcomePage, annotatorKeyForMotivation, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createAdminSecurityStateUnit, createAdminUsersStateUnit, createComposePageStateUnit, createDiscoverStateUnit, createEntityTagsStateUnit, createExchangeStateUnit, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, defaultAnnotateRenderers, defaultBrowseRenderers, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, mediaUrl, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, setPdfWorkerSrc, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKBDiscovery, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMediaToken, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePendingCreation, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceGather, useResourceLoader, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionEventSubscriptions, useSessionExpiry, useSessionStateUnit, useShellStateUnit, useStateUnit, useTheme, useToast, useToolbarPrefs, useTranslations };
 export type { AdminDevOpsPageProps, AdminExchangePageProps, AdminExchangePageTranslations, AdminSecurityPageProps, AdminSecurityStateUnit, AdminUser, AdminUserStats, AdminUsersPageProps, AdminUsersStateUnit, AnnotateMediaRendererProps, AnnotateMediaRenderers, AnnotationConfig, AnnotationCreationHandler, AnnotationGroups, AnnotationHandlers, AnnotationManager, AnnotationProviderProps, AnnotationUIState, AnnotationsCollection, Annotator, AnnotatorKey, AssistProgressProps, AssistProgressTranslations, AssistShellProps, AuthErrorDisplayProps, AvailableLocale, BorderRadiusToken, BrowseMediaRenderers, ButtonGroupProps, ButtonProps, ClickAction, CloneData, CollapsibleResourceNavigationProps, ColorToken, ComposeLoadingStateProps, ComposeMode, ComposePageStateUnit, ComposeParams, CreateAnnotationParams, CreateConfig, DeleteAnnotationParams, DetectionConfig, DevOpsFeature, DiscoverStateUnit, DrawingMode, EntityTagsPageProps, EntityTagsStateUnit, ExchangeStateUnit, ExportCardProps, ExportCardTranslations, HoverEmitterProps, ImportCardProps, ImportCardTranslations, ImportPreview, ImportProgressProps, ImportProgressTranslations, KBDiscoveryOptions, KBDiscoveryResult, KeyboardShortcut, LinkComponentProps, LinkedDataPageProps, LinkedDataPageTranslations, MediaRendererProps, Motivation$7 as Motivation, NavigationItem, NavigationMenuHelper, NavigationProps, OAuthProvider, OAuthUser, ObservableLinkProps, OverlayAnnotation, PendingCreation, RecentDocumentsPageProps, ReferenceData, ReferenceHover, ReferenceWizardModalProps, ResolvedTheme, ResourceCardProps, ResourceComposePageProps, ResourceDiscoveryPageProps, ResourceErrorStateProps, ResourceGatherOptions, ResourceGenerateModalProps, ResourceGenerateModalTranslations, ResourceLoaderStateUnit, ResourceSearchModalProps, ResourceViewerPageProps, ResourceViewerPageStateUnit, RouteBuilder, SaveResourceParams$1 as SaveResourceParams, SearchModalProps, SelectionMotivation, SelectorType, SemiontProviderProps, SemiontResource$1 as SemiontResource, SessionStateUnit, ShadowToken, ShapeType, ShellStateUnit, ShellStateUnitOptions, SignInFormProps, SignUpFormProps, SimpleNavigationItem, SimpleNavigationProps, SortableResourceTabProps, SpacingToken, TagSchemasPageProps, TextSegment, TextSelection, Theme, ToastMessage, ToastType, ToolbarPanelType, ToolbarPart, ToolbarPrefs, TransitionToken, TranslationManager, TranslationProviderProps, TypographyToken, UICreateAnnotationParams, UploadProgressBarProps, UseMediaTokenResult, UseResourceContentResult, UseResourceGatherResult, UseResourceLoaderResult, WelcomePageProps, WelcomeStateUnit, WizardState };