@bldrs-ai/conway 1.375.1183 → 1.376.1184

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

@@ -161,11 +161,15 @@ export class AP214Properties {
      *
      * @param includeProperties When true, merge each node's item properties onto
      * the node (mirrors the IFC surface's `includeProperties`).
+     * @param options Optional shaping: `{ includeSolids: true }` adds the
+     * ephemeral solid layer beneath multibody products (`type: 'solid'`,
+     * `ephemeral: true` nodes) — see `design/new/step-nonproduct-semantics.md`.
      * @return {Promise<Node>} The root node. A single-root file returns its root
      * directly; a multi-root file is wrapped in a synthetic container root.
      */
-    async getSpatialStructure(includeProperties) {
-        const roots = this.productStructure();
+    async getSpatialStructure(includeProperties, options) {
+        const roots = options?.includeSolids === true ?
+            this.productStructureWithSolids() : this.productStructure();
         const nodes = await Promise.all(roots.map((root) => this.toSpatialNode(root, includeProperties)));
         if (nodes.length === 1) {
             return nodes[0];
@@ -217,6 +221,12 @@ export class AP214Properties {
             occurrencePath: node.occurrencePath,
             children,
         };
+        if (node.ephemeral === true) {
+            spatialNode.ephemeral = true;
+        }
+        if (node.droppedSolids !== void 0) {
+            spatialNode.droppedSolids = node.droppedSolids;
+        }
         if (includeProperties === "names") {
             // Satisfied by the unconditional Name handle above.
         }
@@ -312,6 +322,27 @@ export class AP214Properties {
         this.buildIndexes();
         return this.structureRoots_;
     }
+    /**
+     * Return (and cache) the product-structure forest with the ephemeral solid
+     * layer included. Built separately from the plain forest so default callers
+     * never pay for the solid walk; the solid nodes are also indexed so
+     * `getItemProperties` resolves a solid id to its identity row and
+     * `getPropertySets` maps it to the owning product's rows.
+     *
+     * @return {ProductStructureNode[]} The cached solid-including roots.
+     */
+    productStructureWithSolids() {
+        this.buildIndexes();
+        if (this.structureRootsWithSolids_ === void 0) {
+            this.structureRootsWithSolids_ =
+                new AP214ProductStructureExtraction(this.api.StepModel)
+                    .extractProductStructure({ includeSolids: true });
+            for (const root of this.structureRootsWithSolids_) {
+                this.indexNodes(root);
+            }
+        }
+        return this.structureRootsWithSolids_;
+    }
     /**
      * Lazily build and cache the extracted property map.
      *

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

@@ -39,6 +39,28 @@ describe("compat/web-ifc/AP214Properties", () => {
             expect(Array.isArray(child.occurrencePath)).toBe(true);
         }
     });
+    test("getSpatialStructure surfaces the ephemeral solid layer on opt-in only", async () => {
+        const surface = compatSurfaceFor("data/ap214-multibody-part.step");
+        const plainRoot = await surface.getSpatialStructure();
+        const collectTypes = (node, into) => {
+            into.add(node.type);
+            node.children.forEach((child) => collectTypes(child, into));
+            return into;
+        };
+        expect(collectTypes(plainRoot, new Set()).has("solid")).toBe(false);
+        const root = await surface.getSpatialStructure(void 0, { includeSolids: true });
+        const widget = root.children.find((node) => node.Name.value === "widget");
+        const solids = widget.children.filter((node) => node.type === "solid");
+        expect(solids.length).toBeGreaterThan(0);
+        for (const solid of solids) {
+            expect(solid.ephemeral).toBe(true);
+            expect(solid.Name.type).toBe(1);
+            expect(solid.occurrencePath).toEqual(widget.occurrencePath);
+        }
+        // A solid id resolves to its own identity row, like any tree node.
+        const item = await surface.getItemProperties(solids[0].expressID);
+        expect(item.Name.value).toBe(solids[0].Name.value);
+    });
     test("getItemProperties returns a {value}-wrapped identity for a node", async () => {
         const surface = compatSurfaceFor("data/as1-assembly.step");
         const root = await surface.getSpatialStructure();

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

@@ -1,5 +1,5 @@
 import { IfcAPI } from "./ifc_api.js";
-import { IncludeProperties } from "./properties_passthrough.js";
+import { IncludeProperties, SpatialStructureOptions } from "./properties_passthrough.js";
 export declare class Properties {
     private api;
     private types;
@@ -9,7 +9,7 @@ export declare class Properties {
     getPropertySets(modelID: number, elementID: number, recursive?: boolean): Promise<any[] | undefined>;
     getTypeProperties(modelID: number, elementID: number, recursive?: boolean): Promise<any[] | undefined>;
     getMaterialsProperties(modelID: number, elementID: number, recursive?: boolean): Promise<any[] | undefined>;
-    getSpatialStructure(modelID: number, includeProperties?: IncludeProperties): Promise<import("./properties_passthrough.js").Node | undefined>;
+    getSpatialStructure(modelID: number, includeProperties?: IncludeProperties, options?: SpatialStructureOptions): Promise<import("./properties_passthrough.js").Node | undefined>;
     getAllItemsOfType(modelID: number, type: number, verbose: boolean): Promise<any[] | undefined>;
 }
 //# sourceMappingURL=properties.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/properties.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EACP,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG5D,qBAAa,UAAU;IAIT,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAK;gBAEE,GAAG,EAAE,MAAM;IAG/B,UAAU,CAAC,IAAI,EAAE,MAAM;IAIjB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIhE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIvE,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAI5E,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,iBAAiB;IAK1E,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CAIxE"}
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/properties.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EACP,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAGrF,qBAAa,UAAU;IAIT,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAK;gBAEE,GAAG,EAAE,MAAM;IAG/B,UAAU,CAAC,IAAI,EAAE,MAAM;IAIjB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIhE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIrE,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIvE,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAI5E,mBAAmB,CACrB,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,OAAO,CAAC,EAAE,uBAAuB;IAM/B,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CAIxE"}

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

@@ -18,8 +18,9 @@ export class Properties {
     async getMaterialsProperties(modelID, elementID, recursive = false) {
         return await this.api.getPassthrough(modelID)?.properties.getMaterialsProperties(elementID, recursive);
     }
-    async getSpatialStructure(modelID, includeProperties) {
-        return await this.api.getPassthrough(modelID)?.properties.getSpatialStructure(includeProperties);
+    async getSpatialStructure(modelID, includeProperties, options) {
+        return await this.api.getPassthrough(modelID)?.properties
+            .getSpatialStructure(includeProperties, options);
     }
     async getAllItemsOfType(modelID, type, verbose) {
         return await this.api.getPassthrough(modelID)?.properties.getAllItemsOfType(type, verbose);

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

@@ -24,13 +24,25 @@ export interface Node {
  *   (web-ifc parity behavior).
  */
 export type IncludeProperties = boolean | 'names';
+/**
+ * Optional spatial-structure shaping, beyond web-ifc parity.
+ */
+export interface SpatialStructureOptions {
+    /**
+     * STEP (AP214/AP242) only: surface ephemeral solid-level nodes beneath
+     * multibody products — pickable bodies that carry identity in the file but
+     * no product semantics (`type: 'solid'`, `ephemeral: true`). Ignored by the
+     * IFC surface. See `design/new/step-nonproduct-semantics.md`.
+     */
+    includeSolids?: boolean;
+}
 export interface PropertiesPassthrough {
     getIfcType(type: number): string | undefined;
     getItemProperties(id: number, recursive?: boolean): Promise<any>;
     getPropertySets(elementID: number, recursive?: boolean): Promise<any[]>;
     getTypeProperties(elementID: number, recursive?: boolean): Promise<any[]>;
     getMaterialsProperties(elementID: number, recursive?: boolean): Promise<any[]>;
-    getSpatialStructure(includeProperties?: IncludeProperties): Promise<Node>;
+    getSpatialStructure(includeProperties?: IncludeProperties, options?: SpatialStructureOptions): Promise<Node>;
     getAllItemsOfType(type: number, verbose: boolean): Promise<any[]>;
 }
 //# sourceMappingURL=properties_passthrough.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"properties_passthrough.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/properties_passthrough.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,EAAE,CAAA;IAIhB,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IAEpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,CAAE,CAAA;IAEnE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAE1E,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAE5E,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAEhF,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAE,IAAI,CAAE,CAAA;IAE3E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;CACpE"}
+{"version":3,"file":"properties_passthrough.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/properties_passthrough.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,EAAE,CAAA;IAIhB,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IAEtC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,qBAAqB;IAEpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAE5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,CAAE,CAAA;IAEnE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAE1E,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAI,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAE5E,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;IAEhF,mBAAmB,CACjB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,OAAO,CAAC,EAAE,uBAAuB,GAAI,OAAO,CAAE,IAAI,CAAE,CAAA;IAEtD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAE,GAAG,EAAE,CAAE,CAAA;CACpE"}

package/compiled/src/version/version.js

@@ -5,5 +5,5 @@
 // only the first segment (major) is meaningful and is the one CI carries forward.
 // Must stay in `vN.N.N` shape: the CI stamp regex, scripts/updateVersion.mjs, and
 // statistics.ts all match `v\d+\.\d+\.\d+`.
-const versionString = 'Conway Web-Ifc Shim v1.375.1183';
+const versionString = 'Conway Web-Ifc Shim v1.376.1184';
 export { versionString };