@semiont/react-ui 0.5.27 → 0.5.29

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, GatheredContext, CollaboratorEntry, EventMap, DiscoveredKB, AnnotationId, AnchorStrategy, AnchorConfidence, StoredEventLike, ConnectionState, 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, 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 { 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`.
  */
 
 /**
@@ -1072,28 +1106,6 @@ interface UseResourceContentResult {
  */
 declare function useResourceContent(client: SemiontClient | null, rUri: ResourceId, resource: ResourceDescriptor, enabled?: boolean): UseResourceContentResult;
 
-interface ResourceGatherOptions {
-    depth?: number;
-    maxResources?: number;
-    includeContent?: boolean;
-    includeSummary?: boolean;
-    /** Entity types to exclude from the gather's semantic recall (e.g. ['Question']). */
-    excludeEntityTypes?: string[];
-}
-interface UseResourceGatherResult {
-    context: GatheredContext | null;
-    loading: boolean;
-    error: Error | null;
-    /** Run a resource gather (`gather.resource`) and store the result. */
-    gather: (resourceId: string, options?: ResourceGatherOptions) => Promise<void>;
-    reset: () => void;
-}
-/**
- * Drives a whole-resource gather (`client.gather.resource`, a Promise — no progress
- * stream) into React state. The home for the GENERATE-FROM-BUTTON resource-gather flow.
- */
-declare function useResourceGather(): UseResourceGatherResult;
-
 interface UseResourceLoaderResult {
     resource: ResourceDescriptor | undefined;
     annotations: AnnotationsCollection;
@@ -1139,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.
@@ -1354,9 +1366,9 @@ declare function useEventSubscriptions(subscriptions: {
 }): void;
 
 interface ResourceAnnotationsContextType {
-    newAnnotationIds: Set<string>;
+    sparkleAnnotationIds: Set<string>;
     markAnnotation: (rUri: ResourceId, motivation: 'highlighting' | 'linking' | 'assessing' | 'commenting' | 'tagging', selector: Selector | Selector[], body?: any[]) => Promise<string | undefined>;
-    clearNewAnnotationId: (id: AnnotationId) => void;
+    clearSparkle: (id: AnnotationId) => void;
     triggerSparkleAnimation: (annotationId: string) => void;
 }
 declare function ResourceAnnotationsProvider({ children }: {
@@ -1501,7 +1513,7 @@ interface Props$c {
     }) => void;
     onChange?: (content: string) => void;
     editable?: boolean;
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     hoveredAnnotationId?: string | null;
     scrollToAnnotationId?: string | null;
     sourceView?: boolean;
@@ -1512,9 +1524,9 @@ interface Props$c {
     generatingReferenceId?: string | null;
     hoverDelayMs: number;
 }
-declare function CodeMirrorRenderer({ content, segments, onChange, editable, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$c): React$1.JSX.Element;
+declare function CodeMirrorRenderer({ content, segments, onChange, editable, sparkleAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, sourceView, showLineNumbers, enableWidgets, session, getTargetResourceName, generatingReferenceId, hoverDelayMs }: Props$c): React$1.JSX.Element;
 
-type JobProgress$8 = components['schemas']['JobProgress'];
+type JobProgress$9 = components['schemas']['JobProgress'];
 type JobProgressMessage = components['schemas']['JobProgressMessage'];
 /**
  * Every string this component renders. Required by default and with NO English
@@ -1545,7 +1557,7 @@ interface AssistProgressTranslations {
      * Takes the wire's `{ kind, value }` — the localized name for `kind` is the
      * translation layer's business, not this component's.
      */
-    subject: (current: NonNullable<JobProgress$8['current']>, done?: number, total?: number) => string;
+    subject: (current: NonNullable<JobProgress$9['current']>, done?: number, total?: number) => string;
     /**
      * Localized NAME for an echoed request parameter. The wire sends a code
      * (`instructions`, `tone`, …); the VALUE beside it is the user's own words
@@ -1562,8 +1574,27 @@ interface AssistProgressTranslations {
  */
 type AssistDataType = 'highlight' | 'comment' | 'assessment' | 'reference' | 'tag' | 'generation';
 interface AssistProgressProps {
-    progress: JobProgress$8;
+    progress: JobProgress$9;
     dataType: AssistDataType;
+    /**
+     * What the finished run produced, offered as a link in the ended frame
+     * (GENERATE-FROM-RESOURCE D8). The label is the artifact's own name — user
+     * content, never translated. Rendered only once `ended`: mid-run there is no
+     * outcome to offer, whatever the caller has wired.
+     */
+    outcome?: {
+        label: string;
+        onOpen: () => void;
+    } | undefined;
+    /**
+     * The owner's terminal sentence, rendered in place of the payload message
+     * once `ended` (GENERATION-ARRIVAL P1). The producer's final frame is a
+     * fire-and-forget emit that can lose the race with `job:complete`, so an
+     * ended frame must not trust the last payload to describe the ending —
+     * the owner, which signalled `ended`, supplies the words too. Inert while
+     * the run is live.
+     */
+    endedMessage?: string;
     /**
      * The run has ENDED. The owner's fact, not the payload's
      * (ASSIST-PROGRESS-CONSOLIDATION D7): terminality is signalled on
@@ -1598,16 +1629,16 @@ interface AssistProgressProps {
  * opt-ins produced four unrelated layouts from one component, which is what
  * generated the duplicate renders and doubled chrome this replaces.
  */
-declare function AssistProgress({ progress, dataType, ended, onCancel, onDismiss, translations: tr, }: AssistProgressProps): React$1.JSX.Element;
+declare function AssistProgress({ progress, dataType, ended, outcome, endedMessage, onCancel, onDismiss, translations: tr, }: AssistProgressProps): React$1.JSX.Element;
 
-type JobProgress$7 = components['schemas']['JobProgress'];
+type JobProgress$8 = components['schemas']['JobProgress'];
 interface AssistShellProps {
     /** localStorage persist-key suffix and CSS `data-type`. */
     assistType: AssistDataType;
     /** Collapsible section title (already translated). */
     title: string;
     isAssisting: boolean;
-    progress: JobProgress$7 | null | undefined;
+    progress: JobProgress$8 | null | undefined;
     /** The per-motivation form (fields + submit) — shown when no progress is displayed. */
     form: ReactNode;
     /**
@@ -1956,7 +1987,7 @@ interface AnnotateMediaRendererProps {
     selectedMotivation: SelectionMotivation | null;
     hoveredAnnotationId?: string | null;
     hoverDelayMs?: number;
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     scrollToAnnotationId?: string | null;
     showLineNumbers?: boolean;
     enableWidgets?: boolean;
@@ -1965,7 +1996,7 @@ interface AnnotateMediaRendererProps {
 }
 /** Annotating media dispatch, keyed by the registry render mode. */
 type AnnotateMediaRenderers = Partial<Record<string, ComponentType<AnnotateMediaRendererProps>>>;
-declare function TextAnnotateRenderer({ content, annotations, session, newAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, showLineNumbers, hoverDelayMs, enableWidgets, getTargetResourceName, generatingReferenceId, }: AnnotateMediaRendererProps): React$1.JSX.Element;
+declare function TextAnnotateRenderer({ content, annotations, session, sparkleAnnotationIds, hoveredAnnotationId, scrollToAnnotationId, showLineNumbers, hoverDelayMs, enableWidgets, getTargetResourceName, generatingReferenceId, }: AnnotateMediaRendererProps): React$1.JSX.Element;
 declare function ImageAnnotateRenderer({ content, resourceUri, annotations, session, drawingMode, selectedMotivation, hoveredAnnotationId, hoverDelayMs, }: AnnotateMediaRendererProps): React$1.JSX.Element | null;
 declare function PdfAnnotateRenderer({ content, resourceUri, annotations, session, drawingMode, selectedMotivation, hoveredAnnotationId, hoverDelayMs, }: AnnotateMediaRendererProps): React$1.JSX.Element | null;
 /**
@@ -1994,7 +2025,7 @@ interface Props$9 {
     /** Session for the shown resource — its client emits mark:* / mark.request; its bus feeds toolbar + beckon events. */
     session: SemiontSession | null;
     /** Recently-created annotation ids to sparkle (host-provided; was ResourceAnnotationsContext). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     /** The bar's Mode control reports the chosen mode here (the owner applies it). */
     onModeChange?: (mode: boolean) => void;
     /** Render the built-in bar (default). false → no bar; selection capture and drawing stay live. */
@@ -2009,7 +2040,7 @@ interface Props$9 {
  * @subscribes beckon:hover - Annotation hovered. Payload: { annotationId: string | null }
  * @subscribes beckon:focus - Scroll to and highlight annotation, unless `resourceId` names a different resource (D7). Payload: { annotationId: string, resourceId?: string }
  */
-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;
+declare function AnnotateView({ content, mimeType, resourceUri, annotations, uiState, onUIStateChange, enableWidgets, getTargetResourceName, generatingReferenceId, showLineNumbers, hoverDelayMs, annotateMode, session, sparkleAnnotationIds, onModeChange, showToolbar, renderers, }: Props$9): React$1.JSX.Element;
 
 interface Props$8 {
     /**
@@ -2076,7 +2107,7 @@ interface Props$7 {
     /** Session for the shown resource — emits browse:click / beckon:hover; its bus feeds beckon events. */
     session: SemiontSession | null;
     /** Recently-created annotation ids to sparkle (host-provided; was ResourceAnnotationsContext). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     /** Override the read-only media renderers (render mode → renderer); merged over the defaults. */
     renderers?: BrowseMediaRenderers;
     /** A content link (`<a href>` in the rendered content) was clicked. The viewer preventDefaults and
@@ -2117,12 +2148,12 @@ 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$7) => React$1.JSX.Element>;
+declare const BrowseView: React$1.MemoExoticComponent<({ content, mimeType, resourceUri, annotations, selectedClick, onModeChange, onClickActionChange, showToolbar, annotateMode, hoverDelayMs, session, sparkleAnnotationIds, 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 for that resource — its client mints the media token and supplies the gateway origin. */
     session: SemiontSession | null;
 }
 /**
@@ -2198,7 +2229,7 @@ interface Props$4 {
     /** Inline display variant: auto-height, no inner scroll, no pane chrome (browse path). Default: fill-the-pane. */
     inline?: boolean;
     /** Recently-created annotation ids to sparkle (threaded to the browse/annotate subtree). */
-    newAnnotationIds?: Set<string>;
+    sparkleAnnotationIds?: Set<string>;
     generatingReferenceId?: string | null;
     showLineNumbers?: boolean;
     hoverDelayMs?: number;
@@ -2254,7 +2285,7 @@ interface Props$4 {
  *   the motivation is derived from the annotation the id names, and an id this
  *   viewer has not loaded is a no-op.
  */
-declare function ResourceViewer({ resource, annotations, session, onOpenResource, onOpenPanel, onLinkClick, onReferenceHover, inline, newAnnotationIds, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp, annotateMode: annotateModeProp, onAnnotateModeChange, clickAction: clickActionProp, onClickActionChange, selectionMotivation: selectionMotivationProp, onSelectionMotivationChange, shape: shapeProp, onShapeChange, showToolbar, browseRenderers, annotateRenderers, }: Props$4): React__default.JSX.Element;
+declare function ResourceViewer({ resource, annotations, session, onOpenResource, onOpenPanel, onLinkClick, onReferenceHover, inline, sparkleAnnotationIds, generatingReferenceId, showLineNumbers, hoverDelayMs, hoveredAnnotationId: hoveredAnnotationIdProp, annotateMode: annotateModeProp, onAnnotateModeChange, clickAction: clickActionProp, onClickActionChange, selectionMotivation: selectionMotivationProp, onSelectionMotivationChange, shape: shapeProp, onShapeChange, showToolbar, browseRenderers, annotateRenderers, }: Props$4): React__default.JSX.Element;
 
 interface AssessmentEntryProps {
     /** Session for interaction routing (browse.click etc.); the panel threads it. */
@@ -2267,7 +2298,7 @@ interface AssessmentEntryProps {
 declare function AssessmentEntry({ session, assessment, isFocused, isHovered, ref, }: AssessmentEntryProps): React$1.JSX.Element;
 
 type Motivation$5 = components['schemas']['Motivation'];
-type JobProgress$6 = components['schemas']['JobProgress'];
+type JobProgress$7 = components['schemas']['JobProgress'];
 interface PendingAnnotation$5 {
     selector: Selector | Selector[];
     motivation: Motivation$5;
@@ -2280,7 +2311,7 @@ interface AssessmentPanelProps {
     annotations: Annotation[];
     pendingAnnotation: PendingAnnotation$5 | null;
     isAssisting?: boolean;
-    progress?: JobProgress$6 | null;
+    progress?: JobProgress$7 | null;
     locale?: string;
     /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
     sourceLanguage?: string;
@@ -2345,7 +2376,7 @@ interface CommentEntryProps {
 declare function CommentEntry({ session, comment, isFocused, isHovered, annotateMode, ref, }: CommentEntryProps): React$1.JSX.Element;
 
 type Motivation$4 = components['schemas']['Motivation'];
-type JobProgress$5 = components['schemas']['JobProgress'];
+type JobProgress$6 = components['schemas']['JobProgress'];
 interface PendingAnnotation$4 {
     selector: Selector | Selector[];
     motivation: Motivation$4;
@@ -2359,7 +2390,7 @@ interface CommentsPanelProps {
     pendingAnnotation: PendingAnnotation$4 | null;
     annotateMode?: boolean;
     isAssisting?: boolean;
-    progress?: JobProgress$5 | null;
+    progress?: JobProgress$6 | null;
     locale?: string;
     /** BCP-47 tag of the resource being analyzed — forwarded to the assist call. */
     sourceLanguage?: string;
@@ -2376,7 +2407,7 @@ interface CommentsPanelProps {
  */
 declare function CommentsPanel({ session, resourceId, annotations, pendingAnnotation, annotateMode, isAssisting, progress, locale, sourceLanguage, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, }: CommentsPanelProps): React$1.JSX.Element;
 
-type JobProgress$4 = components['schemas']['JobProgress'];
+type JobProgress$5 = components['schemas']['JobProgress'];
 interface AssistSectionProps {
     /** Session carrying the client and event bus; null renders inert. */
     session: SemiontSession | null;
@@ -2386,7 +2417,7 @@ interface AssistSectionProps {
     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;
+    progress?: JobProgress$5 | null | undefined;
 }
 /**
  * Assist fields for the text motivations (highlight, assessment, comment):
@@ -2410,7 +2441,7 @@ interface HighlightEntryProps {
 declare function HighlightEntry({ session, highlight, isFocused, isHovered, ref, }: HighlightEntryProps): React$1.JSX.Element;
 
 type Motivation$3 = components['schemas']['Motivation'];
-type JobProgress$3 = components['schemas']['JobProgress'];
+type JobProgress$4 = components['schemas']['JobProgress'];
 interface PendingAnnotation$3 {
     selector: Selector | Selector[];
     motivation: Motivation$3;
@@ -2423,7 +2454,7 @@ interface HighlightPanelProps {
     annotations: Annotation[];
     pendingAnnotation: PendingAnnotation$3 | null;
     isAssisting?: boolean;
-    progress?: JobProgress$3 | null;
+    progress?: JobProgress$4 | null;
     annotateMode?: boolean;
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
@@ -2474,11 +2505,13 @@ interface ReferenceEntryProps {
     onOpenResource?: (resourceId: string) => void;
     annotateMode?: boolean;
     isGenerating?: boolean;
+    /** The reference just got attention-worthy (created or resolved) — glow the icon (RESOLUTION-SPARKLE D6). */
+    sparkle?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
-declare function ReferenceEntry({ session, reference, isFocused, isHovered, onOpenResource, annotateMode, isGenerating, ref, }: ReferenceEntryProps): React$1.JSX.Element;
+declare function ReferenceEntry({ session, reference, isFocused, isHovered, onOpenResource, annotateMode, isGenerating, sparkle, ref, }: ReferenceEntryProps): React$1.JSX.Element;
 
-type JobProgress$2 = components['schemas']['JobProgress'];
+type JobProgress$3 = components['schemas']['JobProgress'];
 
 type Motivation$2 = components['schemas']['Motivation'];
 type ReferencedBy = components['schemas']['GetReferencedByResponse']['referencedBy'][number];
@@ -2495,7 +2528,7 @@ interface Props$1 {
     resourceId: string;
     annotations?: Annotation[];
     isAssisting: boolean;
-    progress: JobProgress$2 | null;
+    progress: JobProgress$3 | null;
     annotateMode?: boolean;
     Link: React__default.ComponentType<LinkComponentProps>;
     routes: RouteBuilder;
@@ -2523,6 +2556,8 @@ interface Props$1 {
     scrollToAnnotationId?: string | null;
     onScrollCompleted?: () => void;
     hoveredAnnotationId?: string | null;
+    /** Annotations currently sparkling (recently created or resolved) — entries in the set glow their icon (RESOLUTION-SPARKLE D6). */
+    sparkleAnnotationIds?: Set<string>;
     /** 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. */
@@ -2536,9 +2571,10 @@ interface Props$1 {
  * @emits mark:cancel-pending - Cancel pending reference annotation. Payload: undefined
  * @subscribes browse:click - Annotation clicked. Payload: { annotationId: string }
  */
-declare function ReferencesPanel({ session, onOpenResource, resourceId, annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, entityTypesError, generatingReferenceId, referencedBy, referencedByLoading, referencedByError, onRetryReferencedBy, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, locale, sourceLanguage, }: Props$1): React__default.JSX.Element;
+declare function ReferencesPanel({ session, onOpenResource, resourceId, annotations, isAssisting, progress, annotateMode, Link, routes, allEntityTypes, entityTypesError, generatingReferenceId, referencedBy, referencedByLoading, referencedByError, onRetryReferencedBy, pendingAnnotation, scrollToAnnotationId, onScrollCompleted, hoveredAnnotationId, sparkleAnnotationIds, locale, sourceLanguage, }: Props$1): React__default.JSX.Element;
 
 type Agent = components['schemas']['Agent'];
+type JobProgress$2 = components['schemas']['JobProgress'];
 interface Props {
     /** Session carrying the client and event bus; null renders inert. */
     session: SemiontSession | null;
@@ -2560,6 +2596,17 @@ interface Props {
      * to a verb). Omit to hide the Generate action.
      */
     onGenerate?: () => void;
+    /**
+     * Generation lifecycle, page-held (`yield.isGenerating$` / `yield.progress$`
+     * / `yield.outcome$`): this panel is generation's progress surface
+     * (GENERATE-FROM-RESOURCE D7) — the run reports where it was started.
+     */
+    isGenerating?: boolean;
+    generationProgress?: JobProgress$2 | null;
+    /** The finished run's result; the ended frame links it by name (D8). */
+    generationOutcome?: YieldOutcome | null;
+    /** Clear the finished display — wires `yield.dismissProgress()`. */
+    onDismissProgress?: () => void;
 }
 /**
  * Panel for displaying resource metadata and management actions
@@ -2568,7 +2615,7 @@ interface Props {
  * @emits mark:unarchive - Unarchive this resource
  * @emits mark:archive - Archive this resource
  */
-declare function ResourceInfoPanel({ session, resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, onGenerate, }: Props): React$1.JSX.Element;
+declare function ResourceInfoPanel({ session, resourceId, documentEntityTypes, documentLocale, primaryMediaType, primaryByteSize, storageUri, isArchived, dateCreated, dateModified, wasAttributedTo, wasDerivedFrom, generator, onGenerate, isGenerating, generationProgress, generationOutcome, onDismissProgress, }: Props): React$1.JSX.Element;
 
 interface StatisticsPanelProps {
     highlights: Annotation[];
@@ -2626,7 +2673,7 @@ declare function TaggingPanel({ session, resourceId, annotations, annotateMode,
 type JobProgress = components['schemas']['JobProgress'];
 
 type Motivation = components['schemas']['Motivation'];
-type TabKey = 'statistics' | 'reference' | 'highlight' | 'assessment' | 'comment' | 'tag';
+type TabKey = 'statistics' | AnnotatorKey;
 interface PendingAnnotation {
     selector: Selector | Selector[];
     motivation: Motivation;
@@ -2666,6 +2713,8 @@ interface UnifiedAnnotationsPanelProps {
     entityTypesError?: Error | null;
     referencedByError?: Error | null;
     onRetryReferencedBy?: () => void;
+    /** Annotations currently sparkling (recently created or resolved) — RESOLUTION-SPARKLE D6. */
+    sparkleAnnotationIds?: Set<string>;
     resourceId: string;
     initialTab?: TabKey;
     initialTabGeneration?: number;
@@ -2894,14 +2943,46 @@ interface SimpleNavigationProps {
     dropdownContent?: ((onClose: () => void) => ReactNode) | undefined;
 }
 
-interface GenerationConfig {
-    title: string;
+/**
+ * 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;
+    /** Full file:// URI. */
     storagePath: string;
-    prompt?: string;
+    content: string;
+    entityTypes: string[];
     language: string;
-    temperature: number;
-    maxTokens: number;
-    context: GatheredContext;
 }
 
 interface ReferenceWizardModalProps {
@@ -2919,8 +3000,16 @@ 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[];
+    /**
+     * The source resource's display name — a page fact (the wizard opens FROM
+     * that resource), shown in the gather skeleton's source line before the
+     * gathered context can say it itself.
+     */
+    resourceName?: string;
     /** Current locale for generation defaults */
     locale: string;
     /** Gathered context state */
@@ -2930,21 +3019,36 @@ interface ReferenceWizardModalProps {
     /** Callbacks */
     onGenerateSubmit: (referenceId: string, config: GenerationConfig) => void;
     onLinkResource: (referenceId: string, targetResourceId: string) => void;
-    onComposeNavigate: (context: GatheredContext, annotationId: string, resourceId: string, title: string, entityTypes: string[]) => void;
+    /**
+     * Create-and-link (COMPOSE-IN-MODAL): the host runs `yield.resource` then
+     * `bind.body` and settles the promise; rejection keeps the modal open with
+     * the compose footer re-enabled. Replaces the old navigate-to-page flow.
+     */
+    onComposeSubmit: (referenceId: string, params: ComposeParams$1) => Promise<void>;
+    /** Picker vocabulary for compose when the reference fixed no entity types. */
+    entityTypeOptions?: string[];
+    /** Editor hover delay for the compose step's CodeMirror. */
+    hoverDelayMs?: number;
     /** Translation strings */
     translations: {
-        gatherTitle: string;
-        configureGenerationTitle: string;
-        configureSearchTitle: string;
-        searchResultsTitle: string;
+        /** The ONE title, all steps — the flow is resolving a reference; the
+            strategy band below says where in it you are. */
+        resolveTitle: string;
         sourceContextLabel: string;
         connectionsLabel: string;
         citedByLabel: string;
+        graphPaneTitle: string;
+        graphEmpty: string;
+        resourceLinkLabel: string;
+        corpusPaneTitle: string;
+        corpusEmpty: string;
+        excludedReceipt: string;
+        machineRead: string;
         userHintLabel: string;
+        userHintEffect: string;
         userHintPlaceholder: string;
         loadingContext: string;
         failedContext: string;
-        cancel: string;
         search: string;
         searching: string;
         generate: string;
@@ -2956,6 +3060,7 @@ interface ReferenceWizardModalProps {
         noResults: string;
         resourceTitle: string;
         resourceTitlePlaceholder: string;
+        saveLocation: string;
         additionalInstructions: string;
         additionalInstructionsPlaceholder: string;
         language: string;
@@ -2966,41 +3071,52 @@ interface ReferenceWizardModalProps {
         maxLength: string;
         maxLengthHelp: string;
         maxLengthCeiling: string;
+        outputFormat: string;
+        formatExtensionMismatch: string;
         maxResults: string;
         semanticScoring: string;
         semanticScoringHelp: string;
+        searchFailed: string;
+        entityTypes: string;
+        contentLabel: string;
+        createAndLink: string;
+        creatingAndLinking: string;
+        discardDraftPrompt: string;
+        discardDraft: string;
+        keepEditing: string;
     };
 }
-declare function ReferenceWizardModal({ isOpen, onClose, annotationId, resourceId, defaultTitle, entityTypes, locale, context, contextLoading, contextError, onGenerateSubmit, onLinkResource, onComposeNavigate, translations: t, generationAgent, }: ReferenceWizardModalProps): React$1.JSX.Element;
-
-interface ResourceGatherConfig {
-    depth: number;
-    maxResources: number;
-    includeContent: boolean;
-    includeSummary: boolean;
-}
+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 {
-    gatherTitle: string;
-    reviewTitle: string;
-    configureTitle: string;
-    next: string;
-    back: string;
-    cancel: string;
+    /** The ONE modal title — names the flow, not a step. */
+    title: string;
     gatherIntro: string;
     includeContent: string;
     includeSummary: string;
     gatherDepth: string;
     gatherMaxResources: string;
     gatherButton: string;
-    excludeLabel: string;
+    /** Labels the recall chips: every type included until deselected. */
+    recallLabel: string;
+    /** Affordance on the post-gather receipt row (title/tooltip). */
+    editGather: string;
     loadingContext: string;
     failedContext: string;
     sourceContextLabel: string;
     connectionsLabel: string;
     citedByLabel: string;
+    graphPaneTitle: string;
+    graphEmpty: string;
+    resourceLinkLabel: string;
+    corpusPaneTitle: string;
+    corpusEmpty: string;
+    excludedReceipt: string;
+    machineRead: string;
+    score: string;
     resourceTitle: string;
     resourceTitlePlaceholder: string;
+    saveLocation: string;
     additionalInstructions: string;
     additionalInstructionsPlaceholder: string;
     language: string;
@@ -3011,7 +3127,12 @@ interface ResourceGenerateModalTranslations {
     maxLength: string;
     maxLengthHelp: string;
     maxLengthCeiling: string;
+    outputFormat: string;
+    formatExtensionMismatch: string;
     generate: string;
+    discardDraftPrompt: string;
+    discardDraft: string;
+    keepEditing: string;
 }
 interface ResourceGenerateModalProps {
     /**
@@ -3024,8 +3145,9 @@ interface ResourceGenerateModalProps {
     onClose: () => void;
     resourceId: string;
     defaultTitle: string;
+    /** Folder of the source resource, so the artifact lands beside it (D11). */
+    defaultFolder?: string;
     locale: string;
-    gatherDefaults?: Partial<ResourceGatherConfig>;
     /**
      * Entity types offered in the exclusion picker. Owner-supplied so the
      * modal cannot present a failed load as an empty vocabulary.
@@ -3037,14 +3159,35 @@ interface ResourceGenerateModalProps {
      * annotation wizard delegates generation to its parent.
      */
     onGenerateSubmit: (resourceId: string, config: GenerationConfig) => void;
+    /**
+     * Resource-gather state, verbatim from the SDK's gather unit slots
+     * (`gather.resourceContext$` / `resourceLoading$` / `resourceError$`) — the
+     * page reads the observables and threads them here, the same shape the
+     * reference wizard has always had (FLOW-LIFECYCLE-CONVERGENCE D3/A6). The
+     * modal renders this state; it never owns it.
+     */
+    gatherContext: GatheredContext | null;
+    gatherLoading: boolean;
+    gatherError: Error | null;
+    /**
+     * Run the gather — the page wires `gather.gatherResource(resourceId, …)`.
+     * No resourceId in the payload: the owner already holds it. `gatherResource`
+     * clears its slots at start, so no reset threading is needed.
+     */
+    onGather: (options: ResourceGatherOptions) => void;
     translations: ResourceGenerateModalTranslations;
 }
 /**
- * Resource-generate flow (GENERATE-FROM-BUTTON): configure gather options →
- * `gather.resource` → review the gathered `GatheredContext` → configure
- * generation → emit. Reuses the kind-aware `GatherContextStep` for the review.
+ * Resource-generate flow (GENERATE-FROM-BUTTON, folded by GATHER-AT-THE-TOP):
+ * one composite stack in a single scroll pane — the gather controls at the
+ * top, the gathered `GatheredContext` below them once gather fires, and the
+ * generation params beneath the evidence once context arrives. Re-gathering
+ * is scroll-up → tweak → Gather; `gatherResource` clears its slots at start,
+ * so the evidence refreshes in place. [gather zone] → [evidence] → [act
+ * 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, gatherDefaults, entityTypeOptions, onGenerateSubmit, 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;
@@ -3064,21 +3207,6 @@ interface SearchModalProps$1 {
 }
 declare function SearchModal({ isOpen, onClose, onNavigate, translations }: SearchModalProps$1): React__default.JSX.Element;
 
-interface ResourceSearchModalProps$1 {
-    isOpen: boolean;
-    onClose: () => void;
-    onSelect: (resourceId: string) => void;
-    searchTerm?: string;
-    translations?: {
-        title?: string;
-        placeholder?: string;
-        searching?: string;
-        noResults?: string;
-        close?: string;
-    };
-}
-declare function ResourceSearchModal({ isOpen, onClose, onSelect, searchTerm, translations }: ResourceSearchModalProps$1): React$1.JSX.Element;
-
 /**
  * Base modal props that all modals share
  */
@@ -3112,22 +3240,6 @@ interface SearchModalProps extends BaseModalProps, NavigableModalProps {
         close?: string;
     };
 }
-/**
- * Resource search modal props
- */
-interface ResourceSearchModalProps extends BaseModalProps {
-    /** Callback when a resource is selected */
-    onSelect: (resourceId: string) => void;
-    /** Initial search term */
-    searchTerm?: string;
-    /** Optional translation support */
-    translations?: {
-        title?: string;
-        placeholder?: string;
-        searching?: string;
-        noResults?: string;
-    };
-}
 
 /**
  * Skip links for keyboard navigation accessibility
@@ -3139,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;
 
@@ -3543,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: 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;
-
-/**
- * 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
  *
@@ -3746,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
  *
@@ -3873,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)
      */
@@ -3917,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;
@@ -3930,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;
@@ -3941,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
@@ -4161,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.
  *
@@ -4198,26 +4145,15 @@ interface ListState<T> {
     retry(): void;
 }
 
-type ComposeMode = 'new' | 'clone' | 'reference';
+type ComposeMode = 'new' | 'clone';
 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;
@@ -4229,16 +4165,12 @@ interface SaveResourceParams$1 {
     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: ListState<string[]>;
     /**
      * Live upload-progress for the in-flight `save(...)` call. Emits the
@@ -4255,15 +4187,14 @@ declare function createComposePageStateUnit(session: SemiontSession, browse: She
  * ResourceComposePage Component
  *
  * Pure React component for creating and editing resources.
- * Supports three modes: new resource, clone, and reference completion.
+ * Supports two modes: new resource and clone. (Reference completion moved
+ * into the resolve wizard — COMPOSE-IN-MODAL.)
  * All dependencies passed as props - no Next.js hooks!
  */
 
 interface ResourceComposePageProps {
-    mode: 'new' | 'clone' | 'reference';
+    mode: 'new' | 'clone';
     cloneData?: CloneData | null;
-    referenceData?: ReferenceData | null;
-    gatheredContext?: GatheredContext | null;
     availableEntityTypes: string[];
     initialLocale: string;
     theme: 'light' | 'dark';
@@ -4281,10 +4212,7 @@ interface ResourceComposePageProps {
     translations: {
         title: string;
         titleEditClone: string;
-        titleCompleteReference: string;
         subtitleClone: string;
-        subtitleReference: string;
-        linkedNoticePrefix: string;
         resourceName: string;
         resourceNamePlaceholder: string;
         entityTypes: string;
@@ -4306,16 +4234,14 @@ interface ResourceComposePageProps {
         cancel: string;
         saving: string;
         creating: string;
-        creatingAndLinking: string;
         saveClonedResource: string;
-        createAndLinkResource: string;
         createResource: string;
     };
     ToolbarPanels: React__default.ComponentType<any>;
     Toolbar: React__default.ComponentType<any>;
 }
 interface SaveResourceParams {
-    mode: 'new' | 'clone' | 'reference';
+    mode: 'new' | 'clone';
     name: string;
     storageUri: string;
     content?: string;
@@ -4325,10 +4251,8 @@ interface SaveResourceParams {
     entityTypes?: string[];
     language: string;
     archiveOriginal?: boolean;
-    annotationUri?: string;
-    sourceDocumentId?: string;
 }
-declare function ResourceComposePage({ mode, cloneData, referenceData, gatheredContext, availableEntityTypes, initialLocale, theme, hoverDelayMs, activePanel, onSaveResource, onCancel, uploadProgress, translations: t, ToolbarPanels, Toolbar, }: ResourceComposePageProps): React__default.JSX.Element;
+declare function ResourceComposePage({ mode, cloneData, 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.
@@ -4499,6 +4423,7 @@ interface ResourceViewerPageProps {
  * @subscribes yield:clone - Clone the current resource
  * @subscribes beckon:sparkle - Trigger sparkle animation
  * @subscribes mark:added - Annotation was created (sparkle)
+ * @subscribes mark:body-updated - Reference resolved via a linking-add operation (sparkle, both loci)
  * @subscribes browse:resource-open - Open a resource in the viewer (local links + the launcher's tour verbs)
  * @subscribes browse:entity-type-clicked - Navigate filtered by entity type
  *
@@ -4684,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, 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, 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, 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, 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, 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, UseCollaboratorsResult, UseMediaTokenResult, UseResourceContentResult, UseResourceGatherResult, 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 };