@salsita-ai/sdk 0.50.0-develop.a49722158a → 0.50.0-develop.a8cf9ffd01

package/dist/domain/available-system-components/available-system-components.d.ts

@@ -0,0 +1,11 @@
+import { type SystemComponentTypeConstraint } from '../core/index.js';
+/**
+ * All components that are available in the domain spec and can be defined in yaml.
+ *
+ * To add a new component the domain spec, add it to this array
+ */
+export declare const availableSystemComponents: [import("../index.js").SystemComponentType<"applicationConfig", import("../index.js").ApplicationConfigComponentState, never>, import("../index.js").SystemComponentType<"price", import("../index.js").PriceComponentState, never>, import("../index.js").SystemComponentType<"detail", import("../index.js").DetailComponentState, never>, import("../index.js").SystemComponentType<"canvasConfig", import("../index.js").CanvasConfigComponentState, never>, import("../index.js").SystemComponentType<"canvasCustomEnvironment", import("../index.js").CanvasCustomEnvironmentComponentState, never>, import("../index.js").SystemComponentType<"canvasPresetEnvironment", import("../index.js").CanvasPresetEnvironmentComponentState, never>, import("../index.js").SystemComponentType<"dimensionIndicator", import("../index.js").DimensionIndicatorComponentState, never>, import("../index.js").SystemComponentType<"angleIndicator", import("../index.js").AngleIndicatorComponentState, never>, import("../index.js").SystemComponentType<"dragHandle", import("../index.js").DragHandleComponentState, "draggableRotationY" | "draggableX" | "draggableY" | "draggableZ">, import("../index.js").SystemComponentType<"rotationHandle", import("../index.js").RotationHandleComponentState, never>, import("../index.js").SystemComponentType<"rotatable", import("../index.js").RotatableComponentState, "rotation">, import("../index.js").SystemComponentType<"sketching", import("../index.js").SketchingComponentState, never>, import("../index.js").SystemComponentType<"sketchingDraw", import("../index.js").SketchingDrawComponentState, never>, import("../index.js").SystemComponentType<"sketchingEdit", import("../index.js").SketchingEditComponentState, never>, import("../index.js").SystemComponentType<"sketchingLine", import("../index.js").SketchingLineComponentState, "angle" | "length" | "x" | "y">, import("../index.js").SystemComponentType<"sketchingRectangle", import("../index.js").SketchingRectangleComponentState, "angle" | "depth" | "width" | "x" | "y">, import("../index.js").SystemComponentType<"sceneEntityRemoteObject", import("../index.js").SceneEntityRemoteObjectComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObject", import("../index.js").SceneEntityObjectComponentState, never>, import("../index.js").SystemComponentType<"customSceneEntity", import("../index.js").CustomSceneEntityComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityWallObject", import("../index.js").SceneEntityWallObjectComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityFloorObject", import("../index.js").SceneEntityFloorObjectComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityBoxObject", import("../index.js").SceneEntityBoxObjectComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityAmbientLight", import("../index.js").SceneEntityAmbientLightComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityDirectionalLight", import("../index.js").SceneEntityDirectionalLightComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityPointLight", import("../index.js").SceneEntityPointLightComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityRectAreaLight", import("../index.js").SceneEntityRectAreaLightComponentState, never>, import("../index.js").SystemComponentType<"sceneEntitySpotLight", import("../index.js").SceneEntitySpotLightComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityProperties", import("../index.js").SceneEntityPropertiesComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectProperties", import("../index.js").SceneEntityObjectPropertiesComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectGroup", import("../index.js").SceneEntityObjectGroupComponentState, never>, import("../index.js").SystemComponentType<"hiddenEntity", import("../index.js").HiddenEntityComponentState, never>, import("../index.js").SystemComponentType<"cameraBasedHiddenEntity", import("../index.js").CameraBasedHiddenEntityComponentState, never>, import("../index.js").SystemComponentType<"cameraBasedHiddenEntityObject", import("../index.js").CameraBasedHiddenEntityObjectComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityRemoteMaterialOverride", import("../index.js").SceneEntityRemoteMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityLocalMaterialOverride", import("../index.js").SceneEntityLocalMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectRemoteMaterialOverride", import("../index.js").SceneEntityObjectRemoteMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectLocalMaterialOverride", import("../index.js").SceneEntityObjectLocalMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectTransmissiveMaterialOverride", import("../index.js").SceneEntityObjectTransmissiveMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityTransmissiveMaterialOverride", import("../index.js").SceneEntityTransmissiveMaterialOverrideComponentState, never>, import("../index.js").SystemComponentType<"materialOverridePropertyTransition", import("../index.js").MaterialOverridePropertyTransitionComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityAnimation", import("../index.js").SceneEntityAnimationComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectClip", import("../index.js").SceneEntityObjectClipComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectTextDecal", import("../index.js").SceneEntityObjectTextDecalComponentState, never>, import("../index.js").SystemComponentType<"fitRootPerspectiveCamera", import("../index.js").FitRootPerspectiveCameraComponentState, never>, import("../index.js").SystemComponentType<"fitRootOrthographicCamera", import("../index.js").FitRootOrthographicCameraComponentState, never>, import("../index.js").SystemComponentType<"fitEntityPerspectiveCamera", import("../index.js").FitEntityPerspectiveCameraComponentState, never>, import("../index.js").SystemComponentType<"fitEntityOrthographicCamera", import("../index.js").FitEntityOrthographicCameraComponentState, never>, import("../index.js").SystemComponentType<"fitSelectionPerspectiveCamera", import("../index.js").FitSelectionPerspectiveCameraComponentState, never>, import("../index.js").SystemComponentType<"fitSelectionOrthographicCamera", import("../index.js").FitSelectionOrthographicCameraComponentState, never>, import("../index.js").SystemComponentType<"staticPerspectiveCamera", import("../index.js").StaticPerspectiveCameraComponentState, never>, import("../index.js").SystemComponentType<"staticOrthographicCamera", import("../index.js").StaticOrthographicCameraComponentState, never>, import("../index.js").SystemComponentType<"autorotateCamera", import("../index.js").AutorotateCameraComponentState, never>, import("../index.js").SystemComponentType<"boundingBox", import("../index.js").BoundingBoxComponentState, never>, import("../index.js").SystemComponentType<"boundingSphere", import("../index.js").BoundingSphereComponentState, never>, import("../index.js").SystemComponentType<"pivotPoint", import("../index.js").PivotPointComponentState, never>, import("../index.js").SystemComponentType<"snapPoint", import("../index.js").SnapPointComponentState, never>, import("../index.js").SystemComponentType<"snapEdge", import("../index.js").SnapEdgeComponentState, never>, import("../index.js").SystemComponentType<"snapPlane", import("../index.js").SnapPlaneComponentState, never>, import("../index.js").SystemComponentType<"snapAxis", import("../index.js").SnapAxisComponentState, never>, import("../index.js").SystemComponentType<"collisionBoxGeometry", import("../index.js").CollisionBoxGeometryComponentState, never>, import("../index.js").SystemComponentType<"collisionGeometry", import("../index.js").CollisionGeometryComponentState, never>, import("../index.js").SystemComponentType<"collisionPointGeometry", import("../index.js").CollisionPointGeometryComponentState, never>, import("../index.js").SystemComponentType<"constraint", import("../index.js").ConstraintComponentState, never>, import("../index.js").SystemComponentType<"selectable", import("../index.js").SelectableComponentState, never>, import("../index.js").SystemComponentType<"htmlHotspot", import("../index.js").HtmlHotspotComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityObjectHtmlHotspot", import("../index.js").SceneEntityObjectHtmlHotspotComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityControl", import("../index.js").SceneEntityControlComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityAddFab", import("../index.js").SceneEntityAddFabComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityDeleteFab", import("../index.js").SceneEntityDeleteFabComponentState, never>, import("../index.js").SystemComponentType<"sceneEntitySelectHotspot", import("../index.js").SceneEntitySelectHotspotComponentState, never>, import("../index.js").SystemComponentType<"sceneEntityNavigationHotspot", import("../index.js").SceneEntityNavigationHotspotComponentState, never>, import("../index.js").SystemComponentType<"toolMenuFab", import("../index.js").ToolMenuFabComponentState, never>, import("../index.js").SystemComponentType<"exitToolModeFab", import("../index.js").ExitToolModeFabComponentState, never>, import("../index.js").SystemComponentType<"entityHeader", import("../index.js").EntityHeaderComponentState, never>, import("../index.js").SystemComponentType<"propertyPage", import("../index.js").PropertyPageComponentState, never>, import("../index.js").SystemComponentType<"toolbar", import("../index.js").ToolbarComponentState, never>, import("../index.js").SystemComponentType<"viewControls", import("../index.js").ViewControlsComponentState, never>, import("../index.js").SystemComponentType<"toolControls", import("../index.js").ToolControlsComponentState, never>, import("../index.js").SystemComponentType<"sidebarTabs", import("../index.js").SidebarTabsComponentState, never>, import("../index.js").SystemComponentType<"horizontalTabs", import("../index.js").HorizontalTabsComponentState, never>, import("../index.js").SystemComponentType<"navigationSteps", import("../index.js").NavigationStepsComponentState, never>, import("../index.js").SystemComponentType<"finalizeAction", import("../index.js").FinalizeActionComponentState, never>, import("../index.js").SystemComponentType<"otherAction", import("../index.js").OtherActionComponentState, never>, import("../index.js").SystemComponentType<"basicSidebarFooter", import("../index.js").BasicSidebarFooterComponentState, never>, import("../index.js").SystemComponentType<"universalSidebarFooter", import("../index.js").UniversalSidebarFooterComponentState, never>, import("../index.js").SystemComponentType<"readSidebarFooter", import("../index.js").ReadSidebarFooterComponentState, never>, import("../index.js").SystemComponentType<"customSidebarFooter", import("../index.js").CustomSidebarFooterComponentState, never>, import("../index.js").SystemComponentType<"hiddenSidebarFooter", import("../index.js").HiddenSidebarFooterComponentState, never>, import("../index.js").SystemComponentType<"canvasPadding", import("../index.js").CanvasPaddingComponentState, never>, import("../index.js").SystemComponentType<"floatingHeader", import("../index.js").FloatingHeaderComponentState, never>, import("../index.js").SystemComponentType<"customHeader", import("../index.js").CustomHeaderComponentState, never>, import("../index.js").SystemComponentType<"fixedHeader", import("../index.js").FixedHeaderComponentState, never>, import("../index.js").SystemComponentType<"hiddenHeader", import("../index.js").HiddenHeaderComponentState, never>, import("../index.js").SystemComponentType<"replaceEntityRecipes", import("../index.js").ReplaceEntityRecipesComponentState, never>, import("../index.js").SystemComponentType<"replaceEntityRecipeHierarchy", import("../index.js").ReplaceEntityRecipeHierarchyComponentState, never>, import("../index.js").SystemComponentType<"childEntityRecipes", import("../index.js").ChildEntityRecipesComponentState, never>, import("../index.js").SystemComponentType<"childEntityRecipeHierarchy", import("../index.js").ChildEntityRecipeHierarchyComponentState, never>, import("../index.js").SystemComponentType<"materialSwatch", import("../index.js").MaterialSwatchComponentState, "selectedSwatchKey">, import("../index.js").SystemComponentType<"offsetAnchors", import("../index.js").OffsetAnchorsComponentState, never>, import("../index.js").SystemComponentType<"offsetIndicator", import("../index.js").OffsetIndicatorComponentState, never>, import("../index.js").SystemComponentType<"distanceDimension", import("../index.js").DistanceDimensionComponentState, "value">, import("../index.js").SystemComponentType<"angleDimension", import("../index.js").AngleValue, "value">, import("../index.js").SystemComponentType<"genericDimension", import("../index.js").GenericValue, "value">, import("../index.js").SystemComponentType<"distanceDimensionSelect", import("../index.js").DistanceDimensionSelectComponentState, "value">, import("../index.js").SystemComponentType<"colorValue", import("../index.js").ColorValueComponentState, "value">, import("../index.js").SystemComponentType<"textValue", import("../index.js").TextValueComponentState, "value">, import("../index.js").SystemComponentType<"multilingualTextValue", import("../index.js").MultilingualTextValueComponentState, "value">, import("../index.js").SystemComponentType<"attributeSelection", import("../index.js").AttributeSelectionComponentState, "value">, import("../index.js").SystemComponentType<"attributeSwitch", import("../index.js").AttributeSwitchComponentState, "value">, import("../index.js").SystemComponentType<"childEntitySelection", import("../index.js").ChildEntitySelectionComponentState, never>, import("../index.js").SystemComponentType<"size", import("../index.js").SizeComponentState, "sizeX" | "sizeY" | "sizeZ">, import("../index.js").SystemComponentType<"offset", import("../index.js").OffsetComponentState, "offsetX" | "offsetY" | "offsetZ">, import("../index.js").SystemComponentType<"editableAngleIndicator", import("../index.js").EditableAngleIndicatorComponentState, never>, import("../index.js").SystemComponentType<"editableDistanceDimensionIndicator", import("../index.js").EditableDistanceDimensionIndicatorComponentState, never>, import("../index.js").SystemComponentType<"editableOffsetIndicator", import("../index.js").EditableOffsetIndicatorComponentState, never>, import("../index.js").SystemComponentType<"editableSizeIndicator", import("../index.js").EditableSizeIndicatorComponentState, never>, import("../index.js").SystemComponentType<"listSelectorDimensionIndicator", import("../index.js").ListSelectorDimensionIndicatorComponentState, never>, import("../index.js").SystemComponentType<"hotspotDragHandle", import("../index.js").HotspotDragHandleComponentState, "draggableX" | "draggableY" | "draggableZ">, import("../index.js").SystemComponentType<"simpleSummary", import("../index.js").SimpleSummaryComponentState, never>, import("../index.js").SystemComponentType<"clientSideImage", import("../index.js").ClientSideImageComponentState, never>, import("../index.js").SystemComponentType<"saveTemplateThumbnail", import("../index.js").SaveTemplateThumbnailComponentState, never>, import("../index.js").SystemComponentType<"agentScreenshot", import("../index.js").AgentScreenshotComponentState, never>, import("../index.js").SystemComponentType<"projectedEntities", import("../index.js").ProjectedEntitiesComponentState, never>, import("../index.js").SystemComponentType<"violations", import("../index.js").ViolationComponentState, never>];
+/**
+ * Get component by name from all domain spec available components
+ */
+export declare const componentsByName: Map<string, SystemComponentTypeConstraint>;

package/dist/domain/available-system-components/available-system-components.js

@@ -0,0 +1 @@
+import{violationsComponent as e}from"../core/index.js";import{agentScreenshotComponent as o,angleIndicatorComponent as n,attributeSwitchComponent as m,autorotateCameraComponent as s,basicSidebarFooterComponent as t,cameraBasedHiddenEntityComponent as p,cameraBasedHiddenEntityObjectComponent as a,canvasConfigComponent as i,canvasCustomEnvironmentComponent as r,canvasPaddingComponent as x,canvasPresetEnvironmentComponent as c,childEntityRecipeHierarchyComponent as l,clientSideImageComponent as y,colorValueComponent as d,customHeaderComponent as f,customSidebarFooterComponent as j,dimensionIndicatorComponent as b,editableAngleIndicatorComponent as v,editableDistanceDimensionIndicatorComponent as C,editableOffsetIndicatorComponent as S,editableSizeIndicatorComponent as w,entityHeaderComponent as B,exitToolModeFabComponent as M,finalizeActionComponent as N,fitSelectionOrthographicCameraComponent as g,fitSelectionPerspectiveCameraComponent as h,fixedHeaderComponent as k,floatingHeaderComponent as q,hiddenHeaderComponent as u,hiddenSidebarFooterComponent as z,horizontalTabsComponent as A,htmlHotspotComponent as D,listSelectorDimensionIndicatorComponent as E,multilingualTextValueComponent as F,navigationStepsComponent as G,offsetAnchorsComponent as H,offsetComponent as I,offsetIndicatorComponent as J,otherActionComponent as K,propertyPageComponent as L,readSidebarFooterComponent as O,replaceEntityRecipeHierarchyComponent as P,rotatableComponent as Q,rotationHandleComponent as R,saveTemplateThumbnailComponent as T,sceneEntityAddFabComponent as U,sceneEntityAnimationComponent as V,sceneEntityControlComponent as W,sceneEntityDeleteFabComponent as X,sceneEntityFloorObjectComponent as Y,sceneEntityNavigationHotspotComponent as Z,sceneEntityObjectHtmlHotspotComponent as $,sceneEntitySelectHotspotComponent as _,sceneEntityWallObjectComponent as ee,selectableComponent as eo,sidebarTabsComponent as en,simpleSummaryComponent as em,sizeComponent as es,sketchingDrawComponent as et,sketchingEditComponent as ep,textValueComponent as ea,toolControlsComponent as ei,toolMenuFabComponent as er,toolbarComponent as ex,universalSidebarFooterComponent as ec,viewControlsComponent as el}from"../extensions/index.js";import{angleDimensionComponent as ey,applicationConfigComponent as ed,attributeSelectionComponent as ef,boundingBoxComponent as ej,boundingSphereComponent as eb,childEntityRecipesComponent as ev,childEntitySelectionComponent as eC,collisionBoxGeometryComponent as eS,collisionGeometryComponent as ew,collisionPointGeometryComponent as eB,constraintComponent as eM,customSceneEntityComponent as eN,detailComponent as eg,distanceDimensionComponent as eh,distanceDimensionSelectComponent as ek,dragHandleComponent as eq,fitEntityOrthographicCameraComponent as eu,fitEntityPerspectiveCameraComponent as ez,fitRootOrthographicCameraComponent as eA,fitRootPerspectiveCameraComponent as eD,genericDimensionComponent as eE,hiddenEntityComponent as eF,hotspotDragHandleComponent as eG,materialOverridePropertyTransitionComponent as eH,materialSwatchComponent as eI,pivotPointComponent as eJ,priceComponent as eK,projectedEntitiesComponent as eL,replaceEntityRecipesComponent as eO,sceneEntityAmbientLightComponent as eP,sceneEntityBoxObjectComponent as eQ,sceneEntityDirectionalLightComponent as eR,sceneEntityLocalMaterialOverrideComponent as eT,sceneEntityObjectClipComponent as eU,sceneEntityObjectComponent as eV,sceneEntityObjectGroupComponent as eW,sceneEntityObjectLocalMaterialOverrideComponent as eX,sceneEntityObjectPropertiesComponent as eY,sceneEntityObjectRemoteMaterialOverrideComponent as eZ,sceneEntityObjectTextDecalComponent as e$,sceneEntityObjectTransmissiveMaterialOverrideComponent as e_,sceneEntityPointLightComponent as e0,sceneEntityPropertiesComponent as e1,sceneEntityRectAreaLightComponent as e2,sceneEntityRemoteMaterialOverrideComponent as e3,sceneEntityRemoteObjectComponent as e4,sceneEntitySpotLightComponent as e5,sceneEntityTransmissiveMaterialOverrideComponent as e6,sketchingComponent as e7,sketchingLineComponent as e8,sketchingRectangleComponent as e9,snapAxisComponent as oe,snapEdgeComponent as oo,snapPlaneComponent as on,snapPointComponent as om,staticOrthographicCameraComponent as os,staticPerspectiveCameraComponent as ot}from"../system-components/index.js";export const availableSystemComponents=[ed,eK,eg,i,r,c,b,n,eq,R,Q,e7,et,ep,e8,e9,e4,eV,eN,ee,Y,eQ,eP,eR,e0,e2,e5,e1,eY,eW,eF,p,a,e3,eT,eZ,eX,e_,e6,eH,V,eU,e$,eD,eA,ez,eu,h,g,ot,os,s,ej,eb,eJ,om,oo,on,oe,eS,ew,eB,eM,eo,D,$,W,U,X,_,Z,er,M,B,L,ex,el,ei,en,A,G,N,K,t,ec,O,j,z,x,q,f,k,u,eO,P,ev,l,eI,H,J,eh,ey,eE,ek,d,ea,F,ef,m,eC,es,I,v,C,S,w,E,eG,em,y,T,o,eL,e];export const componentsByName=new Map(availableSystemComponents.map(e=>[e.name,e]));

package/dist/domain/available-system-components/index.d.ts

@@ -0,0 +1 @@
+export { availableSystemComponents, componentsByName } from './available-system-components.js';

package/dist/domain/available-system-components/index.js

@@ -0,0 +1 @@
+export{availableSystemComponents,componentsByName}from"./available-system-components.js";

package/dist/domain/core/action/index.d.ts

@@ -1,2 +1 @@
-export * from './action-factory.js';
 export type * from './action.js';

package/dist/domain/core/action/index.js

@@ -1 +1 @@
-export*from"./action-factory.js";
+export{};

package/dist/domain/core/domain.js

@@ -1 +1 @@
-import{createCacheToken as t,getStickyCache as e}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as i}from"./model/index.js";let r=t(),o=t();export class Domain{_context;constructor(t){this._context=t}getEntity=(t,i)=>{let r=e(i,o),n=r.get("entityMap");if(n)return n.get(t);let s=(t=>{let e=new Map;for(let i of t){if(e.has(i.id))throw Error(`Error while creating a UniqueEntityMap for caching of domain queries. Duplicate entity id ${i.id} encountered!`);e.set(i.id,i)}return e})(i.entities);return r.put("entityMap",s),s.get(t)};get$Entity=(t,i)=>{let o=e(i,r),n=o.get(t);if(n)return n;let s=this.getEntity(t,i);if(!s)throw Error(`Entity ${t} does not exist`);let a={...s},l=this._context.selectors.getDomainExpressions()[s.type];return l&&Object.entries(l).forEach(([t,e])=>{Object.defineProperty(a,t,{enumerable:!0,get:()=>e.evaluate(s.id,i,this._context.selectors.getExpressionContext())})}),Object.defineProperty(a,"_raw",{enumerable:!0,writable:!1,value:s}),Object.defineProperty(a,"_state",{enumerable:!0,writable:!1,value:i}),o.put(t,a),a};get$Entities=(t,e)=>t.map(t=>this.get$Entity(t,e));getRoot$Entity=t=>this.get$Entity(t.rootEntityId,t);validateExpressions=t=>{if(!this._context.selectors.getAllowedRootEntityTypes().includes(t.rootEntityType))throw Error(`Entity type ${t.rootEntityType} is not allowed as root entity`);if(!this.getEntity(t.rootEntityId,t))throw Error(`Root entity ${t.rootEntityId} was not found!`);t.entities.forEach(e=>{let i=this._context.selectors.getDomainExpressions()[e.type];void 0!==i&&Object.values(i).forEach(i=>{!0===i.meta.alwaysEvaluate&&i.evaluate(e.id,t,this._context.selectors.getExpressionContext())})})};validateEntity=t=>{let e=this._context.selectors.getEntityReflections()[t.type];if(!e)throw Error(`Unknown entity type ${t.type}`);return e._meta.validator(t)?{success:!0}:{success:!1,errors:e._meta.validator.errors?.map(t=>`${t.instancePath} ${t.message}`.trim())??[]}};getWritableEntityKeys=(t,e)=>{let r=i(t),o=this._context.selectors.getDomainExpressions()[r];return e.filter(t=>"id"!==t&&"type"!==t&&"_raw"!==t&&o?.[t]===void 0)}}
+import{createCacheToken as t,getStickyCache as e}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as i}from"./model/index.js";let r=t(),o=t();export class Domain{_context;constructor(t){this._context=t}getEntity=(t,i)=>{let r=e(i,o),n=r.get("entityMap");if(n)return n.get(t);let s=(t=>{let e=new Map;for(let i of t){if(e.has(i.id))throw Error(`Error while creating a UniqueEntityMap for caching of domain queries. Duplicate entity id ${i.id} encountered!`);e.set(i.id,i)}return e})(i.entities);return r.put("entityMap",s),s.get(t)};get$Entity=(t,i)=>{let o=e(i,r),n=o.get(t);if(n)return n;let s=this.getEntity(t,i);if(!s)throw Error(`Entity ${t} does not exist`);let a={...s},l=this._context.selectors.getDomainExpressions()[s.type];return l&&Object.entries(l).forEach(([t,e])=>{Object.defineProperty(a,t,{enumerable:!0,get:()=>e.evaluate(s.id,i,this._context.selectors.getExpressionContext())})}),Object.defineProperty(a,"_raw",{enumerable:!0,writable:!1,value:s}),Object.defineProperty(a,"_state",{enumerable:!1,writable:!1,value:i}),o.put(t,a),a};get$Entities=(t,e)=>t.map(t=>this.get$Entity(t,e));getRoot$Entity=t=>this.get$Entity(t.rootEntityId,t);validateExpressions=t=>{if(!this._context.selectors.getAllowedRootEntityTypes().includes(t.rootEntityType))throw Error(`Entity type ${t.rootEntityType} is not allowed as root entity`);if(!this.getEntity(t.rootEntityId,t))throw Error(`Root entity ${t.rootEntityId} was not found!`);t.entities.forEach(e=>{let i=this._context.selectors.getDomainExpressions()[e.type];void 0!==i&&Object.values(i).forEach(i=>{!0===i.meta.alwaysEvaluate&&i.evaluate(e.id,t,this._context.selectors.getExpressionContext())})})};validateEntity=t=>{let e=this._context.selectors.getEntityReflections()[t.type];if(!e)throw Error(`Unknown entity type ${t.type}`);return e._meta.validator(t)?{success:!0}:{success:!1,errors:e._meta.validator.errors?.map(t=>`${t.instancePath} ${t.message}`.trim())??[]}};getWritableEntityKeys=(t,e)=>{let r=i(t),o=this._context.selectors.getDomainExpressions()[r];return e.filter(t=>"id"!==t&&"type"!==t&&"_raw"!==t&&o?.[t]===void 0)}}

package/dist/domain/core/index.d.ts

@@ -1,4 +1,4 @@
-export * from './action/index.js';
+export type * from './action/index.js';
 export * from './component/index.js';
 export type * from './data-schema/index.js';
 export * from './decoder/index.js';

package/dist/domain/core/index.js

@@ -1 +1 @@
-export*from"./action/index.js";export*from"./component/index.js";export*from"./decoder/index.js";export*from"./domain-factory.js";export*from"./domain.js";export*from"./expression/index.js";export*from"./invariant/index.js";export*from"./model/index.js";export*from"./recipe/index.js";export*from"./relation/index.js";export*from"./schema/index.js";export*from"./state/index.js";
+export*from"./component/index.js";export*from"./decoder/index.js";export*from"./domain-factory.js";export*from"./domain.js";export*from"./expression/index.js";export*from"./invariant/index.js";export*from"./model/index.js";export*from"./recipe/index.js";export*from"./relation/index.js";export*from"./schema/index.js";export*from"./state/index.js";

package/dist/domain/core/invariant/violation.d.ts

@@ -15,8 +15,9 @@ declare const VIOLATION_SEVERITIES: readonly [
  */
 'fatal', 
 /**
- * Similar semantics to `fatal` - i.e. the violation will never be propagated to the scene, undo stack or saved
- * - but unlike `fatal`, "dry-run" will allow the change and expect a custom logic to suggest or apply a fix.
+ * Same semantics as `fatal` - i.e. the violation will never be propagated to the scene, undo stack or saved, and a
+ * control's "dry-run" disables the option that would cause it. It marks a violation a transformer repairs: the
+ * transformers run before validation, so a change they repair commits with the fix applied.
  */
 'fixable', 
 /**

package/dist/domain/core/schema/extended-schema-validator.js

@@ -1 +1 @@
-import{createAjvSchemaValidator as e}from"./create-ajv-schema-validator.js";import{createCspSchemaValidator as a}from"./create-csp-schema-validator.js";let t="csp-compatible"===globalThis.PHX_SCHEMA_VALIDATOR?a:e;export const getExtendedSchemaValidator=()=>{let e=t();return e.addKeyword("tsType"),e.addKeyword("import"),e.addKeyword("declared"),e};export const extendedSchemaValidator=getExtendedSchemaValidator();
+import{createAjvSchemaValidator as e}from"./create-ajv-schema-validator.js";import{createCspSchemaValidator as a}from"./create-csp-schema-validator.js";export const getExtendedSchemaValidator=()=>{let t="csp-compatible"===globalThis.PHX_SCHEMA_VALIDATOR?a():e();return t.addKeyword("tsType"),t.addKeyword("import"),t.addKeyword("declared"),t};export const extendedSchemaValidator=getExtendedSchemaValidator();

package/dist/domain/domain-builder/domain-builder.d.ts

@@ -0,0 +1,46 @@
+import { type ExtendedJsonSchema } from '@salsita-ai/common/utils';
+import { type $DomainEntity, type $DomainEntityReflection, type ActionDefinition, type AliasMap, type AliasedExpressions, type AnyActionImplementations, type DomainEntity, DomainFactory, type EntityByType, type EntityReflections, type MigrateFunction, type SchemaOfObject } from '../core/index.js';
+import { type ProjectModule } from '../spec/index.js';
+type $EntityReflections<ENTITIES extends DomainEntity<string>> = {
+    [TYPE in ENTITIES['type']]: $DomainEntityReflection<$DomainEntity<EntityByType<ENTITIES, TYPE>>>;
+};
+export declare class DomainBuilder<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, ALIASES extends Readonly<Record<string, ENTITIES>>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> {
+    private readonly entities;
+    private readonly aliasMap;
+    private readonly $entityReflections;
+    private readonly allowedRootEntityTypes;
+    private readonly implemented;
+    private readonly modelVersion;
+    private readonly publishedData;
+    private readonly sessionData;
+    private readonly frontendData;
+    private readonly backendData;
+    private readonly migrate;
+    private readonly isAdminDomain;
+    private readonly actions;
+    private readonly actionImplementations;
+    private constructor();
+    static from<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ALIASES extends Readonly<Record<string, ENTITIES>>>(entities: EntityReflections<ENTITIES>, aliasMap: AliasMap<ALIASES>, $entityReflections: $EntityReflections<ENTITIES>, allowedRootEntityTypes: ReadonlyArray<ALLOWED_ROOT_ENTITIES['type']>, modelVersion: number, publishedData: SchemaOfObject<PUBLISHED_DATA>, sessionData: SchemaOfObject<SESSION_DATA>, frontendData: SchemaOfObject<FRONTEND_DATA>, backendData: ExtendedJsonSchema | undefined, isAdminDomain: boolean): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    withMigrate(migration: MigrateFunction<ENTITIES>): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    withExpressions(implementation: AliasedExpressions<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ALIASES>): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    /**
+     * Adds the expressions of the `src/expressions/` files, as the generated barrel lists them. The
+     * files are merged by `mergeExpressionModules`, which checks each one and throws every wrong file,
+     * every expression defined twice and every expression the domain already has, such as a generated
+     * one, together as one `ImplementationErrors` of `DUPLICATE_DEFINITION`s.
+     */
+    withExpressionModules(modules: readonly ProjectModule[]): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    /**
+     * Adds expressions already expanded to entity types, each with its origin. An expression that the
+     * domain, or an earlier one of the list, defines for the same entity type is an error.
+     */
+    private withEntityExpressions;
+    /** Declares the actions of the domain, as the generated `domain-spec.ts` reads them from the spec's `actions` section. */
+    withActions(actions: readonly ActionDefinition[]): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    /** Adds the action implementations of the `src/actions/` files, as the generated barrel lists them, after checking each file against the folder's contract. */
+    withActionModules(modules: readonly ProjectModule[]): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    /** Adds the implementations of the declared actions, already merged by action name. */
+    withActionImplementations(implementations: AnyActionImplementations): DomainBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, ALIASES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+    build: () => DomainFactory<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
+}
+export {};

package/dist/domain/domain-builder/domain-builder.js

@@ -0,0 +1 @@
+import{DomainFactory as t,createMigrateFunction as i,expandAlias as e}from"../core/index.js";import{mergeExpressionModules as s,resolveActionModules as n}from"../spec/index.js";import{withProfilerLabel as a}from"../utils/index.js";export class DomainBuilder{entities;aliasMap;$entityReflections;allowedRootEntityTypes;implemented;modelVersion;publishedData;sessionData;frontendData;backendData;migrate;isAdminDomain;actions;actionImplementations;constructor(t,i,e,s,n,a,o,h,l,m,r,d,p,c){this.entities=t,this.aliasMap=i,this.$entityReflections=e,this.allowedRootEntityTypes=s,this.implemented=n,this.modelVersion=a,this.publishedData=o,this.sessionData=h,this.frontendData=l,this.backendData=m,this.migrate=r,this.isAdminDomain=d,this.actions=p,this.actionImplementations=c}static from(t,e,s,n,a,o,h,l,m,r){let d=i({1:t},1,{});return new DomainBuilder(t,e,s,n,{},a,o,h,l,m,d,r,{},{})}withMigrate(t){return new DomainBuilder(this.entities,this.aliasMap,this.$entityReflections,this.allowedRootEntityTypes,this.implemented,this.modelVersion,this.publishedData,this.sessionData,this.frontendData,this.backendData,t,this.isAdminDomain,this.actions,this.actionImplementations)}withExpressions(t){let i=Object.entries(t);return this.withEntityExpressions(i.flatMap(([t,i])=>e(this.aliasMap,t).flatMap(e=>Object.entries(i).map(([i,s])=>({type:e,expression:{...s,origin:{name:i,typeOrAlias:t}}})))))}withExpressionModules(t){let i=new Map(Object.entries(this.implemented).map(([t,i])=>[t,new Set(Object.keys(i))]));return this.withEntityExpressions(Object.entries(s(t,this.aliasMap,void 0,i)).flatMap(([t,i])=>Object.values(i).map(i=>({type:t,expression:i}))))}withEntityExpressions(t){let i={...this.implemented};return t.forEach(({type:t,expression:e})=>{let{name:s,typeOrAlias:n}=e.origin,o={...i[t]},h=o[s];if(h)throw Error(`Duplicate expression ${t}.${s}: The expression is defined on both ${n} and ${h.origin.typeOrAlias}, which would lead to ambiguous usage. Please ensure that expressions are only defined once.`);o[s]={...e,evaluate:a(`${t}_${s}`,e.evaluate)},i[t]=o}),new DomainBuilder(this.entities,this.aliasMap,this.$entityReflections,this.allowedRootEntityTypes,i,this.modelVersion,this.publishedData,this.sessionData,this.frontendData,this.backendData,this.migrate,this.isAdminDomain,this.actions,this.actionImplementations)}withActions(t){return new DomainBuilder(this.entities,this.aliasMap,this.$entityReflections,this.allowedRootEntityTypes,this.implemented,this.modelVersion,this.publishedData,this.sessionData,this.frontendData,this.backendData,this.migrate,this.isAdminDomain,Object.fromEntries(t.map(t=>[t.name,t])),this.actionImplementations)}withActionModules(t){return this.withActionImplementations(n(t))}withActionImplementations(t){return new DomainBuilder(this.entities,this.aliasMap,this.$entityReflections,this.allowedRootEntityTypes,this.implemented,this.modelVersion,this.publishedData,this.sessionData,this.frontendData,this.backendData,this.migrate,this.isAdminDomain,this.actions,{...this.actionImplementations,...t})}build=()=>{let e=this.implemented,s=this.migrate??i({1:this.entities},1,{});return new t({aliasMap:this.aliasMap,entityReflections:this.entities,$entityReflections:this.$entityReflections,expressions:e,allowedRootEntityTypes:this.allowedRootEntityTypes,modelVersion:this.modelVersion,migrate:s,publishedData:this.publishedData,sessionData:this.sessionData,frontendData:this.frontendData,backendData:this.backendData,isAdminDomain:this.isAdminDomain,actions:this.actions,actionImplementations:this.actionImplementations})}}

package/dist/domain/domain-builder/index.d.ts

@@ -0,0 +1 @@
+export { DomainBuilder } from './domain-builder.js';

package/dist/domain/domain-builder/index.js

@@ -0,0 +1 @@
+export{DomainBuilder}from"./domain-builder.js";

package/dist/domain/domain-context/action-system/action-system.d.ts

@@ -1,5 +1,5 @@
-import { type $DomainEntity, type ActionTypes, type DomainEntity, type DomainState, type PreparedAction } from '../../core/index.js';
-import type { ActionContext, DomainContextSelectors } from '../../domain-runtime/index.js';
+import { type ActionTypes, type DomainEntity, type DomainState, type PreparedAction } from '../../core/index.js';
+import type { DomainContextSelectors } from '../../domain-runtime/index.js';
 export interface ActionSystemContext {
     /**
      * The action system's window into the runtime registry: the declared actions and their
@@ -9,14 +9,14 @@ export interface ActionSystemContext {
     readonly selectors: DomainContextSelectors;
 }
 /** ActionSystem with its types erased — how the runtime selectors expose the instance. */
-export type AnyActionSystem = ActionSystem<any, any, any, any, any, any, any, any, any, any, any>;
+export type AnyActionSystem = ActionSystem<any, any>;
 /**
  * Runs the actions an application declares under `actions` and implements in `src/actions/`. It
  * only prepares: an action gets the state it is called on and returns the updates it wants applied
  * with a reader for its result, and the caller stages, commits or dry-runs them. Every caller of an
  * action goes through it, so all of them run the same domain logic.
  */
-export declare class ActionSystem<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, ACTION_TYPES extends ActionTypes> {
+export declare class ActionSystem<ENTITIES extends DomainEntity<string>, ACTION_TYPES extends ActionTypes> {
     private readonly _context;
     /** One compiled validator per declared action, rebuilt only when the declarations change. */
     private readonly _selectValidators;
@@ -26,7 +26,33 @@ export declare class ActionSystem<ENTITIES extends DomainEntity<string>, ALLOWED
      * The context an implementation runs with on `state`. Code that prepares updates outside an
      * action can run on the same context, so it can do everything an action can, the same way.
      */
-    readonly createContext: (state: DomainState<ENTITIES>) => ActionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>;
+    readonly createContext: (state: DomainState<ENTITIES>) => {
+        expressionContext: import("../../index.js").AnyExpressionContext;
+        systems: import("../domain-context-systems.js").AnyDomainContextSystems;
+        getIdSequence: () => import("../../index.js").IdSequence<ENTITIES>;
+        updates: {
+            ComponentModification: <COMPONENT_TYPE extends import("../../index.js").SystemComponentTypeConstraint>(details: {
+                readonly componentInstance: import("../../index.js").OneComponentFilter<COMPONENT_TYPE>;
+            } & (COMPONENT_TYPE extends import("../../index.js").SystemComponentType<any, Record<never, never>, never> ? Omit<import("../../index.js").ComponentModification<COMPONENT_TYPE>, "componentInstance" | "entityId" | "initialState" | "kind" | "writableState"> : Omit<import("../../index.js").ComponentModification<COMPONENT_TYPE>, "componentInstance" | "entityId" | "kind">)) => import("../../index.js").ComponentModification<COMPONENT_TYPE>;
+            DomainEntityCreation: <ENTITY extends ENTITIES, PARENT extends ENTITIES>(details: Omit<import("../../index.js").DomainEntityCreation<ENTITY, PARENT>, "entityId" | "kind">) => import("../../index.js").DomainEntityCreation<ENTITY, PARENT>;
+            DomainEntityReplacement: <ENTITY extends ENTITIES>(details: Omit<import("../../index.js").DomainEntityReplacement<ENTITY>, "kind">) => import("../../index.js").DomainEntityReplacement<ENTITY>;
+            EphemeralRecordCreation: <COMPONENT_TYPE extends import("../../index.js").SystemComponentTypeConstraint>(details: {
+                readonly componentInstance: import("../../index.js").OneComponentFilter<COMPONENT_TYPE>;
+            } & (COMPONENT_TYPE extends import("../../index.js").SystemComponentType<any, Record<never, never>, never> ? Omit<import("../../index.js").EphemeralRecordCreation<COMPONENT_TYPE>, "componentInstance" | "entityId" | "initialState" | "kind" | "writableState"> : Omit<import("../../index.js").EphemeralRecordCreation<COMPONENT_TYPE>, "componentInstance" | "entityId" | "kind">)) => import("../../index.js").EphemeralRecordCreation<COMPONENT_TYPE>;
+            DomainEntityModification: <TYPE extends ENTITIES["type"]>(details: Omit<import("../../index.js").DomainEntityModification<Extract<ENTITIES, {
+                type: TYPE;
+            }>>, "kind">) => import("../../index.js").DomainEntityModification<Extract<ENTITIES, {
+                type: TYPE;
+            }>>;
+            EphemeralRecordModification: <COMPONENT_TYPE extends import("../../index.js").SystemComponentTypeConstraint>(details: {
+                readonly componentInstance: import("../../index.js").OneComponentFilter<COMPONENT_TYPE>;
+            } & (COMPONENT_TYPE extends import("../../index.js").SystemComponentType<any, Record<never, never>, never> ? Omit<import("../../index.js").EphemeralRecordModification<COMPONENT_TYPE>, "componentInstance" | "entityId" | "initialState" | "kind" | "writableState"> : Omit<import("../../index.js").EphemeralRecordModification<COMPONENT_TYPE>, "componentInstance" | "entityId" | "kind">)) => import("../../index.js").EphemeralRecordModification<COMPONENT_TYPE>;
+            EphemeralRecordDeletion: <COMPONENT_TYPE extends import("../../index.js").SystemComponentTypeConstraint>(details: {
+                readonly componentInstance: import("../../index.js").OneComponentFilter<COMPONENT_TYPE>;
+            } & (COMPONENT_TYPE extends import("../../index.js").SystemComponentType<any, Record<never, never>, never> ? Omit<import("../../index.js").EphemeralRecordDeletion<COMPONENT_TYPE>, "componentInstance" | "entityId" | "initialState" | "kind" | "writableState"> : Omit<import("../../index.js").EphemeralRecordDeletion<COMPONENT_TYPE>, "componentInstance" | "entityId" | "kind">)) => import("../../index.js").EphemeralRecordDeletion<COMPONENT_TYPE>;
+            EntityDeletion: <ENTITY extends ENTITIES>(details: Omit<import("../../index.js").EntityDeletion<ENTITY>, "kind">) => import("../../index.js").EntityDeletion<ENTITY>;
+        };
+    };
     /**
      * Prepares the action `name` with `args` on `state`. The arguments are validated against the
      * params schema the action declares, and the implementation is called with the validated
@@ -34,5 +60,5 @@ export declare class ActionSystem<ENTITIES extends DomainEntity<string>, ALLOWED
      * action, arguments that do not fit the schema, or a declared action without an implementation.
      * The result of `readResult` is not validated: the generated type is its contract.
      */
-    readonly prepareAction: <NAME extends keyof ACTION_TYPES & string>(name: NAME, args: unknown, state: DomainState<ENTITIES>) => PreparedAction<ENTITIES, ACTION_TYPES[NAME]['result']>;
+    readonly prepareAction: <NAME extends keyof ACTION_TYPES & string>(name: NAME, args: ACTION_TYPES[NAME]['params'], state: DomainState<ENTITIES>) => PreparedAction<ENTITIES, ACTION_TYPES[NAME]['result']>;
 }

package/dist/domain/domain-context/action-system/action-system.js

@@ -1 +1 @@
-import{createSelector as t}from"@salsita-ai/common/utils";import{createUpdateFactory as e,extendedSchemaValidator as s}from"../../core/index.js";import{getIdSequence as n}from"../store-system/index.js";export class ActionSystem{_context;_selectValidators=t([t.leaf(t=>t)],t=>new Map(Object.values(t).map(t=>[t.name,s.compile(t.params)])));_updates=e();constructor(t){this._context=t}createContext=t=>({expressionContext:this._context.selectors.getExpressionContext(),systems:this._context.selectors.getDomainSystems(),getIdSequence:()=>n(t.entities,[]),updates:this._updates});prepareAction=(t,e,n)=>{let o=this._context.selectors.getActionDefinitions(),i=Object.values(o).find(e=>e.name===t);if(!i){let e=Object.values(o).map(t=>`"${t.name}"`);throw Error(`Unknown action "${t}". ${e.length>0?`The application declares these actions: ${e.join(", ")}.`:"The application declares no actions."} Declare it under "actions" in a spec file and implement it in src/actions/.`)}let a=this._selectValidators(o).get(i.name);if(a&&!a(e))throw Error(`The arguments of action "${t}" do not fit its params: ${s.errorsText(a.errors)}. Nothing was changed. Send arguments that fit the params the action declares.`);return(Object.entries(this._context.selectors.getActionImplementations()).find(([e])=>e===t)?.[1])(e,n,this.createContext(n))}}
+import{createSelector as t}from"@salsita-ai/common/utils";import{createUpdateFactory as e,extendedSchemaValidator as s}from"../../core/index.js";import{getIdSequence as o}from"../store-system/index.js";export class ActionSystem{_context;_selectValidators=t([t.leaf(t=>t)],t=>new Map(Object.values(t).map(t=>[t.name,s.compile(t.params)])));_updates=e();constructor(t){this._context=t}createContext=t=>{let e=this._context.selectors.getDomainSystems(),s=this._context.selectors.getHostSystems(),n=Object.keys(s);for(let t of n)if(Object.hasOwn(e,t))throw Error(`Cannot expose action systems: host system "${t}" conflicts with a domain system. Rename the extension system so it does not replace a domain capability.`);return{expressionContext:this._context.selectors.getExpressionContext(),systems:0===n.length?e:{...e,...s},getIdSequence:()=>o(t.entities,[]),updates:this._updates}};prepareAction=(t,e,o)=>{let n=this._context.selectors.getActionDefinitions(),i=Object.values(n).find(e=>e.name===t);if(!i){let e=Object.values(n).map(t=>`"${t.name}"`);throw Error(`Unknown action "${t}". ${e.length>0?`The application declares these actions: ${e.join(", ")}.`:"The application declares no actions."} Declare it under "actions" in a spec file and implement it in src/actions/.`)}let a=this._selectValidators(n).get(i.name);if(a&&!a(e))throw Error(`The arguments of action "${t}" do not fit its params: ${s.errorsText(a.errors)}. Nothing was changed. Send arguments that fit the params the action declares.`);return(Object.entries(this._context.selectors.getActionImplementations()).find(([e])=>e===t)?.[1])(e,o,this.createContext(o))}}

package/dist/domain/domain-context/domain-context-systems.d.ts

@@ -30,7 +30,7 @@ export interface DomainContextSystems<ENTITIES extends DomainEntity<string>, ALL
     readonly dimensionSystem: DimensionSystem<ENTITIES>;
     readonly undoSystem: UndoSystem<ENTITIES, $MAP>;
     readonly recipeCooker: RecipeCookerSystem<ENTITIES>;
-    readonly actionSystem: ActionSystem<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, Record<string, unknown>, Record<string, unknown>, Record<string, unknown>, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, ACTION_TYPES>;
+    readonly actionSystem: ActionSystem<ENTITIES, ACTION_TYPES>;
     readonly sketchingProjections: SketchingProjections<ENTITIES>;
     readonly collisionProjections: CollisionProjections<ENTITIES>;
     readonly positionProjections: PositionProjections<ENTITIES>;

package/dist/domain/domain-context/index.d.ts

@@ -2,7 +2,7 @@ export { type AnalyticsSystem, NoopAnalyticsSystem, type AnalyticsEvent, Analyti
 export { NavigationUpdateTag, isInitialNavigationUpdate, isNavigationUpdate, isInitialViewUpdate, isViewUpdate, isInitialSelectionUpdate, isSelectUpdate, isDeselectUpdate, isInitialFullscreenUpdate, isToggleFullscreenUpdate, isInitialDebugUpdate, isInitialViewportUpdate, isSetViewportUpdate, isInitialDragUpdate, isDragStartUpdate, isDragEndUpdate, isInitialToolUpdate, isToolUpdate, isExportUpdate, createAutoSelectionTransformer, NavigationSystem, type NavigationSystemContext, createResetSelectionOnNavigationTransformer, createNavigationOnSelectionTransformer, createNavigationOnDeselectTransformer, createSelectParentOnDeselectionTransformer, createNavigationOnSelectionChangeTransformer, type AnyNavigationSystem, } from './navigation-system/index.js';
 export { StoreSystem, type TransformerRegistration, type UpdateTransformer, type TransformerLogFunction, type Transformers, type StateSliceName, type StateEmissionKind, type CommitPreparedOutcome, nextDomainEntityId, getIdSequence, applyUpdates, SystemState, SystemStateInitialUpdateTag, SystemStateUpdateTag, type SystemStateContext, type AnyCreateTransformersFactory, type AnyStoreSystem, type Unregister, } from './store-system/index.js';
 export { createRefReplaceTransformer, createCascadeDeletesTransformer, createCascadeRefPruningTransformer, createCreateEntityRefsTransformer, } from './relation-transformers/index.js';
-export { type CanBeUndonePredicate, type CanBeUndoneContext, type UndoCapabilities, UndoSystem, UNDO_REDO_RESET_TAG, isUndoRedoReset, type AnyUndoSystem, } from './undo-system.js';
+export { type CanBeUndonePredicate, type CanBeUndoneContext, type UndoCapabilities, type UndoStep, UndoSystem, UNDO_REDO_RESET_TAG, isUndoRedoReset, type AnyUndoSystem, } from './undo-system.js';
 export { DimensionSystem, type AnyDimensionSystem, type DimensionSystemContext, type AngleDimensionViolation, type DistanceDimensionViolation, type GenericDimensionViolation, } from './dimension-system/index.js';
 export { ActionSystem, type AnyActionSystem, type ActionSystemContext } from './action-system/index.js';
 export { RecipeCookerSystem, type AnyRecipeCookerSystem, type RecipeCookerSystemContext, ReplaceRecipeUpdateTag, isReplaceEntityUpdate, type IsReplaceRecipeUpdate, CreateRecipeUpdateTag, isCreateEntityUpdate, type IsCreateRecipeUpdate, } from './recipe-system/index.js';

package/dist/domain/domain-context/store-system/store-system.d.ts

@@ -53,6 +53,11 @@ export declare class StoreSystem<ENTITIES extends DomainEntity<string>, $MAP ext
     private readonly _context;
     readonly stateSlices: Readonly<Record<StateSliceName, ObservableWithLastValue<StateEmission<ENTITIES, $MAP>>>>;
     get isInitialized(): boolean;
+    /**
+     * True while a change the user is making, such as a drag, is staged and neither committed nor
+     * rolled back. A hover is shown through a staged emission too, but stages no updates.
+     */
+    get hasStagedUpdates(): boolean;
     private _onBeforeCommitHooks;
     private readonly committed;
     private readonly potentiallyInvalid;

package/dist/domain/domain-context/store-system/store-system.js

@@ -1,2 +1,2 @@
-import{CompositeKeyMap as e,assertExistence as t,isEqualArray as i}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as r,dragStateComponent as o,getComponentSystemFilterState as s,hoverStateComponent as n,isEqualComponentInstance as a,isSystemViewportStateComponentSnapshot as d,isVirtualEntityId as m,selectionStateComponent as l,systemUpdateFactory as c,systemVirtualEntityId as p}from"../../core/index.js";import{projectedEntitiesComponent as h}from"../../system-components/index.js";import{cloneEvalCache as v,createEvalCacheToken as f,getEvalCache as g,setEvalCache as u}from"../../utils/eval-cache.js";import{createCascadeDeletesTransformer as y,createCascadeRefPruningTransformer as S}from"../relation-transformers/index.js";import{applyUpdates as I}from"./apply-updates.js";import{LifecycleStateSlice as _}from"./lifecycle-state-slice.js";import{mergeReconciliationsUpdates as x,reconcileProjectedEntities as T}from"./reconcile-projected-entities.js";let E={uninitializedError:"StoreSystem is not initialized."},k=f({clone:e=>e}),w=class InvalidInitialStateError extends Error{emission;childError;constructor(e,t,i){let r="";"uncaught"===e.validity.severity&&(r=`: ${e.validity.error.message}`),("fatal"===e.validity.severity||"fixable"===e.validity.severity)&&(r=`: ${e.validity.entityViolations.map(e=>{let i=e.violation.message;return null!=i?t(i):e.violation.type}).join(", ")}`),super(`Initial state is not valid! Severity: ${e.validity.severity}, Cause: ${r}`),this.emission=e,this.childError=i,this.name="InvalidInitialStateError"}},b=(e,t)=>{try{return e()}catch(e){throw t(e),e}};export class StoreSystem{_context;stateSlices;get isInitialized(){return this.committed.isInitialized}_onBeforeCommitHooks=[];committed=new _(E);potentiallyInvalid=new _(E);rendered=new _(E);stagedUpdates=void 0;transformToDataUpdates=(e,t)=>{let i=!1,r=e.map(e=>"modifyComponent"===e.kind?(i=!0,this.componentModificationToDataUpdate(e,t)):e);return i?r:e};createInitialTransformPipe=()=>[{transformer:this.transformToDataUpdates,priority:1/0,registrationToken:{},name:"TransformToDataUpdates"}];transformPipe=this.createInitialTransformPipe();_cascadeDeletesTransformer=(...e)=>(this._cascadeDeletesTransformerMemo??=y(this._context.selectors.getCompositionProjections()))(...e);_cascadeDeletesTransformerMemo;_refPruningTransformer=(...e)=>(this._refPruningTransformerMemo??=S(this._context.selectors.getComponentReader()))(...e);_refPruningTransformerMemo;_deselectOnDeleteTransformer=(e,t)=>{let i=new Set(e.filter(e=>"deleteEntity"===e.kind).map(e=>e.entityId));if(0===i.size)return e;let r=s(t).selectedEntityId;return r&&i.has(r)?[...e,c.EphemeralRecordModification({componentInstance:{entityId:p,componentType:l},updateTag:"AutoDeselectRemovedProjectedEntity",writableState:{selectedEntityId:t.rootEntityId}})]:e};constructor(e){this._context=e,this.stateSlices={committed:this.committed.observable,rendered:this.rendered.observable,potentiallyInvalid:this.potentiallyInvalid.observable}}_validateState=e=>this._context.selectors.getValidationProjections().validateState(e);initialize=()=>{let e=this._context.selectors.getInitialDomainState();this.stagedUpdates=void 0;let t=this._validateState(e),i={kind:"reset",state:e,validity:t,tag:void 0,transformationLog:void 0},r=i;if(!r.validity.valid&&"fatal"===r.validity.severity||"fixable"===r.validity.severity){this._context.domainServicesSelectors.getLogger().debug("Trying to fix initial emission:",r);let e=r.state,{transformedUpdates:t,transformationLog:i}=this.applyTransformers([],e,"committed"),o=I(this.transformToDataUpdates(t,e),e);v(e,o),r={kind:"reset",state:o,validity:this._validateState(o),tag:"fixed",transformationLog:i}}if(!r.validity.valid){if(this._context.domainServicesSelectors.getLogger().error("Invalid initial emission:",{initialEmission:i,fixedEmission:r}),"uncaught"===r.validity.severity)throw new w(r,this._context.domainServicesSelectors.getResolveLocalizable(),r.validity.error??void 0);throw new w(r,this._context.domainServicesSelectors.getResolveLocalizable())}this.committed.next(r),this.rendered.next(r),this.potentiallyInvalid.next(r)};registerTransformer(e,i,r){let o={};return((e,i,r)=>{let o=0;for(;o<e.length&&0>=r(t(e[o]),i);)o++;e.splice(o,0,i)})(this.transformPipe,{registrationToken:o,transformer:i,priority:e,name:r},(e,t)=>e.priority===t.priority?0:e.priority<t.priority?-1:1),()=>{let e=this.transformPipe.findIndex(e=>e.registrationToken===o);-1!==e&&this.transformPipe.splice(e,1)}}onBeforeCommit(e){return this._onBeforeCommitHooks.push(e),()=>{this._onBeforeCommitHooks=this._onBeforeCommitHooks.filter(t=>t!==e)}}componentModificationToDataUpdate=(e,t)=>{let i=e.entityId;if(!m(i)){let t=this._context.selectors.getComponentReaderIndexes().opticMap.get(r(i))?.get(e.componentInstance.componentType)?.get(e.componentInstance.instanceName);if(t?.kind==="simple"){let r=t.write(e.writableState);return{kind:"modifyDomainEntity",entityId:i,updateTag:e.updateTag,stateDelta:r,hint:e.hint,agentHint:e.agentHint,origin:e}}}let o=t.ephemeralRecords.find(t=>a(t.componentInstance,e.componentInstance));if(o)return{kind:"modifyEphemeralRecord",entityId:e.entityId,updateTag:e.updateTag,componentInstance:o.componentInstance,writableState:e.writableState,hint:e.hint,agentHint:e.agentHint};throw Error(`Component ${e.componentInstance.componentType.name} is not attached on entity #${e.entityId}`)};getNewState=(e,t)=>{let i=I(this.transformToDataUpdates(e,t),t);return v(this.rendered.isInitialized?this.rendered.value.state:t,i),i};applyTransformers(e,t,i){let r=this._context.environmentSelectors.getEnvironmentIsDev()?[]:void 0;return{transformedUpdates:this.transformPipe.reduce((e,{transformer:o,name:s})=>{let n,a=r?[]:void 0,d=a?(e,t,i)=>{n=e,a.push({phase:e,message:t,data:i})}:void 0,m=b(()=>o(e,t,i,d),o=>{this._context.domainServicesSelectors.getLogger().error("Error while applying transformer!",{name:s,updates:e,previousState:t,kind:i,transformationLog:r},o instanceof Error?o:Error(String(o)))});return a&&r&&r.push({name:s,status:n??(m===e?"no-event":"apply"),entries:a,updatesIn:e,updatesOut:m}),m},e),transformationLog:r}}_updateProjectedEntities(e,t,r){if(!e.validity.valid)return e;let o=this._context.selectors.getComponentReader().readManyComponents({componentTypes:[h]},e.state),s=g(e.previousState,k);if(s&&i(s,o))return e;let n=0,a=e,d=[];for(;a.validity.valid;){n++;let i=T(a.state.entities,o,t);if(0===i.length)break;if(n>10)throw Error(`Maximum number of reconciliation rounds reached: 10. Projected entities seem to be recursively depending on themselves.
+import{CompositeKeyMap as e,assertExistence as t,isEqualArray as i}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as r,dragStateComponent as o,getComponentSystemFilterState as s,hoverStateComponent as n,isEqualComponentInstance as a,isSystemViewportStateComponentSnapshot as d,isVirtualEntityId as m,selectionStateComponent as l,systemUpdateFactory as c,systemVirtualEntityId as p}from"../../core/index.js";import{projectedEntitiesComponent as h}from"../../system-components/index.js";import{cloneEvalCache as v,createEvalCacheToken as f,getEvalCache as g,setEvalCache as u}from"../../utils/eval-cache.js";import{createCascadeDeletesTransformer as y,createCascadeRefPruningTransformer as S}from"../relation-transformers/index.js";import{applyUpdates as I}from"./apply-updates.js";import{LifecycleStateSlice as _}from"./lifecycle-state-slice.js";import{mergeReconciliationsUpdates as x,reconcileProjectedEntities as T}from"./reconcile-projected-entities.js";let E={uninitializedError:"StoreSystem is not initialized."},k=f({clone:e=>e}),w=class InvalidInitialStateError extends Error{emission;childError;constructor(e,t,i){let r="";"uncaught"===e.validity.severity&&(r=`: ${e.validity.error.message}`),("fatal"===e.validity.severity||"fixable"===e.validity.severity)&&(r=`: ${e.validity.entityViolations.map(e=>{let i=e.violation.message;return null!=i?t(i):e.violation.type}).join(", ")}`),super(`Initial state is not valid! Severity: ${e.validity.severity}, Cause: ${r}`),this.emission=e,this.childError=i,this.name="InvalidInitialStateError"}},b=(e,t)=>{try{return e()}catch(e){throw t(e),e}};export class StoreSystem{_context;stateSlices;get isInitialized(){return this.committed.isInitialized}get hasStagedUpdates(){return void 0!==this.stagedUpdates}_onBeforeCommitHooks=[];committed=new _(E);potentiallyInvalid=new _(E);rendered=new _(E);stagedUpdates=void 0;transformToDataUpdates=(e,t)=>{let i=!1,r=e.map(e=>"modifyComponent"===e.kind?(i=!0,this.componentModificationToDataUpdate(e,t)):e);return i?r:e};createInitialTransformPipe=()=>[{transformer:this.transformToDataUpdates,priority:1/0,registrationToken:{},name:"TransformToDataUpdates"}];transformPipe=this.createInitialTransformPipe();_cascadeDeletesTransformer=(...e)=>(this._cascadeDeletesTransformerMemo??=y(this._context.selectors.getCompositionProjections()))(...e);_cascadeDeletesTransformerMemo;_refPruningTransformer=(...e)=>(this._refPruningTransformerMemo??=S(this._context.selectors.getComponentReader()))(...e);_refPruningTransformerMemo;_deselectOnDeleteTransformer=(e,t)=>{let i=new Set(e.filter(e=>"deleteEntity"===e.kind).map(e=>e.entityId));if(0===i.size)return e;let r=s(t).selectedEntityId;return r&&i.has(r)?[...e,c.EphemeralRecordModification({componentInstance:{entityId:p,componentType:l},updateTag:"AutoDeselectRemovedProjectedEntity",writableState:{selectedEntityId:t.rootEntityId}})]:e};constructor(e){this._context=e,this.stateSlices={committed:this.committed.observable,rendered:this.rendered.observable,potentiallyInvalid:this.potentiallyInvalid.observable}}_validateState=e=>this._context.selectors.getValidationProjections().validateState(e);initialize=()=>{let e=this._context.selectors.getInitialDomainState();this.stagedUpdates=void 0;let t=this._validateState(e),i={kind:"reset",state:e,validity:t,tag:void 0,transformationLog:void 0},r=i;if(!r.validity.valid&&"fatal"===r.validity.severity||"fixable"===r.validity.severity){this._context.domainServicesSelectors.getLogger().debug("Trying to fix initial emission:",r);let e=r.state,{transformedUpdates:t,transformationLog:i}=this.applyTransformers([],e,"committed"),o=I(this.transformToDataUpdates(t,e),e);v(e,o),r={kind:"reset",state:o,validity:this._validateState(o),tag:"fixed",transformationLog:i}}if(!r.validity.valid){if(this._context.domainServicesSelectors.getLogger().error("Invalid initial emission:",{initialEmission:i,fixedEmission:r}),"uncaught"===r.validity.severity)throw new w(r,this._context.domainServicesSelectors.getResolveLocalizable(),r.validity.error??void 0);throw new w(r,this._context.domainServicesSelectors.getResolveLocalizable())}this.committed.next(r),this.rendered.next(r),this.potentiallyInvalid.next(r)};registerTransformer(e,i,r){let o={};return((e,i,r)=>{let o=0;for(;o<e.length&&0>=r(t(e[o]),i);)o++;e.splice(o,0,i)})(this.transformPipe,{registrationToken:o,transformer:i,priority:e,name:r},(e,t)=>e.priority===t.priority?0:e.priority<t.priority?-1:1),()=>{let e=this.transformPipe.findIndex(e=>e.registrationToken===o);-1!==e&&this.transformPipe.splice(e,1)}}onBeforeCommit(e){return this._onBeforeCommitHooks.push(e),()=>{this._onBeforeCommitHooks=this._onBeforeCommitHooks.filter(t=>t!==e)}}componentModificationToDataUpdate=(e,t)=>{let i=e.entityId;if(!m(i)){let t=this._context.selectors.getComponentReaderIndexes().opticMap.get(r(i))?.get(e.componentInstance.componentType)?.get(e.componentInstance.instanceName);if(t?.kind==="simple"){let r=t.write(e.writableState);return{kind:"modifyDomainEntity",entityId:i,updateTag:e.updateTag,stateDelta:r,hint:e.hint,agentHint:e.agentHint,origin:e}}}let o=t.ephemeralRecords.find(t=>a(t.componentInstance,e.componentInstance));if(o)return{kind:"modifyEphemeralRecord",entityId:e.entityId,updateTag:e.updateTag,componentInstance:o.componentInstance,writableState:e.writableState,hint:e.hint,agentHint:e.agentHint};throw Error(`Component ${e.componentInstance.componentType.name} is not attached on entity #${e.entityId}`)};getNewState=(e,t)=>{let i=I(this.transformToDataUpdates(e,t),t);return v(this.rendered.isInitialized?this.rendered.value.state:t,i),i};applyTransformers(e,t,i){let r=this._context.environmentSelectors.getEnvironmentIsDev()?[]:void 0;return{transformedUpdates:this.transformPipe.reduce((e,{transformer:o,name:s})=>{let n,a=r?[]:void 0,d=a?(e,t,i)=>{n=e,a.push({phase:e,message:t,data:i})}:void 0,m=b(()=>o(e,t,i,d),o=>{this._context.domainServicesSelectors.getLogger().error("Error while applying transformer!",{name:s,updates:e,previousState:t,kind:i,transformationLog:r},o instanceof Error?o:Error(String(o)))});return a&&r&&r.push({name:s,status:n??(m===e?"no-event":"apply"),entries:a,updatesIn:e,updatesOut:m}),m},e),transformationLog:r}}_updateProjectedEntities(e,t,r){if(!e.validity.valid)return e;let o=this._context.selectors.getComponentReader().readManyComponents({componentTypes:[h]},e.state),s=g(e.previousState,k);if(s&&i(s,o))return e;let n=0,a=e,d=[];for(;a.validity.valid;){n++;let i=T(a.state.entities,o,t);if(0===i.length)break;if(n>10)throw Error(`Maximum number of reconciliation rounds reached: 10. Projected entities seem to be recursively depending on themselves.
 If expressions populating 'projectedEntities' components rely on other projected entities, make sure that the dependencies do not have cycles.`);let s=(d=x(d,i)).map(e=>e.dataUpdate),m=this._cascadeDeletesTransformer(s,e.previousState,r,void 0,t),l=this._refPruningTransformer(m,e.previousState,r,void 0,t),c=this._deselectOnDeleteTransformer(l,e.previousState,r,void 0,t);if(!(a=this.prepareStateEmissionWithoutTransformation([...t,...c],e.previousState,r)).validity.valid)return this._context.domainServicesSelectors.getLogger().error("Reconciliation of projected entities led to an invalid state! Reconciliation skipped.",{emission:a}),e;o=this._context.selectors.getComponentReader().readManyComponents({componentTypes:[h]},a.state)}return u(a.state,k,o),a}prepareStateEmission(e,t,i){let{transformedUpdates:r,transformationLog:o}=this.applyTransformers(e,t,i),s=this.prepareStateEmissionWithoutTransformation(r,t,i);return{...this._updateProjectedEntities(s,r,i),transformationLog:o}}emissionCache=new e([Map,WeakMap,WeakMap,WeakMap,WeakMap]);getEmissionCacheKey=(e,t,i)=>[e,t,i,this._context.selectors.getStoreRuntimeDependencies(),this._context.selectors.getExpressionContext()];prepareStateEmissionWithoutTransformation=(e,t,i)=>{let r=this.getEmissionCacheKey(i,t,e),o=this.emissionCache.get(r);if(o)return o;let s=b(()=>this.transformToDataUpdates(e,t),r=>{this._context.domainServicesSelectors.getLogger().error("Error while transforming updates to data updates!",{updates:e,previousState:t,kind:i},r instanceof Error?r:Error(String(r)))}),n=b(()=>I(s,t),r=>{this._context.domainServicesSelectors.getLogger().error("Error while applying updates!",{updates:e,previousState:t,kind:i,dataUpdates:s},r instanceof Error?r:Error(String(r)))});v(this.rendered.isInitialized?this.rendered.value.state:t,n);let a=this._validateState(n);"uncaught"===a.severity&&this._context.domainServicesSelectors.getLogger().error("There was an uncaught validation error:",{updates:e,dataUpdates:s,previousState:t,newState:n,kind:i},a.error);let d={kind:i,previousState:t,state:n,updates:s,validity:a,transformationLog:void 0};return this.emissionCache.set(r,d),d};stage(e,t=!0){this.stagedUpdates=e;let i=this.prepareStateEmission(e,this.committed.value.state,"staged");return t&&this.emit(i),i}emit(e){"staged"===e.kind?e.validity.valid&&this.rendered.nextIfDifferent(e):(e.validity.valid?(this.committed.nextIfDifferent(e),this.rendered.nextIfDifferent(e)):this.rendered.nextIfDifferent(this.committed.value),this.potentiallyInvalid.nextIfDifferent(e))}commit=()=>{if(void 0===this.stagedUpdates)return;let e=this.prepareStateEmission(this.stagedUpdates,this.committed.value.state,"committed"),t=()=>{if(this._onBeforeCommitHooks.some(i=>!1===i(e,t))){this._context.domainServicesSelectors.getLogger().debug("Commit was canceled by one of the onBeforeCommit hooks! Resetting rendered state.",e),this.rollback();return}this.stagedUpdates=void 0,this._context.domainServicesSelectors.getLogger().debug("commit",e),this.emit(e)};t()};commitPrepared=e=>{if("committed"!==e.kind||!e.validity.valid)throw Error(`commitPrepared received a ${e.validity.valid?e.kind:"invalid"} emission, but only a valid committed emission can become the committed state. Prepare the emission with kind "committed" and check its validity before committing it.`);let t=()=>e.previousState===this.committed.value.state;if(!t())return"conflict";let i=()=>{t()?r():this._context.domainServicesSelectors.getLogger().warn("A held commit was dropped, because the committed state changed since it was prepared.",e)},r=()=>this._onBeforeCommitHooks.some(t=>!1===t(e,i))?(this._context.domainServicesSelectors.getLogger().debug("A prepared commit was held by one of the onBeforeCommit hooks.",e),!1):(this._context.domainServicesSelectors.getLogger().debug("commitPrepared",e),this.stagedUpdates=void 0,this.emit(e),!0);return r()?"committed":"held"};rollback=()=>{void 0!==this.stagedUpdates&&(this.stagedUpdates=void 0,this.emit(this.committed.value))};_resetInteractionState(e){return e.ephemeralRecords.some(e=>{let t;return(t=e.componentInstance.componentType)===n||t===o})?{...e,ephemeralRecords:e.ephemeralRecords.map(e=>e.componentInstance.componentType===n?{...e,state:{hoveredEntityId:null}}:e.componentInstance.componentType===o?{...e,state:{draggedEntityId:null}}:e)}:e}_preserveViewportState(e,t){let i=t.ephemeralRecords.find(d),r=e.ephemeralRecords.filter(e=>!d(e));return{...e,ephemeralRecords:i?[...r,i]:r}}reset(e,t){let i=this.committed.value.state,r=this._preserveViewportState(e,i),o=this._resetInteractionState(r),s=this._validateState(o);if(!s.valid)throw Error("Cannot reset to an invalid state");this.stagedUpdates=void 0,this.emit({kind:"reset",state:o,validity:s,tag:t,transformationLog:void 0})}stageAndCommit(e){if(0!==e.length){this.stagedUpdates=e;try{this.commit()}finally{this.stagedUpdates=void 0}}}}

package/dist/domain/domain-context/transformers/context.d.ts

@@ -8,8 +8,10 @@ export type BaseTransformerBuilderContext<ENTITIES extends DomainEntity<string>,
      */
     readonly domainContext: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>;
     /**
-     * The kind of the current state emission: `'committed'`, `'staged'`, or `'dryRun'`.
-     * Useful when the transformer needs to behave differently based on how the update was triggered.
+     * The kind of the current state emission: `'staged'` for a preview, such as a drag in progress, or `'committed'`
+     * for a change about to be committed. A control that dry-runs its options to disable the ones that would fail
+     * prepares them as `'committed'` too, so a transformer cannot tell a dry run from a commit: it may run once for every
+     * option a control checks.
      */
     readonly stateEmissionKind: StateEmissionKind;
     /**

package/dist/domain/domain-context/transformers/when-builder.d.ts

@@ -191,7 +191,8 @@ export type TransformerBuilder<ENTITIES extends DomainEntity<string>, $MAP exten
     /**
      * Restrict the transformer to specific emission kinds before defining the trigger.
      * By default transformers run on all emission kinds. Use this to limit to e.g. only
-     * `'committed'` emissions, ignoring dry-runs and staged updates.
+     * `'committed'` emissions, ignoring staged updates such as a drag in progress. Controls dry-run their options as
+     * `'committed'` emissions, so a transformer limited to `'committed'` still runs in those dry runs.
      *
      * @param stateEmissionKinds - Emission kinds to react to (e.g. `['committed']`).
      */

package/dist/domain/domain-context/undo-system.d.ts

@@ -1,10 +1,31 @@
 import type { ObservableWithLastValue } from '@salsita-ai/common/utils';
-import type { $DomainEntity, DomainEntity, ResetStateEmission, StateEmission } from '../core/index.js';
+import type { $DomainEntity, DomainEntity, DomainState, ResetStateEmission, StateEmission } from '../core/index.js';
 import type { DomainContextSelectors } from '../domain-runtime/index.js';
 export interface UndoCapabilities {
     readonly canUndo: boolean;
     readonly canRedo: boolean;
 }
+/**
+ * One step of the undo history: a state that undo and redo return to.
+ *
+ * A step is made by an undoable change. The non-undoable commits made on top of it afterwards, such
+ * as a selection or a navigation, do not make steps of their own; returning to the step keeps them,
+ * so undoing a later change does not also take back what the user selected since. A step therefore
+ * holds two states: the one that identifies it and the one it returns to.
+ */
+export interface UndoStep<ENTITIES extends DomainEntity<string>> {
+    /**
+     * The state the undoable change committed. It identifies the step and never changes, so a caller
+     * that knows which state its own change committed can tell whether that change is the step the
+     * configuration is at.
+     */
+    readonly committedState: DomainState<ENTITIES>;
+    /**
+     * What undo or redo resets the store to: `committedState` plus the non-undoable commits made on
+     * top of it before the next undoable change.
+     */
+    readonly restoreState: DomainState<ENTITIES>;
+}
 export interface CanBeUndoneContext<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
     oldEmission: StateEmission<ENTITIES, $MAP>;
     newEmission: StateEmission<ENTITIES, $MAP>;
@@ -39,6 +60,12 @@ export declare class UndoSystem<ENTITIES extends DomainEntity<string>, $MAP exte
     private _activeIsUndoable;
     private readonly _canSubject;
     readonly can$: ObservableWithLastValue<UndoCapabilities>;
+    private readonly _tipSubject;
+    /**
+     * The step the configuration is at: the top of the stack, or the step an undo or redo returned to.
+     * Nothing while the stack is empty, before the first undoable change and after a reset.
+     */
+    readonly tip$: ObservableWithLastValue<UndoStep<ENTITIES> | undefined>;
     constructor(_context: UndoSystemContext);
     initialize: () => void;
     /**

package/dist/domain/domain-context/undo-system.js

@@ -1 +1 @@
-import{BehaviorSubject as t,pairwise as e}from"rxjs";let s=t=>t.oldEmission.state.entities!==t.newEmission.state.entities;export const UNDO_REDO_RESET_TAG={};export const isUndoRedoReset=t=>"reset"===t.kind&&t.tag===UNDO_REDO_RESET_TAG;export class UndoSystem{_context;_stack=[];_currentIndex=-1;_activeIsUndoable;_canSubject=new t({canUndo:!1,canRedo:!1});can$=this._canSubject;constructor(t){this._context=t,this._context.selectors.getStoreSystem().stateSlices.committed.pipe(e()).subscribe(([t,e])=>{if("reset"===e.kind&&e.tag!==UNDO_REDO_RESET_TAG)return void this.resetStack();let n=this._activeIsUndoable?.handler??s;("reset"!==e.kind||e.tag!==UNDO_REDO_RESET_TAG)&&n({oldEmission:t,newEmission:e})&&(this._stack=[...this._stack.slice(0,this._currentIndex),t.state,e.state],this._currentIndex=this._stack.length-1,this._refresh())})}initialize=()=>{this.resetStack()};registerIsUndoable(t){let e={handler:t};return this._activeIsUndoable=e,()=>{this._activeIsUndoable===e&&(this._activeIsUndoable=void 0)}}resetStack(){this._stack=[],this._currentIndex=-1,this._refresh()}_refresh(){this._canSubject.next({canUndo:this.canUndo(),canRedo:this.canRedo()})}canUndo(){return this._currentIndex>0}canRedo(){return this._currentIndex<this._stack.length-1}undo(){let t=this._stack[this._currentIndex-1];void 0!==t&&(this._currentIndex--,this._context.selectors.getStoreSystem().reset(t,UNDO_REDO_RESET_TAG),this._refresh())}redo(){let t=this._stack[this._currentIndex+1];void 0!==t&&(this._currentIndex++,this._context.selectors.getStoreSystem().reset(t,UNDO_REDO_RESET_TAG),this._refresh())}}
+import{BehaviorSubject as t,pairwise as e}from"rxjs";let s=t=>t.oldEmission.state.entities!==t.newEmission.state.entities;export const UNDO_REDO_RESET_TAG={};export const isUndoRedoReset=t=>"reset"===t.kind&&t.tag===UNDO_REDO_RESET_TAG;export class UndoSystem{_context;_stack=[];_currentIndex=-1;_activeIsUndoable;_canSubject=new t({canUndo:!1,canRedo:!1});can$=this._canSubject;_tipSubject=new t(void 0);tip$=this._tipSubject;constructor(t){this._context=t,this._context.selectors.getStoreSystem().stateSlices.committed.pipe(e()).subscribe(([t,e])=>{if("reset"===e.kind&&e.tag!==UNDO_REDO_RESET_TAG)return void this.resetStack();let i=this._activeIsUndoable?.handler??s;if("reset"===e.kind&&e.tag===UNDO_REDO_RESET_TAG||!i({oldEmission:t,newEmission:e}))return;let r=this._stack[this._currentIndex],n={committedState:r?.committedState??t.state,restoreState:t.state},c={committedState:e.state,restoreState:e.state};this._stack=[...this._stack.slice(0,this._currentIndex),n,c],this._currentIndex=this._stack.length-1,this._refresh()})}initialize=()=>{this.resetStack()};registerIsUndoable(t){let e={handler:t};return this._activeIsUndoable=e,()=>{this._activeIsUndoable===e&&(this._activeIsUndoable=void 0)}}resetStack(){this._stack=[],this._currentIndex=-1,this._refresh()}_refresh(){this._canSubject.next({canUndo:this.canUndo(),canRedo:this.canRedo()}),this._tipSubject.next(this._stack[this._currentIndex])}canUndo(){return this._currentIndex>0}canRedo(){return this._currentIndex<this._stack.length-1}undo(){let t=this._stack[this._currentIndex-1];void 0!==t&&(this._currentIndex--,this._context.selectors.getStoreSystem().reset(t.restoreState,UNDO_REDO_RESET_TAG),this._refresh())}redo(){let t=this._stack[this._currentIndex+1];void 0!==t&&(this._currentIndex++,this._context.selectors.getStoreSystem().reset(t.restoreState,UNDO_REDO_RESET_TAG),this._refresh())}}

package/dist/domain/domain-runtime/action-factory.d.ts

@@ -0,0 +1,11 @@
+import type { $DomainEntity, ActionImplementations, ActionTypes, DomainEntity } from '../core/index.js';
+import type { ActionContext, RuntimeExpressionContext } from './domain-context/index.js';
+/**
+ * Creates the `implementActions` factory the generated `domain-spec.ts` exposes as
+ * `phx.domain.implementActions`. A module in `src/actions/` implements any subset of the declared
+ * actions and gets each parameter and result typed from the spec; a name the spec does not declare
+ * is a type error, since its implementation would have to be `never`. The generated barrel lists
+ * the modules; `DomainBuilder.withActionModules` merges them, and domain initialization checks that
+ * every declared action is implemented.
+ */
+export declare const createActionFactory: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ACTION_TYPES extends ActionTypes, EXTENSION_SYSTEMS extends object = object>() => <IMPLEMENTATIONS extends Partial<ActionImplementations<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ACTION_TYPES, RuntimeExpressionContext<ENTITIES>, ActionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, ACTION_TYPES, EXTENSION_SYSTEMS>['systems']>>>(implementations: IMPLEMENTATIONS & Readonly<Record<Exclude<keyof IMPLEMENTATIONS, keyof ACTION_TYPES>, never>>) => IMPLEMENTATIONS;

package/dist/domain/domain-runtime/application.d.ts

@@ -0,0 +1,39 @@
+import type { AnyApplicationConfig, DefaultEnvs } from '../application/index.js';
+import type { PersistenceConfig } from './environment/index.js';
+import { type ApplicationSpec } from './spec/index.js';
+/**
+ * The environment an application runs in, before the runtime resolves it: the values of the
+ * phoenix runtime config (`defaultEnvs`), and the deployment id, the development flag and the
+ * persistence when the host sets them explicitly.
+ */
+interface ApplicationEnvironmentInput {
+    readonly defaultEnvs?: DefaultEnvs | undefined;
+    readonly deploymentId?: string | undefined;
+    readonly isDev?: boolean | undefined;
+    readonly persistence?: PersistenceConfig | undefined;
+}
+/**
+ * An application ready to run: the spec slice of the domain runtime, the environment it runs in,
+ * the services it uses (i18n, and a logger, analytics or admin integration a host provides) and the
+ * tag of the web component it mounts as.
+ *
+ * `createApplication` of `@salsita-ai/sdk/application-spec` builds one from an
+ * application's runtime spec and its project modules, without a builder or an `ApplicationConfig`.
+ * `TYPES` is the project's types; no value carries it at run time.
+ */
+export interface Application<TYPES = unknown> {
+    readonly spec: ApplicationSpec;
+    readonly environment: ApplicationEnvironmentInput;
+    readonly services: NonNullable<AnyApplicationConfig['services']>;
+    readonly tag: string;
+    /** Never set: it carries `TYPES` to the functions that take the application. */
+    readonly '~types'?: TYPES;
+}
+/**
+ * Converts the config of a project built with `ConfiguratorBuilder` to the application a runtime
+ * starts from. It checks the project's files (`initializeSpec`) and throws every mistake together,
+ * so a host converts it where it shows a failed start: a mount when an element starts, the domain
+ * runtime when it initializes.
+ */
+export declare const applicationFromConfig: (config: AnyApplicationConfig) => Application;
+export {};

package/dist/domain/domain-runtime/application.js

@@ -0,0 +1 @@
+import{initializeSpec as e}from"./spec/index.js";export const applicationFromConfig=s=>({spec:e(s),environment:{defaultEnvs:s.defaultEnvs,deploymentId:s.deploymentId,isDev:s.isDev,persistence:s.persistence},services:s.services??{},tag:s.mount.tag});

package/dist/domain/domain-runtime/domain-context/action-context.d.ts

@@ -1,11 +1,11 @@
-import type { $DomainEntity, DomainEntity, OpenActionContext } from '../../core/index.js';
+import type { $DomainEntity, ActionTypes, DomainEntity, OpenActionContext } from '../../core/index.js';
 import type { DomainContextSystems } from '../../domain-context/index.js';
 import type { RuntimeExpressionContext } from './runtime-expression-context.js';
 /**
- * The context the domain runtime runs an action implementation with: core's part, with the
- * expression context the runtime evaluates expressions in and the domain systems of the application.
- * `ActionSystem.createContext` builds it.
+ * The context of a runtime action: project-typed domain systems and optional host extensions,
+ * runtime expressions, entity updates and ID allocation. Host extensions are optional because a
+ * browser runtime exposes only the systems registered for its application slot.
  */
-export interface ActionContext<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string> extends OpenActionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, RuntimeExpressionContext<ENTITIES>, DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>> {
+export interface ActionContext<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, ACTION_TYPES extends ActionTypes = ActionTypes, EXTENSION_SYSTEMS extends object = object> extends OpenActionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, RuntimeExpressionContext<ENTITIES>, DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, ACTION_TYPES> & Partial<EXTENSION_SYSTEMS>> {
 }
 export type AnyActionContext = ActionContext<any, any, any, any, any, any, any, any, any, any>;

package/dist/domain/domain-runtime/domain-context/selectors.d.ts

@@ -39,6 +39,7 @@ interface Context {
     readonly sessionContextSelectors: SessionContextSelectors;
     readonly domainServicesSelectors: DomainServicesSelectors;
     readonly environmentSelectors: EnvironmentSelectors;
+    readonly getHostSystems: () => object;
     readonly getExtensionSystems: () => readonly InitializableSystem[];
 }
 export interface DomainContextSelectorState extends SpecSelectorState, AccessSelectorState, WebComponentSelectorState, DomainDataSelectorState, SessionContextSelectorState {
@@ -124,6 +125,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     getMigrate: () => import("../../index.js").MigrateFunction<import("../../index.js").DomainEntity<string>>;
     getActiveMode: () => DomainMode;
     getIsInitialized: () => boolean;
+    getIsViewMode: () => boolean;
     getComponentReaderIndexes: () => ComponentReaderIndexes;
     getStoreRuntimeDependencies: () => {
         componentReaderIndexes: ComponentReaderIndexes;
@@ -161,6 +163,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     getBlenderProjections: () => AnyBlenderProjections;
     getExpressionContext: () => AnyExpressionContext;
     getDomainSystems: () => AnyDomainContextSystems;
+    getHostSystems: () => object;
     getDomainContext: () => DomainContext;
 };
 export type DomainContextSelectors = ReturnType<typeof createDomainContextSelectors>;