react-native-config-ultimate 0.0.1

package/ios/UltimateConfig.xcodeproj/project.pbxproj

@@ -0,0 +1,274 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 46;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		5E555C0D2413F4C50049A1A2 /* UltimateConfig.m in Sources */ = {isa = PBXBuildFile; fileRef = B3E7B5891CC2AC0600A0062D /* UltimateConfig.m */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXCopyFilesBuildPhase section */
+		58B511D91A9E6C8500147676 /* CopyFiles */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "include/$(PRODUCT_NAME)";
+			dstSubfolderSpec = 16;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXCopyFilesBuildPhase section */
+
+/* Begin PBXFileReference section */
+		134814201AA4EA6300B7C361 /* libUltimateConfig.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libUltimateConfig.a; sourceTree = BUILT_PRODUCTS_DIR; };
+		B3E7B5881CC2AC0600A0062D /* UltimateConfig.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = UltimateConfig.h; sourceTree = "<group>"; };
+		B3E7B5891CC2AC0600A0062D /* UltimateConfig.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = UltimateConfig.m; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		58B511D81A9E6C8500147676 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		134814211AA4EA7D00B7C361 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				134814201AA4EA6300B7C361 /* libUltimateConfig.a */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		58B511D21A9E6C8500147676 = {
+			isa = PBXGroup;
+			children = (
+				B3E7B5881CC2AC0600A0062D /* UltimateConfig.h */,
+				B3E7B5891CC2AC0600A0062D /* UltimateConfig.m */,
+				134814211AA4EA7D00B7C361 /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		58B511DA1A9E6C8500147676 /* UltimateConfig */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "UltimateConfig" */;
+			buildPhases = (
+				58B511D71A9E6C8500147676 /* Sources */,
+				58B511D81A9E6C8500147676 /* Frameworks */,
+				58B511D91A9E6C8500147676 /* CopyFiles */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = UltimateConfig;
+			productName = RCTDataManager;
+			productReference = 134814201AA4EA6300B7C361 /* libUltimateConfig.a */;
+			productType = "com.apple.product-type.library.static";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		58B511D31A9E6C8500147676 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				LastUpgradeCheck = 0920;
+				ORGANIZATIONNAME = Facebook;
+				TargetAttributes = {
+					58B511DA1A9E6C8500147676 = {
+						CreatedOnToolsVersion = 6.1.1;
+					};
+				};
+			};
+			buildConfigurationList = 58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "UltimateConfig" */;
+			compatibilityVersion = "Xcode 3.2";
+			developmentRegion = English;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				English,
+				en,
+			);
+			mainGroup = 58B511D21A9E6C8500147676;
+			productRefGroup = 58B511D21A9E6C8500147676;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				58B511DA1A9E6C8500147676 /* UltimateConfig */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXSourcesBuildPhase section */
+		58B511D71A9E6C8500147676 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				B3E7B58A1CC2AC0600A0062D /* UltimateConfig.m in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin XCBuildConfiguration section */
+		58B511ED1A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				"EXCLUDED_ARCHS[sdk=*]" = arm64;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_SYMBOLS_PRIVATE_EXTERN = NO;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+			};
+			name = Debug;
+		};
+		58B511EE1A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = YES;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				"EXCLUDED_ARCHS[sdk=*]" = arm64;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		58B511F01A9E6C8500147676 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = UltimateConfig;
+				SKIP_INSTALL = YES;
+			};
+			name = Debug;
+		};
+		58B511F11A9E6C8500147676 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				HEADER_SEARCH_PATHS = (
+					"$(inherited)",
+					/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
+					"$(SRCROOT)/../../../React/**",
+					"$(SRCROOT)/../../react-native/React/**",
+				);
+				LIBRARY_SEARCH_PATHS = "$(inherited)";
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = UltimateConfig;
+				SKIP_INSTALL = YES;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		58B511D61A9E6C8500147676 /* Build configuration list for PBXProject "UltimateConfig" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511ED1A9E6C8500147676 /* Debug */,
+				58B511EE1A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		58B511EF1A9E6C8500147676 /* Build configuration list for PBXNativeTarget "UltimateConfig" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				58B511F01A9E6C8500147676 /* Debug */,
+				58B511F11A9E6C8500147676 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 58B511D31A9E6C8500147676 /* Project object */;
+}

package/override.js

@@ -0,0 +1 @@
+module.exports = {};

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "react-native-config-ultimate",
+  "title": "React Native Config Ultimate",
+  "version": "0.0.1",
+  "description": "Config that works. A community-maintained fork of react-native-ultimate-config.",
+  "main": "index.js",
+  "react-native": "index.js",
+  "browser": "index.web.js",
+  "types": "index.d.ts",
+  "files": [
+    "src/*.js",
+    "src/*.ts",
+    "src/templates",
+    "index.js",
+    "index.ts",
+    "override.js",
+    "ios/UltimateConfig.{h,mm}",
+    "ios/ConfigValues.h",
+    "ios/UltimateConfig.xcodeproj/project.pbxproj",
+    "android/src",
+    "android/build.gradle",
+    "android/rncu.gradle",
+    "react-native-config-ultimate.podspec"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "pretest": "tsc",
+    "test": "jest",
+    "prepack": "echo '#error \"invoke bin.js with env file before compiling native project\"' > ios/ConfigValues.h && echo 'module.exports = {};' > override.js",
+    "lint": "eslint src/**/*.ts index.ts --max-warnings=0",
+    "format": "prettier --write src/**/*.ts index.ts"
+  },
+  "bin": {
+    "rncu": "./bin.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/javier545dev/react-native-config-ultimate.git"
+  },
+  "homepage": "https://github.com/javier545dev/react-native-config-ultimate#readme",
+  "bugs": {
+    "url": "https://github.com/javier545dev/react-native-config-ultimate/issues"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "12factor",
+    "12factorapp",
+    "dotenv",
+    "env",
+    "environment",
+    "config",
+    "xcconfig",
+    "gradle",
+    "objective-c",
+    "java",
+    "typescript"
+  ],
+  "author": {
+    "name": "Javier Fuentes",
+    "email": "javierfuentes545@gmail.com"
+  },
+  "contributors": [
+    {
+      "name": "Max Komarychev",
+      "email": "maxkomarychev@gmail.com",
+      "url": "https://github.com/maxkomarychev"
+    }
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react-native": ">=0.60.0-rc.0 <1.0.x"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "@types/yargs": "^17.0.35",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.17.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.4.2",
+    "react": "^19.0.0",
+    "react-native": "0.79.5",
+    "ts-jest": "^29.2.0",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  },
+  "dependencies": {
+    "chokidar": "4.0.3",
+    "dotenv": "16.6.1",
+    "dotenv-expand": "^12.0.3",
+    "handlebars": "^4.7.7",
+    "js-yaml": "^4",
+    "yargs": "^17"
+  },
+  "codegenConfig": {
+    "name": "RNUltimateConfigSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.reactnativeultimateconfig"
+    }
+  }
+}

package/react-native-config-ultimate.podspec

@@ -0,0 +1,41 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-config-ultimate"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.description  = <<-DESC
+                  react-native-config-ultimate
+                  A community-maintained fork of react-native-ultimate-config
+                  by Max Komarychev. Adds New Architecture (TurboModules),
+                  multi-env merging, dotenv expansion, schema validation,
+                  and CLI watch mode.
+                   DESC
+  s.homepage     = "https://github.com/javier545dev/react-native-config-ultimate"
+  s.license      = "MIT"
+  s.authors      = { "Javier Fuentes" => "javierfuentes545@gmail.com" }
+  s.platforms    = { :ios => "11.0" }
+  s.source       = { :git => "https://github.com/javier545dev/react-native-config-ultimate.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+
+  s.dependency "React-Core"
+
+  # Don't install the dependencies when we run `pod install` in the old architecture.
+  if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+    s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+    s.pod_target_xcconfig    = {
+        "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+        "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+        "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+    }
+    s.dependency "React-Codegen"
+    s.dependency "RCT-Folly"
+    s.dependency "RCTRequired"
+    s.dependency "RCTTypeSafety"
+    s.dependency "ReactCommon/turbomodule/core"
+  end
+end

package/src/NativeUltimateConfig.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_native_1 = require("react-native");
+exports.default = react_native_1.TurboModuleRegistry.get('UltimateConfig');

package/src/NativeUltimateConfig.ts

@@ -0,0 +1,15 @@
+/**
+ * TurboModule spec for react-native-ultimate-config
+ * This file is read by React Native Codegen to generate native bindings.
+ * Do not rename or move this file - Codegen relies on the "Native" prefix.
+ */
+import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
+import { TurboModuleRegistry } from 'react-native';
+
+export type ConfigValue = string | number | boolean;
+
+export interface Spec extends TurboModule {
+  readonly getConstants: () => Record<string, ConfigValue>;
+}
+
+export default TurboModuleRegistry.get<Spec>('UltimateConfig');

package/src/bin.spec.ts

@@ -0,0 +1,36 @@
+import cp from 'child_process';
+import fs from 'fs';
+import path from 'path';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { files_to_assert } = require('./main.spec') as { files_to_assert: string[] };
+
+describe.each`
+  extension  | env_test_content
+  ${''}      | ${'hello=world'}
+  ${'.yaml'} | ${'hello: world'}
+  ${'.yml'}  | ${'hello: world'}
+`('test codegen', ({ extension, env_test_content }: { extension: string; env_test_content: string }) => {
+  let project_root: string;
+  beforeAll(() => {
+    project_root = path.join(process.cwd(), fs.mkdtempSync('rncu-jest'));
+    for (const file_path of files_to_assert) {
+      const { dir } = path.parse(file_path);
+      const folder = path.join(project_root, dir);
+      fs.mkdirSync(folder, { recursive: true });
+    }
+  });
+  afterAll(() => {
+    fs.rmSync(project_root, { recursive: true, force: true });
+  });
+  it.each(files_to_assert.map((k) => [k]))(
+    'creates file at path %s',
+    (file_path) => {
+      const env_file_path = path.join(project_root, `.env${extension}`);
+      fs.writeFileSync(env_file_path, env_test_content);
+      cp.execFileSync(path.join(process.cwd(), 'bin.js'), [env_file_path], {
+        cwd: project_root,
+      });
+      expect(fs.existsSync(path.join(project_root, file_path as string))).toEqual(true);
+    }
+  );
+});

package/src/cli.js

@@ -0,0 +1,177 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = cli;
+const yargs_1 = __importDefault(require("yargs"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chokidar_1 = require("chokidar");
+const main_1 = __importDefault(require("./main"));
+/**
+ * Load the RC file fresh on every call (clears require cache so
+ * changes to .rncurc.js are picked up during --watch mode).
+ */
+function load_rc(rc_file) {
+    if (!fs.existsSync(rc_file))
+        return undefined;
+    delete require.cache[require.resolve(rc_file)];
+    // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports
+    return require(rc_file);
+}
+function log(msg) {
+    process.stdout.write(`[rncu] ${msg}\n`);
+}
+function log_err(msg) {
+    process.stderr.write(`[rncu] ✗ ${msg}\n`);
+}
+async function cli() {
+    const argv = await (0, yargs_1.default)(process.argv.slice(2))
+        .option('projectRoot', {
+        type: 'string',
+        default: process.cwd(),
+        description: 'Root directory of the React Native project',
+    })
+        .option('libRoot', {
+        type: 'string',
+        description: 'Root directory of react-native-config-ultimate ' +
+            '(defaults to <projectRoot>/node_modules/react-native-config-ultimate)',
+    })
+        .option('watch', {
+        alias: 'w',
+        type: 'boolean',
+        default: false,
+        description: 'Watch env file(s) for changes and regenerate automatically. ' +
+            'Note: changes to native vars (iOS xcconfig, Android BuildConfig) ' +
+            'still require a full native rebuild.',
+    })
+        .usage('Usage: $0 <env-file> [env-file2 ...] [options]')
+        .help()
+        .parseAsync();
+    const project_root = argv.projectRoot;
+    /**
+     * Resolve the library root directory.
+     *
+     * Priority:
+     * 1. --libRoot flag (explicit override)
+     * 2. Conventional path <projectRoot>/node_modules/react-native-config-ultimate
+     *    — used when the directory exists (standard install, or bin.spec.ts integration test).
+     * 3. require.resolve() — handles npm workspaces hoisting, pnpm, Yarn PnP,
+     *    and any layout where the package is hoisted above projectRoot.
+     * 4. Fall back to conventional path even if it doesn't exist yet
+     *    (write-env.ts will create the directories on first run).
+     */
+    const lib_root = (() => {
+        if (argv.libRoot)
+            return argv.libRoot;
+        const conventional = path.join(project_root, 'node_modules', 'react-native-config-ultimate');
+        // If the directory already exists at the conventional location, use it.
+        // This handles standard installs and the integration test temp-dir setup.
+        if (fs.existsSync(conventional))
+            return conventional;
+        // Otherwise, try require.resolve to handle hoisted workspaces.
+        try {
+            const pkg_json = require.resolve('react-native-config-ultimate/package.json', { paths: [project_root] });
+            return path.dirname(pkg_json);
+        }
+        catch (_a) {
+            // Last resort: return the conventional path and let write-env create it.
+            return conventional;
+        }
+    })();
+    // Accept one or more positional env file paths.
+    // Multiple files are merged left-to-right (last file wins for conflicting keys).
+    const env_files = argv._.map(String);
+    // Validate env files exist before running anything.
+    const missing_files = env_files.filter((f) => !fs.existsSync(f));
+    if (missing_files.length > 0) {
+        for (const f of missing_files) {
+            log_err(`env file not found: ${f}`);
+        }
+        process.exit(1);
+    }
+    const rc_file = path.resolve(project_root, '.rncurc.js');
+    // Helper: run the full pipeline once, returning duration in ms.
+    // Never throws — errors are caught and logged so watch mode stays alive.
+    async function run(changed_path) {
+        if (changed_path) {
+            log(`${changed_path} changed → regenerating...`);
+        }
+        const start = Date.now();
+        try {
+            const rc = load_rc(rc_file);
+            await (0, main_1.default)(project_root, lib_root, env_files, rc);
+            if (changed_path) {
+                log(`✓ done in ${Date.now() - start}ms`);
+            }
+        }
+        catch (err) {
+            log_err(err instanceof Error ? err.message : String(err));
+        }
+    }
+    // Initial run (always runs, throws on error in non-watch mode).
+    if (!argv.watch) {
+        const rc = load_rc(rc_file);
+        await (0, main_1.default)(project_root, lib_root, env_files, rc);
+        return;
+    }
+    // --watch mode ────────────────────────────────────────────────────────────
+    // Initial run (errors are caught — we still want to start watching).
+    await run();
+    // Files to watch: env files + RC file (if it exists).
+    const files_to_watch = [
+        ...env_files,
+        ...(fs.existsSync(rc_file) ? [rc_file] : []),
+    ];
+    const watcher = (0, chokidar_1.watch)(files_to_watch, {
+        ignoreInitial: true,
+        persistent: true,
+    });
+    log(`watching: ${files_to_watch.join(', ')}\n` +
+        `[rncu] ⚠  native vars (xcconfig/BuildConfig) require a full rebuild to take effect`);
+    watcher.on('change', (p) => void run(p));
+    watcher.on('add', (p) => void run(p));
+    // Keep the process alive (chokidar persistent:true already does this,
+    // but stdin.resume makes it explicit and survives edge cases).
+    process.stdin.resume();
+    // Graceful shutdown on Ctrl+C.
+    process.on('SIGINT', () => {
+        process.stdout.write('\n');
+        log('stopping...');
+        void watcher.close().then(() => process.exit(0));
+    });
+}