IndexedBatch and Facet

Use these to show the library while it is indexed, without searching again and again. A sorting screen can call facets once, then add each batch’s photos to its groups as they arrive.

let groups = try await Rollup.shared.facets(limit: 16, samples: 4)

for await batch in Rollup.shared.indexing.batches {
    add(batch.items)  // animate the new photos into their groups
}

Call facets again when the state is ready to get the final groups.

IndexedBatch

public struct IndexedBatch: Codable, Sendable, Equatable

What Rollup.shared.indexing.batches reports each time part of a run becomes searchable, about a hundred photos at a time. The stream starts from now: photos indexed earlier are in search and facets.

[IndexedItem]

The photos that just became searchable, newest first.

Int

Photos done in the whole index once this batch is in.

Int

Photos the index’s options take, as IndexingProgress.total.

A shot’s near-duplicates come once, and sensitive photos and screenshots (see sensitivity) are left out. A part with nothing to show sends no batch.

IndexedItem

public struct IndexedItem: Codable, Sendable, Equatable, Identifiable

String

The PhotoKit local identifier.

String

photo, screenshot or video.

Date?

When it was taken.

[SearchResult.Label]

What it shows, most confident first, as in search results.

public struct Facet: Codable, Sendable, Equatable, Identifiable

One of the index’s largest groups, from Rollup.shared.facets(limit:samples:). Groups on most of the library, or on very few photos, are left out.

String

Stable across calls, such as label:oewn:i51129, place:fsq:park, cuisine:ramen or food.

String

A name to show.

String

label, place, cuisine or food.

Int

Photos in the group: a shot once, sensitive photos and screenshots not at all.

[String]

A few of its photos’ PhotoKit identifiers, newest first.

JSON

{ "items": [{ "id": "A1B2.../L0/001", "mediaType": "photo", "date": "2026-10-30T18:02:11Z", "labels": [{ "id": "label:oewn:i51129", "name": "dog", "probability": 0.93 }] }], "indexed": 101, "total": 5400 }

{ "id": "place:fsq:park", "name": "Park", "kind": "place", "count": 212, "sampleIDs": ["A1B2.../L0/001", "C3D4.../L0/001"] }

​IndexedBatch

​IndexedItem

​Facet

​JSON

IndexedBatch

IndexedItem

Facet

JSON