aurasu 0.1.0 → 0.1.1

package/src/runtime/app-state.js

@@ -0,0 +1,100 @@
+export const APP_STATE_SCHEMA = "aurajs.app-state.v1";
+
+function cloneAppStateValue(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => cloneAppStateValue(entry));
+  }
+  if (value && typeof value === 'object') {
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) {
+      output[key] = cloneAppStateValue(entry);
+    }
+    return output;
+  }
+  return value;
+}
+
+function createStoreSection() {
+  return {};
+}
+
+export function createAppState({ projectTitle = 'AuraJS Game', template = 'blank' } = {}) {
+  return {
+    schema: APP_STATE_SCHEMA,
+    projectTitle,
+    template,
+    session: createStoreSection(),
+    ui: createStoreSection(),
+    runtime: {
+      startSceneId: null,
+      currentSceneId: null,
+      previousSceneId: null,
+      hudScreenId: null,
+      overlayScreenId: null,
+      modalScreenIds: [],
+    },
+  };
+}
+
+function ensureStoreBucket(appState, bucketName) {
+  if (!appState || typeof appState !== 'object' || Array.isArray(appState)) {
+    throw new Error('Expected appState to be a mutable object.');
+  }
+  if (!appState[bucketName] || typeof appState[bucketName] !== 'object' || Array.isArray(appState[bucketName])) {
+    appState[bucketName] = createStoreSection();
+  }
+  return appState[bucketName];
+}
+
+export function ensureSessionState(appState, featureKey, seed = {}) {
+  const key = typeof featureKey === 'string' ? featureKey.trim() : '';
+  if (!key) {
+    throw new Error('Expected a non-empty session feature key.');
+  }
+  const session = ensureStoreBucket(appState, 'session');
+  if (!session[key] || typeof session[key] !== 'object' || Array.isArray(session[key])) {
+    session[key] = cloneAppStateValue(seed);
+  }
+  return session[key];
+}
+
+export function ensureUiState(appState, featureKey, seed = {}) {
+  const key = typeof featureKey === 'string' ? featureKey.trim() : '';
+  if (!key) {
+    throw new Error('Expected a non-empty UI feature key.');
+  }
+  const ui = ensureStoreBucket(appState, 'ui');
+  if (!ui[key] || typeof ui[key] !== 'object' || Array.isArray(ui[key])) {
+    ui[key] = cloneAppStateValue(seed);
+  }
+  return ui[key];
+}
+
+export function normalizeAppState(appState, { projectTitle = 'AuraJS Game', template = 'blank' } = {}) {
+  const normalized = appState && typeof appState === 'object' && !Array.isArray(appState)
+    ? appState
+    : createAppState({ projectTitle, template });
+  normalized.schema = APP_STATE_SCHEMA;
+  normalized.projectTitle = projectTitle;
+  normalized.template = template;
+  ensureStoreBucket(normalized, 'session');
+  ensureStoreBucket(normalized, 'ui');
+  const runtimeState = normalized.runtime && typeof normalized.runtime === 'object' && !Array.isArray(normalized.runtime)
+    ? normalized.runtime
+    : {};
+  normalized.runtime = {
+    startSceneId: null,
+    currentSceneId: null,
+    previousSceneId: null,
+    hudScreenId: null,
+    overlayScreenId: null,
+    modalScreenIds: [],
+    ...runtimeState,
+    modalScreenIds: Array.isArray(runtimeState.modalScreenIds)
+      ? runtimeState.modalScreenIds
+        .map((entry) => (typeof entry === 'string' ? entry.trim() : ''))
+        .filter((entry) => entry.length > 0)
+      : [],
+  };
+  return normalized;
+}