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

@@ -0,0 +1,2476 @@
+<!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/storage · Pyric Studio</title><meta name="description" content="Published declarations for @pyric/ui/storage."><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/storage</span> </li> </ol> </nav> <header class="api-reference-header"> <p class="api-reference-kicker">API reference</p> <h1><code>@pyric/ui/storage</code></h1> <p class="api-reference-meta"> 76 published symbols from <code>@pyric/ui</code> </p> <p class="api-reference-source">
+Generated from the TypeScript declarations shipped at this import path.
+</p>  </header> <article class="prose api-reference-body">  <!-- Generated from published package declarations via TypeDoc. Do not edit by hand; run bun run docs:api:generate. -->
+<h2 id="interfaces">Interfaces</h2>
+<p><a id="custommetadataentry"></a></p>
+<h3 id="custommetadataentry">CustomMetadataEntry</h3>
+<p>One <code>customMetadata</code> row. <code>id</code> is a stable render key — keys are
+user-editable, so they can’t key the rows themselves.</p>
+<h4 id="properties">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="error"></a> <code>error?</code></td><td align="left"><code>string</code></td><td align="left">Validation error (<code>'Key is required'</code> / <code>'Duplicate key'</code>).</td></tr><tr><td align="left"><a id="id"></a> <code>id</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="key"></a> <code>key</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">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="deleteselectionwithconfirmprops"></a></p>
+<h3 id="deleteselectionwithconfirmprops">DeleteSelectionWithConfirmProps</h3>
+<h4 id="properties-1">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="body"></a> <code>body?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Confirm-dialog body. Default lists the selected paths.</td></tr><tr><td align="left"><a id="classname"></a> <code>className?</code></td><td align="left"><code>string</code></td><td align="left">Class forwarded to the default trigger button.</td></tr><tr><td align="left"><a id="confirmlabel"></a> <code>confirmLabel?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="entries"></a> <code>entries</code></td><td align="left"><a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>[]</td><td align="left">What to delete — <code>useStorageSelection().selected</code> (or any <code>{kind, fullPath}</code> rows). Folders delete recursively.</td></tr><tr><td align="left"><a id="gate"></a> <code>gate?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#usestoragerulesgateresult"><code>UseStorageRulesGateResult</code></a>, <code>"verdictFor"</code>></td><td align="left">Rules-aware affordance — pass <code>useStorageRulesGate(storage)</code>. When ANY selected entry’s DELETE verdict denies, the trigger disables with the reason (default trigger: <code>data-pyric-denied</code> + <code>data-pyric-denied-reason</code> + <code>title</code>; <code>renderTrigger</code> receives <code>deniedReason</code>). For folder entries the verdict evaluates the folder path itself — an approximation of the recursive walk (descendants matched by <code>{allPaths=**}</code> rules share the verdict).</td></tr><tr><td align="left"><a id="impl"></a> <code>impl?</code></td><td align="left"><a href="#storagerecursivedeleteimpl"><code>StorageRecursiveDeleteImpl</code></a></td><td align="left">Folder-walk impl override (default: the <code>listAll</code>-driven one).</td></tr><tr><td align="left"><a id="list"></a> <code>list?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#usestoragelistresult"><code>UseStorageListResult</code></a>, <code>"insertItem"</code> | <code>"removeItem"</code>></td><td align="left">Optimistic seam from <code>useStorageList</code>.</td></tr><tr><td align="left"><a id="ondeleted"></a> <code>onDeleted?</code></td><td align="left">(<code>outcome</code>: <a href="#storagedeleteoutcome"><code>StorageDeleteOutcome</code></a>) => <code>void</code></td><td align="left">Fired after a run with NO failures (e.g. clear the selection + refresh the list).</td></tr><tr><td align="left"><a id="onfailed"></a> <code>onFailed?</code></td><td align="left">(<code>outcome</code>: <a href="#storagedeleteoutcome"><code>StorageDeleteOutcome</code></a>) => <code>void</code></td><td align="left">Fired after a run with failures (the toast already showed).</td></tr><tr><td align="left"><a id="rendertrigger"></a> <code>renderTrigger?</code></td><td align="left">(<code>props</code>: { <code>deniedReason?</code>: <code>string</code>; <code>disabled</code>: <code>boolean</code>; <code>isRunning</code>: <code>boolean</code>; <code>onClick</code>: () => <code>void</code>; <code>progress</code>: <code>number</code>; }) => <code>ReactNode</code></td><td align="left">Render override for the trigger button.</td></tr><tr><td align="left"><a id="storage"></a> <code>storage</code></td><td align="left"><code>any</code></td><td align="left">The package’s single Storage handle prop.</td></tr><tr><td align="left"><a id="title"></a> <code>title?</code></td><td align="left"><code>string</code></td><td align="left">Confirm-dialog title. Default derives from the entry count.</td></tr></tbody></table></div>
+<hr>
+<p><a id="droppedfile"></a></p>
+<h3 id="droppedfile">DroppedFile</h3>
+<p>One dropped file, flattened from the drop’s file/folder tree.</p>
+<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="file"></a> <code>file</code></td><td align="left"><code>File</code></td><td align="left">-</td></tr><tr><td align="left"><a id="relativepath"></a> <code>relativePath</code></td><td align="left"><code>string</code></td><td align="left">Path relative to the drop — <code>'a.txt'</code> for a plain file drop, <code>'photos/cat.png'</code> for a file inside a dropped folder. Feed straight into <code>useObjectUpload</code>: <code>upload(files.map((f) => ({ path: f.relativePath, data: f.file })))</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="metadataeditorstate"></a></p>
+<h3 id="metadataeditorstate">MetadataEditorState</h3>
+<h4 id="properties-3">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="draft"></a> <code>draft</code></td><td align="left"><code>MetadataDraft</code></td><td align="left">-</td></tr><tr><td align="left"><a id="errorcount"></a> <code>errorCount</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="initial"></a> <code>initial</code></td><td align="left"><code>MetadataDraft</code></td><td align="left">Snapshot for <code>isDirty</code> / <code>reset</code> — same reference-compare semantics as the document editor’s <code>tree !== initial</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="objectbrowserprops"></a></p>
+<h3 id="objectbrowserprops">ObjectBrowserProps</h3>
+<h4 id="properties-4">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="classname-1"></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">-</td></tr><tr><td align="left"><a id="entries-1"></a> <code>entries</code></td><td align="left"><a href="#storagelistentry"><code>StorageListEntry</code></a>[]</td><td align="left">The folders-first row model from <code>useStorageList</code>.</td></tr><tr><td align="left"><a id="error-1"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">Renders a <code>role="alert"</code> container with the message. Pair with the hook’s typed <code>StorageError</code> for code-driven copy.</td></tr><tr><td align="left"><a id="gate-1"></a> <code>gate?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#usestoragerulesgateresult"><code>UseStorageRulesGateResult</code></a>, <code>"verdictFor"</code>></td><td align="left">Rules-aware affordances — pass <code>useStorageRulesGate(storage)</code>. Rows whose READ verdict denies are stamped <code>data-pyric-denied</code> (with the evaluator’s reason trace on <code>data-pyric-denied-reason</code>). A denied folder row would throw <code>storage/unauthorized</code> on <code>listAll</code>; the stamp warns BEFORE the click. Rows stay clickable — the affordance is advisory and the sandbox enforcement layer remains authoritative.</td></tr><tr><td align="left"><a id="onnavigate"></a> <code>onNavigate?</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Folder row click — fired with the prefix’s <code>fullPath</code>. Wire to <code>usePathState.enter</code> (or <code>setPath</code>).</td></tr><tr><td align="left"><a id="onselect"></a> <code>onSelect?</code></td><td align="left">(<code>ref</code>: <code>StorageReference</code>) => <code>void</code></td><td align="left">Object row click — fired with the object’s reference.</td></tr><tr><td align="left"><a id="renderentry"></a> <code>renderEntry?</code></td><td align="left">(<code>entry</code>: <a href="#storagelistentry"><code>StorageListEntry</code></a>) => <code>ReactNode</code></td><td align="left">Row-label slot. Default renders the entry name. The row button, its click wiring, and the <code>data-*</code> states stay with the component — the slot only owns the label content.</td></tr><tr><td align="left"><a id="renderrowaction"></a> <code>renderRowAction?</code></td><td align="left">(<code>entry</code>: <a href="#storagelistentry"><code>StorageListEntry</code></a>) => <code>ReactNode</code></td><td align="left">Optional per-row action rendered as a sibling of the navigation/select button. Use this for independent controls such as selection checkboxes.</td></tr><tr><td align="left"><a id="rowheight"></a> <code>rowHeight?</code></td><td align="left"><code>number</code> | (<code>index</code>: <code>number</code>) => <code>number</code></td><td align="left">Estimated row height when virtualizing. Default 36.</td></tr><tr><td align="left"><a id="selectedpath"></a> <code>selectedPath?</code></td><td align="left"><code>string</code></td><td align="left">Marks the matching object row <code>data-pyric-selected</code> + <code>aria-selected</code>.</td></tr><tr><td align="left"><a id="status"></a> <code>status?</code></td><td align="left"><a href="#storageliststatus"><code>StorageListStatus</code></a></td><td align="left">Drives the loading state (<code>'loading'</code> with no rows yet) and the idle short-circuit. Default <code>'success'</code> for static usage.</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, the list switches to virtualization via <code>&#x3C;VirtualList></code> — <code>listAll</code> has no pagination, so a big prefix arrives as one flat result and virtualization is the only defense. Default 100 (same as <code>&#x3C;DocumentList></code>). <code>Infinity</code> disables.</td></tr></tbody></table></div>
+<hr>
+<p><a id="objectinspectorprops"></a></p>
+<h3 id="objectinspectorprops">ObjectInspectorProps</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="children"></a> <code>children?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Extra content below the preview (metadata editor, delete button, …).</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="path"></a> <code>path</code></td><td align="left"><code>string</code></td><td align="left">Object path to inspect. <code>null</code> renders the idle shell — keep the inspector mounted and swap paths as the user selects rows.</td></tr><tr><td align="left"><a id="previews"></a> <code>previews?</code></td><td align="left"><a href="#storagepreview"><code>StoragePreview</code></a>[]</td><td align="left">Consumer previews, tried BEFORE the built-ins (first match wins) — the extension channel of the preview registry.</td></tr><tr><td align="left"><a id="rendermetadata"></a> <code>renderMetadata?</code></td><td align="left">(<code>metadata</code>: <code>FullMetadata</code>) => <code>ReactNode</code></td><td align="left">Metadata-section slot. Default renders the standard field list. The header, preview, and state wiring stay with the component.</td></tr><tr><td align="left"><a id="storage-1"></a> <code>storage</code></td><td align="left"><code>any</code></td><td align="left">The package’s sandbox Storage handle.</td></tr></tbody></table></div>
+<hr>
+<p><a id="pathbreadcrumbprops"></a></p>
+<h3 id="pathbreadcrumbprops">PathBreadcrumbProps</h3>
+<h4 id="properties-6">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="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="onnavigate-1"></a> <code>onNavigate?</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Fired with the absolute path of the clicked crumb (<code>''</code> for root). Wire to <code>usePathState.setPath</code>.</td></tr><tr><td align="left"><a id="path-1"></a> <code>path</code></td><td align="left"><code>string</code></td><td align="left">Current path. <code>''</code> renders just the root crumb.</td></tr><tr><td align="left"><a id="rootlabel"></a> <code>rootLabel?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Label for the root crumb. Default <code>'/'</code> — pass the bucket name for a <code>gs://bucket</code> feel.</td></tr><tr><td align="left"><a id="separator"></a> <code>separator?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Rendered between crumbs. Default <code>'/'</code>.</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagedeletefailure"></a></p>
+<h3 id="storagedeletefailure">StorageDeleteFailure</h3>
+<p>One entry’s failure in a bulk run. <code>error</code> is the typed
+<code>StorageError</code> (<code>.code</code> e.g. <code>storage/unauthorized</code>).</p>
+<h4 id="properties-7">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="error-2"></a> <code>error</code></td><td align="left"><code>Error</code></td></tr><tr><td align="left"><a id="fullpath"></a> <code>fullPath</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="storagedeleteoutcome"></a></p>
+<h3 id="storagedeleteoutcome">StorageDeleteOutcome</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="deleted"></a> <code>deleted</code></td><td align="left"><code>string</code>[]</td><td align="left">fullPaths of entries fully deleted.</td></tr><tr><td align="left"><a id="failed"></a> <code>failed</code></td><td align="left"><a href="#storagedeletefailure"><code>StorageDeleteFailure</code></a>[]</td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagedeleteprogress"></a></p>
+<h3 id="storagedeleteprogress">StorageDeleteProgress</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="deletedcount"></a> <code>deletedCount</code></td><td align="left"><code>number</code></td><td align="left">Objects deleted so far in this folder walk.</td></tr><tr><td align="left"><a id="done"></a> <code>done</code></td><td align="left"><code>boolean</code></td><td align="left">True for the final emission.</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagegateverdict"></a></p>
+<h3 id="storagegateverdict">StorageGateVerdict</h3>
+<p>Per-path verdict. <code>pyric/storage</code>’s rules subset has exactly two
+verbs (<code>read</code> | <code>write</code> — the granular get/list/create/update/
+delete forms are a parser follow-up), so <code>delete</code> and <code>upload</code> are
+DERIVED aliases of <code>write</code>: Firebase Storage’s <code>write</code> permission
+governs create, overwrite, AND delete.</p>
+<h4 id="properties-10">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="delete"></a> <code>delete</code></td><td align="left"><code>boolean</code></td><td align="left">Derived — always <code>=== write</code> under the two-verb subset.</td></tr><tr><td align="left"><a id="read"></a> <code>read</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="reasons"></a> <code>reasons</code></td><td align="left">{ <code>read</code>: <code>string</code>[]; <code>write</code>: <code>string</code>[]; }</td><td align="left">Evaluator reason traces for DENIED verbs (<code>"no rule matches…"</code> / <code>"match /… : condition false"</code>); empty arrays when allowed. Feed into disabled-state tooltips and <code>data-*-reason</code> attributes.</td></tr><tr><td align="left"><code>reasons.read</code></td><td align="left"><code>string</code>[]</td><td align="left">-</td></tr><tr><td align="left"><code>reasons.write</code></td><td align="left"><code>string</code>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="upload"></a> <code>upload</code></td><td align="left"><code>boolean</code></td><td align="left">Derived — always <code>=== write</code> under the two-verb subset.</td></tr><tr><td align="left"><a id="write"></a> <code>write</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagelistentry"></a></p>
+<h3 id="storagelistentry">StorageListEntry</h3>
+<p>One row of the merged folder/object model, the prefix→folder
+synthesis ported (as an idea, not code) from the emulator UI’s
+<code>useStorageFiles</code>: <code>listAll</code>’s <code>prefixes</code> become <code>kind: 'folder'</code>
+rows, its <code>items</code> become <code>kind: 'object'</code> rows, folders first.</p>
+<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="fullpath-1"></a> <code>fullPath</code></td><td align="left"><code>string</code></td><td align="left">Bucket-rooted path (no trailing slash, even for folders).</td></tr><tr><td align="left"><a id="kind"></a> <code>kind</code></td><td align="left"><code>"object"</code> | <code>"folder"</code></td><td align="left">-</td></tr><tr><td align="left"><a id="name"></a> <code>name</code></td><td align="left"><code>string</code></td><td align="left">Last path segment, display name.</td></tr><tr><td align="left"><a id="ref"></a> <code>ref</code></td><td align="left"><code>StorageReference</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagepreview"></a></p>
+<h3 id="storagepreview">StoragePreview</h3>
+<p>One entry in the content-type preview registry — the storage
+counterpart of the Firestore field-editor registry, keyed by a
+<code>match</code> predicate instead of a type name because content types are
+open-ended. First match wins; consumer previews run BEFORE the
+built-ins, so overriding <code>image/*</code> is just shipping your own
+matcher.</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="id-1"></a> <code>id</code></td><td align="left"><code>string</code></td><td align="left">Diagnostic id — also stamped on the preview container as <code>data-pyric-preview="&#x3C;id>"</code>.</td></tr><tr><td align="left"><a id="match"></a> <code>match</code></td><td align="left">(<code>metadata</code>: <code>FullMetadata</code>) => <code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="maxbytes"></a> <code>maxBytes?</code></td><td align="left"><code>number</code></td><td align="left">Skip the preview (and the blob download) for objects larger than this — the inspector renders its <code>data-pyric-preview-too-large</code> fallback instead. <code>undefined</code> = no cap.</td></tr><tr><td align="left"><a id="needsblob"></a> <code>needsBlob?</code></td><td align="left"><code>boolean</code></td><td align="left">Ask the inspector to <code>loadBlob()</code> before rendering. Default <code>false</code> (metadata-only previews render immediately).</td></tr><tr><td align="left"><a id="render"></a> <code>render</code></td><td align="left">(<code>ctx</code>: <a href="#storagepreviewcontext"><code>StoragePreviewContext</code></a>) => <code>ReactNode</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="storagepreviewcontext"></a></p>
+<h3 id="storagepreviewcontext">StoragePreviewContext</h3>
+<p>What a preview’s <code>render</code> receives. <code>blob</code>/<code>blobUrl</code> are only
+populated for previews that declared <code>needsBlob</code>.</p>
+<h4 id="properties-13">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="blob"></a> <code>blob</code></td><td align="left"><code>Blob</code></td></tr><tr><td align="left"><a id="bloburl"></a> <code>blobUrl</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="metadata"></a> <code>metadata</code></td><td align="left"><code>FullMetadata</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="storagerecursivedeleteimpl"></a></p>
+<h3 id="storagerecursivedeleteimpl">StorageRecursiveDeleteImpl</h3>
+<p>Recursive folder delete implementation — the same injection seam
+as the Firestore half’s <code>RecursiveDeleteImpl</code>. Unlike Firestore
+(where tree-walking needs sandbox introspection or a Cloud
+Function), the public storage surface CAN walk a prefix, so the
+package ships <a href="#createlistalldeleteimpl">createListAllDeleteImpl</a> as the default;
+inject your own for server-driven deletes.</p>
+<h4 id="properties-14">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="start"></a> <code>start</code></td><td align="left">(<code>target</code>: <code>StorageReference</code>) => <code>AsyncIterableIterator</code>&#x3C;<a href="#storagedeleteprogress"><code>StorageDeleteProgress</code></a>></td></tr></tbody></table></div>
+<hr>
+<p><a id="storageselectionentry"></a></p>
+<h3 id="storageselectionentry">StorageSelectionEntry</h3>
+<p>What the selection tracks per row — a structural subset of
+<code>StorageListEntry</code>, so <code>useStorageList</code>’s entries pass straight
+in. The <code>kind</code> decides the delete verb later (object →
+<code>deleteObject</code>, folder → recursive).</p>
+<h4 id="properties-15">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="fullpath-2"></a> <code>fullPath</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><a id="kind-1"></a> <code>kind</code></td><td align="left"><code>"object"</code> | <code>"folder"</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="uploaddropzoneprops"></a></p>
+<h3 id="uploaddropzoneprops">UploadDropzoneProps</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="children-1"></a> <code>children?</code></td><td align="left"><code>ReactNode</code></td><td align="left">Slot — the dropzone chrome (“Drop files here…”, a browse <code>&#x3C;input type="file"></code>, anything). The component owns only the drag wiring + <code>data-*</code> states.</td></tr><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="disabled"></a> <code>disabled?</code></td><td align="left"><code>boolean</code></td><td align="left">Ignore drops + suppress the dragging state.</td></tr><tr><td align="left"><a id="disabledreason"></a> <code>disabledReason?</code></td><td align="left"><code>string</code></td><td align="left">Why the dropzone is disabled — stamped on <code>data-disabled-reason</code> (and only while <code>disabled</code>) so the chrome/styling can surface it. The canonical source is the rules gate: <code>disabled={!gate.verdictFor(path).upload}</code> + <code>disabledReason={gate.verdictFor(path).reasons.write.join('; ')}</code>.</td></tr><tr><td align="left"><a id="onfiles"></a> <code>onFiles</code></td><td align="left">(<code>files</code>: <a href="#droppedfile"><code>DroppedFile</code></a>[]) => <code>void</code></td><td align="left">Fired once per drop with the flattened file list (folder drops are traversed recursively via <code>webkitGetAsEntry</code>; empty folders yield nothing — wire <code>useObjectUpload.createFolder</code> to your own “new folder” affordance instead). Not fired for empty drops.</td></tr></tbody></table></div>
+<hr>
+<p><a id="uploadentry"></a></p>
+<h3 id="uploadentry">UploadEntry</h3>
+<p>Explicit-path upload input. <code>path</code> is relative to the hook’s
+<code>path</code> option (the destination folder).</p>
+<h4 id="properties-17">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><a id="data"></a> <code>data</code></td><td align="left"><code>Blob</code> | <code>ArrayBuffer</code> | <code>Uint8Array</code>&#x3C;<code>ArrayBufferLike</code>></td></tr><tr><td align="left"><a id="metadata-1"></a> <code>metadata?</code></td><td align="left"><code>SettableMetadata</code></td></tr><tr><td align="left"><a id="path-2"></a> <code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<hr>
+<p><a id="uploadtask"></a></p>
+<h3 id="uploadtask">UploadTask</h3>
+<p>One file’s upload, TASK-SHAPED for resumable forward-compat: the
+byte counters and the <code>onProgress</code> callback are in the type NOW so
+a future <code>uploadBytesResumable</code>-backed implementation emits real
+intermediate snapshots without a breaking change. Today
+(<code>pyric/storage</code> has no resumable uploads — COMPAT) a task
+completes in one tick: <code>onProgress</code> fires once at 0 bytes and once
+at <code>totalBytes</code>.</p>
+<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="bytestransferred"></a> <code>bytesTransferred</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="error-3"></a> <code>error?</code></td><td align="left"><code>Error</code></td><td align="left">Populated on <code>'error'</code> — a typed <code>StorageError</code> from the sandbox (<code>.code</code> is <code>storage/&#x3C;code></code>, e.g. <code>storage/unauthorized</code> for a rules-denied write).</td></tr><tr><td align="left"><a id="fullpath-3"></a> <code>fullPath</code></td><td align="left"><code>string</code></td><td align="left">Bucket-rooted destination path.</td></tr><tr><td align="left"><a id="id-2"></a> <code>id</code></td><td align="left"><code>string</code></td><td align="left">Stable id — key task rows on this, not on <code>fullPath</code> (two uploads can target the same path).</td></tr><tr><td align="left"><a id="metadata-2"></a> <code>metadata?</code></td><td align="left"><code>FullMetadata</code></td><td align="left">Populated on <code>'success'</code>.</td></tr><tr><td align="left"><a id="status-1"></a> <code>status</code></td><td align="left"><a href="#uploadtaskstatus-1"><code>UploadTaskStatus</code></a></td><td align="left">-</td></tr><tr><td align="left"><a id="totalbytes"></a> <code>totalBytes</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="usemetadataeditoroptions"></a></p>
+<h3 id="usemetadataeditoroptions">UseMetadataEditorOptions</h3>
+<h4 id="properties-19">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-1"></a> <code>initial?</code></td><td align="left"><code>SettableMetadata</code></td><td align="left">The metadata being edited — the same shape <code>useStorageObject</code>’s <code>metadata</code> carries. Read once on mount (the editor is a stateful workspace, like the document editor); <code>reset()</code> + remount to re-initialize.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usemetadataeditorresult"></a></p>
+<h3 id="usemetadataeditorresult">UseMetadataEditorResult</h3>
+<h4 id="properties-20">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="addcustomentry"></a> <code>addCustomEntry</code></td><td align="left">(<code>key?</code>: <code>string</code>, <code>value?</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="cachecontrol"></a> <code>cacheControl</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="contenttype"></a> <code>contentType</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><a id="custom"></a> <code>custom</code></td><td align="left"><a href="#custommetadataentry"><code>CustomMetadataEntry</code></a>[]</td><td align="left">-</td></tr><tr><td align="left"><a id="dispatch"></a> <code>dispatch</code></td><td align="left">(<code>action</code>: <a href="#metadataeditoraction"><code>MetadataEditorAction</code></a>) => <code>void</code></td><td align="left">Raw dispatch — prefer the named helpers.</td></tr><tr><td align="left"><a id="errorcount-1"></a> <code>errorCount</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isdirty"></a> <code>isDirty</code></td><td align="left"><code>boolean</code></td><td align="left"><code>true</code> once any modifying action fired since the last <code>reset</code>/successful <code>save</code>. Reference-compare semantics — manual re-entry of the original values does NOT clear it.</td></tr><tr><td align="left"><a id="issaving"></a> <code>isSaving</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">Convenience: <code>errorCount === 0</code>.</td></tr><tr><td align="left"><a id="removecustomentry"></a> <code>removeCustomEntry</code></td><td align="left">(<code>id</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="reset"></a> <code>reset</code></td><td align="left">() => <code>void</code></td><td align="left">Restore the initial values. Clears <code>isDirty</code>.</td></tr><tr><td align="left"><a id="save"></a> <code>save</code></td><td align="left">() => <code>Promise</code>&#x3C;<code>any</code>></td><td align="left"><code>updateMetadata(ref(storage, path), toPatch())</code>. Errors surface via <code>saveError</code> (typed <code>StorageError</code>), not throws — resolves <code>undefined</code> on failure or when the draft is invalid. On success the draft becomes the new baseline (<code>isDirty</code> clears) and the fresh <code>FullMetadata</code> is returned.</td></tr><tr><td align="left"><a id="saveerror"></a> <code>saveError</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setcachecontrol"></a> <code>setCacheControl</code></td><td align="left">(<code>value</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setcontenttype"></a> <code>setContentType</code></td><td align="left">(<code>value</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setcustomkey"></a> <code>setCustomKey</code></td><td align="left">(<code>id</code>: <code>string</code>, <code>key</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="setcustomvalue"></a> <code>setCustomValue</code></td><td align="left">(<code>id</code>: <code>string</code>, <code>value</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="topatch"></a> <code>toPatch</code></td><td align="left">() => <code>SettableMetadata</code></td><td align="left">Serialize the draft to an <code>updateMetadata</code> patch. Empty <code>contentType</code>/<code>cacheControl</code> become <code>undefined</code> — which LEAVES the previous value (the sandbox doesn’t model null-clears; see <code>pyric/storage</code>’s <code>updateMetadata</code> doc). <code>customMetadata</code> is always included and replaces wholesale, so row removal works.</td></tr></tbody></table></div>
+<hr>
+<p><a id="useobjectuploadoptions"></a></p>
+<h3 id="useobjectuploadoptions">UseObjectUploadOptions</h3>
+<h4 id="properties-21">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="list-1"></a> <code>list?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#usestoragelistresult"><code>UseStorageListResult</code></a>, <code>"insertItem"</code> | <code>"removeItem"</code>></td><td align="left">Optimistic seam from <code>useStorageList</code>: each upload inserts its path immediately and rolls back via <code>removeItem</code> on failure. Caveat: rolling back an upload that was OVERWRITING an existing object drops that object’s row locally (the seam can’t tell an optimistic row from a listed one) — <code>refresh()</code> restores server truth.</td></tr><tr><td align="left"><a id="oncomplete"></a> <code>onComplete?</code></td><td align="left">(<code>task</code>: <a href="#uploadtask"><code>UploadTask</code></a>) => <code>void</code></td><td align="left">Fired once per task reaching <code>'success'</code>.</td></tr><tr><td align="left"><a id="onerror"></a> <code>onError?</code></td><td align="left">(<code>task</code>: <a href="#uploadtask"><code>UploadTask</code></a>) => <code>void</code></td><td align="left">Fired once per task reaching <code>'error'</code>.</td></tr><tr><td align="left"><a id="onprogress"></a> <code>onProgress?</code></td><td align="left">(<code>task</code>: <a href="#uploadtask"><code>UploadTask</code></a>) => <code>void</code></td><td align="left">Task-shaped progress callback (see <a href="#uploadtask">UploadTask</a>).</td></tr><tr><td align="left"><a id="path-3"></a> <code>path?</code></td><td align="left"><code>string</code></td><td align="left">Destination folder, bucket-rooted. Default <code>''</code> (root). Wire to <code>usePathState().path</code> so uploads land in the browsed folder.</td></tr></tbody></table></div>
+<hr>
+<p><a id="useobjectuploadresult"></a></p>
+<h3 id="useobjectuploadresult">UseObjectUploadResult</h3>
+<h4 id="properties-22">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="clearcompleted"></a> <code>clearCompleted</code></td><td align="left">() => <code>void</code></td><td align="left">Drop settled (<code>success</code>/<code>error</code>) tasks from <code>tasks</code>.</td></tr><tr><td align="left"><a id="createfolder"></a> <code>createFolder</code></td><td align="left">(<code>name</code>: <code>string</code>) => <code>Promise</code>&#x3C;<code>void</code>></td><td align="left">Create an empty folder under the hook’s <code>path</code>: writes the GCS placeholder convention — a zero-byte object named <code>&#x3C;path>/</code> (trailing slash). <code>listAll</code> hides the placeholder from <code>items</code> at every level (it only surfaces as a prefix), so the folder appears in the browser with no phantom file inside. <code>ref()</code> normalizes the trailing slash away, so the placeholder is written through a structural value-object reference the sandbox accepts. Throws the underlying error after rolling back the optimistic prefix insert. ALTERNATIVE: when the store must stay free of placeholder objects (Pyric Studio’s choice), use the client-side pending-prefix mechanism instead — see <code>pendingPrefixes.ts</code> for the reducer and the recorded tradeoff.</td></tr><tr><td align="left"><a id="isuploading"></a> <code>isUploading</code></td><td align="left"><code>boolean</code></td><td align="left"><code>true</code> while any task is <code>'running'</code>.</td></tr><tr><td align="left"><a id="tasks"></a> <code>tasks</code></td><td align="left"><a href="#uploadtask"><code>UploadTask</code></a>[]</td><td align="left">Every task started by this hook instance, oldest first.</td></tr><tr><td align="left"><a id="upload-1"></a> <code>upload</code></td><td align="left">(<code>input</code>: <a href="#uploadinput"><code>UploadInput</code></a> | <a href="#uploadinput"><code>UploadInput</code></a>[]) => <code>Promise</code>&#x3C;<a href="#uploadtask"><code>UploadTask</code></a>[]></td><td align="left">Upload one or many files. Tasks run concurrently; the promise resolves with the settled tasks once ALL finish and never rejects — per-file failures land on <code>task.error</code> (and <code>onError</code>), so one bad file doesn’t mask the others.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usepathstateoptions"></a></p>
+<h3 id="usepathstateoptions">UsePathStateOptions</h3>
+<h4 id="properties-23">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="defaultpath"></a> <code>defaultPath?</code></td><td align="left"><code>string</code></td><td align="left">Uncontrolled initial value. Default <code>''</code> (bucket root).</td></tr><tr><td align="left"><a id="onpathchange"></a> <code>onPathChange?</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Fired with the normalized next path on every navigation. Called in both modes.</td></tr><tr><td align="left"><a id="path-4"></a> <code>path?</code></td><td align="left"><code>string</code></td><td align="left">Controlled value. When provided, the hook derives everything from it and navigation calls only fire <code>onPathChange</code> — the owner owns the state (e.g. a router binding <code>?path=</code>).</td></tr></tbody></table></div>
+<hr>
+<p><a id="usepathstateresult"></a></p>
+<h3 id="usepathstateresult">UsePathStateResult</h3>
+<h4 id="properties-24">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="enter"></a> <code>enter</code></td><td align="left">(<code>nameOrPath</code>: <code>string</code>) => <code>void</code></td><td align="left">Descend into a child folder — accepts a bare name (<code>'sub'</code>) or an absolute path (<code>'docs/sub'</code>, e.g. a prefix’s <code>fullPath</code>).</td></tr><tr><td align="left"><a id="navigatetoindex"></a> <code>navigateToIndex</code></td><td align="left">(<code>index</code>: <code>number</code>) => <code>void</code></td><td align="left">Jump to the ancestor ending at <code>segments[index]</code> — the breadcrumb click. <code>navigateToIndex(-1)</code> (or any negative) is the root.</td></tr><tr><td align="left"><a id="path-5"></a> <code>path</code></td><td align="left"><code>string</code></td><td align="left">Current normalized path. <code>''</code> is the bucket root.</td></tr><tr><td align="left"><a id="segments"></a> <code>segments</code></td><td align="left"><code>string</code>[]</td><td align="left">Path split into segments. <code>[]</code> at root.</td></tr><tr><td align="left"><a id="setpath"></a> <code>setPath</code></td><td align="left">(<code>path</code>: <code>string</code>) => <code>void</code></td><td align="left">Jump to an absolute path (normalized).</td></tr><tr><td align="left"><a id="up"></a> <code>up</code></td><td align="left">() => <code>void</code></td><td align="left">Ascend one level. No-op at root.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestoragedeleteoptions"></a></p>
+<h3 id="usestoragedeleteoptions">UseStorageDeleteOptions</h3>
+<h4 id="properties-25">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="impl-1"></a> <code>impl?</code></td><td align="left"><a href="#storagerecursivedeleteimpl"><code>StorageRecursiveDeleteImpl</code></a></td><td align="left">Folder-walk implementation. Default <a href="#createlistalldeleteimpl">createListAllDeleteImpl</a>.</td></tr><tr><td align="left"><a id="list-2"></a> <code>list?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#usestoragelistresult"><code>UseStorageListResult</code></a>, <code>"insertItem"</code> | <code>"removeItem"</code>></td><td align="left">Optimistic seam from <code>useStorageList</code>: entries vanish from the local list immediately and roll back (object → item, folder → trailing-slash prefix insert) on failure.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestoragedeleteresult"></a></p>
+<h3 id="usestoragedeleteresult">UseStorageDeleteResult</h3>
+<h4 id="properties-26">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="deleteentries"></a> <code>deleteEntries</code></td><td align="left">(<code>entries</code>: <a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>[]) => <code>Promise</code>&#x3C;<a href="#storagedeleteoutcome"><code>StorageDeleteOutcome</code></a>></td><td align="left">Delete a mixed object/folder selection (objects via <code>deleteObject</code>, folders via the recursive impl), sequentially in selection order. Resolves with the outcome and never rejects — per-entry failures land in <code>outcome.failed</code> (and <code>error</code> keeps the first one for simple renders).</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">First failure of the current/last run. Cleared on the next call.</td></tr><tr><td align="left"><a id="isrunning"></a> <code>isRunning</code></td><td align="left"><code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="progress"></a> <code>progress</code></td><td align="left"><code>number</code></td><td align="left">Objects deleted in the current/last run (folder walks included).</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestoragelistresult"></a></p>
+<h3 id="usestoragelistresult">UseStorageListResult</h3>
+<h4 id="properties-27">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="entries-2"></a> <code>entries</code></td><td align="left"><a href="#storagelistentry"><code>StorageListEntry</code></a>[]</td><td align="left">Folders-first merged row model. Derived from <code>prefixes</code> + <code>items</code>.</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"><code>StorageError</code> (with a typed <code>storage/&#x3C;code></code> on <code>.code</code>) from the sandbox. A denied list is <code>error.code === 'storage/unauthorized'</code> (ST-B2).</td></tr><tr><td align="left"><a id="insertitem"></a> <code>insertItem</code></td><td align="left">(<code>fullPath</code>: <code>string</code>) => <code>void</code></td><td align="left">Optimistic seam (consumed by M3 upload / M6 bulk ops, exposed now so those hooks layer on without reshaping this one). Inserts <code>fullPath</code> into the local list immediately, applying the same prefix→folder synthesis <code>listAll</code> would: a direct child becomes an item, a deeper descendant surfaces as its first-segment folder. A trailing slash declares a folder (the GCS placeholder convention <code>useObjectUpload.createFolder</code> writes): a direct trailing-slash child inserts a prefix, not an item. No-op for paths outside the listed path, duplicates, or when <code>status</code> is <code>'idle'</code>. What each call ACTUALLY inserted is recorded (keyed by the given <code>fullPath</code>) so <code>removeItem</code> can reverse it precisely. Rollback = <code>removeItem</code> or <code>refresh</code>.</td></tr><tr><td align="left"><a id="items"></a> <code>items</code></td><td align="left"><code>StorageReference</code>[]</td><td align="left">Direct child objects under <code>path</code>. Sorted by <code>fullPath</code>.</td></tr><tr><td align="left"><a id="prefixes"></a> <code>prefixes</code></td><td align="left"><code>StorageReference</code>[]</td><td align="left">Synthetic folder prefixes under <code>path</code>. Sorted by <code>fullPath</code>.</td></tr><tr><td align="left"><a id="refresh"></a> <code>refresh</code></td><td align="left">() => <code>void</code></td><td align="left">Re-run <code>listAll</code> for the current path.</td></tr><tr><td align="left"><a id="removeitem"></a> <code>removeItem</code></td><td align="left">(<code>fullPath</code>: <code>string</code>) => <code>void</code></td><td align="left">Optimistic counterpart. When <code>fullPath</code> was previously given to <code>insertItem</code>, this reverses EXACTLY what that call inserted: a deep upload that synthesized a first-segment folder row removes that folder row, and an insert that was a no-op (the row already existed — e.g. a real, listed folder) removes NOTHING, so a failed upload can never delete server-truth rows. For paths never seen by <code>insertItem</code> it removes the matching item/folder row directly (the optimistic-delete use). Rollback = <code>refresh</code>.</td></tr><tr><td align="left"><a id="status-2"></a> <code>status</code></td><td align="left"><a href="#storageliststatus"><code>StorageListStatus</code></a></td><td align="left"><code>'idle'</code> only when <code>storage</code> is null/undefined.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestorageobjectresult"></a></p>
+<h3 id="usestorageobjectresult">UseStorageObjectResult</h3>
+<h4 id="properties-28">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="blob-1"></a> <code>blob</code></td><td align="left"><code>Blob</code></td><td align="left">-</td></tr><tr><td align="left"><a id="bloberror"></a> <code>blobError</code></td><td align="left"><code>Error</code></td><td align="left">-</td></tr><tr><td align="left"><a id="blobstatus"></a> <code>blobStatus</code></td><td align="left"><a href="#storageobjectstatus"><code>StorageObjectStatus</code></a></td><td align="left">Blob read state. Stays <code>'idle'</code> until <code>loadBlob()</code>, the blob is LAZY; metadata alone never downloads bytes.</td></tr><tr><td align="left"><a id="bloburl-1"></a> <code>blobUrl</code></td><td align="left"><code>string</code></td><td align="left"><code>URL.createObjectURL</code> handle for the loaded blob, used as the local preview channel. Revoked automatically when the blob is replaced, the path changes, or the hook unmounts.</td></tr><tr><td align="left"><a id="error-6"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">Typed <code>StorageError</code> (<code>storage/object-not-found</code>, <code>storage/unauthorized</code>, …).</td></tr><tr><td align="left"><a id="loadblob"></a> <code>loadBlob</code></td><td align="left">() => <code>void</code></td><td align="left">Fetch the bytes via <code>getBlob</code>. Subsequent calls re-fetch.</td></tr><tr><td align="left"><a id="metadata-3"></a> <code>metadata</code></td><td align="left"><code>any</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-read the metadata (also resets the blob, the object may have been overwritten).</td></tr><tr><td align="left"><a id="status-3"></a> <code>status</code></td><td align="left"><a href="#storageobjectstatus"><code>StorageObjectStatus</code></a></td><td align="left">Metadata read state. <code>'idle'</code> when <code>storage</code> or <code>path</code> is null.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestoragerulesgateoptions"></a></p>
+<h3 id="usestoragerulesgateoptions">UseStorageRulesGateOptions</h3>
+<h4 id="properties-29">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="identity"></a> <code>identity?</code></td><td align="left"><code>any</code></td><td align="left">Identity override. <code>null</code> is anonymous; OMIT the field to use the handle’s own identity (the sandbox context’s <code>auth</code>).</td></tr><tr><td align="left"><a id="paths"></a> <code>paths?</code></td><td align="left"><code>string</code> | readonly <code>string</code>[]</td><td align="left">Path (or paths) to pre-evaluate into <code>verdicts</code>, keyed by the normalized path. Ad-hoc paths (e.g. browser rows) go through <code>verdictFor</code> instead — the two are the same evaluation.</td></tr><tr><td align="left"><a id="rules"></a> <code>rules?</code></td><td align="left"><code>any</code></td><td align="left">Explicit rules source — raw rules text (parsed here; a malformed string surfaces as <code>status: 'error'</code>) or a pre-parsed <code>StorageRules</code> handle. Overrides the sandbox’s deployed ruleset when both exist.</td></tr><tr><td align="left"><a id="writeresource"></a> <code>writeResource?</code></td><td align="left">{ <code>contentType?</code>: <code>string</code>; <code>size</code>: <code>number</code>; }</td><td align="left">The about-to-write payload bound to <code>request.resource</code> for the WRITE evaluation — pass <code>{ size, contentType }</code> when gating a specific upload so size/contentType-conditioned rules evaluate truthfully. When omitted, <code>request.resource</code> is unset, which is exactly DELETE semantics (deletes carry no inbound payload) — a rule like <code>request.resource.size &#x3C; N</code> then denies, the conservative answer for uploads.</td></tr><tr><td align="left"><code>writeResource.contentType?</code></td><td align="left"><code>string</code></td><td align="left">-</td></tr><tr><td align="left"><code>writeResource.size</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestoragerulesgateresult"></a></p>
+<h3 id="usestoragerulesgateresult">UseStorageRulesGateResult</h3>
+<h4 id="properties-30">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="advisory"></a> <code>advisory</code></td><td align="left"><code>boolean</code></td><td align="left">Always false: <code>pyric/storage</code> handles are sandbox mirrors.</td></tr><tr><td align="left"><a id="error-7"></a> <code>error</code></td><td align="left"><code>Error</code></td><td align="left">Rules-resolution failure (e.g. a malformed <code>rules</code> string).</td></tr><tr><td align="left"><a id="identity-1"></a> <code>identity</code></td><td align="left"><code>any</code></td><td align="left">The identity the verdicts evaluate under.</td></tr><tr><td align="left"><a id="source"></a> <code>source</code></td><td align="left"><a href="#storagerulessource"><code>StorageRulesSource</code></a></td><td align="left">Where the active ruleset came from.</td></tr><tr><td align="left"><a id="status-4"></a> <code>status</code></td><td align="left"><a href="#storagerulesgatestatus"><code>StorageRulesGateStatus</code></a></td><td align="left"><code>'idle'</code> only when <code>storage</code> is null/undefined.</td></tr><tr><td align="left"><a id="verdictfor"></a> <code>verdictFor</code></td><td align="left">(<code>path</code>: <code>string</code>) => <a href="#storagegateverdict"><code>StorageGateVerdict</code></a></td><td align="left">Evaluate an arbitrary path under the current ruleset + identity. Pure and synchronous once <code>status</code> is <code>'ready'</code>; before that (and whenever no rules are reachable) it returns the allow-all verdict — the gate FAILS OPEN, because affordances are advisory and the real enforcement (sandbox throw / server denial) stays authoritative.</td></tr><tr><td align="left"><a id="verdicts"></a> <code>verdicts</code></td><td align="left"><code>Record</code>&#x3C;<code>string</code>, <a href="#storagegateverdict"><code>StorageGateVerdict</code></a>></td><td align="left">Pre-evaluated verdicts for <code>options.paths</code>, keyed by normalized path.</td></tr></tbody></table></div>
+<hr>
+<p><a id="usestorageselectionresult"></a></p>
+<h3 id="usestorageselectionresult">UseStorageSelectionResult</h3>
+<h4 id="properties-31">Properties</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Property</th><th align="left">Type</th><th align="left">Description</th></tr></thead><tbody><tr><td align="left"><a id="clear"></a> <code>clear</code></td><td align="left">() => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="deselect"></a> <code>deselect</code></td><td align="left">(<code>fullPath</code>: <code>string</code>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="isselected"></a> <code>isSelected</code></td><td align="left">(<code>fullPath</code>: <code>string</code>) => <code>boolean</code></td><td align="left">-</td></tr><tr><td align="left"><a id="select"></a> <code>select</code></td><td align="left">(<code>entry</code>: <a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>) => <code>void</code></td><td align="left">-</td></tr><tr><td align="left"><a id="selectall"></a> <code>selectAll</code></td><td align="left">(<code>entries</code>: <a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>[]) => <code>void</code></td><td align="left">Replace the selection (e.g. a “select all” over <code>list.entries</code>).</td></tr><tr><td align="left"><a id="selected"></a> <code>selected</code></td><td align="left"><a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>[]</td><td align="left">Selected entries in selection order.</td></tr><tr><td align="left"><a id="size"></a> <code>size</code></td><td align="left"><code>number</code></td><td align="left">-</td></tr><tr><td align="left"><a id="toggle"></a> <code>toggle</code></td><td align="left">(<code>entry</code>: <a href="#storageselectionentry"><code>StorageSelectionEntry</code></a>) => <code>void</code></td><td align="left">Add/remove — the checkbox verb.</td></tr></tbody></table></div>
+<h2 id="type-aliases">Type Aliases</h2>
+<p><a id="metadataeditoraction"></a></p>
+<h3 id="metadataeditoraction">MetadataEditorAction</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"> MetadataEditorAction</span><span style="color:#56B6C2"> =</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">"setContentType"</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">string</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">"setCacheControl"</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">string</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">  id</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">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomKey"</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">  id</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomValue"</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">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addCustomEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#C678DD">?</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>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  id</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"removeCustomEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"commit"</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">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setContentType"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setContentType"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="value">value</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCacheControl"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-1">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCacheControl"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="value-1">value</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  id</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">  key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomKey"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="id">id</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">id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="key">key</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-2">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomKey"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomValue"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="id-1">id</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">id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-3">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"setCustomValue"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="value-2">value</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  key</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addCustomEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  value</span><span style="color:#C678DD">?:</span><span style="color:#E06C75"> string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="key-1">key?</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">optional</span><span style="color:#E06C75"> key</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-4">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"addCustomEntry"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="value-3">value?</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">optional</span><span style="color:#E06C75"> value</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"removeCustomEntry"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="id-2">id</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">id</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-5">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"removeCustomEntry"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-6">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"reset"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"commit"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-7">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"commit"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Internal — a successful save makes the draft the new baseline.</p>
+<hr>
+<p><a id="pendingprefixaction"></a></p>
+<h3 id="pendingprefixaction">PendingPrefixAction</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"> PendingPrefixAction</span><span style="color:#56B6C2"> =</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"create"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"materialize"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span>
+<span class="line"><span style="color:#ABB2BF">  | {</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"discard"</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">"clear"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<h4 id="type-declaration-1">Type Declaration</h4>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"create"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path">path</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-8">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"create"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Create a folder at <code>path</code> (absolute, bucket-rooted; nested paths
+allowed) — adds the full ancestor chain.</p>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"materialize"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path-1">path</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-9">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"materialize"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>An object now exists directly under <code>path</code>: drop <code>path</code> and its
+ancestors from pending (they are real prefixes now).</p>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"discard"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="path-2">path</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">path</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="type-10">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"discard"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Remove a session-only folder and every pending descendant beneath it.</p>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"clear"</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="type-11">type</h5>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#E06C75">type</span><span style="color:#ABB2BF">: </span><span style="color:#98C379">"clear"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="pendingprefixstate"></a></p>
+<h3 id="pendingprefixstate">PendingPrefixState</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"> PendingPrefixState</span><span style="color:#56B6C2"> =</span><span style="color:#C678DD"> readonly</span><span style="color:#E5C07B"> string</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p>Sorted, deduped, normalized pending prefix paths.</p>
+<hr>
+<p><a id="storageapi"></a></p>
+<h3 id="storageapi">StorageApi</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"> StorageApi</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> Pick</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"ref"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"listAll"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"getMetadata"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"getBlob"</span></span>
+<span class="line"><span style="color:#ABB2BF">  | </span><span style="color:#98C379">"uploadBytes"</span></span>
+<span class="line"><span style="color:#ABB2BF">| </span><span style="color:#98C379">"deleteObject"</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>The modular Storage fns the browse/inspect hooks call, as an INJECTABLE
+bundle (same pattern as <code>@pyric/ui</code>’s FirestoreApi / AuthApi).</p>
+<p>Default = in-process <code>pyric/storage</code>, so existing consumers are unchanged.
+Pyric Studio served mode injects the SharedWorker client bundle so the Storage
+surface browses the live worker object store. These ops are already async, so
+no sync/async wrinkle (unlike auth <code>listUsers</code>); the worker handles/refs are
+runtime-compatible at the surface the hooks use (<code>.fullPath</code> / <code>.name</code>).</p>
+<p><code>uploadBytes</code> rides the same seam so <code>useObjectUpload</code> follows the injected
+backend: in-process writes are uncapped; the worker client’s <code>uploadBytes</code>
+(base64 <code>storage.putBytes</code> over the MessagePort) enforces an 8 MiB payload
+cap on both ends — an over-cap upload fails that file’s task with the typed
+<code>storage/...</code> too-large error and the rest of the batch proceeds.</p>
+<p>NOTE the rules gate (<code>useStorageRulesGate</code>) is NOT here: it reads in-process
+rules internals and no-ops on a handle without them (worker handles), which is
+the correct degrade (the worker enforces read rules on <code>listAll</code> server-side).</p>
+<hr>
+<p><a id="storageliststatus"></a></p>
+<h3 id="storageliststatus">StorageListStatus</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"> StorageListStatus</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "idle"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"loading"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"success"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"error"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="storageobjectstatus"></a></p>
+<h3 id="storageobjectstatus">StorageObjectStatus</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"> StorageObjectStatus</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "idle"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"loading"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"success"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"error"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="storagerulesgatestatus"></a></p>
+<h3 id="storagerulesgatestatus">StorageRulesGateStatus</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"> StorageRulesGateStatus</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "idle"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"loading"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"ready"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"error"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="storagerulessource"></a></p>
+<h3 id="storagerulessource">StorageRulesSource</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"> StorageRulesSource</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "option"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"sandbox"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"none"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Where the active ruleset came from:</p>
+<ul>
+<li><code>'option'</code> — the explicit <code>rules</code> option (string or pre-parsed).</li>
+<li><code>'sandbox'</code> — the ruleset deployed on the sandbox handle
+(<code>getStorageSandbox(ctx, { rules })</code>), read off the handle’s
+<code>StorageService</code>.</li>
+<li><code>'none'</code> — no rules reachable. Every verdict allows
+(open-by-default, the same semantics <code>pyric/storage</code>’s
+enforcement layer applies when no rules are configured).</li>
+</ul>
+<hr>
+<p><a id="uploadinput"></a></p>
+<h3 id="uploadinput">UploadInput</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"> UploadInput</span><span style="color:#56B6C2"> =</span><span style="color:#E5C07B"> File</span><span style="color:#ABB2BF"> | </span><span style="color:#E5C07B">UploadEntry</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p><code>upload()</code> accepts plain <code>File</code>s (destination = the file’s
+<code>webkitRelativePath</code> when present — folder drops keep their
+structure — else its <code>name</code>) or explicit <a href="#uploadentry">UploadEntry</a>s.</p>
+<hr>
+<p><a id="uploadtaskstatus-1"></a></p>
+<h3 id="uploadtaskstatus">UploadTaskStatus</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"> UploadTaskStatus</span><span style="color:#56B6C2"> =</span><span style="color:#98C379"> "running"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"success"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"error"</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h2 id="variables">Variables</h2>
+<p><a id="defaultstoragepreviews"></a></p>
+<h3 id="defaultstoragepreviews">defaultStoragePreviews</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"> defaultStoragePreviews</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReadonlyArray</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">StoragePreview</span><span style="color:#ABB2BF">>;</span></span></code></pre>
+<p>The section 3 defaults: image, text/json; everything else is
+metadata-only (the inspector’s <code>data-pyric-preview-none</code> state).</p>
+<hr>
+<p><a id="imagepreview"></a></p>
+<h3 id="imagepreview">imagePreview</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"> imagePreview</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">StoragePreview</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p><code>image/*</code> → blob-URL <code>&#x3C;img></code>.</p>
+<hr>
+<p><a id="initialpendingprefixes"></a></p>
+<h3 id="initialpendingprefixes">initialPendingPrefixes</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"> initialPendingPrefixes</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PendingPrefixState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="text_preview_max_bytes"></a></p>
+<h3 id="text_preview_max_bytes">TEXT_PREVIEW_MAX_BYTES</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"> TEXT_PREVIEW_MAX_BYTES</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>256KB — the section 3 default cap for the text-family preview.</p>
+<hr>
+<p><a id="textpreview"></a></p>
+<h3 id="textpreview">textPreview</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"> textPreview</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">StoragePreview</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p><code>text/*</code> + <code>application/json</code> → text panel, 256KB cap (bigger
+objects fall through to the too-large fallback). JSON is
+pretty-printed when parseable.</p>
+<h2 id="functions">Functions</h2>
+<p><a id="createlistalldeleteimpl"></a></p>
+<h3 id="createlistalldeleteimpl">createListAllDeleteImpl()</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"> createListAllDeleteImpl</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">api</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">Pick</span><span style="color:#ABB2BF">&#x3C;</span><span style="color:#E5C07B">StorageApi</span><span style="color:#ABB2BF">, </span><span style="color:#98C379">"listAll"</span><span style="color:#ABB2BF"> | </span><span style="color:#98C379">"deleteObject"</span><span style="color:#ABB2BF">>): </span><span style="color:#E5C07B">StorageRecursiveDeleteImpl</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>The default, <code>listAll</code>-driven impl: walks the prefix tree,
+<code>deleteObject</code>s every item (yielding progress per object), then
+sweeps each visited folder’s <code>&#x3C;path>/</code> placeholder so emptied
+create-folder folders disappear too (<code>listAll</code> hides placeholders,
+so the walk alone would leave ghost folders). Placeholder sweeps
+are best-effort — <code>deletedCount</code> counts listed objects only.</p>
+<h4 id="parameters">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>api?</code></td><td align="left"><code>Pick</code>&#x3C;<a href="#storageapi"><code>StorageApi</code></a>, <code>"listAll"</code> | <code>"deleteObject"</code>></td></tr></tbody></table></div>
+<h4 id="returns">Returns</h4>
+<p><a href="#storagerecursivedeleteimpl"><code>StorageRecursiveDeleteImpl</code></a></p>
+<hr>
+<p><a id="deleteselectionwithconfirm"></a></p>
+<h3 id="deleteselectionwithconfirm">DeleteSelectionWithConfirm()</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"> DeleteSelectionWithConfirm</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">DeleteSelectionWithConfirmProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Bulk delete behind the confirm-dialog primitive, with toasts on
+outcome — wires <code>useConfirm</code> + <code>useStorageDelete</code> + <code>useToast</code> the
+way <code>&#x3C;DeleteWithConfirm></code> wires the Firestore trio. Requires
+<code>&#x3C;ConfirmProvider></code> AND <code>&#x3C;ToastProvider></code> ancestors.</p>
+<p>Outcome toasts: all-success → one <code>success</code> toast with the count;
+any failure → an <code>error</code> toast listing each failed path with its
+typed <code>StorageError.code</code>.</p>
+<p>The default trigger styles via <code>[data-pyric-ui="delete-selection"]</code>
+(+ <code>[data-pyric-destructive]</code>, <code>[data-pyric-running]</code>,
+<code>[data-pyric-denied]</code> with the reason on
+<code>data-pyric-denied-reason</code>/<code>title</code>); it disables while running,
+when <code>entries</code> is empty, or when the rules <code>gate</code> denies the
+selection.</p>
+<h4 id="parameters-1">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>__namedParameters</code></td><td align="left"><a href="#deleteselectionwithconfirmprops"><code>DeleteSelectionWithConfirmProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-1">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="expandpathchain"></a></p>
+<h3 id="expandpathchain">expandPathChain()</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"> expandPathChain</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">[];</span></span></code></pre>
+<p><code>'a/b/c'</code> → <code>['a', 'a/b', 'a/b/c']</code>; <code>''</code> → <code>[]</code>.</p>
+<h4 id="parameters-2">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-2">Returns</h4>
+<p><code>string</code>[]</p>
+<hr>
+<p><a id="folderinputerror"></a></p>
+<h3 id="folderinputerror">folderInputError()</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"> folderInputError</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">input</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Validate a create-folder input (relative to the current folder;
+nested <code>a/b/c</code> allowed — VS Code semantics). Returns an error
+message or <code>null</code> when valid. Normalization tolerates stray/repeat
+slashes; <code>.</code>/<code>..</code> segments are rejected (GCS object names have no
+dot-segment semantics — accepting them would create unreachable
+names).</p>
+<h4 id="parameters-3">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>input</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-3">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="initmetadataeditorstate"></a></p>
+<h3 id="initmetadataeditorstate">initMetadataEditorState()</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"> initMetadataEditorState</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">initial</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">MetadataEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Build the edit state from the metadata a <code>getMetadata</code> /
+<code>useStorageObject</code> read returned.</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>initial</code></td><td align="left"><code>any</code></td></tr></tbody></table></div>
+<h4 id="returns-4">Returns</h4>
+<p><a href="#metadataeditorstate"><code>MetadataEditorState</code></a></p>
+<hr>
+<p><a id="ispendingprefix"></a></p>
+<h3 id="ispendingprefix">isPendingPrefix()</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"> isPendingPrefix</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PendingPrefixState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">boolean</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Whether <code>path</code> itself is a pending (session-only) folder.</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>state</code></td><td align="left"><a href="#pendingprefixstate"><code>PendingPrefixState</code></a></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-5">Returns</h4>
+<p><code>boolean</code></p>
+<hr>
+<p><a id="metadataeditorreducer"></a></p>
+<h3 id="metadataeditorreducer">metadataEditorReducer()</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"> metadataEditorReducer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">MetadataEditorState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">action</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">MetadataEditorAction</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">MetadataEditorState</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Pure reducer — exported (with <a href="#initmetadataeditorstate">initMetadataEditorState</a>) so
+the edit state is testable without React, mirroring the document
+editor’s reducer/hook split.</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>state</code></td><td align="left"><a href="#metadataeditorstate"><code>MetadataEditorState</code></a></td></tr><tr><td align="left"><code>action</code></td><td align="left"><a href="#metadataeditoraction"><code>MetadataEditorAction</code></a></td></tr></tbody></table></div>
+<h4 id="returns-6">Returns</h4>
+<p><a href="#metadataeditorstate"><code>MetadataEditorState</code></a></p>
+<hr>
+<p><a id="normalizestoragepath"></a></p>
+<h3 id="normalizestoragepath">normalizeStoragePath()</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"> normalizeStoragePath</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Strip leading/trailing slashes and collapse repeats — mirrors
+<code>pyric/storage</code>’s reference normalization so <code>usePathState</code> and
+<code>useStorageList</code> always agree on what a path is.</p>
+<h4 id="parameters-7">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-7">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="objectbrowser"></a></p>
+<h3 id="objectbrowser">ObjectBrowser()</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"> ObjectBrowser</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ObjectBrowserProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless storage browser shell — renders <code>useStorageList</code>’s merged
+folder/object rows. Folder rows navigate (<code>onNavigate</code> with the
+prefix path), object rows select (<code>onSelect</code> with the ref). Below
+<code>virtualizeThreshold</code> renders a plain <code>&#x3C;ul></code>; above it, composes
+the package’s <code>&#x3C;VirtualList></code>.</p>
+<p>Ships no visual styling. Consumers style via:</p>
+<ul>
+<li><code>[data-pyric-ui="object-browser"]</code> — the root (stamps <code>data-size</code>)</li>
+<li><code>…[data-pyric-loading]</code> / <code>[data-pyric-empty]</code> / <code>[data-pyric-error]</code></li>
+<li><code>…[data-pyric-virtualized]</code> — virtualized mode</li>
+<li><code>[data-pyric-object-browser-items]</code> — the <code>&#x3C;ul></code> in plain mode</li>
+<li><code>[data-pyric-storage-entry]</code> — each row</li>
+<li><code>[data-pyric-storage-entry][data-pyric-entry-kind="folder"|"object"]</code></li>
+<li><code>[data-pyric-storage-entry][data-pyric-entry-path="docs/a.txt"]</code></li>
+<li><code>[data-pyric-storage-entry][data-pyric-denied]</code> — read-denied row
+(rules gate; reason on <code>data-pyric-denied-reason</code>)</li>
+<li><code>[data-pyric-entry-select]</code> — the row button</li>
+<li><code>[data-pyric-entry-select][data-pyric-selected]</code> — the selected object</li>
+<li><code>[data-pyric-storage-action]</code> — optional sibling row action</li>
+</ul>
+<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="#objectbrowserprops"><code>ObjectBrowserProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-8">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="objectinspector"></a></p>
+<h3 id="objectinspector">ObjectInspector()</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"> ObjectInspector</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ObjectInspectorProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless inspector for one storage object: metadata + a
+content-type-driven preview. Previews come from the registry
+(<code>image/*</code> and <code>text/* + application/json</code> built in; extend via
+<code>previews</code>). Blob bytes load lazily and ONLY when the matched
+preview asks (<code>needsBlob</code>) and the object is within the preview’s
+<code>maxBytes</code> cap; the blob URL is revoked on unmount/path change
+(see <code>useStorageObject</code>).</p>
+<p>Ships no visual styling. Consumers style via:</p>
+<ul>
+<li><code>[data-pyric-ui="object-inspector"]</code> — root (stamps <code>data-size</code>)</li>
+<li><code>…[data-pyric-idle]</code> / <code>[data-pyric-loading]</code> / <code>[data-pyric-error]</code></li>
+<li><code>[data-pyric-object-name]</code> / <code>[data-pyric-object-metadata]</code></li>
+<li><code>[data-pyric-metadata-field="&#x3C;field>"]</code> — each metadata row</li>
+<li><code>[data-pyric-object-preview]</code> — the preview container, stamping
+<code>data-pyric-preview="&#x3C;id>"</code> for the matched registry entry</li>
+<li><code>…[data-pyric-preview-loading]</code> — blob in flight</li>
+<li><code>…[data-pyric-preview-error]</code> — blob load failed</li>
+<li><code>…[data-pyric-preview-too-large]</code> — over the preview’s cap</li>
+<li><code>…[data-pyric-preview-none]</code> — no registry match (metadata-only)</li>
+</ul>
+<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="#objectinspectorprops"><code>ObjectInspectorProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-9">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="parsecopycounter"></a></p>
+<h3 id="parsecopycounter">parseCopyCounter()</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"> parseCopyCounter</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">stem</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">  base</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">  counter</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">number</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">};</span></span></code></pre>
+<p>Trailing <code> (n)</code> counter: <code>photo (3)</code> → base <code>photo</code>, counter 3.
+<code>counter: null</code> when the stem carries none. A counter beyond
+<code>Number.MAX_SAFE_INTEGER</code> is treated as plain text (no counter):
+incrementing it would be lossy — <code>n + 1 === n</code> in float land, which
+turns <a href="#resolvecollision">resolveCollision</a>’s probe loop into a hang — and the
+candidate would render in scientific notation anyway.</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>stem</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-10">Returns</h4>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  base</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">  counter</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="base">base</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">base</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="counter">counter</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">counter</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">number</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="pathbreadcrumb"></a></p>
+<h3 id="pathbreadcrumb">PathBreadcrumb()</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"> PathBreadcrumb</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PathBreadcrumbProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless breadcrumb for storage paths. Every crumb (including the
+current one) is a real <code>&#x3C;button></code> — clicking the current crumb is
+a cheap “refresh this level” affordance for consumers that wire
+<code>onNavigate</code> to a path-keyed loader.</p>
+<p>Ships no visual styling. Consumers style via:</p>
+<ul>
+<li><code>[data-pyric-ui="path-breadcrumb"]</code> — the <code>&#x3C;nav></code> root</li>
+<li><code>[data-pyric-breadcrumb-item]</code> — each <code>&#x3C;li></code></li>
+<li><code>[data-pyric-breadcrumb-link]</code> — each crumb button</li>
+<li><code>[data-pyric-breadcrumb-link][data-pyric-current]</code> — the current level</li>
+<li><code>[data-pyric-breadcrumb-root]</code> — the root crumb’s button</li>
+<li><code>[data-pyric-breadcrumb-separator]</code> — the separators</li>
+</ul>
+<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="#pathbreadcrumbprops"><code>PathBreadcrumbProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-11">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="pendingchildfolders"></a></p>
+<h3 id="pendingchildfolders">pendingChildFolders()</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"> pendingChildFolders</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PendingPrefixState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">parentPath</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>Direct-child folder NAMES pending under <code>parentPath</code> (<code>''</code> = root),
+sorted. The chain expansion guarantees every level is present, so a
+simple parent match is exact.</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>state</code></td><td align="left"><a href="#pendingprefixstate"><code>PendingPrefixState</code></a></td></tr><tr><td align="left"><code>parentPath</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-12">Returns</h4>
+<p><code>string</code>[]</p>
+<hr>
+<p><a id="pendingprefixreducer"></a></p>
+<h3 id="pendingprefixreducer">pendingPrefixReducer()</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"> pendingPrefixReducer</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">state</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PendingPrefixState</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">action</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">PendingPrefixAction</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">PendingPrefixState</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>state</code></td><td align="left"><a href="#pendingprefixstate"><code>PendingPrefixState</code></a></td></tr><tr><td align="left"><code>action</code></td><td align="left"><a href="#pendingprefixaction"><code>PendingPrefixAction</code></a></td></tr></tbody></table></div>
+<h4 id="returns-13">Returns</h4>
+<p><a href="#pendingprefixstate"><code>PendingPrefixState</code></a></p>
+<hr>
+<p><a id="planbatchnames"></a></p>
+<h3 id="planbatchnames">planBatchNames()</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"> planBatchNames</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">relativePaths</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> string</span><span style="color:#ABB2BF">[], </span><span style="color:#E06C75;font-style:italic">taken</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReadonlySet</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>Resolve a whole drop/pick batch against the destination folder’s
+existing names, with OS drop semantics: collisions are detected and
+renamed at the batch’s TOP LEVEL only (the names the OS drop
+“creates” in the destination — a plain file’s name, or a dropped
+folder’s root segment). Files inside a dropped folder ride their
+folder’s rename and keep their inner structure untouched — exactly
+like dropping <code>photos/</code> next to an existing <code>photos/</code> yields
+<code>photos (1)/…</code> with the contents intact.</p>
+<p>Within one batch:</p>
+<ul>
+<li>all paths sharing a top-level FOLDER segment share its resolution
+(one dropped folder = one rename), and</li>
+<li>top-level FILES resolve individually in order, each claiming its
+resolved name, so two same-named files in one batch get successive
+counters.</li>
+</ul>
+<p>Only the destination’s DIRECT children can be checked — that is all
+the drop target (one <code>listAll</code> level) knows. Deeper paths follow GCS
+overwrite semantics, which the folder-level rename already shields
+in practice (a colliding folder is renamed wholesale).</p>
+<p>Returns resolved paths in input order.</p>
+<h4 id="parameters-14">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>relativePaths</code></td><td align="left">readonly <code>string</code>[]</td></tr><tr><td align="left"><code>taken</code></td><td align="left"><code>ReadonlySet</code>&#x3C;<code>string</code>></td></tr></tbody></table></div>
+<h4 id="returns-14">Returns</h4>
+<p><code>string</code>[]</p>
+<hr>
+<p><a id="resolvecollision"></a></p>
+<h3 id="resolvecollision">resolveCollision()</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"> resolveCollision</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">name</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">taken</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">ReadonlySet</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>Resolve one name against a set of taken sibling names. Returns the
+name unchanged when free; otherwise the first <code> (n)</code> candidate that
+is free, per the module rule above.</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>name</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>taken</code></td><td align="left"><code>ReadonlySet</code>&#x3C;<code>string</code>></td></tr></tbody></table></div>
+<h4 id="returns-15">Returns</h4>
+<p><code>string</code></p>
+<hr>
+<p><a id="selectstoragepreview"></a></p>
+<h3 id="selectstoragepreview">selectStoragePreview()</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"> selectStoragePreview</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">metadata</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">FullMetadata</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">consumerPreviews</span><span style="color:#ABB2BF">: </span><span style="color:#C678DD">readonly</span><span style="color:#E5C07B"> StoragePreview</span><span style="color:#ABB2BF">[]): </span><span style="color:#E5C07B">StoragePreview</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Pick the preview for <code>metadata</code>: consumer previews first (override
+channel), then the built-ins, first <code>match</code> wins. <code>undefined</code>
+means metadata-only.</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>metadata</code></td><td align="left"><code>FullMetadata</code></td></tr><tr><td align="left"><code>consumerPreviews</code></td><td align="left">readonly <a href="#storagepreview"><code>StoragePreview</code></a>[]</td></tr></tbody></table></div>
+<h4 id="returns-16">Returns</h4>
+<p><a href="#storagepreview"><code>StoragePreview</code></a></p>
+<hr>
+<p><a id="splitstoragename"></a></p>
+<h3 id="splitstoragename">splitStorageName()</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"> splitStorageName</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">name</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">  ext</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">  stem</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><code>name</code> split as the rule defines: <code>ext</code> includes the leading dot,
+or is <code>''</code> when the name has no extension (dotfiles, trailing dots,
+extensionless names).</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>name</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-17">Returns</h4>
+<pre class="astro-code one-dark-pro" style="background-color:#282c34;color:#abb2bf; overflow-x: auto;" tabindex="0" data-language="ts"><code><span class="line"><span style="color:#ABB2BF">{</span></span>
+<span class="line"><span style="color:#E06C75">  ext</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">  stem</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span>
+<span class="line"><span style="color:#ABB2BF">}</span></span></code></pre>
+<h5 id="ext">ext</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">ext</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<h5 id="stem">stem</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">stem</span><span style="color:#ABB2BF">: </span><span style="color:#E06C75">string</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<hr>
+<p><a id="storageapiprovider"></a></p>
+<h3 id="storageapiprovider">StorageApiProvider()</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"> StorageApiProvider</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">StorageApi</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">StorageApi</span><span style="color:#ABB2BF">>>;</span></span></code></pre>
+<p>Provide a Storage API bundle to the subtree (Studio’s worker client).</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>__namedParameters</code></td><td align="left">{ <code>children</code>: <code>ReactNode</code>; <code>value</code>: <a href="#storageapi"><code>StorageApi</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="#storageapi"><code>StorageApi</code></a></td></tr></tbody></table></div>
+<h4 id="returns-18">Returns</h4>
+<p><code>FunctionComponentElement</code>&#x3C;<code>ProviderProps</code>&#x3C;<a href="#storageapi"><code>StorageApi</code></a>>></p>
+<hr>
+<p><a id="uploaddropzone"></a></p>
+<h3 id="uploaddropzone">UploadDropzone()</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"> UploadDropzone</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">__namedParameters</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UploadDropzoneProps</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">Element</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless drop target for file + folder uploads. Slot-based: the
+children render the chrome; the component owns drag wiring and
+stamps <code>data-dragging</code> while a drag hovers (a counter tracks
+enter/leave pairs so crossing child elements doesn’t flicker).</p>
+<p>Ships no visual styling. Consumers style via:</p>
+<ul>
+<li><code>[data-pyric-ui="upload-dropzone"]</code> — the root</li>
+<li><code>…[data-dragging]</code> — a drag is hovering</li>
+<li><code>…[data-disabled]</code></li>
+<li><code>…[data-disabled-reason="…"]</code> — why (e.g. a denied write verdict)</li>
+</ul>
+<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>__namedParameters</code></td><td align="left"><a href="#uploaddropzoneprops"><code>UploadDropzoneProps</code></a></td></tr></tbody></table></div>
+<h4 id="returns-19">Returns</h4>
+<p><code>Element</code></p>
+<hr>
+<p><a id="usemetadataeditor"></a></p>
+<h3 id="usemetadataeditor">useMetadataEditor()</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"> useMetadataEditor</span><span style="color:#ABB2BF">(</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">,</span></span>
+<span class="line"><span style="color:#E06C75;font-style:italic">   options</span><span style="color:#C678DD">?</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">UseMetadataEditorOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseMetadataEditorResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Headless metadata editor — the <code>useDocumentEditor</code> reducer pattern
+over <code>updateMetadata</code>: a pure reducer owns the draft (contentType,
+cacheControl, customMetadata k/v rows with stable ids +
+empty/duplicate-key validation); the hook adds named dispatch
+helpers and the save half.</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>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usemetadataeditoroptions"><code>UseMetadataEditorOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-20">Returns</h4>
+<p><a href="#usemetadataeditorresult"><code>UseMetadataEditorResult</code></a></p>
+<hr>
+<p><a id="useobjectupload"></a></p>
+<h3 id="useobjectupload">useObjectUpload()</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"> useObjectUpload</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</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">UseObjectUploadOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseObjectUploadResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Multi-file upload over the package’s single Storage handle prop.
+Headless: returns task state; render it however you like (the
+<code>&#x3C;UploadDropzone></code> component is one producer of <code>upload()</code> calls).</p>
+<p>Optimistic-with-rollback: with the <code>list</code> seam wired, each upload’s
+row appears in <code>useStorageList</code> immediately and disappears again if
+the write fails (typed <code>StorageError</code> on <code>task.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>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#useobjectuploadoptions"><code>UseObjectUploadOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-21">Returns</h4>
+<p><a href="#useobjectuploadresult"><code>UseObjectUploadResult</code></a></p>
+<hr>
+<p><a id="usepathstate"></a></p>
+<h3 id="usepathstate">usePathState()</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"> usePathState</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">UsePathStateOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UsePathStateResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Path navigation state for the storage browser. Controlled when
+<code>path</code> is provided (the owner re-renders with the next value),
+uncontrolled otherwise — standard React value/defaultValue
+semantics. All emitted paths are normalized (<code>normalizeStoragePath</code>).</p>
+<h4 id="parameters-22">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usepathstateoptions"><code>UsePathStateOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-22">Returns</h4>
+<p><a href="#usepathstateresult"><code>UsePathStateResult</code></a></p>
+<hr>
+<p><a id="usestorageapi"></a></p>
+<h3 id="usestorageapi">useStorageApi()</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"> useStorageApi</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">StorageApi</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Read the active Storage API bundle (defaults to in-process <code>pyric/storage</code>).</p>
+<h4 id="returns-23">Returns</h4>
+<p><a href="#storageapi"><code>StorageApi</code></a></p>
+<hr>
+<p><a id="usestoragedelete"></a></p>
+<h3 id="usestoragedelete">useStorageDelete()</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"> useStorageDelete</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</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">UseStorageDeleteOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseStorageDeleteResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Drive bulk + recursive deletes from a React component — the
+storage counterpart of <code>useRecursiveDelete</code> (same progress /
+isRunning / error shape, same stale-run generation token), bulk
+because storage selections are flat multi-row affairs.</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>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usestoragedeleteoptions"><code>UseStorageDeleteOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-24">Returns</h4>
+<p><a href="#usestoragedeleteresult"><code>UseStorageDeleteResult</code></a></p>
+<hr>
+<p><a id="usestoragelist"></a></p>
+<h3 id="usestoragelist">useStorageList()</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"> useStorageList</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseStorageListResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>List the objects + synthetic folders directly under <code>path</code> :
+<code>listAll</code> over the package’s sandbox Storage handle. Read-via-get,
+not realtime: the list updates on <code>refresh</code>, path change, or the
+optimistic seam. Pass <code>''</code> (or the result of <code>usePathState</code>) for
+the bucket root.</p>
+<p><code>listAll</code> has no pagination; a very large prefix arrives as one flat
+result (virtualize the rendering, which <code>&#x3C;ObjectBrowser></code> does).</p>
+<h4 id="parameters-24">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-25">Returns</h4>
+<p><a href="#usestoragelistresult"><code>UseStorageListResult</code></a></p>
+<hr>
+<p><a id="usestorageobject"></a></p>
+<h3 id="usestorageobject">useStorageObject()</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"> useStorageObject</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</span><span style="color:#ABB2BF">, </span><span style="color:#E06C75;font-style:italic">path</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">string</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseStorageObjectResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>One object’s metadata + lazily-loaded bytes, the data source for
+<code>&#x3C;ObjectInspector></code>. Read-via-get like the rest of the storage
+half: updates on <code>refresh</code>, <code>path</code> change, or <code>loadBlob</code>.</p>
+<h4 id="parameters-25">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>path</code></td><td align="left"><code>string</code></td></tr></tbody></table></div>
+<h4 id="returns-26">Returns</h4>
+<p><a href="#usestorageobjectresult"><code>UseStorageObjectResult</code></a></p>
+<hr>
+<p><a id="usestoragerulesgate"></a></p>
+<h3 id="usestoragerulesgate">useStorageRulesGate()</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"> useStorageRulesGate</span><span style="color:#ABB2BF">(</span><span style="color:#E06C75;font-style:italic">storage</span><span style="color:#ABB2BF">: </span><span style="color:#E5C07B">any</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">UseStorageRulesGateOptions</span><span style="color:#ABB2BF">): </span><span style="color:#E5C07B">UseStorageRulesGateResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Pre-flight rules evaluation — the M7 differentiator. Evaluates the
+current identity against paths BEFORE the click, so components can
+annotate denied affordances (<code>data-pyric-denied</code>, disabled-with-
+reason) instead of letting the user discover a denial via a thrown
+<code>storage/unauthorized</code>.</p>
+<p>Rules discovery: a sandbox handle carries its deployed ruleset
+(<code>getStorageSandbox(ctx, { rules })</code> parses it into the handle’s
+<code>StorageService</code>) — the hook reads it through the handle’s target,
+so sandbox callers pass nothing. Identity likewise defaults to the
+handle’s <code>SandboxContext.auth</code>. An explicit <code>rules</code> or <code>identity</code>
+option overrides the handle when evaluating a what-if scenario.</p>
+<p>Evaluation contract (mirrors <code>pyric/storage</code>’s own enforcement):
+<code>resource</code> (the existing object) is bound as <code>null</code> — the gate
+pre-evaluates without fetching per-path metadata, matching how the
+sandbox enforces <code>listAll</code>. Rules conditioned on existing-object
+state (<code>resource.*</code>) evaluate as if the object doesn’t exist; the
+common identity/path/payload-shaped rules evaluate exactly.</p>
+<h4 id="parameters-26">Parameters</h4>
+<div class="table-scroll">
+<table><thead><tr><th align="left">Parameter</th><th align="left">Type</th></tr></thead><tbody><tr><td align="left"><code>storage</code></td><td align="left"><code>any</code></td></tr><tr><td align="left"><code>options?</code></td><td align="left"><a href="#usestoragerulesgateoptions"><code>UseStorageRulesGateOptions</code></a></td></tr></tbody></table></div>
+<h4 id="returns-27">Returns</h4>
+<p><a href="#usestoragerulesgateresult"><code>UseStorageRulesGateResult</code></a></p>
+<hr>
+<p><a id="usestorageselection"></a></p>
+<h3 id="usestorageselection">useStorageSelection()</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"> useStorageSelection</span><span style="color:#ABB2BF">(): </span><span style="color:#E5C07B">UseStorageSelectionResult</span><span style="color:#ABB2BF">;</span></span></code></pre>
+<p>Multi-select state over storage rows, keyed by <code>fullPath</code>.
+Deliberately dumb: it doesn’t watch the list, so clear it on path
+change (or after a bulk op via the delete hook’s outcome) — the
+consumer owns that policy.</p>
+<h4 id="returns-28">Returns</h4>
+<p><a href="#usestorageselectionresult"><code>UseStorageSelectionResult</code></a></p>  </article> </main> <aside class="doc-toc api-symbols" aria-label="API symbols"> <h2 class="doc-toc-heading">Symbols</h2> <input class="api-symbol-filter" type="search" placeholder="Filter symbols" aria-label="Filter API symbols" data-api-symbol-filter> <div class="api-symbol-groups" data-api-symbol-groups> <section class="api-symbol-group" data-api-symbol-group> <a class="api-symbol-kind" href="#interfaces"> Interfaces </a> <ul> <li data-api-symbol="custommetadataentry"> <a href="#custommetadataentry">CustomMetadataEntry</a> </li><li data-api-symbol="deleteselectionwithconfirmprops"> <a href="#deleteselectionwithconfirmprops">DeleteSelectionWithConfirmProps</a> </li><li data-api-symbol="droppedfile"> <a href="#droppedfile">DroppedFile</a> </li><li data-api-symbol="metadataeditorstate"> <a href="#metadataeditorstate">MetadataEditorState</a> </li><li data-api-symbol="objectbrowserprops"> <a href="#objectbrowserprops">ObjectBrowserProps</a> </li><li data-api-symbol="objectinspectorprops"> <a href="#objectinspectorprops">ObjectInspectorProps</a> </li><li data-api-symbol="pathbreadcrumbprops"> <a href="#pathbreadcrumbprops">PathBreadcrumbProps</a> </li><li data-api-symbol="storagedeletefailure"> <a href="#storagedeletefailure">StorageDeleteFailure</a> </li><li data-api-symbol="storagedeleteoutcome"> <a href="#storagedeleteoutcome">StorageDeleteOutcome</a> </li><li data-api-symbol="storagedeleteprogress"> <a href="#storagedeleteprogress">StorageDeleteProgress</a> </li><li data-api-symbol="storagegateverdict"> <a href="#storagegateverdict">StorageGateVerdict</a> </li><li data-api-symbol="storagelistentry"> <a href="#storagelistentry">StorageListEntry</a> </li><li data-api-symbol="storagepreview"> <a href="#storagepreview">StoragePreview</a> </li><li data-api-symbol="storagepreviewcontext"> <a href="#storagepreviewcontext">StoragePreviewContext</a> </li><li data-api-symbol="storagerecursivedeleteimpl"> <a href="#storagerecursivedeleteimpl">StorageRecursiveDeleteImpl</a> </li><li data-api-symbol="storageselectionentry"> <a href="#storageselectionentry">StorageSelectionEntry</a> </li><li data-api-symbol="uploaddropzoneprops"> <a href="#uploaddropzoneprops">UploadDropzoneProps</a> </li><li data-api-symbol="uploadentry"> <a href="#uploadentry">UploadEntry</a> </li><li data-api-symbol="uploadtask"> <a href="#uploadtask">UploadTask</a> </li><li data-api-symbol="usemetadataeditoroptions"> <a href="#usemetadataeditoroptions">UseMetadataEditorOptions</a> </li><li data-api-symbol="usemetadataeditorresult"> <a href="#usemetadataeditorresult">UseMetadataEditorResult</a> </li><li data-api-symbol="useobjectuploadoptions"> <a href="#useobjectuploadoptions">UseObjectUploadOptions</a> </li><li data-api-symbol="useobjectuploadresult"> <a href="#useobjectuploadresult">UseObjectUploadResult</a> </li><li data-api-symbol="usepathstateoptions"> <a href="#usepathstateoptions">UsePathStateOptions</a> </li><li data-api-symbol="usepathstateresult"> <a href="#usepathstateresult">UsePathStateResult</a> </li><li data-api-symbol="usestoragedeleteoptions"> <a href="#usestoragedeleteoptions">UseStorageDeleteOptions</a> </li><li data-api-symbol="usestoragedeleteresult"> <a href="#usestoragedeleteresult">UseStorageDeleteResult</a> </li><li data-api-symbol="usestoragelistresult"> <a href="#usestoragelistresult">UseStorageListResult</a> </li><li data-api-symbol="usestorageobjectresult"> <a href="#usestorageobjectresult">UseStorageObjectResult</a> </li><li data-api-symbol="usestoragerulesgateoptions"> <a href="#usestoragerulesgateoptions">UseStorageRulesGateOptions</a> </li><li data-api-symbol="usestoragerulesgateresult"> <a href="#usestoragerulesgateresult">UseStorageRulesGateResult</a> </li><li data-api-symbol="usestorageselectionresult"> <a href="#usestorageselectionresult">UseStorageSelectionResult</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="metadataeditoraction"> <a href="#metadataeditoraction">MetadataEditorAction</a> </li><li data-api-symbol="pendingprefixaction"> <a href="#pendingprefixaction">PendingPrefixAction</a> </li><li data-api-symbol="pendingprefixstate"> <a href="#pendingprefixstate">PendingPrefixState</a> </li><li data-api-symbol="storageapi"> <a href="#storageapi">StorageApi</a> </li><li data-api-symbol="storageliststatus"> <a href="#storageliststatus">StorageListStatus</a> </li><li data-api-symbol="storageobjectstatus"> <a href="#storageobjectstatus">StorageObjectStatus</a> </li><li data-api-symbol="storagerulesgatestatus"> <a href="#storagerulesgatestatus">StorageRulesGateStatus</a> </li><li data-api-symbol="storagerulessource"> <a href="#storagerulessource">StorageRulesSource</a> </li><li data-api-symbol="uploadinput"> <a href="#uploadinput">UploadInput</a> </li><li data-api-symbol="uploadtaskstatus"> <a href="#uploadtaskstatus">UploadTaskStatus</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="defaultstoragepreviews"> <a href="#defaultstoragepreviews">defaultStoragePreviews</a> </li><li data-api-symbol="imagepreview"> <a href="#imagepreview">imagePreview</a> </li><li data-api-symbol="initialpendingprefixes"> <a href="#initialpendingprefixes">initialPendingPrefixes</a> </li><li data-api-symbol="text_preview_max_bytes"> <a href="#text_preview_max_bytes">TEXT_PREVIEW_MAX_BYTES</a> </li><li data-api-symbol="textpreview"> <a href="#textpreview">textPreview</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="createlistalldeleteimpl()"> <a href="#createlistalldeleteimpl">createListAllDeleteImpl()</a> </li><li data-api-symbol="deleteselectionwithconfirm()"> <a href="#deleteselectionwithconfirm">DeleteSelectionWithConfirm()</a> </li><li data-api-symbol="expandpathchain()"> <a href="#expandpathchain">expandPathChain()</a> </li><li data-api-symbol="folderinputerror()"> <a href="#folderinputerror">folderInputError()</a> </li><li data-api-symbol="initmetadataeditorstate()"> <a href="#initmetadataeditorstate">initMetadataEditorState()</a> </li><li data-api-symbol="ispendingprefix()"> <a href="#ispendingprefix">isPendingPrefix()</a> </li><li data-api-symbol="metadataeditorreducer()"> <a href="#metadataeditorreducer">metadataEditorReducer()</a> </li><li data-api-symbol="normalizestoragepath()"> <a href="#normalizestoragepath">normalizeStoragePath()</a> </li><li data-api-symbol="objectbrowser()"> <a href="#objectbrowser">ObjectBrowser()</a> </li><li data-api-symbol="objectinspector()"> <a href="#objectinspector">ObjectInspector()</a> </li><li data-api-symbol="parsecopycounter()"> <a href="#parsecopycounter">parseCopyCounter()</a> </li><li data-api-symbol="pathbreadcrumb()"> <a href="#pathbreadcrumb">PathBreadcrumb()</a> </li><li data-api-symbol="pendingchildfolders()"> <a href="#pendingchildfolders">pendingChildFolders()</a> </li><li data-api-symbol="pendingprefixreducer()"> <a href="#pendingprefixreducer">pendingPrefixReducer()</a> </li><li data-api-symbol="planbatchnames()"> <a href="#planbatchnames">planBatchNames()</a> </li><li data-api-symbol="resolvecollision()"> <a href="#resolvecollision">resolveCollision()</a> </li><li data-api-symbol="selectstoragepreview()"> <a href="#selectstoragepreview">selectStoragePreview()</a> </li><li data-api-symbol="splitstoragename()"> <a href="#splitstoragename">splitStorageName()</a> </li><li data-api-symbol="storageapiprovider()"> <a href="#storageapiprovider">StorageApiProvider()</a> </li><li data-api-symbol="uploaddropzone()"> <a href="#uploaddropzone">UploadDropzone()</a> </li><li data-api-symbol="usemetadataeditor()"> <a href="#usemetadataeditor">useMetadataEditor()</a> </li><li data-api-symbol="useobjectupload()"> <a href="#useobjectupload">useObjectUpload()</a> </li><li data-api-symbol="usepathstate()"> <a href="#usepathstate">usePathState()</a> </li><li data-api-symbol="usestorageapi()"> <a href="#usestorageapi">useStorageApi()</a> </li><li data-api-symbol="usestoragedelete()"> <a href="#usestoragedelete">useStorageDelete()</a> </li><li data-api-symbol="usestoragelist()"> <a href="#usestoragelist">useStorageList()</a> </li><li data-api-symbol="usestorageobject()"> <a href="#usestorageobject">useStorageObject()</a> </li><li data-api-symbol="usestoragerulesgate()"> <a href="#usestoragerulesgate">useStorageRulesGate()</a> </li><li data-api-symbol="usestorageselection()"> <a href="#usestorageselection">useStorageSelection()</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>