@pyric/ui 0.1.0-alpha.10

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

@@ -0,0 +1,78 @@
+import type { ReactNode } from 'react';
+import type { StorageReference } from 'pyric/storage';
+import type { StorageListEntry, StorageListStatus } from '../hooks/useStorageList.js';
+import type { UseStorageRulesGateResult } from '../hooks/useStorageRulesGate.js';
+export interface ObjectBrowserProps {
+    /** The folders-first row model from `useStorageList`. */
+    entries: StorageListEntry[];
+    /** Drives the loading state (`'loading'` with no rows yet) and the
+     *  idle short-circuit. Default `'success'` for static usage. */
+    status?: StorageListStatus;
+    /** Renders a `role="alert"` container with the message. Pair with
+     *  the hook's typed `StorageError` for code-driven copy. */
+    error?: Error;
+    /** Folder row click — fired with the prefix's `fullPath`. Wire to
+     *  `usePathState.enter` (or `setPath`). */
+    onNavigate?: (path: string) => void;
+    /** Object row click — fired with the object's reference. */
+    onSelect?: (ref: StorageReference) => void;
+    /** Marks the matching object row `data-pyric-selected` +
+     *  `aria-selected`. */
+    selectedPath?: string;
+    /**
+     * Rules-aware affordances — pass `useStorageRulesGate(storage)`.
+     * Rows whose READ verdict denies are stamped `data-pyric-denied`
+     * (with the evaluator's reason trace on
+     * `data-pyric-denied-reason`). A denied folder row would throw
+     * `storage/unauthorized` on `listAll`; the stamp warns BEFORE the
+     * click. Rows stay clickable — the affordance is advisory and the
+     * sandbox enforcement layer remains authoritative.
+     */
+    gate?: Pick<UseStorageRulesGateResult, 'verdictFor'>;
+    /**
+     * Row-label slot. Default renders the entry name. The row button,
+     * its click wiring, and the `data-*` states stay with the
+     * component — the slot only owns the label content.
+     */
+    renderEntry?: (entry: StorageListEntry) => ReactNode;
+    /** Optional per-row action rendered as a sibling of the navigation/select
+     *  button. Use this for independent controls such as selection checkboxes. */
+    renderRowAction?: (entry: StorageListEntry) => ReactNode;
+    emptyState?: ReactNode;
+    className?: string;
+    /**
+     * Above this row count, the list switches to virtualization via
+     * `<VirtualList>` — `listAll` has no pagination, so a big prefix
+     * arrives as one flat result and virtualization is the only
+     * defense. Default 100 (same as `<DocumentList>`). `Infinity`
+     * disables.
+     */
+    virtualizeThreshold?: number;
+    /** Estimated row height when virtualizing. Default 36. */
+    rowHeight?: number | ((index: number) => number);
+    /** Scroll-container height when virtualized. Default `'60vh'`. */
+    virtualizedHeight?: number | string;
+}
+/**
+ * Headless storage browser shell — renders `useStorageList`'s merged
+ * folder/object rows. Folder rows navigate (`onNavigate` with the
+ * prefix path), object rows select (`onSelect` with the ref). Below
+ * `virtualizeThreshold` renders a plain `<ul>`; above it, composes
+ * the package's `<VirtualList>`.
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="object-browser"]` — the root (stamps `data-size`)
+ * - `…[data-pyric-loading]` / `[data-pyric-empty]` / `[data-pyric-error]`
+ * - `…[data-pyric-virtualized]` — virtualized mode
+ * - `[data-pyric-object-browser-items]` — the `<ul>` in plain mode
+ * - `[data-pyric-storage-entry]` — each row
+ * - `[data-pyric-storage-entry][data-pyric-entry-kind="folder"|"object"]`
+ * - `[data-pyric-storage-entry][data-pyric-entry-path="docs/a.txt"]`
+ * - `[data-pyric-storage-entry][data-pyric-denied]` — read-denied row
+ *   (rules gate; reason on `data-pyric-denied-reason`)
+ * - `[data-pyric-entry-select]` — the row button
+ * - `[data-pyric-entry-select][data-pyric-selected]` — the selected object
+ * - `[data-pyric-storage-action]` — optional sibling row action
+ */
+export declare function ObjectBrowser({ entries, status, error, onNavigate, onSelect, selectedPath, gate, renderEntry, renderRowAction, emptyState, className, virtualizeThreshold, rowHeight, virtualizedHeight, }: ObjectBrowserProps): import("react").JSX.Element;
+//# sourceMappingURL=ObjectBrowser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectBrowser.d.ts","sourceRoot":"","sources":["../../../src/storage/components/ObjectBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B;oEACgE;IAChE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;gEAC4D;IAC5D,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;+CAC2C;IAC3C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3C;2BACuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;IACrD;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,CAAC;IACrD;kFAC8E;IAC9E,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,CAAC;IACzD,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACjD,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,MAAkB,EAClB,KAAK,EACL,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,eAAe,EACf,UAAU,EACV,SAAS,EACT,mBAAyB,EACzB,SAAc,EACd,iBAA0B,GAC3B,EAAE,kBAAkB,+BAwHpB"}

package/dist/storage/components/ObjectBrowser.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { VirtualList } from '../../primitives/VirtualList.js';
+import { useContainerSize } from '../../primitives/hooks/useContainerSize.js';
+/**
+ * Headless storage browser shell — renders `useStorageList`'s merged
+ * folder/object rows. Folder rows navigate (`onNavigate` with the
+ * prefix path), object rows select (`onSelect` with the ref). Below
+ * `virtualizeThreshold` renders a plain `<ul>`; above it, composes
+ * the package's `<VirtualList>`.
+ *
+ * Ships no visual styling. Consumers style via:
+ * - `[data-pyric-ui="object-browser"]` — the root (stamps `data-size`)
+ * - `…[data-pyric-loading]` / `[data-pyric-empty]` / `[data-pyric-error]`
+ * - `…[data-pyric-virtualized]` — virtualized mode
+ * - `[data-pyric-object-browser-items]` — the `<ul>` in plain mode
+ * - `[data-pyric-storage-entry]` — each row
+ * - `[data-pyric-storage-entry][data-pyric-entry-kind="folder"|"object"]`
+ * - `[data-pyric-storage-entry][data-pyric-entry-path="docs/a.txt"]`
+ * - `[data-pyric-storage-entry][data-pyric-denied]` — read-denied row
+ *   (rules gate; reason on `data-pyric-denied-reason`)
+ * - `[data-pyric-entry-select]` — the row button
+ * - `[data-pyric-entry-select][data-pyric-selected]` — the selected object
+ * - `[data-pyric-storage-action]` — optional sibling row action
+ */
+export function ObjectBrowser({ entries, status = 'success', error, onNavigate, onSelect, selectedPath, gate, renderEntry, renderRowAction, emptyState, className, virtualizeThreshold = 100, rowHeight = 36, virtualizedHeight = '60vh', }) {
+    const { ref: rootRef, size } = useContainerSize();
+    if (error) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-browser", "data-pyric-error": "", role: "alert", children: error.message }));
+    }
+    if ((status === 'loading' || status === 'idle') && entries.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-browser", "data-pyric-loading": status === 'loading' ? '' : undefined, "data-pyric-idle": status === 'idle' ? '' : undefined }));
+    }
+    if (entries.length === 0) {
+        return (_jsx("div", { className: className, "data-pyric-ui": "object-browser", "data-pyric-empty": "", children: emptyState }));
+    }
+    // Pre-flight read verdict per row (advisory — see the `gate` prop).
+    const denialFor = (entry) => {
+        if (!gate)
+            return { denied: false };
+        const verdict = gate.verdictFor(entry.fullPath);
+        return verdict.read
+            ? { denied: false }
+            : { denied: true, reason: verdict.reasons.read.join('; ') };
+    };
+    const renderRow = (entry) => {
+        const selected = entry.kind === 'object' && entry.fullPath === selectedPath;
+        return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: () => entry.kind === 'folder'
+                        ? onNavigate?.(entry.fullPath)
+                        : onSelect?.(entry.ref), "data-pyric-entry-select": true, "data-pyric-selected": selected ? '' : undefined, "aria-selected": selected || undefined, children: renderEntry ? renderEntry(entry) : entry.name }), renderRowAction ? (_jsx("span", { "data-pyric-storage-action": true, children: renderRowAction(entry) })) : null] }));
+    };
+    const virtualized = entries.length > virtualizeThreshold;
+    return (_jsx("div", { ref: rootRef, className: className, "data-pyric-ui": "object-browser", "data-size": size, "data-pyric-virtualized": virtualized ? '' : undefined, children: virtualized ? (_jsx(VirtualList, { items: entries, estimateSize: rowHeight, height: virtualizedHeight, getItemKey: (entry) => `${entry.kind}:${entry.fullPath}`, renderItem: (entry) => {
+                const denial = denialFor(entry);
+                return (_jsx("div", { "data-pyric-storage-entry": true, "data-pyric-entry-kind": entry.kind, "data-pyric-entry-path": entry.fullPath, "data-pyric-denied": denial.denied ? '' : undefined, "data-pyric-denied-reason": denial.reason, children: renderRow(entry) }));
+            } })) : (_jsx("ul", { "data-pyric-object-browser-items": true, children: entries.map((entry) => {
+                const denial = denialFor(entry);
+                return (_jsx("li", { "data-pyric-storage-entry": true, "data-pyric-entry-kind": entry.kind, "data-pyric-entry-path": entry.fullPath, "data-pyric-denied": denial.denied ? '' : undefined, "data-pyric-denied-reason": denial.reason, children: renderRow(entry) }, `${entry.kind}:${entry.fullPath}`));
+            }) })) }));
+}
+//# sourceMappingURL=ObjectBrowser.js.map

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

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

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 sandbox Storage handle. */
+    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,4CAA4C;IAC5C,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,20 @@
+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. This helper is specific to
+ * the Pyric sandbox mirror.
+ */
+export declare function folderPlaceholderRef(storage: FirebaseStorage, folderPath: string): StorageReference;
+/** Preserve whichever backend identity a reference carries (in-process
+ *  storage handle or worker MessagePort) while targeting its trailing-slash
+ *  GCS folder placeholder. */
+export declare function asFolderPlaceholder<T extends {
+    fullPath: string;
+    name: string;
+}>(folder: T): T;
+//# 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;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,GACjB,gBAAgB,CAWlB;AAED;;8BAE8B;AAC9B,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC9E,MAAM,EAAE,CAAC,GACR,CAAC,CAMH"}

package/dist/storage/folderPlaceholder.js

@@ -0,0 +1,34 @@
+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. This helper is specific to
+ * the Pyric sandbox mirror.
+ */
+export function folderPlaceholderRef(storage, folderPath) {
+    const folder = refFn(storage, folderPath);
+    return {
+        storage,
+        bucket: folder.bucket,
+        fullPath: `${folder.fullPath}/`,
+        name: '',
+        parent: folder,
+        root: folder.root,
+        toString: () => `${folder.toString()}/`,
+    };
+}
+/** Preserve whichever backend identity a reference carries (in-process
+ *  storage handle or worker MessagePort) while targeting its trailing-slash
+ *  GCS folder placeholder. */
+export function asFolderPlaceholder(folder) {
+    return {
+        ...folder,
+        fullPath: `${folder.fullPath}/`,
+        name: '',
+    };
+}
+//# 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;;;;;;;;;GASG;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,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;AAED;;8BAE8B;AAC9B,MAAM,UAAU,mBAAmB,CACjC,MAAS;IAET,OAAO;QACL,GAAG,MAAM;QACT,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG;QAC/B,IAAI,EAAE,EAAE;KACT,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"}