feat: bootstrap namespace-driven Tessera renderer
This commit is contained in:
@@ -0,0 +1,74 @@
|
||||
# Tessera
|
||||
|
||||
Tessera is a clean desktop rendering host. It starts with an empty page. Coding agents submit source code to a namespace through a local CRUD API; Tessera parses that code, builds its architecture tree, compiles it to drawing commands, and renders the result.
|
||||
|
||||
## Start
|
||||
|
||||
```bash
|
||||
cargo run --release
|
||||
```
|
||||
|
||||
Tessera listens only on `127.0.0.1:4737`.
|
||||
|
||||
Start every agent integration by reading the live Markdown guide:
|
||||
|
||||
```bash
|
||||
curl http://127.0.0.1:4737/agent
|
||||
```
|
||||
|
||||
## Namespace code API
|
||||
|
||||
The initial active namespace is `app.main`. Tessera has no file concept.
|
||||
|
||||
```text
|
||||
GET /v1/namespaces/app.main/code
|
||||
PUT /v1/namespaces/app.main/code
|
||||
DELETE /v1/namespaces/app.main/code
|
||||
```
|
||||
|
||||
Submit code as plain text:
|
||||
|
||||
```bash
|
||||
curl \
|
||||
--request PUT \
|
||||
--header 'Content-Type: text/plain; charset=utf-8' \
|
||||
--data-binary @- \
|
||||
http://127.0.0.1:4737/v1/namespaces/app.main/code <<'TESSERA'
|
||||
namespace app.main
|
||||
|
||||
use tessera.ui::{Column, Text}
|
||||
|
||||
export scene Main {
|
||||
render {
|
||||
Column(gap: 12, padding: 24) {
|
||||
Text("Hello", role: .title)
|
||||
Text("Rendered by Tessera")
|
||||
}
|
||||
}
|
||||
}
|
||||
TESSERA
|
||||
```
|
||||
|
||||
Updates are atomic. Invalid code returns diagnostics with HTTP 422 and preserves the last successfully rendered revision.
|
||||
|
||||
## Developer tools
|
||||
|
||||
The developer sidebar is closed by default.
|
||||
|
||||
- macOS: `Command-Option-I` or `F12`
|
||||
- Windows/Linux: `Control-Shift-I` or `F12`
|
||||
|
||||
The upper section displays the compiler-produced architecture tree. Selecting a node shows the corresponding source range below it.
|
||||
|
||||
## Current syntax experiment
|
||||
|
||||
The first parser intentionally supports only enough syntax to test the architecture:
|
||||
|
||||
- `namespace`
|
||||
- namespace-only `use`
|
||||
- one `export scene`
|
||||
- one `render` root
|
||||
- `Column`, `Row`, `Spacer`, and `Text`
|
||||
- `gap`, `padding`, and `.title`
|
||||
|
||||
There are no files, HTML, CSS, JavaScript, DOM, or resource-network concepts in the runtime.
|
||||
Reference in New Issue
Block a user