@semiont/react-ui 0.4.6 → 0.4.9

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as _semiont_core from '@semiont/core';
-import { components, ResourceId, Selector, AnnotationId, ResourceEvent, EventMap, EventBus, MarkProgress, StoredEvent, paths, GatheredContext, Motivation as Motivation$9, YieldProgress } from '@semiont/core';
+import { components, ResourceId, Selector, AnnotationId, ResourceEvent, EventBus, EventMap, MarkProgress, StoredEventLike, paths, GatheredContext, Motivation as Motivation$9, YieldProgress } from '@semiont/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { ComponentType, ReactNode, KeyboardEvent as KeyboardEvent$1, Component, ErrorInfo, Ref } from 'react';
-import { O as OpenResourcesManager, S as SessionManager, T as TranslationManager, a as OpenResource } from './EventBusContext-DUIMowqQ.mjs';
-export { E as EventBusProvider, b as EventBusProviderProps, c as SessionState, r as resetEventBusForTesting, u as useEventBus } from './EventBusContext-DUIMowqQ.mjs';
+import { O as OpenResourcesManager, S as SessionManager, T as TranslationManager, a as OpenResource } from './TranslationManager-CudgH3gw.mjs';
+export { b as SessionState } from './TranslationManager-CudgH3gw.mjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions } from '@tanstack/react-query';
 import { SemiontApiClient, ValidationResult } from '@semiont/api-client';
@@ -13,6 +13,7 @@ import { HighlightStyle } from '@codemirror/language';
 import { WidgetType } from '@codemirror/view';
 import { TagSchema } from '@semiont/ontology';
 export { TAG_SCHEMAS, TagCategory, TagSchema, getAllTagSchemas, getSchemaCategory as getTagCategory, getTagSchema, getTagSchemasByDomain, isValidCategory } from '@semiont/ontology';
+import { Observable } from 'rxjs';
 
 type Annotation$m = components['schemas']['Annotation'];
 /**
@@ -361,7 +362,23 @@ declare function useResources(): {
     };
     events: {
         useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            events: any[];
+            events: {
+                event: {
+                    id: string;
+                    type: string;
+                    timestamp: string;
+                    userId: string;
+                    resourceId: string;
+                    payload?: unknown;
+                };
+                metadata: {
+                    sequenceNumber: number;
+                    prevEventHash?: string;
+                    checksum?: string;
+                };
+            }[];
+            total: number;
+            resourceId: string;
         }, Error>;
     };
     annotations: {
@@ -372,12 +389,26 @@ declare function useResources(): {
     };
     referencedBy: {
         useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
-            referencedBy: any[];
+            referencedBy: {
+                id: string;
+                resourceName: string;
+                target: {
+                    source: string;
+                    selector: {
+                        exact: string;
+                    };
+                };
+            }[];
         }, Error>;
     };
     representation: {
         useQuery: (id: ResourceId, mediaType: string) => _tanstack_react_query.UseQueryResult<string, Error>;
     };
+    mediaToken: {
+        useQuery: (id: ResourceId) => _tanstack_react_query.UseQueryResult<{
+            token: string;
+        }, Error>;
+    };
     search: {
         useQuery: (query: string, limit: number) => _tanstack_react_query.UseQueryResult<{
             resources: _semiont_core.components["schemas"]["ResourceDescriptor"][];
@@ -680,6 +711,7 @@ declare function useAuthApi(): {
             domain: string;
             provider: string;
             isAdmin: boolean;
+            isModerator: boolean;
             isActive: boolean;
             termsAcceptedAt: string | null;
             lastLogin: string | null;
@@ -938,6 +970,7 @@ declare const QUERY_KEYS: {
         annotations: (id: ResourceId) => readonly ["resources", ResourceId, "annotations"];
         referencedBy: (id: ResourceId) => readonly ["resources", ResourceId, "referenced-by"];
         representation: (id: ResourceId) => readonly ["resources", ResourceId, "representation"];
+        mediaToken: (id: ResourceId) => readonly ["resources", ResourceId, "media-token"];
     };
     annotations: {
         detail: (id: AnnotationId) => readonly ["annotations", AnnotationId];
@@ -1313,7 +1346,6 @@ interface UseResourceEventsOptions {
  * React hook for subscribing to real-time document events via SSE
  *
  * Opens a long-lived SSE connection to receive events as they happen.
- * Automatically reconnects on disconnect (with exponential backoff).
  *
  * @example
  * ```tsx
@@ -1321,12 +1353,7 @@ interface UseResourceEventsOptions {
  *   rUri: resourceUri('http://localhost:4000/resources/doc-123'),
  *   onAnnotationAdded: (event) => {
  *     console.log('New annotation:', event.payload);
- *     // Update UI to show new annotation (highlight, reference, or assessment)
  *   },
- *   onAnnotationBodyUpdated: (event) => {
- *     console.log('Annotation body updated:', event.payload);
- *     // Update annotation display to reflect body changes
- *   }
  * });
  * ```
  */
@@ -1334,7 +1361,7 @@ declare function useResourceEvents({ rUri, onEvent, onAnnotationAdded, onAnnotat
     status: StreamStatus;
     lastEvent: ResourceEvent | null;
     eventCount: number;
-    connect: () => Promise<void>;
+    connect: () => void;
     disconnect: () => void;
     isConnected: boolean;
 };
@@ -1421,12 +1448,13 @@ interface UseResourceContentResult {
     loading: boolean;
 }
 /**
- * Hook to load resource content (representation)
+ * Hook to load text resource content (representation)
  *
- * Fetches the primary representation of a resource based on its media type.
- * Uses React Query for caching, deduplication, and consistent loading state.
+ * Fetches and decodes the primary text representation of a resource.
+ * Only for text types (text/plain, text/markdown).
+ * Binary types (image/*, application/pdf) use useMediaToken instead.
  */
-declare function useResourceContent(rUri: ResourceId, resource: SemiontResource$3): UseResourceContentResult;
+declare function useResourceContent(rUri: ResourceId, resource: SemiontResource$3, enabled?: boolean): UseResourceContentResult;
 
 interface AnnotationProviderProps {
     annotationManager: AnnotationManager;
@@ -1482,9 +1510,10 @@ interface ApiClientProviderProps {
     children: ReactNode;
 }
 /**
- * Provider for API client - creates a stateless singleton client
- * The client instance never changes (no token dependency)
- * Auth tokens are passed per-request via useAuthToken() in calling code
+ * Provider for API client — must be nested inside EventBusProvider.
+ * The client is re-created when the baseUrl changes (workspace switch).
+ * The EventBus is taken from EventBusContext so client and UI components
+ * share the same workspace-scoped bus.
  */
 declare function ApiClientProvider({ baseUrl: url, children, }: ApiClientProviderProps): react_jsx_runtime.JSX.Element;
 /**
@@ -1556,6 +1585,48 @@ declare function CacheProvider({ cacheManager, children }: CacheProviderProps):
  */
 declare function useCacheManager(): CacheManager;
 
+interface EventBusProviderProps {
+    children: ReactNode;
+}
+/**
+ * Unified event bus provider for all application events.
+ *
+ * Each provider mount creates a fresh EventBus instance. This means:
+ * - Workspace switches (which remount via key prop) get isolated buses
+ * - Tests get isolation naturally — no resetEventBusForTesting needed
+ *
+ * Operation handlers (API calls triggered by events) are set up separately via
+ * the useBindFlow hook, which should be called at the resource page level.
+ */
+declare function EventBusProvider({ children }: EventBusProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the unified event bus
+ *
+ * Use this everywhere instead of:
+ * - useMakeMeaningEvents()
+ * - useNavigationEvents()
+ * - useGlobalSettingsEvents()
+ *
+ * @example
+ * ```typescript
+ * const eventBus = useEventBus();
+ *
+ * // Emit any event
+ * eventBus.get('beckon:hover').next({ annotationId: '123' });
+ * eventBus.get('browse:sidebar-toggle').next(undefined);
+ * eventBus.get('settings:theme-changed').next({ theme: 'dark' });
+ *
+ * // Subscribe to any event
+ * useEffect(() => {
+ *   const unsubscribe = eventBus.on('beckon:hover', ({ annotationId }) => {
+ *     console.log(annotationId);
+ *   });
+ *   return () => unsubscribe();
+ * }, []);
+ * ```
+ */
+declare function useEventBus(): EventBus;
+
 /**
  * Subscribe to an event bus event with automatic cleanup.
  *
@@ -2029,7 +2100,7 @@ declare function AnnotationOverlay({ annotations, imageWidth, imageHeight, displ
 type Annotation$c = components['schemas']['Annotation'];
 type DrawingMode = 'rectangle' | 'polygon' | 'circle' | 'freeform' | null;
 interface SvgDrawingCanvasProps {
-    resourceUri: ResourceId;
+    imageUrl: string;
     existingAnnotations?: Annotation$c[];
     drawingMode: DrawingMode;
     selectedMotivation?: SelectionMotivation | null;
@@ -2044,7 +2115,7 @@ interface SvgDrawingCanvasProps {
  * @emits browse:click - Annotation clicked on canvas. Payload: { annotationId: string, motivation: Motivation }
  * @emits mark:requested - New annotation drawn on canvas. Payload: { selector: SvgSelector, motivation: SelectionMotivation }
  */
-declare function SvgDrawingCanvas({ resourceUri, existingAnnotations, drawingMode, selectedMotivation, eventBus, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): react_jsx_runtime.JSX.Element;
+declare function SvgDrawingCanvas({ imageUrl, existingAnnotations, drawingMode, selectedMotivation, eventBus, hoveredAnnotationId, selectedAnnotationId }: SvgDrawingCanvasProps): react_jsx_runtime.JSX.Element;
 
 interface KeyboardShortcutsHelpModalProps {
     isOpen: boolean;
@@ -2122,9 +2193,9 @@ declare const BrowseView: React$1.NamedExoticComponent<Props$6>;
 
 type TranslateFn$4 = (key: string, params?: Record<string, string | number>) => string;
 interface Props$5 {
-    event: StoredEvent;
+    event: StoredEventLike;
     annotations: any[];
-    allEvents: StoredEvent[];
+    allEvents: StoredEventLike[];
     isRelated: boolean;
     t: TranslateFn$4;
     Link: React__default.ComponentType<LinkComponentProps>;
@@ -2521,11 +2592,11 @@ interface UnifiedAnnotationsPanelProps {
 declare function UnifiedAnnotationsPanel(props: UnifiedAnnotationsPanelProps): react_jsx_runtime.JSX.Element;
 
 interface ImageViewerProps {
-    resourceUri: ResourceId;
+    imageUrl: string;
     mimeType: string;
     alt?: string;
 }
-declare function ImageViewer({ resourceUri, alt }: ImageViewerProps): react_jsx_runtime.JSX.Element;
+declare function ImageViewer({ imageUrl, alt }: ImageViewerProps): react_jsx_runtime.JSX.Element;
 
 type TranslateFn$3 = (key: string, params?: Record<string, any>) => string;
 interface FooterProps {
@@ -3541,13 +3612,20 @@ declare function AdminUsersPage({ users, userStats, isLoadingUsers, isLoadingSta
 
 interface SignInFormProps {
     /**
-     * Callback when user clicks Google sign-in
+     * Callback when user clicks Google sign-in.
+     * Receives the backend URL (either the locked one or what the user typed).
+     */
+    onGoogleSignIn: (backendUrl: string) => Promise<void>;
+    /**
+     * Callback when user submits email/password credentials.
+     * Receives the backend URL along with email and password.
      */
-    onGoogleSignIn: () => Promise<void>;
+    onCredentialsSignIn?: ((backendUrl: string, email: string, password: string) => Promise<void>) | undefined;
     /**
-     * Callback when user submits email/password credentials
+     * Pre-filled backend URL. When provided the field is read-only (re-auth to known workspace).
+     * When omitted the user enters the URL themselves (new connection).
      */
-    onCredentialsSignIn?: ((email: string, password: string) => Promise<void>) | undefined;
+    backendUrl?: string;
     /**
      * Error message to display (if any)
      */
@@ -3572,6 +3650,8 @@ interface SignInFormProps {
         welcomeBack: string;
         signInPrompt: string;
         continueWithGoogle: string;
+        backendUrlLabel: string;
+        backendUrlPlaceholder: string;
         emailLabel: string;
         emailPlaceholder: string;
         passwordLabel: string;
@@ -3583,15 +3663,21 @@ interface SignInFormProps {
         backToHome: string;
         learnMore: string;
         signUpInstead: string;
+        errorBackendUrlRequired: string;
+        errorBackendUrlInvalid: string;
+        errorBackendUrlUnreachable: string;
         errorEmailRequired: string;
         errorPasswordRequired: string;
         tagline: string;
     };
 }
 /**
- * SignInForm - Main sign-in component
+ * 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.
  */
-declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, error, showCredentialsAuth, isLoading, Link, translations: t, }: SignInFormProps): react_jsx_runtime.JSX.Element;
+declare function SignInForm({ onGoogleSignIn, onCredentialsSignIn, backendUrl, error, showCredentialsAuth, isLoading, Link, translations: t, }: SignInFormProps): react_jsx_runtime.JSX.Element;
 
 interface SignUpFormProps {
     /**
@@ -3918,6 +4004,10 @@ interface ResourceViewerPageProps {
      * Callback to refetch document from parent
      */
     refetchDocument: () => Promise<unknown>;
+    /**
+     * SSE attention stream connection status for the active workspace
+     */
+    streamStatus: StreamStatus;
 }
 /**
  * ResourceViewerPage - Main component
@@ -3946,7 +4036,7 @@ interface ResourceViewerPageProps {
  * @subscribes browse:reference-navigate - Navigate to a referenced document
  * @subscribes browse:entity-type-clicked - Navigate filtered by entity type
  */
-declare function ResourceViewerPage({ resource, rUri, locale, Link, routes, ToolbarPanels, refetchDocument, }: ResourceViewerPageProps): react_jsx_runtime.JSX.Element;
+declare function ResourceViewerPage({ resource, rUri, locale, Link, routes, ToolbarPanels, refetchDocument, streamStatus, }: ResourceViewerPageProps): react_jsx_runtime.JSX.Element;
 
 /**
  * useBeckonFlow — Annotation attention / pointer coordination hook
@@ -4022,23 +4112,14 @@ declare function useAttentionStream(): {
 /**
  * useMarkFlow - Annotation state management hook
  *
- * Manages all annotation workflows (manual and AI-driven):
- * - Pending annotation state (user selected text, waiting for confirmation)
- * - Selection events → pending annotation conversion
- * - Annotation request routing to appropriate panel
- * - Tracking currently assisting motivation (AI-assisted annotation)
- * - Annotation progress updates from SSE
- * - Assisted annotation lifecycle (start, progress, complete, failed)
- * - Auto-dismiss progress after completion (5 seconds)
- * - Manual dismiss via progress-dismiss event
- * - Annotation create/delete API calls
- * - AI-assisted annotation SSE streams (all 5 motivation types)
- *
- * Covers both forms: a human selecting text is manual annotation;
- * AI-driven SSE streams are assisted annotation. Same concept, same hook.
+ * Activates mark orchestration (CRUD + AI assist) by delegating to
+ * client.flows.mark(). Manages UI state (pendingAnnotation, assistingMotivation,
+ * progress) via EventBus subscriptions — the React-specific portion.
  *
- * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
- * subscribes to events and pushes values into React state.
+ * @subscribes mark:submit, mark:delete, mark:assist-request, job:cancel-requested
+ * @subscribes mark:requested, mark:select-*, mark:cancel-pending
+ * @subscribes mark:progress, mark:assist-finished, mark:assist-failed
+ * @returns Annotation flow state
  */
 
 interface PendingAnnotation {
@@ -4051,35 +4132,6 @@ interface MarkFlowState {
     progress: MarkProgress | null;
     assistStreamRef: React.MutableRefObject<AbortController | null>;
 }
-/**
- * Hook for annotation flow (manual and AI-driven)
- *
- * @param rUri - Resource URI being annotated
- * @emits browse:panel-open - Open the annotations panel when annotation is requested
- * @emits mark:created - Annotation successfully created
- * @emits mark:create-failed - Annotation creation failed
- * @emits mark:deleted - Annotation successfully deleted
- * @emits mark:delete-failed - Annotation deletion failed
- * @emits mark:progress - Progress update from SSE stream
- * @emits mark:assist-finished - SSE assist completed
- * @emits mark:assist-failed - SSE assist failed
- * @emits mark:assist-cancelled - SSE assist cancelled
- * @subscribes mark:requested - User requested a new annotation
- * @subscribes mark:create - Create annotation via API
- * @subscribes mark:delete - Delete annotation via API
- * @subscribes mark:select-comment - User selected text for a comment
- * @subscribes mark:select-tag - User selected text for a tag
- * @subscribes mark:select-assessment - User selected text for an assessment
- * @subscribes mark:select-reference - User selected text for a reference
- * @subscribes mark:cancel-pending - Cancel pending annotation creation
- * @subscribes mark:assist-request - Trigger AI-assisted annotation SSE stream
- * @subscribes job:cancel-requested - Cancels in-flight assist stream (assist half only)
- * @subscribes mark:progress - Progress update during assist
- * @subscribes mark:assist-finished - Assist completed successfully
- * @subscribes mark:assist-failed - Error during assist
- * @subscribes mark:progress-dismiss - Manually dismiss progress display
- * @returns Annotation flow state
- */
 declare function useMarkFlow(rUri: ResourceId): MarkFlowState;
 
 /**
@@ -4094,7 +4146,7 @@ declare function useMarkFlow(rUri: ResourceId): MarkFlowState;
  * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
  * subscribes to events and pushes values into React state.
  */
-type ToolbarPanelType = 'history' | 'info' | 'annotations' | 'settings' | 'collaboration' | 'user' | 'jsonld';
+type ToolbarPanelType = 'history' | 'info' | 'annotations' | 'settings' | 'collaboration' | 'user' | 'jsonld' | 'knowledge-base';
 /** Panels available on all pages */
 declare const COMMON_PANELS: readonly ToolbarPanelType[];
 /** Panels available only on resource viewer pages */
@@ -4121,17 +4173,13 @@ declare function usePanelBrowse(): PanelBrowseState;
 /**
  * useYieldFlow - Document generation flow hook
  *
- * Manages document generation state:
- * - Generation progress tracking
- * - SSE stream management
- * - Generation completion/error handling
+ * Activates yield orchestration by delegating to client.flows.yield().
+ * Manages generation progress state (React-specific) via EventBus subscriptions.
  *
- * The wizard modal (ReferenceWizardModal) handles modal state and user
- * interaction. This hook handles the downstream SSE generation after
- * the wizard emits yield:request.
- *
- * Follows react-rxjs-guide.md Layer 2 pattern: Hook bridge that
- * subscribes to events and pushes values into React state.
+ * @subscribes yield:request - Triggers SSE call to yieldResource
+ * @subscribes job:cancel-requested - Cancels in-flight generation stream
+ * @subscribes yield:progress, yield:finished, yield:failed
+ * @returns Generation flow state
  */
 
 interface YieldFlowState {
@@ -4147,41 +4195,23 @@ interface YieldFlowState {
         context: GatheredContext;
     }) => void;
 }
-/**
- * Hook for document generation flow
- *
- * @param locale - Current locale for language defaults
- * @param resourceId - Resource ID for generation
- * @param clearNewAnnotationId - Clear animation callback
- * @emits yield:request - Start document generation
- * @subscribes yield:request - Triggers SSE call to yieldResource
- * @subscribes job:cancel-requested - Cancels in-flight generation stream
- * @subscribes yield:progress - SSE progress chunks
- * @subscribes yield:finished - Generation completed successfully
- * @subscribes yield:failed - Error during generation
- * @returns Generation flow state
- */
 declare function useYieldFlow(locale: string, resourceId: string, clearNewAnnotationId: (annotationId: AnnotationId) => void): YieldFlowState;
 
 /**
  * useContextGatherFlow - Context gather capability hook
  *
- * Gather capability: given a reference annotation, fetch the surrounding
- * text context (before/selected/after) from the source document so it can
- * be gathered and used as grounding material for generation.
+ * Activates gather orchestration for a resource by delegating to
+ * client.flows.gatherContext(). Manages UI state (gatherContext, gatherLoading,
+ * gatherError, gatherAnnotationId) via EventBus subscriptions — the
+ * React-specific portion.
  *
- * This hook is the single owner of gather state. It is triggered by
- * gather:requested on the event bus, making the capability
- * accessible to both human UI flows and agents.
- *
- * @subscribes gather:requested - Fetch LLM context for an annotation
- * @emits gather:complete - Context successfully fetched
- * @emits gather:failed - Context fetch failed
- * @returns Gather state (context, loading, error, which annotation)
+ * @subscribes gather:requested - Triggers loading state
+ * @subscribes gather:complete - Sets gathered context
+ * @subscribes gather:failed - Sets error state
+ * @returns Gather flow state
  */
 
 interface ContextGatherFlowConfig {
-    client: SemiontApiClient;
     resourceId: ResourceId;
 }
 interface ContextGatherFlowState {
@@ -4191,25 +4221,46 @@ interface ContextGatherFlowState {
     /** The annotationId for which context was most recently gathered */
     gatherAnnotationId: AnnotationId | null;
 }
-declare function useContextGatherFlow(eventBus: EventBus, config: ContextGatherFlowConfig): ContextGatherFlowState;
+declare function useContextGatherFlow(config: ContextGatherFlowConfig): ContextGatherFlowState;
 
 /**
  * useBindFlow - Reference resolution flow hook
  *
- * Handles the write side of reference resolution:
- * - Annotation body updates (linking/unlinking)
- * - Error notifications
+ * Activates bind + search orchestration for a resource by delegating to
+ * client.flows.bind(). All subscription logic lives in FlowEngine (api-client).
  *
- * The wizard modal (ReferenceWizardModal) handles modal state, context
- * gathering, search configuration, and result display. This hook handles
- * the downstream API calls after the wizard emits bind:update-body.
+ * Toast notifications for resolution errors remain here (React-specific).
  *
  * @subscribes bind:update-body - Update annotation body via API
- * @subscribes match:search-requested - Bridge to backend Matcher via SSE; results emit as match:search-results
- * @emits bind:body-updated - Annotation body successfully updated
- * @emits bind:body-update-failed - Annotation body update failed
+ * @subscribes match:search-requested - Bridge to backend Matcher via SSE
+ * @emits bind:body-updated, bind:body-update-failed
  */
 
 declare function useBindFlow(rUri: ResourceId): void;
 
-export { ANNOTATORS, AUTH_EVENTS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AuthEventDetail, type AuthEventType, AuthTokenProvider, type AuthTokenProviderProps, type AvailableLocale, type BeckonFlowState, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMMON_PANELS, type CacheManager, CacheProvider, type CacheProviderProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ContextGatherFlowConfig, type ContextGatherFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HOVER_DELAY_MS, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, type HoverHandlers, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, type ImportPreview, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type MarkFlowState, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, OpenResource, OpenResourcesManager, OpenResourcesProvider, type OverlayAnnotation, PageLayout, type PanelBrowseState, PanelHeader, PopupContainer, PopupHeader, ProposeEntitiesModal, QUERY_KEYS, RESOURCE_PANELS, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, type SaveResourceParams, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, type SemiontResource$4 as SemiontResource, SessionExpiryBanner, SessionManager, SessionProvider, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, type StreamStatus, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WelcomePage, type WelcomePageProps, type YieldFlowState, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createHoverHandlers, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAdmin, useAnnotationManager, useAnnotations, useApiClient, useAttentionStream, useAuthApi, useAuthToken, useBeckonFlow, useBindFlow, useCacheManager, useContextGatherFlow, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGlobalEvents, useHealth, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMarkFlow, useModeration, useObservableExternalNavigation, useObservableRouter, useOpenResources, usePanelBrowse, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceEvents, useResourceLoadingAnnouncements, useResources, useRovingTabIndex, useSearchAnnouncements, useSessionContext, useSessionExpiry, useTheme, useToast, useTranslations, useYieldFlow };
+/**
+ * Subscribe to an RxJS Observable and return its current value as React state.
+ *
+ * - Initialises to undefined until the first emission
+ * - Unsubscribes automatically on unmount or when `obs$` changes
+ */
+declare function useObservable<T>(obs$: Observable<T>): T | undefined;
+
+/**
+ * useStoreTokenSync — keeps observable store token getters in sync with auth
+ *
+ * Call once near the workspace root (inside both ApiClientProvider and AuthTokenProvider).
+ * Ensures stores can make authenticated fetches as the token changes.
+ *
+ * @example
+ * ```tsx
+ * function GlobalEventsConnector() {
+ *   useStoreTokenSync();
+ *   useGlobalEvents();
+ *   return null;
+ * }
+ * ```
+ */
+declare function useStoreTokenSync(): void;
+
+export { ANNOTATORS, AUTH_EVENTS, AVAILABLE_LOCALES, AdminDevOpsPage, type AdminDevOpsPageProps, AdminExchangePage, type AdminExchangePageProps, type AdminExchangePageTranslations, AdminSecurityPage, type AdminSecurityPageProps, type AdminUser, type AdminUserStats, AdminUsersPage, type AdminUsersPageProps, AnnotateReferencesProgressWidget, AnnotateToolbar, AnnotateView, type Annotation$k as Annotation, type AnnotationConfig, type AnnotationCreationHandler, type AnnotationHandlers, AnnotationHistory, type AnnotationManager, AnnotationOverlay, AnnotationProvider, type AnnotationProviderProps, type AnnotationUIState, type AnnotationsCollection, type Annotator, ApiClientProvider, type ApiClientProviderProps, AssessmentEntry, AssessmentPanel, AssistSection, AsyncErrorBoundary, AuthErrorDisplay, type AuthErrorDisplayProps, type AuthEventDetail, type AuthEventType, AuthTokenProvider, type AuthTokenProviderProps, type AvailableLocale, type BeckonFlowState, type BorderRadiusToken, BrowseView, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMMON_PANELS, type CacheManager, CacheProvider, type CacheProviderProps, type ClickAction, CodeMirrorRenderer, CollaborationPanel, CollapsibleResourceNavigation, type CollapsibleResourceNavigationProps, type ColorToken, CommentEntry, CommentsPanel, ComposeLoadingState, type ComposeLoadingStateProps, type ContextGatherFlowConfig, type ContextGatherFlowState, type CreateAnnotationParams, type CreateConfig, type DeleteAnnotationParams, type DetectionConfig, type DevOpsFeature, type DrawingMode, EntityTagsPage, type EntityTagsPageProps, EntityTypeBadges, ErrorBoundary, EventBusProvider, type EventBusProviderProps, ExportCard, type ExportCardProps, type ExportCardTranslations, Footer, HOVER_DELAY_MS, HighlightEntry, HighlightPanel, HistoryEvent, type HoverEmitterProps, type HoverHandlers, ImageURLSchema, ImageViewer, ImportCard, type ImportCardProps, type ImportCardTranslations, type ImportPreview, ImportProgress, type ImportProgressProps, type ImportProgressTranslations, JsonLdPanel, JsonLdView, type KeyboardShortcut, KeyboardShortcutsHelpModal, LeftSidebar, type LinkComponentProps, LinkedDataPage, type LinkedDataPageProps, type LinkedDataPageTranslations, LiveRegionProvider, type MarkFlowState, type Motivation$8 as Motivation, type NavigationItem, NavigationMenu, type NavigationMenuHelper, type NavigationProps, type OAuthProvider, type OAuthUser, OAuthUserSchema, ObservableLink, type ObservableLinkProps, OpenResource, OpenResourcesManager, OpenResourcesProvider, type OverlayAnnotation, PageLayout, type PanelBrowseState, PanelHeader, PopupContainer, PopupHeader, ProposeEntitiesModal, QUERY_KEYS, RESOURCE_PANELS, RecentDocumentsPage, type RecentDocumentsPageProps, ReferenceEntry, ReferenceResolutionWidget, ReferenceWizardModal, type ReferenceWizardModalProps, ReferencesPanel, ResizeHandle, type ResolvedTheme, ResourceAnnotationsProvider, ResourceCard, type ResourceCardProps, ResourceComposePage, type ResourceComposePageProps, ResourceDiscoveryPage, type ResourceDiscoveryPageProps, ResourceErrorState, type ResourceErrorStateProps, ResourceInfoPanel, ResourceLoadingState, ResourceSearchModal, type ResourceSearchModalProps, ResourceTagsInline, ResourceViewer, ResourceViewerPage, type ResourceViewerPageProps, type RouteBuilder, type SaveResourceParams, SearchModal, type SearchModalProps, SelectedTextDisplay, type SelectionMotivation, type SelectorType, SemiontBranding, SemiontFavicon, type SemiontResource$4 as SemiontResource, SessionExpiryBanner, SessionManager, SessionProvider, SessionTimer, SettingsPanel, type ShadowToken, type ShapeType, SignInForm, type SignInFormProps, SignUpForm, type SignUpFormProps, SimpleNavigation, type SimpleNavigationItem, type SimpleNavigationProps, SkipLinks, SortableResourceTab, type SortableResourceTabProps, type SpacingToken, StatisticsPanel, StatusDisplay, type StreamStatus, SvgDrawingCanvas, TagEntry, TagSchemasPage, type TagSchemasPageProps, TaggingPanel, type TextSegment, type TextSelection, type Theme, ThemeProvider, ToastContainer, type ToastMessage, ToastProvider, type ToastType, Toolbar, type ToolbarPanelType, type TransitionToken, TranslationManager, TranslationProvider, type TranslationProviderProps, type TypographyToken, type UICreateAnnotationParams, UnifiedAnnotationsPanel, UnifiedHeader, type UseResourceContentResult, UserMenuSkeleton, WelcomePage, type WelcomePageProps, type YieldFlowState, applyHighlights, buildSourceToRenderedMap, buildTextNodeIndex, buttonStyles, clearHighlights, createHoverHandlers, cssVariables, dispatch401Error, dispatch403Error, dispatchAuthEvent, faviconPaths, formatTime, generateCSSVariables, getResourceIcon, getSelectedShapeForSelectorType, getSelectorType, getShortcutDisplay, getSupportedShapes, hideWidgetPreview, isShapeSupported, jsonLightHighlightStyle, jsonLightTheme, onAuthEvent, resolveAnnotationRanges, sanitizeImageURL, saveSelectedShapeForSelectorType, showWidgetPreview, supportsDetection, toOverlayAnnotations, tokens, useAdmin, useAnnotationManager, useAnnotations, useApiClient, useAttentionStream, useAuthApi, useAuthToken, useBeckonFlow, useBindFlow, useCacheManager, useContextGatherFlow, useDebounce, useDebouncedCallback, useDocumentAnnouncements, useDoubleKeyPress, useDropdown, useEntityTypes, useEventBus, useEventSubscription, useEventSubscriptions, useFormAnnouncements, useGlobalEvents, useHealth, useHoverDelay, useHoverEmitter, useIsTyping, useKeyboardShortcuts, useLanguageChangeAnnouncements, useLineNumbers, useLiveRegion, useLoadingState, useLocalStorage, useMarkFlow, useModeration, useObservable, useObservableExternalNavigation, useObservableRouter, useOpenResources, usePanelBrowse, usePanelWidth, usePreloadTranslations, useResourceAnnotations, useResourceContent, useResourceEvents, useResourceLoadingAnnouncements, useResources, useRovingTabIndex, useSearchAnnouncements, useSessionContext, useSessionExpiry, useStoreTokenSync, useTheme, useToast, useTranslations, useYieldFlow };