@pyric/ui 0.1.0-alpha.7

package/dist/firestore/fieldEditors/string.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function StringDisplay({ value, path }) {
+    return (_jsx("span", { "data-pyric-field-type": "string", "data-pyric-field-path": path, children: value }));
+}
+function StringEdit({ value, onChange, error, path }) {
+    return (_jsxs("label", { "data-pyric-field-type": "string", "data-pyric-field-path": path, "data-pyric-error": error ? '' : undefined, children: [_jsx("input", { type: "text", value: value, onChange: (e) => onChange(e.target.value), "aria-invalid": error ? 'true' : undefined }), error ? _jsx("span", { "data-pyric-error-message": true, children: error }) : null] }));
+}
+export const stringEditor = {
+    type: 'string',
+    Display: StringDisplay,
+    Edit: StringEdit,
+};
+//# sourceMappingURL=string.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/string.tsx"],"names":[],"mappings":";AAEA,SAAS,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAA6B;IAC/D,OAAO,CACL,wCAA4B,QAAQ,2BAAwB,IAAI,YAC7D,KAAK,GACD,CACR,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAA0B;IAC1E,OAAO,CACL,0CACwB,QAAQ,2BACP,IAAI,sBACT,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,aAExC,gBACE,IAAI,EAAC,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kBAC3B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,GACxC,EACD,KAAK,CAAC,CAAC,CAAC,2DAAgC,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,IACvD,CACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAgC;IACvD,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,UAAU;CACjB,CAAC"}

package/dist/firestore/fieldEditors/timestamp.d.ts

@@ -0,0 +1,4 @@
+import { Timestamp } from 'pyric/firestore';
+import type { FieldEditorContract } from './types.js';
+export declare const timestampEditor: FieldEditorContract<Timestamp>;
+//# sourceMappingURL=timestamp.d.ts.map

package/dist/firestore/fieldEditors/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/timestamp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,YAAY,CAAC;AAqEzF,eAAO,MAAM,eAAe,EAAE,mBAAmB,CAAC,SAAS,CAI1D,CAAC"}

package/dist/firestore/fieldEditors/timestamp.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Timestamp } from 'pyric/firestore';
+/**
+ * Coerce a Timestamp value to a Date. Real instances use `.toDate()`; a value
+ * that crossed a worker / postMessage boundary arrives as a plain
+ * `{ seconds, nanoseconds }` (or `{ _seconds, _nanoseconds }`) and is rebuilt
+ * here, so the display + editor work in both in-process and served modes.
+ */
+function coerceDate(value) {
+    if (value instanceof Timestamp)
+        return value.toDate();
+    const o = value;
+    const seconds = o ? (o.seconds ?? o._seconds) : undefined;
+    const nanoseconds = o ? (o.nanoseconds ?? o._nanoseconds ?? 0) : 0;
+    if (typeof seconds === 'number')
+        return new Date(seconds * 1000 + Math.floor(nanoseconds / 1e6));
+    return new Date(NaN);
+}
+function TimestampDisplay({ value, path }) {
+    const date = coerceDate(value);
+    const iso = Number.isNaN(date.getTime()) ? '' : date.toISOString();
+    return (_jsx("time", { dateTime: iso, "data-pyric-field-type": "timestamp", "data-pyric-field-path": path, children: iso }));
+}
+/**
+ * Native `<input type="datetime-local">` for editing. The element
+ * speaks local time (no zone offset); we convert to/from a UTC
+ * `Timestamp` at the boundary so the underlying value stays
+ * timezone-correct.
+ */
+function TimestampEdit({ value, onChange, error, path }) {
+    // Convert the value to the `YYYY-MM-DDTHH:MM` shape <input
+    // datetime-local> wants. Seconds and millis aren't part of the
+    // native input precision; round-trips through this editor lose
+    // sub-minute resolution intentionally — consumers needing higher
+    // fidelity should swap the editor out via the registry.
+    const dt = coerceDate(value);
+    const local = new Date(dt.getTime() - dt.getTimezoneOffset() * 60_000);
+    const inputValue = Number.isNaN(local.getTime()) ? '' : local.toISOString().slice(0, 16);
+    return (_jsxs("label", { "data-pyric-field-type": "timestamp", "data-pyric-field-path": path, "data-pyric-error": error ? '' : undefined, children: [_jsx("input", { type: "datetime-local", value: inputValue, onChange: (e) => {
+                    const next = e.target.value;
+                    if (!next)
+                        return;
+                    const localDate = new Date(next);
+                    onChange(Timestamp.fromDate(localDate));
+                }, "aria-invalid": error ? 'true' : undefined }), error ? _jsx("span", { "data-pyric-error-message": true, children: error }) : null] }));
+}
+export const timestampEditor = {
+    type: 'timestamp',
+    Display: TimestampDisplay,
+    Edit: TimestampEdit,
+};
+//# sourceMappingURL=timestamp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/timestamp.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;;;GAKG;AACH,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACtD,MAAM,CAAC,GAAG,KAAsC,CAAC;IACjD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;IACjG,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAgC;IACrE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACnE,OAAO,CACL,eACE,QAAQ,EAAE,GAAG,2BACS,WAAW,2BACV,IAAI,YAE1B,GAAG,GACC,CACR,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAA6B;IAChF,2DAA2D;IAC3D,+DAA+D;IAC/D,+DAA+D;IAC/D,iEAAiE;IACjE,wDAAwD;IACxD,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,GAAG,MAAM,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzF,OAAO,CACL,0CACwB,WAAW,2BACV,IAAI,sBACT,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,aAExC,gBACE,IAAI,EAAC,gBAAgB,EACrB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;oBACd,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC5B,IAAI,CAAC,IAAI;wBAAE,OAAO;oBAClB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC1C,CAAC,kBACa,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,GACxC,EACD,KAAK,CAAC,CAAC,CAAC,2DAAgC,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,IACvD,CACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,gBAAgB;IACzB,IAAI,EAAE,aAAa;CACpB,CAAC"}

package/dist/firestore/fieldEditors/types.d.ts

@@ -0,0 +1,64 @@
+import type { ComponentType } from 'react';
+import type { FieldType } from '../types.js';
+export interface FieldDisplayProps<V = unknown> {
+    /** Value to display. The component's `V` generic narrows this. */
+    value: V;
+    /** Dotted/bracketed path from the document root, e.g. `users.alice`
+     *  or `tags[0]`. Forwarded so consumer styles can target nested
+     *  positions via `[data-field-path="users.alice"]`. */
+    path?: string;
+    /** Recursive editors (Map, Array) need the registry to dispatch
+     *  on their children. Leaf editors (String, Number, …) can ignore
+     *  this prop. Required-but-optional because the consumer of the
+     *  component (`<FieldRenderer>`, `<DocumentPreview>`) always
+     *  threads it through. */
+    fieldEditors?: FieldEditorRegistry;
+}
+/**
+ * Props passed to a per-type `Edit` component. The leaf editors
+ * (string, number, …) consume this directly. Map/array editing is
+ * handled by the `<DocumentEditor>` compound component itself, not
+ * by individual editors — Firestore's container shapes are special
+ * enough that pushing them through the registry costs more than
+ * it's worth.
+ */
+export interface FieldEditProps<V = unknown> {
+    /** Current value. */
+    value: V;
+    /** Commit a new value. The hook wires this to the reducer's
+     *  `setValue` action. */
+    onChange: (next: V) => void;
+    /** Validation error attached by the reducer. Editors render it
+     *  inline alongside the input. */
+    error?: string;
+    /** Dotted/bracketed path from the document root. */
+    path?: string;
+}
+/**
+ * Contract for one Firestore value type. `Display` (read-mode) is
+ * required; `Edit` + `validate` + `defaultValue` are required for
+ * leaf types that participate in M3's editor. Map/array contracts
+ * supply only `Display` — their edit affordances come from the
+ * `<DocumentEditor>` compound component.
+ */
+export interface FieldEditorContract<V = unknown> {
+    type: FieldType;
+    Display: ComponentType<FieldDisplayProps<V>>;
+    Edit?: ComponentType<FieldEditProps<V>>;
+}
+/**
+ * Map of field-type to editor contract. `Partial<…>` so consumers
+ * can override one type without re-supplying the rest — the merge
+ * happens at the `<DocumentPreview>` boundary.
+ *
+ * The stored value type is `FieldEditorContract<any>` rather than
+ * `FieldEditorContract<unknown>` because each per-type contract
+ * narrows its generic (e.g., `FieldEditorContract<Timestamp>` for
+ * timestamp) and TypeScript's `ComponentType` is invariant in
+ * props. `any` at the registry layer means the type-safety lives
+ * at the per-contract definition site, not in the dispatch map.
+ * `FieldRenderer` narrows back from `unknown` -> the right contract
+ * via `inferType` at dispatch time.
+ */
+export type FieldEditorRegistry = Partial<Record<FieldType, FieldEditorContract<any>>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/firestore/fieldEditors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,kEAAkE;IAClE,KAAK,EAAE,CAAC,CAAC;IACT;;2DAEuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;8BAI0B;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,qBAAqB;IACrB,KAAK,EAAE,CAAC,CAAC;IACT;6BACyB;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B;sCACkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/firestore/fieldEditors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/types.ts"],"names":[],"mappings":""}

package/dist/firestore/fieldEditors/vector.d.ts

@@ -0,0 +1,29 @@
+import { type VectorView } from '../types.js';
+import type { FieldEditorContract } from './types.js';
+/**
+ * Result of parsing the raw-replace textarea. `ok` carries the new
+ * wire-sentinel value to commit; otherwise `error` is a human message.
+ * Exported (and pure) so the parse/validation contract is unit-testable
+ * without the JSDOM text-input event path, which is broken under this
+ * repo's bun:test + JSDOM setup (see DocumentEditor.test.tsx note).
+ */
+export type ParsedVectorInput = {
+    ok: true;
+    value: {
+        __type__: '__vector__';
+        value: number[];
+    };
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 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 declare function parseVectorInput(text: string): ParsedVectorInput;
+export declare const vectorEditor: FieldEditorContract<unknown>;
+export type { VectorView };
+//# sourceMappingURL=vector.d.ts.map

package/dist/firestore/fieldEditors/vector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/vector.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAqC,MAAM,YAAY,CAAC;AA+CzF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GAChE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAWhE;AA0DD,eAAO,MAAM,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAIrD,CAAC;AAEF,YAAY,EAAE,UAAU,EAAE,CAAC"}

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":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAG5D;0DAC0D;AAC1D,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;GAIG;AACH,SAAS,WAAW,CAAC,MAAgB;IACnC,IAAI,MAAM,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,IAAI,IAAI,MAAM,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAA8B;IAChE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,gEAAgE;QAChE,iEAAiE;QACjE,+CAA+C;QAC/C,OAAO,CACL,wCAA4B,QAAQ,2BAAwB,IAAI,GAAI,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,CACL,yCACwB,QAAQ,2BACP,IAAI,oBACX,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAEtC,yDAA8B,YAAY,IAAI,CAAC,SAAS,EAAE,GAAQ,EAClE,4DAAiC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAQ,IAC5D,CACR,CAAC;AACJ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC1E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAA2B;IAC3E,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAE5E,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;QAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,kEAAkE;QAClE,gEAAgE;QAChE,2CAA2C;QAC3C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,IAAI,KAAK,CAAC;IAElC,OAAO,CACL,0CACwB,QAAQ,2BACP,IAAI,oBACX,MAAM,CAAC,IAAI,CAAC,sBACV,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,aAExC,yDAA8B,YAAY,IAAI,EAAE,GAAQ,EACxD,uGAA6E,EAC7E,kDAEE,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,kBACzB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,gBAC7B,kCAAkC,GAC7C,EACD,KAAK,CAAC,CAAC,CAAC,2DAAgC,KAAK,GAAQ,CAAC,CAAC,CAAC,IAAI,IACvD,CACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,UAAU;CACjB,CAAC"}

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-tools/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' | '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;AAcjF;;;;;;;;;;;;;;;;;;;;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,OAAO,GACP,QAAQ,GACR,YAAY,CACf,CAAC;AAiBF,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,28 @@
+import { createContext, createElement, useContext } from 'react';
+import { addDoc, collection, deleteDoc, doc, getDoc, getDocs, limit, query, setDoc, startAfter, } from 'pyric/firestore';
+const inProcessFirestoreApi = {
+    addDoc,
+    collection,
+    deleteDoc,
+    doc,
+    getDoc,
+    getDocs,
+    limit,
+    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,KAAK,EACL,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AAqCzB,MAAM,qBAAqB,GAAiB;IAC1C,MAAM;IACN,UAAU;IACV,SAAS;IACT,GAAG;IACH,MAAM;IACN,OAAO;IACP,KAAK;IACL,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"}