@ttsc/metro 0.16.3

package/lib/index.mjs

@@ -0,0 +1,70 @@
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ENV_KEY, serializeOptions } from './core/options.mjs';
+
+/**
+ * `@ttsc/metro` — Metro (React Native / Expo) adapter for ttsc plugins.
+ *
+ * Metro bundles with Babel, which strips TypeScript types and never runs ttsc
+ * plugins, so neither the `ttsc` CLI nor `@ttsc/unplugin` can reach an RN/Expo
+ * build. {@link withTtsc} wires a Metro custom transformer that runs the ttsc
+ * plugin pass on each TypeScript file before handing the result to the
+ * project's existing Expo/React-Native Babel transformer.
+ *
+ * @example
+ *   Expo```js
+ *   // metro.config.js
+ *   const { getDefaultConfig } = require("expo/metro-config");
+ *   const { withTtsc } = require("@ttsc/metro");
+ *
+ *   module.exports = withTtsc(getDefaultConfig(__dirname));
+ *   ```;
+ *
+ * @example
+ *   Bare React Native
+ *   ```js
+ *   // metro.config.js
+ *   const { getDefaultConfig } = require("@react-native/metro-config");
+ *   const { withTtsc } = require("@ttsc/metro");
+ *
+ *   module.exports = withTtsc(getDefaultConfig(__dirname));
+ *   ```
+ */
+/**
+ * Wrap a Metro config so ttsc plugins run on every TypeScript file.
+ *
+ * Sets `transformer.babelTransformerPath` to this package's transformer and
+ * publishes the resolved options to Metro's worker processes via the
+ * {@link ENV_KEY} environment variable (the workers never see this call, so env
+ * is the transport — see `core/options.ts`). Compatible with Expo's
+ * `getDefaultConfig()` and bare React Native alike.
+ *
+ * With no `options`, the transformer auto-discovers `tsconfig.json` and runs
+ * the plugins configured there — the standard ttsc model. Pass `options` only
+ * to override the project path, plugin list, or include/exclude filters.
+ */
+function withTtsc(config, options = {}) {
+    process.env[ENV_KEY] = serializeOptions(options);
+    return {
+        ...config,
+        transformer: {
+            ...config.transformer,
+            babelTransformerPath: transformerModulePath(),
+        },
+    };
+}
+/**
+ * Absolute path to the built transformer module Metro will `require`.
+ *
+ * Always the CommonJS build (`transformer.js`) next to this module: Metro
+ * resolves `babelTransformerPath` with `require`, and `metro.config.js` is a
+ * CommonJS module. Rollup rewrites `import.meta.url` for both the CJS and ESM
+ * builds, so this resolves correctly regardless of how the config loaded this
+ * entry.
+ */
+function transformerModulePath() {
+    return join(dirname(fileURLToPath(import.meta.url)), "transformer.js");
+}
+
+export { withTtsc };
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AAyBH;;;;;;;;;;;;AAYG;SACa,QAAQ,CACtB,MAAS,EACT,UAA4B,EAAE,EAAA;IAE9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAChD,OAAO;AACL,QAAA,GAAG,MAAM;AACT,QAAA,WAAW,EAAE;YACX,GAAG,MAAM,CAAC,WAAW;YACrB,oBAAoB,EAAE,qBAAqB,EAAE;AAC9C,SAAA;KACG;AACR;AAEA;;;;;;;;AAQG;AACH,SAAS,qBAAqB,GAAA;AAC5B,IAAA,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC;AACxE;;;;"}

package/lib/transformer.d.ts

@@ -0,0 +1,52 @@
+import type { ResolvedTtscMetroOptions } from "./core/options";
+/**
+ * Resolve Metro's per-file `filename` to an absolute path.
+ *
+ * Metro hands the babel transformer a path **relative to `projectRoot`** (it
+ * reads the file via `fs.readFileSync(path.resolve(projectRoot, filename))`)
+ * and passes `projectRoot` inside `options`. The ttsc pass needs an absolute
+ * path that matches a key in the compiled program, so resolve against
+ * `projectRoot` — never `process.cwd()`, which differs from `projectRoot` in
+ * monorepos and when Metro is launched from a parent directory. Getting this
+ * wrong makes every file look "outside the project" and silently skips the
+ * plugin pass.
+ */
+export declare function resolveAbsoluteFilename(filename: string, options?: Record<string, unknown>): string;
+/**
+ * Metro transform entry point.
+ *
+ * Runs the ttsc plugin pass on TypeScript files, then delegates to the upstream
+ * Expo/React-Native Babel transformer to produce the AST Metro expects. The
+ * upstream call receives Metro's original params (notably the project-relative
+ * `filename`, which Babel expects); only `src` is replaced with the
+ * ttsc-transformed source.
+ */
+export declare function transform(params: {
+    src: string;
+    filename: string;
+    options: Record<string, unknown>;
+    [key: string]: unknown;
+}): Promise<{
+    ast: object;
+}>;
+/**
+ * Metro transform-cache key.
+ *
+ * Metro already content-hashes each file, so this only has to invalidate when
+ * the transformer itself changes: package version + resolved options + the
+ * upstream transformer's own key (forwarded Metro's args, e.g. `projectRoot`,
+ * so a `babel.config.js` change still busts the cache). Resolving the upstream
+ * is deliberately non-fatal here — a missing peer must not crash cache-key
+ * computation. NOTE: this does not encode the tsconfig / plugin configuration
+ * or cross-file type dependencies, so after editing those (or a depended-upon
+ * type) run Metro with `--reset-cache`. See the README "Caveats" and
+ * samchon/ttsc#255.
+ */
+export declare function getCacheKey(...args: unknown[]): string;
+/**
+ * Decide whether a file should run through the ttsc pass. Only TypeScript
+ * sources (`.ts`/`.tsx`/`.cts`/`.mts`, excluding `.d.ts`) qualify; `exclude`
+ * substrings win over `include`, and an empty `include` means "all TypeScript".
+ * Exported for unit testing.
+ */
+export declare function shouldTransform(filename: string, opts: ResolvedTtscMetroOptions): boolean;

package/lib/transformer.js

@@ -0,0 +1,217 @@
+'use strict';
+
+var api = require('@ttsc/unplugin/api');
+var node_crypto = require('node:crypto');
+var node_module = require('node:module');
+var path = require('node:path');
+var options$1 = require('./core/options.js');
+var upstream = require('./core/upstream.js');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+/**
+ * Metro custom transformer for ttsc.
+ *
+ * Metro loads this module via `transformer.babelTransformerPath` (wired by
+ * {@link withTtsc}) and calls {@link transform} once per file. The flow is:
+ *
+ * TypeScript source -> ttsc plugin pass (typia, nestia, …) via @ttsc/unplugin's
+ * core -> transformed TypeScript source -> upstream Expo/RN Babel transformer
+ * (strips types, RN transforms) -> Babel AST (what Metro consumes)
+ *
+ * The ttsc pass reuses `@ttsc/unplugin`'s `transformTtsc`, so the plugin
+ * contract, tsconfig discovery, and per-build cache are identical to every
+ * other bundler integration. See the package README for the v1 cost model and
+ * the cross-file cache-invalidation caveat.
+ */
+const nodeRequire = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('transformer.js', document.baseURI).href)));
+/**
+ * Matches the TypeScript source extensions the ttsc pass handles (`.ts`,
+ * `.tsx`, `.cts`, `.mts`). JavaScript and declaration files are passed straight
+ * through to the upstream transformer.
+ */
+const TS_EXTENSION = /\.[cm]?tsx?$/;
+const DECLARATION = /\.d\.[cm]?ts$/;
+/**
+ * Per-worker singletons. Metro loads this module once per worker process and
+ * reuses it across every file that worker handles, so the resolved options, the
+ * transform cache, and the memoised `@ttsc/unplugin` options are all scoped to
+ * the worker.
+ */
+let resolved;
+let unpluginOptions;
+const cache = api.createTtscTransformCache();
+/** Lazily resolve the worker-side options (from {@link resolveOptionsFromEnv}). */
+function options() {
+    return (resolved ??= options$1.resolveOptionsFromEnv());
+}
+/**
+ * Resolve Metro's per-file `filename` to an absolute path.
+ *
+ * Metro hands the babel transformer a path **relative to `projectRoot`** (it
+ * reads the file via `fs.readFileSync(path.resolve(projectRoot, filename))`)
+ * and passes `projectRoot` inside `options`. The ttsc pass needs an absolute
+ * path that matches a key in the compiled program, so resolve against
+ * `projectRoot` — never `process.cwd()`, which differs from `projectRoot` in
+ * monorepos and when Metro is launched from a parent directory. Getting this
+ * wrong makes every file look "outside the project" and silently skips the
+ * plugin pass.
+ */
+function resolveAbsoluteFilename(filename, options) {
+    if (path.isAbsolute(filename)) {
+        return filename;
+    }
+    const projectRoot = options !== undefined && typeof options.projectRoot === "string"
+        ? options.projectRoot
+        : process.cwd();
+    return path.resolve(projectRoot, filename);
+}
+/**
+ * Metro transform entry point.
+ *
+ * Runs the ttsc plugin pass on TypeScript files, then delegates to the upstream
+ * Expo/React-Native Babel transformer to produce the AST Metro expects. The
+ * upstream call receives Metro's original params (notably the project-relative
+ * `filename`, which Babel expects); only `src` is replaced with the
+ * ttsc-transformed source.
+ */
+async function transform(params) {
+    const opts = options();
+    const upstream$1 = upstream.resolveUpstreamTransformer(opts.upstreamTransformer);
+    // Gate on the project-relative path Metro supplies, so include/exclude
+    // substrings match what the user writes (e.g. "src/generated") and never
+    // collide with an absolute ancestor directory name. The absolute path is used
+    // only to address the file inside the compiled program.
+    if (!shouldTransform(params.filename, opts)) {
+        return upstream$1.transform(params);
+    }
+    let transformedSrc = params.src;
+    try {
+        unpluginOptions ??= api.resolveOptions(opts.ttsc);
+        const result = await api.transformTtsc(resolveAbsoluteFilename(params.filename, params.options), params.src, unpluginOptions, undefined, cache);
+        if (result !== undefined && typeof result.code === "string") {
+            transformedSrc = result.code;
+        }
+    }
+    catch (error) {
+        // A file that is not part of the tsconfig program is not a build error —
+        // pass it through untransformed. Genuine compile/type failures propagate so
+        // Metro surfaces them, matching the other ttsc bundler integrations.
+        if (!isFileOutsideProject(error)) {
+            throw error;
+        }
+    }
+    return upstream$1.transform({ ...params, src: transformedSrc });
+}
+/**
+ * Metro transform-cache key.
+ *
+ * Metro already content-hashes each file, so this only has to invalidate when
+ * the transformer itself changes: package version + resolved options + the
+ * upstream transformer's own key (forwarded Metro's args, e.g. `projectRoot`,
+ * so a `babel.config.js` change still busts the cache). Resolving the upstream
+ * is deliberately non-fatal here — a missing peer must not crash cache-key
+ * computation. NOTE: this does not encode the tsconfig / plugin configuration
+ * or cross-file type dependencies, so after editing those (or a depended-upon
+ * type) run Metro with `--reset-cache`. See the README "Caveats" and
+ * samchon/ttsc#255.
+ */
+function getCacheKey(...args) {
+    const opts = options();
+    const hash = node_crypto.createHash("sha256");
+    hash.update(`@ttsc/metro:${packageVersion()}`);
+    hash.update(stableStringify({
+        ttsc: opts.ttsc,
+        include: opts.include,
+        exclude: opts.exclude,
+        upstreamTransformer: opts.upstreamTransformer ?? null,
+    }));
+    const upstreamKey = upstreamCacheKey(opts.upstreamTransformer, args);
+    if (upstreamKey.length !== 0) {
+        hash.update(upstreamKey);
+    }
+    return hash.digest("hex");
+}
+/**
+ * Fold the upstream transformer's cache key in, defensively. Forwards Metro's
+ * own `getCacheKey` arguments so the upstream's babelrc-derived key is
+ * preserved, and never throws: a missing peer or a throwing upstream
+ * `getCacheKey` yields an empty contribution rather than failing the whole
+ * build's cache keying.
+ */
+function upstreamCacheKey(upstreamTransformer, args) {
+    let upstream$1;
+    try {
+        upstream$1 = upstream.resolveUpstreamTransformer(upstreamTransformer);
+    }
+    catch {
+        return "";
+    }
+    if (upstream$1.getCacheKey === undefined) {
+        return "";
+    }
+    try {
+        return String(upstream$1.getCacheKey(...args) ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Decide whether a file should run through the ttsc pass. Only TypeScript
+ * sources (`.ts`/`.tsx`/`.cts`/`.mts`, excluding `.d.ts`) qualify; `exclude`
+ * substrings win over `include`, and an empty `include` means "all TypeScript".
+ * Exported for unit testing.
+ */
+function shouldTransform(filename, opts) {
+    if (!TS_EXTENSION.test(filename) || DECLARATION.test(filename)) {
+        return false;
+    }
+    if (opts.exclude.some((pattern) => filename.includes(pattern))) {
+        return false;
+    }
+    if (opts.include.length !== 0 &&
+        !opts.include.some((pattern) => filename.includes(pattern))) {
+        return false;
+    }
+    return true;
+}
+/**
+ * `transformTtsc` throws `"ttsc transform did not return output for <file>"`
+ * when the requested file is not part of the compiled program (e.g. excluded
+ * from the tsconfig). That case is non-fatal — the file should pass through.
+ */
+function isFileOutsideProject(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes("did not return output");
+}
+function packageVersion() {
+    try {
+        const pkg = nodeRequire("@ttsc/metro/package.json");
+        return pkg.version ?? "0";
+    }
+    catch {
+        return "0";
+    }
+}
+/**
+ * JSON-serialise with object keys sorted recursively, so two semantically equal
+ * option sets always hash to the same cache key regardless of property order.
+ */
+function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    if (value !== null && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+
+exports.getCacheKey = getCacheKey;
+exports.resolveAbsoluteFilename = resolveAbsoluteFilename;
+exports.shouldTransform = shouldTransform;
+exports.transform = transform;
+//# sourceMappingURL=transformer.js.map

package/lib/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sources":["../src/transformer.ts"],"sourcesContent":[null],"names":["createRequire","createTtscTransformCache","resolveOptionsFromEnv","upstream","resolveUpstreamTransformer","resolveOptions","transformTtsc","createHash"],"mappings":";;;;;;;;;;AAAA;;;;;;;;;;;;;;AAcG;AAcH,MAAM,WAAW,GAAGA,yBAAa,CAAC,gQAAe,CAAC;AAElD;;;;AAIG;AACH,MAAM,YAAY,GAAG,cAAc;AACnC,MAAM,WAAW,GAAG,eAAe;AAEnC;;;;;AAKG;AACH,IAAI,QAA8C;AAClD,IAAI,eAA8D;AAClE,MAAM,KAAK,GAAGC,4BAAwB,EAAE;AAExC;AACA,SAAS,OAAO,GAAA;AACd,IAAA,QAAQ,QAAQ,KAAKC,+BAAqB,EAAE;AAC9C;AAEA;;;;;;;;;;;AAWG;AACG,SAAU,uBAAuB,CACrC,QAAgB,EAChB,OAAiC,EAAA;AAEjC,IAAA,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;AAC7B,QAAA,OAAO,QAAQ;IACjB;IACA,MAAM,WAAW,GACf,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK;UACpD,OAAO,CAAC;AACV,UAAE,OAAO,CAAC,GAAG,EAAE;IACnB,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;AAC5C;AAEA;;;;;;;;AAQG;AACI,eAAe,SAAS,CAAC,MAK/B,EAAA;AACC,IAAA,MAAM,IAAI,GAAG,OAAO,EAAE;IACtB,MAAMC,UAAQ,GAAGC,mCAA0B,CAAC,IAAI,CAAC,mBAAmB,CAAC;;;;;IAMrE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;AAC3C,QAAA,OAAOD,UAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;IACnC;AAEA,IAAA,IAAI,cAAc,GAAG,MAAM,CAAC,GAAG;AAC/B,IAAA,IAAI;AACF,QAAA,eAAe,KAAKE,kBAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAMC,iBAAa,CAChC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EACxD,MAAM,CAAC,GAAG,EACV,eAAe,EACf,SAAS,EACT,KAAK,CACN;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC3D,YAAA,cAAc,GAAG,MAAM,CAAC,IAAI;QAC9B;IACF;IAAE,OAAO,KAAK,EAAE;;;;AAId,QAAA,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE;AAChC,YAAA,MAAM,KAAK;QACb;IACF;AAEA,IAAA,OAAOH,UAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;AAC/D;AAEA;;;;;;;;;;;;AAYG;AACG,SAAU,WAAW,CAAC,GAAG,IAAe,EAAA;AAC5C,IAAA,MAAM,IAAI,GAAG,OAAO,EAAE;AACtB,IAAA,MAAM,IAAI,GAAGI,sBAAU,CAAC,QAAQ,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,CAAA,YAAA,EAAe,cAAc,EAAE,CAAA,CAAE,CAAC;AAC9C,IAAA,IAAI,CAAC,MAAM,CACT,eAAe,CAAC;QACd,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;AACrB,QAAA,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,IAAI,IAAI;AACtD,KAAA,CAAC,CACH;IACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC;AACpE,IAAA,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;AAC5B,QAAA,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAC1B;AACA,IAAA,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAC3B;AAEA;;;;;;AAMG;AACH,SAAS,gBAAgB,CACvB,mBAAuC,EACvC,IAAe,EAAA;AAEf,IAAA,IAAIJ,UAAQ;AACZ,IAAA,IAAI;AACF,QAAAA,UAAQ,GAAGC,mCAA0B,CAAC,mBAAmB,CAAC;IAC5D;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACA,IAAA,IAAID,UAAQ,CAAC,WAAW,KAAK,SAAS,EAAE;AACtC,QAAA,OAAO,EAAE;IACX;AACA,IAAA,IAAI;AACF,QAAA,OAAO,MAAM,CAACA,UAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACF;AAEA;;;;;AAKG;AACG,SAAU,eAAe,CAC7B,QAAgB,EAChB,IAA8B,EAAA;AAE9B,IAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;AAC9D,QAAA,OAAO,KAAK;IACd;AACA,IAAA,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE;AAC9D,QAAA,OAAO,KAAK;IACd;AACA,IAAA,IACE,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;AACzB,QAAA,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAC3D;AACA,QAAA,OAAO,KAAK;IACd;AACA,IAAA,OAAO,IAAI;AACb;AAEA;;;;AAIG;AACH,SAAS,oBAAoB,CAAC,KAAc,EAAA;AAC1C,IAAA,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;AACtE,IAAA,OAAO,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;AAClD;AAEA,SAAS,cAAc,GAAA;AACrB,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,GAAG,WAAW,CAAC,0BAA0B,CAAyB;AAC3E,QAAA,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG;IAC3B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,GAAG;IACZ;AACF;AAEA;;;AAGG;AACH,SAAS,eAAe,CAAC,KAAc,EAAA;AACrC,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,QAAA,OAAO,CAAA,CAAA,EAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;IACpD;IACA,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC/C,QAAA,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK;AAC5B,aAAA,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aAC/C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAA,EAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA,CAAA,EAAI,eAAe,CAAC,IAAI,CAAC,CAAA,CAAE;AACtE,aAAA,IAAI,CAAC,GAAG,CAAC,CAAA,CAAA,CAAG;IACjB;AACA,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;AAC9B;;;;;;;"}

package/lib/transformer.mjs

@@ -0,0 +1,211 @@
+import { createTtscTransformCache, resolveOptions, transformTtsc } from '@ttsc/unplugin/api';
+import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { resolveOptionsFromEnv } from './core/options.mjs';
+import { resolveUpstreamTransformer } from './core/upstream.mjs';
+
+/**
+ * Metro custom transformer for ttsc.
+ *
+ * Metro loads this module via `transformer.babelTransformerPath` (wired by
+ * {@link withTtsc}) and calls {@link transform} once per file. The flow is:
+ *
+ * TypeScript source -> ttsc plugin pass (typia, nestia, …) via @ttsc/unplugin's
+ * core -> transformed TypeScript source -> upstream Expo/RN Babel transformer
+ * (strips types, RN transforms) -> Babel AST (what Metro consumes)
+ *
+ * The ttsc pass reuses `@ttsc/unplugin`'s `transformTtsc`, so the plugin
+ * contract, tsconfig discovery, and per-build cache are identical to every
+ * other bundler integration. See the package README for the v1 cost model and
+ * the cross-file cache-invalidation caveat.
+ */
+const nodeRequire = createRequire(import.meta.url);
+/**
+ * Matches the TypeScript source extensions the ttsc pass handles (`.ts`,
+ * `.tsx`, `.cts`, `.mts`). JavaScript and declaration files are passed straight
+ * through to the upstream transformer.
+ */
+const TS_EXTENSION = /\.[cm]?tsx?$/;
+const DECLARATION = /\.d\.[cm]?ts$/;
+/**
+ * Per-worker singletons. Metro loads this module once per worker process and
+ * reuses it across every file that worker handles, so the resolved options, the
+ * transform cache, and the memoised `@ttsc/unplugin` options are all scoped to
+ * the worker.
+ */
+let resolved;
+let unpluginOptions;
+const cache = createTtscTransformCache();
+/** Lazily resolve the worker-side options (from {@link resolveOptionsFromEnv}). */
+function options() {
+    return (resolved ??= resolveOptionsFromEnv());
+}
+/**
+ * Resolve Metro's per-file `filename` to an absolute path.
+ *
+ * Metro hands the babel transformer a path **relative to `projectRoot`** (it
+ * reads the file via `fs.readFileSync(path.resolve(projectRoot, filename))`)
+ * and passes `projectRoot` inside `options`. The ttsc pass needs an absolute
+ * path that matches a key in the compiled program, so resolve against
+ * `projectRoot` — never `process.cwd()`, which differs from `projectRoot` in
+ * monorepos and when Metro is launched from a parent directory. Getting this
+ * wrong makes every file look "outside the project" and silently skips the
+ * plugin pass.
+ */
+function resolveAbsoluteFilename(filename, options) {
+    if (path.isAbsolute(filename)) {
+        return filename;
+    }
+    const projectRoot = options !== undefined && typeof options.projectRoot === "string"
+        ? options.projectRoot
+        : process.cwd();
+    return path.resolve(projectRoot, filename);
+}
+/**
+ * Metro transform entry point.
+ *
+ * Runs the ttsc plugin pass on TypeScript files, then delegates to the upstream
+ * Expo/React-Native Babel transformer to produce the AST Metro expects. The
+ * upstream call receives Metro's original params (notably the project-relative
+ * `filename`, which Babel expects); only `src` is replaced with the
+ * ttsc-transformed source.
+ */
+async function transform(params) {
+    const opts = options();
+    const upstream = resolveUpstreamTransformer(opts.upstreamTransformer);
+    // Gate on the project-relative path Metro supplies, so include/exclude
+    // substrings match what the user writes (e.g. "src/generated") and never
+    // collide with an absolute ancestor directory name. The absolute path is used
+    // only to address the file inside the compiled program.
+    if (!shouldTransform(params.filename, opts)) {
+        return upstream.transform(params);
+    }
+    let transformedSrc = params.src;
+    try {
+        unpluginOptions ??= resolveOptions(opts.ttsc);
+        const result = await transformTtsc(resolveAbsoluteFilename(params.filename, params.options), params.src, unpluginOptions, undefined, cache);
+        if (result !== undefined && typeof result.code === "string") {
+            transformedSrc = result.code;
+        }
+    }
+    catch (error) {
+        // A file that is not part of the tsconfig program is not a build error —
+        // pass it through untransformed. Genuine compile/type failures propagate so
+        // Metro surfaces them, matching the other ttsc bundler integrations.
+        if (!isFileOutsideProject(error)) {
+            throw error;
+        }
+    }
+    return upstream.transform({ ...params, src: transformedSrc });
+}
+/**
+ * Metro transform-cache key.
+ *
+ * Metro already content-hashes each file, so this only has to invalidate when
+ * the transformer itself changes: package version + resolved options + the
+ * upstream transformer's own key (forwarded Metro's args, e.g. `projectRoot`,
+ * so a `babel.config.js` change still busts the cache). Resolving the upstream
+ * is deliberately non-fatal here — a missing peer must not crash cache-key
+ * computation. NOTE: this does not encode the tsconfig / plugin configuration
+ * or cross-file type dependencies, so after editing those (or a depended-upon
+ * type) run Metro with `--reset-cache`. See the README "Caveats" and
+ * samchon/ttsc#255.
+ */
+function getCacheKey(...args) {
+    const opts = options();
+    const hash = createHash("sha256");
+    hash.update(`@ttsc/metro:${packageVersion()}`);
+    hash.update(stableStringify({
+        ttsc: opts.ttsc,
+        include: opts.include,
+        exclude: opts.exclude,
+        upstreamTransformer: opts.upstreamTransformer ?? null,
+    }));
+    const upstreamKey = upstreamCacheKey(opts.upstreamTransformer, args);
+    if (upstreamKey.length !== 0) {
+        hash.update(upstreamKey);
+    }
+    return hash.digest("hex");
+}
+/**
+ * Fold the upstream transformer's cache key in, defensively. Forwards Metro's
+ * own `getCacheKey` arguments so the upstream's babelrc-derived key is
+ * preserved, and never throws: a missing peer or a throwing upstream
+ * `getCacheKey` yields an empty contribution rather than failing the whole
+ * build's cache keying.
+ */
+function upstreamCacheKey(upstreamTransformer, args) {
+    let upstream;
+    try {
+        upstream = resolveUpstreamTransformer(upstreamTransformer);
+    }
+    catch {
+        return "";
+    }
+    if (upstream.getCacheKey === undefined) {
+        return "";
+    }
+    try {
+        return String(upstream.getCacheKey(...args) ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Decide whether a file should run through the ttsc pass. Only TypeScript
+ * sources (`.ts`/`.tsx`/`.cts`/`.mts`, excluding `.d.ts`) qualify; `exclude`
+ * substrings win over `include`, and an empty `include` means "all TypeScript".
+ * Exported for unit testing.
+ */
+function shouldTransform(filename, opts) {
+    if (!TS_EXTENSION.test(filename) || DECLARATION.test(filename)) {
+        return false;
+    }
+    if (opts.exclude.some((pattern) => filename.includes(pattern))) {
+        return false;
+    }
+    if (opts.include.length !== 0 &&
+        !opts.include.some((pattern) => filename.includes(pattern))) {
+        return false;
+    }
+    return true;
+}
+/**
+ * `transformTtsc` throws `"ttsc transform did not return output for <file>"`
+ * when the requested file is not part of the compiled program (e.g. excluded
+ * from the tsconfig). That case is non-fatal — the file should pass through.
+ */
+function isFileOutsideProject(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes("did not return output");
+}
+function packageVersion() {
+    try {
+        const pkg = nodeRequire("@ttsc/metro/package.json");
+        return pkg.version ?? "0";
+    }
+    catch {
+        return "0";
+    }
+}
+/**
+ * JSON-serialise with object keys sorted recursively, so two semantically equal
+ * option sets always hash to the same cache key regardless of property order.
+ */
+function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableStringify).join(",")}]`;
+    }
+    if (value !== null && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+
+export { getCacheKey, resolveAbsoluteFilename, shouldTransform, transform };
+//# sourceMappingURL=transformer.mjs.map

package/lib/transformer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.mjs","sources":["../src/transformer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@ttsc/metro",
+  "version": "0.16.3",
+  "description": "Metro (React Native / Expo) adapter for ttsc plugins.",
+  "main": "lib/index.js",
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs",
+      "default": "./lib/index.js"
+    },
+    "./transformer": {
+      "types": "./lib/transformer.d.ts",
+      "import": "./lib/transformer.mjs",
+      "default": "./lib/transformer.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "ttsc",
+    "metro",
+    "react-native",
+    "expo",
+    "typescript",
+    "tsgo"
+  ],
+  "files": [
+    "README.md",
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@ttsc/unplugin": "0.16.3"
+  },
+  "peerDependencies": {
+    "@expo/metro-config": "*",
+    "@react-native/metro-babel-transformer": "*",
+    "metro-react-native-babel-transformer": "*"
+  },
+  "peerDependenciesMeta": {
+    "@expo/metro-config": {
+      "optional": true
+    },
+    "@react-native/metro-babel-transformer": {
+      "optional": true
+    },
+    "metro-react-native-babel-transformer": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@types/node": "^25.3.0",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.60.3",
+    "rollup-plugin-auto-external": "^2.0.0",
+    "rollup-plugin-node-externals": "^9.0.1",
+    "tinyglobby": "^0.2.16",
+    "tslib": "^2.8.1",
+    "typescript": "7.0.1-rc",
+    "ttsc": "0.16.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/ttsc"
+  },
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/ttsc/issues"
+  },
+  "homepage": "https://ttsc.dev",
+  "sideEffects": false,
+  "scripts": {
+    "build": "rimraf lib && tsc --emitDeclarationOnly && rollup -c"
+  }
+}