@bendyline/squisq 1.4.1 → 1.5.1

package/dist/jsonForm/index.d.ts

@@ -1,3 +1,6 @@
+import { az as Theme, ap as SurfaceScheme } from '../Doc-BBVGq1_9.js';
+import '../types-DlAZ7MW4.js';
+
 /**
  * JSON Form types — Squisq's hint vocabulary layered on JSON Schema.
  *
@@ -188,4 +191,42 @@ interface InferSchemaOptions {
 }
 declare function inferSchema(sample: unknown, options?: InferSchemaOptions): SquisqAnnotatedSchema;
 
-export { type ControlKind, type InferSchemaOptions, type JsonFormValidationError, type JsonFormValidator, type SquisqAnnotatedSchema, type SquisqHints, type SquisqWhen, arrayItemKind, chooseControl, evaluateWhen, getByPointer, inferSchema, pointerSegments, primaryType, resolveFlag, resolveRef, setByPointer, toPointer };
+/**
+ * Pure CSS-custom-property builder shared by `<JsonView>` (read-only, in
+ * `@bendyline/squisq-react`) and `<JsonEditor>` (editable, in
+ * `@bendyline/squisq-editor-react`).
+ *
+ * Both components derive an identical token bag from a Theme + resolved
+ * Surface; they differ only in the CSS-var prefix (`--squisq-json` vs
+ * `--squisq-jsonform`) so the viewer and editor can coexist on one page.
+ * This function is the single source of that derivation. It is pure and
+ * framework-free: it performs no `window` / `matchMedia` access — the
+ * surface must already be resolved to a concrete `SurfaceScheme` (or left
+ * `undefined` to skip surface application) by the calling React hook.
+ */
+
+interface BuildJsonFormTokensOptions {
+    /**
+     * CSS-var prefix WITHOUT the trailing dash, e.g. `--squisq-json` or
+     * `--squisq-jsonform`. Each token key is `${prefix}-${name}`.
+     */
+    prefix: string;
+}
+/**
+ * Build the CSS custom-property map for a JSON form/view surface.
+ *
+ * @param theme   The theme to render with (falls back to `DEFAULT_THEME`).
+ * @param surface Already-resolved concrete surface, or `undefined` to leave
+ *                the theme un-surfaced. (The `'auto'` → concrete resolution
+ *                is the React hook's job, so this stays pure.)
+ * @param options `{ prefix }` — the CSS-var namespace.
+ */
+declare function buildJsonFormTokens(theme: Theme | undefined, surface: SurfaceScheme | undefined, options: BuildJsonFormTokensOptions): Record<string, string>;
+/**
+ * Resolve the effective theme after surface application — the companion to
+ * `buildJsonFormTokens` for callers that also need the `Theme` object (both
+ * hooks return it alongside the style bag).
+ */
+declare function resolveJsonFormTheme(theme: Theme | undefined, surface: SurfaceScheme | undefined): Theme;
+
+export { type BuildJsonFormTokensOptions, type ControlKind, type InferSchemaOptions, type JsonFormValidationError, type JsonFormValidator, type SquisqAnnotatedSchema, type SquisqHints, type SquisqWhen, arrayItemKind, buildJsonFormTokens, chooseControl, evaluateWhen, getByPointer, inferSchema, pointerSegments, primaryType, resolveFlag, resolveJsonFormTheme, resolveRef, setByPointer, toPointer };

package/dist/jsonForm/index.js

@@ -1,5 +1,6 @@
 import {
   arrayItemKind,
+  buildJsonFormTokens,
   chooseControl,
   evaluateWhen,
   getByPointer,
@@ -7,12 +8,18 @@ import {
   pointerSegments,
   primaryType,
   resolveFlag,
+  resolveJsonFormTheme,
   resolveRef,
   setByPointer,
   toPointer
-} from "../chunk-K32VJONL.js";
+} from "../chunk-T5UK6YOB.js";
+import "../chunk-A4O7GIWE.js";
+import "../chunk-KKNUBQ6Y.js";
+import "../chunk-DLXZMS5K.js";
+import "../chunk-QE7TWGVT.js";
 export {
   arrayItemKind,
+  buildJsonFormTokens,
   chooseControl,
   evaluateWhen,
   getByPointer,
@@ -20,6 +27,7 @@ export {
   pointerSegments,
   primaryType,
   resolveFlag,
+  resolveJsonFormTheme,
   resolveRef,
   setByPointer,
   toPointer

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,31 @@ declare function parseHtmlToNodes(html: string): HtmlNode[];
  */
 declare function stringifyHtmlNodes(nodes: HtmlNode[]): string;
 
+type HtmlPolicy = 'strip' | 'sanitize' | 'trusted';
+type UrlKind = 'link' | 'media';
+interface SanitizeUrlOptions {
+    /**
+     * Extra lowercase schemes allowed for `kind: 'link'` — the host-app escape
+     * hatch for custom link protocols it intercepts itself (e.g. an app-internal
+     * navigation scheme). Executable schemes are refused regardless.
+     */
+    extraLinkSchemes?: readonly string[];
+}
+/**
+ * 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, options?: SanitizeUrlOptions): 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
  *
@@ -228,6 +434,14 @@ declare function countNodes(node: MarkdownNode): number;
  * @returns A record of string keys to parsed values, or null
  */
 declare function parseFrontmatter(yaml: string): Record<string, unknown> | null;
+/**
+ * Format a multi-line string as a YAML literal block scalar body, i.e.
+ * `|-` followed by each source line indented two spaces. Paired with
+ * {@link parseFrontmatter}'s block-scalar reader so multi-line frontmatter
+ * values (e.g. pretty-printed JSON payloads) round-trip. Blank lines stay
+ * blank (no trailing whitespace) so the output diffs cleanly.
+ */
+declare function formatBlockScalar(value: string): string;
 /**
  * Update a markdown source string's YAML frontmatter block, applying the
  * given key/value updates. A `null` or `undefined` value removes the key.
@@ -273,5 +487,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, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, countNodes, createDocument, extractPlainText, findNodesByType, formatBlockScalar, 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,40 +1,75 @@
 import {
+  sanitizeHtmlNodes,
+  sanitizeUrl,
+  stringifyMarkdown
+} from "../chunk-6ATE2PSM.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-TEEEILMP.js";
 import {
   countNodes,
   createDocument,
   extractPlainText,
   findNodesByType,
+  formatBlockScalar,
   getChildren,
   inferDocumentTitle,
   parseFrontmatter,
+  parseHtmlToNodes,
+  plainTextFromInlineHtml,
   readFrontmatterThemeId,
   setFrontmatterValues,
+  stringifyHtmlNodes,
   walkMarkdownTree
-} from "../chunk-H3AXU4MJ.js";
+} from "../chunk-HWVFJAAH.js";
+import "../chunk-DBS6RIFL.js";
+import "../chunk-QE7TWGVT.js";
 export {
+  BLOCK_META_KEY_DESCRIPTORS,
+  KNOWN_BLOCK_META_KEYS,
   countNodes,
   createDocument,
   extractPlainText,
   findNodesByType,
+  formatBlockScalar,
   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-UY7KGQ5R.js";
+import "../chunk-HWVFJAAH.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 { az as Theme, v as DeepPartial, aD as ThemeSeedColors, aA as ThemeColorPalette, K as FontFamilyKind, J as FontFamily } from '../Doc-BBVGq1_9.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, q as CustomTemplateLayer, D as DARK_SURFACE, r as DEFAULT_DOC_FONT, s as DEFAULT_TITLE_FONT, t as DataTableInput, u as DateEventInput, w as DefinitionCardInput, x as DiagramBlockInput, y as Doc, z as DocBlock, E as DocDiagnostic, F as DrawingBlockInput, G as FRONTMATTER_CUSTOM_TEMPLATES_KEY, H as FRONTMATTER_CUSTOM_THEMES_KEY, I as FactCardInput, L as FullBleedQuoteInput, M as GradientBackgroundConfig, N as ImageBackgroundConfig, O as ImageLayer, P as ImageTreatment, Q as ImageWithCaptionInput, R as LIGHT_SURFACE, S as Layer, T as LayerRepeat, U as LayoutHints, V as LeftFeatureInput, W as LinearGradient, X as ListBlockInput, Y as MapBlockInput, Z as MapLayer, _ as MapMarker, $ as MapTileStyle, a0 as MarkerStyle, a1 as MediaClip, a2 as PathLayer, a3 as PatternBackgroundConfig, a4 as PersistentLayer, a5 as PersistentLayerConfig, a6 as PersistentLayerTemplate, a7 as PersistentLayerTemplateConfig, a8 as PersistentLayerTemplateType, a9 as PhotoGridInput, aa as Position, ab as ProgressIndicatorConfig, ac as PullQuoteInput, ad as QuoteBlockInput, ae as RawLayersInput, af as RenderStyle, ag as RightFeatureInput, ah as ScheduledClip, ai as SectionHeaderInput, aj as ShapeFilter, ak as ShapeLayer, al as ShapePattern, am as SolidBackgroundConfig, an as StartBlockConfig, ao as StatHighlightInput, ap as SurfaceScheme, aq as THEME_SCHEMA_VERSION, ar as TableLayer, as as TableLayerStyle, at as TemplateBlock, au as TemplateContext, av as TemplateFunction, aw as TemplateRegistry, ax as TextLayer, ay as TextStyle, aB as ThemeColorScheme, aC as ThemeSchemaVersion, aE as ThemeStyle, aF as ThemeTypography, aG as TitleBlockInput, aH as TitleCaptionConfig, aI as TwoColumnInput, aJ as VIEWPORT_PRESETS, aK as VideoLayer, aL as VideoPullQuoteInput, aM as VideoWithCaptionInput, aN as ViewportConfig, aO as ViewportOrientation, aP as ViewportPreset, aQ as VignetteConfig, aR as applySurface, aS as calculateDuration, aT as calculateFontScale, aU as createTemplateContext, aV as createTheme, aW as getAspectRatioString, aX as getBlockAtTime, aY as getCaptionAtTime, aZ as getDocPlaybackDuration, a_ as getLayoutHints, a$ as getRegisteredThemes, b0 as getSafeTextBounds, b1 as getSegmentAtTime, b2 as getTwoColumnPositions, b3 as getViewport, b4 as getViewportOrientation, b5 as isPersistentLayerTemplate, b6 as isTemplateBlock, b7 as layoutScaledFontSize, b8 as lookupRegisteredTheme, b9 as registerTheme, ba as resolveMediaSchedule, bb as scaledFontSize, bc as unregisterTheme } from '../Doc-BBVGq1_9.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-CehcJhzz.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-FuyGtt6o.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,20 @@ import {
   deriveColorPalette,
   getBlockAtTime,
   getCaptionAtTime,
+  getDocPlaybackDuration,
   getSegmentAtTime,
   parseTheme,
-  serializeTheme,
-  validateDoc
-} from "../chunk-57CVQCFX.js";
+  resolveMediaSchedule,
+  serializeTheme
+} from "../chunk-A4O7GIWE.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 +33,7 @@ import {
   getFontStack,
   getRegisteredThemes,
   getThemeSummaries,
+  hexHueDegrees,
   isHex,
   lookupRegisteredTheme,
   oklchDarken,
@@ -41,8 +45,9 @@ import {
   resolveFontFamily,
   resolveTheme,
   unregisterTheme,
-  validateTheme
-} from "../chunk-B4EEON3N.js";
+  validateTheme,
+  withAlpha
+} from "../chunk-KKNUBQ6Y.js";
 import {
   DEFAULT_DOC_FONT,
   DEFAULT_TITLE_FONT,
@@ -59,7 +64,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 +82,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 +109,7 @@ export {
   getAvailableThemes,
   getBlockAtTime,
   getCaptionAtTime,
+  getDocPlaybackDuration,
   getFontStack,
   getLayoutHints,
   getRegisteredThemes,
@@ -98,11 +119,15 @@ export {
   getTwoColumnPositions,
   getViewport,
   getViewportOrientation,
+  hexHueDegrees,
   isHex,
   isPersistentLayerTemplate,
   isTemplateBlock,
+  isTransitionType,
   scaledFontSize as layoutScaledFontSize,
   lookupRegisteredTheme,
+  normalizeTransitionDirection,
+  normalizeTransitionType,
   oklchDarken,
   oklchLighten,
   oklchSetChroma,
@@ -110,12 +135,15 @@ export {
   pickContrastingText,
   registerTheme,
   relativeLuminance,
+  resolveBlockTransition,
   resolveFontFamily,
+  resolveMediaSchedule,
   resolveTheme,
+  resolveTransitionDuration,
   scaledFontSize2 as scaledFontSize,
   serializeTheme,
   unregisterTheme,
-  validateDoc,
-  validateTheme
+  validateTheme,
+  withAlpha
 };
 //# sourceMappingURL=index.js.map