@ifc-lite/parser 2.1.8 → 2.2.0

package/README.md

@@ -1,30 +1,6 @@
 # @ifc-lite/parser
 
-High-performance IFC parser with **100% schema coverage** via code generation.
-
-## Features
-
-### Core Parser (Existing)
-- ✅ Fast byte-level STEP tokenization (~1,259 MB/s)
-- ✅ Entity extraction with lazy evaluation
-- ✅ Property and quantity extraction
-- ✅ Relationship graph building
-- ✅ Spatial hierarchy with elevation support
-- ✅ Style and material appearance
-- ✅ Columnar storage (TypedArrays)
-
-### NEW: 100% Schema Coverage
-- ✅ **776 IFC4 entities** (auto-generated from EXPRESS schemas)
-- ✅ **397 type definitions**
-- ✅ **207 enumerations**
-- ✅ **60 SELECT union types**
-- ✅ Full TypeScript type safety
-- ✅ Runtime schema metadata
-
-### NEW: Advanced Extractors
-- ✅ **Materials Extractor** - IfcMaterial, layers, profiles, constituents
-- ✅ **Georeferencing Extractor** - Coordinate transformations, CRS support
-- ✅ **Classification Extractor** - Uniclass, Omniclass, MasterFormat, etc.
+High-performance IFC parser. Tokenizes STEP files at ~1,259 MB/s, builds columnar TypedArray storage, and ships full type-safe coverage of IFC4 (776 entities) and IFC4X3 (876 entities).
 
 ## Installation
 
@@ -32,7 +8,7 @@ High-performance IFC parser with **100% schema coverage** via code generation.
 npm install @ifc-lite/parser
 ```
 
-## Quick Start
+## Parse a file
 
 ```typescript
 import { IfcParser } from '@ifc-lite/parser';
@@ -40,287 +16,102 @@ import { IfcParser } from '@ifc-lite/parser';
 const parser = new IfcParser();
 const buffer = await fetch('model.ifc').then(r => r.arrayBuffer());
 
-// Parse with progress tracking
+const t0 = performance.now();
 const result = await parser.parse(buffer, {
-  onProgress: ({ phase, percent }) => {
-    console.log(`${phase}: ${percent.toFixed(1)}%`);
-  }
+  onProgress: ({ phase, percent }) => console.log(`${phase}: ${percent.toFixed(1)}%`),
 });
 
-console.log(`Parsed ${result.entityCount} entities`);
+console.log(`Parsed ${result.entityCount} entities in ${(performance.now() - t0).toFixed(0)}ms`);
 ```
 
-## Usage
-
-### Basic Entity Access
-
-```typescript
-import type { IfcWall, IfcDoor, IfcWindow } from '@ifc-lite/parser';
-
-// Type-safe entity access with full IntelliSense
-const walls = result.entities.values();
-for (const wall of walls) {
-  if (wall.type === 'IfcWall') {
-    console.log(wall.name);
-    // TypeScript knows all IfcWall attributes!
-  }
-}
-```
-
-### Schema Metadata
+For columnar storage (TypedArray-backed, query-friendly, recommended for models > 10 MB):
 
 ```typescript
-import { SCHEMA_REGISTRY, getEntityMetadata } from '@ifc-lite/parser';
-
-// Get metadata for any entity type
-const wallMeta = getEntityMetadata('IfcWall');
-
-console.log(wallMeta.parent);  // 'IfcBuildingElement'
-console.log(wallMeta.inheritanceChain);  // Full chain from IfcRoot
-console.log(wallMeta.allAttributes);  // All attributes including inherited
+const store = await parser.parseColumnar(buffer);
 
-// Check if a type is known
-import { isKnownEntity } from '@ifc-lite/parser';
-console.log(isKnownEntity('IfcWall'));  // true
-console.log(isKnownEntity('IfcFoo'));   // false
+// store.entities    — typed access by expressId
+// store.properties  — flattened pset table
+// store.quantities  — flattened qset table
+// store.spatialHierarchy.byStorey  — Map<storeyId, Set<elementId>>
+console.log(`${store.entityCount} entities, schema ${store.schemaVersion}`);
 ```
 
-### Materials Extraction (NEW!)
-
-```typescript
-import { extractMaterials, getMaterialNameForElement } from '@ifc-lite/parser';
-
-// Extract all material definitions
-const materialsData = extractMaterials(result.entities, entitiesByType);
-
-console.log(`Materials: ${materialsData.materials.size}`);
-console.log(`Layer sets: ${materialsData.materialLayerSets.size}`);
-console.log(`Associations: ${materialsData.associations.length}`);
-
-// Get material for a specific wall
-const wallId = 12345;
-const materialName = getMaterialNameForElement(wallId, materialsData);
-console.log(`Wall material: ${materialName}`);  // e.g., "Concrete C30/37"
-
-// Access material details
-for (const [id, material] of materialsData.materials) {
-  console.log(`${material.name}: ${material.description}`);
-}
-
-// Access layer sets (multi-layer walls, roofs, etc.)
-for (const [id, layerSet] of materialsData.materialLayerSets) {
-  console.log(`${layerSet.name}: ${layerSet.totalThickness}m total`);
-  for (const layerId of layerSet.layers) {
-    const layer = materialsData.materialLayers.get(layerId);
-    console.log(`  - ${layer?.name}: ${layer?.thickness}m`);
-  }
-}
-```
+## Type-safe entity access
 
-### Georeferencing (NEW!)
+All 776 IFC4 entities (876 for IFC4X3) ship as TypeScript types via the generated schema.
 
 ```typescript
-import {
-  extractGeoreferencing,
-  transformToWorld,
-  getCoordinateSystemDescription
-} from '@ifc-lite/parser';
-
-// Extract georeferencing info
-const georef = extractGeoreferencing(result.entities, entitiesByType);
-
-if (georef.hasGeoreference) {
-  console.log(getCoordinateSystemDescription(georef));
-  // e.g., "EPSG:32610 (UTM Zone 10N) Datum: WGS84 Origin: (500000, 4000000, 100)"
-
-  // Transform local coordinates to world coordinates
-  const localPoint: [number, number, number] = [10, 20, 5];
-  const worldPoint = transformToWorld(localPoint, georef);
-  console.log(`World coordinates: ${worldPoint}`);  // Real-world coordinates
-
-  // Access CRS details
-  console.log(`Projection: ${georef.projectedCRS?.mapProjection}`);
-  console.log(`Datum: ${georef.projectedCRS?.geodeticDatum}`);
-  console.log(`Zone: ${georef.projectedCRS?.mapZone}`);
-}
+import type { IfcWall, IfcDoor, IfcSlab } from '@ifc-lite/parser';
+import { isKnownEntity, getEntityMetadata } from '@ifc-lite/parser';
+
+// Schema metadata
+const meta = getEntityMetadata('IfcWall');
+console.log(meta.parent);              // 'IfcBuildingElement'
+console.log(meta.inheritanceChain);    // ['IfcRoot', ..., 'IfcWall']
+console.log(meta.allAttributes);       // every attribute including inherited
+
+// Schema membership check
+console.log(isKnownEntity('IfcWall'));     // true
+console.log(isKnownEntity('IfcWidget'));   // false
 ```
 
-### Classifications (NEW!)
+## On-demand property extraction
+
+Properties and quantities are extracted lazily — pay only for what you read.
 
 ```typescript
 import {
-  extractClassifications,
-  getClassificationsForElement,
-  getClassificationPath,
-  groupElementsByClassification,
+  extractPropertiesOnDemand,
+  extractQuantitiesOnDemand,
+  extractMaterialsOnDemand,
+  extractClassificationsOnDemand,
 } from '@ifc-lite/parser';
 
-// Extract all classifications
-const classificationsData = extractClassifications(result.entities, entitiesByType);
-
-console.log(`Systems: ${classificationsData.classifications.size}`);
-console.log(`References: ${classificationsData.classificationReferences.size}`);
-
-// Get classifications for a specific element
 const wallId = 12345;
-const classifications = getClassificationsForElement(wallId, classificationsData);
 
-for (const classification of classifications) {
-  console.log(`Code: ${classification.identification}`);
-  console.log(`Name: ${classification.name}`);
+const psets = extractPropertiesOnDemand(store, wallId);
+//   [{ name: 'Pset_WallCommon', properties: [{ name: 'FireRating', value: 'REI 60' }, ...] }]
 
-  // Get full classification path
-  const path = getClassificationPath(classification.id, classificationsData);
-  console.log(`Path: ${path.join(' > ')}`);
-  // e.g., "Uniclass 2015 > Pr > Pr_60 > Pr_60_10 > Pr_60_10_32"
-}
+const qsets = extractQuantitiesOnDemand(store, wallId);
+//   [{ name: 'Qto_WallBaseQuantities', quantities: [{ name: 'Length', value: 5.0 }, ...] }]
 
-// Group elements by classification code
-const groups = groupElementsByClassification(classificationsData);
-for (const [code, elementIds] of groups) {
-  console.log(`${code}: ${elementIds.length} elements`);
-}
-```
+const material = extractMaterialsOnDemand(store, wallId);
+//   { name: 'Concrete C30/37', layers: [{ name: 'Concrete', thickness: 0.15 }, ...] }
 
-### Comprehensive Extraction
-
-```typescript
-import { extractCompleteIfcData, getEnrichedElementInfo } from '@ifc-lite/parser/examples/comprehensive-extraction';
-
-// Extract everything in one call
-const completeData = extractCompleteIfcData(result.entities, entitiesByType);
-
-// Get enriched info for any element (with materials, classifications, world coords)
-const wallInfo = getEnrichedElementInfo(wallId, completeData);
-
-console.log(wallInfo);
-// {
-//   id: 12345,
-//   type: 'IfcWall',
-//   name: 'Wall-001',
-//   inheritanceChain: ['IfcRoot', 'IfcObject', 'IfcProduct', 'IfcElement', 'IfcBuildingElement', 'IfcWall'],
-//   material: {
-//     name: 'Concrete C30/37',
-//     type: 'LayerSet',
-//     layers: [
-//       { material: 'Concrete', thickness: 0.15 },
-//       { material: 'Insulation', thickness: 0.10 },
-//     ]
-//   },
-//   classifications: [
-//     { system: 'Uniclass 2015', code: 'Pr_60_10_32', name: 'External walls', path: [...] }
-//   ],
-//   worldCoordinates: [500010, 4000020, 105],
-//   properties: { ... },
-//   quantities: { ... }
-// }
+const classifications = extractClassificationsOnDemand(store, wallId);
+//   [{ system: 'Uniclass 2015', code: 'Pr_60_10_32', name: 'External walls', ... }]
 ```
 
-## API Reference
-
-### Core Classes
-
-- **`IfcParser`** - Main parser class
-- **`StepTokenizer`** - Fast STEP file tokenizer
-- **`EntityExtractor`** - Entity extraction with lazy evaluation
-- **`PropertyExtractor`** - Property set extraction
-- **`QuantityExtractor`** - Quantity set extraction
-- **`RelationshipExtractor`** - Relationship graph building
-- **`SpatialHierarchyBuilder`** - Spatial hierarchy building
-- **`StyleExtractor`** - Material and color extraction
-
-### NEW: Advanced Extractors
-
-- **`extractMaterials()`** - Extract all material definitions
-- **`extractGeoreferencing()`** - Extract coordinate system info
-- **`extractClassifications()`** - Extract classification systems
-
-### NEW: Generated Schema
-
-- **`SCHEMA_REGISTRY`** - Complete IFC4 schema metadata (776 entities)
-- **`getEntityMetadata()`** - Get metadata for any entity type
-- **`getAllAttributesForEntity()`** - Get all attributes including inherited
-- **`getInheritanceChainForEntity()`** - Get full inheritance chain
-- **`isKnownEntity()`** - Check if entity type exists in schema
-
-### Types (100% Coverage)
-
-All 776 IFC4 entities are available as TypeScript types:
+## Georeferencing
 
 ```typescript
-import type {
-  // Spatial
-  IfcProject, IfcSite, IfcBuilding, IfcBuildingStorey, IfcSpace,
-
-  // Building Elements
-  IfcWall, IfcDoor, IfcWindow, IfcSlab, IfcColumn, IfcBeam,
-  IfcStair, IfcRoof, IfcRailing, IfcCurtainWall,
-
-  // Materials (NEW!)
-  IfcMaterial, IfcMaterialLayer, IfcMaterialLayerSet,
-  IfcMaterialProfile, IfcMaterialProfileSet,
-  IfcMaterialConstituent, IfcMaterialConstituentSet,
-
-  // Georeferencing (NEW!)
-  IfcMapConversion, IfcProjectedCRS, IfcGeometricRepresentationContext,
+import { extractGeoreferencingOnDemand } from '@ifc-lite/parser';
 
-  // Classifications (NEW!)
-  IfcClassification, IfcClassificationReference,
+const georef = extractGeoreferencingOnDemand(store);
 
-  // Infrastructure (IFC4X3 - 876 entities)
-  IfcRoad, IfcBridge, IfcRailway, IfcTunnel, IfcAlignment,
-
-  // ... and 770+ more entities!
-} from '@ifc-lite/parser';
+if (georef?.hasGeoreference) {
+  console.log(`CRS: ${georef.projectedCRS?.name}`);
+  console.log(`Origin: ${georef.eastings}, ${georef.northings}, ${georef.orthogonalHeight}`);
+  console.log(`Rotation: ${georef.rotationRadians} rad`);
+}
 ```
 
-## Schema Coverage
-
-### Before (Manual Implementation)
-- ~70 entities manually implemented
-- ~7% schema coverage
-- Missing: materials, georeferencing, infrastructure
-
-### After (Code Generation)
-- **776 entities** (IFC4) or **876 entities** (IFC4X3)
-- **100% schema coverage**
-- Includes: materials, georeferencing, infrastructure, classifications, structural, MEP, cost, scheduling
-
 ## Performance
 
-- **Parse speed:** ~1,259 MB/s tokenization
-- **Memory:** Columnar storage with TypedArrays
-- **Bundle size:** ~1.9 MB generated schema (200 KB gzipped)
-- **Parse time:** ~600-700ms for 50 MB files, ~100-200ms for 10 MB files
-- **Coverage gain:** +1393% (70 → 1000+ entities)
-
-## Examples
+| Model size | Parse time |
+|---:|---:|
+| 10 MB | ~100–200 ms |
+| 50 MB | ~600–700 ms |
+| 200 MB | ~2.5–3 s |
 
-See `/src/examples/` for comprehensive examples:
-
-- **comprehensive-extraction.ts** - Complete extraction with all new features
-- **material-report.ts** - Generate material usage reports
-- **georef-transform.ts** - Coordinate system transformations
-- **classification-query.ts** - Query by classification codes
-
-## Development
-
-```bash
-# Build
-npm run build
-
-# Test
-npm test
-
-# Regenerate IFC schema (if EXPRESS files updated)
-cd ../codegen
-npm run generate:ifc4
-```
+- Tokenization: ~1,259 MB/s on M1/M2 laptops
+- Bundle: ~200 KB gzipped (schema registry included)
+- Memory: TypedArray columnar storage
 
-## Contributing
+## API
 
-Issues and PRs welcome at https://github.com/louistrue/ifc-lite
+See the [Parsing Guide](https://louistrue.github.io/ifc-lite/guide/parsing/) and [API Reference](https://louistrue.github.io/ifc-lite/api/typescript/#ifc-liteparser).
 
 ## License
 
-MIT
+[MPL-2.0](../../LICENSE)

package/dist/classification-extractor.d.ts

@@ -16,7 +16,7 @@
  * - DIN 276 (Germany)
  * - SfB (Sweden/Denmark)
  */
-import type { IfcEntity } from './entity-extractor';
+import type { IfcEntity } from './entity-extractor.js';
 export interface Classification {
     id: number;
     name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"classification-extractor.d.ts","sourceRoot":"","sources":["../src/classification-extractor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC/D,YAAY,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACpC,mBAAmB,CAsCrB;AAmED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,mBAAmB,GACvC,uBAAuB,EAAE,CAc3B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,GAAG,SAAS,CAGpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,EAAE,CA8BV;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,mBAAmB,EAAE,mBAAmB,GACvC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAavB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,GAAG,SAAS,CAmBpB"}
+{"version":3,"file":"classification-extractor.d.ts","sourceRoot":"","sources":["../src/classification-extractor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC/D,YAAY,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACpC,mBAAmB,CAsCrB;AAmED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,mBAAmB,GACvC,uBAAuB,EAAE,CAc3B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,GAAG,SAAS,CAGpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,EAAE,CA8BV;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,mBAAmB,EAAE,mBAAmB,GACvC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAavB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,MAAM,EAC3B,mBAAmB,EAAE,mBAAmB,GACvC,MAAM,GAAG,SAAS,CAmBpB"}

package/dist/classification-resolver.d.ts

@@ -0,0 +1,18 @@
+import type { IfcDataStore } from './columnar-parser.js';
+export interface ClassificationInfo {
+    system?: string;
+    identification?: string;
+    name?: string;
+    location?: string;
+    description?: string;
+    path?: string[];
+}
+/**
+ * Extract classifications for a single entity ON-DEMAND.
+ * Uses the onDemandClassificationMap built during parsing.
+ * Falls back to relationship graph when on-demand map is not available (e.g., server-loaded models).
+ * Also checks type-level associations via IfcRelDefinesByType.
+ * Returns an array of classification references with system info.
+ */
+export declare function extractClassificationsOnDemand(store: IfcDataStore, entityId: number): ClassificationInfo[];
+//# sourceMappingURL=classification-resolver.d.ts.map

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

@@ -0,0 +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"}

package/dist/classification-resolver.js

@@ -0,0 +1,126 @@
+/* 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/. */
+/**
+ * Classification extraction — resolves IfcClassificationReference chains
+ * and IfcClassification systems for entity classification lookups.
+ */
+import { EntityExtractor } from './entity-extractor.js';
+import { RelationshipType } from '@ifc-lite/data';
+/**
+ * Extract classifications for a single entity ON-DEMAND.
+ * Uses the onDemandClassificationMap built during parsing.
+ * Falls back to relationship graph when on-demand map is not available (e.g., server-loaded models).
+ * Also checks type-level associations via IfcRelDefinesByType.
+ * Returns an array of classification references with system info.
+ */
+export function extractClassificationsOnDemand(store, entityId) {
+    let classRefIds;
+    if (store.onDemandClassificationMap) {
+        classRefIds = store.onDemandClassificationMap.get(entityId);
+    }
+    else if (store.relationships) {
+        // Fallback: use relationship graph (server-loaded models)
+        const related = store.relationships.getRelated(entityId, RelationshipType.AssociatesClassification, 'inverse');
+        if (related.length > 0)
+            classRefIds = related;
+    }
+    // Also check type-level classifications via IfcRelDefinesByType
+    if (store.relationships) {
+        const typeIds = store.relationships.getRelated(entityId, RelationshipType.DefinesByType, 'inverse');
+        for (const typeId of typeIds) {
+            let typeClassRefs;
+            if (store.onDemandClassificationMap) {
+                typeClassRefs = store.onDemandClassificationMap.get(typeId);
+            }
+            else {
+                const related = store.relationships.getRelated(typeId, RelationshipType.AssociatesClassification, 'inverse');
+                if (related.length > 0)
+                    typeClassRefs = related;
+            }
+            if (typeClassRefs && typeClassRefs.length > 0) {
+                classRefIds = classRefIds ? [...classRefIds, ...typeClassRefs] : [...typeClassRefs];
+            }
+        }
+    }
+    if (!classRefIds || classRefIds.length === 0)
+        return [];
+    if (!store.source?.length)
+        return [];
+    const extractor = new EntityExtractor(store.source);
+    const results = [];
+    for (const classRefId of classRefIds) {
+        const ref = store.entityIndex.byId.get(classRefId);
+        if (!ref)
+            continue;
+        const entity = extractor.extractEntity(ref);
+        if (!entity)
+            continue;
+        const typeUpper = entity.type.toUpperCase();
+        const attrs = entity.attributes || [];
+        if (typeUpper === 'IFCCLASSIFICATIONREFERENCE') {
+            // IfcClassificationReference: [Location, Identification, Name, ReferencedSource, Description, Sort]
+            const info = {
+                location: typeof attrs[0] === 'string' ? attrs[0] : undefined,
+                identification: typeof attrs[1] === 'string' ? attrs[1] : undefined,
+                name: typeof attrs[2] === 'string' ? attrs[2] : undefined,
+                description: typeof attrs[4] === 'string' ? attrs[4] : undefined,
+            };
+            // Walk up to find the classification system name
+            const referencedSourceId = typeof attrs[3] === 'number' ? attrs[3] : undefined;
+            if (referencedSourceId) {
+                const path = walkClassificationChain(store, extractor, referencedSourceId);
+                info.system = path.systemName;
+                info.path = path.codes;
+            }
+            results.push(info);
+        }
+        else if (typeUpper === 'IFCCLASSIFICATION') {
+            // IfcClassification: [Source, Edition, EditionDate, Name, Description, Location, ReferenceTokens]
+            results.push({
+                system: typeof attrs[3] === 'string' ? attrs[3] : undefined,
+                name: typeof attrs[3] === 'string' ? attrs[3] : undefined,
+                description: typeof attrs[4] === 'string' ? attrs[4] : undefined,
+                location: typeof attrs[5] === 'string' ? attrs[5] : undefined,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Walk up the IfcClassificationReference chain to find the root IfcClassification system.
+ */
+function walkClassificationChain(store, extractor, startId) {
+    const codes = [];
+    let currentId = startId;
+    const visited = new Set();
+    while (currentId !== undefined && !visited.has(currentId)) {
+        visited.add(currentId);
+        const ref = store.entityIndex.byId.get(currentId);
+        if (!ref)
+            break;
+        const entity = extractor.extractEntity(ref);
+        if (!entity)
+            break;
+        const typeUpper = entity.type.toUpperCase();
+        const attrs = entity.attributes || [];
+        if (typeUpper === 'IFCCLASSIFICATION') {
+            // Root: IfcClassification [Source, Edition, EditionDate, Name, ...]
+            const systemName = typeof attrs[3] === 'string' ? attrs[3] : undefined;
+            return { systemName, codes };
+        }
+        if (typeUpper === 'IFCCLASSIFICATIONREFERENCE') {
+            // IfcClassificationReference [Location, Identification, Name, ReferencedSource, ...]
+            const code = typeof attrs[1] === 'string' ? attrs[1] :
+                typeof attrs[2] === 'string' ? attrs[2] : undefined;
+            if (code)
+                codes.unshift(code);
+            currentId = typeof attrs[3] === 'number' ? attrs[3] : undefined;
+        }
+        else {
+            break;
+        }
+    }
+    return { codes };
+}
+//# sourceMappingURL=classification-resolver.js.map

package/dist/classification-resolver.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Low-level buffer attribute utilities for columnar parsing.
+ *
+ * Pure functions that operate on raw Uint8Array buffers to extract
+ * STEP entity attributes without TextDecoder overhead.
+ */
+import type { EntityRef } from './types.js';
+/**
+ * Find the byte range of a quoted string at a specific attribute position in STEP entity bytes.
+ * Returns [start, end) byte offsets (excluding quotes), or null if not found.
+ *
+ * @param buffer - The IFC file buffer
+ * @param entityStart - byte offset of the entity
+ * @param entityLen - byte length of the entity
+ * @param attrIndex - 0-based attribute index (0=GlobalId, 2=Name)
+ */
+export declare function findQuotedAttrRange(buffer: Uint8Array, entityStart: number, entityLen: number, attrIndex: number): [number, number] | null;
+/**
+ * Skip N commas at depth 0 in STEP bytes.
+ */
+export declare function skipCommas(buffer: Uint8Array, start: number, end: number, count: number): number;
+/** Read a #ID entity reference as a number. Returns -1 if not an entity ref. */
+export declare function readRefId(buffer: Uint8Array, pos: number, end: number): [number, number];
+/** Read a list of entity refs (#id1,#id2,...) or a single #id. Returns [ids, newPos]. */
+export declare function readRefList(buffer: Uint8Array, pos: number, end: number): [number[], number];
+/**
+ * Batch extract GlobalId (attr[0]) and Name (attr[2]) for many entities using
+ * only 2 TextDecoder.decode() calls total (one for all GlobalIds, one for all Names).
+ *
+ * This is ~100x faster than calling extractEntity() per entity for large batches
+ * because it eliminates per-entity TextDecoder overhead which is significant in Firefox.
+ *
+ * Returns a Map from expressId → { globalId, name }.
+ */
+export declare function batchExtractGlobalIdAndName(buffer: Uint8Array, refs: EntityRef[], yieldIfNeeded?: () => Promise<void>): Promise<Map<number, {
+    globalId: string;
+    name: string;
+}>>;
+//# sourceMappingURL=columnar-parser-attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columnar-parser-attributes.d.ts","sourceRoot":"","sources":["../src/columnar-parser-attributes.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiDzB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBhG;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxF;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAsB5F;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAC7C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,SAAS,EAAE,EACjB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAmF1D"}