# @ifc-lite/lists

> Configurable property tables and schedules from IFC data for IFC-Lite

Latest version **2.2.5** (published 2026-09-20) · MPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install @ifc-lite/lists
pnpm add @ifc-lite/lists
yarn add @ifc-lite/lists
bun add @ifc-lite/lists
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.2.5 |
| Published | 2026-09-20 |
| First published | 2026-02-12 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 137.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 377 |
| Author | Louis True |
| Maintainers | louistrue |
| Keywords | ifc, bim, lists, schedules, property-tables, aec |

## Links

- npm: https://www.npmjs.com/package/@ifc-lite/lists
- Repository: https://github.com/LTplus-AG/ifc-lite
- Homepage: https://ifclite.dev/docs/
- Issues: https://github.com/LTplus-AG/ifc-lite/issues
- npm.io page: https://npm.io/package/@ifc-lite/lists

## Dependencies (3)

- [@ifc-lite/data](https://npm.io/package/@ifc-lite/data.md) 5.0.0
- [@ifc-lite/encoding](https://npm.io/package/@ifc-lite/encoding.md) 2.2.0
- [@ifc-lite/regex-guard](https://npm.io/package/@ifc-lite/regex-guard.md) 0.2.0

## Alternatives

- [@lexical/table](https://npm.io/package/@lexical/table.md) — 3.0M weekly downloads
- [mantine-datatable](https://npm.io/package/mantine-datatable.md) — 98.2K weekly downloads
- [react-native-collapsible-tab-view](https://npm.io/package/react-native-collapsible-tab-view.md) — 70.6K weekly downloads
- [@handsontable/vue3](https://npm.io/package/@handsontable/vue3.md) — 16.1K weekly downloads
- [vuewordcloud](https://npm.io/package/vuewordcloud.md) — 7.2K weekly downloads

## Recent versions

- 2.2.5 (latest) — 2026-09-20
- 2.2.4 — 2026-09-18
- 2.2.3 — 2026-09-14
- 2.2.2 — 2026-09-13
- 2.2.1 — 2026-09-13
- 2.1.2 — 2026-09-12
- 2.1.0 — 2026-09-04
- 2.0.2 — 2026-08-27
- 2.0.1 — 2026-08-27
- 2.0.0 — 2026-08-24
- 1.23.2 — 2026-08-21
- 1.23.1 — 2026-08-13
- 1.23.0 — 2026-08-12
- 1.22.5 — 2026-08-10
- 1.22.4 — 2026-08-09
- … 46 more at https://npm.io/package/@ifc-lite/lists/versions

## README

# @ifc-lite/lists

Configurable property tables and schedules from IFC data. Define a list once (entity types, columns, filter conditions, grouping) and execute it against any model through a `ListDataProvider` interface to get typed rows, group summaries, and CSV output. This is the engine behind entity tables and schedules in the ifc-lite viewer.

## Install

```bash
npm install @ifc-lite/lists
```

## Usage

```ts
import { executeList, listResultToCSV, LIST_PRESETS } from '@ifc-lite/lists';
import type { ListDataProvider } from '@ifc-lite/lists';

// Bridge your data source (IfcDataStore, a server API, IndexedDB, ...)
// to the engine by implementing ListDataProvider.
declare const provider: ListDataProvider;

// LIST_PRESETS includes ready-made schedules (for example a Wall Schedule)
const result = executeList(LIST_PRESETS[0], provider);
console.log(result.rows);

const csv = listResultToCSV(result);
```

## Features

- `ListDefinition`: entity types, columns, property conditions, grouping, or an explicit express-ID scope per model
- Column sources: entity attributes, property sets, quantity sets, materials, classifications, spatial containers (storey, building, site, project), and source model
- Filtering with typed `PropertyCondition` operators, including Bonsai-style `/regex/` name patterns (`compileNameMatcher`, `isNamePattern`)
- Grouping with per-group summaries (`summariseListRows`)
- `discoverColumns` finds available columns from the actual model data
- CSV export with formula-injection guarding (`listResultToCSV`)
- `LIST_PRESETS` with common schedules

## Links

- Docs: https://ifclite.dev/docs/
- Source: https://github.com/LTplus-AG/ifc-lite

## License

MPL-2.0

---
_Source: https://npm.io/package/@ifc-lite/lists · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._