@semiont/react-ui 0.5.1 → 0.5.3

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, EventMap, AnnotationId, StoredEventLike, ConnectionState, GatheredContext } from '@semiont/core';
+import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, EventMap, AnnotationId, StoredEventLike, ConnectionState, GatheredContext, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
 export { Annotation } from '@semiont/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
@@ -7,10 +7,8 @@ import { T as TranslationManager } from './TranslationManager-9Xj3MIWQ.mjs';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { ViewModel, SemiontBrowser, SessionStorage, SemiontSession, OpenResource, ImportPreview, CloneData, ReferenceData, ShellVM } from '@semiont/sdk';
-export { ActiveJob, AdminSecurityVM, AdminUsersVM, AnnotationGroups, BeckonVM, COMMON_PANELS, CloneData, ComposeMode, ComposePageVM, ComposeParams, DiscoverVM, EntityTagsVM, ExchangeVM, GatherVM, GenerateDocumentOptions, HOVER_DELAY_MS, HoverHandlers, ImportPreview, Job, JobAssignment, JobClaimAdapter, JobClaimAdapterOptions, JobQueueVM, MarkVM, MatchVM, PendingAnnotation, RESOURCE_PANELS, ReferenceData, ResourceLoaderVM, ResourceViewerPageVM, SaveResourceParams, SearchPipeline, SearchPipelineOptions, SearchState, SessionVM, ShellVM, ShellVMOptions, ToolbarPanelType, WelcomeVM, WizardState, YieldVM, createAdminSecurityVM, createAdminUsersVM, createBeckonVM, createComposePageVM, createDiscoverVM, createEntityTagsVM, createExchangeVM, createGatherVM, createHoverHandlers, createJobClaimAdapter, createJobQueueVM, createMarkVM, createMatchVM, createResourceLoaderVM, createResourceViewerPageVM, createSearchPipeline, createSessionVM, createShellVM, createWelcomeVM, createYieldVM } from '@semiont/sdk';
-import { TagSchema } from '@semiont/ontology';
-export { TAG_SCHEMAS, TagCategory, TagSchema, getAllTagSchemas, getSchemaCategory as getTagCategory, getTagSchema, getTagSchemasByDomain, isValidCategory } from '@semiont/ontology';
+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 { Observable } from 'rxjs';
 
 /**
@@ -139,7 +137,7 @@ interface DeleteAnnotationParams {
  * function useAnnotationManager(client: SemiontClient): AnnotationManager {
  *   return {
  *     markAnnotation: async (params) => {
- *       const result = await client.mark.annotation(params.rUri, {...});
+ *       const result = await client.mark.annotation({ target: { source: params.rUri, ... }, ... });
  *       return result.annotation;
  *     },
  *     deleteAnnotation: async (params) => {
@@ -558,7 +556,7 @@ declare const OAuthUserSchema: {
  */
 declare function sanitizeImageURL(url: string): string | null;
 
-declare function useViewModel<VM extends ViewModel>(factory: () => VM): VM;
+declare function useStateUnit<T extends StateUnit>(factory: () => T): T;
 
 /**
  * Creates a debounced version of a callback function
@@ -806,11 +804,15 @@ interface UseResourceContentResult {
 declare function useResourceContent(rUri: ResourceId, resource: ResourceDescriptor, enabled?: boolean): UseResourceContentResult;
 
 interface SemiontProviderProps {
-    /** Inject a specific browser (tests). Omit in production. */
+    /** Inject a fully-constructed browser (tests, embedded hosts that build their own). Omit to use the default. */
     browser?: SemiontBrowser;
+    /** Override the default `WebBrowserStorage`. Useful for non-browser hosts (Electron/Tauri filesystem-backed adapters). */
+    storage?: SessionStorage;
+    /** Override the default HTTP session factory. Useful for in-process or future non-HTTP transports. */
+    sessionFactory?: SessionFactory;
     children: ReactNode;
 }
-declare function SemiontProvider({ browser, children }: SemiontProviderProps): react_jsx_runtime.JSX.Element;
+declare function SemiontProvider({ browser, storage, sessionFactory, children }: SemiontProviderProps): react_jsx_runtime.JSX.Element;
 declare function useSemiont(): SemiontBrowser;
 
 /**
@@ -847,7 +849,7 @@ interface AnnotationProviderProps {
  * function useAnnotationManager(client: SemiontClient): AnnotationManager {
  *   return {
  *     markAnnotation: async (params) => {
- *       const result = await client.mark.annotation(params.rUri, {
+ *       const result = await client.mark.annotation({
  *         motivation: params.motivation,
  *         target: { source: params.rUri, selector: params.selector },
  *         body: params.body,
@@ -1351,10 +1353,10 @@ declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcu
 
 /**
  * Modal that surfaces when a 403 forbidden error is reported via
- * `notifyPermissionDenied` (called from QueryCache.onError).
+ * the active session's `signals.notifyPermissionDenied(...)`.
  *
  * Reads `permissionDeniedAt$` and `permissionDeniedMessage$` from the
- * active `FrontendSessionSignals`. The signals instance clears the
+ * active `SessionSignals`. The signals instance clears the
  * flag when the user dismisses the modal. Modal state lives on
  * signals (not the session itself) so headless sessions
  * (workers/CLIs) don't carry dead observables.
@@ -1362,11 +1364,11 @@ declare function KeyboardShortcutsHelpModal({ isOpen, onClose }: KeyboardShortcu
 declare function PermissionDeniedModal(): react_jsx_runtime.JSX.Element;
 
 /**
- * Modal that surfaces when the active KB's session expires (a 401 from
- * either the session's own JWT validation or from any React Query call
- * via the QueryCache.onError handler).
+ * Modal that surfaces when the active KB's session expires (a 401
+ * surfaced by the session's own JWT validation or by the host's
+ * error-routing path).
  *
- * Reads `sessionExpiredAt$` from the active `FrontendSessionSignals`.
+ * Reads `sessionExpiredAt$` from the active `SessionSignals`.
  * When the user dismisses the modal, the signals instance clears the
  * flag. Modal state lives on signals (not the session itself) so
  * headless sessions (workers/CLIs) don't carry dead observables.
@@ -1512,6 +1514,8 @@ interface AssessmentPanelProps {
     isAssisting?: boolean;
     progress?: JobProgress$6 | null;
     locale?: string;
+    /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
+    sourceLanguage?: string;
     annotateMode?: boolean;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
@@ -1524,12 +1528,12 @@ 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, 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_jsx_runtime.JSX.Element;
 
 interface Props$3 {
     /**
      * Connection state from `client.actor.state$`. See
-     * `packages/api-client/src/view-models/domain/actor-vm.ts`.
+     * `packages/api-client/src/state/domain/actor-state-unit.ts`.
      *
      * UI mapping:
      *   `open` | `reconnecting` | `initial` | `connecting`
@@ -1573,6 +1577,8 @@ interface CommentsPanelProps {
     isAssisting?: boolean;
     progress?: JobProgress$5 | null;
     locale?: string;
+    /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
+    sourceLanguage?: string;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
@@ -1584,13 +1590,16 @@ 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, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): react_jsx_runtime.JSX.Element;
+declare function CommentsPanel({ annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, sourceLanguage, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): react_jsx_runtime.JSX.Element;
 
 type JobProgress$4 = components['schemas']['JobProgress'];
 interface AssistSectionProps {
     annotationType: 'highlight' | 'assessment' | 'comment';
     isAssisting: boolean;
+    /** User UI locale — written into the annotation body's `language` field for comment/assessment. */
     locale?: string;
+    /** BCP-47 tag of the resource being analyzed. Forwarded to the prompt so the LLM analyzes non-English source correctly. */
+    sourceLanguage?: string;
     progress?: JobProgress$4 | null | undefined;
 }
 /**
@@ -1605,7 +1614,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, progress, }: AssistSectionProps): react_jsx_runtime.JSX.Element;
+declare function AssistSection({ annotationType, isAssisting, locale, sourceLanguage, progress, }: AssistSectionProps): react_jsx_runtime.JSX.Element;
 
 interface HighlightEntryProps {
     highlight: Annotation;
@@ -1630,6 +1639,8 @@ interface HighlightPanelProps {
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
+    /** BCP-47 tag of the resource being analyzed — forwarded to the assist call so the LLM analyzes non-English source correctly. */
+    sourceLanguage?: string;
 }
 /**
  * Panel for managing highlight annotations with auto-creation
@@ -1637,7 +1648,7 @@ 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, }: HighlightPanelProps): react_jsx_runtime.JSX.Element;
+declare function HighlightPanel({ annotations, pendingAnnotation, isAssisting, progress, annotateMode, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, sourceLanguage, }: HighlightPanelProps): react_jsx_runtime.JSX.Element;
 
 type SemiontResource$1 = components['schemas']['ResourceDescriptor'];
 interface Props$2 {
@@ -1691,6 +1702,10 @@ interface Props$1 {
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
+    /** User UI locale — stamped on the unresolved-reference body's `language` field. */
+    locale?: string;
+    /** BCP-47 tag of the resource being analyzed — fed into the prompt for source-aware analysis. */
+    sourceLanguage?: string;
 }
 /**
  * Panel for managing reference annotations with entity type annotation
@@ -1700,7 +1715,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, }: 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_jsx_runtime.JSX.Element;
 
 type Agent = components['schemas']['Agent'];
 interface Props {
@@ -1759,6 +1774,10 @@ interface TaggingPanelProps {
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
+    /** User UI locale — stamped on the tagging body's `language` field. */
+    locale?: string;
+    /** BCP-47 tag of the resource being analyzed — fed into the prompt for source-aware analysis. */
+    sourceLanguage?: string;
 }
 /**
  * Panel for managing tag annotations with schema-based annotation
@@ -1768,7 +1787,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, }: TaggingPanelProps): react_jsx_runtime.JSX.Element;
+declare function TaggingPanel({ annotations, annotateMode, isAssisting, progress, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: TaggingPanelProps): react_jsx_runtime.JSX.Element;
 
 type JobProgress = components['schemas']['JobProgress'];
 
@@ -1805,6 +1824,12 @@ interface UnifiedAnnotationsPanelProps {
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
     locale?: string;
+    /**
+     * BCP-47 tag of the resource being analyzed (source-resource locale).
+     * Independent from `locale` — a German user can analyze a French source
+     * and get German bodies back. Fed into detection prompts.
+     */
+    sourceLanguage?: string;
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
 }
@@ -2594,6 +2619,64 @@ interface ExportCardProps {
 }
 declare function ExportCard({ onExport, isExporting, translations: t }: ExportCardProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * ShellStateUnit — app-shell state: which toolbar panel is open, tab-bar
+ * coordination helpers, scroll-to-annotation signals. Lives on
+ * `SemiontBrowser`'s app-scoped bus (not the per-session client bus)
+ * because panel toggles and shell chrome must work regardless of
+ * whether a KB session is active.
+ *
+ * Channels: `panel:toggle`, `panel:open`, `panel:close`.
+ */
+
+type ToolbarPanelType = 'history' | 'info' | 'annotations' | 'settings' | 'collaboration' | 'user' | 'jsonld' | 'knowledge-base';
+declare const COMMON_PANELS: readonly ToolbarPanelType[];
+declare const RESOURCE_PANELS: readonly ToolbarPanelType[];
+interface ShellStateUnit extends StateUnit {
+    activePanel$: Observable<ToolbarPanelType | null>;
+    scrollToAnnotationId$: Observable<string | null>;
+    panelInitialTab$: Observable<{
+        tab: string;
+        generation: number;
+    } | null>;
+    openPanel(panel: string): void;
+    closePanel(): void;
+    togglePanel(panel: string): void;
+    onScrollCompleted(): void;
+}
+interface ShellStateUnitOptions {
+    initialPanel?: ToolbarPanelType | null;
+    onPanelChange?: (panel: ToolbarPanelType | null) => void;
+}
+declare function createShellStateUnit(browser: SemiontBrowser, options?: ShellStateUnitOptions): ShellStateUnit;
+
+interface ImportPreview {
+    format: string;
+    version: number;
+    sourceUrl: string;
+    stats: Record<string, number>;
+}
+interface ExchangeStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    selectedFile$: Observable<File | null>;
+    preview$: Observable<ImportPreview | null>;
+    importPhase$: Observable<string | null>;
+    importMessage$: Observable<string | undefined>;
+    importResult$: Observable<Record<string, unknown> | undefined>;
+    isExporting$: Observable<boolean>;
+    isImporting$: Observable<boolean>;
+    selectFile(file: File): void;
+    cancelImport(): void;
+    doExport(): Promise<{
+        blob: Blob;
+        filename: string;
+    }>;
+    doImport(): Promise<void>;
+}
+declare function createExchangeStateUnit(browse: ShellStateUnit, exportFn: (params?: {
+    includeArchived?: boolean;
+}) => Promise<BackendDownload>, importFn: (file: File) => Observable<ProgressEvent>): ExchangeStateUnit;
+
 interface ImportCardTranslations {
     title: string;
     description: string;
@@ -3063,6 +3146,59 @@ interface TagSchemasPageProps {
 }
 declare function TagSchemasPage({ schemas, isLoading, theme, showLineNumbers, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): react_jsx_runtime.JSX.Element;
 
+type ComposeMode = 'new' | 'clone' | 'reference';
+interface ComposeParams {
+    mode?: string | undefined;
+    token?: string | undefined;
+    annotationUri?: string | undefined;
+    sourceDocumentId?: string | undefined;
+    name?: string | undefined;
+    entityTypes?: string | undefined;
+    storedContext?: string | undefined;
+}
+interface CloneData {
+    sourceResource: ResourceDescriptor;
+    sourceContent: string;
+}
+interface ReferenceData {
+    annotationUri: string;
+    sourceDocumentId: string;
+    name: string;
+    entityTypes: string[];
+}
+interface SaveResourceParams$1 {
+    mode: ComposeMode;
+    name: string;
+    storageUri: string;
+    content?: string;
+    file?: File;
+    format?: string;
+    charset?: string;
+    entityTypes?: string[];
+    language: string;
+    archiveOriginal?: boolean;
+    annotationUri?: string;
+    sourceDocumentId?: string;
+}
+interface ComposePageStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    mode$: Observable<ComposeMode>;
+    loading$: Observable<boolean>;
+    cloneData$: Observable<CloneData | null>;
+    referenceData$: Observable<ReferenceData | null>;
+    gatheredContext$: Observable<GatheredContext | null>;
+    entityTypes$: Observable<string[]>;
+    /**
+     * Live upload-progress for the in-flight `save(...)` call. Emits the
+     * full `UploadProgress` lifecycle (started → finished) while a save is
+     * underway; resets to `null` between saves and after completion. UI
+     * components can subscribe to render an upload-in-progress indicator.
+     */
+    uploadProgress$: Observable<UploadProgress | null>;
+    save(params: SaveResourceParams$1): Promise<string>;
+}
+declare function createComposePageStateUnit(client: SemiontClient, browse: ShellStateUnit, params: ComposeParams, auth?: AccessToken): ComposePageStateUnit;
+
 interface ResourceComposePageProps {
     mode: 'new' | 'clone' | 'reference';
     cloneData?: CloneData | null;
@@ -3076,6 +3212,13 @@ interface ResourceComposePageProps {
     activePanel: string | null;
     onSaveResource: (params: SaveResourceParams) => Promise<void>;
     onCancel: () => void;
+    /**
+     * Live upload-progress for the in-flight save. Resolved by the route
+     * shell from `composeVM.uploadProgress$`. `null` between saves and
+     * after completion. When non-null, the form disables Save and the
+     * inline `<UploadProgressBar />` below the action buttons renders.
+     */
+    uploadProgress?: UploadProgress | null;
     translations: {
         title: string;
         titleEditClone: string;
@@ -3126,7 +3269,29 @@ interface SaveResourceParams {
     annotationUri?: string;
     sourceDocumentId?: string;
 }
-declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, showLineNumbers, hoverDelayMs, activePanel, onSaveResource, onCancel, 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_jsx_runtime.JSX.Element;
+
+/**
+ * Inline upload-progress affordance for the compose page.
+ *
+ * Subscribes (via prop) to a `UploadProgress | null` value derived from
+ * `composeVM.uploadProgress$`. Renders nothing when null; renders an
+ * indeterminate state on `started`; renders a labeled bar with byte
+ * counts on `progress`; renders a brief "Uploaded" success state on
+ * `finished` (cleared by the state unit's `null` push on complete).
+ *
+ * Designed to live below the Save button in the compose form so the
+ * visual association with the action that triggered the upload is
+ * direct. Uses the existing `.semiont-progress` styles in
+ * `packages/react-ui/src/styles/core/progress.css`.
+ */
+
+interface UploadProgressBarProps {
+    progress: UploadProgress | null;
+    /** Optional label for the "starting" / "uploaded" lines. Defaults to "Upload". */
+    label?: string;
+}
+declare function UploadProgressBar({ progress, label }: UploadProgressBarProps): React__default.ReactElement | null;
 
 interface ResourceDiscoveryPageProps {
     recentDocuments: ResourceDescriptor[];
@@ -3248,13 +3413,113 @@ interface HoverEmitterProps {
 }
 declare function useHoverEmitter(annotationId: AnnotationId, hoverDelayMs?: number): HoverEmitterProps;
 
+interface SessionStateUnit extends StateUnit {
+    isLoggingOut$: Observable<boolean>;
+    logout(): Promise<void>;
+}
+declare function createSessionStateUnit(client: SemiontClient): SessionStateUnit;
+
+interface AnnotationGroups {
+    highlights: Annotation[];
+    comments: Annotation[];
+    assessments: Annotation[];
+    references: Annotation[];
+    tags: Annotation[];
+}
+type StoredEventResponse = components['schemas']['StoredEventResponse'];
+interface WizardState {
+    open: boolean;
+    annotationId: string | null;
+    resourceId: string | null;
+    defaultTitle: string;
+    entityTypes: string[];
+}
+interface ResourceViewerPageStateUnit extends StateUnit {
+    beckon: BeckonStateUnit;
+    browse: ShellStateUnit;
+    mark: MarkStateUnit;
+    gather: GatherStateUnit;
+    yield: YieldStateUnit;
+    annotations$: Observable<Annotation[]>;
+    annotationGroups$: Observable<AnnotationGroups>;
+    entityTypes$: Observable<string[]>;
+    events$: Observable<StoredEventResponse[]>;
+    referencedBy$: Observable<ReferencedByEntry[]>;
+    content$: Observable<string>;
+    contentLoading$: Observable<boolean>;
+    mediaToken$: Observable<string | null>;
+    wizard$: Observable<WizardState>;
+    closeWizard(): void;
+}
+declare function createResourceViewerPageStateUnit(client: SemiontClient, resourceId: ResourceId, locale: string, browse: ShellStateUnit, options?: {
+    mediaType?: string;
+}): ResourceViewerPageStateUnit;
+
+interface ResourceLoaderStateUnit extends StateUnit {
+    resource$: Observable<ResourceDescriptor | undefined>;
+    isLoading$: Observable<boolean>;
+    invalidate(): void;
+}
+declare function createResourceLoaderStateUnit(client: SemiontClient, resourceId: ResourceId): ResourceLoaderStateUnit;
+
+interface AdminUsersStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    users$: Observable<unknown[]>;
+    stats$: Observable<unknown | null>;
+    usersLoading$: Observable<boolean>;
+    statsLoading$: Observable<boolean>;
+    updateUser(id: string, data: {
+        isAdmin?: boolean;
+        isActive?: boolean;
+    }): Promise<void>;
+}
+declare function createAdminUsersStateUnit(client: SemiontClient, browse: ShellStateUnit): AdminUsersStateUnit;
+
+interface AdminSecurityStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    providers$: Observable<unknown[]>;
+    allowedDomains$: Observable<string[]>;
+    isLoading$: Observable<boolean>;
+}
+declare function createAdminSecurityStateUnit(client: SemiontClient, browse: ShellStateUnit): AdminSecurityStateUnit;
+
+interface WelcomeStateUnit extends StateUnit {
+    userData$: Observable<{
+        termsAcceptedAt?: string;
+    } | null>;
+    isProcessing$: Observable<boolean>;
+    acceptTerms(): Promise<void>;
+}
+declare function createWelcomeStateUnit(client: SemiontClient): WelcomeStateUnit;
+
+interface DiscoverStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    search: SearchPipeline<ResourceDescriptor>;
+    recentResources$: Observable<ResourceDescriptor[]>;
+    entityTypes$: Observable<string[]>;
+    isLoadingRecent$: Observable<boolean>;
+}
+declare function createDiscoverStateUnit(client: SemiontClient, browse: ShellStateUnit): DiscoverStateUnit;
+
+interface EntityTagsStateUnit extends StateUnit {
+    browse: ShellStateUnit;
+    entityTypes$: Observable<string[]>;
+    isLoading$: Observable<boolean>;
+    newTag$: Observable<string>;
+    error$: Observable<string>;
+    isAdding$: Observable<boolean>;
+    setNewTag(value: string): void;
+    addTag(): Promise<void>;
+}
+declare function createEntityTagsStateUnit(client: SemiontClient, browse: ShellStateUnit): EntityTagsStateUnit;
+
 /**
- * `ShellVM` is app-scoped — it owns toolbar panel state and lives on
+ * `ShellStateUnit` is app-scoped — it owns toolbar panel state and lives on
  * the `SemiontBrowser`'s own bus. Unlike session-scoped VMs, this hook
  * does not need to wait for an active KB session; `useSemiont()`
  * always returns the module-scoped `SemiontBrowser` singleton.
  */
-declare function useShellVM(): ShellVM;
+declare function useShellStateUnit(): ShellStateUnit;
 
 /**
  * Subscribe to an RxJS Observable and return its current value as React state.
@@ -3278,4 +3543,4 @@ declare function useShellVM(): ShellVM;
  */
 declare function useObservable<T>(obs$: Observable<T> | null | undefined): T | undefined;
 
-export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AvailableLocale, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, type OverlayAnnotation, PageLayout, PanelHeader, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, SemiontProvider, type SemiontProviderProps, type SemiontResource$2 as SemiontResource, SessionExpiredModal, SessionExpiryBanner, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WebBrowserStorage, WelcomePage, type WelcomePageProps, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, cssVariables, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionExpiry, useShellVM, useTheme, useToast, useTranslations, useViewModel };
+export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminSecurityStateUnit, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, type AdminUsersStateUnit, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationGroups, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AvailableLocale, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMMON_PANELS, type ClickAction, type CloneData, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ComposeMode, type ComposePageStateUnit, type ComposeParams, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DiscoverStateUnit, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, type EntityTagsStateUnit, EntityTypeBadges, ErrorBoundary, type ExchangeStateUnit, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, type ImportPreview, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, type OverlayAnnotation, PageLayout, PanelHeader, PermissionDeniedModal, PopupContainer, PopupHeader, ProtectedErrorBoundary, RESOURCE_PANELS, RecentDocumentsPage, type RecentDocumentsPageProps, type ReferenceData, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, type ResourceLoaderStateUnit, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type ResourceViewerPageStateUnit, type RouteBuilder, type SaveResourceParams$1 as SaveResourceParams, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, SemiontProvider, type SemiontProviderProps, type SemiontResource$2 as SemiontResource, SessionExpiredModal, SessionExpiryBanner, type SessionStateUnit, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, type ShellStateUnit, type ShellStateUnitOptions, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, UploadProgressBar, type UploadProgressBarProps, type UseResourceContentResult, UserMenuSkeleton, WebBrowserStorage, WelcomePage, type WelcomePageProps, type WelcomeStateUnit, type WizardState, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createAdminSecurityStateUnit, createAdminUsersStateUnit, createComposePageStateUnit, createDiscoverStateUnit, createEntityTagsStateUnit, createExchangeStateUnit, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useObservable, useObservableExternalNavigation, useObservableRouter, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionExpiry, useShellStateUnit, useStateUnit, useTheme, useToast, useTranslations };