@schlessera/brain-ui-react 0.35.0 → 0.37.0

package/dist/connection.js

@@ -0,0 +1,421 @@
+import { BrainUiClient } from "@schlessera/brain-ui-sdk/client";
+import { activeChat } from "./stores/chat-state.js";
+import { dispatchServerMessage } from "./hooks/websocket-handlers/index.js";
+import { runStateForFrame } from "./hooks/websocket-handlers/chat.js";
+import { REFUSAL_ATTEMPTS } from "./components/connectivity/connection-state.js";
+/** Every callback and mutable queue belongs to the root supplied here. */
+export function createWebSocketClient(root) {
+    let disposed = false;
+    let generation = 0;
+    let owners = 0;
+    let removeListeners;
+    /**
+     * Does this frame announce the identity of the conversation THIS client just
+     * started?
+     *
+     * The old test was `session_info || result` for any unknown session, which
+     * adopted whichever arrived first — an older background turn finishing, or
+     * another client's new session, would capture the user's draft and bind it to
+     * a transcript they never wrote. `draftId` is minted per draft turn and echoed
+     * on `session_info`, so a match is proof.
+     *
+     * A server too old to echo it sends no `draftId`, and the pre-existing
+     * behaviour applies rather than the draft never binding at all: correctness
+     * where the information exists, compatibility where it does not.
+     */
+    function isOurDraftAnnouncement(state, msg) {
+        // A terminal result has no draft correlation. Another client's turn may
+        // finish before our session_info arrives, so it can never claim our draft.
+        if (msg.type !== "session_info")
+            return false;
+        const pending = state.pendingDraftId;
+        if (msg.draftId)
+            return msg.draftId === pending;
+        // No echo to compare against.
+        return true;
+    }
+    /**
+     * Lazily open a session-scoped activity subscription (live subagent rows,
+     * server-stamped tool timing). Idempotent per connection; the subscribed set
+     * resets when a new socket's server_hello arrives.
+     */
+    function ensureActivitySubscription(sessionId) {
+        if (!sessionId)
+            return;
+        const activity = root.stores.activity.getState();
+        if (!activity.supported || activity.subscribed[sessionId])
+            return;
+        activity.markSubscribed(sessionId);
+        wsClient?.send({ type: "activity_subscribe", view: "session", sessionId });
+        // The subscription snapshot carries OPEN runs; finished runs (history
+        // timing, past fan-outs) come from the REST side.
+        void root.stores.activity.loadSessionActivityHistory(sessionId);
+    }
+    const pendingDeltas = new Map();
+    let flushScheduled = false;
+    let frameId;
+    /**
+     * Apply every buffered delta, in arrival order, and clear the buffer.
+     *
+     * Exported so tests can force the frame rather than wait for one; production
+     * code never needs to call it, because every path that reads the transcript
+     * flushes first.
+     */
+    function flushChatDeltas() {
+        flushDeltas();
+    }
+    function flushDeltas() {
+        if (frameId !== undefined && typeof cancelAnimationFrame === "function")
+            cancelAnimationFrame(frameId);
+        frameId = undefined;
+        flushScheduled = false;
+        if (pendingDeltas.size === 0)
+            return;
+        const batches = [...pendingDeltas.entries()];
+        pendingDeltas.clear();
+        const state = root.stores.chat.getState();
+        for (const [key, chunks] of batches) {
+            for (const chunk of chunks) {
+                if (chunk.kind === "text")
+                    state.appendText(key, chunk.text);
+                else
+                    state.appendThinking(key, chunk.text);
+            }
+        }
+    }
+    function enqueueDelta(key, kind, text) {
+        const chunks = pendingDeltas.get(key);
+        if (!chunks) {
+            pendingDeltas.set(key, [{ kind, text }]);
+        }
+        else {
+            const last = chunks[chunks.length - 1];
+            if (last.kind === kind)
+                last.text += text;
+            else
+                chunks.push({ kind, text });
+        }
+        // Outside a browser (unit tests, SSR) there is no frame to wait for, so apply
+        // straight away and keep the handler's behaviour synchronous.
+        if (typeof requestAnimationFrame !== "function") {
+            flushDeltas();
+            return;
+        }
+        if (!flushScheduled) {
+            flushScheduled = true;
+            frameId = requestAnimationFrame(flushDeltas);
+        }
+    }
+    function handleServerMessage(msg) {
+        if (disposed)
+            return;
+        // Every frame that is not itself a delta must see the transcript fully
+        // applied: the demux below reads buffer state, and the store records parts in
+        // arrival order, so a tool call landing ahead of buffered text would reorder
+        // the message.
+        if (msg.type !== "text_delta" && msg.type !== "thinking_delta")
+            flushDeltas();
+        const state = root.stores.chat.getState();
+        // Activity stream frames feed their own store and never touch chat state.
+        if (msg.type === "server_hello" ||
+            msg.type === "activity_snapshot" ||
+            msg.type === "activity_delta") {
+            const key = state.activeSessionId;
+            dispatchServerMessage(msg, {
+                stores: root.stores,
+                state,
+                frameSessionId: undefined,
+                frameTurnId: undefined,
+                key,
+                buffer: () => (key === null ? state.draft : state.buffers[key]),
+                enqueueDelta,
+                ensureActivitySubscription,
+                requestBrowserLocation,
+                resyncIfNeeded,
+                coldResumeIfNeeded,
+                markHistoryReplaced,
+            });
+            return;
+        }
+        // Parallel-session demux (per-session buffers). Every frame is scoped by
+        // sessionId; a scoped frame lands in ITS session's buffer, so a background
+        // session's transcript keeps accumulating while another one is in view.
+        // Frames without a sessionId (legacy single-session servers, or a new
+        // session's pre-binding frames) apply to the buffer in view.
+        const frameSessionId = msg.sessionId;
+        if (frameSessionId) {
+            // `detail` on a queued status is the host's queue-pressure note; it rides
+            // along so the session's badge can show WHY it is queued deep.
+            const queueNote = msg.type === "status" && msg.status === "queued" ? msg.detail : undefined;
+            // `message_blocks` arrives AFTER the turn's result (D42); it must not
+            // reopen a finished session, and it must not touch a queued follow-up
+            // that may already be running, so it takes no part in run state.
+            if (msg.type !== "message_blocks") {
+                state.setRunState(frameSessionId, runStateForFrame(msg), queueNote);
+            }
+        }
+        // Resolve the target buffer key for this frame.
+        let key;
+        if (!frameSessionId) {
+            key = state.activeSessionId; // null = the draft view
+        }
+        else if (state.buffers[frameSessionId]) {
+            key = frameSessionId;
+        }
+        else if (state.draft && isOurDraftAnnouncement(state, msg)) {
+            // A draft run just got its server identity: adopt the draft buffer.
+            state.bindDraftSession(frameSessionId);
+            key = frameSessionId;
+        }
+        else if (msg.type === "session_info" && frameSessionId === state.activeSessionId) {
+            // The ACTIVE session announced itself but has no buffer yet — the cold
+            // reattach case (PWA relaunch mid-turn; the server may skip the history
+            // frame when a first turn has no history yet). Materialize the buffer so
+            // this session_info and every following delta land instead of vanishing.
+            state.setActiveSession(frameSessionId);
+            key = frameSessionId;
+        }
+        else if (msg.type === "session_history") {
+            // History replay may create a buffer (cold resume / reattach).
+            key = frameSessionId;
+        }
+        else {
+            // Scoped frame for a session with no buffer (never opened, or evicted):
+            // the badge above is all we track. The transcript heals via
+            // session_resume when the user opens it.
+            return;
+        }
+        const buffer = () => {
+            const s = root.stores.chat.getState();
+            return key === null ? s.draft : s.buffers[key];
+        };
+        dispatchServerMessage(msg, {
+            stores: root.stores,
+            state,
+            frameSessionId,
+            frameTurnId: msg.turnId,
+            key,
+            buffer,
+            enqueueDelta,
+            ensureActivitySubscription,
+            requestBrowserLocation,
+            resyncIfNeeded,
+            coldResumeIfNeeded,
+            markHistoryReplaced,
+        });
+    }
+    /**
+     * The server asked the browser for its location (the agent called
+     * `get_current_location`). Read `navigator.geolocation` and reply over the same
+     * requestId. The browser shows its own permission prompt on first use; a denial,
+     * timeout, or unavailable position comes back as a `location_error` that the
+     * server turns into a tool error for the agent.
+     */
+    function requestBrowserLocation(msg) {
+        const client = wsClient;
+        const requestedGeneration = generation;
+        const requestedSocket = root.stores.connection.getState().socketOpens;
+        const reply = (message) => {
+            if (!disposed && requestedGeneration === generation && requestedSocket === root.stores.connection.getState().socketOpens && client === wsClient)
+                client?.send(message);
+        };
+        const { requestId } = msg;
+        if (typeof navigator === "undefined" || !navigator.geolocation) {
+            reply({
+                type: "location_error",
+                requestId,
+                code: 0,
+                message: "Geolocation is not available in this browser.",
+            });
+            return;
+        }
+        const opts = msg.options ?? {};
+        navigator.geolocation.getCurrentPosition((pos) => {
+            reply({
+                type: "location_response",
+                requestId,
+                coords: {
+                    latitude: pos.coords.latitude,
+                    longitude: pos.coords.longitude,
+                    accuracy: pos.coords.accuracy,
+                    altitude: pos.coords.altitude,
+                    altitudeAccuracy: pos.coords.altitudeAccuracy,
+                    heading: pos.coords.heading,
+                    speed: pos.coords.speed,
+                },
+                timestamp: pos.timestamp,
+            });
+        }, (err) => {
+            reply({
+                type: "location_error",
+                requestId,
+                code: err.code,
+                message: err.message || "Failed to retrieve location.",
+            });
+        }, {
+            enableHighAccuracy: opts.enableHighAccuracy ?? false,
+            timeout: opts.timeoutMs ?? 15000,
+            maximumAge: opts.maximumAgeMs ?? 60000,
+        });
+    }
+    // Reconnection bookkeeping: after a WS drop, the rendered transcript may have
+    // gaps (deltas streamed while offline are lost). We heal by replaying the
+    // authoritative session history — immediately if nothing is streaming, or
+    // once the in-flight turn settles (result / idle status). The pending resync
+    // is keyed to the session that needs healing (the one that was active at the
+    // reconnect), so a background session settling first cannot consume it.
+    let wasDisconnected = false;
+    let resyncSessionId = null;
+    function handleSocketClose(close) {
+        const connection = root.stores.connection.getState();
+        connection.recordWsClose(close.opened, close.code);
+        if (!close.opened &&
+            root.stores.connection.getState().handshakeFailures >= REFUSAL_ATTEMPTS) {
+            root.recheckVpn?.();
+        }
+    }
+    function resyncIfNeeded(sessionId) {
+        if (!resyncSessionId || !sessionId || sessionId !== resyncSessionId)
+            return;
+        resyncSessionId = null;
+        wsClient?.send({ type: "session_resume", sessionId });
+    }
+    // A cold page / PWA relaunch restores only the stored session id, not the
+    // transcript. The server pushes a snapshot on connect only while a session is
+    // actively running; when it's idle (the common "agent finished while the phone
+    // slept" case) nothing arrives, so the client must fetch the finished
+    // session's history itself. Guarded to fire at most once per session id per
+    // connection — an empty session would otherwise re-trigger on every idle
+    // status and loop.
+    let coldResumedSessionId = null;
+    function markHistoryReplaced(key) {
+        if (key !== null && key === resyncSessionId)
+            resyncSessionId = null;
+        coldResumedSessionId = key;
+    }
+    function coldResumeIfNeeded(sessionId, messageCount) {
+        if (!sessionId || messageCount > 0)
+            return;
+        if (coldResumedSessionId === sessionId)
+            return;
+        coldResumedSessionId = sessionId;
+        wsClient?.send({ type: "session_resume", sessionId });
+    }
+    function handleStatusChange(status) {
+        root.stores.connection.getState().setWsStatus(status);
+        if (status === "connected") {
+            root.stores.connection.getState().noteSocketOpen();
+        }
+        // A status change can be followed by a history replay that rewrites the
+        // buffer, so land whatever is still buffered before anything reads it. In a
+        // hidden tab requestAnimationFrame does not run at all, which is exactly the
+        // case where deltas could otherwise sit unapplied across a reconnect.
+        flushDeltas();
+        if (status === "disconnected") {
+            wasDisconnected = true;
+            // Allow a fresh cold-resume attempt after we reconnect.
+            coldResumedSessionId = null;
+        }
+        else if (status === "connected" && wasDisconnected) {
+            wasDisconnected = false;
+            const chat = root.stores.chat.getState();
+            const active = activeChat(chat);
+            if (chat.activeSessionId && active.messages.length > 0) {
+                resyncSessionId = chat.activeSessionId;
+                // Not mid-stream: replay right away. Mid-stream: the flag holds until
+                // the running turn finishes (result or idle status).
+                if (!active.isStreaming) {
+                    resyncIfNeeded(chat.activeSessionId);
+                }
+            }
+        }
+    }
+    let wsClient = null;
+    function sendClientMessage(msg) {
+        if (!wsClient)
+            return false;
+        if (root.stores.connection.getState().wsStatus !== "connected")
+            return false;
+        return wsClient.send(msg);
+    }
+    /** Retry this root's socket, skipping any remaining backoff. */
+    function reconnectWebSocketNow() {
+        wsClient?.reconnectNow();
+    }
+    /** Acquire a connection lease. Several consumers may share one root safely. */
+    function connect() {
+        if (disposed)
+            throw new Error("Cannot connect a disposed UI root");
+        owners++;
+        if (!wsClient) {
+            const connectedGeneration = ++generation;
+            const current = () => !disposed && connectedGeneration === generation;
+            root.stores.connection.getState().noteSocketOpen();
+            const client = new BrainUiClient({
+                url: root.wsUrl(),
+                handlers: { onAny: (message) => { if (current())
+                        handleServerMessage(message); } },
+                onStatusChange: (status) => { if (current())
+                    handleStatusChange(status); },
+                onClose: (close) => { if (current())
+                    handleSocketClose(close); },
+                onProtocolError: (err) => {
+                    if (!current())
+                        return;
+                    root.stores.connection.getState().reportError("PROTOCOL_ERROR", err.frameType ? `Dropped a ${err.frameType} frame: ${err.detail}` : `Dropped an unreadable frame: ${err.detail}`);
+                },
+            });
+            wsClient = client;
+            client.connect();
+            const reconnectNow = () => { if (current())
+                client.reconnectNow(); };
+            const onVisible = () => { if (document.visibilityState === "visible")
+                reconnectNow(); };
+            if (typeof window !== "undefined")
+                window.addEventListener("online", reconnectNow);
+            if (typeof document !== "undefined")
+                document.addEventListener("visibilitychange", onVisible);
+            removeListeners = () => {
+                if (typeof window !== "undefined")
+                    window.removeEventListener("online", reconnectNow);
+                if (typeof document !== "undefined")
+                    document.removeEventListener("visibilitychange", onVisible);
+            };
+        }
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            if (--owners === 0)
+                disconnect();
+        };
+    }
+    function disconnect() {
+        generation++;
+        removeListeners?.();
+        removeListeners = undefined;
+        const client = wsClient;
+        wsClient = null;
+        client?.close();
+        handleStatusChange("disconnected");
+        root.stores.activity.getState().setSupported(false);
+        root.stores.activity.getState().resetSubscriptions();
+    }
+    return {
+        connect,
+        send: sendClientMessage,
+        reconnectNow: reconnectWebSocketNow,
+        handleServerMessage,
+        flushChatDeltas,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            disconnect();
+            resyncSessionId = null;
+            coldResumedSessionId = null;
+        },
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/default-root.d.ts

@@ -0,0 +1,3 @@
+/** The single application root used by existing shells without a provider. */
+export declare const defaultRoot: import("./root.js").BrainUiRoot;
+//# sourceMappingURL=default-root.d.ts.map

package/dist/default-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-root.d.ts","sourceRoot":"","sources":["../src/default-root.ts"],"names":[],"mappings":"AAKA,8EAA8E;AAC9E,eAAO,MAAM,WAAW,iCAA0G,CAAC"}

package/dist/default-root.js

@@ -0,0 +1,16 @@
+import { defaultToolRendererRegistry, defaultAsrClientRegistry } from "@schlessera/brain-ui-sdk/client";
+import { uiConfig, registerDevHandle } from "./config.js";
+import { api } from "./lib/api-client.js";
+import { createRoot } from "./root.js";
+/** The single application root used by existing shells without a provider. */
+export const defaultRoot = createRoot({ storagePrefix: "", api }, uiConfig, defaultToolRendererRegistry, defaultAsrClientRegistry);
+registerDevHandle(() => {
+    if (typeof window === "undefined")
+        return;
+    Object.assign(window, {
+        __chatStore: defaultRoot.stores.chat,
+        __graphStore: defaultRoot.stores.graph,
+        __activityStore: defaultRoot.stores.activity,
+    });
+});
+//# sourceMappingURL=default-root.js.map

package/dist/default-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-root.js","sourceRoot":"","sources":["../src/default-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACxG,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE,wBAAwB,CAAC,CAAC;AAEnI,iBAAiB,CAAC,GAAG,EAAE;IACrB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI;QACpC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK;QACtC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ;KAC7C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/use-color-scheme.d.ts

@@ -0,0 +1,14 @@
+import { type ColorScheme } from "../lib/light-dark.js";
+/**
+ * The scheme the page is drawing in — `light` or `dark` — for the parts of
+ * the app that read a token as a value rather than referencing it (the graph
+ * canvas, the diagram theme). Everything else lets `light-dark()` decide.
+ *
+ * Follows the store's preference and, under `system`, the OS: both are
+ * subscribed, and the answer is re-read from the root's computed
+ * `color-scheme` after `useApplyTheme` has written the attribute, so a host
+ * that sets `data-theme` itself is honoured too. The initial value is read
+ * synchronously, so the first paint after a stored preference is right.
+ */
+export declare function useColorScheme(): ColorScheme;
+//# sourceMappingURL=use-color-scheme.d.ts.map

package/dist/hooks/use-color-scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-color-scheme.d.ts","sourceRoot":"","sources":["../../src/hooks/use-color-scheme.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAc5C"}

package/dist/hooks/use-color-scheme.js

@@ -0,0 +1,37 @@
+import { useEffect, useState } from "react";
+import { useUIStore } from "../stores/ui-store.js";
+import { useMediaQuery } from "./use-media-query.js";
+import { documentColorScheme } from "../lib/light-dark.js";
+/**
+ * The scheme the page is drawing in — `light` or `dark` — for the parts of
+ * the app that read a token as a value rather than referencing it (the graph
+ * canvas, the diagram theme). Everything else lets `light-dark()` decide.
+ *
+ * Follows the store's preference and, under `system`, the OS: both are
+ * subscribed, and the answer is re-read from the root's computed
+ * `color-scheme` after `useApplyTheme` has written the attribute, so a host
+ * that sets `data-theme` itself is honoured too. The initial value is read
+ * synchronously, so the first paint after a stored preference is right.
+ */
+export function useColorScheme() {
+    const preference = useUIStore((s) => s.theme);
+    const osDark = useMediaQuery("(prefers-color-scheme: dark)");
+    const [scheme, setScheme] = useState(() => expected(preference, osDark));
+    useEffect(() => {
+        // `useApplyTheme` writes `data-theme` in the app root's effect, which runs
+        // after this one; the store says what it will write, and the document is
+        // re-read on the next frame in case a host wrote something else.
+        setScheme(expected(preference, osDark));
+        if (typeof requestAnimationFrame !== "function")
+            return;
+        const frame = requestAnimationFrame(() => setScheme(documentColorScheme()));
+        return () => cancelAnimationFrame(frame);
+    }, [preference, osDark]);
+    return scheme;
+}
+function expected(preference, osDark) {
+    if (preference === "system")
+        return osDark ? "dark" : "light";
+    return preference;
+}
+//# sourceMappingURL=use-color-scheme.js.map

package/dist/hooks/use-color-scheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-color-scheme.js","sourceRoot":"","sources":["../../src/hooks/use-color-scheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;IAC7D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAc,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,SAAS,CAAC,GAAG,EAAE;QACb,2EAA2E;QAC3E,yEAAyE;QACzE,iEAAiE;QACjE,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,IAAI,OAAO,qBAAqB,KAAK,UAAU;YAAE,OAAO;QACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,UAAuC,EAAE,MAAe;IACxE,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9D,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/hooks/use-fine-pointer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether any pointer is fine: the display heuristic chosen in #86 for
+ * shortcut hints on touch devices. This does not detect a keyboard. A paired
+ * mouse or trackpad updates the query live; a keyboard alone does not, so a
+ * tablet with a keyboard but no trackpad prints none of these hints — ruled acceptable,
+ * with the platform fact behind it (no media query reports a keyboard), in
+ * the D36 addendum of docs/decisions/design-kit.md.
+ * Only printed hints follow this signal. Bindings remain active either way.
+ * Without matchMedia (SSR or a test DOM), preserve the existing hints.
+ */
+export declare function useFinePointer(): boolean;
+//# sourceMappingURL=use-fine-pointer.d.ts.map

package/dist/hooks/use-fine-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fine-pointer.d.ts","sourceRoot":"","sources":["../../src/hooks/use-fine-pointer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}

package/dist/hooks/use-fine-pointer.js

@@ -0,0 +1,15 @@
+import { useMediaQuery } from "./use-media-query.js";
+/**
+ * Whether any pointer is fine: the display heuristic chosen in #86 for
+ * shortcut hints on touch devices. This does not detect a keyboard. A paired
+ * mouse or trackpad updates the query live; a keyboard alone does not, so a
+ * tablet with a keyboard but no trackpad prints none of these hints — ruled acceptable,
+ * with the platform fact behind it (no media query reports a keyboard), in
+ * the D36 addendum of docs/decisions/design-kit.md.
+ * Only printed hints follow this signal. Bindings remain active either way.
+ * Without matchMedia (SSR or a test DOM), preserve the existing hints.
+ */
+export function useFinePointer() {
+    return useMediaQuery("(any-pointer: fine)", true);
+}
+//# sourceMappingURL=use-fine-pointer.js.map

package/dist/hooks/use-fine-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-fine-pointer.js","sourceRoot":"","sources":["../../src/hooks/use-fine-pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/hooks/use-hash-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-hash-routes.d.ts","sourceRoot":"","sources":["../../src/hooks/use-hash-routes.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAqEpC"}
+{"version":3,"file":"use-hash-routes.d.ts","sourceRoot":"","sources":["../../src/hooks/use-hash-routes.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAsEpC"}

package/dist/hooks/use-hash-routes.js

@@ -1,3 +1,4 @@
+import { useBrainUiRoot } from "../root-context.js";
 import { useEffect, useRef, useState } from "react";
 import { useFileStore } from "../stores/file-store.js";
 import { useUIStore } from "../stores/ui-store.js";
@@ -21,6 +22,7 @@ function viewForHash(hash) {
  * stores.
  */
 export function useHashRoutes() {
+    const root = useBrainUiRoot();
     const [hash, setHash] = useState(() => window.location.hash);
     const syncingFromHash = useRef(false);
     const activeView = useUIStore((state) => state.activeView);
@@ -65,11 +67,11 @@ export function useHashRoutes() {
         // below never runs and never clears the flag. It would then swallow the
         // NEXT store-driven change, leaving the URL pointing at Activity while the
         // app shows Chat, and a refresh would jump back.
-        if (useUIStore.getState().activeView === view)
+        if (root.stores.ui.getState().activeView === view)
             return;
         syncingFromHash.current = true;
         setActiveView(view);
-    }, [hash, setActiveView]);
+    }, [hash, setActiveView, root]);
     useEffect(() => {
         // A hash-driven store write and this effect are flushed together. Skip
         // the stale pre-write render so it cannot rewrite the incoming hash.

package/dist/hooks/use-hash-routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-hash-routes.js","sourceRoot":"","sources":["../../src/hooks/use-hash-routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-hash-routes.js","sourceRoot":"","sources":["../../src/hooks/use-hash-routes.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-media-query.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether a media query matches, kept current as the window changes. Reads
+ * `fallback` where there is no `matchMedia` — the server, and the test DOM.
+ * It defaults to `false`, so a component that branches on a width query
+ * renders its mobile shape there; a capability query that must fail open
+ * passes `true` (see `useFinePointer`).
+ */
+export declare function useMediaQuery(query: string, fallback?: boolean): boolean;
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/hooks/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-media-query.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAgBtE"}