@almadar/runtime 6.58.0 → 6.59.0

package/dist/{OrbitalServerRuntime-Dn9dIwJk.d.ts → OrbitalServerRuntime-PI9Ioxdp.d.ts}

@@ -974,6 +974,16 @@ interface OrbitalEventRequest {
     user?: RawUserClaims;
     /** Per-tab client identity (UUID) — excludes this request's origin from live-broadcast delivery. */
     clientId?: string;
+    /**
+     * Broadcast-class marker (T6, docs/Almadar_Tick_Loop.md §3a): the name of
+     * the tick that emitted this event. Tick-stamped dispatches are
+     * latest-state broadcasts — the client fires them without awaiting the
+     * response, and the server relays them to OTHER tabs coalesced
+     * (newest-per-key) at a snapshot rate instead of 1:1.
+     */
+    tick?: string;
+    /** Emitting trait for a tick-stamped dispatch — builds the relay's BusEventSource (sourceless emits are dropped client-side). */
+    sourceTrait?: string;
 }
 /**
  * One persist-envelope success emit, handed to the live-broadcast sink
@@ -1072,6 +1082,12 @@ interface LoaderConfig {
 interface OrbitalServerRuntimeConfig {
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Snapshot cadence (ms) for relaying tick-stamped broadcasts to other
+     * clients — newest-per-(client, orbital, event) wins between flushes
+     * (T6, docs/Almadar_Tick_Loop.md §3a). Default 50 (≈20Hz).
+     */
+    tickRelayIntervalMs?: number;
     /** Custom effect handlers (for integrating with your data layer) */
     effectHandlers?: Partial<EffectHandlers>;
     /** Persistence adapter for entity data */
@@ -1162,6 +1178,14 @@ declare class OrbitalServerRuntime {
     private appThemeKey;
     /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
     private liveBroadcastSink;
+    /**
+     * Tick-broadcast relay (T6): newest pending item per
+     * (originClientId, orbital, event), flushed to the live-broadcast sink on
+     * the `tickRelayIntervalMs` cadence — other tabs get the latest position
+     * at snapshot rate, never 1:1 with emissions.
+     */
+    private readonly tickRelayPending;
+    private tickRelayTimer;
     /**
      * Trait name -> resolved `TraitConfig`, computed once per `register()` via
      * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -1382,6 +1406,13 @@ declare class OrbitalServerRuntime {
     setDefaultUser(user: UserContext | undefined): void;
     /** The viewer a dev host is currently presenting the app as. */
     getDefaultUser(): UserContext | undefined;
+    /**
+     * Queue a tick-stamped dispatch for coalesced snapshot relay (T6). Newest
+     * per (originClientId, orbital, event) wins between flushes — the standard
+     * netcode position-broadcast discipline.
+     */
+    private queueTickRelay;
+    private flushTickRelay;
     /**
      * The registered app's declared persona roster: the live rows of its
      * `[identity]` entity, mapped onto viewers (`Almadar_LOLO_Identity.md` §4.3).

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-Dn9dIwJk.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-PI9Ioxdp.js';
 import './types-TwQ8Dybu.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-MMVKKLAP.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-MMVKKLAP.js';
+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 { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -137,6 +137,14 @@ var OrbitalServerRuntime = class {
   appThemeKey;
   /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
   liveBroadcastSink = null;
+  /**
+   * Tick-broadcast relay (T6): newest pending item per
+   * (originClientId, orbital, event), flushed to the live-broadcast sink on
+   * the `tickRelayIntervalMs` cadence — other tabs get the latest position
+   * at snapshot rate, never 1:1 with emissions.
+   */
+  tickRelayPending = /* @__PURE__ */ new Map();
+  tickRelayTimer = null;
   /**
    * Trait name -> resolved `TraitConfig`, computed once per `register()` via
    * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -1047,6 +1055,37 @@ var OrbitalServerRuntime = class {
   getDefaultUser() {
     return this.config.defaultUser;
   }
+  /**
+   * Queue a tick-stamped dispatch for coalesced snapshot relay (T6). Newest
+   * per (originClientId, orbital, event) wins between flushes — the standard
+   * netcode position-broadcast discipline.
+   */
+  queueTickRelay(orbitalName, request) {
+    const key = `${request.clientId ?? ""}:${orbitalName}:${request.event}`;
+    this.tickRelayPending.set(key, {
+      event: request.event,
+      payload: request.payload,
+      source: { orbital: orbitalName, trait: request.sourceTrait, tick: request.tick },
+      originClientId: request.clientId
+    });
+    if (this.tickRelayTimer === null) {
+      const timer = setInterval(() => this.flushTickRelay(), this.config.tickRelayIntervalMs ?? 50);
+      if (typeof timer === "object" && typeof timer.unref === "function") timer.unref();
+      this.tickRelayTimer = timer;
+    }
+  }
+  flushTickRelay() {
+    if (this.tickRelayPending.size === 0) {
+      if (this.tickRelayTimer !== null) {
+        clearInterval(this.tickRelayTimer);
+        this.tickRelayTimer = null;
+      }
+      return;
+    }
+    const items = Array.from(this.tickRelayPending.values());
+    this.tickRelayPending.clear();
+    for (const item of items) this.liveBroadcastSink?.(item);
+  }
   /**
    * The registered app's declared persona roster: the live rows of its
    * `[identity]` entity, mapped onto viewers (`Almadar_LOLO_Identity.md` §4.3).
@@ -1252,6 +1291,9 @@ var OrbitalServerRuntime = class {
       if (effectResults.length > 0) {
         response.effectResults = effectResults;
       }
+      if (request.tick !== void 0 && this.liveBroadcastSink !== null) {
+        this.queueTickRelay(orbitalName, request);
+      }
       return response;
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);

package/dist/{chunk-MMVKKLAP.js → chunk-WSNZNXZE.js}

@@ -234,9 +234,9 @@ var TickScheduler = class {
       }
       tick.accumulatedMs += timestamp - tick.lastTimestamp;
       tick.lastTimestamp = timestamp;
-      while (tick.accumulatedMs >= tick.intervalMs) {
-        tick.accumulatedMs -= tick.intervalMs;
+      if (tick.accumulatedMs >= tick.intervalMs) {
         tick.onDue();
+        tick.accumulatedMs = tick.accumulatedMs % tick.intervalMs;
       }
     }
   }

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, 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-Dn9dIwJk.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-Dn9dIwJk.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 { 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';
@@ -146,8 +146,13 @@ declare function createUnifiedLoader(options: UnifiedLoaderOptions): UnifiedLoad
  * isn't available, e.g. Node/SSR) that walks every registered tick each pass
  * and fires whichever one(s) have crossed their own interval — so ticks due
  * in the same pass commit together instead of on independent, uncoordinated
- * timers. Framework-light: no React, usable from `OrbitalServerRuntime`
- * (this package) and from `@almadar/ui`'s `useTraitStateMachine` alike.
+ * timers. Each interval tick fires AT MOST ONCE per pass: missed beats are
+ * dropped (the phase remainder is kept, so healthy cadence is unchanged),
+ * because bursting catch-up firings after a slow pass multiplies the work
+ * that made the pass slow — an unbounded accumulator is a spiral-of-death
+ * amplifier that pegs the main thread and starves input. Framework-light:
+ * no React, usable from `OrbitalServerRuntime` (this package) and from
+ * `@almadar/ui`'s `useTraitStateMachine` alike.
  *
  * @packageDocumentation
  */

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor } from './chunk-MMVKKLAP.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-MMVKKLAP.js';
+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';
 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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.58.0",
+  "version": "6.59.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.67.0",
+    "@almadar/core": "^10.68.0",
     "@almadar/evaluator": "^2.41.0",
     "@almadar/logger": "^1.11.0",
     "@almadar/server": "^2.37.0",
-    "@almadar/std": "^16.183.0"
+    "@almadar/std": "^16.184.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"