@zhin.js/runtime 1.1.1 → 1.1.2

package/lib/native-development-runtime.d.ts

@@ -3,6 +3,12 @@ import type { ModuleRuntime, ModuleWatchRoot } from './module-runtime.js';
 export interface NativeDevelopmentModuleRuntimeOptions {
     readonly projectRoot: string;
     readonly watch?: boolean;
+    /** Optional scoped loader used only when the active Node loader rejects TSX. */
+    readonly tsxLoader?: TsxModuleLoader;
+}
+export interface TsxModuleLoader {
+    load<T = unknown>(source: string, parentURL: string): Promise<T>;
+    close?(): Promise<void>;
 }
 /**
  * Uses Node's native ESM/TypeScript loader and adds only cache busting and watch.

package/lib/native-development-runtime.js

@@ -18,6 +18,7 @@ const capabilityRoots = new Set([
 export class NativeDevelopmentModuleRuntime {
     #projectRoot;
     #watchEnabled;
+    #tsxLoader;
     #revisions = new Map();
     #watchers = new Set();
     #watchRoots;
@@ -25,19 +26,25 @@ export class NativeDevelopmentModuleRuntime {
     constructor(options) {
         this.#projectRoot = resolve(options.projectRoot);
         this.#watchEnabled = options.watch ?? true;
+        this.#tsxLoader = options.tsxLoader;
         this.#watchRoots = normalizeWatchRoots([this.#projectRoot]);
     }
     async load(source) {
         this.#assertOpen();
         const normalized = resolve(source);
-        if (normalized.endsWith('.tsx')) {
-            throw new Error(`Node native TypeScript does not support TSX: ${normalized}`);
-        }
         if (normalized.endsWith('.ts'))
             assertNativeTypeScriptSupport();
         const url = pathToFileURL(normalized);
         url.searchParams.set('zhin-generation', String(this.#revisions.get(normalized) ?? 0));
-        return import(url.href);
+        try {
+            return await import(url.href);
+        }
+        catch (error) {
+            if (!normalized.endsWith('.tsx') || !isUnsupportedTsxError(error) || !this.#tsxLoader) {
+                throw error;
+            }
+            return this.#tsxLoader.load(url.href, pathToFileURL(`${this.#projectRoot}${sep}`).href);
+        }
     }
     invalidate(source) {
         const normalized = resolve(source);
@@ -83,7 +90,7 @@ export class NativeDevelopmentModuleRuntime {
         // Support files inside capability directories (e.g. commands/_utils.ts)
         // are not discovery entries: reloading the entry URL only bumps that
         // entry's zhin-generation, so the importer closure keeps the old code.
-        return ['.js', '.json', '.ts'].includes(extname(normalized));
+        return ['.js', '.json', '.ts', '.tsx'].includes(extname(normalized));
     }
     updateWatchRoots(roots) {
         this.#assertOpen();
@@ -115,6 +122,7 @@ export class NativeDevelopmentModuleRuntime {
         for (const watcher of this.#watchers)
             watcher.close();
         this.#watchers.clear();
+        await this.#tsxLoader?.close?.();
     }
     #assertOpen() {
         if (this.#closed)
@@ -134,7 +142,7 @@ function isNamedCapabilityDirectory(value, allowSnake) {
 function isDirectoryCapabilityEntry(parts) {
     return parts.length === 2
         && parts[1] === `index${extname(parts[1] ?? '')}`
-        && ['.cjs', '.js', '.mjs', '.ts'].includes(extname(parts[1] ?? ''));
+        && ['.cjs', '.js', '.mjs', '.ts', '.tsx'].includes(extname(parts[1] ?? ''));
 }
 function isNestedDirectoryEntry(parts) {
     const index = parts.indexOf('tools');
@@ -157,6 +165,11 @@ export function assertNativeTypeScriptSupport() {
         'Use Node >=22.18.0 or start Node with --experimental-strip-types.',
     ].join(' '));
 }
+function isUnsupportedTsxError(error) {
+    return error instanceof Error
+        && 'code' in error
+        && error.code === 'ERR_UNKNOWN_FILE_EXTENSION';
+}
 class PortableSourceWatcher {
     listener;
     #watchers = new Set();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/runtime",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Static Plugin graph, generation transaction and HMR Root runtime for Zhin.js",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,23 +18,24 @@
   "dependencies": {
     "ajv": "8.18.0",
     "semver": "7.8.5",
-    "@zhin.js/feature-kit": "1.1.1",
-    "@zhin.js/plugin-runtime": "1.1.10"
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/plugin-runtime": "1.1.11"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
+    "tsx": "^4.23.1",
     "typescript": "^6.0.3",
-    "@zhin.js/adapter": "1.1.14",
-    "@zhin.js/agent-feature": "1.1.1",
-    "@zhin.js/command": "1.1.1",
-    "@zhin.js/component": "1.1.1",
-    "@zhin.js/layout": "1.1.1",
-    "@zhin.js/mcp-feature": "1.1.1",
-    "@zhin.js/middleware": "1.1.1",
-    "@zhin.js/page": "1.1.1",
-    "@zhin.js/prompt-section": "1.1.1",
-    "@zhin.js/skill": "1.1.1",
-    "@zhin.js/tool": "1.1.1"
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/command": "1.1.2",
+    "@zhin.js/component": "1.1.2",
+    "@zhin.js/layout": "1.1.2",
+    "@zhin.js/mcp-feature": "1.1.2",
+    "@zhin.js/middleware": "1.1.2",
+    "@zhin.js/page": "1.1.2",
+    "@zhin.js/prompt-section": "1.1.2",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "repository": {
     "type": "git",