@auraindustry/aurajs 0.0.6 → 0.1.0

package/templates/make/README.md

@@ -0,0 +1,46 @@
+# AuraJS Make Templates
+
+This directory contains the shipped core templates for `aura make`.
+
+Today AuraJS exposes two generator layers:
+
+- core-owned kinds from `templates/make/`
+- starter-owned kinds from `templates/make-starters/<starter>/`
+
+Current core kinds include:
+
+- `scene`
+- `prefab`
+- `ui-screen`
+- `system`
+- `component`
+- `config`
+- `content`
+- `material`
+- `shader`
+
+Starter-owned kinds are only available when the current project starter declares
+them. The first committed proof is `deckbuilder-2d`, which adds:
+
+- `card`
+- `enemy`
+- `relic`
+- `encounter`
+
+Layout:
+
+- `catalog.json` lists the core generator kinds owned by AuraJS itself.
+- `<kind>/manifest.json` describes the generator metadata and output root.
+- `<kind>/files/**` contains the small source-controlled files copied into a
+  project.
+- `../make-starters/<starter>/catalog.json` declares starter-owned kinds and
+  their registry wiring.
+
+Template token replacements:
+
+- `{{MAKE_KIND}}`: selected kind id, such as `scene` or `card`
+- `{{MAKE_NAME}}`: sanitized file/id stem
+- `{{MAKE_TITLE}}`: human-readable display title
+
+The templates stay intentionally small, JS/JSON-first, and safe to hand-edit
+after generation.

package/templates/make/catalog.json

@@ -0,0 +1,51 @@
+{
+  "schema": "aurajs.make-template-catalog.v1",
+  "placeholders": {
+    "MAKE_KIND": "selected kind id",
+    "MAKE_NAME": "sanitized file stem and logical id",
+    "MAKE_TITLE": "human-readable display title"
+  },
+  "kinds": [
+    {
+      "id": "scene",
+      "manifest": "scene/manifest.json",
+      "registerAs": "scene"
+    },
+    {
+      "id": "prefab",
+      "manifest": "prefab/manifest.json",
+      "registerAs": "prefab"
+    },
+    {
+      "id": "system",
+      "manifest": "system/manifest.json"
+    },
+    {
+      "id": "component",
+      "manifest": "component/manifest.json"
+    },
+    {
+      "id": "ui-screen",
+      "manifest": "ui-screen/manifest.json",
+      "registerAs": "ui-screen"
+    },
+    {
+      "id": "config",
+      "manifest": "data/manifest.json",
+      "outputRoot": "config/gameplay"
+    },
+    {
+      "id": "content",
+      "manifest": "data/manifest.json",
+      "outputRoot": "content/gameplay"
+    },
+    {
+      "id": "material",
+      "manifest": "material/manifest.json"
+    },
+    {
+      "id": "shader",
+      "manifest": "shader/manifest.json"
+    }
+  ]
+}

package/templates/make/component/files/{{MAKE_NAME}}.component.js

@@ -0,0 +1,20 @@
+// {{MAKE_TITLE}} component
+
+const defaults = {
+  enabled: true,
+  note: 'Replace with real component fields.',
+};
+
+export function createComponent(initial = {}) {
+  return {
+    ...defaults,
+    ...initial,
+  };
+}
+
+export default {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  defaults,
+  create: createComponent,
+};

package/templates/make/component/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "component",
+  "summary": "Small component definition with defaults and a create helper.",
+  "outputRoot": "src/components",
+  "files": [
+    "files/{{MAKE_NAME}}.component.js"
+  ]
+}

package/templates/make/data/files/{{MAKE_NAME}}.json

@@ -0,0 +1,14 @@
+{
+  "schema": "aurajs.{{MAKE_KIND}}.v1",
+  "id": "{{MAKE_NAME}}",
+  "title": "{{MAKE_TITLE}}",
+  "items": [
+    {
+      "id": "example",
+      "value": 1
+    }
+  ],
+  "notes": [
+    "Replace this payload with game-specific authored {{MAKE_KIND}}."
+  ]
+}

package/templates/make/data/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "config",
+  "summary": "Small JSON payload for authored config or content tuning.",
+  "outputRoot": "config/gameplay",
+  "files": [
+    "files/{{MAKE_NAME}}.json"
+  ]
+}

package/templates/make/material/files/{{MAKE_NAME}}.material.json

@@ -0,0 +1,17 @@
+{
+  "schema": "aurajs.material.v1",
+  "id": "{{MAKE_NAME}}",
+  "label": "{{MAKE_TITLE}}",
+  "surface": "standard",
+  "baseColor": {
+    "r": 0.82,
+    "g": 0.84,
+    "b": 0.9,
+    "a": 1.0
+  },
+  "metallic": 0.1,
+  "roughness": 0.85,
+  "notes": [
+    "Swap these values for texture paths or shader uniforms later."
+  ]
+}

package/templates/make/material/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "material",
+  "summary": "Tiny material config with editable surface values.",
+  "outputRoot": "assets/materials",
+  "files": [
+    "files/{{MAKE_NAME}}.material.json"
+  ]
+}

package/templates/make/prefab/files/{{MAKE_NAME}}.prefab.js

@@ -0,0 +1,20 @@
+// {{MAKE_TITLE}} prefab
+
+const prefab = {
+  id: '{{MAKE_NAME}}',
+  kind: 'prefab',
+  role: '{{MAKE_ROLE}}',
+  view: {
+    kind: 'actor2d',
+    collider: { shape: 'rect', size: { x: 32, y: 32 } },
+  },
+  tags: ['gameplay', 'edit-me'],
+  components: {
+    transform: { x: 0, y: 0, z: 0 },
+    renderable: { visible: true, material: 'default' },
+  },
+  hooks: {},
+  notes: ['Replace the default role, view, and components with your real gameplay contract.'],
+};
+
+export default prefab;

package/templates/make/prefab/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "prefab",
+  "summary": "Composable prefab definition with a tiny component bag.",
+  "outputRoot": "prefabs",
+  "files": [
+    "files/{{MAKE_NAME}}.prefab.js"
+  ]
+}

package/templates/make/scene/files/{{MAKE_NAME}}.scene.js

@@ -0,0 +1,31 @@
+// {{MAKE_TITLE}} scene
+
+const scene = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  entities: [
+    { id: 'player-start', prefab: 'player', position: { x: 0, y: 0, z: 0 } },
+  ],
+  enter(context = {}) {
+    return {
+      ...context,
+      nextScene: null,
+    };
+  },
+  update(state, dt) {
+    return {
+      ...state,
+      elapsed: (state.elapsed || 0) + dt,
+    };
+  },
+};
+
+export function create{{MAKE_EXPORT_NAME}}Scene() {
+  return {
+    ...scene,
+    entities: [...scene.entities],
+  };
+}
+
+export default scene;

package/templates/make/scene/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "scene",
+  "summary": "Small scene module with obvious lifecycle hooks and seed entities.",
+  "outputRoot": "scenes",
+  "files": [
+    "files/{{MAKE_NAME}}.scene.js"
+  ]
+}

package/templates/make/shader/files/{{MAKE_NAME}}.shader.js

@@ -0,0 +1,23 @@
+// {{MAKE_TITLE}} shader
+
+const shader = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  uniforms: {
+    tint: { type: 'vec4', value: [1, 1, 1, 1] },
+  },
+  vertex: `
+// Replace with authored vertex shader source.
+@vertex
+fn vertexMain() {
+}
+`,
+  fragment: `
+// Replace with authored fragment shader source.
+@fragment
+fn fragmentMain() {
+}
+`,
+};
+
+export default shader;

package/templates/make/shader/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "shader",
+  "summary": "JS wrapper around editable vertex and fragment shader source strings.",
+  "outputRoot": "assets/shaders",
+  "files": [
+    "files/{{MAKE_NAME}}.shader.js"
+  ]
+}

package/templates/make/system/files/{{MAKE_NAME}}.system.js

@@ -0,0 +1,15 @@
+// {{MAKE_TITLE}} system
+
+const system = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  query: ['transform'],
+  update(world, dt) {
+    return {
+      ...world,
+      lastSystemTick: dt,
+    };
+  },
+};
+
+export default system;

package/templates/make/system/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "system",
+  "summary": "Pure-JS system shell with query metadata and update hook.",
+  "outputRoot": "src/systems",
+  "files": [
+    "files/{{MAKE_NAME}}.system.js"
+  ]
+}

package/templates/make/ui-screen/files/{{MAKE_NAME}}.screen.js

@@ -0,0 +1,16 @@
+// {{MAKE_TITLE}} screen
+
+const screen = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  layoutFile: './{{MAKE_NAME}}.screen.json',
+  initialState() {
+    return {
+      visible: true,
+      selectedAction: 'primary',
+    };
+  },
+};
+
+export default screen;

package/templates/make/ui-screen/files/{{MAKE_NAME}}.screen.json

@@ -0,0 +1,23 @@
+{
+  "schema": "aurajs.ui-screen.v1",
+  "id": "{{MAKE_NAME}}",
+  "title": "{{MAKE_TITLE}}",
+  "nodes": [
+    {
+      "id": "root",
+      "type": "column",
+      "children": [
+        {
+          "id": "title",
+          "type": "text",
+          "value": "{{MAKE_TITLE}}"
+        },
+        {
+          "id": "primary-action",
+          "type": "button",
+          "label": "Edit me"
+        }
+      ]
+    }
+  ]
+}

package/templates/make/ui-screen/manifest.json

@@ -0,0 +1,10 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "ui-screen",
+  "summary": "Simple screen controller paired with a JSON layout model.",
+  "outputRoot": "ui",
+  "files": [
+    "files/{{MAKE_NAME}}.screen.js",
+    "files/{{MAKE_NAME}}.screen.json"
+  ]
+}

package/templates/make-starters/deckbuilder-2d/card/files/{{MAKE_NAME}}.card.js

@@ -0,0 +1,22 @@
+// {{MAKE_TITLE}} card
+
+const card = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  cost: 1,
+  rarity: 'common',
+  target: 'enemy',
+  text: 'Deal 6 damage.',
+  effects: [
+    {
+      type: 'damage',
+      amount: 6,
+    },
+  ],
+  notes: [
+    'Replace the default text, cost, and effects with your real card rules.',
+  ],
+};
+
+export default card;

package/templates/make-starters/deckbuilder-2d/card/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "card",
+  "summary": "Deckbuilder card definition with cost, effects, and readable rules text.",
+  "outputRoot": "content/cards",
+  "files": [
+    "files/{{MAKE_NAME}}.card.js"
+  ]
+}

package/templates/make-starters/deckbuilder-2d/catalog.json

@@ -0,0 +1,34 @@
+{
+  "schema": "aurajs.make-template-catalog.v1",
+  "placeholders": {
+    "MAKE_KIND": "selected kind id",
+    "MAKE_NAME": "sanitized file stem and logical id",
+    "MAKE_TITLE": "human-readable display title"
+  },
+  "kinds": [
+    {
+      "id": "card",
+      "manifest": "card/manifest.json",
+      "starterContentFamily": "cards",
+      "starterContentRegistry": "content/registries/cards.registry.js"
+    },
+    {
+      "id": "enemy",
+      "manifest": "enemy/manifest.json",
+      "starterContentFamily": "enemies",
+      "starterContentRegistry": "content/registries/enemies.registry.js"
+    },
+    {
+      "id": "relic",
+      "manifest": "relic/manifest.json",
+      "starterContentFamily": "relics",
+      "starterContentRegistry": "content/registries/relics.registry.js"
+    },
+    {
+      "id": "encounter",
+      "manifest": "encounter/manifest.json",
+      "starterContentFamily": "encounters",
+      "starterContentRegistry": "content/registries/encounters.registry.js"
+    }
+  ]
+}

package/templates/make-starters/deckbuilder-2d/encounter/files/{{MAKE_NAME}}.encounter.js

@@ -0,0 +1,18 @@
+// {{MAKE_TITLE}} encounter
+
+const encounter = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  room: 'starter-hall',
+  enemies: ['training-slime'],
+  rewards: {
+    gold: 12,
+    cardChoices: 3,
+  },
+  notes: [
+    'Replace the default enemy ids and rewards with your real combat payload.',
+  ],
+};
+
+export default encounter;

package/templates/make-starters/deckbuilder-2d/encounter/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "encounter",
+  "summary": "Deckbuilder encounter definition with enemy ids, rewards, and pacing hooks.",
+  "outputRoot": "content/encounters",
+  "files": [
+    "files/{{MAKE_NAME}}.encounter.js"
+  ]
+}

package/templates/make-starters/deckbuilder-2d/enemy/files/{{MAKE_NAME}}.enemy.js

@@ -0,0 +1,28 @@
+// {{MAKE_TITLE}} enemy
+
+const enemy = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  hp: 30,
+  block: 0,
+  intent: 'attack',
+  moves: [
+    {
+      id: 'strike',
+      title: 'Strike',
+      effects: [
+        {
+          type: 'damage',
+          amount: 7,
+          target: 'player',
+        },
+      ],
+    },
+  ],
+  notes: [
+    'Replace the default stats and move list with your encounter-specific behavior.',
+  ],
+};
+
+export default enemy;

package/templates/make-starters/deckbuilder-2d/enemy/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "enemy",
+  "summary": "Deckbuilder enemy definition with health, intent, and move list stubs.",
+  "outputRoot": "content/enemies",
+  "files": [
+    "files/{{MAKE_NAME}}.enemy.js"
+  ]
+}

package/templates/make-starters/deckbuilder-2d/relic/files/{{MAKE_NAME}}.relic.js

@@ -0,0 +1,23 @@
+// {{MAKE_TITLE}} relic
+
+const relic = {
+  id: '{{MAKE_NAME}}',
+  kind: '{{MAKE_KIND}}',
+  title: '{{MAKE_TITLE}}',
+  tier: 'common',
+  text: 'At the start of combat, gain 1 block.',
+  hooks: {
+    onCombatStart: [
+      {
+        type: 'gain-block',
+        amount: 1,
+        target: 'player',
+      },
+    ],
+  },
+  notes: [
+    'Replace the default hook payload with the passive effect your relic should grant.',
+  ],
+};
+
+export default relic;

package/templates/make-starters/deckbuilder-2d/relic/manifest.json

@@ -0,0 +1,9 @@
+{
+  "schema": "aurajs.make-template.v1",
+  "kind": "relic",
+  "summary": "Deckbuilder relic definition with passive hooks and a concise reward stub.",
+  "outputRoot": "content/relics",
+  "files": [
+    "files/{{MAKE_NAME}}.relic.js"
+  ]
+}

package/templates/retro/platformer/README.md

@@ -0,0 +1,10 @@
+# __AURA_RETRO_PROJECT_NAME__
+
+Target-safe Aura Retro starter for a simple side-view platformer loop.
+
+Commands:
+
+```bash
+aura retro explain --target gbc
+aura build --target gbc
+```

package/templates/retro/platformer/assets/retro/assets.json

@@ -0,0 +1,91 @@
+{
+  "palettes": [
+    {
+      "id": "dmg",
+      "colors": ["#081820", "#346856", "#88C070", "#E0F8D0"]
+    }
+  ],
+  "tiles": [
+    {
+      "id": "ground",
+      "palette": "dmg",
+      "width": 8,
+      "height": 8,
+      "pixels": [
+        "00011000",
+        "00122100",
+        "01233210",
+        "12333321",
+        "12333321",
+        "01233210",
+        "00122100",
+        "00011000"
+      ]
+    },
+    {
+      "id": "wall",
+      "palette": "dmg",
+      "width": 8,
+      "height": 8,
+      "pixels": [
+        "33333333",
+        "32222223",
+        "32111123",
+        "32133123",
+        "32133123",
+        "32111123",
+        "32222223",
+        "33333333"
+      ]
+    }
+  ],
+  "sprites": [
+    {
+      "id": "hero",
+      "palette": "dmg",
+      "width": 8,
+      "height": 8,
+      "pixels": [
+        "..1111..",
+        ".122221.",
+        "12333321",
+        "12300321",
+        "12333321",
+        ".122221.",
+        ".1.11.1.",
+        "1..11..1"
+      ]
+    },
+    {
+      "id": "marker",
+      "palette": "dmg",
+      "width": 8,
+      "height": 8,
+      "pixels": [
+        "........",
+        "...11...",
+        "..1221..",
+        ".123321.",
+        ".123321.",
+        "..1221..",
+        "...11...",
+        "........"
+      ]
+    }
+  ],
+  "fonts": [
+    {
+      "id": "hud",
+      "width": 4,
+      "height": 6,
+      "glyphs": {
+        "A": [".11.", "1..1", "1111", "1..1", "1..1", "1..1"],
+        "I": ["1111", ".11.", ".11.", ".11.", ".11.", "1111"],
+        "R": ["111.", "1..1", "111.", "1.1.", "1..1", "1..1"],
+        "G": [".111", "1...", "1.11", "1..1", "1..1", ".111"],
+        "N": ["1..1", "11.1", "1111", "1.11", "1..1", "1..1"],
+        "D": ["111.", "1..1", "1..1", "1..1", "1..1", "111."]
+      }
+    }
+  ]
+}

package/templates/retro/platformer/aura.config.json

@@ -0,0 +1,7 @@
+{
+  "identity": {
+    "name": "__AURA_RETRO_PROJECT_NAME__",
+    "version": "0.1.0",
+    "executable": "__AURA_RETRO_PROJECT_SLUG__"
+  }
+}

package/templates/retro/platformer/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "__AURA_RETRO_PROJECT_SLUG__",
+  "version": "0.1.0",
+  "private": true
+}