@almadar/runtime 6.7.0 → 6.8.1

package/dist/index.d.ts

@@ -390,6 +390,10 @@ interface EntityField {
     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;
@@ -440,10 +444,34 @@ 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.
      */
     private generateFieldValue;
+    /**
+     * Generate 3–5 elements for an array field. When `items` describes an
+     * object shape (the common case for `tiles: [KpiTile]`-style declarations),
+     * each element is recursively mock-generated against `items.properties`.
+     * When `items` describes a scalar, each element uses the scalar generator
+     * for that type. When `items` is missing (legacy `[object] = []` declarations
+     * with no element schema), falls back to an empty array — the historical
+     * behavior.
+     */
+    private generateArrayValue;
+    /**
+     * Generate a single object value with each declared property populated
+     * by faker. Walks `properties` and recursively delegates to
+     * `generateFieldValue` per property so nested objects-of-arrays-of-objects
+     * compose correctly.
+     */
+    private generateObjectValue;
     /**
      * Generate a string value based on the field's declared schema metadata.
      * Reads `values` (enum) first, then `format` (email/url/phone/uuid/date/

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor, createContextFromBindings } from './chunk-QE4EUBYW.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-QE4EUBYW.js';
+import { EffectExecutor, createContextFromBindings } from './chunk-L3FDWEQL.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-L3FDWEQL.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.7.0",
+  "version": "6.8.1",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",