xonecas.io
70160
Ce

cel-tui / commit 34b6b7e

chore: prepare 0.7.0 release

xonecas2026-04-11 34b6b7eb6cdff53afcae2627057bd63115e71019 parent f212946

7 files changed

README.md+1−0
@@ -65,6 +65,7 @@ cel.viewport(() =>
6565 - **Uncontrolled by default** — focus and scroll just work. Opt into controlled mode when needed.
6666 - **Adaptive wheel scrolling** — scrollables and TextInput use an adaptive mouse-wheel step by default; override it with `scrollStep` when needed.
6767 - **Content measurement helper** — `measureContentHeight(node, { width })` lets apps preserve scroll anchors when prepending intrinsically sized content.
68+- **Terminal title helper** — `cel.setTitle("My App")` updates the window/tab title when the host honors OSC titles.
6869 - **Style inheritance** — containers propagate styles to descendants. `bgColor` fills the rect.
6970 - **16-color palette** — numbered slots (`"color00"`–`"color15"`) mapped to ANSI 16 by default. Custom themes can remap to different ANSI indices or 24-bit true color.
7071 - **Cell buffer rendering** — styled cells, differential updates, synchronized output.
bun.lock+3−3
@@ -17,7 +17,7 @@
1717 },
1818 "packages/components": {
1919 "name": "@cel-tui/components",
20- "version": "0.6.2",
20+ "version": "0.7.0",
2121 "dependencies": {
2222 "@cel-tui/core": "workspace:*",
2323 "@cel-tui/types": "workspace:*",
@@ -30,7 +30,7 @@
3030 },
3131 "packages/core": {
3232 "name": "@cel-tui/core",
33- "version": "0.6.2",
33+ "version": "0.7.0",
3434 "dependencies": {
3535 "@cel-tui/types": "workspace:*",
3636 "get-east-asian-width": "^1.5.0",
@@ -41,7 +41,7 @@
4141 },
4242 "packages/types": {
4343 "name": "@cel-tui/types",
44- "version": "0.6.2",
44+ "version": "0.7.0",
4545 "peerDependencies": {
4646 "typescript": ">=5.0.0",
4747 },
docs/skill/cel-tui/SKILL.md+3−1
@@ -5,7 +5,7 @@ license: MIT
55 compatibility: Requires Bun runtime. Best experience on Kitty-compatible terminals and in tmux with `set -s extended-keys on`; uses SGR mouse mode and accepts recoverable legacy key encodings when hosts do not preserve a pure Kitty stream.
66 metadata:
77 author: sacenox
8- version: "0.6.2"
8+ version: "0.7.0"
99 ---
1010
1111 # Building TUIs with cel-tui
@@ -74,6 +74,8 @@ cel.viewport(() =>
7474
7575 The steps: `cel.init(terminal)` → `cel.viewport(() => tree)` → mutate state + `cel.render()`.
7676
77+Use `cel.setTitle("My App")` when you want to update the terminal window or tab title. It is imperative terminal state, not part of the render tree, and the previous title is not restored automatically on `cel.stop()`.
78+
7779 ## 4 Primitives
7880
7981 | Primitive | Type | Description |
docs/skill/cel-tui/references/api.md+15−0
@@ -1,5 +1,20 @@
11 # cel-tui API Reference
22
3+## Framework lifecycle
4+
5+```ts
6+cel.init(new ProcessTerminal(), { theme?: Theme });
7+cel.viewport(() => tree); // or () => [layer1, layer2]
8+cel.render();
9+cel.setTitle("My App");
10+cel.stop();
11+```
12+
13+- `cel.viewport` sets the render function and triggers the first render.
14+- `cel.render()` requests a batched re-render after external state changes.
15+- `cel.setTitle(title)` writes a best-effort terminal title request. Control characters are stripped from `title`, and `cel.stop()` does not restore the previous title automatically.
16+- `cel.stop()` restores terminal state (raw mode, keyboard protocol, mouse tracking, alternate screen).
17+
318 ## Container Props
419
520 All props accepted by `VStack` and `HStack`:
packages/components/package.json+1−1
@@ -1,6 +1,6 @@
11 {
22 "name": "@cel-tui/components",
3- "version": "0.6.2",
3+ "version": "0.7.0",
44 "description": "Pre-made components for cel-tui — Button, Spacer, Divider, VDivider, Select, Markdown, SyntaxHighlight",
55 "type": "module",
66 "module": "src/index.ts",
packages/core/package.json+1−1
@@ -1,6 +1,6 @@
11 {
22 "name": "@cel-tui/core",
3- "version": "0.6.2",
3+ "version": "0.7.0",
44 "description": "Core framework engine for cel-tui — primitives, layout, rendering, input",
55 "type": "module",
66 "module": "src/index.ts",
packages/types/package.json+1−1
@@ -1,6 +1,6 @@
11 {
22 "name": "@cel-tui/types",
3- "version": "0.6.2",
3+ "version": "0.7.0",
44 "description": "Type definitions for cel-tui, a TypeScript TUI framework",
55 "type": "module",
66 "module": "src/index.ts",