@bendyline/squisq 2.11.19 → 2.12.0

package/dist/schemas/index.js

@@ -13,7 +13,7 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "../chunk-GB7OFYUK.js";
+} from "../chunk-WAX4QYHA.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
@@ -97,21 +97,32 @@ import {
   validateCustomTemplateDefinition,
   validateTheme,
   withAlpha
-} from "../chunk-PFH3WV6J.js";
+} from "../chunk-I4L4GYDN.js";
 import "../chunk-JSGIWW35.js";
 import "../chunk-L7QZORLB.js";
 import {
+  BUILD_EFFECTS,
+  BUILD_MODES,
+  BUILD_PARAM_KEYS,
+  BUILD_PREVIOUS,
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,
   TRANSITION_TYPES,
+  buildSpecParams,
   isTransitionType,
   normalizeTransitionDirection,
   normalizeTransitionType,
+  parseBuildSpec,
+  recordBuildAdvance,
   resolveBlockTransition,
   resolveTransitionDuration
-} from "../chunk-4VOD55SX.js";
+} from "../chunk-M6YXFNGO.js";
 export {
   AVAILABLE_FONT_STACKS,
+  BUILD_EFFECTS,
+  BUILD_MODES,
+  BUILD_PARAM_KEYS,
+  BUILD_PREVIOUS,
   DARK_SURFACE,
   DEFAULT_DOC_FONT,
   DEFAULT_THEME,
@@ -155,6 +166,7 @@ export {
   assertTheme,
   buildGoogleFontsUrl,
   buildMermaidThemeVariables,
+  buildSpecParams,
   calculateDuration,
   calculateFontScale,
   compileTheme,
@@ -194,10 +206,12 @@ export {
   oklchDarken,
   oklchLighten,
   oklchSetChroma,
+  parseBuildSpec,
   parseTheme,
   pickContrastingText,
   pipStyleVars,
   readFrontmatterMotion,
+  recordBuildAdvance,
   relativeLuminance,
   resolveBlockTransition,
   resolveFontFamily,

package/dist/{themeLibrary-_46saKYO.d.ts → themeLibrary-BaDfxgzt.d.ts}

@@ -1,4 +1,4 @@
-import { bw as Theme, bA as ThemeRegistry } from './Doc-B6TYHYGc.js';
+import { bw as Theme, bA as ThemeRegistry } from './Doc-DIdmgDsV.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.d.ts

@@ -1,5 +1,5 @@
-import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-B6TYHYGc.js';
-import '../types-C6VvDDL2.js';
+import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-DIdmgDsV.js';
+import '../types-BmEHcL3l.js';
 
 /**
  * Narration timing estimation.

package/dist/transform/index.d.ts

@@ -1,7 +1,7 @@
-import { Q as Doc, r as ColorScheme, k as Block, bq as TemplateBlock } from '../Doc-B6TYHYGc.js';
-import { i as PageTransformHints } from '../materializePageSection-IYXU3tDN.js';
+import { Q as Doc, r as ColorScheme, k as Block, bq as TemplateBlock } from '../Doc-DIdmgDsV.js';
+import { i as PageTransformHints } from '../materializePageSection-C33MgcDg.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
-import '../types-C6VvDDL2.js';
+import { f as BuildSpec } from '../types-BmEHcL3l.js';
 
 /** Identifier for a built-in or caller-registered transform style. */
 type TransformStyleId = string;
@@ -351,11 +351,10 @@ declare const PRESENTATION_LIMITS: {
 declare function parsePresentationPlan(input: unknown): PresentationPlan | null;
 declare function serializePresentationPlan(plan: PresentationPlan): string;
 
-/** Durable author intent. Generated slides and their source offsets are never saved here. */
-
 declare const PRESENTATION_HINTS_KEY = "squisq-presentation-hints";
 declare const DYNAMIC_PRESENTATION_STYLE = "dynamic-slides";
 interface PresentationBlockHint {
+    build?: BuildSpec;
     blockId: string;
     layout?: PresentationLayout;
     inbetweens?: boolean;

package/dist/transform/index.js

@@ -24,18 +24,18 @@ import {
   serializePresentationPlan,
   transformNarratedSegment,
   usesDynamicPresentation
-} from "../chunk-QKNFR55R.js";
-import "../chunk-QLN6ILHM.js";
-import "../chunk-A5QJJZ5S.js";
+} from "../chunk-K2PZMWQ5.js";
+import "../chunk-W45PAVYE.js";
+import "../chunk-B3AFOXMA.js";
 import "../chunk-SVN7T6BK.js";
-import "../chunk-PUS54YU6.js";
-import "../chunk-PFH3WV6J.js";
+import "../chunk-FUBMT6SJ.js";
+import "../chunk-I4L4GYDN.js";
 import "../chunk-L7QZORLB.js";
-import "../chunk-Y4OZ5DSG.js";
-import "../chunk-WSFXV5BT.js";
-import "../chunk-Q6ELOAOQ.js";
+import "../chunk-H54A35NZ.js";
+import "../chunk-ZYWYSM6W.js";
+import "../chunk-NNJA7ICB.js";
 import "../chunk-CZ7AUSLI.js";
-import "../chunk-4VOD55SX.js";
+import "../chunk-M6YXFNGO.js";
 import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";
 export {

package/dist/{types-C6VvDDL2.d.ts → types-BmEHcL3l.d.ts}

@@ -1,3 +1,43 @@
+/** Semantic reveal order is independent of decorative motion and slide transitions. */
+declare const BUILD_MODES: readonly ["off", "items", "branches", "chunks"];
+declare const BUILD_EFFECTS: readonly ["appear", "fadeIn", "fadeInUp", "slideIn"];
+declare const BUILD_PREVIOUS: readonly ["keep", "dim"];
+interface BuildSpec {
+    mode: (typeof BUILD_MODES)[number];
+    effect?: (typeof BUILD_EFFECTS)[number];
+    /** Entrance seconds. Reveal timing is independent of this duration. */
+    duration?: number;
+    previous?: (typeof BUILD_PREVIOUS)[number];
+}
+/** Projection-only semantic step. IDs are stable for an unchanged source. */
+interface BuildStep {
+    id: string;
+    text: string;
+    /** Earlier steps which must remain readable for this step's context. */
+    ancestors?: number[];
+}
+/** Number of revealed steps and progress of the most recently revealed step. */
+interface BuildCursor {
+    revealed: number;
+    progress: number;
+}
+/** Source-guarded offsets from block start, produced by narration or recording. */
+interface BuildTiming {
+    sourceText: string;
+    starts: number[];
+}
+/** First reveal of a step during a recording. Time is take-relative seconds. */
+interface BuildAdvance {
+    blockId: string;
+    sourceText: string;
+    step: number;
+    time: number;
+}
+declare function recordBuildAdvance(log: readonly BuildAdvance[], event: BuildAdvance): readonly BuildAdvance[];
+declare const BUILD_PARAM_KEYS: readonly ["build", "buildEffect", "buildDuration", "buildPrevious"];
+declare function parseBuildSpec(value: unknown): BuildSpec | undefined;
+declare function buildSpecParams(build: BuildSpec): Record<string, string>;
+
 interface MarkdownSafetyLimits {
     maxSourceBytes: number;
     maxNodes: number;
@@ -212,6 +252,7 @@ interface HeadingAttributes {
     params?: Record<string, string>;
     /** Typed values for known block-meta keys (coerced from `params`). */
     blockMeta?: {
+        build?: BuildSpec;
         x?: number;
         y?: number;
         startTime?: number;
@@ -695,4 +736,4 @@ interface StringifyOptions {
     setext?: boolean;
 }
 
-export { type ParseOptions as $, type MarkdownLeafDirective as A, MarkdownLimitError as B, type MarkdownLink as C, DEFAULT_MARKDOWN_SAFETY_LIMITS as D, type MarkdownLinkDefinition as E, type MarkdownLinkReference as F, type MarkdownList as G, type HeadingAttributes as H, type MarkdownListItem as I, type MarkdownMathBlock as J, type MarkdownMention as K, type MarkdownNode as L, type MarkdownBlockNode as M, type MarkdownParagraph as N, type MarkdownPoint as O, type MarkdownSafetyLimits as P, type MarkdownSourcePosition as Q, type MarkdownStrikethrough as R, type MarkdownStrong as S, type MarkdownSubscript as T, type MarkdownSuperscript as U, type MarkdownTable as V, type MarkdownTableCell as W, type MarkdownTableRow as X, type MarkdownText as Y, type MarkdownTextDirective as Z, type MarkdownThematicBreak as _, DEFAULT_TRANSITION_DURATION_SECONDS as a, type StringifyOptions as a0, TRANSITION_DIRECTIONS as a1, TRANSITION_TYPES as a2, type Transition as a3, type TransitionDirection as a4, type TransitionType as a5, assertMarkdownDocumentWithinLimits as a6, assertMarkdownSourceWithinLimits as a7, isTransitionType as a8, normalizeTransitionDirection as a9, normalizeTransitionType as aa, resolveBlockTransition as ab, resolveMarkdownSafetyLimits as ac, resolveTransitionDuration as ad, type BlockConnection as ae, type HeadingTemplateAnnotation as b, type HtmlComment as c, type HtmlElement as d, type HtmlNode as e, type HtmlText as f, type MarkdownBlockquote as g, type MarkdownBreak as h, type MarkdownCodeBlock as i, type MarkdownContainerDirective as j, type MarkdownDefinitionDescription as k, type MarkdownDefinitionList as l, type MarkdownDefinitionTerm as m, type MarkdownDocument as n, type MarkdownEmphasis as o, type MarkdownFootnoteDefinition as p, type MarkdownFootnoteReference as q, type MarkdownHeading as r, type MarkdownHtmlBlock as s, type MarkdownImage as t, type MarkdownImageReference as u, type MarkdownInlineCode as v, type MarkdownInlineHtml as w, type MarkdownInlineIcon as x, type MarkdownInlineMath as y, type MarkdownInlineNode as z };
+export { type MarkdownStrong as $, type MarkdownHtmlBlock as A, BUILD_EFFECTS as B, type MarkdownImage as C, DEFAULT_MARKDOWN_SAFETY_LIMITS as D, type MarkdownImageReference as E, type MarkdownInlineCode as F, type MarkdownInlineHtml as G, type HeadingAttributes as H, type MarkdownInlineIcon as I, type MarkdownInlineMath as J, type MarkdownInlineNode as K, type MarkdownLeafDirective as L, type MarkdownBlockNode as M, MarkdownLimitError as N, type MarkdownLink as O, type MarkdownLinkDefinition as P, type MarkdownLinkReference as Q, type MarkdownList as R, type MarkdownListItem as S, type MarkdownMathBlock as T, type MarkdownMention as U, type MarkdownNode as V, type MarkdownParagraph as W, type MarkdownPoint as X, type MarkdownSafetyLimits as Y, type MarkdownSourcePosition as Z, type MarkdownStrikethrough as _, BUILD_MODES as a, type MarkdownSubscript as a0, type MarkdownSuperscript as a1, type MarkdownTable as a2, type MarkdownTableCell as a3, type MarkdownTableRow as a4, type MarkdownText as a5, type MarkdownTextDirective as a6, type MarkdownThematicBreak as a7, type ParseOptions as a8, type StringifyOptions as a9, TRANSITION_DIRECTIONS as aa, TRANSITION_TYPES as ab, type Transition as ac, type TransitionDirection as ad, type TransitionType as ae, assertMarkdownDocumentWithinLimits as af, assertMarkdownSourceWithinLimits as ag, buildSpecParams as ah, isTransitionType as ai, normalizeTransitionDirection as aj, normalizeTransitionType as ak, parseBuildSpec as al, recordBuildAdvance as am, resolveBlockTransition as an, resolveMarkdownSafetyLimits as ao, resolveTransitionDuration as ap, type BlockConnection as aq, BUILD_PARAM_KEYS as b, BUILD_PREVIOUS as c, type BuildAdvance as d, type BuildCursor as e, type BuildSpec as f, type BuildStep as g, type BuildTiming as h, DEFAULT_TRANSITION_DURATION_SECONDS as i, type HeadingTemplateAnnotation as j, type HtmlComment as k, type HtmlElement as l, type HtmlNode as m, type HtmlText as n, type MarkdownBlockquote as o, type MarkdownBreak as p, type MarkdownCodeBlock as q, type MarkdownContainerDirective as r, type MarkdownDefinitionDescription as s, type MarkdownDefinitionList as t, type MarkdownDefinitionTerm as u, type MarkdownDocument as v, type MarkdownEmphasis as w, type MarkdownFootnoteDefinition as x, type MarkdownFootnoteReference as y, type MarkdownHeading as z };

package/package.json

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

package/dist/{chunk-Q6ELOAOQ.js → chunk-NNJA7ICB.js}

@@ -1,3 +1,19 @@
+// src/markdown/mediaReference.ts
+var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set(["mp4", "m4v", "mov", "webm", "ogv"]);
+var AUDIO_EXTENSIONS = /* @__PURE__ */ new Set(["mp3", "m4a", "aac", "wav", "ogg", "oga", "opus", "flac"]);
+var CONTAINER_EXTENSIONS = /* @__PURE__ */ new Set(["webm", "mp4"]);
+function mediaKindForUrl(url) {
+  const path = url.split(/[?#]/, 1)[0] ?? "";
+  const name = path.slice(path.lastIndexOf("/") + 1);
+  const dot = name.lastIndexOf(".");
+  if (dot <= 0) return null;
+  const ext = name.slice(dot + 1).toLowerCase();
+  if (AUDIO_EXTENSIONS.has(ext)) return "audio";
+  if (CONTAINER_EXTENSIONS.has(ext) && /^(?:\.\/)?audio\//i.test(path)) return "audio";
+  if (VIDEO_EXTENSIONS.has(ext)) return "video";
+  return null;
+}
+
 // src/markdown/htmlParse.ts
 import { fromHtml } from "hast-util-from-html";
 var HAST_PROP_TO_ATTR = {
@@ -685,22 +701,6 @@ function plainTextFromInlineHtml(html) {
   return walk(parseHtmlToNodes(html)).replace(/\u00A0/g, " ").replace(/\n{3,}/g, "\n\n").trim();
 }
 
-// src/markdown/mediaReference.ts
-var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set(["mp4", "m4v", "mov", "webm", "ogv"]);
-var AUDIO_EXTENSIONS = /* @__PURE__ */ new Set(["mp3", "m4a", "aac", "wav", "ogg", "oga", "opus", "flac"]);
-var CONTAINER_EXTENSIONS = /* @__PURE__ */ new Set(["webm", "mp4"]);
-function mediaKindForUrl(url) {
-  const path = url.split(/[?#]/, 1)[0] ?? "";
-  const name = path.slice(path.lastIndexOf("/") + 1);
-  const dot = name.lastIndexOf(".");
-  if (dot <= 0) return null;
-  const ext = name.slice(dot + 1).toLowerCase();
-  if (AUDIO_EXTENSIONS.has(ext)) return "audio";
-  if (CONTAINER_EXTENSIONS.has(ext) && /^(?:\.\/)?audio\//i.test(path)) return "audio";
-  if (VIDEO_EXTENSIONS.has(ext)) return "video";
-  return null;
-}
-
 // src/markdown/videoEmbed.ts
 var VIDEO_EMBED_PROVIDERS = [
   { id: "youtube", name: "YouTube", example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
@@ -1058,6 +1058,7 @@ function findBlockVideoEmbed(node) {
 }
 
 export {
+  mediaKindForUrl,
   parseHtmlToNodes,
   stringifyHtmlNodes,
   getChildren,
@@ -1075,7 +1076,6 @@ export {
   inferDocumentTitle,
   readFrontmatterThemeId,
   plainTextFromInlineHtml,
-  mediaKindForUrl,
   VIDEO_EMBED_PROVIDERS,
   parseVideoStartTime,
   parseVideoEmbedUrl,