@hachej/boring-ui-kit 0.4.35 → 0.4.36

package/dist/file-tree-view.d.ts

@@ -59,6 +59,7 @@ export declare const defaultFileTreeLabels: {
     delete: string;
     deleteTitle: (name: string) => string;
     deleteDescription: string;
+    deleteFolderDescription: string;
     cancel: string;
     changing: string;
     renamed: (to: string) => string;

package/dist/file-tree-view.js

@@ -60,6 +60,7 @@ export const defaultFileTreeLabels = {
     delete: 'Delete',
     deleteTitle: (name) => `Delete ${name}?`,
     deleteDescription: 'It is removed from this workspace for everyone who uses it.',
+    deleteFolderDescription: 'Every file in this folder is removed from this workspace for everyone who uses it.',
     cancel: 'Cancel',
     changing: 'Saving…',
     renamed: (to) => `Renamed to ${to}`,
@@ -125,6 +126,7 @@ export const frenchFileTreeLabels = {
     delete: 'Supprimer',
     deleteTitle: name => `Supprimer ${name} ?`,
     deleteDescription: 'Il est retiré de cet espace pour tous ceux qui l’utilisent.',
+    deleteFolderDescription: 'Tous les fichiers de ce dossier sont retirés de cet espace pour tous ceux qui l’utilisent.',
     cancel: 'Annuler',
     changing: 'Enregistrement…',
     renamed: to => `Renommé en ${to}`,
@@ -389,7 +391,7 @@ export function FileTreeView({ components, controller, onOpen, selectedPath, cla
                 node.focus();
     };
     /** Files only: a provider renames and deletes regular files, and a row busy uploading or changing waits. */
-    const mutable = (entry) => entry.kind === 'file' && !temporaryPaths.has(entry.path) && uploadRows.get(entry.path)?.kind !== 'pending' && mutationRows.get(entry.path)?.state.kind !== 'pending';
+    const mutable = (entry) => !temporaryPaths.has(entry.path) && uploadRows.get(entry.path)?.kind !== 'pending' && mutationRows.get(entry.path)?.state.kind !== 'pending';
     /** A blob pointer's row shows the file it stands for, not the pointer's own name: it can be moved or deleted, not renamed in place. */
     const renameable = (entry) => !entry.blob;
     const keyboard = (event, entry) => {
@@ -470,7 +472,7 @@ export function FileTreeView({ components, controller, onOpen, selectedPath, cla
         const Icon = kind.icon;
         const mutation = mutationRows.get(entry.path);
         const changeable = mutable(entry);
-        const draggable = changeable && can.rename;
+        const draggable = changeable && can.rename && !folder;
         const button = _jsxs(Button, { type: "button", variant: selectedPath === entry.path ? 'secondary' : 'ghost', "data-active": selectedPath === entry.path, tabIndex: -1, title: entry.path, disabled: temporary, className: "file-tree-row-button", draggable: draggable || undefined, onClick: () => { focus(entry.path); if (!folder)
                 onOpen?.(entry.path); }, children: [folder ? _jsx(ChevronRight, { "aria-hidden": "true" }) : list && _jsx("span", { className: "file-tree-chevron-space", "aria-hidden": "true" }), _jsx(Icon, { "aria-hidden": "true" }), _jsxs("span", { className: "file-tree-copy", children: [_jsx("span", { className: "file-tree-name", children: name }), list ? folder ? childCount !== undefined && _jsx("span", { "data-file-meta": true, children: childCount }) : _jsxs("span", { "data-file-meta": true, children: [kind.label, " \u00B7 ", fileSize(blob?.size ?? entry.size, locale), parent && ` · ${parent}`] }) : parent && _jsx("span", { className: "file-tree-parent", "data-file-meta": true, children: parent })] })] });
         const editing = renaming?.path === entry.path && can.rename;
@@ -503,14 +505,15 @@ export function FileTreeView({ components, controller, onOpen, selectedPath, cla
                                     }, 
                                     // Focus moved somewhere on purpose cancels; a closing menu that drops focus (no related target) does not.
                                     onBlur: event => { if (event.relatedTarget)
-                                        setRenaming(current => current?.path === entry.path ? undefined : current); } })] }) : folder ? _jsx(CollapsibleTrigger, { render: button }) : button, (status?.kind === 'pending' || mutation?.state.kind === 'pending') && _jsx(LoaderCircle, { "data-upload-spinner": status ? '' : undefined, "data-mutation-spinner": mutation ? '' : undefined, className: "animate-spin motion-reduce:animate-none", "aria-hidden": "true" }), status?.kind === 'failed' && _jsx(Button, { type: "button", variant: "ghost", "data-upload-retry": true, "aria-label": status.retryLabel, onClick: status.retry, children: status.retryLabel }), mutation && mutationFailed && _jsx(Button, { type: "button", variant: "ghost", size: "icon", "data-mutation-dismiss": true, "aria-label": labels.dismiss(entry.path), title: labels.dismiss(entry.path), onClick: () => controller.dismiss(mutation.operationId), children: _jsx(X, { "aria-hidden": "true" }) }), !folder && !temporary && !status && !editing && mutation?.state.kind !== 'pending' && _jsx(FileActions, { Actions: Actions, controller: controller, entry: entry, labels: labels, onOpen: onOpen ? () => onOpen(entry.path) : undefined, onHistory: history ? () => setHistoryPath(entry.path) : undefined, onError: setUploadError, onRename: changeable && can.rename && renameable(entry) ? () => startRename(entry.path) : undefined, onMove: changeable && can.rename && Dialog ? () => ask('move', entry.path) : undefined, onDelete: changeable && can.delete ? () => ask('delete', entry.path) : undefined })] }), status?.kind === 'failed' && _jsx("span", { "data-upload-error": true, children: status.reason }), editing && renaming?.error && _jsx("span", { "data-mutation-error": true, role: "alert", children: renaming.error }), mutation && mutationFailed && _jsx("span", { "data-mutation-error": true, children: mutationReason(mutation) }), folder && !state.query && _jsx(CollapsibleContent, { render: _jsx(SidebarMenuSub, { role: "group" }), children: renderEntries(entry.path, level + 1) })] }, entry.path);
+                                        setRenaming(current => current?.path === entry.path ? undefined : current); } })] }) : folder ? _jsx(CollapsibleTrigger, { render: button }) : button, (status?.kind === 'pending' || mutation?.state.kind === 'pending') && _jsx(LoaderCircle, { "data-upload-spinner": status ? '' : undefined, "data-mutation-spinner": mutation ? '' : undefined, className: "animate-spin motion-reduce:animate-none", "aria-hidden": "true" }), status?.kind === 'failed' && _jsx(Button, { type: "button", variant: "ghost", "data-upload-retry": true, "aria-label": status.retryLabel, onClick: status.retry, children: status.retryLabel }), mutation && mutationFailed && _jsx(Button, { type: "button", variant: "ghost", size: "icon", "data-mutation-dismiss": true, "aria-label": labels.dismiss(entry.path), title: labels.dismiss(entry.path), onClick: () => controller.dismiss(mutation.operationId), children: _jsx(X, { "aria-hidden": "true" }) }), !temporary && !status && !editing && mutation?.state.kind !== 'pending' && (!folder || changeable && (can.rename || can.delete)) && _jsx(FileActions, { Actions: Actions, controller: controller, entry: entry, labels: labels, onOpen: onOpen && !folder ? () => onOpen(entry.path) : undefined, onHistory: history && !folder ? () => setHistoryPath(entry.path) : undefined, onError: setUploadError, onRename: changeable && can.rename && renameable(entry) ? () => startRename(entry.path) : undefined, onMove: changeable && can.rename && Dialog ? () => ask('move', entry.path) : undefined, onDelete: changeable && can.delete ? () => ask('delete', entry.path) : undefined })] }), status?.kind === 'failed' && _jsx("span", { "data-upload-error": true, children: status.reason }), editing && renaming?.error && _jsx("span", { "data-mutation-error": true, role: "alert", children: renaming.error }), mutation && mutationFailed && _jsx("span", { "data-mutation-error": true, children: mutationReason(mutation) }), folder && !state.query && _jsx(CollapsibleContent, { render: _jsx(SidebarMenuSub, { role: "group" }), children: renderEntries(entry.path, level + 1) })] }, entry.path);
         return folder ? _jsx(CollapsibleRoot, { render: item, open: state.expanded.has(entry.path), onOpenChange: () => { void controller.toggle(entry.path); } }, entry.path) : item;
     };
     const visibleListing = state.query ? state.search : state.directories.get('');
     const paginated = visibleListing?.kind === 'ready' && visibleListing.cursor !== undefined;
     const rootDrop = dropHandlers('');
     const dialogPath = asking?.path ?? '';
-    const folders = asking?.kind === 'move' ? [...new Set(['', ...[...state.directories.values(), state.search].flatMap(listing => listing.entries.filter(entry => entry.kind === 'directory').map(entry => entry.path))])].sort() : [];
+    const dialogIsFolder = [...state.directories.values(), state.search].some(listing => listing.entries.some(entry => entry.path === dialogPath && entry.kind === 'directory'));
+    const folders = asking?.kind === 'move' ? [...new Set(['', ...[...state.directories.values(), state.search].flatMap(listing => listing.entries.filter(entry => entry.kind === 'directory').map(entry => entry.path))])].filter(folder => folder !== dialogPath && !folder.startsWith(`${dialogPath}/`)).sort() : [];
     return _jsxs("section", { "data-boring": "file-tree", "data-variant": variant, "data-dropping": dropping || undefined, "data-drop-target": dropTarget === '' ? 'true' : undefined, className: className, "aria-label": labels.region, onDragEnter: event => { rootDrop.onDragEnter?.(event); if (upload && event.dataTransfer.types.includes('Files')) {
             event.preventDefault();
             dragDepth.current++;
@@ -535,7 +538,7 @@ export function FileTreeView({ components, controller, onOpen, selectedPath, cla
                     const percent = item.progress && item.progress.total > 0 ? Math.min(100, Math.round(item.progress.loaded / item.progress.total * 100)) : null;
                     return _jsxs("li", { "data-blob-upload": item.name, "data-progress": percent ?? undefined, className: "flex items-center gap-2", children: [_jsx("span", { className: "min-w-0 flex-1 truncate", children: item.name }), Progress ? _jsx("span", { className: "w-24 shrink-0", children: _jsx(Progress, { value: percent, "aria-label": labels.uploadProgress(item.name) }) }) : _jsx("span", { role: "status", children: percent === null ? labels.uploading : `${percent}%` }), _jsx(Button, { type: "button", variant: "ghost", size: "icon", "data-blob-upload-cancel": true, "aria-label": labels.cancelUpload(item.name), title: labels.cancelUpload(item.name), onClick: () => item.abort.abort(), children: _jsx(X, { "aria-hidden": "true" }) })] }, key);
                 }) }), _jsxs(SidebarMenu, { ref: tree, role: "tree", "aria-label": labels.tree, className: "file-tree-menu", children: [state.query ? _jsxs(_Fragment, { children: [state.search.entries.map(entry => renderEntry(entry, 1)), listingStatus(state.search, '', true)] }) : renderEntries('', 1), temporaryEntries.map(entry => renderEntry(entry, 1))] }), _jsxs("ul", { "aria-label": labels.uploads, "aria-live": "polite", "aria-relevant": "additions text", className: "file-tree-announcements", children: [state.uploads.map(upload => _jsxs("li", { "data-operation": upload.operationId, children: [upload.path, ": ", upload.state.kind === 'pending' ? labels.uploading : upload.state.result.kind === 'committed' ? labels.saved : upload.state.result.kind === 'partial' ? labels.unconfirmed : upload.state.result.reason] }, upload.operationId)), [...localFailures].map(([path, failure]) => _jsxs("li", { children: [path, ": ", failure.reason] }, path)), state.mutations.map(item => _jsxs("li", { "data-operation": item.operationId, children: [item.path, ": ", mutationReason(item)] }, item.operationId))] }), Dialog && _jsx(Dialog, { open: asking !== undefined, onOpenChange: open => { if (!open)
-                    closeAsking(); }, title: asking?.kind === 'move' ? labels.moveTitle(baseName(dialogPath)) : labels.deleteTitle(baseName(dialogPath)), description: asking?.kind === 'move' ? labels.moveDescription : labels.deleteDescription, footer: asking?.kind === 'delete' ? _jsxs(_Fragment, { children: [_jsx(Button, { type: "button", variant: "outline", "data-confirm": "cancel", onClick: closeAsking, children: labels.cancel }), _jsxs(Button, { type: "button", variant: "destructive", "data-confirm": "delete", onClick: () => {
+                    closeAsking(); }, title: asking?.kind === 'move' ? labels.moveTitle(baseName(dialogPath)) : labels.deleteTitle(baseName(dialogPath)), description: asking?.kind === 'move' ? labels.moveDescription : dialogIsFolder ? labels.deleteFolderDescription : labels.deleteDescription, footer: asking?.kind === 'delete' ? _jsxs(_Fragment, { children: [_jsx(Button, { type: "button", variant: "outline", "data-confirm": "cancel", onClick: closeAsking, children: labels.cancel }), _jsxs(Button, { type: "button", variant: "destructive", "data-confirm": "delete", onClick: () => {
                                 const path = dialogPath;
                                 setAsking(undefined);
                                 void controller.remove(path).then(report).catch(refused(path));
@@ -593,7 +596,8 @@ function FileActions({ Actions, controller, entry, labels, onOpen, onHistory, on
         items.push({ id: 'open', label: labels.open, icon: _jsx(FolderOpen, { "aria-hidden": "true" }), onSelect: onOpen });
     if (onHistory)
         items.push({ id: 'history', label: labels.history, icon: _jsx(History, { "aria-hidden": "true" }), onSelect: onHistory });
-    items.push({ id: 'download', label: labels.download, icon: _jsx(Download, { "aria-hidden": "true" }), onSelect: () => { void download(); } });
+    if (entry.kind === 'file')
+        items.push({ id: 'download', label: labels.download, icon: _jsx(Download, { "aria-hidden": "true" }), onSelect: () => { void download(); } });
     if (onRename)
         items.push({ id: 'rename', label: labels.rename, icon: _jsx(Pencil, { "aria-hidden": "true" }), onSelect: onRename, ownsFocus: true });
     if (onMove)

package/dist/file-tree.d.ts

@@ -74,11 +74,11 @@ export interface FileTreeController {
     };
     /** Learn the revision of a file as its row shows it (on opening its menu, renaming, dragging): a later rename or delete is conditional on it. */
     readonly prepare: (path: string, signal?: AbortSignal) => Promise<string | undefined>;
-    /** Rename a file through the client's conditional rename. `to` is a full path; its folder must exist. */
+    /** Rename a file through the client's conditional rename. `to` is a full path; its folder must exist. A listed folder renames file by file. */
     readonly rename: (path: string, to: string) => Promise<FileMutation>;
-    /** Move a file into `folder` (`''` is the workspace root): a rename that keeps its name. */
+    /** Move a file or a listed folder into `folder` (`''` is the workspace root): a rename that keeps its name. */
     readonly move: (path: string, folder: string) => Promise<FileMutation>;
-    /** Delete a file through the client's conditional delete. */
+    /** Delete a file through the client's conditional delete. A listed folder deletes every file in it. */
     readonly remove: (path: string) => Promise<FileMutation>;
     /** Forget a settled rename or delete (its row's message). */
     readonly dismiss: (operationId: string) => void;

package/dist/file-tree.js

@@ -138,7 +138,7 @@ export function createFileTreeController({ revisionProvider }) {
             void load('', false, true);
         return settled;
     }
-    async function mutate(kind, path, to) {
+    async function mutate(kind, path, to, prune = false) {
         active();
         if (kind === 'rename' ? !revisionProvider.rename : !revisionProvider.delete)
             throw new Error(`This workspace cannot ${kind} files`);
@@ -156,8 +156,8 @@ export function createFileTreeController({ revisionProvider }) {
             else {
                 const from = revisionProvider.locate(path);
                 const answer = kind === 'rename' && to !== undefined
-                    ? await revisionProvider.rename({ from, to: revisionProvider.locate(to), expectedRevision: known, operationId }, lifetime.signal)
-                    : await revisionProvider.delete({ path: from, expectedRevision: known, operationId }, lifetime.signal);
+                    ? await revisionProvider.rename({ from, to: revisionProvider.locate(to), expectedRevision: known, operationId, ...(prune ? { pruneEmptied: true } : {}) }, lifetime.signal)
+                    : await revisionProvider.delete({ path: from, expectedRevision: known, operationId, ...(prune ? { pruneEmptied: true } : {}) }, lifetime.signal);
                 try {
                     result = parsePublicationResult(answer);
                 }
@@ -175,6 +175,83 @@ export function createFileTreeController({ revisionProvider }) {
         revisions.delete(path);
         return settle(current, result);
     }
+    const isFolder = (path) => [...state.directories.values(), state.search].some(listing => listing.entries.some(entry => entry.path === path && entry.kind === 'directory'));
+    /** Every file under a folder, read now: a folder exists only through its files, so a retry finds what is left. */
+    async function filesIn(folder) {
+        const files = [];
+        let cursor;
+        do {
+            const page = await revisionProvider.list({ directory: folder, ...(cursor ? { cursor } : {}) }, lifetime.signal);
+            for (const entry of page.entries) {
+                if (entry.kind === 'directory')
+                    files.push(...await filesIn(entry.path));
+                else
+                    files.push(entry.path);
+            }
+            cursor = page.cursor;
+        } while (cursor);
+        return files;
+    }
+    /** Whether a path is listed in its folder, read now. */
+    async function present(path) {
+        let cursor;
+        do {
+            const page = await revisionProvider.list({ directory: parentOf(path), ...(cursor ? { cursor } : {}) }, lifetime.signal);
+            if (page.entries.some(entry => entry.path === path))
+                return true;
+            cursor = page.cursor;
+        } while (cursor);
+        return false;
+    }
+    /** A folder's rename, move or delete, one file at a time: providers change one file per operation. It stops at the first refusal and says how far it got. */
+    async function mutateFolder(kind, path, to) {
+        active();
+        if (kind === 'rename' ? !revisionProvider.rename : !revisionProvider.delete)
+            throw new Error(`This workspace cannot ${kind} files`);
+        if (state.mutations.some(item => item.path === path && item.state.kind === 'pending'))
+            throw new Error(`${path} is already being changed; wait for it to finish`);
+        const operationId = randomUUID();
+        const current = { operationId, kind, path, ...(to === undefined ? {} : { to }), state: { kind: 'pending' } };
+        update({ ...state, mutations: [...state.mutations.filter(item => item.path !== path), current] });
+        let result, done = 0, total = 0;
+        try {
+            // A rename onto a folder that exists would merge them: refused before anything moves.
+            if (to !== undefined && await present(to))
+                result = { kind: 'conflict', current: [], reason: `${nameOf(to)} already exists` };
+            else {
+                const files = await filesIn(path);
+                total = files.length;
+                for (const file of files) {
+                    const finished = await mutate(kind, file, to === undefined ? undefined : `${to}${file.slice(path.length)}`, true);
+                    const outcome = finished.state.kind === 'settled' ? finished.state.result : undefined;
+                    // An unconfirmed file may have changed: the count would be a guess, and a blind retry a mistake.
+                    if (outcome?.kind === 'unknown') {
+                        result = unknown(operationId, `At least ${done} of ${total} files of ${nameOf(path)} were changed, and one is unconfirmed; read the folder again before retrying`);
+                        break;
+                    }
+                    if (outcome?.kind !== 'committed') {
+                        result = { kind: 'unavailable', reason: `${done} of ${total} files of ${nameOf(path)} were changed. Try again to change the rest.` };
+                        break;
+                    }
+                    update({ ...state, mutations: state.mutations.filter(item => item.operationId !== finished.operationId) });
+                    result = outcome;
+                    done++;
+                }
+                result ??= { kind: 'unavailable', reason: `${nameOf(path)} has no files to change` };
+                // The listing leaves out ignored files, so a folder can outlive every file the tree could see: say so rather than report it gone.
+                if (result.kind === 'committed' && await present(path))
+                    result = { kind: 'unavailable', reason: `${done} of ${total} files of ${nameOf(path)} were changed. The folder is still there: it may hold files this list does not show.` };
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && lifetime.signal.aborted)
+                throw error;
+            result = unknown(operationId, `${done} of ${total || 'its'} files of ${nameOf(path)} were changed; read the folder again before retrying`);
+        }
+        const settled = settle(current, result);
+        update({ ...state, expanded: new Set([...state.expanded].filter(folder => folder !== path && !folder.startsWith(`${path}/`))) });
+        return settled;
+    }
     const controller = {
         revisionProvider, getSnapshot: () => state,
         subscribe: listener => { if (state.lifecycle === 'disposed')
@@ -295,6 +372,8 @@ export function createFileTreeController({ revisionProvider }) {
             catch (error) {
                 return Promise.reject(error);
             }
+            if (isFolder(path))
+                return Promise.resolve(undefined);
             // A rename or delete started meanwhile waits for this read, so it uses the revision the row learned.
             const reading = (async () => {
                 try {
@@ -320,7 +399,7 @@ export function createFileTreeController({ revisionProvider }) {
             checkedPath(to);
             if (to === path)
                 throw new TypeError('The new name is the current name');
-            return mutate('rename', path, to);
+            return isFolder(path) ? mutateFolder('rename', path, to) : mutate('rename', path, to);
         },
         move: async (path, folder) => {
             checkedPath(path);
@@ -331,9 +410,9 @@ export function createFileTreeController({ revisionProvider }) {
                 throw new TypeError(`${nameOf(path)} is already in that folder`);
             if (folder === path || folder.startsWith(`${path}/`))
                 throw new TypeError('A file cannot move into itself');
-            return mutate('rename', path, to);
+            return isFolder(path) ? mutateFolder('rename', path, to) : mutate('rename', path, to);
         },
-        remove: async (path) => mutate('delete', checkedPath(path)),
+        remove: async (path) => isFolder(checkedPath(path)) ? mutateFolder('delete', path) : mutate('delete', path),
         dismiss: operationId => { if (state.mutations.some(item => item.operationId === operationId && item.state.kind === 'settled'))
             update({ ...state, mutations: state.mutations.filter(item => item.operationId !== operationId) }); },
         history: (path, signal) => { active(); return revisionProvider.history(path, signal ? AbortSignal.any([signal, lifetime.signal]) : lifetime.signal); },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-ui-kit",
-  "version": "0.4.35",
+  "version": "0.4.36",
   "license": "MIT",
   "private": false,
   "type": "module",
@@ -154,7 +154,7 @@
     }
   },
   "peerDependencies": {
-    "@hachej/boring-files": "^0.4.35",
+    "@hachej/boring-files": "^0.4.36",
     "@earendil-works/pi-durable": "~1.4.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",

package/r/agent-target.json

@@ -4,15 +4,15 @@
   "title": "Point and dictate on app data",
   "description": "Tap explicitly marked JSON app context, dictate once and show the same app agent’s native reply without opening chat. Host-controlled presentation; no feedback report or second controller.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-feedback@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-feedback@^0.4.36",
     "@earendil-works/pi-durable@~1.4.0",
     "react@^19.0.0",
     "react-dom@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/app-shell.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/app-shell.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat.json"
   ],
   "files": [
     {

package/r/app-shell.json

@@ -4,22 +4,22 @@
   "title": "App shell: layouts, list/detail and agent layer",
   "description": "AppShell with three layouts. B \"workspace\" puts a ListDetail on a screen (phone: the list, then the detail as a stack step with Back; wide: a 20rem list and the detail side by side, sidebar as an icon rail). C \"chat\" wraps the app's own AgentWorkspace (untouched, passed as the nav item's render; install the pi-app item yourself) in the same sidebar, account menu and header; it takes no shell agent. A \"screen\": one screen at a time, every screen kept mounted. On a phone bottom tabs (at most four; more give three plus a « Plus » sheet) and an avatar button that opens the account sheet; on a wide screen the shadcn sidebar (icon rail, NavUser). One header per screen through useScreenHeader (title, subtitle, back, up to two actions, the rest behind « … »). The account menu holds « Améliorer l'app » (the improve agent), the app's own entries and sign out. AppSheet is the one bottom sheet (one open at a time, Back closes it). It mounts the AgentLayer: one agent's PiChat above the app (phone: a drawer with peek, half and full snap points; wide: a right panel), the improve agent in the same layer, optional push-to-talk and point mode. Also useAgentContext and readAgentContext (the screen on show travels as `context` with each submit) and useBackLayer, the one Back manager. Built on explicitly pinned Base UI drawer and dropdown-menu recipes, plus the sidebar and avatar of the host's own shadcn style.",
   "dependencies": [
-    "@hachej/boring-feedback@^0.4.35",
-    "@hachej/boring-ui-kit@^0.4.35",
+    "@hachej/boring-feedback@^0.4.36",
+    "@hachej/boring-ui-kit@^0.4.36",
     "@base-ui/react@^1.9.0",
     "react@^19.0.0",
     "react-dom@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat-plugins.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat-voice.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/dock.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pm-panel.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/feedback.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat-plugins.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat-voice.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/dock.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pm-panel.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/feedback.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/button.json"
   ],
   "files": [
     {

package/r/board-viewer.json

@@ -4,17 +4,17 @@
   "title": "Board viewer",
   "description": "A board@1 artifact kind for *.board.json. Lazy native tldraw projection of maquette screens, sandboxed HTML mock-ups, goto arrows and notes. Conditional board-file autosave; phone viewing without accidental frame edits. Hosts supply their resource client, asset URLs and license key.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "lucide-react@1.51.0",
     "tldraw@5.5.2"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/maquette-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/mockup-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-artifacts.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/maquette-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/mockup-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-artifacts.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json"
   ],
   "files": [
     {

package/r/button.json

@@ -9,7 +9,7 @@
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json"
   ],
   "files": [
     {

package/r/dock.json

@@ -7,7 +7,7 @@
     "react@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json"
   ],
   "files": [
     {

package/r/documents.json

@@ -4,22 +4,22 @@
   "title": "Documents: the Library, a file and its revisions",
   "description": "The workspace's Library as the list, the chosen file in its viewer and its retained revisions beside it (an older one opens read-only). DocumentSheet opens one document over the app for a host's « Voir la fiche », with an optional « Toutes les fiches ». Every read goes through one revisionProvider binding.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/button.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-artifacts.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-app.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-app-kinds.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/app-shell.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/file-tree.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-frame.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-image.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-pdf.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/button.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-artifacts.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-app.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-app-kinds.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/app-shell.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/file-tree.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-frame.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-image.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-pdf.json"
   ],
   "files": [
     {

package/r/feedback-preview.json

@@ -4,7 +4,7 @@
   "title": "Feedback preview",
   "description": "PreviewBanner: a live, reversible preview of a change in the page (Approve / Discard) over `@hachej/boring-feedback/preview`, whose subagent calls models through a host gateway. Separate from `feedback` so annotation-only apps do not install the model SDK; install `feedback` first (its styles cover the banner).",
   "dependencies": [
-    "@hachej/boring-feedback@^0.4.35",
+    "@hachej/boring-feedback@^0.4.36",
     "@earendil-works/pi-ai@~1.4.0",
     "react@^19.0.0"
   ],

package/r/feedback.json

@@ -4,17 +4,17 @@
   "title": "Feedback",
   "description": "Feedback from the chat composer: one Feedback button starts feedback mode on the application page (hover, click to pin a numbered note, hold ⌥ to use the app, optional voice), and one chip carries the notes to the next message. FeedbackBar, NoteBubble, FeedbackChip with its review, useComposerFeedback for the pi-chat composer, and PickerOverlay styles. Optional, not mounted by default: PointButton, AnnotateSheet, FeedbackList and FeedbackReport. Picking, masking, anchoring and placement stay in @hachej/boring-feedback/page and /ui, so restyling cannot weaken them.",
   "dependencies": [
-    "@hachej/boring-feedback@^0.4.35",
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-feedback@^0.4.36",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "react-dom@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat-voice.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat-voice.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json"
   ],
   "files": [
     {

package/r/file-tree.json

@@ -4,14 +4,14 @@
   "title": "File tree",
   "description": "Browse, search, upload, rename, move, delete and inspect retained versions through one revisionProvider binding. Uses the consumer's shadcn Button, dropdown-menu and dialog with shared version-history rows; Base UI style only.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/version-history.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/version-history.json"
   ],
   "files": [
     {

package/r/highlights.json

@@ -4,13 +4,13 @@
   "title": "Anchored highlights",
   "description": "Exact Markdown highlights and comments in a conditional workspace sidecar.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "react-dom@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/markdown-editor.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/markdown-editor.json"
   ],
   "files": [
     {

package/r/html-viewer.json

@@ -4,13 +4,13 @@
   "title": "HTML source and passive preview",
   "description": "Exact HTML source editing with a reconstructed passive preview and borrowed controller. Browser security qualification remains separate.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "react-dom@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/button.json"
   ],
   "files": [
     {

package/r/looks-viewer.json

@@ -8,8 +8,8 @@
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/mockup-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/mockup-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json"
   ],
   "files": [
     {

package/r/maquette-viewer.json

@@ -8,7 +8,7 @@
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/diagram-viewer.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/diagram-viewer.json"
   ],
   "files": [
     {

package/r/markdown-editor.json

@@ -4,8 +4,8 @@
   "title": "Markdown editor",
   "description": "A host-owned styled wrapper over the concrete borrowed Markdown controller.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
-    "@hachej/boring-files@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
+    "@hachej/boring-files@^0.4.36",
     "react@^19.0.0",
     "react-dom@^19.0.0",
     "marked@^17.0.6",
@@ -24,7 +24,7 @@
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/button.json"
   ],
   "files": [
     {

package/r/mockup-viewer.json

@@ -10,7 +10,7 @@
     "zod@^4.6.5"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-frame.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-frame.json"
   ],
   "files": [
     {

package/r/pi-ambient.json

@@ -4,7 +4,7 @@
   "title": "Pi ambient agent",
   "description": "AmbientChat, a compact floating agent bar that grows into a chat window over an existing page, and AgentNotifications, toasts over the kit's shared chat-react run notifications (with the one guarded browser Notification helper). A block over the pi-chat item; its in-window artifact panel uses the pi-workspace layout.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.35",
+    "@hachej/boring-ui-kit@^0.4.36",
     "react@^19.0.0",
     "react-dom@^19.0.0",
     "@earendil-works/pi-durable@~1.4.0",
@@ -12,13 +12,13 @@
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat-plugins.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-chat-question.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-artifacts.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-workspace.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat-plugins.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-chat-question.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-artifacts.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-workspace.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/button.json"
   ],
   "files": [
     {

package/r/pi-app-kinds.json

@@ -4,16 +4,16 @@
   "title": "Pi agent app default kinds",
   "description": "defaultKinds({ locale, comments }): the artifact kinds the pi-app item draws with by default, in order: maquette, diagram, mock-up and records, then Markdown, HTML, SVG, CSV, image and PDF (documentKinds). Pass it as AgentWorkspace's artifactKinds (or ViewerOptions.kinds), with an app's own kinds before it. Each kind loads its viewer on first open.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/pi-app.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-markdown.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-html.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-image.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-pdf.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/viewer-code.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/maquette-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/diagram-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/mockup-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.35/r/record-viewer.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/pi-app.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-markdown.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-html.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-image.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-pdf.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/viewer-code.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/maquette-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/diagram-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/mockup-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.36/r/record-viewer.json"
   ],
   "files": [
     {