tsnv 0.0.0-dev.20260119180902

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Geunhyeok LEE
+
+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,162 @@
+<div align="center">
+
+# tsnv
+
+Modern bundler for React Native libraries - fast, platform-aware, zero-config<br>
+(powered by [Rolldown](https://rolldown.rs))
+
+</div>
+
+> [!NOTE]
+> This project is under development
+
+## Features
+
+- **Fast** - Powered by [Rolldown](https://rolldown.rs), a Rust-based bundler
+- **Platform-aware** - Automatic handling of platform-specific modules (`.android.ts`, `.ios.ts`, `.native.ts`)
+- **Dual format** - Supports both CommonJS and ESM output
+- **TypeScript** - First-class TypeScript support with automatic `.d.ts` generation
+- **Zero-config** - Sensible defaults that just work
+- **Yarn PnP** - Works seamlessly with Yarn Plug'n'Play
+
+## Installation
+
+```bash
+# npm
+npm i -D tsnv
+
+# pnpm
+pnpm add -D tsnv
+
+# yarn
+yarn add -D tsnv
+```
+
+## Quick Start
+
+Just run:
+
+```bash
+npx tsnv
+```
+
+That's it. tsnv works out of the box with sensible defaults:
+
+- Source directory: `src`
+- Output directory: `dist`
+- Format: ESM
+- TypeScript declarations: enabled
+
+### Custom Configuration (Optional)
+
+If you need to customize the build, create a `tsnv.config.ts`:
+
+```ts
+import { defineConfig } from 'tsnv';
+
+export default defineConfig({
+  format: ['esm', 'cjs'],
+  sourcemap: true,
+});
+```
+
+## Configuration
+
+All configuration options with their default values:
+
+```ts
+import { defineConfig } from 'tsnv';
+
+export default defineConfig({
+  // Source directory
+  source: 'src',
+
+  // Output directory
+  outDir: 'dist',
+
+  // Output format: 'esm', 'cjs', or ['esm', 'cjs']
+  format: 'esm',
+
+  // Generate TypeScript declaration files
+  dts: true,
+
+  // Platform specifiers for module resolution
+  specifiers: ['android', 'ios', 'native'],
+
+  // Source file extensions
+  sourceExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
+
+  // Asset file extensions (Metro defaults)
+  assetExtensions: ['bmp', 'gif', 'jpg', 'jpeg', 'png', 'psd', 'svg', 'webp' /* ... */],
+
+  // Files to exclude from the build
+  exclude: /__(?:tests?|fixtures?|mocks?)__/,
+
+  // Generate source maps
+  sourcemap: false,
+
+  // Clean output directory before build
+  clean: true,
+
+  // Code injection options
+  banner: undefined,
+  footer: undefined,
+  intro: undefined,
+  outro: undefined,
+
+  // Experimental options
+  experimental: {
+    tsgo: false, // Use tsgo compiler
+  },
+});
+```
+
+## Output Structure
+
+### ESM only (`format: 'esm'`)
+
+```
+dist/
+├── index.js
+├── greeting.android.js
+├── greeting.ios.js
+└── types/
+    ├── index.d.ts
+    ├── greeting.android.d.ts
+    └── greeting.ios.d.ts
+```
+
+### CommonJS only (`format: 'cjs'`)
+
+```
+dist/
+├── index.js
+├── greeting.android.js
+├── greeting.ios.js
+└── types/
+    ├── index.d.ts
+    ├── greeting.android.d.ts
+    └── greeting.ios.d.ts
+```
+
+### Dual format (`format: ['esm', 'cjs']`)
+
+```
+dist/
+├── esm/
+│   ├── index.js
+│   ├── greeting.android.js
+│   └── greeting.ios.js
+├── cjs/
+│   ├── index.js
+│   ├── greeting.android.js
+│   └── greeting.ios.js
+└── types/
+    ├── index.d.ts
+    ├── greeting.android.d.ts
+    └── greeting.ios.d.ts
+```
+
+## License
+
+[MIT](./LICENSE)

package/bin.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import './dist/index.js';

package/dist/config.cjs

@@ -0,0 +1,8 @@
+
+//#region src/config.ts
+function defineConfig(config) {
+	return config;
+}
+
+//#endregion
+exports.defineConfig = defineConfig;

package/dist/config.d.cts

@@ -0,0 +1,97 @@
+import { OutputOptions } from "rolldown";
+
+//#region src/types.d.ts
+type Format = 'esm' | 'cjs';
+//#endregion
+//#region src/config/types.d.ts
+interface Config {
+  /**
+       * Defaults to `'src'`
+       */
+  source?: string;
+  /**
+       * The directory where output files will be written.
+       *
+       * Defaults to `'dist'`
+       */
+  outDir?: string;
+  /**
+       * Files to exclude from the build.
+       *
+       * Defaults to `/__(?:tests?|fixtures?|mocks?)__/`
+       */
+  exclude?: RegExp;
+  /**
+       * Expected format of generated code.
+       *
+       * Defaults to `'esm'`
+       */
+  format?: Format | Format[];
+  /**
+       * Specifiers to resolve platform specific modules.
+       *
+       * Defaults to `['android', 'ios', 'native']`
+       */
+  specifiers?: string[];
+  /**
+       * Source files extensions.
+       *
+       * Defaults to `['ts', 'tsx', 'js', 'jsx', 'json']`
+       */
+  sourceExtensions?: string[];
+  /**
+       * Asset files extensions.
+       *
+       * Default to following extensions: [Metro's default asset extensions](https://github.com/facebook/metro/blob/v0.83.3/packages/metro-config/src/defaults/defaults.js)
+       */
+  assetExtensions?: string[];
+  /**
+       * Enables generation of TypeScript declaration files (.d.ts).
+       *
+       * Defaults to `true`
+       */
+  dts?: boolean;
+  /**
+       * Generate source map files.
+       */
+  sourcemap?: OutputOptions['sourcemap'];
+  /**
+       * Code to prepend to the beginning of each output chunk.
+       */
+  banner?: OutputOptions['banner'];
+  /**
+       * Code to append to the end of each output chunk.
+       */
+  footer?: OutputOptions['footer'];
+  /**
+       * Code to prepend inside the wrapper function (after banner, before actual code).
+       */
+  intro?: OutputOptions['intro'];
+  /**
+       * Code to append inside the wrapper function (after actual code, before footer).
+       */
+  outro?: OutputOptions['outro'];
+  /**
+       * Clean output directory before build.
+       *
+       * Defaults to `true`
+       */
+  clean?: boolean;
+  /**
+       * Experimental configuration.
+       */
+  experimental?: ExperimentalConfig;
+}
+interface ExperimentalConfig {
+  /**
+       * Whether to use the tsgo compiler.
+       *
+       * To use this option, make sure `@typescript/native-preview` is installed as a dependency.
+       */
+  tsgo?: boolean;
+}
+//#endregion
+//#region src/config.d.ts
+declare function defineConfig(config: Config): Config;
+//#endregion
+export { defineConfig };

package/dist/config.d.ts

@@ -0,0 +1,97 @@
+import { OutputOptions } from "rolldown";
+
+//#region src/types.d.ts
+type Format = 'esm' | 'cjs';
+//#endregion
+//#region src/config/types.d.ts
+interface Config {
+  /**
+       * Defaults to `'src'`
+       */
+  source?: string;
+  /**
+       * The directory where output files will be written.
+       *
+       * Defaults to `'dist'`
+       */
+  outDir?: string;
+  /**
+       * Files to exclude from the build.
+       *
+       * Defaults to `/__(?:tests?|fixtures?|mocks?)__/`
+       */
+  exclude?: RegExp;
+  /**
+       * Expected format of generated code.
+       *
+       * Defaults to `'esm'`
+       */
+  format?: Format | Format[];
+  /**
+       * Specifiers to resolve platform specific modules.
+       *
+       * Defaults to `['android', 'ios', 'native']`
+       */
+  specifiers?: string[];
+  /**
+       * Source files extensions.
+       *
+       * Defaults to `['ts', 'tsx', 'js', 'jsx', 'json']`
+       */
+  sourceExtensions?: string[];
+  /**
+       * Asset files extensions.
+       *
+       * Default to following extensions: [Metro's default asset extensions](https://github.com/facebook/metro/blob/v0.83.3/packages/metro-config/src/defaults/defaults.js)
+       */
+  assetExtensions?: string[];
+  /**
+       * Enables generation of TypeScript declaration files (.d.ts).
+       *
+       * Defaults to `true`
+       */
+  dts?: boolean;
+  /**
+       * Generate source map files.
+       */
+  sourcemap?: OutputOptions['sourcemap'];
+  /**
+       * Code to prepend to the beginning of each output chunk.
+       */
+  banner?: OutputOptions['banner'];
+  /**
+       * Code to append to the end of each output chunk.
+       */
+  footer?: OutputOptions['footer'];
+  /**
+       * Code to prepend inside the wrapper function (after banner, before actual code).
+       */
+  intro?: OutputOptions['intro'];
+  /**
+       * Code to append inside the wrapper function (after actual code, before footer).
+       */
+  outro?: OutputOptions['outro'];
+  /**
+       * Clean output directory before build.
+       *
+       * Defaults to `true`
+       */
+  clean?: boolean;
+  /**
+       * Experimental configuration.
+       */
+  experimental?: ExperimentalConfig;
+}
+interface ExperimentalConfig {
+  /**
+       * Whether to use the tsgo compiler.
+       *
+       * To use this option, make sure `@typescript/native-preview` is installed as a dependency.
+       */
+  tsgo?: boolean;
+}
+//#endregion
+//#region src/config.d.ts
+declare function defineConfig(config: Config): Config;
+//#endregion
+export { defineConfig };

package/dist/config.js

@@ -0,0 +1,7 @@
+//#region src/config.ts
+function defineConfig(config) {
+	return config;
+}
+
+//#endregion
+export { defineConfig };

package/dist/index.js

@@ -0,0 +1,301 @@
+import { loadConfig } from "c12";
+import { createDebug } from "obug";
+import fs, { globSync } from "node:fs";
+import * as pkg from "empathic/package";
+import { build } from "rolldown";
+import path from "node:path";
+import { dts } from "rolldown-plugin-dts";
+
+//#region src/common.ts
+const debug$3 = createDebug("tsnv:common");
+
+//#endregion
+//#region src/config/default.ts
+const DEFAULT_CONFIG = {
+	source: "src",
+	outDir: "dist",
+	exclude: /__(?:tests?|fixtures?|mocks?)__/,
+	format: "esm",
+	specifiers: [
+		"android",
+		"ios",
+		"native"
+	],
+	sourceExtensions: [
+		"ts",
+		"tsx",
+		"js",
+		"jsx",
+		"json"
+	],
+	assetExtensions: [
+		"bmp",
+		"gif",
+		"jpg",
+		"jpeg",
+		"png",
+		"psd",
+		"svg",
+		"webp",
+		"xml",
+		"m4v",
+		"mov",
+		"mp4",
+		"mpeg",
+		"mpg",
+		"webm",
+		"aac",
+		"aiff",
+		"caf",
+		"m4a",
+		"mp3",
+		"wav",
+		"html",
+		"pdf",
+		"yaml",
+		"yml",
+		"otf",
+		"ttf",
+		"zip"
+	],
+	dts: true,
+	clean: true
+};
+
+//#endregion
+//#region ../../../.yarn/berry/cache/es-toolkit-npm-1.43.0-b8f13c51d9-10c0.zip/node_modules/es-toolkit/dist/util/invariant.mjs
+function invariant(condition, message) {
+	if (condition) return;
+	if (typeof message === "string") throw new Error(message);
+	throw message;
+}
+
+//#endregion
+//#region src/context.ts
+async function resolveContext(cwd) {
+	const packageJsonPath = pkg.up({ cwd });
+	invariant(packageJsonPath, "could not find package.json");
+	const rawPackageJson = await fs.promises.readFile(packageJsonPath, "utf-8");
+	const packageJson = JSON.parse(rawPackageJson);
+	return {
+		cwd,
+		packageJson,
+		packageType: resolvePackageType(packageJson)
+	};
+}
+function resolvePackageType(packageJson) {
+	switch (packageJson.type) {
+		case "module": return "esm";
+		default: return "cjs";
+	}
+}
+
+//#endregion
+//#region src/utils/path.ts
+async function hasPlatformSpecificModule(id, importer, config$1) {
+	const specifiers = config$1.specifiers;
+	const resolveDir = path.dirname(importer);
+	let fileList = hasPlatformSpecificModule.cache.get(resolveDir);
+	if (fileList == null) {
+		fileList = (await fs.promises.readdir(resolveDir, {
+			recursive: false,
+			withFileTypes: true
+		})).filter((file) => file.isFile()).map(({ name }) => basenameWithoutExtension(name));
+		hasPlatformSpecificModule.cache.set(resolveDir, fileList);
+	}
+	return specifiers.some((specifier) => fileList.includes(`${basenameWithoutExtension(id)}.${specifier}`));
+}
+function basenameWithoutExtension(id) {
+	return path.basename(id, path.extname(id));
+}
+hasPlatformSpecificModule.cache = /* @__PURE__ */ new Map();
+/**
+* For React Native modules, the standard module specification cannot be followed.
+*
+* In the case of platform-specific modules, a prefix such as `android.js` or `ios.js` is added before the module name.
+* If the standard module specification, which requires the full file path to be specified, is followed, platform-specific modules cannot be found.
+*
+* Therefore, the `.js` extension is used regardless of whether the module is ESM or CJS.
+*/
+function resolveFilename() {
+	return `[name].js`;
+}
+function isDts(filename) {
+	return filename.endsWith(".d.ts");
+}
+function removePlatformSpecificExtension(filename, extensions, specifiers) {
+	const extPattern = extensions.map((extension) => extension.replace(".", "")).join("|");
+	const regex = /* @__PURE__ */ new RegExp(`\\.(${specifiers.join("|")})\\.(${extPattern})$`);
+	return filename.replace(regex, ".$2");
+}
+function getUniquePlatformSpecificFiles(files$1, extensions, specifiers) {
+	const extPattern = extensions.map((e) => e.replace(".", "")).join("|");
+	const regex = /* @__PURE__ */ new RegExp(`\\.(${specifiers.join("|")})\\.(${extPattern})$`);
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const file of files$1) {
+		const baseName = file.replace(regex, ".$2");
+		if (seen.has(baseName)) continue;
+		seen.add(baseName);
+		result.push(file);
+	}
+	return result;
+}
+
+//#endregion
+//#region src/rolldown/plugins/dts.ts
+const debug$2 = createDebug("tsnv:dts");
+function dts$1(config$1) {
+	if (!config$1.dts) return null;
+	const dtsExtension = ["d"];
+	return [dts({
+		emitDtsOnly: true,
+		tsgo: config$1.experimental?.tsgo
+	}), {
+		name: "tsnv:dts-renamer",
+		outputOptions(options) {
+			return {
+				...options,
+				entryFileNames(chunkInfo) {
+					if (chunkInfo.name.endsWith(".d")) {
+						const newChunkName = `${removePlatformSpecificExtension(chunkInfo.name, dtsExtension, config$1.specifiers)}.ts`;
+						debug$2(`renaming ${chunkInfo.name} to ${newChunkName}`);
+						return newChunkName;
+					} else return chunkInfo.name;
+				}
+			};
+		}
+	}];
+}
+
+//#endregion
+//#region src/rolldown/plugins/external.ts
+const PLUGIN_NAME = "tsnv:external";
+const debug$1 = createDebug(PLUGIN_NAME);
+function external(context$1) {
+	const productionDependencies = Array.from(new Set([...Object.keys(context$1.packageJson.dependencies ?? {}), ...Object.keys(context$1.packageJson.peerDependencies ?? {})]));
+	debug$1("production dependencies", productionDependencies);
+	return {
+		name: PLUGIN_NAME,
+		async resolveId(id, importer, extraOptions) {
+			if (extraOptions.isEntry || importer == null) return;
+			if (productionDependencies.some((packageName) => isPackageImportSource(packageName, id))) return {
+				id,
+				external: true
+			};
+			const extname = path.extname(id);
+			if (extname) {
+				if (context$1.config.assetExtensions.includes(extname)) return {
+					id,
+					external: true
+				};
+				if (!context$1.config.sourceExtensions.includes(extname)) throw new Error(`Unsupported file extension: ${extname}`);
+			}
+			const resolved = await this.resolve(id, importer, extraOptions);
+			if (resolved == null && await hasPlatformSpecificModule(id, importer, context$1.config)) return {
+				id,
+				external: true,
+				moduleSideEffects: true
+			};
+			return resolved;
+		}
+	};
+}
+function isPackageImportSource(packageName, id) {
+	return id === packageName || id.startsWith(`${packageName}/`);
+}
+
+//#endregion
+//#region src/rolldown/build-options.ts
+function resolveBuildOptions(context$1, options) {
+	const pluginContext = {
+		...context$1,
+		config: options.config
+	};
+	const baseOptions = {
+		input: options.files,
+		plugins: [external(pluginContext)],
+		output: {
+			banner: options.config.banner,
+			footer: options.config.footer,
+			intro: options.config.intro,
+			outro: options.config.outro,
+			sourcemap: options.config.sourcemap,
+			preserveModulesRoot: options.config.source,
+			preserveModules: true
+		}
+	};
+	let formats;
+	if (Array.isArray(options.config.format)) formats = options.config.format;
+	else formats = [options.config.format];
+	const uniqueFormats = Array.from(new Set(formats));
+	const isSingleFormat = uniqueFormats.length === 1;
+	const filename = resolveFilename();
+	const resolvedBuildOptions = uniqueFormats.map((format) => {
+		return {
+			...baseOptions,
+			output: {
+				...baseOptions.output,
+				dir: isSingleFormat ? options.config.outDir : path.join(options.config.outDir, format),
+				cleanDir: options.config.clean,
+				format,
+				entryFileNames: filename,
+				chunkFileNames: filename
+			}
+		};
+	});
+	if (options.config.dts) resolvedBuildOptions.push({
+		...baseOptions,
+		input: getUniquePlatformSpecificFiles(options.files, options.config.sourceExtensions, options.config.specifiers),
+		plugins: [...Array.isArray(baseOptions.plugins) ? baseOptions.plugins : [baseOptions.plugins], dts$1(options.config)],
+		output: {
+			...baseOptions.output,
+			cleanDir: options.config.clean,
+			dir: path.join(options.config.outDir, "types"),
+			format: "esm",
+			entryFileNames: filename,
+			chunkFileNames: filename
+		}
+	});
+	return resolvedBuildOptions;
+}
+
+//#endregion
+//#region src/rolldown/index.ts
+const debug = createDebug("tsnv:build");
+async function build$1(context$1, options) {
+	const buildOptions = resolveBuildOptions(context$1, options);
+	debug("Resolved build options", buildOptions);
+	for (const buildOption of buildOptions) await build(buildOption);
+}
+
+//#endregion
+//#region src/utils/fs.ts
+function collectFiles(config$1) {
+	const files$1 = globSync(`**/*.{${config$1.sourceExtensions.join(",")}}`, {
+		cwd: config$1.source,
+		exclude: (filename) => config$1.exclude.test(filename) || isDts(filename)
+	});
+	if (files$1.length === 0) throw new Error(`No files found in ${path.resolve(config$1.source)}`);
+	return files$1.map((file) => path.join(config$1.source, file));
+}
+
+//#endregion
+//#region src/index.ts
+debug$3("Loading config...");
+const { config } = await loadConfig({
+	configFile: "tsnv.config",
+	defaultConfig: DEFAULT_CONFIG
+});
+debug$3("Config loaded", config);
+const context = await resolveContext(process.cwd());
+debug$3("Resolved context", context);
+const files = await collectFiles(config);
+debug$3("Collected files", files);
+await build$1(context, {
+	files,
+	config
+});
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "tsnv",
+  "version": "0.0.0-dev.20260119180902",
+  "description": "Modern build toolkit for React Native libraries",
+  "license": "MIT",
+  "author": "Geunhyeok Lee <dev.ghlee@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leegeunhyeok/tsnv.git",
+    "directory": "."
+  },
+  "bin": "bin.js",
+  "files": [
+    "bin.js",
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/config.cjs",
+  "module": "./dist/config.js",
+  "types": "./dist/config.d.cjs",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/config.d.js",
+        "default": "./dist/config.js"
+      },
+      "require": {
+        "types": "./dist/config.d.cjs",
+        "default": "./dist/config.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "prepack": "yarn build",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint --type-aware --deny-warnings",
+    "lint:fix": "oxlint --type-aware --deny-warnings --fix",
+    "fmt": "oxfmt",
+    "test": "vitest --run",
+    "test:e2e": "vitest --run --config vitest.e2e.config.ts",
+    "build": "tsdown",
+    "scripts:version": ".scripts/version.sh",
+    "scripts:publish": ".scripts/publish.sh"
+  },
+  "dependencies": {
+    "c12": "^3.3.3",
+    "empathic": "^2.0.0",
+    "obug": "^2.1.1",
+    "rolldown": "1.0.0-beta.60",
+    "rolldown-plugin-dts": "0.21.2",
+    "tsdown": "0.20.0-beta.3"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^24.10.1",
+    "es-toolkit": "^1.43.0",
+    "oxfmt": "^0.24.0",
+    "oxlint": "^1.39.0",
+    "oxlint-tsgolint": "^0.11.1",
+    "picocolors": "^1.1.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17",
+    "zx": "^8.8.5"
+  },
+  "dependenciesMeta": {
+    "@typescript/native-preview": {},
+    "oxfmt": {
+      "unplugged": true
+    },
+    "oxlint": {
+      "unplugged": true
+    },
+    "oxlint-tsgolint": {
+      "unplugged": true
+    },
+    "typescript": {}
+  },
+  "peerDependencies": {
+    "@typescript/native-preview": "*",
+    "typescript": "*"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "packageManager": "yarn@4.12.0",
+  "stableVersion": "0.0.0"
+}