@pyric/ui 0.1.0-alpha.10

package/dist/events/types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * The events/activity domain types. These are a local, structurally-
+ * compatible mirror of `pyric`'s unified `SandboxEvent` union (and its
+ * `EventProvenance`) — the `@pyric/ui` packages never import `pyric` so
+ * the headless layer stays decoupled from the sandbox impl (the same
+ * stance the sibling `traffic/` area takes with `RequestEvent`).
+ *
+ * `sandbox.onEvent` / `sandbox.history()` are assignable as an
+ * `ActivitySource` / `ActivityEvent[]` with zero adapter code: every
+ * field here is a subset (by name + shape) of the matching field on the
+ * sandbox type. A production audit feed satisfying the same shape works
+ * too.
+ *
+ * Unlike `traffic/` (which models only Firestore `request` events, one
+ * row per evaluated op), the events area aggregates the FULL stream —
+ * Firestore `request`/`write` plus the cross-service `service_mutation`
+ * envelope (auth / storage / rtdb) — into category bands. So the local
+ * types cover the union members the digest reads, not just one kind.
+ */
+/** Which sandbox service emitted an event. Absent ⇒ `'firestore'`. */
+export type ActivityService = 'firestore' | 'auth' | 'storage' | 'rtdb';
+/** Who initiated the op behind an event. Absent ⇒ the served app. */
+export type ActivityActor = {
+    kind: 'app';
+} | {
+    kind: 'studio';
+} | {
+    kind: 'agent';
+    name: string;
+} | {
+    kind: 'app-builder';
+};
+/**
+ * The auth lens an op ran under. `admin` bypasses rules, `as` evaluates
+ * rules as a specific uid (impersonation), `app-session` is the app's
+ * own signed-in user. Absent ⇒ `app-session`.
+ */
+export type ActivityLens = {
+    mode: 'admin';
+} | {
+    mode: 'as';
+    uid: string;
+} | {
+    mode: 'app-session';
+};
+/** Identity in effect for an op. `null` is anonymous / signed out. */
+export interface ActivityAuthState {
+    uid: string;
+    token?: Record<string, unknown>;
+}
+/**
+ * Provenance carried by every event. All optional + additive — pre-
+ * provenance emitters omit them (read as firestore / app / app-session).
+ */
+export interface ActivityProvenance {
+    service?: ActivityService;
+    actor?: ActivityActor;
+    authLens?: ActivityLens;
+    /** Set when the op is part of an agent plan (dry-run / accept). */
+    planId?: string;
+}
+/** Firestore op outcome — present on `request` events only. */
+export type ActivityResult = 'allow' | 'deny' | 'unsupported';
+/**
+ * A Firestore `request` event — one per evaluated op. The digest reads
+ * these for denials (`result === 'deny'`) and, when no `write` event is
+ * present, for the allow trail. Structurally a subset of `RequestEvent`.
+ */
+export interface ActivityRequestEvent extends ActivityProvenance {
+    kind: 'request';
+    id: string;
+    at: number;
+    method: 'get' | 'list' | 'create' | 'update' | 'set' | 'delete';
+    path: string;
+    auth: ActivityAuthState | null;
+    result: ActivityResult;
+    /** Simulator debug trail. Used to surface the deciding rule on denials. */
+    reasons: string[];
+    request?: {
+        resourceData?: Record<string, unknown>;
+    };
+    resourceBefore?: {
+        data: Record<string, unknown> | null;
+        exists: boolean;
+    };
+    resourceAfter?: {
+        data: Record<string, unknown> | null;
+        exists: boolean;
+    };
+    matchedRule?: {
+        ruleIndex: number;
+        operations: string[];
+    };
+    origin: 'user' | 'listener' | 'transaction' | 'batch';
+    groupId?: string;
+    triggeredBy?: {
+        method: string;
+        path: string;
+    };
+}
+/**
+ * A committed Firestore write — `create`/`update`/`set`/`delete` that
+ * the rule engine allowed and the keyspace applied. The digest leads
+ * with these for the added/updated/removed bands (richer than `request`:
+ * carries prior/next state for the change summary). Subset of
+ * `WriteSandboxEvent`.
+ */
+export interface ActivityWriteEvent extends ActivityProvenance {
+    kind: 'write';
+    id: string;
+    at: number;
+    method: 'create' | 'update' | 'set' | 'delete';
+    path: string;
+    auth: ActivityAuthState | null;
+    data?: Record<string, unknown>;
+    priorState: Record<string, unknown> | null;
+    nextState: Record<string, unknown> | null;
+    groupId?: string;
+}
+/**
+ * Cross-service mutation — the unified envelope auth / storage / rtdb
+ * emit. The digest maps `service` + `op` to a band (signed-in, added,
+ * updated, removed, …). Subset of `ServiceMutationEvent`.
+ */
+export interface ActivityServiceMutationEvent extends ActivityProvenance {
+    kind: 'service_mutation';
+    id: string;
+    at: number;
+    service: 'auth' | 'storage' | 'rtdb';
+    op: string;
+    path?: string;
+    auth: ActivityAuthState | null;
+    before?: unknown;
+    after?: unknown;
+    detail?: Record<string, unknown>;
+}
+/**
+ * The union members the activity digest aggregates. This is a SUBSET of
+ * `pyric`'s `SandboxEvent` — the listener-lifecycle / snapshot-delivery /
+ * session-boundary kinds carry no user-visible mutation, so the digest
+ * ignores them. The reducer accepts any object with a `kind` and skips
+ * the kinds it doesn't model, so a full `SandboxEvent[]` passes through
+ * cleanly (the extra kinds fall into the "unknown ⇒ skipped" branch).
+ */
+export type ActivityEvent = ActivityRequestEvent | ActivityWriteEvent | ActivityServiceMutationEvent;
+/**
+ * The widened input the reducer accepts: any `ActivityEvent`, plus a
+ * permissive escape for unmodelled `SandboxEvent` kinds carrying a
+ * string `kind` (skipped). Lets `sandbox.history()` flow in unfiltered.
+ */
+export type AnyActivityEvent = ActivityEvent | {
+    kind: string;
+    [k: string]: unknown;
+};
+/**
+ * A subscription: register a callback, get an unsubscribe.
+ * `sandbox.onEvent` matches this signature.
+ */
+export type ActivitySource = (cb: (event: AnyActivityEvent) => void) => () => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

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

package/dist/events/types.js

@@ -0,0 +1,21 @@
+/**
+ * The events/activity domain types. These are a local, structurally-
+ * compatible mirror of `pyric`'s unified `SandboxEvent` union (and its
+ * `EventProvenance`) — the `@pyric/ui` packages never import `pyric` so
+ * the headless layer stays decoupled from the sandbox impl (the same
+ * stance the sibling `traffic/` area takes with `RequestEvent`).
+ *
+ * `sandbox.onEvent` / `sandbox.history()` are assignable as an
+ * `ActivitySource` / `ActivityEvent[]` with zero adapter code: every
+ * field here is a subset (by name + shape) of the matching field on the
+ * sandbox type. A production audit feed satisfying the same shape works
+ * too.
+ *
+ * Unlike `traffic/` (which models only Firestore `request` events, one
+ * row per evaluated op), the events area aggregates the FULL stream —
+ * Firestore `request`/`write` plus the cross-service `service_mutation`
+ * envelope (auth / storage / rtdb) — into category bands. So the local
+ * types cover the union members the digest reads, not just one kind.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

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

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

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import type { CollectionReference } from 'pyric/firestore';
+export interface CollectionListProps {
+    collections: CollectionReference[];
+    isLoading?: boolean;
+    error?: Error;
+    /** Fired when a list item is clicked. Consumer wires navigation. */
+    onSelect?: (collection: CollectionReference) => void;
+    /** Optional empty-state node. Rendered when `collections.length`
+     *  is 0 and the list isn't loading. */
+    emptyState?: ReactNode;
+    className?: string;
+}
+/**
+ * Headless collection list. Takes a pre-fetched array of references
+ * (from `useCollectionList`) plus a select callback. Renders one
+ * row per collection with `data-pyric-collection-id` for styling
+ * and testing. The library does not own the data fetch — the hook
+ * does — so this component is a thin presentational layer.
+ */
+export declare function CollectionList({ collections, isLoading, error, onSelect, emptyState, className, }: CollectionListProps): import("react").JSX.Element;
+//# sourceMappingURL=CollectionList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionList.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/CollectionList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD;2CACuC;IACvC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,EACR,UAAU,EACV,SAAS,GACV,EAAE,mBAAmB,+BAgDrB"}

package/dist/firestore/components/CollectionList.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Headless collection list. Takes a pre-fetched array of references
+ * (from `useCollectionList`) plus a select callback. Renders one
+ * row per collection with `data-pyric-collection-id` for styling
+ * and testing. The library does not own the data fetch — the hook
+ * does — so this component is a thin presentational layer.
+ */
+export function CollectionList({ collections, isLoading, error, onSelect, emptyState, className, }) {
+    if (error) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "collection-list", "data-pyric-error": "", role: "alert", children: error.message }));
+    }
+    if (isLoading && collections.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "collection-list", "data-pyric-loading": "" }));
+    }
+    if (collections.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "collection-list", "data-pyric-empty": "", children: emptyState }));
+    }
+    return (_jsx("ul", { className: className, "data-pyric-ui": "collection-list", children: collections.map((coll) => (_jsx("li", { "data-pyric-collection-entry": true, "data-pyric-collection-id": coll.id, children: _jsx("button", { type: "button", onClick: () => onSelect?.(coll), "data-pyric-collection-select": true, children: coll.id }) }, coll.path))) }));
+}
+//# sourceMappingURL=CollectionList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionList.js","sourceRoot":"","sources":["../../../src/firestore/components/CollectionList.tsx"],"names":[],"mappings":";AAeA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,EACR,UAAU,EACV,SAAS,GACW;IACpB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,cACE,SAAS,EAAE,SAAS,mBACN,iBAAiB,sBACd,EAAE,EACnB,IAAI,EAAC,OAAO,YAEX,KAAK,CAAC,OAAO,GACV,CACP,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,CACL,cACE,SAAS,EAAE,SAAS,mBACN,iBAAiB,wBACZ,EAAE,GACrB,CACH,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,mBAAgB,iBAAiB,sBAAkB,EAAE,YAC3E,UAAU,GACP,CACP,CAAC;IACJ,CAAC;IACD,OAAO,CACL,aAAI,SAAS,EAAE,SAAS,mBAAgB,iBAAiB,YACtD,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACzB,8EAG4B,IAAI,CAAC,EAAE,YAEjC,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,kDAG9B,IAAI,CAAC,EAAE,GACD,IAVJ,IAAI,CAAC,IAAI,CAWX,CACN,CAAC,GACC,CACN,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+import type { CollectionReference, DocumentReference } from 'pyric/firestore';
+import { type RecursiveDeleteImpl } from '../hooks/useRecursiveDelete.js';
+export interface DeleteWithConfirmProps {
+    /** The doc / collection to delete. */
+    target: DocumentReference | CollectionReference;
+    /** Implementation that walks the tree + deletes. Consumer-supplied.
+     *  Sandbox-backed apps usually wire `pyric/sandbox` introspection;
+     *  production apps usually call a Cloud Function. */
+    impl: RecursiveDeleteImpl;
+    /** Confirm-dialog title. Defaults to a sensible derivation from
+     *  the target's path. */
+    title?: string;
+    /** Confirm-dialog body. */
+    body?: ReactNode;
+    /** Label on the destructive button. */
+    confirmLabel?: string;
+    /** Fired after the delete iterator finishes successfully. */
+    onDeleted?: () => void;
+    /** Optional render override for the trigger button. */
+    renderTrigger?: (props: {
+        onClick: () => void;
+        isRunning: boolean;
+        progress: number;
+    }) => ReactNode;
+    /** Class forwarded to the default trigger button. */
+    className?: string;
+}
+/**
+ * Composition that wires `useConfirm` + `useRecursiveDelete`. Requires
+ * a `<ConfirmProvider>` ancestor.
+ *
+ * The default trigger renders a plain `<button>` carrying the
+ * destructive intent (the consumer styles via `[data-pyric-destructive]`).
+ * Consumers wanting different chrome pass `renderTrigger`.
+ */
+export declare function DeleteWithConfirm({ target, impl, title, body, confirmLabel, onDeleted, renderTrigger, className, }: DeleteWithConfirmProps): import("react").JSX.Element;
+//# sourceMappingURL=DeleteWithConfirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteWithConfirm.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/DeleteWithConfirm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAChD;;yDAEqD;IACrD,IAAI,EAAE,mBAAmB,CAAC;IAC1B;6BACyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,SAAS,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,YAAuB,EACvB,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE,sBAAsB,+BAiCxB"}

package/dist/firestore/components/DeleteWithConfirm.js

@@ -0,0 +1,33 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useConfirm } from '../../primitives/useConfirm.js';
+import { useRecursiveDelete, } from '../hooks/useRecursiveDelete.js';
+/**
+ * Composition that wires `useConfirm` + `useRecursiveDelete`. Requires
+ * a `<ConfirmProvider>` ancestor.
+ *
+ * The default trigger renders a plain `<button>` carrying the
+ * destructive intent (the consumer styles via `[data-pyric-destructive]`).
+ * Consumers wanting different chrome pass `renderTrigger`.
+ */
+export function DeleteWithConfirm({ target, impl, title, body, confirmLabel = 'Delete', onDeleted, renderTrigger, className, }) {
+    const confirm = useConfirm();
+    const { delete: runDelete, isRunning, progress, error } = useRecursiveDelete(impl);
+    const handleClick = async () => {
+        const ok = await confirm({
+            title: title ?? `Delete ${target.path}?`,
+            body,
+            destructive: true,
+            confirmLabel,
+        });
+        if (!ok)
+            return;
+        await runDelete(target);
+        if (!error)
+            onDeleted?.();
+    };
+    if (renderTrigger) {
+        return _jsx(_Fragment, { children: renderTrigger({ onClick: handleClick, isRunning, progress }) });
+    }
+    return (_jsx("button", { type: "button", onClick: handleClick, className: className, disabled: isRunning, "data-pyric-ui": "delete-with-confirm", "data-pyric-destructive": "", "data-pyric-running": isRunning ? '' : undefined, children: isRunning ? `Deleting… (${progress})` : confirmLabel }));
+}
+//# sourceMappingURL=DeleteWithConfirm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteWithConfirm.js","sourceRoot":"","sources":["../../../src/firestore/components/DeleteWithConfirm.tsx"],"names":[],"mappings":";AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EACL,kBAAkB,GAEnB,MAAM,gCAAgC,CAAC;AA4BxC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,YAAY,GAAG,QAAQ,EACvB,SAAS,EACT,aAAa,EACb,SAAS,GACc;IACvB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEnF,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;QAC7B,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YACvB,KAAK,EAAE,KAAK,IAAI,UAAU,MAAM,CAAC,IAAI,GAAG;YACxC,IAAI;YACJ,WAAW,EAAE,IAAI;YACjB,YAAY;SACb,CAAC,CAAC;QACH,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK;YAAE,SAAS,EAAE,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,4BAAG,aAAa,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAI,CAAC;IAC7E,CAAC;IAED,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,SAAS,mBACL,qBAAqB,4BACZ,EAAE,wBACL,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,YAE7C,SAAS,CAAC,CAAC,CAAC,cAAc,QAAQ,GAAG,CAAC,CAAC,CAAC,YAAY,GAC9C,CACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,47 @@
+import { type ReactNode } from 'react';
+import { type UseDocumentEditorResult } from '../hooks/useDocumentEditor.js';
+import type { FieldEditorRegistry } from '../fieldEditors/types.js';
+export interface DocumentEditorRootProps {
+    /** Initial document data. Built into the editor's tree on first
+     *  mount; later changes don't rebuild — call `editor.reset()` to
+     *  re-initialize from a fresh `initial`. */
+    initial?: Record<string, unknown>;
+    /** Override or extend the built-in field editors. */
+    fieldEditors?: FieldEditorRegistry;
+    /** Called on every state change with the latest editor state. The
+     *  parent typically watches `state.isValid` + `state.isDirty` to
+     *  enable/disable a Save button. */
+    onChange?: (state: UseDocumentEditorResult) => void;
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * 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 declare function DocumentEditorRoot({ initial, fieldEditors, onChange, children, className, }: DocumentEditorRootProps): import("react").JSX.Element;
+/** Read access to the underlying editor state from inside a Root. */
+export declare function useDocumentEditorContext(): UseDocumentEditorResult;
+/**
+ * Renders the top-level fields of the document. For finer control,
+ * a consumer can call `useDocumentEditorContext()` and render the
+ * tree themselves.
+ */
+export declare function DocumentEditorFields(): import("react").JSX.Element;
+/**
+ * Compound root export. Consumers pattern-match via dot access:
+ *
+ *   <DocumentEditor.Root initial={data} onChange={…}>
+ *     <DocumentEditor.Fields />
+ *   </DocumentEditor.Root>
+ */
+export declare const DocumentEditor: {
+    Root: typeof DocumentEditorRoot;
+    Fields: typeof DocumentEditorFields;
+};
+//# sourceMappingURL=DocumentEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentEditor.d.ts","sourceRoot":"","sources":["../../../src/firestore/components/DocumentEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACrF,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAEhG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAsBpE,MAAM,WAAW,uBAAuB;IACtC;;gDAE4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,qDAAqD;IACrD,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;wCAEoC;IACpC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,+BA6BzB;AAED,qEAAqE;AACrE,wBAAgB,wBAAwB,IAAI,uBAAuB,CAElE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,gCAiBnC;AAkOD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;CAG1B,CAAC"}

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,63 @@
+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;
+    /** Stable collection/query identity used to reset update highlighting when
+     * the rendered list changes scope. */
+    updateScope?: 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, updateScope, 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,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAehF,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;0CACsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;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,WAA6B,EAC7B,mBAAyB,EACzB,SAAc,EACd,iBAA0B,GAC3B,EAAE,iBAAiB,+BA6HnB"}