@amritk/generate-parsers 0.14.0 → 0.15.0

package/README.md

@@ -9,7 +9,7 @@
 ![license](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square) 
 ![JSON Schema](https://img.shields.io/badge/JSON%20Schema-2020--12-f97316?style=flat-square) 
 ![node](https://img.shields.io/badge/node-%E2%89%A520-339933?style=flat-square&logo=node.js&logoColor=white) 
-![vibe coded](https://img.shields.io/badge/vibe%20coded-84%25-a855f7?style=flat-square)
+![vibe coded](https://img.shields.io/badge/vibe-coded-a855f7?style=flat-square)
 
 </div>
 

package/dist/generators/build-schema.d.ts

@@ -48,8 +48,11 @@ export type GeneratedFile = {
  *   is used verbatim and is not affected by this suffix.
  * @param importExt - Extension used on every relative import specifier in the generated
  *   output (cross-file `$ref` imports, the index barrel, and embedded-helper imports).
- *   `'js'` (default) is the standard TS NodeNext form; `'ts'` emits the literal on-disk
- *   paths so the generated sources run directly under Node's type stripping.
+ *   `'js'` (this function's default) is the standard TS NodeNext form; `'ts'` emits the
+ *   literal on-disk paths so the generated sources run directly under Node's type
+ *   stripping. Note the `mjst` CLI defaults this to `'ts'` (falling back to `'js'` only
+ *   under `--build`, where tsc must compile the sources) so generated output runs under
+ *   Node without a build step; direct callers of `buildSchema` opt in explicitly.
  * @returns An array of generated TypeScript files
  *
  * @example

package/dist/generators/build-schema.js

@@ -84,8 +84,11 @@ const readHelperSource = async (helper, importExt) => {
  *   is used verbatim and is not affected by this suffix.
  * @param importExt - Extension used on every relative import specifier in the generated
  *   output (cross-file `$ref` imports, the index barrel, and embedded-helper imports).
- *   `'js'` (default) is the standard TS NodeNext form; `'ts'` emits the literal on-disk
- *   paths so the generated sources run directly under Node's type stripping.
+ *   `'js'` (this function's default) is the standard TS NodeNext form; `'ts'` emits the
+ *   literal on-disk paths so the generated sources run directly under Node's type
+ *   stripping. Note the `mjst` CLI defaults this to `'ts'` (falling back to `'js'` only
+ *   under `--build`, where tsc must compile the sources) so generated output runs under
+ *   Node without a build step; direct callers of `buildSchema` opt in explicitly.
  * @returns An array of generated TypeScript files
  *
  * @example
@@ -137,6 +140,7 @@ export const buildSchema = async (rootSchema, rootTypeName, extensions, typesOnl
             readonly,
             typeSuffix,
             importExt,
+            isRoot: node.isRoot,
             ...(node.ref !== undefined ? { selfRef: node.ref } : {}),
             ...(logWarnings !== undefined ? { logWarnings } : {}),
             ...(strict !== undefined ? { strict } : {}),

package/dist/generators/generate-files.d.ts

@@ -71,6 +71,13 @@ type GenerateFileOptions = {
      * stripping.
      */
     readonly importExt?: ImportExtension;
+    /**
+     * True when this file is the root document rather than a `$ref`-reached
+     * definition. Forwarded to the parser generator so the JSON Schema
+     * meta-schema special case (type name `Schema`) never applies to a
+     * user-named root.
+     */
+    readonly isRoot?: boolean;
 };
 /** Result of generating a single parser file. */
 export type GeneratedFileContent = {

package/dist/generators/generate-files.js

@@ -62,6 +62,7 @@ export const generateFile = (schema, typeName, options) => {
         useRefImports: true,
         typeSuffix,
         reservedNames,
+        ...(options?.isRoot !== undefined ? { isRoot: options.isRoot } : {}),
         ...(rootSchema !== undefined ? { rootSchema } : {}),
         ...(options?.logWarnings !== undefined ? { logWarnings: options.logWarnings } : {}),
         ...(options?.strict !== undefined ? { strict: options.strict } : {}),

package/dist/generators/generate-parser-function.d.ts

@@ -50,6 +50,14 @@ type GenerateParserOptions = {
      * validate against the wrong schema.
      */
     readonly reservedNames?: ReadonlySet<string>;
+    /**
+     * True when this schema is the root document (not a `$ref`-reached definition).
+     * The root type name is user-derived (schema `title`, filename, or `--root-type`),
+     * so the JSON Schema meta-schema special case — keyed on the literal name
+     * `Schema` — must not apply to it, or a common `schema.json` root would silently
+     * generate a validation-free pass-through parser.
+     */
+    readonly isRoot?: boolean;
 };
 /**
  * Generates a safe parser as an arrow function that never throws.

package/dist/generators/generate-parser-function.js

@@ -1525,8 +1525,12 @@ const selectParserStrategy = (schema, typeName, options) => {
     const stripUnknown = options?.stripUnknown ?? false;
     const suffix = options?.typeSuffix ?? '';
     // Special case for the self-referential JSON Schema meta-schema type (e.g.
-    // `Schema` / `SchemaObject`) - it can be any JSON Schema.
-    if (typeName === `Schema${suffix}`) {
+    // `Schema` / `SchemaObject`) - it can be any JSON Schema. This is an OpenAPI
+    // heuristic for a `$defs`/`components.schemas` entry named `schema`; it must
+    // never fire for the root document, whose name is user-derived (a `schema.json`
+    // file naturally yields the root type `Schema`) and would otherwise collapse
+    // to a validation-free pass-through parser.
+    if (!options?.isRoot && typeName === `Schema${suffix}`) {
         return generateSchemaObjectParser(typeName);
     }
     const isObjectLikeSchema = isObjectSchema(schema) ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amritk/generate-parsers",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Generate TypeScript parsers and type definitions from JSON Schemas.",
   "module": "./dist/index.js",
   "type": "module",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "json-schema-typed": "^8.0.1",
-    "@amritk/helpers": "0.11.0",
+    "@amritk/helpers": "0.12.0",
     "@amritk/generate-markdown": "0.4.1"
   },
   "devDependencies": {