@natsuneko-laboratory/memora 0.1.0 → 0.3.0

package/README.md

@@ -47,7 +47,7 @@ if (metadata) {
 function parseImageMetadata(input: ArrayBuffer | Uint8Array): Promise<ImageMetadata | null>;
 ```
 
-画像から 1 件のメタデータを取得します。複数形式が同居する場合は ResoniteScreenshotExtensions を優先し、それ以外は解析結果の先頭を返します。
+画像から 1 件のメタデータを取得します。複数形式が同居する場合は VRChat、VRCX、ResoniteScreenshotExtensions の順で優先します。
 
 `parsePhotoMetadata` はこの関数の別名です。
 
@@ -163,6 +163,8 @@ async function readScreenshot(uri: string, readBytes: (uri: string) => Promise<U
 
 `readBytes` には、アプリで採用しているファイルアクセスライブラリを使った読み取り関数を渡してください。URI、Base64、`File`、`Blob` をパーサーへ直接渡すことはできません。
 
+Metro は `react-native` 条件（従来の解決方式では同名のフィールド）から専用バンドルを読み込みます。Node.js モジュールのポリフィルや Metro の追加設定は不要です。
+
 ## 対応範囲と制約
 
 PNG の iTXt（非圧縮・zlib 圧縮）と XMP を読み取ります。ResoniteScreenshotExtensions の JPEG XMP にも対応します。
@@ -171,6 +173,10 @@ PNG の iTXt（非圧縮・zlib 圧縮）と XMP を読み取ります。Resonit
 
 コアは React やネイティブモジュールに依存しません。Node.js の `Buffer` / `process`、DOM、`TextDecoder` がない環境でのバンドルテストを用意しています。
 
+React Native 向けには、依存先 `exifr` の Node.js 専用ローダーを除いたバンドルを生成します。v0.1.0 では、このローダーの動的 `import` が Metro の依存解析エラーを起こしていました。Metro によるパッケージ解決・バンドルと、ホスト API のない環境での PNG・JPEG 解析を回帰テストで検証しています。iOS / Android 実機でのテストではありません。
+
+`navigator` が存在しても `userAgent` がない React Native 環境に対応するため、専用バンドルでは exifr のブラウザー描画補正用 UA 参照を空文字に置き換えます。アプリ側で `navigator.userAgent` を補完する必要はなく、グローバル変数も変更しません。
+
 ## 開発
 
 リポジトリを取得した後、パッケージのディレクトリで実行します。
@@ -186,7 +192,7 @@ npm run build
 
 `npm run typecheck` は本体とテストの両方を検証します。テストのみの型チェックには `npm run typecheck:test` を使用できます。
 
-ビルドすると、ESM と型定義が `dist/` に生成されます。インストール時のスクリプトを無効にしている場合は、利用前に `npm run build` を実行してください。
+ビルドすると、ESM、React Native 向けバンドル、型定義が `dist/` に生成されます。インストール時のスクリプトを無効にしている場合は、利用前に `npm run build` を実行してください。
 
 ## ライセンス
 

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { ImageMetadata, PhotoInput } from "./types.js";
 export type * from "./types.js";
 /** Read every recognized packet without dropping coexisting formats. Unknown formats return an empty array. */
 export declare const parseAllImageMetadata: (input: PhotoInput) => Promise<ImageMetadata[]>;
-/** Resonite takes precedence, matching steambird; use parseAllImageMetadata for mixed images. */
+/** Prefer VRChat, then VRCX, then ResoniteScreenshotExtensions for mixed images. */
 export declare const parseImageMetadata: (input: PhotoInput) => Promise<ImageMetadata | null>;
 /** Alias for existing callers. */
 export declare const parsePhotoMetadata: typeof parseImageMetadata;

package/dist/index.js

@@ -213,12 +213,23 @@ export const parseAllImageMetadata = async (input) => {
             }));
         }
     }
-    return result;
+    const priority = {
+        VRChat: 0,
+        VRCX: 1,
+        ResoniteScreenshotExtensions: 2,
+    };
+    // A screenshot can contain metadata written by more than one application.
+    // Keep duplicate records and their relative order, but expose the supported
+    // format precedence consistently to callers.
+    return result
+        .map((metadata, index) => ({ metadata, index }))
+        .sort((a, b) => priority[a.metadata.type] - priority[b.metadata.type] || a.index - b.index)
+        .map(({ metadata }) => metadata);
 };
-/** Resonite takes precedence, matching steambird; use parseAllImageMetadata for mixed images. */
+/** Prefer VRChat, then VRCX, then ResoniteScreenshotExtensions for mixed images. */
 export const parseImageMetadata = async (input) => {
     const results = await parseAllImageMetadata(input);
-    return (results.find((result) => result.type === "ResoniteScreenshotExtensions") ?? results[0] ?? null);
+    return results[0] ?? null;
 };
 /** Alias for existing callers. */
 export const parsePhotoMetadata = parseImageMetadata;