@bendyline/squisq 1.5.0 → 1.5.1

package/dist/story/index.d.ts

@@ -1,8 +1,8 @@
-import { a2 as PersistentLayer, ax as Theme, R as Layer, a3 as PersistentLayerConfig, aE as TitleBlockInput, as as TemplateContext, ag as SectionHeaderInput, am as StatHighlightInput, ab as QuoteBlockInput, H as FactCardInput, aG as TwoColumnInput, t as DateEventInput, P as ImageWithCaptionInput, T as LeftFeatureInput, ae as RightFeatureInput, W as MapBlockInput, al as StartBlockConfig, K as FullBleedQuoteInput, V as ListBlockInput, a7 as PhotoGridInput, v as DefinitionCardInput, n as ComparisonBarInput, aa as PullQuoteInput, aK as VideoWithCaptionInput, aJ as VideoPullQuoteInput, s as DataTableInput, w as DiagramBlockInput, B as Block, E as DrawingBlockInput, _ as MarkerStyle, ar as TemplateBlock, A as AccentImage, O as ImageTreatment, a as AccentPosition, aL as ViewportConfig, p as CustomTemplateDefinition, y as DocBlock, au as TemplateRegistry, c as Animation, d as AnimationType, az as ThemeColorScheme, x as Doc, z as DocDiagnostic } from '../Doc-BsMkmzH8.js';
-export { F as FRONTMATTER_CUSTOM_TEMPLATES_KEY, G as FRONTMATTER_CUSTOM_THEMES_KEY, S as LayoutHints, ad as RenderStyle, ay as ThemeColorPalette, aC as ThemeStyle, aD as ThemeTypography, aH as VIEWPORT_PRESETS, aM as ViewportOrientation, aN as ViewportPreset, aS as createTemplateContext, aY as getLayoutHints, b0 as getTwoColumnPositions, b1 as getViewport, b2 as getViewportOrientation, b4 as isTemplateBlock, b9 as scaledFontSize } from '../Doc-BsMkmzH8.js';
+import { a4 as PersistentLayer, az as Theme, S as Layer, a5 as PersistentLayerConfig, aG as TitleBlockInput, au as TemplateContext, ai as SectionHeaderInput, ao as StatHighlightInput, ad as QuoteBlockInput, I as FactCardInput, aI as TwoColumnInput, u as DateEventInput, Q as ImageWithCaptionInput, V as LeftFeatureInput, ag as RightFeatureInput, Y as MapBlockInput, an as StartBlockConfig, L as FullBleedQuoteInput, X as ListBlockInput, a9 as PhotoGridInput, w as DefinitionCardInput, n as ComparisonBarInput, ac as PullQuoteInput, aM as VideoWithCaptionInput, aL as VideoPullQuoteInput, t as DataTableInput, x as DiagramBlockInput, B as Block, F as DrawingBlockInput, a0 as MarkerStyle, at as TemplateBlock, A as AccentImage, P as ImageTreatment, a as AccentPosition, aN as ViewportConfig, p as CustomTemplateDefinition, z as DocBlock, aw as TemplateRegistry, c as Animation, d as AnimationType, aB as ThemeColorScheme, y as Doc, E as DocDiagnostic } from '../Doc-BBVGq1_9.js';
+export { G as FRONTMATTER_CUSTOM_TEMPLATES_KEY, H as FRONTMATTER_CUSTOM_THEMES_KEY, U as LayoutHints, af as RenderStyle, aA as ThemeColorPalette, aE as ThemeStyle, aF as ThemeTypography, aJ as VIEWPORT_PRESETS, aO as ViewportOrientation, aP as ViewportPreset, aU as createTemplateContext, a_ as getLayoutHints, b2 as getTwoColumnPositions, b3 as getViewport, b4 as getViewportOrientation, b6 as isTemplateBlock, bb as scaledFontSize } from '../Doc-BBVGq1_9.js';
 import { I as MarkdownNode, $ as TransitionType, _ as TransitionDirection, M as MarkdownBlockNode, q as MarkdownHeading, m as MarkdownDocument, P as MarkdownTable, h as MarkdownCodeBlock } from '../types-DlAZ7MW4.js';
-import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DQQKuRMx.js';
+import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-CehcJhzz.js';
 
 /**
  * Canonical, framework-free UI metadata for every built-in block template.
@@ -1336,7 +1336,9 @@ declare function readCustomTemplatesFromFrontmatter(frontmatter: Record<string,
  * object described in the module header. Returns undefined when the
  * input list is empty so callers can leave the key off the output.
  */
-declare function writeCustomTemplatesToFrontmatter(templates: readonly CustomTemplateDefinition[] | undefined): string | undefined;
+declare function writeCustomTemplatesToFrontmatter(templates: readonly CustomTemplateDefinition[] | undefined, options?: {
+    pretty?: boolean;
+}): string | undefined;
 
 /**
  * Frontmatter serialization for user-defined custom themes.
@@ -1375,7 +1377,9 @@ declare function readCustomThemesFromFrontmatter(frontmatter: Record<string, unk
  * the module header (keyed by theme id). Returns undefined when the input is
  * empty so callers can leave the key off the output.
  */
-declare function writeCustomThemesToFrontmatter(themes: readonly Theme[] | undefined): string | undefined;
+declare function writeCustomThemesToFrontmatter(themes: readonly Theme[] | undefined, options?: {
+    pretty?: boolean;
+}): string | undefined;
 
 /**
  * Doc-scoped theme resolution.
@@ -1542,10 +1546,12 @@ declare function resolveAudioMapping(doc: Doc, container: ContentContainer): Pro
  *    didn't provide them explicitly.
  *
  * YAML support is a documented subset (this package has no YAML
- * dependency): top-level `key: scalar`, `key: [inline, array]`, and
- * `key:` followed by an indented `- item` block sequence whose items are
- * scalars or inline arrays. Nested maps are rejected with a clear error —
- * use a `json data` fence for deeply nested input.
+ * dependency): top-level `key: scalar`, `key: [inline, array]`, `key:`
+ * followed by an indented `- item` block sequence (scalars or inline
+ * arrays), and `key:` followed by *one level* of indented `subkey: scalar`
+ * lines (a nested map, e.g. `center:` + indented `lat:` / `lng:`). Deeper
+ * nesting, and mixing list items with mapping keys under one key, are
+ * rejected with a clear error — use a `json data` fence for those.
  */
 
 /**
@@ -1565,6 +1571,17 @@ interface DataFenceParseResult {
  * fences are parsed with {@link parseYamlSubset}.
  */
 declare function parseDataFence(node: MarkdownCodeBlock): DataFenceParseResult;
+/**
+ * Return a new contents array with the first data fence's code content
+ * replaced by `data` (pretty-printed JSON). The fence node keeps its
+ * language and `data` marker; only `value` changes. When no data fence
+ * exists, a new ` ```json data ` fence is appended instead.
+ *
+ * Pure: neither `contents` nor its nodes are mutated. This is the write
+ * half of the data-fence channel — editors update `block.templateData`
+ * and call this to reflect the change back into `block.contents`.
+ */
+declare function replaceDataFence(contents: MarkdownBlockNode[], data: Record<string, unknown>): MarkdownBlockNode[];
 /**
  * Parse the supported YAML subset (see module doc) into a key→value map.
  * Throws an Error with a line-anchored message on anything outside the
@@ -1624,6 +1641,7 @@ interface MarkdownValidationResult {
     diagnostics: DocDiagnostic[];
     errorCount: number;
     warningCount: number;
+    infoCount: number;
     /** The converted Doc (conversion diagnostics are included above). */
     doc: Doc;
 }
@@ -1660,4 +1678,100 @@ declare function validateMarkdownDoc(markdownDoc: MarkdownDocument, options?: Va
  */
 declare function fallbackBlockLayers(block: DocBlock, context: TemplateContext, notice: string): Layer[];
 
-export { type AccentLayout, type AudioSegmentTiming, CONTAINER_TEMPLATES, type ClipBox, type ConnectorRouting, type CoverBlockInput, DEFAULT_LAYOUT, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DiagramEdge, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DocStylePreset, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, PATH_SHAPE_KINDS, PersistentLayerConfig, type RenderContext, type RuntimeTemplateRegistry, SHAPE_NAMES, TEMPLATE_ALIASES, TEMPLATE_METADATA, TemplateBlock, TemplateContext, type TemplateMetadata, Theme, ThemeColorScheme, type ValidateOptions, ViewportConfig, adjustY, applyRenderStyleToLayers, buildRegistry, clipEndpoints, clipPoint, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, decodeLayersFromFrontmatter, definitionCard, deriveTemplateInputs, diagramBlock, docToMarkdown, drawingBlock, encodeLayersForFrontmatter, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstTable, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getPersistentLayersFromTheme, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isContainerTemplate, isDataFence, isShapeName, layoutBlock, leftFeature, lineStyleDasharray, listBlock, mapBlock, markdownToDoc, markerPath, normalizeShapeKind, parseDataFence, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, resolveAudioMapping, resolveColorScheme, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shapePath, shouldUseShadow, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, titleBlock, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };
+/**
+ * Template input descriptors — a typed catalog of the inline `{[…]}` params
+ * each built-in template understands, plus the pure coercion + lint logic
+ * that consumes it.
+ *
+ * Two jobs, one source of truth:
+ *
+ * - **Coercion (`coerceTemplateParams`)** turns a flat `key → raw string`
+ *   param map (from a `{[name key=value]}` annotation, always strings) into a
+ *   partial typed input the template functions can consume directly — e.g.
+ *   `center="47.6,-122.3"` → `{ lat: 47.6, lng: -122.3 }`, `zoom=9` → `9`.
+ *   This is what makes `{[map center="47.6,-122.3" zoom=9]}` render with no
+ *   changes to any template function. Unknown keys ALWAYS pass through
+ *   untouched (as strings), so coercion is never lossy; coercion failures are
+ *   returned as `warnings` and the raw string is preserved.
+ *
+ * - **Linting (`lintTemplateParams`)** checks a param map against the
+ *   descriptors and reports unknown keys (with a did-you-mean suggestion),
+ *   values outside a closed enum / that fail coercion, and missing required
+ *   inputs. The document validator surfaces these as diagnostics.
+ *
+ * This mirrors the proven block-meta descriptor pattern in
+ * `markdown/annotationCoercion.ts` (`BLOCK_META_KEY_DESCRIPTORS`), extended
+ * from block geometry/timing to per-template content inputs.
+ *
+ * The descriptors are the `{[…]}` counterpart of the template input
+ * interfaces in `schemas/BlockTemplates.ts` — only keys/enums that provably
+ * exist on those interfaces are declared. Keys that can't be meaningfully
+ * expressed as a single inline string (e.g. a `dataTable`'s `rows`) are still
+ * declared with `coerce: 'string'` so they aren't mis-flagged as unknown.
+ */
+/** How a raw `{[…]}` param string is coerced into a typed input value. */
+type InputCoercion = 'string' | 'number' | 'boolean' | 'latLng' | 'labeledPair' | 'stringList';
+/**
+ * Editor/validator-facing description of a single template input key: what it
+ * does, how to coerce its raw string, and either its closed set of valid
+ * values or a free-form format hint. `values`/`valueHint` are mutually
+ * exclusive (a key has a closed enum OR a hint, not both).
+ */
+interface TemplateInputDescriptor {
+    /** The `{[name key=…]}` param key, matching the template input interface. */
+    key: string;
+    /** One-line description of the input. */
+    description: string;
+    /** Coercion strategy for the raw string (default `'string'`). */
+    coerce?: InputCoercion;
+    /** Closed set of valid values, for keys backed by an enum. */
+    values?: readonly string[];
+    /** Format hint shown when the value is free-form (no closed set). */
+    valueHint?: string;
+    /** When true, the validator warns if the key is absent and can't be derived. */
+    required?: boolean;
+}
+/** A single lint finding produced by {@link lintTemplateParams}. */
+interface TemplateParamFinding {
+    kind: 'unknown-input' | 'invalid-input-value' | 'missing-input';
+    key: string;
+    message: string;
+    /** Did-you-mean candidate (for `unknown-input`). */
+    suggestion?: string;
+}
+/**
+ * Inputs shared by every template via `BaseTemplateBlock`. Merged into each
+ * template's known-key set for coercion + lint. Block-level timing/geometry
+ * keys (`duration`, `x`, `y`, …) are NOT here — those stay owned by the
+ * block-meta registry (`KNOWN_BLOCK_META_KEYS`) and are folded into the lint
+ * known-key set separately.
+ */
+declare const BASE_INPUT_DESCRIPTORS: readonly TemplateInputDescriptor[];
+/**
+ * Per-template input descriptors, keyed by canonical template id. A template
+ * absent from this map has no descriptors and is exempt from lint (custom
+ * templates and not-yet-described built-ins).
+ */
+declare const TEMPLATE_INPUT_DESCRIPTORS: Readonly<Record<string, readonly TemplateInputDescriptor[]>>;
+/**
+ * Coerce a flat `{[…]}` param map into a partial typed template input.
+ *
+ * Known descriptor keys are coerced per their `coerce` strategy; unknown keys
+ * (and `string`-typed keys) pass through unchanged. A coercion failure leaves
+ * the raw string in place and adds a human-readable `warnings` entry — the
+ * output is never lossy. Returns a fresh object; the caller must NOT feed
+ * `templateOverrides` back in — only the ephemeral merged input is coerced.
+ */
+declare function coerceTemplateParams(template: string | undefined, params: Record<string, string>): {
+    input: Record<string, unknown>;
+    warnings: string[];
+};
+/**
+ * Lint a template's `{[…]}` params against its descriptors. Returns findings
+ * for unknown keys, values outside a closed enum / that fail coercion, and
+ * missing required inputs. Templates without descriptors (custom or
+ * not-yet-described built-ins) return `[]`.
+ */
+declare function lintTemplateParams(template: string, params: Record<string, string>): TemplateParamFinding[];
+
+export { type AccentLayout, type AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, CONTAINER_TEMPLATES, type ClipBox, type ConnectorRouting, type CoverBlockInput, DEFAULT_LAYOUT, type DataFenceParseResult, type DeriveTemplateInputsOptions, type DiagramEdge, type DiagramLayout, type DiagramLayoutOptions, type DiagramNodePosition, DocBlock, type DocStylePreset, type DrawingConnector, type DrawingLayout, type DrawingLayoutOptions, type DrawingShape, type DrawingShapeKind, type ExpandDocBlocksOptions, type ExtractedTableData, type FirstImage, type InputCoercion, type LayoutLayerDefaults, type LayoutLayersResult, type MarkdownToDocOptions, type MarkdownValidationResult, PATH_SHAPE_KINDS, PersistentLayerConfig, type RenderContext, type RuntimeTemplateRegistry, SHAPE_NAMES, TEMPLATE_ALIASES, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TemplateBlock, TemplateContext, type TemplateInputDescriptor, type TemplateMetadata, type TemplateParamFinding, Theme, ThemeColorScheme, type ValidateOptions, ViewportConfig, adjustY, applyRenderStyleToLayers, buildRegistry, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, decodeLayersFromFrontmatter, definitionCard, deriveTemplateInputs, diagramBlock, docToMarkdown, drawingBlock, encodeLayersForFrontmatter, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstTable, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getPersistentLayersFromTheme, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isContainerTemplate, isDataFence, isShapeName, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, normalizeShapeKind, parseDataFence, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shapePath, shouldUseShadow, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, titleBlock, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter };

package/dist/story/index.js

@@ -1,12 +1,15 @@
 import {
+  BASE_INPUT_DESCRIPTORS,
   CONTAINER_TEMPLATES,
   DEFAULT_LAYOUT,
   SHAPE_NAMES,
   TEMPLATE_ALIASES,
+  TEMPLATE_INPUT_DESCRIPTORS,
   TEMPLATE_METADATA,
   adjustY,
   applyRenderStyleToLayers,
   buildRegistry,
+  coerceTemplateParams,
   comparisonBar,
   computeDiagramLayout,
   computeDrawingLayout,
@@ -62,6 +65,7 @@ import {
   isShapeName,
   layoutBlock,
   leftFeature,
+  lintTemplateParams,
   listBlock,
   mapBlock,
   markdownToDoc,
@@ -73,6 +77,7 @@ import {
   quoteBlock,
   readCustomTemplatesFromFrontmatter,
   readCustomThemesFromFrontmatter,
+  replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
   resolvePersistentLayers,
@@ -100,8 +105,8 @@ import {
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "../chunk-4ZFRZBU2.js";
-import "../chunk-LRCV7N7F.js";
+} from "../chunk-LH7I6SH7.js";
+import "../chunk-UY7KGQ5R.js";
 import "../chunk-V543AI2F.js";
 import "../chunk-FVTQSNR7.js";
 import {
@@ -120,7 +125,7 @@ import {
   getAvailableThemes,
   getThemeSummaries,
   resolveTheme
-} from "../chunk-4AKUQPEE.js";
+} from "../chunk-KKNUBQ6Y.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -131,13 +136,13 @@ import {
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
 } from "../chunk-DLXZMS5K.js";
-import "../chunk-OH43RPTP.js";
-import "../chunk-OKJOQXK4.js";
+import "../chunk-TEEEILMP.js";
+import "../chunk-HWVFJAAH.js";
 import "../chunk-DBS6RIFL.js";
 import "../chunk-QE7TWGVT.js";
-import "../chunk-4X3JQXNM.js";
-import "../chunk-3E5F2XMR.js";
+import "../chunk-VWUFZ6ZG.js";
 export {
+  BASE_INPUT_DESCRIPTORS,
   CONTAINER_TEMPLATES,
   DEFAULT_LAYOUT,
   DEFAULT_THEME,
@@ -146,6 +151,7 @@ export {
   PATH_SHAPE_KINDS,
   SHAPE_NAMES,
   TEMPLATE_ALIASES,
+  TEMPLATE_INPUT_DESCRIPTORS,
   TEMPLATE_METADATA,
   VIEWPORT_PRESETS,
   adjustY,
@@ -153,6 +159,7 @@ export {
   buildRegistry,
   clipEndpoints,
   clipPoint,
+  coerceTemplateParams,
   comparisonBar,
   computeDiagramLayout,
   computeDrawingLayout,
@@ -218,6 +225,7 @@ export {
   layoutBlock,
   leftFeature,
   lineStyleDasharray,
+  lintTemplateParams,
   listBlock,
   mapBlock,
   markdownToDoc,
@@ -230,6 +238,7 @@ export {
   quoteBlock,
   readCustomTemplatesFromFrontmatter,
   readCustomThemesFromFrontmatter,
+  replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
   resolvePersistentLayers,

package/dist/{themeLibrary-DQQKuRMx.d.ts → themeLibrary-CehcJhzz.d.ts}

@@ -1,4 +1,4 @@
-import { ax as Theme } from './Doc-BsMkmzH8.js';
+import { az as Theme } from './Doc-BBVGq1_9.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.js

@@ -1,16 +1,14 @@
 import "../chunk-DNJKBAI7.js";
-import {
-  estimateNarrationTime,
-  estimateReadingTime
-} from "../chunk-4X3JQXNM.js";
 import {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,
   countSpokenWords,
   estimateNarrationDuration,
+  estimateNarrationTime,
+  estimateReadingTime,
   estimateSpokenWordCount,
   estimateTimeFromText
-} from "../chunk-3E5F2XMR.js";
+} from "../chunk-VWUFZ6ZG.js";
 export {
   DEFAULT_WORDS_PER_SECOND,
   calculatePrefixDuration,

package/dist/transform/index.d.ts

@@ -1,4 +1,4 @@
-import { m as ColorScheme, x as Doc, B as Block } from '../Doc-BsMkmzH8.js';
+import { m as ColorScheme, y as Doc, B as Block } from '../Doc-BBVGq1_9.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-DlAZ7MW4.js';
 
@@ -70,7 +70,7 @@ interface TransformStyleConfig {
         outro?: boolean;
     };
     /**
-     * Duration-based slide budget (folded in from the deprecated
+     * Duration-based slide budget (folded in from the since-removed
      * `generateSlideshow`): caps promoted template blocks at roughly
      * `slidesPerMinute` of doc duration (default: uncapped — only
      * `transformRatio` applies).

package/dist/transform/index.js

@@ -8,11 +8,11 @@ import {
   registerTransformStyle,
   resolveTransformStyle,
   unregisterTransformStyle
-} from "../chunk-TVSGLUID.js";
-import "../chunk-FR2RBTKO.js";
+} from "../chunk-LDQ2HJIX.js";
+import "../chunk-TQWLI6S2.js";
 import "../chunk-FVTQSNR7.js";
 import "../chunk-DLXZMS5K.js";
-import "../chunk-OKJOQXK4.js";
+import "../chunk-HWVFJAAH.js";
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
   analyzeBlocks,

package/dist/versions/index.d.ts

@@ -1,5 +1,5 @@
 import { C as CoalesceOptions, V as Version, P as PrunePolicy, R as RevertOptions, S as SaveVersionOptions, a as SaveVersionResult } from '../types-D98li1gV.js';
-import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
+import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
 
 /**
  * Pure-ish version operations against a {@link ContentContainer}.

package/package.json

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

package/src/__tests__/contentExtractor.test.ts

@@ -116,6 +116,36 @@ describe('extractContent — comparisons', () => {
       expect(comp.right.label).toBeTruthy();
     }
   });
+
+  it('does not let a comparison capture cross a sentence boundary', () => {
+    // Regression: greedy `.{2,30}` used to capture right="witness. Robertson"
+    // from the "from witness to witness." idiom bleeding into the next sentence.
+    const text =
+      'Testimony about who carried guns and how many shots were fired ' +
+      'contradicted from witness to witness. Robertson, who initially ' +
+      'testified against the others, was later named as the ringleader.';
+    const result = extractContent(text, { types: ['comparison'] });
+    for (const el of result.elements) {
+      if (el.data.type === 'comparison') {
+        expect(el.data.left.label).not.toContain('.');
+        expect(el.data.right.label).not.toContain('.');
+        expect(el.data.right.label.toLowerCase()).not.toContain('robertson');
+      }
+    }
+  });
+
+  it('rejects idiomatic "from X to X" non-comparisons', () => {
+    // "from witness to witness", "from day to day" mean "it varied", not "A vs B".
+    for (const text of [
+      'The testimony varied from witness to witness across the trial.',
+      'Conditions changed from day to day during the expedition.',
+      'The practice was handed down from generation to generation.',
+    ]) {
+      const result = extractContent(text, { types: ['comparison'] });
+      const comparisons = result.elements.filter((e) => e.data.type === 'comparison');
+      expect(comparisons.length).toBe(0);
+    }
+  });
 });
 
 describe('extractContent — impact lines', () => {
@@ -125,6 +155,36 @@ describe('extractContent — impact lines', () => {
     const result = extractContent(text, { types: ['impactLine'] });
     expect(result.elements.length).toBeGreaterThan(0);
   });
+
+  it('does not split sentences on abbreviations or initials', () => {
+    // Regression: "…at George W. Tibbetts' store…" was split at "W." into the
+    // fragment "They were met at George W" and shown as a standalone slide.
+    const text =
+      "They were met at George W. Tibbetts' store by a crowd of white and Native men " +
+      'who intimidated them into turning back.';
+    const result = extractContent(text, { types: ['impactLine', 'fact'] });
+    for (const el of result.elements) {
+      if (el.data.type === 'impactLine') {
+        expect(el.data.text).not.toMatch(/George W$/);
+      }
+      if (el.data.type === 'fact') {
+        expect(el.data.fact).not.toMatch(/George W$/);
+      }
+      // No fragment should end on a bare single-letter initial.
+      expect(el.text).not.toMatch(/\b[A-Z]$/);
+    }
+  });
+
+  it('keeps initials-heavy name lists intact as one sentence', () => {
+    const text =
+      'A jury named M. DeWitt Rumsey, Joseph Day, and David Hughes among the killers. ' +
+      'The verdict shocked the town.';
+    const result = extractContent(text, { types: ['fact', 'impactLine'] });
+    // The "M." initial must not spawn a "A jury named M" fragment.
+    for (const el of result.elements) {
+      expect(el.text).not.toMatch(/named M$/);
+    }
+  });
 });
 
 describe('extractContent — lists', () => {

package/src/__tests__/coverBlock.test.ts

@@ -1,5 +1,10 @@
 import { describe, it, expect } from 'vitest';
-import { coverBlock, expandCoverBlock, startBlockToCoverInput } from '../doc/templates/coverBlock';
+import {
+  coverBlock,
+  expandCoverBlock,
+  startBlockToCoverInput,
+  fitCoverTitleSize,
+} from '../doc/templates/coverBlock';
 import { createTemplateContext, DEFAULT_THEME, VIEWPORT_PRESETS } from '../doc/templates/index';
 import type { StartBlockConfig } from '../schemas/Doc';
 import type { CoverBlockInput } from '../doc/templates/coverBlock';
@@ -179,6 +184,46 @@ describe('coverBlock viewport scaling', () => {
   });
 });
 
+// ── Long-title auto-fit ─────────────────────────────────────────────
+
+describe('coverBlock long-title auto-fit', () => {
+  const LONG = 'Seattle: The Emerald City That Rebuilt Itself on Top of Itself';
+
+  it('fitCoverTitleSize returns full base for short titles', () => {
+    expect(fitCoverTitleSize('Kirkland')).toBe(120);
+    expect(fitCoverTitleSize('Test Title')).toBe(120);
+  });
+
+  it('fitCoverTitleSize shrinks long titles below the full base', () => {
+    const size = fitCoverTitleSize(LONG);
+    expect(size).toBeLessThan(120);
+    expect(size).toBeGreaterThanOrEqual(62); // never below the readability floor
+  });
+
+  it('fitCoverTitleSize never drops below the readability floor', () => {
+    const size = fitCoverTitleSize('x'.repeat(400));
+    expect(size).toBe(62);
+  });
+
+  it('fitCoverTitleSize is monotonic — longer titles are never larger', () => {
+    const a = fitCoverTitleSize('A moderately long cover title here');
+    const b = fitCoverTitleSize('A moderately long cover title here that keeps going and going');
+    expect(b).toBeLessThanOrEqual(a);
+  });
+
+  it('renders a long title with a smaller font than a short one', () => {
+    const shortTitle = findText(
+      coverBlock({ heroSrc: 'h.jpg', title: 'Short' }, landscapeContext),
+      'cover-title',
+    );
+    const longTitle = findText(
+      coverBlock({ heroSrc: 'h.jpg', title: LONG }, landscapeContext),
+      'cover-title',
+    );
+    expect(longTitle!.content.style.fontSize).toBeLessThan(shortTitle!.content.style.fontSize);
+  });
+});
+
 // ── startBlockToCoverInput ──────────────────────────────────────────
 
 describe('startBlockToCoverInput', () => {

package/src/__tests__/customTemplateSample.test.ts

@@ -11,8 +11,12 @@ import { describe, it, expect } from 'vitest';
 import { markdownToDoc } from '../doc/markdownToDoc';
 import { expandDocBlocks } from '../doc/templates/index';
 import { parseMarkdown } from '../markdown/parse';
-import { writeCustomTemplatesToFrontmatter } from '../doc/customTemplatesFrontmatter';
-import type { CustomTemplateDefinition } from '../schemas/CustomTemplates.js';
+import {
+  writeCustomTemplatesToFrontmatter,
+  readCustomTemplatesFromFrontmatter,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+} from '../doc/customTemplatesFrontmatter';
+import type { CustomTemplateDefinition, LayerRepeat } from '../schemas/CustomTemplates.js';
 import type { TextLayer } from '../schemas/Doc.js';
 import { VIEWPORT_PRESETS } from '../schemas/Viewport.js';
 
@@ -80,4 +84,61 @@ describe('Custom template pipeline (markdown → expanded layers)', () => {
     expect(layers[0].position.x).toBe('6%');
     expect(layers[0].position.width).toBe('88%');
   });
+
+  it('resolves {attr:key} against a block heading annotation through the pipeline', () => {
+    const attrDef: CustomTemplateDefinition = {
+      name: 'badge',
+      label: 'Badge',
+      viewport: { width: 1920, height: 1080 },
+      layers: [
+        {
+          id: 'badge-role',
+          type: 'text',
+          position: { x: '6%', y: '20%', width: '88%' },
+          content: { text: 'Role: {attr:role|none}', style: { fontSize: 48, color: '#000' } },
+        },
+      ],
+    };
+    const payload = writeCustomTemplatesToFrontmatter([attrDef]);
+    const md = `---
+squisq-custom-templates: "${payload}"
+---
+
+# Team {[badge role=lead]}
+
+Body.
+`;
+    const doc = markdownToDoc(parseMarkdown(md));
+    const blocks = expandDocBlocks(doc.blocks, { customTemplates: doc.customTemplates });
+    const layers = blocks[0].layers ?? [];
+    expect((layers[0] as TextLayer).content.text).toBe('Role: lead');
+  });
+});
+
+describe('Custom template codec — repeat round-trip', () => {
+  it('preserves a layer.repeat directive through write → read (passes through unmapped)', () => {
+    const repeat: LayerRepeat = { source: 'images', direction: 'row', gap: 12, max: 4 };
+    const def: CustomTemplateDefinition = {
+      name: 'gallery',
+      label: 'Gallery',
+      viewport: { width: 1920, height: 1080 },
+      layers: [
+        {
+          id: 'thumb',
+          type: 'image',
+          position: { x: '0%', y: '0%', width: '25%', height: '25%' },
+          content: { src: '{item:src}', alt: '{item:label}' },
+          repeat,
+        },
+      ],
+    };
+    const payload = writeCustomTemplatesToFrontmatter([def]);
+    expect(payload).toBeDefined();
+    const round = readCustomTemplatesFromFrontmatter({
+      [FRONTMATTER_CUSTOM_TEMPLATES_KEY]: JSON.parse(payload as string),
+    });
+    expect(round).toBeDefined();
+    const layer = round?.[0].layers[0] as (typeof def.layers)[number];
+    expect(layer.repeat).toEqual(repeat);
+  });
 });

package/src/__tests__/customTemplatesFrontmatter.test.ts

@@ -71,6 +71,37 @@ describe('writeCustomTemplatesToFrontmatter → readCustomTemplatesFromFrontmatt
     expect(out![0]).toEqual(heroDef);
   });
 
+  it('default output is compact (single line) and byte-unchanged', () => {
+    const payload = writeCustomTemplatesToFrontmatter([heroDef])!;
+    expect(payload).not.toContain('\n');
+    // Explicit pretty:false must match the historical default exactly.
+    expect(writeCustomTemplatesToFrontmatter([heroDef], { pretty: false })).toBe(payload);
+  });
+
+  it('pretty:true emits multi-line JSON that still reads back', () => {
+    const payload = writeCustomTemplatesToFrontmatter([heroDef], { pretty: true })!;
+    expect(payload).toContain('\n');
+    // Same compact key codec, just pretty-printed.
+    expect(payload).toContain('"lb": "Hero"');
+    const fm = { [FRONTMATTER_CUSTOM_TEMPLATES_KEY]: payload };
+    const out = readCustomTemplatesFromFrontmatter(fm);
+    expect(out).toHaveLength(1);
+    expect(out![0]).toEqual(heroDef);
+  });
+
+  it('a hand-written block-scalar frontmatter parses back into the definition', () => {
+    const payload = writeCustomTemplatesToFrontmatter([heroDef], { pretty: true })!;
+    const body = payload
+      .split('\n')
+      .map((l) => `  ${l}`)
+      .join('\n');
+    const md = `---\n${FRONTMATTER_CUSTOM_TEMPLATES_KEY}: |-\n${body}\n---\n\n# Hi\n`;
+    const parsed = parseMarkdown(md);
+    const out = readCustomTemplatesFromFrontmatter(parsed.frontmatter);
+    expect(out).toHaveLength(1);
+    expect(out![0]).toEqual(heroDef);
+  });
+
   it('is markedly smaller than the legacy base64 form', () => {
     const compact = writeCustomTemplatesToFrontmatter([heroDef])!;
     const legacyBase64 = btoa(unescape(encodeURIComponent(JSON.stringify([{ ...heroDef }]))));

package/src/__tests__/customThemesFrontmatter.test.ts

@@ -37,6 +37,33 @@ describe('writeCustomThemesToFrontmatter → readCustomThemesFromFrontmatter', (
     expect(out![0]).toEqual(brand);
   });
 
+  it('default output is compact (single line) and byte-unchanged', () => {
+    const payload = writeCustomThemesToFrontmatter([brand])!;
+    expect(payload).not.toContain('\n');
+    expect(writeCustomThemesToFrontmatter([brand], { pretty: false })).toBe(payload);
+  });
+
+  it('pretty:true emits multi-line JSON that still reads back', () => {
+    const payload = writeCustomThemesToFrontmatter([brand], { pretty: true })!;
+    expect(payload).toContain('\n');
+    const out = readCustomThemesFromFrontmatter({ [FRONTMATTER_CUSTOM_THEMES_KEY]: payload });
+    expect(out).toHaveLength(1);
+    expect(out![0]).toEqual(brand);
+  });
+
+  it('a hand-written block-scalar frontmatter parses back into the theme', () => {
+    const payload = writeCustomThemesToFrontmatter([brand], { pretty: true })!;
+    const body = payload
+      .split('\n')
+      .map((l) => `  ${l}`)
+      .join('\n');
+    const md = `---\n${FRONTMATTER_CUSTOM_THEMES_KEY}: |-\n${body}\n---\n\n# Hi\n`;
+    const parsed = parseMarkdown(md);
+    const out = readCustomThemesFromFrontmatter(parsed.frontmatter);
+    expect(out).toHaveLength(1);
+    expect(out![0]).toEqual(brand);
+  });
+
   it('round-trips multiple themes keyed by id', () => {
     const second = compileTheme({
       id: 'second',