@bendyline/squisq 1.5.2 → 2.0.0

package/dist/chunk-R2GC6RLD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/markdown/stringify.ts","../src/markdown/sanitize.ts"],"sourcesContent":["/**\n * JSON → Markdown Serializer\n *\n * Converts a MarkdownDocument JSON structure back to a markdown string\n * using the unified/remark ecosystem with GFM, math, and directive extensions.\n */\n\nimport { unified } from 'unified';\nimport remarkStringify from 'remark-stringify';\nimport remarkGfm from 'remark-gfm';\nimport remarkMath from 'remark-math';\nimport remarkDirective from 'remark-directive';\nimport type { MarkdownDocument, StringifyOptions } from './types.js';\nimport { toMdast } from './convert.js';\nimport { formatFrontmatterValue } from './utils.js';\n\n// Cache the default processor (all extensions, default formatting) to avoid rebuilding on every call.\nlet defaultProcessor: any;\n\n// ============================================\n// Annotation-span unescaping\n// ============================================\n\n// Quoted runs as they appear in remark-stringify output. Backslashes inside\n// the span are doubled by remark (a literal `\\` before punctuation becomes\n// `\\\\`), so `\\\\.` covers both authored escapes and remark's own.\nconst DQ_RUN = `\"(?:[^\"\\\\\\\\]|\\\\\\\\.)*\"`;\nconst SQ_RUN = `'(?:[^'\\\\\\\\]|\\\\\\\\.)*'`;\n\n/**\n * A `{[…]}` template-annotation (or inline-icon) span as it appears in\n * remark output: `{\\[inner]}`, where `inner` may contain backslash escapes\n * and quoted runs (which may themselves contain `]`).\n */\nconst ESCAPED_TEMPLATE_SPAN_RE = new RegExp(\n  `\\\\{\\\\\\\\\\\\[((?:${DQ_RUN}|${SQ_RUN}|\\\\\\\\.|[^\\\\]\\\\\\\\])*)\\\\]\\\\}`,\n  'g',\n);\n\n/** A heading line (annotations are only emitted trailing on headings). */\nconst HEADING_LINE_RE = /^#{1,6} .*$/gm;\n\n/**\n * The trailing Pandoc `{…}` span on a heading line, possibly followed by an\n * already-unescaped `{[…]}` template span (canonical emit order).\n */\nconst TRAILING_ESCAPED_PANDOC_SPAN_RE = new RegExp(\n  `\\\\{(?!\\\\\\\\?\\\\[)((?:${DQ_RUN}|${SQ_RUN}|\\\\\\\\.|[^}\\\\\\\\])*)\\\\}(?=\\\\s*(?:\\\\{\\\\[.*)?$)`,\n);\n\n/**\n * Backslash+punctuation pairs that are safe to unescape inside an\n * annotation span: the bare character re-parses as literal text in\n * trailing-heading position, so removing the backslash is purely\n * cosmetic and round-trips.\n *\n * Deliberately EXCLUDED (left escaped in the emitted markdown): emphasis\n * and other inline-construct openers (`*`, `_`, `` ` ``, `~`, `<`, `>`,\n * `&`, `!`, `|`, `^`). Unescaping those could make remark-parse split the\n * heading's text run into inline nodes on reparse, which would hide the\n * annotation from the extractor. remark-parse resolves the surviving\n * `\\X` escapes back to bare characters, so values still round-trip —\n * the escapes are a cosmetic cost only.\n *\n * Pairs are consumed left to right, so an authored `\\\"` that remark\n * doubled to `\\\\\"` correctly comes back as `\\\"`.\n */\nconst UNESCAPE_PUNCT_RE = /\\\\([\\\\[\\]:#.,+=/?;@%$(){}'\"-])/g;\n\nfunction unescapeMarkdownPunct(text: string): string {\n  return text.replace(UNESCAPE_PUNCT_RE, '$1');\n}\n\n/**\n * Serialize a MarkdownDocument back to a markdown string.\n *\n * All extensions (GFM, math, directives) are enabled by default.\n * Use the `options` parameter to control formatting and disable extensions.\n *\n * @param doc - The MarkdownDocument to serialize\n * @param options - Serialization options (formatting, extensions)\n * @returns A markdown string\n *\n * @example\n * ```ts\n * const doc: MarkdownDocument = {\n *   type: 'document',\n *   children: [\n *     { type: 'heading', depth: 1, children: [{ type: 'text', value: 'Hello' }] },\n *     { type: 'paragraph', children: [{ type: 'text', value: 'World' }] },\n *   ],\n * };\n * const md = stringifyMarkdown(doc);\n * // '# Hello\\n\\nWorld\\n'\n * ```\n */\nexport function stringifyMarkdown(doc: MarkdownDocument, options?: StringifyOptions): string {\n  // Convert MarkdownDocument → mdast tree\n  const mdastTree = toMdast(doc);\n\n  // Use cached default processor when all extensions and default formatting are used.\n  const useDefaults =\n    !options ||\n    (options.gfm !== false &&\n      options.math !== false &&\n      options.directive !== false &&\n      !options.bullet &&\n      !options.bulletOrdered &&\n      !options.emphasis &&\n      !options.strong &&\n      !options.rule &&\n      !options.fence &&\n      options.setext == null);\n\n  let processor: any;\n\n  if (useDefaults) {\n    if (!defaultProcessor) {\n      defaultProcessor = unified()\n        .use(remarkGfm)\n        .use(remarkMath)\n        .use(remarkDirective)\n        .use(remarkStringify, {\n          bullet: '-',\n          bulletOrdered: '.',\n          emphasis: '*',\n          strong: '*',\n          rule: '-',\n          fence: '`',\n          setext: false,\n        });\n    }\n    processor = defaultProcessor;\n  } else {\n    // Build a custom processor with requested options.\n    // unified's .use() chaining changes the generic signature each time,\n    // making strict typing impractical — use a widened Processor type.\n    processor = unified();\n\n    if (options?.gfm !== false) {\n      processor = processor.use(remarkGfm);\n    }\n    if (options?.math !== false) {\n      processor = processor.use(remarkMath);\n    }\n    if (options?.directive !== false) {\n      processor = processor.use(remarkDirective);\n    }\n\n    processor = processor.use(remarkStringify, {\n      bullet: options?.bullet ?? '-',\n      bulletOrdered: options?.bulletOrdered ?? '.',\n      emphasis: options?.emphasis ?? '*',\n      strong: options?.strong ?? '*',\n      rule: options?.rule ?? '-',\n      fence: options?.fence ?? '`',\n      setext: options?.setext ?? false,\n    });\n  }\n\n  // Stringify mdast → markdown string\n  const result = processor.stringify(mdastTree) as string;\n\n  // remark-stringify backslash-escapes markdown-significant characters in\n  // text nodes (`[` to prevent link syntax, `:` for directives, `*`/`_` for\n  // emphasis, a literal `\\` before punctuation, …). Our annotations are\n  // injected as plain text, so their interiors come back escaped. Undo that\n  // inside `{[…]}` template-annotation spans: removing one backslash from\n  // each backslash+punctuation pair (left to right) exactly inverts\n  // remark's escaping — including restoring an authored `\\\"` that remark\n  // doubled to `\\\\\"`. The span regex understands quoted values, so a\n  // quoted `]` doesn't terminate the span.\n  let cleaned = result.replace(\n    ESCAPED_TEMPLATE_SPAN_RE,\n    (_m, inner: string) => `{[${unescapeMarkdownPunct(inner)}]}`,\n  );\n\n  // Same treatment for the trailing Pandoc `{…}` attribute block on heading\n  // lines (canonical emit order is Pandoc block then template annotation,\n  // so the span sits at end-of-line or just before a `{[…]}` span).\n  cleaned = cleaned.replace(HEADING_LINE_RE, (line) =>\n    line.replace(\n      TRAILING_ESCAPED_PANDOC_SPAN_RE,\n      (_m, inner: string) => `{${unescapeMarkdownPunct(inner)}}`,\n    ),\n  );\n\n  // remark-directive escapes `:` in text (since `:name` would round-trip as\n  // a text directive). Inside any other Pandoc-style `{…}` brace span, `:`\n  // is purely a value separator (e.g. `connectsTo=foo:flow`), so unescape\n  // it to keep round-trips lossless. The negative lookahead skips `{[…]}`\n  // template annotations — those are handled above.\n  cleaned = cleaned.replace(/\\{(?!\\\\?\\[)[^}]*\\}/g, (match) => match.replace(/\\\\:/g, ':'));\n\n  // Prepend YAML frontmatter if present\n  if (doc.frontmatter && Object.keys(doc.frontmatter).length > 0) {\n    const yamlLines = Object.entries(doc.frontmatter).map(([k, v]) => {\n      if (typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean') {\n        return `${k}: ${formatFrontmatterValue(v)}`;\n      }\n      return `${k}: ${JSON.stringify(v)}`;\n    });\n    return `---\\n${yamlLines.join('\\n')}\\n---\\n\\n${cleaned}`;\n  }\n\n  return cleaned;\n}\n","import type { HtmlElement, HtmlNode } from './types.js';\n\nexport type HtmlPolicy = 'strip' | 'sanitize' | 'trusted';\n\nexport type UrlKind = 'link' | 'media';\n\nconst SAFE_LINK_SCHEMES = new Set(['http', 'https', 'mailto', 'tel']);\nconst SAFE_MEDIA_SCHEMES = new Set(['http', 'https', 'blob']);\n\n/** Schemes that can execute script — never allowed, even via extraLinkSchemes. */\nconst NEVER_ALLOWED_SCHEMES = new Set(['javascript', 'vbscript', 'data']);\n\nexport interface SanitizeUrlOptions {\n  /**\n   * Extra lowercase schemes allowed for `kind: 'link'` — the host-app escape\n   * hatch for custom link protocols it intercepts itself (e.g. an app-internal\n   * navigation scheme). Executable schemes are refused regardless.\n   */\n  extraLinkSchemes?: readonly string[];\n}\n\nconst SAFE_DATA_MEDIA_RE =\n  /^data:(?:image\\/(?!svg\\+xml)[a-z0-9.+-]+|audio\\/[a-z0-9.+-]+|video\\/[a-z0-9.+-]+);/i;\n\nconst SAFE_TAGS = new Set([\n  'a',\n  'abbr',\n  'b',\n  'blockquote',\n  'br',\n  'caption',\n  'cite',\n  'code',\n  'col',\n  'colgroup',\n  'data',\n  'dd',\n  'del',\n  'details',\n  'dfn',\n  'div',\n  'dl',\n  'dt',\n  'em',\n  'figcaption',\n  'figure',\n  'h1',\n  'h2',\n  'h3',\n  'h4',\n  'h5',\n  'h6',\n  'hr',\n  'i',\n  'img',\n  'kbd',\n  'li',\n  'mark',\n  'ol',\n  'p',\n  'pre',\n  'q',\n  's',\n  'samp',\n  'small',\n  'source',\n  'span',\n  'strong',\n  'sub',\n  'summary',\n  'sup',\n  'table',\n  'tbody',\n  'td',\n  'tfoot',\n  'th',\n  'thead',\n  'time',\n  'tr',\n  'track',\n  'u',\n  'ul',\n  'var',\n  'video',\n  'audio',\n]);\n\nconst DROP_WITH_CONTENT_TAGS = new Set([\n  'base',\n  'button',\n  'embed',\n  'form',\n  'iframe',\n  'input',\n  'link',\n  'meta',\n  'object',\n  'option',\n  'script',\n  'select',\n  'style',\n  'svg',\n  'template',\n  'textarea',\n]);\n\nconst GLOBAL_ATTRS = new Set(['class', 'id', 'title', 'role']);\n\nconst TAG_ATTRS: Record<string, Set<string>> = {\n  a: new Set(['href', 'target', 'rel']),\n  audio: new Set(['src', 'controls', 'preload', 'muted', 'loop']),\n  col: new Set(['span', 'width']),\n  colgroup: new Set(['span']),\n  data: new Set(['value']),\n  img: new Set(['src', 'alt', 'width', 'height', 'loading', 'decoding']),\n  li: new Set(['value']),\n  ol: new Set(['start', 'type']),\n  q: new Set(['cite']),\n  source: new Set(['src', 'type', 'media']),\n  td: new Set(['colspan', 'rowspan', 'align']),\n  th: new Set(['colspan', 'rowspan', 'align', 'scope']),\n  time: new Set(['datetime']),\n  track: new Set(['src', 'kind', 'label', 'srclang', 'default']),\n  video: new Set([\n    'src',\n    'poster',\n    'width',\n    'height',\n    'controls',\n    'preload',\n    'muted',\n    'loop',\n    'playsinline',\n  ]),\n};\n\nconst SAFE_ATTR_NAME_RE = /^[a-z][a-z0-9:_.-]*$/;\nconst SAFE_OL_TYPES = new Set(['1', 'a', 'A', 'i', 'I']);\nconst SAFE_PRELOAD_VALUES = new Set(['none', 'metadata', 'auto']);\nconst SAFE_TRACK_KINDS = new Set(['subtitles', 'captions', 'descriptions', 'chapters', 'metadata']);\n\n/**\n * Sanitize a URL for a rendered link or media attribute.\n *\n * Relative URLs are allowed. Absolute URLs are restricted to schemes that\n * cannot execute script in a document context. Media URLs additionally allow\n * `blob:` and image/audio/video `data:` URLs because Squisq uses both for\n * browser-local media previews and self-contained exports.\n */\nexport function sanitizeUrl(\n  url: string | null | undefined,\n  kind: UrlKind = 'link',\n  options?: SanitizeUrlOptions,\n): string | null {\n  if (typeof url !== 'string') return null;\n\n  const trimmed = url.trim();\n  if (!trimmed) return null;\n\n  const compact = stripUrlSchemeNoise(trimmed);\n  const colon = compact.indexOf(':');\n  const firstPathChar = firstIndexOfAny(compact, ['/', '?', '#']);\n  const hasScheme = colon >= 0 && (firstPathChar < 0 || colon < firstPathChar);\n\n  if (!hasScheme) return trimmed;\n\n  const scheme = compact.slice(0, colon).toLowerCase();\n  if (kind === 'media') {\n    if (scheme === 'data') return SAFE_DATA_MEDIA_RE.test(compact) ? trimmed : null;\n    return SAFE_MEDIA_SCHEMES.has(scheme) ? trimmed : null;\n  }\n\n  if (SAFE_LINK_SCHEMES.has(scheme)) return trimmed;\n  if (options?.extraLinkSchemes?.includes(scheme) && !NEVER_ALLOWED_SCHEMES.has(scheme)) {\n    return trimmed;\n  }\n  return null;\n}\n\n/**\n * Return a sanitized copy of an HtmlNode tree. The original parsed tree is left\n * untouched so markdown stringify can still preserve source fidelity.\n */\nexport function sanitizeHtmlNodes(nodes: HtmlNode[]): HtmlNode[] {\n  const out: HtmlNode[] = [];\n  for (const node of nodes) {\n    out.push(...sanitizeHtmlNode(node));\n  }\n  return out;\n}\n\nfunction sanitizeHtmlNode(node: HtmlNode): HtmlNode[] {\n  switch (node.type) {\n    case 'htmlText':\n      return [node];\n    case 'htmlComment':\n      return [];\n    case 'htmlElement':\n      return sanitizeHtmlElement(node);\n  }\n}\n\nfunction sanitizeHtmlElement(node: HtmlElement): HtmlNode[] {\n  const tag = node.tagName.toLowerCase();\n\n  if (DROP_WITH_CONTENT_TAGS.has(tag)) return [];\n\n  const children = sanitizeHtmlNodes(node.children);\n  if (!SAFE_TAGS.has(tag)) return children;\n\n  return [\n    {\n      type: 'htmlElement',\n      tagName: tag,\n      attributes: sanitizeAttrs(tag, node.attributes),\n      children,\n      selfClosing: node.selfClosing,\n    },\n  ];\n}\n\nfunction sanitizeAttrs(tag: string, attrs: Record<string, string>): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [rawName, rawValue] of Object.entries(attrs)) {\n    const name = rawName.toLowerCase();\n    if (!isAllowedAttr(tag, name)) continue;\n\n    const value = String(rawValue);\n    const safeValue = sanitizeAttrValue(tag, name, value);\n    if (safeValue === null) continue;\n    out[name] = safeValue;\n  }\n  if (tag === 'a' && out.target === '_blank') {\n    out.rel = ensureRelTokens(out.rel, ['noopener', 'noreferrer']);\n  }\n  return out;\n}\n\nfunction isAllowedAttr(tag: string, name: string): boolean {\n  if (!SAFE_ATTR_NAME_RE.test(name)) return false;\n  if (name.startsWith('on')) return false;\n  if (name.startsWith('aria-') || name.startsWith('data-')) return true;\n  if (GLOBAL_ATTRS.has(name)) return true;\n  return TAG_ATTRS[tag]?.has(name) ?? false;\n}\n\nfunction sanitizeAttrValue(tag: string, name: string, value: string): string | null {\n  if (name === 'href') return sanitizeUrl(value, 'link');\n  if (name === 'src' || name === 'poster') return sanitizeUrl(value, 'media');\n  if (\n    (name === 'width' ||\n      name === 'height' ||\n      name === 'span' ||\n      name === 'colspan' ||\n      name === 'rowspan' ||\n      name === 'value') &&\n    !isNonNegativeInteger(value)\n  ) {\n    return null;\n  }\n  if (name === 'start' && !isInteger(value)) return null;\n  if (name === 'type' && tag === 'ol' && !SAFE_OL_TYPES.has(value)) return null;\n  if (name === 'preload' && !SAFE_PRELOAD_VALUES.has(value)) return null;\n  if (name === 'kind' && tag === 'track' && !SAFE_TRACK_KINDS.has(value)) return null;\n  if (name === 'align' && value !== 'left' && value !== 'right' && value !== 'center') return null;\n  if (name === 'target')\n    return value === '_blank' || value === '_self' || value === '_parent' || value === '_top'\n      ? value\n      : null;\n  if (name === 'rel') return sanitizeRel(value);\n  return value;\n}\n\nfunction sanitizeRel(value: string): string {\n  return relTokens(value).join(' ');\n}\n\nfunction ensureRelTokens(value: string | undefined, required: string[]): string {\n  const tokens = new Set(value ? relTokens(value) : []);\n  for (const token of required) tokens.add(token);\n  return Array.from(tokens).join(' ');\n}\n\nfunction relTokens(value: string): string[] {\n  const tokens = value\n    .split(/\\s+/)\n    .map((token) => token.trim().toLowerCase())\n    .filter(Boolean)\n    .filter((token) => /^[a-z0-9_-]+$/.test(token));\n  return Array.from(new Set(tokens));\n}\n\nfunction isInteger(value: string): boolean {\n  return /^-?\\d+$/.test(value.trim());\n}\n\nfunction isNonNegativeInteger(value: string): boolean {\n  return /^\\d+$/.test(value.trim());\n}\n\nfunction firstIndexOfAny(value: string, needles: string[]): number {\n  let result = -1;\n  for (const needle of needles) {\n    const index = value.indexOf(needle);\n    if (index >= 0 && (result < 0 || index < result)) result = index;\n  }\n  return result;\n}\n\nfunction stripUrlSchemeNoise(value: string): string {\n  let out = '';\n  for (const char of value) {\n    const code = char.charCodeAt(0);\n    if (code <= 0x20 || code === 0x7f || char.trim() === '') continue;\n    out += char;\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-R2YZTCLO.js

@@ -0,0 +1,292 @@
+import {
+  TRANSITION_DIRECTIONS,
+  TRANSITION_TYPES,
+  normalizeTransitionDirection,
+  normalizeTransitionType
+} from "./chunk-QE7TWGVT.js";
+
+// src/markdown/annotationCoercion.ts
+var KNOWN_BLOCK_META_KEYS = {
+  x: "number",
+  y: "number",
+  startTime: "time",
+  duration: "time",
+  connectsTo: "connectionList",
+  transition: "transition",
+  transitionDuration: "time",
+  transitionDirection: "transitionDirection"
+};
+var BLOCK_META_KEY_DESCRIPTORS = [
+  {
+    key: "transition",
+    description: "Block-to-block transition effect",
+    values: TRANSITION_TYPES
+  },
+  {
+    key: "transitionDuration",
+    description: "How long the transition lasts",
+    valueHint: "seconds \u2014 e.g. 0.7, 700ms"
+  },
+  {
+    key: "transitionDirection",
+    description: "Directional variant for the transition",
+    values: TRANSITION_DIRECTIONS
+  },
+  {
+    key: "startTime",
+    description: "Timeline start time of this block",
+    valueHint: "mm:ss or seconds \u2014 e.g. 01:30, 5, 1500ms"
+  },
+  {
+    key: "duration",
+    description: "How long this block lasts",
+    valueHint: "mm:ss or seconds \u2014 e.g. 45, 1500ms"
+  },
+  {
+    key: "x",
+    description: "Horizontal position on the diagram canvas",
+    valueHint: "number \u2014 e.g. 600"
+  },
+  {
+    key: "y",
+    description: "Vertical position on the diagram canvas",
+    valueHint: "number \u2014 e.g. 300"
+  },
+  {
+    key: "connectsTo",
+    description: "Diagram connections to other blocks",
+    valueHint: "comma-separated target or target:type \u2014 e.g. foo,bar:flow"
+  }
+];
+function coerceAnnotationValues(params) {
+  const blockMeta = {};
+  const metadata = {};
+  const warnings = [];
+  let transitionType = null;
+  let transitionDuration;
+  let transitionDirection;
+  for (const [key, raw] of Object.entries(params)) {
+    const kind = KNOWN_BLOCK_META_KEYS[key];
+    if (!kind) {
+      metadata[key] = raw;
+      continue;
+    }
+    if (kind === "number") {
+      const n = parseNumber(raw);
+      if (n == null) {
+        warnings.push(`Invalid number for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        blockMeta[key] = n;
+      }
+    } else if (kind === "time") {
+      const s = parseTimeSeconds(raw);
+      if (s == null) {
+        warnings.push(`Invalid time for "${key}": ${JSON.stringify(raw)}`);
+      } else if (key === "transitionDuration") {
+        transitionDuration = s;
+      } else {
+        blockMeta[key] = s;
+      }
+    } else if (kind === "connectionList") {
+      const { list, warning } = parseConnectionList(raw);
+      if (warning) warnings.push(`"${key}": ${warning}`);
+      blockMeta.connectsTo = list;
+    } else if (kind === "transition") {
+      const transition = normalizeTransitionType(raw);
+      if (transition == null) {
+        warnings.push(`Invalid transition for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        transitionType = transition;
+      }
+    } else if (kind === "transitionDirection") {
+      const direction = normalizeTransitionDirection(raw);
+      if (direction == null) {
+        warnings.push(`Invalid transition direction for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        transitionDirection = direction;
+      }
+    }
+  }
+  if (transitionType) {
+    blockMeta.transition = {
+      type: transitionType,
+      ...transitionDuration !== void 0 ? { duration: transitionDuration } : {},
+      ...transitionDirection !== void 0 ? { direction: transitionDirection } : {}
+    };
+  }
+  return { blockMeta, metadata, warnings };
+}
+function parseNumber(raw) {
+  if (raw.trim() === "") return null;
+  const n = Number(raw);
+  return Number.isFinite(n) ? n : null;
+}
+var TIME_BARE_RE = /^\d+(?:\.\d+)?$/;
+var TIME_MS_RE = /^(\d+(?:\.\d+)?)ms$/;
+var TIME_MMSS_RE = /^(\d+):(\d{1,2})(?:\.(\d+))?$/;
+function parseTimeSeconds(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  if (TIME_BARE_RE.test(trimmed)) {
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : null;
+  }
+  const msMatch = trimmed.match(TIME_MS_RE);
+  if (msMatch) {
+    const n = Number(msMatch[1]);
+    return Number.isFinite(n) ? n / 1e3 : null;
+  }
+  const mmssMatch = trimmed.match(TIME_MMSS_RE);
+  if (mmssMatch) {
+    const mins = Number(mmssMatch[1]);
+    const secs = Number(mmssMatch[2]);
+    const frac = mmssMatch[3] ? Number(`0.${mmssMatch[3]}`) : 0;
+    if (!Number.isFinite(mins) || !Number.isFinite(secs) || !Number.isFinite(frac)) {
+      return null;
+    }
+    if (secs >= 60) return null;
+    return mins * 60 + secs + frac;
+  }
+  return null;
+}
+function parseConnectionList(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return { list: [], warning: null };
+  const list = [];
+  let droppedEmpty = false;
+  for (const part of trimmed.split(",")) {
+    const entry = part.trim();
+    if (!entry) {
+      droppedEmpty = true;
+      continue;
+    }
+    const colonIdx = entry.indexOf(":");
+    if (colonIdx < 0) {
+      list.push({ target: entry });
+    } else {
+      const target = entry.slice(0, colonIdx).trim();
+      const type = entry.slice(colonIdx + 1).trim();
+      if (!target) {
+        droppedEmpty = true;
+        continue;
+      }
+      list.push(type ? { target, type } : { target });
+    }
+  }
+  return {
+    list,
+    warning: droppedEmpty ? "dropped empty connection entries" : null
+  };
+}
+
+// src/markdown/attrTokens.ts
+var DQ_RUN = `"(?:[^"\\\\]|\\\\.)*"`;
+var SQ_RUN = `'(?:[^'\\\\]|\\\\.)*'`;
+var TEMPLATE_STRICT_RE = new RegExp(
+  `\\s*\\{\\[((?:[^\\]"']|${DQ_RUN}|${SQ_RUN})*)\\]\\}[\\s\\]}]*$`
+);
+var TEMPLATE_LEGACY_RE = /\s*\{\[([^\]]*)\]\}[\s\]}]*$/;
+var PANDOC_STRICT_RE = new RegExp(`\\s*\\{(?!\\[)((?:[^}"']|${DQ_RUN}|${SQ_RUN})*)\\}\\s*$`);
+var PANDOC_LEGACY_RE = /\s*\{(?!\[)([^}]*)\}\s*$/;
+function matchTrailing(text, strict, legacy) {
+  const m = strict.exec(text) ?? legacy.exec(text);
+  return m ? { inner: m[1], index: m.index } : null;
+}
+function matchTrailingTemplateAnnotation(text) {
+  return matchTrailing(text, TEMPLATE_STRICT_RE, TEMPLATE_LEGACY_RE);
+}
+function matchTrailingPandocAttr(text) {
+  return matchTrailing(text, PANDOC_STRICT_RE, PANDOC_LEGACY_RE);
+}
+var WHITESPACE_RE = /\s/;
+function tokenizeAttrTokens(input) {
+  const tokens = [];
+  let i = 0;
+  const n = input.length;
+  while (i < n) {
+    while (i < n && WHITESPACE_RE.test(input[i])) i++;
+    if (i >= n) break;
+    let token = "";
+    while (i < n && !WHITESPACE_RE.test(input[i])) {
+      const ch = input[i];
+      const atValueStart = token === "" || token.endsWith("=");
+      if ((ch === '"' || ch === "'") && atValueStart) {
+        token += ch;
+        i++;
+        while (i < n && input[i] !== ch) {
+          if (input[i] === "\\" && i + 1 < n && (input[i + 1] === ch || input[i + 1] === "\\")) {
+            token += input[i] + input[i + 1];
+            i += 2;
+          } else {
+            token += input[i];
+            i++;
+          }
+        }
+        if (i < n && input[i] === ch) {
+          token += ch;
+          i++;
+        }
+      } else {
+        token += ch;
+        i++;
+      }
+    }
+    if (token) tokens.push(token);
+  }
+  return tokens;
+}
+var DQ_UNESCAPE_RE = /\\([\\"])/g;
+var SQ_UNESCAPE_RE = /\\([\\'])/g;
+function unquoteAttrValue(raw) {
+  if (raw.length >= 2) {
+    const q = raw[0];
+    if ((q === '"' || q === "'") && raw.endsWith(q)) {
+      const body = raw.slice(1, -1);
+      return body.replace(q === '"' ? DQ_UNESCAPE_RE : SQ_UNESCAPE_RE, "$1");
+    }
+  }
+  return raw;
+}
+function splitKeyValueToken(token) {
+  const eqIdx = token.indexOf("=");
+  if (eqIdx <= 0) return null;
+  return { key: token.slice(0, eqIdx), value: unquoteAttrValue(token.slice(eqIdx + 1)) };
+}
+var NEEDS_QUOTING_RE = /[\s"'[\]{}]/;
+var DQ_ESCAPE_RE = /[\\"]/g;
+var SQ_ESCAPE_RE = /[\\']/g;
+function needsQuoting(value) {
+  return value === "" || NEEDS_QUOTING_RE.test(value);
+}
+function quoteAttrValue(value) {
+  if (!needsQuoting(value)) return value;
+  if (value.includes('"') && !value.includes("'")) {
+    return `'${value.replace(SQ_ESCAPE_RE, (ch) => `\\${ch}`)}'`;
+  }
+  return `"${value.replace(DQ_ESCAPE_RE, (ch) => `\\${ch}`)}"`;
+}
+function serializeAnnotation(template, params) {
+  const parts = [];
+  if (template) parts.push(template);
+  for (const [key, value] of Object.entries(params ?? {})) {
+    parts.push(`${key}=${quoteAttrValue(value)}`);
+  }
+  return `{[${parts.join(" ")}]}`;
+}
+
+export {
+  KNOWN_BLOCK_META_KEYS,
+  BLOCK_META_KEY_DESCRIPTORS,
+  coerceAnnotationValues,
+  parseNumber,
+  parseTimeSeconds,
+  matchTrailingTemplateAnnotation,
+  matchTrailingPandocAttr,
+  tokenizeAttrTokens,
+  unquoteAttrValue,
+  splitKeyValueToken,
+  needsQuoting,
+  quoteAttrValue,
+  serializeAnnotation
+};
+//# sourceMappingURL=chunk-R2YZTCLO.js.map

package/dist/chunk-R2YZTCLO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/markdown/annotationCoercion.ts","../src/markdown/attrTokens.ts"],"sourcesContent":["/**\n * Heading-attribute value coercion.\n *\n * The Pandoc-style heading attribute block `{#id .class key=value}` parses\n * to a flat `Record<string, string>` of `key → raw value`. This module\n * coerces a known subset of keys to typed values (numbers, time-in-seconds,\n * `BlockConnection[]`) so downstream consumers don't have to re-parse them.\n *\n * Unknown keys are returned in `metadata` as raw strings. Malformed known-key\n * values are dropped from the typed result and reported via `warnings` (the\n * raw string is preserved in `params` upstream for lossless round-tripping —\n * coercion failures do not corrupt the source).\n */\n\nimport type { BlockConnection } from './types.js';\nimport type { TransitionDirection, TransitionType } from '../schemas/Transitions.js';\nimport {\n  normalizeTransitionDirection,\n  normalizeTransitionType,\n  TRANSITION_TYPES,\n  TRANSITION_DIRECTIONS,\n} from '../schemas/Transitions.js';\n\n/**\n * Registry of known block-meta keys and their coercion strategies.\n *\n * Adding a new typed key: add an entry here, add the typed field to\n * `HeadingAttributes.blockMeta` in `types.ts`, and apply the coerced value\n * in `markdownToDoc.ts`.\n */\nexport const KNOWN_BLOCK_META_KEYS = {\n  x: 'number',\n  y: 'number',\n  startTime: 'time',\n  duration: 'time',\n  connectsTo: 'connectionList',\n  transition: 'transition',\n  transitionDuration: 'time',\n  transitionDirection: 'transitionDirection',\n} as const;\n\nexport type KnownBlockMetaKey = keyof typeof KNOWN_BLOCK_META_KEYS;\n\n/**\n * Editor-facing description of a known block-meta key: what it does, and\n * either its closed set of valid values or a free-form format hint. This is\n * the single source the markdown editor's `{[name key=value]}` attribute\n * autocomplete reads from, so the suggestion list stays in lockstep with\n * `KNOWN_BLOCK_META_KEYS` and the transition vocabulary rather than drifting\n * in a hand-maintained copy. `values`/`valueHint` are mutually exclusive: a\n * key has a closed enum (`values`) or a format hint (`valueHint`), not both.\n */\nexport interface BlockMetaKeyDescriptor {\n  key: KnownBlockMetaKey;\n  /** One-line description, shown as the completion item's detail. */\n  description: string;\n  /** Closed set of valid values, for keys backed by an enum. */\n  values?: readonly string[];\n  /** Format hint shown when the value is free-form (no closed set). */\n  valueHint?: string;\n}\n\n/**\n * Ordered descriptors for every key in `KNOWN_BLOCK_META_KEYS`. Order is the\n * suggestion display order: the transition family first (the most common\n * authoring case), then timeline timing, then diagram geometry/links.\n */\nexport const BLOCK_META_KEY_DESCRIPTORS: readonly BlockMetaKeyDescriptor[] = [\n  {\n    key: 'transition',\n    description: 'Block-to-block transition effect',\n    values: TRANSITION_TYPES,\n  },\n  {\n    key: 'transitionDuration',\n    description: 'How long the transition lasts',\n    valueHint: 'seconds — e.g. 0.7, 700ms',\n  },\n  {\n    key: 'transitionDirection',\n    description: 'Directional variant for the transition',\n    values: TRANSITION_DIRECTIONS,\n  },\n  {\n    key: 'startTime',\n    description: 'Timeline start time of this block',\n    valueHint: 'mm:ss or seconds — e.g. 01:30, 5, 1500ms',\n  },\n  {\n    key: 'duration',\n    description: 'How long this block lasts',\n    valueHint: 'mm:ss or seconds — e.g. 45, 1500ms',\n  },\n  {\n    key: 'x',\n    description: 'Horizontal position on the diagram canvas',\n    valueHint: 'number — e.g. 600',\n  },\n  {\n    key: 'y',\n    description: 'Vertical position on the diagram canvas',\n    valueHint: 'number — e.g. 300',\n  },\n  {\n    key: 'connectsTo',\n    description: 'Diagram connections to other blocks',\n    valueHint: 'comma-separated target or target:type — e.g. foo,bar:flow',\n  },\n];\n\n/**\n * The shape of the typed values produced by coercion. Mirrors\n * `HeadingAttributes.blockMeta` in `types.ts`.\n */\nexport interface CoercedBlockMeta {\n  x?: number;\n  y?: number;\n  startTime?: number;\n  duration?: number;\n  connectsTo?: BlockConnection[];\n  transition?: {\n    type: TransitionType;\n    duration?: number;\n    direction?: TransitionDirection;\n  };\n}\n\nexport interface CoerceResult {\n  /** Typed values for known keys whose coercion succeeded. */\n  blockMeta: CoercedBlockMeta;\n  /** Raw string values for keys not in the known-key registry. */\n  metadata: Record<string, string>;\n  /** Human-readable diagnostics — currently emitted for coercion failures. */\n  warnings: string[];\n}\n\n/**\n * Coerce a flat `key → raw string` map into typed block-meta + an\n * untyped metadata bag, per the `KNOWN_BLOCK_META_KEYS` registry.\n */\nexport function coerceAnnotationValues(params: Record<string, string>): CoerceResult {\n  const blockMeta: CoercedBlockMeta = {};\n  const metadata: Record<string, string> = {};\n  const warnings: string[] = [];\n  let transitionType: TransitionType | null = null;\n  let transitionDuration: number | undefined;\n  let transitionDirection: TransitionDirection | undefined;\n\n  for (const [key, raw] of Object.entries(params)) {\n    const kind = (KNOWN_BLOCK_META_KEYS as Record<string, string>)[key];\n    if (!kind) {\n      metadata[key] = raw;\n      continue;\n    }\n    if (kind === 'number') {\n      const n = parseNumber(raw);\n      if (n == null) {\n        warnings.push(`Invalid number for \"${key}\": ${JSON.stringify(raw)}`);\n      } else {\n        (blockMeta as Record<string, unknown>)[key] = n;\n      }\n    } else if (kind === 'time') {\n      const s = parseTimeSeconds(raw);\n      if (s == null) {\n        warnings.push(`Invalid time for \"${key}\": ${JSON.stringify(raw)}`);\n      } else if (key === 'transitionDuration') {\n        transitionDuration = s;\n      } else {\n        (blockMeta as Record<string, unknown>)[key] = s;\n      }\n    } else if (kind === 'connectionList') {\n      const { list, warning } = parseConnectionList(raw);\n      if (warning) warnings.push(`\"${key}\": ${warning}`);\n      blockMeta.connectsTo = list;\n    } else if (kind === 'transition') {\n      const transition = normalizeTransitionType(raw);\n      if (transition == null) {\n        warnings.push(`Invalid transition for \"${key}\": ${JSON.stringify(raw)}`);\n      } else {\n        transitionType = transition;\n      }\n    } else if (kind === 'transitionDirection') {\n      const direction = normalizeTransitionDirection(raw);\n      if (direction == null) {\n        warnings.push(`Invalid transition direction for \"${key}\": ${JSON.stringify(raw)}`);\n      } else {\n        transitionDirection = direction;\n      }\n    }\n  }\n\n  if (transitionType) {\n    blockMeta.transition = {\n      type: transitionType,\n      ...(transitionDuration !== undefined ? { duration: transitionDuration } : {}),\n      ...(transitionDirection !== undefined ? { direction: transitionDirection } : {}),\n    };\n  }\n\n  return { blockMeta, metadata, warnings };\n}\n\n// ============================================\n// Coercers\n// ============================================\n\n/** Parse a finite number from a string. Returns null on failure. */\nexport function parseNumber(raw: string): number | null {\n  if (raw.trim() === '') return null;\n  const n = Number(raw);\n  return Number.isFinite(n) ? n : null;\n}\n\nconst TIME_BARE_RE = /^\\d+(?:\\.\\d+)?$/;\nconst TIME_MS_RE = /^(\\d+(?:\\.\\d+)?)ms$/;\nconst TIME_MMSS_RE = /^(\\d+):(\\d{1,2})(?:\\.(\\d+))?$/;\n\n/**\n * Parse a time value to seconds. Accepts:\n * - bare number: `5` → 5, `5.5` → 5.5\n * - `mm:ss`: `01:30` → 90\n * - `mm:ss.ms`: `01:30.500` → 90.5\n * - `1500ms` → 1.5\n *\n * Returns null on malformed input.\n */\nexport function parseTimeSeconds(raw: string): number | null {\n  const trimmed = raw.trim();\n  if (!trimmed) return null;\n\n  if (TIME_BARE_RE.test(trimmed)) {\n    const n = Number(trimmed);\n    return Number.isFinite(n) ? n : null;\n  }\n\n  const msMatch = trimmed.match(TIME_MS_RE);\n  if (msMatch) {\n    const n = Number(msMatch[1]);\n    return Number.isFinite(n) ? n / 1000 : null;\n  }\n\n  const mmssMatch = trimmed.match(TIME_MMSS_RE);\n  if (mmssMatch) {\n    const mins = Number(mmssMatch[1]);\n    const secs = Number(mmssMatch[2]);\n    const frac = mmssMatch[3] ? Number(`0.${mmssMatch[3]}`) : 0;\n    if (!Number.isFinite(mins) || !Number.isFinite(secs) || !Number.isFinite(frac)) {\n      return null;\n    }\n    if (secs >= 60) return null;\n    return mins * 60 + secs + frac;\n  }\n\n  return null;\n}\n\n/**\n * Parse a comma-separated connection list. Each entry is `target` or\n * `target:type`. Empty entries (`a,,b`) are filtered with a warning; an\n * entirely empty input yields an empty list with no warning.\n */\nexport function parseConnectionList(raw: string): {\n  list: BlockConnection[];\n  warning: string | null;\n} {\n  const trimmed = raw.trim();\n  if (!trimmed) return { list: [], warning: null };\n\n  const list: BlockConnection[] = [];\n  let droppedEmpty = false;\n  for (const part of trimmed.split(',')) {\n    const entry = part.trim();\n    if (!entry) {\n      droppedEmpty = true;\n      continue;\n    }\n    const colonIdx = entry.indexOf(':');\n    if (colonIdx < 0) {\n      list.push({ target: entry });\n    } else {\n      const target = entry.slice(0, colonIdx).trim();\n      const type = entry.slice(colonIdx + 1).trim();\n      if (!target) {\n        droppedEmpty = true;\n        continue;\n      }\n      list.push(type ? { target, type } : { target });\n    }\n  }\n\n  return {\n    list,\n    warning: droppedEmpty ? 'dropped empty connection entries' : null,\n  };\n}\n","/**\n * Shared key=value attribute machinery for the two heading annotation forms:\n * the squisq-native `{[templateName key=value …]}` template annotation and\n * the Pandoc-style `{#id .class key=value}` attribute block.\n *\n * Both forms share one interior grammar — whitespace-separated tokens whose\n * values may be quoted (double or single) to include spaces, brackets, or\n * quote characters. This module is the single implementation of that\n * grammar: one tokenizer, one value un/escaper, one quoting rule. The\n * trailing-annotation recognizers live here too so the editor bridge\n * (packages/editor-react/src/tiptapBridge.ts) stays in sync by importing\n * them rather than copying regexes.\n *\n * Value syntax:\n * - Unquoted: no whitespace, quotes, or `[ ] { }` (those would collide with\n *   the surrounding annotation delimiters), e.g. `columns=3`, `name=O'Brien`\n *   (a quote *inside* an unquoted value is literal).\n * - Quoted: `key=\"value with spaces\"` or `key='…'`. Inside a quoted run,\n *   `\\` escapes the active quote character and itself; any other `\\` is\n *   literal. Quoted values may contain `]` and `}`.\n * - Serialization emits double quotes, switching to single quotes when the\n *   value contains a double quote (markdown character-escape resolution\n *   makes backslash-escaped quotes fragile in `.md` source, so picking the\n *   other quote character is preferred over escaping). A value containing\n *   BOTH quote characters falls back to double quotes with `\\\"` escapes —\n *   that survives the API path but is best avoided in markdown source.\n */\n\n// ============================================\n// Trailing-annotation recognizers\n// ============================================\n\n/** Regex source for a double-quoted run with `\\\"` / `\\\\` escapes. */\nconst DQ_RUN = `\"(?:[^\"\\\\\\\\]|\\\\\\\\.)*\"`;\n/** Regex source for a single-quoted run with `\\'` / `\\\\` escapes. */\nconst SQ_RUN = `'(?:[^'\\\\\\\\]|\\\\\\\\.)*'`;\n\n/**\n * Quote-aware match for a trailing `{[…]}` annotation: the interior is any\n * mix of quoted runs and characters other than `]` and quotes, so quoted\n * values may contain `]`. An empty interior is valid so `{[]}` can remain\n * lossless metadata instead of visible heading text. The trailing\n * `[\\s\\]}]*` tolerates an accidental doubled `]}` that users sometimes type\n * when learning the syntax.\n */\nconst TEMPLATE_STRICT_RE = new RegExp(\n  `\\\\s*\\\\{\\\\[((?:[^\\\\]\"']|${DQ_RUN}|${SQ_RUN})*)\\\\]\\\\}[\\\\s\\\\]}]*$`,\n);\n\n/**\n * Legacy fallback matching the pre-quote-aware grammar (`[^\\]]*` interior).\n * Tried after the strict form so inputs with unbalanced quotes keep parsing\n * exactly as they did before quote support landed.\n */\nconst TEMPLATE_LEGACY_RE = /\\s*\\{\\[([^\\]]*)\\]\\}[\\s\\]}]*$/;\n\n/**\n * Quote-aware match for a trailing Pandoc `{…}` block. The negative\n * lookahead `(?!\\[)` keeps it from colliding with the `{[…]}` template\n * form. Quoted values may contain `}`.\n */\nconst PANDOC_STRICT_RE = new RegExp(`\\\\s*\\\\{(?!\\\\[)((?:[^}\"']|${DQ_RUN}|${SQ_RUN})*)\\\\}\\\\s*$`);\n\n/** Legacy fallback for the Pandoc block (`[^}]*` interior). */\nconst PANDOC_LEGACY_RE = /\\s*\\{(?!\\[)([^}]*)\\}\\s*$/;\n\n/** Result of matching a trailing annotation against a text run. */\nexport interface TrailingAnnotationMatch {\n  /** Interior of the brace block (between `{[`/`{` and `]}`/`}`), untrimmed. */\n  inner: string;\n  /** Offset of the match start (including leading whitespace) in the input. */\n  index: number;\n}\n\nfunction matchTrailing(\n  text: string,\n  strict: RegExp,\n  legacy: RegExp,\n): TrailingAnnotationMatch | null {\n  const m = strict.exec(text) ?? legacy.exec(text);\n  return m ? { inner: m[1], index: m.index } : null;\n}\n\n/**\n * Match a trailing `{[templateName key=value …]}` annotation. Quote-aware\n * (values may contain `]` when quoted), with a legacy fallback so inputs\n * the old `[^\\]]+` grammar accepted still match.\n */\nexport function matchTrailingTemplateAnnotation(text: string): TrailingAnnotationMatch | null {\n  return matchTrailing(text, TEMPLATE_STRICT_RE, TEMPLATE_LEGACY_RE);\n}\n\n/**\n * Match a trailing Pandoc `{#id .class key=value}` block. Quote-aware\n * (values may contain `}` when quoted), with a legacy fallback.\n */\nexport function matchTrailingPandocAttr(text: string): TrailingAnnotationMatch | null {\n  return matchTrailing(text, PANDOC_STRICT_RE, PANDOC_LEGACY_RE);\n}\n\n// ============================================\n// Tokenizer\n// ============================================\n\nconst WHITESPACE_RE = /\\s/;\n\n/**\n * Quote-aware whitespace tokenizer for the interior of either annotation\n * form.\n *\n * A quote run starts only at the beginning of a token or immediately after\n * `=` — a quote elsewhere (e.g. `name=O'Brien`) is a literal character.\n * Inside a run, `\\` escapes the active quote character and itself; the\n * escape pair is preserved in the returned token (callers strip and\n * unescape via {@link splitKeyValueToken} / {@link unquoteAttrValue}).\n * An unbalanced opening quote is tolerated: the run extends to the end of\n * the input.\n */\nexport function tokenizeAttrTokens(input: string): string[] {\n  const tokens: string[] = [];\n  let i = 0;\n  const n = input.length;\n  while (i < n) {\n    while (i < n && WHITESPACE_RE.test(input[i])) i++;\n    if (i >= n) break;\n\n    let token = '';\n    while (i < n && !WHITESPACE_RE.test(input[i])) {\n      const ch = input[i];\n      const atValueStart = token === '' || token.endsWith('=');\n      if ((ch === '\"' || ch === \"'\") && atValueStart) {\n        token += ch;\n        i++;\n        while (i < n && input[i] !== ch) {\n          if (input[i] === '\\\\' && i + 1 < n && (input[i + 1] === ch || input[i + 1] === '\\\\')) {\n            token += input[i] + input[i + 1];\n            i += 2;\n          } else {\n            token += input[i];\n            i++;\n          }\n        }\n        if (i < n && input[i] === ch) {\n          token += ch;\n          i++;\n        }\n      } else {\n        token += ch;\n        i++;\n      }\n    }\n    if (token) tokens.push(token);\n  }\n  return tokens;\n}\n\n// ============================================\n// Value un/escaping\n// ============================================\n\nconst DQ_UNESCAPE_RE = /\\\\([\\\\\"])/g;\nconst SQ_UNESCAPE_RE = /\\\\([\\\\'])/g;\n\n/**\n * Strip surrounding quotes from a raw token value and unescape the active\n * quote character and backslash. Values not wrapped in matching quotes are\n * returned verbatim (including any interior quotes or backslashes).\n */\nexport function unquoteAttrValue(raw: string): string {\n  if (raw.length >= 2) {\n    const q = raw[0];\n    if ((q === '\"' || q === \"'\") && raw.endsWith(q)) {\n      const body = raw.slice(1, -1);\n      return body.replace(q === '\"' ? DQ_UNESCAPE_RE : SQ_UNESCAPE_RE, '$1');\n    }\n  }\n  return raw;\n}\n\n/**\n * Split a `key=value` token into its parts, unquoting/unescaping the value.\n * Returns null for tokens with no `=` past the first character (bare words,\n * `#id`, `.class`, or a leading `=`).\n */\nexport function splitKeyValueToken(token: string): { key: string; value: string } | null {\n  const eqIdx = token.indexOf('=');\n  if (eqIdx <= 0) return null;\n  return { key: token.slice(0, eqIdx), value: unquoteAttrValue(token.slice(eqIdx + 1)) };\n}\n\n// ============================================\n// Serialization\n// ============================================\n\nconst NEEDS_QUOTING_RE = /[\\s\"'[\\]{}]/;\nconst DQ_ESCAPE_RE = /[\\\\\"]/g;\nconst SQ_ESCAPE_RE = /[\\\\']/g;\n\n/**\n * Whether a value must be quoted to survive tokenization and the outer\n * annotation regexes: any whitespace, quote character, bracket, or brace —\n * or an empty value, which would otherwise serialize as a bare `key=`.\n */\nexport function needsQuoting(value: string): boolean {\n  return value === '' || NEEDS_QUOTING_RE.test(value);\n}\n\n/**\n * Serialize an attribute value, quoting when {@link needsQuoting} says the\n * bare form would not round-trip.\n *\n * Double quotes are canonical; a value containing a double quote (but no\n * single quote) is single-quoted instead, because markdown resolves\n * backslash escapes in text runs before our parser sees them — switching\n * the quote character round-trips through `.md` source where `\\\"` would\n * not. Backslashes and the active quote character are escaped.\n */\nexport function quoteAttrValue(value: string): string {\n  if (!needsQuoting(value)) return value;\n  if (value.includes('\"') && !value.includes(\"'\")) {\n    return `'${value.replace(SQ_ESCAPE_RE, (ch) => `\\\\${ch}`)}'`;\n  }\n  return `\"${value.replace(DQ_ESCAPE_RE, (ch) => `\\\\${ch}`)}\"`;\n}\n\n/**\n * Serialize a `{[templateName key=value …]}` template annotation. The inverse\n * of {@link parseStandaloneAnnotation} / the tokenizer: emits the template\n * name (when present) followed by each `key=value` pair in insertion order,\n * quoting values via {@link quoteAttrValue}. Used to re-emit heading-less\n * standalone annotation blocks in `docToMarkdown`.\n */\nexport function serializeAnnotation(\n  template: string | undefined,\n  params?: Record<string, string>,\n): string {\n  const parts: string[] = [];\n  if (template) parts.push(template);\n  for (const [key, value] of Object.entries(params ?? {})) {\n    parts.push(`${key}=${quoteAttrValue(value)}`);\n  }\n  return `{[${parts.join(' ')}]}`;\n}\n"],"mappings":";;;;;;;;AA8BO,IAAM,wBAAwB;AAAA,EACnC,GAAG;AAAA,EACH,GAAG;AAAA,EACH,WAAW;AAAA,EACX,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,oBAAoB;AAAA,EACpB,qBAAqB;AACvB;AA4BO,IAAM,6BAAgE;AAAA,EAC3E;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AACF;AAgCO,SAAS,uBAAuB,QAA8C;AACnF,QAAM,YAA8B,CAAC;AACrC,QAAM,WAAmC,CAAC;AAC1C,QAAM,WAAqB,CAAC;AAC5B,MAAI,iBAAwC;AAC5C,MAAI;AACJ,MAAI;AAEJ,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC/C,UAAM,OAAQ,sBAAiD,GAAG;AAClE,QAAI,CAAC,MAAM;AACT,eAAS,GAAG,IAAI;AAChB;AAAA,IACF;AACA,QAAI,SAAS,UAAU;AACrB,YAAM,IAAI,YAAY,GAAG;AACzB,UAAI,KAAK,MAAM;AACb,iBAAS,KAAK,uBAAuB,GAAG,MAAM,KAAK,UAAU,GAAG,CAAC,EAAE;AAAA,MACrE,OAAO;AACL,QAAC,UAAsC,GAAG,IAAI;AAAA,MAChD;AAAA,IACF,WAAW,SAAS,QAAQ;AAC1B,YAAM,IAAI,iBAAiB,GAAG;AAC9B,UAAI,KAAK,MAAM;AACb,iBAAS,KAAK,qBAAqB,GAAG,MAAM,KAAK,UAAU,GAAG,CAAC,EAAE;AAAA,MACnE,WAAW,QAAQ,sBAAsB;AACvC,6BAAqB;AAAA,MACvB,OAAO;AACL,QAAC,UAAsC,GAAG,IAAI;AAAA,MAChD;AAAA,IACF,WAAW,SAAS,kBAAkB;AACpC,YAAM,EAAE,MAAM,QAAQ,IAAI,oBAAoB,GAAG;AACjD,UAAI,QAAS,UAAS,KAAK,IAAI,GAAG,MAAM,OAAO,EAAE;AACjD,gBAAU,aAAa;AAAA,IACzB,WAAW,SAAS,cAAc;AAChC,YAAM,aAAa,wBAAwB,GAAG;AAC9C,UAAI,cAAc,MAAM;AACtB,iBAAS,KAAK,2BAA2B,GAAG,MAAM,KAAK,UAAU,GAAG,CAAC,EAAE;AAAA,MACzE,OAAO;AACL,yBAAiB;AAAA,MACnB;AAAA,IACF,WAAW,SAAS,uBAAuB;AACzC,YAAM,YAAY,6BAA6B,GAAG;AAClD,UAAI,aAAa,MAAM;AACrB,iBAAS,KAAK,qCAAqC,GAAG,MAAM,KAAK,UAAU,GAAG,CAAC,EAAE;AAAA,MACnF,OAAO;AACL,8BAAsB;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAEA,MAAI,gBAAgB;AAClB,cAAU,aAAa;AAAA,MACrB,MAAM;AAAA,MACN,GAAI,uBAAuB,SAAY,EAAE,UAAU,mBAAmB,IAAI,CAAC;AAAA,MAC3E,GAAI,wBAAwB,SAAY,EAAE,WAAW,oBAAoB,IAAI,CAAC;AAAA,IAChF;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,UAAU,SAAS;AACzC;AAOO,SAAS,YAAY,KAA4B;AACtD,MAAI,IAAI,KAAK,MAAM,GAAI,QAAO;AAC9B,QAAM,IAAI,OAAO,GAAG;AACpB,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAEA,IAAM,eAAe;AACrB,IAAM,aAAa;AACnB,IAAM,eAAe;AAWd,SAAS,iBAAiB,KAA4B;AAC3D,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,aAAa,KAAK,OAAO,GAAG;AAC9B,UAAM,IAAI,OAAO,OAAO;AACxB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AAEA,QAAM,UAAU,QAAQ,MAAM,UAAU;AACxC,MAAI,SAAS;AACX,UAAM,IAAI,OAAO,QAAQ,CAAC,CAAC;AAC3B,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI,MAAO;AAAA,EACzC;AAEA,QAAM,YAAY,QAAQ,MAAM,YAAY;AAC5C,MAAI,WAAW;AACb,UAAM,OAAO,OAAO,UAAU,CAAC,CAAC;AAChC,UAAM,OAAO,OAAO,UAAU,CAAC,CAAC;AAChC,UAAM,OAAO,UAAU,CAAC,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,EAAE,IAAI;AAC1D,QAAI,CAAC,OAAO,SAAS,IAAI,KAAK,CAAC,OAAO,SAAS,IAAI,KAAK,CAAC,OAAO,SAAS,IAAI,GAAG;AAC9E,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,GAAI,QAAO;AACvB,WAAO,OAAO,KAAK,OAAO;AAAA,EAC5B;AAEA,SAAO;AACT;AAOO,SAAS,oBAAoB,KAGlC;AACA,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,CAAC,QAAS,QAAO,EAAE,MAAM,CAAC,GAAG,SAAS,KAAK;AAE/C,QAAM,OAA0B,CAAC;AACjC,MAAI,eAAe;AACnB,aAAW,QAAQ,QAAQ,MAAM,GAAG,GAAG;AACrC,UAAM,QAAQ,KAAK,KAAK;AACxB,QAAI,CAAC,OAAO;AACV,qBAAe;AACf;AAAA,IACF;AACA,UAAM,WAAW,MAAM,QAAQ,GAAG;AAClC,QAAI,WAAW,GAAG;AAChB,WAAK,KAAK,EAAE,QAAQ,MAAM,CAAC;AAAA,IAC7B,OAAO;AACL,YAAM,SAAS,MAAM,MAAM,GAAG,QAAQ,EAAE,KAAK;AAC7C,YAAM,OAAO,MAAM,MAAM,WAAW,CAAC,EAAE,KAAK;AAC5C,UAAI,CAAC,QAAQ;AACX,uBAAe;AACf;AAAA,MACF;AACA,WAAK,KAAK,OAAO,EAAE,QAAQ,KAAK,IAAI,EAAE,OAAO,CAAC;AAAA,IAChD;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,eAAe,qCAAqC;AAAA,EAC/D;AACF;;;ACrQA,IAAM,SAAS;AAEf,IAAM,SAAS;AAUf,IAAM,qBAAqB,IAAI;AAAA,EAC7B,0BAA0B,MAAM,IAAI,MAAM;AAC5C;AAOA,IAAM,qBAAqB;AAO3B,IAAM,mBAAmB,IAAI,OAAO,4BAA4B,MAAM,IAAI,MAAM,aAAa;AAG7F,IAAM,mBAAmB;AAUzB,SAAS,cACP,MACA,QACA,QACgC;AAChC,QAAM,IAAI,OAAO,KAAK,IAAI,KAAK,OAAO,KAAK,IAAI;AAC/C,SAAO,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,IAAI;AAC/C;AAOO,SAAS,gCAAgC,MAA8C;AAC5F,SAAO,cAAc,MAAM,oBAAoB,kBAAkB;AACnE;AAMO,SAAS,wBAAwB,MAA8C;AACpF,SAAO,cAAc,MAAM,kBAAkB,gBAAgB;AAC/D;AAMA,IAAM,gBAAgB;AAcf,SAAS,mBAAmB,OAAyB;AAC1D,QAAM,SAAmB,CAAC;AAC1B,MAAI,IAAI;AACR,QAAM,IAAI,MAAM;AAChB,SAAO,IAAI,GAAG;AACZ,WAAO,IAAI,KAAK,cAAc,KAAK,MAAM,CAAC,CAAC,EAAG;AAC9C,QAAI,KAAK,EAAG;AAEZ,QAAI,QAAQ;AACZ,WAAO,IAAI,KAAK,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,GAAG;AAC7C,YAAM,KAAK,MAAM,CAAC;AAClB,YAAM,eAAe,UAAU,MAAM,MAAM,SAAS,GAAG;AACvD,WAAK,OAAO,OAAO,OAAO,QAAQ,cAAc;AAC9C,iBAAS;AACT;AACA,eAAO,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI;AAC/B,cAAI,MAAM,CAAC,MAAM,QAAQ,IAAI,IAAI,MAAM,MAAM,IAAI,CAAC,MAAM,MAAM,MAAM,IAAI,CAAC,MAAM,OAAO;AACpF,qBAAS,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;AAC/B,iBAAK;AAAA,UACP,OAAO;AACL,qBAAS,MAAM,CAAC;AAChB;AAAA,UACF;AAAA,QACF;AACA,YAAI,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI;AAC5B,mBAAS;AACT;AAAA,QACF;AAAA,MACF,OAAO;AACL,iBAAS;AACT;AAAA,MACF;AAAA,IACF;AACA,QAAI,MAAO,QAAO,KAAK,KAAK;AAAA,EAC9B;AACA,SAAO;AACT;AAMA,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AAOhB,SAAS,iBAAiB,KAAqB;AACpD,MAAI,IAAI,UAAU,GAAG;AACnB,UAAM,IAAI,IAAI,CAAC;AACf,SAAK,MAAM,OAAO,MAAM,QAAQ,IAAI,SAAS,CAAC,GAAG;AAC/C,YAAM,OAAO,IAAI,MAAM,GAAG,EAAE;AAC5B,aAAO,KAAK,QAAQ,MAAM,MAAM,iBAAiB,gBAAgB,IAAI;AAAA,IACvE;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,mBAAmB,OAAsD;AACvF,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,MAAI,SAAS,EAAG,QAAO;AACvB,SAAO,EAAE,KAAK,MAAM,MAAM,GAAG,KAAK,GAAG,OAAO,iBAAiB,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE;AACvF;AAMA,IAAM,mBAAmB;AACzB,IAAM,eAAe;AACrB,IAAM,eAAe;AAOd,SAAS,aAAa,OAAwB;AACnD,SAAO,UAAU,MAAM,iBAAiB,KAAK,KAAK;AACpD;AAYO,SAAS,eAAe,OAAuB;AACpD,MAAI,CAAC,aAAa,KAAK,EAAG,QAAO;AACjC,MAAI,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,SAAS,GAAG,GAAG;AAC/C,WAAO,IAAI,MAAM,QAAQ,cAAc,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;AAAA,EAC3D;AACA,SAAO,IAAI,MAAM,QAAQ,cAAc,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;AAC3D;AASO,SAAS,oBACd,UACA,QACQ;AACR,QAAM,QAAkB,CAAC;AACzB,MAAI,SAAU,OAAM,KAAK,QAAQ;AACjC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,CAAC,CAAC,GAAG;AACvD,UAAM,KAAK,GAAG,GAAG,IAAI,eAAe,KAAK,CAAC,EAAE;AAAA,EAC9C;AACA,SAAO,KAAK,MAAM,KAAK,GAAG,CAAC;AAC7B;","names":[]}

package/dist/chunk-S7A5D7ZJ.js

@@ -0,0 +1,174 @@
+// src/versions/timestamp.ts
+var TIMESTAMP_RE = /^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z$/;
+function pad2(n) {
+  return n < 10 ? `0${n}` : String(n);
+}
+function formatVersionTimestamp(date) {
+  return String(date.getUTCFullYear()).padStart(4, "0") + pad2(date.getUTCMonth() + 1) + pad2(date.getUTCDate()) + "T" + pad2(date.getUTCHours()) + pad2(date.getUTCMinutes()) + pad2(date.getUTCSeconds()) + "Z";
+}
+function parseVersionTimestamp(stamp) {
+  const m = TIMESTAMP_RE.exec(stamp);
+  if (!m) return null;
+  const [, y, mo, d, h, mi, s] = m;
+  const ms = Date.UTC(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s));
+  if (Number.isNaN(ms)) return null;
+  return new Date(ms);
+}
+var VERSION_TIMESTAMP_PATTERN = TIMESTAMP_RE;
+
+// src/versions/gitignore.ts
+var decoder = new TextDecoder();
+var encoder = new TextEncoder();
+var GITIGNORE_PATH = ".gitignore";
+var VERSIONS_IGNORE_RULE = ".versions/";
+var EQUIVALENT_VERSIONS_RULE = /^(!?)\/?\.versions\/?$/;
+async function ensureVersionsGitIgnored(container) {
+  const data = await container.readFile(GITIGNORE_PATH);
+  const existing = data ? decoder.decode(data) : "";
+  let alreadyIgnored = false;
+  for (const line of existing.split(/\r?\n/)) {
+    const match = EQUIVALENT_VERSIONS_RULE.exec(line.trim());
+    if (match) alreadyIgnored = match[1] !== "!";
+  }
+  if (alreadyIgnored) return;
+  const newline = existing.includes("\r\n") ? "\r\n" : "\n";
+  const separator = existing.length > 0 && !existing.endsWith("\n") ? newline : "";
+  const next = `${existing}${separator}${VERSIONS_IGNORE_RULE}${newline}`;
+  await container.writeFile(GITIGNORE_PATH, encoder.encode(next), "text/plain");
+}
+
+// src/versions/snapshotStore.ts
+var decoder2 = new TextDecoder();
+var encoder2 = new TextEncoder();
+function buildSnapshotPath(strategy, basename, date, collision = 0) {
+  const stamp = formatVersionTimestamp(date);
+  const suffix = collision > 0 ? `-${collision + 1}` : "";
+  return `${strategy.prefix}${basename}.${stamp}${suffix}.${strategy.extension}`;
+}
+function parseSnapshotPath(strategy, path) {
+  if (!path.startsWith(strategy.prefix)) return null;
+  const extension = `.${strategy.extension}`;
+  const rest = path.slice(strategy.prefix.length);
+  if (!rest.endsWith(extension)) return null;
+  const stem = rest.slice(0, -extension.length);
+  const lastDot = stem.lastIndexOf(".");
+  if (lastDot <= 0) return null;
+  const basename = stem.slice(0, lastDot);
+  const tail = stem.slice(lastDot + 1);
+  const dash = tail.indexOf("-");
+  let stamp = tail;
+  let collision = 0;
+  if (dash >= 0) {
+    stamp = tail.slice(0, dash);
+    const suffix = Number(tail.slice(dash + 1));
+    if (!Number.isInteger(suffix) || suffix < 2) return null;
+    collision = suffix - 1;
+  }
+  const timestamp = parseVersionTimestamp(stamp);
+  return timestamp ? { basename, timestamp, collision } : null;
+}
+async function listSnapshots(container, strategy, basename) {
+  const entries = await container.listFiles(strategy.prefix);
+  const versions = [];
+  for (const entry of entries) {
+    const parsed = parseSnapshotPath(strategy, entry.path);
+    if (!parsed || basename !== void 0 && parsed.basename !== basename) continue;
+    versions.push({
+      path: entry.path,
+      basename: parsed.basename,
+      timestamp: parsed.timestamp,
+      size: entry.size,
+      collision: parsed.collision
+    });
+  }
+  versions.sort((a, b) => {
+    const timestampDelta = b.timestamp.getTime() - a.timestamp.getTime();
+    return timestampDelta || b.collision - a.collision;
+  });
+  return versions;
+}
+async function readTextSnapshot(container, version) {
+  const path = typeof version === "string" ? version : version.path;
+  const data = await container.readFile(path);
+  return data ? decoder2.decode(data) : null;
+}
+async function saveTextSnapshot(container, strategy, options) {
+  const versions = await listSnapshots(container, strategy, options.basename);
+  if (!options.force && versions.length > 0) {
+    const existing = await readTextSnapshot(container, versions[0]);
+    if (existing === options.content) {
+      await ensureVersionsGitIgnored(container);
+      return { saved: false, version: null, reason: "unchanged" };
+    }
+  }
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  let collision = 0;
+  let path = buildSnapshotPath(strategy, options.basename, now, collision);
+  while (await container.exists(path)) {
+    collision += 1;
+    path = buildSnapshotPath(strategy, options.basename, now, collision);
+  }
+  const data = encoder2.encode(options.content);
+  await ensureVersionsGitIgnored(container);
+  await container.writeFile(path, data, options.mimeType);
+  return {
+    saved: true,
+    version: {
+      path,
+      basename: options.basename,
+      timestamp: now,
+      size: data.byteLength,
+      collision
+    },
+    reason: "saved"
+  };
+}
+async function pruneSnapshots(container, strategy, policy, basename) {
+  const versions = await listSnapshots(container, strategy, basename);
+  let toDelete;
+  if (policy.type === "keep-last-n") {
+    toDelete = versions.slice(Math.max(0, Math.floor(policy.n)));
+  } else if (policy.type === "older-than") {
+    const cutoff = policy.date.getTime();
+    toDelete = versions.filter((version) => version.timestamp.getTime() < cutoff);
+  } else {
+    toDelete = versions.filter((version) => !policy.keep(version, versions));
+  }
+  await removeSnapshots(container, toDelete);
+  return toDelete;
+}
+async function coalesceSnapshots(container, strategy, options = {}, basename) {
+  const windowMs = options.windowMs ?? 6e4;
+  const versions = await listSnapshots(container, strategy, basename);
+  const toDelete = [];
+  if (versions.length > 0) {
+    let anchor = versions[0];
+    for (let index = 1; index < versions.length; index++) {
+      const candidate = versions[index];
+      if (anchor.timestamp.getTime() - candidate.timestamp.getTime() <= windowMs) {
+        toDelete.push(candidate);
+      } else {
+        anchor = candidate;
+      }
+    }
+  }
+  await removeSnapshots(container, toDelete);
+  return toDelete;
+}
+async function removeSnapshots(container, versions) {
+  for (const version of versions) await container.removeFile(version.path);
+}
+
+export {
+  formatVersionTimestamp,
+  parseVersionTimestamp,
+  VERSION_TIMESTAMP_PATTERN,
+  buildSnapshotPath,
+  parseSnapshotPath,
+  listSnapshots,
+  readTextSnapshot,
+  saveTextSnapshot,
+  pruneSnapshots,
+  coalesceSnapshots
+};
+//# sourceMappingURL=chunk-S7A5D7ZJ.js.map

package/dist/chunk-S7A5D7ZJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/versions/timestamp.ts","../src/versions/gitignore.ts","../src/versions/snapshotStore.ts"],"sourcesContent":["/**\n * Sortable, human-readable timestamps for version filenames.\n *\n * Format: ISO 8601 basic, UTC, second precision, `Z` suffix —\n * e.g. `20260430T152030Z`. Lexicographic order matches chronological order,\n * so `listFiles` returns versions in time order without parsing.\n */\n\nconst TIMESTAMP_RE = /^(\\d{4})(\\d{2})(\\d{2})T(\\d{2})(\\d{2})(\\d{2})Z$/;\n\nfunction pad2(n: number): string {\n  return n < 10 ? `0${n}` : String(n);\n}\n\n/**\n * Format a Date as a sortable, filename-safe UTC timestamp string.\n */\nexport function formatVersionTimestamp(date: Date): string {\n  return (\n    String(date.getUTCFullYear()).padStart(4, '0') +\n    pad2(date.getUTCMonth() + 1) +\n    pad2(date.getUTCDate()) +\n    'T' +\n    pad2(date.getUTCHours()) +\n    pad2(date.getUTCMinutes()) +\n    pad2(date.getUTCSeconds()) +\n    'Z'\n  );\n}\n\n/**\n * Parse a version timestamp string back to a Date. Returns null if the input\n * doesn't match the expected format.\n */\nexport function parseVersionTimestamp(stamp: string): Date | null {\n  const m = TIMESTAMP_RE.exec(stamp);\n  if (!m) return null;\n  const [, y, mo, d, h, mi, s] = m;\n  const ms = Date.UTC(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s));\n  if (Number.isNaN(ms)) return null;\n  return new Date(ms);\n}\n\n/**\n * The pattern a valid version timestamp matches. Exported so other modules\n * can validate filenames without re-deriving the regex.\n */\nexport const VERSION_TIMESTAMP_PATTERN = TIMESTAMP_RE;\n","/**\n * Keep version snapshots out of Git when a ContentContainer is persisted\n * as a real folder (typically a `<basename>_files/` sidecar).\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\n\nconst decoder = new TextDecoder();\nconst encoder = new TextEncoder();\n\nconst GITIGNORE_PATH = '.gitignore';\nconst VERSIONS_IGNORE_RULE = '.versions/';\nconst EQUIVALENT_VERSIONS_RULE = /^(!?)\\/?\\.versions\\/?$/;\n\n/**\n * Ensure the container-root `.gitignore` ignores its `.versions/` folder.\n * Existing rules and newline style are preserved.\n */\nexport async function ensureVersionsGitIgnored(container: ContentContainer): Promise<void> {\n  const data = await container.readFile(GITIGNORE_PATH);\n  const existing = data ? decoder.decode(data) : '';\n\n  let alreadyIgnored = false;\n  for (const line of existing.split(/\\r?\\n/)) {\n    const match = EQUIVALENT_VERSIONS_RULE.exec(line.trim());\n    if (match) alreadyIgnored = match[1] !== '!';\n  }\n  if (alreadyIgnored) return;\n\n  const newline = existing.includes('\\r\\n') ? '\\r\\n' : '\\n';\n  const separator = existing.length > 0 && !existing.endsWith('\\n') ? newline : '';\n  const next = `${existing}${separator}${VERSIONS_IGNORE_RULE}${newline}`;\n  await container.writeFile(GITIGNORE_PATH, encoder.encode(next), 'text/plain');\n}\n","/**\n * Internal storage engine shared by document and image-editor histories.\n * Public APIs keep their domain-specific names and result reasons; this module\n * owns the mechanics that must behave identically across both histories.\n */\n\nimport type { ContentContainer } from '../storage/ContentContainer.js';\nimport { ensureVersionsGitIgnored } from './gitignore.js';\nimport { formatVersionTimestamp, parseVersionTimestamp } from './timestamp.js';\nimport type { CoalesceOptions, PrunePolicy, Version } from './types.js';\n\nconst decoder = new TextDecoder();\nconst encoder = new TextEncoder();\n\nexport interface SnapshotPathStrategy {\n  readonly prefix: string;\n  readonly extension: string;\n}\n\nexport interface SaveTextSnapshotOptions {\n  content: string;\n  basename: string;\n  mimeType: string;\n  now?: Date;\n  force?: boolean;\n}\n\nexport interface SaveTextSnapshotResult {\n  saved: boolean;\n  version: Version | null;\n  reason: 'saved' | 'unchanged';\n}\n\nexport function buildSnapshotPath(\n  strategy: SnapshotPathStrategy,\n  basename: string,\n  date: Date,\n  collision = 0,\n): string {\n  const stamp = formatVersionTimestamp(date);\n  const suffix = collision > 0 ? `-${collision + 1}` : '';\n  return `${strategy.prefix}${basename}.${stamp}${suffix}.${strategy.extension}`;\n}\n\nexport function parseSnapshotPath(\n  strategy: SnapshotPathStrategy,\n  path: string,\n): { basename: string; timestamp: Date; collision: number } | null {\n  if (!path.startsWith(strategy.prefix)) return null;\n  const extension = `.${strategy.extension}`;\n  const rest = path.slice(strategy.prefix.length);\n  if (!rest.endsWith(extension)) return null;\n  const stem = rest.slice(0, -extension.length);\n  const lastDot = stem.lastIndexOf('.');\n  if (lastDot <= 0) return null;\n\n  const basename = stem.slice(0, lastDot);\n  const tail = stem.slice(lastDot + 1);\n  const dash = tail.indexOf('-');\n  let stamp = tail;\n  let collision = 0;\n  if (dash >= 0) {\n    stamp = tail.slice(0, dash);\n    const suffix = Number(tail.slice(dash + 1));\n    if (!Number.isInteger(suffix) || suffix < 2) return null;\n    collision = suffix - 1;\n  }\n\n  const timestamp = parseVersionTimestamp(stamp);\n  return timestamp ? { basename, timestamp, collision } : null;\n}\n\nexport async function listSnapshots(\n  container: ContentContainer,\n  strategy: SnapshotPathStrategy,\n  basename?: string,\n): Promise<Version[]> {\n  const entries = await container.listFiles(strategy.prefix);\n  const versions: Version[] = [];\n  for (const entry of entries) {\n    const parsed = parseSnapshotPath(strategy, entry.path);\n    if (!parsed || (basename !== undefined && parsed.basename !== basename)) continue;\n    versions.push({\n      path: entry.path,\n      basename: parsed.basename,\n      timestamp: parsed.timestamp,\n      size: entry.size,\n      collision: parsed.collision,\n    });\n  }\n\n  versions.sort((a, b) => {\n    const timestampDelta = b.timestamp.getTime() - a.timestamp.getTime();\n    return timestampDelta || b.collision - a.collision;\n  });\n  return versions;\n}\n\nexport async function readTextSnapshot(\n  container: ContentContainer,\n  version: Version | string,\n): Promise<string | null> {\n  const path = typeof version === 'string' ? version : version.path;\n  const data = await container.readFile(path);\n  return data ? decoder.decode(data) : null;\n}\n\nexport async function saveTextSnapshot(\n  container: ContentContainer,\n  strategy: SnapshotPathStrategy,\n  options: SaveTextSnapshotOptions,\n): Promise<SaveTextSnapshotResult> {\n  const versions = await listSnapshots(container, strategy, options.basename);\n  if (!options.force && versions.length > 0) {\n    const existing = await readTextSnapshot(container, versions[0]!);\n    if (existing === options.content) {\n      // Backfill containers written before history owned its ignore rule.\n      await ensureVersionsGitIgnored(container);\n      return { saved: false, version: null, reason: 'unchanged' };\n    }\n  }\n\n  const now = options.now ?? new Date();\n  let collision = 0;\n  let path = buildSnapshotPath(strategy, options.basename, now, collision);\n  while (await container.exists(path)) {\n    collision += 1;\n    path = buildSnapshotPath(strategy, options.basename, now, collision);\n  }\n\n  const data = encoder.encode(options.content);\n  await ensureVersionsGitIgnored(container);\n  await container.writeFile(path, data, options.mimeType);\n  return {\n    saved: true,\n    version: {\n      path,\n      basename: options.basename,\n      timestamp: now,\n      size: data.byteLength,\n      collision,\n    },\n    reason: 'saved',\n  };\n}\n\nexport async function pruneSnapshots(\n  container: ContentContainer,\n  strategy: SnapshotPathStrategy,\n  policy: PrunePolicy,\n  basename?: string,\n): Promise<Version[]> {\n  const versions = await listSnapshots(container, strategy, basename);\n  let toDelete: Version[];\n\n  if (policy.type === 'keep-last-n') {\n    toDelete = versions.slice(Math.max(0, Math.floor(policy.n)));\n  } else if (policy.type === 'older-than') {\n    const cutoff = policy.date.getTime();\n    toDelete = versions.filter((version) => version.timestamp.getTime() < cutoff);\n  } else {\n    toDelete = versions.filter((version) => !policy.keep(version, versions));\n  }\n\n  await removeSnapshots(container, toDelete);\n  return toDelete;\n}\n\nexport async function coalesceSnapshots(\n  container: ContentContainer,\n  strategy: SnapshotPathStrategy,\n  options: CoalesceOptions = {},\n  basename?: string,\n): Promise<Version[]> {\n  const windowMs = options.windowMs ?? 60_000;\n  const versions = await listSnapshots(container, strategy, basename);\n  const toDelete: Version[] = [];\n\n  // Compare against the last kept snapshot. Pairwise comparison against a\n  // deleted neighbor would chain through a dense run and over-prune it.\n  if (versions.length > 0) {\n    let anchor = versions[0]!;\n    for (let index = 1; index < versions.length; index++) {\n      const candidate = versions[index]!;\n      if (anchor.timestamp.getTime() - candidate.timestamp.getTime() <= windowMs) {\n        toDelete.push(candidate);\n      } else {\n        anchor = candidate;\n      }\n    }\n  }\n\n  await removeSnapshots(container, toDelete);\n  return toDelete;\n}\n\nasync function removeSnapshots(\n  container: ContentContainer,\n  versions: readonly Version[],\n): Promise<void> {\n  for (const version of versions) await container.removeFile(version.path);\n}\n"],"mappings":"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","names":["decoder","encoder"]}