@salsita-ai/sdk 0.50.0-develop.d81d7591c5 → 0.50.0-develop.d87b28256e

package/dist/domain/domain-context/transformers/auto-snap-transformer.js

@@ -1 +1 @@
-import{Euler as t,Quaternion as e,Vector3 as a}from"three";import{isDomainEntityId as n}from"../../core/index.js";import{defaultDistanceToUnit as o,distanceUnitToDefault as r}from"../../dimensions/dimensions.js";import{extractYRotationFromMatrix as i,findBestAxisSnap as l,findBestEdgeSnap as p,findBestPlaneSnap as s,findBestPointSnap as d,snapScore as g}from"../../projections/snap-matching.js";import{computeWorldMatrix as c,computeWorldSnapEdges as u,computeWorldSnapPoints as y}from"../../projections/snap-utils.js";import{DraggableUpdateTag as m,TransientDraggableUpdateTag as h,dragHandleComponent as f,hotspotDragHandleComponent as S,pivotPointComponent as x,sceneEntityPropertiesComponent as w,snapAxisComponent as Y,snapEdgeComponent as M,snapPlaneComponent as b,snapPointComponent as v}from"../../system-components/index.js";export const AutoSnapUpdateTag="AutoSnap.applied";let T=[m,h],R=t=>"modifyComponent"===t.kind&&(t.componentInstance.componentType===f||t.componentInstance.componentType===S)&&T.includes(t.updateTag);export const isAutoSnapUpdate=t=>"modifyComponent"===t.kind&&t.updateTag===AutoSnapUpdateTag;export const createAutoSnapTransformer=(m,h,f,S,T)=>(P,$,z,A)=>{let E=P.filter(R);if(0===E.length)return A?.("no-event","No drag component modifications found, skipping auto-snap"),P;if(E.length>1)throw Error(`Auto-snap transformer received ${E.length} drag updates in a single batch. Only one drag update per batch is supported. Entity IDs: ${E.map(t=>String(t.componentInstance.entityId)).join(", ")}`);let C=f.getDataDistanceUnit($),X=T.getNewState(P,$),Z=!1,j=[];for(let f of P){if(!R(f)){j.push(f);continue}let T=f.componentInstance.entityId;if(!n(T)){j.push(f);continue}let P=function(n,o,m,h,f,S,T,R,P){let $,z=[n],A=S.readManyComponents({componentTypes:[v],entityIds:z},h),E=S.readManyComponents({componentTypes:[M],entityIds:z},h),C=S.readManyComponents({componentTypes:[b],entityIds:z},h),X=S.readManyComponents({componentTypes:[Y],entityIds:z},h);if(!(A.length>0||E.length>0||C.length>0||X.length>0))return null;if(A.every(t=>!1===t.state.autoSnap)&&E.every(t=>!1===t.state.autoSnap)&&C.every(t=>!1===t.state.autoSnap)&&X.every(t=>!1===t.state.autoSnap))return P?.("no-match",`All snap components on entity ${String(n)} have autoSnap disabled`),null;let Z=S.readFirstComponent({componentTypes:[w],entityIds:z},h),j=o.writableState,F=j.draggableX??0,W=j.draggableY??0,I=j.draggableZ??0,U=new a(r(Z?.state.offsetX??F,f),r(Z?.state.offsetY??W,f),r(Z?.state.offsetZ??I,f)),D=new t(Z?.state.rotationX??0,Z?.state.rotationY??0,Z?.state.rotationZ??0,"XYZ"),N=new a(Z?.state.scaleX??1,Z?.state.scaleY??1,Z?.state.scaleZ??1),O=c(U,D,N),k=R.getEntityParentWorldMatrix(n,h,null),q=k.clone().multiply(O),Q=new a;q.decompose(Q,new e,new a);let B=i(q),G=i(k),H=new e;k.decompose(new a,H,new a);let J=H.clone().invert(),K=new t(D.x,B,D.z,"XYZ"),L=[],V=A.filter(t=>!1!==t.state.autoSnap),_={entityWorldOrigin:Q,currentRotationY:B};if(V.length>0){let t=d($=V.flatMap(t=>y(n,t,t.state,q,f,(t=>{if(void 0===t)return;let e=S.readFirstComponent({componentTypes:[x],instanceNames:[t],entityIds:z},h);if(e)return new a(r(e.state.x,f),r(e.state.y,f),r(e.state.z,f))})(t.state.targetPivotPoint))),T.getWorldSnapPoints(m,z),_);t&&L.push({delta:t.delta,snapMatch:{...t,type:"point"},distance:t.distance,priority:t.targetPoint.priority,targetRotationY:t.targetRotationY,group:t.targetPoint.group})}let tt=E.filter(t=>!1!==t.state.autoSnap);if(tt.length>0){let t,e=p(tt.flatMap(t=>u(n,t,t.state,q,f)),T.getWorldSnapEdges(m,z));e&&L.push({delta:(t=e.sourceEdge.worldStart.clone().add(e.sourceEdge.worldEnd).multiplyScalar(.5),e.alignedWorldMidpoint.clone().sub(t)),snapMatch:{...e,type:"edge"},distance:e.distance,priority:e.targetEdge.priority,targetRotationY:void 0,group:e.targetEdge.group})}if($&&$.length>0){let t=T.getWorldSnapPlanes(m,z);if(t.length>0){let e=s($,t,_);e&&L.push({delta:e.delta,snapMatch:{...e,type:"plane"},distance:e.distance,priority:e.targetPlane.priority,targetRotationY:e.targetRotationY,group:e.targetPlane.group})}let e=T.getWorldSnapAxes(m,z);if(e.length>0){let t=l($,e);t&&L.push({delta:t.delta,snapMatch:{...t,type:"axis"},distance:t.distance,priority:t.targetAxis.priority,targetRotationY:t.targetRotationY,group:t.targetAxis.group})}}L.sort((t,e)=>g(e.priority,e.distance)-g(t.priority,t.distance));let te=L[0];if(!te)return null;if(void 0!==te.targetRotationY){var ta;let t=("edge"===(ta=te.snapMatch).type?ta.sourceEdge.worldStart.clone().add(ta.sourceEdge.worldEnd).multiplyScalar(.5):ta.sourcePoint.worldPosition).clone().sub(Q),e=te.targetRotationY-B,a=Math.cos(e),n=Math.sin(e),o=a*t.x+n*t.z,r=-n*t.x+a*t.z;te.delta.x+=t.x-o,te.delta.z+=t.z-r}let tn=composeOrthogonalSnap({primary:te,activePointSnapshots:V,targetPoints:T.getWorldSnapPoints(m,z),entityId:n,proposedWorldPosition:Q,proposedWorldEuler:K,scale:N,dataDistanceUnit:f});tn&&(P?.("apply",`Composing secondary snap with primary (${te.snapMatch.type}, group=${te.group??"any"}), orthogonal delta: (${tn.x.toFixed(1)}, ${tn.y.toFixed(1)}, ${tn.z.toFixed(1)})`),te.delta.add(tn));let to=te.delta.clone().applyQuaternion(J),tr=void 0!==te.targetRotationY?te.targetRotationY-G:void 0;return{delta:to,snapMatch:te.snapMatch,targetRotationY:tr}}(T,f,$,X,C,m,h,S,A);if(!P){j.push(f);continue}Z=!0;let{delta:z,snapMatch:E,targetRotationY:F}=P,W=new a(o(z.x,C),o(z.y,C),o(z.z,C)),I=f.writableState,U=void 0!==I.draggableX,D=void 0!==I.draggableY,N=void 0!==I.draggableZ,O=I.draggableX??0,k=I.draggableY??0,q=I.draggableZ??0;A?.("apply",`Auto-snap (${E.type}) on entity ${String(T)}, delta: (${z.x.toFixed(1)}, ${z.y.toFixed(1)}, ${z.z.toFixed(1)}), targetRotationY: ${F}`);let Q=Math.round((O+W.x)*1e3)/1e3,B=Math.round((k+W.y)*1e3)/1e3,G=Math.round((q+W.z)*1e3)/1e3;j.push({...f,writableState:{...f.writableState,...U&&{draggableX:Q},...D&&{draggableY:B},...N&&{draggableZ:G},...void 0!==F&&{draggableRotationY:F}},updateTag:AutoSnapUpdateTag,metadata:{...f.metadata,snapType:E.type,snapMatch:E,originalUpdateTag:f.updateTag}})}return Z?j:P};export function composeOrthogonalSnap(e){let{primary:a,activePointSnapshots:n,targetPoints:o,entityId:r,proposedWorldPosition:i,proposedWorldEuler:l,scale:p,dataDistanceUnit:s}=e,g=getConstrainedDirection(a);if(!g||0===n.length)return null;let u=a.targetRotationY??l.y,m=new t(l.x,u,l.z,"XYZ"),h=c(i.clone().add(a.delta),m,p),f=d(n.flatMap(t=>y(r,t,t.state,h,s)),o);return f?composeSecondarySnap(a,f,g):null}export function composeSecondarySnap(t,e,a){let n=e.delta;if(1e-10>=n.lengthSq())return null;let o=n.dot(a),r=n.clone().sub(a.clone().multiplyScalar(o));if(1e-6>=r.lengthSq())return null;let i=e.targetPoint.group;return void 0!==i&&i===t.group?null:r}export function getConstrainedDirection(t){return"plane"===t.snapMatch.type?t.snapMatch.targetPlane.worldNormal.clone().normalize():"axis"===t.snapMatch.type?null:t.delta.lengthSq()>1e-10?t.delta.clone().normalize():null}
+import{Euler as t,Quaternion as e,Vector3 as a}from"three";import{isDomainEntityId as n}from"../../core/index.js";import{defaultDistanceToUnit as o,distanceUnitToDefault as r}from"../../dimensions/index.js";import{computeWorldMatrix as i,computeWorldSnapEdges as l,computeWorldSnapPoints as p,extractYRotationFromMatrix as d,findBestAxisSnap as s,findBestEdgeSnap as g,findBestPlaneSnap as c,findBestPointSnap as u,snapScore as y}from"../../projections/index.js";import{DraggableUpdateTag as m,TransientDraggableUpdateTag as h,dragHandleComponent as f,hotspotDragHandleComponent as S,pivotPointComponent as x,sceneEntityPropertiesComponent as w,snapAxisComponent as Y,snapEdgeComponent as M,snapPlaneComponent as b,snapPointComponent as v}from"../../system-components/index.js";export const AutoSnapUpdateTag="AutoSnap.applied";let T=[m,h],R=t=>"modifyComponent"===t.kind&&(t.componentInstance.componentType===f||t.componentInstance.componentType===S)&&T.includes(t.updateTag);export const isAutoSnapUpdate=t=>"modifyComponent"===t.kind&&t.updateTag===AutoSnapUpdateTag;export const createAutoSnapTransformer=(m,h,f,S,T)=>(P,$,z,A)=>{let E=P.filter(R);if(0===E.length)return A?.("no-event","No drag component modifications found, skipping auto-snap"),P;if(E.length>1)throw Error(`Auto-snap transformer received ${E.length} drag updates in a single batch. Only one drag update per batch is supported. Entity IDs: ${E.map(t=>String(t.componentInstance.entityId)).join(", ")}`);let C=f.getDataDistanceUnit($),X=T.getNewState(P,$),Z=!1,F=[];for(let f of P){if(!R(f)){F.push(f);continue}let T=f.componentInstance.entityId;if(!n(T)){F.push(f);continue}let P=function(n,o,m,h,f,S,T,R,P){let $,z=[n],A=S.readManyComponents({componentTypes:[v],entityIds:z},h),E=S.readManyComponents({componentTypes:[M],entityIds:z},h),C=S.readManyComponents({componentTypes:[b],entityIds:z},h),X=S.readManyComponents({componentTypes:[Y],entityIds:z},h);if(!(A.length>0||E.length>0||C.length>0||X.length>0))return null;if(A.every(t=>!1===t.state.autoSnap)&&E.every(t=>!1===t.state.autoSnap)&&C.every(t=>!1===t.state.autoSnap)&&X.every(t=>!1===t.state.autoSnap))return P?.("no-match",`All snap components on entity ${String(n)} have autoSnap disabled`),null;let Z=S.readFirstComponent({componentTypes:[w],entityIds:z},h),F=o.writableState,W=F.draggableX??0,I=F.draggableY??0,j=F.draggableZ??0,U=new a(r(Z?.state.offsetX??W,f),r(Z?.state.offsetY??I,f),r(Z?.state.offsetZ??j,f)),D=new t(Z?.state.rotationX??0,Z?.state.rotationY??0,Z?.state.rotationZ??0,"XYZ"),N=new a(Z?.state.scaleX??1,Z?.state.scaleY??1,Z?.state.scaleZ??1),O=i(U,D,N),k=R.getEntityParentWorldMatrix(n,h,null),q=k.clone().multiply(O),Q=new a;q.decompose(Q,new e,new a);let B=d(q),G=d(k),H=new e;k.decompose(new a,H,new a);let J=H.clone().invert(),K=new t(D.x,B,D.z,"XYZ"),L=[],V=A.filter(t=>!1!==t.state.autoSnap),_={entityWorldOrigin:Q,currentRotationY:B};if(V.length>0){let t=u($=V.flatMap(t=>p(n,t,t.state,q,f,(t=>{if(void 0===t)return;let e=S.readFirstComponent({componentTypes:[x],instanceNames:[t],entityIds:z},h);if(e)return new a(r(e.state.x,f),r(e.state.y,f),r(e.state.z,f))})(t.state.targetPivotPoint))),T.getWorldSnapPoints(m,z),_);t&&L.push({delta:t.delta,snapMatch:{...t,type:"point"},distance:t.distance,priority:t.targetPoint.priority,targetRotationY:t.targetRotationY,group:t.targetPoint.group})}let tt=E.filter(t=>!1!==t.state.autoSnap);if(tt.length>0){let t,e=g(tt.flatMap(t=>l(n,t,t.state,q,f)),T.getWorldSnapEdges(m,z));e&&L.push({delta:(t=e.sourceEdge.worldStart.clone().add(e.sourceEdge.worldEnd).multiplyScalar(.5),e.alignedWorldMidpoint.clone().sub(t)),snapMatch:{...e,type:"edge"},distance:e.distance,priority:e.targetEdge.priority,targetRotationY:void 0,group:e.targetEdge.group})}if($&&$.length>0){let t=T.getWorldSnapPlanes(m,z);if(t.length>0){let e=c($,t,_);e&&L.push({delta:e.delta,snapMatch:{...e,type:"plane"},distance:e.distance,priority:e.targetPlane.priority,targetRotationY:e.targetRotationY,group:e.targetPlane.group})}let e=T.getWorldSnapAxes(m,z);if(e.length>0){let t=s($,e);t&&L.push({delta:t.delta,snapMatch:{...t,type:"axis"},distance:t.distance,priority:t.targetAxis.priority,targetRotationY:t.targetRotationY,group:t.targetAxis.group})}}L.sort((t,e)=>y(e.priority,e.distance)-y(t.priority,t.distance));let te=L[0];if(!te)return null;if(void 0!==te.targetRotationY){var ta;let t=("edge"===(ta=te.snapMatch).type?ta.sourceEdge.worldStart.clone().add(ta.sourceEdge.worldEnd).multiplyScalar(.5):ta.sourcePoint.worldPosition).clone().sub(Q),e=te.targetRotationY-B,a=Math.cos(e),n=Math.sin(e),o=a*t.x+n*t.z,r=-n*t.x+a*t.z;te.delta.x+=t.x-o,te.delta.z+=t.z-r}let tn=composeOrthogonalSnap({primary:te,activePointSnapshots:V,targetPoints:T.getWorldSnapPoints(m,z),entityId:n,proposedWorldPosition:Q,proposedWorldEuler:K,scale:N,dataDistanceUnit:f});tn&&(P?.("apply",`Composing secondary snap with primary (${te.snapMatch.type}, group=${te.group??"any"}), orthogonal delta: (${tn.x.toFixed(1)}, ${tn.y.toFixed(1)}, ${tn.z.toFixed(1)})`),te.delta.add(tn));let to=te.delta.clone().applyQuaternion(J),tr=void 0!==te.targetRotationY?te.targetRotationY-G:void 0;return{delta:to,snapMatch:te.snapMatch,targetRotationY:tr}}(T,f,$,X,C,m,h,S,A);if(!P){F.push(f);continue}Z=!0;let{delta:z,snapMatch:E,targetRotationY:W}=P,I=new a(o(z.x,C),o(z.y,C),o(z.z,C)),j=f.writableState,U=void 0!==j.draggableX,D=void 0!==j.draggableY,N=void 0!==j.draggableZ,O=j.draggableX??0,k=j.draggableY??0,q=j.draggableZ??0;A?.("apply",`Auto-snap (${E.type}) on entity ${String(T)}, delta: (${z.x.toFixed(1)}, ${z.y.toFixed(1)}, ${z.z.toFixed(1)}), targetRotationY: ${W}`);let Q=Math.round((O+I.x)*1e3)/1e3,B=Math.round((k+I.y)*1e3)/1e3,G=Math.round((q+I.z)*1e3)/1e3;F.push({...f,writableState:{...f.writableState,...U&&{draggableX:Q},...D&&{draggableY:B},...N&&{draggableZ:G},...void 0!==W&&{draggableRotationY:W}},updateTag:AutoSnapUpdateTag,metadata:{...f.metadata,snapType:E.type,snapMatch:E,originalUpdateTag:f.updateTag}})}return Z?F:P};export function composeOrthogonalSnap(e){let{primary:a,activePointSnapshots:n,targetPoints:o,entityId:r,proposedWorldPosition:l,proposedWorldEuler:d,scale:s,dataDistanceUnit:g}=e,c=getConstrainedDirection(a);if(!c||0===n.length)return null;let y=a.targetRotationY??d.y,m=new t(d.x,y,d.z,"XYZ"),h=i(l.clone().add(a.delta),m,s),f=u(n.flatMap(t=>p(r,t,t.state,h,g)),o);return f?composeSecondarySnap(a,f,c):null}export function composeSecondarySnap(t,e,a){let n=e.delta;if(1e-10>=n.lengthSq())return null;let o=n.dot(a),r=n.clone().sub(a.clone().multiplyScalar(o));if(1e-6>=r.lengthSq())return null;let i=e.targetPoint.group;return void 0!==i&&i===t.group?null:r}export function getConstrainedDirection(t){return"plane"===t.snapMatch.type?t.snapMatch.targetPlane.worldNormal.clone().normalize():"axis"===t.snapMatch.type?null:t.delta.lengthSq()>1e-10?t.delta.clone().normalize():null}

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

@@ -1,6 +1,6 @@
-import type { $DomainEntity, DomainEntity } from '../../core/model.js';
+import type { $DomainEntity, DomainEntity } from '../../core/index.js';
 import type { DomainContextSystems } from '../domain-context-systems.js';
-import type { TransformerRegistration, UpdateTransformer } from '../store-system/store-system.js';
+import type { TransformerRegistration, UpdateTransformer } from '../store-system/index.js';
 export type RegisterFunction<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> = (domainContext: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>, priority?: number) => TransformerRegistration<ENTITIES>;
 export type RegistrableTransformer<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> = {
     /**

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

@@ -1,11 +1,6 @@
-import type { DomainEntityModification, DomainEntityStateDelta, StateUpdate } from '../../components/updates.js';
-import type { $DomainEntity, DomainEntity, DomainEntityId } from '../../core/model.js';
-import type { DomainState } from '../../core/state.js';
-import type { ViolationTypesOf$Entity } from '../../invariants/violation.js';
-import type { StateValidationResult } from '../../projections/validation-projections.js';
+import type { $DomainEntity, DomainEntity, DomainEntityId, DomainEntityModification, DomainEntityStateDelta, DomainState, IdSequence, StateUpdate, StateValidationResult, ViolationTypesOf$Entity } from '../../core/index.js';
 import type { DomainContextSystems } from '../domain-context-systems.js';
-import type { IdSequence } from '../store-system/next-domain-entity-id.js';
-import type { StateEmissionKind, TransformerLogFunction } from '../store-system/store-system.js';
+import type { StateEmissionKind, TransformerLogFunction } from '../store-system/index.js';
 export type BaseTransformerBuilderContext<ENTITIES extends DomainEntity<string>, $MAP extends Record<string, $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string> = {
     /**
      * The domain context instance. Provides low-level access to the domain, navigation system,

package/dist/domain/domain-context/transformers/context.js

@@ -1 +1 @@
-import{memoOnce as t}from"@salsita-ai/common/utils";import{getIdSequence as e}from"../store-system/next-domain-entity-id.js";export const isContextWithUpdate=t=>"update"in t&&"object"==typeof t.update&&null!==t.update;export const isContextWithEntityId=t=>"entityId"in t;export const createBaseContext=(i,a,o,n,s)=>{let g=t(()=>i.storeSystem.prepareStateEmissionWithoutTransformation(n,a,o));return{domainContext:i,stateEmissionKind:o,updates:n,getOldState:()=>a,getNewState:()=>g().state,getOld$Root:()=>i.domain.getRoot$Entity(a),getNew$Root:()=>i.domain.getRoot$Entity(g().state),getNewValidity:()=>g().validity,getOldNavigationState:()=>i.navigationSystem.getActiveNavigationState(a),getNewNavigationState:()=>i.navigationSystem.getActiveNavigationState(g().state),getOldViewState:()=>i.navigationSystem.getActiveViewState(a),getNewViewState:()=>i.navigationSystem.getActiveViewState(g().state),getIdSequence:()=>e(a.entities,n),log:s}};
+import{memoOnce as t}from"@salsita-ai/common/utils";import{getIdSequence as e}from"../store-system/index.js";export const isContextWithUpdate=t=>"update"in t&&"object"==typeof t.update&&null!==t.update;export const isContextWithEntityId=t=>"entityId"in t;export const createBaseContext=(i,a,o,n,s)=>{let g=t(()=>i.storeSystem.prepareStateEmissionWithoutTransformation(n,a,o));return{domainContext:i,stateEmissionKind:o,updates:n,getOldState:()=>a,getNewState:()=>g().state,getOld$Root:()=>i.domain.getRoot$Entity(a),getNew$Root:()=>i.domain.getRoot$Entity(g().state),getNewValidity:()=>g().validity,getOldNavigationState:()=>i.navigationSystem.getActiveNavigationState(a),getNewNavigationState:()=>i.navigationSystem.getActiveNavigationState(g().state),getOldViewState:()=>i.navigationSystem.getActiveViewState(a),getNewViewState:()=>i.navigationSystem.getActiveViewState(g().state),getIdSequence:()=>e(a.entities,n),log:s}};

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

@@ -1,8 +1,4 @@
-import type { exportStateComponent } from '../../components/export-state-component.js';
-import type { selectionStateComponent } from '../../components/selection-state-component.js';
-import type { DomainEntityCreation, DomainEntityModification, DomainEntityReplacement, EntityDeletion, EphemeralRecordModification } from '../../components/updates.js';
-import { type $DomainEntity, type DomainEntity, type DomainEntityId, type EntityByType } from '../../core/model.js';
-import type { ViolationTypesOf$Entity } from '../../invariants/violation.js';
+import { type $DomainEntity, type DomainEntity, type DomainEntityCreation, type DomainEntityId, type DomainEntityModification, type DomainEntityReplacement, type EntityByType, type EntityDeletion, type EphemeralRecordModification, type ViolationTypesOf$Entity, type exportStateComponent, type selectionStateComponent } from '../../core/index.js';
 import type { AllActions } from './actions-builder.js';
 import type { BaseTransformerBuilderContext, ContextFactoryFilter, DomainEntityModificationUpdateAtField } from './context.js';
 import type { ThenAndEntityAwareCausesBuilder, ThenBuilder } from './then-builder.js';

package/dist/domain/domain-context/transformers/entity-builder.js

@@ -1 +1 @@
-import{domainEntityTypeFromId as t,isDomainEntityId as e}from"../../core/model.js";import{isDeselectUpdate as n,isExportUpdate as i,isSelectUpdate as r}from"../navigation-system/navigation-updates.js";import{updateActions as o}from"./actions-builder.js";import{createBaseContext as a}from"./context.js";import{thenAndEntityAwareCausesBuilder as l,thenBuilder as s}from"./then-builder.js";export const entityBuilder=(d,f)=>{let p=(n,i,r,o)=>{let a=r.filter(t=>"replaceDomainEntity"===t.kind);if(0===a.length)return o?.("no-event","No replacement updates found, skipping transformer",{updates:r}),[];let l=a.filter(r=>e(r.entityId)&&(void 0===n||n.includes(t(r.entityId)))&&(void 0===i||i.includes(r.replacementEntity.type)));return 0===l.length?(o?.("no-match",`No replacement from ${n?.join(", ")??"any"} to ${i?.join(", ")??"any"} found, skipping transformer`,{updates:r}),[]):l};return{modified:e=>l(d,o(!0),f()((n,i,r,o,l)=>{let s=n.filter(t=>"modifyDomainEntity"===t.kind);if(0===s.length)return l?.("no-event","No modification updates found, skipping transformer",{updates:n}),[];let f=s.filter(e=>d.includes(t(e.entityId)));if(0===f.length)return l?.("no-match",`No modification updates for entity ${d.join(", ")}, skipping transformer`,{updates:n}),[];let p=f;if(e?.atFields!==void 0){if(0===(p=f.filter(t=>e.atFields.every(e=>Object.hasOwn(t.stateDelta,e)))).length)return l?.("no-match",`Entity ${d.join(", ")} modified, but not at field ${e.atFields.join(", ")}, skipping transformer`,{updates:n}),[];l?.("match",`Entity ${d.join(", ")} modified at field ${e.atFields.join(", ")}, processing transformer`,{updates:n})}else l?.("match",`Entity ${d.join(", ")} modified, processing transformer`,{updates:n});let c=a(o,i,r,n,l);return p.map(t=>{let e=t.entityId;return{...c,getOld$Entity:()=>o.domain.get$Entity(e,i),getNew$Entity:()=>o.domain.get$Entity(e,c.getNewState()),entityId:e,update:t}})})),created:()=>l(d,o(!0),f()((t,e,n,i,r)=>{let o=t.filter(t=>"createDomainEntity"===t.kind);if(0===o.length)return r?.("no-event","No entity creation updates found, skipping transformer",{updates:t}),[];let l=o.filter(t=>d.includes(t.entity.type));if(0===l.length)return r?.("no-match",`No creation updates for entity ${d.join(", ")}, skipping transformer`,{updates:t}),[];r?.("match",`Entity ${d.join(", ")} created, processing transformer`,{updates:t});let s=a(i,e,n,t,r);return l.map(t=>{let e=t.entityId;return{...s,getNew$Entity:()=>i.domain.get$Entity(e,s.getNewState()),entityId:e,update:t}})})),deleted:()=>l(d,o(!0),f()((n,i,r,o,l)=>{let s=n.filter(t=>"deleteEntity"===t.kind);if(0===s.length)return l?.("no-event","No entity deletion updates found, skipping transformer",{updates:n}),[];let f=s.filter(n=>e(n.entityId)&&d.includes(t(n.entityId)));if(0===f.length)return l?.("no-match",`No deletion updates for entity ${d.join(", ")}, skipping transformer`,{updates:n}),[];l?.("match",`Entity ${d.join(", ")} deleted, processing transformer`,{updates:n});let p=a(o,i,r,n,l);return f.map(t=>{let e=t.entityId;return{...p,getOld$Entity:()=>o.domain.get$Entity(e,i),entityId:e,update:t}})})),replaces:t=>l(d,o(!0),f()((e,n,i,r,o)=>{let l=p(t,d,e,o);if(0===l.length)return[];o?.("match",`Entity ${d.join(", ")} replaces ${t.join(", ")??"any"}, processing transformer`,{updates:e});let s=a(r,n,i,e,o);return l.map(t=>{let e=t.entityId,i=t.replacementEntity.id;return{...s,getReplacing$Entity:()=>r.domain.get$Entity(i,s.getNewState()),getReplaced$Entity:()=>r.domain.get$Entity(e,n),entityId:i,update:t}})})),replacedWith:t=>l(d,o(!0),f()((e,n,i,r,o)=>{let l=p(d,t,e,o);if(0===l.length)return[];o?.("match",`Entity ${d.join(", ")} replaced with ${t.join(", ")??"any"}, processing transformer`,{updates:e});let s=a(r,n,i,e,o);return l.map(t=>{let e=t.entityId,i=t.replacementEntity.id;return{...s,getReplacing$Entity:()=>r.domain.get$Entity(i,s.getNewState()),getReplaced$Entity:()=>r.domain.get$Entity(e,n),entityId:e,update:t}})})),selected:n=>l(d,o(!0),f()((i,o,l,s,f)=>{let p=i.filter(r);if(0===p.length)return f?.("no-event","No selection updates found, skipping transformer",{updates:i}),[];let c=p.filter(n=>e(n.writableState.selectedEntityId)&&d.includes(t(n.writableState.selectedEntityId)));if(0===c.length)return f?.("no-match",`No selection updates for entity ${d.join(", ")}, skipping transformer`,{updates:i}),[];let m=s.navigationSystem.getActiveSelectionState(o),y=t(m);if(n?.insteadOf!==void 0&&!n?.insteadOf?.includes(y))return f?.("no-match",`Entity ${d.join(", ")} selected, but not instead of ${d.join(", ")}, skipping transformer`,{updates:i}),[];let g=n?.occurrence??"initial",u="any"===g?c:c.filter(t=>"repeated"===g==(t.writableState.selectedEntityId===m));if(0===u.length)return"initial"===g?f?.("no-match",`Targeting initial selection, but the entity ${d.join(", ")} was res-selected, skipping transformer`,{updates:i}):f?.("no-match",`Targeting repeated selection, but the entity ${d.join(", ")} was selected initially, skipping transformer`,{updates:i}),[];f?.("match",`Entity ${d.join(", ")} selected, processing transformer`,{updates:i});let $=a(s,o,l,i,f);return u.map(t=>{let e=t.writableState.selectedEntityId;return{...$,getSelected$Entity:()=>s.domain.get$Entity(e,$.getNewState()),getDeselected$Entity:()=>s.domain.get$Entity(m,o),entityId:e,update:t}})})),deselected:e=>{if((e?.occurrence==="repeated"||e?.occurrence==="any")&&e?.inFavorOf!==void 0)throw Error("inFavorOf is not supported when occurrence is repeated or any");return l(d,o(!0),f()((i,o,l,s,f)=>{let p=i.filter(t=>r(t)||n(t));if(0===p.length)return f?.("no-event","No selection/deselection updates found, skipping transformer",{updates:i}),[];let c=s.navigationSystem.getActiveSelectionState(o),m=t(c);if(!d.includes(m))return f?.("no-match",`Deselected entity is of type ${m} and not ${d.join(", ")}, skipping transformer`,{updates:i}),[];let y=p.filter(t=>t.writableState.selectedEntityId!==c),g=e?.occurrence??"initial";if(0===y.length&&"initial"===g)return f?.("no-match","Entity has not truly been deselected, skipping transformer",{updates:i}),[];if(y.length>0&&"repeated"===g)return f?.("no-match","Entity has been deselected initially, but target occurrence is repeated, skipping transformer",{updates:i}),[];let u=y.length>0?y:p,$=e?.inFavorOf?u.filter(n=>e.inFavorOf?.includes(t(n.writableState.selectedEntityId))):u;if(0===$.length)return f?.("no-match",`Entity ${c} deselected but not in favor of ${e?.inFavorOf?.join(",")}, skipping transformer`,{updates:i}),[];f?.("match",`Entity ${d.join(", ")} deselected in favor of ${e?.inFavorOf?.join(",")??"any"}, processing transformer`,{updates:i});let h=a(s,o,l,i,f);return $.map(t=>{let e=t.writableState.selectedEntityId;return{...h,getSelected$Entity:()=>s.domain.get$Entity(e,h.getNewState()),getDeselected$Entity:()=>s.domain.get$Entity(c,o),entityId:c,update:t}})}))},violated:n=>s(o(!0),f()((i,r,o,l,s)=>{let{validity:f,state:p}=l.storeSystem.prepareStateEmissionWithoutTransformation(i,r,o);if(f.valid||"uncaught"===f.severity)return s?.("no-event","State is valid, skipping transformer",{validity:f}),[];let c=Array.from(new Set(f.entityViolations.filter(t=>n.includes(t.violation.type)).map(t=>t.entityId)));if(!c)return s?.("no-event",`No violations of type ${n.join(", ")} found, skipping transformer`,{validity:f}),[];let m=c.filter(n=>e(n)&&d.includes(t(n)));if(0===m.length)return s?.("no-match",`No violations of type ${n.join(", ")} found for entity ${d.join(", ")}, skipping transformer`,{validity:f}),[];s?.("no-match",`Violations of type ${n.join(", ")} found for entity ${d.join(", ")}, processing transformer`,{validity:f});let y=a(l,r,o,i,s);return m.map(t=>({...y,getViolated$Entity:()=>l.domain.get$Entity(t,p)}))})),exported:n=>l(d,o(!0),f()((r,o,l,s,f)=>{let p=r.filter(i);if(0===p.length)return f?.("no-event","No export updates found, skipping transformer",{updates:r}),[];let c=p.filter(t=>n.includes(t.writableState.activeState));if(0===c.length)return f?.("no-match",`No export updates matching states ${n.join(", ")}, skipping transformer`,{updates:r}),[];let m=c.filter(n=>e(n.writableState.exportedEntityId)&&d.includes(t(n.writableState.exportedEntityId)));if(0===m.length)return f?.("no-match",`No export updates for entity ${d.join(", ")} with states ${n.join(", ")}, skipping transformer`,{updates:r}),[];f?.("match",`Entity ${d.join(", ")} exported with state ${n.join(", ")}, processing transformer`,{updates:r});let y=a(s,o,l,r,f);return m.map(t=>{let e=t.writableState.exportedEntityId;return{...y,getExported$Entity:()=>s.domain.get$Entity(e,y.getNewState()),entityId:e,update:t,getExportState:()=>t.writableState.activeState}})}))}};
+import{domainEntityTypeFromId as t,isDomainEntityId as e}from"../../core/index.js";import{isDeselectUpdate as n,isExportUpdate as i,isSelectUpdate as r}from"../navigation-system/index.js";import{updateActions as o}from"./actions-builder.js";import{createBaseContext as a}from"./context.js";import{thenAndEntityAwareCausesBuilder as l,thenBuilder as s}from"./then-builder.js";export const entityBuilder=(d,f)=>{let p=(n,i,r,o)=>{let a=r.filter(t=>"replaceDomainEntity"===t.kind);if(0===a.length)return o?.("no-event","No replacement updates found, skipping transformer",{updates:r}),[];let l=a.filter(r=>e(r.entityId)&&(void 0===n||n.includes(t(r.entityId)))&&(void 0===i||i.includes(r.replacementEntity.type)));return 0===l.length?(o?.("no-match",`No replacement from ${n?.join(", ")??"any"} to ${i?.join(", ")??"any"} found, skipping transformer`,{updates:r}),[]):l};return{modified:e=>l(d,o(!0),f()((n,i,r,o,l)=>{let s=n.filter(t=>"modifyDomainEntity"===t.kind);if(0===s.length)return l?.("no-event","No modification updates found, skipping transformer",{updates:n}),[];let f=s.filter(e=>d.includes(t(e.entityId)));if(0===f.length)return l?.("no-match",`No modification updates for entity ${d.join(", ")}, skipping transformer`,{updates:n}),[];let p=f;if(e?.atFields!==void 0){if(0===(p=f.filter(t=>e.atFields.every(e=>Object.hasOwn(t.stateDelta,e)))).length)return l?.("no-match",`Entity ${d.join(", ")} modified, but not at field ${e.atFields.join(", ")}, skipping transformer`,{updates:n}),[];l?.("match",`Entity ${d.join(", ")} modified at field ${e.atFields.join(", ")}, processing transformer`,{updates:n})}else l?.("match",`Entity ${d.join(", ")} modified, processing transformer`,{updates:n});let c=a(o,i,r,n,l);return p.map(t=>{let e=t.entityId;return{...c,getOld$Entity:()=>o.domain.get$Entity(e,i),getNew$Entity:()=>o.domain.get$Entity(e,c.getNewState()),entityId:e,update:t}})})),created:()=>l(d,o(!0),f()((t,e,n,i,r)=>{let o=t.filter(t=>"createDomainEntity"===t.kind);if(0===o.length)return r?.("no-event","No entity creation updates found, skipping transformer",{updates:t}),[];let l=o.filter(t=>d.includes(t.entity.type));if(0===l.length)return r?.("no-match",`No creation updates for entity ${d.join(", ")}, skipping transformer`,{updates:t}),[];r?.("match",`Entity ${d.join(", ")} created, processing transformer`,{updates:t});let s=a(i,e,n,t,r);return l.map(t=>{let e=t.entityId;return{...s,getNew$Entity:()=>i.domain.get$Entity(e,s.getNewState()),entityId:e,update:t}})})),deleted:()=>l(d,o(!0),f()((n,i,r,o,l)=>{let s=n.filter(t=>"deleteEntity"===t.kind);if(0===s.length)return l?.("no-event","No entity deletion updates found, skipping transformer",{updates:n}),[];let f=s.filter(n=>e(n.entityId)&&d.includes(t(n.entityId)));if(0===f.length)return l?.("no-match",`No deletion updates for entity ${d.join(", ")}, skipping transformer`,{updates:n}),[];l?.("match",`Entity ${d.join(", ")} deleted, processing transformer`,{updates:n});let p=a(o,i,r,n,l);return f.map(t=>{let e=t.entityId;return{...p,getOld$Entity:()=>o.domain.get$Entity(e,i),entityId:e,update:t}})})),replaces:t=>l(d,o(!0),f()((e,n,i,r,o)=>{let l=p(t,d,e,o);if(0===l.length)return[];o?.("match",`Entity ${d.join(", ")} replaces ${t.join(", ")??"any"}, processing transformer`,{updates:e});let s=a(r,n,i,e,o);return l.map(t=>{let e=t.entityId,i=t.replacementEntity.id;return{...s,getReplacing$Entity:()=>r.domain.get$Entity(i,s.getNewState()),getReplaced$Entity:()=>r.domain.get$Entity(e,n),entityId:i,update:t}})})),replacedWith:t=>l(d,o(!0),f()((e,n,i,r,o)=>{let l=p(d,t,e,o);if(0===l.length)return[];o?.("match",`Entity ${d.join(", ")} replaced with ${t.join(", ")??"any"}, processing transformer`,{updates:e});let s=a(r,n,i,e,o);return l.map(t=>{let e=t.entityId,i=t.replacementEntity.id;return{...s,getReplacing$Entity:()=>r.domain.get$Entity(i,s.getNewState()),getReplaced$Entity:()=>r.domain.get$Entity(e,n),entityId:e,update:t}})})),selected:n=>l(d,o(!0),f()((i,o,l,s,f)=>{let p=i.filter(r);if(0===p.length)return f?.("no-event","No selection updates found, skipping transformer",{updates:i}),[];let c=p.filter(n=>e(n.writableState.selectedEntityId)&&d.includes(t(n.writableState.selectedEntityId)));if(0===c.length)return f?.("no-match",`No selection updates for entity ${d.join(", ")}, skipping transformer`,{updates:i}),[];let m=s.navigationSystem.getActiveSelectionState(o),y=t(m);if(n?.insteadOf!==void 0&&!n?.insteadOf?.includes(y))return f?.("no-match",`Entity ${d.join(", ")} selected, but not instead of ${d.join(", ")}, skipping transformer`,{updates:i}),[];let g=n?.occurrence??"initial",u="any"===g?c:c.filter(t=>"repeated"===g==(t.writableState.selectedEntityId===m));if(0===u.length)return"initial"===g?f?.("no-match",`Targeting initial selection, but the entity ${d.join(", ")} was res-selected, skipping transformer`,{updates:i}):f?.("no-match",`Targeting repeated selection, but the entity ${d.join(", ")} was selected initially, skipping transformer`,{updates:i}),[];f?.("match",`Entity ${d.join(", ")} selected, processing transformer`,{updates:i});let $=a(s,o,l,i,f);return u.map(t=>{let e=t.writableState.selectedEntityId;return{...$,getSelected$Entity:()=>s.domain.get$Entity(e,$.getNewState()),getDeselected$Entity:()=>s.domain.get$Entity(m,o),entityId:e,update:t}})})),deselected:e=>{if((e?.occurrence==="repeated"||e?.occurrence==="any")&&e?.inFavorOf!==void 0)throw Error("inFavorOf is not supported when occurrence is repeated or any");return l(d,o(!0),f()((i,o,l,s,f)=>{let p=i.filter(t=>r(t)||n(t));if(0===p.length)return f?.("no-event","No selection/deselection updates found, skipping transformer",{updates:i}),[];let c=s.navigationSystem.getActiveSelectionState(o),m=t(c);if(!d.includes(m))return f?.("no-match",`Deselected entity is of type ${m} and not ${d.join(", ")}, skipping transformer`,{updates:i}),[];let y=p.filter(t=>t.writableState.selectedEntityId!==c),g=e?.occurrence??"initial";if(0===y.length&&"initial"===g)return f?.("no-match","Entity has not truly been deselected, skipping transformer",{updates:i}),[];if(y.length>0&&"repeated"===g)return f?.("no-match","Entity has been deselected initially, but target occurrence is repeated, skipping transformer",{updates:i}),[];let u=y.length>0?y:p,$=e?.inFavorOf?u.filter(n=>e.inFavorOf?.includes(t(n.writableState.selectedEntityId))):u;if(0===$.length)return f?.("no-match",`Entity ${c} deselected but not in favor of ${e?.inFavorOf?.join(",")}, skipping transformer`,{updates:i}),[];f?.("match",`Entity ${d.join(", ")} deselected in favor of ${e?.inFavorOf?.join(",")??"any"}, processing transformer`,{updates:i});let h=a(s,o,l,i,f);return $.map(t=>{let e=t.writableState.selectedEntityId;return{...h,getSelected$Entity:()=>s.domain.get$Entity(e,h.getNewState()),getDeselected$Entity:()=>s.domain.get$Entity(c,o),entityId:c,update:t}})}))},violated:n=>s(o(!0),f()((i,r,o,l,s)=>{let{validity:f,state:p}=l.storeSystem.prepareStateEmissionWithoutTransformation(i,r,o);if(f.valid||"uncaught"===f.severity)return s?.("no-event","State is valid, skipping transformer",{validity:f}),[];let c=Array.from(new Set(f.entityViolations.filter(t=>n.includes(t.violation.type)).map(t=>t.entityId)));if(!c)return s?.("no-event",`No violations of type ${n.join(", ")} found, skipping transformer`,{validity:f}),[];let m=c.filter(n=>e(n)&&d.includes(t(n)));if(0===m.length)return s?.("no-match",`No violations of type ${n.join(", ")} found for entity ${d.join(", ")}, skipping transformer`,{validity:f}),[];s?.("no-match",`Violations of type ${n.join(", ")} found for entity ${d.join(", ")}, processing transformer`,{validity:f});let y=a(l,r,o,i,s);return m.map(t=>({...y,getViolated$Entity:()=>l.domain.get$Entity(t,p)}))})),exported:n=>l(d,o(!0),f()((r,o,l,s,f)=>{let p=r.filter(i);if(0===p.length)return f?.("no-event","No export updates found, skipping transformer",{updates:r}),[];let c=p.filter(t=>n.includes(t.writableState.activeState));if(0===c.length)return f?.("no-match",`No export updates matching states ${n.join(", ")}, skipping transformer`,{updates:r}),[];let m=c.filter(n=>e(n.writableState.exportedEntityId)&&d.includes(t(n.writableState.exportedEntityId)));if(0===m.length)return f?.("no-match",`No export updates for entity ${d.join(", ")} with states ${n.join(", ")}, skipping transformer`,{updates:r}),[];f?.("match",`Entity ${d.join(", ")} exported with state ${n.join(", ")}, processing transformer`,{updates:r});let y=a(s,o,l,r,f);return m.map(t=>{let e=t.writableState.exportedEntityId;return{...y,getExported$Entity:()=>s.domain.get$Entity(e,y.getNewState()),entityId:e,update:t,getExportState:()=>t.writableState.activeState}})}))}};

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

@@ -1,4 +1,4 @@
 export { createTransformerBuilder } from './when-builder.js';
 export type { TransformerBuilder } from './when-builder.js';
 export type { RegistrableTransformer } from './chain-builder.js';
-export { AutoSnapUpdateTag, isAutoSnapUpdate, type AutoSnapType, type AutoSnapMetadata, } from './auto-snap-transformer.js';
+export { AutoSnapUpdateTag, isAutoSnapUpdate, type AutoSnapType, type AutoSnapMetadata, createAutoSnapTransformer, } from './auto-snap-transformer.js';

package/dist/domain/domain-context/transformers/index.js

@@ -1 +1 @@
-export{createTransformerBuilder}from"./when-builder.js";export{AutoSnapUpdateTag,isAutoSnapUpdate}from"./auto-snap-transformer.js";
+export{createTransformerBuilder}from"./when-builder.js";export{AutoSnapUpdateTag,isAutoSnapUpdate,createAutoSnapTransformer}from"./auto-snap-transformer.js";

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

@@ -1,5 +1,4 @@
-import { type $DomainEntity, type DomainEntity, type DomainEntityId } from '../../core/model.js';
-import type { ViolationTypesOf$Entity } from '../../invariants/violation.js';
+import { type $DomainEntity, type DomainEntity, type DomainEntityId, type ViolationTypesOf$Entity } from '../../core/index.js';
 import type { Actions, ActionsBuilder, AllActions } from './actions-builder.js';
 import type { BaseTransformerBuilderContext, ContextFactory, ContextWithEntityId, ContextWithUpdate, ContextWithUpdateAndEntityId } from './context.js';
 export type ThenBuilder<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, ACTIONS extends AllActions, CTX> = {

package/dist/domain/domain-context/transformers/then-builder.js

@@ -1 +1 @@
-import{isNonNullish as t}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as e,isDomainEntityId as i}from"../../core/model.js";import{updateActions as n}from"./actions-builder.js";export const thenBuilder=(t,e)=>({then:t(e),and:i=>({then:t((t,n,r,o,a)=>{let s=e(t,n,r,o,a);if(!s.length)return[];let l=s.filter(i);return l.length||a?.("no-match","Custom `and` predicate did not match any update, skipping transformer"),l})})});export const tagBuilder=(t,e)=>({...thenBuilder(t,e),withTag:i=>thenBuilder(t,(t,n,r,o,a)=>{let s=e(t,n,r,o,a);if(!s.length)return[];let l=s.filter(t=>i.includes(t.update.updateTag));return l.length||a?.("no-match",`No matching update with tag ${i.join(", ")} found, skipping transformer`,{updates:t}),l})});export const causesBuilder=r=>({entity:o=>({withId:e=>({violation:i=>thenBuilder(n(!0),(n,o,a,s,l)=>{let u=r(n,o,a,s,l);if(!u.length)return[];let{validity:d,state:p}=s.storeSystem.prepareStateEmissionWithoutTransformation(n,o,a);if(d.valid||"uncaught"===d.severity)return l?.("no-event","No violations found, skipping transformer"),[];let f=d.entityViolations.filter(t=>i.includes(t.violation.type)).map(t=>t.entityId);if(0===f.length)return l?.("no-match",`No violations of type ${i.join(", ")} found, skipping transformer`),[];let m=u.map(t=>{let i=e(t);return i?{context:t,candidateEntityIds:Array.isArray(i)?i:[i]}:null}).filter(t);if(0===m.length)return l?.("no-resolve","No entities returned by the selector, skipping transformer"),[];let h=m.map(t=>({...t,violatedEntityIds:t.candidateEntityIds.filter(t=>f.includes(t))})).filter(t=>t.violatedEntityIds.length>0);return 0===h.length?(l?.("no-match",`No violations of type ${i.join(", ")} found for entities returned by the selector, skipping transformer`,{violatedEntityIds:f}),[]):h.map(t=>({...t.context,getViolated$Entities:()=>t.violatedEntityIds.map(t=>s.domain.get$Entity(t,p))}))})}),violation:a=>thenBuilder(n(!0),(n,s,l,u,d)=>{let{validity:p,state:f}=u.storeSystem.prepareStateEmissionWithoutTransformation(n,s,l);if(p.valid||"uncaught"===p.severity)return[];let m=p.entityViolations.map(t=>a.includes(t.violation.type)&&i(t.entityId)&&o.includes(e(t.entityId))?t.entityId:null).filter(t),h=r(n,s,l,u,d);return 0===m.length?[]:h.map(t=>({...t,getViolated$Entities:()=>m.map(t=>u.domain.get$Entity(t,f))}))})})});export const entityAwareCausesBuilder=(t,e)=>({...causesBuilder(e),self:{violation:i=>thenBuilder(n(!0),(n,r,o,a,s)=>{let{validity:l}=a.storeSystem.prepareStateEmissionWithoutTransformation(n,r,o);if(l.valid)return s?.("no-event","No violations found, skipping transformer",{validity:l}),[];if("uncaught"===l.severity)return s?.("no-event","Uncaught exception encountered while calculating new state, skipping transformer",{updates:n}),[];let u=new Set(l.entityViolations.filter(t=>i.includes(t.violation.type)).map(t=>t.entityId));if(0===u.size)return s?.("no-match",`No violations of type ${i.join(", ")} found for the ${t.join(", ")} entities, skipping transformer`,{entityIds:Array.from(u)}),[];let d=e(n,r,o,a,s),p=d.filter(t=>u.has(t.entityId));return 0===p.length&&s?.("no-match",`No violations of type ${i.join(", ")} found for entity ${d.map(t=>t.entityId).join(", ")}, skipping transformer`,{updates:n}),p})}});export const thenAndEntityAwareCausesBuilder=(t,e,i)=>({...tagBuilder(e,i),causes:entityAwareCausesBuilder(t,i)});export const thenAndCausesBuilder=(t,e)=>({...tagBuilder(t,e),causes:causesBuilder(e)});
+import{isNonNullish as t}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as e,isDomainEntityId as i}from"../../core/index.js";import{updateActions as n}from"./actions-builder.js";export const thenBuilder=(t,e)=>({then:t(e),and:i=>({then:t((t,n,r,o,a)=>{let s=e(t,n,r,o,a);if(!s.length)return[];let l=s.filter(i);return l.length||a?.("no-match","Custom `and` predicate did not match any update, skipping transformer"),l})})});export const tagBuilder=(t,e)=>({...thenBuilder(t,e),withTag:i=>thenBuilder(t,(t,n,r,o,a)=>{let s=e(t,n,r,o,a);if(!s.length)return[];let l=s.filter(t=>i.includes(t.update.updateTag));return l.length||a?.("no-match",`No matching update with tag ${i.join(", ")} found, skipping transformer`,{updates:t}),l})});export const causesBuilder=r=>({entity:o=>({withId:e=>({violation:i=>thenBuilder(n(!0),(n,o,a,s,l)=>{let u=r(n,o,a,s,l);if(!u.length)return[];let{validity:d,state:p}=s.storeSystem.prepareStateEmissionWithoutTransformation(n,o,a);if(d.valid||"uncaught"===d.severity)return l?.("no-event","No violations found, skipping transformer"),[];let f=d.entityViolations.filter(t=>i.includes(t.violation.type)).map(t=>t.entityId);if(0===f.length)return l?.("no-match",`No violations of type ${i.join(", ")} found, skipping transformer`),[];let m=u.map(t=>{let i=e(t);return i?{context:t,candidateEntityIds:Array.isArray(i)?i:[i]}:null}).filter(t);if(0===m.length)return l?.("no-resolve","No entities returned by the selector, skipping transformer"),[];let h=m.map(t=>({...t,violatedEntityIds:t.candidateEntityIds.filter(t=>f.includes(t))})).filter(t=>t.violatedEntityIds.length>0);return 0===h.length?(l?.("no-match",`No violations of type ${i.join(", ")} found for entities returned by the selector, skipping transformer`,{violatedEntityIds:f}),[]):h.map(t=>({...t.context,getViolated$Entities:()=>t.violatedEntityIds.map(t=>s.domain.get$Entity(t,p))}))})}),violation:a=>thenBuilder(n(!0),(n,s,l,u,d)=>{let{validity:p,state:f}=u.storeSystem.prepareStateEmissionWithoutTransformation(n,s,l);if(p.valid||"uncaught"===p.severity)return[];let m=p.entityViolations.map(t=>a.includes(t.violation.type)&&i(t.entityId)&&o.includes(e(t.entityId))?t.entityId:null).filter(t),h=r(n,s,l,u,d);return 0===m.length?[]:h.map(t=>({...t,getViolated$Entities:()=>m.map(t=>u.domain.get$Entity(t,f))}))})})});export const entityAwareCausesBuilder=(t,e)=>({...causesBuilder(e),self:{violation:i=>thenBuilder(n(!0),(n,r,o,a,s)=>{let{validity:l}=a.storeSystem.prepareStateEmissionWithoutTransformation(n,r,o);if(l.valid)return s?.("no-event","No violations found, skipping transformer",{validity:l}),[];if("uncaught"===l.severity)return s?.("no-event","Uncaught exception encountered while calculating new state, skipping transformer",{updates:n}),[];let u=new Set(l.entityViolations.filter(t=>i.includes(t.violation.type)).map(t=>t.entityId));if(0===u.size)return s?.("no-match",`No violations of type ${i.join(", ")} found for the ${t.join(", ")} entities, skipping transformer`,{entityIds:Array.from(u)}),[];let d=e(n,r,o,a,s),p=d.filter(t=>u.has(t.entityId));return 0===p.length&&s?.("no-match",`No violations of type ${i.join(", ")} found for entity ${d.map(t=>t.entityId).join(", ")}, skipping transformer`,{updates:n}),p})}});export const thenAndEntityAwareCausesBuilder=(t,e,i)=>({...tagBuilder(e,i),causes:entityAwareCausesBuilder(t,i)});export const thenAndCausesBuilder=(t,e)=>({...tagBuilder(t,e),causes:causesBuilder(e)});

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

@@ -1,12 +1,6 @@
-import type { navigationStateComponent } from '../../components/navigation-state-component.js';
-import type { toolStateComponent } from '../../components/tool-state-component.js';
-import type { ComponentModification, EphemeralRecordModification, StateUpdate } from '../../components/updates.js';
-import type { viewStateComponent } from '../../components/view-state-component.js';
-import type { SystemComponentTypeConstraint } from '../../core/component.js';
-import { type $DomainEntity, type DomainEntity, type DomainEntityId } from '../../core/model.js';
-import type { DragHandleComponent } from '../../system-components/drag-handle.js';
-import type { HotspotDragHandleComponent } from '../../system-components/hotspot-drag-handle.js';
-import type { StateEmissionKind } from '../store-system/store-system.js';
+import { type $DomainEntity, type ComponentModification, type DomainEntity, type DomainEntityId, type EphemeralRecordModification, type StateUpdate, type SystemComponentTypeConstraint, type navigationStateComponent, type toolStateComponent, type viewStateComponent } from '../../core/index.js';
+import type { DragHandleComponent, HotspotDragHandleComponent } from '../../system-components/index.js';
+import type { StateEmissionKind } from '../store-system/index.js';
 import type { AllActions } from './actions-builder.js';
 import { type AutoSnapMetadata, type AutoSnapType } from './auto-snap-transformer.js';
 import type { BaseTransformerBuilderContext, ContextFactoryFilter, ContextWithUpdate } from './context.js';

package/dist/domain/domain-context/transformers/when-builder.js

@@ -1 +1 @@
-import{domainEntityTypeFromId as t,isDomainEntityId as e}from"../../core/model.js";import{isNavigationUpdate as n,isToolUpdate as o,isViewUpdate as i}from"../navigation-system/navigation-updates.js";import{updateActions as r}from"./actions-builder.js";import{isAutoSnapUpdate as a}from"./auto-snap-transformer.js";import{createBaseContext as s}from"./context.js";import{entityBuilder as m}from"./entity-builder.js";import{tagBuilder as l,thenAndCausesBuilder as f,thenBuilder as d}from"./then-builder.js";let p=n=>({...l(r(!1),n),onEntity:o=>l(r(!1),(i,r,a,s,m)=>{let l=n(i,r,a,s,m);if(!l.length)return[];let f=l.filter(n=>e(n.update.entityId)&&o.includes(t(n.update.entityId)));return f.length||m?.("no-match",`No matching update for entity ${o.join(", ")} found, skipping transformer`,{updates:i}),f.map(t=>{let e=t.update.entityId;return{...t,getOld$Entity:()=>s.domain.get$Entity(e,r),getNew$Entity:()=>s.domain.get$Entity(e,t.getNewState()),entityId:e}})})}),g=(t,e,n)=>p(t()((t,o,i,r,a)=>{let m=t.filter(t=>"modifyComponent"===t.kind);if(0===m.length)return a?.("no-event","No component modification updates found, skipping transformer",{updates:t}),[];let l=m.filter(t=>e.includes(t.componentInstance.componentType));return 0===l.length?(a?.("no-match",`No modification updates for component ${e.join(", ")}, skipping transformer`,{updates:t}),[]):(void 0===n?l:l.filter(t=>n.includes(t.componentInstance.instanceName))).map(e=>({...s(r,o,i,t,a),update:e}))}));export const whenBuilder=t=>({component:e=>({modified:g(t,e),instance:n=>({modified:g(t,e,n)})}),update:e=>({fired:p(t()((t,n,o,i,r)=>{let a=t.filter(t=>e.includes(t.kind));return 0===a.length?(r?.("no-event",`No updates of kind ${e.join(", ")} found, skipping transformer`,{updates:t}),[]):a.map(e=>({...s(i,n,o,t,r),update:e}))}))}),entity:e=>m(e,t),snapped:()=>f(r(!0),t()((t,e,n,o,i)=>{let r=t.filter(a);if(0===r.length)return i?.("no-event","No auto-snap updates found, skipping transformer",{updates:t}),[];i?.("match",`Found ${r.length} auto-snap update(s), processing transformer`);let m=s(o,e,n,t,i);return r.map(t=>({...m,update:t,entityId:t.componentInstance.entityId,snapMatch:t.metadata.snapMatch,snapType:t.metadata.snapType}))})),navigated:e=>f(r(!0),t()((t,o,i,r,a)=>{let m=t.filter(n);if(0===m.length)return a?.("no-event","No navigation updates found, skipping transformer",{updates:t}),[];let l=m.filter(t=>{let n=t.writableState.activeState,i=r.navigationSystem.getActiveNavigationState(o);return(e?.to===void 0||e.to.includes(n))&&(e?.from===void 0||e.from.includes(i))});if(0===l.length)return a?.("no-match",`No navigation updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`Navigation state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let f=s(r,o,i,t,a);return l.map(t=>{let e=t.writableState.activeState,n=r.navigationSystem.getActiveNavigationState(o);return{...f,update:t,getFrom:()=>n,getTo:()=>e}})})),viewChanged:e=>f(r(!0),t()((t,n,o,r,a)=>{let m=t.filter(i);if(0===m.length)return a?.("no-event","No view updates found, skipping transformer",{updates:t}),[];let l=m.filter(t=>{let o=t.writableState.activeState,i=r.navigationSystem.getActiveViewState(n);return(e?.to===void 0||e.to.includes(o))&&(e?.from===void 0||e.from.includes(i))});if(0===l.length)return a?.("no-match",`No view updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`View state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let f=s(r,n,o,t,a);return l.map(t=>{let e=t.writableState.activeState,o=r.navigationSystem.getActiveViewState(n);return{...f,update:t,getFrom:()=>o,getTo:()=>e}})})),toolChanged:e=>f(r(!0),t()((t,n,i,r,a)=>{let m=t.filter(o);if(0===m.length)return a?.("no-event","No tool updates found, skipping transformer",{updates:t}),[];let l=m.filter(t=>{let o=t.writableState.activeState,i=r.navigationSystem.getActiveToolState(n);return(e?.to===void 0||e.to.includes(o))&&(e?.from===void 0||e.from.includes(i))});if(0===l.length)return a?.("no-match",`No tool updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`Tool state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let f=s(r,n,i,t,a);return l.map(t=>{let e=t.writableState.activeState,o=r.navigationSystem.getActiveToolState(n);return{...f,update:t,getFrom:()=>o,getTo:()=>e}})}))});export const createTransformerBuilder=()=>({when:whenBuilder(()=>t=>t),onEmissionsOfKind:t=>({when:whenBuilder(()=>e=>(n,o,i,r,a)=>t.includes(i)?e(n,o,i,r,a):(a?.("no-event",`Emission kind ${i} is not supposed to trigger this transformer, only ${t.join(", ")} is, skipping transformer`,{updates:n}),[]))}),always:d(r(!1),(t,e,n,o,i)=>[s(o,e,n,t,i)])});
+import{domainEntityTypeFromId as t,isDomainEntityId as e}from"../../core/index.js";import{isNavigationUpdate as n,isToolUpdate as o,isViewUpdate as i}from"../navigation-system/index.js";import{updateActions as r}from"./actions-builder.js";import{isAutoSnapUpdate as a}from"./auto-snap-transformer.js";import{createBaseContext as s}from"./context.js";import{entityBuilder as m}from"./entity-builder.js";import{tagBuilder as f,thenAndCausesBuilder as l,thenBuilder as d}from"./then-builder.js";let p=n=>({...f(r(!1),n),onEntity:o=>f(r(!1),(i,r,a,s,m)=>{let f=n(i,r,a,s,m);if(!f.length)return[];let l=f.filter(n=>e(n.update.entityId)&&o.includes(t(n.update.entityId)));return l.length||m?.("no-match",`No matching update for entity ${o.join(", ")} found, skipping transformer`,{updates:i}),l.map(t=>{let e=t.update.entityId;return{...t,getOld$Entity:()=>s.domain.get$Entity(e,r),getNew$Entity:()=>s.domain.get$Entity(e,t.getNewState()),entityId:e}})})}),g=(t,e,n)=>p(t()((t,o,i,r,a)=>{let m=t.filter(t=>"modifyComponent"===t.kind);if(0===m.length)return a?.("no-event","No component modification updates found, skipping transformer",{updates:t}),[];let f=m.filter(t=>e.includes(t.componentInstance.componentType));return 0===f.length?(a?.("no-match",`No modification updates for component ${e.join(", ")}, skipping transformer`,{updates:t}),[]):(void 0===n?f:f.filter(t=>n.includes(t.componentInstance.instanceName))).map(e=>({...s(r,o,i,t,a),update:e}))}));export const whenBuilder=t=>({component:e=>({modified:g(t,e),instance:n=>({modified:g(t,e,n)})}),update:e=>({fired:p(t()((t,n,o,i,r)=>{let a=t.filter(t=>e.includes(t.kind));return 0===a.length?(r?.("no-event",`No updates of kind ${e.join(", ")} found, skipping transformer`,{updates:t}),[]):a.map(e=>({...s(i,n,o,t,r),update:e}))}))}),entity:e=>m(e,t),snapped:()=>l(r(!0),t()((t,e,n,o,i)=>{let r=t.filter(a);if(0===r.length)return i?.("no-event","No auto-snap updates found, skipping transformer",{updates:t}),[];i?.("match",`Found ${r.length} auto-snap update(s), processing transformer`);let m=s(o,e,n,t,i);return r.map(t=>({...m,update:t,entityId:t.componentInstance.entityId,snapMatch:t.metadata.snapMatch,snapType:t.metadata.snapType}))})),navigated:e=>l(r(!0),t()((t,o,i,r,a)=>{let m=t.filter(n);if(0===m.length)return a?.("no-event","No navigation updates found, skipping transformer",{updates:t}),[];let f=m.filter(t=>{let n=t.writableState.activeState,i=r.navigationSystem.getActiveNavigationState(o);return(e?.to===void 0||e.to.includes(n))&&(e?.from===void 0||e.from.includes(i))});if(0===f.length)return a?.("no-match",`No navigation updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`Navigation state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let l=s(r,o,i,t,a);return f.map(t=>{let e=t.writableState.activeState,n=r.navigationSystem.getActiveNavigationState(o);return{...l,update:t,getFrom:()=>n,getTo:()=>e}})})),viewChanged:e=>l(r(!0),t()((t,n,o,r,a)=>{let m=t.filter(i);if(0===m.length)return a?.("no-event","No view updates found, skipping transformer",{updates:t}),[];let f=m.filter(t=>{let o=t.writableState.activeState,i=r.navigationSystem.getActiveViewState(n);return(e?.to===void 0||e.to.includes(o))&&(e?.from===void 0||e.from.includes(i))});if(0===f.length)return a?.("no-match",`No view updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`View state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let l=s(r,n,o,t,a);return f.map(t=>{let e=t.writableState.activeState,o=r.navigationSystem.getActiveViewState(n);return{...l,update:t,getFrom:()=>o,getTo:()=>e}})})),toolChanged:e=>l(r(!0),t()((t,n,i,r,a)=>{let m=t.filter(o);if(0===m.length)return a?.("no-event","No tool updates found, skipping transformer",{updates:t}),[];let f=m.filter(t=>{let o=t.writableState.activeState,i=r.navigationSystem.getActiveToolState(n);return(e?.to===void 0||e.to.includes(o))&&(e?.from===void 0||e.from.includes(i))});if(0===f.length)return a?.("no-match",`No tool updates matching filter from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, skipping transformer`,{updates:t}),[];a?.("match",`Tool state changed from ${e?.from?.join(", ")??"any"} to ${e?.to?.join(", ")??"any"}, processing transformer`,{updates:t});let l=s(r,n,i,t,a);return f.map(t=>{let e=t.writableState.activeState,o=r.navigationSystem.getActiveToolState(n);return{...l,update:t,getFrom:()=>o,getTo:()=>e}})}))});export const createTransformerBuilder=()=>({when:whenBuilder(()=>t=>t),onEmissionsOfKind:t=>({when:whenBuilder(()=>e=>(n,o,i,r,a)=>t.includes(i)?e(n,o,i,r,a):(a?.("no-event",`Emission kind ${i} is not supposed to trigger this transformer, only ${t.join(", ")} is, skipping transformer`,{updates:n}),[]))}),always:d(r(!1),(t,e,n,o,i)=>[s(o,e,n,t,i)])});

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

@@ -1,11 +1,31 @@
 import type { ObservableWithLastValue } from '@salsita-ai/common/utils';
-import type { $DomainEntity, DomainEntity } from '../core/model.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
-import type { ResetStateEmission, StateEmission } from './store-system/store-system.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>;
@@ -40,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/access/selectors.d.ts

@@ -1,3 +1,4 @@
+import { AccessLevel } from '@salsita-ai/contracts/api';
 import type { OverridesSelectorState, OverridesSelectors } from '../overrides/index.js';
 import type { AccessService, ApplicationAccessInfo } from './types.js';
 /**
@@ -17,24 +18,28 @@ export declare const requireAccessService: (applicationName: 'configurator' | 'a
 export declare const createAccessInfoSelectors: (context: Context) => {
     selectConfiguratorRawAccessInfo: import("@salsita-ai/common/utils").Selector<AccessSelectorState, {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     } | null>;
     selectAdminRawAccessInfo: import("@salsita-ai/common/utils").Selector<AccessSelectorState, {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     } | null>;
     selectConfiguratorAccessInfo: import("@salsita-ai/common/utils").Selector<AccessSelectorState, {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     }>;
     selectAdminAccessInfo: import("@salsita-ai/common/utils").Selector<AccessSelectorState, {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
@@ -47,24 +52,28 @@ export declare const createAccessInfoSelectors: (context: Context) => {
     selectAdminConfigurationId: import("@salsita-ai/common/utils").Selector<AccessSelectorState, string>;
     getConfiguratorRawAccessInfo: () => {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     } | null;
     getAdminRawAccessInfo: () => {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     } | null;
     getConfiguratorAccessInfo: () => {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;
     };
     getAdminAccessInfo: () => {
         raw: string;
+        access: AccessLevel;
         viewMode: boolean;
         revisionId: string | undefined;
         configurationId: string;

package/dist/domain/domain-runtime/access/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";let c=e=>Error(`Cannot read ${e} access info because valid access is not loaded. Access info is written by the ${e} lifecycle after token validation. Move this read into the loaded ${e} lifecycle.`),i=e=>({accessInfo:e,configurationId:e.configurationId});export const requireAccessService=(e,i)=>{if(null===i)throw c(e);return i};export const createAccessInfoSelectors=n=>{let{getState:o,overridesSelectors:r}=n,s=e.withTypes(),t=s([s.leaf(e=>e.access.configuratorAccessInfo)],e=>e),a=s([s.leaf(e=>e.access.adminAccessInfo)],e=>e),l=s([t],e=>{if(null===e)throw c("configurator");return e}),f=s([a],e=>{if(null===e)throw c("admin");return e}),u=s([t,r.selectAccessService,r.selectAccessLevel],(e,c,n)=>{var o;let r,s,t=c??(null===e?null:i(e));return null===t||null===n?t:(o={configurationId:t.configurationId,...void 0===t.accessInfo.revisionId?{}:{revisionId:t.accessInfo.revisionId},access:n},r=e=>btoa(JSON.stringify(e)).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,""),s=`${r({alg:"none",typ:"JWT"})}.${r(o)}.`,{configurationId:t.configurationId,accessInfo:{raw:s,viewMode:"read-revision"===n,revisionId:t.accessInfo.revisionId,configurationId:t.configurationId}})}),d=s([a,r.selectAccessService],(e,c)=>null!==c?c:null===e?null:i(e)),g=s([u],e=>requireAccessService("configurator",e)),I=s([d],e=>requireAccessService("admin",e)),A=s([g],e=>e.configurationId),v=s([I],e=>e.configurationId);return{selectConfiguratorRawAccessInfo:t,selectAdminRawAccessInfo:a,selectConfiguratorAccessInfo:l,selectAdminAccessInfo:f,selectConfiguratorRawAccessService:u,selectAdminRawAccessService:d,selectConfiguratorAccessService:g,selectAdminAccessService:I,selectConfiguratorConfigurationId:A,selectAdminConfigurationId:v,getConfiguratorRawAccessInfo:()=>t(o()),getAdminRawAccessInfo:()=>a(o()),getConfiguratorAccessInfo:()=>l(o()),getAdminAccessInfo:()=>f(o()),getConfiguratorRawAccessService:()=>u(o()),getAdminRawAccessService:()=>d(o()),getConfiguratorAccessService:()=>g(o()),getAdminAccessService:()=>I(o()),getConfiguratorConfigurationId:()=>A(o()),getAdminConfigurationId:()=>v(o())}};
+import{createSelector as e}from"@salsita-ai/common/utils";import{AccessLevel as c}from"@salsita-ai/contracts/api";let i=e=>Error(`Cannot read ${e} access info because valid access is not loaded. Access info is written by the ${e} lifecycle after token validation. Move this read into the loaded ${e} lifecycle.`),n=e=>({accessInfo:e,configurationId:e.configurationId});export const requireAccessService=(e,c)=>{if(null===c)throw i(e);return c};export const createAccessInfoSelectors=o=>{let{getState:r,overridesSelectors:s}=o,t=e.withTypes(),a=t([t.leaf(e=>e.access.configuratorAccessInfo)],e=>e),l=t([t.leaf(e=>e.access.adminAccessInfo)],e=>e),f=t([a],e=>{if(null===e)throw i("configurator");return e}),u=t([l],e=>{if(null===e)throw i("admin");return e}),d=t([a,s.selectAccessService,s.selectAccessLevel],(e,i,o)=>{var r;let s,t,a=i??(null===e?null:n(e));return null===a||null===o?a:(r={configurationId:a.configurationId,...void 0===a.accessInfo.revisionId?{}:{revisionId:a.accessInfo.revisionId},access:o},s=e=>btoa(JSON.stringify(e)).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,""),t=`${s({alg:"none",typ:"JWT"})}.${s(r)}.`,{configurationId:a.configurationId,accessInfo:{raw:t,access:"owner"===o?c.Owner:"read-revision"===o?c.ReadRevision:c.Read,viewMode:"read-revision"===o,revisionId:a.accessInfo.revisionId,configurationId:a.configurationId}})}),g=t([l,s.selectAccessService],(e,c)=>null!==c?c:null===e?null:n(e)),I=t([d],e=>requireAccessService("configurator",e)),v=t([g],e=>requireAccessService("admin",e)),A=t([I],e=>e.configurationId),m=t([v],e=>e.configurationId);return{selectConfiguratorRawAccessInfo:a,selectAdminRawAccessInfo:l,selectConfiguratorAccessInfo:f,selectAdminAccessInfo:u,selectConfiguratorRawAccessService:d,selectAdminRawAccessService:g,selectConfiguratorAccessService:I,selectAdminAccessService:v,selectConfiguratorConfigurationId:A,selectAdminConfigurationId:m,getConfiguratorRawAccessInfo:()=>a(r()),getAdminRawAccessInfo:()=>l(r()),getConfiguratorAccessInfo:()=>f(r()),getAdminAccessInfo:()=>u(r()),getConfiguratorRawAccessService:()=>d(r()),getAdminRawAccessService:()=>g(r()),getConfiguratorAccessService:()=>I(r()),getAdminAccessService:()=>v(r()),getConfiguratorConfigurationId:()=>A(r()),getAdminConfigurationId:()=>m(r())}};

package/dist/domain/domain-runtime/access/types.d.ts

@@ -1,5 +1,7 @@
+import { AccessLevel } from '@salsita-ai/contracts/api';
 export declare const decodeAccessInfo: (accessToken: string, configurationId: string) => {
     raw: string;
+    access: AccessLevel;
     viewMode: boolean;
     revisionId: string | undefined;
     configurationId: string;

package/dist/domain/domain-runtime/access/types.js

@@ -1 +1 @@
-import{jwtDecode as o}from"jwt-decode";import{AccessLevel as e}from"@salsita-ai/contracts/api";export const decodeAccessInfo=(i,r)=>{try{let n=o(i),t=n.exp;if(void 0!==t&&t<Date.now()/1e3||n.configurationId!==r)return null;return{raw:i,viewMode:n.access===e.ReadRevision,revisionId:n.revisionId,configurationId:n.configurationId}}catch(o){return null}};
+import{jwtDecode as e}from"jwt-decode";import{AccessLevel as o}from"@salsita-ai/contracts/api";export const decodeAccessInfo=(i,r)=>{try{let c=e(i),n=c.exp;if(void 0!==n&&n<Date.now()/1e3||c.configurationId!==r)return null;return{raw:i,access:c.access,viewMode:c.access===o.ReadRevision,revisionId:c.revisionId,configurationId:c.configurationId}}catch(e){return null}};

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

@@ -0,0 +1,11 @@
+import type { $DomainEntity, 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.
+ */
+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 type AnyActionContext = ActionContext<any, any, any, any, any, any, any, any, any, any>;

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

@@ -0,0 +1 @@
+export{};

package/dist/domain/domain-runtime/domain-context/component-reader.d.ts

@@ -1,7 +1,4 @@
-import type { FilteredOutComponentSnapshot, ManyComponentFilter, OneComponentFilter } from '../../components/component-reader-types.js';
-import { type ComponentSnapshot, type SystemComponentTypeConstraint } from '../../core/component.js';
-import type { DomainEntity, EntityId } from '../../core/model.js';
-import type { DomainState } from '../../core/state.js';
+import { type ComponentSnapshot, type DomainEntity, type DomainState, type EntityId, type FilteredOutComponentSnapshot, type ManyComponentFilter, type OneComponentFilter, type SystemComponentTypeConstraint } from '../../core/index.js';
 import type { DomainContextSelectors } from './selectors.js';
 export interface ComponentReaderContext {
     readonly selectors: DomainContextSelectors;

package/dist/domain/domain-runtime/domain-context/component-reader.js

@@ -1 +1 @@
-import{getComponentSystemFilterState as e,isComponentActive as n}from"../../components/system-component-filter.js";import{domainEntityTypeFromId as t,isDomainEntityId as o}from"../../core/model.js";let i=class InternalFilter{componentTypes;entityIds;instanceNames;constructor(e){"entityId"in e&&void 0!==e.entityId&&(this.entityIds=new Set([e.entityId])),"entityIds"in e&&void 0!==e.entityIds&&(this.entityIds=new Set(e.entityIds)),"instanceName"in e&&void 0!==e.instanceName&&(this.instanceNames=new Set([e.instanceName])),"instanceNames"in e&&void 0!==e.instanceNames&&(this.instanceNames=new Set(e.instanceNames)),"componentType"in e&&void 0!==e.componentType&&(this.componentTypes=new Set([e.componentType])),"componentTypes"in e&&void 0!==e.componentTypes&&(this.componentTypes=new Set(e.componentTypes))}toString(){let e=this.instanceNames&&Array.from(this.instanceNames).join(", "),n=this.componentTypes&&Array.from(this.componentTypes).map(e=>e.name).join(", "),t=this.entityIds&&Array.from(this.entityIds).map(e=>`#${String(e)}`).join(", ");return[e?`instance ${e} of`:void 0,n?`component ${n}`:void 0,t?`on entity ${t}`:void 0].filter(Boolean).join(" ")}},s=new WeakMap;export class ComponentReader{_context;constructor(e){this._context=e}_resolveDynamicInstanceName=(e,n,t,o)=>{let i=o.dynamicInstanceNames.get(e)?.get(n);if(!i)return null;for(let e of i)if(t.startsWith(`${e}_`))return e;return null};_readComponents(i,a,c,m=!1){let p=e(a),r=this._context.selectors.getExpressionContext(),l=this._context.selectors.getComponentReaderIndexes(),d=[],y=void 0!==i.entityIds?[]:void 0;if(void 0!==i.entityIds)for(let e of i.entityIds)o(e)&&y?.push(e);if(void 0===y||y.length>0){let e=y??a.entities,o=void 0!==y?new Map:void 0;for(let y of e){let e="string"==typeof y?y:y.id;if(void 0!==o){if(o.has(e))continue;o.set(e,!0)}let f="string"==typeof y?t(e):y.type;for(let t of i.componentTypes??l.allComponentTypes.get(f)??[])for(let o of i.instanceNames??l.allComponentInstanceNames.get(f)?.get(t)??[]){let i=l.opticMap.get(f)?.get(t)?.get(o),y=i?null:this._resolveDynamicInstanceName(f,t,o,l),h=y?l.opticMap.get(f)?.get(t)?.get(y):void 0,I=i??h;if(!I)continue;let u=0===I.navigationFilters.length||n(p,I.navigationFilters,e,a,r,m);if(!0!==u){m&&d.push({componentInstance:{componentType:t,entityId:e,instanceName:o},filteredOut:!0,filterState:p,filterContext:{mode:r.mode,role:r.role},mismatchReasons:u});continue}if("simple"===I.kind){let n=I.read(e,a,r),t=s.get(n);if(!t||t.componentInstance.entityId!==e||t.componentInstance.componentType!==I.componentType||t.componentInstance.instanceName!==I.instanceName){let o={state:n,componentInstance:{componentType:I.componentType,entityId:e,instanceName:I.instanceName}};s.set(n,o),t=o}if(d.push(t),c)return d}else{let n=I.read(e,a,r),t=new Set;for(let i of n){let n=I.instanceName+`_${i.key}`;if(null!==y&&o!==n)continue;if(t.has(n))throw Error(`Cannot read dynamic component instance ${I.instanceName} for component ${I.componentType.name} on entity ${e} because it emitted duplicate compound instance ${n}. Make emitted keys unique for this component instance.`);t.add(n);let a=s.get(i);if(!a||a.componentInstance.entityId!==e||a.componentInstance.componentType!==I.componentType||a.componentInstance.instanceName!==n){let t={state:function(e){let n={};for(let t in e)"key"!==t&&(n[t]=e[t]);return n}(i),componentInstance:{componentType:I.componentType,entityId:e,instanceName:n}};s.set(i,t),a=t}if(d.push(a),c)return d}}}}}for(let e of a.ephemeralRecords)if((void 0===i.entityIds||i.entityIds.has(e.componentInstance.entityId))&&(void 0===i.componentTypes||i.componentTypes.has(e.componentInstance.componentType))&&(void 0===i.instanceNames||i.instanceNames.has(e.componentInstance.instanceName))&&(d.push(e),c))break;return d}readOneComponent(e,n){let t=new i(e),o=this._readComponents(t,n,!1);if(o.length>1)throw Error(`Expected component ${e.componentType.name} to be attached only once to entity #${String(e.entityId)}, but found ${o.length} instances`);return o.length>0?o[0]:null}readManyComponents(e,n){let t=new i(e);return this._readComponents(t,n,!1)}readFirstComponent(e,n){let t=new i(e),o=this._readComponents(t,n,!0);return o.length>0?o[0]:null}readFirstRootComponent(e,n){let t=new i({...e,entityIds:[n.rootEntityId]}),o=this._readComponents(t,n,!0);return o.length>0?o[0]:null}readOneComponentOrThrow(e,n){let t=this.readOneComponent(e,n);if(null===t){let n=new i(e);throw Error(`Cannot read ${n.toString()} because such component is not attached`)}return t}isComponentTypeAttached=e=>{let n,i,s,{componentTypes:a,instanceNames:c,entityTypes:m}=("componentTypes"in e&&(n=e.componentTypes),"componentType"in e&&e.componentType&&(n=[e.componentType]),"instanceNames"in e&&(i=e.instanceNames),"instanceName"in e&&e.instanceName&&(i=[e.instanceName]),"entityIds"in e&&e.entityIds&&(s=e.entityIds.filter(o).map(e=>t(e))),"entityId"in e&&e.entityId&&(s=o(e.entityId)?[t(e.entityId)]:[]),{componentTypes:n,instanceNames:i,entityTypes:s}),p=this._context.selectors.getComponentReaderIndexes();for(let e of m??Array.from(p.allComponentTypes.keys()))for(let n of a??p.allComponentTypes.get(e)??[])for(let t of c??p.allComponentInstanceNames.get(e)?.get(n)??[])if(p.opticMap.get(e)?.get(n)?.get(t)||this._resolveDynamicInstanceName(e,n,t,p))return!0;return!1};peekManyComponents(e,n){let t=new i(e);return this._readComponents(t,n,!1,!0)}}
+import{domainEntityTypeFromId as e,getComponentSystemFilterState as n,isComponentActive as t,isDomainEntityId as o}from"../../core/index.js";let i=class InternalFilter{componentTypes;entityIds;instanceNames;constructor(e){"entityId"in e&&void 0!==e.entityId&&(this.entityIds=new Set([e.entityId])),"entityIds"in e&&void 0!==e.entityIds&&(this.entityIds=new Set(e.entityIds)),"instanceName"in e&&void 0!==e.instanceName&&(this.instanceNames=new Set([e.instanceName])),"instanceNames"in e&&void 0!==e.instanceNames&&(this.instanceNames=new Set(e.instanceNames)),"componentType"in e&&void 0!==e.componentType&&(this.componentTypes=new Set([e.componentType])),"componentTypes"in e&&void 0!==e.componentTypes&&(this.componentTypes=new Set(e.componentTypes))}toString(){let e=this.instanceNames&&Array.from(this.instanceNames).join(", "),n=this.componentTypes&&Array.from(this.componentTypes).map(e=>e.name).join(", "),t=this.entityIds&&Array.from(this.entityIds).map(e=>`#${String(e)}`).join(", ");return[e?`instance ${e} of`:void 0,n?`component ${n}`:void 0,t?`on entity ${t}`:void 0].filter(Boolean).join(" ")}},s=new WeakMap;export class ComponentReader{_context;constructor(e){this._context=e}_resolveDynamicInstanceName=(e,n,t,o)=>{let i=o.dynamicInstanceNames.get(e)?.get(n);if(!i)return null;for(let e of i)if(t.startsWith(`${e}_`))return e;return null};_readComponents(i,a,c,p=!1){let m=n(a),r=this._context.selectors.getExpressionContext(),l=this._context.selectors.getComponentReaderIndexes(),d=[],y=void 0!==i.entityIds?[]:void 0;if(void 0!==i.entityIds)for(let e of i.entityIds)o(e)&&y?.push(e);if(void 0===y||y.length>0){let n=y??a.entities,o=void 0!==y?new Map:void 0;for(let y of n){let n="string"==typeof y?y:y.id;if(void 0!==o){if(o.has(n))continue;o.set(n,!0)}let f="string"==typeof y?e(n):y.type;for(let e of i.componentTypes??l.allComponentTypes.get(f)??[])for(let o of i.instanceNames??l.allComponentInstanceNames.get(f)?.get(e)??[]){let i=l.opticMap.get(f)?.get(e)?.get(o),y=i?null:this._resolveDynamicInstanceName(f,e,o,l),h=y?l.opticMap.get(f)?.get(e)?.get(y):void 0,I=i??h;if(!I)continue;let u=0===I.navigationFilters.length||t(m,I.navigationFilters,n,a,r,p);if(!0!==u){p&&d.push({componentInstance:{componentType:e,entityId:n,instanceName:o},filteredOut:!0,filterState:m,filterContext:{mode:r.mode,role:r.role},mismatchReasons:u});continue}if("simple"===I.kind){let e=I.read(n,a,r),t=s.get(e);if(!t||t.componentInstance.entityId!==n||t.componentInstance.componentType!==I.componentType||t.componentInstance.instanceName!==I.instanceName){let o={state:e,componentInstance:{componentType:I.componentType,entityId:n,instanceName:I.instanceName}};s.set(e,o),t=o}if(d.push(t),c)return d}else{let e=I.read(n,a,r),t=new Set;for(let i of e){let e=I.instanceName+`_${i.key}`;if(null!==y&&o!==e)continue;if(t.has(e))throw Error(`Cannot read dynamic component instance ${I.instanceName} for component ${I.componentType.name} on entity ${n} because it emitted duplicate compound instance ${e}. Make emitted keys unique for this component instance.`);t.add(e);let a=s.get(i);if(!a||a.componentInstance.entityId!==n||a.componentInstance.componentType!==I.componentType||a.componentInstance.instanceName!==e){let t={state:function(e){let n={};for(let t in e)"key"!==t&&(n[t]=e[t]);return n}(i),componentInstance:{componentType:I.componentType,entityId:n,instanceName:e}};s.set(i,t),a=t}if(d.push(a),c)return d}}}}}for(let e of a.ephemeralRecords)if((void 0===i.entityIds||i.entityIds.has(e.componentInstance.entityId))&&(void 0===i.componentTypes||i.componentTypes.has(e.componentInstance.componentType))&&(void 0===i.instanceNames||i.instanceNames.has(e.componentInstance.instanceName))&&(d.push(e),c))break;return d}readOneComponent(e,n){let t=new i(e),o=this._readComponents(t,n,!1);if(o.length>1)throw Error(`Expected component ${e.componentType.name} to be attached only once to entity #${String(e.entityId)}, but found ${o.length} instances`);return o.length>0?o[0]:null}readManyComponents(e,n){let t=new i(e);return this._readComponents(t,n,!1)}readFirstComponent(e,n){let t=new i(e),o=this._readComponents(t,n,!0);return o.length>0?o[0]:null}readFirstRootComponent(e,n){let t=new i({...e,entityIds:[n.rootEntityId]}),o=this._readComponents(t,n,!0);return o.length>0?o[0]:null}readOneComponentOrThrow(e,n){let t=this.readOneComponent(e,n);if(null===t){let n=new i(e);throw Error(`Cannot read ${n.toString()} because such component is not attached`)}return t}isComponentTypeAttached=n=>{let t,i,s,{componentTypes:a,instanceNames:c,entityTypes:p}=("componentTypes"in n&&(t=n.componentTypes),"componentType"in n&&n.componentType&&(t=[n.componentType]),"instanceNames"in n&&(i=n.instanceNames),"instanceName"in n&&n.instanceName&&(i=[n.instanceName]),"entityIds"in n&&n.entityIds&&(s=n.entityIds.filter(o).map(n=>e(n))),"entityId"in n&&n.entityId&&(s=o(n.entityId)?[e(n.entityId)]:[]),{componentTypes:t,instanceNames:i,entityTypes:s}),m=this._context.selectors.getComponentReaderIndexes();for(let e of p??Array.from(m.allComponentTypes.keys()))for(let n of a??m.allComponentTypes.get(e)??[])for(let t of c??m.allComponentInstanceNames.get(e)?.get(n)??[])if(m.opticMap.get(e)?.get(n)?.get(t)||this._resolveDynamicInstanceName(e,n,t,m))return!0;return!1};peekManyComponents(e,n){let t=new i(e);return this._readComponents(t,n,!1,!0)}}

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

@@ -1 +1 @@
-import{createCascadeDeletesTransformer as e}from"../../domain-context/relation-transformers/cascade-deletes.js";import{createCascadeRefPruningTransformer as t}from"../../domain-context/relation-transformers/cascade-ref-pruning.js";import{createCreateEntityRefsTransformer as s}from"../../domain-context/relation-transformers/create-entity-refs.js";import{createRefReplaceTransformer as r}from"../../domain-context/relation-transformers/replace-refs.js";import{createAutoSnapTransformer as n}from"../../domain-context/transformers/auto-snap-transformer.js";export class DomainContext{_context;_connected=!1;_activeCreateTransformers=void 0;_userTransformerUnregisters=[];_lastExpressionContext=null;_lastDomainExpressions=null;_lastComponentReaderIndexes=null;_lastLoadedData=null;constructor(e){this._context=e}initialize(){let{selectors:o,actions:a,getExtensionSystems:i}=this._context;this._assertSchemaCoherence();let m=o.getStoreSystem();try{for(let i of(a.setInitializationContext(o.getNextInitializationContext()),this._connected||(m.registerTransformer(10,e(o.getCompositionProjections()),"CascadeDeletes"),m.registerTransformer(20,t(o.getComponentReader()),"CascadeRefPruning"),m.registerTransformer(25,s(o.getComponentReader()),"CreateEntityRefs"),m.registerTransformer(30,r(o.getComponentReader()),"RefReplace"),m.registerTransformer(40,n(o.getComponentReader(),o.getSnappingProjections(),o.getDimensionSystem(),o.getPositionProjections(),m),"AutoSnap"),this._connected=!0),this._reconcileUserTransformers(),[m,o.getUndoSystem()]))i.initialize();for(let e of(m.stageAndCommit(o.getDimensionSystem().initialize(m.stateSlices.committed.value.state)),[o.getNavigationSystem(),...i()]))e.initialize();o.getActionImplementations(),this._lastExpressionContext=o.getExpressionContext(),this._lastDomainExpressions=o.getDomainExpressions(),this._lastComponentReaderIndexes=o.getComponentReaderIndexes(),this._lastLoadedData=o.getLoadedData(),a.completeInitialization()}catch(e){throw a.failInitialization(),e}}reconcile=()=>{this._context.selectors.getInitializationState().isCurrent&&(this._reconcileUserTransformers(),this._refreshIfLoadedDataChanged(),this._refreshIfExpressionContextChanged())};_assertSchemaCoherence(){switch(this._context.selectors.getSchemaCoherence()){case"coherent":return;case"missing-stamp":throw Error("Cannot initialize the domain context: the loaded data carries no schema identity.");case"schema-mismatch":throw Error("Cannot initialize the domain context: the loaded data belongs to a different schema identity than the active spec.")}}_registerUserTransformers(e){let t=this._context.selectors.getStoreSystem();for(let s of e)this._userTransformerUnregisters.push(t.registerTransformer(s.priority,s.transformer,s.name??"Anonymous"))}_unregisterUserTransformers(){for(let e of this._userTransformerUnregisters)e();this._userTransformerUnregisters=[]}_reconcileUserTransformers(){let e=this._context.selectors.getCreateTransformers();if(this._activeCreateTransformers===e)return;let t=e?.(this._context.selectors.getDomainSystems())??[];this._unregisterUserTransformers(),this._activeCreateTransformers=e,this._registerUserTransformers(t)}_refreshIfExpressionContextChanged(){let{selectors:e}=this._context,t=e.getExpressionContext(),s=e.getDomainExpressions(),r=e.getComponentReaderIndexes();if(this._lastExpressionContext===t&&this._lastDomainExpressions===s&&this._lastComponentReaderIndexes===r)return;let n=e.getStoreSystem();n.reset(n.stateSlices.committed.value.state,"expressionContextRefreshed"),this._lastExpressionContext=t,this._lastDomainExpressions=s,this._lastComponentReaderIndexes=r}_refreshIfLoadedDataChanged(){let{selectors:e}=this._context,t=e.getLatestLoadedData();null!==t&&this._lastLoadedData!==t&&(e.getStoreSystem().reset(e.getInitialDomainState(),"loadedDataRefreshed"),this._lastLoadedData=t)}}
+import{createAutoSnapTransformer as e,createCascadeDeletesTransformer as t,createCascadeRefPruningTransformer as s,createCreateEntityRefsTransformer as r,createRefReplaceTransformer as n}from"../../domain-context/index.js";export class DomainContext{_context;_connected=!1;_activeCreateTransformers=void 0;_userTransformerUnregisters=[];_lastExpressionContext=null;_lastDomainExpressions=null;_lastComponentReaderIndexes=null;_lastLoadedData=null;constructor(e){this._context=e}initialize(){let{selectors:o,actions:i,getExtensionSystems:a}=this._context;this._assertSchemaCoherence();let m=o.getStoreSystem();try{for(let a of(i.setInitializationContext(o.getNextInitializationContext()),this._connected||(m.registerTransformer(10,t(o.getCompositionProjections()),"CascadeDeletes"),m.registerTransformer(20,s(o.getComponentReader()),"CascadeRefPruning"),m.registerTransformer(25,r(o.getComponentReader()),"CreateEntityRefs"),m.registerTransformer(30,n(o.getComponentReader()),"RefReplace"),m.registerTransformer(40,e(o.getComponentReader(),o.getSnappingProjections(),o.getDimensionSystem(),o.getPositionProjections(),m),"AutoSnap"),this._connected=!0),this._reconcileUserTransformers(),[m,o.getUndoSystem()]))a.initialize();for(let e of(m.stageAndCommit(o.getDimensionSystem().initialize(m.stateSlices.committed.value.state)),[o.getNavigationSystem(),...a()]))e.initialize();o.getActionImplementations(),this._lastExpressionContext=o.getExpressionContext(),this._lastDomainExpressions=o.getDomainExpressions(),this._lastComponentReaderIndexes=o.getComponentReaderIndexes(),this._lastLoadedData=o.getLoadedData(),i.completeInitialization()}catch(e){throw i.failInitialization(),e}}reconcile=()=>{this._context.selectors.getInitializationState().isCurrent&&(this._reconcileUserTransformers(),this._refreshIfLoadedDataChanged(),this._refreshIfExpressionContextChanged())};_assertSchemaCoherence(){switch(this._context.selectors.getSchemaCoherence()){case"coherent":return;case"missing-stamp":throw Error("Cannot initialize the domain context: the loaded data carries no schema identity.");case"schema-mismatch":throw Error("Cannot initialize the domain context: the loaded data belongs to a different schema identity than the active spec.")}}_registerUserTransformers(e){let t=this._context.selectors.getStoreSystem();for(let s of e)this._userTransformerUnregisters.push(t.registerTransformer(s.priority,s.transformer,s.name??"Anonymous"))}_unregisterUserTransformers(){for(let e of this._userTransformerUnregisters)e();this._userTransformerUnregisters=[]}_reconcileUserTransformers(){let e=this._context.selectors.getCreateTransformers();if(this._activeCreateTransformers===e)return;let t=e?.(this._context.selectors.getDomainSystems())??[];this._unregisterUserTransformers(),this._activeCreateTransformers=e,this._registerUserTransformers(t)}_refreshIfExpressionContextChanged(){let{selectors:e}=this._context,t=e.getExpressionContext(),s=e.getDomainExpressions(),r=e.getComponentReaderIndexes();if(this._lastExpressionContext===t&&this._lastDomainExpressions===s&&this._lastComponentReaderIndexes===r)return;let n=e.getStoreSystem();n.reset(n.stateSlices.committed.value.state,"expressionContextRefreshed"),this._lastExpressionContext=t,this._lastDomainExpressions=s,this._lastComponentReaderIndexes=r}_refreshIfLoadedDataChanged(){let{selectors:e}=this._context,t=e.getLatestLoadedData();null!==t&&this._lastLoadedData!==t&&(e.getStoreSystem().reset(e.getInitialDomainState(),"loadedDataRefreshed"),this._lastLoadedData=t)}}

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

@@ -0,0 +1,8 @@
+import type { CoreExpressionContext, DomainEntity } from '../../core/index.js';
+import type { RuntimeExpressionContext } from './runtime-expression-context.js';
+/**
+ * The context the domain runtime evaluates expressions in: core's part and the runtime's own part.
+ */
+export interface ExpressionContext<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>> extends CoreExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>, RuntimeExpressionContext<ENTITIES> {
+}
+export type AnyExpressionContext = ExpressionContext<any, any, any, any, any>;

package/dist/domain/domain-runtime/domain-context/expression-context.js

@@ -0,0 +1 @@
+export{};

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

@@ -1,6 +1,9 @@
+export type * from './action-context.js';
 export * from './actions.js';
 export { ComponentReader, type AnyComponentReader } from './component-reader.js';
 export { DomainContext } from './domain-context.js';
+export type * from './expression-context.js';
 export * from './initialize.js';
+export type * from './runtime-expression-context.js';
 export * from './selectors.js';
 export type * from './types.js';

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

@@ -0,0 +1,18 @@
+import type { DomainEntity } from '../../core/index.js';
+import type { CollisionProjections, ConstraintProjections, PositionProjections, ProjectedEntitiesProjections, SnappingProjections } from '../../projections/index.js';
+import type { SketchingProjections } from '../../sketching/index.js';
+import type { ComponentReader } from './component-reader.js';
+/**
+ * What the domain runtime adds to the expression context of core: the component reader and the
+ * projections it builds for every application. It is the context extension that generated project
+ * code closes the factories of core with.
+ */
+export interface RuntimeExpressionContext<ENTITIES extends DomainEntity<string>> {
+    readonly componentReader: ComponentReader<ENTITIES>;
+    readonly positionProjections: PositionProjections<ENTITIES>;
+    readonly sketchingProjections: SketchingProjections<ENTITIES>;
+    readonly collisionProjections: CollisionProjections<ENTITIES>;
+    readonly constraintProjections: ConstraintProjections<ENTITIES>;
+    readonly snappingProjections: SnappingProjections<ENTITIES>;
+    readonly projectedEntitiesProjections: ProjectedEntitiesProjections<ENTITIES>;
+}

package/dist/domain/domain-runtime/domain-context/runtime-expression-context.js

@@ -0,0 +1 @@
+export{};