@almadar/core 10.15.0 → 10.16.0

package/dist/{trait-Ctj2l6ma.d.ts → trait-BnNByIRE.d.ts}

@@ -1888,11 +1888,9 @@ declare function validateAssetAnimations(assetRef: SemanticAssetRef, requiredAni
  *
  * - persistent: Stored in database (has collection)
  * - runtime: Exists only at runtime (not persisted)
- * - singleton: Single global instance
- * - instance: Static data (read-only instances)
  */
-type EntityPersistence = 'persistent' | 'runtime' | 'singleton' | 'instance' | 'local';
-declare const EntityPersistenceSchema: z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>;
+type EntityPersistence = 'persistent' | 'runtime';
+declare const EntityPersistenceSchema: z.ZodEnum<["persistent", "runtime"]>;
 /**
  * OrbitalEntity - the nucleus of an Orbital Unit.
  *
@@ -1904,6 +1902,8 @@ interface OrbitalEntity {
     name: string;
     /** Entity persistence type (defaults to 'persistent' if not specified) */
     persistence?: EntityPersistence;
+    /** Whether this entity's state is shared across all bound traits (vs per-trait copy). Orthogonal to persistence. */
+    shared?: boolean;
     /** Collection name (auto-derived if not provided for persistent entities) */
     collection?: string;
     /** Entity fields */
@@ -1923,7 +1923,8 @@ interface OrbitalEntity {
 }
 declare const OrbitalEntitySchema: z.ZodObject<{
     name: z.ZodString;
-    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
+    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
+    shared: z.ZodOptional<z.ZodBoolean>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, unknown>, "many">;
     instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -1958,9 +1959,10 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+    persistence: "persistent" | "runtime";
     fields: EntityField[];
     description?: string | undefined;
+    shared?: boolean | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -1979,7 +1981,8 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     name: string;
     fields: unknown[];
     description?: string | undefined;
-    persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+    persistence?: "persistent" | "runtime" | undefined;
+    shared?: boolean | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -2001,7 +2004,8 @@ type Entity = OrbitalEntity;
 /** Alias for OrbitalEntitySchema - preferred name */
 declare const EntitySchema: z.ZodObject<{
     name: z.ZodString;
-    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
+    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
+    shared: z.ZodOptional<z.ZodBoolean>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, unknown>, "many">;
     instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -2036,9 +2040,10 @@ declare const EntitySchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+    persistence: "persistent" | "runtime";
     fields: EntityField[];
     description?: string | undefined;
+    shared?: boolean | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -2057,7 +2062,8 @@ declare const EntitySchema: z.ZodObject<{
     name: string;
     fields: unknown[];
     description?: string | undefined;
-    persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+    persistence?: "persistent" | "runtime" | undefined;
+    shared?: boolean | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -2078,7 +2084,7 @@ declare const EntitySchema: z.ZodObject<{
  *
  * Generates the database collection name by converting the entity name
  * to lowercase and adding an 's' suffix (simple pluralization).
- * Returns undefined for non-persistent entities (runtime/singleton).
+ * Returns undefined for non-persistent (runtime) entities.
  *
  * @param {OrbitalEntity} entity - Entity to derive collection name for
  * @returns {string | undefined} Collection name or undefined for non-persistent entities
@@ -2102,27 +2108,13 @@ declare function deriveCollection(entity: OrbitalEntity): string | undefined;
  * isRuntimeEntity({ persistence: 'persistent' }); // returns false
  */
 declare function isRuntimeEntity(entity: OrbitalEntity): boolean;
-/**
- * Checks if an entity is a singleton.
- *
- * Type guard to determine if an entity has a single global instance
- * rather than multiple records in a collection.
- *
- * @param {OrbitalEntity} entity - Entity to check
- * @returns {boolean} True if entity is a singleton, false otherwise
- *
- * @example
- * isSingletonEntity({ persistence: 'singleton' }); // returns true
- * isSingletonEntity({ persistence: 'persistent' }); // returns false
- */
-declare function isSingletonEntity(entity: OrbitalEntity): boolean;
 /**
  * Checks whether an entity's persistence mode allows `persistence` /
  * `collection` overrides at the factory call site.
  *
  * Only `persistent` entities (explicit or default) support these overrides.
- * Runtime, singleton, instance, and local entities are fixed; callers must
- * not expose `persistence` or `collection` params for them.
+ * Runtime entities are fixed; callers must not expose `persistence` or
+ * `collection` params for them.
  *
  * @param persistence - The entity persistence mode (undefined = default persistent)
  * @returns True when overrides are allowed, false otherwise
@@ -3476,10 +3468,10 @@ declare const TraitDataEntitySchema: z.ZodObject<{
     }[];
     description?: string | undefined;
     runtime?: boolean | undefined;
-    singleton?: boolean | undefined;
     collection?: string | undefined;
     timestamps?: boolean | undefined;
     pages?: string[] | undefined;
+    singleton?: boolean | undefined;
 }, {
     name: string;
     fields: {
@@ -3491,10 +3483,10 @@ declare const TraitDataEntitySchema: z.ZodObject<{
     }[];
     description?: string | undefined;
     runtime?: boolean | undefined;
-    singleton?: boolean | undefined;
     collection?: string | undefined;
     timestamps?: boolean | undefined;
     pages?: string[] | undefined;
+    singleton?: boolean | undefined;
 }>;
 /**
  * Tick rule for traits.
@@ -4284,10 +4276,10 @@ declare const TraitSchema: z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }, {
         name: string;
         fields: {
@@ -4299,10 +4291,10 @@ declare const TraitSchema: z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
         states: z.ZodArray<z.ZodObject<{
@@ -4682,7 +4674,8 @@ declare const TraitSchema: z.ZodObject<{
     }>>;
     sourceEntityDefinition: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
+        shared: z.ZodOptional<z.ZodBoolean>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, unknown>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -4717,9 +4710,10 @@ declare const TraitSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -4738,7 +4732,8 @@ declare const TraitSchema: z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -4756,7 +4751,7 @@ declare const TraitSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -4821,10 +4816,10 @@ declare const TraitSchema: z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -4883,9 +4878,10 @@ declare const TraitSchema: z.ZodObject<{
     } | undefined;
     sourceEntityDefinition?: {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -4903,7 +4899,7 @@ declare const TraitSchema: z.ZodObject<{
     } | undefined;
 }, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -4968,10 +4964,10 @@ declare const TraitSchema: z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -5032,7 +5028,8 @@ declare const TraitSchema: z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -5139,10 +5136,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }, {
         name: string;
         fields: {
@@ -5154,10 +5151,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
         states: z.ZodArray<z.ZodObject<{
@@ -5537,7 +5534,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }>>;
     sourceEntityDefinition: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
+        shared: z.ZodOptional<z.ZodBoolean>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, unknown>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -5572,9 +5570,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -5593,7 +5592,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -5611,7 +5611,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -5676,10 +5676,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -5738,9 +5738,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     sourceEntityDefinition?: {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -5758,7 +5759,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -5823,10 +5824,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -5887,7 +5888,8 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6064,10 +6066,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }, {
         name: string;
         fields: {
@@ -6079,10 +6081,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }>, "many">>;
     stateMachine: z.ZodOptional<z.ZodObject<{
         states: z.ZodArray<z.ZodObject<{
@@ -6462,7 +6464,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }>>;
     sourceEntityDefinition: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
+        shared: z.ZodOptional<z.ZodBoolean>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, unknown>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -6497,9 +6500,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6518,7 +6522,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6536,7 +6541,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -6601,10 +6606,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -6663,9 +6668,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     sourceEntityDefinition?: {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
+        persistence: "persistent" | "runtime";
         fields: EntityField[];
         description?: string | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6683,7 +6689,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }, {
     name: string;
-    scope: "instance" | "collection";
+    scope: "collection" | "instance";
     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;
@@ -6748,10 +6754,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }[];
         description?: string | undefined;
         runtime?: boolean | undefined;
-        singleton?: boolean | undefined;
         collection?: string | undefined;
         timestamps?: boolean | undefined;
         pages?: string[] | undefined;
+        singleton?: boolean | undefined;
     }[] | undefined;
     stateMachine?: {
         events: {
@@ -6812,7 +6818,8 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: string;
         fields: unknown[];
         description?: string | undefined;
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
+        persistence?: "persistent" | "runtime" | undefined;
+        shared?: boolean | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6830,4 +6837,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { type CallSiteConfigEntry as $, ANIMATION_NAMES as A, type AssetAspect as B, type CallSiteConfig as C, AssetAspectSchema as D, type Effect as E, type AssetCatalog as F, type AssetCatalogEntry as G, type AssetCatalogEntryInput as H, AssetCatalogEntrySchema as I, AssetCatalogSchema as J, type AssetDimension as K, AssetDimensionSchema as L, type AssetMap as M, type AssetMapInput as N, AssetMapSchema as O, type AssetMapping as P, type AssetMappingInput as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, AssetMappingSchema as V, AssetSchema as W, type AssetUrl as X, type AtomicEffect as Y, type CallServiceConfig as Z, type CallServiceEffect as _, type Trait as a, type OrbitalEntity as a$, type CharacterKit as a0, type CharacterKitLayer as a1, CharacterKitLayerSchema as a2, CharacterKitSchema as a3, type CheckpointLoadEffect as a4, type CheckpointSaveEffect as a5, ConfigFieldDeclarationSchema as a6, type DeclaredTraitConfig as a7, DeclaredTraitConfigSchema as a8, type DerefEffect as a9, type FetchEffect as aA, type FetchOptions as aB, type FetchResult as aC, type Field as aD, type FieldFormat as aE, FieldFormatSchema as aF, FieldSchema as aG, type FieldType as aH, FieldTypeSchema as aI, type FieldValue as aJ, type ForwardConfig as aK, type ForwardEffect as aL, GAME_TYPES as aM, type GameType as aN, GameTypeSchema as aO, type Guard as aP, type GuardInput as aQ, GuardSchema as aR, type ListenSource as aS, ListenSourceSchema as aT, type LogEffect as aU, type McpServiceDef as aV, McpServiceDefSchema as aW, type NavigateEffect as aX, type NnConfig as aY, type NnLayer as aZ, type NotifyEffect as a_, type DespawnEffect as aa, type DoEffect as ab, ENTITY_ROLES as ac, type EffectInput as ad, EffectSchema as ae, type EmitConfig as af, type EmitEffect as ag, type EntityData as ah, type EntityFieldContract as ai, EntityFieldContractSchema as aj, type EntityFieldInput as ak, EntityFieldSchema as al, EntityPersistenceSchema as am, type EntityRole as an, EntityRoleSchema as ao, EntitySchema as ap, type EntityWith as aq, type EnumEntityField as ar, type EvaluateConfig as as, type EvaluateEffect as at, type Event as au, type EventInput as av, EventPayloadFieldSchema as aw, EventSchema as ax, type EventScope as ay, EventScopeSchema as az, type RenderUIEffect as b, type SwapEffect as b$, type OrbitalEntityInput as b0, OrbitalEntitySchema as b1, type OrbitalTraitRef as b2, OrbitalTraitRefSchema as b3, type OsEffect as b4, PACK_CLASSES as b5, type PackClass as b6, PackClassSchema as b7, type PayloadField as b8, PayloadFieldSchema as b9, ServiceDefinitionSchema as bA, type ServiceParams as bB, type ServiceParamsValue as bC, type ServiceRefObject as bD, ServiceRefObjectSchema as bE, ServiceRefSchema as bF, ServiceRefStringSchema as bG, type ServiceType as bH, ServiceTypeSchema as bI, type SetEffect as bJ, type SocketEvents as bK, SocketEventsSchema as bL, type SocketServiceDef as bM, SocketServiceDefSchema as bN, type SpawnEffect as bO, type SpriteDirection as bP, SpriteDirectionSchema as bQ, type SpriteSheetAtlas as bR, type SpriteSheetAtlasInput as bS, SpriteSheetAtlasSchema as bT, type StateInput as bU, type StateMachine as bV, type StateMachineInput as bW, StateMachineSchema as bX, StateSchema as bY, type SubTexture as bZ, SubTextureSchema as b_, type PersistData as ba, type PersistEffect as bb, type PersistEmitConfig as bc, type PresentationType as bd, type RefEffect as be, RelationConfigSchema as bf, type RelationEntityField as bg, type RenderItemLambda as bh, type RenderUIConfig as bi, type RenderUINode as bj, type RequiredField as bk, RequiredFieldSchema as bl, type ResolvedAsset as bm, type ResolvedAssetInput as bn, ResolvedAssetSchema as bo, type ResolvedPatternProps as bp, type RestAuthConfig as bq, RestAuthConfigSchema as br, type RestServiceDef as bs, RestServiceDefSchema as bt, SERVICE_TYPES as bu, SPRITE_DIRECTIONS as bv, type ScalarEntityField as bw, type SemanticAssetRef as bx, type SemanticAssetRefInput as by, SemanticAssetRefSchema as bz, type TraitEventContract as c, normalizeTraitRef as c$, type TextureAtlas as c0, TextureAtlasSchema as c1, type Tilesheet as c2, TilesheetSchema as c3, type TrainConfig as c4, type TrainEffect as c5, type TraitCategory as c6, TraitCategorySchema as c7, TraitConfigSchema as c8, type TraitConfigValue as c9, 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, isCallSiteConfigDeclaration as cO, isCircuitEvent as cP, isEffect as cQ, isInlineTrait as cR, isMcpService as cS, isRestService as cT, isRuntimeEntity as cU, isSExprEffect as cV, isServiceReference as cW, isServiceReferenceObject as cX, isSingletonEntity as cY, isSocketService as cZ, navigate as c_, TraitConfigValueSchema as ca, type TraitDataEntity as cb, TraitDataEntitySchema as cc, type TraitEntityField as cd, TraitEntityFieldSchema as ce, TraitEventContractSchema as cf, TraitEventListenerSchema as cg, type TraitInput as ch, TraitRefSchema as ci, type TraitReferenceInput as cj, TraitReferenceSchema as ck, TraitSchema as cl, type TraitTick as cm, TraitTickSchema as cn, type TraitUIBinding as co, type Transition as cp, type TransitionInput as cq, TransitionSchema as cr, type TypedEffect as cs, UISlotSchema as ct, UI_SLOTS as cu, VISUAL_STYLES as cv, type VisualStyle as cw, VisualStyleSchema as cx, type WatchEffect as cy, type WatchOptions as cz, type Entity as d, notify as d0, parseAssetKey as d1, parseServiceRef as d2, persist as d3, persistenceModeAllowsOverrides as d4, ref as d5, renderUI as d6, set as d7, spawn as d8, swap as d9, validateAssetAnimations as da, watch as db, type TraitScope as dc, 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 RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type State as p, ASSET_ASPECTS as q, ASSET_DIMENSIONS as r, type AgentEffect as s, type AnimationDef as t, type AnimationDefInput as u, AnimationDefSchema as v, type AnimationName as w, AnimationNameSchema as x, type ArrayEntityField as y, type Asset as z };
+export { type CallServiceConfig as $, ANIMATION_NAMES as A, type Asset as B, type CallSiteConfig as C, type AssetAspect as D, type Effect as E, type FieldValue as F, AssetAspectSchema as G, type AssetCatalog as H, type AssetCatalogEntry as I, type AssetCatalogEntryInput as J, AssetCatalogEntrySchema as K, AssetCatalogSchema as L, type AssetDimension as M, AssetDimensionSchema as N, type AssetMap as O, type AssetMapInput as P, AssetMapSchema as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type AssetMapping as V, type AssetMappingInput as W, AssetMappingSchema as X, AssetSchema as Y, type AssetUrl as Z, type AtomicEffect as _, type Trait as a, type OrbitalEntity as a$, type CallServiceEffect as a0, type CharacterKit as a1, type CharacterKitLayer as a2, CharacterKitLayerSchema as a3, CharacterKitSchema as a4, type CheckpointLoadEffect as a5, type CheckpointSaveEffect as a6, ConfigFieldDeclarationSchema as a7, type DeclaredTraitConfig as a8, DeclaredTraitConfigSchema as a9, EventScopeSchema as aA, type FetchEffect as aB, type FetchOptions as aC, type FetchResult as aD, type Field as aE, type FieldFormat as aF, FieldFormatSchema as aG, FieldSchema as aH, type FieldType as aI, FieldTypeSchema as aJ, type ForwardConfig as aK, type ForwardEffect as aL, GAME_TYPES as aM, type GameType as aN, GameTypeSchema as aO, type Guard as aP, type GuardInput as aQ, GuardSchema as aR, type ListenSource as aS, ListenSourceSchema as aT, type LogEffect as aU, type McpServiceDef as aV, McpServiceDefSchema as aW, type NavigateEffect as aX, type NnConfig as aY, type NnLayer as aZ, type NotifyEffect as a_, type DerefEffect as aa, type DespawnEffect as ab, type DoEffect as ac, ENTITY_ROLES as ad, type EffectInput as ae, EffectSchema as af, type EmitConfig as ag, type EmitEffect as ah, type EntityData as ai, type EntityFieldContract as aj, EntityFieldContractSchema as ak, type EntityFieldInput as al, EntityFieldSchema as am, EntityPersistenceSchema as an, type EntityRole as ao, EntityRoleSchema as ap, EntitySchema as aq, type EntityWith as ar, type EnumEntityField as as, type EvaluateConfig as at, type EvaluateEffect as au, type Event as av, type EventInput as aw, EventPayloadFieldSchema as ax, EventSchema as ay, type EventScope as az, type RenderUIEffect as b, type SwapEffect as b$, type OrbitalEntityInput as b0, OrbitalEntitySchema as b1, type OrbitalTraitRef as b2, OrbitalTraitRefSchema as b3, type OsEffect as b4, PACK_CLASSES as b5, type PackClass as b6, PackClassSchema as b7, type PayloadField as b8, PayloadFieldSchema as b9, ServiceDefinitionSchema as bA, type ServiceParams as bB, type ServiceParamsValue as bC, type ServiceRefObject as bD, ServiceRefObjectSchema as bE, ServiceRefSchema as bF, ServiceRefStringSchema as bG, type ServiceType as bH, ServiceTypeSchema as bI, type SetEffect as bJ, type SocketEvents as bK, SocketEventsSchema as bL, type SocketServiceDef as bM, SocketServiceDefSchema as bN, type SpawnEffect as bO, type SpriteDirection as bP, SpriteDirectionSchema as bQ, type SpriteSheetAtlas as bR, type SpriteSheetAtlasInput as bS, SpriteSheetAtlasSchema as bT, type StateInput as bU, type StateMachine as bV, type StateMachineInput as bW, StateMachineSchema as bX, StateSchema as bY, type SubTexture as bZ, SubTextureSchema as b_, type PersistData as ba, type PersistEffect as bb, type PersistEmitConfig as bc, type PresentationType as bd, type RefEffect as be, RelationConfigSchema as bf, type RelationEntityField as bg, type RenderItemLambda as bh, type RenderUIConfig as bi, type RenderUINode as bj, type RequiredField as bk, RequiredFieldSchema as bl, type ResolvedAsset as bm, type ResolvedAssetInput as bn, ResolvedAssetSchema as bo, type ResolvedPatternProps as bp, type RestAuthConfig as bq, RestAuthConfigSchema as br, type RestServiceDef as bs, RestServiceDefSchema as bt, SERVICE_TYPES as bu, SPRITE_DIRECTIONS as bv, type ScalarEntityField as bw, type SemanticAssetRef as bx, type SemanticAssetRefInput as by, SemanticAssetRefSchema as bz, type TraitEventContract as c, notify as c$, type TextureAtlas as c0, TextureAtlasSchema as c1, type Tilesheet as c2, TilesheetSchema as c3, type TrainConfig as c4, type TrainEffect as c5, type TraitCategory as c6, TraitCategorySchema as c7, TraitConfigSchema as c8, type TraitConfigValue as c9, 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, isCallSiteConfigDeclaration as cO, isCircuitEvent as cP, isEffect as cQ, isInlineTrait as cR, isMcpService as cS, isRestService as cT, isRuntimeEntity as cU, isSExprEffect as cV, isServiceReference as cW, isServiceReferenceObject as cX, isSocketService as cY, navigate as cZ, normalizeTraitRef as c_, TraitConfigValueSchema as ca, type TraitDataEntity as cb, TraitDataEntitySchema as cc, type TraitEntityField as cd, TraitEntityFieldSchema as ce, TraitEventContractSchema as cf, TraitEventListenerSchema as cg, type TraitInput as ch, TraitRefSchema as ci, type TraitReferenceInput as cj, TraitReferenceSchema as ck, TraitSchema as cl, type TraitTick as cm, TraitTickSchema as cn, type TraitUIBinding as co, type Transition as cp, type TransitionInput as cq, TransitionSchema as cr, type TypedEffect as cs, UISlotSchema as ct, UI_SLOTS as cu, VISUAL_STYLES as cv, type VisualStyle as cw, VisualStyleSchema as cx, type WatchEffect as cy, type WatchOptions as cz, type Entity as d, parseAssetKey as d0, parseServiceRef as d1, persist as d2, persistenceModeAllowsOverrides as d3, ref as d4, renderUI as d5, set as d6, spawn as d7, swap as d8, validateAssetAnimations as d9, watch as da, type TraitScope as db, 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 RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type CallSiteConfigEntry as p, type State as q, ASSET_ASPECTS as r, ASSET_DIMENSIONS as s, type AgentEffect as t, type AnimationDef as u, type AnimationDefInput as v, AnimationDefSchema as w, type AnimationName as x, AnimationNameSchema as y, type ArrayEntityField as z };

package/dist/types/index.d.ts

@@ -1,14 +1,14 @@
-import { O as OrbitalSchema, a7 as Orbital, b as Page, L as DomainContext, a as OrbitalDefinition, b0 as PageTraitRef } from '../schema-BVcq7eXk.js';
-export { A as AGENT_DOMAIN_CATEGORIES, d as ALLOWED_CUSTOM_COMPONENTS, e as AgentDomainCategory, f as AgentDomainCategorySchema, g as AllowedCustomComponent, C as ColorSlice, h as ColorSliceSchema, i as ColorTokens, j as ColorTokensSchema, k as ComputedEventContract, l as ComputedEventContractSchema, m as ComputedEventListener, n as ComputedEventListenerSchema, o as ConfigProvenanceRecord, p as ConfigProvenanceRecordSchema, q as CustomPatternDefinition, r as CustomPatternDefinitionInput, s as CustomPatternDefinitionSchema, t as CustomPatternMap, u as CustomPatternMapInput, v as CustomPatternMapSchema, D as DensitySlice, w as DensitySliceSchema, x as DensityTokens, y as DensityTokensSchema, z as DesignPreferences, B as DesignPreferencesInput, F as DesignPreferencesSchema, G as DesignTokens, H as DesignTokensInput, I as DesignTokensSchema, J as DomainCategory, K as DomainCategorySchema, M as DomainContextInput, N as DomainContextSchema, Q as DomainVocabulary, R as DomainVocabularySchema, S as ElevationSlice, T as ElevationSliceSchema, V as ElevationTokens, W as ElevationTokensSchema, X as EntityCall, Y as EntityCallSchema, E as EntityRef, Z as EntityRefSchema, _ as EntityRefStringSchema, $ as EntitySemanticRole, a0 as EntitySemanticRoleSchema, a1 as EventListener, a2 as EventListenerSchema, a3 as EventSemanticRole, a4 as EventSemanticRoleSchema, a5 as EventSource, a6 as EventSourceSchema, a8 as GameSubCategory, a9 as GameSubCategorySchema, aa as GeometrySlice, ab as GeometrySliceSchema, ac as GeometryTokens, ad as GeometryTokensSchema, ae as IconFamily, af as IconFamilySchema, ag as IconographySlice, ah as IconographySliceSchema, ai as IconographyTokens, aj as IconographyTokensSchema, ak as IllustrationSlice, al as IllustrationSliceSchema, am as IllustrationStyle, an as IllustrationStyleSchema, ao as IllustrationTokens, ap as IllustrationTokensSchema, aq as MotionDurationKey, ar as MotionDurationKeySchema, as as MotionDurationPalette, at as MotionDurationPaletteSchema, au as MotionEasingKey, av as MotionEasingKeySchema, aw as MotionEasingPalette, ax as MotionEasingPaletteSchema, ay as MotionIntent, az as MotionIntentMap, aA as MotionIntentMapSchema, aB as MotionIntentSchema, aC as MotionSlice, aD as MotionSliceSchema, aE as MotionTokens, aF as MotionTokensSchema, aG as NodeClassification, aH as NodeClassificationSchema, aI as OrbitalConfig, aJ as OrbitalConfigInput, aK as OrbitalConfigSchema, aL as OrbitalDefinitionSchema, aM as OrbitalInput, aN as OrbitalPage, aO as OrbitalPageInput, aP as OrbitalPageSchema, aQ as OrbitalPageStrictInput, aR as OrbitalPageStrictSchema, aS as OrbitalSchemaInput, aT as OrbitalSchemaSchema, aU as OrbitalSchemaWithTraits, aV as OrbitalUnit, aW as OrbitalUnitSchema, aX as OrbitalZodSchema, P as PageRef, c as PageRefObject, aY as PageRefObjectSchema, aZ as PageRefSchema, a_ as PageRefStringSchema, a$ as PageSchema, b1 as PageTraitRefSchema, b2 as RelatedLink, b3 as RelatedLinkSchema, b4 as SchemaMetadata, b5 as SchemaMetadataSchema, b6 as SkinSpec, b7 as SkinSpecSchema, b8 as SpacingScale, b9 as SpacingScaleSchema, ba as StateSemanticRole, bb as StateSemanticRoleSchema, bc as SuggestedGuard, bd as SuggestedGuardSchema, be as ThemeDefinition, bf as ThemeDefinitionSchema, bg as ThemeRef, bh as ThemeRefSchema, bi as ThemeRefStringSchema, bj as ThemeTokens, bk as ThemeTokensSchema, bl as ThemeVariant, bm as ThemeVariantSchema, bn as TypeIntent, bo as TypeIntentMap, bp as TypeIntentMapSchema, bq as TypeIntentSchema, br as TypeScale, bs as TypeScaleEntry, bt as TypeScaleEntrySchema, bu as TypeScaleSchema, bv as TypeScaleTokens, bw as TypeScaleTokensSchema, bx as TypeSizeKey, by as TypeSizeKeySchema, bz as TypeSlice, bA as TypeSliceSchema, bB as TypeSlot, bC as TypeSlotSchema, bD as TypeWeight, bE as TypeWeightSchema, bF as UXHints, bG as UXHintsSchema, U as UseDeclaration, bH as UseDeclarationSchema, bI as UserPersona, bJ as UserPersonaInput, bK as UserPersonaSchema, bL as ViewType, bM as ViewTypeSchema, bN as isEntityCall, bO as isEntityReference, bP as isEntityReferenceAny, bQ as isImportedTraitRef, bR as isOrbitalDefinition, bS as isPageReference, bT as isPageReferenceObject, bU as isPageReferenceString, bV as isThemeReference, bW as parseEntityRef, bX as parseImportedTraitRef, bY as parseOrbitalSchema, bZ as parsePageRef, b_ as safeParseOrbitalSchema } from '../schema-BVcq7eXk.js';
-import { bB as ServiceParams, a as Trait, d as Entity, h as EntityRow, aJ as FieldValue, a7 as DeclaredTraitConfig, T as TraitConfig, E as Effect, n as ConfigFieldDeclaration, p as State, cp as Transition, f as EntityField, au as Event, c9 as TraitConfigValue, g as EntityPersistence, c6 as TraitCategory, dc as TraitScope } from '../trait-Ctj2l6ma.js';
-export { A as ANIMATION_NAMES, q as ASSET_ASPECTS, r as ASSET_DIMENSIONS, s as AgentEffect, t as AnimationDef, u as AnimationDefInput, v as AnimationDefSchema, w as AnimationName, x as AnimationNameSchema, y as ArrayEntityField, z as Asset, B as AssetAspect, D as AssetAspectSchema, F as AssetCatalog, G as AssetCatalogEntry, H as AssetCatalogEntryInput, I as AssetCatalogEntrySchema, J as AssetCatalogSchema, K as AssetDimension, L as AssetDimensionSchema, M as AssetMap, N as AssetMapInput, O as AssetMapSchema, P as AssetMapping, Q as AssetMappingInput, V as AssetMappingSchema, W as AssetSchema, X as AssetUrl, Y as AtomicEffect, Z as CallServiceConfig, _ as CallServiceEffect, C as CallSiteConfig, $ as CallSiteConfigEntry, a0 as CharacterKit, a1 as CharacterKitLayer, a2 as CharacterKitLayerSchema, a3 as CharacterKitSchema, a4 as CheckpointLoadEffect, a5 as CheckpointSaveEffect, a6 as ConfigFieldDeclarationSchema, a8 as DeclaredTraitConfigSchema, a9 as DerefEffect, aa as DespawnEffect, ab as DoEffect, ac as ENTITY_ROLES, ad as EffectInput, ae as EffectSchema, af as EmitConfig, ag as EmitEffect, ah as EntityData, ai as EntityFieldContract, aj as EntityFieldContractSchema, ak as EntityFieldInput, al as EntityFieldSchema, am as EntityPersistenceSchema, an as EntityRole, ao as EntityRoleSchema, ap as EntitySchema, aq as EntityWith, ar as EnumEntityField, as as EvaluateConfig, at as EvaluateEffect, av as EventInput, m as EventPayloadField, aw as EventPayloadFieldSchema, ax as EventSchema, ay as EventScope, az as EventScopeSchema, aA as FetchEffect, aB as FetchOptions, aC as FetchResult, aD as Field, aE as FieldFormat, aF as FieldFormatSchema, aG as FieldSchema, aH as FieldType, aI as FieldTypeSchema, aK as ForwardConfig, aL as ForwardEffect, aM as GAME_TYPES, aN as GameType, aO as GameTypeSchema, aP as Guard, aQ as GuardInput, aR as GuardSchema, aS as ListenSource, aT as ListenSourceSchema, aU as LogEffect, aV as McpServiceDef, aW as McpServiceDefSchema, aX as NavigateEffect, aY as NnConfig, aZ as NnLayer, a_ as NotifyEffect, a$ as OrbitalEntity, b0 as OrbitalEntityInput, b1 as OrbitalEntitySchema, b2 as OrbitalTraitRef, b3 as OrbitalTraitRefSchema, b4 as OsEffect, b5 as PACK_CLASSES, b6 as PackClass, b7 as PackClassSchema, b8 as PayloadField, b9 as PayloadFieldSchema, ba as PersistData, bb as PersistEffect, bc as PersistEmitConfig, bd as PresentationType, be as RefEffect, k as RelationConfig, bf as RelationConfigSchema, bg as RelationEntityField, R as RenderBinding, bh as RenderItemLambda, bi as RenderUIConfig, b as RenderUIEffect, bj as RenderUINode, bk as RequiredField, bl as RequiredFieldSchema, bm as ResolvedAsset, bn as ResolvedAssetInput, bo as ResolvedAssetSchema, bp as ResolvedPatternProps, bq as RestAuthConfig, br as RestAuthConfigSchema, bs as RestServiceDef, bt as RestServiceDefSchema, bu as SERVICE_TYPES, bv as SPRITE_DIRECTIONS, bw as ScalarEntityField, bx as SemanticAssetRef, by as SemanticAssetRefInput, bz as SemanticAssetRefSchema, o as ServiceDefinition, bA as ServiceDefinitionSchema, bC as ServiceParamsValue, S as ServiceRef, bD as ServiceRefObject, bE as ServiceRefObjectSchema, bF as ServiceRefSchema, bG as ServiceRefStringSchema, bH as ServiceType, bI as ServiceTypeSchema, bJ as SetEffect, bK as SocketEvents, bL as SocketEventsSchema, bM as SocketServiceDef, bN as SocketServiceDefSchema, bO as SpawnEffect, bP as SpriteDirection, bQ as SpriteDirectionSchema, bR as SpriteSheetAtlas, bS as SpriteSheetAtlasInput, bT as SpriteSheetAtlasSchema, bU as StateInput, bV as StateMachine, bW as StateMachineInput, bX as StateMachineSchema, bY as StateSchema, bZ as SubTexture, b_ as SubTextureSchema, b$ as SwapEffect, c0 as TextureAtlas, c1 as TextureAtlasSchema, c2 as Tilesheet, c3 as TilesheetSchema, c4 as TrainConfig, c5 as TrainEffect, c7 as TraitCategorySchema, l as TraitConfigObject, c8 as TraitConfigSchema, ca as TraitConfigValueSchema, cb as TraitDataEntity, cc as TraitDataEntitySchema, cd as TraitEntityField, ce as TraitEntityFieldSchema, c as TraitEventContract, cf as TraitEventContractSchema, e as TraitEventListener, cg as TraitEventListenerSchema, ch as TraitInput, i as TraitRef, ci as TraitRefSchema, j as TraitReference, cj as TraitReferenceInput, ck as TraitReferenceSchema, cl as TraitSchema, cm as TraitTick, cn as TraitTickSchema, co as TraitUIBinding, cq as TransitionInput, cr as TransitionSchema, cs as TypedEffect, U as UISlot, ct as UISlotSchema, cu as UI_SLOTS, cv as VISUAL_STYLES, cw as VisualStyle, cx as VisualStyleSchema, cy as WatchEffect, cz as WatchOptions, cA as atomic, cB as callService, cC as createAssetKey, cD as deref, cE as deriveCollection, cF as despawn, cG as doEffects, cH as emit, cI as findService, cJ as getDefaultAnimationsForRole, cK as getServiceNames, cL as getTraitConfig, cM as getTraitName, cN as hasService, cO as isCallSiteConfigDeclaration, cP as isCircuitEvent, cQ as isEffect, cR as isInlineTrait, cS as isMcpService, cT as isRestService, cU as isRuntimeEntity, cV as isSExprEffect, cW as isServiceReference, cX as isServiceReferenceObject, cY as isSingletonEntity, cZ as isSocketService, c_ as navigate, c$ as normalizeTraitRef, d0 as notify, d1 as parseAssetKey, d2 as parseServiceRef, d3 as persist, d4 as persistenceModeAllowsOverrides, d5 as ref, d6 as renderUI, d7 as set, d8 as spawn, d9 as swap, da as validateAssetAnimations, db as watch } from '../trait-Ctj2l6ma.js';
+import { O as OrbitalSchema, a7 as Orbital, b as Page, L as DomainContext, a as OrbitalDefinition, b0 as PageTraitRef } from '../schema-BOGLyI7O.js';
+export { A as AGENT_DOMAIN_CATEGORIES, d as ALLOWED_CUSTOM_COMPONENTS, e as AgentDomainCategory, f as AgentDomainCategorySchema, g as AllowedCustomComponent, C as ColorSlice, h as ColorSliceSchema, i as ColorTokens, j as ColorTokensSchema, k as ComputedEventContract, l as ComputedEventContractSchema, m as ComputedEventListener, n as ComputedEventListenerSchema, o as ConfigProvenanceRecord, p as ConfigProvenanceRecordSchema, q as CustomPatternDefinition, r as CustomPatternDefinitionInput, s as CustomPatternDefinitionSchema, t as CustomPatternMap, u as CustomPatternMapInput, v as CustomPatternMapSchema, D as DensitySlice, w as DensitySliceSchema, x as DensityTokens, y as DensityTokensSchema, z as DesignPreferences, B as DesignPreferencesInput, F as DesignPreferencesSchema, G as DesignTokens, H as DesignTokensInput, I as DesignTokensSchema, J as DomainCategory, K as DomainCategorySchema, M as DomainContextInput, N as DomainContextSchema, Q as DomainVocabulary, R as DomainVocabularySchema, S as ElevationSlice, T as ElevationSliceSchema, V as ElevationTokens, W as ElevationTokensSchema, X as EntityCall, Y as EntityCallSchema, E as EntityRef, Z as EntityRefSchema, _ as EntityRefStringSchema, $ as EntitySemanticRole, a0 as EntitySemanticRoleSchema, a1 as EventListener, a2 as EventListenerSchema, a3 as EventSemanticRole, a4 as EventSemanticRoleSchema, a5 as EventSource, a6 as EventSourceSchema, a8 as GameSubCategory, a9 as GameSubCategorySchema, aa as GeometrySlice, ab as GeometrySliceSchema, ac as GeometryTokens, ad as GeometryTokensSchema, ae as IconFamily, af as IconFamilySchema, ag as IconographySlice, ah as IconographySliceSchema, ai as IconographyTokens, aj as IconographyTokensSchema, ak as IllustrationSlice, al as IllustrationSliceSchema, am as IllustrationStyle, an as IllustrationStyleSchema, ao as IllustrationTokens, ap as IllustrationTokensSchema, aq as MotionDurationKey, ar as MotionDurationKeySchema, as as MotionDurationPalette, at as MotionDurationPaletteSchema, au as MotionEasingKey, av as MotionEasingKeySchema, aw as MotionEasingPalette, ax as MotionEasingPaletteSchema, ay as MotionIntent, az as MotionIntentMap, aA as MotionIntentMapSchema, aB as MotionIntentSchema, aC as MotionSlice, aD as MotionSliceSchema, aE as MotionTokens, aF as MotionTokensSchema, aG as NodeClassification, aH as NodeClassificationSchema, aI as OrbitalConfig, aJ as OrbitalConfigInput, aK as OrbitalConfigSchema, aL as OrbitalDefinitionSchema, aM as OrbitalInput, aN as OrbitalPage, aO as OrbitalPageInput, aP as OrbitalPageSchema, aQ as OrbitalPageStrictInput, aR as OrbitalPageStrictSchema, aS as OrbitalSchemaInput, aT as OrbitalSchemaSchema, aU as OrbitalSchemaWithTraits, aV as OrbitalUnit, aW as OrbitalUnitSchema, aX as OrbitalZodSchema, P as PageRef, c as PageRefObject, aY as PageRefObjectSchema, aZ as PageRefSchema, a_ as PageRefStringSchema, a$ as PageSchema, b1 as PageTraitRefSchema, b2 as RelatedLink, b3 as RelatedLinkSchema, b4 as SchemaMetadata, b5 as SchemaMetadataSchema, b6 as SkinSpec, b7 as SkinSpecSchema, b8 as SpacingScale, b9 as SpacingScaleSchema, ba as StateSemanticRole, bb as StateSemanticRoleSchema, bc as SuggestedGuard, bd as SuggestedGuardSchema, be as ThemeDefinition, bf as ThemeDefinitionSchema, bg as ThemeRef, bh as ThemeRefSchema, bi as ThemeRefStringSchema, bj as ThemeTokens, bk as ThemeTokensSchema, bl as ThemeVariant, bm as ThemeVariantSchema, bn as TypeIntent, bo as TypeIntentMap, bp as TypeIntentMapSchema, bq as TypeIntentSchema, br as TypeScale, bs as TypeScaleEntry, bt as TypeScaleEntrySchema, bu as TypeScaleSchema, bv as TypeScaleTokens, bw as TypeScaleTokensSchema, bx as TypeSizeKey, by as TypeSizeKeySchema, bz as TypeSlice, bA as TypeSliceSchema, bB as TypeSlot, bC as TypeSlotSchema, bD as TypeWeight, bE as TypeWeightSchema, bF as UXHints, bG as UXHintsSchema, U as UseDeclaration, bH as UseDeclarationSchema, bI as UserPersona, bJ as UserPersonaInput, bK as UserPersonaSchema, bL as ViewType, bM as ViewTypeSchema, bN as isEntityCall, bO as isEntityReference, bP as isEntityReferenceAny, bQ as isImportedTraitRef, bR as isOrbitalDefinition, bS as isPageReference, bT as isPageReferenceObject, bU as isPageReferenceString, bV as isThemeReference, bW as parseEntityRef, bX as parseImportedTraitRef, bY as parseOrbitalSchema, bZ as parsePageRef, b_ as safeParseOrbitalSchema } from '../schema-BOGLyI7O.js';
+import { bB as ServiceParams, a as Trait, d as Entity, h as EntityRow, F as FieldValue, a8 as DeclaredTraitConfig, T as TraitConfig, E as Effect, n as ConfigFieldDeclaration, q as State, cp as Transition, f as EntityField, av as Event, c9 as TraitConfigValue, g as EntityPersistence, c6 as TraitCategory, db as TraitScope } from '../trait-BnNByIRE.js';
+export { A as ANIMATION_NAMES, r as ASSET_ASPECTS, s as ASSET_DIMENSIONS, t as AgentEffect, u as AnimationDef, v as AnimationDefInput, w as AnimationDefSchema, x as AnimationName, y as AnimationNameSchema, z as ArrayEntityField, B as Asset, D as AssetAspect, G as AssetAspectSchema, H as AssetCatalog, I as AssetCatalogEntry, J as AssetCatalogEntryInput, K as AssetCatalogEntrySchema, L as AssetCatalogSchema, M as AssetDimension, N as AssetDimensionSchema, O as AssetMap, P as AssetMapInput, Q as AssetMapSchema, V as AssetMapping, W as AssetMappingInput, X as AssetMappingSchema, Y as AssetSchema, Z as AssetUrl, _ as AtomicEffect, $ as CallServiceConfig, a0 as CallServiceEffect, C as CallSiteConfig, p as CallSiteConfigEntry, a1 as CharacterKit, a2 as CharacterKitLayer, a3 as CharacterKitLayerSchema, a4 as CharacterKitSchema, a5 as CheckpointLoadEffect, a6 as CheckpointSaveEffect, a7 as ConfigFieldDeclarationSchema, a9 as DeclaredTraitConfigSchema, aa as DerefEffect, ab as DespawnEffect, ac as DoEffect, ad as ENTITY_ROLES, ae as EffectInput, af as EffectSchema, ag as EmitConfig, ah as EmitEffect, ai as EntityData, aj as EntityFieldContract, ak as EntityFieldContractSchema, al as EntityFieldInput, am as EntityFieldSchema, an as EntityPersistenceSchema, ao as EntityRole, ap as EntityRoleSchema, aq as EntitySchema, ar as EntityWith, as as EnumEntityField, at as EvaluateConfig, au as EvaluateEffect, aw as EventInput, m as EventPayloadField, ax as EventPayloadFieldSchema, ay as EventSchema, az as EventScope, aA as EventScopeSchema, aB as FetchEffect, aC as FetchOptions, aD as FetchResult, aE as Field, aF as FieldFormat, aG as FieldFormatSchema, aH as FieldSchema, aI as FieldType, aJ as FieldTypeSchema, aK as ForwardConfig, aL as ForwardEffect, aM as GAME_TYPES, aN as GameType, aO as GameTypeSchema, aP as Guard, aQ as GuardInput, aR as GuardSchema, aS as ListenSource, aT as ListenSourceSchema, aU as LogEffect, aV as McpServiceDef, aW as McpServiceDefSchema, aX as NavigateEffect, aY as NnConfig, aZ as NnLayer, a_ as NotifyEffect, a$ as OrbitalEntity, b0 as OrbitalEntityInput, b1 as OrbitalEntitySchema, b2 as OrbitalTraitRef, b3 as OrbitalTraitRefSchema, b4 as OsEffect, b5 as PACK_CLASSES, b6 as PackClass, b7 as PackClassSchema, b8 as PayloadField, b9 as PayloadFieldSchema, ba as PersistData, bb as PersistEffect, bc as PersistEmitConfig, bd as PresentationType, be as RefEffect, k as RelationConfig, bf as RelationConfigSchema, bg as RelationEntityField, R as RenderBinding, bh as RenderItemLambda, bi as RenderUIConfig, b as RenderUIEffect, bj as RenderUINode, bk as RequiredField, bl as RequiredFieldSchema, bm as ResolvedAsset, bn as ResolvedAssetInput, bo as ResolvedAssetSchema, bp as ResolvedPatternProps, bq as RestAuthConfig, br as RestAuthConfigSchema, bs as RestServiceDef, bt as RestServiceDefSchema, bu as SERVICE_TYPES, bv as SPRITE_DIRECTIONS, bw as ScalarEntityField, bx as SemanticAssetRef, by as SemanticAssetRefInput, bz as SemanticAssetRefSchema, o as ServiceDefinition, bA as ServiceDefinitionSchema, bC as ServiceParamsValue, S as ServiceRef, bD as ServiceRefObject, bE as ServiceRefObjectSchema, bF as ServiceRefSchema, bG as ServiceRefStringSchema, bH as ServiceType, bI as ServiceTypeSchema, bJ as SetEffect, bK as SocketEvents, bL as SocketEventsSchema, bM as SocketServiceDef, bN as SocketServiceDefSchema, bO as SpawnEffect, bP as SpriteDirection, bQ as SpriteDirectionSchema, bR as SpriteSheetAtlas, bS as SpriteSheetAtlasInput, bT as SpriteSheetAtlasSchema, bU as StateInput, bV as StateMachine, bW as StateMachineInput, bX as StateMachineSchema, bY as StateSchema, bZ as SubTexture, b_ as SubTextureSchema, b$ as SwapEffect, c0 as TextureAtlas, c1 as TextureAtlasSchema, c2 as Tilesheet, c3 as TilesheetSchema, c4 as TrainConfig, c5 as TrainEffect, c7 as TraitCategorySchema, l as TraitConfigObject, c8 as TraitConfigSchema, ca as TraitConfigValueSchema, cb as TraitDataEntity, cc as TraitDataEntitySchema, cd as TraitEntityField, ce as TraitEntityFieldSchema, c as TraitEventContract, cf as TraitEventContractSchema, e as TraitEventListener, cg as TraitEventListenerSchema, ch as TraitInput, i as TraitRef, ci as TraitRefSchema, j as TraitReference, cj as TraitReferenceInput, ck as TraitReferenceSchema, cl as TraitSchema, cm as TraitTick, cn as TraitTickSchema, co as TraitUIBinding, cq as TransitionInput, cr as TransitionSchema, cs as TypedEffect, U as UISlot, ct as UISlotSchema, cu as UI_SLOTS, cv as VISUAL_STYLES, cw as VisualStyle, cx as VisualStyleSchema, cy as WatchEffect, cz as WatchOptions, cA as atomic, cB as callService, cC as createAssetKey, cD as deref, cE as deriveCollection, cF as despawn, cG as doEffects, cH as emit, cI as findService, cJ as getDefaultAnimationsForRole, cK as getServiceNames, cL as getTraitConfig, cM as getTraitName, cN as hasService, cO as isCallSiteConfigDeclaration, cP as isCircuitEvent, cQ as isEffect, cR as isInlineTrait, cS as isMcpService, cT as isRestService, cU as isRuntimeEntity, cV as isSExprEffect, cW as isServiceReference, cX as isServiceReferenceObject, cY as isSocketService, cZ as navigate, c_ as normalizeTraitRef, c$ as notify, d0 as parseAssetKey, d1 as parseServiceRef, d2 as persist, d3 as persistenceModeAllowsOverrides, d4 as ref, d5 as renderUI, d6 as set, d7 as spawn, d8 as swap, d9 as validateAssetAnimations, da as watch } from '../trait-BnNByIRE.js';
 import { d as EventPayloadValue, c as EventPayload, L as LogMeta, S as SExpr, b as EvalContext } from '../expression-BUIi9ezJ.js';
 export { C as CORE_BINDINGS, a as CoreBinding, E as Expression, e as ExpressionInput, f as ExpressionSchema, P as ParsedBinding, g as SExprAtom, h as SExprAtomSchema, i as SExprInput, j as SExprSchema, k as collectBindings, l as getArgs, m as getOperator, n as isBinding, o as isSExpr, p as isSExprAtom, q as isSExprCall, r as isValidBinding, s as parseBinding, t as sexpr, w as walkSExpr } from '../expression-BUIi9ezJ.js';
 import { z } from 'zod';
 import { AnyPatternConfig } from '@almadar/patterns';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
-import { l as JsonObject, T as ToolArgs, J as JsonValue, c as FactoryConfigTier } from '../types-QQ9BTzkx.js';
-export { t as isJsonArray, u as isJsonObject, v as isJsonPrimitive } from '../types-QQ9BTzkx.js';
+import { l as JsonObject, T as ToolArgs, J as JsonValue, c as FactoryConfigTier } from '../types-By4AQApw.js';
+export { t as isJsonArray, u as isJsonObject, v as isJsonPrimitive } from '../types-By4AQApw.js';
 
 /**
  * S-Expression Bindings
@@ -878,8 +878,8 @@ interface ResolvedEntity {
     fields: ResolvedField[];
     /** Whether this entity only exists in runtime (not persisted to Firestore) */
     runtime?: boolean;
-    /** Whether this is a singleton entity (only one instance exists) */
-    singleton?: boolean;
+    /** Whether this entity's state is shared across every bound trait (vs a per-trait copy). Orthogonal to `runtime`. */
+    shared?: boolean;
     /** Whether this entity has pre-authored instances in the schema */
     hasInstances?: boolean;
     /** Pre-authored instances from the schema (seed data or static reference data) */