@semiont/react-ui 0.5.28 → 0.5.30

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import * as _semiont_react_ui from '@semiont/react-ui';
 import { BrowseMediaRenderers as BrowseMediaRenderers$1, AnnotateMediaRenderers as AnnotateMediaRenderers$1 } from '@semiont/react-ui';
-import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, StateUnit, CollaboratorEntry, EventMap, DiscoveredKB, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, GatheredContext, BackendDownload, ProgressEvent, AccessToken } from '@semiont/core';
+import { Annotation, ResourceId, Selector, components, ResourceDescriptor, ValidationResult, StateUnit, CollaboratorEntry, EventMap, DiscoveredKB, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, GatheredContext, 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, MouseEvent, Ref } from 'react';
 import * as _codemirror_state from '@codemirror/state';
 import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
-import { SemiontClient, SemiontSession, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, YieldOutcome, OpenResource, ResourceGatherOptions, 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 { SemiontClient, SemiontSession, DiscoveryTransport, DiscoveryState, SemiontBrowser, SessionStorage, SessionFactory, YieldOutcome, OpenResource, GenerationOptions, ResourceGatherOptions, TagSchema, UploadProgress, BeckonStateUnit, MarkStateUnit, GatherStateUnit, YieldStateUnit, ReferencedByEntry } from '@semiont/sdk';
+export { BeckonStateUnit, GatherStateUnit, GenerationOptions, 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';
 
 /**
@@ -558,12 +558,13 @@ type SelectorType = 'fragment' | 'svg' | 'text';
  * This set is the host-facing CONTRACT for "which shapes can this medium
  * draw" — gate shape UI on it directly.
  *
- * PDF: only rectangles (FragmentSelector with RFC 3778 viewrect).
- * Images: all shapes (SvgSelector supports rect, circle, polygon).
- * Everything else — including text media and absent/unknown types — supports
- * NONE: those anchor by character offsets (TextPositionSelector /
- * TextQuoteSelector), and no selector can carry a shape. Mirrors
- * `getSelectorType`'s 'text' fallback.
+ * The registry's anchoring model decides, never the type name: a spatially
+ * anchored medium draws what its renderer can carry — rectangles only for
+ * PDF (FragmentSelector, RFC 3778 viewrect; circle and polygon would need an
+ * SvgSelector, which loses page context), all three for images (SvgSelector).
+ * Everything else draws nothing — text media anchor by character offsets and
+ * no selector there can carry a shape, and storage-tier rows are not
+ * annotated at all.
  *
  * @param mediaType - MIME type of the resource (e.g., 'application/pdf', 'image/png')
  * @returns Array of supported shape types for annotation
@@ -578,7 +579,17 @@ declare function getSupportedShapes(mediaType: string | undefined | null): Shape
  */
 declare function isShapeSupported(mediaType: string | undefined | null, shape: ShapeType): boolean;
 /**
- * Get the selector type used for a given media type
+ * Get the selector type used for a given media type.
+ *
+ * Keyed off the registry's anchoring model, in step with
+ * `getSupportedShapes`: spatial + PDF render → FragmentSelector (RFC 3778),
+ * spatial + image render → SvgSelector.
+ *
+ * Everything else answers 'text' — text media because they genuinely anchor
+ * by character offset, storage-tier rows and registry misses because
+ * `SelectorType` has no "not annotatable" member. That catch-all is harmless
+ * rather than a claim: `getSupportedShapes` offers those types no shapes, and
+ * the write path refuses them outright (MEDIA-CAPABILITY-DISPATCH D6).
  *
  * @param mediaType - MIME type of the resource
  * @returns Selector type (fragment, svg, or text)
@@ -612,7 +623,7 @@ declare function saveSelectedShapeForSelectorType(selectorType: SelectorType, sh
  *   `<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.
+ *   origin, so a relative path resolves against the HOST, not the gateway.
  *
  * 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;
@@ -627,11 +638,23 @@ declare function mediaUrl(client: SemiontClient | null | undefined, id: Resource
  * (which forces O(ASTnodes × annotations) work on every render), this module:
  *
  * 1. Builds a source→rendered offset map once after the markdown DOM paints
- * 2. Resolves W3C TextPositionSelector offsets to DOM Ranges via binary search
- * 3. Wraps matched ranges with <span> elements carrying data-annotation-* attributes
+ * 2. Resolves W3C TextPositionSelector offsets to rendered-text offset spans
+ * 3. Rebuilds each annotated text node ONCE, off-DOM, into segments wrapped by
+ *    <span> elements carrying data-annotation-* attributes
  *
  * Markdown renders once (cached by React.memo). Annotation changes only touch
  * the overlay spans — no markdown re-parse, no AST walk.
+ *
+ * The application step deliberately never uses live DOM Ranges. A previous
+ * implementation resolved every annotation to a Range up front and then wrapped
+ * them one `surroundContents` at a time. Each wrap is a DOM mutation, and DOM
+ * mutations re-target every OTHER still-live Range: overlapping annotations —
+ * the normal result of repeated annotation on the same passage — had their
+ * ranges collapsed or inflated by earlier wraps, painting whole paragraphs and
+ * fragmenting text nodes so hard that 36 annotations produced 2,554 wraps and
+ * a 10-second main-thread freeze (measured 2026-08-28, e2e specs 08/09).
+ * Working in offset space against the pristine text-node index makes overlap
+ * geometry exact, and costs one `replaceChild` per annotated text node.
  */
 
 interface OverlayAnnotation {
@@ -647,6 +670,12 @@ interface TextNodeEntry {
     start: number;
     end: number;
 }
+/** An annotation resolved to rendered-text offsets: `[start, end)`. */
+interface ResolvedAnnotationSpan {
+    annotation: OverlayAnnotation;
+    start: number;
+    end: number;
+}
 /**
  * Build a map from markdown source offsets to rendered text offsets.
  * Character-by-character alignment: walks source and rendered text in parallel,
@@ -656,32 +685,37 @@ interface TextNodeEntry {
  */
 declare function buildSourceToRenderedMap(markdownSource: string, container: HTMLElement): Map<number, number>;
 /**
- * Build a sorted array of text nodes with cumulative rendered offsets
- * for efficient offset→node lookups via binary search.
+ * Build a sorted array of text nodes with cumulative rendered offsets.
  *
  * Complexity: O(textNodes) — runs once per overlay application.
  */
 declare function buildTextNodeIndex(container: HTMLElement): TextNodeEntry[];
 /**
- * Resolve annotations to DOM Ranges using the cached offset map.
+ * Resolve annotations to rendered-text offset spans using the cached offset
+ * map. Annotations whose offsets don't map (content changed under them) are
+ * skipped, as are empty ones.
  *
- * Complexity: O(annotations × log(textNodes)).
+ * Complexity: O(annotations).
  */
-declare function resolveAnnotationRanges(annotations: OverlayAnnotation[], offsetMap: Map<number, number>, textNodeIndex: TextNodeEntry[]): Map<string, {
-    range: Range;
-    annotation: OverlayAnnotation;
-}>;
+declare function resolveAnnotationSpans(annotations: OverlayAnnotation[], offsetMap: Map<number, number>): ResolvedAnnotationSpan[];
 /**
- * Wrap annotation Ranges with styled <span> elements.
- * Handles cross-element ranges by splitting into per-text-node segments.
+ * Wrap annotated stretches of text with styled <span> elements.
+ *
+ * Each text node the spans touch is rebuilt off-DOM as a run of segments —
+ * one per distinct overlap region — and swapped in with a single
+ * `replaceChild`. A segment covered by several annotations gets nested spans,
+ * one per annotation; the later annotation in the input order ends up
+ * innermost, so `closest('[data-annotation-id]')` resolves to it (interactive
+ * types — references, comments, tags — are listed after plain highlights).
+ * An annotation cut by segment or node boundaries yields sibling spans
+ * sharing its data-annotation-id, as the Range-based predecessor also did.
+ *
+ * Complexity: O(textNodes × spans) comparisons, O(annotated nodes) mutations.
  */
-declare function applyHighlights(ranges: Map<string, {
-    range: Range;
-    annotation: OverlayAnnotation;
-}>): void;
+declare function applyHighlights(spans: ResolvedAnnotationSpan[], textNodeIndex: TextNodeEntry[]): void;
 /**
  * Remove all annotation highlight spans, restoring the original DOM.
- * Unwraps spans and merges adjacent text nodes.
+ * Unwraps every span, then merges adjacent text nodes in one pass.
  */
 declare function clearHighlights(container: HTMLElement): void;
 /**
@@ -729,7 +763,7 @@ declare function supportsDetection(mediaType: string | undefined): boolean;
  * The worker can't be resolved inside this tsup-built library (Vite's `?url`
  * lives in the app), so the host hands us the worker URL via `setPdfWorkerSrc`
  * once at startup; it is applied to `GlobalWorkerOptions` when pdf.js loads.
- * See `apps/frontend/src/main.tsx`.
+ * See `apps/browser/src/main.tsx`.
  */
 
 /**
@@ -1117,7 +1151,7 @@ interface UseCollaboratorsResult {
  *
  * SUBSCRIBES rather than fetching once. `browse.agents()` is a `CacheObservable`
  * whose only refresh triggers are `bus:resume-gap` and an explicit `fresh()` —
- * a backend restart with a changed roster necessarily presents as an SSE gap, so
+ * a gateway restart with a changed roster necessarily presents as an SSE gap, so
  * a one-shot read would pin the UI to a roster that no longer exists. Awaiting
  * it instead would also force a network round trip on every mount, which is
  * exactly what the cache exists to avoid.
@@ -2119,7 +2153,7 @@ declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, reso
 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 for that resource — its client mints the media token and supplies the gateway origin. */
     session: SemiontSession | null;
 }
 /**
@@ -2909,15 +2943,38 @@ interface SimpleNavigationProps {
     dropdownContent?: ((onClose: () => void) => ReactNode) | undefined;
 }
 
-interface GenerationConfig {
-    title: string;
-    storagePath: string;
-    prompt?: string;
-    language: string;
-    temperature: number;
-    maxTokens: number;
+/**
+ * What this form fills in. Named here, but TYPED by the SDK (P2b).
+ *
+ * `storageUri` is on this list rather than a local `storagePath: string`
+ * because the two were the same thing under different names — a divergence
+ * that survived precisely because nothing tied them together (D8).
+ */
+type FormFilled = 'title' | 'storageUri' | 'language' | 'temperature' | 'maxTokens' | 'outputMediaType';
+/**
+ * The submitted payload: the SDK's own generation options, DERIVED rather
+ * than restated (P2b), plus the grounding context.
+ *
+ * This was a hand-written interface listing the same fields with independent
+ * types — the shape `## Duplicated Shape` forbids — and it drifted exactly as
+ * predicted: `storagePath: string` held a `storageUri`, so every consumer
+ * re-mapped it by hand and silently dropped whatever the mapping forgot.
+ * Deriving means a rename or retype in `GenerationOptions` is a compile
+ * error here instead of a quiet gap at the wire.
+ *
+ * NARROWED on purpose: the SDK also carries `task`, `structure`, `cite` and
+ * `stallDeadlineMs`, which this form does not collect, and a payload type
+ * that advertised them would promise more than the UI delivers. Surfacing one
+ * later is a one-word edit to `FormFilled` plus its control — the door is
+ * unlocked, not open.
+ *
+ * `Required` because the form always fills these, even where the SDK lets
+ * them be absent; `prompt` stays optional, because a blank instruction field
+ * is omitted rather than sent empty.
+ */
+type GenerationConfig = Required<Pick<GenerationOptions, FormFilled>> & Pick<GenerationOptions, 'prompt'> & {
     context: GatheredContext;
-}
+};
 
 interface ComposeParams$1 {
     name: string;
@@ -2943,6 +3000,8 @@ interface ReferenceWizardModalProps {
     resourceId: string | null;
     /** Default title (selected text) */
     defaultTitle: string;
+    /** Folder of the source resource, so new files land beside it (D11). */
+    defaultFolder?: string;
     /** Entity types from the annotation */
     entityTypes: string[];
     /**
@@ -3012,6 +3071,8 @@ interface ReferenceWizardModalProps {
         maxLength: string;
         maxLengthHelp: string;
         maxLengthCeiling: string;
+        outputFormat: string;
+        formatExtensionMismatch: string;
         maxResults: string;
         semanticScoring: string;
         semanticScoringHelp: string;
@@ -3025,7 +3086,7 @@ interface ReferenceWizardModalProps {
         keepEditing: string;
     };
 }
-declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, resourceName, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeSubmit, entityTypeOptions, hoverDelayMs, translations: t, generationAgent, }: ReferenceWizardModalProps): React$1.JSX.Element;
+declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, defaultFolder, entityTypes, resourceName, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeSubmit, entityTypeOptions, hoverDelayMs, translations: t, generationAgent, }: ReferenceWizardModalProps): React$1.JSX.Element;
 
 interface ResourceGenerateModalTranslations {
     /** The ONE modal title — names the flow, not a step. */
@@ -3066,6 +3127,8 @@ interface ResourceGenerateModalTranslations {
     maxLength: string;
     maxLengthHelp: string;
     maxLengthCeiling: string;
+    outputFormat: string;
+    formatExtensionMismatch: string;
     generate: string;
     discardDraftPrompt: string;
     discardDraft: string;
@@ -3082,6 +3145,8 @@ interface ResourceGenerateModalProps {
     onClose: () => void;
     resourceId: string;
     defaultTitle: string;
+    /** Folder of the source resource, so the artifact lands beside it (D11). */
+    defaultFolder?: string;
     locale: string;
     /**
      * Entity types offered in the exclusion picker. Owner-supplied so the
@@ -3122,7 +3187,7 @@ interface ResourceGenerateModalProps {
  * zone]: the same grammar the resolve wizard expresses, whose gather zone
  * happens to be automatic and whose act zone has a strategy choice.
  */
-declare function ResourceGenerateModal({ isOpen, onClose, resourceId, defaultTitle, locale, entityTypeOptions, onGenerateSubmit, gatherContext, gatherLoading, gatherError, onGather, translations: t, generationAgent, }: ResourceGenerateModalProps): React$1.JSX.Element;
+declare function ResourceGenerateModal({ isOpen, onClose, resourceId, defaultTitle, defaultFolder, locale, entityTypeOptions, onGenerateSubmit, gatherContext, gatherLoading, gatherError, onGather, translations: t, generationAgent, }: ResourceGenerateModalProps): React$1.JSX.Element;
 
 interface SearchModalProps$1 {
     isOpen: boolean;
@@ -3186,9 +3251,9 @@ declare function SkipLinks(): React$1.JSX.Element;
 interface StatusDisplayProps {
     isFullyAuthenticated?: boolean;
     isAuthenticated?: boolean;
-    hasValidBackendToken?: boolean;
+    hasValidGatewayToken?: boolean;
 }
-declare function StatusDisplay({ isFullyAuthenticated, isAuthenticated, hasValidBackendToken }: StatusDisplayProps): React$1.JSX.Element;
+declare function StatusDisplay({ isFullyAuthenticated, isAuthenticated, hasValidGatewayToken }: StatusDisplayProps): React$1.JSX.Element;
 
 declare function SessionTimer(): React$1.JSX.Element | null;
 
@@ -3590,168 +3655,6 @@ interface AdminDevOpsPageProps {
 }
 declare function AdminDevOpsPage({ suggestedFeatures, theme, activePanel, translations: t, StatusDisplay, ToolbarPanels, Toolbar, }: AdminDevOpsPageProps): React__default.JSX.Element;
 
-/**
- * ExportCard — Backup trigger
- *
- * Pure React component. All state and handlers passed as props.
- */
-interface ExportCardTranslations {
-    title: string;
-    description: string;
-    exportButton: string;
-    exporting: string;
-}
-interface ExportCardProps {
-    onExport: () => void;
-    isExporting: boolean;
-    translations: ExportCardTranslations;
-}
-declare function ExportCard({ onExport, isExporting, translations: t }: ExportCardProps): React$1.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: AnnotatorKey;
-        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;
-
-/**
- * ImportCard — File drop zone, preview, and import trigger
- *
- * Pure React component. All state and handlers passed as props.
- */
-
-interface ImportCardTranslations {
-    title: string;
-    description: string;
-    dropzoneLabel: string;
-    dropzoneActive: string;
-    detectedFormat: string;
-    statsPreview: string;
-    importButton: string;
-    importing: string;
-    importConfirmTitle: string;
-    importConfirmMessage: string;
-    confirmImport: string;
-    cancelImport: string;
-}
-interface ImportCardProps {
-    onFileSelected: (file: File) => void;
-    onImport: () => void;
-    onCancel: () => void;
-    selectedFile: File | null;
-    preview: ImportPreview | null;
-    isImporting: boolean;
-    translations: ImportCardTranslations;
-}
-declare function ImportCard({ onFileSelected, onImport, onCancel, selectedFile, preview, isImporting, translations: t, }: ImportCardProps): React__default.JSX.Element;
-
-/**
- * ImportProgress — Shows SSE-driven progress during restore
- *
- * Pure React component. All state passed as props.
- */
-interface ImportProgressTranslations {
-    phaseStarted: string;
-    phaseComplete: string;
-    phaseError: string;
-    statsEventsReplayed: string;
-    statsResourcesCreated: string;
-    statsAnnotationsCreated: string;
-    statsEntityTypesAdded: string;
-}
-interface ImportProgressProps {
-    phase: string;
-    message?: string;
-    result?: Record<string, unknown>;
-    translations: ImportProgressTranslations;
-}
-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;
-    subtitle: string;
-    export: ExportCardTranslations;
-    import: ImportCardTranslations;
-    progress: ImportProgressTranslations;
-}
-interface AdminExchangePageProps {
-    onExport: () => void;
-    isExporting: boolean;
-    onFileSelected: (file: File) => void;
-    onImport: () => void;
-    onCancelImport: () => void;
-    selectedFile: File | null;
-    preview: ImportCardProps['preview'];
-    isImporting: boolean;
-    importPhase: string | null;
-    importMessage?: string | undefined;
-    importResult?: Record<string, unknown> | undefined;
-    theme: 'light' | 'dark' | 'system';
-    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, activePanel, translations: t, ToolbarPanels, Toolbar, }: AdminExchangePageProps): React__default.JSX.Element;
-
 /**
  * AdminSecurityPage Component
  *
@@ -3793,40 +3696,6 @@ interface AdminSecurityPageProps {
 }
 declare function AdminSecurityPage({ providers, allowedDomains, isLoading, theme, 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;
-    subtitle: string;
-    export: ExportCardTranslations;
-    import: ImportCardTranslations;
-    progress: ImportProgressTranslations;
-}
-interface LinkedDataPageProps {
-    onExport: () => void;
-    isExporting: boolean;
-    onFileSelected: (file: File) => void;
-    onImport: () => void;
-    onCancelImport: () => void;
-    selectedFile: File | null;
-    preview: ImportCardProps['preview'];
-    isImporting: boolean;
-    importPhase: string | null;
-    importMessage?: string | undefined;
-    importResult?: Record<string, unknown> | undefined;
-    theme: 'light' | 'dark' | 'system';
-    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, activePanel, translations: t, ToolbarPanels, Toolbar, }: LinkedDataPageProps): React__default.JSX.Element;
-
 /**
  * AdminUsersPage Component
  *
@@ -3920,26 +3789,26 @@ declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingSta
  * 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.
+ * When gatewayUrl is provided it is shown as a locked read-only field.
+ * When gatewayUrl is omitted the user must enter a gateway URL to connect to.
  */
 
 interface SignInFormProps {
     /**
      * Callback when user clicks Google sign-in.
-     * Receives the backend URL (either the locked one or what the user typed).
+     * Receives the gateway URL (either the locked one or what the user typed).
      */
-    onGoogleSignIn: (backendUrl: string) => Promise<void>;
+    onGoogleSignIn: (gatewayUrl: string) => Promise<void>;
     /**
      * Callback when user submits email/password credentials.
-     * Receives the backend URL along with email and password.
+     * Receives the gateway URL along with email and password.
      */
-    onCredentialsSignIn?: ((backendUrl: string, email: string, password: string) => Promise<void>) | undefined;
+    onCredentialsSignIn?: ((gatewayUrl: string, email: string, password: string) => Promise<void>) | undefined;
     /**
-     * Pre-filled backend URL. When provided the field is read-only (re-auth to known workspace).
+     * Pre-filled gateway URL. When provided the field is read-only (re-auth to known workspace).
      * When omitted the user enters the URL themselves (new connection).
      */
-    backendUrl?: string;
+    gatewayUrl?: string;
     /**
      * Error message to display (if any)
      */
@@ -3964,8 +3833,8 @@ interface SignInFormProps {
         welcomeBack: string;
         signInPrompt: string;
         continueWithGoogle: string;
-        backendUrlLabel: string;
-        backendUrlPlaceholder: string;
+        gatewayUrlLabel: string;
+        gatewayUrlPlaceholder: string;
         emailLabel: string;
         emailPlaceholder: string;
         passwordLabel: string;
@@ -3977,9 +3846,9 @@ interface SignInFormProps {
         backToHome: string;
         learnMore: string;
         signUpInstead: string;
-        errorBackendUrlRequired: string;
-        errorBackendUrlInvalid: string;
-        errorBackendUrlUnreachable: string;
+        errorGatewayUrlRequired: string;
+        errorGatewayUrlInvalid: string;
+        errorGatewayUrlUnreachable: string;
         errorEmailRequired: string;
         errorPasswordRequired: string;
         tagline: string;
@@ -3988,10 +3857,10 @@ interface SignInFormProps {
 /**
  * SignInForm - Main sign-in / connect component.
  *
- * 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.
+ * When gatewayUrl is provided (re-auth to known workspace) the URL field is locked.
+ * When gatewayUrl is omitted (new connection) the user enters the URL themselves.
  */
-declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, backendUrl, error, showCredentialsAuth, isLoading, translations: t, }: SignInFormProps): React__default.JSX.Element;
+declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, gatewayUrl, error, showCredentialsAuth, isLoading, translations: t, }: SignInFormProps): React__default.JSX.Element;
 
 /**
  * SignUpForm - Pure React component for Google OAuth sign-up
@@ -4208,6 +4077,37 @@ interface TagSchemasPageProps {
 }
 declare function TagSchemasPage({ schemas, isLoading, theme, activePanel, translations: t, ToolbarPanels, Toolbar, }: TagSchemasPageProps): React__default.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: AnnotatorKey;
+        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;
+
 /**
  * A cache-backed list in its real states.
  *
@@ -4709,5 +4609,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, 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, 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, useCollaborators, 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, 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, AssistDataType, 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, ReferenceHover, ReferenceWizardModalProps, ResolvedTheme, ResourceCardProps, ResourceComposePageProps, ResourceDiscoveryPageProps, ResourceErrorStateProps, ResourceGenerateModalProps, ResourceGenerateModalTranslations, ResourceLoaderStateUnit, 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, UseCollaboratorsResult, UseMediaTokenResult, UseResourceContentResult, UseResourceLoaderResult, WelcomePageProps, WelcomeStateUnit, WizardState };
+export { ANNOTATORS, AVAILABLE_LOCALES, AdminDevOpsPage, 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, Footer, HighlightEntry, HighlightPanel, HistoryEvent, ImageAnnotateRenderer, ImageBrowseRenderer, ImageURLSchema, ImageViewer, JsonLdPanel, JsonLdView, KeyboardShortcutsHelpModal, LeftSidebar, LineNumbersProvider, 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, 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, createResourceLoaderStateUnit, createResourceViewerPageStateUnit, createSessionStateUnit, createShellStateUnit, createWelcomeStateUnit, cssVariables, defaultAnnotateRenderers, defaultBrowseRenderers, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, mediaUrl, resolveAnnotationSpans, sanitizeImageURL, saveSelectedShapeForSelectorType, setPdfWorkerSrc, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAnnotationManager, useCollaborators, 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, useResourceLoader, useResourceLoadingAnnouncements, useRovingTabIndex, useSearchAnnouncements, useSemiont, useSessionEventSubscriptions, useSessionExpiry, useSessionStateUnit, useShellStateUnit, useStateUnit, useTheme, useToast, useToolbarPrefs, useTranslations };
+export type { AdminDevOpsPageProps, AdminSecurityPageProps, AdminSecurityStateUnit, AdminUser, AdminUserStats, AdminUsersPageProps, AdminUsersStateUnit, AnnotateMediaRendererProps, AnnotateMediaRenderers, AnnotationConfig, AnnotationCreationHandler, AnnotationGroups, AnnotationHandlers, AnnotationManager, AnnotationProviderProps, AnnotationUIState, AnnotationsCollection, Annotator, AnnotatorKey, AssistDataType, 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, HoverEmitterProps, KBDiscoveryOptions, KBDiscoveryResult, KeyboardShortcut, LinkComponentProps, MediaRendererProps, Motivation$7 as Motivation, NavigationItem, NavigationMenuHelper, NavigationProps, OAuthProvider, OAuthUser, ObservableLinkProps, OverlayAnnotation, PendingCreation, RecentDocumentsPageProps, ReferenceHover, ReferenceWizardModalProps, ResolvedAnnotationSpan, ResolvedTheme, ResourceCardProps, ResourceComposePageProps, ResourceDiscoveryPageProps, ResourceErrorStateProps, ResourceGenerateModalProps, ResourceGenerateModalTranslations, ResourceLoaderStateUnit, 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, TextNodeEntry, TextSegment, TextSelection, Theme, ToastMessage, ToastType, ToolbarPanelType, ToolbarPart, ToolbarPrefs, TransitionToken, TranslationManager, TranslationProviderProps, TypographyToken, UICreateAnnotationParams, UploadProgressBarProps, UseCollaboratorsResult, UseMediaTokenResult, UseResourceContentResult, UseResourceLoaderResult, WelcomePageProps, WelcomeStateUnit, WizardState };