@almadar/core 9.0.0 → 9.1.0

package/dist/{compose-behaviors-9ZKmnI0e.d.ts → compose-behaviors-Bn9WPGfr.d.ts}

@@ -1,4 +1,4 @@
-import { aj as OrbitalDefinition, ar as OrbitalSchema } from './schema-B9mHgRPp.js';
+import { aD as OrbitalDefinition, aL as OrbitalSchema } from './schema-B6gRJD4J.js';
 
 /**
  * Event Wiring

package/dist/factory/index.d.ts

@@ -1,4 +1,4 @@
-import { by as TraitEventListener, F as EntityField, I as EntityPersistence, bD as TraitReference } from '../trait-C23jbaBB.js';
+import { bA as TraitEventListener, F as EntityField, K as EntityPersistence, bF as TraitReference } from '../trait-DvvM-71c.js';
 import { a as JsonValue } from '../json-lCu3FWzv.js';
 import 'zod';
 import '../expression-BVRFm0sV.js';
@@ -90,6 +90,23 @@ interface JsonSchema {
     oneOf?: ReadonlyArray<JsonSchema>;
     anyOf?: ReadonlyArray<JsonSchema>;
     default?: JsonValue;
+    /**
+     * Reference to a shared definition under `$defs` at the schema root.
+     * Lets consumers DRY large repeated subschemas (e.g. a 300-entry enum
+     * of std-behavior paths reused across every orbital branch of a tool
+     * schema). Per JSON Schema 2020-12: absolute reference starting with
+     * `#`. Standard OpenAI / DeepSeek strict-mode tool calling resolves
+     * `$ref` against `$defs` defined on the tool's parameters root.
+     */
+    $ref?: string;
+    /**
+     * Inline subschema definitions referenced from elsewhere via `$ref`.
+     * Lives at the schema root so all `$ref` paths can resolve. Values are
+     * full `JsonSchema` (can be referenced recursively).
+     */
+    $defs?: Readonly<{
+        [key: string]: JsonSchema;
+    }>;
     /** Knob's `@synonyms` from the source `.lolo`. */
     'x-synonyms'?: string;
     /** Knob's `@label` from the source `.lolo`. */
@@ -224,6 +241,23 @@ interface FactoryTraitSignature {
      *  header annotations. Free-form strings — the translator overlay
      *  matches rules to traits by exact set membership. */
     capabilities: ReadonlyArray<string>;
+    /** `true` when the source trait's entity binding was authored
+     *  `-> @rebindable Entity`. Only then may a consumer rebind it via
+     *  `traitOverrides.<name>.linkedEntity`; rabit enum-constrains that
+     *  override to the organism's entities and the validator enforces the
+     *  field contract. Absent/false = fixed binding. */
+    entityRebindable?: boolean;
+    /** Inferred field contract a rebind target must satisfy. `requires` =
+     *  fields the trait reads via `@entity.X`; `provides` = fields it writes.
+     *  Present only alongside `entityRebindable`. */
+    entityContract?: {
+        requires: ReadonlyArray<string>;
+        provides: ReadonlyArray<string>;
+    };
+    /** `@description` / `@synonyms` authored on the `@rebindable` binding —
+     *  fed to catalog prose + knob-embeddings for binding-discovery. */
+    entityBindingDescription?: string;
+    entityBindingSynonyms?: string;
 }
 /** One page the factory emits. The path is the factory default; the
  *  projector may override via `params.pagePaths`. */

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { ar as OrbitalSchema, aj as OrbitalDefinition } from './schema-B9mHgRPp.js';
-export { A as AGENT_DOMAIN_CATEGORIES, a as ALLOWED_CUSTOM_COMPONENTS, b as AgentDomainCategory, c as AgentDomainCategorySchema, d as AllowedCustomComponent, C as ComputedEventContract, e as ComputedEventContractSchema, f as ComputedEventListener, g as ComputedEventListenerSchema, h as CustomPatternDefinition, i as CustomPatternDefinitionInput, j as CustomPatternDefinitionSchema, k as CustomPatternMap, l as CustomPatternMapInput, m as CustomPatternMapSchema, D as DensityTokens, n as DensityTokensSchema, o as DesignPreferences, p as DesignPreferencesInput, q as DesignPreferencesSchema, r as DesignTokens, s as DesignTokensInput, t as DesignTokensSchema, u as DomainCategory, v as DomainCategorySchema, w as DomainContext, x as DomainContextInput, y as DomainContextSchema, z as DomainVocabulary, B as DomainVocabularySchema, E as ElevationTokens, F as ElevationTokensSchema, G as EntityCall, H as EntityCallSchema, I as EntityRef, J as EntityRefSchema, K as EntityRefStringSchema, L as EntitySemanticRole, M as EntitySemanticRoleSchema, N as EventListener, O as EventListenerSchema, P as EventSemanticRole, Q as EventSemanticRoleSchema, R as EventSource, S as EventSourceSchema, af as FullOrbitalUnit, T as GameSubCategory, U as GameSubCategorySchema, V as GeometryTokens, W as GeometryTokensSchema, X as IconFamily, Y as IconFamilySchema, Z as IconographyTokens, _ as IconographyTokensSchema, $ as MotionDurationKey, a0 as MotionDurationKeySchema, a1 as MotionDurationPalette, a2 as MotionDurationPaletteSchema, a3 as MotionEasingKey, a4 as MotionEasingKeySchema, a5 as MotionEasingPalette, a6 as MotionEasingPaletteSchema, a7 as MotionIntent, a8 as MotionIntentMap, a9 as MotionIntentMapSchema, aa as MotionIntentSchema, ab as MotionTokens, ac as MotionTokensSchema, ad as NodeClassification, ae as NodeClassificationSchema, af as Orbital, ag as OrbitalConfig, ah as OrbitalConfigInput, ai as OrbitalConfigSchema, ak as OrbitalDefinitionSchema, al as OrbitalInput, am as OrbitalPage, an as OrbitalPageInput, ao as OrbitalPageSchema, ap as OrbitalPageStrictInput, aq as OrbitalPageStrictSchema, at as OrbitalSchemaInput, au as OrbitalSchemaSchema, av as OrbitalSchemaWithTraits, aw as OrbitalUnit, ax as OrbitalUnitSchema, as as OrbitalZodSchema, ay as Page, az as PageRef, aA as PageRefObject, aB as PageRefObjectSchema, aC as PageRefSchema, aD as PageRefStringSchema, aE as PageSchema, aF as PageTraitRef, aG as PageTraitRefSchema, aH as RelatedLink, aI as RelatedLinkSchema, aJ as SpacingScale, aK as SpacingScaleSchema, aL as StateSemanticRole, aM as StateSemanticRoleSchema, aN as SuggestedGuard, aO as SuggestedGuardSchema, aP as ThemeDefinition, aQ as ThemeDefinitionSchema, aR as ThemeRef, aS as ThemeRefSchema, aT as ThemeRefStringSchema, aU as ThemeTokens, aV as ThemeTokensSchema, aW as ThemeVariant, aX as ThemeVariantSchema, aY as TypeIntent, aZ as TypeIntentMap, a_ as TypeIntentMapSchema, a$ as TypeIntentSchema, b0 as TypeScale, b1 as TypeScaleEntry, b2 as TypeScaleEntrySchema, b3 as TypeScaleSchema, b4 as TypeScaleTokens, b5 as TypeScaleTokensSchema, b6 as TypeSizeKey, b7 as TypeSizeKeySchema, b8 as TypeSlot, b9 as TypeSlotSchema, ba as TypeWeight, bb as TypeWeightSchema, bc as UXHints, bd as UXHintsSchema, be as UseDeclaration, bf as UseDeclarationSchema, bg as UserPersona, bh as UserPersonaInput, bi as UserPersonaSchema, bj as ViewType, bk as ViewTypeSchema, bl as isEntityCall, bm as isEntityReference, bn as isEntityReferenceAny, bo as isImportedTraitRef, bp as isOrbitalDefinition, bq as isPageReference, br as isPageReferenceObject, bs as isPageReferenceString, bt as isThemeReference, bu as parseEntityRef, bv as parseImportedTraitRef, bw as parseOrbitalSchema, bx as parsePageRef, by as safeParseOrbitalSchema } from './schema-B9mHgRPp.js';
-import { bb as State } from './trait-C23jbaBB.js';
-export { A as AgentEffect, a as AnimationDef, b as AnimationDefInput, c as AnimationDefSchema, d as ArrayEntityField, e as AssetMap, f as AssetMapInput, g as AssetMapSchema, h as AssetMapping, i as AssetMappingInput, j as AssetMappingSchema, k as AtomicEffect, C as CallServiceConfig, l as CallServiceEffect, m as CheckpointLoadEffect, n as CheckpointSaveEffect, o as ConfigFieldDeclaration, p as ConfigFieldDeclarationSchema, D as DeclaredTraitConfig, q as DeclaredTraitConfigSchema, r as DerefEffect, s as DespawnEffect, t as DoEffect, E as ENTITY_ROLES, u as Effect, v as EffectInput, w as EffectSchema, x as EmitConfig, y as EmitEffect, z as Entity, B as EntityData, F as EntityField, G as EntityFieldInput, H as EntityFieldSchema, I as EntityPersistence, J as EntityPersistenceSchema, K as EntityRole, L as EntityRoleSchema, M as EntityRow, N as EntitySchema, O as EnumEntityField, P as EvaluateConfig, Q as EvaluateEffect, R as Event, S as EventInput, T as EventPayloadField, U as EventPayloadFieldSchema, V as EventSchema, W as EventScope, X as EventScopeSchema, Y as FetchEffect, Z as FetchOptions, _ as FetchResult, $ as Field, a0 as FieldFormat, a1 as FieldFormatSchema, a2 as FieldSchema, a3 as FieldType, a4 as FieldTypeSchema, a5 as FieldValue, a6 as ForwardConfig, a7 as ForwardEffect, a8 as GAME_TYPES, a9 as GameType, aa as GameTypeSchema, ab as Guard, ac as GuardInput, ad as GuardSchema, ae as ListenSource, af as ListenSourceSchema, ag as LogEffect, ah as McpServiceDef, ai as McpServiceDefSchema, aj as NavigateEffect, ak as NnConfig, al as NnLayer, am as NotifyEffect, an as OrbitalEntity, ao as OrbitalEntityInput, ap as OrbitalEntitySchema, aq as OrbitalTraitRef, ar as OrbitalTraitRefSchema, as as OsEffect, at as PayloadField, au as PayloadFieldSchema, av as PersistData, aw as PersistEffect, ax as PersistEmitConfig, ay as PresentationType, az as RefEffect, aA as RelationConfig, aB as RelationConfigSchema, aC as RelationEntityField, aD as RenderItemLambda, aE as RenderUIConfig, aF as RenderUIEffect, aG as RenderUINode, aH as RequiredField, aI as RequiredFieldSchema, aJ as ResolvedAsset, aK as ResolvedAssetInput, aL as ResolvedAssetSchema, aM as ResolvedPatternProps, aN as RestAuthConfig, aO as RestAuthConfigSchema, aP as RestServiceDef, aQ as RestServiceDefSchema, aR as SERVICE_TYPES, aS as ScalarEntityField, aT as SemanticAssetRef, aU as SemanticAssetRefInput, aV as SemanticAssetRefSchema, aW as ServiceDefinition, aX as ServiceDefinitionSchema, aY as ServiceParams, aZ as ServiceParamsValue, a_ as ServiceRef, a$ as ServiceRefObject, b0 as ServiceRefObjectSchema, b1 as ServiceRefSchema, b2 as ServiceRefStringSchema, b3 as ServiceType, b4 as ServiceTypeSchema, b5 as SetEffect, b6 as SocketEvents, b7 as SocketEventsSchema, b8 as SocketServiceDef, b9 as SocketServiceDefSchema, ba as SpawnEffect, bc as StateInput, bd as StateMachine, be as StateMachineInput, bf as StateMachineSchema, bg as StateSchema, bh as SwapEffect, bi as TrainConfig, bj as TrainEffect, bk as Trait, bl as TraitCategory, bm as TraitCategorySchema, bn as TraitConfig, bo as TraitConfigObject, bp as TraitConfigSchema, bq as TraitConfigValue, br as TraitConfigValueSchema, bs as TraitDataEntity, bt as TraitDataEntitySchema, bu as TraitEntityField, bv as TraitEntityFieldSchema, bw as TraitEventContract, bx as TraitEventContractSchema, by as TraitEventListener, bz as TraitEventListenerSchema, bA as TraitInput, bB as TraitRef, bC as TraitRefSchema, bD as TraitReference, bE as TraitReferenceInput, bF as TraitReferenceSchema, bG as TraitSchema, bI as TraitTick, bJ as TraitTickSchema, bK as TraitUIBinding, bL as Transition, bM as TransitionInput, bN as TransitionSchema, bO as TypedEffect, bP as UISlot, bQ as UISlotSchema, bR as UI_SLOTS, bS as VISUAL_STYLES, bT as VisualStyle, bU as VisualStyleSchema, bV as WatchEffect, bW as WatchOptions, bX as atomic, bY as callService, bZ as createAssetKey, b_ as deref, b$ as deriveCollection, c0 as despawn, c1 as doEffects, c2 as emit, c3 as findService, c4 as getDefaultAnimationsForRole, c5 as getServiceNames, c6 as getTraitConfig, c7 as getTraitName, c8 as hasService, c9 as isCircuitEvent, ca as isEffect, cb as isInlineTrait, cc as isMcpService, cd as isRestService, ce as isRuntimeEntity, cf as isSExprEffect, cg as isServiceReference, ch as isServiceReferenceObject, ci as isSingletonEntity, cj as isSocketService, ck as navigate, cl as normalizeTraitRef, cm as notify, cn as parseAssetKey, co as parseServiceRef, cp as persist, cq as ref, cr as renderUI, cs as set, ct as spawn, cu as swap, cv as validateAssetAnimations, cw as watch } from './trait-C23jbaBB.js';
+import { aL as OrbitalSchema, aD as OrbitalDefinition } from './schema-B6gRJD4J.js';
+export { A as AGENT_DOMAIN_CATEGORIES, a as ALLOWED_CUSTOM_COMPONENTS, b as AgentDomainCategory, c as AgentDomainCategorySchema, d as AllowedCustomComponent, C as ColorSlice, e as ColorSliceSchema, f as ColorTokens, g as ColorTokensSchema, h as ComputedEventContract, i as ComputedEventContractSchema, j as ComputedEventListener, k as ComputedEventListenerSchema, l as CustomPatternDefinition, m as CustomPatternDefinitionInput, n as CustomPatternDefinitionSchema, o as CustomPatternMap, p as CustomPatternMapInput, q as CustomPatternMapSchema, D as DensitySlice, r as DensitySliceSchema, s as DensityTokens, t as DensityTokensSchema, u as DesignPreferences, v as DesignPreferencesInput, w as DesignPreferencesSchema, x as DesignTokens, y as DesignTokensInput, z as DesignTokensSchema, B as DomainCategory, E as DomainCategorySchema, F as DomainContext, G as DomainContextInput, H as DomainContextSchema, I as DomainVocabulary, J as DomainVocabularySchema, K as ElevationSlice, L as ElevationSliceSchema, M as ElevationTokens, N as ElevationTokensSchema, O as EntityCall, P as EntityCallSchema, Q as EntityRef, R as EntityRefSchema, S as EntityRefStringSchema, T as EntitySemanticRole, U as EntitySemanticRoleSchema, V as EventListener, W as EventListenerSchema, X as EventSemanticRole, Y as EventSemanticRoleSchema, Z as EventSource, _ as EventSourceSchema, az as FullOrbitalUnit, $ as GameSubCategory, a0 as GameSubCategorySchema, a1 as GeometrySlice, a2 as GeometrySliceSchema, a3 as GeometryTokens, a4 as GeometryTokensSchema, a5 as IconFamily, a6 as IconFamilySchema, a7 as IconographySlice, a8 as IconographySliceSchema, a9 as IconographyTokens, aa as IconographyTokensSchema, ab as IllustrationSlice, ac as IllustrationSliceSchema, ad as IllustrationStyle, ae as IllustrationStyleSchema, af as IllustrationTokens, ag as IllustrationTokensSchema, ah as MotionDurationKey, ai as MotionDurationKeySchema, aj as MotionDurationPalette, ak as MotionDurationPaletteSchema, al as MotionEasingKey, am as MotionEasingKeySchema, an as MotionEasingPalette, ao as MotionEasingPaletteSchema, ap as MotionIntent, aq as MotionIntentMap, ar as MotionIntentMapSchema, as as MotionIntentSchema, at as MotionSlice, au as MotionSliceSchema, av as MotionTokens, aw as MotionTokensSchema, ax as NodeClassification, ay as NodeClassificationSchema, az as Orbital, aA as OrbitalConfig, aB as OrbitalConfigInput, aC as OrbitalConfigSchema, aE as OrbitalDefinitionSchema, aF as OrbitalInput, aG as OrbitalPage, aH as OrbitalPageInput, aI as OrbitalPageSchema, aJ as OrbitalPageStrictInput, aK as OrbitalPageStrictSchema, aN as OrbitalSchemaInput, aO as OrbitalSchemaSchema, aP as OrbitalSchemaWithTraits, aQ as OrbitalUnit, aR as OrbitalUnitSchema, aM as OrbitalZodSchema, aS as Page, aT as PageRef, aU as PageRefObject, aV as PageRefObjectSchema, aW as PageRefSchema, aX as PageRefStringSchema, aY as PageSchema, aZ as PageTraitRef, a_ as PageTraitRefSchema, a$ as RelatedLink, b0 as RelatedLinkSchema, b1 as SkinSpec, b2 as SkinSpecSchema, b3 as SpacingScale, b4 as SpacingScaleSchema, b5 as StateSemanticRole, b6 as StateSemanticRoleSchema, b7 as SuggestedGuard, b8 as SuggestedGuardSchema, b9 as ThemeDefinition, ba as ThemeDefinitionSchema, bb as ThemeRef, bc as ThemeRefSchema, bd as ThemeRefStringSchema, be as ThemeTokens, bf as ThemeTokensSchema, bg as ThemeVariant, bh as ThemeVariantSchema, bi as TypeIntent, bj as TypeIntentMap, bk as TypeIntentMapSchema, bl as TypeIntentSchema, bm as TypeScale, bn as TypeScaleEntry, bo as TypeScaleEntrySchema, bp as TypeScaleSchema, bq as TypeScaleTokens, br as TypeScaleTokensSchema, bs as TypeSizeKey, bt as TypeSizeKeySchema, bu as TypeSlice, bv as TypeSliceSchema, bw as TypeSlot, bx as TypeSlotSchema, by as TypeWeight, bz as TypeWeightSchema, bA as UXHints, bB as UXHintsSchema, bC as UseDeclaration, bD as UseDeclarationSchema, bE as UserPersona, bF as UserPersonaInput, bG as UserPersonaSchema, bH as ViewType, bI as ViewTypeSchema, bJ as isEntityCall, bK as isEntityReference, bL as isEntityReferenceAny, bM as isImportedTraitRef, bN as isOrbitalDefinition, bO as isPageReference, bP as isPageReferenceObject, bQ as isPageReferenceString, bR as isThemeReference, bS as parseEntityRef, bT as parseImportedTraitRef, bU as parseOrbitalSchema, bV as parsePageRef, bW as safeParseOrbitalSchema } from './schema-B6gRJD4J.js';
+import { bd as State } from './trait-DvvM-71c.js';
+export { A as AgentEffect, a as AnimationDef, b as AnimationDefInput, c as AnimationDefSchema, d as ArrayEntityField, e as AssetMap, f as AssetMapInput, g as AssetMapSchema, h as AssetMapping, i as AssetMappingInput, j as AssetMappingSchema, k as AtomicEffect, C as CallServiceConfig, l as CallServiceEffect, m as CheckpointLoadEffect, n as CheckpointSaveEffect, o as ConfigFieldDeclaration, p as ConfigFieldDeclarationSchema, D as DeclaredTraitConfig, q as DeclaredTraitConfigSchema, r as DerefEffect, s as DespawnEffect, t as DoEffect, E as ENTITY_ROLES, u as Effect, v as EffectInput, w as EffectSchema, x as EmitConfig, y as EmitEffect, z as Entity, B as EntityData, F as EntityField, G as EntityFieldContract, H as EntityFieldContractSchema, I as EntityFieldInput, J as EntityFieldSchema, K as EntityPersistence, L as EntityPersistenceSchema, M as EntityRole, N as EntityRoleSchema, O as EntityRow, P as EntitySchema, Q as EnumEntityField, R as EvaluateConfig, S as EvaluateEffect, T as Event, U as EventInput, V as EventPayloadField, W as EventPayloadFieldSchema, X as EventSchema, Y as EventScope, Z as EventScopeSchema, _ as FetchEffect, $ as FetchOptions, a0 as FetchResult, a1 as Field, a2 as FieldFormat, a3 as FieldFormatSchema, a4 as FieldSchema, a5 as FieldType, a6 as FieldTypeSchema, a7 as FieldValue, a8 as ForwardConfig, a9 as ForwardEffect, aa as GAME_TYPES, ab as GameType, ac as GameTypeSchema, ad as Guard, ae as GuardInput, af as GuardSchema, ag as ListenSource, ah as ListenSourceSchema, ai as LogEffect, aj as McpServiceDef, ak as McpServiceDefSchema, al as NavigateEffect, am as NnConfig, an as NnLayer, ao as NotifyEffect, ap as OrbitalEntity, aq as OrbitalEntityInput, ar as OrbitalEntitySchema, as as OrbitalTraitRef, at as OrbitalTraitRefSchema, au as OsEffect, av as PayloadField, aw as PayloadFieldSchema, ax as PersistData, ay as PersistEffect, az as PersistEmitConfig, aA as PresentationType, aB as RefEffect, aC as RelationConfig, aD as RelationConfigSchema, aE as RelationEntityField, aF as RenderItemLambda, aG as RenderUIConfig, aH as RenderUIEffect, aI as RenderUINode, aJ as RequiredField, aK as RequiredFieldSchema, aL as ResolvedAsset, aM as ResolvedAssetInput, aN as ResolvedAssetSchema, aO as ResolvedPatternProps, aP as RestAuthConfig, aQ as RestAuthConfigSchema, aR as RestServiceDef, aS as RestServiceDefSchema, aT as SERVICE_TYPES, aU as ScalarEntityField, aV as SemanticAssetRef, aW as SemanticAssetRefInput, aX as SemanticAssetRefSchema, aY as ServiceDefinition, aZ as ServiceDefinitionSchema, a_ as ServiceParams, a$ as ServiceParamsValue, b0 as ServiceRef, b1 as ServiceRefObject, b2 as ServiceRefObjectSchema, b3 as ServiceRefSchema, b4 as ServiceRefStringSchema, b5 as ServiceType, b6 as ServiceTypeSchema, b7 as SetEffect, b8 as SocketEvents, b9 as SocketEventsSchema, ba as SocketServiceDef, bb as SocketServiceDefSchema, bc as SpawnEffect, be as StateInput, bf as StateMachine, bg as StateMachineInput, bh as StateMachineSchema, bi as StateSchema, bj as SwapEffect, bk as TrainConfig, bl as TrainEffect, bm as Trait, bn as TraitCategory, bo as TraitCategorySchema, bp as TraitConfig, bq as TraitConfigObject, br as TraitConfigSchema, bs as TraitConfigValue, bt as TraitConfigValueSchema, bu as TraitDataEntity, bv as TraitDataEntitySchema, bw as TraitEntityField, bx as TraitEntityFieldSchema, by as TraitEventContract, bz as TraitEventContractSchema, bA as TraitEventListener, bB as TraitEventListenerSchema, bC as TraitInput, bD as TraitRef, bE as TraitRefSchema, bF as TraitReference, bG as TraitReferenceInput, bH as TraitReferenceSchema, bI as TraitSchema, bK as TraitTick, bL as TraitTickSchema, bM as TraitUIBinding, bN as Transition, bO as TransitionInput, bP as TransitionSchema, bQ as TypedEffect, bR as UISlot, bS as UISlotSchema, bT as UI_SLOTS, bU as VISUAL_STYLES, bV as VisualStyle, bW as VisualStyleSchema, bX as WatchEffect, bY as WatchOptions, bZ as atomic, b_ as callService, b$ as createAssetKey, c0 as deref, c1 as deriveCollection, c2 as despawn, c3 as doEffects, c4 as emit, c5 as findService, c6 as getDefaultAnimationsForRole, c7 as getServiceNames, c8 as getTraitConfig, c9 as getTraitName, ca as hasService, cb as isCircuitEvent, cc as isEffect, cd as isInlineTrait, ce as isMcpService, cf as isRestService, cg as isRuntimeEntity, ch as isSExprEffect, ci as isServiceReference, cj as isServiceReferenceObject, ck as isSingletonEntity, cl as isSocketService, cm as navigate, cn as normalizeTraitRef, co as notify, cp as parseAssetKey, cq as parseServiceRef, cr as persist, cs as ref, ct as renderUI, cu as set, cv as spawn, cw as swap, cx as validateAssetAnimations, cy as watch } from './trait-DvvM-71c.js';
 export { C as CORE_BINDINGS, a as CoreBinding, E as EvalContext, b as EventPayload, c as EventPayloadValue, d as Expression, e as ExpressionInput, f as ExpressionSchema, L as LogMeta, P as ParsedBinding, S as SExpr, g as SExprAtom, h as SExprAtomSchema, i as SExprInput, j as SExprSchema, k as collectBindings, l as getArgs, m as getOperator, n as isBinding, o as isSExpr, p as isSExprAtom, q as isSExprCall, r as isValidBinding, s as parseBinding, t as sexpr, w as walkSExpr } from './expression-BVRFm0sV.js';
 import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, ChangesetValue, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
 export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BusEvent, BusEventListener, BusEventSource, ChangeAuthor, ChangeSetDocument, ChangeSummary, CheckStatus, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, EffectTrace, EventEmit, EventKey, EventListen, EventLogEntry, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, KnownValidationErrorCode, LazyService, ListInteraction, OrbitalVerificationAPI, ParsedDesign, ParsedDomainContext, ParsedEmitDeclaration, ParsedEntity, ParsedEvent, ParsedListenDeclaration, ParsedOrbital, ParsedPage, ParsedState, ParsedStateMachine, ParsedTrait, ParsedTraitConfig, ParsedTransition, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SemanticChangeKind, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, ValidationDocument, ValidationError, ValidationErrorCode, ValidationIssue, ValidationMeta, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext } from './types/index.js';
 export { J as JsonObject, a as JsonValue, T as ToolArgs, i as isJsonArray, b as isJsonObject, c as isJsonPrimitive } from './json-lCu3FWzv.js';
 export { CallSiteDiff, DomainQuestion, DomainQuestionAnswer, DomainQuestionAnswers, DomainQuestionInputType, FactoryCallPlanMutation, FactoryCallPlanMutationTemplate, FactoryCallPlanState, FactoryCallSite, FactoryCallSiteParams, FactoryConfigParam, FactoryConfigTier, FactoryEntitySignature, FactoryPageSignature, FactoryParamValue, FactorySignature, FactorySignatureCatalog, FactorySignatureEntityField, FactoryTraitSignature, JsonSchema, JsonSchemaType, OrbitalCallInput, OwnershipOverlayEntry, PresentationNavItem, PresentationOverlay, RuleOverlay, RuleOverlayEntry, SchemaFieldType, TraitOverlay, TraitOverlayEntry, TraitOverlayListener, TranslationBinding, TranslationResult, TranslationWarning, answerToMutations, answersToMutations, applyFactoryCallPlanMutation, deriveInputType, diffFactoryCalls, generateQuestions, translateOverlaysToParams } from './factory/index.js';
-export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-9ZKmnI0e.js';
+export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-Bn9WPGfr.js';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';
 import 'zod';

package/dist/index.js

@@ -650,6 +650,10 @@ var TraitReferenceSchema = z.object({
   }
 );
 var TraitScopeSchema = z.enum(["instance", "collection"]);
+var EntityFieldContractSchema = z.object({
+  requires: z.array(z.string()),
+  provides: z.array(z.string())
+});
 var SourceBehaviorMetadataSchema = z.object({
   behavior: z.string().min(1),
   alias: z.string().min(1),
@@ -660,6 +664,10 @@ var TraitSchema = z.object({
   description: z.string().optional(),
   description_visual_prompt: z.string().optional(),
   category: TraitCategorySchema.optional(),
+  entityRebindable: z.boolean().optional(),
+  entityContract: EntityFieldContractSchema.optional(),
+  entityBindingDescription: z.string().optional(),
+  entityBindingSynonyms: z.string().optional(),
   capabilities: z.array(z.string()).optional(),
   scope: TraitScopeSchema,
   linkedEntity: z.string().optional(),
@@ -1022,31 +1030,84 @@ var GeometryTokensSchema = z.object({
   borderStandard: z.string().optional(),
   borderHeavy: z.string().optional()
 });
+var ColorTokensSchema = z.object({
+  primary: z.string().optional(),
+  primaryHover: z.string().optional(),
+  primaryForeground: z.string().optional(),
+  secondary: z.string().optional(),
+  secondaryHover: z.string().optional(),
+  secondaryForeground: z.string().optional(),
+  accent: z.string().optional(),
+  accentForeground: z.string().optional(),
+  muted: z.string().optional(),
+  mutedForeground: z.string().optional(),
+  background: z.string().optional(),
+  foreground: z.string().optional(),
+  card: z.string().optional(),
+  cardForeground: z.string().optional(),
+  surface: z.string().optional(),
+  border: z.string().optional(),
+  input: z.string().optional(),
+  ring: z.string().optional(),
+  error: z.string().optional(),
+  errorForeground: z.string().optional(),
+  success: z.string().optional(),
+  successForeground: z.string().optional(),
+  warning: z.string().optional(),
+  warningForeground: z.string().optional(),
+  info: z.string().optional(),
+  infoForeground: z.string().optional(),
+  tableHeader: z.string().optional(),
+  tableBorder: z.string().optional(),
+  tableRowHover: z.string().optional(),
+  surfaceHover: z.string().optional(),
+  borderHover: z.string().optional(),
+  placeholder: z.string().optional()
+});
+var IllustrationStyleSchema = z.enum([
+  "minimal",
+  "illustrated",
+  "photo",
+  "text-only",
+  "mascot"
+]);
+var IllustrationTokensSchema = z.object({
+  style: IllustrationStyleSchema.optional(),
+  emptyAsset: z.string().optional(),
+  loadingAsset: z.string().optional(),
+  errorAsset: z.string().optional(),
+  onboardingAsset: z.string().optional()
+});
 var ThemeTokensSchema = z.object({
-  colors: z.record(z.string(), z.string()).optional(),
-  radii: z.record(z.string(), z.string()).optional(),
-  spacing: z.record(z.string(), z.string()).optional(),
-  typography: z.record(z.string(), z.string()).optional(),
-  shadows: z.record(z.string(), z.string()).optional(),
+  color: ColorTokensSchema.optional(),
   density: DensityTokensSchema.optional(),
   typeScale: TypeScaleTokensSchema.optional(),
   motion: MotionTokensSchema.optional(),
   iconography: IconographyTokensSchema.optional(),
   elevation: ElevationTokensSchema.optional(),
-  geometry: GeometryTokensSchema.optional()
-});
-var ThemeVariantSchema = z.object({
+  geometry: GeometryTokensSchema.optional(),
+  illustration: IllustrationTokensSchema.optional(),
+  // Legacy
   colors: z.record(z.string(), z.string()).optional(),
   radii: z.record(z.string(), z.string()).optional(),
   spacing: z.record(z.string(), z.string()).optional(),
   typography: z.record(z.string(), z.string()).optional(),
-  shadows: z.record(z.string(), z.string()).optional(),
+  shadows: z.record(z.string(), z.string()).optional()
+});
+var ThemeVariantSchema = z.object({
+  color: ColorTokensSchema.optional(),
   density: DensityTokensSchema.optional(),
   typeScale: TypeScaleTokensSchema.optional(),
   motion: MotionTokensSchema.optional(),
   iconography: IconographyTokensSchema.optional(),
   elevation: ElevationTokensSchema.optional(),
-  geometry: GeometryTokensSchema.optional()
+  geometry: GeometryTokensSchema.optional(),
+  illustration: IllustrationTokensSchema.optional(),
+  colors: z.record(z.string(), z.string()).optional(),
+  radii: z.record(z.string(), z.string()).optional(),
+  spacing: z.record(z.string(), z.string()).optional(),
+  typography: z.record(z.string(), z.string()).optional(),
+  shadows: z.record(z.string(), z.string()).optional()
 });
 var ThemeDefinitionSchema = z.object({
   name: z.string().min(1, "Theme name is required"),
@@ -1064,6 +1125,15 @@ var ThemeRefSchema = z.union([
   ThemeDefinitionSchema,
   ThemeRefStringSchema
 ]);
+var SkinSpecSchema = ThemeDefinitionSchema;
+var ColorSliceSchema = ColorTokensSchema;
+var DensitySliceSchema = DensityTokensSchema;
+var TypeSliceSchema = TypeScaleTokensSchema;
+var GeometrySliceSchema = GeometryTokensSchema;
+var ElevationSliceSchema = ElevationTokensSchema;
+var MotionSliceSchema = MotionTokensSchema;
+var IconographySliceSchema = IconographyTokensSchema;
+var IllustrationSliceSchema = IllustrationTokensSchema;
 var DesignTokensSchema = z.record(z.string(), z.record(z.string(), z.string())).optional();
 var ALLOWED_CUSTOM_COMPONENTS = [
   "div",
@@ -3948,6 +4018,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographyTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionTokensSchema, 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, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, extractPayloadFieldRef, findService, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEntity, getInteractionModelForDomain, getOperator, getPage, getPages, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, ref, renderUI, requiresConfirmation, safeParseOrbitalSchema, schemaToIR, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, 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, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, extractPayloadFieldRef, findService, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEntity, getInteractionModelForDomain, getOperator, getPage, getPages, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, ref, renderUI, requiresConfirmation, safeParseOrbitalSchema, schemaToIR, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map