@agentshouse/mdmodel 0.1.0-c5a71fe539a49 → 0.1.0-c60b1ddb74fcc

package/dist/definition.js

@@ -1,4 +1,4 @@
-import { MEMBER_FIELD, RECEIVED_FIELD, SITE_FIELD } from './fields.js';
+import { MEMBER_FIELD, RECEIVED_FIELD, SITE_FIELD, TYPE_FIELD } from './fields.js';
 import { equalValue, isRecord, jsValue, parseYamlMapping, YamlError } from './yaml.js';
 export const JSON_TYPES = [
     'string',
@@ -12,11 +12,23 @@ export const JSON_TYPES = [
 export const BUILT_IN_TYPE = 'any';
 export const ATTACHMENT = 'attachment';
 const SCALAR_TYPES = new Set(['string', 'number', 'integer', 'boolean']);
+const COMPOSITES = ['array', 'object'];
+const ANNOTATIONS = new Set([
+    '$comment',
+    'title',
+    'description',
+    'default',
+    'examples',
+    'deprecated',
+    'readOnly',
+    'writeOnly',
+]);
+const FIELD_RULES = ['change_roles', 'initial_roles', 'transitions'];
 const DEFS_REFERENCE = '#/$defs/';
 const UNRESOLVED = /[\u0000-\u001f\u007f%[\]\\^{|}]|\s$/u;
 export const ARRAY_INDEX = /^(?:0|[1-9][0-9]*)$/u;
 const HOUSE_KEYS = {
-    type: { prose: false },
+    [TYPE_FIELD]: { prose: false },
     [SITE_FIELD]: { prose: false },
     [RECEIVED_FIELD]: { prose: false },
 };
@@ -270,24 +282,43 @@ function united(left, right) {
         return undefined;
     return [...left, ...right.filter((value) => !left.some((held) => equalValue(held, value)))];
 }
+function both(left, right) {
+    return left !== undefined && right !== undefined ? joined(left, right) : undefined;
+}
 function joined(left, right) {
     const type = left.type === right.type ? left.type : undefined;
     const format = left.format === right.format ? left.format : undefined;
     const values = united(left.values, right.values);
     const reference = united(left.reference, right.reference);
-    const items = left.items !== undefined && right.items !== undefined
-        ? joined(left.items, right.items)
-        : undefined;
+    const items = both(left.items, right.items);
+    const prefix = left.prefix === undefined && right.prefix === undefined
+        ? undefined
+        : Array.from({ length: Math.max(left.prefix?.length ?? 0, right.prefix?.length ?? 0) }, (_, index) => both(itemFacts(left, index), itemFacts(right, index)) ?? { prose: false });
+    const properties = Object.create(null);
+    for (const [name, facts] of Object.entries(left.properties ?? {})) {
+        const shared = both(facts, right.properties?.[name]);
+        if (shared !== undefined)
+            properties[name] = shared;
+    }
+    const patterns = (left.patterns ?? []).flatMap(({ pattern, facts }) => {
+        const shared = both(facts, right.patterns?.find((one) => one.pattern === pattern)?.facts);
+        return shared === undefined ? [] : [{ pattern, facts: shared }];
+    });
+    const additional = both(left.additional, right.additional);
     return {
         ...(type === undefined ? {} : { type }),
         ...(format === undefined ? {} : { format }),
         ...(values === undefined ? {} : { values }),
         ...(reference === undefined ? {} : { reference }),
         prose: left.prose && right.prose,
+        ...(prefix === undefined ? {} : { prefix }),
         ...(items === undefined ? {} : { items }),
+        ...(Object.keys(properties).length === 0 ? {} : { properties }),
+        ...(patterns.length === 0 ? {} : { patterns }),
+        ...(additional === undefined ? {} : { additional }),
     };
 }
-function propertiesOf(held, defs, ancestry) {
+function propertiesOf(held, variants, defs, ancestry) {
     const declared = new Map();
     for (const node of held) {
         if (!isRecord(node.properties))
@@ -298,45 +329,87 @@ function propertiesOf(held, defs, ancestry) {
     const properties = Object.create(null);
     for (const [name, schemas] of declared)
         properties[name] = factsOf(schemas, defs, ancestry);
-    const variants = Object.create(null);
-    for (const branch of held.flatMap(variantsOf)) {
-        for (const [name, facts] of Object.entries(factsOf([branch], defs, ancestry).properties ?? {})) {
+    const conditional = Object.create(null);
+    for (const branch of variants.values()) {
+        for (const [name, facts] of Object.entries(branch.properties ?? {})) {
             if (Object.hasOwn(properties, name))
                 continue;
-            variants[name] = Object.hasOwn(variants, name) ? joined(variants[name], facts) : facts;
+            conditional[name] = Object.hasOwn(conditional, name)
+                ? joined(conditional[name], facts)
+                : facts;
         }
     }
-    Object.assign(properties, variants);
+    for (const [name, facts] of Object.entries(conditional))
+        properties[name] = { ...facts, conditional: true };
     return Object.keys(properties).length === 0 ? undefined : properties;
 }
+function nullOnly(facts) {
+    return facts.type === 'null' || (facts.values?.every((value) => value === null) ?? false);
+}
+function alternativesOf(held, variants) {
+    return held.flatMap((node) => [node.anyOf, node.oneOf].flatMap((branches) => {
+        if (!Array.isArray(branches))
+            return [];
+        const kept = branches
+            .flatMap((branch) => {
+            const facts = isRecord(branch) ? variants.get(branch) : undefined;
+            return facts === undefined ? [] : [facts];
+        })
+            .filter((facts) => !nullOnly(facts));
+        return kept.length === 0 ? [] : [kept];
+    }));
+}
+function inheritedOf(held) {
+    return held.flatMap((node) => {
+        const kept = Object.fromEntries(['type', 'items', 'prefixItems'].flatMap((key) => node[key] === undefined ? [] : [[key, node[key]]]));
+        return Object.keys(kept).length === 0 ? [] : [kept];
+    });
+}
 function factsOf(nodes, defs, ancestry) {
     const { held, ancestry: reached } = conjoined(nodes, defs, ancestry);
-    const listed = held.flatMap((node) => Array.isArray(node.enum) ? [node.enum] : node.const !== undefined ? [[node.const]] : []);
+    const inherited = inheritedOf(held);
+    const variants = new Map(held
+        .flatMap(variantsOf)
+        .map((branch) => [branch, factsOf([branch, ...inherited], defs, reached)]));
+    const unions = alternativesOf(held, variants);
+    const alternatives = unions.map((kept) => kept.reduce(joined));
+    const listed = [
+        ...held.flatMap((node) => Array.isArray(node.enum) ? [node.enum] : node.const !== undefined ? [[node.const]] : []),
+        ...alternatives.flatMap((facts) => (facts.values === undefined ? [] : [facts.values])),
+    ];
     const values = listed.length === 0
         ? undefined
         : listed.reduce((kept, list) => kept.filter((value) => list.some((other) => equalValue(other, value))));
     const type = firstOf(held, (node) => singleType(node.type)) ??
-        (values === undefined ? undefined : sharedType(values));
+        (values === undefined ? undefined : sharedType(values)) ??
+        alternatives.find((facts) => facts.type !== undefined)?.type;
     const reference = firstOf(held, (node) => typeof node.reference === 'string'
         ? [node.reference]
         : Array.isArray(node.reference)
             ? node.reference
-            : undefined);
-    const format = firstOf(held, (node) => typeof node.format === 'string' ? node.format : undefined);
+            : undefined) ?? alternatives.find((facts) => facts.reference !== undefined)?.reference;
+    const format = firstOf(held, (node) => (typeof node.format === 'string' ? node.format : undefined)) ??
+        alternatives.find((facts) => facts.format !== undefined)?.format;
     const prose = type === 'string' &&
         values === undefined &&
         format === undefined &&
         reference === undefined &&
-        held.every((node) => node.pattern === undefined);
+        held.every((node) => node.pattern === undefined) &&
+        unions.every((kept) => kept.every((facts) => facts.type !== 'string' || facts.prose));
     const listedItems = held.flatMap((node) => (node.items === undefined ? [] : [node.items]));
-    const items = type === 'array' && listedItems.length > 0 ? factsOf(listedItems, defs, reached) : undefined;
-    const prefix = type === 'array'
-        ? firstOf(held, (node) => Array.isArray(node.prefixItems)
-            ? node.prefixItems.map((schema) => factsOf([schema], defs, reached))
-            : undefined)
-        : undefined;
+    const items = type !== 'array'
+        ? undefined
+        : (alternatives.find((facts) => facts.items !== undefined)?.items ??
+            (listedItems.length > 0 ? factsOf(listedItems, defs, reached) : undefined));
+    const tuples = held.flatMap((node) => Array.isArray(node.prefixItems) ? [node.prefixItems] : []);
+    const prefix = type !== 'array'
+        ? undefined
+        : (alternatives.find((facts) => facts.prefix !== undefined)?.prefix ??
+            (tuples.length === 0
+                ? undefined
+                : Array.from({ length: Math.max(...tuples.map((tuple) => tuple.length)) }, (_, index) => factsOf(tuples.flatMap((tuple) => (index < tuple.length ? [tuple[index]] : [])), defs, reached))));
     const mapped = type === 'object' || type === undefined;
-    const properties = mapped ? propertiesOf(held, defs, reached) : undefined;
+    const properties = mapped ? propertiesOf(held, variants, defs, reached) : undefined;
     const patterns = mapped
         ? held.flatMap((node) => Object.entries(isRecord(node.patternProperties) ? node.patternProperties : {}).map(([pattern, schema]) => ({ pattern, facts: factsOf([schema], defs, reached) })))
         : [];
@@ -369,6 +442,54 @@ export function memberFacts(facts, key) {
     const pattern = facts.patterns?.find((one) => new RegExp(one.pattern, 'u').test(key));
     return pattern === undefined ? facts.additional : pattern.facts;
 }
+export function crossedFacts(facts) {
+    if (facts.type !== 'array')
+        return [facts];
+    return [...(facts.prefix ?? []), ...(facts.items === undefined ? [] : [facts.items])].flatMap(crossedFacts);
+}
+export function fieldFacts(definition, key) {
+    if (Object.hasOwn(definition.fields, key))
+        return definition.fields[key];
+    if (Object.hasOwn(HOUSE_KEYS, key))
+        return undefined;
+    return memberFacts(definition.frontmatter, key);
+}
+function stepped({ facts, through, conditional }, token) {
+    if (facts.type === 'array' && ARRAY_INDEX.test(token)) {
+        const item = itemFacts(facts, Number(token));
+        return item === undefined ? [] : [{ facts: item, through, conditional }];
+    }
+    return crossedFacts(facts).flatMap((crossed) => {
+        const member = memberFacts(crossed, token);
+        return member === undefined
+            ? []
+            : [
+                {
+                    facts: member,
+                    through: through || facts.type === 'array',
+                    conditional: conditional || member.conditional === true,
+                },
+            ];
+    });
+}
+export function pointerFacts(definition, pointer) {
+    const [field, ...rest] = pointerSegments(pointer);
+    const declared = field === undefined ? undefined : fieldFacts(definition, field);
+    if (declared === undefined)
+        return undefined;
+    let reached = [
+        { facts: declared, through: false, conditional: declared.conditional === true },
+    ];
+    for (const token of rest)
+        reached = reached.flatMap((held) => stepped(held, token));
+    if (reached.length === 0)
+        return undefined;
+    return reached.reduce((kept, held) => ({
+        facts: joined(kept.facts, held.facts),
+        through: kept.through || held.through,
+        conditional: kept.conditional || held.conditional,
+    }));
+}
 function reachedDefs(value, defs, reached) {
     if (Array.isArray(value)) {
         for (const item of value)
@@ -429,21 +550,134 @@ function deepFreeze(value) {
     }
     return value;
 }
+function ruleValue(value) {
+    return value === null || typeof value === 'string' || typeof value === 'boolean' || finite(value);
+}
+function roleNames(value) {
+    return strings(value) && value.every((name) => name !== '');
+}
+function compositesOf(value) {
+    return Array.isArray(value) ? ['array'] : isRecord(value) ? ['object'] : [];
+}
+function typed(type) {
+    const types = typeof type === 'string' ? [type] : type;
+    return Array.isArray(types) ? COMPOSITES.filter((kind) => types.includes(kind)) : undefined;
+}
+function admittedWhole(node) {
+    if (node === true)
+        return COMPOSITES;
+    if (!isRecord(node) || Object.keys(node).some((key) => key !== 'type' && !ANNOTATIONS.has(key)))
+        return [];
+    return typed(node.type) ?? COMPOSITES;
+}
+function composites(node, defs, seen) {
+    if (node === false)
+        return [];
+    if (!isRecord(node))
+        return COMPOSITES;
+    const each = (nodes) => Array.isArray(nodes) ? nodes.map((one) => composites(one, defs, seen)) : [];
+    const target = typeof node.$ref === 'string' ? refTarget(node.$ref, defs)?.node : undefined;
+    const conditioned = () => {
+        const met = composites(node.then ?? true, defs, seen);
+        return COMPOSITES.filter((kind) => (composites(node.if, defs, seen).includes(kind) && met.includes(kind)) ||
+            composites(node.else ?? true, defs, seen).includes(kind));
+    };
+    const bounds = [
+        typed(node.type),
+        Array.isArray(node.enum) ? node.enum.flatMap(compositesOf) : undefined,
+        Object.hasOwn(node, 'const') ? compositesOf(node.const) : undefined,
+        target === undefined || seen.has(target)
+            ? undefined
+            : composites(target, defs, new Set([...seen, target])),
+        ...each(node.allOf),
+        ...[node.anyOf, node.oneOf].filter(Array.isArray).map((branches) => each(branches).flat()),
+        Object.hasOwn(node, 'if') ? conditioned() : undefined,
+        Object.hasOwn(node, 'not')
+            ? COMPOSITES.filter((kind) => !admittedWhole(node.not).includes(kind))
+            : undefined,
+    ];
+    return COMPOSITES.filter((kind) => bounds.every((bound) => bound?.includes(kind) ?? true));
+}
+function transitionOf(value) {
+    if (!isRecord(value) || !Object.hasOwn(value, 'from') || !Object.hasOwn(value, 'to'))
+        return undefined;
+    const { from, to, roles, ...rest } = value;
+    if (Object.keys(rest).length > 0 || !ruleValue(from) || !ruleValue(to))
+        return undefined;
+    if (roles === undefined)
+        return { from, to };
+    return roleNames(roles) ? { from, to, roles } : undefined;
+}
+function fieldRules(written, field, at, defs) {
+    const { change_roles: changeRoles, initial_roles: initialRoles, transitions } = written;
+    if (changeRoles !== undefined && !roleNames(changeRoles))
+        return refuse('change_roles', `${at}/change_roles`);
+    if (initialRoles !== undefined && !roleNames(initialRoles))
+        return refuse('initial_roles', `${at}/initial_roles`);
+    if (transitions === undefined)
+        return {
+            ...(changeRoles === undefined ? {} : { changeRoles }),
+            ...(initialRoles === undefined ? {} : { initialRoles }),
+        };
+    if (!Array.isArray(transitions) || composites(field, defs, new Set()).length > 0)
+        return refuse('transitions', `${at}/transitions`);
+    const listed = [];
+    for (const [index, held] of transitions.entries()) {
+        const transition = transitionOf(held);
+        if (transition === undefined)
+            return refuse('transitions', `${at}/transitions/${index}`);
+        listed.push(transition);
+    }
+    return {
+        ...(changeRoles === undefined ? {} : { changeRoles }),
+        ...(initialRoles === undefined ? {} : { initialRoles }),
+        transitions: listed,
+    };
+}
+function unruled(schema) {
+    const written = new Map();
+    if (!isRecord(schema.properties))
+        return { schema, written };
+    const properties = Object.create(null);
+    for (const [field, node] of Object.entries(schema.properties)) {
+        if (!isRecord(node) || !FIELD_RULES.some((keyword) => Object.hasOwn(node, keyword))) {
+            properties[field] = node;
+            continue;
+        }
+        written.set(field, node);
+        properties[field] = Object.fromEntries(Object.entries(node).filter(([keyword]) => !FIELD_RULES.includes(keyword)));
+    }
+    return { schema: written.size === 0 ? schema : { ...schema, properties }, written };
+}
 function readType(name, value, context) {
     const at = `/${escapePointer(name)}`;
     if (!isRecord(value))
         return refuse('schema', at);
-    const { sections: declared, member_document: mark, ...schema } = value;
+    const { sections: declared, member_document: mark, create_roles: createRoles, delete_roles: deleteRoles, ...ruled } = value;
     if (mark !== undefined && typeof mark !== 'boolean')
         return refuse('member_document', `${at}/member_document`);
+    if (createRoles !== undefined && !roleNames(createRoles))
+        return refuse('create_roles', `${at}/create_roles`);
+    if (deleteRoles !== undefined && !roleNames(deleteRoles))
+        return refuse('delete_roles', `${at}/delete_roles`);
     const read = declared === undefined
         ? { sections: Object.create(null) }
         : readSections(declared, `${at}/sections`, context);
     if ('failure' in read)
         return read.failure;
+    const { schema, written } = unruled(ruled);
     const failure = schemaFailure(schema, at, context);
     if (failure !== undefined)
         return failure;
+    const rules = Object.create(null);
+    for (const [field, keywords] of written) {
+        const properties = schema.properties;
+        const where = `${at}/properties/${escapePointer(field)}`;
+        const ruling = fieldRules(keywords, properties[field], where, context.defs);
+        if ('rule' in ruling)
+            return ruling;
+        rules[field] = ruling;
+    }
     const memberDocument = mark === true;
     const root = valueFacts(schema, context.defs);
     const fields = Object.assign(Object.create(null), root.properties);
@@ -451,13 +685,20 @@ function readType(name, value, context) {
         fields[MEMBER_FIELD] = { type: 'string', prose: false };
     const defs = Object.create(null);
     reachedDefs(value, context.defs, defs);
+    const { create_roles: _create, delete_roles: _delete, ...shaped } = value;
     return {
         name,
         memberDocument,
         frontmatter: { ...root, properties: { ...HOUSE_KEYS, ...fields } },
         fields,
         sections: read.sections,
-        shape: { schema: value, defs },
+        rules,
+        ...(createRoles === undefined ? {} : { createRoles }),
+        ...(deleteRoles === undefined ? {} : { deleteRoles }),
+        shape: {
+            schema: written.size === 0 ? shaped : { ...shaped, properties: schema.properties },
+            defs,
+        },
     };
 }
 function lineAt(text, offset) {

package/dist/document.d.ts

@@ -1,17 +1,16 @@
 import { type Definition } from './definition.js';
-import type { ApplyResult, Change, Document, Link, ParseResult, Refusal } from './types.js';
+import type { ApplyResult, BodyResult, FrontmatterResult, Change, Document, Link, LinkOccurrence, ParseResult } from './types.js';
 import { type YamlMap } from './yaml.js';
+export declare function parseFrontmatter(content: string, file?: string): FrontmatterResult;
 export declare function parse(content: string, file?: string): ParseResult;
 export declare function relativize(document: Document, file: string, handle: string, definition?: Definition): ApplyResult;
-export declare function relativizeBody(body: string, file: string, handle: string): {
-    readonly outcome: 'applied';
-    readonly body: string;
-} | {
-    readonly outcome: 'refuse';
-    readonly refusal: Refusal;
-};
+export declare function relativizeBody(body: string, file: string, handle: string): BodyResult;
+export declare function relinkBody(body: string, file: string, moves: ReadonlyMap<string, string>): BodyResult;
 export declare function links(document: Document, file: string): readonly Link[];
+export declare function linkOccurrences(document: Document, file: string): readonly LinkOccurrence[];
+export declare function bodyLinks(body: string, file: string): readonly Link[];
 export declare function apply(document: Document, change: Change): ApplyResult;
 export declare function serialize(document: Document): string;
+export declare function fieldStart(document: Document, pointer: string): number | undefined;
 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":"AAAA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAYL,KAAK,OAAO,EAEb,MAAM,WAAW,CAAC;AAwCnB,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,WAAW,CAkD7D;AA2KD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,GACtB,WAAW,CAYb;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAEZ;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAO5D;AAED,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,CAerE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhF,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,WAAW,EAEZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAaL,KAAK,OAAO,EAEb,MAAM,WAAW,CAAC;AAmEnB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,iBAAiB,CAW9E;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,WAAW,CAgB7D;AAqMD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,GACtB,WAAW,CAYb;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CASrF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,UAAU,CAeZ;AAuBD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAEvE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,CAG3F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAErE;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAOrE;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAE9D"}

package/dist/document.js

@@ -1,10 +1,10 @@
 import { ARRAY_INDEX, pointerSegments } from './definition.js';
 import { hrefOccurrences } from './links.js';
-import { relative, retarget, SHELL_ROOMS, shellTarget, target } from './paths.js';
+import { destinationPath, relative, retarget, SHELL_ROOMS, shellTarget, target } from './paths.js';
 import { references } from './references.js';
 import { headingSpans, sectionsRecord } from './sections.js';
 import { refusal } from './refuse.js';
-import { bodyStartAfterYaml, bodyStartOf, equalValue, extractFrontmatter, jsValue, lineEnding, mapEntry, parseYamlMapping, serializeJs, serializeKey, YamlError, } from './yaml.js';
+import { bodyStartAfterYaml, bodyStartOf, equalValue, extractFrontmatter, frontmatterValue, 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 });
@@ -28,19 +28,10 @@ function declaredType(fields) {
         return undefined;
     return value;
 }
-export function parse(content, file = '') {
+function opened(content, file) {
     const fence = extractFrontmatter(content);
-    if (fence.kind === 'none') {
-        const spans = headingSpans(content, 0);
-        return {
-            ok: true,
-            document: freezeDocument(content, undefined, {}, content.slice(0, spans[0]?.headingStart), sectionsRecord(spans, content), {
-                root: null,
-                yamlEnd: 0,
-                bodyStart: 0,
-            }),
-        };
-    }
+    if (fence.kind === 'none')
+        return { ok: true, root: null, fields: {}, yamlEnd: 0 };
     if (fence.kind === 'unclosed')
         return { ok: false, refusal: refuse(file, 'frontmatter-fence') };
     try {
@@ -49,17 +40,7 @@ export function parse(content, file = '') {
         if (fields === null || typeof fields !== 'object' || Array.isArray(fields)) {
             return { ok: false, refusal: refuse(file, 'frontmatter-fence') };
         }
-        const bodyStart = bodyStartAfterYaml(content, fence.yamlEnd);
-        const spans = headingSpans(content, bodyStart);
-        const record = fields;
-        return {
-            ok: true,
-            document: freezeDocument(content, declaredType(record), record, content.slice(bodyStart, spans[0]?.headingStart), sectionsRecord(spans, content), {
-                root,
-                yamlEnd: fence.yamlEnd,
-                bodyStart,
-            }),
-        };
+        return { ok: true, root, fields: fields, yamlEnd: fence.yamlEnd };
     }
     catch (error) {
         if (error instanceof YamlError)
@@ -67,6 +48,30 @@ export function parse(content, file = '') {
         throw error;
     }
 }
+export function parseFrontmatter(content, file = '') {
+    const read = opened(content, file);
+    if (!read.ok)
+        return read;
+    return {
+        ok: true,
+        frontmatter: Object.freeze({
+            content,
+            type: declaredType(read.fields),
+            fields: Object.freeze(read.fields),
+        }),
+    };
+}
+export function parse(content, file = '') {
+    const read = opened(content, file);
+    if (!read.ok)
+        return read;
+    const bodyStart = read.root === null ? 0 : bodyStartAfterYaml(content, read.yamlEnd);
+    const spans = headingSpans(content, bodyStart);
+    return {
+        ok: true,
+        document: freezeDocument(content, declaredType(read.fields), read.fields, content.slice(bodyStart, spans[0]?.headingStart), sectionsRecord(spans, content), { root: read.root, yamlEnd: read.yamlEnd, bodyStart }),
+    };
+}
 function splice(content, start, end, insert) {
     return content.slice(0, start) + insert + content.slice(end);
 }
@@ -78,10 +83,18 @@ function applyField(document, name, value, prior) {
     if (!equalValue(document.fields[name], prior)) {
         return { outcome: 'stale', document };
     }
+    if (!frontmatterValue(value)) {
+        return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', name) };
+    }
     let nextContent;
     const existing = mapEntry(internal.root, name);
     if (existing !== undefined) {
-        nextContent = splice(document.content, existing.value.start, existing.value.end, serializeJs(value));
+        const held = existing.value;
+        const inline = held.start > existing.after &&
+            !/[\r\n]/.test(document.content.slice(existing.after, held.start));
+        nextContent = inline
+            ? splice(document.content, held.start, held.end, serializeJs(value))
+            : splice(document.content, existing.after, held.end, ` ${serializeJs(value)}`);
     }
     else if (document.content[internal.root.start] === '{') {
         nextContent = splice(document.content, internal.root.end - 1, internal.root.end - 1, `${internal.root.entries.length === 0 ? '' : ', '}${serializeKey(name)}: ${serializeJs(value)}`);
@@ -111,16 +124,30 @@ function applySection(document, name, value, prior) {
     const current = document.content.slice(span.bodyStart, span.bodyEnd);
     if (current !== prior)
         return { outcome: 'stale', document };
-    const parsed = parse(splice(document.content, span.bodyStart, span.bodyEnd, value));
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
+    return replaced(document, internal.bodyStart, span.bodyStart, span.bodyEnd, value);
 }
 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));
+    return replaced(document, start, start, start + document.preamble.length, value);
+}
+function firstHeadings(content, bodyStart) {
+    const first = new Map();
+    for (const span of headingSpans(content, bodyStart)) {
+        if (!first.has(span.name))
+            first.set(span.name, span.headingStart);
+    }
+    return first;
+}
+function replaced(document, bodyStart, start, end, value) {
+    const content = splice(document.content, start, end, value);
+    const after = firstHeadings(content, bodyStartOf(content));
+    for (const [name, at] of firstHeadings(document.content, bodyStart)) {
+        if (after.get(name) !== (at < start ? at : at + value.length - (end - start)))
+            return { outcome: 'refuse', refusal: refuse('', 'overlapping-section', name) };
+    }
+    const parsed = parse(content);
     if (!parsed.ok)
         return { outcome: 'refuse', refusal: parsed.refusal };
     return { outcome: 'applied', document: parsed.document };
@@ -248,25 +275,58 @@ export function relativizeBody(body, file, handle) {
     const relinkedBody = shellRelinked(body, 0, file, handle);
     if (typeof relinkedBody !== 'string')
         return { outcome: 'refuse', refusal: relinkedBody };
-    const elsewhere = hrefOccurrences(relinkedBody).find(({ href }) => href.startsWith(SHELL_ROOMS));
+    const elsewhere = hrefOccurrences(relinkedBody).find(({ href }) => destinationPath(href)?.startsWith(SHELL_ROOMS) === true);
     if (elsewhere !== undefined)
         return { outcome: 'refuse', refusal: refuse(file, 'unresolved-link', elsewhere.href) };
     return { outcome: 'applied', body: relinkedBody };
 }
-export function links(document, file) {
+export function relinkBody(body, file, moves) {
+    let rewritten = '';
+    let cursor = 0;
+    for (const match of hrefOccurrences(body)) {
+        const from = target(file, match.href);
+        const to = from === null ? undefined : moves.get(from);
+        if (to === undefined)
+            continue;
+        const written = retarget(match.href, relative(file, to));
+        const text = destinationText(written, match.bracketed);
+        if (text === null)
+            return { outcome: 'refuse', refusal: refuse(file, 'unwritable-link', written) };
+        rewritten += body.slice(cursor, match.start) + text;
+        cursor = match.end;
+    }
+    return { outcome: 'applied', body: rewritten + body.slice(cursor) };
+}
+function occurrencesIn(text, file, offset) {
+    const found = [];
+    for (const occurrence of hrefOccurrences(text)) {
+        const resolved = target(file, occurrence.href);
+        if (resolved !== null)
+            found.push({ href: occurrence.href, target: resolved, start: offset + occurrence.start });
+    }
+    return found;
+}
+function linksIn(text, file) {
     const found = [];
     const seen = new Set();
-    for (const occurrence of hrefOccurrences(document.content.slice(bodyStartOf(document.content)))) {
+    for (const occurrence of occurrencesIn(text, file, 0)) {
         if (seen.has(occurrence.href))
             continue;
-        const resolved = target(file, occurrence.href);
-        if (resolved === null)
-            continue;
         seen.add(occurrence.href);
-        found.push({ href: occurrence.href, target: resolved });
+        found.push({ href: occurrence.href, target: occurrence.target });
     }
     return found;
 }
+export function links(document, file) {
+    return linksIn(document.content.slice(bodyStartOf(document.content)), file);
+}
+export function linkOccurrences(document, file) {
+    const bodyStart = bodyStartOf(document.content);
+    return occurrencesIn(document.content.slice(bodyStart), file, bodyStart);
+}
+export function bodyLinks(body, file) {
+    return linksIn(body, file);
+}
 export function apply(document, change) {
     if (change.kind === 'link')
         return applyLink(document, change.href, change.to);
@@ -274,21 +334,17 @@ export function apply(document, change) {
         return applyReference(document, change.pointer, change.value, change.prior);
     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);
-    }
-    catch (error) {
-        if (error instanceof YamlError) {
-            return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', change.name) };
-        }
-        throw error;
-    }
+    if (change.kind === 'field')
+        return applyField(document, change.name, change.value, change.prior);
+    return applySection(document, change.name, change.value, change.prior);
 }
 export function serialize(document) {
     return document.content;
 }
+export function fieldStart(document, pointer) {
+    const root = internals.get(document)?.root;
+    return root === null || root === undefined ? undefined : nodeAt(root, pointer)?.start;
+}
 export function frontmatter(document) {
     return internals.get(document)?.root ?? null;
 }