@amritk/mjst 0.7.15 → 0.8.0

package/README.md

@@ -232,13 +232,22 @@ npx mjst --config ./mjst.config.json
 <td colspan="4">Suffix appended to every generated type name derived from a $ref (e.g. 'Object' turns Contact into ContactObject). Defaults to no suffix. The root type name is used verbatim and is unaffected.</td>
 </tr>
 <tr>
+<td>🔗 <code>importExt</code></td>
+<td><code>--import-ext &lt;ext&gt;</code></td>
+<td><code>string</code></td>
+<td align="center"><code>"js"</code></td>
+</tr>
+<tr>
+<td colspan="4">Extension emitted 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 ('./x.js' resolving to a sibling x.ts), accepted by tsc, Bun, and bundlers, and required by 'build'. 'ts' emits the literal on-disk paths so the generated .ts sources run directly under Node's type stripping (Node 22.6+ with --experimental-strip-types, on by default from Node 23). Incompatible with 'build' — tsc refuses to emit from .ts specifiers.<br><strong>Allowed:</strong> <code>"js"</code>, <code>"ts"</code></td>
+</tr>
+<tr>
 <td>⚙️ <code>config</code></td>
 <td><code>--config &lt;path&gt;</code></td>
 <td><code>string</code></td>
 <td align="center"></td>
 </tr>
 <tr>
-<td colspan="4">Path to a JSON config file. Keys match the option names in this schema (schema, schemaDir, outDir, outFile, typesOnly, build, logWarnings, strict, readonly, helpers, typeSuffix). CLI flags take precedence over config file values.<br><strong>Examples:</strong> <code>"./mjst.config.json"</code></td>
+<td colspan="4">Path to a JSON config file. Keys match the option names in this schema (schema, schemaDir, outDir, outFile, typesOnly, build, logWarnings, strict, readonly, helpers, typeSuffix, importExt). CLI flags take precedence over config file values.<br><strong>Examples:</strong> <code>"./mjst.config.json"</code></td>
 </tr>
 </tbody>
 </table>

package/dist/cli-config.d.ts

@@ -89,4 +89,17 @@ export type CliConfig = {
      * - `false` / omitted — no header.
      */
     readonly banner?: boolean | string;
+    /**
+     * Extension emitted on every relative import specifier in the generated
+     * output (cross-file `$ref` imports, the index barrel, and embedded-helper
+     * imports).
+     * - `'js'` (default): the standard TS NodeNext form (`./x.js` resolving to a
+     *   sibling `x.ts`), accepted by tsc, Bun, and bundlers, and required by
+     *   `build`.
+     * - `'ts'`: the literal on-disk paths, so the generated `.ts` sources run
+     *   directly under Node's type stripping (Node 22.6+ with
+     *   `--experimental-strip-types`, default from Node 23). Incompatible with
+     *   `build` — tsc refuses to emit from `.ts` specifiers.
+     */
+    readonly importExt?: 'js' | 'ts';
 };

package/dist/cli.js

@@ -132,7 +132,7 @@ const runSingle = async (config, schemaPath, outputDir) => {
     console.log(`Helpers mode: ${helpersMode}${config.helpers ? ' (explicit)' : ' (auto-detected)'}`);
     const rootTypeName = deriveRootTypeName(schema);
     console.log(`Root type: ${rootTypeName}`);
-    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, undefined, config.readonly, config.stripUnknown, config.typeSuffix);
+    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, undefined, config.readonly, config.stripUnknown, config.typeSuffix, config.importExt);
     for (const file of files) {
         const isHelper = file.filename.startsWith('_helpers/');
         const content = config.banner && !isHelper ? resolveBanner(config.banner) + file.content : file.content;
@@ -157,7 +157,7 @@ const runSingleFile = async (config, schemaPath, outFilePath) => {
     await mkdir(outputDir, { recursive: true });
     const rootTypeName = deriveRootTypeName(schema);
     console.log(`Root type: ${rootTypeName}`);
-    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, config.helpers ?? 'package', undefined, config.readonly, config.stripUnknown, config.typeSuffix);
+    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, config.helpers ?? 'package', undefined, config.readonly, config.stripUnknown, config.typeSuffix, config.importExt);
     const combined = combineGeneratedFiles(files);
     await writeFile(outFilePath, config.banner ? resolveBanner(config.banner) + combined : combined, 'utf-8');
     console.log(`Generated: ${relative(process.cwd(), outFilePath)}`);
@@ -202,7 +202,7 @@ const runRecursive = async (config, schemaDir, outputDir) => {
         const schema = await loadSchema(config, schemaFile);
         const rootTypeName = deriveRootTypeName(schema);
         console.log(`\n${relPath} → ${relNoExt}/ (root type: ${rootTypeName})`);
-        const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, helpersImportPrefix, config.readonly, config.stripUnknown, config.typeSuffix);
+        const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, helpersImportPrefix, config.readonly, config.stripUnknown, config.typeSuffix, config.importExt);
         for (const file of files) {
             if (file.filename.startsWith('_helpers/')) {
                 sharedHelpers.set(file.filename, file.content);
@@ -243,6 +243,13 @@ const run = async () => {
         console.error('Error: provide only one of --out-dir or --out-file, not both.');
         process.exit(1);
     }
+    // tsc cannot emit from `.ts` import specifiers (allowImportingTsExtensions
+    // requires noEmit), so compiled output and stripping-ready sources are
+    // mutually exclusive.
+    if (config.build && config.importExt === 'ts') {
+        console.error('Error: --import-ext ts cannot be combined with --build. Drop --build to keep runnable .ts sources.');
+        process.exit(1);
+    }
     // Single-file output is the alternative to a directory of files.
     if (config.outFile) {
         if (!config.typesOnly) {

package/dist/load-config.js

@@ -3,6 +3,7 @@ import { resolve } from 'node:path';
 const SOURCE_FORMATS = ['json', 'typebox', 'zod', 'valibot', 'effect'];
 const isSourceFormat = (value) => typeof value === 'string' && SOURCE_FORMATS.includes(value);
 const isHelpersMode = (value) => value === 'package' || value === 'embedded';
+const isImportExt = (value) => value === 'js' || value === 'ts';
 /**
  * Loads a JSON config file and returns the relevant CLI config properties.
  * The config file should have the same keys as the CLI flags (schema, outDir).
@@ -29,6 +30,7 @@ export const loadConfig = async (configPath) => {
         ...(typeof obj['stripUnknown'] === 'boolean' && { stripUnknown: obj['stripUnknown'] }),
         ...(typeof obj['readonly'] === 'boolean' && { readonly: obj['readonly'] }),
         ...(isHelpersMode(obj['helpers']) && { helpers: obj['helpers'] }),
+        ...(isImportExt(obj['importExt']) && { importExt: obj['importExt'] }),
         ...(typeof obj['typeSuffix'] === 'string' && { typeSuffix: obj['typeSuffix'] }),
         // `banner` is a boolean toggle or a custom header string, mirroring the CLI flag.
         ...((typeof obj['banner'] === 'boolean' || typeof obj['banner'] === 'string') && { banner: obj['banner'] }),

package/dist/parse-cli-args.js

@@ -18,6 +18,7 @@ const VALUE_KEYS = new Set([
     'export',
     'helpers',
     'typeSuffix',
+    'importExt',
 ]);
 // Recognized flags that don't map into CliConfig because they're consumed
 // earlier in the pipeline (e.g. `--config` is read by `extractConfigPath` to
@@ -31,6 +32,11 @@ const parseHelpersValue = (value) => {
         return value;
     return undefined;
 };
+const parseImportExtValue = (value) => {
+    if (value === 'js' || value === 'ts')
+        return value;
+    return undefined;
+};
 const parseInputValue = (value) => SOURCE_FORMATS.includes(value) ? value : undefined;
 /** Assigns a value-flag onto the config. Returns false for unknown keys. */
 const assignValue = (config, key, value) => {
@@ -69,6 +75,14 @@ const assignValue = (config, key, value) => {
             config.helpers = parsed;
             return true;
         }
+        case 'importExt': {
+            const parsed = parseImportExtValue(value);
+            if (!parsed) {
+                throw new Error(`Invalid --import-ext value "${value}". Expected one of: js, ts.`);
+            }
+            config.importExt = parsed;
+            return true;
+        }
         default:
             return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amritk/mjst",
-  "version": "0.7.15",
+  "version": "0.8.0",
   "description": "Generate TypeScript parsers and type definitions from JSON Schemas.",
   "type": "module",
   "license": "MIT",
@@ -41,10 +41,10 @@
     "generate-readme": "bun run ./scripts/generate-readme.ts"
   },
   "dependencies": {
-    "@amritk/adapters": "0.2.13",
-    "@amritk/generate-parsers": "0.12.3",
+    "@amritk/adapters": "0.2.15",
+    "@amritk/generate-parsers": "0.14.0",
     "@amritk/generate-markdown": "0.4.1",
-    "@amritk/helpers": "0.10.2"
+    "@amritk/helpers": "0.11.0"
   },
   "devDependencies": {
     "json-schema-typed": "^8.0.1"