@pyric/ui 0.1.0-alpha.7

package/dist/storage/components/ObjectInspector.d.ts

@@ -0,0 +1,43 @@
+import { type ReactNode } from 'react';
+import type { FirebaseStorage, FullMetadata } from 'pyric/storage';
+import { type StoragePreview } from '../previews.js';
+export interface ObjectInspectorProps {
+    /** The package's single Storage handle prop (sandbox or prod). */
+    storage: FirebaseStorage | null | undefined;
+    /** Object path to inspect. `null` renders the idle shell — keep
+     *  the inspector mounted and swap paths as the user selects rows. */
+    path: string | null;
+    /** Consumer previews, tried BEFORE the built-ins (first match
+     *  wins) — the extension channel of the preview registry. */
+    previews?: StoragePreview[];
+    /** Metadata-section slot. Default renders the standard field list.
+     *  The header, preview, and state wiring stay with the component. */
+    renderMetadata?: (metadata: FullMetadata) => ReactNode;
+    /** Extra content below the preview (metadata editor, delete
+     *  button, …). */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * Headless inspector for one storage object: metadata + a
+ * content-type-driven preview. Previews come from the registry
+ * (`image/*` and `text/* + application/json` built in; extend via
+ * `previews`). Blob bytes load lazily and ONLY when the matched
+ * preview asks (`needsBlob`) and the object is within the preview's
+ * `maxBytes` cap; the blob URL is revoked on unmount/path change
+ * (see `useStorageObject`).
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="object-inspector"]` — root (stamps `data-size`)
+ * - `…[data-pyric-idle]` / `[data-pyric-loading]` / `[data-pyric-error]`
+ * - `[data-pyric-object-name]` / `[data-pyric-object-metadata]`
+ * - `[data-pyric-metadata-field="<field>"]` — each metadata row
+ * - `[data-pyric-object-preview]` — the preview container, stamping
+ *   `data-pyric-preview="<id>"` for the matched registry entry
+ * - `…[data-pyric-preview-loading]` — blob in flight
+ * - `…[data-pyric-preview-error]` — blob load failed
+ * - `…[data-pyric-preview-too-large]` — over the preview's cap
+ * - `…[data-pyric-preview-none]` — no registry match (metadata-only)
+ */
+export declare function ObjectInspector({ storage, path, previews, renderMetadata, children, className, }: ObjectInspectorProps): import("react").JSX.Element;
+//# sourceMappingURL=ObjectInspector.d.ts.map

package/dist/storage/components/ObjectInspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectInspector.d.ts","sourceRoot":"","sources":["../../../src/storage/components/ObjectInspector.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C;yEACqE;IACrE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;iEAC6D;IAC7D,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B;yEACqE;IACrE,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS,CAAC;IACvD;sBACkB;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,SAAS,GACV,EAAE,oBAAoB,+BAgFtB"}

package/dist/storage/components/ObjectInspector.js

@@ -0,0 +1,92 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { useContainerSize } from '../../primitives/hooks/useContainerSize.js';
+import { useStorageObject } from '../hooks/useStorageObject.js';
+import { selectStoragePreview } from '../previews.js';
+const METADATA_FIELDS = [
+    { key: 'fullPath', label: 'Path', value: (md) => md.fullPath },
+    { key: 'size', label: 'Size', value: (md) => `${md.size}` },
+    { key: 'contentType', label: 'Content type', value: (md) => md.contentType },
+    { key: 'cacheControl', label: 'Cache control', value: (md) => md.cacheControl },
+    { key: 'timeCreated', label: 'Created', value: (md) => md.timeCreated },
+    { key: 'updated', label: 'Updated', value: (md) => md.updated },
+];
+function DefaultMetadata({ metadata }) {
+    return (_jsxs("dl", { "data-pyric-object-metadata": true, children: [METADATA_FIELDS.map(({ key, label, value }) => {
+                const v = value(metadata);
+                if (v === undefined)
+                    return null;
+                return (_jsxs("div", { "data-pyric-metadata-field": key, children: [_jsx("dt", { children: label }), _jsx("dd", { children: v })] }, key));
+            }), Object.entries(metadata.customMetadata ?? {}).map(([k, v]) => (_jsxs("div", { "data-pyric-metadata-field": "customMetadata", "data-pyric-metadata-key": k, children: [_jsx("dt", { children: k }), _jsx("dd", { children: v })] }, `custom:${k}`)))] }));
+}
+/**
+ * Headless inspector for one storage object: metadata + a
+ * content-type-driven preview. Previews come from the registry
+ * (`image/*` and `text/* + application/json` built in; extend via
+ * `previews`). Blob bytes load lazily and ONLY when the matched
+ * preview asks (`needsBlob`) and the object is within the preview's
+ * `maxBytes` cap; the blob URL is revoked on unmount/path change
+ * (see `useStorageObject`).
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="object-inspector"]` — root (stamps `data-size`)
+ * - `…[data-pyric-idle]` / `[data-pyric-loading]` / `[data-pyric-error]`
+ * - `[data-pyric-object-name]` / `[data-pyric-object-metadata]`
+ * - `[data-pyric-metadata-field="<field>"]` — each metadata row
+ * - `[data-pyric-object-preview]` — the preview container, stamping
+ *   `data-pyric-preview="<id>"` for the matched registry entry
+ * - `…[data-pyric-preview-loading]` — blob in flight
+ * - `…[data-pyric-preview-error]` — blob load failed
+ * - `…[data-pyric-preview-too-large]` — over the preview's cap
+ * - `…[data-pyric-preview-none]` — no registry match (metadata-only)
+ */
+export function ObjectInspector({ storage, path, previews, renderMetadata, children, className, }) {
+    const { ref: rootRef, size } = useContainerSize();
+    const object = useStorageObject(storage, path);
+    const { metadata, blobStatus, loadBlob } = object;
+    const preview = metadata ? selectStoragePreview(metadata, previews) : undefined;
+    const tooLarge = preview?.maxBytes !== undefined &&
+        metadata !== undefined &&
+        metadata.size > preview.maxBytes;
+    const wantsBlob = preview?.needsBlob === true && !tooLarge;
+    // Auto-load the bytes when (and only when) the matched preview
+    // needs them. `blobStatus` resets to 'idle' on path change, which
+    // re-arms this effect for the next object.
+    useEffect(() => {
+        if (wantsBlob && blobStatus === 'idle')
+            loadBlob();
+    }, [wantsBlob, blobStatus, loadBlob]);
+    if (object.status === 'idle') {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-inspector", "data-pyric-idle": "" }));
+    }
+    if (object.status === 'loading') {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-inspector", "data-pyric-loading": "" }));
+    }
+    if (object.status === 'error' || metadata === undefined) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-inspector", "data-pyric-error": "", role: "alert", children: object.error?.message }));
+    }
+    let previewContent;
+    let previewState = {};
+    if (preview === undefined) {
+        previewState = { 'data-pyric-preview-none': '' };
+    }
+    else if (tooLarge) {
+        previewState = { 'data-pyric-preview-too-large': '' };
+    }
+    else if (wantsBlob && blobStatus === 'loading') {
+        previewState = { 'data-pyric-preview-loading': '' };
+    }
+    else if (wantsBlob && blobStatus === 'error') {
+        previewState = { 'data-pyric-preview-error': '' };
+        previewContent = object.blobError?.message;
+    }
+    else if (!wantsBlob || blobStatus === 'success') {
+        previewContent = preview.render({
+            metadata,
+            blob: object.blob,
+            blobUrl: object.blobUrl,
+        });
+    }
+    return (_jsxs("div", { ref: rootRef, className: className, "data-pyric-ui": "object-inspector", "data-size": size, children: [_jsx("div", { "data-pyric-object-name": true, children: metadata.name }), renderMetadata ? renderMetadata(metadata) : _jsx(DefaultMetadata, { metadata: metadata }), _jsx("div", { "data-pyric-object-preview": true, "data-pyric-preview": preview?.id, ...previewState, children: previewContent }), children] }));
+}
+//# sourceMappingURL=ObjectInspector.js.map

package/dist/storage/components/ObjectInspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectInspector.js","sourceRoot":"","sources":["../../../src/storage/components/ObjectInspector.tsx"],"names":[],"mappings":"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"}

package/dist/storage/components/PathBreadcrumb.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from 'react';
+export interface PathBreadcrumbProps {
+    /** Current path. `''` renders just the root crumb. */
+    path: string;
+    /** Fired with the absolute path of the clicked crumb (`''` for
+     *  root). Wire to `usePathState.setPath`. */
+    onNavigate?: (path: string) => void;
+    /** Label for the root crumb. Default `'/'` — pass the bucket name
+     *  for a `gs://bucket` feel. */
+    rootLabel?: ReactNode;
+    /** Rendered between crumbs. Default `'/'`. */
+    separator?: ReactNode;
+    className?: string;
+}
+/**
+ * Headless breadcrumb for storage paths. Every crumb (including the
+ * current one) is a real `<button>` — clicking the current crumb is
+ * a cheap "refresh this level" affordance for consumers that wire
+ * `onNavigate` to a path-keyed loader.
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="path-breadcrumb"]` — the `<nav>` root
+ * - `[data-pyric-breadcrumb-item]` — each `<li>`
+ * - `[data-pyric-breadcrumb-link]` — each crumb button
+ * - `[data-pyric-breadcrumb-link][data-pyric-current]` — the current level
+ * - `[data-pyric-breadcrumb-root]` — the root crumb's button
+ * - `[data-pyric-breadcrumb-separator]` — the separators
+ */
+export declare function PathBreadcrumb({ path, onNavigate, rootLabel, separator, className, }: PathBreadcrumbProps): import("react").JSX.Element;
+//# sourceMappingURL=PathBreadcrumb.d.ts.map

package/dist/storage/components/PathBreadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathBreadcrumb.d.ts","sourceRoot":"","sources":["../../../src/storage/components/PathBreadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb;iDAC6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;oCACgC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,UAAU,EACV,SAAe,EACf,SAAe,EACf,SAAS,GACV,EAAE,mBAAmB,+BA8CrB"}

package/dist/storage/components/PathBreadcrumb.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { normalizeStoragePath } from '../hooks/usePathState.js';
+/**
+ * Headless breadcrumb for storage paths. Every crumb (including the
+ * current one) is a real `<button>` — clicking the current crumb is
+ * a cheap "refresh this level" affordance for consumers that wire
+ * `onNavigate` to a path-keyed loader.
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="path-breadcrumb"]` — the `<nav>` root
+ * - `[data-pyric-breadcrumb-item]` — each `<li>`
+ * - `[data-pyric-breadcrumb-link]` — each crumb button
+ * - `[data-pyric-breadcrumb-link][data-pyric-current]` — the current level
+ * - `[data-pyric-breadcrumb-root]` — the root crumb's button
+ * - `[data-pyric-breadcrumb-separator]` — the separators
+ */
+export function PathBreadcrumb({ path, onNavigate, rootLabel = '/', separator = '/', className, }) {
+    const normalized = normalizeStoragePath(path);
+    const segments = normalized === '' ? [] : normalized.split('/');
+    return (_jsx("nav", { className: className, "data-pyric-ui": "path-breadcrumb", "aria-label": "Storage path", children: _jsxs("ol", { "data-pyric-breadcrumb-list": true, children: [_jsx("li", { "data-pyric-breadcrumb-item": true, children: _jsx("button", { type: "button", onClick: () => onNavigate?.(''), "data-pyric-breadcrumb-link": true, "data-pyric-breadcrumb-root": true, "data-pyric-current": segments.length === 0 ? '' : undefined, "aria-current": segments.length === 0 ? 'page' : undefined, children: rootLabel }) }), segments.map((segment, i) => {
+                    const isCurrent = i === segments.length - 1;
+                    const target = segments.slice(0, i + 1).join('/');
+                    return (_jsxs("li", { "data-pyric-breadcrumb-item": true, children: [_jsx("span", { "aria-hidden": true, "data-pyric-breadcrumb-separator": true, children: separator }), _jsx("button", { type: "button", onClick: () => onNavigate?.(target), "data-pyric-breadcrumb-link": true, "data-pyric-current": isCurrent ? '' : undefined, "aria-current": isCurrent ? 'page' : undefined, children: segment })] }, target));
+                })] }) }));
+}
+//# sourceMappingURL=PathBreadcrumb.js.map

package/dist/storage/components/PathBreadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathBreadcrumb.js","sourceRoot":"","sources":["../../../src/storage/components/PathBreadcrumb.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAgBhE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,IAAI,EACJ,UAAU,EACV,SAAS,GAAG,GAAG,EACf,SAAS,GAAG,GAAG,EACf,SAAS,GACW;IACpB,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhE,OAAO,CACL,cACE,SAAS,EAAE,SAAS,mBACN,iBAAiB,gBACpB,cAAc,YAEzB,6DACE,2DACE,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,gGAGX,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,kBAC5C,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAEvD,SAAS,GACH,GACN,EACJ,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;oBAC3B,MAAM,SAAS,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClD,OAAO,CACL,6DACE,uFACG,SAAS,GACL,EACP,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,4DAEf,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,kBAChC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,YAE3C,OAAO,GACD,KAZF,MAAM,CAaV,CACN,CAAC;gBACJ,CAAC,CAAC,IACC,GACD,CACP,CAAC;AACJ,CAAC"}

package/dist/storage/components/UploadDropzone.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from 'react';
+/** One dropped file, flattened from the drop's file/folder tree. */
+export interface DroppedFile {
+    file: File;
+    /**
+     * Path relative to the drop — `'a.txt'` for a plain file drop,
+     * `'photos/cat.png'` for a file inside a dropped folder. Feed
+     * straight into `useObjectUpload`:
+     * `upload(files.map((f) => ({ path: f.relativePath, data: f.file })))`.
+     */
+    relativePath: string;
+}
+export interface UploadDropzoneProps {
+    /**
+     * Fired once per drop with the flattened file list (folder drops
+     * are traversed recursively via `webkitGetAsEntry`; empty folders
+     * yield nothing — wire `useObjectUpload.createFolder` to your own
+     * "new folder" affordance instead). Not fired for empty drops.
+     */
+    onFiles: (files: DroppedFile[]) => void;
+    /** Slot — the dropzone chrome ("Drop files here…", a browse
+     *  `<input type="file">`, anything). The component owns only the
+     *  drag wiring + `data-*` states. */
+    children?: ReactNode;
+    /** Ignore drops + suppress the dragging state. */
+    disabled?: boolean;
+    /**
+     * Why the dropzone is disabled — stamped on
+     * `data-disabled-reason` (and only while `disabled`) so the
+     * chrome/styling can surface it. The canonical source is the rules
+     * gate: `disabled={!gate.verdictFor(path).upload}` +
+     * `disabledReason={gate.verdictFor(path).reasons.write.join('; ')}`.
+     */
+    disabledReason?: string;
+    className?: string;
+}
+/**
+ * Headless drop target for file + folder uploads. Slot-based: the
+ * children render the chrome; the component owns drag wiring and
+ * stamps `data-dragging` while a drag hovers (a counter tracks
+ * enter/leave pairs so crossing child elements doesn't flicker).
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="upload-dropzone"]` — the root
+ * - `…[data-dragging]` — a drag is hovering
+ * - `…[data-disabled]`
+ * - `…[data-disabled-reason="…"]` — why (e.g. a denied write verdict)
+ */
+export declare function UploadDropzone({ onFiles, children, disabled, disabledReason, className, }: UploadDropzoneProps): import("react").JSX.Element;
+//# sourceMappingURL=UploadDropzone.d.ts.map

package/dist/storage/components/UploadDropzone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadDropzone.d.ts","sourceRoot":"","sources":["../../../src/storage/components/UploadDropzone.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtF,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACxC;;yCAEqC;IACrC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACV,EAAE,mBAAmB,+BA8DrB"}

package/dist/storage/components/UploadDropzone.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useRef, useState } from 'react';
+/**
+ * Walk a `FileSystemEntry` tree depth-first, accumulating files with
+ * folder-relative paths. `readEntries` is batched per spec (Chrome
+ * caps a batch at 100) — loop until an empty batch.
+ */
+async function walkEntry(entry, prefix, out) {
+    const path = prefix === '' ? entry.name : `${prefix}/${entry.name}`;
+    if (entry.isFile) {
+        const file = await new Promise((resolve, reject) => entry.file(resolve, reject));
+        out.push({ file, relativePath: path });
+        return;
+    }
+    if (entry.isDirectory) {
+        const reader = entry.createReader();
+        for (;;) {
+            const batch = await new Promise((resolve, reject) => reader.readEntries(resolve, reject));
+            if (batch.length === 0)
+                break;
+            for (const child of batch) {
+                await walkEntry(child, path, out);
+            }
+        }
+    }
+}
+/**
+ * Flatten a drop's `DataTransfer` into files. Prefers the
+ * `webkitGetAsEntry` tree (the only channel that exposes folder
+ * structure); items without it fall back to `getAsFile`, and a
+ * `DataTransfer` with no usable `items` falls back to `files`.
+ */
+async function collectDroppedFiles(dt) {
+    const out = [];
+    const items = dt.items ? Array.from(dt.items) : [];
+    for (const item of items) {
+        if (item.kind !== 'file')
+            continue;
+        const getEntry = item.webkitGetAsEntry;
+        const entry = typeof getEntry === 'function' ? getEntry.call(item) : null;
+        if (entry) {
+            await walkEntry(entry, '', out);
+        }
+        else {
+            const file = item.getAsFile?.();
+            if (file)
+                out.push({ file, relativePath: file.name });
+        }
+    }
+    if (out.length === 0) {
+        for (const file of Array.from(dt.files ?? [])) {
+            out.push({ file, relativePath: file.name });
+        }
+    }
+    return out;
+}
+/**
+ * Headless drop target for file + folder uploads. Slot-based: the
+ * children render the chrome; the component owns drag wiring and
+ * stamps `data-dragging` while a drag hovers (a counter tracks
+ * enter/leave pairs so crossing child elements doesn't flicker).
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="upload-dropzone"]` — the root
+ * - `…[data-dragging]` — a drag is hovering
+ * - `…[data-disabled]`
+ * - `…[data-disabled-reason="…"]` — why (e.g. a denied write verdict)
+ */
+export function UploadDropzone({ onFiles, children, disabled, disabledReason, className, }) {
+    const [dragging, setDragging] = useState(false);
+    // dragenter/dragleave fire for every child crossing — count the
+    // pairs and only clear at depth 0.
+    const depthRef = useRef(0);
+    const handleDragEnter = useCallback((e) => {
+        e.preventDefault();
+        if (disabled)
+            return;
+        depthRef.current += 1;
+        setDragging(true);
+    }, [disabled]);
+    const handleDragOver = useCallback((e) => {
+        // Required — without preventDefault the browser refuses the drop.
+        e.preventDefault();
+    }, []);
+    const handleDragLeave = useCallback((e) => {
+        e.preventDefault();
+        if (disabled)
+            return;
+        depthRef.current = Math.max(0, depthRef.current - 1);
+        if (depthRef.current === 0)
+            setDragging(false);
+    }, [disabled]);
+    const handleDrop = useCallback((e) => {
+        e.preventDefault();
+        depthRef.current = 0;
+        setDragging(false);
+        if (disabled)
+            return;
+        const dt = e.dataTransfer;
+        if (!dt)
+            return;
+        void collectDroppedFiles(dt).then((files) => {
+            if (files.length > 0)
+                onFiles(files);
+        });
+    }, [disabled, onFiles]);
+    return (_jsx("div", { className: className, "data-pyric-ui": "upload-dropzone", "data-dragging": dragging ? '' : undefined, "data-disabled": disabled ? '' : undefined, "data-disabled-reason": disabled ? disabledReason : undefined, "aria-disabled": disabled || undefined, onDragEnter: handleDragEnter, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, children: children }));
+}
+//# sourceMappingURL=UploadDropzone.js.map

package/dist/storage/components/UploadDropzone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadDropzone.js","sourceRoot":"","sources":["../../../src/storage/components/UploadDropzone.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAkC,MAAM,OAAO,CAAC;AAuCtF;;;;GAIG;AACH,KAAK,UAAU,SAAS,CACtB,KAAsB,EACtB,MAAc,EACd,GAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACtD,KAA6B,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CACrD,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,MAAM,GAAI,KAAkC,CAAC,YAAY,EAAE,CAAC;QAClE,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACrE,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CACpC,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB,CAAC,EAAgB;IACjD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,QAAQ,GACZ,IACD,CAAC,gBAAgB,CAAC;QACnB,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAChC,IAAI,IAAI;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,GACW;IACpB,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,gEAAgE;IAChE,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAE3B,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,CAA4B,EAAE,EAAE;QAC/B,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;QACtB,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAA4B,EAAE,EAAE;QAClE,kEAAkE;QAClE,CAAC,CAAC,cAAc,EAAE,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,CAA4B,EAAE,EAAE;QAC/B,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC;YAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,CAA4B,EAAE,EAAE;QAC/B,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;QACrB,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,QAAQ;YAAE,OAAO;QACrB,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC;QAC1B,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,KAAK,mBAAmB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,QAAQ,EAAE,OAAO,CAAC,CACpB,CAAC;IAEF,OAAO,CACL,cACE,SAAS,EAAE,SAAS,mBACN,iBAAiB,mBAChB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,mBACzB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,0BAClB,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,mBAC5C,QAAQ,IAAI,SAAS,EACpC,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE,UAAU,YAEjB,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

package/dist/storage/folderPlaceholder.d.ts

@@ -0,0 +1,14 @@
+import { type FirebaseStorage, type StorageReference } from 'pyric/storage';
+/**
+ * Internal — build a reference to the trailing-slash folder
+ * placeholder (`<path>/`, the GCS create-folder convention).
+ *
+ * `StorageReference` is a documented structural value object (two
+ * refs with the same `(storage, fullPath)` are equal), so a plain
+ * object is a legal reference — the only way to express a `<path>/`
+ * name past `ref()`'s slash normalization. Sandbox targets accept
+ * it; prod targets throw (the `pyric/storage` follow-up routes prod
+ * through the REST `name=<path>/` channel — see the P2 step-00 doc).
+ */
+export declare function folderPlaceholderRef(storage: FirebaseStorage, folderPath: string): StorageReference;
+//# sourceMappingURL=folderPlaceholder.d.ts.map

package/dist/storage/folderPlaceholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderPlaceholder.d.ts","sourceRoot":"","sources":["../../src/storage/folderPlaceholder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,gBAAgB,CAalB"}

package/dist/storage/folderPlaceholder.js

@@ -0,0 +1,27 @@
+import { ref as refFn } from 'pyric/storage';
+/**
+ * Internal — build a reference to the trailing-slash folder
+ * placeholder (`<path>/`, the GCS create-folder convention).
+ *
+ * `StorageReference` is a documented structural value object (two
+ * refs with the same `(storage, fullPath)` are equal), so a plain
+ * object is a legal reference — the only way to express a `<path>/`
+ * name past `ref()`'s slash normalization. Sandbox targets accept
+ * it; prod targets throw (the `pyric/storage` follow-up routes prod
+ * through the REST `name=<path>/` channel — see the P2 step-00 doc).
+ */
+export function folderPlaceholderRef(storage, folderPath) {
+    const folder = refFn(storage, folderPath);
+    return {
+        storage,
+        bucket: folder.bucket,
+        fullPath: `${folder.fullPath}/`,
+        // GCS semantics: the segment after the final slash — empty for a
+        // placeholder.
+        name: '',
+        parent: folder,
+        root: folder.root,
+        toString: () => `${folder.toString()}/`,
+    };
+}
+//# sourceMappingURL=folderPlaceholder.js.map

package/dist/storage/folderPlaceholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderPlaceholder.js","sourceRoot":"","sources":["../../src/storage/folderPlaceholder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,KAAK,EAA+C,MAAM,eAAe,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwB,EACxB,UAAkB;IAElB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG;QAC/B,iEAAiE;QACjE,eAAe;QACf,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG;KACxC,CAAC;AACJ,CAAC"}

package/dist/storage/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { useStorageList, type StorageListStatus, type StorageListEntry, type UseStorageListResult, } from './useStorageList.js';
+export { usePathState, normalizeStoragePath, type UsePathStateOptions, type UsePathStateResult, } from './usePathState.js';
+export { useStorageObject, type StorageObjectStatus, type UseStorageObjectResult, } from './useStorageObject.js';
+export { useMetadataEditor, metadataEditorReducer, initMetadataEditorState, type CustomMetadataEntry, type MetadataEditorState, type MetadataEditorAction, type UseMetadataEditorOptions, type UseMetadataEditorResult, } from './useMetadataEditor.js';
+export { useStorageSelection, type StorageSelectionEntry, type UseStorageSelectionResult, } from './useStorageSelection.js';
+export { useStorageDelete, createListAllDeleteImpl, type StorageDeleteProgress, type StorageRecursiveDeleteImpl, type StorageDeleteFailure, type StorageDeleteOutcome, type UseStorageDeleteOptions, type UseStorageDeleteResult, } from './useStorageDelete.js';
+export { useStorageRulesGate, type StorageRulesGateStatus, type StorageRulesSource, type StorageGateVerdict, type UseStorageRulesGateOptions, type UseStorageRulesGateResult, } from './useStorageRulesGate.js';
+export { useObjectUpload, type UploadTask, type UploadTaskStatus, type UploadEntry, type UploadInput, type UseObjectUploadOptions, type UseObjectUploadResult, } from './useObjectUpload.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/storage/hooks/index.js

@@ -0,0 +1,9 @@
+export { useStorageList, } from './useStorageList.js';
+export { usePathState, normalizeStoragePath, } from './usePathState.js';
+export { useStorageObject, } from './useStorageObject.js';
+export { useMetadataEditor, metadataEditorReducer, initMetadataEditorState, } from './useMetadataEditor.js';
+export { useStorageSelection, } from './useStorageSelection.js';
+export { useStorageDelete, createListAllDeleteImpl, } from './useStorageDelete.js';
+export { useStorageRulesGate, } from './useStorageRulesGate.js';
+export { useObjectUpload, } from './useObjectUpload.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,GAMxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GAOxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,GAMpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,GAOhB,MAAM,sBAAsB,CAAC"}

package/dist/storage/hooks/useMetadataEditor.d.ts

@@ -0,0 +1,114 @@
+import { type FirebaseStorage, type FullMetadata, type SettableMetadata } from 'pyric/storage';
+/** One `customMetadata` row. `id` is a stable render key — keys are
+ *  user-editable, so they can't key the rows themselves. */
+export interface CustomMetadataEntry {
+    id: string;
+    key: string;
+    value: string;
+    /** Validation error (`'Key is required'` / `'Duplicate key'`). */
+    error?: string;
+}
+interface MetadataDraft {
+    contentType: string;
+    cacheControl: string;
+    custom: CustomMetadataEntry[];
+}
+export interface MetadataEditorState {
+    draft: MetadataDraft;
+    /** Snapshot for `isDirty` / `reset` — same reference-compare
+     *  semantics as the document editor's `tree !== initial`. */
+    initial: MetadataDraft;
+    errorCount: number;
+}
+export type MetadataEditorAction = {
+    type: 'setContentType';
+    value: string;
+} | {
+    type: 'setCacheControl';
+    value: string;
+} | {
+    type: 'setCustomKey';
+    id: string;
+    key: string;
+} | {
+    type: 'setCustomValue';
+    id: string;
+    value: string;
+} | {
+    type: 'addCustomEntry';
+    key?: string;
+    value?: string;
+} | {
+    type: 'removeCustomEntry';
+    id: string;
+} | {
+    type: 'reset';
+}
+/** Internal — a successful save makes the draft the new baseline. */
+ | {
+    type: 'commit';
+};
+/** Pure reducer — exported (with {@link initMetadataEditorState}) so
+ *  the edit state is testable without React, mirroring the document
+ *  editor's reducer/hook split. */
+export declare function metadataEditorReducer(state: MetadataEditorState, action: MetadataEditorAction): MetadataEditorState;
+/** Build the edit state from the metadata a `getMetadata` /
+ *  `useStorageObject` read returned. */
+export declare function initMetadataEditorState(initial: SettableMetadata | undefined): MetadataEditorState;
+export interface UseMetadataEditorOptions {
+    /** The metadata being edited — the same shape `useStorageObject`'s
+     *  `metadata` carries. Read once on mount (the editor is a
+     *  stateful workspace, like the document editor); `reset()` +
+     *  remount to re-initialize. */
+    initial?: SettableMetadata;
+}
+export interface UseMetadataEditorResult {
+    contentType: string;
+    cacheControl: string;
+    custom: CustomMetadataEntry[];
+    /** Convenience: `errorCount === 0`. */
+    isValid: boolean;
+    /** `true` once any modifying action fired since the last
+     *  `reset`/successful `save`. Reference-compare semantics — manual
+     *  re-entry of the original values does NOT clear it. */
+    isDirty: boolean;
+    errorCount: number;
+    /** Raw dispatch — prefer the named helpers. */
+    dispatch: (action: MetadataEditorAction) => void;
+    setContentType: (value: string) => void;
+    setCacheControl: (value: string) => void;
+    setCustomKey: (id: string, key: string) => void;
+    setCustomValue: (id: string, value: string) => void;
+    addCustomEntry: (key?: string, value?: string) => void;
+    removeCustomEntry: (id: string) => void;
+    /** Restore the initial values. Clears `isDirty`. */
+    reset: () => void;
+    /**
+     * Serialize the draft to an `updateMetadata` patch. Empty
+     * `contentType`/`cacheControl` become `undefined` — which LEAVES
+     * the previous value (the sandbox doesn't model null-clears; see
+     * `pyric/storage`'s `updateMetadata` doc). `customMetadata` is
+     * always included and replaces wholesale, so row removal works.
+     */
+    toPatch: () => SettableMetadata;
+    /**
+     * `updateMetadata(ref(storage, path), toPatch())`. Errors surface
+     * via `saveError` (typed `StorageError`), not throws — resolves
+     * `undefined` on failure or when the draft is invalid. On success
+     * the draft becomes the new baseline (`isDirty` clears) and the
+     * fresh `FullMetadata` is returned.
+     */
+    save: () => Promise<FullMetadata | undefined>;
+    isSaving: boolean;
+    saveError: Error | undefined;
+}
+/**
+ * Headless metadata editor — the `useDocumentEditor` reducer pattern
+ * over `updateMetadata`: 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.
+ */
+export declare function useMetadataEditor(storage: FirebaseStorage | null | undefined, path: string | null | undefined, options?: UseMetadataEditorOptions): UseMetadataEditorResult;
+export {};
+//# sourceMappingURL=useMetadataEditor.d.ts.map

package/dist/storage/hooks/useMetadataEditor.d.ts.map

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