# mob_photos

Photo / video library picker for apps built with [Mob](https://hexdocs.pm/mob)
— extracted from mob core as a plugin.

iOS: `PHPickerViewController` (iOS 14+). Android: the system Photo Picker
(`PickMultipleVisualMedia`). Both run out of process, so no runtime permission
dialog is ever shown and no usage-description string is needed.

## Installation

```elixir
# mix.exs
{:mob_photos, "~> 0.1"}

# mob.exs
config :mob, :plugins, [:mob_photos]
```

The plugin manifest merges `READ_MEDIA_IMAGES` / `READ_MEDIA_VIDEO` /
`READ_EXTERNAL_STORAGE` into the host AndroidManifest at build time — the
system picker doesn't need them, but they cover OEM fallback pickers on
API <= 32. No iOS plist key.

## Usage

```elixir
socket = MobPhotos.pick(socket, max: 5)

def handle_info({:photos, :picked, items}, socket) do
  # each item: %{path: "/tmp/mob_pick_xxx.jpg", type: :image | :video,
  #              width: 1920, height: 1080}
end

def handle_info({:photos, :cancelled}, socket), do: ...
```

## Limits (platform parity, inherited from core)

- iOS items carry only `path` + `type` (no `width`/`height`; `type` is an
  atom).
- Android items carry all four keys, but `type` is a string
  (`"image"`/`"video"`) and `width`/`height` are `0` — the picker doesn't
  probe dimensions.
- The `types:` option is currently ignored by both native sides; both pickers
  show images + videos.

## License

MIT