@auraindustry/aurajs 0.1.3 → 0.1.5

package/templates/create/3d-collectathon/scenes/gameplay.scene.js

@@ -74,6 +74,34 @@ export function createGameplayScene(context = {}) {
   let playerVisual = null;
   let sceneState = createCollectathonRunState();
 
+  function configureSceneLook() {
+    aura.light.ambient({ r: 0.94, g: 0.97, b: 1.0 }, 0.16);
+    aura.light.hemisphere(
+      { r: 0.46, g: 0.6, b: 0.82 },
+      { r: 0.13, g: 0.1, b: 0.08 },
+      0.32,
+      { x: 0, y: 1, z: 0 },
+    );
+    aura.light.directional({ x: 0.52, y: -1.0, z: -0.28 }, { r: 1.0, g: 0.97, b: 0.9 }, 1.08);
+    aura.light.spot(
+      { x: -7.5, y: 7.0, z: 9.0 },
+      { x: 0.38, y: -1.0, z: -0.34 },
+      { r: 1.0, g: 0.84, b: 0.56 },
+      1.45,
+      30,
+      0.76,
+    );
+    aura.draw3d.setFog({
+      mode: 'exp2',
+      color: { r: 0.05, g: 0.08, b: 0.11 },
+      density: 0.017,
+    });
+    aura.draw3d.setOcclusionCulling({ enabled: true, conservative: true });
+    aura.draw3d.setPostFXPass('bloom', { strength: 0.32, radius: 0.52, threshold: 0.72 });
+    aura.draw3d.setPostFXPass('vignette', { strength: 0.14, radius: 0.93 });
+    aura.draw3d.setPostFXPass('fxaa', { strength: 1.0 });
+  }
+
   function syncSessionState() {
     collectathonSession.lastSceneId = 'gameplay';
     collectathonSession.bestScore = Math.max(Number(collectathonSession.bestScore || 0), sceneState.score);
@@ -137,8 +165,7 @@ export function createGameplayScene(context = {}) {
       materials = createCollectathonMaterials();
       playerVisual = loadPlayerAvatarVisual();
 
-      aura.light.ambient({ r: 1, g: 1, b: 1 }, 0.23);
-      aura.light.directional({ x: 0.55, y: -1.0, z: -0.35 }, { r: 1, g: 1, b: 1 }, 1.0);
+      configureSceneLook();
       aura.camera3d.perspective(62, 0.1, 150);
 
       resetRun();
@@ -174,7 +201,7 @@ export function createGameplayScene(context = {}) {
       syncSessionState();
     },
     draw() {
-      aura.draw3d.clear3d({ r: 0.06, g: 0.08, b: 0.12 });
+      aura.draw3d.clear3d({ r: 0.04, g: 0.06, b: 0.085 });
       drawCollectathonCourse({
         mesh: boxMesh,
         floorMaterial: materials.floor,

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

@@ -11,7 +11,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.mesh, 'createBox')) missing.push('aura.mesh.createBox');
   if (!hasMethod(aura.material, 'create')) missing.push('aura.material.create');
   if (!hasMethod(aura.light, 'ambient')) missing.push('aura.light.ambient');
+  if (!hasMethod(aura.light, 'hemisphere')) missing.push('aura.light.hemisphere');
   if (!hasMethod(aura.light, 'directional')) missing.push('aura.light.directional');
+  if (!hasMethod(aura.light, 'spot')) missing.push('aura.light.spot');
   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');
@@ -33,6 +35,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.scene3d, 'submitRenderBindings')) missing.push('aura.scene3d.submitRenderBindings');
   if (!hasMethod(aura.draw3d, 'clear3d')) missing.push('aura.draw3d.clear3d');
   if (!hasMethod(aura.draw3d, 'drawMesh')) missing.push('aura.draw3d.drawMesh');
+  if (!hasMethod(aura.draw3d, 'setFog')) missing.push('aura.draw3d.setFog');
+  if (!hasMethod(aura.draw3d, 'setOcclusionCulling')) missing.push('aura.draw3d.setOcclusionCulling');
+  if (!hasMethod(aura.draw3d, 'setPostFXPass')) missing.push('aura.draw3d.setPostFXPass');
   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');

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

@@ -12,23 +12,33 @@ export function createCollectathonMaterials() {
     }),
     player: aura.material.create({
       color: { r: 0.98, g: 0.55, b: 0.26, a: 1.0 },
+      emissive: { r: 0.09, g: 0.03, b: 0.01 },
       metallic: 0.28,
       roughness: 0.32,
+      sheenColor: { r: 0.16, g: 0.1, b: 0.08 },
+      sheenRoughness: 0.44,
     }),
     collectible: aura.material.create({
       color: { r: 0.98, g: 0.92, b: 0.38, a: 1.0 },
+      emissive: { r: 0.48, g: 0.38, b: 0.1 },
       metallic: 0.7,
       roughness: 0.25,
     }),
     checkpoint: aura.material.create({
       color: { r: 0.34, g: 0.9, b: 1.0, a: 1.0 },
+      emissive: { r: 0.05, g: 0.24, b: 0.28 },
       metallic: 0.45,
       roughness: 0.3,
+      sheenColor: { r: 0.12, g: 0.18, b: 0.22 },
+      sheenRoughness: 0.24,
     }),
     goal: aura.material.create({
       color: { r: 0.54, g: 1.0, b: 0.7, a: 1.0 },
+      emissive: { r: 0.08, g: 0.26, b: 0.14 },
       metallic: 0.38,
       roughness: 0.32,
+      sheenColor: { r: 0.14, g: 0.2, b: 0.16 },
+      sheenRoughness: 0.28,
     }),
   };
 }

package/templates/create/shared/src/runtime/ui-forms.js

@@ -34,6 +34,89 @@ function normalizeMenuOptions(options) {
     : [];
 }
 
+function normalizeCollectionItems(items) {
+  return Array.isArray(items)
+    ? items
+      .filter((entry) => entry && typeof entry === 'object' && !Array.isArray(entry))
+      .map((entry) => ({
+        id: typeof entry.id === 'string' ? entry.id.trim() : '',
+        label: typeof entry.label === 'string' && entry.label.trim().length > 0 ? entry.label : String(entry.id || ''),
+        description: typeof entry.description === 'string' ? entry.description : null,
+        detail: typeof entry.detail === 'string' ? entry.detail : null,
+        badge: typeof entry.badge === 'string' && entry.badge.trim().length > 0 ? entry.badge.trim() : null,
+        quantity: Number.isFinite(Number(entry.quantity)) ? Math.max(0, Number(entry.quantity)) : 0,
+        disabled: entry.disabled === true,
+      }))
+      .filter((entry) => entry.id.length > 0)
+    : [];
+}
+
+function normalizeDialogueChoices(choices) {
+  return normalizeMenuOptions(choices);
+}
+
+function normalizeJournalEntries(entries) {
+  return Array.isArray(entries)
+    ? entries
+      .filter((entry) => entry && typeof entry === 'object' && !Array.isArray(entry))
+      .map((entry, index) => {
+        const id = typeof entry.id === 'string' && entry.id.trim().length > 0
+          ? entry.id.trim()
+          : `entry-${index + 1}`;
+        const label = typeof entry.label === 'string' && entry.label.trim().length > 0
+          ? entry.label.trim()
+          : (typeof entry.title === 'string' && entry.title.trim().length > 0
+            ? entry.title.trim()
+            : id);
+        return {
+          id,
+          label,
+          description: typeof entry.description === 'string'
+            ? entry.description
+            : (typeof entry.summary === 'string' ? entry.summary : null),
+          detail: typeof entry.detail === 'string'
+            ? entry.detail
+            : (typeof entry.body === 'string' ? entry.body : null),
+          badge: typeof entry.badge === 'string' && entry.badge.trim().length > 0
+            ? entry.badge.trim()
+            : (typeof entry.status === 'string' && entry.status.trim().length > 0
+              ? entry.status.trim()
+              : null),
+          meta: typeof entry.meta === 'string' && entry.meta.trim().length > 0
+            ? entry.meta.trim()
+            : (typeof entry.updatedAt === 'string' && entry.updatedAt.trim().length > 0
+              ? entry.updatedAt.trim()
+              : null),
+          disabled: entry.disabled === true,
+        };
+      })
+      .filter((entry) => entry.id.length > 0)
+    : [];
+}
+
+function buttonStateFromView(rootId, optionId) {
+  return readViewState(`${rootId}-${optionId}`) || null;
+}
+
+function selectionState(option, state, selected) {
+  return {
+    id: option.id,
+    label: option.label,
+    selected,
+    clicked: state?.clicked === true,
+    focused: state?.focused === true,
+    disabled: state?.disabled === true || option.disabled === true,
+  };
+}
+
+function collectionSummary(item) {
+  if (!item) return null;
+  if (item.badge && item.quantity > 1) return `${item.badge} · x${item.quantity}`;
+  if (item.badge) return item.badge;
+  if (item.quantity > 1) return `x${item.quantity}`;
+  return null;
+}
+
 function renderInfoText(id, label = null, description = null) {
   if (label) {
     globalThis.aura.ui.text(`${id}-label`, {
@@ -207,3 +290,472 @@ export function renderMenuList({
     states: cloneValue(states),
   };
 }
+
+export function renderTabBar({
+  id,
+  label = null,
+  description = null,
+  value = null,
+  tabs = [],
+} = {}) {
+  if (!hasUiMethod('beginColumn') || !hasUiMethod('beginRow') || !hasUiMethod('button')) {
+    return {
+      ok: false,
+      reasonCode: 'ui_tab_bar_runtime_unavailable',
+      value,
+      actionId: null,
+    };
+  }
+  const rootId = typeof id === 'string' ? id.trim() : '';
+  const normalizedTabs = normalizeMenuOptions(tabs);
+  if (!rootId || normalizedTabs.length <= 0) {
+    return {
+      ok: false,
+      reasonCode: 'ui_tab_bar_invalid_options',
+      value,
+      actionId: null,
+    };
+  }
+
+  const theme = activeTheme();
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-group`,
+    gap: 8,
+    width: 'fill',
+  });
+  renderInfoText(rootId, label, description);
+  globalThis.aura.ui.beginRow({
+    id: `${rootId}-tabs`,
+    gap: 8,
+    width: 'fill',
+  });
+  for (const tab of normalizedTabs) {
+    const selected = tab.id === value;
+    globalThis.aura.ui.button(`${rootId}-${tab.id}`, {
+      label: tab.label,
+      disabled: tab.disabled === true,
+      width: 'hug',
+      background: selected ? (theme?.buttonFocusColor || '#1e5b97') : (theme?.buttonColor || '#132132'),
+      borderColor: selected ? (theme?.buttonTextColor || '#ffffff') : (theme?.panelBorderColor || '#314e68'),
+    });
+  }
+  globalThis.aura.ui.endRow();
+  globalThis.aura.ui.endColumn();
+
+  let nextValue = value;
+  let actionId = null;
+  const states = [];
+  for (const tab of normalizedTabs) {
+    const state = buttonStateFromView(rootId, tab.id);
+    if (state?.clicked === true || state?.activated === true) {
+      nextValue = tab.id;
+      actionId = tab.id;
+    }
+    states.push(selectionState(tab, state, tab.id === nextValue));
+  }
+
+  return {
+    ok: true,
+    reasonCode: 'ui_tab_bar_rendered',
+    value: nextValue,
+    changed: nextValue !== value,
+    actionId,
+    states: cloneValue(states),
+  };
+}
+
+export function renderCollectionList({
+  id,
+  label = null,
+  description = null,
+  value = null,
+  items = [],
+  emptyText = 'Nothing here yet.',
+} = {}) {
+  if (!hasUiMethod('beginColumn') || !hasUiMethod('button')) {
+    return {
+      ok: false,
+      reasonCode: 'ui_collection_list_runtime_unavailable',
+      value,
+      actionId: null,
+      states: [],
+    };
+  }
+  const rootId = typeof id === 'string' ? id.trim() : '';
+  if (!rootId) {
+    return {
+      ok: false,
+      reasonCode: 'ui_collection_list_invalid_id',
+      value,
+      actionId: null,
+      states: [],
+    };
+  }
+
+  const normalizedItems = normalizeCollectionItems(items);
+  const theme = activeTheme();
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-group`,
+    gap: 8,
+    width: 'fill',
+  });
+  renderInfoText(rootId, label, description);
+
+  if (normalizedItems.length <= 0) {
+    globalThis.aura.ui.text(`${rootId}-empty`, {
+      text: emptyText,
+      size: 13,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+    globalThis.aura.ui.endColumn();
+    return {
+      ok: true,
+      reasonCode: 'ui_collection_list_empty',
+      value,
+      changed: false,
+      actionId: null,
+      states: [],
+      selectedItem: null,
+    };
+  }
+
+  for (const item of normalizedItems) {
+    const selected = item.id === value;
+    const summary = collectionSummary(item);
+    const buttonLabel = summary ? `${item.label} (${summary})` : item.label;
+    globalThis.aura.ui.button(`${rootId}-${item.id}`, {
+      label: buttonLabel,
+      width: 'fill',
+      disabled: item.disabled === true,
+      background: selected ? (theme?.buttonFocusColor || '#1e5b97') : (theme?.buttonColor || '#132132'),
+      borderColor: selected ? (theme?.buttonTextColor || '#ffffff') : (theme?.panelBorderColor || '#314e68'),
+    });
+    if (item.description) {
+      globalThis.aura.ui.text(`${rootId}-${item.id}-description`, {
+        text: item.description,
+        size: 12,
+        color: theme?.mutedTextColor || '#9db2cb',
+      });
+    }
+    if (item.detail) {
+      globalThis.aura.ui.text(`${rootId}-${item.id}-detail`, {
+        text: item.detail,
+        size: 12,
+        color: theme?.mutedTextColor || '#9db2cb',
+      });
+    }
+  }
+  globalThis.aura.ui.endColumn();
+
+  let nextValue = value;
+  let actionId = null;
+  const states = [];
+  for (const item of normalizedItems) {
+    const state = buttonStateFromView(rootId, item.id);
+    if (state?.clicked === true || state?.activated === true) {
+      nextValue = item.id;
+      actionId = item.id;
+    }
+    states.push({
+      ...selectionState(item, state, item.id === nextValue),
+      badge: item.badge,
+      quantity: item.quantity,
+    });
+  }
+
+  const selectedItem = normalizedItems.find((entry) => entry.id === nextValue) || null;
+  return {
+    ok: true,
+    reasonCode: 'ui_collection_list_rendered',
+    value: nextValue,
+    changed: nextValue !== value,
+    actionId,
+    states: cloneValue(states),
+    selectedItem: cloneValue(selectedItem),
+  };
+}
+
+export function renderDialoguePanel({
+  id,
+  label = null,
+  speaker = null,
+  title = null,
+  text = '',
+  note = null,
+  value = null,
+  choices = [],
+  emptyText = 'No response options available.',
+} = {}) {
+  if (!hasUiMethod('beginColumn') || !hasUiMethod('button') || !hasUiMethod('text')) {
+    return {
+      ok: false,
+      reasonCode: 'ui_dialogue_panel_runtime_unavailable',
+      value,
+      actionId: null,
+      states: [],
+      selectedChoice: null,
+    };
+  }
+  const rootId = typeof id === 'string' ? id.trim() : '';
+  if (!rootId) {
+    return {
+      ok: false,
+      reasonCode: 'ui_dialogue_panel_invalid_id',
+      value,
+      actionId: null,
+      states: [],
+      selectedChoice: null,
+    };
+  }
+
+  const normalizedChoices = normalizeDialogueChoices(choices);
+  const theme = activeTheme();
+
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-group`,
+    gap: 8,
+    width: 'fill',
+  });
+  if (label) {
+    globalThis.aura.ui.text(`${rootId}-label`, {
+      text: label,
+      size: 11,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+  }
+  if (speaker) {
+    globalThis.aura.ui.text(`${rootId}-speaker`, {
+      text: speaker,
+      size: 13,
+      color: '#84c3ef',
+    });
+  }
+  if (title) {
+    globalThis.aura.ui.text(`${rootId}-title`, {
+      text: title,
+      size: 20,
+      color: '#eef7ff',
+    });
+  }
+  globalThis.aura.ui.text(`${rootId}-text`, {
+    text,
+    size: 13,
+    color: '#d5e1ee',
+  });
+  if (note) {
+    globalThis.aura.ui.text(`${rootId}-note`, {
+      text: note,
+      size: 12,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+  }
+
+  if (normalizedChoices.length <= 0) {
+    globalThis.aura.ui.text(`${rootId}-empty`, {
+      text: emptyText,
+      size: 12,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+    globalThis.aura.ui.endColumn();
+    return {
+      ok: true,
+      reasonCode: 'ui_dialogue_panel_empty_choices',
+      value,
+      changed: false,
+      actionId: null,
+      states: [],
+      selectedChoice: null,
+    };
+  }
+
+  for (const choice of normalizedChoices) {
+    const selected = choice.id === value;
+    globalThis.aura.ui.button(`${rootId}-${choice.id}`, {
+      label: choice.label,
+      width: 'fill',
+      disabled: choice.disabled === true,
+      background: selected ? (theme?.buttonFocusColor || '#1e5b97') : (theme?.buttonColor || '#132132'),
+      borderColor: selected ? (theme?.buttonTextColor || '#ffffff') : (theme?.panelBorderColor || '#314e68'),
+    });
+    if (choice.description) {
+      globalThis.aura.ui.text(`${rootId}-${choice.id}-description`, {
+        text: choice.description,
+        size: 12,
+        color: theme?.mutedTextColor || '#9db2cb',
+      });
+    }
+  }
+  globalThis.aura.ui.endColumn();
+
+  let nextValue = value;
+  let actionId = null;
+  const states = [];
+  for (const choice of normalizedChoices) {
+    const state = buttonStateFromView(rootId, choice.id);
+    if (state?.clicked === true || state?.activated === true) {
+      nextValue = choice.id;
+      actionId = choice.id;
+    }
+    states.push(selectionState(choice, state, choice.id === nextValue));
+  }
+
+  const selectedChoice = normalizedChoices.find((entry) => entry.id === nextValue) || null;
+  return {
+    ok: true,
+    reasonCode: 'ui_dialogue_panel_rendered',
+    value: nextValue,
+    changed: nextValue !== value,
+    actionId,
+    states: cloneValue(states),
+    selectedChoice: cloneValue(selectedChoice),
+  };
+}
+
+export function renderJournalPane({
+  id,
+  label = null,
+  description = null,
+  value = null,
+  entries = [],
+  emptyText = 'No journal entries yet.',
+  detailEmptyText = 'Select an entry to inspect the current route record.',
+} = {}) {
+  if (!hasUiMethod('beginColumn') || !hasUiMethod('beginRow') || !hasUiMethod('button') || !hasUiMethod('text')) {
+    return {
+      ok: false,
+      reasonCode: 'ui_journal_pane_runtime_unavailable',
+      value,
+      actionId: null,
+      states: [],
+      selectedEntry: null,
+    };
+  }
+  const rootId = typeof id === 'string' ? id.trim() : '';
+  if (!rootId) {
+    return {
+      ok: false,
+      reasonCode: 'ui_journal_pane_invalid_id',
+      value,
+      actionId: null,
+      states: [],
+      selectedEntry: null,
+    };
+  }
+
+  const normalizedEntries = normalizeJournalEntries(entries);
+  const theme = activeTheme();
+
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-group`,
+    gap: 8,
+    width: 'fill',
+  });
+  renderInfoText(rootId, label, description);
+  globalThis.aura.ui.beginRow({
+    id: `${rootId}-layout`,
+    gap: 12,
+    width: 'fill',
+  });
+
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-list`,
+    width: 220,
+    gap: 8,
+  });
+  if (normalizedEntries.length <= 0) {
+    globalThis.aura.ui.text(`${rootId}-empty`, {
+      text: emptyText,
+      size: 13,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+  } else {
+    for (const entry of normalizedEntries) {
+      const selected = entry.id === value;
+      const summary = entry.badge ? `${entry.label} (${entry.badge})` : entry.label;
+      globalThis.aura.ui.button(`${rootId}-${entry.id}`, {
+        label: summary,
+        width: 'fill',
+        disabled: entry.disabled === true,
+        background: selected ? (theme?.buttonFocusColor || '#1e5b97') : (theme?.buttonColor || '#132132'),
+        borderColor: selected ? (theme?.buttonTextColor || '#ffffff') : (theme?.panelBorderColor || '#314e68'),
+      });
+      if (entry.description) {
+        globalThis.aura.ui.text(`${rootId}-${entry.id}-description`, {
+          text: entry.description,
+          size: 12,
+          color: theme?.mutedTextColor || '#9db2cb',
+        });
+      }
+    }
+  }
+  globalThis.aura.ui.endColumn();
+
+  const fallbackEntry = normalizedEntries[0] || null;
+  const activeEntry = normalizedEntries.find((entry) => entry.id === value) || fallbackEntry;
+
+  globalThis.aura.ui.beginColumn({
+    id: `${rootId}-detail`,
+    width: 'fill',
+    gap: 8,
+  });
+  globalThis.aura.ui.text(`${rootId}-detail-label`, {
+    text: 'ENTRY',
+    size: 11,
+    color: '#84c3ef',
+  });
+  globalThis.aura.ui.text(`${rootId}-detail-title`, {
+    text: activeEntry?.label || 'No entry selected',
+    size: 18,
+    color: '#eef7ff',
+  });
+  globalThis.aura.ui.text(`${rootId}-detail-badge`, {
+    text: activeEntry?.badge || 'Journal',
+    size: 12,
+    color: '#f0cf79',
+  });
+  globalThis.aura.ui.text(`${rootId}-detail-copy`, {
+    text: activeEntry?.detail || activeEntry?.description || detailEmptyText,
+    size: 13,
+    color: '#d5e1ee',
+  });
+  if (activeEntry?.meta) {
+    globalThis.aura.ui.text(`${rootId}-detail-meta`, {
+      text: activeEntry.meta,
+      size: 12,
+      color: theme?.mutedTextColor || '#9db2cb',
+    });
+  }
+  globalThis.aura.ui.endColumn();
+
+  globalThis.aura.ui.endRow();
+  globalThis.aura.ui.endColumn();
+
+  let nextValue = value;
+  let actionId = null;
+  const states = [];
+  for (const entry of normalizedEntries) {
+    const state = buttonStateFromView(rootId, entry.id);
+    if (state?.clicked === true || state?.activated === true) {
+      nextValue = entry.id;
+      actionId = entry.id;
+    }
+    states.push({
+      ...selectionState(entry, state, entry.id === nextValue),
+      badge: entry.badge,
+      meta: entry.meta,
+    });
+  }
+
+  const selectedEntry = normalizedEntries.find((entry) => entry.id === nextValue)
+    || normalizedEntries[0]
+    || null;
+  return {
+    ok: true,
+    reasonCode: normalizedEntries.length > 0 ? 'ui_journal_pane_rendered' : 'ui_journal_pane_empty',
+    value: selectedEntry?.id || value || null,
+    changed: Boolean(selectedEntry?.id && selectedEntry.id !== value),
+    actionId,
+    states: cloneValue(states),
+    selectedEntry: cloneValue(selectedEntry),
+  };
+}