sh3-core 0.20.1 → 0.20.3

package/dist/documents/http-backend.js

@@ -128,6 +128,31 @@ export class HttpDocumentBackend {
             throw new Error(`readBranch failed: ${res.status}`);
         return res.text();
     }
+    async xfer(srcTenant, srcPath, dstTenant, dstPath, opts) {
+        var _a;
+        const url = `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/xfer`;
+        const res = await apiFetch(url, {
+            method: 'POST',
+            headers: Object.assign(Object.assign({}, __classPrivateFieldGet(this, _HttpDocumentBackend_instances, "m", _HttpDocumentBackend_authHeaders).call(this)), { 'Content-Type': 'application/json' }),
+            body: JSON.stringify({
+                src: { scope: srcTenant, path: srcPath },
+                dst: { scope: dstTenant, path: dstPath },
+                move: (_a = opts === null || opts === void 0 ? void 0 : opts.move) !== null && _a !== void 0 ? _a : false,
+            }),
+            credentials: 'include',
+        });
+        if (!res.ok) {
+            let detail = `HTTP ${res.status}`;
+            try {
+                const b = await res.json();
+                if (b.error)
+                    detail = b.error;
+            }
+            catch ( /* not JSON */_b) { /* not JSON */ }
+            throw new Error(`xfer failed: ${detail}`);
+        }
+        return res.json();
+    }
     async rename(tenantId, shardId, oldPath, newPath) {
         const url = `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}/${oldPath}/rename`;
         const headers = Object.assign(Object.assign({}, __classPrivateFieldGet(this, _HttpDocumentBackend_instances, "m", _HttpDocumentBackend_authHeaders).call(this)), { 'Content-Type': 'application/json' });
@@ -147,6 +172,67 @@ export class HttpDocumentBackend {
             throw new Error(`Document rename failed: ${res.status}`);
         }
     }
+    async mkdir(tenantId, shardId, path) {
+        const url = `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}/${path}/mkdir`;
+        const res = await apiFetch(url, {
+            method: 'POST',
+            headers: __classPrivateFieldGet(this, _HttpDocumentBackend_instances, "m", _HttpDocumentBackend_authHeaders).call(this),
+            credentials: 'include',
+        });
+        if (!res.ok) {
+            let detail = `HTTP ${res.status}`;
+            try {
+                const b = await res.json();
+                if (b.error)
+                    detail = b.error;
+            }
+            catch ( /* not JSON */_a) { /* not JSON */ }
+            throw new Error(`mkdir failed: ${detail}`);
+        }
+    }
+    async rmdir(tenantId, shardId, path, opts) {
+        const url = `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}/${path}/rmdir`;
+        const res = await apiFetch(url, {
+            method: 'POST',
+            headers: Object.assign(Object.assign({}, __classPrivateFieldGet(this, _HttpDocumentBackend_instances, "m", _HttpDocumentBackend_authHeaders).call(this)), { 'Content-Type': 'application/json' }),
+            body: JSON.stringify({ recursive: opts.recursive }),
+            credentials: 'include',
+        });
+        if (!res.ok) {
+            let detail = `HTTP ${res.status}`;
+            try {
+                const b = await res.json();
+                if (b.error)
+                    detail = b.error;
+            }
+            catch ( /* not JSON */_a) { /* not JSON */ }
+            throw new Error(`rmdir failed: ${detail}`);
+        }
+    }
+    async renameFolder(tenantId, shardId, oldPath, newPath) {
+        const url = `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}/${oldPath}/rename-folder`;
+        const res = await apiFetch(url, {
+            method: 'POST',
+            headers: Object.assign(Object.assign({}, __classPrivateFieldGet(this, _HttpDocumentBackend_instances, "m", _HttpDocumentBackend_authHeaders).call(this)), { 'Content-Type': 'application/json' }),
+            body: JSON.stringify({ to: newPath }),
+            credentials: 'include',
+        });
+        if (res.status === 404)
+            throw new Error(`Folder not found at ${oldPath}`);
+        if (res.status === 409)
+            throw new Error(`Folder already exists at ${newPath}`);
+        if (!res.ok)
+            throw new Error(`renameFolder failed: ${res.status}`);
+    }
+    async listFolders(tenantId, shardId, prefix) {
+        const base = prefix
+            ? `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}/${prefix}?folders=1`
+            : `${__classPrivateFieldGet(this, _HttpDocumentBackend_baseUrl, "f")}/api/docs/${tenantId}/${shardId}?folders=1`;
+        const res = await apiFetch(base, { credentials: 'include' });
+        if (!res.ok)
+            throw new Error(`listFolders failed: ${res.status}`);
+        return res.json();
+    }
 }
 _HttpDocumentBackend_baseUrl = new WeakMap(), _HttpDocumentBackend_apiKey = new WeakMap(), _HttpDocumentBackend_instances = new WeakSet(), _HttpDocumentBackend_authHeaders = function _HttpDocumentBackend_authHeaders() {
     if (!__classPrivateFieldGet(this, _HttpDocumentBackend_apiKey, "f"))

package/dist/documents/http-backend.test.js

@@ -1,4 +1,4 @@
-import { describe, it, expect, afterEach } from 'vitest';
+import { describe, it, expect, afterEach, vi } from 'vitest';
 import { HttpDocumentBackend } from './http-backend';
 const originalFetch = globalThis.fetch;
 describe('HttpDocumentBackend.readBranch', () => {
@@ -79,3 +79,119 @@ describe('HttpDocumentBackend.rename', () => {
             .rejects.toThrow(/rename failed/i);
     });
 });
+describe('HttpDocumentBackend folder ops', () => {
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it('mkdir POSTs to /:path/mkdir', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ ok: true }), { status: 200 }));
+        globalThis.fetch = fetchMock;
+        const backend = new HttpDocumentBackend('http://server');
+        await backend.mkdir('t', 's', 'a/b');
+        expect(fetchMock).toHaveBeenCalledWith('http://server/api/docs/t/s/a/b/mkdir', expect.objectContaining({ method: 'POST' }));
+    });
+    it('rmdir POSTs to /:path/rmdir with recursive flag', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ ok: true }), { status: 200 }));
+        globalThis.fetch = fetchMock;
+        const backend = new HttpDocumentBackend('http://server');
+        await backend.rmdir('t', 's', 'a', { recursive: true });
+        const call = fetchMock.mock.calls[0];
+        expect(call[0]).toBe('http://server/api/docs/t/s/a/rmdir');
+        const body = JSON.parse(call[1].body);
+        expect(body).toEqual({ recursive: true });
+    });
+    it('rmdir throws on 409', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue(new Response(JSON.stringify({ error: 'not empty' }), { status: 409 }));
+        const backend = new HttpDocumentBackend('http://server');
+        await expect(backend.rmdir('t', 's', 'a', { recursive: false })).rejects.toThrow();
+    });
+    it('renameFolder POSTs to /:path/rename-folder with { to }', async () => {
+        const fetchMock = vi.fn().mockResolvedValue(new Response(JSON.stringify({ ok: true }), { status: 200 }));
+        globalThis.fetch = fetchMock;
+        const backend = new HttpDocumentBackend('http://server');
+        await backend.renameFolder('t', 's', 'old', 'new');
+        const call = fetchMock.mock.calls[0];
+        expect(call[0]).toBe('http://server/api/docs/t/s/old/rename-folder');
+        expect(JSON.parse(call[1].body)).toEqual({ to: 'new' });
+    });
+    it('listFolders at root uses ?folders=1 on the shard list URL', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue(new Response(JSON.stringify(['a', 'b']), { status: 200 }));
+        const backend = new HttpDocumentBackend('http://server');
+        const result = await backend.listFolders('t', 's', '');
+        expect(globalThis.fetch).toHaveBeenCalledWith('http://server/api/docs/t/s?folders=1', expect.any(Object));
+        expect(result).toEqual(['a', 'b']);
+    });
+    it('listFolders with prefix uses ?folders=1 on the path URL', async () => {
+        globalThis.fetch = vi.fn().mockResolvedValue(new Response(JSON.stringify(['c']), { status: 200 }));
+        const backend = new HttpDocumentBackend('http://server');
+        const result = await backend.listFolders('t', 's', 'a');
+        expect(globalThis.fetch).toHaveBeenCalledWith('http://server/api/docs/t/s/a?folders=1', expect.any(Object));
+        expect(result).toEqual(['c']);
+    });
+});
+describe('HttpDocumentBackend.xfer', () => {
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    it('POSTs to /api/xfer with src, dst, and move in the body', async () => {
+        var _a, _b;
+        const calls = [];
+        globalThis.fetch = (async (url, init) => {
+            calls.push({ url: String(url), init });
+            return new Response(JSON.stringify({ ok: true, existed: false }), { status: 200 });
+        });
+        const be = new HttpDocumentBackend('http://server', 'apikey-1');
+        const result = await be.xfer('alice', 'notes/draft.md', 'proj-1', 'notes/draft.md', { move: true });
+        expect(calls).toHaveLength(1);
+        expect(calls[0].url).toBe('http://server/api/xfer');
+        expect((_a = calls[0].init) === null || _a === void 0 ? void 0 : _a.method).toBe('POST');
+        const body = JSON.parse((_b = calls[0].init) === null || _b === void 0 ? void 0 : _b.body);
+        expect(body).toEqual({
+            src: { scope: 'alice', path: 'notes/draft.md' },
+            dst: { scope: 'proj-1', path: 'notes/draft.md' },
+            move: true,
+        });
+        expect(result).toEqual({ ok: true, existed: false });
+    });
+    it('sends move=false when opts.move is false', async () => {
+        var _a;
+        const calls = [];
+        globalThis.fetch = (async (url, init) => {
+            calls.push({ url: String(url), init });
+            return new Response(JSON.stringify({ ok: true, existed: true }), { status: 200 });
+        });
+        const be = new HttpDocumentBackend('http://server');
+        await be.xfer('alice', 'notes/a.md', 'proj-1', 'notes/a.md', { move: false });
+        const body = JSON.parse((_a = calls[0].init) === null || _a === void 0 ? void 0 : _a.body);
+        expect(body.move).toBe(false);
+    });
+    it('sends move=false when opts is omitted', async () => {
+        var _a;
+        const calls = [];
+        globalThis.fetch = (async (url, init) => {
+            calls.push({ url: String(url), init });
+            return new Response(JSON.stringify({ ok: true, existed: false }), { status: 200 });
+        });
+        const be = new HttpDocumentBackend('http://server');
+        await be.xfer('alice', 'notes/a.md', 'proj-1', 'notes/a.md');
+        const body = JSON.parse((_a = calls[0].init) === null || _a === void 0 ? void 0 : _a.body);
+        expect(body.move).toBe(false);
+    });
+    it('includes Authorization header when apiKey is set', async () => {
+        var _a;
+        const calls = [];
+        globalThis.fetch = (async (url, init) => {
+            calls.push({ url: String(url), init });
+            return new Response(JSON.stringify({ ok: true, existed: false }), { status: 200 });
+        });
+        const be = new HttpDocumentBackend('http://server', 'my-key');
+        await be.xfer('alice', 'notes/a.md', 'proj-1', 'notes/a.md');
+        const headers = (_a = calls[0].init) === null || _a === void 0 ? void 0 : _a.headers;
+        expect(headers['Authorization']).toBe('Bearer my-key');
+    });
+    it('throws with server error message on non-ok response', async () => {
+        globalThis.fetch = (async () => new Response(JSON.stringify({ error: 'Source document not found' }), { status: 404 }));
+        const be = new HttpDocumentBackend('http://server');
+        await expect(be.xfer('alice', 'notes/missing.md', 'proj-1', 'notes/missing.md')).rejects.toThrow('Source document not found');
+    });
+});

package/dist/documents/index.d.ts

@@ -3,6 +3,6 @@ export { MemoryDocumentBackend, IndexedDBDocumentBackend } from './backends';
 export { HttpDocumentBackend } from './http-backend';
 export { createDocumentHandle } from './handle';
 export { documentChanges } from './notifications';
-export { getActiveScopeId, getTenantId, getDocumentBackend, __setActiveScope, __setTenantId, __setDocumentBackend, __setScopeResolver, } from './config';
+export { getActiveScopeId, getDocumentBackend, __setActiveScope, __setDocumentBackend, __setScopeResolver, } from './config';
 export type { SyncPolicy, SyncPolicyRule, DocStatus, ConflictFile, ConflictBranch, } from './sync-types';
 export { PERMISSION_SYNC_PEER, PERMISSION_SYNC_POLICY, } from './sync-types';

package/dist/documents/index.js

@@ -5,5 +5,5 @@ export { MemoryDocumentBackend, IndexedDBDocumentBackend } from './backends';
 export { HttpDocumentBackend } from './http-backend';
 export { createDocumentHandle } from './handle';
 export { documentChanges } from './notifications';
-export { getActiveScopeId, getTenantId, getDocumentBackend, __setActiveScope, __setTenantId, __setDocumentBackend, __setScopeResolver, } from './config';
+export { getActiveScopeId, getDocumentBackend, __setActiveScope, __setDocumentBackend, __setScopeResolver, } from './config';
 export { PERMISSION_SYNC_PEER, PERMISSION_SYNC_POLICY, } from './sync-types';

package/dist/documents/picker-api.test.js

@@ -43,7 +43,7 @@ beforeEach(() => {
     vi.clearAllMocks();
 });
 describe('createDocumentPicker', () => {
-    const sampleDoc = { shardId: 'my-shard', path: 'readme.md' };
+    const sampleDoc = { shardId: 'my-shard', path: 'readme.md', kind: 'file' };
     describe('open() — modal (no anchor)', () => {
         it('resolves with OpenerValue when user commits', async () => {
             const listFn = async () => [{ shardId: 'my-shard', path: 'readme.md', size: 100, lastModified: 0 }];
@@ -53,7 +53,7 @@ describe('createDocumentPicker', () => {
             await vi.waitFor(() => expect(mockModalOpen).toHaveBeenCalledOnce());
             modal.commit(sampleDoc);
             const result = await promise;
-            expect(result).toEqual({ shardId: 'my-shard', path: 'readme.md' });
+            expect(result).toEqual({ shardId: 'my-shard', path: 'readme.md', kind: 'file' });
             expect(mockPopupShow).not.toHaveBeenCalled();
         });
         it('resolves with null when user cancels', async () => {

package/dist/documents/types.d.ts

@@ -73,26 +73,37 @@ export interface DocumentMeta {
     deleted?: boolean;
 }
 /** Change notification payload delivered to watch callbacks. */
-export interface DocumentChange {
-    type: 'create' | 'update' | 'delete' | 'rename';
-    /**
-     * For 'create' / 'update' / 'delete', the affected document path.
-     * For 'rename', the new path the document now lives at.
-     */
+export type DocumentChange = {
+    type: 'create' | 'update' | 'delete';
     path: string;
-    /**
-     * Populated only when type === 'rename'. The path the document
-     * used to live at before the rename.
-     */
-    oldPath?: string;
     tenantId: string;
     shardId: string;
-}
-/** Type guard: narrows a DocumentChange to the rename variant. */
-export declare function isRename(change: DocumentChange): change is DocumentChange & {
+} | {
     type: 'rename';
+    path: string;
+    oldPath: string;
+    tenantId: string;
+    shardId: string;
+} | {
+    type: 'folder-create' | 'folder-delete';
+    path: string;
+    tenantId: string;
+    shardId: string;
+} | {
+    type: 'folder-rename';
+    path: string;
     oldPath: string;
+    tenantId: string;
+    shardId: string;
 };
+/** Type guard: narrows a DocumentChange to the rename variant. */
+export declare function isRename(change: DocumentChange): change is Extract<DocumentChange, {
+    type: 'rename';
+}>;
+/** Type guard: narrows a DocumentChange to the folder-rename variant. */
+export declare function isFolderRename(change: DocumentChange): change is Extract<DocumentChange, {
+    type: 'folder-rename';
+}>;
 import type { DocStatus } from './sync-types';
 /**
  * File-oriented backend for the document zone.
@@ -120,6 +131,31 @@ export interface DocumentBackend {
      * as folder semantics.
      */
     rename(tenantId: string, shardId: string, oldPath: string, newPath: string): Promise<void>;
+    /**
+     * Create an empty folder. No-op if the folder already exists.
+     * Throws if a document occupies the path.
+     */
+    mkdir(tenantId: string, shardId: string, path: string): Promise<void>;
+    /**
+     * Remove a folder. Throws if non-empty and `recursive` is false.
+     * When `recursive: true`, atomically removes the folder and all
+     * descendant documents and folders.
+     */
+    rmdir(tenantId: string, shardId: string, path: string, opts: {
+        recursive: boolean;
+    }): Promise<void>;
+    /**
+     * Rename a folder atomically. Rewrites all descendant document paths
+     * to use the new prefix. Throws if `oldPath` does not exist as a
+     * folder, or if `newPath` already exists.
+     */
+    renameFolder(tenantId: string, shardId: string, oldPath: string, newPath: string): Promise<void>;
+    /**
+     * List immediate folder children of `prefix`. Returns folder names
+     * (not full paths). Empty `prefix` lists folders directly under the
+     * shard root.
+     */
+    listFolders(tenantId: string, shardId: string, prefix: string): Promise<string[]>;
     /** List all documents stored for this tenant + shard combination. */
     list(tenantId: string, shardId: string): Promise<DocumentMeta[]>;
     /** Return true if the document at `path` exists. */
@@ -156,6 +192,17 @@ export interface DocumentBackend {
      * Optional; only supported by HttpDocumentBackend in v1.
      */
     readBranch?(tenantId: string, shardId: string, path: string, origin: string): Promise<string | null>;
+    /**
+     * Server-side cross-scope transfer. When implemented, `transferBetweenScopes`
+     * delegates to this rather than doing client-side read+write, bypassing the
+     * per-shard app allowlist check. `srcPath` and `dstPath` are in the form
+     * `shardId/filePath`. Returns whether the destination document already existed.
+     */
+    xfer?(srcTenant: string, srcPath: string, dstTenant: string, dstPath: string, opts?: {
+        move?: boolean;
+    }): Promise<{
+        existed: boolean;
+    }>;
 }
 /**
  * Shard-facing document handle returned by `ctx.documents()`. Binds
@@ -187,6 +234,32 @@ export interface DocumentHandle {
      * extensions filter — newPath must satisfy the filter.
      */
     rename(oldPath: string, newPath: string, opts?: ScopeOption): Promise<void>;
+    /**
+     * Create an empty folder at `path`. No-op if the folder already
+     * exists. Throws if a document occupies the path.
+     */
+    mkdir(path: string, opts?: ScopeOption): Promise<void>;
+    /**
+     * Remove a folder. Throws if non-empty and `opts.recursive` is not
+     * true. When `opts.recursive` is true, atomically removes the folder
+     * and all descendants. Throws if any active autosave controller's
+     * path falls inside the folder.
+     */
+    rmdir(path: string, opts?: {
+        recursive?: boolean;
+    } & ScopeOption): Promise<void>;
+    /**
+     * Rename a folder. Atomically rewrites all descendant document paths.
+     * Throws if any active autosave controller's path falls inside the
+     * folder (caller must flush and dispose first). Throws if `newPath`
+     * already exists or if `oldPath` does not.
+     */
+    renameFolder(oldPath: string, newPath: string, opts?: ScopeOption): Promise<void>;
+    /**
+     * List immediate folder children of `prefix`. Empty `prefix` (or
+     * omitted) lists folders directly under the shard root.
+     */
+    listFolders(prefix?: string, opts?: ScopeOption): Promise<string[]>;
     /** Check existence without reading content. */
     exists(path: string): Promise<boolean>;
     /** Fetch sync-state metadata for a path. Null if the doc does not exist. */

package/dist/documents/types.js

@@ -51,3 +51,7 @@ export const PERMISSION_DOCUMENTS_MOUNT = 'documents:mount';
 export function isRename(change) {
     return change.type === 'rename';
 }
+/** Type guard: narrows a DocumentChange to the folder-rename variant. */
+export function isFolderRename(change) {
+    return change.type === 'folder-rename';
+}

package/dist/host-entry.d.ts

@@ -1,6 +1,6 @@
 export { registerShard, registerApp, bootstrap, __setBackend, setLocalOwner } from './host';
 export type { BootstrapConfig } from './host';
-export { __setActiveScope, __setTenantId, __setDocumentBackend } from './host';
+export { __setActiveScope, __setDocumentBackend } from './host';
 export type { Backend } from './state/types';
 export type { DocumentBackend } from './documents/types';
 export { HttpDocumentBackend } from './documents/http-backend';

package/dist/host-entry.js

@@ -6,7 +6,7 @@
  * should touch this path. Shards and apps must not import from here.
  */
 export { registerShard, registerApp, bootstrap, __setBackend, setLocalOwner } from './host';
-export { __setActiveScope, __setTenantId, __setDocumentBackend } from './host';
+export { __setActiveScope, __setDocumentBackend } from './host';
 export { HttpDocumentBackend } from './documents/http-backend';
 export { IndexedDBDocumentBackend, MemoryDocumentBackend } from './documents/backends';
 export { __setEnvServerUrl } from './env/index';

package/dist/host.d.ts

@@ -4,7 +4,7 @@ import { __setBackend } from './state/zones.svelte';
 import { setLocalOwner } from './auth/index';
 export { __setBackend };
 export { setLocalOwner };
-export { __setActiveScope, __setTenantId, __setDocumentBackend } from './documents/config';
+export { __setActiveScope, __setDocumentBackend } from './documents/config';
 export declare function registerShard(shard: Parameters<typeof registerShardInternal>[0]): void;
 export { registerApp };
 export interface BootstrapConfig {

package/dist/host.js

@@ -38,7 +38,7 @@ import { installWebEmitter } from './navigation/platform-web';
 import { returnToHome } from './apps/lifecycle';
 export { __setBackend };
 export { setLocalOwner };
-export { __setActiveScope, __setTenantId, __setDocumentBackend } from './documents/config';
+export { __setActiveScope, __setDocumentBackend } from './documents/config';
 import { getActiveScopeId } from './documents/config';
 export function registerShard(shard) {
     registerShardInternal(shard);

package/dist/layout/slotHostPool.svelte.js

@@ -75,7 +75,7 @@ function onViewRegistered(viewId, factory) {
             if (entry.handle !== undefined)
                 return; // already mounted by a race
             entry.handle = factory.mount(entry.host, ctx);
-            if (((_a = entry.handle) === null || _a === void 0 ? void 0 : _a.closable) || slotId.startsWith('float:')) {
+            if (((_a = entry.handle) === null || _a === void 0 ? void 0 : _a.closable) || slotId.startsWith('float:') || slotId.startsWith('standalone:')) {
                 closableState[slotId] = true;
             }
             if ((_b = entry.handle) === null || _b === void 0 ? void 0 : _b.onResize) {
@@ -179,7 +179,7 @@ function createHost(slotId, viewId, label, meta) {
             },
         };
         entry.handle = factory === null || factory === void 0 ? void 0 : factory.mount(host, ctx);
-        if (((_a = entry.handle) === null || _a === void 0 ? void 0 : _a.closable) || slotId.startsWith('float:')) {
+        if (((_a = entry.handle) === null || _a === void 0 ? void 0 : _a.closable) || slotId.startsWith('float:') || slotId.startsWith('standalone:')) {
             closableState[slotId] = true;
         }
         // The pool owns the ResizeObserver so its lifetime matches the

package/dist/overlays/FloatFrame.svelte

@@ -262,6 +262,7 @@
         title: entry.title,
         size: { w: entry.size.w, h: entry.size.h },
         activateShards: walkShardsForContent(entry.content),
+        projectId: sh3.getActiveScope().isProject ? sh3.getActiveScope().id : undefined,
       });
       floatManager.close(entry.id);
     } catch (err) {

package/dist/primitives/widgets/DocumentFilePicker.d.ts

@@ -2,7 +2,11 @@ import type { DocumentMeta } from '../../documents/types';
 export type DocEntry = DocumentMeta & {
     shardId: string;
 };
-export type OpenerValue = Pick<DocEntry, 'shardId' | 'path'> | null;
+export type OpenerValue = {
+    shardId: string;
+    path: string;
+    kind: 'file' | 'folder';
+} | null;
 export type SaverValue = string | null;
 export type FileItem = {
     kind: 'folder';
@@ -13,7 +17,7 @@ export type FileItem = {
     name: string;
     doc: DocEntry;
 };
-export declare function buildTree(docs: DocEntry[], shardId: string | null, prefix: string): FileItem[];
+export declare function buildTree(docs: DocEntry[], folders: string[], shardId: string | null, prefix: string): FileItem[];
 export declare function formatSize(bytes: number): string;
 export declare function formatDate(epochMs: number): string;
 export declare function iconForFile(name: string): string;

package/dist/primitives/widgets/DocumentFilePicker.js

@@ -1,10 +1,10 @@
-export function buildTree(docs, shardId, prefix) {
+export function buildTree(docs, folders, shardId, prefix) {
     if (shardId === null) {
         const shards = [...new Set(docs.map((d) => d.shardId))].sort();
         return shards.map((s) => ({ kind: 'folder', name: s, fullPath: s }));
     }
     const shardDocs = docs.filter((d) => d.shardId === shardId);
-    const folders = new Map();
+    const folderMap = new Map();
     const files = [];
     const normPrefix = prefix ? prefix + '/' : '';
     const plen = normPrefix.length;
@@ -16,14 +16,21 @@ export function buildTree(docs, shardId, prefix) {
         if (slash >= 0) {
             const name = relative.slice(0, slash);
             const full = prefix ? `${prefix}/${name}` : name;
-            if (!folders.has(name))
-                folders.set(name, full);
+            if (!folderMap.has(name))
+                folderMap.set(name, full);
         }
         else {
             files.push({ kind: 'file', name: relative, doc });
         }
     }
-    const folderItems = [...folders.entries()]
+    // Merge explicit empty folders (immediate children of prefix)
+    for (const name of folders) {
+        if (folderMap.has(name))
+            continue;
+        const full = prefix ? `${prefix}/${name}` : name;
+        folderMap.set(name, full);
+    }
+    const folderItems = [...folderMap.entries()]
         .map(([name, fullPath]) => ({ kind: 'folder', name, fullPath }))
         .sort((a, b) => a.name.localeCompare(b.name));
     const fileItems = files.sort((a, b) => a.name.localeCompare(b.name));

package/dist/primitives/widgets/DocumentFilePicker.svelte

@@ -6,24 +6,40 @@
   import type { DocEntry, OpenerValue, SaverValue } from './DocumentFilePicker';
 
   type DocListFn = () => Promise<Array<DocumentMeta & { shardId: string }>>;
+  type FolderListFn = (shardId: string, prefix: string) => Promise<string[]>;
+  type HandleFn = {
+    mkdir: (shardId: string, path: string) => Promise<void>;
+    rmdir: (shardId: string, path: string, opts: { recursive: boolean }) => Promise<void>;
+    renameFolder: (shardId: string, oldPath: string, newPath: string) => Promise<void>;
+    rename: (shardId: string, oldPath: string, newPath: string) => Promise<void>;
+    delete: (shardId: string, path: string) => Promise<void>;
+  };
 
   let {
     mode,
     value = $bindable<OpenerValue | SaverValue>(null),
     listDocuments,
+    listFolders,
+    handle,
+    readOnlyShard,
     disabled = false,
     invalid = false,
     size = 'md',
     buttonLabel = 'Choose…',
+    selectable = 'file',
     onchange,
   }: {
     mode: 'open' | 'save';
     value?: OpenerValue | SaverValue;
     listDocuments: DocListFn;
+    listFolders?: FolderListFn;
+    handle?: HandleFn;
+    readOnlyShard?: (shardId: string) => boolean;
     disabled?: boolean;
     invalid?: boolean;
     size?: 'sm' | 'md';
     buttonLabel?: string;
+    selectable?: 'file' | 'folder' | 'both';
   } & CommitOnlyEvents<OpenerValue | SaverValue> = $props();
 
   let trigger = $state<HTMLButtonElement | undefined>(undefined);
@@ -33,7 +49,9 @@
     value
       ? typeof value === 'string'
         ? value
-        : `${value.shardId}/${value.path}`
+        : value.kind === 'folder'
+          ? `${value.shardId}/${value.path}/`
+          : `${value.shardId}/${value.path}`
       : null,
   );
 
@@ -63,6 +81,10 @@
       {
         mode,
         docs,
+        selectable,
+        listFolders,
+        handle,
+        readOnlyShard,
         onCommit: (result: OpenerValue | SaverValue) => {
           handleCommit(result);
         },

package/dist/primitives/widgets/DocumentFilePicker.svelte.d.ts

@@ -4,14 +4,28 @@ import type { OpenerValue, SaverValue } from './DocumentFilePicker';
 type DocListFn = () => Promise<Array<DocumentMeta & {
     shardId: string;
 }>>;
+type FolderListFn = (shardId: string, prefix: string) => Promise<string[]>;
+type HandleFn = {
+    mkdir: (shardId: string, path: string) => Promise<void>;
+    rmdir: (shardId: string, path: string, opts: {
+        recursive: boolean;
+    }) => Promise<void>;
+    renameFolder: (shardId: string, oldPath: string, newPath: string) => Promise<void>;
+    rename: (shardId: string, oldPath: string, newPath: string) => Promise<void>;
+    delete: (shardId: string, path: string) => Promise<void>;
+};
 type $$ComponentProps = {
     mode: 'open' | 'save';
     value?: OpenerValue | SaverValue;
     listDocuments: DocListFn;
+    listFolders?: FolderListFn;
+    handle?: HandleFn;
+    readOnlyShard?: (shardId: string) => boolean;
     disabled?: boolean;
     invalid?: boolean;
     size?: 'sm' | 'md';
     buttonLabel?: string;
+    selectable?: 'file' | 'folder' | 'both';
 } & CommitOnlyEvents<OpenerValue | SaverValue>;
 declare const DocumentFilePicker: import("svelte").Component<$$ComponentProps, {}, "value">;
 type DocumentFilePicker = ReturnType<typeof DocumentFilePicker>;

package/dist/primitives/widgets/DocumentFilePicker.test.d.ts

@@ -0,0 +1 @@
+export {};