oriverse-engine 0.1.2 → 0.1.3

package/LICENSE.md

@@ -1,30 +1,30 @@
-# Oriverse Artifact Bundle License
-
-> PLACEHOLDER — review with legal counsel before the first `npm publish`.
-
-Copyright (c) 2026 Oriverse. All rights reserved.
-
-This package contains a compiled, proprietary build of the Oriverse engine
-("the Bundle"). No source code is included or licensed.
-
-Permission is hereby granted, free of charge and royalty-free, to any person
-obtaining a copy of the Bundle to:
-
-1. Use the Bundle to run and serve games and applications, commercial or
-   non-commercial.
-2. Redistribute the Bundle **unmodified** (including via CDNs such as unpkg,
-   bundlers, or by copying the `dist/` files alongside your game), provided this
-   license file accompanies any standalone redistribution of the Bundle.
-
-The following are NOT permitted:
-
-- Modifying, decompiling, disassembling, or reverse-engineering the Bundle,
-  except to the extent such restriction is prohibited by applicable law.
-- Redistributing modified versions of the Bundle.
-- Representing the Bundle as your own work or removing copyright notices.
-
-THE BUNDLE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY ARISING FROM THE USE OF THE BUNDLE.
+# Oriverse Artifact Bundle License
+
+> PLACEHOLDER — review with legal counsel before the first `npm publish`.
+
+Copyright (c) 2026 Oriverse. All rights reserved.
+
+This package contains a compiled, proprietary build of the Oriverse engine
+("the Bundle"). No source code is included or licensed.
+
+Permission is hereby granted, free of charge and royalty-free, to any person
+obtaining a copy of the Bundle to:
+
+1. Use the Bundle to run and serve games and applications, commercial or
+   non-commercial.
+2. Redistribute the Bundle **unmodified** (including via CDNs such as unpkg,
+   bundlers, or by copying the `dist/` files alongside your game), provided this
+   license file accompanies any standalone redistribution of the Bundle.
+
+The following are NOT permitted:
+
+- Modifying, decompiling, disassembling, or reverse-engineering the Bundle,
+  except to the extent such restriction is prohibited by applicable law.
+- Redistributing modified versions of the Bundle.
+- Representing the Bundle as your own work or removing copyright notices.
+
+THE BUNDLE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY ARISING FROM THE USE OF THE BUNDLE.

package/dist/AGENT_ONBOARDING.md

@@ -1,74 +1,74 @@
-# Oriverse artifact package — agent onboarding
-
-This folder is a self-contained, offline, single-player build of the Oriverse engine.
-It runs without SharedArrayBuffer, web workers, or any network access, so it can be
-served by any dumb static file server — no COOP/COEP headers needed.
-
-## Quick start
-
-1. Serve this folder:
-
-```bash
-python -m http.server 8000
-```
-
-2. Open `http://localhost:8000/game.html` in a WebGPU-capable browser (Chrome/Edge,
-   or iOS Safari with the WebGPU feature flag enabled).
-
-No server at all: `oriverse_single_game.html` is the same engine + world in ONE
-self-contained file (wasm embedded as base64, zero fetches) — double-click it to run
-via `file://` (a secure context in Chrome, so WebGPU works there too).
-
-## Authoring a game
-
-Edit `game.html` and replace the Weave source inside:
-
-```html
-<script type="text/weave" id="oriverse-weave"> ...your world... </script>
-```
-
-(Alternatives: set `window.ORIVERSE_ARTIFACT_WEAVE` to a string before the module
-script runs, or omit the tag entirely and call the typed export
-`bootOriverseArtifact(weaveSource)` once after `initOriverse(...)` resolves — with no
-inline Weave present the engine waits for that call instead of auto-booting.)
-
-For game-making patterns and three complete engine-tested example games, read
-`GAME_AUTHORING.md` (npm package `dist/`; examples also under `dist/examples/`).
-
-Rules for artifact worlds:
-
-- Content must be fully procedural. Allowed: primitive models (`"cube"`, `"sphere"`, ...),
-  `#mesh` clauses (procedural mesh DSL), `#texture` clauses (procedural texture DSL,
-  `baked.*` urls), `#particles` clauses, and triplanar materials.
-- `color = (r, g, b)` channels are 0-1 floats (or `#RRGGBB` hex). Values above 1 clamp
-  to 1.0 per channel, so 0-255 style colors silently render as untinted white.
-- The game boots directly into play mode (no editor). WASD moves the player: if your
-  world has no `#class player ... #end` block, the engine injects the default
-  third-person controller (camera-relative move + Space jump). Define `#class player`
-  yourself to override movement/camera (see `weave_documentation.txt`).
-- Market assets (`Ori.model.*`, `Ori.image.*`, fonts from the network, ...) are NOT
-  available. Any runtime HTTP request hard-errors with `[artifact][zero-fetch]`.
-- The world is built once at boot from the inline Weave; a load error is fatal and shows
-  in the status banner / browser console.
-
-The Weave language reference is in `weave_documentation.txt` in this folder.
-
-## Package contents
-
-- `game.html` — template page with inline Weave (this is the file you author). The default
-  world is injected from `default_world.weave` at packaging time and compile-tested natively.
-- `oriverse_single_game.html` — single-file variant of the same game (edit the same
-  `#oriverse-weave` block inside it); runs from `file://` or any static server.
-- `oriverse_wgpu.js` / `oriverse_wgpu_bg.wasm` — engine glue + wasm (single-threaded,
-  non-shared memory).
-- `ktx_lib.js` / `ktx_lib.wasm` / `ktx_bridge.js` — KTX2 texture transcoder sidecar
-  (loaded as classic scripts; the one non-module exception).
-- `weave_documentation.txt` — Weave language + API reference.
-
-## How it works (for the curious)
-
-The engine runs its normal deterministic client simulation, but instead of a network
-relay it talks to an in-process loopback relay: your inputs are packed into real relay
-wire packets, merged one frame per tick, and fed back through the production frame
-reader. The whole sim runs on the browser main thread (fixed-step accumulator inside
-requestAnimationFrame, with a small catch-up cap).
+# Oriverse artifact package — agent onboarding
+
+This folder is a self-contained, offline, single-player build of the Oriverse engine.
+It runs without SharedArrayBuffer, web workers, or any network access, so it can be
+served by any dumb static file server — no COOP/COEP headers needed.
+
+## Quick start
+
+1. Serve this folder:
+
+```bash
+python -m http.server 8000
+```
+
+2. Open `http://localhost:8000/game.html` in a WebGPU-capable browser (Chrome/Edge,
+   or iOS Safari with the WebGPU feature flag enabled).
+
+No server at all: `oriverse_single_game.html` is the same engine + world in ONE
+self-contained file (wasm embedded as base64, zero fetches) — double-click it to run
+via `file://` (a secure context in Chrome, so WebGPU works there too).
+
+## Authoring a game
+
+Edit `game.html` and replace the Weave source inside:
+
+```html
+<script type="text/weave" id="oriverse-weave"> ...your world... </script>
+```
+
+(Alternatives: set `window.ORIVERSE_ARTIFACT_WEAVE` to a string before the module
+script runs, or omit the tag entirely and call the typed export
+`bootOriverseArtifact(weaveSource)` once after `initOriverse(...)` resolves — with no
+inline Weave present the engine waits for that call instead of auto-booting.)
+
+For game-making patterns and three complete engine-tested example games, read
+`GAME_AUTHORING.md` (npm package `dist/`; examples also under `dist/examples/`).
+
+Rules for artifact worlds:
+
+- Content must be fully procedural. Allowed: primitive models (`"cube"`, `"sphere"`, ...),
+  `#mesh` clauses (procedural mesh DSL), `#texture` clauses (procedural texture DSL,
+  `baked.*` urls), `#particles` clauses, and triplanar materials.
+- `color = (r, g, b)` channels are 0-1 floats (or `#RRGGBB` hex). Values above 1 clamp
+  to 1.0 per channel, so 0-255 style colors silently render as untinted white.
+- The game boots directly into play mode (no editor). WASD moves the player: if your
+  world has no `#class player ... #end` block, the engine injects the default
+  third-person controller (camera-relative move + Space jump). Define `#class player`
+  yourself to override movement/camera (see `weave_documentation.txt`).
+- Market assets (`Ori.model.*`, `Ori.image.*`, fonts from the network, ...) are NOT
+  available. Any runtime HTTP request hard-errors with `[artifact][zero-fetch]`.
+- The world is built once at boot from the inline Weave; a load error is fatal and shows
+  in the status banner / browser console.
+
+The Weave language reference is in `weave_documentation.txt` in this folder.
+
+## Package contents
+
+- `game.html` — template page with inline Weave (this is the file you author). The default
+  world is injected from `default_world.weave` at packaging time and compile-tested natively.
+- `oriverse_single_game.html` — single-file variant of the same game (edit the same
+  `#oriverse-weave` block inside it); runs from `file://` or any static server.
+- `oriverse_wgpu.js` / `oriverse_wgpu_bg.wasm` — engine glue + wasm (single-threaded,
+  non-shared memory).
+- `ktx_lib.js` / `ktx_lib.wasm` / `ktx_bridge.js` — KTX2 texture transcoder sidecar
+  (loaded as classic scripts; the one non-module exception).
+- `weave_documentation.txt` — Weave language + API reference.
+
+## How it works (for the curious)
+
+The engine runs its normal deterministic client simulation, but instead of a network
+relay it talks to an in-process loopback relay: your inputs are packed into real relay
+wire packets, merged one frame per tick, and fed back through the production frame
+reader. The whole sim runs on the browser main thread (fixed-step accumulator inside
+requestAnimationFrame, with a small catch-up cap).

package/dist/CODEX_PROMPT.md

@@ -53,15 +53,15 @@ object BlueCube {
   </script>
   <!-- ==== END OF EDITABLE BLOCK ==== -->
 
-  <script src="https://unpkg.com/oriverse-engine@0.1.2/dist/ktx_lib.js"></script>
-  <script src="https://unpkg.com/oriverse-engine@0.1.2/dist/ktx_bridge.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.3/dist/ktx_lib.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.3/dist/ktx_bridge.js"></script>
   <script type="module">
-    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.2/dist/oriverse_wgpu.js";
+    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.3/dist/oriverse_wgpu.js";
     const setBoot = (t) => { const b = document.getElementById('oriverse-status-banner'); if (b) b.textContent = t; };
     (async () => {
       try {
         setBoot('instantiating wasm...');
-        await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.2/dist/oriverse_wgpu_bg.wasm" });
+        await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.3/dist/oriverse_wgpu_bg.wasm" });
       } catch (e) {
         setBoot('WASM init failed:\n' + ((e && e.stack) ? e.stack : String(e)));
         console.error('[wasm_boot] initOriverse failed:', e);
@@ -96,9 +96,9 @@ Rules — the engine hard-errors if you break the first two:
 Authoritative references, served next to the engine (fetch if you can — the authoring
 guide contains three complete tested example games to pattern-match from):
 
-- https://unpkg.com/oriverse-engine@0.1.2/dist/GAME_AUTHORING.md  <- game patterns + 3 full example games
-- https://unpkg.com/oriverse-engine@0.1.2/dist/weave_documentation.txt  <- full language + API reference
-- https://unpkg.com/oriverse-engine@0.1.2/dist/examples/coin_collector.weave (also dodge_blocks / target_range)
+- https://unpkg.com/oriverse-engine@0.1.3/dist/GAME_AUTHORING.md  <- game patterns + 3 full example games
+- https://unpkg.com/oriverse-engine@0.1.3/dist/weave_documentation.txt  <- full language + API reference
+- https://unpkg.com/oriverse-engine@0.1.3/dist/examples/coin_collector.weave (also dodge_blocks / target_range)
 
 ## Step 3: test
 

package/dist/examples/coin_collector.weave

@@ -1,70 +1,70 @@
-// Coin Collector — walk into the 10 spinning coins to collect them all. Press R to replay.
-// Demonstrates: saved objects + runtime spawning, tags, proximity pickup, HUD score text,
-// win + restart flow. Movement uses the engine's default player controller (no #class player).
-
-#class Coin
-event OnPreSpawn {
-    AddTag(Tag.Coin)
-}
-event OnSpawned {
-    forever {
-        RotateLeftInstantly(4)
-        var p = NearestPlayer()
-        if p.Exists() and SurfaceGapTo(p) < 70 {
-            p.SpawnFloatingText("+1", Vector(1, 0.9, 0.2))
-            Destroy()
-        }
-    }
-}
-#end
-
-#class GameManager
-var TotalCoins = 10
-var SeenCoins = false
-event OnSpawned {
-    for i in 0..TotalCoins {
-        var pos = Position(RandomNumber(-1400, 1400), RandomNumber(-1400, 1400), 80)
-        SpawnObject(SavedObject.coin, pos)
-    }
-    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
-    var midLabel = ResolveObjectByNameOnce("MidText")
-    forever {
-        // Spawned coins register their tag on the next tick, so wait until the census
-        // has seen at least one coin before treating "0 left" as a win.
-        var left = GetAllObjectsWithTag(Tag.Coin).Count()
-        var collected = TotalCoins - left
-        scoreLabel.SetText("Coins: " + collected + " / " + TotalCoins)
-        if left == 0 and collected == TotalCoins and SeenCoins {
-            midLabel.SetText("YOU WIN!  Press R to play again")
-        } else {
-            midLabel.SetText("")
-        }
-        if left > 0 {
-            SeenCoins = true
-        }
-    }
-}
-event KeyboardDown[R] {
-    RestartGame()
-}
-#end
-
-saved coin {
-    display coin : Coin { model = "cylinder" size = (60, 60, 12) rotation = (90, 0, 0) color = (1, 0.85, 0.2) }
-}
-
-object Ground {
-    model = "cube"
-    position = (0, 0, -50)
-    size = (4000, 4000, 100)
-    color = (0.32, 0.5, 0.34)
-}
-object PillarA { position = (400, 400, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-object PillarB { position = (-600, 300, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-object PillarC { position = (200, -700, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-display manager : GameManager { visible = false }
-
-screenCanvas HUD {
-    textLabel ScoreText { offset = (20, 20) text = "Coins: 0 / 10" color = (1, 1, 0.85) }
-    textLabel MidText { align = (center, center) text = "" color = (1, 1, 0.3) }
-}
+// Coin Collector — walk into the 10 spinning coins to collect them all. Press R to replay.
+// Demonstrates: saved objects + runtime spawning, tags, proximity pickup, HUD score text,
+// win + restart flow. Movement uses the engine's default player controller (no #class player).
+
+#class Coin
+event OnPreSpawn {
+    AddTag(Tag.Coin)
+}
+event OnSpawned {
+    forever {
+        RotateLeftInstantly(4)
+        var p = NearestPlayer()
+        if p.Exists() and SurfaceGapTo(p) < 70 {
+            p.SpawnFloatingText("+1", Vector(1, 0.9, 0.2))
+            Destroy()
+        }
+    }
+}
+#end
+
+#class GameManager
+var TotalCoins = 10
+var SeenCoins = false
+event OnSpawned {
+    for i in 0..TotalCoins {
+        var pos = Position(RandomNumber(-1400, 1400), RandomNumber(-1400, 1400), 80)
+        SpawnObject(SavedObject.coin, pos)
+    }
+    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
+    var midLabel = ResolveObjectByNameOnce("MidText")
+    forever {
+        // Spawned coins register their tag on the next tick, so wait until the census
+        // has seen at least one coin before treating "0 left" as a win.
+        var left = GetAllObjectsWithTag(Tag.Coin).Count()
+        var collected = TotalCoins - left
+        scoreLabel.SetText("Coins: " + collected + " / " + TotalCoins)
+        if left == 0 and collected == TotalCoins and SeenCoins {
+            midLabel.SetText("YOU WIN!  Press R to play again")
+        } else {
+            midLabel.SetText("")
+        }
+        if left > 0 {
+            SeenCoins = true
+        }
+    }
+}
+event KeyboardDown[R] {
+    RestartGame()
+}
+#end
+
+saved coin {
+    display coin : Coin { model = "cylinder" size = (60, 60, 12) rotation = (90, 0, 0) color = (1, 0.85, 0.2) }
+}
+
+object Ground {
+    model = "cube"
+    position = (0, 0, -50)
+    size = (4000, 4000, 100)
+    color = (0.32, 0.5, 0.34)
+}
+object PillarA { position = (400, 400, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+object PillarB { position = (-600, 300, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+object PillarC { position = (200, -700, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+display manager : GameManager { visible = false }
+
+screenCanvas HUD {
+    textLabel ScoreText { offset = (20, 20) text = "Coins: 0 / 10" color = (1, 1, 0.85) }
+    textLabel MidText { align = (center, center) text = "" color = (1, 1, 0.3) }
+}

package/dist/examples/dodge_blocks.weave

@@ -1,70 +1,70 @@
-// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Press R to retry.
-// Demonstrates: a hidden manager object, timed spawning with Timer, dynamic physics objects,
-// cross-object variable writes (block -> manager), survival-seconds score, lose + restart flow.
-// Movement uses the engine's default player controller (no #class player).
-
-#class FallingBlock
-var LifeTmr : Timer
-event OnSpawned {
-    LifeTmr.StartCountDown(8) // despawn landed blocks so the arena stays playable
-    forever {
-        if LifeTmr.IsDone() {
-            Destroy()
-        }
-        var p = NearestPlayer()
-        if p.Exists() and SurfaceGapTo(p) < 5 {
-            NearestObjectWithTag(Tag.Manager).GameOver = true
-        }
-    }
-}
-#end
-
-#class GameManager
-var GameOver = false
-var Score = 0
-event OnPreSpawn {
-    AddTag(Tag.Manager)
-}
-event OnSpawned {
-    var secondTmr = Timer()
-    var dropTmr = Timer()
-    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
-    var midLabel = ResolveObjectByNameOnce("MidText")
-    forever {
-        if GameOver {
-            midLabel.SetText("GAME OVER — survived " + Score + " s. Press R to retry")
-            continue
-        }
-        if secondTmr.IsDone() {
-            secondTmr.StartCountDown(1)
-            Score += 1
-            scoreLabel.SetText("Survived: " + Score + " s")
-        }
-        if dropTmr.IsDone() {
-            dropTmr.StartCountDown(0.35)
-            var pos = Position(RandomNumber(-900, 900), RandomNumber(-900, 900), 1300)
-            SpawnObject(SavedObject.block, pos)
-        }
-    }
-}
-event KeyboardDown[R] {
-    RestartGame()
-}
-#end
-
-saved block {
-    physics block : FallingBlock { model = "cube" size = (120, 120, 120) color = (0.85, 0.25, 0.2) }
-}
-
-object Ground {
-    model = "cube"
-    position = (0, 0, -50)
-    size = (2200, 2200, 100)
-    color = (0.4, 0.42, 0.5)
-}
-display manager : GameManager { visible = false }
-
-screenCanvas HUD {
-    textLabel ScoreText { offset = (20, 20) text = "Survived: 0 s" color = (1, 1, 1) }
-    textLabel MidText { align = (center, center) text = "" color = (1, 0.45, 0.35) }
-}
+// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Press R to retry.
+// Demonstrates: a hidden manager object, timed spawning with Timer, dynamic physics objects,
+// cross-object variable writes (block -> manager), survival-seconds score, lose + restart flow.
+// Movement uses the engine's default player controller (no #class player).
+
+#class FallingBlock
+var LifeTmr : Timer
+event OnSpawned {
+    LifeTmr.StartCountDown(8) // despawn landed blocks so the arena stays playable
+    forever {
+        if LifeTmr.IsDone() {
+            Destroy()
+        }
+        var p = NearestPlayer()
+        if p.Exists() and SurfaceGapTo(p) < 5 {
+            NearestObjectWithTag(Tag.Manager).GameOver = true
+        }
+    }
+}
+#end
+
+#class GameManager
+var GameOver = false
+var Score = 0
+event OnPreSpawn {
+    AddTag(Tag.Manager)
+}
+event OnSpawned {
+    var secondTmr = Timer()
+    var dropTmr = Timer()
+    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
+    var midLabel = ResolveObjectByNameOnce("MidText")
+    forever {
+        if GameOver {
+            midLabel.SetText("GAME OVER — survived " + Score + " s. Press R to retry")
+            continue
+        }
+        if secondTmr.IsDone() {
+            secondTmr.StartCountDown(1)
+            Score += 1
+            scoreLabel.SetText("Survived: " + Score + " s")
+        }
+        if dropTmr.IsDone() {
+            dropTmr.StartCountDown(0.35)
+            var pos = Position(RandomNumber(-900, 900), RandomNumber(-900, 900), 1300)
+            SpawnObject(SavedObject.block, pos)
+        }
+    }
+}
+event KeyboardDown[R] {
+    RestartGame()
+}
+#end
+
+saved block {
+    physics block : FallingBlock { model = "cube" size = (120, 120, 120) color = (0.85, 0.25, 0.2) }
+}
+
+object Ground {
+    model = "cube"
+    position = (0, 0, -50)
+    size = (2200, 2200, 100)
+    color = (0.4, 0.42, 0.5)
+}
+display manager : GameManager { visible = false }
+
+screenCanvas HUD {
+    textLabel ScoreText { offset = (20, 20) text = "Survived: 0 s" color = (1, 1, 1) }
+    textLabel MidText { align = (center, center) text = "" color = (1, 0.45, 0.35) }
+}