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

@@ -0,0 +1,1708 @@
+<!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/auth · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/ui/auth."><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/auth</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/ui/auth</code></h1> <p class="api-reference-meta"> 51 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="classes">Classes</h2>
+<p><a id="authflowcontroller"></a></p>
+<h3 id="authflowcontroller">AuthFlowController</h3>
+<h4 id="constructors">Constructors</h4>
+<p><a id="constructor"></a></p>
+<h5 id="constructor">Constructor</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:#C678DD">new</span><span style="color:#61AFEF"> AuthFlowController</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">auth</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Auth</span><span style="color:#ABB2BF">): </span><span style="color:#E06C75">AuthFlowController</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>auth</code></td><td align="left"><code>Auth</code></td></tr></tbody></table></div>
+<h6 id="returns">Returns</h6>
+<p><a href="#authflowcontroller"><code>AuthFlowController</code></a></p>
+<h4 id="methods">Methods</h4>
+<p><a id="add"></a></p>
+<h5 id="add">add()</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">add</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">spec</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">NewIdentitySpec</span><span style="color:#ABB2BF">): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Add + sign in as a new identity. The backend creates the identity
+(so claims resolve in rules and it shows up in the picker next time)
+and mints the credential in one step.</p>
+<p>Credential creation happens BEFORE take’s emit: subscribers
+recompute the snapshot synchronously on emit, so creating after would
+publish a stale identity list (a <code>useSyncExternalStore</code> consumer
+would miss the new account until the next unrelated emit).</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>spec</code></td><td align="left"><a href="#newidentityspec"><code>NewIdentitySpec</code></a></td></tr></tbody></table></div>
+<h6 id="returns-1">Returns</h6>
+<p><code>void</code></p>
+<p><a id="cancel"></a></p>
+<h5 id="cancel">cancel()</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">cancel</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Dismiss — rejects with the faithful <code>auth/popup-closed-by-user</code>.</p>
+<h6 id="returns-2">Returns</h6>
+<p><code>void</code></p>
+<p><a id="install"></a></p>
+<h5 id="install">install()</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">install</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Wire this controller’s resolver into the auth handle. Paired with
+<a href="#uninstall">uninstall</a> for use in a React effect (install in the body,
+uninstall in the cleanup) — StrictMode-safe.</p>
+<h6 id="returns-3">Returns</h6>
+<p><code>void</code></p>
+<p><a id="pick"></a></p>
+<h5 id="pick">pick()</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">pick</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">uid</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>
+<p>Pick an existing identity (by uid). The backend mints the credential
+(and records the provider on the identity).</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>uid</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h6 id="returns-4">Returns</h6>
+<p><code>void</code></p>
+<p><a id="resolver"></a></p>
+<h5 id="resolver">resolver()</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">resolver</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">AuthFlowResolver</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The resolver to hand to <code>sandbox.setAuthFlowResolver</code>. Popup and
+redirect share one implementation (the sandbox has no navigation).</p>
+<h6 id="returns-5">Returns</h6>
+<p><code>AuthFlowResolver</code></p>
+<p><a id="snapshot"></a></p>
+<h5 id="snapshot">snapshot()</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">snapshot</span><span style="color:#ABB2BF">(): </span><span style="color:#E06C75">HelperState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-6">Returns</h6>
+<p><a href="#helperstate"><code>HelperState</code></a></p>
+<p><a id="subscribe"></a></p>
+<h5 id="subscribe">subscribe()</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">subscribe</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75">fn</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>
+<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>fn</code></td><td align="left">() => <code>void</code></td></tr></tbody></table></div>
+<h6 id="returns-7">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-8">Returns</h6>
+<p><code>void</code></p>
+<p><a id="uninstall"></a></p>
+<h5 id="uninstall">uninstall()</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">uninstall</span><span style="color:#ABB2BF">(): </span><span style="color:#C678DD">void</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h6 id="returns-9">Returns</h6>
+<p><code>void</code></p>
+<h2 id="interfaces">Interfaces</h2>
+<p><a id="authproviderconfigentry"></a></p>
+<h3 id="authproviderconfigentry">AuthProviderConfigEntry</h3>
+<p>One provider’s current enablement, as the hook exposes it.</p>
+<h4 id="properties">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="enabled"></a> <code>enabled</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="providerid"></a> <code>providerId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="authprovidertogglesprops"></a></p>
+<h3 id="authprovidertogglesprops">AuthProviderTogglesProps</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="config"></a> <code>config</code></td><td align="left"><a href="#authproviderconfigentry"><code>AuthProviderConfigEntry</code></a>[]</td><td align="left">Current config — usually <code>useAuthProviderConfig(auth).config</code>.</td></tr><tr><td align="left"><a id="error"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isloading"></a> <code>isLoading?</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="knownproviderids"></a> <code>knownProviderIds?</code></td><td align="left">readonly <code>string</code>[]</td><td align="left">Always-shown rows, in this order. Default: <a href="#default_known_provider_ids">DEFAULT_KNOWN_PROVIDER_IDS</a>.</td></tr><tr><td align="left"><a id="ontoggle"></a> <code>onToggle</code></td><td align="left">(<code>providerId</code>: <code>string</code>, <code>enabled</code>: <code>boolean</code>) => <code>void</code></td><td align="left">Fired when a toggle (known or custom) flips.</td></tr></tbody></table></div>
+<hr>
+<p><a id="authsigninhelperprops"></a></p>
+<h3 id="authsigninhelperprops">AuthSignInHelperProps</h3>
+<h4 id="properties-2">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="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="description"></a> <code>description?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Optional helper text rendered under the title (<code>[data-pyric-helper-description]</code>). Default: none.</td></tr><tr><td align="left"><a id="initialvalues"></a> <code>initialValues?</code></td><td align="left">{ <code>claims?</code>: <code>string</code>; <code>displayName?</code>: <code>string</code>; <code>email?</code>: <code>string</code>; }</td><td align="left">Prefill for the add-account form (e.g. a host-suggested email). Read once on mount; <code>claims</code> is the raw textarea JSON text.</td></tr><tr><td align="left"><code>initialValues.claims?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><code>initialValues.displayName?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><code>initialValues.email?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="onadd"></a> <code>onAdd</code></td><td align="left">(<code>spec</code>: <a href="#newidentityspec"><code>NewIdentitySpec</code></a>) => <code>void</code></td><td align="left">Create + sign in as a new identity (wire to the hook’s <code>add</code>).</td></tr><tr><td align="left"><a id="oncancel"></a> <code>onCancel</code></td><td align="left">() => <code>void</code></td><td align="left">Dismiss the flow (wire to the hook’s <code>cancel</code>). Rejects the app’s sign-in promise with <code>auth/popup-closed-by-user</code>.</td></tr><tr><td align="left"><a id="onpick"></a> <code>onPick</code></td><td align="left">(<code>uid</code>: <code>string</code>) => <code>void</code></td><td align="left">Settle with an existing identity (wire to the hook’s <code>pick</code>).</td></tr><tr><td align="left"><a id="renderaccount"></a> <code>renderAccount?</code></td><td align="left">(<code>identity</code>: <code>any</code>) => <code>ReactNode</code></td><td align="left">Optional renderer for an account row’s content. Default renders the display name (or email, or uid) plus the email when both exist. The row button + data attributes stay owned by the component; this slot only fills the button’s children.</td></tr><tr><td align="left"><a id="state"></a> <code>state</code></td><td align="left"><a href="#helperstate"><code>HelperState</code></a></td><td align="left">Snapshot from <code>useAuthFlowHelper</code>. Renders nothing while <code>state.request</code> is null.</td></tr><tr><td align="left"><a id="title"></a> <code>title?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Heading text. Default: <code>Sign in with &#x3C;provider label></code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="authusereditorerrors"></a></p>
+<h3 id="authusereditorerrors">AuthUserEditorErrors</h3>
+<h4 id="properties-3">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="claims"></a> <code>claims?</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="email"></a> <code>email?</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="password"></a> <code>password?</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="authusereditorfields"></a></p>
+<h3 id="authusereditorfields">AuthUserEditorFields</h3>
+<p>Editable field set. <code>claimsText</code> is the raw textarea JSON.
+<code>providerIds</code> are the linked FEDERATED providers (<code>google.com</code>,
+<code>apple.com</code>, …) — <code>password</code> is credential-derived (the password
+field) and never appears here.</p>
+<h4 id="properties-4">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="claimstext"></a> <code>claimsText</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="disabled"></a> <code>disabled</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="displayname"></a> <code>displayName</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="email-1"></a> <code>email</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="emailverified"></a> <code>emailVerified</code></td><td align="left"><code>boolean</code></td></tr><tr><td align="left"><a id="password-1"></a> <code>password</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="phonenumber"></a> <code>phoneNumber</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="photourl"></a> <code>photoUrl</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="providerids"></a> <code>providerIds</code></td><td align="left"><code>string</code>[]</td></tr></tbody></table></div>
+<hr>
+<p><a id="authusereditorstate"></a></p>
+<h3 id="authusereditorstate">AuthUserEditorState</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="fields"></a> <code>fields</code></td><td align="left"><a href="#authusereditorfields"><code>AuthUserEditorFields</code></a></td><td align="left">-</td></tr><tr><td align="left"><a id="initial"></a> <code>initial</code></td><td align="left"><a href="#authusereditorfields"><code>AuthUserEditorFields</code></a></td><td align="left">What reset returns to; dirtiness is measured against this.</td></tr></tbody></table></div>
+<hr>
+<p><a id="authuserformfield"></a></p>
+<h3 id="authuserformfield">AuthUserFormField</h3>
+<p>What the <a href="#renderfield">AuthUserFormProps.renderField</a> slot receives per field.</p>
+<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="defaultrender"></a> <code>defaultRender</code></td><td align="left">() => <code>ReactNode</code></td><td align="left">The default rendering (label wrapper + label text + input + error). Call it to keep the stock layout for fields you don’t customize.</td></tr><tr><td align="left"><a id="error-1"></a> <code>error</code></td><td align="left"><code>string</code></td><td align="left">Current validation message for this field, or null.</td></tr><tr><td align="left"><a id="input"></a> <code>input</code></td><td align="left"><code>ReactNode</code></td><td align="left">The wired, controlled input element (carries <code>data-pyric-field</code>). Place it anywhere; state/validation stay connected.</td></tr><tr><td align="left"><a id="kind"></a> <code>kind</code></td><td align="left"><code>"text"</code> | <code>"checkbox"</code> | <code>"group"</code></td><td align="left">`‘text'</td></tr><tr><td align="left"><a id="label"></a> <code>label</code></td><td align="left"><code>string</code></td><td align="left">The visible label text the default rendering uses.</td></tr><tr><td align="left"><a id="name"></a> <code>name</code></td><td align="left"><a href="#authuserformfieldname-1"><code>AuthUserFormFieldName</code></a></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="authuserformprops"></a></p>
+<h3 id="authuserformprops">AuthUserFormProps</h3>
+<h4 id="properties-7">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="cancellabel"></a> <code>cancelLabel?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="children"></a> <code>children?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Extra content rendered before the action row (e.g. an error from a failed <code>createUser</code> call).</td></tr><tr><td align="left"><a id="classname-2"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="initial-1"></a> <code>initial?</code></td><td align="left"><code>AuthUserRecord</code></td><td align="left">Existing record → edit mode (delta payloads); omit → create mode.</td></tr><tr><td align="left"><a id="oncancel-1"></a> <code>onCancel?</code></td><td align="left">() => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="onsubmit"></a> <code>onSubmit</code></td><td align="left">(<code>submit</code>: <a href="#authuserformsubmit"><code>AuthUserFormSubmit</code></a>) => <code>void</code></td><td align="left">Receives the validated payload. Wire <code>create</code> to <code>useAuthUsers().createUser</code> and <code>edit</code> to <code>updateUser</code>.</td></tr><tr><td align="left"><a id="renderfield"></a> <code>renderField?</code></td><td align="left">(<code>field</code>: <a href="#authuserformfield"><code>AuthUserFormField</code></a>) => <code>ReactNode</code></td><td align="left">Per-field layout override. Called for each field (see <a href="#authuserformfieldname-1">AuthUserFormFieldName</a> order); return your own markup around <code>field.input</code>, or <code>field.defaultRender()</code> to keep the stock label wrapper for that field. Omit the prop for the default layout.</td></tr><tr><td align="left"><a id="submitlabel"></a> <code>submitLabel?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="authuserlistprops"></a></p>
+<h3 id="authuserlistprops">AuthUserListProps</h3>
+<h4 id="properties-8">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-3"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="emptystate"></a> <code>emptyState?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Zero state when the project has no users at all.</td></tr><tr><td align="left"><a id="error-2"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="filter"></a> <code>filter?</code></td><td align="left"><code>string</code></td><td align="left">The active filter text. Distinguishes the “no users yet” zero state (empty filter) from “no results” (non-empty).</td></tr><tr><td align="left"><a id="formatcreatedat"></a> <code>formatCreatedAt?</code></td><td align="left">(<code>iso</code>: <code>string</code>) => <code>ReactNode</code></td><td align="left">Timestamp formatter for Created. Default: locale date, em dash for null.</td></tr><tr><td align="left"><a id="formatlastloginat"></a> <code>formatLastLoginAt?</code></td><td align="left">(<code>iso</code>: <code>string</code>) => <code>ReactNode</code></td><td align="left">Timestamp formatter for Signed In. Kept separate because a missing login means “never”, while a missing/invalid creation time is malformed data.</td></tr><tr><td align="left"><a id="isloading-1"></a> <code>isLoading?</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="noresultsstate"></a> <code>noResultsState?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Zero state when the filter matches nothing.</td></tr><tr><td align="left"><a id="onselect"></a> <code>onSelect?</code></td><td align="left">(<code>user</code>: <code>AuthUserRecord</code>) => <code>void</code></td><td align="left">Fired when the identifier cell is clicked. When omitted, the identifier renders as plain text.</td></tr><tr><td align="left"><a id="renderactions"></a> <code>renderActions?</code></td><td align="left">(<code>user</code>: <code>AuthUserRecord</code>) => <code>ReactNode</code></td><td align="left">Per-row action slot (edit / disable / delete menu). Rendered in a trailing cell; column header is added when this is provided.</td></tr><tr><td align="left"><a id="renderactionsheader"></a> <code>renderActionsHeader?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Optional content for the trailing actions column header (for example, a select-all checkbox). Only rendered with <code>renderActions</code>.</td></tr><tr><td align="left"><a id="renderidentifier"></a> <code>renderIdentifier?</code></td><td align="left">(<code>user</code>: <code>AuthUserRecord</code>) => <code>ReactNode</code></td><td align="left">Identifier-cell override. Default: email, else phone, else <code>anonymous</code>, else the uid.</td></tr><tr><td align="left"><a id="renderproviders"></a> <code>renderProviders?</code></td><td align="left">(<code>user</code>: <code>AuthUserRecord</code>) => <code>ReactNode</code></td><td align="left">Providers-cell override. Default: one <code>&#x3C;span data-pyric-provider-id></code> per linked provider with its text label (<code>anonymous</code> for anonymous users) — hook icons off the attribute.</td></tr><tr><td align="left"><a id="renderselection"></a> <code>renderSelection?</code></td><td align="left">(<code>user</code>: <code>AuthUserRecord</code>) => <code>ReactNode</code></td><td align="left">Per-row selection control. Rendered in the leading cell so bulk selection stays visually separate from trailing row actions.</td></tr><tr><td align="left"><a id="renderselectionheader"></a> <code>renderSelectionHeader?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Optional content for the leading selection column header (for example, a select-all checkbox). Only rendered with <code>renderSelection</code>.</td></tr><tr><td align="left"><a id="rowheight"></a> <code>rowHeight?</code></td><td align="left"><code>number</code> | (<code>index</code>: <code>number</code>) => <code>number</code></td><td align="left">Estimated row height when virtualizing. Default 44.</td></tr><tr><td align="left"><a id="users"></a> <code>users</code></td><td align="left"><code>AuthUserRecord</code>[]</td><td align="left">Rows to render — usually <code>useAuthUsers().users</code>.</td></tr><tr><td align="left"><a id="virtualizedheight"></a> <code>virtualizedHeight?</code></td><td align="left"><code>string</code> | <code>number</code></td><td align="left">Scroll-container height when virtualized. Default <code>'60vh'</code>.</td></tr><tr><td align="left"><a id="virtualizethreshold"></a> <code>virtualizeThreshold?</code></td><td align="left"><code>number</code></td><td align="left">Above this row count, rows render through <code>&#x3C;VirtualList></code>. Default 100. <code>Infinity</code> disables.</td></tr></tbody></table></div>
+<hr>
+<p><a id="claimsfieldprops"></a></p>
+<h3 id="claimsfieldprops">ClaimsFieldProps</h3>
+<h4 id="properties-9">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-4"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="error-3"></a> <code>error?</code></td><td align="left"><code>string</code></td><td align="left">Validation message (from <code>validateSerializedClaims</code> / <code>useAuthUserEditor().errors.claims</code>). Renders a <code>role="alert"</code> paragraph and marks the textarea invalid.</td></tr><tr><td align="left"><a id="hint"></a> <code>hint?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Helper text under the field (rules-usage hint by default).</td></tr><tr><td align="left"><a id="onchange"></a> <code>onChange</code></td><td align="left">(<code>text</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="placeholder"></a> <code>placeholder?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="value"></a> <code>value</code></td><td align="left"><code>string</code></td><td align="left">Raw claims JSON text.</td></tr></tbody></table></div>
+<hr>
+<p><a id="clearuserswithconfirmprops"></a></p>
+<h3 id="clearuserswithconfirmprops">ClearUsersWithConfirmProps</h3>
+<h4 id="properties-10">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="body"></a> <code>body?</code></td><td align="left"><code>ReactNode</code></td><td align="left">-</td></tr><tr><td align="left"><a id="classname-5"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="confirmlabel"></a> <code>confirmLabel?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="count"></a> <code>count?</code></td><td align="left"><code>number</code></td><td align="left">Current user count, interpolated into the default body.</td></tr><tr><td align="left"><a id="onclear"></a> <code>onClear</code></td><td align="left">() => <code>void</code></td><td align="left">Runs after the user confirms. Wire to <code>useAuthUsers().clearUsers</code>.</td></tr><tr><td align="left"><a id="rendertrigger"></a> <code>renderTrigger?</code></td><td align="left">(<code>props</code>: <code>TriggerProps</code>) => <code>ReactNode</code></td><td align="left">-</td></tr><tr><td align="left"><a id="title-1"></a> <code>title?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="deleteuserwithconfirmprops"></a></p>
+<h3 id="deleteuserwithconfirmprops">DeleteUserWithConfirmProps</h3>
+<h4 id="properties-11">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="body-1"></a> <code>body?</code></td><td align="left"><code>ReactNode</code></td><td align="left">-</td></tr><tr><td align="left"><a id="classname-6"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="confirmlabel-1"></a> <code>confirmLabel?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="ondelete"></a> <code>onDelete</code></td><td align="left">(<code>uid</code>: <code>string</code>) => <code>void</code></td><td align="left">Runs after the user confirms. Wire to <code>useAuthUsers().deleteUser</code>.</td></tr><tr><td align="left"><a id="rendertrigger-1"></a> <code>renderTrigger?</code></td><td align="left">(<code>props</code>: <code>TriggerProps</code>) => <code>ReactNode</code></td><td align="left">Trigger override; default is a plain destructive <code>&#x3C;button></code>.</td></tr><tr><td align="left"><a id="title-2"></a> <code>title?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="user"></a> <code>user</code></td><td align="left"><code>AuthUserRecord</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="helperstate"></a></p>
+<h3 id="helperstate">HelperState</h3>
+<p>Snapshot the helper UI renders from.</p>
+<h4 id="properties-12">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="identities"></a> <code>identities</code></td><td align="left"><code>any</code>[]</td><td align="left">Existing identities to pick from (seeded + previously created).</td></tr><tr><td align="left"><a id="request"></a> <code>request</code></td><td align="left"><code>any</code></td><td align="left">The in-flight request, or null when the helper is closed.</td></tr></tbody></table></div>
+<hr>
+<p><a id="newidentityspec"></a></p>
+<h3 id="newidentityspec">NewIdentitySpec</h3>
+<p>A field set for “add new account” — mirrors the emulator’s add-user form.</p>
+<h4 id="properties-13">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="customclaims"></a> <code>customClaims?</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <code>unknown</code>></td><td align="left">Parsed custom claims (the emulator’s <code>customAttributes</code>).</td></tr><tr><td align="left"><a id="displayname-1"></a> <code>displayName?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="email-2"></a> <code>email</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="useauthflowhelperresult"></a></p>
+<h3 id="useauthflowhelperresult">UseAuthFlowHelperResult</h3>
+<h4 id="properties-14">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="add-2"></a> <code>add</code></td><td align="left">(<code>spec</code>: <a href="#newidentityspec"><code>NewIdentitySpec</code></a>) => <code>void</code></td><td align="left">Create + sign in as a new identity (seeds it for next time).</td></tr><tr><td align="left"><a id="cancel-2"></a> <code>cancel</code></td><td align="left">() => <code>void</code></td><td align="left">Dismiss — rejects the app’s sign-in promise with <code>auth/popup-closed-by-user</code> (faithful to <code>firebase/auth</code>).</td></tr><tr><td align="left"><a id="pick-2"></a> <code>pick</code></td><td align="left">(<code>uid</code>: <code>string</code>) => <code>void</code></td><td align="left">Settle the flow with an existing identity (by uid).</td></tr><tr><td align="left"><a id="state-1"></a> <code>state</code></td><td align="left"><a href="#helperstate"><code>HelperState</code></a></td><td align="left">Render snapshot: the in-flight request (or null) + pickable identities.</td></tr></tbody></table></div>
+<hr>
+<p><a id="useauthproviderconfigresult"></a></p>
+<h3 id="useauthproviderconfigresult">UseAuthProviderConfigResult</h3>
+<h4 id="properties-15">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="config-1"></a> <code>config</code></td><td align="left"><a href="#authproviderconfigentry"><code>AuthProviderConfigEntry</code></a>[]</td><td align="left">Every provider this sandbox has an explicit enablement for. Unknown providers (never toggled) are simply absent — <code>isEnabled</code> treats an absent entry as disabled, matching the backend default.</td></tr><tr><td align="left"><a id="error-4"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isenabled"></a> <code>isEnabled</code></td><td align="left">(<code>providerId</code>: <code>string</code>) => <code>boolean</code></td><td align="left">Convenience lookup: <code>false</code> for a provider that’s never been toggled.</td></tr><tr><td align="left"><a id="isloading-2"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="refresh"></a> <code>refresh</code></td><td align="left">() => <code>void</code></td><td align="left">Re-read manually. Rarely needed — every mutation (this hook’s own <code>setEnabled</code>, another handle, the agent) already triggers the subscription re-list.</td></tr><tr><td align="left"><a id="setenabled"></a> <code>setEnabled</code></td><td align="left">(<code>providerId</code>: <code>string</code>, <code>enabled</code>: <code>boolean</code>) => <code>void</code></td><td align="left">Toggle a provider on/off. Sync (in-process) failures throw to the caller, same policy as <code>useAuthUsers</code>’s mutation callbacks; an ASYNC (worker-RPC) failure can’t reach a sync caller, so it surfaces on the hook’s <code>error</code> state instead — never an unhandled rejection.</td></tr></tbody></table></div>
+<hr>
+<p><a id="useauthusereditoroptions"></a></p>
+<h3 id="useauthusereditoroptions">UseAuthUserEditorOptions</h3>
+<h4 id="properties-16">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="initial-2"></a> <code>initial?</code></td><td align="left"><code>AuthUserRecord</code></td><td align="left">Existing record to edit. Omit for create mode.</td></tr></tbody></table></div>
+<hr>
+<p><a id="useauthusereditorresult"></a></p>
+<h3 id="useauthusereditorresult">UseAuthUserEditorResult</h3>
+<h4 id="properties-17">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="dispatch"></a> <code>dispatch</code></td><td align="left">(<code>action</code>: <a href="#authusereditoraction"><code>AuthUserEditorAction</code></a>) => <code>void</code></td><td align="left">Raw reducer access for advanced consumers.</td></tr><tr><td align="left"><a id="errors"></a> <code>errors</code></td><td align="left"><a href="#authusereditorerrors"><code>AuthUserEditorErrors</code></a></td><td align="left">Per-field validation messages (emulator-UI wording). Empty when valid.</td></tr><tr><td align="left"><a id="fields-1"></a> <code>fields</code></td><td align="left"><a href="#authusereditorfields"><code>AuthUserEditorFields</code></a></td><td align="left">-</td></tr><tr><td align="left"><a id="isdirty"></a> <code>isDirty</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isvalid"></a> <code>isValid</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="reset"></a> <code>reset</code></td><td align="left">() => <code>void</code></td><td align="left">Back to the initial snapshot.</td></tr><tr><td align="left"><a id="setfield"></a> <code>setField</code></td><td align="left">&#x3C;<code>K</code>>(<code>field</code>: <code>K</code>, <code>value</code>: <a href="#authusereditorfields"><code>AuthUserEditorFields</code></a>[<code>K</code>]) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="tocreaterequest"></a> <code>toCreateRequest</code></td><td align="left">() => <code>CreateUserRequest</code></td><td align="left">Full payload for <code>createUser</code> (every non-empty field).</td></tr><tr><td align="left"><a id="toupdaterequest"></a> <code>toUpdateRequest</code></td><td align="left">() => <code>UpdateUserRequest</code></td><td align="left">Delta payload for <code>updateUser</code> (only changed fields).</td></tr></tbody></table></div>
+<hr>
+<p><a id="useauthusersresult"></a></p>
+<h3 id="useauthusersresult">UseAuthUsersResult</h3>
+<h4 id="properties-18">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="clearusers"></a> <code>clearUsers</code></td><td align="left">() => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="createuser"></a> <code>createUser</code></td><td align="left">(<code>request</code>: <code>CreateUserRequest</code>) => <code>AuthUserRecord</code></td><td align="left">-</td></tr><tr><td align="left"><a id="deleteuser"></a> <code>deleteUser</code></td><td align="left">(<code>uid</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="error-5"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="filter-1"></a> <code>filter</code></td><td align="left"><code>string</code></td><td align="left">Case-insensitive substring match over uid, email, display name and phone number (the emulator UI’s search semantics).</td></tr><tr><td align="left"><a id="isloading-3"></a> <code>isLoading</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="refresh-1"></a> <code>refresh</code></td><td align="left">() => <code>void</code></td><td align="left">Re-list manually. Rarely needed, every mutation (including ones made by the agent or the running app) already triggers <code>subscribeUsers</code>.</td></tr><tr><td align="left"><a id="setfilter"></a> <code>setFilter</code></td><td align="left">(<code>filter</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="totalcount"></a> <code>totalCount</code></td><td align="left"><code>number</code></td><td align="left">Unfiltered count: lets a list distinguish “no users at all” from “no results for this filter”.</td></tr><tr><td align="left"><a id="updateuser"></a> <code>updateUser</code></td><td align="left">(<code>uid</code>: <code>string</code>, <code>update</code>: <code>UpdateUserRequest</code>) => <code>AuthUserRecord</code></td><td align="left">-</td></tr><tr><td align="left"><a id="users-1"></a> <code>users</code></td><td align="left"><code>AuthUserRecord</code>[]</td><td align="left">Users matching <a href="#filter-1">filter</a> (everyone when the filter is empty).</td></tr></tbody></table></div>
+<h2 id="type-aliases">Type Aliases</h2>
+<p><a id="authapi"></a></p>
+<h3 id="authapi">AuthApi</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"> AuthApi</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> Pick</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#C678DD">typeof</span><span style="color:#E06C75"> authSandbox</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"listUsers"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"subscribeUsers"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"createUser"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"updateUser"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"deleteUser"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"clearUsers"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"getAuthProviderConfig"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"setAuthProviderConfig"</span></span>
+<span class="line"><span style="color:#ABB2BF">| </span><span style="color:#98C379">"subscribeAuthProviderConfig"</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>The sandbox auth admin ops <code>useAuthUsers</code> drives, as an INJECTABLE bundle.</p>
+<p>WHY (same rationale as <code>@pyric/ui/firestore</code>’s FirestoreApi): the hook defaults
+to the in-process <code>pyric/auth</code> <code>sandbox</code> ops, but Pyric Studio’s served mode
+drives the SAME ops over a SharedWorker (a parallel client over a MessagePort).
+Reading them from this context lets a consumer inject the worker client’s fns
+so the hook operates on the live worker user DB without knowing the backend.</p>
+<p>The bundle is typed to the in-process signatures; a worker bundle is adapted
+(cast) at the Studio boundary. NOTE the worker <code>listUsers</code> is ASYNC (an RPC)
+whereas the in-process one is sync, so <code>useAuthUsers</code> tolerates a promise (it
+wraps the result in <code>Promise.resolve</code>).</p>
+<p>Default = the real <code>pyric/auth</code> sandbox ops, so every existing consumer is
+unchanged: no provider needed unless swapping the backend.</p>
+<hr>
+<p><a id="authusereditoraction"></a></p>
+<h3 id="authusereditoraction">AuthUserEditorAction</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"> AuthUserEditorAction</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  field</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">keyof</span><span style="color:#E5C07B"> AuthUserEditorFields</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">"setField"</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">AuthUserEditorFields</span><span style="color:#ABB2BF">[</span><span style="color:#C678DD">keyof</span><span style="color:#E5C07B"> AuthUserEditorFields</span><span style="color:#ABB2BF">];</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<hr>
+<p><a id="authuserformfieldname-1"></a></p>
+<h3 id="authuserformfieldname">AuthUserFormFieldName</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"> AuthUserFormFieldName</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"email"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"password"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"display-name"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"phone-number"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"photo-url"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"providers"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"email-verified"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"disabled"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Field names the <a href="#renderfield">AuthUserFormProps.renderField</a> slot receives,
+in render order. Claims is NOT a slot field — it stays the standalone
+<code>&#x3C;ClaimsField></code> (override it by composing <code>useAuthUserEditor</code>).</p>
+<hr>
+<p><a id="authuserformsubmit"></a></p>
+<h3 id="authuserformsubmit">AuthUserFormSubmit</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"> AuthUserFormSubmit</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  mode</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"create"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  request</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">CreateUserRequest</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">  mode</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"edit"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  request</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UpdateUserRequest</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  uid</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>What <code>onSubmit</code> receives — discriminated on the form’s mode.</p>
+<hr>
+<p><a id="claimsvalidationresult"></a></p>
+<h3 id="claimsvalidationresult">ClaimsValidationResult</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"> ClaimsValidationResult</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  claims</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">unknown</span><span style="color:#ABB2BF">> | </span><span style="color:#E5C07B">undefined</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">true</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">  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>
+<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">  claims</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#56B6C2"> |</span><span style="color:#D19A66"> undefined</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">true</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="claims">claims</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">claims</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">Record</span><span style="color:#56B6C2">&#x3C;</span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75">unknown</span><span style="color:#56B6C2">></span><span style="color:#56B6C2"> |</span><span style="color:#D19A66"> undefined</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="ok">ok</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">ok</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">true</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p><code>claims</code> is <code>undefined</code> when the input was empty/whitespace.</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">  ok</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">false</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="ok-1">ok</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">ok</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">false</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="sandboxidentity"></a></p>
+<h3 id="sandboxidentity">SandboxIdentity</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"> SandboxIdentity</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> ReturnType</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#C678DD">typeof</span><span style="color:#E5C07B"> authSandbox</span><span style="color:#ABB2BF">.</span><span style="color:#E06C75">listIdentities</span><span style="color:#ABB2BF">>[</span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">];</span></span></code></pre>
+<p>One pickable identity, as reported by <code>sandbox.listIdentities</code>.</p>
+<h2 id="variables">Variables</h2>
+<p><a id="custom_claims_max_length"></a></p>
+<h3 id="custom_claims_max_length">CUSTOM_CLAIMS_MAX_LENGTH</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"> CUSTOM_CLAIMS_MAX_LENGTH</span><span style="color:#ABB2BF">: </span><span style="color:#D19A66">1000</span><span style="color:#56B6C2"> =</span><span style="color:#D19A66"> 1000</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Serialized-length cap, matching the emulator’s <code>CUSTOM_ATTRIBUTES_MAX_LENGTH</code>.</p>
+<hr>
+<p><a id="default_known_provider_ids"></a></p>
+<h3 id="default_known_provider_ids">DEFAULT_KNOWN_PROVIDER_IDS</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"> DEFAULT_KNOWN_PROVIDER_IDS</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#ABB2BF"> [</span><span style="color:#98C379">"password"</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"anonymous"</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"google.com"</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"github.com"</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"apple.com"</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"microsoft.com"</span><span style="color:#ABB2BF">];</span></span></code></pre>
+<p>Providers always shown as a toggle row, regardless of whether the
+backend has an explicit entry for them yet (an unconfigured provider
+simply reads as disabled — same default the sandbox backend applies).</p>
+<hr>
+<p><a id="forbidden_custom_claims"></a></p>
+<h3 id="forbidden_custom_claims">FORBIDDEN_CUSTOM_CLAIMS</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"> FORBIDDEN_CUSTOM_CLAIMS</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> string</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>Reserved JWT/OIDC keys the Auth emulator rejects as custom claims.
+<a href="https://firebase.google.com/docs/auth/admin/create-custom-tokens" target="_blank" rel="noopener noreferrer" class="external-link">https://firebase.google.com/docs/auth/admin/create-custom-tokens</a></p>
+<hr>
+<p><a id="provider_labels"></a></p>
+<h3 id="provider_labels">PROVIDER_LABELS</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"> PROVIDER_LABELS</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Record</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>Provider-id → human label mapping, mirroring the provider set the
+Firebase emulator UI recognizes (it maps the same ids to icons; a
+headless library maps them to text and leaves icons to the consumer
+via <code>data-pyric-provider-id</code>).</p>
+<h2 id="functions">Functions</h2>
+<p><a id="authapiprovider"></a></p>
+<h3 id="authapiprovider">AuthApiProvider()</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"> AuthApiProvider</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: {</span></span>
+<span class="line"><span style="color:#E06C75">  children</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReactNode</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthApi</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}): </span><span style="color:#E5C07B">FunctionComponentElement</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">ProviderProps</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">AuthApi</span><span style="color:#ABB2BF">>>;</span></span></code></pre>
+<p>Provide an auth API bundle to the subtree. Pyric Studio supplies the
+in-process bundle for dev-seed review and the SharedWorker client bundle under
+<code>pyric dev --ui</code>.</p>
+<h4 id="parameters-4">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left">{ <code>children</code>: <code>ReactNode</code>; <code>value</code>: <a href="#authapi"><code>AuthApi</code></a>; }</td></tr><tr><td align="left"><code>__namedParameters.children</code></td><td align="left"><code>ReactNode</code></td></tr><tr><td align="left"><code>__namedParameters.value</code></td><td align="left"><a href="#authapi"><code>AuthApi</code></a></td></tr></tbody></table></div>
+<h4 id="returns-10">Returns</h4>
+<p><code>FunctionComponentElement</code>&#x3C;<code>ProviderProps</code>&#x3C;<a href="#authapi"><code>AuthApi</code></a>>></p>
+<hr>
+<p><a id="authprovidertoggles"></a></p>
+<h3 id="authprovidertoggles">AuthProviderToggles()</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"> AuthProviderToggles</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthProviderTogglesProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless “Sign-in providers” toggle grid — the Authentication → Sign-in
+method surface. Known providers (password / anonymous / the built-in OAuth
+set) always render as a row; any OTHER provider already present in
+<code>config</code> (a custom OAuth id a host previously added) also gets a row. A
+free-text field lets a consumer enable an arbitrary OAuth provider id not
+in the known set — this is a SECTION, not a dialog: the add row lives
+inline, no modal.</p>
+<p>Fully headless: styling hangs off <code>data-pyric-*</code>, matching the rest of
+<code>@pyric/ui/auth</code> (<code>AuthUserList</code>, <code>AuthUserForm</code>, …). Data + mutation come
+from <code>useAuthProviderConfig</code>; this component only renders + fires events.</p>
+<h4 id="parameters-5">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#authprovidertogglesprops"><code>AuthProviderTogglesProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-11">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="authsigninhelper"></a></p>
+<h3 id="authsigninhelper">AuthSignInHelper()</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"> AuthSignInHelper</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthSignInHelperProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless emulator-style sign-in helper: an account picker over the
+sandbox’s known identities plus an add-account form (email, display
+name, custom-claims JSON with emulator-grade validation messages).</p>
+<p>Ships zero styling. Structure is addressable via the
+<code>data-pyric-*</code> contract:</p>
+<ul>
+<li>root: <code>[data-pyric-ui="auth-signin-helper"]</code>,
+<code>[data-pyric-provider-id]</code>, <code>[data-pyric-auth-type]</code></li>
+<li>picker: <code>[data-pyric-account-list]</code> > <code>[data-pyric-account-entry]</code>
+<blockquote>
+<p><code>button[data-pyric-account-pick]</code></p>
+</blockquote>
+</li>
+<li>form: <code>form[data-pyric-add-account-form]</code>, fields
+<code>[data-pyric-field="email" | "display-name" | "claims"]</code>,
+<code>[data-pyric-claims-error]</code> (role=alert),
+<code>button[data-pyric-cancel]</code>, <code>button[data-pyric-submit]</code></li>
+</ul>
+<p>Positioning is the consumer’s job — render it inside your own modal
+or panel (the flow is host-UI-agnostic; only <code>onCancel</code> carries the
+popup-closed semantics).</p>
+<h4 id="parameters-6">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#authsigninhelperprops"><code>AuthSignInHelperProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-12">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="authusereditorreducer"></a></p>
+<h3 id="authusereditorreducer">authUserEditorReducer()</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"> authUserEditorReducer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserEditorState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">action</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserEditorAction</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">AuthUserEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h4 id="parameters-7">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>state</code></td><td align="left"><a href="#authusereditorstate"><code>AuthUserEditorState</code></a></td></tr><tr><td align="left"><code>action</code></td><td align="left"><a href="#authusereditoraction"><code>AuthUserEditorAction</code></a></td></tr></tbody></table></div>
+<h4 id="returns-13">Returns</h4>
+<p><a href="#authusereditorstate"><code>AuthUserEditorState</code></a></p>
+<hr>
+<p><a id="authuserform"></a></p>
+<h3 id="authuserform">AuthUserForm()</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"> AuthUserForm</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserFormProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless add/edit-user form over <code>useAuthUserEditor</code> — the emulator
+UI’s user dialog fields (email, password, display name, phone, photo
+URL, verified/disabled toggles, custom claims) with its validation
+messages. Zero CSS; structure addressable via <code>data-pyric-*</code>:</p>
+<ul>
+<li>root <code>form[data-pyric-ui="auth-user-form"]</code> with <code>data-pyric-mode</code>,
+<code>data-pyric-is-dirty</code>, <code>data-pyric-is-valid</code> state attrs</li>
+<li>every field (text inputs AND checkboxes) is wrapped in a
+<code>label[data-pyric-field-label="&#x3C;name>"]</code> carrying a visible
+<code>span[data-pyric-label-text]</code> — labeled grid layouts are pure CSS
+(<code>display: grid</code> on the wrappers); label-less designs hide
+<code>[data-pyric-label-text]</code> and lean on the placeholders</li>
+<li>inputs <code>[data-pyric-field="email" | "password" | "display-name" | "phone-number" | "photo-url" | "email-verified" | "disabled"]</code></li>
+<li>CREATE mode only: a “Sign-in providers” group
+(<code>fieldset[data-pyric-field-label="providers"]</code> wrapping
+<code>[data-pyric-provider-checklist]</code>) — one checkbox per federated
+provider the sandbox supports (<code>FEDERATED_PROVIDER_IDS</code> from
+<code>pyric/auth</code>; multiple selectable, entries land on
+<code>CreateUserRequest.providerUserInfo</code>)</li>
+<li>claims via the standalone <code>&#x3C;ClaimsField></code></li>
+<li>per-field messages <code>[data-pyric-field-error="email" | "password"]</code>
+render INSIDE the field’s label wrapper, after the input</li>
+<li><code>button[data-pyric-cancel]</code> / <code>button[data-pyric-submit]</code> (submit is
+disabled while invalid, or pristine in edit mode)</li>
+</ul>
+<p>Submit emits payloads only — no sandbox calls — so the same form works
+for create and edit and the consumer owns error handling.</p>
+<h4 id="parameters-8">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#authuserformprops"><code>AuthUserFormProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-14">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="authuserlist"></a></p>
+<h3 id="authuserlist">AuthUserList()</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"> AuthUserList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserListProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless users table — the emulator UI’s columns (Identifier,
+Provider, Created, Signed In, User UID, actions) over the
+<code>data-pyric-*</code> styling contract, with role-based table semantics so
+rows can virtualize (a real <code>&#x3C;table></code> can’t wrap a scroll container).</p>
+<p>The hook (<code>useAuthUsers</code>) owns data + filter state; this component
+just renders. Disabled accounts carry <code>data-pyric-user-disabled</code> for
+dimmed styling.</p>
+<h4 id="parameters-9">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#authuserlistprops"><code>AuthUserListProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-15">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="claimsfield"></a></p>
+<h3 id="claimsfield">ClaimsField()</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"> ClaimsField</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClaimsFieldProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless custom-claims textarea — the emulator UI’s
+<code>customAttributes</code> control. Standalone so custom forms can reuse the
+exact field (the playground’s sign-in helper and the user form both
+render one); validation itself lives in <code>validateSerializedClaims</code>.</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>__namedParameters</code></td><td align="left"><a href="#claimsfieldprops"><code>ClaimsFieldProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-16">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="clearuserswithconfirm"></a></p>
+<h3 id="clearuserswithconfirm">ClearUsersWithConfirm()</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"> ClearUsersWithConfirm</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ClearUsersWithConfirmProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Confirm-gated clear-all (the emulator UI’s “Clear all data”).
+Requires a <code>&#x3C;ConfirmProvider></code> ancestor.</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>__namedParameters</code></td><td align="left"><a href="#clearuserswithconfirmprops"><code>ClearUsersWithConfirmProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-17">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="deleteuserwithconfirm"></a></p>
+<h3 id="deleteuserwithconfirm">DeleteUserWithConfirm()</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"> DeleteUserWithConfirm</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DeleteUserWithConfirmProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Confirm-gated single-user delete (the emulator UI’s row-menu
+“Delete user”). Requires a <code>&#x3C;ConfirmProvider></code> ancestor.</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>__namedParameters</code></td><td align="left"><a href="#deleteuserwithconfirmprops"><code>DeleteUserWithConfirmProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-18">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="fieldsfromrecord"></a></p>
+<h3 id="fieldsfromrecord">fieldsFromRecord()</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"> fieldsFromRecord</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">record</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserRecord</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">AuthUserEditorFields</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>record?</code></td><td align="left"><code>AuthUserRecord</code></td></tr></tbody></table></div>
+<h4 id="returns-19">Returns</h4>
+<p><a href="#authusereditorfields"><code>AuthUserEditorFields</code></a></p>
+<hr>
+<p><a id="initauthusereditorstate"></a></p>
+<h3 id="initauthusereditorstate">initAuthUserEditorState()</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"> initAuthUserEditorState</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">initial</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserRecord</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">AuthUserEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>initial?</code></td><td align="left"><code>AuthUserRecord</code></td></tr></tbody></table></div>
+<h4 id="returns-20">Returns</h4>
+<p><a href="#authusereditorstate"><code>AuthUserEditorState</code></a></p>
+<hr>
+<p><a id="providerlabel"></a></p>
+<h3 id="providerlabel">providerLabel()</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"> providerLabel</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">providerId</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>Label for a provider id; falls back to the raw id for custom
+<code>OAuthProvider</code> ids the map doesn’t know.</p>
+<h4 id="parameters-15">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>providerId</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-21">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="tocreaterequest-1"></a></p>
+<h3 id="tocreaterequest">toCreateRequest()</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"> toCreateRequest</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserEditorState</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">CreateUserRequest</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Full payload for <code>sandbox.createUser</code> — every non-empty field.</p>
+<h4 id="parameters-16">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>state</code></td><td align="left"><a href="#authusereditorstate"><code>AuthUserEditorState</code></a></td></tr></tbody></table></div>
+<h4 id="returns-22">Returns</h4>
+<p><code>CreateUserRequest</code></p>
+<hr>
+<p><a id="toupdaterequest-1"></a></p>
+<h3 id="toupdaterequest">toUpdateRequest()</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"> toUpdateRequest</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserEditorState</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UpdateUserRequest</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Delta payload for <code>sandbox.updateUser</code> — only fields that changed
+from the initial record. A cleared displayName maps to <code>null</code>
+(the update API’s clear semantics).</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="#authusereditorstate"><code>AuthUserEditorState</code></a></td></tr></tbody></table></div>
+<h4 id="returns-23">Returns</h4>
+<p><code>UpdateUserRequest</code></p>
+<hr>
+<p><a id="useauthapi"></a></p>
+<h3 id="useauthapi">useAuthApi()</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"> useAuthApi</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">AuthApi</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Read the active auth API bundle (defaults to in-process <code>pyric/auth</code>).</p>
+<h4 id="returns-24">Returns</h4>
+<p><a href="#authapi"><code>AuthApi</code></a></p>
+<hr>
+<p><a id="useauthflowhelper"></a></p>
+<h3 id="useauthflowhelper">useAuthFlowHelper()</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"> useAuthFlowHelper</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">auth</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Auth</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseAuthFlowHelperResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Emulator-style sign-in helper for a sandbox <code>Auth</code> handle.</p>
+<p>Installs an <a href="#authflowcontroller">AuthFlowController</a> as the handle’s
+<code>AuthFlowResolver</code> for the lifetime of the calling component — the
+analog of browser <code>getAuth</code> wiring <code>browserPopupRedirectResolver</code>.
+While mounted, any <code>signInWithPopup</code> / <code>signInWithRedirect</code> call made
+against <code>auth</code> parks on <code>state.request</code>; render an account-picker UI
+(e.g. <code>&#x3C;AuthSignInHelper></code>) from <code>state</code> and settle with
+<code>pick</code> / <code>add</code> / <code>cancel</code>.</p>
+<p>Install/uninstall is a paired effect, so the StrictMode double-mount
+installs and cleanly uninstalls. Sandbox-only: the controller throws
+<code>failed-precondition</code> if <code>auth</code> is prod-backed.</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>auth</code></td><td align="left"><code>Auth</code></td></tr></tbody></table></div>
+<h4 id="returns-25">Returns</h4>
+<p><a href="#useauthflowhelperresult"><code>UseAuthFlowHelperResult</code></a></p>
+<hr>
+<p><a id="useauthproviderconfig"></a></p>
+<h3 id="useauthproviderconfig">useAuthProviderConfig()</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"> useAuthProviderConfig</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">auth</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Auth</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseAuthProviderConfigResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Live sign-in provider config view over a sandbox <code>Auth</code> handle:
+<code>sandbox.getAuthProviderConfig</code> + <code>sandbox.subscribeAuthProviderConfig</code> +
+<code>sandbox.setAuthProviderConfig</code>. Mirrors <code>useAuthUsers</code>’s shape exactly
+(coarse “something changed, re-list” subscription; sync in-process,
+tolerates a promise over the SharedWorker client).</p>
+<p>Sandbox-only: throws <code>failed-precondition</code> on a prod-backed handle (the
+hook surfaces that via <code>error</code>, same as <code>useAuthUsers</code>).</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>auth</code></td><td align="left"><code>Auth</code></td></tr></tbody></table></div>
+<h4 id="returns-26">Returns</h4>
+<p><a href="#useauthproviderconfigresult"><code>UseAuthProviderConfigResult</code></a></p>
+<hr>
+<p><a id="useauthusereditor"></a></p>
+<h3 id="useauthusereditor">useAuthUserEditor()</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"> useAuthUserEditor</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseAuthUserEditorOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseAuthUserEditorResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless add/edit-user state machine (reducer-based, like
+<code>useDocumentEditor</code>): field edits, claims-JSON validation with
+emulator-grade messages, dirtiness vs the initial record, and payload
+builders for <code>useAuthUsers</code>’ <code>createUser</code> / <code>updateUser</code>.</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>options?</code></td><td align="left"><a href="#useauthusereditoroptions"><code>UseAuthUserEditorOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-27">Returns</h4>
+<p><a href="#useauthusereditorresult"><code>UseAuthUserEditorResult</code></a></p>
+<hr>
+<p><a id="useauthusers"></a></p>
+<h3 id="useauthusers">useAuthUsers()</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"> useAuthUsers</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">auth</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Auth</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseAuthUsersResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Live user-admin view over a sandbox <code>Auth</code> handle:
+<code>sandbox.listUsers</code> + <code>sandbox.subscribeUsers</code> + CRUD actions.</p>
+<p>The subscription is coarse (“something changed”): any user-DB
+mutation (from these actions, the running app’s sign-ups, the
+agent’s seeding) triggers a re-list, so the view stays live without
+per-row bookkeeping. Filtering is client-side (the sandbox is
+in-process; there is no server to push the query to).</p>
+<p>Mutation errors (e.g. <code>auth/uid-already-exists</code>) throw to the caller:
+handle them at the call site like the firestore hooks’ <code>createDocument</code>.
+Sandbox-only: throws <code>failed-precondition</code> on a prod-backed handle (the
+hook surfaces that via <code>error</code>).</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>auth</code></td><td align="left"><code>Auth</code></td></tr></tbody></table></div>
+<h4 id="returns-28">Returns</h4>
+<p><a href="#useauthusersresult"><code>UseAuthUsersResult</code></a></p>
+<hr>
+<p><a id="validateauthuserfields"></a></p>
+<h3 id="validateauthuserfields">validateAuthUserFields()</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"> validateAuthUserFields</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">fields</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">AuthUserEditorFields</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">AuthUserEditorErrors</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<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>fields</code></td><td align="left"><a href="#authusereditorfields"><code>AuthUserEditorFields</code></a></td></tr></tbody></table></div>
+<h4 id="returns-29">Returns</h4>
+<p><a href="#authusereditorerrors"><code>AuthUserEditorErrors</code></a></p>
+<hr>
+<p><a id="validateserializedclaims"></a></p>
+<h3 id="validateserializedclaims">validateSerializedClaims()</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"> validateSerializedClaims</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">ClaimsValidationResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Validate the claims textarea’s raw text. Empty input is valid (no
+claims). Messages match the emulator UI verbatim so users see the
+same wording in both tools.</p>
+<h4 id="parameters-23">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>text</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-30">Returns</h4>
+<p><a href="#claimsvalidationresult"><code>ClaimsValidationResult</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="#classes"> Classes </a> <ul> <li data-api-symbol="authflowcontroller"> <a href="#authflowcontroller">AuthFlowController</a> </li> </ul> </section><section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="authproviderconfigentry"> <a href="#authproviderconfigentry">AuthProviderConfigEntry</a> </li><li data-api-symbol="authprovidertogglesprops"> <a href="#authprovidertogglesprops">AuthProviderTogglesProps</a> </li><li data-api-symbol="authsigninhelperprops"> <a href="#authsigninhelperprops">AuthSignInHelperProps</a> </li><li data-api-symbol="authusereditorerrors"> <a href="#authusereditorerrors">AuthUserEditorErrors</a> </li><li data-api-symbol="authusereditorfields"> <a href="#authusereditorfields">AuthUserEditorFields</a> </li><li data-api-symbol="authusereditorstate"> <a href="#authusereditorstate">AuthUserEditorState</a> </li><li data-api-symbol="authuserformfield"> <a href="#authuserformfield">AuthUserFormField</a> </li><li data-api-symbol="authuserformprops"> <a href="#authuserformprops">AuthUserFormProps</a> </li><li data-api-symbol="authuserlistprops"> <a href="#authuserlistprops">AuthUserListProps</a> </li><li data-api-symbol="claimsfieldprops"> <a href="#claimsfieldprops">ClaimsFieldProps</a> </li><li data-api-symbol="clearuserswithconfirmprops"> <a href="#clearuserswithconfirmprops">ClearUsersWithConfirmProps</a> </li><li data-api-symbol="deleteuserwithconfirmprops"> <a href="#deleteuserwithconfirmprops">DeleteUserWithConfirmProps</a> </li><li data-api-symbol="helperstate"> <a href="#helperstate">HelperState</a> </li><li data-api-symbol="newidentityspec"> <a href="#newidentityspec">NewIdentitySpec</a> </li><li data-api-symbol="useauthflowhelperresult"> <a href="#useauthflowhelperresult">UseAuthFlowHelperResult</a> </li><li data-api-symbol="useauthproviderconfigresult"> <a href="#useauthproviderconfigresult">UseAuthProviderConfigResult</a> </li><li data-api-symbol="useauthusereditoroptions"> <a href="#useauthusereditoroptions">UseAuthUserEditorOptions</a> </li><li data-api-symbol="useauthusereditorresult"> <a href="#useauthusereditorresult">UseAuthUserEditorResult</a> </li><li data-api-symbol="useauthusersresult"> <a href="#useauthusersresult">UseAuthUsersResult</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="authapi"> <a href="#authapi">AuthApi</a> </li><li data-api-symbol="authusereditoraction"> <a href="#authusereditoraction">AuthUserEditorAction</a> </li><li data-api-symbol="authuserformfieldname"> <a href="#authuserformfieldname">AuthUserFormFieldName</a> </li><li data-api-symbol="authuserformsubmit"> <a href="#authuserformsubmit">AuthUserFormSubmit</a> </li><li data-api-symbol="claimsvalidationresult"> <a href="#claimsvalidationresult">ClaimsValidationResult</a> </li><li data-api-symbol="sandboxidentity"> <a href="#sandboxidentity">SandboxIdentity</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="custom_claims_max_length"> <a href="#custom_claims_max_length">CUSTOM_CLAIMS_MAX_LENGTH</a> </li><li data-api-symbol="default_known_provider_ids"> <a href="#default_known_provider_ids">DEFAULT_KNOWN_PROVIDER_IDS</a> </li><li data-api-symbol="forbidden_custom_claims"> <a href="#forbidden_custom_claims">FORBIDDEN_CUSTOM_CLAIMS</a> </li><li data-api-symbol="provider_labels"> <a href="#provider_labels">PROVIDER_LABELS</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="authapiprovider()"> <a href="#authapiprovider">AuthApiProvider()</a> </li><li data-api-symbol="authprovidertoggles()"> <a href="#authprovidertoggles">AuthProviderToggles()</a> </li><li data-api-symbol="authsigninhelper()"> <a href="#authsigninhelper">AuthSignInHelper()</a> </li><li data-api-symbol="authusereditorreducer()"> <a href="#authusereditorreducer">authUserEditorReducer()</a> </li><li data-api-symbol="authuserform()"> <a href="#authuserform">AuthUserForm()</a> </li><li data-api-symbol="authuserlist()"> <a href="#authuserlist">AuthUserList()</a> </li><li data-api-symbol="claimsfield()"> <a href="#claimsfield">ClaimsField()</a> </li><li data-api-symbol="clearuserswithconfirm()"> <a href="#clearuserswithconfirm">ClearUsersWithConfirm()</a> </li><li data-api-symbol="deleteuserwithconfirm()"> <a href="#deleteuserwithconfirm">DeleteUserWithConfirm()</a> </li><li data-api-symbol="fieldsfromrecord()"> <a href="#fieldsfromrecord">fieldsFromRecord()</a> </li><li data-api-symbol="initauthusereditorstate()"> <a href="#initauthusereditorstate">initAuthUserEditorState()</a> </li><li data-api-symbol="providerlabel()"> <a href="#providerlabel">providerLabel()</a> </li><li data-api-symbol="tocreaterequest()"> <a href="#tocreaterequest">toCreateRequest()</a> </li><li data-api-symbol="toupdaterequest()"> <a href="#toupdaterequest">toUpdateRequest()</a> </li><li data-api-symbol="useauthapi()"> <a href="#useauthapi">useAuthApi()</a> </li><li data-api-symbol="useauthflowhelper()"> <a href="#useauthflowhelper">useAuthFlowHelper()</a> </li><li data-api-symbol="useauthproviderconfig()"> <a href="#useauthproviderconfig">useAuthProviderConfig()</a> </li><li data-api-symbol="useauthusereditor()"> <a href="#useauthusereditor">useAuthUserEditor()</a> </li><li data-api-symbol="useauthusers()"> <a href="#useauthusers">useAuthUsers()</a> </li><li data-api-symbol="validateauthuserfields()"> <a href="#validateauthuserfields">validateAuthUserFields()</a> </li><li data-api-symbol="validateserializedclaims()"> <a href="#validateserializedclaims">validateSerializedClaims()</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>