@idfkit/schemas 0.0.1 → 0.2.0-rc.1

package/README.md

@@ -16,10 +16,12 @@ npm install @idfkit/schemas
 The raw epJSON schemas are ~10 MB each, 17 of them, 11.9 MB gzipped in total. In
 a Python wheel nobody notices. On a page load it decides your architecture.
 
-87% of object-type definitions are byte-identical across releases: `Zone` has not
-changed since EnergyPlus 8.9. So this package stores each unique definition once,
-keyed by a content hash, and gives every version a manifest mapping type name to
-hash.
+The 17 manifests name 14,092 object-type definitions between them, and only
+2,568 of those are distinct. 82% of what the releases carry is a byte-identical
+repeat of a definition another release already has: `Construction`, for
+instance, has changed once in 17 releases. So this package stores each unique
+definition once, keyed by a content hash, and gives every version a manifest
+mapping type name to hash.
 
 |                                          | All 17 versions, gzipped |
 | ---------------------------------------- | ------------------------ |
@@ -28,7 +30,7 @@ hash.
 | Content-addressed (this package)         | ~1,000 KB                |
 
 Splitting per version would have been the obvious move and is the wrong one: it
-duplicates the shared 87% across packages and makes cross-version work require
+duplicates the shared 82% across packages and makes cross-version work require
 several installs. The longer argument is in [Content-addressed
 schemas](https://js.idfkit.com/explanation/content-addressed-schemas/).
 

package/dist/index.d.ts

@@ -17,8 +17,14 @@ export interface BundleSource {
  *
  * Reads the gzipped bundle and inflates it with `DecompressionStream`, which is
  * baseline-available in browsers. That keeps the served payload at roughly 1 MB
- * for all 17 versions instead of the ~6 MB the raw JSON would cost, and it does
- * not depend on the host serving the right `Content-Encoding`.
+ * for all 17 versions instead of the ~6 MB the raw JSON would cost.
+ *
+ * The payload is sniffed for the gzip magic bytes before inflating. A host that
+ * maps the `.gz` extension to `Content-Encoding: gzip` (Vite's dev server,
+ * nginx with `gzip_static on`, and several static hosts) makes the HTTP client
+ * inflate the body itself, leaving plain JSON with nothing left to decompress.
+ * Feeding that to `DecompressionStream` fails with an opaque `incorrect header
+ * check`, so we only decompress when the bytes actually start with `1f 8b`.
  */
 export declare function httpSource(baseUrl: string): BundleSource;
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAexD;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;;gBAQX,MAAM,EAAE,YAAY;IAIhC,oDAAoD;IAC9C,QAAQ,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAI5C,wCAAwC;IAClC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5C,qEAAqE;IACrE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CA4B5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA6BxD;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;;gBAQX,MAAM,EAAE,YAAY;IAIhC,oDAAoD;IAC9C,QAAQ,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAI5C,wCAAwC;IAClC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5C,qEAAqE;IACrE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CA4B5C"}

package/dist/index.js

@@ -5,21 +5,41 @@ export { BlobStore, Schema } from './schema.js';
  *
  * Reads the gzipped bundle and inflates it with `DecompressionStream`, which is
  * baseline-available in browsers. That keeps the served payload at roughly 1 MB
- * for all 17 versions instead of the ~6 MB the raw JSON would cost, and it does
- * not depend on the host serving the right `Content-Encoding`.
+ * for all 17 versions instead of the ~6 MB the raw JSON would cost.
+ *
+ * The payload is sniffed for the gzip magic bytes before inflating. A host that
+ * maps the `.gz` extension to `Content-Encoding: gzip` (Vite's dev server,
+ * nginx with `gzip_static on`, and several static hosts) makes the HTTP client
+ * inflate the body itself, leaving plain JSON with nothing left to decompress.
+ * Feeding that to `DecompressionStream` fails with an opaque `incorrect header
+ * check`, so we only decompress when the bytes actually start with `1f 8b`.
  */
 export function httpSource(baseUrl) {
-    const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    // Resolve against the document base when there is one, so a same-origin
+    // path like '/schemas/' works the way `fetch('/schemas/...')` does. In Node
+    // there is no base, and a relative path stays an error — it cannot resolve.
+    // Resolution is deferred to `read` so that merely constructing the source
+    // (e.g. `new SchemaBundle(httpSource('/schemas/'))` at module scope in an
+    // isomorphic app) never throws on the server; the error only surfaces if a
+    // relative base is actually read where it cannot resolve.
+    const normalized = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
     return {
         async read(fileName) {
+            const documentBase = globalThis.location?.href;
+            const base = new URL(normalized, documentBase).href;
             const response = await fetch(new URL(`${fileName}.gz`, base));
             if (!response.ok) {
                 throw new Error(`Failed to load ${fileName}.gz: ${response.status} ${response.statusText}`);
             }
-            if (response.body === null) {
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            if (bytes.length === 0) {
                 throw new Error(`Empty response for ${fileName}.gz`);
             }
-            const stream = response.body.pipeThrough(new DecompressionStream('gzip'));
+            // The client already inflated the body (host set Content-Encoding: gzip).
+            if (bytes[0] !== 0x1f || bytes[1] !== 0x8b) {
+                return JSON.parse(new TextDecoder().decode(bytes));
+            }
+            const stream = new Blob([bytes]).stream().pipeThrough(new DecompressionStream('gzip'));
             return JSON.parse(await new Response(stream).text());
         },
     };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsBhD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;IAC7D,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9F,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,KAAK,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAY,CAAC;QAClE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACvB,OAAO,CAAe;IACtB,MAAM,CAA0B;IAChC,MAAM,CAAwB;IAC9B,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,gEAAgE;IAChE,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9C,YAAY,MAAoB;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,MAAM;QACV,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,OAAe;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,cAAc,OAAO,sCAAsC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAA6B,CAAC;YAChF,IAAI,CAAC,MAAM,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAa,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAgB,CAAC;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -4,8 +4,9 @@
  * This is deliberately NOT the raw epJSON schema. Keys are single letters and
  * documentation metadata (`note`, `ip-units`, `field_info`) is dropped, because
  * this bundle is on the critical path of every parse and, in a browser, every
- * page load. Human-facing metadata lives in `@idfkit/schemas/docs`, which only
- * tooling that renders documentation needs to pull in.
+ * page load. This package republishes that metadata nowhere; tooling that
+ * renders documentation reads the raw epJSON schemas directly, or uses
+ * idfkit-docs (https://docs.idfkit.com).
  */
 /** Field storage class, mirroring how the IDF writer must format the value. */
 export type FieldKind = 
@@ -20,22 +21,59 @@ export type FieldKind =
 export interface SlimField {
     /** Storage class. */
     t: FieldKind;
-    /** Field accepts `Autosize` / `Autocalculate` in addition to a number. */
+    /**
+     * Field is an `anyOf` of a numeric branch and a string branch, in that order.
+     *
+     * Set for every one of the 13060 such fields across the 17 bundled versions.
+     * The numeric branch's type, enum and bounds are hoisted onto this record;
+     * the string branch survives as `se`.
+     */
     auto?: 1;
+    /**
+     * String literals the `anyOf` string branch accepts, verbatim from the schema.
+     *
+     * Only meaningful together with `auto`. Absent while `auto` is set means the
+     * string branch carries no enum at all and ANY string is legal there, which is
+     * the shape of 646 fields including `Schedule:Compact`'s extensible `field`.
+     * That is why the empty string is kept here rather than filtered out the way
+     * `e` filters it: `se: ['']` (the whole string branch of the 68 fields whose
+     * number branch carries a numeric enum) and no `se` at all mean the opposite
+     * of one another.
+     *
+     * The sentinel is not a constant: 10565 fields take `Autosize` and 1781 take
+     * `Autocalculate`, so a validator that accepts either everywhere accepts a
+     * value EnergyPlus rejects.
+     */
+    se?: string[];
     /** Names of reference lists this field points *into* (i.e. it is a foreign key). */
     ol?: string[];
     /** Names of reference lists this field contributes *to* (i.e. it is a key). */
     ref?: string[];
-    /** Permitted values for a choice field. */
-    e?: string[];
+    /**
+     * Permitted values for a choice field.
+     *
+     * Numbers, not strings, on the 68 fields across the versions that express a
+     * choice numerically (`e: [1, 3]` on `Site:GroundDomain:Slab.phase`). Compare
+     * strings case-insensitively and numbers by value.
+     */
+    e?: (string | number)[];
     /** Schema default, applied on write when the field is absent. */
     d?: string | number;
     min?: number;
     max?: number;
-    /** Exclusive minimum. */
-    xmin?: number;
-    /** Exclusive maximum. */
-    xmax?: number;
+    /**
+     * Exclusive minimum, in whichever JSON Schema dialect the version shipped.
+     *
+     * A number is the bound itself (draft-06+, 9.6.0 onwards). The boolean `true`
+     * qualifies the sibling `min`, making it exclusive (draft-04, 8.9.0 through
+     * 9.5.0). Measured across the bundled schemas: `xmin` is boolean 9013 times
+     * in the older seven versions and numeric 13840 times in the newer ten;
+     * `xmax` behaves identically, and no version mixes the two. Branch on the
+     * value's type, never on the version.
+     */
+    xmin?: number | boolean;
+    /** Exclusive maximum. Number or boolean, exactly as `xmin`. */
+    xmax?: number | boolean;
     /** SI units, used by the unit-conversion helpers. */
     u?: string;
     /** Value is case-sensitive and must not be normalized. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,SAAS;AACnB,+BAA+B;AAC7B,GAAG;AACL,oDAAoD;GAClD,GAAG;AACL,gDAAgD;GAC9C,GAAG;AACL,gCAAgC;GAC9B,KAAK,CAAC;AAEV,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,CAAC,EAAE,SAAS,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,oFAAoF;IACpF,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,iEAAiE;IACjE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,EAAE,CAAC,EAAE,CAAC,CAAC;CACR;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,qDAAqD;IACrD,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7B,4BAA4B;IAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,8EAA8E;IAC9E,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,8EAA8E;IAC9E,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0DAA0D;IAC1D,CAAC,CAAC,EAAE,cAAc,CAAC;IACnB,oDAAoD;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,SAAS;AACnB,+BAA+B;AAC7B,GAAG;AACL,oDAAoD;GAClD,GAAG;AACL,gDAAgD;GAC9C,GAAG;AACL,gCAAgC;GAC9B,KAAK,CAAC;AAEV,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,CAAC,EAAE,SAAS,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC;IACT;;;;;;;;;;;;;;OAcG;IACH,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,oFAAoF;IACpF,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf;;;;;;OAMG;IACH,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACxB,iEAAiE;IACjE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,qDAAqD;IACrD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,EAAE,CAAC,EAAE,CAAC,CAAC;CACR;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,qDAAqD;IACrD,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7B,4BAA4B;IAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,8EAA8E;IAC9E,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,8EAA8E;IAC9E,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0DAA0D;IAC1D,CAAC,CAAC,EAAE,cAAc,CAAC;IACnB,oDAAoD;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}

package/dist/types.js

@@ -4,8 +4,9 @@
  * This is deliberately NOT the raw epJSON schema. Keys are single letters and
  * documentation metadata (`note`, `ip-units`, `field_info`) is dropped, because
  * this bundle is on the critical path of every parse and, in a browser, every
- * page load. Human-facing metadata lives in `@idfkit/schemas/docs`, which only
- * tooling that renders documentation needs to pull in.
+ * page load. This package republishes that metadata nowhere; tooling that
+ * renders documentation reads the raw epJSON schemas directly, or uses
+ * idfkit-docs (https://docs.idfkit.com).
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idfkit/schemas",
-  "version": "0.0.1",
+  "version": "0.2.0-rc.1",
   "description": "Content-addressed EnergyPlus epJSON schemas for all supported versions",
   "type": "module",
   "license": "MIT",