npm - @pyric/cli - Versions diffs - 0.1.0-alpha.9 - Mend

@pyric/cli 0.1.0-alpha.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1169) hide show

package/dist/serve/docs-ui/docs/pyric-ui-firestore-reference-api/index.html ADDED Viewed

@@ -0,0 +1,2753 @@
+<!DOCTYPE html><html lang="en"> <head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>API reference: @pyric/ui/firestore · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/ui/firestore."><link rel="preconnect" href="https://fonts.googleapis.com"><link rel="preconnect" href="https://fonts.gstatic.com" crossorigin><link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet"><link rel="stylesheet" href="/__pyric/ui/_astro/_slug_.CQYSemvw.css"></head> <body>  <header class="studio__bar"> <div class="studio__bar-inner"> <a class="studio__brand" href="/__pyric/ui/" aria-label="Pyric Studio">Pyric</a> <nav class="studio__nav" aria-label="Studio tabs"> <a class="studio__nav-tab" href="/__pyric/ui/"> Home </a><a class="studio__nav-tab" href="/__pyric/ui/firestore"> Firestore </a><a class="studio__nav-tab" href="/__pyric/ui/auth"> Auth </a><a class="studio__nav-tab" href="/__pyric/ui/rtdb"> RTDB </a><a class="studio__nav-tab" href="/__pyric/ui/storage"> Storage </a><a class="studio__nav-tab" href="/__pyric/ui/traffic"> Traffic </a><a class="studio__nav-tab" href="/__pyric/ui/settings"> Settings </a><a class="studio__nav-tab" href="/__pyric/ui/docs" aria-current="page"> Docs </a> </nav> </div> </header> <div class="docs-shell">  <details class="docs-nav-drawer"> <summary>Navigate</summary> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div> <script type="module">let i=null;function d(t){return i||(i=fetch(t).then(e=>e.json())),i}function l(t,e){return t.title.toLowerCase().includes(e)||t.excerpt.toLowerCase().includes(e)?!0:t.headings.some(r=>r.text.toLowerCase().includes(e))}function u(t,e,r){if(e.innerHTML="",t.length===0){e.hidden=!1;{const n=document.createElement("li");n.className="docs-search-empty",n.textContent="No matches",e.appendChild(n)}return}e.hidden=!1;for(const n of t.slice(0,8)){const s=document.createElement("li"),c=document.createElement("a");c.href=n.path;const o=document.createElement("span");o.className="docs-search-result-title",o.textContent=n.title;const a=document.createElement("span");a.className="docs-search-result-meta",a.textContent=[n.group,n.section].filter(Boolean).join(" / "),c.append(o,a),s.appendChild(c),e.appendChild(s)}}document.querySelectorAll(".docs-search").forEach(t=>{const e=t.dataset.indexUrl,r=t.querySelector(".docs-search-input"),n=t.querySelector(".docs-search-results");r.addEventListener("input",async()=>{const s=r.value.trim().toLowerCase();if(!s){n.hidden=!0,n.innerHTML="";return}const{pages:c}=await d(e);r.value.trim().toLowerCase()===s&&u(c.filter(o=>l(o,s)),n)}),r.addEventListener("focus",()=>{d(e),n.childElementCount>0&&(n.hidden=!1)}),r.addEventListener("keydown",s=>{s.key==="Escape"&&(r.value="",n.hidden=!0,n.innerHTML="",r.blur())}),r.addEventListener("blur",()=>{window.setTimeout(()=>{n.hidden=!0},150)})});document.addEventListener("keydown",t=>{if(!(t.metaKey||t.ctrlKey)||t.key.toLowerCase()!=="k")return;const e=[...document.querySelectorAll(".docs-search-input")].find(r=>r.offsetParent!==null);e&&(t.preventDefault(),e.focus(),e.select())});</script> <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/"> Overview </a><details class="docs-nav-group"> <summary>Run locally</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/how-the-swap-works/"> How the swap works </a> </li><li> <a href="/__pyric/ui/docs/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Develop with Firebase APIs</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/sign-in-and-manage-users/"> Sign in and manage users </a> </li><li> <a href="/__pyric/ui/docs/store-and-query-data/"> Store and query data </a> </li><li> <a href="/__pyric/ui/docs/sync-realtime-data/"> Sync realtime data </a> </li><li> <a href="/__pyric/ui/docs/store-files/"> Store files </a> </li><li> <a href="/__pyric/ui/docs/receive-messages/"> Receive messages </a> </li><li> <a href="/__pyric/ui/docs/run-ai-logic-locally/"> Run AI Logic locally </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-how-to-run-rtdb-onvaluecreated/"> Run an RTDB function locally </a> </li><li> <a href="/__pyric/ui/docs/which-data-service/"> Which data service? </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Inspect and correct</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <h2 class="docs-nav-heading"> Inspect the sandbox </h2> <ul> <li> <a href="/__pyric/ui/docs/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/shape-your-data/"> Seed, snapshot, replay </a> </li><li> <a href="/__pyric/ui/docs/watch-and-review/"> Review agent activity </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading"> Correct Security Rules </h2> <ul> <li> <a href="/__pyric/ui/docs/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/rules-patterns/"> Rules patterns </a> </li><li> <a href="/__pyric/ui/docs/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/whats-possible/"> Case studies </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading"> Work with an agent </h2> <ul> <li> <a href="/__pyric/ui/docs/what-your-agent-can-do/"> Work through an agent </a> </li><li> <a href="/__pyric/ui/docs/skills/"> Agent skills </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Verify the boundary</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-how-to-verify-against-a-captured-session/"> Verify a captured session </a> </li><li> <a href="/__pyric/ui/docs/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Ship unchanged</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/set-up-the-project/"> Set up the Firebase project </a> </li> </ul> </div> </div> </details><details class="docs-nav-group"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/how-we-know-it-matches-firebase/"> Conformance </a> </li><li> <a href="/__pyric/ui/docs/whats-experimental/"> What&#39;s experimental </a> </li><li> <a href="/__pyric/ui/docs/pyric-conformance-scores/"> Conformance scores </a> </li><li> <a href="/__pyric/ui/docs/pyric-app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-compat/"> Rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-functions-rtdb-compat/"> Functions · RTDB </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" open> <summary>Reference</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli/"> @pyric/cli </a> </li><li> <a href="/__pyric/ui/docs/pyric-explanation-versioning-and-compatibility/"> pyric </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore/"> pyric / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules/"> pyric / rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox/"> pyric / sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage/"> pyric / storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth/"> pyric / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database/"> pyric / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-app/"> pyric-admin / app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore/"> pyric-admin / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth/"> pyric-admin / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database/"> pyric-admin / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage/"> pyric-admin / storage </a> </li><li> <a href="/__pyric/ui/docs/ui/"> @pyric/ui </a> </li><li> <a href="/__pyric/ui/docs/api-reference/" aria-current="true"> API reference </a> </li> </ul> </div> </div> </details> </nav> </details> <nav class="docs-nav" aria-label="Documentation"> <div class="docs-search" data-index-url="/__pyric/ui/docs/index.json"> <div class="docs-search-field"> <svg class="docs-search-icon" viewBox="0 0 16 16" width="14" height="14" aria-hidden="true"> <path d="M11.5 11.5 15 15M13 7A6 6 0 1 1 1 7a6 6 0 0 1 12 0Z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"></path> </svg> <input type="text" class="docs-search-input" placeholder="Search docs" aria-label="Search docs" autocomplete="off" spellcheck="false"> <kbd class="docs-search-kbd">⌘K</kbd> </div> <ul class="docs-search-results" hidden></ul> </div>  <a class="docs-nav-toplink" href="/__pyric/ui/docs/overview/" id="nav-group-overview"> Overview </a><details class="docs-nav-group" id="nav-group-run-locally"> <summary>Run locally</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/start-building/"> Quickstart </a> </li><li> <a href="/__pyric/ui/docs/how-the-swap-works/"> How the swap works </a> </li><li> <a href="/__pyric/ui/docs/set-up-your-agent/"> Connect an agent </a> </li><li> <a href="/__pyric/ui/docs/test-in-node/"> Test in Node </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-develop-with-firebase-apis"> <summary>Develop with Firebase APIs</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/sign-in-and-manage-users/"> Sign in and manage users </a> </li><li> <a href="/__pyric/ui/docs/store-and-query-data/"> Store and query data </a> </li><li> <a href="/__pyric/ui/docs/sync-realtime-data/"> Sync realtime data </a> </li><li> <a href="/__pyric/ui/docs/store-files/"> Store files </a> </li><li> <a href="/__pyric/ui/docs/receive-messages/"> Receive messages </a> </li><li> <a href="/__pyric/ui/docs/run-ai-logic-locally/"> Run AI Logic locally </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-how-to-run-rtdb-onvaluecreated/"> Run an RTDB function locally </a> </li><li> <a href="/__pyric/ui/docs/which-data-service/"> Which data service? </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-inspect-and-correct"> <summary>Inspect and correct</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-inspect-the-sandbox"> Inspect the sandbox </h2> <ul> <li> <a href="/__pyric/ui/docs/see-whats-happening/"> Traffic &amp; rule verdicts </a> </li><li> <a href="/__pyric/ui/docs/read-a-denial/"> Read a denial and understand it </a> </li><li> <a href="/__pyric/ui/docs/shape-your-data/"> Seed, snapshot, replay </a> </li><li> <a href="/__pyric/ui/docs/watch-and-review/"> Review agent activity </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-correct-security-rules"> Correct Security Rules </h2> <ul> <li> <a href="/__pyric/ui/docs/secure-it-with-rules/"> Security Rules </a> </li><li> <a href="/__pyric/ui/docs/simulate-and-lint/"> Simulate and lint before you deploy </a> </li><li> <a href="/__pyric/ui/docs/rules-patterns/"> Rules patterns </a> </li><li> <a href="/__pyric/ui/docs/rules-standard-library/"> The rules standard library </a> </li><li> <a href="/__pyric/ui/docs/rtdb-rules-in-typescript/"> RTDB rules in TypeScript </a> </li><li> <a href="/__pyric/ui/docs/firestore-rules-limits/"> Rules limits </a> </li><li> <a href="/__pyric/ui/docs/whats-possible/"> Case studies </a> </li> </ul> </div><div class="docs-nav-section"> <h2 class="docs-nav-heading" id="nav-section-inspect-and-correct-work-with-an-agent"> Work with an agent </h2> <ul> <li> <a href="/__pyric/ui/docs/what-your-agent-can-do/"> Work through an agent </a> </li><li> <a href="/__pyric/ui/docs/skills/"> Agent skills </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-verify-the-boundary"> <summary>Verify the boundary</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/pyric-cli-how-to-verify-against-a-captured-session/"> Verify a captured session </a> </li><li> <a href="/__pyric/ui/docs/write-a-rules-test-suite/"> Write a rules test suite </a> </li><li> <a href="/__pyric/ui/docs/audit-your-rules/"> Audit rules and data </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-ship-unchanged"> <summary>Ship unchanged</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/ship-to-production/"> Ship to production </a> </li><li> <a href="/__pyric/ui/docs/set-up-the-project/"> Set up the Firebase project </a> </li> </ul> </div> </div> </details><details class="docs-nav-group" id="nav-group-conformance"> <summary>Conformance</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section">  <ul> <li> <a href="/__pyric/ui/docs/how-we-know-it-matches-firebase/"> Conformance </a> </li><li> <a href="/__pyric/ui/docs/whats-experimental/"> What&#39;s experimental </a> </li><li> <a href="/__pyric/ui/docs/pyric-conformance-scores/"> Conformance scores </a> </li><li> <a href="/__pyric/ui/docs/pyric-app-compat/"> App </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore-compat/"> Firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth-compat/"> Auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database-compat/"> Realtime Database </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage-compat/"> Storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules-compat/"> Rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-messaging-compat/"> Messaging </a> </li><li> <a href="/__pyric/ui/docs/pyric-ai-compat/"> AI Logic </a> </li><li> <a href="/__pyric/ui/docs/pyric-cli-functions-rtdb-compat/"> Functions · RTDB </a> </li> </ul> </div> </div> </details> <details class="docs-nav-group" id="nav-group-reference" open> <summary>Reference</summary> <div class="docs-nav-group-body"> <div class="docs-nav-section"> <ul> <li> <a href="/__pyric/ui/docs/pyric-cli/"> @pyric/cli </a> </li><li> <a href="/__pyric/ui/docs/pyric-explanation-versioning-and-compatibility/"> pyric </a> </li><li> <a href="/__pyric/ui/docs/pyric-firestore/"> pyric / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-rules/"> pyric / rules </a> </li><li> <a href="/__pyric/ui/docs/pyric-sandbox/"> pyric / sandbox </a> </li><li> <a href="/__pyric/ui/docs/pyric-storage/"> pyric / storage </a> </li><li> <a href="/__pyric/ui/docs/pyric-auth/"> pyric / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-database/"> pyric / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-app/"> pyric-admin / app </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-firestore/"> pyric-admin / firestore </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-auth/"> pyric-admin / auth </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-database/"> pyric-admin / database </a> </li><li> <a href="/__pyric/ui/docs/pyric-admin-storage/"> pyric-admin / storage </a> </li><li> <a href="/__pyric/ui/docs/ui/"> @pyric/ui </a> </li><li> <a href="/__pyric/ui/docs/api-reference/" aria-current="true"> API reference </a> </li> </ul> </div> </div> </details> </nav> <main class="doc-main"> <nav class="docs-breadcrumbs" aria-label="Breadcrumb"> <ol> <li>  <a href="/__pyric/ui/docs/api-reference/">API reference</a> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span>@pyric/ui</span> </li><li> <span class="docs-breadcrumbs-sep" aria-hidden="true">/</span> <span aria-current="page">@pyric/ui/firestore</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/ui/firestore</code></h1> <p class="api-reference-meta"> 86 published symbols from <code>@pyric/ui</code> </p> <p class="api-reference-source">
+Generated from the TypeScript declarations shipped at this import path.
+</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Do not edit by hand; run bun run docs:api:generate. -->
+<h2 id="interfaces">Interfaces</h2>
+<p><a id="collectionlistprops"></a></p>
+<h3 id="collectionlistprops">CollectionListProps</h3>
+<h4 id="properties">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="collections"></a> <code>collections</code></td><td align="left"><code>CollectionReference</code>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="emptystate"></a> <code>emptyState?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Optional empty-state node. Rendered when <code>collections.length</code> is 0 and the list isn’t loading.</td></tr><tr><td align="left"><a id="error"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isloading"></a> <code>isLoading?</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="onselect"></a> <code>onSelect?</code></td><td align="left">(<code>collection</code>: <code>CollectionReference</code>) => <code>void</code></td><td align="left">Fired when a list item is clicked. Consumer wires navigation.</td></tr></tbody></table></div>
+<hr>
+<p><a id="deletewithconfirmprops"></a></p>
+<h3 id="deletewithconfirmprops">DeleteWithConfirmProps</h3>
+<h4 id="properties-1">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="body"></a> <code>body?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Confirm-dialog body.</td></tr><tr><td align="left"><a id="classname-1"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">Class forwarded to the default trigger button.</td></tr><tr><td align="left"><a id="confirmlabel"></a> <code>confirmLabel?</code></td><td align="left"><code>string</code></td><td align="left">Label on the destructive button.</td></tr><tr><td align="left"><a id="impl"></a> <code>impl</code></td><td align="left"><a href="#recursivedeleteimpl"><code>RecursiveDeleteImpl</code></a></td><td align="left">Implementation that walks the tree + deletes. Consumer-supplied. Sandbox-backed apps usually wire <code>pyric/sandbox</code> introspection; production apps usually call a Cloud Function.</td></tr><tr><td align="left"><a id="ondeleted"></a> <code>onDeleted?</code></td><td align="left">() => <code>void</code></td><td align="left">Fired after the delete iterator finishes successfully.</td></tr><tr><td align="left"><a id="rendertrigger"></a> <code>renderTrigger?</code></td><td align="left">(<code>props</code>: { <code>isRunning</code>: <code>boolean</code>; <code>onClick</code>: () => <code>void</code>; <code>progress</code>: <code>number</code>; }) => <code>ReactNode</code></td><td align="left">Optional render override for the trigger button.</td></tr><tr><td align="left"><a id="target"></a> <code>target</code></td><td align="left"><code>any</code></td><td align="left">The doc / collection to delete.</td></tr><tr><td align="left"><a id="title"></a> <code>title?</code></td><td align="left"><code>string</code></td><td align="left">Confirm-dialog title. Defaults to a sensible derivation from the target’s path.</td></tr></tbody></table></div>
+<hr>
+<p><a id="documenteditorrootprops"></a></p>
+<h3 id="documenteditorrootprops">DocumentEditorRootProps</h3>
+<h4 id="properties-2">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="children"></a> <code>children</code></td><td align="left"><code>ReactNode</code></td><td align="left">-</td></tr><tr><td align="left"><a id="classname-2"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="fieldeditors"></a> <code>fieldEditors?</code></td><td align="left"><a href="#fieldeditorregistry"><code>FieldEditorRegistry</code></a></td><td align="left">Override or extend the built-in field editors.</td></tr><tr><td align="left"><a id="initial"></a> <code>initial?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">Initial document data. Built into the editor’s tree on first mount; later changes don’t rebuild — call <code>editor.reset()</code> to re-initialize from a fresh <code>initial</code>.</td></tr><tr><td align="left"><a id="onchange"></a> <code>onChange?</code></td><td align="left">(<code>state</code>: <a href="#usedocumenteditorresult"><code>UseDocumentEditorResult</code></a>) => <code>void</code></td><td align="left">Called on every state change with the latest editor state. The parent typically watches <code>state.isValid</code> + <code>state.isDirty</code> to enable/disable a Save button.</td></tr></tbody></table></div>
+<hr>
+<p><a id="documenteditorstate"></a></p>
+<h3 id="documenteditorstate">DocumentEditorState</h3>
+<p>Reducer state. <code>tree</code> is the live document under edit; <code>initial</code>
+is the snapshot the editor was constructed from (used to
+implement <code>reset</code> and <code>isDirty</code>).</p>
+<h4 id="extended-by">Extended by</h4>
+<ul>
+<li><a href="#usedocumenteditorresult"><code>UseDocumentEditorResult</code></a></li>
+</ul>
+<h4 id="properties-3">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="errorcount"></a> <code>errorCount</code></td><td align="left"><code>number</code></td><td align="left">Count of nodes with an active <code>error</code>. Derived after every action; the reducer keeps it in state to avoid a tree walk on every render.</td></tr><tr><td align="left"><a id="initial-1"></a> <code>initial</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td><td align="left">Frozen copy of the tree at construction. <code>reset</code> restores from here; <code>isDirty</code> is computed by comparing serializations.</td></tr><tr><td align="left"><a id="tree"></a> <code>tree</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="documentlistprops"></a></p>
+<h3 id="documentlistprops">DocumentListProps</h3>
+<h4 id="properties-4">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-3"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="documents"></a> <code>documents</code></td><td align="left"><code>QueryDocumentSnapshot</code>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="emptystate-1"></a> <code>emptyState?</code></td><td align="left"><code>ReactNode</code></td><td align="left">-</td></tr><tr><td align="left"><a id="error-1"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="hasmore"></a> <code>hasMore?</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isloading-1"></a> <code>isLoading?</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="onloadmore"></a> <code>onLoadMore?</code></td><td align="left">() => <code>void</code></td><td align="left">Fired when the user requests another page. Wire to the hook’s <code>loadMore</code>. The component will not render a Load More button when this is undefined.</td></tr><tr><td align="left"><a id="onselect-1"></a> <code>onSelect?</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="renderlabel"></a> <code>renderLabel?</code></td><td align="left">(<code>doc</code>: <code>QueryDocumentSnapshot</code>) => <code>ReactNode</code></td><td align="left">Optional renderer for the row label. Default renders the doc id. Override to show a field value alongside, an icon, etc.</td></tr><tr><td align="left"><a id="renderrowaction"></a> <code>renderRowAction?</code></td><td align="left">(<code>doc</code>: <code>QueryDocumentSnapshot</code>) => <code>ReactNode</code></td><td align="left">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.</td></tr><tr><td align="left"><a id="rowheight"></a> <code>rowHeight?</code></td><td align="left"><code>number</code> | (<code>index</code>: <code>number</code>) => <code>number</code></td><td align="left">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).</td></tr><tr><td align="left"><a id="updatescope"></a> <code>updateScope?</code></td><td align="left"><code>string</code></td><td align="left">Stable collection/query identity used to reset update highlighting when the rendered list changes scope.</td></tr><tr><td align="left"><a id="virtualizedheight"></a> <code>virtualizedHeight?</code></td><td align="left"><code>string</code> | <code>number</code></td><td align="left">Pixel height the virtualized scroll container fills. Only applies when <code>documents.length > virtualizeThreshold</code>. Default <code>'60vh'</code> — consumers usually constrain via their layout.</td></tr><tr><td align="left"><a id="virtualizethreshold"></a> <code>virtualizeThreshold?</code></td><td align="left"><code>number</code></td><td align="left">Above this row count, the list switches to virtualization via <code>&#x3C;VirtualList></code>. Default 100. Set to <code>Infinity</code> to disable (e.g. when measuring layout shifts is more important than scroll perf).</td></tr></tbody></table></div>
+<hr>
+<p><a id="documentpreviewprops"></a></p>
+<h3 id="documentpreviewprops">DocumentPreviewProps</h3>
+<h4 id="properties-5">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-4"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">Forwarded to the root <code>&#x3C;div></code>.</td></tr><tr><td align="left"><a id="documentref"></a> <code>documentRef?</code></td><td align="left"><code>any</code></td><td align="left">The document’s own reference. Required to surface its subcollections — <code>DocumentSnapshot</code> (as typed by <code>pyric/firestore</code>) doesn’t expose <code>.ref</code>, so the consumer threads the ref it already holds from fetching the doc. Without it (or without <a href="#listsubcollections">listSubcollections</a>) the Subcollections section is omitted.</td></tr><tr><td align="left"><a id="emptystate-2"></a> <code>emptyState?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Content rendered when the snapshot is missing or <code>!exists()</code>. Defaults to <code>null</code> (renders nothing).</td></tr><tr><td align="left"><a id="fieldeditors-1"></a> <code>fieldEditors?</code></td><td align="left"><a href="#fieldeditorregistry"><code>FieldEditorRegistry</code></a></td><td align="left">Override or extend the built-in field editors. Merged on top of <a href="#defaultfieldeditors">defaultFieldEditors</a> — only the keys you provide override.</td></tr><tr><td align="left"><a id="firestore"></a> <code>firestore?</code></td><td align="left"><code>Firestore</code></td><td align="left">Firestore handle passed to <a href="#listsubcollections">listSubcollections</a>. Required alongside <code>documentRef</code> + <code>listSubcollections</code> to surface the Subcollections section (the same explicit-handle shape <code>ReferencePicker</code> uses).</td></tr><tr><td align="left"><a id="listsubcollections"></a> <code>listSubcollections?</code></td><td align="left"><a href="#listsubcollections-2"><code>ListSubcollections</code></a></td><td align="left">Injected lister for the document’s subcollections. The modular Web SDK has no client-side <code>listCollections</code>; sandbox-backed apps wire <code>pyric/sandbox</code>’s in-process listing, production apps pass a known list or a server proxy. Same shape <code>ReferencePicker</code> / <code>useCollectionList</code> use. Omit to hide the Subcollections section.</td></tr><tr><td align="left"><a id="onreferenceclick"></a> <code>onReferenceClick?</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>void</code></td><td align="left">Fired when a reference field is clicked. When supplied, the reference Display renders as an interactive <code>&#x3C;button></code> (with <code>data-pyric-clickable</code>); when omitted, it stays inert as a <code>&#x3C;span></code>. Consumers wire navigation here — the library does not depend on a router.</td></tr><tr><td align="left"><a id="onsubcollectionclick"></a> <code>onSubcollectionClick?</code></td><td align="left">(<code>collection</code>: <code>CollectionReference</code>) => <code>void</code></td><td align="left">Fired when a subcollection’s drill affordance is activated. Receives the subcollection’s <code>CollectionReference</code> (its <code>.path</code> is the navigate target). Consumers wire navigation here.</td></tr><tr><td align="left"><a id="snapshot"></a> <code>snapshot</code></td><td align="left"><code>any</code></td><td align="left">Snapshot from <code>useFirestoreDoc</code> or <code>getDoc</code>. When <code>null</code> / <code>undefined</code>, renders <a href="#emptystate-2">emptyState</a>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="editortree"></a></p>
+<h3 id="editortree">EditorTree</h3>
+<p>Normalized tree of nodes. <code>nodes</code> is the lookup; <code>childIds</code> is the
+ordered child list per parent. The root node is itself a <code>map</code>
+node (its children are the document’s top-level fields).</p>
+<h4 id="properties-6">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="childids"></a> <code>childIds</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>string</code>[]></td></tr><tr><td align="left"><a id="nodes"></a> <code>nodes</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#fieldnode"><code>FieldNode</code></a>></td></tr><tr><td align="left"><a id="rootid"></a> <code>rootId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="fielddisplayprops"></a></p>
+<h3 id="fielddisplayprops">FieldDisplayProps</h3>
+<h4 id="type-parameters">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th><th align="left">Default type</th></tr></thead><tbody><tr><td align="left"><code>V</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="properties-7">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="fieldeditors-2"></a> <code>fieldEditors?</code></td><td align="left"><a href="#fieldeditorregistry"><code>FieldEditorRegistry</code></a></td><td align="left">Recursive editors (Map, Array) need the registry to dispatch on their children. Leaf editors (String, Number, …) can ignore this prop. Required-but-optional because the consumer of the component (<code>&#x3C;FieldRenderer></code>, <code>&#x3C;DocumentPreview></code>) always threads it through.</td></tr><tr><td align="left"><a id="path"></a> <code>path?</code></td><td align="left"><code>string</code></td><td align="left">Dotted/bracketed path from the document root, e.g. <code>users.alice</code> or <code>tags[0]</code>. Forwarded so consumer styles can target nested positions via <code>[data-field-path="users.alice"]</code>.</td></tr><tr><td align="left"><a id="value"></a> <code>value</code></td><td align="left"><code>V</code></td><td align="left">Value to display. The component’s <code>V</code> generic narrows this.</td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldeditorcontract"></a></p>
+<h3 id="fieldeditorcontract">FieldEditorContract</h3>
+<p>Contract for one Firestore value type. <code>Display</code> (read-mode) is
+required; <code>Edit</code> + <code>validate</code> + <code>defaultValue</code> are required for
+leaf types that participate in M3’s editor. Map/array contracts
+supply only <code>Display</code> — their edit affordances come from the
+<code>&#x3C;DocumentEditor></code> compound component.</p>
+<h4 id="type-parameters-1">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th><th align="left">Default type</th></tr></thead><tbody><tr><td align="left"><code>V</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="properties-8">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="display"></a> <code>Display</code></td><td align="left"><code>ComponentType</code>&#x3C;<a href="#fielddisplayprops"><code>FieldDisplayProps</code></a>&#x3C;<code>V</code>>></td></tr><tr><td align="left"><a id="edit"></a> <code>Edit?</code></td><td align="left"><code>ComponentType</code>&#x3C;<a href="#fieldeditprops"><code>FieldEditProps</code></a>&#x3C;<code>V</code>>></td></tr><tr><td align="left"><a id="type"></a> <code>type</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a></td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldeditprops"></a></p>
+<h3 id="fieldeditprops">FieldEditProps</h3>
+<p>Props passed to a per-type <code>Edit</code> component. The leaf editors
+(string, number, …) consume this directly. Map/array editing is
+handled by the <code>&#x3C;DocumentEditor></code> compound component itself, not
+by individual editors — Firestore’s container shapes are special
+enough that pushing them through the registry costs more than
+it’s worth.</p>
+<h4 id="type-parameters-2">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th><th align="left">Default type</th></tr></thead><tbody><tr><td align="left"><code>V</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="properties-9">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="error-2"></a> <code>error?</code></td><td align="left"><code>string</code></td><td align="left">Validation error attached by the reducer. Editors render it inline alongside the input.</td></tr><tr><td align="left"><a id="onchange-1"></a> <code>onChange</code></td><td align="left">(<code>next</code>: <code>V</code>) => <code>void</code></td><td align="left">Commit a new value. The hook wires this to the reducer’s <code>setValue</code> action.</td></tr><tr><td align="left"><a id="path-1"></a> <code>path?</code></td><td align="left"><code>string</code></td><td align="left">Dotted/bracketed path from the document root.</td></tr><tr><td align="left"><a id="value-1"></a> <code>value</code></td><td align="left"><code>V</code></td><td align="left">Current value.</td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldnode"></a></p>
+<h3 id="fieldnode">FieldNode</h3>
+<p>One node in the normalized editor tree. Every Firestore field —
+leaf or container — is a node with a uuid, a parent pointer, a
+type, and a value. Containers (map, array) carry no value of
+their own; their children represent the value.</p>
+<h4 id="properties-10">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="error-3"></a> <code>error?</code></td><td align="left"><code>string</code></td><td align="left">Validation error message attached to the node by the reducer after every action. <code>undefined</code> when valid. Computed on EVERY action regardless of <a href="#touched">touched</a> — <code>errorCount</code> / <code>isValid</code> must reflect the true state so Save stays disabled. <code>touched</code> governs only whether a consumer chooses to DISPLAY the error.</td></tr><tr><td align="left"><a id="id"></a> <code>id</code></td><td align="left"><code>string</code></td><td align="left">Stable uuid. Used as React <code>key</code> and as the action target.</td></tr><tr><td align="left"><a id="key"></a> <code>key</code></td><td align="left"><code>string</code></td><td align="left">Map children carry their key here. Array children carry <code>null</code> (position comes from the parent’s <code>childIds</code> order). The root also carries <code>null</code> (it has no parent).</td></tr><tr><td align="left"><a id="parentid"></a> <code>parentId</code></td><td align="left"><code>string</code></td><td align="left">Parent uuid; <code>null</code> for the root.</td></tr><tr><td align="left"><a id="touched"></a> <code>touched?</code></td><td align="left"><code>boolean</code></td><td align="left">Set once the field has been blurred (or a submit attempt swept the whole tree via <code>touchAll</code>). Consumers gate error display on <code>touched &#x26;&#x26; error</code> so a freshly-added empty row doesn’t show “Field name is required” before the user has interacted with it.</td></tr><tr><td align="left"><a id="type-1"></a> <code>type</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a></td><td align="left">Discriminated type. Drives which editor renders.</td></tr><tr><td align="left"><a id="value-2"></a> <code>value</code></td><td align="left"><code>unknown</code></td><td align="left">Leaf value. <code>undefined</code> for <code>map</code> / <code>array</code> — those carry their value as children. <code>null</code> field type has <code>value === null</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="fieldrendererprops"></a></p>
+<h3 id="fieldrendererprops">FieldRendererProps</h3>
+<h4 id="properties-11">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="fieldeditors-3"></a> <code>fieldEditors</code></td><td align="left"><a href="#fieldeditorregistry"><code>FieldEditorRegistry</code></a></td><td align="left">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). <code>&#x3C;DocumentPreview></code> is the entry point that merges user overrides into defaults.</td></tr><tr><td align="left"><a id="path-2"></a> <code>path?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="value-3"></a> <code>value</code></td><td align="left"><code>unknown</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="parsedimportdoc"></a></p>
+<h3 id="parsedimportdoc">ParsedImportDoc</h3>
+<p>One document to create. <code>id === null</code> means “let Firestore auto-id it”
+(only produced by the array shape when no <code>generateId</code> option is given —
+a map key is always a chosen id).</p>
+<h4 id="properties-12">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="data"></a> <code>data</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr><tr><td align="left"><a id="id-1"></a> <code>id</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="parseimportoptions"></a></p>
+<h3 id="parseimportoptions">ParseImportOptions</h3>
+<h4 id="properties-13">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="generateid"></a> <code>generateId?</code></td><td align="left">() => <code>string</code></td><td align="left">When provided, array-shape entries get their auto-id GENERATED AT PARSE TIME (instead of <code>id: null</code> / addDoc-at-write-time). Fixing ids at parse makes a retry after a partial failure idempotent: the same parse’s ids are reused, so re-running the import cannot duplicate already-written docs. Use <a href="#firestoreautoid">firestoreAutoId</a> for prod-parity ids.</td></tr></tbody></table></div>
+<hr>
+<p><a id="parseimportresult"></a></p>
+<h3 id="parseimportresult">ParseImportResult</h3>
+<h4 id="properties-14">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="docs"></a> <code>docs</code></td><td align="left"><a href="#parsedimportdoc"><code>ParsedImportDoc</code></a>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="errors"></a> <code>errors</code></td><td align="left"><code>string</code>[]</td><td align="left">Human-readable problems found while parsing. A non-empty <code>errors</code> does NOT necessarily mean <code>docs</code> is empty — the parser is per-item tolerant so one bad entry doesn’t block the rest; the caller decides whether to block on any error or proceed with the valid subset.</td></tr></tbody></table></div>
+<hr>
+<p><a id="querybuilderactions"></a></p>
+<h3 id="querybuilderactions">QueryBuilderActions</h3>
+<h4 id="properties-15">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="addcondition"></a> <code>addCondition</code></td><td align="left">(<code>c?</code>: <code>Partial</code>&#x3C;<code>Omit</code>&#x3C;<a href="#querycondition"><code>QueryCondition</code></a>, <code>"id"</code>>>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="buildquery"></a> <code>buildQuery</code></td><td align="left">(<code>base</code>: <code>any</code>) => <code>Query</code></td><td align="left">Compose the state into a Firestore <code>Query</code>. Returns the base collection when there are no conditions / orderBy / limit. Conditions with empty <code>field</code> are skipped — the builder UI lets users add a row before they’ve filled it in.</td></tr><tr><td align="left"><a id="removecondition"></a> <code>removeCondition</code></td><td align="left">(<code>id</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="reset"></a> <code>reset</code></td><td align="left">() => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setlimit"></a> <code>setLimit</code></td><td align="left">(<code>limit?</code>: <code>number</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setorderby"></a> <code>setOrderBy</code></td><td align="left">(<code>orderBy?</code>: { <code>direction</code>: <code>OrderDirection</code>; <code>field</code>: <code>string</code>; }) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="updatecondition"></a> <code>updateCondition</code></td><td align="left">(<code>id</code>: <code>string</code>, <code>patch</code>: <code>Partial</code>&#x3C;<code>Omit</code>&#x3C;<a href="#querycondition"><code>QueryCondition</code></a>, <code>"id"</code>>>) => <code>void</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="querybuilderprops"></a></p>
+<h3 id="querybuilderprops">QueryBuilderProps</h3>
+<h4 id="properties-16">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-5"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="initial-2"></a> <code>initial?</code></td><td align="left"><code>Partial</code>&#x3C;<a href="#querybuilderstate"><code>QueryBuilderState</code></a>></td><td align="left">Drives the hook used internally. Both the state and the composed Query are exposed via <code>onChange</code>.</td></tr><tr><td align="left"><a id="onchange-2"></a> <code>onChange?</code></td><td align="left">(<code>builder</code>: <a href="#usequerybuilderresult"><code>UseQueryBuilderResult</code></a>) => <code>void</code></td><td align="left">Fired on every state change with the latest builder API. The parent typically calls <code>builder.buildQuery(collection)</code> and feeds the result into <code>useDocumentList</code> / <code>useFirestoreCollection</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="querybuilderstate"></a></p>
+<h3 id="querybuilderstate">QueryBuilderState</h3>
+<h4 id="properties-17">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="conditions"></a> <code>conditions</code></td><td align="left"><a href="#querycondition"><code>QueryCondition</code></a>[]</td></tr><tr><td align="left"><a id="limit"></a> <code>limit?</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="orderby"></a> <code>orderBy?</code></td><td align="left">{ <code>direction</code>: <code>OrderDirection</code>; <code>field</code>: <code>string</code>; }</td></tr><tr><td align="left"><code>orderBy.direction</code></td><td align="left"><code>OrderDirection</code></td></tr><tr><td align="left"><code>orderBy.field</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="querycondition"></a></p>
+<h3 id="querycondition">QueryCondition</h3>
+<h4 id="properties-18">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="field"></a> <code>field</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="id-2"></a> <code>id</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="op"></a> <code>op</code></td><td align="left"><code>WhereFilterOp</code></td></tr><tr><td align="left"><a id="value-4"></a> <code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="recursivedeleteimpl"></a></p>
+<h3 id="recursivedeleteimpl">RecursiveDeleteImpl</h3>
+<p>Implementation injected by the consumer. The library doesn’t ship
+one — sandbox-backed apps usually walk <code>pyric/sandbox</code>’s in-process
+tree; production apps usually call a Cloud Function. Either way,
+<code>start</code> returns an async iterator emitting progress.</p>
+<h4 id="properties-19">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="start"></a> <code>start</code></td><td align="left">(<code>target</code>: <code>any</code>) => <code>AsyncIterableIterator</code>&#x3C;<a href="#recursivedeleteprogress"><code>RecursiveDeleteProgress</code></a>></td></tr></tbody></table></div>
+<hr>
+<p><a id="recursivedeleteprogress"></a></p>
+<h3 id="recursivedeleteprogress">RecursiveDeleteProgress</h3>
+<h4 id="properties-20">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="deletedcount"></a> <code>deletedCount</code></td><td align="left"><code>number</code></td><td align="left">Total nodes deleted so far.</td></tr><tr><td align="left"><a id="done"></a> <code>done</code></td><td align="left"><code>boolean</code></td><td align="left">True for the final emission.</td></tr></tbody></table></div>
+<hr>
+<p><a id="referencepickerprops"></a></p>
+<h3 id="referencepickerprops">ReferencePickerProps</h3>
+<h4 id="properties-21">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-6"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">Forwarded to the root.</td></tr><tr><td align="left"><a id="firestore-1"></a> <code>firestore</code></td><td align="left"><code>Firestore</code></td><td align="left">-</td></tr><tr><td align="left"><a id="initialpath"></a> <code>initialPath?</code></td><td align="left"><code>string</code></td><td align="left">Initial path text.</td></tr><tr><td align="left"><a id="listcollections"></a> <code>listCollections</code></td><td align="left">(<code>firestore</code>: <code>Firestore</code>, <code>parent</code>: <code>any</code>) => <code>Promise</code>&#x3C;<code>CollectionReference</code>[]></td><td align="left">Lister for subcollections. Required — see <code>useReferencePicker</code> docs for the rationale.</td></tr><tr><td align="left"><a id="onpick"></a> <code>onPick?</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>void</code></td><td align="left">Fired when the user commits a picked reference (browse pick OR a valid manually-typed path with the Commit button).</td></tr><tr><td align="left"><a id="pathlabel"></a> <code>pathLabel?</code></td><td align="left"><code>string</code></td><td align="left">Label for the path text input. Default ‘Document path’.</td></tr></tbody></table></div>
+<hr>
+<p><a id="subscriptionstate"></a></p>
+<h3 id="subscriptionstate">SubscriptionState</h3>
+<h4 id="type-parameters-3">Type Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Type Parameter</th></tr></thead><tbody><tr><td align="left"><code>T</code></td></tr></tbody></table></div>
+<h4 id="properties-22">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="data-1"></a> <code>data</code></td><td align="left"><code>T</code></td></tr><tr><td align="left"><a id="error-4"></a> <code>error</code></td><td align="left"><code>Error</code></td></tr><tr><td align="left"><a id="isloading-2"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="usecollectionlistoptions"></a></p>
+<h3 id="usecollectionlistoptions">UseCollectionListOptions</h3>
+<h4 id="properties-23">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="firestore-2"></a> <code>firestore</code></td><td align="left"><code>Firestore</code></td><td align="left">-</td></tr><tr><td align="left"><a id="listcollections-1"></a> <code>listCollections</code></td><td align="left">(<code>firestore</code>: <code>Firestore</code>, <code>parent</code>: <code>any</code>) => <code>Promise</code>&#x3C;<code>CollectionReference</code>[]></td><td align="left">Injected collection-listing function. The library doesn’t ship a default — the modular Web SDK doesn’t expose <code>listCollections</code> on the client. Sandbox-backed apps usually wire <code>pyric/sandbox</code>’s in-process listing; production apps either pass a known list (e.g. from a schema) or call a server proxy.</td></tr><tr><td align="left"><a id="parent"></a> <code>parent?</code></td><td align="left"><code>any</code></td><td align="left">Parent document, or <code>null</code>/<code>undefined</code> for root collections.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usecollectionlistresult"></a></p>
+<h3 id="usecollectionlistresult">UseCollectionListResult</h3>
+<h4 id="properties-24">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="collections-1"></a> <code>collections</code></td><td align="left"><code>CollectionReference</code>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="createcollection"></a> <code>createCollection</code></td><td align="left">(<code>collectionId</code>: <code>string</code>, <code>firstDoc</code>: { <code>data</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>; <code>id</code>: <code>string</code>; }) => <code>Promise</code>&#x3C;<code>DocumentReference</code>></td><td align="left">Create a new collection by writing its first document. Firestore collections don’t exist independently of their documents — <code>setDoc</code> on the first child path materializes the collection.</td></tr><tr><td align="left"><a id="error-5"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isloading-3"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="refresh"></a> <code>refresh</code></td><td align="left">() => <code>void</code></td><td align="left">Re-run the listing function.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumenteditoroptions"></a></p>
+<h3 id="usedocumenteditoroptions">UseDocumentEditorOptions</h3>
+<h4 id="properties-25">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="initial-3"></a> <code>initial?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">Initial document data — the same shape a <code>DocumentSnapshot.data()</code> call returns.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumenteditorresult"></a></p>
+<h3 id="usedocumenteditorresult">UseDocumentEditorResult</h3>
+<p>Reducer state. <code>tree</code> is the live document under edit; <code>initial</code>
+is the snapshot the editor was constructed from (used to
+implement <code>reset</code> and <code>isDirty</code>).</p>
+<h4 id="extends">Extends</h4>
+<ul>
+<li><a href="#documenteditorstate"><code>DocumentEditorState</code></a></li>
+</ul>
+<h4 id="properties-26">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="addarrayentry"></a> <code>addArrayEntry</code></td><td align="left">(<code>parentId</code>: <code>string</code>, <code>childType</code>: <a href="#fieldtype"><code>FieldType</code></a>) => <code>void</code></td><td align="left">Append a child to an array. Nested arrays are silently rejected by the reducer (Firestore disallows them).</td></tr><tr><td align="left"><a id="addmapentry"></a> <code>addMapEntry</code></td><td align="left">(<code>parentId</code>: <code>string</code>, <code>key</code>: <code>string</code>, <code>childType</code>: <a href="#fieldtype"><code>FieldType</code></a>) => <code>void</code></td><td align="left">Append a child to a map.</td></tr><tr><td align="left"><a id="dispatch"></a> <code>dispatch</code></td><td align="left">(<code>action</code>: <a href="#documenteditoraction"><code>DocumentEditorAction</code></a>) => <code>void</code></td><td align="left">Raw dispatch — drops to the reducer-action surface. Prefer the named helpers below.</td></tr><tr><td align="left"><a id="errorcount-1"></a> <code>errorCount</code></td><td align="left"><code>number</code></td><td align="left">Count of nodes with an active <code>error</code>. Derived after every action; the reducer keeps it in state to avoid a tree walk on every render.</td></tr><tr><td align="left"><a id="initial-4"></a> <code>initial</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td><td align="left">Frozen copy of the tree at construction. <code>reset</code> restores from here; <code>isDirty</code> is computed by comparing serializations.</td></tr><tr><td align="left"><a id="isdirty"></a> <code>isDirty</code></td><td align="left"><code>boolean</code></td><td align="left"><code>true</code> once any modifying action has fired since the last <code>reset</code>. Cleared by <code>reset</code>. Does NOT clear when the user manually re-enters the original values — checking that would require a full serialization comparison on every dispatch.</td></tr><tr><td align="left"><a id="isvalid"></a> <code>isValid</code></td><td align="left"><code>boolean</code></td><td align="left">Convenience: <code>errorCount === 0</code>.</td></tr><tr><td align="left"><a id="remove"></a> <code>remove</code></td><td align="left">(<code>nodeId</code>: <code>string</code>) => <code>void</code></td><td align="left">Remove a node (and all its descendants). Removing the root is a no-op.</td></tr><tr><td align="left"><a id="replacedata"></a> <code>replaceData</code></td><td align="left">(<code>data</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>) => <code>void</code></td><td align="left">Replace the editor with a newly delivered snapshot and adopt it as the clean baseline. Intended for live document viewers.</td></tr><tr><td align="left"><a id="reset-1"></a> <code>reset</code></td><td align="left">() => <code>void</code></td><td align="left">Restore the tree to its initial state. Clears <code>isDirty</code>.</td></tr><tr><td align="left"><a id="setkey"></a> <code>setKey</code></td><td align="left">(<code>nodeId</code>: <code>string</code>, <code>key</code>: <code>string</code>) => <code>void</code></td><td align="left">Set a map-child’s key.</td></tr><tr><td align="left"><a id="settype"></a> <code>setType</code></td><td align="left">(<code>nodeId</code>: <code>string</code>, <code>newType</code>: <a href="#fieldtype"><code>FieldType</code></a>) => <code>void</code></td><td align="left">Switch a node’s type. Map/array nodes drop their children.</td></tr><tr><td align="left"><a id="setvalue"></a> <code>setValue</code></td><td align="left">(<code>nodeId</code>: <code>string</code>, <code>value</code>: <code>unknown</code>) => <code>void</code></td><td align="left">Update a leaf value.</td></tr><tr><td align="left"><a id="todata"></a> <code>toData</code></td><td align="left">() => <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">Serialize the tree back to a Firestore-shaped object suitable for <code>setDoc</code> / <code>updateDoc</code>.</td></tr><tr><td align="left"><a id="touch"></a> <code>touch</code></td><td align="left">(<code>nodeId</code>: <code>string</code>) => <code>void</code></td><td align="left">Mark one node touched (dispatch on blur). Gates error display — a freshly-added row stays quiet until the user leaves it.</td></tr><tr><td align="left"><a id="touchall"></a> <code>touchAll</code></td><td align="left">() => <code>void</code></td><td align="left">Mark every node touched (dispatch on a submit attempt) so any hidden errors surface at once.</td></tr><tr><td align="left"><a id="tree-1"></a> <code>tree</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumentlistoptions"></a></p>
+<h3 id="usedocumentlistoptions">UseDocumentListOptions</h3>
+<h4 id="properties-27">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="collection"></a> <code>collection</code></td><td align="left"><code>CollectionReference</code></td><td align="left">-</td></tr><tr><td align="left"><a id="mode"></a> <code>mode?</code></td><td align="left"><code>"paged"</code> | <code>"live"</code></td><td align="left"><code>paged</code> preserves the historical get-based cursor behavior. <code>live</code> keeps the currently requested window under an <code>onSnapshot</code> subscription and grows that window when <code>loadMore</code> is requested. Default <code>paged</code>.</td></tr><tr><td align="left"><a id="pagesize"></a> <code>pageSize?</code></td><td align="left"><code>number</code></td><td align="left">Page size for cursor-based pagination. Default 50.</td></tr><tr><td align="left"><a id="query"></a> <code>query?</code></td><td align="left"><code>Query</code></td><td align="left">Optional filter / sort. If omitted, the raw collection is used.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumentlistresult"></a></p>
+<h3 id="usedocumentlistresult">UseDocumentListResult</h3>
+<h4 id="properties-28">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="createdocument"></a> <code>createDocument</code></td><td align="left">(<code>id</code>: <code>string</code>, <code>data</code>: <code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>>, <code>opts?</code>: { <code>onExisting?</code>: <code>"overwrite"</code> | <code>"fail"</code>; }) => <code>Promise</code>&#x3C;<code>DocumentReference</code>></td><td align="left">Create a document. If <code>id</code> is null, Firestore generates one via <code>addDoc</code>. With <code>onExisting: 'fail'</code> (CREATE semantics, the admin <code>create()</code> analog) an id that already exists rejects with <code>code: 'already-exists'</code> instead of silently overwriting — checked against the BACKEND (a <code>getDoc</code> probe), not any loaded page, so it is honest beyond pagination. Default: ‘overwrite’ (plain <code>setDoc</code>, the historical behavior).</td></tr><tr><td align="left"><a id="deletedocument"></a> <code>deleteDocument</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>Promise</code>&#x3C;<code>void</code>></td><td align="left">-</td></tr><tr><td align="left"><a id="documents-1"></a> <code>documents</code></td><td align="left"><code>QueryDocumentSnapshot</code>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="error-6"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="hasmore-1"></a> <code>hasMore</code></td><td align="left"><code>boolean</code></td><td align="left">True if there might be another page. The hook tracks this via the last fetch’s length === pageSize.</td></tr><tr><td align="left"><a id="isloading-4"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="loadmore"></a> <code>loadMore</code></td><td align="left">() => <code>void</code></td><td align="left">Fetch the next page; live mode grows and re-establishes its window.</td></tr><tr><td align="left"><a id="refresh-1"></a> <code>refresh</code></td><td align="left">() => <code>void</code></td><td align="left">Re-establish the active read/subscription. Useful after the consumer mutates data outside this hook.</td></tr><tr><td align="left"><a id="subscriptiongeneration"></a> <code>subscriptionGeneration</code></td><td align="left"><code>number</code></td><td align="left">Identifies the active live subscription. Consumers that diff result snapshots can include this in their scope so a re-subscription (including load-more) establishes a silent baseline instead of looking like writes.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumentsubcollectionsoptions"></a></p>
+<h3 id="usedocumentsubcollectionsoptions">UseDocumentSubcollectionsOptions</h3>
+<h4 id="properties-29">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="documentref-1"></a> <code>documentRef</code></td><td align="left"><code>any</code></td><td align="left">The document whose subcollections to list. When <code>null</code>/<code>undefined</code> the hook stays idle (empty, not loading) — used when the preview has no ref to drill from.</td></tr><tr><td align="left"><a id="firestore-3"></a> <code>firestore</code></td><td align="left"><code>Firestore</code></td><td align="left">-</td></tr><tr><td align="left"><a id="listsubcollections-1"></a> <code>listSubcollections</code></td><td align="left"><a href="#listsubcollections-2"><code>ListSubcollections</code></a></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="usedocumentsubcollectionsresult"></a></p>
+<h3 id="usedocumentsubcollectionsresult">UseDocumentSubcollectionsResult</h3>
+<h4 id="properties-30">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="error-7"></a> <code>error</code></td><td align="left"><code>Error</code></td></tr><tr><td align="left"><a id="isloading-5"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="subcollections"></a> <code>subcollections</code></td><td align="left"><code>CollectionReference</code>[]</td></tr></tbody></table></div>
+<hr>
+<p><a id="usequerybuilderoptions"></a></p>
+<h3 id="usequerybuilderoptions">UseQueryBuilderOptions</h3>
+<h4 id="properties-31">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="initial-5"></a> <code>initial?</code></td><td align="left"><code>Partial</code>&#x3C;<a href="#querybuilderstate"><code>QueryBuilderState</code></a>></td><td align="left">Pre-populate the builder.</td></tr></tbody></table></div>
+<hr>
+<p><a id="userecursivedeleteresult"></a></p>
+<h3 id="userecursivedeleteresult">UseRecursiveDeleteResult</h3>
+<h4 id="properties-32">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="delete"></a> <code>delete</code></td><td align="left">(<code>target</code>: <code>any</code>) => <code>Promise</code>&#x3C;<code>void</code>></td><td align="left">Run the delete. Resolves when the iterator signals <code>done</code>.</td></tr><tr><td align="left"><a id="error-8"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">Error thrown by the iterator, if any. Cleared at the start of the next call.</td></tr><tr><td align="left"><a id="isrunning"></a> <code>isRunning</code></td><td align="left"><code>boolean</code></td><td align="left">True while an iteration is in flight.</td></tr><tr><td align="left"><a id="progress"></a> <code>progress</code></td><td align="left"><code>number</code></td><td align="left">Number of nodes deleted in the current/last run.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usereferencepickeroptions"></a></p>
+<h3 id="usereferencepickeroptions">UseReferencePickerOptions</h3>
+<h4 id="properties-33">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="firestore-4"></a> <code>firestore</code></td><td align="left"><code>Firestore</code></td><td align="left">-</td></tr><tr><td align="left"><a id="initialpath-1"></a> <code>initialPath?</code></td><td align="left"><code>string</code></td><td align="left">Initial value to pre-populate the text input + parse.</td></tr><tr><td align="left"><a id="listcollections-2"></a> <code>listCollections</code></td><td align="left">(<code>firestore</code>: <code>Firestore</code>, <code>parent</code>: <code>any</code>) => <code>Promise</code>&#x3C;<code>CollectionReference</code>[]></td><td align="left">Lister for subcollections under a parent (or root when <code>parent == null</code>). The library does not ship a default — see <code>useCollectionList</code> for the same rationale (the modular Web SDK can’t enumerate collections client-side).</td></tr><tr><td align="left"><a id="pagesize-1"></a> <code>pageSize?</code></td><td align="left"><code>number</code></td><td align="left">Default page size for the document list when browsing inside a collection. Default 20.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usereferencepickerresult"></a></p>
+<h3 id="usereferencepickerresult">UseReferencePickerResult</h3>
+<h4 id="properties-34">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="browselocation"></a> <code>browseLocation</code></td><td align="left"><a href="#browselocation-1"><code>BrowseLocation</code></a></td><td align="left">Current browse position in the tree.</td></tr><tr><td align="left"><a id="candrillback"></a> <code>canDrillBack</code></td><td align="left"><code>boolean</code></td><td align="left">Whether <code>drillBack</code> has anywhere to go.</td></tr><tr><td align="left"><a id="clear"></a> <code>clear</code></td><td align="left">() => <code>void</code></td><td align="left">Clear the path input + reset browse to root.</td></tr><tr><td align="left"><a id="collections-2"></a> <code>collections</code></td><td align="left"><code>CollectionReference</code>[]</td><td align="left">Collections available at the current browse level. Populated when <code>browseLocation</code> is <code>root</code> or <code>document</code>.</td></tr><tr><td align="left"><a id="documents-2"></a> <code>documents</code></td><td align="left"><code>QueryDocumentSnapshot</code>[]</td><td align="left">First page of documents in the current collection — populated when <code>browseLocation.kind === 'collection'</code>.</td></tr><tr><td align="left"><a id="drillback"></a> <code>drillBack</code></td><td align="left">() => <code>void</code></td><td align="left">Step back one level. No-op when at root.</td></tr><tr><td align="left"><a id="drillintocollection"></a> <code>drillIntoCollection</code></td><td align="left">(<code>ref</code>: <code>CollectionReference</code>) => <code>void</code></td><td align="left">Drill into a collection — fetches its first page of documents.</td></tr><tr><td align="left"><a id="drillintodocument"></a> <code>drillIntoDocument</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>void</code></td><td align="left">Drill into a document — fetches its subcollections.</td></tr><tr><td align="left"><a id="error-9"></a> <code>error</code></td><td align="left"><code>string</code></td><td align="left">Parse error, or <code>null</code> when valid.</td></tr><tr><td align="left"><a id="isloading-6"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td><td align="left">True while a fetch is in flight.</td></tr><tr><td align="left"><a id="pathinput"></a> <code>pathInput</code></td><td align="left"><code>string</code></td><td align="left">Current text input value.</td></tr><tr><td align="left"><a id="pick"></a> <code>pick</code></td><td align="left">(<code>ref</code>: <code>DocumentReference</code>) => <code>void</code></td><td align="left">Commit a chosen reference. Updates <code>pathInput</code> (and therefore the parsed <code>reference</code>).</td></tr><tr><td align="left"><a id="reference"></a> <code>reference</code></td><td align="left"><code>any</code></td><td align="left">Validated <code>DocumentReference</code> parsed from <code>pathInput</code>, or <code>null</code> when the path is empty / invalid.</td></tr><tr><td align="left"><a id="setpathinput"></a> <code>setPathInput</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Set the text-input value. Parses on every change.</td></tr></tbody></table></div>
+<hr>
+<p><a id="vectorview"></a></p>
+<h3 id="vectorview">VectorView</h3>
+<p>Normalized read-side view of a Firestore vector (embedding) value.
+Editors and the renderer work against this rather than the raw shape
+so they don’t have to care which backend produced the value.</p>
+<h4 id="properties-35">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Modifier</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="dimension"></a> <code>dimension</code></td><td align="left"><code>readonly</code></td><td align="left"><code>number</code></td><td align="left">Number of components. Equivalent to <code>values.length</code>; surfaced separately because that’s what the UI labels (<code>vector · &#x3C;dims></code>).</td></tr><tr><td align="left"><a id="values"></a> <code>values</code></td><td align="left"><code>readonly</code></td><td align="left"><code>number</code>[]</td><td align="left">The embedding components. Defensive copy — safe to read freely.</td></tr></tbody></table></div>
+<h2 id="type-aliases">Type Aliases</h2>
+<p><a id="browselocation-1"></a></p>
+<h3 id="browselocation">BrowseLocation</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> BrowseLocation</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"root"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"document"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  ref</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentReference</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  kind</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"collection"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  ref</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CollectionReference</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<hr>
+<p><a id="documenteditoraction"></a></p>
+<h3 id="documenteditoraction">DocumentEditorAction</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> DocumentEditorAction</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setValue"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  newType</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setType"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setKey"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  childType</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addMapEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  childType</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addArrayEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"remove"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  data</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"replaceData"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touch"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touchAll"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Discriminated union of every action the reducer accepts. Each
+action carries a <code>type</code> discriminator plus the data the reducer
+needs to apply it.</p>
+<h4 id="type-declaration">Type Declaration</h4>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setValue"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">unknown</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="nodeid">nodeId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setValue"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="value">value</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">unknown</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  newType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setType"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="newtype">newType</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">newType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="nodeid-1">nodeId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-1">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setType"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setKey"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="key">key</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="nodeid-2">nodeId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-2">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setKey"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  childType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addMapEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="childtype">childType</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">childType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="key-1">key</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="parentid">parentId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-3">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addMapEntry"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  childType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addArrayEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="childtype-1">childType</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">childType</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">FieldType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="parentid-1">parentId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">parentId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-4">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addArrayEntry"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"remove"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="nodeid-3">nodeId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-5">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"remove"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-6">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  data</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"replaceData"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="data">data</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">data</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-7">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"replaceData"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touch"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="nodeid-4">nodeId</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">nodeId</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-8">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touch"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Mark one node touched (dispatched on blur). Doesn’t change any
+value — only gates error display for consumers that check it.</p>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touchAll"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-9">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"touchAll"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Mark every node touched (dispatched on a submit attempt), so
+errors that were hidden pre-interaction all surface at once.</p>
+<hr>
+<p><a id="fieldeditorregistry"></a></p>
+<h3 id="fieldeditorregistry">FieldEditorRegistry</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> FieldEditorRegistry</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> Partial</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">FieldEditorContract</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">>>>;</span></span></code></pre>
+<p>Map of field-type to editor contract. <code>Partial&#x3C;…></code> so consumers
+can override one type without re-supplying the rest — the merge
+happens at the <code>&#x3C;DocumentPreview></code> boundary.</p>
+<p>The stored value type is <code>FieldEditorContract&#x3C;any></code> rather than
+<code>FieldEditorContract&#x3C;unknown></code> because each per-type contract
+narrows its generic (e.g., <code>FieldEditorContract&#x3C;Timestamp></code> for
+timestamp) and TypeScript’s <code>ComponentType</code> is invariant in
+props. <code>any</code> at the registry layer means the type-safety lives
+at the per-contract definition site, not in the dispatch map.
+<code>FieldRenderer</code> narrows back from <code>unknown</code> -> the right contract
+via <code>inferType</code> at dispatch time.</p>
+<hr>
+<p><a id="fieldtype"></a></p>
+<h3 id="fieldtype">FieldType</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> FieldType</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"string"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"number"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"boolean"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"null"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"timestamp"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"geopoint"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"reference"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"bytes"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"map"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"array"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"vector"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The set of value types <code>@pyric/ui</code> knows how to display + edit.
+Maps 1:1 to Firestore’s serializable value shapes; consumers can
+extend the registry but the built-in editors cover these.</p>
+<hr>
+<p><a id="firestoreapi"></a></p>
+<h3 id="firestoreapi">FirestoreApi</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> FirestoreApi</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> Pick</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"addDoc"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"collection"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"deleteDoc"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"doc"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"getDoc"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"getDocs"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"limit"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"onSnapshot"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"query"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"setDoc"</span></span>
+<span class="line"><span style="color:#ABB2BF">| </span><span style="color:#98C379">"startAfter"</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>The modular Firestore functions the data hooks call, as an INJECTABLE bundle.</p>
+<p>WHY: the hooks default to the in-process <code>pyric/firestore</code> API, but Pyric
+Studio’s served mode drives the SAME ops over a SharedWorker via a PARALLEL
+modular client (<code>@pyric/cli/serve/worker</code>: its own <code>collection</code>/<code>getDocs</code>/…
+over a <code>MessagePort</code>, and a <code>ClientDb</code> that is not a <code>pyric/firestore</code>
+<code>Firestore</code>). Statically importing the in-process fns hardwires the hooks to
+the in-page sandbox; reading them from this context lets a consumer inject the
+worker client’s fns so the hooks operate on the live worker backend without
+the hooks (or the components) knowing which backend they hit.</p>
+<p>The bundle is typed to the in-process signatures. A worker bundle is adapted
+(cast) to this shape at the Studio boundary: the worker handles + snapshots
+are runtime-compatible at the surface the hooks use (<code>.id</code> / <code>.data()</code> /
+<code>.docs</code> / <code>.ref</code>), which is the contract function-injection relies on.</p>
+<p>Default = the real <code>pyric/firestore</code> fns, so every existing consumer (the
+dev-seed review build, tests, any app embedding <code>@pyric/ui</code>) is unchanged: no
+provider needed unless you are swapping the backend.</p>
+<hr>
+<p><a id="listsubcollections-2"></a></p>
+<h3 id="listsubcollections">ListSubcollections()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> ListSubcollections</span><span style="color:#56B6C2"> =</span><span style="color:#ABB2BF"> (</span><span style="color:#E06C75;font-style:italic">firestore</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Firestore</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">parent</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentReference</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#E5C07B"> Promise</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">CollectionReference</span><span style="color:#ABB2BF">[]>;</span></span></code></pre>
+<p>Lister for a document’s own subcollections. Same injected-lister
+shape as <code>useCollectionList</code> / <code>ReferencePicker</code> use — the modular
+Web SDK doesn’t expose a native <code>listCollections</code> on the client, so
+the caller wires it (sandbox in-process listing, a server proxy, or
+a known schema list).</p>
+<h4 id="parameters">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>firestore</code></td><td align="left"><code>Firestore</code></td></tr><tr><td align="left"><code>parent</code></td><td align="left"><code>DocumentReference</code></td></tr></tbody></table></div>
+<h4 id="returns">Returns</h4>
+<p><code>Promise</code>&#x3C;<code>CollectionReference</code>[]></p>
+<hr>
+<p><a id="queryop"></a></p>
+<h3 id="queryop">QueryOp</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> QueryOp</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> WhereFilterOp</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="usequerybuilderresult"></a></p>
+<h3 id="usequerybuilderresult">UseQueryBuilderResult</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">type</span><span style="color:#E5C07B"> UseQueryBuilderResult</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> QueryBuilderState</span><span style="color:#ABB2BF"> &#x26; </span><span style="color:#E5C07B">QueryBuilderActions</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h2 id="variables">Variables</h2>
+<p><a id="defaultfieldeditors"></a></p>
+<h3 id="defaultfieldeditors">defaultFieldEditors</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> defaultFieldEditors</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldEditorRegistry</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Default registry. Covers every <a href="#fieldtype">FieldType</a>. Consumers extend
+or override by passing their own (partial) registry into
+<code>&#x3C;DocumentPreview></code> / <code>&#x3C;FieldRenderer></code> — the components merge
+overrides into these defaults so a consumer can swap just one
+editor without re-declaring the rest.</p>
+<hr>
+<p><a id="documenteditor"></a></p>
+<h3 id="documenteditor">DocumentEditor</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> DocumentEditor</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  Fields</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">typeof</span><span style="color:#E06C75"> DocumentEditorFields</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  Root</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">typeof</span><span style="color:#E06C75"> DocumentEditorRoot</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Compound root export. Consumers pattern-match via dot access:</p>
+<p>&#x3C;DocumentEditor.Root initial={data} onChange={…}>
+&#x3C;DocumentEditor.Fields />
+&#x3C;/DocumentEditor.Root></p>
+<h4 id="type-declaration-1">Type Declaration</h4>
+<p><a id="fields"></a></p>
+<h5 id="fields">Fields</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">Fields</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">typeof</span><span style="color:#E06C75"> DocumentEditorFields</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p><a id="root"></a></p>
+<h5 id="root">Root</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">Root</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">typeof</span><span style="color:#E06C75"> DocumentEditorRoot</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="multi_value_ops"></a></p>
+<h3 id="multi_value_ops">MULTI_VALUE_OPS</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> MULTI_VALUE_OPS</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReadonlySet</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">QueryOp</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Ops that accept an array of values. The value editor in the
+bundled <querybuilder> parses the input as JSON for these.</querybuilder></p>
+<hr>
+<p><a id="query_ops"></a></p>
+<h3 id="query_ops">QUERY_OPS</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">const</span><span style="color:#E5C07B"> QUERY_OPS</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> QueryOp</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<h2 id="functions">Functions</h2>
+<p><a id="asvectorview"></a></p>
+<h3 id="asvectorview">asVectorView()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> asVectorView</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">VectorView</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Detect + normalize a Firestore vector value, or return <code>null</code> if the
+value isn’t a vector. Vectors reach <code>@pyric/ui</code> in several runtime
+shapes depending on the backend the snapshot came from — there is no
+single <code>VectorValue</code> class <code>pyric/firestore</code> re-exports, so we match
+structurally (the same strategy isDocumentReferenceShape uses
+for refs):</p>
+<ol>
+<li><strong>pyric <code>Vector</code> wrapper</strong> — frozen <code>.value: number[]</code> array plus
+a <code>.dimension</code> getter (sandbox / rules-side reads).</li>
+<li><strong>firebase/firestore (web) <code>VectorValue</code></strong> — exposes <code>.toArray()</code>
+and nothing else publicly.</li>
+<li><strong>firebase-admin <code>VectorValue</code></strong> — internal <code>._values: number[]</code>
+(also a <code>.toArray()</code>).</li>
+<li><strong>wire sentinel</strong> — <code>{ __type__: '__vector__', value: number[] }</code>,
+the plain-object encoded form a discover crawler / seed emits.</li>
+</ol>
+<p>A bare <code>number[]</code> is intentionally NOT a vector — those stay <code>array</code>.
+Only the typed/branded shapes above match.</p>
+<h4 id="parameters-1">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-1">Returns</h4>
+<p><a href="#vectorview"><code>VectorView</code></a></p>
+<hr>
+<p><a id="collectionlist"></a></p>
+<h3 id="collectionlist">CollectionList()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> CollectionList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CollectionListProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless collection list. Takes a pre-fetched array of references
+(from <code>useCollectionList</code>) plus a select callback. Renders one
+row per collection with <code>data-pyric-collection-id</code> for styling
+and testing. The library does not own the data fetch — the hook
+does — so this component is a thin presentational layer.</p>
+<h4 id="parameters-2">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#collectionlistprops"><code>CollectionListProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-2">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="deletewithconfirm"></a></p>
+<h3 id="deletewithconfirm">DeleteWithConfirm()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> DeleteWithConfirm</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DeleteWithConfirmProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Composition that wires <code>useConfirm</code> + <code>useRecursiveDelete</code>. Requires
+a <code>&#x3C;ConfirmProvider></code> ancestor.</p>
+<p>The default trigger renders a plain <code>&#x3C;button></code> carrying the
+destructive intent (the consumer styles via <code>[data-pyric-destructive]</code>).
+Consumers wanting different chrome pass <code>renderTrigger</code>.</p>
+<h4 id="parameters-3">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#deletewithconfirmprops"><code>DeleteWithConfirmProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-3">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="detectcollisions"></a></p>
+<h3 id="detectcollisions">detectCollisions()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> detectCollisions</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">existingIds</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> string</span><span style="color:#ABB2BF">[], </span><span style="color:#E06C75;font-style:italic">docs</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> ParsedImportDoc</span><span style="color:#ABB2BF">[]): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>Ids in <code>docs</code> (map-shape entries only — <code>id !== null</code>) that already exist
+in <code>existingIds</code>. The UI shows the skip-or-overwrite policy choice ONLY
+when this returns a non-empty list.</p>
+<h4 id="parameters-4">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>existingIds</code></td><td align="left">readonly <code>string</code>[]</td></tr><tr><td align="left"><code>docs</code></td><td align="left">readonly <a href="#parsedimportdoc"><code>ParsedImportDoc</code></a>[]</td></tr></tbody></table></div>
+<h4 id="returns-4">Returns</h4>
+<p><code>string</code>[]</p>
+<hr>
+<p><a id="documenteditorfields-1"></a></p>
+<h3 id="documenteditorfields">DocumentEditorFields()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> DocumentEditorFields</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Renders the top-level fields of the document. For finer control,
+a consumer can call <code>useDocumentEditorContext()</code> and render the
+tree themselves.</p>
+<h4 id="returns-5">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="documenteditorroot-1"></a></p>
+<h3 id="documenteditorroot">DocumentEditorRoot()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> DocumentEditorRoot</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentEditorRootProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Wires the <code>useDocumentEditor</code> hook + field-editor registry into a
+React context so <code>&#x3C;DocumentEditor.Fields></code> and <code>&#x3C;DocumentEditor.AddField></code>
+can render the tree without prop drilling.</p>
+<p>Pattern: hook + compound component. Consumers wanting full control
+over the layout call <code>useDocumentEditor</code> directly and render their
+own tree; consumers wanting the default rendering use this.</p>
+<h4 id="parameters-5">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#documenteditorrootprops"><code>DocumentEditorRootProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-6">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="documentlist"></a></p>
+<h3 id="documentlist">DocumentList()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> DocumentList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentListProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless document list. Below <code>virtualizeThreshold</code>, renders a
+plain <code>&#x3C;ul></code>; above it, switches to TanStack-Virtual via
+<code>&#x3C;VirtualList></code> so 10k-doc collections don’t bloat the DOM.</p>
+<p>The hook owns pagination state; this component just renders. The
+Load More button only renders when <code>hasMore</code> is true AND
+<code>onLoadMore</code> is provided. Consumers wanting infinite scroll
+trigger <code>onLoadMore</code> from a sentinel <code>IntersectionObserver</code> in
+their own code — the component doesn’t bake that policy in.</p>
+<h4 id="parameters-6">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#documentlistprops"><code>DocumentListProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-7">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="documentpreview"></a></p>
+<h3 id="documentpreview">DocumentPreview()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> DocumentPreview</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentPreviewProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>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.</p>
+<p>Headless — no shipped CSS. Consumers style via <code>className</code> on the
+root and <code>[data-pyric-field-type]</code> / <code>[data-pyric-field-path]</code>
+attribute selectors on the per-field nodes.</p>
+<p>Editing arrives in M3 (<code>&#x3C;DocumentEditor></code>). M2 only displays.</p>
+<h4 id="parameters-7">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#documentpreviewprops"><code>DocumentPreviewProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-8">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="fieldrenderer"></a></p>
+<h3 id="fieldrenderer">FieldRenderer()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> FieldRenderer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldRendererProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>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.</p>
+<h4 id="parameters-8">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#fieldrendererprops"><code>FieldRendererProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-9">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="firestoreapiprovider"></a></p>
+<h3 id="firestoreapiprovider">FirestoreApiProvider()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> FirestoreApiProvider</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  children</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReactNode</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FirestoreApi</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E5C07B">FunctionComponentElement</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">ProviderProps</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">FirestoreApi</span><span style="color:#ABB2BF">>>;</span></span></code></pre>
+<p>Provide a Firestore API bundle to the subtree. Pyric Studio wraps its data
+surface with this, supplying the in-process bundle for dev-seed review and the
+SharedWorker client bundle under <code>pyric dev --ui</code>.</p>
+<h4 id="parameters-9">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left">{ <code>children</code>: <code>ReactNode</code>; <code>value</code>: <a href="#firestoreapi"><code>FirestoreApi</code></a>; }</td></tr><tr><td align="left"><code>__namedParameters.children</code></td><td align="left"><code>ReactNode</code></td></tr><tr><td align="left"><code>__namedParameters.value</code></td><td align="left"><a href="#firestoreapi"><code>FirestoreApi</code></a></td></tr></tbody></table></div>
+<h4 id="returns-10">Returns</h4>
+<p><code>FunctionComponentElement</code>&#x3C;<code>ProviderProps</code>&#x3C;<a href="#firestoreapi"><code>FirestoreApi</code></a>>></p>
+<hr>
+<p><a id="firestoreautoid"></a></p>
+<h3 id="firestoreautoid">firestoreAutoId()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> firestoreAutoId</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>A Firestore-style 20-char auto id (same alphabet/length the SDK uses).</p>
+<h4 id="returns-11">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="firestorevaluesequal"></a></p>
+<h3 id="firestorevaluesequal">firestoreValuesEqual()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> firestoreValuesEqual</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">previous</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">next</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Firestore-aware structural equality for values delivered by either the
+in-process SDK or the SharedWorker serializer.</p>
+<h4 id="parameters-10">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>previous</code></td><td align="left"><code>unknown</code></td></tr><tr><td align="left"><code>next</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-12">Returns</h4>
+<p><code>boolean</code></p>
+<hr>
+<p><a id="infertype"></a></p>
+<h3 id="infertype">inferType()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> inferType</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Runtime-classify a value into one of the <a href="#fieldtype">FieldType</a>s.</p>
+<p>The discrimination order matters:</p>
+<ul>
+<li><code>null</code> checked before <code>typeof === 'object'</code> (null is an object)</li>
+<li>vector (a typed embedding wrapper) checked before <code>Array.isArray</code>
+and before generic objects — its wire-sentinel shape is a plain
+object, and a bare <code>number[]</code> must stay <code>array</code>, not <code>vector</code></li>
+<li><code>Array.isArray</code> checked before generic objects</li>
+<li>Firestore special types (Timestamp/GeoPoint/Bytes/DocumentRef)
+checked before falling through to <code>map</code></li>
+</ul>
+<p><code>undefined</code> values aren’t legal Firestore field values; we coerce
+them to <code>'null'</code> rather than throw — the caller can decide whether
+to display or filter.</p>
+<h4 id="parameters-11">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-13">Returns</h4>
+<p><a href="#fieldtype"><code>FieldType</code></a></p>
+<hr>
+<p><a id="initstate"></a></p>
+<h3 id="initstate">initState()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> initState</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">initial</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>): </span><span style="color:#E5C07B">DocumentEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Initial state factory. Builds tree + initial snapshot + error count.</p>
+<h4 id="parameters-12">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>initial</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
+<h4 id="returns-14">Returns</h4>
+<p><a href="#documenteditorstate"><code>DocumentEditorState</code></a></p>
+<hr>
+<p><a id="mergefieldeditors"></a></p>
+<h3 id="mergefieldeditors">mergeFieldEditors()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> mergeFieldEditors</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">override</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Partial</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">FieldEditorContract</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">>>>): </span><span style="color:#E5C07B">FieldEditorRegistry</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Merge a consumer-supplied registry over the defaults. <code>undefined</code>
+input returns the defaults as-is. Used internally by
+<code>&#x3C;DocumentPreview></code> so consumers don’t have to spread manually.</p>
+<h4 id="parameters-13">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>override</code></td><td align="left"><code>Partial</code>&#x3C;<code>Record</code>&#x3C;<a href="#fieldtype"><code>FieldType</code></a>, <a href="#fieldeditorcontract"><code>FieldEditorContract</code></a>&#x3C;<code>any</code>>>></td></tr></tbody></table></div>
+<h4 id="returns-15">Returns</h4>
+<p><a href="#fieldeditorregistry"><code>FieldEditorRegistry</code></a></p>
+<hr>
+<p><a id="parseimport"></a></p>
+<h3 id="parseimport">parseImport()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> parseImport</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">input</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ParseImportOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">ParseImportResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Parse raw JSON text into the documents it would create. Never throws —
+a JSON syntax error or a wrong top-level shape becomes an entry in
+<code>errors</code> with an empty <code>docs</code> array.</p>
+<h4 id="parameters-14">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>input</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#parseimportoptions"><code>ParseImportOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-16">Returns</h4>
+<p><a href="#parseimportresult"><code>ParseImportResult</code></a></p>
+<hr>
+<p><a id="querybuilder"></a></p>
+<h3 id="querybuilder">QueryBuilder()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> QueryBuilder</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">QueryBuilderProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Default visible composition over <code>useQueryBuilder</code>. Renders the
+condition list + orderBy + limit form. Headless — every node
+carries <code>data-pyric-*</code> for styling.</p>
+<p>Values are JSON-parsed on input. <code>42</code>, <code>"text"</code>, <code>true</code>, <code>null</code>,
+and <code>[1, 2, 3]</code> (for <code>in</code>/<code>not-in</code>/<code>array-contains-any</code>) 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.</p>
+<h4 id="parameters-15">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#querybuilderprops"><code>QueryBuilderProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-17">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="reducer"></a></p>
+<h3 id="reducer">reducer()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> reducer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentEditorState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">action</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DocumentEditorAction</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">DocumentEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Pure reducer. Every action returns a fresh state — no in-place
+mutation of <code>state.tree</code>. Validation re-runs after the structural
+change so <code>errorCount</code> is always current. Container nodes (map /
+array) ignore actions that don’t apply to them rather than
+throwing; the components only render valid affordances per type.</p>
+<h4 id="parameters-16">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>state</code></td><td align="left"><a href="#documenteditorstate"><code>DocumentEditorState</code></a></td></tr><tr><td align="left"><code>action</code></td><td align="left"><a href="#documenteditoraction"><code>DocumentEditorAction</code></a></td></tr></tbody></table></div>
+<h4 id="returns-18">Returns</h4>
+<p><a href="#documenteditorstate"><code>DocumentEditorState</code></a></p>
+<hr>
+<p><a id="referencepicker"></a></p>
+<h3 id="referencepicker">ReferencePicker()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> ReferencePicker</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReferencePickerProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Visible reference picker — text input + browseable panel.</p>
+<p>Two ways to commit a reference:</p>
+<ol>
+<li>Type a path, then click Commit (enabled only when the path
+parses to a valid <code>DocumentReference</code>).</li>
+<li>Drill into a collection in the panel and click a document
+row.</li>
+</ol>
+<p>Either path fires <code>onPick(ref)</code>. Headless — emits structural
+<code>data-pyric-*</code> for styling.</p>
+<h4 id="parameters-17">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#referencepickerprops"><code>ReferencePickerProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-19">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="treefromdata"></a></p>
+<h3 id="treefromdata">treeFromData()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> treeFromData</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">data</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>): </span><span style="color:#E5C07B">EditorTree</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Build a normalized editor tree from a Firestore-shaped object.
+The root node is a virtual <code>map</code> that holds the document’s
+top-level fields. Order of children mirrors <code>Object.entries</code> (the
+renderer is responsible for any sort it wants).</p>
+<h4 id="parameters-18">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>data</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td></tr></tbody></table></div>
+<h4 id="returns-20">Returns</h4>
+<p><a href="#editortree"><code>EditorTree</code></a></p>
+<hr>
+<p><a id="treetodata"></a></p>
+<h3 id="treetodata">treeToData()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> treeToData</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">tree</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">EditorTree</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Serialize a tree back to a Firestore-shaped object. Leaf values
+pass through unchanged (so a <code>Timestamp</code> round-trips as the same
+<code>Timestamp</code> instance). Maps recurse with their sorted keys; arrays
+recurse in <code>childIds</code> order.</p>
+<h4 id="parameters-19">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>tree</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td></tr></tbody></table></div>
+<h4 id="returns-21">Returns</h4>
+<p><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></p>
+<hr>
+<p><a id="truncatevectorsfordisplay"></a></p>
+<h3 id="truncatevectorsfordisplay">truncateVectorsForDisplay()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> truncateVectorsForDisplay</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Deep-replace any vector-shaped value with a compact preview STRING, so the
+result can be <code>JSON.stringify</code>’d / formatted without dumping full embeddings.
+Recurses plain objects + arrays; class instances (Timestamp/GeoPoint) and
+scalars pass through untouched. Vector instances/sentinels are caught first.</p>
+<h4 id="parameters-20">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-22">Returns</h4>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="usecollectionlist"></a></p>
+<h3 id="usecollectionlist">useCollectionList()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useCollectionList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseCollectionListOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseCollectionListResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Operational read + create for collections under a parent (or root).
+Listing is injected because the modular Web SDK doesn’t expose a
+native <code>listCollections</code> on the client — see options docs.</p>
+<h4 id="parameters-21">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#usecollectionlistoptions"><code>UseCollectionListOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-23">Returns</h4>
+<p><a href="#usecollectionlistresult"><code>UseCollectionListResult</code></a></p>
+<hr>
+<p><a id="usedocumenteditor"></a></p>
+<h3 id="usedocumenteditor">useDocumentEditor()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useDocumentEditor</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseDocumentEditorOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseDocumentEditorResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless document editor. Owns the entire edit state for one
+document via a pure reducer. Consumers either render the bundled
+<code>&#x3C;DocumentEditor></code> compound component over this hook, or render
+their own tree using the returned state.</p>
+<p>The hook builds its tree from <code>initial</code> on first mount. Changing
+<code>initial</code> later does NOT rebuild the tree; live viewers explicitly call
+<code>replaceData()</code> when a newer snapshot should become the clean baseline.
+This matches the firebase-tools-ui pattern of treating the editor as a
+stateful workspace while still allowing snapshot-driven reconciliation.</p>
+<h4 id="parameters-22">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usedocumenteditoroptions"><code>UseDocumentEditorOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-24">Returns</h4>
+<p><a href="#usedocumenteditorresult"><code>UseDocumentEditorResult</code></a></p>
+<hr>
+<p><a id="usedocumenteditorcontext"></a></p>
+<h3 id="usedocumenteditorcontext">useDocumentEditorContext()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useDocumentEditorContext</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">UseDocumentEditorResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Read access to the underlying editor state from inside a Root.</p>
+<h4 id="returns-25">Returns</h4>
+<p><a href="#usedocumenteditorresult"><code>UseDocumentEditorResult</code></a></p>
+<hr>
+<p><a id="usedocumentlist"></a></p>
+<h3 id="usedocumentlist">useDocumentList()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useDocumentList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseDocumentListOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseDocumentListResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Paginated document list with two acquisition strategies. The default
+<code>paged</code> mode uses <code>startAfter</code> and accumulates one-shot reads. <code>live</code> keeps
+the requested prefix under one <code>onSnapshot</code> listener; loading more grows
+that prefix and establishes a new subscription baseline.</p>
+<h4 id="parameters-23">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#usedocumentlistoptions"><code>UseDocumentListOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-26">Returns</h4>
+<p><a href="#usedocumentlistresult"><code>UseDocumentListResult</code></a></p>
+<hr>
+<p><a id="usedocumentsubcollections"></a></p>
+<h3 id="usedocumentsubcollections">useDocumentSubcollections()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useDocumentSubcollections</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseDocumentSubcollectionsOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseDocumentSubcollectionsResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Read a single document’s subcollection list. A thin specialization of
+the <code>useCollectionList</code> pattern, scoped to one parent document and
+read-only (no create — that lives in <code>useCollectionList</code>).</p>
+<h4 id="parameters-24">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#usedocumentsubcollectionsoptions"><code>UseDocumentSubcollectionsOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-27">Returns</h4>
+<p><a href="#usedocumentsubcollectionsresult"><code>UseDocumentSubcollectionsResult</code></a></p>
+<hr>
+<p><a id="usefirestoreapi"></a></p>
+<h3 id="usefirestoreapi">useFirestoreApi()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useFirestoreApi</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">FirestoreApi</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Read the active Firestore API bundle (defaults to in-process <code>pyric/firestore</code>).</p>
+<h4 id="returns-28">Returns</h4>
+<p><a href="#firestoreapi"><code>FirestoreApi</code></a></p>
+<hr>
+<p><a id="usefirestorecollection"></a></p>
+<h3 id="usefirestorecollection">useFirestoreCollection()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useFirestoreCollection</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">query</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">SubscriptionState</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">QuerySnapshot</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Subscribe to a Firestore query (a <code>Query</code> from <code>pyric/firestore</code>’s
+modular surface, including any <code>CollectionReference</code>, which extends
+<code>Query</code>). Returns <code>{ data, error, isLoading }</code>.</p>
+<p>Null/undefined query short-circuits to idle. Cleanup is automatic
+on unmount or query change. <code>Query</code> objects don’t have a stable
+structural identity, so the consumer must memoize at the call site
+— pass the same instance across renders to avoid re-subscribing.</p>
+<h4 id="parameters-25">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>query</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
+<h4 id="returns-29">Returns</h4>
+<p><a href="#subscriptionstate"><code>SubscriptionState</code></a>&#x3C;<code>QuerySnapshot</code>></p>
+<hr>
+<p><a id="usefirestoredoc"></a></p>
+<h3 id="usefirestoredoc">useFirestoreDoc()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useFirestoreDoc</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">ref</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">SubscriptionState</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">DocumentSnapshot</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Subscribe to a single Firestore document. Returns <code>{ data, error, isLoading }</code>. Null/undefined ref short-circuits to an idle state
+(<code>data: undefined, error: undefined, isLoading: false</code>) — useful
+for conditional rendering before a ref is known.</p>
+<p>Cleanup is automatic on unmount or ref change. Memoize the ref at
+the call site; this hook’s effect re-runs on identity change.</p>
+<h4 id="parameters-26">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>ref</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
+<h4 id="returns-30">Returns</h4>
+<p><a href="#subscriptionstate"><code>SubscriptionState</code></a>&#x3C;<code>DocumentSnapshot</code>></p>
+<hr>
+<p><a id="usequerybuilder"></a></p>
+<h3 id="usequerybuilder">useQueryBuilder()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useQueryBuilder</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseQueryBuilderOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseQueryBuilderResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless query-builder state machine. Single-level — no nested
+<code>and()</code>/<code>or()</code> groups in v1. Consumers compose the state into a
+Firestore <code>Query</code> via <code>buildQuery(base)</code> and feed that into
+<code>useDocumentList</code> / <code>useFirestoreCollection</code>.</p>
+<h4 id="parameters-27">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usequerybuilderoptions"><code>UseQueryBuilderOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-31">Returns</h4>
+<p><a href="#usequerybuilderresult"><code>UseQueryBuilderResult</code></a></p>
+<hr>
+<p><a id="userecursivedelete"></a></p>
+<h3 id="userecursivedelete">useRecursiveDelete()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useRecursiveDelete</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">impl</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RecursiveDeleteImpl</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseRecursiveDeleteResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Drive a <a href="#recursivedeleteimpl">RecursiveDeleteImpl</a> from a React component. Tracks
+progress + running state so the consumer can render a progress
+indicator. Errors are caught and surfaced via the returned state,
+not thrown.</p>
+<p>Stale-run protection: if the component remounts (or the user
+cancels and starts a new run) before a previous iteration
+finishes, the older run’s progress updates are dropped via a
+generation token.</p>
+<h4 id="parameters-28">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>impl</code></td><td align="left"><a href="#recursivedeleteimpl"><code>RecursiveDeleteImpl</code></a></td></tr></tbody></table></div>
+<h4 id="returns-32">Returns</h4>
+<p><a href="#userecursivedeleteresult"><code>UseRecursiveDeleteResult</code></a></p>
+<hr>
+<p><a id="usereferencepicker"></a></p>
+<h3 id="usereferencepicker">useReferencePicker()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> useReferencePicker</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseReferencePickerOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseReferencePickerResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Picker state machine. Browses a Firestore tree level-by-level
+(root → collection → document → collection → …), maintains a
+separately-validated text-input path, and commits a chosen
+reference via <code>pick</code>.</p>
+<p>Headless — consumers compose the resulting state into their own
+UI, or use the bundled <code>&#x3C;ReferencePicker></code> component.</p>
+<h4 id="parameters-29">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#usereferencepickeroptions"><code>UseReferencePickerOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-33">Returns</h4>
+<p><a href="#usereferencepickerresult"><code>UseReferencePickerResult</code></a></p>
+<hr>
+<p><a id="validatecollectionid"></a></p>
+<h3 id="validatecollectionid">validateCollectionId()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> validateCollectionId</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">id</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Validate a collection id. Returns an error message, or <code>undefined</code> when valid.</p>
+<h4 id="parameters-30">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>id</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-34">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="validatedocumentid"></a></p>
+<h3 id="validatedocumentid">validateDocumentId()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> validateDocumentId</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">id</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Validate a document id. Returns an error message, or <code>undefined</code> when valid.</p>
+<h4 id="parameters-31">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>id</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-35">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="validateleaf"></a></p>
+<h3 id="validateleaf">validateLeaf()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> validateLeaf</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">type</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FieldType</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Per-type leaf validator. Returns an error message when the value
+doesn’t satisfy the type’s constraints, <code>undefined</code> when valid.</p>
+<p><code>map</code> and <code>array</code> aren’t validated here — their integrity comes
+from their children + (for maps) sibling-key uniqueness, which
+is enforced in <a href="#validatetree">validateTree</a>.</p>
+<h4 id="parameters-32">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>type</code></td><td align="left"><a href="#fieldtype"><code>FieldType</code></a></td></tr><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-36">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="validatetree"></a></p>
+<h3 id="validatetree">validateTree()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> validateTree</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">tree</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">EditorTree</span><span style="color:#ABB2BF">): {</span></span>
+<span class="line"><span style="color:#E06C75">  errorCount</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  tree</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">EditorTree</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Walk the tree, attach an <code>error</code> to each node, and return the
+mutated tree along with the total error count. The function does
+not mutate the input; it returns a fresh tree.</p>
+<p>Per-leaf errors come from <a href="#validateleaf">validateLeaf</a>. Map nodes
+additionally surface duplicate-key + empty-key errors on the
+offending children (not on the parent).</p>
+<h4 id="parameters-33">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>tree</code></td><td align="left"><a href="#editortree"><code>EditorTree</code></a></td></tr></tbody></table></div>
+<h4 id="returns-37">Returns</h4>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  errorCount</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  tree</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">EditorTree</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="errorcount">errorCount</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">errorCount</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="tree">tree</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">tree</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">EditorTree</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="vectorpreview"></a></p>
+<h3 id="vectorpreview">vectorPreview()</h3>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#C678DD">function</span><span style="color:#61AFEF"> vectorPreview</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">view</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">VectorView</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Compact, display-safe rendering of a vector: <code>vector · &#x3C;dim> [a, b, c, …]</code>.
+So a real embedding never dumps its full array into a diff, a rules trace, or
+a debugger panel.</p>
+<h4 id="parameters-34">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>view</code></td><td align="left"><a href="#vectorview"><code>VectorView</code></a></td></tr></tbody></table></div>
+<h4 id="returns-38">Returns</h4>
+<p><code>string</code></p>  </article> </main> <aside class="doc-toc api-symbols" aria-label="API symbols"> <h2 class="doc-toc-heading">Symbols</h2> <input class="api-symbol-filter" type="search" placeholder="Filter symbols" aria-label="Filter API symbols" data-api-symbol-filter> <div class="api-symbol-groups" data-api-symbol-groups> <section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="collectionlistprops"> <a href="#collectionlistprops">CollectionListProps</a> </li><li data-api-symbol="deletewithconfirmprops"> <a href="#deletewithconfirmprops">DeleteWithConfirmProps</a> </li><li data-api-symbol="documenteditorrootprops"> <a href="#documenteditorrootprops">DocumentEditorRootProps</a> </li><li data-api-symbol="documenteditorstate"> <a href="#documenteditorstate">DocumentEditorState</a> </li><li data-api-symbol="documentlistprops"> <a href="#documentlistprops">DocumentListProps</a> </li><li data-api-symbol="documentpreviewprops"> <a href="#documentpreviewprops">DocumentPreviewProps</a> </li><li data-api-symbol="editortree"> <a href="#editortree">EditorTree</a> </li><li data-api-symbol="fielddisplayprops"> <a href="#fielddisplayprops">FieldDisplayProps</a> </li><li data-api-symbol="fieldeditorcontract"> <a href="#fieldeditorcontract">FieldEditorContract</a> </li><li data-api-symbol="fieldeditprops"> <a href="#fieldeditprops">FieldEditProps</a> </li><li data-api-symbol="fieldnode"> <a href="#fieldnode">FieldNode</a> </li><li data-api-symbol="fieldrendererprops"> <a href="#fieldrendererprops">FieldRendererProps</a> </li><li data-api-symbol="parsedimportdoc"> <a href="#parsedimportdoc">ParsedImportDoc</a> </li><li data-api-symbol="parseimportoptions"> <a href="#parseimportoptions">ParseImportOptions</a> </li><li data-api-symbol="parseimportresult"> <a href="#parseimportresult">ParseImportResult</a> </li><li data-api-symbol="querybuilderactions"> <a href="#querybuilderactions">QueryBuilderActions</a> </li><li data-api-symbol="querybuilderprops"> <a href="#querybuilderprops">QueryBuilderProps</a> </li><li data-api-symbol="querybuilderstate"> <a href="#querybuilderstate">QueryBuilderState</a> </li><li data-api-symbol="querycondition"> <a href="#querycondition">QueryCondition</a> </li><li data-api-symbol="recursivedeleteimpl"> <a href="#recursivedeleteimpl">RecursiveDeleteImpl</a> </li><li data-api-symbol="recursivedeleteprogress"> <a href="#recursivedeleteprogress">RecursiveDeleteProgress</a> </li><li data-api-symbol="referencepickerprops"> <a href="#referencepickerprops">ReferencePickerProps</a> </li><li data-api-symbol="subscriptionstate"> <a href="#subscriptionstate">SubscriptionState</a> </li><li data-api-symbol="usecollectionlistoptions"> <a href="#usecollectionlistoptions">UseCollectionListOptions</a> </li><li data-api-symbol="usecollectionlistresult"> <a href="#usecollectionlistresult">UseCollectionListResult</a> </li><li data-api-symbol="usedocumenteditoroptions"> <a href="#usedocumenteditoroptions">UseDocumentEditorOptions</a> </li><li data-api-symbol="usedocumenteditorresult"> <a href="#usedocumenteditorresult">UseDocumentEditorResult</a> </li><li data-api-symbol="usedocumentlistoptions"> <a href="#usedocumentlistoptions">UseDocumentListOptions</a> </li><li data-api-symbol="usedocumentlistresult"> <a href="#usedocumentlistresult">UseDocumentListResult</a> </li><li data-api-symbol="usedocumentsubcollectionsoptions"> <a href="#usedocumentsubcollectionsoptions">UseDocumentSubcollectionsOptions</a> </li><li data-api-symbol="usedocumentsubcollectionsresult"> <a href="#usedocumentsubcollectionsresult">UseDocumentSubcollectionsResult</a> </li><li data-api-symbol="usequerybuilderoptions"> <a href="#usequerybuilderoptions">UseQueryBuilderOptions</a> </li><li data-api-symbol="userecursivedeleteresult"> <a href="#userecursivedeleteresult">UseRecursiveDeleteResult</a> </li><li data-api-symbol="usereferencepickeroptions"> <a href="#usereferencepickeroptions">UseReferencePickerOptions</a> </li><li data-api-symbol="usereferencepickerresult"> <a href="#usereferencepickerresult">UseReferencePickerResult</a> </li><li data-api-symbol="vectorview"> <a href="#vectorview">VectorView</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#type-aliases"> Type Aliases </a> <ul> <li data-api-symbol="browselocation"> <a href="#browselocation">BrowseLocation</a> </li><li data-api-symbol="documenteditoraction"> <a href="#documenteditoraction">DocumentEditorAction</a> </li><li data-api-symbol="fieldeditorregistry"> <a href="#fieldeditorregistry">FieldEditorRegistry</a> </li><li data-api-symbol="fieldtype"> <a href="#fieldtype">FieldType</a> </li><li data-api-symbol="firestoreapi"> <a href="#firestoreapi">FirestoreApi</a> </li><li data-api-symbol="listsubcollections()"> <a href="#listsubcollections">ListSubcollections()</a> </li><li data-api-symbol="queryop"> <a href="#queryop">QueryOp</a> </li><li data-api-symbol="usequerybuilderresult"> <a href="#usequerybuilderresult">UseQueryBuilderResult</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#variables"> Variables </a> <ul> <li data-api-symbol="defaultfieldeditors"> <a href="#defaultfieldeditors">defaultFieldEditors</a> </li><li data-api-symbol="documenteditor"> <a href="#documenteditor">DocumentEditor</a> </li><li data-api-symbol="multi_value_ops"> <a href="#multi_value_ops">MULTI_VALUE_OPS</a> </li><li data-api-symbol="query_ops"> <a href="#query_ops">QUERY_OPS</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#functions"> Functions </a> <ul> <li data-api-symbol="asvectorview()"> <a href="#asvectorview">asVectorView()</a> </li><li data-api-symbol="collectionlist()"> <a href="#collectionlist">CollectionList()</a> </li><li data-api-symbol="deletewithconfirm()"> <a href="#deletewithconfirm">DeleteWithConfirm()</a> </li><li data-api-symbol="detectcollisions()"> <a href="#detectcollisions">detectCollisions()</a> </li><li data-api-symbol="documenteditorfields()"> <a href="#documenteditorfields">DocumentEditorFields()</a> </li><li data-api-symbol="documenteditorroot()"> <a href="#documenteditorroot">DocumentEditorRoot()</a> </li><li data-api-symbol="documentlist()"> <a href="#documentlist">DocumentList()</a> </li><li data-api-symbol="documentpreview()"> <a href="#documentpreview">DocumentPreview()</a> </li><li data-api-symbol="fieldrenderer()"> <a href="#fieldrenderer">FieldRenderer()</a> </li><li data-api-symbol="firestoreapiprovider()"> <a href="#firestoreapiprovider">FirestoreApiProvider()</a> </li><li data-api-symbol="firestoreautoid()"> <a href="#firestoreautoid">firestoreAutoId()</a> </li><li data-api-symbol="firestorevaluesequal()"> <a href="#firestorevaluesequal">firestoreValuesEqual()</a> </li><li data-api-symbol="infertype()"> <a href="#infertype">inferType()</a> </li><li data-api-symbol="initstate()"> <a href="#initstate">initState()</a> </li><li data-api-symbol="mergefieldeditors()"> <a href="#mergefieldeditors">mergeFieldEditors()</a> </li><li data-api-symbol="parseimport()"> <a href="#parseimport">parseImport()</a> </li><li data-api-symbol="querybuilder()"> <a href="#querybuilder">QueryBuilder()</a> </li><li data-api-symbol="reducer()"> <a href="#reducer">reducer()</a> </li><li data-api-symbol="referencepicker()"> <a href="#referencepicker">ReferencePicker()</a> </li><li data-api-symbol="treefromdata()"> <a href="#treefromdata">treeFromData()</a> </li><li data-api-symbol="treetodata()"> <a href="#treetodata">treeToData()</a> </li><li data-api-symbol="truncatevectorsfordisplay()"> <a href="#truncatevectorsfordisplay">truncateVectorsForDisplay()</a> </li><li data-api-symbol="usecollectionlist()"> <a href="#usecollectionlist">useCollectionList()</a> </li><li data-api-symbol="usedocumenteditor()"> <a href="#usedocumenteditor">useDocumentEditor()</a> </li><li data-api-symbol="usedocumenteditorcontext()"> <a href="#usedocumenteditorcontext">useDocumentEditorContext()</a> </li><li data-api-symbol="usedocumentlist()"> <a href="#usedocumentlist">useDocumentList()</a> </li><li data-api-symbol="usedocumentsubcollections()"> <a href="#usedocumentsubcollections">useDocumentSubcollections()</a> </li><li data-api-symbol="usefirestoreapi()"> <a href="#usefirestoreapi">useFirestoreApi()</a> </li><li data-api-symbol="usefirestorecollection()"> <a href="#usefirestorecollection">useFirestoreCollection()</a> </li><li data-api-symbol="usefirestoredoc()"> <a href="#usefirestoredoc">useFirestoreDoc()</a> </li><li data-api-symbol="usequerybuilder()"> <a href="#usequerybuilder">useQueryBuilder()</a> </li><li data-api-symbol="userecursivedelete()"> <a href="#userecursivedelete">useRecursiveDelete()</a> </li><li data-api-symbol="usereferencepicker()"> <a href="#usereferencepicker">useReferencePicker()</a> </li><li data-api-symbol="validatecollectionid()"> <a href="#validatecollectionid">validateCollectionId()</a> </li><li data-api-symbol="validatedocumentid()"> <a href="#validatedocumentid">validateDocumentId()</a> </li><li data-api-symbol="validateleaf()"> <a href="#validateleaf">validateLeaf()</a> </li><li data-api-symbol="validatetree()"> <a href="#validatetree">validateTree()</a> </li><li data-api-symbol="vectorpreview()"> <a href="#vectorpreview">vectorPreview()</a> </li> </ul> </section> <p class="api-symbol-empty" data-api-symbol-empty hidden>No matching symbols</p> </div> </aside> </div> <script type="module">const a=document.querySelector("[data-api-symbol-filter]"),d=[...document.querySelectorAll("[data-api-symbol-group]")],n=document.querySelector("[data-api-symbol-empty]");a?.addEventListener("input",()=>{const t=a.value.trim().toLowerCase();let o=0;for(const i of d){let e=0;i.querySelectorAll("[data-api-symbol]").forEach(l=>{const r=!t||(l.dataset.apiSymbol??"").includes(t);l.hidden=!r,r&&e++}),i.hidden=e===0,o+=e}n&&(n.hidden=o>0)});</script> <script type="module">const s=new Map;document.querySelectorAll('.doc-toc a[href^="#"]').forEach(t=>s.set(decodeURIComponent(t.hash.slice(1)),t));if(s.size>0){const t=new Set,n=()=>{let o=null;for(const e of s.keys())if(t.has(e)){o=e;break}s.forEach((e,c)=>e.classList.toggle("active",c===o))},r=new IntersectionObserver(o=>{for(const e of o)e.isIntersecting?t.add(e.target.id):t.delete(e.target.id);n()},{rootMargin:"-72px 0px -60% 0px"});s.forEach((o,e)=>{const c=document.getElementById(e);c&&r.observe(c)})}</script> <script type="module">document.querySelector('.studio__nav [aria-current="page"]')?.scrollIntoView({block:"nearest",inline:"center"});</script> </body> </html>