@almadar/runtime 6.51.0 → 6.53.0

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

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-CL03tjGU.js';
+import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-BcPORH_x.js';
 import { EventPayload, EventId, EntityRow, UserContext, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, RawUserClaims, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**

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-DD9FKDpN.js';
-import './types-CL03tjGU.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-DRvduqA7.js';
+import './types-BcPORH_x.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,14 +1,14 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-BNTXTICR.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-BNTXTICR.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-XLMDWRMB.js';
+import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
 import './chunk-SCRAHWOC.js';
 import './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 import * as nodeModule from 'module';
 import { evaluateListenPayloadExpr, evaluateGuard, evaluate } from '@almadar/evaluator';
-import { DEFAULT_VIEWER, buildResolvedTraitConfigs, isInlineTrait, isEntityCall, applyListenPayloadMapping, personaFromIdentityRow, normalizeUserContext, isRuntimeEntity } from '@almadar/core';
+import { DEFAULT_VIEWER, buildResolvedTraitConfigs, isInlineTrait, isEntityCall, applyListenPayloadMapping, personaFromIdentityRow, normalizeUserContext, isRuntimeEntity, isPageReference } from '@almadar/core';
 import { ownerFieldsFromSchema, identityEntityName, entityAccessPolicies } from '@almadar/core/mock';
 
 // src/identity/routing.ts
@@ -79,6 +79,36 @@ function needsPreprocessing(schema) {
   }
   return false;
 }
+function inlineNavItems(pages) {
+  const items = [];
+  for (const page of pages) {
+    if (isPageReference(page)) continue;
+    const p = page;
+    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;
@@ -1699,6 +1729,20 @@ var OrbitalServerRuntime = class {
         ...callSiteOverride ?? {}
       };
     }
+    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) || 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/ServerBridge.d.ts

@@ -1,4 +1,4 @@
-import { I as IEventBus } from './types-CL03tjGU.js';
+import { I as IEventBus } from './types-BcPORH_x.js';
 import { EventPayload } from '@almadar/core';
 
 /**

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

@@ -1,5 +1,5 @@
 import { parseCron, cronMinuteKey, cronMatches } from './chunk-OU3ITB5S.js';
-import { createContextFromBindings, interpolateValue, deferEntityBindings } from './chunk-XLMDWRMB.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-XLMDWRMB.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)) {
@@ -170,6 +202,15 @@ function interpolateString(value, ctx) {
         inFlightConfigRecursions.delete(value);
       }
     }
+    if (value.startsWith("@config.") && typeof resolved === "string" && resolved.startsWith("@") && isPureBinding(resolved) && !isClientOnlyBinding(resolved) && !inFlightConfigRecursions.has(value)) {
+      inFlightConfigRecursions.add(value);
+      try {
+        bindLog.debug("resolve:config-default-binding", { binding: value, resolvesTo: resolved });
+        return interpolateString(resolved, ctx);
+      } finally {
+        inFlightConfigRecursions.delete(value);
+      }
+    }
     return resolved;
   }
   if (value.includes("@")) {
@@ -194,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);
@@ -283,6 +324,12 @@ function createContextFromBindings(bindings, strictBindings, contextExtensions)
   if (bindings.user) {
     ctx.user = bindings.user;
   }
+  if (bindings.pages) {
+    ctx.pages = bindings.pages;
+  }
+  if (bindings.currentTheme) {
+    ctx.currentTheme = bindings.currentTheme;
+  }
   if (bindings.locals) {
     ctx.locals = bindings.locals;
   }

package/dist/createOsHandlers.d.ts

@@ -1,4 +1,4 @@
-import { E as EffectHandlers } from './types-CL03tjGU.js';
+import { E as EffectHandlers } from './types-BcPORH_x.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/entityAccess.js

@@ -1,2 +1,2 @@
-export { accessDeniedMessage, applyRowAccess, checkMutationAccess } from './chunk-XLMDWRMB.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-CL03tjGU.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-CL03tjGU.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-DD9FKDpN.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-DD9FKDpN.js';
+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 { 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-BNTXTICR.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-BNTXTICR.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-XLMDWRMB.js';
-export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-XLMDWRMB.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/dist/{types-CL03tjGU.d.ts → types-BcPORH_x.d.ts}

@@ -1,5 +1,5 @@
 import * as _almadar_core from '@almadar/core';
-import { TraitId, EventId, SExpr, TraitEventListener, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, EventPayload, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1, UserContext } from '@almadar/core';
+import { TraitId, EventId, SExpr, TraitEventListener, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, EventPayload, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1, UserContext, NavItem } from '@almadar/core';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -326,6 +326,18 @@ interface BindingContext {
     config?: ConfigContext;
     /** Authenticated viewer behind `@user.x` — ownership (`@user.id`) and role gates. */
     user?: UserContext;
+    /**
+     * The host orbital's pages for the `@pages` render sigil (`href`/`label`
+     * per inline page). Seeded onto the render binding context only — never
+     * present on a guard/tick context. Mirrors the compiler's
+     * `OirBindingRoot::Pages`.
+     */
+    pages?: NavItem[];
+    /**
+     * The `data-theme` key string for the `@currentTheme` render sigil,
+     * derived from the host orbital's `Orbital.theme`. Render-context only.
+     */
+    currentTheme?: string;
     /**
      * Local variables introduced by a `let` form, keyed by bare name and
      * referenced via `@<name>` (the canonical evaluator convention — same as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.51.0",
+  "version": "6.53.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.52.0",
-    "@almadar/evaluator": "^2.39.0",
+    "@almadar/core": "^10.55.0",
+    "@almadar/evaluator": "^2.40.0",
     "@almadar/logger": "^1.11.0",
     "@almadar/server": "^2.34.0",
-    "@almadar/std": "^16.163.0"
+    "@almadar/std": "^16.168.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"