@almadar/runtime 6.59.0 → 6.60.0

package/dist/{OrbitalServerRuntime-PI9Ioxdp.d.ts → OrbitalServerRuntime-Cvw0CUfG.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-TwQ8Dybu.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-BaD_ox7e.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 ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-PI9Ioxdp.js';
-import './types-TwQ8Dybu.js';
+export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-Cvw0CUfG.js';
+import './types-BaD_ox7e.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-WSNZNXZE.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-WSNZNXZE.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-5IFHQDW2.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-5IFHQDW2.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -1542,6 +1542,7 @@ var OrbitalServerRuntime = class {
             data: resultData,
             success: true
           });
+          return resultData;
         } catch (err) {
           effectLog.error("persist:store-mutate-error", {
             action,
@@ -1556,6 +1557,7 @@ var OrbitalServerRuntime = class {
             error: err instanceof Error ? err.message : String(err)
           });
         }
+        return void 0;
       },
       callService: async (service, action, params) => {
         try {

package/dist/ServerBridge.d.ts

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

package/dist/{chunk-WSNZNXZE.js → chunk-5IFHQDW2.js}

@@ -1363,15 +1363,16 @@ var EffectExecutor = class _EffectExecutor {
           } else {
             const entityType = args[1];
             const data = args[2];
-            await this.handlers.persist(action, entityType, data);
-            const dataId = typeof data === "string" ? data : data && typeof data === "object" ? data.id : void 0;
+            const persisted = await this.handlers.persist(action, entityType, data);
+            const successPayload = persisted ?? data;
+            const dataId = typeof successPayload === "string" ? successPayload : successPayload && typeof successPayload === "object" ? successPayload.id : void 0;
             persistLog.debug("persist:success", {
               action,
               entityType,
               dataId,
               willEmit: emitCfg?.success
             });
-            this.emitSuccess(emitCfg, "success", data, true);
+            this.emitSuccess(emitCfg, "success", successPayload, true);
             persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           }
         } catch (err) {
@@ -1974,8 +1975,7 @@ var EffectExecutor = class _EffectExecutor {
   }
 };
 function createTestExecutor(overrides = {}) {
-  const noopAsync = async () => {
-  };
+  const noopAsync = async () => void 0;
   const noop = () => {
   };
   return new EffectExecutor({
@@ -3616,6 +3616,23 @@ function traitEmbedNamesOf(trait) {
   for (const field of Object.values(trait.config ?? {})) walk(field.default);
   return [...found];
 }
+function resolveForwardedSiblingConfig(trait, parent) {
+  const declared = trait.config;
+  const parentDeclared = parent?.config;
+  if (!declared || !parentDeclared) return trait;
+  let next;
+  for (const [key, field] of Object.entries(declared)) {
+    const forward = field.default;
+    if (typeof forward !== "string" || !forward.startsWith("@config.")) continue;
+    const knob = forward.slice("@config.".length);
+    if (knob.length === 0 || knob.includes(".")) continue;
+    const value = parentDeclared[knob]?.default;
+    if (value === void 0 || value === forward) continue;
+    next ??= { ...declared };
+    next[key] = { ...field, default: value };
+  }
+  return next ? { ...trait, config: next } : trait;
+}
 function applyLinkedEntityRename(trait, linkedEntity) {
   const atomLinked = trait.linkedEntity;
   if (!linkedEntity || !atomLinked || linkedEntity === atomLinked) return trait;
@@ -4148,7 +4165,11 @@ var ReferenceResolver = class {
         }
         atomTrait = nested.data.trait;
       }
-      let copy = applyLinkedEntityRename(atomTrait, linkedEntity);
+      const embedder = resolved.find((r) => r.trait.name === parent)?.trait ?? pulled.find((r) => r.trait.name === parent)?.trait;
+      let copy = resolveForwardedSiblingConfig(
+        applyLinkedEntityRename(atomTrait, linkedEntity),
+        embedder
+      );
       if (finalName !== sibling) {
         copy = { ...copy, name: finalName };
         noteRewrite(parent, sibling, finalName);

package/dist/{chunk-FOFLEZRJ.js → chunk-F5W3YZGJ.js}

@@ -134,6 +134,9 @@ function push(entry) {
   scheduleNotify();
 }
 function isEnabled() {
+  return isLogLevelEnabled("DEBUG", PERF_NAMESPACE) || globalThis.__ALMADAR_PERF__ === true;
+}
+function isVerbose() {
   return isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
 }
 function now() {
@@ -161,7 +164,8 @@ function perfEnd(name, startToken, detail) {
     }
   }
   push({ name, durationMs, ts: endTs, detail });
-  log.debug(name, () => ({ durationMs, ...detail ?? {} }));
+  aggregate(name, durationMs);
+  if (isVerbose()) log.debug(name, () => ({ durationMs, ...detail ?? {} }));
 }
 function perfTime(name, fn, detail) {
   const t = perfStart(name);
@@ -171,6 +175,46 @@ function perfTime(name, fn, detail) {
     perfEnd(name, t, detail);
   }
 }
+async function perfTimeAsync(name, fn) {
+  const t = perfStart(name);
+  try {
+    return await fn();
+  } finally {
+    perfEnd(name, t);
+  }
+}
+function perfGauge(name, value) {
+  if (!isEnabled()) return;
+  aggregate(name, value);
+}
+var buckets = /* @__PURE__ */ new Map();
+var dumpTimer = null;
+function aggregate(name, ms) {
+  const b = buckets.get(name);
+  if (b) {
+    b.count++;
+    b.totalMs += ms;
+    if (ms > b.maxMs) b.maxMs = ms;
+  } else {
+    buckets.set(name, { count: 1, totalMs: ms, maxMs: ms });
+  }
+  if (dumpTimer === null) {
+    dumpTimer = setInterval(dumpSummary, 5e3);
+    if (typeof dumpTimer === "object" && "unref" in dumpTimer) dumpTimer.unref();
+  }
+}
+function dumpSummary() {
+  if (buckets.size === 0) return;
+  const rows = [...buckets.entries()].map(([name, b]) => ({
+    name,
+    count: b.count,
+    totalMs: Math.round(b.totalMs),
+    avgMs: Math.round(b.totalMs / b.count * 100) / 100,
+    maxMs: Math.round(b.maxMs * 10) / 10
+  })).sort((a, b) => b.totalMs - a.totalMs);
+  log.warn("[PROFILE] summary", { phases: JSON.stringify(rows) });
+  buckets.clear();
+}
 function getPerfSnapshot() {
   if (ring.length < RING_SIZE) return ring.slice();
   return [...ring.slice(writeIdx), ...ring.slice(0, writeIdx)];
@@ -424,4 +468,4 @@ function bindTraitStateGetter(getter) {
   api.getTraitState = getter;
 }
 
-export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };
+export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };

package/dist/createOsHandlers.d.ts

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

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-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, S as ServiceCallContext, T as TraitDefinition } from './types-TwQ8Dybu.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-TwQ8Dybu.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-PI9Ioxdp.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-PI9Ioxdp.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, S as ServiceCallContext, T as TraitDefinition } from './types-BaD_ox7e.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-BaD_ox7e.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-Cvw0CUfG.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-Cvw0CUfG.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';
+import { RenderBindingMarker, SExpr, RuntimeValue, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
 export { EntityField, normalizeCallSiteConfigToValues } from '@almadar/core';
 export { AccessBindings, applyRowAccess, checkMutationAccess } from './entityAccess.js';
 export { ServerBridgeConfig, ServerBridgeState } from './ServerBridge.js';
 export { OsHandlerContext, OsHandlerResult } from './createOsHandlers.js';
-export { MultiSourceSlotManager, PERF_NAMESPACE, PerfDetail, PerfDetailValue, PerfEntry, PreparedPreviewSchema, RendererContractViolationError, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './ui/index.js';
+export { MultiSourceSlotManager, PERF_NAMESPACE, PerfDetail, PerfDetailValue, PerfEntry, PreparedPreviewSchema, RendererContractViolationError, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './ui/index.js';
 import 'express';
 import '@almadar/core/patterns';
 
@@ -289,7 +289,7 @@ declare function interpolateProps(props: PatternProps, ctx: EvaluationContext):
 /**
  * Interpolate a single value.
  */
-declare function interpolateValue(value: unknown, ctx: EvaluationContext): unknown;
+declare function interpolateValue(value: RuntimeValue, ctx: EvaluationContext): RuntimeValue;
 /**
  * Value a deferred render-ui prop tree can carry: interpolated runtime
  * values, raw pass-through S-expressions (`fn` lambdas), render-time
@@ -419,15 +419,15 @@ declare class EffectExecutor {
     /**
      * Execute a single effect.
      */
-    execute(effect: unknown): Promise<void>;
+    execute(effect: RuntimeValue): Promise<void>;
     /**
      * Execute multiple effects in sequence.
      */
-    executeAll(effects: unknown[]): Promise<void>;
+    executeAll(effects: RuntimeValue[]): Promise<void>;
     /**
      * Execute multiple effects in parallel.
      */
-    executeParallel(effects: unknown[]): Promise<void>;
+    executeParallel(effects: RuntimeValue[]): Promise<void>;
     /**
      * Execute effects and return detailed results for each.
      * Enables compensating transitions by reporting which effects failed.
@@ -435,7 +435,7 @@ declare class EffectExecutor {
      * Unlike `executeAll`, this method does NOT throw on effect errors.
      * Instead, it captures errors in the returned `EffectResult[]` array.
      */
-    executeWithResults(effects: unknown[]): Promise<EffectResult[]>;
+    executeWithResults(effects: RuntimeValue[]): Promise<EffectResult[]>;
     private extractEmitConfig;
     /** Build the source metadata stamp for an emit fired from this trait. */
     private sourceStamp;

package/dist/index.js

@@ -1,10 +1,10 @@
-import { EffectExecutor } from './chunk-WSNZNXZE.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-WSNZNXZE.js';
+import { EffectExecutor } from './chunk-5IFHQDW2.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-5IFHQDW2.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.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 { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-F5W3YZGJ.js';
 export { collectEmbeddedTraits, collectTraitRefsFromResolvedTrait } from './chunk-SCRAHWOC.js';
 import { __export } from './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
@@ -416,6 +416,7 @@ function createServerEffectHandlers(opts) {
           data: resultData,
           success: true
         });
+        return resultData;
       } catch (err) {
         effectLog.error("persist:store-mutate-error", {
           action,
@@ -430,6 +431,7 @@ function createServerEffectHandlers(opts) {
           error: err instanceof Error ? err.message : String(err)
         });
       }
+      return void 0;
     },
     callService: async (service, action, params) => {
       try {

package/dist/{types-TwQ8Dybu.d.ts → types-BaD_ox7e.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, NavItem } 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, RuntimeValue } from '@almadar/core';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -149,8 +149,19 @@ interface EffectHandlers {
      * `fetch` success envelopes, cascade re-emits).
      */
     emit: (event: string, payload?: EventPayload, source?: RuntimeEvent['source'], fromPersistSuccess?: boolean) => void;
-    /** Persist data (create/update/delete/batch) */
-    persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<void>;
+    /**
+     * Persist data (create/update/delete/batch).
+     *
+     * Returns the persisted ROW — for a create that is the submitted data
+     * plus the store-minted `id`, which the caller's `emit:{success}`
+     * envelope carries. Without it a `*_CREATED` listener sees no id (the
+     * compiled path emits the created row), so anything routing on the new
+     * row's identity — navigating to the page just created — worked in one
+     * execution path only. Implementations that have no row to hand back
+     * (batch, a denied write, a no-op stub) return undefined and the
+     * envelope falls back to the submitted data.
+     */
+    persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<EntityRow | undefined>;
     /** Set a field value on an entity */
     set: (entityId: string, field: string, value: FieldValue) => void;
     /** Call an external service. `context` carries the caller's identity
@@ -371,7 +382,7 @@ interface BindingContext {
      * a `let` body's effects resolve their value expressions against the
      * `let`-bound locals.
      */
-    locals?: Map<string, unknown>;
+    locals?: Map<string, RuntimeValue>;
     /** Additional custom bindings */
     [key: string]: unknown;
 }

package/dist/ui/index.d.ts

@@ -339,6 +339,10 @@ declare function perfStart(name: string): number;
 declare function perfEnd(name: string, startToken: number, detail?: PerfDetail): void;
 /** Synchronous wrapper that times a fn end-to-end. */
 declare function perfTime<T>(name: string, fn: () => T, detail?: PerfDetail): T;
+/** Async wrapper — the tick/effect paths are async end-to-end. */
+declare function perfTimeAsync<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+/** Record a non-duration scalar (queue depth, entries/pass) into the summary. */
+declare function perfGauge(name: string, value: number): void;
 declare function getSnapshot(): readonly PerfEntry[];
 declare function subscribe(fn: () => void): () => void;
 /** Push a pre-computed entry (e.g. React.Profiler callback). */
@@ -416,4 +420,4 @@ declare function bindEventBus(eventBus: VerificationBus): void;
  */
 declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
 
-export { type MultiSourceSlotManager, PERF_NAMESPACE, type PerfDetail, type PerfDetailValue, type PerfEntry, type PreparedPreviewSchema, RendererContractViolationError, type ResolvedPageTraits, type SlotContent, type SlotContentValidationError, type SlotManager, type SlotSource, type VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };
+export { type MultiSourceSlotManager, PERF_NAMESPACE, type PerfDetail, type PerfDetailValue, type PerfEntry, type PreparedPreviewSchema, RendererContractViolationError, type ResolvedPageTraits, type SlotContent, type SlotContentValidationError, type SlotManager, type SlotSource, type VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };

package/dist/ui/index.js

@@ -1,3 +1,3 @@
-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 { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from '../chunk-F5W3YZGJ.js';
 export { collectEmbeddedTraits, collectTraitRefsFromResolvedTrait } from '../chunk-SCRAHWOC.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.59.0",
+  "version": "6.60.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.68.0",
-    "@almadar/evaluator": "^2.41.0",
+    "@almadar/core": "^10.69.0",
+    "@almadar/evaluator": "^2.42.0",
     "@almadar/logger": "^1.11.0",
-    "@almadar/server": "^2.37.0",
-    "@almadar/std": "^16.184.0"
+    "@almadar/server": "^2.38.0",
+    "@almadar/std": "^16.185.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"