RtlZeroMemory/Rezi

최근 기록된 소스 활동: 2026년 4월 23일 15:42

SkillsMP 카탈로그 업데이트: 2026년 10월 29일 18:30

수집된 skills: 10

GitHub 스타: 677
GitHub 포크: 16

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/RtlZeroMemory/Rezi.

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

# Rezi [![CI](https://github.com/RtlZeroMemory/Rezi/actions/workflows/ci.yml/badge.svg)](https://github.com/RtlZeroMemory/Rezi/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/%40rezi-ui%2Fcore)](https://www.npmjs.com/package/@rezi-ui/core) [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) Rezi is a TypeScript framework for building terminal applications on Node.js and Bun. It provides structured layout, focus and input handling, routing, widgets, and testing tools, with rendering handled by [Zireael](https://github.com/RtlZeroMemory/Zireael), a terminal engine written in C. **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/) ![Rezi command console demo](assets/REZICONSOLE3.gif) ## Status Rezi is in **beta**. The core API — the app model, layout, input routing, theming, and the widget surface — is stable enough to build on, and the public API of `@rezi-ui/core` is recorded and diffed in CI. Breaking changes still happen before 1.0, but they are deliberate, batched, and documented in the [changelog](CHANGELOG.md) with migration notes. Individual widgets carry explicit [stability tiers](docs/widgets/stability.md) (`stable`, `beta`, `experimental`), so the guarantees that apply to what you use are spelled out rather than implied. ## What Rezi Is For Dashboards, control planes, internal tools, log viewers, agent consoles, and developer workflows that need more than line-oriented output: multi-panel layouts, routed screens, focusable controls, forms, tables, overlays, and predictable behavior under keyboard and mouse input. Apps choose their presentation: full-screen on the alternate buffer, or **inline screen mode** — a bounded region on the primary screen with terminal scrollback preserved above it and the final frame left in scrollback on exit (the presentation style of agent CLIs, progress UIs, and REPLs). See the [Screen Modes guide](docs/guide/screen-modes.md). ## Why Rezi - A structured app model instead of a rendering loop you assemble yourself - A declarative widget API that does not require React - Native framebuffer diffing and terminal output through a fuzz-tested C engine - First-party widgets for forms, tables, trees, overlays, charts, file pickers, and command palettes - Full-screen and inline screen modes from the same widget API (`screen: { mode: "inline", inlineRows: 9 }`) - Reproducible rendering and input contracts, so application behavior is testable ## Example ```ts import { ui } from "@rezi-ui/core"; import { createNodeApp } from "@rezi-ui/node"; type State = { count: number }; const app = createNodeApp<State>({ initialState: { count: 0 } }); app.view((state) => ui.page({ p: 1, gap: 1, header: ui.header({ title: "Counter" }), body: ui.panel("Count", [ ui.row({ gap: 1, items: "center" }, [ ui.text(String(state.count), { variant: "heading" }), ui.spacer({ flex: 1 }), ui.button({ id: "inc", label: "+1", intent: "primary", onPress: () => app.update((s) => ({ count: s.count + 1 })), }), ]), ]), }), ); app.keys({ q: () => app.stop() }); await app.run(); ``` ## Quick Start ```bash npm create rezi my-app cd my-app npm run start ``` With Bun: ```bash bun create rezi my-app cd my-app bun run start ``` Or add Rezi to an existing project: ```bash npm install @rezi-ui/core @rezi-ui/node ``` Three templates are available: - `minimal` — single-screen starter for focused utilities - `cli-tool` — routed multi-screen starter for product-style terminal tools - `starship` — large command-console showcase with routing, charts, canvas, forms, and overlays Start with `minimal` or `cli-tool`. Use `starship` (`npm create rezi my-console -- --template starship`) when you want the full surface area in one app. ## Requirements - Node.js 18+ or Bun 1.3+ - Linux, macOS, or Windows `@rezi-ui/native` ships prebuilt binaries for Linux x64/arm64 (glibc), macOS x64/arm64, and Windows x64/arm64, so `npm install` never compiles C. Alpine/musl is not yet supported. Terminal capabilities — color depth, mouse, bracketed paste, synchronized output — are probed at startup, and output adapts to what the terminal reports. ## How It Works Your application builds a widget tree in TypeScript. `@rezi-ui/core` lays it out and serializes the result into a compact binary drawlist. The Zireael engine validates the drawlist, diffs it against the previous frame, and writes the minimal terminal update; in the other direction it parses keyboard, mouse, paste, and resize input into event batches that core routes through focus and keybindings. The protocol at this boundary is versioned and [documented](docs/protocol/zrdl.md). The API stays in TypeScript; the hot path stays in C; both sides are tested in isolation. See [Architecture](docs/architecture/index.md). ## Packages | Package | Purpose | |---|---| | [`@rezi-ui/core`](https://www.npmjs.com/package/@rezi-ui/core) | Widget API, layout, routing, focus, forms, themes, test renderer | | [`@rezi-ui/node`](https://www.npmjs.com/package/@rezi-ui/node) | Node/Bun backend: terminal I/O, scheduling, native engine integration | | [`@rezi-ui/native`](https://www.npmjs.com/package/@rezi-ui/native) | N-API binding to the Zireael engine, with prebuilt binaries | | [`@rezi-ui/jsx`](https://www.npmjs.com/package/@rezi-ui/jsx) | Optional JSX runtime over the core API | | [`@rezi-ui/testkit`](https://www.npmjs.com/package/@rezi-ui/testkit) | Assertions, snapshot helpers, and deterministic fuzz utilities | | [`create-rezi`](https://www.npmjs.com/package/create-rezi) | Project scaffolding CLI | All publishable packages share one version and release together. ## Versioning Rezi follows semantic versioning, applied through stability tiers during the beta line: - `stable` widgets and the core app, layout, and routing APIs do not change documented behavior without a changelog callout and a migration note - `beta` widgets are tested for their core invariants; contract details may still evolve - `experimental` widgets may change at any time The full tier assignment per widget is in [Widget Stability](docs/widgets/stability.md). ## Testing Applications are testable without a terminal: `@rezi-ui/core` includes a deterministic test renderer, and `@rezi-ui/testkit` adds assertions, frame snapshots, and seeded fuzz helpers on top of `node:test`. The framework holds itself to the same bar — behavior-contract tests, golden-frame tests, fuzzed parsers on both sides of the native boundary, and a Linux/macOS/Windows × Node 18/20/22 × Bun CI matrix. See the [testing guide](docs/guide/testing.md). ## Performance Rezi is designed to stay fast on structured terminal workloads. Benchmark methodology, caveats, and committed result snapshots are documented in [BENCHMARKS.md](BENCHMARKS.md) and on the [benchmarks page](docs/benchmarks.md). ## Documentation - [Install](docs/getting-started/install.md) - [Quickstart](docs/getting-started/quickstart.md) - [Widget catalog](docs/widgets/index.md) - [Examples](docs/getting-started/examples.md) - [Architecture](docs/architecture/index.md) - [Benchmarks](docs/benchmarks.md) ## Contributing Bug reports and pull requests are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md); the short version: ```bash npm ci npm run build npm test ``` For reporting security issues, see [SECURITY.md](SECURITY.md). ## License [Apache-2.0](LICENSE)

저장소 README를 불러오는 중…

이 저장소의 skills

소프트웨어 개발자 소프트웨어 품질 보증 분석가·테스터

직업 카테고리 2개 · 100% 분류됨

소프트웨어 품질 보증 분석가·테스터

Write tests for Rezi widgets, screens, or app logic using createTestRenderer and node:test.

원문 언어: 영어

2026-02-23

수집된 skill 10개 중 10개를 표시합니다.