@zntc/core 0.1.4 → 0.1.6

package/README.md

@@ -37,7 +37,7 @@ bun add -D browserslist core-js core-js-compat lightningcss
 bunx zntc src/index.ts --outfile out.js
 
 # Bundle (multi-entry)
-bunx zntc --bundle src/index.ts --outfile dist/bundle.js --format=esm --target=node
+bunx zntc --bundle src/index.ts --outfile dist/bundle.js --format=esm --platform=node
 ```
 
 See `bunx zntc --help` for the full list of options.

package/bin/cli-flags.mjs

@@ -239,6 +239,7 @@ export const FLAG_REGISTRY = [
   // ─── kind=key-value — `--key:K=V` → opts[target][K]=V ───
   { kind: 'key-value', flag: '--define', target: 'define' },
   { kind: 'key-value', flag: '--alias', target: 'alias' },
+  { kind: 'key-value', flag: '--external-alias', target: 'externalAlias' },
   // Fallback resolution — 해석 실패 시에만 적용 (webpack resolve.fallback /
   // Metro extraNodeModules 호환). `--fallback:crypto=crypto-browserify`.
   // 값 "false" → 빈-모듈 강제 + specifier 제약은 normalizeFallback 참조.

package/bin/zntc.mjs

@@ -17,7 +17,7 @@ import {
   unlinkSync,
   writeFileSync,
 } from 'node:fs';
-import { resolve, dirname, basename, extname, join, sep } from 'node:path';
+import { resolve, dirname, basename, extname, join, sep, relative, isAbsolute } from 'node:path';
 import { createServer } from 'node:http';
 import { createServer as createHttpsServer } from 'node:https';
 import { createRequire } from 'node:module';
@@ -296,6 +296,7 @@ function parseArgs(argv) {
     packagesExternal: false,
     define: {},
     alias: {},
+    externalAlias: {},
     banner: undefined,
     footer: undefined,
     globalName: undefined,
@@ -1228,12 +1229,17 @@ async function runTranspile(opts) {
 
   if (opts.outfile || opts.outdir) {
     const name = basename(opts.entryPoints[0]).replace(/\.[^.]+$/, '.js');
+    // 맵이 놓일 자리 — sources 를 그 자리 기준으로 적어야 브라우저가 원본을 찾는다.
+    const outPath = opts.outfile ? resolve(opts.outfile) : join(resolve(opts.outdir), name);
+    const { code, map } = finishTranspileSourcemap(result, outPath, opts.sourcemapMode);
     // transpile result.code / result.map 은 string — writeOutputFiles 는 contents
     // (Uint8Array) 를 받으므로 `Buffer.from` 으로 한 번 변환. 같은 메모리 backing 의
     // utf-8 byte view 라 추가 copy 없음.
-    const outputFiles = [{ path: name, contents: Buffer.from(result.code) }];
-    if (opts.outfile && result.map) {
-      outputFiles.push({ path: name + '.map', contents: Buffer.from(result.map) });
+    const outputFiles = [{ path: name, contents: Buffer.from(code) }];
+    // outdir 로 낼 때도 맵을 함께 낸다 — 예전엔 outfile 일 때만 내서
+    // `--outdir --sourcemap` 이 조용히 맵 없이 끝났다.
+    if (map) {
+      outputFiles.push({ path: name + '.map', contents: Buffer.from(map) });
     }
     writeOutputFiles(outputFiles, opts.outfile, opts.outdir, opts.entryPoints, opts.allowOverwrite);
   } else {
@@ -1245,6 +1251,52 @@ async function runTranspile(opts) {
   }
 }
 
+/**
+ * transpile 결과의 소스맵을 출력 자리에 맞게 마무리한다.
+ *
+ * 셋 다 CLI 만 아는 것이라 여기서 한다 — 라이브러리 호출자는 출력 경로를
+ * 스스로 정하므로 그쪽이 맡는다.
+ *
+ *  1. `sources` 를 **맵이 놓일 자리 기준**으로 고친다. 엔진은 넘겨받은 파일
+ *     이름(대개 CWD 기준)을 그대로 적어서, `-o dist/x.js` 로 내면 브라우저가
+ *     `dist/src/x.ts` 를 찾다 못 찾는다. tsc·esbuild 도 출력 기준으로 적는다.
+ *  2. `file` 에 생성 파일 이름을 채운다 — 소스맵 v3 의 `file` 은 *생성된* 파일이다.
+ *  3. 모드대로 마무리한다. linked(기본)는 `//# sourceMappingURL=` 주석을 붙이고,
+ *     external 은 맵만 내고 주석은 안 붙이며, inline 은 맵을 파일로 내지 않고
+ *     data URL 로 코드에 심는다. 예전에는 어느 모드든 주석이 안 붙어, 맵을 내고도
+ *     브라우저가 찾지 못했다(inline 인데 .map 파일이 따로 나오기도 했다).
+ */
+function finishTranspileSourcemap(result, outPath, mode) {
+  if (!result.map) return { code: result.code, map: null };
+  let json;
+  try {
+    json = JSON.parse(result.map);
+  } catch {
+    return { code: result.code, map: result.map }; // 못 읽으면 손대지 않는다
+  }
+  json.file = basename(outPath);
+  const outDirAbs = dirname(outPath);
+  json.sources = (json.sources ?? []).map((src) => {
+    if (!src || src.startsWith('data:')) return src;
+    const abs = isAbsolute(src) ? src : resolve(src);
+    const rel = relative(outDirAbs, abs).split(sep).join('/');
+    return rel.startsWith('.') ? rel : './' + rel;
+  });
+  const text = JSON.stringify(json);
+
+  if (mode === 'inline') {
+    const url = 'data:application/json;base64,' + Buffer.from(text).toString('base64');
+    return { code: appendSourceMappingURL(result.code, url), map: null };
+  }
+  if (mode === 'external') return { code: result.code, map: text };
+  return { code: appendSourceMappingURL(result.code, basename(outPath) + '.map'), map: text };
+}
+
+function appendSourceMappingURL(code, url) {
+  if (code.includes('//# sourceMappingURL=')) return code;
+  return code.replace(/\n*$/, '\n') + '//# sourceMappingURL=' + url + '\n';
+}
+
 // ─── Bundle 모드 ───
 
 /**
@@ -1477,7 +1529,7 @@ function mergeConfigIntoOpts(opts, config) {
     }
   }
 
-  for (const key of ['define', 'alias', 'loader', 'globals', 'fallback']) {
+  for (const key of ['define', 'alias', 'externalAlias', 'loader', 'globals', 'fallback']) {
     if (config[key] && typeof config[key] === 'object') {
       opts[key] = { ...config[key], ...opts[key] };
     }
@@ -1561,6 +1613,9 @@ async function buildBundleOptions(opts, config, { filterCallerPreWarmCss = false
     packagesExternal: opts.packagesExternal,
     // `--alias:K=V` 플래그 (webpack/rollup 스타일) — JS 옵션이 tsconfig paths 보다 우선 적용됨.
     alias: Object.keys(opts.alias).length > 0 ? opts.alias : undefined,
+    // #4616 external 지정자를 다른 이름으로 방출 (rollup output.paths 대응).
+    externalAlias:
+      Object.keys(opts.externalAlias ?? {}).length > 0 ? opts.externalAlias : undefined,
     define: Object.keys(opts.define).length > 0 ? opts.define : undefined,
     loader: Object.keys(opts.loader).length > 0 ? opts.loader : undefined,
     minify: opts.minify,

package/dist/core/index.d.cts

@@ -625,6 +625,16 @@ interface BuildOptionsCommon {
         find: string | RegExp;
         replacement: string;
     }>;
+    /**
+     * external 로 남는 지정자를 **다른 이름으로 방출** (rollup `output.paths` /
+     * webpack object-form `externals` 대응).
+     *
+     * `alias` 와 달리 **해석에는 관여하지 않는다** — 이미 external 로 확정된 지정자를
+     * 출력에 쓸 때만 이름을 바꾼다. 브라우저용 shim 을 번들하지 않고 이름만 갈아끼울 때 쓴다.
+     *
+     * @example { crypto: 'crypto-browserify' }  // import ... from "crypto-browserify"
+     */
+    externalAlias?: Record<string, string>;
     /** alias 의 prefix matching 을 끄는 from 목록 — exact 매칭만 허용.
      *
      * `alias` object form 의 기본 동작은 esbuild 처럼 정확/접두사 둘 다 매칭이라

package/dist/core/index.d.ts

@@ -625,6 +625,16 @@ interface BuildOptionsCommon {
         find: string | RegExp;
         replacement: string;
     }>;
+    /**
+     * external 로 남는 지정자를 **다른 이름으로 방출** (rollup `output.paths` /
+     * webpack object-form `externals` 대응).
+     *
+     * `alias` 와 달리 **해석에는 관여하지 않는다** — 이미 external 로 확정된 지정자를
+     * 출력에 쓸 때만 이름을 바꾼다. 브라우저용 shim 을 번들하지 않고 이름만 갈아끼울 때 쓴다.
+     *
+     * @example { crypto: 'crypto-browserify' }  // import ... from "crypto-browserify"
+     */
+    externalAlias?: Record<string, string>;
     /** alias 의 prefix matching 을 끄는 from 목록 — exact 매칭만 허용.
      *
      * `alias` object form 의 기본 동작은 esbuild 처럼 정확/접두사 둘 다 매칭이라

package/dist/index.cjs

@@ -61,7 +61,7 @@ function validateTsConfigRaw(raw) {
 }
 function buildOptionsJson(opts={},unsupportedOverride) {
 	const payload = {};
-	if (opts.target)payload.target = opts.target;
+	if (opts.target && ES_TARGET_BITS[opts.target] !== undefined)payload.target = opts.target;
 	if (unsupportedOverride !== undefined && unsupportedOverride !== 0)payload.unsupported = unsupportedOverride;
 	if (opts.flow)payload.flow = true;
 	if (opts.jsxInJs)payload.jsxInJs = true;
@@ -555,7 +555,7 @@ function warnUnknownKeys(config,known,options={}) {
 	}
 	return result;
 }
-const KNOWN_CONFIG_KEYS = ["entryPoints", "output", "outdir", "outfile", "outbase", "format", "platform", "target", "rnVersion", "diskCache", "cacheDir", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "aliasExact", "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", "assetInlineLimit", "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", "lazyCompilation", "lazyForceParse", "preserveSafePlugins", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
+const KNOWN_CONFIG_KEYS = ["entryPoints", "output", "outdir", "outfile", "outbase", "format", "platform", "target", "rnVersion", "diskCache", "cacheDir", "browserslist", "runtimePolyfills", "coreJs", "jsx", "jsxDev", "jsxFactory", "jsxFragment", "jsxImportSource", "jsxInJs", "jsxSideEffects", "minify", "minifyWhitespace", "minifyIdentifiers", "minifySyntax", "sourcemap", "sourcemapMode", "sourcemapDebugIds", "sourcesContent", "sourceRoot", "external", "alias", "externalAlias", "aliasExact", "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", "assetInlineLimit", "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", "lazyCompilation", "lazyForceParse", "preserveSafePlugins", "extends", "root", "projectRoot", "entry", "dev", "outDir", "bundler", "resolver", "transformer", "serializer", "symbolicator", "watchFolders"];
 //#endregion
 //#region workspace.ts
 var existsSync$1 = require("node:fs").existsSync;
@@ -776,7 +776,10 @@ function resolveUnsupported(options) {
 		}
 		return browserslistToUnsupported(bl(options.browserslist));
 	}
-	return options.target ? ES_TARGET_BITS[options.target] ?? 0 : 0;
+	if (!options.target)return 0;
+	const esBits = ES_TARGET_BITS[options.target];
+	if (esBits !== undefined)return esBits;
+	return ensureNative().targetToUnsupported(options.target);
 }
 var TsconfigCache = class {
 	_handle;
@@ -1220,6 +1223,9 @@ function prepareNapiOptions(options) {
 		delete napiOptions.browserslist;
 	}
 	if (options.target && !isEsTarget(options.target)) {
+		if (napiOptions.unsupported === undefined) {
+			napiOptions.unsupported = ensureNative().targetToUnsupported(options.target);
+		}
 		delete napiOptions.target;
 	}
 	delete napiOptions.compiler;

package/dist/index.js

@@ -1240,7 +1240,7 @@ function validateTsConfigRaw(raw) {
 }
 function buildOptionsJson(opts = {}, unsupportedOverride) {
   const payload = {};
-  if (opts.target)
+  if (opts.target && ES_TARGET_BITS[opts.target] !== undefined)
     payload.target = opts.target;
   if (unsupportedOverride !== undefined && unsupportedOverride !== 0)
     payload.unsupported = unsupportedOverride;
@@ -2244,6 +2244,7 @@ var KNOWN_CONFIG_KEYS = [
   "sourceRoot",
   "external",
   "alias",
+  "externalAlias",
   "aliasExact",
   "define",
   "server",
@@ -2574,7 +2575,12 @@ function resolveUnsupported(options) {
     }
     return browserslistToUnsupported(bl(options.browserslist));
   }
-  return options.target ? ES_TARGET_BITS[options.target] ?? 0 : 0;
+  if (!options.target)
+    return 0;
+  const esBits = ES_TARGET_BITS[options.target];
+  if (esBits !== undefined)
+    return esBits;
+  return ensureNative().targetToUnsupported(options.target);
 }
 
 class TsconfigCache {
@@ -3183,6 +3189,9 @@ function prepareNapiOptions(options) {
     delete napiOptions.browserslist;
   }
   if (options.target && !isEsTarget(options.target)) {
+    if (napiOptions.unsupported === undefined) {
+      napiOptions.unsupported = ensureNative().targetToUnsupported(options.target);
+    }
     delete napiOptions.target;
   }
   delete napiOptions.compiler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zntc/core",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "ZNTC native transpiler & compiler binding",
   "keywords": [
     "bundler",
@@ -76,15 +76,15 @@
     "@zntc/test-helpers": "0.0.0"
   },
   "optionalDependencies": {
-    "@zntc/core-darwin-arm64": "0.1.4",
-    "@zntc/core-darwin-x64": "0.1.4",
-    "@zntc/core-linux-arm64-gnu": "0.1.4",
-    "@zntc/core-linux-arm64-musl": "0.1.4",
-    "@zntc/core-linux-x64-gnu": "0.1.4",
-    "@zntc/core-linux-x64-musl": "0.1.4",
-    "@zntc/core-win32-arm64-msvc": "0.1.4",
-    "@zntc/core-win32-ia32-msvc": "0.1.4",
-    "@zntc/core-win32-x64-msvc": "0.1.4",
+    "@zntc/core-darwin-arm64": "0.1.6",
+    "@zntc/core-darwin-x64": "0.1.6",
+    "@zntc/core-linux-arm64-gnu": "0.1.6",
+    "@zntc/core-linux-arm64-musl": "0.1.6",
+    "@zntc/core-linux-x64-gnu": "0.1.6",
+    "@zntc/core-linux-x64-musl": "0.1.6",
+    "@zntc/core-win32-arm64-msvc": "0.1.6",
+    "@zntc/core-win32-ia32-msvc": "0.1.6",
+    "@zntc/core-win32-x64-msvc": "0.1.6",
     "browserslist": "^4.24.0",
     "core-js": "^3.49.0",
     "core-js-compat": "^3.49.0",