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

package/dist/bsdd/contract.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Readers from the raw bSDD API v1 JSON (the public "Dictionaries" API
+ * contracts: DictionaryContractV1, ClassContractV1, ClassPropertyContractV1,
+ * ClassSearchResponseContractV1, PropertyContract) into the normalised
+ * shapes of `./types.ts`. Input is untrusted: every field is checked, an
+ * unexpected shape degrades to "absent", never to a throw or a cast.
+ */
+import type { BsddAllowedValue, BsddClass, BsddClassProperty, BsddClassSummary, BsddDictionary, BsddSearchPage, BsddStatus } from './types.js';
+export type Json = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is Json;
+export declare function str(o: Json, key: string): string | undefined;
+export declare function readStatus(raw: unknown): BsddStatus;
+export declare function readDictionary(o: Json): BsddDictionary | undefined;
+export declare function readDictionaries(o: unknown): BsddDictionary[];
+export declare function readAllowedValues(o: Json): BsddAllowedValue[] | undefined;
+export declare function readClassProperty(o: Json): BsddClassProperty | undefined;
+/** The dictionary URI of a bSDD class/property URI (`…/uri/<org>/<dict>/<version>`). */
+export declare function dictionaryUriOf(uri: string): string | undefined;
+export declare function readClass(o: unknown): BsddClass | undefined;
+export declare function readClassSummary(o: Json, dictionary?: {
+    uri: string;
+    name?: string;
+}): BsddClassSummary | undefined;
+/** One page of `Dictionary/v1/Classes`: its rows and the server's total. */
+export declare function readDictionaryClasses(o: unknown): {
+    classes: BsddClassSummary[];
+    total: number;
+    name?: string;
+};
+export declare function readSearchPage(o: unknown, offset: number): BsddSearchPage;
+//# sourceMappingURL=contract.d.ts.map

package/dist/bsdd/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/bsdd/contract.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EAEjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEtD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5D;AA+BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAInD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,GAAG,cAAc,GAAG,SAAS,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,EAAE,CAK7D;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,gBAAgB,EAAE,GAAG,SAAS,CAKzE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAwBxE;AAQD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAwB3D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,GAAG,SAAS,CAgBnH;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAO/G;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAMzE"}

package/dist/bsdd/contract.js

@@ -0,0 +1,185 @@
+/* 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 function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function str(o, key) {
+    const v = o[key];
+    return typeof v === 'string' && v.trim() !== '' ? v : undefined;
+}
+function num(o, key) {
+    const v = o[key];
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '' && Number.isFinite(Number(v)))
+        return Number(v);
+    return undefined;
+}
+function bool(o, key) {
+    const v = o[key];
+    return typeof v === 'boolean' ? v : undefined;
+}
+function records(o, key) {
+    const v = o[key];
+    return Array.isArray(v) ? v.filter(isRecord) : [];
+}
+function strings(o, key) {
+    const v = o[key];
+    return Array.isArray(v) ? v.filter((x) => typeof x === 'string' && x.trim() !== '') : [];
+}
+/** Copy of `o` without the keys whose value is undefined. */
+function compact(o) {
+    const out = { ...o };
+    for (const k of Object.keys(out))
+        if (out[k] === undefined)
+            delete out[k];
+    return out;
+}
+export function readStatus(raw) {
+    if (typeof raw !== 'string')
+        return 'unknown';
+    const s = raw.trim().toLowerCase();
+    return s === 'active' || s === 'preview' || s === 'inactive' ? s : 'unknown';
+}
+export function readDictionary(o) {
+    const uri = str(o, 'uri');
+    const name = str(o, 'name');
+    if (!uri || !name)
+        return undefined;
+    return compact({
+        uri,
+        name,
+        version: str(o, 'version') ?? '',
+        code: str(o, 'code'),
+        organizationCode: str(o, 'organizationCodeOwner'),
+        organizationName: str(o, 'organizationNameOwner'),
+        languageCode: str(o, 'defaultLanguageCode'),
+        status: readStatus(o.status),
+        license: str(o, 'license'),
+        licenseUrl: str(o, 'licenseUrl'),
+        isLatestVersion: bool(o, 'isLatestVersion'),
+        isVerified: bool(o, 'isVerified'),
+        releaseDate: str(o, 'releaseDate'),
+    });
+}
+export function readDictionaries(o) {
+    if (!isRecord(o))
+        return [];
+    return records(o, 'dictionaries')
+        .map(readDictionary)
+        .filter((d) => !!d);
+}
+function readAllowedValue(o) {
+    const code = str(o, 'code') ?? str(o, 'value');
+    if (!code)
+        return undefined;
+    return compact({ code, value: str(o, 'value') ?? code, uri: str(o, 'uri'), description: str(o, 'description') });
+}
+export function readAllowedValues(o) {
+    const list = records(o, 'allowedValues')
+        .map(readAllowedValue)
+        .filter((v) => !!v);
+    return list.length ? list : undefined;
+}
+export function readClassProperty(o) {
+    const code = str(o, 'propertyCode') ?? str(o, 'code') ?? str(o, 'name');
+    if (!code)
+        return undefined;
+    const units = strings(o, 'units');
+    return compact({
+        code,
+        name: str(o, 'name') ?? code,
+        uri: str(o, 'propertyUri') ?? str(o, 'uri'),
+        propertySet: str(o, 'propertySet'),
+        dataType: str(o, 'dataType'),
+        propertyValueKind: str(o, 'propertyValueKind'),
+        dimension: str(o, 'dimension'),
+        physicalQuantity: str(o, 'physicalQuantity'),
+        units: units.length ? units : undefined,
+        allowedValues: readAllowedValues(o),
+        minInclusive: num(o, 'minInclusive'),
+        maxInclusive: num(o, 'maxInclusive'),
+        minExclusive: num(o, 'minExclusive'),
+        maxExclusive: num(o, 'maxExclusive'),
+        pattern: str(o, 'pattern'),
+        isRequired: bool(o, 'isRequired'),
+        description: str(o, 'definition') ?? str(o, 'description'),
+        status: o.propertyStatus === undefined ? undefined : readStatus(o.propertyStatus),
+    });
+}
+function readRef(o) {
+    if (!isRecord(o))
+        return undefined;
+    const uri = str(o, 'uri');
+    return uri ? compact({ uri, code: str(o, 'code'), name: str(o, 'name') }) : undefined;
+}
+/** The dictionary URI of a bSDD class/property URI (`…/uri/<org>/<dict>/<version>`). */
+export function dictionaryUriOf(uri) {
+    const m = /^(https?:\/\/[^/]+\/uri\/[^/]+\/[^/]+\/[^/]+)\/(class|prop)\//i.exec(uri);
+    return m?.[1];
+}
+export function readClass(o) {
+    if (!isRecord(o))
+        return undefined;
+    const uri = str(o, 'uri');
+    const code = str(o, 'code') ?? str(o, 'name');
+    if (!uri || !code)
+        return undefined;
+    return compact({
+        uri,
+        code,
+        name: str(o, 'name') ?? code,
+        definition: str(o, 'definition') ?? str(o, 'description'),
+        status: readStatus(o.status),
+        classType: str(o, 'classType'),
+        dictionaryUri: str(o, 'dictionaryUri') ?? dictionaryUriOf(uri) ?? '',
+        relatedIfcEntityNames: strings(o, 'relatedIfcEntityNames'),
+        parentClass: readRef(o.parentClassReference),
+        childClasses: records(o, 'childClassReferences')
+            .map(readRef)
+            .filter((r) => !!r),
+        properties: records(o, 'classProperties')
+            .map(readClassProperty)
+            .filter((p) => !!p),
+        replacingObjectCodes: strings(o, 'replacingObjectCodes'),
+        synonyms: strings(o, 'synonyms'),
+    });
+}
+export function readClassSummary(o, dictionary) {
+    const uri = str(o, 'uri');
+    const code = str(o, 'code') ?? str(o, 'name');
+    if (!uri || !code)
+        return undefined;
+    return compact({
+        uri,
+        code,
+        name: str(o, 'name') ?? code,
+        definition: str(o, 'definition'),
+        dictionaryUri: str(o, 'dictionaryUri') ?? dictionary?.uri ?? dictionaryUriOf(uri) ?? '',
+        dictionaryName: str(o, 'dictionaryName') ?? dictionary?.name,
+        relatedIfcEntityNames: strings(o, 'relatedIfcEntityNames'),
+        parentClassCode: str(o, 'parentClassCode'),
+        classType: str(o, 'classType'),
+        status: o.status === undefined ? undefined : readStatus(o.status),
+    });
+}
+/** One page of `Dictionary/v1/Classes`: its rows and the server's total. */
+export function readDictionaryClasses(o) {
+    if (!isRecord(o))
+        return { classes: [], total: 0 };
+    const dict = { uri: str(o, 'uri') ?? '', name: str(o, 'name') };
+    const classes = records(o, 'classes')
+        .map((c) => readClassSummary(c, dict))
+        .filter((c) => !!c);
+    return compact({ classes, total: num(o, 'classesTotalCount') ?? classes.length, name: dict.name });
+}
+export function readSearchPage(o, offset) {
+    if (!isRecord(o))
+        return { classes: [], total: 0, offset };
+    const classes = records(o, 'classes')
+        .map((c) => readClassSummary(c))
+        .filter((c) => !!c);
+    return { classes, total: num(o, 'totalCount') ?? classes.length, offset };
+}
+//# sourceMappingURL=contract.js.map

package/dist/bsdd/contract.js.map

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

package/dist/bsdd/dictionary.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A bSDD dictionary as a class tree, and the class hierarchy resolved for
+ * property inheritance (05-bsdd.md §2.3, IDS-072). Parent links come from
+ * the server, so every walk here is iterative with a visited set and a
+ * work budget: a cyclic or absurdly deep hierarchy ends, it does not hang.
+ */
+import type { BsddClass, BsddClassProperty, BsddClassSummary, BsddSource } from './types.js';
+export interface BsddClassTreeNode {
+    uri: string;
+    code: string;
+    name: string;
+    depth: number;
+    children: BsddClassTreeNode[];
+}
+/**
+ * The parent/child tree of a dictionary's flat class list. A class whose
+ * parent is missing (or that sits on a parent cycle) becomes a root.
+ */
+export declare function buildClassTree(rows: readonly BsddClassSummary[]): BsddClassTreeNode[];
+/** Default bound on classes fetched for one generator run. */
+export declare const MAX_CLASSES = 2000;
+/**
+ * Fetch the selected classes and every ancestor (for inherited
+ * properties). Classes bSDD does not know are reported, not thrown.
+ */
+export declare function loadClassesWithAncestors(source: BsddSource, uris: readonly string[], options?: {
+    maxClasses?: number;
+    languageCode?: string;
+}): Promise<{
+    classes: Map<string, BsddClass>;
+    missing: string[];
+    truncated: boolean;
+}>;
+/** The class's ancestors, nearest first (cycle-safe). */
+export declare function ancestors(cls: BsddClass, classes: ReadonlyMap<string, BsddClass>): BsddClass[];
+/**
+ * Own plus inherited properties. A property the class redefines (same set
+ * and code) overrides the ancestor's definition; inherited properties come
+ * first, in root-to-leaf order, so a family of classes lists them alike.
+ */
+export declare function effectiveProperties(cls: BsddClass, classes: ReadonlyMap<string, BsddClass>): BsddClassProperty[];
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/bsdd/dictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.d.ts","sourceRoot":"","sources":["../../src/bsdd/dictionary.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,GAAG,iBAAiB,EAAE,CA6BrF;AAcD,8DAA8D;AAC9D,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CA0BrF;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,EAAE,CAU9F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,iBAAiB,EAAE,CAQhH"}

package/dist/bsdd/dictionary.js

@@ -0,0 +1,115 @@
+/* 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 parent/child tree of a dictionary's flat class list. A class whose
+ * parent is missing (or that sits on a parent cycle) becomes a root.
+ */
+export function buildClassTree(rows) {
+    const byCode = new Map();
+    for (const r of rows)
+        if (!byCode.has(r.code))
+            byCode.set(r.code, r);
+    const childrenOf = new Map();
+    const roots = [];
+    for (const r of byCode.values()) {
+        const parent = r.parentClassCode;
+        if (parent && parent !== r.code && byCode.has(parent) && !onCycle(r.code, byCode)) {
+            const list = childrenOf.get(parent) ?? [];
+            list.push(r);
+            childrenOf.set(parent, list);
+        }
+        else {
+            roots.push(r);
+        }
+    }
+    const out = [];
+    const stack = roots.map((row) => ({ row, depth: 0, into: out }));
+    stack.reverse();
+    const placed = new Set();
+    while (stack.length) {
+        const { row, depth, into } = stack.pop();
+        if (placed.has(row.code))
+            continue;
+        placed.add(row.code);
+        const node = { uri: row.uri, code: row.code, name: row.name, depth, children: [] };
+        into.push(node);
+        const kids = childrenOf.get(row.code) ?? [];
+        for (let i = kids.length - 1; i >= 0; i--)
+            stack.push({ row: kids[i], depth: depth + 1, into: node.children });
+    }
+    return out;
+}
+/** Whether following parent codes from `code` comes back to it. */
+function onCycle(code, byCode) {
+    const seen = new Set([code]);
+    let cursor = byCode.get(code)?.parentClassCode;
+    while (cursor && byCode.has(cursor)) {
+        if (seen.has(cursor))
+            return cursor === code;
+        seen.add(cursor);
+        cursor = byCode.get(cursor)?.parentClassCode;
+    }
+    return false;
+}
+/** Default bound on classes fetched for one generator run. */
+export const MAX_CLASSES = 2000;
+/**
+ * Fetch the selected classes and every ancestor (for inherited
+ * properties). Classes bSDD does not know are reported, not thrown.
+ */
+export async function loadClassesWithAncestors(source, uris, options = {}) {
+    const max = options.maxClasses ?? MAX_CLASSES;
+    const classes = new Map();
+    const missing = [];
+    const queue = [...new Set(uris)];
+    const queued = new Set(queue);
+    let truncated = false;
+    while (queue.length) {
+        if (classes.size + missing.length >= max) {
+            truncated = true;
+            break;
+        }
+        const uri = queue.shift();
+        const cls = await source.getClass(uri, options.languageCode ? { languageCode: options.languageCode } : {});
+        if (!cls) {
+            missing.push(uri);
+            continue;
+        }
+        classes.set(uri, cls);
+        const parent = cls.parentClass?.uri;
+        if (parent && !queued.has(parent)) {
+            queued.add(parent);
+            queue.push(parent);
+        }
+    }
+    return { classes, missing, truncated };
+}
+/** The class's ancestors, nearest first (cycle-safe). */
+export function ancestors(cls, classes) {
+    const out = [];
+    const seen = new Set([cls.uri]);
+    let cursor = cls.parentClass ? classes.get(cls.parentClass.uri) : undefined;
+    while (cursor && !seen.has(cursor.uri)) {
+        out.push(cursor);
+        seen.add(cursor.uri);
+        cursor = cursor.parentClass ? classes.get(cursor.parentClass.uri) : undefined;
+    }
+    return out;
+}
+/**
+ * Own plus inherited properties. A property the class redefines (same set
+ * and code) overrides the ancestor's definition; inherited properties come
+ * first, in root-to-leaf order, so a family of classes lists them alike.
+ */
+export function effectiveProperties(cls, classes) {
+    const chain = [...ancestors(cls, classes)].reverse();
+    chain.push(cls);
+    const byKey = new Map();
+    for (const c of chain) {
+        for (const p of c.properties)
+            byKey.set(`${p.propertySet ?? ''}\u0000${p.code}`, p);
+    }
+    return [...byKey.values()];
+}
+//# sourceMappingURL=dictionary.js.map

package/dist/bsdd/dictionary.js.map

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

package/dist/bsdd/generator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Dictionary → IDS (05-bsdd.md §2.3, IDS-072). Selected classes of one
+ * dictionary become specifications: one per class, or one per related IFC
+ * entity with a classification enumeration. Properties come from the class
+ * and, optionally, its ancestors in the bSDD hierarchy; scope is the
+ * required properties only or all of them.
+ *
+ * `planDictionaryIds` is pure and returns `bulk.fromBsddClass` ops; the host
+ * previews them (`previewDictionaryIds`: gate, counts, lint summary on a
+ * dry run) and commits them as ONE history transaction, so one undo
+ * removes the whole import.
+ */
+import type { IFCVersion } from '@ifc-lite/ids';
+import type { Section, StudioDocument } from '../document/types.js';
+import type { GateContext } from '../gate/context.js';
+import type { GateResult } from '../gate/types.js';
+import type { LintContext, LintSeverity } from '../lint/types.js';
+import type { BulkFromBsddClassOp, SpecCardinality } from '../ops/types.js';
+import { type Uuid } from '../uuid.js';
+import type { BsddClass, BsddDictionary } from './types.js';
+export interface DictionaryIdsOptions {
+    ifcVersions: IFCVersion[];
+    /** `perClass`: one spec per class. `perEntity`: one spec per related IFC entity, classes as an enumeration. */
+    grouping?: 'perClass' | 'perEntity';
+    /** Include properties inherited from parent classes. Default true. */
+    inheritProperties?: boolean;
+    /** `required`: only properties bSDD marks required. Default `all`. */
+    propertyScope?: 'required' | 'all';
+    /**
+     * Cardinality of each generated specification. Default `optional`: the
+     * requirements apply to the classified elements a model has, without
+     * demanding that every class occurs (lint IDSL-CARD-004 flags the latter).
+     */
+    cardinality?: SpecCardinality;
+    /** Where the classification facet goes. Default `applicability`. */
+    classificationSection?: Section;
+    /** Property set for properties without one; without it they are skipped (and noted). */
+    fallbackPropertySet?: string;
+    /** Generate classes bSDD marks inactive too. Default false (they are skipped, and noted). */
+    includeInactive?: boolean;
+}
+export interface PlannedSpec {
+    specId: Uuid;
+    name: string;
+    classCodes: string[];
+    entities: string[];
+    properties: string[];
+}
+export interface DictionaryIdsPlan {
+    ops: BulkFromBsddClassOp[];
+    specs: PlannedSpec[];
+    /** What was left out and why. */
+    notes: string[];
+}
+export interface DictionaryIdsInput {
+    dictionary: BsddDictionary;
+    /** Classes by URI: the selection and (for inheritance) their ancestors. */
+    classes: ReadonlyMap<string, BsddClass>;
+    /** URIs of the classes to generate, in the order wanted. */
+    selected: readonly string[];
+    options: DictionaryIdsOptions;
+    /** Schema tables: split `IfcWallSOLIDWALL`-style names, drop entities unknown in the versions, keep standard data types. */
+    gate?: GateContext;
+    newId?: () => Uuid;
+}
+/** Plan the specifications for a dictionary selection. Pure. */
+export declare function planDictionaryIds(input: DictionaryIdsInput): DictionaryIdsPlan;
+export interface DictionaryIdsPreview {
+    specCount: number;
+    applicabilityFacets: number;
+    requirements: number;
+    gate: GateResult;
+    /** Lint findings of the document after the import, by severity and by code. */
+    lint: Record<LintSeverity, number> & {
+        byCode: Record<string, number>;
+    };
+    /** The document the plan produces (when the gate accepts it). */
+    result?: StudioDocument;
+}
+/** Dry-run the plan on `doc`: gate it, apply it to a copy, lint the result. */
+export declare function previewDictionaryIds(doc: StudioDocument, plan: DictionaryIdsPlan, lint: LintContext): DictionaryIdsPreview;
+//# sourceMappingURL=generator.d.ts.map

package/dist/bsdd/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bsdd/generator.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAqB,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/F,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAI/C,OAAO,KAAK,EAAE,SAAS,EAAqB,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACpC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,aAAa,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6FAA6F;IAC7F,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,mBAAmB,EAAE,CAAC;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,cAAc,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4HAA4H;IAC5H,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAUD,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,CAyE9E;AAiCD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACxE,iEAAiE;IACjE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,CAqB1H"}

package/dist/bsdd/generator.js

@@ -0,0 +1,155 @@
+/* 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 { checkOps } from '../gate/check.js';
+import { createLinter } from '../lint/engine.js';
+import { apply } from '../reducer/apply.js';
+import { uuidv7 } from '../uuid.js';
+import { effectiveProperties } from './dictionary.js';
+import { snapshotBsddClass } from './insert.js';
+import { BsddMappingError, mapBsddProperty } from './mapping.js';
+function entityKnown(gate, versions, name) {
+    return !gate || versions.every((v) => gate.tables[v].entities.has(name.toUpperCase()));
+}
+function scoped(props, scope) {
+    return scope === 'required' ? props.filter((p) => p.isRequired === true) : [...props];
+}
+/** Plan the specifications for a dictionary selection. Pure. */
+export function planDictionaryIds(input) {
+    const { dictionary, classes, options, gate } = input;
+    const versions = options.ifcVersions;
+    const newId = input.newId ?? uuidv7;
+    const notes = [];
+    const snapshots = [];
+    for (const uri of new Set(input.selected)) {
+        const cls = classes.get(uri);
+        if (!cls) {
+            notes.push(`${uri}: not loaded; skipped`);
+            continue;
+        }
+        if (cls.dictionaryUri && cls.dictionaryUri !== dictionary.uri) {
+            notes.push(`${cls.code}: belongs to another dictionary; skipped`);
+            continue;
+        }
+        if (cls.status === 'inactive' && !options.includeInactive) {
+            notes.push(`${cls.code}: inactive in bSDD; skipped`);
+            continue;
+        }
+        const all = options.inheritProperties === false ? cls.properties : effectiveProperties(cls, classes);
+        const snap = snapshotBsddClass(cls, { dictionaryName: dictionary.name, gate, versions, properties: scoped(all, options.propertyScope ?? 'all') });
+        snap.properties = (snap.properties ?? []).filter((p) => {
+            try {
+                mapBsddProperty(p, options.fallbackPropertySet ? { fallbackPropertySet: options.fallbackPropertySet } : {});
+                return true;
+            }
+            catch (err) {
+                if (!(err instanceof BsddMappingError))
+                    throw err;
+                notes.push(`${cls.code}.${p.code}: ${err.message}; skipped`);
+                return false;
+            }
+        });
+        const known = (snap.relatedIfcEntities ?? []).filter((r) => entityKnown(gate, versions, r.entity));
+        for (const r of snap.relatedIfcEntities ?? []) {
+            if (!known.includes(r))
+                notes.push(`${cls.code}: related entity ${r.entity} does not exist in ${versions.join(', ')}; left out`);
+        }
+        snapshots.push({ ...snap, relatedIfcEntities: known });
+    }
+    const groups = options.grouping === 'perEntity' ? groupByEntity(snapshots, notes) : snapshots.map((s) => ({ key: s.code, classes: [s], entity: undefined }));
+    const plan = { ops: [], specs: [], notes };
+    for (const g of groups) {
+        const specId = newId();
+        const first = g.classes[0];
+        const name = g.entity ? `${g.entity} (${dictionary.name})` : `${first.name} (${first.code})`;
+        const propCodes = commonProperties(g.classes, notes);
+        const entities = g.entity ? [g.entity] : [...new Set((first.relatedIfcEntities ?? []).map((r) => r.entity))];
+        const op = {
+            kind: 'bulk.fromBsddClass',
+            opId: newId(),
+            payload: {
+                classes: g.classes.map((c) => ({ ...c, properties: (c.properties ?? []).filter((p) => propCodes.includes(p.code)) })),
+                target: {
+                    newSpec: {
+                        specId,
+                        name,
+                        ifcVersions: versions,
+                        cardinality: options.cardinality ?? 'optional',
+                        ...(g.classes.length === 1 ? { identifier: first.code } : {}),
+                        ...(g.classes.length === 1 && classes.get(first.uri)?.definition ? { description: classes.get(first.uri)?.definition } : {}),
+                    },
+                },
+                classification: { section: options.classificationSection ?? 'applicability' },
+            },
+        };
+        if (entities.length)
+            op.payload.entity = { section: 'applicability', entities };
+        else
+            notes.push(`${g.classes.map((c) => c.code).join(', ')}: no known related IFC entity; the specification applies by classification only`);
+        if (propCodes.length) {
+            op.payload.properties = { select: propCodes, ...(options.fallbackPropertySet ? { fallbackPropertySet: options.fallbackPropertySet } : {}) };
+        }
+        plan.ops.push(op);
+        plan.specs.push({ specId, name, classCodes: g.classes.map((c) => c.code), entities, properties: propCodes });
+    }
+    return plan;
+}
+/** One group per related entity (a class's first related entity decides). */
+function groupByEntity(snapshots, notes) {
+    const groups = new Map();
+    for (const s of snapshots) {
+        const entity = s.relatedIfcEntities?.[0]?.entity;
+        if (!entity) {
+            notes.push(`${s.code}: no known related IFC entity; generated as its own specification`);
+            groups.set(`class:${s.code}`, { key: s.code, classes: [s] });
+            continue;
+        }
+        if ((s.relatedIfcEntities ?? []).some((r) => r.entity !== entity))
+            notes.push(`${s.code}: grouped under ${entity}, its first related entity`);
+        const g = groups.get(entity) ?? { key: entity, classes: [], entity };
+        g.classes.push({ ...s, relatedIfcEntities: [{ entity }] });
+        groups.set(entity, g);
+    }
+    return [...groups.values()];
+}
+/** Property codes defined (with the same set) on every class of a group. */
+function commonProperties(classes, notes) {
+    const [first, ...rest] = classes;
+    const out = [];
+    for (const p of first.properties ?? []) {
+        if (out.includes(p.code))
+            continue;
+        const everywhere = rest.every((c) => c.properties?.some((q) => q.code === p.code && q.propertySet === p.propertySet));
+        if (everywhere)
+            out.push(p.code);
+        else
+            notes.push(`${p.code}: not defined on every class of ${classes.map((c) => c.code).join(', ')}; left out of the shared specification`);
+    }
+    return out;
+}
+/** Dry-run the plan on `doc`: gate it, apply it to a copy, lint the result. */
+export function previewDictionaryIds(doc, plan, lint) {
+    const gate = checkOps(plan.ops, doc, lint.gate);
+    const byCode = {};
+    const counts = { error: 0, warning: 0, info: 0, byCode };
+    if (!gate.ok)
+        return { specCount: plan.specs.length, applicabilityFacets: 0, requirements: 0, gate, lint: counts };
+    const result = apply(doc, plan.ops).doc;
+    const created = new Set(plan.specs.map((s) => s.specId));
+    const specs = result.ids.specifications.filter((s) => created.has(s.id));
+    for (const d of createLinter(lint).lint(result).diagnostics) {
+        if (d.specId && !created.has(d.specId))
+            continue;
+        counts[d.severity]++;
+        counts.byCode[d.code] = (counts.byCode[d.code] ?? 0) + 1;
+    }
+    return {
+        specCount: specs.length,
+        applicabilityFacets: specs.reduce((n, s) => n + s.applicability.facets.length, 0),
+        requirements: specs.reduce((n, s) => n + s.requirements.length, 0),
+        gate,
+        lint: counts,
+        result,
+    };
+}
+//# sourceMappingURL=generator.js.map