chore: follow up repo hygiene cleanup

Author: RtlZeroMemory

.claude/skills/rezi-create-screen/SKILL.md

@@ -29,16 +29,29 @@ Use this skill when:
 
 1. **Create screen file** at `src/screens/{screen-name}.ts`:
    ```typescript
+   import type { VNode } from "@rezi-ui/core";
    import { ui } from "@rezi-ui/core";
-   import type { AppState } from "../state.js";
+   import type { AppState } from "../types.js";
 
-   export function MyScreen(state: AppState) {
+   type ScreenHandlers = Readonly<{
+     onPrimaryAction: () => void;
+   }>;
+
+   export function renderMyScreen(_state: AppState, handlers: ScreenHandlers): VNode {
      return ui.page({
        p: 1,
        gap: 1,
        header: ui.header({ title: "Screen Title" }),
        body: ui.column({ gap: 1 }, [
-         // screen content
+         ui.text("Screen content"),
+         ui.actions([
+           ui.button({
+             id: "my-screen-action",
+             label: "Go",
+             intent: "primary",
+             onPress: handlers.onPrimaryAction,
+           }),
+         ]),
        ]),
      });
    }
@@ -87,13 +100,26 @@ Use this skill when:
 
 4. **If using router**, add a route definition (see `rezi-routing` skill)
 
-5. **Add keybindings** for screen-specific actions in the app's key handler
+5. **Add keybindings** for screen-specific actions in `src/helpers/keybindings.ts` or your route command resolver
+
+6. **Wire into `src/main.ts`** via a view builder or route factory:
+   ```typescript
+   app.view((state) =>
+     renderMyScreen(state, {
+       onPrimaryAction: () => dispatch({ type: "open-my-screen" }),
+     }),
+   );
+   ```
 
-6. **Wire into main** via router or view switch:
+   For routed apps, add the screen to `src/screens/index.ts`:
    ```typescript
-   view: (state) => {
-     if (state.screen === "my-screen") return MyScreen(state);
-     return HomeScreen(state);
+   {
+     id: "my-screen",
+     title: "My Screen",
+     screen: (_params, context) =>
+       renderMyScreen(context.state, {
+         onPrimaryAction: () => deps.dispatch({ type: "open-my-screen" }),
+       }),
    }
    ```
 

.codex/skills/rezi-create-screen/SKILL.md

@@ -29,16 +29,29 @@ Use this skill when:
 
 1. **Create screen file** at `src/screens/{screen-name}.ts`:
    ```typescript
+   import type { VNode } from "@rezi-ui/core";
    import { ui } from "@rezi-ui/core";
-   import type { AppState } from "../state.js";
+   import type { AppState } from "../types.js";
 
-   export function MyScreen(state: AppState) {
+   type ScreenHandlers = Readonly<{
+     onPrimaryAction: () => void;
+   }>;
+
+   export function renderMyScreen(_state: AppState, handlers: ScreenHandlers): VNode {
      return ui.page({
        p: 1,
        gap: 1,
        header: ui.header({ title: "Screen Title" }),
        body: ui.column({ gap: 1 }, [
-         // screen content
+         ui.text("Screen content"),
+         ui.actions([
+           ui.button({
+             id: "my-screen-action",
+             label: "Go",
+             intent: "primary",
+             onPress: handlers.onPrimaryAction,
+           }),
+         ]),
        ]),
      });
    }
@@ -87,13 +100,26 @@ Use this skill when:
 
 4. **If using router**, add a route definition (see `rezi-routing` skill)
 
-5. **Add keybindings** for screen-specific actions in the app's key handler
+5. **Add keybindings** for screen-specific actions in `src/helpers/keybindings.ts` or your route command resolver
+
+6. **Wire into `src/main.ts`** via a view builder or route factory:
+   ```typescript
+   app.view((state) =>
+     renderMyScreen(state, {
+       onPrimaryAction: () => dispatch({ type: "open-my-screen" }),
+     }),
+   );
+   ```
 
-6. **Wire into main** via router or view switch:
+   For routed apps, add the screen to `src/screens/index.ts`:
    ```typescript
-   view: (state) => {
-     if (state.screen === "my-screen") return MyScreen(state);
-     return HomeScreen(state);
+   {
+     id: "my-screen",
+     title: "My Screen",
+     screen: (_params, context) =>
+       renderMyScreen(context.state, {
+         onPrimaryAction: () => deps.dispatch({ type: "open-my-screen" }),
+       }),
    }
    ```
 

.codex/skills/rezi-perf-profiling/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: rezi-perf-profiling
 description: Profile and optimize Rezi app performance. Use when app feels slow, frames drop, or render phases take too long.
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash(REZI_PERF=1 *), Bash(npx tsx packages/bench/*)
+argument-hint: "[performance-concern]"
+metadata:
+  short-description: Performance profiling
 ---
 
 ## When to use

.codex/skills/rezi-routing/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: rezi-routing
 description: Add routing with guards and nested outlets to a Rezi app. Use when building multi-page/screen TUI applications.
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Edit, Write
+argument-hint: "[route-name]"
+metadata:
+  short-description: Add routing
 ---
 
 ## When to use

.gitignore

@@ -142,7 +142,9 @@ vite.config.ts.timestamp-*
 # Docs (MkDocs)
 .venv-docs/
 
-# Native addon build artifacts
+# Bench and release artifacts
+.artifacts/
+benchmarks/local-*
 packages/native/target/
 packages/native/*.node
 
@@ -160,27 +162,13 @@ Thumbs.db
 *.key
 credentials.json
 
-# Demo benchmark artifacts
-packages/demo/benchmarks/
-
 # Bench artifacts
-packages/bench/results/
-packages/bench/ratatui/target/
+packages/bench/ratatui-bench/target/
 benchmarks/native/ratatui-bench/target/
 
 # Local investigation artifacts
 Screens/
 debug-traces/
 isolate-*.log
 CODEX_*.md
-.last_perf_dir
-.last_perf_pack
-.last_perf_pack_full
-.last_perf_pack_quick
 *.cpuprofile
-packages/bench/bubbletea-bench/.bin/
-
-# Ink compat benchmark artifacts (runner output)
-results/ink-bench_*/
-results/verify_*/
-results/verify_*.json

CLAUDE.md

@@ -22,7 +22,7 @@ Repository examples:
 - `examples/hello-counter`
 - `examples/raw-draw-demo`
 - `examples/gallery`
-- `examples/regression-dashboard`
+- `examples/regression-dashboard` (validation surface for layout/render/input regressions)
 
 ## Canonical References
 
@@ -176,4 +176,4 @@ Project-level skills are mirrored for Claude and Codex.
 | Perf Profiling | `.claude/skills/rezi-perf-profiling/` | `.codex/skills/rezi-perf-profiling/` |
 | Routing | `.claude/skills/rezi-routing/` | `.codex/skills/rezi-routing/` |
 
-Keep these files aligned when the repo structure or recommended workflows change.
+Keep these files aligned, including YAML frontmatter and path examples, when the repo structure or recommended workflows change.

README.md

@@ -2,11 +2,9 @@
 
 > **Status: pre-alpha.** Rezi is under active development. Public APIs, native ABI details, and behavior may change between releases. It is not yet recommended for production workloads.
 
-Rezi is a TypeScript framework for building terminal user interfaces on Node.js and Bun. It provides a declarative widget API, deterministic input and rendering behavior, and a native-backed rendering pipeline through the Zireael engine written in C. 
+Rezi is a TypeScript framework for building terminal user interfaces on Node.js and Bun. It provides a declarative widget API, deterministic input and rendering behavior, and a native-backed rendering pipeline through the [Zireael engine](https://github.com/RtlZeroMemory/Zireael) written in C.
 
-https://github.com/RtlZeroMemory/Zireael
-
-**Links:** [Website](https://rezitui.dev/) · [Docs](https://rezitui.dev/docs/) · [Quickstart](https://rezitui.dev/docs/getting-started/quickstart/) · [Widgets](https://rezitui.dev/docs/widgets/) · [Benchmarks](https://rezitui.dev/docs/benchmarks/)
+**Links:** [Website](https://rezitui.dev/) · [Docs](https://rezitui.dev/) · [Quickstart](https://rezitui.dev/getting-started/quickstart/) · [Widgets](https://rezitui.dev/widgets/) · [Benchmarks](https://rezitui.dev/benchmarks/)
 
 ## What Rezi Is For
 

biome.json

@@ -79,7 +79,9 @@
   "files": {
     "ignore": [
       ".venv-docs/**",
+      ".artifacts/**",
       "out/**",
+      "benchmarks/local-*/**",
       "**/dist/**",
       "**/node_modules/**",
       "**/target/**",

docs/api.md

@@ -15,6 +15,7 @@ The hosted API reference is available at the documentation site under `/api/refe
 Generate the API documentation locally:
 
 ```bash
+npm run build
 npm run docs:api
 ```
 
@@ -23,6 +24,7 @@ The output is written to `out/typedoc/index.html`.
 Alternatively, build the complete documentation site:
 
 ```bash
+npm run build
 npm run docs:build
 ```
 

docs/dev/build.md

@@ -60,8 +60,10 @@ npm run build
 
 This runs `tsc -b` (TypeScript project build mode) across the root project
 references: `packages/create-rezi`, `packages/core`, `packages/node`,
-`packages/testkit`, `packages/jsx`, and `examples/*`. Packages like
-`@rezi-ui/native` and `@rezi-ui/bench` are built separately.
+`packages/testkit`, `packages/jsx`, and the current example apps
+(`examples/gallery`, `examples/hello-counter`, `examples/raw-draw-demo`, and
+`examples/regression-dashboard`). Packages like `@rezi-ui/native` and
+`@rezi-ui/bench` are built separately.
 
 TypeScript build mode is incremental, so subsequent builds after the first are
 fast -- only changed files and their dependents are recompiled.
@@ -74,8 +76,10 @@ packages/node/dist/
 packages/jsx/dist/
 packages/testkit/dist/
 packages/create-rezi/dist/
+examples/gallery/dist/
 examples/hello-counter/dist/
 examples/raw-draw-demo/dist/
+examples/regression-dashboard/dist/
 ```
 
 ### Incremental Rebuilds
@@ -102,6 +106,33 @@ This runs `tsc -b --pretty false` for the same root project references with
 colorized output disabled for easier log parsing. It produces the same `.js`
 and `.d.ts` output as `npm run build`.
 
+For the full CI project graph, including `packages/bench`, run:
+
+```bash
+npm run typecheck:ci
+```
+
+`typecheck:ci` uses `tsconfig.ci.json`, which extends the root graph with the
+benchmark package for release/CI parity checks.
+
+## Benchmark Package Build
+
+The benchmark runner is compiled outside the root `tsc -b` graph. Build it
+explicitly with:
+
+```bash
+npm run bench:build
+```
+
+This runs the `@rezi-ui/bench` project-reference graph and writes the runner to
+`packages/bench/dist/`.
+
+The root benchmark entry points (`npm run bench`, `npm run bench:rezi`,
+`npm run bench:ci`, `npm run bench:terminal:rigorous`, and
+`npm run bench:all:rigorous`) invoke this automatically via `pre*` scripts, so
+they work from a clean checkout after `npm ci` without a separate manual
+`npx tsc -b packages/bench`.
+
 ## Native Addon Build
 
 The native addon (`@rezi-ui/native`) wraps the Zireael C engine via napi-rs.
@@ -196,7 +227,7 @@ git submodule update --init --recursive
 If TypeScript reports errors that do not match the source, delete build caches:
 
 ```bash
-rm -rf packages/*/dist packages/*/.tsbuildinfo
+rm -rf packages/*/dist examples/*/dist packages/*/tsconfig.tsbuildinfo examples/*/tsconfig.tsbuildinfo
 npm run build
 ```