@ifc-lite/cli 0.26.0 → 0.28.0

package/dist/commands/schedule-render.js

@@ -0,0 +1,205 @@
+/* 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/. */
+/**
+ * CSV / JSON rendering for `ifc-lite schedule`.
+ *
+ * A schedule is a list of header names plus one raw value per (row, column).
+ * CSV routes every cell through `escapeCsvCell` (RFC 4180 quoting + the
+ * spreadsheet-formula-injection guard) shared with the `export` command; a
+ * missing value renders as an empty CSV cell and as JSON `null`.
+ */
+import { escapeCsvCell } from '@ifc-lite/export';
+import { columnValueToCsv } from './export.js';
+/**
+ * Render the schedule as RFC-4180 CSV. Headers and cells both go through the
+ * shared escaper so a header or value containing a comma, quote, newline, or a
+ * leading formula trigger is correctly quoted/neutralised.
+ */
+export function renderScheduleCsv(columns, rows) {
+    const sep = ',';
+    const headerLine = columns.map(c => escapeCsvCell(c.header, { delimiter: sep })).join(sep);
+    const dataLines = rows.map(row => row.map(value => escapeCsvCell(columnValueToCsv(value), { delimiter: sep })).join(sep));
+    return [headerLine, ...dataLines].join('\n');
+}
+/**
+ * Render the schedule as a JSON array of row objects keyed by header. Raw
+ * values keep their type; a missing value is `null`.
+ */
+export function renderScheduleJson(columns, rows) {
+    return rows.map(row => scheduleRowToJson(columns, row));
+}
+/** One data row as a header-keyed object; a missing value is `null`. */
+function scheduleRowToJson(columns, row) {
+    const obj = {};
+    columns.forEach((col, i) => {
+        const value = row[i];
+        obj[col.header] = value == null ? null : value;
+    });
+    return obj;
+}
+/**
+ * The subtotal/total label for a group: `Subtotal (H1=v1, H2=v2)` or `Total`,
+ * suffixed with `: <n>` when a `count` aggregation is present (the row count of
+ * the group / whole schedule).
+ */
+function subtotalLabel(data) {
+    const base = data.kind === 'total'
+        ? 'Total'
+        : `Subtotal (${data.groupValues.map(g => `${g.header}=${g.value == null ? '' : String(g.value)}`).join(', ')})`;
+    const count = data.values.find(v => v.spec === 'count');
+    return count ? `${base}: ${count.value}` : base;
+}
+/**
+ * Pick the column that carries the subtotal/total label. A forced choice
+ * (the first group column, or column 0 for the grand total) can collide with
+ * a `--subtotals` aggregation targeting that same column — `sum:Area` when
+ * `Area` is the first declared column, or the first group-by header — and a
+ * fixed-width row array has no spare slot to hold both a text label and a
+ * numeric value in the same cell. Prefer, in order: the first group column
+ * that is not itself an aggregation target (keeps the label meaningfully
+ * tied to a group value), then the first column overall that is not a
+ * target, and only when every column is a target — no free slot exists at
+ * all — fall back to the historical group/0 choice (that one column's
+ * aggregation is what the label displaces; every other aggregation still
+ * lands in its own column).
+ */
+function chooseLabelCol(columns, data) {
+    const targetIdx = new Set();
+    for (const v of data.values) {
+        if (v.spec === 'count')
+            continue;
+        const header = v.spec.slice(v.spec.indexOf(':') + 1);
+        const idx = columns.findIndex(c => c.header === header);
+        if (idx !== -1)
+            targetIdx.add(idx);
+    }
+    for (const g of data.groupValues) {
+        if (!targetIdx.has(g.index))
+            return g.index;
+    }
+    for (let i = 0; i < columns.length; i++) {
+        if (!targetIdx.has(i))
+            return i;
+    }
+    return data.groupValues.length > 0 ? data.groupValues[0].index : 0;
+}
+/**
+ * A subtotal/total row as a full-width cell array. The label sits in a
+ * column none of this row's aggregations target (see `chooseLabelCol`); each
+ * numeric aggregation fills its own target column; every other column is
+ * blank.
+ *
+ * `--subtotals` allows more than one aggregation on the same `--columns`
+ * header (`sum:Area,avg:Area` is a reasonable request, and the JSON renderer
+ * already keys those by `spec` without collision — see `subtotalToJson`).
+ * The tabular formats have only one cell per column, so when two or more
+ * aggregations target the same column their values are joined into one cell
+ * as `"sum: 30, avg: 15"` instead of the second one silently overwriting the
+ * first. A single aggregation on a column keeps rendering as its bare value
+ * (a number, same as before) so the common case is unaffected.
+ *
+ * When every declared column is an aggregation target there is no free slot
+ * for the label at all (`--columns Area --subtotals sum:Area`), so the label
+ * takes a targeted column. Those displaced aggregations are appended to the
+ * label cell as `Total (sum: 30, avg: 15)` rather than dropped, which is what
+ * used to happen: the tabular formats printed a bare `Total` while JSON still
+ * reported the values.
+ *
+ * Exported so the Markdown/HTML renderers (`schedule-render-md.ts`,
+ * `schedule-render-html.ts`) lay out subtotal/total rows identically to CSV —
+ * same label, same column placement — instead of re-deriving the shape.
+ */
+export function subtotalCells(columns, data) {
+    const cells = columns.map(() => '');
+    const labelCol = chooseLabelCol(columns, data);
+    // Group every non-count aggregation by its target column index so a
+    // collision can be detected before any cell is written. Aggregations
+    // targeting the label's own column are kept too (under `labelCol`), to be
+    // folded into the label text rather than dropped.
+    const byIdx = new Map();
+    for (const v of data.values) {
+        if (v.spec === 'count')
+            continue;
+        const header = v.spec.slice(v.spec.indexOf(':') + 1);
+        const idx = columns.findIndex(c => c.header === header);
+        if (idx === -1)
+            continue; // header is not a declared column: nowhere to put it
+        const bucket = byIdx.get(idx);
+        if (bucket)
+            bucket.push(v);
+        else
+            byIdx.set(idx, [v]);
+    }
+    const label = subtotalLabel(data);
+    const displaced = byIdx.get(labelCol);
+    cells[labelCol] = displaced ? `${label} (${joinAggValues(displaced)})` : label;
+    for (const [idx, values] of byIdx) {
+        if (idx === labelCol)
+            continue; // already folded into the label cell
+        if (values.length === 1) {
+            cells[idx] = values[0].value == null ? '' : values[0].value;
+            continue;
+        }
+        // Two-plus aggregations on one column: join as "mode: value" pairs so
+        // every value survives instead of the last one winning.
+        cells[idx] = joinAggValues(values);
+    }
+    return cells;
+}
+/** `sum:Area`/`avg:Area` values as the shared `"sum: 30, avg: 15"` cell text. */
+function joinAggValues(values) {
+    return values
+        .map(v => `${v.spec.slice(0, v.spec.indexOf(':'))}: ${v.value == null ? '' : v.value}`)
+        .join(', ');
+}
+/**
+ * Render a schedule with `--subtotals`. Grouped output emits each contiguous
+ * group's rows followed by its subtotal row; the grand total closes the table.
+ * Without `--group-by` only the flat rows and the grand total are emitted.
+ */
+export function renderScheduleCsvWithSubtotals(columns, plan) {
+    const sep = ',';
+    const escapeRow = (row) => row.map(value => escapeCsvCell(columnValueToCsv(value), { delimiter: sep })).join(sep);
+    const lines = [columns.map(c => escapeCsvCell(c.header, { delimiter: sep })).join(sep)];
+    if (plan.groups.length > 0) {
+        for (const group of plan.groups) {
+            for (const row of group.rows)
+                lines.push(escapeRow(row));
+            lines.push(escapeRow(subtotalCells(columns, group.subtotal)));
+        }
+    }
+    else {
+        for (const row of plan.rows)
+            lines.push(escapeRow(row));
+    }
+    lines.push(escapeRow(subtotalCells(columns, plan.total)));
+    return lines.join('\n');
+}
+/** The JSON form of a subtotal/total row: `__row` marker + group + aggregated fields. */
+function subtotalToJson(data) {
+    const obj = { __row: data.kind };
+    for (const g of data.groupValues)
+        obj[g.header] = g.value == null ? null : g.value;
+    for (const v of data.values)
+        obj[v.spec] = v.value;
+    return obj;
+}
+/** Render a schedule with `--subtotals` as flat JSON rows plus `__row`-marked subtotal/total objects. */
+export function renderScheduleJsonWithSubtotals(columns, plan) {
+    const out = [];
+    if (plan.groups.length > 0) {
+        for (const group of plan.groups) {
+            for (const row of group.rows)
+                out.push(scheduleRowToJson(columns, row));
+            out.push(subtotalToJson(group.subtotal));
+        }
+    }
+    else {
+        for (const row of plan.rows)
+            out.push(scheduleRowToJson(columns, row));
+    }
+    out.push(subtotalToJson(plan.total));
+    return out;
+}
+//# sourceMappingURL=schedule-render.js.map

package/dist/commands/schedule-render.js.map

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

package/dist/commands/schedule-spec.d.ts

@@ -0,0 +1,29 @@
+/** The reusable definition persisted by `--save` and consumed by `--spec`. */
+export interface ScheduleSpec {
+    preset?: string;
+    type?: string;
+    columns?: string;
+    where?: string;
+    sort?: string;
+    groupBy?: string;
+    subtotals?: string;
+    format?: string;
+}
+/**
+ * Load a `--spec` file. Fatal (not a thrown exception the top-level handler
+ * reformats) on every way a spec can fail to be a usable schedule definition:
+ * the file doesn't exist or isn't readable, its content isn't valid JSON,
+ * isn't a JSON object, or has a declared field that isn't a string — each
+ * would otherwise surface only once `schedule.ts` tries to use the bad value
+ * (or, for a non-object/wrong-type field, might silently coerce into an empty
+ * `--columns`/`--type`, producing an empty schedule with no error at all).
+ */
+export declare function loadScheduleSpec(path: string): Promise<ScheduleSpec>;
+/**
+ * Write the schedule definition actually used by this invocation (after
+ * `--preset` defaults are folded in, so a saved spec is self-contained and
+ * `--spec`-loadable without also needing the original `--preset`) to `path`.
+ * Undefined fields are omitted rather than written as `null`.
+ */
+export declare function saveScheduleSpec(path: string, spec: ScheduleSpec): Promise<void>;
+//# sourceMappingURL=schedule-spec.d.ts.map

package/dist/commands/schedule-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-spec.d.ts","sourceRoot":"","sources":["../../src/commands/schedule-spec.ts"],"names":[],"mappings":"AA6BA,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwD1E;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtF"}

package/dist/commands/schedule-spec.js

@@ -0,0 +1,111 @@
+/* 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/. */
+/**
+ * `--save`/`--spec` reusable schedule definitions for `ifc-lite schedule`.
+ *
+ * A spec is a small JSON file holding exactly the flag strings the CLI itself
+ * accepts — `--type`, `--columns`, `--where`, `--sort`, `--group-by`,
+ * `--subtotals`, `--format` — plus an optional `preset` field naming a
+ * `--preset` to start from. It is a plain file at whatever path the caller
+ * gives `--spec`/`--save`, not a config-directory convention: `--save` writes
+ * one, `--spec` reads one back.
+ *
+ * Precedence when both a spec and an explicit flag are given (`schedule.ts`):
+ * explicit CLI flag > spec field > preset field (whether `--preset` on the
+ * command line or `preset` inside the spec) — the same "most specific wins"
+ * rule `--preset` already uses against explicit flags.
+ *
+ * A spec naming an unresolvable `preset`, or missing/malformed in a way that
+ * would otherwise silently resolve to an empty schedule, is a `fatal(...)`:
+ * failing loudly beats emitting a table with no rows or columns.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { fatal } from '../output.js';
+import { logger } from '../logger.js';
+import { parseWhereFilter } from './where-filter.js';
+const SPEC_FIELDS = [
+    'preset', 'type', 'columns', 'where', 'sort', 'groupBy', 'subtotals', 'format',
+];
+/**
+ * Load a `--spec` file. Fatal (not a thrown exception the top-level handler
+ * reformats) on every way a spec can fail to be a usable schedule definition:
+ * the file doesn't exist or isn't readable, its content isn't valid JSON,
+ * isn't a JSON object, or has a declared field that isn't a string — each
+ * would otherwise surface only once `schedule.ts` tries to use the bad value
+ * (or, for a non-object/wrong-type field, might silently coerce into an empty
+ * `--columns`/`--type`, producing an empty schedule with no error at all).
+ */
+export async function loadScheduleSpec(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf-8');
+    }
+    catch (err) {
+        fatal(`--spec "${path}" could not be read: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        fatal(`--spec "${path}" is not valid JSON: ${err.message}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        fatal(`--spec "${path}" must be a JSON object with schedule fields (type, columns, where, sort, groupBy, subtotals, format, preset), got ${Array.isArray(parsed) ? 'an array' : typeof parsed}.`);
+    }
+    const obj = parsed;
+    // An unrecognised key (a mistyped "group-by" instead of "groupBy", say) used
+    // to be silently ignored by the loop below, which only ever reads the
+    // fields it already knows about — the mistyped key had no effect and the
+    // command exited 0 with whatever the OTHER, correctly-spelled fields
+    // produced (an ungrouped schedule, for a mistyped "groupBy"), never
+    // surfacing that the field was dropped. Reject it up front instead.
+    const unknownKeys = Object.keys(obj).filter(k => !SPEC_FIELDS.includes(k));
+    if (unknownKeys.length > 0) {
+        fatal(`--spec "${path}" has unrecognised field(s): ${unknownKeys.join(', ')}. Valid fields: ${SPEC_FIELDS.join(', ')}.`);
+    }
+    const spec = {};
+    for (const field of SPEC_FIELDS) {
+        if (!(field in obj))
+            continue;
+        const value = obj[field];
+        if (typeof value !== 'string') {
+            fatal(`--spec "${path}": field "${field}" must be a string, got ${Array.isArray(value) ? 'an array' : typeof value}.`);
+        }
+        spec[field] = value;
+    }
+    if (spec.preset === undefined && spec.type === undefined) {
+        fatal(`--spec "${path}" declares neither "preset" nor "type" — nothing to schedule. Expected at least one, plus "columns" unless a preset supplies it.`);
+    }
+    // Validate `where` the same way an explicit --where flag is (schedule.ts
+    // calls the identical parseWhereFilter once it applies the filter) —
+    // eagerly here, rather than deferring the same fatal(...) until the run
+    // gets around to using it (by which point --save, if also given, may
+    // already have written a spec built from this same broken value).
+    if (spec.where !== undefined) {
+        parseWhereFilter(spec.where);
+    }
+    return spec;
+}
+/**
+ * Write the schedule definition actually used by this invocation (after
+ * `--preset` defaults are folded in, so a saved spec is self-contained and
+ * `--spec`-loadable without also needing the original `--preset`) to `path`.
+ * Undefined fields are omitted rather than written as `null`.
+ */
+export async function saveScheduleSpec(path, spec) {
+    const out = {};
+    for (const field of SPEC_FIELDS) {
+        if (spec[field] !== undefined)
+            out[field] = spec[field];
+    }
+    try {
+        await writeFile(path, JSON.stringify(out, null, 2) + '\n');
+    }
+    catch (err) {
+        fatal(`--save "${path}" could not be written: ${err.message}`);
+    }
+    logger.info(`Schedule spec written to ${path}`);
+}
+//# sourceMappingURL=schedule-spec.js.map

package/dist/commands/schedule-spec.js.map

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

package/dist/commands/schedule.d.ts

@@ -0,0 +1,23 @@
+import { type ScheduleColumn } from './schedule-columns.js';
+import { type ScheduleRow } from './schedule-render.js';
+/**
+ * Resolve one column path against one entity.
+ *
+ * A `Set.Member` path (and the five native attributes) goes through the shared
+ * `resolveColumnValue` the `export` command uses, so schedule columns inherit
+ * its type-inheritance / same-named-pset / complex-property behaviour and agree
+ * with `--where`. A plain attribute name the shared resolver does not treat as
+ * native (e.g. `Tag`, `PredefinedType`) is then read from the canonical
+ * entity-attribute list — the same surface `query --attributes` exposes — so a
+ * missing value stays `null`.
+ */
+export declare function resolveScheduleValue(entity: any, path: string, bim: any): unknown;
+/**
+ * Build one row per entity, resolving every declared column. Reads
+ * properties/quantities/attributes/materials at most once per entity
+ * (see `memoizedColumnAccessors`) — measured 5.6x on FM_ARC_DigitalHub,
+ * 6 columns: 40.6ms -> 7.2ms per row build.
+ */
+export declare function buildScheduleRows(entities: any[], columns: ScheduleColumn[], bim: any): ScheduleRow[];
+export declare function scheduleCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/commands/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/commands/schedule.ts"],"names":[],"mappings":"AAmDA,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAW9B;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CA2DjF;AAgCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,WAAW,EAAE,CAGrG;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiHnE"}

package/dist/commands/schedule.js

@@ -0,0 +1,249 @@
+/* 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/. */
+/**
+ * ifc-lite schedule <file.ifc> [--preset <name>] --type <IfcClass>
+ *                    --columns "<Header>=<path>[, ...]"
+ *                    [--where "<expr>"] [--sort "<Header>[:asc|desc][, ...]"]
+ *                    [--group-by "<Header>[, ...]"]
+ *                    [--subtotals "<agg>[, ...]"] [--format csv|json|md|html]
+ *                    [--spec <file.json>] [--save <file.json>]
+ *
+ * `--preset door|window|space|wall|material-takeoff` supplies a default
+ * `--type` and `--columns` (and, for some presets, a default group-by/sort/
+ * subtotals) so a common schedule runs with no other flags. An explicit flag of
+ * the same name overrides the preset's default; `--where`/`--format` apply as
+ * normal. See `schedule-presets.ts`.
+ *
+ * `--spec <file.json>` loads a saved schedule definition (see
+ * `schedule-spec.ts`) supplying the same defaults a preset would (lower
+ * priority than an explicit flag, higher priority than `--preset`); `--save
+ * <file.json>` writes the definition this invocation resolved to — after any
+ * `--preset`/`--spec` defaults are folded in — so it can be re-run later with
+ * `--spec` alone. A spec that names an unresolvable preset, isn't valid JSON,
+ * or is missing both `type` and `preset` is a `fatal(...)`, never a silent
+ * empty schedule.
+ *
+ * Produce a tabular schedule of one IFC class: pick the entities of `--type`,
+ * (optionally) narrow them with the same `--where` filter `query` uses, and
+ * emit one row per entity with the requested columns. A column path is a plain
+ * attribute name, a `PsetName.PropName`, or a `QtoName.QtyName`, resolved
+ * through the SAME resolver the `export` command uses so schedule columns and
+ * query filters agree on type-inheritance / same-named-pset / complex-property
+ * behaviour. `--format md` emits a GFM table; `--format html` emits a
+ * standalone HTML document — both lay out `--group-by`/`--subtotals` rows
+ * identically to CSV/JSON (see `schedule-render-md.ts`/`schedule-render-html.ts`)
+ * and escape cell text for their format (`|`/newline for Markdown;
+ * `&`/`<`/`>`/quotes for HTML — model text is untrusted).
+ *
+ * `--sort`, `--group-by` and `--subtotals` all name column HEADERS (never
+ * paths); a header that is not among `--columns` is a `fatal(...)`. Rows are
+ * ordered by group first (so each group is contiguous) then by the remaining
+ * sort keys, with the original entity order as the stable tiebreaker.
+ * `--subtotals` emits a subtotal row after each group and a grand-total row;
+ * without `--group-by` it emits only the grand total.
+ */
+import { createHeadlessContext } from '../loader.js';
+import { getFlag, fatal, printJson, firstNonBlank, isBlank } from '../output.js';
+import { normalizeTypeName, parseWhereFilter, applyWhereFilter } from './query.js';
+import { resolveColumnValue } from './export.js';
+import { parseColumnSpec } from './schedule-columns.js';
+import { renderScheduleCsv, renderScheduleJson, renderScheduleCsvWithSubtotals, renderScheduleJsonWithSubtotals, } from './schedule-render.js';
+import { renderScheduleMarkdown, renderScheduleMarkdownWithSubtotals } from './schedule-render-md.js';
+import { renderScheduleHtml, renderScheduleHtmlWithSubtotals } from './schedule-render-html.js';
+import { parseSortSpec, parseGroupBySpec, orderRows } from './schedule-group.js';
+import { parseSubtotalsSpec, buildSubtotalPlan } from './schedule-aggregate.js';
+import { resolvePreset } from './schedule-presets.js';
+import { loadScheduleSpec, saveScheduleSpec } from './schedule-spec.js';
+const FORMATS = ['csv', 'json', 'md', 'html'];
+/**
+ * Resolve one column path against one entity.
+ *
+ * A `Set.Member` path (and the five native attributes) goes through the shared
+ * `resolveColumnValue` the `export` command uses, so schedule columns inherit
+ * its type-inheritance / same-named-pset / complex-property behaviour and agree
+ * with `--where`. A plain attribute name the shared resolver does not treat as
+ * native (e.g. `Tag`, `PredefinedType`) is then read from the canonical
+ * entity-attribute list — the same surface `query --attributes` exposes — so a
+ * missing value stays `null`.
+ */
+export function resolveScheduleValue(entity, path, bim) {
+    // `Material` is a pseudo-column: resolve the element's associated material
+    // name through the same fallback chain `packages/mcp/src/material-naming.ts`
+    // `materialFallbackName` applies (duplicated locally the same way
+    // `firstNonBlank`/`isBlank` already are in `output.ts` — a cross-package
+    // import would widen `@ifc-lite/mcp`'s public surface for one helper). A
+    // plain `.name`/`.materials[0]` pair (the pre-fix behaviour) only covers a
+    // bare `IfcMaterial` or `IfcMaterialList`: the normal `IfcWall` shape is a
+    // `MaterialLayerSet` with no top-level `LayerSetName`, whose real name
+    // lives on `layers[]`/`profiles[]`/`constituents[]` — reading only
+    // `.name`/`.materials[0]` returns `null` for every such wall, and
+    // `--preset material-takeoff`'s default `--group-by Material` collapses
+    // them into one unlabelled group instead of one group per real material.
+    // A whitespace-only leaf name falls through the same way (#3714's family),
+    // and a fully blank result renders `(no material)` — the same placeholder
+    // `query --group-by material` uses — rather than a silent empty cell, so a
+    // group-by/subtotal on `Material` buckets blank elements together under a
+    // readable label instead of splitting on `null` vs `''` vs whitespace.
+    if (path === 'Material') {
+        const mat = bim.materials(entity.ref);
+        if (!mat)
+            return '(no material)';
+        return (firstNonBlank(mat.name, mat.materials?.[0]?.name, mat.layers?.find(l => !isBlank(l.materialName))?.materialName, mat.profiles?.find(p => !isBlank(p.materialName))?.materialName, mat.constituents?.find(c => !isBlank(c.materialName))?.materialName) ?? '(no material)');
+    }
+    // A dot-free path checks the canonical entity-attribute list FIRST.
+    // resolveColumnValue's own bare-name fallback (below) sweeps EVERY property
+    // and quantity set for a member with that literal name — a user-authored
+    // pset property that happens to share a schema attribute's name (e.g. a
+    // "Tag" property in some custom Pset) would otherwise shadow the real
+    // IfcDoor.Tag attribute that a column like --preset door's `Mark=Tag`
+    // means. A dotted `Pset.Prop`/`Qto.Qty` path is unambiguous and always
+    // goes straight through resolveColumnValue.
+    if (!path.includes('.')) {
+        const attrs = bim.attributes(entity.ref);
+        const hit = attrs.find(a => a.name === path);
+        if (hit && hit.value != null)
+            return hit.value;
+    }
+    const viaColumn = resolveColumnValue(entity, path, bim);
+    if (viaColumn != null)
+        return viaColumn;
+    return null;
+}
+/** Wrap a single-argument function so a repeated call with the SAME argument (by `===`) is served from cache instead of re-invoked. */
+function memoize(fn) {
+    const cache = new Map();
+    return (arg) => {
+        const hit = cache.get(arg);
+        if (hit !== undefined || cache.has(arg))
+            return hit;
+        const result = fn(arg);
+        cache.set(arg, result);
+        return result;
+    };
+}
+/**
+ * Wrap `bim` so `properties`/`quantities`/`attributes`/`materials` — the only
+ * four methods `resolveScheduleValue` (and the `resolveColumnValue` it
+ * delegates to) ever call — are read at most ONCE per entity ref for the
+ * whole schedule, however many `--columns` request them. Resolving each
+ * column independently means an N-column row calls e.g. `bim.properties(ref)`
+ * N times for the identical entity, re-walking the same property-set list
+ * from scratch each time.
+ */
+function memoizedColumnAccessors(bim) {
+    return {
+        properties: memoize((ref) => bim.properties(ref)),
+        quantities: memoize((ref) => bim.quantities(ref)),
+        attributes: memoize((ref) => bim.attributes(ref)),
+        materials: memoize((ref) => bim.materials(ref)),
+    };
+}
+/**
+ * Build one row per entity, resolving every declared column. Reads
+ * properties/quantities/attributes/materials at most once per entity
+ * (see `memoizedColumnAccessors`) — measured 5.6x on FM_ARC_DigitalHub,
+ * 6 columns: 40.6ms -> 7.2ms per row build.
+ */
+export function buildScheduleRows(entities, columns, bim) {
+    const cached = memoizedColumnAccessors(bim);
+    return entities.map((e) => columns.map(col => resolveScheduleValue(e, col.path, cached)));
+}
+export async function scheduleCommand(args) {
+    const filePath = args.find(a => !a.startsWith('-'));
+    if (!filePath) {
+        fatal('Usage: ifc-lite schedule <file.ifc> --type IfcDoor --columns "Name=Name, Mark=Pset_DoorCommon.Reference" [--where PsetName.Prop=Value] [--format csv|json]');
+    }
+    // --spec loads a saved definition (see schedule-spec.ts); its fields sit
+    // between an explicit flag (wins) and a --preset default (loses) in
+    // precedence, whether the preset comes from --preset or the spec's own
+    // "preset" field.
+    const specPath = getFlag(args, '--spec');
+    const spec = specPath ? await loadScheduleSpec(specPath) : undefined;
+    // --preset supplies default type/columns (and optionally group-by/sort/
+    // subtotals); an explicit flag of the same name overrides the preset default.
+    const presetName = getFlag(args, '--preset') ?? spec?.preset;
+    const preset = presetName ? resolvePreset(presetName) : undefined;
+    const typeRaw = getFlag(args, '--type') ?? spec?.type ?? preset?.type;
+    if (!typeRaw) {
+        fatal('--type is required (or pass --preset/--spec), e.g. --type IfcDoor or --preset door');
+    }
+    const type = normalizeTypeName(typeRaw);
+    const columnsSpec = getFlag(args, '--columns') ?? spec?.columns ?? preset?.columns;
+    const columns = parseColumnSpec(columnsSpec);
+    const format = (getFlag(args, '--format') ?? spec?.format ?? 'csv').toLowerCase();
+    if (!FORMATS.includes(format)) {
+        fatal(`Unknown --format "${format}". Expected ${FORMATS.join(', ')}.`);
+    }
+    const whereFilter = getFlag(args, '--where') ?? spec?.where;
+    // --sort / --group-by / --subtotals name declared column HEADERS; an unknown
+    // header is a fatal(...) with the valid headers listed (raised during parse).
+    const sortSpec = getFlag(args, '--sort') ?? spec?.sort ?? preset?.sort;
+    const groupBySpec = getFlag(args, '--group-by') ?? spec?.groupBy ?? preset?.groupBy;
+    const subtotalsSpec = getFlag(args, '--subtotals') ?? spec?.subtotals ?? preset?.subtotals;
+    const sortKeys = parseSortSpec(sortSpec, columns);
+    const groupKeys = parseGroupBySpec(groupBySpec, columns);
+    const subtotalAggs = parseSubtotalsSpec(subtotalsSpec, columns);
+    // --save's target path is captured here (so --save itself is validated up
+    // front, same as every other flag) but the file is written only once this
+    // run has actually succeeded — see below.
+    const savePath = getFlag(args, '--save');
+    const { bim } = await createHeadlessContext(filePath);
+    let entities = bim.query().byType(...type.split(',')).toArray();
+    // --where reuses the exact query filter (property sets + quantity fallback).
+    if (whereFilter) {
+        const parsed = parseWhereFilter(whereFilter);
+        entities = applyWhereFilter(entities, parsed, bim);
+    }
+    // One row per entity, in entity order — the stable tiebreaker for ordering.
+    let rows = buildScheduleRows(entities, columns, bim);
+    // Order once, after row assembly: groups contiguous, then remaining sort keys.
+    if (sortKeys.length > 0 || groupKeys.length > 0) {
+        rows = orderRows(rows, sortKeys, groupKeys);
+    }
+    // --save persists the definition this invocation actually resolved to
+    // (after --preset/--spec defaults are folded in), so the written file is
+    // self-contained and reloadable with --spec alone. Written only here, once
+    // --type/--where/--sort/--group-by/--subtotals have all parsed AND the
+    // input file has loaded successfully — writing it any earlier (its
+    // original position, before --where was even parsed and before the input
+    // file was opened) could persist a broken spec despite the run's own
+    // non-zero exit.
+    if (savePath) {
+        await saveScheduleSpec(savePath, {
+            type, columns: columnsSpec, where: whereFilter,
+            sort: sortSpec, groupBy: groupBySpec, subtotals: subtotalsSpec, format,
+        });
+    }
+    if (subtotalAggs.length > 0) {
+        const plan = buildSubtotalPlan(rows, groupKeys, subtotalAggs);
+        if (format === 'json') {
+            printJson(renderScheduleJsonWithSubtotals(columns, plan));
+            return;
+        }
+        if (format === 'md') {
+            process.stdout.write(renderScheduleMarkdownWithSubtotals(columns, plan) + '\n');
+            return;
+        }
+        if (format === 'html') {
+            process.stdout.write(renderScheduleHtmlWithSubtotals(columns, plan));
+            return;
+        }
+        process.stdout.write(renderScheduleCsvWithSubtotals(columns, plan) + '\n');
+        return;
+    }
+    if (format === 'json') {
+        printJson(renderScheduleJson(columns, rows));
+        return;
+    }
+    if (format === 'md') {
+        process.stdout.write(renderScheduleMarkdown(columns, rows) + '\n');
+        return;
+    }
+    if (format === 'html') {
+        process.stdout.write(renderScheduleHtml(columns, rows));
+        return;
+    }
+    process.stdout.write(renderScheduleCsv(columns, rows) + '\n');
+}
+//# sourceMappingURL=schedule.js.map