# Codebase Map

> Auto-generated by Space Operator Context extension.
> Links are relative — click to navigate to source files.

## Project Structure

- **[bench/](../../bench/)** 
  - [benches/](../../bench/benches/)
  - [Cargo.toml](../../bench/Cargo.toml)
  - [src/](../../bench/src/)
- [BITSTREAM_INTEGRATION.md](../../BITSTREAM_INTEGRATION.md)
- [Cargo.lock](../../Cargo.lock)
- [Cargo.toml](../../Cargo.toml)
- [CHANGELOG.md](../../CHANGELOG.md)
- [cliff.toml](../../cliff.toml)
- **[compiler/](../../compiler/)** 
  - [ds-analyzer/](../../compiler/ds-analyzer/)
  - [ds-cli/](../../compiler/ds-cli/)
  - [ds-codegen/](../../compiler/ds-codegen/)
  - [ds-incremental/](../../compiler/ds-incremental/)
  - [ds-layout/](../../compiler/ds-layout/)
  - [ds-parser/](../../compiler/ds-parser/)
  - [ds-types/](../../compiler/ds-types/)
- **[devices/](../../devices/)** 
  - [panel-preview/](../../devices/panel-preview/)
  - [waveshare-p4-panel/](../../devices/waveshare-p4-panel/)
- **[docs/](../)** — Project documentation
  - [explorations.md](../explorations.md)
  - [fabric-display-build-guide.md](../fabric-display-build-guide.md)
  - [fabric-display-overview.md](../fabric-display-overview.md)
  - [generated/](/)
  - [integration.md](../integration.md)
  - [panel-ir-spec.md](../panel-ir-spec.md)
- [DREAMSTACK.md](../../DREAMSTACK.md)
- **[engine/](../../engine/)** 
  - [ds-physics/](../../engine/ds-physics/)
  - [ds-screencast/](../../engine/ds-screencast/)
  - [ds-stream/](../../engine/ds-stream/)
  - [ds-stream-wasm/](../../engine/ds-stream-wasm/)
- **[examples/](../../examples/)** 
  - [beats-viewer.ds](../../examples/beats-viewer.ds)
  - [bench-signals.ds](../../examples/bench-signals.ds)
  - [benchmarks.html](../../examples/benchmarks.html)
  - [builtins.ds](../../examples/builtins.ds)
  - [callback-demo.ds](../../examples/callback-demo.ds)
  - [component-gallery.ds](../../examples/component-gallery.ds)
  - [compose-dashboard.ds](../../examples/compose-dashboard.ds)
  - [compose-master.ds](../../examples/compose-master.ds)
  - [compose-metrics.ds](../../examples/compose-metrics.ds)
  - [compose-search-map.ds](../../examples/compose-search-map.ds)
  - [compose-widgets.ds](../../examples/compose-widgets.ds)
  - [counter.ds](../../examples/counter.ds)
  - [dashboard.ds](../../examples/dashboard.ds)
  - [dashboard.html](../../examples/dashboard.html)
  - [each-demo.ds](../../examples/each-demo.ds)
  - [form.ds](../../examples/form.ds)
  - [game-breakout.ds](../../examples/game-breakout.ds)
  - [game-pong.ds](../../examples/game-pong.ds)
  - [game-pong.html](../../examples/game-pong.html)
  - [game-reaction.ds](../../examples/game-reaction.ds)
- [IMPLEMENTATION_PLAN.md](../../IMPLEMENTATION_PLAN.md)
- **[pkg/](../../pkg/)** 
  - [ds-stream-wasm/](../../pkg/ds-stream-wasm/)
- **[registry/](../../registry/)** 
  - [components/](../../registry/components/)
  - [registry.json](../../registry/registry.json)
- **[scripts/](../../scripts/)** 
  - [release.sh](../../scripts/release.sh)
- **[sdk/](../../sdk/)** 
  - [dreamstack-embed.js](../../sdk/dreamstack-embed.js)
- [STREAM_COMPOSITION.md](../../STREAM_COMPOSITION.md)
- [TODO.md](../../TODO.md)
- [USE_CASES.md](../../USE_CASES.md)

## Rust Dependencies (Key Crates)

### Local Crates
| Crate | Path |
|-------|------|
| `ds-parser` | [compiler/ds-parser](../../compiler/ds-parser) |
| `ds-analyzer` | [compiler/ds-analyzer](../../compiler/ds-analyzer) |
| `ds-codegen` | [compiler/ds-codegen](../../compiler/ds-codegen) |
| `ds-layout` | [compiler/ds-layout](../../compiler/ds-layout) |
| `ds-types` | [compiler/ds-types](../../compiler/ds-types) |
| `ds-incremental` | [compiler/ds-incremental](../../compiler/ds-incremental) |
| `ds-physics` | [engine/ds-physics](../../engine/ds-physics) |
| `ds-stream` | [engine/ds-stream](../../engine/ds-stream) |
| `ds-stream-wasm` | [engine/ds-stream-wasm](../../engine/ds-stream-wasm) |


## Tauri Backend Modules


## Frontend (p2p-ui)

React + TypeScript desktop UI built with Tauri.

### Key Pages
| Page | Description |
|------|-------------|
| ConnectionPage | Connect to a remote Space Operator server |
| ProviderPage | Register as a P2P compute provider |
| LocalServerPage | Run an embedded flow backend locally |
| CommandsPage | Browse and test registered flow commands |
| NodeDevPage | Develop and test new nodes |
| KeypairsPage | Manage Solana keypairs |
| DiscoveryPage | P2P network node discovery |

## Flow Backend

The flow engine (git submodule) provides:
- **flow** — Core flow graph execution engine
- **flow-lib** — Shared types: `CommandTrait`, `Value`, `CommandContext`
- **flow-rpc** — Cap'n Proto RPC for distributed node execution
- **cmds-std** — Standard nodes: HTTP, JSON, string ops, storage, KV store
- **cmds-solana** — Solana blockchain nodes: token ops, DeFi, NFT, governance
- **cmds-deno** — JavaScript/TypeScript node runtime via Deno
- **rhai-script** — Rhai scripting language nodes
