@mindees/compiler 0.27.1 → 0.28.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { PerfLintOptions, perfLint } from "./perf-lint.js";
 import { CompileOptions, CompileResult, CompileStats, Diagnostic, DiagnosticSeverity, MdcPlugin, SourcePosition } from "./types.js";
 import { BudgetOptions, checkBudget } from "./budget.js";
 import { STATIC_MARKER, createFlattenTransformer } from "./flatten.js";
+import { rewriteImportSpecifiers } from "./rewrite-imports.js";
 import { GenerateRouteModuleOptions, RouteEntry, RouteManifest, buildRouteManifest, chunkName, fileToRoute, generateRouteModule } from "./routes.js";
 import { compile, compileChecked } from "./transform.js";
 import { hasErrors, typecheck } from "./typecheck.js";
@@ -12,7 +13,7 @@ import { Maturity, NotImplementedError, PackageInfo, notImplemented } from "@min
 /** The npm package name. */
 declare const name = "@mindees/compiler";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-declare const VERSION = "0.27.1";
+declare const VERSION = "0.28.0";
 /**
  * Current maturity. The build-time optimizer — type-check gate, TSX→createElement
  * transform, tree-flattening, per-route manifest, plugin API — is implemented
@@ -27,5 +28,5 @@ declare const maturity: Maturity;
  */
 declare const info: PackageInfo;
 //#endregion
-export { type BudgetOptions, type CompileOptions, type CompileResult, type CompileStats, type Diagnostic, type DiagnosticSeverity, type GenerateRouteModuleOptions, type Maturity, type MdcPlugin, type NativeTarget, NotImplementedError, type PackageInfo, type PerfLintOptions, type RouteEntry, type RouteManifest, STATIC_MARKER, type SourcePosition, VERSION, buildRouteManifest, checkBudget, chunkName, compile, compileChecked, compileToNative, createFlattenTransformer, fileToRoute, generateRouteModule, hasErrors, info, maturity, name, notImplemented, perfLint, typecheck };
+export { type BudgetOptions, type CompileOptions, type CompileResult, type CompileStats, type Diagnostic, type DiagnosticSeverity, type GenerateRouteModuleOptions, type Maturity, type MdcPlugin, type NativeTarget, NotImplementedError, type PackageInfo, type PerfLintOptions, type RouteEntry, type RouteManifest, STATIC_MARKER, type SourcePosition, VERSION, buildRouteManifest, checkBudget, chunkName, compile, compileChecked, compileToNative, createFlattenTransformer, fileToRoute, generateRouteModule, hasErrors, info, maturity, name, notImplemented, perfLint, rewriteImportSpecifiers, typecheck };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;cAqCa,IAAA;AAGO;AAAA,cAAP,OAAA;;;;AAQmC;AAOhD;;cAPa,QAAA,EAAU,QAAyB;;AAOoC;;;;cAAvE,IAAA,EAAM,WAAiE"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;cAuCa,IAAA;AAWb;AAAA,cARa,OAAA;;;AAQmC;AAOhD;;;cAPa,QAAA,EAAU,QAAyB;AAOoC;;;;;AAAA,cAAvE,IAAA,EAAM,WAAiE"}

package/dist/index.js

@@ -3,6 +3,7 @@ import { checkBudget } from "./budget.js";
 import { STATIC_MARKER, createFlattenTransformer } from "./flatten.js";
 import { hasErrors, typecheck } from "./typecheck.js";
 import { perfLint } from "./perf-lint.js";
+import { rewriteImportSpecifiers } from "./rewrite-imports.js";
 import { buildRouteManifest, chunkName, fileToRoute, generateRouteModule } from "./routes.js";
 import { compile, compileChecked } from "./transform.js";
 import { NotImplementedError, notImplemented } from "@mindees/core";
@@ -10,7 +11,7 @@ import { NotImplementedError, notImplemented } from "@mindees/core";
 /** The npm package name. */
 const name = "@mindees/compiler";
 /** The package version. All `@mindees/*` packages share one locked version line. */
-const VERSION = "0.27.1";
+const VERSION = "0.28.0";
 /**
 * Current maturity. The build-time optimizer — type-check gate, TSX→createElement
 * transform, tree-flattening, per-route manifest, plugin API — is implemented
@@ -29,6 +30,6 @@ const info = Object.freeze({
 	maturity
 });
 //#endregion
-export { NotImplementedError, STATIC_MARKER, VERSION, buildRouteManifest, checkBudget, chunkName, compile, compileChecked, compileToNative, createFlattenTransformer, fileToRoute, generateRouteModule, hasErrors, info, maturity, name, notImplemented, perfLint, typecheck };
+export { NotImplementedError, STATIC_MARKER, VERSION, buildRouteManifest, checkBudget, chunkName, compile, compileChecked, compileToNative, createFlattenTransformer, fileToRoute, generateRouteModule, hasErrors, info, maturity, name, notImplemented, perfLint, rewriteImportSpecifiers, typecheck };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** TS → native AOT (research track). */\nexport { compileToNative, type NativeTarget } from './aot'\n/** Build-time performance budget (opt-in via `compileChecked(src, { budget })`) — fails the build. */\nexport { type BudgetOptions, checkBudget } from './budget'\n/** Tree-flattening optimizer pass. */\nexport { createFlattenTransformer, STATIC_MARKER } from './flatten'\n/** Build-time perf-lint (opt-in via `compileChecked(src, { perf: true })`). */\nexport { type PerfLintOptions, perfLint } from './perf-lint'\n/** Per-route code-splitting manifest + file-based route codegen. */\nexport {\n  buildRouteManifest,\n  chunkName,\n  fileToRoute,\n  type GenerateRouteModuleOptions,\n  generateRouteModule,\n  type RouteEntry,\n  type RouteManifest,\n} from './routes'\n/** Compile pipeline (TSX → optimized JS). */\nexport { compile, compileChecked } from './transform'\n/** The type-check gate. */\nexport { hasErrors, typecheck } from './typecheck'\n/** Shared types. */\nexport type {\n  CompileOptions,\n  CompileResult,\n  CompileStats,\n  Diagnostic,\n  DiagnosticSeverity,\n  MdcPlugin,\n  SourcePosition,\n} from './types'\n\n/** The npm package name. */\nexport const name = '@mindees/compiler'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.27.1'\n\n/**\n * Current maturity. The build-time optimizer — type-check gate, TSX→createElement\n * transform, tree-flattening, per-route manifest, plugin API — is implemented\n * and tested on the TypeScript Compiler API. TS→native AOT is a research track\n * (throws `NotImplementedError`); the working path is TS → optimized JS.\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;AAqCA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;AAQvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { Maturity, PackageInfo } from '@mindees/core'\nimport { NotImplementedError, notImplemented } from '@mindees/core'\n\n/** TS → native AOT (research track). */\nexport { compileToNative, type NativeTarget } from './aot'\n/** Build-time performance budget (opt-in via `compileChecked(src, { budget })`) — fails the build. */\nexport { type BudgetOptions, checkBudget } from './budget'\n/** Tree-flattening optimizer pass. */\nexport { createFlattenTransformer, STATIC_MARKER } from './flatten'\n/** Build-time perf-lint (opt-in via `compileChecked(src, { perf: true })`). */\nexport { type PerfLintOptions, perfLint } from './perf-lint'\n/** Rewrite relative import specifiers in emitted JS for native-ESM (browser) loading. */\nexport { rewriteImportSpecifiers } from './rewrite-imports'\n/** Per-route code-splitting manifest + file-based route codegen. */\nexport {\n  buildRouteManifest,\n  chunkName,\n  fileToRoute,\n  type GenerateRouteModuleOptions,\n  generateRouteModule,\n  type RouteEntry,\n  type RouteManifest,\n} from './routes'\n/** Compile pipeline (TSX → optimized JS). */\nexport { compile, compileChecked } from './transform'\n/** The type-check gate. */\nexport { hasErrors, typecheck } from './typecheck'\n/** Shared types. */\nexport type {\n  CompileOptions,\n  CompileResult,\n  CompileStats,\n  Diagnostic,\n  DiagnosticSeverity,\n  MdcPlugin,\n  SourcePosition,\n} from './types'\n\n/** The npm package name. */\nexport const name = '@mindees/compiler'\n\n/** The package version. All `@mindees/*` packages share one locked version line. */\nexport const VERSION = '0.28.0'\n\n/**\n * Current maturity. The build-time optimizer — type-check gate, TSX→createElement\n * transform, tree-flattening, per-route manifest, plugin API — is implemented\n * and tested on the TypeScript Compiler API. TS→native AOT is a research track\n * (throws `NotImplementedError`); the working path is TS → optimized JS.\n */\nexport const maturity: Maturity = 'experimental'\n\n/**\n * Static identity + maturity metadata for this package. Frozen so the\n * self-reported identity tooling introspects cannot be mutated at runtime,\n * matching the `readonly` fields of {@link PackageInfo}.\n */\nexport const info: PackageInfo = Object.freeze({ name, version: VERSION, maturity })\n\nexport type { Maturity, PackageInfo }\nexport { NotImplementedError, notImplemented }\n"],"mappings":";;;;;;;;;;;AAuCA,MAAa,OAAO;;AAGpB,MAAa,UAAU;;;;;;;AAQvB,MAAa,WAAqB;;;;;;AAOlC,MAAa,OAAoB,OAAO,OAAO;CAAE;CAAM,SAAS;CAAS;AAAS,CAAC"}

package/dist/rewrite-imports.d.ts

@@ -0,0 +1,20 @@
+//#region src/rewrite-imports.d.ts
+/**
+ * Rewrite relative import/export specifiers in EMITTED JavaScript so they load as native ES modules in a
+ * browser (which needs explicit file extensions). AST-based, not regex: it touches ONLY real module
+ * specifiers — `import … from '…'`, `export … from '…'`, and `import('…')` with a single string-literal
+ * argument. A concatenated dynamic import (`import('./x/' + name)`) has a non-literal argument and is left
+ * alone; import-like text inside a string or comment is never matched.
+ *
+ * The `resolve` callback decides the new specifier for each relative one (e.g. add `.js`, or `/index.js`
+ * for a directory). Only `./`/`../` specifiers are passed to it; bare specifiers (`@mindees/*`, npm) are
+ * left untouched. Edits are applied right-to-left so positions stay valid (minor column-level source-map
+ * drift on the edited specifiers only — never structural corruption).
+ *
+ * @module
+ */
+/** Rewrite relative module specifiers in `code` via `resolve`. Returns the original string if nothing changed. */
+declare function rewriteImportSpecifiers(code: string, resolve: (specifier: string) => string): string;
+//#endregion
+export { rewriteImportSpecifiers };
+//# sourceMappingURL=rewrite-imports.d.ts.map

package/dist/rewrite-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-imports.d.ts","names":[],"sources":["../src/rewrite-imports.ts"],"mappings":";;AAkBA;;;;;;;;AAEwC;;;;;;iBAFxB,uBAAA,CACd,IAAA,UACA,OAAA,GAAU,SAAA"}

package/dist/rewrite-imports.js

@@ -0,0 +1,49 @@
+import ts from "typescript";
+//#region src/rewrite-imports.ts
+/**
+* Rewrite relative import/export specifiers in EMITTED JavaScript so they load as native ES modules in a
+* browser (which needs explicit file extensions). AST-based, not regex: it touches ONLY real module
+* specifiers — `import … from '…'`, `export … from '…'`, and `import('…')` with a single string-literal
+* argument. A concatenated dynamic import (`import('./x/' + name)`) has a non-literal argument and is left
+* alone; import-like text inside a string or comment is never matched.
+*
+* The `resolve` callback decides the new specifier for each relative one (e.g. add `.js`, or `/index.js`
+* for a directory). Only `./`/`../` specifiers are passed to it; bare specifiers (`@mindees/*`, npm) are
+* left untouched. Edits are applied right-to-left so positions stay valid (minor column-level source-map
+* drift on the edited specifiers only — never structural corruption).
+*
+* @module
+*/
+/** Rewrite relative module specifiers in `code` via `resolve`. Returns the original string if nothing changed. */
+function rewriteImportSpecifiers(code, resolve) {
+	const sf = ts.createSourceFile("module.js", code, ts.ScriptTarget.ESNext, true, ts.ScriptKind.JS);
+	const edits = [];
+	const consider = (lit) => {
+		const spec = lit.text;
+		if (!spec.startsWith("./") && !spec.startsWith("../")) return;
+		const next = resolve(spec);
+		if (next === spec) return;
+		const start = lit.getStart(sf);
+		const quote = code[start] ?? "'";
+		edits.push({
+			start,
+			end: lit.getEnd(),
+			text: `${quote}${next}${quote}`
+		});
+	};
+	const visit = (node) => {
+		if ((ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) consider(node.moduleSpecifier);
+		else if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword && node.arguments.length === 1 && ts.isStringLiteralLike(node.arguments[0])) consider(node.arguments[0]);
+		ts.forEachChild(node, visit);
+	};
+	visit(sf);
+	if (edits.length === 0) return code;
+	edits.sort((a, b) => b.start - a.start);
+	let out = code;
+	for (const e of edits) out = out.slice(0, e.start) + e.text + out.slice(e.end);
+	return out;
+}
+//#endregion
+export { rewriteImportSpecifiers };
+
+//# sourceMappingURL=rewrite-imports.js.map

package/dist/rewrite-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-imports.js","names":[],"sources":["../src/rewrite-imports.ts"],"sourcesContent":["/**\n * Rewrite relative import/export specifiers in EMITTED JavaScript so they load as native ES modules in a\n * browser (which needs explicit file extensions). AST-based, not regex: it touches ONLY real module\n * specifiers — `import … from '…'`, `export … from '…'`, and `import('…')` with a single string-literal\n * argument. A concatenated dynamic import (`import('./x/' + name)`) has a non-literal argument and is left\n * alone; import-like text inside a string or comment is never matched.\n *\n * The `resolve` callback decides the new specifier for each relative one (e.g. add `.js`, or `/index.js`\n * for a directory). Only `./`/`../` specifiers are passed to it; bare specifiers (`@mindees/*`, npm) are\n * left untouched. Edits are applied right-to-left so positions stay valid (minor column-level source-map\n * drift on the edited specifiers only — never structural corruption).\n *\n * @module\n */\n\nimport ts from 'typescript'\n\n/** Rewrite relative module specifiers in `code` via `resolve`. Returns the original string if nothing changed. */\nexport function rewriteImportSpecifiers(\n  code: string,\n  resolve: (specifier: string) => string,\n): string {\n  const sf = ts.createSourceFile('module.js', code, ts.ScriptTarget.ESNext, true, ts.ScriptKind.JS)\n  const edits: Array<{ start: number; end: number; text: string }> = []\n\n  const consider = (lit: ts.StringLiteralLike): void => {\n    const spec = lit.text\n    if (!spec.startsWith('./') && !spec.startsWith('../')) return // only relative; bare specifiers pass through\n    const next = resolve(spec)\n    if (next === spec) return\n    const start = lit.getStart(sf)\n    const quote = code[start] ?? \"'\" // preserve the original quote character\n    edits.push({ start, end: lit.getEnd(), text: `${quote}${next}${quote}` })\n  }\n\n  const visit = (node: ts.Node): void => {\n    if (\n      (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) &&\n      node.moduleSpecifier &&\n      ts.isStringLiteral(node.moduleSpecifier)\n    ) {\n      consider(node.moduleSpecifier)\n    } else if (\n      ts.isCallExpression(node) &&\n      node.expression.kind === ts.SyntaxKind.ImportKeyword &&\n      node.arguments.length === 1 &&\n      ts.isStringLiteralLike(node.arguments[0] as ts.Expression)\n    ) {\n      consider(node.arguments[0] as ts.StringLiteralLike)\n    }\n    ts.forEachChild(node, visit)\n  }\n  visit(sf)\n\n  if (edits.length === 0) return code\n  edits.sort((a, b) => b.start - a.start) // right-to-left → earlier offsets stay valid\n  let out = code\n  for (const e of edits) out = out.slice(0, e.start) + e.text + out.slice(e.end)\n  return out\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAgB,wBACd,MACA,SACQ;CACR,MAAM,KAAK,GAAG,iBAAiB,aAAa,MAAM,GAAG,aAAa,QAAQ,MAAM,GAAG,WAAW,EAAE;CAChG,MAAM,QAA6D,CAAC;CAEpE,MAAM,YAAY,QAAoC;EACpD,MAAM,OAAO,IAAI;EACjB,IAAI,CAAC,KAAK,WAAW,IAAI,KAAK,CAAC,KAAK,WAAW,KAAK,GAAG;EACvD,MAAM,OAAO,QAAQ,IAAI;EACzB,IAAI,SAAS,MAAM;EACnB,MAAM,QAAQ,IAAI,SAAS,EAAE;EAC7B,MAAM,QAAQ,KAAK,UAAU;EAC7B,MAAM,KAAK;GAAE;GAAO,KAAK,IAAI,OAAO;GAAG,MAAM,GAAG,QAAQ,OAAO;EAAQ,CAAC;CAC1E;CAEA,MAAM,SAAS,SAAwB;EACrC,KACG,GAAG,oBAAoB,IAAI,KAAK,GAAG,oBAAoB,IAAI,MAC5D,KAAK,mBACL,GAAG,gBAAgB,KAAK,eAAe,GAEvC,SAAS,KAAK,eAAe;OACxB,IACL,GAAG,iBAAiB,IAAI,KACxB,KAAK,WAAW,SAAS,GAAG,WAAW,iBACvC,KAAK,UAAU,WAAW,KAC1B,GAAG,oBAAoB,KAAK,UAAU,EAAmB,GAEzD,SAAS,KAAK,UAAU,EAA0B;EAEpD,GAAG,aAAa,MAAM,KAAK;CAC7B;CACA,MAAM,EAAE;CAER,IAAI,MAAM,WAAW,GAAG,OAAO;CAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;CACtC,IAAI,MAAM;CACV,KAAK,MAAM,KAAK,OAAO,MAAM,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI,EAAE,OAAO,IAAI,MAAM,EAAE,GAAG;CAC7E,OAAO;AACT"}

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@mindees/compiler",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "description": "MindeesNative Compiler (MDC) — build-time optimizer: type-check gate, TSX→createElement transform, tree-flattening, per-route code-splitting, and a plugin API. TS→native AOT is a research track.",
   "license": "MIT OR Apache-2.0",
   "type": "module",
+  "engines": {
+    "node": ">=22.18.0"
+  },
   "sideEffects": false,
   "files": [
     "dist"
@@ -24,7 +27,7 @@
   },
   "dependencies": {
     "typescript": "6.0.3",
-    "@mindees/core": "0.27.1"
+    "@mindees/core": "0.28.0"
   },
   "scripts": {
     "build": "tsdown",