@ifc-lite/collab 0.2.0

package/dist/doc/geometry.js

@@ -0,0 +1,99 @@
+/* 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/. */
+/**
+ * Geometry-reference operations on the Y.Doc.
+ *
+ * The Y.Doc only ever holds *references* to geometry (parametric params or
+ * mesh blob hashes), never raw mesh bytes. This keeps Y.Doc memory small
+ * and bounded — see spec §11 and §15.
+ */
+import * as Y from 'yjs';
+import { GEOMETRY_KEY, geometryMap } from './schema.js';
+export function getGeometry(doc, geomId) {
+    return geometryMap(doc).get(geomId);
+}
+export function createGeometry(doc, geomId, opts) {
+    const geom = geometryMap(doc);
+    const existing = geom.get(geomId);
+    if (existing)
+        return existing;
+    const node = new Y.Map();
+    node.set(GEOMETRY_KEY.TYPE, opts.type);
+    node.set(GEOMETRY_KEY.SOURCE, opts.source);
+    if (opts.blobHash)
+        node.set(GEOMETRY_KEY.BLOB_HASH, opts.blobHash);
+    const params = new Y.Map();
+    if (opts.params) {
+        for (const [k, v] of Object.entries(opts.params)) {
+            params.set(k, v);
+        }
+    }
+    node.set(GEOMETRY_KEY.PARAMS, params);
+    if (opts.bbox)
+        node.set(GEOMETRY_KEY.BBOX, opts.bbox);
+    // The version vector is a Y.Map<peerId, counter> so concurrent replaces
+    // become detectable conflicts (§9.4).
+    node.set(GEOMETRY_KEY.VERSION_VECTOR, new Y.Map());
+    geom.set(geomId, node);
+    return node;
+}
+export function setGeometryParam(doc, geomId, paramName, value) {
+    const node = getGeometry(doc, geomId);
+    if (!node)
+        throw new Error(`@ifc-lite/collab: geometry "${geomId}" not found`);
+    const params = node.get(GEOMETRY_KEY.PARAMS);
+    if (!params)
+        throw new Error(`@ifc-lite/collab: geometry "${geomId}" missing params map`);
+    params.set(paramName, value);
+}
+export function setGeometryBlobHash(doc, geomId, blobHash) {
+    const node = getGeometry(doc, geomId);
+    if (!node)
+        throw new Error(`@ifc-lite/collab: geometry "${geomId}" not found`);
+    node.set(GEOMETRY_KEY.BLOB_HASH, blobHash);
+}
+/**
+ * Bump the version vector for a peer when this peer replaces geometry. The
+ * conflict detector (`conflicts/detector.ts`) uses these vectors to
+ * identify concurrent replacements.
+ */
+export function bumpGeometryVersion(doc, geomId, peerId) {
+    const node = getGeometry(doc, geomId);
+    if (!node)
+        throw new Error(`@ifc-lite/collab: geometry "${geomId}" not found`);
+    const vv = node.get(GEOMETRY_KEY.VERSION_VECTOR);
+    if (!vv)
+        throw new Error(`@ifc-lite/collab: geometry "${geomId}" missing version vector`);
+    const key = String(peerId);
+    vv.set(key, (vv.get(key) ?? 0) + 1);
+}
+export function deleteGeometry(doc, geomId) {
+    const geom = geometryMap(doc);
+    if (!geom.has(geomId))
+        return false;
+    geom.delete(geomId);
+    return true;
+}
+/** Plain JSON snapshot of a geometry node (used by the IFCX writer). */
+export function geometryToJSON(node) {
+    const params = node.get(GEOMETRY_KEY.PARAMS);
+    const vv = node.get(GEOMETRY_KEY.VERSION_VECTOR);
+    const paramsJson = {};
+    if (params)
+        for (const [k, v] of params.entries())
+            paramsJson[k] = v;
+    const vvJson = {};
+    if (vv)
+        for (const [k, v] of vv.entries())
+            vvJson[k] = v;
+    return {
+        type: node.get(GEOMETRY_KEY.TYPE),
+        source: node.get(GEOMETRY_KEY.SOURCE),
+        params: paramsJson,
+        blobHash: node.get(GEOMETRY_KEY.BLOB_HASH),
+        bbox: node.get(GEOMETRY_KEY.BBOX),
+        versionVector: vvJson,
+    };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/doc/geometry.js.map

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

package/dist/doc/index.d.ts

@@ -0,0 +1,8 @@
+export * from './schema.js';
+export * from './schema-version.js';
+export * from './migration-ifc4-to-ifc4x3.js';
+export * from './entity.js';
+export * from './relationship.js';
+export * from './geometry.js';
+export * from './units.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/doc/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/doc/index.js

@@ -0,0 +1,11 @@
+/* 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 * from './schema.js';
+export * from './schema-version.js';
+export * from './migration-ifc4-to-ifc4x3.js';
+export * from './entity.js';
+export * from './relationship.js';
+export * from './geometry.js';
+export * from './units.js';
+//# sourceMappingURL=index.js.map

package/dist/doc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/doc/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/doc/migration-ifc4-to-ifc4x3.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Sample IFC4 → IFC4X3 schema migration (spec open #2).
+ *
+ * Demonstrates the migration plumb in `schema-version.ts`. Apps can
+ * register this directly via `installIfc4ToIfc4x3Migration()` or
+ * write their own equivalent.
+ *
+ * The transformation here is intentionally narrow:
+ *   - rename common Pset attribute prefixes from `Pset_<…>::` to
+ *     `bsi::ifc::v5a::Pset_<…>::` so they line up with IFCX namespacing.
+ *
+ * Real schema migrations are far more involved (entity-class renames,
+ * attribute splits, unit changes). This sample shows the shape; the
+ * full IFC4 → IFC4X3 migration registry is a v1.0+ task.
+ */
+import { type SchemaMigration } from '../doc/schema-version.js';
+declare const ifc4ToIfc4x3: SchemaMigration;
+/** Register the IFC4 → IFC4X3 migration. Idempotent within a process. */
+export declare function installIfc4ToIfc4x3Migration(): SchemaMigration;
+export { ifc4ToIfc4x3 };
+//# sourceMappingURL=migration-ifc4-to-ifc4x3.d.ts.map

package/dist/doc/migration-ifc4-to-ifc4x3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-ifc4-to-ifc4x3.d.ts","sourceRoot":"","sources":["../../src/doc/migration-ifc4-to-ifc4x3.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAKlC,QAAA,MAAM,YAAY,EAAE,eAyBnB,CAAC;AAEF,yEAAyE;AACzE,wBAAgB,4BAA4B,IAAI,eAAe,CAG9D;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/doc/migration-ifc4-to-ifc4x3.js

@@ -0,0 +1,55 @@
+/* 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/. */
+/**
+ * Sample IFC4 → IFC4X3 schema migration (spec open #2).
+ *
+ * Demonstrates the migration plumb in `schema-version.ts`. Apps can
+ * register this directly via `installIfc4ToIfc4x3Migration()` or
+ * write their own equivalent.
+ *
+ * The transformation here is intentionally narrow:
+ *   - rename common Pset attribute prefixes from `Pset_<…>::` to
+ *     `bsi::ifc::v5a::Pset_<…>::` so they line up with IFCX namespacing.
+ *
+ * Real schema migrations are far more involved (entity-class renames,
+ * attribute splits, unit changes). This sample shows the shape; the
+ * full IFC4 → IFC4X3 migration registry is a v1.0+ task.
+ */
+import { registerSchemaMigration, } from '../doc/schema-version.js';
+const PREFIX_FROM = /^Pset_([A-Za-z0-9_]+)::(.+)$/;
+const ifc4ToIfc4x3 = {
+    from: 'ifc4',
+    to: 'ifc4x3',
+    apply(doc) {
+        const ents = doc.getMap('entities');
+        ents.forEach((entUntyped) => {
+            const entity = entUntyped;
+            const attrs = entity.get('attributes');
+            if (!attrs)
+                return;
+            const renames = [];
+            attrs.forEach((value, key) => {
+                const match = PREFIX_FROM.exec(key);
+                if (!match)
+                    return;
+                renames.push({
+                    from: key,
+                    to: `bsi::ifc::v5a::Pset_${match[1]}::${match[2]}`,
+                    value,
+                });
+            });
+            for (const r of renames) {
+                attrs.set(r.to, r.value);
+                attrs.delete(r.from);
+            }
+        });
+    },
+};
+/** Register the IFC4 → IFC4X3 migration. Idempotent within a process. */
+export function installIfc4ToIfc4x3Migration() {
+    registerSchemaMigration(ifc4ToIfc4x3);
+    return ifc4ToIfc4x3;
+}
+export { ifc4ToIfc4x3 };
+//# sourceMappingURL=migration-ifc4-to-ifc4x3.js.map

package/dist/doc/migration-ifc4-to-ifc4x3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-ifc4-to-ifc4x3.js","sourceRoot":"","sources":["../../src/doc/migration-ifc4-to-ifc4x3.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,uBAAuB,GAExB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAEnD,MAAM,YAAY,GAAoB;IACpC,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,QAAQ;IACZ,KAAK,CAAC,GAAU;QACd,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,UAA4B,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAA+B,CAAC;YACrE,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,MAAM,OAAO,GAAwD,EAAE,CAAC;YACxE,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpC,IAAI,CAAC,KAAK;oBAAE,OAAO;gBACnB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,GAAG;oBACT,EAAE,EAAE,uBAAuB,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE;oBAClD,KAAK;iBACN,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;gBACzB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,4BAA4B;IAC1C,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACtC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/doc/relationship.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Relationship-level operations on the Y.Doc.
+ *
+ * Relationships are stored in their own top-level Y.Map so concurrent edits
+ * to the source/target lists don't collide with edits on the entities they
+ * reference (spec §5.2).
+ */
+import * as Y from 'yjs';
+export interface CreateRelationshipOptions {
+    ifcClass: string;
+    source: string;
+    targets?: string[];
+    attributes?: Record<string, unknown>;
+}
+export declare function getRelationship(doc: Y.Doc, path: string): Y.Map<unknown> | undefined;
+export declare function createRelationship(doc: Y.Doc, path: string, options: CreateRelationshipOptions): Y.Map<unknown>;
+export declare function deleteRelationship(doc: Y.Doc, path: string): boolean;
+export declare function addTarget(doc: Y.Doc, path: string, targetPath: string): void;
+export declare function removeTarget(doc: Y.Doc, path: string, targetPath: string): boolean;
+export declare function getTargets(doc: Y.Doc, path: string): string[];
+/**
+ * Cascade relationship cleanup when an entity is deleted. Removes the
+ * entity from any relationship's targets and deletes relationships that
+ * had it as their source.
+ */
+export declare function cascadeDeleteRelationships(doc: Y.Doc, entityPath: string): void;
+//# sourceMappingURL=relationship.d.ts.map

package/dist/doc/relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship.d.ts","sourceRoot":"","sources":["../../src/doc/relationship.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,SAAS,CAEpF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,yBAAyB,GACjC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAyBhB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQ5E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAclF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAoB/E"}

package/dist/doc/relationship.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/. */
+/**
+ * Relationship-level operations on the Y.Doc.
+ *
+ * Relationships are stored in their own top-level Y.Map so concurrent edits
+ * to the source/target lists don't collide with edits on the entities they
+ * reference (spec §5.2).
+ */
+import * as Y from 'yjs';
+import { RELATIONSHIP_KEY, relationshipsMap } from './schema.js';
+export function getRelationship(doc, path) {
+    return relationshipsMap(doc).get(path);
+}
+export function createRelationship(doc, path, options) {
+    const rels = relationshipsMap(doc);
+    const existing = rels.get(path);
+    if (existing)
+        return existing;
+    const rel = new Y.Map();
+    rel.set(RELATIONSHIP_KEY.IFC_CLASS, options.ifcClass);
+    rel.set(RELATIONSHIP_KEY.SOURCE, options.source);
+    const targets = new Y.Array();
+    if (options.targets && options.targets.length > 0) {
+        targets.push(options.targets);
+    }
+    rel.set(RELATIONSHIP_KEY.TARGETS, targets);
+    const attrs = new Y.Map();
+    if (options.attributes) {
+        for (const [k, v] of Object.entries(options.attributes)) {
+            attrs.set(k, v);
+        }
+    }
+    rel.set(RELATIONSHIP_KEY.ATTRIBUTES, attrs);
+    rels.set(path, rel);
+    return rel;
+}
+export function deleteRelationship(doc, path) {
+    const rels = relationshipsMap(doc);
+    if (!rels.has(path))
+        return false;
+    rels.delete(path);
+    return true;
+}
+export function addTarget(doc, path, targetPath) {
+    const rel = getRelationship(doc, path);
+    if (!rel)
+        throw new Error(`@ifc-lite/collab: relationship "${path}" not found`);
+    const targets = rel.get(RELATIONSHIP_KEY.TARGETS);
+    if (!targets)
+        throw new Error(`@ifc-lite/collab: relationship "${path}" missing targets`);
+    // Push preserves concurrent additions per CRDT semantics; dedupe is left
+    // to the caller because IFC relationships occasionally allow duplicates.
+    targets.push([targetPath]);
+}
+export function removeTarget(doc, path, targetPath) {
+    const rel = getRelationship(doc, path);
+    if (!rel)
+        return false;
+    const targets = rel.get(RELATIONSHIP_KEY.TARGETS);
+    if (!targets)
+        return false;
+    const arr = targets.toArray();
+    let removed = false;
+    for (let i = arr.length - 1; i >= 0; i--) {
+        if (arr[i] === targetPath) {
+            targets.delete(i, 1);
+            removed = true;
+        }
+    }
+    return removed;
+}
+export function getTargets(doc, path) {
+    const rel = getRelationship(doc, path);
+    if (!rel)
+        return [];
+    const targets = rel.get(RELATIONSHIP_KEY.TARGETS);
+    return targets ? targets.toArray() : [];
+}
+/**
+ * Cascade relationship cleanup when an entity is deleted. Removes the
+ * entity from any relationship's targets and deletes relationships that
+ * had it as their source.
+ */
+export function cascadeDeleteRelationships(doc, entityPath) {
+    const rels = relationshipsMap(doc);
+    const toDelete = [];
+    doc.transact(() => {
+        for (const [relPath, relUntyped] of rels.entries()) {
+            const rel = relUntyped;
+            const source = rel.get(RELATIONSHIP_KEY.SOURCE);
+            if (source === entityPath) {
+                toDelete.push(relPath);
+                continue;
+            }
+            const targets = rel.get(RELATIONSHIP_KEY.TARGETS);
+            if (!targets)
+                continue;
+            const arr = targets.toArray();
+            for (let i = arr.length - 1; i >= 0; i--) {
+                if (arr[i] === entityPath)
+                    targets.delete(i, 1);
+            }
+        }
+        for (const path of toDelete)
+            rels.delete(path);
+    });
+}
+//# sourceMappingURL=relationship.js.map

package/dist/doc/relationship.js.map

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

package/dist/doc/schema-version.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Schema-version helpers (open problem #2 — v1.0 prep).
+ *
+ * The current IFCX schema version of a Y.Doc lives in the top-level
+ * `meta` Y.Map under `schemaVersion`. This module gives that field a
+ * typed accessor + a tiny migration registry so v1.0 can ship the
+ * server-mediated migration flow without a bigger refactor.
+ *
+ * The actual structural migrations (e.g. attribute renames between
+ * IFC4 → IFC4X3) are out of scope for v0.x — this is the wiring.
+ */
+import * as Y from 'yjs';
+/**
+ * Schema versions we recognize.
+ *
+ * `unknown` is what older docs (or hand-built ones) report when no
+ * version was ever set. We treat it as IFC5 for collab purposes since
+ * that's what IFCX targets.
+ */
+export type SchemaVersion = 'ifc4' | 'ifc4x3' | 'ifc5' | 'unknown';
+export declare function getSchemaVersion(doc: Y.Doc): SchemaVersion;
+export declare function setSchemaVersion(doc: Y.Doc, version: SchemaVersion): void;
+/**
+ * Migration registry: each entry transforms `(doc) => doc'` in-place
+ * inside a single transaction. Migrations are looked up by
+ * `(from, to)` pair.
+ *
+ * v0.x ships an empty registry intentionally — registering one is the
+ * v1.0 task. The shape is stable so consumers can author migrations
+ * without further API churn.
+ */
+export interface SchemaMigration {
+    from: SchemaVersion;
+    to: SchemaVersion;
+    apply: (doc: Y.Doc) => void;
+}
+export declare function registerSchemaMigration(migration: SchemaMigration): void;
+export declare function listSchemaMigrations(): readonly SchemaMigration[];
+/**
+ * Run a single migration in a transaction tagged with our migration
+ * origin. Returns true when applied, false if the doc isn't at `from`
+ * or no migration is registered.
+ */
+export declare function migrateSchema(doc: Y.Doc, from: SchemaVersion, to: SchemaVersion): boolean;
+/** Origin tag used by migration transactions so observers can filter them. */
+export declare const MIGRATION_ORIGIN: unique symbol;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/doc/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/doc/schema-version.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,aAAa,CAI1D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAEzE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;CAC7B;AAID,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAExE;AAED,wBAAgB,oBAAoB,IAAI,SAAS,eAAe,EAAE,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CASzF;AAED,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,eAAkD,CAAC"}

package/dist/doc/schema-version.js

@@ -0,0 +1,41 @@
+/* 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 { metaMap } from './schema.js';
+const KEY = 'schemaVersion';
+export function getSchemaVersion(doc) {
+    const v = metaMap(doc).get(KEY);
+    if (v === 'ifc4' || v === 'ifc4x3' || v === 'ifc5')
+        return v;
+    return 'unknown';
+}
+export function setSchemaVersion(doc, version) {
+    metaMap(doc).set(KEY, version);
+}
+const REGISTRY = [];
+export function registerSchemaMigration(migration) {
+    REGISTRY.push(migration);
+}
+export function listSchemaMigrations() {
+    return REGISTRY;
+}
+/**
+ * Run a single migration in a transaction tagged with our migration
+ * origin. Returns true when applied, false if the doc isn't at `from`
+ * or no migration is registered.
+ */
+export function migrateSchema(doc, from, to) {
+    if (getSchemaVersion(doc) !== from)
+        return false;
+    const migration = REGISTRY.find((m) => m.from === from && m.to === to);
+    if (!migration)
+        return false;
+    doc.transact(() => {
+        migration.apply(doc);
+        setSchemaVersion(doc, to);
+    }, MIGRATION_ORIGIN);
+    return true;
+}
+/** Origin tag used by migration transactions so observers can filter them. */
+export const MIGRATION_ORIGIN = Symbol.for('@ifc-lite/collab/schema-migration');
+//# sourceMappingURL=schema-version.js.map

package/dist/doc/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../src/doc/schema-version.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAe/D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAWtC,MAAM,GAAG,GAAG,eAAe,CAAC;AAE5B,MAAM,UAAU,gBAAgB,CAAC,GAAU;IACzC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAU,EAAE,OAAsB;IACjE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAiBD,MAAM,QAAQ,GAAsB,EAAE,CAAC;AAEvC,MAAM,UAAU,uBAAuB,CAAC,SAA0B;IAChE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAU,EAAE,IAAmB,EAAE,EAAiB;IAC9E,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE;QAChB,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,gBAAgB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC"}

package/dist/doc/schema.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Y.Doc schema for the collaborative BIM runtime.
+ *
+ * Mirrors the spec §5 data model, adapted to the actual IFCX wire shape
+ * (path + flat namespaced attributes + role→path children).
+ */
+import * as Y from 'yjs';
+/** Top-level shared-type names. */
+export declare const TOP: {
+    readonly ENTITIES: "entities";
+    readonly RELATIONSHIPS: "relationships";
+    readonly GEOMETRY: "geometry";
+    readonly META: "meta";
+};
+/** Origin tag used for transactions originated by the local CollabSession. */
+export declare const LOCAL_ORIGIN: unique symbol;
+/** Origin tag for transactions originated by snapshot seeding. */
+export declare const SEED_ORIGIN: unique symbol;
+/** Origin tag for transactions originated by undo/redo. */
+export declare const UNDO_ORIGIN: unique symbol;
+/**
+ * Per-entity Y.Map keys.
+ *
+ * Each entity is a Y.Map with these well-known sub-maps. Sub-maps are
+ * themselves Y.Maps so concurrent edits to different sub-maps never
+ * conflict.
+ */
+export declare const ENTITY_KEY: {
+    /** IFCX `attributes` — flat record keyed by namespaced names. */
+    readonly ATTRIBUTES: "attributes";
+    /** IFCX `children` — role → path. */
+    readonly CHILDREN: "children";
+    /** IFCX `inherits` — role → path. */
+    readonly INHERITS: "inherits";
+    /** Property sets, grouped: psetName → propName → PropertyValue. */
+    readonly PSETS: "psets";
+    /** Quantity sets: qsetName → quantityName → number. */
+    readonly QUANTITIES: "quantities";
+    /** Classification refs (Y.Array). */
+    readonly CLASSIFICATIONS: "classifications";
+    /** Material assignments (Y.Array). */
+    readonly MATERIALS: "materials";
+    /** Reference into the `geometry` top-level map. */
+    readonly GEOMETRY_REF: "geometryRef";
+    /** Provenance metadata: createdBy, createdAt, lastEditedBy, etc. */
+    readonly META: "meta";
+};
+/** Per-relationship Y.Map keys. */
+export declare const RELATIONSHIP_KEY: {
+    readonly IFC_CLASS: "ifcClass";
+    readonly SOURCE: "source";
+    readonly TARGETS: "targets";
+    readonly ATTRIBUTES: "attributes";
+};
+/** Per-geometry Y.Map keys. */
+export declare const GEOMETRY_KEY: {
+    readonly TYPE: "type";
+    readonly SOURCE: "source";
+    readonly PARAMS: "params";
+    readonly BLOB_HASH: "blobHash";
+    readonly BBOX: "bbox";
+    readonly VERSION_VECTOR: "versionVector";
+};
+/**
+ * A typed property value as stored in a Pset Y.Map.
+ *
+ * We store these as plain JSON values (not Y.Maps) because the property
+ * value is replaced atomically; partial updates to the typed shape are not
+ * meaningful at the IFC level.
+ */
+export interface PropertyValue {
+    type: 'IfcLabel' | 'IfcText' | 'IfcReal' | 'IfcInteger' | 'IfcBoolean' | 'IfcLogical' | 'IfcIdentifier' | string;
+    value: string | number | boolean | null;
+    unit?: string;
+    /** Provenance: 'manual' | 'bsdd:<uri>' | 'derived' | 'ifcx:<layer>'. */
+    source?: string;
+}
+/** Classification reference. */
+export interface ClassificationRef {
+    system: string;
+    code: string;
+    uri?: string;
+    description?: string;
+}
+/** Material assignment record. */
+export interface MaterialAssignment {
+    materialId: string;
+    layerName?: string;
+    thickness?: number;
+    fraction?: number;
+}
+/** Geometry reference stored on each entity. */
+export interface GeometryRefRecord {
+    /** Pointer into the `geometry` top-level map (== that entry's geomId). */
+    geomId: string;
+}
+/** Entity metadata. */
+export interface EntityMeta {
+    ifcClass?: string;
+    schemaVersion?: 'ifc4' | 'ifc4x3' | 'ifc5';
+    createdBy?: string;
+    createdAt?: string;
+    lastEditedBy?: string;
+    lastEditedAt?: string;
+    /** For type promotion: previous path before delete+create. */
+    previousPath?: string;
+    /** Free-form per-entity metadata. */
+    [key: string]: unknown;
+}
+/**
+ * Create a fresh, empty Y.Doc with the spec's top-level shared types.
+ *
+ * Idempotent: calling `getMap` twice returns the same shared type, so this
+ * is safe to call on an already-populated doc as well.
+ */
+export declare function createCollabDoc(opts?: {
+    gc?: boolean;
+}): Y.Doc;
+/** Top-level accessors. Centralized so refactors stay safe. */
+export declare function entitiesMap(doc: Y.Doc): Y.Map<Y.Map<unknown>>;
+export declare function relationshipsMap(doc: Y.Doc): Y.Map<Y.Map<unknown>>;
+export declare function geometryMap(doc: Y.Doc): Y.Map<Y.Map<unknown>>;
+export declare function metaMap(doc: Y.Doc): Y.Map<unknown>;
+/**
+ * Runtime invariant check used by tests and seeding.
+ *
+ * Throws if the Y.Doc does not have the expected shape. We check structural
+ * presence and type shape, not content, so an empty fresh doc passes.
+ */
+export declare function assertSchemaInvariants(doc: Y.Doc): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/doc/schema.d.ts.map

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