@zntc/core 0.1.1 → 0.1.3

package/dist/index.js

@@ -818,7 +818,7 @@ var require_node = __commonJS((exports, module) => {
 // index.ts
 import { createRequire as createRequire3 } from "module";
 import { existsSync as existsSync3, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
-import { join as join3, dirname as dirname3, resolve as resolve2 } from "path";
+import { join as join4, dirname as dirname3, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
 // src/platforms.ts
@@ -935,7 +935,10 @@ var FEATURES = [
   "regex_sticky",
   "regex_dotall",
   "regex_named_groups",
-  "unicode_brace_escape"
+  "unicode_brace_escape",
+  "regex_duplicate_named_groups",
+  "regex_modifiers",
+  "regex_lookbehind"
 ];
 var SUPPORT = {
   arrow: {
@@ -1146,7 +1149,34 @@ var SUPPORT = {
     ios: [13, 4],
     hermes: [0, 7]
   },
-  using: {}
+  using: {},
+  regex_duplicate_named_groups: {
+    chrome: [125, 0],
+    edge: [125, 0],
+    firefox: [129, 0],
+    safari: [17, 4],
+    ios: [17, 4],
+    node: [23, 0],
+    deno: [1, 44]
+  },
+  regex_modifiers: {
+    chrome: [125, 0],
+    edge: [125, 0],
+    firefox: [132, 0],
+    safari: [26, 0],
+    ios: [26, 0],
+    node: [23, 0],
+    deno: [1, 44]
+  },
+  regex_lookbehind: {
+    chrome: [62, 0],
+    edge: [79, 0],
+    firefox: [78, 0],
+    safari: [16, 4],
+    ios: [16, 4],
+    node: [8, 10],
+    deno: [1, 0]
+  }
 };
 function verGte(a, b) {
   if (a[0] !== b[0])
@@ -1177,17 +1207,17 @@ function computeUnsupportedFromEngines(engines) {
 }
 // ../shared/index.ts
 var ES_TARGET_BITS = {
-  es5: 268435455,
-  es2015: 117438464,
-  es2016: 117436416,
-  es2017: 117432320,
-  es2018: 16760832,
-  es2019: 16744448,
-  es2020: 16646144,
-  es2021: 16515072,
-  es2022: 12582912,
-  es2023: 8388608,
-  es2024: 8388608,
+  es5: 2147483647,
+  es2015: 1996486656,
+  es2016: 1996484608,
+  es2017: 1996480512,
+  es2018: 822067200,
+  es2019: 822050816,
+  es2020: 821952512,
+  es2021: 821821440,
+  es2022: 817889280,
+  es2023: 813694976,
+  es2024: 813694976,
   es2025: 0,
   esnext: 0
 };
@@ -1928,7 +1958,7 @@ async function loadModuleDefault(absPath, kind, options) {
   const allowArray = options?.allowArray === true;
   const ext = extname(absPath).toLowerCase();
   if (ext === ".json") {
-    const raw = readFileOrThrowNotFound(absPath);
+    const raw = readFileOrThrowNotFound(absPath, kind);
     try {
       return JSON.parse(raw);
     } catch (err) {
@@ -1953,7 +1983,7 @@ async function loadModuleDefault(absPath, kind, options) {
 }
 async function loadTsModule(absPath, kind, allowArray) {
   init();
-  const source = readFileOrThrowNotFound(absPath);
+  const source = readFileOrThrowNotFound(absPath, kind);
   const parseFilename = absPath.endsWith(".cts") ? absPath.slice(0, -4) + ".ts" : absPath;
   const result = transpile(source, {
     filename: parseFilename,
@@ -2000,12 +2030,12 @@ async function importAndResolveDefault(absPath, options) {
   }
   return value;
 }
-function readFileOrThrowNotFound(absPath) {
+function readFileOrThrowNotFound(absPath, kind) {
   try {
     return readFileSync2(absPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
-      throw new Error(`@zntc/core: config file not found: ${absPath}`);
+      throw new Error(`@zntc/core: ${kind} file not found: ${absPath}`);
     }
     throw err;
   }
@@ -2061,7 +2091,7 @@ function mergeUserConfigs(base, mode) {
   return merged;
 }
 // src/load-env.ts
-import { resolve as pathResolve2 } from "node:path";
+import { join as join2, resolve as pathResolve2 } from "node:path";
 function parseDotenvLine(line) {
   const trimmed = line.trim();
   if (!trimmed || trimmed.startsWith("#"))
@@ -2099,7 +2129,7 @@ function loadEnv(mode, envDir, prefixes = ["VITE_", "ZNTC_"]) {
   const files = [`.env`, `.env.local`, `.env.${mode}`, `.env.${mode}.local`];
   const merged = {};
   for (const file of files) {
-    Object.assign(merged, parseDotenvFile(`${dir}/${file}`));
+    Object.assign(merged, parseDotenvFile(join2(dir, file)));
   }
   const filtered = {};
   for (const [key, value] of Object.entries(merged)) {
@@ -2183,12 +2213,16 @@ function warnUnknownKeys(config, known, options = {}) {
 }
 var KNOWN_CONFIG_KEYS = [
   "entryPoints",
+  "output",
   "outdir",
   "outfile",
   "outbase",
   "format",
   "platform",
   "target",
+  "rnVersion",
+  "diskCache",
+  "cacheDir",
   "browserslist",
   "runtimePolyfills",
   "coreJs",
@@ -2210,6 +2244,7 @@ var KNOWN_CONFIG_KEYS = [
   "sourceRoot",
   "external",
   "alias",
+  "aliasExact",
   "define",
   "server",
   "loader",
@@ -2247,6 +2282,8 @@ var KNOWN_CONFIG_KEYS = [
   "entryNames",
   "chunkNames",
   "assetNames",
+  "assetInlineLimit",
+  "cssNames",
   "experimentalDecorators",
   "emitDecoratorMetadata",
   "useDefineForClassFields",
@@ -2275,6 +2312,9 @@ var KNOWN_CONFIG_KEYS = [
   "watchDelay",
   "jobs",
   "codegenTransform",
+  "lazyCompilation",
+  "lazyForceParse",
+  "preserveSafePlugins",
   "extends",
   "root",
   "projectRoot",
@@ -2290,7 +2330,7 @@ var KNOWN_CONFIG_KEYS = [
 ];
 // src/workspace.ts
 import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
-import { basename, join as join2, resolve as pathResolve3 } from "node:path";
+import { basename, join as join3, resolve as pathResolve3 } from "node:path";
 var CONFIG_EXT_PRIORITY_LOCAL = [".ts", ".mts", ".cts", ".mjs", ".js", ".cjs", ".json"];
 function defineWorkspace(input) {
   return input;
@@ -2298,7 +2338,7 @@ function defineWorkspace(input) {
 var WORKSPACE_EXT_PRIORITY = CONFIG_EXT_PRIORITY_LOCAL;
 function findWorkspacePath(cwd) {
   for (const ext of WORKSPACE_EXT_PRIORITY) {
-    const p = join2(cwd, `zntc.workspace${ext}`);
+    const p = join3(cwd, `zntc.workspace${ext}`);
     if (existsSync2(p))
       return p;
   }
@@ -2334,9 +2374,10 @@ function identifyWorkspaceEntries(entries, rootDir) {
   const seen = new Set;
   const out = [];
   const push = (w) => {
-    if (seen.has(w.cwd))
+    const key = w.source === "inline" ? `inline:${w.name}` : w.cwd;
+    if (seen.has(key))
       return;
-    seen.add(w.cwd);
+    seen.add(key);
     out.push(w);
   };
   for (const entry of entries) {
@@ -2399,7 +2440,7 @@ function enumerateDirs(baseDir, namePattern) {
     if (d.name === "node_modules")
       continue;
     if (matcher(d.name))
-      out.push(join2(baseDir, d.name));
+      out.push(join3(baseDir, d.name));
   }
   out.sort();
   return out;
@@ -2412,7 +2453,7 @@ function makeStarMatcher(pattern) {
   return (s) => re.test(s);
 }
 function detectPackageName(absDir) {
-  const pkgPath = join2(absDir, "package.json");
+  const pkgPath = join3(absDir, "package.json");
   if (existsSync2(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
@@ -2475,10 +2516,10 @@ function getPlatformPackage() {
 function findAddon() {
   const __dirname2 = dirname3(fileURLToPath(import.meta.url));
   const platformPkg = getPlatformPackage();
-  const zigOut = join3(__dirname2, "../../zig-out/lib/zntc.node");
+  const zigOut = join4(__dirname2, "../../zig-out/lib/zntc.node");
   if (existsSync3(zigOut))
     return zigOut;
-  const zigOut2 = join3(__dirname2, "../../../zig-out/lib/zntc.node");
+  const zigOut2 = join4(__dirname2, "../../../zig-out/lib/zntc.node");
   if (existsSync3(zigOut2))
     return zigOut2;
   if (platformPkg) {
@@ -2487,10 +2528,10 @@ function findAddon() {
       return nodeRequire.resolve(platformPkg);
     } catch {}
   }
-  const local = join3(__dirname2, "zntc.node");
+  const local = join4(__dirname2, "zntc.node");
   if (existsSync3(local))
     return local;
-  const parent = join3(__dirname2, "../zntc.node");
+  const parent = join4(__dirname2, "../zntc.node");
   if (existsSync3(parent))
     return parent;
   const expected = platformPkg ? ` (expected sub-package: ${platformPkg})` : "";
@@ -2555,15 +2596,15 @@ class TsconfigCache {
   }
 }
 function transpile(source, options = {}) {
-  if (!source)
-    throw new Error("@zntc/core: empty source");
+  if (typeof source !== "string")
+    throw new Error("@zntc/core: source must be a string");
   validateTsConfigRaw(options.tsconfigRaw);
   const optionsJson = buildOptionsJson(options, resolveUnsupported(options));
   return ensureNative().transpile(source, options.filename ?? "input.js", optionsJson, options.cache ? TsconfigCache._unwrap(options.cache) : undefined);
 }
 function tokenize(source, options = {}) {
-  if (!source)
-    throw new Error("@zntc/core: empty source");
+  if (typeof source !== "string")
+    throw new Error("@zntc/core: source must be a string");
   return ensureNative().tokenize(source, options.filename ?? "input.js");
 }
 function configureProfile(profile, level) {
@@ -2572,6 +2613,18 @@ function configureProfile(profile, level) {
 function profileReport(format = "table") {
   return ensureNative().profileReport(format);
 }
+function tlsSelfCheck(options) {
+  ensureNative().tlsSelfCheck(options);
+}
+function startDevServer(options) {
+  return ensureNative().startDevServer(options);
+}
+function stopDevServer(handle) {
+  ensureNative().stopDevServer(handle);
+}
+function getDevServerPort(handle) {
+  return ensureNative().getDevServerPort(handle);
+}
 function normalizePluginFailure(pluginName, hookName, thrown, fallbackFile) {
   let message = "Plugin hook failed";
   let file = fallbackFile ?? undefined;
@@ -2654,6 +2707,21 @@ function syncPluginPromiseFailure(pluginName, hookName, file) {
 function isPluginFailureResult(value) {
   return Boolean(value && typeof value === "object" && value.__zntcPluginFailure === true);
 }
+function deepMergeMeta(target, source) {
+  const out = { ...target };
+  for (const key of Object.keys(source)) {
+    const sv = source[key];
+    const tv = out[key];
+    const merged = sv != null && typeof sv === "object" && !Array.isArray(sv) && tv != null && typeof tv === "object" && !Array.isArray(tv) ? deepMergeMeta(tv, sv) : sv;
+    Object.defineProperty(out, key, {
+      value: merged,
+      writable: true,
+      enumerable: true,
+      configurable: true
+    });
+  }
+  return out;
+}
 function safeSerializeSourceMap(map) {
   try {
     return { ok: true, map: serializePluginSourceMap(map) };
@@ -2680,31 +2748,37 @@ function collectPluginRegistry(plugins) {
     buildEndCallbacks: [],
     closeBundleCallbacks: [],
     astFunctionHooks: [],
-    lifecycleFailures: []
+    lifecycleFailures: [],
+    pluginWarnings: [],
+    contexts: new Map
   };
   for (const plugin of plugins) {
     const build = {
       onResolve(opts, cb) {
         registry.hooks.resolveId.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onLoad(opts, cb) {
-        registry.hooks.load.push({ pluginName: plugin.name, filter: opts.filter, callback: cb });
+        registry.hooks.load.push({
+          pluginName: plugin.name,
+          filter: stripStatefulFilterFlags(opts.filter),
+          callback: cb
+        });
       },
       onTransform(opts, cb) {
         registry.hooks.transform.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onRenderChunk(opts, cb) {
         registry.hooks.renderChunk.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
@@ -2723,14 +2797,14 @@ function collectPluginRegistry(plugins) {
       onAstFunction(opts, cb) {
         registry.astFunctionHooks.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       },
       onResolveContext(opts, cb) {
         registry.hooks.resolveContext.push({
           pluginName: plugin.name,
-          filter: opts.filter,
+          filter: stripStatefulFilterFlags(opts.filter),
           callback: cb
         });
       }
@@ -2772,7 +2846,25 @@ function lifecycleHookSpec(reg, hookName, arg1) {
       return null;
   }
 }
-function* dispatchHook(reg, hookName, arg1, arg2) {
+function getPluginContext(reg, pluginName, getModuleInfo, resolve3, emitFile, getFileName) {
+  let ctx = reg.contexts.get(pluginName);
+  if (!ctx) {
+    ctx = createRollupPluginContext(pluginName, (d) => reg.pluginWarnings.push(d));
+    reg.contexts.set(pluginName, ctx);
+  }
+  const slot = ctx;
+  slot.__getModuleInfo = getModuleInfo;
+  slot.__resolve = resolve3;
+  slot.__emitFile = emitFile;
+  slot.__getFileName = getFileName;
+  return ctx;
+}
+function stripStatefulFilterFlags(re) {
+  if (!re.global && !re.sticky)
+    return re;
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, ""));
+}
+function* dispatchHook(reg, hookName, arg1, arg2, getModuleInfo, resolve3, emitFile, getFileName) {
   if (hookName === "astFunction") {
     if (reg.astFunctionHooks.length === 0)
       return null;
@@ -2786,7 +2878,7 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
       if (!h.filter.test(info.sourcePath))
         continue;
       const result = yield {
-        callback: () => h.callback(info),
+        callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve3, emitFile, getFileName), info),
         pluginName: h.pluginName,
         hookName: "astFunction",
         fallbackFile: info.sourcePath
@@ -2811,7 +2903,7 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
       if (!h.filter.test(args.dir))
         continue;
       const result = yield {
-        callback: () => h.callback(args),
+        callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve3, emitFile, getFileName), args),
         pluginName: h.pluginName,
         hookName: "resolveContext",
         fallbackFile: args.importer
@@ -2829,7 +2921,7 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
       let firstFailure = null;
       for (const { pluginName, callback } of spec.callbacks) {
         const result = yield {
-          callback: () => callback(spec.arg),
+          callback: () => callback.call(getPluginContext(reg, pluginName, getModuleInfo, resolve3, emitFile, getFileName), spec.arg),
           pluginName,
           hookName
         };
@@ -2851,12 +2943,13 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
     let currentCode = arg1;
     let changed = false;
     const sourceMaps = [];
+    let mergedMeta;
     for (const h of hookList2) {
       if (!h.filter.test(arg2 ?? ""))
         continue;
       const cbArgs2 = hookName === "transform" ? { code: currentCode, path: arg2 } : { code: currentCode, chunk: arg2 };
       const result = yield {
-        callback: () => h.callback(cbArgs2),
+        callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve3, emitFile, getFileName), cbArgs2),
         pluginName: h.pluginName,
         hookName,
         fallbackFile: arg2
@@ -2877,9 +2970,26 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
           if (r.map != null)
             sourceMaps.push(r.map);
         }
+        if (hookName === "transform" && typeof result === "object" && obj.meta != null) {
+          if (typeof obj.meta !== "object") {} else {
+            mergedMeta = mergedMeta === undefined ? { ...obj.meta } : deepMergeMeta(mergedMeta, obj.meta);
+          }
+        }
+      }
+    }
+    let metaJson;
+    if (mergedMeta !== undefined) {
+      try {
+        metaJson = JSON.stringify(mergedMeta);
+      } catch (err) {
+        return normalizePluginFailure("transform-chain", hookName, err, arg2);
       }
     }
-    return changed ? { code: currentCode, ...sourceMaps.length > 0 ? { maps: sourceMaps } : {} } : null;
+    return changed || metaJson !== undefined ? {
+      ...changed ? { code: currentCode } : {},
+      ...sourceMaps.length > 0 ? { maps: sourceMaps } : {},
+      ...metaJson !== undefined ? { meta: metaJson } : {}
+    } : null;
   }
   const hookList = reg.hooks[hookName];
   if (!hookList)
@@ -2893,7 +3003,7 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
       continue;
     const fallbackFile = hookName === "resolveId" ? arg2 : filterTarget;
     const result = yield {
-      callback: () => h.callback(cbArgs),
+      callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve3, emitFile, getFileName), cbArgs),
       pluginName: h.pluginName,
       hookName,
       fallbackFile
@@ -2901,13 +3011,27 @@ function* dispatchHook(reg, hookName, arg1, arg2) {
     if (isPluginFailureResult(result))
       return result;
     if (result != null) {
-      if (hookName === "load" && typeof result === "object" && "map" in result) {
-        const r = safeSerializeSourceMap(result.map);
+      let withMeta = result;
+      const rawMeta = typeof result === "object" && result !== null ? result.meta : undefined;
+      if (rawMeta != null && typeof rawMeta === "object") {
+        let metaJson;
+        try {
+          metaJson = JSON.stringify(rawMeta);
+        } catch (err) {
+          return normalizePluginFailure(h.pluginName, hookName, err, fallbackFile);
+        }
+        withMeta = { ...result, meta: metaJson };
+      }
+      if (hookName === "load" && typeof withMeta === "object" && "map" in withMeta) {
+        const r = safeSerializeSourceMap(withMeta.map);
         if (!r.ok)
           return normalizePluginFailure(h.pluginName, hookName, r.err, fallbackFile);
-        return { ...result, ...r.map != null ? { map: r.map } : { map: undefined } };
+        return {
+          ...withMeta,
+          ...r.map != null ? { map: r.map } : { map: undefined }
+        };
       }
-      return result;
+      return withMeta;
     }
   }
   return null;
@@ -2948,10 +3072,11 @@ function driveDispatchSync(gen) {
 }
 function createPluginDispatcher(plugins) {
   const reg = collectPluginRegistry(plugins);
-  const dispatcher = function dispatcher2(hookName, arg1, arg2) {
-    return driveDispatchAsync(dispatchHook(reg, hookName, arg1, arg2));
+  const dispatcher = function dispatcher2(hookName, arg1, arg2, getModuleInfo, resolve3, emitFile, getFileName) {
+    return driveDispatchAsync(dispatchHook(reg, hookName, arg1, arg2, getModuleInfo, resolve3, emitFile, getFileName));
   };
   dispatcher.takeLifecycleFailures = () => reg.lifecycleFailures.splice(0);
+  dispatcher.takePluginWarnings = () => reg.pluginWarnings.splice(0);
   return dispatcher;
 }
 function createSyncPluginDispatcher(plugins) {
@@ -2960,6 +3085,7 @@ function createSyncPluginDispatcher(plugins) {
     return driveDispatchSync(dispatchHook(reg, hookName, arg1, arg2));
   };
   dispatcher.takeLifecycleFailures = () => reg.lifecycleFailures.splice(0);
+  dispatcher.takePluginWarnings = () => reg.pluginWarnings.splice(0);
   return dispatcher;
 }
 function arrayAliasToPlugin(aliasArray) {
@@ -3003,6 +3129,11 @@ function withDefaultBuildDefines(options) {
   }
   return Object.keys(define).length > 0 ? define : undefined;
 }
+function warnIfWatchOnlyOption(options, fnName) {
+  if (options.skipInitialOutput) {
+    console.warn(`@zntc/core: ${fnName}() does not honor skipInitialOutput (watch()-only option). It is silently ignored. If you meant to use this with a separate build, call watch() instead.`);
+  }
+}
 function withDefaultAppBuildDefines(options) {
   const define = { ...options.define };
   if (define["process.env.NODE_ENV"] === undefined) {
@@ -3012,6 +3143,15 @@ function withDefaultAppBuildDefines(options) {
 }
 function prepareNapiOptions(options) {
   const napiOptions = { ...options };
+  if (typeof options.rnVersion === "string") {
+    const m = /^[ \t]*(?:>=|<=|==|>|<)?[ \t]*(\d+)\.(\d+)(?:\.\d+)*[ \t]*$/.exec(options.rnVersion);
+    if (!m || Number(m[1]) > 65535 || Number(m[2]) > 65535) {
+      throw new Error(`Invalid rnVersion '${options.rnVersion}' (expected e.g. '0.74', '>=0.74', '<=0.84', '==0.76')`);
+    }
+    if (options.platform === "node" || options.platform === "neutral") {
+      throw new Error(`rnVersion conflicts with platform: '${options.platform}' (rnVersion implies react-native)`);
+    }
+  }
   const define = withDefaultBuildDefines(options);
   if (define)
     napiOptions.define = define;
@@ -3153,6 +3293,16 @@ function postProcessCssOutputs(result, options) {
     } catch {}
   }
 }
+function resolveOutputPath(filePath, opts) {
+  const { outfileResolved, outdir } = opts;
+  if (outfileResolved && filePath === "bundle.js")
+    return outfileResolved;
+  if (outfileResolved && filePath === "bundle.js.map")
+    return `${outfileResolved}.map`;
+  if (outdir)
+    return join4(resolve2(outdir), filePath);
+  return resolve2(filePath);
+}
 function writeOutputFiles(result, options) {
   const shouldWrite = options.write ?? (options.outdir != null || options.outfile != null);
   if (!shouldWrite)
@@ -3168,16 +3318,7 @@ function writeOutputFiles(result, options) {
   const createdDirs = new Set;
   const outfileResolved = options.outfile ? resolve2(options.outfile) : null;
   for (const file of result.outputFiles) {
-    let outPath;
-    if (outfileResolved && file.path === "bundle.js") {
-      outPath = outfileResolved;
-    } else if (outfileResolved && file.path.endsWith(".map")) {
-      outPath = outfileResolved + ".map";
-    } else if (options.outdir) {
-      outPath = join3(resolve2(options.outdir), file.path);
-    } else {
-      outPath = resolve2(file.path);
-    }
+    const outPath = resolveOutputPath(file.path, { outfileResolved, outdir: options.outdir });
     const dir = dirname3(outPath);
     if (!createdDirs.has(dir)) {
       mkdirSync(dir, { recursive: true });
@@ -3191,6 +3332,7 @@ async function build(options) {
   if (!options.entryPoints?.length)
     throw new Error("@zntc/core: entryPoints is required");
   validateTsConfigRaw(options.tsconfigRaw);
+  warnIfWatchOnlyOption(options, "build");
   if (options.output && options.output.length >= 2) {
     return buildMultiFormat(options);
   }
@@ -3204,6 +3346,9 @@ async function build(options) {
       for (const failure of dispatcher.takeLifecycleFailures()) {
         result.errors.push(pluginFailureToDiagnostic(failure));
       }
+      for (const warning of dispatcher.takePluginWarnings()) {
+        result.warnings.push(warning);
+      }
     }
     postProcessCssOutputs(result, options);
     writeOutputFiles(result, options);
@@ -3212,6 +3357,9 @@ async function build(options) {
       for (const failure of dispatcher.takeLifecycleFailures()) {
         result.errors.push(pluginFailureToDiagnostic(failure));
       }
+      for (const warning of dispatcher.takePluginWarnings()) {
+        result.warnings.push(warning);
+      }
     }
     return result;
   } finally {
@@ -3223,6 +3371,7 @@ function buildSync(options) {
   if (!options.entryPoints?.length)
     throw new Error("@zntc/core: entryPoints is required");
   validateTsConfigRaw(options.tsconfigRaw);
+  warnIfWatchOnlyOption(options, "buildSync");
   const { napiOptions, cleanup } = prepareNapiOptions(options);
   const dispatcher = resolveDispatcher(options, "sync");
   if (dispatcher)
@@ -3233,6 +3382,9 @@ function buildSync(options) {
       for (const failure of dispatcher.takeLifecycleFailures()) {
         result.errors.push(pluginFailureToDiagnostic(failure));
       }
+      for (const warning of dispatcher.takePluginWarnings()) {
+        result.warnings.push(warning);
+      }
     }
     postProcessCssOutputs(result, options);
     writeOutputFiles(result, options);
@@ -3241,6 +3393,9 @@ function buildSync(options) {
       for (const failure of dispatcher.takeLifecycleFailures()) {
         result.errors.push(pluginFailureToDiagnostic(failure));
       }
+      for (const warning of dispatcher.takePluginWarnings()) {
+        result.warnings.push(warning);
+      }
     }
     return result;
   } finally {
@@ -3316,13 +3471,33 @@ async function buildMultiFormat(options) {
 }
 function buildAppSync(options = {}) {
   const n = ensureNative();
-  const { publicDir, compiler, ...rest } = options;
-  return wrapOutputFiles(n.buildAppSync({
+  const { publicDir, compiler, plugins: _plugins, ...rest } = options;
+  const dispatcher = resolveDispatcher(options, "sync");
+  const napiOptions = {
     ...rest,
     define: withDefaultAppBuildDefines(options),
     ...publicDir === false ? { disablePublicDir: true } : publicDir !== undefined ? { publicDir } : {},
     ...buildCompilerNapiFields(compiler)
-  }));
+  };
+  if (dispatcher)
+    napiOptions._pluginDispatcherSync = dispatcher;
+  const result = wrapOutputFiles(n.buildAppSync(napiOptions));
+  if (dispatcher) {
+    for (const failure of dispatcher.takeLifecycleFailures()) {
+      result.errors.push(pluginFailureToDiagnostic(failure));
+    }
+    for (const warning of dispatcher.takePluginWarnings()) {
+      result.warnings.push(warning);
+    }
+    dispatcher("closeBundle", undefined, null);
+    for (const failure of dispatcher.takeLifecycleFailures()) {
+      result.errors.push(pluginFailureToDiagnostic(failure));
+    }
+    for (const warning of dispatcher.takePluginWarnings()) {
+      result.warnings.push(warning);
+    }
+  }
+  return result;
 }
 function buildCompilerNapiFields(compiler) {
   const out = {};
@@ -3436,22 +3611,90 @@ function normalizeVitePluginSourceMap(map, onDrop) {
     return;
   }
 }
-function createRollupPluginContext(pluginName) {
-  return {
+function createRollupPluginContext(pluginName, onWarn) {
+  const ctx = {
     error(error) {
       throw error;
     },
     warn(message) {
-      console.warn(`@zntc/core [${pluginName}]: ${typeof message === "string" ? message : String(message)}`);
+      const text = `@zntc/core [${pluginName}]: ${typeof message === "string" ? message : String(message)}`;
+      if (onWarn)
+        onWarn({ text });
+      else
+        console.warn(text);
     },
     addWatchFile(_id) {},
-    resolve(_source, _importer, _options) {
-      throw new Error(`@zntc/core [${pluginName}]: this.resolve() is not supported by vitePlugin() adapter yet ` + `(graph mutation surface missing). Use alias config or another plugin's resolveId hook.`);
+    resolve(source, importer, _options) {
+      const fn = ctx.__resolve;
+      if (typeof fn !== "function") {
+        throw new Error(`@zntc/core [${pluginName}]: this.resolve() 는 async build() 의 resolveId/load/transform hook 에서만 사용 가능합니다 (#1880 PR4).`);
+      }
+      return Promise.resolve(fn(source, importer));
+    },
+    emitFile(file) {
+      const fn = ctx.__emitFile;
+      if (typeof fn !== "function") {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile() 는 async build() 의 resolveId/load/transform hook 에서만 사용 가능합니다 (#1880 PR5).`);
+      }
+      if (typeof file !== "object" || file === null) {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile() 는 객체 인자가 필요합니다.`);
+      }
+      const f = file;
+      if (f.type === "chunk") {
+        if (typeof f.id !== "string" || f.id.length === 0) {
+          throw new Error(`@zntc/core [${pluginName}]: this.emitFile({ type: 'chunk' }) 는 비어있지 않은 id(모듈 specifier)가 필요합니다 (#1880 PR7-2b).`);
+        }
+        if (f.implicitlyLoadedAfterOneOf !== undefined && (!Array.isArray(f.implicitlyLoadedAfterOneOf) || !f.implicitlyLoadedAfterOneOf.every((x) => typeof x === "string"))) {
+          throw new Error(`@zntc/core [${pluginName}]: this.emitFile({ type: 'chunk' }) 의 implicitlyLoadedAfterOneOf 는 문자열 id 배열이어야 합니다 (#3664).`);
+        }
+        const chunkRef = fn({
+          chunkId: f.id,
+          chunkName: typeof f.name === "string" && f.name.length > 0 ? f.name : undefined,
+          chunkFileName: typeof f.fileName === "string" && f.fileName.length > 0 ? f.fileName : undefined,
+          chunkImplicitlyLoadedAfterOneOf: Array.isArray(f.implicitlyLoadedAfterOneOf) && f.implicitlyLoadedAfterOneOf.length > 0 ? f.implicitlyLoadedAfterOneOf : undefined
+        });
+        if (typeof chunkRef !== "string") {
+          throw new Error(`@zntc/core [${pluginName}]: this.emitFile({ type: 'chunk', id: ${JSON.stringify(f.id)} }) 가 reference id 를 반환하지 못했습니다.`);
+        }
+        return chunkRef;
+      }
+      if (f.type !== "asset") {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile({ type: '${String(f.type)}' }) 는 아직 미지원입니다 — 현재 type:'asset'/'chunk' 만 지원 (#1880 PR7-2b).`);
+      }
+      const hasFileName = typeof f.fileName === "string" && f.fileName.length > 0;
+      const hasName = typeof f.name === "string" && f.name.length > 0;
+      if (!hasFileName && !hasName) {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile() asset 은 비어있지 않은 fileName 또는 name 이 필요합니다 (#1880 PR6).`);
+      }
+      if (typeof f.source !== "string" && !(f.source instanceof Uint8Array)) {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile() asset 은 source(string | Uint8Array) 가 필요합니다.`);
+      }
+      const referenceId = hasFileName ? fn({ fileName: f.fileName, source: f.source }) : fn({ name: f.name, source: f.source });
+      if (typeof referenceId !== "string") {
+        throw new Error(`@zntc/core [${pluginName}]: this.emitFile(${JSON.stringify(hasFileName ? f.fileName : f.name)}) 가 reference id 를 반환하지 못했습니다 (asset emit 실패).`);
+      }
+      return referenceId;
     },
-    emitFile(_file) {
-      throw new Error(`@zntc/core [${pluginName}]: this.emitFile() is not supported by vitePlugin() adapter yet.`);
+    getFileName(referenceId) {
+      const fn = ctx.__getFileName;
+      if (typeof fn !== "function") {
+        throw new Error(`@zntc/core [${pluginName}]: this.getFileName() 는 resolveId/load/transform/generateBundle hook 에서만 사용 가능합니다 (#1880 PR6/2c).`);
+      }
+      const name = fn(referenceId);
+      if (typeof name !== "string") {
+        throw new Error(`@zntc/core [${pluginName}]: this.getFileName(${JSON.stringify(referenceId)}) — 알 수 없는 reference id (미emit, 또는 chunk 를 청킹 전 hook 에서 조회 — chunk 파일명은 generateBundle 에서 확정).`);
+      }
+      return name;
+    },
+    getModuleInfo(id) {
+      const fn = ctx.__getModuleInfo;
+      if (typeof fn !== "function") {
+        throw new Error(`@zntc/core [${pluginName}]: this.getModuleInfo() 는 async build() 의 transform hook 에서만 사용 가능합니다 (#1880 PR3).`);
+      }
+      return fn(id);
     }
   };
+  return ctx;
 }
 function createDropWarner(context) {
   const seen = new Set;
@@ -3462,6 +3705,12 @@ function createDropWarner(context) {
     context.warn(`sourcemap dropped: ${reason}`);
   };
 }
+function forwardEmitContext(nativeThis, viteCtx) {
+  const from = nativeThis;
+  const to = viteCtx;
+  to.__emitFile = from?.__emitFile;
+  to.__getFileName = from?.__getFileName;
+}
 function vitePlugin(rollupPlugin) {
   return {
     name: rollupPlugin.name,
@@ -3470,7 +3719,8 @@ function vitePlugin(rollupPlugin) {
       const onDropSourceMap = createDropWarner(context);
       const resolveId = extractHandler(rollupPlugin.resolveId);
       if (resolveId) {
-        build2.onResolve({ filter: /.*/ }, (args) => {
+        build2.onResolve({ filter: /.*/ }, function(args) {
+          forwardEmitContext(this, context);
           const result = resolveId.call(context, args.path, args.importer);
           return mapMaybePromise(result, (result2) => {
             if (result2 == null)
@@ -3486,7 +3736,8 @@ function vitePlugin(rollupPlugin) {
       }
       const load = extractHandler(rollupPlugin.load);
       if (load) {
-        build2.onLoad({ filter: /.*/ }, (args) => {
+        build2.onLoad({ filter: /.*/ }, function(args) {
+          forwardEmitContext(this, context);
           const result = load.call(context, args.path);
           return mapMaybePromise(result, (result2) => {
             if (result2 == null)
@@ -3505,7 +3756,8 @@ function vitePlugin(rollupPlugin) {
       }
       const transform = extractHandler(rollupPlugin.transform);
       if (transform) {
-        build2.onTransform({ filter: /.*/ }, (args) => {
+        build2.onTransform({ filter: /.*/ }, function(args) {
+          forwardEmitContext(this, context);
           const result = transform.call(context, args.code, args.path);
           return mapMaybePromise(result, (result2) => {
             if (result2 == null)
@@ -3524,7 +3776,8 @@ function vitePlugin(rollupPlugin) {
       }
       const renderChunk = extractHandler(rollupPlugin.renderChunk);
       if (renderChunk) {
-        build2.onRenderChunk({ filter: /.*/ }, (args) => {
+        build2.onRenderChunk({ filter: /.*/ }, function(args) {
+          forwardEmitContext(this, context);
           const result = renderChunk.call(context, args.code, args.chunk);
           return mapMaybePromise(result, (result2) => {
             if (result2 == null)
@@ -3540,19 +3793,31 @@ function vitePlugin(rollupPlugin) {
       }
       const generateBundle = extractHandler(rollupPlugin.generateBundle);
       if (generateBundle) {
-        build2.onGenerateBundle((outputs) => generateBundle.call(context, outputs));
+        build2.onGenerateBundle(function(outputs) {
+          forwardEmitContext(this, context);
+          return generateBundle.call(context, outputs);
+        });
       }
       const buildStart = extractHandler(rollupPlugin.buildStart);
       if (buildStart) {
-        build2.onBuildStart(() => buildStart.call(context));
+        build2.onBuildStart(function() {
+          forwardEmitContext(this, context);
+          return buildStart.call(context);
+        });
       }
       const buildEnd = extractHandler(rollupPlugin.buildEnd);
       if (buildEnd) {
-        build2.onBuildEnd((err) => buildEnd.call(context, err));
+        build2.onBuildEnd(function(err) {
+          forwardEmitContext(this, context);
+          return buildEnd.call(context, err);
+        });
       }
       const closeBundle = extractHandler(rollupPlugin.closeBundle);
       if (closeBundle) {
-        build2.onCloseBundle(() => closeBundle.call(context));
+        build2.onCloseBundle(function() {
+          forwardEmitContext(this, context);
+          return closeBundle.call(context);
+        });
       }
     }
   };
@@ -3560,11 +3825,16 @@ function vitePlugin(rollupPlugin) {
 function watch(options) {
   const n = ensureNative();
   const { napiOptions: nativeOpts, cleanup } = prepareNapiOptions(options);
+  if (options.outdir !== undefined)
+    nativeOpts.outdir = options.outdir;
   const dispatcher = resolveDispatcher(options);
   if (dispatcher) {
     nativeOpts._pluginDispatcher = dispatcher;
     const dispatchCloseBundle = () => {
-      dispatcher("closeBundle", undefined, null).catch(() => {});
+      dispatcher("closeBundle", undefined, null).catch(() => {}).finally(() => {
+        for (const w of dispatcher.takePluginWarnings())
+          console.warn(w.text);
+      });
     };
     const wrapWatchCallback = (callback) => (event) => {
       Promise.resolve().then(() => callback?.(event)).finally(dispatchCloseBundle).catch(() => {});
@@ -3592,6 +3862,9 @@ function watch(options) {
     },
     getHmrSourceMap(moduleId) {
       return handle.getHmrSourceMap(moduleId);
+    },
+    requestLazySeed(path) {
+      handle.requestLazySeed(path);
     }
   };
 }
@@ -3603,7 +3876,11 @@ export {
   validateTsConfigRaw,
   transpile,
   tokenize,
+  tlsSelfCheck,
   suggestKey,
+  stopDevServer,
+  startDevServer,
+  resolveOutputPath,
   profileReport,
   prepareAppDevSync,
   mergeUserConfigs,
@@ -3616,6 +3893,7 @@ export {
   init,
   importAndResolveDefault,
   identifyWorkspaceEntries,
+  getDevServerPort,
   findWorkspacePath,
   findModeConfigPath,
   findConfigPath,