@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/svelte/stores/storage-browse.svelte.d.ts

@@ -0,0 +1,70 @@
+import type { StorageRuntimeSource } from '../storage-runtime.ts';
+import { type PlatformStorageBrowseClient, type StorageBrowseConfig, type StorageDrive, type StorageEntry } from '../storage-browse-runtime.ts';
+export interface StorageBrowseStoreOptions {
+    /** Browse-capable adapter id (e.g. `'sharepoint'`). */
+    adapterId: string;
+    /** Optional adapter config forwarded to every browse call. */
+    config?: StorageBrowseConfig;
+    /** Injected client (tests / SSR-supplied); defaults to the platform client. */
+    client?: PlatformStorageBrowseClient;
+    /** Runtime source (a component's `getRuntimeSvelteContext()`); defaults to the init-time context. */
+    runtime?: StorageRuntimeSource;
+}
+/**
+ * Reactive store for browsing a `browse`-capable `storage/adapter` through the
+ * runtime-resolved platform client. Live read-through (not a synced collection):
+ * it reflects the external source, caching only the current view.
+ *
+ * `.svelte.ts` (uses `$state`) — import via `@vibesdotdev/storage/svelte/stores`
+ * or the component, never the package root (avoids the `$state` barrel trap).
+ */
+export declare class StorageBrowseStore {
+    private readonly adapterId;
+    private readonly config?;
+    private client?;
+    private readonly runtime;
+    drives: {
+        id: string;
+        name: string;
+        kind: string;
+    }[];
+    entries: {
+        id: string;
+        name: string;
+        path: string;
+        kind: "file" | "directory";
+        sizeBytes?: number | undefined;
+        modifiedAt?: string | undefined;
+        documentId?: string | undefined;
+        sourceRefreshUrl?: string | undefined;
+    }[];
+    currentDriveId: string | null;
+    currentPath: string;
+    drivesLoading: boolean;
+    entriesLoading: boolean;
+    error: Error | null;
+    /** False once a browse call fails with a "not connected / no credential" error. */
+    connected: boolean;
+    private loadRuntime;
+    constructor(options: StorageBrowseStoreOptions);
+    /** Path segments of the current location, for breadcrumb rendering. */
+    get breadcrumbs(): string[];
+    private resolve;
+    /** Record a failure as the store's typed error (its text never shown) and the connected flag. */
+    private capture;
+    /** Load the adapter's top-level drives (SharePoint sites, …). */
+    loadDrives(): Promise<StorageDrive[]>;
+    /** Select a drive and list its root. */
+    selectDrive(driveId: string): Promise<void>;
+    /** Navigate to a path within the current drive. */
+    navigate(path: string): Promise<void>;
+    /** Step into a directory entry (appends to the current path). */
+    openDirectory(entry: StorageEntry): Promise<void>;
+    /** Go up one path segment (no-op at the drive root). */
+    navigateUp(): Promise<void>;
+    private loadEntries;
+    /** Re-fetch the current view (drives if no drive selected, else entries). */
+    refresh(): Promise<void>;
+}
+export declare function createStorageBrowseStore(options: StorageBrowseStoreOptions): StorageBrowseStore;
+//# sourceMappingURL=storage-browse.svelte.d.ts.map

package/dist/svelte/stores/storage-browse.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-browse.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/stores/storage-browse.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAEN,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,8BAA8B,CAAC;AAItC,MAAM,WAAW,yBAAyB;IACzC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,qGAAqG;IACrG,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAsB;IAC9C,OAAO,CAAC,MAAM,CAAC,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,MAAM;;;;QAA8B;IACpC,OAAO;;;;;;;;;QAA8B;IACrC,cAAc,gBAA+B;IAC7C,WAAW,SAAc;IACzB,aAAa,UAAiB;IAC9B,cAAc,UAAiB;IAC/B,KAAK,eAA8B;IACnC,mFAAmF;IACnF,SAAS,UAAgB;IAEzB,OAAO,CAAC,WAAW;gBAUP,OAAO,EAAE,yBAAyB;IAO9C,uEAAuE;IACvE,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;YAEa,OAAO;IAKrB,iGAAiG;IACjG,OAAO,CAAC,OAAO;IASf,iEAAiE;IAC3D,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAc3C,wCAAwC;IAClC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,mDAAmD;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,iEAAiE;IAC3D,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,wDAAwD;IAClD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,WAAW;IAiBzB,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO9B;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAI/F"}

package/dist/svelte/stores/storage-browse.svelte.js

@@ -0,0 +1,133 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+import { resolvePlatformStorageBrowseClient } from "../storage-browse-runtime.js";
+import { settleStorage, storageSurfaceFailure } from "../../client/storage-failure.js";
+import { isStorageNotConnected } from "../storage-connection.js";
+/**
+ * Reactive store for browsing a `browse`-capable `storage/adapter` through the
+ * runtime-resolved platform client. Live read-through (not a synced collection):
+ * it reflects the external source, caching only the current view.
+ *
+ * `.svelte.ts` (uses `$state`) — import via `@vibesdotdev/storage/svelte/stores`
+ * or the component, never the package root (avoids the `$state` barrel trap).
+ */
+export class StorageBrowseStore {
+    adapterId;
+    config;
+    client;
+    runtime;
+    drives = $state([]);
+    entries = $state([]);
+    currentDriveId = $state(null);
+    currentPath = $state('');
+    drivesLoading = $state(false);
+    entriesLoading = $state(false);
+    error = $state(null);
+    /** False once a browse call fails with a "not connected / no credential" error. */
+    connected = $state(true);
+    loadRuntime() {
+        if (!this.runtime) {
+            throw new CapabilityError('No runtime source: pass `runtime` (getRuntimeSvelteContext()) or an explicit client.', 'INVALID_INPUT', {
+                reason: 'storage-browse-runtime-missing',
+                retryable: false
+            });
+        }
+        return this.runtime.load();
+    }
+    constructor(options) {
+        this.adapterId = options.adapterId;
+        this.config = options.config;
+        this.client = options.client;
+        this.runtime = options.runtime;
+    }
+    /** Path segments of the current location, for breadcrumb rendering. */
+    get breadcrumbs() {
+        return this.currentPath ? this.currentPath.split('/').filter(Boolean) : [];
+    }
+    async resolve() {
+        if (this.client)
+            return this.client;
+        return resolvePlatformStorageBrowseClient(await this.loadRuntime());
+    }
+    /** Record a failure as the store's typed error (its text never shown) and the connected flag. */
+    capture(cause) {
+        const failure = storageSurfaceFailure(cause);
+        if (isStorageNotConnected(failure)) {
+            this.connected = false;
+        }
+        this.error = failure;
+        return failure;
+    }
+    /** Load the adapter's top-level drives (SharePoint sites, …). */
+    async loadDrives() {
+        this.drivesLoading = true;
+        this.error = null;
+        try {
+            const attempt = await settleStorage(async () => (await this.resolve()).listDrives(this.adapterId, this.config));
+            if (!attempt.ok)
+                throw this.capture(attempt.cause);
+            this.drives = attempt.value;
+            this.connected = true;
+            return this.drives;
+        }
+        finally {
+            this.drivesLoading = false;
+        }
+    }
+    /** Select a drive and list its root. */
+    async selectDrive(driveId) {
+        this.currentDriveId = driveId;
+        this.currentPath = '';
+        await this.loadEntries();
+    }
+    /** Navigate to a path within the current drive. */
+    async navigate(path) {
+        this.currentPath = path;
+        await this.loadEntries();
+    }
+    /** Step into a directory entry (appends to the current path). */
+    async openDirectory(entry) {
+        if (entry.kind !== 'directory')
+            return;
+        await this.navigate(entry.path);
+    }
+    /** Go up one path segment (no-op at the drive root). */
+    async navigateUp() {
+        if (!this.currentPath)
+            return;
+        const segments = this.currentPath.split('/').filter(Boolean);
+        segments.pop();
+        await this.navigate(segments.join('/'));
+    }
+    async loadEntries() {
+        if (!this.currentDriveId)
+            return;
+        this.entriesLoading = true;
+        this.error = null;
+        const driveId = this.currentDriveId;
+        try {
+            const attempt = await settleStorage(async () => (await this.resolve()).listEntries(this.adapterId, driveId, this.currentPath, this.config));
+            if (!attempt.ok)
+                throw this.capture(attempt.cause);
+            this.entries = attempt.value;
+            this.connected = true;
+        }
+        finally {
+            this.entriesLoading = false;
+        }
+    }
+    /** Re-fetch the current view (drives if no drive selected, else entries). */
+    async refresh() {
+        if (this.currentDriveId) {
+            await this.loadEntries();
+        }
+        else {
+            await this.loadDrives();
+        }
+    }
+}
+export function createStorageBrowseStore(options) {
+    // Call during component init (or pass `runtime`): the context is read once, here.
+    const runtime = options.runtime ?? (options.client ? undefined : getRuntimeSvelteContext());
+    return new StorageBrowseStore({ ...options, runtime });
+}

package/dist/svelte/stores/storage-providers.svelte.d.ts

@@ -0,0 +1,32 @@
+import type { CreateStorageProviderInput } from '@vibesdotdev/storage/schemas/storage-provider';
+import { type PlatformStorageClient, type StorageRuntimeSource, type StorageProviderOption } from '../storage-runtime.ts';
+export interface StorageProvidersStoreOptions {
+    client?: PlatformStorageClient;
+    /** Runtime source (a component's `getRuntimeSvelteContext()`); defaults to the init-time context. */
+    runtime?: StorageRuntimeSource;
+    initialProviders?: StorageProviderOption[];
+}
+export declare class StorageProvidersStore {
+    private client?;
+    private readonly runtime;
+    providers: {
+        id: string;
+        name: string;
+        type: string;
+        isActive: boolean;
+        isDefault: boolean;
+    }[];
+    loaded: boolean;
+    loading: boolean;
+    error: Error | null;
+    private loadRuntime;
+    constructor(options?: StorageProvidersStoreOptions);
+    private resolve;
+    get defaultProvider(): StorageProviderOption | undefined;
+    load(): Promise<StorageProviderOption[]>;
+    refresh(): Promise<void>;
+    create(input: CreateStorageProviderInput): Promise<StorageProviderOption>;
+    remove(providerId: string): Promise<void>;
+}
+export declare function createStorageProvidersStore(options?: StorageProvidersStoreOptions): StorageProvidersStore;
+//# sourceMappingURL=storage-providers.svelte.d.ts.map

package/dist/svelte/stores/storage-providers.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-providers.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/stores/storage-providers.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAIhG,OAAO,EAGN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,4BAA4B;IAC5C,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,qGAAqG;IACrG,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAC3C;AAED,qBAAa,qBAAqB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,SAAS;;;;;;QAAuC;IAChD,MAAM,UAAiB;IACvB,OAAO,UAAiB;IACxB,KAAK,eAA8B;IAEnC,OAAO,CAAC,WAAW;gBAUP,OAAO,GAAE,4BAAiC;YASxC,OAAO;IAIrB,IAAI,eAAe,IAAI,qBAAqB,GAAG,SAAS,CAEvD;IAEK,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAmBxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOzE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/C;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,GAAE,4BAAiC,GACxC,qBAAqB,CAIvB"}

package/dist/svelte/stores/storage-providers.svelte.js

@@ -0,0 +1,73 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+import { settleStorage, storageSurfaceFailure } from "../../client/storage-failure.js";
+import { pickDefaultProvider, resolvePlatformStorageClient } from "../storage-runtime.js";
+export class StorageProvidersStore {
+    client;
+    runtime;
+    providers = $state([]);
+    loaded = $state(false);
+    loading = $state(false);
+    error = $state(null);
+    loadRuntime() {
+        if (!this.runtime) {
+            throw new CapabilityError('No runtime source: pass `runtime` (getRuntimeSvelteContext()) or an explicit client.', 'INVALID_INPUT', {
+                reason: 'storage-providers-runtime-missing',
+                retryable: false
+            });
+        }
+        return this.runtime.load();
+    }
+    constructor(options = {}) {
+        this.client = options.client;
+        this.runtime = options.runtime;
+        if (options.initialProviders && options.initialProviders.length > 0) {
+            this.providers = options.initialProviders;
+            this.loaded = true;
+        }
+    }
+    async resolve() {
+        return resolvePlatformStorageClient(await this.loadRuntime(), this.client);
+    }
+    get defaultProvider() {
+        return pickDefaultProvider(this.providers);
+    }
+    async load() {
+        this.loading = true;
+        this.error = null;
+        try {
+            const attempt = await settleStorage(async () => (await this.resolve()).listProviders());
+            if (!attempt.ok) {
+                // The store's error is the typed failure (code and reason); its text is never shown.
+                const failure = storageSurfaceFailure(attempt.cause);
+                this.error = failure;
+                throw failure;
+            }
+            this.providers = attempt.value;
+            this.loaded = true;
+            return this.providers;
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    async refresh() {
+        await this.load();
+    }
+    async create(input) {
+        const client = await this.resolve();
+        const created = await client.createProvider(input);
+        await this.refresh();
+        return created;
+    }
+    async remove(providerId) {
+        const client = await this.resolve();
+        await client.deleteProvider(providerId);
+        await this.refresh();
+    }
+}
+export function createStorageProvidersStore(options = {}) {
+    // Call during component init (or pass `runtime`): the context is read once, here.
+    const runtime = options.runtime ?? (options.client ? undefined : getRuntimeSvelteContext());
+    return new StorageProvidersStore({ ...options, runtime });
+}

package/dist/svelte/stores/storage-refs.svelte.d.ts

@@ -0,0 +1,57 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { type RefsBackend, type StorageRef, type StorageRefKind, type StorageRefList } from '../storage-refs-runtime.ts';
+/**
+ * Where the store reads and writes: an injected backend (tests), or the
+ * StorageManifest backend of the runtime the caller holds.
+ */
+export type StorageRefsStoreOptions = {
+    backend: RefsBackend;
+} | {
+    runtime: VibesRuntime;
+};
+/**
+ * Reactive store over offline-first owned storage references (pins/recents/links).
+ * Reads/writes through a {@link RefsBackend} — the default is StorageManifest-backed
+ * (local-first `storage.idb`, synced via `storage.cloud-api`). `.svelte.ts`
+ * (uses `$state`) — import via `@vibesdotdev/storage/svelte/stores`, not the root.
+ */
+export declare class StorageRefsStore {
+    private readonly backend;
+    refs: {
+        id: string;
+        adapterId: string;
+        driveId: string;
+        path: string;
+        kind: "link" | "pin" | "recent";
+        createdAt: number;
+        label?: string | undefined;
+        refId?: string | undefined;
+    }[];
+    loaded: boolean;
+    loading: boolean;
+    saving: boolean;
+    error: Error | null;
+    constructor(options: StorageRefsStoreOptions);
+    /** Refs of a given kind (e.g. only pins). */
+    byKind(kind: StorageRefKind): StorageRefList;
+    /** Whether a (adapter, drive, path) reference of `kind` exists. */
+    has(adapterId: string, driveId: string, path: string, kind?: StorageRefKind): boolean;
+    /** Record a failure as the store's typed error (code and reason; its text is never shown). */
+    private capture;
+    load(): Promise<StorageRefList>;
+    private persist;
+    /** Add (or upsert by id) a reference. Returns the stored ref. */
+    add(input: {
+        adapterId: string;
+        driveId: string;
+        path: string;
+        kind: StorageRefKind;
+        label?: string;
+        refId?: string;
+        createdAt?: number;
+    }): Promise<StorageRef>;
+    /** Remove a reference by (adapter, drive, path). Returns whether it existed. */
+    remove(adapterId: string, driveId: string, path: string): Promise<boolean>;
+}
+export declare function createStorageRefsStore(options: StorageRefsStoreOptions): StorageRefsStore;
+//# sourceMappingURL=storage-refs.svelte.d.ts.map

package/dist/svelte/stores/storage-refs.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-refs.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/stores/storage-refs.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,EAGN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3F;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,IAAI;;;;;;;;;QAA8B;IAClC,MAAM,UAAiB;IACvB,OAAO,UAAiB;IACxB,MAAM,UAAiB;IACvB,KAAK,eAA8B;gBAEvB,OAAO,EAAE,uBAAuB;IAI5C,6CAA6C;IAC7C,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc;IAI5C,mEAAmE;IACnE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO;IAKrF,8FAA8F;IAC9F,OAAO,CAAC,OAAO;IAMT,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;YAcvB,OAAO;IAYrB,iEAAiE;IAC3D,GAAG,CAAC,KAAK,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,cAAc,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBvB,gFAAgF;IAC1E,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAMhF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAEzF"}

package/dist/svelte/stores/storage-refs.svelte.js

@@ -0,0 +1,90 @@
+import { settleStorage, storageSurfaceFailure } from "../../client/storage-failure.js";
+import { createManifestRefsBackend, storageRefId } from "../storage-refs-runtime.js";
+/**
+ * Reactive store over offline-first owned storage references (pins/recents/links).
+ * Reads/writes through a {@link RefsBackend} — the default is StorageManifest-backed
+ * (local-first `storage.idb`, synced via `storage.cloud-api`). `.svelte.ts`
+ * (uses `$state`) — import via `@vibesdotdev/storage/svelte/stores`, not the root.
+ */
+export class StorageRefsStore {
+    backend;
+    refs = $state([]);
+    loaded = $state(false);
+    loading = $state(false);
+    saving = $state(false);
+    error = $state(null);
+    constructor(options) {
+        this.backend = 'backend' in options ? options.backend : createManifestRefsBackend(options.runtime);
+    }
+    /** Refs of a given kind (e.g. only pins). */
+    byKind(kind) {
+        return this.refs.filter((r) => r.kind === kind);
+    }
+    /** Whether a (adapter, drive, path) reference of `kind` exists. */
+    has(adapterId, driveId, path, kind) {
+        const id = storageRefId(adapterId, driveId, path);
+        return this.refs.some((r) => r.id === id && (kind ? r.kind === kind : true));
+    }
+    /** Record a failure as the store's typed error (code and reason; its text is never shown). */
+    capture(cause) {
+        const failure = storageSurfaceFailure(cause);
+        this.error = failure;
+        return failure;
+    }
+    async load() {
+        this.loading = true;
+        this.error = null;
+        try {
+            const attempt = await settleStorage(() => this.backend.load());
+            if (!attempt.ok)
+                throw this.capture(attempt.cause);
+            this.refs = attempt.value;
+            this.loaded = true;
+            return this.refs;
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    async persist(next) {
+        this.saving = true;
+        this.error = null;
+        try {
+            const attempt = await settleStorage(() => this.backend.save(next));
+            if (!attempt.ok)
+                throw this.capture(attempt.cause);
+            this.refs = next;
+        }
+        finally {
+            this.saving = false;
+        }
+    }
+    /** Add (or upsert by id) a reference. Returns the stored ref. */
+    async add(input) {
+        const id = storageRefId(input.adapterId, input.driveId, input.path);
+        const ref = {
+            id,
+            adapterId: input.adapterId,
+            driveId: input.driveId,
+            path: input.path,
+            kind: input.kind,
+            label: input.label,
+            refId: input.refId,
+            createdAt: input.createdAt ?? 0
+        };
+        const next = [...this.refs.filter((r) => r.id !== id), ref];
+        await this.persist(next);
+        return ref;
+    }
+    /** Remove a reference by (adapter, drive, path). Returns whether it existed. */
+    async remove(adapterId, driveId, path) {
+        const id = storageRefId(adapterId, driveId, path);
+        if (!this.refs.some((r) => r.id === id))
+            return false;
+        await this.persist(this.refs.filter((r) => r.id !== id));
+        return true;
+    }
+}
+export function createStorageRefsStore(options) {
+    return new StorageRefsStore(options);
+}

package/dist/svelte/styles.css

@@ -0,0 +1,14 @@
+/*
+ * Tailwind v4 source declaration for consumers — mirrors @vibesdotdev/kit's
+ * styles.css pattern. Apps that `@import '@vibesdotdev/storage/svelte/styles.css'`
+ * get this package's components scanned by their Tailwind build, so utility
+ * classes used ONLY inside these components are actually emitted in the app's
+ * CSS bundle. Without this, such a class (e.g. the explorer search box's
+ * `pr-6` / `sm:w-52`) is silently missing whenever no app-source file happens
+ * to use the same class — each app gets a different random subset.
+ *
+ * Paths resolve relative to this file: at runtime that's dist/styles.css, so
+ * "./" scans the compiled dist; under the `bun` export condition it's
+ * src/styles.css scanning src. Both contain the same class names.
+ */
+@source "./";

package/dist/svelte/test-assets.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Test-only ambient module declarations for the Svelte surface's browser
+ * tests. Vitest (Vite) resolves CSS side-effect imports at run time; plain
+ * `tsc -p tsconfig.json` — which typechecks every src file including tests —
+ * needs this wildcard. This file lives under `src/svelte`, so the production
+ * core build (`tsconfig.core.json`) never emits or publishes it.
+ */
+declare module '*.css';

package/dist/svelte/tool-widgets/StorageBrowseToolCard.svelte

@@ -0,0 +1,109 @@
+<script lang="ts">
+	/**
+	 * Designed widget for `storage.browse`. Always composes Kit `ToolCard` —
+	 * empty folders, drive lists, pending calls, and failures stay on this card.
+	 */
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { storageBrowseWidgetView } from '../../tools/widget-views.js';
+	import { fmtSize } from './format.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(storageBrowseWidgetView(tool.output, tool.input));
+	const mode = $derived(view.mode);
+	const path = $derived(view.path);
+	const providerId = $derived(view.providerId);
+	const driveId = $derived(view.driveId);
+	const drives = $derived(view.drives);
+	const entries = $derived(view.entries);
+	const notes = $derived(view.notes);
+	const listing = $derived(view.listing);
+	const pathLabel = $derived(path ? `/${path.replace(/^\//, '')}` : '');
+
+	const summaryTitle = $derived(
+		mode === 'drives'
+			? `Listed ${drives.length} drive${drives.length === 1 ? '' : 's'}`
+			: pathLabel
+				? `${listing ? 'Browsed' : 'Browsing'} ${pathLabel}`
+				: providerId
+					? `${listing ? 'Browsed' : 'Browsing'} ${providerId}`
+					: listing
+						? 'Browsed storage'
+						: 'Browse storage'
+	);
+</script>
+
+<ToolCard {tool} {compact} title={summaryTitle} icon="lucide:folder">
+	<ToolCardBody {compact} aria-label="Storage browse result">
+		{#if providerId || driveId}
+			<div class="flex flex-wrap items-center gap-1.5 text-caption text-muted-foreground">
+				{#if providerId}
+					<span class="truncate font-mono">{providerId}</span>
+				{/if}
+				{#if driveId}
+					<span class="truncate font-mono">{driveId}</span>
+				{/if}
+			</div>
+		{/if}
+
+		{#if !listing}
+			<p class="text-muted-foreground italic">
+				{providerId ? `Listing ${pathLabel || providerId}…` : 'Listing storage drives…'}
+			</p>
+		{:else if mode === 'drives'}
+			{#if drives.length}
+				<ul class="space-y-1.5">
+					{#each drives as drive (drive.id)}
+						<li class="flex items-center gap-2">
+							<Icon icon="lucide:hard-drive" class="size-3.5 shrink-0 text-muted-foreground" />
+							<span class="min-w-0 flex-1 truncate font-medium text-foreground">{drive.name}</span>
+							{#if drive.scope}
+								<Badge variant="outline" class="shrink-0 text-caption">{drive.scope}</Badge>
+							{/if}
+							{#if drive.kind}
+								<span class="shrink-0 font-mono text-caption text-muted-foreground"
+									>{drive.kind}</span
+								>
+							{/if}
+						</li>
+					{/each}
+				</ul>
+			{:else}
+				<p class="text-muted-foreground italic">No storage drives.</p>
+			{/if}
+		{:else if entries.length}
+			<ul class="space-y-1">
+				{#each entries as entry (entry.path)}
+					<li class="flex items-center gap-2">
+						<Icon
+							icon={entry.kind === 'directory' ? 'lucide:folder' : 'lucide:file'}
+							class="size-3.5 shrink-0 text-muted-foreground"
+						/>
+						<span class="min-w-0 flex-1 truncate text-foreground">{entry.name}</span>
+						{#if entry.sizeBytes !== undefined}
+							<span class="shrink-0 tabular-nums text-caption text-muted-foreground">
+								{fmtSize(entry.sizeBytes)}
+							</span>
+						{/if}
+					</li>
+				{/each}
+			</ul>
+		{:else}
+			<p class="text-muted-foreground italic">Empty folder.</p>
+		{/if}
+
+		{#if notes.length}
+			<ul class="space-y-1">
+				{#each notes as note (note)}
+					<li class="text-caption text-muted-foreground">{note}</li>
+				{/each}
+			</ul>
+		{/if}
+	</ToolCardBody>
+</ToolCard>

package/dist/svelte/tool-widgets/StorageBrowseToolCard.svelte.d.ts

@@ -0,0 +1,9 @@
+/**
+     * Designed widget for `storage.browse`. Always composes Kit `ToolCard` —
+     * empty folders, drive lists, pending calls, and failures stay on this card.
+     */
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const StorageBrowseToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type StorageBrowseToolCard = ReturnType<typeof StorageBrowseToolCard>;
+export default StorageBrowseToolCard;
+//# sourceMappingURL=StorageBrowseToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/StorageBrowseToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageBrowseToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/StorageBrowseToolCard.svelte.ts"],"names":[],"mappings":"AAGA;;;OAGI;AACJ,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AA0GnD,QAAA,MAAM,qBAAqB,qDAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}