@bendyline/squisq-react 2.7.2 → 2.9.0

package/dist/{chunk-UJEHDVQO.js → chunk-G6FVNYNW.js}

@@ -593,7 +593,8 @@ function RichTextLayer({ layer, viewport, blockTime }) {
     ...animStyle.style
   };
   const cls = `squisq-rich-text-${cssId(layer.id)}`;
-  const scopedCss = `.${cls}{margin:0}.${cls} p{margin:0 0 .4em}.${cls} h1,.${cls} h2,.${cls} h3,.${cls} h4,.${cls} h5,.${cls} h6{margin:0 0 .3em;line-height:1.2}.${cls} ul,.${cls} ol{margin:0 0 .4em;padding-left:1.2em;list-style-position:inside}.${cls} li{margin:0}.${cls} li>p{display:inline;margin:0}.${cls} *:first-child{margin-top:0}.${cls} *:last-child{margin-bottom:0}.${cls} a{color:inherit;text-decoration:underline}`;
+  const listStylePosition = style.textAlign === "center" || style.textAlign === "right" ? "inside" : "outside";
+  const scopedCss = `.${cls}{margin:0}.${cls} p{margin:0 0 .4em}.${cls} h1,.${cls} h2,.${cls} h3,.${cls} h4,.${cls} h5,.${cls} h6{margin:0 0 .3em;line-height:1.2}.${cls} ul,.${cls} ol{margin:0 0 .7em;padding-left:1.2em;list-style-position:${listStylePosition}}.${cls} li{margin:0}.${cls} li>p{display:inline;margin:0}.${cls} *:first-child{margin-top:0}.${cls} *:last-child{margin-bottom:0}.${cls} a{color:inherit;text-decoration:underline}`;
   return /* @__PURE__ */ jsx3("g", { className: `block-layer block-layer--text ${animStyle.className}`, "data-layer-id": layer.id, children: /* @__PURE__ */ jsx3(
     "foreignObject",
     {

package/dist/{chunk-IQGW6SA6.js → chunk-NGQQKH7J.js}

@@ -9,7 +9,7 @@ import {
   TreeLayer,
   VideoLayer,
   getTransitionClass
-} from "./chunk-UJEHDVQO.js";
+} from "./chunk-G6FVNYNW.js";
 import {
   useAutoSurface
 } from "./chunk-TT6ENR6T.js";

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 import { SquisqRenderAPI, VideoPresentation as VideoPresentation$1, PipSize, PipShape, PipPosition } 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';
+export { BlockMarker, BlockRenderer, CaptionMode, CaptionOverlay, CaptionStyle, ControlsLayout, DisplayMode, DocControlsBottom, DocControlsOverlay, DocControlsSidebar, DocControlsSlideshow, DocPlayer, DocPlayerProps, DocPlayerWithSidebar, DocProgressBar, FlashcardFaceView, FlashcardFaceViewProps, FlashcardView, FlashcardViewProps, InlineAudioPlayer, InlineAudioPlayerProps, InlineVideoPlayer, InlineVideoPlayerProps, MediaClipLayer, MediaClipLayerProps, PlaybackActions, PlaybackState, RenderAudioSegmentInfo, RenderBlockInfo, RenderCaptionInfo, RenderChapterInfo, SlideNavActions, SocialCaptionOverlay, formatTime } from './player/index.js';
 import { Theme, VideoPresentation, VideoPipSize, VideoPipShape, VideoPipPosition, Doc, ScheduledClip, MediaProvider } from '@bendyline/squisq/schemas';
+import { DashboardStyleId, ViewportConfig, CoverSlideTemplate, CoverSlidePlayback } from '@bendyline/squisq/doc';
+export { getAnimationStyle, getTransitionClass } from '@bendyline/squisq/doc';
 import { C as CodeBlockCopyHandler } from './MarkdownRenderer-CC9dOc6b.js';
 export { a as CodeBlockCopyContext, M as MarkdownRenderer, b as MarkdownRendererProps } from './MarkdownRenderer-CC9dOc6b.js';
 export { FenceRendererContext, MermaidDiagram, MermaidDiagramProps, useFenceRenderers } from './markdown/index.js';
 export { CanvasSection, CanvasSectionProps, ImageDisplayMode, LinearDocView, LinearDocViewProps, PageSectionView, PageSectionViewProps, PageViewContext, PageViewContextValue, usePageView } from './page/index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { ImageLayer, MapLayer, MermaidLayer, PathLayer, ShapeLayer, TableLayer, TextLayer, TreeLayer, VideoLayer } from './layers/index.js';
-import { CoverSlideTemplate, CoverSlidePlayback } from '@bendyline/squisq/doc';
-export { getAnimationStyle, getTransitionClass } from '@bendyline/squisq/doc';
 export { MediaContext, MediaScheduleController, ModalDialogOptions, ResourcePolicyContext, UseDocPlaybackOptions, useAudioSync, useAutoSurface, useDocPlayback, useMediaProvider, useMediaSchedule, useMediaUrl, useModalDialog, useResourcePolicy, useViewportOrientation } from './hooks/index.js';
 export { FenceRenderContext, FenceRenderer, FenceRendererMap } from '@bendyline/squisq/fence';
 export { A as AudioActions, a as AudioController, b as AudioState } from './AudioController-DwMsPe38.js';
 export { JsonFormFenceAction, JsonFormFenceRendererOptions, JsonView, JsonViewProps, createJsonFormFenceRenderer } from './json-view/index.js';
-import 'react/jsx-runtime';
 import 'react';
 import '@bendyline/squisq/markdown';
 import '@bendyline/squisq/jsonForm';
@@ -42,8 +42,23 @@ import '@bendyline/squisq/jsonForm';
  */
 
 interface MountOptions {
-    /** Rendering mode: 'slideshow' (interactive, default) or 'static' (scrollable) */
-    mode?: 'slideshow' | 'static';
+    /**
+     * Rendering mode: 'slideshow' (interactive, default), 'static'
+     * (scrollable page), 'dashboard' (one canvas of arranged blocks), or
+     * 'flashcards' (progressively revealed study deck).
+     */
+    mode?: 'slideshow' | 'static' | 'dashboard' | 'flashcards';
+    /** Dashboard-mode options (ignored by the other modes). */
+    dashboard?: {
+        /** Layout id or 'auto'. Overrides doc frontmatter. */
+        layout?: string;
+        /** Title-band override. Overrides doc frontmatter. */
+        title?: boolean;
+        /** Cell style variant ('basic' | 'card' | 'panel' | 'accent'). */
+        style?: DashboardStyleId;
+        /** Host-supplied title fallback (typically the file name). */
+        documentTitle?: string;
+    };
     /** Base path for resolving relative media URLs */
     basePath?: string;
     /**
@@ -104,6 +119,37 @@ interface SquisqPlayerHandle {
     unmount(): void;
 }
 
+interface DashboardViewProps {
+    doc: Doc;
+    /** Resolved theme; defaults to the doc's own theme resolution. */
+    theme?: Theme;
+    /** Canvas viewport (default: the landscape preset). */
+    viewport?: ViewportConfig;
+    /** Layout override: an id or `'auto'`. Overrides doc frontmatter. */
+    layout?: string;
+    /** Title-band override. Overrides doc frontmatter (default true). */
+    showTitle?: boolean;
+    /**
+     * Cell style variant (`basic` | `card` | `panel` | `accent`). Overrides
+     * doc frontmatter; all variants take their colors from the active theme.
+     */
+    style?: DashboardStyleId;
+    /** Host-supplied title fallback (typically the file name). */
+    documentTitle?: string;
+    /** Base path for resolving media URLs (default `'.'`). */
+    basePath?: string;
+    /** Render ambient/authored layer animations (default true). */
+    animationsEnabled?: boolean;
+    /** Silence audio carried by cell video layers (default true). */
+    muted?: boolean;
+    /** Publish the capture-readiness render API (headless export). */
+    renderMode?: boolean;
+    /** Receives the minimal render API, and `null` on cleanup. */
+    onRenderAPIReady?: (api: SquisqRenderAPI | null) => void;
+    className?: string;
+}
+declare function DashboardView({ doc, theme, viewport, layout, showTitle, style, documentTitle, basePath, animationsEnabled, muted, renderMode, onRenderAPIReady, className, }: DashboardViewProps): react_jsx_runtime.JSX.Element;
+
 interface DocPlayerAppearanceOverrides {
     theme?: Theme;
     videoPresentation?: VideoPresentation$1;
@@ -154,4 +200,4 @@ declare function resolveDocPlayerAppearance(doc: Doc, overrides?: DocPlayerAppea
  */
 declare function useMediaClipDurations(schedule: ScheduledClip[], basePath: string, mediaProviderOverride?: MediaProvider | null): Map<string, number>;
 
-export { CodeBlockCopyHandler, type DocPlayerAppearanceOverrides, type MountOptions, PipPosition, PipShape, PipSize, type ResolvedDocPlayerAppearance, type SquisqPlayerHandle, SquisqRenderAPI, VideoPresentation$1 as VideoPresentation, resolveDocPlayerAppearance, useMediaClipDurations };
+export { CodeBlockCopyHandler, DashboardView, type DashboardViewProps, type DocPlayerAppearanceOverrides, type MountOptions, PipPosition, PipShape, PipSize, type ResolvedDocPlayerAppearance, type SquisqPlayerHandle, SquisqRenderAPI, VideoPresentation$1 as VideoPresentation, resolveDocPlayerAppearance, useMediaClipDurations };

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   CaptionOverlay,
+  DashboardView,
   DocControlsBottom,
   DocControlsOverlay,
   DocControlsSidebar,
@@ -7,12 +8,14 @@ import {
   DocPlayer,
   DocPlayerWithSidebar,
   DocProgressBar,
+  FlashcardFaceView,
+  FlashcardView,
   MediaClipLayer,
   SocialCaptionOverlay,
   formatTime,
   resolveDocPlayerAppearance,
   useMediaClipDurations
-} from "./chunk-KXYE4AGL.js";
+} from "./chunk-2Y7F3S6M.js";
 import {
   BlockRenderer,
   CanvasSection,
@@ -20,7 +23,7 @@ import {
   PageSectionView,
   PageViewContext,
   usePageView
-} from "./chunk-IQGW6SA6.js";
+} from "./chunk-NGQQKH7J.js";
 import {
   ImageLayer,
   MapLayer,
@@ -33,7 +36,7 @@ import {
   VideoLayer,
   getAnimationStyle,
   getTransitionClass
-} from "./chunk-UJEHDVQO.js";
+} from "./chunk-G6FVNYNW.js";
 import {
   useModalDialog
 } from "./chunk-65POMKHR.js";
@@ -71,6 +74,7 @@ export {
   BlockRenderer,
   CanvasSection,
   CaptionOverlay,
+  DashboardView,
   DocControlsBottom,
   DocControlsOverlay,
   DocControlsSidebar,
@@ -79,6 +83,8 @@ export {
   DocPlayerWithSidebar,
   DocProgressBar,
   FenceRendererContext,
+  FlashcardFaceView,
+  FlashcardView,
   ImageLayer,
   InlineAudioPlayer,
   InlineVideoPlayer,

package/dist/layers/index.js

@@ -8,7 +8,7 @@ import {
   TextLayer,
   TreeLayer,
   VideoLayer
-} from "../chunk-UJEHDVQO.js";
+} from "../chunk-G6FVNYNW.js";
 import "../chunk-WLUZTUNZ.js";
 import "../chunk-LR3AIGDD.js";
 export {

package/dist/page/index.js

@@ -4,8 +4,8 @@ import {
   PageSectionView,
   PageViewContext,
   usePageView
-} from "../chunk-IQGW6SA6.js";
-import "../chunk-UJEHDVQO.js";
+} from "../chunk-NGQQKH7J.js";
+import "../chunk-G6FVNYNW.js";
 import "../chunk-TT6ENR6T.js";
 import "../chunk-ESI3P77P.js";
 import "../chunk-WLUZTUNZ.js";

package/dist/player/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Block, VideoPresentation as VideoPresentation$1, VideoPipSize, VideoPipShape, VideoPipPosition, Doc, Theme, SurfaceScheme, Transition, CaptionTrack, ViewportConfig as ViewportConfig$1, ScheduledClip } from '@bendyline/squisq/schemas';
-import { ViewportConfig, CoverSlideTemplate, CoverSlidePlayback } from '@bendyline/squisq/doc';
+import { Block, VideoPresentation as VideoPresentation$1, VideoPipSize, VideoPipShape, VideoPipPosition, Doc, Theme, SurfaceScheme, Transition, CaptionTrack, ViewportConfig as ViewportConfig$1, CustomTemplateDefinition, ScheduledClip } from '@bendyline/squisq/schemas';
+import { ViewportConfig, DashboardStyleId, CoverSlideTemplate, CoverSlidePlayback, FlashcardFace, FlashcardSourceMode } from '@bendyline/squisq/doc';
 import { FenceRendererMap } from '@bendyline/squisq/fence';
 import { a as AudioController } from '../AudioController-DwMsPe38.js';
 import { C as CodeBlockCopyHandler } from '../MarkdownRenderer-CC9dOc6b.js';
@@ -57,8 +57,13 @@ type PipPosition = VideoPipPosition;
  *   implement this mode; it is owned by the editor package
  *   (`@bendyline/squisq-editor-react`), which renders its own
  *   voice-paced teleprompter view for it.
+ * - `'dashboard'` — One static canvas that arranges every block into a
+ *   layout's cells (grids, hero mosaics). No timeline, no navigation;
+ *   overflow blocks beyond the layout's capacity are not rendered.
+ * - `'flashcards'` — A progressively revealed study deck derived from the
+ *   document's nested block hierarchy, including multiple-choice quizzes.
  */
-type DisplayMode = 'video' | 'slideshow' | 'linear' | 'page' | 'narrate';
+type DisplayMode = 'video' | 'slideshow' | 'linear' | 'page' | 'narrate' | 'dashboard' | 'flashcards';
 /**
  * Caption display style.
  *
@@ -223,8 +228,16 @@ interface DocPlayerProps {
     forceViewport?: ViewportConfig;
     theme?: Theme;
     surface?: SurfaceScheme | 'auto';
-    /** Video, manual slideshow, or long-scrolling linear rendition. */
+    /** Video, slideshow, page, dashboard, or flashcards rendition. */
     displayMode?: DisplayMode;
+    /** Dashboard mode: layout id or `'auto'`. Overrides doc frontmatter. */
+    dashboardLayout?: string;
+    /** Dashboard mode: title-band override. Overrides doc frontmatter. */
+    dashboardShowTitle?: boolean;
+    /** Dashboard mode: cell style variant. Overrides doc frontmatter. */
+    dashboardStyle?: DashboardStyleId;
+    /** Dashboard mode: host-supplied title fallback (typically the file name). */
+    dashboardDocumentTitle?: string;
     showCoverSlide?: boolean;
     /** Visual template used to materialize the managed cover. */
     coverSlideTemplate?: CoverSlideTemplate;
@@ -416,6 +429,36 @@ interface DocProgressBarProps {
 }
 declare function DocProgressBar({ state, actions, blockMarkers, expandedBlocks, getBlockTitle, }: DocProgressBarProps): react_jsx_runtime.JSX.Element;
 
+interface FlashcardViewProps {
+    doc: Doc;
+    theme?: Theme;
+    basePath?: string;
+    source?: FlashcardSourceMode;
+    /** Start the deck in shuffled order (default false). */
+    shuffle?: boolean;
+    /** Capture shortcuts without requiring focus (default false). */
+    globalKeyboardShortcuts?: boolean;
+    showCodeCopyButton?: boolean;
+    onCopyCode?: CodeBlockCopyHandler;
+    fenceRenderers?: FenceRendererMap;
+    /** Viewport used to materialize diagrams and other spatial content. */
+    viewport?: ViewportConfig$1;
+    className?: string;
+}
+interface FlashcardFaceViewProps {
+    face: FlashcardFace;
+    theme: Theme;
+    basePath: string;
+    showCodeCopyButton: boolean;
+    onCopyCode?: CodeBlockCopyHandler;
+    fenceRenderers?: FenceRendererMap;
+    viewport?: ViewportConfig$1;
+    customTemplates?: readonly CustomTemplateDefinition[];
+}
+/** Rich, theme-aware renderer for one materialized flashcard face. */
+declare function FlashcardFaceView(props: FlashcardFaceViewProps): react_jsx_runtime.JSX.Element;
+declare function FlashcardView({ doc, theme, basePath, source, shuffle: initialShuffle, globalKeyboardShortcuts, showCodeCopyButton, onCopyCode, fenceRenderers, viewport, className, }: FlashcardViewProps): react_jsx_runtime.JSX.Element;
+
 interface InlineVideoPlayerProps {
     /** Source path — resolved through MediaContext when relative. */
     src: string;
@@ -475,4 +518,4 @@ interface MediaClipLayerProps {
 }
 declare function MediaClipLayer({ schedule, currentTime, isPlaying, basePath, renderMode, muted, presentation, pipSize, pipShape, pipPosition, pipOrientation, pipFrameStyle, honorClipPresentation, }: MediaClipLayerProps): react_jsx_runtime.JSX.Element | null;
 
-export { type BlockMarker, BlockRenderer, type CaptionMode, CaptionOverlay, type CaptionStyle, CodeBlockCopyHandler, type ControlsLayout, type DisplayMode, DocControlsBottom, DocControlsOverlay, DocControlsSidebar, DocControlsSlideshow, DocPlayer, type DocPlayerProps, DocPlayerWithSidebar, DocProgressBar, InlineAudioPlayer, type InlineAudioPlayerProps, InlineVideoPlayer, type InlineVideoPlayerProps, MediaClipLayer, type MediaClipLayerProps, type PipPosition, type PipShape, type PipSize, type PlaybackActions, type PlaybackState, type RenderAudioSegmentInfo, type RenderBlockInfo, type RenderCaptionInfo, type RenderChapterInfo, type SlideNavActions, SocialCaptionOverlay, type SquisqRenderAPI, type VideoPresentation, formatTime };
+export { type BlockMarker, BlockRenderer, type CaptionMode, CaptionOverlay, type CaptionStyle, CodeBlockCopyHandler, type ControlsLayout, type DisplayMode, DocControlsBottom, DocControlsOverlay, DocControlsSidebar, DocControlsSlideshow, DocPlayer, type DocPlayerProps, DocPlayerWithSidebar, DocProgressBar, FlashcardFaceView, type FlashcardFaceViewProps, FlashcardView, type FlashcardViewProps, InlineAudioPlayer, type InlineAudioPlayerProps, InlineVideoPlayer, type InlineVideoPlayerProps, MediaClipLayer, type MediaClipLayerProps, type PipPosition, type PipShape, type PipSize, type PlaybackActions, type PlaybackState, type RenderAudioSegmentInfo, type RenderBlockInfo, type RenderCaptionInfo, type RenderChapterInfo, type SlideNavActions, SocialCaptionOverlay, type SquisqRenderAPI, type VideoPresentation, formatTime };

package/dist/player/index.js

@@ -7,14 +7,16 @@ import {
   DocPlayer,
   DocPlayerWithSidebar,
   DocProgressBar,
+  FlashcardFaceView,
+  FlashcardView,
   MediaClipLayer,
   SocialCaptionOverlay,
   formatTime
-} from "../chunk-KXYE4AGL.js";
+} from "../chunk-2Y7F3S6M.js";
 import {
   BlockRenderer
-} from "../chunk-IQGW6SA6.js";
-import "../chunk-UJEHDVQO.js";
+} from "../chunk-NGQQKH7J.js";
+import "../chunk-G6FVNYNW.js";
 import "../chunk-MVJQL2W2.js";
 import "../chunk-TT6ENR6T.js";
 import {
@@ -33,6 +35,8 @@ export {
   DocPlayer,
   DocPlayerWithSidebar,
   DocProgressBar,
+  FlashcardFaceView,
+  FlashcardView,
   InlineAudioPlayer,
   InlineVideoPlayer,
   MediaClipLayer,