@bendyline/squisq 2.4.2 → 2.4.4

package/dist/{chunk-JUAC2QWP.js → chunk-CYRIVZTR.js}

@@ -2,7 +2,7 @@ import {
   assertMarkdownDocumentWithinLimits,
   parseMarkdown,
   toMdast
-} from "./chunk-7TJJA2RI.js";
+} from "./chunk-YQW6AQBV.js";
 import {
   formatFrontmatterYaml,
   getChildren,

package/dist/{chunk-EMXYZLRH.js → chunk-GGTDYLW4.js}

@@ -1,7 +1,7 @@
 import {
   expectedSyllablesAt,
   wordPosAtExpectedSyllables
-} from "./chunk-2HY2ZA7U.js";
+} from "./chunk-OIIIHI3Y.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/{chunk-AQF5ZYDI.js → chunk-GXUFHFYD.js}

@@ -23,7 +23,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-2HY2ZA7U.js";
+} from "./chunk-OIIIHI3Y.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -58,7 +58,7 @@ import {
 } from "./chunk-BAOV476U.js";
 import {
   parseMarkdown
-} from "./chunk-7TJJA2RI.js";
+} from "./chunk-YQW6AQBV.js";
 import {
   KNOWN_BLOCK_META_KEYS,
   TEMPLATE_ALIASES,
@@ -66,7 +66,7 @@ import {
   isContainerTemplate,
   resolveTemplateName,
   serializeAnnotation
-} from "./chunk-D6YTLQCL.js";
+} from "./chunk-O3LLD7HG.js";
 import {
   extractPlainText,
   getChildren,

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

@@ -56,7 +56,7 @@ import {
   sanitizeUrl,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-D6YTLQCL.js";
+} from "./chunk-O3LLD7HG.js";
 import {
   extractPlainText,
   readFrontmatterThemeId,
@@ -2414,7 +2414,7 @@ function renderInlineHtml(nodes) {
       case "mention":
         return escapeInlineHtml(`@${node.displayName}`);
       case "inlineIcon":
-        return escapeInlineHtml(`{[${node.token}]}`);
+        return `<i class="fa-${node.family} fa-${node.name}" aria-hidden="true"></i>`;
       case "htmlInline":
         return escapeInlineHtml(node.rawHtml);
     }
@@ -2525,10 +2525,16 @@ function extractEmbeddedVideos(contents, limit = Infinity) {
       const attrs = n.attributes;
       const src = attrs?.src || nestedSource(n.children);
       if (src) {
+        const startAt = attrs?.["data-squisq-video-start-at"] ? parseTimeSeconds(attrs["data-squisq-video-start-at"]) : null;
+        const clipStart = attrs?.["data-squisq-video-clip-start"] ? parseTimeSeconds(attrs["data-squisq-video-clip-start"]) : null;
+        const clipEnd = attrs?.["data-squisq-video-clip-end"] ? parseTimeSeconds(attrs["data-squisq-video-clip-end"]) : null;
         add({
           src,
           ...attrs?.poster ? { posterSrc: attrs.poster } : {},
-          alt: attrs?.["aria-label"] || attrs?.title || attrs?.alt || ""
+          alt: attrs?.["aria-label"] || attrs?.title || attrs?.alt || "",
+          ...startAt != null ? { startAt } : {},
+          ...clipStart != null ? { clipStart } : {},
+          ...clipEnd != null ? { clipEnd } : {}
         });
       }
     } else if ((n.type === "link" || n.type === "image") && typeof n.url === "string" && VIDEO_FILE_RE.test(n.url)) {
@@ -8125,7 +8131,10 @@ function collectRichMediaItems(layers, block) {
         src: video.src,
         ...video.posterSrc ? { posterSrc: video.posterSrc } : {},
         alt: video.alt,
-        aspectRatio: 16 / 9
+        aspectRatio: 16 / 9,
+        ...video.startAt != null ? { startAt: video.startAt } : {},
+        ...video.clipStart != null ? { clipStart: video.clipStart } : {},
+        ...video.clipEnd != null ? { clipEnd: video.clipEnd } : {}
       })
     ),
     ...sources.map((source) => ({ kind: "mermaid", source, aspectRatio: 16 / 9 })),
@@ -8181,6 +8190,7 @@ function richMediaLayers(item, position, block, theme, kindIndex) {
     ];
   }
   if (item.kind === "video") {
+    const clipStart = Math.max(0, item.clipStart ?? 0);
     return [
       {
         id: `${block.id}-embedded-video-${kindIndex}`,
@@ -8191,8 +8201,9 @@ function richMediaLayers(item, position, block, theme, kindIndex) {
           ...item.posterSrc ? { posterSrc: item.posterSrc } : {},
           alt: item.alt || block.title || "Embedded video",
           fit: "contain",
-          clipStart: 0,
-          clipEnd: Math.max(0, block.duration)
+          clipStart,
+          clipEnd: Math.max(clipStart, item.clipEnd ?? clipStart + Math.max(0, block.duration)),
+          ...item.startAt != null ? { startAt: Math.max(0, item.startAt) } : {}
         }
       }
     ];
@@ -8233,11 +8244,36 @@ function richMediaLayers(item, position, block, theme, kindIndex) {
     `${block.id}-embedded-${item.template}-${kindIndex}`
   );
 }
+function applyEmbeddedVideoTiming(layers, block) {
+  const timedBySrc = new Map(
+    extractEmbeddedVideos(block.contents).filter((video) => video.startAt != null || video.clipStart != null || video.clipEnd != null).map((video) => [video.src, video])
+  );
+  if (timedBySrc.size === 0) return layers;
+  return layers.map((layer) => {
+    if (layer.type !== "video") return layer;
+    const video = timedBySrc.get(layer.content.src);
+    if (!video) return layer;
+    const clipStart = Math.max(0, video.clipStart ?? layer.content.clipStart);
+    return {
+      ...layer,
+      content: {
+        ...layer.content,
+        clipStart,
+        clipEnd: Math.max(
+          clipStart,
+          video.clipEnd ?? (video.clipStart != null ? clipStart + Math.max(0, block.duration) : layer.content.clipEnd)
+        ),
+        ...video.startAt != null ? { startAt: Math.max(0, video.startAt) } : {}
+      }
+    };
+  });
+}
 function appendRichContentLayers(layers, block, theme, viewport) {
-  const items = collectRichMediaItems(layers, block);
-  if (items.length === 0) return layers;
+  const timedLayers = applyEmbeddedVideoTiming(layers, block);
+  const items = collectRichMediaItems(timedLayers, block);
+  if (items.length === 0) return timedLayers;
   const layout = resolveSupplementalMediaLayout(
-    layers,
+    timedLayers,
     block.template ? resolveTemplateName(block.template) : void 0,
     viewport,
     items.length,

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

@@ -6,7 +6,7 @@ import {
   quoteAttrValue,
   splitKeyValueToken,
   tokenizeAttrTokens
-} from "./chunk-D6YTLQCL.js";
+} from "./chunk-O3LLD7HG.js";
 import {
   resolveIcon
 } from "./chunk-7N4G32LG.js";

package/dist/doc/index.d.ts

@@ -979,8 +979,9 @@ declare function pullQuote(input: PullQuoteInput, context: TemplateContext): Lay
  * Video With Caption Template
  *
  * Full-screen background video clip with text overlay. Mirrors the structure of
- * imageWithCaption but uses a VideoLayer instead of an ImageLayer. The video
- * plays muted — narration audio is the only sound track.
+ * imageWithCaption but uses a VideoLayer instead of an ImageLayer. Interactive
+ * players may play the video's own audio; muted and render-mode players keep it
+ * silent.
  *
  * Adapts caption positioning and font sizes for different viewports.
  *
@@ -1762,6 +1763,11 @@ interface EmbeddedVideo {
     src: string;
     posterSrc?: string;
     alt: string;
+    /** Delay within the owning block before playback begins. */
+    startAt?: number;
+    /** Source-media in/out points carried by inline video data attributes. */
+    clipStart?: number;
+    clipEnd?: number;
 }
 /** Plain text of a block's body contents (excluding the heading). */
 declare function extractBodyPlainText(contents?: MarkdownBlockNode[]): string;

package/dist/doc/index.js

@@ -26,7 +26,7 @@ import {
   sectionExtractors,
   validateMarkdownDoc,
   validateMarkdownSource
-} from "../chunk-AQF5ZYDI.js";
+} from "../chunk-GXUFHFYD.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -144,7 +144,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "../chunk-2HY2ZA7U.js";
+} from "../chunk-OIIIHI3Y.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -200,13 +200,13 @@ import {
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
 } from "../chunk-BAOV476U.js";
-import "../chunk-7TJJA2RI.js";
+import "../chunk-YQW6AQBV.js";
 import {
   CONTAINER_TEMPLATES,
   TABLE_FED_TEMPLATES,
   isContainerTemplate,
   resolveTemplateName
-} from "../chunk-D6YTLQCL.js";
+} from "../chunk-O3LLD7HG.js";
 import "../chunk-7N4G32LG.js";
 import "../chunk-O7JILDEF.js";
 import "../chunk-4VOD55SX.js";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { B as BoundingBox, C as Coordinates } from './Types-sh2VRxfo.js';
 export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as Block, k as BlockConnection, l as BorderStyle, C as CaptionPhrase, m as CaptionTrack, n as CaptionWord, o as ChartBaseFields, p as ChartTemplateInput, q as ColorScheme, r as ColumnChartInput, s as ComparisonBarInput, t as ContentBlockInput, u as CornerBrandingConfig, v as CustomTemplateDefinition, w as CustomTemplateLayer, x as CustomTemplateValidationError, y as CustomTemplateValidationResult, D as DARK_SURFACE, z as DEFAULT_DOC_FONT, E as DEFAULT_TITLE_FONT, F as DataTableInput, G as DateEventInput, H as DeepPartial, I as DefinitionCardInput, J as DiagramBlockInput, K as DiagramEdgeAnchor, L as DiagramTemplateEdge, M as DiagramTemplateNode, N as Doc, O as DocBlock, P as DocDiagnostic, Q as DonutChartInput, R as DrawingBlockInput, S as FRONTMATTER_CUSTOM_TEMPLATES_KEY, T as FRONTMATTER_CUSTOM_THEMES_KEY, U as FactCardInput, V as FontFamily, W as FontFamilyKind, X as FullBleedQuoteInput, Y as GradientBackgroundConfig, Z as ImageBackgroundConfig, _ as ImageLayer, $ as ImageTreatment, a0 as ImageWithCaptionInput, a1 as LIGHT_SURFACE, a2 as Layer, a3 as LayerRepeat, a4 as LayoutHints, a5 as LeftFeatureInput, a6 as LineChartInput, a7 as LinearGradient, a8 as ListBlockInput, a9 as MapBlockInput, aa as MapLayer, ab as MapMarker, ac as MapTileStyle, ad as MarkerStyle, ae as MediaClip, af as MediaScheduleOptions, ag as MermaidLayer, ah as PAGE_ACCENT_STRATEGIES, ai as PAGE_BACKGROUNDS, aj as PAGE_BACKGROUND_RHYTHMS, ak as PAGE_DESIGN_FAMILIES, al as PAGE_DIVIDERS, am as PAGE_EMPHASES, an as PAGE_EYEBROWS, ao as PAGE_HEADING_CASES, ap as PAGE_HEADING_SCALES, aq as PAGE_HEADING_UNDERLINES, ar as PAGE_HERO_STYLES, as as PAGE_IMAGE_FRAMINGS, at as PAGE_NUMERAL_STYLES, au as PAGE_PATTERNS, av as PAGE_QUOTE_MARKS, aw as PAGE_SECTION_KINDS, ax as PAGE_SECTION_SPACINGS, ay as PAGE_SHADOWS, az as PageAccentRotation, aA as PageBackground, aB as PageDesignFamily, aC as PageEmphasis, aD as PageHeadingTreatment, aE as PageSectionKind, aF as PageSectionOverride, aG as PageTokens, aH as PathLayer, aI as PatternBackgroundConfig, aJ as PersistentLayer, aK as PersistentLayerConfig, aL as PersistentLayerTemplate, aM as PersistentLayerTemplateConfig, aN as PersistentLayerTemplateType, aO as PhotoGridInput, aP as PieChartInput, aQ as PipStyle, aR as Position, aS as ProgressIndicatorConfig, aT as PromotedBodyAnnotation, aU as PullQuoteInput, aV as QuoteBlockInput, aW as RawLayersInput, aX as RenderStyle, aY as RightFeatureInput, aZ as ScatterChartInput, a_ as ScheduledClip, a$ as SectionHeaderInput, b0 as ShapeFilter, b1 as ShapeLayer, b2 as ShapePattern, b3 as SolidBackgroundConfig, b4 as StartBlockConfig, b5 as StatHighlightInput, b6 as SurfaceScheme, b7 as THEME_SCHEMA_VERSION, b8 as TableLayer, b9 as TableLayerStyle, ba as TemplateBlock, bb as TemplateContext, bc as TemplateFunction, bd as TemplateRegistry, be as TextLayer, bf as TextStyle, bg as Theme, bh as ThemeColorPalette, bi as ThemeColorScheme, bj as ThemePageStyle, bk as ThemeRegistry, bl as ThemeSchemaVersion, bm as ThemeSeedColors, bn as ThemeStyle, bo as ThemeTypography, bp as TimelineBlockInput, bq as TimelineTemplateEvent, br as TimelineTemplateLink, bs as TimelineTemplateTrack, bt as TitleBlockInput, bu as TitleCaptionConfig, bv as TreeBlockInput, bw as TreeLayer, bx as TreeLayerItem, by as TreeLayerStyle, bz as TreeTemplateItem, bA as TwoColumnInput, bB as VIEWPORT_PRESETS, bC as VideoLayer, bD as VideoPipPosition, bE as VideoPipShape, bF as VideoPipSize, bG as VideoPlacement, bH as VideoPresentation, bI as VideoPullQuoteInput, bJ as VideoWithCaptionInput, bK as ViewportConfig, bL as ViewportOrientation, bM as ViewportPreset, bN as VignetteConfig, bO as applySurface, bP as calculateDuration, bQ as calculateFontScale, bR as createTemplateContext, bS as createTheme, bT as createThemeRegistry, bU as getAspectRatioString, bV as getBlockAtTime, bW as getCaptionAtTime, bX as getDocPlaybackDuration, bY as getLayoutHints, bZ as getSafeTextBounds, b_ as getSegmentAtTime, b$ as getTwoColumnPositions, c0 as getViewport, c1 as getViewportOrientation, c2 as isCustomTemplateDefinition, c3 as isPersistentLayerTemplate, c4 as isTemplateBlock, c5 as layoutScaledFontSize, c6 as resolveMediaSchedule, c7 as scaledFontSize, c8 as validateCustomTemplateDefinition } from './Doc-BKKcPjfe.js';
+export { AVAILABLE_FONT_STACKS, CompileOptions, ContrastPreset, DocSchemaIssue, FONT_FALLBACKS, FontStack, MermaidThemeVariables, PipStyleVars, STARTER_THEME, ValidationError, ValidationResult, accentToColorScheme, assertDocSchema, assertTheme, buildGoogleFontsUrl, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateDocSchema, validateTheme, withAlpha } from './schemas/index.js';
 export { D as DEFAULT_MARKDOWN_SAFETY_LIMITS, a as DEFAULT_TRANSITION_DURATION_SECONDS, H as HeadingAttributes, b as HeadingTemplateAnnotation, c as HtmlComment, d as HtmlElement, e as HtmlNode, f as HtmlText, M as MarkdownBlockNode, g as MarkdownBlockquote, h as MarkdownBreak, i as MarkdownCodeBlock, j as MarkdownContainerDirective, k as MarkdownDefinitionDescription, l as MarkdownDefinitionList, m as MarkdownDefinitionTerm, n as MarkdownDocument, o as MarkdownEmphasis, p as MarkdownFootnoteDefinition, q as MarkdownFootnoteReference, r as MarkdownHeading, s as MarkdownHtmlBlock, t as MarkdownImage, u as MarkdownImageReference, v as MarkdownInlineCode, w as MarkdownInlineHtml, x as MarkdownInlineIcon, y as MarkdownInlineMath, z as MarkdownInlineNode, A as MarkdownLeafDirective, B as MarkdownLimitError, C as MarkdownLink, E as MarkdownLinkDefinition, F as MarkdownLinkReference, G as MarkdownList, I as MarkdownListItem, J as MarkdownMathBlock, K as MarkdownMention, L as MarkdownNode, N as MarkdownParagraph, O as MarkdownPoint, P as MarkdownSafetyLimits, Q as MarkdownSourcePosition, R as MarkdownStrikethrough, S as MarkdownStrong, T as MarkdownTable, U as MarkdownTableCell, V as MarkdownTableRow, W as MarkdownText, X as MarkdownTextDirective, Y as MarkdownThematicBreak, Z as ParseOptions, _ as StringifyOptions, $ as TRANSITION_DIRECTIONS, a0 as TRANSITION_TYPES, a1 as Transition, a2 as TransitionDirection, a3 as TransitionType, a4 as assertMarkdownDocumentWithinLimits, a5 as assertMarkdownSourceWithinLimits, a6 as isTransitionType, a7 as normalizeTransitionDirection, a8 as normalizeTransitionType, a9 as resolveBlockTransition, aa as resolveMarkdownSafetyLimits, ab as resolveTransitionDuration } from './types-CcrDFdWH.js';
-export { AVAILABLE_FONT_STACKS, CompileOptions, ContrastPreset, FONT_FALLBACKS, FontStack, MermaidThemeVariables, PipStyleVars, STARTER_THEME, ValidationError, ValidationResult, accentToColorScheme, assertTheme, buildGoogleFontsUrl, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha } from './schemas/index.js';
 export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from './themeLibrary-BMXXLZBU.js';
 export { M as MediaEntry, a as MediaProvider } from './MediaProvider-wpSe21B3.js';
 export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from './ImageEditDoc-CU1cXxRd.js';

package/dist/index.js

@@ -23,7 +23,7 @@ import {
   reanchorSession,
   traceWordPosAt,
   vadStep
-} from "./chunk-EMXYZLRH.js";
+} from "./chunk-GGTDYLW4.js";
 import {
   DEFAULT_TRANSFORM_STYLE_ID,
   analyzeBlocks,
@@ -112,6 +112,7 @@ import {
 import {
   STARTER_THEME,
   accentToColorScheme,
+  assertDocSchema,
   buildMermaidThemeVariables,
   calculateDuration,
   compileTheme,
@@ -121,8 +122,9 @@ import {
   getSegmentAtTime,
   parseTheme,
   pipStyleVars,
-  serializeTheme
-} from "./chunk-GODLNXO4.js";
+  serializeTheme,
+  validateDocSchema
+} from "./chunk-24SENDJY.js";
 import {
   calculateBearing,
   decodeGeohash,
@@ -163,7 +165,7 @@ import {
   sectionExtractors,
   validateMarkdownDoc,
   validateMarkdownSource
-} from "./chunk-AQF5ZYDI.js";
+} from "./chunk-GXUFHFYD.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -289,7 +291,7 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-2HY2ZA7U.js";
+} from "./chunk-OIIIHI3Y.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -432,7 +434,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "./chunk-JUAC2QWP.js";
+} from "./chunk-CYRIVZTR.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -444,7 +446,7 @@ import {
   resolveMarkdownSafetyLimits,
   serializePandocAttributes,
   toMdast
-} from "./chunk-7TJJA2RI.js";
+} from "./chunk-YQW6AQBV.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   CONTAINER_TEMPLATES,
@@ -462,7 +464,7 @@ import {
   splitKeyValueToken,
   tokenizeAttrTokens,
   unquoteAttrValue
-} from "./chunk-D6YTLQCL.js";
+} from "./chunk-O3LLD7HG.js";
 import {
   ICONS,
   canonicalIconToken,
@@ -623,6 +625,7 @@ export {
   asciiDiagramFromTemplateData,
   asciiDiagramToTemplateData,
   asciiTimelineToTemplateData,
+  assertDocSchema,
   assertMarkdownDocumentWithinLimits,
   assertMarkdownSourceWithinLimits,
   assertTheme,
@@ -966,6 +969,7 @@ export {
   updateLayer,
   vadStep,
   validateCustomTemplateDefinition,
+  validateDocSchema,
   validateMarkdownDoc,
   validateMarkdownSource,
   validateTheme,

package/dist/jsonForm/index.js

@@ -16,7 +16,7 @@ import {
   setByPointer,
   toPointer
 } from "../chunk-DAMIRKTO.js";
-import "../chunk-GODLNXO4.js";
+import "../chunk-24SENDJY.js";
 import "../chunk-GAZKTT4R.js";
 import "../chunk-SBAX4ZPO.js";
 import "../chunk-BAOV476U.js";

package/dist/markdown/index.js

@@ -14,7 +14,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "../chunk-JUAC2QWP.js";
+} from "../chunk-CYRIVZTR.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -26,7 +26,7 @@ import {
   resolveMarkdownSafetyLimits,
   serializePandocAttributes,
   toMdast
-} from "../chunk-7TJJA2RI.js";
+} from "../chunk-YQW6AQBV.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   KNOWN_BLOCK_META_KEYS,
@@ -40,7 +40,7 @@ import {
   splitKeyValueToken,
   tokenizeAttrTokens,
   unquoteAttrValue
-} from "../chunk-D6YTLQCL.js";
+} from "../chunk-O3LLD7HG.js";
 import "../chunk-7N4G32LG.js";
 import {
   countNodes,

package/dist/narration/index.js

@@ -23,7 +23,7 @@ import {
   reanchorSession,
   traceWordPosAt,
   vadStep
-} from "../chunk-EMXYZLRH.js";
+} from "../chunk-GGTDYLW4.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -33,12 +33,12 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-2HY2ZA7U.js";
+} from "../chunk-OIIIHI3Y.js";
 import "../chunk-PUS54YU6.js";
 import "../chunk-CUYHFOFL.js";
 import "../chunk-SBAX4ZPO.js";
 import "../chunk-BAOV476U.js";
-import "../chunk-D6YTLQCL.js";
+import "../chunk-O3LLD7HG.js";
 import "../chunk-O7JILDEF.js";
 import "../chunk-4VOD55SX.js";
 import "../chunk-XOFT65EX.js";

package/dist/schemas/index.d.ts

@@ -1,11 +1,30 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { bg as Theme, bj as ThemePageStyle, bi as ThemeColorScheme, H as DeepPartial, bm as ThemeSeedColors, bh as ThemeColorPalette, W as FontFamilyKind, V as FontFamily } from '../Doc-BKKcPjfe.js';
-export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as Block, k as BlockConnection, l as BorderStyle, C as CaptionPhrase, m as CaptionTrack, n as CaptionWord, o as ChartBaseFields, p as ChartTemplateInput, q as ColorScheme, r as ColumnChartInput, s as ComparisonBarInput, t as ContentBlockInput, u as CornerBrandingConfig, v as CustomTemplateDefinition, w as CustomTemplateLayer, x as CustomTemplateValidationError, y as CustomTemplateValidationResult, D as DARK_SURFACE, z as DEFAULT_DOC_FONT, E as DEFAULT_TITLE_FONT, F as DataTableInput, G as DateEventInput, I as DefinitionCardInput, J as DiagramBlockInput, K as DiagramEdgeAnchor, L as DiagramTemplateEdge, M as DiagramTemplateNode, N as Doc, O as DocBlock, P as DocDiagnostic, Q as DonutChartInput, R as DrawingBlockInput, S as FRONTMATTER_CUSTOM_TEMPLATES_KEY, T as FRONTMATTER_CUSTOM_THEMES_KEY, U as FactCardInput, X as FullBleedQuoteInput, Y as GradientBackgroundConfig, Z as ImageBackgroundConfig, _ as ImageLayer, $ as ImageTreatment, a0 as ImageWithCaptionInput, a1 as LIGHT_SURFACE, a2 as Layer, a3 as LayerRepeat, a4 as LayoutHints, a5 as LeftFeatureInput, a6 as LineChartInput, a7 as LinearGradient, a8 as ListBlockInput, a9 as MapBlockInput, aa as MapLayer, ab as MapMarker, ac as MapTileStyle, ad as MarkerStyle, ae as MediaClip, af as MediaScheduleOptions, ag as MermaidLayer, ah as PAGE_ACCENT_STRATEGIES, ai as PAGE_BACKGROUNDS, aj as PAGE_BACKGROUND_RHYTHMS, ak as PAGE_DESIGN_FAMILIES, al as PAGE_DIVIDERS, am as PAGE_EMPHASES, an as PAGE_EYEBROWS, ao as PAGE_HEADING_CASES, ap as PAGE_HEADING_SCALES, aq as PAGE_HEADING_UNDERLINES, ar as PAGE_HERO_STYLES, as as PAGE_IMAGE_FRAMINGS, at as PAGE_NUMERAL_STYLES, au as PAGE_PATTERNS, av as PAGE_QUOTE_MARKS, aw as PAGE_SECTION_KINDS, ax as PAGE_SECTION_SPACINGS, ay as PAGE_SHADOWS, az as PageAccentRotation, aA as PageBackground, aB as PageDesignFamily, aC as PageEmphasis, aD as PageHeadingTreatment, aE as PageSectionKind, aF as PageSectionOverride, aG as PageTokens, aH as PathLayer, aI as PatternBackgroundConfig, aJ as PersistentLayer, aK as PersistentLayerConfig, aL as PersistentLayerTemplate, aM as PersistentLayerTemplateConfig, aN as PersistentLayerTemplateType, aO as PhotoGridInput, aP as PieChartInput, aQ as PipStyle, aR as Position, aS as ProgressIndicatorConfig, aT as PromotedBodyAnnotation, aU as PullQuoteInput, aV as QuoteBlockInput, aW as RawLayersInput, aX as RenderStyle, aY as RightFeatureInput, aZ as ScatterChartInput, a_ as ScheduledClip, a$ as SectionHeaderInput, b0 as ShapeFilter, b1 as ShapeLayer, b2 as ShapePattern, b3 as SolidBackgroundConfig, b4 as StartBlockConfig, b5 as StatHighlightInput, b6 as SurfaceScheme, b7 as THEME_SCHEMA_VERSION, b8 as TableLayer, b9 as TableLayerStyle, ba as TemplateBlock, bb as TemplateContext, bc as TemplateFunction, bd as TemplateRegistry, be as TextLayer, bf as TextStyle, bk as ThemeRegistry, bl as ThemeSchemaVersion, bn as ThemeStyle, bo as ThemeTypography, bp as TimelineBlockInput, bq as TimelineTemplateEvent, br as TimelineTemplateLink, bs as TimelineTemplateTrack, bt as TitleBlockInput, bu as TitleCaptionConfig, bv as TreeBlockInput, bw as TreeLayer, bx as TreeLayerItem, by as TreeLayerStyle, bz as TreeTemplateItem, bA as TwoColumnInput, bB as VIEWPORT_PRESETS, bC as VideoLayer, bD as VideoPipPosition, bE as VideoPipShape, bF as VideoPipSize, bG as VideoPlacement, bH as VideoPresentation, bI as VideoPullQuoteInput, bJ as VideoWithCaptionInput, bK as ViewportConfig, bL as ViewportOrientation, bM as ViewportPreset, bN as VignetteConfig, bO as applySurface, bP as calculateDuration, bQ as calculateFontScale, bR as createTemplateContext, bS as createTheme, bT as createThemeRegistry, bU as getAspectRatioString, bV as getBlockAtTime, bW as getCaptionAtTime, bX as getDocPlaybackDuration, bY as getLayoutHints, bZ as getSafeTextBounds, b_ as getSegmentAtTime, b$ as getTwoColumnPositions, c0 as getViewport, c1 as getViewportOrientation, c2 as isCustomTemplateDefinition, c3 as isPersistentLayerTemplate, c4 as isTemplateBlock, c5 as layoutScaledFontSize, c6 as resolveMediaSchedule, c7 as scaledFontSize, c8 as validateCustomTemplateDefinition } from '../Doc-BKKcPjfe.js';
+import { N as Doc, bg as Theme, bj as ThemePageStyle, bi as ThemeColorScheme, H as DeepPartial, bm as ThemeSeedColors, bh as ThemeColorPalette, W as FontFamilyKind, V as FontFamily } from '../Doc-BKKcPjfe.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as Block, k as BlockConnection, l as BorderStyle, C as CaptionPhrase, m as CaptionTrack, n as CaptionWord, o as ChartBaseFields, p as ChartTemplateInput, q as ColorScheme, r as ColumnChartInput, s as ComparisonBarInput, t as ContentBlockInput, u as CornerBrandingConfig, v as CustomTemplateDefinition, w as CustomTemplateLayer, x as CustomTemplateValidationError, y as CustomTemplateValidationResult, D as DARK_SURFACE, z as DEFAULT_DOC_FONT, E as DEFAULT_TITLE_FONT, F as DataTableInput, G as DateEventInput, I as DefinitionCardInput, J as DiagramBlockInput, K as DiagramEdgeAnchor, L as DiagramTemplateEdge, M as DiagramTemplateNode, O as DocBlock, P as DocDiagnostic, Q as DonutChartInput, R as DrawingBlockInput, S as FRONTMATTER_CUSTOM_TEMPLATES_KEY, T as FRONTMATTER_CUSTOM_THEMES_KEY, U as FactCardInput, X as FullBleedQuoteInput, Y as GradientBackgroundConfig, Z as ImageBackgroundConfig, _ as ImageLayer, $ as ImageTreatment, a0 as ImageWithCaptionInput, a1 as LIGHT_SURFACE, a2 as Layer, a3 as LayerRepeat, a4 as LayoutHints, a5 as LeftFeatureInput, a6 as LineChartInput, a7 as LinearGradient, a8 as ListBlockInput, a9 as MapBlockInput, aa as MapLayer, ab as MapMarker, ac as MapTileStyle, ad as MarkerStyle, ae as MediaClip, af as MediaScheduleOptions, ag as MermaidLayer, ah as PAGE_ACCENT_STRATEGIES, ai as PAGE_BACKGROUNDS, aj as PAGE_BACKGROUND_RHYTHMS, ak as PAGE_DESIGN_FAMILIES, al as PAGE_DIVIDERS, am as PAGE_EMPHASES, an as PAGE_EYEBROWS, ao as PAGE_HEADING_CASES, ap as PAGE_HEADING_SCALES, aq as PAGE_HEADING_UNDERLINES, ar as PAGE_HERO_STYLES, as as PAGE_IMAGE_FRAMINGS, at as PAGE_NUMERAL_STYLES, au as PAGE_PATTERNS, av as PAGE_QUOTE_MARKS, aw as PAGE_SECTION_KINDS, ax as PAGE_SECTION_SPACINGS, ay as PAGE_SHADOWS, az as PageAccentRotation, aA as PageBackground, aB as PageDesignFamily, aC as PageEmphasis, aD as PageHeadingTreatment, aE as PageSectionKind, aF as PageSectionOverride, aG as PageTokens, aH as PathLayer, aI as PatternBackgroundConfig, aJ as PersistentLayer, aK as PersistentLayerConfig, aL as PersistentLayerTemplate, aM as PersistentLayerTemplateConfig, aN as PersistentLayerTemplateType, aO as PhotoGridInput, aP as PieChartInput, aQ as PipStyle, aR as Position, aS as ProgressIndicatorConfig, aT as PromotedBodyAnnotation, aU as PullQuoteInput, aV as QuoteBlockInput, aW as RawLayersInput, aX as RenderStyle, aY as RightFeatureInput, aZ as ScatterChartInput, a_ as ScheduledClip, a$ as SectionHeaderInput, b0 as ShapeFilter, b1 as ShapeLayer, b2 as ShapePattern, b3 as SolidBackgroundConfig, b4 as StartBlockConfig, b5 as StatHighlightInput, b6 as SurfaceScheme, b7 as THEME_SCHEMA_VERSION, b8 as TableLayer, b9 as TableLayerStyle, ba as TemplateBlock, bb as TemplateContext, bc as TemplateFunction, bd as TemplateRegistry, be as TextLayer, bf as TextStyle, bk as ThemeRegistry, bl as ThemeSchemaVersion, bn as ThemeStyle, bo as ThemeTypography, bp as TimelineBlockInput, bq as TimelineTemplateEvent, br as TimelineTemplateLink, bs as TimelineTemplateTrack, bt as TitleBlockInput, bu as TitleCaptionConfig, bv as TreeBlockInput, bw as TreeLayer, bx as TreeLayerItem, by as TreeLayerStyle, bz as TreeTemplateItem, bA as TwoColumnInput, bB as VIEWPORT_PRESETS, bC as VideoLayer, bD as VideoPipPosition, bE as VideoPipShape, bF as VideoPipSize, bG as VideoPlacement, bH as VideoPresentation, bI as VideoPullQuoteInput, bJ as VideoWithCaptionInput, bK as ViewportConfig, bL as ViewportOrientation, bM as ViewportPreset, bN as VignetteConfig, bO as applySurface, bP as calculateDuration, bQ as calculateFontScale, bR as createTemplateContext, bS as createTheme, bT as createThemeRegistry, bU as getAspectRatioString, bV as getBlockAtTime, bW as getCaptionAtTime, bX as getDocPlaybackDuration, bY as getLayoutHints, bZ as getSafeTextBounds, b_ as getSegmentAtTime, b$ as getTwoColumnPositions, c0 as getViewport, c1 as getViewportOrientation, c2 as isCustomTemplateDefinition, c3 as isPersistentLayerTemplate, c4 as isTemplateBlock, c5 as layoutScaledFontSize, c6 as resolveMediaSchedule, c7 as scaledFontSize, c8 as validateCustomTemplateDefinition } from '../Doc-BKKcPjfe.js';
 export { a as DEFAULT_TRANSITION_DURATION_SECONDS, $ as TRANSITION_DIRECTIONS, a0 as TRANSITION_TYPES, a1 as Transition, a2 as TransitionDirection, a3 as TransitionType, a6 as isTransitionType, a7 as normalizeTransitionDirection, a8 as normalizeTransitionType, a9 as resolveBlockTransition, ab as resolveTransitionDuration } from '../types-CcrDFdWH.js';
 export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BMXXLZBU.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
 export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-CU1cXxRd.js';
 
+/**
+ * Runtime validation for the canonical {@link Doc} JSON shape.
+ *
+ * TypeScript types disappear at a JSON boundary. This validator deliberately
+ * lives next to the schema so every importer can apply the same structural
+ * contract instead of maintaining a partial, consumer-specific guard.
+ */
+
+interface DocSchemaIssue {
+    /** JavaScript-style path to the invalid value. */
+    path: string;
+    /** Human-readable statement of the violated schema rule. */
+    message: string;
+}
+/** Return every structural problem found in a prospective Doc value. */
+declare function validateDocSchema(value: unknown): DocSchemaIssue[];
+/** Assert that a value implements the canonical Doc JSON schema. */
+declare function assertDocSchema(value: unknown): asserts value is Doc;
+
 /**
  * Theme-driven picture-in-picture framing.
  *
@@ -291,4 +310,4 @@ type MermaidThemeVariables = Record<string, string | number | boolean>;
 /** Build complete, contrast-aware Mermaid theme variables from a Squisq theme. */
 declare function buildMermaidThemeVariables(theme: Theme): MermaidThemeVariables;
 
-export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, type MermaidThemeVariables, type PipStyleVars, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemePageStyle, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertTheme, buildGoogleFontsUrl, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha };
+export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, Doc, type DocSchemaIssue, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, type MermaidThemeVariables, type PipStyleVars, STARTER_THEME, Theme, ThemeColorPalette, ThemeColorScheme, ThemePageStyle, ThemeSeedColors, type ValidationError, type ValidationResult, accentToColorScheme, assertDocSchema, assertTheme, buildGoogleFontsUrl, buildMermaidThemeVariables, compileTheme, contrastRatio, defaultPageStyle, deriveColorPalette, deriveScale, fontStack, getFontStack, guessFontFallback, hexHueDegrees, isHex, matchFontFamily, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, pipStyleVars, relativeLuminance, resolveFontFamily, serializeTheme, validateDocSchema, validateTheme, withAlpha };

package/dist/schemas/index.js

@@ -1,6 +1,7 @@
 import {
   STARTER_THEME,
   accentToColorScheme,
+  assertDocSchema,
   buildMermaidThemeVariables,
   calculateDuration,
   compileTheme,
@@ -10,8 +11,9 @@ import {
   getSegmentAtTime,
   parseTheme,
   pipStyleVars,
-  serializeTheme
-} from "../chunk-GODLNXO4.js";
+  serializeTheme,
+  validateDocSchema
+} from "../chunk-24SENDJY.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
@@ -138,6 +140,7 @@ export {
   VIEWPORT_PRESETS,
   accentToColorScheme,
   applySurface,
+  assertDocSchema,
   assertTheme,
   buildGoogleFontsUrl,
   buildMermaidThemeVariables,
@@ -191,6 +194,7 @@ export {
   scaledFontSize2 as scaledFontSize,
   serializeTheme,
   validateCustomTemplateDefinition,
+  validateDocSchema,
   validateTheme,
   withAlpha
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",