@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/domain/domain-context/navigation-system/navigation-updates.js

@@ -0,0 +1 @@
+import{debugStateComponent as e}from"../../components/debug-state-component.js";import{dragStateComponent as t}from"../../components/drag-state-component.js";import{exportStateComponent as a}from"../../components/export-state-component.js";import{fullscreenStateComponent as o}from"../../components/fullscreen-state-component.js";import{hoverStateComponent as n}from"../../components/hover-state-component.js";import{navigationStateComponent as i}from"../../components/navigation-state-component.js";import{selectionStateComponent as p}from"../../components/selection-state-component.js";import{toolStateComponent as c}from"../../components/tool-state-component.js";import{viewStateComponent as r}from"../../components/view-state-component.js";import{viewportStateComponent as d}from"../../components/viewport-state-component.js";export const NavigationUpdateTag={Initial:"navigation.initial",ReplaceNavigation:"navigation.replaceNavigation",PushNavigation:"navigation.pushNavigation",PopNavigation:"navigation.popNavigation",ActiveateView:"navigation.activateView",ActivateTool:"navigation.activateTool",SetExportState:"navigation.setExportState",SelectEntity:"navigation.selectEntity",Deselect:"navigation.deselect",ToggleFullscreen:"navigation.toggleFullscreen",SetViewport:"navigation.setViewport",HoverIn:"navigation.hoverIn",HoverOut:"navigation.hoverOut",DragStart:"navigation.dragStart",DragEnd:"navigation.dragEnd"};export const isInitialNavigationUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===i;export const isNavigationUpdate=e=>(e.updateTag===NavigationUpdateTag.ReplaceNavigation||e.updateTag===NavigationUpdateTag.PushNavigation||e.updateTag===NavigationUpdateTag.PopNavigation)&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===i;export const isInitialViewUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===r;export const isInitialToolUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===c;export const isViewUpdate=e=>e.updateTag===NavigationUpdateTag.ActiveateView&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===r;export const isToolUpdate=e=>e.updateTag===NavigationUpdateTag.ActivateTool&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===c;export const isExportUpdate=e=>e.updateTag===NavigationUpdateTag.SetExportState&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===a;export const isInitialSelectionUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===p;export const isSelectUpdate=e=>e.updateTag===NavigationUpdateTag.SelectEntity&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===p;export const isDeselectUpdate=e=>e.updateTag===NavigationUpdateTag.Deselect&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===p;export const isHoverInUpdate=e=>e.updateTag===NavigationUpdateTag.HoverIn&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===n;export const isHoverOutUpdate=e=>e.updateTag===NavigationUpdateTag.HoverOut&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===n;export const isInitialFullscreenUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===o;export const isToggleFullscreenUpdate=e=>e.updateTag===NavigationUpdateTag.ToggleFullscreen&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===o;export const isInitialDebugUpdate=t=>t.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===t.kind&&t.componentInstance.componentType===e;export const isInitialViewportUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===d;export const isSetViewportUpdate=e=>e.updateTag===NavigationUpdateTag.SetViewport&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===d;export const isInitialDragUpdate=e=>e.updateTag===NavigationUpdateTag.Initial&&"createEphemeralRecord"===e.kind&&e.componentInstance.componentType===t;export const isDragStartUpdate=e=>e.updateTag===NavigationUpdateTag.DragStart&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===t;export const isDragEndUpdate=e=>e.updateTag===NavigationUpdateTag.DragEnd&&"modifyEphemeralRecord"===e.kind&&e.componentInstance.componentType===t;

package/dist/domain/domain-context/navigation-system/selection-transformers.d.ts

@@ -0,0 +1,20 @@
+import { type $DomainEntity, type DomainEntity } from '../../core/model.js';
+import type { DomainContextSystems } from '../domain-context-systems.js';
+import type { UpdateTransformer } from '../store-system/store-system.js';
+/**
+ * Resets selection (Deselect update) when the navigation state is one of the provided states.
+ */
+export declare const createResetSelectionOnNavigationTransformer: <ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(navigationStates: NAVIGATION_STATES[], ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => UpdateTransformer<ENTITIES>;
+/**
+ * Simple transformer that navigates to a specific navigation state when an entity of a specific type is selected.
+ */
+export declare const createNavigationOnSelectionTransformer: <ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(entityType: ENTITIES['type'], navigationState: NAVIGATION_STATES, ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => UpdateTransformer<ENTITIES>;
+/**
+ * Simple transformer that navigates to a specific navigation state when a specified selection change occurs (defined by from and to states).
+ */
+export declare const createNavigationOnSelectionChangeTransformer: <ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(fromEntityType: ENTITIES['type'], toEntityType: ENTITIES['type'], navigationState: NAVIGATION_STATES, ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => UpdateTransformer<ENTITIES>;
+export declare const createNavigationOnDeselectTransformer: <ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(navigationState: NAVIGATION_STATES, ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => UpdateTransformer<ENTITIES>;
+/**
+ * Transformer that selects the parent of the currently selected entity when it is deselected resulting in a hierarchical selection.
+ */
+export declare const createSelectParentOnDeselectionTransformer: <ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, ALLOWED_ROOT_ENTITIES extends ENTITIES, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string>(ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => UpdateTransformer<ENTITIES>;

package/dist/domain/domain-context/navigation-system/selection-transformers.js

@@ -0,0 +1 @@
+import{domainEntityTypeFromId as t,isDomainEntityId as e}from"../../core/model.js";import{isDeselectUpdate as a,isNavigationUpdate as n,isSelectUpdate as i}from"./navigation-updates.js";export const createResetSelectionOnNavigationTransformer=(t,e)=>a=>a.flatMap(a=>n(a)&&t.includes(a.writableState.activeState)?[a,e.navigationSystem.getDeselectUpdate()]:[a]);export const createNavigationOnSelectionTransformer=(e,a,n)=>o=>o.flatMap(o=>i(o)&&t(o.writableState.selectedEntityId)===e?[o,n.navigationSystem.getNavigationUpdate(a)]:[o]);export const createNavigationOnSelectionChangeTransformer=(e,a,n,o)=>(r,s)=>r.flatMap(r=>{if(!i(r))return[r];let c=t(o.navigationSystem.getActiveSelectionState(s)),l=t(r.writableState.selectedEntityId);return c===e&&l===a?[r,o.navigationSystem.getNavigationUpdate(n)]:[r]});export const createNavigationOnDeselectTransformer=(t,e)=>n=>n.flatMap(n=>a(n)?[n,e.navigationSystem.getNavigationUpdate(t)]:[n]);export const createSelectParentOnDeselectionTransformer=t=>(n,i)=>{let o=t.navigationSystem.getActiveSelectionState(i);return n.flatMap(n=>{if(a(n)&&e(o)){let e=t.compositionProjections.getTree(i).map.get(o);if(!e)throw Error(`Can not fallback to parent selected entity, entity with id ${o} not found in the composition tree. The state is invalid!`);return e.parent?[n,t.navigationSystem.getSelectUpdate(e.parent.id)]:[n]}return[n]})};

package/dist/domain/domain-context/recipe-system/recipe-cooker-system.d.ts

@@ -0,0 +1,45 @@
+import { type DomainEntityCreation, type DomainEntityReplacement, type StateUpdate } from '../../components/updates.js';
+import { type DomainEntity, type DomainEntityId, type DomainState } from '../../core/index.js';
+import type { DomainContextSelectors } from '../../domain-runtime/domain-context/index.js';
+import type { EntityRecipe } from './recipes.js';
+export declare const CreateRecipeUpdateTag = "createRecipe";
+export type IsCreateRecipeUpdate<ENTITIES extends DomainEntity<string>> = <TYPE extends ENTITIES['type']>(update: StateUpdate<ENTITIES, ENTITIES>, types: readonly TYPE[]) => update is DomainEntityCreation<Extract<ENTITIES, {
+    type: TYPE;
+}>, ENTITIES>;
+export declare const isCreateEntityUpdate: (update: StateUpdate<DomainEntity<string>, DomainEntity<string>>, types: readonly string[]) => update is DomainEntityCreation<DomainEntity<string>, DomainEntity<string>>;
+export declare const ReplaceRecipeUpdateTag = "replaceRecipe";
+export type IsReplaceRecipeUpdate<ENTITIES extends DomainEntity<string>> = <TYPE extends ENTITIES['type']>(update: StateUpdate<ENTITIES, ENTITIES>, types: readonly TYPE[]) => update is DomainEntityReplacement<Extract<ENTITIES, {
+    type: TYPE;
+}>>;
+export declare const isReplaceEntityUpdate: (update: StateUpdate<DomainEntity<string>, DomainEntity<string>>, types: readonly string[]) => update is DomainEntityReplacement<DomainEntity<string>>;
+export interface RecipeCookerSystemContext {
+    /**
+     * The recipe cooker's only window into the runtime registry — the component optic indexes used
+     * to rewrite entity references are resolved per call, never snapshotted, so a hot-reloaded spec
+     * is observed without rebuilding the system.
+     */
+    readonly selectors: DomainContextSelectors;
+}
+/** RecipeCookerSystem with its entity types erased — how the runtime selectors expose the instance. */
+export type AnyRecipeCookerSystem = RecipeCookerSystem<any>;
+export declare class RecipeCookerSystem<ENTITIES extends DomainEntity<string>> {
+    private readonly _context;
+    constructor(_context: RecipeCookerSystemContext);
+    private readonly _getFragmentComponents;
+    /**
+     * Cooks the provided recipes and returns an array of entities with their parent IDs.
+     * It takes care of all references, new id generation and composition.
+     *
+     * @param recipes - An array of entity recipes to be cooked.
+     * @param state - The current domain state.
+     * @returns An array of objects containing the cooked entity and its parent ID.
+     */
+    readonly cookRecipes: (recipes: ReadonlyArray<EntityRecipe<ENTITIES>>, state: DomainState<ENTITIES>) => {
+        entity: ENTITIES & {
+            id: DomainEntityId<string>;
+        };
+        parentId: DomainEntityId<string>;
+    }[];
+    readonly prepareCreateUpdates: (recipes: ReadonlyArray<EntityRecipe<ENTITIES>>, state: DomainState<ENTITIES>, parentId: ENTITIES['id'], collection?: string) => ReadonlyArray<DomainEntityCreation<ENTITIES, ENTITIES>>;
+    readonly prepareReplaceUpdates: (recipes: ReadonlyArray<EntityRecipe<ENTITIES>>, state: DomainState<ENTITIES>, entityId: ENTITIES['id'], keepChildren?: boolean) => ReadonlyArray<DomainEntityCreation<ENTITIES, ENTITIES> | DomainEntityReplacement<ENTITIES>>;
+}

package/dist/domain/domain-context/recipe-system/recipe-cooker-system.js

@@ -0,0 +1 @@
+import{systemUpdateFactory as e}from"../../components/updates.js";import{domainEntityTypeFromId as t,isDomainEntityId as n}from"../../core/index.js";import{composedOfComponent as i}from"../../relations/composed-of.js";import{referenceComponent as o}from"../../relations/reference-component.js";import{getIdSequence as a}from"../store-system/next-domain-entity-id.js";export const CreateRecipeUpdateTag="createRecipe";export const isCreateEntityUpdate=(e,n)=>"createDomainEntity"===e.kind&&e.updateTag===CreateRecipeUpdateTag&&n.includes(t(e.entityId));export const ReplaceRecipeUpdateTag="replaceRecipe";export const isReplaceEntityUpdate=(e,i)=>"replaceDomainEntity"===e.kind&&e.updateTag===ReplaceRecipeUpdateTag&&n(e.entityId)&&i.includes(t(e.entityId));export class RecipeCookerSystem{_context;constructor(e){this._context=e}_getFragmentComponents=(e,t)=>this._context.selectors.getComponentReader().readManyComponents({componentTypes:[t]},{rootEntityId:"Root-1",rootEntityType:"Root",entities:e,ephemeralRecords:[]});cookRecipes=(e,n)=>{let p=new Map,r=a(n.entities,[]);for(let t of e){let e=r.nextId(t.type);p.set(t.id,e)}let c=this._getFragmentComponents(e,o),s=e.map(e=>{let n={...e,id:p.get(e.id)};return c.filter(t=>t.componentInstance.entityId===e.id).reduce((n,i)=>{let o=this._context.selectors.getComponentReaderIndexes().opticMap.get(t(e.id))?.get(i.componentInstance.componentType)?.get(i.componentInstance.instanceName);if(o?.kind!=="simple")throw Error("References can only be simple optics!");return{...n,...o?.write({referencedEntityIds:i.state.referencedEntityIds.map(t=>t===e.id?t:p.get(t)??t)})}},n)}),d=this._getFragmentComponents(s,i);return s.map(e=>{let t=d.find(t=>t.state.childEntityIds.includes(e.id));return{entity:e,parentId:t?.componentInstance.entityId}})};prepareCreateUpdates=(t,n,i,o)=>this.cookRecipes(t,n).map(t=>t.parentId?e.DomainEntityCreation({entity:t.entity,collection:void 0,updateTag:CreateRecipeUpdateTag,parentId:t.parentId}):e.DomainEntityCreation({entity:t.entity,collection:o,updateTag:CreateRecipeUpdateTag,parentId:i}));prepareReplaceUpdates=(t,n,i,o)=>{let a=this.cookRecipes(t,n),p=a.filter(e=>!e.parentId);if(!p[0]||p.length>1)throw Error("Can not prepare ReplaceEntityRecipes, root entity not found in the cooked recipes. Please, make sure that defined recipes have always a single root entity.");return a.map(t=>t.parentId?e.DomainEntityCreation({entity:t.entity,collection:void 0,updateTag:ReplaceRecipeUpdateTag,parentId:t.parentId}):e.DomainEntityReplacement({entityId:i,replacementEntity:t.entity,updateTag:ReplaceRecipeUpdateTag,keepChildren:o??!1}))}}

package/dist/domain/domain-context/recipe-system/recipes.d.ts

@@ -0,0 +1,57 @@
+import type { OmitEmpty, OmitNever, UnionToIntersection } from '@salsita-ai/common/utils';
+import { type AliasMap, type EventualAlias, type ExpandAlias, type ExtractFromAliasedRecord, type TypeOrAlias } from '../../core/alias.js';
+import { type DomainEntity, type DomainEntityId, type EntityByType } from '../../core/model.js';
+import type { DomainEntityReflection } from '../../core/reflection.js';
+export type EntityDefaults<ENTITY extends DomainEntity<string>> = {
+    [K in Exclude<keyof ENTITY, 'id' | 'type'>]: ENTITY[K] extends DomainEntityId<any> ? null : ENTITY[K];
+};
+export type EntityRecipe<ENTITY extends DomainEntity<string>> = ENTITY;
+export type EntityOverrides<ENTITIES extends DomainEntity<string>, TYPE extends ENTITIES['type']> = Partial<Omit<EntityByType<ENTITIES, TYPE>, 'type'>> & {
+    type: TYPE;
+};
+export type DeclaredEntitiesDefaults<ENTITIES extends DomainEntity<string>> = {
+    [K in ENTITIES['type']]: EntityDefaults<EntityByType<ENTITIES, K>>;
+};
+type ExpandDefaults<ENTITIES extends DomainEntity<string>, ALIASES extends Readonly<Record<string, ENTITIES>>, ALIASED_DEFAULTS extends Partial<Record<TypeOrAlias<ENTITIES, ALIASES>, Record<string, unknown>>>> = {
+    [K in ENTITIES['type']]: ExtractFromAliasedRecord<ENTITIES, ALIASES, ALIASED_DEFAULTS, EventualAlias<ENTITIES, ALIASES, K> | K> extends infer DEFAULTS_FROM_ALIAS ? [
+        DEFAULTS_FROM_ALIAS
+    ] extends [never] ? Record<never, never> : unknown extends UnionToIntersection<DEFAULTS_FROM_ALIAS> ? never : UnionToIntersection<DEFAULTS_FROM_ALIAS> : never;
+};
+export type AliasedEntitiesDefaults<ENTITIES extends DomainEntity<string>, ALIASES extends Readonly<Record<string, ENTITIES>>> = {
+    [K in TypeOrAlias<ENTITIES, ALIASES>]?: Partial<EntityDefaults<ExpandAlias<ENTITIES, ALIASES, K>>>;
+};
+export type RecipeFactory<ENTITIES extends DomainEntity<string>> = <TYPE extends ENTITIES['type']>(overrides: EntityOverrides<ENTITIES, TYPE>) => EntityRecipe<EntityByType<ENTITIES, TYPE>>;
+type ConflictingDefaults<PROVIDED extends Record<string, Record<string, unknown>>, EXPECTED extends Record<string, Record<string, unknown>>> = OmitEmpty<OmitNever<{
+    [TYPE in keyof PROVIDED | keyof EXPECTED]: TYPE extends keyof EXPECTED ? TYPE extends keyof PROVIDED ? PROVIDED[TYPE] extends EXPECTED[TYPE] ? never : OmitNever<Exclude<EXPECTED[TYPE], PROVIDED[TYPE]>> : EXPECTED[TYPE] : never;
+}>>;
+type Build<ENTITIES extends DomainEntity<string>, PROVIDED extends Record<string, Record<string, unknown>>, EXPECTED extends Record<string, Record<string, unknown>>> = Record<string, never> extends ConflictingDefaults<PROVIDED, EXPECTED> ? {
+    build: () => RecipeFactory<ENTITIES>;
+} : {
+    /**
+     * DO NOT USE in runtime!
+     *
+     * This is just a dev-time tool to review which defaults you forgot to provide.
+     * Use your IDEs code-completion to see which entities have missing expressions
+     * and which expressions these are.
+     *
+     * Use the helper when you see the following error on the `.build()` method call:
+     * ```
+     * TS2349: This expression is not callable.
+     * Type never has no call signatures.
+     * ```
+     * simply
+     * ```ts
+     *   .withDefaults({...})
+     *   ._conflicts.Oven. // <- trigger code-completion here
+     * ```
+     */
+    _conflicts: ConflictingDefaults<PROVIDED, EXPECTED>;
+};
+export declare const RecipeFactoryBuilder: {
+    forAliases: <ENTITIES extends DomainEntity<string>, ALIASES extends Record<string, ENTITIES>>(aliasMap: AliasMap<ALIASES>) => {
+        forEntities: (entityReflections: ReadonlyArray<ENTITIES extends any ? DomainEntityReflection<ENTITIES> : never>) => {
+            withDefaults: <ALIASED_DEFAULTS extends AliasedEntitiesDefaults<ENTITIES, ALIASES>>(entitiesDefaults: ALIASED_DEFAULTS) => Build<ENTITIES, ExpandDefaults<ENTITIES, ALIASES, ALIASED_DEFAULTS>, DeclaredEntitiesDefaults<ENTITIES>>;
+        };
+    };
+};
+export {};

package/dist/domain/domain-context/recipe-system/recipes.js

@@ -0,0 +1 @@
+import{expandAlias as r}from"../../core/alias.js";import{_unsafeBuildDomainEntityId as e}from"../../core/model.js";export const RecipeFactoryBuilder={forAliases:t=>({forEntities:o=>({withDefaults:i=>{let a={};Object.entries(i).forEach(([e,o])=>{r(t,e).forEach(r=>{a[r]={...a[r],...o}})});let f=new Map(o.map(r=>[r.type,r._meta.validator]));return Object.entries(a).forEach(([r,t])=>{let o=f.get(r);if(!o)throw Error(`Defaults provided for unknown entity ${r}`);if(!o({id:e(r,1),type:r,...t}))throw console.error(o.errors,t),Error(`Invalid defaults for ${r} entity.`)}),{build:()=>r=>({id:e(r.type,1),...a[r.type],...r})}}})})};

package/dist/domain/domain-context/relation-transformers/cascade-deletes.d.ts

@@ -0,0 +1,7 @@
+import { type DomainEntity } from '../../core/model.js';
+import type { CompositionProjections } from '../../projections/composition-projections.js';
+import type { IncrementalUpdateTransformer } from '../store-system/store-system.js';
+/**
+ * This transformer reacts on entity deletion and removes any descendant entities of the deleted one.
+ */
+export declare const createCascadeDeletesTransformer: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES>(compositionProjections: CompositionProjections<ENTITIES, ALLOWED_ROOT_ENTITIES>) => IncrementalUpdateTransformer<ENTITIES>;

package/dist/domain/domain-context/relation-transformers/cascade-deletes.js

@@ -0,0 +1 @@
+import{systemUpdateFactory as e}from"../../components/updates.js";import{isVirtualEntityId as t}from"../../core/model.js";let n=e=>"deleteEntity"===e.kind||"replaceDomainEntity"===e.kind&&!e.keepChildren;export const createCascadeDeletesTransformer=i=>(o,r,d,l,a=[])=>{let s=o.filter(n);if(0===s.length)return o;let{map:f}=i.getTree(r),p=[],c=new Set([...s,...a.filter(n)].map(e=>e.entityId));for(let n of s){if(t(n.entityId))continue;let i=f.get(n.entityId);if(i)for(let t of i.descendants())c.has(t.id)||(p.push(e.EntityDeletion({entityId:t.id,updateTag:"composition.cascadeDelete"})),c.add(t.id))}return p.length>0?[...o,...p]:o};

package/dist/domain/domain-context/relation-transformers/cascade-ref-pruning.d.ts

@@ -0,0 +1,8 @@
+import type { DomainEntity } from '../../core/model.js';
+import type { ComponentReader } from '../../domain-runtime/domain-context/index.js';
+import type { IncrementalUpdateTransformer } from '../store-system/store-system.js';
+/**
+ * This transformer reacts on entity deletion and removes references to the deleted entities from any reference field,
+ * through the appropriate system component.
+ */
+export declare const createCascadeRefPruningTransformer: <ENTITIES extends DomainEntity<string>>(componentReader: ComponentReader<ENTITIES>) => IncrementalUpdateTransformer<ENTITIES>;

package/dist/domain/domain-context/relation-transformers/cascade-ref-pruning.js

@@ -0,0 +1 @@
+import{isNonNullish as e}from"@salsita-ai/common/utils";import{systemUpdateFactory as t}from"../../components/updates.js";import{referenceComponent as n}from"../../relations/reference-component.js";export const createCascadeRefPruningTransformer=r=>(i,o,a,s,c=[])=>{let m=new Set([...i,...c].filter(e=>"deleteEntity"===e.kind).map(e=>e.entityId));if(0===m.size)return i;let d=new Set([...i,...c].filter(e=>"deleteEntity"===e.kind||"replaceDomainEntity"===e.kind).map(e=>e.entityId)),p=r.readManyComponents({componentTypes:[n]},o).map(e=>{if(d.has(e.componentInstance.entityId))return;let n=e.state.referencedEntityIds.filter(e=>!m.has(e));if(n.length<e.state.referencedEntityIds.length)return t.ComponentModification({componentInstance:e.componentInstance,updateTag:"refs.cascadePruning",writableState:{referencedEntityIds:n}})}).filter(e);return p.length>0?[...i,...p]:i};

package/dist/domain/domain-context/relation-transformers/create-entity-refs.d.ts

@@ -0,0 +1,7 @@
+import type { DomainEntity } from '../../core/model.js';
+import type { ComponentReader } from '../../domain-runtime/domain-context/index.js';
+import type { IncrementalUpdateTransformer } from '../store-system/store-system.js';
+/**
+ * This transformer reacts on entity creation and adds the entity to all references specified.
+ */
+export declare const createCreateEntityRefsTransformer: <ENTITIES extends DomainEntity<string>>(componentReader: ComponentReader<ENTITIES>) => IncrementalUpdateTransformer<ENTITIES>;

package/dist/domain/domain-context/relation-transformers/create-entity-refs.js

@@ -0,0 +1,2 @@
+import{systemUpdateFactory as e}from"../../components/updates.js";import{referenceComponent as t}from"../../relations/reference-component.js";export const createCreateEntityRefsTransformer=n=>(o,r)=>{let i=o.filter(e=>"createDomainEntity"===e.kind);if(0===i.length)return o;let a=i.flatMap(o=>{if(void 0===o.collection)return[];let i=n.readManyComponents({componentTypes:[t],entityIds:[o.parentId],instanceNames:[o.collection]},r);if(0===i.length)throw Error(`Newly created entity ${o.entityId} should be added to collection ${o.collection} on parent entity ${o.parentId}, but no such collection can be found.
+Check whether the collection name is correctly specified in the createDomainEntity update.`);return i.map(t=>e.ComponentModification({componentInstance:t.componentInstance,updateTag:"refs.update",writableState:{referencedEntityIds:t.state.referencedEntityIds.concat(o.entityId)}}))}).reduce((t,n)=>{let o=t[n.entityId.toString()];if(o){let r=e.ComponentModification({componentInstance:o.componentInstance,updateTag:o.updateTag,writableState:{referencedEntityIds:Array.from(new Set([...o.writableState.referencedEntityIds,...n.writableState.referencedEntityIds]))}});t[n.entityId.toString()]=r}else t[n.entityId.toString()]=n;return t},{});return o.concat(Object.values(a))};

package/dist/domain/domain-context/relation-transformers/replace-refs.d.ts

@@ -0,0 +1,7 @@
+import type { DomainEntity } from '../../core/model.js';
+import type { ComponentReader } from '../../domain-runtime/domain-context/index.js';
+import type { IncrementalUpdateTransformer } from '../store-system/store-system.js';
+/**
+ * This transformer reacts on entity replacement and updates references to the replaced entities in any other entity.
+ */
+export declare const createRefReplaceTransformer: <ENTITIES extends DomainEntity<string>>(componentReader: ComponentReader<ENTITIES>) => IncrementalUpdateTransformer<ENTITIES>;

package/dist/domain/domain-context/relation-transformers/replace-refs.js

@@ -0,0 +1 @@
+import{isNonNullish as e}from"@salsita-ai/common/utils";import{systemUpdateFactory as t}from"../../components/updates.js";import{referenceComponent as n}from"../../relations/reference-component.js";export const createRefReplaceTransformer=o=>(i,r,a,p,c=[])=>{let m=new Map(i.filter(e=>"replaceDomainEntity"===e.kind).map(e=>[e.entityId,e.replacementEntity.id]));if(0===m.size)return i;let s=new Set([...i,...c].filter(e=>"deleteEntity"===e.kind||"replaceDomainEntity"===e.kind).map(e=>e.entityId)),d=o.readManyComponents({componentTypes:[n]},r).map(e=>{if(s.has(e.componentInstance.entityId)&&!m.has(e.componentInstance.entityId))return;let n=!1,o=e.state.referencedEntityIds.map(e=>{let t=m.get(e);return void 0!==t?(n=!0,t):e});if(n)return t.ComponentModification({componentInstance:{...e.componentInstance,entityId:m.get(e.componentInstance.entityId)??e.componentInstance.entityId},updateTag:"refs.replace",writableState:{referencedEntityIds:o}})}).filter(e);return d.length>0?[...i,...d]:i};

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

@@ -0,0 +1,4 @@
+import type { DataUpdate } from '../../components/updates.js';
+import type { DomainEntity } from '../../core/model.js';
+import type { DomainState } from '../../core/state.js';
+export declare const applyUpdates: <ENTITIES extends DomainEntity<string>>(updates: ReadonlyArray<DataUpdate<ENTITIES, ENTITIES>>, state: DomainState<ENTITIES>) => DomainState<ENTITIES>;

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

@@ -0,0 +1 @@
+import{match as e}from"ts-pattern";import{isEqualComponentInstance as t}from"../../core/component.js";import{isVirtualEntityId as n}from"../../core/model.js";export const applyUpdates=(o,i)=>o.reduce((o,r)=>e(r).with({kind:"createDomainEntity"},e=>({...o,entities:[...o.entities,e.entity]})).with({kind:"deleteEntity"},e=>{let t=o.entities;if(!n(e.entityId)&&(t=o.entities.filter(t=>t.id!==e.entityId)).length===o.entities.length)throw Error(`No-op: Cannot remove domain entity #${String(e.entityId)}, because it does not exist`);let i=o.ephemeralRecords.filter(t=>t.componentInstance.entityId!==e.entityId);if(n(e.entityId)&&i.length===o.ephemeralRecords.length)throw Error(`No-op: Cannot remove virtual entity #${e.entityId}, because it does not exist`);return{...o,entities:t,ephemeralRecords:i}}).with({kind:"modifyDomainEntity"},e=>{let t=!1,n=o.entities.map(n=>n.id===e.entityId?(t=!0,{...n,...e.stateDelta}):n);if(!t)throw Error(`No-op: Cannot modify domain entity #${String(e.entityId)}, because it does not exist`);return{...o,entities:n}}).with({kind:"replaceDomainEntity"},e=>{let t=!1,n=o.entities.map(n=>n.id===e.entityId?(t=!0,e.replacementEntity):n);if(!t)throw Error(`No-op: Cannot replace entity #${String(e.entityId)} as it was not found in the domain state`);let r=o.ephemeralRecords.filter(t=>t.componentInstance.entityId!==e.entityId),a=e.entityId===i.rootEntityId?{rootEntityId:e.replacementEntity.id,rootEntityType:e.replacementEntity.type}:void 0;return{...o,...a,ephemeralRecords:r,entities:n}}).with({kind:"modifyEphemeralRecord"},e=>{let n=!1,i=o.ephemeralRecords.map(o=>t(o.componentInstance,e.componentInstance)?(n=!0,{...o,state:{...o.state,...e.writableState}}):o);if(!n)throw Error(`No-op: Cannot modify ephemeral record #${e.entityId} for component ${e.componentInstance.componentType.name}#${e.componentInstance.instanceName}, because it does not exist`);return{...o,ephemeralRecords:i}}).with({kind:"createEphemeralRecord"},e=>{if(o.ephemeralRecords.find(n=>t(n.componentInstance,e.componentInstance)))throw Error(`No-op: Cannot create ephemeral record #${e.entityId} for component ${e.componentInstance.componentType.name}#${e.componentInstance.instanceName}, because it already exists`);let n=[...o.ephemeralRecords,{entityId:e.entityId,updateTag:e.updateTag,state:e.initialState,componentInstance:e.componentInstance}];return{...o,ephemeralRecords:n}}).with({kind:"deleteEphemeralRecord"},e=>{let n=o.ephemeralRecords.filter(n=>!t(n.componentInstance,e.componentInstance));if(n.length===o.ephemeralRecords.length)throw Error(`No-op: Cannot delete ephemeral record #${e.entityId} for component ${e.componentInstance.componentType.name}#${e.componentInstance.instanceName}, because it does not exist`);return{...o,ephemeralRecords:n}}).exhaustive(),i);

package/dist/domain/domain-context/store-system/lifecycle-state-slice.d.ts

@@ -0,0 +1,30 @@
+import type { ObservableWithLastValue } from '@salsita-ai/common/utils';
+export interface LifecycleStateSliceProps {
+    /**
+     * Message of the error thrown when `value` is read while the slice is uninitialized. Owners
+     * phrase it in their own domain terms so the failure points at the owning system, not at this
+     * container.
+     */
+    readonly uninitializedError: string;
+}
+/**
+ * A state container that starts without a value and receives one when its owner first initializes.
+ * Its `observable` never completes, so graph-lifetime subscribers remain attached while later
+ * initializations replace the current value.
+ *
+ * Owned by {@link StoreSystem}, which exposes one slice per public state stream.
+ */
+export declare class LifecycleStateSlice<T> {
+    private readonly _props;
+    private readonly subject;
+    /**
+     * Public view of the slice: emits only while a value is present and exposes its current value
+     * through `.value`.
+     */
+    readonly observable: ObservableWithLastValue<T>;
+    constructor(_props: LifecycleStateSliceProps);
+    get isInitialized(): boolean;
+    get value(): T;
+    next: (value: T) => void;
+    nextIfDifferent: (value: T) => void;
+}

package/dist/domain/domain-context/store-system/lifecycle-state-slice.js

@@ -0,0 +1 @@
+import{BehaviorSubject as e,filter as t}from"rxjs";let i=Symbol("LifecycleStateSlice.uninitialized");export class LifecycleStateSlice{_props;subject=new e(i);observable;constructor(e){this._props=e;let s=this.subject.pipe(t(e=>e!==i));Object.defineProperty(s,"value",{get:()=>this.value}),this.observable=s}get isInitialized(){return this.subject.value!==i}get value(){let e=this.subject.value;if(e===i)throw Error(this._props.uninitializedError);return e}next=e=>{this.subject.next(e)};nextIfDifferent=e=>{this.subject.value!==e&&this.next(e)}}

package/dist/domain/domain-context/store-system/next-domain-entity-id.d.ts

@@ -0,0 +1,38 @@
+import type { StateUpdate } from '../../components/updates.js';
+import { type DomainEntity, type DomainEntityId } from '../../core/model.js';
+import type { DomainState } from '../../core/state.js';
+/**
+ * Returns the next available entity id for the given entity type.
+ *
+ * The `pendingUpdates` is used to skip over ids that are already reserved by pending updates.
+ * It is intentionally mandatory, in order for people not to miss it, but if you really don't have any pending updates,
+ * just pass an empty array.
+ *
+ * @param domainState current domain state to use for finding the next available id
+ * @param type entity type for which to find the next available id
+ * @param pendingUpdates pending updates to the domain state that should be considered when finding the next available id
+ *
+ * @deprecated Use `getIdSequence` instead
+ */
+export declare const nextDomainEntityId: <ENTITIES extends DomainEntity<string>, TYPE extends ENTITIES['type']>(domainState: DomainState<ENTITIES>, type: TYPE, pendingUpdates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>) => DomainEntityId<TYPE>;
+export type IdSequence<ENTITIES extends DomainEntity<string>> = {
+    /**
+     * Returns the next available entity ID for the given type.
+     * This automatically increments the sequence number for the given type, so that the next call will return a new ID.
+     *
+     * @param type the entity type
+     * @returns a new domain entity ID for the given type
+     */
+    nextId: <TYPE extends ENTITIES['type']>(type: TYPE) => DomainEntityId<TYPE>;
+};
+/**
+ * Returns an object that manages ID sequences for each entity type.
+ *
+ * The `pendingUpdates` is used to skip over ids that are already reserved by pending updates.
+ * It is intentionally mandatory, in order for people not to miss it, but if you really don't have any pending updates,
+ * just pass an empty array.
+ *
+ * @param entities current domain entities in the state used for computing initial sequences
+ * @param pendingUpdates pending updates to the domain state that should be considered when finding the next available id
+ */
+export declare function getIdSequence<ENTITIES extends DomainEntity<string>>(entities: readonly ENTITIES[], pendingUpdates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>): IdSequence<ENTITIES>;

package/dist/domain/domain-context/store-system/next-domain-entity-id.js

@@ -0,0 +1 @@
+import{_unsafeBuildDomainEntityId as e,parseDomainEntityId as t}from"../../core/model.js";export const nextDomainEntityId=(n,i,r)=>{let o=0;for(let e of n.entities){let n=t(e.id);n.type===i&&n.sequenceNumber>o&&(o=n.sequenceNumber)}for(let e of r){let n;if("createDomainEntity"===e.kind&&e.entity.type===i?n=e.entity.id:"replaceDomainEntity"===e.kind&&e.replacementEntity.type===i&&(n=e.replacementEntity.id),void 0!==n){let e=t(n);e.sequenceNumber>o&&(o=e.sequenceNumber)}}return e(i,o+1)};export function getIdSequence(n,i){let r=new Map;return n.forEach(e=>{let n=t(e.id),i=r.get(n.type)??0;r.set(e.type,Math.max(i,n.sequenceNumber))}),i.forEach(e=>{let n;if("createDomainEntity"===e.kind?n=e.entity.id:"replaceDomainEntity"===e.kind&&(n=e.replacementEntity.id),void 0!==n){let e=t(n),i=r.get(e.type)??0;r.set(e.type,Math.max(i,e.sequenceNumber))}}),{nextId:t=>{let n=(r.get(t)??0)+1;return r.set(t,n),e(t,n)}}}

package/dist/domain/domain-context/store-system/reconcile-projected-entities.d.ts

@@ -0,0 +1,25 @@
+import { type DomainEntityCreation, type EntityDeletion, type StateUpdate } from '../../components/updates.js';
+import type { DomainEntity } from '../../core/model.js';
+import { type ProjectedEntitiesComponentSnapshot } from '../../system-components/index.js';
+export interface ReconciliationUpdate<ENTITY extends DomainEntity<string>, PARENT extends DomainEntity<string>> {
+    readonly dataUpdate: DomainEntityCreation<ENTITY, PARENT> | EntityDeletion<ENTITY>;
+    readonly compoundKey: string;
+}
+/**
+ * Diffs blueprint declarations against existing projected entities in the given state.
+ * Returns only the creation/deletion updates needed to reconcile them.
+ * Returns an empty array when no changes are needed.
+ */
+export declare const reconcileProjectedEntities: <ENTITIES extends DomainEntity<string>>(entities: readonly ENTITIES[], componentSnapshots: readonly ProjectedEntitiesComponentSnapshot[], pendingUpdates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>) => ReadonlyArray<ReconciliationUpdate<ENTITIES, ENTITIES>>;
+/**
+ * Merges two rounds of reconciliation updates, keeping at most one update per compound key.
+ * Opposite operations on the same key (create + delete or delete + create) cancel each other out,
+ * producing no update for that key. Otherwise the newer update replaces the previous one.
+ *
+ * Called across iterative reconciliation rounds for nested projections (projected entities
+ * carrying their own `projectedEntities` components). Cancellation handles the case where
+ * a transient entity created in round N is no longer needed after round N+1's blueprint
+ * re-evaluation — this primarily occurs when blueprint expressions depend on projected
+ * entity state (a discouraged pattern that can lead to oscillation).
+ */
+export declare const mergeReconciliationsUpdates: <ENTITIES extends DomainEntity<string>, PARENT extends DomainEntity<string>>(previousUpdates: ReadonlyArray<ReconciliationUpdate<ENTITIES, PARENT>>, newUpdates: ReadonlyArray<ReconciliationUpdate<ENTITIES, PARENT>>) => ReadonlyArray<ReconciliationUpdate<ENTITIES, PARENT>>;

package/dist/domain/domain-context/store-system/reconcile-projected-entities.js

@@ -0,0 +1 @@
+import{systemUpdateFactory as e}from"../../components/updates.js";import{getIdSequence as t}from"../store-system/next-domain-entity-id.js";let n=e=>"string"==typeof e.parentId&&"string"==typeof e.instanceName&&"string"==typeof e.key,o=(e,t,n,o)=>`${e}|${t}|${n}|${o}`;export const reconcileProjectedEntities=(a,p,i)=>{let s=new Map;for(let e of p){let t=String(e.componentInstance.entityId),n=e.componentInstance.instanceName;for(let a of e.state.blueprints){let e=o(t,n,a.key,a.type);s.set(e,{type:a.type,defaults:a.defaults,parentId:t,instanceName:n,key:a.key})}}let d=new Map;for(let e of a)if(n(e)){let t=o(e.parentId,e.instanceName,e.key,e.type);d.set(t,e)}let r=[],l=t(a,i);for(let[t,n]of s)if(!d.has(t)){let o=l.nextId(n.type),a={...n.defaults,id:o,type:n.type,parentId:n.parentId,instanceName:n.instanceName,key:n.key};r.push({dataUpdate:e.DomainEntityCreation({entity:a,parentId:n.parentId,updateTag:"projectedEntities.reconcile"}),compoundKey:t})}for(let[t,n]of d)s.has(t)||r.push({dataUpdate:e.EntityDeletion({entityId:n.id,updateTag:"projectedEntities.reconcile"}),compoundKey:t});return r};export const mergeReconciliationsUpdates=(e,t)=>{let n=new Map;for(let t of e)n.set(t.compoundKey,t);for(let e of t){let t=n.get(e.compoundKey);t&&t.dataUpdate.kind!==e.dataUpdate.kind?n.delete(e.compoundKey):n.set(e.compoundKey,e)}return[...n.values()]};

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

@@ -0,0 +1,149 @@
+import { type ObservableWithLastValue } from '@salsita-ai/common/utils';
+import { type ComponentModification, type DataUpdate, type DomainEntityModification, type EphemeralRecordModification, type StateUpdate } from '../../components/updates.js';
+import { type SystemComponentTypeConstraint } from '../../core/component.js';
+import { type $DomainEntity, type DomainEntity } from '../../core/model.js';
+import type { DomainState } from '../../core/state.js';
+import type { DomainContextSelectors } from '../../domain-runtime/domain-context/index.js';
+import type { DomainServicesSelectors } from '../../domain-runtime/domain-services/index.js';
+import type { EnvironmentSelectors } from '../../domain-runtime/environment/index.js';
+import type { ViolationTypesOf$Entity } from '../../invariants/violation.js';
+import type { StateValidationResult } from '../../projections/validation-projections.js';
+import type { DomainContextSystems } from '../domain-context-systems.js';
+export type Unregister = () => void;
+export type StateSliceName = 
+/**
+ * Emits for every valid state, including both committed and staged.
+ * This should be used to render the 3D scene.
+ */
+'rendered'
+/**
+ * Emits for every state that was attempted to be committed, including invalid ones.
+ * The valid ones are included to hide eventual error messages.
+ */
+ | 'potentiallyInvalid'
+/**
+ * Emits for every valid committed state.
+ */
+ | 'committed';
+export interface ResetStateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
+    readonly kind: 'reset';
+    readonly state: DomainState<ENTITIES>;
+    readonly validity: StateValidationResult<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>;
+    readonly tag: unknown;
+    readonly transformationLog: TransformationLog | undefined;
+}
+export interface StateUpdateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
+    readonly kind: 'staged' | 'committed';
+    readonly previousState: DomainState<ENTITIES>;
+    readonly state: DomainState<ENTITIES>;
+    readonly updates: ReadonlyArray<DataUpdate<ENTITIES, ENTITIES>>;
+    readonly validity: StateValidationResult<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>;
+    readonly transformationLog: TransformationLog | undefined;
+}
+export type StateEmission<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = ResetStateEmission<ENTITIES, $MAP> | StateUpdateEmission<ENTITIES, $MAP>;
+export type TransformerPhase = 'no-event' | 'no-match' | 'no-resolve' | 'match' | 'no-apply' | 'apply';
+export interface TransformerLogEntry {
+    phase: TransformerPhase;
+    message: string;
+    data: unknown | undefined;
+}
+export interface TransformerLog {
+    name: string;
+    entries: readonly TransformerLogEntry[];
+    status: TransformerPhase;
+    updatesIn: ReadonlyArray<StateUpdate<DomainEntity<string>, DomainEntity<string>>>;
+    updatesOut: ReadonlyArray<StateUpdate<DomainEntity<string>, DomainEntity<string>>>;
+}
+export type TransformationLog = readonly TransformerLog[];
+export type TransformerLogFunction = (phase: TransformerPhase, message: string, data?: unknown) => void;
+export type UpdateTransformer<ENTITIES extends DomainEntity<string> = DomainEntity<string>> = (updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>, kind: StateEmissionKind, log: TransformerLogFunction | undefined) => ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>;
+export type IncrementalUpdateTransformer<ENTITIES extends DomainEntity<string> = DomainEntity<string>> = (unprocessedUpdates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>, kind: StateEmissionKind, log: TransformerLogFunction | undefined, processedUpdates?: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>) => ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>;
+export type TransformerRegistration<ENTITIES extends DomainEntity<string>> = {
+    name?: string;
+    priority: number;
+    transformer: UpdateTransformer<ENTITIES>;
+};
+export type Transformers<ENTITIES extends DomainEntity<string>> = ReadonlyArray<TransformerRegistration<ENTITIES>>;
+export type AnyCreateTransformersFactory = (ctx: DomainContextSystems<any, any, any, any, any, any, any>) => Transformers<any>;
+export type OnBeforeCommitHook<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = ((emission: StateUpdateEmission<ENTITIES, $MAP>, emit: () => void) => boolean) | ((emission: StateUpdateEmission<ENTITIES, $MAP>, emit: () => void) => void);
+export interface StoreSystemContext {
+    /**
+     * The store system's window into the runtime registry — mode, store runtime dependencies and
+     * the dev flag are read live through these selectors, never snapshotted, so runtime changes are
+     * observed without rebuilding the system.
+     */
+    readonly selectors: DomainContextSelectors;
+    readonly domainServicesSelectors: DomainServicesSelectors;
+    readonly environmentSelectors: EnvironmentSelectors;
+}
+export type StateEmissionKind = 'staged' | 'committed';
+/**
+ * How {@link StoreSystem.commitPrepared} ended: `committed` when the emission became the committed
+ * state; `conflict` when the committed state moved on since the emission was prepared, so it was
+ * not applied and must be prepared again; `held` when an `onBeforeCommit` hook vetoed it, typically
+ * to ask the user first, and may still commit later through the hook's deferred `emit`.
+ */
+export type CommitPreparedOutcome = 'committed' | 'conflict' | 'held';
+/** StoreSystem with its entity types erased — how the runtime selectors expose the instance. */
+export type AnyStoreSystem = StoreSystem<any, any>;
+export declare class StoreSystem<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> {
+    private readonly _context;
+    readonly stateSlices: Readonly<Record<StateSliceName, ObservableWithLastValue<StateEmission<ENTITIES, $MAP>>>>;
+    get isInitialized(): boolean;
+    private _onBeforeCommitHooks;
+    private readonly committed;
+    private readonly potentiallyInvalid;
+    private readonly rendered;
+    private stagedUpdates;
+    readonly transformToDataUpdates: (updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>) => (import("../../index.js").DomainEntityCreation<ENTITIES, ENTITIES> | DomainEntityModification<DomainEntity<string>> | import("../../index.js").DomainEntityReplacement<ENTITIES> | import("../../index.js").EntityDeletion<ENTITIES> | import("../../index.js").EphemeralRecordCreation<SystemComponentTypeConstraint> | import("../../index.js").EphemeralRecordDeletion<SystemComponentTypeConstraint> | EphemeralRecordModification<SystemComponentTypeConstraint>)[] | readonly DataUpdate<ENTITIES, ENTITIES>[];
+    private createInitialTransformPipe;
+    private transformPipe;
+    private readonly _cascadeDeletesTransformer;
+    private _cascadeDeletesTransformerMemo;
+    private readonly _refPruningTransformer;
+    private _refPruningTransformerMemo;
+    private readonly _deselectOnDeleteTransformer;
+    constructor(_context: StoreSystemContext);
+    /**
+     * The validation projections are exposed by the runtime selectors with their entity types erased. This
+     * is the single point where the result is narrowed back to the store's own generics.
+     */
+    private _validateState;
+    initialize: () => void;
+    registerTransformer(priority: number, transformer: UpdateTransformer<ENTITIES>, name: string): Unregister;
+    onBeforeCommit(fn: OnBeforeCommitHook<ENTITIES, $MAP>): Unregister;
+    componentModificationToDataUpdate: <COMPONENT_TYPE extends SystemComponentTypeConstraint>(update: ComponentModification<COMPONENT_TYPE>, state: DomainState<ENTITIES>) => DomainEntityModification | EphemeralRecordModification;
+    /**
+     * @deprecated Use {@link TransformerBuilder} instead to work with "potential new state"
+     */
+    getNewState: (updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>) => DomainState<ENTITIES>;
+    private applyTransformers;
+    private _updateProjectedEntities;
+    prepareStateEmission(updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>, kind: StateEmissionKind): StateUpdateEmission<ENTITIES, $MAP>;
+    private readonly emissionCache;
+    private readonly getEmissionCacheKey;
+    readonly prepareStateEmissionWithoutTransformation: (updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, previousState: DomainState<ENTITIES>, kind: StateEmissionKind) => StateUpdateEmission<ENTITIES, $MAP>;
+    stage(updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>, emit?: boolean): StateUpdateEmission<ENTITIES, $MAP>;
+    emit(emission: StateEmission<ENTITIES, $MAP>): void;
+    commit: () => void;
+    /**
+     * Commits an emission prepared outside the store, such as the one the GraphQL system prepares for
+     * a list of operations: one committed emission, one undo step, `onBeforeCommit` hooks
+     * run once. The emission must have been prepared from the current committed state; when the
+     * committed state has moved on since, nothing is applied and `conflict` tells the caller to
+     * prepare again. A deferred commit through a hook's `emit` is guarded the same way and dropped
+     * with a warning when the committed state changed in the meantime. Like `reset`, a commit discards
+     * staged updates, since they were prepared from the state it replaces.
+     */
+    commitPrepared: (emission: StateUpdateEmission<ENTITIES, $MAP>) => CommitPreparedOutcome;
+    rollback: () => void;
+    /**
+     * Hover and drag are pointer interactions that belong to the moment a state was committed, not to
+     * the state itself: a state restored by undo, redo, or a template load must never claim that an
+     * entity is still hovered or dragged.
+     */
+    private _resetInteractionState;
+    private _preserveViewportState;
+    reset(domainState: DomainState<ENTITIES>, tag?: unknown): void;
+    stageAndCommit(updates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>): void;
+}

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

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

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

@@ -0,0 +1,25 @@
+import type { StateOfComponent, SystemComponentTypeConstraint, WritableStateOfComponent } from '../../core/component.js';
+import type { DomainEntity } from '../../core/model.js';
+import type { DomainState } from '../../core/state.js';
+import type { DomainContextSelectors } from '../../domain-runtime/domain-context/index.js';
+export declare const SystemStateInitialUpdateTag = "system.state.initial";
+export declare const SystemStateUpdateTag = "system.state";
+type CombinedComponentState<COMPONENT_TYPE extends SystemComponentTypeConstraint> = WritableStateOfComponent<COMPONENT_TYPE> & StateOfComponent<COMPONENT_TYPE>;
+type SetSystemState<COMPONENT_TYPE extends SystemComponentTypeConstraint> = CombinedComponentState<COMPONENT_TYPE> | ((state: CombinedComponentState<COMPONENT_TYPE>) => CombinedComponentState<COMPONENT_TYPE> | null);
+export interface SystemStateContext<ENTITIES extends DomainEntity<string>, COMPONENT_TYPE extends SystemComponentTypeConstraint> {
+    readonly selectors: DomainContextSelectors;
+    readonly componentType: COMPONENT_TYPE;
+    readonly getInitialState: (state: DomainState<ENTITIES>) => CombinedComponentState<COMPONENT_TYPE>;
+}
+/**
+ * Owns one singleton system component whose state participates in domain snapshots and updates.
+ */
+export declare class SystemState<ENTITIES extends DomainEntity<string>, COMPONENT_TYPE extends SystemComponentTypeConstraint> {
+    private readonly _context;
+    constructor(_context: SystemStateContext<ENTITIES, COMPONENT_TYPE>);
+    initialize: () => void;
+    getInitialUpdates: (state: DomainState<ENTITIES>) => import("../../index.js").EphemeralRecordCreation<COMPONENT_TYPE>[];
+    get: (state: DomainState<ENTITIES>) => CombinedComponentState<COMPONENT_TYPE>;
+    getUpdates: (set: SetSystemState<COMPONENT_TYPE>, state: DomainState<ENTITIES>) => import("../../index.js").ComponentModification<COMPONENT_TYPE>[];
+}
+export {};

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

@@ -0,0 +1 @@
+import{systemVirtualEntityId as t}from"../../components/system-virtual-entity.js";import{systemUpdateFactory as e}from"../../components/updates.js";export const SystemStateInitialUpdateTag="system.state.initial";export const SystemStateUpdateTag="system.state";export class SystemState{_context;constructor(t){this._context=t}initialize=()=>{let t=this._context.selectors.getStoreSystem(),e=t.stateSlices.committed.value.state;t.stageAndCommit(this.getInitialUpdates(e))};getInitialUpdates=n=>{let o=this._context.getInitialState(n);return[e.EphemeralRecordCreation({componentInstance:{entityId:t,componentType:this._context.componentType,instanceName:"singleton"},updateTag:"system.state.initial",initialState:o})]};get=e=>{let n=this._context.selectors.getComponentReader().readOneComponent({entityId:t,componentType:this._context.componentType,instanceName:"singleton"},e);return n?n.state:this._context.getInitialState(e)};getUpdates=(n,o)=>{let s=this.get(o),i="function"==typeof n?n(s):n;return i?[e.ComponentModification({componentInstance:{entityId:t,componentType:this._context.componentType,instanceName:"singleton"},updateTag:"system.state",writableState:i})]:[]}}