@almadar/core 9.4.0 → 9.6.0

package/dist/{trait-S6adsRKG.d.ts → trait-BjSJtFXv.d.ts}

@@ -135,6 +135,13 @@ interface EntityFieldBase {
     /** Runtime-managed widget state (authored `@intrinsic` in `.lolo`). Exempt
      *  from the explicit-binding rule and never a domain-data bind target. */
     intrinsic?: boolean;
+    /** Human/semantic description (authored `@description "..."` in `.lolo`).
+     *  Authoring/build-time metadata — factory-signature catalog, embeddings,
+     *  curation field-matching; the runtime ignores it. */
+    description?: string;
+    /** User-vocabulary synonyms (authored `@synonyms "..."` in `.lolo`).
+     *  Free text feeding catalog search / curation field-matching. */
+    synonyms?: string;
 }
 /**
  * Scalar / structural fields — no type-dependent payload required.
@@ -1377,11 +1384,11 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     name: string;
     persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
     fields: EntityField[];
+    description?: string | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
-    description?: string | undefined;
     visual_prompt?: string | undefined;
     assetRef?: {
         role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -1393,12 +1400,12 @@ declare const OrbitalEntitySchema: z.ZodObject<{
 }, {
     name: string;
     fields: unknown[];
+    description?: string | undefined;
     persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
-    description?: string | undefined;
     visual_prompt?: string | undefined;
     assetRef?: {
         role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -1445,11 +1452,11 @@ declare const EntitySchema: z.ZodObject<{
     name: string;
     persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
     fields: EntityField[];
+    description?: string | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
-    description?: string | undefined;
     visual_prompt?: string | undefined;
     assetRef?: {
         role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -1461,12 +1468,12 @@ declare const EntitySchema: z.ZodObject<{
 }, {
     name: string;
     fields: unknown[];
+    description?: string | undefined;
     persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
-    description?: string | undefined;
     visual_prompt?: string | undefined;
     assetRef?: {
         role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -2292,8 +2299,13 @@ interface Event {
     key: string;
     /** Human-readable name */
     name: string;
-    /** Description */
+    /** Description (authored `@description` on the emit/listen). */
     description?: string;
+    /** User-vocabulary synonyms (comma-separated) — per-event analogue of a
+     *  field/config `@synonyms`. Feeds the curation event matcher. */
+    synonyms?: string;
+    /** Authoring tier (`essential`/`customization`/`advanced`/`internal`). */
+    tier?: string;
     /** Expected payload structure */
     payloadSchema?: PayloadField[];
     /** Domain vs System classification (optional, for analysis) */
@@ -2305,6 +2317,8 @@ declare const EventSchema: z.ZodObject<{
     key: z.ZodString;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    synonyms: z.ZodOptional<z.ZodString>;
+    tier: z.ZodOptional<z.ZodString>;
     payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodString;
@@ -2324,6 +2338,8 @@ declare const EventSchema: z.ZodObject<{
     name: string;
     key: string;
     description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     payloadSchema?: {
         type: string;
         name: string;
@@ -2335,6 +2351,8 @@ declare const EventSchema: z.ZodObject<{
     name: string;
     key: string;
     description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     payloadSchema?: {
         type: string;
         name: string;
@@ -2468,6 +2486,8 @@ declare const StateMachineSchema: z.ZodObject<{
         key: z.ZodString;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodString;
@@ -2487,6 +2507,8 @@ declare const StateMachineSchema: z.ZodObject<{
         name: string;
         key: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -2498,6 +2520,8 @@ declare const StateMachineSchema: z.ZodObject<{
         name: string;
         key: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -2546,6 +2570,8 @@ declare const StateMachineSchema: z.ZodObject<{
         name: string;
         key: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -2581,6 +2607,8 @@ declare const StateMachineSchema: z.ZodObject<{
         name: string;
         key: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -2757,11 +2785,11 @@ declare const TraitDataEntitySchema: z.ZodObject<{
         required?: boolean | undefined;
         default?: unknown;
     }[];
+    description?: string | undefined;
     runtime?: boolean | undefined;
     singleton?: boolean | undefined;
     collection?: string | undefined;
     timestamps?: boolean | undefined;
-    description?: string | undefined;
     pages?: string[] | undefined;
 }, {
     name: string;
@@ -2772,11 +2800,11 @@ declare const TraitDataEntitySchema: z.ZodObject<{
         required?: boolean | undefined;
         default?: unknown;
     }[];
+    description?: string | undefined;
     runtime?: boolean | undefined;
     singleton?: boolean | undefined;
     collection?: string | undefined;
     timestamps?: boolean | undefined;
-    description?: string | undefined;
     pages?: string[] | undefined;
 }>;
 /**
@@ -2904,6 +2932,11 @@ interface TraitEventContract {
     event: string;
     /** Human-readable description */
     description?: string;
+    /** User-vocabulary synonyms (comma-separated) — the per-event analogue of a
+     *  field/config `@synonyms`. Feeds the curation event matcher. */
+    synonyms?: string;
+    /** Authoring tier (`essential`/`customization`/`advanced`/`internal`). */
+    tier?: string;
     /** 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. */
@@ -2925,6 +2958,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
      */
     event: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    synonyms: z.ZodOptional<z.ZodString>;
+    tier: z.ZodOptional<z.ZodString>;
     payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         /**
@@ -2958,6 +2993,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     event: string;
     description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     payloadSchema?: {
         type: string;
         name: string;
@@ -2969,6 +3006,8 @@ declare const TraitEventContractSchema: z.ZodObject<{
 }, {
     event: string;
     description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     payloadSchema?: {
         type: string;
         name: string;
@@ -3039,6 +3078,12 @@ interface TraitEventListener {
     event: string;
     /** State machine event to trigger */
     triggers: string;
+    /** Human-readable description (authored `@description` on the listen). */
+    description?: string;
+    /** User-vocabulary synonyms (comma-separated). */
+    synonyms?: string;
+    /** Authoring tier (`essential`/`customization`/`advanced`/`internal`). */
+    tier?: string;
     /** Guard expression - string (legacy) or S-expression array */
     guard?: Expression;
     /**
@@ -3058,6 +3103,9 @@ interface TraitEventListener {
 declare const TraitEventListenerSchema: z.ZodObject<{
     event: z.ZodString;
     triggers: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    synonyms: z.ZodOptional<z.ZodString>;
+    tier: z.ZodOptional<z.ZodString>;
     guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
     scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
     payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -3092,6 +3140,9 @@ declare const TraitEventListenerSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     event: string;
     triggers: string;
+    description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     guard?: SExpr | undefined;
     source?: {
         kind: "any";
@@ -3108,6 +3159,9 @@ declare const TraitEventListenerSchema: z.ZodObject<{
 }, {
     event: string;
     triggers: string;
+    description?: string | undefined;
+    synonyms?: string | undefined;
+    tier?: string | undefined;
     guard?: SExpr | undefined;
     source?: {
         kind: "any";
@@ -3529,11 +3583,11 @@ declare const TraitSchema: z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }, {
         name: string;
@@ -3544,11 +3598,11 @@ declare const TraitSchema: z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
@@ -3581,6 +3635,8 @@ declare const TraitSchema: z.ZodObject<{
             key: z.ZodString;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            synonyms: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodString>;
             payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodString;
@@ -3600,6 +3656,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -3611,6 +3669,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -3659,6 +3719,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -3694,6 +3756,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -3767,6 +3831,8 @@ declare const TraitSchema: z.ZodObject<{
          */
         event: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             /**
@@ -3800,6 +3866,8 @@ declare const TraitSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -3811,6 +3879,8 @@ declare const TraitSchema: z.ZodObject<{
     }, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -3823,6 +3893,9 @@ declare const TraitSchema: z.ZodObject<{
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
         triggers: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
         payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -3857,6 +3930,9 @@ declare const TraitSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -3873,6 +3949,9 @@ declare const TraitSchema: z.ZodObject<{
     }, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -3935,11 +4014,11 @@ declare const TraitSchema: z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -3951,12 +4030,12 @@ declare const TraitSchema: z.ZodObject<{
     }, {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -3969,14 +4048,16 @@ declare const TraitSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -3989,6 +4070,9 @@ declare const TraitSchema: z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4026,11 +4110,11 @@ declare const TraitSchema: z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -4038,6 +4122,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4090,11 +4176,11 @@ declare const TraitSchema: z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -4107,14 +4193,16 @@ declare const TraitSchema: z.ZodObject<{
 }, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -4127,6 +4215,9 @@ declare const TraitSchema: z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4164,11 +4255,11 @@ declare const TraitSchema: z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -4176,6 +4267,8 @@ declare const TraitSchema: z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4227,12 +4320,12 @@ declare const TraitSchema: z.ZodObject<{
     sourceEntityDefinition?: {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -4331,11 +4424,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }, {
         name: string;
@@ -4346,11 +4439,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
@@ -4383,6 +4476,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             key: z.ZodString;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            synonyms: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodString>;
             payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodString;
@@ -4402,6 +4497,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4413,6 +4510,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4461,6 +4560,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4496,6 +4597,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4569,6 +4672,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
          */
         event: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             /**
@@ -4602,6 +4707,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -4613,6 +4720,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -4625,6 +4734,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
         triggers: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
         payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -4659,6 +4771,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4675,6 +4790,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4737,11 +4855,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -4753,12 +4871,12 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -4771,14 +4889,16 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -4791,6 +4911,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4828,11 +4951,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -4840,6 +4963,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -4892,11 +5017,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -4909,14 +5034,16 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -4929,6 +5056,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -4966,11 +5096,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -4978,6 +5108,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5029,12 +5161,12 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     sourceEntityDefinition?: {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -5203,11 +5335,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }, {
         name: string;
@@ -5218,11 +5350,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
@@ -5255,6 +5387,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             key: z.ZodString;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
+            synonyms: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodString>;
             payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodString;
@@ -5274,6 +5408,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5285,6 +5421,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5333,6 +5471,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5368,6 +5508,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5441,6 +5583,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
          */
         event: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         payloadSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             /**
@@ -5474,6 +5618,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -5485,6 +5631,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -5497,6 +5645,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
         triggers: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        synonyms: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
         payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -5531,6 +5682,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -5547,6 +5701,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -5609,11 +5766,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -5625,12 +5782,12 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -5643,14 +5800,16 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -5663,6 +5822,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -5700,11 +5862,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -5712,6 +5874,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5764,11 +5928,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
+        description?: string | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
@@ -5781,14 +5945,16 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     scope: "instance" | "collection";
+    description?: string | undefined;
     ui?: Record<string, unknown> | 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;
-    description?: string | undefined;
     config?: Readonly<Record<string, ConfigFieldDeclaration>> | undefined;
     capabilities?: string[] | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         payloadSchema?: {
             type: string;
             name: string;
@@ -5801,6 +5967,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     listens?: {
         event: string;
         triggers: string;
+        description?: string | undefined;
+        synonyms?: string | undefined;
+        tier?: string | undefined;
         guard?: SExpr | undefined;
         source?: {
             kind: "any";
@@ -5838,11 +6007,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             required?: boolean | undefined;
             default?: unknown;
         }[];
+        description?: string | undefined;
         runtime?: boolean | undefined;
         singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
-        description?: string | undefined;
         pages?: string[] | undefined;
     }[] | undefined;
     stateMachine?: {
@@ -5850,6 +6019,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             name: string;
             key: string;
             description?: string | undefined;
+            synonyms?: string | undefined;
+            tier?: string | undefined;
             payloadSchema?: {
                 type: string;
                 name: string;
@@ -5901,12 +6072,12 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     sourceEntityDefinition?: {
         name: string;
         fields: unknown[];
+        description?: string | undefined;
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
-        description?: string | undefined;
         visual_prompt?: string | undefined;
         assetRef?: {
             role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";