@agentshouse/mdmodel 0.1.0-alpha.4 → 0.1.0-alpha.5

package/README.md

@@ -76,8 +76,46 @@ a resulting collection supplies that collection's context to this same
 `validate` function. `parse`, `apply`, and `serialize` operate on a single text
 Document; they do not validate collection membership or consume binary bytes.
 `apply` sets one typed field, including a list field as a whole, replaces
-one declared section body against that value's prior content, or rewrites one
-Markdown link destination. A field change does not reformat the rest of the file.
+one existing section body or the preamble against that value's prior content,
+or rewrites one Markdown link destination. A section need not be declared by
+the Document's MD Type to be replaced. A field change does not reformat the rest of the file.
+
+`Document.preamble` is a readonly string containing the exact source after
+frontmatter and before the first section heading recognized by the existing
+section parser. Without a section it is the entire post-frontmatter body;
+without frontmatter it starts at the beginning of the Document. An empty span
+is `''`. It includes whitespace, newlines, a leading H1, and any fenced text
+before the first section. The closing frontmatter delimiter and its line ending
+belong to frontmatter. Section recognition and the syntax profile are unchanged.
+
+```ts
+const parsed = parse(content);
+if (parsed.ok) {
+  const change = {
+    kind: 'preamble' as const,
+    prior: parsed.document.preamble,
+    value: 'Updated introduction.\n\n',
+  };
+  const result = apply(parsed.document, change);
+  if (result.outcome === 'applied') serialize(result.document);
+}
+```
+
+`apply(document, { kind: 'preamble', prior, value })` compares `prior` to the
+current preamble exactly. A mismatch returns `{ outcome: 'stale', document }`
+with the unchanged current Document. A match replaces only that source span,
+then parses a new immutable Document; the original is unchanged. Frontmatter
+and section source outside the span retain their exact bytes, including newline
+and heading syntax. As with section replacement, `value` is literal source:
+no newline or separator is inserted, and the resulting source is parsed again.
+An invalid frontmatter result receives the existing parse refusal. Independent
+field, section, and preamble edits keep their own prior values valid.
+
+For a moved link, use `links` and the `link` change below to obtain the rewritten
+Document, then compare its public `preamble` and `sections` to the original.
+Submit the changed values with their original priors. Consumers need no source
+span calculation or private Model import. Collection validation remains a
+separate call against the resulting Library.
 
 `links(document, file)` is the inventory of that Document's ordinary link and
 image destinations that resolve to a collection Path, each with the destination

package/dist/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoDnF,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,WAAW,CA0C7D;AAiGD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAWvE;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAYrE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsDnF,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,WAAW,CAkD7D;AAyGD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAWvE;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAarE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEpD"}

package/dist/document.js

@@ -9,11 +9,12 @@ function refuse(file, rule, location) {
         location
     });
 }
-function freezeDocument(content, type, fields, sections, internal) {
+function freezeDocument(content, type, fields, preamble, sections, internal) {
     const document = Object.freeze({
         content,
         type,
         fields: Object.freeze(fields),
+        preamble,
         sections: Object.freeze(sections)
     });
     internals.set(document, internal);
@@ -31,7 +32,7 @@ export function parse(content, file = '') {
         const spans = headingSpans(content, 0);
         return {
             ok: true,
-            document: freezeDocument(content, undefined, {}, sectionsRecord(spans, content), {
+            document: freezeDocument(content, undefined, {}, content.slice(0, spans[0]?.headingStart), sectionsRecord(spans, content), {
                 root: null,
                 yamlEnd: 0,
                 bodyStart: 0
@@ -56,7 +57,7 @@ export function parse(content, file = '') {
         const record = fields;
         return {
             ok: true,
-            document: freezeDocument(content, declaredType(record), record, sectionsRecord(spans, content), {
+            document: freezeDocument(content, declaredType(record), record, content.slice(bodyStart, spans[0]?.headingStart), sectionsRecord(spans, content), {
                 root,
                 yamlEnd: fence.yamlEnd,
                 bodyStart
@@ -135,6 +136,22 @@ function applySection(document, name, value, prior) {
         document: parsed.document
     };
 }
+function applyPreamble(document, value, prior) {
+    if (document.preamble !== prior) return {
+        outcome: 'stale',
+        document
+    };
+    const start = bodyStartOf(document.content);
+    const parsed = parse(splice(document.content, start, start + document.preamble.length, value));
+    if (!parsed.ok) return {
+        outcome: 'refuse',
+        refusal: parsed.refusal
+    };
+    return {
+        outcome: 'applied',
+        document: parsed.document
+    };
+}
 function fitsBare(to) {
     if (to === '' || to.startsWith('<')) return false;
     let depth = 0;
@@ -204,6 +221,7 @@ export function links(document, file) {
 }
 export function apply(document, change) {
     if (change.kind === 'link') return applyLink(document, change.href, change.to);
+    if (change.kind === 'preamble') return applyPreamble(document, change.value, change.prior);
     try {
         if (change.kind === 'field') return applyField(document, change.name, change.value, change.prior);
         return applySection(document, change.name, change.value, change.prior);

package/dist/document.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/workspace/packages/mdmodel/src/document.ts"],"sourcesContent":["import { hrefOccurrences } from './links.js';\nimport { classifyHref, hrefSuffix } from './paths.js';\nimport { headingSpans, sectionsRecord } from './sections.js';\nimport { refusal } from './refuse.js';\nimport type { ApplyResult, Change, Document, Link, ParseResult } from './types.js';\nimport {\n  bodyStartAfterYaml,\n  bodyStartOf,\n  equalValue,\n  extractFrontmatter,\n  jsValue,\n  lineEnding,\n  mapEntry,\n  parseYamlMapping,\n  serializeJs,\n  serializeKey,\n  YamlError,\n  type YamlMap,\n} from './yaml.js';\n\ntype Internal = {\n  readonly root: YamlMap | null;\n  readonly yamlEnd: number;\n  readonly bodyStart: number;\n};\n\nconst internals = new WeakMap<Document, Internal>();\n\nfunction refuse(file: string, rule: string, location?: string) {\n  return location === undefined ? refusal(file, rule) : refusal(file, rule, { location });\n}\n\nfunction freezeDocument(\n  content: string,\n  type: string | undefined,\n  fields: Record<string, unknown>,\n  sections: Record<string, string>,\n  internal: Internal,\n): Document {\n  const document: Document = Object.freeze({\n    content,\n    type,\n    fields: Object.freeze(fields),\n    sections: Object.freeze(sections),\n  });\n  internals.set(document, internal);\n  return document;\n}\n\nfunction declaredType(fields: Record<string, unknown>): string | undefined {\n  const value = fields.type;\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== 'string' || value === '') return undefined;\n  return value;\n}\n\nexport function parse(content: string, file = ''): ParseResult {\n  const fence = extractFrontmatter(content);\n  if (fence.kind === 'none') {\n    const spans = headingSpans(content, 0);\n    return {\n      ok: true,\n      document: freezeDocument(content, undefined, {}, sectionsRecord(spans, content), {\n        root: null,\n        yamlEnd: 0,\n        bodyStart: 0,\n      }),\n    };\n  }\n  if (fence.kind === 'unclosed') return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n  try {\n    const root = parseYamlMapping(content, fence.yamlStart, fence.yamlEnd);\n    const fields = jsValue(root);\n    if (fields === null || typeof fields !== 'object' || Array.isArray(fields)) {\n      return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n    }\n    const bodyStart = bodyStartAfterYaml(content, fence.yamlEnd);\n    const spans = headingSpans(content, bodyStart);\n    const record = fields as Record<string, unknown>;\n    return {\n      ok: true,\n      document: freezeDocument(\n        content,\n        declaredType(record),\n        record,\n        sectionsRecord(spans, content),\n        {\n          root,\n          yamlEnd: fence.yamlEnd,\n          bodyStart,\n        },\n      ),\n    };\n  } catch (error) {\n    if (error instanceof YamlError)\n      return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n    throw error;\n  }\n}\n\nfunction splice(content: string, start: number, end: number, insert: string): string {\n  return content.slice(0, start) + insert + content.slice(end);\n}\n\nfunction applyField(document: Document, name: string, value: unknown, prior: unknown): ApplyResult {\n  const internal = internals.get(document);\n  if (internal === undefined || internal.root === null) {\n    return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', name) };\n  }\n  if (!equalValue(document.fields[name], prior)) {\n    return { outcome: 'stale', document };\n  }\n  let nextContent: string;\n  const existing = mapEntry(internal.root, name);\n  if (existing !== undefined) {\n    nextContent = splice(\n      document.content,\n      existing.value.start,\n      existing.value.end,\n      serializeJs(value),\n    );\n  } else {\n    const nl = lineEnding(document.content);\n    const line = `${serializeKey(name)}: ${serializeJs(value)}${nl}`;\n    const before = document.content.slice(0, internal.yamlEnd);\n    const prefix = before.endsWith('\\n') || before.endsWith('\\r\\n') ? '' : nl;\n    nextContent = splice(document.content, internal.yamlEnd, internal.yamlEnd, `${prefix}${line}`);\n  }\n  const parsed = parse(nextContent);\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nfunction applySection(document: Document, name: string, value: string, prior: string): ApplyResult {\n  const internal = internals.get(document);\n  if (internal === undefined)\n    return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };\n  const spans = headingSpans(document.content, internal.bodyStart);\n  const span = spans.find((item) => item.name === name);\n  if (span === undefined)\n    return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };\n  const current = document.content.slice(span.bodyStart, span.bodyEnd);\n  if (current !== prior) return { outcome: 'stale', document };\n  const parsed = parse(splice(document.content, span.bodyStart, span.bodyEnd, value));\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nfunction fitsBare(to: string): boolean {\n  if (to === '' || to.startsWith('<')) return false;\n  let depth = 0;\n  for (const character of to) {\n    if (/[\\s\\u0000-\\u001f\\u007f]/.test(character)) return false;\n    if (character === '(') depth += 1;\n    else if (character === ')') {\n      if (depth === 0) return false;\n      depth -= 1;\n    }\n  }\n  return depth === 0;\n}\n\nfunction fitsBrackets(to: string): boolean {\n  return to !== '' && !/[<>\\n\\r]/.test(to);\n}\n\nfunction destinationText(to: string, bracketed: boolean): string | null {\n  if (fitsBare(to)) return bracketed && fitsBrackets(to) ? `<${to}>` : to;\n  if (fitsBrackets(to)) return `<${to}>`;\n  return null;\n}\n\nfunction applyLink(document: Document, href: string, to: string): ApplyResult {\n  const content = document.content;\n  const bodyStart = bodyStartOf(content);\n  const matches = hrefOccurrences(content.slice(bodyStart)).filter(\n    (occurrence) => occurrence.href === href,\n  );\n  if (matches.length === 0) return { outcome: 'stale', document };\n  const written = to + hrefSuffix(href);\n  let rewritten = '';\n  let cursor = 0;\n  for (const match of matches) {\n    const text = destinationText(written, match.bracketed);\n    if (text === null)\n      return { outcome: 'refuse', refusal: refuse('', 'unwritable-link', written) };\n    rewritten += content.slice(cursor, bodyStart + match.start);\n    rewritten += text;\n    cursor = bodyStart + match.end;\n  }\n  const parsed = parse(rewritten + content.slice(cursor));\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nexport function links(document: Document, file: string): readonly Link[] {\n  const found: Link[] = [];\n  const seen = new Set<string>();\n  for (const occurrence of hrefOccurrences(document.content.slice(bodyStartOf(document.content)))) {\n    if (seen.has(occurrence.href)) continue;\n    const resolved = classifyHref(file, occurrence.href);\n    if (resolved.kind !== 'path') continue;\n    seen.add(occurrence.href);\n    found.push({ href: occurrence.href, target: resolved.path });\n  }\n  return found;\n}\n\nexport function apply(document: Document, change: Change): ApplyResult {\n  if (change.kind === 'link') return applyLink(document, change.href, change.to);\n  try {\n    if (change.kind === 'field')\n      return applyField(document, change.name, change.value, change.prior);\n    return applySection(document, change.name, change.value, change.prior);\n  } catch (error) {\n    if (error instanceof YamlError) {\n      return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', change.name) };\n    }\n    throw error;\n  }\n}\n\nexport function serialize(document: Document): string {\n  return document.content;\n}\n"],"names":["hrefOccurrences","classifyHref","hrefSuffix","headingSpans","sectionsRecord","refusal","bodyStartAfterYaml","bodyStartOf","equalValue","extractFrontmatter","jsValue","lineEnding","mapEntry","parseYamlMapping","serializeJs","serializeKey","YamlError","internals","WeakMap","refuse","file","rule","location","undefined","freezeDocument","content","type","fields","sections","internal","document","Object","freeze","set","declaredType","value","parse","fence","kind","spans","ok","root","yamlEnd","bodyStart","yamlStart","Array","isArray","record","error","splice","start","end","insert","slice","applyField","name","prior","get","outcome","nextContent","existing","nl","line","before","prefix","endsWith","parsed","applySection","span","find","item","current","bodyEnd","fitsBare","to","startsWith","depth","character","test","fitsBrackets","destinationText","bracketed","applyLink","href","matches","filter","occurrence","length","written","rewritten","cursor","match","text","links","found","seen","Set","has","resolved","add","push","target","path","apply","change","serialize"],"mappings":"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"}
+{"version":3,"sources":["/workspace/packages/mdmodel/src/document.ts"],"sourcesContent":["import { hrefOccurrences } from './links.js';\nimport { classifyHref, hrefSuffix } from './paths.js';\nimport { headingSpans, sectionsRecord } from './sections.js';\nimport { refusal } from './refuse.js';\nimport type { ApplyResult, Change, Document, Link, ParseResult } from './types.js';\nimport {\n  bodyStartAfterYaml,\n  bodyStartOf,\n  equalValue,\n  extractFrontmatter,\n  jsValue,\n  lineEnding,\n  mapEntry,\n  parseYamlMapping,\n  serializeJs,\n  serializeKey,\n  YamlError,\n  type YamlMap,\n} from './yaml.js';\n\ntype Internal = {\n  readonly root: YamlMap | null;\n  readonly yamlEnd: number;\n  readonly bodyStart: number;\n};\n\nconst internals = new WeakMap<Document, Internal>();\n\nfunction refuse(file: string, rule: string, location?: string) {\n  return location === undefined ? refusal(file, rule) : refusal(file, rule, { location });\n}\n\nfunction freezeDocument(\n  content: string,\n  type: string | undefined,\n  fields: Record<string, unknown>,\n  preamble: string,\n  sections: Record<string, string>,\n  internal: Internal,\n): Document {\n  const document: Document = Object.freeze({\n    content,\n    type,\n    fields: Object.freeze(fields),\n    preamble,\n    sections: Object.freeze(sections),\n  });\n  internals.set(document, internal);\n  return document;\n}\n\nfunction declaredType(fields: Record<string, unknown>): string | undefined {\n  const value = fields.type;\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== 'string' || value === '') return undefined;\n  return value;\n}\n\nexport function parse(content: string, file = ''): ParseResult {\n  const fence = extractFrontmatter(content);\n  if (fence.kind === 'none') {\n    const spans = headingSpans(content, 0);\n    return {\n      ok: true,\n      document: freezeDocument(\n        content,\n        undefined,\n        {},\n        content.slice(0, spans[0]?.headingStart),\n        sectionsRecord(spans, content),\n        {\n          root: null,\n          yamlEnd: 0,\n          bodyStart: 0,\n        },\n      ),\n    };\n  }\n  if (fence.kind === 'unclosed') return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n  try {\n    const root = parseYamlMapping(content, fence.yamlStart, fence.yamlEnd);\n    const fields = jsValue(root);\n    if (fields === null || typeof fields !== 'object' || Array.isArray(fields)) {\n      return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n    }\n    const bodyStart = bodyStartAfterYaml(content, fence.yamlEnd);\n    const spans = headingSpans(content, bodyStart);\n    const record = fields as Record<string, unknown>;\n    return {\n      ok: true,\n      document: freezeDocument(\n        content,\n        declaredType(record),\n        record,\n        content.slice(bodyStart, spans[0]?.headingStart),\n        sectionsRecord(spans, content),\n        {\n          root,\n          yamlEnd: fence.yamlEnd,\n          bodyStart,\n        },\n      ),\n    };\n  } catch (error) {\n    if (error instanceof YamlError)\n      return { ok: false, refusal: refuse(file, 'frontmatter-fence') };\n    throw error;\n  }\n}\n\nfunction splice(content: string, start: number, end: number, insert: string): string {\n  return content.slice(0, start) + insert + content.slice(end);\n}\n\nfunction applyField(document: Document, name: string, value: unknown, prior: unknown): ApplyResult {\n  const internal = internals.get(document);\n  if (internal === undefined || internal.root === null) {\n    return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', name) };\n  }\n  if (!equalValue(document.fields[name], prior)) {\n    return { outcome: 'stale', document };\n  }\n  let nextContent: string;\n  const existing = mapEntry(internal.root, name);\n  if (existing !== undefined) {\n    nextContent = splice(\n      document.content,\n      existing.value.start,\n      existing.value.end,\n      serializeJs(value),\n    );\n  } else {\n    const nl = lineEnding(document.content);\n    const line = `${serializeKey(name)}: ${serializeJs(value)}${nl}`;\n    const before = document.content.slice(0, internal.yamlEnd);\n    const prefix = before.endsWith('\\n') || before.endsWith('\\r\\n') ? '' : nl;\n    nextContent = splice(document.content, internal.yamlEnd, internal.yamlEnd, `${prefix}${line}`);\n  }\n  const parsed = parse(nextContent);\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nfunction applySection(document: Document, name: string, value: string, prior: string): ApplyResult {\n  const internal = internals.get(document);\n  if (internal === undefined)\n    return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };\n  const spans = headingSpans(document.content, internal.bodyStart);\n  const span = spans.find((item) => item.name === name);\n  if (span === undefined)\n    return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };\n  const current = document.content.slice(span.bodyStart, span.bodyEnd);\n  if (current !== prior) return { outcome: 'stale', document };\n  const parsed = parse(splice(document.content, span.bodyStart, span.bodyEnd, value));\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nfunction applyPreamble(document: Document, value: string, prior: string): ApplyResult {\n  if (document.preamble !== prior) return { outcome: 'stale', document };\n  const start = bodyStartOf(document.content);\n  const parsed = parse(splice(document.content, start, start + document.preamble.length, value));\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nfunction fitsBare(to: string): boolean {\n  if (to === '' || to.startsWith('<')) return false;\n  let depth = 0;\n  for (const character of to) {\n    if (/[\\s\\u0000-\\u001f\\u007f]/.test(character)) return false;\n    if (character === '(') depth += 1;\n    else if (character === ')') {\n      if (depth === 0) return false;\n      depth -= 1;\n    }\n  }\n  return depth === 0;\n}\n\nfunction fitsBrackets(to: string): boolean {\n  return to !== '' && !/[<>\\n\\r]/.test(to);\n}\n\nfunction destinationText(to: string, bracketed: boolean): string | null {\n  if (fitsBare(to)) return bracketed && fitsBrackets(to) ? `<${to}>` : to;\n  if (fitsBrackets(to)) return `<${to}>`;\n  return null;\n}\n\nfunction applyLink(document: Document, href: string, to: string): ApplyResult {\n  const content = document.content;\n  const bodyStart = bodyStartOf(content);\n  const matches = hrefOccurrences(content.slice(bodyStart)).filter(\n    (occurrence) => occurrence.href === href,\n  );\n  if (matches.length === 0) return { outcome: 'stale', document };\n  const written = to + hrefSuffix(href);\n  let rewritten = '';\n  let cursor = 0;\n  for (const match of matches) {\n    const text = destinationText(written, match.bracketed);\n    if (text === null)\n      return { outcome: 'refuse', refusal: refuse('', 'unwritable-link', written) };\n    rewritten += content.slice(cursor, bodyStart + match.start);\n    rewritten += text;\n    cursor = bodyStart + match.end;\n  }\n  const parsed = parse(rewritten + content.slice(cursor));\n  if (!parsed.ok) return { outcome: 'refuse', refusal: parsed.refusal };\n  return { outcome: 'applied', document: parsed.document };\n}\n\nexport function links(document: Document, file: string): readonly Link[] {\n  const found: Link[] = [];\n  const seen = new Set<string>();\n  for (const occurrence of hrefOccurrences(document.content.slice(bodyStartOf(document.content)))) {\n    if (seen.has(occurrence.href)) continue;\n    const resolved = classifyHref(file, occurrence.href);\n    if (resolved.kind !== 'path') continue;\n    seen.add(occurrence.href);\n    found.push({ href: occurrence.href, target: resolved.path });\n  }\n  return found;\n}\n\nexport function apply(document: Document, change: Change): ApplyResult {\n  if (change.kind === 'link') return applyLink(document, change.href, change.to);\n  if (change.kind === 'preamble') return applyPreamble(document, change.value, change.prior);\n  try {\n    if (change.kind === 'field')\n      return applyField(document, change.name, change.value, change.prior);\n    return applySection(document, change.name, change.value, change.prior);\n  } catch (error) {\n    if (error instanceof YamlError) {\n      return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', change.name) };\n    }\n    throw error;\n  }\n}\n\nexport function serialize(document: Document): string {\n  return document.content;\n}\n"],"names":["hrefOccurrences","classifyHref","hrefSuffix","headingSpans","sectionsRecord","refusal","bodyStartAfterYaml","bodyStartOf","equalValue","extractFrontmatter","jsValue","lineEnding","mapEntry","parseYamlMapping","serializeJs","serializeKey","YamlError","internals","WeakMap","refuse","file","rule","location","undefined","freezeDocument","content","type","fields","preamble","sections","internal","document","Object","freeze","set","declaredType","value","parse","fence","kind","spans","ok","slice","headingStart","root","yamlEnd","bodyStart","yamlStart","Array","isArray","record","error","splice","start","end","insert","applyField","name","prior","get","outcome","nextContent","existing","nl","line","before","prefix","endsWith","parsed","applySection","span","find","item","current","bodyEnd","applyPreamble","length","fitsBare","to","startsWith","depth","character","test","fitsBrackets","destinationText","bracketed","applyLink","href","matches","filter","occurrence","written","rewritten","cursor","match","text","links","found","seen","Set","has","resolved","add","push","target","path","apply","change","serialize"],"mappings":"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"}

package/dist/types.d.ts

@@ -6,6 +6,7 @@ export type Document = {
     readonly content: string;
     readonly type: string | undefined;
     readonly fields: Readonly<Record<string, unknown>>;
+    readonly preamble: string;
     readonly sections: Readonly<Record<string, string>>;
 };
 export type Refusal = {
@@ -41,6 +42,10 @@ export type Change = {
     readonly name: string;
     readonly value: string;
     readonly prior: string;
+} | {
+    readonly kind: 'preamble';
+    readonly value: string;
+    readonly prior: string;
 } | {
     readonly kind: 'link';
     readonly href: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC9B,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,MAAM,GACd;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC9B,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,IAAI,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,MAAM,GACd;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/workspace/packages/mdmodel/src/types.ts"],"sourcesContent":["export type Library = Readonly<Record<string, string>>;\n\nexport type ValidationContext = {\n  readonly binaryTargets: readonly string[];\n};\n\nexport type Document = {\n  readonly content: string;\n  readonly type: string | undefined;\n  readonly fields: Readonly<Record<string, unknown>>;\n  readonly sections: Readonly<Record<string, string>>;\n};\n\nexport type Refusal = {\n  readonly file: string;\n  readonly rule: string;\n  readonly version: string;\n  readonly location?: string;\n  readonly referrers?: readonly string[];\n};\n\nexport type Validation =\n  | { readonly verdict: 'accept' }\n  | ({ readonly verdict: 'refuse' } & Refusal);\n\nexport type ParseResult =\n  | { readonly ok: true; readonly document: Document }\n  | { readonly ok: false; readonly refusal: Refusal };\n\nexport type Link = {\n  readonly href: string;\n  readonly target: string;\n};\n\nexport type Change =\n  | {\n      readonly kind: 'field';\n      readonly name: string;\n      readonly value: unknown;\n      readonly prior: unknown;\n    }\n  | {\n      readonly kind: 'section';\n      readonly name: string;\n      readonly value: string;\n      readonly prior: string;\n    }\n  | {\n      readonly kind: 'link';\n      readonly href: string;\n      readonly to: string;\n    };\n\nexport type ApplyResult =\n  | { readonly outcome: 'applied'; readonly document: Document }\n  | { readonly outcome: 'stale'; readonly document: Document }\n  | { readonly outcome: 'refuse'; readonly refusal: Refusal };\n"],"names":[],"mappings":"AAqDA,WAG8D"}
+{"version":3,"sources":["/workspace/packages/mdmodel/src/types.ts"],"sourcesContent":["export type Library = Readonly<Record<string, string>>;\n\nexport type ValidationContext = {\n  readonly binaryTargets: readonly string[];\n};\n\nexport type Document = {\n  readonly content: string;\n  readonly type: string | undefined;\n  readonly fields: Readonly<Record<string, unknown>>;\n  readonly preamble: string;\n  readonly sections: Readonly<Record<string, string>>;\n};\n\nexport type Refusal = {\n  readonly file: string;\n  readonly rule: string;\n  readonly version: string;\n  readonly location?: string;\n  readonly referrers?: readonly string[];\n};\n\nexport type Validation =\n  | { readonly verdict: 'accept' }\n  | ({ readonly verdict: 'refuse' } & Refusal);\n\nexport type ParseResult =\n  | { readonly ok: true; readonly document: Document }\n  | { readonly ok: false; readonly refusal: Refusal };\n\nexport type Link = {\n  readonly href: string;\n  readonly target: string;\n};\n\nexport type Change =\n  | {\n      readonly kind: 'field';\n      readonly name: string;\n      readonly value: unknown;\n      readonly prior: unknown;\n    }\n  | {\n      readonly kind: 'section';\n      readonly name: string;\n      readonly value: string;\n      readonly prior: string;\n    }\n  | {\n      readonly kind: 'preamble';\n      readonly value: string;\n      readonly prior: string;\n    }\n  | {\n      readonly kind: 'link';\n      readonly href: string;\n      readonly to: string;\n    };\n\nexport type ApplyResult =\n  | { readonly outcome: 'applied'; readonly document: Document }\n  | { readonly outcome: 'stale'; readonly document: Document }\n  | { readonly outcome: 'refuse'; readonly refusal: Refusal };\n"],"names":[],"mappings":"AA2DA,WAG8D"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.4";
+export declare const VERSION = "0.1.0-alpha.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
-export const VERSION = '0.1.0-alpha.4';
+export const VERSION = '0.1.0-alpha.5';
 
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/workspace/packages/mdmodel/src/version.ts"],"sourcesContent":["export const VERSION = '0.1.0-alpha.4';\n"],"names":["VERSION"],"mappings":"AAAA,OAAO,MAAMA,UAAU,gBAAgB"}
+{"version":3,"sources":["/workspace/packages/mdmodel/src/version.ts"],"sourcesContent":["export const VERSION = '0.1.0-alpha.5';\n"],"names":["VERSION"],"mappings":"AAAA,OAAO,MAAMA,UAAU,gBAAgB"}

package/fixtures/README.md

@@ -7,6 +7,20 @@ compare `validate(library, context)` against `expected.json`. Text-only cases
 carry `{ "binaryTargets": [] }`. Binary targets are membership declarations;
 the corpus supplies no binary bytes or placeholder Documents.
 
+## Preamble operations
+
+`preamble.json` exercises the public parse/apply/serialize seam separately from
+the validation Libraries. Each row carries `name`, exact `source`, expected
+`preamble`, replacement `value`, and exact serialized `expected` output. Parse
+the source, compare `Document.preamble`, apply
+`{ kind: 'preamble', prior: preamble, value }`, and compare the serialized result.
+These cases cover empty and heading-free Documents, frontmatter boundaries,
+fenced headings, newline/source preservation, and the Runtime moved-export
+example from its [approved candidate](https://github.com/agentshouse/mdruntime/blob/ed0a6f0b95317d9ade846ec1f2871a3997519bc4/test/rooms.ts).
+The package check runs every row in ESM, CommonJS, and the browser-target VM
+bundle, also checking stale priors, immutable Documents, and conversion of the
+Runtime link rewrite into a preamble operation through public APIs.
+
 ## Verdict format
 
 Acceptance:

package/fixtures/preamble.json

@@ -0,0 +1,107 @@
+[
+  {
+    "name": "CRLF frontmatter and H2 closing syntax",
+    "source": "---\r\ntype: note\r\ntitle: \"Kept\" # syntax\r\n---\r\n\r\n# Title\r\nIntro.\r\n\r\n## Body ###\r\nKept.\r\n",
+    "preamble": "\r\n# Title\r\nIntro.\r\n\r\n",
+    "value": "\r\nNew intro.\r\n\r\n",
+    "expected": "---\r\ntype: note\r\ntitle: \"Kept\" # syntax\r\n---\r\n\r\nNew intro.\r\n\r\n## Body ###\r\nKept.\r\n"
+  },
+  {
+    "name": "untyped document without sections",
+    "source": "# Title\nAll body text.",
+    "preamble": "# Title\nAll body text.",
+    "value": "Replaced without final newline.",
+    "expected": "Replaced without final newline."
+  },
+  {
+    "name": "typed document without sections",
+    "source": "---\ntype: note\n---\n# Title\nAll body text.",
+    "preamble": "# Title\nAll body text.",
+    "value": "New body.\n",
+    "expected": "---\ntype: note\n---\nNew body.\n"
+  },
+  {
+    "name": "empty document",
+    "source": "",
+    "preamble": "",
+    "value": "First text.\n",
+    "expected": "First text.\n"
+  },
+  {
+    "name": "frontmatter only",
+    "source": "---\ntype: note\n---\n",
+    "preamble": "",
+    "value": "First text.\n",
+    "expected": "---\ntype: note\n---\nFirst text.\n"
+  },
+  {
+    "name": "frontmatter delimiter at EOF",
+    "source": "---\ntype: note\n---",
+    "preamble": "",
+    "value": "\nFirst text.",
+    "expected": "---\ntype: note\n---\nFirst text."
+  },
+  {
+    "name": "section starts at offset zero",
+    "source": "## Body\nKept.\n",
+    "preamble": "",
+    "value": "Intro.\n\n",
+    "expected": "Intro.\n\n## Body\nKept.\n"
+  },
+  {
+    "name": "section immediately after frontmatter",
+    "source": "---\ntype: note\n---\n## Body\nKept.\n",
+    "preamble": "",
+    "value": "Intro.\n",
+    "expected": "---\ntype: note\n---\nIntro.\n## Body\nKept.\n"
+  },
+  {
+    "name": "backtick fence hides a heading",
+    "source": "```md\n## Example\n```\n\n## Body\nKept.\n",
+    "preamble": "```md\n## Example\n```\n\n",
+    "value": "Example removed.\n",
+    "expected": "Example removed.\n## Body\nKept.\n"
+  },
+  {
+    "name": "tilde fence hides a heading",
+    "source": "  ~~~md\n## Example\n  ~~~\n\n## Body\nKept.",
+    "preamble": "  ~~~md\n## Example\n  ~~~\n\n",
+    "value": "Example removed.\n",
+    "expected": "Example removed.\n## Body\nKept."
+  },
+  {
+    "name": "unclosed fence carries the entire body",
+    "source": "---\ntype: note\n---\n```\n## Example\n",
+    "preamble": "```\n## Example\n",
+    "value": "Plain replacement.\n",
+    "expected": "---\ntype: note\n---\nPlain replacement.\n"
+  },
+  {
+    "name": "existing section parser ignores other heading forms",
+    "source": "# Title\n### Subheading\n> ## Quoted\n    ## Indented\nSetext\n------\n\n## Actual ##\nKept.\n",
+    "preamble": "# Title\n### Subheading\n> ## Quoted\n    ## Indented\nSetext\n------\n\n",
+    "value": "Intro.\n",
+    "expected": "Intro.\n## Actual ##\nKept.\n"
+  },
+  {
+    "name": "Unicode and mixed newlines",
+    "source": "---\r\ntype: note\r\n---\r\n🙂 Вступ\r\n\n## Body\nKept.\r\n",
+    "preamble": "🙂 Вступ\r\n\n",
+    "value": "Новий 🙂\n\n",
+    "expected": "---\r\ntype: note\r\n---\r\nНовий 🙂\n\n## Body\nKept.\r\n"
+  },
+  {
+    "name": "heading at EOF and empty replacement",
+    "source": "Intro.\n\n## Body",
+    "preamble": "Intro.\n\n",
+    "value": "",
+    "expected": "## Body"
+  },
+  {
+    "name": "Runtime moved export link",
+    "source": "---\ntype: note\ntitle: Filed note\n---\n\nFiled beside [the export](../data/export.csv).\n\n## Body\n\nThe destination above sits outside every section.\n",
+    "preamble": "\nFiled beside [the export](../data/export.csv).\n\n",
+    "value": "\nFiled beside [the export](../files/export.csv).\n\n",
+    "expected": "---\ntype: note\ntitle: Filed note\n---\n\nFiled beside [the export](../files/export.csv).\n\n## Body\n\nThe destination above sits outside every section.\n"
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/mdmodel",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "MD Type language, parser, validator, structured change application, Markdown syntax profile, and conformance fixtures",
   "license": "MIT",
   "type": "module",