@bendyline/squisq-react 2.4.7 → 2.6.0

package/dist/{chunk-3HYSWEKG.js → chunk-U6P7HBUY.js}

@@ -9,14 +9,14 @@ import {
   TreeLayer,
   VideoLayer,
   getTransitionClass
-} from "./chunk-MKWVJYUS.js";
+} from "./chunk-UJEHDVQO.js";
 import {
   useAutoSurface
 } from "./chunk-TT6ENR6T.js";
 import {
   InlineVideoPlayer,
   MarkdownRenderer
-} from "./chunk-VMPQEUJH.js";
+} from "./chunk-TMCLQNLM.js";
 import {
   useMediaUrl
 } from "./chunk-LR3AIGDD.js";
@@ -165,7 +165,8 @@ var defaultValue = {
   viewport: VIEWPORT_PRESETS.landscape,
   renderContext: { theme: DEFAULT_THEME },
   animationsEnabled: true,
-  imageDisplayMode: "inline"
+  imageDisplayMode: "inline",
+  showCodeCopyButton: false
 };
 var PageViewContext = createContext(defaultValue);
 function usePageView() {
@@ -438,11 +439,19 @@ function CardGridSection({ section }) {
   ] });
 }
 function ItemListSection({ section }) {
-  const { theme } = usePageView();
+  const { theme, showCodeCopyButton, onCopyCode } = usePageView();
   const items = section.slots.items ?? [];
   return /* @__PURE__ */ jsxs2(Fragment, { children: [
     section.slots.title && /* @__PURE__ */ jsx3("h2", { className: "squisq-page-section-title squisq-page-items-title", children: section.slots.title }),
-    /* @__PURE__ */ jsx3("ol", { className: "squisq-page-items", children: items.map((item, i) => /* @__PURE__ */ jsx3("li", { children: item.markdown ? /* @__PURE__ */ jsx3(MarkdownRenderer, { nodes: item.markdown, theme }) : item.body }, i)) })
+    /* @__PURE__ */ jsx3("ol", { className: "squisq-page-items", children: items.map((item, i) => /* @__PURE__ */ jsx3("li", { children: item.markdown ? /* @__PURE__ */ jsx3(
+      MarkdownRenderer,
+      {
+        nodes: item.markdown,
+        theme,
+        showCodeCopyButton,
+        onCopyCode
+      }
+    ) : item.body }, i)) })
   ] });
 }
 function TimelineRailSection({ section }) {
@@ -470,12 +479,28 @@ function TableSection({ section }) {
   ] });
 }
 function ProseSection({ section, block }) {
-  const { theme } = usePageView();
-  const heading = section.slots.title !== void 0 && block?.sourceHeading ? /* @__PURE__ */ jsx3(MarkdownRenderer, { nodes: [block.sourceHeading], theme }) : null;
+  const { theme, showCodeCopyButton, onCopyCode } = usePageView();
+  const heading = section.slots.title !== void 0 && block?.sourceHeading ? /* @__PURE__ */ jsx3(
+    MarkdownRenderer,
+    {
+      nodes: [block.sourceHeading],
+      theme,
+      showCodeCopyButton,
+      onCopyCode
+    }
+  ) : null;
   const bodyNodes = section.slots.body?.markdown ?? block?.contents;
   return /* @__PURE__ */ jsxs2("div", { className: "squisq-page-prose", children: [
     heading,
-    bodyNodes && bodyNodes.length > 0 && /* @__PURE__ */ jsx3(MarkdownRenderer, { nodes: bodyNodes, theme })
+    bodyNodes && bodyNodes.length > 0 && /* @__PURE__ */ jsx3(
+      MarkdownRenderer,
+      {
+        nodes: bodyNodes,
+        theme,
+        showCodeCopyButton,
+        onCopyCode
+      }
+    )
   ] });
 }
 function FooterSection({ section }) {
@@ -537,7 +562,7 @@ function sectionBody(entry, featureFlip) {
   }
 }
 function PageSectionView({ entry, featureFlip, isLeadProse }) {
-  const { pageStyle, theme } = usePageView();
+  const { pageStyle, theme, showCodeCopyButton, onCopyCode } = usePageView();
   const { section } = entry;
   const richContent = section.slots.richContent?.markdown;
   const classes = [
@@ -566,7 +591,15 @@ function PageSectionView({ entry, featureFlip, isLeadProse }) {
       ...hintAttrs,
       children: /* @__PURE__ */ jsxs3("div", { className: "squisq-page-section-inner", children: [
         sectionBody(entry, featureFlip),
-        richContent && richContent.length > 0 && /* @__PURE__ */ jsx4("div", { className: "squisq-page-rich-content", children: /* @__PURE__ */ jsx4(MarkdownRenderer, { nodes: richContent, theme }) })
+        richContent && richContent.length > 0 && /* @__PURE__ */ jsx4("div", { className: "squisq-page-rich-content", children: /* @__PURE__ */ jsx4(
+          MarkdownRenderer,
+          {
+            nodes: richContent,
+            theme,
+            showCodeCopyButton,
+            onCopyCode
+          }
+        ) })
       ] })
     }
   );
@@ -603,7 +636,9 @@ function LinearDocView({
   imageDisplayMode = "inline",
   globalKeyboardShortcuts = false,
   showCover = true,
-  transformPage
+  transformPage,
+  showCodeCopyButton = false,
+  onCopyCode
 }) {
   const scrollRef = useRef(null);
   const activeViewport = viewport ?? VIEWPORT_PRESETS2.landscape;
@@ -650,7 +685,9 @@ function LinearDocView({
       viewport: activeViewport,
       renderContext,
       animationsEnabled,
-      imageDisplayMode
+      imageDisplayMode,
+      showCodeCopyButton,
+      onCopyCode
     }),
     [
       activeTheme,
@@ -659,7 +696,9 @@ function LinearDocView({
       activeViewport,
       renderContext,
       animationsEnabled,
-      imageDisplayMode
+      imageDisplayMode,
+      showCodeCopyButton,
+      onCopyCode
     ]
   );
   const { featureOrdinals, leadProseIndex } = useMemo2(() => {

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

@@ -239,7 +239,7 @@ function remapToKenBurns(anim) {
 }
 
 // src/layers/TextLayer.tsx
-import { useId, useMemo } from "react";
+import { useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { DEFAULT_DOC_FONT } from "@bendyline/squisq/schemas";
 import {
   parseHtmlToNodes,
@@ -454,6 +454,55 @@ function PlainTextLayer({ layer, viewport, blockTime }) {
   }
   const lineHeight = style.lineHeight || 1.4;
   const lineHeightPx = style.fontSize * lineHeight;
+  const shrinkToFit = style.shrinkToFit === true;
+  const centerBlock = shrinkToFit && dominantBaseline === "middle";
+  const firstLineDy = centerBlock ? -((lines.length - 1) / 2) * lineHeightPx : 0;
+  const textRef = useRef(null);
+  const [fit, setFit] = useState(null);
+  const linesKey = lines.join("\n");
+  useLayoutEffect(() => {
+    if (!shrinkToFit) {
+      setFit(null);
+      return;
+    }
+    const element = textRef.current;
+    if (!element || typeof element.getBBox !== "function") return;
+    const measure = () => {
+      try {
+        const bbox = element.getBBox();
+        if (bbox.width <= 0 || bbox.height <= 0) return;
+        const maxW = boxWidth ?? viewport.width;
+        const maxH = boxHeight ?? viewport.height;
+        const scale = Math.min(1, maxW / bbox.width, maxH / bbox.height);
+        setFit(
+          scale < 0.995 ? { scale, cx: bbox.x + bbox.width / 2, cy: bbox.y + bbox.height / 2 } : null
+        );
+      } catch {
+      }
+    };
+    measure();
+    const fonts = element.ownerDocument?.fonts;
+    if (fonts && fonts.status !== "loaded") {
+      let cancelled = false;
+      void fonts.ready.then(() => {
+        if (!cancelled) measure();
+      });
+      return () => {
+        cancelled = true;
+      };
+    }
+  }, [
+    shrinkToFit,
+    linesKey,
+    boxWidth,
+    boxHeight,
+    viewport.width,
+    viewport.height,
+    style.fontSize,
+    style.fontFamily,
+    style.fontWeight
+  ]);
+  const fitTransform = fit ? `translate(${fit.cx} ${fit.cy}) scale(${fit.scale}) translate(${-fit.cx} ${-fit.cy})` : void 0;
   const textStyles = {
     fontSize: `${style.fontSize}px`,
     fontFamily: style.fontFamily || DEFAULT_DOC_FONT,
@@ -486,13 +535,15 @@ function PlainTextLayer({ layer, viewport, blockTime }) {
     /* @__PURE__ */ jsx3(
       "text",
       {
+        ref: textRef,
         x,
         y,
         textAnchor,
         dominantBaseline,
         style: textStyles,
         filter: filterId ? `url(#${filterId})` : void 0,
-        children: lines.map((line, i) => /* @__PURE__ */ jsxs2("tspan", { x, dy: i === 0 ? 0 : lineHeightPx, children: [
+        transform: fitTransform,
+        children: lines.map((line, i) => /* @__PURE__ */ jsxs2("tspan", { x, dy: i === 0 ? firstLineDy : lineHeightPx, children: [
           line || "\xA0",
           " "
         ] }, i))
@@ -893,7 +944,7 @@ function MarkerDef({
 }
 
 // src/layers/MapLayer.tsx
-import { useId as useId4, useState, useEffect } from "react";
+import { useId as useId4, useState as useState2, useEffect } from "react";
 import { ResourcePolicyError as ResourcePolicyError2 } from "@bendyline/squisq/markdown";
 
 // src/utils/mapTileUtils.ts
@@ -1092,10 +1143,10 @@ import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 function MapLayer({ layer, basePath, viewport, blockTime }) {
   const { content, position, animation } = layer;
   const clipId = `map-clip-${useId4().replace(/:/g, "")}-${layer.id}`;
-  const [mapImageUrl, setMapImageUrl] = useState(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState(null);
-  const [blockedByPolicy, setBlockedByPolicy] = useState(false);
+  const [mapImageUrl, setMapImageUrl] = useState2(null);
+  const [isLoading, setIsLoading] = useState2(true);
+  const [error, setError] = useState2(null);
+  const [blockedByPolicy, setBlockedByPolicy] = useState2(false);
   const x = resolveValue(position.x, viewport.width);
   const y = resolveValue(position.y, viewport.height);
   const width = position.width ? resolveValue(position.width, viewport.width) : viewport.width;
@@ -1242,7 +1293,7 @@ function MapLayer({ layer, basePath, viewport, blockTime }) {
 }
 
 // src/layers/VideoLayer.tsx
-import { useRef, useEffect as useEffect2 } from "react";
+import { useRef as useRef2, useEffect as useEffect2 } from "react";
 import { jsx as jsx7 } from "react/jsx-runtime";
 var VIDEO_SYNC_DRIFT_SECONDS = 0.2;
 function VideoLayer({
@@ -1254,8 +1305,8 @@ function VideoLayer({
   muted = false
 }) {
   const { content, position } = layer;
-  const videoRef = useRef(null);
-  const hasStartedRef = useRef(false);
+  const videoRef = useRef2(null);
+  const hasStartedRef = useRef2(false);
   const startAt = content.startAt ?? 0;
   const gated = blockTime < startAt;
   const x = resolveValue(position.x, viewport.width);
@@ -1434,7 +1485,7 @@ function TableLayer({ layer, viewport, blockTime }) {
 }
 
 // src/layers/TreeLayer.tsx
-import { useState as useState2 } from "react";
+import { useState as useState3 } from "react";
 import { jsx as jsx9, jsxs as jsxs7 } from "react/jsx-runtime";
 function faClass(token, fallback) {
   const name = token && token.trim() ? token.trim() : fallback;
@@ -1508,7 +1559,7 @@ function TreeRow({
   style
 }) {
   const hasChildren = item.children.length > 0;
-  const [collapsed, setCollapsed] = useState2(false);
+  const [collapsed, setCollapsed] = useState3(false);
   const isDir = item.isDir || hasChildren;
   const iconCls = isDir ? faClass(style.folderIcon, collapsed ? "folder" : "folder-open") : faClass(style.fileIcon, "file");
   return /* @__PURE__ */ jsxs7("li", { style: { position: "relative" }, children: [

package/dist/{chunk-DJRYQQXB.js → chunk-YKBVTYU4.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-TT6ENR6T.js";
 import {
   MarkdownRenderer
-} from "./chunk-VMPQEUJH.js";
+} from "./chunk-TMCLQNLM.js";
 
 // src/jsonView/useJsonViewTokens.ts
 import { useMemo } from "react";

package/dist/hooks/index.d.ts

@@ -18,10 +18,14 @@ import { ResourcePolicy } from '@bendyline/squisq/markdown';
  * 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.
+ *
+ * In `synthetic` mode there is no audio element to follow, so a caller that
+ * has no segments passes `syntheticDuration` — the document's own timeline
+ * length — and the same segment machinery drives a timer instead.
  */
 
 type AudioSyncMode = 'media' | 'synthetic';
-declare function useAudioSync(audioRef: RefObject<HTMLAudioElement>, audioTrack: AudioTrack | undefined, basePath?: string, enabled?: boolean, mode?: AudioSyncMode): AudioController;
+declare function useAudioSync(audioRef: RefObject<HTMLAudioElement>, track: AudioTrack | undefined, basePath?: string, enabled?: boolean, mode?: AudioSyncMode, syntheticDuration?: number): AudioController;
 
 interface ModalDialogOptions {
     /** The backdrop/portal root. Siblings of this branch are made inert. */

package/dist/hooks/index.js

@@ -6,7 +6,7 @@ import {
   useDocPlayback,
   useMediaSchedule,
   useViewportOrientation
-} from "../chunk-BOZJ655L.js";
+} from "../chunk-MVJQL2W2.js";
 import {
   useAutoSurface
 } from "../chunk-TT6ENR6T.js";

package/dist/index.d.ts

@@ -1,12 +1,15 @@
 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';
 import { Theme, VideoPresentation, VideoPipSize, VideoPipShape, VideoPipPosition, Doc, ScheduledClip, MediaProvider } from '@bendyline/squisq/schemas';
-export { MarkdownRenderer, MermaidDiagram, MermaidDiagramProps } from './markdown/index.js';
+import { C as CodeBlockCopyHandler } from './MarkdownRenderer-CerBKw-c.js';
+export { a as CodeBlockCopyContext, M as MarkdownRenderer, b as MarkdownRendererProps } from './MarkdownRenderer-CerBKw-c.js';
+export { 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';
+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 { A as AudioActions, a as AudioController, b as AudioState } from './AudioController-DwMsPe38.js';
-export { getAnimationStyle, getTransitionClass } from '@bendyline/squisq/doc';
 export { JsonView, JsonViewProps } from './json-view/index.js';
 import 'react/jsx-runtime';
 import 'react';
@@ -83,6 +86,10 @@ interface MountOptions {
     animationsEnabled?: boolean;
     /** Caption style: 'standard' or 'social'. Omit or set to undefined for no captions. */
     captionStyle?: 'standard' | 'social';
+    /** Show a Copy button on fenced code blocks in static mode (default: false). */
+    showCodeCopyButton?: boolean;
+    /** Optional host clipboard adapter; otherwise the browser Clipboard API is used. */
+    onCopyCode?: CodeBlockCopyHandler;
 }
 /** Instance handle returned by {@link mount}. */
 interface SquisqPlayerHandle {
@@ -103,6 +110,9 @@ interface DocPlayerAppearanceOverrides {
     pipShape?: PipShape;
     pipPosition?: PipPosition;
     showCoverSlide?: boolean;
+    coverSlideTemplate?: CoverSlideTemplate;
+    coverSlideDuration?: number;
+    coverSlidePlayback?: CoverSlidePlayback;
 }
 interface ResolvedDocPlayerAppearance {
     theme: Theme;
@@ -111,6 +121,9 @@ interface ResolvedDocPlayerAppearance {
     pipShape: PipShape;
     pipPosition: PipPosition;
     showCoverSlide: boolean;
+    coverSlideTemplate: CoverSlideTemplate;
+    coverSlideDuration: number;
+    coverSlidePlayback: CoverSlidePlayback;
 }
 /** Resolve the visual settings a standalone/export player must inherit from its Doc. */
 declare function resolveDocPlayerAppearance(doc: Doc, overrides?: DocPlayerAppearanceOverrides): ResolvedDocPlayerAppearance;
@@ -140,4 +153,4 @@ declare function resolveDocPlayerAppearance(doc: Doc, overrides?: DocPlayerAppea
  */
 declare function useMediaClipDurations(schedule: ScheduledClip[], basePath: string, mediaProviderOverride?: MediaProvider | null): Map<string, number>;
 
-export { type DocPlayerAppearanceOverrides, type MountOptions, PipPosition, PipShape, PipSize, type ResolvedDocPlayerAppearance, type SquisqPlayerHandle, SquisqRenderAPI, VideoPresentation$1 as VideoPresentation, resolveDocPlayerAppearance, useMediaClipDurations };
+export { CodeBlockCopyHandler, type DocPlayerAppearanceOverrides, type MountOptions, PipPosition, PipShape, PipSize, type ResolvedDocPlayerAppearance, type SquisqPlayerHandle, SquisqRenderAPI, VideoPresentation$1 as VideoPresentation, resolveDocPlayerAppearance, useMediaClipDurations };

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   formatTime,
   resolveDocPlayerAppearance,
   useMediaClipDurations
-} from "./chunk-KF4DTT46.js";
+} from "./chunk-GWD62KLD.js";
 import {
   BlockRenderer,
   CanvasSection,
@@ -20,7 +20,7 @@ import {
   PageSectionView,
   PageViewContext,
   usePageView
-} from "./chunk-3HYSWEKG.js";
+} from "./chunk-U6P7HBUY.js";
 import {
   ImageLayer,
   MapLayer,
@@ -33,7 +33,7 @@ import {
   VideoLayer,
   getAnimationStyle,
   getTransitionClass
-} from "./chunk-MKWVJYUS.js";
+} from "./chunk-UJEHDVQO.js";
 import {
   useModalDialog
 } from "./chunk-65POMKHR.js";
@@ -42,10 +42,10 @@ import {
   useDocPlayback,
   useMediaSchedule,
   useViewportOrientation
-} from "./chunk-BOZJ655L.js";
+} from "./chunk-MVJQL2W2.js";
 import {
   JsonView
-} from "./chunk-DJRYQQXB.js";
+} from "./chunk-YKBVTYU4.js";
 import {
   useAutoSurface
 } from "./chunk-TT6ENR6T.js";
@@ -53,7 +53,7 @@ import {
   InlineAudioPlayer,
   InlineVideoPlayer,
   MarkdownRenderer
-} from "./chunk-VMPQEUJH.js";
+} from "./chunk-TMCLQNLM.js";
 import {
   MermaidDiagram
 } from "./chunk-WLUZTUNZ.js";

package/dist/json-view/index.js

@@ -1,8 +1,8 @@
 import {
   JsonView
-} from "../chunk-DJRYQQXB.js";
+} from "../chunk-YKBVTYU4.js";
 import "../chunk-TT6ENR6T.js";
-import "../chunk-VMPQEUJH.js";
+import "../chunk-TMCLQNLM.js";
 import "../chunk-WLUZTUNZ.js";
 import "../chunk-LR3AIGDD.js";
 export {

package/dist/layers/index.js

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

package/dist/markdown/index.d.ts

@@ -1,35 +1,7 @@
+export { a as CodeBlockCopyContext, C as CodeBlockCopyHandler, M as MarkdownRenderer, b as MarkdownRendererProps } from '../MarkdownRenderer-CerBKw-c.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Theme } from '@bendyline/squisq/schemas';
-import { MarkdownBlockNode, HtmlPolicy } from '@bendyline/squisq/markdown';
-
-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[];
-    /** Resolved Squisq theme inherited by embedded Mermaid diagrams. */
-    theme?: Theme;
-}
-/**
- * Renders MarkdownBlockNode[] AST as React HTML elements.
- *
- * @example
- * ```tsx
- * <MarkdownRenderer nodes={block.contents} />
- * ```
- */
-declare function MarkdownRenderer({ nodes, className, htmlPolicy, linkSchemes, theme, }: MarkdownRendererProps): react_jsx_runtime.JSX.Element | null;
+import '@bendyline/squisq/markdown';
 
 interface MermaidDiagramProps {
     source: string;
@@ -41,4 +13,4 @@ interface MermaidDiagramProps {
 /** Read-only Mermaid rendering for page bodies and slide layers. */
 declare function MermaidDiagram({ source, className, ariaLabel, theme, }: MermaidDiagramProps): react_jsx_runtime.JSX.Element;
 
-export { MarkdownRenderer, MermaidDiagram, type MermaidDiagramProps };
+export { MermaidDiagram, type MermaidDiagramProps };

package/dist/markdown/index.js

@@ -1,6 +1,6 @@
 import {
   MarkdownRenderer
-} from "../chunk-VMPQEUJH.js";
+} from "../chunk-TMCLQNLM.js";
 import {
   MermaidDiagram
 } from "../chunk-WLUZTUNZ.js";

package/dist/page/index.d.ts

@@ -1,7 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, ViewportConfig, Theme, SurfaceScheme, ThemePageStyle } from '@bendyline/squisq/schemas';
 import { PageTransformHints, PageSectionMaterialization, PageSection, MaterializeBlockLayersOptions } from '@bendyline/squisq/doc';
+import { C as CodeBlockCopyHandler } from '../MarkdownRenderer-CerBKw-c.js';
+export { a as CodeBlockCopyContext } from '../MarkdownRenderer-CerBKw-c.js';
 import * as react from 'react';
+import '@bendyline/squisq/markdown';
 
 interface LinearDocViewProps {
     /**
@@ -63,6 +66,10 @@ interface LinearDocViewProps {
      * emphasis-curve adjustments defined by `TransformStyleConfig.page`.
      */
     transformPage?: PageTransformHints;
+    /** Show a Copy button on ordinary fenced code blocks (default: false). */
+    showCodeCopyButton?: boolean;
+    /** Optional host clipboard adapter; otherwise the browser Clipboard API is used. */
+    onCopyCode?: CodeBlockCopyHandler;
 }
 type ImageDisplayMode = 'inline' | 'thumbnail';
 /**
@@ -73,7 +80,7 @@ type ImageDisplayMode = 'inline' | 'thumbnail';
  * <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;
+declare function LinearDocView({ doc, markdown, basePath, viewport, className, theme, surface, animationsEnabled, thinMargins, imageDisplayMode, globalKeyboardShortcuts, showCover, transformPage, showCodeCopyButton, onCopyCode, }: LinearDocViewProps): react_jsx_runtime.JSX.Element;
 
 interface PageSectionViewProps {
     entry: PageSectionMaterialization;
@@ -98,8 +105,10 @@ interface PageViewContextValue {
     renderContext: MaterializeBlockLayersOptions;
     animationsEnabled: boolean;
     imageDisplayMode: ImageDisplayMode;
+    showCodeCopyButton: boolean;
+    onCopyCode?: CodeBlockCopyHandler;
 }
 declare const PageViewContext: react.Context<PageViewContextValue>;
 declare function usePageView(): PageViewContextValue;
 
-export { CanvasSection, type CanvasSectionProps, type ImageDisplayMode, LinearDocView, type LinearDocViewProps, PageSectionView, type PageSectionViewProps, PageViewContext, type PageViewContextValue, usePageView };
+export { CanvasSection, type CanvasSectionProps, CodeBlockCopyHandler, type ImageDisplayMode, LinearDocView, type LinearDocViewProps, PageSectionView, type PageSectionViewProps, PageViewContext, type PageViewContextValue, usePageView };

package/dist/page/index.js

@@ -4,10 +4,10 @@ import {
   PageSectionView,
   PageViewContext,
   usePageView
-} from "../chunk-3HYSWEKG.js";
-import "../chunk-MKWVJYUS.js";
+} from "../chunk-U6P7HBUY.js";
+import "../chunk-UJEHDVQO.js";
 import "../chunk-TT6ENR6T.js";
-import "../chunk-VMPQEUJH.js";
+import "../chunk-TMCLQNLM.js";
 import "../chunk-WLUZTUNZ.js";
 import "../chunk-LR3AIGDD.js";
 export {

package/dist/player/index.d.ts

@@ -1,8 +1,11 @@
 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 } from '@bendyline/squisq/doc';
+import { ViewportConfig, CoverSlideTemplate, CoverSlidePlayback } from '@bendyline/squisq/doc';
 import { a as AudioController } from '../AudioController-DwMsPe38.js';
+import { C as CodeBlockCopyHandler } from '../MarkdownRenderer-CerBKw-c.js';
+export { a as CodeBlockCopyContext } from '../MarkdownRenderer-CerBKw-c.js';
 import { CSSProperties } from 'react';
+import '@bendyline/squisq/markdown';
 
 /**
  * Doc Player Control Types
@@ -222,6 +225,12 @@ interface DocPlayerProps {
     /** Video, manual slideshow, or long-scrolling linear rendition. */
     displayMode?: DisplayMode;
     showCoverSlide?: boolean;
+    /** Visual template used to materialize the managed cover. */
+    coverSlideTemplate?: CoverSlideTemplate;
+    /** Seconds the cover remains visible after Video playback starts. */
+    coverSlideDuration?: number;
+    /** Whether video export advances or delays the story while the cover is visible. */
+    coverSlidePlayback?: CoverSlidePlayback;
     coverVisible?: boolean;
     captionStyle?: CaptionStyle;
     /**
@@ -237,6 +246,10 @@ interface DocPlayerProps {
     pipPosition?: PipPosition;
     enableSwipe?: boolean;
     globalKeyboardShortcuts?: boolean;
+    /** Show a Copy button on fenced code blocks in linear mode (default: false). */
+    showCodeCopyButton?: boolean;
+    /** Optional host clipboard adapter; otherwise the browser Clipboard API is used. */
+    onCopyCode?: CodeBlockCopyHandler;
 }
 
 /**
@@ -455,4 +468,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, 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, 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

@@ -10,17 +10,17 @@ import {
   MediaClipLayer,
   SocialCaptionOverlay,
   formatTime
-} from "../chunk-KF4DTT46.js";
+} from "../chunk-GWD62KLD.js";
 import {
   BlockRenderer
-} from "../chunk-3HYSWEKG.js";
-import "../chunk-MKWVJYUS.js";
-import "../chunk-BOZJ655L.js";
+} from "../chunk-U6P7HBUY.js";
+import "../chunk-UJEHDVQO.js";
+import "../chunk-MVJQL2W2.js";
 import "../chunk-TT6ENR6T.js";
 import {
   InlineAudioPlayer,
   InlineVideoPlayer
-} from "../chunk-VMPQEUJH.js";
+} from "../chunk-TMCLQNLM.js";
 import "../chunk-WLUZTUNZ.js";
 import "../chunk-LR3AIGDD.js";
 export {