@zntc/core 0.1.0 → 0.1.2

package/dist/index.cjs

@@ -102,7 +102,7 @@ function parseBrowserslistEntry(entry) {
 	if (!m)return null;
 	const name = m[1].toLowerCase();
 	;
-	const [majStr, minStr="0"] = (m[2]).split("."),major = parseInt(majStr, 10),minor = parseInt(minStr, 10);
+	const [majStr, minStr="0"] = m[2].split("."),major = parseInt(majStr, 10),minor = parseInt(minStr, 10);
 	if (Number.isNaN(major))return null;
 	;
 	const engine = { chrome: "chrome", and_chr: "chrome", firefox: "firefox", and_ff: "firefox", safari: "safari", ios_saf: "ios", edge: "edge", node: "node", deno: "deno", opera: "opera", op_mob: "opera", hermes: "hermes" }[name];
@@ -352,7 +352,7 @@ async function loadModuleDefault(absPath,kind,options) {
 		}
 	}
 	if (TS_EXTS.has(ext)) {
-		return (await loadTsModule(absPath, kind, allowArray));
+		return await loadTsModule(absPath, kind, allowArray);
 	}
 	if (JS_EXTS.has(ext)) {
 		try {
@@ -402,7 +402,7 @@ async function importAndResolveDefault(absPath,options) {
 	;
 	if (valueType !== "function" && !(valueType === "object" && value !== null && (allowArray || !isArray))) {
 		;
-		throw new Error(`@zntc/core: module must be an object or function (got ${(value === null ? "null" : isArray ? "array" : valueType)}) from ${absPath}`);
+		throw new Error(`@zntc/core: module must be an object or function (got ${value === null ? "null" : isArray ? "array" : valueType}) from ${absPath}`);
 	}
 	return value;
 }
@@ -469,7 +469,7 @@ function parseDotenvLine(line) {
 	const key = trimmed.slice(0, eqIdx).trim();
 	if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))return null;
 	let value = trimmed.slice(eqIdx + 1).trim();
-	const quoted = (value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"));
+	const quoted = value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'");
 	if (quoted) {
 		value = value.slice(1, -1);
 	} else {
@@ -534,7 +534,7 @@ function suggestKey(unknown,known,threshold=2) {
 	for (const candidate of known) {
 		const d = levenshtein(unknown, candidate);
 		if (d > adjusted)continue;
-		if (d < bestDist || (d === bestDist && best !== null && candidate < best)) {
+		if (d < bestDist || d === bestDist && best !== null && candidate < best) {
 			best = candidate;
 			bestDist = d;
 		}
@@ -554,7 +554,7 @@ function warnUnknownKeys(config,known,options={}) {
 	}
 	return result;
 }
-const KNOWN_CONFIG_KEYS = ["entryPoints", "outdir", "outfile", "outbase", "format", "platform", "target", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "define", "server", "loader", "conditions", "nodePaths", "moduleSpecifierMap", "resolveExtensions", "mainFields", "packagesExternal", "preserveSymlinks", "resolveSymlinkSiblings", "disableHierarchicalLookup", "splitting", "outputExports", "preserveModules", "preserveModulesRoot", "inlineDynamicImports", "manualChunks", "minChunkSize", "metafile", "treeShaking", "shimMissingExports", "keepNames", "drop", "dropConsole", "dropDebugger", "dropLabels", "banner", "footer", "intro", "outro", "inject", "pure", "legalComments", "entryNames", "chunkNames", "assetNames", "experimentalDecorators", "emitDecoratorMetadata", "useDefineForClassFields", "verbatimModuleSyntax", "tsconfigPath", "tsconfigRaw", "globalName", "globals", "publicPath", "charsetUtf8", "asciiOnly", "quotes", "compiler", "mf", "flow", "plugins", "logLevel", "logLimit", "lineLimit", "profile", "profileFormat", "profileLevel", "tokenizeFormat", "stopAfter", "ignoreAnnotations", "watchDelay", "jobs", "codegenTransform", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
+const KNOWN_CONFIG_KEYS = ["entryPoints", "output", "outdir", "outfile", "outbase", "format", "platform", "target", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "define", "server", "loader", "conditions", "nodePaths", "moduleSpecifierMap", "resolveExtensions", "mainFields", "packagesExternal", "preserveSymlinks", "resolveSymlinkSiblings", "disableHierarchicalLookup", "splitting", "outputExports", "preserveModules", "preserveModulesRoot", "inlineDynamicImports", "manualChunks", "minChunkSize", "metafile", "treeShaking", "shimMissingExports", "keepNames", "drop", "dropConsole", "dropDebugger", "dropLabels", "banner", "footer", "intro", "outro", "inject", "pure", "legalComments", "entryNames", "chunkNames", "assetNames", "cssNames", "experimentalDecorators", "emitDecoratorMetadata", "useDefineForClassFields", "verbatimModuleSyntax", "tsconfigPath", "tsconfigRaw", "globalName", "globals", "publicPath", "charsetUtf8", "asciiOnly", "quotes", "compiler", "mf", "flow", "plugins", "logLevel", "logLimit", "lineLimit", "profile", "profileFormat", "profileLevel", "tokenizeFormat", "stopAfter", "ignoreAnnotations", "watchDelay", "jobs", "codegenTransform", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
 //#endregion
 //#region workspace.ts
 var existsSync$1 = require("node:fs").existsSync;
@@ -579,7 +579,7 @@ async function loadWorkspace(filePath,env) {
 	const absPath = pathResolve$2(filePath),raw = await loadModuleDefault(absPath, "workspace", { allowArray: true }),entries = typeof raw == "function" ? await raw(env ?? defaultConfigEnv()) : raw;
 	if (!Array.isArray(entries)) {
 		;
-		throw new Error(`@zntc/core: workspace must export an array (got ${(entries === null ? "null" : typeof entries)}) from ${absPath}`);
+		throw new Error(`@zntc/core: workspace must export an array (got ${entries === null ? "null" : typeof entries}) from ${absPath}`);
 	}
 	for (let i = 0; i < entries.length; i += 1) {
 		const e = entries[i];
@@ -774,7 +774,7 @@ function resolveUnsupported(options) {
 		}
 		return browserslistToUnsupported(bl(options.browserslist));
 	}
-	return options.target ? (ES_TARGET_BITS[options.target] ?? 0) : 0;
+	return options.target ? ES_TARGET_BITS[options.target] ?? 0 : 0;
 }
 var TsconfigCache = class {
 	_handle;
@@ -810,6 +810,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",file = fallbackFile ?? undefined,line,column;
 	if (typeof thrown == "string") {
@@ -827,14 +839,14 @@ function normalizePluginFailure(pluginName,hookName,thrown,fallbackFile) {
 	} else if (thrown != null) {
 		message = String(thrown);
 	}
-	return { __zntcPluginFailure: true, pluginName, hookName, message, ...(file ? { file } : {}), ...(line !== undefined ? { line } : {}), ...(column !== undefined ? { column } : {}) };
+	return { __zntcPluginFailure: true, pluginName, hookName, message, ...file ? { file } : {}, ...line !== undefined ? { line } : {}, ...column !== undefined ? { column } : {} };
 }
 function pluginFailureText(failure) {
 	const location = failure.file && failure.line !== undefined ? ` (${failure.file}:${failure.line}:${failure.column ?? 0})` : failure.file ? ` (${failure.file})` : "";
 	return `Plugin "${failure.pluginName}" failed in ${failure.hookName}: ${failure.message}${location}`;
 }
 function pluginFailureToDiagnostic(failure) {
-	return { code: "plugin_error", text: pluginFailureText(failure), ...(failure.file ? { location: { file: failure.file, line: failure.line, column: failure.column } } : {}) };
+	return { code: "plugin_error", text: pluginFailureText(failure), ...failure.file ? { location: { file: failure.file, line: failure.line, column: failure.column } } : {} };
 }
 function serializePluginSourceMap(map) {
 	if (map == null)return null;
@@ -856,7 +868,7 @@ function serializePluginSourceMap(map) {
 	}
 }
 function isPromiseLike(value) {
-	return (value != null && (typeof value == "object" || typeof value == "function") && typeof value.then == "function");
+	return value != null && (typeof value == "object" || typeof value == "function") && typeof value.then == "function";
 }
 function silenceUnsupportedSyncPromise(value) {
 	Promise.resolve(value).catch(() => {
@@ -868,6 +880,14 @@ 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],tv = out[key],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) };
@@ -880,7 +900,7 @@ function mapMaybePromise(value,mapper) {
 	return mapper(value);
 }
 function collectPluginRegistry(plugins) {
-	const registry = { hooks: { resolveId: [], load: [], transform: [], renderChunk: [], resolveContext: [] }, generateBundleCallbacks: [], buildStartCallbacks: [], buildEndCallbacks: [], closeBundleCallbacks: [], astFunctionHooks: [], lifecycleFailures: [] };
+	const registry = { hooks: { resolveId: [], load: [], transform: [], renderChunk: [], resolveContext: [] }, generateBundleCallbacks: [], buildStartCallbacks: [], buildEndCallbacks: [], closeBundleCallbacks: [], astFunctionHooks: [], 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, callback: cb });
@@ -929,7 +949,20 @@ function lifecycleHookSpec(reg,hookName,arg1) {
 			return null;
 	}
 }
-function* dispatchHook(reg,hookName,arg1,arg2) {
+function getPluginContext(reg,pluginName,getModuleInfo,resolve,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 = resolve;
+	slot.__emitFile = emitFile;
+	slot.__getFileName = getFileName;
+	return ctx;
+}
+function* dispatchHook(reg,hookName,arg1,arg2,getModuleInfo,resolve,emitFile,getFileName) {
 	if (hookName === "astFunction") {
 		if (reg.astFunctionHooks.length === 0)return null;
 		let info;
@@ -940,7 +973,7 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 		}
 		for (const h of reg.astFunctionHooks) {
 			if (!h.filter.test(info.sourcePath))continue;
-			const result = yield { callback: () => h.callback(info), pluginName: h.pluginName, hookName: "astFunction", fallbackFile: info.sourcePath };
+			const result = yield { callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve, emitFile, getFileName), info), pluginName: h.pluginName, hookName: "astFunction", fallbackFile: info.sourcePath };
 			if (isPluginFailureResult(result))return result;
 			if (result != null)return result;
 		}
@@ -956,7 +989,7 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 		}
 		for (const h of reg.hooks.resolveContext) {
 			if (!h.filter.test(args.dir))continue;
-			const result = yield { callback: () => h.callback(args), pluginName: h.pluginName, hookName: "resolveContext", fallbackFile: args.importer };
+			const result = yield { callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve, emitFile, getFileName), args), pluginName: h.pluginName, hookName: "resolveContext", fallbackFile: args.importer };
 			if (isPluginFailureResult(result))return result;
 			if (result != null)return result;
 		}
@@ -967,7 +1000,7 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 		if (spec) {
 			let firstFailure = null;
 			for (const { pluginName:pluginName, callback:callback } of spec.callbacks) {
-				const result = yield { callback: () => callback(spec.arg), pluginName, hookName };
+				const result = yield { callback: () => callback.call(getPluginContext(reg, pluginName, getModuleInfo, resolve, emitFile, getFileName), spec.arg), pluginName, hookName };
 				if (isPluginFailureResult(result) && firstFailure == null)firstFailure = result;
 			}
 			if (spec.surfaceFailures) {
@@ -982,9 +1015,10 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 		if (!hookList)return null;
 		let currentCode = arg1,changed = false;
 		const sourceMaps = [];
+		let mergedMeta;
 		for (const h of hookList) {
 			if (!h.filter.test(arg2 ?? ""))continue;
-			const cbArgs = hookName === "transform" ? { code: currentCode, path: arg2 } : { code: currentCode, chunk: arg2 },result = yield { callback: () => h.callback(cbArgs), pluginName: h.pluginName, hookName, fallbackFile: arg2 };
+			const cbArgs = hookName === "transform" ? { code: currentCode, path: arg2 } : { code: currentCode, chunk: arg2 },result = yield { callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve, emitFile, getFileName), cbArgs), pluginName: h.pluginName, hookName, fallbackFile: arg2 };
 			if (isPluginFailureResult(result))return result;
 			if (result != null) {
 				const obj = result,newCode = typeof result == "string" ? result : obj.code;
@@ -997,9 +1031,23 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 					if (!r.ok)return normalizePluginFailure(h.pluginName, hookName, r.err, 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)return null;
@@ -1008,15 +1056,26 @@ function* dispatchHook(reg,hookName,arg1,arg2) {
 	const [filterTarget, cbArgs] = buildArgs(arg1, arg2);
 	for (const h of hookList) {
 		if (!h.filter.test(filterTarget))continue;
-		const fallbackFile = hookName === "resolveId" ? arg2 : filterTarget,result = yield { callback: () => h.callback(cbArgs), pluginName: h.pluginName, hookName, fallbackFile };
+		const fallbackFile = hookName === "resolveId" ? arg2 : filterTarget,result = yield { callback: () => h.callback.call(getPluginContext(reg, h.pluginName, getModuleInfo, resolve, emitFile, getFileName), cbArgs), pluginName: h.pluginName, hookName, fallbackFile };
 		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;
@@ -1056,10 +1115,11 @@ function driveDispatchSync(gen) {
 	return r.value;
 }
 function createPluginDispatcher(plugins) {
-	const reg = collectPluginRegistry(plugins),dispatcher = function dispatcher(hookName,arg1,arg2) {
-		return driveDispatchAsync(dispatchHook(reg, hookName, arg1, arg2));
+	const reg = collectPluginRegistry(plugins),dispatcher = function dispatcher(hookName,arg1,arg2,getModuleInfo,resolve,emitFile,getFileName) {
+		return driveDispatchAsync(dispatchHook(reg, hookName, arg1, arg2, getModuleInfo, resolve, emitFile, getFileName));
 	};
 	dispatcher.takeLifecycleFailures = () => reg.lifecycleFailures.splice(0);
+	dispatcher.takePluginWarnings = () => reg.pluginWarnings.splice(0);
 	return dispatcher;
 }
 function createSyncPluginDispatcher(plugins) {
@@ -1067,6 +1127,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) {
@@ -1103,6 +1164,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) {
@@ -1252,6 +1318,7 @@ async function build(options) {
 	const n = ensureNative();
 	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);
 	}
@@ -1263,6 +1330,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);
@@ -1271,6 +1341,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 {
@@ -1281,6 +1354,7 @@ function buildSync(options) {
 	const n = ensureNative();
 	if (!options.entryPoints?.length)throw new Error("@zntc/core: entryPoints is required");
 	validateTsConfigRaw(options.tsconfigRaw);
+	warnIfWatchOnlyOption(options, "buildSync");
 	const { napiOptions:napiOptions, cleanup:cleanup } = prepareNapiOptions(options),dispatcher = resolveDispatcher(options, "sync");
 	if (dispatcher)napiOptions._pluginDispatcherSync = dispatcher;
 	try {
@@ -1289,6 +1363,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);
@@ -1297,6 +1374,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 {
@@ -1354,8 +1434,27 @@ async function buildMultiFormat(options) {
 	return aggregated;
 }
 function buildAppSync(options={}) {
-	const n = ensureNative(),{ publicDir:publicDir, compiler:compiler, ...rest } = options;
-	return wrapOutputFiles(n.buildAppSync({ ...rest, define: withDefaultAppBuildDefines(options), ...(publicDir === false ? { disablePublicDir: true } : publicDir !== undefined ? { publicDir } : {}), ...buildCompilerNapiFields(compiler) }));
+	const n = ensureNative(),{ publicDir:publicDir, compiler:compiler, plugins:_plugins, ...rest } = options;
+	;
+	const dispatcher = resolveDispatcher(options, "sync"),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 = {},sc = compiler?.styledComponents;
@@ -1392,7 +1491,7 @@ function buildCompilerNapiFields(compiler) {
 }
 function prepareAppDevSync(options={}) {
 	const n = ensureNative(),{ publicDir:publicDir, ...rest } = options;
-	return n.prepareAppDevSync({ ...rest, ...(publicDir === false ? { disablePublicDir: true } : publicDir !== undefined ? { publicDir } : {}) });
+	return n.prepareAppDevSync({ ...rest, ...publicDir === false ? { disablePublicDir: true } : publicDir !== undefined ? { publicDir } : {} });
 }
 function close() {
 	native = null;
@@ -1438,17 +1537,74 @@ function normalizeVitePluginSourceMap(map,onDrop) {
 		return undefined;
 	}
 }
-function createRollupPluginContext(pluginName) {
-	return { error(error) {
+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.`);
-	}, emitFile(_file) {
-		throw new Error(`@zntc/core [${pluginName}]: this.emitFile() is not supported by vitePlugin() adapter yet.`);
+	}, 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,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;
+	}, 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();
@@ -1458,11 +1614,17 @@ function createDropWarner(context) {
 		context.warn(`sourcemap dropped: ${reason}`);
 	};
 }
+function forwardEmitContext(nativeThis,viteCtx) {
+	const from = nativeThis,to = viteCtx;
+	to.__emitFile = from?.__emitFile;
+	to.__getFileName = from?.__getFileName;
+}
 function vitePlugin(rollupPlugin) {
 	return { name: rollupPlugin.name, setup(build) {
 		const context = createRollupPluginContext(rollupPlugin.name),onDropSourceMap = createDropWarner(context),resolveId = extractHandler(rollupPlugin.resolveId);
 		if (resolveId) {
-			build.onResolve({ filter: /.*/ }, (args) => {
+			build.onResolve({ filter: /.*/ }, function(args) {
+				forwardEmitContext(this, context);
 				const result = resolveId.call(context, args.path, args.importer);
 				return mapMaybePromise(result, (result) => {
 					if (result == null)return null;
@@ -1476,7 +1638,8 @@ function vitePlugin(rollupPlugin) {
 		}
 		const load = extractHandler(rollupPlugin.load);
 		if (load) {
-			build.onLoad({ filter: /.*/ }, (args) => {
+			build.onLoad({ filter: /.*/ }, function(args) {
+				forwardEmitContext(this, context);
 				const result = load.call(context, args.path);
 				return mapMaybePromise(result, (result) => {
 					if (result == null)return null;
@@ -1490,7 +1653,8 @@ function vitePlugin(rollupPlugin) {
 		}
 		const transform = extractHandler(rollupPlugin.transform);
 		if (transform) {
-			build.onTransform({ filter: /.*/ }, (args) => {
+			build.onTransform({ filter: /.*/ }, function(args) {
+				forwardEmitContext(this, context);
 				const result = transform.call(context, args.code, args.path);
 				return mapMaybePromise(result, (result) => {
 					if (result == null)return null;
@@ -1504,7 +1668,8 @@ function vitePlugin(rollupPlugin) {
 		}
 		const renderChunk = extractHandler(rollupPlugin.renderChunk);
 		if (renderChunk) {
-			build.onRenderChunk({ filter: /.*/ }, (args) => {
+			build.onRenderChunk({ filter: /.*/ }, function(args) {
+				forwardEmitContext(this, context);
 				const result = renderChunk.call(context, args.code, args.chunk);
 				return mapMaybePromise(result, (result) => {
 					if (result == null)return null;
@@ -1518,28 +1683,44 @@ function vitePlugin(rollupPlugin) {
 		}
 		const generateBundle = extractHandler(rollupPlugin.generateBundle);
 		if (generateBundle) {
-			build.onGenerateBundle((outputs) => generateBundle.call(context, outputs));
+			build.onGenerateBundle(function(outputs) {
+				forwardEmitContext(this, context);
+				return generateBundle.call(context, outputs);
+			});
 		}
 		const buildStart = extractHandler(rollupPlugin.buildStart);
 		if (buildStart) {
-			build.onBuildStart(() => buildStart.call(context));
+			build.onBuildStart(function() {
+				forwardEmitContext(this, context);
+				return buildStart.call(context);
+			});
 		}
 		const buildEnd = extractHandler(rollupPlugin.buildEnd);
 		if (buildEnd) {
-			build.onBuildEnd((err) => buildEnd.call(context, err));
+			build.onBuildEnd(function(err) {
+				forwardEmitContext(this, context);
+				return buildEnd.call(context, err);
+			});
 		}
 		const closeBundle = extractHandler(rollupPlugin.closeBundle);
 		if (closeBundle) {
-			build.onCloseBundle(() => closeBundle.call(context));
+			build.onCloseBundle(function() {
+				forwardEmitContext(this, context);
+				return closeBundle.call(context);
+			});
 		}
 	} };
 }
 function watch(options) {
-	const n = ensureNative(),{ napiOptions:nativeOpts, cleanup:cleanup } = prepareNapiOptions(options),dispatcher = resolveDispatcher(options);
+	const n = ensureNative(),{ napiOptions:nativeOpts, cleanup:cleanup } = prepareNapiOptions(options);
+	if (options.outdir !== undefined)nativeOpts.outdir = options.outdir;
+	const dispatcher = resolveDispatcher(options);
 	if (dispatcher) {
 		nativeOpts._pluginDispatcher = dispatcher;
 		const dispatchCloseBundle = () => {
 			void dispatcher("closeBundle", undefined, null).catch(() => {
+			}).finally(() => {
+				for (const w of dispatcher.takePluginWarnings())console.warn(w.text);
 			});
 		},wrapWatchCallback = (callback) => (event) => {
 			void Promise.resolve().then(() => callback?.(event)).finally(dispatchCloseBundle).catch(() => {
@@ -1565,6 +1746,8 @@ function watch(options) {
 		return handle.getBundleSourceMap();
 	}, getHmrSourceMap(moduleId) {
 		return handle.getHmrSourceMap(moduleId);
+	}, requestLazySeed(path) {
+		handle.requestLazySeed(path);
 	} };
 }
 exports.isPlainObject = isPlainObject;
@@ -1595,6 +1778,10 @@ exports.transpile = transpile;
 exports.tokenize = tokenize;
 exports.configureProfile = configureProfile;
 exports.profileReport = profileReport;
+exports.tlsSelfCheck = tlsSelfCheck;
+exports.startDevServer = startDevServer;
+exports.stopDevServer = stopDevServer;
+exports.getDevServerPort = getDevServerPort;
 exports.build = build;
 exports.buildSync = buildSync;
 exports.BuildInstance = BuildInstance;