@almadar/core 2.13.0 → 2.14.1

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { c as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-D3qNm2Ac.js';
-export { A as AGENT_DOMAIN_CATEGORIES, f as ALLOWED_CUSTOM_COMPONENTS, g as AgentDomainCategory, h as AgentDomainCategorySchema, i as AgentEffect, j as AllowedCustomComponent, k as AnimationDef, l as AnimationDefInput, m as AnimationDefSchema, n as AssetMap, o as AssetMapInput, p as AssetMapSchema, q as AssetMapping, r as AssetMappingInput, s as AssetMappingSchema, t as AtomicEffect, C as CORE_BINDINGS, u as CallServiceConfig, v as ComputedEventContract, w as ComputedEventContractSchema, x as ComputedEventListener, y as ComputedEventListenerSchema, z as CoreBinding, B as CustomPatternDefinition, D as CustomPatternDefinitionInput, F as CustomPatternDefinitionSchema, G as CustomPatternMap, H as CustomPatternMapInput, I as CustomPatternMapSchema, J as DerefEffect, K as DesignPreferences, L as DesignPreferencesInput, M as DesignPreferencesSchema, N as DesignTokens, Q as DesignTokensInput, R as DesignTokensSchema, U as DomainCategory, V as DomainCategorySchema, W as DomainContext, X as DomainContextInput, Y as DomainContextSchema, Z as DomainVocabulary, _ as DomainVocabularySchema, $ as ENTITY_ROLES, a0 as Effect, a1 as EffectInput, a2 as EffectSchema, e as Entity, a3 as EntityData, E as EntityField, a4 as EntityFieldInput, a5 as EntityFieldSchema, a as EntityPersistence, a6 as EntityPersistenceSchema, a7 as EntityRef, a8 as EntityRefSchema, a9 as EntityRefStringSchema, aa as EntityRole, ab as EntityRoleSchema, b as EntityRow, ac as EntitySchema, ad as EntitySemanticRole, ae as EntitySemanticRoleSchema, af as EvalContext, ag as Event, ah as EventInput, ai as EventListener, aj as EventListenerSchema, ak as EventPayload, al as EventPayloadField, am as EventPayloadFieldSchema, an as EventSchema, ao as EventScope, ap as EventScopeSchema, aq as EventSemanticRole, ar as EventSemanticRoleSchema, as as EventSource, at as EventSourceSchema, au as Expression, av as ExpressionInput, aw as ExpressionSchema, ax as Field, ay as FieldFormat, az as FieldFormatSchema, aA as FieldSchema, aB as FieldType, aC as FieldTypeSchema, aD as FieldValue, aE as FullOrbitalUnit, aF as GAME_TYPES, aG as GameSubCategory, aH as GameSubCategorySchema, aI as GameType, aJ as GameTypeSchema, aK as Guard, aL as GuardInput, aM as GuardSchema, aN as LogMeta, aO as McpServiceDef, aP as McpServiceDefSchema, aQ as NodeClassification, aR as NodeClassificationSchema, aE as Orbital, aS as OrbitalConfig, aT as OrbitalConfigInput, aU as OrbitalConfigSchema, aV as OrbitalDefinitionSchema, aW as OrbitalEntity, aX as OrbitalEntityInput, aY as OrbitalEntitySchema, aZ as OrbitalInput, a_ as OrbitalPage, a$ as OrbitalPageInput, b0 as OrbitalPageSchema, b1 as OrbitalPageStrictInput, b2 as OrbitalPageStrictSchema, b3 as OrbitalSchemaInput, b4 as OrbitalSchemaSchema, b5 as OrbitalTraitRef, b6 as OrbitalTraitRefSchema, b7 as OrbitalUnit, b8 as OrbitalUnitSchema, b9 as OrbitalZodSchema, P as Page, ba as PageRef, bb as PageRefObject, bc as PageRefObjectSchema, bd as PageRefSchema, be as PageRefStringSchema, bf as PageSchema, bg as PageTraitRef, bh as PageTraitRefSchema, bi as ParsedBinding, bj as PayloadField, bk as PayloadFieldSchema, bl as PresentationType, bm as RefEffect, bn as RelatedLink, bo as RelatedLinkSchema, bp as RelationConfig, bq as RelationConfigSchema, br as RenderUIConfig, bs as RenderUINode, bt as RequiredField, bu as RequiredFieldSchema, bv as ResolvedAsset, bw as ResolvedAssetInput, bx as ResolvedAssetSchema, by as ResolvedPatternProps, bz as RestAuthConfig, bA as RestAuthConfigSchema, bB as RestServiceDef, bC as RestServiceDefSchema, bD as SERVICE_TYPES, bE as SExpr, bF as SExprAtom, bG as SExprAtomSchema, bH as SExprInput, bI as SExprSchema, bJ as SemanticAssetRef, bK as SemanticAssetRefInput, bL as SemanticAssetRefSchema, bM as ServiceDefinition, bN as ServiceDefinitionSchema, bO as ServiceParams, bP as ServiceRef, bQ as ServiceRefSchema, bR as ServiceRefStringSchema, bS as ServiceType, bT as ServiceTypeSchema, bU as SocketEvents, bV as SocketEventsSchema, bW as SocketServiceDef, bX as SocketServiceDefSchema, bY as StateInput, bZ as StateMachine, b_ as StateMachineInput, b$ as StateMachineSchema, c0 as StateSchema, c1 as StateSemanticRole, c2 as StateSemanticRoleSchema, c3 as SuggestedGuard, c4 as SuggestedGuardSchema, c5 as SwapEffect, c6 as ThemeDefinition, c7 as ThemeDefinitionSchema, c8 as ThemeRef, c9 as ThemeRefSchema, ca as ThemeRefStringSchema, cb as ThemeTokens, cc as ThemeTokensSchema, cd as ThemeVariant, ce as ThemeVariantSchema, d as Trait, cf as TraitCategory, cg as TraitCategorySchema, ch as TraitDataEntity, ci as TraitDataEntitySchema, cj as TraitEntityField, ck as TraitEntityFieldSchema, T as TraitEventContract, cl as TraitEventContractSchema, cm as TraitEventListener, cn as TraitEventListenerSchema, co as TraitInput, cp as TraitRef, cq as TraitRefSchema, cr as TraitReference, cs as TraitReferenceInput, ct as TraitReferenceSchema, cu as TraitSchema, cv as TraitTick, cw as TraitTickSchema, cx as TraitUIBinding, cy as Transition, cz as TransitionInput, cA as TransitionSchema, cB as UISlot, cC as UISlotSchema, cD as UI_SLOTS, cE as UXHints, cF as UXHintsSchema, cG as UseDeclaration, cH as UseDeclarationSchema, cI as UserPersona, cJ as UserPersonaInput, cK as UserPersonaSchema, cL as VISUAL_STYLES, cM as ViewType, cN as ViewTypeSchema, cO as VisualStyle, cP as VisualStyleSchema, cQ as WatchEffect, cR as WatchOptions, cS as atomic, cT as callService, cU as collectBindings, cV as createAssetKey, cW as deref, cX as deriveCollection, cY as despawn, cZ as doEffects, c_ as emit, c$ as findService, d0 as getArgs, d1 as getDefaultAnimationsForRole, d2 as getOperator, d3 as getServiceNames, d4 as getTraitConfig, d5 as getTraitName, d6 as hasService, d7 as isBinding, d8 as isCircuitEvent, d9 as isEffect, da as isEntityReference, db as isImportedTraitRef, dc as isInlineTrait, dd as isMcpService, de as isOrbitalDefinition, df as isPageReference, dg as isPageReferenceObject, dh as isPageReferenceString, di as isRestService, dj as isRuntimeEntity, dk as isSExpr, dl as isSExprAtom, dm as isSExprCall, dn as isSExprEffect, dp as isServiceReference, dq as isSingletonEntity, dr as isSocketService, ds as isThemeReference, dt as isValidBinding, du as navigate, dv as normalizeTraitRef, dw as notify, dx as parseAssetKey, dy as parseBinding, dz as parseEntityRef, dA as parseImportedTraitRef, dB as parseOrbitalSchema, dC as parsePageRef, dD as parseServiceRef, dE as persist, dF as ref, dG as renderUI, dH as safeParseOrbitalSchema, dI as set, dJ as sexpr, dK as spawn, dL as swap, dM as validateAssetAnimations, dN as walkSExpr, dO as watch } from './schema-D3qNm2Ac.js';
-import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, SchemaChange, CategorizedRemovals, PageContentReduction } from './types/index.js';
-export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingContext, BindingSchema, ChangeAuthor, ChangeSetDocument, ChangeSummary, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, LazyService, ListInteraction, OperatorName, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TransitionFrom, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllOperators, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, validateBindingInContext } from './types/index.js';
+import { c as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-BFnZrBhm.js';
+export { A as AGENT_DOMAIN_CATEGORIES, f as ALLOWED_CUSTOM_COMPONENTS, g as AgentDomainCategory, h as AgentDomainCategorySchema, i as AgentEffect, j as AllowedCustomComponent, k as AnimationDef, l as AnimationDefInput, m as AnimationDefSchema, n as AssetMap, o as AssetMapInput, p as AssetMapSchema, q as AssetMapping, r as AssetMappingInput, s as AssetMappingSchema, t as AtomicEffect, C as CORE_BINDINGS, u as CallServiceConfig, v as ComputedEventContract, w as ComputedEventContractSchema, x as ComputedEventListener, y as ComputedEventListenerSchema, z as CoreBinding, B as CustomPatternDefinition, D as CustomPatternDefinitionInput, F as CustomPatternDefinitionSchema, G as CustomPatternMap, H as CustomPatternMapInput, I as CustomPatternMapSchema, J as DerefEffect, K as DesignPreferences, L as DesignPreferencesInput, M as DesignPreferencesSchema, N as DesignTokens, Q as DesignTokensInput, R as DesignTokensSchema, U as DomainCategory, V as DomainCategorySchema, W as DomainContext, X as DomainContextInput, Y as DomainContextSchema, Z as DomainVocabulary, _ as DomainVocabularySchema, $ as ENTITY_ROLES, a0 as Effect, a1 as EffectInput, a2 as EffectSchema, e as Entity, a3 as EntityData, E as EntityField, a4 as EntityFieldInput, a5 as EntityFieldSchema, a as EntityPersistence, a6 as EntityPersistenceSchema, a7 as EntityRef, a8 as EntityRefSchema, a9 as EntityRefStringSchema, aa as EntityRole, ab as EntityRoleSchema, b as EntityRow, ac as EntitySchema, ad as EntitySemanticRole, ae as EntitySemanticRoleSchema, af as EvalContext, ag as Event, ah as EventInput, ai as EventListener, aj as EventListenerSchema, ak as EventPayload, al as EventPayloadField, am as EventPayloadFieldSchema, an as EventSchema, ao as EventScope, ap as EventScopeSchema, aq as EventSemanticRole, ar as EventSemanticRoleSchema, as as EventSource, at as EventSourceSchema, au as Expression, av as ExpressionInput, aw as ExpressionSchema, ax as Field, ay as FieldFormat, az as FieldFormatSchema, aA as FieldSchema, aB as FieldType, aC as FieldTypeSchema, aD as FieldValue, aE as FullOrbitalUnit, aF as GAME_TYPES, aG as GameSubCategory, aH as GameSubCategorySchema, aI as GameType, aJ as GameTypeSchema, aK as Guard, aL as GuardInput, aM as GuardSchema, aN as LogMeta, aO as McpServiceDef, aP as McpServiceDefSchema, aQ as NodeClassification, aR as NodeClassificationSchema, aE as Orbital, aS as OrbitalConfig, aT as OrbitalConfigInput, aU as OrbitalConfigSchema, aV as OrbitalDefinitionSchema, aW as OrbitalEntity, aX as OrbitalEntityInput, aY as OrbitalEntitySchema, aZ as OrbitalInput, a_ as OrbitalPage, a$ as OrbitalPageInput, b0 as OrbitalPageSchema, b1 as OrbitalPageStrictInput, b2 as OrbitalPageStrictSchema, b3 as OrbitalSchemaInput, b4 as OrbitalSchemaSchema, b5 as OrbitalTraitRef, b6 as OrbitalTraitRefSchema, b7 as OrbitalUnit, b8 as OrbitalUnitSchema, b9 as OrbitalZodSchema, P as Page, ba as PageRef, bb as PageRefObject, bc as PageRefObjectSchema, bd as PageRefSchema, be as PageRefStringSchema, bf as PageSchema, bg as PageTraitRef, bh as PageTraitRefSchema, bi as ParsedBinding, bj as PayloadField, bk as PayloadFieldSchema, bl as PresentationType, bm as RefEffect, bn as RelatedLink, bo as RelatedLinkSchema, bp as RelationConfig, bq as RelationConfigSchema, br as RenderUIConfig, bs as RenderUINode, bt as RequiredField, bu as RequiredFieldSchema, bv as ResolvedAsset, bw as ResolvedAssetInput, bx as ResolvedAssetSchema, by as ResolvedPatternProps, bz as RestAuthConfig, bA as RestAuthConfigSchema, bB as RestServiceDef, bC as RestServiceDefSchema, bD as SERVICE_TYPES, bE as SExpr, bF as SExprAtom, bG as SExprAtomSchema, bH as SExprInput, bI as SExprSchema, bJ as SemanticAssetRef, bK as SemanticAssetRefInput, bL as SemanticAssetRefSchema, bM as ServiceDefinition, bN as ServiceDefinitionSchema, bO as ServiceParams, bP as ServiceRef, bQ as ServiceRefSchema, bR as ServiceRefStringSchema, bS as ServiceType, bT as ServiceTypeSchema, bU as SocketEvents, bV as SocketEventsSchema, bW as SocketServiceDef, bX as SocketServiceDefSchema, bY as StateInput, bZ as StateMachine, b_ as StateMachineInput, b$ as StateMachineSchema, c0 as StateSchema, c1 as StateSemanticRole, c2 as StateSemanticRoleSchema, c3 as SuggestedGuard, c4 as SuggestedGuardSchema, c5 as SwapEffect, c6 as ThemeDefinition, c7 as ThemeDefinitionSchema, c8 as ThemeRef, c9 as ThemeRefSchema, ca as ThemeRefStringSchema, cb as ThemeTokens, cc as ThemeTokensSchema, cd as ThemeVariant, ce as ThemeVariantSchema, d as Trait, cf as TraitCategory, cg as TraitCategorySchema, ch as TraitDataEntity, ci as TraitDataEntitySchema, cj as TraitEntityField, ck as TraitEntityFieldSchema, T as TraitEventContract, cl as TraitEventContractSchema, cm as TraitEventListener, cn as TraitEventListenerSchema, co as TraitInput, cp as TraitRef, cq as TraitRefSchema, cr as TraitReference, cs as TraitReferenceInput, ct as TraitReferenceSchema, cu as TraitSchema, cv as TraitTick, cw as TraitTickSchema, cx as TraitUIBinding, cy as Transition, cz as TransitionInput, cA as TransitionSchema, cB as UISlot, cC as UISlotSchema, cD as UI_SLOTS, cE as UXHints, cF as UXHintsSchema, cG as UseDeclaration, cH as UseDeclarationSchema, cI as UserPersona, cJ as UserPersonaInput, cK as UserPersonaSchema, cL as VISUAL_STYLES, cM as ViewType, cN as ViewTypeSchema, cO as VisualStyle, cP as VisualStyleSchema, cQ as WatchEffect, cR as WatchOptions, cS as atomic, cT as callService, cU as collectBindings, cV as createAssetKey, cW as deref, cX as deriveCollection, cY as despawn, cZ as doEffects, c_ as emit, c$ as findService, d0 as getArgs, d1 as getDefaultAnimationsForRole, d2 as getOperator, d3 as getServiceNames, d4 as getTraitConfig, d5 as getTraitName, d6 as hasService, d7 as isBinding, d8 as isCircuitEvent, d9 as isEffect, da as isEntityReference, db as isImportedTraitRef, dc as isInlineTrait, dd as isMcpService, de as isOrbitalDefinition, df as isPageReference, dg as isPageReferenceObject, dh as isPageReferenceString, di as isRestService, dj as isRuntimeEntity, dk as isSExpr, dl as isSExprAtom, dm as isSExprCall, dn as isSExprEffect, dp as isServiceReference, dq as isSingletonEntity, dr as isSocketService, ds as isThemeReference, dt as isValidBinding, du as navigate, dv as normalizeTraitRef, dw as notify, dx as parseAssetKey, dy as parseBinding, dz as parseEntityRef, dA as parseImportedTraitRef, dB as parseOrbitalSchema, dC as parsePageRef, dD as parseServiceRef, dE as persist, dF as ref, dG as renderUI, dH as safeParseOrbitalSchema, dI as set, dJ as sexpr, dK as spawn, dL as swap, dM as validateAssetAnimations, dN as walkSExpr, dO as watch } from './schema-BFnZrBhm.js';
+import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
+export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingContext, BindingSchema, ChangeAuthor, ChangeSetDocument, ChangeSummary, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, LazyService, ListInteraction, OperatorName, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SemanticChangeKind, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TransitionFrom, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllOperators, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, validateBindingInContext } from './types/index.js';
 export { ASTNode, ComparisonCondition, ComparisonOperator, DomainBehavior, DomainChunk, DomainDocument, DomainEffect, DomainEntity, DomainField, DomainFieldType, DomainGuard, DomainPage, DomainPageAction, DomainPageSection, DomainRelationship, DomainTick, DomainToSchemaResult, DomainTransition, EFFECT_REGISTRY, EffectMapping, EffectType, FIELD_TYPE_REGISTRY, FieldCheckCondition, FieldReference, FieldTypeMapping, GUARD_REGISTRY, GuardCondition, GuardMapping, KEYWORDS, Lexer, LogicalCondition, LogicalOperator, MULTI_WORD_KEYWORDS, MappingStore, MergeResult, ParseError, ParseResult, RelationshipType, SchemaToDomainResult, SectionMapping, SourceLocation, SourceRange, Token, TokenType, UserCheckCondition, applySectionUpdate, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createMappingStore, deleteSection, detectChanges, domainKeywordToSchemaType, findMapping, findMappingByPath, findMappingsByType, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getEffectMapping, getFieldTypeMapping, getGuardMapping, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getSchemaPath, hasSchemaChanged, isEffectRegistered, isFieldTypeRegistered, isGuardRegistered, mergeDomainChunks, parseBehavior, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseGuard, parsePage, parseSectionId, removeMapping, resolveConflict, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateDomainChunk } from './domain-language/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-C9G-CUOB.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-CQC8hsaL.js';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';
 export { CATEGORIES, CategoryMeta, OPERATORS, OPERATORS_SCHEMA, OPERATOR_NAMES, OperatorCategory, OperatorMeta, OperatorStats, OperatorsSchema, TargetPlatform, getOperatorMeta, getOperatorStats, getOperatorsByCategory, getOperatorsForTarget, isEffectOperator, isGuardOperator, isKnownOperator, validateOperatorArity } from '@almadar/operators';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
@@ -138,6 +138,14 @@ declare function detectPageContentReduction(beforePages: unknown[], afterPages:
  * Check if page content reductions are significant.
  */
 declare function hasSignificantPageReduction(reductions: PageContentReduction[]): boolean;
+/**
+ * Semantic diff: what .orb CONCEPTS changed between two schema versions.
+ *
+ * Unlike `diffSchemas()` which produces operational CRUD changes for persistence,
+ * this produces concept-level changes (guard-changed, render-ui-changed, etc.)
+ * for canvas focus derivation, CLI narration, and selective re-verification.
+ */
+declare function diffSchemaSemantics(before: OrbitalSchema, after: OrbitalSchema): SemanticSchemaChange[];
 
 /**
  * Orbital Summarization
@@ -180,4 +188,4 @@ declare function summarizeOrbital(orbital: OrbitalDefinition): OrbitalDefinition
  */
 declare function summarizeSchema(schema: OrbitalSchema): OrbitalSchema;
 
-export { OrbitalSchema as AppSchema, CategorizedRemovals, OrbitalDefinition, OrbitalSchema, PageContentReduction, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SchemaChange, State, categorizeRemovals, classifyWorkflow, clearSchemaCache, detectPageContentReduction, diffSchemas, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, isDestructiveChange, requiresConfirmation, schemaToIR, summarizeOrbital, summarizeSchema };
+export { OrbitalSchema as AppSchema, CategorizedRemovals, OrbitalDefinition, OrbitalSchema, PageContentReduction, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SchemaChange, SemanticSchemaChange, State, categorizeRemovals, classifyWorkflow, clearSchemaCache, detectPageContentReduction, diffSchemaSemantics, diffSchemas, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, isDestructiveChange, requiresConfirmation, schemaToIR, summarizeOrbital, summarizeSchema };

package/dist/index.js

@@ -1601,6 +1601,159 @@ function detectPageContentReduction(beforePages, afterPages) {
 function hasSignificantPageReduction(reductions) {
   return reductions.some((r) => r.isSignificant);
 }
+function jsonEqual(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+function setsEqual(a, b) {
+  if (a.size !== b.size) return false;
+  for (const item of a) {
+    if (!b.has(item)) return false;
+  }
+  return true;
+}
+function inlineTraitMap(refs) {
+  const map = /* @__PURE__ */ new Map();
+  for (const r of refs) {
+    if (isInlineTrait(r)) map.set(r.name, r);
+  }
+  return map;
+}
+function inlinePageMap(refs) {
+  const map = /* @__PURE__ */ new Map();
+  for (const r of refs) {
+    if (typeof r === "string") continue;
+    if ("ref" in r && !("name" in r)) continue;
+    const page = r;
+    if (page.path) map.set(page.path, page);
+  }
+  return map;
+}
+function isRenderUIEffect(effect) {
+  if (!Array.isArray(effect)) return false;
+  return String(effect[0]) === "render-ui" || String(effect[0]) === "renderUI";
+}
+function tKey(t) {
+  return `${t.from ?? ""}+${t.event}`;
+}
+function diffSemanticTransitions(orbitalName, traitName, before, after) {
+  const changes = [];
+  const bMap = new Map(before.map((t) => [tKey(t), t]));
+  const aMap = new Map(after.map((t) => [tKey(t), t]));
+  for (const [key, aT] of aMap) {
+    const bT = bMap.get(key);
+    if (!bT) continue;
+    if (!jsonEqual(bT.guard, aT.guard)) {
+      changes.push({ kind: "guard-changed", orbitalName, traitName, transitionEvent: aT.event });
+    }
+    if (!jsonEqual(bT.effects, aT.effects)) {
+      const bEffects = bT.effects ?? [];
+      const aEffects = aT.effects ?? [];
+      const bRUI = bEffects.filter(isRenderUIEffect);
+      const aRUI = aEffects.filter(isRenderUIEffect);
+      if (bRUI.length !== aRUI.length || !jsonEqual(bRUI, aRUI)) {
+        changes.push({ kind: "render-ui-changed", orbitalName, traitName, transitionEvent: aT.event });
+      } else {
+        changes.push({ kind: "effect-changed", orbitalName, traitName, transitionEvent: aT.event });
+      }
+    }
+  }
+  return changes;
+}
+function diffSemanticOrbital(name, before, after) {
+  const changes = [];
+  const bEntity = typeof before.entity === "object" ? before.entity : null;
+  const aEntity = typeof after.entity === "object" ? after.entity : null;
+  if (bEntity && aEntity) {
+    if (!jsonEqual(bEntity.fields, aEntity.fields)) {
+      changes.push({ kind: "entity-fields-changed", orbitalName: name });
+    }
+  } else if (bEntity !== aEntity) {
+    changes.push({ kind: "entity-fields-changed", orbitalName: name });
+  }
+  const bTraits = inlineTraitMap(before.traits ?? []);
+  const aTraits = inlineTraitMap(after.traits ?? []);
+  for (const [tName] of aTraits) {
+    if (!bTraits.has(tName)) changes.push({ kind: "trait-added", orbitalName: name, traitName: tName });
+  }
+  for (const [tName] of bTraits) {
+    if (!aTraits.has(tName)) changes.push({ kind: "trait-removed", orbitalName: name, traitName: tName });
+  }
+  for (const [tName, aTrait] of aTraits) {
+    const bTrait = bTraits.get(tName);
+    if (!bTrait) continue;
+    const bSM = bTrait.stateMachine;
+    const aSM = aTrait.stateMachine;
+    if (!bSM && !aSM) continue;
+    if (!bSM || !aSM) {
+      changes.push({ kind: "state-machine-changed", orbitalName: name, traitName: tName });
+      continue;
+    }
+    const bStates = new Set((bSM.states ?? []).map((s) => s.name));
+    const aStates = new Set((aSM.states ?? []).map((s) => s.name));
+    if (!setsEqual(bStates, aStates)) {
+      changes.push({ kind: "state-machine-changed", orbitalName: name, traitName: tName });
+    }
+    const bTKeys = new Set((bSM.transitions ?? []).map(tKey));
+    const aTKeys = new Set((aSM.transitions ?? []).map(tKey));
+    if (!setsEqual(bTKeys, aTKeys)) {
+      if (!changes.some((c) => c.kind === "state-machine-changed" && c.traitName === tName)) {
+        changes.push({ kind: "state-machine-changed", orbitalName: name, traitName: tName });
+      }
+    }
+    changes.push(...diffSemanticTransitions(name, tName, bSM.transitions ?? [], aSM.transitions ?? []));
+    if (!jsonEqual(bTrait.emits, aTrait.emits) || !jsonEqual(bTrait.listens, aTrait.listens)) {
+      changes.push({ kind: "event-wiring-changed", orbitalName: name, traitName: tName });
+    }
+  }
+  const bPages = inlinePageMap(before.pages ?? []);
+  const aPages = inlinePageMap(after.pages ?? []);
+  const bPaths = new Set(bPages.keys());
+  const aPaths = new Set(aPages.keys());
+  if (!setsEqual(bPaths, aPaths)) {
+    changes.push({ kind: "page-changed", orbitalName: name });
+  } else {
+    for (const [path, aPage] of aPages) {
+      if (!jsonEqual(bPages.get(path), aPage)) {
+        changes.push({ kind: "page-changed", orbitalName: name });
+        break;
+      }
+    }
+  }
+  return changes;
+}
+function diffSchemaSemantics(before, after) {
+  const changes = [];
+  const bOrbitals = /* @__PURE__ */ new Map();
+  for (const o of before.orbitals ?? []) {
+    const orb = o;
+    bOrbitals.set(orb.name, orb);
+  }
+  const aOrbitals = /* @__PURE__ */ new Map();
+  for (const o of after.orbitals ?? []) {
+    const orb = o;
+    aOrbitals.set(orb.name, orb);
+  }
+  const added = [];
+  for (const [name] of aOrbitals) {
+    if (!bOrbitals.has(name)) {
+      changes.push({ kind: "orbital-added", orbitalName: name });
+      added.push(name);
+    }
+  }
+  for (const [name] of bOrbitals) {
+    if (!aOrbitals.has(name)) {
+      changes.push({ kind: "orbital-removed", orbitalName: name });
+    }
+  }
+  if (added.length > 1) {
+    changes.push({ kind: "behavior-composed", orbitalName: added[0] });
+  }
+  for (const [name, aOrb] of aOrbitals) {
+    const bOrb = bOrbitals.get(name);
+    if (bOrb) changes.push(...diffSemanticOrbital(name, bOrb, aOrb));
+  }
+  return changes;
+}
 
 // src/summarize.ts
 var CRUD_STATES = /* @__PURE__ */ new Set(["browsing", "creating", "editing", "viewing", "deleting"]);
@@ -8248,6 +8401,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, MULTI_WORD_KEYWORDS, 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, TokenType, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityReference, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, MULTI_WORD_KEYWORDS, 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, TokenType, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffSchemaSemantics, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityReference, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map