@bldrs-ai/conway 1.535.1506 → 1.536.1507

package/compiled/examples/browser-bundled.cjs

@@ -30,7 +30,7 @@ var import_node_process = require("node:process");
 var readline = __toESM(require("node:readline"), 1);
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.535.1506";
+var versionString = "Conway v1.536.1507";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";

package/compiled/examples/cli-bundled.cjs

@@ -14965,7 +14965,7 @@ ${t5.join("\n")}` : "";
 var import_process = require("process");
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.535.1506";
+var versionString = "Conway v1.536.1507";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {

package/compiled/examples/cli-step-bundled.cjs

@@ -15943,7 +15943,7 @@ var ParsingBuffer = class {
 };
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.535.1506";
+var versionString = "Conway v1.536.1507";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 function pThreadsAllowed() {

package/compiled/examples/validator-bundled.cjs

@@ -944,7 +944,7 @@ var EntityTypesIfcCount = 909;
 var entity_types_ifc_gen_default = EntityTypesIfc;
 
 // compiled/src/version/version.js
-var versionString = "Conway v1.535.1506";
+var versionString = "Conway v1.536.1507";
 
 // compiled/dependencies/conway-geom/interface/conway_geometry.js
 var wasmType = "";

package/compiled/src/compat/web-ifc/ifc_api.d.ts

@@ -466,6 +466,31 @@ export declare class IfcAPI {
         budgetBytes: number;
         liveBytes: number;
     } | undefined;
+    /**
+     * Conway extension (M3): extract only one shard of a deferred model's
+     * geometry, so N workers — each with its own instance and heap — can pump
+     * disjoint products with no scheduling channel between them.
+     *
+     * Placement is a pure function of the product (its representation's mapped
+     * source), so every worker independently agrees on who owns what, and
+     * products sharing geometry land together rather than each shard rebuilding
+     * it. Measured at N=4: +0 % extra assets on MB-Khaya and +38.1 % on D3D
+     * against round-robin's +25 % and +40.7 %, for 1.76x and 2.34x wall-clock.
+     *
+     * **A shard is a SUBSET of the model.** Pumping one to completion yields
+     * part of the geometry; the consumer unions the shards. Call before the
+     * first ExtractGeometryBatch — after that the worklists exist and narrowing
+     * them would drop products already reported as pending, so it throws.
+     *
+     * @param modelID handle from a DEFER_GEOMETRY open
+     * @param shard `{index, count}`, or omitted for the whole model
+     * @return {boolean} false for unknown models and for passthroughs with no
+     * demand worklists (AP214/STEP), which cannot shard
+     */
+    SetGeometryShard(modelID: number, shard?: {
+        index: number;
+        count: number;
+    }): boolean;
     ExtractGeometryBatch(modelID: number, batchSize: number, meshCallback?: (mesh: FlatMesh) => void): {
         extracted: number;
         remaining: number;

package/compiled/src/compat/web-ifc/ifc_api.d.ts.map

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

package/compiled/src/compat/web-ifc/ifc_api.js

@@ -653,6 +653,35 @@ export class IfcAPI {
         }
         return result.setGeometryBudget(megabytes * BYTES_PER_MIB);
     }
+    /**
+     * Conway extension (M3): extract only one shard of a deferred model's
+     * geometry, so N workers — each with its own instance and heap — can pump
+     * disjoint products with no scheduling channel between them.
+     *
+     * Placement is a pure function of the product (its representation's mapped
+     * source), so every worker independently agrees on who owns what, and
+     * products sharing geometry land together rather than each shard rebuilding
+     * it. Measured at N=4: +0 % extra assets on MB-Khaya and +38.1 % on D3D
+     * against round-robin's +25 % and +40.7 %, for 1.76x and 2.34x wall-clock.
+     *
+     * **A shard is a SUBSET of the model.** Pumping one to completion yields
+     * part of the geometry; the consumer unions the shards. Call before the
+     * first ExtractGeometryBatch — after that the worklists exist and narrowing
+     * them would drop products already reported as pending, so it throws.
+     *
+     * @param modelID handle from a DEFER_GEOMETRY open
+     * @param shard `{index, count}`, or omitted for the whole model
+     * @return {boolean} false for unknown models and for passthroughs with no
+     * demand worklists (AP214/STEP), which cannot shard
+     */
+    SetGeometryShard(modelID, shard) {
+        const result = this.models.get(modelID);
+        if (result?.setGeometryShard === void 0) {
+            return false;
+        }
+        result.setGeometryShard(shard);
+        return true;
+    }
     ExtractGeometryBatch(modelID, batchSize, meshCallback) {
         const result = this.models.get(modelID);
         if (result?.extractGeometryBatch === void 0) {

package/compiled/src/compat/web-ifc/ifc_api_deferred_open.test.js

@@ -9,6 +9,25 @@ import * as fs from "fs";
 import { beforeAll, describe, expect, test } from "@jest/globals";
 import { IfcAPI } from "./ifc_api.js";
 const SETTINGS = { COORDINATE_TO_ORIGIN: true, USE_FAST_BOOLS: true };
+// Sharding refuses COORDINATE_TO_ORIGIN — each shard would derive its own
+// recentre anchor — so every sharded open here goes without it.
+const SHARD_SETTINGS = { COORDINATE_TO_ORIGIN: false, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true };
+/**
+ * A transform's exact bytes, as a comparable string.
+ *
+ * Rounding would make these comparisons unable to fail: a transform that
+ * moved by less than half the last printed digit would serialize identically
+ * to the one it is being checked against. Every use below is asserting that
+ * two paths produce the SAME output, so the encoding has to be lossless.
+ *
+ * @param transform The flat transformation.
+ * @return {string} A lossless encoding of every component.
+ */
+function transformKey(transform) {
+    const exact = new Float64Array(transform);
+    return Buffer.from(exact.buffer, exact.byteOffset, exact.byteLength)
+        .toString("base64");
+}
 let api;
 let buffer;
 /**
@@ -299,8 +318,7 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
         api5.StreamAllMeshes(classicID, (mesh) => {
             for (let where = 0; where < mesh.geometries.size(); ++where) {
                 const placed = mesh.geometries.get(where);
-                classicPlacements.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
-                    .map((value) => value.toFixed(3)).join(",")}`);
+                classicPlacements.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
             }
         });
         const deferredID = await api5.OpenModelStreamed(fixture, { ...SETTINGS, DEFER_GEOMETRY: true });
@@ -310,8 +328,7 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
             const { extracted, remaining } = api5.ExtractGeometryBatch(deferredID, 4, (mesh) => {
                 for (let where = 0; where < mesh.geometries.size(); ++where) {
                     const placed = mesh.geometries.get(where);
-                    pumpedPlacements.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
-                        .map((value) => value.toFixed(3)).join(",")}`);
+                    pumpedPlacements.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
                 }
             });
             ++batches;
@@ -415,8 +432,7 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
         api6.StreamAllMeshes(classicID, (mesh) => {
             for (let where = 0; where < mesh.geometries.size(); ++where) {
                 const placed = mesh.geometries.get(where);
-                classicPlacements.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
-                    .map((value) => value.toFixed(3)).join(",")}`);
+                classicPlacements.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
             }
         });
         const deferredID = await api6.OpenModelStreamed(fixture, { ...SETTINGS, DEFER_GEOMETRY: true });
@@ -431,8 +447,7 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
             const { extracted, remaining } = api6.ExtractGeometryBatch(deferredID, 4, (mesh) => {
                 for (let where = 0; where < mesh.geometries.size(); ++where) {
                     const placed = mesh.geometries.get(where);
-                    pumped.push(`${placed.geometryExpressID}@${[...placed.flatTransformation]
-                        .map((value) => value.toFixed(3)).join(",")}`);
+                    pumped.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
                 }
             });
             if (remaining === 0 && extracted === 0) {
@@ -580,6 +595,351 @@ describe("OpenModelStreamed + DEFER_GEOMETRY", () => {
         }
         api7.CloseModel(modelID);
     }, 240000);
+    test("shards partition the model: every instance exactly once", async () => {
+        // The property a worker pool rests on. Four instances each claim a shard
+        // and pump to completion; the union must equal what one unsharded load
+        // delivers — no instance lost, none built twice. Placement being a pure
+        // function of the product is what lets the shards agree without talking
+        // to each other, so this also pins that: the same product must land in
+        // the same shard from four independent decisions.
+        // Both fixtures deliberately: the mapped one exercises the product
+        // worklist, and aggregate_master_voids the rel-aggregates pass, which is
+        // a SEPARATE worklist with its own filter. Sharding one and not the other
+        // duplicates every aggregate across every shard — and on an
+        // assembly-heavy model that pass is most of the geometry, so this is the
+        // failure with real consequences, not the exotic one.
+        for (const fixturePath of [
+            "data/mapped_shared_representation.ifc",
+            "data/aggregate_master_voids.ifc",
+        ]) {
+            await partitionsExactlyOnce(fixturePath);
+        }
+    }, 240000);
+    /**
+     * Assert that N shards of a model union to exactly what one unsharded load
+     * delivers.
+     *
+     * @param fixturePath The model to check.
+     */
+    async function partitionsExactlyOnce(fixturePath) {
+        const fixture = new Uint8Array(fs.readFileSync(fixturePath));
+        const wholeApi = new IfcAPI();
+        await wholeApi.Init();
+        const wholeID = await wholeApi.OpenModelStreamed(fixture, SHARD_SETTINGS);
+        const whole = [];
+        for (;;) {
+            const { extracted, remaining } = wholeApi.ExtractGeometryBatch(wholeID, 4, (mesh) => {
+                for (let where = 0; where < mesh.geometries.size(); ++where) {
+                    const placed = mesh.geometries.get(where);
+                    whole.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
+                }
+            });
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        expect(whole.length).toBeGreaterThan(0);
+        const shardCount = 4;
+        const sharded = [];
+        const perShard = [];
+        for (let index = 0; index < shardCount; ++index) {
+            const api = new IfcAPI();
+            await api.Init();
+            const modelID = await api.OpenModelStreamed(fixture, SHARD_SETTINGS);
+            expect(api.SetGeometryShard(modelID, { index, count: shardCount }))
+                .toBe(true);
+            let delivered = 0;
+            for (;;) {
+                const { extracted, remaining } = api.ExtractGeometryBatch(modelID, 4, (mesh) => {
+                    for (let where = 0; where < mesh.geometries.size(); ++where) {
+                        const placed = mesh.geometries.get(where);
+                        sharded.push(`${placed.geometryExpressID}@${transformKey(placed.flatTransformation)}`);
+                        ++delivered;
+                    }
+                });
+                if (remaining === 0 && extracted === 0) {
+                    break;
+                }
+            }
+            perShard.push(delivered);
+            api.CloseModel(modelID);
+        }
+        // The union is the model: same multiset, nothing lost or doubled.
+        expect(sharded.slice().sort()).toEqual(whole.slice().sort());
+        // ...and no shard delivered the whole thing, which the equality above
+        // would happily accept from one shard doing everything. A single-instance
+        // model legitimately lands in one shard, so this only asserts that no
+        // shard exceeded the total.
+        expect(Math.max(...perShard)).toBeLessThanOrEqual(whole.length);
+        wholeApi.CloseModel(wholeID);
+    }
+    test("a shard cannot be claimed after pumping starts", async () => {
+        // Narrowing the worklists mid-load would drop products already reported
+        // as pending, so the model would quietly deliver less than it promised.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/mapped_shared_representation.ifc")), { COORDINATE_TO_ORIGIN: false, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true });
+        api.ExtractGeometryBatch(modelID, 1);
+        expect(() => api.SetGeometryShard(modelID, { index: 0, count: 2 }))
+            .toThrow(/before the first/);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("enabling COORDINATE_TO_ORIGIN after claiming a shard is refused", async () => {
+        // The claim-time check alone is not enforcement: the proxy holds the
+        // CALLER'S settings object by reference and reads COORDINATE_TO_ORIGIN
+        // live when it derives the recentre frame. A caller that opens without
+        // it, claims a shard, then flips the flag would get per-shard anchors —
+        // subsets of a large-coordinate model shifted by whole grid cells,
+        // which no union-of-placements check catches on a fixture at the origin.
+        const api = new IfcAPI();
+        await api.Init();
+        const settings = { COORDINATE_TO_ORIGIN: false, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true };
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/mapped_shared_representation.ifc")), settings);
+        expect(api.SetGeometryShard(modelID, { index: 0, count: 2 })).toBe(true);
+        settings.COORDINATE_TO_ORIGIN = true;
+        expect(() => api.ExtractGeometryBatch(modelID, 1))
+            .toThrow(/COORDINATE_TO_ORIGIN was enabled on a sharded model/);
+        // The async entry is a SEPARATE path — on an external source it never
+        // reaches pumpGeometryBatch_ at all — so the guard has to hold there
+        // independently. It was bypassed when the check lived in the pump.
+        await expect(api.ExtractGeometryBatchAsync(modelID, 1))
+            .rejects.toThrow(/COORDINATE_TO_ORIGIN was enabled on a sharded model/);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a one-worker claim is accepted, whatever the model settings", async () => {
+        // {index: 0, count: 1} IS the unsharded model, and a coordinator
+        // that calls this uniformly for its N=1 baseline is doing nothing
+        // that needs cross-worker agreement. The guards below it exist only
+        // because workers must agree with each other, so applying them to a
+        // single worker would fail a configuration equivalent to never
+        // having claimed at all — including on a recentred model, which is
+        // how Share opens.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), { COORDINATE_TO_ORIGIN: true, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true });
+        expect(api.SetGeometryShard(modelID, { index: 0, count: 1 }))
+            .toBe(true);
+        let delivered = 0;
+        for (;;) {
+            const { extracted, remaining } = api.ExtractGeometryBatch(modelID, 4, (mesh) => {
+                delivered += mesh.geometries.size();
+            });
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        // The whole model, not a subset, and no throw from the recentre
+        // guard on the pump either.
+        expect(delivered).toBeGreaterThan(0);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a malformed descriptor is reported as malformed", async () => {
+        // Validation runs before the incompatibility checks, so a bad
+        // descriptor on a recentred model says what is bad about it rather
+        // than blaming whichever guard it trips first.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), { COORDINATE_TO_ORIGIN: true, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true });
+        expect(() => api.SetGeometryShard(modelID, { index: 3, count: 2 }))
+            .toThrow(/invalid shard/);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a model that already adopted a recentre frame cannot be sharded", async () => {
+        // WHITE-BOX, and deliberately so. The reported route here is
+        // ON_PREVIEW_MESH: the preview channel can install a coordination
+        // frame at OPEN, before any pump, after which a caller may set
+        // COORDINATE_TO_ORIGIN false on its own settings object and claim a
+        // shard — passing a flag-only guard while already sitting in a
+        // frame derived from whichever geometry THIS instance previewed.
+        //
+        // I could not get the preview channel to install a frame from a
+        // test (tried index.ifc and index_georeferenced.ifc; demandCoordination_
+        // stayed undefined), so this pins the guard on the state itself
+        // rather than pretending to reproduce the route to it. If the route
+        // is unreachable the guard is merely cheap; if it is reachable, this
+        // is what stops it.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), SHARD_SETTINGS);
+        const passthrough = api.getPassthrough(modelID);
+        // A frame adopted from somewhere other than the current flag.
+        passthrough.demandCoordination_ =
+            [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 1000, 2000, 3000, 1];
+        expect(() => api.SetGeometryShard(modelID, { index: 0, count: 2 }))
+            .toThrow(/already adopted a recentre frame/);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a sharded model does not recentre even if a callback enables it", async () => {
+        // The window codex found in round 9: ON_PROGRESS is invoked
+        // synchronously from beginPhase, INSIDE the first pump — after the
+        // precondition check for that batch has passed and before the
+        // capture reads the flag. A handler enabling COORDINATE_TO_ORIGIN
+        // there would have each worker derive its own frame despite the
+        // guard.
+        //
+        // Two windows of this shape were patched individually in earlier
+        // rounds, so this asserts BOTH halves of closing the class:
+        //   1. geometry delivered inside the window is not recentred, and
+        //   2. the refusal still fires on the next batch, so the caller is
+        //      told rather than quietly given a subset it cannot merge.
+        const api = new IfcAPI();
+        await api.Init();
+        const settings = {
+            COORDINATE_TO_ORIGIN: false,
+            USE_FAST_BOOLS: true,
+            DEFER_GEOMETRY: true,
+            // Only once the GEOMETRY phase begins — inside the first pump,
+            // after the shard was claimed. Flipping it earlier is caught by
+            // the claim-time refusal, which is correct and not this window.
+            ON_PROGRESS: (event) => {
+                if (event.phase === "geometry") {
+                    settings.COORDINATE_TO_ORIGIN = true;
+                }
+            },
+        };
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), settings);
+        expect(api.SetGeometryShard(modelID, { index: 0, count: 2 }))
+            .toBe(true);
+        const windowed = [];
+        api.ExtractGeometryBatch(modelID, 4, (mesh) => {
+            for (let where = 0; where < mesh.geometries.size(); ++where) {
+                windowed.push(transformKey(mesh.geometries.get(where).flatTransformation));
+            }
+        });
+        // The handler really did flip it, mid-pump.
+        expect(settings.COORDINATE_TO_ORIGIN).toBe(true);
+        // (2) The refusal fires now that the flag is observable.
+        expect(() => api.ExtractGeometryBatch(modelID, 4))
+            .toThrow(/COORDINATE_TO_ORIGIN was enabled on a sharded model/);
+        // (1) ...and nothing delivered inside the window was recentred:
+        // identical to a shard whose flag was never touched. A derived
+        // frame would move every transform.
+        const referenceApi = new IfcAPI();
+        await referenceApi.Init();
+        const referenceID = await referenceApi.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), SHARD_SETTINGS);
+        referenceApi.SetGeometryShard(referenceID, { index: 0, count: 2 });
+        const reference = [];
+        referenceApi.ExtractGeometryBatch(referenceID, 4, (mesh) => {
+            for (let where = 0; where < mesh.geometries.size(); ++where) {
+                reference.push(transformKey(mesh.geometries.get(where).flatTransformation));
+            }
+        });
+        expect(reference.length).toBeGreaterThan(0);
+        expect(windowed).toEqual(reference);
+        api.CloseModel(modelID);
+        referenceApi.CloseModel(referenceID);
+    }, 240000);
+    test("a model opened with ON_PREVIEW_MESH cannot be sharded", async () => {
+        // The preview channel runs during OPEN, before a shard can be claimed,
+        // so its payloads are never partitioned: every worker in a pool would
+        // perform the same capped preview extraction and emit the same
+        // imposters, and a consumer forwarding those callbacks would receive N
+        // overlapping copies while only the durable pump was split.
+        //
+        // Note this is NOT covered by the adopted-frame guard: that one keys on
+        // demandCoordination_, which the preview only installs when recentring
+        // is on. With COORDINATE_TO_ORIGIN false there is no frame to catch,
+        // and the duplicated preview output is the whole problem.
+        const api = new IfcAPI();
+        await api.Init();
+        let previews = 0;
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), { ...SHARD_SETTINGS, ON_PREVIEW_MESH: () => {
+                ++previews;
+            } });
+        // The preview really did run, so the refusal below is about something
+        // that happened rather than a flag nobody acted on.
+        expect(previews).toBeGreaterThan(0);
+        expect(() => api.SetGeometryShard(modelID, { index: 0, count: 2 }))
+            .toThrow(/ON_PREVIEW_MESH/);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a shard cannot be claimed on a model opened without DEFER_GEOMETRY", async () => {
+        // Sharding only narrows the deferred pump's worklists. A classic
+        // open has already extracted everything, so the claim would be
+        // accepted and then do nothing: ExtractGeometryBatch returns zero
+        // work and StreamAllMeshes serves the whole scene. A coordinator
+        // that forgot the flag would get the COMPLETE model from every
+        // worker while believing it had a partition.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), { COORDINATE_TO_ORIGIN: false, USE_FAST_BOOLS: true });
+        expect(() => api.SetGeometryShard(modelID, { index: 0, count: 2 }))
+            .toThrow(/requires DEFER_GEOMETRY/);
+        // N=1 is still fine: it asks for the whole model, which is exactly
+        // what a classic open delivers.
+        expect(api.SetGeometryShard(modelID, { index: 0, count: 1 }))
+            .toBe(true);
+        api.CloseModel(modelID);
+    }, 240000);
+    test("a shard descriptor is snapshotted, not retained", async () => {
+        // A coordinator configuring several instances from one reused object is
+        // the natural way to write an in-process pool. If the descriptor were
+        // retained, every proxy would read its FINAL index at first pump —
+        // several workers claiming one shard, the rest of the model claimed by
+        // nobody — and each call would still have passed validation.
+        const api = new IfcAPI();
+        await api.Init();
+        const fixture = new Uint8Array(fs.readFileSync("data/mapped_shared_representation.ifc"));
+        const descriptor = { index: 0, count: 2 };
+        const modelID = await api.OpenModelStreamed(fixture, SHARD_SETTINGS);
+        expect(api.SetGeometryShard(modelID, descriptor)).toBe(true);
+        // The coordinator moves on to configuring the next worker.
+        descriptor.index = 1;
+        const delivered = [];
+        for (;;) {
+            const { extracted, remaining } = api.ExtractGeometryBatch(modelID, 4, (mesh) => {
+                for (let where = 0; where < mesh.geometries.size(); ++where) {
+                    delivered.push(`${mesh.expressID}/` +
+                        `${mesh.geometries.get(where).geometryExpressID}`);
+                }
+            });
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        // Shard 0's contents, not shard 1's. Compared against a model that
+        // claims shard 0 from a descriptor nobody touches.
+        const referenceApi = new IfcAPI();
+        await referenceApi.Init();
+        const referenceID = await referenceApi.OpenModelStreamed(fixture, SHARD_SETTINGS);
+        referenceApi.SetGeometryShard(referenceID, { index: 0, count: 2 });
+        const reference = [];
+        for (;;) {
+            const { extracted, remaining } = referenceApi.ExtractGeometryBatch(referenceID, 4, (mesh) => {
+                for (let where = 0; where < mesh.geometries.size(); ++where) {
+                    reference.push(`${mesh.expressID}/` +
+                        `${mesh.geometries.get(where).geometryExpressID}`);
+                }
+            });
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        expect(reference.length).toBeGreaterThan(0);
+        expect(delivered.sort()).toEqual(reference.sort());
+        api.CloseModel(modelID);
+        referenceApi.CloseModel(referenceID);
+    }, 240000);
+    test("an unsharded model is unaffected by the shard preconditions", async () => {
+        // The guards must be about workers agreeing with each other and nothing
+        // else. A model that never claims a shard recentres and pumps exactly as
+        // before — without this, the checks would be a behaviour change for
+        // every existing caller, Share included.
+        const api = new IfcAPI();
+        await api.Init();
+        const modelID = await api.OpenModelStreamed(new Uint8Array(fs.readFileSync("data/index.ifc")), { COORDINATE_TO_ORIGIN: true, USE_FAST_BOOLS: true, DEFER_GEOMETRY: true });
+        let delivered = 0;
+        for (;;) {
+            const { extracted, remaining } = api.ExtractGeometryBatch(modelID, 4, (mesh) => {
+                delivered += mesh.geometries.size();
+            });
+            if (remaining === 0 && extracted === 0) {
+                break;
+            }
+        }
+        expect(delivered).toBeGreaterThan(0);
+        api.CloseModel(modelID);
+    }, 240000);
     test("ExtractGeometryBatch is a safe no-op on non-deferred models", async () => {
         const modelID = await api.OpenModelStreamed(buffer, SETTINGS);
         expect(api.ExtractGeometryBatch(modelID, 8))

package/compiled/src/compat/web-ifc/ifc_api_model_passthrough.d.ts

@@ -16,6 +16,15 @@ export interface IfcApiModelPassthrough {
     releaseGeometry?(): boolean;
     /** Metres per model unit (see IfcAPI.GetLinearScalingFactor). */
     linearScalingFactor?: number;
+    /**
+     * Claim one shard of this model's geometry (conway extension, M3) — see
+     * IfcAPI.SetGeometryShard. Optional: passthroughs without demand worklists
+     * (AP214/STEP) have nothing to shard.
+     */
+    setGeometryShard?(shard?: {
+        index: number;
+        count: number;
+    }): void;
     /**
      * Set the resident-geometry budget in bytes (conway extension, M3) —
      * see IfcAPI.SetGeometryBudget. Optional so non-IFC passthroughs, whose

package/compiled/src/compat/web-ifc/ifc_api_model_passthrough.d.ts.map

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