@bendyline/squisq 1.5.2 → 2.0.1

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":"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","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"]}