@salsita-ai/sdk 0.50.0-develop.b5468d6828 → 0.50.0-develop.b929a82a82

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -124,6 +124,7 @@ export declare const createDomainContextSelectors: (context: Context) => {
     getMigrate: () => import("../../index.js").MigrateFunction<import("../../index.js").DomainEntity<string>>;
     getActiveMode: () => DomainMode;
     getIsInitialized: () => boolean;
+    getIsViewMode: () => boolean;
     getComponentReaderIndexes: () => ComponentReaderIndexes;
     getStoreRuntimeDependencies: () => {
         componentReaderIndexes: ComponentReaderIndexes;

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

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";import{Domain as t,createInitialDomainState as n}from"../../core/index.js";import{ActionSystem as o,DimensionSystem as i,NavigationSystem as a,RecipeCookerSystem as s,StoreSystem as r,UndoSystem as c}from"../../domain-context/index.js";import{BlenderProjections as l,CollisionProjections as m,CompositionProjections as d,ConstraintProjections as g,PositionProjections as f,ProjectedEntitiesProjections as u,SnappingProjections as p,ValidationProjections as y}from"../../projections/index.js";import{SketchingProjections as w}from"../../sketching/sketching-projections.js";import{requireAccessService as h}from"../access/index.js";import{prepareActionImplementations as S,prepareDomainExpressions as x}from"../spec/index.js";import{ComponentReader as C}from"./component-reader.js";import{DomainContext as D}from"./domain-context.js";let j=e.withTypes(),I=[],v={},P={role:"admin",data:v},M=e=>{if(null!==e)return e;throw Error("Cannot read the session role and data because the domain session context is not set. The session context is written into the domain runtime by the session lifecycle after authentication. Move this read into the loaded session lifecycle.")};export const createDomainContextSelectors=e=>{let{applicationType:A,getState:R,actions:E,specSelectors:T,accessSelectors:b,webComponentSelectors:$,domainDataSelectors:k,sessionContextSelectors:N,domainServicesSelectors:z,environmentSelectors:L,getExtensionSystems:V}=e,B="configurator"===A?T.selectConfiguratorSpec:T.selectAdminSpec,F="configurator"===A?b.selectConfiguratorRawAccessService:b.selectAdminRawAccessService,W=j.leaf(e=>e.domainContext[A]),_=j([W],e=>e.initializationContext),q=j([_],e=>{if(null===e)throw Error(`Domain lifecycle context is not available for ${A}! Read it from an active domain lifecycle.`);return e}),O=j([W],e=>e.executionMode),U=j([W],e=>e.isInitialized),G=j([B],e=>e.factory),H=j([B],e=>e.expressions),J=j([B],e=>e.actions),K=j([B],e=>e.actionImplementations),Q=j([J,K],S),X=j([B],e=>e.$entityReflections),Y=j([H,X],(e,t)=>x({expressions:e,$entityReflections:t})),Z=j([B],e=>e.modelVersion),ee=j([B],e=>e.aliasMap),et=j([B],e=>e.allowedRootEntityTypes),en=j([B],e=>e.entityReflections),eo=j([B],e=>e.migrate),ei=j([O,$.selectReadonly,F],(e,t,n)=>"finalize"===e?"finalize":h(A,n).accessInfo.viewMode||t?"read":"owner"),ea=j([F],e=>e?.configurationId??null),es="configurator"===A?N.selectSessionContext:j([],()=>P),er=j([es],e=>e?.role??null),ec=j([es],e=>e?.data??null),el=j([j.leaf(e=>e.loadedData)],e=>"configurator"===A?e.configuratorLoadedData:e.adminLoadedData),em=j([el],e=>e?.schemaIdentity??null),ed=j([el,G],(e,t)=>{if(null===e)return"coherent";let n=e.schemaIdentity;return void 0===n?"missing-stamp":n===t?"coherent":"schema-mismatch"}),eg=j([ea,er,ec,em,ed,F],(e,t,n,o,i,a)=>null===e||null===a||null===t||null===n||null===o||"coherent"!==i?null:{access:a.accessInfo.access,configurationId:e,role:t,schemaIdentity:o,sessionData:n}),ef=j([F,$.selectReadonly],(e,t)=>e?.accessInfo.viewMode===!0||t),eu=j([eg,_,U,ef],(e,t,n,o)=>{let i=null!==e&&null!==t&&n&&t.access===e.access&&t.configurationId===e.configurationId&&t.role===e.role&&t.schemaIdentity===e.schemaIdentity&&t.sessionData===e.sessionData;return{identity:e,isCurrent:i,isViewMode:o}}),ep=j([B],e=>e.componentOptics),ey=j([ep],e=>(e=>{let t=new Map,n=new Map,o=new Map,i=new Map;for(let n of e)for(let e of n.entityTypes){let o=t.get(e);o||(o=new Map,t.set(e,o));let a=o.get(n.componentType);if(a||(a=new Map,o.set(n.componentType,a)),a.has(n.instanceName))throw Error(`Component instance ${n.instanceName} already exists for type ${n.componentType.name} in entity ${e}. This is likely a bug in the component definition! InstanceNames must be unique within an entity and component.`);if(a.set(n.instanceName,n),"dynamic"===n.kind){let t=i.get(e);t||(t=new Map,i.set(e,t));let o=t.get(n.componentType)??[],a=o.find(e=>{var t;return t=n.instanceName,e.startsWith(`${t}_`)||t.startsWith(`${e}_`)});if(a)throw Error(`Cannot register dynamic component instance ${n.instanceName} for component ${n.componentType.name} on entity ${e} because it overlaps with dynamic instance ${a}. Rename one dynamic instance so compound names cannot be ambiguous.`);t.set(n.componentType,[...o,n.instanceName])}}for(let[e,i]of t.entries()){n.set(e,new Set(i.keys()));let t=new Map;for(let[n,a]of(o.set(e,t),i.entries()))t.set(n,new Set(a.keys()))}return{opticMap:t,allComponentTypes:n,allComponentInstanceNames:o,dynamicInstanceNames:i}})(e)),ew=j([ey,Y,et],(e,t,n)=>({componentReaderIndexes:e,domainExpressions:t,allowedRootEntityTypes:n})),eh=j([B],e=>e.navigationStates),eS=j([B],e=>e.viewStates),ex="configurator"===A?j([T.selectConfiguratorSpec],e=>e.toolStates):j([],()=>I),eC="configurator"===A?j([T.selectConfiguratorSpec],e=>e.exportStates):j([],()=>I),eD="configurator"===A?j([T.selectConfiguratorSpec],e=>e.createTransformers):j([],()=>void 0),ej=j([el],e=>{if(null===e)throw Error(`Loaded data is not available for ${A}! Loaded data is written after the configuration fetch succeeds and before the domain context initialization starts.`);return e}),eI=j([ej,G],(e,t)=>n(t.validateAndMigrateState(e.initialEntities,e.modelVersion),e.rootEntityType)),ev="configurator"===A?k.selectConfiguratorFrontendData:k.selectAdminFrontendData,eP="configurator"===A?k.selectConfiguratorBackendData:k.selectAdminBackendData,eM="configurator"===A?k.selectConfiguratorPublishedData:k.selectAdminPublishedData,eA="configurator"===A?j([N.selectSessionContext],e=>M(e).role):j([],()=>"admin"),eR="configurator"===A?j([N.selectSessionContext],e=>M(e).data):j([],()=>v),eE=j([ea,ei,eA,eR,ej,F],(e,t,n,o,i,a)=>({access:a?.accessInfo.access??null,configurationId:e,mode:t,role:n,schemaIdentity:i.schemaIdentity,sessionData:o})),eT=j([q],e=>e.mode),eb=j([q],e=>{let t=e.configurationId;if(null===t)throw Error(`Configuration id is not available for ${A}! Read it from an active interactive domain lifecycle.`);return t}),e$=j([q],e=>e.role),ek=j([q],e=>e.sessionData),eN=j([eT,e$,ek,ev,eP,eM,eo],(e,t,n,o,i,a,s)=>({mode:e,role:t,sessionData:n,frontendData:o,backendData:i,publishedData:a,migrate:s,domain:eL,componentReader:eV,positionProjections:eq,sketchingProjections:e_,collisionProjections:eO,constraintProjections:eG,snappingProjections:eU,projectedEntitiesProjections:eH})),ez={selectApplicationSpec:B,selectRawAccessService:F,selectDomainContextState:W,selectInitializationContext:_,selectActiveInitializationContext:q,selectExecutionMode:O,selectIsInitialized:U,selectFactory:G,selectSpecExpressions:H,select$SpecEntityReflections:X,selectDomainExpressions:Y,selectModelVersion:Z,selectAliasMap:ee,selectAllowedRootEntityTypes:et,selectEntityReflections:en,selectMigrate:eo,selectLatestMode:ei,selectLatestConfigurationId:ea,selectLatestSessionContext:es,selectLatestRoleOrNull:er,selectLatestSessionDataOrNull:ec,selectLatestSchemaIdentity:em,selectSchemaCoherence:ed,selectInitializationIdentity:eg,selectIsViewMode:ef,selectInitializationState:eu,selectComponentOptics:ep,selectComponentReaderIndexes:ey,selectStoreRuntimeDependencies:ew,selectNavigationStates:eh,selectViewStates:eS,selectToolStates:ex,selectExportStates:eC,selectCreateTransformers:eD,selectLatestLoadedData:el,selectLoadedData:ej,selectInitialDomainState:eI,selectFrontendData:ev,selectBackendData:eP,selectPublishedData:eM,selectLatestRole:eA,selectLatestSessionData:eR,selectNextInitializationContext:eE,selectActiveMode:eT,selectActiveConfigurationId:eb,selectActiveRole:e$,selectActiveSessionData:ek,selectExpressionContext:eN,getInitializationContext:()=>_(R()),getInitializationState:()=>eu(R()),getNextInitializationContext:()=>eE(R()),getLatestLoadedData:()=>el(R()),getSchemaCoherence:()=>ed(R()),getActiveConfigurationId:()=>eb(R()),getFactory:()=>G(R()),getDomainExpressions:()=>Y(R()),getActionDefinitions:()=>J(R()),getActionImplementations:()=>Q(R()),getModelVersion:()=>Z(R()),getAliasMap:()=>ee(R()),getAllowedRootEntityTypes:()=>et(R()),getEntityReflections:()=>en(R()),getMigrate:()=>eo(R()),getActiveMode:()=>eT(R()),getIsInitialized:()=>U(R()),getComponentReaderIndexes:()=>ey(R()),getStoreRuntimeDependencies:()=>ew(R()),getNavigationStates:()=>eh(R()),getViewStates:()=>eS(R()),getToolStates:()=>ex(R()),getExportStates:()=>eC(R()),getCreateTransformers:()=>eD(R()),getLoadedData:()=>ej(R()),getInitialDomainState:()=>eI(R()),getFrontendData:()=>ev(R()),getBackendData:()=>eP(R()),getPublishedData:()=>eM(R()),getActiveRole:()=>e$(R()),getActiveSessionData:()=>ek(R()),getDomain:()=>eL,getComponentReader:()=>eV,getCompositionProjections:()=>eB,getDimensionSystem:()=>eF,getValidationProjections:()=>eW,getSketchingProjections:()=>e_,getPositionProjections:()=>eq,getCollisionProjections:()=>eO,getSnappingProjections:()=>eU,getConstraintProjections:()=>eG,getProjectedEntitiesProjections:()=>eH,getStoreSystem:()=>eJ,getNavigationSystem:()=>eK,getUndoSystem:()=>eQ,getRecipeCookerSystem:()=>eX,getActionSystem:()=>eY,getBlenderProjections:()=>eZ,getExpressionContext:()=>eN(R()),getDomainSystems:function(){return e0},getDomainContext:function(){return e1}},eL=new t({selectors:ez}),eV=new C({selectors:ez}),eB=new d({selectors:ez}),eF=new i({selectors:ez}),eW=new y({selectors:ez}),e_=new w({selectors:ez}),eq=new f({selectors:ez}),eO=new m({selectors:ez}),eU=new p({selectors:ez}),eG=new g({selectors:ez}),eH=new u({selectors:ez}),eJ=new r({selectors:ez,domainServicesSelectors:z,environmentSelectors:L}),eK=new a({selectors:ez,domainServicesSelectors:z}),eQ=new c({selectors:ez}),eX=new s({selectors:ez}),eY=new o({selectors:ez}),eZ=new l({selectors:ez,domainServicesSelectors:z}),e0={domainContextSelectors:ez,domain:eL,componentReader:eV,compositionProjections:eB,blenderProjections:eZ,validationProjections:eW,storeSystem:eJ,navigationSystem:eK,dimensionSystem:eF,undoSystem:eQ,recipeCooker:eX,actionSystem:eY,sketchingProjections:e_,collisionProjections:eO,positionProjections:eq,snappingProjections:eU,projectedEntitiesProjections:eH,constraintProjections:eG},e1=new D({selectors:ez,actions:E,getExtensionSystems:V});return ez};
+import{createSelector as e}from"@salsita-ai/common/utils";import{Domain as t,createInitialDomainState as n}from"../../core/index.js";import{ActionSystem as o,DimensionSystem as i,NavigationSystem as a,RecipeCookerSystem as s,StoreSystem as r,UndoSystem as c}from"../../domain-context/index.js";import{BlenderProjections as l,CollisionProjections as d,CompositionProjections as m,ConstraintProjections as g,PositionProjections as f,ProjectedEntitiesProjections as u,SnappingProjections as p,ValidationProjections as y}from"../../projections/index.js";import{SketchingProjections as w}from"../../sketching/sketching-projections.js";import{requireAccessService as h}from"../access/index.js";import{prepareActionImplementations as S,prepareDomainExpressions as x}from"../spec/index.js";import{ComponentReader as C}from"./component-reader.js";import{DomainContext as D}from"./domain-context.js";let j=e.withTypes(),I=[],v={},P={role:"admin",data:v},M=e=>{if(null!==e)return e;throw Error("Cannot read the session role and data because the domain session context is not set. The session context is written into the domain runtime by the session lifecycle after authentication. Move this read into the loaded session lifecycle.")};export const createDomainContextSelectors=e=>{let{applicationType:A,getState:R,actions:E,specSelectors:T,accessSelectors:b,webComponentSelectors:$,domainDataSelectors:k,sessionContextSelectors:N,domainServicesSelectors:z,environmentSelectors:L,getExtensionSystems:V}=e,B="configurator"===A?T.selectConfiguratorSpec:T.selectAdminSpec,F="configurator"===A?b.selectConfiguratorRawAccessService:b.selectAdminRawAccessService,W=j.leaf(e=>e.domainContext[A]),_=j([W],e=>e.initializationContext),q=j([_],e=>{if(null===e)throw Error(`Domain lifecycle context is not available for ${A}! Read it from an active domain lifecycle.`);return e}),O=j([W],e=>e.executionMode),U=j([W],e=>e.isInitialized),G=j([B],e=>e.factory),H=j([B],e=>e.expressions),J=j([B],e=>e.actions),K=j([B],e=>e.actionImplementations),Q=j([J,K],S),X=j([B],e=>e.$entityReflections),Y=j([H,X],(e,t)=>x({expressions:e,$entityReflections:t})),Z=j([B],e=>e.modelVersion),ee=j([B],e=>e.aliasMap),et=j([B],e=>e.allowedRootEntityTypes),en=j([B],e=>e.entityReflections),eo=j([B],e=>e.migrate),ei=j([O,$.selectReadonly,F],(e,t,n)=>"finalize"===e?"finalize":h(A,n).accessInfo.viewMode||t?"read":"owner"),ea=j([F],e=>e?.configurationId??null),es="configurator"===A?N.selectSessionContext:j([],()=>P),er=j([es],e=>e?.role??null),ec=j([es],e=>e?.data??null),el=j([j.leaf(e=>e.loadedData)],e=>"configurator"===A?e.configuratorLoadedData:e.adminLoadedData),ed=j([el],e=>e?.schemaIdentity??null),em=j([el,G],(e,t)=>{if(null===e)return"coherent";let n=e.schemaIdentity;return void 0===n?"missing-stamp":n===t?"coherent":"schema-mismatch"}),eg=j([ea,er,ec,ed,em,F],(e,t,n,o,i,a)=>null===e||null===a||null===t||null===n||null===o||"coherent"!==i?null:{access:a.accessInfo.access,configurationId:e,role:t,schemaIdentity:o,sessionData:n}),ef=j([F,$.selectReadonly],(e,t)=>e?.accessInfo.viewMode===!0||t),eu=j([eg,_,U,ef],(e,t,n,o)=>{let i=null!==e&&null!==t&&n&&t.access===e.access&&t.configurationId===e.configurationId&&t.role===e.role&&t.schemaIdentity===e.schemaIdentity&&t.sessionData===e.sessionData;return{identity:e,isCurrent:i,isViewMode:o}}),ep=j([B],e=>e.componentOptics),ey=j([ep],e=>(e=>{let t=new Map,n=new Map,o=new Map,i=new Map;for(let n of e)for(let e of n.entityTypes){let o=t.get(e);o||(o=new Map,t.set(e,o));let a=o.get(n.componentType);if(a||(a=new Map,o.set(n.componentType,a)),a.has(n.instanceName))throw Error(`Component instance ${n.instanceName} already exists for type ${n.componentType.name} in entity ${e}. This is likely a bug in the component definition! InstanceNames must be unique within an entity and component.`);if(a.set(n.instanceName,n),"dynamic"===n.kind){let t=i.get(e);t||(t=new Map,i.set(e,t));let o=t.get(n.componentType)??[],a=o.find(e=>{var t;return t=n.instanceName,e.startsWith(`${t}_`)||t.startsWith(`${e}_`)});if(a)throw Error(`Cannot register dynamic component instance ${n.instanceName} for component ${n.componentType.name} on entity ${e} because it overlaps with dynamic instance ${a}. Rename one dynamic instance so compound names cannot be ambiguous.`);t.set(n.componentType,[...o,n.instanceName])}}for(let[e,i]of t.entries()){n.set(e,new Set(i.keys()));let t=new Map;for(let[n,a]of(o.set(e,t),i.entries()))t.set(n,new Set(a.keys()))}return{opticMap:t,allComponentTypes:n,allComponentInstanceNames:o,dynamicInstanceNames:i}})(e)),ew=j([ey,Y,et],(e,t,n)=>({componentReaderIndexes:e,domainExpressions:t,allowedRootEntityTypes:n})),eh=j([B],e=>e.navigationStates),eS=j([B],e=>e.viewStates),ex="configurator"===A?j([T.selectConfiguratorSpec],e=>e.toolStates):j([],()=>I),eC="configurator"===A?j([T.selectConfiguratorSpec],e=>e.exportStates):j([],()=>I),eD="configurator"===A?j([T.selectConfiguratorSpec],e=>e.createTransformers):j([],()=>void 0),ej=j([el],e=>{if(null===e)throw Error(`Loaded data is not available for ${A}! Loaded data is written after the configuration fetch succeeds and before the domain context initialization starts.`);return e}),eI=j([ej,G],(e,t)=>n(t.validateAndMigrateState(e.initialEntities,e.modelVersion),e.rootEntityType)),ev="configurator"===A?k.selectConfiguratorFrontendData:k.selectAdminFrontendData,eP="configurator"===A?k.selectConfiguratorBackendData:k.selectAdminBackendData,eM="configurator"===A?k.selectConfiguratorPublishedData:k.selectAdminPublishedData,eA="configurator"===A?j([N.selectSessionContext],e=>M(e).role):j([],()=>"admin"),eR="configurator"===A?j([N.selectSessionContext],e=>M(e).data):j([],()=>v),eE=j([ea,ei,eA,eR,ej,F],(e,t,n,o,i,a)=>({access:a?.accessInfo.access??null,configurationId:e,mode:t,role:n,schemaIdentity:i.schemaIdentity,sessionData:o})),eT=j([q],e=>e.mode),eb=j([q],e=>{let t=e.configurationId;if(null===t)throw Error(`Configuration id is not available for ${A}! Read it from an active interactive domain lifecycle.`);return t}),e$=j([q],e=>e.role),ek=j([q],e=>e.sessionData),eN=j([eT,e$,ek,ev,eP,eM,eo],(e,t,n,o,i,a,s)=>({mode:e,role:t,sessionData:n,frontendData:o,backendData:i,publishedData:a,migrate:s,domain:eL,componentReader:eV,positionProjections:eq,sketchingProjections:e_,collisionProjections:eO,constraintProjections:eG,snappingProjections:eU,projectedEntitiesProjections:eH})),ez={selectApplicationSpec:B,selectRawAccessService:F,selectDomainContextState:W,selectInitializationContext:_,selectActiveInitializationContext:q,selectExecutionMode:O,selectIsInitialized:U,selectFactory:G,selectSpecExpressions:H,select$SpecEntityReflections:X,selectDomainExpressions:Y,selectModelVersion:Z,selectAliasMap:ee,selectAllowedRootEntityTypes:et,selectEntityReflections:en,selectMigrate:eo,selectLatestMode:ei,selectLatestConfigurationId:ea,selectLatestSessionContext:es,selectLatestRoleOrNull:er,selectLatestSessionDataOrNull:ec,selectLatestSchemaIdentity:ed,selectSchemaCoherence:em,selectInitializationIdentity:eg,selectIsViewMode:ef,selectInitializationState:eu,selectComponentOptics:ep,selectComponentReaderIndexes:ey,selectStoreRuntimeDependencies:ew,selectNavigationStates:eh,selectViewStates:eS,selectToolStates:ex,selectExportStates:eC,selectCreateTransformers:eD,selectLatestLoadedData:el,selectLoadedData:ej,selectInitialDomainState:eI,selectFrontendData:ev,selectBackendData:eP,selectPublishedData:eM,selectLatestRole:eA,selectLatestSessionData:eR,selectNextInitializationContext:eE,selectActiveMode:eT,selectActiveConfigurationId:eb,selectActiveRole:e$,selectActiveSessionData:ek,selectExpressionContext:eN,getInitializationContext:()=>_(R()),getInitializationState:()=>eu(R()),getNextInitializationContext:()=>eE(R()),getLatestLoadedData:()=>el(R()),getSchemaCoherence:()=>em(R()),getActiveConfigurationId:()=>eb(R()),getFactory:()=>G(R()),getDomainExpressions:()=>Y(R()),getActionDefinitions:()=>J(R()),getActionImplementations:()=>Q(R()),getModelVersion:()=>Z(R()),getAliasMap:()=>ee(R()),getAllowedRootEntityTypes:()=>et(R()),getEntityReflections:()=>en(R()),getMigrate:()=>eo(R()),getActiveMode:()=>eT(R()),getIsInitialized:()=>U(R()),getIsViewMode:()=>ef(R()),getComponentReaderIndexes:()=>ey(R()),getStoreRuntimeDependencies:()=>ew(R()),getNavigationStates:()=>eh(R()),getViewStates:()=>eS(R()),getToolStates:()=>ex(R()),getExportStates:()=>eC(R()),getCreateTransformers:()=>eD(R()),getLoadedData:()=>ej(R()),getInitialDomainState:()=>eI(R()),getFrontendData:()=>ev(R()),getBackendData:()=>eP(R()),getPublishedData:()=>eM(R()),getActiveRole:()=>e$(R()),getActiveSessionData:()=>ek(R()),getDomain:()=>eL,getComponentReader:()=>eV,getCompositionProjections:()=>eB,getDimensionSystem:()=>eF,getValidationProjections:()=>eW,getSketchingProjections:()=>e_,getPositionProjections:()=>eq,getCollisionProjections:()=>eO,getSnappingProjections:()=>eU,getConstraintProjections:()=>eG,getProjectedEntitiesProjections:()=>eH,getStoreSystem:()=>eJ,getNavigationSystem:()=>eK,getUndoSystem:()=>eQ,getRecipeCookerSystem:()=>eX,getActionSystem:()=>eY,getBlenderProjections:()=>eZ,getExpressionContext:()=>eN(R()),getDomainSystems:function(){return e0},getDomainContext:function(){return e1}},eL=new t({selectors:ez}),eV=new C({selectors:ez}),eB=new m({selectors:ez}),eF=new i({selectors:ez}),eW=new y({selectors:ez}),e_=new w({selectors:ez}),eq=new f({selectors:ez}),eO=new d({selectors:ez}),eU=new p({selectors:ez}),eG=new g({selectors:ez}),eH=new u({selectors:ez}),eJ=new r({selectors:ez,domainServicesSelectors:z,environmentSelectors:L}),eK=new a({selectors:ez,domainServicesSelectors:z}),eQ=new c({selectors:ez}),eX=new s({selectors:ez}),eY=new o({selectors:ez}),eZ=new l({selectors:ez,domainServicesSelectors:z}),e0={domainContextSelectors:ez,domain:eL,componentReader:eV,compositionProjections:eB,blenderProjections:eZ,validationProjections:eW,storeSystem:eJ,navigationSystem:eK,dimensionSystem:eF,undoSystem:eQ,recipeCooker:eX,actionSystem:eY,sketchingProjections:e_,collisionProjections:eO,positionProjections:eq,snappingProjections:eU,projectedEntitiesProjections:eH,constraintProjections:eG},e1=new D({selectors:ez,actions:E,getExtensionSystems:V});return ez};

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

@@ -1,6 +1,7 @@
 import { BehaviorSubject } from 'rxjs';
 import type { AnyApplicationConfig } from '../application/index.js';
 import { type ApplicationAccessInfo } from './access/index.js';
+import { type Application } from './application.js';
 import { type ApplicationDomainContextState, type DomainApplicationType, type InitializableSystem } from './domain-context/index.js';
 import { type ApplicationDomainData } from './domain-data/index.js';
 import { type DomainRuntimeServices } from './domain-services/index.js';
@@ -21,17 +22,30 @@ export interface DomainRuntimeState {
     readonly webComponent: ApplicationWebComponentState;
     readonly domainContext: ApplicationDomainContextState;
 }
-interface Props<State extends DomainRuntimeState> {
+/**
+ * What a domain runtime starts from: the spec slice and the environment of an application, or the
+ * config of a project built with `ConfiguratorBuilder`, which is converted to them when the runtime
+ * initializes.
+ */
+type DomainRuntimeSource = {
+    readonly application: Pick<Application, 'spec' | 'environment'>;
+    readonly config?: undefined;
+} | {
     readonly config: AnyApplicationConfig;
+    readonly application?: undefined;
+};
+type DomainRuntimeProps = DomainRuntimeSource & {
     readonly services: DomainRuntimeServices;
-    readonly getSubject: () => BehaviorSubject<State>;
     /**
      * Systems a host layers onto a slot's domain initialization. Webhook and finalize hosts run the
      * domain alone and pass nothing; the application runtime contributes its domain-application
      * systems here.
      */
     readonly getExtensionSystems?: (applicationType: DomainApplicationType) => readonly InitializableSystem[];
-}
+};
+type Props<State extends DomainRuntimeState> = DomainRuntimeProps & {
+    readonly getSubject: () => BehaviorSubject<State>;
+};
 export declare function createDomainRuntimeSlices<State extends DomainRuntimeState>(props: Props<State>): {
     initialize: () => {
         spec: ApplicationSpec;
@@ -74,18 +88,19 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
             selectPrefetchTextureUrls: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly string[]>;
             selectTextLanguages: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly string[]>;
             selectHandlerHashes: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, Record<string, string>>;
-            selectHandlers: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("./index.js").HandlerRegistration<any, any>[]>;
+            selectHandlers: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("../index.js").HandlerRegistration<any, any>[]>;
             selectHandlerSlots: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, {
-                handlers: Record<string, () => import("./index.js").PhoenixHandlerDefinition>;
-                systemHandlers: Record<string, () => import("./index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
-                systemAsyncHandlers: Record<string, () => import("./index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
+                handlers: Record<string, () => import("../index.js").PhoenixHandlerDefinition>;
+                systemHandlers: Record<string, () => import("../index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
+                systemAsyncHandlers: Record<string, () => import("../index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
                 hashes: Record<string, string>;
             }>;
             selectElementHashes: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, Record<string, string>>;
-            selectElements: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("./index.js").ElementRegistration[]>;
+            selectElements: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("../index.js").ElementRegistration[]>;
             selectElementSlots: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, {
-                entityElements: Record<string, (props: import("./index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
+                entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             }>;
             selectDataConfig: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, import("../index.js").DataSpec | null>;
@@ -117,18 +132,19 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
             getPrefetchTextureUrls: () => readonly string[];
             getTextLanguages: () => readonly string[];
             getHandlerHashes: () => Record<string, string>;
-            getHandlers: () => readonly import("./index.js").HandlerRegistration<any, any>[];
+            getHandlers: () => readonly import("../index.js").HandlerRegistration<any, any>[];
             getHandlerSlots: () => {
-                handlers: Record<string, () => import("./index.js").PhoenixHandlerDefinition>;
-                systemHandlers: Record<string, () => import("./index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
-                systemAsyncHandlers: Record<string, () => import("./index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
+                handlers: Record<string, () => import("../index.js").PhoenixHandlerDefinition>;
+                systemHandlers: Record<string, () => import("../index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
+                systemAsyncHandlers: Record<string, () => import("../index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
                 hashes: Record<string, string>;
             };
             getElementHashes: () => Record<string, string>;
-            getElements: () => readonly import("./index.js").ElementRegistration[];
+            getElements: () => readonly import("../index.js").ElementRegistration[];
             getElementSlots: () => {
-                entityElements: Record<string, (props: import("./index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
+                entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             };
             getDataConfig: () => import("../index.js").DataSpec | null;
@@ -342,6 +358,8 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
         webComponent: {
             selectReadonly: import("@salsita-ai/common/utils").Selector<import("./index.js").WebComponentSelectorState, boolean>;
             getReadonly: () => boolean;
+            selectLocale: import("@salsita-ai/common/utils").Selector<import("./index.js").WebComponentSelectorState, string>;
+            getLocale: () => string;
             getWebcomponentGeneration: () => number;
         };
         domainContext: {
@@ -415,6 +433,7 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
@@ -524,6 +543,7 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
@@ -628,9 +648,16 @@ export declare function createDomainRuntimeSlices<State extends DomainRuntimeSta
             };
         };
     };
+    /**
+     * Writers only the runtime that owns the host-property mirror may call, kept off the public
+     * `actions`: the host sets `locale` on the element, and the mirror copies it here.
+     */
+    hostMirrorActions: {
+        setLocale: (locale: string) => void;
+    };
 };
 export type DomainRuntimeSlices = ReturnType<typeof createDomainRuntimeSlices>;
-export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>, 'getSubject'>) => {
+export declare const createDomainRuntime: (props: DomainRuntimeProps) => {
     initialize: () => {
         spec: ApplicationSpec;
         overrides: ApplicationOverrides;
@@ -672,18 +699,19 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
             selectPrefetchTextureUrls: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly string[]>;
             selectTextLanguages: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly string[]>;
             selectHandlerHashes: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, Record<string, string>>;
-            selectHandlers: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("./index.js").HandlerRegistration<any, any>[]>;
+            selectHandlers: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("../index.js").HandlerRegistration<any, any>[]>;
             selectHandlerSlots: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, {
-                handlers: Record<string, () => import("./index.js").PhoenixHandlerDefinition>;
-                systemHandlers: Record<string, () => import("./index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
-                systemAsyncHandlers: Record<string, () => import("./index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
+                handlers: Record<string, () => import("../index.js").PhoenixHandlerDefinition>;
+                systemHandlers: Record<string, () => import("../index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
+                systemAsyncHandlers: Record<string, () => import("../index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
                 hashes: Record<string, string>;
             }>;
             selectElementHashes: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, Record<string, string>>;
-            selectElements: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("./index.js").ElementRegistration[]>;
+            selectElements: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, readonly import("../index.js").ElementRegistration[]>;
             selectElementSlots: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, {
-                entityElements: Record<string, (props: import("./index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
+                entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             }>;
             selectDataConfig: import("@salsita-ai/common/utils").Selector<import("./index.js").SpecSelectorState, import("../index.js").DataSpec | null>;
@@ -715,18 +743,19 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
             getPrefetchTextureUrls: () => readonly string[];
             getTextLanguages: () => readonly string[];
             getHandlerHashes: () => Record<string, string>;
-            getHandlers: () => readonly import("./index.js").HandlerRegistration<any, any>[];
+            getHandlers: () => readonly import("../index.js").HandlerRegistration<any, any>[];
             getHandlerSlots: () => {
-                handlers: Record<string, () => import("./index.js").PhoenixHandlerDefinition>;
-                systemHandlers: Record<string, () => import("./index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
-                systemAsyncHandlers: Record<string, () => import("./index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
+                handlers: Record<string, () => import("../index.js").PhoenixHandlerDefinition>;
+                systemHandlers: Record<string, () => import("../index.js").SystemPhoenixHandlerDefinition<unknown, unknown>>;
+                systemAsyncHandlers: Record<string, () => import("../index.js").SystemPhoenixAsyncHandlerDefinition<unknown, unknown>>;
                 hashes: Record<string, string>;
             };
             getElementHashes: () => Record<string, string>;
-            getElements: () => readonly import("./index.js").ElementRegistration[];
+            getElements: () => readonly import("../index.js").ElementRegistration[];
             getElementSlots: () => {
-                entityElements: Record<string, (props: import("./index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
+                entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             };
             getDataConfig: () => import("../index.js").DataSpec | null;
@@ -940,6 +969,8 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
         webComponent: {
             selectReadonly: import("@salsita-ai/common/utils").Selector<import("./index.js").WebComponentSelectorState, boolean>;
             getReadonly: () => boolean;
+            selectLocale: import("@salsita-ai/common/utils").Selector<import("./index.js").WebComponentSelectorState, string>;
+            getLocale: () => string;
             getWebcomponentGeneration: () => number;
         };
         domainContext: {
@@ -1013,6 +1044,7 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
@@ -1122,6 +1154,7 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
                 getMigrate: () => import("../index.js").MigrateFunction<import("../index.js").DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("./index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("./index.js").ComponentReaderIndexes;
@@ -1226,6 +1259,13 @@ export declare const createDomainRuntime: (props: Omit<Props<DomainRuntimeState>
             };
         };
     };
+    /**
+     * Writers only the runtime that owns the host-property mirror may call, kept off the public
+     * `actions`: the host sets `locale` on the element, and the mirror copies it here.
+     */
+    hostMirrorActions: {
+        setLocale: (locale: string) => void;
+    };
     getState: () => DomainRuntimeState;
     subscribe: (callback: () => void) => () => void;
 };