@symbiote-native/image-picker 0.1.0

package/build-ngc/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;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,55 @@
+/** @deprecated use an array of `IMediaType` instead. */
+export var MediaTypeOptions;
+(function (MediaTypeOptions) {
+    MediaTypeOptions["All"] = "All";
+    MediaTypeOptions["Videos"] = "Videos";
+    MediaTypeOptions["Images"] = "Images";
+})(MediaTypeOptions || (MediaTypeOptions = {}));
+export var VideoExportPreset;
+(function (VideoExportPreset) {
+    VideoExportPreset[VideoExportPreset["Passthrough"] = 0] = "Passthrough";
+    VideoExportPreset[VideoExportPreset["LowQuality"] = 1] = "LowQuality";
+    VideoExportPreset[VideoExportPreset["MediumQuality"] = 2] = "MediumQuality";
+    VideoExportPreset[VideoExportPreset["HighestQuality"] = 3] = "HighestQuality";
+    VideoExportPreset[VideoExportPreset["H264_640x480"] = 4] = "H264_640x480";
+    VideoExportPreset[VideoExportPreset["H264_960x540"] = 5] = "H264_960x540";
+    VideoExportPreset[VideoExportPreset["H264_1280x720"] = 6] = "H264_1280x720";
+    VideoExportPreset[VideoExportPreset["H264_1920x1080"] = 7] = "H264_1920x1080";
+    VideoExportPreset[VideoExportPreset["H264_3840x2160"] = 8] = "H264_3840x2160";
+    VideoExportPreset[VideoExportPreset["HEVC_1920x1080"] = 9] = "HEVC_1920x1080";
+    VideoExportPreset[VideoExportPreset["HEVC_3840x2160"] = 10] = "HEVC_3840x2160";
+})(VideoExportPreset || (VideoExportPreset = {}));
+export var UIImagePickerControllerQualityType;
+(function (UIImagePickerControllerQualityType) {
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["High"] = 0] = "High";
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["Medium"] = 1] = "Medium";
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["Low"] = 2] = "Low";
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["VGA640x480"] = 3] = "VGA640x480";
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["IFrame1280x720"] = 4] = "IFrame1280x720";
+    UIImagePickerControllerQualityType[UIImagePickerControllerQualityType["IFrame960x540"] = 5] = "IFrame960x540";
+})(UIImagePickerControllerQualityType || (UIImagePickerControllerQualityType = {}));
+/** iOS only — maps to `UIModalPresentationStyle`. */
+export var UIImagePickerPresentationStyle;
+(function (UIImagePickerPresentationStyle) {
+    UIImagePickerPresentationStyle["FULL_SCREEN"] = "fullScreen";
+    UIImagePickerPresentationStyle["PAGE_SHEET"] = "pageSheet";
+    UIImagePickerPresentationStyle["FORM_SHEET"] = "formSheet";
+    UIImagePickerPresentationStyle["CURRENT_CONTEXT"] = "currentContext";
+    UIImagePickerPresentationStyle["OVER_FULL_SCREEN"] = "overFullScreen";
+    UIImagePickerPresentationStyle["OVER_CURRENT_CONTEXT"] = "overCurrentContext";
+    UIImagePickerPresentationStyle["POPOVER"] = "popover";
+    UIImagePickerPresentationStyle["AUTOMATIC"] = "automatic";
+})(UIImagePickerPresentationStyle || (UIImagePickerPresentationStyle = {}));
+/** iOS only — maps to `PHPickerConfigurationAssetRepresentationMode`. */
+export var UIImagePickerPreferredAssetRepresentationMode;
+(function (UIImagePickerPreferredAssetRepresentationMode) {
+    UIImagePickerPreferredAssetRepresentationMode["Automatic"] = "automatic";
+    UIImagePickerPreferredAssetRepresentationMode["Compatible"] = "compatible";
+    UIImagePickerPreferredAssetRepresentationMode["Current"] = "current";
+})(UIImagePickerPreferredAssetRepresentationMode || (UIImagePickerPreferredAssetRepresentationMode = {}));
+export var CameraType;
+(function (CameraType) {
+    CameraType["back"] = "back";
+    CameraType["front"] = "front";
+})(CameraType || (CameraType = {}));
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AASA,wDAAwD;AACxD,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;AACnB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAOD,MAAM,CAAN,IAAY,iBAYX;AAZD,WAAY,iBAAiB;IAC3B,uEAAe,CAAA;IACf,qEAAc,CAAA;IACd,2EAAiB,CAAA;IACjB,6EAAkB,CAAA;IAClB,yEAAgB,CAAA;IAChB,yEAAgB,CAAA;IAChB,2EAAiB,CAAA;IACjB,6EAAkB,CAAA;IAClB,6EAAkB,CAAA;IAClB,6EAAkB,CAAA;IAClB,8EAAmB,CAAA;AACrB,CAAC,EAZW,iBAAiB,KAAjB,iBAAiB,QAY5B;AAED,MAAM,CAAN,IAAY,kCAOX;AAPD,WAAY,kCAAkC;IAC5C,2FAAQ,CAAA;IACR,+FAAU,CAAA;IACV,yFAAO,CAAA;IACP,uGAAc,CAAA;IACd,+GAAkB,CAAA;IAClB,6GAAiB,CAAA;AACnB,CAAC,EAPW,kCAAkC,KAAlC,kCAAkC,QAO7C;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,8BASX;AATD,WAAY,8BAA8B;IACxC,4DAA0B,CAAA;IAC1B,0DAAwB,CAAA;IACxB,0DAAwB,CAAA;IACxB,oEAAkC,CAAA;IAClC,qEAAmC,CAAA;IACnC,6EAA2C,CAAA;IAC3C,qDAAmB,CAAA;IACnB,yDAAuB,CAAA;AACzB,CAAC,EATW,8BAA8B,KAA9B,8BAA8B,QASzC;AAED,yEAAyE;AACzE,MAAM,CAAN,IAAY,6CAIX;AAJD,WAAY,6CAA6C;IACvD,wEAAuB,CAAA;IACvB,0EAAyB,CAAA;IACzB,oEAAmB,CAAA;AACrB,CAAC,EAJW,6CAA6C,KAA7C,6CAA6C,QAIxD;AAED,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,6BAAe,CAAA;AACjB,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/build-ngc/core/utils.d.ts

@@ -0,0 +1,4 @@
+import { MediaTypeOptions } from './types';
+import type { IImagePickerOptions, IMediaType } from './types';
+export declare function parseMediaTypes(mediaTypes: MediaTypeOptions | IMediaType | IMediaType[]): IMediaType[];
+export declare function mapDeprecatedOptions(options: IImagePickerOptions): IImagePickerOptions;

package/build-ngc/core/utils.js

@@ -0,0 +1,25 @@
+import { MediaTypeOptions } from './types';
+const DEPRECATED_MEDIA_TYPE_MAP = {
+    [MediaTypeOptions.Images]: ['images'],
+    [MediaTypeOptions.Videos]: ['videos'],
+    [MediaTypeOptions.All]: ['images', 'videos'],
+};
+export function parseMediaTypes(mediaTypes) {
+    if (mediaTypes === MediaTypeOptions.Images ||
+        mediaTypes === MediaTypeOptions.Videos ||
+        mediaTypes === MediaTypeOptions.All) {
+        console.warn('[image-picker] `MediaTypeOptions` is deprecated. Use `IMediaType` or an array of it instead.');
+        return DEPRECATED_MEDIA_TYPE_MAP[mediaTypes];
+    }
+    if (typeof mediaTypes === 'string') {
+        return [mediaTypes];
+    }
+    return mediaTypes;
+}
+export function mapDeprecatedOptions(options) {
+    if (!options.mediaTypes) {
+        return options;
+    }
+    return { ...options, mediaTypes: parseMediaTypes(options.mediaTypes) };
+}
+//# sourceMappingURL=utils.js.map

package/build-ngc/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,MAAM,yBAAyB,GAA2C;IACxE,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC;IACrC,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC;IACrC,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7C,CAAC;AAEF,MAAM,UAAU,eAAe,CAC7B,UAAwD;IAExD,IACE,UAAU,KAAK,gBAAgB,CAAC,MAAM;QACtC,UAAU,KAAK,gBAAgB,CAAC,MAAM;QACtC,UAAU,KAAK,gBAAgB,CAAC,GAAG,EACnC,CAAC;QACD,OAAO,CAAC,IAAI,CACV,8FAA8F,CAC/F,CAAC;QACF,OAAO,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAA4B;IAE5B,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;AACzE,CAAC"}

package/native-link.json

@@ -0,0 +1,20 @@
+{
+  "android": {
+    "gradleProjectName": "expo-image-picker",
+    "modules": [
+      {
+        "importPath": "expo.modules.imagepicker.ImagePickerModule",
+        "className": "ImagePickerModule",
+        "nativeName": "ExponentImagePicker"
+      }
+    ],
+    "manifestPermissions": ["android.permission.RECORD_AUDIO"]
+  },
+  "ios": {
+    "infoPlistKeys": {
+      "NSPhotoLibraryUsageDescription": "This app uses the photo library to let you pick images and videos.",
+      "NSCameraUsageDescription": "This app uses the camera to let you take a photo or video.",
+      "NSMicrophoneUsageDescription": "This app uses the microphone to record audio for videos."
+    }
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/image-picker",
+  "version": "0.1.0",
+  "description": "expo-image-picker wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Opens the system UI for picking an image/video or taking a photo with the camera.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-image-picker",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "image-picker",
+    "camera"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/image-picker"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/image-picker#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./svelte": {
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
+    },
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-image-picker": "57.0.20",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/solid": "^3.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/vue": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/test-utils": "0.4.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

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

package/src/angular/services/camera-permissions.service/index.ts

@@ -0,0 +1,16 @@
+// Angular twin of `../../react`'s `useCameraPermissions`
+
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import {
+  getCameraPermissionsAsync,
+  requestCameraPermissionsAsync,
+} from '../../../core';
+import type { ICameraPermissionResponse } from '../../../core';
+
+@Injectable({ providedIn: 'root' })
+export class CameraPermissionsService extends PermissionsServiceBase<ICameraPermissionResponse> {
+  constructor() {
+    super(getCameraPermissionsAsync, requestCameraPermissionsAsync);
+  }
+}

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

@@ -0,0 +1,19 @@
+// Angular twin of `../../react`'s `useMediaLibraryPermissions`, `get`/`request` take a `writeOnly` flag
+
+import { Injectable } from '@angular/core';
+import { PermissionsServiceBase } from '@symbiote-native/angular';
+import {
+  getMediaLibraryPermissionsAsync,
+  requestMediaLibraryPermissionsAsync,
+} from '../../../core';
+import type { IMediaLibraryPermissionResponse } from '../../../core';
+
+@Injectable({ providedIn: 'root' })
+export class MediaLibraryPermissionsService extends PermissionsServiceBase<
+  IMediaLibraryPermissionResponse,
+  boolean
+> {
+  constructor() {
+    super(getMediaLibraryPermissionsAsync, requestMediaLibraryPermissionsAsync);
+  }
+}

package/src/core/image-picker.ts

@@ -0,0 +1,90 @@
+import { CodedError, UnavailabilityError } from 'expo-modules-core';
+import { expoImagePicker } from './native-module';
+import { mapDeprecatedOptions } from './utils';
+import type {
+  ICameraPermissionResponse,
+  IImagePickerErrorResult,
+  IImagePickerOptions,
+  IImagePickerResult,
+  IMediaLibraryPermissionResponse,
+} from './types';
+
+function validateOptions(options: IImagePickerOptions): IImagePickerOptions {
+  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(): Promise<ICameraPermissionResponse> {
+  return expoImagePicker.getCameraPermissionsAsync();
+}
+
+export async function getMediaLibraryPermissionsAsync(
+  writeOnly: boolean = false,
+): Promise<IMediaLibraryPermissionResponse> {
+  return expoImagePicker.getMediaLibraryPermissionsAsync(writeOnly);
+}
+
+export async function requestCameraPermissionsAsync(): Promise<ICameraPermissionResponse> {
+  return expoImagePicker.requestCameraPermissionsAsync();
+}
+
+export async function requestMediaLibraryPermissionsAsync(
+  writeOnly: boolean = false,
+): Promise<IMediaLibraryPermissionResponse> {
+  return expoImagePicker.requestMediaLibraryPermissionsAsync(writeOnly);
+}
+
+/** Android only — recovers a result lost to `MainActivity` being killed mid-pick. */
+export async function getPendingResultAsync(): Promise<
+  IImagePickerResult | IImagePickerErrorResult | null
+> {
+  if (expoImagePicker.getPendingResultAsync) {
+    return expoImagePicker.getPendingResultAsync();
+  }
+  return null;
+}
+
+export async function launchCameraAsync(
+  options: IImagePickerOptions = {},
+): Promise<IImagePickerResult> {
+  if (!expoImagePicker.launchCameraAsync) {
+    throw new UnavailabilityError('ImagePicker', 'launchCameraAsync');
+  }
+  const mappedOptions = mapDeprecatedOptions(options);
+  return await expoImagePicker.launchCameraAsync(
+    validateOptions(mappedOptions),
+  );
+}
+
+export async function launchImageLibraryAsync(
+  options: IImagePickerOptions = {},
+): Promise<IImagePickerResult> {
+  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/src/core/index.ts

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

package/src/core/media-library-permission-api.ts

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

package/src/core/native-module.ts

@@ -0,0 +1,34 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  ICameraPermissionResponse,
+  IImagePickerErrorResult,
+  IImagePickerOptions,
+  IImagePickerResult,
+  IMediaLibraryPermissionResponse,
+} from './types';
+
+const EXPO_IMAGE_PICKER_MODULE_NAME = 'ExponentImagePicker';
+
+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 const expoImagePicker = requireNativeModule<INativeImagePickerModule>(
+  EXPO_IMAGE_PICKER_MODULE_NAME,
+);