@dimina-kit/compiler 0.0.1-dev.20260706064107 → 0.0.1-dev.20260706125036

package/dist/stage-worker.browser.js

@@ -14942,81 +14942,23 @@ var init_npm_resolver = __esm({
 });
 
 // ../../dimina/fe/packages/compiler/src/env.js
-function normalizeExt(raw) {
-  if (typeof raw !== "string") {
-    return null;
-  }
-  const v = raw.trim().toLowerCase().replace(/^\.+/, "");
-  if (!/^[a-z0-9_-]+$/.test(v)) {
-    return null;
-  }
-  return `.${v}`;
-}
-function normalizeTag(raw) {
-  if (typeof raw !== "string") {
-    return null;
-  }
-  const v = raw.trim().toLowerCase().replace(/^\.+/, "");
-  if (!/^[a-z][a-z0-9_-]*$/.test(v)) {
-    return null;
-  }
-  return v;
-}
-function mergeUnique(builtins, custom, normalizer, reserved) {
-  const out = [...builtins];
-  const seen2 = new Set(builtins);
-  if (Array.isArray(custom)) {
-    for (const raw of custom) {
-      const n2 = normalizer(raw);
-      if (n2 && !seen2.has(n2) && !reserved?.has(n2)) {
-        seen2.add(n2);
-        out.push(n2);
-      }
-    }
-  }
-  return out;
-}
-function normalizeFileTypes(fileTypes = {}) {
-  const ft = fileTypes || {};
-  return {
-    templateExts: mergeUnique(DEFAULT_TEMPLATE_EXTS, ft.template, normalizeExt, RESERVED_EXTS),
-    styleExts: mergeUnique(DEFAULT_STYLE_EXTS, ft.style, normalizeExt, RESERVED_EXTS),
-    viewScriptExts: mergeUnique(DEFAULT_VIEW_SCRIPT_EXTS, ft.viewScript, normalizeExt, RESERVED_EXTS),
-    viewScriptTags: mergeUnique(DEFAULT_VIEW_SCRIPT_TAGS, ft.viewScript, normalizeTag)
-  };
-}
-function storeInfo(workPath, options = {}) {
+function storeInfo(workPath) {
   storePathInfo(workPath);
   storeProjectConfig();
   storeAppConfig();
   storePageConfig();
-  compilerOptions = normalizeFileTypes(options.fileTypes);
   return {
     pathInfo,
-    configInfo,
-    compilerOptions
+    configInfo
   };
 }
 function resetStoreInfo(opts) {
   pathInfo = opts.pathInfo;
   configInfo = opts.configInfo;
-  compilerOptions = opts.compilerOptions || normalizeFileTypes();
   if (pathInfo.workPath) {
     npmResolver = new NpmResolver(pathInfo.workPath);
   }
 }
-function getTemplateExts() {
-  return compilerOptions.templateExts;
-}
-function getStyleExts() {
-  return compilerOptions.styleExts;
-}
-function getViewScriptExts() {
-  return compilerOptions.viewScriptExts;
-}
-function getViewScriptTags() {
-  return compilerOptions.viewScriptTags;
-}
 function storePathInfo(workPath) {
   pathInfo.workPath = workPath;
   if (process_default.env.TARGET_PATH) {
@@ -15254,7 +15196,7 @@ function getPages() {
     subPages
   };
 }
-var import_node_path4, pathInfo, configInfo, npmResolver, DEFAULT_TEMPLATE_EXTS, DEFAULT_STYLE_EXTS, DEFAULT_VIEW_SCRIPT_EXTS, DEFAULT_VIEW_SCRIPT_TAGS, RESERVED_EXTS, compilerOptions;
+var import_node_path4, pathInfo, configInfo, npmResolver;
 var init_env = __esm({
   "../../dimina/fe/packages/compiler/src/env.js"() {
     init_fs();
@@ -15267,19 +15209,6 @@ var init_env = __esm({
     pathInfo = {};
     configInfo = {};
     npmResolver = null;
-    DEFAULT_TEMPLATE_EXTS = [".wxml", ".ddml"];
-    DEFAULT_STYLE_EXTS = [".wxss", ".ddss", ".less", ".scss", ".sass"];
-    DEFAULT_VIEW_SCRIPT_EXTS = [".wxs"];
-    DEFAULT_VIEW_SCRIPT_TAGS = ["wxs", "dds"];
-    RESERVED_EXTS = /* @__PURE__ */ new Set([
-      ...DEFAULT_TEMPLATE_EXTS,
-      ...DEFAULT_STYLE_EXTS,
-      ...DEFAULT_VIEW_SCRIPT_EXTS,
-      ".js",
-      ".ts",
-      ".json"
-    ]);
-    compilerOptions = normalizeFileTypes();
   }
 });
 
@@ -18693,7 +18622,7 @@ function warnUnsupportedWxApi(apiName, filePath, line) {
 }
 function warnUnsupportedComponent(tagName, filePath, line) {
   const { supportedBuiltinComponents: supportedBuiltinComponents2 } = loadReference();
-  if (!tagName || supportedBuiltinComponents2.has(tagName) || getViewScriptTags().includes(tagName)) {
+  if (!tagName || supportedBuiltinComponents2.has(tagName)) {
     return;
   }
   const location = formatLocation(filePath, line);
@@ -18754,7 +18683,6 @@ var cachedReference, warnedItems;
 var init_compatibility = __esm({
   "../../dimina/fe/packages/compiler/src/common/compatibility.js"() {
     init_dist3();
-    init_env();
     init_compatibility_reference();
     cachedReference = null;
     warnedItems = /* @__PURE__ */ new Set();
@@ -45121,7 +45049,7 @@ function doCompileTemplate({
   ssrCssVars,
   isProd = false,
   compiler,
-  compilerOptions: compilerOptions2 = {},
+  compilerOptions = {},
   transformAssetUrls
 }) {
   const errors2 = [];
@@ -45155,7 +45083,7 @@ function doCompileTemplate({
   if (inAST == null ? void 0 : inAST.transformed) {
     const newAST = (ssr ? CompilerDOM : compiler).parse(inAST.source, __spreadProps$5(__spreadValues$6({
       prefixIdentifiers: true
-    }, compilerOptions2), {
+    }, compilerOptions), {
       parseMode: "sfc",
       onError: (e) => errors2.push(e)
     }));
@@ -45173,9 +45101,9 @@ function doCompileTemplate({
     scopeId: scoped ? longId : void 0,
     slotted,
     sourceMap: true
-  }, compilerOptions2), {
+  }, compilerOptions), {
     hmr: !isProd,
-    nodeTransforms: nodeTransforms.concat(compilerOptions2.nodeTransforms || []),
+    nodeTransforms: nodeTransforms.concat(compilerOptions.nodeTransforms || []),
     filename,
     onError: (e) => errors2.push(e),
     onWarn: (w) => warnings.push(w)
@@ -76947,8 +76875,6 @@ __export(view_compiler_exports, {
   compileML: () => compileML,
   generateSlotDirective: () => generateSlotDirective,
   generateVModelTemplate: () => generateVModelTemplate,
-  initWxsFilePathMap: () => initWxsFilePathMap,
-  loadWxsModule: () => loadWxsModule,
   parseBraceExp: () => parseBraceExp,
   parseClassRules: () => parseClassRules,
   parseKeyExpression: () => parseKeyExpression,
@@ -76957,13 +76883,6 @@ __export(view_compiler_exports, {
   processWxsContent: () => processWxsContent,
   splitWithBraces: () => splitWithBraces
 });
-function buildExtStripRegex(exts) {
-  const alt = exts.map((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
-  return new RegExp(`(${alt})$`);
-}
-function stripViewScriptExt(p) {
-  return p.replace(buildExtStripRegex(getViewScriptExts()), "");
-}
 function parseJs(code, filename = "view-compiler.js", sourceType = "module") {
   return parseSync(filename, code, {
     sourceType,
@@ -77129,8 +77048,8 @@ function scanWxsFiles(dir, workPath) {
       const stat2 = fs_default.statSync(fullPath);
       if (stat2.isDirectory()) {
         scanWxsFiles(fullPath, workPath);
-      } else if (stat2.isFile() && getViewScriptExts().some((ext) => item.endsWith(ext))) {
-        const relativePath = stripViewScriptExt(fullPath.replace(workPath, ""));
+      } else if (stat2.isFile() && item.endsWith(".wxs")) {
+        const relativePath = fullPath.replace(workPath, "").replace(/\.wxs$/, "");
         const moduleName = relativePath.replace(/[\/\\@\-]/g, "_").replace(/^_/, "");
         wxsFilePathMap.set(moduleName, fullPath);
       }
@@ -77360,7 +77279,7 @@ function processWxsContent(wxsContent, wxsFilePath, scriptModule, workPath, file
             if (filePath && filePath.includes("/miniprogram_npm/")) {
               const currentWxsDir = import_node_path8.default.dirname(wxsFilePath);
               resolvedWxsPath = import_node_path8.default.resolve(currentWxsDir, requirePath);
-              const relativePath = stripViewScriptExt(resolvedWxsPath.replace(workPath, ""));
+              const relativePath = resolvedWxsPath.replace(workPath, "").replace(/\.wxs$/, "");
               const moduleName = relativePath.replace(/[\/\\@\-]/g, "_").replace(/^_/, "");
               processWxsDependency(resolvedWxsPath, moduleName, scriptModule, workPath, filePath);
               replacements.push({
@@ -77371,7 +77290,7 @@ function processWxsContent(wxsContent, wxsFilePath, scriptModule, workPath, file
             } else {
               const currentWxsDir = import_node_path8.default.dirname(wxsFilePath);
               resolvedWxsPath = import_node_path8.default.resolve(currentWxsDir, requirePath);
-              const relativePath = stripViewScriptExt(resolvedWxsPath.replace(workPath, ""));
+              const relativePath = resolvedWxsPath.replace(workPath, "").replace(/\.wxs$/, "");
               const depModuleName = relativePath.replace(/[\/\\@\-]/g, "_").replace(/^_/, "");
               processWxsDependency(resolvedWxsPath, depModuleName, scriptModule, workPath, filePath);
               replacements.push({
@@ -77587,7 +77506,7 @@ function toCompileTemplate(isComponent2, path10, components, componentPlaceholde
     const src = $2(elem).attr("src");
     if (src) {
       const includeFullPath = getAbsolutePath(workPath, path10, src);
-      let includePath = includeFullPath.replace(workPath, "").replace(buildExtStripRegex(getTemplateExts()), "");
+      let includePath = includeFullPath.replace(workPath, "").replace(/\.(wxml|ddml)$/, "");
       const includeDiagnosticSource = includeFullPath.startsWith(workPath) ? includeFullPath.slice(workPath.length) : includePath;
       if (!includePath.startsWith("/")) {
         includePath = "/" + includePath;
@@ -77613,7 +77532,8 @@ function toCompileTemplate(isComponent2, path10, components, componentPlaceholde
         );
         processIncludedFileWxsDependencies(includeContent, includePath, scriptModule, components, processedPaths);
         $includeContent("template").remove();
-        $includeContent(getViewScriptTags().join(",")).remove();
+        $includeContent("wxs").remove();
+        $includeContent("dds").remove();
         const processedContent = processIncludeConditionalAttrs($2, elem, $includeContent.html());
         $2(elem).replaceWith(processedContent);
       } else {
@@ -77630,7 +77550,7 @@ function toCompileTemplate(isComponent2, path10, components, componentPlaceholde
     const src = $2(elem).attr("src");
     if (src) {
       const importFullPath = getAbsolutePath(workPath, path10, src);
-      let importPath = importFullPath.replace(workPath, "").replace(buildExtStripRegex(getTemplateExts()), "");
+      let importPath = importFullPath.replace(workPath, "").replace(/\.(wxml|ddml)$/, "");
       const importDiagnosticSource = importFullPath.startsWith(workPath) ? importFullPath.slice(workPath.length) : importPath;
       if (!importPath.startsWith("/")) {
         importPath = "/" + importPath;
@@ -77677,7 +77597,8 @@ function transTagTemplate($2, templateModule, path10, components, componentPlace
     const templateContent = $2(elem);
     templateContent.find("import").remove();
     templateContent.find("include").remove();
-    templateContent.find(getViewScriptTags().join(",")).remove();
+    templateContent.find("wxs").remove();
+    templateContent.find("dds").remove();
     transAsses($2, templateContent.find("image"), path10);
     const res = [];
     transHtmlTag(templateContent.html(), res, components, componentPlaceholder);
@@ -77984,7 +77905,7 @@ function parseKeyExpression(exp, itemName = "item", indexName = "index") {
 }
 function getViewPath(workPath, src) {
   const aSrc = src.startsWith("/") ? src : `/${src}`;
-  for (const mlType of getTemplateExts()) {
+  for (const mlType of fileType) {
     const mlFullPath = `${workPath}${aSrc}${mlType}`;
     if (fs_default.existsSync(mlFullPath)) {
       return mlFullPath;
@@ -78090,7 +78011,10 @@ function parseTemplateDataExp(exp) {
   return `{${parseBraceExp(exp)}}`;
 }
 function transTagWxs($2, scriptModule, filePath) {
-  const wxsNodes = $2(getViewScriptTags().join(","));
+  let wxsNodes = $2("wxs");
+  if (wxsNodes.length === 0) {
+    wxsNodes = $2("dds");
+  }
   wxsNodes.each((_, elem) => {
     const smName = $2(elem).attr("module");
     if (smName) {
@@ -78109,7 +78033,7 @@ function transTagWxs($2, scriptModule, filePath) {
           wxsFilePath = getAbsolutePath(workPath, filePath, src);
         }
         if (wxsFilePath) {
-          const relativePath = stripViewScriptExt(wxsFilePath.replace(workPath, ""));
+          const relativePath = wxsFilePath.replace(workPath, "").replace(/\.wxs$/, "");
           uniqueModuleName = relativePath.replace(/[\/\\@\-]/g, "_").replace(/^_/, "");
           cacheKey = wxsFilePath;
         }
@@ -78182,8 +78106,12 @@ function collectAllWxsModules(scriptRes, collectedPaths = /* @__PURE__ */ new Se
   return allWxsModules;
 }
 function loadWxsModule(modulePath, workPath, scriptModule) {
+  if (!modulePath.startsWith("miniprogram_npm__") || !modulePath.includes("_wxs_")) {
+    return null;
+  }
   const wxsFilePath = wxsFilePathMap.get(modulePath);
   if (!wxsFilePath) {
+    console.warn(`[view] \u65E0\u6CD5\u627E\u5230 wxs \u6A21\u5757\u6587\u4EF6: ${modulePath}`);
     return null;
   }
   try {
@@ -78270,7 +78198,7 @@ function __resetViewState() {
   wxsModuleRegistry.clear();
   wxsFilePathMap.clear();
 }
-var import_node_path8, compileResCache, wxsModuleRegistry, wxsFilePathMap, braceRegex, noBraceRegex, ternaryRegex;
+var import_node_path8, fileType, compileResCache, wxsModuleRegistry, wxsFilePathMap, braceRegex, noBraceRegex, ternaryRegex;
 var init_view_compiler = __esm({
   "../../dimina/fe/packages/compiler/src/core/view-compiler.js"() {
     init_fs();
@@ -78287,6 +78215,7 @@ var init_view_compiler = __esm({
     init_utils();
     init_env();
     init_expression_parser();
+    fileType = [".wxml", ".ddml"];
     compileResCache = /* @__PURE__ */ new Map();
     wxsModuleRegistry = /* @__PURE__ */ new Set();
     wxsFilePathMap = /* @__PURE__ */ new Map();
@@ -291076,7 +291005,7 @@ function normalizeCssUrlValue(value, absolutePath) {
 function getAbsolutePath2(modulePath) {
   const workPath = getWorkPath();
   const src = modulePath.startsWith("/") ? modulePath : `/${modulePath}`;
-  for (const ssType of getStyleExts()) {
+  for (const ssType of fileType2) {
     const ssFullPath = `${workPath}${src}${ssType}`;
     if (fs_default.existsSync(ssFullPath)) {
       return ssFullPath;
@@ -291129,7 +291058,7 @@ function processHostSelector(selector2, moduleId) {
 function __resetStyleState() {
   compileRes.clear();
 }
-var import_node_path9, import_autoprefixer, import_cssnano, import_postcss_selector_parser, compileRes;
+var import_node_path9, import_autoprefixer, import_cssnano, import_postcss_selector_parser, fileType2, compileRes;
 var init_style_compiler = __esm({
   "../../dimina/fe/packages/compiler/src/core/style-compiler.js"() {
     init_fs();
@@ -291144,6 +291073,7 @@ var init_style_compiler = __esm({
     init_sass_default();
     init_utils();
     init_env();
+    fileType2 = [".wxss", ".ddss", ".less", ".scss", ".sass"];
     compileRes = /* @__PURE__ */ new Map();
     if (!isMainThread) {
       parentPort.on("message", async ({ pages, storeInfo: storeInfo2 }) => {
@@ -291242,7 +291172,6 @@ var config_compiler_default = compileConfig;
 // ../../dimina/fe/packages/compiler/src/common/npm-builder.js
 init_fs();
 var import_node_path6 = __toESM(require_path_browserify(), 1);
-init_env();
 var NpmBuilder = class {
   constructor(workPath, targetPath) {
     this.workPath = workPath;
@@ -291350,7 +291279,7 @@ var NpmBuilder = class {
    * @returns {boolean} 是否为小程序文件
    */
   isMiniprogramFile(filename) {
-    const miniprogramExts = [".js", ".json", ".ts", ...getTemplateExts(), ...getStyleExts(), ...getViewScriptExts()];
+    const miniprogramExts = [".js", ".json", ".wxml", ".wxss", ".wxs", ".ts", ".less", ".scss", ".styl"];
     const ext = import_node_path6.default.extname(filename).toLowerCase();
     return miniprogramExts.includes(ext) || filename === "package.json" || filename === "README.md" || filename.startsWith(".");
   }

package/dist/stage-worker.node.js

@@ -3,12 +3,12 @@ import {
   preloadStage,
   resetCompilerState,
   runStage
-} from "./pool.node-chunks/chunk-PDHO4Y56.js";
+} from "./pool.node-chunks/chunk-MHOA4NGC.js";
 import {
   getAppId,
   getAppName,
   resetStoreInfo
-} from "./pool.node-chunks/chunk-7FGOYOXU.js";
+} from "./pool.node-chunks/chunk-UYQ7D5I5.js";
 
 // src/stage-worker-node.js
 import { createRequire } from "node:module";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimina-kit/compiler",
-  "version": "0.0.1-dev.20260706064107",
+  "version": "0.0.1-dev.20260706125036",
   "description": "dmcc compiler bundles (browser + node) that drive @dimina/compiler against a caller-injected node:fs replacement (no bundled fs)",
   "license": "MIT",
   "type": "module",

package/scripts/test-pool-node.js

@@ -8,7 +8,7 @@
 // and require our pool to match dmcc only where dmcc matches itself. Assets (uuid-named)
 // are matched by CONTENT hash multiset instead of name. Sourcemap is asserted against
 // dmcc's own map (parity), since that is the format devtools already consumes.
-import { readdirSync, readFileSync, statSync, rmSync, mkdirSync } from 'node:fs'
+import { readdirSync, readFileSync, statSync, rmSync, mkdirSync, writeFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { createHash } from 'node:crypto'
 import path from 'node:path'
@@ -42,7 +42,12 @@ function readTree(root) {
 }
 
 const dmccBuild = (await import('../../../dimina/fe/packages/compiler/src/index.js')).default
-const { createNodeCompilerPool } = await import('../dist/pool.node.js')
+const poolNodeModule = await import('../dist/pool.node.js')
+const { createNodeCompilerPool } = poolNodeModule
+// Destructured lazily below (may be absent pre-fix): the default drop-in build(),
+// the pure oxc-native-binding-hint mapper, and the lazy-singleton disposer.
+const defaultBuild = poolNodeModule.default
+const { oxcNativeBindingHint, disposeDefaultPool } = poolNodeModule
 
 // --- reference: dmcc twice ------------------------------------------------
 console.log(`[ref] dmcc build ×2 (sourcemap) from ${APP}`)
@@ -113,5 +118,90 @@ checkAgainstDmcc(readTree(path.join(dir('ours1'), appInfo1.appId)), 'cold')
 checkAgainstDmcc(readTree(path.join(dir('ours2'), appInfo2.appId)), 'warm')
 
 console.log(`[sourcemap] logic.js.map: ${refMap.sources.length} sources, sourcesContent present, matches dmcc ✅`)
-console.log(failed ? '\n❌ FAIL' : '\n✅ PASS: resident Node pool is dmcc-equivalent (incl. sourcemap) on cold+warm builds')
+
+// --- failure contract: the default drop-in build() must REJECT a broken compile ------------------
+// (never resolve undefined and let the caller mistake a failed compile for success), and the pool
+// must expose a pure helper that turns a missing-oxc-native-binding message into an actionable
+// packaging hint (checked as a string mapping only — a real environment can't be made to lack the
+// binding on demand).
+console.log("[fail] broken fixture: default build() must reject, not resolve undefined")
+function writeBrokenFixture(root) {
+  const write = (rel, content) => {
+    const target = path.join(root, rel)
+    mkdirSync(path.dirname(target), { recursive: true })
+    writeFileSync(target, content)
+  }
+  write('project.config.json', JSON.stringify({ appid: 'fixture_app_broken', projectname: 'fixture-broken' }))
+  write('app.json', JSON.stringify({ pages: ['pages/index/index'] }))
+  write('app.js', 'App({})\n')
+  write('app.wxss', 'page { font-size: 14px; }\n')
+  write('pages/index/index.json', '{}\n')
+  // Unbalanced brace + bad tokens — same corruption shape used by devkit's
+  // open-project-compile-log fixture, chosen because it fails the logic stage
+  // rather than being silently absorbed by esbuild's error-tolerant fallback.
+  write('pages/index/index.js', 'Page({ data: { msg: "hi" } })\nconst broken = {{{ ;;; <<<\n')
+  write('pages/index/index.wxml', '<view>{{msg}}</view>\n')
+  write('pages/index/index.wxss', '.x { color: red; }\n')
+}
+const brokenRoot = dir('broken-fixture')
+mkdirSync(brokenRoot, { recursive: true })
+writeBrokenFixture(brokenRoot)
+
+if (typeof defaultBuild !== 'function') {
+  fail('pool.node.js must have a default export `build(outputDir, workPath, useAppIdDir?, options?)` — default export is missing/not a function')
+}
+else {
+  let brokenResolvedValue
+  let brokenRejectedError
+  try {
+    brokenResolvedValue = await defaultBuild(dir('broken-out'), brokenRoot, true, {})
+  }
+  catch (e) {
+    brokenRejectedError = e
+  }
+  if (brokenRejectedError === undefined) {
+    fail(`default build() must REJECT on a broken compile — instead it resolved to ${JSON.stringify(brokenResolvedValue)} (a swallowed error looks like success to every caller)`)
+  }
+  else if (!(brokenRejectedError instanceof Error) || !brokenRejectedError.message) {
+    fail(`default build() rejected but without a usable Error message: ${brokenRejectedError}`)
+  }
+  else if (!/stage "logic" failed/.test(brokenRejectedError.message)) {
+    fail(`default build() rejection message must name the failing stage, got: ${brokenRejectedError.message.split('\n')[0]}`)
+  }
+  else if (!/Transform failed/.test(brokenRejectedError.message)) {
+    fail(`default build() rejection message must carry the underlying compile reason (esbuild transform failure), got: ${brokenRejectedError.message.split('\n')[0]}`)
+  }
+  else {
+    console.log(`[fail] ✅ default build() rejected with: ${brokenRejectedError.message.split('\n')[0]}`)
+  }
+}
+
+// --- oxcNativeBindingHint: pure message -> actionable-packaging-hint mapper -----------------------
+if (typeof oxcNativeBindingHint !== 'function') {
+  fail('pool.node.js must export a named `oxcNativeBindingHint(message)` helper — export is missing')
+}
+else {
+  const hint = oxcNativeBindingHint('Cannot find native binding. It means oxc-parser was not installed correctly for this platform.')
+  if (typeof hint !== 'string' || !hint.includes('@oxc-parser/binding-') || !hint.includes('wasm32-wasi')) {
+    fail(`oxcNativeBindingHint must mention both the native platform binding package (@oxc-parser/binding-*) and the wasm32-wasi fallback, got: ${JSON.stringify(hint)}`)
+  }
+  else {
+    console.log('[fail] ✅ oxcNativeBindingHint surfaces a packaging fix for a missing native binding')
+  }
+  const noHint = oxcNativeBindingHint('some unrelated compile error')
+  if (noHint !== null) {
+    fail(`oxcNativeBindingHint must return null for a message that is not the native-binding failure, got: ${JSON.stringify(noHint)}`)
+  }
+}
+
+// The default export is a lazy module-level singleton pool (resident worker threads) — the
+// broken-fixture build above spun it up, so the process cannot exit cleanly without disposing it.
+if (typeof disposeDefaultPool !== 'function') {
+  fail('pool.node.js must export `disposeDefaultPool()` to tear down the lazy default-export singleton pool')
+}
+else {
+  await disposeDefaultPool()
+}
+
+console.log(failed ? '\n❌ FAIL' : '\n✅ PASS: resident Node pool is dmcc-equivalent (incl. sourcemap) on cold+warm builds, and rejects broken compiles')
 process.exit(failed ? 1 : 0)

package/src/pool-node.js

@@ -167,7 +167,9 @@ export function createNodeCompilerPool({
     for (const r of results) {
       if (!r || r.type === 'error') {
         const info = r && r.error
-        const err = new Error(`[compiler] stage "${r && r.stage}" failed: ${(info && info.message) || 'unknown error'}`)
+        const cause = (info && info.message) || 'unknown error'
+        const hint = oxcNativeBindingHint(cause)
+        const err = new Error(`[compiler] stage "${r && r.stage}" failed: ${cause}${hint ? ` — ${hint}` : ''}`)
         if (info && info.stack) err.stack = info.stack
         err.stage = r && r.stage
         err.code = 'compiler-stage-error' // worker-reported compile error — never retried
@@ -232,19 +234,40 @@ export function createNodeCompilerPool({
 // user-facing compile-log lines a host (e.g. devkit/devtools' log panel) already scrapes.
 const STAGE_TITLES = { logic: '编译页面逻辑', view: '编译页面文件', style: '编译样式文件' }
 
+/**
+ * Map a failure message to an actionable packaging hint when it is oxc-parser's
+ * "missing runtime binding" error (thrown when NEITHER the platform-native
+ * `@oxc-parser/binding-<platform>` package NOR the `@oxc-parser/binding-wasm32-wasi`
+ * fallback resolves at runtime). Neither package is a direct dependency of a
+ * typical host, so app bundlers (e.g. electron-builder's dependency collection)
+ * silently drop them — and the raw oxc message says nothing about packaging.
+ * Returns null for every other message.
+ * @param {string} message
+ * @returns {string | null}
+ */
+export function oxcNativeBindingHint(message) {
+  if (!/Cannot find native binding/i.test(String(message))) return null
+  return 'oxc-parser 的运行时绑定没有被打进宿主应用：@dimina-kit/compiler 的 Node 编译路径需要 '
+    + `@oxc-parser/binding-${process.platform}-${process.arch}（平台原生绑定）或 `
+    + '@oxc-parser/binding-wasm32-wasi（wasm 兜底）二者之一实际存在于包内。'
+    + '打包分发（如 electron-builder）时请把其中一个显式声明为宿主依赖，避免依赖收集时被丢弃'
+}
+
 // Lazy singleton pool — a DROP-IN replacement for dmcc's `build(targetPath, workPath,
-// useAppIdDir, options)`, matching its behavior on BOTH the happy and error paths so a
-// host that consumed dmcc keeps working unchanged:
+// useAppIdDir, options)` with ONE deliberate divergence on the error path:
 //   • the first call spins up the resident workers; every later call (a watch rebuild)
 //     reuses them warm;
 //   • on success it emits `✔ 输出编译产物` on stdout (dmcc's listr2 completion line — the
 //     pool has no listr2, so the equivalent user-facing line is surfaced here);
-//   • on failure it reports the failing stage + summary on stderr and RESOLVES undefined
-//     (never rethrows), exactly like dmcc's build() catch (index.js) — the host normalizes
-//     undefined to a null appInfo and the error detail (incl. dmcc's own
-//     `[logic] esbuild 转换失败 …`) still reaches the log channel.
-// Callers that want structured throwing errors + explicit teardown should use
-// createNodeCompilerPool() directly instead.
+//   • on failure it reports the failing stage + summary on stderr (same lines a dmcc
+//     host already scrapes: `✖ <stage>` + `<workPath> 编译出错: …`) and then REJECTS
+//     with the error. dmcc's own build() swallows the error and resolves undefined,
+//     which makes a failed compile indistinguishable from benign "no app info" — a
+//     host would start a session that can only 404. Rejecting keeps the log surface
+//     identical while giving callers a real failure signal; a resolved null/undefined
+//     no longer means "compile failed", only "no app info to report".
+// Callers that want structured errors (`.stage`/`.code`) + explicit teardown should
+// use createNodeCompilerPool() directly instead.
 let singleton = null
 export default async function build(outputDir, workPath, useAppIdDir = true, options = {}) {
   if (!singleton) singleton = createNodeCompilerPool()
@@ -255,7 +278,7 @@ export default async function build(outputDir, workPath, useAppIdDir = true, opt
   } catch (e) {
     if (e && e.stage) console.error(`✖ ${STAGE_TITLES[e.stage] || e.stage}`)
     console.error(`${workPath} 编译出错: ${e && e.message}`)
-    return undefined
+    throw e
   }
 }