Document assets-registry package, add TS definitions

Summary:
Quality pass on the `assets-registry` package ahead of the next diff.

- Add user-facing notes to package README.
- Add adjacent `.d.ts` definitions (manually/AI-maintained is fine at this scale).
- Move source files to `src/` (`"exports"` map added; no breaking changes).

Changelog: [Internal]

Differential Revision: D108624321

Author: huntie

packages/assets-registry/README.md

@@ -1,21 +1,26 @@
 # @react-native/assets-registry
 
-[![Version][version-badge]][package]
+![npm package](https://img.shields.io/npm/v/@react-native/assets-registry?color=brightgreen&label=npm%20package)
 
-## Installation
+Runtime registry that maps asset IDs generated in a Metro bundle to asset metadata. It backs `<Image>`, `Image.resolveAssetSource()`, and any code that resolves `require('./img.png')` on native.
 
-```
-yarn add --dev @react-native/assets-registry
-```
+Most apps never import this directly — assets are handled through `<Image>`.
 
-*Note: We're using `yarn` to install deps. Feel free to change commands to use `npm` 3+ and `npx` if you like*
+## API
 
-[version-badge]: https://img.shields.io/npm/v/@react-native/assets-registry?style=flat-square
-[package]: https://www.npmjs.com/package/@react-native/assets-registry
+### `@react-native/assets-registry/registry`
 
-## Testing
+| Export | Signature | Notes |
+|---|---|---|
+| `registerAsset` | `(asset: PackagerAsset) => number` | Stores the asset; returns a numeric ID |
+| `getAssetByID` | `(assetId: number) => PackagerAsset` | Looks an asset back up by ID |
 
-To run the tests in this package, run the following commands from the React Native root folder:
+### `@react-native/assets-registry/path-support`
 
-1. `yarn` to install the dependencies. You just need to run this once
-2. `yarn jest packages/assets-registry`.
+Android resource-path helpers, used when copying assets into `drawable-*` folders.
+
+| Export | Signature | Notes |
+|---|---|---|
+| `getAndroidResourceFolderName` | `(asset: PackagerAsset, scale: number) => string` | e.g. `drawable-xhdpi`; non-drawable types resolve to `raw` |
+| `getAndroidResourceIdentifier` | `(asset: PackagerAsset) => string` | Sanitised resource name |
+| `getBasePath` | `(asset: PackagerAsset) => string` | `httpServerLocation` without the leading slash |

packages/assets-registry/package.json

@@ -10,19 +10,19 @@
   },
   "homepage": "https://github.com/facebook/react-native/tree/HEAD/packages/assets-registry#readme",
   "keywords": [
-    "assets",
-    "registry",
-    "react-native",
-    "support"
+    "react-native"
   ],
   "bugs": "https://github.com/facebook/react-native/issues",
   "engines": {
     "node": "^22.13.0 || ^24.3.0 || >= 26.0.0"
   },
+  "exports": {
+    "./path-support": "./src/path-support.js",
+    "./registry": "./src/registry.js",
+    "./package.json": "./package.json"
+  },
   "files": [
-    "path-support.js",
-    "registry.js",
-    "README.md",
+    "src",
     "!**/__docs__/**",
     "!**/__fixtures__/**",
     "!**/__mocks__/**",

…-registry/__tests__/path-support-test.js …istry/src/__tests__/path-support-test.jspackages/assets-registry/__tests__/path-support-test.js renamed to packages/assets-registry/src/__tests__/path-support-test.js packages/assets-registry/__tests__/path-support-test.js renamed to packages/assets-registry/src/__tests__/path-support-test.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+import type {PackagerAsset} from './registry';
+
+export function getAndroidResourceFolderName(
+  asset: PackagerAsset,
+  scale: number,
+): string;
+
+export function getAndroidResourceIdentifier(asset: PackagerAsset): string;
+
+export function getBasePath(asset: PackagerAsset): string;

packages/assets-registry/src/path-support.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+export type AssetDestPathResolver = 'android' | 'generic';
+
+export type PackagerAsset = {
+  readonly __packager_asset: boolean;
+  readonly fileSystemLocation: string;
+  readonly httpServerLocation: string;
+  readonly width: number | null | undefined;
+  readonly height: number | null | undefined;
+  readonly scales: Array<number>;
+  readonly hash: string;
+  readonly name: string;
+  readonly type: string;
+  readonly resolver?: AssetDestPathResolver | undefined;
+};
+
+export function registerAsset(asset: PackagerAsset): number;
+
+export function getAssetByID(assetId: number): PackagerAsset;

packages/assets-registry/path-support.js …ages/assets-registry/src/path-support.jspackages/assets-registry/path-support.js renamed to packages/assets-registry/src/path-support.js packages/assets-registry/path-support.js renamed to packages/assets-registry/src/path-support.js

@@ -40,5 +40,7 @@ function getAssetByID(assetId /*: number */) /*: PackagerAsset */ {
   return assets[assetId - 1];
 }
 
-// eslint-disable-next-line @react-native/monorepo/no-commonjs-exports
-module.exports = {registerAsset, getAssetByID};
+module.exports = {
+  registerAsset,
+  getAssetByID,
+};