@almadar/runtime 5.8.1 → 5.8.3

package/dist/{OrbitalServerRuntime-BP5sz5Bn.d.ts → OrbitalServerRuntime-Bv8y7nIu.d.ts}

@@ -1,6 +1,7 @@
+import * as _almadar_core from '@almadar/core';
+import { EventPayload, EntityRow, OrbitalSchema, Orbital, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, Entity, TraitConfig, TraitTick } from '@almadar/core';
 import { Router } from 'express';
 import { I as IEventBus, g as RuntimeEvent, f as EventListener, U as Unsubscribe, T as TraitDefinition, R as RuntimeConfig, i as TransitionObserver, C as ConfigContext, h as TraitState, j as TransitionResult, E as EvaluationContextExtensions, a as EffectHandlers } from './types-ByLpy6yj.js';
-import { EventPayload, EntityRow, OrbitalSchema, Orbital, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, Entity, TraitConfig, TraitTick } from '@almadar/core';
 import { P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';
 
 /**
@@ -657,41 +658,6 @@ declare function parseNamespacedEvent(eventName: string): {
     event: string;
 };
 
-/**
- * OrbitalServerRuntime - Dynamic Server-Side Orbital Execution
- *
- * This runtime takes an OrbitalSchema and dynamically:
- * 1. Registers all orbitals and their traits
- * 2. Creates Express routes for trait communication
- * 3. Executes state machines server-side
- * 4. Handles cross-orbital event propagation
- *
- * This is the "interpreted" mode - no compilation needed.
- * The compiler generates equivalent static code for production.
- *
- * @example
- * ```typescript
- * import { OrbitalServerRuntime } from '@kflow-builder/shared/runtime';
- * import express from 'express';
- *
- * const app = express();
- * const runtime = new OrbitalServerRuntime();
- *
- * // Register schema (can be loaded from file, API, etc.)
- * runtime.register(orbitalSchema);
- *
- * // Mount orbital routes
- * app.use('/api/orbitals', runtime.router());
- *
- * // Client can now:
- * // POST /api/orbitals/:orbital/events  - Send event to orbital
- * // GET  /api/orbitals/:orbital/state   - Get current state
- * // GET  /api/orbitals                  - List registered orbitals
- * ```
- *
- * @packageDocumentation
- */
-
 /**
  * Client-side effect tuple shipped in `OrbitalEventResponse.clientEffects`.
  * Restricted to the three effect kinds the client knows how to apply to the
@@ -889,6 +855,49 @@ interface OrbitalServerRuntimeConfig {
     contextExtensions?: EvaluationContextExtensions;
 }
 
+/**
+ * Check whether a schema needs preprocessing (has `uses` declarations or
+ * un-inlined cross-orbital trait references).
+ *
+ * Cross-orbital refs are trait entries like
+ * `{ ref: "Modal.traits.ModalRecordModal", ... }` with no inline
+ * `stateMachine`. If these aren't resolved before `register()` runs, the
+ * trait binder produces an empty state machine and all interactions
+ * targeting the trait are silently dropped.
+ */
+/**
+ * Walk a trait's DECLARED config schema (`{ icon: { type, default }, ... }`)
+ * and collect a flat `{ icon: <default>, ... }` map of just the default
+ * values. Used to seed the `@config.X` binding context with the atom's
+ * own declared defaults before any call-site override is applied. Mirrors
+ * the compiled path's `DEFAULT_<TRAIT>_CONFIG` constant emitted by
+ * backend.rs's Solution-1 plumbing.
+ *
+ * Returns `undefined` when the trait has no config schema or none of its
+ * fields declare a default — keeps the caller's existing fast-path.
+ */
+/**
+ * Structural shape that both `@almadar/core`'s `Trait` and
+ * `ResolvedTrait` satisfy: a `config?` map keyed by field name whose
+ * values either carry a `default` (the declared-schema form loaded
+ * from `.orb`) or are bare values (the runtime-resolved form).
+ *
+ * Widening to a structural parameter lets callers from the resolved
+ * side (e.g., `@almadar/ui`'s `useTraitStateMachine`) pass their own
+ * `ResolvedTrait` without an `as unknown as` cast.
+ */
+/**
+ * Read the `default` from each field of a trait's declared
+ * `config { }` schema and return the flat `{ key: default, ... }`
+ * map. Used to seed `@config.X` binding context with the atom's
+ * own declared defaults before any call-site override is applied.
+ *
+ * Mirrors the compiled path's `DEFAULT_<TRAIT>_CONFIG` constant
+ * emitted by `backend.rs` Solution-1.
+ */
+declare function collectDeclaredConfigDefaults(trait: {
+    config?: _almadar_core.DeclaredTraitConfig;
+} | undefined): TraitConfig | undefined;
 declare class OrbitalServerRuntime {
     protected orbitals: Map<string, RegisteredOrbital>;
     private eventBus;
@@ -1126,4 +1135,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { type ClientNavigateTuple as A, type ClientNotifyTuple as B, type ClientEffectTuple as C, type ClientRenderUITuple as D, type EntitySharingMap as E, type EffectResult as F, type LoaderConfig as G, OrbitalServerRuntime as H, type ImportChainLike as I, type RuntimeTraitTick as J, createOrbitalServerRuntime as K, type LoadResult as L, type OrbitalEventRequest as O, type PreprocessOptions as P, type RegisteredOrbital as R, type SchemaLoader as S, type UnifiedLoaderOptions as U, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, type OrbitalEventResponse as e, type OrbitalServerRuntimeConfig as f, type PreprocessResult as g, type PreprocessedSchema as h, type ProcessEventOptions as i, type RuntimeOrbital as j, type RuntimeOrbitalSchema as k, type RuntimeTrait as l, StateMachineManager as m, createInitialTraitState as n, findInitialState as o, findTransition as p, getIsolatedCollectionName as q, getNamespacedEvent as r, isBrowser as s, isElectron as t, isNamespacedEvent as u, isNode as v, normalizeEventKey as w, parseNamespacedEvent as x, preprocessSchema as y, processEvent as z };
+export { processEvent as A, type ClientNavigateTuple as B, type ClientEffectTuple as C, type ClientNotifyTuple as D, type EntitySharingMap as E, type ClientRenderUITuple as F, type EffectResult as G, type LoaderConfig as H, type ImportChainLike as I, OrbitalServerRuntime as J, type RuntimeTraitTick as K, type LoadResult as L, createOrbitalServerRuntime as M, type OrbitalEventRequest as O, type PreprocessOptions as P, type RegisteredOrbital as R, type SchemaLoader as S, type UnifiedLoaderOptions as U, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, type OrbitalEventResponse as e, type OrbitalServerRuntimeConfig as f, type PreprocessResult as g, type PreprocessedSchema as h, type ProcessEventOptions as i, type RuntimeOrbital as j, type RuntimeOrbitalSchema as k, type RuntimeTrait as l, StateMachineManager as m, collectDeclaredConfigDefaults as n, createInitialTraitState as o, findInitialState as p, findTransition as q, getIsolatedCollectionName as r, getNamespacedEvent as s, isBrowser as t, isElectron as u, isNamespacedEvent as v, isNode as w, normalizeEventKey as x, parseNamespacedEvent as y, preprocessSchema as z };

package/dist/OrbitalServerRuntime.d.ts

@@ -1,5 +1,5 @@
+import '@almadar/core';
 import 'express';
-export { C as ClientEffectTuple, A as ClientNavigateTuple, B as ClientNotifyTuple, D as ClientRenderUITuple, F as EffectResult, G as LoaderConfig, O as OrbitalEventRequest, e as OrbitalEventResponse, H as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, R as RegisteredOrbital, j as RuntimeOrbital, k as RuntimeOrbitalSchema, l as RuntimeTrait, J as RuntimeTraitTick, K as createOrbitalServerRuntime } from './OrbitalServerRuntime-BP5sz5Bn.js';
+export { C as ClientEffectTuple, B as ClientNavigateTuple, D as ClientNotifyTuple, F as ClientRenderUITuple, G as EffectResult, H as LoaderConfig, O as OrbitalEventRequest, e as OrbitalEventResponse, J as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, R as RegisteredOrbital, j as RuntimeOrbital, k as RuntimeOrbitalSchema, l as RuntimeTrait, K as RuntimeTraitTick, n as collectDeclaredConfigDefaults, M as createOrbitalServerRuntime } from './OrbitalServerRuntime-Bv8y7nIu.js';
 import './types-ByLpy6yj.js';
-import '@almadar/core';
 export { I as InMemoryPersistence, P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';