@almadar/runtime 6.52.0 → 6.54.0

package/dist/{OrbitalServerRuntime-DRvduqA7.d.ts → OrbitalServerRuntime-Cz5MiWKB.d.ts}

@@ -1152,6 +1152,11 @@ declare class OrbitalServerRuntime {
     private substrateHandlers;
     private substrateHandlersPromise;
     private resolvedSchema;
+    /** App-level theme key from the schema's `theme "<key>"` header — the
+     *  `@currentTheme` fallback between an orbital's own `theme` and
+     *  `DEFAULT_THEME_KEY`. Set at registration, before the orbital loops
+     *  (`resolvedSchema` is assigned only after them). */
+    private appThemeKey;
     /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
     private liveBroadcastSink;
     /**

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { F as ClientEffectTuple, G as ClientNavigateTuple, H as ClientNotifyTuple, J as ClientRenderUITuple, K as EffectResult, e as InMemoryPersistence, M as LiveBroadcastItem, N as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, Q as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, T as RuntimeTraitTick, p as collectDeclaredConfigDefaults, V as createOrbitalServerRuntime } from './OrbitalServerRuntime-DRvduqA7.js';
+export { F as ClientEffectTuple, G as ClientNavigateTuple, H as ClientNotifyTuple, J as ClientRenderUITuple, K as EffectResult, e as InMemoryPersistence, M as LiveBroadcastItem, N as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, Q as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, T as RuntimeTraitTick, p as collectDeclaredConfigDefaults, V as createOrbitalServerRuntime } from './OrbitalServerRuntime-Cz5MiWKB.js';
 import './types-BcPORH_x.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,7 +1,7 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-EHFQOBQH.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-EHFQOBQH.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-DERIA6MO.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-DERIA6MO.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
-import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ORBJ5YEQ.js';
+import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
 import './chunk-SCRAHWOC.js';
 import './chunk-MLKGABMK.js';
@@ -84,17 +84,31 @@ function inlineNavItems(pages) {
   for (const page of pages) {
     if (isPageReference(page)) continue;
     const p = page;
-    if (typeof p.path === "string" && typeof p.name === "string") {
-      items.push({ href: p.path, label: p.name });
-    }
+    if (typeof p.path !== "string" || typeof p.name !== "string") continue;
+    if (p.path.includes(":")) continue;
+    const item = {
+      href: p.path,
+      // `@label` annotation wins; else derive by stripping a trailing
+      // `Page` suffix from `name` (`ContactsPage` → `Contacts`).
+      label: p.label ?? deriveNavLabel(p.name)
+    };
+    if (typeof p.icon === "string") item.icon = p.icon;
+    items.push(item);
   }
   return items;
 }
+function deriveNavLabel(name) {
+  if (name.endsWith("Page") && name.length > "Page".length) {
+    return name.slice(0, -"Page".length);
+  }
+  return name;
+}
 function themeDataKey(theme) {
   if (theme === void 0) return "";
   if (typeof theme === "string") return theme;
   return theme.name;
 }
+var DEFAULT_THEME_KEY = "minimalist-light";
 var OrbitalServerRuntime = class {
   orbitals = /* @__PURE__ */ new Map();
   eventBus;
@@ -115,6 +129,11 @@ var OrbitalServerRuntime = class {
   substrateHandlers = null;
   substrateHandlersPromise = null;
   resolvedSchema = null;
+  /** App-level theme key from the schema's `theme "<key>"` header — the
+   *  `@currentTheme` fallback between an orbital's own `theme` and
+   *  `DEFAULT_THEME_KEY`. Set at registration, before the orbital loops
+   *  (`resolvedSchema` is assigned only after them). */
+  appThemeKey;
   /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
   liveBroadcastSink = null;
   /**
@@ -287,6 +306,7 @@ var OrbitalServerRuntime = class {
     if (this.config.debug) {
       registerLog.debug("register:schema", { name: schema.name });
     }
+    this.appThemeKey = themeDataKey(schema.theme) || void 0;
     if (needsPreprocessing(schema)) {
       await this.ensureLoader();
       if (this.loader) {
@@ -353,6 +373,7 @@ var OrbitalServerRuntime = class {
     if (this.config.debug) {
       registerLog.debug("register:schema-sync", { name: schema.name });
     }
+    this.appThemeKey = themeDataKey(schema.theme) || void 0;
     this.applyIdentityOwnerFields(schema);
     for (const orbital of schema.orbitals) {
       this.registerOrbital(orbital);
@@ -1715,14 +1736,20 @@ var OrbitalServerRuntime = class {
         ...callSiteOverride ?? {}
       };
     }
-    const sigilPages = inlineNavItems(registered.schema.pages);
+    const sigilPages = [];
+    const seenPaths = /* @__PURE__ */ new Set();
+    for (const reg of this.orbitals.values()) {
+      for (const item of inlineNavItems(reg.schema.pages ?? [])) {
+        if (seenPaths.has(item.href)) continue;
+        seenPaths.add(item.href);
+        sigilPages.push(item);
+      }
+    }
     if (sigilPages.length > 0) {
       bindings.pages = sigilPages;
     }
-    const sigilTheme = themeDataKey(registered.schema.theme);
-    if (sigilTheme) {
-      bindings.currentTheme = sigilTheme;
-    }
+    const sigilTheme = themeDataKey(registered.schema.theme) || this.appThemeKey || DEFAULT_THEME_KEY;
+    bindings.currentTheme = sigilTheme;
     const entityFieldDefaults = collectDeclaredEntityDefaults(registered.entity);
     const traitFieldState = registered.traitFieldStates.get(this.sharedFieldKey(registered, traitName));
     if (entityFieldDefaults || traitFieldState) {

package/dist/{chunk-EHFQOBQH.js → chunk-DERIA6MO.js}

@@ -1,5 +1,5 @@
 import { parseCron, cronMinuteKey, cronMatches } from './chunk-OU3ITB5S.js';
-import { createContextFromBindings, interpolateValue, deferEntityBindings } from './chunk-ORBJ5YEQ.js';
+import { createContextFromBindings, interpolateValue, deferEntityBindings } from './chunk-ZJ62H3ES.js';
 import { seedRandom, randomArrayElement, randomInt, shuffleArray, randomPastDate } from './chunk-T4VDAB4C.js';
 import { collectTraitRefsFromValue, collectTraitRefsFromEffects } from './chunk-SCRAHWOC.js';
 import { createLogger, setNamespaceLevel } from '@almadar/logger';

package/dist/{chunk-ORBJ5YEQ.js → chunk-ZJ62H3ES.js}

@@ -113,6 +113,38 @@ function interpolateValue(value, ctx) {
   }
   return value;
 }
+function resolveConfigLeavesInLambdaBody(node, ctx) {
+  if (typeof node === "string") {
+    if (!node.startsWith("@config.") || node.includes(" ")) return node;
+    const resolved = resolveBinding(node, ctx);
+    deferLog.debug("lambda:config-leaf", () => ({
+      binding: node,
+      resolvedType: typeof resolved,
+      selfForward: resolved === node
+    }));
+    return resolved === node ? void 0 : resolved;
+  }
+  if (Array.isArray(node)) {
+    let changed = false;
+    const out = node.map((item) => {
+      const next = resolveConfigLeavesInLambdaBody(item, ctx);
+      if (next !== item) changed = true;
+      return next;
+    });
+    return changed ? out : node;
+  }
+  if (node !== null && typeof node === "object" && !(node instanceof Date)) {
+    let changed = false;
+    const out = {};
+    for (const [key, item] of Object.entries(node)) {
+      const next = resolveConfigLeavesInLambdaBody(item, ctx);
+      if (next !== item) changed = true;
+      out[key] = next;
+    }
+    return changed ? out : node;
+  }
+  return node;
+}
 function deferEntityBindings(value, ctx, configHops = 0) {
   if (typeof value === "string") {
     if (containsEntityBinding(value) && !containsPayloadBinding(value)) {
@@ -133,7 +165,7 @@ function deferEntityBindings(value, ctx, configHops = 0) {
   }
   if (Array.isArray(value)) {
     if (value.length === 3 && value[0] === "fn" && typeof value[1] === "string") {
-      return value;
+      return resolveConfigLeavesInLambdaBody(value, ctx);
     }
     if (isSExpression(value)) {
       if (containsEntityBinding(value) && !containsPayloadBinding(value)) {
@@ -203,7 +235,7 @@ function interpolateArray(value, ctx) {
     return value;
   }
   if (Array.isArray(value) && value.length === 3 && value[0] === "fn" && typeof value[1] === "string") {
-    return value;
+    return resolveConfigLeavesInLambdaBody(value, ctx);
   }
   if (isSExpression(value)) {
     const result = evaluate(value, ctx);

package/dist/entityAccess.js

@@ -1,2 +1,2 @@
-export { accessDeniedMessage, applyRowAccess, checkMutationAccess } from './chunk-ORBJ5YEQ.js';
+export { accessDeniedMessage, applyRowAccess, checkMutationAccess } from './chunk-ZJ62H3ES.js';
 import './chunk-MLKGABMK.js';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, T as TraitDefinition } from './types-BcPORH_x.js';
 export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-BcPORH_x.js';
-import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-DRvduqA7.js';
-export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-DRvduqA7.js';
+import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-Cz5MiWKB.js';
+export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-Cz5MiWKB.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { RenderBindingMarker, SExpr, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -294,18 +294,6 @@ declare function interpolateValue(value: unknown, ctx: EvaluationContext): unkno
 type DeferredPatternValue = RuntimePatternValue | RenderBindingMarker | SExpr | Date | readonly DeferredPatternValue[] | {
     readonly [prop: string]: DeferredPatternValue;
 };
-/**
- * Carry `@entity`-dependent prop leaves into slot content as
- * `RenderBindingMarker`s instead of resolving them at flush time — the
- * renderer (`@almadar/ui`'s SlotContentRenderer) evaluates each marker
- * against the live entity store on every React render, the same model the
- * compiled shell uses. Everything else resolves eagerly through the same
- * `interpolateValue` path the non-deferring executor uses:
- * - payload-referencing leaves stay eager (`@payload` is event-scoped and
- *   does not exist at render time);
- * - `fn` render lambdas pass through raw (they are already render-time);
- * - literal arrays (children lists) and plain objects recurse per item.
- */
 declare function deferEntityBindings(value: SExpr, ctx: EvaluationContext, configHops?: number): DeferredPatternValue;
 /**
  * Check if a value contains any binding references.

package/dist/index.js

@@ -1,8 +1,8 @@
-import { EffectExecutor } from './chunk-EHFQOBQH.js';
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-EHFQOBQH.js';
+import { EffectExecutor } from './chunk-DERIA6MO.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-DERIA6MO.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
-import { createContextFromBindings, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ORBJ5YEQ.js';
-export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-ORBJ5YEQ.js';
+import { createContextFromBindings, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
+export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
 export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-FOFLEZRJ.js';
 export { collectEmbeddedTraits, collectTraitRefsFromResolvedTrait } from './chunk-SCRAHWOC.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.52.0",
+  "version": "6.54.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,11 +57,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.54.0",
-    "@almadar/evaluator": "^2.40.0",
+    "@almadar/core": "^10.61.0",
+    "@almadar/evaluator": "^2.41.0",
     "@almadar/logger": "^1.11.0",
     "@almadar/server": "^2.34.0",
-    "@almadar/std": "^16.167.0"
+    "@almadar/std": "^16.176.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"