starlight-cli 1.1.1 → 1.1.3

package/README.md

@@ -237,7 +237,53 @@ server()
 ```
 
 ---
+## Start & Race Statements
 
+Starlight includes a **`start` / `race`** control structure similar to JavaScript `switch`, with **fall-through behavior**. The `start` statement evaluates a discriminant expression and executes all `race` clauses **starting from the first match** until the end, unless a `break` is used.
+
+### Syntax
+
+```
+start (<discriminant>) {
+race (<value>) {
+# body
+}
+
+race (<value>) {
+# body
+}
+
+```
+
+
+
+- `start` – evaluates the discriminant expression.
+- `race` – each clause is checked; execution starts at the first matching `race` and continues to subsequent races (fall-through).
+- Optional `break` can stop execution early (if implemented).
+
+### Example
+
+```
+define x = 2;
+
+start (x) {
+race (1) { sldeploy("Race 1 executed"); }
+race (2) { sldeploy("Race 2 executed"); }
+race (3) { sldeploy("Race 3 executed"); }
+}
+
+sldeploy("Done with start statement");
+
+```
+
+**Expected Output:**
+
+```
+Race 2 executed
+Race 3 executed
+Done with start statement
+
+```
 ## Why Starlight?
 
 Starlight is designed for developers who want: