@almadar/core 10.28.0 → 10.29.0

package/dist/{expression-C6X4A8L7.d.ts → expression-CB9R3KWk.d.ts}

@@ -129,8 +129,11 @@ interface ParsedBinding {
  * `user` is the authenticated user / agent context (see binding.ts) and is
  * read-only in guards/effects/ticks — atoms reference `@user.id` and
  * `@user.role` for ownership / role-based gating.
+ * `callsitePayload` is the call-site-captured event payload emitted by the
+ * compiler's inline-trait hoisting; the runtime BindingResolver resolves it
+ * at the composing effect.
  */
-declare const CORE_BINDINGS: readonly ["entity", "payload", "state", "now", "config", "computed", "trait", "user"];
+declare const CORE_BINDINGS: readonly ["entity", "payload", "state", "now", "config", "computed", "trait", "user", "callsitePayload"];
 type CoreBinding = (typeof CORE_BINDINGS)[number];
 /**
  * Parses a binding reference into its components.

package/dist/factory/index.d.ts

@@ -1,9 +1,9 @@
-import { h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, r as RuleOverlayEntry, q as PresentationOverlay, s as TraitOverlay } from '../types-DFn3sWpV.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, o as JsonSchema, p as JsonSchemaType, J as JsonValue, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, t as TraitOverlayEntry, u as TraitOverlayListener } from '../types-DFn3sWpV.js';
-import { a as EntityPersistence, E as EntityField } from '../pattern-types-BeQXwgpZ.js';
-import { a as TraitReference } from '../trait-DZkS625T.js';
+import { h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, r as RuleOverlayEntry, q as PresentationOverlay, s as TraitOverlay } from '../types-CGC5A1-T.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, o as JsonSchema, p as JsonSchemaType, J as JsonValue, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, t as TraitOverlayEntry, u as TraitOverlayListener } from '../types-CGC5A1-T.js';
+import { a as EntityPersistence, E as EntityField } from '../pattern-types-JZordBZv.js';
+import { a as TraitReference } from '../trait-B_CzfDSi.js';
 import 'zod';
-import '../expression-C6X4A8L7.js';
+import '../expression-CB9R3KWk.js';
 
 /**
  * Typed questionnaire surface — shapes the studio renders + answers.

package/dist/factory-runtime/index.d.ts

@@ -1,8 +1,8 @@
-import { O as OrbitalSchema, M as MakeTraitRefOpts, a as OrbitalDefinition } from '../builders-BN3WLFYM.js';
-import { C as CallSiteConfig, b as CallSiteConfigEntry, c as Trait } from '../trait-DZkS625T.js';
-import { E as EntityField, a as EntityPersistence } from '../pattern-types-BeQXwgpZ.js';
+import { O as OrbitalSchema, M as MakeTraitRefOpts, a as OrbitalDefinition } from '../builders-DcBjE_Uw.js';
+import { C as CallSiteConfig, b as CallSiteConfigEntry, c as Trait } from '../trait-B_CzfDSi.js';
+import { E as EntityField, a as EntityPersistence } from '../pattern-types-JZordBZv.js';
 import 'zod';
-import '../expression-C6X4A8L7.js';
+import '../expression-CB9R3KWk.js';
 
 /**
  * Orbital factory manifest types — shared across all packages.
@@ -148,6 +148,22 @@ declare function rewriteEntityInInlineTrait(trait: Trait, oldName: string, newNa
  *   - generated `mergeExtraTraitWithOverlay` in dispatch.ts
  */
 declare function mergeCallSiteConfigOverrides(base: CallSiteConfig, overrides: CallSiteConfig): Record<string, CallSiteConfigEntry>;
+/**
+ * Rewrite every reference to a renamed trait so a
+ * `traitOverrides.<T>.name` override keeps the orbital internally
+ * consistent. A rename changes ONLY the trait's local name; without this
+ * pass the factory output still carries the canonical name in:
+ *   - `pages[].traits[].ref` (→ ORB_P_INVALID_TRAIT_REF: "referenced on
+ *     page does not exist" — the exact demotion storm the dashboard
+ *     param-fill hit when the LLM renamed its chart traits), and
+ *   - `@trait.<canonical>` tokens inside sibling traits' config (layout
+ *     tile slots like `tile1Trait: "@trait.DefaultRevenueChart"`).
+ *
+ * Single canonical implementation shared by `applyParamsToOrb` (runtime
+ * factory overlay) and every generated factory body (via the packages'
+ * `factory-runtime` re-export shims). Pure — returns a new definition.
+ */
+declare function applyTraitRenames(orbital: OrbitalDefinition, renames: ReadonlyMap<string, string>): OrbitalDefinition;
 /**
  * The overlay. Resolves the effective entity name + collection, calls
  * `makeOrbitalWithUses` with the rewritten data, then applies the params'
@@ -171,4 +187,4 @@ declare function applyParamsToOrb(orb: OrbitalSchema, orbitalName: string, _mani
 
 declare function applyParamsToWholeOrb(orb: OrbitalSchema, manifests: readonly OrbitalParamsManifest[], params: OrbitalFactoryParams): OrbitalSchema;
 
-export { type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, applyParamsToOrb, applyParamsToWholeOrb, applyTraitRenames, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };

package/dist/factory-runtime/index.js

@@ -324,7 +324,8 @@ var StateSchema = z.object({
 var PayloadFieldSchema = z.object({
   name: z.string().min(1),
   type: z.string().min(1),
-  required: z.boolean().optional()
+  required: z.boolean().optional(),
+  properties: z.lazy(() => z.array(PayloadFieldSchema)).optional()
 });
 var EventSchema = z.object({
   key: z.string().min(1, "Event key is required"),
@@ -371,14 +372,24 @@ var TraitConfigSchema = z.record(TraitConfigValueSchema);
 function isCallSiteConfigDeclaration(entry) {
   return typeof entry === "object" && entry !== null && !Array.isArray(entry) && "type" in entry && typeof entry.type === "string" && "default" in entry;
 }
+var ConfigFieldItemsDeclarationSchema = z.lazy(
+  () => z.object({
+    type: z.string().optional(),
+    properties: z.record(TraitEntityFieldSchema).optional(),
+    items: ConfigFieldItemsDeclarationSchema.optional()
+  })
+);
 var ConfigFieldDeclarationSchema = z.object({
   type: z.string(),
   default: TraitConfigValueSchema.optional(),
+  required: z.boolean().optional(),
   label: z.string().optional(),
   description: z.string().optional(),
   tier: z.string().optional(),
   values: z.array(z.string()).optional(),
-  synonyms: z.string().optional()
+  synonyms: z.string().optional(),
+  items: ConfigFieldItemsDeclarationSchema.optional(),
+  properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
 });
 var DeclaredTraitConfigSchema = z.record(
   ConfigFieldDeclarationSchema
@@ -415,7 +426,9 @@ var TraitEntityFieldSchema = z.object({
   ]),
   required: z.boolean().optional(),
   default: z.unknown().optional(),
-  values: z.array(z.string()).optional()
+  values: z.array(z.string()).optional(),
+  items: ConfigFieldItemsDeclarationSchema.optional(),
+  properties: z.lazy(() => z.record(TraitEntityFieldSchema)).optional()
 });
 var TraitDataEntitySchema = z.object({
   name: z.string().min(1),
@@ -454,7 +467,8 @@ var EventPayloadFieldSchema = z.object({
   type: z.string().min(1),
   required: z.boolean().optional(),
   description: z.string().optional(),
-  entityType: z.string().optional()
+  entityType: z.string().optional(),
+  properties: z.lazy(() => z.array(EventPayloadFieldSchema)).optional()
 });
 var TraitEventContractSchema = z.object({
   /**
@@ -462,11 +476,13 @@ var TraitEventContractSchema = z.object({
    * starts with a letter, then any letters / digits / underscores. Both
    * UPPER_SNAKE_CASE and PascalCase shapes are valid identifiers in the
    * post-Phase 2.5 nominal-event type system (events declared via
-   * `type X = Event<T>`).
+   * `type X = Event<T>`). A pre-resolution `@config.<knob>` reference
+   * (Option B) is also legal — inline/resolve substitutes it with the
+   * knob's effective literal before codegen/runtime consume it.
    */
   event: z.string().min(1).regex(
-    /^[A-Za-z][A-Za-z0-9_]*$/,
-    "Event name must start with a letter and contain only letters, digits, and underscores"
+    /^([A-Za-z][A-Za-z0-9_]*|@config\.[A-Za-z_][A-Za-z0-9_]*)$/,
+    "Event name must start with a letter and contain only letters, digits, and underscores, or be a `@config.<knob>` reference"
   ),
   description: z.string().optional(),
   synonyms: z.string().optional(),
@@ -1683,6 +1699,62 @@ function mergeCallSiteConfigOverrides(base, overrides) {
   }
   return next;
 }
+function applyTraitRenames(orbital, renames) {
+  if (renames.size === 0) return orbital;
+  const TRAIT_TOKEN = "@trait.";
+  const renameToken = (v) => {
+    if (!v.startsWith(TRAIT_TOKEN)) return v;
+    const renamed = renames.get(v.slice(TRAIT_TOKEN.length));
+    return renamed !== void 0 ? `${TRAIT_TOKEN}${renamed}` : v;
+  };
+  const rewriteValue = (v) => {
+    if (typeof v === "string") return renameToken(v);
+    if (Array.isArray(v)) return v.map(rewriteValue);
+    if (v !== null && typeof v === "object") {
+      const out = {};
+      for (const [k, x] of Object.entries(v)) out[k] = rewriteValue(x);
+      return out;
+    }
+    return v;
+  };
+  const rewriteEntry = (e) => {
+    if (isCallSiteConfigDeclaration(e)) {
+      return e.default !== void 0 ? { ...e, default: rewriteValue(e.default) } : e;
+    }
+    return rewriteValue(e);
+  };
+  const rewriteConfig = (config) => {
+    const out = {};
+    for (const [k, e] of Object.entries(config)) out[k] = rewriteEntry(e);
+    return out;
+  };
+  const rewriteStateMachine = (sm) => JSON.parse(
+    JSON.stringify(sm),
+    (_k, v) => typeof v === "string" ? renameToken(v) : v
+  );
+  const traits = (orbital.traits ?? []).map((t) => {
+    if (typeof t !== "object" || t === null) return t;
+    if ("ref" in t) {
+      return t.config !== void 0 ? { ...t, config: rewriteConfig(t.config) } : t;
+    }
+    const withConfig = t.config !== void 0 ? { ...t, config: rewriteConfig(t.config) } : t;
+    return withConfig.stateMachine !== void 0 ? { ...withConfig, stateMachine: rewriteStateMachine(withConfig.stateMachine) } : withConfig;
+  });
+  const renamePageTrait = (entry) => {
+    if (typeof entry === "string") return renames.get(entry) ?? entry;
+    if ("ref" in entry && typeof entry.ref === "string") {
+      const renamed = renames.get(entry.ref);
+      return renamed !== void 0 ? { ...entry, ref: renamed } : entry;
+    }
+    return entry;
+  };
+  const pages = (orbital.pages ?? []).map((p) => {
+    if (typeof p !== "object" || p === null) return p;
+    if (!Array.isArray(p.traits)) return p;
+    return { ...p, traits: p.traits.map(renamePageTrait) };
+  });
+  return { ...orbital, traits, pages };
+}
 function applyParamsToOrb(orb, orbitalName, _manifest, params) {
   const orbital = findOrbitalOrThrow(orb, orbitalName);
   const canonicalEntity = assertResolvedEntity(orbital.entity, orbitalName, orb.name);
@@ -1697,11 +1769,15 @@ function applyParamsToOrb(orb, orbitalName, _manifest, params) {
     traits: rebuildTraits(ctx, effectiveEntityName, orbital.traits),
     pages: rebuildPages(ctx, effectiveEntityName, orbital.pages)
   });
+  const traitRenames = /* @__PURE__ */ new Map();
   if (built.traits && params.traitOverrides !== void 0) {
     built.traits = built.traits.map((t) => {
       if (!isTraitReferenceObject(t) || typeof t.name !== "string") return t;
       const override = params.traitOverrides?.[t.name];
       if (!override) return t;
+      if (override.name !== void 0 && override.name !== t.name) {
+        traitRenames.set(t.name, override.name);
+      }
       const merged = { ...t };
       if (override.config !== void 0) {
         merged.config = mergeCallSiteConfigOverrides(t.config ?? {}, override.config);
@@ -1734,7 +1810,7 @@ function applyParamsToOrb(orb, orbitalName, _manifest, params) {
       return { ...p, path: params.pagePath };
     });
   }
-  return built;
+  return applyTraitRenames(built, traitRenames);
 }
 
 // src/factory-runtime/apply-params-to-whole-orb.ts
@@ -1755,6 +1831,6 @@ function applyParamsToWholeOrb(orb, manifests, params) {
   return { ...orb, orbitals: rebuilt };
 }
 
-export { applyParamsToOrb, applyParamsToWholeOrb, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { applyParamsToOrb, applyParamsToWholeOrb, applyTraitRenames, extractManifest, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map