@ifc-lite/query

@ifc-lite/query

Query system for IFClite. Fluent type-safe filtering of an IfcDataStore, plus full SQL via DuckDB-WASM. Filters by IFC type, property values, and relationships across multi-model federations.

Installation

npm install @ifc-lite/query

Fluent queries

import { IfcQuery } from '@ifc-lite/query';

const query = new IfcQuery(store); // store from `parseColumnar()`

// All external load-bearing walls
const walls = query
  .ofType('IfcWall', 'IfcWallStandardCase')
  .whereProperty('Pset_WallCommon', 'IsExternal', '=', true)
  .whereProperty('Pset_WallCommon', 'LoadBearing', '=', true)
  .execute();

console.log(`${walls.length} external load-bearing walls`);

for (const wall of walls) {
  console.log(wall.name, wall.globalId);
  console.log(wall.properties); // lazily-loaded psets
}

Convenience methods for the common building elements:

query.walls().execute();
query.doors().execute();
query.windows().execute();
query.slabs().execute();
query.columns().execute();
query.beams().execute();
query.spaces().execute();

Comparison operators

query
  .ofType('IfcWall')
  .whereProperty('Qto_WallBaseQuantities', 'NetVolume', '>', 5.0)
  .whereProperty('Pset_WallCommon', 'FireRating', '!=', null)
  .execute();

Supported: =, !=, >, <, >=, <=, contains, startsWith.

Graph traversal

const wall = query.entity(12345);

// Walk the spatial structure
console.log(wall.storey()?.name);    // 'Ground Floor'
console.log(wall.building()?.name);  // 'Office Tower'

// Containment + composition
const openings = wall.contains(); // openings hosted by the wall
const aggregates = wall.decomposes();

SQL via DuckDB-WASM

const result = await query.sql(`
  SELECT e.type, COUNT(*) AS count, AVG(q.value) AS avg_volume
  FROM entities e
  JOIN quantities q ON q.entity_id = e.express_id
  WHERE q.quantity_name = 'NetVolume'
  GROUP BY e.type
  ORDER BY count DESC
  LIMIT 10
`);

console.table(result.rows);

Tables exposed: entities, properties, quantities, relationships. Useful when you'd rather write SQL than chain method calls.

DuckDB is loaded lazily on the first sql() call and is not bundled (it would add ~4 MB). To use the SQL API, install it alongside:

npm install @duckdb/duckdb-wasm

The fluent query API works without it.

API

See the Querying Guide and API Reference.

License

MPL-2.0