@vxrn/utils 2.10.0 → 2.11.0

package/src/desktopReactNativeResolve.ts

@@ -0,0 +1,148 @@
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join, relative, resolve } from 'node:path'
+
+export type DesktopPlatform = 'macos' | 'linux'
+
+const IOS_EXTENSIONS = ['.ios.tsx', '.ios.ts', '.ios.jsx', '.ios.js']
+const OVERRIDE_EXTENSIONS = ['', '.tsx', '.ts', '.jsx', '.js']
+
+const reactNativeRootCache = new Map<string, string | null>()
+
+export function findOnePackageRoot(appRoot: string): string | null {
+  try {
+    const req = createRequire(join(appRoot, 'package.json'))
+    return dirname(req.resolve('one/package.json'))
+  } catch {
+    return null
+  }
+}
+
+export function requireOnePackageRoot(appRoot: string, platform: DesktopPlatform): string {
+  const root = findOnePackageRoot(appRoot)
+  if (!root) {
+    throw new Error(
+      `${platform} build cannot resolve one from ${appRoot}. Add "one" as a dependency.`
+    )
+  }
+  return root
+}
+
+function reactNativeRootOf(importerFile: string): string | null {
+  const start = dirname(importerFile)
+  const cached = reactNativeRootCache.get(start)
+  if (cached !== undefined) return cached
+  let dir = start
+  let found: string | null = null
+  for (let i = 0; i < 12; i++) {
+    const manifest = join(dir, 'package.json')
+    if (existsSync(manifest)) {
+      try {
+        const name = JSON.parse(readFileSync(manifest, 'utf8')).name
+        if (name === 'react-native') found = realpathSync(dir)
+      } catch {
+        found = null
+      }
+      break
+    }
+    const parent = dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  reactNativeRootCache.set(start, found)
+  return found
+}
+
+function fileIfPresent(path: string): string | null {
+  if (!existsSync(path)) return null
+  try {
+    return statSync(path).isFile() ? path : null
+  } catch {
+    return null
+  }
+}
+
+const PLATFORM_MODULE = 'Libraries/Utilities/Platform'
+const BARE_PLATFORM = /^react-native\/Libraries\/Utilities\/Platform(?:\.(?:js|ts|tsx|jsx))?$/
+
+function slashRelative(from: string, to: string): string {
+  return relative(from, to).split('\\').join('/')
+}
+
+function isPackageEntry(importerFile: string, rnRoot: string): boolean {
+  try {
+    return slashRelative(rnRoot, realpathSync(importerFile)) === 'index.js'
+  } catch {
+    return false
+  }
+}
+
+function isPlatformTarget(rnRoot: string, target: string): boolean {
+  const rel = slashRelative(rnRoot, target).replace(/\.(tsx|ts|jsx|js)$/, '')
+  return rel === PLATFORM_MODULE
+}
+
+function platformOverrideFile(oneRoot: string, platform: DesktopPlatform): string | null {
+  return fileIfPresent(join(oneRoot, platform, 'react-native', PLATFORM_MODULE + '.js'))
+}
+
+/**
+ * The desktop platforms load react-native's iOS files, and only for importers
+ * inside that package. React Native's own modules keep Platform.ios.js, so
+ * Platform.OS stays ios there. The package entry and every importer outside
+ * react-native get the one Platform override, where OS is the desktop
+ * platform. Returns an absolute file, or null to keep the normal resolver.
+ */
+export function desktopReactNativeFile(
+  importerFile: string | undefined,
+  source: string,
+  oneRoot: string | null,
+  platform: DesktopPlatform
+): string | null {
+  if (BARE_PLATFORM.test(source)) {
+    if (!oneRoot) return null
+    if (importerFile) {
+      const rnRoot = reactNativeRootOf(importerFile)
+      if (rnRoot && !isPackageEntry(importerFile, rnRoot)) {
+        let dir = dirname(importerFile)
+        try {
+          dir = realpathSync(dir)
+        } catch {
+          // keep the unresolved directory
+        }
+        const inside = slashRelative(rnRoot, dir)
+        if (!inside.startsWith('..')) return null
+      }
+    }
+    return platformOverrideFile(oneRoot, platform)
+  }
+
+  if (!importerFile || !source.startsWith('.')) return null
+  const rnRoot = reactNativeRootOf(importerFile)
+  if (!rnRoot) return null
+  let importerReal: string
+  try {
+    importerReal = realpathSync(dirname(importerFile))
+  } catch {
+    return null
+  }
+  const fromRoot = relative(rnRoot, importerReal)
+  if (fromRoot.startsWith('..')) return null
+
+  const target = resolve(dirname(importerFile), source)
+  // the package entry re-exports Platform. its importer is index.js, so the
+  // public Platform is the override, while library files keep the ios one.
+  const internalPlatform = isPlatformTarget(rnRoot, target) && !isPackageEntry(importerFile, rnRoot)
+  if (oneRoot && !internalPlatform) {
+    const overrideBase = join(oneRoot, platform, 'react-native', relative(rnRoot, target))
+    for (const ext of OVERRIDE_EXTENSIONS) {
+      const file = fileIfPresent(overrideBase + ext)
+      if (file) return file
+    }
+  }
+  for (const ext of IOS_EXTENSIONS) {
+    const file = fileIfPresent(target + ext)
+    if (file) return file
+  }
+  return null
+}

package/src/platformEnv.test.ts

@@ -9,12 +9,14 @@ describe('one platform env contract', () => {
   it('exposes ONE_PLATFORM for every vite environment', () => {
     expect(getPlatformEnv('ios').ONE_PLATFORM).toBe('ios')
     expect(getPlatformEnv('android').ONE_PLATFORM).toBe('android')
+    expect(getPlatformEnv('macos').ONE_PLATFORM).toBe('macos')
+    expect(getPlatformEnv('linux').ONE_PLATFORM).toBe('linux')
     expect(getPlatformEnv('client').ONE_PLATFORM).toBe('web')
     expect(getPlatformEnv('ssr').ONE_PLATFORM).toBe('web')
   })
 
   it('defines the Expo platform alias only on native', () => {
-    for (const environment of ['ios', 'android'] as const) {
+    for (const environment of ['ios', 'android', 'macos', 'linux'] as const) {
       expect(getPlatformEnv(environment).EXPO_OS).toBe(
         getPlatformEnv(environment).ONE_PLATFORM
       )
@@ -38,6 +40,7 @@ describe('one platform env contract', () => {
   it('maps metro platforms to vite environments without probing', () => {
     expect(metroPlatformToViteEnvironment('ios')).toBe('ios')
     expect(metroPlatformToViteEnvironment('android')).toBe('android')
+    expect(metroPlatformToViteEnvironment('macos')).toBe('macos')
     expect(metroPlatformToViteEnvironment(null)).toBe('client')
     expect(metroPlatformToViteEnvironment(undefined)).toBe('client')
   })

package/src/platformEnv.ts

@@ -1,11 +1,12 @@
-export type Platform = 'ios' | 'android' | 'web'
-export type ViteEnvironment = 'client' | 'ssr' | 'ios' | 'android'
+export type NativePlatform = 'ios' | 'android' | 'macos' | 'linux'
+export type Platform = NativePlatform | 'web'
+export type ViteEnvironment = 'client' | 'ssr' | NativePlatform
 
 export type PlatformEnv = {
   VITE_ENVIRONMENT: ViteEnvironment
   VITE_NATIVE: '' | '1'
-  ONE_PLATFORM: 'web' | 'ios' | 'android'
-  EXPO_OS?: 'ios' | 'android'
+  ONE_PLATFORM: Platform
+  EXPO_OS?: NativePlatform
   TAMAGUI_TARGET: 'web' | 'native'
   TAMAGUI_ENVIRONMENT: ViteEnvironment
 }
@@ -41,6 +42,28 @@ const platformEnvMap: Record<ViteEnvironment, PlatformEnv> = {
     TAMAGUI_TARGET: 'native',
     TAMAGUI_ENVIRONMENT: 'android',
   },
+  macos: {
+    VITE_ENVIRONMENT: 'macos',
+    VITE_NATIVE: '1',
+    ONE_PLATFORM: 'macos',
+    EXPO_OS: 'macos',
+    TAMAGUI_TARGET: 'native',
+    TAMAGUI_ENVIRONMENT: 'macos',
+  },
+  linux: {
+    VITE_ENVIRONMENT: 'linux',
+    VITE_NATIVE: '1',
+    ONE_PLATFORM: 'linux',
+    EXPO_OS: 'linux',
+    TAMAGUI_TARGET: 'native',
+    TAMAGUI_ENVIRONMENT: 'linux',
+  },
+}
+
+const nativePlatforms = new Set<string>(['ios', 'android', 'macos', 'linux'])
+
+export function isNativePlatform(platform: string | null | undefined): platform is NativePlatform {
+  return platform != null && nativePlatforms.has(platform)
 }
 
 export function getPlatformEnv(environment: ViteEnvironment): PlatformEnv {
@@ -50,8 +73,7 @@ export function getPlatformEnv(environment: ViteEnvironment): PlatformEnv {
 export function metroPlatformToViteEnvironment(
   platform: Platform | string | null | undefined
 ): ViteEnvironment {
-  if (platform === 'ios') return 'ios'
-  if (platform === 'android') return 'android'
+  if (isNativePlatform(platform)) return platform
   return 'client'
 }
 

package/types/desktopReactNativeResolve.d.ts

@@ -0,0 +1,12 @@
+export type DesktopPlatform = 'macos' | 'linux';
+export declare function findOnePackageRoot(appRoot: string): string | null;
+export declare function requireOnePackageRoot(appRoot: string, platform: DesktopPlatform): string;
+/**
+ * The desktop platforms load react-native's iOS files, and only for importers
+ * inside that package. React Native's own modules keep Platform.ios.js, so
+ * Platform.OS stays ios there. The package entry and every importer outside
+ * react-native get the one Platform override, where OS is the desktop
+ * platform. Returns an absolute file, or null to keep the normal resolver.
+ */
+export declare function desktopReactNativeFile(importerFile: string | undefined, source: string, oneRoot: string | null, platform: DesktopPlatform): string | null;
+//# sourceMappingURL=desktopReactNativeResolve.d.ts.map

package/types/desktopReactNativeResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktopReactNativeResolve.d.ts","sourceRoot":"","sources":["../src/desktopReactNativeResolve.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,CAAA;AAO/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAQxF;AA4DD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,EAAE,eAAe,GACxB,MAAM,GAAG,IAAI,CA+Cf"}

package/types/platformEnv.d.ts

@@ -1,13 +1,15 @@
-export type Platform = 'ios' | 'android' | 'web';
-export type ViteEnvironment = 'client' | 'ssr' | 'ios' | 'android';
+export type NativePlatform = 'ios' | 'android' | 'macos' | 'linux';
+export type Platform = NativePlatform | 'web';
+export type ViteEnvironment = 'client' | 'ssr' | NativePlatform;
 export type PlatformEnv = {
     VITE_ENVIRONMENT: ViteEnvironment;
     VITE_NATIVE: '' | '1';
-    ONE_PLATFORM: 'web' | 'ios' | 'android';
-    EXPO_OS?: 'ios' | 'android';
+    ONE_PLATFORM: Platform;
+    EXPO_OS?: NativePlatform;
     TAMAGUI_TARGET: 'web' | 'native';
     TAMAGUI_ENVIRONMENT: ViteEnvironment;
 };
+export declare function isNativePlatform(platform: string | null | undefined): platform is NativePlatform;
 export declare function getPlatformEnv(environment: ViteEnvironment): PlatformEnv;
 export declare function metroPlatformToViteEnvironment(platform: Platform | string | null | undefined): ViteEnvironment;
 /**

package/types/platformEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platformEnv.d.ts","sourceRoot":"","sources":["../src/platformEnv.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAA;AAChD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,EAAE,eAAe,CAAA;IACjC,WAAW,EAAE,EAAE,GAAG,GAAG,CAAA;IACrB,YAAY,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;IACvC,OAAO,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IAC3B,cAAc,EAAE,KAAK,GAAG,QAAQ,CAAA;IAChC,mBAAmB,EAAE,eAAe,CAAA;CACrC,CAAA;AAmCD,wBAAgB,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,CAExE;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7C,eAAe,CAIjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB"}
+{"version":3,"file":"platformEnv.d.ts","sourceRoot":"","sources":["../src/platformEnv.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAClE,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,KAAK,CAAA;AAC7C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,cAAc,CAAA;AAE/D,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,EAAE,eAAe,CAAA;IACjC,WAAW,EAAE,EAAE,GAAG,GAAG,CAAA;IACrB,YAAY,EAAE,QAAQ,CAAA;IACtB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,cAAc,EAAE,KAAK,GAAG,QAAQ,CAAA;IAChC,mBAAmB,EAAE,eAAe,CAAA;CACrC,CAAA;AAqDD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,IAAI,cAAc,CAEhG;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,CAExE;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7C,eAAe,CAGjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB"}