@idfkit/core 0.0.1

package/dist/parse/idf.js

@@ -0,0 +1,170 @@
+import { IDFDocument } from '../document.js';
+import { lex } from './lexer.js';
+/**
+ * Parse IDF text into a document.
+ *
+ * Synchronous and pure: text in, document out, no I/O. Everything that touches
+ * the filesystem or network lives at the edges (`@idfkit/core/node`), so this
+ * function behaves identically in Node, a browser, and a worker. The schema
+ * must already be loaded, which is the one genuinely async step.
+ */
+export function parseIdf(text, schema, options = {}) {
+    const strict = options.strict ?? true;
+    const diagnostics = [];
+    const report = (diagnostic) => {
+        if (strict) {
+            throw new IdfParseError(diagnostic);
+        }
+        diagnostics.push(diagnostic);
+        options.onDiagnostic?.(diagnostic);
+    };
+    const raw = lex(text, { onDiagnostic: report });
+    const document = new IDFDocument(schema);
+    for (const object of raw) {
+        const canonical = schema.resolve(object.typeName);
+        if (canonical === undefined) {
+            report({
+                message: `Unknown object type "${object.typeName}" in EnergyPlus ${schema.version}`,
+                line: object.line,
+                typeName: object.typeName,
+            });
+            continue;
+        }
+        const definition = schema.require(canonical);
+        try {
+            const { name, values } = interpret(definition, object);
+            document.addRaw(canonical, definition.anon === 1 ? null : name, values);
+        }
+        catch (error) {
+            report({
+                message: error instanceof Error ? error.message : String(error),
+                line: object.line,
+                typeName: canonical,
+            });
+        }
+    }
+    return { document, diagnostics };
+}
+/** Map positional IDF values onto named schema fields. */
+function interpret(definition, object) {
+    const order = definition.f;
+    const named = definition.anon !== 1 && order[0] === 'name';
+    const values = {};
+    let cursor = 0;
+    let name = '';
+    if (named) {
+        name = object.values[0]?.trim() ?? '';
+        if (name === '' && definition.nreq === 1) {
+            throw new Error(`${object.typeName} requires a name`);
+        }
+        cursor = 1;
+    }
+    const fixed = named ? order.slice(1) : order;
+    for (const field of fixed) {
+        const raw = object.values[cursor++];
+        if (raw === undefined)
+            break;
+        if (raw === '')
+            continue;
+        const coerced = coerce(definition, field, raw);
+        if (coerced !== undefined)
+            values[field] = coerced;
+    }
+    // Everything past the fixed fields belongs to the extensible section, read in
+    // repeats of the group width. A trailing partial group is kept rather than
+    // dropped: files in the wild are truncated, and losing data on a round-trip
+    // is worse than carrying an incomplete group.
+    const extensible = definition.x;
+    if (extensible !== undefined) {
+        const width = extensible.fields.length;
+        const groups = [];
+        let lastPopulated = -1;
+        while (cursor < object.values.length) {
+            const group = {};
+            let populated = false;
+            for (let offset = 0; offset < width; offset += 1) {
+                const raw = object.values[cursor++];
+                if (raw === undefined || raw === '')
+                    continue;
+                const field = extensible.fields[offset];
+                const coerced = coerceExtensible(definition, field, raw);
+                if (coerced !== undefined) {
+                    group[field] = coerced;
+                    populated = true;
+                }
+            }
+            if (populated)
+                lastPopulated = groups.length;
+            groups.push(group);
+        }
+        // An all-blank repeat in the middle is kept, because the section is
+        // positional: dropping it pulls every later group down a slot, so a surface
+        // silently loses a vertex and its `number_of_vertices` stops matching.
+        // Trailing blanks are padding rather than data, and are dropped.
+        groups.length = lastPopulated + 1;
+        if (groups.length > 0)
+            values[extensible.key] = groups;
+    }
+    return { name, values };
+}
+function coerce(definition, field, raw) {
+    return coerceValue(definition.p[field]?.t, raw);
+}
+function coerceExtensible(definition, field, raw) {
+    const value = coerceValue(definition.x?.p[field]?.t, raw);
+    return Array.isArray(value) ? undefined : value;
+}
+/**
+ * Convert IDF text to a stored value.
+ *
+ * Numeric fields that hold `Autosize`, `Autocalculate`, or anything else
+ * non-numeric stay as strings. EnergyPlus accepts them and silently coercing
+ * to `NaN` would destroy the model on write.
+ */
+function coerceValue(kind, raw) {
+    if (kind === 'n' || kind === 'i') {
+        const parsed = Number(raw);
+        if (!Number.isNaN(parsed) && raw.trim() !== '') {
+            const value = kind === 'i' ? Math.trunc(parsed) : parsed;
+            // Normalize -0 to 0. IDF files do contain `-0`, and JavaScript keeps the
+            // sign, so without this a value round-trips to a different (if equal)
+            // number and every strict comparison downstream reports a spurious diff.
+            return value === 0 ? 0 : value;
+        }
+    }
+    return raw;
+}
+export class IdfParseError extends Error {
+    line;
+    typeName;
+    constructor(diagnostic) {
+        super(`${diagnostic.message} (line ${diagnostic.line})`);
+        this.name = 'IdfParseError';
+        this.line = diagnostic.line;
+        this.typeName = diagnostic.typeName;
+    }
+}
+/**
+ * Read the version identifier from IDF text without a schema.
+ *
+ * Chicken-and-egg: choosing the schema requires knowing the version, and the
+ * version lives inside the file. This does the minimum scan needed to break
+ * the cycle, and does not validate anything else.
+ */
+export function detectVersion(text) {
+    // Strip comments first. Trying to tolerate them inside the pattern means
+    // guessing how many comment lines sit between the comma and the value, which
+    // is exactly the kind of thing that works on the file you tested and fails on
+    // the next one.
+    const stripped = text.replace(/!.*$/gm, '');
+    // Anchored to a statement boundary so a field value containing the word
+    // "Version" cannot be mistaken for the object.
+    const match = /(?:^|;)\s*Version\s*,\s*([\d.]+)\s*;/i.exec(stripped);
+    const raw = match?.[1];
+    if (raw === undefined)
+        return undefined;
+    const parts = raw.split('.').map((p) => Number(p) || 0);
+    // EnergyPlus writes `Version, 26.1;` but schemas are keyed `26.1.0`.
+    return `${parts[0] ?? 0}.${parts[1] ?? 0}.${parts[2] ?? 0}`;
+}
+//# sourceMappingURL=idf.js.map

package/dist/parse/idf.js.map

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

package/dist/parse/lexer.d.ts

@@ -0,0 +1,37 @@
+/** A raw object as it appears in the file, before schema interpretation. */
+export interface RawObject {
+    /** Type name exactly as written, e.g. `BuildingSurface:Detailed`. */
+    typeName: string;
+    /** Comma-separated values after the type name, trimmed, comments stripped. */
+    values: string[];
+    /** 1-based line where the object starts, for diagnostics. */
+    line: number;
+}
+export interface LexDiagnostic {
+    message: string;
+    line: number;
+}
+export interface LexOptions {
+    /** Report a problem instead of throwing. */
+    onDiagnostic?: (diagnostic: LexDiagnostic) => void;
+}
+/**
+ * Split IDF text into raw objects.
+ *
+ * A hand-written character scan rather than a regex. The Python library matches
+ * objects with a `(?:[^;!]*(?:![^\n]*\n)?)*?` inner loop; that is a nested
+ * quantifier, so it backtracks badly on malformed input and cannot report where
+ * the problem was. A scanner is about the same amount of code, is linear in the
+ * input, and always knows its line number.
+ *
+ * The grammar is small:
+ *   - `!` starts a comment running to end of line
+ *   - `,` separates fields
+ *   - `;` terminates an object
+ *   - everything else is field text, trimmed
+ *
+ * There are no string literals and no escape sequences, so a comma cannot occur
+ * inside a field value. Real files depend on that.
+ */
+export declare function lex(text: string, options?: LexOptions): RawObject[];
+//# sourceMappingURL=lexer.d.ts.map

package/dist/parse/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../src/parse/lexer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,SAAS,EAAE,CAkGvE"}

package/dist/parse/lexer.js

@@ -0,0 +1,105 @@
+/**
+ * Split IDF text into raw objects.
+ *
+ * A hand-written character scan rather than a regex. The Python library matches
+ * objects with a `(?:[^;!]*(?:![^\n]*\n)?)*?` inner loop; that is a nested
+ * quantifier, so it backtracks badly on malformed input and cannot report where
+ * the problem was. A scanner is about the same amount of code, is linear in the
+ * input, and always knows its line number.
+ *
+ * The grammar is small:
+ *   - `!` starts a comment running to end of line
+ *   - `,` separates fields
+ *   - `;` terminates an object
+ *   - everything else is field text, trimmed
+ *
+ * There are no string literals and no escape sequences, so a comma cannot occur
+ * inside a field value. Real files depend on that.
+ */
+export function lex(text, options = {}) {
+    const objects = [];
+    const report = options.onDiagnostic;
+    const length = text.length;
+    /** Field text pieces, split whenever a comment interrupts a field. */
+    let chunks = [];
+    /** Fields of the object being read; index 0 ends up being the type name. */
+    let values = [];
+    let index = 0;
+    let line = 1;
+    let fieldStart = 0;
+    let objectLine = 1;
+    let objectStarted = false;
+    const endField = (end) => {
+        chunks.push(text.slice(fieldStart, end));
+        const value = chunks.join('').trim();
+        chunks = [];
+        return value;
+    };
+    while (index < length) {
+        const char = text[index];
+        if (char === '!') {
+            // Preserve any field text seen before the comment, then resume after the
+            // newline. This is what lets `Zone1,  !- Name` work: the comment is not
+            // part of the value, but the value is not finished either.
+            chunks.push(text.slice(fieldStart, index));
+            const newline = text.indexOf('\n', index);
+            if (newline === -1) {
+                index = length;
+                fieldStart = length;
+                break;
+            }
+            index = newline + 1;
+            fieldStart = index;
+            line += 1;
+            if (!objectStarted && chunks.join('').trim() === '') {
+                chunks = [];
+                objectLine = line;
+            }
+            continue;
+        }
+        if (char === ',') {
+            values.push(endField(index));
+            objectStarted = true;
+            index += 1;
+            fieldStart = index;
+            continue;
+        }
+        if (char === ';') {
+            values.push(endField(index));
+            index += 1;
+            fieldStart = index;
+            const typeName = values.shift() ?? '';
+            if (typeName === '') {
+                report?.({ message: 'Object with no type name', line: objectLine });
+            }
+            else {
+                objects.push({ typeName, values, line: objectLine });
+            }
+            values = [];
+            objectStarted = false;
+            objectLine = line;
+            continue;
+        }
+        if (char === '\n') {
+            line += 1;
+            if (!objectStarted &&
+                chunks.join('').trim() === '' &&
+                text.slice(fieldStart, index).trim() === '') {
+                // Blank line before any object content: keep the start line current.
+                chunks = [];
+                fieldStart = index + 1;
+                objectLine = line;
+            }
+        }
+        index += 1;
+    }
+    const trailing = (chunks.join('') + text.slice(fieldStart, length)).trim();
+    if (trailing !== '' || values.length > 0) {
+        report?.({
+            message: `Unterminated object near "${trailing.slice(0, 40) || values[0]}" (missing ";")`,
+            line: objectLine,
+        });
+    }
+    return objects;
+}
+//# sourceMappingURL=lexer.js.map

package/dist/parse/lexer.js.map

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

package/dist/references.d.ts

@@ -0,0 +1,56 @@
+import type { IdfObject } from './object.js';
+/** One field of one object pointing at a name. */
+export interface ReferenceEdge {
+    readonly from: IdfObject;
+    readonly field: string;
+    readonly target: string;
+    /**
+     * Repeat index, when the field lives inside an extensible group. Absent for
+     * ordinary positional fields, which is what distinguishes the two.
+     */
+    readonly index?: number;
+}
+/**
+ * Live index of every name-to-name reference in a document.
+ *
+ * Kept current by the document as objects are added, removed, renamed, and
+ * edited, so `referencing()` is a lookup rather than a scan. EnergyPlus models
+ * are dense with references (every surface names a zone and a construction,
+ * every construction names materials), and the rename-propagation behaviour
+ * that makes the library useful depends on this being exact.
+ *
+ * Names are matched case-insensitively, because EnergyPlus resolves them that
+ * way, but the original casing is preserved for round-tripping.
+ */
+export declare class ReferenceGraph {
+    #private;
+    /** Record that `obj.field` points at `target`. */
+    add(obj: IdfObject, field: string, target: string, index?: number): void;
+    /** Index every reference field of an object at once. */
+    addObject(obj: IdfObject): void;
+    /** Drop every edge originating from an object. */
+    removeObject(obj: IdfObject): void;
+    /** Update the edge for a single field after its value changed. */
+    updateField(obj: IdfObject, field: string, previous: unknown, next: unknown): void;
+    /** Edges pointing at a name. */
+    referencing(name: string): ReferenceEdge[];
+    /** Objects that reference a name, deduplicated. */
+    referencingObjects(name: string): IdfObject[];
+    /** Names an object points at. */
+    referencedBy(obj: IdfObject): string[];
+    /** Whether anything points at this name. */
+    isReferenced(name: string): boolean;
+    /**
+     * Rewrite every edge pointing at `previous` to point at `next`.
+     *
+     * Only updates the index. The document is responsible for writing the new
+     * value into the referencing objects' fields, which it does without going
+     * back through the setter hook to avoid re-entering this method.
+     */
+    retarget(previous: string, next: string): ReferenceEdge[];
+    /** Edges whose target does not exist. `valid` holds lowercased names. */
+    dangling(valid: ReadonlySet<string>): ReferenceEdge[];
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;;IAMzB,kDAAkD;IAClD,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBxE,wDAAwD;IACxD,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAM/B,kDAAkD;IAClD,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAalC,kEAAkE;IAClE,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAqBlF,gCAAgC;IAChC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAK1C,mDAAmD;IACnD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAM7C,iCAAiC;IACjC,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE;IAKtC,4CAA4C;IAC5C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAiBzD,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,EAAE;IASrD,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI,MAAM,CAIjB;CACF"}

package/dist/references.js

@@ -0,0 +1,147 @@
+/**
+ * Live index of every name-to-name reference in a document.
+ *
+ * Kept current by the document as objects are added, removed, renamed, and
+ * edited, so `referencing()` is a lookup rather than a scan. EnergyPlus models
+ * are dense with references (every surface names a zone and a construction,
+ * every construction names materials), and the rename-propagation behaviour
+ * that makes the library useful depends on this being exact.
+ *
+ * Names are matched case-insensitively, because EnergyPlus resolves them that
+ * way, but the original casing is preserved for round-tripping.
+ */
+export class ReferenceGraph {
+    /** lowercased target name -> edges pointing at it. */
+    #incoming = new Map();
+    /** object -> edges originating from it. */
+    #outgoing = new Map();
+    /** Record that `obj.field` points at `target`. */
+    add(obj, field, target, index) {
+        if (target === '')
+            return;
+        const edge = Object.freeze({ from: obj, field, target, index });
+        const key = target.toLowerCase();
+        let incoming = this.#incoming.get(key);
+        if (incoming === undefined) {
+            incoming = new Set();
+            this.#incoming.set(key, incoming);
+        }
+        incoming.add(edge);
+        let outgoing = this.#outgoing.get(obj);
+        if (outgoing === undefined) {
+            outgoing = new Set();
+            this.#outgoing.set(obj, outgoing);
+        }
+        outgoing.add(edge);
+    }
+    /** Index every reference field of an object at once. */
+    addObject(obj) {
+        for (const { field, target, index } of obj.outgoingReferences()) {
+            this.add(obj, field, target, index);
+        }
+    }
+    /** Drop every edge originating from an object. */
+    removeObject(obj) {
+        const outgoing = this.#outgoing.get(obj);
+        if (outgoing === undefined)
+            return;
+        for (const edge of outgoing) {
+            const key = edge.target.toLowerCase();
+            const incoming = this.#incoming.get(key);
+            if (incoming === undefined)
+                continue;
+            incoming.delete(edge);
+            if (incoming.size === 0)
+                this.#incoming.delete(key);
+        }
+        this.#outgoing.delete(obj);
+    }
+    /** Update the edge for a single field after its value changed. */
+    updateField(obj, field, previous, next) {
+        if (typeof previous === 'string' && previous !== '') {
+            const key = previous.toLowerCase();
+            const incoming = this.#incoming.get(key);
+            const outgoing = this.#outgoing.get(obj);
+            if (incoming !== undefined && outgoing !== undefined) {
+                for (const edge of outgoing) {
+                    // `index !== undefined` marks an edge inside an extensible group.
+                    // Those are re-indexed wholesale, so a positional-field update must
+                    // not consume one that happens to share the field name.
+                    if (edge.field !== field || edge.index !== undefined)
+                        continue;
+                    outgoing.delete(edge);
+                    incoming.delete(edge);
+                    break;
+                }
+                if (incoming.size === 0)
+                    this.#incoming.delete(key);
+            }
+        }
+        if (typeof next === 'string' && next !== '')
+            this.add(obj, field, next);
+    }
+    /** Edges pointing at a name. */
+    referencing(name) {
+        const edges = this.#incoming.get(name.toLowerCase());
+        return edges === undefined ? [] : [...edges];
+    }
+    /** Objects that reference a name, deduplicated. */
+    referencingObjects(name) {
+        const seen = new Set();
+        for (const edge of this.referencing(name))
+            seen.add(edge.from);
+        return [...seen];
+    }
+    /** Names an object points at. */
+    referencedBy(obj) {
+        const edges = this.#outgoing.get(obj);
+        return edges === undefined ? [] : [...new Set([...edges].map((e) => e.target))];
+    }
+    /** Whether anything points at this name. */
+    isReferenced(name) {
+        return (this.#incoming.get(name.toLowerCase())?.size ?? 0) > 0;
+    }
+    /**
+     * Rewrite every edge pointing at `previous` to point at `next`.
+     *
+     * Only updates the index. The document is responsible for writing the new
+     * value into the referencing objects' fields, which it does without going
+     * back through the setter hook to avoid re-entering this method.
+     */
+    retarget(previous, next) {
+        const key = previous.toLowerCase();
+        const edges = this.#incoming.get(key);
+        if (edges === undefined)
+            return [];
+        const affected = [...edges];
+        this.#incoming.delete(key);
+        for (const edge of affected) {
+            this.#outgoing.get(edge.from)?.delete(edge);
+        }
+        for (const edge of affected) {
+            this.add(edge.from, edge.field, next, edge.index);
+        }
+        return affected;
+    }
+    /** Edges whose target does not exist. `valid` holds lowercased names. */
+    dangling(valid) {
+        const out = [];
+        for (const [key, edges] of this.#incoming) {
+            if (valid.has(key))
+                continue;
+            out.push(...edges);
+        }
+        return out;
+    }
+    clear() {
+        this.#incoming.clear();
+        this.#outgoing.clear();
+    }
+    get size() {
+        let total = 0;
+        for (const edges of this.#incoming.values())
+            total += edges.size;
+        return total;
+    }
+}
+//# sourceMappingURL=references.js.map

package/dist/references.js.map

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

package/dist/shape.d.ts

@@ -0,0 +1,54 @@
+import type { SlimType } from '@idfkit/schemas';
+import type { IdfObject } from './object.js';
+/**
+ * Per-object-type prototype carrying real accessors for every field.
+ *
+ * The Python library resolves `zone.ceiling_height` through `__getattr__`. The
+ * mechanical translation of that is a `Proxy`, which we deliberately do not use:
+ * proxies defeat V8's inline caches, and more importantly they are invisible to
+ * TypeScript, so nothing would autocomplete. Instead each object type gets one
+ * prototype with `Object.defineProperty` accessors, built once and shared by
+ * every instance of that type. Property access is then an ordinary monomorphic
+ * lookup, and the generated `.d.ts` interfaces describe it statically.
+ *
+ * Shapes are keyed by the schema definition object rather than by type name.
+ * Because the schema bundle is content-addressed, `Zone` in 9.4.0 and `Zone` in
+ * 26.1.0 are the same frozen definition, so they share one shape and one
+ * prototype. Cross-version documents stay monomorphic for free.
+ */
+export declare class ObjectShape {
+    readonly typeName: string;
+    readonly type: SlimType;
+    readonly proto: object;
+    /** Field names in IDF positional order, excluding the name field. */
+    readonly fields: readonly string[];
+    /** Fields that point into a reference list, i.e. foreign keys. */
+    readonly refFields: readonly string[];
+    /**
+     * Fields *inside* the extensible group that point into a reference list.
+     *
+     * Kept separate from `refFields` because these live in `type.x.fields`, not
+     * the positional field list, and so need the repeat index to address them.
+     * Ignoring them is not cosmetic: `ZoneList`, `Branch`, and the supply/return
+     * paths carry all of their references here, so leaving them out of the graph
+     * makes `rename()` silently produce a broken model.
+     */
+    readonly extensibleRefFields: readonly string[];
+    /** Fields whose value declares a name other objects may reference. */
+    readonly keyFields: readonly string[];
+    /** Extensible array key (`vertices`), if this type has one. */
+    readonly extensibleKey: string | undefined;
+    /** Whether the object carries a name (most do; `Version` does not). */
+    readonly named: boolean;
+    constructor(typeName: string, type: SlimType, base: object);
+}
+/**
+ * Get (or build) the shape for an object type.
+ *
+ * `base` is `IdfObject.prototype`, threaded in rather than imported to keep
+ * this module free of a cycle with `object.ts`.
+ */
+export declare function shapeFor(typeName: string, type: SlimType, base: object): ObjectShape;
+/** Number of distinct shapes built, for tests and diagnostics. */
+export declare function shapeOf(obj: IdfObject): ObjectShape;
+//# sourceMappingURL=shape.d.ts.map

package/dist/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../src/shape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM;CA4B3D;AA0BD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAYpF;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,CAEnD"}