@pyric/ui 0.1.0-alpha.7

package/dist/firestore/components/DocumentEditor.js

@@ -0,0 +1,176 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useRef } from 'react';
+import { useDocumentEditor } from '../hooks/useDocumentEditor.js';
+import { mergeFieldEditors } from '../fieldEditors/registry.js';
+import { useContainerSize } from '../../primitives/hooks/useContainerSize.js';
+const Ctx = createContext(null);
+function useEditorContext() {
+    const ctx = useContext(Ctx);
+    if (!ctx) {
+        throw new Error('DocumentEditor.* components must render inside <DocumentEditor.Root>');
+    }
+    return ctx;
+}
+/**
+ * Wires the `useDocumentEditor` hook + field-editor registry into a
+ * React context so `<DocumentEditor.Fields>` and `<DocumentEditor.AddField>`
+ * can render the tree without prop drilling.
+ *
+ * Pattern: hook + compound component. Consumers wanting full control
+ * over the layout call `useDocumentEditor` directly and render their
+ * own tree; consumers wanting the default rendering use this.
+ */
+export function DocumentEditorRoot({ initial, fieldEditors, onChange, children, className, }) {
+    const editor = useDocumentEditor({ initial });
+    const registry = mergeFieldEditors(fieldEditors);
+    // Hold the latest onChange in a ref so the effect's deps don't
+    // include the callback — avoids re-firing onChange on every parent
+    // re-render that produces a new function identity.
+    const onChangeRef = useRef(onChange);
+    onChangeRef.current = onChange;
+    useEffect(() => {
+        onChangeRef.current?.(editor);
+    }, [editor]);
+    const { ref: rootRef, size } = useContainerSize();
+    return (_jsx(Ctx.Provider, { value: { editor, fieldEditors: registry }, children: _jsx("div", { ref: rootRef, className: className, "data-pyric-ui": "document-editor", "data-pyric-is-valid": editor.isValid ? '' : undefined, "data-pyric-is-dirty": editor.isDirty ? '' : undefined, "data-size": size, children: children }) }));
+}
+/** Read access to the underlying editor state from inside a Root. */
+export function useDocumentEditorContext() {
+    return useEditorContext().editor;
+}
+/**
+ * Renders the top-level fields of the document. For finer control,
+ * a consumer can call `useDocumentEditorContext()` and render the
+ * tree themselves.
+ */
+export function DocumentEditorFields() {
+    const { editor } = useEditorContext();
+    // Stable INSERTION order, never re-sorted by the (currently being
+    // typed) key — `childIds` already preserves the order fields were
+    // added in, which is exactly what must stay stable while a row's
+    // name is edited. Sorting here was the cause of rows visibly
+    // reordering mid-keystroke.
+    const rootChildren = editor.tree.childIds[editor.tree.rootId] ?? [];
+    return (_jsxs("div", { "data-pyric-editor-fields": true, children: [rootChildren.map((id) => (_jsx(Field, { nodeId: id, path: fieldPath(editor, id) }, id))), _jsx(AddMapEntry, { parentId: editor.tree.rootId })] }));
+}
+function fieldPath(editor, nodeId) {
+    const segments = [];
+    let current = editor.tree.nodes[nodeId];
+    while (current && current.parentId != null) {
+        const parent = editor.tree.nodes[current.parentId];
+        if (!parent)
+            break;
+        if (parent.type === 'array') {
+            const idx = (editor.tree.childIds[parent.id] ?? []).indexOf(current.id);
+            segments.unshift(`[${idx}]`);
+        }
+        else {
+            segments.unshift(current.key ?? '');
+        }
+        current = parent;
+    }
+    // Join — array index segments don't take a leading dot.
+    return segments.reduce((acc, seg) => {
+        if (seg.startsWith('['))
+            return `${acc}${seg}`;
+        return acc ? `${acc}.${seg}` : seg;
+    }, '');
+}
+function Field({ nodeId, path }) {
+    const { editor, fieldEditors } = useEditorContext();
+    const node = editor.tree.nodes[nodeId];
+    if (!node)
+        return null;
+    if (node.type === 'map') {
+        return _jsx(MapField, { node: node, path: path });
+    }
+    if (node.type === 'array') {
+        return _jsx(ArrayField, { node: node, path: path });
+    }
+    const contract = fieldEditors[node.type];
+    const EditComponent = contract?.Edit;
+    if (!EditComponent)
+        return null;
+    // Errors are computed on every keystroke (so Save can gate on
+    // `isValid`), but only DISPLAYED once the field has been touched
+    // (blurred) or a submit attempt swept the tree — otherwise a
+    // freshly-added empty row would show "required" before the user
+    // has typed anything.
+    const showError = node.touched ? node.error : undefined;
+    return (_jsxs("div", { "data-pyric-field-entry": true, "data-field-name": node.key ?? undefined, "data-pyric-error": showError ? '' : undefined, onBlur: () => editor.touch(node.id), children: [_jsx(FieldChrome, { node: node, path: path }), _jsx(EditComponent, { value: node.value, path: path, error: showError, onChange: (v) => editor.setValue(node.id, v) })] }));
+}
+/**
+ * Per-field chrome: the field's key input (for map children), the
+ * type selector, and the remove button. Inline at every non-root
+ * node so consumers can hide individual pieces via `data-*` CSS.
+ */
+function FieldChrome({ node, path }) {
+    const { editor } = useEditorContext();
+    const parent = node.parentId != null ? editor.tree.nodes[node.parentId] : null;
+    const inMap = parent?.type === 'map';
+    const isRoot = node.id === editor.tree.rootId;
+    if (isRoot)
+        return null;
+    return (_jsxs("div", { "data-pyric-field-chrome": true, "data-pyric-field-path": path, children: [inMap ? (_jsx("input", { type: "text", value: node.key ?? '', onChange: (e) => editor.setKey(node.id, e.target.value), "aria-label": "Field name", "data-pyric-field-key-input": true, "aria-invalid": node.touched && node.error ? 'true' : undefined })) : null, _jsx(TypeSelect, { node: node }), _jsx("button", { type: "button", onClick: () => editor.remove(node.id), "data-pyric-remove": true, "aria-label": "Remove field", children: "\u00D7" })] }));
+}
+const ALL_TYPES = [
+    'string',
+    'number',
+    'boolean',
+    'null',
+    'timestamp',
+    'geopoint',
+    'reference',
+    'bytes',
+    'vector',
+    'map',
+    'array',
+];
+function TypeSelect({ node }) {
+    const { editor } = useEditorContext();
+    const parent = node.parentId != null ? editor.tree.nodes[node.parentId] : null;
+    // Firestore disallows nested arrays — filter that option out
+    // when the parent is an array.
+    const options = ALL_TYPES.filter((t) => !(parent?.type === 'array' && t === 'array'));
+    return (_jsx("select", { value: node.type, onChange: (e) => editor.setType(node.id, e.target.value), "aria-label": "Field type", "data-pyric-field-type-select": true, children: options.map((t) => (_jsx("option", { value: t, children: t }, t))) }));
+}
+function MapField({ node, path }) {
+    const { editor } = useEditorContext();
+    // Stable insertion order — same rationale as `DocumentEditorFields`.
+    const children = editor.tree.childIds[node.id] ?? [];
+    return (_jsxs("div", { "data-pyric-field-entry": true, "data-pyric-field-type": "map", "data-field-name": node.key ?? undefined, children: [node.id !== editor.tree.rootId ? _jsx(FieldChrome, { node: node, path: path }) : null, _jsx("div", { "data-pyric-map-children": true, children: children.map((childId) => {
+                    const child = editor.tree.nodes[childId];
+                    if (!child)
+                        return null;
+                    const childPath = path ? `${path}.${child.key ?? ''}` : child.key ?? '';
+                    return _jsx(Field, { nodeId: childId, path: childPath }, childId);
+                }) }), _jsx(AddMapEntry, { parentId: node.id })] }));
+}
+function ArrayField({ node, path }) {
+    const { editor } = useEditorContext();
+    const children = editor.tree.childIds[node.id] ?? [];
+    return (_jsxs("div", { "data-pyric-field-entry": true, "data-pyric-field-type": "array", "data-field-name": node.key ?? undefined, children: [_jsx(FieldChrome, { node: node, path: path }), _jsx("ol", { "data-pyric-array-children": true, children: children.map((childId, idx) => {
+                    const childPath = path ? `${path}[${idx}]` : `[${idx}]`;
+                    return (_jsx("li", { "data-field-index": String(idx), children: _jsx(Field, { nodeId: childId, path: childPath }) }, childId));
+                }) }), _jsx(AddArrayEntry, { parentId: node.id })] }));
+}
+function AddMapEntry({ parentId }) {
+    const { editor } = useEditorContext();
+    return (_jsx("button", { type: "button", "data-pyric-add-map-entry": true, onClick: () => editor.addMapEntry(parentId, '', 'string'), children: "+ Add field" }));
+}
+function AddArrayEntry({ parentId }) {
+    const { editor } = useEditorContext();
+    return (_jsx("button", { type: "button", "data-pyric-add-array-entry": true, onClick: () => editor.addArrayEntry(parentId, 'string'), children: "+ Add item" }));
+}
+/**
+ * Compound root export. Consumers pattern-match via dot access:
+ *
+ *   <DocumentEditor.Root initial={data} onChange={…}>
+ *     <DocumentEditor.Fields />
+ *   </DocumentEditor.Root>
+ */
+export const DocumentEditor = {
+    Root: DocumentEditorRoot,
+    Fields: DocumentEditorFields,
+};
+//# sourceMappingURL=DocumentEditor.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { ReactNode } from 'react';
+import type { DocumentReference, QueryDocumentSnapshot } from 'pyric/firestore';
+export interface DocumentListProps {
+    documents: QueryDocumentSnapshot[];
+    isLoading?: boolean;
+    error?: Error;
+    hasMore?: boolean;
+    onSelect?: (ref: DocumentReference) => void;
+    /** Fired when the user requests another page. Wire to the hook's
+     *  `loadMore`. The component will not render a Load More button
+     *  when this is undefined. */
+    onLoadMore?: () => void;
+    /**
+     * Optional renderer for the row label. Default renders the doc id.
+     * Override to show a field value alongside, an icon, etc.
+     */
+    renderLabel?: (doc: QueryDocumentSnapshot) => ReactNode;
+    /**
+     * Optional per-row action(s), rendered as a SIBLING of the row's
+     * select button inside the entry (not nested in it — so the action
+     * carries its own click handling without an invalid button-in-button).
+     * Used for row-level affordances like delete.
+     */
+    renderRowAction?: (doc: QueryDocumentSnapshot) => ReactNode;
+    emptyState?: ReactNode;
+    className?: string;
+    /**
+     * Above this row count, the list switches to virtualization via
+     * `<VirtualList>`. Default 100. Set to `Infinity` to disable
+     * (e.g. when measuring layout shifts is more important than
+     * scroll perf).
+     */
+    virtualizeThreshold?: number;
+    /**
+     * Estimated row height when virtualizing. Default 36 — matches
+     * a single-line text button at 13px font + ~10px padding. Pass
+     * a function for variable sizing (TanStack measures the actual
+     * height via ResizeObserver after the first paint anyway).
+     */
+    rowHeight?: number | ((index: number) => number);
+    /**
+     * Pixel height the virtualized scroll container fills. Only
+     * applies when `documents.length > virtualizeThreshold`. Default
+     * `'60vh'` — consumers usually constrain via their layout.
+     */
+    virtualizedHeight?: number | string;
+}
+/**
+ * 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 declare function DocumentList({ documents, isLoading, error, hasMore, onSelect, onLoadMore, renderLabel, renderRowAction, emptyState, className, virtualizeThreshold, rowHeight, virtualizedHeight, }: DocumentListProps): import("react").JSX.Element;
+//# sourceMappingURL=DocumentList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentList.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/DocumentList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAahF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5C;;kCAE8B;IAC9B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,SAAS,CAAC;IACxD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,SAAS,CAAC;IAC5D,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACjD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,SAAS,EACT,mBAAyB,EACzB,SAAc,EACd,iBAA0B,GAC3B,EAAE,iBAAiB,+BAmGnB"}

package/dist/firestore/components/DocumentList.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { VirtualList } from '../../primitives/VirtualList.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, virtualizeThreshold = 100, rowHeight = 36, virtualizedHeight = '60vh', }) {
+    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) => (_jsxs("div", { "data-pyric-document-entry": true, "data-pyric-document-id": doc.id, children: [_jsx("button", { type: "button", onClick: () => onSelect?.(snapshotRef(doc)), "data-pyric-document-select": true, 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);
+                    return (_jsxs("li", { "data-pyric-document-entry": true, "data-pyric-document-id": doc.id, children: [_jsx("button", { type: "button", onClick: () => onSelect?.(ref), "data-pyric-document-select": true, 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