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

package/dist/revision/verify.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tamper evidence for a revision log: every hash is recomputed and every
+ * link checked. Problems are data (`code`, `revId`, `message`), so a UI can
+ * mark the affected revisions and a CLI can fail.
+ */
+import type { Uuid } from '../uuid.js';
+import { type RevisionLog } from './revision.js';
+export type RevisionProblemCode = 'REV-FORMAT-001' | 'REV-DOC-001' | 'REV-DUP-001' | 'REV-HASH-001' | 'REV-CONTENT-001' | 'REV-CHAIN-001' | 'REV-RELEASED-001' | 'SIGN-REV-001' | 'SIGN-HASH-001' | 'SIGN-CHAIN-001';
+export interface RevisionProblem {
+    code: RevisionProblemCode;
+    message: string;
+    revId?: Uuid;
+    /** Index of the sign-off, for SIGN-* problems. */
+    signOff?: number;
+}
+export interface RevisionVerification {
+    ok: boolean;
+    problems: RevisionProblem[];
+}
+export declare function verifyRevisionLog(log: RevisionLog): RevisionVerification;
+//# sourceMappingURL=verify.d.ts.map

package/dist/revision/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/revision/verify.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAA+D,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9G,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,oBAAoB,CAoCxE"}

package/dist/revision/verify.js

@@ -0,0 +1,51 @@
+/* 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 { contentHash, REVISION_LOG_FORMAT, revisionHash, signOffHash } from './revision.js';
+export function verifyRevisionLog(log) {
+    const problems = [];
+    if (log.format !== REVISION_LOG_FORMAT)
+        problems.push({ code: 'REV-FORMAT-001', message: 'not an IDS Studio revision log' });
+    const byId = new Map();
+    for (const r of log.revisions) {
+        if (byId.has(r.revId))
+            problems.push({ code: 'REV-DUP-001', revId: r.revId, message: 'revision id appears twice' });
+        byId.set(r.revId, r);
+    }
+    log.revisions.forEach((r, i) => {
+        const at = { revId: r.revId };
+        if (r.docId !== log.docId || r.snapshot.docId !== log.docId)
+            problems.push({ ...at, code: 'REV-DOC-001', message: 'revision belongs to another document' });
+        if (revisionHash(r) !== r.hash)
+            problems.push({ ...at, code: 'REV-HASH-001', message: 'revision record does not match its hash' });
+        if (contentHash(r.snapshot) !== r.contentHash)
+            problems.push({ ...at, code: 'REV-CONTENT-001', message: 'revision content does not match its content hash' });
+        if (r.parentRevId === undefined) {
+            if (i > 0 || r.parentHash !== undefined)
+                problems.push({ ...at, code: 'REV-CHAIN-001', message: 'only the first revision may have no parent' });
+            return;
+        }
+        const parent = byId.get(r.parentRevId);
+        const parentIndex = log.revisions.findIndex((x) => x.revId === r.parentRevId);
+        if (!parent || parentIndex >= i || parent.hash !== r.parentHash) {
+            problems.push({ ...at, code: 'REV-CHAIN-001', message: 'parent revision is missing, later, or does not match the recorded parent hash' });
+            return;
+        }
+        if (parent.label === 'released' && parent.contentHash !== r.contentHash && r.label !== 'draft') {
+            problems.push({ ...at, code: 'REV-RELEASED-001', message: 'a released revision was edited without starting a new draft' });
+        }
+    });
+    log.signOffs.forEach((s, i) => {
+        const at = { revId: s.revId, signOff: i };
+        const revision = byId.get(s.revId);
+        if (!revision || revision.hash !== s.revisionHash)
+            problems.push({ ...at, code: 'SIGN-REV-001', message: 'signed revision is missing or changed since it was signed' });
+        if (signOffHash(s) !== s.hash)
+            problems.push({ ...at, code: 'SIGN-HASH-001', message: 'sign-off record does not match its hash' });
+        const prev = i > 0 ? log.signOffs[i - 1].hash : '';
+        if (s.prevHash !== prev)
+            problems.push({ ...at, code: 'SIGN-CHAIN-001', message: 'sign-off chain is broken (a sign-off was removed, inserted or reordered)' });
+    });
+    return { ok: problems.length === 0, problems };
+}
+//# sourceMappingURL=verify.js.map

package/dist/revision/verify.js.map

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

package/dist/revision/view.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Framework-free view model of a revision log: a timeline with labels,
+ * sign-offs, what changed against the parent (plain language) and
+ * whether the entry passed verification.
+ */
+import type { SupportedLocale } from '@ifc-lite/ids';
+import type { Uuid } from '../uuid.js';
+import { type RevisionLabel, type RevisionLog } from './revision.js';
+import { type RevisionProblem } from './verify.js';
+export interface TimelineEntry {
+    revId: Uuid;
+    label: RevisionLabel;
+    author: string;
+    at: string;
+    message?: string;
+    /** Short hash for display. */
+    shortHash: string;
+    isHead: boolean;
+    readOnly: boolean;
+    signOffs: {
+        by: string;
+        role?: string;
+        at: string;
+        statement: string;
+    }[];
+    /** Changes against the parent revision, as sentences. */
+    changes: string[];
+    problems: RevisionProblem[];
+}
+export interface RevisionTimeline {
+    entries: TimelineEntry[];
+    /** The whole log verified. */
+    verified: boolean;
+}
+export declare function revisionTimeline(log: RevisionLog, locale?: SupportedLocale): RevisionTimeline;
+//# sourceMappingURL=view.d.ts.map

package/dist/revision/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/revision/view.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzE,yDAAyD;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,GAAE,eAAsB,GAAG,gBAAgB,CAuBnG"}

package/dist/revision/view.js

@@ -0,0 +1,32 @@
+/* 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 { changelog } from '../diff/changelog.js';
+import { diffDocuments } from '../diff/diff.js';
+import { findRevision } from './revision.js';
+import { verifyRevisionLog } from './verify.js';
+export function revisionTimeline(log, locale = 'en') {
+    const { ok, problems } = verifyRevisionLog(log);
+    const head = log.revisions[log.revisions.length - 1]?.revId;
+    const entries = log.revisions.map((r) => {
+        const parent = r.parentRevId ? findRevision(log, r.parentRevId) : undefined;
+        const changes = parent ? changelog(diffDocuments(parent.snapshot, r.snapshot), { locale }).map((l) => l.text) : [];
+        return {
+            revId: r.revId,
+            label: r.label,
+            author: r.author,
+            at: r.at,
+            ...(r.message !== undefined ? { message: r.message } : {}),
+            shortHash: r.hash.slice(0, 12),
+            isHead: r.revId === head,
+            readOnly: r.label === 'released',
+            signOffs: log.signOffs
+                .filter((s) => s.revId === r.revId)
+                .map((s) => ({ by: s.by, at: s.at, statement: s.statement, ...(s.role !== undefined ? { role: s.role } : {}) })),
+            changes,
+            problems: problems.filter((p) => p.revId === r.revId),
+        };
+    });
+    return { entries: entries.reverse(), verified: ok };
+}
+//# sourceMappingURL=view.js.map

package/dist/revision/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/revision/view.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAS/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAwC,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAwBtE,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,SAA0B,IAAI;IAC/E,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAiB,EAAE;QACrD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnH,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI;YACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,KAAK,UAAU;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAClH,OAAO;YACP,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;SACtD,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACtD,CAAC"}

package/dist/sidecar/idsz.d.ts

@@ -0,0 +1,14 @@
+import { type StudioSidecar } from './sidecar.js';
+export declare const IDSZ_XML = "ids.xml";
+export declare const IDSZ_APPENDIX = "appendix.pdf";
+export interface IdszContent {
+    xml: string;
+    sidecar?: StudioSidecar;
+    /** File name → bytes. Names must not contain path separators. */
+    fixtures?: Record<string, Uint8Array>;
+    appendix?: Uint8Array;
+}
+export declare function writeIdsz(content: IdszContent): Uint8Array;
+/** Read a bundle. Unknown entries are ignored; a missing `ids.xml` throws. */
+export declare function readIdsz(bytes: Uint8Array): IdszContent;
+//# sourceMappingURL=idsz.d.ts.map

package/dist/sidecar/idsz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idsz.d.ts","sourceRoot":"","sources":["../../src/sidecar/idsz.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAoD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAEpG,eAAO,MAAM,QAAQ,YAAY,CAAC;AAClC,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAID,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAW1D;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAgBvD"}

package/dist/sidecar/idsz.js

@@ -0,0 +1,58 @@
+/* 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/. */
+/**
+ * `.idsz` bundle: a plain zip anyone can inspect (01-overview.md §7).
+ *
+ *   ids.xml          the IDS, byte-for-byte as given
+ *   studio.json      the sidecar (optional)
+ *   fixtures/<name>  test models (optional)
+ *   appendix.pdf     readable appendix (optional, produced elsewhere)
+ *
+ * The XML is stored verbatim, so a bundle with and without sidecar carries
+ * byte-identical XML. Entries use a fixed timestamp, so writing the same
+ * content twice yields the same bytes.
+ */
+import { strFromU8, strToU8, unzipSync, zipSync } from 'fflate';
+import { parseSidecar, serializeSidecar, SIDECAR_FILENAME } from './sidecar.js';
+export const IDSZ_XML = 'ids.xml';
+export const IDSZ_APPENDIX = 'appendix.pdf';
+const FIXTURE_DIR = 'fixtures/';
+const FIXED_MTIME = new Date(Date.UTC(1980, 0, 1, 0, 0, 0));
+export function writeIdsz(content) {
+    const files = { [IDSZ_XML]: [strToU8(content.xml), { mtime: FIXED_MTIME }] };
+    if (content.sidecar)
+        files[SIDECAR_FILENAME] = [strToU8(serializeSidecar(content.sidecar)), { mtime: FIXED_MTIME }];
+    for (const [name, bytes] of Object.entries(content.fixtures ?? {})) {
+        if (!name || name.includes('/') || name.includes('\\') || name === '.' || name === '..') {
+            throw new Error(`invalid fixture name "${name}"`);
+        }
+        files[`${FIXTURE_DIR}${name}`] = [bytes, { mtime: FIXED_MTIME }];
+    }
+    if (content.appendix)
+        files[IDSZ_APPENDIX] = [content.appendix, { mtime: FIXED_MTIME }];
+    return zipSync(files, { level: 6 });
+}
+/** Read a bundle. Unknown entries are ignored; a missing `ids.xml` throws. */
+export function readIdsz(bytes) {
+    const entries = unzipSync(bytes);
+    const xml = entries[IDSZ_XML];
+    if (!xml)
+        throw new Error(`not an .idsz bundle: ${IDSZ_XML} is missing`);
+    const out = { xml: strFromU8(xml) };
+    const sidecar = entries[SIDECAR_FILENAME];
+    if (sidecar)
+        out.sidecar = parseSidecar(strFromU8(sidecar));
+    const fixtures = {};
+    for (const [path, data] of Object.entries(entries)) {
+        if (path.startsWith(FIXTURE_DIR) && path.length > FIXTURE_DIR.length && !path.endsWith('/')) {
+            fixtures[path.slice(FIXTURE_DIR.length)] = data;
+        }
+    }
+    if (Object.keys(fixtures).length)
+        out.fixtures = fixtures;
+    if (entries[IDSZ_APPENDIX])
+        out.appendix = entries[IDSZ_APPENDIX];
+    return out;
+}
+//# sourceMappingURL=idsz.js.map

package/dist/sidecar/idsz.js.map

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

package/dist/sidecar/sidecar-schema.d.ts

@@ -0,0 +1,4 @@
+import { type SchemaError } from '../ops/json-schema-lite.js';
+/** The op validator's node/UUID definitions also govern imported sidecars (#7168, IDS-025). */
+export declare function validateSidecarShape(value: unknown): SchemaError[];
+//# sourceMappingURL=sidecar-schema.d.ts.map

package/dist/sidecar/sidecar-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-schema.d.ts","sourceRoot":"","sources":["../../src/sidecar/sidecar-schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAoE7F,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAElE"}

package/dist/sidecar/sidecar-schema.js

@@ -0,0 +1,69 @@
+/* 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 { validateJson } from '../ops/json-schema-lite.js';
+import { VALUE_DEFS } from '../ops/schema-values.js';
+const str = { type: 'string' };
+const uuid = { $ref: '#/$defs/Uuid' };
+const arr = (items) => ({ type: 'array', items });
+const record = (values) => ({ type: 'object', additionalProperties: values });
+// Preserve extension fields while validating every field consumed by this core.
+const object = (properties, required = []) => ({
+    type: 'object', properties, required,
+});
+const provenance = { oneOf: [
+        object({ by: { const: 'user' }, userId: str, at: str, opId: uuid }, ['by', 'at', 'opId']),
+        object({ by: { const: 'ai' }, runId: uuid, model: str, at: str, opId: uuid }, ['by', 'runId', 'model', 'at', 'opId']),
+        object({
+            by: { const: 'import' },
+            format: { enum: ['ids', 'xlsx', 'csv', 'yaml', 'bsdd', 'template', 'infer'] },
+            ref: str, at: str, opId: uuid,
+        }, ['by', 'format', 'at', 'opId']),
+    ] };
+const source = object({
+    docRef: str, kind: { enum: ['pdf', 'docx', 'xlsx', 'text'] },
+    page: { type: 'number' }, para: { type: 'number' }, sheet: str, cell: str, quote: str,
+}, ['docRef', 'kind', 'quote']);
+const comment = object({ author: str, at: str, text: str }, ['author', 'at', 'text']);
+const thread = object({ id: uuid, resolved: { type: 'boolean' }, comments: arr(comment) }, ['id', 'resolved', 'comments']);
+const suppression = object({ rule: str, reason: str, by: str, at: str }, ['rule', 'reason', 'at']);
+const meta = object({
+    provenance: record(arr(provenance)), sources: record(arr(source)), comments: record(arr(thread)),
+    suppressions: record(arr(suppression)),
+    // Later pitches own these payloads; only their collection shape belongs here.
+    tests: record({}), mappings: arr({}), unresolved: arr({}),
+    revision: object({
+        parentHash: str, label: str,
+        signOffs: arr(object({ by: str, at: str, role: str }, ['by', 'at'])),
+    }),
+    custom: object({
+        psets: arr({ $ref: '#/$defs/CustomPsetDecl' }),
+        userDefinedTypes: arr(object({ entity: str, value: str }, ['entity', 'value'])),
+    }, ['psets', 'userDefinedTypes']),
+}, ['provenance', 'sources', 'comments', 'suppressions', 'tests', 'mappings', 'revision', 'unresolved', 'custom']);
+// Optional content snapshot (versioned on its own). Version 1 is checked as
+// far as snapshot re-identification reads it (`attachSidecar` also verifies
+// it against the node index); a later version is kept opaque and ignored on
+// attachment, so a newer writer does not make the sidecar unreadable.
+const snapshotSpec = object({
+    applicability: object({ facets: arr({ type: 'object' }) }, ['facets']),
+    requirements: arr({ type: 'object' }),
+}, ['applicability', 'requirements']);
+const snapshot = { anyOf: [
+        object({
+            version: { const: 1 },
+            ids: object({ info: { type: 'object' }, specifications: arr(snapshotSpec) }, ['info', 'specifications']),
+        }, ['version', 'ids']),
+        object({ version: { type: 'integer', minimum: 2 } }, ['version']),
+    ] };
+const sidecar = object({
+    docId: uuid, idsFingerprint: str,
+    nodes: object({ document: uuid, specs: arr({ $ref: '#/$defs/SpecNodes' }) }, ['document', 'specs']),
+    meta,
+    snapshot,
+}, ['docId', 'idsFingerprint', 'nodes', 'meta']);
+/** The op validator's node/UUID definitions also govern imported sidecars (#7168, IDS-025). */
+export function validateSidecarShape(value) {
+    return validateJson(value, sidecar, VALUE_DEFS);
+}
+//# sourceMappingURL=sidecar-schema.js.map

package/dist/sidecar/sidecar-schema.js.map

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

package/dist/sidecar/sidecar.d.ts

@@ -0,0 +1,102 @@
+/**
+ * The `studio.json` sidecar (ADR-001): everything Studio-specific about an
+ * IDS document — node ids and `StudioMeta` — persisted NEXT TO the IDS XML,
+ * never inside it, so the XML stays standard.
+ *
+ * The node index is positional (it mirrors the document shape), so the
+ * sidecar records a fingerprint of the IDS content it was written for.
+ * `attachSidecar` stamps the ids back only when the XML still has that
+ * fingerprint; when the XML was edited elsewhere it re-identifies nodes
+ * against the previous document (`reidentify`), so comments and
+ * provenance survive.
+ */
+import { type IDSDocument } from '@ifc-lite/ids';
+import { STUDIO_SCHEMA_VERSION, type NodeIndex, type StudioDocument, type StudioMeta } from '../document/types.js';
+import { type ReidentifyReport } from '../match/reidentify.js';
+import { type Uuid } from '../uuid.js';
+export declare const SIDECAR_FORMAT = "ifc-lite.ids-studio.sidecar";
+export declare const SIDECAR_FILENAME = "studio.json";
+/**
+ * Version of the optional content snapshot. It is versioned on its own so
+ * the snapshot can evolve without bumping the sidecar `schemaVersion`:
+ * sidecars without a snapshot (written before it existed) still load, and
+ * a snapshot with a version this reader does not know is ignored.
+ */
+export declare const SIDECAR_SNAPSHOT_VERSION = 1;
+/**
+ * The IDS content the node index was written for, so a standalone `.idsz`
+ * edited elsewhere can be re-identified without the previous document.
+ * `ids` carries the Studio node UUIDs as specification / requirement ids.
+ */
+export interface SidecarSnapshot {
+    /** {@link SIDECAR_SNAPSHOT_VERSION} when written by this core; later versions are read but ignored. */
+    version: number;
+    ids: IDSDocument;
+}
+export interface StudioSidecar {
+    format: typeof SIDECAR_FORMAT;
+    schemaVersion: typeof STUDIO_SCHEMA_VERSION;
+    docId: Uuid;
+    /** Fingerprint of the IDS content the node index was written for. */
+    idsFingerprint: string;
+    nodes: NodeIndex;
+    meta: StudioMeta;
+    /** Optional content snapshot (additive; absent in older sidecars). */
+    snapshot?: SidecarSnapshot;
+}
+export interface CreateSidecarOptions {
+    /**
+     * Embed a content snapshot so the bundle can be re-identified on its own
+     * after an external edit. Default `true`; pass `false` for a smaller
+     * sidecar when the previous document is always available elsewhere.
+     */
+    snapshot?: boolean;
+}
+/**
+ * Fingerprint of IDS content, independent of node ids (specification and
+ * requirement `id`s are positional after a parse and UUIDs inside Studio).
+ */
+export declare function fingerprintIds(ids: IDSDocument): string;
+/**
+ * Build the sidecar for `doc`. Pass the XML that will travel with it when
+ * there is one: the fingerprint is then taken from what a reader will
+ * parse, which is what `attachSidecar` compares against.
+ */
+export declare function createSidecar(doc: StudioDocument, xml?: string, options?: CreateSidecarOptions): StudioSidecar;
+/** Stable, human-diffable JSON (2-space indent, trailing newline). */
+export declare function serializeSidecar(sidecar: StudioSidecar): string;
+/** Parse and validate `studio.json`. Throws on a foreign or newer format. */
+export declare function parseSidecar(json: string): StudioSidecar;
+export type AttachResult = {
+    doc: StudioDocument;
+    binding: 'exact';
+} | {
+    doc: StudioDocument;
+    binding: 'reidentified';
+    report: ReidentifyReport;
+    /** What the nodes were matched against: `options.previous` or the sidecar's snapshot. */
+    basis: 'previous' | 'snapshot';
+} | {
+    doc: StudioDocument;
+    binding: 'fresh';
+};
+export interface AttachOptions {
+    newId?: () => Uuid;
+    /**
+     * The document as it was when the sidecar was written (e.g. from the
+     * local library). When the XML changed elsewhere, its nodes are
+     * re-identified against this instead of getting fresh ids.
+     */
+    previous?: StudioDocument;
+}
+/**
+ * Rebuild a Studio document from parsed IDS content and its sidecar. When
+ * the content still has the sidecar's fingerprint the node ids are reused
+ * exactly. Otherwise nodes are re-identified (identifier → name +
+ * signature → similarity) against the `previous` document or, without it,
+ * against the sidecar's content snapshot; when neither is usable the
+ * document gets fresh ids. `docId` and `meta` are kept either way and
+ * `binding` tells the caller which path was taken.
+ */
+export declare function attachSidecar(ids: IDSDocument, sidecar: StudioSidecar, options?: AttachOptions): AttachResult;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/sidecar/sidecar.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,EAAE,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,EAAmB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,cAAc,gCAAgC,CAAC;AAC5D,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,aAAa,EAAE,OAAO,qBAAqB,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC;IACZ,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAUvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAmBlH;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE/D;AAMD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAWxD;AAkCD,MAAM,MAAM,YAAY,GACpB;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACzC;IACE,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,yFAAyF;IACzF,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;CAChC,GACD;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAqBjH"}

package/dist/sidecar/sidecar.js

@@ -0,0 +1,160 @@
+/* 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/. */
+/**
+ * The `studio.json` sidecar (ADR-001): everything Studio-specific about an
+ * IDS document — node ids and `StudioMeta` — persisted NEXT TO the IDS XML,
+ * never inside it, so the XML stays standard.
+ *
+ * The node index is positional (it mirrors the document shape), so the
+ * sidecar records a fingerprint of the IDS content it was written for.
+ * `attachSidecar` stamps the ids back only when the XML still has that
+ * fingerprint; when the XML was edited elsewhere it re-identifies nodes
+ * against the previous document (`reidentify`), so comments and
+ * provenance survive.
+ */
+import { parseIDS } from '@ifc-lite/ids';
+import { fromIdsDocument } from '../document/from-ids.js';
+import { verifyNodeIndex } from '../document/node-index.js';
+import { STUDIO_SCHEMA_VERSION } from '../document/types.js';
+import { reidentify } from '../match/reidentify.js';
+import { canonicalJson } from '../canonical-json.js';
+import { fnv1a64, uuidv7 } from '../uuid.js';
+import { validateSidecarShape } from './sidecar-schema.js';
+export const SIDECAR_FORMAT = 'ifc-lite.ids-studio.sidecar';
+export const SIDECAR_FILENAME = 'studio.json';
+/**
+ * Version of the optional content snapshot. It is versioned on its own so
+ * the snapshot can evolve without bumping the sidecar `schemaVersion`:
+ * sidecars without a snapshot (written before it existed) still load, and
+ * a snapshot with a version this reader does not know is ignored.
+ */
+export const SIDECAR_SNAPSHOT_VERSION = 1;
+/**
+ * Fingerprint of IDS content, independent of node ids (specification and
+ * requirement `id`s are positional after a parse and UUIDs inside Studio).
+ */
+export function fingerprintIds(ids) {
+    const stripped = {
+        ...ids,
+        specifications: ids.specifications.map((s) => ({
+            ...s,
+            id: undefined,
+            requirements: s.requirements.map((r) => ({ ...r, id: undefined })),
+        })),
+    };
+    return fnv1a64(canonicalJson(stripped)).toString(16).padStart(16, '0');
+}
+/**
+ * Build the sidecar for `doc`. Pass the XML that will travel with it when
+ * there is one: the fingerprint is then taken from what a reader will
+ * parse, which is what `attachSidecar` compares against.
+ */
+export function createSidecar(doc, xml, options = {}) {
+    let content = doc.ids;
+    if (xml !== undefined) {
+        content = parseIDS(xml);
+        const shape = (d) => d.specifications.map((s) => `${s.applicability.facets.length}/${s.requirements.length}`).join(',');
+        if (shape(content) !== shape(doc.ids)) {
+            throw new Error('the XML does not have the shape of the document; write it from this document');
+        }
+    }
+    const sidecar = {
+        format: SIDECAR_FORMAT,
+        schemaVersion: STUDIO_SCHEMA_VERSION,
+        docId: doc.docId,
+        idsFingerprint: fingerprintIds(content),
+        nodes: doc.nodes,
+        meta: doc.meta,
+    };
+    if (options.snapshot !== false)
+        sidecar.snapshot = { version: SIDECAR_SNAPSHOT_VERSION, ids: doc.ids };
+    return sidecar;
+}
+/** Stable, human-diffable JSON (2-space indent, trailing newline). */
+export function serializeSidecar(sidecar) {
+    return `${JSON.stringify(sidecar, null, 2)}\n`;
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** Parse and validate `studio.json`. Throws on a foreign or newer format. */
+export function parseSidecar(json) {
+    const value = JSON.parse(json);
+    if (!isRecord(value) || value.format !== SIDECAR_FORMAT)
+        throw new Error('not an IDS Studio sidecar');
+    if (value.schemaVersion !== STUDIO_SCHEMA_VERSION) {
+        throw new Error(`unsupported sidecar schemaVersion ${String(value.schemaVersion)}`);
+    }
+    const errors = validateSidecarShape(value);
+    if (errors.length) {
+        throw new Error(`IDS Studio sidecar is incomplete or invalid: ${errors[0].path} ${errors[0].message}`);
+    }
+    return value;
+}
+/** Stamp node ids onto parsed content positionally; undefined if the shape differs. */
+function stamp(ids, sidecar) {
+    const nodes = sidecar.nodes;
+    if (nodes.specs.length !== ids.specifications.length)
+        return undefined;
+    const doc = {
+        docId: sidecar.docId,
+        schemaVersion: STUDIO_SCHEMA_VERSION,
+        ids: {
+            ...ids,
+            specifications: ids.specifications.map((s, i) => ({
+                ...s,
+                id: nodes.specs[i].id,
+                requirements: s.requirements.map((r, j) => ({ ...r, id: nodes.specs[i].requirements[j]?.id ?? r.id })),
+            })),
+        },
+        nodes,
+        meta: sidecar.meta,
+    };
+    return verifyNodeIndex(doc).length === 0 ? doc : undefined;
+}
+/**
+ * The document as it was when the sidecar was written, rebuilt from its
+ * snapshot; undefined when there is no snapshot, its version is unknown, or
+ * it does not fit the node index.
+ */
+function snapshotDocument(sidecar) {
+    const snapshot = sidecar.snapshot;
+    if (!snapshot || snapshot.version !== SIDECAR_SNAPSHOT_VERSION)
+        return undefined;
+    return stamp(snapshot.ids, sidecar);
+}
+/**
+ * Rebuild a Studio document from parsed IDS content and its sidecar. When
+ * the content still has the sidecar's fingerprint the node ids are reused
+ * exactly. Otherwise nodes are re-identified (identifier → name +
+ * signature → similarity) against the `previous` document or, without it,
+ * against the sidecar's content snapshot; when neither is usable the
+ * document gets fresh ids. `docId` and `meta` are kept either way and
+ * `binding` tells the caller which path was taken.
+ */
+export function attachSidecar(ids, sidecar, options = {}) {
+    const newId = options.newId ?? (() => uuidv7());
+    if (fingerprintIds(ids) === sidecar.idsFingerprint) {
+        const doc = stamp(ids, sidecar);
+        if (doc)
+            return { doc, binding: 'exact' };
+    }
+    if (options.previous) {
+        const base = { ...options.previous, docId: sidecar.docId, meta: sidecar.meta };
+        const { doc, report } = reidentify(base, ids, { newId });
+        return { doc, binding: 'reidentified', report, basis: 'previous' };
+    }
+    const fromSnapshot = snapshotDocument(sidecar);
+    if (fromSnapshot) {
+        try {
+            const { doc, report } = reidentify(fromSnapshot, ids, { newId });
+            return { doc, binding: 'reidentified', report, basis: 'snapshot' };
+        }
+        catch {
+            // A snapshot that passed the shape check but not the matcher falls back to fresh ids.
+        }
+    }
+    return { doc: fromIdsDocument(ids, { docId: sidecar.docId, meta: sidecar.meta, newId }), binding: 'fresh' };
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/sidecar/sidecar.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,6 @@
+export type { FixtureRecipe, TestCase, TestExpectation, TestFixture, TestSuite } from './types.js';
+export { expectationMismatch, runTestSuites, selectCases, type CaseEvaluator, type CaseResult, type CaseVerdict, type EvaluateResult, type RunOptions, type SpecOutcome, type TestRunReport, } from './runner.js';
+export { outcomeFromSpecResult } from './outcome.js';
+export { junitXml } from './junit.js';
+export { testSuitesView, type TestCaseRow, type TestSuiteRow, type TestSuitesView } from './view.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC"}