@ifc-lite/parser 5.0.0 → 5.2.0

package/dist/classification-resolver.d.ts

@@ -6,6 +6,16 @@ export interface ClassificationInfo {
     location?: string;
     description?: string;
     path?: string[];
+    /**
+     * True when the relationship graph proves this entity/type carries a
+     * classification association, but the classification's own attributes
+     * (system, identification, name, path) could not be read because this
+     * store has no source bytes — a server-parsed store (issue #3948).
+     * Distinguishes "classified but unresolved" from "genuinely unclassified"
+     * (an empty result array), which are otherwise byte-identical to every
+     * caller. All other fields are left `undefined` on an unresolved entry.
+     */
+    unresolved?: boolean;
 }
 /**
  * Extract classifications for a single entity ON-DEMAND.
@@ -15,9 +25,25 @@ export interface ClassificationInfo {
  * Returns an array of classification references with system info.
  */
 export declare function extractClassificationsOnDemand(store: IfcDataStore, entityId: number): ClassificationInfo[];
+/** Result of {@link extractClassificationSystemsOnDemand}. */
+export interface ClassificationSystemNames {
+    /** Distinct system names, sorted. Empty when the model genuinely has no
+     *  `IfcClassification` entities — check `unresolved` before reading an
+     *  empty array as "no systems". */
+    names: string[];
+    /**
+     * True when the model DOES have `IfcClassification` entities (per the
+     * byType index) but their `Name` could not be read because this store
+     * has no source bytes — a server-parsed store (issue #3948), the same
+     * condition `extractClassificationsOnDemand` signals per-entity via
+     * `ClassificationInfo.unresolved`. When true, `names` is always `[]`
+     * and must not be read as "the model has no classification systems".
+     */
+    unresolved: boolean;
+}
 /**
  * List the distinct classification system names present in a model —
- * CHEAP and EXACT.
+ * CHEAP and EXACT when source bytes are available.
  *
  * Unlike extractClassificationsOnDemand (which resolves classifications for
  * ONE entity by walking its reference chain, and is only reachable through
@@ -30,5 +56,5 @@ export declare function extractClassificationsOnDemand(store: IfcDataStore, enti
  * A model can carry SEVERAL systems at once (e.g. Uniclass, OmniClass, and
  * a national system) — this returns all of them, sorted alphabetically.
  */
-export declare function extractClassificationSystemsOnDemand(store: IfcDataStore): string[];
+export declare function extractClassificationSystemsOnDemand(store: IfcDataStore): ClassificationSystemNames;
 //# sourceMappingURL=classification-resolver.d.ts.map

package/dist/classification-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classification-resolver.d.ts","sourceRoot":"","sources":["../src/classification-resolver.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACjB,kBAAkB,EAAE,CA0EtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAoBlF"}
+{"version":3,"file":"classification-resolver.d.ts","sourceRoot":"","sources":["../src/classification-resolver.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACjB,kBAAkB,EAAE,CA6GtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,yBAAyB;IACtC;;uCAEmC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;;OAOG;IACH,UAAU,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,YAAY,GAAG,yBAAyB,CA2BnG"}

package/dist/classification-resolver.js

@@ -45,8 +45,44 @@ export function extractClassificationsOnDemand(store, entityId) {
     }
     if (!classRefIds || classRefIds.length === 0)
         return [];
-    if (!store.source?.length)
-        return [];
+    if (!store.source?.length) {
+        // Server-parsed / source-empty store: no source bytes to decode the
+        // classification reference's own attributes. The relationship graph
+        // above already proved this entity (or its type) IS classified — the
+        // ids resolved into `classRefIds` are real
+        // `IfcRelAssociatesClassification` targets.
+        //
+        // If the server also forwarded the resolved attributes (issue
+        // #3955), prefer those — real system/identification/name data beats
+        // a marker. Roll up the entity's own row plus its type's (mirroring
+        // the classRefIds roll-up above) so a type-level classification is
+        // not dropped.
+        if (store.resolvedClassifications) {
+            const resolved = [...(store.resolvedClassifications.get(entityId) || [])];
+            if (store.relationships) {
+                const typeIds = store.relationships.getRelated(entityId, RelationshipType.DefinesByType, 'inverse');
+                for (const typeId of typeIds) {
+                    const typeResolved = store.resolvedClassifications.get(typeId);
+                    if (typeResolved)
+                        resolved.push(...typeResolved);
+                }
+            }
+            // The server resolves these rows from the same immutable input
+            // as its graph. Repeated relationships emit repeated rows while
+            // the graph deduplicates edges, so their counts need not match.
+            if (resolved.length > 0)
+                return resolved;
+        }
+        // No forwarded resolved data. Turning an id into
+        // system/identification/name/path needs raw STEP bytes
+        // (`EntityExtractor`), which this store doesn't have. Previously
+        // this silently returned `[]` here, making a classified entity
+        // byte-identical to a genuinely unclassified one (issue #3948).
+        // Surface one unresolved marker per resolved id instead, so callers
+        // — the IDS bridge in particular — can tell "classified, but this
+        // data source can't say more" from "none".
+        return classRefIds.map(() => ({ unresolved: true }));
+    }
     const extractor = new EntityExtractor(store.source);
     const results = [];
     for (const classRefId of classRefIds) {
@@ -89,7 +125,7 @@ export function extractClassificationsOnDemand(store, entityId) {
 }
 /**
  * List the distinct classification system names present in a model —
- * CHEAP and EXACT.
+ * CHEAP and EXACT when source bytes are available.
  *
  * Unlike extractClassificationsOnDemand (which resolves classifications for
  * ONE entity by walking its reference chain, and is only reachable through
@@ -104,8 +140,15 @@ export function extractClassificationsOnDemand(store, entityId) {
  */
 export function extractClassificationSystemsOnDemand(store) {
     const ids = store.entityIndex.byType.get('IFCCLASSIFICATION');
-    if (!ids || ids.length === 0 || !store.source?.length)
-        return [];
+    if (!ids || ids.length === 0)
+        return { names: [], unresolved: false };
+    if (!store.source?.length) {
+        // The model has classification systems (confirmed by the byType
+        // index), but reading their Name needs raw STEP bytes this
+        // server-parsed store doesn't carry. `[]` alone would be
+        // indistinguishable from "no systems" (issue #3948).
+        return { names: [], unresolved: true };
+    }
     const extractor = new EntityExtractor(store.source);
     const names = new Set();
     for (const id of ids) {
@@ -120,7 +163,7 @@ export function extractClassificationSystemsOnDemand(store) {
         if (typeof name === 'string' && name.length > 0)
             names.add(name);
     }
-    return Array.from(names).sort();
+    return { names: Array.from(names).sort(), unresolved: false };
 }
 /**
  * Walk up the IfcClassificationReference chain to find the root IfcClassification system.

package/dist/classification-resolver.js.map

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

package/dist/columnar-entity-preparation.d.ts

@@ -0,0 +1,22 @@
+import type { EntityRef } from './types.js';
+import type { ScannedEntityColumns } from './entity-refs-from-index.js';
+export type ColumnarEntityInput = EntityRef[] | ScannedEntityColumns;
+/** Shared categorization for scanned objects and pre-pass columns. #3985 */
+export declare function prepareColumnarEntities(input: ColumnarEntityInput, deferPropertyAtomIndex: boolean, yieldIfNeeded: () => Promise<void>): Promise<{
+    byType: Map<string, number[]>;
+    getTypeUpper: (type: string) => string;
+    indexedCount: number;
+    propertyAtomCount: number;
+    spatialRefs: EntityRef[];
+    geometryRefs: EntityRef[];
+    relationshipRefs: EntityRef[];
+    propertyRelRefs: EntityRef[];
+    propertyContainerRefs: EntityRef[];
+    associationRelRefs: EntityRef[];
+    typeObjectRefs: EntityRef[];
+    otherRelevantRefs: EntityRef[];
+    groupRefs: EntityRef[];
+    buildPrimaryIndex(): Promise<import("./compact-entity-index.js").CompactEntityIndex>;
+    buildDeferredIndex(): Promise<import("./compact-entity-index.js").CompactEntityIndex | undefined>;
+}>;
+//# sourceMappingURL=columnar-entity-preparation.d.ts.map

package/dist/columnar-entity-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnar-entity-preparation.d.ts","sourceRoot":"","sources":["../src/columnar-entity-preparation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAUxE,MAAM,MAAM,mBAAmB,GAAG,SAAS,EAAE,GAAG,oBAAoB,CAAC;AAErE,4EAA4E;AAC5E,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,sBAAsB,EAAE,OAAO,EAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;;yBAON,MAAM;;;;;;;;;;;;;;GA+JnC"}

package/dist/columnar-entity-preparation.js

@@ -0,0 +1,192 @@
+/* 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 { compactEntityIndexFromColumns } from './compact-entity-index-transport.js';
+import { buildCompactEntityIndexAsync } from './compact-entity-index.js';
+import { selectEntityColumns } from './select-entity-columns.js';
+import { getInheritanceChain } from './ifc-schema.js';
+import { GEOMETRY_TYPES, SPATIAL_TYPES, HIERARCHY_REL_TYPES, PROPERTY_REL_TYPES, PROPERTY_ENTITY_TYPES, PROPERTY_CONTAINER_TYPES, ASSOCIATION_REL_TYPES, isIfcTypeLikeEntity, } from './columnar-parser-indexes.js';
+/** Shared categorization for scanned objects and pre-pass columns. #3985 */
+export async function prepareColumnarEntities(input, deferPropertyAtomIndex, yieldIfNeeded) {
+    // Single pass: build byType index AND categorize entities simultaneously.
+    // Uses a type-name cache to avoid calling .toUpperCase() on 4.4M refs
+    // (only ~776 unique type names in IFC4).
+    const byType = new Map();
+    const typeUpperCache = new Map();
+    const getTypeUpper = (type) => {
+        let upper = typeUpperCache.get(type);
+        if (upper === undefined) {
+            upper = type.toUpperCase();
+            typeUpperCache.set(type, upper);
+        }
+        return upper;
+    };
+    // Non-product helper entities that on-demand extraction / StepExporter
+    // need addressable in `byId`. These are not IfcProduct subtypes so the
+    // schema-driven IFCPRODUCT subtype check below cannot capture them.
+    // Without them, findPreferredGeometricRepresentationContextId() and
+    // findLengthUnitReference() fail because the entities are missing from
+    // the compact entity index.
+    const RELEVANT_NON_PRODUCT_HELPERS = new Set([
+        'IFCGEOMETRICREPRESENTATIONCONTEXT', 'IFCGEOMETRICREPRESENTATIONSUBCONTEXT',
+        'IFCUNITASSIGNMENT', 'IFCSIUNIT', 'IFCCONVERSIONBASEDUNIT',
+        'IFCDERIVEDUNIT', 'IFCDERIVEDUNITELEMENT', 'IFCMEASUREWITHUNIT',
+        'IFCDIMENSIONALEXPONENTS',
+        'IFCMAPCONVERSION', 'IFCPROJECTEDCRS',
+        'IFCMATERIALLAYER', 'IFCMATERIALLAYERSET', 'IFCMATERIALLAYERSETUSAGE',
+        'IFCMATERIALCONSTITUENTSET', 'IFCMATERIALCONSTITUENT',
+        'IFCMATERIALPROFILESET', 'IFCMATERIALPROFILE', 'IFCMATERIAL',
+        'IFCCLASSIFICATION', 'IFCCLASSIFICATIONREFERENCE',
+        'IFCDOCUMENTINFORMATION', 'IFCDOCUMENTREFERENCE',
+    ]);
+    // Schema-driven inclusion: every IfcProduct subtype belongs in the
+    // EntityTable. The previous hardcoded enumeration of IFC4 building-
+    // element leaves (IFCWALL, IFCSLAB, …) and IFC4x3 infrastructure
+    // leaves (IFCREFERENT, IFCSIGNAL, IFCALIGNMENT, IFCPAVEMENT, …) drifted
+    // with every schema bump — new entities silently became CAT_SKIP and
+    // disappeared from the hierarchy panel. The generated schema registry
+    // already knows the full inheritance chain, so use it.
+    const RELEVANT_PRODUCT_ROOTS = new Set(['IFCPRODUCT']);
+    // IfcGroup family (IfcZone, IfcSystem, IfcDistributionSystem,
+    // IfcBuildingSystem, IfcDistributionCircuit, …). These are NOT
+    // IfcProduct subtypes, so without an explicit branch they fall through
+    // to CAT_SKIP and never enter the EntityTable — leaving their Name
+    // unresolvable (`getName` → '') and making them invisible to
+    // `getByType`. The Relationships card then shows "Group #<id>" and the
+    // lens/lists can't surface them. Route them into their own bucket so we
+    // can extract Name/LongName/ObjectType for the group label (#1075).
+    const GROUP_ROOTS = new Set(['IFCGROUP']);
+    // Category constants for the lookup cache
+    const CAT_SKIP = 0, CAT_SPATIAL = 1, CAT_GEOMETRY = 2, CAT_HIERARCHY_REL = 3, CAT_PROPERTY_REL = 4, CAT_PROPERTY_ENTITY = 5, CAT_ASSOCIATION_REL = 6, CAT_TYPE_OBJECT = 7, CAT_RELEVANT = 8, CAT_GROUP = 9;
+    /** Returns true if `upper` (already uppercased) is a subtype of any type in `set`. */
+    function isSubtypeOfAny(upper, set) {
+        const chain = getInheritanceChain(upper);
+        return chain.some(ancestor => set.has(ancestor.toUpperCase()));
+    }
+    // Cache: type name → category (avoids 4.4M .toUpperCase() calls)
+    const typeCategoryCache = new Map();
+    function getCategory(type) {
+        let cat = typeCategoryCache.get(type);
+        if (cat !== undefined)
+            return cat;
+        const upper = getTypeUpper(type);
+        if (SPATIAL_TYPES.has(upper) || isSubtypeOfAny(upper, SPATIAL_TYPES))
+            cat = CAT_SPATIAL;
+        else if (GEOMETRY_TYPES.has(upper) || isSubtypeOfAny(upper, GEOMETRY_TYPES))
+            cat = CAT_GEOMETRY;
+        else if (HIERARCHY_REL_TYPES.has(upper))
+            cat = CAT_HIERARCHY_REL;
+        else if (PROPERTY_REL_TYPES.has(upper))
+            cat = CAT_PROPERTY_REL;
+        else if (PROPERTY_ENTITY_TYPES.has(upper))
+            cat = CAT_PROPERTY_ENTITY;
+        else if (ASSOCIATION_REL_TYPES.has(upper))
+            cat = CAT_ASSOCIATION_REL;
+        else if (isIfcTypeLikeEntity(upper))
+            cat = CAT_TYPE_OBJECT;
+        else if (isSubtypeOfAny(upper, GROUP_ROOTS))
+            cat = CAT_GROUP;
+        else if (RELEVANT_NON_PRODUCT_HELPERS.has(upper)
+            || isSubtypeOfAny(upper, RELEVANT_PRODUCT_ROOTS)
+            || upper.startsWith('IFCREL'))
+            cat = CAT_RELEVANT;
+        else
+            cat = CAT_SKIP;
+        typeCategoryCache.set(type, cat);
+        return cat;
+    }
+    const refs = Array.isArray(input) ? input : undefined;
+    const columns = Array.isArray(input) ? undefined : input;
+    const count = refs ? refs.length : columns.expressIds.length;
+    const spatialRefs = [];
+    const geometryRefs = [];
+    const relationshipRefs = [];
+    const propertyRelRefs = [];
+    const propertyContainerRefs = [];
+    const propertyAtomRefs = [];
+    const deferredRows = [];
+    let propertyAtomCount = 0;
+    const associationRelRefs = [];
+    const typeObjectRefs = [];
+    const otherRelevantRefs = [];
+    const groupRefs = [];
+    for (let i = 0; i < count; i++) {
+        if ((i & 0x3FF) === 0)
+            await yieldIfNeeded();
+        const type = refs ? refs[i].type : columns.typeStrings[columns.typeIndices[i]];
+        const id = refs ? refs[i].expressId : columns.expressIds[i];
+        const cat = getCategory(type);
+        const atom = cat === CAT_PROPERTY_ENTITY && !PROPERTY_CONTAINER_TYPES.has(getTypeUpper(type));
+        if (!deferPropertyAtomIndex || !atom) {
+            const typeKey = getTypeUpper(type);
+            let list = byType.get(typeKey);
+            if (!list) {
+                list = [];
+                byType.set(typeKey, list);
+            }
+            list.push(id);
+        }
+        if (atom) {
+            propertyAtomCount++;
+            if (deferPropertyAtomIndex) {
+                if (refs)
+                    propertyAtomRefs.push(refs[i]);
+                else
+                    deferredRows.push(i);
+            }
+            continue;
+        }
+        // Helper records still remain in both complete indexes. They do not need
+        // a transient EntityRef merely to copy their numeric fields back out.
+        if (cat === CAT_SKIP)
+            continue;
+        const ref = refs ? refs[i] : {
+            expressId: id, type, byteOffset: columns.byteOffsets[i],
+            byteLength: columns.byteLengths[i], lineNumber: 0,
+        };
+        if (cat === CAT_SPATIAL)
+            spatialRefs.push(ref);
+        else if (cat === CAT_GEOMETRY)
+            geometryRefs.push(ref);
+        else if (cat === CAT_HIERARCHY_REL)
+            relationshipRefs.push(ref);
+        else if (cat === CAT_PROPERTY_REL)
+            propertyRelRefs.push(ref);
+        else if (cat === CAT_PROPERTY_ENTITY)
+            propertyContainerRefs.push(ref);
+        else if (cat === CAT_ASSOCIATION_REL)
+            associationRelRefs.push(ref);
+        else if (cat === CAT_TYPE_OBJECT)
+            typeObjectRefs.push(ref);
+        else if (cat === CAT_GROUP)
+            groupRefs.push(ref);
+        else if (cat === CAT_RELEVANT)
+            otherRelevantRefs.push(ref);
+    }
+    const isPrimary = (type) => !deferPropertyAtomIndex
+        || getCategory(type) !== CAT_PROPERTY_ENTITY || PROPERTY_CONTAINER_TYPES.has(getTypeUpper(type));
+    const indexedCount = count - (deferPropertyAtomIndex ? propertyAtomCount : 0);
+    return {
+        byType, getTypeUpper, indexedCount, propertyAtomCount,
+        spatialRefs, geometryRefs, relationshipRefs, propertyRelRefs,
+        propertyContainerRefs, associationRelRefs, typeObjectRefs, otherRelevantRefs, groupRefs,
+        async buildPrimaryIndex() {
+            if (refs)
+                return buildCompactEntityIndexAsync(deferPropertyAtomIndex ? refs.filter(ref => isPrimary(ref.type)) : refs);
+            if (!deferPropertyAtomIndex || propertyAtomCount === 0)
+                return compactEntityIndexFromColumns({
+                    ...columns, typeIndices: columns.typeIndices instanceof Uint16Array
+                        ? columns.typeIndices : Uint16Array.from(columns.typeIndices),
+                });
+            return selectEntityColumns(columns, indexedCount, isPrimary);
+        },
+        async buildDeferredIndex() {
+            if (!deferPropertyAtomIndex || propertyAtomCount === 0)
+                return undefined;
+            if (refs)
+                return buildCompactEntityIndexAsync(propertyAtomRefs, undefined, 1024, 2);
+            return selectEntityColumns(columns, propertyAtomCount, undefined, deferredRows, 1024, 2);
+        },
+    };
+}
+//# sourceMappingURL=columnar-entity-preparation.js.map

package/dist/columnar-entity-preparation.js.map

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

package/dist/columnar-parser-root-attributes.d.ts

@@ -0,0 +1,66 @@
+import type { EntityRef } from './types.js';
+import type { IfcEntity, IfcAttributeValue } from '@ifc-lite/data';
+import type { IfcDataStore } from './columnar-parser.js';
+export declare function getEntityRefFromStore(store: IfcDataStore, expressId: number): EntityRef | undefined;
+/**
+ * Extract entity attributes on-demand from source buffer.
+ * Returns globalId, name, description, objectType, tag mapped by schema name
+ * (see {@link extractRootAttributesFromEntity}), so the result stays correct
+ * for entity types whose attribute order differs from the IfcElement layout.
+ * This is used for entities that weren't fully parsed during initial load.
+ */
+export declare function extractEntityAttributesOnDemand(store: IfcDataStore, entityId: number): {
+    globalId: string;
+    name: string;
+    description: string;
+    objectType: string;
+    tag: string;
+};
+/**
+ * Extract ALL named entity attributes on-demand from source buffer.
+ * Uses the IFC schema to map attribute indices to names.
+ * Returns only string/enum attributes, skipping references and structural attributes.
+ */
+export declare function extractAllEntityAttributes(store: IfcDataStore, entityId: number): Array<{
+    name: string;
+    value: string | number | boolean;
+}>;
+/**
+ * Returns named raw attribute pairs for an entity, filtered to display-relevant attributes.
+ * Skips structural/reference attributes using the IFC schema. Used by query layer for coercion.
+ */
+export declare function getRawNamedAttributes(entity: IfcEntity): Array<{
+    name: string;
+    raw: IfcAttributeValue;
+}>;
+/**
+ * Resolve the common IfcRoot-family display attributes (GlobalId, Name,
+ * Description, ObjectType, Tag) from an entity's raw attribute array.
+ *
+ * These are mapped by schema-derived attribute *name*, not fixed index. The
+ * fixed indices `[0],[2],[3],[4],[7]` only hold for the IfcElement layout: for
+ * a spatial element `attrs[7]` is LongName (not Tag), and for a resource entity
+ * like IfcMaterial `attrs[0]` is Name (not GlobalId). Name-mapping keeps all of
+ * these correct for every entity type, returning '' for attributes the type
+ * does not declare.
+ *
+ * For types the schema registry does not recognise (e.g. an IFC4x3 infra leaf
+ * outside the codegen pin, or a vendor extension) we fall back to the canonical
+ * IfcRoot/IfcElement positions so we never regress vs. the old fixed-index path.
+ */
+export declare function extractRootAttributesFromEntity(entity: IfcEntity): {
+    globalId: string;
+    name: string;
+    description: string;
+    objectType: string;
+    tag: string;
+};
+/**
+ * Resolve an entity's LongName (IfcZone, IfcSystem subtypes, IfcSpatialZone,
+ * IfcBuildingSystem, …) by schema attribute name. Groups frequently leave Name
+ * empty and carry their human label in LongName, so consumers fall back to this
+ * for the display label. Returns '' when the type does not declare LongName.
+ * (#1075)
+ */
+export declare function pickLongName(entity: IfcEntity): string;
+//# sourceMappingURL=columnar-parser-root-attributes.d.ts.map

package/dist/columnar-parser-root-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnar-parser-root-attributes.d.ts","sourceRoot":"","sources":["../src/columnar-parser-root-attributes.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEnG;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC3C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACjB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAa1F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,CAoG3D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,SAAS,GAClB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAYjD;AAoCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC3C,MAAM,EAAE,SAAS,GAClB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA0B1F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAKtD"}