@bldrs-ai/conway 1.346.1102 → 1.347.1107

package/compiled/src/AP214E3_2010/ap214_property_extraction.js

@@ -0,0 +1,143 @@
+import { AP214ProductStructureExtraction } from "./ap214_product_structure_extraction.js";
+import { descriptive_representation_item } from "./AP214E3_2010_gen/descriptive_representation_item.gen.js";
+import { general_property } from "./AP214E3_2010_gen/general_property.gen.js";
+import { general_property_association } from "./AP214E3_2010_gen/general_property_association.gen.js";
+import { measure_representation_item } from "./AP214E3_2010_gen/measure_representation_item.gen.js";
+import { property_definition } from "./AP214E3_2010_gen/property_definition.gen.js";
+import { property_definition_representation } from "./AP214E3_2010_gen/property_definition_representation.gen.js";
+import { shape_definition_representation } from "./AP214E3_2010_gen/shape_definition_representation.gen.js";
+/**
+ * Extracts STEP part properties from a populated {@link AP214StepModel}.
+ *
+ * Walks the property chain
+ * `general_property` → (`general_property_association`) → `property_definition`
+ * → `property_definition_representation` → `representation` →
+ * `descriptive_representation_item` / `measure_representation_item` into
+ * per-part key/value rows. Includes the NIST validation properties
+ * (`geometric/attribute validation property`, e.g. volume via
+ * `measure_representation_item`).
+ *
+ * Mirrors the IFC precedent (`src/ifc/ifc_property_extraction.ts`); feeds the
+ * web-ifc compat surface `ap214_properties.ts` that Share consumes.
+ */
+export class AP214PropertyExtraction {
+    /**
+     * @param model The populated AP214/AP242 step model to walk.
+     */
+    constructor(model) {
+        this.model = model;
+        this.generalPropertyNameByDef_ = new Map();
+    }
+    /**
+     * Build the per-part property map.
+     *
+     * @return {ExtractedPropertyMap} Properties keyed by owning
+     * `product_definition` express id. Properties whose owner is a feature
+     * (`shape_aspect`, dimensions) rather than a part are skipped at this
+     * (Simplified) tier — they belong to the Full PMI tier.
+     */
+    extractProperties() {
+        this.indexGeneralPropertyNames();
+        const result = new Map();
+        for (const element of this.model.types(property_definition_representation)) {
+            // shape_definition_representation is a subtype: its representation holds
+            // geometry, not properties — skip it here, geometry extraction owns it.
+            if (element instanceof shape_definition_representation) {
+                continue;
+            }
+            const pdr = element;
+            this.collectFromRepresentation(pdr, result);
+        }
+        return result;
+    }
+    /**
+     * Index general-property names by the express id of the `property_definition`
+     * they are associated with, so a property can carry the canonical
+     * `general_property` label when one exists.
+     */
+    indexGeneralPropertyNames() {
+        for (const element of this.model.types(general_property_association)) {
+            const association = element;
+            const base = association.base_definition;
+            const derived = association.derived_definition;
+            if (!(base instanceof general_property) ||
+                !(derived instanceof property_definition)) {
+                continue;
+            }
+            const definitionId = derived.expressID;
+            if (definitionId !== void 0 && base.name.length > 0) {
+                this.generalPropertyNameByDef_.set(definitionId, base.name);
+            }
+        }
+    }
+    /**
+     * Resolve the part owner and value rows for one
+     * `property_definition_representation` and append them to the result map.
+     *
+     * @param pdr The property-definition representation to walk.
+     * @param result The accumulating per-part property map.
+     */
+    collectFromRepresentation(pdr, result) {
+        const propertyDefinition = pdr.definition;
+        if (!(propertyDefinition instanceof property_definition)) {
+            return;
+        }
+        const ownerId = AP214ProductStructureExtraction.resolveProductDefinitionId(propertyDefinition.definition);
+        if (ownerId === void 0) {
+            return;
+        }
+        const definitionId = propertyDefinition.expressID;
+        const group = propertyDefinition.name;
+        const fallbackKey = (definitionId !== void 0 ? this.generalPropertyNameByDef_.get(definitionId) : void 0) ??
+            (group.length > 0 ? group : (propertyDefinition.description ?? ""));
+        const representation = pdr.used_representation;
+        if (representation === void 0) {
+            return;
+        }
+        for (const item of representation.items) {
+            const property = AP214PropertyExtraction.toProperty(item, fallbackKey, group);
+            if (property === void 0) {
+                continue;
+            }
+            let rows = result.get(ownerId);
+            if (rows === void 0) {
+                rows = [];
+                result.set(ownerId, rows);
+            }
+            rows.push(property);
+        }
+    }
+    /**
+     * Convert a representation item into a property row, or `undefined` for item
+     * kinds that carry no key/value (e.g. a centroid `cartesian_point`).
+     *
+     * @param item The representation item to convert.
+     * @param fallbackKey Key to use when the item itself is unnamed.
+     * @param group Grouping label from the owning property definition.
+     * @return {ExtractedProperty | undefined} The property row, or `undefined`.
+     */
+    static toProperty(item, fallbackKey, group) {
+        const key = item.name.length > 0 ? item.name : fallbackKey;
+        const expressID = item.expressID;
+        if (item instanceof descriptive_representation_item) {
+            // Skip a descriptive item with no value — it would surface as a blank
+            // key/value row in the Properties panel where there is nothing to show.
+            if (item.description.length === 0) {
+                return void 0;
+            }
+            return { name: key, value: item.description, group, expressID };
+        }
+        if (item instanceof measure_representation_item) {
+            // `value_component` is a `measure_value` SELECT: most members carry a
+            // numeric `.Value`, but `descriptive_measure` / `context_dependent_measure`
+            // carry a string. Only treat a genuinely numeric value as `numericValue`
+            // so a textual measure doesn't end up typed as a number downstream.
+            const rawValue = item.value_component.Value;
+            if (typeof rawValue === "number") {
+                return { name: key, value: String(rawValue), numericValue: rawValue, group, expressID };
+            }
+            return { name: key, value: String(rawValue), group, expressID };
+        }
+        return void 0;
+    }
+}

package/compiled/src/AP214E3_2010/ap214_property_extraction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ap214_property_extraction.test.d.ts.map

package/compiled/src/AP214E3_2010/ap214_property_extraction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ap214_property_extraction.test.d.ts","sourceRoot":"","sources":["../../../src/AP214E3_2010/ap214_property_extraction.test.ts"],"names":[],"mappings":""}

package/compiled/src/AP214E3_2010/ap214_property_extraction.test.js

@@ -0,0 +1,56 @@
+import fs from "fs";
+import { describe, expect, test } from "@jest/globals";
+import AP214StepParser from "./ap214_step_parser.js";
+import ParsingBuffer from "../parsing/parsing_buffer.js";
+import { ParseResult } from "../step/parsing/step_parser.js";
+import { AP214PropertyExtraction, } from "./ap214_property_extraction.js";
+const parser = AP214StepParser.Instance;
+/** Express id of the single part (`product_definition`) in the CTC fixture. */
+const CTC_PRODUCT_DEFINITION_EXPRESS_ID = 4368;
+/** Expected volume validation value for the CTC fixture. */
+const CTC_VOLUME_MEASURE = 14644822.6361138;
+/**
+ * Parse the hermetic CTC properties fixture and extract its property map.
+ *
+ * @return {ExtractedPropertyMap} Properties keyed by owning product definition.
+ */
+function extractCtcProperties() {
+    const buffer = fs.readFileSync("data/nist-ctc-properties.step");
+    const bufferInput = new ParsingBuffer(buffer);
+    const headerResult = parser.parseHeader(bufferInput)[1];
+    expect(headerResult).toBe(ParseResult.COMPLETE);
+    const [result, model] = parser.parseDataToModel(bufferInput);
+    expect(model).not.toBe(void 0);
+    expect(result === ParseResult.COMPLETE || result === ParseResult.INCOMPLETE).toBe(true);
+    return new AP214PropertyExtraction(model).extractProperties();
+}
+/**
+ * Find a property by key among a part's property rows.
+ *
+ * @param rows The property rows for a part.
+ * @param name The property key to find.
+ * @return {ExtractedProperty} The matching property row.
+ */
+function property(rows, name) {
+    const found = rows.find((row) => row.name === name);
+    expect(found).not.toBe(void 0);
+    return found;
+}
+describe("AP214PropertyExtraction", () => {
+    test("attaches properties to the owning product definition", () => {
+        const properties = extractCtcProperties();
+        expect(properties.has(CTC_PRODUCT_DEFINITION_EXPRESS_ID)).toBe(true);
+    });
+    test("extracts the NIST attribute key/values", () => {
+        const rows = extractCtcProperties().get(CTC_PRODUCT_DEFINITION_EXPRESS_ID);
+        expect(property(rows, "Modeled By").value).toBe("Engineer");
+        expect(property(rows, "CAGE Code").value).toBe("64JW1");
+        expect(property(rows, "Company").value).toBe("ACME");
+    });
+    test("extracts the geometric validation volume property", () => {
+        const rows = extractCtcProperties().get(CTC_PRODUCT_DEFINITION_EXPRESS_ID);
+        const volume = property(rows, "volume measure");
+        expect(volume.numericValue).toBeCloseTo(CTC_VOLUME_MEASURE);
+        expect(volume.group).toBe("geometric validation property");
+    });
+});

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

@@ -1,21 +1,148 @@
 import { IfcApiProxyAP214 } from "./ifc_api_proxy_ap214.js";
-interface Node {
-    expressID: number;
-    type: string;
-    children: Node[];
-}
+import { Node } from "./properties_passthrough.js";
+/**
+ * web-ifc-compatible property/spatial surface over an AP214/AP242 step model.
+ *
+ * Backed by {@link AP214ProductStructureExtraction} and
+ * {@link AP214PropertyExtraction}: `getSpatialStructure` returns the real
+ * nested, named, occurrence-keyed tree (replacing the old flat, nameless stub);
+ * `getItemProperties` / `getPropertySets` return the extracted attribute and
+ * validation rows; `getAllItemsOfType` is backed by the model type index.
+ *
+ * This is the seam Share consumes (via `IfcApiProxyAP214`); nothing in Share
+ * changes — it lights up the moment this returns a real tree.
+ */
 export declare class AP214Properties {
     private api;
-    private types;
+    private structureRoots_?;
+    private propertyMap_?;
+    private ownerByExpressID_?;
+    private nodeNameByExpressID_?;
+    private propertyByItemId_?;
+    /**
+     * @param api The AP214 passthrough proxy owning the step model.
+     */
     constructor(api: IfcApiProxyAP214);
+    /**
+     * No-op type-name lookup retained for interface compatibility; AP214 surfaces
+     * STEP entity names directly on the nodes.
+     *
+     * @param type The numeric type code.
+     * @return {string} The empty string (AP214 has no IFC type-name map).
+     */
     getIfcType(type: number): string;
-    getItemProperties(id: number, recursive?: boolean): Promise<void>;
-    getPropertySets(elementID: number, recursive?: boolean): Promise<never[]>;
-    getTypeProperties(elementID: number, recursive?: boolean): Promise<never[]>;
-    getMaterialsProperties(elementID: number, recursive?: boolean): Promise<never[]>;
+    /**
+     * Resolve one express id to a web-ifc-shaped item, dispatching on what the id
+     * denotes:
+     *
+     * - a **property single** (a `descriptive_/measure_representation_item` id,
+     *   referenced from a pset's `HasProperties`) → `{ expressID, Name: {value},
+     *   NominalValue: {value} }`, the shape `unpackHelper` reads after it
+     *   dereferences a `HasProperties` handle;
+     * - a **tree node** (NAUO occurrence id, or `product_definition[_shape]` id
+     *   for single-part files) → `{ expressID, Name: {value} }`, the part's
+     *   identity row.
+     *
+     * Property-single ids and node ids are disjoint (distinct STEP entities), so
+     * the lookup is unambiguous.
+     *
+     * @param id Express id to resolve.
+     * @param recursive Unused; kept for web-ifc signature parity.
+     * @return {Promise<object>} The web-ifc-shaped item.
+     */
+    getItemProperties(id: number, recursive?: boolean): Promise<object>;
+    /**
+     * Get a part's property sets: one `IfcPropertySet`-shaped set per grouping
+     * label (plain attributes vs. validation properties). Each set's
+     * `HasProperties` is an array of web-ifc reference handles
+     * (`{ type: 5, value: itemExpressID }`) that Share's Properties panel resolves
+     * back to individual properties via `getItemProperties` — emitting inline
+     * property objects instead would trip `unpackHelper`'s reference-type guard.
+     *
+     * @param elementID Node express id.
+     * @param recursive Unused; kept for web-ifc signature parity.
+     * @return {Promise<any[]>} The property sets for the element.
+     */
+    getPropertySets(elementID: number, recursive?: boolean): Promise<any[]>;
+    /**
+     * Type properties are not modeled for AP214 at the Simplified tier.
+     *
+     * @param elementID Node express id.
+     * @param recursive Unused; kept for web-ifc signature parity.
+     * @return {Promise<any[]>} An empty array.
+     */
+    getTypeProperties(elementID: number, recursive?: boolean): Promise<any[]>;
+    /**
+     * Material properties are not modeled for AP214 at the Simplified tier.
+     *
+     * @param elementID Node express id.
+     * @param recursive Unused; kept for web-ifc signature parity.
+     * @return {Promise<any[]>} An empty array.
+     */
+    getMaterialsProperties(elementID: number, recursive?: boolean): Promise<any[]>;
+    /**
+     * Get the real nested, named, occurrence-keyed product structure.
+     *
+     * @param includeProperties When true, merge each node's item properties onto
+     * the node (mirrors the IFC surface's `includeProperties`).
+     * @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.
+     */
     getSpatialStructure(includeProperties?: boolean): Promise<Node>;
-    getAllItemsOfType(type: number, verbose: boolean): Promise<never[]>;
-    private static newAP214Product;
+    /**
+     * Get every element of a STEP entity type, backed by the model type index.
+     *
+     * @param type The numeric AP214 entity type id.
+     * @param verbose When true, return raw line data; otherwise express ids.
+     * @return {Promise<any[]>} The matching elements (ids or raw lines).
+     */
+    getAllItemsOfType(type: number, verbose: boolean): Promise<any[]>;
+    /**
+     * Convert an extracted structure node into a spatial node for the compat
+     * surface, recursing into children.
+     *
+     * @param node The extracted product-structure node.
+     * @param includeProperties When true, merge the node's item properties.
+     * @return {Promise<AP214Node>} The converted spatial node.
+     */
+    private toSpatialNode;
+    /**
+     * Resolve the property rows for an element, mapping an occurrence node id back
+     * to its owning product definition (where properties are keyed).
+     *
+     * @param id Node express id.
+     * @return {AP214PropertyRow[]} The element's property rows (possibly empty).
+     */
+    private rowsForElement;
+    /**
+     * Lazily build and cache every index the surface reads in one pass:
+     * - `structureRoots_` — the assembly forest;
+     * - `ownerByExpressID_` — node id → owning product-definition id (where the
+     *   property map is keyed);
+     * - `nodeNameByExpressID_` — node id → display name (for `getItemProperties`
+     *   identity rows);
+     * - `propertyByItemId_` — representation-item id → property (so a pset's
+     *   `HasProperties` reference resolves back to its key/value).
+     */
+    private buildIndexes;
+    /**
+     * Record a node's owning product-definition id and display name, recursing
+     * into children.
+     *
+     * @param node The node to index.
+     */
+    private indexNodes;
+    /**
+     * Return the cached product-structure forest, building the indexes if needed.
+     *
+     * @return {ProductStructureNode[]} The cached assembly roots.
+     */
+    private productStructure;
+    /**
+     * Lazily build and cache the extracted property map.
+     *
+     * @return {ExtractedPropertyMap} The cached per-part property map.
+     */
+    private properties;
 }
-export {};
 //# sourceMappingURL=ap214_properties.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ap214_properties.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ap214_properties.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,UAAU,IAAI;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,EAAE,CAAA;CACnB;AAED,qBAAa,eAAe;IAId,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,KAAK,CAAK;gBAEE,GAAG,EAAE,gBAAgB;IAGzC,UAAU,CAAC,IAAI,EAAE,MAAM;IAIjB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,UAAQ;IAI/C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAIpD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAItD,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ;IAI3D,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,OAAO;IA0B/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKtD,OAAO,CAAC,MAAM,CAAC,eAAe;CAO/B"}
+{"version":3,"file":"ap214_properties.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ap214_properties.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AA0E/C;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAWb,OAAO,CAAC,GAAG;IATxB,OAAO,CAAC,eAAe,CAAC,CAAwB;IAChD,OAAO,CAAC,YAAY,CAAC,CAAsB;IAC3C,OAAO,CAAC,iBAAiB,CAAC,CAAqB;IAC/C,OAAO,CAAC,oBAAoB,CAAC,CAAqB;IAClD,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAE1D;;OAEG;gBACkB,GAAG,EAAE,gBAAgB;IAG1C;;;;;;OAMG;IACH,UAAU,CAAE,IAAI,EAAE,MAAM,GAAI,MAAM;IAIlC;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CAAE,EAAE,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAI,OAAO,CAAC,MAAM,CAAC;IAoBzE;;;;;;;;;;;OAWG;IACG,eAAe,CAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAkD7E;;;;;;OAMG;IACG,iBAAiB,CAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAI/E;;;;;;OAMG;IACG,sBAAsB,CAAE,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAIpF;;;;;;;OAOG;IACG,mBAAmB,CAAE,iBAAiB,CAAC,EAAE,OAAO,GAAI,OAAO,CAAC,IAAI,CAAC;IAuBvE;;;;;;OAMG;IACG,iBAAiB,CAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAmBzE;;;;;;;OAOG;YACW,aAAa;IAwB3B;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAQnB"}