@auraindustry/aurajs 0.0.7 → 0.1.1

package/templates/create/video-cutscene/scenes/cutscene.scene.js

@@ -0,0 +1,113 @@
+// Cutscene scene: loads and plays an MP4 video fullscreen with fade
+// transitions, skip support, and automatic advance when the video ends.
+//
+// Drop your .mp4 files in assets/video/ and update the path below.
+// Audio embedded in the MP4 is automatically played through the mixer.
+
+export function createCutsceneScene() {
+  const VIDEO_PATH = 'assets/video/intro.mp4';
+  const FADE_SPEED = 2.0;
+
+  let videoHandle = null;
+  let textureHandle = null;
+  let playing = false;
+  let fadeAlpha = 1.0;
+  let fadeDir = -1; // -1 = fading in, +1 = fading out
+  let finished = false;
+
+  return {
+    id: 'cutscene',
+    nextSceneId: 'gameplay',
+
+    setup() {
+      finished = false;
+      playing = false;
+      fadeAlpha = 1.0;
+      fadeDir = -1;
+
+      videoHandle = aura.video.load(VIDEO_PATH, { type: 'mp4' });
+      textureHandle = aura.video.getTexture(videoHandle);
+
+      aura.camera3d.perspective({ fov: 60 });
+      aura.camera3d.setPosition(0, 0, 2);
+      aura.camera3d.lookAt(0, 0, 0);
+    },
+
+    update(dt) {
+      if (finished) return;
+
+      // Fade logic
+      fadeAlpha += fadeDir * dt * FADE_SPEED;
+
+      if (fadeAlpha <= 0 && fadeDir === -1) {
+        fadeAlpha = 0;
+        fadeDir = 0;
+        if (!playing && videoHandle) {
+          aura.video.play(videoHandle);
+          playing = true;
+        }
+      }
+
+      if (fadeAlpha >= 1 && fadeDir === 1) {
+        fadeAlpha = 1;
+        finished = true;
+        if (videoHandle) aura.video.stop(videoHandle);
+        return;
+      }
+
+      // Skip on Space or Enter
+      if (aura.input.isKeyPressed('Space') || aura.input.isKeyPressed('Enter')) {
+        fadeDir = 1;
+      }
+
+      // Auto-advance when video ends
+      if (playing && videoHandle) {
+        const info = aura.video.getInfo(videoHandle);
+        if (info && info.ended) {
+          fadeDir = 1;
+        }
+      }
+    },
+
+    draw() {
+      aura.draw3d.clear3d(aura.rgba(0, 0, 0, 1));
+
+      // Video billboard
+      if (textureHandle && playing) {
+        aura.draw3d.billboard(textureHandle, {
+          position: [0, 0, 0],
+          scale: [1.78, 1.0, 1.0],
+          mode: 'face',
+        });
+      }
+
+      // Fade overlay
+      if (fadeAlpha > 0.001) {
+        const { width, height } = aura.window.getSize();
+        aura.draw2d.rect(0, 0, width, height, {
+          color: aura.rgba(0, 0, 0, fadeAlpha),
+          filled: true,
+        });
+      }
+
+      // Skip hint
+      if (!finished && fadeDir === 0) {
+        const { width, height } = aura.window.getSize();
+        aura.draw2d.text('Press SPACE to skip', width / 2, height - 40, {
+          color: aura.rgba(1, 1, 1, 0.4),
+          size: 14,
+          align: 'center',
+        });
+      }
+    },
+
+    cleanup() {
+      if (videoHandle) {
+        aura.video.stop(videoHandle);
+        videoHandle = null;
+        textureHandle = null;
+      }
+      playing = false;
+    },
+  };
+}

package/templates/create/video-cutscene/scenes/gameplay.scene.js

@@ -0,0 +1,50 @@
+// Gameplay scene: placeholder 3D world that plays between cutscenes.
+// Replace this with your actual game loop.
+
+export function createGameplayScene() {
+  let floor = null;
+  let floorMat = null;
+
+  return {
+    id: 'gameplay',
+    nextSceneId: 'cutscene',
+
+    setup() {
+      aura.camera3d.perspective({ fov: 60 });
+      aura.camera3d.setPosition(0, 2, 6);
+      aura.camera3d.lookAt(0, 0.5, 0);
+      aura.light.ambient(aura.rgb(0.15, 0.15, 0.2));
+      aura.light.directional({
+        direction: [0.4, -0.8, -0.3],
+        color: aura.rgb(1, 0.95, 0.9),
+        intensity: 1.2,
+      });
+
+      if (!floor) {
+        floor = aura.mesh.createBox({ width: 20, height: 0.1, depth: 20 });
+        floorMat = aura.material.create({ color: aura.rgb(0.2, 0.25, 0.2) });
+      }
+    },
+
+    update(_dt) {
+      // Press C to trigger the next cutscene (demo flow)
+      // In a real game, trigger cutscenes from story events instead.
+    },
+
+    draw() {
+      aura.draw3d.clear3d(aura.rgba(0.05, 0.05, 0.08, 1));
+
+      aura.draw3d.drawMesh(floor, floorMat, { position: [0, -0.05, 0] });
+
+      const { width } = aura.window.getSize();
+      aura.draw2d.text('Gameplay — your game goes here', 20, 24, {
+        color: aura.Color.WHITE,
+        size: 18,
+      });
+      aura.draw2d.text(`${Math.floor(aura.window.getFPS())} fps`, width - 60, 24, {
+        color: aura.rgba(1, 1, 1, 0.3),
+        size: 12,
+      });
+    },
+  };
+}

package/templates/create/video-cutscene/src/main.js

@@ -0,0 +1,17 @@
+// {{PROJECT_TITLE}} — AuraJS video cutscene starter
+
+import { createApp } from './runtime/app.js';
+
+const app = createApp();
+
+aura.setup = function () {
+  app.setup();
+};
+
+aura.update = function (dt) {
+  app.update(dt);
+};
+
+aura.draw = function () {
+  app.draw();
+};

package/templates/create/video-cutscene/src/runtime/app.js

@@ -0,0 +1,52 @@
+import { createSceneRegistry } from './scene-registry.js';
+import { createProjectInspector } from './project-inspector.js';
+import { assertRuntimeCapabilities } from './capabilities.js';
+
+export function createApp() {
+  const sceneRegistry = createSceneRegistry({
+    projectTitle: '{{PROJECT_TITLE}}',
+  });
+  const projectInspector = createProjectInspector();
+  let activeSceneId = sceneRegistry.defaultSceneId || Object.keys(sceneRegistry.scenes)[0] || null;
+
+  const activeScene = () => (activeSceneId ? sceneRegistry.scenes[activeSceneId] || null : null);
+
+  return {
+    get activeSceneId() {
+      return activeSceneId;
+    },
+    get sceneRegistry() {
+      return sceneRegistry;
+    },
+    get projectInspectorEnabled() {
+      return projectInspector.enabled;
+    },
+    getProjectInspectorState() {
+      return projectInspector.snapshot({ activeSceneId });
+    },
+    setup() {
+      assertRuntimeCapabilities();
+      activeScene()?.setup?.();
+    },
+    update(dt) {
+      projectInspector.syncInput(globalThis.aura?.input || null);
+      activeScene()?.update?.(dt);
+    },
+    draw() {
+      activeScene()?.draw?.();
+      projectInspector.draw({ activeSceneId });
+    },
+    toggleProjectInspector(nextEnabled) {
+      return projectInspector.toggle(nextEnabled);
+    },
+    swapScene(nextSceneId) {
+      if (!sceneRegistry.scenes[nextSceneId]) {
+        throw new Error(`Unknown scene "${nextSceneId}".`);
+      }
+      const prev = activeSceneId;
+      activeSceneId = nextSceneId;
+      activeScene()?.setup?.();
+      return prev;
+    },
+  };
+}

package/templates/create/video-cutscene/src/runtime/capabilities.js

@@ -0,0 +1,35 @@
+function hasMethod(obj, method) {
+  return Boolean(obj) && typeof obj[method] === 'function';
+}
+
+function failWithReason(reasonCode, message) {
+  throw new Error(`[video-cutscene-template] ${message} [reason:${reasonCode}]`);
+}
+
+export function assertRuntimeCapabilities() {
+  const missing = [];
+  if (!hasMethod(aura.video, 'load')) missing.push('aura.video.load');
+  if (!hasMethod(aura.video, 'play')) missing.push('aura.video.play');
+  if (!hasMethod(aura.video, 'pause')) missing.push('aura.video.pause');
+  if (!hasMethod(aura.video, 'stop')) missing.push('aura.video.stop');
+  if (!hasMethod(aura.video, 'seek')) missing.push('aura.video.seek');
+  if (!hasMethod(aura.video, 'getTexture')) missing.push('aura.video.getTexture');
+  if (!hasMethod(aura.video, 'getInfo')) missing.push('aura.video.getInfo');
+  if (!hasMethod(aura.draw3d, 'billboard')) missing.push('aura.draw3d.billboard');
+  if (!hasMethod(aura.draw3d, 'clear3d')) missing.push('aura.draw3d.clear3d');
+  if (!hasMethod(aura.camera3d, 'perspective')) missing.push('aura.camera3d.perspective');
+  if (!hasMethod(aura.camera3d, 'setPosition')) missing.push('aura.camera3d.setPosition');
+  if (!hasMethod(aura.camera3d, 'lookAt')) missing.push('aura.camera3d.lookAt');
+  if (!hasMethod(aura.input, 'isKeyPressed')) missing.push('aura.input.isKeyPressed');
+  if (!hasMethod(aura.draw2d, 'clear')) missing.push('aura.draw2d.clear');
+  if (!hasMethod(aura.draw2d, 'rect')) missing.push('aura.draw2d.rect');
+  if (!hasMethod(aura.draw2d, 'text')) missing.push('aura.draw2d.text');
+  if (!hasMethod(aura.draw2d, 'measureText')) missing.push('aura.draw2d.measureText');
+  if (typeof aura.rgb !== 'function') missing.push('aura.rgb');
+  if (typeof aura.rgba !== 'function') missing.push('aura.rgba');
+  if (!aura.Color || !aura.Color.WHITE) missing.push('aura.Color.WHITE');
+
+  if (missing.length > 0) {
+    failWithReason('missing_runtime_api', `runtime missing required APIs: ${missing.join(', ')}`);
+  }
+}

package/templates/create/video-cutscene/src/runtime/state.js

@@ -0,0 +1,13 @@
+// Cross-scene application state for the video cutscene template.
+// Scenes read and write this shared object to coordinate flow.
+
+export const appState = {
+  // Which cutscenes have been viewed (skip on replay)
+  viewedCutscenes: new Set(),
+
+  // Current chapter index in the story sequence
+  chapterIndex: 0,
+
+  // Whether the player chose to skip the current cutscene
+  skipped: false,
+};