@idfkit/core 0.0.1

package/dist/node.js

@@ -0,0 +1,70 @@
+/**
+ * Node-only conveniences.
+ *
+ * This is the async edge of the library. The core is sync and pure; everything
+ * that touches a disk or a network is here, so the portable surface never has
+ * to be async "just in case" and browser bundles never pull in `node:fs`.
+ */
+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 { resolveVersion } from './versions.js';
+import { writeEpJson } from './write/epjson.js';
+import { writeIdf } from './write/idf.js';
+let defaultBundle;
+/** The schema bundle shipped with `@idfkit/schemas`, created once per process. */
+export function schemas() {
+    defaultBundle ??= localBundle();
+    return defaultBundle;
+}
+/**
+ * Resolve the schema for a file whose version was detected from its contents.
+ *
+ * Exported because callers who parse text themselves still need this step, and
+ * getting it wrong (loading 26.1 for a 9.0 file) silently mis-maps every
+ * positional field rather than failing loudly.
+ */
+export async function schemaFor(detected, options = {}) {
+    const bundle = options.bundle ?? schemas();
+    if (options.version !== undefined)
+        return bundle.load(options.version);
+    if (detected === undefined) {
+        throw new Error('No Version object found. Pass `version` explicitly to parse a versionless file.');
+    }
+    const available = await bundle.versions();
+    const resolved = resolveVersion(detected, available);
+    if (resolved === undefined) {
+        throw new Error(`EnergyPlus ${detected} is not supported. Available: ${available.join(', ')}`);
+    }
+    return bundle.load(resolved);
+}
+/** Read and parse an IDF file. */
+export async function loadIdf(path, options = {}) {
+    return (await loadIdfWithDiagnostics(path, options)).document;
+}
+/** Read and parse an IDF file, keeping non-fatal diagnostics. */
+export async function loadIdfWithDiagnostics(path, options = {}) {
+    // latin-1 rather than utf-8: EnergyPlus example files and vendor-exported
+    // 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);
+    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);
+    return parseEpJson(text, schema, options).document;
+}
+/** Write a document to an IDF file. */
+export async function saveIdf(document, path, options = {}) {
+    await writeFile(path, writeIdf(document, options), 'latin1');
+}
+/** Write a document to an epJSON file. */
+export async function saveEpJson(document, path, options = {}) {
+    await writeFile(path, writeEpJson(document, options), 'utf8');
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/dist/object.d.ts

@@ -0,0 +1,114 @@
+import type { SlimField, SlimType } from '@idfkit/schemas';
+import { DATA, KEY, NAME, OWNER, SHAPE } from './internal.js';
+import { type ObjectShape } from './shape.js';
+/** A scalar field value. `undefined` means the field is absent. */
+export type FieldValue = string | number | undefined;
+/** One repeat of an extensible group, e.g. a single vertex. */
+export type ExtensibleGroup = Record<string, string | number>;
+/** Anything storable in a field slot. */
+export type StoredValue = string | number | ExtensibleGroup[];
+/** Field values accepted when constructing or updating an object. */
+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
+ * has no dependency on the document at all.
+ */
+export interface ObjectOwner {
+    onFieldChanged(obj: IdfObject, field: string, previous: unknown, next: unknown): void;
+    onNameChanged(obj: IdfObject, previous: string, next: string): void;
+}
+/**
+ * A single EnergyPlus object.
+ *
+ * Field access is via real accessors installed on a per-type prototype, so
+ * `zone.ceiling_height` is an ordinary property read that TypeScript can see
+ * (given the generated interfaces) and V8 can inline. See `shape.ts`.
+ *
+ * Field names are epJSON names (`zone_name`, `outside_boundary_condition`),
+ * not the space-separated IDD names. That is a deliberate break from the Python
+ * library's IDF-to-Python conversion: epJSON names are already valid JS
+ * identifiers and valid TS interface keys, so using them directly means the
+ * on-disk name, the runtime key, and the static type all agree.
+ */
+export declare class IdfObject {
+    readonly [DATA]: Record<string, StoredValue>;
+    readonly [SHAPE]: ObjectShape;
+    [OWNER]: ObjectOwner | undefined;
+    [NAME]: string;
+    [KEY]: string;
+    /**
+     * Objects are built through `IdfObject.create`, never `new`, because each
+     * instance's prototype depends on its object type.
+     */
+    private constructor();
+    static create(typeName: string, type: SlimType, name: string, values?: FieldValues): IdfObject;
+    /** Canonical object type name, e.g. `BuildingSurface:Detailed`. */
+    get typeName(): string;
+    /** Schema definition for this object's type. */
+    get schema(): SlimType;
+    /**
+     * The object's name, i.e. its key within its collection.
+     *
+     * Assigning propagates through the document: the collection is re-keyed and
+     * every field elsewhere in the model that referenced the old name is updated.
+     */
+    get name(): string;
+    set name(value: string);
+    /**
+     * The object's slot in its collection.
+     *
+     * Equals `name` for ordinary objects. Objects with no name, or with a blank
+     * name, get a synthetic key so they can still be stored and addressed.
+     */
+    get key(): string;
+    /** Whether this object type carries a name at all. */
+    get isNamed(): boolean;
+    /** Read a field by name. Untyped escape hatch for version-generic code. */
+    get(field: string): StoredValue | undefined;
+    /** Write a field by name, going through the same hooks as property access. */
+    set(field: string, value: StoredValue | null | undefined): void;
+    /** Apply several fields at once. */
+    update(values: FieldValues): this;
+    /** Whether the schema defines this field for this object type. */
+    hasField(field: string): boolean;
+    /** Schema definition for one field. */
+    fieldSchema(field: string): SlimField | undefined;
+    /** Field names in IDF positional order, excluding the name. */
+    get fieldNames(): readonly string[];
+    /** Field names that are actually set on this object. */
+    setFieldNames(): string[];
+    /**
+     * Repeat groups of the extensible section, e.g. the vertices of a surface.
+     *
+     * Returns a live array: pushing to it mutates the object.
+     */
+    get extensible(): ExtensibleGroup[];
+    /**
+     * Names this object's fields point at, paired with the field holding them.
+     *
+     * Extensible groups are included, with `index` naming the repeat the value
+     * sits in. Half the references in a real model live there.
+     */
+    outgoingReferences(): Array<{
+        field: string;
+        target: string;
+        index?: number;
+    }>;
+    /**
+     * Names this object contributes to the model's reference lists.
+     *
+     * Usually just `name`, but anonymous types like `FluidProperties:Name` carry
+     * their identity in an ordinary field instead, and other objects reference
+     * that value. Treating those as nameless makes every pointer at them look
+     * dangling.
+     */
+    declaredNames(): string[];
+    /** Detached deep copy, optionally renamed. Not attached to any document. */
+    clone(name?: string): IdfObject;
+    /** Plain epJSON body: field values only, without the name. */
+    toJSON(): Record<string, StoredValue>;
+    toString(): string;
+}
+//# sourceMappingURL=object.d.ts.map

package/dist/object.d.ts.map

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

package/dist/object.js

@@ -0,0 +1,224 @@
+import { DATA, KEY, NAME, OWNER, SHAPE } from './internal.js';
+import { shapeFor } from './shape.js';
+/**
+ * A single EnergyPlus object.
+ *
+ * Field access is via real accessors installed on a per-type prototype, so
+ * `zone.ceiling_height` is an ordinary property read that TypeScript can see
+ * (given the generated interfaces) and V8 can inline. See `shape.ts`.
+ *
+ * Field names are epJSON names (`zone_name`, `outside_boundary_condition`),
+ * not the space-separated IDD names. That is a deliberate break from the Python
+ * library's IDF-to-Python conversion: epJSON names are already valid JS
+ * identifiers and valid TS interface keys, so using them directly means the
+ * on-disk name, the runtime key, and the static type all agree.
+ */
+export class IdfObject {
+    /**
+     * Objects are built through `IdfObject.create`, never `new`, because each
+     * instance's prototype depends on its object type.
+     */
+    constructor() {
+        throw new Error('Use IdfObject.create()');
+    }
+    static create(typeName, type, name, values = {}) {
+        const shape = shapeFor(typeName, type, IdfObject.prototype);
+        const obj = Object.create(shape.proto);
+        Object.defineProperty(obj, DATA, { value: Object.create(null) });
+        Object.defineProperty(obj, SHAPE, { value: shape });
+        Object.defineProperty(obj, OWNER, { value: undefined, writable: true });
+        Object.defineProperty(obj, NAME, { value: name, writable: true });
+        Object.defineProperty(obj, KEY, { value: name, writable: true });
+        for (const [field, value] of Object.entries(values)) {
+            if (value === undefined || value === null)
+                continue;
+            // Rejected rather than stored: an unrecognized name has no accessor and is
+            // dropped by every writer, so accepting it here means the caller reads
+            // their value back correctly and then loses it on save. `set()` already
+            // throws on the same input; this keeps the two paths in agreement.
+            if (!Object.hasOwn(type.p, field) && field !== shape.extensibleKey) {
+                throw new Error(`"${field}" is not a field of ${typeName}`);
+            }
+            obj[DATA][field] = value;
+        }
+        return obj;
+    }
+    /** Canonical object type name, e.g. `BuildingSurface:Detailed`. */
+    get typeName() {
+        return this[SHAPE].typeName;
+    }
+    /** Schema definition for this object's type. */
+    get schema() {
+        return this[SHAPE].type;
+    }
+    /**
+     * The object's name, i.e. its key within its collection.
+     *
+     * Assigning propagates through the document: the collection is re-keyed and
+     * every field elsewhere in the model that referenced the old name is updated.
+     */
+    get name() {
+        return this[NAME];
+    }
+    set name(value) {
+        const previous = this[NAME];
+        if (previous === value)
+            return;
+        const owner = this[OWNER];
+        if (owner === undefined) {
+            this[NAME] = value;
+            // The key has to move with the name, exactly as `onNameChanged` does for
+            // an attached object. Leaving it behind means a detached rename followed
+            // by `attach()` files the object under its old name, where no lookup by
+            // its current name can reach it.
+            if (value !== '')
+                this[KEY] = value;
+            return;
+        }
+        // The document performs the rename so it can reject duplicates before
+        // anything mutates, then rewrite referencing fields.
+        owner.onNameChanged(this, previous, value);
+    }
+    /**
+     * The object's slot in its collection.
+     *
+     * Equals `name` for ordinary objects. Objects with no name, or with a blank
+     * name, get a synthetic key so they can still be stored and addressed.
+     */
+    get key() {
+        return this[KEY];
+    }
+    /** Whether this object type carries a name at all. */
+    get isNamed() {
+        return this[SHAPE].named;
+    }
+    /** Read a field by name. Untyped escape hatch for version-generic code. */
+    get(field) {
+        return this[DATA][field];
+    }
+    /** Write a field by name, going through the same hooks as property access. */
+    set(field, value) {
+        if (!this.hasField(field)) {
+            throw new Error(`"${field}" is not a field of ${this.typeName}`);
+        }
+        // Route through the accessor so reference tracking fires exactly once.
+        this[field] = value ?? undefined;
+    }
+    /** Apply several fields at once. */
+    update(values) {
+        for (const [field, value] of Object.entries(values)) {
+            this.set(field, value ?? undefined);
+        }
+        return this;
+    }
+    /** Whether the schema defines this field for this object type. */
+    hasField(field) {
+        return Object.hasOwn(this[SHAPE].type.p, field) || field === this[SHAPE].extensibleKey;
+    }
+    /** Schema definition for one field. */
+    fieldSchema(field) {
+        return this[SHAPE].type.p[field];
+    }
+    /** Field names in IDF positional order, excluding the name. */
+    get fieldNames() {
+        return this[SHAPE].fields;
+    }
+    /** Field names that are actually set on this object. */
+    setFieldNames() {
+        return this[SHAPE].fields.filter((f) => this[DATA][f] !== undefined);
+    }
+    /**
+     * Repeat groups of the extensible section, e.g. the vertices of a surface.
+     *
+     * Returns a live array: pushing to it mutates the object.
+     */
+    get extensible() {
+        const key = this[SHAPE].extensibleKey;
+        if (key === undefined)
+            return [];
+        let list = this[DATA][key];
+        if (!Array.isArray(list)) {
+            list = [];
+            this[DATA][key] = list;
+        }
+        return list;
+    }
+    /**
+     * Names this object's fields point at, paired with the field holding them.
+     *
+     * Extensible groups are included, with `index` naming the repeat the value
+     * sits in. Half the references in a real model live there.
+     */
+    outgoingReferences() {
+        const out = [];
+        for (const field of this[SHAPE].refFields) {
+            const value = this[DATA][field];
+            if (typeof value === 'string' && value !== '')
+                out.push({ field, target: value });
+        }
+        const extensibleRefs = this[SHAPE].extensibleRefFields;
+        const key = this[SHAPE].extensibleKey;
+        if (extensibleRefs.length > 0 && key !== undefined) {
+            // Read through DATA rather than the `extensible` getter, which
+            // materializes an empty array as a side effect.
+            const list = this[DATA][key];
+            if (Array.isArray(list)) {
+                list.forEach((group, index) => {
+                    for (const field of extensibleRefs) {
+                        const value = group[field];
+                        if (typeof value === 'string' && value !== '')
+                            out.push({ field, target: value, index });
+                    }
+                });
+            }
+        }
+        return out;
+    }
+    /**
+     * Names this object contributes to the model's reference lists.
+     *
+     * Usually just `name`, but anonymous types like `FluidProperties:Name` carry
+     * their identity in an ordinary field instead, and other objects reference
+     * that value. Treating those as nameless makes every pointer at them look
+     * dangling.
+     */
+    declaredNames() {
+        const out = [];
+        if (this[NAME] !== '')
+            out.push(this[NAME]);
+        for (const field of this[SHAPE].keyFields) {
+            const value = this[DATA][field];
+            if (typeof value === 'string' && value !== '')
+                out.push(value);
+        }
+        return out;
+    }
+    /** Detached deep copy, optionally renamed. Not attached to any document. */
+    clone(name = this[NAME]) {
+        const copy = IdfObject.create(this.typeName, this[SHAPE].type, name);
+        for (const [field, value] of Object.entries(this[DATA])) {
+            copy[DATA][field] = Array.isArray(value) ? value.map((group) => ({ ...group })) : value;
+        }
+        return copy;
+    }
+    /** Plain epJSON body: field values only, without the name. */
+    toJSON() {
+        const out = {};
+        for (const field of this[SHAPE].fields) {
+            const value = this[DATA][field];
+            if (value !== undefined)
+                out[field] = value;
+        }
+        const key = this[SHAPE].extensibleKey;
+        if (key !== undefined) {
+            const list = this[DATA][key];
+            if (Array.isArray(list) && list.length > 0)
+                out[key] = list.map((g) => ({ ...g }));
+        }
+        return out;
+    }
+    toString() {
+        return `${this.typeName}(${this[NAME]})`;
+    }
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

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

package/dist/parse/epjson.d.ts

@@ -0,0 +1,16 @@
+import type { Schema } from '@idfkit/schemas';
+import type { AnyTypeMap, UntypedMap } from '../typemap.js';
+import type { ParseOptions, ParseResult } from './idf.js';
+/** epJSON document shape: type -> name -> field values. */
+export type EpJson = Record<string, Record<string, Record<string, unknown>>>;
+/**
+ * Parse epJSON into a document.
+ *
+ * Trivial next to the IDF path, which is the point: epJSON is already named and
+ * typed, so there is no positional mapping and no coercion to do. Most of the
+ * work here is deciding what to do about input the schema does not recognize.
+ */
+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;
+//# sourceMappingURL=epjson.d.ts.map

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

@@ -0,0 +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"}

package/dist/parse/epjson.js

@@ -0,0 +1,91 @@
+import { IDFDocument } from '../document.js';
+import { IdfParseError } from './idf.js';
+/**
+ * Parse epJSON into a document.
+ *
+ * Trivial next to the IDF path, which is the point: epJSON is already named and
+ * typed, so there is no positional mapping and no coercion to do. Most of the
+ * work here is deciding what to do about input the schema does not recognize.
+ */
+export function parseEpJson(source, schema, options = {}) {
+    const strict = options.strict ?? true;
+    const diagnostics = [];
+    const report = (diagnostic) => {
+        if (strict)
+            throw new IdfParseError(diagnostic);
+        diagnostics.push(diagnostic);
+        options.onDiagnostic?.(diagnostic);
+    };
+    let root;
+    try {
+        root = typeof source === 'string' ? JSON.parse(source) : source;
+    }
+    catch (error) {
+        throw new IdfParseError({
+            message: `Invalid JSON: ${error instanceof Error ? error.message : String(error)}`,
+            line: 1,
+        });
+    }
+    const document = new IDFDocument(schema);
+    for (const [typeName, body] of Object.entries(root)) {
+        const canonical = schema.resolve(typeName);
+        if (canonical === undefined) {
+            report({
+                message: `Unknown object type "${typeName}" in EnergyPlus ${schema.version}`,
+                line: 1,
+                typeName,
+            });
+            continue;
+        }
+        const definition = schema.require(canonical);
+        for (const [name, fields] of Object.entries(body ?? {})) {
+            const values = {};
+            for (const [field, value] of Object.entries(fields ?? {})) {
+                if (value === null || value === undefined)
+                    continue;
+                if (!Object.hasOwn(definition.p, field) && field !== definition.x?.key) {
+                    report({
+                        message: `Unknown field "${field}" on ${canonical}`,
+                        line: 1,
+                        typeName: canonical,
+                    });
+                    continue;
+                }
+                values[field] = value;
+            }
+            try {
+                document.addRaw(canonical, definition.anon === 1 ? null : name, values);
+            }
+            catch (error) {
+                report({
+                    message: error instanceof Error ? error.message : String(error),
+                    line: 1,
+                    typeName: canonical,
+                });
+            }
+        }
+    }
+    return { document, diagnostics };
+}
+/** Read the version identifier from epJSON without a schema. */
+export function detectEpJsonVersion(source) {
+    let root;
+    try {
+        root = typeof source === 'string' ? JSON.parse(source) : source;
+    }
+    catch {
+        return undefined;
+    }
+    const versions = root['Version'];
+    if (versions === undefined)
+        return undefined;
+    const first = Object.values(versions)[0];
+    const raw = first?.['version_identifier'];
+    if (raw === undefined)
+        return undefined;
+    const parts = String(raw)
+        .split('.')
+        .map((p) => Number(p) || 0);
+    return `${parts[0] ?? 0}.${parts[1] ?? 0}.${parts[2] ?? 0}`;
+}
+//# sourceMappingURL=epjson.js.map

package/dist/parse/epjson.js.map

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

package/dist/parse/idf.d.ts

@@ -0,0 +1,44 @@
+import type { Schema } from '@idfkit/schemas';
+import { IDFDocument } from '../document.js';
+import type { AnyTypeMap, UntypedMap } from '../typemap.js';
+import { type LexDiagnostic } from './lexer.js';
+export interface ParseDiagnostic extends LexDiagnostic {
+    /** Object type the problem occurred in, when known. */
+    typeName?: string;
+}
+export interface ParseOptions {
+    /**
+     * Throw on the first diagnostic instead of collecting them.
+     * @defaultValue true
+     */
+    strict?: boolean;
+    /** Collects diagnostics when `strict` is false. */
+    onDiagnostic?: (diagnostic: ParseDiagnostic) => void;
+}
+export interface ParseResult<M extends AnyTypeMap = UntypedMap> {
+    document: IDFDocument<M>;
+    diagnostics: ParseDiagnostic[];
+}
+/**
+ * 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 declare function parseIdf<M extends AnyTypeMap = UntypedMap>(text: string, schema: Schema, options?: ParseOptions): ParseResult<M>;
+export declare class IdfParseError extends Error {
+    readonly line: number;
+    readonly typeName: string | undefined;
+    constructor(diagnostic: ParseDiagnostic);
+}
+/**
+ * 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 declare function detectVersion(text: string): string | undefined;
+//# sourceMappingURL=idf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idf.d.ts","sourceRoot":"","sources":["../../src/parse/idf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAO,KAAK,aAAa,EAAkB,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IAC5D,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EACxD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,WAAW,CAAC,CAAC,CAAC,CAwChB;AAkGD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE1B,UAAU,EAAE,eAAe;CAMxC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc9D"}