@toolproof-core/schema 1.0.9 → 1.0.11

package/src/scripts/generateSchemaShims.ts

@@ -1,127 +1,127 @@
-import fs from 'fs';
-import path from 'path';
-import { getConfig } from './_lib/config.js';
-
-/**
- * Generate TypeScript shim files for all JSON schemas and resources
- * 
- * Creates .ts files that import and re-export .json files using
- * the JSON import assertion syntax. This enables proper dependency resolution
- * and type inference when importing schemas in TypeScript.
- * 
- * Generates shims for:
- * - schemas dir: config.getSchemasDir() (schema files)
- * - standalone schemas dir: config.getStandaloneSchemaDir() (standalone schema files)
- * - resources dir: config.getResourcesDir() (resource envelope files)
- * 
- * Usage: node ./dist/scripts/generateSchemaShims.js
- */
-
-// PURE: Generate the .ts shim module content for a given .json filename.
-function generateShimContent(jsonFile: string, variableName: string): string {
-    return `import ${variableName} from './${jsonFile}' with { type: 'json' };\nexport default ${variableName};\n`;
-}
-
-// PURE: Map JSON filenames to deterministic shim file contents.
-function getShimsForFiles(jsonFiles: string[], variableName: string): Record<string, string> {
-    const shims: Record<string, string> = {};
-    for (const jsonFile of jsonFiles) {
-        const baseName = path.basename(jsonFile, '.json');
-        const tsFile = `${baseName}.ts`;
-        shims[tsFile] = generateShimContent(jsonFile, variableName);
-    }
-    return shims;
-}
-
-// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
-function main() {
-    try {
-        const config = getConfig();
-        const schemasDir = config.getSchemasDir();
-        const standaloneSchemasDir = config.getStandaloneSchemaDir();
-        const resourcesDir = config.getResourcesDir();
-        const generatedResourceTypesDir = config.getNormalizedDir();
-
-        let totalCount = 0;
-
-        // Process schemas directory
-        if (fs.existsSync(schemasDir)) {
-            const files = fs.readdirSync(schemasDir);
-            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
-
-            const shims = getShimsForFiles(jsonFiles, 'schema');
-
-            for (const [tsFile, content] of Object.entries(shims)) {
-                const tsPath = path.join(schemasDir, tsFile);
-                fs.writeFileSync(tsPath, content, 'utf-8');
-                console.log('Generated ' + tsFile + ' in ' + schemasDir);
-                totalCount++;
-            }
-            console.log('Generated ' + jsonFiles.length + ' TypeScript schema shims in ' + schemasDir);
-        } else {
-            console.warn('Schemas directory not found at ' + schemasDir);
-        }
-
-        // Process standalone schemas directory
-        if (fs.existsSync(standaloneSchemasDir)) {
-            const files = fs.readdirSync(standaloneSchemasDir);
-            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
-
-            const shims = getShimsForFiles(jsonFiles, 'schema');
-
-            for (const [tsFile, content] of Object.entries(shims)) {
-                const tsPath = path.join(standaloneSchemasDir, tsFile);
-                fs.writeFileSync(tsPath, content, 'utf-8');
-                console.log('Generated ' + tsFile + ' in ' + standaloneSchemasDir);
-                totalCount++;
-            }
-            console.log('Generated ' + jsonFiles.length + ' TypeScript standalone schema shims in ' + standaloneSchemasDir);
-        } else {
-            // Standalone schemas are optional
-        }
-
-        // Process resources directory
-        if (fs.existsSync(resourcesDir)) {
-            const files = fs.readdirSync(resourcesDir);
-            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
-
-            const shims = getShimsForFiles(jsonFiles, 'resources');
-
-            for (const [tsFile, content] of Object.entries(shims)) {
-                const tsPath = path.join(resourcesDir, tsFile);
-                fs.writeFileSync(tsPath, content, 'utf-8');
-                console.log('Generated ' + tsFile + ' in ' + resourcesDir);
-                totalCount++;
-            }
-            console.log('Generated ' + jsonFiles.length + ' TypeScript resource shims in ' + resourcesDir);
-        } else {
-            console.warn('Resources directory not found at ' + resourcesDir);
-        }
-
-        // Genesis (normalized) shim
-        try {
-            const genesisJsonPath = config.getNormalizedSourcePath();
-            if (fs.existsSync(genesisJsonPath)) {
-                fs.mkdirSync(generatedResourceTypesDir, { recursive: true });
-                const tsFile = 'Genesis.ts';
-                const content = generateShimContent('Genesis.json', 'schema');
-                const tsPath = path.join(generatedResourceTypesDir, tsFile);
-
-                fs.writeFileSync(tsPath, content, 'utf-8');
-                console.log('Generated ' + tsFile + ' in ' + generatedResourceTypesDir);
-                totalCount++;
-            } else {
-                console.warn('Genesis source JSON not found at ' + genesisJsonPath + '; skipping Genesis.ts shim');
-            }
-        } catch (e) {
-            console.warn('Failed to generate Genesis.ts shim:', e);
-        }
-
-        console.log('Generated ' + totalCount + ' total TypeScript shims');
-    } catch (e) {
-        console.error(e);
-        process.exitCode = 1;
-    }
-}
-
-main();
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from './_lib/config.js';
+
+/**
+ * Generate TypeScript shim files for all JSON schemas and resources
+ * 
+ * Creates .ts files that import and re-export .json files using
+ * the JSON import assertion syntax. This enables proper dependency resolution
+ * and type inference when importing schemas in TypeScript.
+ * 
+ * Generates shims for:
+ * - schemas dir: config.getSchemasDir() (schema files)
+ * - standalone schemas dir: config.getStandaloneSchemaDir() (standalone schema files)
+ * - resources dir: config.getResourcesDir() (resource envelope files)
+ * 
+ * Usage: node ./dist/scripts/generateSchemaShims.js
+ */
+
+// PURE: Generate the .ts shim module content for a given .json filename.
+function generateShimContent(jsonFile: string, variableName: string): string {
+    return `import ${variableName} from './${jsonFile}' with { type: 'json' };\nexport default ${variableName};\n`;
+}
+
+// PURE: Map JSON filenames to deterministic shim file contents.
+function getShimsForFiles(jsonFiles: string[], variableName: string): Record<string, string> {
+    const shims: Record<string, string> = {};
+    for (const jsonFile of jsonFiles) {
+        const baseName = path.basename(jsonFile, '.json');
+        const tsFile = `${baseName}.ts`;
+        shims[tsFile] = generateShimContent(jsonFile, variableName);
+    }
+    return shims;
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
+function main() {
+    try {
+        const config = getConfig();
+        const schemasDir = config.getSchemasDir();
+        const standaloneSchemasDir = config.getStandaloneSchemaDir();
+        const resourcesDir = config.getResourcesDir();
+        const generatedResourceTypesDir = config.getNormalizedDir();
+
+        let totalCount = 0;
+
+        // Process schemas directory
+        if (fs.existsSync(schemasDir)) {
+            const files = fs.readdirSync(schemasDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'schema');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(schemasDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + schemasDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript schema shims in ' + schemasDir);
+        } else {
+            console.warn('Schemas directory not found at ' + schemasDir);
+        }
+
+        // Process standalone schemas directory
+        if (fs.existsSync(standaloneSchemasDir)) {
+            const files = fs.readdirSync(standaloneSchemasDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'schema');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(standaloneSchemasDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + standaloneSchemasDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript standalone schema shims in ' + standaloneSchemasDir);
+        } else {
+            // Standalone schemas are optional
+        }
+
+        // Process resources directory
+        if (fs.existsSync(resourcesDir)) {
+            const files = fs.readdirSync(resourcesDir);
+            const jsonFiles = files.filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+
+            const shims = getShimsForFiles(jsonFiles, 'resources');
+
+            for (const [tsFile, content] of Object.entries(shims)) {
+                const tsPath = path.join(resourcesDir, tsFile);
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + resourcesDir);
+                totalCount++;
+            }
+            console.log('Generated ' + jsonFiles.length + ' TypeScript resource shims in ' + resourcesDir);
+        } else {
+            console.warn('Resources directory not found at ' + resourcesDir);
+        }
+
+        // Genesis (normalized) shim
+        try {
+            const genesisJsonPath = config.getNormalizedSourcePath();
+            if (fs.existsSync(genesisJsonPath)) {
+                fs.mkdirSync(generatedResourceTypesDir, { recursive: true });
+                const tsFile = 'Genesis.ts';
+                const content = generateShimContent('Genesis.json', 'schema');
+                const tsPath = path.join(generatedResourceTypesDir, tsFile);
+
+                fs.writeFileSync(tsPath, content, 'utf-8');
+                console.log('Generated ' + tsFile + ' in ' + generatedResourceTypesDir);
+                totalCount++;
+            } else {
+                console.warn('Genesis source JSON not found at ' + genesisJsonPath + '; skipping Genesis.ts shim');
+            }
+        } catch (e) {
+            console.warn('Failed to generate Genesis.ts shim:', e);
+        }
+
+        console.log('Generated ' + totalCount + ' total TypeScript shims');
+    } catch (e) {
+        console.error(e);
+        process.exitCode = 1;
+    }
+}
+
+main();

package/src/scripts/generateStandaloneSchema.ts

@@ -1,185 +1,185 @@
-import fs from 'fs';
-import path from 'path';
-import { getConfig } from './_lib/config.js';
-
-/**
- * Create a standalone JSON Schema for a single $defs entry under Genesis.json,
- * embedding all direct & transitive local $defs dependencies.
- *
- * Usage:
- *   node ./dist/scripts/generateStandaloneSchema.js --name <DefName>
- */
-
-// PURE: Extract a standalone subschema from a flattened Genesis schema, returning warnings instead of logging
-function extractStandaloneSchemaLogic(genesis: any, name: string): { schema: any; warnings: string[] } {
-  const rootDefs: Record<string, any> | undefined = genesis.$defs;
-  if (!rootDefs || typeof rootDefs !== 'object') {
-    throw new Error('No $defs object found in Genesis.json');
-  }
-
-  const target = rootDefs[name];
-  if (!target) {
-    throw new Error(`Subschema named '${name}' not found under $defs in Genesis.json`);
-  }
-
-  const needed = collectLocalDefClosure(target, rootDefs);
-
-  const targetClone = deepClone(target);
-  const defsOut: Record<string, any> = {};
-  const warnings: string[] = [];
-  for (const defName of needed) {
-    if (defName === name) continue;
-    const defSchema = rootDefs[defName];
-    if (defSchema === undefined) {
-      warnings.push(`Warning: referenced def '${defName}' missing in root $defs (skipped).`);
-      continue;
-    }
-    defsOut[defName] = deepClone(defSchema);
-  }
-
-  const existingInner = isObject(targetClone.$defs) ? targetClone.$defs : {};
-  targetClone.$defs = { ...existingInner, ...defsOut };
-
-  return { schema: targetClone, warnings };
-}
-
-// PURE: Strip accidental surrounding quotes from CLI values (PowerShell/cmd).
-function stripSurroundingQuotes(value: string): string {
-  if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-    return value.slice(1, -1);
-  }
-  return value;
-}
-
-// PURE: Parse CLI args (no defaults, no filesystem probing).
-function parseArgs(args: string[]): { name?: string } {
-  let name: string | undefined;
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === '--name') {
-      name = args[i + 1];
-      i++;
-    } else if (a.startsWith('--name=')) {
-      name = a.split('=')[1];
-    }
-  }
-  const normalized = typeof name === 'string' ? stripSurroundingQuotes(name) : undefined;
-  return { name: normalized?.trim() ? normalized : undefined };
-}
-
-// PURE: Narrow unknown values to plain objects.
-function isObject(v: any): v is Record<string, any> {
-  return v !== null && typeof v === 'object' && !Array.isArray(v);
-}
-
-// PURE: Deep-clone JSON-ish values (no mutation of input).
-function deepClone<T>(v: T): T {
-  if (Array.isArray(v)) return v.map((x) => deepClone(x)) as any;
-  if (isObject(v)) {
-    const out: Record<string, any> = {};
-    for (const k of Object.keys(v)) out[k] = deepClone((v as any)[k]);
-    return out as any;
-  }
-  return v;
-}
-
-// PURE: Extract a $defs key from a local JSON pointer ref.
-function extractPointerDefName(ref: string): string | null {
-  if (!ref || !ref.startsWith('#/')) return null;
-  const parts = ref.slice(2).split('/');
-  if (parts.length !== 2) return null;
-  if (parts[0] !== '$defs') return null;
-  const name = parts[1].replace(/~1/g, '/').replace(/~0/g, '~');
-  return name;
-}
-
-// PURE: Resolve an internal ref (pointer or anchor) to a root $defs key.
-function resolveRefToDefName(ref: string, rootDefs: Record<string, any>): string | null {
-  if (!ref) return null;
-  const byPointer = extractPointerDefName(ref);
-  if (byPointer) return byPointer;
-
-  if (ref.startsWith('#') && !ref.startsWith('#/')) {
-    const anchor = ref.slice(1);
-    if (!anchor) return null;
-    for (const [defName, defSchema] of Object.entries(rootDefs)) {
-      if (!defSchema || typeof defSchema !== 'object') continue;
-      const topLevelAnchor = (defSchema as any).$anchor;
-      const nested = (defSchema as any).nucleusSchema;
-      const nestedAnchor = nested && typeof nested === 'object' ? nested.$anchor : undefined;
-      const defAnchor = typeof topLevelAnchor === 'string' ? topLevelAnchor : (typeof nestedAnchor === 'string' ? nestedAnchor : undefined);
-      if (defAnchor === anchor) {
-        return defName;
-      }
-    }
-  }
-
-  return null;
-}
-
-// PURE: Compute the transitive closure of local $defs dependencies for a node.
-function collectLocalDefClosure(node: any, rootDefs: Record<string, any>): Set<string> {
-  const needed = new Set<string>();
-  const queue: string[] = [];
-
-  function visit(n: any) {
-    if (Array.isArray(n)) {
-      for (const item of n) visit(item);
-      return;
-    }
-    if (!isObject(n)) return;
-    if (typeof n.$ref === 'string') {
-      const name = resolveRefToDefName(n.$ref, rootDefs);
-      if (name && !needed.has(name)) {
-        needed.add(name);
-        queue.push(name);
-      }
-    }
-    for (const val of Object.values(n)) visit(val);
-  }
-
-  visit(node);
-
-  while (queue.length > 0) {
-    const name = queue.shift()!;
-    const def = rootDefs[name];
-    if (!def) continue;
-    visit(def);
-  }
-
-  return needed;
-}
-
-// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
-async function main() {
-  try {
-    const config = getConfig();
-    const { name } = parseArgs(process.argv.slice(2));
-    if (!name) {
-      throw new Error('Missing --name <DefName> argument');
-    }
-
-    const schemasDir = config.getSchemasDir();
-    const genesisPath = path.join(schemasDir, config.getSourceFile());
-    const outPath = config.getStandaloneSchemaPath(`${name}.json`);
-
-    if (!fs.existsSync(genesisPath)) {
-      throw new Error(`Genesis.json not found at ${genesisPath}. Run extractSchemasFromResourceTypeShells first.`);
-    }
-
-    const raw = fs.readFileSync(genesisPath, 'utf-8');
-    const genesis = JSON.parse(raw);
-
-    const { schema, warnings } = extractStandaloneSchemaLogic(genesis, name);
-    for (const w of warnings) console.warn(w);
-
-    fs.mkdirSync(path.dirname(outPath), { recursive: true });
-    fs.writeFileSync(outPath, JSON.stringify(schema, null, 2) + '\n');
-    console.log(`Created standalone subschema '${name}' -> ${outPath}`);
-  } catch (error: any) {
-    console.error(error?.message ?? error);
-    process.exitCode = 1;
-  }
-}
-
-void main();
+import fs from 'fs';
+import path from 'path';
+import { getConfig } from './_lib/config.js';
+
+/**
+ * Create a standalone JSON Schema for a single $defs entry under Genesis.json,
+ * embedding all direct & transitive local $defs dependencies.
+ *
+ * Usage:
+ *   node ./dist/scripts/generateStandaloneSchema.js --name <DefName>
+ */
+
+// PURE: Extract a standalone subschema from a flattened Genesis schema, returning warnings instead of logging
+function extractStandaloneSchemaLogic(genesis: any, name: string): { schema: any; warnings: string[] } {
+  const rootDefs: Record<string, any> | undefined = genesis.$defs;
+  if (!rootDefs || typeof rootDefs !== 'object') {
+    throw new Error('No $defs object found in Genesis.json');
+  }
+
+  const target = rootDefs[name];
+  if (!target) {
+    throw new Error(`Subschema named '${name}' not found under $defs in Genesis.json`);
+  }
+
+  const needed = collectLocalDefClosure(target, rootDefs);
+
+  const targetClone = deepClone(target);
+  const defsOut: Record<string, any> = {};
+  const warnings: string[] = [];
+  for (const defName of needed) {
+    if (defName === name) continue;
+    const defSchema = rootDefs[defName];
+    if (defSchema === undefined) {
+      warnings.push(`Warning: referenced def '${defName}' missing in root $defs (skipped).`);
+      continue;
+    }
+    defsOut[defName] = deepClone(defSchema);
+  }
+
+  const existingInner = isObject(targetClone.$defs) ? targetClone.$defs : {};
+  targetClone.$defs = { ...existingInner, ...defsOut };
+
+  return { schema: targetClone, warnings };
+}
+
+// PURE: Strip accidental surrounding quotes from CLI values (PowerShell/cmd).
+function stripSurroundingQuotes(value: string): string {
+  if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+
+// PURE: Parse CLI args (no defaults, no filesystem probing).
+function parseArgs(args: string[]): { name?: string } {
+  let name: string | undefined;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '--name') {
+      name = args[i + 1];
+      i++;
+    } else if (a.startsWith('--name=')) {
+      name = a.split('=')[1];
+    }
+  }
+  const normalized = typeof name === 'string' ? stripSurroundingQuotes(name) : undefined;
+  return { name: normalized?.trim() ? normalized : undefined };
+}
+
+// PURE: Narrow unknown values to plain objects.
+function isObject(v: any): v is Record<string, any> {
+  return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+
+// PURE: Deep-clone JSON-ish values (no mutation of input).
+function deepClone<T>(v: T): T {
+  if (Array.isArray(v)) return v.map((x) => deepClone(x)) as any;
+  if (isObject(v)) {
+    const out: Record<string, any> = {};
+    for (const k of Object.keys(v)) out[k] = deepClone((v as any)[k]);
+    return out as any;
+  }
+  return v;
+}
+
+// PURE: Extract a $defs key from a local JSON pointer ref.
+function extractPointerDefName(ref: string): string | null {
+  if (!ref || !ref.startsWith('#/')) return null;
+  const parts = ref.slice(2).split('/');
+  if (parts.length !== 2) return null;
+  if (parts[0] !== '$defs') return null;
+  const name = parts[1].replace(/~1/g, '/').replace(/~0/g, '~');
+  return name;
+}
+
+// PURE: Resolve an internal ref (pointer or anchor) to a root $defs key.
+function resolveRefToDefName(ref: string, rootDefs: Record<string, any>): string | null {
+  if (!ref) return null;
+  const byPointer = extractPointerDefName(ref);
+  if (byPointer) return byPointer;
+
+  if (ref.startsWith('#') && !ref.startsWith('#/')) {
+    const anchor = ref.slice(1);
+    if (!anchor) return null;
+    for (const [defName, defSchema] of Object.entries(rootDefs)) {
+      if (!defSchema || typeof defSchema !== 'object') continue;
+      const topLevelAnchor = (defSchema as any).$anchor;
+      const nested = (defSchema as any).nucleusSchema;
+      const nestedAnchor = nested && typeof nested === 'object' ? nested.$anchor : undefined;
+      const defAnchor = typeof topLevelAnchor === 'string' ? topLevelAnchor : (typeof nestedAnchor === 'string' ? nestedAnchor : undefined);
+      if (defAnchor === anchor) {
+        return defName;
+      }
+    }
+  }
+
+  return null;
+}
+
+// PURE: Compute the transitive closure of local $defs dependencies for a node.
+function collectLocalDefClosure(node: any, rootDefs: Record<string, any>): Set<string> {
+  const needed = new Set<string>();
+  const queue: string[] = [];
+
+  function visit(n: any) {
+    if (Array.isArray(n)) {
+      for (const item of n) visit(item);
+      return;
+    }
+    if (!isObject(n)) return;
+    if (typeof n.$ref === 'string') {
+      const name = resolveRefToDefName(n.$ref, rootDefs);
+      if (name && !needed.has(name)) {
+        needed.add(name);
+        queue.push(name);
+      }
+    }
+    for (const val of Object.values(n)) visit(val);
+  }
+
+  visit(node);
+
+  while (queue.length > 0) {
+    const name = queue.shift()!;
+    const def = rootDefs[name];
+    if (!def) continue;
+    visit(def);
+  }
+
+  return needed;
+}
+
+// IMPURE: Script entrypoint (config + filesystem I/O + console + process exit code).
+async function main() {
+  try {
+    const config = getConfig();
+    const { name } = parseArgs(process.argv.slice(2));
+    if (!name) {
+      throw new Error('Missing --name <DefName> argument');
+    }
+
+    const schemasDir = config.getSchemasDir();
+    const genesisPath = path.join(schemasDir, config.getSourceFile());
+    const outPath = config.getStandaloneSchemaPath(`${name}.json`);
+
+    if (!fs.existsSync(genesisPath)) {
+      throw new Error(`Genesis.json not found at ${genesisPath}. Run extractSchemasFromResourceTypeShells first.`);
+    }
+
+    const raw = fs.readFileSync(genesisPath, 'utf-8');
+    const genesis = JSON.parse(raw);
+
+    const { schema, warnings } = extractStandaloneSchemaLogic(genesis, name);
+    for (const w of warnings) console.warn(w);
+
+    fs.mkdirSync(path.dirname(outPath), { recursive: true });
+    fs.writeFileSync(outPath, JSON.stringify(schema, null, 2) + '\n');
+    console.log(`Created standalone subschema '${name}' -> ${outPath}`);
+  } catch (error: any) {
+    console.error(error?.message ?? error);
+    process.exitCode = 1;
+  }
+}
+
+void main();