@almadar/core 7.23.0 → 7.25.0

package/dist/domain-language/index.d.ts

@@ -1,4 +1,4 @@
-import { a6 as EntityField, a9 as EntityPersistence, cX as TraitReference, c$ as TraitScope, a2 as Entity, br as Page, bh as OrbitalSchema, cE as Trait } from '../schema-BVni4uNf.js';
+import { a6 as EntityField, a9 as EntityPersistence, cX as TraitReference, c$ as TraitScope, cS as TraitEventListener, a2 as Entity, br as Page, bh as OrbitalSchema, cE as Trait } from '../schema-BVni4uNf.js';
 import { S as SExpr } from '../expression-BVRFm0sV.js';
 import 'zod';
 import '@almadar/patterns';
@@ -114,6 +114,14 @@ interface DomainEntity extends ASTNode {
      * the entity section.
      */
     persistence?: EntityPersistence;
+    /**
+     * Storage collection key. Mirrors `OrbitalSchema.entities[i].collection`.
+     * Omitted ⇒ defaults to `plural(name).toLowerCase()`. Surfaced to the
+     * factory translator so the LLM can override the storage key without
+     * touching the entity name (e.g. entity `Product` → collection
+     * `"catalog"`).
+     */
+    collection?: string;
 }
 interface DomainPageSection extends ASTNode {
     type: 'page_section';
@@ -361,6 +369,10 @@ interface FactoryCallSiteParams {
     entityFields?: ReadonlyArray<EntityField>;
     /** Override `signature.entities[0].persistence`. */
     persistence?: EntityPersistence;
+    /** Override the entity's storage collection key. Defaults to
+     *  `plural(entityName).toLowerCase()` at factory dispatch time
+     *  when omitted. */
+    collection?: string;
     /** Per-page path overrides keyed by `signature.pages[i].name`. */
     pagePaths?: Readonly<Record<string, string>>;
     /** Trait config overrides keyed by `signature.traits[i].name`. Each
@@ -487,15 +499,15 @@ interface TraitOverlayEntry {
     events?: Readonly<Record<string, string>>;
     name?: string;
     emitsScope?: 'internal' | 'external';
-    listens?: ReadonlyArray<TraitOverlayListener>;
-}
-interface TraitOverlayListener {
-    event: string;
-    source?: {
-        orbital?: string;
-        trait?: string;
-    };
+    /** Reuses `TraitEventListener` from `@almadar/core/types/trait` so the
+     *  overlay's listen entries carry the same `event` / `triggers` /
+     *  `source` / `guard` shape as everywhere else — no narrower clone. */
+    listens?: ReadonlyArray<TraitEventListener>;
 }
+/** @deprecated Phase 4.1 placeholder — use `TraitEventListener` instead.
+ *  Kept as a structural type alias so callers that imported it keep
+ *  compiling through the transition; will be removed in 7.25.0. */
+type TraitOverlayListener = TraitEventListener;
 /**
  * Rules carry a free-form `capability: string` that the translator
  * matches against `signature.traits[].capabilities` (source-tagged

package/dist/domain-language/index.js

@@ -6436,6 +6436,7 @@ function translateDomainToParams(binding, signature, presentation, ruleOverlay,
   applyEntityName(binding.entity, signature, params);
   applyEntityFields(binding.entity, signature, params, warnings);
   applyPersistence(binding.entity, signature, params, warnings);
+  applyCollection(binding.entity, params);
   applyPagePaths(binding.pages ?? [], signature, params, warnings);
   applyPresentation(presentation, signature, params, warnings);
   applyTraitOverlay(traitOverlay, signature, params, warnings);
@@ -6486,6 +6487,10 @@ function applyPersistence(entity, signature, params, warnings) {
   if (entity.persistence === signature.entities[0].persistence) return;
   params.persistence = entity.persistence;
 }
+function applyCollection(entity, params) {
+  if (!entity.collection) return;
+  params.collection = entity.collection;
+}
 function applyPagePaths(pages, signature, params, warnings) {
   if (pages.length === 0) return;
   const sigPages = new Map(signature.pages.map((p) => [p.name, p]));