@almadar/core 10.7.0 → 10.9.0

package/dist/{schema-QKCaijbj.d.ts → schema-DAc5czBW.d.ts}

@@ -1,5 +1,5 @@
 import { E as Expression, S as SExpr } from './expression-BUIi9ezJ.js';
-import { T as TraitConfig, k as TraitConfigObject, S as ServiceRef, d as Entity, f as EntityField, g as EntityPersistence, i as TraitRef, l as EventPayloadField, C as ConfigFieldDeclaration, m as ServiceDefinition, a as Trait } from './trait-BkW6nFHo.js';
+import { T as TraitConfig, k as TraitConfigObject, S as ServiceRef, d as Entity, f as EntityField, g as EntityPersistence, i as TraitRef, l as EventPayloadField, m as ConfigFieldDeclaration, n as ServiceDefinition, a as Trait } from './trait-CWjT0yBO.js';
 import { z } from 'zod';
 
 /**
@@ -19522,7 +19522,6 @@ declare const PageRefObjectSchema: z.ZodObject<{
     ref: string;
     path?: string | undefined;
     from?: string | undefined;
-    linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
         scope: "instance" | "collection";
@@ -19677,11 +19676,11 @@ declare const PageRefObjectSchema: z.ZodObject<{
         events?: Record<string, string> | undefined;
         linkedEntity?: string | undefined;
     })[] | undefined;
+    linkedEntity?: string | undefined;
 }, {
     ref: string;
     path?: string | undefined;
     from?: string | undefined;
-    linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
         scope: "instance" | "collection";
@@ -19836,6 +19835,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
         events?: Record<string, string> | undefined;
         linkedEntity?: string | undefined;
     })[] | undefined;
+    linkedEntity?: string | undefined;
 }>;
 declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
     name: z.ZodString;
@@ -20728,7 +20728,6 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
     ref: string;
     path?: string | undefined;
     from?: string | undefined;
-    linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
         scope: "instance" | "collection";
@@ -20883,11 +20882,11 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
         events?: Record<string, string> | undefined;
         linkedEntity?: string | undefined;
     })[] | undefined;
+    linkedEntity?: string | undefined;
 }, {
     ref: string;
     path?: string | undefined;
     from?: string | undefined;
-    linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
         scope: "instance" | "collection";
@@ -21042,6 +21041,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
         events?: Record<string, string> | undefined;
         linkedEntity?: string | undefined;
     })[] | undefined;
+    linkedEntity?: string | undefined;
 }>]>;
 /**
  * Checks if a trait reference is an imported reference.
@@ -27308,7 +27308,6 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -27463,11 +27462,11 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }, {
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -27622,6 +27621,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }>]>, "many">;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -28062,7 +28062,6 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -28217,6 +28216,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -28976,7 +28976,6 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -29131,6 +29130,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -35565,7 +35565,6 @@ declare const OrbitalSchema$1: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -35720,11 +35719,11 @@ declare const OrbitalSchema$1: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }, {
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -35879,6 +35878,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }>]>, "many">;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -36319,7 +36319,6 @@ declare const OrbitalSchema$1: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -36474,6 +36473,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -37233,7 +37233,6 @@ declare const OrbitalSchema$1: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -37388,6 +37387,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -43829,7 +43829,6 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -43984,11 +43983,11 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }, {
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -44143,6 +44142,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     }>]>, "many">;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
@@ -44583,7 +44583,6 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -44738,6 +44737,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -45497,7 +45497,6 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         ref: string;
         path?: string | undefined;
         from?: string | undefined;
-        linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
             scope: "instance" | "collection";
@@ -45652,6 +45651,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             events?: Record<string, string> | undefined;
             linkedEntity?: string | undefined;
         })[] | undefined;
+        linkedEntity?: string | undefined;
     })[];
     description?: string | undefined;
     visual_prompt?: string | undefined;
@@ -52430,7 +52430,6 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -52585,11 +52584,11 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         }, {
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -52744,6 +52743,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         }>]>, "many">;
         emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
             event: z.ZodString;
@@ -53184,7 +53184,6 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -53339,6 +53338,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;
@@ -54098,7 +54098,6 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -54253,6 +54252,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;
@@ -55234,7 +55234,6 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -55389,6 +55388,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;
@@ -56250,7 +56250,6 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -56405,6 +56404,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;
@@ -57331,7 +57331,6 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -57486,6 +57485,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;
@@ -58347,7 +58347,6 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             ref: string;
             path?: string | undefined;
             from?: string | undefined;
-            linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
                 scope: "instance" | "collection";
@@ -58502,6 +58501,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
                 events?: Record<string, string> | undefined;
                 linkedEntity?: string | undefined;
             })[] | undefined;
+            linkedEntity?: string | undefined;
         })[];
         description?: string | undefined;
         visual_prompt?: string | undefined;

package/dist/{trait-BkW6nFHo.d.ts → trait-CWjT0yBO.d.ts}

@@ -1069,6 +1069,57 @@ declare const SemanticAssetRefSchema: z.ZodObject<{
     dimension?: "2d" | "3d" | undefined;
     aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
 }>;
+/**
+ * The single asset type: a `SemanticAssetRef` (role/dimension/animations/aspect/style)
+ * WITH its resolved URL folded in. Used everywhere an asset is referenced — a lolo
+ * board `assetManifest` (`Map string Asset`), every `@almadar/ui` game prop, the
+ * asset-workflow's resolved/pool assets, and the inspector picker. Replaces the bare
+ * `AssetUrl`-string asset field so the render metadata travels WITH the asset (no
+ * pixel-dimension or filename heuristics needed to know sheet-vs-frame / 2d-vs-3d).
+ */
+interface Asset extends SemanticAssetRef {
+    /** The resolved asset URL. */
+    url: AssetUrl;
+    /** Optional display name (inspector picker). */
+    name?: string;
+    /** Optional thumbnail URL (inspector picker grid). */
+    thumbnailUrl?: string;
+}
+declare const AssetSchema: z.ZodObject<{
+    role: z.ZodEnum<["player", "enemy", "npc", "item", "tile", "projectile", "effect", "ui", "decoration", "vehicle"]>;
+    category: z.ZodString;
+    animations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    style: z.ZodOptional<z.ZodEnum<["pixel", "vector", "hd", "1-bit", "isometric"]>>;
+    variant: z.ZodOptional<z.ZodString>;
+    dimension: z.ZodOptional<z.ZodEnum<["2d", "3d"]>>;
+    aspect: z.ZodOptional<z.ZodEnum<["1:1", "16:9", "5:7", "8:1"]>>;
+} & {
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
+    category: string;
+    name?: string | undefined;
+    animations?: string[] | undefined;
+    style?: "pixel" | "vector" | "hd" | "1-bit" | "isometric" | undefined;
+    variant?: string | undefined;
+    dimension?: "2d" | "3d" | undefined;
+    aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
+    thumbnailUrl?: string | undefined;
+}, {
+    url: string;
+    role: "player" | "enemy" | "npc" | "item" | "tile" | "projectile" | "effect" | "ui" | "decoration" | "vehicle";
+    category: string;
+    name?: string | undefined;
+    animations?: string[] | undefined;
+    style?: "pixel" | "vector" | "hd" | "1-bit" | "isometric" | undefined;
+    variant?: string | undefined;
+    dimension?: "2d" | "3d" | undefined;
+    aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
+    thumbnailUrl?: string | undefined;
+}>;
 /**
  * Result of resolving a SemanticAssetRef to actual asset paths
  */
@@ -2857,6 +2908,27 @@ type TraitConfig = TraitConfigObject;
 /** Zod schema for TraitConfig. Recursive via z.lazy to allow nested structures. */
 declare const TraitConfigValueSchema: z.ZodType<TraitConfigValue>;
 declare const TraitConfigSchema: z.ZodType<TraitConfig>;
+/**
+ * A single entry in a call-site `config { }` override block. Either a plain
+ * wiring value (`TraitConfigValue` — string, number, bool, array, object) or
+ * a fully-annotated re-declaration (`ConfigFieldDeclaration` — carries `type`,
+ * optional `label`/`description`/`synonyms`/`tier`). Disambiguated at runtime
+ * by `isCallSiteConfigDeclaration`: the presence of a `"type"` string key
+ * marks the annotated form.
+ *
+ * The `.orb` compiler emits plain values for wiring entries and
+ * `{ type, default, ... }` objects for annotated entries. Consumers that only
+ * need the value (e.g. `apply-params-to-orb.ts`) read `entry` directly for
+ * primitives or `entry.default` for the declaration form.
+ */
+type CallSiteConfigEntry = TraitConfigValue | ConfigFieldDeclaration;
+/** Typed map of call-site config entries (one per knob). */
+type CallSiteConfig = Readonly<Record<string, CallSiteConfigEntry>>;
+/**
+ * Type guard: returns `true` when `entry` is an annotated `ConfigFieldDeclaration`
+ * (has a `"type"` string key) rather than a plain wiring value.
+ */
+declare function isCallSiteConfigDeclaration(entry: CallSiteConfigEntry): entry is ConfigFieldDeclaration;
 /**
  * Per-field entry in a trait's DECLARED `config { }` schema as it lives
  * on the `.orb` JSON: `{ type: "string" | "[string]" | "object" | ...,
@@ -3422,7 +3494,17 @@ interface TraitReference {
      * fields. Applied during inline substitution alongside `linkedEntity`.
      */
     fields?: Record<string, string>;
-    config?: TraitConfig;
+    /**
+     * Call-site config overrides. Each entry is either a plain wiring value
+     * (`TraitConfigValue`) or a fully-annotated re-declaration
+     * (`ConfigFieldDeclaration` with `type`, optional `label`/`description`/
+     * `synonyms`/`tier`). Use `isCallSiteConfigDeclaration` to discriminate.
+     *
+     * Plain wiring (existing callers): `config: { icon: "star", count: 5 }`.
+     * Annotated (new): `config: { icon: { type: "string", default: "star",
+     *   label: "Icon", tier: "presentation" } }`.
+     */
+    config?: CallSiteConfig;
     appliesTo?: string[];
     /**
      * Phase F.7: replace the imported trait's `listens` array with the
@@ -3473,7 +3555,7 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    config: z.ZodOptional<z.ZodType<TraitConfigObject, z.ZodTypeDef, TraitConfigObject>>;
+    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">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
     emitsScope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
@@ -3482,49 +3564,49 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     ref: string;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
-    config?: TraitConfigObject | undefined;
+    config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
     from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
     listens?: unknown[] | undefined;
-    linkedEntity?: string | undefined;
     appliesTo?: string[] | undefined;
+    linkedEntity?: string | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
-    config?: TraitConfigObject | undefined;
+    config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
     from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
     listens?: unknown[] | undefined;
-    linkedEntity?: string | undefined;
     appliesTo?: string[] | undefined;
+    linkedEntity?: string | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, {
     ref: string;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
-    config?: TraitConfigObject | undefined;
+    config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
     from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
     listens?: unknown[] | undefined;
-    linkedEntity?: string | undefined;
     appliesTo?: string[] | undefined;
+    linkedEntity?: string | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
-    config?: TraitConfigObject | undefined;
+    config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
     from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
     listens?: unknown[] | undefined;
-    linkedEntity?: string | undefined;
     appliesTo?: string[] | undefined;
+    linkedEntity?: string | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>;
 /**
@@ -3538,7 +3620,7 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
  */
 type TraitRef = string | {
     ref: string;
-    config?: TraitConfig;
+    config?: CallSiteConfig;
     linkedEntity?: string;
     name?: string;
     events?: Record<string, string>;
@@ -5448,7 +5530,7 @@ declare function getTraitName(traitRef: TraitRef): string;
  * getTraitConfig({ name: 'MyTrait' }); // returns undefined
  * getTraitConfig({ ref: 'MyTrait', config: { option: 'value' } }); // returns config object
  */
-declare function getTraitConfig(traitRef: TraitRef): TraitConfig | undefined;
+declare function getTraitConfig(traitRef: TraitRef): CallSiteConfig | undefined;
 /**
  * Normalizes a trait reference to object form.
  *
@@ -5465,7 +5547,7 @@ declare function getTraitConfig(traitRef: TraitRef): TraitConfig | undefined;
  */
 declare function normalizeTraitRef(traitRef: TraitRef): {
     ref: string;
-    config?: TraitConfig;
+    config?: CallSiteConfig;
 };
 type TraitInput = z.input<typeof TraitSchema>;
 type TraitReferenceInput = z.input<typeof TraitReferenceSchema>;
@@ -6326,4 +6408,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { type DoEffect as $, ASSET_ASPECTS as A, AssetCatalogSchema as B, type ConfigFieldDeclaration as C, type AssetDimension as D, type Effect as E, AssetDimensionSchema as F, type AssetMap as G, type AssetMapInput as H, AssetMapSchema as I, type AssetMapping as J, type AssetMappingInput as K, AssetMappingSchema as L, type AssetUrl as M, type AtomicEffect as N, type CallServiceConfig as O, type CallServiceEffect as P, type CheckpointLoadEffect as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type CheckpointSaveEffect as V, ConfigFieldDeclarationSchema as W, type DeclaredTraitConfig as X, DeclaredTraitConfigSchema as Y, type DerefEffect as Z, type DespawnEffect as _, type Trait as a, type RefEffect as a$, ENTITY_ROLES as a0, type EffectInput as a1, EffectSchema as a2, type EmitConfig as a3, type EmitEffect as a4, type EntityData as a5, type EntityFieldContract as a6, EntityFieldContractSchema as a7, type EntityFieldInput as a8, EntityFieldSchema as a9, GAME_TYPES as aA, type GameType as aB, GameTypeSchema as aC, type Guard as aD, type GuardInput as aE, GuardSchema as aF, type ListenSource as aG, ListenSourceSchema as aH, type LogEffect as aI, type McpServiceDef as aJ, McpServiceDefSchema as aK, type NavigateEffect as aL, type NnConfig as aM, type NnLayer as aN, type NotifyEffect as aO, type OrbitalEntity as aP, type OrbitalEntityInput as aQ, OrbitalEntitySchema as aR, type OrbitalTraitRef as aS, OrbitalTraitRefSchema as aT, type OsEffect as aU, type PayloadField as aV, PayloadFieldSchema as aW, type PersistData as aX, type PersistEffect as aY, type PersistEmitConfig as aZ, type PresentationType as a_, EntityPersistenceSchema as aa, type EntityRole as ab, EntityRoleSchema as ac, EntitySchema as ad, type EntityWith as ae, type EnumEntityField as af, type EvaluateConfig as ag, type EvaluateEffect as ah, type Event as ai, type EventInput as aj, EventPayloadFieldSchema as ak, EventSchema as al, type EventScope as am, EventScopeSchema as an, type FetchEffect as ao, type FetchOptions as ap, type FetchResult as aq, type Field as ar, type FieldFormat as as, FieldFormatSchema as at, FieldSchema as au, type FieldType as av, FieldTypeSchema as aw, type FieldValue as ax, type ForwardConfig as ay, type ForwardEffect as az, type RenderUIEffect as b, type Transition as b$, type RelationConfig as b0, RelationConfigSchema as b1, type RelationEntityField as b2, type RenderItemLambda as b3, type RenderUIConfig as b4, type RenderUINode as b5, type RequiredField as b6, RequiredFieldSchema as b7, type ResolvedAsset as b8, type ResolvedAssetInput as b9, type StateInput as bA, type StateMachine as bB, type StateMachineInput as bC, StateMachineSchema as bD, StateSchema as bE, type SwapEffect as bF, type TrainConfig as bG, type TrainEffect as bH, type TraitCategory as bI, TraitCategorySchema as bJ, TraitConfigSchema as bK, type TraitConfigValue as bL, TraitConfigValueSchema as bM, type TraitDataEntity as bN, TraitDataEntitySchema as bO, type TraitEntityField as bP, TraitEntityFieldSchema as bQ, TraitEventContractSchema as bR, TraitEventListenerSchema as bS, type TraitInput as bT, TraitRefSchema as bU, type TraitReferenceInput as bV, TraitReferenceSchema as bW, TraitSchema as bX, type TraitTick as bY, TraitTickSchema as bZ, type TraitUIBinding as b_, ResolvedAssetSchema as ba, type ResolvedPatternProps as bb, type RestAuthConfig as bc, RestAuthConfigSchema as bd, type RestServiceDef as be, RestServiceDefSchema as bf, SERVICE_TYPES as bg, type ScalarEntityField as bh, type SemanticAssetRef as bi, type SemanticAssetRefInput as bj, SemanticAssetRefSchema as bk, ServiceDefinitionSchema as bl, type ServiceParams as bm, type ServiceParamsValue as bn, type ServiceRefObject as bo, ServiceRefObjectSchema as bp, ServiceRefSchema as bq, ServiceRefStringSchema as br, type ServiceType as bs, ServiceTypeSchema as bt, type SetEffect as bu, type SocketEvents as bv, SocketEventsSchema as bw, type SocketServiceDef as bx, SocketServiceDefSchema as by, type SpawnEffect as bz, type TraitEventContract as c, type TransitionInput as c0, TransitionSchema as c1, type TypedEffect as c2, UISlotSchema as c3, UI_SLOTS as c4, VISUAL_STYLES as c5, type VisualStyle as c6, VisualStyleSchema as c7, type WatchEffect as c8, type WatchOptions as c9, normalizeTraitRef as cA, notify as cB, parseAssetKey as cC, parseServiceRef as cD, persist as cE, ref as cF, renderUI as cG, set as cH, spawn as cI, swap as cJ, validateAssetAnimations as cK, watch as cL, type TraitScope as cM, atomic as ca, callService as cb, createAssetKey as cc, deref as cd, deriveCollection as ce, despawn as cf, doEffects as cg, emit as ch, findService as ci, getDefaultAnimationsForRole as cj, getServiceNames as ck, getTraitConfig as cl, getTraitName as cm, hasService as cn, isCircuitEvent as co, isEffect as cp, isInlineTrait as cq, isMcpService as cr, isRestService as cs, isRuntimeEntity as ct, isSExprEffect as cu, isServiceReference as cv, isServiceReferenceObject as cw, isSingletonEntity as cx, isSocketService as cy, navigate as cz, type Entity as d, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type TraitConfigObject as k, type EventPayloadField as l, type ServiceDefinition as m, type State as n, ASSET_DIMENSIONS as o, type AgentEffect as p, type AnimationDef as q, type AnimationDefInput as r, AnimationDefSchema as s, type ArrayEntityField as t, type AssetAspect as u, AssetAspectSchema as v, type AssetCatalog as w, type AssetCatalogEntry as x, type AssetCatalogEntryInput as y, AssetCatalogEntrySchema as z };
+export { type DeclaredTraitConfig as $, ASSET_ASPECTS as A, type AssetCatalogEntryInput as B, type CallSiteConfig as C, AssetCatalogEntrySchema as D, type Effect as E, AssetCatalogSchema as F, type AssetDimension as G, AssetDimensionSchema as H, type AssetMap as I, type AssetMapInput as J, AssetMapSchema as K, type AssetMapping as L, type AssetMappingInput as M, AssetMappingSchema as N, AssetSchema as O, type AssetUrl as P, type AtomicEffect as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type CallServiceConfig as V, type CallServiceEffect as W, type CallSiteConfigEntry as X, type CheckpointLoadEffect as Y, type CheckpointSaveEffect as Z, ConfigFieldDeclarationSchema as _, type Trait as a, type PersistData as a$, DeclaredTraitConfigSchema as a0, type DerefEffect as a1, type DespawnEffect as a2, type DoEffect as a3, ENTITY_ROLES as a4, type EffectInput as a5, EffectSchema as a6, type EmitConfig as a7, type EmitEffect as a8, type EntityData as a9, FieldTypeSchema as aA, type FieldValue as aB, type ForwardConfig as aC, type ForwardEffect as aD, GAME_TYPES as aE, type GameType as aF, GameTypeSchema as aG, type Guard as aH, type GuardInput as aI, GuardSchema as aJ, type ListenSource as aK, ListenSourceSchema as aL, type LogEffect as aM, type McpServiceDef as aN, McpServiceDefSchema as aO, type NavigateEffect as aP, type NnConfig as aQ, type NnLayer as aR, type NotifyEffect as aS, type OrbitalEntity as aT, type OrbitalEntityInput as aU, OrbitalEntitySchema as aV, type OrbitalTraitRef as aW, OrbitalTraitRefSchema as aX, type OsEffect as aY, type PayloadField as aZ, PayloadFieldSchema as a_, type EntityFieldContract as aa, EntityFieldContractSchema as ab, type EntityFieldInput as ac, EntityFieldSchema as ad, EntityPersistenceSchema as ae, type EntityRole as af, EntityRoleSchema as ag, EntitySchema as ah, type EntityWith as ai, type EnumEntityField as aj, type EvaluateConfig as ak, type EvaluateEffect as al, type Event as am, type EventInput as an, EventPayloadFieldSchema as ao, EventSchema as ap, type EventScope as aq, EventScopeSchema as ar, type FetchEffect as as, type FetchOptions as at, type FetchResult as au, type Field as av, type FieldFormat as aw, FieldFormatSchema as ax, FieldSchema as ay, type FieldType as az, type RenderUIEffect as b, TraitSchema as b$, type PersistEffect as b0, type PersistEmitConfig as b1, type PresentationType as b2, type RefEffect as b3, type RelationConfig as b4, RelationConfigSchema as b5, type RelationEntityField as b6, type RenderItemLambda as b7, type RenderUIConfig as b8, type RenderUINode as b9, SocketEventsSchema as bA, type SocketServiceDef as bB, SocketServiceDefSchema as bC, type SpawnEffect as bD, type StateInput as bE, type StateMachine as bF, type StateMachineInput as bG, StateMachineSchema as bH, StateSchema as bI, type SwapEffect as bJ, type TrainConfig as bK, type TrainEffect as bL, type TraitCategory as bM, TraitCategorySchema as bN, TraitConfigSchema as bO, type TraitConfigValue as bP, TraitConfigValueSchema as bQ, type TraitDataEntity as bR, TraitDataEntitySchema as bS, type TraitEntityField as bT, TraitEntityFieldSchema as bU, TraitEventContractSchema as bV, TraitEventListenerSchema as bW, type TraitInput as bX, TraitRefSchema as bY, type TraitReferenceInput as bZ, TraitReferenceSchema as b_, type RequiredField as ba, RequiredFieldSchema as bb, type ResolvedAsset as bc, type ResolvedAssetInput as bd, ResolvedAssetSchema as be, type ResolvedPatternProps as bf, type RestAuthConfig as bg, RestAuthConfigSchema as bh, type RestServiceDef as bi, RestServiceDefSchema as bj, SERVICE_TYPES as bk, type ScalarEntityField as bl, type SemanticAssetRef as bm, type SemanticAssetRefInput as bn, SemanticAssetRefSchema as bo, ServiceDefinitionSchema as bp, type ServiceParams as bq, type ServiceParamsValue as br, type ServiceRefObject as bs, ServiceRefObjectSchema as bt, ServiceRefSchema as bu, ServiceRefStringSchema as bv, type ServiceType as bw, ServiceTypeSchema as bx, type SetEffect as by, type SocketEvents as bz, type TraitEventContract as c, type TraitTick as c0, TraitTickSchema as c1, type TraitUIBinding as c2, type Transition as c3, type TransitionInput as c4, TransitionSchema as c5, type TypedEffect as c6, UISlotSchema as c7, UI_SLOTS as c8, VISUAL_STYLES as c9, isServiceReference as cA, isServiceReferenceObject as cB, isSingletonEntity as cC, isSocketService as cD, navigate as cE, normalizeTraitRef as cF, notify as cG, parseAssetKey as cH, parseServiceRef as cI, persist as cJ, ref as cK, renderUI as cL, set as cM, spawn as cN, swap as cO, validateAssetAnimations as cP, watch as cQ, type TraitScope as cR, type VisualStyle as ca, VisualStyleSchema as cb, type WatchEffect as cc, type WatchOptions as cd, atomic as ce, callService as cf, createAssetKey as cg, deref as ch, deriveCollection as ci, despawn as cj, doEffects as ck, emit as cl, findService as cm, getDefaultAnimationsForRole as cn, getServiceNames as co, getTraitConfig as cp, getTraitName as cq, hasService as cr, isCallSiteConfigDeclaration as cs, isCircuitEvent as ct, isEffect as cu, isInlineTrait as cv, isMcpService as cw, isRestService as cx, isRuntimeEntity as cy, isSExprEffect as cz, type Entity as d, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type TraitConfigObject as k, type EventPayloadField as l, type ConfigFieldDeclaration as m, type ServiceDefinition as n, type State as o, ASSET_DIMENSIONS as p, type AgentEffect as q, type AnimationDef as r, type AnimationDefInput as s, AnimationDefSchema as t, type ArrayEntityField as u, type Asset as v, type AssetAspect as w, AssetAspectSchema as x, type AssetCatalog as y, type AssetCatalogEntry as z };