react-native-config-ultimate 0.0.7 → 0.1.0

package/lib/typescript/src/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../src/load-env.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAiB7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAqCzE"}

package/lib/typescript/src/load-env.spec.d.ts

@@ -0,0 +1,6 @@
+declare const mockReadFileSync: jest.Mock<any, any, any>;
+declare const mockParse: jest.Mock<any, any, any>;
+declare const mockExpand: jest.Mock<any, any, any>;
+declare const mockYaml: jest.Mock<any, any, any>;
+declare const load_env: (paths: string | string[]) => Record<string, unknown>;
+//# sourceMappingURL=load-env.spec.d.ts.map

package/lib/typescript/src/load-env.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.spec.d.ts","sourceRoot":"","sources":["../../../src/load-env.spec.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,gBAAgB,0BAAY,CAAC;AAGnC,QAAA,MAAM,SAAS,0BAAY,CAAC;AAG5B,QAAA,MAAM,UAAU,0BAAY,CAAC;AAG7B,QAAA,MAAM,QAAQ,0BAAY,CAAC;AAI3B,QAAA,MAAM,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CACrC,CAAC"}

package/lib/typescript/src/main.d.ts

@@ -0,0 +1,12 @@
+import type { RC } from './resolve-env';
+/**
+ * Main build-time pipeline:
+ *   load → resolve (on_env hook) → validate (schema) → flatten → render → write
+ *
+ * @param project_root  Root of the React Native project
+ * @param lib_root      Root of the react-native-config-ultimate install
+ * @param env_file      Path(s) to env file(s). Multiple files are merged (last wins).
+ * @param rc            Optional RC config from `.rncurc.js`
+ */
+export default function main(project_root: string, lib_root: string, env_file: string | string[], rc?: RC): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/lib/typescript/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,EAAW,MAAM,eAAe,CAAC;AAGjD;;;;;;;;GAQG;AACH,wBAA8B,IAAI,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,EAAE,CAAC,EAAE,EAAE,GACN,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/lib/typescript/src/main.spec.d.ts

@@ -0,0 +1,2 @@
+export declare const files_to_assert: string[];
+//# sourceMappingURL=main.spec.d.ts.map

package/lib/typescript/src/main.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.spec.d.ts","sourceRoot":"","sources":["../../../src/main.spec.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,eAAe,UAO3B,CAAC"}

package/lib/typescript/src/render-env.d.ts

@@ -0,0 +1,11 @@
+import type { FlatConfig } from './flatten';
+import type { RC } from './resolve-env';
+import type { FileMap } from './write-env';
+interface PlatformEnv {
+    ios: FlatConfig;
+    android: FlatConfig;
+    web: FlatConfig;
+}
+export default function render_env(project_root: string, lib_root: string, env: PlatformEnv, rc?: RC): FileMap;
+export {};
+//# sourceMappingURL=render-env.d.ts.map

package/lib/typescript/src/render-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-env.d.ts","sourceRoot":"","sources":["../../../src/render-env.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAoE3C,UAAU,WAAW;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,EAChB,EAAE,CAAC,EAAE,EAAE,GACN,OAAO,CAyBT"}

package/lib/typescript/src/render-env.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-env.spec.d.ts.map

package/lib/typescript/src/render-env.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-env.spec.d.ts","sourceRoot":"","sources":["../../../src/render-env.spec.ts"],"names":[],"mappings":""}

package/lib/typescript/src/resolve-env.d.ts

@@ -0,0 +1,35 @@
+export type EnvData = Record<string, unknown>;
+/**
+ * Schema definition for a single environment variable.
+ * Used in `.rncurc.js` to validate env vars at build time.
+ *
+ * @example
+ * module.exports = {
+ *   schema: {
+ *     API_URL:    { type: 'string',  required: true },
+ *     TIMEOUT_MS: { type: 'number',  required: true },
+ *     DEBUG:      { type: 'boolean', required: false },
+ *     ENV_NAME:   { type: 'string',  required: true, pattern: '^(dev|staging|prod)$' },
+ *   }
+ * };
+ */
+export interface SchemaField {
+    /** Expected type. Strings are always accepted as-is; number/boolean validate parsability. */
+    type: 'string' | 'number' | 'boolean';
+    /** If true, build fails when this var is missing or empty. Default: false. */
+    required?: boolean;
+    /** Optional regex pattern the value must match (applied to string representation). */
+    pattern?: string;
+}
+export type Schema = Record<string, SchemaField>;
+export interface RC {
+    on_env?: (env: EnvData) => unknown;
+    js_override?: boolean;
+    /**
+     * Optional schema for build-time validation of env vars.
+     * Validated after `on_env` runs (so the hook can add/transform vars before validation).
+     */
+    schema?: Schema;
+}
+export default function resolve_env(env: EnvData, rc?: RC): Promise<EnvData>;
+//# sourceMappingURL=resolve-env.d.ts.map

package/lib/typescript/src/resolve-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-env.d.ts","sourceRoot":"","sources":["../../../src/resolve-env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEjD,MAAM,WAAW,EAAE;IACjB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAA8B,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjF"}

package/lib/typescript/src/resolve-env.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-env.spec.d.ts.map

package/lib/typescript/src/resolve-env.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-env.spec.d.ts","sourceRoot":"","sources":["../../../src/resolve-env.spec.ts"],"names":[],"mappings":""}

package/lib/typescript/src/validate-env.d.ts

@@ -0,0 +1,10 @@
+import type { EnvData, Schema } from './resolve-env';
+/**
+ * Validate env data against a schema defined in `.rncurc.js`.
+ * Called after `on_env` so the hook can add/transform vars before validation.
+ *
+ * Throws with a human-readable error listing ALL failures at once
+ * (not just the first one), so users can fix everything in one pass.
+ */
+export declare function validate_env(env: EnvData, schema: Schema): void;
+//# sourceMappingURL=validate-env.d.ts.map

package/lib/typescript/src/validate-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-env.d.ts","sourceRoot":"","sources":["../../../src/validate-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIrD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA2D/D"}

package/lib/typescript/src/validate-env.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate-env.spec.d.ts.map

package/lib/typescript/src/validate-env.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-env.spec.d.ts","sourceRoot":"","sources":["../../../src/validate-env.spec.ts"],"names":[],"mappings":""}

package/lib/typescript/src/write-env.d.ts

@@ -0,0 +1,13 @@
+export type FileMap = Record<string, string>;
+/**
+ * Atomically write all generated files.
+ *
+ * Strategy: write each file to a temp path first, then rename (atomic on POSIX).
+ * If any write fails, we abort before committing any renames so the project
+ * is never left in a partially-written state.
+ *
+ * On Windows, `fs.renameSync` across drives may fail — in that case we fall
+ * back to a direct `writeFileSync` (best-effort, still better than nothing).
+ */
+export default function write_env(files: FileMap): void;
+//# sourceMappingURL=write-env.d.ts.map

package/lib/typescript/src/write-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-env.d.ts","sourceRoot":"","sources":["../../../src/write-env.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAyDtD"}

package/lib/typescript/src/write-env.spec.d.ts

@@ -0,0 +1,9 @@
+declare const mockWriteFileSync: jest.Mock<any, any, any>;
+declare const mockRenameSync: jest.Mock<any, any, any>;
+declare const mockUnlinkSync: jest.Mock<any, any, any>;
+declare const mockCopyFileSync: jest.Mock<any, any, any>;
+declare const mockMkdirSync: jest.Mock<any, any, any>;
+declare const write_env: (env: Record<string, string>) => void;
+/** Returns the temp file path used for a given destination. */
+declare function tmp_for(dest: string): string;
+//# sourceMappingURL=write-env.spec.d.ts.map

package/lib/typescript/src/write-env.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-env.spec.d.ts","sourceRoot":"","sources":["../../../src/write-env.spec.ts"],"names":[],"mappings":"AACA,QAAA,MAAM,iBAAiB,0BAAY,CAAC;AACpC,QAAA,MAAM,cAAc,0BAAY,CAAC;AACjC,QAAA,MAAM,cAAc,0BAAY,CAAC;AACjC,QAAA,MAAM,gBAAgB,0BAAY,CAAC;AACnC,QAAA,MAAM,aAAa,0BAAY,CAAC;AAahC,QAAA,MAAM,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAqC,CAAC;AAIxF,+DAA+D;AAC/D,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrC"}

package/package.json

@@ -1,59 +1,53 @@
 {
   "name": "react-native-config-ultimate",
   "title": "React Native Config Ultimate",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "Config that works. A community-maintained fork of react-native-ultimate-config.",
-  "main": "index.js",
-  "module": "index.js",
-  "react-native": "index.js",
-  "source": "index.ts",
-  "browser": "index.web.js",
-  "types": "index.d.ts",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
   "exports": {
     ".": {
-      "react-native": "./index.js",
-      "import": "./index.js",
-      "require": "./index.js",
-      "default": "./index.js"
-    }
+      "react-native": "./src/index.ts",
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "bin.js",
-    "index.js",
-    "index.d.ts",
-    "index.web.js",
-    "src/*.js",
-    "!src/*.spec.js",
-    "src/NativeUltimateConfig.ts",
-    "src/templates",
-    "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"
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "*.podspec",
+    "!src/**/*.spec.ts",
+    "!src/test_outputs",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
   ],
   "scripts": {
-    "build": "tsc",
+    "example": "yarn workspace react-native-config-ultimate-example",
+    "build": "bob build && node -e \"const fs=require('fs');const f='lib/commonjs/cli.js';const c=fs.readFileSync(f,'utf8');if(!c.startsWith('#!')){fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c)}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "npm run build",
+    "prepack": "printf '#error \"react-native-config-ultimate: ConfigValues.h not generated. Run: npx rncu .env from your project root before building iOS.\\n\"' > ios/ConfigValues.h",
     "typecheck": "tsc --noEmit",
-    "pretest": "tsc",
     "test": "jest",
-    "prepack": "printf '#error \"react-native-config-ultimate: ConfigValues.h not generated. Run: npx rncu .env from your project root before building iOS.\\n\"' > ios/ConfigValues.h && echo 'module.exports = {};' > override.js",
-    "lint": "eslint src/**/*.ts index.ts --max-warnings=0",
-    "format": "prettier --write src/**/*.ts index.ts"
+    "lint": "eslint \"src/**/*.{js,ts,tsx}\" --max-warnings=0"
   },
   "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"
+    "rncu": "./lib/commonjs/cli.js"
   },
   "keywords": [
     "react-native",
@@ -76,6 +70,10 @@
     "new-architecture",
     "turbomodules"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/javier545dev/react-native-config-ultimate.git"
+  },
   "author": {
     "name": "Javier Fuentes",
     "email": "javierfuentes545@gmail.com"
@@ -88,26 +86,40 @@
     }
   ],
   "license": "MIT",
-  "peerDependencies": {
-    "react-native": ">=0.73.0 <1.0.x"
+  "bugs": {
+    "url": "https://github.com/javier545dev/react-native-config-ultimate/issues"
+  },
+  "homepage": "https://github.com/javier545dev/react-native-config-ultimate#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
     "@types/jest": "^29.5.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.0.0",
+    "@types/react": "^19.2.0",
     "@types/yargs": "^17.0.35",
-    "@typescript-eslint/eslint-plugin": "^8.20.0",
-    "@typescript-eslint/parser": "^8.20.0",
-    "eslint": "^9.17.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
     "jest": "^29.7.0",
     "prettier": "^3.4.2",
-    "react": "^19.0.0",
-    "react-native": "0.79.5",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.18",
     "ts-jest": "^29.2.0",
-    "typescript": "^5.5.4"
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
   },
-  "engines": {
-    "node": ">= 18.0.0"
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
   },
   "dependencies": {
     "chokidar": "4.0.3",
@@ -117,6 +129,19 @@
     "js-yaml": "^4",
     "yargs": "^17"
   },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      "typescript"
+    ]
+  },
   "codegenConfig": {
     "name": "RNUltimateConfigSpec",
     "type": "modules",
@@ -124,5 +149,12 @@
     "android": {
       "javaPackageName": "com.reactnativeultimateconfig"
     }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
   }
 }

package/src/NativeUltimateConfig.ts

@@ -9,8 +9,7 @@
  * - getAll() returns all config values as a JSON-encoded string, which Codegen handles perfectly
  * - This gives us a working TurboModule binding for New Architecture
  */
-import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
-import { TurboModuleRegistry } from 'react-native';
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
 
 export interface Spec extends TurboModule {
   // Returns all config values as a JSON-encoded string.

package/src/cli.ts

@@ -0,0 +1,158 @@
+import yargs from 'yargs';
+import * as path from 'path';
+import * as fs from 'fs';
+import { watch } from 'chokidar';
+import main from './main';
+import type { RC } from './resolve-env';
+
+/**
+ * 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: string): RC | undefined {
+  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) as RC;
+}
+
+function log(msg: string): void {
+  process.stdout.write(`[rncu] ${msg}\n`);
+}
+
+function log_err(msg: string): void {
+  process.stderr.write(`[rncu] ✗ ${msg}\n`);
+}
+
+export default async function cli(): Promise<void> {
+  const argv = await yargs(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: string = (() => {
+    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 {
+      // 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?: string): Promise<void> {
+    if (changed_path) {
+      log(`${changed_path} changed → regenerating...`);
+    }
+    const start = Date.now();
+    try {
+      const rc = load_rc(rc_file);
+      await main(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 main(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 = 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));
+  });
+}

package/src/flatten.ts

@@ -0,0 +1,26 @@
+import assert from 'assert';
+
+type Platform = 'ios' | 'android' | 'web';
+export type ConfigValue = string | number | boolean;
+export type PerPlatformValue = Partial<Record<Platform, ConfigValue>>;
+export type EnvConfig = Record<string, ConfigValue | PerPlatformValue>;
+export type FlatConfig = Record<string, ConfigValue | undefined>;
+
+const VALID_PLATFORMS: Platform[] = ['ios', 'android', 'web'];
+
+export default function flatten(config: EnvConfig, platform: Platform): FlatConfig {
+  assert(config && typeof config === 'object', 'Config should be non-null object');
+  assert(
+    VALID_PLATFORMS.includes(platform),
+    '`platform` should one of: ' + VALID_PLATFORMS.join(', ')
+  );
+  const result: FlatConfig = {};
+  for (const [key, value] of Object.entries(config)) {
+    if (value && typeof value === 'object') {
+      result[key] = (value as PerPlatformValue)[platform];
+    } else {
+      result[key] = value as ConfigValue;
+    }
+  }
+  return result;
+}

package/src/index.ts

@@ -0,0 +1,37 @@
+import { TurboModuleRegistry, NativeModules } from 'react-native';
+import type { Spec } from './NativeUltimateConfig';
+
+export type ConfigValue = string | number | boolean;
+export type { Spec } from './NativeUltimateConfig';
+
+type Config = Record<string, ConfigValue>;
+
+// override.js is dynamically generated by the rncu CLI at the package root.
+// It contains platform-specific overrides. Do not commit override.js to git.
+// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+const override: Config = require('../override');
+
+// New Architecture: TurboModules are accessed via TurboModuleRegistry.
+// The spec exposes getAll(): string — returns config values as JSON.
+// Old Architecture: constants are exposed directly on NativeModules via constantsToExport.
+const turboModule = TurboModuleRegistry.get<Spec>('UltimateConfig');
+
+let nativeConstants: Config;
+
+if (turboModule != null && typeof turboModule.getAll === 'function') {
+  // New Arch: call getAll() and parse JSON
+  try {
+    const raw = turboModule.getAll();
+    nativeConstants = JSON.parse(raw) as Config;
+  } catch {
+    nativeConstants = {};
+  }
+} else {
+  // Old Arch / interop bridge: constants are properties on NativeModules.UltimateConfig
+  nativeConstants = (NativeModules.UltimateConfig as Config | undefined) ?? {};
+}
+
+export default {
+  ...nativeConstants,
+  ...override,
+} as Config;