@almadar/runtime 6.61.0 → 6.63.0

package/dist/{OrbitalServerRuntime-CZHHxo_A.d.ts → OrbitalServerRuntime-nqwGldMC.d.ts}

@@ -767,6 +767,11 @@ declare function preprocessSchema(schema: OrbitalSchema, options: PreprocessOpti
  *
  * - `persistent` entities share the same collection
  * - `runtime` entities get isolated collections per orbital
+ *
+ * NOTE: the runtime's own store keying does NOT go through this helper —
+ * `MockPersistenceAdapter` resolves entity → store via its declared
+ * `collection` directly (collection-keyed stores, 2026-08-29). This stays
+ * exported for external consumers computing display/derived names only.
  */
 declare function getIsolatedCollectionName(orbitalName: string, entitySharing: EntitySharingMap): string;
 /**

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-CZHHxo_A.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-nqwGldMC.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-QY5EUGR2.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-QY5EUGR2.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-C7SIRVGS.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-C7SIRVGS.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -707,6 +707,7 @@ var OrbitalServerRuntime = class {
         this.persistence.registerEntity({
           name: entity.name,
           id: entity.id,
+          collection: entity.collection,
           fields,
           persistence: entity.persistence
         });
@@ -727,6 +728,7 @@ var OrbitalServerRuntime = class {
         this.persistence.registerEntity({
           name: auxEntity.name,
           id: auxEntity.id,
+          collection: auxEntity.collection,
           fields: auxFields,
           persistence: auxEntity.persistence
         });
@@ -1015,10 +1017,25 @@ var OrbitalServerRuntime = class {
         this.persistence.registerEntity({
           name: entity.name,
           id: entity.id,
+          collection: entity.collection,
           fields,
           persistence: entity.persistence
         });
       }
+      for (const auxRef of registered.schema.auxiliaryEntities ?? []) {
+        if (typeof auxRef === "string" || isEntityCall(auxRef)) continue;
+        if (!auxRef.name || !auxRef.fields) continue;
+        const auxFields = auxRef.fields.filter(
+          (f) => typeof f.name === "string" && f.name.length > 0
+        );
+        this.persistence.registerEntity({
+          name: auxRef.name,
+          id: auxRef.id,
+          collection: auxRef.collection,
+          fields: auxFields,
+          persistence: auxRef.persistence
+        });
+      }
     }
   }
   /**
@@ -1613,8 +1630,9 @@ var OrbitalServerRuntime = class {
           const readPolicy = this.resolvedSchema ? entityAccessPolicies(this.resolvedSchema, fetchEntityType)?.read : void 0;
           const accessBindings = { user: bindingsRef?.user, payload: bindingsRef?.payload, config: bindingsRef?.config };
           if (options?.id) {
-            const entity = await this.persistence.getById(fetchEntityType, options.id);
-            if (entity && applyRowAccess([entity], readPolicy, void 0, accessBindings).length > 0) {
+            const stored = await this.persistence.getById(fetchEntityType, options.id);
+            if (stored && applyRowAccess([stored], readPolicy, void 0, accessBindings).length > 0) {
+              const entity = { ...stored };
               if (options?.include && options.include.length > 0) {
                 await this.populateRelations([entity], fetchEntityType, options.include);
               }
@@ -1638,6 +1656,7 @@ var OrbitalServerRuntime = class {
               entities = entities.slice(0, options.limit);
             }
             if (options?.include && options.include.length > 0) {
+              entities = entities.map((row) => ({ ...row }));
               await this.populateRelations(entities, fetchEntityType, options.include);
             }
             fetchedData[fetchEntityType] = entities;

package/dist/{chunk-QY5EUGR2.js → chunk-C7SIRVGS.js}

@@ -355,7 +355,7 @@ function processEvent(options) {
   let lastFailedGuardTransition;
   for (const transition of candidates) {
     smLog.debug("processEvent", { trait: trait.name, event: normalizedEvent, currentState: traitState.currentState, to: transition.to });
-    if (!transition.guard) {
+    if (transition.guard === void 0 || transition.guard === null) {
       return {
         executed: true,
         newState: transition.to,
@@ -2132,8 +2132,14 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
   stores = /* @__PURE__ */ new Map();
   schemas = /* @__PURE__ */ new Map();
   idCounters = /* @__PURE__ */ new Map();
-  /** entityId -> normalized store name, so relation lookups can prefer the id sibling over `relation.entity` name-matching. */
+  /** entityId -> store key, so relation lookups can prefer the id sibling over `relation.entity` name-matching. */
   storeNameById = /* @__PURE__ */ new Map();
+  /** normalized entity name -> store key (the declared collection, else the name).
+   *  Entities sharing a `persistent:` collection resolve to the same store. */
+  storeKeyByEntity = /* @__PURE__ */ new Map();
+  /** store key -> the first registrant's entity name, used as the minted-id label
+   *  so rows in a shared collection carry one consistent id family. */
+  idLabelByStoreKey = /* @__PURE__ */ new Map();
   config;
   /**
    * Every (entity, row id, column) cell `seed()` stamped with `config.ownerId`.
@@ -2213,19 +2219,27 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
   // ============================================================================
   // Store Management
   // ============================================================================
-  getStore(entityName) {
+  /** Resolve an entity name to its store key: the declared collection when the
+   *  entity is registered, the lowercased name otherwise (unregistered ad-hoc
+   *  creates keep working). */
+  resolveStoreKey(entityName) {
     const normalized = entityName.toLowerCase();
-    if (!this.stores.has(normalized)) {
-      this.stores.set(normalized, /* @__PURE__ */ new Map());
-      this.idCounters.set(normalized, 0);
+    return this.storeKeyByEntity.get(normalized) ?? normalized;
+  }
+  getStore(entityName) {
+    const key = this.resolveStoreKey(entityName);
+    if (!this.stores.has(key)) {
+      this.stores.set(key, /* @__PURE__ */ new Map());
+      this.idCounters.set(key, 0);
     }
-    return this.stores.get(normalized);
+    return this.stores.get(key);
   }
   nextId(entityName) {
-    const normalized = entityName.toLowerCase();
-    const counter = (this.idCounters.get(normalized) ?? 0) + 1;
-    this.idCounters.set(normalized, counter);
-    return `${this.capitalizeFirst(entityName)} Id ${counter}`;
+    const key = this.resolveStoreKey(entityName);
+    const counter = (this.idCounters.get(key) ?? 0) + 1;
+    this.idCounters.set(key, counter);
+    const label = this.idLabelByStoreKey.get(key) ?? entityName;
+    return `${this.capitalizeFirst(label)} Id ${counter}`;
   }
   // ============================================================================
   // Schema & Seeding
@@ -2237,12 +2251,20 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    */
   registerEntity(schema, seedCount) {
     const normalized = schema.name.toLowerCase();
+    const storeKey = (schema.collection ?? schema.name).toLowerCase();
+    this.storeKeyByEntity.set(normalized, storeKey);
+    if (!this.idLabelByStoreKey.has(storeKey)) {
+      this.idLabelByStoreKey.set(storeKey, schema.name);
+    }
     this.schemas.set(normalized, schema);
     if (schema.id) {
-      this.storeNameById.set(schema.id, normalized);
+      this.storeNameById.set(schema.id, storeKey);
     }
+    const alreadySeeded = (this.stores.get(storeKey)?.size ?? 0) > 0;
     if (schema.seedData && schema.seedData.length > 0) {
       this.seedFromInstances(schema.name, schema.seedData);
+    } else if (alreadySeeded) {
+      this.backfillFields(storeKey, schema);
     } else {
       const requested = seedCount ?? this.config.defaultSeedCount ?? 6;
       const count = sampleRowCount(
@@ -2261,36 +2283,63 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    * 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.
+   * Cross-entity relations pick random IDs from the target store. A
+   * SELF-referential `one`-cardinality relation (a parent column like
+   * `Tag.parentId : Tag`) is linked deterministically instead: row 0 stays a
+   * root (`""`) and row *i* parents to row ⌊(i−1)/2⌋ — a proper forest with
+   * real roots and no cycles, so tree views and `parentId = ""` root fetches
+   * render sensibly. Self-referential `many` relations keep the 2–4 random
+   * sibling IDs (excluding self). The runtime caps recursion at depth=2 in
+   * `populateRelations`, so deep chains render two levels then stop.
+   *
+   * Entities sharing a collection are linked once per STORE, over the union
+   * of their declared relation fields (first declarer of a field name wins).
    */
   linkRelationFields() {
+    const relationFieldsByStore = /* @__PURE__ */ new Map();
     for (const [normalizedName, schema] of this.schemas) {
-      const store = this.stores.get(normalizedName);
-      if (!store) continue;
-      const relationFields = schema.fields.filter(
-        (f) => f.type === "relation"
-      );
-      if (relationFields.length === 0) continue;
-      for (const row of store.values()) {
-        for (const field of relationFields) {
+      const storeKey = this.storeKeyByEntity.get(normalizedName) ?? normalizedName;
+      let fieldMap = relationFieldsByStore.get(storeKey);
+      if (!fieldMap) {
+        fieldMap = /* @__PURE__ */ new Map();
+        relationFieldsByStore.set(storeKey, fieldMap);
+      }
+      for (const f of schema.fields) {
+        if (((candidate) => candidate.type === "relation")(f) && !fieldMap.has(f.name)) {
+          fieldMap.set(f.name, f);
+        }
+      }
+    }
+    for (const [storeKey, fieldMap] of relationFieldsByStore) {
+      const store = this.stores.get(storeKey);
+      if (!store || fieldMap.size === 0) continue;
+      const rows = [...store.values()];
+      for (const field of fieldMap.values()) {
+        const targetKey = (field.relation.entityId && this.storeNameById.get(field.relation.entityId)) ?? this.resolveStoreKey(field.relation.entity);
+        const targetStore = this.stores.get(targetKey);
+        if (!targetStore || targetStore.size === 0) continue;
+        const sameStore = targetStore === store;
+        const cardinality = field.relation.cardinality ?? "many";
+        if (sameStore && (cardinality === "one" || cardinality === "many-to-one")) {
+          rows.forEach((row, i) => {
+            if (this.config.ownerId !== void 0 && row[field.name] === this.config.ownerId) {
+              return;
+            }
+            row[field.name] = i === 0 ? "" : rows[Math.floor((i - 1) / 2)]["id"];
+          });
+          continue;
+        }
+        for (const row of rows) {
           if (this.config.ownerId !== void 0 && row[field.name] === this.config.ownerId) {
             continue;
           }
-          const targetNormalized = (field.relation.entityId && this.storeNameById.get(field.relation.entityId)) ?? field.relation.entity.toLowerCase();
-          const targetStore = this.stores.get(targetNormalized);
-          if (!targetStore || targetStore.size === 0) continue;
           const selfId = row["id"];
-          const sameStore = targetStore === store;
           const eligible = [];
           for (const id of targetStore.keys()) {
             if (sameStore && id === selfId) continue;
             eligible.push(id);
           }
           if (eligible.length === 0) continue;
-          const cardinality = field.relation.cardinality ?? "many";
           if (cardinality === "one" || cardinality === "many-to-one") {
             row[field.name] = randomArrayElement(eligible);
           } else {
@@ -2301,6 +2350,43 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
       }
     }
   }
+  /**
+   * Fill fields a late-registering sibling schema declares that the shared
+   * store's existing rows lack. The first registrant on a collection seeds
+   * with ITS field list; a sibling declaring extra columns (e.g. `Tag.parentId`
+   * arriving after `WikiTagRef {id,name}`) would otherwise read `undefined`
+   * where its filters expect a value. Values come from the same canonical
+   * sample policy as seeding; relation fields are then linked by the global
+   * `linkRelationFields` pass that follows registration.
+   */
+  backfillFields(storeKey, schema) {
+    const store = this.stores.get(storeKey);
+    if (!store) return;
+    const candidates = schema.fields.filter(
+      (f) => f.name !== "id" && f.name !== "createdAt" && f.name !== "updatedAt"
+    );
+    if (candidates.length === 0) return;
+    let index = 0;
+    for (const row of store.values()) {
+      index += 1;
+      const absent = candidates.filter((f) => row[f.name] === void 0);
+      if (absent.length === 0) continue;
+      const sample = sampleRow(
+        { name: schema.name, persistence: schema.persistence, fields: absent },
+        { index, strategy: "seeded", persistence: schema.persistence }
+      );
+      for (const f of absent) {
+        if (sample[f.name] !== void 0) {
+          row[f.name] = sample[f.name];
+        }
+      }
+    }
+    mockLog.debug("mock:backfill", {
+      storeKey,
+      entity: schema.name,
+      fields: candidates.map((f) => f.name)
+    });
+  }
   /**
    * Seed an entity with pre-authored instance data.
    */
@@ -2326,6 +2412,7 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
   seed(entityName, fields, count, persistence) {
     const store = this.getStore(entityName);
     const normalized = entityName.toLowerCase();
+    const storeKey = this.resolveStoreKey(entityName);
     if (this.config.debug) {
       mockLog.debug("seeding", { count, entity: entityName });
     }
@@ -2337,7 +2424,7 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
       if (ownerId && ownerCols.length > 0 && i % 2 === 0) {
         for (const col of ownerCols) {
           item[col] = ownerId;
-          this.ownerStampedCells.push({ entity: normalized, id: item.id, column: col });
+          this.ownerStampedCells.push({ entity: storeKey, id: item.id, column: col });
         }
       }
       store.set(item.id, item);
@@ -2467,9 +2554,9 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
    * Clear all data for an entity.
    */
   clear(entityName) {
-    const normalized = entityName.toLowerCase();
-    this.stores.delete(normalized);
-    this.idCounters.delete(normalized);
+    const key = this.resolveStoreKey(entityName);
+    this.stores.delete(key);
+    this.idCounters.delete(key);
   }
   /** Clear all data + re-anchor the PRNG so the next seed loop reproduces
    *  identical rows. Hermetic-frame mode calls this between every step
@@ -2478,6 +2565,9 @@ var MockPersistenceAdapter = class _MockPersistenceAdapter {
     this.stores.clear();
     this.idCounters.clear();
     this.ownerStampedCells = [];
+    this.storeKeyByEntity.clear();
+    this.idLabelByStoreKey.clear();
+    this.storeNameById.clear();
     this.resetFakerSeed();
     mockLog.debug("mock:adapter:clearAll", { reanchored: this.config.seed });
   }
@@ -3448,16 +3538,50 @@ function renameEventsInRenderUiConfig(node, rename) {
   return next;
 }
 function renameEventsInEffects(effects, rename) {
-  return effects.map((effect) => {
-    if (!Array.isArray(effect)) return effect;
-    if (effect[0] === "render-ui" && effect.length >= 3) {
-      const slot = effect[1];
-      const config = effect[2];
-      const nextConfig = renameEventsInRenderUiConfig(config, rename);
-      return [effect[0], slot, nextConfig, ...effect.slice(3)];
-    }
-    return effect;
-  });
+  return effects.map((effect) => renameEventRefsInNode(effect, rename));
+}
+var EMIT_OPTION_SLOTS = /* @__PURE__ */ new Set(["success", "failure", "on_message", "on_change"]);
+function renameEventRefsInNode(node, rename) {
+  if (node === null || node === void 0) return node;
+  if (Array.isArray(node)) {
+    if (node[0] === "render-ui" && node.length >= 3) {
+      const nextConfig = renameEventsInRenderUiConfig(node[2], rename);
+      return [
+        node[0],
+        node[1],
+        nextConfig,
+        ...node.slice(3).map((x) => renameEventRefsInNode(x, rename))
+      ];
+    }
+    const out = node.map((x) => renameEventRefsInNode(x, rename));
+    if (node[0] === "emit" && typeof node[1] === "string") {
+      out[1] = rename(node[1]) ?? node[1];
+    }
+    return out;
+  }
+  if (typeof node === "object") {
+    const obj = node;
+    const next = {};
+    for (const [k, v] of Object.entries(obj)) {
+      if (k === "emit") {
+        if (typeof v === "string") {
+          next[k] = rename(v) ?? v;
+        } else if (v !== null && typeof v === "object" && !Array.isArray(v)) {
+          const slots = {};
+          for (const [slot, slotV] of Object.entries(v)) {
+            slots[slot] = EMIT_OPTION_SLOTS.has(slot) && typeof slotV === "string" ? rename(slotV) ?? slotV : renameEventRefsInNode(slotV, rename);
+          }
+          next[k] = slots;
+        } else {
+          next[k] = renameEventRefsInNode(v, rename);
+        }
+        continue;
+      }
+      next[k] = renameEventRefsInNode(v, rename);
+    }
+    return next;
+  }
+  return node;
 }
 var REBIND_ENTITY_PROPS = /* @__PURE__ */ new Set(["entity"]);
 var ID_ENTITY_PROPS = /* @__PURE__ */ new Set(["entity", "entityType", "source"]);
@@ -3751,13 +3875,12 @@ function applyEventRenames(trait, renames) {
   if (!renames || Object.keys(renames).length === 0) return trait;
   const rename = (k) => k !== void 0 && k in renames ? renames[k] : k;
   const sm = trait.stateMachine;
-  if (!sm) return trait;
-  const nextTransitions = (sm.transitions ?? []).map((t) => {
+  const nextTransitions = (sm?.transitions ?? []).map((t) => {
     const nextEvent = rename(t.event) ?? t.event;
     const nextEffects = t.effects ? renameEventsInEffects(t.effects, rename) : t.effects;
     return { ...t, event: nextEvent, effects: nextEffects };
   });
-  const nextEvents = (sm.events ?? []).map((e) => {
+  const nextEvents = (sm?.events ?? []).map((e) => {
     const newKey = rename(e.key);
     if (newKey === e.key) return e;
     return { ...e, key: newKey ?? e.key };
@@ -3767,13 +3890,30 @@ function applyEventRenames(trait, renames) {
     const newEvent = rename(em.event);
     return newEvent === em.event ? em : { ...em, event: newEvent ?? em.event };
   });
+  const nextTicks = (trait.ticks ?? []).map(
+    (tk) => tk.effects ? {
+      ...tk,
+      effects: renameEventsInEffects(
+        tk.effects,
+        rename
+      )
+    } : tk
+  );
+  const nextListens = (trait.listens ?? []).map((l) => {
+    const sourced = l.source !== void 0 && l.source.kind !== "any";
+    const nextEvent = sourced ? l.event : rename(l.event) ?? l.event;
+    const nextTriggers = rename(l.triggers) ?? l.triggers;
+    return nextEvent === l.event && nextTriggers === l.triggers ? l : { ...l, event: nextEvent, triggers: nextTriggers };
+  });
   return {
     ...trait,
-    stateMachine: {
+    stateMachine: sm ? {
       ...sm,
       transitions: nextTransitions,
       events: nextEvents
-    },
+    } : sm,
+    ...trait.ticks ? { ticks: nextTicks } : {},
+    ...trait.listens ? { listens: nextListens } : {},
     emits: nextEmits
   };
 }

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-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-CZHHxo_A.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-CZHHxo_A.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-nqwGldMC.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-nqwGldMC.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { RenderBindingMarker, SExpr, RuntimeValue, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -571,6 +571,15 @@ interface EntitySchema {
     name: string;
     /** V4 dual-carry id sibling of `name` — optional until the Phase-7 flip. */
     id?: EntityId;
+    /**
+     * Declared `persistent: <collection>` name. Entities declaring the SAME
+     * collection share ONE store — a shadow entity (`WikiTagRef [persistent:
+     * tags]`) reads the very rows its sibling (`Tag [persistent: tags]`) seeds,
+     * matching the compiled path's dedup-by-collection (orbital-shell-typescript
+     * seed.rs) and docs/Almadar_Entity.md's collection rule. Absent → the store
+     * is keyed by entity name, as before.
+     */
+    collection?: string;
     fields: NamedEntityField[];
     /** Pre-authored instance data from the schema (used instead of generated mocks) */
     seedData?: EntityRow[];
@@ -610,8 +619,14 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
     private stores;
     private schemas;
     private idCounters;
-    /** entityId -> normalized store name, so relation lookups can prefer the id sibling over `relation.entity` name-matching. */
+    /** entityId -> store key, so relation lookups can prefer the id sibling over `relation.entity` name-matching. */
     private storeNameById;
+    /** normalized entity name -> store key (the declared collection, else the name).
+     *  Entities sharing a `persistent:` collection resolve to the same store. */
+    private storeKeyByEntity;
+    /** store key -> the first registrant's entity name, used as the minted-id label
+     *  so rows in a shared collection carry one consistent id family. */
+    private idLabelByStoreKey;
     private config;
     /**
      * Every (entity, row id, column) cell `seed()` stamped with `config.ownerId`.
@@ -656,6 +671,10 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
      *  reseed produces row set A, the second produces row set B, and
      *  diff observers see all rows as "changed" between frames. */
     resetFakerSeed(): void;
+    /** Resolve an entity name to its store key: the declared collection when the
+     *  entity is registered, the lowercased name otherwise (unregistered ad-hoc
+     *  creates keep working). */
+    private resolveStoreKey;
     private getStore;
     private nextId;
     /**
@@ -672,12 +691,29 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
      * 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.
+     * Cross-entity relations pick random IDs from the target store. A
+     * SELF-referential `one`-cardinality relation (a parent column like
+     * `Tag.parentId : Tag`) is linked deterministically instead: row 0 stays a
+     * root (`""`) and row *i* parents to row ⌊(i−1)/2⌋ — a proper forest with
+     * real roots and no cycles, so tree views and `parentId = ""` root fetches
+     * render sensibly. Self-referential `many` relations keep the 2–4 random
+     * sibling IDs (excluding self). The runtime caps recursion at depth=2 in
+     * `populateRelations`, so deep chains render two levels then stop.
+     *
+     * Entities sharing a collection are linked once per STORE, over the union
+     * of their declared relation fields (first declarer of a field name wins).
      */
     linkRelationFields(): void;
+    /**
+     * Fill fields a late-registering sibling schema declares that the shared
+     * store's existing rows lack. The first registrant on a collection seeds
+     * with ITS field list; a sibling declaring extra columns (e.g. `Tag.parentId`
+     * arriving after `WikiTagRef {id,name}`) would otherwise read `undefined`
+     * where its filters expect a value. Values come from the same canonical
+     * sample policy as seeding; relation fields are then linked by the global
+     * `linkRelationFields` pass that follows registration.
+     */
+    private backfillFields;
     /**
      * Seed an entity with pre-authored instance data.
      */

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor } from './chunk-QY5EUGR2.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-QY5EUGR2.js';
+import { EffectExecutor } from './chunk-C7SIRVGS.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-C7SIRVGS.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.61.0",
+  "version": "6.63.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.70.0",
+    "@almadar/core": "^10.73.0",
     "@almadar/evaluator": "^2.42.0",
     "@almadar/logger": "^1.11.0",
     "@almadar/server": "^2.38.0",
-    "@almadar/std": "^16.186.0"
+    "@almadar/std": "^16.192.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"
@@ -72,7 +72,7 @@
     }
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.15.0",
+    "@almadar/eslint-plugin": "^2.16.0",
     "@types/express": "^5.0.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/parser": "8.65.0",