@symbiote-native/image-picker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# @symbiote-native/image-picker
+
+Let users choose a photo or video from their library, or take one with the camera. One API for
+every [SymbioteNative](../../README.md) adapter (React, Vue, Svelte, Solid and Angular).
+
+It wraps [`expo-image-picker`](https://github.com/expo/expo/tree/main/packages/expo-image-picker),
+which opens the system picker UI, the same way
+[`@symbiote-native/document-picker`](../document-picker) wraps its upstream: `expo-modules-core` is
+a direct dependency, never the `expo` meta-package, and the upstream JS is hand-ported into
+`core/`. The mechanics live in the `symbiote-expo-native-module` project skill.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --image-picker
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --image-picker
+```
+
+Either way: installs `@symbiote-native/image-picker` and wires the native autolinking
+automatically - see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/image-picker
+```
+
+`expo-image-picker` and `expo-modules-core` come along as regular, pinned dependencies - never
+install either yourself, and never add the `expo` meta-package to this project (it bundles its
+own Metro/Babel pipeline that conflicts with this project's own).
+
+### Required one-time step: native autolinking wiring
+
+Unlike a plain RN native module, `expo-image-picker`'s native code is discovered by
+`expo-modules-autolinking` - this needs wiring into the native host app **once**, covering this
+package and every other `expo-modules-core` package with zero further changes:
+
+| Platform | Touches                                                                               |
+| -------- | ------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` - add `use_expo_modules!`                                               |
+| iOS      | `AppDelegate.swift` - Expo's runtime-bootstrap hook                                   |
+| Android  | `settings.gradle` / `app/build.gradle` - resolve and include the Expo Gradle projects |
+| Android  | `MainApplication.kt` - Expo's bootstrap hook, plus a native-module name map           |
+
+Full mechanics live in the `symbiote-expo-native-module` skill. The per-package half of that
+table - the Gradle dependency and the module map entry - is generated by
+[`@symbiote-native/expo-modules-link`](../expo-modules-link) from this package's
+`native-link.json` on every install.
+
+### Permissions this package requests
+
+- **iOS `Info.plist` keys** (generated automatically): `NSPhotoLibraryUsageDescription`,
+  `NSCameraUsageDescription`, `NSMicrophoneUsageDescription` - reword the strings in
+  `native-link.json` if the defaults don't fit your app.
+- **Android `RECORD_AUDIO`** (generated automatically) - needed because the camera picker can
+  record video with sound. `CAMERA`, `READ_MEDIA_IMAGES`, `READ_MEDIA_VIDEO`, and the pre-33
+  storage permissions ship in `expo-image-picker`'s own `AndroidManifest.xml` and merge in
+  automatically once the Gradle project is included - nothing to declare for those.
+
+</details>
+
+## Shape
+
+```
+src/core/                 launchCameraAsync + launchImageLibraryAsync + getPendingResultAsync +
+                          the permission functions + the shared permission-hook runtime.
+                          native-module.ts resolves ExponentImagePicker through
+                          expo-modules-core's requireNativeModule.
+src/react/                useCameraPermissions + useMediaLibraryPermissions (hooks)
+src/vue/                  useCameraPermissions + useMediaLibraryPermissions (composables)
+src/solid/                useCameraPermissions + useMediaLibraryPermissions (primitives)
+src/svelte/               useCameraPermissions + useMediaLibraryPermissions (runes)
+src/angular/              CameraPermissionsService + MediaLibraryPermissionsService (DI)
+```
+
+`launchCameraAsync`/`launchImageLibraryAsync`/`getPendingResultAsync` stay framework-agnostic free
+functions, re-exported by every adapter's own barrel. Upstream's `useCameraPermissions`/
+`useMediaLibraryPermissions` are ported to **every** adapter, not just React: React/Vue/Solid
+bind `createPermissionHook` from `@symbiote-native/{react,vue,solid}` (the method-dispatch
+plumbing lives once in `@symbiote-native/engine`'s `permission-hook-runtime.ts`), Svelte binds it
+from `@symbiote-native/svelte/runes/create-permission-hook`, Angular ships
+`CameraPermissionsService`/`MediaLibraryPermissionsService`.
+
+## Use it
+
+```ts
+import { launchImageLibraryAsync, requestMediaLibraryPermissionsAsync } from '@symbiote-native/image-picker';
+
+await requestMediaLibraryPermissionsAsync();
+const result = await launchImageLibraryAsync({ mediaTypes: 'images', quality: 0.8 });
+if (!result.canceled) {
+  console.log(result.assets[0].uri);
+}
+```
+
+Taking a photo:
+
+```ts
+import { launchCameraAsync, requestCameraPermissionsAsync } from '@symbiote-native/image-picker';
+
+await requestCameraPermissionsAsync();
+const result = await launchCameraAsync({ allowsEditing: true });
+```
+
+## API
+
+| Export                              | Signature                                                         | Notes                                    |
+| ------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------ |
+| `launchCameraAsync`                 | `(options?: IImagePickerOptions) => Promise<IImagePickerResult>`     | Throws `UnavailabilityError` if absent.  |
+| `launchImageLibraryAsync`           | `(options?: IImagePickerOptions) => Promise<IImagePickerResult>`     |                                             |
+| `getCameraPermissionsAsync`         | `() => Promise<ICameraPermissionResponse>`                          |                                             |
+| `requestCameraPermissionsAsync`     | `() => Promise<ICameraPermissionResponse>`                          |                                             |
+| `getMediaLibraryPermissionsAsync`   | `(writeOnly?: boolean) => Promise<IMediaLibraryPermissionResponse>`  |                                             |
+| `requestMediaLibraryPermissionsAsync` | `(writeOnly?: boolean) => Promise<IMediaLibraryPermissionResponse>` |                                             |
+| `getPendingResultAsync`             | `() => Promise<IImagePickerResult \| IImagePickerErrorResult \| null>` | Android only - resolves `null` on iOS.   |
+
+`IImagePickerOptions` carries the full upstream surface: `allowsEditing`, `aspect`, `shape`,
+`quality`, `mediaTypes`, `exif`, `base64`, `videoExportPreset`, `videoQuality`,
+`allowsMultipleSelection`, `selectionLimit`, `orderedSelection`, `defaultTab`, `videoMaxDuration`,
+`presentationStyle`, `cameraType`, `preferredAssetRepresentationMode`, `legacy`,
+`shouldDownloadFromNetwork`.
+
+## Declarative permission hooks
+
+```
+useCameraPermissions()        -> [status, requestPermission, getPermission]        (React/Vue/Solid)
+useMediaLibraryPermissions({ writeOnly? }) -> same shape, plus writeOnly forwarding
+```
+
+React/Vue/Solid match upstream's tuple return; Svelte returns `{ status, requestPermission,
+getPermission }` (a boxed getter, matching this repo's own rune idiom); Angular exposes
+`CameraPermissionsService`/`MediaLibraryPermissionsService` (`connect()` returns a signal,
+`get()`/`request()` are imperative), same DI shape as `@symbiote-native/brightness`'s own
+`PermissionsService`.
+
+## Notes
+
+- **`allowsEditing` + `allowsMultipleSelection` together only warns**, matching upstream: the
+  native side silently ignores `allowsEditing` in that case rather than throwing.
+- **Deprecated `MediaTypeOptions` enum still works** (ported for parity) but logs a console
+  warning pointing at the string/array `mediaTypes` form upstream now prefers.
+- **Check `canceled` before reading `assets`.** The result is a union: `assets` is `null` when the
+  user backs out.
+- **Android can kill your app while the camera is open.** Call `getPendingResultAsync()` on launch to
+  recover a result that arrived while the activity was destroyed.
+- **Web-only fields dropped**: `ImagePickerAsset.file`, `ImagePickerResult.output`, and the
+  `base64`/`capture` fields of the internal web-only options type - this package targets
+  iOS/Android only, matching `expo-module.config.json`'s `platforms: ["apple", "android"]`.
+
+## Common questions
+
+- **Permission before opening the library?** None needed to launch it. Ask only when needed, for
+  example for videos on iOS when `allowsEditing` is `false` and the export preset is the default.
+- **Camera does not open on the iOS Simulator.** It has no camera; use a device.
+- **Android: result never arrives after the camera.** Android can destroy the activity; call
+  `getPendingResultAsync()` on launch.
+- **Smaller file.** Lower `quality`, and resize with
+  [`@symbiote-native/image-manipulator`](../image-manipulator).
+- **Base64 or EXIF.** `base64: true` / `exif: true` add them to each asset.
+- **Wrong crop rectangle on iOS.** An upstream `UIImagePickerController` bug.
+
+Sources: [Expo docs: ImagePicker](https://docs.expo.dev/versions/latest/sdk/imagepicker/),
+[expo/expo#20482](https://github.com/expo/expo/issues/20482),
+[expo/expo#11752](https://github.com/expo/expo/issues/11752).
+
+## Test it
+
+```bash
+pnpm vitest run packages/image-picker
+```
+
+The core tests fake the native module in place of `requireNativeModule`'s runtime resolution -
+`ExponentImagePicker` only exists on a device, so a headless run would otherwise throw at import.
+Two cases are ported directly from upstream's `src/__tests__/ImagePicker-test.native.ts`
+(`launchCameraAsync`/`launchImageLibraryAsync` default to an empty options object); the rest is
+net-new coverage of option validation, permission delegation, and the Android-only
+`getPendingResultAsync` branch. Upstream's other test suite
+(`plugin/src/__tests__/withImagePicker-test.ts`) exercises the config-plugin's own internals -
+build-time code this project doesn't carry over (native config here is static
+`native-link.json`, not a plugin we run), so it isn't ported.

package/build/angular/index.d.ts

@@ -0,0 +1,3 @@
+export * from '../core';
+export { CameraPermissionsService } from './services/camera-permissions.service';
+export { MediaLibraryPermissionsService } from './services/media-library-permissions.service';

package/build/angular/index.js

@@ -0,0 +1,3 @@
+export * from '../core/index.js';
+export { CameraPermissionsService } from './services/camera-permissions.service/index.js';
+export { MediaLibraryPermissionsService } from './services/media-library-permissions.service/index.js';

package/build/angular/services/camera-permissions.service/index.d.ts

@@ -0,0 +1,5 @@
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import type { ICameraPermissionResponse } from '../../../core';
+export declare class CameraPermissionsService extends PermissionsServiceBase<ICameraPermissionResponse> {
+    constructor();
+}

package/build/angular/services/camera-permissions.service/index.js

@@ -0,0 +1,60 @@
+// Angular twin of `../../react`'s `useCameraPermissions`
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import { getCameraPermissionsAsync, requestCameraPermissionsAsync, } from '../../../core/index.js';
+let CameraPermissionsService = (() => {
+    let _classDecorators = [Injectable({ providedIn: 'root' })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PermissionsServiceBase;
+    var CameraPermissionsService = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            CameraPermissionsService = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        constructor() {
+            super(getCameraPermissionsAsync, requestCameraPermissionsAsync);
+        }
+    };
+    return CameraPermissionsService = _classThis;
+})();
+export { CameraPermissionsService };

package/build/angular/services/media-library-permissions.service/index.d.ts

@@ -0,0 +1,5 @@
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import type { IMediaLibraryPermissionResponse } from '../../../core';
+export declare class MediaLibraryPermissionsService extends PermissionsServiceBase<IMediaLibraryPermissionResponse, boolean> {
+    constructor();
+}

package/build/angular/services/media-library-permissions.service/index.js

@@ -0,0 +1,60 @@
+// Angular twin of `../../react`'s `useMediaLibraryPermissions`, `get`/`request` take a `writeOnly` flag
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import { getMediaLibraryPermissionsAsync, requestMediaLibraryPermissionsAsync, } from '../../../core/index.js';
+let MediaLibraryPermissionsService = (() => {
+    let _classDecorators = [Injectable({ providedIn: 'root' })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = PermissionsServiceBase;
+    var MediaLibraryPermissionsService = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            MediaLibraryPermissionsService = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        constructor() {
+            super(getMediaLibraryPermissionsAsync, requestMediaLibraryPermissionsAsync);
+        }
+    };
+    return MediaLibraryPermissionsService = _classThis;
+})();
+export { MediaLibraryPermissionsService };

package/build/core/image-picker.d.ts

@@ -0,0 +1,9 @@
+import type { ICameraPermissionResponse, IImagePickerErrorResult, IImagePickerOptions, IImagePickerResult, IMediaLibraryPermissionResponse } from './types';
+export declare function getCameraPermissionsAsync(): Promise<ICameraPermissionResponse>;
+export declare function getMediaLibraryPermissionsAsync(writeOnly?: boolean): Promise<IMediaLibraryPermissionResponse>;
+export declare function requestCameraPermissionsAsync(): Promise<ICameraPermissionResponse>;
+export declare function requestMediaLibraryPermissionsAsync(writeOnly?: boolean): Promise<IMediaLibraryPermissionResponse>;
+/** Android only — recovers a result lost to `MainActivity` being killed mid-pick. */
+export declare function getPendingResultAsync(): Promise<IImagePickerResult | IImagePickerErrorResult | null>;
+export declare function launchCameraAsync(options?: IImagePickerOptions): Promise<IImagePickerResult>;
+export declare function launchImageLibraryAsync(options?: IImagePickerOptions): Promise<IImagePickerResult>;

package/build/core/image-picker.js

@@ -0,0 +1,52 @@
+import { CodedError, UnavailabilityError } from 'expo-modules-core';
+import { expoImagePicker } from './native-module.js';
+import { mapDeprecatedOptions } from './utils.js';
+function validateOptions(options) {
+    const { aspect, quality, videoMaxDuration } = options;
+    if (aspect != null) {
+        const [x, y] = aspect;
+        if (x <= 0 || y <= 0) {
+            throw new CodedError('ERR_INVALID_ARGUMENT', `Invalid aspect ratio values ${x}:${y}. Provide positive numbers.`);
+        }
+    }
+    if (quality != null && (quality < 0 || quality > 1)) {
+        throw new CodedError('ERR_INVALID_ARGUMENT', `Invalid 'quality' value ${quality}. Provide a value between 0 and 1.`);
+    }
+    if (videoMaxDuration != null && videoMaxDuration < 0) {
+        throw new CodedError('ERR_INVALID_ARGUMENT', `Invalid 'videoMaxDuration' value ${videoMaxDuration}. Provide a non-negative number.`);
+    }
+    return options;
+}
+export async function getCameraPermissionsAsync() {
+    return expoImagePicker.getCameraPermissionsAsync();
+}
+export async function getMediaLibraryPermissionsAsync(writeOnly = false) {
+    return expoImagePicker.getMediaLibraryPermissionsAsync(writeOnly);
+}
+export async function requestCameraPermissionsAsync() {
+    return expoImagePicker.requestCameraPermissionsAsync();
+}
+export async function requestMediaLibraryPermissionsAsync(writeOnly = false) {
+    return expoImagePicker.requestMediaLibraryPermissionsAsync(writeOnly);
+}
+/** Android only — recovers a result lost to `MainActivity` being killed mid-pick. */
+export async function getPendingResultAsync() {
+    if (expoImagePicker.getPendingResultAsync) {
+        return expoImagePicker.getPendingResultAsync();
+    }
+    return null;
+}
+export async function launchCameraAsync(options = {}) {
+    if (!expoImagePicker.launchCameraAsync) {
+        throw new UnavailabilityError('ImagePicker', 'launchCameraAsync');
+    }
+    const mappedOptions = mapDeprecatedOptions(options);
+    return await expoImagePicker.launchCameraAsync(validateOptions(mappedOptions));
+}
+export async function launchImageLibraryAsync(options = {}) {
+    const mappedOptions = mapDeprecatedOptions(options);
+    if (mappedOptions.allowsEditing && mappedOptions.allowsMultipleSelection) {
+        console.warn('[image-picker] `allowsEditing` is ignored when `allowsMultipleSelection` is enabled.');
+    }
+    return await expoImagePicker.launchImageLibraryAsync(mappedOptions);
+}

package/build/core/index.d.ts

@@ -0,0 +1,3 @@
+export { PermissionStatus } from 'expo-modules-core';
+export { getCameraPermissionsAsync, getMediaLibraryPermissionsAsync, getPendingResultAsync, launchCameraAsync, launchImageLibraryAsync, requestCameraPermissionsAsync, requestMediaLibraryPermissionsAsync, } from './image-picker';
+export * from './types';

package/build/core/index.js

@@ -0,0 +1,3 @@
+export { PermissionStatus } from 'expo-modules-core';
+export { getCameraPermissionsAsync, getMediaLibraryPermissionsAsync, getPendingResultAsync, launchCameraAsync, launchImageLibraryAsync, requestCameraPermissionsAsync, requestMediaLibraryPermissionsAsync, } from './image-picker.js';
+export * from './types.js';

package/build/core/media-library-permission-api.d.ts

@@ -0,0 +1,11 @@
+import type { IMediaLibraryPermissionResponse } from './types';
+import { splitWriteOnlyPermissionOptions } from '@symbiote-native/engine';
+export type IMediaLibraryPermissionMethodOptions = {
+    writeOnly?: boolean;
+};
+export declare const mediaLibraryPermissionMethods: {
+    getMethod: (options?: IMediaLibraryPermissionMethodOptions) => Promise<IMediaLibraryPermissionResponse>;
+    requestMethod: (options?: IMediaLibraryPermissionMethodOptions) => Promise<IMediaLibraryPermissionResponse>;
+};
+export declare const splitMediaLibraryPermissionOptions: typeof splitWriteOnlyPermissionOptions;
+export type { IMediaLibraryPermissionResponse };

package/build/core/media-library-permission-api.js

@@ -0,0 +1,9 @@
+// `methods` every adapter's `useMediaLibraryPermissions` binds to the shared
+// `@symbiote-native/{react,vue,solid}` `createPermissionHook` factory
+import { getMediaLibraryPermissionsAsync, requestMediaLibraryPermissionsAsync, } from './index.js';
+import { splitWriteOnlyPermissionOptions } from '@symbiote-native/engine';
+export const mediaLibraryPermissionMethods = {
+    getMethod: (options) => getMediaLibraryPermissionsAsync(options?.writeOnly),
+    requestMethod: (options) => requestMediaLibraryPermissionsAsync(options?.writeOnly),
+};
+export const splitMediaLibraryPermissionOptions = splitWriteOnlyPermissionOptions;

package/build/core/native-module.d.ts

@@ -0,0 +1,13 @@
+import type { ICameraPermissionResponse, IImagePickerErrorResult, IImagePickerOptions, IImagePickerResult, IMediaLibraryPermissionResponse } from './types';
+export type INativeImagePickerModule = {
+    getCameraPermissionsAsync(): Promise<ICameraPermissionResponse>;
+    getMediaLibraryPermissionsAsync(writeOnly: boolean): Promise<IMediaLibraryPermissionResponse>;
+    requestCameraPermissionsAsync(): Promise<ICameraPermissionResponse>;
+    requestMediaLibraryPermissionsAsync(writeOnly: boolean): Promise<IMediaLibraryPermissionResponse>;
+    /** Android only — absent on iOS's native module. */
+    getPendingResultAsync?(): Promise<IImagePickerResult | IImagePickerErrorResult>;
+    /** Absent on web's native module. */
+    launchCameraAsync?(options: IImagePickerOptions): Promise<IImagePickerResult>;
+    launchImageLibraryAsync(options: IImagePickerOptions): Promise<IImagePickerResult>;
+};
+export declare const expoImagePicker: INativeImagePickerModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_IMAGE_PICKER_MODULE_NAME = 'ExponentImagePicker';
+export const expoImagePicker = requireNativeModule(EXPO_IMAGE_PICKER_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,127 @@
+import type { PermissionResponse } from 'expo-modules-core';
+export type ICameraPermissionResponse = PermissionResponse;
+export type IMediaLibraryPermissionResponse = PermissionResponse & {
+    /** `'all'` | `'limited'` (Android 13+/iOS 14+) | `'none'`. */
+    accessPrivileges?: 'all' | 'limited' | 'none';
+};
+/** @deprecated use an array of `IMediaType` instead. */
+export declare enum MediaTypeOptions {
+    All = "All",
+    Videos = "Videos",
+    Images = "Images"
+}
+export type IMediaType = 'images' | 'videos' | 'livePhotos';
+/** Android only. */
+export type IDefaultTab = 'photos' | 'albums';
+export declare enum VideoExportPreset {
+    Passthrough = 0,
+    LowQuality = 1,
+    MediumQuality = 2,
+    HighestQuality = 3,
+    H264_640x480 = 4,
+    H264_960x540 = 5,
+    H264_1280x720 = 6,
+    H264_1920x1080 = 7,
+    H264_3840x2160 = 8,
+    HEVC_1920x1080 = 9,
+    HEVC_3840x2160 = 10
+}
+export declare enum UIImagePickerControllerQualityType {
+    High = 0,
+    Medium = 1,
+    Low = 2,
+    VGA640x480 = 3,
+    IFrame1280x720 = 4,
+    IFrame960x540 = 5
+}
+/** iOS only — maps to `UIModalPresentationStyle`. */
+export declare enum UIImagePickerPresentationStyle {
+    FULL_SCREEN = "fullScreen",
+    PAGE_SHEET = "pageSheet",
+    FORM_SHEET = "formSheet",
+    CURRENT_CONTEXT = "currentContext",
+    OVER_FULL_SCREEN = "overFullScreen",
+    OVER_CURRENT_CONTEXT = "overCurrentContext",
+    POPOVER = "popover",
+    AUTOMATIC = "automatic"
+}
+/** iOS only — maps to `PHPickerConfigurationAssetRepresentationMode`. */
+export declare enum UIImagePickerPreferredAssetRepresentationMode {
+    Automatic = "automatic",
+    Compatible = "compatible",
+    Current = "current"
+}
+export declare enum CameraType {
+    back = "back",
+    front = "front"
+}
+export type IImagePickerAsset = {
+    uri: string;
+    /** Usable with `@symbiote-native/media-library`. Null if unavailable or access is limited. */
+    assetId?: string | null;
+    width: number;
+    height: number;
+    type?: 'image' | 'video' | 'livePhoto' | 'pairedVideo' | null;
+    fileName?: string | null;
+    fileSize?: number;
+    exif?: Record<string, unknown> | null;
+    /** Base64 JPEG data — set only when the `base64` option is truthy. */
+    base64?: string | null;
+    duration?: number | null;
+    mimeType?: string;
+    /** Set only when `livePhotos` was requested and a live photo was picked. iOS only. */
+    pairedVideoAsset?: IImagePickerAsset | null;
+};
+export type IImagePickerErrorResult = {
+    code: string;
+    message: string;
+    exception?: string;
+};
+export type IImagePickerSuccessResult = {
+    canceled: false;
+    assets: IImagePickerAsset[];
+};
+export type IImagePickerCanceledResult = {
+    canceled: true;
+    assets: null;
+};
+export type IImagePickerResult = IImagePickerSuccessResult | IImagePickerCanceledResult;
+export type ICropShape = 'rectangle' | 'oval';
+export type IImagePickerOptions = {
+    /** Crop/rotate after picking. Exclusive with `allowsMultipleSelection`. Default `false`. */
+    allowsEditing?: boolean;
+    /** `[x, y]` crop aspect ratio. Android only. */
+    aspect?: [number, number];
+    /** Android only. Default `'rectangle'`. */
+    shape?: ICropShape;
+    /** `0`–`1`. Default `1.0`. */
+    quality?: number;
+    /** Default `'images'`. */
+    mediaTypes?: IMediaType | IMediaType[] | MediaTypeOptions;
+    exif?: boolean;
+    base64?: boolean;
+    /** @deprecated iOS 11+ only. */
+    videoExportPreset?: VideoExportPreset;
+    /** iOS only. Default `High`. */
+    videoQuality?: UIImagePickerControllerQualityType;
+    /** Ignored when `allowsEditing` is set. Default `false`. */
+    allowsMultipleSelection?: boolean;
+    /** `0` = system maximum. Android + iOS 14+. Default `0`. */
+    selectionLimit?: number;
+    /** iOS 15+ only. Default `false`. */
+    orderedSelection?: boolean;
+    /** Android only. Default `'photos'`. */
+    defaultTab?: IDefaultTab;
+    /** Seconds. `0` = no limit (default). No effect on web. */
+    videoMaxDuration?: number;
+    /** iOS only. Default `AUTOMATIC`. */
+    presentationStyle?: UIImagePickerPresentationStyle;
+    /** Default `back`. */
+    cameraType?: CameraType;
+    /** iOS 14+ only. Default `Automatic`. */
+    preferredAssetRepresentationMode?: UIImagePickerPreferredAssetRepresentationMode;
+    /** Android only — allows picking from outside the photo library. Default `false`. */
+    legacy?: boolean;
+    /** iOS only — download from iCloud if not stored locally. Default `false`. */
+    shouldDownloadFromNetwork?: boolean;
+};