@bendyline/squisq 1.4.1 → 1.5.0

package/dist/inlineIconMarker-CiE8Hlvz.d.ts

@@ -0,0 +1,59 @@
+/**
+ * iconData.ts — GENERATED FILE
+ *
+ * FontAwesome Free icon catalog. Run `node scripts/generate-icon-data.mjs`
+ * to regenerate after bumping @fortawesome/fontawesome-free.
+ *
+ * Entry count: 2141
+ * Generated:   2026-05-14T03:38:13.863Z
+ */
+type IconFamily = 'brands' | 'solid' | 'regular';
+interface IconEntry {
+    /** Icon name without the `fa-` prefix (e.g. `github`). */
+    name: string;
+    /** Family bucket — drives the `fa-brands` / `fa-solid` / `fa-regular` class. */
+    family: IconFamily;
+    /** Human display label (used by the picker tooltip). */
+    label: string;
+    /** Lowercase, space-joined search keywords. */
+    keywords: string;
+    /** FontAwesome Private-Use-Area codepoint as a hex string (e.g. `'f09b'`).
+     *  Use `String.fromCodePoint(parseInt(unicode, 16))` to get the rendered
+     *  glyph when the FA font is loaded. */
+    unicode: string;
+}
+declare const ICONS: IconEntry[];
+
+/**
+ * Inline-icon markers for template text.
+ *
+ * Slide templates flatten rich markdown body content into strings before
+ * rendering. Inline icons need to survive that flattening step, so we encode
+ * them as sentinel-delimited text markers and let `TextLayer` turn them back
+ * into FontAwesome glyphs when rendering.
+ */
+
+/** Encode a resolved icon (family + name) as an embeddable text marker. */
+declare function iconMarker(family: IconFamily, name: string): string;
+/** True when a string contains at least one encoded icon marker. */
+declare function hasIconMarker(value: string): boolean;
+/** Remove every icon marker, leaving a clean plain-text projection. */
+declare function stripIconMarkers(value: string): string;
+/** A run of a marker-bearing string: literal text or a resolved icon. */
+type IconTextRun = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'icon';
+    family: IconFamily;
+    name: string;
+};
+/**
+ * Split a string into ordered text/icon runs. Text between markers is
+ * preserved verbatim, including whitespace; each marker becomes an icon run.
+ */
+declare function splitIconMarkers(value: string): IconTextRun[];
+/** FontAwesome CSS class for a resolved icon, e.g. `fa-solid fa-rocket`. */
+declare function iconClass(family: IconFamily, name: string): string;
+
+export { ICONS as I, type IconEntry as a, type IconFamily as b, type IconTextRun as c, iconMarker as d, stripIconMarkers as e, hasIconMarker as h, iconClass as i, splitIconMarkers as s };

package/dist/markdown/index.d.ts

@@ -1,5 +1,5 @@
-import { T as ParseOptions, l as MarkdownDocument, U as StringifyOptions, c as HtmlNode, F as MarkdownNode } from '../types-BdZkdJ3z.js';
-export { H as HeadingTemplateAnnotation, a as HtmlComment, b as HtmlElement, d as HtmlText, M as MarkdownBlockNode, e as MarkdownBlockquote, f as MarkdownBreak, g as MarkdownCodeBlock, h as MarkdownContainerDirective, i as MarkdownDefinitionDescription, j as MarkdownDefinitionList, k as MarkdownDefinitionTerm, m as MarkdownEmphasis, n as MarkdownFootnoteDefinition, o as MarkdownFootnoteReference, p as MarkdownHeading, q as MarkdownHtmlBlock, r as MarkdownImage, s as MarkdownImageReference, t as MarkdownInlineCode, u as MarkdownInlineHtml, v as MarkdownInlineMath, w as MarkdownInlineNode, x as MarkdownLeafDirective, y as MarkdownLink, z as MarkdownLinkDefinition, A as MarkdownLinkReference, B as MarkdownList, C as MarkdownListItem, D as MarkdownMathBlock, E as MarkdownMention, G as MarkdownParagraph, I as MarkdownPoint, J as MarkdownSourcePosition, K as MarkdownStrikethrough, L as MarkdownStrong, N as MarkdownTable, O as MarkdownTableCell, P as MarkdownTableRow, Q as MarkdownText, R as MarkdownTextDirective, S as MarkdownThematicBreak } from '../types-BdZkdJ3z.js';
+import { V as ParseOptions, m as MarkdownDocument, W as StringifyOptions, H as HeadingAttributes, d as HtmlNode, I as MarkdownNode } from '../types-DlAZ7MW4.js';
+export { a as HeadingTemplateAnnotation, b as HtmlComment, c as HtmlElement, e as HtmlText, M as MarkdownBlockNode, f as MarkdownBlockquote, g as MarkdownBreak, h as MarkdownCodeBlock, i as MarkdownContainerDirective, j as MarkdownDefinitionDescription, k as MarkdownDefinitionList, l as MarkdownDefinitionTerm, n as MarkdownEmphasis, o as MarkdownFootnoteDefinition, p as MarkdownFootnoteReference, q as MarkdownHeading, r as MarkdownHtmlBlock, s as MarkdownImage, t as MarkdownImageReference, u as MarkdownInlineCode, v as MarkdownInlineHtml, w as MarkdownInlineMath, x as MarkdownInlineNode, y as MarkdownLeafDirective, z as MarkdownLink, A as MarkdownLinkDefinition, B as MarkdownLinkReference, C as MarkdownList, E as MarkdownListItem, F as MarkdownMathBlock, G as MarkdownMention, J as MarkdownParagraph, K as MarkdownPoint, L as MarkdownSourcePosition, N as MarkdownStrikethrough, O as MarkdownStrong, P as MarkdownTable, Q as MarkdownTableCell, R as MarkdownTableRow, S as MarkdownText, T as MarkdownTextDirective, U as MarkdownThematicBreak } from '../types-DlAZ7MW4.js';
 
 /**
  * Markdown → JSON Parser
@@ -112,6 +112,29 @@ interface MdastNode {
     attributes?: Record<string, string>;
     data?: Record<string, unknown>;
 }
+/**
+ * Parse the inner content of a Pandoc-style `{…}` block. Tokens are
+ * whitespace-separated, with quoted runs (single or double) treated as
+ * single tokens — tokenization is shared with the `{[…]}` template
+ * annotation parser via {@link tokenizeAttrTokens}.
+ *
+ * - `#id` → `attributes.id`
+ * - `.class` → push onto `attributes.classes`
+ * - `key=value` or `key="quoted value"` → `attributes.params[key] = value`
+ *
+ * Empty `{}` yields `{}` (preserved as an annotation marker for round-tripping).
+ * Duplicate ids and keys: last wins, silent.
+ */
+declare function parsePandocAttrTokens(inner: string): HeadingAttributes;
+/**
+ * Serialize a HeadingAttributes object back to a Pandoc `{#id .class key=value}` string.
+ * Returns null when the attributes object is entirely empty (nothing to emit).
+ *
+ * Canonical key order: `#id`, then `.classes` (in original order), then
+ * params in their original insertion order. Values are quoted via the
+ * shared {@link quoteAttrValue} rule (same as `{[…]}` serialization).
+ */
+declare function serializePandocAttributes(attrs: HeadingAttributes): string | null;
 /**
  * Convert an mdast Root node to a MarkdownDocument.
  *
@@ -130,6 +153,164 @@ declare function fromMdast(root: MdastNode, options?: {
  */
 declare function toMdast(doc: MarkdownDocument): MdastNode;
 
+/**
+ * Shared key=value attribute machinery for the two heading annotation forms:
+ * the squisq-native `{[templateName key=value …]}` template annotation and
+ * the Pandoc-style `{#id .class key=value}` attribute block.
+ *
+ * Both forms share one interior grammar — whitespace-separated tokens whose
+ * values may be quoted (double or single) to include spaces, brackets, or
+ * quote characters. This module is the single implementation of that
+ * grammar: one tokenizer, one value un/escaper, one quoting rule. The
+ * trailing-annotation recognizers live here too so the editor bridge
+ * (packages/editor-react/src/tiptapBridge.ts) stays in sync by importing
+ * them rather than copying regexes.
+ *
+ * Value syntax:
+ * - Unquoted: no whitespace, quotes, or `[ ] { }` (those would collide with
+ *   the surrounding annotation delimiters), e.g. `columns=3`, `name=O'Brien`
+ *   (a quote *inside* an unquoted value is literal).
+ * - Quoted: `key="value with spaces"` or `key='…'`. Inside a quoted run,
+ *   `\` escapes the active quote character and itself; any other `\` is
+ *   literal. Quoted values may contain `]` and `}`.
+ * - Serialization emits double quotes, switching to single quotes when the
+ *   value contains a double quote (markdown character-escape resolution
+ *   makes backslash-escaped quotes fragile in `.md` source, so picking the
+ *   other quote character is preferred over escaping). A value containing
+ *   BOTH quote characters falls back to double quotes with `\"` escapes —
+ *   that survives the API path but is best avoided in markdown source.
+ */
+/** Result of matching a trailing annotation against a text run. */
+interface TrailingAnnotationMatch {
+    /** Interior of the brace block (between `{[`/`{` and `]}`/`}`), untrimmed. */
+    inner: string;
+    /** Offset of the match start (including leading whitespace) in the input. */
+    index: number;
+}
+/**
+ * Match a trailing `{[templateName key=value …]}` annotation. Quote-aware
+ * (values may contain `]` when quoted), with a legacy fallback so inputs
+ * the old `[^\]]+` grammar accepted still match.
+ */
+declare function matchTrailingTemplateAnnotation(text: string): TrailingAnnotationMatch | null;
+/**
+ * Match a trailing Pandoc `{#id .class key=value}` block. Quote-aware
+ * (values may contain `}` when quoted), with a legacy fallback.
+ */
+declare function matchTrailingPandocAttr(text: string): TrailingAnnotationMatch | null;
+/**
+ * Quote-aware whitespace tokenizer for the interior of either annotation
+ * form.
+ *
+ * A quote run starts only at the beginning of a token or immediately after
+ * `=` — a quote elsewhere (e.g. `name=O'Brien`) is a literal character.
+ * Inside a run, `\` escapes the active quote character and itself; the
+ * escape pair is preserved in the returned token (callers strip and
+ * unescape via {@link splitKeyValueToken} / {@link unquoteAttrValue}).
+ * An unbalanced opening quote is tolerated: the run extends to the end of
+ * the input.
+ */
+declare function tokenizeAttrTokens(input: string): string[];
+/**
+ * Strip surrounding quotes from a raw token value and unescape the active
+ * quote character and backslash. Values not wrapped in matching quotes are
+ * returned verbatim (including any interior quotes or backslashes).
+ */
+declare function unquoteAttrValue(raw: string): string;
+/**
+ * Split a `key=value` token into its parts, unquoting/unescaping the value.
+ * Returns null for tokens with no `=` past the first character (bare words,
+ * `#id`, `.class`, or a leading `=`).
+ */
+declare function splitKeyValueToken(token: string): {
+    key: string;
+    value: string;
+} | null;
+/**
+ * Whether a value must be quoted to survive tokenization and the outer
+ * annotation regexes: any whitespace, quote character, bracket, or brace —
+ * or an empty value, which would otherwise serialize as a bare `key=`.
+ */
+declare function needsQuoting(value: string): boolean;
+/**
+ * Serialize an attribute value, quoting when {@link needsQuoting} says the
+ * bare form would not round-trip.
+ *
+ * Double quotes are canonical; a value containing a double quote (but no
+ * single quote) is single-quoted instead, because markdown resolves
+ * backslash escapes in text runs before our parser sees them — switching
+ * the quote character round-trips through `.md` source where `\"` would
+ * not. Backslashes and the active quote character are escaped.
+ */
+declare function quoteAttrValue(value: string): string;
+
+/**
+ * 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[];
+/**
+ * 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;
+
 /**
  * HTML ↔ HtmlNode Conversion
  *
@@ -156,6 +337,23 @@ declare function parseHtmlToNodes(html: string): HtmlNode[];
  */
 declare function stringifyHtmlNodes(nodes: HtmlNode[]): string;
 
+type HtmlPolicy = 'strip' | 'sanitize' | 'trusted';
+type UrlKind = 'link' | 'media';
+/**
+ * Sanitize a URL for a rendered link or media attribute.
+ *
+ * Relative URLs are allowed. Absolute URLs are restricted to schemes that
+ * cannot execute script in a document context. Media URLs additionally allow
+ * `blob:` and image/audio/video `data:` URLs because Squisq uses both for
+ * browser-local media previews and self-contained exports.
+ */
+declare function sanitizeUrl(url: string | null | undefined, kind?: UrlKind): string | null;
+/**
+ * Return a sanitized copy of an HtmlNode tree. The original parsed tree is left
+ * untouched so markdown stringify can still preserve source fidelity.
+ */
+declare function sanitizeHtmlNodes(nodes: HtmlNode[]): HtmlNode[];
+
 /**
  * Markdown Tree Utilities
  *
@@ -273,5 +471,16 @@ declare function inferDocumentTitle(doc: MarkdownDocument): string | undefined;
  * spelling later is a one-file change.
  */
 declare function readFrontmatterThemeId(frontmatter: Record<string, unknown> | undefined): string | undefined;
+/**
+ * Project an inline-HTML string (as stored on `TextLayer.content.html`) down
+ * to plain text — the value mirrored into `content.text` for plain consumers
+ * (PDF/markdown export, search, accessibility) and the SVG `<text>` fallback.
+ *
+ * `<br>` and block-level tags (`p`, `div`, `h1`–`h6`, `li`, `blockquote`,
+ * `pre`) become line breaks so multi-line rich content reads sensibly. Entity
+ * decoding is handled by {@link parseHtmlToNodes} (parse5-backed), so this is
+ * more correct than a regex tag-stripper.
+ */
+declare function plainTextFromInlineHtml(html: string): string;
 
-export { HtmlNode, MarkdownDocument, MarkdownNode, ParseOptions, StringifyOptions, countNodes, createDocument, extractPlainText, findNodesByType, fromMdast, getChildren, inferDocumentTitle, parseFrontmatter, parseHtmlToNodes, parseMarkdown, readFrontmatterThemeId, setFrontmatterValues, stringifyHtmlNodes, stringifyMarkdown, toMdast, walkMarkdownTree };
+export { BLOCK_META_KEY_DESCRIPTORS, type BlockMetaKeyDescriptor, HeadingAttributes, HtmlNode, type HtmlPolicy, KNOWN_BLOCK_META_KEYS, type KnownBlockMetaKey, MarkdownDocument, MarkdownNode, ParseOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, countNodes, createDocument, extractPlainText, findNodesByType, fromMdast, getChildren, inferDocumentTitle, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, parseTimeSeconds, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, walkMarkdownTree };

package/dist/markdown/index.js

@@ -1,12 +1,25 @@
 import {
+  sanitizeHtmlNodes,
+  sanitizeUrl,
+  stringifyMarkdown
+} from "../chunk-KZNXZ5SM.js";
+import {
+  BLOCK_META_KEY_DESCRIPTORS,
+  KNOWN_BLOCK_META_KEYS,
   fromMdast,
-  parseHtmlToNodes,
+  matchTrailingPandocAttr,
+  matchTrailingTemplateAnnotation,
+  needsQuoting,
   parseMarkdown,
-  stringifyHtmlNodes,
-  stringifyMarkdown,
-  toMdast
-} from "../chunk-3K5OG6KI.js";
-import "../chunk-DBS6RIFL.js";
+  parsePandocAttrTokens,
+  parseTimeSeconds,
+  quoteAttrValue,
+  serializePandocAttributes,
+  splitKeyValueToken,
+  toMdast,
+  tokenizeAttrTokens,
+  unquoteAttrValue
+} from "../chunk-OH43RPTP.js";
 import {
   countNodes,
   createDocument,
@@ -15,11 +28,18 @@ import {
   getChildren,
   inferDocumentTitle,
   parseFrontmatter,
+  parseHtmlToNodes,
+  plainTextFromInlineHtml,
   readFrontmatterThemeId,
   setFrontmatterValues,
+  stringifyHtmlNodes,
   walkMarkdownTree
-} from "../chunk-H3AXU4MJ.js";
+} from "../chunk-OKJOQXK4.js";
+import "../chunk-DBS6RIFL.js";
+import "../chunk-QE7TWGVT.js";
 export {
+  BLOCK_META_KEY_DESCRIPTORS,
+  KNOWN_BLOCK_META_KEYS,
   countNodes,
   createDocument,
   extractPlainText,
@@ -27,14 +47,27 @@ export {
   fromMdast,
   getChildren,
   inferDocumentTitle,
+  matchTrailingPandocAttr,
+  matchTrailingTemplateAnnotation,
+  needsQuoting,
   parseFrontmatter,
   parseHtmlToNodes,
   parseMarkdown,
+  parsePandocAttrTokens,
+  parseTimeSeconds,
+  plainTextFromInlineHtml,
+  quoteAttrValue,
   readFrontmatterThemeId,
+  sanitizeHtmlNodes,
+  sanitizeUrl,
+  serializePandocAttributes,
   setFrontmatterValues,
+  splitKeyValueToken,
   stringifyHtmlNodes,
   stringifyMarkdown,
   toMdast,
+  tokenizeAttrTokens,
+  unquoteAttrValue,
   walkMarkdownTree
 };
 //# sourceMappingURL=index.js.map

package/dist/recommend/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MarkdownBlockNode } from '../types-BdZkdJ3z.js';
+import { M as MarkdownBlockNode } from '../types-DlAZ7MW4.js';
 
 /**
  * Block template recommendations.

package/dist/recommend/index.js

@@ -1,8 +1,9 @@
+import "../chunk-ZLQKNOZQ.js";
 import {
   profileBlockContents,
   recommendTemplatesForBlock
-} from "../chunk-WMOI7FN3.js";
-import "../chunk-H3AXU4MJ.js";
+} from "../chunk-LRCV7N7F.js";
+import "../chunk-OKJOQXK4.js";
 export {
   profileBlockContents,
   recommendTemplatesForBlock

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { af as Theme, q as DeepPartial, aj as ThemeSeedColors, ag as ThemeColorPalette, v as FontFamilyKind, u as FontFamily } from '../Doc-BeSeH2iX.js';
-export { A as AccentImage, a as AccentPosition, b as Animation, c as AnimationType, d as AudioBookmark, e as AudioSegment, f as AudioTimingData, g as AudioTrack, B as Block, C as CaptionPhrase, h as CaptionTrack, i as CaptionWord, j as ColorScheme, k as ComparisonBarInput, l as CornerBrandingConfig, D as DARK_SURFACE, m as DEFAULT_DOC_FONT, n as DEFAULT_TITLE_FONT, o as DataTableInput, p as DateEventInput, r as DefinitionCardInput, s as Doc, t as DocBlock, F as FactCardInput, w as FullBleedQuoteInput, G as GradientBackgroundConfig, I as ImageBackgroundConfig, x as ImageLayer, y as ImageWithCaptionInput, L as LIGHT_SURFACE, z as Layer, E as LayoutHints, H as LeftFeatureInput, J as ListBlockInput, M as MapBlockInput, K as MapLayer, N as MapMarker, O as MapTileStyle, P as PatternBackgroundConfig, Q as PersistentLayer, R as PersistentLayerConfig, S as PersistentLayerTemplate, T as PersistentLayerTemplateConfig, U as PersistentLayerTemplateType, V as PhotoGridInput, W as Position, X as ProgressIndicatorConfig, Y as PullQuoteInput, Z as QuoteBlockInput, _ as RenderStyle, $ as RightFeatureInput, a0 as SectionHeaderInput, a1 as ShapeLayer, a2 as SolidBackgroundConfig, a3 as StartBlockConfig, a4 as StatHighlightInput, a5 as SurfaceScheme, a6 as THEME_SCHEMA_VERSION, a7 as TableLayer, a8 as TableLayerStyle, a9 as TemplateBlock, aa as TemplateContext, ab as TemplateFunction, ac as TemplateRegistry, ad as TextLayer, ae as TextStyle, ah as ThemeColorScheme, ai as ThemeSchemaVersion, ak as ThemeStyle, al as ThemeTypography, am as TitleBlockInput, an as TitleCaptionConfig, ao as Transition, ap as TransitionType, aq as TwoColumnInput, ar as VIEWPORT_PRESETS, as as VideoLayer, at as VideoPullQuoteInput, au as VideoWithCaptionInput, av as ViewportConfig, aw as ViewportOrientation, ax as ViewportPreset, ay as applySurface, az as calculateDuration, aA as calculateFontScale, aB as createTemplateContext, aC as createTheme, aD as getAspectRatioString, aE as getBlockAtTime, aF as getCaptionAtTime, aG as getLayoutHints, aH as getRegisteredThemes, aI as getSafeTextBounds, aJ as getSegmentAtTime, aK as getTwoColumnPositions, aL as getViewport, aM as getViewportOrientation, aN as isPersistentLayerTemplate, aO as isTemplateBlock, aP as layoutScaledFontSize, aQ as lookupRegisteredTheme, aR as registerTheme, aS as scaledFontSize, aT as unregisterTheme, aU as validateDoc } from '../Doc-BeSeH2iX.js';
-export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BHjJ0Qx6.js';
+import { ax as Theme, u as DeepPartial, aB as ThemeSeedColors, ay as ThemeColorPalette, J as FontFamilyKind, I as FontFamily } from '../Doc-BsMkmzH8.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AudioBookmark, f as AudioSegment, g as AudioTimingData, h as AudioTrack, B as Block, i as BlockConnection, j as BorderStyle, C as CaptionPhrase, k as CaptionTrack, l as CaptionWord, m as ColorScheme, n as ComparisonBarInput, o as CornerBrandingConfig, p as CustomTemplateDefinition, D as DARK_SURFACE, q as DEFAULT_DOC_FONT, r as DEFAULT_TITLE_FONT, s as DataTableInput, t as DateEventInput, v as DefinitionCardInput, w as DiagramBlockInput, x as Doc, y as DocBlock, z as DocDiagnostic, E as DrawingBlockInput, F as FRONTMATTER_CUSTOM_TEMPLATES_KEY, G as FRONTMATTER_CUSTOM_THEMES_KEY, H as FactCardInput, K as FullBleedQuoteInput, L as GradientBackgroundConfig, M as ImageBackgroundConfig, N as ImageLayer, O as ImageTreatment, P as ImageWithCaptionInput, Q as LIGHT_SURFACE, R as Layer, S as LayoutHints, T as LeftFeatureInput, U as LinearGradient, V as ListBlockInput, W as MapBlockInput, X as MapLayer, Y as MapMarker, Z as MapTileStyle, _ as MarkerStyle, $ as MediaClip, a0 as PathLayer, a1 as PatternBackgroundConfig, a2 as PersistentLayer, a3 as PersistentLayerConfig, a4 as PersistentLayerTemplate, a5 as PersistentLayerTemplateConfig, a6 as PersistentLayerTemplateType, a7 as PhotoGridInput, a8 as Position, a9 as ProgressIndicatorConfig, aa as PullQuoteInput, ab as QuoteBlockInput, ac as RawLayersInput, ad as RenderStyle, ae as RightFeatureInput, af as ScheduledClip, ag as SectionHeaderInput, ah as ShapeFilter, ai as ShapeLayer, aj as ShapePattern, ak as SolidBackgroundConfig, al as StartBlockConfig, am as StatHighlightInput, an as SurfaceScheme, ao as THEME_SCHEMA_VERSION, ap as TableLayer, aq as TableLayerStyle, ar as TemplateBlock, as as TemplateContext, at as TemplateFunction, au as TemplateRegistry, av as TextLayer, aw as TextStyle, az as ThemeColorScheme, aA as ThemeSchemaVersion, aC as ThemeStyle, aD as ThemeTypography, aE as TitleBlockInput, aF as TitleCaptionConfig, aG as TwoColumnInput, aH as VIEWPORT_PRESETS, aI as VideoLayer, aJ as VideoPullQuoteInput, aK as VideoWithCaptionInput, aL as ViewportConfig, aM as ViewportOrientation, aN as ViewportPreset, aO as VignetteConfig, aP as applySurface, aQ as calculateDuration, aR as calculateFontScale, aS as createTemplateContext, aT as createTheme, aU as getAspectRatioString, aV as getBlockAtTime, aW as getCaptionAtTime, aX as getDocPlaybackDuration, aY as getLayoutHints, aZ as getRegisteredThemes, a_ as getSafeTextBounds, a$ as getSegmentAtTime, b0 as getTwoColumnPositions, b1 as getViewport, b2 as getViewportOrientation, b3 as isPersistentLayerTemplate, b4 as isTemplateBlock, b5 as layoutScaledFontSize, b6 as lookupRegisteredTheme, b7 as registerTheme, b8 as resolveMediaSchedule, b9 as scaledFontSize, ba as unregisterTheme, bb as validateDoc } from '../Doc-BsMkmzH8.js';
+export { D as DEFAULT_TRANSITION_DURATION_SECONDS, X as TRANSITION_DIRECTIONS, Y as TRANSITION_TYPES, Z as Transition, _ as TransitionDirection, $ as TransitionType, a0 as isTransitionType, a1 as normalizeTransitionDirection, a2 as normalizeTransitionType, a3 as resolveBlockTransition, a4 as resolveTransitionDuration } from '../types-DlAZ7MW4.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-DQQKuRMx.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-BTIvw0oq.js';
-import '../types-BdZkdJ3z.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-DvoeHMP9.js';
 
 /**
  * Theme Validator
@@ -60,11 +60,19 @@ type ContrastPreset = 'subtle' | 'balanced' | 'high';
 interface CompileOptions {
     /** Contrast level for OKLCh derivation (default 'balanced'). */
     contrast?: ContrastPreset;
+    /**
+     * Base theme to inherit from. When provided, the partial is deep-merged
+     * over this theme instead of the neutral `STARTER_THEME`, so the compiled
+     * theme inherits the base's render style, color schemes, typography, and
+     * persistent layers — and only the fields the user changed are overridden.
+     * The base's id is recorded on the result as `basedOn`.
+     */
+    base?: Theme;
 }
 /**
  * Compile a partial Theme into a complete one. Fills missing fields from
- * `STARTER_THEME`, derives missing color slots from `seedColors` (when
- * present), and validates the result.
+ * the base (`opts.base` when given, else `STARTER_THEME`), derives missing
+ * color slots from `seedColors` (when present), and validates the result.
  */
 declare function compileTheme(partial: DeepPartial<Theme>, opts?: CompileOptions): Theme;
 /**
@@ -164,6 +172,18 @@ declare function oklchSetChroma(hex: string, multiplier: number): string;
  * WCAG relative luminance of a hex color, returned as 0..1.
  */
 declare function relativeLuminance(hex: string): number;
+/**
+ * Hue of a hex color in HSL degrees (0..360). Returns 0 for pure grays
+ * and on parse failure. Used by the duotone image treatment to aim its
+ * `hue-rotate()` at the theme's tint color.
+ */
+declare function hexHueDegrees(hex: string): number;
+/**
+ * Convert a hex color + alpha (0..1) to an `rgba()` string.
+ * Falls back to the input on parse failure (e.g. a value that is
+ * already an rgba()/gradient string).
+ */
+declare function withAlpha(hex: string, alpha: number): string;
 /**
  * WCAG contrast ratio between two hex colors. Returns 1..21.
  */
@@ -185,4 +205,4 @@ declare function deriveScale(seedHex: string, spread?: number): {
     darker2: string;
 };
 
-export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, STARTER_THEME, Theme, ThemeColorPalette, ThemeSeedColors, type ValidationError, type ValidationResult, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, deriveColorPalette, deriveScale, fontStack, getFontStack, isHex, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme };
+export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, STARTER_THEME, Theme, ThemeColorPalette, ThemeSeedColors, type ValidationError, type ValidationResult, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, deriveColorPalette, deriveScale, fontStack, getFontStack, hexHueDegrees, isHex, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha };

package/dist/schemas/index.js

@@ -5,17 +5,21 @@ import {
   deriveColorPalette,
   getBlockAtTime,
   getCaptionAtTime,
+  getDocPlaybackDuration,
   getSegmentAtTime,
   parseTheme,
+  resolveMediaSchedule,
   serializeTheme,
   validateDoc
-} from "../chunk-57CVQCFX.js";
+} from "../chunk-7MQGNR76.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
   DEFAULT_THEME,
   DEFAULT_THEME_ID,
   FONT_FALLBACKS,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
   LIGHT_SURFACE,
   THEMES,
   THEME_SCHEMA_VERSION,
@@ -30,6 +34,7 @@ import {
   getFontStack,
   getRegisteredThemes,
   getThemeSummaries,
+  hexHueDegrees,
   isHex,
   lookupRegisteredTheme,
   oklchDarken,
@@ -41,8 +46,9 @@ import {
   resolveFontFamily,
   resolveTheme,
   unregisterTheme,
-  validateTheme
-} from "../chunk-B4EEON3N.js";
+  validateTheme,
+  withAlpha
+} from "../chunk-4AKUQPEE.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -59,7 +65,17 @@ import {
   isTemplateBlock,
   scaledFontSize,
   scaledFontSize2
-} from "../chunk-5WFRKURX.js";
+} from "../chunk-DLXZMS5K.js";
+import {
+  DEFAULT_TRANSITION_DURATION_SECONDS,
+  TRANSITION_DIRECTIONS,
+  TRANSITION_TYPES,
+  isTransitionType,
+  normalizeTransitionDirection,
+  normalizeTransitionType,
+  resolveBlockTransition,
+  resolveTransitionDuration
+} from "../chunk-QE7TWGVT.js";
 export {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -67,11 +83,16 @@ export {
   DEFAULT_THEME,
   DEFAULT_THEME_ID,
   DEFAULT_TITLE_FONT,
+  DEFAULT_TRANSITION_DURATION_SECONDS,
   FONT_FALLBACKS,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
   LIGHT_SURFACE,
   STARTER_THEME,
   THEMES,
   THEME_SCHEMA_VERSION,
+  TRANSITION_DIRECTIONS,
+  TRANSITION_TYPES,
   VIEWPORT_PRESETS,
   applySurface,
   assertTheme,
@@ -89,6 +110,7 @@ export {
   getAvailableThemes,
   getBlockAtTime,
   getCaptionAtTime,
+  getDocPlaybackDuration,
   getFontStack,
   getLayoutHints,
   getRegisteredThemes,
@@ -98,11 +120,15 @@ export {
   getTwoColumnPositions,
   getViewport,
   getViewportOrientation,
+  hexHueDegrees,
   isHex,
   isPersistentLayerTemplate,
   isTemplateBlock,
+  isTransitionType,
   scaledFontSize as layoutScaledFontSize,
   lookupRegisteredTheme,
+  normalizeTransitionDirection,
+  normalizeTransitionType,
   oklchDarken,
   oklchLighten,
   oklchSetChroma,
@@ -110,12 +136,16 @@ export {
   pickContrastingText,
   registerTheme,
   relativeLuminance,
+  resolveBlockTransition,
   resolveFontFamily,
+  resolveMediaSchedule,
   resolveTheme,
+  resolveTransitionDuration,
   scaledFontSize2 as scaledFontSize,
   serializeTheme,
   unregisterTheme,
   validateDoc,
-  validateTheme
+  validateTheme,
+  withAlpha
 };
 //# sourceMappingURL=index.js.map

package/dist/spatial/index.d.ts

@@ -39,6 +39,7 @@ declare function calculateBearing(from: Coordinates, to: Coordinates): number;
  * - 5 chars: ~5km x 5km
  * - 6 chars: ~1.2km x 0.6km
  */
+
 /**
  * Encode latitude/longitude to a geohash string.
  * Uses the standard ngeohash library.
@@ -91,10 +92,14 @@ declare function getGeohashPrefix(geohash: string, precision: number): string;
  */
 declare function geohashToHierarchicalPath(geohash4: string): string;
 /**
- * Compute all geohash cells along the path between two geohash cells.
- * Interpolates lat/lng points between the centers of `from` and `to`,
- * encoding each to a geohash at the given precision, and returns the
- * deduplicated list of intermediate cells (excluding `from` and `to`).
+ * Compute all geohash cells along the great-circle path between two geohash cells.
+ * Samples points along the spherical arc from `from` to `to`, encoding each to a
+ * geohash at the given precision, and returns the deduplicated list of intermediate
+ * cells (excluding `from` and `to`).
+ *
+ * Uses spherical linear interpolation (SLERP) via 3D unit vectors, which correctly
+ * handles antimeridian crossings and polar paths — both of which flat lat/lng
+ * interpolation gets wrong.
  */
 declare function getGeohashPath(from: string, to: string, precision?: number): string[];
 /**

package/dist/spatial/index.js

@@ -9,7 +9,7 @@ import {
   getGeohashPrefix,
   getNeighbors,
   haversineDistance
-} from "../chunk-7UDSRZKG.js";
+} from "../chunk-Q3ROPT5H.js";
 export {
   calculateBearing,
   decodeGeohash,