@hirarijs/loader 1.0.18 → 1.0.19

package/dist/chunk-HIW3PA5X.js

@@ -0,0 +1,367 @@
+// src/config.ts
+import fs from "fs";
+import path from "path";
+var DEFAULT_CONFIG = {
+  format: "cjs",
+  plugins: [
+    "@hirarijs/loader-ts",
+    "@hirarijs/loader-tsx",
+    "@hirarijs/loader-vue",
+    "@hirarijs/loader-cjs-interop"
+  ]
+};
+function loadHirariConfig(cwd = process.cwd()) {
+  const configPath = path.join(cwd, "hirari.json");
+  if (!fs.existsSync(configPath)) {
+    return { ...DEFAULT_CONFIG };
+  }
+  const raw = fs.readFileSync(configPath, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(`Failed to parse hirari.json: ${error.message}`);
+  }
+  const loaderConfig = parsed.loader || {};
+  return {
+    ...DEFAULT_CONFIG,
+    ...loaderConfig,
+    plugins: loaderConfig.plugins?.length ? loaderConfig.plugins : DEFAULT_CONFIG.plugins
+  };
+}
+function getFormat(config) {
+  return config.format === "esm" ? "esm" : "cjs";
+}
+
+// src/constants.ts
+var IMPORT_META_URL_VARIABLE = "__hirari_loader_import_meta_url__";
+var BYPASS_FLAG = "__hirari_loader_bypass__";
+var BYPASS_PREFIX = "hirari-bypass:";
+
+// src/plugin-manager.ts
+import { spawnSync } from "child_process";
+import fs2 from "fs";
+import path2 from "path";
+import { createRequire } from "module";
+var PACKAGE_MANAGERS = [
+  { lock: "pnpm-lock.yaml", command: "pnpm", args: ["add"] },
+  { lock: "yarn.lock", command: "yarn", args: ["add"] },
+  { lock: "package-lock.json", command: "npm", args: ["install"] },
+  { lock: "npm-shrinkwrap.json", command: "npm", args: ["install"] }
+];
+function detectPackageManager(cwd) {
+  for (const pm of PACKAGE_MANAGERS) {
+    if (fs2.existsSync(path2.join(cwd, pm.lock))) return pm;
+  }
+  return { command: "npm", args: ["install"] };
+}
+function tryRequire(moduleId, cwd) {
+  const req = createRequire(path2.join(cwd, "noop.js"));
+  const loaded = req(moduleId);
+  return loaded && (loaded.default || loaded);
+}
+function install(pkg, cwd) {
+  const pm = detectPackageManager(cwd);
+  const result = spawnSync(pm.command, [...pm.args, pkg], {
+    cwd,
+    stdio: "inherit",
+    env: process.env
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`${pm.command} ${pm.args.join(" ")} ${pkg} failed`);
+  }
+}
+function resolvePlugins(config, cwd) {
+  const plugins = [];
+  for (const pluginName of config.plugins || []) {
+    let loaded = null;
+    try {
+      loaded = tryRequire(pluginName, cwd);
+    } catch (error) {
+      if (config.autoInstall) {
+        console.log(`[hirari-loader] installing missing plugin ${pluginName}`);
+        install(pluginName, cwd);
+        loaded = tryRequire(pluginName, cwd);
+      } else {
+        throw new Error(
+          `Plugin "${pluginName}" not found. Enable autoInstall or install manually.`
+        );
+      }
+    }
+    if (!loaded) continue;
+    plugins.push({
+      plugin: loaded,
+      options: config.pluginOptions?.[pluginName]
+    });
+    if (config.debug) {
+      console.log(`[hirari-loader] loaded plugin ${pluginName}`);
+    }
+  }
+  return plugins;
+}
+
+// src/runtime.ts
+import fs3 from "fs";
+import module from "module";
+import path3 from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+import { addHook } from "pirates";
+import * as sourceMapSupport from "source-map-support";
+var map = {};
+var packageTypeCache = /* @__PURE__ */ new Map();
+var EXTENSION_CANDIDATES = [
+  ".ts",
+  ".mts",
+  ".cts",
+  ".tsx",
+  ".jsx",
+  ".vue",
+  ".js",
+  ".mjs",
+  ".cjs"
+];
+function installSourceMaps() {
+  sourceMapSupport.install({
+    handleUncaughtExceptions: false,
+    environment: "node",
+    retrieveSourceMap(file) {
+      if (map[file]) {
+        return { url: file, map: map[file] };
+      }
+      return null;
+    }
+  });
+}
+var toNodeLoaderFormat = (format) => format === "esm" ? "module" : "commonjs";
+function findNearestPackageType(filename) {
+  const dir = path3.dirname(filename);
+  if (packageTypeCache.has(dir)) return packageTypeCache.get(dir);
+  let current = dir;
+  while (true) {
+    const candidate = path3.join(current, "package.json");
+    if (fs3.existsSync(candidate)) {
+      try {
+        const pkg = JSON.parse(fs3.readFileSync(candidate, "utf8"));
+        const type = pkg && pkg.type === "module" ? "module" : "commonjs";
+        packageTypeCache.set(dir, type);
+        return type;
+      } catch {
+        break;
+      }
+    }
+    const parent = path3.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  packageTypeCache.set(dir, "commonjs");
+  return "commonjs";
+}
+function inferFormat(filename, fallback) {
+  const ext = path3.extname(filename);
+  if (ext === ".mjs" || ext === ".mts" || ext === ".mtsx") return "esm";
+  if (ext === ".cjs" || ext === ".cts") return "cjs";
+  if (ext === ".js" || ext === ".ts" || ext === ".tsx" || ext === ".jsx" || ext === ".vue") {
+    const pkgType = findNearestPackageType(filename);
+    return pkgType === "module" ? "esm" : "cjs";
+  }
+  return fallback;
+}
+function createRuntime(cwd = process.cwd()) {
+  const loaderConfig = loadHirariConfig(cwd);
+  const resolvedPlugins = resolvePlugins(loaderConfig, cwd);
+  installSourceMaps();
+  return {
+    cwd,
+    loaderConfig,
+    resolvedPlugins,
+    format: getFormat(loaderConfig)
+  };
+}
+function applyPlugin(code, filename, runtime) {
+  let currentCode = code;
+  let currentFormat = runtime.format;
+  let lastResult = null;
+  for (const match of runtime.resolvedPlugins) {
+    if (!match.plugin.match(filename)) continue;
+    const ctx = {
+      format: currentFormat,
+      loaderConfig: runtime.loaderConfig,
+      pluginOptions: match.options
+    };
+    const result = match.plugin.transform(currentCode, filename, ctx);
+    if (runtime.loaderConfig.debug) {
+      console.log(`[hirari-loader][${match.plugin.name}] compiled ${filename}`);
+    }
+    if (result.map) {
+      map[filename] = result.map;
+    }
+    if (result.format) {
+      currentFormat = result.format;
+    }
+    if (result.continue) {
+      lastResult = result;
+      if (result.code) {
+        currentCode = result.code;
+      }
+      continue;
+    }
+    return result;
+  }
+  if (lastResult) {
+    return {
+      code: lastResult.code ?? currentCode,
+      map: lastResult.map,
+      format: lastResult.format ?? currentFormat
+    };
+  }
+  if (runtime.loaderConfig.debug) {
+    console.log(`[hirari-loader] no plugin matched ${filename}`);
+  }
+  return { code: currentCode };
+}
+function pickPlugin(filename, runtime) {
+  return runtime.resolvedPlugins.find(({ plugin }) => plugin.match(filename));
+}
+function collectExtensions(plugins) {
+  const set = /* @__PURE__ */ new Set();
+  for (const { plugin } of plugins) {
+    plugin.extensions.forEach((ext) => set.add(ext));
+  }
+  return Array.from(set);
+}
+function registerRequireHooks(runtime) {
+  const extensions = collectExtensions(runtime.resolvedPlugins);
+  const compile = (code, filename) => {
+    if (globalThis[BYPASS_FLAG]) {
+      return code;
+    }
+    const result = applyPlugin(code, filename, runtime);
+    const banner = `const ${IMPORT_META_URL_VARIABLE} = require('url').pathToFileURL(__filename).href;`;
+    if (!result.code.includes(IMPORT_META_URL_VARIABLE)) {
+      return `${banner}${result.code}`;
+    }
+    return result.code;
+  };
+  const revert = addHook(compile, {
+    exts: extensions,
+    ignoreNodeModules: false
+  });
+  const extensionsObj = module.Module._extensions;
+  const jsHandler = extensionsObj[".js"];
+  extensionsObj[".js"] = function(mod, filename) {
+    try {
+      return jsHandler.call(this, mod, filename);
+    } catch (error) {
+      if (error && error.code === "ERR_REQUIRE_ESM") {
+        const src = fs3.readFileSync(filename, "utf8");
+        const result = applyPlugin(src, filename, runtime);
+        mod._compile(result.code, filename);
+        return;
+      }
+      throw error;
+    }
+  };
+  return () => {
+    revert();
+    extensionsObj[".js"] = jsHandler;
+  };
+}
+async function loaderResolve(specifier, context, next, runtime) {
+  const parentUrl = context && context.parentURL;
+  const baseDir = parentUrl && typeof parentUrl === "string" && parentUrl.startsWith("file:") ? path3.dirname(fileURLToPath(parentUrl)) : process.cwd();
+  if (specifier.startsWith(BYPASS_PREFIX)) {
+    const target = specifier.slice(BYPASS_PREFIX.length);
+    const url = target.startsWith("file:") ? target : pathToFileURL(target).href;
+    return { url, shortCircuit: true };
+  }
+  for (const match of runtime.resolvedPlugins) {
+    if (typeof match.plugin.resolve !== "function") continue;
+    const importer = parentUrl && typeof parentUrl === "string" && parentUrl.startsWith("file:") ? fileURLToPath(parentUrl) : null;
+    const ctx = {
+      format: runtime.format,
+      loaderConfig: runtime.loaderConfig,
+      pluginOptions: match.options
+    };
+    const res = match.plugin.resolve(specifier, importer, ctx);
+    if (res && res.url) {
+      const url = res.url.startsWith("file:") ? res.url : pathToFileURL(res.url).href;
+      return { url, shortCircuit: res.shortCircuit !== false, format: res.format };
+    }
+  }
+  const tryResolve = (basePath, note) => {
+    for (const ext2 of EXTENSION_CANDIDATES) {
+      const candidate = basePath + ext2;
+      if (fs3.existsSync(candidate) && fs3.statSync(candidate).isFile()) {
+        const url = pathToFileURL(candidate).href;
+        if (runtime.loaderConfig.debug) {
+          console.log(`[hirari-loader] resolve ${note} ${specifier} -> ${url}`);
+        }
+        return { url, shortCircuit: true };
+      }
+      const indexCandidate = path3.join(basePath, "index" + ext2);
+      if (fs3.existsSync(indexCandidate) && fs3.statSync(indexCandidate).isFile()) {
+        const url = pathToFileURL(indexCandidate).href;
+        if (runtime.loaderConfig.debug) {
+          console.log(`[hirari-loader] resolve ${note} ${specifier} -> ${url}`);
+        }
+        return { url, shortCircuit: true };
+      }
+    }
+    return null;
+  };
+  if (!path3.extname(specifier) && (specifier.startsWith("./") || specifier.startsWith("../") || specifier.startsWith("/") || specifier.startsWith("file:")) && !specifier.startsWith("node:")) {
+    const basePath = specifier.startsWith("file:") ? fileURLToPath(specifier) : specifier.startsWith("/") ? specifier : path3.resolve(baseDir, specifier);
+    const res = tryResolve(basePath, "extless");
+    if (res) return res;
+  }
+  const ext = path3.extname(specifier);
+  if ((ext === ".js" || ext === ".mjs" || ext === ".cjs") && (specifier.startsWith("./") || specifier.startsWith("../") || specifier.startsWith("/") || specifier.startsWith("file:"))) {
+    const withoutExt = specifier.slice(0, -ext.length);
+    const basePath = specifier.startsWith("file:") ? fileURLToPath(withoutExt) : specifier.startsWith("/") ? withoutExt : path3.resolve(baseDir, withoutExt);
+    const res = tryResolve(basePath, "fallback-js");
+    if (res) return res;
+  }
+  if (next) return next(specifier, context);
+  return { url: specifier, shortCircuit: true };
+}
+async function loaderLoad(url, context, next, runtime) {
+  const { format: expectedFormat } = runtime;
+  if (url.startsWith("file://")) {
+    const filename = fileURLToPath(url);
+    const match = pickPlugin(filename, runtime);
+    if (runtime.loaderConfig.debug) {
+      console.log(`[hirari-loader] load hook url=${url} match=${!!match}`);
+    }
+    if (match) {
+      const source = fs3.readFileSync(filename, "utf8");
+      const result = applyPlugin(source, filename, runtime);
+      const fallbackFormat = inferFormat(filename, expectedFormat);
+      return {
+        format: toNodeLoaderFormat(result.format || fallbackFormat),
+        source: result.code,
+        shortCircuit: true
+      };
+    }
+  }
+  if (!next) {
+    throw new Error("No default loader available for " + url);
+  }
+  const forwarded = await next(url, context);
+  if (forwarded) return forwarded;
+  throw new Error("Loader did not return a result for " + url);
+}
+
+export {
+  loadHirariConfig,
+  IMPORT_META_URL_VARIABLE,
+  BYPASS_FLAG,
+  BYPASS_PREFIX,
+  resolvePlugins,
+  createRuntime,
+  registerRequireHooks,
+  loaderResolve,
+  loaderLoad
+};

package/dist/chunk-VGNNMSLY.js

@@ -0,0 +1,15 @@
+import {
+  createRuntime,
+  registerRequireHooks
+} from "./chunk-HIW3PA5X.js";
+
+// src/register.ts
+function register(cwd = process.cwd()) {
+  const runtime = createRuntime(cwd);
+  const unregister = registerRequireHooks(runtime);
+  return { unregister };
+}
+
+export {
+  register
+};

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BYPASS_FLAG: () => BYPASS_FLAG,
+  BYPASS_PREFIX: () => BYPASS_PREFIX,
   IMPORT_META_URL_VARIABLE: () => IMPORT_META_URL_VARIABLE,
   createRuntime: () => createRuntime,
   loadHirariConfig: () => loadHirariConfig,
@@ -84,6 +85,7 @@ var sourceMapSupport = __toESM(require("source-map-support"), 1);
 // src/constants.ts
 var IMPORT_META_URL_VARIABLE = "__hirari_loader_import_meta_url__";
 var BYPASS_FLAG = "__hirari_loader_bypass__";
+var BYPASS_PREFIX = "hirari-bypass:";
 
 // src/plugin-manager.ts
 var import_child_process = require("child_process");
@@ -271,6 +273,7 @@ function register(cwd = process.cwd()) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BYPASS_FLAG,
+  BYPASS_PREFIX,
   IMPORT_META_URL_VARIABLE,
   createRuntime,
   loadHirariConfig,

package/dist/index.d.cts

@@ -25,6 +25,14 @@ interface LoaderPlugin {
      * Match is called with the absolute filename. Return true when the plugin should run.
      */
     match: (filename: string) => boolean;
+    /**
+     * Optional resolve hook. Return a URL (or null to skip) to short-circuit resolution.
+     */
+    resolve?: (specifier: string, importer: string | null, ctx: LoaderPluginContext) => {
+        url: string;
+        format?: ModuleFormat;
+        shortCircuit?: boolean;
+    } | null;
     /**
      * Synchronous transform hook. Should return already-transformed JS.
      */
@@ -63,5 +71,6 @@ declare function createRuntime(cwd?: string): RuntimeContext;
 
 declare const IMPORT_META_URL_VARIABLE = "__hirari_loader_import_meta_url__";
 declare const BYPASS_FLAG = "__hirari_loader_bypass__";
+declare const BYPASS_PREFIX = "hirari-bypass:";
 
-export { BYPASS_FLAG, type HirariConfig, IMPORT_META_URL_VARIABLE, type LoaderConfig, type LoaderPlugin, type LoaderPluginContext, type ModuleFormat, type TransformResult, createRuntime, loadHirariConfig, resolvePlugins };
+export { BYPASS_FLAG, BYPASS_PREFIX, type HirariConfig, IMPORT_META_URL_VARIABLE, type LoaderConfig, type LoaderPlugin, type LoaderPluginContext, type ModuleFormat, type TransformResult, createRuntime, loadHirariConfig, resolvePlugins };

package/dist/index.d.ts

@@ -25,6 +25,14 @@ interface LoaderPlugin {
      * Match is called with the absolute filename. Return true when the plugin should run.
      */
     match: (filename: string) => boolean;
+    /**
+     * Optional resolve hook. Return a URL (or null to skip) to short-circuit resolution.
+     */
+    resolve?: (specifier: string, importer: string | null, ctx: LoaderPluginContext) => {
+        url: string;
+        format?: ModuleFormat;
+        shortCircuit?: boolean;
+    } | null;
     /**
      * Synchronous transform hook. Should return already-transformed JS.
      */
@@ -63,5 +71,6 @@ declare function createRuntime(cwd?: string): RuntimeContext;
 
 declare const IMPORT_META_URL_VARIABLE = "__hirari_loader_import_meta_url__";
 declare const BYPASS_FLAG = "__hirari_loader_bypass__";
+declare const BYPASS_PREFIX = "hirari-bypass:";
 
-export { BYPASS_FLAG, type HirariConfig, IMPORT_META_URL_VARIABLE, type LoaderConfig, type LoaderPlugin, type LoaderPluginContext, type ModuleFormat, type TransformResult, createRuntime, loadHirariConfig, resolvePlugins };
+export { BYPASS_FLAG, BYPASS_PREFIX, type HirariConfig, IMPORT_META_URL_VARIABLE, type LoaderConfig, type LoaderPlugin, type LoaderPluginContext, type ModuleFormat, type TransformResult, createRuntime, loadHirariConfig, resolvePlugins };

package/dist/index.js

@@ -1,15 +1,17 @@
 import {
   register
-} from "./chunk-B7W66ZEK.js";
+} from "./chunk-VGNNMSLY.js";
 import {
   BYPASS_FLAG,
+  BYPASS_PREFIX,
   IMPORT_META_URL_VARIABLE,
   createRuntime,
   loadHirariConfig,
   resolvePlugins
-} from "./chunk-ORDKCG7D.js";
+} from "./chunk-HIW3PA5X.js";
 export {
   BYPASS_FLAG,
+  BYPASS_PREFIX,
   IMPORT_META_URL_VARIABLE,
   createRuntime,
   loadHirariConfig,

package/dist/loader.cjs

@@ -42,6 +42,9 @@ var import_url = require("url");
 var import_pirates = require("pirates");
 var sourceMapSupport = __toESM(require("source-map-support"), 1);
 
+// src/constants.ts
+var BYPASS_PREFIX = "hirari-bypass:";
+
 // src/config.ts
 var import_fs = __toESM(require("fs"), 1);
 var import_path = __toESM(require("path"), 1);
@@ -144,6 +147,7 @@ function resolvePlugins(config, cwd) {
 
 // src/runtime.ts
 var map = {};
+var packageTypeCache = /* @__PURE__ */ new Map();
 var EXTENSION_CANDIDATES = [
   ".ts",
   ".mts",
@@ -168,6 +172,39 @@ function installSourceMaps() {
   });
 }
 var toNodeLoaderFormat = (format) => format === "esm" ? "module" : "commonjs";
+function findNearestPackageType(filename) {
+  const dir = import_path3.default.dirname(filename);
+  if (packageTypeCache.has(dir)) return packageTypeCache.get(dir);
+  let current = dir;
+  while (true) {
+    const candidate = import_path3.default.join(current, "package.json");
+    if (import_fs3.default.existsSync(candidate)) {
+      try {
+        const pkg = JSON.parse(import_fs3.default.readFileSync(candidate, "utf8"));
+        const type = pkg && pkg.type === "module" ? "module" : "commonjs";
+        packageTypeCache.set(dir, type);
+        return type;
+      } catch {
+        break;
+      }
+    }
+    const parent = import_path3.default.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  packageTypeCache.set(dir, "commonjs");
+  return "commonjs";
+}
+function inferFormat(filename, fallback) {
+  const ext = import_path3.default.extname(filename);
+  if (ext === ".mjs" || ext === ".mts" || ext === ".mtsx") return "esm";
+  if (ext === ".cjs" || ext === ".cts") return "cjs";
+  if (ext === ".js" || ext === ".ts" || ext === ".tsx" || ext === ".jsx" || ext === ".vue") {
+    const pkgType = findNearestPackageType(filename);
+    return pkgType === "module" ? "esm" : "cjs";
+  }
+  return fallback;
+}
 function createRuntime(cwd = process.cwd()) {
   const loaderConfig = loadHirariConfig(cwd);
   const resolvedPlugins = resolvePlugins(loaderConfig, cwd);
@@ -227,6 +264,25 @@ function pickPlugin(filename, runtime2) {
 async function loaderResolve(specifier, context, next, runtime2) {
   const parentUrl = context && context.parentURL;
   const baseDir = parentUrl && typeof parentUrl === "string" && parentUrl.startsWith("file:") ? import_path3.default.dirname((0, import_url.fileURLToPath)(parentUrl)) : process.cwd();
+  if (specifier.startsWith(BYPASS_PREFIX)) {
+    const target = specifier.slice(BYPASS_PREFIX.length);
+    const url = target.startsWith("file:") ? target : (0, import_url.pathToFileURL)(target).href;
+    return { url, shortCircuit: true };
+  }
+  for (const match of runtime2.resolvedPlugins) {
+    if (typeof match.plugin.resolve !== "function") continue;
+    const importer = parentUrl && typeof parentUrl === "string" && parentUrl.startsWith("file:") ? (0, import_url.fileURLToPath)(parentUrl) : null;
+    const ctx = {
+      format: runtime2.format,
+      loaderConfig: runtime2.loaderConfig,
+      pluginOptions: match.options
+    };
+    const res = match.plugin.resolve(specifier, importer, ctx);
+    if (res && res.url) {
+      const url = res.url.startsWith("file:") ? res.url : (0, import_url.pathToFileURL)(res.url).href;
+      return { url, shortCircuit: res.shortCircuit !== false, format: res.format };
+    }
+  }
   const tryResolve = (basePath, note) => {
     for (const ext2 of EXTENSION_CANDIDATES) {
       const candidate = basePath + ext2;
@@ -274,8 +330,9 @@ async function loaderLoad(url, context, next, runtime2) {
     if (match) {
       const source = import_fs3.default.readFileSync(filename, "utf8");
       const result = applyPlugin(source, filename, runtime2);
+      const fallbackFormat = inferFormat(filename, expectedFormat);
       return {
-        format: toNodeLoaderFormat(result.format || expectedFormat),
+        format: toNodeLoaderFormat(result.format || fallbackFormat),
         source: result.code,
         shortCircuit: true
       };

package/dist/loader.js

@@ -2,7 +2,7 @@ import {
   createRuntime,
   loaderLoad,
   loaderResolve
-} from "./chunk-ORDKCG7D.js";
+} from "./chunk-HIW3PA5X.js";
 
 // src/loader.ts
 var runtime = createRuntime();

package/dist/register-auto.js

@@ -1,7 +1,7 @@
 import {
   register
-} from "./chunk-B7W66ZEK.js";
-import "./chunk-ORDKCG7D.js";
+} from "./chunk-VGNNMSLY.js";
+import "./chunk-HIW3PA5X.js";
 
 // src/register-auto.ts
 register();

package/dist/register.js

@@ -1,7 +1,7 @@
 import {
   register
-} from "./chunk-B7W66ZEK.js";
-import "./chunk-ORDKCG7D.js";
+} from "./chunk-VGNNMSLY.js";
+import "./chunk-HIW3PA5X.js";
 export {
   register
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirarijs/loader",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "description": "Runtime loader for HirariJS that wires loader plugins and config",
   "type": "module",
   "main": "./dist/index.cjs",