@zhin.js/runtime 1.0.0

package/lib/typescript-specifier-remap.js

@@ -0,0 +1,92 @@
+import { access } from 'node:fs/promises';
+import { register } from 'node:module';
+import { sep } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/**
+ * ESM resolve hook: when a relative/absolute `.js` specifier fails and a
+ * sibling `.ts` / `.tsx` exists, rewrite to that source file.
+ *
+ * Needed for Plugin Runtime on Node 22.6–22.17 with `--experimental-strip-types`:
+ * TypeScript authoring uses `.js` import suffixes, but strip-types does not
+ * remap missing `.js` → `.ts` the way `tsc`/tsx do.
+ */
+export async function resolve(specifier, context, nextResolve) {
+    try {
+        return await nextResolve(specifier, context);
+    }
+    catch (error) {
+        if (!shouldTryTypeScript(specifier, error))
+            throw error;
+        const candidate = await firstExistingTypeScript(specifier, context.parentURL);
+        if (!candidate)
+            throw error;
+        return nextResolve(candidate, context);
+    }
+}
+let registered = false;
+/** Register once for the current process (safe to call from CLI / RootHost). */
+export function ensureTypeScriptSpecifierRemap() {
+    if (registered)
+        return;
+    registered = true;
+    register(import.meta.url);
+}
+function shouldTryTypeScript(specifier, error) {
+    if (!(error instanceof Error) || !('code' in error) || error.code !== 'ERR_MODULE_NOT_FOUND') {
+        return false;
+    }
+    if (specifier.startsWith('node:') || specifier.startsWith('data:'))
+        return false;
+    return /\.[cm]?js$/u.test(specifier) || specifier.endsWith('.jsx');
+}
+async function firstExistingTypeScript(specifier, parentURL) {
+    const resolvedJs = resolveAgainstParent(specifier, parentURL);
+    if (!resolvedJs)
+        return undefined;
+    // Prefer compiled lib/ over strip-types (.ts): many packages use syntax that
+    // Node strip-only mode rejects (parameter properties, enums, etc.).
+    const libCandidate = compiledLibPath(resolvedJs);
+    if (libCandidate && await exists(libCandidate)) {
+        return pathToFileURL(libCandidate).href;
+    }
+    const bases = [
+        resolvedJs.replace(/\.jsx$/u, ''),
+        resolvedJs.replace(/\.[cm]?js$/u, ''),
+    ];
+    for (const base of bases) {
+        for (const ext of ['.ts', '.tsx', '.mts', '.cts']) {
+            const candidate = `${base}${ext}`;
+            if (await exists(candidate))
+                return pathToFileURL(candidate).href;
+        }
+    }
+    return undefined;
+}
+function compiledLibPath(sourceJsPath) {
+    const marker = `${sep}src${sep}`;
+    const index = sourceJsPath.lastIndexOf(marker);
+    if (index < 0)
+        return undefined;
+    return `${sourceJsPath.slice(0, index)}${sep}lib${sep}${sourceJsPath.slice(index + marker.length)}`;
+}
+function resolveAgainstParent(specifier, parentURL) {
+    try {
+        if (specifier.startsWith('file:'))
+            return fileURLToPath(specifier);
+        if (!parentURL)
+            return undefined;
+        return fileURLToPath(new URL(specifier, parentURL));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@zhin.js/runtime",
+  "version": "1.0.0",
+  "description": "Static Plugin graph, generation transaction and HMR Root runtime for Zhin.js",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib"
+  ],
+  "dependencies": {
+    "ajv": "8.18.0",
+    "semver": "7.8.5",
+    "@zhin.js/feature-kit": "1.0.0",
+    "@zhin.js/plugin-runtime": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3",
+    "@zhin.js/adapter": "1.0.0",
+    "@zhin.js/agent-feature": "1.0.0",
+    "@zhin.js/component": "1.0.0",
+    "@zhin.js/page": "1.0.0",
+    "@zhin.js/layout": "1.0.0",
+    "@zhin.js/mcp-feature": "1.0.0",
+    "@zhin.js/command": "1.0.0",
+    "@zhin.js/middleware": "1.0.0",
+    "@zhin.js/tool": "1.0.0",
+    "@zhin.js/skill": "1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "packages/im/runtime"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "vitest run --root ../../.. packages/im/runtime/tests",
+    "check:size": "node ../../../scripts/check-plugin-runtime-install-size.mjs @zhin.js/runtime"
+  }
+}