npm - @almadar/core - Versions diffs - 10.77.0 → 10.79.0 - Mend

@almadar/core 10.77.0 → 10.79.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

package/dist/builders.d.ts +8 -3
package/dist/builders.js +31 -6
package/dist/builders.js.map +1 -1
package/dist/{effect-BHaHSAvM.d.ts → effect-Mx_niZdY.d.ts} +62 -21
package/dist/{entityAccess-CqqGrG-7.d.ts → entityAccess-C3_cjLNi.d.ts} +1 -1
package/dist/factory/index.d.ts +41 -5
package/dist/factory/index.js +52615 -1
package/dist/factory/index.js.map +1 -1
package/dist/factory-runtime/index.d.ts +3 -3
package/dist/factory-runtime/index.js +31 -6
package/dist/factory-runtime/index.js.map +1 -1
package/dist/{index-B8ZQ8lo5.d.ts → index-B1N3gjT0.d.ts} +4 -4
package/dist/index.d.ts +11 -11
package/dist/index.js +4792 -749
package/dist/index.js.map +1 -1
package/dist/mock/index.d.ts +4 -4
package/dist/mock/index.js +27 -4
package/dist/mock/index.js.map +1 -1
package/dist/patterns/component-mapping.json +1 -1
package/dist/patterns/event-contracts.json +14 -1
package/dist/patterns/index.d.ts +8460 -898
package/dist/patterns/index.js +4140 -612
package/dist/patterns/index.js.map +1 -1
package/dist/patterns/patterns-registry.json +3966 -455
package/dist/patterns/registry.json +3966 -455
package/dist/{schema-Czlrw3bA.d.ts → schema-CkTuSx6F.d.ts} +5971 -5622
package/dist/{trait-DCmf5iRN.d.ts → trait-B1fI0lTU.d.ts} +686 -568
package/dist/types/index.d.ts +5 -5
package/dist/types/index.js +29 -5
package/dist/types/index.js.map +1 -1
package/dist/{types-Cb51Jqxe.d.ts → types-B53Myv7U.d.ts} +41 -2
package/package.json +1 -1

package/dist/{trait-DCmf5iRN.d.ts → trait-B1fI0lTU.d.ts} RENAMED Viewed

@@ -1,4 +1,4 @@
-import { b as EventId, c as Effect, T as TraitId, O as OrbitalId, d as EntityId, P as PageId, A as AnyPatternConfig, e as Entity, E as EntityField } from './effect-BHaHSAvM.js';
+import { b as EventId, c as Effect, T as TraitId, O as OrbitalId, d as EntityId, P as PageId, A as AnyPatternConfig, e as Entity, E as EntityField } from './effect-Mx_niZdY.js';
 import { E as Expression, S as SExpr, J as JsonValue } from './expression-Fk8bQWef.js';
 import { z } from 'zod';
@@ -33,16 +33,16 @@ declare const StateSchema: z.ZodObject<{
     name: string;
     description?: string | undefined;
     isInitial?: boolean | undefined;
-    isTerminal?: boolean | undefined;
     isFinal?: boolean | undefined;
+    isTerminal?: boolean | undefined;
     onEntry?: string[] | undefined;
     onExit?: string[] | undefined;
 }, {
     name: string;
     description?: string | undefined;
     isInitial?: boolean | undefined;
-    isTerminal?: boolean | undefined;
     isFinal?: boolean | undefined;
+    isTerminal?: boolean | undefined;
     onEntry?: string[] | undefined;
     onExit?: string[] | undefined;
 }>;
@@ -194,17 +194,17 @@ declare const TransitionSchema: z.ZodObject<{
     from: string;
     to: string;
     description?: string | null | undefined;
-    eventId?: EventId | undefined;
     guard?: SExpr | undefined;
     effects?: SExpr[][] | undefined;
+    eventId?: EventId | undefined;
 }, {
     event: string;
     from: string;
     to: string;
     description?: string | null | undefined;
-    eventId?: string | undefined;
     guard?: SExpr | undefined;
     effects?: SExpr[][] | undefined;
+    eventId?: string | undefined;
 }>;
 /**
  * Complete state machine definition
@@ -232,16 +232,16 @@ declare const StateMachineSchema: z.ZodObject<{
         name: string;
         description?: string | undefined;
         isInitial?: boolean | undefined;
-        isTerminal?: boolean | undefined;
         isFinal?: boolean | undefined;
+        isTerminal?: boolean | undefined;
         onEntry?: string[] | undefined;
         onExit?: string[] | undefined;
     }, {
         name: string;
         description?: string | undefined;
         isInitial?: boolean | undefined;
-        isTerminal?: boolean | undefined;
         isFinal?: boolean | undefined;
+        isTerminal?: boolean | undefined;
         onEntry?: string[] | undefined;
         onExit?: string[] | undefined;
     }>, "many">;
@@ -289,17 +289,17 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
-        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         effects?: SExpr[][] | undefined;
+        eventId?: EventId | undefined;
     }, {
         event: string;
         from: string;
         to: string;
         description?: string | null | undefined;
-        eventId?: string | undefined;
         guard?: SExpr | undefined;
         effects?: SExpr[][] | undefined;
+        eventId?: string | undefined;
     }>, "many">;
     guards: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -315,23 +315,12 @@ declare const StateMachineSchema: z.ZodObject<{
         description?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    events: {
-        name: string;
-        key: string;
-        id?: EventId | undefined;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        tier?: string | undefined;
-        payloadSchema?: PayloadField[] | undefined;
-        classification?: "domain" | "system" | undefined;
-        semanticRole?: string | undefined;
-    }[];
     states: {
         name: string;
         description?: string | undefined;
         isInitial?: boolean | undefined;
-        isTerminal?: boolean | undefined;
         isFinal?: boolean | undefined;
+        isTerminal?: boolean | undefined;
         onEntry?: string[] | undefined;
         onExit?: string[] | undefined;
     }[];
@@ -340,20 +329,14 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
-        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         effects?: SExpr[][] | undefined;
+        eventId?: EventId | undefined;
     }[];
-    guards?: {
-        name: string;
-        expression: SExpr;
-        description?: string | undefined;
-    }[] | undefined;
-}, {
     events: {
         name: string;
         key: string;
-        id?: string | undefined;
+        id?: EventId | undefined;
         description?: string | undefined;
         synonyms?: string | undefined;
         tier?: string | undefined;
@@ -361,12 +344,18 @@ declare const StateMachineSchema: z.ZodObject<{
         classification?: "domain" | "system" | undefined;
         semanticRole?: string | undefined;
     }[];
+    guards?: {
+        name: string;
+        expression: SExpr;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
     states: {
         name: string;
         description?: string | undefined;
         isInitial?: boolean | undefined;
-        isTerminal?: boolean | undefined;
         isFinal?: boolean | undefined;
+        isTerminal?: boolean | undefined;
         onEntry?: string[] | undefined;
         onExit?: string[] | undefined;
     }[];
@@ -375,9 +364,20 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
-        eventId?: string | undefined;
         guard?: SExpr | undefined;
         effects?: SExpr[][] | undefined;
+        eventId?: string | undefined;
+    }[];
+    events: {
+        name: string;
+        key: string;
+        id?: string | undefined;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
+        payloadSchema?: PayloadField[] | undefined;
+        classification?: "domain" | "system" | undefined;
+        semanticRole?: string | undefined;
     }[];
     guards?: {
         name: string;
@@ -568,7 +568,7 @@ declare const TraitCategorySchema: z.ZodEnum<["lifecycle", "temporal", "validati
 /**
  * Field types for trait data entities
  */
-type TraitFieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'timestamp' | 'datetime' | 'enum' | 'email' | 'url' | 'phone' | 'uuid' | 'image' | 'trait' | 'slot' | 'pattern' | 'node' | 'event';
+type TraitFieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'timestamp' | 'datetime' | 'enum' | 'email' | 'url' | 'phone' | 'uuid' | 'image' | 'trait' | 'slot' | 'pattern' | 'node' | 'event' | 'scalar' | 'union' | 'opaque';
 /**
  * Simplified field for trait data entities
  */
@@ -684,11 +684,11 @@ declare const TraitTickSchema: z.ZodObject<{
     interval: string | number;
     description?: string | undefined;
     pages?: string[] | undefined;
-    priority?: number | undefined;
+    emits?: string[] | undefined;
     guard?: SExpr | undefined;
+    priority?: number | undefined;
     appliesTo?: string[] | undefined;
     pageIds?: PageId[] | undefined;
-    emits?: string[] | undefined;
     emitIds?: EventId[] | undefined;
 }, {
     name: string;
@@ -696,11 +696,11 @@ declare const TraitTickSchema: z.ZodObject<{
     interval: string | number;
     description?: string | undefined;
     pages?: string[] | undefined;
-    priority?: number | undefined;
+    emits?: string[] | undefined;
     guard?: SExpr | undefined;
+    priority?: number | undefined;
     appliesTo?: string[] | undefined;
     pageIds?: string[] | undefined;
-    emits?: string[] | undefined;
     emitIds?: string[] | undefined;
 }>;
 /**
@@ -755,6 +755,27 @@ type TraitEventContract = {
     synonyms?: string;
     /** Authoring tier (`essential`/`customization`/`advanced`/`internal`). */
     tier?: string;
+    /**
+     * The config knob whose value DEFINES this event's name, when the emit was
+     * authored as `emits { @config.<knob> }`. Captured at L1, where the
+     * `@config.X` spelling still exists — after inlining, `event` holds the
+     * resolved literal and the fact that it came from a knob is otherwise
+     * unrecoverable.
+     *
+     * A definer knob CREATES an event name rather than referencing one, which
+     * is why consumers must not pin such a knob to the trait's existing event
+     * vocabulary: doing so forbids the very name it exists to introduce.
+     */
+    definerKnob?: string;
+    /**
+     * `true` when `scope` was set by a CALL-SITE `emitsScope` override (the
+     * inline phase applies it), not by the source atom's own `-> external`
+     * declaration. An atom declaring its emits external is an unexamined
+     * default (nearly every atom does), while a composition restating it is
+     * the consumer's own deferral — the dead-control check honours it as an
+     * exemption. See ORB-X-EXTERNAL-EMIT-EXEMPTION.
+     */
+    scopeOverridden?: boolean;
     /** Payload schema — declarative type info for the event's payload.
      *  Distinct from the runtime payload value (`@payload.X` bindings,
      *  `EventPayload`) which is a separate concept. */
@@ -809,6 +830,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     synonyms: z.ZodOptional<z.ZodString>;
     tier: z.ZodOptional<z.ZodString>;
+    definerKnob: z.ZodOptional<z.ZodString>;
+    scopeOverridden: z.ZodOptional<z.ZodBoolean>;
     payloadSchema: z.ZodOptional<z.ZodArray<z.ZodType<EventPayloadField, z.ZodTypeDef, EventPayloadField>, "many">>;
     scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
 }, "strip", z.ZodTypeAny, {
@@ -819,6 +842,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
     payloadSchema?: EventPayloadField[] | undefined;
+    definerKnob?: string | undefined;
+    scopeOverridden?: boolean | undefined;
 }, {
     event: string;
     description?: string | undefined;
@@ -827,6 +852,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
     payloadSchema?: EventPayloadField[] | undefined;
+    definerKnob?: string | undefined;
+    scopeOverridden?: boolean | undefined;
 }>;
 /**
  * Event listener for trait communication.
@@ -1001,10 +1028,10 @@ declare const TraitEventListenerSchema: z.ZodObject<{
         traitId?: TraitId | undefined;
         orbitalId?: OrbitalId | undefined;
     } | undefined;
+    guard?: SExpr | undefined;
     eventId?: EventId | undefined;
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
-    guard?: SExpr | undefined;
     triggersId?: EventId | undefined;
     payloadMapping?: Record<string, SExpr> | undefined;
 }, {
@@ -1025,10 +1052,10 @@ declare const TraitEventListenerSchema: z.ZodObject<{
         traitId?: string | undefined;
         orbitalId?: string | undefined;
     } | undefined;
+    guard?: SExpr | undefined;
     eventId?: string | undefined;
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
-    guard?: SExpr | undefined;
     triggersId?: string | undefined;
     payloadMapping?: Record<string, SExpr> | undefined;
 }>;
@@ -1088,6 +1115,15 @@ type TraitReference = {
     name?: string;
     /** Phase F: rename atom event keys at the call site, e.g. {OPEN: "ADD_ITEM"} */
     events?: Record<string, string>;
+    /**
+     * 3-II trait type-parameter arguments (`:: p SomeType` in `.lolo`):
+     * declared-param name → type-vocabulary name (an entity, a primitive incl.
+     * `scalar`, or a struct alias from the AUTHORING file's `types` map).
+     * Present on pre-inline registry references only — the inline phase
+     * consumes it while resolving `$<name>` payload sentinels and it never
+     * appears in a final composed `.orb`.
+     */
+    typeArgs?: Record<string, string>;
     /** V4 dual-carry id sibling of `events` (keys = baked event names resolved to ids) — optional until the Phase-7 flip. */
     eventIds?: Record<string, EventId>;
     /**
@@ -1161,6 +1197,7 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     eventIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EventId, string>>>;
+    typeArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodType<ConfigFieldDeclaration, z.ZodTypeDef, ConfigFieldDeclaration>, z.ZodType<TraitConfigValue, z.ZodTypeDef, TraitConfigValue>]>>>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1230,10 +1267,10 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -1254,10 +1291,10 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -1270,13 +1307,6 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -1295,13 +1325,21 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -1310,13 +1348,6 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -1335,13 +1366,21 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, {
     ref: string;
@@ -1350,13 +1389,6 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -1375,13 +1407,21 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -1390,13 +1430,6 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -1415,13 +1448,21 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>;
 /**
@@ -1479,8 +1520,8 @@ declare const TraitUIBindingSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         width?: string | undefined;
         title?: string | undefined;
         totalSteps?: number | undefined;
-        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         step?: number | undefined;
+        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
         showProgress?: boolean | undefined;
         closable?: boolean | undefined;
@@ -1488,8 +1529,8 @@ declare const TraitUIBindingSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         width?: string | undefined;
         title?: string | undefined;
         totalSteps?: number | undefined;
-        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         step?: number | undefined;
+        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
         showProgress?: boolean | undefined;
         closable?: boolean | undefined;
@@ -1501,8 +1542,8 @@ declare const TraitUIBindingSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         width?: string | undefined;
         title?: string | undefined;
         totalSteps?: number | undefined;
-        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         step?: number | undefined;
+        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
         showProgress?: boolean | undefined;
         closable?: boolean | undefined;
@@ -1514,8 +1555,8 @@ declare const TraitUIBindingSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         width?: string | undefined;
         title?: string | undefined;
         totalSteps?: number | undefined;
-        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         step?: number | undefined;
+        size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
         position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
         showProgress?: boolean | undefined;
         closable?: boolean | undefined;
@@ -1679,6 +1720,12 @@ type Trait = {
      * `linkedEntity` without re-walking the import graph at runtime.
      */
     sourceEntityDefinition?: Entity;
+    /**
+     * Increment 3-II: this trait's own declared type parameters. Present
+     * only on an atom's DECLARING inline trait (never authored on a
+     * reference); survives cloning into a consumer's composed schema.
+     */
+    typeParams?: TraitTypeParamDef[];
 };
 /**
  * Provenance attached to a trait that was cloned from a `uses[]` import
@@ -1696,6 +1743,28 @@ type SourceBehaviorMetadata = {
      *  call-site `name:` rename. */
     originalName: string;
 };
+/**
+ * One trait-level type parameter — `(V : Type, R : Type)` in
+ * `trait Name (V : Type, R : Type) -> Entity { ... }`. Present only on an
+ * atom's DECLARING inline trait; survives cloning into a consumer's composed
+ * schema so the inline phase can read each param's `kind` when resolving a
+ * surviving `"$<name>"` payload sentinel. `kind` is one of the six alias
+ * type-parameter kind names (`Type`, `Entity`, `Trait`, `Page`, `Orbital`,
+ * `Event`) — in practice `Type` and `Entity` are the two meaningful kinds
+ * for a trait param today.
+ */
+type TraitTypeParamDef = {
+    name: string;
+    kind: string;
+    /**
+     * Declaration default (`(r : Type = <name>)`) — a primitive name (incl.
+     * `scalar`), an entity name, or a struct-alias name, all resolved in
+     * the atom's own file. Consulted only when no call-site `::` arg was
+     * supplied (and, for Entity-kind, only when `linkedEntity` also gave no
+     * default).
+     */
+    default?: string;
+};
 declare const TraitSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     name: z.ZodString;
@@ -1775,16 +1844,16 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }, {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }>, "many">;
@@ -1832,17 +1901,17 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }, {
             event: string;
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
         }>, "many">;
         guards: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -1858,23 +1927,12 @@ declare const TraitSchema: z.ZodObject<{
             description?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -1883,20 +1941,14 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }[];
-        guards?: {
-            name: string;
-            expression: SExpr;
-            description?: string | undefined;
-        }[] | undefined;
-    }, {
         events: {
             name: string;
             key: string;
-            id?: string | undefined;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -1904,12 +1956,18 @@ declare const TraitSchema: z.ZodObject<{
             classification?: "domain" | "system" | undefined;
             semanticRole?: string | undefined;
         }[];
+        guards?: {
+            name: string;
+            expression: SExpr;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -1918,9 +1976,20 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -1947,11 +2016,11 @@ declare const TraitSchema: z.ZodObject<{
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }, {
         name: string;
@@ -1959,11 +2028,11 @@ declare const TraitSchema: z.ZodObject<{
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1981,6 +2050,8 @@ declare const TraitSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
+        definerKnob: z.ZodOptional<z.ZodString>;
+        scopeOverridden: z.ZodOptional<z.ZodBoolean>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodType<EventPayloadField, z.ZodTypeDef, EventPayloadField>, "many">>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
     }, "strip", z.ZodTypeAny, {
@@ -1991,6 +2062,8 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -1999,6 +2072,8 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -2066,10 +2141,10 @@ declare const TraitSchema: z.ZodObject<{
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -2090,10 +2165,10 @@ declare const TraitSchema: z.ZodObject<{
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -2113,8 +2188,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2122,8 +2197,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2135,8 +2210,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2148,8 +2223,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2289,6 +2364,7 @@ declare const TraitSchema: z.ZodObject<{
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     }>>;
+    typeParams: z.ZodOptional<z.ZodArray<z.ZodType<TraitTypeParamDef, z.ZodTypeDef, TraitTypeParamDef>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
@@ -2301,8 +2377,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2310,64 +2386,17 @@ declare const TraitSchema: z.ZodObject<{
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
-    capabilities?: string[] | undefined;
-    dataEntities?: {
-        name: string;
-        fields: TraitEntityField[];
+    emits?: {
+        event: string;
         description?: string | undefined;
-        pages?: string[] | undefined;
-        runtime?: boolean | undefined;
-        collection?: string | undefined;
-        timestamps?: boolean | undefined;
-        singleton?: boolean | undefined;
+        synonyms?: string | undefined;
+        eventId?: EventId | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }[] | undefined;
-    stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
-        states: {
-            name: string;
-            description?: string | undefined;
-            isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
-            isFinal?: boolean | undefined;
-            onEntry?: string[] | undefined;
-            onExit?: string[] | undefined;
-        }[];
-        transitions: {
-            event: string;
-            from: string;
-            to: string;
-            description?: string | null | undefined;
-            eventId?: EventId | undefined;
-            guard?: SExpr | undefined;
-            effects?: SExpr[][] | undefined;
-        }[];
-        guards?: {
-            name: string;
-            expression: SExpr;
-            description?: string | undefined;
-        }[] | undefined;
-    } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: EventId | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -2386,13 +2415,62 @@ declare const TraitSchema: z.ZodObject<{
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    linkedEntity?: string | undefined;
+    capabilities?: string[] | undefined;
+    dataEntities?: {
+        name: string;
+        fields: TraitEntityField[];
+        description?: string | undefined;
+        pages?: string[] | undefined;
+        runtime?: boolean | undefined;
+        collection?: string | undefined;
+        timestamps?: boolean | undefined;
+        singleton?: boolean | undefined;
+    }[] | undefined;
+    stateMachine?: {
+        states: {
+            name: string;
+            description?: string | undefined;
+            isInitial?: boolean | undefined;
+            isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
+            onEntry?: string[] | undefined;
+            onExit?: string[] | undefined;
+        }[];
+        transitions: {
+            event: string;
+            from: string;
+            to: string;
+            description?: string | null | undefined;
+            guard?: SExpr | undefined;
+            effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: EventId | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
+        }[];
+        guards?: {
+            name: string;
+            expression: SExpr;
+            description?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    linkedEntityId?: EntityId | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -2415,11 +2493,11 @@ declare const TraitSchema: z.ZodObject<{
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -2459,6 +2537,7 @@ declare const TraitSchema: z.ZodObject<{
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }, {
     name: string;
     scope: "collection" | "instance";
@@ -2471,8 +2550,8 @@ declare const TraitSchema: z.ZodObject<{
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -2480,6 +2559,43 @@ declare const TraitSchema: z.ZodObject<{
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
+    emits?: {
+        event: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
+    }[] | undefined;
+    listens?: {
+        event: string;
+        triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        source?: {
+            kind: "any";
+        } | {
+            trait: string;
+            kind: "trait";
+            traitId?: string | undefined;
+        } | {
+            orbital: string;
+            trait: string;
+            kind: "orbital";
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
+        } | undefined;
+        guard?: SExpr | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        triggersId?: string | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
+    }[] | undefined;
+    linkedEntity?: string | undefined;
     capabilities?: string[] | undefined;
     dataEntities?: {
         name: string;
@@ -2492,23 +2608,12 @@ declare const TraitSchema: z.ZodObject<{
         singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: string | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -2517,9 +2622,20 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -2527,42 +2643,7 @@ declare const TraitSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
     } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
     linkedEntityId?: string | undefined;
-    listens?: {
-        event: string;
-        triggers: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        source?: {
-            kind: "any";
-        } | {
-            trait: string;
-            kind: "trait";
-            traitId?: string | undefined;
-        } | {
-            orbital: string;
-            trait: string;
-            kind: "orbital";
-            traitId?: string | undefined;
-            orbitalId?: string | undefined;
-        } | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        guard?: SExpr | undefined;
-        triggersId?: string | undefined;
-        payloadMapping?: Record<string, SExpr> | undefined;
-    }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -2585,11 +2666,11 @@ declare const TraitSchema: z.ZodObject<{
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -2629,6 +2710,7 @@ declare const TraitSchema: z.ZodObject<{
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }>;
 declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<{
     ref: z.ZodString;
@@ -2640,6 +2722,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     name: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     eventIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EventId, string>>>;
+    typeArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodType<ConfigFieldDeclaration, z.ZodTypeDef, ConfigFieldDeclaration>, z.ZodType<TraitConfigValue, z.ZodTypeDef, TraitConfigValue>]>>>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2709,10 +2792,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -2733,10 +2816,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -2749,13 +2832,6 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -2774,13 +2850,21 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -2789,13 +2873,6 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -2814,13 +2891,21 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, {
     ref: string;
@@ -2829,13 +2914,6 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -2854,13 +2932,21 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -2869,13 +2955,6 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -2894,13 +2973,21 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, z.ZodObject<{
     id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
@@ -2981,16 +3068,16 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }, {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }>, "many">;
@@ -3038,17 +3125,17 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }, {
             event: string;
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
         }>, "many">;
         guards: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -3064,23 +3151,12 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             description?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -3089,20 +3165,14 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }[];
-        guards?: {
-            name: string;
-            expression: SExpr;
-            description?: string | undefined;
-        }[] | undefined;
-    }, {
         events: {
             name: string;
             key: string;
-            id?: string | undefined;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3110,12 +3180,18 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             classification?: "domain" | "system" | undefined;
             semanticRole?: string | undefined;
         }[];
+        guards?: {
+            name: string;
+            expression: SExpr;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -3124,9 +3200,20 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -3153,11 +3240,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }, {
         name: string;
@@ -3165,11 +3252,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3187,6 +3274,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
+        definerKnob: z.ZodOptional<z.ZodString>;
+        scopeOverridden: z.ZodOptional<z.ZodBoolean>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodType<EventPayloadField, z.ZodTypeDef, EventPayloadField>, "many">>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
     }, "strip", z.ZodTypeAny, {
@@ -3197,6 +3286,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -3205,6 +3296,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -3272,10 +3365,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -3296,10 +3389,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -3319,8 +3412,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3328,8 +3421,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3341,8 +3434,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3354,8 +3447,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3495,6 +3588,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     }>>;
+    typeParams: z.ZodOptional<z.ZodArray<z.ZodType<TraitTypeParamDef, z.ZodTypeDef, TraitTypeParamDef>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
@@ -3507,8 +3601,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3516,6 +3610,43 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
+    emits?: {
+        event: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        eventId?: EventId | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
+    }[] | undefined;
+    listens?: {
+        event: string;
+        triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        source?: {
+            kind: "any";
+        } | {
+            trait: string;
+            kind: "trait";
+            traitId?: TraitId | undefined;
+        } | {
+            orbital: string;
+            trait: string;
+            kind: "orbital";
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
+        } | undefined;
+        guard?: SExpr | undefined;
+        eventId?: EventId | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        triggersId?: EventId | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
+    }[] | undefined;
+    linkedEntity?: string | undefined;
     capabilities?: string[] | undefined;
     dataEntities?: {
         name: string;
@@ -3528,23 +3659,12 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -3553,9 +3673,20 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: EventId | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -3563,42 +3694,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             description?: string | undefined;
         }[] | undefined;
     } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: EventId | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
     linkedEntityId?: EntityId | undefined;
-    listens?: {
-        event: string;
-        triggers: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        source?: {
-            kind: "any";
-        } | {
-            trait: string;
-            kind: "trait";
-            traitId?: TraitId | undefined;
-        } | {
-            orbital: string;
-            trait: string;
-            kind: "orbital";
-            traitId?: TraitId | undefined;
-            orbitalId?: OrbitalId | undefined;
-        } | undefined;
-        eventId?: EventId | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        guard?: SExpr | undefined;
-        triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, SExpr> | undefined;
-    }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -3621,11 +3717,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -3665,6 +3761,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }, {
     name: string;
     scope: "collection" | "instance";
@@ -3677,8 +3774,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -3686,6 +3783,43 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
+    emits?: {
+        event: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
+    }[] | undefined;
+    listens?: {
+        event: string;
+        triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        source?: {
+            kind: "any";
+        } | {
+            trait: string;
+            kind: "trait";
+            traitId?: string | undefined;
+        } | {
+            orbital: string;
+            trait: string;
+            kind: "orbital";
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
+        } | undefined;
+        guard?: SExpr | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        triggersId?: string | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
+    }[] | undefined;
+    linkedEntity?: string | undefined;
     capabilities?: string[] | undefined;
     dataEntities?: {
         name: string;
@@ -3698,23 +3832,12 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: string | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -3723,9 +3846,20 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -3733,42 +3867,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             description?: string | undefined;
         }[] | undefined;
     } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
     linkedEntityId?: string | undefined;
-    listens?: {
-        event: string;
-        triggers: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        source?: {
-            kind: "any";
-        } | {
-            trait: string;
-            kind: "trait";
-            traitId?: string | undefined;
-        } | {
-            orbital: string;
-            trait: string;
-            kind: "orbital";
-            traitId?: string | undefined;
-            orbitalId?: string | undefined;
-        } | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        guard?: SExpr | undefined;
-        triggersId?: string | undefined;
-        payloadMapping?: Record<string, SExpr> | undefined;
-    }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -3791,11 +3890,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -3835,6 +3934,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodObject<
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }>]>;
 /**
  * Check if a trait ref is an inline Trait definition
@@ -3916,6 +4016,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     name: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     eventIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EventId, string>>>;
+    typeArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodType<ConfigFieldDeclaration, z.ZodTypeDef, ConfigFieldDeclaration>, z.ZodType<TraitConfigValue, z.ZodTypeDef, TraitConfigValue>]>>>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3985,10 +4086,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -4009,10 +4110,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -4025,13 +4126,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4050,13 +4144,21 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -4065,13 +4167,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4090,13 +4185,21 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, {
     ref: string;
@@ -4105,13 +4208,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: TraitId | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: EntityId | undefined;
-    eventIds?: Record<string, EventId> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4130,13 +4226,21 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: TraitId | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
@@ -4145,13 +4249,6 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     name?: string | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     fields?: Record<string, string> | undefined;
-    events?: Record<string, string> | undefined;
-    effects?: Record<string, SExpr[]> | undefined;
-    refId?: string | undefined;
-    appliesTo?: string[] | undefined;
-    linkedEntity?: string | undefined;
-    linkedEntityId?: string | undefined;
-    eventIds?: Record<string, string> | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4170,13 +4267,21 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
+    effects?: Record<string, SExpr[]> | undefined;
+    linkedEntity?: string | undefined;
+    events?: Record<string, string> | undefined;
+    refId?: string | undefined;
+    appliesTo?: string[] | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
+    typeArgs?: Record<string, string> | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, z.ZodObject<{
     id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
@@ -4257,16 +4362,16 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }, {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }>, "many">;
@@ -4314,17 +4419,17 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }, {
             event: string;
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
         }>, "many">;
         guards: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -4340,23 +4445,12 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             description?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -4365,20 +4459,14 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
         }[];
-        guards?: {
-            name: string;
-            expression: SExpr;
-            description?: string | undefined;
-        }[] | undefined;
-    }, {
         events: {
             name: string;
             key: string;
-            id?: string | undefined;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4386,12 +4474,18 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             classification?: "domain" | "system" | undefined;
             semanticRole?: string | undefined;
         }[];
+        guards?: {
+            name: string;
+            expression: SExpr;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -4400,9 +4494,20 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -4429,11 +4534,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }, {
         name: string;
@@ -4441,11 +4546,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -4463,6 +4568,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
+        definerKnob: z.ZodOptional<z.ZodString>;
+        scopeOverridden: z.ZodOptional<z.ZodBoolean>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodType<EventPayloadField, z.ZodTypeDef, EventPayloadField>, "many">>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
     }, "strip", z.ZodTypeAny, {
@@ -4473,6 +4580,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -4481,6 +4590,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -4548,10 +4659,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: TraitId | undefined;
             orbitalId?: OrbitalId | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: EventId | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }, {
@@ -4572,10 +4683,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             traitId?: string | undefined;
             orbitalId?: string | undefined;
         } | undefined;
+        guard?: SExpr | undefined;
         eventId?: string | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
-        guard?: SExpr | undefined;
         triggersId?: string | undefined;
         payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
@@ -4595,8 +4706,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4604,8 +4715,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4617,8 +4728,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4630,8 +4741,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4771,6 +4882,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     }>>;
+    typeParams: z.ZodOptional<z.ZodArray<z.ZodType<TraitTypeParamDef, z.ZodTypeDef, TraitTypeParamDef>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
@@ -4783,8 +4895,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4792,6 +4904,43 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
+    emits?: {
+        event: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        eventId?: EventId | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
+    }[] | undefined;
+    listens?: {
+        event: string;
+        triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        source?: {
+            kind: "any";
+        } | {
+            trait: string;
+            kind: "trait";
+            traitId?: TraitId | undefined;
+        } | {
+            orbital: string;
+            trait: string;
+            kind: "orbital";
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
+        } | undefined;
+        guard?: SExpr | undefined;
+        eventId?: EventId | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        triggersId?: EventId | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
+    }[] | undefined;
+    linkedEntity?: string | undefined;
     capabilities?: string[] | undefined;
     dataEntities?: {
         name: string;
@@ -4804,23 +4953,12 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: EventId | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -4829,9 +4967,20 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: EventId | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: EventId | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -4839,42 +4988,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             description?: string | undefined;
         }[] | undefined;
     } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: EventId | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
     linkedEntityId?: EntityId | undefined;
-    listens?: {
-        event: string;
-        triggers: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        source?: {
-            kind: "any";
-        } | {
-            trait: string;
-            kind: "trait";
-            traitId?: TraitId | undefined;
-        } | {
-            orbital: string;
-            trait: string;
-            kind: "orbital";
-            traitId?: TraitId | undefined;
-            orbitalId?: OrbitalId | undefined;
-        } | undefined;
-        eventId?: EventId | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        guard?: SExpr | undefined;
-        triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, SExpr> | undefined;
-    }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -4897,11 +5011,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: PageId[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -4941,6 +5055,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }, {
     name: string;
     scope: "collection" | "instance";
@@ -4953,8 +5068,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             width?: string | undefined;
             title?: string | undefined;
             totalSteps?: number | undefined;
-            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             step?: number | undefined;
+            size?: "sm" | "md" | "lg" | "xl" | "full" | undefined;
             position?: "top" | "center" | "left" | "right" | "bottom" | undefined;
             showProgress?: boolean | undefined;
             closable?: boolean | undefined;
@@ -4962,6 +5077,43 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
     }> | undefined;
     category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
+    emits?: {
+        event: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        payloadSchema?: EventPayloadField[] | undefined;
+        definerKnob?: string | undefined;
+        scopeOverridden?: boolean | undefined;
+    }[] | undefined;
+    listens?: {
+        event: string;
+        triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        source?: {
+            kind: "any";
+        } | {
+            trait: string;
+            kind: "trait";
+            traitId?: string | undefined;
+        } | {
+            orbital: string;
+            trait: string;
+            kind: "orbital";
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
+        } | undefined;
+        guard?: SExpr | undefined;
+        eventId?: string | undefined;
+        scope?: "internal" | "external" | undefined;
+        tier?: string | undefined;
+        triggersId?: string | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
+    }[] | undefined;
+    linkedEntity?: string | undefined;
     capabilities?: string[] | undefined;
     dataEntities?: {
         name: string;
@@ -4974,23 +5126,12 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
-        events: {
-            name: string;
-            key: string;
-            id?: string | undefined;
-            description?: string | undefined;
-            synonyms?: string | undefined;
-            tier?: string | undefined;
-            payloadSchema?: PayloadField[] | undefined;
-            classification?: "domain" | "system" | undefined;
-            semanticRole?: string | undefined;
-        }[];
         states: {
             name: string;
             description?: string | undefined;
             isInitial?: boolean | undefined;
-            isTerminal?: boolean | undefined;
             isFinal?: boolean | undefined;
+            isTerminal?: boolean | undefined;
             onEntry?: string[] | undefined;
             onExit?: string[] | undefined;
         }[];
@@ -4999,9 +5140,20 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             from: string;
             to: string;
             description?: string | null | undefined;
-            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: SExpr[][] | undefined;
+            eventId?: string | undefined;
+        }[];
+        events: {
+            name: string;
+            key: string;
+            id?: string | undefined;
+            description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
+            payloadSchema?: PayloadField[] | undefined;
+            classification?: "domain" | "system" | undefined;
+            semanticRole?: string | undefined;
         }[];
         guards?: {
             name: string;
@@ -5009,42 +5161,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             description?: string | undefined;
         }[] | undefined;
     } | undefined;
-    emits?: {
-        event: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        payloadSchema?: EventPayloadField[] | undefined;
-    }[] | undefined;
-    linkedEntity?: string | undefined;
     linkedEntityId?: string | undefined;
-    listens?: {
-        event: string;
-        triggers: string;
-        description?: string | undefined;
-        synonyms?: string | undefined;
-        source?: {
-            kind: "any";
-        } | {
-            trait: string;
-            kind: "trait";
-            traitId?: string | undefined;
-        } | {
-            orbital: string;
-            trait: string;
-            kind: "orbital";
-            traitId?: string | undefined;
-            orbitalId?: string | undefined;
-        } | undefined;
-        eventId?: string | undefined;
-        scope?: "internal" | "external" | undefined;
-        tier?: string | undefined;
-        guard?: SExpr | undefined;
-        triggersId?: string | undefined;
-        payloadMapping?: Record<string, SExpr> | undefined;
-    }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
     entityContract?: {
@@ -5067,11 +5184,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
         interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
-        priority?: number | undefined;
+        emits?: string[] | undefined;
         guard?: SExpr | undefined;
+        priority?: number | undefined;
         appliesTo?: string[] | undefined;
         pageIds?: string[] | undefined;
-        emits?: string[] | undefined;
         emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
@@ -5111,6 +5228,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodEffects<z.Zod
             aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
         } | undefined;
     } | undefined;
+    typeParams?: TraitTypeParamDef[] | undefined;
 }>]>;
-export { TraitConfigValueSchema as $, OrbitalTraitRefSchema as A, PayloadFieldSchema as B, type ConfigFieldDeclaration as C, type DeclaredTraitConfig as D, type EventPayloadField as E, type PresentationType as F, type Guard as G, type ReferenceConfigType as H, type RequiredField as I, RequiredFieldSchema as J, SECRET_CONFIG_TYPES as K, type ListenSource as L, type SecretConfigType as M, type StateInput as N, type OrbitalTraitRef as O, type PayloadField as P, type StateMachine as Q, REFERENCE_CONFIG_TYPES as R, type State as S, type TraitEventListener as T, type StateMachineInput as U, StateMachineSchema as V, StateSchema as W, TickIntervalSchema as X, type TraitCategory as Y, TraitCategorySchema as Z, TraitConfigSchema as _, type TraitReference as a, type TraitDataEntity as a0, TraitDataEntitySchema as a1, TraitEntityFieldSchema as a2, TraitEventContractSchema as a3, TraitEventListenerSchema as a4, type TraitInput as a5, TraitRefSchema as a6, type TraitReferenceInput as a7, TraitReferenceSchema as a8, TraitSchema as a9, type TraitTick as aa, TraitTickSchema as ab, type TraitUIBinding as ac, TraitUIBindingSchema as ad, type Transition as ae, type TransitionInput as af, TransitionSchema as ag, configRefEventKnob as ah, getTraitConfig as ai, getTraitName as aj, isCallSiteConfigDeclaration as ak, isCircuitEvent as al, isInlineTrait as am, isReferenceConfigType as an, isSecretConfigType as ao, maskSecretConfigValues as ap, normalizeCallSiteConfigToValues as aq, normalizeTraitRef as ar, resolveConfigRefEventName as as, type TraitScope as at, type TraitConfig as b, type TraitConfigObject as c, type TraitRef as d, type TraitConfigValue as e, type TraitEntityField as f, type Trait as g, type CallSiteConfig as h, type CallSiteConfigEntry as i, type TraitEventContract as j, CONFIG_REF_EVENT_PATTERN as k, ConfigFieldDeclarationSchema as l, type ConfigFieldItemsDeclaration as m, type ConfigRefEventError as n, DeclaredTraitConfigSchema as o, type EntityFieldContract as p, EntityFieldContractSchema as q, type Event as r, type EventInput as s, EventPayloadFieldSchema as t, EventSchema as u, type EventScope as v, EventScopeSchema as w, type GuardInput as x, GuardSchema as y, ListenSourceSchema as z };
+export { TraitConfigSchema as $, ListenSourceSchema as A, OrbitalTraitRefSchema as B, type ConfigFieldDeclaration as C, type DeclaredTraitConfig as D, type EventPayloadField as E, PayloadFieldSchema as F, type Guard as G, type PresentationType as H, type ReferenceConfigType as I, type RequiredField as J, RequiredFieldSchema as K, type ListenSource as L, SECRET_CONFIG_TYPES as M, type SecretConfigType as N, type OrbitalTraitRef as O, type PayloadField as P, type StateInput as Q, REFERENCE_CONFIG_TYPES as R, type State as S, type TraitEventListener as T, type StateMachine as U, type StateMachineInput as V, StateMachineSchema as W, StateSchema as X, TickIntervalSchema as Y, type TraitCategory as Z, TraitCategorySchema as _, type TraitReference as a, TraitConfigValueSchema as a0, type TraitDataEntity as a1, TraitDataEntitySchema as a2, TraitEntityFieldSchema as a3, TraitEventContractSchema as a4, TraitEventListenerSchema as a5, type TraitInput as a6, TraitRefSchema as a7, type TraitReferenceInput as a8, TraitReferenceSchema as a9, TraitSchema as aa, type TraitTick as ab, TraitTickSchema as ac, type TraitUIBinding as ad, TraitUIBindingSchema as ae, type Transition as af, type TransitionInput as ag, TransitionSchema as ah, configRefEventKnob as ai, getTraitConfig as aj, getTraitName as ak, isCallSiteConfigDeclaration as al, isCircuitEvent as am, isInlineTrait as an, isReferenceConfigType as ao, isSecretConfigType as ap, maskSecretConfigValues as aq, normalizeCallSiteConfigToValues as ar, normalizeTraitRef as as, resolveConfigRefEventName as at, type TraitScope as au, type TraitConfig as b, type TraitConfigObject as c, type TraitRef as d, type TraitConfigValue as e, type TraitEntityField as f, type TraitTypeParamDef as g, type Trait as h, type CallSiteConfig as i, type CallSiteConfigEntry as j, type TraitEventContract as k, CONFIG_REF_EVENT_PATTERN as l, ConfigFieldDeclarationSchema as m, type ConfigFieldItemsDeclaration as n, type ConfigRefEventError as o, DeclaredTraitConfigSchema as p, type EntityFieldContract as q, EntityFieldContractSchema as r, type Event as s, type EventInput as t, EventPayloadFieldSchema as u, EventSchema as v, type EventScope as w, EventScopeSchema as x, type GuardInput as y, GuardSchema as z };