@penabt/pixi-expo 0.6.0 → 0.6.1

package/README.md

@@ -292,7 +292,7 @@ module.exports = config;
 
 ## Design Resolution
 
-Cocos2d-style fixed coordinate system for your game. Define a virtual resolution and the library automatically scales the stage to fit any device screen.
+Fixed coordinate system for your game. Define a virtual resolution and the library automatically scales the stage to fit any device screen.
 
 ```tsx
 <PixiView

package/dist/index.d.mts

@@ -543,13 +543,6 @@ declare const loadExpoFont: LoaderParser<string>;
  * ```
  */
 declare function registerBitmapFont(xmlModuleId: number, pageModuleIds: number[]): string;
-/**
- * Expo Bitmap Font Loader
- *
- * A PixiJS LoadParser that handles local bitmap fonts registered via
- * registerBitmapFont(). Runs at High priority to intercept before
- * PixiJS's built-in loadBitmapFont (which can't handle module IDs).
- */
 declare const loadExpoBitmapFont: LoaderParser;
 
 /**
@@ -627,7 +620,7 @@ declare function createExpoManifest(manifest: ExpoAssetsManifest): AssetsManifes
 /**
  * Design resolution scaling utilities.
  *
- * Provides Cocos2d-style design resolution support: define a fixed logical
+ * Provides design resolution support: define a fixed logical
  * size (e.g. 768×1024) and the library automatically scales the PixiJS stage
  * to fit the device screen.
  */

package/dist/index.d.ts

@@ -543,13 +543,6 @@ declare const loadExpoFont: LoaderParser<string>;
  * ```
  */
 declare function registerBitmapFont(xmlModuleId: number, pageModuleIds: number[]): string;
-/**
- * Expo Bitmap Font Loader
- *
- * A PixiJS LoadParser that handles local bitmap fonts registered via
- * registerBitmapFont(). Runs at High priority to intercept before
- * PixiJS's built-in loadBitmapFont (which can't handle module IDs).
- */
 declare const loadExpoBitmapFont: LoaderParser;
 
 /**
@@ -627,7 +620,7 @@ declare function createExpoManifest(manifest: ExpoAssetsManifest): AssetsManifes
 /**
  * Design resolution scaling utilities.
  *
- * Provides Cocos2d-style design resolution support: define a fixed logical
+ * Provides design resolution support: define a fixed logical
  * size (e.g. 768×1024) and the library automatically scales the PixiJS stage
  * to fit the device screen.
  */

package/dist/index.js

@@ -1463,6 +1463,7 @@ var loadExpoFont = {
 // src/adapter/loadExpoBitmapFont.ts
 var import_expo_asset3 = require("expo-asset");
 var import_expo_file_system = require("expo-file-system");
+var import_react_native2 = require("react-native");
 var import_pixi3 = require("pixi.js");
 var BMFONT_PREFIX = "__expo_bmfont_";
 var bitmapFontRegistry = /* @__PURE__ */ new Map();
@@ -1472,6 +1473,57 @@ function registerBitmapFont(xmlModuleId, pageModuleIds) {
   bitmapFontRegistry.set(key, { xmlModuleId, pageModuleIds });
   return key;
 }
+async function readTextFromUri(uri) {
+  console.log(`[bmfont] readTextFromUri: ${uri}`);
+  if (uri.startsWith("file:///android_asset/") || uri.startsWith("http://") || uri.startsWith("https://")) {
+    console.log(`[bmfont] Using fetch for: ${uri}`);
+    const response = await fetch(uri);
+    if (!response.ok) throw new Error(`HTTP ${response.status} for ${uri}`);
+    const text = await response.text();
+    console.log(`[bmfont] Fetch OK, length: ${text.length}`);
+    return text;
+  }
+  if (uri.startsWith("file://") || uri.startsWith("/")) {
+    const fileUri = uri.startsWith("/") ? `file://${uri}` : uri;
+    console.log(`[bmfont] Using File API for: ${fileUri}`);
+    const file = new import_expo_file_system.File(fileUri);
+    const content = await file.text();
+    console.log(`[bmfont] File read OK, length: ${content.length}`);
+    return content;
+  }
+  throw new Error(`Unsupported URI scheme: ${uri.substring(0, 30)}`);
+}
+function getMetroBaseUrl() {
+  try {
+    const scriptURL = import_react_native2.NativeModules.SourceCode?.getConstants?.()?.scriptURL ?? import_react_native2.NativeModules.SourceCode?.scriptURL;
+    if (scriptURL) {
+      const match = scriptURL.match(/^(https?:\/\/[^/]+)/);
+      if (match) return match[1];
+    }
+  } catch {
+  }
+  return null;
+}
+function getAndroidAssetCandidates(asset) {
+  const candidates = [];
+  const name = asset.name;
+  const type = asset.type;
+  const hash = asset.hash;
+  const metroBase = getMetroBaseUrl();
+  if (metroBase && name && type) {
+    candidates.push(`${metroBase}/assets/assets/fonts/${name}.${type}?platform=android`);
+    candidates.push(`${metroBase}/assets/fonts/${name}.${type}?platform=android`);
+  }
+  if (name && type) {
+    candidates.push(`file:///android_asset/assets/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/${name}.${type}`);
+  }
+  if (hash && type) {
+    candidates.push(`file:///android_asset/${hash}.${type}`);
+  }
+  return candidates;
+}
 var loadExpoBitmapFont = {
   extension: {
     type: import_pixi3.ExtensionType.LoadParser,
@@ -1492,20 +1544,61 @@ var loadExpoBitmapFont = {
       throw new Error(`[loadExpoBitmapFont] No registered bitmap font for key: ${url}`);
     }
     const expoAsset = import_expo_asset3.Asset.fromModule(entry.xmlModuleId);
-    await expoAsset.downloadAsync();
-    const localUri = expoAsset.localUri || expoAsset.uri;
-    if (!localUri) {
-      throw new Error(`[loadExpoBitmapFont] Failed to get local URI for XML asset`);
+    const errors = [];
+    console.log(`[bmfont] === Loading ${url} ===`);
+    console.log(`[bmfont] moduleId: ${entry.xmlModuleId}`);
+    console.log(`[bmfont] name: ${expoAsset.name}`);
+    console.log(`[bmfont] type: ${expoAsset.type}`);
+    console.log(`[bmfont] hash: ${expoAsset.hash}`);
+    console.log(`[bmfont] localUri: ${expoAsset.localUri}`);
+    console.log(`[bmfont] uri: ${expoAsset.uri}`);
+    console.log(`[bmfont] downloaded: ${expoAsset.downloaded}`);
+    console.log(`[bmfont] Platform: ${import_react_native2.Platform.OS}`);
+    if (expoAsset.localUri) {
+      console.log(`[bmfont] Strategy 1: localUri`);
+      try {
+        return await readTextFromUri(expoAsset.localUri);
+      } catch (e) {
+        console.log(`[bmfont] Strategy 1 FAILED: ${e.message}`);
+        errors.push(`localUri: ${e.message}`);
+      }
     }
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] Loading XML from: ${localUri}`);
+    if (import_react_native2.Platform.OS === "android") {
+      const candidates = getAndroidAssetCandidates(expoAsset);
+      console.log(`[bmfont] Strategy 2: trying ${candidates.length} android_asset candidates`);
+      console.log(`[bmfont] httpServerLocation: ${expoAsset.httpServerLocation}`);
+      for (const candidate of candidates) {
+        try {
+          console.log(`[bmfont] Trying: ${candidate}`);
+          const content = await readTextFromUri(candidate);
+          console.log(`[bmfont] SUCCESS with: ${candidate}`);
+          return content;
+        } catch (e) {
+          console.log(`[bmfont] Failed: ${candidate} \u2192 ${e.message}`);
+        }
+      }
+      errors.push(`android_asset: all ${candidates.length} candidates failed`);
     }
-    const file = new import_expo_file_system.File(localUri);
-    const content = await file.text();
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] XML content length: ${content.length}`);
+    console.log(`[bmfont] Strategy 3: downloadAsync`);
+    try {
+      await expoAsset.downloadAsync();
+      console.log(`[bmfont] downloadAsync OK, localUri: ${expoAsset.localUri}`);
+      const uri = expoAsset.localUri || expoAsset.uri;
+      if (uri) return await readTextFromUri(uri);
+    } catch (e) {
+      console.log(`[bmfont] Strategy 3 FAILED: ${e.message}`);
+      errors.push(`downloadAsync: ${e.message}`);
     }
-    return content;
+    if (expoAsset.uri) {
+      console.log(`[bmfont] Strategy 4: uri \u2192 ${expoAsset.uri}`);
+      try {
+        return await readTextFromUri(expoAsset.uri);
+      } catch (e) {
+        console.log(`[bmfont] Strategy 4 FAILED: ${e.message}`);
+        errors.push(`uri(${expoAsset.uri.substring(0, 50)}): ${e.message}`);
+      }
+    }
+    throw new Error(`[loadExpoBitmapFont] All strategies failed for ${url}: ${errors.join("; ")}`);
   },
   async parse(asset, data, loader) {
     if (__DEV__) console.log(`[loadExpoBitmapFont] parse() called, src=${data.src}`);
@@ -1611,16 +1704,16 @@ function createExpoManifest(manifest) {
 
 // src/components/PixiView.tsx
 var import_react = require("react");
-var import_react_native3 = require("react-native");
+var import_react_native4 = require("react-native");
 var import_expo_gl = require("expo-gl");
 var import_pixi4 = require("pixi.js");
 
 // src/utils/touchEventBridge.ts
-var import_react_native2 = require("react-native");
+var import_react_native3 = require("react-native");
 var touchPositions = /* @__PURE__ */ new Map();
 function createPointerEvent(touch, eventType, options, isPrimary, nativeEvent) {
   const { canvas, offsetX = 0, offsetY = 0 } = options;
-  const ratio = import_react_native2.PixelRatio.get();
+  const ratio = import_react_native3.PixelRatio.get();
   const x = (touch.locationX ?? touch.pageX - offsetX) * ratio;
   const y = (touch.locationY ?? touch.pageY - offsetY) * ratio;
   const prevPos = touchPositions.get(touch.identifier);
@@ -1838,7 +1931,7 @@ var PixiView = (0, import_react.forwardRef)((props, ref) => {
       const { width, height } = event.nativeEvent.layout;
       layoutRef.current = { width, height };
       if (appRef.current) {
-        const res = resolution || import_react_native3.PixelRatio.get();
+        const res = resolution || import_react_native4.PixelRatio.get();
         appRef.current.renderer.resize(width * res, height * res);
         applyDesignScale(appRef.current, width, height);
       }
@@ -1947,7 +2040,7 @@ var PixiView = (0, import_react.forwardRef)((props, ref) => {
   const handleContextCreate = (0, import_react.useCallback)(
     async (gl) => {
       glRef.current = gl;
-      const pixelRatio = import_react_native3.PixelRatio.get();
+      const pixelRatio = import_react_native4.PixelRatio.get();
       const { width: layoutWidth, height: layoutHeight } = layoutRef.current;
       const logicalWidth = layoutWidth || gl.drawingBufferWidth / pixelRatio;
       const logicalHeight = layoutHeight || gl.drawingBufferHeight / pixelRatio;
@@ -2052,7 +2145,7 @@ var PixiView = (0, import_react.forwardRef)((props, ref) => {
     onResponderTerminationRequest: () => true
   } : {};
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-    import_react_native3.View,
+    import_react_native4.View,
     {
       ref: containerRef,
       style: [styles.container, style],
@@ -2063,7 +2156,7 @@ var PixiView = (0, import_react.forwardRef)((props, ref) => {
   );
 });
 PixiView.displayName = "PixiView";
-var styles = import_react_native3.StyleSheet.create({
+var styles = import_react_native4.StyleSheet.create({
   container: {
     flex: 1,
     overflow: "hidden"

package/dist/index.mjs

@@ -1371,6 +1371,7 @@ var loadExpoFont = {
 // src/adapter/loadExpoBitmapFont.ts
 import { Asset as Asset3 } from "expo-asset";
 import { File } from "expo-file-system";
+import { Platform, NativeModules } from "react-native";
 import {
   ExtensionType as ExtensionType3,
   LoaderParserPriority as LoaderParserPriority2,
@@ -1386,6 +1387,57 @@ function registerBitmapFont(xmlModuleId, pageModuleIds) {
   bitmapFontRegistry.set(key, { xmlModuleId, pageModuleIds });
   return key;
 }
+async function readTextFromUri(uri) {
+  console.log(`[bmfont] readTextFromUri: ${uri}`);
+  if (uri.startsWith("file:///android_asset/") || uri.startsWith("http://") || uri.startsWith("https://")) {
+    console.log(`[bmfont] Using fetch for: ${uri}`);
+    const response = await fetch(uri);
+    if (!response.ok) throw new Error(`HTTP ${response.status} for ${uri}`);
+    const text = await response.text();
+    console.log(`[bmfont] Fetch OK, length: ${text.length}`);
+    return text;
+  }
+  if (uri.startsWith("file://") || uri.startsWith("/")) {
+    const fileUri = uri.startsWith("/") ? `file://${uri}` : uri;
+    console.log(`[bmfont] Using File API for: ${fileUri}`);
+    const file = new File(fileUri);
+    const content = await file.text();
+    console.log(`[bmfont] File read OK, length: ${content.length}`);
+    return content;
+  }
+  throw new Error(`Unsupported URI scheme: ${uri.substring(0, 30)}`);
+}
+function getMetroBaseUrl() {
+  try {
+    const scriptURL = NativeModules.SourceCode?.getConstants?.()?.scriptURL ?? NativeModules.SourceCode?.scriptURL;
+    if (scriptURL) {
+      const match = scriptURL.match(/^(https?:\/\/[^/]+)/);
+      if (match) return match[1];
+    }
+  } catch {
+  }
+  return null;
+}
+function getAndroidAssetCandidates(asset) {
+  const candidates = [];
+  const name = asset.name;
+  const type = asset.type;
+  const hash = asset.hash;
+  const metroBase = getMetroBaseUrl();
+  if (metroBase && name && type) {
+    candidates.push(`${metroBase}/assets/assets/fonts/${name}.${type}?platform=android`);
+    candidates.push(`${metroBase}/assets/fonts/${name}.${type}?platform=android`);
+  }
+  if (name && type) {
+    candidates.push(`file:///android_asset/assets/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/${name}.${type}`);
+  }
+  if (hash && type) {
+    candidates.push(`file:///android_asset/${hash}.${type}`);
+  }
+  return candidates;
+}
 var loadExpoBitmapFont = {
   extension: {
     type: ExtensionType3.LoadParser,
@@ -1406,20 +1458,61 @@ var loadExpoBitmapFont = {
       throw new Error(`[loadExpoBitmapFont] No registered bitmap font for key: ${url}`);
     }
     const expoAsset = Asset3.fromModule(entry.xmlModuleId);
-    await expoAsset.downloadAsync();
-    const localUri = expoAsset.localUri || expoAsset.uri;
-    if (!localUri) {
-      throw new Error(`[loadExpoBitmapFont] Failed to get local URI for XML asset`);
+    const errors = [];
+    console.log(`[bmfont] === Loading ${url} ===`);
+    console.log(`[bmfont] moduleId: ${entry.xmlModuleId}`);
+    console.log(`[bmfont] name: ${expoAsset.name}`);
+    console.log(`[bmfont] type: ${expoAsset.type}`);
+    console.log(`[bmfont] hash: ${expoAsset.hash}`);
+    console.log(`[bmfont] localUri: ${expoAsset.localUri}`);
+    console.log(`[bmfont] uri: ${expoAsset.uri}`);
+    console.log(`[bmfont] downloaded: ${expoAsset.downloaded}`);
+    console.log(`[bmfont] Platform: ${Platform.OS}`);
+    if (expoAsset.localUri) {
+      console.log(`[bmfont] Strategy 1: localUri`);
+      try {
+        return await readTextFromUri(expoAsset.localUri);
+      } catch (e) {
+        console.log(`[bmfont] Strategy 1 FAILED: ${e.message}`);
+        errors.push(`localUri: ${e.message}`);
+      }
     }
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] Loading XML from: ${localUri}`);
+    if (Platform.OS === "android") {
+      const candidates = getAndroidAssetCandidates(expoAsset);
+      console.log(`[bmfont] Strategy 2: trying ${candidates.length} android_asset candidates`);
+      console.log(`[bmfont] httpServerLocation: ${expoAsset.httpServerLocation}`);
+      for (const candidate of candidates) {
+        try {
+          console.log(`[bmfont] Trying: ${candidate}`);
+          const content = await readTextFromUri(candidate);
+          console.log(`[bmfont] SUCCESS with: ${candidate}`);
+          return content;
+        } catch (e) {
+          console.log(`[bmfont] Failed: ${candidate} \u2192 ${e.message}`);
+        }
+      }
+      errors.push(`android_asset: all ${candidates.length} candidates failed`);
     }
-    const file = new File(localUri);
-    const content = await file.text();
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] XML content length: ${content.length}`);
+    console.log(`[bmfont] Strategy 3: downloadAsync`);
+    try {
+      await expoAsset.downloadAsync();
+      console.log(`[bmfont] downloadAsync OK, localUri: ${expoAsset.localUri}`);
+      const uri = expoAsset.localUri || expoAsset.uri;
+      if (uri) return await readTextFromUri(uri);
+    } catch (e) {
+      console.log(`[bmfont] Strategy 3 FAILED: ${e.message}`);
+      errors.push(`downloadAsync: ${e.message}`);
     }
-    return content;
+    if (expoAsset.uri) {
+      console.log(`[bmfont] Strategy 4: uri \u2192 ${expoAsset.uri}`);
+      try {
+        return await readTextFromUri(expoAsset.uri);
+      } catch (e) {
+        console.log(`[bmfont] Strategy 4 FAILED: ${e.message}`);
+        errors.push(`uri(${expoAsset.uri.substring(0, 50)}): ${e.message}`);
+      }
+    }
+    throw new Error(`[loadExpoBitmapFont] All strategies failed for ${url}: ${errors.join("; ")}`);
   },
   async parse(asset, data, loader) {
     if (__DEV__) console.log(`[loadExpoBitmapFont] parse() called, src=${data.src}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penabt/pixi-expo",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "PixiJS v8 adapter for React Native Expo. Enables hardware-accelerated 2D graphics using expo-gl WebGL context.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/adapter/loadExpoBitmapFont.ts

@@ -16,6 +16,7 @@
 
 import { Asset } from 'expo-asset';
 import { File } from 'expo-file-system';
+import { Platform, NativeModules } from 'react-native';
 import {
   ExtensionType,
   LoaderParserPriority,
@@ -90,6 +91,82 @@ export function registerBitmapFont(xmlModuleId: number, pageModuleIds: number[])
  * registerBitmapFont(). Runs at High priority to intercept before
  * PixiJS's built-in loadBitmapFont (which can't handle module IDs).
  */
+/** Read text from a URI using the most appropriate method */
+async function readTextFromUri(uri: string): Promise<string> {
+  console.log(`[bmfont] readTextFromUri: ${uri}`);
+
+  // android_asset or http(s) → use fetch (RN's fetch supports file:///android_asset/)
+  if (uri.startsWith('file:///android_asset/') || uri.startsWith('http://') || uri.startsWith('https://')) {
+    console.log(`[bmfont] Using fetch for: ${uri}`);
+    const response = await fetch(uri);
+    if (!response.ok) throw new Error(`HTTP ${response.status} for ${uri}`);
+    const text = await response.text();
+    console.log(`[bmfont] Fetch OK, length: ${text.length}`);
+    return text;
+  }
+
+  // file:// or absolute path → use expo-file-system File API
+  if (uri.startsWith('file://') || uri.startsWith('/')) {
+    const fileUri = uri.startsWith('/') ? `file://${uri}` : uri;
+    console.log(`[bmfont] Using File API for: ${fileUri}`);
+    const file = new File(fileUri);
+    const content = await file.text();
+    console.log(`[bmfont] File read OK, length: ${content.length}`);
+    return content;
+  }
+
+  throw new Error(`Unsupported URI scheme: ${uri.substring(0, 30)}`);
+}
+
+/**
+ * Get Metro dev server base URL from the JS bundle source URL.
+ * Returns null if not available (e.g., production build).
+ */
+function getMetroBaseUrl(): string | null {
+  try {
+    const scriptURL: string | undefined =
+      NativeModules.SourceCode?.getConstants?.()?.scriptURL ??
+      (NativeModules.SourceCode as any)?.scriptURL;
+    if (scriptURL) {
+      // scriptURL is like "http://192.168.1.105:8081/index.bundle?platform=android&..."
+      const match = scriptURL.match(/^(https?:\/\/[^/]+)/);
+      if (match) return match[1];
+    }
+  } catch {}
+  return null;
+}
+
+/**
+ * Generate candidate URIs for reading a font asset on Android.
+ * Includes both Metro HTTP URLs (dev) and APK asset paths (prod).
+ */
+function getAndroidAssetCandidates(asset: Asset): string[] {
+  const candidates: string[] = [];
+  const name = asset.name;
+  const type = asset.type;
+  const hash = asset.hash;
+
+  // In dev builds, Metro serves assets over HTTP
+  const metroBase = getMetroBaseUrl();
+  if (metroBase && name && type) {
+    // Metro asset URL patterns
+    candidates.push(`${metroBase}/assets/assets/fonts/${name}.${type}?platform=android`);
+    candidates.push(`${metroBase}/assets/fonts/${name}.${type}?platform=android`);
+  }
+
+  // file:///android_asset/ patterns for production builds
+  if (name && type) {
+    candidates.push(`file:///android_asset/assets/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/fonts/${name}.${type}`);
+    candidates.push(`file:///android_asset/${name}.${type}`);
+  }
+  if (hash && type) {
+    candidates.push(`file:///android_asset/${hash}.${type}`);
+  }
+
+  return candidates;
+}
+
 export const loadExpoBitmapFont = {
   extension: {
     type: ExtensionType.LoadParser,
@@ -114,29 +191,63 @@ export const loadExpoBitmapFont = {
       throw new Error(`[loadExpoBitmapFont] No registered bitmap font for key: ${url}`);
     }
 
-    // Resolve XML module ID to local URI via expo-asset
     const expoAsset = Asset.fromModule(entry.xmlModuleId);
-    await expoAsset.downloadAsync();
-
-    const localUri = expoAsset.localUri || expoAsset.uri;
-    if (!localUri) {
-      throw new Error(`[loadExpoBitmapFont] Failed to get local URI for XML asset`);
+    const errors: string[] = [];
+
+    console.log(`[bmfont] === Loading ${url} ===`);
+    console.log(`[bmfont] moduleId: ${entry.xmlModuleId}`);
+    console.log(`[bmfont] name: ${expoAsset.name}`);
+    console.log(`[bmfont] type: ${expoAsset.type}`);
+    console.log(`[bmfont] hash: ${expoAsset.hash}`);
+    console.log(`[bmfont] localUri: ${expoAsset.localUri}`);
+    console.log(`[bmfont] uri: ${expoAsset.uri}`);
+    console.log(`[bmfont] downloaded: ${expoAsset.downloaded}`);
+    console.log(`[bmfont] Platform: ${Platform.OS}`);
+
+    // Strategy 1: localUri already available (iOS native builds)
+    if (expoAsset.localUri) {
+      console.log(`[bmfont] Strategy 1: localUri`);
+      try {
+        return await readTextFromUri(expoAsset.localUri);
+      } catch (e: any) { console.log(`[bmfont] Strategy 1 FAILED: ${e.message}`); errors.push(`localUri: ${e.message}`); }
     }
 
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] Loading XML from: ${localUri}`);
+    // Strategy 2: Android bundled asset — try multiple path patterns
+    if (Platform.OS === 'android') {
+      const candidates = getAndroidAssetCandidates(expoAsset);
+      console.log(`[bmfont] Strategy 2: trying ${candidates.length} android_asset candidates`);
+      console.log(`[bmfont] httpServerLocation: ${(expoAsset as any).httpServerLocation}`);
+      for (const candidate of candidates) {
+        try {
+          console.log(`[bmfont] Trying: ${candidate}`);
+          const content = await readTextFromUri(candidate);
+          console.log(`[bmfont] SUCCESS with: ${candidate}`);
+          return content;
+        } catch (e: any) {
+          console.log(`[bmfont] Failed: ${candidate} → ${e.message}`);
+        }
+      }
+      errors.push(`android_asset: all ${candidates.length} candidates failed`);
     }
 
-    // Read file content via expo-file-system's File API
-    // (React Native's fetch/XHR don't reliably support file:// URIs)
-    const file = new File(localUri);
-    const content = await file.text();
-
-    if (__DEV__) {
-      console.log(`[loadExpoBitmapFont] XML content length: ${content.length}`);
+    // Strategy 3: downloadAsync → localUri (works in Expo Go / dev client)
+    console.log(`[bmfont] Strategy 3: downloadAsync`);
+    try {
+      await expoAsset.downloadAsync();
+      console.log(`[bmfont] downloadAsync OK, localUri: ${expoAsset.localUri}`);
+      const uri = expoAsset.localUri || expoAsset.uri;
+      if (uri) return await readTextFromUri(uri);
+    } catch (e: any) { console.log(`[bmfont] Strategy 3 FAILED: ${e.message}`); errors.push(`downloadAsync: ${e.message}`); }
+
+    // Strategy 4: expo-asset uri (may be HTTP in dev, or asset:// scheme)
+    if (expoAsset.uri) {
+      console.log(`[bmfont] Strategy 4: uri → ${expoAsset.uri}`);
+      try {
+        return await readTextFromUri(expoAsset.uri);
+      } catch (e: any) { console.log(`[bmfont] Strategy 4 FAILED: ${e.message}`); errors.push(`uri(${expoAsset.uri.substring(0, 50)}): ${e.message}`); }
     }
 
-    return content;
+    throw new Error(`[loadExpoBitmapFont] All strategies failed for ${url}: ${errors.join('; ')}`);
   },
 
   async parse(asset: string, data: ResolvedAsset, loader: Loader): Promise<any> {

package/src/index.ts

@@ -180,7 +180,7 @@ export type { PixiViewProps, PixiViewHandle } from './components/PixiView';
 
 // =============================================================================
 // EXPORTS: DESIGN RESOLUTION
-// Cocos2d-style design resolution utilities for fixed coordinate systems.
+// Design resolution utilities for fixed coordinate systems.
 // =============================================================================
 
 export { calculateDesignScale, calculateDesignSafeArea } from './utils/designResolution';

package/src/utils/designResolution.ts

@@ -1,7 +1,7 @@
 /**
  * Design resolution scaling utilities.
  *
- * Provides Cocos2d-style design resolution support: define a fixed logical
+ * Provides design resolution support: define a fixed logical
  * size (e.g. 768×1024) and the library automatically scales the PixiJS stage
  * to fit the device screen.
  */