direct fbs support

.github/workflows/check-generated-fbs.yml

@@ -0,0 +1,62 @@
+# -----------------------------------------------------------------
+# Freshness check for committed FlatBuffers bindings
+# -----------------------------------------------------------------
+#
+# Why this exists
+# ---------------
+# The Rust FlatBuffers bindings (`crates/grida-canvas/src/io/generated/grida.rs`)
+# are committed to git so that `cargo build` works from a clean checkout without
+# requiring `flatc`. However, because the file is generated from `format/grida.fbs`,
+# it can become stale if someone edits the schema but forgets to regenerate.
+#
+# This workflow re-runs codegen and asserts that the committed file is identical
+# to what `flatc` would produce. If it differs, the check fails with a clear
+# error message telling the contributor how to fix it.
+#
+# When does it run
+# ----------------
+# Only on PRs / pushes that touch the schema, the generated output, the codegen
+# tooling, or the TS format package (which shares the same schema source).
+#
+# How to fix a failure
+# --------------------
+#   pnpm --filter @crates/grida-canvas generate
+#   git add crates/grida-canvas/src/io/generated/grida.rs
+#   git commit
+# -----------------------------------------------------------------
+
+name: check generated flatbuffers
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    paths:
+      - "format/grida.fbs"
+      - "crates/grida-canvas/src/io/generated/**"
+      - "packages/grida-format/src/**"
+      - "bin/activate-flatc"
+
+jobs:
+  rust-bindings:
+    name: rust fbs freshness
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Regenerate Rust FlatBuffers bindings
+        run: |
+          python3 bin/activate-flatc -- --rust \
+            -o crates/grida-canvas/src/io/generated \
+            format/grida.fbs
+          mv crates/grida-canvas/src/io/generated/grida_generated.rs \
+             crates/grida-canvas/src/io/generated/grida.rs
+
+      - name: Check for uncommitted changes
+        run: |
+          if ! git diff --exit-code crates/grida-canvas/src/io/generated/grida.rs; then
+            echo "::error::Generated Rust FlatBuffers bindings are stale. Run 'pnpm --filter @crates/grida-canvas generate' and commit the result."
+            exit 1
+          fi

bin/activate-flatc

@@ -5,9 +5,10 @@ Grida: FlatBuffers compiler (flatc) bootstrapper
 
 Why this exists
 ---------------
-We intentionally do NOT commit generated FlatBuffers bindings to git (see
-`packages/grida-format/.gitignore`). The package build step runs `flatc` (see
-`packages/grida-format/package.json`), so CI and Vercel builds must have a
+Generated FlatBuffers bindings are committed for the Rust crate
+(`crates/grida-canvas/src/io/generated/grida.rs`) so that `cargo build` works
+from a clean checkout. The TypeScript package (`packages/grida-format`)
+regenerates at build time. In both cases CI and Vercel builds need a
 deterministic way to obtain `flatc`.
 
 FlatBuffers does not ship `flatc` via npm, so this script installs a prebuilt

crates/grida-canvas-wasm/example/demo.grida1

@@ -9889,5 +9889,5 @@
       "main"
     ]
   },
-  "version": "0.90.0-beta+20260108"
+  "version": "0.91.0-beta+20260311"
 }

crates/grida-canvas-wasm/example/gradient.grida1

@@ -1,5 +1,5 @@
 {
-  "version": "0.90.0-beta+20260108",
+  "version": "0.91.0-beta+20260311",
   "document": {
     "nodes": {
       "gradient-rect": {

crates/grida-canvas-wasm/example/rectangle.grida1

@@ -1,5 +1,5 @@
 {
-  "version": "0.90.0-beta+20260108",
+  "version": "0.91.0-beta+20260311",
   "document": {
     "nodes": {
       "rectangle": {

crates/grida-canvas-wasm/lib/__test__/environment-node-raster-export.test.ts

@@ -76,7 +76,7 @@ describe("raster export (node)", () => {
     const imageBytes = new Uint8Array(readFileSync(imagePath));
 
     const doc = {
-      version: "0.90.0-beta+20260108",
+      version: "0.91.0-beta+20260311",
       document: {
         nodes: {
           "image-rect": {

crates/grida-canvas/AGENTS.md

@@ -75,6 +75,5 @@ See [examples/tool_io_grida.rs](./examples/tool_io_grida.rs) for full documentat
 ## Package Docs
 
 ```sh
-# skia-safe
-cargo doc --package skia-safe --open --no-deps
+cargo doc --package cg --open --no-deps
 ```

crates/grida-canvas/Cargo.toml

@@ -22,6 +22,7 @@ gl = "0.14.0"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 json-patch = "4.1.0"
+flatbuffers = "25.12.19"
 
 # text editing
 grida-text-edit = { path = "../grida-text-edit" }

crates/grida-canvas/README.md

@@ -2,52 +2,116 @@
 
 <img src="./cover.png" alt="Grida Canvas Rendering Backend Example" width="100%" />
 
-Grida Canvas core graphics implements High-level Node & Property based Graphics API that supports mordern design techniques.
+Grida Canvas is a **safe, high-performance 2D real-time rendering engine** for the Grida design tool. It provides a node- and property-based graphics API with support for modern design techniques.
 
-## Rendering
+- **Rendering**: [`skia-safe`](https://rust-skia.github.io/doc/skia_safe/) for painting
+- **Geometry & math**: [`math2`](../math2/README.md) for transforms, rects, and common operations
 
-**2D Nodes**
+## Capabilities
 
-- [ ] TextSpan
-- [ ] Text (Text with mixed styles)
-- [ ] Image
-- [ ] Bitmap (for bitmap drawing)
-- [ ] Group
-- [ ] Container (Frame)
-- [ ] Rectangle
-- [ ] Ellipse
-- [ ] Polygon
-- [ ] RegularPolygon
-- [ ] RegularStarPolygon
-- [ ] Path (SVG Path)
-- [ ] Vector (Vector Network)
-- [ ] Line
+### 2D nodes
 
-**Meta**
+| Node                                        | Status |
+| ------------------------------------------- | ------ |
+| Container (Frame)                           | ✅     |
+| Group                                       | ✅     |
+| Rectangle                                   | ✅     |
+| Ellipse (incl. arc, ring, sector)           | ✅     |
+| Polygon, RegularPolygon, RegularStarPolygon | ✅     |
+| Line                                        | ✅     |
+| Path (SVG path)                             | ✅     |
+| Vector (vector network)                     | ✅     |
+| BooleanOperation                            | ✅     |
+| TextSpan                                    | ✅     |
+| Image                                       | ✅     |
+| InitialContainer, Error                     | ✅     |
 
-- [ ] Mask
-- [ ] Clip
+### Paints & effects
 
-**Styles & Effects**
+- **Fills**: Solid, LinearGradient, RadialGradient, SweepGradient, Image (with fit and image filters)
+- **Strokes**: Stroke width (uniform/variable), dash array, caps/joins, stroke alignment, rect-specific stroke widths, markers
+- **Effects**: Layer blur, backdrop blur, drop/inner shadow, liquid glass, noise
+- **Blend modes** on layers and paints
 
-- [ ] SolidPaint
-- [ ] LinearGradientPaint
-- [ ] RadialGradientPaint
-- [ ] DropShadow
-- [ ] BoxShadow
-- [ ] BlendMode
+### Layout
 
-## API
+- **Taffy**-based layout: flex (direction, alignment, gap, padding), positioning (inset, width/height), transform
 
-**Camera**
+### Meta
 
-- [ ] 2D Camera
+- **Masks** (layer and vector masks)
 
-**Pipeline & API**
+### Pipeline & runtime
 
-- [ ] load font
-- [ ] load image
+- **Camera**: 2D camera (pan, zoom, viewport)
+- **Resources**: Font loading (`FontRepository`), image loading (`ImageRepository`), embedded fonts (e.g. Geist, Geist Mono)
+- **Export**: PNG, JPEG, WEBP, BMP, PDF, SVG
 
-## Interactivity
+### Interactivity
 
-- [ ] Hit testing
+- **Hit testing**: `HitTester` for point-in-node and hit-test queries
+
+## I/O
+
+| Module                                        | Description                                                                                                                                            |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `io::io_grida_fbs`                            | Encode/decode `.grida` FlatBuffers binaries. Bindings are generated from `format/grida.fbs` via `flatc --rust` (see repo root and `format/README.md`). |
+| `io::io_grida`                                | Decode Grida JSON documents into a `Scene`.                                                                                                            |
+| `io::io_grida_patch`                          | Apply JSON Patch to a decoded scene.                                                                                                                   |
+| `io::io_figma`                                | Decode Figma API JSON into a `Scene` (feature-gated: `--features figma`).                                                                              |
+| `io::io_svg`, `io::io_css`, `io::io_markdown` | Additional import/parsing helpers.                                                                                                                     |
+
+### Test fixtures
+
+Raw FlatBuffers test fixtures live in [`fixtures/test-grida/`](../../fixtures/test-grida/) at the repo root. In-memory round-trip tests are in `cargo test --package cg --test fbs_roundtrip`. See the fixtures directory README for format and version details.
+
+## NodeID system
+
+The canvas uses a dual-ID system:
+
+- **NodeId** (`u64`): Internal counter-based IDs for high-performance operations. Ephemeral and not serialized.
+- **UserNodeId** (`String`): External user-provided IDs for public APIs. Stable and serialized in `.grida` files.
+
+See [AGENTS.md](./AGENTS.md#nodeid-system) for details and migration notes.
+
+## Testing & development
+
+```sh
+# run tests
+cargo test
+
+# run fmt
+cargo fmt
+
+# run check
+cargo check
+cargo check --all-targets --all-features
+
+# run clippy (no deps — skips re-checking skia etc.)
+cargo clippy --no-deps --all-targets --all-features
+
+# run build
+cargo build
+
+# run examples (many require window/GPU; headless_gpu requires native-gl-context)
+cargo run --example <example-name>
+cargo run --example headless_gpu --features native-gl-context
+```
+
+## Tools
+
+### `tool_io_grida` — Grida file validator
+
+CLI for validating `.grida` files and debugging parsing.
+
+```sh
+cargo run --example tool_io_grida <path-to-grida-file>
+```
+
+Validates file structure, reports node counts and types, and surfaces decode errors. See [examples/tool_io_grida.rs](./examples/tool_io_grida.rs) for full documentation.
+
+## Package docs
+
+```sh
+cargo doc --package cg --open --no-deps
+```