@zntc/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ohah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @zntc/core
+
+ZNTC (Zig Native Transpiler & Compiler) 의 코어 — Zig 로 작성된 JS/TS/Flow 트랜스파일러 + 번들러의 Node.js NAPI 바인딩 + JS API + CLI.
+
+SWC / oxc 와 동급 성능을 목표로, in-process 호출 (NAPI) + Vite/Rollup 어댑터 / 단독 CLI 모두 제공.
+
+## 설치
+
+```bash
+bun add -D @zntc/core
+# 또는
+npm i -D @zntc/core
+```
+
+플랫폼별 prebuilt binary 가 함께 install 됨 (linux/darwin/windows × x64/arm64).
+
+### Optional (필요 시)
+
+```bash
+bun add -D browserslist core-js core-js-compat lightningcss
+```
+
+- `browserslist` / `core-js-compat` — `runtimePolyfills` 옵션 사용 시
+- `lightningcss` — CSS minify / nesting 사용 시
+
+## CLI
+
+```bash
+# transpile single file
+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 --help`
+
+App-mode (`bunx zntc dev / build / preview`) 는 `@zntc/web` 또는 `@zntc/react-native` 가 함께 install 되어야 동작 — 각 패키지 README 참조.
+
+## JS API
+
+```ts
+import { init, transpile, build } from '@zntc/core';
+
+await init();
+
+// 단일 파일 transpile
+const r = transpile('const x: number = 1;', { filename: 'input.ts' });
+console.log(r.code); // "const x = 1;"
+
+// bundle (multi-file)
+const out = await build({
+  entryPoints: ['src/index.ts'],
+  outdir: 'dist',
+  format: 'esm',
+  target: 'es2020',
+});
+```
+
+자세한 옵션: [docs/CONFIG.md](https://github.com/ohah/zts/blob/main/docs/CONFIG.md) · [docs/USAGE.md](https://github.com/ohah/zts/blob/main/docs/USAGE.md)
+
+## 관련 패키지
+
+- [@zntc/web](https://npmjs.com/package/@zntc/web) — dev server + HMR overlay + postcss/sass
+- [@zntc/react-native](https://npmjs.com/package/@zntc/react-native) — RN preset + Metro HMR adapter
+- [@zntc/wasm](https://npmjs.com/package/@zntc/wasm) — browser-side WASM 빌드 (NAPI 대신)
+- [@zntc/init](https://npmjs.com/package/@zntc/init) — 기존 RN 프로젝트에 ZNTC 도입
+- [@zntc/vite-plugin](https://npmjs.com/package/@zntc/vite-plugin) — Vite 의 esbuild transform 을 ZNTC 로 교체
+
+## 라이센스
+
+MIT.

package/bin/banner.mjs

@@ -0,0 +1,131 @@
+// ZNTC CLI 시작 banner — ASCII 로고 + 그라디언트 + 박스.
+// 시각 디자인은 packages/react-native/src/dev-server/logger.ts 의
+// `printZntcRnBanner` 와 sync 유지 (양쪽 동시 수정).
+
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  gray: '\x1b[90m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  // 16-color 엔 진짜 amber/orange 가 없어 bright-yellow→yellow→bright-red 로
+  // warm 근사. 256-color 는 미지원 터미널서 무색으로 떨어져 보편 16-color 사용.
+  brightYellow: '\x1b[93m',
+  brightRed: '\x1b[91m',
+};
+
+/**
+ * 색상(ANSI) 출력 사용 여부. NO_COLOR / FORCE_COLOR 관례(no-color.org,
+ * supports-color) 준수: `NO_COLOR` 가 비어있지 않으면 무조건 비활성,
+ * `FORCE_COLOR` 가 "0"/"false" 가 아니면(빈 문자열 포함 — supports-color 관례상
+ * 활성) 무조건 활성, 둘 다 없으면 TTY 여부.
+ */
+export function shouldUseColor() {
+  const { NO_COLOR, FORCE_COLOR } = process.env;
+  if (NO_COLOR) return false;
+  if (FORCE_COLOR !== undefined) return FORCE_COLOR !== '0' && FORCE_COLOR !== 'false';
+  return Boolean(process.stdout.isTTY);
+}
+
+/**
+ * `zntc --color` / `--no-color` 를 NO_COLOR/FORCE_COLOR env 로 환원해 shouldUseColor()
+ * 단일 경로로 합류시킨다. 명시 flag 는 **반대편 env 를 제거**해 기존 env 보다
+ * 우선한다 (`NO_COLOR=1 zntc --color` → 색상 ON). `color` 미지정(undefined) 시
+ * env 무변경 → 기존 NO_COLOR/FORCE_COLOR/TTY 자동 판정 유지.
+ *
+ * @param {boolean | undefined} color  opts.color (true=강제, false=억제, undefined=자동)
+ * @param {Record<string, string | undefined>} env  기본 process.env (테스트는 주입)
+ */
+export function applyColorPreference(color, env = process.env) {
+  if (color === true) {
+    delete env.NO_COLOR;
+    env.FORCE_COLOR = '1';
+  } else if (color === false) {
+    delete env.FORCE_COLOR;
+    env.NO_COLOR = '1';
+  }
+}
+
+const BANNER_WIDTH = 59;
+
+function bannerLine(content) {
+  // eslint-disable-next-line no-control-regex
+  const visibleLen = content.replace(/\x1b\[[0-9;]*m/g, '').length;
+  const padding = Math.max(0, BANNER_WIDTH - visibleLen);
+  const left = Math.floor(padding / 2);
+  const right = padding - left;
+  return `${colors.cyan}    ║${colors.reset}${' '.repeat(left)}${content}${' '.repeat(right)}${colors.cyan}║${colors.reset}`;
+}
+
+// 지구라트 로고 — zntc-logo.svg / favicon 과 동일: 단 사이가 띈 적층 바
+// (햄버거식). half-block `▀` 로 한 줄에 바+여백을 담아 절반 높이·컴팩트.
+// ZNTC_GRADIENT 와 index 1:1. bannerLine 이 각 줄을 박스 중앙 정렬.
+export const ZNTC_ASCII = [
+  '▀▀▀▀▀▀▀▀',
+  '▀▀▀▀▀▀▀▀▀▀▀▀',
+  '▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀',
+  '▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀',
+  '▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀',
+];
+
+export const ZNTC_GRADIENT = [
+  colors.brightYellow,
+  colors.brightYellow,
+  colors.yellow,
+  colors.brightRed,
+  colors.brightRed,
+];
+
+// ZNTC_ASCII[i] 는 ZNTC_GRADIENT[i] 로 색칠 — desync 시 undefined 가
+// visibleLen 을 오염시켜 줄 정렬이 깨진다. import 시점 fail-fast.
+if (ZNTC_ASCII.length !== ZNTC_GRADIENT.length) {
+  throw new Error(
+    `ZNTC banner: ZNTC_ASCII(${ZNTC_ASCII.length}) / ZNTC_GRADIENT(${ZNTC_GRADIENT.length}) 길이 불일치`,
+  );
+}
+
+const TAGLINES = {
+  web: 'Lightning Fast Web Bundler',
+  rn: 'Lightning Fast React Native Bundler',
+};
+
+/**
+ * ZNTC 시작 banner 출력.
+ *
+ * - `silent: true` 또는 색상 비활성 환경(비-TTY / NO_COLOR / `--no-color`)에서는
+ *   plain 한 줄 (`zntc <flavor> v0.1.0`) 만 출력. ASCII art 의 ANSI escape 가 CI
+ *   로그 / pipe 에서 노이즈가 되는 것을 막는다.
+ *
+ * @param {{ flavor: 'web' | 'rn', version?: string, silent?: boolean }} opts
+ */
+export function printZntcBanner({ flavor, version, silent = false }) {
+  if (silent) return;
+  const tagline = TAGLINES[flavor];
+  if (!tagline) throw new Error(`printZntcBanner: unknown flavor "${flavor}"`);
+
+  const versionText = version ? `v${version}` : '';
+
+  if (!shouldUseColor()) {
+    console.log(`zntc ${flavor}${versionText ? ` ${versionText}` : ''} — ${tagline}`);
+    return;
+  }
+
+  const logoLines = ZNTC_ASCII.map((line, i) =>
+    bannerLine(`${colors.bold}${ZNTC_GRADIENT[i]}${line}${colors.reset}`),
+  );
+  const lines = [
+    '',
+    `${colors.cyan}    ╔${'═'.repeat(BANNER_WIDTH)}╗${colors.reset}`,
+    bannerLine(''),
+    ...logoLines,
+    bannerLine(''),
+    bannerLine(`${colors.cyan}${tagline}${colors.reset}`),
+    bannerLine(`${colors.gray}${versionText}${colors.reset}`),
+    bannerLine(''),
+    `${colors.cyan}    ╚${'═'.repeat(BANNER_WIDTH)}╝${colors.reset}`,
+    '',
+  ];
+  console.log(lines.join('\n'));
+}