@vxrn/vite-plugin-metro 1.2.61 → 1.2.63

package/src/babel-plugins/import-meta-env-plugin.ts

@@ -1,19 +1,36 @@
 import { declare } from '@babel/helper-plugin-utils'
 import * as t from '@babel/types'
 import type { PluginObj } from '@babel/core'
+import { getPlatformEnv, metroPlatformToViteEnvironment } from '../env/platformEnv'
 
 type PluginOptions = {
-  env?: Record<string, string | undefined>
+  env?: Record<string, string | boolean | undefined>
 }
 
 /**
- * A Babel plugin to replace `import.meta.env` and `import.meta.env.*` with the provided env variables.
+ * Babel plugin to replace `import.meta.env` and `import.meta.env.*` with env values.
  *
- * This plugin may not be referenced directly since metro runs transformers in separate workers, search for `@vxrn/vite-plugin-metro/babel-plugins/import-meta-env-plugin` to see how it's used.
+ * Platform-specific env vars (VITE_ENVIRONMENT, VITE_PLATFORM, EXPO_OS, TAMAGUI_ENVIRONMENT)
+ * are automatically injected based on the babel caller's platform.
+ *
+ * This plugin is referenced by name since Metro runs transformers in separate workers:
+ * '@vxrn/vite-plugin-metro/babel-plugins/import-meta-env-plugin'
  */
 export const importMetaEnvPlugin = declare<PluginOptions>((api, options): PluginObj => {
   api.assertVersion(7)
 
+  const platform = api.caller((caller) => (caller as any)?.platform) as
+    | string
+    | null
+    | undefined
+  const platformEnv = getPlatformEnv(metroPlatformToViteEnvironment(platform))
+
+  // Platform env is authoritative and cannot be overridden
+  const env: Record<string, string | boolean | undefined> = {
+    ...options.env,
+    ...platformEnv,
+  }
+
   return {
     name: 'import-meta-env',
     visitor: {
@@ -27,7 +44,7 @@ export const importMetaEnvPlugin = declare<PluginOptions>((api, options): Plugin
 
         // Replace import.meta.env
         if (isImportMeta && t.isIdentifier(node.property, { name: 'env' })) {
-          const envEntries = Object.entries(options.env ?? {}).map(([key, value]) =>
+          const envEntries = Object.entries(env).map(([key, value]) =>
             t.objectProperty(
               t.identifier(key),
               value === undefined ? t.identifier('undefined') : t.valueToNode(value)
@@ -53,7 +70,7 @@ export const importMetaEnvPlugin = declare<PluginOptions>((api, options): Plugin
 
           if (!envKey) return
 
-          const value = options.env?.[envKey]
+          const value = env[envKey]
           path.replaceWith(
             value === undefined ? t.identifier('undefined') : t.valueToNode(value)
           )

package/src/env/platformEnv.ts

@@ -0,0 +1,66 @@
+export type Platform = 'ios' | 'android' | 'web'
+export type ViteEnvironment = 'client' | 'ssr' | 'ios' | 'android'
+
+export type PlatformEnv = {
+  VITE_ENVIRONMENT: ViteEnvironment
+  VITE_PLATFORM: 'web' | 'native'
+  EXPO_OS: 'web' | 'ios' | 'android'
+  TAMAGUI_ENVIRONMENT: ViteEnvironment
+}
+
+const platformEnvMap: Record<ViteEnvironment, PlatformEnv> = {
+  client: {
+    VITE_ENVIRONMENT: 'client',
+    VITE_PLATFORM: 'web',
+    EXPO_OS: 'web',
+    TAMAGUI_ENVIRONMENT: 'client',
+  },
+  ssr: {
+    VITE_ENVIRONMENT: 'ssr',
+    VITE_PLATFORM: 'web',
+    EXPO_OS: 'web',
+    TAMAGUI_ENVIRONMENT: 'ssr',
+  },
+  ios: {
+    VITE_ENVIRONMENT: 'ios',
+    VITE_PLATFORM: 'native',
+    EXPO_OS: 'ios',
+    TAMAGUI_ENVIRONMENT: 'ios',
+  },
+  android: {
+    VITE_ENVIRONMENT: 'android',
+    VITE_PLATFORM: 'native',
+    EXPO_OS: 'android',
+    TAMAGUI_ENVIRONMENT: 'android',
+  },
+}
+
+export function getPlatformEnv(environment: ViteEnvironment): PlatformEnv {
+  return platformEnvMap[environment]
+}
+
+export function metroPlatformToViteEnvironment(
+  platform: Platform | string | null | undefined
+): ViteEnvironment {
+  if (platform === 'ios') return 'ios'
+  if (platform === 'android') return 'android'
+  return 'client'
+}
+
+/**
+ * Format platform env for Vite's define config.
+ * Returns both process.env.* and import.meta.env.* definitions.
+ */
+export function getPlatformEnvDefine(
+  environment: ViteEnvironment
+): Record<string, string> {
+  const env = getPlatformEnv(environment)
+  const define: Record<string, string> = {}
+
+  for (const [key, value] of Object.entries(env)) {
+    define[`process.env.${key}`] = JSON.stringify(value)
+    define[`import.meta.env.${key}`] = JSON.stringify(value)
+  }
+
+  return define
+}

package/src/index.ts

@@ -2,3 +2,11 @@ export { metroPlugin } from './plugins/metroPlugin'
 export type { MetroPluginOptions } from './plugins/metroPlugin'
 export { expoManifestRequestHandlerPlugin } from './plugins/expoManifestRequestHandlerPlugin'
 export type { ExpoManifestRequestHandlerPluginPluginOptions } from './plugins/expoManifestRequestHandlerPlugin'
+export {
+  getPlatformEnv,
+  getPlatformEnvDefine,
+  metroPlatformToViteEnvironment,
+  type Platform,
+  type PlatformEnv,
+  type ViteEnvironment,
+} from './env/platformEnv'

package/src/metro-config/getMetroBabelConfigFromViteConfig.ts

@@ -1,45 +1,34 @@
 import type { ResolvedConfig } from 'vite'
-
-// For Metro and Expo, we only import types here.
-// We use `projectImport` to dynamically import the actual modules
-// at runtime to ensure they are loaded from the user's project root.
-import type { loadConfig as loadConfigT } from 'metro'
-
 import type { TransformOptions } from '@babel/core'
 
-type MetroInputConfig = Parameters<typeof loadConfigT>[1]
-
+/**
+ * Creates babel config for Metro transforms from Vite config.
+ *
+ * Platform-specific env vars (VITE_ENVIRONMENT, VITE_PLATFORM, EXPO_OS, TAMAGUI_ENVIRONMENT)
+ * are handled by the import-meta-env-plugin based on caller.platform and always take precedence.
+ */
 export function getMetroBabelConfigFromViteConfig(
   config: ResolvedConfig
 ): TransformOptions {
-  const importMetaEnv = {
-    // https://vite.dev/guide/env-and-mode.html#built-in-constants
+  const importMetaEnv: Record<string, string | boolean | undefined> = {
     MODE: config.mode,
-    BASE_URL: 'https://vxrn.not.supported.yet',
+    BASE_URL: config.base,
     PROD: config.mode === 'production',
     DEV: config.mode === 'development',
     SSR: false,
   }
 
-  // Collect from process.env
   const envPrefix = config.envPrefix || 'VITE_'
-  if (envPrefix) {
-    Object.keys(config.env).forEach((key) => {
-      const shouldInclude = Array.isArray(envPrefix)
-        ? envPrefix.some((p) => key.startsWith(p))
-        : key.startsWith(envPrefix)
+  const prefixes = Array.isArray(envPrefix) ? envPrefix : [envPrefix]
 
-      if (shouldInclude) {
-        importMetaEnv[key] = process.env[key]
-      }
-    })
+  for (const key of Object.keys(config.env)) {
+    if (prefixes.some((p) => key.startsWith(p))) {
+      importMetaEnv[key] = process.env[key]
+    }
   }
 
   return {
     plugins: [
-      // Note that we can only pass Babel plugins by name here,
-      // since Metro will run Babel transformers in different threads
-      // and plugins are not serializable, it seems.
       [
         '@vxrn/vite-plugin-metro/babel-plugins/import-meta-env-plugin',
         { env: importMetaEnv },

package/types/babel-plugins/import-meta-env-plugin.d.ts

@@ -1,11 +1,15 @@
 import type { PluginObj } from '@babel/core';
 type PluginOptions = {
-    env?: Record<string, string | undefined>;
+    env?: Record<string, string | boolean | undefined>;
 };
 /**
- * A Babel plugin to replace `import.meta.env` and `import.meta.env.*` with the provided env variables.
+ * Babel plugin to replace `import.meta.env` and `import.meta.env.*` with env values.
  *
- * This plugin may not be referenced directly since metro runs transformers in separate workers, search for `@vxrn/vite-plugin-metro/babel-plugins/import-meta-env-plugin` to see how it's used.
+ * Platform-specific env vars (VITE_ENVIRONMENT, VITE_PLATFORM, EXPO_OS, TAMAGUI_ENVIRONMENT)
+ * are automatically injected based on the babel caller's platform.
+ *
+ * This plugin is referenced by name since Metro runs transformers in separate workers:
+ * '@vxrn/vite-plugin-metro/babel-plugins/import-meta-env-plugin'
  */
 export declare const importMetaEnvPlugin: (api: object, options: PluginOptions | null | undefined, dirname: string) => PluginObj<import("@babel/core").PluginPass>;
 export default importMetaEnvPlugin;

package/types/babel-plugins/import-meta-env-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-meta-env-plugin.d.ts","sourceRoot":"","sources":["../../src/babel-plugins/import-meta-env-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,KAAK,aAAa,GAAG;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACzC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,0HAkD9B,CAAA;AAEF,eAAe,mBAAmB,CAAA"}
+{"version":3,"file":"import-meta-env-plugin.d.ts","sourceRoot":"","sources":["../../src/babel-plugins/import-meta-env-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,KAAK,aAAa,GAAG;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;CACnD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,0HA8D9B,CAAA;AAEF,eAAe,mBAAmB,CAAA"}

package/types/env/platformEnv.d.ts

@@ -0,0 +1,16 @@
+export type Platform = 'ios' | 'android' | 'web';
+export type ViteEnvironment = 'client' | 'ssr' | 'ios' | 'android';
+export type PlatformEnv = {
+    VITE_ENVIRONMENT: ViteEnvironment;
+    VITE_PLATFORM: 'web' | 'native';
+    EXPO_OS: 'web' | 'ios' | 'android';
+    TAMAGUI_ENVIRONMENT: ViteEnvironment;
+};
+export declare function getPlatformEnv(environment: ViteEnvironment): PlatformEnv;
+export declare function metroPlatformToViteEnvironment(platform: Platform | string | null | undefined): ViteEnvironment;
+/**
+ * Format platform env for Vite's define config.
+ * Returns both process.env.* and import.meta.env.* definitions.
+ */
+export declare function getPlatformEnvDefine(environment: ViteEnvironment): Record<string, string>;
+//# sourceMappingURL=platformEnv.d.ts.map

package/types/env/platformEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformEnv.d.ts","sourceRoot":"","sources":["../../src/env/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,aAAa,EAAE,KAAK,GAAG,QAAQ,CAAA;IAC/B,OAAO,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;IAClC,mBAAmB,EAAE,eAAe,CAAA;CACrC,CAAA;AA6BD,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;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB"}

package/types/index.d.ts

@@ -2,4 +2,5 @@ export { metroPlugin } from './plugins/metroPlugin';
 export type { MetroPluginOptions } from './plugins/metroPlugin';
 export { expoManifestRequestHandlerPlugin } from './plugins/expoManifestRequestHandlerPlugin';
 export type { ExpoManifestRequestHandlerPluginPluginOptions } from './plugins/expoManifestRequestHandlerPlugin';
+export { getPlatformEnv, getPlatformEnvDefine, metroPlatformToViteEnvironment, type Platform, type PlatformEnv, type ViteEnvironment, } from './env/platformEnv';
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAA;AAC7F,YAAY,EAAE,6CAA6C,EAAE,MAAM,4CAA4C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAA;AAC7F,YAAY,EAAE,6CAA6C,EAAE,MAAM,4CAA4C,CAAA;AAC/G,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAA"}

package/types/metro-config/getMetroBabelConfigFromViteConfig.d.ts

@@ -1,4 +1,10 @@
 import type { ResolvedConfig } from 'vite';
 import type { TransformOptions } from '@babel/core';
+/**
+ * Creates babel config for Metro transforms from Vite config.
+ *
+ * Platform-specific env vars (VITE_ENVIRONMENT, VITE_PLATFORM, EXPO_OS, TAMAGUI_ENVIRONMENT)
+ * are handled by the import-meta-env-plugin based on caller.platform and always take precedence.
+ */
 export declare function getMetroBabelConfigFromViteConfig(config: ResolvedConfig): TransformOptions;
 //# sourceMappingURL=getMetroBabelConfigFromViteConfig.d.ts.map

package/types/metro-config/getMetroBabelConfigFromViteConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getMetroBabelConfigFromViteConfig.d.ts","sourceRoot":"","sources":["../../src/metro-config/getMetroBabelConfigFromViteConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAO1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAInD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAmClB"}
+{"version":3,"file":"getMetroBabelConfigFromViteConfig.d.ts","sourceRoot":"","sources":["../../src/metro-config/getMetroBabelConfigFromViteConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,cAAc,GACrB,gBAAgB,CA0BlB"}