@jxsuite/schema 0.29.0 → 0.30.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "dependencies": {
-    "@webref/css": "^8.5.8",
+    "@webref/css": "^8.6.0",
     "@webref/elements": "^2.7.1",
-    "@webref/idl": "^3.81.0"
+    "@webref/idl": "^3.81.1"
   },
   "description": "JSON Schema 2020-12 meta-schema generator for Jx documents",
   "exports": {
@@ -39,7 +39,7 @@
     "upgrade": "bunx npm-check-updates -u && bun install"
   },
   "type": "module",
-  "version": "0.29.0",
+  "version": "0.30.1",
   "devDependencies": {
     "json-schema-to-ts": "^3.1.1"
   }

package/src/schema.ts

@@ -96,7 +96,24 @@ import { projectConfigSchema } from "../defs/project-config.schema";
 
 // ─── Web standards data loader ────────────────────────────────────────────────
 
-async function loadWebData() {
+let webDataCache: Promise<{
+  cssProps: string[];
+  eventHandlers: string[];
+  tagExamples: string[];
+}> | null = null;
+
+/**
+ * Web-standards parsing (WebIDL / CSS / HTML elements) is expensive and the data is static for the
+ * Process, so memoize it. generateSchema runs several times across a build or test run, and
+ * Re-parsing on each call made the validateDocument / CLI tests load-sensitive (occasionally past
+ * The 5s test timeout under full-suite CPU contention).
+ */
+function loadWebData() {
+  webDataCache ??= computeWebData();
+  return webDataCache;
+}
+
+async function computeWebData() {
   const [elementsData, cssData, idlData] = await Promise.all([
     listElements(),
     css.listAll(),
@@ -488,7 +505,7 @@ export async function generateSchemaString() {
 }
 
 // Minimal structural types for the optional `ajv` / `ajv-formats` peer deps
-// (not installed, and shipping no types, in this repo).
+// (no direct dependency, and shipping no types usable from here).
 interface AjvValidateFn {
   (doc: unknown): boolean;
   errors?: unknown[] | null;
@@ -506,8 +523,9 @@ type AddFormatsFn = (ajv: AjvInstance) => void;
 export async function validateDocument(doc: Record<string, unknown>) {
   let Ajv: AjvCtor, addFormats: AddFormatsFn;
   try {
-    // @ts-expect-error — optional peer dependency
-    ({ default: Ajv } = (await import("ajv")) as { default: AjvCtor });
+    // The generated schema is JSON Schema 2020-12, so use the matching Ajv build
+    // (the default `ajv` export is draft-07 and can't compile a 2020-12 schema).
+    ({ default: Ajv } = (await import("ajv/dist/2020")) as { default: AjvCtor });
     // @ts-expect-error — optional peer dependency
     ({ default: addFormats } = (await import("ajv-formats")) as { default: AddFormatsFn });
   } catch {
@@ -526,11 +544,11 @@ export async function validateDocument(doc: Record<string, unknown>) {
 
 // ─── CLI ──────────────────────────────────────────────────────────────────────
 
-if (process.argv[1] && process.argv[1].endsWith("schema.ts")) {
+async function runSchemaCli() {
   const { writeFileSync } = await import("node:fs");
   const { resolve, dirname } = await import("node:path");
 
-  const schemaDir = dirname(resolve(process.argv[1], ".."));
+  const schemaDir = dirname(resolve(process.argv[1] as string, ".."));
 
   const componentSchema = await generateSchema();
   const projectSchema = generateProjectSchema();
@@ -555,3 +573,9 @@ if (process.argv[1] && process.argv[1].endsWith("schema.ts")) {
     console.error("  class-schema.json");
   }
 }
+
+// Runs when invoked as a script or driven by a test that stages argv[1]. The build lives in an async
+// Function rather than a top-level await: Bun's test runtime drops a dynamically-imported module's
+// Top-level-await continuation on Windows. `ready` lets tests await the same sequence.
+// oxlint-disable-next-line unicorn/prefer-top-level-await
+export const ready = process.argv[1]?.endsWith("schema.ts") ? runSchemaCli() : undefined;