🎬

A precompiler for
Roku/BrightScript/SceneGraph

Declarative field/derived bindings that compile straight to SceneGraph onChange handlers — no observeFieldScoped, no forceUpdate, no observer cascades.

Try the live playground GitHub

real components validated

1506

tests

diagnostics on generated .brs

field types

How it works

Validated end to end on one real component, compiled to a working SceneGraph node with generated observer wiring.

📝

.thr source

field / derived / private-public function, template markup that is always valid XML.

→

⚙️

packages/compiler

Parses with flash-parser’s own vendored BrightScript + XML grammar, adapted from kopytko-brightscript-parser but not delegated to it at parse time.

→

📄

.xml + .brs

Static SceneGraph tree, generated init()/onChange handlers — zero vdom, zero diffing.

→

📺

Real Roku device

Sideloaded and verified live — reactive fields update the screen with no hand-written observer.

Try it live

Edit the .thr source on the left — this runs the real compiler (packages/compiler) in your browser, not a canned example.

Widget.thr

compiled in your browser

<?xml version="1.0" encoding="utf-8" ?>
<component name="PlaygroundWidget" extends="Group">
  <interface>
    <field id="enabled" type="boolean" value="false" onChange="on_enabledChange" />
    <field id="label" type="string" value="&quot;Off&quot;" onChange="on_labelChange" />
    <field id="ft_routeReady" type="boolean" value="false" />
    <function name="ft_unmount" />
  </interface>
  <children>
    <Rectangle id="box" color="0x1A1A1AFF" width="200" height="60">
      <Label id="statusLabel" />
    </Rectangle>
  </children>
  <script type="text/brightscript" uri="PlaygroundWidget.brs" />
</component>

Documentation

Every shipped feature, one topic per page — syntax, a real code showcase, and what's not (yet) supported. This is a knowingly narrow subset of the target flash-theater language — enough to validate the architecture end to end before investing in the rest.

🚀

Getting started

Project layout, the <component> root tag, and the compile CLI.

🔄

Reactive state

field / derived / state, the global store, read/watch.

🧮

Statements & expressions

if/else, ternary, ==/!=, chain safety, loops, try/catch, anonymous functions.

🧩

Template & binding

Dynamic attributes, {#if}/{#if:destroy}, {#each}, bind:.

🎯

Focus & navigation

focusable, on:key, and the cross-component LRUD focus system.

🧭

Router

router.navigate, RouterOutlet, default-focus, the vacuum rule.

🎨

Theme

<theme-template>/<theme>, bare theme.a.b access, switchTheme.

🏛️

Classes (.flsh)

Reusable BrightScript-only logic: extends, override, super.

📡

Streams

Per-instance pub-sub between objects inside one component.

⚙️

Task manager

taskManager.run/cancel, priority queues, alerting, onResult.

🌐

Requests

request Http {}, response caching, safe build/parse hooks.

⏱️

Timer statements

setTimeout/setInterval/clearTimeout/clearInterval — JS-shaped Timer sugar.

🎬

Animation

animation {} declarations, transition:/in:/out:, animate:.

📐

Scale

Design-resolution-aware scaling for numbers, arrays, and AAs.

🌎

Environments

env.<name>, environments/<name>.config.json, manifestOverrides, --env.

Full status: docs/features.md. Exact grammar: GRAMMAR.md.

Packages

Two npm packages, published separately — the parser and the compiler built on top of it.

🧬

v0.0.1

flash-parser

A lossless CST + typed AST parser for the flash-theater DSL, plus a full vendored BrightScript/XML grammar.

⚙️