@agentshouse/mdmodel 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/divide.js

@@ -0,0 +1,363 @@
+import { blockRanges, headingLines } from './blocks.js';
+import { projectionInput, rangeText } from './project.js';
+function node(draft) {
+    return {
+        start: draft.start,
+        end: draft.end,
+        bodyStart: draft.bodyStart,
+        heading: draft.heading,
+        children: draft.children.map(node)
+    };
+}
+function forest(state, range) {
+    const content = state.content;
+    const headings = headingLines(content, range.start, range.end);
+    const roots = [];
+    const open = [];
+    const first = headings[0]?.start ?? range.end;
+    if (first > range.start) {
+        roots.push({
+            level: 0,
+            start: range.start,
+            end: first,
+            bodyStart: range.start,
+            heading: '',
+            children: []
+        });
+    }
+    for (const heading of headings){
+        while((open[open.length - 1]?.level ?? 0) >= heading.level){
+            open.pop().end = heading.start;
+        }
+        const draft = {
+            level: heading.level,
+            start: heading.start,
+            end: range.end,
+            bodyStart: heading.next,
+            heading: `${textOf(state, {
+                start: heading.start,
+                end: heading.textEnd
+            })}\n\n`,
+            children: []
+        };
+        (open[open.length - 1]?.children ?? roots).push(draft);
+        open.push(draft);
+    }
+    return roots.map(node);
+}
+function isSpace(character) {
+    return character === ' ' || character === '\t' || character === '\n' || character === '\r';
+}
+const TERMINATORS = new Set([
+    '.',
+    '!',
+    '?',
+    '…',
+    '。',
+    '！',
+    '？'
+]);
+function isTerminator(character) {
+    return TERMINATORS.has(character);
+}
+const CLOSERS = new Set([
+    '"',
+    "'",
+    ')',
+    ']',
+    '»',
+    '”'
+]);
+function isCloser(character) {
+    return CLOSERS.has(character);
+}
+function sentenceBounds(text) {
+    const bounds = [
+        0
+    ];
+    let i = 0;
+    while(i < text.length){
+        if (!isTerminator(text[i])) {
+            i += 1;
+            continue;
+        }
+        let after = i + 1;
+        while(after < text.length && isCloser(text[after]))after += 1;
+        if (after >= text.length || !isSpace(text[after])) {
+            i = after + 1;
+            continue;
+        }
+        while(after < text.length && isSpace(text[after]))after += 1;
+        if (after < text.length) bounds.push(after);
+        i = after;
+    }
+    bounds.push(text.length);
+    return bounds;
+}
+function isTrailingSurrogate(text, index) {
+    const code = text.charCodeAt(index);
+    return code >= 0xdc00 && code <= 0xdfff;
+}
+function boundOf(cutting, from, to, budget) {
+    const limit = from + Math.max(budget, 1);
+    if (limit >= to) return to;
+    for(let index = limit; index > from + 1; index -= 1){
+        if (isSpace(cutting.text[index])) return index;
+    }
+    const inside = cutting.masks.find((mask)=>limit > mask.start && limit < mask.end);
+    if (inside !== undefined) return inside.start > from ? inside.start : Math.min(inside.end, to);
+    return isTrailingSurrogate(cutting.text, limit) ? limit + 1 : limit;
+}
+function utf8Size(code) {
+    if (code < 0x80) return 1;
+    if (code < 0x800) return 2;
+    if (code < 0x10000) return 3;
+    return 4;
+}
+function byteBounds(content, spans) {
+    const marks = [
+        ...new Set(spans.flatMap((span)=>[
+                span.start,
+                span.end
+            ]))
+    ].sort((left, right)=>left - right);
+    const bytes = new Map();
+    let index = 0;
+    let count = 0;
+    for (const mark of marks){
+        while(index < mark){
+            const code = content.codePointAt(index);
+            count += utf8Size(code);
+            index += code > 0xffff ? 2 : 1;
+        }
+        bytes.set(mark, count);
+    }
+    return spans.map((span)=>({
+            ...span,
+            start: bytes.get(span.start),
+            end: bytes.get(span.end)
+        }));
+}
+function textOf(state, extent) {
+    return rangeText(state.content, extent, state.edits);
+}
+function sourceCutting(state, extent) {
+    let text = state.content.slice(extent.start, extent.end);
+    const masks = [];
+    for (const edit of state.edits){
+        if (edit.start < extent.start || edit.end > extent.end) continue;
+        const from = edit.start - extent.start;
+        const to = edit.end - extent.start;
+        text = `${text.slice(0, from)}${'x'.repeat(to - from)}${text.slice(to)}`;
+        masks.push({
+            start: from,
+            end: to
+        });
+    }
+    return {
+        text,
+        masks,
+        piece: (from, to)=>{
+            const cut = {
+                start: extent.start + from,
+                end: extent.start + to
+            };
+            return {
+                ...cut,
+                text: textOf(state, cut)
+            };
+        }
+    };
+}
+function valueCutting(value) {
+    return {
+        text: value.text,
+        masks: [],
+        piece: (from, to)=>({
+                start: value.start,
+                end: value.end,
+                text: value.text.slice(from, to)
+            })
+    };
+}
+function prefixOf(state, body) {
+    if (body.emitted === 0 || body.heading.length >= state.budget) return '';
+    return body.heading;
+}
+function available(state, body) {
+    return state.budget - prefixOf(state, body).length;
+}
+function emit(state, body, piece) {
+    if (piece.text.trim() === '') return;
+    const text = prefixOf(state, body) + piece.text;
+    state.spans.push({
+        start: piece.start,
+        end: piece.end,
+        text
+    });
+    body.emitted += 1;
+}
+function merge(run) {
+    return {
+        start: Math.min(...run.map((unit)=>unit.start)),
+        end: Math.max(...run.map((unit)=>unit.end)),
+        text: run.map((unit)=>unit.text).join('')
+    };
+}
+function divideUnits(state, body, units) {
+    let run = [];
+    let length = 0;
+    const flush = ()=>{
+        if (run.length === 0) return;
+        emit(state, body, merge(run));
+        run = [];
+        length = 0;
+    };
+    for (const unit of units){
+        if (run.length > 0 && length + unit.text.length > available(state, body)) flush();
+        if (unit.text.length > available(state, body)) {
+            flush();
+            unit.descend();
+            continue;
+        }
+        run.push(unit);
+        length += unit.text.length;
+    }
+    flush();
+}
+function divideBound(state, body, cutting, range) {
+    let start = range.start;
+    while(start < range.end){
+        const stop = boundOf(cutting, start, range.end, available(state, body));
+        const piece = cutting.piece(start, stop);
+        if (cutting.masks.length === 0 || piece.text.length <= available(state, body)) {
+            emit(state, body, piece);
+        } else {
+            divideBound(state, body, valueCutting(piece), {
+                start: 0,
+                end: piece.text.length
+            });
+        }
+        start = stop;
+    }
+}
+function divideSentences(state, body, cutting) {
+    const cut = cutting.piece;
+    const bounds = sentenceBounds(cutting.text);
+    let index = 0;
+    while(index + 1 < bounds.length){
+        const alone = {
+            start: bounds[index],
+            end: bounds[index + 1]
+        };
+        if (cut(alone.start, alone.end).text.length > available(state, body)) {
+            divideBound(state, body, cutting, alone);
+            index += 1;
+            continue;
+        }
+        const carried = bounds[Math.max(index - 1, 0)];
+        const from = cut(carried, alone.end).text.length <= available(state, body) ? carried : alone.start;
+        let last = index;
+        while(last + 2 < bounds.length && cut(from, bounds[last + 2]).text.length <= available(state, body)){
+            last += 1;
+        }
+        emit(state, body, cut(from, bounds[last + 1]));
+        index = last + 1;
+    }
+}
+function blockUnit(state, body, block) {
+    return {
+        start: block.start,
+        end: block.end,
+        text: textOf(state, block),
+        descend: ()=>divideSentences(state, body, sourceCutting(state, block))
+    };
+}
+function valueUnit(state, body, value) {
+    return {
+        start: value.start,
+        end: value.end,
+        text: value.text,
+        descend: ()=>divideSentences(state, body, valueCutting(value))
+    };
+}
+function nodeUnit(state, subject) {
+    return {
+        start: subject.start,
+        end: subject.end,
+        text: textOf(state, subject),
+        descend: ()=>divideNode(state, subject)
+    };
+}
+function ownBlocks(subject, end, blocks) {
+    const first = blocks[0];
+    return first === undefined ? [
+        {
+            start: subject.start,
+            end
+        }
+    ] : [
+        {
+            start: subject.start,
+            end: first.end
+        },
+        ...blocks.slice(1)
+    ];
+}
+function divideNode(state, subject) {
+    const end = subject.children[0]?.start ?? subject.end;
+    const blocks = blockRanges(state.content, subject.bodyStart, end);
+    const children = {
+        heading: '',
+        emitted: 0
+    };
+    if (blocks.length === 0 && subject.children.length > 0) {
+        const [first, ...rest] = subject.children;
+        const led = [
+            {
+                ...first,
+                start: subject.start
+            },
+            ...rest
+        ];
+        divideUnits(state, children, led.map((child)=>nodeUnit(state, child)));
+        return;
+    }
+    const body = {
+        heading: subject.heading,
+        emitted: 0
+    };
+    const own = ownBlocks(subject, end, blocks);
+    divideUnits(state, body, own.map((block)=>blockUnit(state, body, block)));
+    divideUnits(state, children, subject.children.map((child)=>nodeUnit(state, child)));
+}
+function divideInput(state, input) {
+    const body = {
+        heading: '',
+        emitted: 0
+    };
+    divideUnits(state, body, [
+        ...input.values.map((value)=>valueUnit(state, body, value)),
+        ...input.ranges.flatMap((range)=>forest(state, range).map((subject)=>nodeUnit(state, subject)))
+    ]);
+}
+export function divide(document, file, context) {
+    const result = projectionInput(document, file, context);
+    if (!result.ok) return {
+        ok: false,
+        refusal: result.refusal
+    };
+    const state = {
+        content: document.content,
+        edits: result.input.edits,
+        budget: context.budget,
+        spans: []
+    };
+    divideInput(state, result.input);
+    return {
+        ok: true,
+        spans: byteBounds(document.content, state.spans)
+    };
+}
+
+//# sourceMappingURL=divide.js.map

package/dist/divide.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/workspace/packages/mdmodel/src/divide.ts"],"sourcesContent":["import { blockRanges, headingLines } from './blocks.js';\nimport { projectionInput, rangeText, type Edit, type Input, type Piece } from './project.js';\nimport type { Division, DivisionContext, Document, Extent, Span } from './types.js';\n\ntype Node = {\n  readonly start: number;\n  readonly end: number;\n  readonly bodyStart: number;\n  readonly heading: string;\n  readonly children: readonly Node[];\n};\n\ntype Draft = {\n  readonly level: number;\n  start: number;\n  end: number;\n  readonly bodyStart: number;\n  readonly heading: string;\n  readonly children: Draft[];\n};\n\ntype State = {\n  readonly content: string;\n  readonly edits: readonly Edit[];\n  readonly budget: number;\n  readonly spans: Span[];\n};\n\ntype Body = {\n  readonly heading: string;\n  emitted: number;\n};\n\ntype Unit = Piece & { readonly descend: () => void };\n\ntype Cutting = {\n  readonly text: string;\n  readonly masks: readonly Extent[];\n  readonly piece: (from: number, to: number) => Piece;\n};\n\nfunction node(draft: Draft): Node {\n  return {\n    start: draft.start,\n    end: draft.end,\n    bodyStart: draft.bodyStart,\n    heading: draft.heading,\n    children: draft.children.map(node),\n  };\n}\n\nfunction forest(state: State, range: Extent): Node[] {\n  const content = state.content;\n  const headings = headingLines(content, range.start, range.end);\n  const roots: Draft[] = [];\n  const open: Draft[] = [];\n  const first = headings[0]?.start ?? range.end;\n  if (first > range.start) {\n    roots.push({\n      level: 0,\n      start: range.start,\n      end: first,\n      bodyStart: range.start,\n      heading: '',\n      children: [],\n    });\n  }\n  for (const heading of headings) {\n    while ((open[open.length - 1]?.level ?? 0) >= heading.level) {\n      open.pop()!.end = heading.start;\n    }\n    const draft: Draft = {\n      level: heading.level,\n      start: heading.start,\n      end: range.end,\n      bodyStart: heading.next,\n      heading: `${textOf(state, { start: heading.start, end: heading.textEnd })}\\n\\n`,\n      children: [],\n    };\n    (open[open.length - 1]?.children ?? roots).push(draft);\n    open.push(draft);\n  }\n  return roots.map(node);\n}\n\nfunction isSpace(character: string): boolean {\n  return character === ' ' || character === '\\t' || character === '\\n' || character === '\\r';\n}\n\nconst TERMINATORS = new Set(['.', '!', '?', '…', '。', '！', '？']);\n\nfunction isTerminator(character: string): boolean {\n  return TERMINATORS.has(character);\n}\n\nconst CLOSERS = new Set(['\"', \"'\", ')', ']', '»', '”']);\n\nfunction isCloser(character: string): boolean {\n  return CLOSERS.has(character);\n}\n\nfunction sentenceBounds(text: string): number[] {\n  const bounds = [0];\n  let i = 0;\n  while (i < text.length) {\n    if (!isTerminator(text[i]!)) {\n      i += 1;\n      continue;\n    }\n    let after = i + 1;\n    while (after < text.length && isCloser(text[after]!)) after += 1;\n    if (after >= text.length || !isSpace(text[after]!)) {\n      i = after + 1;\n      continue;\n    }\n    while (after < text.length && isSpace(text[after]!)) after += 1;\n    if (after < text.length) bounds.push(after);\n    i = after;\n  }\n  bounds.push(text.length);\n  return bounds;\n}\n\nfunction isTrailingSurrogate(text: string, index: number): boolean {\n  const code = text.charCodeAt(index);\n  return code >= 0xdc00 && code <= 0xdfff;\n}\n\nfunction boundOf(cutting: Cutting, from: number, to: number, budget: number): number {\n  const limit = from + Math.max(budget, 1);\n  if (limit >= to) return to;\n  for (let index = limit; index > from + 1; index -= 1) {\n    if (isSpace(cutting.text[index]!)) return index;\n  }\n  const inside = cutting.masks.find((mask) => limit > mask.start && limit < mask.end);\n  if (inside !== undefined) return inside.start > from ? inside.start : Math.min(inside.end, to);\n  return isTrailingSurrogate(cutting.text, limit) ? limit + 1 : limit;\n}\n\nfunction utf8Size(code: number): number {\n  if (code < 0x80) return 1;\n  if (code < 0x800) return 2;\n  if (code < 0x10000) return 3;\n  return 4;\n}\n\nfunction byteBounds(content: string, spans: readonly Span[]): Span[] {\n  const marks = [...new Set(spans.flatMap((span) => [span.start, span.end]))].sort(\n    (left, right) => left - right,\n  );\n  const bytes = new Map<number, number>();\n  let index = 0;\n  let count = 0;\n  for (const mark of marks) {\n    while (index < mark) {\n      const code = content.codePointAt(index)!;\n      count += utf8Size(code);\n      index += code > 0xffff ? 2 : 1;\n    }\n    bytes.set(mark, count);\n  }\n  return spans.map((span) => ({\n    ...span,\n    start: bytes.get(span.start)!,\n    end: bytes.get(span.end)!,\n  }));\n}\n\nfunction textOf(state: State, extent: Extent): string {\n  return rangeText(state.content, extent, state.edits);\n}\n\nfunction sourceCutting(state: State, extent: Extent): Cutting {\n  let text = state.content.slice(extent.start, extent.end);\n  const masks: Extent[] = [];\n  for (const edit of state.edits) {\n    if (edit.start < extent.start || edit.end > extent.end) continue;\n    const from = edit.start - extent.start;\n    const to = edit.end - extent.start;\n    text = `${text.slice(0, from)}${'x'.repeat(to - from)}${text.slice(to)}`;\n    masks.push({ start: from, end: to });\n  }\n  return {\n    text,\n    masks,\n    piece: (from, to) => {\n      const cut = { start: extent.start + from, end: extent.start + to };\n      return { ...cut, text: textOf(state, cut) };\n    },\n  };\n}\n\nfunction valueCutting(value: Piece): Cutting {\n  return {\n    text: value.text,\n    masks: [],\n    piece: (from, to) => ({ start: value.start, end: value.end, text: value.text.slice(from, to) }),\n  };\n}\n\nfunction prefixOf(state: State, body: Body): string {\n  if (body.emitted === 0 || body.heading.length >= state.budget) return '';\n  return body.heading;\n}\n\nfunction available(state: State, body: Body): number {\n  return state.budget - prefixOf(state, body).length;\n}\n\nfunction emit(state: State, body: Body, piece: Piece): void {\n  if (piece.text.trim() === '') return;\n  const text = prefixOf(state, body) + piece.text;\n  state.spans.push({ start: piece.start, end: piece.end, text });\n  body.emitted += 1;\n}\n\nfunction merge(run: readonly Unit[]): Piece {\n  return {\n    start: Math.min(...run.map((unit) => unit.start)),\n    end: Math.max(...run.map((unit) => unit.end)),\n    text: run.map((unit) => unit.text).join(''),\n  };\n}\n\nfunction divideUnits(state: State, body: Body, units: readonly Unit[]): void {\n  let run: Unit[] = [];\n  let length = 0;\n  const flush = (): void => {\n    if (run.length === 0) return;\n    emit(state, body, merge(run));\n    run = [];\n    length = 0;\n  };\n  for (const unit of units) {\n    if (run.length > 0 && length + unit.text.length > available(state, body)) flush();\n    if (unit.text.length > available(state, body)) {\n      flush();\n      unit.descend();\n      continue;\n    }\n    run.push(unit);\n    length += unit.text.length;\n  }\n  flush();\n}\n\nfunction divideBound(state: State, body: Body, cutting: Cutting, range: Extent): void {\n  let start = range.start;\n  while (start < range.end) {\n    const stop = boundOf(cutting, start, range.end, available(state, body));\n    const piece = cutting.piece(start, stop);\n    if (cutting.masks.length === 0 || piece.text.length <= available(state, body)) {\n      emit(state, body, piece);\n    } else {\n      divideBound(state, body, valueCutting(piece), { start: 0, end: piece.text.length });\n    }\n    start = stop;\n  }\n}\n\nfunction divideSentences(state: State, body: Body, cutting: Cutting): void {\n  const cut = cutting.piece;\n  const bounds = sentenceBounds(cutting.text);\n  let index = 0;\n  while (index + 1 < bounds.length) {\n    const alone = { start: bounds[index]!, end: bounds[index + 1]! };\n    if (cut(alone.start, alone.end).text.length > available(state, body)) {\n      divideBound(state, body, cutting, alone);\n      index += 1;\n      continue;\n    }\n    const carried = bounds[Math.max(index - 1, 0)]!;\n    const from =\n      cut(carried, alone.end).text.length <= available(state, body) ? carried : alone.start;\n    let last = index;\n    while (\n      last + 2 < bounds.length &&\n      cut(from, bounds[last + 2]!).text.length <= available(state, body)\n    ) {\n      last += 1;\n    }\n    emit(state, body, cut(from, bounds[last + 1]!));\n    index = last + 1;\n  }\n}\n\nfunction blockUnit(state: State, body: Body, block: Extent): Unit {\n  return {\n    start: block.start,\n    end: block.end,\n    text: textOf(state, block),\n    descend: () => divideSentences(state, body, sourceCutting(state, block)),\n  };\n}\n\nfunction valueUnit(state: State, body: Body, value: Piece): Unit {\n  return {\n    start: value.start,\n    end: value.end,\n    text: value.text,\n    descend: () => divideSentences(state, body, valueCutting(value)),\n  };\n}\n\nfunction nodeUnit(state: State, subject: Node): Unit {\n  return {\n    start: subject.start,\n    end: subject.end,\n    text: textOf(state, subject),\n    descend: () => divideNode(state, subject),\n  };\n}\n\nfunction ownBlocks(subject: Node, end: number, blocks: readonly Extent[]): Extent[] {\n  const first = blocks[0];\n  return first === undefined\n    ? [{ start: subject.start, end }]\n    : [{ start: subject.start, end: first.end }, ...blocks.slice(1)];\n}\n\nfunction divideNode(state: State, subject: Node): void {\n  const end = subject.children[0]?.start ?? subject.end;\n  const blocks = blockRanges(state.content, subject.bodyStart, end);\n  const children: Body = { heading: '', emitted: 0 };\n  if (blocks.length === 0 && subject.children.length > 0) {\n    const [first, ...rest] = subject.children;\n    const led = [{ ...first!, start: subject.start }, ...rest];\n    divideUnits(\n      state,\n      children,\n      led.map((child) => nodeUnit(state, child)),\n    );\n    return;\n  }\n  const body: Body = { heading: subject.heading, emitted: 0 };\n  const own = ownBlocks(subject, end, blocks);\n  divideUnits(\n    state,\n    body,\n    own.map((block) => blockUnit(state, body, block)),\n  );\n  divideUnits(\n    state,\n    children,\n    subject.children.map((child) => nodeUnit(state, child)),\n  );\n}\n\nfunction divideInput(state: State, input: Input): void {\n  const body: Body = { heading: '', emitted: 0 };\n  divideUnits(state, body, [\n    ...input.values.map((value) => valueUnit(state, body, value)),\n    ...input.ranges.flatMap((range) =>\n      forest(state, range).map((subject) => nodeUnit(state, subject)),\n    ),\n  ]);\n}\n\nexport function divide(document: Document, file: string, context: DivisionContext): Division {\n  const result = projectionInput(document, file, context);\n  if (!result.ok) return { ok: false, refusal: result.refusal };\n  const state: State = {\n    content: document.content,\n    edits: result.input.edits,\n    budget: context.budget,\n    spans: [],\n  };\n  divideInput(state, result.input);\n  return { ok: true, spans: byteBounds(document.content, state.spans) };\n}\n"],"names":["blockRanges","headingLines","projectionInput","rangeText","node","draft","start","end","bodyStart","heading","children","map","forest","state","range","content","headings","roots","open","first","push","level","length","pop","next","textOf","textEnd","isSpace","character","TERMINATORS","Set","isTerminator","has","CLOSERS","isCloser","sentenceBounds","text","bounds","i","after","isTrailingSurrogate","index","code","charCodeAt","boundOf","cutting","from","to","budget","limit","Math","max","inside","masks","find","mask","undefined","min","utf8Size","byteBounds","spans","marks","flatMap","span","sort","left","right","bytes","Map","count","mark","codePointAt","set","get","extent","edits","sourceCutting","slice","edit","repeat","piece","cut","valueCutting","value","prefixOf","body","emitted","available","emit","trim","merge","run","unit","join","divideUnits","units","flush","descend","divideBound","stop","divideSentences","alone","carried","last","blockUnit","block","valueUnit","nodeUnit","subject","divideNode","ownBlocks","blocks","rest","led","child","own","divideInput","input","values","ranges","divide","document","file","context","result","ok","refusal"],"mappings":"AAAA,SAASA,WAAW,EAAEC,YAAY,QAAQ,cAAc;AACxD,SAASC,eAAe,EAAEC,SAAS,QAA2C,eAAe;AAwC7F,SAASC,KAAKC,KAAY;IACxB,OAAO;QACLC,OAAOD,MAAMC,KAAK;QAClBC,KAAKF,MAAME,GAAG;QACdC,WAAWH,MAAMG,SAAS;QAC1BC,SAASJ,MAAMI,OAAO;QACtBC,UAAUL,MAAMK,QAAQ,CAACC,GAAG,CAACP;IAC/B;AACF;AAEA,SAASQ,OAAOC,KAAY,EAAEC,KAAa;IACzC,MAAMC,UAAUF,MAAME,OAAO;IAC7B,MAAMC,WAAWf,aAAac,SAASD,MAAMR,KAAK,EAAEQ,MAAMP,GAAG;IAC7D,MAAMU,QAAiB,EAAE;IACzB,MAAMC,OAAgB,EAAE;IACxB,MAAMC,QAAQH,QAAQ,CAAC,EAAE,EAAEV,SAASQ,MAAMP,GAAG;IAC7C,IAAIY,QAAQL,MAAMR,KAAK,EAAE;QACvBW,MAAMG,IAAI,CAAC;YACTC,OAAO;YACPf,OAAOQ,MAAMR,KAAK;YAClBC,KAAKY;YACLX,WAAWM,MAAMR,KAAK;YACtBG,SAAS;YACTC,UAAU,EAAE;QACd;IACF;IACA,KAAK,MAAMD,WAAWO,SAAU;QAC9B,MAAO,AAACE,CAAAA,IAAI,CAACA,KAAKI,MAAM,GAAG,EAAE,EAAED,SAAS,CAAA,KAAMZ,QAAQY,KAAK,CAAE;YAC3DH,KAAKK,GAAG,GAAIhB,GAAG,GAAGE,QAAQH,KAAK;QACjC;QACA,MAAMD,QAAe;YACnBgB,OAAOZ,QAAQY,KAAK;YACpBf,OAAOG,QAAQH,KAAK;YACpBC,KAAKO,MAAMP,GAAG;YACdC,WAAWC,QAAQe,IAAI;YACvBf,SAAS,GAAGgB,OAAOZ,OAAO;gBAAEP,OAAOG,QAAQH,KAAK;gBAAEC,KAAKE,QAAQiB,OAAO;YAAC,GAAG,IAAI,CAAC;YAC/EhB,UAAU,EAAE;QACd;QACCQ,CAAAA,IAAI,CAACA,KAAKI,MAAM,GAAG,EAAE,EAAEZ,YAAYO,KAAI,EAAGG,IAAI,CAACf;QAChDa,KAAKE,IAAI,CAACf;IACZ;IACA,OAAOY,MAAMN,GAAG,CAACP;AACnB;AAEA,SAASuB,QAAQC,SAAiB;IAChC,OAAOA,cAAc,OAAOA,cAAc,QAAQA,cAAc,QAAQA,cAAc;AACxF;AAEA,MAAMC,cAAc,IAAIC,IAAI;IAAC;IAAK;IAAK;IAAK;IAAK;IAAK;IAAK;CAAI;AAE/D,SAASC,aAAaH,SAAiB;IACrC,OAAOC,YAAYG,GAAG,CAACJ;AACzB;AAEA,MAAMK,UAAU,IAAIH,IAAI;IAAC;IAAK;IAAK;IAAK;IAAK;IAAK;CAAI;AAEtD,SAASI,SAASN,SAAiB;IACjC,OAAOK,QAAQD,GAAG,CAACJ;AACrB;AAEA,SAASO,eAAeC,IAAY;IAClC,MAAMC,SAAS;QAAC;KAAE;IAClB,IAAIC,IAAI;IACR,MAAOA,IAAIF,KAAKd,MAAM,CAAE;QACtB,IAAI,CAACS,aAAaK,IAAI,CAACE,EAAE,GAAI;YAC3BA,KAAK;YACL;QACF;QACA,IAAIC,QAAQD,IAAI;QAChB,MAAOC,QAAQH,KAAKd,MAAM,IAAIY,SAASE,IAAI,CAACG,MAAM,EAAIA,SAAS;QAC/D,IAAIA,SAASH,KAAKd,MAAM,IAAI,CAACK,QAAQS,IAAI,CAACG,MAAM,GAAI;YAClDD,IAAIC,QAAQ;YACZ;QACF;QACA,MAAOA,QAAQH,KAAKd,MAAM,IAAIK,QAAQS,IAAI,CAACG,MAAM,EAAIA,SAAS;QAC9D,IAAIA,QAAQH,KAAKd,MAAM,EAAEe,OAAOjB,IAAI,CAACmB;QACrCD,IAAIC;IACN;IACAF,OAAOjB,IAAI,CAACgB,KAAKd,MAAM;IACvB,OAAOe;AACT;AAEA,SAASG,oBAAoBJ,IAAY,EAAEK,KAAa;IACtD,MAAMC,OAAON,KAAKO,UAAU,CAACF;IAC7B,OAAOC,QAAQ,UAAUA,QAAQ;AACnC;AAEA,SAASE,QAAQC,OAAgB,EAAEC,IAAY,EAAEC,EAAU,EAAEC,MAAc;IACzE,MAAMC,QAAQH,OAAOI,KAAKC,GAAG,CAACH,QAAQ;IACtC,IAAIC,SAASF,IAAI,OAAOA;IACxB,IAAK,IAAIN,QAAQQ,OAAOR,QAAQK,OAAO,GAAGL,SAAS,EAAG;QACpD,IAAId,QAAQkB,QAAQT,IAAI,CAACK,MAAM,GAAI,OAAOA;IAC5C;IACA,MAAMW,SAASP,QAAQQ,KAAK,CAACC,IAAI,CAAC,CAACC,OAASN,QAAQM,KAAKjD,KAAK,IAAI2C,QAAQM,KAAKhD,GAAG;IAClF,IAAI6C,WAAWI,WAAW,OAAOJ,OAAO9C,KAAK,GAAGwC,OAAOM,OAAO9C,KAAK,GAAG4C,KAAKO,GAAG,CAACL,OAAO7C,GAAG,EAAEwC;IAC3F,OAAOP,oBAAoBK,QAAQT,IAAI,EAAEa,SAASA,QAAQ,IAAIA;AAChE;AAEA,SAASS,SAAShB,IAAY;IAC5B,IAAIA,OAAO,MAAM,OAAO;IACxB,IAAIA,OAAO,OAAO,OAAO;IACzB,IAAIA,OAAO,SAAS,OAAO;IAC3B,OAAO;AACT;AAEA,SAASiB,WAAW5C,OAAe,EAAE6C,KAAsB;IACzD,MAAMC,QAAQ;WAAI,IAAI/B,IAAI8B,MAAME,OAAO,CAAC,CAACC,OAAS;gBAACA,KAAKzD,KAAK;gBAAEyD,KAAKxD,GAAG;aAAC;KAAG,CAACyD,IAAI,CAC9E,CAACC,MAAMC,QAAUD,OAAOC;IAE1B,MAAMC,QAAQ,IAAIC;IAClB,IAAI3B,QAAQ;IACZ,IAAI4B,QAAQ;IACZ,KAAK,MAAMC,QAAQT,MAAO;QACxB,MAAOpB,QAAQ6B,KAAM;YACnB,MAAM5B,OAAO3B,QAAQwD,WAAW,CAAC9B;YACjC4B,SAASX,SAAShB;YAClBD,SAASC,OAAO,SAAS,IAAI;QAC/B;QACAyB,MAAMK,GAAG,CAACF,MAAMD;IAClB;IACA,OAAOT,MAAMjD,GAAG,CAAC,CAACoD,OAAU,CAAA;YAC1B,GAAGA,IAAI;YACPzD,OAAO6D,MAAMM,GAAG,CAACV,KAAKzD,KAAK;YAC3BC,KAAK4D,MAAMM,GAAG,CAACV,KAAKxD,GAAG;QACzB,CAAA;AACF;AAEA,SAASkB,OAAOZ,KAAY,EAAE6D,MAAc;IAC1C,OAAOvE,UAAUU,MAAME,OAAO,EAAE2D,QAAQ7D,MAAM8D,KAAK;AACrD;AAEA,SAASC,cAAc/D,KAAY,EAAE6D,MAAc;IACjD,IAAItC,OAAOvB,MAAME,OAAO,CAAC8D,KAAK,CAACH,OAAOpE,KAAK,EAAEoE,OAAOnE,GAAG;IACvD,MAAM8C,QAAkB,EAAE;IAC1B,KAAK,MAAMyB,QAAQjE,MAAM8D,KAAK,CAAE;QAC9B,IAAIG,KAAKxE,KAAK,GAAGoE,OAAOpE,KAAK,IAAIwE,KAAKvE,GAAG,GAAGmE,OAAOnE,GAAG,EAAE;QACxD,MAAMuC,OAAOgC,KAAKxE,KAAK,GAAGoE,OAAOpE,KAAK;QACtC,MAAMyC,KAAK+B,KAAKvE,GAAG,GAAGmE,OAAOpE,KAAK;QAClC8B,OAAO,GAAGA,KAAKyC,KAAK,CAAC,GAAG/B,QAAQ,IAAIiC,MAAM,CAAChC,KAAKD,QAAQV,KAAKyC,KAAK,CAAC9B,KAAK;QACxEM,MAAMjC,IAAI,CAAC;YAAEd,OAAOwC;YAAMvC,KAAKwC;QAAG;IACpC;IACA,OAAO;QACLX;QACAiB;QACA2B,OAAO,CAAClC,MAAMC;YACZ,MAAMkC,MAAM;gBAAE3E,OAAOoE,OAAOpE,KAAK,GAAGwC;gBAAMvC,KAAKmE,OAAOpE,KAAK,GAAGyC;YAAG;YACjE,OAAO;gBAAE,GAAGkC,GAAG;gBAAE7C,MAAMX,OAAOZ,OAAOoE;YAAK;QAC5C;IACF;AACF;AAEA,SAASC,aAAaC,KAAY;IAChC,OAAO;QACL/C,MAAM+C,MAAM/C,IAAI;QAChBiB,OAAO,EAAE;QACT2B,OAAO,CAAClC,MAAMC,KAAQ,CAAA;gBAAEzC,OAAO6E,MAAM7E,KAAK;gBAAEC,KAAK4E,MAAM5E,GAAG;gBAAE6B,MAAM+C,MAAM/C,IAAI,CAACyC,KAAK,CAAC/B,MAAMC;YAAI,CAAA;IAC/F;AACF;AAEA,SAASqC,SAASvE,KAAY,EAAEwE,IAAU;IACxC,IAAIA,KAAKC,OAAO,KAAK,KAAKD,KAAK5E,OAAO,CAACa,MAAM,IAAIT,MAAMmC,MAAM,EAAE,OAAO;IACtE,OAAOqC,KAAK5E,OAAO;AACrB;AAEA,SAAS8E,UAAU1E,KAAY,EAAEwE,IAAU;IACzC,OAAOxE,MAAMmC,MAAM,GAAGoC,SAASvE,OAAOwE,MAAM/D,MAAM;AACpD;AAEA,SAASkE,KAAK3E,KAAY,EAAEwE,IAAU,EAAEL,KAAY;IAClD,IAAIA,MAAM5C,IAAI,CAACqD,IAAI,OAAO,IAAI;IAC9B,MAAMrD,OAAOgD,SAASvE,OAAOwE,QAAQL,MAAM5C,IAAI;IAC/CvB,MAAM+C,KAAK,CAACxC,IAAI,CAAC;QAAEd,OAAO0E,MAAM1E,KAAK;QAAEC,KAAKyE,MAAMzE,GAAG;QAAE6B;IAAK;IAC5DiD,KAAKC,OAAO,IAAI;AAClB;AAEA,SAASI,MAAMC,GAAoB;IACjC,OAAO;QACLrF,OAAO4C,KAAKO,GAAG,IAAIkC,IAAIhF,GAAG,CAAC,CAACiF,OAASA,KAAKtF,KAAK;QAC/CC,KAAK2C,KAAKC,GAAG,IAAIwC,IAAIhF,GAAG,CAAC,CAACiF,OAASA,KAAKrF,GAAG;QAC3C6B,MAAMuD,IAAIhF,GAAG,CAAC,CAACiF,OAASA,KAAKxD,IAAI,EAAEyD,IAAI,CAAC;IAC1C;AACF;AAEA,SAASC,YAAYjF,KAAY,EAAEwE,IAAU,EAAEU,KAAsB;IACnE,IAAIJ,MAAc,EAAE;IACpB,IAAIrE,SAAS;IACb,MAAM0E,QAAQ;QACZ,IAAIL,IAAIrE,MAAM,KAAK,GAAG;QACtBkE,KAAK3E,OAAOwE,MAAMK,MAAMC;QACxBA,MAAM,EAAE;QACRrE,SAAS;IACX;IACA,KAAK,MAAMsE,QAAQG,MAAO;QACxB,IAAIJ,IAAIrE,MAAM,GAAG,KAAKA,SAASsE,KAAKxD,IAAI,CAACd,MAAM,GAAGiE,UAAU1E,OAAOwE,OAAOW;QAC1E,IAAIJ,KAAKxD,IAAI,CAACd,MAAM,GAAGiE,UAAU1E,OAAOwE,OAAO;YAC7CW;YACAJ,KAAKK,OAAO;YACZ;QACF;QACAN,IAAIvE,IAAI,CAACwE;QACTtE,UAAUsE,KAAKxD,IAAI,CAACd,MAAM;IAC5B;IACA0E;AACF;AAEA,SAASE,YAAYrF,KAAY,EAAEwE,IAAU,EAAExC,OAAgB,EAAE/B,KAAa;IAC5E,IAAIR,QAAQQ,MAAMR,KAAK;IACvB,MAAOA,QAAQQ,MAAMP,GAAG,CAAE;QACxB,MAAM4F,OAAOvD,QAAQC,SAASvC,OAAOQ,MAAMP,GAAG,EAAEgF,UAAU1E,OAAOwE;QACjE,MAAML,QAAQnC,QAAQmC,KAAK,CAAC1E,OAAO6F;QACnC,IAAItD,QAAQQ,KAAK,CAAC/B,MAAM,KAAK,KAAK0D,MAAM5C,IAAI,CAACd,MAAM,IAAIiE,UAAU1E,OAAOwE,OAAO;YAC7EG,KAAK3E,OAAOwE,MAAML;QACpB,OAAO;YACLkB,YAAYrF,OAAOwE,MAAMH,aAAaF,QAAQ;gBAAE1E,OAAO;gBAAGC,KAAKyE,MAAM5C,IAAI,CAACd,MAAM;YAAC;QACnF;QACAhB,QAAQ6F;IACV;AACF;AAEA,SAASC,gBAAgBvF,KAAY,EAAEwE,IAAU,EAAExC,OAAgB;IACjE,MAAMoC,MAAMpC,QAAQmC,KAAK;IACzB,MAAM3C,SAASF,eAAeU,QAAQT,IAAI;IAC1C,IAAIK,QAAQ;IACZ,MAAOA,QAAQ,IAAIJ,OAAOf,MAAM,CAAE;QAChC,MAAM+E,QAAQ;YAAE/F,OAAO+B,MAAM,CAACI,MAAM;YAAGlC,KAAK8B,MAAM,CAACI,QAAQ,EAAE;QAAE;QAC/D,IAAIwC,IAAIoB,MAAM/F,KAAK,EAAE+F,MAAM9F,GAAG,EAAE6B,IAAI,CAACd,MAAM,GAAGiE,UAAU1E,OAAOwE,OAAO;YACpEa,YAAYrF,OAAOwE,MAAMxC,SAASwD;YAClC5D,SAAS;YACT;QACF;QACA,MAAM6D,UAAUjE,MAAM,CAACa,KAAKC,GAAG,CAACV,QAAQ,GAAG,GAAG;QAC9C,MAAMK,OACJmC,IAAIqB,SAASD,MAAM9F,GAAG,EAAE6B,IAAI,CAACd,MAAM,IAAIiE,UAAU1E,OAAOwE,QAAQiB,UAAUD,MAAM/F,KAAK;QACvF,IAAIiG,OAAO9D;QACX,MACE8D,OAAO,IAAIlE,OAAOf,MAAM,IACxB2D,IAAInC,MAAMT,MAAM,CAACkE,OAAO,EAAE,EAAGnE,IAAI,CAACd,MAAM,IAAIiE,UAAU1E,OAAOwE,MAC7D;YACAkB,QAAQ;QACV;QACAf,KAAK3E,OAAOwE,MAAMJ,IAAInC,MAAMT,MAAM,CAACkE,OAAO,EAAE;QAC5C9D,QAAQ8D,OAAO;IACjB;AACF;AAEA,SAASC,UAAU3F,KAAY,EAAEwE,IAAU,EAAEoB,KAAa;IACxD,OAAO;QACLnG,OAAOmG,MAAMnG,KAAK;QAClBC,KAAKkG,MAAMlG,GAAG;QACd6B,MAAMX,OAAOZ,OAAO4F;QACpBR,SAAS,IAAMG,gBAAgBvF,OAAOwE,MAAMT,cAAc/D,OAAO4F;IACnE;AACF;AAEA,SAASC,UAAU7F,KAAY,EAAEwE,IAAU,EAAEF,KAAY;IACvD,OAAO;QACL7E,OAAO6E,MAAM7E,KAAK;QAClBC,KAAK4E,MAAM5E,GAAG;QACd6B,MAAM+C,MAAM/C,IAAI;QAChB6D,SAAS,IAAMG,gBAAgBvF,OAAOwE,MAAMH,aAAaC;IAC3D;AACF;AAEA,SAASwB,SAAS9F,KAAY,EAAE+F,OAAa;IAC3C,OAAO;QACLtG,OAAOsG,QAAQtG,KAAK;QACpBC,KAAKqG,QAAQrG,GAAG;QAChB6B,MAAMX,OAAOZ,OAAO+F;QACpBX,SAAS,IAAMY,WAAWhG,OAAO+F;IACnC;AACF;AAEA,SAASE,UAAUF,OAAa,EAAErG,GAAW,EAAEwG,MAAyB;IACtE,MAAM5F,QAAQ4F,MAAM,CAAC,EAAE;IACvB,OAAO5F,UAAUqC,YACb;QAAC;YAAElD,OAAOsG,QAAQtG,KAAK;YAAEC;QAAI;KAAE,GAC/B;QAAC;YAAED,OAAOsG,QAAQtG,KAAK;YAAEC,KAAKY,MAAMZ,GAAG;QAAC;WAAMwG,OAAOlC,KAAK,CAAC;KAAG;AACpE;AAEA,SAASgC,WAAWhG,KAAY,EAAE+F,OAAa;IAC7C,MAAMrG,MAAMqG,QAAQlG,QAAQ,CAAC,EAAE,EAAEJ,SAASsG,QAAQrG,GAAG;IACrD,MAAMwG,SAAS/G,YAAYa,MAAME,OAAO,EAAE6F,QAAQpG,SAAS,EAAED;IAC7D,MAAMG,WAAiB;QAAED,SAAS;QAAI6E,SAAS;IAAE;IACjD,IAAIyB,OAAOzF,MAAM,KAAK,KAAKsF,QAAQlG,QAAQ,CAACY,MAAM,GAAG,GAAG;QACtD,MAAM,CAACH,OAAO,GAAG6F,KAAK,GAAGJ,QAAQlG,QAAQ;QACzC,MAAMuG,MAAM;YAAC;gBAAE,GAAG9F,KAAK;gBAAGb,OAAOsG,QAAQtG,KAAK;YAAC;eAAM0G;SAAK;QAC1DlB,YACEjF,OACAH,UACAuG,IAAItG,GAAG,CAAC,CAACuG,QAAUP,SAAS9F,OAAOqG;QAErC;IACF;IACA,MAAM7B,OAAa;QAAE5E,SAASmG,QAAQnG,OAAO;QAAE6E,SAAS;IAAE;IAC1D,MAAM6B,MAAML,UAAUF,SAASrG,KAAKwG;IACpCjB,YACEjF,OACAwE,MACA8B,IAAIxG,GAAG,CAAC,CAAC8F,QAAUD,UAAU3F,OAAOwE,MAAMoB;IAE5CX,YACEjF,OACAH,UACAkG,QAAQlG,QAAQ,CAACC,GAAG,CAAC,CAACuG,QAAUP,SAAS9F,OAAOqG;AAEpD;AAEA,SAASE,YAAYvG,KAAY,EAAEwG,KAAY;IAC7C,MAAMhC,OAAa;QAAE5E,SAAS;QAAI6E,SAAS;IAAE;IAC7CQ,YAAYjF,OAAOwE,MAAM;WACpBgC,MAAMC,MAAM,CAAC3G,GAAG,CAAC,CAACwE,QAAUuB,UAAU7F,OAAOwE,MAAMF;WACnDkC,MAAME,MAAM,CAACzD,OAAO,CAAC,CAAChD,QACvBF,OAAOC,OAAOC,OAAOH,GAAG,CAAC,CAACiG,UAAYD,SAAS9F,OAAO+F;KAEzD;AACH;AAEA,OAAO,SAASY,OAAOC,QAAkB,EAAEC,IAAY,EAAEC,OAAwB;IAC/E,MAAMC,SAAS1H,gBAAgBuH,UAAUC,MAAMC;IAC/C,IAAI,CAACC,OAAOC,EAAE,EAAE,OAAO;QAAEA,IAAI;QAAOC,SAASF,OAAOE,OAAO;IAAC;IAC5D,MAAMjH,QAAe;QACnBE,SAAS0G,SAAS1G,OAAO;QACzB4D,OAAOiD,OAAOP,KAAK,CAAC1C,KAAK;QACzB3B,QAAQ2E,QAAQ3E,MAAM;QACtBY,OAAO,EAAE;IACX;IACAwD,YAAYvG,OAAO+G,OAAOP,KAAK;IAC/B,OAAO;QAAEQ,IAAI;QAAMjE,OAAOD,WAAW8D,SAAS1G,OAAO,EAAEF,MAAM+C,KAAK;IAAE;AACtE"}

package/dist/document.d.ts

@@ -1,5 +1,8 @@
-import type { ApplyResult, Change, Document, ParseResult } from './types.js';
+import type { ApplyResult, Change, Document, Link, ParseResult } from './types.js';
+import { type YamlMap } from './yaml.js';
 export declare function parse(content: string, file?: string): ParseResult;
+export declare function links(document: Document, file: string): readonly Link[];
 export declare function apply(document: Document, change: Change): ApplyResult;
 export declare function serialize(document: Document): string;
+export declare function frontmatter(document: Document): YamlMap | null;
 //# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmD7E,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,WAAW,CA0C7D;AAkDD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAWrE;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;AACnF,OAAO,EAYL,KAAK,OAAO,EACb,MAAM,WAAW,CAAC;AAwCnB,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;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAE9D"}

package/dist/document.js

@@ -1,17 +1,20 @@
+import { hrefOccurrences } from './links.js';
+import { classifyHref, hrefSuffix } from './paths.js';
 import { headingSpans, sectionsRecord } from './sections.js';
 import { refusal } from './refuse.js';
-import { bodyStartAfterYaml, equalValue, extractFrontmatter, jsValue, lineEnding, mapEntry, parseYamlMapping, serializeJs, serializeKey, YamlError } from './yaml.js';
+import { bodyStartAfterYaml, bodyStartOf, equalValue, extractFrontmatter, jsValue, lineEnding, mapEntry, parseYamlMapping, serializeJs, serializeKey, YamlError } from './yaml.js';
 const internals = new WeakMap();
 function refuse(file, rule, location) {
     return location === undefined ? refusal(file, rule) : refusal(file, rule, {
         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);
@@ -29,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
@@ -54,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
@@ -133,7 +136,92 @@ 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;
+    for (const character of to){
+        if (/[\s\u0000-\u001f\u007f]/.test(character)) return false;
+        if (character === '(') depth += 1;
+        else if (character === ')') {
+            if (depth === 0) return false;
+            depth -= 1;
+        }
+    }
+    return depth === 0;
+}
+function fitsBrackets(to) {
+    return to !== '' && !/[<>\n\r]/.test(to);
+}
+function destinationText(to, bracketed) {
+    if (fitsBare(to)) return bracketed && fitsBrackets(to) ? `<${to}>` : to;
+    if (fitsBrackets(to)) return `<${to}>`;
+    return null;
+}
+function applyLink(document, href, to) {
+    const content = document.content;
+    const bodyStart = bodyStartOf(content);
+    const matches = hrefOccurrences(content.slice(bodyStart)).filter((occurrence)=>occurrence.href === href);
+    if (matches.length === 0) return {
+        outcome: 'stale',
+        document
+    };
+    const written = to + hrefSuffix(href);
+    let rewritten = '';
+    let cursor = 0;
+    for (const match of matches){
+        const text = destinationText(written, match.bracketed);
+        if (text === null) return {
+            outcome: 'refuse',
+            refusal: refuse('', 'unwritable-link', written)
+        };
+        rewritten += content.slice(cursor, bodyStart + match.start);
+        rewritten += text;
+        cursor = bodyStart + match.end;
+    }
+    const parsed = parse(rewritten + content.slice(cursor));
+    if (!parsed.ok) return {
+        outcome: 'refuse',
+        refusal: parsed.refusal
+    };
+    return {
+        outcome: 'applied',
+        document: parsed.document
+    };
+}
+export function links(document, file) {
+    const found = [];
+    const seen = new Set();
+    for (const occurrence of hrefOccurrences(document.content.slice(bodyStartOf(document.content)))){
+        if (seen.has(occurrence.href)) continue;
+        const resolved = classifyHref(file, occurrence.href);
+        if (resolved.kind !== 'path') continue;
+        seen.add(occurrence.href);
+        found.push({
+            href: occurrence.href,
+            target: resolved.path
+        });
+    }
+    return found;
+}
 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);
@@ -150,5 +238,8 @@ export function apply(document, change) {
 export function serialize(document) {
     return document.content;
 }
+export function frontmatter(document) {
+    return internals.get(document)?.root ?? null;
+}
 
 //# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/executor/code/agents.house/mdmodel/packages/mdmodel/src/document.ts"],"sourcesContent":["import { headingSpans, sectionsRecord } from './sections.js';\nimport { refusal } from './refuse.js';\nimport type { ApplyResult, Change, Document, ParseResult } from './types.js';\nimport {\n  bodyStartAfterYaml,\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\nexport function apply(document: Document, change: Change): ApplyResult {\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":["headingSpans","sectionsRecord","refusal","bodyStartAfterYaml","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","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\nexport function frontmatter(document: Document): YamlMap | null {\n  return internals.get(document)?.root ?? null;\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","frontmatter"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-export { apply, parse, serialize } from './document.js';
+export { divide } from './divide.js';
+export { apply, links, parse, serialize } from './document.js';
 export { MARKDOWN_SYNTAX_PROFILE } from './profile.js';
-export type { ApplyResult, Change, Document, Library, ParseResult, Refusal, Validation, } from './types.js';
+export { project } from './project.js';
+export type { ApplyResult, Change, Division, DivisionContext, Document, Library, Link, ParseResult, Projection, ProjectionContext, Refusal, Span, Validation, ValidationContext, } from './types.js';
 export { validate } from './validate.js';
 export { VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,OAAO,EACP,WAAW,EACX,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,WAAW,EACX,MAAM,EACN,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,IAAI,EACJ,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}