@hvakr/firestate 0.1.2 → 0.1.4

package/dist/index.d.mts

@@ -27,27 +27,43 @@ interface UpdateOptions {
   undoGroupId?: string;
 }
 /**
- * State of a document subscription
+ * The full observable state of a document subscription — what a hook `selector`
+ * receives. Carries every status flag (including `isSynced`, which the default
+ * data handle deliberately omits) so a selector can react to exactly the slice
+ * it reads.
  */
 interface DocumentState<T> {
   /** Current merged state (local changes applied to sync state) */
   data: T | undefined;
-  /** Whether initial data has loaded */
+  /** Whether the initial snapshot has not arrived yet */
   isLoading: boolean;
-  /** Whether there are pending local changes */
+  /**
+       * Whether the initial snapshot has arrived and data is ready to render — the
+       * completion of {@link DocumentState.isLoading} (`!isLoading` for a live
+       * subscription; `false` while the hook is disabled).
+       */
+  isLoaded: boolean;
+  /** Whether all local changes have synced to Firestore (no pending writes) */
   isSynced: boolean;
   /** Error from listener, if any */
   error: Error | undefined;
 }
 /**
- * State of a collection subscription
+ * The full observable state of a collection subscription — what a hook
+ * `selector` receives. See {@link DocumentState}.
  */
 interface CollectionState<T> {
   /** Current merged state keyed by document ID */
   data: Record<string, T>;
-  /** Whether initial data has loaded */
+  /** Whether the initial snapshot has not arrived yet */
   isLoading: boolean;
-  /** Whether there are pending local changes */
+  /**
+       * Whether the collection is active and its initial snapshot has arrived —
+       * `isActive && !isLoading`. `false` for a lazy collection before `load()`,
+       * and while the hook is disabled.
+       */
+  isLoaded: boolean;
+  /** Whether all local changes have synced to Firestore (no pending writes) */
   isSynced: boolean;
   /** Whether the collection has been activated (for lazy loading) */
   isActive: boolean;
@@ -55,7 +71,38 @@ interface CollectionState<T> {
   error: Error | undefined;
 }
 /**
- * Document handle returned by useDocument hook
+ * Sync status of a single resource, returned by the per-entry
+ * `use{Name}SyncStatus` hook. Opt-in: only components that render save/dirty
+ * state subscribe to it, so the common data path does not re-render when a write
+ * settles. Shares the resource's one `onSnapshot` listener.
+ */
+interface SyncStatus {
+  /** Whether all local changes have synced to Firestore (no pending writes) */
+  isSynced: boolean;
+  /** Whether there are pending local changes still being saved (`!isSynced`) */
+  isSaving: boolean;
+}
+/**
+ * Loading status of a single resource, returned by the per-entry
+ * `use{Name}LoadingStatus` hook. A spinner-only channel: it re-renders on load
+ * transitions but never on data changes. Shares the resource's listener.
+ */
+interface LoadingStatus {
+  /** Whether the initial snapshot has not arrived yet */
+  isLoading: boolean;
+  /** Whether the initial snapshot has arrived (the completion of `isLoading`) */
+  isLoaded: boolean;
+}
+/**
+ * Document handle returned by the `useDocument` hook.
+ *
+ * **Sync-agnostic by default.** The handle carries `data`, `isLoaded`, `error`,
+ * the writers, and `ref` — but NOT `isSynced`. A document hook therefore does
+ * not re-render when a write settles (the `isSynced` flip on every autosave),
+ * so "just render the record" is the cheap, default path. Components that
+ * actually render save/dirty state opt into the per-entry `use{Name}SyncStatus`
+ * hook ({@link SyncStatus}), which shares the same listener. The raw
+ * `isLoading`/`isSynced` flags remain on {@link DocumentState} for selectors.
  */
 interface DocumentHandle<T extends FirestoreObject> {
   /** Current document data */
@@ -66,10 +113,13 @@ interface DocumentHandle<T extends FirestoreObject> {
   set: (data: T, options?: UpdateOptions) => void;
   /** Delete the document */
   delete: (options?: UpdateOptions) => void;
-  /** Whether initial data is loading */
-  isLoading: boolean;
-  /** Whether all changes have synced to Firestore */
-  isSynced: boolean;
+  /**
+       * Whether the initial snapshot has arrived and data is ready to render — the
+       * completion of `isLoading`. `false` while loading or when the hook is
+       * disabled. (Use `use{Name}LoadingStatus` for an `isLoading`/`isLoaded`
+       * channel that does not re-render on data changes.)
+       */
+  isLoaded: boolean;
   /** Force sync pending changes immediately */
   sync: () => Promise<void>;
   /** Error from listener, if any */
@@ -81,7 +131,13 @@ interface DocumentHandle<T extends FirestoreObject> {
   ref: DocumentReference<T> | undefined;
 }
 /**
- * Collection handle returned by useCollection hook
+ * Collection handle returned by the `useCollection` hook.
+ *
+ * Sync-agnostic by default, exactly like {@link DocumentHandle}: it carries
+ * `data`, `isLoaded`, `isActive`, `error`, the writers, `load`, and `ref` — but
+ * NOT `isSynced`. Opt into `use{Name}SyncStatus` for save state. `isActive`
+ * stays (lazy collections gate a "Load" button on it); `isLoaded` is
+ * `isActive && !isLoading`.
  */
 interface CollectionHandle<T extends FirestoreObject> {
   /** Current collection data keyed by document ID */
@@ -102,10 +158,12 @@ interface CollectionHandle<T extends FirestoreObject> {
   };
   /** Remove a document from the collection */
   remove: (id: string, options?: UpdateOptions) => void;
-  /** Whether initial data is loading */
-  isLoading: boolean;
-  /** Whether all changes have synced to Firestore */
-  isSynced: boolean;
+  /**
+       * Whether the collection is active and its initial snapshot has arrived
+       * (ready to render) — `isActive && !isLoading`. `false` for a lazy
+       * collection before `load()`, while loading, or when the hook is disabled.
+       */
+  isLoaded: boolean;
   /** Whether subscription is active (for lazy collections) */
   isActive: boolean;
   /** Activate a lazy subscription */
@@ -120,6 +178,46 @@ interface CollectionHandle<T extends FirestoreObject> {
        */
   ref: CollectionReference<T> | undefined;
 }
+/** Reactive status fields a selector drops unless it folds them into its slice. */
+type DocumentStatusKeys = "isLoaded" | "error";
+type CollectionStatusKeys = DocumentStatusKeys | "isActive";
+/**
+ * A {@link DocumentHandle} reduced to a hook-level `selector`'s output. The
+ * selector receives the full observable state ({@link DocumentState}) and
+ * returns the slice this component reacts to; the handle re-renders *only* when
+ * that slice changes.
+ *
+ * A selected handle deliberately exposes **only** `data` (the slice) plus the
+ * writer surface (`update`/`set`/`delete`/`sync`) and `ref` — never the status
+ * fields (`isLoaded`/`error`). Status is not a freebie here: if a component
+ * needs it, it must select it (`s => ({ slice: s.data?.x, loading:
+ * s.isLoading })`), so what you re-render on is exactly what you select. The
+ * writers stay typed against the full document `TData`, because a selector
+ * changes what you *read*, never what you *write*.
+ *
+ * Note: `update(diff)` takes a *partial* of the full document and merges it, so
+ * writing a selected field is `update({ field: next })`. `set(data)` still
+ * *replaces the entire document*, not the slice — never pass the selected value
+ * to `set`, or you will overwrite every other field. Prefer `update` from a
+ * narrowed handle; reach for `set` only when you hold the full document.
+ */
+interface SelectedDocumentHandle<TData extends FirestoreObject, TSelected> extends Omit<DocumentHandle<TData>, "data" | DocumentStatusKeys> {
+  /** The slice produced by the hook's `selector`. */
+  data: TSelected;
+}
+/**
+ * A {@link CollectionHandle} reduced to a hook-level `selector`'s output. As
+ * with {@link SelectedDocumentHandle}, the selector receives the full
+ * observable state ({@link CollectionState}) and the handle exposes only the
+ * slice plus the writer surface (`update`/`add`/`remove`/`load`/`sync`) and
+ * `ref` — status fields (`isLoaded`/`isActive`/`error`) are dropped unless
+ * folded into the slice. Writers stay typed against the full collection of
+ * `TData`.
+ */
+interface SelectedCollectionHandle<TData extends FirestoreObject, TSelected> extends Omit<CollectionHandle<TData>, "data" | CollectionStatusKeys> {
+  /** The slice produced by the hook's `selector`. */
+  data: TSelected;
+}
 /**
  * An undo/redo action
  */
@@ -269,7 +367,7 @@ type Subscriber<T> = (state: T) => void;
  */
 type Unsubscribe = () => void;
 //#endregion
-//#region src/schema.d.ts
+//#region src/registry/schema.d.ts
 /**
  * Define a typed document. `TData` is the document's TypeScript shape.
  *
@@ -355,7 +453,7 @@ type InferCollectionDocument<T extends CollectionDefinition<FirestoreObject>> =
   id: string;
 };
 //#endregion
-//#region src/undo.d.ts
+//#region src/utils/undo.d.ts
 /**
  * Configuration for creating an undo manager
  */
@@ -392,7 +490,7 @@ declare const createUndoManager: (config?: UndoManagerConfig) => UndoManager & {
  */
 type UndoManagerWithSubscribe = ReturnType<typeof createUndoManager>;
 //#endregion
-//#region src/store.d.ts
+//#region src/core/store.d.ts
 /**
  * Firestate store that holds configuration and shared state
  */
@@ -456,7 +554,65 @@ declare const createStore: (config: FirestateConfig) => FirestateStore;
  */
 type Store = ReturnType<typeof createStore>;
 //#endregion
-//#region src/hooks.d.ts
+//#region src/react/hooks.d.ts
+/**
+ * Opts a {@link useDocument} call into a selected slice. The hook still returns
+ * a full handle (writers, `ref`, status) — only `data` is narrowed to whatever
+ * `selector` returns.
+ */
+interface DocumentSelectorOptions<TData extends FirestoreObject, TSelected> {
+  /**
+       * Project the document's observable state down to the slice this component
+       * reacts to. The selector receives the full {@link DocumentState} —
+       * `{ data, isLoading, isLoaded, isSynced, error }`, where `data` is
+       * `undefined` while the document is loading or the hook is disabled — and
+       * the component
+       * re-renders *only* when the returned slice changes (per `isEqual`). Status
+       * is not a freebie: read `s.isLoading`/`s.isSynced`/`s.error` here if you
+       * want to react to them (e.g. `s => ({ title: s.data?.title, saving:
+       * !s.isSynced })`). What you select is exactly what re-renders, and the
+       * returned handle exposes only the slice plus writers/`ref`.
+       */
+  selector: (state: DocumentState<TData>) => TSelected;
+  /**
+       * Decide whether two consecutive slices are equal; the hook re-renders only
+       * when this returns `false`. Defaults to a deep value comparison, so a
+       * selector that returns a fresh object/array of the same shape does not
+       * over-render. Pass {@link shallow} for a one-level compare, or a custom
+       * comparator.
+       */
+  isEqual?: (a: TSelected, b: TSelected) => boolean;
+}
+/**
+ * Opts a {@link useCollection} call into a selected slice. See
+ * {@link DocumentSelectorOptions}; the only difference is the selector receives
+ * the collection's keyed record.
+ */
+interface CollectionSelectorOptions<TData extends FirestoreObject, TSelected> {
+  /**
+       * Project the collection's observable state down to the slice this component
+       * reacts to. The selector receives the full {@link CollectionState} —
+       * `{ data, isLoading, isLoaded, isSynced, isActive, error }`, where `data` is
+       * the keyed record (e.g. `s => s.data[id]` or `s => Object.keys(s.data)`) —
+       * and the
+       * component re-renders *only* when the returned slice changes. As with
+       * {@link DocumentSelectorOptions.selector}, status is reactive only if you
+       * select it, and the returned handle exposes just the slice plus
+       * writers/`ref`.
+       */
+  selector: (state: CollectionState<TData>) => TSelected;
+  /** See {@link DocumentSelectorOptions.isEqual}. */
+  isEqual?: (a: TSelected, b: TSelected) => boolean;
+}
+/**
+ * Shape used by the non-selector hook overload to *exclude* selector options,
+ * so passing a real `selector` falls through to the selector overload (which
+ * infers `TSelected`) instead of silently resolving to the full-data return.
+ */
+type WithoutSelector = {
+  selector?: undefined;
+  isEqual?: undefined;
+};
 /**
  * Context for providing the Firestate store
  */
@@ -487,9 +643,8 @@ interface UseDocumentOptions<TData extends FirestoreObject> {
   undoable?: boolean;
   /**
        * If false, no subscription is created and a no-op handle is returned
-       * (`{ data: undefined, isLoading: false, isSynced: true, ref: undefined }`).
-       * Use this to gate subscriptions on route params that aren't ready yet.
-       * Default: true.
+       * (`{ data: undefined, isLoaded: false, ref: undefined }`). Use this to gate
+       * subscriptions on route params that aren't ready yet. Default: true.
        */
   enabled?: boolean;
 }
@@ -497,19 +652,29 @@ interface UseDocumentOptions<TData extends FirestoreObject> {
  * Hook to subscribe to a Firestore document with real-time updates.
  *
  * The subscription is keyed on the resolved document path (`definition` +
- * computed id) and `readOnly`. When that key changes — typically because
- * `params` produces a different id — the hook tears down the old Firestore
- * listener and attaches a new one. Toggling `undoable` does not rebuild the
- * subscription.
+ * computed id). When that key changes — typically because `params` produces a
+ * different id — the hook tears down the old Firestore listener and attaches a
+ * new one. Toggling `undoable` does not rebuild the subscription.
+ *
+ * `readOnly` is a *per-handle capability*, not part of the key: a `readOnly`
+ * hook shares the same listener and optimistic state as a writable hook on the
+ * same document (a write through the writable handle is instantly visible to
+ * the read-only reader), and only this handle's own writers (`update`/`set`/
+ * `delete`) and `sync` are disabled.
  *
  * Use `enabled: false` to suppress the subscription entirely (e.g., when
  * route params aren't ready yet).
  *
  * **SSR.** On the server there is no Firestore listener, so this hook returns
- * the initial handle (`{ data: undefined, isLoading: true }`). Mutations like
+ * the initial handle (`{ data: undefined, isLoaded: false }`). Mutations like
  * `update`/`set` will mutate orphaned local state with no effect — avoid
  * calling them server-side.
  *
+ * The default handle is **sync-agnostic** — it carries `data`/`isLoaded`/`error`
+ * but not `isSynced`, so it does not re-render when a write settles. Render save
+ * state via the per-entry `use{Name}SyncStatus` hook, or fold `isSynced` into a
+ * `selector`.
+ *
  * @example
  * ```tsx
  * const projectDoc = defineDocument<Project>({
@@ -518,12 +683,12 @@ interface UseDocumentOptions<TData extends FirestoreObject> {
  * })
  *
  * function ProjectEditor({ projectId }: { projectId: string }) {
- *   const { data, update, isLoading, isSynced } = useDocument({
+ *   const { data, update, isLoaded } = useDocument({
  *     definition: projectDoc,
  *     params: { projectId },
  *   })
  *
- *   if (isLoading) return <Spinner />
+ *   if (!isLoaded) return <Spinner />
  *
  *   return (
  *     <input
@@ -534,7 +699,24 @@ interface UseDocumentOptions<TData extends FirestoreObject> {
  * }
  * ```
  */
-declare const useDocument: <TData extends FirestoreObject>(options: UseDocumentOptions<TData>) => DocumentHandle<TData>;
+declare function useDocument<TData extends FirestoreObject>(options: UseDocumentOptions<TData> & WithoutSelector): DocumentHandle<TData>;
+/**
+ * Selector overload: pass `selector` to narrow the returned `data` to a slice
+ * and re-render only when that slice changes. Writers (`update`/`set`/`delete`)
+ * and `ref` keep operating on the full document. See
+ * {@link DocumentSelectorOptions}.
+ *
+ * @example
+ * ```tsx
+ * // Re-renders only when the title changes, not on any other field.
+ * const { data: title, update } = useDocument({
+ *   definition: projectDoc,
+ *   params: { projectId },
+ *   selector: (s) => s.data?.title,
+ * })
+ * ```
+ */
+declare function useDocument<TData extends FirestoreObject, TSelected>(options: UseDocumentOptions<TData> & DocumentSelectorOptions<TData, TSelected>): SelectedDocumentHandle<TData, TSelected>;
 /**
  * Options for useCollection hook
  */
@@ -551,7 +733,7 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
   undoable?: boolean;
   /**
        * If false, no subscription is created and a no-op handle is returned
-       * (`{ data: {}, isLoading: false, isActive: false }`). Use this to gate on
+       * (`{ data: {}, isLoaded: false, isActive: false }`). Use this to gate on
        * route params that aren't ready yet. Default: true.
        */
   enabled?: boolean;
@@ -559,10 +741,12 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
 /**
  * Hook to subscribe to a Firestore collection with real-time updates.
  *
- * The subscription is keyed on the resolved collection path, `readOnly`, and
- * the *semantic identity* of `queryConstraints`. When any of these change, the
- * listener is torn down and re-attached with the new query. Toggling
- * `undoable` does not rebuild the subscription.
+ * The subscription is keyed on the resolved collection path and the *semantic
+ * identity* of `queryConstraints`. When either changes, the listener is torn
+ * down and re-attached with the new query. Toggling `undoable` does not rebuild
+ * the subscription. `readOnly` is a per-handle capability, not part of the key —
+ * a `readOnly` hook shares one listener and optimistic state with a writable
+ * hook on the same query (see {@link useDocument}).
  *
  * **You do not need to memoize `queryConstraints`.** `QueryConstraint` objects
  * are opaque, so Firestate compares the *built query* with Firestore's own
@@ -588,8 +772,13 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
  * route params aren't ready yet).
  *
  * **SSR.** On the server there is no Firestore listener, so this hook returns
- * the initial handle (`{ data: {}, isLoading: true }` for non-lazy, or
- * `isActive: false` for lazy). Avoid calling mutations server-side.
+ * the initial handle (`{ data: {}, isLoaded: false }`, `isActive: false` for
+ * lazy). Avoid calling mutations server-side.
+ *
+ * Like {@link useDocument}, the default handle is **sync-agnostic** — `data`,
+ * `isLoaded`, `isActive`, `error`, but not `isSynced`. `isActive` stays so a
+ * lazy collection can gate a "Load" button; `isLoaded` is `isActive &&
+ * !isLoading`. Render save state via `use{Name}SyncStatus`.
  *
  * @example
  * ```tsx
@@ -599,7 +788,7 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
  * })
  *
  * function SpacesList({ projectId }: { projectId: string }) {
- *   const { data, update, load, isActive, isLoading } = useCollection({
+ *   const { data, update, load, isActive, isLoaded } = useCollection({
  *     definition: spacesCollection,
  *     params: { projectId },
  *   })
@@ -608,7 +797,7 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
  *   useEffect(() => { load() }, [load])
  *
  *   if (!isActive) return <Button onClick={load}>Load Spaces</Button>
- *   if (isLoading) return <Spinner />
+ *   if (!isLoaded) return <Spinner />
  *
  *   return (
  *     <ul>
@@ -620,7 +809,96 @@ interface UseCollectionOptions<TData extends FirestoreObject> {
  * }
  * ```
  */
-declare const useCollection: <TData extends FirestoreObject>(options: UseCollectionOptions<TData>) => CollectionHandle<TData>;
+declare function useCollection<TData extends FirestoreObject>(options: UseCollectionOptions<TData> & WithoutSelector): CollectionHandle<TData>;
+/**
+ * Selector overload: pass `selector` to narrow the returned `data` to a slice
+ * of the collection and re-render only when that slice changes. Writers
+ * (`update`/`add`/`remove`) and `ref` keep operating on the full collection.
+ * See {@link CollectionSelectorOptions}.
+ *
+ * @example
+ * ```tsx
+ * // Re-renders only when this one document's slice changes.
+ * const { data: space } = useCollection({
+ *   definition: spacesCollection,
+ *   params: { projectId },
+ *   selector: (s) => s.data[spaceId],
+ * })
+ * ```
+ */
+declare function useCollection<TData extends FirestoreObject, TSelected>(options: UseCollectionOptions<TData> & CollectionSelectorOptions<TData, TSelected>): SelectedCollectionHandle<TData, TSelected>;
+/** Options for the document status hooks (a subset of {@link UseDocumentOptions}). */
+interface UseDocumentStatusOptions<TData extends FirestoreObject> {
+  /** Document definition from defineDocument(). */
+  definition: DocumentDefinition<TData>;
+  /** Route/path parameters for dynamic paths. */
+  params?: Record<string, string>;
+  /**
+       * If false, no subscription is created and the idle status is returned
+       * (`{ isSynced: true, isSaving: false }` / `{ isLoading: false, isLoaded:
+       * false }`). Default: true.
+       */
+  enabled?: boolean;
+}
+/** Options for the collection status hooks. Adds `queryConstraints`. */
+interface UseCollectionStatusOptions<TData extends FirestoreObject> {
+  /** Collection definition from defineCollection(). */
+  definition: CollectionDefinition<TData>;
+  /** Route/path parameters for dynamic paths. */
+  params?: Record<string, string>;
+  /**
+       * Query constraints. Must produce the same query the data hook uses, or the
+       * status hook resolves a *different* shared entry (a second listener) —
+       * sharing is keyed by semantic query identity.
+       */
+  queryConstraints?: QueryConstraint[];
+  /** See {@link UseDocumentStatusOptions.enabled}. */
+  enabled?: boolean;
+}
+/**
+ * Subscribe to a document's **sync status only** — `{ isSynced, isSaving }`.
+ *
+ * The opt-in counterpart to the sync-agnostic default handle (see
+ * {@link DocumentHandle}): it re-renders when sync state flips but never on data
+ * changes, and shares the resource's one `onSnapshot` listener with
+ * `useDocument` and any slice hooks, so opting in adds no listener. While
+ * disabled it reports `{ isSynced: true, isSaving: false }`.
+ */
+declare function useDocumentSyncStatus<TData extends FirestoreObject>(options: UseDocumentStatusOptions<TData>): SyncStatus;
+/**
+ * Subscribe to a document's **loading status only** — `{ isLoading, isLoaded }`.
+ *
+ * A spinner channel that shares the resource's listener and does NOT re-render
+ * on data changes — for a progress indicator rendered apart from the data. The
+ * data handle keeps `isLoaded` for the common render path; this is an extra
+ * channel, not a replacement.
+ */
+declare function useDocumentLoadingStatus<TData extends FirestoreObject>(options: UseDocumentStatusOptions<TData>): LoadingStatus;
+/**
+ * Collection counterpart of {@link useDocumentSyncStatus} — `{ isSynced,
+ * isSaving }` over a collection query, sharing its one listener.
+ *
+ * **Lazy caveat.** On a `lazy` collection this hook never calls `load()` itself:
+ * activating a lazy listener is the data hook's job, and a passive status reader
+ * must not silently start the listener (and bill the reads) the laziness exists
+ * to defer. As the *lone* subscriber it therefore attaches no listener and stays
+ * at the idle `{ isSynced: true, isSaving: false }`. Mount it alongside a
+ * {@link useCollection} on the same query whose `load()` has run — the status
+ * hook rides that one shared listener and reports real sync state. Non-lazy
+ * collections activate on mount, so this hook works standalone there.
+ */
+declare function useCollectionSyncStatus<TData extends FirestoreObject>(options: UseCollectionStatusOptions<TData>): SyncStatus;
+/**
+ * Collection counterpart of {@link useDocumentLoadingStatus} — `{ isLoading,
+ * isLoaded }` over a collection query, sharing its one listener.
+ *
+ * Same lazy caveat as {@link useCollectionSyncStatus}: on a `lazy` collection it
+ * never calls `load()`, so as the lone subscriber it attaches no listener and
+ * stays at the idle `{ isLoading: false, isLoaded: false }` until a co-mounted
+ * {@link useCollection} (or any active hook on the same query) activates the
+ * shared listener via `load()`. Non-lazy collections activate on mount.
+ */
+declare function useCollectionLoadingStatus<TData extends FirestoreObject>(options: UseCollectionStatusOptions<TData>): LoadingStatus;
 /**
  * Keyboard shortcut hook for undo/redo
  *
@@ -634,7 +912,7 @@ declare const useCollection: <TData extends FirestoreObject>(options: UseCollect
  */
 declare const useUndoKeyboardShortcuts: () => void;
 //#endregion
-//#region src/firestate.d.ts
+//#region src/registry/firestate.d.ts
 /**
  * Knobs forwarded from a generated document hook to {@link useDocument}.
  * Same shape as `UseDocumentOptions` minus the fields the registry already
@@ -668,8 +946,13 @@ interface CommonEntryOptions {
 interface DocEntry<T extends FirestoreObject, P extends string = string> extends CommonEntryOptions {
   readonly __kind: "document";
   readonly __type?: T;
-  /** Path template, e.g. `'taskLists/{listId}'`. */
-  path: P;
+  /**
+       * Path template, e.g. `'taskLists/{listId}'`, or a function returning the
+       * **full document path** at runtime (the collection/id split happens
+       * per-call via {@link splitDocPath}). Use the function form for paths that
+       * branch on a param. See {@link PathArg}.
+       */
+  path: PathArg<P>;
   /**
        * Zod schema. **Required** — firestate's registry API is opinionated
        * about Zod. The schema is the source of `T` for the generated hooks
@@ -683,22 +966,126 @@ interface DocEntry<T extends FirestoreObject, P extends string = string> extends
        * param typing and no runtime validation.
        */
   schema: ZodType<T>;
+  /**
+       * Derive a **named slice-hook** off this document, sharing its schema and
+       * path — the schema is handed to firestate once, here, and never
+       * re-specified. The `selector` receives the full {@link DocumentState};
+       * return the slice the generated hook reacts to. For a *parameterized* slice,
+       * declare the extra params as the selector's second argument — the generated
+       * hook then requires the path params **and** those, merged into one bag.
+       *
+       * Pass the result to {@link createFirestate} under the key the hook is named
+       * for. Status is reactive only if the slice reads it, exactly as the inline
+       * `selector` option (see {@link DocumentHandle}); the comparator (`isEqual`)
+       * is baked in here, not passed per call.
+       *
+       * ```ts
+       * const project = doc({ path: 'projects/{projectId}', schema: ProjectSchema })
+       * const { useProject, useProjectTitle } = createFirestate({
+       *   project,                                           // → useProject (full)
+       *   projectTitle: project.select((s) => s.data?.name), // → useProjectTitle
+       * })
+       * ```
+       *
+       * A derived entry is a leaf, not a base: there is intentionally no
+       * `.select(...).select(...)` chaining.
+       *
+       * `PExtra` (the selector's own params) defaults to `{}`: a one-argument
+       * selector leaves it unbound, a two-argument one infers it from the annotated
+       * second parameter. One signature keeps the selector's `state` arg reliably
+       * typed in both cases. `PExtra` is intentionally unconstrained — leaving it
+       * `extends Record<string, string>` made TS resolve a param-less selector's
+       * `PExtra` to that constraint (not the `{}` default), wrongly forcing a
+       * `params` arg on no-placeholder paths; unconstrained also lets a slice take
+       * non-string params (e.g. `{ index: number }`).
+       */
+  select<TSelected, PExtra = {}>(selector: (state: DocumentState<T>, params: PExtra) => TSelected, options?: SelectOptions<TSelected>): SelectedDocEntry<T, P, PExtra, TSelected>;
 }
 /** Collection entry in a Firestate registry. Produced by {@link col}. */
 interface ColEntry<T extends FirestoreObject, P extends string = string> extends CommonEntryOptions {
   readonly __kind: "collection";
   readonly __type?: T;
-  /** Path template, e.g. `'taskLists/{listId}/tasks'`. */
-  path: P;
+  /**
+       * Path template, e.g. `'taskLists/{listId}/tasks'`, or a function returning
+       * the **collection path** at runtime. Use the function form for paths that
+       * branch on a param. See {@link PathArg}.
+       */
+  path: PathArg<P>;
   /** Zod schema. Required. See {@link DocEntry.schema}. */
   schema: ZodType<T>;
   /** Only subscribe when `load()` is called. */
   lazy?: boolean;
   /** Additional Firestore query constraints. */
   queryConstraints?: QueryConstraint[];
+  /**
+       * Derive a **named slice-hook** off this collection, sharing its schema,
+       * path, and query — see {@link DocEntry.select}. The `selector` receives the
+       * full {@link CollectionState} (`s.data` is the keyed record), and a
+       * parameterized slice declares its extra params as the selector's second
+       * argument.
+       *
+       * ```ts
+       * const tasks = col({ path: 'projects/{projectId}/tasks', schema: TaskSchema })
+       * const { useTasks, useTaskIds, useTaskById } = createFirestate({
+       *   tasks,                                                  // → useTasks (full)
+       *   taskIds:  tasks.select((s) => Object.keys(s.data)),     // → useTaskIds
+       *   taskById: tasks.select((s, p: { id: string }) => s.data[p.id]), // → useTaskById
+       * })
+       * // useTaskById requires the merged bag: useTaskById({ projectId, id })
+       * ```
+       *
+       * `PExtra` defaults to `{}` and is unconstrained — see {@link DocEntry.select}.
+       */
+  select<TSelected, PExtra = {}>(selector: (state: CollectionState<T>, params: PExtra) => TSelected, options?: SelectOptions<TSelected>): SelectedColEntry<T, P, PExtra, TSelected>;
+}
+/**
+ * Options bundled into a `.select(...)` entry at definition time. Kept separate
+ * from the runtime hook options (`enabled`/`readOnly`/`queryConstraints`)
+ * because these are baked into the named hook, not passed per call.
+ */
+interface SelectOptions<TSelected> {
+  /**
+       * Comparator for this named hook's slice; the hook re-renders only when it
+       * returns `false`. Defaults to a deep value compare (so a fresh object/array
+       * of equal shape does not over-render). Pass {@link shallow} or a custom fn.
+       */
+  isEqual?: (a: TSelected, b: TSelected) => boolean;
+}
+/**
+ * A {@link DocEntry} narrowed by a `.select(...)` projection. Produced by
+ * {@link DocEntry.select}, consumed by {@link createFirestate}, which turns it
+ * into a hook whose `data` is the slice (`TSelected`) and whose params are the
+ * path params (`P`) merged with the selector's own params (`PExtra`).
+ *
+ * The schema/path/options live on `base` — a derived entry never re-declares
+ * them. `PExtra` is `{}` for an un-parameterized selector.
+ */
+interface SelectedDocEntry<T extends FirestoreObject, P extends string, PExtra, TSelected> {
+  readonly __kind: "document-selected";
+  /** Base entry carrying schema/path/options — handed to firestate once. */
+  readonly base: DocEntry<T, P>;
+  /** Projection over the full state; receives the merged params bag at runtime. */
+  readonly selector: (state: DocumentState<T>, params: PExtra) => TSelected;
+  /** Comparator baked in at definition time (see {@link SelectOptions}). */
+  readonly isEqual?: (a: TSelected, b: TSelected) => boolean;
+}
+/**
+ * A {@link ColEntry} narrowed by a `.select(...)` projection. See
+ * {@link SelectedDocEntry}; the selector receives the collection's keyed state.
+ */
+interface SelectedColEntry<T extends FirestoreObject, P extends string, PExtra, TSelected> {
+  readonly __kind: "collection-selected";
+  /** Base entry carrying schema/path/query/options — handed to firestate once. */
+  readonly base: ColEntry<T, P>;
+  /** Projection over the full state; receives the merged params bag at runtime. */
+  readonly selector: (state: CollectionState<T>, params: PExtra) => TSelected;
+  /** Comparator baked in at definition time (see {@link SelectOptions}). */
+  readonly isEqual?: (a: TSelected, b: TSelected) => boolean;
 }
 type FirestateEntry<T extends FirestoreObject = FirestoreObject, P extends string = string> = DocEntry<T, P> | ColEntry<T, P>;
-type FirestateRegistry = Record<string, FirestateEntry<any, any>>;
+/** Any `.select(...)`-derived entry, regardless of its type parameters. */
+type AnySelectedEntry = SelectedDocEntry<any, any, any, any> | SelectedColEntry<any, any, any, any>;
+type FirestateRegistry = Record<string, FirestateEntry<any, any> | AnySelectedEntry>;
 /**
  * Extract `{name}` placeholders from a path template into a params shape.
  *
@@ -712,8 +1099,20 @@ type FirestateRegistry = Record<string, FirestateEntry<any, any>>;
 type ParamsOf<P extends string> = string extends P ? Record<string, string> : Prettify<RawParamsOf<P>>;
 type RawParamsOf<P extends string> = P extends `${string}{${infer K}}${infer Rest}` ? { [Key in K]: string } & RawParamsOf<Rest> : {};
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
-type DocOpts<T extends FirestoreObject> = Omit<DocEntry<T>, "__kind" | "__type" | "path">;
-type ColOpts<T extends FirestoreObject> = Omit<ColEntry<T>, "__kind" | "__type" | "path">;
+/**
+ * The `path` accepted by {@link doc} / {@link col}. Either a static template
+ * (whose `{param}` placeholders are interpolated and whose param keys are
+ * inferred via {@link ParamsOf}), or a function that returns the path at
+ * runtime — for paths that branch on a param, e.g. live
+ * `projects/{projectId}/spaces` vs. revision
+ * `projects/{projectId}/revisions/{revisionId}/spaces`.
+ *
+ * With the function form, params can't be inferred from a template, so the
+ * generated hook's params fall back to `Record<string, string>`.
+ */
+type PathArg<P extends string> = P | ((params: Record<string, string>) => string);
+type DocOpts<T extends FirestoreObject> = Omit<DocEntry<T>, "__kind" | "__type" | "path" | "select">;
+type ColOpts<T extends FirestoreObject> = Omit<ColEntry<T>, "__kind" | "__type" | "path" | "select">;
 /**
  * Declare a single-document entry for a Firestate registry.
  *
@@ -727,6 +1126,10 @@ type ColOpts<T extends FirestoreObject> = Omit<ColEntry<T>, "__kind" | "__type"
  * directly — that escape hatch keeps the plain-TypeScript form, at the
  * cost of looser param typing on the hook and no runtime validation.
  *
+ * `path` may also be a function returning the full document path at runtime —
+ * for paths that branch on a param. Param keys can't be inferred from a
+ * function, so they fall back to `Record<string, string>`. See {@link PathArg}.
+ *
  * ```ts
  * import { z } from 'zod'
  *
@@ -737,19 +1140,58 @@ type ColOpts<T extends FirestoreObject> = Omit<ColEntry<T>, "__kind" | "__type"
  */
 declare function doc<S extends ZodType<FirestoreObject>, const P extends string = string>(opts: Omit<DocOpts<z.infer<S>>, "schema"> & {
   schema: S;
-  path: P;
+  path: PathArg<P>;
 }): DocEntry<z.infer<S>, P>;
 /**
  * Declare a collection entry for a Firestate registry. See {@link doc}
- * for the schema/typing contract.
+ * for the schema/typing contract. `path` may also be a function returning
+ * the collection path at runtime — see {@link PathArg}.
  */
 declare function col<S extends ZodType<FirestoreObject>, const P extends string = string>(opts: Omit<ColOpts<z.infer<S>>, "schema"> & {
   schema: S;
-  path: P;
+  path: PathArg<P>;
 }): ColEntry<z.infer<S>, P>;
 type HookName<K extends string> = `use${Capitalize<K>}`;
-type HookFor<E> = E extends DocEntry<infer T, infer P> ? keyof ParamsOf<P> extends never ? (params?: Record<string, string>, options?: DocHookOptions<T>) => DocumentHandle<T> : (params: ParamsOf<P>, options?: DocHookOptions<T>) => DocumentHandle<T> : E extends ColEntry<infer T, infer P> ? keyof ParamsOf<P> extends never ? (params?: Record<string, string>, options?: ColHookOptions<T>) => CollectionHandle<T> : (params: ParamsOf<P>, options?: ColHookOptions<T>) => CollectionHandle<T> : never;
-type FirestateApi<R extends FirestateRegistry> = { [K in keyof R & string as HookName<K>]: HookFor<R[K]> };
+type NoSelector = {
+  selector?: undefined;
+  isEqual?: undefined;
+};
+interface DocHookOptionalParams<T extends FirestoreObject> {
+  (params?: Record<string, string>, options?: DocHookOptions<T> & NoSelector): DocumentHandle<T>;
+  <TSelected>(params: Record<string, string> | undefined, options: DocHookOptions<T> & DocumentSelectorOptions<T, TSelected>): SelectedDocumentHandle<T, TSelected>;
+}
+interface DocHookRequiredParams<T extends FirestoreObject, P extends string> {
+  (params: ParamsOf<P>, options?: DocHookOptions<T> & NoSelector): DocumentHandle<T>;
+  <TSelected>(params: ParamsOf<P>, options: DocHookOptions<T> & DocumentSelectorOptions<T, TSelected>): SelectedDocumentHandle<T, TSelected>;
+}
+interface ColHookOptionalParams<T extends FirestoreObject> {
+  (params?: Record<string, string>, options?: ColHookOptions<T> & NoSelector): CollectionHandle<T>;
+  <TSelected>(params: Record<string, string> | undefined, options: ColHookOptions<T> & CollectionSelectorOptions<T, TSelected>): SelectedCollectionHandle<T, TSelected>;
+}
+interface ColHookRequiredParams<T extends FirestoreObject, P extends string> {
+  (params: ParamsOf<P>, options?: ColHookOptions<T> & NoSelector): CollectionHandle<T>;
+  <TSelected>(params: ParamsOf<P>, options: ColHookOptions<T> & CollectionSelectorOptions<T, TSelected>): SelectedCollectionHandle<T, TSelected>;
+}
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type SelectedParams<P extends string, PExtra> = IsAny<PExtra> extends true ? ParamsOf<P> : Prettify<ParamsOf<P> & PExtra>;
+type SelectedDocHookFor<T extends FirestoreObject, P extends string, PExtra, TSelected> = keyof SelectedParams<P, PExtra> extends never ? (params?: Record<string, string>, options?: DocHookOptions<T>) => SelectedDocumentHandle<T, TSelected> : (params: SelectedParams<P, PExtra>, options?: DocHookOptions<T>) => SelectedDocumentHandle<T, TSelected>;
+type SelectedColHookFor<T extends FirestoreObject, P extends string, PExtra, TSelected> = keyof SelectedParams<P, PExtra> extends never ? (params?: Record<string, string>, options?: ColHookOptions<T>) => SelectedCollectionHandle<T, TSelected> : (params: SelectedParams<P, PExtra>, options?: ColHookOptions<T>) => SelectedCollectionHandle<T, TSelected>;
+type HookFor<E> = E extends SelectedDocEntry<infer T, infer P, infer PExtra, infer TSelected> ? SelectedDocHookFor<T, P, PExtra, TSelected> : E extends SelectedColEntry<infer T, infer P, infer PExtra, infer TSelected> ? SelectedColHookFor<T, P, PExtra, TSelected> : E extends DocEntry<infer T, infer P> ? keyof ParamsOf<P> extends never ? DocHookOptionalParams<T> : DocHookRequiredParams<T, P> : E extends ColEntry<infer T, infer P> ? keyof ParamsOf<P> extends never ? ColHookOptionalParams<T> : ColHookRequiredParams<T, P> : never;
+type SyncStatusHookName<K extends string> = `${HookName<K>}SyncStatus`;
+type LoadingStatusHookName<K extends string> = `${HookName<K>}LoadingStatus`;
+type BaseEntry = DocEntry<any, any> | ColEntry<any, any>;
+type DocStatusHookOptions = {
+  enabled?: boolean;
+};
+type ColStatusHookOptions = {
+  enabled?: boolean;
+  queryConstraints?: QueryConstraint[];
+};
+type DocStatusHookFor<P extends string, Ret> = keyof ParamsOf<P> extends never ? (params?: Record<string, string>, options?: DocStatusHookOptions) => Ret : (params: ParamsOf<P>, options?: DocStatusHookOptions) => Ret;
+type ColStatusHookFor<P extends string, Ret> = keyof ParamsOf<P> extends never ? (params?: Record<string, string>, options?: ColStatusHookOptions) => Ret : (params: ParamsOf<P>, options?: ColStatusHookOptions) => Ret;
+type SyncStatusHookFor<E> = E extends DocEntry<any, infer P> ? DocStatusHookFor<P, SyncStatus> : E extends ColEntry<any, infer P> ? ColStatusHookFor<P, SyncStatus> : never;
+type LoadingStatusHookFor<E> = E extends DocEntry<any, infer P> ? DocStatusHookFor<P, LoadingStatus> : E extends ColEntry<any, infer P> ? ColStatusHookFor<P, LoadingStatus> : never;
+type FirestateApi<R extends FirestateRegistry> = { [K in keyof R & string as HookName<K>]: HookFor<R[K]> } & { [K in keyof R & string as R[K] extends BaseEntry ? SyncStatusHookName<K> : never]: SyncStatusHookFor<R[K]> } & { [K in keyof R & string as R[K] extends BaseEntry ? LoadingStatusHookName<K> : never]: LoadingStatusHookFor<R[K]> };
 /**
  * Turn a Firestate registry into a map of typed React hooks. Each entry
  * `K` produces a hook named `use{Capitalize<K>}`.
@@ -763,7 +1205,7 @@ type FirestateApi<R extends FirestateRegistry> = { [K in keyof R & string as Hoo
  */
 declare function createFirestate<R extends FirestateRegistry>(registry: R): FirestateApi<R>;
 //#endregion
-//#region src/diff.d.ts
+//#region src/utils/diff.d.ts
 /**
  * Check if two values are deeply equal
  */
@@ -821,11 +1263,44 @@ declare const isDiffEmpty: (diff: Record<string, unknown>) => boolean;
  * VectorValue) are NOT flattened — they're preserved at their path so
  * Firestore receives them in their original form.
  *
+ * ⚠️ The dot-joined keys this produces are AMBIGUOUS to Firestore if any map
+ * key itself contains a "." (e.g. an email key `a@b.com`): `updateDoc` parses
+ * the "." as a path separator and writes to the wrong nested field. The
+ * write path uses {@link flattenDiffToFieldPaths} + `FieldPath` instead, which
+ * keeps every segment literal. Reach for this only when dotted-string keys are
+ * what you actually want.
+ *
  * @param diff - The nested diff object
  * @param prefix - Internal: current path prefix for recursion
  * @returns Flattened object with dotted keys
  */
 declare const flattenDiff: (diff: Record<string, unknown>, prefix?: string) => Record<string, unknown>;
+/**
+ * Flatten a nested diff into a list of `{ segments, value }` entries, where
+ * `segments` is the path expressed as an array of *literal* key segments
+ * (never joined into a dotted string).
+ *
+ * This is the segment-preserving sibling of {@link flattenDiff}. It exists
+ * because dot-joined string keys are ambiguous to Firestore: `updateDoc(ref,
+ * { "users.a@b.com.role": 4 })` parses the `.` inside the email key as a path
+ * separator and writes to `users → "a@b" → "com" → role` instead of the
+ * literal key `"a@b.com"`. Feeding these segments to `new FieldPath(...segments)`
+ * (with the variadic `updateDoc(ref, fieldPath, value, …)` form) keeps every
+ * segment literal, so a "." inside a map key is never re-interpreted.
+ *
+ * The opaque/plain-object rules mirror {@link flattenDiff} exactly: arrays,
+ * FieldValue sentinels (deleteField, serverTimestamp, …), and Firestore value
+ * types (Timestamp, DocumentReference, GeoPoint, Bytes, VectorValue) ride
+ * through verbatim at their path; only plain objects are recursed into.
+ *
+ * @param diff - The nested diff object
+ * @param prefix - Internal: accumulated path segments for recursion
+ * @returns Flat list of `{ segments, value }` entries
+ */
+declare const flattenDiffToFieldPaths: (diff: Record<string, unknown>, prefix?: string[]) => Array<{
+  segments: string[];
+  value: unknown;
+}>;
 /**
  * Merge two diffs together, with the second taking precedence
  */
@@ -928,7 +1403,29 @@ declare const createDiffAtPath: (path: string, value: unknown) => Record<string,
  */
 declare const unflattenDiff: (flatDiff: Record<string, unknown>) => Record<string, unknown>;
 //#endregion
-//#region src/document.d.ts
+//#region src/utils/shallow.d.ts
+/**
+ * Shallow structural equality.
+ *
+ * Returns `true` when `a` and `b` are identical by `Object.is`, or are two
+ * arrays / two plain objects whose entries are pairwise `Object.is`-equal one
+ * level deep. Anything else (different shapes, nested objects that aren't
+ * reference-equal) is `false`.
+ *
+ * Intended as the `isEqual` for a hook `selector` that builds a fresh array or
+ * object every render — e.g. `data => Object.values(data).map(d => d.id)` or
+ * `data => ({ name: data?.name, done: data?.done })`. The default selector
+ * comparison is a *deep* value compare, which is correct but does more work
+ * than needed for a flat projection; `shallow` re-renders on a genuine change
+ * to any entry while collapsing the fresh-reference-same-entries case.
+ *
+ * Not recursive on purpose: if a selected entry is itself an object you mutate
+ * in place rather than replace, prefer the default deep comparison or a
+ * bespoke `isEqual`.
+ */
+declare const shallow: <T>(a: T, b: T) => boolean;
+//#endregion
+//#region src/core/document.d.ts
 /**
  * Options for creating a document subscription
  */
@@ -981,7 +1478,7 @@ declare const createDocumentSubscription: <TData extends FirestoreObject>(option
   sync: () => Promise<void>;
 };
 //#endregion
-//#region src/collection.d.ts
+//#region src/core/collection.d.ts
 /**
  * Options for creating a collection subscription
  */
@@ -1031,7 +1528,7 @@ declare const createCollectionSubscription: <TData extends FirestoreObject>(opti
   sync: () => Promise<void>;
 };
 //#endregion
-//#region src/provider.d.ts
+//#region src/react/provider.d.ts
 /**
  * Props for FirestateProvider
  */
@@ -1147,5 +1644,5 @@ declare const FirestateStoreProvider: React.FC<FirestateStoreProviderProps>;
  */
 declare const useUnsavedChangesBlocker: () => boolean;
 //#endregion
-export { type ColEntry, type CollectionDefinition, type CollectionHandle, type CollectionOptions, type CollectionState, type DeepPartial, type DocEntry, type DocumentDefinition, type DocumentHandle, type DocumentOptions, type DocumentState, type ErrorContext, type FirestateApi, type FirestateConfig, FirestateContext, type FirestateEntry, FirestateProvider, type FirestateProviderProps, type FirestateRegistry, type FirestateStore, FirestateStoreProvider, type FirestateStoreProviderProps, type FirestoreObject, type InferCollectionData, type InferCollectionDocument, type InferDocument, type InferDocumentData, type Store, type UndoAction, type UndoManager, type UndoManagerConfig, type UndoManagerState, type UndoManagerWithSubscribe, type UpdateOptions, type UseCollectionOptions, type UseDocumentOptions, applyDiff, applyDiffMutable, col, computeDiff, computeUndoDiff, createCollectionSubscription, createDiffAtPath, createDocumentSubscription, createFirestate, createStore, createUndoManager, deepClone, defineCollection, defineDocument, diffContainsPath, doc, extractDiffValue, flattenDiff, isDeepEqual, isDiffEmpty, mergeDiffs, unflattenDiff, useCollection, useDocument, useIsSynced, useStore, useUndoKeyboardShortcuts, useUndoManager, useUnsavedChangesBlocker };
+export { type AnySelectedEntry, type ColEntry, type CollectionDefinition, type CollectionHandle, type CollectionOptions, type CollectionSelectorOptions, type CollectionState, type DeepPartial, type DocEntry, type DocumentDefinition, type DocumentHandle, type DocumentOptions, type DocumentSelectorOptions, type DocumentState, type ErrorContext, type FirestateApi, type FirestateConfig, FirestateContext, type FirestateEntry, FirestateProvider, type FirestateProviderProps, type FirestateRegistry, type FirestateStore, FirestateStoreProvider, type FirestateStoreProviderProps, type FirestoreObject, type InferCollectionData, type InferCollectionDocument, type InferDocument, type InferDocumentData, type LoadingStatus, type SelectOptions, type SelectedColEntry, type SelectedCollectionHandle, type SelectedDocEntry, type SelectedDocumentHandle, type Store, type SyncStatus, type UndoAction, type UndoManager, type UndoManagerConfig, type UndoManagerState, type UndoManagerWithSubscribe, type UpdateOptions, type UseCollectionOptions, type UseCollectionStatusOptions, type UseDocumentOptions, type UseDocumentStatusOptions, applyDiff, applyDiffMutable, col, computeDiff, computeUndoDiff, createCollectionSubscription, createDiffAtPath, createDocumentSubscription, createFirestate, createStore, createUndoManager, deepClone, defineCollection, defineDocument, diffContainsPath, doc, extractDiffValue, flattenDiff, flattenDiffToFieldPaths, isDeepEqual, isDiffEmpty, mergeDiffs, shallow, unflattenDiff, useCollection, useCollectionLoadingStatus, useCollectionSyncStatus, useDocument, useDocumentLoadingStatus, useDocumentSyncStatus, useIsSynced, useStore, useUndoKeyboardShortcuts, useUndoManager, useUnsavedChangesBlocker };
 //# sourceMappingURL=index.d.mts.map