@idfkit/core 0.1.0 → 0.2.0-rc.1

package/dist/introspect/describe.d.ts

@@ -0,0 +1,106 @@
+import type { Schema } from '@idfkit/schemas';
+/**
+ * Description of a single field in an EnergyPlus object type.
+ *
+ * The field set mirrors Python's `idfkit.introspection.FieldDescription`
+ * one-for-one, snake_case renamed to camelCase. Every member is always present,
+ * so a description can be diffed against the Python dataclass key by key;
+ * Python's `str | None` becomes `string | undefined`.
+ */
+export interface FieldDescription {
+    /** Field name in epJSON spelling, e.g. `x_origin`. */
+    readonly name: string;
+    /**
+     * epJSON JSON-Schema type: `"number"`, `"string"`, `"integer"`, `"array"`, or
+     * a pipe-delimited union in declaration order for heterogeneous `anyOf`
+     * fields, e.g. `"number|string"` for `Schedule:Compact`'s extensible `field`.
+     *
+     * `undefined` when the field appears in the positional order but carries no
+     * schema definition at all.
+     */
+    readonly fieldType: string | undefined;
+    /** Whether the field is listed in the object's `required` array. */
+    readonly required: boolean;
+    readonly default: string | number | undefined;
+    /** SI units, e.g. `"m"`, `"W/m-K"`. */
+    readonly units: string | undefined;
+    /**
+     * Permitted values for a choice field.
+     *
+     * Numbers rather than strings for the handful of fields that express a choice
+     * numerically, matching Python, which also hands back the raw JSON values.
+     */
+    readonly enumValues: readonly (string | number)[] | undefined;
+    readonly minimum: number | undefined;
+    readonly maximum: number | undefined;
+    /**
+     * Exclusive minimum, as the schema for this version declares it.
+     *
+     * `true` rather than a number on 8.9.0 through 9.5.0, whose draft-04 schemas
+     * use the keyword as a flag qualifying `minimum` instead of as a bound. Python
+     * reports the same raw value, so a caller comparing the two sides sees no
+     * difference; a caller comparing a value against it must check the type first.
+     */
+    readonly exclusiveMinimum: number | boolean | undefined;
+    /** Exclusive maximum. Number or boolean, exactly as `exclusiveMinimum`. */
+    readonly exclusiveMaximum: number | boolean | undefined;
+    /**
+     * Field documentation note.
+     *
+     * Always `undefined` here. The slim schema bundle deliberately drops `note`
+     * (see the header of `@idfkit/schemas`'s `types.ts`), and no other faithful
+     * source for it exists in this package. It is kept in the type because the
+     * naming register requires the same field set on both sides, and because
+     * inventing a value from the field name would be worse than admitting the
+     * absence.
+     */
+    readonly note: string | undefined;
+    /** Whether this field points into another object's reference list. */
+    readonly isReference: boolean;
+    /** Reference list names this field points into. */
+    readonly objectList: readonly string[] | undefined;
+}
+/**
+ * Description of an EnergyPlus object type.
+ *
+ * Field set mirrors Python's `idfkit.introspection.ObjectDescription`.
+ */
+export interface ObjectDescription {
+    /** Canonical object type name, e.g. `"Zone"`. */
+    readonly objType: string;
+    /**
+     * Object memo from the schema.
+     *
+     * Always `undefined` here, for the same reason as `FieldDescription.note`:
+     * the slim bundle drops `memo`, and this package has no faithful source for
+     * it. See that member's note.
+     */
+    readonly memo: string | undefined;
+    readonly fields: readonly FieldDescription[];
+    /** Required field names, in schema order. */
+    readonly requiredFields: readonly string[];
+    /** Whether the type carries a name field. `Version` and friends do not. */
+    readonly hasName: boolean;
+    /** Whether the type has a repeating extensible group. */
+    readonly isExtensible: boolean;
+    /** Number of fields in one extensible repeat group. */
+    readonly extensibleSize: number | undefined;
+}
+/**
+ * Describe an EnergyPlus object type: its fields, their order, and their
+ * constraints.
+ *
+ * Synchronous and pure, like the rest of `@idfkit/core`'s root entry: the
+ * schema is already in memory, and this only reads it.
+ *
+ * Ports `idfkit.introspection.describe_object_type`. Where the slim schema
+ * cannot reproduce Python exactly the loss is recorded in a comment at the
+ * point it happens rather than papered over with a plausible substitute.
+ *
+ * @throws If `objType` is not defined in this schema version. The message is
+ * the one `Schema.require` already produces everywhere else in the package;
+ * Python raises `UnknownObjectTypeError`, which has no registered TypeScript
+ * counterpart and so must not become a new exported class.
+ */
+export declare function describeObjectType(schema: Schema, objType: string): ObjectDescription;
+//# sourceMappingURL=describe.d.ts.map

package/dist/introspect/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/introspect/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,iBAAiB,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA+BrF"}

package/dist/introspect/describe.js

@@ -0,0 +1,168 @@
+/**
+ * Describe an EnergyPlus object type: its fields, their order, and their
+ * constraints.
+ *
+ * Synchronous and pure, like the rest of `@idfkit/core`'s root entry: the
+ * schema is already in memory, and this only reads it.
+ *
+ * Ports `idfkit.introspection.describe_object_type`. Where the slim schema
+ * cannot reproduce Python exactly the loss is recorded in a comment at the
+ * point it happens rather than papered over with a plausible substitute.
+ *
+ * @throws If `objType` is not defined in this schema version. The message is
+ * the one `Schema.require` already produces everywhere else in the package;
+ * Python raises `UnknownObjectTypeError`, which has no registered TypeScript
+ * counterpart and so must not become a new exported class.
+ */
+export function describeObjectType(schema, objType) {
+    const type = schema.require(objType);
+    // Exact-cased input resolves to itself, so this matches Python's verbatim
+    // echo of the argument for every name Python accepts.
+    const canonical = schema.resolve(objType) ?? objType;
+    const properties = mergedProperties(type);
+    const requiredFields = type.r ?? [];
+    const required = new Set(requiredFields);
+    const extensible = type.x;
+    const fieldNames = orderedFieldNames(type);
+    const fields = fieldNames.map((name) => describeField(name, properties[name], required.has(name)));
+    return {
+        objType: canonical,
+        // Not carried by the slim bundle. See ObjectDescription.memo.
+        memo: undefined,
+        fields,
+        requiredFields: [...requiredFields],
+        hasName: type.anon !== 1,
+        isExtensible: extensible !== undefined,
+        // Python reads `extensible_size` straight from the schema. The slim bundle
+        // drops that key, but it is exactly the repeat-group width, which survives
+        // as `x.fields.length`. Verified equal for every extensible type in all 17
+        // bundled versions, so this is a derivation, not an approximation.
+        extensibleSize: extensible === undefined ? undefined : extensible.fields.length,
+    };
+}
+/**
+ * Field names in the order Python produces them.
+ *
+ * @internal
+ */
+function orderedFieldNames(type) {
+    // Python's `get_field_names` returns `legacy_idd.fields[1:]` — it drops the
+    // first entry positionally, on the assumption that it is always the name.
+    // That holds for every named type in all 17 bundled versions, but 154 types
+    // in 26.1.0 are anonymous, and for those the first entry is a real field
+    // (`GlobalGeometryRules.starting_vertex_position`, `Output:Variable.key_value`)
+    // which Python silently drops. Dropping positionally rather than filtering on
+    // `!== 'name'` is what keeps this port in agreement with the oracle; the
+    // divergence to close is in Python, not here.
+    const names = type.f.slice(1);
+    // No legacy field order (or only the name): Python falls back to the key order
+    // of the merged property map. Only the fixed half is taken from `p` here; the
+    // extensible half is appended below from `x.fields`, which is an array and so
+    // keeps its declaration order. Taking it from `x.p` instead would be wrong:
+    // the bundle content-addresses each definition through a canonical serializer
+    // that sorts object keys, so every `Record` in it is in alphabetical order,
+    // not schema order. `AvailabilityManagerAssignmentList` is the type that shows
+    // it — its two extensible fields are declared object-type first and sort
+    // name first.
+    const ordered = names.length > 0 ? names : Object.keys(type.p);
+    if (type.x !== undefined) {
+        for (const name of type.x.fields) {
+            if (!ordered.includes(name))
+                ordered.push(name);
+        }
+    }
+    return ordered;
+}
+/**
+ * Python flattens each extension array's `items.properties` into the top-level
+ * property map so extensible fields look up the same way as fixed ones. Spread
+ * order reproduces that: existing keys keep their position, new ones append.
+ *
+ * @internal
+ */
+function mergedProperties(type) {
+    return type.x === undefined ? type.p : { ...type.p, ...type.x.p };
+}
+/** @internal */
+function describeField(name, field, required) {
+    if (field === undefined) {
+        // In the positional order but absent from the schema. Python reaches the
+        // same state via `properties.get(field_name, {})`.
+        return {
+            name,
+            fieldType: undefined,
+            required,
+            default: undefined,
+            units: undefined,
+            enumValues: undefined,
+            minimum: undefined,
+            maximum: undefined,
+            exclusiveMinimum: undefined,
+            exclusiveMaximum: undefined,
+            note: undefined,
+            isReference: false,
+            objectList: undefined,
+        };
+    }
+    // `auto` marks a field the bundle collapsed from `anyOf: [number, string]`.
+    // Python's `describe_object_type` reads `minimum`/`maximum`/`exclusiveMinimum`/
+    // `exclusiveMaximum` from the *top level* of the field schema only, and no
+    // `anyOf` field in any of the 17 bundled versions carries those keys at the
+    // top level — they live on the numeric branch, which that function never looks
+    // at. The bundle hoists them; Python reports null. Suppressing them here is
+    // what makes the two sides agree. Validation is a separate question and reads
+    // the branch properly on both sides; see `validate/`.
+    const collapsedAnyOf = field.auto === 1;
+    return {
+        name,
+        fieldType: fieldTypeOf(field),
+        required,
+        default: field.d,
+        units: field.u,
+        enumValues: field.e === undefined ? undefined : [...field.e],
+        minimum: collapsedAnyOf ? undefined : field.min,
+        maximum: collapsedAnyOf ? undefined : field.max,
+        exclusiveMinimum: collapsedAnyOf ? undefined : field.xmin,
+        exclusiveMaximum: collapsedAnyOf ? undefined : field.xmax,
+        note: undefined,
+        isReference: field.ol !== undefined,
+        objectList: field.ol === undefined ? undefined : [...field.ol],
+    };
+}
+/**
+ * Map the slim storage class back to the epJSON JSON-Schema type string Python
+ * reports.
+ *
+ * The bundle stores four storage classes where Python reports the raw `type`
+ * key, so the mapping is not automatically one-to-one. Measured against all 17
+ * bundled schemas it is, with one exception:
+ *
+ * - `'a'` is `"string"`. Every `'a'` field is a raw `"type": "string"`, or an
+ *   enum-only field, which Python also calls `"string"`.
+ * - `'n'` is `"number"`, and `"number|string"` when `auto` is set. `auto` is set
+ *   exactly when the raw field was `anyOf: [{number}, {string}]` — 13052 such
+ *   fields across all versions, every one of them in that branch order, so the
+ *   union string is reconstructed exactly rather than guessed.
+ * - `'i'` is `"integer"`, and `"integer|string"` when `auto` is set, the
+ *   `anyOf: [{integer}, {string}]` shape carried by one field per version from
+ *   9.3.0 on, `AirTerminal:SingleDuct:ConstantVolume:CooledBeam.number_of_beams`.
+ *   The bundle also folds `"type": "number"` carrying `"data_type": "integer"`
+ *   into `'i'`, which would report `"number"` in Python — but no schema in any
+ *   bundled version actually uses that form.
+ * - `'arr'` is `"array"`.
+ *
+ * @internal
+ */
+function fieldTypeOf(field) {
+    switch (field.t) {
+        case 'arr':
+            return 'array';
+        case 'i':
+            return field.auto === 1 ? 'integer|string' : 'integer';
+        case 'n':
+            return field.auto === 1 ? 'number|string' : 'number';
+        case 'a':
+            return 'string';
+    }
+}
+//# sourceMappingURL=describe.js.map

package/dist/introspect/describe.js.map

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

package/dist/node.d.ts

@@ -6,7 +6,7 @@
  * to be async "just in case" and browser bundles never pull in `node:fs`.
  */
 import { SchemaBundle, type Schema } from '@idfkit/schemas';
-import type { IDFDocument } from './document.js';
+import type { IdfDocument } from './document.js';
 import { type ParseOptions, type ParseResult } from './parse/idf.js';
 import type { AnyTypeMap, UntypedMap } from './typemap.js';
 import { type WriteEpJsonOptions } from './write/epjson.js';
@@ -28,13 +28,13 @@ export interface LoadOptions extends ParseOptions {
  */
 export declare function schemaFor(detected: string | undefined, options?: LoadOptions): Promise<Schema>;
 /** Read and parse an IDF file. */
-export declare function loadIdf<M extends AnyTypeMap = UntypedMap>(path: string, options?: LoadOptions): Promise<IDFDocument<M>>;
+export declare function loadIdf<M extends AnyTypeMap = UntypedMap>(path: string, options?: LoadOptions): Promise<IdfDocument<M>>;
 /** Read and parse an IDF file, keeping non-fatal diagnostics. */
 export declare function loadIdfWithDiagnostics<M extends AnyTypeMap = UntypedMap>(path: string, options?: LoadOptions): Promise<ParseResult<M>>;
 /** Read and parse an epJSON file. */
-export declare function loadEpJson<M extends AnyTypeMap = UntypedMap>(path: string, options?: LoadOptions): Promise<IDFDocument<M>>;
+export declare function loadEpJson<M extends AnyTypeMap = UntypedMap>(path: string, options?: LoadOptions): Promise<IdfDocument<M>>;
 /** Write a document to an IDF file. */
-export declare function saveIdf<M extends AnyTypeMap>(document: IDFDocument<M>, path: string, options?: WriteIdfOptions): Promise<void>;
+export declare function saveIdf<M extends AnyTypeMap>(document: IdfDocument<M>, path: string, options?: WriteIdfOptions): Promise<void>;
 /** Write a document to an epJSON file. */
-export declare function saveEpJson<M extends AnyTypeMap>(document: IDFDocument<M>, path: string, options?: WriteEpJsonOptions): Promise<void>;
+export declare function saveEpJson<M extends AnyTypeMap>(document: IdfDocument<M>, path: string, options?: WriteEpJsonOptions): Promise<void>;
 //# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -8,8 +8,8 @@
 import { readFile, writeFile } from 'node:fs/promises';
 import { SchemaBundle } from '@idfkit/schemas';
 import { localBundle } from '@idfkit/schemas/node';
-import { detectEpJsonVersion, parseEpJson } from './parse/epjson.js';
-import { detectVersion, parseIdf } from './parse/idf.js';
+import { getEpJsonVersion, parseEpJson } from './parse/epjson.js';
+import { getIdfVersion, parseIdf } from './parse/idf.js';
 import { resolveVersion } from './versions.js';
 import { writeEpJson } from './write/epjson.js';
 import { writeIdf } from './write/idf.js';
@@ -50,13 +50,13 @@ export async function loadIdfWithDiagnostics(path, options = {}) {
     // models routinely contain single high bytes (degree signs, accented station
     // names) that are not valid utf-8 and would otherwise decode to U+FFFD.
     const text = await readFile(path, 'latin1');
-    const schema = await schemaFor(detectVersion(text), options);
+    const schema = await schemaFor(getIdfVersion(text), options);
     return parseIdf(text, schema, options);
 }
 /** Read and parse an epJSON file. */
 export async function loadEpJson(path, options = {}) {
     const text = await readFile(path, 'utf8');
-    const schema = await schemaFor(detectEpJsonVersion(text), options);
+    const schema = await schemaFor(getEpJsonVersion(text), options);
     return parseEpJson(text, schema, options).document;
 }
 /** Write a document to an IDF file. */

package/dist/node.js.map

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

package/dist/object.d.ts

@@ -12,7 +12,7 @@ export type FieldValues = Record<string, StoredValue | null | undefined>;
 /**
  * Something that wants to know when an object changes.
  *
- * Implemented by `IDFDocument`. Declared as an interface so a detached object
+ * Implemented by `IdfDocument`. Declared as an interface so a detached object
  * has no dependency on the document at all.
  */
 export interface ObjectOwner {

package/dist/parse/epjson.d.ts

@@ -12,5 +12,5 @@ export type EpJson = Record<string, Record<string, Record<string, unknown>>>;
  */
 export declare function parseEpJson<M extends AnyTypeMap = UntypedMap>(source: string | EpJson, schema: Schema, options?: ParseOptions): ParseResult<M>;
 /** Read the version identifier from epJSON without a schema. */
-export declare function detectEpJsonVersion(source: string | EpJson): string | undefined;
+export declare function getEpJsonVersion(source: string | EpJson): string | undefined;
 //# sourceMappingURL=epjson.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"epjson.d.ts","sourceRoot":"","sources":["../../src/parse/epjson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAmB,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG3E,2DAA2D;AAC3D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAC3D,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,WAAW,CAAC,CAAC,CAAC,CA6DhB;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB/E"}
+{"version":3,"file":"epjson.d.ts","sourceRoot":"","sources":["../../src/parse/epjson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAmB,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG3E,2DAA2D;AAC3D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAC3D,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,WAAW,CAAC,CAAC,CAAC,CA6DhB;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB5E"}

package/dist/parse/epjson.js

@@ -1,4 +1,4 @@
-import { IDFDocument } from '../document.js';
+import { IdfDocument } from '../document.js';
 import { IdfParseError } from './idf.js';
 /**
  * Parse epJSON into a document.
@@ -26,7 +26,7 @@ export function parseEpJson(source, schema, options = {}) {
             line: 1,
         });
     }
-    const document = new IDFDocument(schema);
+    const document = new IdfDocument(schema);
     for (const [typeName, body] of Object.entries(root)) {
         const canonical = schema.resolve(typeName);
         if (canonical === undefined) {
@@ -68,7 +68,7 @@ export function parseEpJson(source, schema, options = {}) {
     return { document, diagnostics };
 }
 /** Read the version identifier from epJSON without a schema. */
-export function detectEpJsonVersion(source) {
+export function getEpJsonVersion(source) {
     let root;
     try {
         root = typeof source === 'string' ? JSON.parse(source) : source;

package/dist/parse/epjson.js.map

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

package/dist/parse/idf.d.ts

@@ -1,5 +1,5 @@
 import type { Schema } from '@idfkit/schemas';
-import { IDFDocument } from '../document.js';
+import { IdfDocument } from '../document.js';
 import type { AnyTypeMap, UntypedMap } from '../typemap.js';
 import { type LexDiagnostic } from './lexer.js';
 export interface ParseDiagnostic extends LexDiagnostic {
@@ -16,7 +16,7 @@ export interface ParseOptions {
     onDiagnostic?: (diagnostic: ParseDiagnostic) => void;
 }
 export interface ParseResult<M extends AnyTypeMap = UntypedMap> {
-    document: IDFDocument<M>;
+    document: IdfDocument<M>;
     diagnostics: ParseDiagnostic[];
 }
 /**
@@ -40,5 +40,5 @@ export declare class IdfParseError extends Error {
  * version lives inside the file. This does the minimum scan needed to break
  * the cycle, and does not validate anything else.
  */
-export declare function detectVersion(text: string): string | undefined;
+export declare function getIdfVersion(text: string): string | undefined;
 //# sourceMappingURL=idf.d.ts.map

package/dist/parse/idf.js

@@ -1,4 +1,4 @@
-import { IDFDocument } from '../document.js';
+import { IdfDocument } from '../document.js';
 import { lex } from './lexer.js';
 /**
  * Parse IDF text into a document.
@@ -19,7 +19,7 @@ export function parseIdf(text, schema, options = {}) {
         options.onDiagnostic?.(diagnostic);
     };
     const raw = lex(text, { onDiagnostic: report });
-    const document = new IDFDocument(schema);
+    const document = new IdfDocument(schema);
     for (const object of raw) {
         const canonical = schema.resolve(object.typeName);
         if (canonical === undefined) {
@@ -151,7 +151,7 @@ export class IdfParseError extends Error {
  * 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) {
+export function getIdfVersion(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

package/dist/typemap.d.ts

@@ -1,11 +1,13 @@
 /**
  * Version-specific static typing, with no runtime cost at all.
  *
- * A generated module (`@idfkit/core/types/v26-1`) exports one interface per
- * object type plus a `TypeMap` joining type name to interface. A document
- * parameterized by that map resolves `doc.all('Zone')` to a collection of
- * objects with `Zone`'s fields, and the editor completes among all 858 type
- * names as you type the string.
+ * An opt-in package (`@idfkit/types-v26-1`, one per EnergyPlus version) exports
+ * one interface per object type plus a `TypeMap` joining type name to
+ * interface. A document parameterized by that map resolves `doc.all('Zone')` to
+ * a collection of objects with `Zone`'s fields, and the editor completes among
+ * all 858 type names as you type the string. Install none of them and every
+ * document is an `UntypedMap`: nothing stops working, the field names are
+ * simply not checked.
  *
  * This is where JavaScript beats the Python original rather than imitating it.
  * `__getattr__` resolves names at runtime, so an editor cannot see them and a

package/dist/typemap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typemap.d.ts","sourceRoot":"","sources":["../src/typemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElF,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAC5E,CAAC,CAAC,CAAC,CAAC,GACJ,UAAU,CAAC;AAEf;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAC5E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACb,WAAW,CAAC"}
+{"version":3,"file":"typemap.d.ts","sourceRoot":"","sources":["../src/typemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElF,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAC5E,CAAC,CAAC,CAAC,CAAC,GACJ,UAAU,CAAC;AAEf;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,CAAC,GAC5E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACb,WAAW,CAAC"}

package/dist/typemap.js

@@ -1,11 +1,13 @@
 /**
  * Version-specific static typing, with no runtime cost at all.
  *
- * A generated module (`@idfkit/core/types/v26-1`) exports one interface per
- * object type plus a `TypeMap` joining type name to interface. A document
- * parameterized by that map resolves `doc.all('Zone')` to a collection of
- * objects with `Zone`'s fields, and the editor completes among all 858 type
- * names as you type the string.
+ * An opt-in package (`@idfkit/types-v26-1`, one per EnergyPlus version) exports
+ * one interface per object type plus a `TypeMap` joining type name to
+ * interface. A document parameterized by that map resolves `doc.all('Zone')` to
+ * a collection of objects with `Zone`'s fields, and the editor completes among
+ * all 858 type names as you type the string. Install none of them and every
+ * document is an `UntypedMap`: nothing stops working, the field names are
+ * simply not checked.
  *
  * This is where JavaScript beats the Python original rather than imitating it.
  * `__getattr__` resolves names at runtime, so an editor cannot see them and a

package/dist/typemap.js.map

@@ -1 +1 @@
-{"version":3,"file":"typemap.js","sourceRoot":"","sources":["../src/typemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}
+{"version":3,"file":"typemap.js","sourceRoot":"","sources":["../src/typemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/validate/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Schema validation.
+ *
+ * Five names, matching the Python library's `idfkit.validation` one for one
+ * under the field-casing rule. Everything else in this directory is an
+ * implementation detail.
+ */
+export { validateDocument, validateObject } from './validate.js';
+export { Severity } from './types.js';
+export type { ValidationError, ValidationResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/validate/index.js

@@ -0,0 +1,10 @@
+/**
+ * Schema validation.
+ *
+ * Five names, matching the Python library's `idfkit.validation` one for one
+ * under the field-casing rule. Everything else in this directory is an
+ * implementation detail.
+ */
+export { validateDocument, validateObject } from './validate.js';
+export { Severity } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/validate/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The vocabulary validation reports in.
+ *
+ * A finding is a record, not a throw. The Python original names the type
+ * `ValidationError` and this port keeps that spelling, but nothing here is ever
+ * raised: a finding carries a severity and a location, and callers collect them
+ * into a `ValidationResult` and decide what to do. Naming it after an exception
+ * and then returning it is the one thing the naming register asks both
+ * libraries to keep in step, so the name stays.
+ */
+/**
+ * Severity of a validation finding.
+ *
+ * Both a value and a type. The value gives the Python original's
+ * `Severity.ERROR` spelling; the type is the string union that a `'error'`
+ * literal satisfies, which is how the same three strings reach the wire in both
+ * languages. The strings themselves are load-bearing: the conformance corpus
+ * compares them across the two implementations.
+ */
+export declare const Severity: Readonly<{
+    readonly ERROR: "error";
+    readonly WARNING: "warning";
+    readonly INFO: "info";
+}>;
+export type Severity = (typeof Severity)[keyof typeof Severity];
+/**
+ * One validation finding.
+ *
+ * `code` is the machine-readable part and is shared with the Python library
+ * verbatim (`E001`…`E010`, `W002`, `W003`). `message` is for a human and is
+ * *not* guaranteed identical across the two languages: number formatting and
+ * type names differ between the runtimes. Match on `code`.
+ */
+export interface ValidationError {
+    /** How serious the finding is. */
+    readonly severity: Severity;
+    /** Object type the finding was found on. */
+    readonly objType: string;
+    /** Object name the finding was found on. Empty for anonymous objects. */
+    readonly objName: string;
+    /** Field the finding concerns, or `undefined` when it concerns the object. */
+    readonly field: string | undefined;
+    /** Human-readable description. */
+    readonly message: string;
+    /** Machine-readable code, stable across languages. */
+    readonly code: string;
+}
+/**
+ * Everything one validation run found, split by severity.
+ *
+ * `isValid` and `totalIssues` are computed once when the result is built rather
+ * than being live properties, because the arrays are read-only.
+ */
+export interface ValidationResult {
+    readonly errors: readonly ValidationError[];
+    readonly warnings: readonly ValidationError[];
+    readonly info: readonly ValidationError[];
+    /** True when `errors` is empty. Warnings and info do not make a model invalid. */
+    readonly isValid: boolean;
+    /** `errors + warnings + info`. */
+    readonly totalIssues: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/validate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validate/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ;;;;EAIV,CAAC;AAEZ,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}