@auraindustry/aurajs 0.0.7 → 0.1.0

package/README.md

@@ -13,22 +13,118 @@ cd my-game
 npm run dev
 ```
 
+One-off bootstrap without a global install:
+
+```bash
+npx auramaxx
+```
+
+Scaffolded projects also expose the shorter `aura` alias for in-project engine
+commands.
+
+## Local-First Dev Loop
+
+AuraJS currently leads with the scaffolded native loop:
+
+```bash
+cd my-game
+npm run dev
+```
+
+When you want the live developer session surface in parallel with the native
+window, stay in the same project wrapper:
+
+```bash
+npm run state -- export --session <session-id> --compact
+npm run inspect -- export --session <session-id> --compact
+npm run action -- schema --session <session-id> --compact
+```
+
+Generated projects wire those commands through `bin/play.js`. Raw `aura dev`
+still exists as the engine command, but it is no longer the public first step
+for a new local project.
+
+The same native play lane also exposes `aura play` / `npm run play` for the
+foreground live-session loop. Press `F1` in that runtime to open the dev-only
+playtest HUD, jump between authored scenes, and use the compact record,
+screenshot, restart, pause, and minimize controls.
+
+This wrapper-driven native lane is the current product center for `aura dev`. Browser rebuilds exist, but
+they are a secondary surface in this stage rather than the default authoring
+loop.
+
+## Room-Code Multiplayer
+
+The public first stop is the single-project local-first starter:
+
+```bash
+auramaxx create my-room-game --template multiplayer
+cd my-room-game
+npm run dev
+
+# second terminal
+npm run join -- AURA2P
+```
+
+Fastest internet-backed upgrade for the same starter:
+
+```bash
+AURA_MULTIPLAYER_RELAY_HOST=relay.aurajs.gg npm run dev
+AURA_MULTIPLAYER_RELAY_HOST=relay.aurajs.gg npm run join -- AURA2P
+```
+
+The lower-level proof path is still two native `aura dev --session`
+processes on one machine using a room code. See:
+
+- [`../../docs/local-multiplayer-dev-playbook.md`](../../docs/local-multiplayer-dev-playbook.md)
+- [`../../examples/README.md`](../../examples/README.md)
+
 ## Publish And Play
 
 In a scaffolded AuraJS game:
 
 ```bash
+aura publish --dry-run
 npm run publish
 npm run play
+npx <game> fork ./mygame-local
 ```
 
-`npm run publish` maps to `npx auramaxx publish` in generated projects.
+`aura publish` is the canonical npm-first publish command. In generated projects,
+`npm run publish` delegates to the same engine-owned lane, which then dispatches
+to `npm publish` with scoped packages defaulting to public access. The dry-run
+lane validates the native build contract first and writes
+`.aura/publish/publish-report.json` before dispatch. Change `package.json -> name`
+first if you are publishing outside the `@aurajs` scope.
+
+Raw `npm publish` remains available as an escape hatch, but it is not the
+engine-owned product path for this stage and does not replace the publish
+report/validation contract.
 
-## API Surfaces
+Published game wrappers also expose `fork`, which copies the installed package
+surface into a new local directory for editing. After `npx <game> fork
+./mygame-local`, run `npm install` inside the fork before starting `npm run
+dev`.
 
+## Secondary API Surfaces
+
+- Cutscene/media helpers: `@auraindustry/aurajs/cutscene`
+- JS-first retained 3D scene helpers: `@auraindustry/aurajs/scene-composition`
+- Scene prefab and serialization helpers: `@auraindustry/aurajs/prefabs`
+- Shader kits over custom materials: `@auraindustry/aurajs/shader-kits`
 - React embedding: `@auraindustry/aurajs/react`
 - Web runtime helpers: `@auraindustry/aurajs/web`
 
+These package surfaces stay available, but native local development is the
+priority path in the current stage and browser work remains secondary.
+
+Current media truth:
+
+- native desktop `.mp4` playback is supported through `aura.video` and the
+  cutscene helpers
+- browser `.mp4` parity is not part of the current contract
+- frame sequences or sprite sheets remain the portable fallback
+
 ## Docs
 
 - Repo README: <https://github.com/Aura-Industry/auramaxx>

package/benchmarks/perf-thresholds.json

@@ -40,6 +40,24 @@
       "maxP95FrameTimeMs": 36,
       "maxP99FrameTimeMs": 48,
       "maxStutterBurstCount": 12
+    },
+    "ui_composition_surface_stress": {
+      "maxAvgFrameTimeMs": 26,
+      "maxJitterMs": 10,
+      "minFps": 24,
+      "maxP50FrameTimeMs": 26,
+      "maxP95FrameTimeMs": 38,
+      "maxP99FrameTimeMs": 50,
+      "maxStutterBurstCount": 12
+    },
+    "ui_masking_compositor_fx_stress": {
+      "maxAvgFrameTimeMs": 28,
+      "maxJitterMs": 11,
+      "minFps": 22,
+      "maxP50FrameTimeMs": 28,
+      "maxP95FrameTimeMs": 42,
+      "maxP99FrameTimeMs": 54,
+      "maxStutterBurstCount": 14
     }
   },
   "coldStart": {
@@ -79,6 +97,24 @@
         "maxP95FrameTimeMs": 44,
         "maxP99FrameTimeMs": 56,
         "maxStutterBurstCount": 3
+      },
+      "ui_composition_surface_stress": {
+        "maxAvgFrameTimeMs": 34,
+        "maxJitterMs": 12,
+        "minFps": 20,
+        "maxP50FrameTimeMs": 34,
+        "maxP95FrameTimeMs": 46,
+        "maxP99FrameTimeMs": 58,
+        "maxStutterBurstCount": 3
+      },
+      "ui_masking_compositor_fx_stress": {
+        "maxAvgFrameTimeMs": 36,
+        "maxJitterMs": 13,
+        "minFps": 18,
+        "maxP50FrameTimeMs": 36,
+        "maxP95FrameTimeMs": 50,
+        "maxP99FrameTimeMs": 62,
+        "maxStutterBurstCount": 4
       }
     }
   },
@@ -119,6 +155,24 @@
         "maxP95FrameTimeMs": 32,
         "maxP99FrameTimeMs": 40,
         "maxStutterBurstCount": 10
+      },
+      "ui_composition_surface_stress": {
+        "maxAvgFrameTimeMs": 24,
+        "maxJitterMs": 8,
+        "minFps": 28,
+        "maxP50FrameTimeMs": 24,
+        "maxP95FrameTimeMs": 34,
+        "maxP99FrameTimeMs": 42,
+        "maxStutterBurstCount": 10
+      },
+      "ui_masking_compositor_fx_stress": {
+        "maxAvgFrameTimeMs": 26,
+        "maxJitterMs": 9,
+        "minFps": 26,
+        "maxP50FrameTimeMs": 26,
+        "maxP95FrameTimeMs": 38,
+        "maxP99FrameTimeMs": 46,
+        "maxStutterBurstCount": 12
       }
     }
   },

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@auraindustry/aurajs",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "Write games in JavaScript, build native binaries.",
   "type": "module",
   "exports": {
     "./cutscene": "./src/cutscene.mjs",
+    "./scene-composition": "./src/scene-composition/index.mjs",
+    "./prefabs": "./src/prefabs/index.mjs",
+    "./shader-kits": "./src/shader-kits/index.mjs",
     "./react": "./src/react/index.mjs",
     "./web": "./src/web-api.mjs",
     "./package.json": "./package.json"
@@ -37,12 +40,6 @@
     "react": "^18.3.1",
     "react-test-renderer": "^18.3.1"
   },
-  "optionalDependencies": {
-    "@aurajs/darwin-arm64": "github:Aura-Industry/aurajs-darwin-arm64",
-    "@aurajs/darwin-x64": "github:Aura-Industry/aurajs-darwin-x64",
-    "@aurajs/linux-x64": "github:Aura-Industry/aurajs-linux-x64",
-    "@aurajs/win32-x64": "github:Aura-Industry/aurajs-win32-x64"
-  },
   "keywords": [
     "game",
     "gamedev",

package/src/asset-pack.mjs

@@ -18,6 +18,9 @@ const SUPPORTED = {
   wav: 'audio',
   ogg: 'audio',
   mp3: 'audio',
+  mp4: 'video',
+  gltf: 'model',
+  glb: 'model',
   ttf: 'font',
   otf: 'font',
   json: 'json',
@@ -38,7 +41,8 @@ const SUPPORTED = {
 
 const APPROVED_FORMATS = [
   '.png', '.jpg', '.jpeg',
-  '.wav', '.ogg', '.mp3',
+  '.wav', '.ogg', '.mp3', '.mp4',
+  '.gltf', '.glb',
   '.ttf', '.otf',
   '.json',
   '.txt', '.csv', '.xml', '.toml', '.yaml', '.yml', '.ini', '.cfg', '.log', '.md',