@ifc-lite/parser 5.2.0 → 6.1.0

package/dist/structural-load-extractor.js

@@ -0,0 +1,178 @@
+/* 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/. */
+import { getAttributeNames, normalizeIfcTypeName } from './ifc-schema.js';
+import { asBoolean, asNumber, asString } from './structural-step-values.js';
+/** Attributes that every load/condition carries from its supertype, not a component. */
+const NAME_ATTR = 'Name';
+/**
+ * `IfcStructuralLoadConfiguration` positional attributes. Named here rather
+ * than resolved by name because this is the one load whose components are
+ * references and lists instead of measures.
+ */
+const LOAD_CONFIGURATION_ATTR = {
+    Name: 0,
+    Values: 1,
+    Locations: 2,
+};
+/**
+ * Read the `Locations` attribute of an `IfcStructuralLoadConfiguration`: a
+ * list of 1..2-element lists of `IfcLengthMeasure`.
+ */
+function readLocations(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    // A flat scalar list (`(0.,4.5)` instead of `((0.),(4.5))`) is unusable as
+    // a whole. Otherwise keep one row per slot so `Values[i]` still pairs with
+    // `Locations[i]`: a `$` row or a row with a non-numeric cell becomes an
+    // EMPTY placeholder rather than being dropped (which would shift every
+    // later row onto the wrong slot) or compacted.
+    if (!value.some((row) => Array.isArray(row)))
+        return undefined;
+    return value.map((row) => {
+        if (!Array.isArray(row))
+            return [];
+        const nums = row.map(asNumber);
+        return nums.every((n) => n !== undefined) ? nums : [];
+    });
+}
+/** Longest chain of nested configurations followed before giving up. */
+const MAX_LOAD_DEPTH = 4;
+/** Ceiling on entities expanded by one top-level load read. */
+const MAX_LOAD_NODES = 256;
+/**
+ * Read one `IfcStructuralLoad` entity by expressId, resolving an
+ * `IfcStructuralLoadConfiguration` down through the loads its `Values` name.
+ *
+ * The `Values` edge is the only recursive one here, and it is
+ * exporter-controlled, so it is bounded three ways — none of which is
+ * redundant:
+ *
+ * - a **path-local** cycle set stops a configuration that reaches itself. It
+ *   has to be path-local rather than shared across siblings, because `Values`
+ *   is a LIST and may legitimately name one load twice; a shared set would
+ *   suppress the repeat as if it were a cycle and report one load where the
+ *   file applies two.
+ * - a **depth cap** bounds one chain's length, which the cycle set alone does
+ *   not for a long acyclic chain.
+ * - a **node budget** bounds total work. The first two still admit `k`
+ *   children each recursing `k` deep, which is O(k^depth) — an abort turned
+ *   into a hang, and a hang reports nothing.
+ *
+ * All three bounds, and every reference this reader cannot follow for the
+ * file's own reasons, keep the `Values` slot they gave up on: the slot becomes
+ * an entry with no `value` and a `dropped` reason naming which it was, so
+ * the station a `Locations` row names still belongs to the load the file put
+ * there. Only the three bounds set `truncated`, since only they mean the file
+ * holds more than this reader agreed to walk.
+ */
+export function extractStructuralLoad(extractor, store, expressId) {
+    return readLoad(extractor, store, expressId, new Set(), { remaining: MAX_LOAD_NODES }, 0).value;
+}
+function readLoad(extractor, store, expressId, path, budget, depth) {
+    if (depth > MAX_LOAD_DEPTH)
+        return { dropped: 'depth', truncated: true };
+    if (path.has(expressId))
+        return { dropped: 'cycle', truncated: true };
+    if (budget.remaining <= 0)
+        return { dropped: 'budget', truncated: true };
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return { dropped: 'unresolved', truncated: false };
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return { dropped: 'unreadable', truncated: false };
+    budget.remaining--;
+    const type = normalizeIfcTypeName(entity.type);
+    const attrs = entity.attributes || [];
+    if (type.toUpperCase() === 'IFCSTRUCTURALLOADCONFIGURATION') {
+        const locations = readLocations(attrs[LOAD_CONFIGURATION_ATTR.Locations]);
+        const entries = [];
+        let truncated = false;
+        const values = attrs[LOAD_CONFIGURATION_ATTR.Values];
+        if (Array.isArray(values)) {
+            // On this node's path only — removed again below so a sibling that
+            // names the same load still reads it.
+            path.add(expressId);
+            for (let i = 0; i < values.length; i++) {
+                const v = values[i];
+                const row = locations?.[i];
+                const location = row && row.length > 0 ? row : undefined; // empty = placeholder for an unusable row
+                const slot = typeof v === 'number' && Number.isInteger(v) && v > 0
+                    ? readLoad(extractor, store, v, path, budget, depth + 1)
+                    : { dropped: 'invalid-reference', truncated: false };
+                if (slot.truncated)
+                    truncated = true;
+                entries.push({ value: slot.value, dropped: slot.dropped, location });
+            }
+            path.delete(expressId);
+        }
+        return {
+            value: {
+                expressId,
+                type,
+                name: asString(attrs[LOAD_CONFIGURATION_ATTR.Name]),
+                components: {},
+                configuration: { entries, locations, truncated },
+            },
+            truncated,
+        };
+    }
+    return {
+        value: {
+            expressId,
+            type,
+            name: asString(attrs[0]),
+            components: readNumericComponents(type, attrs),
+        },
+        truncated: false,
+    };
+}
+/**
+ * Every attribute the registry names for `type`, except the inherited `Name`,
+ * that the record carries a finite number for.
+ */
+function readNumericComponents(type, attrs) {
+    const components = {};
+    const names = getAttributeNames(type);
+    for (let i = 0; i < names.length; i++) {
+        const attrName = names[i];
+        if (attrName === NAME_ATTR)
+            continue;
+        const n = asNumber(attrs[i]);
+        if (n !== undefined)
+            components[attrName] = n;
+    }
+    return components;
+}
+/** Read one `IfcBoundaryCondition` entity by expressId. */
+export function extractBoundaryCondition(extractor, store, expressId) {
+    const ref = store.entityIndex.byId.get(expressId);
+    if (!ref)
+        return undefined;
+    const entity = extractor.extractEntity(ref);
+    if (!entity)
+        return undefined;
+    const type = normalizeIfcTypeName(entity.type);
+    const attrs = entity.attributes || [];
+    const components = {};
+    const names = getAttributeNames(type);
+    for (let i = 0; i < names.length; i++) {
+        const attrName = names[i];
+        if (attrName === NAME_ATTR)
+            continue;
+        // The stiffness selects admit either a measure or IfcBoolean; read the
+        // boolean branch first, since a bare `.T.` would not survive the numeric
+        // test and a number is never a valid boolean token.
+        const b = asBoolean(attrs[i]);
+        if (b !== undefined) {
+            components[attrName] = b;
+            continue;
+        }
+        const n = asNumber(attrs[i]);
+        if (n !== undefined)
+            components[attrName] = n;
+    }
+    return { expressId, type, name: asString(attrs[0]), components };
+}
+//# sourceMappingURL=structural-load-extractor.js.map

package/dist/structural-load-extractor.js.map

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

package/dist/structural-step-values.d.ts

@@ -0,0 +1,51 @@
+/**
+ * STEP value coercions and schema-derived attribute lookup shared by the
+ * structural extractor and its load/boundary-condition reader.
+ *
+ * Shared rather than duplicated per module on purpose: the two readers walk
+ * the same `EntityExtractor` output, so a coercion that disagreed between them
+ * — one accepting `.T.` as a boolean, the other not — would be invisible until
+ * a file exercised both paths over one value.
+ */
+import type { EntityExtractor } from './entity-extractor.js';
+import type { IfcDataStore } from './columnar-parser.js';
+/**
+ * Unwrap a STEP typed value. `EntityExtractor` returns `IFCFORCEMEASURE(-100.)`
+ * as `['IFCFORCEMEASURE', -100]`, so every coercion below has to look through
+ * that wrapper before testing the value.
+ */
+export declare function unwrapTyped(value: unknown): unknown;
+export declare function asString(value: unknown): string | undefined;
+export declare function asNumber(value: unknown): number | undefined;
+export declare function asBoolean(value: unknown): boolean | undefined;
+/** A STEP enum reaches us as `.GLOBAL_COORDS.`; return the bare label. */
+export declare function asEnum(value: unknown): string | undefined;
+export declare function asRef(value: unknown): number | undefined;
+export declare function asRefList(value: unknown): number[];
+export declare function asNumberList(value: unknown): number[] | undefined;
+/**
+ * Resolve an attribute's STEP position from the generated registry by its
+ * EXPRESS name, rather than writing the index literally. A type whose registry
+ * entry does not carry the name answers -1, and {@link readAttr} reports the
+ * attribute as absent instead of reading whatever sits at a guessed offset.
+ */
+export declare function attrIndex(type: string, attrName: string): number;
+export declare function readAttr(type: string, attrs: unknown[], attrName: string): unknown;
+/** Push `value` onto `key`'s list without duplicating it. */
+export declare function addUnique(map: Map<number, string[]>, key: number, value: string): void;
+/** One extracted STEP record, reduced to what the structural readers need. */
+export interface RawEntity {
+    expressId: number;
+    /**
+     * Canonical EXPRESS PascalCase. STEP stores type names uppercase, and the
+     * house rule is that a user-facing surface carries the exact EXPRESS name,
+     * so the raw `IFCSTRUCTURALCURVEMEMBER` is normalized once here rather than
+     * at each of the six places that build a public record from it.
+     */
+    type: string;
+    attrs: unknown[];
+    /** Attribute 0 for an IfcRoot descendant; '' when absent or unreadable. */
+    globalId: string;
+}
+export declare function readEntities(extractor: EntityExtractor, store: IfcDataStore, expressIds: readonly number[]): RawEntity[];
+//# sourceMappingURL=structural-step-values.d.ts.map

package/dist/structural-step-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-step-values.d.ts","sourceRoot":"","sources":["../src/structural-step-values.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAM7D;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKzD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAQlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGlF;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOtF;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,SAAS,EAAE,CAgBb"}

package/dist/structural-step-values.js

@@ -0,0 +1,109 @@
+/* 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/. */
+import { getAttributeNames, normalizeIfcTypeName } from './ifc-schema.js';
+/**
+ * Unwrap a STEP typed value. `EntityExtractor` returns `IFCFORCEMEASURE(-100.)`
+ * as `['IFCFORCEMEASURE', -100]`, so every coercion below has to look through
+ * that wrapper before testing the value.
+ */
+export function unwrapTyped(value) {
+    if (Array.isArray(value) && value.length === 2 && typeof value[0] === 'string') {
+        return value[1];
+    }
+    return value;
+}
+export function asString(value) {
+    const inner = unwrapTyped(value);
+    return typeof inner === 'string' && inner.length > 0 ? inner : undefined;
+}
+export function asNumber(value) {
+    const inner = unwrapTyped(value);
+    return typeof inner === 'number' && Number.isFinite(inner) ? inner : undefined;
+}
+export function asBoolean(value) {
+    const inner = unwrapTyped(value);
+    if (typeof inner === 'boolean')
+        return inner;
+    if (inner === '.T.' || inner === 'T')
+        return true;
+    if (inner === '.F.' || inner === 'F')
+        return false;
+    return undefined;
+}
+/** A STEP enum reaches us as `.GLOBAL_COORDS.`; return the bare label. */
+export function asEnum(value) {
+    const s = asString(value);
+    if (!s)
+        return undefined;
+    const m = s.match(/^\.([A-Za-z0-9_]+)\.$/);
+    return m ? m[1] : undefined;
+}
+export function asRef(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+export function asRefList(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const v of value) {
+        const id = asRef(v);
+        if (id !== undefined)
+            out.push(id);
+    }
+    return out;
+}
+export function asNumberList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const v of value) {
+        const n = asNumber(v);
+        if (n !== undefined)
+            out.push(n);
+    }
+    return out.length > 0 ? out : undefined;
+}
+/**
+ * Resolve an attribute's STEP position from the generated registry by its
+ * EXPRESS name, rather than writing the index literally. A type whose registry
+ * entry does not carry the name answers -1, and {@link readAttr} reports the
+ * attribute as absent instead of reading whatever sits at a guessed offset.
+ */
+export function attrIndex(type, attrName) {
+    return getAttributeNames(type).indexOf(attrName);
+}
+export function readAttr(type, attrs, attrName) {
+    const i = attrIndex(type, attrName);
+    return i >= 0 ? attrs[i] : undefined;
+}
+/** Push `value` onto `key`'s list without duplicating it. */
+export function addUnique(map, key, value) {
+    let list = map.get(key);
+    if (!list) {
+        list = [];
+        map.set(key, list);
+    }
+    if (!list.includes(value))
+        list.push(value);
+}
+export function readEntities(extractor, store, expressIds) {
+    const out = [];
+    for (const expressId of expressIds) {
+        const ref = store.entityIndex.byId.get(expressId);
+        if (!ref)
+            continue;
+        const entity = extractor.extractEntity(ref);
+        if (!entity)
+            continue;
+        const attrs = entity.attributes || [];
+        out.push({
+            expressId,
+            type: normalizeIfcTypeName(entity.type),
+            attrs,
+            globalId: asString(attrs[0]) ?? '',
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=structural-step-values.js.map

package/dist/structural-step-values.js.map

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

package/dist/structural-types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * The public read model for structural analysis — the shapes
+ * `extractStructuralOnDemand` returns, held in their own module so the
+ * extractor stays orchestration and every later layer (query namespace,
+ * properties card, serializer) has one place to import the contract from.
+ *
+ * Every cross-link is a globalId, not an expressId, matching the schedule
+ * extraction's contract: a consumer federating two models is never handed an
+ * id it cannot place.
+ */
+import type { BoundaryConditionInfo, StructuralLoadInfo } from './structural-load-extractor.js';
+/** An `IfcStructuralMember` subtype occurrence. */
+export interface StructuralMemberInfo {
+    expressId: number;
+    globalId: string;
+    /** Canonical EXPRESS type name, e.g. `IfcStructuralCurveMember`. */
+    type: string;
+    name?: string;
+    description?: string;
+    objectType?: string;
+    predefinedType?: string;
+    /** `IfcStructuralSurfaceMember.Thickness`, when the file carries it. */
+    thickness?: number;
+    /** Connections this member is joined to, via IfcRelConnectsStructuralMember. */
+    connectionGlobalIds: string[];
+    /** Activities applied to it, via IfcRelConnectsStructuralActivity. */
+    activityGlobalIds: string[];
+    /** Analysis models it belongs to, via IfcRelAssignsToGroup. */
+    analysisModelGlobalIds: string[];
+}
+/** An `IfcStructuralConnection` subtype occurrence. */
+export interface StructuralConnectionInfo {
+    expressId: number;
+    globalId: string;
+    type: string;
+    name?: string;
+    description?: string;
+    objectType?: string;
+    /** The support condition, resolved from `AppliedCondition`. */
+    appliedCondition?: BoundaryConditionInfo;
+    memberGlobalIds: string[];
+    activityGlobalIds: string[];
+    analysisModelGlobalIds: string[];
+}
+/** An `IfcStructuralActivity` subtype occurrence — an action or a reaction. */
+export interface StructuralActivityInfo {
+    expressId: number;
+    globalId: string;
+    type: string;
+    /**
+     * Which side of the analysis this is: an applied load (`Action`) or a
+     * computed result (`Reaction`). Derived from the inheritance chain, so a
+     * subtype outside the two named branches reports `Unknown` rather than being
+     * silently filed as a load.
+     */
+    kind: 'Action' | 'Reaction' | 'Unknown';
+    name?: string;
+    description?: string;
+    objectType?: string;
+    predefinedType?: string;
+    /** `IfcStructuralActivity.GlobalOrLocal`, e.g. `GLOBAL_COORDS`. */
+    globalOrLocal?: string;
+    /** `IfcStructuralAction.DestabilizingLoad`; absent on reactions. */
+    destabilizingLoad?: boolean;
+    /** `IfcStructuralActivity.AppliedLoad`, resolved. */
+    appliedLoad?: StructuralLoadInfo;
+    /** The member or connection it acts on, via IfcRelConnectsStructuralActivity. */
+    appliesToGlobalId?: string;
+    /**
+     * Every structural group this activity is assigned into via
+     * IfcRelAssignsToGroup — load groups, result groups **and** analysis models.
+     * Unlike a member's `analysisModelGlobalIds`, this one is not narrowed to a
+     * single role, because an activity legitimately belongs to several: a load
+     * case that owns it and an analysis model it was assigned straight into.
+     * Consumers wanting one role must filter by looking the globalId up in the
+     * matching collection.
+     */
+    groupGlobalIds: string[];
+}
+/** An `IfcStructuralLoadGroup` or `IfcStructuralLoadCase`. */
+export interface StructuralLoadGroupInfo {
+    expressId: number;
+    globalId: string;
+    type: string;
+    name?: string;
+    description?: string;
+    objectType?: string;
+    predefinedType?: string;
+    actionType?: string;
+    actionSource?: string;
+    coefficient?: number;
+    purpose?: string;
+    /** `IfcStructuralLoadCase.SelfWeightCoefficients`, when present. */
+    selfWeightCoefficients?: number[];
+    activityGlobalIds: string[];
+}
+/** An `IfcStructuralResultGroup`. */
+export interface StructuralResultGroupInfo {
+    expressId: number;
+    globalId: string;
+    name?: string;
+    description?: string;
+    objectType?: string;
+    theoryType?: string;
+    isLinear?: boolean;
+    resultForLoadGroupGlobalId?: string;
+    activityGlobalIds: string[];
+}
+/** An `IfcStructuralAnalysisModel`. */
+export interface StructuralAnalysisModelInfo {
+    expressId: number;
+    globalId: string;
+    name?: string;
+    description?: string;
+    objectType?: string;
+    predefinedType?: string;
+    /** `LoadedBy` — load group globalIds. */
+    loadGroupGlobalIds: string[];
+    /** `HasResults` — result group globalIds. */
+    resultGroupGlobalIds: string[];
+    /** Members and connections assigned in via IfcRelAssignsToGroup. */
+    itemGlobalIds: string[];
+}
+export interface StructuralExtraction {
+    analysisModels: StructuralAnalysisModelInfo[];
+    members: StructuralMemberInfo[];
+    connections: StructuralConnectionInfo[];
+    activities: StructuralActivityInfo[];
+    loadGroups: StructuralLoadGroupInfo[];
+    resultGroups: StructuralResultGroupInfo[];
+    /** True if any structural entity was found (empty-state UI). */
+    hasStructural: boolean;
+    /**
+     * True when reading an activity's `AppliedLoad` hit one of the walk's own
+     * bounds — the nesting cap, the node budget, or a cycle — and so returned
+     * fewer nested loads than the file holds. A consumer showing a load
+     * configuration reads this before saying "2 loads": a truncated tree is
+     * shaped exactly like a genuinely small one, and reporting the two alike is
+     * how silent truncation becomes wrong data. The per-configuration detail is
+     * `appliedLoad.configuration.truncated` and the entry-level reason is
+     * `configuration.entries[i].dropped`.
+     */
+    loadsTruncated: boolean;
+}
+//# sourceMappingURL=structural-types.d.ts.map

package/dist/structural-types.d.ts.map

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

package/dist/structural-types.js

@@ -0,0 +1,5 @@
+/* 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/. */
+export {};
+//# sourceMappingURL=structural-types.js.map

package/dist/structural-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-types.js","sourceRoot":"","sources":["../src/structural-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/tokenizer.d.ts

@@ -7,11 +7,17 @@ export declare class StepTokenizer {
     /** Records the last scan refused for an out-of-contract express id
      *  (express-id.ts, #3395). Reset per scan; the caller reports it. */
     get oversizedIdCount(): number;
-    /** 0 or 1: whether the last `scanEntitiesFast`/`scanEntities` run stopped
-     *  early on an unclosed `'` string, an unclosed block comment, or a
-     *  declaration cut off before its own '(' -- never a count of how many,
-     *  since the scan has no reliable way to resume past the first one it
-     *  hits. Reset at the start of every scan; the caller reports it. */
+    /** 0 or 1: whether the last run DROPPED a record for having no terminator
+     *  of its own. Never a count of how many: the first is reported and later
+     *  ones are not accumulated. Nor does it say the scan STOPPED.
+     *
+     *  The two scans DISAGREE about which records exist, and this is where that
+     *  shows. `scanEntitiesFast` applies the #4179 record-boundary rules, so
+     *  `#1=IFCA(1);\n#2=IFCB(2)\n#3=IFCC(3);` gives ids [1, 3] and a count of
+     *  1: it drops the unterminated #2 and recovers. `scanEntities`
+     *  (BalancedEntityScan) closes every record on the ')' balancing its '(' and
+     *  never looks at the ';' at all, so the same input gives [1, 2, 3] and a
+     *  count of 0. Reset at the start of every scan; the caller reports it. */
     get malformedRecordCount(): number;
     /**
      * Scan for all entity declarations (#EXPRESS_ID = TYPE(...))

package/dist/tokenizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAUxF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,MAAM,EAAE,UAAU;IAI9B;yEACqE;IACrE,IAAI,gBAAgB,IAAI,MAAM,CAA8B;IAE5D;;;;yEAIqE;IACrE,IAAI,oBAAoB,IAAI,MAAM,CAAkC;IAEpE;;;;;;;;OAQG;IACF,YAAY,IAAI,SAAS,CAAC,gBAAgB,CAAC;IAY5C;;;OAGG;IACF,gBAAgB,IAAI,SAAS,CAAC,gBAAgB,CAAC;CAqQjD"}
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAmBxF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,MAAM,EAAE,UAAU;IAI9B;yEACqE;IACrE,IAAI,gBAAgB,IAAI,MAAM,CAA8B;IAE5D;;;;;;;;;;+EAU2E;IAC3E,IAAI,oBAAoB,IAAI,MAAM,CAAkC;IAEpE;;;;;;;;OAQG;IACF,YAAY,IAAI,SAAS,CAAC,gBAAgB,CAAC;IAY5C;;;OAGG;IACF,gBAAgB,IAAI,SAAS,CAAC,gBAAgB,CAAC;CA6SjD"}