@almadar/core 1.0.1 → 1.0.9

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

@@ -1,7 +1,7 @@
-export { CATEGORIES, CategoryMeta, OPERATORS, OPERATORS_SCHEMA, OPERATOR_NAMES, OperatorCategory, OperatorMeta, OperatorStats, OperatorsSchema, TargetPlatform, getOperatorMeta, getOperatorStats, getOperatorsByCategory, getOperatorsForTarget, isEffectOperator, isGuardOperator, isKnownOperator, validateOperatorArity } from '@almadar/operators';
+import { z } from 'zod';
 import { AnyPatternConfig } from '@almadar/patterns';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
-import { z } from 'zod';
+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
@@ -585,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 */
@@ -601,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>;
@@ -629,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;
@@ -645,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;
@@ -666,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>;
@@ -694,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;
@@ -710,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;
@@ -961,6 +969,22 @@ declare const UI_SLOTS: readonly ["main", "sidebar", "modal", "drawer", "overlay
 type UISlot = (typeof UI_SLOTS)[number];
 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"]>;
 
+/**
+ * Configuration for render-ui effect.
+ * Used in runtime to specify which slot and pattern to render.
+ */
+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
  */
@@ -1596,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
@@ -5036,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>;
@@ -5064,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;
@@ -5080,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;
@@ -5767,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>;
@@ -5795,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;
@@ -5811,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;
@@ -6676,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;
@@ -6932,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;
@@ -7402,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>;
@@ -7430,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;
@@ -7446,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;
@@ -8311,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;
@@ -8567,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;
@@ -9044,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>;
@@ -9072,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;
@@ -9088,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;
@@ -9953,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;
@@ -10209,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;
@@ -10927,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>;
@@ -10955,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;
@@ -10971,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;
@@ -11836,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;
@@ -12092,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;
@@ -12526,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;
@@ -12871,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;
@@ -13224,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;
@@ -13569,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;
@@ -14162,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[];
@@ -14381,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, 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 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, 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 };
+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 };

package/dist/{src/types → types}/index.js

@@ -162,6 +162,7 @@ var OrbitalEntitySchema = z.object({
   persistence: EntityPersistenceSchema.default("persistent"),
   collection: z.string().optional(),
   fields: z.array(EntityFieldSchema).min(1, "At least one field is required"),
+  instances: z.array(z.record(z.unknown())).optional(),
   timestamps: z.boolean().optional(),
   softDelete: z.boolean().optional(),
   description: z.string().optional(),
@@ -416,6 +417,9 @@ var StateMachineSchema = z.object({
   transitions: z.array(TransitionSchema),
   guards: z.array(GuardSchema).optional()
 });
+function isCircuitEvent(event) {
+  return !event.startsWith("_");
+}
 
 // src/types/trait.ts
 var TraitCategorySchema = z.enum([
@@ -1144,6 +1148,6 @@ function isResolvedIR(ir) {
   return typeof r.appName === "string" && r.traits instanceof Map && r.pages instanceof Map;
 }
 
-export { ALLOWED_CUSTOM_COMPONENTS, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, McpServiceDefSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, 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, 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 };
+export { ALLOWED_CUSTOM_COMPONENTS, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, McpServiceDefSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map