@neurocode-ai/tui 1.18.8

package/test/fixture/tui-sdk.ts

@@ -0,0 +1,109 @@
+import type { GlobalEvent } from "@neurocode-ai/sdk/v2"
+import type { EventSource } from "../../src/context/sdk"
+
+export const worktree = "/tmp/opencode"
+export const directory = `${worktree}/packages/tui`
+
+export function json(data: unknown, init?: ResponseInit) {
+  return new Response(JSON.stringify(data), {
+    ...init,
+    headers: { "content-type": "application/json", ...(init?.headers ?? {}) },
+  })
+}
+
+export function eventSource(): EventSource {
+  return { subscribe: async () => () => {} }
+}
+
+export function createEventSource() {
+  let fn: ((event: GlobalEvent) => void) | undefined
+  let stream: ReadableStreamDefaultController<Uint8Array> | undefined
+  const pending: Uint8Array[] = []
+  return {
+    source: {
+      subscribe: async (handler: (event: GlobalEvent) => void) => {
+        fn = handler
+        return () => {
+          if (fn === handler) fn = undefined
+        }
+      },
+    } satisfies EventSource,
+    emit(event: GlobalEvent) {
+      if (!fn) throw new Error("event source not ready")
+      fn(event)
+      if (!("properties" in event.payload)) return
+      const chunk = new TextEncoder().encode(
+        `data: ${JSON.stringify({
+          ...event.payload,
+          location: { directory: event.directory, workspaceID: event.workspace },
+          data: event.payload.properties,
+        })}\n\n`,
+      )
+      if (stream) return stream.enqueue(chunk)
+      pending.push(chunk)
+    },
+    response() {
+      return new Response(
+        new ReadableStream<Uint8Array>({
+          start(controller) {
+            stream = controller
+            for (const chunk of pending.splice(0)) controller.enqueue(chunk)
+          },
+          cancel() {
+            stream = undefined
+          },
+        }),
+        { headers: { "content-type": "text/event-stream" } },
+      )
+    },
+  }
+}
+
+export type FetchHandler = (url: URL) => Response | Promise<Response> | undefined
+
+export function createFetch(override?: FetchHandler, events?: ReturnType<typeof createEventSource>) {
+  const session = [] as URL[]
+  const fetch = (async (input: RequestInfo | URL) => {
+    const url = new URL(input instanceof Request ? input.url : String(input))
+    if (url.pathname === "/session") session.push(url)
+    const overridden = await override?.(url)
+    if (overridden) return overridden
+    if (url.pathname === "/api/event" && events) return events.response()
+
+    if (
+      [
+        "/agent",
+        "/command",
+        "/experimental/workspace",
+        "/experimental/workspace/status",
+        "/formatter",
+        "/lsp",
+      ].includes(url.pathname)
+    )
+      return json([])
+    if (["/config", "/experimental/resource", "/mcp", "/provider/auth", "/session/status"].includes(url.pathname))
+      return json({})
+    if (url.pathname === "/config/providers") return json({ providers: {}, default: {} })
+    if (url.pathname === "/experimental/console") return json({ consoleManagedProviders: [], switchableOrgCount: 0 })
+    if (url.pathname === "/experimental/capabilities") return json({ backgroundSubagents: false })
+    if (url.pathname === "/path") return json({ home: "", state: "", config: "", worktree, directory })
+    if (url.pathname === "/api/location") return json({ directory, project: { id: "proj_test", directory: worktree } })
+    if (
+      ["/api/agent", "/api/model", "/api/provider", "/api/integration", "/api/command", "/api/skill"].includes(
+        url.pathname,
+      )
+    )
+      return json({
+        location: { directory, project: { id: "proj_test", directory: worktree } },
+        data: [],
+      })
+    if (url.pathname === "/project/current") return json({ id: "proj_test" })
+    if (url.pathname === "/api/reference")
+      return json({ location: { directory, project: { id: "proj_test", directory } }, data: [] })
+    if (url.pathname === "/provider") return json({ all: [], default: {}, connected: [] })
+    if (url.pathname === "/session") return json([])
+    if (url.pathname === "/vcs") return json({ branch: "main" })
+    throw new Error(`unexpected request: ${url.pathname}`)
+  }) as typeof globalThis.fetch
+  return { fetch, session }
+}

package/test/index.test.tsx

@@ -0,0 +1,6 @@
+import { expect, test } from "bun:test"
+import { run } from "../src"
+
+test("exports the canonical application lifecycle", () => {
+  expect(typeof run).toBe("function")
+})

package/test/keymap.test.tsx

@@ -0,0 +1,141 @@
+/** @jsxImportSource @opentui/solid */
+import { createDefaultOpenTuiKeymap } from "@opentui/keymap/opentui"
+import { createBindingLookup } from "@opentui/keymap/extras"
+import { testRender, useRenderer } from "@opentui/solid"
+import { expect, test } from "bun:test"
+import { onCleanup } from "solid-js"
+import { TuiKeybind } from "../src/config/keybind"
+import { getOpencodeModeStack, NEUROCODE_BASE_MODE, OpencodeKeymapProvider, registerOpencodeKeymap } from "../src/keymap"
+
+function createResolvedKeymapConfig(input: TuiKeybind.KeybindOverrides = {}) {
+  const keybinds = TuiKeybind.parse(input)
+  return {
+    keybinds: createBindingLookup(TuiKeybind.toBindingConfig(keybinds), {
+      commandMap: TuiKeybind.CommandMap,
+      bindingDefaults: TuiKeybind.bindingDefaults(),
+    }),
+    leader_timeout: 2000,
+  }
+}
+
+test("legacy page key aliases compile as page keys", async () => {
+  const sequences: Record<string, string[][]> = {}
+
+  function Harness() {
+    const renderer = useRenderer()
+    const keymap = createDefaultOpenTuiKeymap(renderer)
+    const config = createResolvedKeymapConfig({
+      messages_page_up: "pgup",
+      messages_page_down: "pgdown",
+    })
+    const offKeymap = registerOpencodeKeymap(keymap, renderer, config)
+    const offLayer = keymap.registerLayer({
+      bindings: config.keybinds.gather("session", ["session.page.up", "session.page.down"]),
+    })
+    const bindings = keymap.getCommandBindings({
+      visibility: "registered",
+      commands: ["session.page.up", "session.page.down"],
+    })
+    sequences.up =
+      bindings.get("session.page.up")?.map((binding) => binding.sequence.map((part) => part.stroke.name)) ?? []
+    sequences.down =
+      bindings.get("session.page.down")?.map((binding) => binding.sequence.map((part) => part.stroke.name)) ?? []
+    onCleanup(() => {
+      offLayer()
+      offKeymap()
+    })
+
+    return (
+      <OpencodeKeymapProvider keymap={keymap}>
+        <box />
+      </OpencodeKeymapProvider>
+    )
+  }
+
+  const app = await testRender(() => <Harness />)
+  try {
+    expect(sequences).toEqual({
+      up: [["pageup"]],
+      down: [["pagedown"]],
+    })
+  } finally {
+    app.renderer.destroy()
+  }
+})
+
+test("mode-less bindings stay active when opencode mode changes", async () => {
+  const counts: Record<string, Record<string, number>> = {}
+
+  function Harness() {
+    const renderer = useRenderer()
+    const keymap = createDefaultOpenTuiKeymap(renderer)
+    const config = createResolvedKeymapConfig()
+    const offKeymap = registerOpencodeKeymap(keymap, renderer, config)
+    const offGlobal = keymap.registerLayer({
+      commands: [
+        { name: "session.list", run() {} },
+        { name: "session.new", run() {} },
+        { name: "session.page.up", run() {} },
+        { name: "session.first", run() {} },
+      ],
+      bindings: config.keybinds.gather("test.global", [
+        "session.list",
+        "session.new",
+        "session.page.up",
+        "session.first",
+      ]),
+    })
+    const offBase = keymap.registerLayer({
+      mode: NEUROCODE_BASE_MODE,
+      commands: [{ name: "model.list", run() {} }],
+      bindings: config.keybinds.gather("test.base", ["model.list"]),
+    })
+    const activeCounts = () =>
+      Object.fromEntries(
+        Array.from(
+          keymap.getCommandBindings({
+            visibility: "active",
+            commands: ["session.list", "session.new", "session.page.up", "session.first", "model.list"],
+          }),
+          ([command, bindings]) => [command, bindings.length],
+        ),
+      )
+
+    counts.base = activeCounts()
+    const popQuestion = getOpencodeModeStack(keymap).push("question")
+    counts.question = activeCounts()
+    popQuestion()
+    const popAutocomplete = getOpencodeModeStack(keymap).push("autocomplete")
+    counts.autocomplete = activeCounts()
+    popAutocomplete()
+
+    onCleanup(() => {
+      offBase()
+      offGlobal()
+      offKeymap()
+    })
+
+    return (
+      <OpencodeKeymapProvider keymap={keymap}>
+        <box />
+      </OpencodeKeymapProvider>
+    )
+  }
+
+  const app = await testRender(() => <Harness />)
+  try {
+    expect(counts).toEqual({
+      base: { "session.list": 1, "session.new": 1, "session.page.up": 2, "session.first": 2, "model.list": 1 },
+      question: { "session.list": 1, "session.new": 1, "session.page.up": 2, "session.first": 2, "model.list": 0 },
+      autocomplete: {
+        "session.list": 1,
+        "session.new": 1,
+        "session.page.up": 2,
+        "session.first": 2,
+        "model.list": 0,
+      },
+    })
+  } finally {
+    app.renderer.destroy()
+  }
+})

package/test/plugin/runtime.test.ts

@@ -0,0 +1,50 @@
+import { expect, test } from "bun:test"
+import { createPluginRuntime } from "../../src/plugin/runtime"
+
+test("routes use the latest registration and restore previous registrations", () => {
+  const runtime = createPluginRuntime()
+  const first = () => "first"
+  const second = () => "second"
+  runtime.routes.register([{ name: "demo", render: first }])
+  const dispose = runtime.routes.register([{ name: "demo", render: second }])
+
+  expect(runtime.routes.get("demo")).toBe(second)
+  dispose()
+  expect(runtime.routes.get("demo")).toBe(first)
+})
+
+test("facade publishes and clears presentation state", async () => {
+  const runtime = createPluginRuntime()
+  runtime.update({
+    commands: {
+      async activate() {
+        return true
+      },
+      async deactivate() {
+        return true
+      },
+      async add() {
+        return true
+      },
+      async install() {
+        return { ok: true, dir: "/tmp", tui: true }
+      },
+    },
+    status: [
+      {
+        id: "demo",
+        source: "internal",
+        spec: "demo",
+        target: "demo",
+        enabled: true,
+        active: true,
+      },
+    ],
+  })
+
+  expect(await runtime.commands().activate("demo")).toBe(true)
+  expect(runtime.status()).toHaveLength(1)
+  runtime.clear()
+  expect(await runtime.commands().activate("demo")).toBe(false)
+  expect(runtime.status()).toEqual([])
+})

package/test/plugin/slots.test.tsx

@@ -0,0 +1,38 @@
+/** @jsxImportSource @opentui/solid */
+import { expect, test } from "bun:test"
+import { createSlot, createSolidSlotRegistry, testRender, useRenderer } from "@opentui/solid"
+import { onMount } from "solid-js"
+
+type Slots = {
+  prompt: {}
+}
+
+test("replace slot mounts plugin content once", async () => {
+  let mounts = 0
+
+  const Probe = () => {
+    onMount(() => {
+      mounts += 1
+    })
+    return <box />
+  }
+
+  const App = () => {
+    const registry = createSolidSlotRegistry<Slots>(useRenderer(), {})
+    const Slot = createSlot(registry)
+    registry.register({ id: "plugin", slots: { prompt: () => <Probe /> } })
+
+    return (
+      <Slot name="prompt" mode="replace">
+        <box />
+      </Slot>
+    )
+  }
+
+  const app = await testRender(() => <App />)
+  try {
+    expect(mounts).toBe(1)
+  } finally {
+    app.renderer.destroy()
+  }
+})

package/test/prompt/display.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, test } from "bun:test"
+import { displayCharAt, displaySlice, mentionTriggerIndex } from "../../src/prompt/display"
+
+describe("prompt display", () => {
+  test("uses display-width offsets for mentions", () => {
+    expect(mentionTriggerIndex("@")).toBe(0)
+    expect(mentionTriggerIndex("test @")).toBe(5)
+    expect(mentionTriggerIndex("中文 @")).toBe(5)
+    expect(mentionTriggerIndex("こんにちは @")).toBe(11)
+    expect(mentionTriggerIndex("한국어 @")).toBe(7)
+    expect(mentionTriggerIndex("🙂 @")).toBe(3)
+    expect(mentionTriggerIndex("中文 @src file", Bun.stringWidth("中文 @src"))).toBe(5)
+    expect(displayCharAt("中文 @src", Bun.stringWidth("中文 @"))).toBe("s")
+    expect(displaySlice("中文 @src", 5, Bun.stringWidth("中文 @src"))).toBe("@src")
+    expect(displaySlice("中文 @src", 6, Bun.stringWidth("中文 @src"))).toBe("src")
+    expect(mentionTriggerIndex("👨‍👩‍👧‍👦 @src", Bun.stringWidth("👨‍👩‍👧‍👦 @src"))).toBe(3)
+    expect(displayCharAt("👨‍👩‍👧‍👦 @src", Bun.stringWidth("👨‍👩‍👧‍👦 @"))).toBe("s")
+    expect(displaySlice("👨‍👩‍👧‍👦 @src", 3, Bun.stringWidth("👨‍👩‍👧‍👦 @src"))).toBe("@src")
+    expect(mentionTriggerIndex("@file1\n@file2", 13)).toBe(7)
+    expect(displayCharAt("@file1\n@file2", 6)).toBe("\n")
+    expect(displaySlice("@file1\n@file2", 8, 13)).toBe("file2")
+    expect(mentionTriggerIndex("@file1\nfoo @file2", 17)).toBe(11)
+    expect(mentionTriggerIndex("中文 @one\n@two", 14)).toBe(10)
+    expect(displaySlice("中文 @one\n@two", 11, 14)).toBe("two")
+    expect(mentionTriggerIndex("中文@")).toBeUndefined()
+    expect(mentionTriggerIndex("こんにちは@")).toBeUndefined()
+    expect(mentionTriggerIndex("한국어@")).toBeUndefined()
+    expect(mentionTriggerIndex("🙂@")).toBeUndefined()
+    expect(mentionTriggerIndex("hello@")).toBeUndefined()
+    expect(mentionTriggerIndex("foo@bar.com")).toBeUndefined()
+    expect(mentionTriggerIndex("中文 @src file")).toBeUndefined()
+  })
+})

package/test/prompt/history.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, test } from "bun:test"
+import { isDuplicateEntry, MAX_HISTORY_ENTRIES, parsePromptHistory, type PromptInfo } from "../../src/prompt/history"
+
+const entry = (input: string, parts: PromptInfo["parts"] = []): PromptInfo => ({ input, parts })
+
+describe("prompt history", () => {
+  test("recovers valid JSONL entries around corruption", () => {
+    expect(parsePromptHistory(`${JSON.stringify(entry("one"))}\nnot-json\n${JSON.stringify(entry("two"))}\n`)).toEqual([
+      entry("one"),
+      entry("two"),
+    ])
+  })
+
+  test("retains only the newest entries", () => {
+    const input = Array.from({ length: MAX_HISTORY_ENTRIES + 5 }, (_, index) =>
+      JSON.stringify(entry(String(index))),
+    ).join("\n")
+    const result = parsePromptHistory(input)
+    expect(result).toHaveLength(MAX_HISTORY_ENTRIES)
+    expect(result[0]?.input).toBe("5")
+  })
+
+  test("dedupes only identical consecutive entries", () => {
+    expect(isDuplicateEntry(undefined, entry("hello"))).toBe(false)
+    expect(isDuplicateEntry(entry("hello"), entry("hello"))).toBe(true)
+    expect(isDuplicateEntry(entry("foo"), entry("bar"))).toBe(false)
+    expect(isDuplicateEntry({ ...entry("ls"), mode: "normal" }, { ...entry("ls"), mode: "shell" })).toBe(false)
+  })
+
+  test("does not dedupe entries with different parts", () => {
+    const a = entry("describe this", [
+      { type: "file", mime: "image/png", filename: "a.png", url: "data:image/png;base64,AAA" },
+    ])
+    const b = entry("describe this", [
+      { type: "file", mime: "image/png", filename: "b.png", url: "data:image/png;base64,BBB" },
+    ])
+    expect(isDuplicateEntry(a, b)).toBe(false)
+  })
+})

package/test/prompt/jsonl.test.ts

@@ -0,0 +1,24 @@
+import { expect, test } from "bun:test"
+import { MAX_FRECENCY_ENTRIES, parseFrecency } from "../../src/prompt/frecency"
+import { MAX_STASH_ENTRIES, parsePromptStash } from "../../src/prompt/stash"
+
+test("stash JSONL skips corruption and retains newest entries", () => {
+  const entries = Array.from({ length: MAX_STASH_ENTRIES + 2 }, (_, index) =>
+    JSON.stringify({ input: String(index), parts: [], timestamp: index }),
+  )
+  entries.splice(2, 0, "broken")
+  const result = parsePromptStash(entries.join("\n"))
+  expect(result).toHaveLength(MAX_STASH_ENTRIES)
+  expect(result[0]?.input).toBe("2")
+})
+
+test("frecency JSONL skips corruption, keeps latest path state, and limits entries", () => {
+  const entries = Array.from({ length: MAX_FRECENCY_ENTRIES + 1 }, (_, index) =>
+    JSON.stringify({ path: String(index), frequency: 1, lastOpen: index }),
+  )
+  entries.push("broken", JSON.stringify({ path: "1000", frequency: 2, lastOpen: 2000 }))
+  const result = parseFrecency(entries.join("\n"))
+  expect(result).toHaveLength(MAX_FRECENCY_ENTRIES)
+  expect(result[0]).toEqual({ path: "1000", frequency: 2, lastOpen: 2000 })
+  expect(result.some((entry) => entry.path === "0")).toBe(false)
+})

package/test/prompt/local-attachment.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "bun:test"
+import { readLocalAttachmentWith } from "../../src/component/prompt/local-attachment"
+import type { LocalFiles } from "../../src/component/prompt/local-attachment"
+
+function files(input: { mime: string; text?: string; bytes?: Uint8Array }): LocalFiles {
+  return {
+    mime: async () => input.mime,
+    readText: async () => input.text ?? "",
+    readBytes: async () => input.bytes ?? new Uint8Array(),
+  }
+}
+
+describe("prompt local attachments", () => {
+  test("reads SVG attachments as text", async () => {
+    expect(await readLocalAttachmentWith(files({ mime: "image/svg+xml", text: "<svg />" }), "/tmp/image.svg")).toEqual({
+      type: "text",
+      mime: "image/svg+xml",
+      content: "<svg />",
+    })
+  })
+
+  test("reads image and PDF attachments as bytes", async () => {
+    const content = new Uint8Array([1, 2, 3])
+    expect(await readLocalAttachmentWith(files({ mime: "application/pdf", bytes: content }), "/tmp/file.pdf")).toEqual({
+      type: "binary",
+      mime: "application/pdf",
+      content,
+    })
+  })
+
+  test("ignores unsupported and unreadable local files", async () => {
+    expect(await readLocalAttachmentWith(files({ mime: "text/plain" }), "/tmp/file.txt")).toBeUndefined()
+    expect(
+      await readLocalAttachmentWith(
+        {
+          ...files({ mime: "image/png" }),
+          readBytes: async () => Promise.reject(new Error("missing")),
+        },
+        "/tmp/missing.png",
+      ),
+    ).toBeUndefined()
+  })
+})

package/test/prompt/part.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, test } from "bun:test"
+import { expandTrackedPastedText, stripPromptPartIDs } from "../../src/prompt/part"
+
+describe("prompt part", () => {
+  test("strips persisted IDs from reused parts", () => {
+    expect(
+      stripPromptPartIDs({
+        id: "prt_old",
+        sessionID: "ses_old",
+        messageID: "msg_old",
+        type: "file" as const,
+        mime: "image/png",
+        filename: "tiny.png",
+        url: "data:image/png;base64,abc",
+      }),
+    ).toEqual({
+      type: "file",
+      mime: "image/png",
+      filename: "tiny.png",
+      url: "data:image/png;base64,abc",
+    })
+  })
+
+  test("preserves wide characters around pasted text", () => {
+    const marker = "[Pasted ~3 lines]"
+    const prefix = "你好你好\n"
+
+    expect(
+      expandTrackedPastedText(prefix + marker + "\n阿斯顿法国红酒看来", [
+        {
+          start: Bun.stringWidth("你好你好") + 1,
+          end: Bun.stringWidth("你好你好") + 1 + Bun.stringWidth(marker),
+          text: "public:\n\tvoid ExecuteTask();\nprivate:",
+        },
+      ]),
+    ).toBe("你好你好\npublic:\n\tvoid ExecuteTask();\nprivate:\n阿斯顿法国红酒看来")
+  })
+
+  test("only expands the tracked placeholder occurrence", () => {
+    const marker = "[Pasted ~3 lines]"
+    const prefix = `keep ${marker} then `
+
+    expect(
+      expandTrackedPastedText(prefix + marker + " tail", [
+        {
+          start: Bun.stringWidth(prefix),
+          end: Bun.stringWidth(prefix + marker),
+          text: "alpha\nbeta\ngamma",
+        },
+      ]),
+    ).toBe(`keep ${marker} then alpha\nbeta\ngamma tail`)
+  })
+})

package/test/prompt/persistence.test.ts

@@ -0,0 +1,23 @@
+import { expect, test } from "bun:test"
+import path from "path"
+import { mkdtemp, rm } from "fs/promises"
+import { tmpdir } from "os"
+import { appendText, readJson, readText, writeJsonAtomic, writeText } from "../../src/util/persistence"
+
+test("persistence creates parent directories and supports text, append, and JSON", async () => {
+  const root = await mkdtemp(path.join(tmpdir(), "opencode-tui-persistence-"))
+  try {
+    const textPath = path.join(root, "nested", "state.jsonl")
+    await writeText(textPath, "one\n")
+    await appendText(textPath, "two\n")
+    expect(await readText(textPath)).toBe("one\ntwo\n")
+
+    const jsonPath = path.join(root, "other", "state.json")
+    await writeJsonAtomic(jsonPath, { value: 1 })
+    expect(await readJson<{ value: number }>(jsonPath)).toEqual({ value: 1 })
+    await writeJsonAtomic(jsonPath, { value: 2 })
+    expect(await readJson<{ value: number }>(jsonPath)).toEqual({ value: 2 })
+  } finally {
+    await rm(root, { recursive: true, force: true })
+  }
+})

package/test/prompt/traits.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, test } from "bun:test"
+import { computePromptTraits } from "../../src/prompt/traits"
+
+describe("computePromptTraits", () => {
+  test("normal mode without autocomplete only captures tab", () => {
+    const traits = computePromptTraits({ mode: "normal", autocompleteVisible: false })
+    expect(traits.capture).toEqual(["tab"])
+    expect(traits.suspend).toBeUndefined()
+    expect(traits.status).toBeUndefined()
+  })
+
+  test("normal mode with autocomplete captures navigation keys", () => {
+    const traits = computePromptTraits({ mode: "normal", autocompleteVisible: true })
+    expect(traits.capture).toEqual(["escape", "navigate", "submit", "tab"])
+    expect(traits.suspend).toBeUndefined()
+    expect(traits.status).toBeUndefined()
+  })
+
+  test("shell mode disables capture and labels the prompt without suspending", () => {
+    const traits = computePromptTraits({ mode: "shell", autocompleteVisible: false })
+    expect(traits.capture).toBeUndefined()
+    expect(traits.suspend).toBeUndefined()
+    expect(traits.status).toBe("SHELL")
+  })
+})

package/test/runtime.test.tsx

@@ -0,0 +1,37 @@
+import { expect, test } from "bun:test"
+import { testRender } from "@opentui/solid"
+import { abbreviateHome } from "../src/runtime"
+import { TuiPathsProvider, useTuiPaths } from "../src/context/runtime"
+
+test("abbreviates paths within home boundaries", () => {
+  expect(abbreviateHome("/home/test", "/home/test")).toBe("~")
+  expect(abbreviateHome("/home/test/project", "/home/test")).toBe("~/project")
+  expect(abbreviateHome("/home/tester/project", "/home/test")).toBe("/home/tester/project")
+  expect(abbreviateHome("/tmp/project", "/home/test")).toBe("/tmp/project")
+})
+
+test("provides focused immutable runtime inputs", async () => {
+  let paths: ReturnType<typeof useTuiPaths>
+
+  function Runtime() {
+    paths = useTuiPaths()
+    return <text>{paths.cwd}</text>
+  }
+
+  const app = await testRender(
+    () => (
+      <TuiPathsProvider value={{ cwd: "/work", home: "/home/test", state: "/state", worktree: "/worktree" }}>
+        <Runtime />
+      </TuiPathsProvider>
+    ),
+    { width: 40, height: 3 },
+  )
+
+  try {
+    await app.renderOnce()
+    expect(app.captureCharFrame()).toContain("/work")
+    expect(Object.isFrozen(paths!)).toBe(true)
+  } finally {
+    app.renderer.destroy()
+  }
+})