@bendyline/squisq-react 2.2.0 → 2.3.0

package/dist/index.d.ts

@@ -1,272 +1,17 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Block, Doc, Theme, SurfaceScheme, Transition, CaptionTrack, ViewportConfig as ViewportConfig$1, ThemePageStyle, ImageLayer as ImageLayer$1, TextLayer as TextLayer$1, ShapeLayer as ShapeLayer$1, PathLayer as PathLayer$1, VideoLayer as VideoLayer$1, TableLayer as TableLayer$1, TreeLayer as TreeLayer$1, MapLayer as MapLayer$1, MermaidLayer as MermaidLayer$1, ScheduledClip, AudioTrack, MediaProvider } from '@bendyline/squisq/schemas';
-import { ViewportConfig, PageTransformHints, PageSectionMaterialization, PageSection, MaterializeBlockLayersOptions, ViewportOrientation } from '@bendyline/squisq/doc';
+import { SquisqRenderAPI } from './player/index.js';
+export { BlockMarker, BlockRenderer, CaptionMode, CaptionOverlay, CaptionStyle, ControlsLayout, DisplayMode, DocControlsBottom, DocControlsOverlay, DocControlsSidebar, DocControlsSlideshow, DocPlayer, DocPlayerProps, DocPlayerWithSidebar, DocProgressBar, InlineAudioPlayer, InlineAudioPlayerProps, InlineVideoPlayer, InlineVideoPlayerProps, MediaClipLayer, MediaClipLayerProps, PlaybackActions, PlaybackState, RenderAudioSegmentInfo, RenderBlockInfo, RenderCaptionInfo, RenderChapterInfo, SlideNavActions, SocialCaptionOverlay, formatTime } from './player/index.js';
+import { Theme } from '@bendyline/squisq/schemas';
+export { MarkdownRenderer, MermaidDiagram, MermaidDiagramProps } from './markdown/index.js';
+export { CanvasSection, CanvasSectionProps, ImageDisplayMode, LinearDocView, LinearDocViewProps, PageSectionView, PageSectionViewProps, PageViewContext, PageViewContextValue, usePageView } from './page/index.js';
+export { ImageLayer, MapLayer, MermaidLayer, PathLayer, ShapeLayer, TableLayer, TextLayer, TreeLayer, VideoLayer } from './layers/index.js';
+export { MediaContext, MediaScheduleController, ModalDialogOptions, ResourcePolicyContext, UseDocPlaybackOptions, useAudioSync, useAutoSurface, useDocPlayback, useMediaProvider, useMediaSchedule, useMediaUrl, useModalDialog, useResourcePolicy, useViewportOrientation } from './hooks/index.js';
+export { A as AudioActions, a as AudioController, b as AudioState } from './AudioController-DwMsPe38.js';
 export { getAnimationStyle, getTransitionClass } from '@bendyline/squisq/doc';
-import { MarkdownBlockNode, HtmlPolicy, ResourcePolicy } from '@bendyline/squisq/markdown';
-import * as react from 'react';
-import { RefObject } from 'react';
-import { SquisqAnnotatedSchema } from '@bendyline/squisq/jsonForm';
-
-/**
- * AudioController - Abstraction for audio playback in DocPlayer
- *
- * This module defines an interface for audio playback operations that can have
- * different implementations depending on the runtime environment:
- *
- * - Site/Browser: Uses HTML5 Audio element directly
- * - EFB/MSFS: Routes through CompanionAPI to Electron app
- *
- * The DocPlayer uses this abstraction instead of directly manipulating audio,
- * allowing the same component code to work in both environments.
- */
-
-interface AudioState {
-    /** Current time in overall timeline (seconds) */
-    currentTime: number;
-    /** Whether audio is currently playing */
-    isPlaying: boolean;
-    /** Index of current audio segment */
-    currentSegment: number;
-    /** Total duration of all segments */
-    totalDuration: number;
-    /** Whether audio has finished */
-    isEnded: boolean;
-    /** Whether audio is loaded and ready to play */
-    isReady: boolean;
-    /** Whether the audio backend is available/connected */
-    isAvailable: boolean;
-    /** Message to show when not available */
-    unavailableMessage?: string;
-}
-interface AudioActions {
-    /** Start or resume playback */
-    play: () => Promise<void>;
-    /** Pause playback */
-    pause: () => Promise<void>;
-    /** Toggle play/pause */
-    toggle: () => Promise<void>;
-    /** Seek to specific time in timeline */
-    seekTo: (time: number) => Promise<void>;
-    /** Skip to specific segment */
-    skipToSegment: (index: number) => Promise<void>;
-    /** Restart from beginning */
-    restart: () => Promise<void>;
-}
-type AudioController = AudioState & AudioActions;
-
-/**
- * Doc Player Control Types
- *
- * Shared type definitions for doc player controls across different
- * layout modes (overlay, sidebar, bottom). These interfaces allow
- * control components to be decoupled from the core DocPlayer.
- *
- * Related Files:
- * - DocPlayer.tsx — Core player component
- * - DocProgressBar.tsx — Extracted progress bar
- * - DocControlsOverlay.tsx — Overlay controls (default)
- * - DocControlsSidebar.tsx — Vertical sidebar controls
- * - DocControlsBottom.tsx — Horizontal bottom strip controls
- */
-
-/** Layout mode for doc player controls */
-type ControlsLayout = 'overlay' | 'sidebar' | 'bottom';
-/**
- * Display mode for DocPlayer.
- *
- * - `'video'` — Traditional video-style playback with play/pause, scrub bar,
- *   and time-based auto-advance. Default mode.
- * - `'slideshow'` — PowerPoint-style presentation with prev/next navigation.
- *   Blocks are treated as static slides that only change on user click.
- *   No auto-advance, no scrub bar.
- * - `'linear'` — Long-scrolling document view. Renders the full markdown as
- *   readable HTML with template-annotated sections shown as inline SVG cards.
- *   No audio, no timeline, no controls — just a scrollable page.
- * - `'page'` — Plain semantic HTML preview matching what the
- *   `markdownDocToPlainHtml` export produces. No SquisqPlayer, no SVG
- *   cards — just `<h1>`/`<p>`/`<ul>` etc. inside a sandboxed iframe.
- *   Use when you want a WYSIWYG view of the simple HTML export.
- * - `'narrate'` — Teleprompter/performance surface. DocPlayer does not
- *   implement this mode; it is owned by the editor package
- *   (`@bendyline/squisq-editor-react`), which renders its own
- *   voice-paced teleprompter view for it.
- */
-type DisplayMode = 'video' | 'slideshow' | 'linear' | 'page' | 'narrate';
-/**
- * Caption display style.
- *
- * - `'standard'` — Traditional broadcast-style captions: small white text
- *   on a semi-transparent black badge at the top of the player.
- * - `'social'` — Social media-style (Instagram/TikTok): large centered words
- *   showing 3-5 words at a time with the active word highlighted in the
- *   theme's primary color. Font and colors pulled from the active theme.
- */
-type CaptionStyle = 'standard' | 'social';
-/**
- * Caption display mode — combines enable/disable with style selection.
- * The CC button cycles through: off → standard → social → off.
- */
-type CaptionMode = 'off' | 'standard' | 'social';
-/** Slide navigation actions for slideshow display mode */
-interface SlideNavActions {
-    /** Navigate to the next slide */
-    nextSlide: () => void;
-    /** Navigate to the previous slide */
-    prevSlide: () => void;
-    /** Navigate to a specific slide by index (0-based) */
-    goToSlide: (index: number) => void;
-}
-/** Playback state exposed to external control components */
-interface PlaybackState$1 {
-    isPlaying: boolean;
-    currentTime: number;
-    totalDuration: number;
-    /** Whether the managed cover is the visual currently shown. */
-    isCoverVisible?: boolean;
-    currentBlockIndex: number;
-    totalBlocks: number;
-    docProgress: number;
-    hasCaptions: boolean;
-    captionsEnabled: boolean;
-    /** Current caption display mode (off, standard, social). */
-    captionMode: CaptionMode;
-    isFullscreen?: boolean;
-    /** Current audio segment index (0-based) */
-    currentSegmentIndex: number;
-    /** Current audio segment name (e.g., 'intro', 'history') */
-    currentSegmentName: string | null;
-    /** Current block data (for extracting image info, etc.) */
-    currentBlock: Block | null;
-    /** Optional display label for non-block slides, e.g. the managed cover. */
-    currentSlideLabel?: string;
-    /** Optional human-facing slide number, separate from internal nav index. */
-    currentSlideNumber?: number;
-    /** Optional human-facing slide total, separate from internal nav total. */
-    totalSlideNumber?: number;
-}
-/** Playback actions exposed to external control components */
-interface PlaybackActions$1 {
-    toggle: () => void;
-    restart: () => void;
-    seekTo: (time: number) => void;
-    setCaptionsEnabled: (enabled: boolean) => void;
-    /** Cycle caption mode: off → standard → social → off */
-    cycleCaptionMode: () => void;
-    toggleFullscreen?: () => void;
-}
-/** Block marker data for the progress bar */
-interface BlockMarker {
-    block: Block;
-    index: number;
-    position: number;
-    title: string;
-    /** True if this block is the first in a new audio segment (section boundary) */
-    isSectionStart: boolean;
-}
-/** Block metadata returned by SquisqRenderAPI.getBlocks() */
-interface RenderBlockInfo {
-    id: string;
-    template: string;
-    startTime: number;
-    duration: number;
-}
-/** Audio segment info returned by SquisqRenderAPI.getAudioSegments() */
-interface RenderAudioSegmentInfo {
-    src: string;
-    name: string;
-    duration: number;
-    startTime: number;
-}
-/** Caption phrase info returned by SquisqRenderAPI.getCaptions() */
-interface RenderCaptionInfo {
-    text: string;
-    startTime: number;
-    endTime: number;
-}
-/** Chapter marker returned by SquisqRenderAPI.getChapters() */
-interface RenderChapterInfo {
-    title: string;
-    startTime: number;
-    duration: number;
-}
-/**
- * Instance-scoped API created in render mode and debug mode.
- * React hosts receive it via `DocPlayer.onRenderAPIReady`; standalone hosts
- * receive it from their mount handle.
- *
- * @example
- * ```ts
- * const handle = SquisqPlayer.getHandle(rootElement);
- * const api = await handle?.renderAPI;
- * await api?.seekTo(5.0);
- * ```
- */
-interface SquisqRenderAPI {
-    seekTo: (time: number) => Promise<void>;
-    getDuration: () => number;
-    getBlocks: () => RenderBlockInfo[];
-    getAudioSegments: () => RenderAudioSegmentInfo[];
-    getCaptions: () => RenderCaptionInfo[];
-    getChapters: () => RenderChapterInfo[];
-    showCover: () => Promise<void>;
-    hideCover: () => Promise<void>;
-    hasCoverBlock: () => boolean;
-}
-/** Format time in seconds to MM:SS string */
-declare function formatTime(seconds: number): string;
-
-interface DocPlayerProps {
-    /** The Doc to play. Wins over `markdown` when both are provided. */
-    doc?: Doc;
-    /** Markdown source to convert when `doc` is absent. */
-    markdown?: string;
-    /** Base path for resolving media URLs (default: `'.'`). */
-    basePath?: string;
-    /** Render mode for deterministic video capture. */
-    renderMode?: boolean;
-    /** Render slide transitions and per-layer animations (default: true). */
-    animationsEnabled?: boolean;
-    /** Receives the instance-scoped render API, and `null` on cleanup. */
-    onRenderAPIReady?: (api: SquisqRenderAPI | null) => void;
-    autoPlay?: boolean;
-    onEnded?: () => void;
-    onTimeUpdate?: (time: number) => void;
-    /** Optional host-owned audio controller. */
-    audioController?: AudioController;
-    /** Explicit synthetic clock for timed documents that intentionally have no audio asset. */
-    audioMode?: 'media' | 'synthetic';
-    showControls?: boolean;
-    showScrubber?: boolean;
-    muted?: boolean;
-    captionsEnabled?: boolean;
-    onCaptionsToggle?: (enabled: boolean) => void;
-    onPlaybackStateChange?: (state: PlaybackState$1) => void;
-    onControlsReady?: (controls: PlaybackActions$1 & {
-        play: () => void;
-        pause: () => void;
-    }) => void;
-    isFullscreen?: boolean;
-    onFullscreenToggle?: () => void;
-    onBlockMarkers?: (markers: BlockMarker[]) => void;
-    forceViewport?: ViewportConfig;
-    theme?: Theme;
-    surface?: SurfaceScheme | 'auto';
-    /** Video, manual slideshow, or long-scrolling linear rendition. */
-    displayMode?: DisplayMode;
-    showCoverSlide?: boolean;
-    coverVisible?: boolean;
-    captionStyle?: CaptionStyle;
-    enableSwipe?: boolean;
-    globalKeyboardShortcuts?: boolean;
-}
-
-/**
- * Front-door component: resolves the `doc` / `markdown` props into a Doc
- * and renders a themed empty state when neither is provided. The playback
- * machinery lives in `DocPlayerContent` so its hook order never changes
- * when a doc appears or disappears.
- */
-declare function DocPlayer(props: DocPlayerProps): react_jsx_runtime.JSX.Element;
+export { JsonView, JsonViewProps } from './json-view/index.js';
+import 'react/jsx-runtime';
+import '@bendyline/squisq/markdown';
+import 'react';
+import '@bendyline/squisq/jsonForm';
 
 /**
  * Standalone Entry Point — IIFE bundle for self-contained HTML rendering.
@@ -342,639 +87,4 @@ interface SquisqPlayerHandle {
     unmount(): void;
 }
 
-/** Viewport configuration type */
-interface ViewportDimensions {
-    width: number;
-    height: number;
-}
-interface BlockRendererProps {
-    /** The block to render */
-    block: Block;
-    /** Current time relative to block start (seconds) */
-    blockTime: number;
-    /** Base path for resolving media URLs */
-    basePath: string;
-    /** Whether this block is entering (for transition) */
-    isEntering?: boolean;
-    /** Whether this block is exiting (for transition) */
-    isExiting?: boolean;
-    /** Transition to apply. Defaults to block.transition. */
-    transition?: Transition;
-    /** Viewport dimensions (defaults to 1920x1080 landscape) */
-    viewport?: ViewportDimensions;
-    /** Whether the doc is currently playing (controls video playback) */
-    isPlaying?: boolean;
-    /**
-     * Whether to render block transitions and layer animations (default: true).
-     * Disabling this only removes authored/render-style motion; timed video
-     * layers continue to advance normally.
-     */
-    animationsEnabled?: boolean;
-}
-declare function BlockRenderer({ block, blockTime, basePath, isEntering, isExiting, transition, viewport, isPlaying, animationsEnabled, }: BlockRendererProps): react_jsx_runtime.JSX.Element;
-
-interface CaptionOverlayProps {
-    /** Caption track with timestamped phrases */
-    captions: CaptionTrack | undefined;
-    /** Current playback time in seconds */
-    currentTime: number;
-    /** Whether captions are enabled */
-    enabled?: boolean;
-    /** Font size in pixels for standard style (default: 16) */
-    fontSize?: number;
-    /** Caption display style (default: 'standard') */
-    captionStyle?: CaptionStyle;
-    /** Theme for social-style caption colors and fonts */
-    theme?: Theme;
-    /** Viewport config for social-style font scaling */
-    viewport?: ViewportConfig$1;
-}
-declare function CaptionOverlay({ captions, currentTime, enabled, fontSize, captionStyle, theme, viewport, }: CaptionOverlayProps): react_jsx_runtime.JSX.Element;
-
-interface SocialCaptionOverlayProps {
-    captions: CaptionTrack | undefined;
-    currentTime: number;
-    enabled?: boolean;
-    theme?: Theme;
-    viewport?: ViewportConfig$1;
-}
-declare function SocialCaptionOverlay({ captions, currentTime, enabled, theme, viewport, }: SocialCaptionOverlayProps): react_jsx_runtime.JSX.Element | null;
-
-interface DocControlsOverlayProps {
-    state: PlaybackState$1;
-    actions: PlaybackActions$1;
-    blockMarkers: BlockMarker[];
-    expandedBlocks: Block[];
-    getBlockTitle?: (block: Block) => string;
-}
-declare function DocControlsOverlay({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocControlsOverlayProps): react_jsx_runtime.JSX.Element;
-
-interface DocControlsBottomProps {
-    state: PlaybackState$1;
-    actions: PlaybackActions$1;
-    blockMarkers: BlockMarker[];
-    expandedBlocks: Block[];
-    getBlockTitle?: (block: Block) => string;
-}
-declare function DocControlsBottom({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocControlsBottomProps): react_jsx_runtime.JSX.Element;
-
-interface DocControlsSidebarProps {
-    state: PlaybackState$1;
-    actions: PlaybackActions$1;
-}
-declare function DocControlsSidebar({ state, actions }: DocControlsSidebarProps): react_jsx_runtime.JSX.Element;
-
-interface SlideshowPickerItem {
-    /** Stable identifier for the slide/block. */
-    id: string;
-    /** Human-facing slide number, or a special label such as "Cover". */
-    label: string;
-    /** Short description shown in the slide picker. */
-    summary: string;
-}
-interface DocControlsSlideshowProps {
-    state: PlaybackState$1;
-    slideNav: SlideNavActions;
-    /** Slides available for direct navigation from the counter popover. */
-    slides?: readonly SlideshowPickerItem[];
-    /** Controlled open state for hosts that expose their own picker shortcut. */
-    pickerOpen?: boolean;
-    /** Called whenever the slide picker should open or close. */
-    onPickerOpenChange?: (open: boolean) => void;
-}
-declare function DocControlsSlideshow({ state, slideNav, slides, pickerOpen, onPickerOpenChange, }: DocControlsSlideshowProps): react_jsx_runtime.JSX.Element;
-
-interface DocPlayerWithSidebarProps {
-    /** The Doc to play */
-    doc: Doc;
-    /** Base path for resolving media URLs (default: `'.'`) */
-    basePath?: string;
-    autoPlay?: boolean;
-    onEnded?: () => void;
-    onTimeUpdate?: (time: number) => void;
-    /** Optional audio controller (if not provided, uses default HTML5 audio) */
-    audioController?: AudioController;
-    /** Whether to render slide transitions and per-layer animations (default: true). */
-    animationsEnabled?: boolean;
-    muted?: boolean;
-    captionsEnabled?: boolean;
-    isFullscreen?: boolean;
-    onFullscreenToggle?: () => void;
-    /** Force a specific viewport preset, bypassing window-based orientation detection. */
-    forceViewport?: ViewportConfig$1;
-    /** Called when playing state changes */
-    onPlayingChange?: (isPlaying: boolean) => void;
-    /**
-     * Theme for rendering. Forwarded to the inner DocPlayer so the sidebar
-     * (portrait) layout matches the default (landscape) layout — without it the
-     * inner player falls back to DEFAULT_THEME, whose dark text is unreadable
-     * over a hero cover image.
-     */
-    theme?: Theme;
-}
-declare function DocPlayerWithSidebar({ doc, basePath, autoPlay, onEnded, onTimeUpdate, audioController, animationsEnabled, muted, captionsEnabled, isFullscreen, onFullscreenToggle, forceViewport, onPlayingChange, theme, }: DocPlayerWithSidebarProps): react_jsx_runtime.JSX.Element;
-
-interface DocProgressBarProps {
-    state: PlaybackState$1;
-    actions: PlaybackActions$1;
-    blockMarkers: BlockMarker[];
-    /** All expanded blocks for hover lookup */
-    expandedBlocks: Block[];
-    /** Optional: get block title for hover tooltip */
-    getBlockTitle?: (block: Block) => string;
-}
-declare function DocProgressBar({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocProgressBarProps): react_jsx_runtime.JSX.Element;
-
-interface MarkdownRendererProps {
-    /** Block-level AST nodes to render */
-    nodes: MarkdownBlockNode[];
-    /** Optional CSS class for the wrapper element */
-    className?: string;
-    /**
-     * Raw HTML policy. Defaults to `sanitize`, which removes unsafe tags,
-     * event handlers, and executable URL schemes before rendering.
-     */
-    htmlPolicy?: HtmlPolicy;
-    /**
-     * Extra URL schemes to allow on links (e.g. a host app's internal
-     * navigation scheme it intercepts on click). Executable schemes are
-     * never allowed regardless. See {@link SanitizeUrlOptions}.
-     */
-    linkSchemes?: readonly string[];
-}
-/**
- * Renders MarkdownBlockNode[] AST as React HTML elements.
- *
- * @example
- * ```tsx
- * <MarkdownRenderer nodes={block.contents} />
- * ```
- */
-declare function MarkdownRenderer({ nodes, className, htmlPolicy, linkSchemes, }: MarkdownRendererProps): react_jsx_runtime.JSX.Element | null;
-
-interface MermaidDiagramProps {
-    source: string;
-    className?: string;
-    ariaLabel?: string;
-}
-/** Read-only Mermaid rendering for page bodies and slide layers. */
-declare function MermaidDiagram({ source, className, ariaLabel, }: MermaidDiagramProps): react_jsx_runtime.JSX.Element;
-
-interface LinearDocViewProps {
-    /**
-     * The Doc to render. Wins over `markdown` when both are provided.
-     * When neither `doc` nor `markdown` is given, an empty container renders.
-     */
-    doc?: Doc;
-    /**
-     * Markdown source to render. When `doc` is absent, the markdown is parsed
-     * and converted to a Doc via `markdownToDoc(parseMarkdown(markdown))`.
-     * Ignored when `doc` is provided.
-     */
-    markdown?: string;
-    /** Base path for resolving media URLs (images, etc.) */
-    basePath?: string;
-    /** Viewport config for embedded SVG canvas sections (default: landscape) */
-    viewport?: ViewportConfig$1;
-    /** Optional CSS class for the outer container */
-    className?: string;
-    /** Theme to use for rendering (default: DEFAULT_THEME from the theme library) */
-    theme?: Theme;
-    /** Whether embedded canvas sections render their layer animations (default: true). */
-    animationsEnabled?: boolean;
-    /**
-     * Optional surface scheme (light / dark paper) overlaid on top of the
-     * theme's colors. Orthogonal to `theme` — a theme picks editorial
-     * identity, a surface picks the paper. Pass `'auto'` to follow the
-     * user's OS `prefers-color-scheme`, a `SurfaceScheme` object to force a
-     * specific surface, or omit to use the theme's built-in colors.
-     */
-    surface?: SurfaceScheme | 'auto';
-    /**
-     * Use tight padding + a hugging layout. The default layout is a full
-     * page with themed section bands. Short conversational snippets like
-     * chat replies benefit from a much tighter layout. Set to `true` to
-     * render with minimal padding so the content hugs its container.
-     */
-    thinMargins?: boolean;
-    /**
-     * How images inside the doc should be sized. `'inline'` (default)
-     * flows them at natural size up to the column width; `'thumbnail'`
-     * constrains each image to a 100×100 box with aspect-preserving
-     * containment — use for chat history and other dense surfaces where
-     * full-size images would dominate the layout.
-     */
-    imageDisplayMode?: ImageDisplayMode;
-    /**
-     * Let unmodified Up/Down arrows scroll this view even when it does not
-     * currently hold focus. Intended for a primary document preview.
-     */
-    globalKeyboardShortcuts?: boolean;
-    /**
-     * Synthesize a hero section from `doc.startBlock` at the top of the
-     * page (default: true). The editor's Cover toggle maps here.
-     */
-    showCover?: boolean;
-    /**
-     * Page hints from the active transform (Summarize) style — spacing and
-     * emphasis-curve adjustments defined by `TransformStyleConfig.page`.
-     */
-    transformPage?: PageTransformHints;
-}
-type ImageDisplayMode = 'inline' | 'thumbnail';
-/**
- * Renders a Doc as a scrolling, theme-art-directed page.
- *
- * @example
- * ```tsx
- * <LinearDocView doc={doc} basePath="/media/" />
- * ```
- */
-declare function LinearDocView({ doc, markdown, basePath, viewport, className, theme, surface, animationsEnabled, thinMargins, imageDisplayMode, globalKeyboardShortcuts, showCover, transformPage, }: LinearDocViewProps): react_jsx_runtime.JSX.Element;
-
-interface PageSectionViewProps {
-    entry: PageSectionMaterialization;
-    /** Alternation flip for feature-split sections (theme `alternate` hint). */
-    featureFlip?: boolean;
-    /** True when this is the doc's lead prose section (drop-cap target). */
-    isLeadProse?: boolean;
-}
-declare function PageSectionView({ entry, featureFlip, isLeadProse }: PageSectionViewProps): react_jsx_runtime.JSX.Element;
-
-interface CanvasSectionProps {
-    section: PageSection;
-}
-declare function CanvasSection({ section }: CanvasSectionProps): react_jsx_runtime.JSX.Element | null;
-
-interface PageViewContextValue {
-    theme: Theme;
-    pageStyle: ThemePageStyle;
-    basePath: string;
-    viewport: ViewportConfig$1;
-    /** Options for `materializeBlockLayers` inside canvas embeds. */
-    renderContext: MaterializeBlockLayersOptions;
-    animationsEnabled: boolean;
-    imageDisplayMode: ImageDisplayMode;
-}
-declare const PageViewContext: react.Context<PageViewContextValue>;
-declare function usePageView(): PageViewContextValue;
-
-interface InlineVideoPlayerProps {
-    /** Source path — resolved through MediaContext when relative. */
-    src: string;
-    /** Base path used when no MediaProvider is in context. */
-    basePath?: string;
-    /** Optional explicit width (pixels or CSS length). */
-    width?: number | string;
-    /** Optional explicit height (pixels or CSS length). */
-    height?: number | string;
-    /** Optional poster image src — also resolved through MediaContext. */
-    poster?: string;
-    /** Whether to show native controls. Defaults to true. */
-    controls?: boolean;
-    /** `preload` attribute passthrough. Defaults to `'metadata'`. */
-    preload?: 'none' | 'metadata' | 'auto';
-    /** Extra className on the wrapper. */
-    className?: string;
-}
-declare function InlineVideoPlayer({ src, basePath, width, height, poster, controls, preload, className, }: InlineVideoPlayerProps): react_jsx_runtime.JSX.Element | null;
-
-interface InlineAudioPlayerProps {
-    /** Source path — resolved through MediaContext when relative. */
-    src: string;
-    /** Base path used when no MediaProvider is in context. */
-    basePath?: string;
-    /** Whether to show native controls. Defaults to true. */
-    controls?: boolean;
-    /** `preload` attribute passthrough. Defaults to `'metadata'`. */
-    preload?: 'none' | 'metadata' | 'auto';
-    /** Extra className on the wrapper. */
-    className?: string;
-}
-declare function InlineAudioPlayer({ src, basePath, controls, preload, className, }: InlineAudioPlayerProps): react_jsx_runtime.JSX.Element | null;
-
-interface ImageLayerProps {
-    layer: ImageLayer$1;
-    /** Base path for resolving relative image URLs */
-    basePath: string;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start (for animation timing) */
-    blockTime: number;
-    /** Whether authored and responsive image motion should run. */
-    animationsEnabled?: boolean;
-}
-declare function ImageLayer({ layer, basePath, viewport, blockTime, animationsEnabled, }: ImageLayerProps): react_jsx_runtime.JSX.Element;
-
-interface TextLayerProps {
-    layer: TextLayer$1;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start */
-    blockTime: number;
-}
-/**
- * Dispatch between the plain SVG-text renderer and the rich HTML renderer
- * based on whether the layer carries `content.html`.
- */
-declare function TextLayer(props: TextLayerProps): react_jsx_runtime.JSX.Element;
-
-interface ShapeLayerProps {
-    layer: ShapeLayer$1;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start */
-    blockTime: number;
-}
-declare function ShapeLayer({ layer, viewport, blockTime }: ShapeLayerProps): react_jsx_runtime.JSX.Element;
-
-interface PathLayerProps {
-    layer: PathLayer$1;
-    /** Viewport dimensions — used to resolve `%` positions for named shapes. */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start. */
-    blockTime: number;
-}
-declare function PathLayer({ layer, viewport, blockTime }: PathLayerProps): react_jsx_runtime.JSX.Element;
-
-interface VideoLayerProps {
-    layer: VideoLayer$1;
-    /** Base path for resolving relative video URLs */
-    basePath: string;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start (for playback sync) */
-    blockTime: number;
-    /** Whether the doc is currently playing */
-    isPlaying?: boolean;
-}
-declare function VideoLayer({ layer, basePath, viewport, blockTime, isPlaying }: VideoLayerProps): react_jsx_runtime.JSX.Element;
-
-interface TableLayerProps {
-    layer: TableLayer$1;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start (for animation) */
-    blockTime: number;
-}
-declare function TableLayer({ layer, viewport, blockTime }: TableLayerProps): react_jsx_runtime.JSX.Element;
-
-interface TreeLayerProps {
-    layer: TreeLayer$1;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    blockTime: number;
-}
-declare function TreeLayer({ layer, viewport, blockTime }: TreeLayerProps): react_jsx_runtime.JSX.Element;
-
-interface MapLayerProps {
-    layer: MapLayer$1;
-    /** Base path for resolving relative image URLs */
-    basePath: string;
-    /** Viewport dimensions for percentage calculations */
-    viewport: {
-        width: number;
-        height: number;
-    };
-    /** Current time relative to block start (for animation timing) */
-    blockTime: number;
-}
-declare function MapLayer({ layer, basePath, viewport, blockTime }: MapLayerProps): react_jsx_runtime.JSX.Element;
-
-interface MermaidLayerProps {
-    layer: MermaidLayer$1;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    blockTime: number;
-}
-/** Mermaid diagram hosted in HTML inside the slide SVG. */
-declare function MermaidLayer({ layer, viewport, blockTime }: MermaidLayerProps): react_jsx_runtime.JSX.Element;
-
-interface MediaClipLayerProps {
-    schedule: ScheduledClip[];
-    currentTime: number;
-    isPlaying: boolean;
-    basePath: string;
-    renderMode?: boolean;
-    /** Silence every scheduled clip during live playback. */
-    muted?: boolean;
-}
-declare function MediaClipLayer({ schedule, currentTime, isPlaying, basePath, renderMode, muted, }: MediaClipLayerProps): react_jsx_runtime.JSX.Element | null;
-
-/**
- * useAudioSync Hook
- *
- * Synchronizes playback state with an audio element. Provides current
- * playback time, playing state, and methods to control audio playback.
- *
- * Handles multiple audio segments (MP3 files) by tracking which segment
- * is currently playing and calculating the overall timeline position.
- *
- * This is the HTML5 Audio implementation of the AudioController interface.
- * Hosts that drive audio through an external player (e.g. a native shell)
- * can supply their own AudioController to DocPlayer instead of this hook.
- */
-
-type AudioSyncMode = 'media' | 'synthetic';
-declare function useAudioSync(audioRef: RefObject<HTMLAudioElement>, audioTrack: AudioTrack | undefined, basePath?: string, enabled?: boolean, mode?: AudioSyncMode): AudioController;
-
-interface ModalDialogOptions {
-    /** The backdrop/portal root. Siblings of this branch are made inert. */
-    rootRef: RefObject<HTMLElement | null>;
-    /** The element with `role="dialog"`; focus is trapped within it. */
-    dialogRef: RefObject<HTMLElement | null>;
-    initialFocusRef?: RefObject<HTMLElement | null>;
-    /** Explicit opener/owner to restore after unmount (important when a child uses autofocus). */
-    returnFocusRef?: RefObject<HTMLElement | null>;
-    onClose: () => void;
-}
-/** Shared focus, keyboard, background-isolation, and restoration behavior for modal dialogs. */
-declare function useModalDialog({ rootRef, dialogRef, initialFocusRef, returnFocusRef, onClose, }: ModalDialogOptions): void;
-
-/**
- * useMediaSchedule
- *
- * Pure follower of the playback clock for the media-clip model. Given the
- * resolved {@link ScheduledClip}s and the current time, it returns the clips
- * the player should mount and which of them are active right now.
- * {@link MediaClipLayer} consumes this to drive one hidden `<audio>` /
- * full-bleed `<video>` element per clip. (Annotation-authored clips all render
- * at the player level; template-produced `VideoLayer`s are a separate path and
- * are not part of the schedule.)
- *
- * It owns no clock: `currentTime`/`isPlaying` come from the existing
- * `useAudioSync` provider via `DocPlayer`. With an empty schedule it returns
- * empty lists, so documents without the new media model are unaffected.
- */
-
-interface MediaScheduleController {
-    /** Clips the player mounts (every scheduled clip). */
-    renderClips: ScheduledClip[];
-    /** Ids of clips whose [absoluteStart, absoluteEnd) contains currentTime. */
-    activeIds: Set<string>;
-}
-declare function useMediaSchedule(schedule: ScheduledClip[], currentTime: number): MediaScheduleController;
-
-/**
- * useDocPlayback Hook
- *
- * Manages the playback state for a visual doc, including which block
- * is currently active, transition states, and synchronization with audio.
- *
- * This hook provides:
- * - Current block determination based on time
- * - Transition tracking (entering/exiting blocks)
- * - Manual navigation (next/prev block)
- * - Time-based seeking
- * - Automatic expansion of template blocks
- */
-
-interface PlaybackState {
-    /** Currently visible block */
-    currentBlock: Block | null;
-    /** Index of current block */
-    currentBlockIndex: number;
-    /** Previous block (for transitions) */
-    previousBlock: Block | null;
-    /** Whether current block is entering */
-    isEntering: boolean;
-    /** Whether previous block is exiting */
-    isExiting: boolean;
-    /** Time relative to current block start */
-    blockTime: number;
-    /** Progress through current block (0-1) */
-    blockProgress: number;
-    /** Overall progress through doc (0-1) */
-    docProgress: number;
-    /** Expanded blocks (templates converted to full blocks with layers) */
-    blocks: Block[];
-}
-interface PlaybackActions {
-    /** Go to next block */
-    nextBlock: () => void;
-    /** Go to previous block */
-    prevBlock: () => void;
-    /** Go to specific block by index */
-    goToBlock: (index: number) => void;
-    /**
-     * Let the identified block enter without remounting the outgoing block.
-     * Used when another interaction (such as a swipe) already removed it.
-     */
-    suppressOutgoingForNextBlock: (blockId: string) => void;
-}
-interface UseDocPlaybackOptions {
-    /** Target viewport used to materialize template blocks. */
-    viewport?: ViewportConfig;
-    /** Active theme used for materialization and transition defaults. */
-    theme?: Theme;
-    /** Host seek callback used by block navigation actions. */
-    onSeek?: (time: number) => void;
-}
-declare function useDocPlayback(script: Doc | null, currentTime: number, options?: UseDocPlaybackOptions): PlaybackState & PlaybackActions;
-
-/**
- * useViewportOrientation Hook
- *
- * Detects the current viewport orientation and returns the appropriate
- * VIEWPORT_PRESET for rendering docs. Automatically updates when
- * the window is resized.
- *
- * Thresholds:
- * - Portrait: height > width * 1.2 (significantly taller than wide)
- * - Square: width and height within 20% of each other
- * - Landscape: width > height * 1.2 (significantly wider than tall)
- */
-
-interface UseViewportOrientationResult {
-    /** Current viewport preset configuration */
-    viewport: ViewportConfig;
-    /** Current orientation name */
-    orientation: ViewportOrientation;
-    /** Current window dimensions */
-    windowSize: {
-        width: number;
-        height: number;
-    };
-}
-/**
- * Hook to detect viewport orientation and return appropriate preset.
- * Updates automatically when window is resized.
- */
-declare function useViewportOrientation(): UseViewportOrientationResult;
-
-/**
- * React context holding the current MediaProvider (or null if none provided).
- */
-declare const MediaContext: react.Context<MediaProvider | null>;
-/**
- * Policy for document-controlled media URLs. Hosts rendering untrusted
- * documents can provide `LOCAL_ONLY_RESOURCE_POLICY` or an explicit host
- * allow-list without changing their MediaProvider.
- */
-declare const ResourcePolicyContext: react.Context<ResourcePolicy>;
-declare function useResourcePolicy(): ResourcePolicy;
-/**
- * Hook to access the current MediaProvider from context.
- * Returns null if no provider is set.
- */
-declare function useMediaProvider(): MediaProvider | null;
-/**
- * Hook to resolve a media URL via the MediaProvider (if available),
- * falling back to basePath-based resolution.
- *
- * Returns the resolved URL string. Updates when the provider or path changes.
- *
- * @param relativePath - Relative media path from the document (e.g., 'hero.jpg')
- * @param basePath - Fallback base path for URL construction
- */
-declare function useMediaUrl(relativePath: string, basePath: string): string;
-
-/**
- * Live-track `prefers-color-scheme` and return a stable SurfaceScheme.
- * `enabled: false` short-circuits to LIGHT_SURFACE (callers pass `false`
- * when a static surface was provided so the hook never observes the
- * media query). The `MediaQueryList` and the `subscribe`/`getSnapshot`
- * callbacks are memoized so `useSyncExternalStore` doesn't resubscribe on
- * every parent render.
- */
-declare function useAutoSurface(enabled: boolean): SurfaceScheme;
-
-interface JsonViewProps {
-    /** Schema describing the value's shape (with optional `squisq` UI hints). */
-    schema: SquisqAnnotatedSchema;
-    /** The value to display. */
-    value: unknown;
-    /** Optional theme. Defaults to `DEFAULT_THEME`. */
-    theme?: Theme;
-    /** Light/dark surface override; `'auto'` follows `prefers-color-scheme`. */
-    surface?: SurfaceScheme | 'auto';
-    /** Padding/gap density. Default: 'comfortable'. */
-    density?: 'comfortable' | 'compact';
-    /** Optional CSS class for the outer container. */
-    className?: string;
-}
-declare function JsonView(props: JsonViewProps): react_jsx_runtime.JSX.Element;
-
-export { type AudioActions, type AudioController, type AudioState, type BlockMarker, BlockRenderer, CanvasSection, type CanvasSectionProps, type CaptionMode, CaptionOverlay, type CaptionStyle, type ControlsLayout, type DisplayMode, DocControlsBottom, DocControlsOverlay, DocControlsSidebar, DocControlsSlideshow, DocPlayer, type DocPlayerProps, DocPlayerWithSidebar, DocProgressBar, type ImageDisplayMode, ImageLayer, InlineAudioPlayer, type InlineAudioPlayerProps, InlineVideoPlayer, type InlineVideoPlayerProps, JsonView, type JsonViewProps, LinearDocView, type LinearDocViewProps, MapLayer, MarkdownRenderer, MediaClipLayer, type MediaClipLayerProps, MediaContext, type MediaScheduleController, MermaidDiagram, type MermaidDiagramProps, MermaidLayer, type ModalDialogOptions, type MountOptions, PageSectionView, type PageSectionViewProps, PageViewContext, type PageViewContextValue, PathLayer, type PlaybackActions$1 as PlaybackActions, type PlaybackState$1 as PlaybackState, type RenderAudioSegmentInfo, type RenderBlockInfo, type RenderCaptionInfo, type RenderChapterInfo, ResourcePolicyContext, ShapeLayer, type SlideNavActions, SocialCaptionOverlay, type SquisqPlayerHandle, type SquisqRenderAPI, TableLayer, TextLayer, TreeLayer, type UseDocPlaybackOptions, VideoLayer, formatTime, useAudioSync, useAutoSurface, useDocPlayback, useMediaProvider, useMediaSchedule, useMediaUrl, useModalDialog, usePageView, useResourcePolicy, useViewportOrientation };
+export { type MountOptions, type SquisqPlayerHandle, SquisqRenderAPI };