@auraindustry/aurajs 0.1.1 → 0.1.5

package/src/web-conformance.mjs

@@ -16,15 +16,6 @@ export const DEFAULT_WEB_SMOKE_CASES = Object.freeze([
     testName: 'web loader installs browser-backed aura surface for 2d examples',
     examples: [],
   }),
-  Object.freeze({
-    id: 'web-supported-render-2d-proof-example',
-    bucket: 'supported',
-    expectation: 'supported',
-    title: 'web-render-2d-proof runs on the committed advanced draw2d browser floor',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: web-render-2d-proof runs on the committed advanced draw2d browser floor',
-    examples: ['examples/web-render-2d-proof'],
-  }),
   Object.freeze({
     id: 'web-partial-auramon-example',
     bucket: 'partial',
@@ -34,33 +25,6 @@ export const DEFAULT_WEB_SMOKE_CASES = Object.freeze([
     testName: 'web loader browser smoke: auramon runs on the supported 2d subset with input and resize evidence',
     examples: ['examples/auramon'],
   }),
-  Object.freeze({
-    id: 'web-supported-starter-3d-example',
-    bucket: 'supported',
-    expectation: 'supported',
-    title: 'starter-3d runs on the committed browser 3d floor',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: starter-3d runs on the committed browser 3d floor',
-    examples: ['examples/starter-3d'],
-  }),
-  Object.freeze({
-    id: 'web-unsupported-multiplayer-examples',
-    bucket: 'unsupported',
-    expectation: 'unsupported',
-    title: 'multiplayer examples fail before setup with stable capability diagnostics',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: multiplayer examples fail before setup with stable capability diagnostics',
-    examples: ['examples/multiplayer-room-client', 'examples/multiplayer-room-host'],
-  }),
-  Object.freeze({
-    id: 'web-unsupported-advanced-3d-example',
-    bucket: 'unsupported',
-    expectation: 'unsupported',
-    title: 'advanced 3d examples outside the committed browser floor fail before setup with stable capability diagnostics',
-    file: DEFAULT_TEST_FILE,
-    testName: 'web loader browser smoke: advanced 3d examples still fail before setup with stable capability diagnostics',
-    examples: ['examples/custom-shader-material-proof'],
-  }),
 ]);
 
 export class WebConformanceSuiteError extends Error {

package/templates/create/2d/src/runtime/app.js

@@ -1,6 +1,7 @@
 import { createSceneRegistry } from './scene-registry.js';
 import { createProjectInspector } from './project-inspector.js';
 import { assertRuntimeCapabilities } from './capabilities.js';
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './splash.js';
 
 export function createApp() {
   const sceneRegistry = createSceneRegistry({
@@ -26,13 +27,16 @@ export function createApp() {
     },
     setup() {
       assertRuntimeCapabilities();
+      initSplash();
       activeScene()?.setup?.();
     },
     update(dt) {
+      if (isSplashActive()) { updateSplash(dt); return; }
       projectInspector.syncInput(globalThis.aura?.input || null);
       activeScene()?.update?.(dt);
     },
     draw() {
+      if (isSplashActive()) { drawSplash(); return; }
       activeScene()?.draw?.();
       projectInspector.draw({ activeSceneId });
     },

package/templates/create/2d-adventure/config/gameplay/adventure.config.js

@@ -1,14 +1,17 @@
 export const ADVENTURE_CONFIG = {
   playerSize: 28,
-  playerSpeed: 232,
-  relicRadius: 20,
-  beaconRadius: 42,
-  exitPadding: 18,
+  playerSpeed: 216,
+  pickupSize: 28,
+  checkpointSize: 48,
+  gateGlowSize: 96,
 };
 
 export const ADVENTURE_TEXT = {
   started: '{{PROJECT_TITLE}} started (2D adventure template)',
-  controls: 'Move: Arrows/WASD  Interact: E or Enter  Hint: H',
-  clearedTitle: 'RUINS SURVEY COMPLETE',
+  controls: 'Move: Arrows/WASD  Interact: E or Enter  Inventory: I or Tab  Journal: J  Hint: H',
+  inventoryControls: 'Inventory: A/D or Left/Right tabs  W/S or Up/Down items  I or Tab closes',
+  journalControls: 'Journal: A/D or Left/Right sections  W/S or Up/Down entries  J closes',
+  dialogueControls: 'Dialogue: W/S or Up/Down choices  E, Enter, or Space confirms',
+  clearedTitle: 'ARCHIVE ROUTE SECURED',
   clearedPrompt: 'Press Enter to restart the route',
 };

package/templates/create/2d-adventure/content/gameplay/dialogue.js

@@ -0,0 +1,85 @@
+export const ARCHIVE_CONSOLE_DIALOGUE_ID = 'archive-console-link';
+
+export const JOURNAL_ENTRY_IDS = Object.freeze({
+  routeBrief: 'route-brief',
+  consoleLog: 'archive-console-log',
+  moonGate: 'moon-gate-route',
+});
+
+export const JOURNAL_CATEGORIES = [
+  { id: 'route', label: 'Route' },
+  { id: 'intel', label: 'Archive Intel' },
+];
+
+export const STARTING_JOURNAL_ENTRIES = [
+  {
+    id: JOURNAL_ENTRY_IDS.routeBrief,
+    label: 'Route Brief',
+    categoryId: 'route',
+    categoryLabel: 'Route',
+    description: 'Sweep the Moon Archive, recover the route note, then reopen the Moon Gate.',
+    detail: 'The archive console should reveal the final route once the relic anchors are back online.',
+    status: 'active',
+    badge: 'Active',
+    updatedAt: 'Initial route objective',
+  },
+];
+
+export const ADVENTURE_DIALOGUES = [
+  {
+    id: ARCHIVE_CONSOLE_DIALOGUE_ID,
+    title: 'Archive Console Link',
+    speaker: 'Archivist Sol',
+    startNodeId: 'handshake',
+    nodes: [
+      {
+        id: 'handshake',
+        lines: [
+          'Moon Archive relay restored. I can mark the exit route once you choose what to review.',
+        ],
+        nextNodeId: 'prompt',
+      },
+      {
+        id: 'prompt',
+        lines: [
+          'Ask for the route or confirm what still blocks the gate.',
+        ],
+        choices: [
+          {
+            id: 'ask-route',
+            label: 'Ask for the route',
+            detail: 'Request the marked path through the lower gallery.',
+            nextNodeId: 'route',
+          },
+          {
+            id: 'ask-key',
+            label: 'Ask about the Dawn Key',
+            detail: 'Confirm what the Moon Gate still needs.',
+            nextNodeId: 'key',
+          },
+        ],
+      },
+      {
+        id: 'route',
+        lines: [
+          'The final route runs south, then doubles back to the Moon Gate once the key is recovered.',
+        ],
+        nextNodeId: 'briefing',
+      },
+      {
+        id: 'key',
+        lines: [
+          'The Moon Gate still listens for the Dawn Key. Recover it from the south gallery and the route will hold.',
+        ],
+        nextNodeId: 'briefing',
+      },
+      {
+        id: 'briefing',
+        lines: [
+          'Route note transmitted. Check your journal and carry the Dawn Key back to the gate.',
+        ],
+        outcomeId: 'route-briefed',
+      },
+    ],
+  },
+];

package/templates/create/2d-adventure/content/gameplay/world.js

@@ -1,46 +1,42 @@
-export const WORLD_BOUNDS = { x: 72, y: 72, width: 1136, height: 576 };
+import WORLD_TILEMAP_SOURCE from './world.tilemap.json' with { type: 'json' };
 
-export const PLAYER_SPAWN = { x: 156, y: 584 };
+export const WORLD_ORIGIN = { x: 128, y: 72 };
 
-export const WORLD_OBSTACLES = [
-  { id: 'fallen-arch', x: 312, y: 236, w: 220, h: 40 },
-  { id: 'mirror-pool', x: 694, y: 172, w: 164, h: 104 },
-  { id: 'collapsed-hall', x: 530, y: 422, w: 268, h: 42 },
-];
+export const WORLD_TILEMAP = WORLD_TILEMAP_SOURCE;
+
+export const WORLD_OBJECT_LAYERS = Object.freeze({
+  markers: 'markers',
+  pickups: 'pickups',
+  checkpoints: 'checkpoints',
+  props: 'props',
+  locks: 'locks',
+  scenery: 'scenery',
+});
 
-export const RELIC_SPAWNS = [
-  { id: 'survey-lens', label: 'Survey Lens', x: 214, y: 190, radius: 20 },
-  { id: 'signal-reel', label: 'Signal Reel', x: 546, y: 152, radius: 20 },
-  { id: 'chorus-map', label: 'Chorus Map', x: 930, y: 352, radius: 20 },
-  { id: 'dawn-key', label: 'Dawn Key', x: 792, y: 548, radius: 20 },
+export const INVENTORY_CATEGORIES = [
+  { id: 'relics', label: 'Relics' },
+  { id: 'keys', label: 'Access Keys' },
+  { id: 'field', label: 'Field Notes' },
 ];
 
-export const BEACON_SITES = [
-  {
-    id: 'north-brazier',
-    label: 'North Brazier',
-    x: 246,
-    y: 150,
-    size: 34,
-    radius: 42,
-    requiredRelics: 1,
-  },
+export const STARTING_INVENTORY_ITEMS = [
   {
-    id: 'east-brazier',
-    label: 'East Brazier',
-    x: 1034,
-    y: 276,
-    size: 34,
-    radius: 42,
-    requiredRelics: 3,
+    id: 'route-brief',
+    label: 'Route Brief',
+    categoryId: 'field',
+    categoryLabel: 'Field Notes',
+    quantity: 1,
+    badge: 'BRIEF',
+    description: 'Survey the Moon Archive and restore the exit route.',
+    detail: 'Recover three relics, inspect the archive console, then use the Dawn Key on the Moon Gate.',
   },
 ];
 
-export const EXIT_GATE = {
-  id: 'moon-gate',
-  label: 'Moon Gate',
-  x: 1028,
-  y: 526,
-  w: 118,
-  h: 88,
+export const WORLD_TEXT = {
+  zoneLabel: 'Moon Archive',
+  objective: 'Recover the relics, inspect the archive console, and leave through the Moon Gate.',
+  inventoryHint: 'Inventory stays on the HUD while the journal and dialogue proof move through the overlay screen lane.',
+  journalHint: 'Journal tracks route progress and archive intel through one shared starter-owned log surface.',
+  consoleNoteTitle: 'Archive Console Log',
+  consoleNoteDetail: 'The route seal listens for the Dawn Key. The relic anchors simply restore power to the archive floor.',
 };

package/templates/create/2d-adventure/content/gameplay/world.tilemap.json

@@ -0,0 +1,273 @@
+{
+  "width": 16,
+  "height": 9,
+  "tilewidth": 64,
+  "tileheight": 64,
+  "solidLayerNames": [
+    "collision"
+  ],
+  "layers": [
+    {
+      "name": "ground",
+      "type": "tilelayer",
+      "width": 16,
+      "height": 9,
+      "data": [
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+      ]
+    },
+    {
+      "name": "collision",
+      "type": "tilelayer",
+      "width": 16,
+      "height": 9,
+      "data": [
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+        1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1,
+        1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1,
+        1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 1, 0, 1,
+        1, 0, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 1,
+        1, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 1, 0, 1,
+        1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 1,
+        1, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 1,
+        1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+      ]
+    },
+    {
+      "name": "markers",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 1,
+          "name": "player-start",
+          "type": "spawn",
+          "x": 128,
+          "y": 128,
+          "point": true
+        },
+        {
+          "id": 2,
+          "name": "camp-west",
+          "type": "spawn",
+          "x": 320,
+          "y": 448,
+          "point": true
+        }
+      ]
+    },
+    {
+      "name": "pickups",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 101,
+          "name": "Survey Lens",
+          "type": "pickup",
+          "x": 168,
+          "y": 168,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to secure the Survey Lens",
+            "grantItemId": "survey-lens",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Calibrates the archive's survey route.",
+            "grantDetail": "The brass housing still hums with lunar static.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 102,
+          "name": "Signal Reel",
+          "type": "pickup",
+          "x": 456,
+          "y": 152,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to pocket the Signal Reel",
+            "grantItemId": "signal-reel",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Restores the relay sequence for the east hall.",
+            "grantDetail": "Stamped with route marks from the first survey team.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 103,
+          "name": "Chorus Map",
+          "type": "pickup",
+          "x": 760,
+          "y": 344,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to collect the Chorus Map",
+            "grantItemId": "chorus-map",
+            "grantCategoryId": "relics",
+            "grantCategoryLabel": "Relics",
+            "grantDescription": "Pins the resonant floor and old service ducts.",
+            "grantDetail": "Enough of it survived to restore the final route.",
+            "grantBadge": "RELIC"
+          }
+        },
+        {
+          "id": 104,
+          "name": "Dawn Key",
+          "type": "pickup",
+          "x": 888,
+          "y": 456,
+          "width": 28,
+          "height": 28,
+          "properties": {
+            "promptText": "Press E to recover the Dawn Key",
+            "grantItemId": "dawn-key",
+            "grantCategoryId": "keys",
+            "grantCategoryLabel": "Access Keys",
+            "grantDescription": "Still accepted by the Moon Gate lock.",
+            "grantDetail": "The key teeth match the seal at the archive exit.",
+            "grantBadge": "KEY"
+          }
+        }
+      ]
+    },
+    {
+      "name": "checkpoints",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 201,
+          "name": "Camp Lantern",
+          "type": "checkpoint",
+          "x": 288,
+          "y": 416,
+          "width": 48,
+          "height": 48,
+          "properties": {
+            "promptText": "Press E to mark the west camp checkpoint",
+            "checkpointId": "camp-west"
+          }
+        }
+      ]
+    },
+    {
+      "name": "props",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 301,
+          "name": "Archive Console",
+          "type": "prop",
+          "x": 616,
+          "y": 192,
+          "width": 56,
+          "height": 40,
+          "properties": {
+            "promptText": "Press E to inspect the archive console"
+          }
+        }
+      ]
+    },
+    {
+      "name": "locks",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 401,
+          "name": "Moon Gate",
+          "type": "lock",
+          "x": 896,
+          "y": 448,
+          "width": 96,
+          "height": 88,
+          "properties": {
+            "promptText": "Press E to unlock the Moon Gate",
+            "lockedPromptText": "Recover the Dawn Key before opening the Moon Gate",
+            "openedPromptText": "The Moon Gate is online",
+            "requiredItemId": "dawn-key",
+            "requiredQuantity": 1,
+            "consumeRequiredItem": false
+          }
+        }
+      ]
+    },
+    {
+      "name": "scenery",
+      "type": "objectgroup",
+      "objects": [
+        {
+          "id": 501,
+          "name": "Central Court",
+          "type": "plaza",
+          "x": 64,
+          "y": 64,
+          "width": 896,
+          "height": 448,
+          "properties": {
+            "fill": "#14211b",
+            "border": "#294436"
+          }
+        },
+        {
+          "id": 502,
+          "name": "Mirror Pool",
+          "type": "pool",
+          "x": 704,
+          "y": 128,
+          "width": 160,
+          "height": 96,
+          "properties": {
+            "fill": "#173949",
+            "border": "#3a728c"
+          }
+        },
+        {
+          "id": 503,
+          "name": "Collapsed Hall",
+          "type": "ruin",
+          "x": 256,
+          "y": 224,
+          "width": 192,
+          "height": 48,
+          "properties": {
+            "fill": "#28302d",
+            "border": "#4c5b57"
+          }
+        },
+        {
+          "id": 504,
+          "name": "South Gallery",
+          "type": "ruin",
+          "x": 512,
+          "y": 384,
+          "width": 224,
+          "height": 48,
+          "properties": {
+            "fill": "#242a29",
+            "border": "#48504c"
+          }
+        }
+      ]
+    }
+  ],
+  "tilesets": [
+    {
+      "firstgid": 1,
+      "image": "ruins-placeholder.png",
+      "tilewidth": 64,
+      "tileheight": 64,
+      "tilecount": 1,
+      "columns": 1
+    }
+  ]
+}

package/templates/create/2d-adventure/docs/design/loop.md

@@ -1,5 +1,6 @@
 # 2D Adventure Loop
 
-1. Sweep the ruin, collect four relics, and light the route beacons.
-1. Keep tuning knobs in `config/gameplay/adventure.config.js` and authored room nouns in `content/gameplay/world.js`.
-1. Extend the loop by adding more relic families, gate rules, or room variants before introducing heavier systems.
+1. Sweep the Moon Archive, recover the route relics, inspect the archive console, and leave through the Moon Gate.
+1. Keep authored room nouns in `content/gameplay/world.js`, `content/gameplay/world.tilemap.json`, and `content/gameplay/dialogue.js`, then keep starter-specific render/collision wrappers in `prefabs/world.prefab.js`.
+1. Use the archive console beat to prove the shared dialogue helper lane plus the shared journal/log owner before widening into heavier narrative or quest systems.
+1. Extend the loop by adding more object layers, item categories, checkpoints, or lock rules once the dialogue and journal proof still fits in one readable starter scene.

package/templates/create/2d-adventure/prefabs/relic.prefab.js

@@ -6,28 +6,28 @@ const relicPrefab = {
     kind: 'pickup2d',
   },
   hooks: {},
-  notes: ['Treat relics as authored pickups first, then grow them into richer quest nouns later.'],
+  notes: ['Treat relics as tilemap-authored pickups first, then grow them into richer quest nouns later.'],
 };
 
 export function createRelicPrefab() {
   return relicPrefab;
 }
 
-export function drawAdventureRelics(relics, elapsed = 0) {
-  for (const relic of relics) {
-    if (relic.collected) continue;
-    const pulse = 0.88 + (Math.sin((elapsed * 3.4) + relic.x) * 0.12);
-    const size = relic.radius * pulse;
+export function drawAdventureRelics(interactables = [], elapsed = 0) {
+  for (const entry of interactables) {
+    if (!entry || entry.kind !== 'pickup' || entry.collected === true) continue;
+    const pulse = 0.88 + (Math.sin((elapsed * 3.4) + entry.x) * 0.12);
+    const size = Math.max(12, (Math.max(Number(entry.w) || 0, Number(entry.h) || 0) * 0.5) * pulse);
     aura.draw2d.rect(
-      relic.x - size,
-      relic.y - size,
+      entry.x + ((entry.w - (size * 2)) * 0.5),
+      entry.y + ((entry.h - (size * 2)) * 0.5),
       size * 2,
       size * 2,
       aura.rgb(0.98, 0.9, 0.42),
     );
     aura.draw2d.rect(
-      relic.x - (size * 0.42),
-      relic.y - (size * 0.42),
+      entry.x + ((entry.w - (size * 0.84)) * 0.5),
+      entry.y + ((entry.h - (size * 0.84)) * 0.5),
       size * 0.84,
       size * 0.84,
       aura.rgb(0.18, 0.12, 0.04),