@bendyline/squisq 1.5.0 → 1.5.2

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.
@@ -516,9 +516,11 @@ declare function drawingBlock(input: DrawingBlockInput, context: TemplateContext
  *  - `markerPath(style, dir)` → the `<marker>` path for a line end-style, in the
  *    standard 0–10 marker viewBox (shared by the SSR `PathLayer` renderer and the
  *    editor's edge renderer).
- *  - `connectorPath(routing, start, end)` + `clipEndpoints(a, b)` → the line/edge
+ *  - `connectorPath(routing, start, end)` + `snapEndpoints(a, b)` → the line/edge
  *    geometry between two shapes (straight / orthogonal / curved), lifted from the
- *    diagram template so drawings and diagrams draw identical connectors.
+ *    diagram template so drawings and diagrams draw identical connectors. The older
+ *    `clipEndpoints(a, b)` helper remains for free-angle clipping, but rendered
+ *    connectors use snapped ports so authored lines land on stable attachment points.
  */
 
 /** Connector routing styles. */
@@ -549,6 +551,12 @@ interface ClipBox {
     rx: number;
     ry: number;
 }
+type ConnectorPort = 'top' | 'right' | 'bottom' | 'left' | 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left';
+interface ConnectorSnapPoint {
+    port: ConnectorPort;
+    x: number;
+    y: number;
+}
 /** Intersection of the center-to-center line with `from`'s bounding box. */
 declare function clipPoint(from: ClipBox, to: ClipBox): {
     x: number;
@@ -565,6 +573,22 @@ declare function clipEndpoints(a: ClipBox, b: ClipBox): {
         y: number;
     };
 };
+/** The stable connector ports exposed around a shape/card box. */
+declare function snapPoints(box: ClipBox): ConnectorSnapPoint[];
+/** Nearest stable connector port on `box` to an arbitrary point. */
+declare function nearestSnapPoint(box: ClipBox, point: {
+    x: number;
+    y: number;
+}): ConnectorSnapPoint;
+/**
+ * Pick the pair of connector ports, one on each box, with the shortest
+ * distance between them. This gives stable attachments to side/corner handles
+ * instead of arbitrary center-ray intersections.
+ */
+declare function snapEndpoints(a: ClipBox, b: ClipBox): {
+    start: ConnectorSnapPoint;
+    end: ConnectorSnapPoint;
+};
 /** Build the SVG `d` for a connector between two clipped endpoints. */
 declare function connectorPath(routing: ConnectorRouting, start: {
     x: number;
@@ -1336,7 +1360,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 +1401,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 +1570,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 +1595,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 +1665,7 @@ interface MarkdownValidationResult {
     diagnostics: DocDiagnostic[];
     errorCount: number;
     warningCount: number;
+    infoCount: number;
     /** The converted Doc (conversion diagnostics are included above). */
     doc: Doc;
 }
@@ -1660,4 +1702,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 ConnectorPort, type ConnectorRouting, type ConnectorSnapPoint, 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, nearestSnapPoint, normalizeShapeKind, parseDataFence, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, 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-5TYS5V3G.js";
+import "../chunk-UY7KGQ5R.js";
 import "../chunk-V543AI2F.js";
 import "../chunk-FVTQSNR7.js";
 import {
@@ -111,8 +116,11 @@ import {
   connectorPath,
   lineStyleDasharray,
   markerPath,
-  shapePath
-} from "../chunk-RUDYOTA6.js";
+  nearestSnapPoint,
+  shapePath,
+  snapEndpoints,
+  snapPoints
+} from "../chunk-LTN6I7QW.js";
 import {
   DEFAULT_THEME,
   FRONTMATTER_CUSTOM_TEMPLATES_KEY,
@@ -120,7 +128,7 @@ import {
   getAvailableThemes,
   getThemeSummaries,
   resolveTheme
-} from "../chunk-4AKUQPEE.js";
+} from "../chunk-KKNUBQ6Y.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -131,13 +139,13 @@ import {
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
 } from "../chunk-DLXZMS5K.js";
-import "../chunk-OH43RPTP.js";
-import "../chunk-OKJOQXK4.js";
+import "../chunk-BEQODJWV.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 +154,7 @@ export {
   PATH_SHAPE_KINDS,
   SHAPE_NAMES,
   TEMPLATE_ALIASES,
+  TEMPLATE_INPUT_DESCRIPTORS,
   TEMPLATE_METADATA,
   VIEWPORT_PRESETS,
   adjustY,
@@ -153,6 +162,7 @@ export {
   buildRegistry,
   clipEndpoints,
   clipPoint,
+  coerceTemplateParams,
   comparisonBar,
   computeDiagramLayout,
   computeDrawingLayout,
@@ -218,10 +228,12 @@ export {
   layoutBlock,
   leftFeature,
   lineStyleDasharray,
+  lintTemplateParams,
   listBlock,
   mapBlock,
   markdownToDoc,
   markerPath,
+  nearestSnapPoint,
   normalizeShapeKind,
   parseDataFence,
   parseYamlSubset,
@@ -230,6 +242,7 @@ export {
   quoteBlock,
   readCustomTemplatesFromFrontmatter,
   readCustomThemesFromFrontmatter,
+  replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
   resolvePersistentLayers,
@@ -243,6 +256,8 @@ export {
   sectionHeader,
   shapePath,
   shouldUseShadow,
+  snapEndpoints,
+  snapPoints,
   statHighlight,
   templateRegistry,
   themeWantsAmbientMotion,

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.2",
   "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';
@@ -80,6 +85,7 @@ describe('coverBlock with hero image', () => {
   it('does not produce theme background layers', () => {
     const layers = coverBlock(input, landscapeContext);
     expect(findLayer(layers, 'cover-bg')).toBeUndefined();
+    expect(findLayer(layers, 'cover-bg-tint')).toBeUndefined();
     expect(findLayer(layers, 'cover-accent')).toBeUndefined();
   });
 
@@ -105,12 +111,16 @@ describe('coverBlock without hero image', () => {
     subtitle: 'Subtitle text',
   };
 
-  it('produces theme background instead of hero', () => {
+  it('produces theme background and soft tint instead of hero', () => {
     const layers = coverBlock(input, landscapeContext);
     const bg = findShape(layers, 'cover-bg');
+    const tint = findShape(layers, 'cover-bg-tint');
     expect(bg).toBeDefined();
     expect(bg!.type).toBe('shape');
-    expect(bg!.content.fill).toContain('radial-gradient');
+    expect(bg!.content.fill).toBe(DEFAULT_THEME.colors.background);
+    expect(tint).toBeDefined();
+    expect(tint!.content.fill).toContain('radial-gradient');
+    expect(tint!.content.fill).toContain('rgba(37, 99, 235, 0.16)');
   });
 
   it('produces decorative accent line', () => {
@@ -139,6 +149,31 @@ describe('coverBlock without hero image', () => {
     const subtitle = findLayer(layers, 'cover-subtitle');
     expect(subtitle!.position.y).not.toBe('82%');
   });
+
+  it('uses high-contrast Standard Light cover text', () => {
+    const layers = coverBlock(input, landscapeContext);
+    const title = findText(layers, 'cover-title');
+    const subtitle = findText(layers, 'cover-subtitle');
+    expect(title!.content.style.shadow).toBe(false);
+    expect(subtitle!.content.style.fontWeight).toBe('bold');
+    expect(subtitle!.content.style.color).toBe('rgba(15, 23, 42, 0.78)');
+  });
+
+  it('keeps non-Standard themes on the existing dramatic cover background', () => {
+    const nonStandardContext = createTemplateContext(
+      { ...DEFAULT_THEME, id: 'custom-light' },
+      0,
+      1,
+      VIEWPORT_PRESETS.landscape,
+    );
+    const layers = coverBlock(input, nonStandardContext);
+    const bg = findShape(layers, 'cover-bg');
+    const title = findText(layers, 'cover-title');
+    expect(findShape(layers, 'cover-bg-tint')).toBeUndefined();
+    expect(bg!.content.fill).toContain('radial-gradient');
+    expect(bg!.content.fill).toContain(`${DEFAULT_THEME.colors.primary} 0%`);
+    expect(title!.content.style.shadow).toBe(true);
+  });
 });
 
 // ── coverBlock title-only (no subtitle) ─────────────────────────────
@@ -179,6 +214,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', () => {
@@ -228,6 +303,7 @@ describe('expandCoverBlock', () => {
     const config: StartBlockConfig = { title: 'No Hero' };
     const layers = expandCoverBlock(config, landscapeContext);
     expect(layers.some((l) => l.id === 'cover-bg')).toBe(true);
+    expect(layers.some((l) => l.id === 'cover-bg-tint')).toBe(true);
     expect(layers.some((l) => l.id === 'cover-title')).toBe(true);
     expect(layers.some((l) => l.id === 'cover-hero')).toBe(false);
   });