expoPicker — @gj-kit/expo-media

A public function from @gj-kit/expo-media/picker. The signature below is taken directly from the 0.6.1 release declaration.

Verified import example

import { expoPicker } from '@gj-kit/expo-media/picker';

Signature, parameters, and return type

/** §5.6 — `"./picker"`의 유일한 공개 심볼. */
declare function expoPicker(options?: {
    /**
     * 기본 `true` — iOS PhotoKit 원본 표현 fast path(§7.1).
     *
     * `false`로 내리면 `preferredAssetRepresentationMode`만 빠져 시스템이 표현을 고르게 된다
     * (HEIC → JPEG 트랜스코딩이 일어날 수 있다). `quality`·`exif`·`allowsEditing` 세 값은
     * **어떤 경우에도 바뀌지 않는다** — 그 셋이 흔들리면 크기 정합(§7 하드닝 3)과 메타데이터가
     * 함께 깨지기 때문이다. 즉 이 옵션은 fast path의 on/off이지 옵션 가방이 아니다.
     */
    readonly preferOriginalRepresentation?: boolean | undefined;
    /**
     * When original PhotoKit data is unsuitable for an app-owned processing flow, ask iOS for a
     * compatible representation. This keeps the default upload-oriented original fast path intact.
     */
    readonly preferCompatibleRepresentation?: boolean | undefined;
    /**
     * Retry a failed single-image library launch with UIImagePickerController's editing flow.
     * This is useful for iCloud/HEIC assets that PHPicker cannot materialize. The retry is limited
     * to one selection because Expo does not support editing together with multi-selection.
     */
    readonly retryWithEditingOnError?: boolean | undefined;
}): PickerAdapter;

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/expo-media
• Version: 0.6.1
• Public entry: ./picker
• Source: GitHub