@hachej/boring-ui-kit 0.4.50 → 0.4.52

package/dist/native-chat.d.ts

@@ -86,6 +86,12 @@ export interface NativeChatHistorySource {
     readonly id: Conversation['id'];
     readonly entries: Conversation['entries'];
 }
+/**
+ * Whether entries older than the view's first one exist, when the host says so. A host that sends a slice of the conversation sets
+ * `hasEarlier` on the view it sends (a boolean beside the native fields); without it, a native `head` on a kept entry means earlier entries
+ * exist (a reset or compaction starts the view there). `undefined`: the view does not say.
+ */
+export declare function viewHasEarlier(view: ConversationView | undefined): boolean | undefined;
 export type ChatHistoryState = {
     readonly kind: 'disabled' | 'idle';
 } | {
@@ -195,7 +201,8 @@ export declare function createNativeChatController(options: NativeChatOptions):
     /**
      * Sends the composer draft (or `input`) and empties the composer at once. While another send is still being confirmed the message
      * waits in `outbox` and is submitted, in order, after it. A refused message, and any waiting behind it, go back into the composer
-     * ahead of what was typed since; nothing is dropped or merged into another message. Resolves with the native submission, or
+     * ahead of what was typed since; nothing is dropped or merged into another message. Sent before any view (while connecting), it is
+     * held until the first view arrives and then submitted, in order; if the connection fails first it goes back into the composer. Resolves with the native submission, or
      * undefined when the message was not admitted (refused, unknown, or the controller was disposed).
      */
     send: (whenBusy?: ChatAttempt["whenBusy"], input?: ChatSendInput) => Promise<Submission | undefined>;

package/dist/native-chat.js

@@ -1,5 +1,14 @@
 import { awaitWithContext, withCancel } from '@earendil-works/chord/context';
 import { randomUUID } from '@hachej/boring-files/platform';
+/**
+ * Whether entries older than the view's first one exist, when the host says so. A host that sends a slice of the conversation sets
+ * `hasEarlier` on the view it sends (a boolean beside the native fields); without it, a native `head` on a kept entry means earlier entries
+ * exist (a reset or compaction starts the view there). `undefined`: the view does not say.
+ */
+export function viewHasEarlier(view) {
+    const said = view?.hasEarlier;
+    return typeof said === 'boolean' ? said : undefined;
+}
 function draft(text, attachments, version) {
     if (typeof text !== 'string' || attachments.some(item => typeof item.id !== 'string' || !item.id || typeof item.name !== 'string'
         || item.content.type !== 'image' || typeof item.content.data !== 'string' || typeof item.content.mimeType !== 'string'))
@@ -191,6 +200,17 @@ export function createNativeChatController(options) {
         publish({ send: { kind: 'admitted', attempt, submissionId, ...(record ? { record } : {}) }, ...(found ? { echo: echoView() } : {}) });
         return true;
     };
+    /** Resolves true once a view is there, false if the controller is disposed or its connection fails first. */
+    const viewed = () => snapshot.view ? Promise.resolve(true) : new Promise(resolve => {
+        const check = () => {
+            const failed = snapshot.disposed || snapshot.connection.kind === 'error' || snapshot.connection.kind === 'closed';
+            if (snapshot.view || failed) {
+                listeners.delete(check);
+                resolve(Boolean(snapshot.view) && !snapshot.disposed);
+            }
+        };
+        listeners.add(check);
+    });
     /** Messages taken from the composer that wait for the current send (`outbox` in the snapshot). */
     const waiting = [];
     let sending = false;
@@ -367,15 +387,16 @@ export function createNativeChatController(options) {
             if (previous.kind === 'ready' && !previous.hasMore)
                 return Promise.resolve();
             if (!historyScan) {
-                let maxEntryId;
+                // Earlier means below the view's first entry: the view's own entries are on screen already, so the first page never repeats them.
+                let firstEntryId;
                 for (const entry of snapshot.view?.entries ?? [])
-                    if (maxEntryId === undefined || entry.id > maxEntryId)
-                        maxEntryId = entry.id;
-                if (maxEntryId === undefined) {
+                    if (firstEntryId === undefined || entry.id < firstEntryId)
+                        firstEntryId = entry.id;
+                if (firstEntryId === undefined || firstEntryId <= 0 || viewHasEarlier(snapshot.view) === false) {
                     publish({ history: { kind: 'ready', entries: Object.freeze([]), hasMore: false } });
                     return Promise.resolve();
                 }
-                historyScan = { maxEntryId };
+                historyScan = { maxEntryId: firstEntryId - 1 };
             }
             const scan = historyScan, generation = historyGeneration;
             const entries = 'entries' in previous ? previous.entries : Object.freeze([]);
@@ -445,7 +466,14 @@ export function createNativeChatController(options) {
                     }
                     watch = acquired;
                     const ready = snapshot.timing.inputReady === undefined;
-                    publish({ connection: live(), view: acquired.value, ...(ready ? { timing: Object.freeze({ inputReady: mark('input-ready'), sends: Object.freeze([...timings]) }) } : {}) });
+                    // Messages sent before any view were counted against none; they are held until now (see `send`), so the first view is their baseline.
+                    for (const [index, item] of echoes.entries())
+                        if (item.blind) {
+                            item.blind = false;
+                            firstEntries.set(item.key, acquired.value.entries.length);
+                            item.base = countOf(acquired.value, item.match) + echoes.slice(0, index).filter(other => other.match === item.match).length;
+                        }
+                    publish({ connection: live(), view: acquired.value, ...(snapshot.conversationId !== conversation.id ? { conversationId: conversation.id } : {}), ...(ready ? { timing: Object.freeze({ inputReady: mark('input-ready'), sends: Object.freeze([...timings]) }) } : {}) });
                     acquired.start(async (view) => {
                         if (snapshot.disposed || watch !== acquired)
                             return;
@@ -474,7 +502,8 @@ export function createNativeChatController(options) {
         /**
          * Sends the composer draft (or `input`) and empties the composer at once. While another send is still being confirmed the message
          * waits in `outbox` and is submitted, in order, after it. A refused message, and any waiting behind it, go back into the composer
-         * ahead of what was typed since; nothing is dropped or merged into another message. Resolves with the native submission, or
+         * ahead of what was typed since; nothing is dropped or merged into another message. Sent before any view (while connecting), it is
+         * held until the first view arrives and then submitted, in order; if the connection fails first it goes back into the composer. Resolves with the native submission, or
          * undefined when the message was not admitted (refused, unknown, or the controller was disposed).
          */
         send: async (whenBusy = 'followUp', input) => {
@@ -490,13 +519,15 @@ export function createNativeChatController(options) {
             }
             if (input?.restore)
                 restoreOf.set(selected, draft(input.restore.text, input.restore.attachments ?? [], 0));
+            // Connecting with no view yet: the message is held until the first view (below), which is then its echo's baseline.
+            const held = !snapshot.view && snapshot.connection.kind === 'connecting';
             // The message is the person's from this moment: it is drawn at once (the echo) and the composer is emptied, before any
             // validation or network call. The server's copy replaces it when it arrives; a refusal puts the words back in the composer.
             // (A steer takes a queued message back and sends it again, so it is not echoed twice.)
             if (whenBusy !== 'steer') {
                 const enter = mark('enter');
                 const match = selected.text.trim(), key = `m${++echoSeq}`;
-                echoes.push({ key, draft: selected, match, base: countOf(snapshot.view, match) + echoes.filter(item => item.match === match).length, at: enter, sentAt: Date.now(), failed: false, admitted: false });
+                echoes.push({ key, draft: selected, match, base: countOf(snapshot.view, match) + echoes.filter(item => item.match === match).length, blind: held, at: enter, sentAt: Date.now(), failed: false, admitted: false });
                 firstEntries.set(key, snapshot.view?.entries.length ?? 0);
                 timings.push(Object.freeze({ key, enter }));
                 if (timings.length > 20)
@@ -512,6 +543,12 @@ export function createNativeChatController(options) {
             sending = true;
             publish(cleared);
             try {
+                // Sent while connecting: held (shown as the person's own) until the first view, so nothing is submitted before the connection is up.
+                // If the connection fails first, it and everything behind it go back into the composer, marked not sent.
+                if (held && !await viewed()) {
+                    restore([selected], { send: { kind: 'blocked', reason: 'Not connected: the message was not sent' } });
+                    return;
+                }
                 let next = { draft: selected, whenBusy, resolve: () => { } };
                 const first = await dispatch(next);
                 let result = first;

package/dist/remote-chat.js

@@ -14,6 +14,50 @@ export class SubmissionRefused extends Error {
     code = 'submission-refused';
     constructor(message) { super(message); this.name = 'SubmissionRefused'; }
 }
+/**
+ * A photo the host sends as a link (an image part with a `url`, `data: ''`, so the first view stays small) is handed out with its
+ * `url` resolved against the chat endpoint: a relative link names the endpoint's own route (`?op=image&…`), whatever page the chat is
+ * on. The wire replica stays as sent, so later native operations (a field set, a string append) replay on the host's own values; the
+ * linked copy is derived after each replay. Values are immutable, so a node maps to one linked node for good: unchanged entries keep
+ * their identity and only changed paths are walked again.
+ */
+function imageLinker(base) {
+    const linked = new WeakMap();
+    const link = (node) => {
+        if (!node || typeof node !== 'object')
+            return node;
+        if (linked.has(node))
+            return linked.get(node);
+        let out = node;
+        if (Array.isArray(node)) {
+            const items = node.map(link);
+            if (items.some((item, index) => item !== node[index]))
+                out = items;
+        }
+        else {
+            const record = node;
+            let copy;
+            for (const key of Object.keys(record)) {
+                const value = record[key];
+                const next = key === 'url' && record.type === 'image' && typeof value === 'string' ? resolved(value) : link(value);
+                if (next !== value)
+                    (copy ??= { ...record })[key] = next;
+            }
+            if (copy)
+                out = copy;
+        }
+        linked.set(node, out);
+        return out;
+    };
+    // A link that is not a URL is left as sent: the chat draws a placeholder.
+    const resolved = (url) => { try {
+        return new URL(url, base).href;
+    }
+    catch {
+        return url;
+    } };
+    return (value) => link(value);
+}
 async function reason(response) {
     try {
         const value = await response.json();
@@ -30,6 +74,7 @@ async function reason(response) {
  */
 export async function createRemoteChat(options) {
     const base = new URL(options.endpoint, globalThis.location?.href);
+    const linkImages = imageLinker(base);
     const send = options.fetch, pollMs = options.pollMs ?? 500;
     const backoff = { base: options.reconnect?.baseDelayMs ?? 1000, max: options.reconnect?.maxDelayMs ?? 30_000 };
     const url = (op, extra = {}) => {
@@ -265,7 +310,7 @@ export async function createRemoteChat(options) {
             settle(end);
         } };
         const handle = {
-            get value() { return value; },
+            get value() { return linkImages(value); },
             closed,
             lost: () => lost,
             stop: async () => { finish({ reason: 'stopped' }); return closed; },
@@ -288,7 +333,7 @@ export async function createRemoteChat(options) {
                             // Native operation batches are replayed with the upstream delta implementation; a view frame resets the replica.
                             value = frame.kind === 'view' ? frame.view : applyImmutable(value, frame.ops);
                             try {
-                                await listener(value, [], context);
+                                await listener(linkImages(value), [], context);
                             }
                             catch (error) {
                                 return finish({ reason: 'listener_error', error: error instanceof Error ? error : new Error(String(error)) });
@@ -345,7 +390,8 @@ export async function createRemoteChat(options) {
             cancelRetry();
             setReconnecting(false);
             settle(end);
-            const live = current;
+            // Stopped before it started (the owner left while the first view was on its way, D-1434): the first watch is still open, close it.
+            const live = current ?? (listener ? undefined : first);
             current = undefined;
             void live?.stop();
         };
@@ -478,11 +524,11 @@ export async function createRemoteChat(options) {
         // The controller only reconciles a submission by request ID; no other transaction work crosses the wire.
         commit: async (change, _context) => change({ submissionByRequest: (_conversationId, requestId) => lookup(requestId) }),
         abort: async () => { await post('abort', {}); },
-        entries: async (query, limit, cursor) => (await call('entries', {}, { limit: String(limit),
+        entries: async (query, limit, cursor) => linkImages((await call('entries', {}, { limit: String(limit),
             ...(query.maxEntryId === undefined ? {} : { maxEntryId: String(query.maxEntryId) }),
             ...(query.minEntryId === undefined ? {} : { minEntryId: String(query.minEntryId) }),
             ...(query.order === undefined ? {} : { order: query.order }),
-            ...(cursor === undefined ? {} : { cursor: JSON.stringify(cursor) }) })).page,
+            ...(cursor === undefined ? {} : { cursor: JSON.stringify(cursor) }) })).page),
     };
     const context = BACKGROUND_CONTEXT;
     const close = async () => { const first = unclaimed; unclaimed = undefined; await first?.stop(); };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-ui-kit",
-  "version": "0.4.50",
+  "version": "0.4.52",
   "license": "MIT",
   "private": false,
   "type": "module",
@@ -154,7 +154,7 @@
     }
   },
   "peerDependencies": {
-    "@hachej/boring-files": "^0.4.50",
+    "@hachej/boring-files": "^0.4.52",
     "@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.50",
-    "@hachej/boring-feedback@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-feedback@^0.4.52",
     "@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.50/r/app-shell.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-chat.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/app-shell.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat.json"
   ],
   "files": [
     {

package/r/app-shell.json

@@ -4,21 +4,21 @@
   "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.50",
-    "@hachej/boring-ui-kit@^0.4.50",
+    "@hachej/boring-feedback@^0.4.52",
+    "@hachej/boring-ui-kit@^0.4.52",
     "@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.50/r/pi-chat.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-chat-plugins.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-chat-voice.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/dock.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/feedback.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat-plugins.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat-voice.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/dock.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/feedback.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/button.json"
   ],
   "files": [
     {
@@ -59,7 +59,7 @@
     },
     {
       "path": "registry/app-shell/app-shell.tsx",
-      "content": "'use client';\n\n// The app shell. Layout A (`screen`): one screen at a time. Compact: bottom tabs (at most four; more give three plus « Plus »), or with `compactNav=\"sheet\"` no bar and the sidebar as a sheet from the header. Expanded:\n// the shadcn sidebar (icon rail plus NavUser). Layout B (`workspace`): the same, with a screen made of a `ListDetail`; the sidebar starts\n// as the icon rail because the list pane is the wide navigation. Layout C (`chat`): the one nav item renders the app's `AgentWorkspace`,\n// untouched, below the same sidebar, account menu and header; there is no shell agent (the page is the chat). The shell imports nothing from pi-app: a layout C app installs the `pi-app` item itself. One header per screen\n// (`useScreenHeader`). The AgentLayer is mounted once, here.\n// Host concern: Pi has no layout; the screen on show travels as the agent's context (useAgentContext -> createPromptContext).\nimport { useEffect, useState, useSyncExternalStore } from 'react';\nimport { afterStacksBack } from '../utils/back';\nimport type { ReactNode } from 'react';\nimport { SidebarProvider } from '@/components/ui/sidebar';\nimport { Button } from '@/components/ui/button';\nimport { AccountAvatar, AccountChoices } from './account';\nimport type { AccountSpec } from './account';\nimport { AgentDockLayout, AgentLayer, AgentLayerProvider } from './agent-layer';\nimport type { AgentSpec } from './agent-layer';\nimport { NoPanelLayout } from './shell-panel';\nimport type { ShellPanel } from './shell-panel';\nimport { ScreenActiveContext, useAgentContext } from './agent-context';\nimport { useIsCompact } from './compact';\nimport { HeaderProvider, ScreenHeader } from './header';\nimport { AppSidebar, TabBar } from './nav';\nimport type { NavItem } from './nav';\nimport { AppSheet } from './app-sheet';\nimport { appShellText } from './text';\nimport { ScreenHeaderSlotContext } from '../utils/screen-header-slot';\nimport type { AppShellLocale, AppShellText } from './text';\n\nexport interface AppShellProps {\n  /** A `screen` (tabs), B `workspace` (list and detail), C `chat` (the app's `AgentWorkspace`; no `agent`). */\n  readonly layout: 'screen' | 'workspace' | 'chat';\n  readonly title: string;\n  readonly nav: readonly NavItem[];\n  /** Wide-screen navigation: `hover` reveals labels over the page on hover or keyboard focus. Default: `icon` (the native sidebar toggle). */\n  readonly rail?: 'icon' | 'hover';\n  /** Phone navigation: `tabs` (default) is the bottom tab bar; `sheet` has no bar, the header's leading button opens the sidebar (the nav items, a screen's `sidebar` content and the account) as a sheet. */\n  readonly compactNav?: 'tabs' | 'sheet';\n  readonly agent?: AgentSpec;\n  /** Consume agent/open/input launch parameters on mount (default). `false` leaves the URL and layer untouched. */\n  readonly agentLink?: false;\n  /** A panel beside the app, opened from the account menu. The product manager is `pmPanel` from the Factory's `platform-ui/pm-panel`. */\n  readonly panel?: ShellPanel;\n  readonly account?: AccountSpec;\n  /** The language of the shell's own words and the layer's (« Se déconnecter », « Plus », « Ouvrir l’assistant »…). The agent's `chatProps.locale` wins when it sets one; else this; else English. */\n  readonly locale?: AppShellLocale;\n  /** The app's router owns the URL; the shell only reports the choice. */\n  readonly route: { readonly id: string; readonly onChange: (id: string) => void };\n  /**\n   * `false`: no backdrop blur behind dialogs, sheets and drawers (blurring the page costs frames on slow phones), only their dim.\n   * Default `true`. Overlays live in a portal, so the shell marks `<html data-overlay-blur=\"off\">` while it is mounted; the app's\n   * own CSS drops the blur there (the rule is in registry/README.md: an item's CSS stays inside `.app-shell`).\n   */\n  readonly overlayBlur?: boolean;\n}\n\n/** `<html data-overlay-blur=\"off\">` while a shell asks for it. */\nfunction useOverlayBlur(blur: boolean) {\n  useEffect(() => {\n    if (blur || typeof document === 'undefined') return;\n    const root = document.documentElement;\n    root.dataset.overlayBlur = 'off';\n    return () => { delete root.dataset.overlayBlur; };\n  }, [blur]);\n}\n\n/** Registers what is on show for the agent. A screen's own `useAgentContext` is mounted later and wins. */\nfunction ShellContext({ name }: { readonly name: string }): null {\n  useAgentContext({ name, params: {} });\n  return null;\n}\n\nfunction ScreenBody({ item }: { readonly item: NavItem }): ReactNode { return item.render(); }\n\n/** Every screen stays mounted; the ones not on show are `hidden` and do not register a header or a context. */\nfunction Screens({ items, activeId, scrolls, slot }: { readonly items: readonly NavItem[]; readonly activeId: string; readonly scrolls: boolean; readonly slot: HTMLElement | null }) {\n  return <div className=\"relative min-h-0 flex-1\">\n    {items.map(item => <ScreenActiveContext.Provider key={item.id} value={item.id === activeId}><ScreenHeaderSlotContext.Provider value={item.id === activeId ? slot : null}>\n      <div hidden={item.id !== activeId} data-testid={`screen-${item.id}`} className={scrolls ? 'h-full overflow-y-auto overscroll-contain' : 'h-full overflow-hidden'}><ScreenBody item={item} /></div>\n    </ScreenHeaderSlotContext.Provider></ScreenActiveContext.Provider>)}\n  </div>;\n}\n\nfunction Shell({ compactNav, layout, rail, title, nav, agent, panel, account, route, text }: { readonly compactNav: NonNullable<AppShellProps['compactNav']>; readonly rail: NonNullable<AppShellProps['rail']>; readonly layout: AppShellProps['layout']; readonly title: string; readonly nav: readonly NavItem[]; readonly agent: AgentSpec | undefined; readonly panel: ShellPanel | undefined; readonly account: AccountSpec | undefined; readonly route: AppShellProps['route']; readonly text: AppShellText }) {\n  const improve = panel ? panel.label ?? text.improve : undefined;\n  const Layout = panel?.Layout ?? NoPanelLayout;\n  const compact = useIsCompact();\n  const sheet = compact && compactNav === 'sheet';\n  const [accountOpen, setAccountOpen] = useState(false);\n  // The header's slot for the screen on show (an embedded AgentWorkspace puts its bar's controls there).\n  const [slot, setSlot] = useState<HTMLElement | null>(null);\n  const active = nav.find(item => item.id === route.id) ?? nav[0];\n  if (!active) return null;\n  // A nav choice waits for an open detail's stack entry to go back, so the app's router can replace the URL without that Back restoring\n  // the detail's. Choosing the screen already on show changes nothing and keeps the detail.\n  const choose = (id: string) => { if (id === active.id) route.onChange(id); else afterStacksBack(() => route.onChange(id)); };\n  const hasAccount = Boolean(account) || improve;\n  const avatar = hasAccount ? <>\n    <Button variant=\"ghost\" size=\"icon\" data-testid=\"account-button\" aria-label={account?.name ?? text.account} title={account?.name ?? text.account} onClick={() => setAccountOpen(true)}><AccountAvatar account={account} /></Button>\n    <AppSheet open={accountOpen} onOpenChange={setAccountOpen} title={text.account}>\n      <AccountChoices account={account} improve={improve} text={text} done={() => setAccountOpen(false)} />\n    </AppSheet>\n  </> : null;\n  // The structure is the same compact or expanded, so a resize never remounts a screen.\n  return <SidebarProvider data-testid=\"app-shell\" defaultOpen={rail !== 'hover' && layout === 'screen'} className=\"app-shell h-dvh min-h-0 overflow-hidden\">\n    {(!compact || sheet) && <AppSidebar rail={sheet ? 'icon' : rail} title={title} items={nav} activeId={active.id} onChange={choose} agent={agent} account={account} improve={improve} text={text} />}\n    <AgentDockLayout>\n      <div data-slot=\"sidebar-inset\" className=\"relative flex min-h-0 min-w-0 w-full flex-1 flex-col overflow-hidden bg-background\">\n      <Layout screen={active.label} navigation={compact && !sheet ? <TabBar items={nav} activeId={active.id} onChange={choose} text={text} /> : undefined}>\n        <ShellContext name={active.label} />\n        <ScreenHeader fallbackTitle={active.label} compact={compact} avatar={avatar} menu={sheet} text={text} slotRef={setSlot} />\n        <Screens items={nav} activeId={active.id} scrolls={layout === 'screen'} slot={slot} />\n      </Layout>\n      </div>\n    </AgentDockLayout>\n    <AgentLayer />\n  </SidebarProvider>;\n}\n\nconst never = () => () => {};\n\nexport function AppShell(props: AppShellProps) {\n  const { layout, rail = 'icon', compactNav = 'tabs', agent, panel, title, nav, account, route } = props;\n  if (layout === 'chat' && agent) throw new Error('AppShell layout \"chat\" takes no `agent`: the page is the chat (use `panel` for the product manager)');\n  const text = appShellText(agent?.chatProps?.locale ?? (panel?.locale as AppShellLocale | undefined) ?? props.locale);\n  useOverlayBlur(props.overlayBlur ?? true);\n  const alone = useSyncExternalStore(never, () => panel?.page?.matches() ?? false, () => false);\n  if (alone && panel?.page) return <panel.page.Page config={panel.config} appName={title} locale={props.locale} />;\n  return <AgentLayerProvider agent={agent} panel={panel} locale={props.locale} agentLink={props.agentLink} appName={props.title}>\n    <HeaderProvider><Shell compactNav={compactNav} layout={layout} rail={rail} title={title} nav={nav} agent={agent} account={account} route={route} panel={panel} text={text} /></HeaderProvider>\n  </AgentLayerProvider>;\n}\n",
+      "content": "'use client';\n\n// The app shell. Layout A (`screen`): one screen at a time. Compact: bottom tabs (at most four; more give three plus « Plus »), or with `compactNav=\"sheet\"` no bar and the sidebar as a sheet from the header. Expanded:\n// the shadcn sidebar (icon rail plus NavUser). Layout B (`workspace`): the same, with a screen made of a `ListDetail`; the sidebar starts\n// as the icon rail because the list pane is the wide navigation. Layout C (`chat`): the one nav item renders the app's `AgentWorkspace`,\n// untouched, below the same sidebar, account menu and header; there is no shell agent (the page is the chat). The shell imports nothing from pi-app: a layout C app installs the `pi-app` item itself. One header per screen\n// (`useScreenHeader`). The AgentLayer is mounted once, here.\n// Host concern: Pi has no layout; the screen on show travels as the agent's context (useAgentContext -> createPromptContext).\nimport { useEffect, useState, useSyncExternalStore } from 'react';\nimport { afterStacksBack } from '../utils/back';\nimport type { ReactNode } from 'react';\nimport { SidebarProvider } from '@/components/ui/sidebar';\nimport { Button } from '@/components/ui/button';\nimport { AccountAvatar, AccountChoices } from './account';\nimport type { AccountSpec } from './account';\nimport { AgentDockLayout, AgentLayer, AgentLayerProvider } from './agent-layer';\nimport type { AgentSpec } from './agent-layer';\nimport { NoPanelLayout } from './shell-panel';\nimport type { ShellPanel } from './shell-panel';\nimport { ScreenActiveContext, useAgentContext } from './agent-context';\nimport { useIsCompact } from './compact';\nimport { HeaderProvider, ScreenHeader } from './header';\nimport { AppSidebar, TabBar } from './nav';\nimport type { NavItem } from './nav';\nimport { AppSheet } from './app-sheet';\nimport { appShellText } from './text';\nimport { ScreenHeaderSlotContext } from '../utils/screen-header-slot';\nimport type { AppShellLocale, AppShellText } from './text';\n\nexport interface AppShellProps {\n  /** A `screen` (tabs), B `workspace` (list and detail), C `chat` (the app's `AgentWorkspace`; no `agent`). */\n  readonly layout: 'screen' | 'workspace' | 'chat';\n  readonly title: string;\n  readonly nav: readonly NavItem[];\n  /** Wide-screen navigation: `hover` reveals labels over the page on hover or keyboard focus. Default: `icon` (the native sidebar toggle). */\n  readonly rail?: 'icon' | 'hover';\n  /** Phone navigation: `tabs` (default) is the bottom tab bar; `sheet` has no bar, the header's leading button opens the sidebar (the nav items, a screen's `sidebar` content and the account) as a sheet. */\n  readonly compactNav?: 'tabs' | 'sheet';\n  readonly agent?: AgentSpec;\n  /** Consume agent/open/input launch parameters on mount (default). `false` leaves the URL and layer untouched. */\n  readonly agentLink?: false;\n  /** A panel beside the app, opened from the account menu. The product manager is `pmPanel` from the Factory's `platform-ui/pm-panel`. */\n  readonly panel?: ShellPanel;\n  readonly account?: AccountSpec;\n  /** The language of the shell's own words and the layer's (« Se déconnecter », « Plus », « Ouvrir l’assistant »…). The agent's `chatProps.locale` wins when it sets one; else this; else English. */\n  readonly locale?: AppShellLocale;\n  /** The app's router owns the URL; the shell only reports the choice. */\n  readonly route: { readonly id: string; readonly onChange: (id: string) => void };\n  /**\n   * `false`: no backdrop blur behind dialogs, sheets and drawers (blurring the page costs frames on slow phones), only their dim.\n   * Default `true`. Overlays live in a portal, so the shell marks `<html data-overlay-blur=\"off\">` while it is mounted; the app's\n   * own CSS drops the blur there (the rule is in registry/README.md: an item's CSS stays inside `.app-shell`).\n   */\n  readonly overlayBlur?: boolean;\n}\n\n/** `<html data-overlay-blur=\"off\">` while a shell asks for it. */\nfunction useOverlayBlur(blur: boolean) {\n  useEffect(() => {\n    if (blur || typeof document === 'undefined') return;\n    const root = document.documentElement;\n    root.dataset.overlayBlur = 'off';\n    return () => { delete root.dataset.overlayBlur; };\n  }, [blur]);\n}\n\n/** Registers what is on show for the agent. A screen's own `useAgentContext` is mounted later and wins. */\nfunction ShellContext({ name }: { readonly name: string }): null {\n  useAgentContext({ name, params: {} });\n  return null;\n}\n\nfunction ScreenBody({ item }: { readonly item: NavItem }): ReactNode { return item.render(); }\n\n/** Every screen stays mounted; the ones not on show are `hidden` and do not register a header or a context. */\nfunction Screens({ items, activeId, scrolls, slot }: { readonly items: readonly NavItem[]; readonly activeId: string; readonly scrolls: boolean; readonly slot: HTMLElement | null }) {\n  return <div className=\"relative min-h-0 flex-1\">\n    {items.map(item => <ScreenActiveContext.Provider key={item.id} value={item.id === activeId}><ScreenHeaderSlotContext.Provider value={item.id === activeId ? slot : null}>\n      <div hidden={item.id !== activeId} data-testid={`screen-${item.id}`} className={scrolls ? 'h-full overflow-y-auto overscroll-contain' : 'h-full overflow-hidden'}><ScreenBody item={item} /></div>\n    </ScreenHeaderSlotContext.Provider></ScreenActiveContext.Provider>)}\n  </div>;\n}\n\nfunction Shell({ compactNav, layout, rail, title, nav, agent, panel, account, route, text }: { readonly compactNav: NonNullable<AppShellProps['compactNav']>; readonly rail: NonNullable<AppShellProps['rail']>; readonly layout: AppShellProps['layout']; readonly title: string; readonly nav: readonly NavItem[]; readonly agent: AgentSpec | undefined; readonly panel: ShellPanel | undefined; readonly account: AccountSpec | undefined; readonly route: AppShellProps['route']; readonly text: AppShellText }) {\n  const improve = panel && panel.menu !== false ? panel.label ?? text.improve : undefined;\n  const Layout = panel?.Layout ?? NoPanelLayout;\n  const compact = useIsCompact();\n  const sheet = compact && compactNav === 'sheet';\n  const [accountOpen, setAccountOpen] = useState(false);\n  // The header's slot for the screen on show (an embedded AgentWorkspace puts its bar's controls there).\n  const [slot, setSlot] = useState<HTMLElement | null>(null);\n  const active = nav.find(item => item.id === route.id) ?? nav[0];\n  if (!active) return null;\n  // A nav choice waits for an open detail's stack entry to go back, so the app's router can replace the URL without that Back restoring\n  // the detail's. Choosing the screen already on show changes nothing and keeps the detail.\n  const choose = (id: string) => { if (id === active.id) route.onChange(id); else afterStacksBack(() => route.onChange(id)); };\n  const hasAccount = Boolean(account) || improve;\n  const avatar = hasAccount ? <>\n    <Button variant=\"ghost\" size=\"icon\" data-testid=\"account-button\" aria-label={account?.name ?? text.account} title={account?.name ?? text.account} onClick={() => setAccountOpen(true)}><AccountAvatar account={account} /></Button>\n    <AppSheet open={accountOpen} onOpenChange={setAccountOpen} title={text.account}>\n      <AccountChoices account={account} improve={improve} text={text} done={() => setAccountOpen(false)} />\n    </AppSheet>\n  </> : null;\n  // The structure is the same compact or expanded, so a resize never remounts a screen.\n  return <SidebarProvider data-testid=\"app-shell\" defaultOpen={rail !== 'hover' && layout === 'screen'} className=\"app-shell h-dvh min-h-0 overflow-hidden\">\n    {(!compact || sheet) && <AppSidebar rail={sheet ? 'icon' : rail} title={title} items={nav} activeId={active.id} onChange={choose} agent={agent} account={account} improve={improve} text={text} />}\n    <AgentDockLayout>\n      <div data-slot=\"sidebar-inset\" className=\"relative flex min-h-0 min-w-0 w-full flex-1 flex-col overflow-hidden bg-background\">\n      <Layout screen={active.label} navigation={compact && !sheet ? <TabBar items={nav} activeId={active.id} onChange={choose} text={text} /> : undefined}>\n        <ShellContext name={active.label} />\n        <ScreenHeader fallbackTitle={active.label} compact={compact} avatar={avatar} menu={sheet} text={text} slotRef={setSlot} />\n        <Screens items={nav} activeId={active.id} scrolls={layout === 'screen'} slot={slot} />\n      </Layout>\n      </div>\n    </AgentDockLayout>\n    <AgentLayer />\n  </SidebarProvider>;\n}\n\nconst never = () => () => {};\n\nexport function AppShell(props: AppShellProps) {\n  const { layout, rail = 'icon', compactNav = 'tabs', agent, panel, title, nav, account, route } = props;\n  if (layout === 'chat' && agent) throw new Error('AppShell layout \"chat\" takes no `agent`: the page is the chat (use `panel` for the product manager)');\n  const text = appShellText(agent?.chatProps?.locale ?? (panel?.locale as AppShellLocale | undefined) ?? props.locale);\n  useOverlayBlur(props.overlayBlur ?? true);\n  const alone = useSyncExternalStore(never, () => panel?.page?.matches() ?? false, () => false);\n  if (alone && panel?.page) return <panel.page.Page config={panel.config} appName={title} locale={props.locale} />;\n  return <AgentLayerProvider agent={agent} panel={panel} locale={props.locale} agentLink={props.agentLink} appName={props.title}>\n    <HeaderProvider><Shell compactNav={compactNav} layout={layout} rail={rail} title={title} nav={nav} agent={agent} account={account} route={route} panel={panel} text={text} /></HeaderProvider>\n  </AgentLayerProvider>;\n}\n",
       "type": "registry:component",
       "target": "components/app-shell/app-shell.tsx"
     },
@@ -107,7 +107,7 @@
     },
     {
       "path": "registry/app-shell/shell-panel.tsx",
-      "content": "'use client';\n\n// The shell's panel place: a second agent or tool beside the app, opened from the account menu. The shell knows only this shape, so an app\n// plugs in what it wants (the product manager is `pmPanel` from the Factory's `platform-ui/pm-panel`) and an app without one installs nothing more.\nimport type { ComponentType, ReactNode } from 'react';\n\nexport interface ShellPanelProviderProps {\n  /** `ShellPanel.config`, as the panel wrote it. */\n  readonly config: unknown;\n  readonly open: boolean;\n  readonly close: () => void;\n  readonly appName?: string | undefined;\n  readonly locale?: string | undefined;\n  /** The panel took the whole screen, or gave it back; `collapse` is what Back runs. */\n  readonly onFull?: ((full: boolean, collapse: () => void) => void) | undefined;\n  readonly children: ReactNode;\n}\n\nexport interface ShellPanelLayoutProps {\n  readonly children: ReactNode;\n  /** The phone tab bar. The layout hides it while the panel covers the page. */\n  readonly navigation?: ReactNode;\n  /** The label of the screen on show. */\n  readonly screen?: string;\n}\n\nexport interface ShellPanelPageProps {\n  readonly config: unknown;\n  readonly appName: string;\n  readonly locale?: string | undefined;\n}\n\n/** Keep `Provider`, `Layout` and `page.Page` the same across renders: a new component remounts the app. */\nexport interface ShellPanel {\n  /** Passed back to `Provider` and `page.Page`. */\n  readonly config: unknown;\n  /** Wraps the whole shell, so the panel's state outlives its closing. */\n  readonly Provider: ComponentType<ShellPanelProviderProps>;\n  /** Wraps the screen and draws the panel beside it. */\n  readonly Layout: ComponentType<ShellPanelLayoutProps>;\n  /** The account menu's row and the layer's title. Default: the shell's « Améliorer l'app ». */\n  readonly label?: string;\n  /** The panel's language, for the shell's own words when the app has no agent to say it. */\n  readonly locale?: string | undefined;\n  /** Changes when the panel's conversation changes; a launch link's focus waits on it. */\n  readonly identity?: unknown;\n  /** The address that shows only the panel, without the shell. */\n  readonly page?: { readonly matches: () => boolean; readonly Page: ComponentType<ShellPanelPageProps> };\n}\n\n/** The screen when the app has no panel. */\nexport function NoPanelLayout({ children, navigation }: ShellPanelLayoutProps) {\n  return <div className=\"relative flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden\">\n    <div className=\"flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden\">{children}</div>\n    <div className=\"shrink-0 md:hidden\">{navigation}</div>\n  </div>;\n}\n",
+      "content": "'use client';\n\n// The shell's panel place: a second agent or tool beside the app, opened from the account menu. The shell knows only this shape, so an app\n// plugs in what it wants (the product manager is `pmPanel` from the Factory's `platform-ui/pm-panel`) and an app without one installs nothing more.\nimport type { ComponentType, ReactNode } from 'react';\n\nexport interface ShellPanelProviderProps {\n  /** `ShellPanel.config`, as the panel wrote it. */\n  readonly config: unknown;\n  readonly open: boolean;\n  readonly close: () => void;\n  readonly appName?: string | undefined;\n  readonly locale?: string | undefined;\n  /** The panel took the whole screen, or gave it back; `collapse` is what Back runs. */\n  readonly onFull?: ((full: boolean, collapse: () => void) => void) | undefined;\n  readonly children: ReactNode;\n}\n\nexport interface ShellPanelLayoutProps {\n  readonly children: ReactNode;\n  /** The phone tab bar. The layout hides it while the panel covers the page. */\n  readonly navigation?: ReactNode;\n  /** The label of the screen on show. */\n  readonly screen?: string;\n}\n\nexport interface ShellPanelPageProps {\n  readonly config: unknown;\n  readonly appName: string;\n  readonly locale?: string | undefined;\n}\n\n/** Keep `Provider`, `Layout` and `page.Page` the same across renders: a new component remounts the app. */\nexport interface ShellPanel {\n  /** Passed back to `Provider` and `page.Page`. */\n  readonly config: unknown;\n  /** Wraps the whole shell, so the panel's state outlives its closing. */\n  readonly Provider: ComponentType<ShellPanelProviderProps>;\n  /** Wraps the screen and draws the panel beside it. */\n  readonly Layout: ComponentType<ShellPanelLayoutProps>;\n  /** The account menu's row and the layer's title. Default: the shell's « Améliorer l'app ». */\n  readonly label?: string;\n  /** `false`: no account menu row for the panel, which still mounts (a host that already shows the panel, around a framed app). Default: the row. */\n  readonly menu?: false;\n  /** The panel's language, for the shell's own words when the app has no agent to say it. */\n  readonly locale?: string | undefined;\n  /** Changes when the panel's conversation changes; a launch link's focus waits on it. */\n  readonly identity?: unknown;\n  /** The address that shows only the panel, without the shell. */\n  readonly page?: { readonly matches: () => boolean; readonly Page: ComponentType<ShellPanelPageProps> };\n}\n\n/** The screen when the app has no panel. */\nexport function NoPanelLayout({ children, navigation }: ShellPanelLayoutProps) {\n  return <div className=\"relative flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden\">\n    <div className=\"flex min-h-0 min-w-0 flex-1 flex-col overflow-hidden\">{children}</div>\n    <div className=\"shrink-0 md:hidden\">{navigation}</div>\n  </div>;\n}\n",
       "type": "registry:component",
       "target": "components/app-shell/shell-panel.tsx"
     },

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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "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.50/r/maquette-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/mockup-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-artifacts.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/maquette-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/mockup-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-artifacts.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "react@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/button.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-artifacts.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-app.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-app-kinds.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/app-shell.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/file-tree.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/viewer-frame.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/viewer-image.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/viewer-pdf.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/button.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-artifacts.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-app.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-app-kinds.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/app-shell.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/file-tree.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/viewer-frame.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/viewer-image.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/viewer-pdf.json"
   ],
   "files": [
     {

package/r/drawing-viewer.json

@@ -4,7 +4,7 @@
   "title": "Drawing viewer",
   "description": "DrawingViewer, drawingKind and describeDrawing: an Excalidraw (.excalidraw) or draw.io (.drawio) file, read-only, drawn by the tool's own renderer on a white page fitted to the shapes: Excalidraw's exportToSvg (its fonts served by the app, never its CDN) and the official diagrams.net viewer, vendored in the kit (@hachej/boring-ui-kit/drawio-viewer), in a sandboxed frame without network. Shown as an image, so nothing in the file runs; an unreadable file shows an inline error. onRead hands the shapes and arrows the renderer read (kind, place, size, label, colours, from and to). Each renderer loads the first time a drawing of its format opens; the kind is not in the pi-app-kinds default list, so apps without drawings install nothing.",
   "dependencies": [
-    "@hachej/boring-ui-kit@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
     "react@^19.0.0",
     "lucide-react@^1.51.0",
     "@excalidraw/excalidraw@0.18.1"

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.50",
-    "@hachej/boring-ui-kit@^0.4.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-feedback@^0.4.52",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "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.50/r/pi-chat.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/pi-chat-voice.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/pi-chat-voice.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "react@^19.0.0",
     "lucide-react@^1.51.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/version-history.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/utils.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "react@^19.0.0",
     "react-dom@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/markdown-editor.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "react@^19.0.0",
     "react-dom@^19.0.0"
   ],
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50/r/mockup-viewer.json",
-    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.50/r/utils.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/mockup-viewer.json",
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50/r/diagram-viewer.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50",
-    "@hachej/boring-files@^0.4.50",
+    "@hachej/boring-ui-kit@^0.4.52",
+    "@hachej/boring-files@^0.4.52",
     "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.50/r/button.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/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.50/r/viewer-frame.json"
+    "https://cdn.jsdelivr.net/npm/@hachej/boring-ui-kit@0.4.52/r/viewer-frame.json"
   ],
   "files": [
     {