@bendyline/squisq 2.4.0 → 2.4.2

package/dist/{Doc-DLpyOAXJ.d.ts → Doc-BKKcPjfe.d.ts}

@@ -1,4 +1,4 @@
-import { a0 as Transition, a2 as TransitionType, M as MarkdownBlockNode, r as MarkdownHeading } from './types-CUNc9biN.js';
+import { a1 as Transition, a3 as TransitionType, M as MarkdownBlockNode, r as MarkdownHeading } from './types-CcrDFdWH.js';
 
 /**
  * Media-clip timing model.
@@ -25,6 +25,14 @@ import { a0 as Transition, a2 as TransitionType, M as MarkdownBlockNode, r as Ma
  * above the composed slide.
  */
 type VideoPlacement = 'content' | 'picture-in-picture' | 'overlay';
+/** Player-level placement of scheduled video relative to slide content. */
+type VideoPresentation = 'background' | 'full-frame' | 'picture-in-picture';
+/** Optional per-video override for picture-in-picture size. */
+type VideoPipSize = 'small' | 'large';
+/** Optional per-video override for the picture-in-picture frame shape. */
+type VideoPipShape = 'square' | 'wide';
+/** Optional per-video override for the picture-in-picture corner. */
+type VideoPipPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 /**
  * A timed piece of media attached to a block (or the document).
  */
@@ -36,6 +44,12 @@ interface MediaClip {
     kind: 'audio' | 'video';
     /** Per-video placement. Omitted audio and legacy video use player defaults. */
     placement?: Exclude<VideoPlacement, 'content'>;
+    /** Per-video PIP size. Omitted clips use the document/player setting. */
+    pipSize?: VideoPipSize;
+    /** Per-video PIP shape. Omitted clips use the document/player setting. */
+    pipShape?: VideoPipShape;
+    /** Per-video PIP corner. Omitted clips use the document/player setting. */
+    pipPosition?: VideoPipPosition;
     /**
      * Whether a placed video is locked to its owning block's timeline span.
      * `true` clips start with and are capped by the block. `false` clips are
@@ -95,6 +109,12 @@ interface ScheduledClip {
     kind: 'audio' | 'video';
     /** Per-video placement carried through to the player-level compositor. */
     placement?: Exclude<VideoPlacement, 'content'>;
+    /** Per-video PIP size carried through to the player-level compositor. */
+    pipSize?: VideoPipSize;
+    /** Per-video PIP shape carried through to the player-level compositor. */
+    pipShape?: VideoPipShape;
+    /** Per-video PIP corner carried through to the player-level compositor. */
+    pipPosition?: VideoPipPosition;
     /** Authored placed-video lock state, when applicable. */
     lockToBlock?: boolean;
     /** Absolute doc-timeline second the clip starts. */
@@ -109,17 +129,36 @@ interface ScheduledClip {
     /** 1-based source line of the authoring annotation, when known. */
     sourceLine?: number;
 }
+/** Options for {@link resolveMediaSchedule} / {@link getDocPlaybackDuration}. */
+interface MediaScheduleOptions {
+    /**
+     * Optional lookup of a media file's intrinsic duration in seconds (e.g.
+     * probed from the decoded file). When a clip has no authored out-point
+     * (`clipEnd`) and is not locked to its block, its scheduled end is capped at
+     * this natural length instead of filling to the block/document end — so an
+     * unlocked video plays for its own length and then goes inactive rather than
+     * holding its last frame until the timeline ends.
+     *
+     * Applied only as an upper bound: it can pull a clip's end earlier but never
+     * extends it, so the overall timeline length is unchanged. Return undefined
+     * (the default when no probe is wired) to preserve the historical
+     * fill-to-end behavior. Locked clips ignore it — they fill their owning
+     * block by design.
+     */
+    intrinsicDuration?: (clip: MediaClip) => number | undefined;
+}
 /**
  * Flatten every block clip and document clip into absolute-timed
- * `ScheduledClip`s. Pure — depends only on `doc`.
+ * `ScheduledClip`s. Pure — depends only on `doc` (plus the optional intrinsic
+ * media durations in {@link MediaScheduleOptions}).
  */
-declare function resolveMediaSchedule(doc: Doc): ScheduledClip[];
+declare function resolveMediaSchedule(doc: Doc, opts?: MediaScheduleOptions): ScheduledClip[];
 /**
  * Total playback duration including any media that spills past the last
  * block (or audio segment). Export uses this for the frame count and the
  * player for its effective timeline length.
  */
-declare function getDocPlaybackDuration(doc: Doc): number;
+declare function getDocPlaybackDuration(doc: Doc, opts?: MediaScheduleOptions): number;
 
 /**
  * Viewport Configuration
@@ -282,13 +321,13 @@ declare function getSafeTextBounds(orientation: ViewportOrientation): {
 /**
  * Block Templates Schema
  *
- * Defines a template system for AI-generated doc blocks. Instead of
- * specifying low-level layers, positions, and animations, AI can use
+ * Defines a template system for generated or programmatic doc blocks. Instead
+ * of specifying low-level layers, positions, and animations, callers can use
  * high-level templates like "title" or "statHighlight" with simple
  * content parameters.
  *
  * Templates are expanded into full Block structures at render time,
- * ensuring consistent styling and reducing AI generation errors.
+ * ensuring consistent styling and reducing generation errors.
  *
  * Template Types:
  * - title: Doc intro with title + subtitle
@@ -1510,6 +1549,41 @@ interface ThemeStyle {
      * template via `imageTreatment: 'none'`.
      */
     imageTreatment?: ImageTreatment;
+    /**
+     * Framing for scheduled picture-in-picture presenter video, so a theme can
+     * style the PiP (border, shadow, corner radius) to match. All fields are
+     * optional — anything omitted is derived from the rest of the theme by
+     * `pipStyleVars()`. See {@link PipStyle}.
+     */
+    pip?: PipStyle;
+}
+/**
+ * Theme-driven framing for scheduled picture-in-picture presenter video. Every
+ * field is optional; `pipStyleVars()` fills any gaps by deriving a fitting
+ * default from the palette and {@link ThemeStyle.borderRadius}, so a theme that
+ * declares no `pip` block still gets a PiP consistent with its look.
+ */
+interface PipStyle {
+    /**
+     * Corner radius of the PiP frame — a number (px), a CSS length/percentage
+     * string (e.g. `'18%'`, `'50%'`), or `0` for square corners. Omitted →
+     * derived from {@link ThemeStyle.borderRadius} (0 stays square).
+     */
+    cornerRadius?: number | string;
+    /**
+     * Frame border. `'none'` removes it; an explicit `{ width, color }` sets it.
+     * Omitted → a subtle rim in the theme's text color that reads on both light
+     * and dark slides.
+     */
+    border?: 'none' | {
+        width?: number | string;
+        color?: string;
+    };
+    /**
+     * Drop shadow. `false` / `'none'` → no shadow; `true` (or omitted) → a soft
+     * themed shadow; a string → an explicit CSS `box-shadow` value.
+     */
+    shadow?: boolean | string;
 }
 /**
  * Render-style algorithm preset. Controls layout tweaks, default animations,
@@ -1744,6 +1818,29 @@ interface CustomTemplateDefinition {
      */
     layers: CustomTemplateLayer[];
 }
+/** A structural problem found while decoding a custom template. */
+interface CustomTemplateValidationError {
+    /** JSON-style path to the invalid value. */
+    path: string;
+    /** Human-readable description of the required shape. */
+    message: string;
+}
+/** Result returned by {@link validateCustomTemplateDefinition}. */
+interface CustomTemplateValidationResult {
+    valid: boolean;
+    errors: CustomTemplateValidationError[];
+    /** Present only when the complete input is structurally valid. */
+    template?: CustomTemplateDefinition;
+}
+/**
+ * Validate an untrusted custom-template definition before it reaches template
+ * expansion or rendering. Unknown object keys are ignored for forward
+ * compatibility, but every currently supported layer's required shape is
+ * checked recursively.
+ */
+declare function validateCustomTemplateDefinition(input: unknown): CustomTemplateValidationResult;
+/** Type guard form of {@link validateCustomTemplateDefinition}. */
+declare function isCustomTemplateDefinition(input: unknown): input is CustomTemplateDefinition;
 /**
  * Tag value for the YAML frontmatter key that carries inlined custom
  * template definitions. Exported so the markdown bridge stays in sync.
@@ -1819,7 +1916,7 @@ interface Doc {
     blocks: Block[];
     /** Audio track configuration */
     audio: AudioTrack;
-    /** Caption track for closed captions (generated by postprocess-doc) */
+    /** Optional caption track for closed captions. */
     captions?: CaptionTrack;
     /**
      * Start/resting block shown before playback begins.
@@ -1910,6 +2007,30 @@ interface Doc {
  * Merge order at render time: template defaults → `templateData` →
  * `templateOverrides`.
  */
+/**
+ * Provenance for a template tag that an author (usually an LLM) placed in a
+ * block's BODY instead of on its heading, and which `markdownToDoc` promoted to
+ * the block's template. Ephemeral — like `autoTemplate` — but round-tripped
+ * lazily: `docToMarkdown` re-emits the tag in the body verbatim while the block
+ * is unedited, and relocates it onto the heading (`# Heading {[…]}`) once the
+ * block's `template`/`templateOverrides` change. See `promoteBodyAnnotation.ts`.
+ */
+interface PromotedBodyAnnotation {
+    /** Authored template name (pre-alias), e.g. `title` or `titleBlock`. */
+    template: string;
+    /** Authored params, unquoted/unescaped. */
+    params: Record<string, string>;
+    /** Where the tag lived in the body, for byte-faithful re-emission. */
+    origin: {
+        kind: 'paragraph';
+        index: number;
+        raw: string;
+    } | {
+        kind: 'trailing';
+        index: number;
+        suffix: string;
+    };
+}
 interface Block {
     /** Unique identifier for this block.
      *  Defaults to a slug derived from the heading text. May be overridden by
@@ -1976,6 +2097,13 @@ interface Block {
         template?: string;
         params?: Record<string, string>;
     };
+    /**
+     * Set when this block's `template` was PROMOTED from a `{[…]}` tag that
+     * appeared in the block's body (rather than on the heading). Ephemeral and
+     * round-tripped lazily by `docToMarkdown`: the tag stays in the body until the
+     * block is edited, then moves onto the heading. See `promoteBodyAnnotation.ts`.
+     */
+    promotedBodyAnnotation?: PromotedBodyAnnotation;
     /**
      * Display title for template rendering.
      * Extracted from the sourceHeading when the block is created by markdownToDoc().
@@ -2642,4 +2770,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { LIGHT_SURFACE as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, type DateEventInput as E, type DeepPartial as F, type DefinitionCardInput as G, type DiagramBlockInput as H, type DiagramEdgeAnchor as I, type DiagramTemplateEdge as J, type DiagramTemplateNode as K, type Doc as L, type DocBlock as M, type DocDiagnostic as N, type DonutChartInput as O, type DrawingBlockInput as P, FRONTMATTER_CUSTOM_TEMPLATES_KEY as Q, FRONTMATTER_CUSTOM_THEMES_KEY as R, type FactCardInput as S, type FontFamily as T, type FontFamilyKind as U, type FullBleedQuoteInput as V, type GradientBackgroundConfig as W, type ImageBackgroundConfig as X, type ImageLayer as Y, type ImageTreatment as Z, type ImageWithCaptionInput as _, type AccentPosition as a, type StartBlockConfig as a$, type Layer as a0, type LayerRepeat as a1, type LayoutHints as a2, type LeftFeatureInput as a3, type LineChartInput as a4, type LinearGradient as a5, type ListBlockInput as a6, type MapBlockInput as a7, type MapLayer as a8, type MapMarker as a9, type PageHeadingTreatment as aA, type PageSectionKind as aB, type PageSectionOverride as aC, type PageTokens as aD, type PathLayer as aE, type PatternBackgroundConfig as aF, type PersistentLayer as aG, type PersistentLayerConfig as aH, type PersistentLayerTemplate as aI, type PersistentLayerTemplateConfig as aJ, type PersistentLayerTemplateType as aK, type PhotoGridInput as aL, type PieChartInput as aM, type Position as aN, type ProgressIndicatorConfig as aO, type PullQuoteInput as aP, type QuoteBlockInput as aQ, type RawLayersInput as aR, type RenderStyle as aS, type RightFeatureInput as aT, type ScatterChartInput as aU, type ScheduledClip as aV, type SectionHeaderInput as aW, type ShapeFilter as aX, type ShapeLayer as aY, type ShapePattern as aZ, type SolidBackgroundConfig as a_, type MapTileStyle as aa, type MarkerStyle as ab, type MediaClip as ac, type MermaidLayer as ad, PAGE_ACCENT_STRATEGIES as ae, PAGE_BACKGROUNDS as af, PAGE_BACKGROUND_RHYTHMS as ag, PAGE_DESIGN_FAMILIES as ah, PAGE_DIVIDERS as ai, PAGE_EMPHASES as aj, PAGE_EYEBROWS as ak, PAGE_HEADING_CASES as al, PAGE_HEADING_SCALES as am, PAGE_HEADING_UNDERLINES as an, PAGE_HERO_STYLES as ao, PAGE_IMAGE_FRAMINGS as ap, PAGE_NUMERAL_STYLES as aq, PAGE_PATTERNS as ar, PAGE_QUOTE_MARKS as as, PAGE_SECTION_KINDS as at, PAGE_SECTION_SPACINGS as au, PAGE_SHADOWS as av, type PageAccentRotation as aw, type PageBackground as ax, type PageDesignFamily as ay, type PageEmphasis as az, type AmbientGradientConfig as b, type StatHighlightInput as b0, type SurfaceScheme as b1, THEME_SCHEMA_VERSION as b2, type TableLayer as b3, type TableLayerStyle as b4, type TemplateBlock as b5, type TemplateContext as b6, type TemplateFunction as b7, type TemplateRegistry as b8, type TextLayer as b9, type VideoWithCaptionInput as bA, type ViewportConfig as bB, type ViewportOrientation as bC, type ViewportPreset as bD, type VignetteConfig as bE, applySurface as bF, calculateDuration as bG, calculateFontScale as bH, createTemplateContext as bI, createTheme as bJ, createThemeRegistry as bK, getAspectRatioString as bL, getBlockAtTime as bM, getCaptionAtTime as bN, getDocPlaybackDuration as bO, getLayoutHints as bP, getSafeTextBounds as bQ, getSegmentAtTime as bR, getTwoColumnPositions as bS, getViewport as bT, getViewportOrientation as bU, isPersistentLayerTemplate as bV, isTemplateBlock as bW, scaledFontSize$1 as bX, resolveMediaSchedule as bY, scaledFontSize as bZ, type TextStyle as ba, type Theme as bb, type ThemeColorPalette as bc, type ThemeColorScheme as bd, type ThemePageStyle as be, type ThemeRegistry as bf, type ThemeSchemaVersion as bg, type ThemeSeedColors as bh, type ThemeStyle as bi, type ThemeTypography as bj, type TimelineBlockInput as bk, type TimelineTemplateEvent as bl, type TimelineTemplateLink as bm, type TimelineTemplateTrack as bn, type TitleBlockInput as bo, type TitleCaptionConfig as bp, type TreeBlockInput as bq, type TreeLayer as br, type TreeLayerItem as bs, type TreeLayerStyle as bt, type TreeTemplateItem as bu, type TwoColumnInput as bv, VIEWPORT_PRESETS as bw, type VideoLayer as bx, type VideoPlacement as by, type VideoPullQuoteInput as bz, type Animation as c, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type Block as j, type BlockConnection as k, type BorderStyle as l, type CaptionTrack as m, type CaptionWord as n, type ChartBaseFields as o, type ChartTemplateInput as p, type ColorScheme as q, type ColumnChartInput as r, type ComparisonBarInput as s, type ContentBlockInput as t, type CornerBrandingConfig as u, type CustomTemplateDefinition as v, type CustomTemplateLayer as w, DEFAULT_DOC_FONT as x, DEFAULT_TITLE_FONT as y, type DataTableInput as z };
+export { type ImageTreatment as $, type AccentImage as A, type BarChartInput as B, type CaptionPhrase as C, DARK_SURFACE as D, DEFAULT_TITLE_FONT as E, type DataTableInput as F, type DateEventInput as G, type DeepPartial as H, type DefinitionCardInput as I, type DiagramBlockInput as J, type DiagramEdgeAnchor as K, type DiagramTemplateEdge as L, type DiagramTemplateNode as M, type Doc as N, type DocBlock as O, type DocDiagnostic as P, type DonutChartInput as Q, type DrawingBlockInput as R, FRONTMATTER_CUSTOM_TEMPLATES_KEY as S, FRONTMATTER_CUSTOM_THEMES_KEY as T, type FactCardInput as U, type FontFamily as V, type FontFamilyKind as W, type FullBleedQuoteInput as X, type GradientBackgroundConfig as Y, type ImageBackgroundConfig as Z, type ImageLayer as _, type AccentPosition as a, type SectionHeaderInput as a$, type ImageWithCaptionInput as a0, LIGHT_SURFACE as a1, type Layer as a2, type LayerRepeat as a3, type LayoutHints as a4, type LeftFeatureInput as a5, type LineChartInput as a6, type LinearGradient as a7, type ListBlockInput as a8, type MapBlockInput as a9, type PageBackground as aA, type PageDesignFamily as aB, type PageEmphasis as aC, type PageHeadingTreatment as aD, type PageSectionKind as aE, type PageSectionOverride as aF, type PageTokens as aG, type PathLayer as aH, type PatternBackgroundConfig as aI, type PersistentLayer as aJ, type PersistentLayerConfig as aK, type PersistentLayerTemplate as aL, type PersistentLayerTemplateConfig as aM, type PersistentLayerTemplateType as aN, type PhotoGridInput as aO, type PieChartInput as aP, type PipStyle as aQ, type Position as aR, type ProgressIndicatorConfig as aS, type PromotedBodyAnnotation as aT, type PullQuoteInput as aU, type QuoteBlockInput as aV, type RawLayersInput as aW, type RenderStyle as aX, type RightFeatureInput as aY, type ScatterChartInput as aZ, type ScheduledClip as a_, type MapLayer as aa, type MapMarker as ab, type MapTileStyle as ac, type MarkerStyle as ad, type MediaClip as ae, type MediaScheduleOptions as af, type MermaidLayer as ag, PAGE_ACCENT_STRATEGIES as ah, PAGE_BACKGROUNDS as ai, PAGE_BACKGROUND_RHYTHMS as aj, PAGE_DESIGN_FAMILIES as ak, PAGE_DIVIDERS as al, PAGE_EMPHASES as am, PAGE_EYEBROWS as an, PAGE_HEADING_CASES as ao, PAGE_HEADING_SCALES as ap, PAGE_HEADING_UNDERLINES as aq, PAGE_HERO_STYLES as ar, PAGE_IMAGE_FRAMINGS as as, PAGE_NUMERAL_STYLES as at, PAGE_PATTERNS as au, PAGE_QUOTE_MARKS as av, PAGE_SECTION_KINDS as aw, PAGE_SECTION_SPACINGS as ax, PAGE_SHADOWS as ay, type PageAccentRotation as az, type AmbientGradientConfig as b, getTwoColumnPositions as b$, type ShapeFilter as b0, type ShapeLayer as b1, type ShapePattern as b2, type SolidBackgroundConfig as b3, type StartBlockConfig as b4, type StatHighlightInput as b5, type SurfaceScheme as b6, THEME_SCHEMA_VERSION as b7, type TableLayer as b8, type TableLayerStyle as b9, type TwoColumnInput as bA, VIEWPORT_PRESETS as bB, type VideoLayer as bC, type VideoPipPosition as bD, type VideoPipShape as bE, type VideoPipSize as bF, type VideoPlacement as bG, type VideoPresentation as bH, type VideoPullQuoteInput as bI, type VideoWithCaptionInput as bJ, type ViewportConfig as bK, type ViewportOrientation as bL, type ViewportPreset as bM, type VignetteConfig as bN, applySurface as bO, calculateDuration as bP, calculateFontScale as bQ, createTemplateContext as bR, createTheme as bS, createThemeRegistry as bT, getAspectRatioString as bU, getBlockAtTime as bV, getCaptionAtTime as bW, getDocPlaybackDuration as bX, getLayoutHints as bY, getSafeTextBounds as bZ, getSegmentAtTime as b_, type TemplateBlock as ba, type TemplateContext as bb, type TemplateFunction as bc, type TemplateRegistry as bd, type TextLayer as be, type TextStyle as bf, type Theme as bg, type ThemeColorPalette as bh, type ThemeColorScheme as bi, type ThemePageStyle as bj, type ThemeRegistry as bk, type ThemeSchemaVersion as bl, type ThemeSeedColors as bm, type ThemeStyle as bn, type ThemeTypography as bo, type TimelineBlockInput as bp, type TimelineTemplateEvent as bq, type TimelineTemplateLink as br, type TimelineTemplateTrack as bs, type TitleBlockInput as bt, type TitleCaptionConfig as bu, type TreeBlockInput as bv, type TreeLayer as bw, type TreeLayerItem as bx, type TreeLayerStyle as by, type TreeTemplateItem as bz, type Animation as c, getViewport as c0, getViewportOrientation as c1, isCustomTemplateDefinition as c2, isPersistentLayerTemplate as c3, isTemplateBlock as c4, scaledFontSize$1 as c5, resolveMediaSchedule as c6, scaledFontSize as c7, validateCustomTemplateDefinition as c8, type AnimationType as d, type AreaChartInput as e, type AudioBookmark as f, type AudioSegment as g, type AudioTimingData as h, type AudioTrack as i, type Block as j, type BlockConnection as k, type BorderStyle as l, type CaptionTrack as m, type CaptionWord as n, type ChartBaseFields as o, type ChartTemplateInput as p, type ColorScheme as q, type ColumnChartInput as r, type ComparisonBarInput as s, type ContentBlockInput as t, type CornerBrandingConfig as u, type CustomTemplateDefinition as v, type CustomTemplateLayer as w, type CustomTemplateValidationError as x, type CustomTemplateValidationResult as y, DEFAULT_DOC_FONT as z };

package/dist/{ImageEditDoc-Cu30xb9b.d.ts → ImageEditDoc-CU1cXxRd.d.ts}

@@ -1,4 +1,4 @@
-import { Y as ImageLayer, b9 as TextLayer, aY as ShapeLayer, aE as PathLayer } from './Doc-DLpyOAXJ.js';
+import { _ as ImageLayer, be as TextLayer, b1 as ShapeLayer, aH as PathLayer } from './Doc-BKKcPjfe.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/{annotationCoercion-PtRQhk5V.d.ts → annotationCoercion-CPHEggo3.d.ts}

@@ -1,4 +1,4 @@
-import { ab as BlockConnection, a2 as TransitionType, a1 as TransitionDirection } from './types-CUNc9biN.js';
+import { ac as BlockConnection, a3 as TransitionType, a2 as TransitionDirection } from './types-CcrDFdWH.js';
 
 /**
  * Heading-attribute value coercion.

package/dist/{chunk-F2IEPSMA.js → chunk-2HY2ZA7U.js}

@@ -30,9 +30,10 @@ import {
   pickContrastingText,
   relativeLuminance,
   resolveFontFamily,
+  validateCustomTemplateDefinition,
   validateTheme,
   withAlpha
-} from "./chunk-C33GTPUZ.js";
+} from "./chunk-SBAX4ZPO.js";
 import {
   VIEWPORT_PRESETS,
   cloneData,
@@ -45,14 +46,17 @@ import {
 } from "./chunk-BAOV476U.js";
 import {
   KNOWN_BLOCK_META_KEYS,
+  TABLE_FED_TEMPLATES,
   coerceAnnotationValues,
+  isContainerTemplate,
   matchTrailingTemplateAnnotation,
   parseNumber,
   parseTimeSeconds,
+  resolveTemplateName,
   sanitizeUrl,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-2VCNTDNZ.js";
+} from "./chunk-D6YTLQCL.js";
 import {
   extractPlainText,
   readFrontmatterThemeId,
@@ -411,33 +415,6 @@ function wrapWithPersistentLayers(layers, block, bottomLayers, topLayers) {
   ];
 }
 
-// src/doc/templates/templateNames.ts
-var TEMPLATE_ALIASES = Object.freeze({
-  titleBlock: "title",
-  quoteBlock: "quote",
-  mapBlock: "map",
-  listBlock: "list",
-  diagramBlock: "diagram",
-  diagramNode: "diagram"
-});
-function resolveTemplateName(name) {
-  return TEMPLATE_ALIASES[name] ?? name;
-}
-var TABLE_FED_TEMPLATES = /* @__PURE__ */ new Set([
-  "dataTable",
-  "barChart",
-  "columnChart",
-  "pieChart",
-  "donutChart",
-  "lineChart",
-  "areaChart",
-  "scatterChart"
-]);
-var CONTAINER_TEMPLATES = /* @__PURE__ */ new Set(["diagram", "drawing", "layout"]);
-function isContainerTemplate(name) {
-  return !!name && CONTAINER_TEMPLATES.has(resolveTemplateName(name));
-}
-
 // src/doc/utils/themeUtils.ts
 var FALLBACK_COLOR_SCHEME = {
   bg: "#1a365d",
@@ -8919,7 +8896,8 @@ function expandDocBlocks(blocks, options = {}) {
     audioSegments,
     customTemplates,
     failureMode = "fallback",
-    onDiagnostic
+    onDiagnostic,
+    splitLongBlocks = true
   } = opts;
   const totalBlocks = blocks.length;
   const registry = customTemplates && customTemplates.length > 0 ? buildRegistry(customTemplates) : templateRegistry;
@@ -9110,27 +9088,29 @@ function expandDocBlocks(blocks, options = {}) {
       }
     }
     const MAX_BLOCK_DURATION = 20;
-    for (let i = 0; i < segmentExpandedBlocks.length; i++) {
-      const block = segmentExpandedBlocks[i];
-      if (block.duration > MAX_BLOCK_DURATION) {
-        const numParts = Math.ceil(block.duration / MAX_BLOCK_DURATION);
-        const partDuration = block.duration / numParts;
-        if (partDuration >= MIN_TRANSITION_GAP) {
-          block.duration = partDuration;
-          for (let p = 1; p < numParts; p++) {
-            const splitBlock = {
-              id: `${block.id}-split-${p}`,
-              startTime: block.startTime + p * partDuration,
-              duration: partDuration,
-              audioSegment: block.audioSegment,
-              layers: (block.layers ?? []).map((layer) => ({
-                ...cloneData(layer),
-                id: `${layer.id}-split-${p}`
-              })),
-              transition: { type: "dissolve", duration: 1 },
-              template: block.template
-            };
-            expandedBlocks.push(splitBlock);
+    if (splitLongBlocks) {
+      for (let i = 0; i < segmentExpandedBlocks.length; i++) {
+        const block = segmentExpandedBlocks[i];
+        if (block.duration > MAX_BLOCK_DURATION) {
+          const numParts = Math.ceil(block.duration / MAX_BLOCK_DURATION);
+          const partDuration = block.duration / numParts;
+          if (partDuration >= MIN_TRANSITION_GAP) {
+            block.duration = partDuration;
+            for (let p = 1; p < numParts; p++) {
+              const splitBlock = {
+                id: `${block.id}-split-${p}`,
+                startTime: block.startTime + p * partDuration,
+                duration: partDuration,
+                audioSegment: block.audioSegment,
+                layers: (block.layers ?? []).map((layer) => ({
+                  ...cloneData(layer),
+                  id: `${layer.id}-split-${p}`
+                })),
+                transition: { type: "dissolve", duration: 1 },
+                template: block.template
+              };
+              expandedBlocks.push(splitBlock);
+            }
           }
         }
       }
@@ -9230,16 +9210,15 @@ function readCustomTemplatesFromFrontmatter(frontmatter) {
   for (const entry of candidates) {
     if (!entry || typeof entry !== "object") continue;
     const e = entry;
-    if (typeof e.name !== "string" || typeof e.label !== "string") continue;
-    if (!Array.isArray(e.layers)) continue;
-    const def = {
+    const candidate = {
       name: e.name,
       label: e.label,
-      viewport: readViewport(e.viewport),
+      viewport: e.viewport ?? { ...DEFAULT_VIEWPORT },
       layers: e.layers
     };
-    if (typeof e.description === "string") def.description = e.description;
-    out.push(def);
+    if (e.description !== void 0) candidate.description = e.description;
+    const result = validateCustomTemplateDefinition(candidate);
+    if (result.template) out.push(result.template);
   }
   return out.length > 0 ? out : void 0;
 }
@@ -9255,15 +9234,6 @@ function writeCustomTemplatesToFrontmatter(templates, options) {
   }
   return JSON.stringify(map, null, options?.pretty ? 2 : void 0);
 }
-function readViewport(raw) {
-  if (raw && typeof raw === "object") {
-    const v = raw;
-    const w = typeof v.width === "number" ? v.width : DEFAULT_VIEWPORT.width;
-    const h = typeof v.height === "number" ? v.height : DEFAULT_VIEWPORT.height;
-    return { width: w, height: h };
-  }
-  return DEFAULT_VIEWPORT;
-}
 function expandCompactMap(map) {
   return Object.entries(map).map(([name, raw]) => {
     const e = raw && typeof raw === "object" ? raw : {};
@@ -9506,14 +9476,8 @@ function extractTableData(table) {
 }
 
 // src/doc/standaloneAnnotation.ts
-function parseStandaloneAnnotation(node) {
-  if (node.type !== "paragraph") return null;
-  const children = node.children ?? [];
-  if (children.length !== 1 || children[0].type !== "text") return null;
-  const text = children[0].value.trim();
-  const match = matchTrailingTemplateAnnotation(text);
-  if (!match || match.index !== 0) return null;
-  const tokens = tokenizeAttrTokens(match.inner.trim());
+function parseAnnotationInner(inner) {
+  const tokens = tokenizeAttrTokens(inner.trim());
   const firstIsParam = tokens.length > 0 && tokens[0].indexOf("=") > 0;
   const template = firstIsParam || tokens.length === 0 ? void 0 : tokens[0];
   const startIdx = firstIsParam ? 0 : 1;
@@ -9524,6 +9488,15 @@ function parseStandaloneAnnotation(node) {
   }
   return { template, params };
 }
+function parseStandaloneAnnotation(node) {
+  if (node.type !== "paragraph") return null;
+  const children = node.children ?? [];
+  if (children.length !== 1 || children[0].type !== "text") return null;
+  const text = children[0].value.trim();
+  const match = matchTrailingTemplateAnnotation(text);
+  if (!match || match.index !== 0) return null;
+  return parseAnnotationInner(match.inner);
+}
 
 // src/doc/mediaAnnotations.ts
 var MEDIA_TEMPLATES = /* @__PURE__ */ new Set(["audio", "video", "media"]);
@@ -9546,6 +9519,15 @@ function videoPlacement(params) {
 function lockToBlock(raw) {
   return raw !== "false" && raw !== "0";
 }
+function videoPipSize(raw) {
+  return raw === "small" || raw === "large" ? raw : void 0;
+}
+function videoPipShape(raw) {
+  return raw === "square" || raw === "wide" ? raw : void 0;
+}
+function videoPipPosition(raw) {
+  return raw === "top-left" || raw === "top-right" || raw === "bottom-left" || raw === "bottom-right" ? raw : void 0;
+}
 function toMediaClip(parsed, id) {
   const { template, params } = parsed;
   if (!template || !MEDIA_TEMPLATES.has(template)) return null;
@@ -9562,6 +9544,12 @@ function toMediaClip(parsed, id) {
   };
   const placement = kind === "video" ? videoPlacement(params) : void 0;
   if (placement && placement !== "content") clip.placement = placement;
+  const pipSize = videoPipSize(params.pipSize);
+  const pipShape = videoPipShape(params.pipShape);
+  const pipPosition = videoPipPosition(params.pipPosition);
+  if (pipSize) clip.pipSize = pipSize;
+  if (pipShape) clip.pipShape = pipShape;
+  if (pipPosition) clip.pipPosition = pipPosition;
   if (kind === "video" && placement && placement !== "content" && params.lockToBlock != null) {
     const locked = lockToBlock(params.lockToBlock);
     clip.lockToBlock = locked;
@@ -9626,6 +9614,12 @@ function htmlVideoClip(node, id) {
     startAt: locked ? 0 : time(element.attributes["data-squisq-video-start-at"]) ?? 0,
     anchor: locked ? "block" : "document"
   };
+  const pipSize = videoPipSize(element.attributes["data-squisq-video-pip-size"]);
+  const pipShape = videoPipShape(element.attributes["data-squisq-video-pip-shape"]);
+  const pipPosition = videoPipPosition(element.attributes["data-squisq-video-pip-position"]);
+  if (pipSize) clip.pipSize = pipSize;
+  if (pipShape) clip.pipShape = pipShape;
+  if (pipPosition) clip.pipPosition = pipPosition;
   const clipStart = time(element.attributes["data-squisq-video-clip-start"]);
   const clipEnd = time(element.attributes["data-squisq-video-clip-end"]);
   if (clipStart != null) clip.clipStart = clipStart;
@@ -9716,6 +9710,78 @@ function extractTemplateBlocksFromContents(contents, options) {
   return { leading, blocks };
 }
 
+// src/doc/promoteBodyAnnotation.ts
+function lastTextChildValue(node) {
+  if (node.type !== "paragraph") return null;
+  const children = node.children;
+  if (children.length === 0) return null;
+  const last = children[children.length - 1];
+  return last.type === "text" ? last.value : null;
+}
+function isBodyAnnotationNode(node) {
+  if (parseStandaloneAnnotation(node)?.template) return true;
+  const value = lastTextChildValue(node);
+  if (value == null) return false;
+  const match = matchTrailingTemplateAnnotation(value);
+  return !!match && match.index > 0 && !!parseAnnotationInner(match.inner).template;
+}
+function stripTrailingToken(contents, index, cut) {
+  const out = [...contents];
+  const para = out[index];
+  if (para.type !== "paragraph") return out;
+  const children = [...para.children];
+  const last = children[children.length - 1];
+  if (last.type !== "text") return out;
+  const kept = last.value.slice(0, cut);
+  if (kept.length === 0 && children.length === 1) {
+    out.splice(index, 1);
+  } else {
+    children[children.length - 1] = { ...last, value: kept };
+    out[index] = { ...para, children };
+  }
+  return out;
+}
+function detectPromotableBodyAnnotation(contents) {
+  if (!contents || contents.length === 0) return null;
+  const lastIndex = contents.length - 1;
+  const last = contents[lastIndex];
+  let data = null;
+  let strippedContents = null;
+  const whole = parseStandaloneAnnotation(last);
+  if (whole?.template && last.type === "paragraph") {
+    const first = last.children[0];
+    data = {
+      template: whole.template,
+      params: whole.params,
+      origin: {
+        kind: "paragraph",
+        index: lastIndex,
+        raw: first && first.type === "text" ? first.value.trim() : ""
+      }
+    };
+    strippedContents = contents.slice(0, lastIndex);
+  } else {
+    const value = lastTextChildValue(last);
+    const match = value != null ? matchTrailingTemplateAnnotation(value) : null;
+    if (value != null && match && match.index > 0) {
+      const parsed = parseAnnotationInner(match.inner);
+      if (parsed.template) {
+        data = {
+          template: parsed.template,
+          params: parsed.params,
+          origin: { kind: "trailing", index: lastIndex, suffix: value.slice(match.index) }
+        };
+        strippedContents = stripTrailingToken(contents, lastIndex, match.index);
+      }
+    }
+  }
+  if (!data || !strippedContents) return null;
+  for (let i = 0; i < lastIndex; i++) {
+    if (isBodyAnnotationNode(contents[i])) return null;
+  }
+  return { data, strippedContents };
+}
+
 // src/doc/markdownToDoc.ts
 var SLUG_NON_WORD_RE = /[^\w\s-]/g;
 var SLUG_SPACES_RE = /[\s_]+/g;
@@ -9761,6 +9827,9 @@ function pinnedHeadingMeta(heading) {
   return { ...fromAnnotation, ...fromPandoc };
 }
 function pinnedMeta(block) {
+  if (block.promotedBodyAnnotation?.params) {
+    return coerceAnnotationValues(block.promotedBodyAnnotation.params).blockMeta;
+  }
   if (block.sourceHeading) return pinnedHeadingMeta(block.sourceHeading);
   if (block.sourceAnnotation?.params) {
     return coerceAnnotationValues(block.sourceAnnotation.params).blockMeta;
@@ -9770,6 +9839,22 @@ function pinnedMeta(block) {
 function getPinnedBlockMeta(block) {
   return pinnedMeta(block);
 }
+function promoteBodyAnnotations(blocks) {
+  for (const block of blocks) {
+    if (!block.sourceHeading || block.sourceHeading.templateAnnotation?.template) continue;
+    const found = detectPromotableBodyAnnotation(block.contents);
+    if (!found) continue;
+    const { template, params } = found.data;
+    if (isMediaAnnotationName(template) || !hasTemplate(template)) continue;
+    block.template = resolveTemplateName(template);
+    if (Object.keys(params).length > 0) {
+      block.templateOverrides = params;
+      applyBlockMeta2(block, coerceAnnotationValues(params).blockMeta);
+    }
+    block.contents = found.strippedContents;
+    block.promotedBodyAnnotation = found.data;
+  }
+}
 function expandStandaloneAnnotations(blocks, makeId, defaultDuration) {
   const out = [];
   for (const block of blocks) {
@@ -9906,6 +9991,7 @@ function markdownToDoc(markdownDoc, options) {
   if (rootBlocks.length > 0 && !rootBlocks[0].sourceHeading && (rootBlocks[0].contents?.length ?? 0) === 0 && (rootBlocks[0].children?.length ?? 0) === 0 && !rootBlocks[0].media) {
     rootBlocks.shift();
   }
+  promoteBodyAnnotations(flattenBlocks(rootBlocks));
   const makeStandaloneId = (parsed) => {
     const base = parsed.params.title ?? parsed.template ?? "block";
     return idGenerator ? idGenerator.fromText(base) : slugify(base);
@@ -10165,7 +10251,7 @@ function frontmatterDisablesAutoTemplates(markdownDoc) {
 }
 function applyAutoTemplates(blocks, resolvedDefault, state) {
   for (const block of blocks) {
-    const annotated = !!block.sourceHeading?.templateAnnotation?.template;
+    const annotated = !!block.sourceHeading?.templateAnnotation?.template || !!block.promotedBodyAnnotation;
     if (block.sourceHeading && !annotated && block.template === resolvedDefault) {
       const profile = profileBlockContents(block.contents ?? []);
       const picked = pickAutoTemplate(profile, state.featureIndex);
@@ -10604,11 +10690,6 @@ export {
   getPersistentLayersFromTheme,
   resolvePersistentLayers,
   wrapWithPersistentLayers,
-  TEMPLATE_ALIASES,
-  resolveTemplateName,
-  TABLE_FED_TEMPLATES,
-  CONTAINER_TEMPLATES,
-  isContainerTemplate,
   resolveColorScheme,
   getThemeFont,
   themedFontSize,

package/dist/{chunk-D4LPP3P5.js → chunk-7TJJA2RI.js}

@@ -1,11 +1,12 @@
 import {
   coerceAnnotationValues,
+  isReservedAnnotationToken,
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
   quoteAttrValue,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-2VCNTDNZ.js";
+} from "./chunk-D6YTLQCL.js";
 import {
   resolveIcon
 } from "./chunk-7N4G32LG.js";
@@ -303,6 +304,7 @@ function splitTextOnIcons(value, position) {
   const out = [];
   while ((match = ICON_TOKEN_RE.exec(value)) !== null) {
     const token = match[1];
+    if (isReservedAnnotationToken(token)) continue;
     const icon = resolveIcon(token);
     if (!icon) continue;
     if (match.index > lastIndex) {