@almadar/runtime 6.8.0 → 6.9.0

package/dist/index.d.ts

@@ -4,7 +4,8 @@ import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L a
 export { d as EntitySharingMap, e as EventBus, f as EventNamespaceMap, O as OrbitalEventRequest, j as OrbitalEventResponse, l as OrbitalServerRuntimeConfig, P as PreprocessOptions, m as PreprocessResult, n as PreprocessedSchema, o as ProcessEventOptions, R as RegisteredOrbital, p as RuntimeOrbital, q as RuntimeOrbitalSchema, r as RuntimeTrait, t as StateMachineManager, u as collectDeclaredConfigDefaults, v as createInitialTraitState, x as findInitialState, y as findTransition, z as getIsolatedCollectionName, A as getNamespacedEvent, B as isBrowser, D as isElectron, F as isNamespacedEvent, G as isNode, H as normalizeEventKey, J as parseNamespacedEvent, K as preprocessSchema, M as processEvent } from './OrbitalServerRuntime-CzUrdroI.js';
 import { EvaluationContext } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
-import { EventPayload, EntityRow, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
+import { EventPayload, EntityField, EntityRow, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
+export { EntityField } from '@almadar/core';
 import { P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';
 export { I as InMemoryPersistence } from './PersistenceAdapter-B6dQCbbU.js';
 export { ServerBridgeConfig, ServerBridgeState } from './ServerBridge.js';
@@ -382,22 +383,16 @@ declare function createClientEffectHandlers(options: CreateClientEffectHandlersO
  * @packageDocumentation
  */
 
-interface EntityField {
+/** EntityField narrowed to require `name`. The canonical type makes `name`
+ *  optional (it's omitted on nested `items` / `properties` descriptors), but
+ *  the seed loop iterates by name. Callers filter for name-having fields
+ *  at the registerEntity boundary. */
+type NamedEntityField = EntityField & {
     name: string;
-    type: string;
-    required?: boolean;
-    values?: string[];
-    default?: unknown;
-    /** Validation format: email/url/phone/date/datetime/uuid. Drives mock-value shape without name heuristics. */
-    format?: 'email' | 'url' | 'phone' | 'date' | 'datetime' | 'uuid' | 'image' | 'avatar' | 'thumbnail';
-    /** Element schema for `type: 'array'`. When omitted, arrays default to []. Mirrors `ArrayEntityField.items` in @almadar/core. */
-    items?: EntityField;
-    /** Property schemas for `type: 'object'` (or array-of-object via `items.properties`). Mirrors `EntityFieldBase.properties` in @almadar/core. */
-    properties?: Record<string, EntityField>;
-}
+};
 interface EntitySchema {
     name: string;
-    fields: EntityField[];
+    fields: NamedEntityField[];
     /** Pre-authored instance data from the schema (used instead of faker generation) */
     seedData?: EntityRow[];
 }
@@ -432,6 +427,20 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
      * Otherwise, random mock data is generated with faker.
      */
     registerEntity(schema: EntitySchema, seedCount?: number): void;
+    /**
+     * Walk every row of every registered entity and fill in `type: "relation"`
+     * fields with real IDs from the target entity's store. Without this pass,
+     * relation fields stay as placeholder `[]` / `""` and `populateRelations`
+     * in OrbitalServerRuntime has nothing to hydrate — catalog/preview demos
+     * of nested-tree atoms (e.g. std-thread-comments-linear with ThreadPost.
+     * replies → [ThreadPost]) render empty reply cards.
+     *
+     * For self-referential relations, each row gets 2–4 sibling IDs (excluding
+     * self). For cross-entity relations, IDs are picked from the target store.
+     * The runtime caps recursion at depth=2 in `populateRelations`, so
+     * grandparent-of-self cycles render two levels deep then stop.
+     */
+    linkRelationFields(): void;
     /**
      * Seed an entity with pre-authored instance data.
      */
@@ -444,6 +453,13 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
      * Generate a single mock item based on field schemas.
      */
     private generateMockItem;
+    /** Max nesting depth for recursive array/object schemas (e.g. a Comment
+     *  entity whose `replies: [Comment]` field references itself). Without
+     *  this guard, generateArrayValue → generateObjectValue → generateArray…
+     *  recurses until stack overflow on every recursive type. Three levels
+     *  is enough to render a useful thread depth (parent → reply → sub-reply)
+     *  in catalog/preview without blowing the fixture. */
+    private static MAX_NESTED_DEPTH;
     /**
      * Generate a mock value for a field based on its schema.
      */
@@ -886,4 +902,4 @@ declare namespace index {
   export { type index_ComposeBehaviorsInput as ComposeBehaviorsInput, type index_ComposeBehaviorsResult as ComposeBehaviorsResult, type index_EventWiringEntry as EventWiringEntry, type index_LayoutStrategy as LayoutStrategy, type index_PipeStep as PipeStep, index_applyEventWiring as applyEventWiring, index_composeBehaviors as composeBehaviors, index_detectLayoutStrategy as detectLayoutStrategy, index_pipeBehaviors as pipeBehaviors };
 }
 
-export { BindingContext, type ClientEventBus, type ComposeBehaviorsInput, type ComposeBehaviorsResult, type CreateClientEffectHandlersOptions, type CreateServerEffectHandlersOptions, EffectContext, EffectExecutor, type EffectExecutorOptions, EffectHandlers, EffectResult, type EntityField, type EntitySchema, type EventWiringEntry, ExecutionEnvironment, ImportChainLike, type LayoutStrategy, LoadResult, LoadedOrbital, LoadedSchema, MockPersistenceAdapter, type MockPersistenceConfig, type PayloadMismatch, type PayloadValidationFailure, PersistenceAdapter, type PipeStep, SchemaLoader, type ServerEffectResult, type SlotSetter, TraitDefinition, UnifiedLoaderOptions, applyEventWiring, buildEmitsFromTraits, composeBehaviors, index as composition, containsBindings, createClientEffectHandlers, createContextFromBindings, createMockPersistence, createServerEffectHandlers, createTestExecutor, createUnifiedLoader, detectLayoutStrategy, extractBindings, formatPayloadValidationError, interpolateProps, interpolateValue, pipeBehaviors, validateEventPayload, validatePayloadShapes };
+export { BindingContext, type ClientEventBus, type ComposeBehaviorsInput, type ComposeBehaviorsResult, type CreateClientEffectHandlersOptions, type CreateServerEffectHandlersOptions, EffectContext, EffectExecutor, type EffectExecutorOptions, EffectHandlers, EffectResult, type EntitySchema, type EventWiringEntry, ExecutionEnvironment, ImportChainLike, type LayoutStrategy, LoadResult, LoadedOrbital, LoadedSchema, MockPersistenceAdapter, type MockPersistenceConfig, type PayloadMismatch, type PayloadValidationFailure, PersistenceAdapter, type PipeStep, SchemaLoader, type ServerEffectResult, type SlotSetter, TraitDefinition, UnifiedLoaderOptions, applyEventWiring, buildEmitsFromTraits, composeBehaviors, index as composition, containsBindings, createClientEffectHandlers, createContextFromBindings, createMockPersistence, createServerEffectHandlers, createTestExecutor, createUnifiedLoader, detectLayoutStrategy, extractBindings, formatPayloadValidationError, interpolateProps, interpolateValue, pipeBehaviors, validateEventPayload, validatePayloadShapes };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor, createContextFromBindings } from './chunk-WOXI5KCA.js';
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, buildEmitsFromTraits, collectDeclaredConfigDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createMockPersistence, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-WOXI5KCA.js';
+import { EffectExecutor, createContextFromBindings } from './chunk-TNK77RLG.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, buildEmitsFromTraits, collectDeclaredConfigDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createMockPersistence, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-TNK77RLG.js';
 import { __export } from './chunk-PZ5AY32C.js';
 import { createLogger } from '@almadar/logger';
 import { evaluate } from '@almadar/evaluator';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.8.0",
+  "version": "6.9.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^7.8.0",
+    "@almadar/core": "^9.2.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/logger": "^1.0.0",
     "@almadar/std": ">=7.2.4",