chore: format main

Author: gingerhendrix

docs/store-conventions.md

@@ -6,19 +6,19 @@ built on `@xstate/store`, with thin React adapters on top. This note records
 when to reach for a store, where store code lives, and how it is tested.
 
 Rule of thumb: **transition logic moves into store events; IO stays at the
-boundary.** An effect that only *repairs state after render* is a store
+boundary.** An effect that only _repairs state after render_ is a store
 transition in disguise. An effect that talks to a renderer, timer, stream, or
 process is doing its job.
 
 ## When to use what
 
-| Situation | Use |
-|---|---|
-| Synchronous state updated by named events; cross-component; needs subscription/selectors (registry, surface stack, overlay stack, nav/search, sequence display) | `@xstate/store` |
-| Async lifecycles with real states and cancellable work (content loader) | `@xstate/store` + request-ids first; full `xstate` only if a written justification shows the statechart pays for itself |
-| Component-local input state that never crosses a component boundary (a filter query local to one overlay, a focus flag) | React `useState` |
-| Purely derived render data | `useMemo`/selectors — never an effect, never a store |
-| Imperative OpenTUI ref sync, subscriptions, timers, async IO | effects (or store-adjacent wrappers) — these are legitimate external synchronization and stay effects |
+| Situation                                                                                                                                                       | Use                                                                                                                     |
+| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| Synchronous state updated by named events; cross-component; needs subscription/selectors (registry, surface stack, overlay stack, nav/search, sequence display) | `@xstate/store`                                                                                                         |
+| Async lifecycles with real states and cancellable work (content loader)                                                                                         | `@xstate/store` + request-ids first; full `xstate` only if a written justification shows the statechart pays for itself |
+| Component-local input state that never crosses a component boundary (a filter query local to one overlay, a focus flag)                                         | React `useState`                                                                                                        |
+| Purely derived render data                                                                                                                                      | `useMemo`/selectors — never an effect, never a store                                                                    |
+| Imperative OpenTUI ref sync, subscriptions, timers, async IO                                                                                                    | effects (or store-adjacent wrappers) — these are legitimate external synchronization and stay effects                   |
 
 ## File layout
 

examples/mouse-choose.ts

@@ -20,8 +20,18 @@
 import { launch, createStaticProvider, type ChooseItem } from "@tooee/choose"
 
 const frameworks: ChooseItem[] = [
-  { text: "OpenTUI", value: "opentui", icon: "\u{1F5A5}", description: "Zig-native terminal renderer" },
-  { text: "React", value: "react", icon: "\u{269B}", description: "Declarative UI via the reconciler" },
+  {
+    text: "OpenTUI",
+    value: "opentui",
+    icon: "\u{1F5A5}",
+    description: "Zig-native terminal renderer",
+  },
+  {
+    text: "React",
+    value: "react",
+    icon: "\u{269B}",
+    description: "Declarative UI via the reconciler",
+  },
   { text: "Solid", value: "solid", icon: "\u{1F9F1}", description: "Fine-grained reactivity" },
   { text: "Bun", value: "bun", icon: "\u{1F35E}", description: "Fast all-in-one runtime" },
   { text: "TypeScript", value: "typescript", icon: "\u{1F4D8}", description: "Typed JavaScript" },

packages/choose/test/ChooseOverlay.mouse.test.tsx

@@ -34,10 +34,7 @@ function lineOf(frame: string, text: string): { x: number; y: number } {
   return { x: -1, y: -1 }
 }
 
-async function setup(opts: {
-  onSelect?: (item: ChooseItem) => void
-  onCancel?: () => void
-}) {
+async function setup(opts: { onSelect?: (item: ChooseItem) => void; onCancel?: () => void }) {
   const s = await testRender(
     <TooeeProvider initialMode="insert">
       <ChooseOverlay

packages/commands/package.json

@@ -35,6 +35,10 @@
   "scripts": {
     "typecheck": "tsc --noEmit"
   },
+  "dependencies": {
+    "@xstate/store": "^4",
+    "@xstate/store-react": "^2"
+  },
   "devDependencies": {
     "@opentui/core": "^0.2.15",
     "@opentui/react": "^0.2.15",
@@ -46,9 +50,5 @@
     "@opentui/core": "^0.2.15",
     "@opentui/react": "^0.2.15",
     "react": "^18.0.0 || ^19.0.0"
-  },
-  "dependencies": {
-    "@xstate/store": "^4",
-    "@xstate/store-react": "^2"
   }
 }

packages/commands/src/context.tsx

@@ -254,10 +254,7 @@ export function CommandSurfaceProvider({
 
   // Surface-local mode changes are transitions too (F-08): a mid-chord mode
   // switch on a modal surface resets the pending sequence.
-  const handleModeChange = useCallback(
-    () => commandStore.modeChanged(id),
-    [commandStore, id],
-  )
+  const handleModeChange = useCallback(() => commandStore.modeChanged(id), [commandStore, id])
 
   return (
     <ModeProvider initialMode={initialMode} onModeChange={handleModeChange}>

packages/commands/src/parse.ts

@@ -69,7 +69,9 @@ export function parseHotkey(hotkey: string, leaderKey?: string): ParsedHotkey {
     if (!leaderKey) {
       // No leader configured: the hotkey must not spring to life on some
       // invented default. Zero steps = unmatchable; the dispatcher skips it.
-      warnOnce(`[tooee/commands] Hotkey "${trimmed}" uses <leader> but no leader key is configured; the hotkey is disabled.`)
+      warnOnce(
+        `[tooee/commands] Hotkey "${trimmed}" uses <leader> but no leader key is configured; the hotkey is disabled.`,
+      )
       return { steps: [] }
     }
     const leaderStep = parseStep(leaderKey)

packages/commands/test/command-store.test.ts

@@ -156,12 +156,8 @@ describe("command store — registration", () => {
     const registry = cs.registryFor(surface)
     const seen: Mode[] = []
     let blocked = 0
-    registry.register(
-      command("go", "g", { handler: (ctx) => seen.push(ctx.mode) }),
-    )
-    registry.register(
-      command("no", "n", { when: () => false, handler: () => blocked++ }),
-    )
+    registry.register(command("go", "g", { handler: (ctx) => seen.push(ctx.mode) }))
+    registry.register(command("no", "n", { when: () => false, handler: () => blocked++ }))
 
     registry.invoke("go")
     registry.invoke("no")

packages/commands/test/registry.test.tsx

@@ -1,12 +1,7 @@
 import { testRender } from "../../../test/support/test-render.ts"
 import { test, expect, afterEach, describe } from "bun:test"
 import { act, useState } from "react"
-import {
-  CommandProvider,
-  useCommand,
-  useCommandGroup,
-  useCommandRegistry,
-} from "../src/index.js"
+import { CommandProvider, useCommand, useCommandGroup, useCommandRegistry } from "../src/index.js"
 import type { RegisteredCommandGroup } from "../src/index.js"
 
 type TestSession = Awaited<ReturnType<typeof testRender>>

packages/commands/test/store-integration.test.tsx

@@ -238,7 +238,12 @@ describe("F-13: surface command metadata", () => {
   test("useActiveCommandSurface().commands lists the modal surface's commands reactively", async () => {
     function ActiveProbe() {
       const active = useActiveCommandSurface()
-      const ids = active ? active.commands.map((c) => c.id).sort().join(",") : "none"
+      const ids = active
+        ? active.commands
+            .map((c) => c.id)
+            .sort()
+            .join(",")
+        : "none"
       return <text content={`active-commands:[${ids}]`} />
     }
 
@@ -279,7 +284,10 @@ describe("F-13: surface command metadata", () => {
   test("useSurfaceCommands defaults to the active surface and falls back to root", async () => {
     function SurfaceCommandsProbe() {
       const commands = useSurfaceCommands()
-      const ids = commands.map((c) => c.id).sort().join(",")
+      const ids = commands
+        .map((c) => c.id)
+        .sort()
+        .join(",")
       return <text content={`surface-commands:[${ids}]`} />
     }
 

packages/commands/test/surface.test.tsx

@@ -228,7 +228,12 @@ describe("command surface arbitration", () => {
       const [surfaceAction, setSurfaceAction] = useState(0)
       const active = useActiveCommandSurface()
 
-      useCommand({ id: "root.open", title: "Open", hotkey: "o", handler: () => setShowSurface(true) })
+      useCommand({
+        id: "root.open",
+        title: "Open",
+        hotkey: "o",
+        handler: () => setShowSurface(true),
+      })
 
       useKeyboard((key) => {
         if (key.name === "z") setUnguarded((n) => n + 1)