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-rtdb-reference-api/index.html ADDED Viewed

@@ -0,0 +1,1388 @@
+<!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/rtdb · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/ui/rtdb."><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/rtdb</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/ui/rtdb</code></h1> <p class="api-reference-meta"> 42 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="rtdbapi"></a></p>
+<h3 id="rtdbapi">RtdbApi</h3>
+<p>The RTDB backend seam the viewer drives — an EXPLICIT bundle, not a context
+default. Unlike Firestore/Auth/Storage there is no in-process handle typed
+into <code>@pyric/ui</code>, so the consumer constructs the bundle and passes it to the
+hook/components directly (Studio wires it to the SharedWorker client’s
+admin-lens ops; data views are always admin — PRINCIPLES M3).</p>
+<h4 id="methods">Methods</h4>
+<p><a id="remove"></a></p>
+<h5 id="remove">remove()</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:#61AFEF">remove</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Delete the subtree at <code>path</code>.</p>
+<h6 id="parameters">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<p><a id="set"></a></p>
+<h5 id="set">set()</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:#61AFEF">set</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">unknown</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Promise</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#C678DD">void</span><span style="color:#56B6C2">></span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Replace the value at <code>path</code> (<code>null</code> deletes, RTDB semantics).</p>
+<h6 id="parameters-1">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h6 id="returns-1">Returns</h6>
+<p><code>Promise</code>&#x3C;<code>void</code>></p>
+<p><a id="subscribevalue"></a></p>
+<h5 id="subscribevalue">subscribeValue()</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:#61AFEF">subscribeValue</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75">   path</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">   next</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:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75">   error</span><span style="color:#C678DD">?:</span><span style="color:#ABB2BF"> (</span><span style="color:#E06C75;font-style:italic">err</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">) </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">): () </span><span style="color:#C678DD">=></span><span style="color:#C678DD"> void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Live value subscription at <code>path</code>: <code>next</code> fires with the subtree’s plain
+JSON value (<code>null</code> when absent) on subscribe and after every change.
+Returns the unsubscribe.</p>
+<h6 id="parameters-2">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>next</code></td><td align="left">(<code>value</code>: <code>unknown</code>) => <code>void</code></td></tr><tr><td align="left"><code>error?</code></td><td align="left">(<code>err</code>: <code>unknown</code>) => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-2">Returns</h6>
+<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 style="color:#E5C07B">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-3">Returns</h6>
+<p><code>void</code></p>
+<hr>
+<p><a id="rtdbcrumb"></a></p>
+<h3 id="rtdbcrumb">RtdbCrumb</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="label"></a> <code>label</code></td><td align="left"><code>string</code></td><td align="left">The path segment to display.</td></tr><tr><td align="left"><a id="path"></a> <code>path</code></td><td align="left"><code>string</code></td><td align="left">Absolute database path this crumb navigates to.</td></tr></tbody></table></div>
+<hr>
+<p><a id="rtdbpathbarprops"></a></p>
+<h3 id="rtdbpathbarprops">RtdbPathBarProps</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="classname"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="inputprefix"></a> <code>inputPrefix?</code></td><td align="left"><code>string</code></td><td align="left">Text shown before the input while editing (the non-editable URL part).</td></tr><tr><td align="left"><a id="onnavigate"></a> <code>onNavigate</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Fired with the parsed absolute path on crumb click or input submit.</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">Current absolute database path (<code>'/'</code> for root).</td></tr><tr><td align="left"><a id="rootlabel"></a> <code>rootLabel?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Root crumb label — the database/instance identity (e.g. the sandbox slug). Default <code>'/'</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="rtdbtreecontroller"></a></p>
+<h3 id="rtdbtreecontroller">RtdbTreeController</h3>
+<p>Everything a tree view needs: the reducer state plus path-addressed
+selectors and the expansion/paging commands. All paths are ABSOLUTE
+database paths.</p>
+<h4 id="properties-2">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="pagesize"></a> <code>pageSize</code></td><td align="left"><code>number</code></td></tr><tr><td align="left"><a id="state"></a> <code>state</code></td><td align="left"><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></td></tr></tbody></table></div>
+<h4 id="methods-1">Methods</h4>
+<p><a id="childrenat"></a></p>
+<h5 id="childrenat">childrenAt()</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:#61AFEF">childrenAt</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">RtdbVisibleChildren</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-3">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-4">Returns</h6>
+<p><a href="#rtdbvisiblechildren"><code>RtdbVisibleChildren</code></a></p>
+<p><a id="isexpanded"></a></p>
+<h5 id="isexpanded">isExpanded()</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:#61AFEF">isExpanded</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-4">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-5">Returns</h6>
+<p><code>boolean</code></p>
+<p><a id="showmore"></a></p>
+<h5 id="showmore">showMore()</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:#61AFEF">showMore</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-5">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-6">Returns</h6>
+<p><code>void</code></p>
+<p><a id="toggle"></a></p>
+<h5 id="toggle">toggle()</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:#61AFEF">toggle</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-6">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-7">Returns</h6>
+<p><code>void</code></p>
+<p><a id="updateat"></a></p>
+<h5 id="updateat">updateAt()</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:#61AFEF">updateAt</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">UpdateHighlight</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-7">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-8">Returns</h6>
+<p><code>UpdateHighlight</code></p>
+<p><a id="valueat"></a></p>
+<h5 id="valueat">valueAt()</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:#61AFEF">valueAt</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">unknown</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="parameters-8">Parameters</h6>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-9">Returns</h6>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="rtdbtreeprops"></a></p>
+<h3 id="rtdbtreeprops">RtdbTreeProps</h3>
+<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="api"></a> <code>api</code></td><td align="left"><a href="#rtdbapi"><code>RtdbApi</code></a></td><td align="left">Mutation backend (admin lens in Studio).</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">-</td></tr><tr><td align="left"><a id="onnavigate-1"></a> <code>onNavigate?</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Key-click navigation: re-roots the viewer at the clicked node (wire to the same path state as the path bar).</td></tr><tr><td align="left"><a id="rootlabel-1"></a> <code>rootLabel?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Label for the view-root row when the root is <code>'/'</code> — the database / instance identity. Default <code>'/'</code>.</td></tr><tr><td align="left"><a id="tree"></a> <code>tree</code></td><td align="left"><a href="#rtdbtreecontroller"><code>RtdbTreeController</code></a></td><td align="left">The live tree controller from <code>useRtdbTree</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="rtdbtreestate"></a></p>
+<h3 id="rtdbtreestate">RtdbTreeState</h3>
+<p>RTDB viewer tree state (pure reducer). The interaction form is the Firebase
+console / firebase-tools-ui data viewer: one view root (set by the path
+bar), expandable/collapsible descendants, and per-level paging for wide
+child lists.</p>
+<p>DATA-LOADING STRATEGY (documented decision): the worker protocol exposes
+<code>rtdb.get</code> / value subscriptions per PATH but no shallow or depth-limited
+reads — a read at a path always ships that path’s WHOLE subtree over the
+MessagePort. A per-expand fetch would therefore re-ship data the view-root
+read already delivered. So the viewer holds ONE live value subscription at
+the view root (realtime by construction) and makes RENDERING lazy instead:
+nodes below the root start collapsed and mount nothing until expanded, and
+an expanded level renders at most <code>pageSize</code> children until “show more”
+(console-style paging at 50, chosen over virtualization for its simplicity —
+it bounds the mounted DOM the same way). Cost is bounded by navigating the
+view root deeper, which is the path bar’s job.</p>
+<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="error"></a> <code>error</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="expanded"></a> <code>expanded</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>true</code>></td><td align="left">Expanded descendant paths (absolute). The view root itself is always expanded and is never in this set.</td></tr><tr><td align="left"><a id="pages"></a> <code>pages</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>number</code>></td><td align="left">Per-path shown-children override (absolute path → count). Absent means one page.</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">The view root — the absolute database path the path bar points at.</td></tr><tr><td align="left"><a id="status"></a> <code>status</code></td><td align="left"><code>"loading"</code> | <code>"live"</code> | <code>"error"</code></td><td align="left"><code>loading</code> until the first snapshot after a navigate; then <code>live</code>.</td></tr><tr><td align="left"><a id="value"></a> <code>value</code></td><td align="left"><code>unknown</code></td><td align="left">The subtree value AT <code>path</code> (plain JSON; <code>null</code> = nothing there).</td></tr></tbody></table></div>
+<hr>
+<p><a id="rtdbvisiblechildren"></a></p>
+<h3 id="rtdbvisiblechildren">RtdbVisibleChildren</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="entries"></a> <code>entries</code></td><td align="left">[<code>string</code>, <code>unknown</code>][]</td><td align="left">The children to render, in key order, capped at the shown count.</td></tr><tr><td align="left"><a id="hiddencount"></a> <code>hiddenCount</code></td><td align="left"><code>number</code></td><td align="left">How many more “show more” would reveal (0 = all shown).</td></tr><tr><td align="left"><a id="total"></a> <code>total</code></td><td align="left"><code>number</code></td><td align="left">Total direct children at this path.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usertdbtreeoptions"></a></p>
+<h3 id="usertdbtreeoptions">UseRtdbTreeOptions</h3>
+<h4 id="properties-6">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="pagesize-1"></a> <code>pageSize?</code></td><td align="left"><code>number</code></td><td align="left">Children rendered per level before “show more”. Default 50.</td></tr></tbody></table></div>
+<h2 id="type-aliases">Type Aliases</h2>
+<p><a id="rtdbeditorresult"></a></p>
+<h3 id="rtdbeditorresult">RtdbEditorResult</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"> RtdbEditorResult</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">true</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">  error</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">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">false</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<hr>
+<p><a id="rtdbeditortype"></a></p>
+<h3 id="rtdbeditortype">RtdbEditorType</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"> RtdbEditorType</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "string"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"number"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"boolean"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"json"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Inline value-editor logic (pure): the type select + text input pair used by
+the tree’s click-to-edit and add-child rows. Four author-facing types cover
+every RTDB value: string / number / boolean scalars, and <code>json</code> for
+objects/arrays/null (or any hand-written literal).</p>
+<hr>
+<p><a id="rtdbtreeaction"></a></p>
+<h3 id="rtdbtreeaction">RtdbTreeAction</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"> RtdbTreeAction</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  path</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">"navigate"</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">  path</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">"value"</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">  message</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">  path</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">"error"</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">  path</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">"toggle"</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">  path</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">"expand"</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">  path</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">"collapse"</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">  pageSize</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">  path</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">"show-more"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<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">  path</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">"navigate"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path">path</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">path</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">"navigate"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Path bar navigation: reset to a new view root.</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">  path</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">"value"</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="path-1">path</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">path</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">"value"</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>
+<p>A value snapshot arrived. <code>path</code> is the subscription’s view root — a
+snapshot from a superseded subscription (its path no longer the state’s)
+is ignored.</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">  message</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">  path</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">"error"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="message">message</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">message</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="path-2">path</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">path</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">"error"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The view-root subscription failed (same <code>path</code> guard as <code>value</code>).</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">  path</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">"toggle"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path-3">path</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">path</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">"toggle"</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">  path</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">"expand"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path-4">path</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">path</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">"expand"</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">  path</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">"collapse"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path-5">path</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">path</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">"collapse"</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">  pageSize</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">  path</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">"show-more"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="pagesize">pageSize</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">pageSize</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="path-6">path</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">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><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">"show-more"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Reveal one more page of children at <code>path</code>.</p>
+<h2 id="variables">Variables</h2>
+<p><a id="rtdb_default_page_size"></a></p>
+<h3 id="rtdb_default_page_size">RTDB_DEFAULT_PAGE_SIZE</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"> RTDB_DEFAULT_PAGE_SIZE</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">50</span><span style="color:#56B6C2"> =</span><span style="color:#D19A66"> 50</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Console-style child paging (Firebase console shows 50, then “show more”).</p>
+<hr>
+<p><a id="rtdb_editor_types"></a></p>
+<h3 id="rtdb_editor_types">RTDB_EDITOR_TYPES</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"> RTDB_EDITOR_TYPES</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> RtdbEditorType</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<h2 id="functions">Functions</h2>
+<p><a id="coercertdbeditorvalue"></a></p>
+<h3 id="coercertdbeditorvalue">coerceRtdbEditorValue()</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"> coerceRtdbEditorValue</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">type</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbEditorType</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">text</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbEditorResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Coerce the editor’s text under the selected type, or explain why not.</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>type</code></td><td align="left"><a href="#rtdbeditortype"><code>RtdbEditorType</code></a></td></tr><tr><td align="left"><code>text</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-10">Returns</h4>
+<p><a href="#rtdbeditorresult"><code>RtdbEditorResult</code></a></p>
+<hr>
+<p><a id="formatrtdbeditorvalue"></a></p>
+<h3 id="formatrtdbeditorvalue">formatRtdbEditorValue()</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"> formatRtdbEditorValue</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:#E06C75;font-style:italic">type</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbEditorType</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Seed the editor’s text field from the current value under a type.</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>value</code></td><td align="left"><code>unknown</code></td></tr><tr><td align="left"><code>type</code></td><td align="left"><a href="#rtdbeditortype"><code>RtdbEditorType</code></a></td></tr></tbody></table></div>
+<h4 id="returns-11">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="formatrtdbjson"></a></p>
+<h3 id="formatrtdbjson">formatRtdbJson()</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"> formatRtdbJson</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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-12">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="formatrtdbvaluelabel"></a></p>
+<h3 id="formatrtdbvaluelabel">formatRtdbValueLabel()</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"> formatRtdbValueLabel</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>Leaf value text, console style: strings quoted, primitives literal.
+Defensive on objects: never <code>String</code>-coerce (that’s <code>[object Object]</code>) —
+fall back to JSON. Object values should have been normalized/expanded away
+before reaching a leaf label; this keeps the label honest if one slips in.</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-13">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="hasrtdbchildren"></a></p>
+<h3 id="hasrtdbchildren">hasRtdbChildren()</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"> hasRtdbChildren</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">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Does this value render as a PARENT node (has child keys)? RTDB has no true
+arrays — an array is an object with numeric keys, and renders as one.</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-14">Returns</h4>
+<p><code>boolean</code></p>
+<hr>
+<p><a id="inferrtdbeditortype"></a></p>
+<h3 id="inferrtdbeditortype">inferRtdbEditorType()</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"> inferRtdbEditorType</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">RtdbEditorType</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The editor type a value opens under when clicked.</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-15">Returns</h4>
+<p><a href="#rtdbeditortype"><code>RtdbEditorType</code></a></p>
+<hr>
+<p><a id="initialrtdbtree"></a></p>
+<h3 id="initialrtdbtree">initialRtdbTree()</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"> initialRtdbTree</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-16">Returns</h4>
+<p><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></p>
+<hr>
+<p><a id="isrtdbobjectvalue"></a></p>
+<h3 id="isrtdbobjectvalue">isRtdbObjectValue()</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"> isRtdbObjectValue</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:#E06C75;font-style:italic">value</span><span style="color:#C678DD"> is</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-17">Returns</h4>
+<p><code>value is Record&#x3C;string, unknown></code></p>
+<hr>
+<p><a id="isrtdbpathexpanded"></a></p>
+<h3 id="isrtdbpathexpanded">isRtdbPathExpanded()</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"> isRtdbPathExpanded</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Is this absolute path expanded? The view root always is.</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>state</code></td><td align="left"><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-18">Returns</h4>
+<p><code>boolean</code></p>
+<hr>
+<p><a id="joinrtdbpath"></a></p>
+<h3 id="joinrtdbpath">joinRtdbPath()</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"> joinRtdbPath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">base</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">child</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>base</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>child</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-19">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="normalizertdbpath"></a></p>
+<h3 id="normalizertdbpath">normalizeRtdbPath()</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"> normalizeRtdbPath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</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>RTDB path + value helpers (pure). Paths are ALWAYS normalized to the
+<code>'/'</code>-rooted form (<code>'/'</code> for the root, <code>'/a/b'</code> otherwise) so every module in
+this package — the tree reducer, the path bar, the viewer components — agrees
+on what a path is.</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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-20">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="normalizertdbsnapshotvalue"></a></p>
+<h3 id="normalizertdbsnapshotvalue">normalizeRtdbSnapshotValue()</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"> normalizeRtdbSnapshotValue</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>Normalize a snapshot value to RTDB semantics before it enters tree state:
+an empty object IS null (RTDB has no empty containers — the server prunes
+them), so <code>{}</code> — and any object whose children all normalize away — becomes
+<code>null</code>. Without this, an empty database’s root value <code>{}</code> fails
+<code>hasRtdbChildren</code> and renders as a scalar leaf (<code>String({})</code> →
+<code>"[object Object]"</code>). Reuses the input object when nothing changed.</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-21">Returns</h4>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="parentrtdbpath"></a></p>
+<h3 id="parentrtdbpath">parentRtdbPath()</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"> parentRtdbPath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-22">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="parsertdbjson"></a></p>
+<h3 id="parsertdbjson">parseRtdbJson()</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"> parseRtdbJson</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">value</span><span style="color:#ABB2BF">: </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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>value</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-23">Returns</h4>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="parsertdbpathinput"></a></p>
+<h3 id="parsertdbpathinput">parseRtdbPathInput()</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"> parseRtdbPathInput</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">raw</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>Normalize raw path-input text to a database path. Tolerant of what people
+paste into a database URL bar:</p>
+<ul>
+<li>a plain path, with or without the leading slash (<code>rooms/r1</code>, <code>/rooms</code>)</li>
+<li>a full URL (<code>https://x.firebaseio.com/rooms/r1</code> → <code>/rooms/r1</code>)</li>
+<li>repeated/trailing slashes, surrounding whitespace</li>
+<li>a <code>?query</code> / <code>#hash</code> tail (dropped)
+Empty input is the root.</li>
+</ul>
+<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>raw</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-24">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="previewrtdbvalue"></a></p>
+<h3 id="previewrtdbvalue">previewRtdbValue()</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"> previewRtdbValue</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-25">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="relativertdbpath"></a></p>
+<h3 id="relativertdbpath">relativeRtdbPath()</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"> relativeRtdbPath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">base</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">target</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>The path of <code>target</code> RELATIVE to <code>base</code>, or <code>null</code> when <code>target</code> is not
+<code>base</code> or one of its descendants. <code>'/'</code> means “target IS base”. Lets the
+tree address nodes by absolute database path while the loaded value sits at
+the view root.</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>base</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>target</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-26">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="rtdbchildentries"></a></p>
+<h3 id="rtdbchildentries">rtdbChildEntries()</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"> rtdbChildEntries</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 style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">][];</span></span></code></pre>
+<p>Child entries sorted RTDB-console style: numeric-aware key order
+(<code>2</code> before <code>10</code>), then lexicographic.</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>value</code></td><td align="left"><code>unknown</code></td></tr></tbody></table></div>
+<h4 id="returns-27">Returns</h4>
+<p>[<code>string</code>, <code>unknown</code>][]</p>
+<hr>
+<p><a id="rtdbcrumbs"></a></p>
+<h3 id="rtdbcrumbs">rtdbCrumbs()</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"> rtdbCrumbs</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbCrumb</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>The non-root crumbs for a path, in order. <code>'/'</code> yields <code>[]</code> — the root crumb
+is the caller’s (it carries the database/instance label, not a segment).</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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-28">Returns</h4>
+<p><a href="#rtdbcrumb"><code>RtdbCrumb</code></a>[]</p>
+<hr>
+<p><a id="rtdbkeyinputerror"></a></p>
+<h3 id="rtdbkeyinputerror">rtdbKeyInputError()</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"> rtdbKeyInputError</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">key</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>Why a typed child key is unusable, or <code>null</code> when it’s fine. RTDB forbids
+<code>. $ # [ ] /</code> in keys (a <code>/</code> would silently create a nested path).</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>key</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-29">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="rtdbpathbar"></a></p>
+<h3 id="rtdbpathbar">RtdbPathBar()</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"> RtdbPathBar</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbPathBarProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The editable path bar of the RTDB viewer — the interaction form of the
+Firebase console / firebase-tools-ui database URL bar (clean-room
+adaptation): in DISPLAY mode the path renders as clickable crumbs
+(root → … → current) plus an edit affordance; EDIT mode swaps in a text
+input seeded with the current path — Enter navigates, Escape or blur
+cancels. Pasted full URLs and missing leading slashes are tolerated
+(<code>parseRtdbPathInput</code>).</p>
+<p>Headless. Consumers style via:</p>
+<ul>
+<li><code>[data-pyric-ui="rtdb-path-bar"]</code> — the root (<code>data-rtdb-editing</code> when editing)</li>
+<li><code>[data-rtdb-crumb]</code> / <code>[data-rtdb-crumb-root]</code> / <code>[data-pyric-current]</code></li>
+<li><code>[data-rtdb-crumb-separator]</code></li>
+<li><code>[data-rtdb-path-edit]</code> — the edit button</li>
+<li><code>[data-rtdb-path-form]</code>, <code>[data-rtdb-path-prefix]</code>, <code>[data-rtdb-path-input]</code></li>
+</ul>
+<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="#rtdbpathbarprops"><code>RtdbPathBarProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-30">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="rtdbpathsegments"></a></p>
+<h3 id="rtdbpathsegments">rtdbPathSegments()</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"> rtdbPathSegments</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-31">Returns</h4>
+<p><code>string</code>[]</p>
+<hr>
+<p><a id="rtdbtree"></a></p>
+<h3 id="rtdbtree">RtdbTree()</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"> RtdbTree</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The RTDB data tree — the interaction form of the Firebase console /
+firebase-tools-ui database viewer (clean-room adaptation of the
+NodeContainer/NodeParent/NodeLeaf split):</p>
+<ul>
+<li>parents render a caret (expand/collapse), leaves a <code>key: value</code> row;</li>
+<li>keys navigate (re-root the view), carets only toggle;</li>
+<li>hover/focus reveals per-node actions: <code>+</code> add child, <code>×</code> delete —
+delete flips to an INLINE two-step confirm (no modal, C3);</li>
+<li>leaf values are click-to-edit inline (type select: string / number /
+boolean / JSON);</li>
+<li>wide levels page at <code>tree.pageSize</code> with a “show more” row (the console’s
+form — see <code>reducers/tree.ts</code> for why paging over virtualization).</li>
+</ul>
+<p>Headless: consumers style <code>[data-pyric-ui="rtdb-tree"]</code> and the
+<code>data-rtdb-*</code> attributes (<code>node</code>, <code>row</code>, <code>caret</code>, <code>key</code>, <code>sep</code>, <code>value</code>,
+<code>actions</code>, <code>action-add</code>, <code>action-delete</code>, <code>confirm</code>, <code>editor</code>, <code>children</code>,
+<code>show-more</code>, <code>error</code>, <code>loading</code>). An empty root renders the console’s
+classic form — <code>&#x3C;root>: null</code> — not an instructional empty state.</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>__namedParameters</code></td><td align="left"><a href="#rtdbtreeprops"><code>RtdbTreeProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-32">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="rtdbtreereducer"></a></p>
+<h3 id="rtdbtreereducer">rtdbTreeReducer()</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"> rtdbTreeReducer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">action</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeAction</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>state</code></td><td align="left"><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></td></tr><tr><td align="left"><code>action</code></td><td align="left"><a href="#rtdbtreeaction"><code>RtdbTreeAction</code></a></td></tr></tbody></table></div>
+<h4 id="returns-33">Returns</h4>
+<p><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></p>
+<hr>
+<p><a id="rtdbtreevalueat"></a></p>
+<h3 id="rtdbtreevalueat">rtdbTreeValueAt()</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"> rtdbTreeValueAt</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </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>The subtree value at an ABSOLUTE database path, resolved against the
+loaded view-root value. <code>null</code> outside the view root.</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>state</code></td><td align="left"><a href="#rtdbtreestate"><code>RtdbTreeState</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-34">Returns</h4>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="rtdbvalueat"></a></p>
+<h3 id="rtdbvalueat">rtdbValueAt()</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"> rtdbValueAt</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">root</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</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>root</code></td><td align="left"><code>unknown</code></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-35">Returns</h4>
+<p><code>unknown</code></p>
+<hr>
+<p><a id="rtdbvaluekind"></a></p>
+<h3 id="rtdbvaluekind">rtdbValueKind()</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"> rtdbValueKind</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><code>@pyric/ui/rtdb</code> — the headless RTDB data viewer, in the Firebase console /
+firebase-tools-ui form: an editable path bar (crumbs + direct path entry)
+over an expandable tree with inline add/edit/delete affordances. Follows
+this package’s firestore/auth/storage split: pure logic + hooks +
+unstyled components on <code>data-*</code> styling contracts; the consumer (Studio)
+brings the CSS and the backend bundle (<a href="#rtdbapi">RtdbApi</a>).</p>
+<h4 id="parameters-35">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-36">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="rtdbvisiblechildren-1"></a></p>
+<h3 id="rtdbvisiblechildren-1">rtdbVisibleChildren()</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"> rtdbVisibleChildren</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbTreeState</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   path</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;font-style:italic">   pageSize</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbVisibleChildren</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The page-capped child list at an absolute path (console pages at 50).</p>
+<h4 id="parameters-36">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="#rtdbtreestate"><code>RtdbTreeState</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>pageSize</code></td><td align="left"><code>number</code></td></tr></tbody></table></div>
+<h4 id="returns-37">Returns</h4>
+<p><a href="#rtdbvisiblechildren"><code>RtdbVisibleChildren</code></a></p>
+<hr>
+<p><a id="usertdbtree"></a></p>
+<h3 id="usertdbtree">useRtdbTree()</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"> useRtdbTree</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   api</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">RtdbApi</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   path</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;font-style:italic">   options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseRtdbTreeOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">RtdbTreeController</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Live tree state for the RTDB viewer: subscribes to the value at the view
+root <code>path</code> (realtime — every write re-delivers the subtree) and runs the
+expansion/paging reducer over it. See <code>reducers/tree.ts</code> for the
+one-subscription-per-view-root loading strategy and why expansion is a
+pure render toggle rather than a fetch.</p>
+<h4 id="parameters-37">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>api</code></td><td align="left"><a href="#rtdbapi"><code>RtdbApi</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usertdbtreeoptions"><code>UseRtdbTreeOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-38">Returns</h4>
+<p><a href="#rtdbtreecontroller"><code>RtdbTreeController</code></a></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="rtdbapi"> <a href="#rtdbapi">RtdbApi</a> </li><li data-api-symbol="rtdbcrumb"> <a href="#rtdbcrumb">RtdbCrumb</a> </li><li data-api-symbol="rtdbpathbarprops"> <a href="#rtdbpathbarprops">RtdbPathBarProps</a> </li><li data-api-symbol="rtdbtreecontroller"> <a href="#rtdbtreecontroller">RtdbTreeController</a> </li><li data-api-symbol="rtdbtreeprops"> <a href="#rtdbtreeprops">RtdbTreeProps</a> </li><li data-api-symbol="rtdbtreestate"> <a href="#rtdbtreestate">RtdbTreeState</a> </li><li data-api-symbol="rtdbvisiblechildren"> <a href="#rtdbvisiblechildren">RtdbVisibleChildren</a> </li><li data-api-symbol="usertdbtreeoptions"> <a href="#usertdbtreeoptions">UseRtdbTreeOptions</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="rtdbeditorresult"> <a href="#rtdbeditorresult">RtdbEditorResult</a> </li><li data-api-symbol="rtdbeditortype"> <a href="#rtdbeditortype">RtdbEditorType</a> </li><li data-api-symbol="rtdbtreeaction"> <a href="#rtdbtreeaction">RtdbTreeAction</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="rtdb_default_page_size"> <a href="#rtdb_default_page_size">RTDB_DEFAULT_PAGE_SIZE</a> </li><li data-api-symbol="rtdb_editor_types"> <a href="#rtdb_editor_types">RTDB_EDITOR_TYPES</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="coercertdbeditorvalue()"> <a href="#coercertdbeditorvalue">coerceRtdbEditorValue()</a> </li><li data-api-symbol="formatrtdbeditorvalue()"> <a href="#formatrtdbeditorvalue">formatRtdbEditorValue()</a> </li><li data-api-symbol="formatrtdbjson()"> <a href="#formatrtdbjson">formatRtdbJson()</a> </li><li data-api-symbol="formatrtdbvaluelabel()"> <a href="#formatrtdbvaluelabel">formatRtdbValueLabel()</a> </li><li data-api-symbol="hasrtdbchildren()"> <a href="#hasrtdbchildren">hasRtdbChildren()</a> </li><li data-api-symbol="inferrtdbeditortype()"> <a href="#inferrtdbeditortype">inferRtdbEditorType()</a> </li><li data-api-symbol="initialrtdbtree()"> <a href="#initialrtdbtree">initialRtdbTree()</a> </li><li data-api-symbol="isrtdbobjectvalue()"> <a href="#isrtdbobjectvalue">isRtdbObjectValue()</a> </li><li data-api-symbol="isrtdbpathexpanded()"> <a href="#isrtdbpathexpanded">isRtdbPathExpanded()</a> </li><li data-api-symbol="joinrtdbpath()"> <a href="#joinrtdbpath">joinRtdbPath()</a> </li><li data-api-symbol="normalizertdbpath()"> <a href="#normalizertdbpath">normalizeRtdbPath()</a> </li><li data-api-symbol="normalizertdbsnapshotvalue()"> <a href="#normalizertdbsnapshotvalue">normalizeRtdbSnapshotValue()</a> </li><li data-api-symbol="parentrtdbpath()"> <a href="#parentrtdbpath">parentRtdbPath()</a> </li><li data-api-symbol="parsertdbjson()"> <a href="#parsertdbjson">parseRtdbJson()</a> </li><li data-api-symbol="parsertdbpathinput()"> <a href="#parsertdbpathinput">parseRtdbPathInput()</a> </li><li data-api-symbol="previewrtdbvalue()"> <a href="#previewrtdbvalue">previewRtdbValue()</a> </li><li data-api-symbol="relativertdbpath()"> <a href="#relativertdbpath">relativeRtdbPath()</a> </li><li data-api-symbol="rtdbchildentries()"> <a href="#rtdbchildentries">rtdbChildEntries()</a> </li><li data-api-symbol="rtdbcrumbs()"> <a href="#rtdbcrumbs">rtdbCrumbs()</a> </li><li data-api-symbol="rtdbkeyinputerror()"> <a href="#rtdbkeyinputerror">rtdbKeyInputError()</a> </li><li data-api-symbol="rtdbpathbar()"> <a href="#rtdbpathbar">RtdbPathBar()</a> </li><li data-api-symbol="rtdbpathsegments()"> <a href="#rtdbpathsegments">rtdbPathSegments()</a> </li><li data-api-symbol="rtdbtree()"> <a href="#rtdbtree">RtdbTree()</a> </li><li data-api-symbol="rtdbtreereducer()"> <a href="#rtdbtreereducer">rtdbTreeReducer()</a> </li><li data-api-symbol="rtdbtreevalueat()"> <a href="#rtdbtreevalueat">rtdbTreeValueAt()</a> </li><li data-api-symbol="rtdbvalueat()"> <a href="#rtdbvalueat">rtdbValueAt()</a> </li><li data-api-symbol="rtdbvaluekind()"> <a href="#rtdbvaluekind">rtdbValueKind()</a> </li><li data-api-symbol="rtdbvisiblechildren()"> <a href="#rtdbvisiblechildren-1">rtdbVisibleChildren()</a> </li><li data-api-symbol="usertdbtree()"> <a href="#usertdbtree">useRtdbTree()</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>