@auraindustry/aurajs 0.0.7 → 0.1.0

package/templates/create/3d-collectathon/src/runtime/materials.js

@@ -0,0 +1,34 @@
+export function createCollectathonMaterials() {
+  return {
+    floor: aura.material.create({
+      color: { r: 0.16, g: 0.25, b: 0.2, a: 1.0 },
+      metallic: 0.06,
+      roughness: 0.92,
+    }),
+    platform: aura.material.create({
+      color: { r: 0.42, g: 0.54, b: 0.74, a: 1.0 },
+      metallic: 0.1,
+      roughness: 0.6,
+    }),
+    player: aura.material.create({
+      color: { r: 0.98, g: 0.55, b: 0.26, a: 1.0 },
+      metallic: 0.28,
+      roughness: 0.32,
+    }),
+    collectible: aura.material.create({
+      color: { r: 0.98, g: 0.92, b: 0.38, a: 1.0 },
+      metallic: 0.7,
+      roughness: 0.25,
+    }),
+    checkpoint: aura.material.create({
+      color: { r: 0.34, g: 0.9, b: 1.0, a: 1.0 },
+      metallic: 0.45,
+      roughness: 0.3,
+    }),
+    goal: aura.material.create({
+      color: { r: 0.54, g: 1.0, b: 0.7, a: 1.0 },
+      metallic: 0.38,
+      roughness: 0.32,
+    }),
+  };
+}

package/templates/create/3d-collectathon/src/runtime/state.js

@@ -0,0 +1,27 @@
+import { createCheckpointSystem, createMovingPlatform3D } from '../starter-utils/index.js';
+import { CHECKPOINTS, COLLECTIBLE_SPAWNS, MOVING_PLATFORM, PLAYER_SPAWN, START_TIMER_SECONDS } from '../../content/gameplay/course.js';
+import { createPlayerAvatar, resetPlayerAvatar } from '../../prefabs/player.prefab.js';
+
+function buildCollectibles() {
+  return COLLECTIBLE_SPAWNS.map((entry, index) => ({
+    id: `c-${index + 1}`,
+    x: entry.x,
+    y: entry.y,
+    z: entry.z,
+    collected: false,
+  }));
+}
+
+export function createCollectathonRunState(existingPlayer = null) {
+  return {
+    player: existingPlayer ? resetPlayerAvatar(existingPlayer, PLAYER_SPAWN) : createPlayerAvatar(PLAYER_SPAWN),
+    collectibles: buildCollectibles(),
+    score: 0,
+    elapsed: 0,
+    timerRemaining: START_TIMER_SECONDS,
+    runFailed: false,
+    runComplete: false,
+    checkpointSystem: createCheckpointSystem({ checkpoints: CHECKPOINTS }),
+    movingPlatform: createMovingPlatform3D(MOVING_PLATFORM),
+  };
+}

package/templates/create/3d-collectathon/ui/hud.screen.js

@@ -0,0 +1,66 @@
+import { TARGET_COLLECTIBLES } from '../content/gameplay/course.js';
+
+const hudScreen = {
+  id: 'hud',
+  kind: 'ui-screen',
+  notes: ['HUD draw helpers still live beside the authored screen descriptor in this template.'],
+};
+
+export function drawCollectathonHud({ score, timerRemaining, runFailed, runComplete, showControlsHint = true }) {
+  let nextY = 12;
+  if (showControlsHint) {
+    aura.draw2d.text('Move: Arrows/WASD  Jump: Space', 12, nextY, {
+      color: aura.Color.WHITE,
+      size: 14,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+  aura.draw2d.text(`Collectibles ${score}/${TARGET_COLLECTIBLES}`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+  nextY += 22;
+  aura.draw2d.text(`Timer ${timerRemaining.toFixed(1)}s`, 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 14,
+    align: 'left',
+  });
+  nextY += 22;
+  aura.draw2d.text('Reach checkpoints, collect orbs, then hit the goal.', 12, nextY, {
+    color: aura.Color.WHITE,
+    size: 13,
+    align: 'left',
+  });
+  nextY += 30;
+
+  if (runComplete) {
+    aura.draw2d.text('COURSE CLEARED', 12, nextY, {
+      color: aura.rgb(0.54, 1.0, 0.7),
+      size: 24,
+      align: 'left',
+    });
+    aura.draw2d.text('Press Enter to restart', 12, nextY + 28, {
+      color: aura.Color.WHITE,
+      size: 16,
+      align: 'left',
+    });
+    return;
+  }
+
+  if (!runFailed) return;
+
+  aura.draw2d.text('TIME UP', 12, nextY, {
+    color: aura.rgb(1.0, 0.46, 0.46),
+    size: 24,
+    align: 'left',
+  });
+  aura.draw2d.text('Press Enter to retry', 12, nextY + 28, {
+    color: aura.Color.WHITE,
+    size: 16,
+    align: 'left',
+  });
+}
+
+export default hudScreen;

package/templates/create/3d-collectathon/ui/pause.screen.js

@@ -0,0 +1,13 @@
+const screen = {
+  id: "pause",
+  kind: 'ui-screen',
+  notes: [
+  "Use this for timer state, collected progress, and restart affordances."
+],
+};
+
+export function createPauseScreen() {
+  return screen;
+}
+
+export default screen;

package/templates/create/blank/config/gameplay/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/content/gameplay/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/content/registries/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/docs/design/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/docs/design/loop.md

@@ -0,0 +1,5 @@
+# Blank Starter Notes
+
+1. Treat this template as the minimal authored AuraJS scaffold rather than a second project shape.
+1. Keep defaults in `config/`, authored nouns in `content/`, gameplay flow in `scenes/`, reusable pieces in `prefabs/`, and runtime wiring in `src/runtime/`.
+1. Use `aura make`, `aura explain`, and `aura check` instead of inventing an alternate folder model.

package/templates/create/blank/prefabs/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/scenes/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/src/runtime/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/blank/ui/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/assets/audio/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/assets/fonts/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/assets/sprites/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/assets/starter/README.md

@@ -0,0 +1,11 @@
+# Deckbuilder 2D Starter Assets
+
+Use this folder for the first authored native-first pass:
+
+- card frame sprites
+- combat arena backdrops
+- icon sheets for deck, discard, energy, and intents
+
+The starter loop is playable without art. Add content in `content/registries/`,
+`content/cards/`, `content/enemies/`, `content/relics/`, and `content/encounters/` first,
+then replace the placeholder rectangles here.

package/templates/create/deckbuilder-2d/assets/ui/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/aura.config.json

@@ -0,0 +1,28 @@
+{
+  "identity": {
+    "name": "{{PROJECT_TITLE}}",
+    "version": "{{PROJECT_VERSION}}",
+    "executable": "{{PROJECT_BIN_NAME}}",
+    "icon": null
+  },
+  "window": {
+    "title": "{{PROJECT_TITLE}}",
+    "width": 1280,
+    "height": 720,
+    "resizable": true,
+    "fullscreen": false,
+    "vsync": true,
+    "hidpi": true
+  },
+  "build": {
+    "entry": "src/main.js",
+    "outDir": "build",
+    "assetDir": "assets",
+    "assetMode": "embed"
+  },
+  "modules": {
+    "physics": false,
+    "network": false,
+    "steam": false
+  }
+}

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

@@ -0,0 +1,26 @@
+export const DECKBUILDER_CONFIG = {
+  handSize: 5,
+  energyPerTurn: 3,
+  playerMaxHp: 36,
+  hudHeight: 122,
+  cardWidth: 158,
+  cardHeight: 104,
+  boardPadding: 24,
+};
+
+export const DECKBUILDER_TEXT = {
+  bootTitle: '{{PROJECT_TITLE}}',
+  bootSubtitle: 'AuraJS deckbuilder-2d starter',
+  bootPrompt: 'Press SPACE or ENTER to load the starter battle.',
+  battleHint: 'Keys 1-5 play cards. ENTER ends turn. R restarts. ESC returns to boot. Grow content with `aura make` before adding more systems.',
+  nativeFirstNote: 'Native-first starter. Add content in content/ before growing engine surface.',
+  contentTargets: [
+    'content/registries/cards.registry.js',
+    'content/registries/enemies.registry.js',
+    'content/registries/relics.registry.js',
+    'content/registries/encounters.registry.js',
+    'content/cards/starter.deck.js',
+    'content/encounters/training-battle.encounter.js',
+    'ui/hud.screen.js',
+  ],
+};

package/templates/create/deckbuilder-2d/content/cards/guard.card.js

@@ -0,0 +1,19 @@
+const guardCard = {
+  id: 'guard',
+  kind: 'card',
+  title: 'Guard',
+  cost: 1,
+  rarity: 'starter',
+  tone: 'guard',
+  target: 'self',
+  text: 'Gain 5 block.',
+  effects: [
+    {
+      type: 'gain-block',
+      amount: 5,
+      target: 'player',
+    },
+  ],
+};
+
+export default guardCard;

package/templates/create/deckbuilder-2d/content/cards/spark.card.js

@@ -0,0 +1,20 @@
+const card = {
+  id: 'spark',
+  kind: 'card',
+  title: 'Spark',
+  cost: 2,
+  rarity: 'common',
+  target: 'enemy',
+  text: 'Deal 9 damage. Draw 1 card.',
+  tone: 'skill',
+  damage: 9,
+  block: 0,
+  draw: 1,
+  summary: 'Deal 9 damage. Draw 1 card.',
+  effects: [
+    { type: 'damage', amount: 9, target: 'enemy' },
+    { type: 'draw', amount: 1, target: 'self' },
+  ],
+};
+
+export default card;

package/templates/create/deckbuilder-2d/content/cards/starter.deck.js

@@ -0,0 +1,69 @@
+import guardCard from './guard.card.js';
+import strikeCard from './strike.card.js';
+
+const CARD_TONES = {
+  attack: { r: 0.78, g: 0.28, b: 0.24 },
+  guard: { r: 0.24, g: 0.54, b: 0.82 },
+  skill: { r: 0.44, g: 0.38, b: 0.82 },
+};
+
+export const STARTER_CARD_LIBRARY = {
+  [strikeCard.id]: strikeCard,
+  [guardCard.id]: guardCard,
+};
+
+export const STARTER_DECK = [
+  'strike',
+  'strike',
+  'strike',
+  'strike',
+  'guard',
+  'guard',
+  'guard',
+  'guard',
+];
+
+function summarizeCard(card) {
+  return card?.text || card?.summary || 'Custom card effect.';
+}
+
+export function resolveCardTotals(card) {
+  const totals = {
+    damage: 0,
+    block: 0,
+    draw: 0,
+  };
+
+  for (const effect of Array.isArray(card?.effects) ? card.effects : []) {
+    const amount = Number(effect?.amount || 0);
+    if (!Number.isFinite(amount)) continue;
+    if (effect.type === 'damage') totals.damage += amount;
+    if (effect.type === 'gain-block') totals.block += amount;
+    if (effect.type === 'draw-cards') totals.draw += amount;
+  }
+
+  return totals;
+}
+
+export function createStarterDeck(cardLibrary = STARTER_CARD_LIBRARY) {
+  return STARTER_DECK.map((cardId, index) => {
+    const source = cardLibrary[cardId] || STARTER_CARD_LIBRARY.strike;
+    const totals = resolveCardTotals(source);
+    return {
+      ...source,
+      ...totals,
+      name: source.title || source.name || source.id,
+      summary: summarizeCard(source),
+      instanceId: `${source.id}-${index + 1}`,
+    };
+  });
+}
+
+export function resolveCardTone(card) {
+  const tone = CARD_TONES[card?.tone] || CARD_TONES.skill;
+  return {
+    r: tone.r,
+    g: tone.g,
+    b: tone.b,
+  };
+}

package/templates/create/deckbuilder-2d/content/cards/strike.card.js

@@ -0,0 +1,19 @@
+const strikeCard = {
+  id: 'strike',
+  kind: 'card',
+  title: 'Strike',
+  cost: 1,
+  rarity: 'starter',
+  tone: 'attack',
+  target: 'enemy',
+  text: 'Deal 6 damage.',
+  effects: [
+    {
+      type: 'damage',
+      amount: 6,
+      target: 'enemy',
+    },
+  ],
+};
+
+export default strikeCard;

package/templates/create/deckbuilder-2d/content/cards/survey.card.js

@@ -0,0 +1,20 @@
+const card = {
+  id: 'survey',
+  kind: 'card',
+  title: 'Survey',
+  cost: 0,
+  rarity: 'common',
+  target: 'self',
+  text: 'Gain 3 block. Draw 1 card.',
+  tone: 'skill',
+  damage: 0,
+  block: 3,
+  draw: 1,
+  summary: 'Gain 3 block. Draw 1 card.',
+  effects: [
+    { type: 'block', amount: 3, target: 'self' },
+    { type: 'draw', amount: 1, target: 'self' },
+  ],
+};
+
+export default card;

package/templates/create/deckbuilder-2d/content/encounters/training-battle.encounter.js

@@ -0,0 +1,14 @@
+const trainingBattleEncounter = {
+  id: 'training-battle',
+  kind: 'encounter',
+  title: 'Training Battle',
+  intro: 'Starter battle loaded. Keep the first proof loop small and content-first.',
+  room: 'starter-hall',
+  enemies: ['training-automaton'],
+  rewards: {
+    gold: 12,
+    relicIds: ['ember-charm'],
+  },
+};
+
+export default trainingBattleEncounter;

package/templates/create/deckbuilder-2d/content/encounters/training-battle.js

@@ -0,0 +1,65 @@
+import trainingBattleEncounter from './training-battle.encounter.js';
+import trainingAutomatonEnemy from '../enemies/training-automaton.enemy.js';
+import emberCharmRelic from '../relics/ember-charm.relic.js';
+
+const STARTER_ENEMY_LIBRARY = {
+  [trainingAutomatonEnemy.id]: trainingAutomatonEnemy,
+};
+
+const STARTER_RELIC_LIBRARY = {
+  [emberCharmRelic.id]: emberCharmRelic,
+};
+
+function summarizeMove(move, damage, block) {
+  if (typeof move?.text === 'string' && move.text.trim().length > 0) {
+    return move.text.trim();
+  }
+  if (damage > 0 && block > 0) return `Deal ${damage} damage and gain ${block} block.`;
+  if (damage > 0) return `Deal ${damage} damage.`;
+  if (block > 0) return `Gain ${block} block.`;
+  return 'Custom move effect.';
+}
+
+function materializeMove(move) {
+  let damage = 0;
+  let block = 0;
+  for (const effect of Array.isArray(move?.effects) ? move.effects : []) {
+    const amount = Number(effect?.amount || 0);
+    if (!Number.isFinite(amount)) continue;
+    if (effect.type === 'damage') damage += amount;
+    if (effect.type === 'gain-block') block += amount;
+  }
+
+  return {
+    id: move.id,
+    name: move.title || move.name || move.id,
+    damage,
+    block,
+    summary: summarizeMove(move, damage, block),
+  };
+}
+
+export function createTrainingBattle(encounter = trainingBattleEncounter, enemyLibrary = STARTER_ENEMY_LIBRARY) {
+  const enemyId = Array.isArray(encounter?.enemies) && encounter.enemies.length > 0
+    ? encounter.enemies[0]
+    : trainingAutomatonEnemy.id;
+  const enemy = enemyLibrary[enemyId] || trainingAutomatonEnemy;
+  const relicRewards = Array.isArray(encounter?.rewards?.relicIds)
+    ? encounter.rewards.relicIds.map((relicId) => STARTER_RELIC_LIBRARY[relicId]).filter(Boolean)
+    : [];
+
+  return {
+    id: encounter.id,
+    label: encounter.title,
+    enemyId,
+    enemyName: enemy.title,
+    enemyMaxHp: Number(enemy.hp || 0),
+    intro: encounter.intro || 'Starter battle loaded. Keep the first proof loop small and data-driven.',
+    rewardNote: relicRewards.length > 0
+      ? `Reward seed: ${relicRewards.map((relic) => relic.title).join(', ')}`
+      : 'Next expansion point: card rewards, relics, and multi-encounter runs.',
+    moves: (Array.isArray(enemy.moves) ? enemy.moves : []).map((move) => materializeMove(move)),
+    enemyHp: Number(enemy.hp || 0),
+    enemyBlock: Number(enemy.block || 0),
+  };
+}

package/templates/create/deckbuilder-2d/content/enemies/training-automaton.enemy.js

@@ -0,0 +1,48 @@
+const trainingAutomatonEnemy = {
+  id: 'training-automaton',
+  kind: 'enemy',
+  title: 'Training Automaton',
+  hp: 34,
+  block: 0,
+  intent: 'attack',
+  moves: [
+    {
+      id: 'probe',
+      title: 'Probe Beam',
+      text: 'Deal 4 damage.',
+      effects: [
+        {
+          type: 'damage',
+          amount: 4,
+          target: 'player',
+        },
+      ],
+    },
+    {
+      id: 'brace',
+      title: 'Brace',
+      text: 'Gain 4 block.',
+      effects: [
+        {
+          type: 'gain-block',
+          amount: 4,
+          target: 'self',
+        },
+      ],
+    },
+    {
+      id: 'slam',
+      title: 'Heavy Slam',
+      text: 'Deal 7 damage.',
+      effects: [
+        {
+          type: 'damage',
+          amount: 7,
+          target: 'player',
+        },
+      ],
+    },
+  ],
+};
+
+export default trainingAutomatonEnemy;

package/templates/create/deckbuilder-2d/content/gameplay/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/deckbuilder-2d/content/registries/cards.registry.js

@@ -0,0 +1,26 @@
+const starterContentRegistry = {
+  schema: 'aurajs.starter-content-registry.v1',
+  template: 'deckbuilder-2d',
+  family: 'cards',
+  title: 'Starter cards',
+  entries: [
+    {
+      id: 'guard',
+      kind: 'card',
+      path: 'content/cards/guard.card.js',
+      exportName: 'default',
+    },
+    {
+      id: 'strike',
+      kind: 'card',
+      path: 'content/cards/strike.card.js',
+      exportName: 'default',
+    },
+  ],
+};
+
+export function createStarterContentRegistry() {
+  return starterContentRegistry;
+}
+
+export default starterContentRegistry;

package/templates/create/deckbuilder-2d/content/registries/encounters.registry.js

@@ -0,0 +1,20 @@
+const starterContentRegistry = {
+  schema: 'aurajs.starter-content-registry.v1',
+  template: 'deckbuilder-2d',
+  family: 'encounters',
+  title: 'Starter encounters',
+  entries: [
+    {
+      id: 'training-battle',
+      kind: 'encounter',
+      path: 'content/encounters/training-battle.encounter.js',
+      exportName: 'default',
+    },
+  ],
+};
+
+export function createStarterContentRegistry() {
+  return starterContentRegistry;
+}
+
+export default starterContentRegistry;

package/templates/create/deckbuilder-2d/content/registries/enemies.registry.js

@@ -0,0 +1,20 @@
+const starterContentRegistry = {
+  schema: 'aurajs.starter-content-registry.v1',
+  template: 'deckbuilder-2d',
+  family: 'enemies',
+  title: 'Starter enemies',
+  entries: [
+    {
+      id: 'training-automaton',
+      kind: 'enemy',
+      path: 'content/enemies/training-automaton.enemy.js',
+      exportName: 'default',
+    },
+  ],
+};
+
+export function createStarterContentRegistry() {
+  return starterContentRegistry;
+}
+
+export default starterContentRegistry;

package/templates/create/deckbuilder-2d/content/registries/relics.registry.js

@@ -0,0 +1,20 @@
+const starterContentRegistry = {
+  schema: 'aurajs.starter-content-registry.v1',
+  template: 'deckbuilder-2d',
+  family: 'relics',
+  title: 'Starter relics',
+  entries: [
+    {
+      id: 'ember-charm',
+      kind: 'relic',
+      path: 'content/relics/ember-charm.relic.js',
+      exportName: 'default',
+    },
+  ],
+};
+
+export function createStarterContentRegistry() {
+  return starterContentRegistry;
+}
+
+export default starterContentRegistry;

package/templates/create/deckbuilder-2d/content/relics/ember-charm.relic.js

@@ -0,0 +1,18 @@
+const emberCharmRelic = {
+  id: 'ember-charm',
+  kind: 'relic',
+  title: 'Ember Charm',
+  tier: 'starter',
+  text: 'Start combat with 1 block.',
+  hooks: {
+    onCombatStart: [
+      {
+        type: 'gain-block',
+        amount: 1,
+        target: 'player',
+      },
+    ],
+  },
+};
+
+export default emberCharmRelic;

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

@@ -0,0 +1,12 @@
+# Deckbuilder 2D Starter Loop
+
+This starter keeps the first gameplay proof intentionally small:
+
+1. Boot scene
+2. Single authored training battle
+3. Hand of cards with energy, damage, block, and draw
+4. HUD with turn state, intent, draw/discard counts, and last action
+
+Grow content through `content/registries/`, `content/cards/`, `content/enemies/`,
+`content/relics/`, and `content/encounters/` before adding map flow, rewards, or
+meta-progression.

package/templates/create/deckbuilder-2d/prefabs/.gitkeep

@@ -0,0 +1 @@
+