@zntc/core 0.1.0

package/dist/shared/compat-engines.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Engine × Feature 지원 버전 테이블 (JS 미러).
+ *
+ * src/transformer/compat.zig의 compat_table을 거울 복사.
+ * browserslist → UnsupportedFeatures bitmask 계산에 사용.
+ *
+ * **주의**: compat.zig를 수정하면 이 파일도 함께 업데이트.
+ * 장기적으론 scripts/compat-from-kangax.ts를 확장해 자동 생성.
+ *
+ * Bit 레이아웃은 packages/shared/index.ts ES_TARGET_BITS와 동일 (0-27).
+ */
+export type Engine = 'chrome' | 'firefox' | 'safari' | 'edge' | 'node' | 'deno' | 'ios' | 'opera' | 'hermes';
+/** compat.zig의 Feature enum과 동일 순서. bit 위치 = 배열 인덱스. */
+export declare const FEATURES: readonly ["arrow", "class", "template_literal", "destructuring", "for_of", "spread", "object_extensions", "default_params", "block_scoping", "generator", "new_target", "exponentiation", "async_await", "object_spread", "optional_catch_binding", "nullish_coalescing", "optional_chaining", "logical_assignment", "class_static_block", "class_private_method", "class_private_field", "top_level_await", "hashbang", "using", "regex_sticky", "regex_dotall", "regex_named_groups", "unicode_brace_escape"];
+export type Feature = (typeof FEATURES)[number];
+/**
+ * feature × engine → 최소 지원 버전 [major, minor].
+ * 엔진에 키가 없으면 "해당 엔진에서 미지원" (compat.zig의 보수적 해석).
+ */
+export declare const SUPPORT: Partial<Record<Feature, Partial<Record<Engine, [number, number]>>>>;
+export type EngineVersion = {
+    engine: Engine;
+    major: number;
+    minor: number;
+};
+/**
+ * 엔진 목록에 대해 unsupported feature bitmask 계산.
+ * 하나라도 미지원인 feature는 set (가장 보수적).
+ */
+export declare function computeUnsupportedFromEngines(engines: EngineVersion[]): number;

package/dist/shared/index.d.ts

@@ -0,0 +1,185 @@
+/**
+ * @zntc/shared — Types and utilities shared by @zntc/core and @zntc/wasm.
+ */
+export type Target = 'es5' | 'es2015' | 'es2016' | 'es2017' | 'es2018' | 'es2019' | 'es2020' | 'es2021' | 'es2022' | 'es2023' | 'es2024' | 'es2025' | 'esnext';
+export type Platform = 'browser' | 'node' | 'neutral' | 'react-native';
+export interface TranspileOptions {
+    /** File path (used for extension detection, default: "input.ts"). */
+    filename?: string;
+    /** Generate a source map. */
+    sourcemap?: boolean;
+    /** Source map Debug ID (Sentry-compatible). */
+    sourcemapDebugIds?: boolean;
+    /** Include the original source in the source map (default: true). */
+    sourcesContent?: boolean;
+    /** Minify whitespace. */
+    minifyWhitespace?: boolean;
+    /** Minify identifiers. */
+    minifyIdentifiers?: boolean;
+    /** Minify syntax. */
+    minifySyntax?: boolean;
+    /** Full minification (whitespace + identifiers + syntax). */
+    minify?: boolean;
+    /** JSX runtime. `'preserve'` emits JSX unchanged — only TypeScript annotations
+     * are stripped. Use this to delegate JSX handling to a downstream tool (e.g.
+     * @vitejs/plugin-react, @preact/preset-vite, vite-plugin-solid). Equivalent to
+     * tsc `"jsx": "preserve"`. */
+    jsx?: 'classic' | 'automatic' | 'automatic-dev' | 'preserve';
+    /** classic-mode JSX factory (default: "React.createElement"). */
+    jsxFactory?: string;
+    /** classic-mode Fragment factory (default: "React.Fragment"). */
+    jsxFragment?: string;
+    /** automatic-mode import source (default: "react"). */
+    jsxImportSource?: string;
+    /** Allow JSX in .js files as well. */
+    jsxInJs?: boolean;
+    /**
+     * React Fast Refresh transform — registers components via
+     * `$RefreshReg$(_c, "Name")`. Equivalent to the SWC builtin
+     * `jsc.transform.react.refresh: true` / babel-plugin-react-refresh component
+     * registration. Used by loaders (rspack-loader, webpack/vite plugin) when
+     * enabled on the single-file transpile path.
+     *
+     * The default behavior is Metro-compatible (registration only, no hook
+     * signatures). The babel/SWC-equivalent hook signature emit is opt-in via
+     * `reactRefreshHookSignatures: true`. Defining the HMR runtime
+     * ($RefreshReg$/$RefreshSig$) is the consumer's responsibility.
+     */
+    reactRefresh?: boolean;
+    /**
+     * On top of `reactRefresh: true`, adds hook signature emit
+     * (`var _s = $RefreshSig$();` + `_s(Component, "sig")`). Equivalent to
+     * babel-plugin-react-refresh. Default false — preserves the Metro policy
+     * (no signatures).
+     *
+     * When enabled, the transformer scans hook calls inside function bodies to
+     * build the signature string, then emits a `_s(Comp, "sig")` call right after
+     * component registration. RN HMR keeps the default (false), so it is
+     * unaffected.
+     */
+    reactRefreshHookSignatures?: boolean;
+    /** Remove console.* calls. */
+    dropConsole?: boolean;
+    /** Remove debugger statements. */
+    dropDebugger?: boolean;
+    /** Escape non-ASCII to \uXXXX. */
+    asciiOnly?: boolean;
+    /** Do not escape non-ASCII. */
+    charsetUtf8?: boolean;
+    /** Strip Flow types. */
+    flow?: boolean;
+    /** legacy decorator transform. */
+    experimentalDecorators?: boolean;
+    /** decorator metadata emit */
+    emitDecoratorMetadata?: boolean;
+    /** Transform class fields → `constructor` this.x = v (default: true). */
+    useDefineForClassFields?: boolean;
+    /** verbatimModuleSyntax (TS 5.0+): when true, unused value imports are not elided. */
+    verbatimModuleSyntax?: boolean;
+    /**
+     * Path to tsconfig.json (file or directory). When set, compilerOptions are
+     * auto-loaded and merged. Fields set explicitly via JS options take
+     * precedence — only unspecified fields are filled from the tsconfig values.
+     * e.g. "./tsconfig.json" or "./project-dir".
+     */
+    tsconfigPath?: string;
+    /**
+     * Inline tsconfig JSON string (same meaning as esbuild's `tsconfigRaw`).
+     * When set, both `tsconfigPath` and autodiscovery are ignored — raw is the
+     * single source of truth. The Zig-side `tsconfig_merge` applies
+     * compilerOptions such as jsx/target/decorators directly.
+     */
+    tsconfigRaw?: string;
+    /** Module format. */
+    format?: 'esm' | 'cjs';
+    /** String quote style. */
+    quotes?: 'double' | 'single' | 'preserve';
+    /** Target platform. */
+    platform?: Platform;
+    /** ES downlevel target. */
+    target?: Target;
+    /**
+     * browserslist query (e.g. "last 2 versions", ">1%, not dead").
+     * Takes precedence over target when set. Resolved only in the core package
+     * (depends on browserslist).
+     */
+    browserslist?: string | string[];
+    /** The source map's sourceRoot field (default: empty string). */
+    sourceRoot?: string;
+    /**
+     * Identifier substitution pairs. `value` is raw JSON (strings must include
+     * the surrounding quotes).
+     * e.g. `[{ key: "process.env.NODE_ENV", value: "\"production\"" }]`
+     */
+    define?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /**
+     * Pipeline early-exit point — for debug/profile. When set, all stages after
+     * the given phase are skipped and empty output is returned. Useful combined
+     * with `profile` to measure a specific phase's cost in isolation.
+     *
+     * - "scan": Scanner token drain only
+     * - "parse": after Parser AST construction
+     * - "semantic": after the Semantic analyzer
+     * - "transform": after the Transformer
+     * - "codegen": full run (same as the default behavior)
+     */
+    stopAfter?: 'scan' | 'parse' | 'semantic' | 'transform' | 'codegen';
+}
+export interface TranspileResult {
+    /** Transformed JavaScript code. */
+    code: string;
+    /** Source map JSON (when sourcemap: true). */
+    map?: string;
+    /**
+     * Full error text rendered in the same format as the CLI when semantic
+     * errors are present. tsc-compatible policy: code is still returned even
+     * when there are errors. Playgrounds/IDEs parse this field to display
+     * markers.
+     */
+    errors?: string;
+}
+export declare const ES_TARGET_BITS: Record<string, number>;
+export declare function targetToUnsupported(target?: Target): number;
+/**
+ * Narrows whether `value` is a plain object (non-null, not an array).
+ * Use this to narrow a value of unknown shape — such as a `JSON.parse` result
+ * or a dynamic config object — to `Record<string, unknown>`. Shared across
+ * functional config / workspace entries / tsconfigRaw validation, etc.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Pre-validates user-supplied `tsconfigRaw` input.
+ *
+ * NAPI (`napi_entry.zig` / `transpile.zig`) silently falls back to an empty
+ * TsConfig on raw parse failure, so an invalid raw passed through looks to the
+ * user as if the option were ignored. Called from both the CLI and JS API
+ * entry points so they uniformly throw the same explicit error
+ * (`failed to parse --tsconfig-raw: ...`). No-op when undefined.
+ */
+export declare function validateTsConfigRaw(raw: string | undefined): void;
+/**
+ * Serializes TranspileOptions into Zig `ConfigOptionsDto` JSON.
+ *
+ * - Default values are omitted (minimizes payload size).
+ * - enum keys match the Zig enum name (e.g. "react-native" → "react_native").
+ * - The browserslist resolution result can be injected as the
+ *   `unsupportedOverride` number. When set, it takes precedence over the
+ *   `target`-based fallback on the Zig side.
+ * - `define` is serialized as a `[{ key, value }]` array (compatible with Zig
+ *   DefineEntry).
+ */
+export declare function buildOptionsJson(opts?: TranspileOptions, unsupportedOverride?: number): string;
+export type { Engine, EngineVersion, Feature } from './compat-engines';
+export { computeUnsupportedFromEngines, FEATURES } from './compat-engines';
+import type { EngineVersion } from './compat-engines';
+/** browserslist result string ("chrome 100", "ios_saf 14.5") → EngineVersion. */
+export declare function parseBrowserslistEntry(entry: string): EngineVersion | null;
+/**
+ * browserslist result string array → unsupported bitmask.
+ * Unmappable engines (samsung, kaios, etc.) are ignored (engines ZNTC does not
+ * target).
+ */
+export declare function browserslistToUnsupported(entries: string[]): number;

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@zntc/core",
+  "version": "0.1.0",
+  "description": "ZNTC native transpiler & compiler binding",
+  "keywords": [
+    "bundler",
+    "compiler",
+    "esbuild",
+    "flow",
+    "javascript",
+    "jsx",
+    "napi",
+    "oxc",
+    "swc",
+    "transpiler",
+    "tsx",
+    "typescript",
+    "zig",
+    "zntc"
+  ],
+  "homepage": "https://ohah.github.io/zntc",
+  "bugs": {
+    "url": "https://github.com/ohah/zntc/issues"
+  },
+  "license": "MIT",
+  "author": "ohah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ohah/zntc.git",
+    "directory": "packages/core"
+  },
+  "bin": {
+    "zntc": "./bin/zntc.mjs"
+  },
+  "source": "./index.ts",
+  "files": [
+    "dist/",
+    "bin/banner.mjs",
+    "bin/cli-flags.mjs",
+    "bin/rn-asset-copy.mjs",
+    "bin/rn-dev-input.mjs",
+    "bin/verify.mjs",
+    "bin/zntc.mjs"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "types": "dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./index.ts",
+      "import": {
+        "types": "./dist/core/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/core/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build:napi": "cd ../.. && zig build napi",
+    "build:js:esm": "bun build index.ts --outdir dist --format esm --target node",
+    "build:js:cjs": "node bin/zntc.mjs --bundle index.ts --outfile dist/index.cjs --format=cjs --platform=node --packages=external",
+    "build:js": "bun run build:js:esm && bun run build:js:cjs",
+    "build:dts": "bun x tsc -b && cp dist/core/index.d.ts dist/core/index.d.cts",
+    "build": "bun run build:js && bun run build:dts",
+    "build:local": "bun run build:napi && cp ../../zig-out/lib/zntc.node . && bun run build:js && bun run build:dts",
+    "postinstall": "[ -f ../../zig-out/lib/zntc.node ] && cp ../../zig-out/lib/zntc.node . || true",
+    "pretest": "bun run --cwd ../server build && bun run --cwd ../web build && bun run --cwd ../react-native build",
+    "test": "bun test --timeout 10000",
+    "prepublishOnly": "bun run build && bunx publint --strict --level error ."
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@zntc/test-helpers": "workspace:*"
+  },
+  "optionalDependencies": {
+    "@zntc/core-darwin-arm64": "0.1.0",
+    "@zntc/core-darwin-x64": "0.1.0",
+    "@zntc/core-linux-arm64-gnu": "0.1.0",
+    "@zntc/core-linux-arm64-musl": "0.1.0",
+    "@zntc/core-linux-x64-gnu": "0.1.0",
+    "@zntc/core-linux-x64-musl": "0.1.0",
+    "@zntc/core-win32-arm64-msvc": "0.1.0",
+    "@zntc/core-win32-ia32-msvc": "0.1.0",
+    "@zntc/core-win32-x64-msvc": "0.1.0",
+    "browserslist": "^4.24.0",
+    "core-js": "^3.49.0",
+    "core-js-compat": "^3.49.0",
+    "lightningcss": "^1.28.0",
+    "playwright": "^1.50.0"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}