@pyric/ui 0.1.0-alpha.10

package/dist/firestore/components/DocumentList.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { VirtualList } from '../../primitives/VirtualList.js';
+import { useUpdateHighlights } from '../../primitives/hooks/useUpdateHighlights.js';
+import { firestoreValuesEqual } from '../valueEquality.js';
+/**
+ * Both backends carry `.ref` on snapshots at runtime, but the
+ * `pyric/firestore` modular interface omits it. Pull it through
+ * a structural cast — safe because the property is guaranteed by
+ * the underlying SDKs.
+ */
+function snapshotRef(snap) {
+    return snap.ref;
+}
+/**
+ * Headless document list. Below `virtualizeThreshold`, renders a
+ * plain `<ul>`; above it, switches to TanStack-Virtual via
+ * `<VirtualList>` so 10k-doc collections don't bloat the DOM.
+ *
+ * The hook owns pagination state; this component just renders. The
+ * Load More button only renders when `hasMore` is true AND
+ * `onLoadMore` is provided. Consumers wanting infinite scroll
+ * trigger `onLoadMore` from a sentinel `IntersectionObserver` in
+ * their own code — the component doesn't bake that policy in.
+ */
+export function DocumentList({ documents, isLoading, error, hasMore, onSelect, onLoadMore, renderLabel, renderRowAction, emptyState, className, updateScope = 'document-list', virtualizeThreshold = 100, rowHeight = 36, virtualizedHeight = '60vh', }) {
+    const updateEntries = useMemo(() => new Map(documents.map((snapshot) => [snapshotRef(snapshot).path, snapshot.data()])), [documents]);
+    const updates = useUpdateHighlights({
+        scope: updateScope,
+        entries: updateEntries,
+        equals: firestoreValuesEqual,
+        ready: !isLoading,
+    });
+    if (error) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "document-list", "data-pyric-error": "", role: "alert", children: error.message }));
+    }
+    if (isLoading && documents.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "document-list", "data-pyric-loading": "" }));
+    }
+    if (documents.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "document-list", "data-pyric-empty": "", children: emptyState }));
+    }
+    const virtualized = documents.length > virtualizeThreshold;
+    return (_jsxs("div", { className: className, "data-pyric-ui": "document-list", "data-pyric-virtualized": virtualized ? '' : undefined, children: [virtualized ? (_jsx(VirtualList, { items: documents, estimateSize: rowHeight, height: virtualizedHeight, getItemKey: (doc) => snapshotRef(doc).path, renderItem: (doc) => {
+                    const update = updates.get(snapshotRef(doc).path);
+                    return (_jsxs("div", { "data-pyric-document-entry": true, "data-pyric-document-id": doc.id, "data-pyric-update": update?.kind, "data-pyric-update-cycle": update?.cycle, children: [_jsx("button", { type: "button", onClick: () => onSelect?.(snapshotRef(doc)), "data-pyric-document-select": true, "data-pyric-update": update?.kind, "data-pyric-update-cycle": update?.cycle, children: renderLabel ? renderLabel(doc) : doc.id }), renderRowAction ? (_jsx("span", { "data-pyric-document-action": true, children: renderRowAction(doc) })) : null] }));
+                } })) : (_jsx("ul", { "data-pyric-document-list-items": true, children: documents.map((doc) => {
+                    const ref = snapshotRef(doc);
+                    const update = updates.get(ref.path);
+                    return (_jsxs("li", { "data-pyric-document-entry": true, "data-pyric-document-id": doc.id, "data-pyric-update": update?.kind, "data-pyric-update-cycle": update?.cycle, children: [_jsx("button", { type: "button", onClick: () => onSelect?.(ref), "data-pyric-document-select": true, "data-pyric-update": update?.kind, "data-pyric-update-cycle": update?.cycle, children: renderLabel ? renderLabel(doc) : doc.id }), renderRowAction ? (_jsx("span", { "data-pyric-document-action": true, children: renderRowAction(doc) })) : null] }, ref.path));
+                }) })), hasMore && onLoadMore ? (_jsx("button", { type: "button", onClick: onLoadMore, "data-pyric-load-more": true, disabled: isLoading, children: "Load more" })) : null] }));
+}
+//# sourceMappingURL=DocumentList.js.map

package/dist/firestore/components/DocumentList.js.map

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

package/dist/firestore/components/DocumentPreview.d.ts

@@ -0,0 +1,68 @@
+import { type ReactNode } from 'react';
+import type { CollectionReference, DocumentReference, DocumentSnapshot, Firestore } from 'pyric/firestore';
+import type { FieldEditorRegistry } from '../fieldEditors/types.js';
+import { type ListSubcollections } from '../hooks/useDocumentSubcollections.js';
+export interface DocumentPreviewProps {
+    /** Snapshot from `useFirestoreDoc` or `getDoc`. When `null` /
+     *  `undefined`, renders {@link emptyState}. */
+    snapshot: DocumentSnapshot | null | undefined;
+    /** Override or extend the built-in field editors. Merged on top
+     *  of {@link defaultFieldEditors} — only the keys you provide
+     *  override. */
+    fieldEditors?: FieldEditorRegistry;
+    /** Content rendered when the snapshot is missing or
+     *  `!exists()`. Defaults to `null` (renders nothing). */
+    emptyState?: ReactNode;
+    /** Forwarded to the root `<div>`. */
+    className?: string;
+    /**
+     * Fired when a reference field is clicked. When supplied, the
+     * reference Display renders as an interactive `<button>` (with
+     * `data-pyric-clickable`); when omitted, it stays inert as a
+     * `<span>`. Consumers wire navigation here — the library does
+     * not depend on a router.
+     */
+    onReferenceClick?: (ref: DocumentReference) => void;
+    /**
+     * The document's own reference. Required to surface its
+     * subcollections — `DocumentSnapshot` (as typed by `pyric/firestore`)
+     * doesn't expose `.ref`, so the consumer threads the ref it already
+     * holds from fetching the doc. Without it (or without
+     * {@link listSubcollections}) the Subcollections section is omitted.
+     */
+    documentRef?: DocumentReference | null;
+    /**
+     * Firestore handle passed to {@link listSubcollections}. Required
+     * alongside `documentRef` + `listSubcollections` to surface the
+     * Subcollections section (the same explicit-handle shape
+     * `ReferencePicker` uses).
+     */
+    firestore?: Firestore;
+    /**
+     * Injected lister for the document's subcollections. The modular Web
+     * SDK has no client-side `listCollections`; sandbox-backed apps wire
+     * `pyric/sandbox`'s in-process listing, production apps pass a known
+     * list or a server proxy. Same shape `ReferencePicker` /
+     * `useCollectionList` use. Omit to hide the Subcollections section.
+     */
+    listSubcollections?: ListSubcollections;
+    /**
+     * Fired when a subcollection's drill affordance is activated. Receives
+     * the subcollection's `CollectionReference` (its `.path` is the
+     * navigate target). Consumers wire navigation here.
+     */
+    onSubcollectionClick?: (collection: CollectionReference) => void;
+}
+/**
+ * Read-only renderer for a Firestore document. Iterates top-level
+ * fields in lexicographic order; each field dispatches through the
+ * field-editor registry on its inferred type.
+ *
+ * Headless — no shipped CSS. Consumers style via `className` on the
+ * root and `[data-pyric-field-type]` / `[data-pyric-field-path]`
+ * attribute selectors on the per-field nodes.
+ *
+ * Editing arrives in M3 (`<DocumentEditor>`). M2 only displays.
+ */
+export declare function DocumentPreview({ snapshot, fieldEditors, emptyState, className, onReferenceClick, documentRef, firestore, listSubcollections, onSubcollectionClick, }: DocumentPreviewProps): import("react").JSX.Element;
+//# sourceMappingURL=DocumentPreview.d.ts.map

package/dist/firestore/components/DocumentPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentPreview.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/DocumentPreview.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACV,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,uCAAuC,CAAC;AAa/C,MAAM,WAAW,oBAAoB;IACnC;mDAC+C;IAC/C,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C;;oBAEgB;IAChB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;6DACyD;IACzD,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,EACZ,UAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,GACrB,EAAE,oBAAoB,+BAqCtB"}

package/dist/firestore/components/DocumentPreview.js

@@ -0,0 +1,76 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from 'react';
+import { FieldRenderer } from './FieldRenderer.js';
+import { inferType } from '../types.js';
+import { mergeFieldEditors } from '../fieldEditors/registry.js';
+import { DisplayContextProvider } from './context.js';
+import { useContainerSize } from '../../primitives/hooks/useContainerSize.js';
+import { useDocumentSubcollections, } from '../hooks/useDocumentSubcollections.js';
+/**
+ * `DocumentSnapshot.exists` is a method on the firebase/firestore
+ * `QueryDocumentSnapshot` (`.exists()`) and a getter/property on the
+ * Admin chainable adapter. `pyric/firestore` unions the two; this
+ * helper handles either.
+ */
+function snapshotExists(snapshot) {
+    const e = snapshot.exists;
+    return typeof e === 'function' ? e.call(snapshot) : e;
+}
+/**
+ * Read-only renderer for a Firestore document. Iterates top-level
+ * fields in lexicographic order; each field dispatches through the
+ * field-editor registry on its inferred type.
+ *
+ * Headless — no shipped CSS. Consumers style via `className` on the
+ * root and `[data-pyric-field-type]` / `[data-pyric-field-path]`
+ * attribute selectors on the per-field nodes.
+ *
+ * Editing arrives in M3 (`<DocumentEditor>`). M2 only displays.
+ */
+export function DocumentPreview({ snapshot, fieldEditors, emptyState = null, className, onReferenceClick, documentRef, firestore, listSubcollections, onSubcollectionClick, }) {
+    const displayCtx = useMemo(() => ({ onReferenceClick }), [onReferenceClick]);
+    const { ref: rootRef, size } = useContainerSize();
+    if (!snapshot || !snapshotExists(snapshot)) {
+        return _jsx(_Fragment, { children: emptyState });
+    }
+    const data = snapshot.data() ?? {};
+    const entries = Object.entries(data).sort(([a], [b]) => a.localeCompare(b));
+    const registry = mergeFieldEditors(fieldEditors);
+    return (_jsx(DisplayContextProvider, { value: displayCtx, children: _jsxs("div", { ref: rootRef, className: className, "data-pyric-ui": "document-preview", "data-doc-id": snapshot.id, "data-size": size, children: [entries.map(([key, value]) => (_jsx(FieldEntry, { fieldKey: key, value: value, registry: registry }, key))), firestore && documentRef && listSubcollections ? (_jsx(SubcollectionsSection, { firestore: firestore, documentRef: documentRef, listSubcollections: listSubcollections, onSubcollectionClick: onSubcollectionClick })) : null] }) }));
+}
+/**
+ * One top-level document field. A scalar renders `key  value` in the field grid;
+ * a map/array renders a disclosure (chevron + key) that collapses its value, so
+ * top-level containers toggle just like the nested tree does. A chevron gutter
+ * sits on scalars too (empty) so every key aligns.
+ */
+function FieldEntry({ fieldKey, value, registry, }) {
+    const type = inferType(value);
+    const nested = type === 'map' || type === 'array';
+    const [expanded, setExpanded] = useState(true);
+    if (!nested) {
+        return (_jsxs("div", { "data-pyric-field-entry": true, "data-field-name": fieldKey, children: [_jsxs("span", { "data-pyric-field-keycell": true, children: [_jsx("span", { "data-pyric-tree-chevron": true, "data-pyric-tree-chevron-empty": true, "aria-hidden": "true" }), _jsx("span", { "data-pyric-field-key": true, children: fieldKey })] }), _jsx(FieldRenderer, { value: value, path: fieldKey, fieldEditors: registry })] }));
+    }
+    return (_jsxs("div", { "data-pyric-field-entry": true, "data-field-name": fieldKey, "data-pyric-field-nested": true, children: [_jsxs("button", { type: "button", "data-pyric-field-keycell": true, "data-pyric-field-toggle": true, "aria-expanded": expanded, onClick: () => setExpanded((e) => !e), children: [_jsx("span", { "data-pyric-tree-chevron": true, "aria-hidden": "true", children: "\u203A" }), _jsx("span", { "data-pyric-field-key": true, children: fieldKey })] }), expanded ? _jsx(FieldRenderer, { value: value, path: fieldKey, fieldEditors: registry }) : null] }));
+}
+/**
+ * The "Subcollections" section under a document's fields. Lists the
+ * document's OWN subcollections (name + a drill affordance), mirroring
+ * the `c-data` mock. Reuses the injected-lister pattern; emits the
+ * subcollection ref through {@link onSubcollectionClick} for navigation.
+ *
+ * Renders nothing once loaded if the document has no subcollections —
+ * an empty section is noise. While loading it carries
+ * `data-pyric-loading` so consumers can show a placeholder.
+ */
+function SubcollectionsSection({ firestore, documentRef, listSubcollections, onSubcollectionClick, }) {
+    const { subcollections, isLoading } = useDocumentSubcollections({
+        firestore,
+        documentRef,
+        listSubcollections,
+    });
+    if (!isLoading && subcollections.length === 0)
+        return null;
+    return (_jsxs("section", { "data-pyric-ui": "subcollections", "data-pyric-loading": isLoading ? '' : undefined, children: [_jsx("div", { "data-pyric-subcollections-group": true, children: "Subcollections" }), _jsx("ul", { "data-pyric-subcollections-list": true, children: subcollections.map((coll) => (_jsx("li", { "data-pyric-subcollection": true, "data-pyric-collection-id": coll.id, "data-pyric-collection-path": coll.path, children: onSubcollectionClick ? (_jsxs("button", { type: "button", "data-pyric-subcollection-row": true, "data-pyric-clickable": true, onClick: () => onSubcollectionClick(coll), "aria-label": `Open subcollection ${coll.id}`, children: [_jsx("span", { "data-pyric-subcollection-key": true, children: coll.id }), _jsx("span", { "data-pyric-subcollection-type": true, children: "subcollection" }), _jsx("span", { "data-pyric-subcollection-drill": true, "aria-hidden": "true", children: "\u203A" })] })) : (_jsxs("div", { "data-pyric-subcollection-row": true, children: [_jsx("span", { "data-pyric-subcollection-key": true, children: coll.id }), _jsx("span", { "data-pyric-subcollection-type": true, children: "subcollection" }), _jsx("span", { "data-pyric-subcollection-drill": true, "aria-hidden": "true", children: "\u203A" })] })) }, coll.path))) })] }));
+}
+//# sourceMappingURL=DocumentPreview.js.map

package/dist/firestore/components/DocumentPreview.js.map

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

package/dist/firestore/components/FieldRenderer.d.ts

@@ -0,0 +1,17 @@
+import type { FieldEditorRegistry } from '../fieldEditors/types.js';
+export interface FieldRendererProps {
+    value: unknown;
+    path?: string;
+    /** Registry to dispatch through. Pass the merged registry — this
+     *  component does not fall back to defaults on its own (to avoid
+     *  a circular import with the editors). `<DocumentPreview>` is
+     *  the entry point that merges user overrides into defaults. */
+    fieldEditors: FieldEditorRegistry;
+}
+/**
+ * Dispatches a single value to its registered display component.
+ * Recursive editors (Map, Array) re-enter through this component
+ * for their children, threading the same registry.
+ */
+export declare function FieldRenderer({ value, path, fieldEditors }: FieldRendererProps): import("react").JSX.Element | null;
+//# sourceMappingURL=FieldRenderer.d.ts.map

package/dist/firestore/components/FieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldRenderer.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/FieldRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;oEAGgE;IAChE,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,kBAAkB,sCAM9E"}

package/dist/firestore/components/FieldRenderer.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { inferType } from '../types.js';
+/**
+ * Dispatches a single value to its registered display component.
+ * Recursive editors (Map, Array) re-enter through this component
+ * for their children, threading the same registry.
+ */
+export function FieldRenderer({ value, path, fieldEditors }) {
+    const type = inferType(value);
+    const contract = fieldEditors[type];
+    if (!contract)
+        return null;
+    const { Display } = contract;
+    return _jsx(Display, { value: value, path: path, fieldEditors: fieldEditors });
+}
+//# sourceMappingURL=FieldRenderer.js.map

package/dist/firestore/components/FieldRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldRenderer.js","sourceRoot":"","sources":["../../../src/firestore/components/FieldRenderer.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAaxC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAsB;IAC7E,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC7B,OAAO,KAAC,OAAO,IAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,GAAI,CAAC;AAC3E,CAAC"}

package/dist/firestore/components/QueryBuilder.d.ts

@@ -0,0 +1,25 @@
+import { type UseQueryBuilderOptions, type UseQueryBuilderResult } from '../hooks/useQueryBuilder.js';
+export interface QueryBuilderProps {
+    /** Drives the hook used internally. Both the state and the
+     *  composed Query are exposed via `onChange`. */
+    initial?: UseQueryBuilderOptions['initial'];
+    /** Fired on every state change with the latest builder API. The
+     *  parent typically calls `builder.buildQuery(collection)` and
+     *  feeds the result into `useDocumentList` / `useFirestoreCollection`. */
+    onChange?: (builder: UseQueryBuilderResult) => void;
+    className?: string;
+}
+/**
+ * Default visible composition over `useQueryBuilder`. Renders the
+ * condition list + orderBy + limit form. Headless — every node
+ * carries `data-pyric-*` for styling.
+ *
+ * Values are JSON-parsed on input. `42`, `"text"`, `true`, `null`,
+ * and `[1, 2, 3]` (for `in`/`not-in`/`array-contains-any`) all
+ * work; raw strings that aren't JSON-parsable fall through as-is.
+ * For non-JSON Firestore values (Timestamp, GeoPoint, Reference,
+ * Bytes), consumers either use the hook directly with their own
+ * value editors or swap the rendered component out.
+ */
+export declare function QueryBuilder({ initial, onChange, className }: QueryBuilderProps): import("react").JSX.Element;
+//# sourceMappingURL=QueryBuilder.d.ts.map

package/dist/firestore/components/QueryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBuilder.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/QueryBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC;qDACiD;IACjD,OAAO,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC5C;;8EAE0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,iBAAiB,+BA6H/E"}

package/dist/firestore/components/QueryBuilder.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQueryBuilder, QUERY_OPS, MULTI_VALUE_OPS, } from '../hooks/useQueryBuilder.js';
+/**
+ * Default visible composition over `useQueryBuilder`. Renders the
+ * condition list + orderBy + limit form. Headless — every node
+ * carries `data-pyric-*` for styling.
+ *
+ * Values are JSON-parsed on input. `42`, `"text"`, `true`, `null`,
+ * and `[1, 2, 3]` (for `in`/`not-in`/`array-contains-any`) all
+ * work; raw strings that aren't JSON-parsable fall through as-is.
+ * For non-JSON Firestore values (Timestamp, GeoPoint, Reference,
+ * Bytes), consumers either use the hook directly with their own
+ * value editors or swap the rendered component out.
+ */
+export function QueryBuilder({ initial, onChange, className }) {
+    const builder = useQueryBuilder({ initial });
+    // Pipe state changes back to the consumer. We don't memoize on
+    // the builder object itself since the hook already memoizes
+    // internally; calling onChange every render is cheap and matches
+    // the `<DocumentEditor>` pattern.
+    if (onChange)
+        onChange(builder);
+    return (_jsxs("div", { className: className, "data-pyric-ui": "query-builder", children: [_jsx("ul", { "data-pyric-query-conditions": true, children: builder.conditions.map((cond) => (_jsxs("li", { "data-pyric-query-condition": true, children: [_jsx("input", { type: "text", value: cond.field, placeholder: "field", onChange: (e) => builder.updateCondition(cond.id, { field: e.target.value }), "data-pyric-query-field": true, "aria-label": "Field" }), _jsx("select", { value: cond.op, onChange: (e) => builder.updateCondition(cond.id, { op: e.target.value }), "data-pyric-query-op": true, "aria-label": "Operator", children: QUERY_OPS.map((op) => (_jsx("option", { value: op, children: op }, op))) }), _jsx("input", { type: "text", value: stringifyValue(cond.value), placeholder: MULTI_VALUE_OPS.has(cond.op) ? '[1, 2]' : 'value', onChange: (e) => builder.updateCondition(cond.id, { value: parseValue(e.target.value) }), "data-pyric-query-value": true, "aria-label": "Value" }), _jsx("button", { type: "button", onClick: () => builder.removeCondition(cond.id), "data-pyric-query-remove": true, "aria-label": "Remove condition", children: "\u00D7" })] }, cond.id))) }), _jsx("button", { type: "button", onClick: () => builder.addCondition(), "data-pyric-query-add-condition": true, children: "+ Add condition" }), _jsxs("div", { "data-pyric-query-modifiers": true, children: [_jsxs("label", { "data-pyric-query-orderby": true, children: [_jsx("span", { children: "orderBy" }), _jsx("input", { type: "text", value: builder.orderBy?.field ?? '', placeholder: "field", onChange: (e) => {
+                                    const field = e.target.value;
+                                    if (!field) {
+                                        builder.setOrderBy(undefined);
+                                    }
+                                    else {
+                                        builder.setOrderBy({
+                                            field,
+                                            direction: builder.orderBy?.direction ?? 'asc',
+                                        });
+                                    }
+                                }, "data-pyric-query-orderby-field": true }), _jsxs("select", { value: builder.orderBy?.direction ?? 'asc', onChange: (e) => {
+                                    if (!builder.orderBy?.field)
+                                        return;
+                                    builder.setOrderBy({
+                                        field: builder.orderBy.field,
+                                        direction: e.target.value,
+                                    });
+                                }, disabled: !builder.orderBy?.field, "data-pyric-query-orderby-direction": true, children: [_jsx("option", { value: "asc", children: "asc" }), _jsx("option", { value: "desc", children: "desc" })] })] }), _jsxs("label", { "data-pyric-query-limit": true, children: [_jsx("span", { children: "limit" }), _jsx("input", { type: "number", min: 0, value: builder.limit ?? '', placeholder: "\u221E", onChange: (e) => {
+                                    const v = e.target.value;
+                                    if (!v) {
+                                        builder.setLimit(undefined);
+                                    }
+                                    else {
+                                        const n = parseInt(v, 10);
+                                        builder.setLimit(Number.isFinite(n) ? n : undefined);
+                                    }
+                                }, "data-pyric-query-limit-input": true })] })] })] }));
+}
+function parseValue(raw) {
+    if (raw === '')
+        return '';
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // Not JSON — return the raw string. Firestore `where` will
+        // refuse mistyped values at query time; the builder doesn't
+        // gate on type because some workflows (e.g. searching by a
+        // numeric-string id) are deliberate.
+        return raw;
+    }
+}
+function stringifyValue(v) {
+    if (typeof v === 'string')
+        return v;
+    if (v === undefined)
+        return '';
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=QueryBuilder.js.map

package/dist/firestore/components/QueryBuilder.js.map

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

package/dist/firestore/components/ReferencePicker.d.ts

@@ -0,0 +1,33 @@
+import type { CollectionReference, DocumentReference, Firestore } from 'pyric/firestore';
+export interface ReferencePickerProps {
+    firestore: Firestore;
+    /** Initial path text. */
+    initialPath?: string;
+    /**
+     * Lister for subcollections. Required — see
+     * `useReferencePicker` docs for the rationale.
+     */
+    listCollections: (firestore: Firestore, parent: DocumentReference | null) => Promise<CollectionReference[]>;
+    /** Fired when the user commits a picked reference (browse pick OR
+     *  a valid manually-typed path with the Commit button). */
+    onPick?: (ref: DocumentReference) => void;
+    /** Forwarded to the root. */
+    className?: string;
+    /** Label for the path text input. Default 'Document path'. */
+    pathLabel?: string;
+}
+/**
+ * Visible reference picker — text input + browseable panel.
+ *
+ * Two ways to commit a reference:
+ *
+ *   1. Type a path, then click Commit (enabled only when the path
+ *      parses to a valid `DocumentReference`).
+ *   2. Drill into a collection in the panel and click a document
+ *      row.
+ *
+ * Either path fires `onPick(ref)`. Headless — emits structural
+ * `data-pyric-*` for styling.
+ */
+export declare function ReferencePicker({ firestore, initialPath, listCollections, onPick, className, pathLabel, }: ReferencePickerProps): import("react").JSX.Element;
+//# sourceMappingURL=ReferencePicker.d.ts.map

package/dist/firestore/components/ReferencePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferencePicker.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/ReferencePicker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACV,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,EAAE,CACf,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,iBAAiB,GAAG,IAAI,KAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACpC;+DAC2D;IAC3D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC1C,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,WAAW,EACX,eAAe,EACf,MAAM,EACN,SAAS,EACT,SAA2B,GAC5B,EAAE,oBAAoB,+BA0DtB"}

package/dist/firestore/components/ReferencePicker.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { useReferencePicker, } from '../hooks/useReferencePicker.js';
+/**
+ * Visible reference picker — text input + browseable panel.
+ *
+ * Two ways to commit a reference:
+ *
+ *   1. Type a path, then click Commit (enabled only when the path
+ *      parses to a valid `DocumentReference`).
+ *   2. Drill into a collection in the panel and click a document
+ *      row.
+ *
+ * Either path fires `onPick(ref)`. Headless — emits structural
+ * `data-pyric-*` for styling.
+ */
+export function ReferencePicker({ firestore, initialPath, listCollections, onPick, className, pathLabel = 'Document path', }) {
+    const picker = useReferencePicker({ firestore, listCollections, initialPath });
+    const [browseOpen, setBrowseOpen] = useState(false);
+    return (_jsxs("div", { className: className, "data-pyric-ui": "reference-picker", children: [_jsxs("label", { "data-pyric-reference-path-label": true, children: [pathLabel, _jsx("input", { type: "text", value: picker.pathInput, onChange: (e) => picker.setPathInput(e.target.value), placeholder: "users/alice", "data-pyric-reference-path-input": true, "aria-invalid": picker.error ? 'true' : undefined })] }), picker.error ? (_jsx("span", { "data-pyric-error-message": true, children: picker.error })) : null, _jsxs("div", { "data-pyric-reference-actions": true, children: [_jsx("button", { type: "button", "data-pyric-reference-browse-toggle": true, "aria-expanded": browseOpen, onClick: () => setBrowseOpen((o) => !o), children: browseOpen ? 'Close browser' : 'Browse' }), _jsx("button", { type: "button", "data-pyric-reference-commit": true, disabled: !picker.reference, onClick: () => {
+                            if (picker.reference)
+                                onPick?.(picker.reference);
+                        }, children: "Commit" })] }), browseOpen ? (_jsx(BrowsePanel, { browseLocation: picker.browseLocation, canDrillBack: picker.canDrillBack, collections: picker.collections, documents: picker.documents, isLoading: picker.isLoading, drillIntoCollection: picker.drillIntoCollection, drillIntoDocument: picker.drillIntoDocument, drillBack: picker.drillBack, onPick: (ref) => {
+                    picker.pick(ref);
+                    onPick?.(ref);
+                } })) : null] }));
+}
+function BrowsePanel({ browseLocation, canDrillBack, collections, documents, isLoading, drillIntoCollection, drillIntoDocument, drillBack, onPick, }) {
+    const here = describeLocation(browseLocation);
+    return (_jsxs("div", { "data-pyric-ui": "reference-browse-panel", "data-pyric-loading": isLoading ? '' : undefined, children: [_jsxs("div", { "data-pyric-browse-header": true, children: [_jsx("button", { type: "button", "data-pyric-browse-back": true, onClick: drillBack, disabled: !canDrillBack, "aria-label": "Back", children: "\u2190" }), _jsx("span", { "data-pyric-browse-location": true, children: here })] }), browseLocation.kind === 'root' || browseLocation.kind === 'document' ? (_jsx("ul", { "data-pyric-browse-collections": true, children: collections.map((c) => (_jsx("li", { "data-pyric-browse-entry": true, "data-pyric-entry-kind": "collection", "data-pyric-collection-id": c.id, children: _jsxs("button", { type: "button", onClick: () => drillIntoCollection(c), "data-pyric-browse-select": true, children: [c.id, "/"] }) }, c.path))) })) : (_jsx("ul", { "data-pyric-browse-documents": true, children: documents.map((d) => {
+                    const ref = d.ref;
+                    return (_jsxs("li", { "data-pyric-browse-entry": true, "data-pyric-entry-kind": "document", "data-pyric-document-id": d.id, children: [_jsx("button", { type: "button", onClick: () => onPick(ref), "data-pyric-browse-pick": true, children: d.id }), _jsx("button", { type: "button", onClick: () => drillIntoDocument(ref), "data-pyric-browse-drill": true, "aria-label": "Drill into subcollections", children: "\u2192" })] }, ref.path));
+                }) }))] }));
+}
+function describeLocation(loc) {
+    if (loc.kind === 'root')
+        return '/';
+    if (loc.kind === 'document')
+        return `/${loc.ref.path}`;
+    return `/${loc.ref.path}`;
+}
+//# sourceMappingURL=ReferencePicker.js.map

package/dist/firestore/components/ReferencePicker.js.map

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

package/dist/firestore/components/TreeEntry.d.ts

@@ -0,0 +1,15 @@
+import type { FieldEditorRegistry } from '../fieldEditors/types.js';
+/**
+ * One row of the read-only value tree. A scalar renders `key: value` inline; a
+ * map/array renders a disclosure chevron + key that toggles its nested tree
+ * (collapsible, default expanded). Shared by the map + array displays so both
+ * lists and objects get the same chevron behavior.
+ */
+export declare function TreeEntry({ label, value, path, fieldEditors, kind, }: {
+    label: string;
+    value: unknown;
+    path: string;
+    fieldEditors: FieldEditorRegistry;
+    kind: 'key' | 'index';
+}): import("react").JSX.Element;
+//# sourceMappingURL=TreeEntry.d.ts.map

package/dist/firestore/components/TreeEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeEntry.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/TreeEntry.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,GACL,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,mBAAmB,CAAC;IAClC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;CACvB,+BAkCA"}

package/dist/firestore/components/TreeEntry.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { inferType } from '../types.js';
+import { FieldRenderer } from './FieldRenderer.js';
+/**
+ * One row of the read-only value tree. A scalar renders `key: value` inline; a
+ * map/array renders a disclosure chevron + key that toggles its nested tree
+ * (collapsible, default expanded). Shared by the map + array displays so both
+ * lists and objects get the same chevron behavior.
+ */
+export function TreeEntry({ label, value, path, fieldEditors, kind, }) {
+    const type = inferType(value);
+    const nested = type === 'map' || type === 'array';
+    const [expanded, setExpanded] = useState(true);
+    const labelAttr = kind === 'key' ? { 'data-pyric-tree-key': '' } : { 'data-pyric-tree-index': '' };
+    // Stable targeting hook for the entry (map key / array index).
+    const entryAttr = kind === 'key' ? { 'data-field-name': label } : { 'data-field-index': label };
+    if (!nested) {
+        return (_jsxs("li", { "data-pyric-tree-entry": true, ...entryAttr, children: [_jsx("span", { "data-pyric-tree-chevron": true, "data-pyric-tree-chevron-empty": true, "aria-hidden": "true" }), _jsx("span", { ...labelAttr, children: label }), _jsx(FieldRenderer, { value: value, path: path, fieldEditors: fieldEditors })] }));
+    }
+    return (_jsxs("li", { "data-pyric-tree-entry": true, "data-pyric-tree-nested": true, ...entryAttr, children: [_jsxs("button", { type: "button", "data-pyric-tree-toggle": true, "aria-expanded": expanded, onClick: () => setExpanded((e) => !e), children: [_jsx("span", { "data-pyric-tree-chevron": true, "aria-hidden": "true", children: "\u203A" }), _jsx("span", { ...labelAttr, children: label })] }), expanded ? _jsx(FieldRenderer, { value: value, path: path, fieldEditors: fieldEditors }) : null] }));
+}
+//# sourceMappingURL=TreeEntry.js.map

package/dist/firestore/components/TreeEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeEntry.js","sourceRoot":"","sources":["../../../src/firestore/components/TreeEntry.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,IAAI,GAOL;IACC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO,CAAC;IAClD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,EAAE,EAAE,CAAC;IACnG,+DAA+D;IAC/D,MAAM,SAAS,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;IAEhG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CACL,gDAA8B,SAAS,aACrC,sGAAwE,MAAM,GAAG,EACjF,kBAAU,SAAS,YAAG,KAAK,GAAQ,EACnC,KAAC,aAAa,IAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,GAAI,IACpE,CACN,CAAC;IACJ,CAAC;IAED,OAAO,CACL,gFAAqD,SAAS,aAC5D,kBACE,IAAI,EAAC,QAAQ,mDAEE,QAAQ,EACvB,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAErC,+DAA0C,MAAM,uBAEzC,EACP,kBAAU,SAAS,YAAG,KAAK,GAAQ,IAC5B,EACR,QAAQ,CAAC,CAAC,CAAC,KAAC,aAAa,IAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,IACvF,CACN,CAAC;AACJ,CAAC"}

package/dist/firestore/components/context.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentReference } from 'pyric/firestore';
+/**
+ * Cross-cutting display context threaded into individual field
+ * editors. Today it carries:
+ *
+ *   - `onReferenceClick` — fires when the reference Display
+ *     component is activated. Consumers wire navigation here.
+ *
+ * Read by the per-type Display components via `useDisplayContext`.
+ * Set by `<DocumentPreview>`'s wrapper. Editors that don't need it
+ * (string, number, …) simply ignore the context.
+ */
+export interface DisplayContextValue {
+    onReferenceClick?: (ref: DocumentReference) => void;
+}
+export declare const DisplayContextProvider: import("react").Provider<DisplayContextValue>;
+export declare function useDisplayContext(): DisplayContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/firestore/components/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACrD;AAID,eAAO,MAAM,sBAAsB,+CAAe,CAAC;AAEnD,wBAAgB,iBAAiB,IAAI,mBAAmB,CAEvD"}

package/dist/firestore/components/context.js

@@ -0,0 +1,7 @@
+import { createContext, useContext } from 'react';
+const Ctx = createContext({});
+export const DisplayContextProvider = Ctx.Provider;
+export function useDisplayContext() {
+    return useContext(Ctx);
+}
+//# sourceMappingURL=context.js.map

package/dist/firestore/components/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/firestore/components/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAkBlD,MAAM,GAAG,GAAG,aAAa,CAAsB,EAAE,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC,QAAQ,CAAC;AAEnD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { FieldEditorContract } from './types.js';
+export declare const arrayEditor: FieldEditorContract<unknown[]>;
+//# sourceMappingURL=array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/array.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AAyBzE,eAAO,MAAM,WAAW,EAAE,mBAAmB,CAAC,OAAO,EAAE,CAGtD,CAAC"}

package/dist/firestore/fieldEditors/array.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { TreeEntry } from '../components/TreeEntry.js';
+/**
+ * Read-only array renderer as an indented tree: each element is `index value`
+ * inline for scalars, or a collapsible disclosure (chevron + index) whose
+ * nested tree indents below for maps/arrays (so arrays-of-maps render through
+ * the same recursion). {@link TreeEntry} owns the collapse state + chevron.
+ */
+function ArrayDisplay({ value, path, fieldEditors }) {
+    return (_jsx("ul", { "data-pyric-field-type": "array", "data-pyric-tree": true, "data-pyric-field-path": path, children: value.map((item, i) => (_jsx(TreeEntry, { label: String(i), value: item, path: path ? `${path}[${i}]` : `[${i}]`, fieldEditors: fieldEditors ?? {}, kind: "index" }, i))) }));
+}
+export const arrayEditor = {
+    type: 'array',
+    Display: ArrayDisplay,
+};
+//# sourceMappingURL=array.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/firestore/fieldEditors/array.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD;;;;;GAKG;AACH,SAAS,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAgC;IAC/E,OAAO,CACL,sCAA0B,OAAO,oDAAwC,IAAI,YAC1E,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CACtB,KAAC,SAAS,IAER,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAChB,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EACvC,YAAY,EAAE,YAAY,IAAI,EAAE,EAChC,IAAI,EAAC,OAAO,IALP,CAAC,CAMN,CACH,CAAC,GACC,CACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAmC;IACzD,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,YAAY;CACtB,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { FieldEditorContract } from './types.js';
+export declare const booleanEditor: FieldEditorContract<boolean>;
+//# sourceMappingURL=boolean.d.ts.map