@almadar/core 1.0.13 → 1.0.15

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, AppSchema as OrbitalSchema } from './types/index.js';
-export { ALLOWED_CUSTOM_COMPONENTS, AllowedCustomComponent, AnimationDef, AnimationDefInput, AnimationDefSchema, AssetMap, AssetMapInput, AssetMapSchema, AssetMapping, AssetMappingInput, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingContext, BindingSchema, CORE_BINDINGS, CallServiceConfig, ComputedEventContract, ComputedEventContractSchema, ComputedEventListener, ComputedEventListenerSchema, CoreBinding, CreateFlow, CustomPatternDefinition, CustomPatternDefinitionInput, CustomPatternDefinitionSchema, CustomPatternMap, CustomPatternMapInput, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeleteFlow, DesignPreferences, DesignPreferencesInput, DesignPreferencesSchema, DesignTokens, DesignTokensInput, DesignTokensSchema, DomainCategory, DomainCategorySchema, DomainContext, DomainContextInput, DomainContextSchema, DomainVocabulary, DomainVocabularySchema, ENTITY_ROLES, EditFlow, Effect, EffectInput, EffectSchema, Entity, EntityField, EntityFieldInput, EntityFieldSchema, EntityPersistence, EntityPersistenceSchema, EntityRef, EntityRefSchema, EntityRefStringSchema, EntityRole, EntityRoleSchema, EntitySchema, EntitySemanticRole, EntitySemanticRoleSchema, Event, EventInput, EventListener, EventListenerSchema, EventPayloadField, EventPayloadFieldSchema, EventSchema, EventScope, EventScopeSchema, EventSemanticRole, EventSemanticRoleSchema, EventSource, EventSourceSchema, Expression, ExpressionInput, ExpressionSchema, Field, FieldFormat, FieldFormatSchema, FieldSchema, FieldType, FieldTypeSchema, FullOrbitalUnit, GAME_TYPES, GameSubCategory, GameSubCategorySchema, GameType, GameTypeSchema, Guard, GuardInput, GuardSchema, InteractionModel, InteractionModelInput, InteractionModelSchema, ListInteraction, McpServiceDef, McpServiceDefSchema, NodeClassification, NodeClassificationSchema, OperatorName, FullOrbitalUnit as Orbital, OrbitalConfig, OrbitalConfigInput, OrbitalConfigSchema, OrbitalDefinition, OrbitalDefinitionSchema, OrbitalEntity, OrbitalEntityInput, OrbitalEntitySchema, OrbitalInput, OrbitalPage, OrbitalPageInput, OrbitalPageSchema, OrbitalPageStrictInput, OrbitalPageStrictSchema, OrbitalSchemaInput, OrbitalSchemaSchema, OrbitalTraitRef, OrbitalTraitRefSchema, OrbitalUnit, OrbitalUnitSchema, OrbitalZodSchema, Page, PageRef, PageRefObject, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRef, PageTraitRefSchema, ParsedBinding, PatternTypeSchema, PayloadField, PayloadFieldSchema, PresentationType, RelatedLink, RelatedLinkSchema, RelationConfig, RelationConfigSchema, RenderUIConfig, RequiredField, RequiredFieldSchema, ResolvedAsset, ResolvedAssetInput, ResolvedAssetSchema, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, RestAuthConfig, RestAuthConfigSchema, RestServiceDef, RestServiceDefSchema, SERVICE_TYPES, SExpr, SExprAtom, SExprAtomSchema, SExprInput, SExprSchema, SemanticAssetRef, SemanticAssetRefInput, SemanticAssetRefSchema, ServiceDefinition, ServiceDefinitionSchema, ServiceRef, ServiceRefSchema, ServiceRefStringSchema, ServiceType, ServiceTypeSchema, SocketEvents, SocketEventsSchema, SocketServiceDef, SocketServiceDefSchema, State, StateInput, StateMachine, StateMachineInput, StateMachineSchema, StateSchema, StateSemanticRole, StateSemanticRoleSchema, SuggestedGuard, SuggestedGuardSchema, ThemeDefinition, ThemeDefinitionSchema, ThemeRef, ThemeRefSchema, ThemeRefStringSchema, ThemeTokens, ThemeTokensSchema, ThemeVariant, ThemeVariantSchema, Trait, TraitCategory, TraitCategorySchema, TraitDataEntity, TraitDataEntitySchema, TraitEntityField, TraitEntityFieldSchema, TraitEventContract, TraitEventContractSchema, TraitEventListener, TraitEventListenerSchema, TraitInput, TraitRef, TraitRefSchema, TraitReference, TraitReferenceInput, TraitReferenceSchema, TraitSchema, TraitTick, TraitTickSchema, TraitUIBinding, Transition, TransitionFrom, TransitionInput, TransitionSchema, UISlot, UISlotSchema, UI_SLOTS, UXHints, UXHintsSchema, UseDeclaration, UseDeclarationSchema, UserPersona, UserPersonaInput, UserPersonaSchema, VISUAL_STYLES, ViewFlow, ViewType, ViewTypeSchema, 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 } from './types/index.js';
+import { O as OrbitalSchema } from './schema-DFOz4rEu.js';
+export { A as ALLOWED_CUSTOM_COMPONENTS, a as AllowedCustomComponent, b as AnimationDef, c as AnimationDefInput, d as AnimationDefSchema, e as AssetMap, f as AssetMapInput, g as AssetMapSchema, h as AssetMapping, i as AssetMappingInput, j as AssetMappingSchema, C as CORE_BINDINGS, k as CallServiceConfig, l as ComputedEventContract, m as ComputedEventContractSchema, n as ComputedEventListener, o as ComputedEventListenerSchema, p as CoreBinding, q as CustomPatternDefinition, r as CustomPatternDefinitionInput, s as CustomPatternDefinitionSchema, t as CustomPatternMap, u as CustomPatternMapInput, v as CustomPatternMapSchema, D as DesignPreferences, w as DesignPreferencesInput, x as DesignPreferencesSchema, y as DesignTokens, z as DesignTokensInput, B as DesignTokensSchema, E as DomainCategory, F as DomainCategorySchema, G as DomainContext, H as DomainContextInput, I as DomainContextSchema, J as DomainVocabulary, K as DomainVocabularySchema, L as ENTITY_ROLES, M as Effect, N as EffectInput, P as EffectSchema, Q as Entity, R as EntityField, S as EntityFieldInput, T as EntityFieldSchema, U as EntityPersistence, V as EntityPersistenceSchema, W as EntityRef, X as EntityRefSchema, Y as EntityRefStringSchema, Z as EntityRole, _ as EntityRoleSchema, $ as EntitySchema, a0 as EntitySemanticRole, a1 as EntitySemanticRoleSchema, a2 as Event, a3 as EventInput, a4 as EventListener, a5 as EventListenerSchema, a6 as EventPayloadField, a7 as EventPayloadFieldSchema, a8 as EventSchema, a9 as EventScope, aa as EventScopeSchema, ab as EventSemanticRole, ac as EventSemanticRoleSchema, ad as EventSource, ae as EventSourceSchema, af as Expression, ag as ExpressionInput, ah as ExpressionSchema, ai as Field, aj as FieldFormat, ak as FieldFormatSchema, al as FieldSchema, am as FieldType, an as FieldTypeSchema, ao as FullOrbitalUnit, ap as GAME_TYPES, aq as GameSubCategory, ar as GameSubCategorySchema, as as GameType, at as GameTypeSchema, au as Guard, av as GuardInput, aw as GuardSchema, ax as McpServiceDef, ay as McpServiceDefSchema, az as NodeClassification, aA as NodeClassificationSchema, ao as Orbital, aB as OrbitalConfig, aC as OrbitalConfigInput, aD as OrbitalConfigSchema, aE as OrbitalDefinition, aF as OrbitalDefinitionSchema, aG as OrbitalEntity, aH as OrbitalEntityInput, aI as OrbitalEntitySchema, aJ as OrbitalInput, aK as OrbitalPage, aL as OrbitalPageInput, aM as OrbitalPageSchema, aN as OrbitalPageStrictInput, aO as OrbitalPageStrictSchema, aP as OrbitalSchemaInput, aQ as OrbitalSchemaSchema, aR as OrbitalTraitRef, aS as OrbitalTraitRefSchema, aT as OrbitalUnit, aU as OrbitalUnitSchema, aV as OrbitalZodSchema, aW as Page, aX as PageRef, aY as PageRefObject, aZ as PageRefObjectSchema, a_ as PageRefSchema, a$ as PageRefStringSchema, b0 as PageSchema, b1 as PageTraitRef, b2 as PageTraitRefSchema, b3 as ParsedBinding, b4 as PayloadField, b5 as PayloadFieldSchema, b6 as PresentationType, b7 as RelatedLink, b8 as RelatedLinkSchema, b9 as RelationConfig, ba as RelationConfigSchema, bb as RenderUIConfig, bc as RequiredField, bd as RequiredFieldSchema, be as ResolvedAsset, bf as ResolvedAssetInput, bg as ResolvedAssetSchema, bh as RestAuthConfig, bi as RestAuthConfigSchema, bj as RestServiceDef, bk as RestServiceDefSchema, bl as SERVICE_TYPES, bm as SExpr, bn as SExprAtom, bo as SExprAtomSchema, bp as SExprInput, bq as SExprSchema, br as SemanticAssetRef, bs as SemanticAssetRefInput, bt as SemanticAssetRefSchema, bu as ServiceDefinition, bv as ServiceDefinitionSchema, bw as ServiceRef, bx as ServiceRefSchema, by as ServiceRefStringSchema, bz as ServiceType, bA as ServiceTypeSchema, bB as SocketEvents, bC as SocketEventsSchema, bD as SocketServiceDef, bE as SocketServiceDefSchema, bF as State, bG as StateInput, bH as StateMachine, bI as StateMachineInput, bJ as StateMachineSchema, bK as StateSchema, bL as StateSemanticRole, bM as StateSemanticRoleSchema, bN as SuggestedGuard, bO as SuggestedGuardSchema, bP as ThemeDefinition, bQ as ThemeDefinitionSchema, bR as ThemeRef, bS as ThemeRefSchema, bT as ThemeRefStringSchema, bU as ThemeTokens, bV as ThemeTokensSchema, bW as ThemeVariant, bX as ThemeVariantSchema, bY as Trait, bZ as TraitCategory, b_ as TraitCategorySchema, b$ as TraitDataEntity, c0 as TraitDataEntitySchema, c1 as TraitEntityField, c2 as TraitEntityFieldSchema, c3 as TraitEventContract, c4 as TraitEventContractSchema, c5 as TraitEventListener, c6 as TraitEventListenerSchema, c7 as TraitInput, c8 as TraitRef, c9 as TraitRefSchema, ca as TraitReference, cb as TraitReferenceInput, cc as TraitReferenceSchema, cd as TraitSchema, ce as TraitTick, cf as TraitTickSchema, cg as TraitUIBinding, ch as Transition, ci as TransitionInput, cj as TransitionSchema, ck as UISlot, cl as UISlotSchema, cm as UI_SLOTS, cn as UXHints, co as UXHintsSchema, cp as UseDeclaration, cq as UseDeclarationSchema, cr as UserPersona, cs as UserPersonaInput, ct as UserPersonaSchema, cu as VISUAL_STYLES, cv as ViewType, cw as ViewTypeSchema, cx as VisualStyle, cy as VisualStyleSchema, cz as callService, cA as collectBindings, cB as createAssetKey, cC as deriveCollection, cD as despawn, cE as doEffects, cF as emit, cG as findService, cH as getArgs, cI as getDefaultAnimationsForRole, cJ as getOperator, cK as getServiceNames, cL as getTraitConfig, cM as getTraitName, cN as hasService, cO as isBinding, cP as isCircuitEvent, cQ as isEffect, cR as isEntityReference, cS as isImportedTraitRef, cT as isInlineTrait, cU as isMcpService, cV as isOrbitalDefinition, cW as isPageReference, cX as isPageReferenceObject, cY as isPageReferenceString, cZ as isRestService, c_ as isRuntimeEntity, c$ as isSExpr, d0 as isSExprAtom, d1 as isSExprCall, d2 as isSExprEffect, d3 as isServiceReference, d4 as isSingletonEntity, d5 as isSocketService, d6 as isThemeReference, d7 as isValidBinding, d8 as navigate, d9 as normalizeTraitRef, da as notify, db as parseAssetKey, dc as parseBinding, dd as parseEntityRef, de as parseImportedTraitRef, df as parseOrbitalSchema, dg as parsePageRef, dh as parseServiceRef, di as persist, dj as renderUI, dk as safeParseOrbitalSchema, dl as set, dm as sexpr, dn as spawn, dp as validateAssetAnimations, dq as walkSExpr } from './schema-DFOz4rEu.js';
+import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, SchemaChange, CategorizedRemovals, PageContentReduction } from './types/index.js';
+export { AppSummary, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingContext, BindingSchema, ChangeAuthor, ChangeSetDocument, ChangeSummary, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, ListInteraction, OperatorName, PatternTypeSchema, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SnapshotDocument, StatsView, TransitionFrom, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createResolvedField, 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, 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 { 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';
 import 'zod';
@@ -83,4 +86,55 @@ declare function getEntity(ir: ResolvedIR, entityName: string): ResolvedEntity |
  */
 declare function getTrait(ir: ResolvedIR, traitName: string): ResolvedTrait | undefined;
 
-export { OrbitalSchema as AppSchema, OrbitalSchema, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, clearSchemaCache, getEntity, getPage, getPages, getSchemaCacheStats, getTrait, schemaToIR };
+/**
+ * Schema Diffing & Protection
+ *
+ * Pure functions for comparing OrbitalSchema objects, detecting destructive changes,
+ * and categorizing removals. No I/O — operates on in-memory schema objects.
+ */
+
+/**
+ * Diff two OrbitalSchema objects and produce a list of changes.
+ * Compares orbitals, entities, traits, pages, services, and top-level fields.
+ */
+declare function diffSchemas(before: OrbitalSchema, after: OrbitalSchema): {
+    changes: SchemaChange[];
+};
+/**
+ * Check if a changeset contains any removals.
+ */
+declare function isDestructiveChange(changeSet: {
+    changes: SchemaChange[];
+}): boolean;
+/**
+ * Extract all removal operations from a changeset.
+ */
+declare function getRemovals(changeSet: {
+    changes: SchemaChange[];
+}): SchemaChange[];
+/**
+ * Categorize removals by severity.
+ *
+ * - Critical: orbitals, entities, states, pages (require confirmation)
+ * - Standard: fields, actions, traits (auto-snapshotted)
+ * - Minor: transitions, guards (tracked)
+ */
+declare function categorizeRemovals(changeSet: {
+    changes: SchemaChange[];
+}): CategorizedRemovals;
+/**
+ * Check if critical removals require explicit confirmation.
+ */
+declare function requiresConfirmation(removals: CategorizedRemovals): boolean;
+/**
+ * Detect implicit content reduction within pages.
+ * Catches cases where a page 'modify' reduces components/actions/displays
+ * without an explicit 'remove' operation.
+ */
+declare function detectPageContentReduction(beforePages: unknown[], afterPages: unknown[]): PageContentReduction[];
+/**
+ * Check if page content reductions are significant.
+ */
+declare function hasSignificantPageReduction(reductions: PageContentReduction[]): boolean;
+
+export { OrbitalSchema as AppSchema, CategorizedRemovals, OrbitalSchema, PageContentReduction, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SchemaChange, categorizeRemovals, clearSchemaCache, detectPageContentReduction, diffSchemas, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, isDestructiveChange, requiresConfirmation, schemaToIR };