@almadar/core 1.0.0 → 1.0.9

package/dist/{src/types → types}/index.d.ts

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+import { AnyPatternConfig } from '@almadar/patterns';
+export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
+export { CATEGORIES, CategoryMeta, OPERATORS, OPERATORS_SCHEMA, OPERATOR_NAMES, OperatorCategory, OperatorMeta, OperatorStats, OperatorsSchema, TargetPlatform, getOperatorMeta, getOperatorStats, getOperatorsByCategory, getOperatorsForTarget, isEffectOperator, isGuardOperator, isKnownOperator, validateOperatorArity } from '@almadar/operators';
 
 /**
  * S-Expression Types
@@ -582,6 +585,8 @@ interface OrbitalEntity {
     collection?: string;
     /** Entity fields */
     fields: EntityField[];
+    /** Pre-authored instances (seed data or static reference data) */
+    instances?: Record<string, unknown>[];
     /** Auto-add createdAt/updatedAt timestamps */
     timestamps?: boolean;
     /** Soft delete support */
@@ -598,6 +603,7 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+    instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
     timestamps: z.ZodOptional<z.ZodBoolean>;
     softDelete: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
@@ -626,6 +632,7 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     persistence: "persistent" | "runtime" | "singleton" | "instance";
     fields: EntityField[];
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -642,6 +649,7 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     fields: EntityField[];
     persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -663,6 +671,7 @@ declare const EntitySchema: z.ZodObject<{
     persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+    instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
     timestamps: z.ZodOptional<z.ZodBoolean>;
     softDelete: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
@@ -691,6 +700,7 @@ declare const EntitySchema: z.ZodObject<{
     persistence: "persistent" | "runtime" | "singleton" | "instance";
     fields: EntityField[];
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -707,6 +717,7 @@ declare const EntitySchema: z.ZodObject<{
     fields: EntityField[];
     persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -954,15 +965,25 @@ declare const PageSchema: z.ZodObject<{
 /**
  * Known UI slots where content can be rendered
  */
-declare const UI_SLOTS: readonly ["main", "sidebar", "modal", "drawer", "overlay", "center", "toast", "hud-top", "hud-bottom", "floating", "system"];
+declare const UI_SLOTS: readonly ["main", "sidebar", "modal", "drawer", "overlay", "center", "toast", "floating", "system", "content", "screen", "hud", "hud-top", "hud-bottom", "hud.health", "hud.score", "hud.inventory", "hud.stamina", "overlay.inventory", "overlay.dialogue", "overlay.menu", "overlay.pause"];
 type UISlot = (typeof UI_SLOTS)[number];
-declare const UISlotSchema: z.ZodEnum<["main", "sidebar", "modal", "drawer", "overlay", "center", "toast", "hud-top", "hud-bottom", "floating", "system"]>;
+declare const UISlotSchema: z.ZodEnum<["main", "sidebar", "modal", "drawer", "overlay", "center", "toast", "floating", "system", "content", "screen", "hud", "hud-top", "hud-bottom", "hud.health", "hud.score", "hud.inventory", "hud.stamina", "overlay.inventory", "overlay.dialogue", "overlay.menu", "overlay.pause"]>;
+
 /**
- * Pattern configuration for render-ui effect
+ * Configuration for render-ui effect.
+ * Used in runtime to specify which slot and pattern to render.
  */
-interface PatternConfig {
-    type: string;
-    [key: string]: unknown;
+interface RenderUIConfig {
+    /** Target UI slot */
+    slot: UISlot;
+    /** Pattern configuration (null clears the slot) */
+    pattern: AnyPatternConfig | null;
+    /** Target element (trait name or entity ID) */
+    target?: string;
+    /** Additional props for the pattern */
+    props?: Record<string, unknown>;
+    /** Optional priority for slot ordering */
+    priority?: number;
 }
 /**
  * Configuration extracted from call-service effects
@@ -977,20 +998,161 @@ interface CallServiceConfig {
     onError?: string;
 }
 /**
- * Effect type - S-expression format (array form).
+ * Render UI effect - displays a pattern in a UI slot.
+ * @example ['render-ui', 'main', { patternType: 'entity-table', columns: ['name'] }]
+ */
+type RenderUIEffect = ['render-ui', UISlot, AnyPatternConfig] | ['render-ui', UISlot, AnyPatternConfig, Record<string, unknown>];
+/**
+ * Navigate effect - navigates to a path.
+ * @example ['navigate', '/tasks'] or ['navigate', '/tasks/:id', { id: '123' }]
+ */
+type NavigateEffect = ['navigate', string] | ['navigate', string, Record<string, string>];
+/**
+ * Emit effect - emits an event, optionally with payload.
+ * @example ['emit', 'SAVE'] or ['emit', 'PLAYER_DIED', { playerId: '@entity.id' }]
+ * @example ['emit', 'FILTER_CHANGED', '@entity.filters']
+ */
+type EmitEffect = ['emit', string] | ['emit', string, Record<string, unknown> | string];
+/**
+ * Set effect - sets a binding to a value.
+ * @example ['set', '@entity.health', 100]
+ */
+type SetEffect = ['set', string, unknown];
+/**
+ * Persist effect - creates, updates, deletes, or clears entities.
+ * @example ['persist', 'create', 'Task', { title: '@payload.title' }]
+ * @example ['persist', 'update', '@entity.entityType', '@payload.data']
+ */
+type PersistEffect = ['persist', 'create', string, Record<string, unknown> | string] | ['persist', 'update', string, Record<string, unknown> | string] | ['persist', 'delete', string] | ['persist', 'delete', string, Record<string, unknown> | string] | ['persist', 'clear', string] | ['persist', 'clear', string, Record<string, unknown> | string];
+/**
+ * Call service effect - invokes an external service.
+ * @example ['call-service', 'WeatherAPI', { service: 'weather', action: 'get', onSuccess: 'OK' }]
+ */
+type CallServiceEffect = ['call-service', string, CallServiceConfig];
+/**
+ * Spawn effect - creates a new entity instance (games).
+ * @example ['spawn', 'Bullet', { x: '@entity.x', y: '@entity.y' }]
+ */
+type SpawnEffect = ['spawn', string] | ['spawn', string, Record<string, unknown>];
+/**
+ * Despawn effect - removes an entity instance (games).
+ * @example ['despawn', '@entity.id']
+ */
+type DespawnEffect = ['despawn', string];
+/**
+ * Do effect - executes multiple effects in sequence.
+ * Uses SExpr to allow deeply nested conditionals.
+ * @example ['do', ['set', '@entity.x', 0], ['set', '@entity.y', 0]]
+ */
+type DoEffect = ['do', ...SExpr[]];
+/**
+ * Notify effect - sends a notification.
+ * @example ['notify', 'in_app', 'Task created successfully']
+ * @example ['notify', 'in_app', ['str/concat', 'Item: ', '@entity.name']]
+ */
+type NotifyEffect = ['notify', string, string | SExpr] | ['notify', string, string | SExpr, string];
+/**
+ * Fetch effect - retrieves entity data (server-side).
+ * @example ['fetch', 'User'] or ['fetch', 'User', { id: '@payload.userId' }]
+ */
+type FetchEffect = ['fetch', string] | ['fetch', string, Record<string, unknown>];
+/**
+ * If effect - conditional effect execution.
+ * Uses SExpr to allow deeply nested conditionals.
+ * @example ['if', ['>', '@entity.health', 0], ['emit', 'ALIVE'], ['emit', 'DEAD']]
+ */
+type IfEffect = ['if', Expression, SExpr] | ['if', Expression, SExpr, SExpr];
+/**
+ * When effect - conditional effect similar to if but without else.
+ * Uses SExpr to allow deeply nested conditionals.
+ * @example ['when', ['>', '@entity.health', 0], ['emit', 'ALIVE']]
+ */
+type WhenEffect = ['when', Expression, SExpr];
+/**
+ * Let effect - creates local bindings for effects.
+ * Uses SExpr to allow deeply nested conditionals.
+ * @example ['let', ['temp', ['get', '@payload.value']], ['set', '@entity.value', 'temp']]
+ */
+type LetEffect = ['let', [string, unknown][], ...SExpr[]];
+/**
+ * Log effect - logs a message for debugging.
+ * @example ['log', 'User created:', '@entity.name']
+ */
+type LogEffect = ['log', ...unknown[]];
+/**
+ * Wait effect - delays execution.
+ * @example ['wait', 1000] - wait 1 second
+ */
+type WaitEffect = ['wait', number];
+/**
+ * Async delay effect - wait then execute effects.
+ * @example ['async/delay', 2000, ['emit', 'TIMEOUT']]
+ */
+type AsyncDelayEffect = ['async/delay', number | string, ...Effect[]];
+/**
+ * Async debounce effect - debounce then execute effect.
+ * @example ['async/debounce', 300, ['emit', 'SEARCH_COMPLETE']]
+ * @example ['async/debounce', '@entity.debounceMs', ['emit', 'SEARCH_COMPLETE']]
+ */
+type AsyncDebounceEffect = ['async/debounce', number | string, SExpr];
+/**
+ * Async throttle effect - throttle then execute effect.
+ * @example ['async/throttle', 100, ['emit', 'SCROLL_HANDLED']]
+ * @example ['async/throttle', '@entity.throttleMs', ['emit', 'SCROLL_HANDLED']]
+ */
+type AsyncThrottleEffect = ['async/throttle', number | string, SExpr];
+/**
+ * Async interval effect - execute effect at intervals.
+ * @example ['async/interval', 1000, ['emit', 'TICK']]
+ * @example ['async/interval', '@entity.intervalMs', ['emit', 'POLL_TICK']]
+ */
+type AsyncIntervalEffect = ['async/interval', number | string, SExpr];
+/**
+ * Async race effect - first effect to complete wins.
+ * @example ['async/race', ['call', 'api1'], ['call', 'api2']]
+ */
+type AsyncRaceEffect = ['async/race', ...Effect[]];
+/**
+ * Async all effect - wait for all effects to complete.
+ * @example ['async/all', ['call', 'api1'], ['call', 'api2']]
+ */
+type AsyncAllEffect = ['async/all', ...Effect[]];
+/**
+ * Async sequence effect - execute effects in sequence.
+ * @example ['async/sequence', ['call', 'validate'], ['call', 'save']]
+ */
+type AsyncSequenceEffect = ['async/sequence', ...Effect[]];
+/**
+ * Union of all typed effects.
+ * Provides compile-time validation for common effect types.
+ */
+type TypedEffect = RenderUIEffect | NavigateEffect | EmitEffect | SetEffect | PersistEffect | CallServiceEffect | SpawnEffect | DespawnEffect | DoEffect | NotifyEffect | FetchEffect | IfEffect | WhenEffect | LetEffect | LogEffect | WaitEffect | AsyncDelayEffect | AsyncDebounceEffect | AsyncThrottleEffect | AsyncIntervalEffect | AsyncRaceEffect | AsyncAllEffect | AsyncSequenceEffect;
+/**
+ * Effect type - typed S-expression format.
+ *
+ * Effects are strongly typed tuples that enforce:
+ * - Valid effect operators (render-ui, emit, set, persist, navigate, call-service)
+ * - Valid UISlots for render-ui
+ * - Valid PatternTypes and props for render-ui
+ * - Correct argument types for each effect
  *
- * Effects are arrays where the first element is the operator name (string)
- * and subsequent elements are the arguments.
+ * Available typed effects:
+ * - RenderUIEffect: ['render-ui', UISlot, PatternConfig]
+ * - NavigateEffect: ['navigate', path] or ['navigate', path, params]
+ * - EmitEffect: ['emit', eventName] or ['emit', eventName, payload]
+ * - SetEffect: ['set', binding, value]
+ * - PersistEffect: ['persist', operation, entity, data?]
+ * - CallServiceEffect: ['call-service', serviceName, config]
  *
  * @example
  * ["set", "@entity.health", 100]
  * ["emit", "PLAYER_DIED", { "playerId": "@entity.id" }]
- * ["render-ui", "main", { "type": "entity-table", "entity": "Task" }]
- * ["call-service", "WeatherAPI", { "action": "getWeather", "onSuccess": "OK", "onError": "ERR" }]
+ * ["render-ui", "main", { "patternType": "entity-table", "columns": ["name"] }]
+ * ["call-service", "WeatherAPI", { "action": "getWeather", "onSuccess": "OK" }]
  * ["navigate", "/tasks"]
  * ["persist", "create", "Task", { "title": "@payload.title" }]
  */
-type Effect = SExpr[];
+type Effect = TypedEffect;
 /**
  * Schema for Effect - validates S-expression format
  */
@@ -1018,47 +1180,47 @@ declare function emit(event: string, payload?: Record<string, unknown>): Effect;
  * Create a navigate effect
  * @example ["navigate", "/tasks"]
  */
-declare function navigate(path: string, params?: Record<string, string>): Effect;
+declare function navigate(path: string): NavigateEffect;
+declare function navigate(path: string, params: Record<string, string>): NavigateEffect;
 /**
  * Create a render-ui effect
- * @example ["render-ui", "main", { "type": "entity-table", "entity": "Task" }]
+ * @example ["render-ui", "main", { "patternType": "entity-table", "columns": ["name"] }]
  */
-declare function renderUI(target: UISlot, pattern: PatternConfig | null, props?: Record<string, unknown>): Effect;
+declare function renderUI(target: UISlot, pattern: AnyPatternConfig): RenderUIEffect;
+declare function renderUI(target: UISlot, pattern: AnyPatternConfig, props: Record<string, unknown>): RenderUIEffect;
 /**
  * Create a persist effect
  * @example ["persist", "create", "Task", { "title": "@payload.title" }]
  */
-declare function persist(action: 'create' | 'update' | 'delete' | 'clear', entity: string, data?: Record<string, unknown>): Effect;
+declare function persist(action: 'create' | 'update', entity: string, data: Record<string, unknown>): PersistEffect;
+declare function persist(action: 'delete' | 'clear', entity: string, data?: Record<string, unknown>): PersistEffect;
 /**
  * Create a call-service effect
- * @example ["call-service", "stripe", { "action": "charge", "onSuccess": "OK", "onError": "ERR" }]
+ * @example ["call-service", "stripe", { "service": "stripe", "action": "charge", "onSuccess": "OK", "onError": "ERR" }]
  */
-declare function callService(service: string, config: {
-    action: string;
-    onSuccess: string;
-    onError: string;
-    params?: Record<string, unknown>;
-}): Effect;
+declare function callService(serviceName: string, config: CallServiceConfig): CallServiceEffect;
 /**
  * Create a spawn effect (games)
  * @example ["spawn", "Bullet", { "x": "@entity.x", "y": "@entity.y" }]
  */
-declare function spawn(entity: string, initialState?: Record<string, unknown>): Effect;
+declare function spawn(entity: string): SpawnEffect;
+declare function spawn(entity: string, initialState: Record<string, unknown>): SpawnEffect;
 /**
  * Create a despawn effect (games)
  * @example ["despawn", "@entity.id"]
  */
-declare function despawn(entityId: string): Effect;
+declare function despawn(entityId: string): DespawnEffect;
 /**
  * Create a do effect (multiple effects)
  * @example ["do", ["set", "@entity.x", 0], ["set", "@entity.y", 0]]
  */
-declare function doEffects(...effects: Effect[]): Effect;
+declare function doEffects(...effects: SExpr[]): DoEffect;
 /**
  * Create a notify effect
  * @example ["notify", "in_app", "Task created successfully"]
  */
-declare function notify(channel: 'email' | 'push' | 'sms' | 'in_app', message: string, recipient?: string): Effect;
+declare function notify(channel: 'email' | 'push' | 'sms' | 'in_app', message: string): NotifyEffect;
+declare function notify(channel: 'email' | 'push' | 'sms' | 'in_app', message: string, recipient: string): NotifyEffect;
 
 /**
  * Represents a state in the state machine
@@ -1458,6 +1620,21 @@ type EventInput = z.input<typeof EventSchema>;
 type GuardInput = z.input<typeof GuardSchema>;
 type TransitionInput = z.input<typeof TransitionSchema>;
 type StateMachineInput = z.input<typeof StateMachineSchema>;
+/**
+ * Check if an event is a circuit event (not internal/system event).
+ * Circuit events are user-defined events that participate in the closed circuit pattern.
+ * Internal/system events start with underscore (e.g., _INIT, _TICK, _TIMER).
+ *
+ * @param event - Event name to check
+ * @returns true if event is a circuit event (doesn't start with underscore)
+ *
+ * @example
+ * isCircuitEvent('CREATE') // true
+ * isCircuitEvent('SAVE') // true
+ * isCircuitEvent('_INIT') // false (internal)
+ * isCircuitEvent('_TICK') // false (internal)
+ */
+declare function isCircuitEvent(event: string): boolean;
 
 /**
  * Categories for organizing traits
@@ -1854,6 +2031,11 @@ interface Trait {
     description?: string;
     description_visual_prompt?: string;
     category?: TraitCategory;
+    /**
+     * The entity this trait is linked to.
+     * Required for inline trait definitions within an orbital.
+     */
+    linkedEntity?: string;
     requiredFields?: RequiredField[];
     dataEntities?: TraitDataEntity[];
     stateMachine?: StateMachine;
@@ -1877,6 +2059,7 @@ declare const TraitSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -2223,8 +2406,9 @@ declare const TraitSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -2317,8 +2501,9 @@ declare const TraitSchema: z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -2426,6 +2611,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -2772,8 +2958,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -2866,8 +3053,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -2997,6 +3185,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -3343,8 +3532,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -3437,8 +3627,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
+    linkedEntity?: string | undefined;
     emits?: {
         event: string;
         description?: string | undefined;
@@ -3659,7 +3850,7 @@ declare const DomainContextSchema: z.ZodObject<{
     }>, "many">>;
     vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, "strip", z.ZodTypeAny, {
-    category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+    category: "dashboard" | "content" | "form" | "social" | "game" | "business";
     request: string;
     requestFragment?: string | undefined;
     subDomain?: string | undefined;
@@ -3670,7 +3861,7 @@ declare const DomainContextSchema: z.ZodObject<{
     }[] | undefined;
     vocabulary?: Record<string, string> | undefined;
 }, {
-    category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+    category: "dashboard" | "content" | "form" | "social" | "game" | "business";
     request: string;
     requestFragment?: string | undefined;
     subDomain?: string | undefined;
@@ -4175,13 +4366,13 @@ declare const CustomPatternDefinitionSchema: z.ZodObject<{
     props: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "custom";
-    component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+    component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
 }, {
     type: "custom";
-    component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+    component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
@@ -4198,13 +4389,13 @@ declare const CustomPatternMapSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.Z
     props: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     type: "custom";
-    component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+    component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
 }, {
     type: "custom";
-    component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+    component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
     className: string;
     slots?: string[] | undefined;
     props?: string[] | undefined;
@@ -4884,6 +5075,7 @@ declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
     persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+    instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
     timestamps: z.ZodOptional<z.ZodBoolean>;
     softDelete: z.ZodOptional<z.ZodBoolean>;
     description: z.ZodOptional<z.ZodString>;
@@ -4912,6 +5104,7 @@ declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
     persistence: "persistent" | "runtime" | "singleton" | "instance";
     fields: EntityField[];
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -4928,6 +5121,7 @@ declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
     fields: EntityField[];
     persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
     collection?: string | undefined;
+    instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
     softDelete?: boolean | undefined;
     description?: string | undefined;
@@ -5615,6 +5809,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+        instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
         timestamps: z.ZodOptional<z.ZodBoolean>;
         softDelete: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
@@ -5643,6 +5838,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -5659,6 +5855,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -5688,6 +5885,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -6034,8 +6232,9 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -6128,8 +6327,9 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -6403,7 +6603,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         }>, "many">>;
         vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -6414,7 +6614,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         }[] | undefined;
         vocabulary?: Record<string, string> | undefined;
     }, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -6521,6 +6721,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -6537,8 +6738,9 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -6737,7 +6939,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -6776,6 +6978,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -6792,8 +6995,9 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -6992,7 +7196,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -7245,6 +7449,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+        instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
         timestamps: z.ZodOptional<z.ZodBoolean>;
         softDelete: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
@@ -7273,6 +7478,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -7289,6 +7495,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -7318,6 +7525,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -7664,8 +7872,9 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -7758,8 +7967,9 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -8033,7 +8243,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         }>, "many">>;
         vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -8044,7 +8254,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         }[] | undefined;
         vocabulary?: Record<string, string> | undefined;
     }, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -8151,6 +8361,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -8167,8 +8378,9 @@ declare const OrbitalSchema$1: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -8367,7 +8579,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -8406,6 +8618,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -8422,8 +8635,9 @@ declare const OrbitalSchema$1: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -8622,7 +8836,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -8882,6 +9096,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+        instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
         timestamps: z.ZodOptional<z.ZodBoolean>;
         softDelete: z.ZodOptional<z.ZodBoolean>;
         description: z.ZodOptional<z.ZodString>;
@@ -8910,6 +9125,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -8926,6 +9142,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -8955,6 +9172,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -9301,8 +9519,9 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -9395,8 +9614,9 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -9670,7 +9890,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         }>, "many">>;
         vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -9681,7 +9901,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         }[] | undefined;
         vocabulary?: Record<string, string> | undefined;
     }, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -9788,6 +10008,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         persistence: "persistent" | "runtime" | "singleton" | "instance";
         fields: EntityField[];
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -9804,8 +10025,9 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -10004,7 +10226,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -10043,6 +10265,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         fields: EntityField[];
         persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
         collection?: string | undefined;
+        instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
         softDelete?: boolean | undefined;
         description?: string | undefined;
@@ -10059,8 +10282,9 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
+        linkedEntity?: string | undefined;
         emits?: {
             event: string;
             description?: string | undefined;
@@ -10259,7 +10483,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     })[] | undefined;
     exposes?: string[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -10422,7 +10646,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }>, "many">>;
         vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -10433,7 +10657,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }[] | undefined;
         vocabulary?: Record<string, string> | undefined;
     }, {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -10530,13 +10754,13 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         props: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
     }, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
@@ -10760,6 +10984,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
             collection: z.ZodOptional<z.ZodString>;
             fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
+            instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
             timestamps: z.ZodOptional<z.ZodBoolean>;
             softDelete: z.ZodOptional<z.ZodBoolean>;
             description: z.ZodOptional<z.ZodString>;
@@ -10788,6 +11013,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             persistence: "persistent" | "runtime" | "singleton" | "instance";
             fields: EntityField[];
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -10804,6 +11030,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             fields: EntityField[];
             persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -10833,6 +11060,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
             category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+            linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
@@ -11179,8 +11407,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -11273,8 +11502,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }, {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -11548,7 +11778,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             }>, "many">>;
             vocabulary: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
         }, "strip", z.ZodTypeAny, {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -11559,7 +11789,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             }[] | undefined;
             vocabulary?: Record<string, string> | undefined;
         }, {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -11666,6 +11896,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             persistence: "persistent" | "runtime" | "singleton" | "instance";
             fields: EntityField[];
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -11682,8 +11913,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -11882,7 +12114,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -11921,6 +12153,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             fields: EntityField[];
             persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -11937,8 +12170,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -12137,7 +12371,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -12354,6 +12588,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             persistence: "persistent" | "runtime" | "singleton" | "instance";
             fields: EntityField[];
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -12370,8 +12605,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -12570,7 +12806,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -12653,7 +12889,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         env?: Record<string, string> | undefined;
     })[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -12685,7 +12921,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
     designTokens?: Record<string, Record<string, string>> | undefined;
     customPatterns?: Record<string, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
@@ -12698,6 +12934,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             fields: EntityField[];
             persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -12714,8 +12951,9 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -12914,7 +13152,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -12997,7 +13235,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         env?: Record<string, string> | undefined;
     })[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -13029,7 +13267,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
     designTokens?: Record<string, Record<string, string>> | undefined;
     customPatterns?: Record<string, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
@@ -13050,6 +13288,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             fields: EntityField[];
             persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -13066,8 +13305,9 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -13266,7 +13506,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -13349,7 +13589,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         env?: Record<string, string> | undefined;
     })[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -13381,7 +13621,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
     designTokens?: Record<string, Record<string, string>> | undefined;
     customPatterns?: Record<string, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
@@ -13394,6 +13634,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             persistence: "persistent" | "runtime" | "singleton" | "instance";
             fields: EntityField[];
             collection?: string | undefined;
+            instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
             softDelete?: boolean | undefined;
             description?: string | undefined;
@@ -13410,8 +13651,9 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "lifecycle" | "temporal" | "notification" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
+            linkedEntity?: string | undefined;
             emits?: {
                 event: string;
                 description?: string | undefined;
@@ -13610,7 +13852,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         })[] | undefined;
         exposes?: string[] | undefined;
         domainContext?: {
-            category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+            category: "dashboard" | "content" | "form" | "social" | "game" | "business";
             request: string;
             requestFragment?: string | undefined;
             subDomain?: string | undefined;
@@ -13693,7 +13935,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         env?: Record<string, string> | undefined;
     })[] | undefined;
     domainContext?: {
-        category: "dashboard" | "social" | "game" | "business" | "form" | "content";
+        category: "dashboard" | "content" | "form" | "social" | "game" | "business";
         request: string;
         requestFragment?: string | undefined;
         subDomain?: string | undefined;
@@ -13725,7 +13967,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
     designTokens?: Record<string, Record<string, string>> | undefined;
     customPatterns?: Record<string, {
         type: "custom";
-        component: "main" | "form" | "label" | "div" | "span" | "button" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img" | "input";
+        component: "main" | "button" | "form" | "input" | "label" | "div" | "span" | "a" | "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "footer" | "section" | "article" | "nav" | "aside" | "ul" | "ol" | "li" | "img";
         className: string;
         slots?: string[] | undefined;
         props?: string[] | undefined;
@@ -13737,93 +13979,14 @@ type OrbitalConfigInput = z.input<typeof OrbitalConfigSchema>;
 /**
  * S-Expression Operators
  *
- * Defines all operators available in the S-expression language.
- * This is the single source of truth for operator metadata.
- *
- * Operators are organized by category:
- * - Arithmetic: +, -, *, /, %, abs, min, max, floor, ceil, round
- * - Comparison: =, !=, <, >, <=, >=
- * - Logic: and, or, not, if
- * - Control: let, do, when
- * - Effects: set, emit, persist, navigate, notify, spawn, despawn
- * - Collections: map, filter, find, count, sum, first, last, nth, concat, includes
- * - Standard Library: std-math, std-str, std-array, std-object, std-validate, std-time, std-format, std-async
+ * Re-exports operator types and data from the canonical @almadar/operators package.
+ * This ensures almadar-core stays in sync with the single source of truth.
  *
  * @packageDocumentation
  */
-declare const OPERATOR_CATEGORIES: readonly ["arithmetic", "comparison", "logic", "control", "effect", "collection", "std-math", "std-str", "std-array", "std-object", "std-validate", "std-time", "std-format", "std-async", "std-nn", "std-tensor", "std-train"];
-type OperatorCategory = (typeof OPERATOR_CATEGORIES)[number];
-/**
- * Metadata for an operator
- */
-interface OperatorMeta {
-    /** Operator category */
-    category: OperatorCategory;
-    /** Minimum number of arguments */
-    minArity: number;
-    /** Maximum number of arguments (null = unlimited) */
-    maxArity: number | null;
-    /** Human-readable description */
-    description: string;
-    /** Whether this operator has side effects (only valid in effect context) */
-    hasSideEffects: boolean;
-    /** Return type hint - basic types for core operators, extended types for std modules */
-    returnType: string;
-}
-/**
- * Operator registry - single source of truth for all operators.
- */
-declare const OPERATORS: Record<string, OperatorMeta>;
-/**
- * Get operator metadata by name.
- *
- * @param operator - Operator name
- * @returns Operator metadata or undefined if not found
- */
-declare function getOperatorMeta(operator: string): OperatorMeta | undefined;
-/**
- * Check if an operator exists.
- *
- * @param operator - Operator name
- * @returns true if operator exists
- */
-declare function isKnownOperator(operator: string): boolean;
-/**
- * Check if an operator has side effects.
- *
- * @param operator - Operator name
- * @returns true if operator has side effects
- */
-declare function isEffectOperator(operator: string): boolean;
-/**
- * Check if an operator is valid in a guard context (no side effects).
- *
- * @param operator - Operator name
- * @returns true if operator can be used in guards
- */
-declare function isGuardOperator(operator: string): boolean;
-/**
- * Get all operators in a category.
- *
- * @param category - Operator category
- * @returns Array of operator names
- */
-declare function getOperatorsByCategory(category: OperatorCategory): string[];
-/**
- * Get all operator names.
- *
- * @returns Array of all operator names
- */
-declare function getAllOperators(): string[];
-/**
- * Validate operator arity.
- *
- * @param operator - Operator name
- * @param argCount - Number of arguments provided
- * @returns Error message if invalid, null if valid
- */
-declare function validateOperatorArity(operator: string, argCount: number): string | null;
-type OperatorName = keyof typeof OPERATORS;
+
+declare const getAllOperators: () => string[];
+type OperatorName = string;
 
 /**
  * S-Expression Bindings
@@ -14001,37 +14164,22 @@ type InteractionModelInput = z.input<typeof InteractionModelSchema>;
 /**
  * Pattern Type for Orbital Units
  *
- * Defines pattern type validation.
- * The actual pattern definitions come from @almadar/patterns.
+ * Re-exports pattern type definitions from @almadar/patterns,
+ * which is the single source of truth for all pattern types.
  *
  * @packageDocumentation
  */
 
-/**
- * Common pattern types.
- * The full list is defined in @almadar/patterns registry.
- */
-declare const PATTERN_TYPES: readonly ["entity-table", "entity-list", "entity-cards", "entity-grid", "form", "form-section", "page-header", "stats", "stat-card", "master-detail", "dashboard-grid", "game-canvas", "game-hud", "game-controls"];
-/**
- * Pattern type union.
- * This is a string type to allow for custom/extended patterns.
- */
-type PatternType = string;
 /**
  * Zod schema for pattern types.
  * Accepts any string - validation against full registry happens at runtime.
  */
 declare const PatternTypeSchema: z.ZodString;
 /**
- * Get the common pattern types.
- * For the full registry, import from @almadar/patterns.
+ * Get all valid pattern types from the registry.
+ * Delegates to @almadar/patterns which is the SSOT.
  */
 declare function getAllPatternTypes(): string[];
-/**
- * Check if a pattern type is in the common list.
- * For comprehensive validation, use @almadar/patterns registry.
- */
-declare function isValidPatternType(patternType: string): patternType is PatternType;
 
 /**
  * Shared Intermediate Representation Types
@@ -14080,6 +14228,8 @@ interface ResolvedEntity {
     singleton?: 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) */
+    instances?: Record<string, unknown>[];
     /** Default field values from schema (for spawning singletons) */
     defaults?: Record<string, unknown>;
     usedByTraits: string[];
@@ -14299,4 +14449,4 @@ declare function createResolvedField(field: {
 }): ResolvedField;
 declare function isResolvedIR(ir: unknown): ir is ResolvedIR;
 
-export { ALLOWED_CUSTOM_COMPONENTS, type AllowedCustomComponent, type AnimationDef, type AnimationDefInput, AnimationDefSchema, type OrbitalSchema as AppSchema, type AssetMap, type AssetMapInput, AssetMapSchema, type AssetMapping, type AssetMappingInput, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, type BindingContext, BindingSchema, CORE_BINDINGS, type CallServiceConfig, type ComputedEventContract, ComputedEventContractSchema, type ComputedEventListener, ComputedEventListenerSchema, type CoreBinding, type CreateFlow, type CustomPatternDefinition, type CustomPatternDefinitionInput, CustomPatternDefinitionSchema, type CustomPatternMap, type CustomPatternMapInput, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, type DeleteFlow, type DesignPreferences, type DesignPreferencesInput, DesignPreferencesSchema, type DesignTokens, type DesignTokensInput, DesignTokensSchema, type DomainCategory, DomainCategorySchema, type DomainContext, type DomainContextInput, DomainContextSchema, type DomainVocabulary, DomainVocabularySchema, ENTITY_ROLES, type EditFlow, type Effect, type EffectInput, EffectSchema, type Entity, type EntityField, type EntityFieldInput, EntityFieldSchema, type EntityPersistence, EntityPersistenceSchema, type EntityRef, EntityRefSchema, EntityRefStringSchema, type EntityRole, EntityRoleSchema, EntitySchema, type EntitySemanticRole, EntitySemanticRoleSchema, type Event, type EventInput, type EventListener, EventListenerSchema, type EventPayloadField, EventPayloadFieldSchema, EventSchema, type EventScope, EventScopeSchema, type EventSemanticRole, EventSemanticRoleSchema, type EventSource, EventSourceSchema, type Expression, type ExpressionInput, ExpressionSchema, type Field, type FieldFormat, FieldFormatSchema, FieldSchema, type FieldType, FieldTypeSchema, type Orbital as FullOrbitalUnit, GAME_TYPES, type GameSubCategory, GameSubCategorySchema, type GameType, GameTypeSchema, type Guard, type GuardInput, GuardSchema, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type ListInteraction, type McpServiceDef, McpServiceDefSchema, type NodeClassification, NodeClassificationSchema, OPERATORS, OPERATOR_CATEGORIES, type OperatorCategory, type OperatorMeta, type OperatorName, type Orbital, type OrbitalConfig, type OrbitalConfigInput, OrbitalConfigSchema, type OrbitalDefinition, OrbitalDefinitionSchema, type OrbitalEntity, type OrbitalEntityInput, OrbitalEntitySchema, type OrbitalInput, type OrbitalPage, type OrbitalPageInput, OrbitalPageSchema, type OrbitalPageStrictInput, OrbitalPageStrictSchema, type OrbitalSchema, type OrbitalSchemaInput, OrbitalSchemaSchema, type OrbitalTraitRef, OrbitalTraitRefSchema, type OrbitalUnit, OrbitalUnitSchema, OrbitalSchema$1 as OrbitalZodSchema, PATTERN_TYPES, type Page, type PageRef, type PageRefObject, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, type PageTraitRef, PageTraitRefSchema, type ParsedBinding, type PatternConfig, type PatternType, PatternTypeSchema, type PayloadField, PayloadFieldSchema, type PresentationType, type RelatedLink, RelatedLinkSchema, type RelationConfig, RelationConfigSchema, type RequiredField, RequiredFieldSchema, type ResolvedAsset, type ResolvedAssetInput, ResolvedAssetSchema, type ResolvedEntity, type ResolvedEntityBinding, type ResolvedField, type ResolvedIR, type ResolvedNavigation, type ResolvedPage, type ResolvedPattern, type ResolvedSection, type ResolvedSectionEvent, type ResolvedTrait, type ResolvedTraitBinding, type ResolvedTraitDataEntity, type ResolvedTraitEvent, type ResolvedTraitGuard, type ResolvedTraitListener, type ResolvedTraitState, type ResolvedTraitTick, type ResolvedTraitTransition, type ResolvedTraitUIBinding, type RestAuthConfig, RestAuthConfigSchema, type RestServiceDef, RestServiceDefSchema, SERVICE_TYPES, type SExpr, type SExprAtom, SExprAtomSchema, type SExprInput, SExprSchema, type SemanticAssetRef, type SemanticAssetRefInput, SemanticAssetRefSchema, type ServiceDefinition, ServiceDefinitionSchema, type ServiceRef, ServiceRefSchema, ServiceRefStringSchema, type ServiceType, ServiceTypeSchema, type SocketEvents, SocketEventsSchema, type SocketServiceDef, SocketServiceDefSchema, type State, type StateInput, type StateMachine, type StateMachineInput, StateMachineSchema, StateSchema, type StateSemanticRole, StateSemanticRoleSchema, type SuggestedGuard, SuggestedGuardSchema, type ThemeDefinition, ThemeDefinitionSchema, type ThemeRef, ThemeRefSchema, ThemeRefStringSchema, type ThemeTokens, ThemeTokensSchema, type ThemeVariant, ThemeVariantSchema, type Trait, type TraitCategory, TraitCategorySchema, type TraitDataEntity, TraitDataEntitySchema, type TraitEntityField, TraitEntityFieldSchema, type TraitEventContract, TraitEventContractSchema, type TraitEventListener, TraitEventListenerSchema, type TraitInput, type TraitRef, TraitRefSchema, type TraitReference, type TraitReferenceInput, TraitReferenceSchema, TraitSchema, type TraitTick, TraitTickSchema, type TraitUIBinding, type Transition, type TransitionFrom, type TransitionInput, TransitionSchema, type UISlot, UISlotSchema, UI_SLOTS, type UXHints, UXHintsSchema, type UseDeclaration, UseDeclarationSchema, type UserPersona, type UserPersonaInput, UserPersonaSchema, VISUAL_STYLES, type ViewFlow, type ViewType, ViewTypeSchema, type VisualStyle, VisualStyleSchema, callService, collectBindings, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createResolvedField, deriveCollection, despawn, doEffects, emit, findService, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getOperatorMeta, getOperatorsByCategory, getServiceNames, getTraitConfig, getTraitName, hasService, inferTsType, isBinding, isEffect, isEffectOperator, isEntityReference, isGuardOperator, isImportedTraitRef, isInlineTrait, isKnownOperator, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, isValidPatternType, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, renderUI, safeParseOrbitalSchema, set, sexpr, spawn, validateAssetAnimations, validateBindingInContext, validateOperatorArity, walkSExpr };
+export { ALLOWED_CUSTOM_COMPONENTS, type AllowedCustomComponent, type AnimationDef, type AnimationDefInput, AnimationDefSchema, type OrbitalSchema as AppSchema, type AssetMap, type AssetMapInput, AssetMapSchema, type AssetMapping, type AssetMappingInput, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, type BindingContext, BindingSchema, CORE_BINDINGS, type CallServiceConfig, type ComputedEventContract, ComputedEventContractSchema, type ComputedEventListener, ComputedEventListenerSchema, type CoreBinding, type CreateFlow, type CustomPatternDefinition, type CustomPatternDefinitionInput, CustomPatternDefinitionSchema, type CustomPatternMap, type CustomPatternMapInput, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, type DeleteFlow, type DesignPreferences, type DesignPreferencesInput, DesignPreferencesSchema, type DesignTokens, type DesignTokensInput, DesignTokensSchema, type DomainCategory, DomainCategorySchema, type DomainContext, type DomainContextInput, DomainContextSchema, type DomainVocabulary, DomainVocabularySchema, ENTITY_ROLES, type EditFlow, type Effect, type EffectInput, EffectSchema, type Entity, type EntityField, type EntityFieldInput, EntityFieldSchema, type EntityPersistence, EntityPersistenceSchema, type EntityRef, EntityRefSchema, EntityRefStringSchema, type EntityRole, EntityRoleSchema, EntitySchema, type EntitySemanticRole, EntitySemanticRoleSchema, type Event, type EventInput, type EventListener, EventListenerSchema, type EventPayloadField, EventPayloadFieldSchema, EventSchema, type EventScope, EventScopeSchema, type EventSemanticRole, EventSemanticRoleSchema, type EventSource, EventSourceSchema, type Expression, type ExpressionInput, ExpressionSchema, type Field, type FieldFormat, FieldFormatSchema, FieldSchema, type FieldType, FieldTypeSchema, type Orbital as FullOrbitalUnit, GAME_TYPES, type GameSubCategory, GameSubCategorySchema, type GameType, GameTypeSchema, type Guard, type GuardInput, GuardSchema, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type ListInteraction, type McpServiceDef, McpServiceDefSchema, type NodeClassification, NodeClassificationSchema, type OperatorName, type Orbital, type OrbitalConfig, type OrbitalConfigInput, OrbitalConfigSchema, type OrbitalDefinition, OrbitalDefinitionSchema, type OrbitalEntity, type OrbitalEntityInput, OrbitalEntitySchema, type OrbitalInput, type OrbitalPage, type OrbitalPageInput, OrbitalPageSchema, type OrbitalPageStrictInput, OrbitalPageStrictSchema, type OrbitalSchema, type OrbitalSchemaInput, OrbitalSchemaSchema, type OrbitalTraitRef, OrbitalTraitRefSchema, type OrbitalUnit, OrbitalUnitSchema, OrbitalSchema$1 as OrbitalZodSchema, type Page, type PageRef, type PageRefObject, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, type PageTraitRef, PageTraitRefSchema, type ParsedBinding, PatternTypeSchema, type PayloadField, PayloadFieldSchema, type PresentationType, type RelatedLink, RelatedLinkSchema, type RelationConfig, RelationConfigSchema, type RenderUIConfig, type RequiredField, RequiredFieldSchema, type ResolvedAsset, type ResolvedAssetInput, ResolvedAssetSchema, type ResolvedEntity, type ResolvedEntityBinding, type ResolvedField, type ResolvedIR, type ResolvedNavigation, type ResolvedPage, type ResolvedPattern, type ResolvedSection, type ResolvedSectionEvent, type ResolvedTrait, type ResolvedTraitBinding, type ResolvedTraitDataEntity, type ResolvedTraitEvent, type ResolvedTraitGuard, type ResolvedTraitListener, type ResolvedTraitState, type ResolvedTraitTick, type ResolvedTraitTransition, type ResolvedTraitUIBinding, type RestAuthConfig, RestAuthConfigSchema, type RestServiceDef, RestServiceDefSchema, SERVICE_TYPES, type SExpr, type SExprAtom, SExprAtomSchema, type SExprInput, SExprSchema, type SemanticAssetRef, type SemanticAssetRefInput, SemanticAssetRefSchema, type ServiceDefinition, ServiceDefinitionSchema, type ServiceRef, ServiceRefSchema, ServiceRefStringSchema, type ServiceType, ServiceTypeSchema, type SocketEvents, SocketEventsSchema, type SocketServiceDef, SocketServiceDefSchema, type State, type StateInput, type StateMachine, type StateMachineInput, StateMachineSchema, StateSchema, type StateSemanticRole, StateSemanticRoleSchema, type SuggestedGuard, SuggestedGuardSchema, type ThemeDefinition, ThemeDefinitionSchema, type ThemeRef, ThemeRefSchema, ThemeRefStringSchema, type ThemeTokens, ThemeTokensSchema, type ThemeVariant, ThemeVariantSchema, type Trait, type TraitCategory, TraitCategorySchema, type TraitDataEntity, TraitDataEntitySchema, type TraitEntityField, TraitEntityFieldSchema, type TraitEventContract, TraitEventContractSchema, type TraitEventListener, TraitEventListenerSchema, type TraitInput, type TraitRef, TraitRefSchema, type TraitReference, type TraitReferenceInput, TraitReferenceSchema, TraitSchema, type TraitTick, TraitTickSchema, type TraitUIBinding, type Transition, type TransitionFrom, type TransitionInput, TransitionSchema, type UISlot, UISlotSchema, UI_SLOTS, type UXHints, UXHintsSchema, type UseDeclaration, UseDeclarationSchema, type UserPersona, type UserPersonaInput, UserPersonaSchema, VISUAL_STYLES, type ViewFlow, type ViewType, ViewTypeSchema, type VisualStyle, VisualStyleSchema, callService, collectBindings, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createResolvedField, deriveCollection, despawn, doEffects, emit, findService, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getServiceNames, getTraitConfig, getTraitName, hasService, inferTsType, isBinding, isCircuitEvent, isEffect, isEntityReference, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, renderUI, safeParseOrbitalSchema, set, sexpr, spawn, validateAssetAnimations, validateBindingInContext, walkSExpr };