@bendyline/squisq 1.5.1 → 2.0.0

package/dist/{chunk-HWVFJAAH.js → chunk-AMIR72JP.js}

@@ -160,6 +160,14 @@ function parseFrontmatter(yaml) {
   if (!yaml || !yaml.trim()) return null;
   const result = {};
   const lines = yaml.split("\n");
+  const assign = (key, value) => {
+    Object.defineProperty(result, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  };
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i];
     const trimmed = line.trim();
@@ -167,7 +175,7 @@ function parseFrontmatter(yaml) {
     const colonIdx = trimmed.indexOf(":");
     if (colonIdx < 1) continue;
     const key = trimmed.slice(0, colonIdx).trim();
-    let value = trimmed.slice(colonIdx + 1).trim();
+    const value = trimmed.slice(colonIdx + 1).trim();
     if (value === "|" || value === "|-") {
       const keyIndent = line.length - line.trimStart().length;
       const blockLines = [];
@@ -192,20 +200,29 @@ function parseFrontmatter(yaml) {
         commonIndent = Math.min(commonIndent, bl.length - bl.trimStart().length);
       }
       if (!isFinite(commonIndent)) commonIndent = 0;
-      result[key] = blockLines.map((bl) => bl === "" ? "" : bl.slice(commonIndent)).join("\n");
+      assign(key, blockLines.map((bl) => bl === "" ? "" : bl.slice(commonIndent)).join("\n"));
       continue;
     }
-    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-      value = value.slice(1, -1);
+    if (value.startsWith('"') && value.endsWith('"')) {
+      try {
+        assign(key, JSON.parse(value));
+      } catch {
+        assign(key, value.slice(1, -1));
+      }
+      continue;
+    }
+    if (value.startsWith("'") && value.endsWith("'")) {
+      assign(key, value.slice(1, -1).replace(/''/g, "'"));
+      continue;
     }
     if (value === "true") {
-      result[key] = true;
+      assign(key, true);
     } else if (value === "false") {
-      result[key] = false;
+      assign(key, false);
     } else if (value !== "" && !isNaN(Number(value))) {
-      result[key] = Number(value);
+      assign(key, Number(value));
     } else {
-      result[key] = value;
+      assign(key, value);
     }
   }
   return Object.keys(result).length > 0 ? result : null;
@@ -220,7 +237,7 @@ function formatFrontmatterValue(value) {
   if (typeof value === "boolean" || typeof value === "number") return String(value);
   if (/[\r\n]/.test(value)) return formatBlockScalar(value.replace(/\r\n?/g, "\n"));
   if (/^[{[]/.test(value) && !/[\r\n]/.test(value)) return value;
-  const needsQuote = /^\s|\s$/.test(value) || /^[!&*?|>%@`]/.test(value) || /[:#]/.test(value) || value === "" || value === "true" || value === "false" || /^-?\d+(\.\d+)?$/.test(value);
+  const needsQuote = /^\s|\s$/.test(value) || /^[!&*?|>%@`]/.test(value) || /[:#]/.test(value) || value === "" || value === "true" || value === "false" || value !== "" && !Number.isNaN(Number(value)) || /^["']/.test(value) && /["']$/.test(value);
   if (!needsQuote) return value;
   const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
   return `"${escaped}"`;
@@ -353,10 +370,11 @@ export {
   countNodes,
   parseFrontmatter,
   formatBlockScalar,
+  formatFrontmatterValue,
   setFrontmatterValues,
   createDocument,
   inferDocumentTitle,
   readFrontmatterThemeId,
   plainTextFromInlineHtml
 };
-//# sourceMappingURL=chunk-HWVFJAAH.js.map
+//# sourceMappingURL=chunk-AMIR72JP.js.map

package/dist/chunk-AMIR72JP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/markdown/htmlParse.ts","../src/markdown/utils.ts"],"sourcesContent":["/**\n * HTML ↔ HtmlNode Conversion\n *\n * Parses raw HTML strings into the squisq HtmlNode tree representation\n * using hast-util-from-html (parse5-backed), and serializes HtmlNode trees\n * back to HTML strings with a lightweight custom serializer.\n */\n\nimport { fromHtml } from 'hast-util-from-html';\nimport type { HtmlNode } from './types.js';\n\n// ============================================\n// Hast → HtmlNode conversion\n// ============================================\n\n/**\n * Mapping from hast DOM-style property names to HTML attribute names.\n * Only includes names where the property and attribute differ.\n */\nconst HAST_PROP_TO_ATTR: Record<string, string> = {\n  className: 'class',\n  htmlFor: 'for',\n  httpEquiv: 'http-equiv',\n  acceptCharset: 'accept-charset',\n};\n\n/** HTML void elements that are self-closing. */\nconst VOID_ELEMENTS = new Set([\n  'area',\n  'base',\n  'br',\n  'col',\n  'embed',\n  'hr',\n  'img',\n  'input',\n  'link',\n  'meta',\n  'param',\n  'source',\n  'track',\n  'wbr',\n]);\n\n/**\n * Convert a hast property name to an HTML attribute name.\n */\nfunction propertyToAttribute(prop: string): string {\n  if (HAST_PROP_TO_ATTR[prop]) return HAST_PROP_TO_ATTR[prop];\n\n  // data-* attributes: dataFooBar → data-foo-bar\n  if (prop.length > 4 && prop.startsWith('data') && prop[4] >= 'A' && prop[4] <= 'Z') {\n    return (\n      'data-' +\n      prop\n        .slice(4)\n        .replace(/[A-Z]/g, (m) => '-' + m.toLowerCase())\n        .replace(/^-/, '')\n    );\n  }\n\n  // aria-* attributes: ariaLabel → aria-label\n  if (prop.length > 4 && prop.startsWith('aria') && prop[4] >= 'A' && prop[4] <= 'Z') {\n    return (\n      'aria-' +\n      prop\n        .slice(4)\n        .replace(/[A-Z]/g, (m) => '-' + m.toLowerCase())\n        .replace(/^-/, '')\n    );\n  }\n\n  // Most HTML attributes are lowercase (tabIndex → tabindex, readOnly → readonly, etc.)\n  return prop.toLowerCase();\n}\n\n/**\n * Convert hast element properties to a flat HTML attribute map.\n */\nfunction convertHastProperties(properties: Record<string, unknown>): Record<string, string> {\n  const attrs: Record<string, string> = {};\n  for (const [key, value] of Object.entries(properties)) {\n    if (value === false || value === undefined || value === null) continue;\n\n    const attrName = propertyToAttribute(key);\n\n    if (value === true) {\n      attrs[attrName] = '';\n    } else if (Array.isArray(value)) {\n      attrs[attrName] = value.join(' ');\n    } else {\n      attrs[attrName] = String(value);\n    }\n  }\n  return attrs;\n}\n\n/**\n * Recursively convert hast child nodes to HtmlNode[].\n */\nfunction hastChildrenToNodes(children: unknown[]): HtmlNode[] {\n  const result: HtmlNode[] = [];\n  for (const child of children) {\n    const node = hastNodeToHtmlNode(child as Record<string, unknown>);\n    if (node) result.push(node);\n  }\n  return result;\n}\n\n/**\n * Convert a single hast node to an HtmlNode.\n */\nfunction hastNodeToHtmlNode(node: Record<string, unknown>): HtmlNode | null {\n  switch (node.type) {\n    case 'element': {\n      const tagName = node.tagName as string;\n      const properties = (node.properties ?? {}) as Record<string, unknown>;\n      const children = (node.children ?? []) as unknown[];\n      return {\n        type: 'htmlElement',\n        tagName,\n        attributes: convertHastProperties(properties),\n        children: hastChildrenToNodes(children),\n        selfClosing: VOID_ELEMENTS.has(tagName) && children.length === 0,\n      };\n    }\n    case 'text':\n      return {\n        type: 'htmlText',\n        value: node.value as string,\n      };\n    case 'comment':\n      return {\n        type: 'htmlComment',\n        value: node.value as string,\n      };\n    case 'doctype':\n      // Doctype nodes are rare in markdown HTML; skip them\n      return null;\n    default:\n      return null;\n  }\n}\n\n// ============================================\n// Public API\n// ============================================\n\n/**\n * Parse a raw HTML string into an HtmlNode[] tree.\n *\n * Uses the HTML5 parsing algorithm (via parse5) for correct handling of\n * self-closing tags, optional end tags, entity decoding, etc.\n *\n * @param html - Raw HTML string to parse\n * @returns Array of top-level HtmlNode elements\n */\nexport function parseHtmlToNodes(html: string): HtmlNode[] {\n  if (!html || !html.trim()) return [];\n\n  try {\n    const tree = fromHtml(html, { fragment: true });\n    return hastChildrenToNodes(tree.children as unknown[]);\n  } catch {\n    // If parsing fails, return the raw text as a single text node\n    return [{ type: 'htmlText', value: html }];\n  }\n}\n\n/**\n * Escape special characters in HTML attribute values.\n */\nfunction escapeHtmlAttr(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/\"/g, '&quot;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n}\n\n/**\n * Serialize an HtmlNode back to an HTML string.\n */\nfunction stringifyNode(node: HtmlNode): string {\n  switch (node.type) {\n    case 'htmlElement': {\n      const attrs = Object.entries(node.attributes)\n        .map(([k, v]) => (v === '' ? k : `${k}=\"${escapeHtmlAttr(v)}\"`))\n        .join(' ');\n      const open = attrs ? `<${node.tagName} ${attrs}>` : `<${node.tagName}>`;\n\n      if (node.selfClosing) return open;\n\n      const inner = node.children.map(stringifyNode).join('');\n      return `${open}${inner}</${node.tagName}>`;\n    }\n    case 'htmlText':\n      return node.value;\n    case 'htmlComment':\n      return `<!--${node.value}-->`;\n  }\n}\n\n/**\n * Serialize an HtmlNode[] tree back to an HTML string.\n *\n * @param nodes - Array of HtmlNode elements to serialize\n * @returns HTML string\n */\nexport function stringifyHtmlNodes(nodes: HtmlNode[]): string {\n  return nodes.map(stringifyNode).join('');\n}\n","/**\n * Markdown Tree Utilities\n *\n * Helper functions for traversing and querying the MarkdownDocument tree.\n * All functions are pure and operate on the JSON node interfaces.\n */\n\nimport type { MarkdownNode, MarkdownDocument, HtmlNode } from './types.js';\nimport { parseHtmlToNodes } from './htmlParse.js';\n\n/**\n * Get the children of any markdown node, if it has children.\n * Returns an empty array for leaf nodes (text, code, break, etc.).\n *\n * This is useful for generic tree walking where you don't want to\n * check the specific node type.\n */\nexport function getChildren(node: MarkdownNode): MarkdownNode[] {\n  if ('children' in node && Array.isArray(node.children)) {\n    return node.children as MarkdownNode[];\n  }\n  return [];\n}\n\n/**\n * Walk the markdown tree depth-first, calling the visitor for each node.\n *\n * The visitor receives the current node and its parent. Return `true`\n * from the visitor to skip the node's children (prune).\n *\n * @param node - The root node to start walking from\n * @param visitor - Called for each node; return true to skip children\n * @param parent - (internal) Parent node\n */\nexport function walkMarkdownTree(\n  node: MarkdownNode,\n  visitor: (node: MarkdownNode, parent?: MarkdownNode) => void | boolean,\n  parent?: MarkdownNode,\n): void {\n  const skip = visitor(node, parent);\n  if (skip === true) return;\n\n  const children = getChildren(node);\n  for (const child of children) {\n    walkMarkdownTree(child, visitor, node);\n  }\n}\n\n/**\n * Find all nodes of a specific type in the tree.\n *\n * @param root - The document or node to search within\n * @param type - The node type to find (e.g., 'heading', 'link', 'text')\n * @returns Array of matching nodes\n *\n * @example\n * ```ts\n * const headings = findNodesByType(doc, 'heading');\n * const links = findNodesByType(doc, 'link');\n * ```\n */\nexport function findNodesByType<T extends MarkdownNode>(root: MarkdownNode, type: T['type']): T[] {\n  const results: T[] = [];\n  walkMarkdownTree(root, (node) => {\n    if (node.type === type) {\n      results.push(node as T);\n    }\n  });\n  return results;\n}\n\n/**\n * Extract all plain text content from a node and its descendants.\n * Concatenates text values, ignoring formatting, links, etc.\n *\n * @param node - The node to extract text from\n * @returns Plain text content\n *\n * @example\n * ```ts\n * const heading = doc.children[0]; // { type: 'heading', children: [{ type: 'text', value: 'Hello' }] }\n * extractPlainText(heading); // 'Hello'\n * ```\n */\nexport function extractPlainText(node: MarkdownNode): string {\n  if ('value' in node && typeof node.value === 'string') {\n    return node.value;\n  }\n\n  const children = getChildren(node);\n  // Preserve boundaries between block-level elements (list items, paragraphs\n  // inside list items, blockquotes) so downstream consumers like caption\n  // splitting can treat each item as a separate phrase.\n  const separator = node.type === 'list' || node.type === 'listItem' ? '\\n' : '';\n  return children.map(extractPlainText).join(separator);\n}\n\n/**\n * Count the total number of nodes in the tree.\n *\n * @param node - The root node\n * @returns Total node count (including the root)\n */\nexport function countNodes(node: MarkdownNode): number {\n  let count = 1;\n  const children = getChildren(node);\n  for (const child of children) {\n    count += countNodes(child);\n  }\n  return count;\n}\n\n/**\n * Parse a YAML frontmatter string into a key-value record.\n *\n * Handles simple `key: value` pairs common in markdown frontmatter.\n * Values are trimmed; quoted strings have their quotes removed.\n * Returns `null` if parsing fails or the input is empty.\n *\n * @param yaml - The raw YAML string (without the `---` delimiters)\n * @returns A record of string keys to parsed values, or null\n */\nexport function parseFrontmatter(yaml: string): Record<string, unknown> | null {\n  if (!yaml || !yaml.trim()) return null;\n\n  const result: Record<string, unknown> = {};\n  const lines = yaml.split('\\n');\n\n  // Define keys as data properties so a frontmatter key named `__proto__`\n  // cannot invoke Object.prototype's legacy setter.\n  const assign = (key: string, value: unknown): void => {\n    Object.defineProperty(result, key, {\n      value,\n      enumerable: true,\n      configurable: true,\n      writable: true,\n    });\n  };\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n\n    const colonIdx = trimmed.indexOf(':');\n    if (colonIdx < 1) continue;\n\n    const key = trimmed.slice(0, colonIdx).trim();\n    const value = trimmed.slice(colonIdx + 1).trim();\n\n    // YAML literal block scalar: `key: |` or `key: |-`. Subsequent lines\n    // that are more-indented than the key belong to the scalar; they are\n    // dedented by their common leading indent and joined with `\\n`. A line\n    // at the key's indent (or less) ends the scalar. Both `|` and `|-`\n    // yield the joined string here (`|-` without a trailing newline); we do\n    // not model `|`'s trailing-newline / `+`/`-` chomping nuances beyond\n    // stripping trailing blank lines.\n    if (value === '|' || value === '|-') {\n      const keyIndent = line.length - line.trimStart().length;\n      const blockLines: string[] = [];\n      let j = i + 1;\n      for (; j < lines.length; j++) {\n        const bl = lines[j];\n        if (bl.trim() === '') {\n          blockLines.push('');\n          continue;\n        }\n        const indent = bl.length - bl.trimStart().length;\n        if (indent <= keyIndent) break; // dedent ends the scalar\n        blockLines.push(bl);\n      }\n      i = j - 1; // resume the outer walk at the terminating line\n\n      // Drop trailing blank lines captured inside the scalar.\n      while (blockLines.length > 0 && blockLines[blockLines.length - 1] === '') {\n        blockLines.pop();\n      }\n\n      // Dedent by the common leading whitespace of the non-blank lines.\n      let commonIndent = Infinity;\n      for (const bl of blockLines) {\n        if (bl === '') continue;\n        commonIndent = Math.min(commonIndent, bl.length - bl.trimStart().length);\n      }\n      if (!isFinite(commonIndent)) commonIndent = 0;\n      assign(key, blockLines.map((bl) => (bl === '' ? '' : bl.slice(commonIndent))).join('\\n'));\n      continue;\n    }\n\n    // Quoted scalars are always strings, even when their contents look like a\n    // number or boolean. Double-quoted values emitted by\n    // formatFrontmatterValue use JSON-compatible escaping; single-quoted YAML\n    // represents a literal quote as two consecutive quotes.\n    if (value.startsWith('\"') && value.endsWith('\"')) {\n      try {\n        assign(key, JSON.parse(value));\n      } catch {\n        // Be permissive for hand-authored YAML outside our formatter's subset.\n        assign(key, value.slice(1, -1));\n      }\n      continue;\n    }\n    if (value.startsWith(\"'\") && value.endsWith(\"'\")) {\n      assign(key, value.slice(1, -1).replace(/''/g, \"'\"));\n      continue;\n    }\n\n    // Parse booleans and numbers\n    if (value === 'true') {\n      assign(key, true);\n    } else if (value === 'false') {\n      assign(key, false);\n    } else if (value !== '' && !isNaN(Number(value))) {\n      assign(key, Number(value));\n    } else {\n      assign(key, value);\n    }\n  }\n\n  return Object.keys(result).length > 0 ? result : null;\n}\n\n/**\n * Format a multi-line string as a YAML literal block scalar body, i.e.\n * `|-` followed by each source line indented two spaces. Paired with\n * {@link parseFrontmatter}'s block-scalar reader so multi-line frontmatter\n * values (e.g. pretty-printed JSON payloads) round-trip. Blank lines stay\n * blank (no trailing whitespace) so the output diffs cleanly.\n */\nexport function formatBlockScalar(value: string): string {\n  const body = value\n    .split('\\n')\n    .map((line) => (line === '' ? '' : `  ${line}`))\n    .join('\\n');\n  return `|-\\n${body}`;\n}\n\nconst FRONTMATTER_BLOCK_RE = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---(\\r?\\n)?/;\n\n/** Quote a frontmatter scalar so it round-trips cleanly through `parseFrontmatter`. */\nexport function formatFrontmatterValue(value: string | number | boolean): string {\n  if (typeof value === 'boolean' || typeof value === 'number') return String(value);\n  // Multi-line strings can't live on one line — emit a YAML literal block\n  // scalar (`|-`) that `parseFrontmatter` reads back. This carries pretty-\n  // printed JSON payloads (opt-in custom templates/themes). Single-line\n  // values keep their exact historical output below.\n  if (/[\\r\\n]/.test(value)) return formatBlockScalar(value.replace(/\\r\\n?/g, '\\n'));\n  // A single-line JSON object/array literal round-trips verbatim through\n  // the line-based `parseFrontmatter` (no leading quote to strip, no\n  // newline to split on), so write it unquoted to keep it human-readable\n  // — matching how `stringifyMarkdown` emits string values. Used by the\n  // compact custom-layouts payload.\n  if (/^[{[]/.test(value) && !/[\\r\\n]/.test(value)) return value;\n  // Quote when needed: leading/trailing whitespace, leading punctuation that\n  // could trigger YAML modes, or values that look like reserved literals.\n  const needsQuote =\n    /^\\s|\\s$/.test(value) ||\n    /^[!&*?|>%@`]/.test(value) ||\n    /[:#]/.test(value) ||\n    value === '' ||\n    value === 'true' ||\n    value === 'false' ||\n    (value !== '' && !Number.isNaN(Number(value))) ||\n    (/^[\"']/.test(value) && /[\"']$/.test(value));\n  if (!needsQuote) return value;\n  // Prefer double quotes; escape any embedded double-quote / backslash.\n  const escaped = value.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"');\n  return `\"${escaped}\"`;\n}\n\n/**\n * Update a markdown source string's YAML frontmatter block, applying the\n * given key/value updates. A `null` or `undefined` value removes the key.\n * If no frontmatter block exists and any non-null update is supplied, a\n * new block is prepended; if every update is a removal and no block\n * exists, the source is returned unchanged.\n *\n * Existing key order is preserved; new keys are appended in the order\n * they appear in `updates`. The simple parser used here handles plain\n * `key: value` pairs only — comments, multi-line scalars, and nested\n * structures are left untouched (we only rewrite lines whose key matches\n * one in `updates`).\n *\n * @param source - The markdown source string.\n * @param updates - Map of key → new value (or null/undefined to remove).\n * @returns The updated markdown source string.\n */\nexport function setFrontmatterValues(\n  source: string,\n  updates: Record<string, string | number | boolean | null | undefined>,\n): string {\n  const updateKeys = Object.keys(updates);\n  if (updateKeys.length === 0) return source;\n\n  const match = source.match(FRONTMATTER_BLOCK_RE);\n  const handled = new Set<string>();\n\n  // Existing frontmatter block — rewrite line-by-line, preserving order.\n  if (match) {\n    const inner = match[1];\n    const lines = inner.split(/\\r?\\n/);\n    const newLines: string[] = [];\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed || trimmed.startsWith('#')) {\n        newLines.push(line);\n        continue;\n      }\n      const colonIdx = trimmed.indexOf(':');\n      if (colonIdx < 1) {\n        newLines.push(line);\n        continue;\n      }\n      const key = trimmed.slice(0, colonIdx).trim();\n      if (!Object.prototype.hasOwnProperty.call(updates, key)) {\n        newLines.push(line);\n        continue;\n      }\n      handled.add(key);\n      const next = updates[key];\n      if (next === null || next === undefined) continue; // remove\n      newLines.push(`${key}: ${formatFrontmatterValue(next)}`);\n    }\n\n    // Append any keys that weren't already present.\n    for (const key of updateKeys) {\n      if (handled.has(key)) continue;\n      const next = updates[key];\n      if (next === null || next === undefined) continue;\n      newLines.push(`${key}: ${formatFrontmatterValue(next)}`);\n    }\n\n    // If every line got removed, drop the block entirely.\n    const nonEmpty = newLines.filter((l) => l.trim().length > 0);\n    const rest = source.slice(match[0].length);\n    if (nonEmpty.length === 0) return rest;\n    return `---\\n${newLines.join('\\n')}\\n---\\n${rest}`;\n  }\n\n  // No existing block — only create one if there's at least one non-null\n  // value to write.\n  const fresh: string[] = [];\n  for (const key of updateKeys) {\n    const next = updates[key];\n    if (next === null || next === undefined) continue;\n    fresh.push(`${key}: ${formatFrontmatterValue(next)}`);\n  }\n  if (fresh.length === 0) return source;\n  return `---\\n${fresh.join('\\n')}\\n---\\n${source}`;\n}\n\n/**\n * Create a minimal MarkdownDocument from a list of block nodes.\n * Convenience function for programmatic document construction.\n */\nexport function createDocument(...children: MarkdownDocument['children']): MarkdownDocument {\n  return {\n    type: 'document',\n    children,\n  };\n}\n\n/**\n * Infer a human-readable title for a markdown document.\n *\n * Resolution order:\n *   1. `title:` value in YAML frontmatter (when present and non-empty)\n *   2. Text of the first heading found, walking top-level depth (H1, then\n *      H2, etc.) — the shallowest heading wins regardless of source order\n *\n * Returns `undefined` when no usable title is found.\n */\nexport function inferDocumentTitle(doc: MarkdownDocument): string | undefined {\n  const fmTitle = doc.frontmatter?.title;\n  if (typeof fmTitle === 'string') {\n    const trimmed = fmTitle.trim();\n    if (trimmed) return trimmed;\n  }\n\n  let best: { depth: number; text: string } | null = null;\n  for (const node of doc.children) {\n    if (node.type !== 'heading') continue;\n    const text = extractPlainText(node).trim();\n    if (!text) continue;\n    if (best === null || node.depth < best.depth) {\n      best = { depth: node.depth, text };\n      if (best.depth === 1) break;\n    }\n  }\n\n  return best?.text;\n}\n\n/**\n * Read a theme id from a markdown document's frontmatter.\n *\n * Checks the editor's canonical `squisq-theme` key first, then the\n * shorter legacy aliases (`themeId`, `theme`). Returns `undefined`\n * when none of them carry a non-empty string. Centralizing the lookup\n * keeps the export pipelines (DOCX, PPTX, HTML, plain-HTML bundle) in\n * sync with whatever the editor writes — adding a new frontmatter\n * spelling later is a one-file change.\n */\nexport function readFrontmatterThemeId(\n  frontmatter: Record<string, unknown> | undefined,\n): string | undefined {\n  if (!frontmatter) return undefined;\n  const keys = ['squisq-theme', 'themeId', 'theme'] as const;\n  for (const key of keys) {\n    const raw = frontmatter[key];\n    if (typeof raw === 'string') {\n      const trimmed = raw.trim();\n      if (trimmed) return trimmed;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Project an inline-HTML string (as stored on `TextLayer.content.html`) down\n * to plain text — the value mirrored into `content.text` for plain consumers\n * (PDF/markdown export, search, accessibility) and the SVG `<text>` fallback.\n *\n * `<br>` and block-level tags (`p`, `div`, `h1`–`h6`, `li`, `blockquote`,\n * `pre`) become line breaks so multi-line rich content reads sensibly. Entity\n * decoding is handled by {@link parseHtmlToNodes} (parse5-backed), so this is\n * more correct than a regex tag-stripper.\n */\nexport function plainTextFromInlineHtml(html: string): string {\n  const BLOCK = new Set([\n    'p',\n    'div',\n    'h1',\n    'h2',\n    'h3',\n    'h4',\n    'h5',\n    'h6',\n    'li',\n    'blockquote',\n    'pre',\n  ]);\n  const walk = (nodes: HtmlNode[]): string =>\n    nodes\n      .map((n) => {\n        if (n.type === 'htmlText') return n.value;\n        if (n.type !== 'htmlElement') return '';\n        const tag = n.tagName.toLowerCase();\n        if (tag === 'br') return '\\n';\n        const inner = walk(n.children);\n        return BLOCK.has(tag) ? `${inner}\\n` : inner;\n      })\n      .join('');\n  return walk(parseHtmlToNodes(html))\n    .replace(/\\u00A0/g, ' ')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-FVJUUTEM.js

@@ -0,0 +1,74 @@
+// src/schemas/Media.ts
+function flatten(blocks, out = []) {
+  for (const b of blocks) {
+    out.push(b);
+    if (b.children && b.children.length > 0) flatten(b.children, out);
+  }
+  return out;
+}
+function clipLength(clip) {
+  if (clip.clipEnd == null) return null;
+  return Math.max(0, clip.clipEnd - (clip.clipStart ?? 0));
+}
+function baseTimelineEnd(doc) {
+  const blockEnd = flatten(doc.blocks).reduce(
+    (max, b) => Math.max(max, b.startTime + b.duration),
+    0
+  );
+  return Math.max(doc.duration ?? 0, blockEnd);
+}
+function resolveMediaSchedule(doc) {
+  const out = [];
+  const docEnd = baseTimelineEnd(doc);
+  for (const block of flatten(doc.blocks)) {
+    const blockEnd = block.startTime + block.duration;
+    for (const clip of block.media ?? []) {
+      const start = block.startTime + clip.startAt;
+      const len = clipLength(clip);
+      let end;
+      if (clip.spillover) {
+        end = len != null ? start + len : blockEnd;
+      } else {
+        end = len != null ? Math.min(start + len, blockEnd) : blockEnd;
+      }
+      out.push({
+        id: clip.id,
+        src: clip.src,
+        kind: clip.kind,
+        absoluteStart: start,
+        absoluteEnd: Math.max(start, end),
+        sourceIn: clip.clipStart ?? 0,
+        anchor: "block",
+        blockId: block.id,
+        ...clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}
+      });
+    }
+  }
+  for (const clip of doc.documentMedia ?? []) {
+    const start = clip.startAt;
+    const len = clipLength(clip);
+    const end = len != null ? start + len : docEnd;
+    out.push({
+      id: clip.id,
+      src: clip.src,
+      kind: clip.kind,
+      absoluteStart: start,
+      absoluteEnd: Math.max(start, end),
+      sourceIn: clip.clipStart ?? 0,
+      anchor: "document",
+      ...clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}
+    });
+  }
+  return out;
+}
+function getDocPlaybackDuration(doc) {
+  const base = baseTimelineEnd(doc);
+  const mediaEnd = resolveMediaSchedule(doc).reduce((max, c) => Math.max(max, c.absoluteEnd), 0);
+  return Math.max(base, mediaEnd);
+}
+
+export {
+  resolveMediaSchedule,
+  getDocPlaybackDuration
+};
+//# sourceMappingURL=chunk-FVJUUTEM.js.map

package/dist/chunk-FVJUUTEM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/Media.ts"],"sourcesContent":["/**\n * Media-clip timing model.\n *\n * An additive layer on top of the simple sequential `Doc.audio.segments[]`\n * narration track, which remains first-class. A {@link MediaClip} is a piece\n * of audio or video whose\n * timing is expressed *relative to its parent block* (or the whole document),\n * with an optional `startAt` offset and an optional `spillover` past the\n * block's end. {@link resolveMediaSchedule} flattens these into absolute,\n * doc-timeline `ScheduledClip`s that playback and export consume.\n *\n * Authoring: a body-level `{[audio …]}` / `{[video …]}` annotation inside a\n * block becomes a `block.media` clip; the same annotation in the preamble\n * (before the first heading) with `anchor=document` becomes a\n * `doc.documentMedia` clip that spans the whole timeline.\n */\n\nimport type { Block, Doc } from './Doc.js';\n\n/**\n * A timed piece of media attached to a block (or the document).\n */\nexport interface MediaClip {\n  /** Stable id (for React keys and timeline selection). */\n  id: string;\n  /** Source path (mp3/mp4/…), relative to the article media dir. */\n  src: string;\n  kind: 'audio' | 'video';\n  /**\n   * Seconds from the parent block's start when this clip begins. For an\n   * `anchor='document'` clip, seconds from the document start. Default 0.\n   */\n  startAt: number;\n  /** Source in-point within the file (seconds). Default 0. */\n  clipStart?: number;\n  /** Source out-point within the file (seconds). Default: file/block end. */\n  clipEnd?: number;\n  /**\n   * When false (default) the clip stops at its block's end. When true it\n   * keeps playing past the block boundary until the clip itself finishes.\n   * Ignored for `anchor='document'` clips (they already span the timeline).\n   */\n  spillover?: boolean;\n  /**\n   * `'block'` (default) — timed relative to the parent block. `'document'` —\n   * timed relative to the document start and able to span every block.\n   */\n  anchor: 'block' | 'document';\n  /**\n   * 1-based source line of the authoring annotation, when derived from\n   * markdown. Enables round-tripping edits (e.g. the timeline editor rewriting\n   * `startAt`) back to the exact line. Absent for programmatically built clips.\n   */\n  sourceLine?: number;\n  /**\n   * Round-trip home of the authoring annotation: the block whose contents\n   * held the paragraph, its position in that block's ORIGINAL contents\n   * array (before extraction), and the paragraph's exact source text.\n   * `docToMarkdown` re-inserts the annotation from this — `raw` verbatim\n   * when present, a re-serialized annotation otherwise. Absent for\n   * programmatically built clips (those emit at the document top).\n   */\n  origin?: { blockId: string; index: number; raw?: string };\n}\n\n/**\n * A {@link MediaClip} resolved to absolute document-timeline coordinates.\n * Produced by {@link resolveMediaSchedule}; consumed by the playback\n * scheduler and the MP4 export.\n */\nexport interface ScheduledClip {\n  id: string;\n  src: string;\n  kind: 'audio' | 'video';\n  /** Absolute doc-timeline second the clip starts. */\n  absoluteStart: number;\n  /** Absolute doc-timeline second the clip ends (exclusive). */\n  absoluteEnd: number;\n  /** Source in-point to seek to at `absoluteStart`. */\n  sourceIn: number;\n  anchor: 'block' | 'document';\n  /** Owning block id for block-anchored clips (for video re-homing/export). */\n  blockId?: string;\n  /** 1-based source line of the authoring annotation, when known. */\n  sourceLine?: number;\n}\n\n/** Depth-first flatten of the block tree (local copy to avoid a doc-layer dep). */\nfunction flatten(blocks: Block[], out: Block[] = []): Block[] {\n  for (const b of blocks) {\n    out.push(b);\n    if (b.children && b.children.length > 0) flatten(b.children, out);\n  }\n  return out;\n}\n\n/** Played length of a clip when known from its in/out points, else null. */\nfunction clipLength(clip: MediaClip): number | null {\n  if (clip.clipEnd == null) return null;\n  return Math.max(0, clip.clipEnd - (clip.clipStart ?? 0));\n}\n\n/**\n * Base playback span ignoring media — the larger of the audio-segment sum\n * and the last block's end. Document clips that don't pin a length run to\n * this point.\n */\nfunction baseTimelineEnd(doc: Doc): number {\n  const blockEnd = flatten(doc.blocks).reduce(\n    (max, b) => Math.max(max, b.startTime + b.duration),\n    0,\n  );\n  return Math.max(doc.duration ?? 0, blockEnd);\n}\n\n/**\n * Flatten every block clip and document clip into absolute-timed\n * `ScheduledClip`s. Pure — depends only on `doc`.\n */\nexport function resolveMediaSchedule(doc: Doc): ScheduledClip[] {\n  const out: ScheduledClip[] = [];\n  const docEnd = baseTimelineEnd(doc);\n\n  for (const block of flatten(doc.blocks)) {\n    const blockEnd = block.startTime + block.duration;\n    for (const clip of block.media ?? []) {\n      const start = block.startTime + clip.startAt;\n      const len = clipLength(clip);\n      let end: number;\n      if (clip.spillover) {\n        // Continue past the block; fall back to the block end when the\n        // played length is unknown (no clipEnd authored).\n        end = len != null ? start + len : blockEnd;\n      } else {\n        end = len != null ? Math.min(start + len, blockEnd) : blockEnd;\n      }\n      out.push({\n        id: clip.id,\n        src: clip.src,\n        kind: clip.kind,\n        absoluteStart: start,\n        absoluteEnd: Math.max(start, end),\n        sourceIn: clip.clipStart ?? 0,\n        anchor: 'block',\n        blockId: block.id,\n        ...(clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}),\n      });\n    }\n  }\n\n  for (const clip of doc.documentMedia ?? []) {\n    const start = clip.startAt;\n    const len = clipLength(clip);\n    const end = len != null ? start + len : docEnd;\n    out.push({\n      id: clip.id,\n      src: clip.src,\n      kind: clip.kind,\n      absoluteStart: start,\n      absoluteEnd: Math.max(start, end),\n      sourceIn: clip.clipStart ?? 0,\n      anchor: 'document',\n      ...(clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}),\n    });\n  }\n\n  return out;\n}\n\n/**\n * Total playback duration including any media that spills past the last\n * block (or audio segment). Export uses this for the frame count and the\n * player for its effective timeline length.\n */\nexport function getDocPlaybackDuration(doc: Doc): number {\n  const base = baseTimelineEnd(doc);\n  const mediaEnd = resolveMediaSchedule(doc).reduce((max, c) => Math.max(max, c.absoluteEnd), 0);\n  return Math.max(base, mediaEnd);\n}\n"],"mappings":";AAwFA,SAAS,QAAQ,QAAiB,MAAe,CAAC,GAAY;AAC5D,aAAW,KAAK,QAAQ;AACtB,QAAI,KAAK,CAAC;AACV,QAAI,EAAE,YAAY,EAAE,SAAS,SAAS,EAAG,SAAQ,EAAE,UAAU,GAAG;AAAA,EAClE;AACA,SAAO;AACT;AAGA,SAAS,WAAW,MAAgC;AAClD,MAAI,KAAK,WAAW,KAAM,QAAO;AACjC,SAAO,KAAK,IAAI,GAAG,KAAK,WAAW,KAAK,aAAa,EAAE;AACzD;AAOA,SAAS,gBAAgB,KAAkB;AACzC,QAAM,WAAW,QAAQ,IAAI,MAAM,EAAE;AAAA,IACnC,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,YAAY,EAAE,QAAQ;AAAA,IAClD;AAAA,EACF;AACA,SAAO,KAAK,IAAI,IAAI,YAAY,GAAG,QAAQ;AAC7C;AAMO,SAAS,qBAAqB,KAA2B;AAC9D,QAAM,MAAuB,CAAC;AAC9B,QAAM,SAAS,gBAAgB,GAAG;AAElC,aAAW,SAAS,QAAQ,IAAI,MAAM,GAAG;AACvC,UAAM,WAAW,MAAM,YAAY,MAAM;AACzC,eAAW,QAAQ,MAAM,SAAS,CAAC,GAAG;AACpC,YAAM,QAAQ,MAAM,YAAY,KAAK;AACrC,YAAM,MAAM,WAAW,IAAI;AAC3B,UAAI;AACJ,UAAI,KAAK,WAAW;AAGlB,cAAM,OAAO,OAAO,QAAQ,MAAM;AAAA,MACpC,OAAO;AACL,cAAM,OAAO,OAAO,KAAK,IAAI,QAAQ,KAAK,QAAQ,IAAI;AAAA,MACxD;AACA,UAAI,KAAK;AAAA,QACP,IAAI,KAAK;AAAA,QACT,KAAK,KAAK;AAAA,QACV,MAAM,KAAK;AAAA,QACX,eAAe;AAAA,QACf,aAAa,KAAK,IAAI,OAAO,GAAG;AAAA,QAChC,UAAU,KAAK,aAAa;AAAA,QAC5B,QAAQ;AAAA,QACR,SAAS,MAAM;AAAA,QACf,GAAI,KAAK,cAAc,OAAO,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,MACnE,CAAC;AAAA,IACH;AAAA,EACF;AAEA,aAAW,QAAQ,IAAI,iBAAiB,CAAC,GAAG;AAC1C,UAAM,QAAQ,KAAK;AACnB,UAAM,MAAM,WAAW,IAAI;AAC3B,UAAM,MAAM,OAAO,OAAO,QAAQ,MAAM;AACxC,QAAI,KAAK;AAAA,MACP,IAAI,KAAK;AAAA,MACT,KAAK,KAAK;AAAA,MACV,MAAM,KAAK;AAAA,MACX,eAAe;AAAA,MACf,aAAa,KAAK,IAAI,OAAO,GAAG;AAAA,MAChC,UAAU,KAAK,aAAa;AAAA,MAC5B,QAAQ;AAAA,MACR,GAAI,KAAK,cAAc,OAAO,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,IACnE,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAOO,SAAS,uBAAuB,KAAkB;AACvD,QAAM,OAAO,gBAAgB,GAAG;AAChC,QAAM,WAAW,qBAAqB,GAAG,EAAE,OAAO,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,WAAW,GAAG,CAAC;AAC7F,SAAO,KAAK,IAAI,MAAM,QAAQ;AAChC;","names":[]}