# Dimentra3D

**Dimentra3D is a new language.** Rustba is retired as a starting point: its
programs and playground are preserved as references for concepts and migration
research, not as syntax Dimentra3D promises to accept.

Dimentra3D's intended home is one typed system for mobile interaction,
hardware-aware effects, Petri-flow, synthesis, mathematical geometry,
materials, light, shaders, and state-aware identity. It is designed to
eventually compile to efficient native/GPU backends. Better performance is a
goal that must be proved with benchmarks; parsing itself provides no speedup.

## What exists

- `SPEC.md` defines the independent v0.1 grammar and clearly marks future
  compiler/runtime features.
- `ASSISTANT-ROADMAP.md` is the implementation guide for assistants: it explains
  the current parser-only boundary and gives staged criteria for a typed
  frontend, real compiler, mathematical renderer and additional targets.
- `RENDERER-ROADMAP.md` focuses on connecting Dimentra3D scenes to the existing
  mathematical CPU renderer and on a bounded, local-only Android preview.
- `dimentra3d.js` is the canonical dependency-free parser shared by Node and
  the browser. It never evaluates source or invokes host actions.
- `dimentra3d-render.js` is an experimental, bounded renderer path: it lowers
  the sample's icosphere scene subset into typed in-memory Scene IR and uses
  the existing mathematical CPU rasterizer. It is not a general compiler or
  production renderer.
- `examples/*.dimentra` demonstrate the new syntax for mobile, geometry,
  materials, identity, shaders, resource effects, Petri flow and synthesis.
- `references/rustba/` preserves byte-identical shipped source programs.
- `SOURCES.md` maps each archive source to the new design and records hashes.
- `playground.html` uses the real shared parser; it prints an AST and
  diagnostics without executing the program.
- `android-preview.html` is a local browser/WebView preview for the supported
  scene subset. The standalone
  [Android prototype](android/README.md) includes a Gradle-free APK build
  script; an APK/device build has not yet been verified.
- `ASSISTANT-ROADMAP.md` guides the language's staged expansion;
  `RENDERER-ROADMAP.md` covers the mathematical renderer and mobile targets.

Run the parser conformance tests:

```powershell
node --test workshop\dimentra3d\dimentra3d.test.cjs
```

Not implemented yet: a general compiler, GPU/native renderer, runtime effects,
full expression type checking, screen layout, Petri scheduler,
material/shader execution, native mobile integration, performance measurements,
or ROM generation. The CPU/mobile preview supports only a bounded subset and
does not imply any of those capabilities.
