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

package/dist/bsdd/uri-health.d.ts

@@ -0,0 +1,65 @@
+/**
+ * URI health (05-bsdd.md §2.4, IDS-073). A background check resolves the
+ * bSDD URIs of a document, rate-limited and cached for 24 h, into a
+ * `BsddUriIndex`. The lint rules IDSL-BSDD-001…003 and the gate rule
+ * GATE-BSDD-001 read that index synchronously: they never call bSDD
+ * themselves, and a URI not checked yet produces no finding.
+ */
+import type { StudioDocument } from '../document/types.js';
+import type { Uuid } from '../uuid.js';
+import { type BsddSource, type BsddUriRecord } from './types.js';
+export declare const URI_HEALTH_TTL_MS: number;
+/** The checked URIs. `revision` changes on every write, so caches keyed on it go stale correctly. */
+export interface BsddUriIndex {
+    readonly revision: number;
+    get(uri: string): BsddUriRecord | undefined;
+    put(record: BsddUriRecord): void;
+    records(): BsddUriRecord[];
+}
+export declare function createBsddUriIndex(initial?: readonly BsddUriRecord[]): BsddUriIndex;
+/** Whether a URI has the bSDD identifier shape (`…/uri/<org>/<dictionary>/<version>/class|prop/…`). */
+export declare function isBsddUri(uri: string): boolean;
+export interface DocUri {
+    uri: string;
+    facetId: Uuid;
+    specId: Uuid;
+    facetType: 'property' | 'classification' | 'material';
+}
+/** Every bSDD URI on the document's facets, in document order. */
+export declare function collectDocUris(doc: StudioDocument): DocUri[];
+export interface UriHealthOptions {
+    source: BsddSource;
+    index: BsddUriIndex;
+    now?: () => number;
+    /** A record younger than this is not checked again. Default 24 h. */
+    ttlMs?: number;
+    /** Pause between two requests. Default 200 ms. */
+    minIntervalMs?: number;
+    /** At most this many requests per run. Default 200. */
+    maxChecks?: number;
+    sleep?: (ms: number) => Promise<void>;
+    signal?: AbortSignal;
+}
+export interface UriHealthReport {
+    /** URIs resolved in this run. */
+    checked: string[];
+    /** URIs skipped because their record is fresh. */
+    fresh: string[];
+    /** URIs bSDD answered with an unexpected HTTP error. */
+    failed: {
+        uri: string;
+        status: number;
+    }[];
+    /** URIs left for a later run (offline, rate-limited, aborted or over budget). */
+    deferred: string[];
+    /** Why the run stopped early, if it did. */
+    stopped?: 'offline' | 'rateLimited' | 'aborted' | 'budget';
+    retryAfterSeconds?: number;
+}
+/**
+ * Resolve the stale or unknown `uris` one at a time, pausing between
+ * requests. An offline or rate-limited answer stops the run (the rest are
+ * deferred, nothing is recorded for them) rather than hammering bSDD.
+ */
+export declare function checkUriHealth(uris: readonly string[], options: UriHealthOptions): Promise<UriHealthReport>;
+//# sourceMappingURL=uri-health.d.ts.map

package/dist/bsdd/uri-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-health.d.ts","sourceRoot":"","sources":["../../src/bsdd/uri-health.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAuC,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtG,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AAErD,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,SAAS,aAAa,EAAO,GAAG,YAAY,CAcvF;AAED,uGAAuG;AACvG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,UAAU,GAAG,gBAAgB,GAAG,UAAU,CAAC;CACvD;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAc5D;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,iFAAiF;IACjF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmDjH"}

package/dist/bsdd/uri-health.js

@@ -0,0 +1,110 @@
+/* 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 { dictionaryUriOf } from './contract.js';
+import { BsddHttpError, BsddUnavailableError } from './types.js';
+export const URI_HEALTH_TTL_MS = 24 * 60 * 60 * 1000;
+export function createBsddUriIndex(initial = []) {
+    const map = new Map(initial.map((r) => [r.uri, r]));
+    let revision = 0;
+    return {
+        get revision() {
+            return revision;
+        },
+        get: (uri) => map.get(uri),
+        put(record) {
+            map.set(record.uri, record);
+            revision++;
+        },
+        records: () => [...map.values()],
+    };
+}
+/** Whether a URI has the bSDD identifier shape (`…/uri/<org>/<dictionary>/<version>/class|prop/…`). */
+export function isBsddUri(uri) {
+    return dictionaryUriOf(uri) !== undefined;
+}
+/** Every bSDD URI on the document's facets, in document order. */
+export function collectDocUris(doc) {
+    const out = [];
+    doc.ids.specifications.forEach((spec, i) => {
+        const nodes = doc.nodes.specs[i];
+        const facets = [
+            ...spec.applicability.facets.map((facet, j) => ({ facet, facetId: nodes.applicability[j].id })),
+            ...spec.requirements.map((r) => ({ facet: r.facet, facetId: r.id })),
+        ];
+        for (const { facet, facetId } of facets) {
+            if (facet.type !== 'property' && facet.type !== 'classification' && facet.type !== 'material')
+                continue;
+            if (facet.uri && isBsddUri(facet.uri))
+                out.push({ uri: facet.uri, facetId, specId: spec.id, facetType: facet.type });
+        }
+    });
+    return out;
+}
+const sleeper = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function isOffline(err) {
+    return err instanceof BsddUnavailableError || err instanceof TypeError || (err instanceof Error && err.name === 'AbortError');
+}
+/**
+ * Resolve the stale or unknown `uris` one at a time, pausing between
+ * requests. An offline or rate-limited answer stops the run (the rest are
+ * deferred, nothing is recorded for them) rather than hammering bSDD.
+ */
+export async function checkUriHealth(uris, options) {
+    const now = options.now ?? Date.now;
+    const ttl = options.ttlMs ?? URI_HEALTH_TTL_MS;
+    const interval = options.minIntervalMs ?? 200;
+    const budget = options.maxChecks ?? 200;
+    const sleep = options.sleep ?? sleeper;
+    const report = { checked: [], fresh: [], failed: [], deferred: [] };
+    const todo = [];
+    for (const uri of new Set(uris)) {
+        const known = options.index.get(uri);
+        if (known && now() - known.checkedAt < ttl)
+            report.fresh.push(uri);
+        else
+            todo.push(uri);
+    }
+    let requests = 0;
+    for (let i = 0; i < todo.length; i++) {
+        const uri = todo[i];
+        const stop = (reason) => {
+            report.stopped = reason;
+            report.deferred.push(...todo.slice(i));
+        };
+        if (options.signal?.aborted) {
+            stop('aborted');
+            break;
+        }
+        if (requests >= budget) {
+            stop('budget');
+            break;
+        }
+        if (requests > 0 && interval > 0)
+            await sleep(interval);
+        requests++;
+        try {
+            options.index.put(await options.source.resolveUri(uri));
+            report.checked.push(uri);
+        }
+        catch (err) {
+            if (err instanceof BsddHttpError && err.status === 429) {
+                stop('rateLimited');
+                if (err.retryAfterSeconds !== undefined)
+                    report.retryAfterSeconds = err.retryAfterSeconds;
+                break;
+            }
+            if (err instanceof BsddHttpError) {
+                report.failed.push({ uri, status: err.status });
+                continue;
+            }
+            if (isOffline(err)) {
+                stop('offline');
+                break;
+            }
+            throw err;
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=uri-health.js.map

package/dist/bsdd/uri-health.js.map

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

package/dist/canonical-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical JSON: object keys sorted by code unit, `undefined` members
+ * dropped, no whitespace. Two values with the same content always give the
+ * same string, so it is safe to hash (fingerprints, revision hashes).
+ */
+export declare function canonicalJson(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../src/canonical-json.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASpD"}

package/dist/canonical-json.js

@@ -0,0 +1,20 @@
+/* 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/. */
+/**
+ * Canonical JSON: object keys sorted by code unit, `undefined` members
+ * dropped, no whitespace. Two values with the same content always give the
+ * same string, so it is safe to hash (fingerprints, revision hashes).
+ */
+export function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../src/canonical-json.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9F,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/comments/view.d.ts

@@ -0,0 +1,37 @@
+import type { StudioDocument } from '../document/types.js';
+import type { Uuid } from '../uuid.js';
+export interface CommentAnchor {
+    kind: 'document' | 'spec' | 'applicabilityFacet' | 'requirement' | 'constraint' | 'missing';
+    specName?: string;
+    /** Short facet handle ("FireRating (Pset_DoorCommon)"). */
+    facet?: string;
+    field?: string;
+}
+export interface CommentView {
+    author: string;
+    at: string;
+    text: string;
+    mentions: string[];
+}
+export interface CommentThreadView {
+    threadId: Uuid;
+    nodeId: Uuid;
+    anchor: CommentAnchor;
+    /** The node no longer exists (thread kept for the record). */
+    orphan: boolean;
+    resolved: boolean;
+    comments: CommentView[];
+    participants: string[];
+}
+export interface CommentsView {
+    threads: CommentThreadView[];
+    unresolved: number;
+    /** Unresolved thread count per node id (for badges in an outline). */
+    badges: Record<Uuid, number>;
+}
+/** Names mentioned in `text`, in order, without duplicates. */
+export declare function extractMentions(text: string): string[];
+export declare function commentThreads(doc: StudioDocument, options?: {
+    includeResolved?: boolean;
+}): CommentsView;
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/comments/view.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,oBAAoB,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CAC9B;AAID,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOtD;AAaD,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,YAAY,CAqB7G"}

package/dist/comments/view.js

@@ -0,0 +1,61 @@
+/* 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/. */
+/**
+ * Framework-free view model of the comment threads in the sidecar
+ * (FR-G07): where each thread is anchored, whether its node still exists,
+ * who takes part and whom it mentions. Mentions are names (`@Ana`,
+ * `@"Ana Lima"`); e-mail addresses are never treated as mentions.
+ */
+import { facetLabel } from '../diff/changelog.js';
+import { facetAt, locateNode } from '../document/node-index.js';
+const MENTION = /(?:^|[\s(,;])@(?:"([^"]+)"|([\p{L}\p{N}][\p{L}\p{N}._-]*))/gu;
+/** Names mentioned in `text`, in order, without duplicates. */
+export function extractMentions(text) {
+    const out = [];
+    for (const m of text.matchAll(MENTION)) {
+        const name = (m[1] ?? m[2] ?? '').replace(/[._-]+$/, '');
+        if (name && !out.includes(name))
+            out.push(name);
+    }
+    return out;
+}
+function anchorOf(doc, nodeId) {
+    const loc = locateNode(doc, nodeId);
+    if (!loc)
+        return { kind: 'missing' };
+    if (loc.kind === 'document')
+        return { kind: 'document' };
+    const specName = doc.ids.specifications[loc.specIndex].name;
+    if (loc.kind === 'spec')
+        return { kind: 'spec', specName };
+    const facet = facetLabel(facetAt(doc, loc));
+    if (loc.kind === 'constraint')
+        return { kind: 'constraint', specName, facet, field: loc.field };
+    return { kind: loc.kind, specName, facet };
+}
+export function commentThreads(doc, options = {}) {
+    const threads = [];
+    const badges = {};
+    for (const [nodeId, list] of Object.entries(doc.meta.comments)) {
+        const anchor = anchorOf(doc, nodeId);
+        for (const thread of list) {
+            if (!thread.resolved)
+                badges[nodeId] = (badges[nodeId] ?? 0) + 1;
+            if (thread.resolved && !options.includeResolved)
+                continue;
+            threads.push({
+                threadId: thread.id,
+                nodeId,
+                anchor,
+                orphan: anchor.kind === 'missing',
+                resolved: thread.resolved,
+                comments: thread.comments.map((c) => ({ ...c, mentions: extractMentions(c.text) })),
+                participants: [...new Set(thread.comments.map((c) => c.author))],
+            });
+        }
+    }
+    threads.sort((a, b) => (a.comments[0]?.at ?? '').localeCompare(b.comments[0]?.at ?? ''));
+    return { threads, unresolved: Object.values(badges).reduce((n, k) => n + k, 0), badges };
+}
+//# sourceMappingURL=view.js.map

package/dist/comments/view.js.map

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

package/dist/compound/expand.d.ts

@@ -0,0 +1,5 @@
+import type { StudioDocument } from '../document/types.js';
+import type { CompoundOp, PrimitiveOp } from '../ops/types.js';
+/** Expand a compound op into primitives against `doc`. */
+export declare function expandCompound(doc: StudioDocument, op: CompoundOp): PrimitiveOp[];
+//# sourceMappingURL=expand.d.ts.map

package/dist/compound/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/compound/expand.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAIV,UAAU,EACV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAsHzB,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,GAAG,WAAW,EAAE,CAWjF"}

package/dist/compound/expand.js

@@ -0,0 +1,135 @@
+/* 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 { getField } from '../document/fields.js';
+import { validateOp } from '../ops/schema.js';
+import { OpApplyError } from '../reducer/edit.js';
+import { expandFromBsddClass } from './from-bsdd.js';
+import { deriveId } from '../uuid.js';
+function visitFacets(doc, scope) {
+    const allowed = scope ? new Set(scope) : undefined;
+    const out = [];
+    doc.ids.specifications.forEach((spec, i) => {
+        if (allowed && !allowed.has(spec.id))
+            return;
+        const nodes = doc.nodes.specs[i];
+        spec.applicability.facets.forEach((facet, j) => out.push({ facetId: nodes.applicability[j].id, facet }));
+        spec.requirements.forEach((r) => out.push({ facetId: r.id, facet: r.facet }));
+    });
+    return out;
+}
+function literal(c) {
+    return c?.type === 'simpleValue' ? c.value : undefined;
+}
+class Emitter {
+    parent;
+    ops = [];
+    constructor(parent) {
+        this.parent = parent;
+    }
+    setField(facetId, field, constraint) {
+        this.ops.push({
+            kind: 'facet.setField',
+            opId: deriveId(this.parent.opId, `x:${this.ops.length}`),
+            payload: { facetId, field, value: { kind: 'raw', constraint } },
+        });
+    }
+}
+function expandRenameProperty(doc, op) {
+    const { fromPset, fromName, toPset, toName, scope } = op.payload;
+    const out = new Emitter(op);
+    for (const { facetId, facet } of visitFacets(doc, scope)) {
+        if (facet.type !== 'property')
+            continue;
+        if (literal(facet.propertySet) !== fromPset || literal(facet.baseName) !== fromName)
+            continue;
+        if (toPset !== fromPset)
+            out.setField(facetId, 'property.propertySet', { type: 'simpleValue', value: toPset });
+        if (toName !== fromName)
+            out.setField(facetId, 'property.baseName', { type: 'simpleValue', value: toName });
+    }
+    return out.ops;
+}
+/** Replace `from` (case-insensitive) in a literal or enumeration entity-name constraint. */
+function retarget(c, from, to) {
+    const fromUpper = from.toUpperCase();
+    const toUpper = to.toUpperCase();
+    if (c?.type === 'simpleValue' && c.value.toUpperCase() === fromUpper)
+        return { type: 'simpleValue', value: toUpper };
+    if (c?.type === 'enumeration' && c.values.some((v) => v.toUpperCase() === fromUpper)) {
+        const values = [...new Set(c.values.map((v) => (v.toUpperCase() === fromUpper ? toUpper : v)))];
+        return { ...c, values };
+    }
+    return undefined;
+}
+function expandRetargetEntity(doc, op) {
+    const { from, to, scope } = op.payload;
+    const out = new Emitter(op);
+    for (const { facetId, facet } of visitFacets(doc, scope)) {
+        const field = facet.type === 'entity' ? 'entity.name' : facet.type === 'partOf' ? 'partOf.entity.name' : undefined;
+        if (!field)
+            continue;
+        const next = retarget(getField(facet, field), from, to);
+        if (next)
+            out.setField(facetId, field, next);
+    }
+    return out.ops;
+}
+const PLACEHOLDER = /\{\{\s*(id:)?([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+function substitute(value, fill) {
+    if (typeof value === 'string')
+        return value.replace(PLACEHOLDER, (_m, id, name) => fill(!!id, name));
+    if (Array.isArray(value))
+        return value.map((v) => substitute(v, fill));
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, substitute(v, fill)]));
+    }
+    return value;
+}
+function expandApplyTemplate(op) {
+    const { template, params } = op.payload;
+    const declared = new Map(template.params.map((p) => [p.name, p]));
+    for (const name of Object.keys(params)) {
+        if (!declared.has(name))
+            throw new OpApplyError('GATE-OP-002', `template ${template.id} has no parameter "${name}"`);
+    }
+    const fill = (isId, name) => {
+        if (isId)
+            return deriveId(op.opId, `tpl:${name}`);
+        const value = params[name] ?? declared.get(name)?.default;
+        if (value === undefined) {
+            throw new OpApplyError('GATE-OP-002', `template ${template.id} needs parameter "${name}"`);
+        }
+        return value;
+    };
+    return template.ops.map((t, i) => {
+        const candidate = {
+            kind: t.kind,
+            opId: deriveId(op.opId, `t:${i}`),
+            payload: substitute(t.payload, fill),
+        };
+        const checked = validateOp(candidate);
+        if (!checked.ok) {
+            const first = checked.errors[0];
+            throw new OpApplyError('GATE-OP-001', `template ${template.id} op ${i} (${t.kind}): ${first.path}: ${first.message}`);
+        }
+        if (checked.op.kind.startsWith('bulk.')) {
+            throw new OpApplyError('GATE-OP-001', `template ${template.id} op ${i}: templates cannot nest compound ops`);
+        }
+        return checked.op;
+    });
+}
+/** Expand a compound op into primitives against `doc`. */
+export function expandCompound(doc, op) {
+    switch (op.kind) {
+        case 'bulk.renameProperty':
+            return expandRenameProperty(doc, op);
+        case 'bulk.retargetEntity':
+            return expandRetargetEntity(doc, op);
+        case 'bulk.applyTemplate':
+            return expandApplyTemplate(op);
+        case 'bulk.fromBsddClass':
+            return expandFromBsddClass(doc, op);
+    }
+}
+//# sourceMappingURL=expand.js.map

package/dist/compound/expand.js.map

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

package/dist/compound/from-bsdd.d.ts

@@ -0,0 +1,9 @@
+import type { StudioDocument } from '../document/types.js';
+import type { BulkFromBsddClassOp, ConstraintDraft, PrimitiveOp } from '../ops/types.js';
+import { type Uuid } from '../uuid.js';
+/** `equals` for one value, `oneOf` for several. */
+export declare function oneOrMany(values: readonly string[]): ConstraintDraft;
+/** Ids of the facets `bulk.fromBsddClass` creates, derived from its op id. */
+export declare function bsddFacetId(opId: Uuid, role: string): Uuid;
+export declare function expandFromBsddClass(doc: StudioDocument, op: BulkFromBsddClassOp): PrimitiveOp[];
+//# sourceMappingURL=from-bsdd.d.ts.map

package/dist/compound/from-bsdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-bsdd.d.ts","sourceRoot":"","sources":["../../src/compound/from-bsdd.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAA2C,mBAAmB,EAAE,eAAe,EAAc,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9I,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEjD,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAEpE;AAuCD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1D;AAmFD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAc/F"}