@pyric/ui 0.1.0-alpha.10

package/dist/firestore/fieldEditors/vector.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { asVectorView } from '../types.js';
+/** How many leading components to show in the truncated preview. The
+ *  mock (`c-data.html`) renders four then an ellipsis. */
+const PREVIEW_COUNT = 4;
+/**
+ * Render a `[a, b, c, … ]` preview of the first {@link PREVIEW_COUNT}
+ * components. A vector that's already short enough is shown in full
+ * without the trailing ellipsis.
+ */
+function previewText(values) {
+    if (values.length <= PREVIEW_COUNT) {
+        return `[${values.join(', ')}]`;
+    }
+    const head = values.slice(0, PREVIEW_COUNT).join(', ');
+    return `[${head}, …]`;
+}
+/**
+ * Read view for a vector (embedding). Mirrors the mock: a
+ * `vector · <dims>` type chip plus a truncated value preview. The full
+ * 768-float array is never rendered inline — it's noise and a perf
+ * hazard. `data-dimension` carries the dimension for styling/queries.
+ */
+function VectorDisplay({ value, path }) {
+    const view = asVectorView(value);
+    if (!view) {
+        // Should be unreachable: the renderer only dispatches here when
+        // `inferType` already classified the value as `vector`. Render a
+        // defensive empty marker rather than throwing.
+        return (_jsx("span", { "data-pyric-field-type": "vector", "data-pyric-field-path": path }));
+    }
+    return (_jsxs("span", { "data-pyric-field-type": "vector", "data-pyric-field-path": path, "data-dimension": String(view.dimension), children: [_jsx("span", { "data-pyric-vector-dims": true, children: `vector · ${view.dimension}` }), _jsx("span", { "data-pyric-vector-preview": true, children: previewText(view.values) })] }));
+}
+/**
+ * Parse the textarea contents into a wire-sentinel vector, or an error.
+ * Accepts only a JSON array of numbers — the whole-value replace
+ * contract. Anything else (bad JSON, non-array, non-numeric element)
+ * is rejected and the previous value is kept by the caller.
+ */
+export function parseVectorInput(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { ok: false, error: 'Invalid JSON' };
+    }
+    if (!Array.isArray(parsed) || !parsed.every((n) => typeof n === 'number')) {
+        return { ok: false, error: 'Expected a JSON array of numbers' };
+    }
+    return { ok: true, value: { __type__: '__vector__', value: parsed } };
+}
+/**
+ * Edit affordance for a vector. Deliberately NOT a per-element grid —
+ * a 768-dim embedding isn't hand-tuned float by float. The contract is
+ * "replace the whole value": paste a JSON number array and commit. The
+ * dimension + a note are shown so the editor is honest about what it is.
+ *
+ * On commit, we emit the value back in the same wire-sentinel shape the
+ * read side already understands (`{__type__:'__vector__', value}`), so a
+ * round-trip through `inferType` re-classifies it as `vector`. Invalid
+ * JSON / non-numeric input leaves the previous value in place (same
+ * forgiving stance as the bytes + geopoint editors).
+ */
+function VectorEdit({ value, onChange, error, path }) {
+    const view = asVectorView(value);
+    const initial = view ? JSON.stringify(view.values) : '[]';
+    const [draft, setDraft] = useState(initial);
+    const [parseError, setParseError] = useState(undefined);
+    const commit = (text) => {
+        setDraft(text);
+        const result = parseVectorInput(text);
+        if (!result.ok) {
+            setParseError(result.error);
+            return;
+        }
+        setParseError(undefined);
+        // Re-emit in the wire-sentinel shape so the read side + inferType
+        // recognize it as a vector again without depending on a backend
+        // VectorValue class being importable here.
+        onChange(result.value);
+    };
+    const dims = view ? view.dimension : 0;
+    const shown = parseError ?? error;
+    return (_jsxs("label", { "data-pyric-field-type": "vector", "data-pyric-field-path": path, "data-dimension": String(dims), "data-pyric-error": shown ? '' : undefined, children: [_jsx("span", { "data-pyric-vector-dims": true, children: `vector · ${dims}` }), _jsx("span", { "data-pyric-vector-note": true, children: "Replace whole. Paste a JSON number array." }), _jsx("textarea", { "data-pyric-vector-raw": true, value: draft, onChange: (e) => commit(e.target.value), "aria-invalid": shown ? 'true' : undefined, "aria-label": "Vector value (JSON number array)" }), shown ? _jsx("span", { "data-pyric-error-message": true, children: shown }) : null] }));
+}
+export const vectorEditor = {
+    type: 'vector',
+    Display: VectorDisplay,
+    Edit: VectorEdit,
+};
+//# sourceMappingURL=vector.js.map

package/dist/firestore/fieldEditors/vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.js","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/vector.tsx"],"names":[],"mappings":"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"}

package/dist/firestore/firestoreApi.d.ts

@@ -0,0 +1,35 @@
+import { type ReactNode } from 'react';
+/**
+ * The modular Firestore functions the data hooks call, as an INJECTABLE bundle.
+ *
+ * WHY: the hooks default to the in-process `pyric/firestore` API, but Pyric
+ * Studio's served mode drives the SAME ops over a SharedWorker via a PARALLEL
+ * modular client (`@pyric/cli/serve/worker`: its own `collection`/`getDocs`/...
+ * over a `MessagePort`, and a `ClientDb` that is not a `pyric/firestore`
+ * `Firestore`). Statically importing the in-process fns hardwires the hooks to
+ * the in-page sandbox; reading them from this context lets a consumer inject the
+ * worker client's fns so the hooks operate on the live worker backend without
+ * the hooks (or the components) knowing which backend they hit.
+ *
+ * The bundle is typed to the in-process signatures. A worker bundle is adapted
+ * (cast) to this shape at the Studio boundary: the worker handles + snapshots
+ * are runtime-compatible at the surface the hooks use (`.id` / `.data()` /
+ * `.docs` / `.ref`), which is the contract function-injection relies on.
+ *
+ * Default = the real `pyric/firestore` fns, so every existing consumer (the
+ * dev-seed review build, tests, any app embedding `@pyric/ui`) is unchanged: no
+ * provider needed unless you are swapping the backend.
+ */
+export type FirestoreApi = Pick<typeof import('pyric/firestore'), 'addDoc' | 'collection' | 'deleteDoc' | 'doc' | 'getDoc' | 'getDocs' | 'limit' | 'onSnapshot' | 'query' | 'setDoc' | 'startAfter'>;
+/** Read the active Firestore API bundle (defaults to in-process `pyric/firestore`). */
+export declare function useFirestoreApi(): FirestoreApi;
+/**
+ * Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
+ * surface with this, supplying the in-process bundle for dev-seed review and the
+ * SharedWorker client bundle under `pyric dev --ui`.
+ */
+export declare function FirestoreApiProvider({ value, children, }: {
+    value: FirestoreApi;
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<FirestoreApi>>;
+//# sourceMappingURL=firestoreApi.d.ts.map

package/dist/firestore/firestoreApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestoreApi.d.ts","sourceRoot":"","sources":["../../src/firestore/firestoreApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAejF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,cAAc,iBAAiB,CAAC,EAC9B,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,KAAK,GACL,QAAQ,GACR,SAAS,GACT,OAAO,GACP,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,YAAY,CACf,CAAC;AAkBF,uFAAuF;AACvF,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB,yFAEA"}

package/dist/firestore/firestoreApi.js

@@ -0,0 +1,29 @@
+import { createContext, createElement, useContext } from 'react';
+import { addDoc, collection, deleteDoc, doc, getDoc, getDocs, limit, onSnapshot, query, setDoc, startAfter, } from 'pyric/firestore';
+const inProcessFirestoreApi = {
+    addDoc,
+    collection,
+    deleteDoc,
+    doc,
+    getDoc,
+    getDocs,
+    limit,
+    onSnapshot,
+    query,
+    setDoc,
+    startAfter,
+};
+const FirestoreApiContext = createContext(inProcessFirestoreApi);
+/** Read the active Firestore API bundle (defaults to in-process `pyric/firestore`). */
+export function useFirestoreApi() {
+    return useContext(FirestoreApiContext);
+}
+/**
+ * Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
+ * surface with this, supplying the in-process bundle for dev-seed review and the
+ * SharedWorker client bundle under `pyric dev --ui`.
+ */
+export function FirestoreApiProvider({ value, children, }) {
+    return createElement(FirestoreApiContext.Provider, { value }, children);
+}
+//# sourceMappingURL=firestoreApi.js.map

package/dist/firestore/firestoreApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestoreApi.js","sourceRoot":"","sources":["../../src/firestore/firestoreApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AACjF,OAAO,EACL,MAAM,EACN,UAAU,EACV,SAAS,EACT,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,KAAK,EACL,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AAsCzB,MAAM,qBAAqB,GAAiB;IAC1C,MAAM;IACN,UAAU;IACV,SAAS;IACT,GAAG;IACH,MAAM;IACN,OAAO;IACP,KAAK;IACL,UAAU;IACV,KAAK;IACL,MAAM;IACN,UAAU;CACX,CAAC;AAEF,MAAM,mBAAmB,GAAG,aAAa,CAAe,qBAAqB,CAAC,CAAC;AAE/E,uFAAuF;AACvF,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,aAAa,CAAC,mBAAmB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/firestore/hooks/coerceError.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Coerce an arbitrary thrown value into an `Error` with a useful
+ * `.message`. The naive `new Error(String(err))` produces the literal
+ * string `"[object Object]"` when `err` is a non-Error object shape
+ * — which is exactly what Firestore's `onSnapshot` error callback
+ * receives for `FirestoreError`-like values (`{ code, message, …}`).
+ *
+ * Strategy:
+ *   - `Error` → returned unchanged.
+ *   - `string` → `new Error(value)`.
+ *   - `{ message }` → `new Error(message)` (preserves Firestore's
+ *     stringified message), with `code` appended when present.
+ *   - anything else → `new Error(JSON.stringify(value))` (no more
+ *     "[object Object]").
+ */
+export declare function coerceError(value: unknown): Error;
+//# sourceMappingURL=coerceError.d.ts.map

package/dist/firestore/hooks/coerceError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerceError.d.ts","sourceRoot":"","sources":["../../../src/firestore/hooks/coerceError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAkBjD"}

package/dist/firestore/hooks/coerceError.js

@@ -0,0 +1,41 @@
+/**
+ * Coerce an arbitrary thrown value into an `Error` with a useful
+ * `.message`. The naive `new Error(String(err))` produces the literal
+ * string `"[object Object]"` when `err` is a non-Error object shape
+ * — which is exactly what Firestore's `onSnapshot` error callback
+ * receives for `FirestoreError`-like values (`{ code, message, …}`).
+ *
+ * Strategy:
+ *   - `Error` → returned unchanged.
+ *   - `string` → `new Error(value)`.
+ *   - `{ message }` → `new Error(message)` (preserves Firestore's
+ *     stringified message), with `code` appended when present.
+ *   - anything else → `new Error(JSON.stringify(value))` (no more
+ *     "[object Object]").
+ */
+export function coerceError(value) {
+    if (value instanceof Error)
+        return value;
+    if (typeof value === 'string')
+        return new Error(value);
+    if (value && typeof value === 'object') {
+        const obj = value;
+        const msg = typeof obj.message === 'string' ? obj.message : null;
+        const code = typeof obj.code === 'string' ? obj.code : null;
+        if (msg && code)
+            return new Error(`[${code}] ${msg}`);
+        if (msg)
+            return new Error(msg);
+        if (code)
+            return new Error(code);
+        try {
+            return new Error(JSON.stringify(value));
+        }
+        catch {
+            // Cyclic objects — bail to a type tag rather than crash.
+            return new Error(Object.prototype.toString.call(value));
+        }
+    }
+    return new Error(String(value));
+}
+//# sourceMappingURL=coerceError.js.map

package/dist/firestore/hooks/coerceError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerceError.js","sourceRoot":"","sources":["../../../src/firestore/hooks/coerceError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAA8C,CAAC;QAC3D,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QACtD,IAAI,GAAG;YAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;YACzD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/firestore/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export { useFirestoreDoc, type SubscriptionState } from './useFirestoreDoc.js';
+export { useFirestoreCollection } from './useFirestoreCollection.js';
+export { useDocumentEditor, type UseDocumentEditorOptions, type UseDocumentEditorResult, } from './useDocumentEditor.js';
+export { useCollectionList, type UseCollectionListOptions, type UseCollectionListResult, } from './useCollectionList.js';
+export { useDocumentList, type UseDocumentListOptions, type UseDocumentListResult, } from './useDocumentList.js';
+export { useDocumentSubcollections, type ListSubcollections, type UseDocumentSubcollectionsOptions, type UseDocumentSubcollectionsResult, } from './useDocumentSubcollections.js';
+export { useRecursiveDelete, type RecursiveDeleteImpl, type RecursiveDeleteProgress, type UseRecursiveDeleteResult, } from './useRecursiveDelete.js';
+export { useReferencePicker, type BrowseLocation, type UseReferencePickerOptions, type UseReferencePickerResult, } from './useReferencePicker.js';
+export { useQueryBuilder, QUERY_OPS, MULTI_VALUE_OPS, type QueryOp, type QueryCondition, type QueryBuilderState, type QueryBuilderActions, type UseQueryBuilderOptions, type UseQueryBuilderResult, } from './useQueryBuilder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/firestore/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/firestore/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,GACrC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/firestore/hooks/index.js

@@ -0,0 +1,10 @@
+export { useFirestoreDoc } from './useFirestoreDoc.js';
+export { useFirestoreCollection } from './useFirestoreCollection.js';
+export { useDocumentEditor, } from './useDocumentEditor.js';
+export { useCollectionList, } from './useCollectionList.js';
+export { useDocumentList, } from './useDocumentList.js';
+export { useDocumentSubcollections, } from './useDocumentSubcollections.js';
+export { useRecursiveDelete, } from './useRecursiveDelete.js';
+export { useReferencePicker, } from './useReferencePicker.js';
+export { useQueryBuilder, QUERY_OPS, MULTI_VALUE_OPS, } from './useQueryBuilder.js';
+//# sourceMappingURL=index.js.map

package/dist/firestore/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/firestore/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,GAGhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,yBAAyB,GAI1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,GAOhB,MAAM,sBAAsB,CAAC"}

package/dist/firestore/hooks/useCollectionList.d.ts

@@ -0,0 +1,37 @@
+import { type CollectionReference, type DocumentReference, type Firestore } from 'pyric/firestore';
+export interface UseCollectionListOptions {
+    firestore: Firestore;
+    /** Parent document, or `null`/`undefined` for root collections. */
+    parent?: DocumentReference | null;
+    /**
+     * Injected collection-listing function. The library doesn't ship
+     * a default — the modular Web SDK doesn't expose `listCollections`
+     * on the client. Sandbox-backed apps usually wire
+     * `pyric/sandbox`'s in-process listing; production apps either
+     * pass a known list (e.g. from a schema) or call a server proxy.
+     */
+    listCollections: (firestore: Firestore, parent: DocumentReference | null | undefined) => Promise<CollectionReference[]>;
+}
+export interface UseCollectionListResult {
+    collections: CollectionReference[];
+    isLoading: boolean;
+    error: Error | undefined;
+    /** Re-run the listing function. */
+    refresh: () => void;
+    /**
+     * Create a new collection by writing its first document. Firestore
+     * collections don't exist independently of their documents —
+     * `setDoc` on the first child path materializes the collection.
+     */
+    createCollection: (collectionId: string, firstDoc: {
+        id: string;
+        data: Record<string, unknown>;
+    }) => Promise<DocumentReference>;
+}
+/**
+ * Operational read + create for collections under a parent (or root).
+ * Listing is injected because the modular Web SDK doesn't expose a
+ * native `listCollections` on the client — see options docs.
+ */
+export declare function useCollectionList({ firestore, parent, listCollections, }: UseCollectionListOptions): UseCollectionListResult;
+//# sourceMappingURL=useCollectionList.d.ts.map

package/dist/firestore/hooks/useCollectionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionList.d.ts","sourceRoot":"","sources":["../../../src/firestore/hooks/useCollectionList.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,SAAS,CAAC;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC;;;;;;OAMG;IACH,eAAe,EAAE,CACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,KACzC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KACpD,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,MAAM,EACN,eAAe,GAChB,EAAE,wBAAwB,GAAG,uBAAuB,CAgDpD"}

package/dist/firestore/hooks/useCollectionList.js

@@ -0,0 +1,51 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { collection as collFn, doc as docFn, setDoc, } from 'pyric/firestore';
+/**
+ * Operational read + create for collections under a parent (or root).
+ * Listing is injected because the modular Web SDK doesn't expose a
+ * native `listCollections` on the client — see options docs.
+ */
+export function useCollectionList({ firestore, parent, listCollections, }) {
+    const [collections, setCollections] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(undefined);
+    const [tick, setTick] = useState(0);
+    // Stable-ref the injected lister so re-renders with a fresh
+    // closure identity don't loop the effect — see useReferencePicker
+    // for the same pattern + rationale.
+    const listCollectionsRef = useRef(listCollections);
+    listCollectionsRef.current = listCollections;
+    useEffect(() => {
+        let cancelled = false;
+        setIsLoading(true);
+        setError(undefined);
+        listCollectionsRef.current(firestore, parent)
+            .then((list) => {
+            if (cancelled)
+                return;
+            setCollections(list);
+            setIsLoading(false);
+        })
+            .catch((e) => {
+            if (cancelled)
+                return;
+            setError(e instanceof Error ? e : new Error(String(e)));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [firestore, parent, tick]);
+    const refresh = useCallback(() => setTick((n) => n + 1), []);
+    const createCollection = useCallback(async (collectionId, firstDoc) => {
+        const parentColl = parent
+            ? collFn(parent, collectionId)
+            : collFn(firestore, collectionId);
+        const ref = docFn(parentColl, firstDoc.id);
+        await setDoc(ref, firstDoc.data);
+        setTick((n) => n + 1);
+        return ref;
+    }, [firestore, parent]);
+    return { collections, isLoading, error, refresh, createCollection };
+}
+//# sourceMappingURL=useCollectionList.js.map

package/dist/firestore/hooks/useCollectionList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionList.js","sourceRoot":"","sources":["../../../src/firestore/hooks/useCollectionList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EACL,UAAU,IAAI,MAAM,EACpB,GAAG,IAAI,KAAK,EACZ,MAAM,GAIP,MAAM,iBAAiB,CAAC;AAoCzB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,SAAS,EACT,MAAM,EACN,eAAe,GACU;IACzB,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAwB,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,SAAS,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEpC,4DAA4D;IAC5D,kEAAkE;IAClE,oCAAoC;IACpC,MAAM,kBAAkB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,kBAAkB,CAAC,OAAO,GAAG,eAAe,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;aAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,SAAS;gBAAE,OAAO;YACtB,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACX,IAAI,SAAS;gBAAE,OAAO;YACtB,QAAQ,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7D,MAAM,gBAAgB,GAAG,WAAW,CAClC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,MAAM;YACvB,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;YAC9B,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC,EACD,CAAC,SAAS,EAAE,MAAM,CAAC,CACpB,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AACtE,CAAC"}

package/dist/firestore/hooks/useDocumentEditor.d.ts

@@ -0,0 +1,61 @@
+import type { FieldType } from '../types.js';
+import type { DocumentEditorAction, DocumentEditorState } from '../reducers/types.js';
+export interface UseDocumentEditorOptions {
+    /** Initial document data — the same shape a `DocumentSnapshot.data()`
+     *  call returns. */
+    initial?: Record<string, unknown>;
+}
+export interface UseDocumentEditorResult extends DocumentEditorState {
+    /** Convenience: `errorCount === 0`. */
+    isValid: boolean;
+    /** `true` once any modifying action has fired since the last
+     *  `reset`. Cleared by `reset`. Does NOT clear when the user
+     *  manually re-enters the original values — checking that would
+     *  require a full serialization comparison on every dispatch. */
+    isDirty: boolean;
+    /** Raw dispatch — drops to the reducer-action surface. Prefer the
+     *  named helpers below. */
+    dispatch: (action: DocumentEditorAction) => void;
+    /** Update a leaf value. */
+    setValue: (nodeId: string, value: unknown) => void;
+    /** Switch a node's type. Map/array nodes drop their children. */
+    setType: (nodeId: string, newType: FieldType) => void;
+    /** Set a map-child's key. */
+    setKey: (nodeId: string, key: string) => void;
+    /** Append a child to a map. */
+    addMapEntry: (parentId: string, key: string, childType: FieldType) => void;
+    /** Append a child to an array. Nested arrays are silently
+     *  rejected by the reducer (Firestore disallows them). */
+    addArrayEntry: (parentId: string, childType: FieldType) => void;
+    /** Remove a node (and all its descendants). Removing the root is
+     *  a no-op. */
+    remove: (nodeId: string) => void;
+    /** Restore the tree to its initial state. Clears `isDirty`. */
+    reset: () => void;
+    /** Replace the editor with a newly delivered snapshot and adopt it as the
+     * clean baseline. Intended for live document viewers. */
+    replaceData: (data: Record<string, unknown>) => void;
+    /** Mark one node touched (dispatch on blur). Gates error display —
+     *  a freshly-added row stays quiet until the user leaves it. */
+    touch: (nodeId: string) => void;
+    /** Mark every node touched (dispatch on a submit attempt) so any
+     *  hidden errors surface at once. */
+    touchAll: () => void;
+    /** Serialize the tree back to a Firestore-shaped object suitable
+     *  for `setDoc` / `updateDoc`. */
+    toData: () => Record<string, unknown>;
+}
+/**
+ * Headless document editor. Owns the entire edit state for one
+ * document via a pure reducer. Consumers either render the bundled
+ * `<DocumentEditor>` compound component over this hook, or render
+ * their own tree using the returned state.
+ *
+ * The hook builds its tree from `initial` on first mount. Changing
+ * `initial` later does NOT rebuild the tree; live viewers explicitly call
+ * `replaceData()` when a newer snapshot should become the clean baseline.
+ * This matches the firebase-tools-ui pattern of treating the editor as a
+ * stateful workspace while still allowing snapshot-driven reconciliation.
+ */
+export declare function useDocumentEditor(options?: UseDocumentEditorOptions): UseDocumentEditorResult;
+//# sourceMappingURL=useDocumentEditor.d.ts.map

package/dist/firestore/hooks/useDocumentEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentEditor.d.ts","sourceRoot":"","sources":["../../../src/firestore/hooks/useDocumentEditor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IACvC;wBACoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB;;;qEAGiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB;+BAC2B;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACjD,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,iEAAiE;IACjE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACtD,6BAA6B;IAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,+BAA+B;IAC/B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3E;8DAC0D;IAC1D,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IAChE;mBACe;IACf,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+DAA+D;IAC/D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;6DACyD;IACzD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD;oEACgE;IAChE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;yCACqC;IACrC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;sCACkC;IAClC,MAAM,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CA0FzB"}

package/dist/firestore/hooks/useDocumentEditor.js

@@ -0,0 +1,71 @@
+import { useCallback, useMemo, useReducer, useRef } from 'react';
+import { initState, reducer } from '../reducers/documentEditor.js';
+import { treeToData } from '../reducers/tree.js';
+/**
+ * Headless document editor. Owns the entire edit state for one
+ * document via a pure reducer. Consumers either render the bundled
+ * `<DocumentEditor>` compound component over this hook, or render
+ * their own tree using the returned state.
+ *
+ * The hook builds its tree from `initial` on first mount. Changing
+ * `initial` later does NOT rebuild the tree; live viewers explicitly call
+ * `replaceData()` when a newer snapshot should become the clean baseline.
+ * This matches the firebase-tools-ui pattern of treating the editor as a
+ * stateful workspace while still allowing snapshot-driven reconciliation.
+ */
+export function useDocumentEditor(options = {}) {
+    const initial = options.initial ?? {};
+    // `useRef` so the initial snapshot is computed once. The reducer
+    // owns the live tree from there on.
+    const initialRef = useRef(null);
+    if (initialRef.current == null) {
+        initialRef.current = initState(initial);
+    }
+    const [state, dispatch] = useReducer(reducer, initialRef.current);
+    const setValue = useCallback((nodeId, value) => dispatch({ type: 'setValue', nodeId, value }), []);
+    const setType = useCallback((nodeId, newType) => dispatch({ type: 'setType', nodeId, newType }), []);
+    const setKey = useCallback((nodeId, key) => dispatch({ type: 'setKey', nodeId, key }), []);
+    const addMapEntry = useCallback((parentId, key, childType) => dispatch({ type: 'addMapEntry', parentId, key, childType }), []);
+    const addArrayEntry = useCallback((parentId, childType) => dispatch({ type: 'addArrayEntry', parentId, childType }), []);
+    const remove = useCallback((nodeId) => dispatch({ type: 'remove', nodeId }), []);
+    const reset = useCallback(() => dispatch({ type: 'reset' }), []);
+    const replaceData = useCallback((data) => dispatch({ type: 'replaceData', data }), []);
+    const touch = useCallback((nodeId) => dispatch({ type: 'touch', nodeId }), []);
+    const touchAll = useCallback(() => dispatch({ type: 'touchAll' }), []);
+    const toData = useCallback(() => treeToData(state.tree), [state.tree]);
+    const isDirty = state.tree !== state.initial;
+    const isValid = state.errorCount === 0;
+    return useMemo(() => ({
+        ...state,
+        isDirty,
+        isValid,
+        dispatch,
+        setValue,
+        setType,
+        setKey,
+        addMapEntry,
+        addArrayEntry,
+        remove,
+        reset,
+        replaceData,
+        touch,
+        touchAll,
+        toData,
+    }), [
+        state,
+        isDirty,
+        isValid,
+        setValue,
+        setType,
+        setKey,
+        addMapEntry,
+        addArrayEntry,
+        remove,
+        reset,
+        replaceData,
+        touch,
+        touchAll,
+        toData,
+    ]);
+}
+//# sourceMappingURL=useDocumentEditor.js.map

package/dist/firestore/hooks/useDocumentEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentEditor.js","sourceRoot":"","sources":["../../../src/firestore/hooks/useDocumentEditor.ts"],"names":[],"mappings":"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"}

package/dist/firestore/hooks/useDocumentList.d.ts

@@ -0,0 +1,50 @@
+import type { CollectionReference, DocumentReference, Query, QueryDocumentSnapshot } from 'pyric/firestore';
+export interface UseDocumentListOptions {
+    collection: CollectionReference;
+    /** Optional filter / sort. If omitted, the raw collection is used. */
+    query?: Query;
+    /** Page size for cursor-based pagination. Default 50. */
+    pageSize?: number;
+    /**
+     * `paged` preserves the historical get-based cursor behavior. `live` keeps
+     * the currently requested window under an `onSnapshot` subscription and
+     * grows that window when `loadMore` is requested. Default `paged`.
+     */
+    mode?: 'paged' | 'live';
+}
+export interface UseDocumentListResult {
+    documents: QueryDocumentSnapshot[];
+    isLoading: boolean;
+    error: Error | undefined;
+    /** Identifies the active live subscription. Consumers that diff result
+     * snapshots can include this in their scope so a re-subscription (including
+     * load-more) establishes a silent baseline instead of looking like writes. */
+    subscriptionGeneration: number;
+    /** True if there might be another page. The hook tracks this via
+     *  the last fetch's length === pageSize. */
+    hasMore: boolean;
+    /** Fetch the next page; live mode grows and re-establishes its window. */
+    loadMore: () => void;
+    /** Create a document. If `id` is null, Firestore generates one
+     *  via `addDoc`. With `onExisting: 'fail'` (CREATE semantics, the
+     *  admin `create()` analog) an id that already exists rejects with
+     *  `code: 'already-exists'` instead of silently overwriting —
+     *  checked against the BACKEND (a `getDoc` probe), not any loaded
+     *  page, so it is honest beyond pagination. Default: 'overwrite'
+     *  (plain `setDoc`, the historical behavior). */
+    createDocument: (id: string | null, data: Record<string, unknown>, opts?: {
+        onExisting?: 'overwrite' | 'fail';
+    }) => Promise<DocumentReference>;
+    deleteDocument: (ref: DocumentReference) => Promise<void>;
+    /** Re-establish the active read/subscription. Useful after the consumer
+     *  mutates data outside this hook. */
+    refresh: () => void;
+}
+/**
+ * Paginated document list with two acquisition strategies. The default
+ * `paged` mode uses `startAfter` and accumulates one-shot reads. `live` keeps
+ * the requested prefix under one `onSnapshot` listener; loading more grows
+ * that prefix and establishes a new subscription baseline.
+ */
+export declare function useDocumentList({ collection, query, pageSize, mode, }: UseDocumentListOptions): UseDocumentListResult;
+//# sourceMappingURL=useDocumentList.d.ts.map

package/dist/firestore/hooks/useDocumentList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentList.d.ts","sourceRoot":"","sources":["../../../src/firestore/hooks/useDocumentList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,EACL,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,mBAAmB,CAAC;IAChC,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB;;kFAE8E;IAC9E,sBAAsB,EAAE,MAAM,CAAC;IAC/B;gDAC4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;;qDAMiD;IACjD,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;KAAE,KACzC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,cAAc,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;0CACsC;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,KAAK,EACL,QAAa,EACb,IAAc,GACf,EAAE,sBAAsB,GAAG,qBAAqB,CAgLhD"}