@bendyline/squisq 1.5.2 → 2.0.1

package/README.md

@@ -18,7 +18,7 @@ npm install @bendyline/squisq
 | Module       | Description                                                                      |
 | ------------ | -------------------------------------------------------------------------------- |
 | **schemas**  | Type definitions — `Doc`, `BlockTemplate`, `Viewport`, `Theme`, `LayoutStrategy` |
-| **doc**      | Template registry, 23 block templates, animation/theme utilities                 |
+| **doc**      | Template registry, 25 block templates, animation/theme utilities                 |
 | **markdown** | Markdown parsing, stringifying, AST types (`MarkdownDocument`), tree utilities   |
 | **spatial**  | Haversine distance, Geohash encode/decode                                        |
 | **storage**  | `StorageAdapter` interface, Memory + LocalStorage + LocalForage adapters         |
@@ -42,16 +42,16 @@ Import only what you need:
 
 ```ts
 import type { Doc, BlockTemplate, Theme } from '@bendyline/squisq/schemas';
-import { getLayers, expandDocBlocks } from '@bendyline/squisq/doc';
+import { materializeBlockLayers, expandDocBlocks } from '@bendyline/squisq/doc';
 import { parseMarkdown, stringifyMarkdown } from '@bendyline/squisq/markdown';
-import { haversineDistance, geohashEncode } from '@bendyline/squisq/spatial';
+import { encodeGeohash, haversineDistance } from '@bendyline/squisq/spatial';
 import { LocalStorageAdapter } from '@bendyline/squisq/storage';
 ```
 
 Or import everything from the root:
 
 ```ts
-import { parseMarkdown, haversineDistance, getLayers } from '@bendyline/squisq';
+import { parseMarkdown, haversineDistance, materializeBlockLayers } from '@bendyline/squisq';
 ```
 
 ## Quick Examples
@@ -67,22 +67,75 @@ console.log(doc.children); // AST nodes
 const md = stringifyMarkdown(doc);
 ```
 
+### Author an ASCII Timeline
+
+Timeline fences are source-of-truth markdown. Unicode marker rails are
+auto-detected; the explicit `timeline` language also accepts sparse/ASCII
+forms. Repeat rails for multiple tracks and use event ids in `branch:` lines
+for forks or cross-track links. Add longer callout text after `::`; optional
+`side=above|below`, `descriptionSide=above|below`, and `callout=false` metadata
+control placement or suppress labels on dense cadence points.
+
+````markdown
+## Runtime timing
+
+```timeline
+Kernel: ● T28 :: Δ28 {#t28 side=above descriptionSide=below} ─────● T29 {#t29} ─────● T30 {#t30} ───►
+Client: ──────────────────● Frame A {#frame-a} ───● Frame B {#frame-b} ───►
+branch: t29 -> frame-a : interpolate
+```
+````
+
+`markdownToDoc()` derives globally aligned event positions while preserving
+the original fence byte-for-byte for markdown round-trips.
+
 ### Spatial Utilities
 
 ```ts
-import { haversineDistance, geohashEncode } from '@bendyline/squisq/spatial';
+import { encodeGeohash, haversineDistance } from '@bendyline/squisq/spatial';
 
-const meters = haversineDistance(47.6, -122.3, 37.7, -122.4);
-const hash = geohashEncode(47.6, -122.3, 7);
+const distanceKm = haversineDistance({ lat: 47.6, lng: -122.3 }, { lat: 37.7, lng: -122.4 });
+const hash = encodeGeohash(47.6, -122.3, 7);
 ```
 
-### Theme System
+### Materialize a Block
 
 ```ts
-import { resolveTheme, getAvailableThemes } from '@bendyline/squisq/schemas';
+import { materializeBlockLayers } from '@bendyline/squisq/doc';
+
+const result = materializeBlockLayers(block, {
+  theme,
+  viewport,
+  customTemplates: doc.customTemplates,
+});
 
-const themes = getAvailableThemes(); // 8 built-in themes
+render(result.layers);
+if (result.diagnostic) report(result.diagnostic);
+```
+
+The canonical materializer handles authored layers, built-in and document-scoped
+templates, theme motion, and persistent layers. Failed templates produce a
+visible fallback plus a structured diagnostic by default; pass
+`failureMode: 'empty'` when a host deliberately wants no fallback UI.
+
+### Theme System
+
+```ts
+import {
+  compileTheme,
+  createThemeRegistry,
+  getAvailableThemes,
+  resolveTheme,
+} from '@bendyline/squisq/schemas';
+
+const themes = getAvailableThemes(); // 11 built-in themes
 const theme = resolveTheme('cinematic');
+
+// Host-level custom themes live in an explicit caller-owned registry.
+const registry = createThemeRegistry([
+  compileTheme({ id: 'brand', name: 'Brand', seedColors: { primary: '#6633cc' } }),
+]);
+const brand = resolveTheme('brand', registry);
 ```
 
 ## Related Packages

package/dist/{Doc-BBVGq1_9.d.ts → Doc-ylqWKDc_.d.ts}

@@ -1,10 +1,11 @@
-import { Z as Transition, $ as TransitionType, M as MarkdownBlockNode, q as MarkdownHeading } from './types-DlAZ7MW4.js';
+import { Z as Transition, $ as TransitionType, M as MarkdownBlockNode, q as MarkdownHeading } from './types-BwMPl2CB.js';
 
 /**
  * Media-clip timing model.
  *
- * An additive layer on top of the legacy sequential `Doc.audio.segments[]`
- * narration track. A {@link MediaClip} is a piece of audio or video whose
+ * An additive layer on top of the simple sequential `Doc.audio.segments[]`
+ * narration track, which remains first-class. A {@link MediaClip} is a piece
+ * of audio or video whose
  * timing is expressed *relative to its parent block* (or the whole document),
  * with an optional `startAt` offset and an optional `spillover` past the
  * block's end. {@link resolveMediaSchedule} flattens these into absolute,
@@ -51,6 +52,19 @@ interface MediaClip {
      * `startAt`) back to the exact line. Absent for programmatically built clips.
      */
     sourceLine?: number;
+    /**
+     * Round-trip home of the authoring annotation: the block whose contents
+     * held the paragraph, its position in that block's ORIGINAL contents
+     * array (before extraction), and the paragraph's exact source text.
+     * `docToMarkdown` re-inserts the annotation from this — `raw` verbatim
+     * when present, a re-serialized annotation otherwise. Absent for
+     * programmatically built clips (those emit at the document top).
+     */
+    origin?: {
+        blockId: string;
+        index: number;
+        raw?: string;
+    };
 }
 /**
  * A {@link MediaClip} resolved to absolute document-timeline coordinates.
@@ -95,7 +109,7 @@ declare function getDocPlaybackDuration(doc: Doc): number;
  * - landscape (16:9) - Default, standard video/presentation format
  * - portrait (9:16) - Vertical video, mobile stories
  * - square (1:1) - Social media posts
- * - standard (4:3) - Legacy presentation format
+ * - standard (4:3) - Classic presentation format
  */
 /**
  * Viewport configuration for doc rendering.
@@ -130,7 +144,7 @@ declare const VIEWPORT_PRESETS: {
         readonly height: 1080;
         readonly name: "1:1 Square";
     };
-    /** 4:3 standard (legacy) */
+    /** 4:3 standard */
     readonly standard: {
         readonly width: 1440;
         readonly height: 1080;
@@ -331,6 +345,19 @@ interface BaseTemplateBlock {
      * Used with sourceStartTime to precisely position the block.
      */
     sourceDuration?: number;
+    /**
+     * Transform provenance: the id of the source Block this template block
+     * was derived from. Lets narration timing (and any per-source styling)
+     * be remapped onto transformed/summarized docs.
+     */
+    sourceBlockId?: string;
+    /** All source block ids when the block summarizes more than one. */
+    sourceBlockIds?: string[];
+    /**
+     * Char offset of the extraction inside the source block's plain text.
+     * Provenance only — NOT a time (see sourceStartTime for seconds).
+     */
+    sourceCharOffset?: number;
     /**
      * Per-block override for the theme's photographic image grade
      * (`theme.style.imageTreatment`). `'none'` opts this block's imagery out;
@@ -563,6 +590,86 @@ interface ListBlockInput extends BaseTemplateBlock {
     /** Optional accent image */
     accentImage?: AccentImage;
 }
+/**
+ * Tree block — renders a hierarchical filesystem-style treeview from an
+ * ASCII tree fence (file trees, dependency trees, outlines). The nested
+ * `items` arrive via `templateData`, derived from the fence by the pipeline
+ * (peer to how `diagram` receives `nodes`/`edges`).
+ */
+interface TreeBlockInput extends BaseTemplateBlock {
+    template: 'tree';
+    /** Nested tree items (usually via `templateData.items`). */
+    items?: TreeTemplateItem[];
+    /** Optional title above the tree. */
+    title?: string;
+    /** Color scheme for folder rows / icons. */
+    colorScheme?: ColorScheme;
+}
+/** One node supplied via `templateData.items` (mirrors `TreeLayerItem`). */
+interface TreeTemplateItem {
+    id: string;
+    label: string;
+    isDir?: boolean;
+    comment?: string;
+    children: TreeTemplateItem[];
+}
+/**
+ * One point on a timeline track. Event positions are normalized across the
+ * whole timeline (0 = left edge, 1 = right edge) so events on separate tracks
+ * remain horizontally comparable.
+ */
+interface TimelineTemplateEvent {
+    /** Stable id used by cross-track branch links. */
+    id: string;
+    /** Short label displayed next to the event dot. */
+    label: string;
+    /** Optional longer callout text. */
+    description?: string;
+    /** Normalized horizontal position; renderers clamp values to 0..1. */
+    position: number;
+    /** Preferred callout placement. Defaults to alternating above/below. */
+    side?: 'above' | 'below';
+    /** Description placement when it should sit opposite the event label. */
+    descriptionSide?: 'above' | 'below';
+    /** False renders the point only (useful for dense cadence tracks). */
+    callout?: boolean;
+    /** Dot treatment. Defaults to `filled`. */
+    marker?: 'filled' | 'hollow' | 'diamond';
+}
+/** A horizontal timeline lane with zero or more positioned events. */
+interface TimelineTemplateTrack {
+    id: string;
+    /** Optional label displayed to the left of the track. */
+    label?: string;
+    /** Optional label displayed after the track's terminal arrow. */
+    endLabel?: string;
+    events: TimelineTemplateEvent[];
+}
+/**
+ * A branch or relationship between two events. Source and target resolve
+ * against event ids globally, so links may cross tracks.
+ */
+interface TimelineTemplateLink {
+    source: string;
+    target: string;
+    /** Optional text displayed near the branch path. */
+    label?: string;
+}
+/**
+ * Timeline block - renders one or more horizontal tracks with event dots,
+ * text callouts, and optional branches between events.
+ */
+interface TimelineBlockInput extends BaseTemplateBlock {
+    template: 'timeline';
+    /** Tracks and their events (usually supplied through `templateData`). */
+    tracks?: TimelineTemplateTrack[];
+    /** Optional branch/cross-track links between event ids. */
+    links?: TimelineTemplateLink[];
+    /** Optional title above the timeline. */
+    title?: string;
+    /** Color scheme for tracks, markers, and branch links. */
+    colorScheme?: ColorScheme;
+}
 /**
  * Photo grid - 2-4 images in a tiled layout.
  * Used when multiple images are available for visual variety.
@@ -687,13 +794,54 @@ interface VideoPullQuoteInput extends BaseTemplateBlock {
     };
 }
 /**
- * Diagram block - renders child headings as a node-and-edge diagram.
+ * One diagram node supplied via `templateData.nodes` (canvas units, the
+ * same coordinate space as `Block.x`/`Block.y`). This is the data-driven
+ * alternative to child headings — used when a diagram is derived from an
+ * ASCII-art fence.
+ */
+interface DiagramTemplateNode {
+    id: string;
+    /** Display label; may contain `\n` for multi-line labels. */
+    label: string;
+    x: number;
+    y: number;
+    /** Per-node width override in canvas units (defaults to the standard card width). */
+    w?: number;
+    /** Per-node height override in canvas units. */
+    h?: number;
+    /** Id of the node visually containing this one; containers draw behind their children. */
+    container?: string;
+}
+/** A position along one side of a diagram node, normalized from 0 to 1. */
+interface DiagramEdgeAnchor {
+    side: 'top' | 'right' | 'bottom' | 'left';
+    /** Left→right on horizontal sides; top→bottom on vertical sides. */
+    offset: number;
+}
+/** An edge for `DiagramTemplateNode` lists. `directed` defaults to true. */
+interface DiagramTemplateEdge {
+    source: string;
+    target: string;
+    /** Edge label rendered at the midpoint. */
+    label?: string;
+    /** False suppresses the end arrowhead (a plain connecting line). */
+    directed?: boolean;
+    /** Optional authored attachment on the source node. */
+    sourceAnchor?: DiagramEdgeAnchor;
+    /** Optional authored attachment on the target node. */
+    targetAnchor?: DiagramEdgeAnchor;
+    /** Per-edge path routing; ASCII-derived edges use orthogonal routing. */
+    routing?: 'straight' | 'orthogonal' | 'curved';
+}
+/**
+ * Diagram block - renders a node-and-edge diagram.
  *
- * Unlike other templates, the diagram template reads its content from
- * the parent block's `children` (passed via `context.children`) — each
- * child heading becomes a node, positioned by its `x`/`y` and connected
- * by its `connectsTo`. Per-diagram options on this input control overall
- * appearance; per-node data lives on the child blocks themselves.
+ * Two data sources, in precedence order:
+ * 1. Child headings (`context.children`) — each child is a node positioned
+ *    by its `x`/`y` and connected by its `connectsTo` (legacy authored form).
+ * 2. `nodes`/`edges` on this input (usually via `templateData`, derived
+ *    from an ASCII-art diagram fence in the block body).
+ * Per-diagram options on this input control overall appearance.
  */
 interface DiagramBlockInput extends BaseTemplateBlock {
     template: 'diagram';
@@ -711,6 +859,10 @@ interface DiagramBlockInput extends BaseTemplateBlock {
     endStyle?: MarkerStyle;
     /** Edge line style (default: 'solid'). */
     lineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Data-driven node list; used only when the block has no children. */
+    nodes?: DiagramTemplateNode[];
+    /** Edges for `nodes`. */
+    edges?: DiagramTemplateEdge[];
 }
 /**
  * Free-form 2D canvas block (`layout`). Like `drawing`/`diagram`, the
@@ -775,7 +927,7 @@ interface DataTableInput extends BaseTemplateBlock {
 /**
  * Union of all template block types.
  */
-type TemplateBlock = TitleBlockInput | SectionHeaderInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | LeftFeatureInput | RightFeatureInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput | DiagramBlockInput | DrawingBlockInput | RawLayersInput;
+type TemplateBlock = TitleBlockInput | SectionHeaderInput | StatHighlightInput | QuoteBlockInput | FactCardInput | TwoColumnInput | DateEventInput | ImageWithCaptionInput | LeftFeatureInput | RightFeatureInput | MapBlockInput | FullBleedQuoteInput | ListBlockInput | PhotoGridInput | DefinitionCardInput | ComparisonBarInput | PullQuoteInput | VideoWithCaptionInput | VideoPullQuoteInput | DataTableInput | DiagramBlockInput | TreeBlockInput | TimelineBlockInput | DrawingBlockInput | RawLayersInput;
 /**
  * A block can be either a raw Block or a TemplateBlock.
  */
@@ -804,7 +956,7 @@ interface TemplateContext {
     /** Layout hints for this orientation */
     layout: LayoutHints;
     /**
-     * The block's direct children (set by `getLayers` when the block has
+     * The block's direct children (set by `materializeBlockLayers` when the block has
      * `children`). Most templates ignore this; aggregate templates like
      * `diagram` consume it to render each child as part of their output.
      */
@@ -990,6 +1142,9 @@ interface ProgressIndicatorConfig {
     color?: string;
 }
 
+/** Current Theme schema version. Bump on breaking changes; loader migrates. */
+declare const THEME_SCHEMA_VERSION: "1";
+
 /**
  * Theme System
  *
@@ -1012,8 +1167,6 @@ interface ProgressIndicatorConfig {
  *   `seedColors`; both produce a complete `Theme`.
  */
 
-/** Current Theme schema version. Bump on breaking changes; loader migrates. */
-declare const THEME_SCHEMA_VERSION: "1";
 type ThemeSchemaVersion = typeof THEME_SCHEMA_VERSION;
 /**
  * Frontmatter key under which a document inlines its custom Theme
@@ -1228,19 +1381,19 @@ declare const DARK_SURFACE: SurfaceScheme;
  * style, renderStyle, colorSchemes) untouched.
  */
 declare function applySurface(theme: Theme, surface: SurfaceScheme): Theme;
+/** A caller-owned custom-theme registry for SSR tenants, tests, and embedders. */
+interface ThemeRegistry {
+    register(theme: Theme): void;
+    unregister(id: string): boolean;
+    get(id: string): Theme | undefined;
+    list(): Theme[];
+}
 /**
- * Register a Theme so it can be looked up by id via `resolveTheme(id)`.
- * Lets `Doc.themeId` round-trip through Doc serialization for custom themes.
- *
- * Registered themes take precedence over built-ins with the same id.
- */
-declare function registerTheme(theme: Theme): void;
-/** Remove a previously registered theme. */
-declare function unregisterTheme(id: string): void;
-/** Snapshot of all currently registered (non-built-in) themes. */
-declare function getRegisteredThemes(): Theme[];
-/** @internal — used by themeLibrary's `resolveTheme` to check the registry first. */
-declare function lookupRegisteredTheme(id: string | undefined): Theme | undefined;
+ * Create a registry whose state is owned by the caller rather than the
+ * process. Registered values are validated and stored as deeply frozen
+ * snapshots, so later caller mutation cannot alter resolution behavior.
+ */
+declare function createThemeRegistry(initialThemes?: readonly Theme[]): ThemeRegistry;
 
 /**
  * Custom Templates Schema
@@ -1532,11 +1685,22 @@ interface Block {
     duration: number;
     /** Which audio segment this block belongs to (0-indexed) */
     audioSegment: number;
+    /**
+     * Transform provenance: the source block id this block was derived
+     * from (see `BaseTemplateBlock.sourceBlockId`). Present on blocks a
+     * transform produced; lets a persisted transformed Doc keep its typed
+     * link back to the source content.
+     */
+    sourceBlockId?: string;
+    /** All source block ids when this block summarizes several. */
+    sourceBlockIds?: string[];
+    /** Char offset of the extraction inside the source block's plain text. */
+    sourceCharOffset?: number;
     /**
      * Pre-computed visual layers, rendered back-to-front.
      *
      * Optional — template-derived blocks typically omit this and compute
-     * layers on demand via `getLayers()` from `@bendyline/squisq/doc`.
+     * layers on demand via `materializeBlockLayers()` from `@bendyline/squisq/doc`.
      * Raw blocks (e.g., hand-crafted by AI) may provide layers directly.
      */
     layers?: Layer[];
@@ -1655,7 +1819,7 @@ interface Block {
  * A visual element within a block.
  * Layers are composited back-to-front (first layer is background).
  */
-type Layer = ImageLayer | TextLayer | ShapeLayer | PathLayer | MapLayer | VideoLayer | TableLayer;
+type Layer = ImageLayer | TextLayer | ShapeLayer | PathLayer | MapLayer | VideoLayer | TableLayer | TreeLayer;
 interface BaseLayer {
     /** Unique identifier for this layer */
     id: string;
@@ -1847,14 +2011,9 @@ interface PathLayer extends BaseLayer {
         borderStyle?: BorderStyle;
         /** Optional stroke dash pattern (SVG `stroke-dasharray` syntax). */
         dasharray?: string;
-        /**
-         * Legacy arrowhead flag. Prefer `startMarker`/`endMarker`. When those are
-         * unset, `'end'`/`'start'`/`'both'` render a filled-triangle arrowhead.
-         */
-        arrow?: 'none' | 'end' | 'start' | 'both';
-        /** Marker at the path start (overrides `arrow`). Default: derived from `arrow`. */
+        /** Marker at the path start. */
         startMarker?: MarkerStyle;
-        /** Marker at the path end (overrides `arrow`). Default: derived from `arrow`. */
+        /** Marker at the path end. */
         endMarker?: MarkerStyle;
     };
 }
@@ -1965,6 +2124,58 @@ interface TableLayerStyle {
     /** Corner radius for the table container */
     borderRadius?: number;
 }
+/**
+ * One node in a `TreeLayer` — a JSON-serializable hierarchy item (mirrors
+ * the treeview codec's `TreeItem`). Rendered as an indented filesystem-style
+ * row with a folder/file icon and connector rails.
+ */
+interface TreeLayerItem {
+    id: string;
+    label: string;
+    /** True renders a folder (container) icon; else a file (leaf) icon. */
+    isDir?: boolean;
+    /** Trailing comment shown muted after the label. */
+    comment?: string;
+    children: TreeLayerItem[];
+}
+/**
+ * A hierarchical treeview rendered as interactive HTML inside a
+ * `<foreignObject>` (like `TableLayer`): folder/file icons, connector
+ * rails, and collapse chevrons. Interactive (collapse/expand) in the live
+ * React player; captured fully-expanded and static in frame/PDF export.
+ */
+interface TreeLayer extends BaseLayer {
+    type: 'tree';
+    content: {
+        items: TreeLayerItem[];
+        style: TreeLayerStyle;
+    };
+}
+/** Styling options for a TreeLayer. */
+interface TreeLayerStyle {
+    /** Leaf (file) row text color. */
+    rowColor: string;
+    /** Container (folder) row text color. */
+    dirColor: string;
+    /** Connector rail / branch color. */
+    connectorColor: string;
+    /** Icon color. */
+    iconColor: string;
+    /** Muted comment color. */
+    commentColor: string;
+    /** Font size in pixels. */
+    fontSize: number;
+    /** Row label font family. */
+    fontFamily?: string;
+    /** Monospace font for the connector rails. */
+    monoFontFamily?: string;
+    /** Indent step per depth level, in pixels. */
+    indentPx: number;
+    /** FontAwesome icon token for containers (default `folder`). */
+    folderIcon?: string;
+    /** FontAwesome icon token for leaves (default `file`). */
+    fileIcon?: string;
+}
 /**
  * Available map tile styles from free/open-source providers.
  */
@@ -2174,4 +2385,4 @@ declare function getBlockAtTime(blocks: Block[], time: number): Block | null;
  */
 declare function getCaptionAtTime(captions: CaptionTrack | undefined, time: number): CaptionPhrase | null;
 
-export { type MapTileStyle as $, type AccentImage as A, type Block as B, type CaptionPhrase as C, DARK_SURFACE as D, type DocDiagnostic as E, type DrawingBlockInput as F, FRONTMATTER_CUSTOM_TEMPLATES_KEY as G, FRONTMATTER_CUSTOM_THEMES_KEY as H, type FactCardInput as I, type FontFamily as J, type FontFamilyKind as K, type FullBleedQuoteInput as L, type GradientBackgroundConfig as M, type ImageBackgroundConfig as N, type ImageLayer as O, type ImageTreatment as P, type ImageWithCaptionInput as Q, LIGHT_SURFACE as R, type Layer as S, type LayerRepeat as T, type LayoutHints as U, type LeftFeatureInput as V, type LinearGradient as W, type ListBlockInput as X, type MapBlockInput as Y, type MapLayer as Z, type MapMarker as _, type AccentPosition as a, getRegisteredThemes as a$, type MarkerStyle as a0, type MediaClip as a1, type PathLayer as a2, type PatternBackgroundConfig as a3, type PersistentLayer as a4, type PersistentLayerConfig as a5, type PersistentLayerTemplate as a6, type PersistentLayerTemplateConfig as a7, type PersistentLayerTemplateType as a8, type PhotoGridInput as a9, type ThemeColorPalette as aA, type ThemeColorScheme as aB, type ThemeSchemaVersion as aC, type ThemeSeedColors as aD, type ThemeStyle as aE, type ThemeTypography as aF, type TitleBlockInput as aG, type TitleCaptionConfig as aH, type TwoColumnInput as aI, VIEWPORT_PRESETS as aJ, type VideoLayer as aK, type VideoPullQuoteInput as aL, type VideoWithCaptionInput as aM, type ViewportConfig as aN, type ViewportOrientation as aO, type ViewportPreset as aP, type VignetteConfig as aQ, applySurface as aR, calculateDuration as aS, calculateFontScale as aT, createTemplateContext as aU, createTheme as aV, getAspectRatioString as aW, getBlockAtTime as aX, getCaptionAtTime as aY, getDocPlaybackDuration as aZ, getLayoutHints as a_, type Position as aa, type ProgressIndicatorConfig as ab, type PullQuoteInput as ac, type QuoteBlockInput as ad, type RawLayersInput as ae, type RenderStyle as af, type RightFeatureInput as ag, type ScheduledClip as ah, type SectionHeaderInput as ai, type ShapeFilter as aj, type ShapeLayer as ak, type ShapePattern as al, type SolidBackgroundConfig as am, type StartBlockConfig as an, type StatHighlightInput as ao, type SurfaceScheme as ap, THEME_SCHEMA_VERSION as aq, type TableLayer as ar, type TableLayerStyle as as, type TemplateBlock as at, type TemplateContext as au, type TemplateFunction as av, type TemplateRegistry as aw, type TextLayer as ax, type TextStyle as ay, type Theme as az, type AmbientGradientConfig as b, getSafeTextBounds as b0, getSegmentAtTime as b1, getTwoColumnPositions as b2, getViewport as b3, getViewportOrientation as b4, isPersistentLayerTemplate as b5, isTemplateBlock as b6, scaledFontSize$1 as b7, lookupRegisteredTheme as b8, registerTheme as b9, resolveMediaSchedule as ba, scaledFontSize as bb, unregisterTheme as bc, type Animation as c, type AnimationType as d, type AudioBookmark as e, type AudioSegment as f, type AudioTimingData as g, type AudioTrack as h, type BlockConnection as i, type BorderStyle as j, type CaptionTrack as k, type CaptionWord as l, type ColorScheme as m, type ComparisonBarInput as n, type CornerBrandingConfig as o, type CustomTemplateDefinition as p, type CustomTemplateLayer as q, DEFAULT_DOC_FONT as r, DEFAULT_TITLE_FONT as s, type DataTableInput as t, type DateEventInput as u, type DeepPartial as v, type DefinitionCardInput as w, type DiagramBlockInput as x, type Doc as y, type DocBlock as z };
+export { type MapBlockInput as $, type AccentImage as A, type Block as B, type CaptionPhrase as C, DARK_SURFACE as D, type DiagramTemplateNode as E, type Doc as F, type DocBlock as G, type DocDiagnostic as H, type DrawingBlockInput as I, FRONTMATTER_CUSTOM_TEMPLATES_KEY as J, FRONTMATTER_CUSTOM_THEMES_KEY as K, type FactCardInput as L, type FontFamily as M, type FontFamilyKind as N, type FullBleedQuoteInput as O, type GradientBackgroundConfig as P, type ImageBackgroundConfig as Q, type ImageLayer as R, type ImageTreatment as S, type ImageWithCaptionInput as T, LIGHT_SURFACE as U, type Layer as V, type LayerRepeat as W, type LayoutHints as X, type LeftFeatureInput as Y, type LinearGradient as Z, type ListBlockInput as _, type AccentPosition as a, type ViewportOrientation as a$, type MapLayer as a0, type MapMarker as a1, type MapTileStyle as a2, type MarkerStyle as a3, type MediaClip as a4, type PathLayer as a5, type PatternBackgroundConfig as a6, type PersistentLayer as a7, type PersistentLayerConfig as a8, type PersistentLayerTemplate as a9, type TextLayer as aA, type TextStyle as aB, type Theme as aC, type ThemeColorPalette as aD, type ThemeColorScheme as aE, type ThemeRegistry as aF, type ThemeSchemaVersion as aG, type ThemeSeedColors as aH, type ThemeStyle as aI, type ThemeTypography as aJ, type TimelineBlockInput as aK, type TimelineTemplateEvent as aL, type TimelineTemplateLink as aM, type TimelineTemplateTrack as aN, type TitleBlockInput as aO, type TitleCaptionConfig as aP, type TreeBlockInput as aQ, type TreeLayer as aR, type TreeLayerItem as aS, type TreeLayerStyle as aT, type TreeTemplateItem as aU, type TwoColumnInput as aV, VIEWPORT_PRESETS as aW, type VideoLayer as aX, type VideoPullQuoteInput as aY, type VideoWithCaptionInput as aZ, type ViewportConfig as a_, type PersistentLayerTemplateConfig as aa, type PersistentLayerTemplateType as ab, type PhotoGridInput as ac, type Position as ad, type ProgressIndicatorConfig as ae, type PullQuoteInput as af, type QuoteBlockInput as ag, type RawLayersInput as ah, type RenderStyle as ai, type RightFeatureInput as aj, type ScheduledClip as ak, type SectionHeaderInput as al, type ShapeFilter as am, type ShapeLayer as an, type ShapePattern as ao, type SolidBackgroundConfig as ap, type StartBlockConfig as aq, type StatHighlightInput as ar, type SurfaceScheme as as, THEME_SCHEMA_VERSION as at, type TableLayer as au, type TableLayerStyle as av, type TemplateBlock as aw, type TemplateContext as ax, type TemplateFunction as ay, type TemplateRegistry as az, type AmbientGradientConfig as b, type ViewportPreset as b0, type VignetteConfig as b1, applySurface as b2, calculateDuration as b3, calculateFontScale as b4, createTemplateContext as b5, createTheme as b6, createThemeRegistry as b7, getAspectRatioString as b8, getBlockAtTime as b9, getCaptionAtTime as ba, getDocPlaybackDuration as bb, getLayoutHints as bc, getSafeTextBounds as bd, getSegmentAtTime as be, getTwoColumnPositions as bf, getViewport as bg, getViewportOrientation as bh, isPersistentLayerTemplate as bi, isTemplateBlock as bj, scaledFontSize$1 as bk, resolveMediaSchedule as bl, scaledFontSize as bm, type Animation as c, type AnimationType as d, type AudioBookmark as e, type AudioSegment as f, type AudioTimingData as g, type AudioTrack as h, type BlockConnection as i, type BorderStyle as j, type CaptionTrack as k, type CaptionWord as l, type ColorScheme as m, type ComparisonBarInput as n, type CornerBrandingConfig as o, type CustomTemplateDefinition as p, type CustomTemplateLayer as q, DEFAULT_DOC_FONT as r, DEFAULT_TITLE_FONT as s, type DataTableInput as t, type DateEventInput as u, type DeepPartial as v, type DefinitionCardInput as w, type DiagramBlockInput as x, type DiagramEdgeAnchor as y, type DiagramTemplateEdge as z };

package/dist/{ImageEditDoc-FuyGtt6o.d.ts → ImageEditDoc-D828IXJ1.d.ts}

@@ -1,4 +1,4 @@
-import { O as ImageLayer, ax as TextLayer, ak as ShapeLayer, a2 as PathLayer } from './Doc-BBVGq1_9.js';
+import { R as ImageLayer, aA as TextLayer, an as ShapeLayer, a5 as PathLayer } from './Doc-ylqWKDc_.js';
 
 /**
  * ImageEditDoc — JSON document describing a layered, editable image.

package/dist/annotationCoercion-Dr_DY9Hx.d.ts

@@ -0,0 +1,86 @@
+import { a5 as BlockConnection, $ as TransitionType, _ as TransitionDirection } from './types-BwMPl2CB.js';
+
+/**
+ * Heading-attribute value coercion.
+ *
+ * The Pandoc-style heading attribute block `{#id .class key=value}` parses
+ * to a flat `Record<string, string>` of `key → raw value`. This module
+ * coerces a known subset of keys to typed values (numbers, time-in-seconds,
+ * `BlockConnection[]`) so downstream consumers don't have to re-parse them.
+ *
+ * Unknown keys are returned in `metadata` as raw strings. Malformed known-key
+ * values are dropped from the typed result and reported via `warnings` (the
+ * raw string is preserved in `params` upstream for lossless round-tripping —
+ * coercion failures do not corrupt the source).
+ */
+
+/**
+ * Registry of known block-meta keys and their coercion strategies.
+ *
+ * Adding a new typed key: add an entry here, add the typed field to
+ * `HeadingAttributes.blockMeta` in `types.ts`, and apply the coerced value
+ * in `markdownToDoc.ts`.
+ */
+declare const KNOWN_BLOCK_META_KEYS: {
+    readonly x: "number";
+    readonly y: "number";
+    readonly startTime: "time";
+    readonly duration: "time";
+    readonly connectsTo: "connectionList";
+    readonly transition: "transition";
+    readonly transitionDuration: "time";
+    readonly transitionDirection: "transitionDirection";
+};
+type KnownBlockMetaKey = keyof typeof KNOWN_BLOCK_META_KEYS;
+/**
+ * Editor-facing description of a known block-meta key: what it does, and
+ * either its closed set of valid values or a free-form format hint. This is
+ * the single source the markdown editor's `{[name key=value]}` attribute
+ * autocomplete reads from, so the suggestion list stays in lockstep with
+ * `KNOWN_BLOCK_META_KEYS` and the transition vocabulary rather than drifting
+ * in a hand-maintained copy. `values`/`valueHint` are mutually exclusive: a
+ * key has a closed enum (`values`) or a format hint (`valueHint`), not both.
+ */
+interface BlockMetaKeyDescriptor {
+    key: KnownBlockMetaKey;
+    /** One-line description, shown as the completion item's detail. */
+    description: string;
+    /** 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;
+}
+/**
+ * Ordered descriptors for every key in `KNOWN_BLOCK_META_KEYS`. Order is the
+ * suggestion display order: the transition family first (the most common
+ * authoring case), then timeline timing, then diagram geometry/links.
+ */
+declare const BLOCK_META_KEY_DESCRIPTORS: readonly BlockMetaKeyDescriptor[];
+/**
+ * The shape of the typed values produced by coercion. Mirrors
+ * `HeadingAttributes.blockMeta` in `types.ts`.
+ */
+interface CoercedBlockMeta {
+    x?: number;
+    y?: number;
+    startTime?: number;
+    duration?: number;
+    connectsTo?: BlockConnection[];
+    transition?: {
+        type: TransitionType;
+        duration?: number;
+        direction?: TransitionDirection;
+    };
+}
+/**
+ * Parse a time value to seconds. Accepts:
+ * - bare number: `5` → 5, `5.5` → 5.5
+ * - `mm:ss`: `01:30` → 90
+ * - `mm:ss.ms`: `01:30.500` → 90.5
+ * - `1500ms` → 1.5
+ *
+ * Returns null on malformed input.
+ */
+declare function parseTimeSeconds(raw: string): number | null;
+
+export { BLOCK_META_KEY_DESCRIPTORS as B, type CoercedBlockMeta as C, KNOWN_BLOCK_META_KEYS as K, type BlockMetaKeyDescriptor as a, type KnownBlockMetaKey as b, parseTimeSeconds as p };