@ifc-lite/ids-authoring 0.0.0-stage → 0.2.2

package/dist/diff/changelog.js

@@ -0,0 +1,173 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Plain-language changelog for a `DocumentDiff`: one sentence per change
+ * ("Doors: FireRating (Pset_DoorCommon) changed from optional to
+ * required"). Every entry kind renders; the min/max occurrence pair of
+ * one specification renders as one cardinality sentence.
+ */
+import { formatConstraint } from '@ifc-lite/ids';
+import { getField } from '../document/fields.js';
+import { describeFacet } from '../render/describe.js';
+import { catalogue } from './changelog-text.js';
+function value(v, t) {
+    if (v === undefined || v === null)
+        return t.none;
+    if (Array.isArray(v))
+        return v.join(', ');
+    if (typeof v === 'object' && 'type' in v)
+        return formatConstraint(v);
+    return typeof v === 'string' ? `"${v}"` : String(v);
+}
+/** A short handle for a facet: what it is about. */
+export function facetLabel(facet) {
+    const f = (field) => {
+        const c = getField(facet, field);
+        if (!c)
+            return '';
+        return c.type === 'simpleValue' ? c.value : formatConstraint(c);
+    };
+    switch (facet.type) {
+        case 'entity':
+            return f('entity.name');
+        case 'attribute':
+            return f('attribute.name');
+        case 'property':
+            return `${f('property.baseName')} (${f('property.propertySet')})`;
+        case 'classification':
+            return facet.system ? `${f('classification.system')} classification` : 'classification';
+        case 'material':
+            return 'material';
+        case 'partOf':
+            return facet.entity ? `partOf ${f('partOf.entity.name')}` : 'partOf';
+    }
+}
+const FIELD_SUFFIX = {
+    'entity.predefinedType': 'predefinedType',
+    'attribute.value': '',
+    'property.dataType': 'dataType',
+    'property.value': '',
+    'classification.value': '',
+    'material.value': '',
+    'partOf.entity.predefinedType': 'predefinedType',
+};
+function sentence(e, t, locale) {
+    switch (e.kind) {
+        case 'info.changed':
+            if (e.old === undefined)
+                return t.set(t.info[e.field], value(e.new, t));
+            if (e.new === undefined)
+                return t.removedValue(t.info[e.field], value(e.old, t));
+            return t.changed(t.info[e.field], value(e.old, t), value(e.new, t));
+        case 'custom.psetDeclared':
+            return t.psetDeclared(e.decl.name);
+        case 'custom.psetRemoved':
+            return t.psetRemoved(e.decl.name);
+        case 'custom.userDefinedTypeDeclared':
+            return t.udtDeclared(e.decl.entity, e.decl.value);
+        case 'custom.userDefinedTypeRemoved':
+            return t.udtRemoved(e.decl.entity, e.decl.value);
+        case 'spec.added':
+            return t.specAdded(e.specName);
+        case 'spec.removed':
+            return t.specRemoved(e.specName);
+        case 'spec.moved':
+            return t.specMoved(e.specName, e.from + 1, e.to + 1);
+        case 'spec.changed':
+            if (e.field === 'name')
+                return t.specRenamed(String(e.old), String(e.new));
+            if (e.cardinality && e.cardinality.old !== e.cardinality.new) {
+                return t.specCardinality(e.specName, t.cardinality[e.cardinality.old], t.cardinality[e.cardinality.new]);
+            }
+            return `${e.specName}: ${t.changed(t.specField[e.field], value(e.old, t), value(e.new, t))}`;
+        case 'facet.added':
+            return `${e.specName}: ${t.facetAdded(cap(t.section[e.section]), describeFacet(e.facet, e.section, e.optionality, locale))}`;
+        case 'facet.removed':
+            return `${e.specName}: ${t.facetRemoved(cap(t.section[e.section]), describeFacet(e.facet, e.section, e.optionality, locale))}`;
+        case 'facet.moved': {
+            const across = e.from.specId !== e.to.specId || e.from.section !== e.to.section;
+            const from = across ? t.inSpec(e.specName, t.section[e.from.section]) : t.position(e.from.index + 1);
+            const to = across ? t.inSpec(e.specName, t.section[e.to.section]) : t.position(e.to.index + 1);
+            return `${e.specName}: ${t.facetMoved(facetLabel(e.facet), from, to)}`;
+        }
+        case 'facet.replaced':
+            return `${e.specName}: ${t.facetReplaced(facetLabel(e.old), describeFacet(e.facet, e.section, e.optionality, locale))}`;
+        case 'facet.valueChanged': {
+            const suffix = FIELD_SUFFIX[e.field];
+            const what = suffix ? `${facetLabel(e.facet)} ${suffix}` : facetLabel(e.facet);
+            if (!e.old)
+                return `${e.specName}: ${t.set(what, value(e.new, t))}`;
+            if (!e.new)
+                return `${e.specName}: ${t.removedValue(what, value(e.old, t))}`;
+            return `${e.specName}: ${t.changed(what, value(e.old, t), value(e.new, t))}`;
+        }
+        case 'facet.relationChanged':
+            return `${e.specName}: ${t.changed(`${facetLabel(e.facet)} ${t.relation}`, e.old.relation, e.new.relation)}`;
+        case 'facet.uriChanged': {
+            const what = `${facetLabel(e.facet)} URI`;
+            if (e.old === undefined)
+                return `${e.specName}: ${t.set(what, e.new ?? t.none)}`;
+            if (e.new === undefined)
+                return `${e.specName}: ${t.removedValue(what, e.old)}`;
+            return `${e.specName}: ${t.changed(what, e.old, e.new)}`;
+        }
+        case 'requirement.changed':
+            if (e.field === 'optionality') {
+                return `${e.specName}: ${t.changed(facetLabel(e.facet), t.optionality[e.old], t.optionality[e.new])}`;
+            }
+            return `${e.specName}: ${t.changed(`${facetLabel(e.facet)} ${t.reqField[e.field]}`, value(e.old, t), value(e.new, t))}`;
+    }
+}
+function cap(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function specNameOf(e) {
+    return 'specName' in e ? e.specName : undefined;
+}
+/** One sentence for one diff entry. */
+export function describeChange(entry, locale = 'en') {
+    return sentence(entry, catalogue(locale), locale);
+}
+/** One plain-language line per change, in diff order. */
+export function changelog(diff, options = {}) {
+    const locale = options.locale ?? 'en';
+    const t = catalogue(locale);
+    const lines = [];
+    const cardinalityDone = new Set();
+    for (const entry of diff.entries) {
+        if (entry.kind === 'spec.changed' && entry.cardinality && entry.cardinality.old !== entry.cardinality.new) {
+            if (cardinalityDone.has(entry.specId))
+                continue;
+            cardinalityDone.add(entry.specId);
+        }
+        const specName = specNameOf(entry);
+        lines.push({ text: sentence(entry, t, locale), ...(specName !== undefined ? { specName } : {}), entry });
+    }
+    return lines;
+}
+/** The changelog as Markdown, grouped by specification (for `ids diff --md`). */
+export function changelogMarkdown(diff, options = {}) {
+    const lines = changelog(diff, options);
+    const out = [`# ${options.title ?? 'Changes'}`, ''];
+    if (!lines.length)
+        return `${out.join('\n')}\n`;
+    const doc = lines.filter((l) => l.specName === undefined);
+    for (const l of doc)
+        out.push(`- ${l.text}`);
+    if (doc.length)
+        out.push('');
+    const groups = new Map();
+    for (const l of lines) {
+        if (l.specName === undefined)
+            continue;
+        const list = groups.get(l.specName) ?? [];
+        list.push(l.text);
+        groups.set(l.specName, list);
+    }
+    for (const [name, texts] of groups) {
+        out.push(`## ${name}`, '', ...texts.map((x) => `- ${x}`), '');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=changelog.js.map

package/dist/diff/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/diff/changelog.ts"],"names":[],"mappings":"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"}

package/dist/diff/compare.d.ts

@@ -0,0 +1,25 @@
+/** Field-level comparison of matched nodes, for the diff. */
+import type { IDSDocument, IDSRequirement, IDSSpecification } from '@ifc-lite/ids';
+import type { StudioDocument } from '../document/types.js';
+import type { RequirementSnapshot, SpecCardinality } from '../ops/types.js';
+import type { FacetSite } from './align.js';
+import type { DiffEntry, FacetContext, SpecField } from './types.js';
+export declare const SPEC_FIELDS: readonly SpecField[];
+export declare function same(x: unknown, y: unknown): boolean;
+export declare function infoEntries(a: IDSDocument, b: IDSDocument): DiffEntry[];
+export declare function customEntries(a: StudioDocument, b: StudioDocument): DiffEntry[];
+export declare function specField(spec: IDSSpecification, field: SpecField): unknown;
+/** required / optional / prohibited, as IDS reads minOccurs and maxOccurs. */
+export declare function specCardinality(spec: IDSSpecification): SpecCardinality;
+export declare function specEntries(a: IDSSpecification, b: IDSSpecification): DiffEntry[];
+/** The requirement record of a site in its document, if it is a requirement. */
+export declare function requirementOf(doc: StudioDocument, site: FacetSite): IDSRequirement | undefined;
+export declare function snapshot(r: IDSRequirement | undefined): RequirementSnapshot | undefined;
+/**
+ * Entries for one matched facet pair. `ctx` is the shared facet context
+ * (named by the id in `a`). A requirement that arrives from applicability
+ * starts as `required` with no texts (what `facet.move` creates), so only
+ * the differences from that are reported.
+ */
+export declare function facetEntries(ctx: FacetContext, aSite: FacetSite, bSite: FacetSite, reqA: IDSRequirement | undefined, reqB: IDSRequirement | undefined): DiffEntry[];
+//# sourceMappingURL=compare.d.ts.map

package/dist/diff/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/diff/compare.ts"],"names":[],"mappings":"AAIA,6DAA6D;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,KAAK,EAAkB,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAEhG,OAAO,KAAK,EAAa,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAoB,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvF,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAU3C,CAAC;AAIF,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,EAAE,CASvE;AAMD,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE,CAkB/E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAE3E;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAGvE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,SAAS,EAAE,CAWjF;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS,CAE9F;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAOvF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,IAAI,EAAE,cAAc,GAAG,SAAS,GAC/B,SAAS,EAAE,CAyCb"}

package/dist/diff/compare.js

@@ -0,0 +1,150 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { FACET_FIELDS, getField } from '../document/fields.js';
+import { canonical } from '../match/cascade.js';
+const INFO_FIELDS = ['title', 'copyright', 'version', 'description', 'author', 'date', 'purpose', 'milestone'];
+export const SPEC_FIELDS = [
+    'name',
+    'description',
+    'instructions',
+    'identifier',
+    'ifcVersions',
+    'ifcVersionRaw',
+    'minOccurs',
+    'maxOccurs',
+    'applicabilityCardinality',
+];
+const REQUIREMENT_FIELDS = ['optionality', 'cardinalityRaw', 'description', 'instructions'];
+export function same(x, y) {
+    return canonical(x) === canonical(y);
+}
+export function infoEntries(a, b) {
+    const out = [];
+    for (const field of INFO_FIELDS) {
+        const old = a.info[field];
+        const next = b.info[field];
+        if (old === next)
+            continue;
+        out.push({ kind: 'info.changed', field, ...(old !== undefined ? { old } : {}), ...(next !== undefined ? { new: next } : {}) });
+    }
+    return out;
+}
+function udtKey(d) {
+    return `${d.entity.toUpperCase()}\u0000${d.value.toUpperCase()}`;
+}
+export function customEntries(a, b) {
+    const out = [];
+    const psetsA = new Map(a.meta.custom.psets.map((d) => [d.name, d]));
+    const psetsB = new Map(b.meta.custom.psets.map((d) => [d.name, d]));
+    const declared = (d) => ({ kind: 'custom.psetDeclared', decl: d });
+    for (const [name, d] of psetsA) {
+        const other = psetsB.get(name);
+        if (!other || !same(d, other))
+            out.push({ kind: 'custom.psetRemoved', decl: d });
+    }
+    for (const [name, d] of psetsB) {
+        const other = psetsA.get(name);
+        if (!other || !same(d, other))
+            out.push(declared(d));
+    }
+    const udtA = new Map(a.meta.custom.userDefinedTypes.map((d) => [udtKey(d), d]));
+    const udtB = new Map(b.meta.custom.userDefinedTypes.map((d) => [udtKey(d), d]));
+    for (const [k, d] of udtA)
+        if (!udtB.has(k))
+            out.push({ kind: 'custom.userDefinedTypeRemoved', decl: d });
+    for (const [k, d] of udtB)
+        if (!udtA.has(k))
+            out.push({ kind: 'custom.userDefinedTypeDeclared', decl: d });
+    return out;
+}
+export function specField(spec, field) {
+    return field === 'applicabilityCardinality' ? spec.applicability.cardinality : spec[field];
+}
+/** required / optional / prohibited, as IDS reads minOccurs and maxOccurs. */
+export function specCardinality(spec) {
+    if (spec.maxOccurs === 0)
+        return 'prohibited';
+    return (spec.minOccurs ?? 0) >= 1 ? 'required' : 'optional';
+}
+export function specEntries(a, b) {
+    const out = [];
+    const cardinality = { old: specCardinality(a), new: specCardinality(b) };
+    for (const field of SPEC_FIELDS) {
+        const old = specField(a, field);
+        const next = specField(b, field);
+        if (same(old, next))
+            continue;
+        const occurs = field === 'minOccurs' || field === 'maxOccurs';
+        out.push({ kind: 'spec.changed', specId: a.id, specName: b.name, field, old, new: next, ...(occurs ? { cardinality } : {}) });
+    }
+    return out;
+}
+/** The requirement record of a site in its document, if it is a requirement. */
+export function requirementOf(doc, site) {
+    return site.section === 'requirements' ? doc.ids.specifications[site.specIndex].requirements[site.index] : undefined;
+}
+export function snapshot(r) {
+    if (!r)
+        return undefined;
+    const snap = { optionality: r.optionality };
+    if (r.cardinalityRaw !== undefined)
+        snap.cardinalityRaw = r.cardinalityRaw;
+    if (r.description !== undefined)
+        snap.description = r.description;
+    if (r.instructions !== undefined)
+        snap.instructions = r.instructions;
+    return snap;
+}
+/**
+ * Entries for one matched facet pair. `ctx` is the shared facet context
+ * (named by the id in `a`). A requirement that arrives from applicability
+ * starts as `required` with no texts (what `facet.move` creates), so only
+ * the differences from that are reported.
+ */
+export function facetEntries(ctx, aSite, bSite, reqA, reqB) {
+    const out = [];
+    if (aSite.facet.type !== bSite.facet.type) {
+        const requirement = snapshot(reqB);
+        out.push({ ...ctx, kind: 'facet.replaced', old: aSite.facet, nodes: bSite.nodes, ...(requirement ? { requirement } : {}) });
+        return out;
+    }
+    for (const field of FACET_FIELDS[aSite.facet.type]) {
+        const old = getField(aSite.facet, field);
+        const next = getField(bSite.facet, field);
+        if (same(old, next))
+            continue;
+        const constraintId = bSite.nodes.constraints[field];
+        out.push({
+            ...ctx,
+            kind: 'facet.valueChanged',
+            field,
+            ...(old ? { old } : {}),
+            ...(next ? { new: next } : {}),
+            ...(constraintId ? { constraintId } : {}),
+        });
+    }
+    if (aSite.facet.type === 'partOf' && bSite.facet.type === 'partOf') {
+        const o = { relation: aSite.facet.relation, ...(aSite.facet.rawRelation !== undefined ? { rawRelation: aSite.facet.rawRelation } : {}) };
+        const n = { relation: bSite.facet.relation, ...(bSite.facet.rawRelation !== undefined ? { rawRelation: bSite.facet.rawRelation } : {}) };
+        if (!same(o, n))
+            out.push({ ...ctx, kind: 'facet.relationChanged', old: o, new: n });
+    }
+    const oldUri = 'uri' in aSite.facet ? aSite.facet.uri : undefined;
+    const newUri = 'uri' in bSite.facet ? bSite.facet.uri : undefined;
+    if (oldUri !== newUri) {
+        out.push({ ...ctx, kind: 'facet.uriChanged', ...(oldUri !== undefined ? { old: oldUri } : {}), ...(newUri !== undefined ? { new: newUri } : {}) });
+    }
+    if (reqB) {
+        const base = reqA ?? { optionality: 'required' };
+        for (const field of REQUIREMENT_FIELDS) {
+            const old = base[field];
+            const next = reqB[field];
+            if (same(old, next))
+                continue;
+            out.push({ ...ctx, kind: 'requirement.changed', field, old, new: next });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=compare.js.map

package/dist/diff/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/diff/compare.ts"],"names":[],"mappings":"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"}

package/dist/diff/diff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `diffDocuments(a, b)`: the semantic diff (02-document-model-and-ops.md
+ * §6). Nodes are paired with the matcher shared with re-identification;
+ * paired nodes are compared field by field; unpaired ones are added or
+ * removed. Reorders are reported only for nodes off the longest run that
+ * kept its relative order, so moving one specification to the top reports
+ * one move, not N.
+ */
+import type { StudioDocument } from '../document/types.js';
+import type { DiffOptions, DocumentDiff } from './types.js';
+/** Compute the semantic diff from `a` to `b`. */
+export declare function diffDocuments(a: StudioDocument, b: StudioDocument, options?: DiffOptions): DocumentDiff;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAW,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIpE,OAAO,KAAK,EAAa,WAAW,EAAa,YAAY,EAA+C,MAAM,YAAY,CAAC;AAqG/H,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,GAAE,WAAgB,GAAG,YAAY,CAuC3G"}

package/dist/diff/diff.js

@@ -0,0 +1,140 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { align, facetSites, longestIncreasing, SECTIONS } from './align.js';
+import { customEntries, facetEntries, infoEntries, requirementOf, snapshot, specEntries } from './compare.js';
+/** Id of a `b` spec in the patched document's id space. */
+function targetSpecId(w, n) {
+    const pair = w.al.specs.pairs.get(n);
+    return pair ? w.a.ids.specifications[pair.prev].id : w.b.ids.specifications[n].id;
+}
+function context(w, n, site, matched) {
+    const spec = w.b.ids.specifications[n];
+    const req = requirementOf(w.b, site);
+    return {
+        specId: targetSpecId(w, n),
+        specName: spec.name,
+        section: site.section,
+        facetId: matched?.nodes.id ?? site.nodes.id,
+        facet: site.facet,
+        ...(req ? { optionality: req.optionality } : {}),
+    };
+}
+/** Facet rows and entries of `b` spec `n` in `section`. */
+function walkSection(w, n, section, rows, specAdded) {
+    const sites = facetSites(w.b, n, section);
+    const tSpec = targetSpecId(w, n);
+    const pair = w.al.specs.pairs.get(n);
+    // In-section reorders: LIS over the `a` indices of facets that stayed in
+    // this (matched) spec and section.
+    const stayed = [];
+    for (const site of sites) {
+        const hit = w.al.facets.get(site.nodes.id);
+        if (hit && pair && hit.a.specIndex === pair.prev && hit.a.section === section) {
+            stayed.push({ bIndex: site.index, aIndex: hit.a.index });
+        }
+    }
+    const keep = longestIncreasing(stayed.map((s) => s.aIndex));
+    const kept = new Set(stayed.filter((_, i) => keep.has(i)).map((s) => s.bIndex));
+    const order = [];
+    for (const site of sites) {
+        const hit = w.al.facets.get(site.nodes.id);
+        const ctx = context(w, n, site, hit?.a);
+        const bRow = { specId: tSpec, section, index: site.index, facetId: site.nodes.id };
+        if (!hit) {
+            order.push(site.nodes.id);
+            rows.push({ b: bRow, status: 'added' });
+            if (!specAdded) {
+                const requirement = snapshot(requirementOf(w.b, site));
+                w.entries.push({ ...ctx, kind: 'facet.added', index: site.index, nodes: site.nodes, ...(requirement ? { requirement } : {}) });
+            }
+            continue;
+        }
+        order.push(hit.a.nodes.id);
+        const crossed = !pair || hit.a.specIndex !== pair.prev || hit.a.section !== section;
+        const moved = crossed || !kept.has(site.index);
+        const changes = facetEntries(ctx, hit.a, site, requirementOf(w.a, hit.a), requirementOf(w.b, site));
+        if (moved) {
+            w.entries.push({
+                ...ctx,
+                kind: 'facet.moved',
+                from: { specId: hit.a.specId, section: hit.a.section, index: hit.a.index },
+                to: { specId: tSpec, section, index: site.index },
+            });
+        }
+        w.entries.push(...changes);
+        rows.push({
+            a: { specId: hit.a.specId, section: hit.a.section, index: hit.a.index, facetId: hit.a.nodes.id },
+            b: bRow,
+            by: hit.by,
+            status: moved ? 'moved' : changes.length ? 'changed' : 'unchanged',
+        });
+    }
+    // Facets of the matched `a` spec section that nothing continues.
+    if (pair) {
+        for (const site of facetSites(w.a, pair.prev, section)) {
+            if (w.al.usedA.has(site.nodes.id))
+                continue;
+            const spec = w.b.ids.specifications[n];
+            const req = requirementOf(w.a, site);
+            w.entries.push({
+                kind: 'facet.removed',
+                specId: tSpec,
+                specName: spec.name,
+                section,
+                facetId: site.nodes.id,
+                facet: site.facet,
+                index: site.index,
+                ...(req ? { optionality: req.optionality } : {}),
+            });
+            rows.push({ a: { specId: site.specId, section, index: site.index, facetId: site.nodes.id }, status: 'removed' });
+        }
+    }
+    return order;
+}
+/** Compute the semantic diff from `a` to `b`. */
+export function diffDocuments(a, b, options = {}) {
+    const byNodeId = options.byNodeId ?? a.docId === b.docId;
+    const al = align(a, b, byNodeId, options.threshold);
+    const w = { a, b, al, entries: [...infoEntries(a.ids, b.ids), ...customEntries(a, b)], order: { specs: [], sections: {} } };
+    const specs = [];
+    const pairs = b.ids.specifications.map((_, n) => ({ n, prev: al.specs.pairs.get(n)?.prev }));
+    const matched = pairs.filter((p) => p.prev !== undefined);
+    const keep = longestIncreasing(matched.map((p) => p.prev));
+    const kept = new Set(matched.filter((_, i) => keep.has(i)).map((p) => p.n));
+    b.ids.specifications.forEach((spec, n) => {
+        const pair = al.specs.pairs.get(n);
+        const tSpec = targetSpecId(w, n);
+        w.order.specs.push(tSpec);
+        const before = w.entries.length;
+        const rows = [];
+        if (!pair) {
+            w.entries.push({ kind: 'spec.added', specId: spec.id, specName: spec.name, index: n, spec, nodes: b.nodes.specs[n] });
+        }
+        else {
+            const old = a.ids.specifications[pair.prev];
+            if (!kept.has(n))
+                w.entries.push({ kind: 'spec.moved', specId: old.id, specName: spec.name, from: pair.prev, to: n });
+            w.entries.push(...specEntries(old, spec));
+        }
+        const sections = { applicability: [], requirements: [] };
+        for (const section of SECTIONS)
+            sections[section] = walkSection(w, n, section, rows, !pair);
+        w.order.sections[tSpec] = sections;
+        const old = pair ? a.ids.specifications[pair.prev] : undefined;
+        specs.push({
+            ...(old && pair ? { a: { index: pair.prev, specId: old.id, name: old.name }, by: pair.by } : {}),
+            b: { index: n, specId: tSpec, name: spec.name },
+            status: !pair ? 'added' : !kept.has(n) ? 'moved' : w.entries.length > before ? 'changed' : 'unchanged',
+            facets: rows,
+        });
+    });
+    a.ids.specifications.forEach((spec, p) => {
+        if (al.specs.usedPrev.has(p))
+            return;
+        w.entries.push({ kind: 'spec.removed', specId: spec.id, specName: spec.name, index: p });
+        specs.push({ a: { index: p, specId: spec.id, name: spec.name }, status: 'removed', facets: [] });
+    });
+    return { identical: w.entries.length === 0, byNodeId, entries: w.entries, specs, order: w.order };
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAa/D,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAkC,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAW9G,2DAA2D;AAC3D,SAAS,YAAY,CAAC,CAAO,EAAE,CAAS;IACtC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,OAAO,CAAC,CAAO,EAAE,CAAS,EAAE,IAAe,EAAE,OAA8B;IAClF,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE;QAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,SAAS,WAAW,CAAC,CAAO,EAAE,CAAS,EAAE,OAAgB,EAAE,IAAsB,EAAE,SAAkB;IACnG,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,yEAAyE;IACzE,mCAAmC;IACnC,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACnF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;gBACvD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACjI,CAAC;YACD,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC;QACpF,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACpG,IAAI,KAAK,EAAE,CAAC;YACV,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBACb,GAAG,GAAG;gBACN,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;gBAC1E,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aAClD,CAAC,CAAC;QACL,CAAC;QACD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC;YACR,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YAChG,CAAC,EAAE,IAAI;YACP,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;SACnE,CAAC,CAAC;IACL,CAAC;IACD,iEAAiE;IACjE,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,OAAO;gBACP,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBACtB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjD,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,CAAiB,EAAE,CAAiB,EAAE,UAAuB,EAAE;IAC3F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;IACzD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,CAAC,GAAS,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;IAClI,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,MAAM,IAAI,GAAqB,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YACtH,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,QAAQ,GAAG,EAAE,aAAa,EAAE,EAAY,EAAE,YAAY,EAAE,EAAY,EAAE,CAAC;QAC7E,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5F,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YAC/C,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;YACtG,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACvC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO;QACrC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AACpG,CAAC"}

package/dist/diff/index.d.ts

@@ -0,0 +1,5 @@
+export { diffDocuments } from './diff.js';
+export { diffToOps, type PatchOptions } from './patch.js';
+export { changelog, changelogMarkdown, describeChange, facetLabel, type ChangelogLine, type ChangelogOptions } from './changelog.js';
+export type { DiffEntry, DiffEntryKind, DiffOptions, DiffOrder, DocumentDiff, FacetAlignment, FacetContext, RequirementField, SpecAlignment, SpecField, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/diff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diff/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrI,YAAY,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/diff/index.js

@@ -0,0 +1,7 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export { diffDocuments } from './diff.js';
+export { diffToOps } from './patch.js';
+export { changelog, changelogMarkdown, describeChange, facetLabel } from './changelog.js';
+//# sourceMappingURL=index.js.map

package/dist/diff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diff/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAqB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAA6C,MAAM,gBAAgB,CAAC"}

package/dist/diff/patch.d.ts

@@ -0,0 +1,10 @@
+import type { StudioDocument } from '../document/types.js';
+import type { PrimitiveOp } from '../ops/types.js';
+import type { DocumentDiff } from './types.js';
+export interface PatchOptions {
+    /** Seed for the deterministic op ids (default: `diff`). */
+    seed?: string;
+}
+/** Ops that turn `a` into the document `diff` was computed against. */
+export declare function diffToOps(a: StudioDocument, diff: DocumentDiff, options?: PatchOptions): PrimitiveOp[];
+//# sourceMappingURL=patch.d.ts.map

package/dist/diff/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/diff/patch.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAkC,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAc,WAAW,EAAkC,MAAM,iBAAiB,CAAC;AAK/F,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoID,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,EAAE,CA+B1G"}