@ifc-lite/data

@ifc-lite/data

Columnar data structures for IFClite. TypedArray-backed storage for entities, properties, quantities, and relationships — the layout that lets @ifc-lite/parser hold a 200 MB IFC file in ~30 MB of RAM and lets @ifc-lite/query filter it in milliseconds.

Installation

npm install @ifc-lite/data

When to use this directly

Most users get these structures for free as the output of @ifc-lite/parser's parseColumnar(). Use this package directly when you're:

• Building a custom data source (e.g. server-side parquet → IFClite tables)
• Writing a tool that consumes the columnar format outside the parser pipeline
• Looking up EPSG codes (the geo-reference index is shipped here)

Build an entity table

import { EntityTableBuilder, StringTable } from '@ifc-lite/data';

const strings = new StringTable();
const entities = new EntityTableBuilder(1, strings);

// add(expressId, type, globalId, name, description, objectType)
entities.add(42, 'IFCWALL', '1abc2def3...', 'Wall A', '', '');

const table = entities.build();

console.log(table.count);                    // 1
console.log(strings.get(table.name[0]));     // 'Wall A'
console.log(table.getTypeName(42));          // 'IfcWall'

Relationship graph

Edges are stored CSR-style (compressed sparse row) — fast to traverse, compact in memory.

import { RelationshipGraphBuilder, RelationshipType } from '@ifc-lite/data';

const builder = new RelationshipGraphBuilder();

// Storey 100 contains walls 42, 43, 44 (last arg = the IfcRel* express id)
builder.addEdge(100, 42, RelationshipType.ContainsElements, 200);
builder.addEdge(100, 43, RelationshipType.ContainsElements, 200);
builder.addEdge(100, 44, RelationshipType.ContainsElements, 200);

const graph = builder.build();

const contained = graph.getRelated(100, RelationshipType.ContainsElements, 'forward');
console.log(contained); // [42, 43, 44]

EPSG lookup

The full EPSG database ships as a pre-built index — geo-referenced models can resolve coordinate systems offline at runtime.

import { lookupEpsgByCode, searchEpsgIndex } from '@ifc-lite/data';

const lv95 = await lookupEpsgByCode(2056);
// { code: '2056', name: 'CH1903+ / LV95', kind: 'projected', ... }

const matches = await searchEpsgIndex('web mercator');
// → top text-search results; ordered by relevance
console.log(matches.map(m => `${m.code} ${m.name}`));

The index is generated at build time and committed to the repo, so normal builds stay offline. Refresh it with pnpm generate:epsg-index.

API

See the API Reference.

License

MPL-2.0