@bendyline/squisq-react 0.1.3 → 1.0.1

package/dist/BlockRenderer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * BlockRenderer Component
+ *
+ * Renders a single block as an SVG element with all its layers.
+ * Each layer is rendered back-to-front (first layer is background).
+ * Handles positioning, animations, and transitions.
+ */
+import type { Block } from '@bendyline/squisq/schemas';
+/** Default viewport dimensions (1080p landscape) - for backwards compatibility */
+export declare const VIEWPORT: {
+    width: number;
+    height: number;
+};
+/** Viewport configuration type */
+export 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;
+    /** Viewport dimensions (defaults to 1920x1080 landscape) */
+    viewport?: ViewportDimensions;
+    /** Whether the doc is currently playing (controls video playback) */
+    isPlaying?: boolean;
+}
+export declare function BlockRenderer({ block, blockTime, basePath, isEntering, isExiting, viewport, isPlaying, }: BlockRendererProps): import("react/jsx-runtime").JSX.Element;
+export default BlockRenderer;
+//# sourceMappingURL=BlockRenderer.d.ts.map

package/dist/BlockRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockRenderer.d.ts","sourceRoot":"","sources":["../src/BlockRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,2BAA2B,CAAC;AAQ9D,kFAAkF;AAElF,eAAO,MAAM,QAAQ;;;CAGpB,CAAC;AAEF,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,QAAQ,EACR,UAAkB,EAClB,SAAiB,EACjB,QAAmB,EACnB,SAAS,GACV,EAAE,kBAAkB,2CAgDpB;AA2CD,eAAe,aAAa,CAAC"}

package/dist/BlockRenderer.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ImageLayer } from './layers/ImageLayer';
+import { TextLayer } from './layers/TextLayer';
+import { ShapeLayer } from './layers/ShapeLayer';
+import { MapLayer } from './layers/MapLayer';
+import { VideoLayer } from './layers/VideoLayer';
+import { getTransitionClass } from './utils/animationUtils';
+/** Default viewport dimensions (1080p landscape) - for backwards compatibility */
+// eslint-disable-next-line react-refresh/only-export-components
+export const VIEWPORT = {
+    width: 1920,
+    height: 1080,
+};
+export function BlockRenderer({ block, blockTime, basePath, isEntering = false, isExiting = false, viewport = VIEWPORT, isPlaying, }) {
+    // Build transition class and inline style for dynamic duration
+    let transitionClass = '';
+    const transitionStyle = {};
+    if (block.transition && isEntering) {
+        transitionClass = getTransitionClass(block.transition.type, true);
+        transitionStyle['--transition-duration'] = `${block.transition.duration}s`;
+    }
+    else if (block.transition && isExiting) {
+        transitionClass = getTransitionClass(block.transition.type, false);
+        transitionStyle['--transition-duration'] = `${block.transition.duration}s`;
+    }
+    // Unique clip path ID per block to avoid conflicts when multiple blocks render simultaneously
+    const clipId = `vb-clip-${block.id}`;
+    return (_jsxs("svg", { className: `block-svg ${transitionClass}`, style: transitionStyle, viewBox: `0 0 ${viewport.width} ${viewport.height}`, preserveAspectRatio: "xMidYMid meet", overflow: "hidden", "data-block-id": block.id, children: [_jsx("defs", { children: _jsx("clipPath", { id: clipId, children: _jsx("rect", { x: "0", y: "0", width: viewport.width, height: viewport.height }) }) }), _jsx("g", { clipPath: `url(#${clipId})`, children: (block.layers ?? []).map((layer) => (_jsx(LayerRenderer, { layer: layer, basePath: basePath, viewport: viewport, blockTime: blockTime, isPlaying: isPlaying }, layer.id))) })] }));
+}
+/**
+ * Dispatch to the appropriate layer component based on type.
+ */
+function LayerRenderer({ layer, basePath, viewport, blockTime, isPlaying }) {
+    switch (layer.type) {
+        case 'image':
+            return (_jsx(ImageLayer, { layer: layer, basePath: basePath, viewport: viewport, blockTime: blockTime }));
+        case 'text':
+            return _jsx(TextLayer, { layer: layer, viewport: viewport, blockTime: blockTime });
+        case 'shape':
+            return _jsx(ShapeLayer, { layer: layer, viewport: viewport, blockTime: blockTime });
+        case 'map':
+            return (_jsx(MapLayer, { layer: layer, basePath: basePath, viewport: viewport, blockTime: blockTime }));
+        case 'video':
+            return (_jsx(VideoLayer, { layer: layer, basePath: basePath, viewport: viewport, blockTime: blockTime, isPlaying: isPlaying }));
+        default:
+            console.warn(`Unknown layer type: ${layer.type}`);
+            return null;
+    }
+}
+export default BlockRenderer;
+//# sourceMappingURL=BlockRenderer.js.map

package/dist/BlockRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockRenderer.js","sourceRoot":"","sources":["../src/BlockRenderer.tsx"],"names":[],"mappings":"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"}

package/dist/CaptionOverlay.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CaptionOverlay Component
+ *
+ * Displays closed captions synchronized with audio playback.
+ * Captions cross-fade smoothly using CSS transitions on a single
+ * persistent element (no mount/unmount flicker).
+ *
+ * The captions are generated by the postprocess-doc command based
+ * on article text and audio segment timing.
+ */
+import type { CaptionTrack } from '@bendyline/squisq/schemas';
+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 (default: 16) */
+    fontSize?: number;
+}
+export declare function CaptionOverlay({ captions, currentTime, enabled, fontSize, }: CaptionOverlayProps): import("react/jsx-runtime").JSX.Element;
+export default CaptionOverlay;
+//# sourceMappingURL=CaptionOverlay.d.ts.map

package/dist/CaptionOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionOverlay.d.ts","sourceRoot":"","sources":["../src/CaptionOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,UAAU,mBAAmB;IAC3B,6CAA6C;IAC7C,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAW,EACX,OAAc,EACd,QAAa,GACd,EAAE,mBAAmB,2CAqDrB;AAED,eAAe,cAAc,CAAC"}

package/dist/CaptionOverlay.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getCaptionAtTime } from '@bendyline/squisq/schemas';
+export function CaptionOverlay({ captions, currentTime, enabled = true, fontSize = 16, }) {
+    // Derive caption directly from currentTime -- pure computation, no hooks.
+    // This avoids race conditions between timeupdate events and async state updates.
+    const phrase = enabled && captions ? getCaptionAtTime(captions, currentTime) : null;
+    const captionText = phrase?.text ?? null;
+    return (_jsx("div", { className: "caption-overlay", style: {
+            position: 'absolute',
+            top: '6px',
+            left: '50%',
+            transform: 'translateX(-50%)',
+            zIndex: 50,
+            pointerEvents: 'none',
+            maxWidth: '100%',
+            width: '100%',
+            textAlign: 'center',
+            opacity: captionText ? 1 : 0,
+            transition: 'opacity 0.15s ease-in-out',
+            padding: '0 4px',
+            boxSizing: 'border-box',
+        }, children: captionText && (_jsx("div", { style: {
+                display: 'inline-block',
+                padding: '3px 10px',
+                background: 'rgba(0, 0, 0, 0.65)',
+                borderRadius: '4px',
+                backdropFilter: 'blur(4px)',
+            }, children: _jsx("span", { style: {
+                    color: '#ffffff',
+                    fontSize: `${fontSize}px`,
+                    fontFamily: "'Hanken Grotesk', system-ui, sans-serif",
+                    fontWeight: 500,
+                    lineHeight: 1.25,
+                    textShadow: '0 1px 3px rgba(0,0,0,0.5)',
+                    whiteSpace: 'pre-wrap',
+                    wordWrap: 'break-word',
+                }, children: captionText }) })) }));
+}
+export default CaptionOverlay;
+//# sourceMappingURL=CaptionOverlay.js.map

package/dist/CaptionOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaptionOverlay.js","sourceRoot":"","sources":["../src/CaptionOverlay.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAa7D,MAAM,UAAU,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAW,EACX,OAAO,GAAG,IAAI,EACd,QAAQ,GAAG,EAAE,GACO;IACpB,0EAA0E;IAC1E,iFAAiF;IACjF,MAAM,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,MAAM,WAAW,GAAG,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;IAEzC,OAAO,CACL,cACE,SAAS,EAAC,iBAAiB,EAC3B,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE,EAAE;YACV,aAAa,EAAE,MAAM;YACrB,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,UAAU,EAAE,2BAA2B;YACvC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,YAAY;SACxB,YAEA,WAAW,IAAI,CACd,cACE,KAAK,EAAE;gBACL,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,qBAAqB;gBACjC,YAAY,EAAE,KAAK;gBACnB,cAAc,EAAE,WAAW;aAC5B,YAED,eACE,KAAK,EAAE;oBACL,KAAK,EAAE,SAAS;oBAChB,QAAQ,EAAE,GAAG,QAAQ,IAAI;oBACzB,UAAU,EAAE,yCAAyC;oBACrD,UAAU,EAAE,GAAG;oBACf,UAAU,EAAE,IAAI;oBAChB,UAAU,EAAE,2BAA2B;oBACvC,UAAU,EAAE,UAAU;oBACtB,QAAQ,EAAE,YAAY;iBACvB,YAEA,WAAW,GACP,GACH,CACP,GACG,CACP,CAAC;AACJ,CAAC;AAED,eAAe,cAAc,CAAC"}

package/dist/DocControlsBottom.d.ts

@@ -0,0 +1,28 @@
+/**
+ * DocControlsBottom Component
+ *
+ * Horizontal control strip that renders below the doc player video.
+ * An alternative to the overlay for landscape mode -- controls sit in a
+ * separate bar below the video instead of overlapping the content.
+ *
+ * Contains: restart, play/pause, time display, progress bar, segment
+ * indicator, CC toggle. Same controls as the overlay but in an external bar.
+ *
+ * Related Files:
+ * - DocControlsOverlay.tsx -- Overlay variant (default landscape)
+ * - DocControlsSidebar.tsx -- Sidebar variant (portrait)
+ * - DocProgressBar.tsx -- Shared progress bar component
+ * - types.ts -- PlaybackState/PlaybackActions interfaces
+ */
+import type { PlaybackState, PlaybackActions, BlockMarker } from './types';
+import type { Block } from '@bendyline/squisq/schemas';
+interface DocControlsBottomProps {
+    state: PlaybackState;
+    actions: PlaybackActions;
+    blockMarkers: BlockMarker[];
+    expandedBlocks: Block[];
+    getBlockTitle?: (block: Block) => string;
+}
+export declare function DocControlsBottom({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocControlsBottomProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocControlsBottom.d.ts.map

package/dist/DocControlsBottom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsBottom.d.ts","sourceRoot":"","sources":["../src/DocControlsBottom.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,UAAU,sBAAsB;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,KAAK,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,GACd,EAAE,sBAAsB,2CAkExB"}

package/dist/DocControlsBottom.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DocControlsBottom Component
+ *
+ * Horizontal control strip that renders below the doc player video.
+ * An alternative to the overlay for landscape mode -- controls sit in a
+ * separate bar below the video instead of overlapping the content.
+ *
+ * Contains: restart, play/pause, time display, progress bar, segment
+ * indicator, CC toggle. Same controls as the overlay but in an external bar.
+ *
+ * Related Files:
+ * - DocControlsOverlay.tsx -- Overlay variant (default landscape)
+ * - DocControlsSidebar.tsx -- Sidebar variant (portrait)
+ * - DocProgressBar.tsx -- Shared progress bar component
+ * - types.ts -- PlaybackState/PlaybackActions interfaces
+ */
+import { DocProgressBar } from './DocProgressBar';
+import { formatTime } from './types';
+export function DocControlsBottom({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }) {
+    return (_jsxs("div", { className: "doc-controls-bottom", children: [_jsx("button", { className: "bottom-ctrl-btn", onClick: actions.restart, title: "Restart", "aria-label": "Restart from beginning", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M12 5V1L7 6l5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6H4c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z" }) }) }), _jsx("button", { className: "bottom-ctrl-btn bottom-play-btn", onClick: actions.toggle, "aria-label": state.isPlaying ? 'Pause' : 'Play', children: state.isPlaying ? (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M6 19h4V5H6v14zm8-14v14h4V5h-4z" }) })) : (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M8 5v14l11-7z" }) })) }), _jsxs("span", { className: "bottom-time", children: [formatTime(state.currentTime), " / ", formatTime(state.totalDuration)] }), _jsx(DocProgressBar, { state: state, actions: actions, blockMarkers: blockMarkers, expandedBlocks: expandedBlocks, getBlockTitle: getBlockTitle }), _jsxs("span", { className: "bottom-segment", children: [state.currentBlockIndex + 1, "/", state.totalBlocks] }), state.hasCaptions && (_jsx("button", { className: `bottom-ctrl-btn ${state.captionsEnabled ? 'bottom-ctrl-btn--active' : ''}`, onClick: () => actions.setCaptionsEnabled(!state.captionsEnabled), title: state.captionsEnabled ? 'Hide captions' : 'Show captions', "aria-label": state.captionsEnabled ? 'Hide captions' : 'Show captions', children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M19 4H5a2 2 0 00-2 2v12a2 2 0 002 2h14a2 2 0 002-2V6a2 2 0 00-2-2zm-8 7H9.5v-.5h-2v3h2V13H11v1a1 1 0 01-1 1H7a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1zm7 0h-1.5v-.5h-2v3h2V13H18v1a1 1 0 01-1 1h-3a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1z" }) }) }))] }));
+}
+//# sourceMappingURL=DocControlsBottom.js.map

package/dist/DocControlsBottom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsBottom.js","sourceRoot":"","sources":["../src/DocControlsBottom.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAWrC,MAAM,UAAU,iBAAiB,CAAC,EAChC,KAAK,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,GACU;IACvB,OAAO,CACL,eAAK,SAAS,EAAC,qBAAqB,aAElC,iBACE,SAAS,EAAC,iBAAiB,EAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAC,SAAS,gBACJ,wBAAwB,YAEnC,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,uGAAuG,GAAG,GAC9G,GACC,EAGT,iBACE,SAAS,EAAC,iCAAiC,EAC3C,OAAO,EAAE,OAAO,CAAC,MAAM,gBACX,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,YAE7C,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CACjB,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,iCAAiC,GAAG,GACxC,CACP,CAAC,CAAC,CAAC,CACF,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,eAAe,GAAG,GACtB,CACP,GACM,EAGT,gBAAM,SAAS,EAAC,aAAa,aAC1B,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,SAAK,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,IAC7D,EAGP,KAAC,cAAc,IACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,GAC5B,EAGF,gBAAM,SAAS,EAAC,gBAAgB,aAC7B,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAG,KAAK,CAAC,WAAW,IAC3C,EAGN,KAAK,CAAC,WAAW,IAAI,CACpB,iBACE,SAAS,EAAE,mBAAmB,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,EACtF,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EACjE,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,gBACpD,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,YAErE,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,qPAAqP,GAAG,GAC5P,GACC,CACV,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/DocControlsOverlay.d.ts

@@ -0,0 +1,28 @@
+/**
+ * DocControlsOverlay Component
+ *
+ * The default overlay controls that render at the bottom of the doc player
+ * video with a gradient background. Contains all playback controls: restart,
+ * play/pause, time display, progress bar with block markers, segment indicator,
+ * and caption toggle.
+ *
+ * This is the original control layout extracted from DocPlayer. It's used
+ * for the 'overlay' controls layout mode (Flow mode, landscape default).
+ *
+ * Related Files:
+ * - DocPlayer.tsx -- Parent component
+ * - DocProgressBar.tsx -- Progress bar sub-component
+ * - types.ts -- Shared type definitions
+ */
+import type { PlaybackState, PlaybackActions, BlockMarker } from './types';
+import type { Block } from '@bendyline/squisq/schemas';
+interface DocControlsOverlayProps {
+    state: PlaybackState;
+    actions: PlaybackActions;
+    blockMarkers: BlockMarker[];
+    expandedBlocks: Block[];
+    getBlockTitle?: (block: Block) => string;
+}
+export declare function DocControlsOverlay({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocControlsOverlayProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocControlsOverlay.d.ts.map

package/dist/DocControlsOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsOverlay.d.ts","sourceRoot":"","sources":["../src/DocControlsOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,KAAK,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CAC1C;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,GACd,EAAE,uBAAuB,2CA6IzB"}

package/dist/DocControlsOverlay.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DocControlsOverlay Component
+ *
+ * The default overlay controls that render at the bottom of the doc player
+ * video with a gradient background. Contains all playback controls: restart,
+ * play/pause, time display, progress bar with block markers, segment indicator,
+ * and caption toggle.
+ *
+ * This is the original control layout extracted from DocPlayer. It's used
+ * for the 'overlay' controls layout mode (Flow mode, landscape default).
+ *
+ * Related Files:
+ * - DocPlayer.tsx -- Parent component
+ * - DocProgressBar.tsx -- Progress bar sub-component
+ * - types.ts -- Shared type definitions
+ */
+import { DocProgressBar } from './DocProgressBar';
+import { formatTime } from './types';
+export function DocControlsOverlay({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }) {
+    return (_jsxs("div", { className: "doc-player__controls", style: {
+            position: 'absolute',
+            bottom: 0,
+            left: 0,
+            right: 0,
+            padding: '12px 16px',
+            background: 'linear-gradient(transparent, rgba(0,0,0,0.8))',
+            display: 'flex',
+            alignItems: 'center',
+            gap: '8px',
+            zIndex: 100,
+        }, children: [_jsx("button", { onClick: actions.restart, style: {
+                    background: 'none',
+                    border: 'none',
+                    color: 'rgba(255,255,255,0.7)',
+                    cursor: 'pointer',
+                    padding: '8px',
+                    fontSize: '14px',
+                    display: 'flex',
+                    alignItems: 'center',
+                }, title: "Restart", "aria-label": "Restart from beginning", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M12 5V1L7 6l5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6H4c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z" }) }) }), _jsx("button", { onClick: actions.toggle, style: {
+                    background: 'rgba(255,255,255,0.2)',
+                    border: 'none',
+                    borderRadius: '50%',
+                    color: 'white',
+                    cursor: 'pointer',
+                    padding: '10px',
+                    fontSize: '16px',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    width: '40px',
+                    height: '40px',
+                }, "aria-label": state.isPlaying ? 'Pause' : 'Play', children: state.isPlaying ? (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M6 19h4V5H6v14zm8-14v14h4V5h-4z" }) })) : (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M8 5v14l11-7z" }) })) }), _jsxs("span", { style: { color: 'white', fontSize: '12px', minWidth: '80px', fontFamily: 'monospace' }, children: [formatTime(state.currentTime), " / ", formatTime(state.totalDuration)] }), _jsx(DocProgressBar, { state: state, actions: actions, blockMarkers: blockMarkers, expandedBlocks: expandedBlocks, getBlockTitle: getBlockTitle }), _jsxs("span", { style: { color: 'rgba(255,255,255,0.5)', fontSize: '11px', whiteSpace: 'nowrap' }, children: [state.currentBlockIndex + 1, "/", state.totalBlocks] }), state.hasCaptions && (_jsx("button", { onClick: () => actions.setCaptionsEnabled(!state.captionsEnabled), style: {
+                    background: state.captionsEnabled ? 'rgba(255,255,255,0.2)' : 'none',
+                    border: 'none',
+                    color: state.captionsEnabled ? 'white' : 'rgba(255,255,255,0.5)',
+                    cursor: 'pointer',
+                    padding: '8px',
+                    fontSize: '12px',
+                    display: 'flex',
+                    alignItems: 'center',
+                    borderRadius: '4px',
+                }, title: state.captionsEnabled ? 'Hide captions' : 'Show captions', "aria-label": state.captionsEnabled ? 'Hide captions' : 'Show captions', children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M19 4H5a2 2 0 00-2 2v12a2 2 0 002 2h14a2 2 0 002-2V6a2 2 0 00-2-2zm-8 7H9.5v-.5h-2v3h2V13H11v1a1 1 0 01-1 1H7a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1zm7 0h-1.5v-.5h-2v3h2V13H18v1a1 1 0 01-1 1h-3a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1z" }) }) })), actions.toggleFullscreen && (_jsx("button", { onClick: actions.toggleFullscreen, style: {
+                    background: state.isFullscreen ? 'rgba(255,255,255,0.2)' : 'none',
+                    border: 'none',
+                    color: state.isFullscreen ? 'white' : 'rgba(255,255,255,0.5)',
+                    cursor: 'pointer',
+                    padding: '8px',
+                    display: 'flex',
+                    alignItems: 'center',
+                    borderRadius: '4px',
+                }, title: state.isFullscreen ? 'Exit fullscreen (F)' : 'Fullscreen (F)', "aria-label": state.isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen', children: state.isFullscreen ? (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M5 16h3v3h2v-5H5v2zm3-8H5v2h5V5H8v3zm6 11h2v-3h3v-2h-5v5zm2-11V5h-2v5h5V8h-3z" }) })) : (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M7 14H5v5h5v-2H7v-3zm-2-4h2V7h3V5H5v5zm12 7h-3v2h5v-5h-2v3zM14 5v2h3v3h2V5h-5z" }) })) }))] }));
+}
+//# sourceMappingURL=DocControlsOverlay.js.map

package/dist/DocControlsOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsOverlay.js","sourceRoot":"","sources":["../src/DocControlsOverlay.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAWrC,MAAM,UAAU,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,GACW;IACxB,OAAO,CACL,eACE,SAAS,EAAC,sBAAsB,EAChC,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,+CAA+C;YAC3D,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,QAAQ;YACpB,GAAG,EAAE,KAAK;YACV,MAAM,EAAE,GAAG;SACZ,aAGD,iBACE,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE;oBACL,UAAU,EAAE,MAAM;oBAClB,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,uBAAuB;oBAC9B,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;iBACrB,EACD,KAAK,EAAC,SAAS,gBACJ,wBAAwB,YAEnC,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,uGAAuG,GAAG,GAC9G,GACC,EAGT,iBACE,OAAO,EAAE,OAAO,CAAC,MAAM,EACvB,KAAK,EAAE;oBACL,UAAU,EAAE,uBAAuB;oBACnC,MAAM,EAAE,MAAM;oBACd,YAAY,EAAE,KAAK;oBACnB,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;oBACpB,cAAc,EAAE,QAAQ;oBACxB,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,MAAM;iBACf,gBACW,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,YAE7C,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CACjB,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,iCAAiC,GAAG,GACxC,CACP,CAAC,CAAC,CAAC,CACF,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,eAAe,GAAG,GACtB,CACP,GACM,EAGT,gBAAM,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,aACzF,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,SAAK,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,IAC7D,EAGP,KAAC,cAAc,IACb,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,GAC5B,EAGF,gBAAM,KAAK,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aACpF,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAG,KAAK,CAAC,WAAW,IAC3C,EAGN,KAAK,CAAC,WAAW,IAAI,CACpB,iBACE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EACjE,KAAK,EAAE;oBACL,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM;oBACpE,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;oBAChE,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;oBACpB,YAAY,EAAE,KAAK;iBACpB,EACD,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,gBACpD,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,YAErE,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,qPAAqP,GAAG,GAC5P,GACC,CACV,EAGA,OAAO,CAAC,gBAAgB,IAAI,CAC3B,iBACE,OAAO,EAAE,OAAO,CAAC,gBAAgB,EACjC,KAAK,EAAE;oBACL,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,MAAM;oBACjE,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;oBAC7D,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,MAAM;oBACf,UAAU,EAAE,QAAQ;oBACpB,YAAY,EAAE,KAAK;iBACpB,EACD,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB,gBACxD,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,YAEtE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CACpB,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,+EAA+E,GAAG,GACtF,CACP,CAAC,CAAC,CAAC,CACF,cAAK,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,cAAc,EAAC,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,YACjE,eAAM,CAAC,EAAC,gFAAgF,GAAG,GACvF,CACP,GACM,CACV,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/DocControlsSidebar.d.ts

@@ -0,0 +1,27 @@
+/**
+ * DocControlsSidebar Component
+ *
+ * Vertical control strip that renders alongside the doc player video.
+ * Used in portrait orientation to eliminate black bars -- controls sit in a
+ * "tab" to the right of the 9:16 video instead of overlaying it.
+ *
+ * Contains: restart, play/pause, time display, segment indicator, CC toggle.
+ * Does NOT contain the scrubber/progress bar (that stays in the video via
+ * DocPlayer's showScrubber prop).
+ *
+ * The sidebar stretches to match the full height of the video and has rounded
+ * corners on the right side to create a connected "tab" appearance.
+ *
+ * Related Files:
+ * - DocPlayerWithSidebar.tsx -- Wrapper that composes player + sidebar
+ * - DocPlayer.tsx -- Core player (renders with showScrubber=true)
+ * - types.ts -- PlaybackState/PlaybackActions interfaces
+ */
+import type { PlaybackState, PlaybackActions } from './types';
+interface DocControlsSidebarProps {
+    state: PlaybackState;
+    actions: PlaybackActions;
+}
+export declare function DocControlsSidebar({ state, actions }: DocControlsSidebarProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocControlsSidebar.d.ts.map

package/dist/DocControlsSidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsSidebar.d.ts","sourceRoot":"","sources":["../src/DocControlsSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG9D,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,uBAAuB,2CA8E7E"}

package/dist/DocControlsSidebar.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatTime } from './types';
+export function DocControlsSidebar({ state, actions }) {
+    return (_jsxs("div", { className: "doc-controls-sidebar", children: [_jsx("button", { className: "sidebar-ctrl-btn", onClick: actions.restart, title: "Restart", "aria-label": "Restart from beginning", children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M12 5V1L7 6l5 5V7c3.31 0 6 2.69 6 6s-2.69 6-6 6-6-2.69-6-6H4c0 4.42 3.58 8 8 8s8-3.58 8-8-3.58-8-8-8z" }) }) }), _jsx("button", { className: "sidebar-ctrl-btn sidebar-play-btn", onClick: actions.toggle, "aria-label": state.isPlaying ? 'Pause' : 'Play', children: state.isPlaying ? (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "22", height: "22", children: _jsx("path", { d: "M6 19h4V5H6v14zm8-14v14h4V5h-4z" }) })) : (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "22", height: "22", children: _jsx("path", { d: "M8 5v14l11-7z" }) })) }), _jsxs("div", { className: "sidebar-time", children: [_jsx("div", { children: formatTime(state.currentTime) }), _jsx("div", { className: "sidebar-time-total", children: formatTime(state.totalDuration) })] }), _jsxs("div", { className: "sidebar-segment", children: [state.currentBlockIndex + 1, "/", state.totalBlocks] }), state.hasCaptions && (_jsx("button", { className: `sidebar-ctrl-btn ${state.captionsEnabled ? 'sidebar-ctrl-btn--active' : ''}`, onClick: () => actions.setCaptionsEnabled(!state.captionsEnabled), title: state.captionsEnabled ? 'Hide captions' : 'Show captions', "aria-label": state.captionsEnabled ? 'Hide captions' : 'Show captions', children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M19 4H5a2 2 0 00-2 2v12a2 2 0 002 2h14a2 2 0 002-2V6a2 2 0 00-2-2zm-8 7H9.5v-.5h-2v3h2V13H11v1a1 1 0 01-1 1H7a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1zm7 0h-1.5v-.5h-2v3h2V13H18v1a1 1 0 01-1 1h-3a1 1 0 01-1-1v-4a1 1 0 011-1h3a1 1 0 011 1v1z" }) }) })), actions.toggleFullscreen && (_jsx("button", { className: `sidebar-ctrl-btn ${state.isFullscreen ? 'sidebar-ctrl-btn--active' : ''}`, onClick: actions.toggleFullscreen, title: state.isFullscreen ? 'Exit fullscreen (F)' : 'Fullscreen (F)', "aria-label": state.isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen', children: state.isFullscreen ? (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M5 16h3v3h2v-5H5v2zm3-8H5v2h5V5H8v3zm6 11h2v-3h3v-2h-5v5zm2-11V5h-2v5h5V8h-3z" }) })) : (_jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "20", height: "20", children: _jsx("path", { d: "M7 14H5v5h5v-2H7v-3zm-2-4h2V7h3V5H5v5zm12 7h-3v2h5v-5h-2v3zM14 5v2h3v3h2V5h-5z" }) })) }))] }));
+}
+//# sourceMappingURL=DocControlsSidebar.js.map

package/dist/DocControlsSidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsSidebar.js","sourceRoot":"","sources":["../src/DocControlsSidebar.tsx"],"names":[],"mappings":"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"}

package/dist/DocControlsSlideshow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * DocControlsSlideshow Component
+ *
+ * Compact slide navigation controls for the DocPlayer slideshow display mode.
+ * Renders in the lower-right corner with previous / slide counter / next buttons,
+ * similar to PowerPoint/Keynote presentation navigation.
+ *
+ * Related Files:
+ * - DocPlayer.tsx — Parent component (renders this when displayMode='slideshow')
+ * - DocControlsOverlay.tsx — Video-mode controls (overlay layout)
+ * - types.ts — Shared type definitions
+ */
+import type { PlaybackState, SlideNavActions } from './types';
+interface DocControlsSlideshowProps {
+    state: PlaybackState;
+    slideNav: SlideNavActions;
+}
+export declare function DocControlsSlideshow({ state, slideNav }: DocControlsSlideshowProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocControlsSlideshow.d.ts.map

package/dist/DocControlsSlideshow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsSlideshow.d.ts","sourceRoot":"","sources":["../src/DocControlsSlideshow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D,UAAU,yBAAyB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,yBAAyB,2CA+GlF"}

package/dist/DocControlsSlideshow.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function DocControlsSlideshow({ state, slideNav }) {
+    const { currentBlockIndex, totalBlocks } = state;
+    const isFirst = currentBlockIndex <= 0;
+    const isLast = currentBlockIndex >= totalBlocks - 1;
+    return (_jsxs("div", { className: "doc-controls-slideshow", "data-testid": "slideshow-controls", style: {
+            position: 'absolute',
+            bottom: '16px',
+            right: '16px',
+            display: 'flex',
+            alignItems: 'center',
+            gap: '2px',
+            background: 'rgba(0, 0, 0, 0.65)',
+            borderRadius: '8px',
+            padding: '4px 6px',
+            zIndex: 100,
+            userSelect: 'none',
+            backdropFilter: 'blur(8px)',
+            WebkitBackdropFilter: 'blur(8px)',
+        }, children: [_jsx("button", { onClick: (e) => {
+                    e.stopPropagation();
+                    slideNav.prevSlide();
+                }, disabled: isFirst, "data-testid": "slide-prev", "aria-label": "Previous slide", title: "Previous slide", style: {
+                    background: 'none',
+                    border: 'none',
+                    color: isFirst ? 'rgba(255,255,255,0.3)' : 'rgba(255,255,255,0.9)',
+                    cursor: isFirst ? 'default' : 'pointer',
+                    padding: '6px 8px',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    borderRadius: '4px',
+                    transition: 'background 0.15s',
+                }, onMouseEnter: (e) => {
+                    if (!isFirst)
+                        e.currentTarget.style.background = 'rgba(255,255,255,0.1)';
+                }, onMouseLeave: (e) => {
+                    e.currentTarget.style.background = 'none';
+                }, children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M15.41 7.41L14 6l-6 6 6 6 1.41-1.41L10.83 12z" }) }) }), _jsx("span", { "data-testid": "slide-counter", style: {
+                    color: 'rgba(255,255,255,0.9)',
+                    fontSize: '13px',
+                    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+                    fontVariantNumeric: 'tabular-nums',
+                    minWidth: '48px',
+                    textAlign: 'center',
+                    padding: '0 4px',
+                    letterSpacing: '0.02em',
+                }, children: totalBlocks > 0 ? `${currentBlockIndex + 1} / ${totalBlocks}` : '—' }), _jsx("button", { onClick: (e) => {
+                    e.stopPropagation();
+                    slideNav.nextSlide();
+                }, disabled: isLast, "data-testid": "slide-next", "aria-label": "Next slide", title: "Next slide", style: {
+                    background: 'none',
+                    border: 'none',
+                    color: isLast ? 'rgba(255,255,255,0.3)' : 'rgba(255,255,255,0.9)',
+                    cursor: isLast ? 'default' : 'pointer',
+                    padding: '6px 8px',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    borderRadius: '4px',
+                    transition: 'background 0.15s',
+                }, onMouseEnter: (e) => {
+                    if (!isLast)
+                        e.currentTarget.style.background = 'rgba(255,255,255,0.1)';
+                }, onMouseLeave: (e) => {
+                    e.currentTarget.style.background = 'none';
+                }, children: _jsx("svg", { viewBox: "0 0 24 24", fill: "currentColor", width: "18", height: "18", children: _jsx("path", { d: "M8.59 16.59L10 18l6-6-6-6-1.41 1.41L13.17 12z" }) }) })] }));
+}
+//# sourceMappingURL=DocControlsSlideshow.js.map

package/dist/DocControlsSlideshow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocControlsSlideshow.js","sourceRoot":"","sources":["../src/DocControlsSlideshow.tsx"],"names":[],"mappings":"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"}

package/dist/DocPlayer.d.ts

@@ -0,0 +1,87 @@
+/**
+ * DocPlayer Component
+ *
+ * Main component for playing visual stories. Combines audio playback
+ * with synchronized SVG block animations. Supports both interactive
+ * browser playback and headless rendering for video export.
+ *
+ * Features:
+ * - Audio synchronization with multiple MP3 segments
+ * - Block transitions (fade, dissolve, slide)
+ * - Playback controls (play/pause, seek, next/prev)
+ * - Progress display
+ * - Render mode for video capture (via window.seekTo)
+ * - Pluggable audio provider for different environments (browser, EFB)
+ * - Multiple control layouts: overlay (default), sidebar, bottom
+ *
+ * Related Files:
+ * - DocControlsOverlay.tsx -- Default overlay controls
+ * - DocProgressBar.tsx -- Extracted progress bar
+ * - DocControlsSidebar.tsx -- Vertical sidebar controls
+ * - DocPlayerWithSidebar.tsx -- Wrapper for sidebar layout
+ * - types.ts -- Shared control types
+ */
+import type { Doc } from '@bendyline/squisq/schemas';
+import type { Theme } from '@bendyline/squisq/schemas';
+import type { AudioProvider } from './hooks/AudioProvider';
+import { type ViewportConfig } from '@bendyline/squisq/doc';
+import type { PlaybackState, PlaybackActions, BlockMarker, DisplayMode } from './types';
+interface DocPlayerProps {
+    /** Doc script to play */
+    script: Doc;
+    /** Base path for resolving media URLs */
+    basePath: string;
+    /** Render mode for video capture (hides controls, exposes seekTo) */
+    renderMode?: boolean;
+    /** Auto-play when loaded */
+    autoPlay?: boolean;
+    /** Callback when playback ends */
+    onEnded?: () => void;
+    /** Callback for time updates */
+    onTimeUpdate?: (time: number) => void;
+    /** Optional audio provider (if not provided, uses default HTML5 audio) */
+    audioProvider?: AudioProvider;
+    /** Show built-in controls (default: true). Set to false for custom controls. */
+    showControls?: boolean;
+    /** Show only the progress bar/scrubber at bottom (no other controls).
+     *  Only takes effect when showControls is false. Allows external controls
+     *  while keeping the scrubber in-video. */
+    showScrubber?: boolean;
+    /** Mute audio (default: false) */
+    muted?: boolean;
+    /** Enable captions (default: true) */
+    captionsEnabled?: boolean;
+    /** Callback when captions enabled state is toggled */
+    onCaptionsToggle?: (enabled: boolean) => void;
+    /** Callback for playback state changes (for external controls) */
+    onPlaybackStateChange?: (state: PlaybackState) => void;
+    /** Callback when playback controls are ready (for external controls) */
+    onControlsReady?: (controls: PlaybackActions & {
+        play: () => void;
+        pause: () => void;
+    }) => void;
+    /** Whether the player is currently in fullscreen mode */
+    isFullscreen?: boolean;
+    /** Callback to toggle fullscreen mode */
+    onFullscreenToggle?: () => void;
+    /** Callback when block markers are computed (for external progress bars) */
+    onBlockMarkers?: (markers: BlockMarker[]) => void;
+    /** Force a specific viewport preset, bypassing window-based orientation detection.
+     *  Used when the player is rendered in a constrained container (e.g., map overlay panel)
+     *  whose shape differs from the window's. */
+    forceViewport?: ViewportConfig;
+    /** Theme to use for rendering (default: DEFAULT_THEME from the theme library) */
+    theme?: Theme;
+    /**
+     * Display mode for the player.
+     * - `'video'` (default) — Traditional video playback with play/pause, scrub bar, auto-advance.
+     * - `'slideshow'` — PowerPoint-style with prev/next buttons. Blocks are static slides
+     *   that only change on user click. No auto-advance, no scrub bar.
+     * - `'linear'` — Long-scrolling document view. Renders markdown as readable HTML with
+     *   template-annotated sections as inline SVG cards. No audio, no timeline.
+     */
+    displayMode?: DisplayMode;
+}
+export declare function DocPlayer({ script, basePath, renderMode, autoPlay, onEnded, onTimeUpdate, audioProvider: externalAudioProvider, showControls, showScrubber, muted, captionsEnabled: captionsEnabledProp, onCaptionsToggle, onPlaybackStateChange, onControlsReady, isFullscreen, onFullscreenToggle, onBlockMarkers, forceViewport, displayMode, theme, }: DocPlayerProps): import("react/jsx-runtime").JSX.Element;
+export default DocPlayer;
+//# sourceMappingURL=DocPlayer.d.ts.map

package/dist/DocPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocPlayer.d.ts","sourceRoot":"","sources":["../src/DocPlayer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAgD,MAAM,2BAA2B,CAAC;AAEnG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAMvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,WAAW,EAGZ,MAAM,SAAS,CAAC;AA8DjB,UAAU,cAAc;IACtB,yBAAyB;IACzB,MAAM,EAAE,GAAG,CAAC;IACZ,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,gCAAgC;IAChC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;+CAE2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,kEAAkE;IAClE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACvD,wEAAwE;IACxE,eAAe,CAAC,EAAE,CAChB,QAAQ,EAAE,eAAe,GAAG;QAC1B,IAAI,EAAE,MAAM,IAAI,CAAC;QACjB,KAAK,EAAE,MAAM,IAAI,CAAC;KACnB,KACE,IAAI,CAAC;IACV,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAClD;;iDAE6C;IAC7C,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,iFAAiF;IACjF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,QAAQ,EACR,UAAkB,EAClB,QAAgB,EAChB,OAAO,EACP,YAAY,EACZ,aAAa,EAAE,qBAAqB,EACpC,YAAmB,EACnB,YAAoB,EACpB,KAAa,EACb,eAAe,EAAE,mBAAmB,EACpC,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,YAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,WAAqB,EACrB,KAAK,GACN,EAAE,cAAc,2CAwyBhB;AAED,eAAe,SAAS,CAAC"}