@salsita-ai/sdk 0.50.0-develop.be40f0cee8 → 0.50.0-develop.c1dcc73e88

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

@@ -1 +1 @@
-import{match as e}from"ts-pattern";import{isEqualArray as t,isNonNullish as r}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as i}from"../../core/model.js";import{isDeselectUpdate as n,isNavigationUpdate as o,isSelectUpdate as a,isViewUpdate as l}from"../navigation-system/navigation-updates.js";import{createCascadeDeletesTransformer as s}from"../relation-transformers/cascade-deletes.js";import{createCascadeRefPruningTransformer as p}from"../relation-transformers/cascade-ref-pruning.js";import{createCreateEntityRefsTransformer as d}from"../relation-transformers/create-entity-refs.js";import{createRefReplaceTransformer as f}from"../relation-transformers/replace-refs.js";import{getIdSequence as g}from"../store-system/next-domain-entity-id.js";import{chainBuilder as u}from"./chain-builder.js";import{isContextWithEntityId as c,isContextWithUpdate as h}from"./context.js";let m=(e,t)=>{let i=[d(e.componentReader),f(e.componentReader),s(e.compositionProjections),p(e.componentReader),t?e.storeSystem.transformToDataUpdates:void 0].filter(r);return(e,t,r,n,o)=>i.reduce((e,i)=>i(e,t,r,n,o),e)};export const updateActions=s=>p=>{let d,f=t=>r=>u(i=>{let n=m(i,s);return(o,a,l,s)=>{let d=p(o,a,l,i,s);return d.length?d.reduce((i,o)=>{let p=r({...o,getIdSequence:()=>g(a.entities,i)});return e(t).with("applySideEffect",()=>0===p.length?(s?.("no-apply","No side effects applied"),i):(s?.("apply","Applying side effects",{added:p}),[...i,...n(p,a,l,s,i)])).with("overrideMatchingUpdate",()=>{let e=h(o)?o.update:null;if(1===p.length&&p[0]===e)return s?.("no-apply","Update replaced with itself, no-op"),i;s?.("apply","Overriding matched updates",{removed:[e],added:p});let t=i.filter(t=>t!==e);return[...t,...n(p,a,l,s,t)]}).exhaustive()},o):o}});return{applySideEffect:f("applySideEffect"),overrideMatchingUpdate:f("overrideMatchingUpdate"),overrideAllUpdates:e=>u(r=>{let i=m(r,s);return(n,o,a,l)=>{let s=p(n,o,a,r,l);if(!s.length)return n;s.length>1&&l?.("apply",'Multiple contexts matched for "overrideAllUpdates", picking the first one only');let d=e(s[0]);if(t(d,n))return l?.("no-apply",'Updates returned from "overrideAllUpdates" are the same as the original updates, skipping transformer'),n;let{processedUpdates:f,trulyNewUpdates:g}=d.reduce((e,t)=>(n.includes(t)?e.processedUpdates.push(t):e.trulyNewUpdates.push(t),e),{processedUpdates:[],trulyNewUpdates:[]});return l?.("apply","Overriding all updates",{removed:n,added:d,keptUnchanged:f,trulyNew:g}),[...f,...i(g,o,a,l,f)]}}),...(d=(e,t,r,i)=>{if(0===r.length)return t;r.length>1&&i?.("apply","Multiple entities supposed to be selected, picking the first one",{entityIds:r});let o=t.filter(e=>!(a(e)||n(e))),l=r[0],s=e.navigationSystem.getSelectUpdate(l);return o.length<t.length?i?.("apply",`Overriding previous selection updates with selection of entity ${l}`,{removed:t.filter(e=>a(e)||n(e)),added:s}):i?.("apply",`Selecting entity ${l}`,{added:s}),[...o,s]},{select:{entity:e=>u(t=>(i,n,o,a)=>{t.storeSystem.prepareStateEmissionWithoutTransformation(i,n,o);let l=p(i,n,o,t,a);if(0===l.length)return i;let s=l.map(e).filter(r);return 0===s.length?(a?.("no-resolve","Custom selector did not return any entity id, skipping selection"),i):d(t,i,s,a)}),self:()=>u(e=>(t,r,i,n)=>{let o=p(t,r,i,e,n);return 0===o.length?t:d(e,t,o.map(e=>{if(!c(e))throw Error("Context does not have entity id");return e.entityId}),n)}),ancestorOfType:e=>u(t=>(n,o,a,l)=>{let s=p(n,o,a,t,l);if(0===s.length)return n;let f=s.map(e=>{if(!c(e))throw Error("Context does not have entity id");return e.entityId}),g=s.map(r=>{if(!c(r))throw Error("Context does not have entity id");let n=t.compositionProjections.getTree(o).map.get(r.entityId);if(!n)throw Error(`Entity with id ${r.entityId} not found in the composition tree. The state is invalid!`);for(let t of n.ancestors())if(e.includes(i(t.id)))return t.id}),u=g.filter(r);return(u.length<f.length&&l?.("no-apply",0===u.length?"No entities have ancestor of the specified type, skipping selection":"Some entities do not have ancestor of the specified type",{entityIds:f.filter((e,t)=>void 0===g[t])}),0===u.length)?n:d(t,n,u,l)})},deselect:()=>u(e=>(t,r,i,o)=>0===p(t,r,i,e,o).length?t:[...t.filter(e=>!(a(e)||n(e))),e.navigationSystem.getDeselectUpdate()]),navigateTo:e=>u(t=>(i,n,a,l)=>{let s=p(i,n,a,t,l);if(0===s.length)return i;let d=s.map(t=>"function"==typeof e?e(t):e).filter(r);if(0===d.length)return l?.("no-resolve","Custom selector did not return any navigation state, skipping navigation"),i;d.length>1&&l?.("apply","Multiple navigation states selected, picking the first one",{navigationStates:d});let f=d[0],g=t.navigationSystem.getNavigationUpdate(f),u=i.filter(e=>!o(e));return u.length<i.length?l?.("apply",`Overriding previous navigation updates with ${f}`,{removed:i.filter(e=>o(e)),added:g}):l?.("apply",`Navigating to ${f}`,{added:g}),[...u,g]}),changeView:e=>u(t=>(i,o,s,d)=>{let f=p(i,o,s,t,d);if(0===f.length)return i;let g=f.map(t=>"function"==typeof e?e(t):e).filter(r);if(0===g.length)return d?.("no-resolve","Custom selector did not return any view state, skipping view change"),i;g.length>1&&d?.("apply","Multiple view states selected, picking the first one",{viewStates:g});let u=g[0],c=t.navigationSystem.getViewUpdate(u),h=i.filter(e=>!l(e));return h.length<i.length?d?.("apply",`Overriding previous view state updates with ${u}`,{removed:i.filter(e=>a(e)||n(e)),added:c}):d?.("apply",`Changing view to ${u}`,{added:c}),[...h,c]})})}};
+import{match as e}from"ts-pattern";import{isEqualArray as t,isNonNullish as i}from"@salsita-ai/common/utils";import{domainEntityTypeFromId as n}from"../../core/index.js";import{isDeselectUpdate as r,isNavigationUpdate as o,isSelectUpdate as l,isViewUpdate as a}from"../navigation-system/index.js";import{createCascadeDeletesTransformer as p,createCascadeRefPruningTransformer as d,createCreateEntityRefsTransformer as s,createRefReplaceTransformer as g}from"../relation-transformers/index.js";import{getIdSequence as f}from"../store-system/index.js";import{chainBuilder as u}from"./chain-builder.js";import{isContextWithEntityId as h,isContextWithUpdate as c}from"./context.js";let m=(e,t)=>{let n=[s(e.componentReader),g(e.componentReader),p(e.compositionProjections),d(e.componentReader),t?e.storeSystem.transformToDataUpdates:void 0].filter(i);return(e,t,i,r,o)=>n.reduce((e,n)=>n(e,t,i,r,o),e)};export const updateActions=p=>d=>{let s,g=t=>i=>u(n=>{let r=m(n,p);return(o,l,a,p)=>{let s=d(o,l,a,n,p);return s.length?s.reduce((n,o)=>{let d=i({...o,getIdSequence:()=>f(l.entities,n)});return e(t).with("applySideEffect",()=>0===d.length?(p?.("no-apply","No side effects applied"),n):(p?.("apply","Applying side effects",{added:d}),[...n,...r(d,l,a,p,n)])).with("overrideMatchingUpdate",()=>{let e=c(o)?o.update:null;if(1===d.length&&d[0]===e)return p?.("no-apply","Update replaced with itself, no-op"),n;p?.("apply","Overriding matched updates",{removed:[e],added:d});let t=n.filter(t=>t!==e);return[...t,...r(d,l,a,p,t)]}).exhaustive()},o):o}});return{applySideEffect:g("applySideEffect"),overrideMatchingUpdate:g("overrideMatchingUpdate"),overrideAllUpdates:e=>u(i=>{let n=m(i,p);return(r,o,l,a)=>{let p=d(r,o,l,i,a);if(!p.length)return r;p.length>1&&a?.("apply",'Multiple contexts matched for "overrideAllUpdates", picking the first one only');let s=e(p[0]);if(t(s,r))return a?.("no-apply",'Updates returned from "overrideAllUpdates" are the same as the original updates, skipping transformer'),r;let{processedUpdates:g,trulyNewUpdates:f}=s.reduce((e,t)=>(r.includes(t)?e.processedUpdates.push(t):e.trulyNewUpdates.push(t),e),{processedUpdates:[],trulyNewUpdates:[]});return a?.("apply","Overriding all updates",{removed:r,added:s,keptUnchanged:g,trulyNew:f}),[...g,...n(f,o,l,a,g)]}}),...(s=(e,t,i,n)=>{if(0===i.length)return t;i.length>1&&n?.("apply","Multiple entities supposed to be selected, picking the first one",{entityIds:i});let o=t.filter(e=>!(l(e)||r(e))),a=i[0],p=e.navigationSystem.getSelectUpdate(a);return o.length<t.length?n?.("apply",`Overriding previous selection updates with selection of entity ${a}`,{removed:t.filter(e=>l(e)||r(e)),added:p}):n?.("apply",`Selecting entity ${a}`,{added:p}),[...o,p]},{select:{entity:e=>u(t=>(n,r,o,l)=>{t.storeSystem.prepareStateEmissionWithoutTransformation(n,r,o);let a=d(n,r,o,t,l);if(0===a.length)return n;let p=a.map(e).filter(i);return 0===p.length?(l?.("no-resolve","Custom selector did not return any entity id, skipping selection"),n):s(t,n,p,l)}),self:()=>u(e=>(t,i,n,r)=>{let o=d(t,i,n,e,r);return 0===o.length?t:s(e,t,o.map(e=>{if(!h(e))throw Error("Context does not have entity id");return e.entityId}),r)}),ancestorOfType:e=>u(t=>(r,o,l,a)=>{let p=d(r,o,l,t,a);if(0===p.length)return r;let g=p.map(e=>{if(!h(e))throw Error("Context does not have entity id");return e.entityId}),f=p.map(i=>{if(!h(i))throw Error("Context does not have entity id");let r=t.compositionProjections.getTree(o).map.get(i.entityId);if(!r)throw Error(`Entity with id ${i.entityId} not found in the composition tree. The state is invalid!`);for(let t of r.ancestors())if(e.includes(n(t.id)))return t.id}),u=f.filter(i);return(u.length<g.length&&a?.("no-apply",0===u.length?"No entities have ancestor of the specified type, skipping selection":"Some entities do not have ancestor of the specified type",{entityIds:g.filter((e,t)=>void 0===f[t])}),0===u.length)?r:s(t,r,u,a)})},deselect:()=>u(e=>(t,i,n,o)=>0===d(t,i,n,e,o).length?t:[...t.filter(e=>!(l(e)||r(e))),e.navigationSystem.getDeselectUpdate()]),navigateTo:e=>u(t=>(n,r,l,a)=>{let p=d(n,r,l,t,a);if(0===p.length)return n;let s=p.map(t=>"function"==typeof e?e(t):e).filter(i);if(0===s.length)return a?.("no-resolve","Custom selector did not return any navigation state, skipping navigation"),n;s.length>1&&a?.("apply","Multiple navigation states selected, picking the first one",{navigationStates:s});let g=s[0],f=t.navigationSystem.getNavigationUpdate(g),u=n.filter(e=>!o(e));return u.length<n.length?a?.("apply",`Overriding previous navigation updates with ${g}`,{removed:n.filter(e=>o(e)),added:f}):a?.("apply",`Navigating to ${g}`,{added:f}),[...u,f]}),changeView:e=>u(t=>(n,o,p,s)=>{let g=d(n,o,p,t,s);if(0===g.length)return n;let f=g.map(t=>"function"==typeof e?e(t):e).filter(i);if(0===f.length)return s?.("no-resolve","Custom selector did not return any view state, skipping view change"),n;f.length>1&&s?.("apply","Multiple view states selected, picking the first one",{viewStates:f});let u=f[0],h=t.navigationSystem.getViewUpdate(u),c=n.filter(e=>!a(e));return c.length<n.length?s?.("apply",`Overriding previous view state updates with ${u}`,{removed:n.filter(e=>l(e)||r(e)),added:h}):s?.("apply",`Changing view to ${u}`,{added:h}),[...c,h]})})}};

package/dist/domain/domain-context/transformers/auto-snap-transformer.d.ts

@@ -1,15 +1,11 @@
 import { Euler, Vector3 } from 'three';
-import type { ComponentModification, StateUpdate } from '../../components/updates.js';
-import type { ComponentSnapshot } from '../../core/component.js';
-import { type $DomainEntity, type DomainEntity, type DomainEntityId } from '../../core/index.js';
-import { type DimensionUnit } from '../../dimensions/dimensions.js';
-import type { ComponentReader } from '../../domain-runtime/domain-context/index.js';
-import type { PositionProjections } from '../../projections/position-projections.js';
-import type { AnySnapMatch, WorldSnapPoint } from '../../projections/snap-matching.js';
-import type { SnappingProjections } from '../../projections/snapping-projections.js';
+import { type $DomainEntity, type ComponentModification, type ComponentSnapshot, type DomainEntity, type DomainEntityId, type StateUpdate } from '../../core/index.js';
+import { type DimensionUnit } from '../../dimensions/index.js';
+import type { ComponentReader } from '../../domain-runtime/index.js';
+import type { AnySnapMatch, PositionProjections, SnappingProjections, WorldSnapPoint } from '../../projections/index.js';
 import { dragHandleComponent, hotspotDragHandleComponent, snapPointComponent } from '../../system-components/index.js';
-import type { DimensionSystem } from '../dimension-system/dimension-system.js';
-import type { StoreSystem, TransformerLogFunction, UpdateTransformer } from '../store-system/store-system.js';
+import type { DimensionSystem } from '../dimension-system/index.js';
+import type { StoreSystem, TransformerLogFunction, UpdateTransformer } from '../store-system/index.js';
 export declare const AutoSnapUpdateTag: 'AutoSnap.applied';
 export type AutoSnapType = 'point' | 'edge' | 'plane' | 'axis';
 export interface AutoSnapMetadata {

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,10 +1,10 @@
-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> = {
     /**
-     * Creates a registration object consumed in `createTransformers` callback of the app config.
+     * Creates a registration object consumed by the runtime spec's `createTransformers` factory.
      */
     register: RegisterFunction<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>;
 };

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,7 +1,6 @@
 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, ResetStateEmission, StateEmission } from '../core/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 export interface UndoCapabilities {
     readonly canUndo: boolean;
     readonly canRedo: boolean;

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{};

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

@@ -1,13 +1,5 @@
-import type { DomainComponentOptic } from '../../components/index.js';
-import { type AnyDomain } from '../../core/domain.js';
-import type { AnyDomainFactory, AnyExpressionContext, DomainEntity, DomainMode, SystemComponentTypeConstraint } from '../../core/index.js';
-import { type AnyActionSystem } from '../../domain-context/action-system/action-system.js';
-import { type AnyDimensionSystem } from '../../domain-context/dimension-system/dimension-system.js';
-import type { AnyDomainContextSystems } from '../../domain-context/domain-context-systems.js';
-import { type AnyNavigationSystem } from '../../domain-context/navigation-system/navigation-system.js';
-import { type AnyRecipeCookerSystem } from '../../domain-context/recipe-system/recipe-cooker-system.js';
-import { type AnyStoreSystem } from '../../domain-context/store-system/store-system.js';
-import { type AnyUndoSystem } from '../../domain-context/undo-system.js';
+import { type AnyDomain, type AnyDomainFactory, type DomainComponentOptic, type DomainMode, type SystemComponentTypeConstraint } from '../../core/index.js';
+import { type AnyActionSystem, type AnyDimensionSystem, type AnyDomainContextSystems, type AnyNavigationSystem, type AnyRecipeCookerSystem, type AnyStoreSystem, type AnyUndoSystem } from '../../domain-context/index.js';
 import { type AnyBlenderProjections, type AnyCollisionProjections, type AnyCompositionProjections, type AnyConstraintProjections, type AnyPositionProjections, type AnyProjectedEntitiesProjections, type AnySnappingProjections, type AnyValidationProjections } from '../../projections/index.js';
 import { type AnySketchingProjections } from '../../sketching/sketching-projections.js';
 import type { AccessInfoSelectors, AccessSelectorState } from '../access/index.js';
@@ -16,23 +8,25 @@ import type { DomainServicesSelectors } from '../domain-services/index.js';
 import type { EnvironmentSelectors } from '../environment/index.js';
 import type { ApplicationLoadedData } from '../loaded-data/index.js';
 import type { DomainSessionContext, SessionContextSelectorState, SessionContextSelectors } from '../session-context/index.js';
-import type { SpecSelectorState, SpecSelectors } from '../spec/index.js';
+import { type SpecSelectorState, type SpecSelectors } from '../spec/index.js';
 import type { WebComponentSelectorState, WebComponentSelectors } from '../web-component/index.js';
 import type { DomainContextApplicationActions } from './actions.js';
 import { type AnyComponentReader } from './component-reader.js';
 import { DomainContext } from './domain-context.js';
+import type { AnyExpressionContext } from './expression-context.js';
 import type { ApplicationDomainContextState, DomainApplicationType, DomainContextInitializationContext, DomainContextInitializationIdentity, DomainContextInitializationState, InitializableSystem, SchemaCoherence } from './types.js';
-type ComponentOptic<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>> = DomainComponentOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITIES, SystemComponentTypeConstraint>;
+/** A component optic of any project, for any component type. */
+type ComponentOptic = DomainComponentOptic<any, any, any, any, any, any, SystemComponentTypeConstraint>;
 /**
  * Lookup indexes derived from the current component optics. The component reader and the
  * component write systems share this representation so a runtime optic update is observed
  * consistently across reads and writes.
  */
-export interface ComponentReaderIndexes<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>> {
-    readonly opticMap: ReadonlyMap<ENTITIES['type'], ReadonlyMap<SystemComponentTypeConstraint, ReadonlyMap<string, ComponentOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>>>>;
-    readonly allComponentTypes: ReadonlyMap<ENTITIES['type'], ReadonlySet<SystemComponentTypeConstraint>>;
-    readonly allComponentInstanceNames: ReadonlyMap<ENTITIES['type'], ReadonlyMap<SystemComponentTypeConstraint, ReadonlySet<string>>>;
-    readonly dynamicInstanceNames: ReadonlyMap<ENTITIES['type'], ReadonlyMap<SystemComponentTypeConstraint, readonly string[]>>;
+export interface ComponentReaderIndexes {
+    readonly opticMap: ReadonlyMap<string, ReadonlyMap<SystemComponentTypeConstraint, ReadonlyMap<string, ComponentOptic>>>;
+    readonly allComponentTypes: ReadonlyMap<string, ReadonlySet<SystemComponentTypeConstraint>>;
+    readonly allComponentInstanceNames: ReadonlyMap<string, ReadonlyMap<SystemComponentTypeConstraint, ReadonlySet<string>>>;
+    readonly dynamicInstanceNames: ReadonlyMap<string, ReadonlyMap<SystemComponentTypeConstraint, readonly string[]>>;
 }
 interface Context {
     readonly applicationType: DomainApplicationType;
@@ -76,7 +70,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     selectAliasMap: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").AnyAliasMap>;
     selectAllowedRootEntityTypes: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").AnyAllowedRootEntityTypes>;
     selectEntityReflections: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").AnyEntityReflections>;
-    selectMigrate: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").MigrateFunction<DomainEntity<string>>>;
+    selectMigrate: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").MigrateFunction<import("../../index.js").DomainEntity<string>>>;
     selectLatestMode: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, DomainMode>;
     selectLatestConfigurationId: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, string | null>;
     selectLatestSessionContext: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, DomainSessionContext> | import("@salsita-ai/common/utils").Selector<SessionContextSelectorState, DomainSessionContext | null>;
@@ -88,9 +82,9 @@ export declare const createDomainContextSelectors: (context: Context) => {
     selectIsViewMode: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, boolean>;
     selectInitializationState: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, DomainContextInitializationState>;
     selectComponentOptics: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, readonly import("../../index.js").AnyDomainComponentOptic[]>;
-    selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, ComponentReaderIndexes<any, any, any, any, any>>;
+    selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, ComponentReaderIndexes>;
     selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, {
-        componentReaderIndexes: ComponentReaderIndexes<any, any, any, any, any>;
+        componentReaderIndexes: ComponentReaderIndexes;
         domainExpressions: import("../../index.js").AnyExpressions;
         allowedRootEntityTypes: import("../../index.js").AnyAllowedRootEntityTypes;
     }>;
@@ -98,7 +92,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     selectViewStates: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, readonly string[]>;
     selectToolStates: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, readonly string[]>;
     selectExportStates: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, readonly string[]>;
-    selectCreateTransformers: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../domain-context/store-system/store-system.js").AnyCreateTransformersFactory>;
+    selectCreateTransformers: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").AnyCreateTransformersFactory>;
     selectLatestLoadedData: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData | null>;
     selectLoadedData: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData>;
     selectInitialDomainState: import("@salsita-ai/common/utils").Selector<DomainContextSelectorState, import("../../index.js").DomainState<any>>;
@@ -127,12 +121,12 @@ export declare const createDomainContextSelectors: (context: Context) => {
     getAliasMap: () => import("../../index.js").AnyAliasMap;
     getAllowedRootEntityTypes: () => import("../../index.js").AnyAllowedRootEntityTypes;
     getEntityReflections: () => import("../../index.js").AnyEntityReflections;
-    getMigrate: () => import("../../index.js").MigrateFunction<DomainEntity<string>>;
+    getMigrate: () => import("../../index.js").MigrateFunction<import("../../index.js").DomainEntity<string>>;
     getActiveMode: () => DomainMode;
     getIsInitialized: () => boolean;
-    getComponentReaderIndexes: () => ComponentReaderIndexes<any, any, any, any, any>;
+    getComponentReaderIndexes: () => ComponentReaderIndexes;
     getStoreRuntimeDependencies: () => {
-        componentReaderIndexes: ComponentReaderIndexes<any, any, any, any, any>;
+        componentReaderIndexes: ComponentReaderIndexes;
         domainExpressions: import("../../index.js").AnyExpressions;
         allowedRootEntityTypes: import("../../index.js").AnyAllowedRootEntityTypes;
     };
@@ -140,7 +134,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     getViewStates: () => readonly string[];
     getToolStates: () => readonly string[];
     getExportStates: () => readonly string[];
-    getCreateTransformers: () => import("../../domain-context/store-system/store-system.js").AnyCreateTransformersFactory | undefined;
+    getCreateTransformers: () => import("../../index.js").AnyCreateTransformersFactory | undefined;
     getLoadedData: () => import("../index.js").ConfiguratorLoadedData;
     getInitialDomainState: () => import("../../index.js").DomainState<any>;
     getFrontendData: () => Record<string, unknown>;