tmux-ide 2.8.0 → 2.9.0-beta.5

package/packages/daemon/src/tui/mirror/THEME.md

@@ -0,0 +1,48 @@
+# Semantic theme foundation
+
+`theme.ts` is the app-owned semantic token boundary. It deliberately stays
+small: OpenTUI receives concrete `RGBA` values, but app code should name the
+role it needs instead of hard-coding surface colors.
+
+## Token roles
+
+- `colors.accent` is the user-selected brand/action color. It is preserved
+  exactly, so a saved accent may equal a status color.
+- `colors.focus` and `colors.focusBorder` are focus tokens. They default from
+  accent when safe, but fall back to the base focus family when the selected
+  accent collides with any resolved status color. Keyboard focus must not look
+  like blocked, working, done, idle, or unknown state.
+- `colors.status.*` are state tokens. They must remain visually distinct from
+  focus so blocked, working, done, idle, and unknown states are never confused
+  with navigation focus. They are not guaranteed to be distinct from raw user
+  accent because old saved accents remain valid.
+- `density`, `borders`, and `glyphs` are structural tokens. They describe the
+  app's default spacing, border style, and common terminal symbols; they are not
+  per-surface layout decisions.
+
+## State precedence
+
+Theme state resolves in this order:
+
+1. The persisted app config supplies the selected mode (`dark`, `light`, or
+   `system`) and custom token overrides such as `theme.accent`.
+2. Explicit `dark`/`light` modes choose that palette directly.
+3. `system` follows the renderer `theme_mode` subscription; if the renderer
+   has not reported a mode yet, the dark palette is used as the stable fallback.
+4. Custom accent, foreground, muted, status, and glyph overrides are applied
+   after palette selection. Existing saved custom accents remain valid.
+
+Snapshots are stable immutable containers. The TypeScript contract exposes
+readonly token fields and runtime freezes the containers. `RGBA` itself exposes
+mutable channel setters backed by native storage, so snapshots provide readonly
+RGBA references by contract; consumers must treat them as immutable and never
+mutate color instances in place. Consumers subscribe once, compare snapshot
+identity, and avoid allocating reactive theme objects during render.
+
+## Primitive versus recipe boundary
+
+This module is a primitive-style foundation: it defines semantic tokens, mode
+resolution, and subscriptions. Recipes such as Missions lanes, settings rows,
+dialogs, or terminal chrome decide how those tokens are mapped to their own
+layout and interaction states. tmux-ide does not depend on TUIparts at runtime;
+the reference informed the shape, but the visual layer remains app-owned.

package/packages/daemon/src/tui/mirror/__snapshots__/activity-surface-renderer.test.tsx.snap

@@ -0,0 +1,42 @@
+// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+
+exports[`ActivitySurface OpenTUI renderer records the %sx%s compact native dock-body baseline 1`] = `
+" Activity · 6 updates · 1 attention · 1 blocked · 1 working
+● Codex 5.5: Building native Activity        12:48 working█
+● mission M31: Files surface verified           12:47 done█
+● ! review: Card 04 needs attention            now blocked░
+● Claude: Waiting for integration               12:44 idle░
+ 1-4 of 6"
+`;
+
+exports[`ActivitySurface OpenTUI renderer records the %sx%s standard native dock-body baseline 1`] = `
+" Activity · 6 updates · 1 attention · 1 blocked · 1 working
+● agent Codex 5.5 · Building native Activity                                12:48 · working
+● event mission M31 · Files surface verified                                   12:47 · done
+● ! event review · Card 04 needs attention                                    now · blocked
+● agent Claude · Waiting for integration                                       12:44 · idle
+● event workspace · Activity feed refreshed                                 12:42 · unknown
+● agent 設計 agent · Checked responsive rows                                   12:40 · done
+
+
+ j/k select · 1-6 of 6"
+`;
+
+exports[`ActivitySurface OpenTUI renderer records the %sx%s wide native dock-body baseline 1`] = `
+" Activity · 6 updates · 1 attention · 1 blocked · 1 working
+● agent Codex 5.5 · Building native Activity — projection and renderer                                                                                      12:48 · working
+● event mission M31 · Files surface verified — 47 tests passed                                                                                                 12:47 · done
+● ! event review · Card 04 needs attention — one renderer snapshot changed                                                                                    now · blocked
+● agent Claude · Waiting for integration                                                                                                                       12:44 · idle
+● event workspace · Activity feed refreshed                                                                                                                 12:42 · unknown
+● agent 設計 agent · Checked responsive rows — compact, standard, and wide                                                                                     12:40 · done
+
+
+
+
+
+
+
+
+ j/k select · enter inspect · 1-6 of 6"
+`;

package/packages/daemon/src/tui/mirror/__snapshots__/changes-terminal-surface-renderer.test.tsx.snap

@@ -0,0 +1,267 @@
+// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders Changes %sx%s with projected chip parity 1`] = `
+" Changes 3 files · +18 -3 │ app▏                     │                    ○ [r]
+ ready
+  ○ Staged (1)                   diff --git a/src/app.ts b/src/app.ts
+M○  README.md +2                 @@ -1 +1 @@
+  ○ Unstaged (1)                 -old
+M●  src/app.… +12 -3 · [s stage] +new
+  ○ Untracked (1)                 context
+?○  notes/todo.md +4
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ]/[ hunk · / filter · ^e e ○ [s stage]   ○ [u unstage]   ○ [S all]   ○ [U all]"
+`;
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders Changes %sx%s with projected chip parity 2`] = `
+" Changes 3 files · +18 -3 │ app▏                     │                                                    ○ [r refresh]
+ ready
+  ○ Staged (1)                          diff --git a/src/app.ts b/src/app.ts
+M○  README.md +2                        @@ -1 +1 @@
+  ○ Unstaged (1)                        -old
+M●  src/app.ts +12 -3       · [s stage] +new
+  ○ Untracked (1)                        context
+?○  notes/todo.md +4
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ]/[ hunk · ^e edit · / filter · r refresh · ^g home · ^q quit      ○ [s stage]   ○ [u unstage]   ○ [S all]   ○ [U all]"
+`;
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders Changes %sx%s with projected chip parity 3`] = `
+" Changes 3 files · +18 -3 │ app▏                     │                                                                                                                                    ○ [r refresh]
+ ready
+  ○ Staged (1)                                      diff --git a/src/app.ts b/src/app.ts
+M○  README.md +2                                    @@ -1 +1 @@
+  ○ Unstaged (1)                                    -old
+M●  src/app.ts +12 -3                   · [s stage] +new
+  ○ Untracked (1)                                    context
+?○  notes/todo.md +4
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ]/[ hunk · ^e edit · / filter · r refresh · ^g home · ^q quit                                                                                      ○ [s stage]   ○ [u unstage]   ○ [S all]   ○ [U all]"
+`;
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders terminal chrome %sx%s without expanding body cells 1`] = `
+" api server                  ● [⛶ zoom]   ○ [+ split]   ● [/ search]   ● [SYNC]
+framebuffer body stays opaque
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ focused · attention · zoomed · ↑12/120 · workspace %7"
+`;
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders terminal chrome %sx%s without expanding body cells 2`] = `
+" api server                                                          ● [⛶ zoom]   ○ [+ split]   ● [/ search]   ● [SYNC]
+framebuffer body stays opaque
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ focused · attention · zoomed · ↑12/120 · workspace %7"
+`;
+
+exports[`Changes and terminal surfaces OpenTUI renderer renders terminal chrome %sx%s without expanding body cells 3`] = `
+" api server                                                                                                                                          ● [⛶ zoom]   ○ [+ split]   ● [/ search]   ● [SYNC]
+framebuffer body stays opaque
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ focused · attention · zoomed · ↑12/120 · workspace %7"
+`;

package/packages/daemon/src/tui/mirror/__snapshots__/home-files-surface-renderer.test.tsx.snap

@@ -0,0 +1,267 @@
+// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s home first-run frame 1`] = `
+" Home · undefined sessions · undefined projects ● 0 ● 0 ● 0 ○ 0
+────────────────────────────────────────────────────────────────────────────────
+
+                              Welcome to tmux-ide
+
+                          ○ ▸ open a folder — press f
+
+                                press f to open
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ open a folder to start
+ j/k enter ○ [f folder] ^ ○ [n session]   ○ [a agent]   ○ [o open]   ○ [d diff]"
+`;
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s home populated frame 1`] = `
+" tmux-ide Home · Sessions, registered projects, and recent folders ● 0 ● 1 ● 0 ○ 0
+────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+● workspace                                                                      2w · working ○ [+ agent]   ○ [± diff]
+○ docs                                                                           /repo/docs ○ [+ agent]   ○ [▸ launch]
+○ playground                                                                                /tmp/playground ○ [▸ open]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ workspace · 2 windows
+ enter open · n new session · ^q quit ○ [f open folder]   ○ [n new session]   ○ [a new agent]   ○ [o open]   ○ [d diff]"
+`;
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s home populated frame 2`] = `
+" tmux-ide Home · Sessions, registered projects, and recent folders ● 0 ● 1 ● 0 ○ 0
+────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+● workspace                                                                                                                                                      2w · working ○ [+ agent]   ○ [± diff]
+○ docs                                                                                                                                                           /repo/docs ○ [+ agent]   ○ [▸ launch]
+○ playground                                                                                                                                                                /tmp/playground ○ [▸ open]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ workspace · 2 windows
+ enter open · n new session · ^q quit                                                                                 ○ [f open folder]   ○ [n new session]   ○ [a new agent]   ○ [o open]   ○ [d diff]"
+`;
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s files filtered frame 1`] = `
+" Files 1:8 2L ready │ app▏         │             ○ save   ○ reload   ○ / filter
+ /repo/workspace/src/app.ts
+● ▾ src                            1 export const app = true;
+○     app.ts M                     2 console.log(app);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ enter open · / filter · esc list"
+`;
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s files empty frame 1`] = `
+" Files 1:8 0L ready                                                ○ / filter   ○ H dot:off   ○ I ign:off   ○ r refresh
+ no files visible — try H or I
+ ○ No files                              ○ No file open
+   no files visible — try H or I           Select a file from the list.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ enter open · / filter · ^q quit"
+`;
+
+exports[`Home and Files surfaces OpenTUI renderer renders deterministic %sx%s files error frame 1`] = `
+" Files 1:8 2L read failed                                                                                                               ○ reload   ○ / filter   ○ H dot:off   ○ I ign:off   ○ r refresh
+ outside workspace
+● ▾ src                                       1 export const app = true;
+○     app.ts M                                2 console.log(app);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ enter open · / filter · ^q quit"
+`;