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

package/dist/configurator/application-runtime/extensions/systems/graphql-system/graphql-system.js

@@ -0,0 +1 @@
+import{GraphQLError as e,buildSchema as t,defaultFieldResolver as i,getNamedType as o,graphql as a,validateSchema as n}from"graphql";import{assertExistence as r,createSelector as s,isMessageDescriptor as l,isMultilingualString as c}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as h,findAssistantMutation as d}from"#package/domain";import{createEntityMeta as m}from"./entity-meta.js";let p={errors:[new e('No assistant manifest in the application spec. The GraphQL schema is generated from the "assistant" section. Add an "assistant" section to a spec file to expose a schema.')]},u={errors:[new e("The configuration is not loaded yet, so there is no state to query. Run the query again once the configurator has finished loading.")]},f=new RegExp(h.pattern),y=e=>"object"==typeof e&&null!==e&&"type"in e&&"string"==typeof e.type&&"id"in e&&"string"==typeof e.id,g=(e,t)=>"object"==typeof e&&null!==e?Reflect.get(e,t):void 0,v=e=>e instanceof Error?e.message:String(e),S=e=>/[.!?]$/.test(e)?e:`${e}.`,_=e=>"object"==typeof e&&null!==e&&Object.getPrototypeOf(e)===Object.prototype,w=(e,t)=>{let i=_(e)?e._raw:void 0;if(y(i))return i;if(!Array.isArray(e)&&!_(e))return e;if(t.has(e))throw Error("The value contains itself. Return ids or copies of the values instead of objects that reference each other.");let o=new Set([...t,e]);return Array.isArray(e)?e.map(e=>w(e,o)):Object.fromEntries(Object.entries(e).map(([e,t])=>[e,w(t,o)]))},x=(e,t)=>Array.isArray(e)?e.map(e=>x(e,t)):"string"==typeof e||l(e)||c(e)?t(e):e,$=t=>new e(`The GraphQL schema generated from the "assistant" manifest is invalid: ${S(t)} Regenerate the application so the schema is rebuilt from the current spec.`),E=e=>(e.errors?.length??0)>0,b=t=>({errors:[new e(`Not run: operation ${t+1} failed, so the operations after it were skipped and no change of the list takes effect. Fix the failing operation and send the whole list again.`)]});export class GraphQLSystem{_context;_selectSchema=s([s.leaf(e=>e)],e=>{try{let i=t(e),o=n(i);return o.length>0?$(o.map(e=>e.message).join(" ")):i}catch(e){return $(v(e))}});_selectFieldResolver=s([s.leaf(e=>e)],t=>(a,n,r,s)=>{if(s.parentType===s.schema.getQueryType())return i(a,n,r,s);if(s.parentType===s.schema.getMutationType())return this._resolveMutation(s.fieldName,String(s.path.key),n,r);if(!y(a))return i(a,n,r,s);if("meta"===s.fieldName){let e;return m({entity:a,state:("object"==typeof(e=g(a,"_state"))&&null!==e&&"entities"in e&&"rootEntityId"in e?e:void 0)??r.state},{manifest:r.manifest,recipes:this._recipeContext(),prepareStateEmission:(e,t,i)=>this._context.domainContextSelectors.getStoreSystem().prepareStateEmission(e,t,i),find$Entity:(e,t)=>this._find$Entity(e,t)})}let{source:l,localized:c}=t[s.parentType.name]?.[s.fieldName]??{source:s.fieldName},h=((t,i)=>{try{return g(t,i)}catch(o){throw new e(`Expression "${i}" failed on ${y(t)?t.id:"an entity"}: ${S(v(o))} The expression threw while the query read it; fix the expression or the configuration state it reads.`,{originalError:o instanceof Error?o:void 0})}})(a,l);return c?x(h,this._context.domainServicesSelectors.getResolveLocalizable()):l.startsWith("$")&&"JSON"===o(s.returnType).name?((t,i,o)=>{try{return w(o,new Set)}catch(o){throw new e(`Expression "${i}" returned a value that is not plain serializable data on ${y(t)?t.id:"an entity"}: ${S(v(o))} A JSON field can only return data that serializes to JSON.`,{originalError:o instanceof Error?o:void 0})}})(a,l,h):h});constructor(e){this._context=e}_get$Entity=(e,t)=>this._context.domainContextSelectors.getDomain().get$Entity(e,t);_find$Entity=(e,t)=>this._context.domainContextSelectors.getDomain().getEntity(e,t)?this._get$Entity(e,t):null;_recipeContext=()=>({componentReader:this._context.domainContextSelectors.getComponentReader(),recipeCooker:this._context.domainContextSelectors.getRecipeCookerSystem(),resolveLocalizable:this._context.domainServicesSelectors.getResolveLocalizable()});_rootValue={root:(e,{state:t})=>this._get$Entity(t.rootEntityId,t),entities:({ids:t},{state:i})=>{if(null==t)return i.entities.map(e=>this._get$Entity(e.id,i));var o=i.rootEntityId;let a=t.filter(e=>!f.test(e));if(a.length>0)throw new e(`${a.map(e=>`"${e}"`).join(", ")} ${1===a.length?"is not an entity id":"are not entity ids"}. Entity ids have the form "<Type>-<number>", e.g. "${o}". Use ids as returned by the "id" field.`);return t.map(e=>f.test(e)?this._find$Entity(e,i):null)},selectedEntity:(e,{state:t})=>this._find$Entity(this._context.domainContextSelectors.getNavigationSystem().getActiveSelectionState(t),t),navigation:(e,{state:t})=>{let i=this._context.domainContextSelectors.getNavigationSystem();return{navigationState:i.getActiveNavigationState(t),viewState:i.getActiveViewState(t),toolState:i.getActiveToolState(t)}}};_resolveType=e=>y(e)?e.type:void 0;initialize=()=>{};_resolveMutation=(t,i,o,a)=>{if(void 0!==a.failedMutationField)throw new e(`Not run: the earlier field "${a.failedMutationField}" of this operation failed, so "${i}" was skipped and no change of the operation takes effect. Fix the failing field and send the operation again.`);try{return this._runMutation(t,o,a)}catch(e){throw a.failedMutationField=i,e}};_runMutation=(t,i,o)=>{let a=d(t,o.manifest);if(!a)throw new e(`The schema declares the mutation "${t}", but the configurator has no implementation for it. Regenerate the application so the schema matches the configurator.`);let n=o.state,r=a.implementation(i,n,{manifest:o.manifest,domain:this._context.domainContextSelectors.getDomain(),...this._recipeContext()});if(r.updates.length>0){let i=this._context.domainContextSelectors.getStoreSystem().prepareStateEmission(r.updates,n,"committed");if(!i.validity.valid)throw new e(`The changes of "${t}" were not applied, because the resulting configuration is invalid: ${(e=>{if("uncaught"===e.severity)return`validating it threw: ${S(v(e.error))}`;let t=[...new Set(e.entityViolations.filter(({violation:t})=>t.severity===e.severity).map(({entityId:e})=>e))];return`it has ${e.severity} violations on ${t.join(", ")}.`})(i.validity)} Change the request so the configuration stays valid.`);o.emissions.push(i),o.state=i.state}return r.readResult({previousState:n,state:o.state})};_setup=()=>{let t=this._context.specSelectors.getAssistant();if(!t)return{ready:!1,result:p};let i=this._selectSchema(t.sdl);return i instanceof e?{ready:!1,result:{errors:[i]}}:{ready:!0,assistant:t,schema:i,fieldResolver:this._selectFieldResolver(t.fields)}};prepare=async(e,t)=>{let i,o=this._setup();if(!o.ready)return t.map(()=>({result:o.result,emissions:[]}));let n={manifest:o.assistant,state:e,emissions:[],failedMutationField:void 0},r=[];for(let[e,s]of t.entries())if(void 0===i){let t=n.emissions.length;n.failedMutationField=void 0;let l=await a({schema:o.schema,source:s.document,rootValue:this._rootValue,contextValue:n,variableValues:s.variables,operationName:s.operationName,fieldResolver:o.fieldResolver,typeResolver:this._resolveType});r.push({result:l,emissions:n.emissions.slice(t)}),E(l)&&(i=e)}else r.push({result:b(i),emissions:[]});return r};_prepareAndCommit=async e=>{let t,i,o,a=this._context.domainContextSelectors.getStoreSystem(),n=await this.prepare(a.stateSlices.committed.value.state,e),s=n.map(({result:e})=>e),l=n.flatMap(e=>e.emissions);return s.some(E)||0===l.length?{results:s,outcome:"none"}:{results:s,outcome:a.commitPrepared((t=r(l[0]),i=r(l[l.length-1]),o=l.some(e=>void 0!==e.transformationLog),{kind:"committed",previousState:t.previousState,state:i.state,updates:l.flatMap(e=>e.updates),validity:i.validity,transformationLog:o?l.flatMap(e=>e.transformationLog??[]):void 0}))}};execute=async e=>{if(!this._context.domainContextSelectors.getStoreSystem().isInitialized)return{results:e.map(()=>u),committed:!1};let t=await this._prepareAndCommit(e),{results:i,outcome:o}="conflict"===t.outcome?await this._prepareAndCommit(e):t;return"committed"===o?{results:i,committed:!0}:"held"===o?{results:i,committed:!1,message:"The changes were not committed yet: the application held them, usually to ask the user for approval. They may still be applied once the user approves, and the next turn shows whether they were. Do not send the operations again."}:"conflict"===o?{results:i,committed:!1,message:"The changes were not committed, because the configuration changed while they were being applied. The results describe a state that was discarded. Query the current configuration and send the operations again if they still make sense."}:{results:i,committed:!1}}}

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/canvas-freeze-frame.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lays a snapshot of the live canvas over it and returns the function that removes it again.
+ *
+ * Exports resize the canvas's drawing buffer, and a resized WebGL canvas shows up blank until it is
+ * drawn again — even when nothing draws to it in between. The snapshot keeps the current view on
+ * screen meanwhile. Without `preserveDrawingBuffer` the canvas can only be read in the task that drew
+ * it, so `render` draws the current view first and the snapshot is taken right after.
+ */
+export declare const createCanvasFreezeFrame: (canvas: HTMLCanvasElement, render: () => void) => (() => void);

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/canvas-freeze-frame.js

@@ -0,0 +1 @@
+export const createCanvasFreezeFrame=(e,t)=>{let n=document.createElement("canvas");n.width=e.width,n.height=e.height;let i=n.getContext("2d");return null===i?()=>{}:(t(),i.drawImage(e,0,0),Object.assign(n.style,{position:"absolute",left:`${e.offsetLeft}px`,top:`${e.offsetTop}px`,width:`${e.clientWidth}px`,height:`${e.clientHeight}px`,pointerEvents:"none"}),e.after(n),()=>{n.remove()})};

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/export-image-capture.d.ts

@@ -0,0 +1,45 @@
+import { Pass } from 'postprocessing';
+import type { ColorSpace, IUniform, Scene, Texture, ToneMapping, WebGLRenderer } from 'three';
+import { Color, RawShaderMaterial, WebGLRenderTarget } from 'three';
+/** Uniforms of the export output material, typed so the capture pass can feed them directly. */
+interface ExportOutputUniforms {
+    readonly [uniform: string]: IUniform;
+    readonly tDiffuse: IUniform<Texture | null>;
+    readonly toneMappingExposure: IUniform<number>;
+}
+/**
+ * Creates the material that turns a linear, premultiplied export render into straight-alpha output
+ * pixels: the tone mapping and sRGB transfer the renderer would otherwise apply only when drawing to
+ * the canvas.
+ */
+export declare const createExportOutputMaterial: (toneMapping: ToneMapping, outputColorSpace: ColorSpace) => RawShaderMaterial & {
+    uniforms: ExportOutputUniforms;
+};
+/**
+ * Captures the export frame into its own 8-bit target at the export resolution. As the composer's
+ * last pass it takes `renderToScreen` away from the effect passes, so a composer render during an
+ * export never reaches the live canvas; outside a composer it is rendered directly on the scene
+ * target.
+ */
+export declare class ExportCapturePass extends Pass {
+    readonly renderTarget: WebGLRenderTarget;
+    private readonly _material;
+    constructor(width: number, height: number, toneMapping: ToneMapping, outputColorSpace: ColorSpace);
+    render(renderer: WebGLRenderer, inputBuffer: WebGLRenderTarget | null): void;
+}
+/**
+ * Resolves the CSS colour painted behind the exported pixels, or `null` to keep them transparent. A
+ * Color scene background wins, as it does on the canvas, then the export's own background colour;
+ * JPEG has no alpha, so it falls back to white.
+ */
+export declare const resolveExportBackground: (config: {
+    readonly sceneBackground: Scene['background'];
+    readonly backgroundColor: Color | undefined;
+    readonly fileFormat: 'PNG' | 'JPEG';
+    readonly outputColorSpace: ColorSpace;
+}) => string | null;
+/** Reorders WebGL's bottom-up pixel rows into the top-down order 2D canvases use. */
+export declare const flipPixelRows: (pixels: Uint8Array, width: number, height: number) => Uint8ClampedArray<ArrayBuffer>;
+/** Reads an 8-bit render target back and encodes it over the given background colour. */
+export declare const readTargetToBlob: (renderer: WebGLRenderer, target: WebGLRenderTarget, background: string | null, mimeType: 'image/png' | 'image/jpeg') => Promise<Blob>;
+export {};

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/export-image-capture.js

@@ -0,0 +1,50 @@
+import{Pass as e}from"postprocessing";import{ACESFilmicToneMapping as r,AgXToneMapping as t,CineonToneMapping as o,Color as a,ColorManagement as n,CustomToneMapping as i,LinearToneMapping as l,NoBlending as s,RawShaderMaterial as p,ReinhardToneMapping as c,SRGBTransfer as g,WebGLRenderTarget as u}from"three";let f=new Map([[l,"LINEAR_TONE_MAPPING"],[c,"REINHARD_TONE_MAPPING"],[o,"CINEON_TONE_MAPPING"],[r,"ACES_FILMIC_TONE_MAPPING"],[t,"AGX_TONE_MAPPING"],[i,"CUSTOM_TONE_MAPPING"]]),d=`
+  precision highp float;
+
+  attribute vec3 position;
+  attribute vec2 uv;
+
+  varying vec2 vUv;
+
+  void main() {
+    vUv = uv;
+    gl_Position = vec4(position.xy, 1.0, 1.0);
+  }
+`,_=`
+  precision highp float;
+
+  uniform sampler2D tDiffuse;
+
+  #include <tonemapping_pars_fragment>
+  #include <colorspace_pars_fragment>
+
+  varying vec2 vUv;
+
+  void main() {
+    vec4 color = texture2D(tDiffuse, vUv);
+
+    if (color.a > 0.0) {
+      color.rgb /= color.a;
+    }
+
+    #ifdef LINEAR_TONE_MAPPING
+      color.rgb = LinearToneMapping(color.rgb);
+    #elif defined(REINHARD_TONE_MAPPING)
+      color.rgb = ReinhardToneMapping(color.rgb);
+    #elif defined(CINEON_TONE_MAPPING)
+      color.rgb = OptimizedCineonToneMapping(color.rgb);
+    #elif defined(ACES_FILMIC_TONE_MAPPING)
+      color.rgb = ACESFilmicToneMapping(color.rgb);
+    #elif defined(AGX_TONE_MAPPING)
+      color.rgb = AgXToneMapping(color.rgb);
+    #elif defined(CUSTOM_TONE_MAPPING)
+      color.rgb = CustomToneMapping(color.rgb);
+    #endif
+
+    #ifdef SRGB_TRANSFER
+      color = sRGBTransferOETF(color);
+    #endif
+
+    gl_FragColor = color;
+  }
+`;export const createExportOutputMaterial=(e,r)=>{let t=f.get(e),o={...void 0!==t?{[t]:""}:{},...n.getTransfer(r)===g?{SRGB_TRANSFER:""}:{}},a={tDiffuse:{value:null},toneMappingExposure:{value:1}};return Object.assign(new p({name:"ExportOutputMaterial",uniforms:a,defines:o,vertexShader:d,fragmentShader:_,blending:s,depthTest:!1,depthWrite:!1}),{uniforms:a})};export class ExportCapturePass extends e{renderTarget;_material;constructor(e,r,t,o){super("ExportCapturePass"),this.needsSwap=!1,this.renderTarget=new u(e,r),this._material=createExportOutputMaterial(t,o),this.fullscreenMaterial=this._material}render(e,r){this._material.uniforms.tDiffuse.value=r?.texture??null,this._material.uniforms.toneMappingExposure.value=e.toneMappingExposure,e.setRenderTarget(this.renderTarget),e.render(this.scene,this.camera)}}export const resolveExportBackground=e=>{let r=e.sceneBackground instanceof a?e.sceneBackground:e.backgroundColor??("JPEG"===e.fileFormat?new a(0xffffff):null);return null===r?null:`#${r.getHexString(e.outputColorSpace)}`};export const flipPixelRows=(e,r,t)=>{let o=4*r,a=new Uint8ClampedArray(e.length);for(let r=0;r<t;r++)a.set(e.subarray(r*o,(r+1)*o),(t-r-1)*o);return a};export const readTargetToBlob=async(e,r,t,o)=>{let{width:a,height:n}=r,i=new Uint8Array(a*n*4);e.readRenderTargetPixels(r,0,0,a,n,i);let l=document.createElement("canvas");l.width=a,l.height=n;let s=l.getContext("2d");if(null===s)throw Error("Failed to get a 2D context for encoding the exported image! The browser refused to create one, possibly because too many canvases are alive. Retry the export.");let p=s.createImageData(a,n);return p.data.set(flipPixelRows(i,a,n)),s.putImageData(p,0,0),null!==t&&(s.globalCompositeOperation="destination-over",s.fillStyle=t,s.fillRect(0,0,a,n)),new Promise((e,r)=>{l.toBlob(t=>{t?e(t):r(Error("Failed to create blob from canvas"))},o)})};

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/image-renderer.d.ts

@@ -0,0 +1,37 @@
+import type CameraControls from 'camera-controls';
+import type { Camera, Color, PerspectiveCamera, Scene, WebGLRenderer } from 'three';
+export interface ImageRenderConfig {
+    name: string;
+    width: number;
+    height: number;
+    getCamera: (scene: Scene) => Promise<Camera>;
+    getRenderer?: (canvas: HTMLCanvasElement) => Promise<WebGLRenderer>;
+    fileFormat?: 'PNG' | 'JPEG';
+    backgroundColor?: Color;
+}
+interface BaseRenderConfig {
+    name: string;
+    width: number;
+    height: number;
+    fileFormat?: 'PNG' | 'JPEG';
+}
+export interface SimpleRenderConfig extends BaseRenderConfig {
+    distance: number;
+    polarAngle: number;
+    azimuthAngle: number;
+}
+export interface CustomCameraRenderConfig extends BaseRenderConfig {
+    setupCamera: (camera: PerspectiveCamera, controls: CameraControls) => Promise<void>;
+}
+export type RenderConfig = SimpleRenderConfig | CustomCameraRenderConfig;
+export interface RenderResult {
+    name: string;
+    blob: Blob;
+}
+export interface ImageRenderer {
+    renderImage(config: ImageRenderConfig): Promise<Blob>;
+    renderUsingOriginalCanvas(config: RenderConfig): Promise<RenderResult>;
+    renderUsingOriginalCanvas(config: RenderConfig[]): Promise<RenderResult[]>;
+    renderUsingOriginalCanvas(config: RenderConfig | RenderConfig[]): Promise<RenderResult | RenderResult[]>;
+}
+export {};

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/image-renderer.js

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

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/image-rendering-system.d.ts

@@ -0,0 +1,113 @@
+import type { EffectComposer } from 'postprocessing';
+import { Color, OrthographicCamera, PerspectiveCamera } from 'three';
+import type { AuthorizedPhoenixApiClient } from '#package/client';
+import type { ClientSideImageComponent, ComponentSnapshot, DomainContextSelectors, DomainEntity, DomainServicesSelectors, DomainState, SaveTemplateThumbnailComponent } from '#package/domain';
+import type { ConfiguratorExtensionSelectors } from '../../selectors.js';
+import type { ImageRenderConfig, ImageRenderer, RenderConfig } from './image-renderer.js';
+/**
+ * Constructor context of an `ImageRenderingSystem`. Same-layer configurator peers are reached
+ * through the configurator slice's selectors, exactly as the domain is reached through its own — so
+ * the context names no instances and stops being parameterised over entity types.
+ */
+export interface ImageRenderingSystemContext {
+    readonly configuratorExtensionSelectors: ConfiguratorExtensionSelectors;
+    readonly domainContextSelectors: DomainContextSelectors;
+    readonly domainServicesSelectors: DomainServicesSelectors;
+    readonly getConfigurationId: () => string;
+    readonly getAuthorizedClient: () => AuthorizedPhoenixApiClient<any, any, any>;
+}
+export interface ClientSideImageRenderingOptions {
+    /** Opens rendered images in new browser tabs instead of uploading them. */
+    readonly debug?: boolean;
+}
+/** ImageRenderingSystem with its entity types erased — how the runtime selectors expose the instance. */
+export type AnyImageRenderingSystem = ImageRenderingSystem<any>;
+export declare class ImageRenderingSystem<ENTITIES extends DomainEntity<string>> {
+    private readonly _context;
+    private _renderer;
+    private _effectComposer;
+    private _generation;
+    private readonly _debugObjectUrls;
+    private _canvasFreeze;
+    constructor(_context: ImageRenderingSystemContext);
+    private readonly _captureGenerationAssertion;
+    private readonly _captureGenerationGuard;
+    register(renderer: ImageRenderer): () => void;
+    registerEffectComposer(effectComposer: EffectComposer): () => void;
+    private readonly _openDebugImage;
+    private readonly _getRenderer;
+    /**
+     * Generates an image for the given configuration and uploads it to s3 as finalization data.
+     * This method uses the original canvas and camera to render the image.
+     *
+     * To debug the image, set the `debug` parameter to `true`. This will open the image in a new tab.
+     *
+     * To render multiple images, use the `generateImagesUsingOriginalCanvas` method istead, the images will be generated in bulk
+     * and it will prevent issues when rendered image is empty because the chrome tab isn't active.
+     *
+     * Currently this supports just perspective camera.
+     */
+    readonly generateImageUsingOriginalCanvas: (finalizationUuid: string, config: RenderConfig, debug?: boolean) => Promise<void>;
+    /**
+     * Generates images for the given configurations and uploads it to s3 as finalization data.
+     * This method uses the original canvas and camera to render the images.
+     *
+     * To debug the images, set the `debug` parameter to `true`. This will open the images in new tabs.
+     *
+     * Currently this supports just perspective camera.
+     */
+    generateImagesUsingOriginalCanvas(finalizationUuid: string, config: RenderConfig | RenderConfig[], debug?: boolean): Promise<void>;
+    /**
+     * Generates images for the given configurations and uploads it to s3 as finalization data.
+     */
+    generateImages(finalizationUuid: string, configs: ImageRenderConfig[], debug?: boolean): Promise<void>;
+    /**
+     * Generates images for the given configurations and returns them as blobs.
+     */
+    getGeneratedImages(configs: ImageRenderConfig[], debug?: boolean): Promise<Array<{
+        name: string;
+        blob: Blob;
+    }>>;
+    private readonly _renderCurrentView;
+    /**
+     * Keeps the current view on screen, with the frameloop paused, until the returned release has
+     * been called as often as the freeze was taken. The last release waits for the restored state to
+     * flush and redraws it before the snapshot comes off and the pause is let go, so the canvas is
+     * never seen blank or mid-export.
+     *
+     * The pause is the export system's shared one, the same that `runExportJobs` holds: a running loop
+     * would draw the export camera and size to the live canvas, and at priority 0 the `advance()` of
+     * an export would render the scene there too. Sharing it is what lets a standalone export (editor
+     * screenshot) and an export batch overlap in any order.
+     */
+    private readonly _freezeCanvas;
+    renderImage(config: {
+        width: number;
+        height: number;
+        fileFormat: 'PNG' | 'JPEG';
+        backgroundColor?: Color;
+        camera: PerspectiveCamera | OrthographicCamera;
+    }): Promise<Blob>;
+    /**
+     * Generates client side images from declarative clientSideImage components and uploads them to s3.
+     */
+    generateAndUploadDeclaredClientSideImages(state: DomainState<ENTITIES>, finalizationUuid: string, options?: ClientSideImageRenderingOptions): Promise<readonly {
+        name: string;
+        blob: Blob;
+        imageComponent: ComponentSnapshot<ClientSideImageComponent> | ComponentSnapshot<SaveTemplateThumbnailComponent>;
+    }[]>;
+    /**
+     * Generates client side images from declarative clientSideImage components without uploading them.
+     */
+    generateDeclaredClientSideImages(state: DomainState<ENTITIES>, options?: ClientSideImageRenderingOptions): Promise<readonly {
+        name: string;
+        blob: Blob;
+        imageComponent: ComponentSnapshot<ClientSideImageComponent> | ComponentSnapshot<SaveTemplateThumbnailComponent>;
+    }[]>;
+    generateImagesFromComponents(imageComponents: ReadonlyArray<ComponentSnapshot<ClientSideImageComponent> | ComponentSnapshot<SaveTemplateThumbnailComponent>>, sourceState: DomainState<ENTITIES>, options?: ClientSideImageRenderingOptions): Promise<ReadonlyArray<{
+        name: string;
+        blob: Blob;
+        imageComponent: ComponentSnapshot<ClientSideImageComponent> | ComponentSnapshot<SaveTemplateThumbnailComponent>;
+    }>>;
+    initialize: () => void;
+}

package/dist/configurator/application-runtime/extensions/systems/image-rendering-system/image-rendering-system.js

@@ -0,0 +1 @@
+import{Color as e,HalfFloatType as t,NoToneMapping as r,OrthographicCamera as a,PerspectiveCamera as n,WebGLRenderTarget as o}from"three";import{preloadFont as i}from"troika-three-text";import{match as s}from"ts-pattern";import{clientSideImageComponent as l,dimensionIndicatorComponent as c,domainEntityTypeFromId as m,editableDistanceDimensionIndicatorComponent as g,isDomainEntityId as d,isVirtualEntityId as h,sketchingEditComponent as u}from"#package/domain";import{createCameraControls as f}from"../camera-control-system/create-camera-controls.js";import{createCanvasFreezeFrame as p}from"./canvas-freeze-frame.js";import{ExportCapturePass as w,readTargetToBlob as C,resolveExportBackground as _}from"./export-image-capture.js";export class ImageRenderingSystem{_context;_renderer=null;_effectComposer=null;_generation=null;_debugObjectUrls=new Set;_canvasFreeze=null;constructor(e){this._context=e}_captureGenerationAssertion=()=>{let e=this._generation,t=()=>{if(!e?.active)throw Error("Image rendering generation ended while images were being rendered! The configurator context was reinitialized before the renderer finished, so the results belong to a configuration that is no longer active. Await the render before leaving the configuration, or discard the rejection.")};return t(),t};_captureGenerationGuard=()=>{let e=this._captureGenerationAssertion();return{assertActive:e,waitFor:async t=>{let r=await t;return e(),r},runEffect:t=>(e(),t())}};register(e){return this._renderer=e,()=>{this._renderer===e&&(this._renderer=null)}}registerEffectComposer(e){return this._effectComposer=e,()=>{this._effectComposer===e&&(this._effectComposer=null)}}_openDebugImage=e=>{let t=URL.createObjectURL(e);this._debugObjectUrls.add(t),window.open(t,"_blank")};_getRenderer=async()=>{let e=this._generation,t=Date.now(),r=()=>{if(!e?.active)throw Error("Image rendering generation ended while waiting for the renderer! The configurator context was reinitialized before the renderer arrived, so the render would target a scene that is gone. Await the render before leaving the configuration, or discard the rejection.")};r();let a=this._renderer;for(;null===a;){if(await new Promise(e=>setTimeout(e,50)),r(),Date.now()-t>1e4)throw Error("Renderer could not be retrieved! Reached timeout.");a=this._renderer}return a};generateImageUsingOriginalCanvas=async(e,t,r=!1)=>{let a=this._captureGenerationGuard(),n=await a.waitFor(this._getRenderer());if(r){let{blob:e}=await a.waitFor(a.runEffect(()=>n.renderUsingOriginalCanvas(t)));a.runEffect(()=>this._openDebugImage(e));return}let o=await Promise.all([t].map(async e=>{let{blob:t}=await a.waitFor(a.runEffect(()=>n.renderUsingOriginalCanvas(e)));return{blob:t,name:e.name}})),i=await a.waitFor(a.runEffect(()=>this._context.getAuthorizedClient().generateUploadLinks(this._context.getConfigurationId(),e,[t.name])));await Promise.all(i.map(async e=>{let t=o.find(t=>t.name===e.name);if(null==t)throw Error("Blob not found!");await Promise.all(i.map(async e=>{await a.waitFor(a.runEffect(()=>fetch(e.url,{method:"PUT",body:t.blob,headers:{"Content-Type":"image/png","Content-Length":t.blob.size.toString()}})))}))}))};async generateImagesUsingOriginalCanvas(e,t,r=!1){let a=this._captureGenerationGuard(),n=await a.waitFor(this._getRenderer()),o=Array.isArray(t)?t:[t],i=await o.reduce(async(e,t)=>[...await e,await a.waitFor(a.runEffect(()=>n.renderUsingOriginalCanvas(t)))],Promise.resolve([]));if(r){for(let e of i)a.runEffect(()=>this._openDebugImage(e.blob)),await a.waitFor(new Promise(e=>setTimeout(e,100)));return}let s=o.map(e=>e.name),l=await a.waitFor(a.runEffect(()=>this._context.getAuthorizedClient().generateUploadLinks(this._context.getConfigurationId(),e,s)));await Promise.all(l.map(async e=>{let t=i.find(t=>t.name===e.name);if(null==t)throw Error("Blob not found!");await Promise.all(l.map(async e=>{await a.waitFor(a.runEffect(()=>fetch(e.url,{method:"PUT",body:t.blob,headers:{"Content-Type":"image/png","Content-Length":t.blob.size.toString()}})))}))}))}async generateImages(e,t,r=!1){let a=this._captureGenerationGuard(),n=await a.waitFor(this._getRenderer()),o=t.map(e=>e.name);if(r)return void await Promise.all(t.map(async e=>{let t=await a.waitFor(a.runEffect(()=>n.renderImage(e)));a.runEffect(()=>this._openDebugImage(t))}));let i=await Promise.all(t.map(async e=>({blob:await a.waitFor(a.runEffect(()=>n.renderImage(e))),name:e.name}))),s=await a.waitFor(a.runEffect(()=>this._context.getAuthorizedClient().generateUploadLinks(this._context.getConfigurationId(),e,o)));await Promise.all(s.map(async e=>{let t=i.find(t=>t.name===e.name);if(null==t)throw Error("Blob not found!");await Promise.all(s.map(async e=>{await a.waitFor(a.runEffect(()=>fetch(e.url,{method:"PUT",body:t.blob,headers:{"Content-Type":"image/png","Content-Length":t.blob.size.toString()}})))}))}))}async getGeneratedImages(e,t=!1){let r=this._captureGenerationAssertion(),a=await this._getRenderer();return(r(),t)?(await Promise.all(e.map(async e=>{let t=await a.renderImage(e);r(),this._openDebugImage(t)})),[]):Promise.all(e.map(async e=>{let t=await a.renderImage(e);return r(),{blob:t,name:e.name}}))}_renderCurrentView=e=>{let{gl:t,scene:r,camera:a}=e.get();null!==this._effectComposer?this._effectComposer.render():t.render(r,a)};_freezeCanvas=e=>{this._canvasFreeze?.handle===e?this._canvasFreeze.holders+=1:(this._canvasFreeze?.remove(),this._canvasFreeze={handle:e,remove:p(e.get().gl.domElement,()=>this._renderCurrentView(e)),resumeFrameloop:this._context.configuratorExtensionSelectors.getExportSystem().pauseFrameloop(e),holders:1});let t=this._canvasFreeze,r=!1;return async()=>{if(!r&&(r=!0,t.holders-=1,!(t.holders>0)))try{let r=this._context.configuratorExtensionSelectors.getCanvasSystem();r.r3fHandle$.value===e&&await r.waitForFlush(),r.r3fHandle$.value===e&&0===t.holders&&this._renderCurrentView(e)}catch{}finally{0===t.holders&&(t.remove(),t.resumeFrameloop(),this._canvasFreeze===t&&(this._canvasFreeze=null))}}};async renderImage(a){let n=this._context.configuratorExtensionSelectors.getCanvasSystem().r3fHandle$.value;if(null===n)throw Error("R3F state not ready");let{gl:i,scene:s,camera:l,size:c,advance:m}=n.get(),g=i.getRenderTarget(),d=i.getClearColor(new e),h=i.getClearAlpha(),u=i.autoClearColor,f=e=>new w(a.width,a.height,e,i.outputColorSpace),p={composer:null,pass:null},y=null,b=null,x=e=>{let t=p.pass??f(r);return p.pass=t,p.composer===e&&e.passes.at(-1)===t||(p.composer?.removePass(t),e.addPass(t),p.composer=e),t},v=async()=>{if(await this._context.configuratorExtensionSelectors.getCanvasSystem().waitForFlush(),this._context.configuratorExtensionSelectors.getCanvasSystem().r3fHandle$.value!==n)throw Error("Canvas was remounted while an image was being rendered! The export borrowed a canvas that is gone, so it cannot capture the image. Retry the export once the configurator has settled.")},E=this._freezeCanvas(n);try{n.set({size:{height:a.height,width:a.width,top:0,left:0,updateStyle:!1}}),n.set({camera:a.camera}),await v(),null!==this._effectComposer&&x(this._effectComposer),m(void 0),await v();let r="JPEG"===a.fileFormat?"image/jpeg":"image/png",l=_({sceneBackground:s.background,backgroundColor:a.backgroundColor,fileFormat:a.fileFormat,outputColorSpace:i.outputColorSpace});if(null!==this._effectComposer){i.setRenderTarget(null),"JPEG"===a.fileFormat?i.setClearColor(a.backgroundColor??0xffffff):a.backgroundColor?i.setClearColor(a.backgroundColor):i.setClearAlpha(0),i.autoClearColor=!0;let e=x(this._effectComposer);return this._effectComposer.render(),await C(i,e.renderTarget,l,r)}y=f(i.toneMapping),b=new o(a.width,a.height,{samples:4,type:t,stencilBuffer:i.getContextAttributes().stencil??!1});let c=s.background;c instanceof e&&(s.background=null);try{i.setClearColor(0,0),i.setRenderTarget(b),i.clear(),i.render(s,a.camera)}finally{s.background=c}return y.render(i,b),await C(i,y.renderTarget,l,r)}finally{null!==p.pass&&(p.composer?.removePass(p.pass),p.pass.dispose()),y?.dispose(),b?.dispose(),this._context.configuratorExtensionSelectors.getCanvasSystem().r3fHandle$.value===n&&(i.setClearColor(d,h),i.autoClearColor=u,i.setRenderTarget(g),n.set({camera:l,size:{...c,updateStyle:!1}})),await E()}}async generateAndUploadDeclaredClientSideImages(e,t,r={}){let a=this._captureGenerationGuard(),n=await a.waitFor(this.generateDeclaredClientSideImages(e,r));if(r.debug)return n;let o=new Map((await a.waitFor(a.runEffect(()=>this._context.getAuthorizedClient().generateUploadLinks(this._context.getConfigurationId(),t,n.map(e=>e.name))))).map(e=>[e.name,e.url]));return await Promise.all(n.map(async e=>{let t=o.get(e.name);if(!t)throw Error(`Presigned link for image ${e.name} not found!`);await a.waitFor(a.runEffect(()=>fetch(t,{method:"PUT",body:e.blob})))})),n}generateDeclaredClientSideImages(e,t={}){let r=this._context.domainContextSelectors.getComponentReader().readManyComponents({componentTypes:[l]},e);return this.generateImagesFromComponents(r,e,t)}async generateImagesFromComponents(t,r,o={}){let l=this._captureGenerationGuard(),p=this._context.configuratorExtensionSelectors.getCanvasSystem().r3fHandle$.value;if(null===p)throw Error("R3F state not ready");let w=!1,C=this._context.domainContextSelectors.getExportStates(),_=t.map(t=>{if(!C.includes(t.state.exportState)){let e=d(t.componentInstance.entityId)?m(t.componentInstance.entityId):"unknown entity",r=t.componentInstance.componentType.name,a=t.componentInstance.instanceName;throw Error(`Export state ${t.state.exportState} declared in component ${r}/${a} on ${e} is not a valid export state. Expected one of: ${C.join(", ")}`)}let p=t.componentInstance.entityId;if(h(p))throw Error("Virtual entities cannot be used for export");return this._context.configuratorExtensionSelectors.getExportSystem().createExportJob(r,{exportState:t.state.exportState,exportedEntityId:p,toolState:t.state.toolState,viewState:t.state.viewState,navigationState:t.state.navigationState,selectedEntityId:r.rootEntityId},async r=>{let m=this._context.domainContextSelectors.getComponentReader().readManyComponents({componentTypes:[c,g,u]},r.state);!w&&m.length>0&&(await new Promise(e=>{i({font:void 0,characters:void 0},e)}),w=!0,await this._context.configuratorExtensionSelectors.getCanvasSystem().waitForFlush());let d=this._context.configuratorExtensionSelectors.getCameraSystem().getActiveCameraConfig(r.state);if(null==d)throw Error(`No camera config is attached for export state ${t.state.exportState} and exported entity ${p}. Whenever using a client-side image component, you need to attach a camera configuration to the export state defined on that componentin the domain spec. This camera will be used to render the image.`);let h=s(d.typeSpecificConfig.cameraType).with("perspective",()=>new n(45,t.state.width/t.state.height,1,1e4)).with("orthographic",()=>new a(0,0,1e4,0,1,1e4)).exhaustive(),C=f(h);await this._context.configuratorExtensionSelectors.getCameraSystem().applyConfig(d,C,!1,{width:t.state.width,height:t.state.height,padding:{top:0,right:0,bottom:0,left:0}}),C.update(1e6),await new Promise(e=>setTimeout(e,100));let _=await l.waitFor(l.runEffect(()=>this.renderImage({width:t.state.width,height:t.state.height,fileFormat:t.state.fileFormat,backgroundColor:t.state.backgroundColor?new e(t.state.backgroundColor):void 0,camera:h})));return o.debug&&l.runEffect(()=>this._openDebugImage(_)),{blob:_,imageComponent:t,name:`${t.componentInstance.componentType.name}-${t.componentInstance.entityId}-${t.componentInstance.instanceName}`}})});if(0===_.length)return this._context.configuratorExtensionSelectors.getExportSystem().runExportJobs(_);let y=this._freezeCanvas(p);try{return await this._context.configuratorExtensionSelectors.getExportSystem().runExportJobs(_)}finally{await y()}}initialize=()=>{for(let e of(null!==this._generation&&(this._generation.active=!1),this._debugObjectUrls))URL.revokeObjectURL(e);this._debugObjectUrls.clear(),this._generation={active:!0}}}

package/dist/configurator/application-runtime/extensions/systems/index.d.ts

@@ -0,0 +1,14 @@
+export { AnimationSystem, type AnimationSystemContext } from './animation-system.js';
+export { CameraControlSystem, CameraControlType } from './camera-control-system/camera-control-system.js';
+export { type AnyCameraSystem, CameraSystem, type CameraSystemContext } from './camera-control-system/camera-system.js';
+export { createCameraControls } from './camera-control-system/create-camera-controls.js';
+export { type AnyCanvasSystem, CanvasSystem, type EntityObjectFilter, type FlushToken } from './canvas-system.js';
+export { type AnyDragAndDropSystem, DragAndDropSystem, type DragAndDropSystemContext, type DraggableState, type DraggingState, type RotationDraggingState, } from './drag-and-drop-system/drag-and-drop-system.js';
+export { type AnyExportSystem, ExportSystem, type ExportSystemContext } from './export-system/export-system.js';
+export { type GraphQLExecution, type GraphQLOperation, GraphQLSystem, type GraphQLSystemContext, type PreparedOperation, } from './graphql-system/graphql-system.js';
+export type * from './image-rendering-system/image-renderer.js';
+export { type AnyImageRenderingSystem, ImageRenderingSystem, type ImageRenderingSystemContext, } from './image-rendering-system/image-rendering-system.js';
+export { type AnyLayoutSystem, LayoutSystem, type LayoutSystemContext } from './layout-system/layout-system.js';
+export { toolbarHelpElementName } from './layout-system/toolbar-help-element.js';
+export { type AnySketchingSystem, SketchingSystem } from './sketching-system/sketching-system.js';
+export { LineEndPointUpdateTag, LineLengthUpdateTag, LineLineConnectionUpdateTag, LineRectangleBottomLeftConnectionUpdateTag, LineRectangleBottomRightConnectionUpdateTag, LineRectangleTopLeftConnectionUpdateTag, LineRectangleTopRightConnectionUpdateTag, LineSketchingPointUpdateTag, LineStartPointUpdateTag, RectangleBottomLeftCornerUpdateTag, RectangleBottomRightCornerUpdateTag, RectangleDepthUpdateTag, RectangleSketchingPointUpdateTag, RectangleTopLeftCornerUpdateTag, RectangleTopRightCornerUpdateTag, RectangleWidthUpdateTag, SetInitialSketchingPointPositionTag, SketchingFixTransformationTag, isAnySketchingPointUpdate, isLineEndPointUpdate, isLineLengthUpdate, isLineLineConnectionUpdate, isLineRectangleBottomLeftConnectionUpdate, isLineRectangleBottomRightConnectionUpdate, isLineRectangleTopLeftConnectionUpdate, isLineRectangleTopRightConnectionUpdate, isLineSketchingPointUpdate, isLineStartPointUpdate, isRectangleBottomLeftCornerUpdate, isRectangleBottomRightCornerUpdate, isRectangleDepthUpdate, isRectangleSketchingPointUpdate, isRectangleTopLeftCornerUpdate, isRectangleTopRightCornerUpdate, isRectangleWidthUpdate, isSetInitialLinePositionUpdate, isSetInitialRectanglePositionUpdate, isSketchingFixTransformationUpdate, } from './sketching-system/sketching-updates.js';

package/dist/configurator/application-runtime/extensions/systems/index.js

@@ -0,0 +1 @@
+export{AnimationSystem}from"./animation-system.js";export{CameraControlSystem,CameraControlType}from"./camera-control-system/camera-control-system.js";export{CameraSystem}from"./camera-control-system/camera-system.js";export{createCameraControls}from"./camera-control-system/create-camera-controls.js";export{CanvasSystem}from"./canvas-system.js";export{DragAndDropSystem}from"./drag-and-drop-system/drag-and-drop-system.js";export{ExportSystem}from"./export-system/export-system.js";export{GraphQLSystem}from"./graphql-system/graphql-system.js";export{ImageRenderingSystem}from"./image-rendering-system/image-rendering-system.js";export{LayoutSystem}from"./layout-system/layout-system.js";export{toolbarHelpElementName}from"./layout-system/toolbar-help-element.js";export{SketchingSystem}from"./sketching-system/sketching-system.js";export{LineEndPointUpdateTag,LineLengthUpdateTag,LineLineConnectionUpdateTag,LineRectangleBottomLeftConnectionUpdateTag,LineRectangleBottomRightConnectionUpdateTag,LineRectangleTopLeftConnectionUpdateTag,LineRectangleTopRightConnectionUpdateTag,LineSketchingPointUpdateTag,LineStartPointUpdateTag,RectangleBottomLeftCornerUpdateTag,RectangleBottomRightCornerUpdateTag,RectangleDepthUpdateTag,RectangleSketchingPointUpdateTag,RectangleTopLeftCornerUpdateTag,RectangleTopRightCornerUpdateTag,RectangleWidthUpdateTag,SetInitialSketchingPointPositionTag,SketchingFixTransformationTag,isAnySketchingPointUpdate,isLineEndPointUpdate,isLineLengthUpdate,isLineLineConnectionUpdate,isLineRectangleBottomLeftConnectionUpdate,isLineRectangleBottomRightConnectionUpdate,isLineRectangleTopLeftConnectionUpdate,isLineRectangleTopRightConnectionUpdate,isLineSketchingPointUpdate,isLineStartPointUpdate,isRectangleBottomLeftCornerUpdate,isRectangleBottomRightCornerUpdate,isRectangleDepthUpdate,isRectangleSketchingPointUpdate,isRectangleTopLeftCornerUpdate,isRectangleTopRightCornerUpdate,isRectangleWidthUpdate,isSetInitialLinePositionUpdate,isSetInitialRectanglePositionUpdate,isSketchingFixTransformationUpdate}from"./sketching-system/sketching-updates.js";

package/dist/configurator/application-runtime/extensions/systems/layout-system/layout-state.d.ts

@@ -0,0 +1,16 @@
+import type { FC } from 'react';
+import { type DomainEntityId } from '#package/domain';
+export interface PropertyPageStackPage {
+    readonly props: Record<string, unknown>;
+    readonly component: FC<unknown>;
+}
+export interface PropertyPageState {
+    readonly customState: Record<string, unknown>;
+    readonly stackPages: readonly PropertyPageStackPage[];
+}
+export type PropertyPageStates = Record<DomainEntityId<string>, PropertyPageState>;
+export type LayoutStateComponentState = {
+    readonly propertyPageStates: PropertyPageStates;
+};
+export declare const layoutStateComponent: import("#package/domain").SystemComponentType<"layoutStateComponent", LayoutStateComponentState, "propertyPageStates">;
+export type LayoutStateComponent = typeof layoutStateComponent;

package/dist/configurator/application-runtime/extensions/systems/layout-system/layout-state.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as t}from"#package/domain";export const layoutStateComponent=t.component("layoutStateComponent").withState({type:"object",properties:{propertyPageStates:{type:"object",additionalProperties:!0}},required:["propertyPageStates"],additionalProperties:!1}).withWritableKeys(["propertyPageStates"]).build();

package/dist/configurator/application-runtime/extensions/systems/layout-system/layout-system.d.ts

@@ -0,0 +1,73 @@
+import type { FC } from 'react';
+import type { DomainContextSelectors, DomainEntity, DomainEntityId, DomainServicesSelectors, DomainState, SpecSelectors, ToolbarComponentState } from '#package/domain';
+import { SystemState } from '#package/domain';
+import { type LayoutStateComponent } from './layout-state.js';
+/**
+placeholder
+ */
+export interface LayoutSystemContext {
+    readonly specSelectors: SpecSelectors;
+    readonly domainContextSelectors: DomainContextSelectors;
+    readonly domainServicesSelectors: DomainServicesSelectors;
+}
+/** LayoutSystem with its entity types erased — how the runtime selectors expose the instance. */
+export type AnyLayoutSystem = LayoutSystem<any>;
+export declare class LayoutSystem<ENTITIES extends DomainEntity<string>> {
+    private readonly _context;
+    private readonly _toolbarCache;
+    readonly state: SystemState<ENTITIES, LayoutStateComponent>;
+    constructor(_context: LayoutSystemContext);
+    /**
+     * Whether the legacy toolbar help element is registered for this application.
+     *
+     * Read on demand rather than captured at construction: the element slots live in runtime state,
+     * so a system built once and reused across lifecycles would otherwise keep answering with
+     * whatever was true when it was created.
+     */
+    private get _toolbarHelpExists();
+    initialize: () => void;
+    getCleanUpPropertyPageStateUpdates: (entityId: DomainEntityId<string>, state: DomainState<ENTITIES>) => import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"layoutStateComponent", import("./layout-state.js").LayoutStateComponentState, "propertyPageStates">>[];
+    getLayoutConfig: (state: DomainState<ENTITIES>) => {
+        layout: "custom" | "simple" | "steps" | "tabs" | "universal";
+        ignoreSelectionInSidebar: boolean;
+        miniSidebar: boolean;
+        splitSidebar: boolean;
+        showSelectionBackButton: boolean;
+        shareDisabled: boolean;
+        availableLocales: string[];
+        indicatorSwitch: boolean;
+    };
+    getSidebarSummaryPage: (state: DomainState<ENTITIES>) => {
+        page: import("#package/domain").ComponentSnapshot<import("#package/domain").SystemComponentType<"customSummaryPage", import("#package/domain").CustomSummaryPageComponentState, never> | import("#package/domain").SystemComponentType<"simpleSummary", import("#package/domain").SimpleSummaryComponentState, never>> | null;
+        isSummaryActive: boolean;
+        summaryNavigationState: string | undefined;
+    };
+    getEnterSidebarSummaryUpdates: (state: DomainState<ENTITIES>) => import("#package/domain").EphemeralRecordModification<import("#package/domain").SystemComponentType<"navigationState", import("#package/domain").NavigationStateComponentState, "activeState" | "historyStack">>[];
+    getLeaveSidebarSummaryUpdates: (state: DomainState<ENTITIES>) => import("#package/domain").EphemeralRecordModification<import("#package/domain").SystemComponentType<"navigationState", import("#package/domain").NavigationStateComponentState, "activeState" | "historyStack">>[];
+    getPushSidebarStackPageUpdates: <PROPS>(entityId: DomainEntityId<string>, component: FC<PROPS>, props: PROPS, state: DomainState<ENTITIES>) => import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"layoutStateComponent", import("./layout-state.js").LayoutStateComponentState, "propertyPageStates">>[];
+    getPopSidebarStackPageUpdates: (entityId: DomainEntityId<string>, state: DomainState<ENTITIES>) => import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"layoutStateComponent", import("./layout-state.js").LayoutStateComponentState, "propertyPageStates">>[];
+    getSidebarBackUpdates: (state: DomainState<ENTITIES>) => import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"layoutStateComponent", import("./layout-state.js").LayoutStateComponentState, "propertyPageStates">>[] | import("#package/domain").EphemeralRecordModification<import("#package/domain").SystemComponentType<"navigationState", import("#package/domain").NavigationStateComponentState, "activeState" | "historyStack">>[] | import("#package/domain").EphemeralRecordModification<import("#package/domain").SystemComponentType<"selectionState", import("#package/domain").SelectionStateComponentState, "selectedEntityId">>[];
+    getSidebarContent: (state: DomainState<ENTITIES>) => {
+        summaryPage: import("#package/domain").ComponentSnapshot<import("#package/domain").SystemComponentType<"customSummaryPage", import("#package/domain").CustomSummaryPageComponentState, never> | import("#package/domain").SystemComponentType<"simpleSummary", import("#package/domain").SimpleSummaryComponentState, never>> | null;
+        propertyPages: never[];
+        isBackAvailable: boolean;
+        hasMiniSidebar: boolean;
+        hasSplitSidebar: boolean;
+        renderedStackedPage?: undefined;
+        activePropertyPageId?: undefined;
+    } | {
+        summaryPage: null;
+        propertyPages: {
+            id: any;
+            propertyPages: readonly import("#package/domain").ComponentSnapshot<import("#package/domain").SystemComponentType<"propertyPage", import("#package/domain").PropertyPageComponentState, never>>[];
+            header: import("#package/domain").ComponentSnapshot<import("#package/domain").SystemComponentType<"entityHeader", import("#package/domain").EntityHeaderComponentState, never>> | null;
+        }[];
+        renderedStackedPage: import("./layout-state.js").PropertyPageStackPage | null;
+        activePropertyPageId: any;
+        isBackAvailable: boolean;
+        hasMiniSidebar: boolean;
+        hasSplitSidebar: boolean;
+    };
+    getToolbarState: (state: DomainState<ENTITIES>) => ToolbarComponentState;
+    getNavigationSteps: (state: DomainState<ENTITIES>) => import("#package/domain").NavigationStep[];
+}

package/dist/configurator/application-runtime/extensions/systems/layout-system/layout-system.js

@@ -0,0 +1 @@
+import{P as t,match as e}from"ts-pattern";import{SystemState as o,applicationConfigComponent as n,customSummaryPageComponent as a,entityHeaderComponent as i,navigationStepsComponent as r,propertyPageComponent as s,sidebarTabsComponent as l,simpleSummaryComponent as d,toolbarComponent as c}from"#package/domain";import{layoutStateComponent as g}from"./layout-state.js";import{toolbarHelpElementName as u}from"./toolbar-help-element.js";export class LayoutSystem{_context;_toolbarCache=new WeakMap;state;constructor(t){this._context=t,this.state=new o({...this._context,selectors:this._context.domainContextSelectors,componentType:g,getInitialState:()=>({propertyPageStates:{}})})}get _toolbarHelpExists(){return void 0!==this._context.specSelectors.getElementSlots().layoutElements[u]}initialize=()=>{this.state.initialize()};getCleanUpPropertyPageStateUpdates=(t,e)=>this.state.getUpdates(e=>{if(!e.propertyPageStates[t])return null;let o={...e.propertyPageStates};return delete o[t],{...e,propertyPageStates:o}},e);getLayoutConfig=t=>{let e=this._context.domainContextSelectors.getComponentReader().readFirstRootComponent({componentTypes:[n]},t),o=e?.state.shareDisabled??!1,a=o||(e?.state.shareOwnerLinkDisabled??!1),i=o||(e?.state.shareReadRevisionLinkDisabled??!1);return{layout:e?.state.layout??"universal",ignoreSelectionInSidebar:e?.state.ignoreSelectionInSidebar??!1,miniSidebar:e?.state.miniSidebar??!1,splitSidebar:e?.state.splitSidebar??!1,showSelectionBackButton:e?.state.showSelectionBackButton??!0,shareDisabled:a&&i,availableLocales:e?.state.availableLocales??["en"],indicatorSwitch:e?.state.indicatorSwitch??!0}};getSidebarSummaryPage=t=>{let e=this._context.domainContextSelectors.getNavigationSystem().getActiveNavigationState(t),o=this._context.domainContextSelectors.getComponentReader().readFirstRootComponent({componentTypes:[a,d]},t),n=e===o?.state.summaryNavigationState,i=o?.state.summaryNavigationState;return{page:o,isSummaryActive:n,summaryNavigationState:i}};getEnterSidebarSummaryUpdates=t=>{let{summaryNavigationState:e}=this.getSidebarSummaryPage(t);return e?[this._context.domainContextSelectors.getNavigationSystem().getPushNavigationUpdate(e,t)]:[]};getLeaveSidebarSummaryUpdates=t=>{let e=this._context.domainContextSelectors.getNavigationSystem().getPopNavigationUpdate(t);if(e)return[e];let o=this._context.domainContextSelectors.getNavigationStates().at(0);return o?(this._context.domainServicesSelectors.getLogger().error("There is no navigation state to pop, falling back to the initial navigation state. Check whether the history stack is not broken by some custom navigation logic."),[this._context.domainContextSelectors.getNavigationSystem().getNavigationUpdate(o)]):(this._context.domainServicesSelectors.getLogger().error("There is no navigation state to pop and no initial navigation state to fallback to, this should not happen"),[])};getPushSidebarStackPageUpdates=(t,e,o,n)=>this.state.getUpdates(n=>{let a=n.propertyPageStates[t]??{customState:{},stackPages:[]};return{...n,propertyPageStates:{...n.propertyPageStates,[t]:{...a,stackPages:[...a.stackPages,{props:o,component:e}]}}}},n);getPopSidebarStackPageUpdates=(t,e)=>this.state.getUpdates(e=>{let o=e.propertyPageStates[t]??{customState:{},stackPages:[]};return{...e,propertyPageStates:{...e.propertyPageStates,[t]:{...o,stackPages:o.stackPages.slice(0,-1)}}}},e);getSidebarBackUpdates=t=>{let e=this._context.domainContextSelectors.getNavigationSystem().getHasStackToPop(t),o=this._context.domainContextSelectors.getNavigationSystem().getIsRootSelected(t),{renderedStackedPage:n,summaryPage:a,activePropertyPageId:i}=this.getSidebarContent(t);if(a)return this.getLeaveSidebarSummaryUpdates(t);if(n&&i)return this.getPopSidebarStackPageUpdates(i,t);if(e){let e=this._context.domainContextSelectors.getNavigationSystem().getPopNavigationUpdate(t);return e?[e]:[]}return o?[]:[this._context.domainContextSelectors.getNavigationSystem().getDeselectUpdate()]};getSidebarContent=t=>{let e=this._context.domainContextSelectors.getNavigationSystem().getActiveSelectionState(t),o=this.state.get(t),n=this.getLayoutConfig(t),a=this._context.domainContextSelectors.getComponentReader().readManyComponents({componentTypes:[l],entityIds:[e]},t).some(t=>t.state.tabs.length>0),r=n.miniSidebar&&!a;r&&a&&this._context.domainServicesSelectors.getLogger().warn("Mini sidebar is not active because the layout contains tabs. Only layouts without tabs can have mini sidebar.");let d=this._context.domainContextSelectors.getComponentReader().readManyComponents({componentTypes:[s]},t),{isSummaryActive:c,page:g}=this.getSidebarSummaryPage(t),u=this._context.domainContextSelectors.getComponentReader().readManyComponents({componentTypes:[i]},t),p=this._context.domainContextSelectors.getCompositionProjections().getTree(t).map.get(e);if(!p)throw Error(`Selected entity ${e} not found in composition tree`);let m=this._context.domainContextSelectors.getCompositionProjections().getTree(t).map.get(t.rootEntityId);if(!m)throw Error(`Root entity ${t.rootEntityId} not found in composition tree`);let S=(n.ignoreSelectionInSidebar?[m]:[p,...p.ancestors()]).map(t=>{let e=n.ignoreSelectionInSidebar?d:d.filter(e=>e.componentInstance.entityId===t.id),o=u.filter(e=>e.componentInstance.entityId===t.id);return{id:t.id,propertyPages:e,header:o[0]??null}}),h=S[0]?.id,b=(h?o.propertyPageStates[h]?.stackPages??[]:[]).at(-1)??null,k=this._context.domainContextSelectors.getNavigationSystem().getHasStackToPop(t),x=this._context.domainContextSelectors.getNavigationSystem().getIsRootSelected(t),y=c&&k||k||!!b||!x&&n.showSelectionBackButton&&!n.ignoreSelectionInSidebar;return c?{summaryPage:g,propertyPages:[],isBackAvailable:y,hasMiniSidebar:r,hasSplitSidebar:n.splitSidebar}:{summaryPage:null,propertyPages:S,renderedStackedPage:b,activePropertyPageId:h,isBackAvailable:y,hasMiniSidebar:r,hasSplitSidebar:n.splitSidebar}};getToolbarState=o=>{let n=this._toolbarHelpExists,a=this._toolbarCache.get(o);if(a&&a.toolbarHelpExists===n)return a.result;let i=this._context.domainContextSelectors.getExpressionContext(),r=this._context.domainContextSelectors.getNavigationSystem().getActiveFullscreenState(o),s="read"===i.mode,l=this._context.domainContextSelectors.getComponentReader().readFirstRootComponent({componentTypes:[c]},o),d=this._context.domainContextSelectors.getDimensionSystem().getDimensionConfig(o),g=this.getLayoutConfig(o),u="read"===this._context.domainContextSelectors.getExpressionContext().mode,p=g.availableLocales.length>1,m=!u&&!g.shareDisabled,S=g.indicatorSwitch,h=d.availableDimensions.length>1||S,b=e(l).returnType().with(t.nonNullable,t=>t.state).with(t.nullish,()=>e([r,s]).returnType().with([!1,!1],()=>({desktop:[{kind:"toolbarButtonGroup",children:[{kind:"enterFullscreenToolbarButton"}]},{kind:"toolbarButtonGroup",children:[{kind:"resetCameraToolbarButton"}]},...p?[{kind:"toolbarButtonGroup",children:[{kind:"languageToolbarButton"}]}]:[],...m||h?[{kind:"toolbarButtonGroup",children:[...m?[{kind:"shareToolbarButton"}]:[],...h?[{kind:"measurementsToolbarButton"}]:[],...n?[{kind:"helpToolbarButton"}]:[]]}]:[],{kind:"toolbarButtonGroup",children:[{kind:"undoToolbarButton"},{kind:"redoToolbarButton"}]}],mobile:[{kind:"toolbarButtonGroup",children:[{kind:"undoToolbarButton"},{kind:"redoToolbarButton"}]},{kind:"toolbarButtonGroup",children:[{kind:"resetCameraToolbarButton"}]},{kind:"toolbarButtonGroup",children:[{kind:"enterFullscreenToolbarButton"}]}],mobileMenu:[...m?[{kind:"shareMenuAction"}]:[],...h?[{kind:"measurementsMenuAction"}]:[],...p?[{kind:"languageMenuAction"}]:[],...n?[{kind:"helpMenuAction"}]:[]]})).with([!0,!1],()=>({desktop:[{kind:"toolbarButtonGroup",children:[{kind:"exitFullscreenToolbarButton"}]}],mobile:[{kind:"toolbarButtonGroup",children:[{kind:"exitFullscreenToolbarButton"}]}],mobileMenu:[]})).with([!1,!0],()=>({desktop:[{kind:"toolbarButtonGroup",children:[{kind:"enterFullscreenToolbarButton"}]},{kind:"toolbarButtonGroup",children:[{kind:"resetCameraToolbarButton"}]},...p?[{kind:"toolbarButtonGroup",children:[{kind:"languageToolbarButton"}]}]:[],...h?[{kind:"toolbarButtonGroup",children:[...h?[{kind:"measurementsToolbarButton"}]:[]]}]:[],...n?[{kind:"helpToolbarButton"}]:[]],mobile:[{kind:"toolbarButtonGroup",children:[{kind:"resetCameraToolbarButton"}]},{kind:"toolbarButtonGroup",children:[{kind:"enterFullscreenToolbarButton"}]}],mobileMenu:[...h?[{kind:"measurementsMenuAction"}]:[],...p?[{kind:"languageMenuAction"}]:[],...n?[{kind:"helpMenuAction"}]:[]]})).with([!0,!0],()=>({desktop:[{kind:"toolbarButtonGroup",children:[{kind:"exitFullscreenToolbarButton"}]}],mobile:[{kind:"toolbarButtonGroup",children:[{kind:"exitFullscreenToolbarButton"}]}],mobileMenu:[]})).exhaustive()).exhaustive();return this._toolbarCache.set(o,{toolbarHelpExists:n,result:b}),b};getNavigationSteps=t=>{let e=this._context.domainContextSelectors.getComponentReader().readFirstRootComponent({componentTypes:[r]},t);return e?.state.steps??[]}}

package/dist/configurator/application-runtime/extensions/systems/layout-system/toolbar-help-element.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Slot name of the legacy toolbar help element.
+ *
+ * Kept in its own leaf module with no imports so both sides of the feature can read it without a
+ * cycle: `LayoutSystem` derives the toolbar entries from whether the slot is filled, and the
+ * `ToolbarHelp` element in `configurator/ui` registers itself under the same name.
+ *
+ * @deprecated Use the toolbar YAML definition with `helpToolbarButton` instead. This will be
+ * removed together with the `ToolbarHelp` element.
+ */
+export declare const toolbarHelpElementName = "ToolbarHelp";

package/dist/configurator/application-runtime/extensions/systems/layout-system/toolbar-help-element.js

@@ -0,0 +1 @@
+export const toolbarHelpElementName="ToolbarHelp";

package/dist/configurator/application-runtime/extensions/systems/sketching-system/sketching-system.d.ts

@@ -0,0 +1,111 @@
+import type { ObservableWithLastValue } from '@salsita-ai/common/utils';
+import type { Connection, DomainContextSelectors, DomainEntity, DomainEntityId, DomainServicesSelectors, EntityRecipe, Line, Point, Rectangle, SketchingPoint, StateUpdate } from '#package/domain';
+import type { ConfiguratorExtensionSelectors } from '../../selectors.js';
+interface DrawingState<ENTITIES extends DomainEntity<string>> {
+    readonly position: [number, number];
+    readonly entityId: DomainEntityId<string>;
+    readonly stagedCreateUpdates: ReadonlyArray<StateUpdate<ENTITIES, ENTITIES>>;
+    readonly currentRecipes: ReadonlyArray<EntityRecipe<ENTITIES>>;
+    readonly currentParentId: DomainEntityId<string>;
+    readonly currentCollection: string | undefined;
+    readonly fixedDrawingPoint: 'start' | 'end';
+    readonly currentSketchingKey: string;
+}
+type SketchingSystemState<ENTITIES extends DomainEntity<string>> = {
+    readonly emptySketchingPosition: [number, number];
+    readonly drawingState: DrawingState<ENTITIES> | null;
+};
+/**
+ * Constructor context of a `SketchingSystem`. Same-layer configurator peers stay instances; everything the
+ * domain owns is reached through the runtime selectors, so the context stops being parameterised
+ * over entity types in order to name a handful of collaborators.
+ */
+export interface SketchingSystemContext {
+    readonly configuratorExtensionSelectors: ConfiguratorExtensionSelectors;
+    readonly domainContextSelectors: DomainContextSelectors;
+    readonly domainServicesSelectors: DomainServicesSelectors;
+}
+export interface GetSketchingRecipeUpdatesParams<ENTITIES extends DomainEntity<string>> {
+    position: [number, number];
+    recipes: ReadonlyArray<EntityRecipe<ENTITIES>>;
+    parentId: ENTITIES['id'];
+    collection?: string;
+}
+export interface StartSketchingParams<ENTITIES extends DomainEntity<string>> {
+    position: [number, number];
+    recipes: ReadonlyArray<EntityRecipe<ENTITIES>>;
+    parentId: ENTITIES['id'];
+    fixedDrawingPoint: 'start' | 'end';
+    sketchingKey: string;
+    collection?: string;
+}
+export interface UpdateSketchingShapeParams {
+    readonly newPosition: [number, number];
+    readonly angleSnapValue: number;
+    readonly distanceSnapValue: number;
+}
+export interface MovePointParams {
+    readonly offsetX: number;
+    readonly offsetZ: number;
+    readonly point: SketchingPoint;
+    readonly angleSnapValue: number;
+    readonly distanceSnapValue: number;
+    readonly sketchingKey: string;
+}
+/** SketchingSystem with its entity types erased — how the runtime selectors expose the instance. */
+export type AnySketchingSystem = SketchingSystem<any>;
+export declare class SketchingSystem<ENTITIES extends DomainEntity<string>> {
+    private readonly _context;
+    private readonly _state;
+    readonly state$: ObservableWithLastValue<SketchingSystemState<ENTITIES>>;
+    constructor(_context: SketchingSystemContext);
+    initialize: () => void;
+    setEmptySketchingPosition: (position: [number, number]) => void;
+    /**
+     * Prepares recipe updates and sets the initial position of the sketching point with default dimensions.
+     * This method can be used for dry running the start of the sketching via sketching recipes.
+     */
+    prepareInitialDrawingUpdates: (params: GetSketchingRecipeUpdatesParams<ENTITIES>) => {
+        updates: (import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"sketchingLine", import("#package/domain").SketchingLineComponentState, "angle" | "length" | "x" | "y">> | import("#package/domain").ComponentModification<import("#package/domain").SystemComponentType<"sketchingRectangle", import("#package/domain").SketchingRectangleComponentState, "angle" | "depth" | "width" | "x" | "y">> | import("#package/domain").DomainEntityCreation<any, any>)[];
+        entityId: any;
+    };
+    /**
+     * Starts the sketching process from a given sketching recipe.
+     */
+    startDrawing: (params: StartSketchingParams<ENTITIES>) => void;
+    /**
+     * Commits the current sketching to the store and starts sketching again from the last position of the previous shape.
+     * For rectangles, the sketching process is ended.
+     */
+    commitShape: () => void;
+    /**
+     * Updates the current sketching shape that is being drawn.
+     */
+    updateDrawnShape: (params: UpdateSketchingShapeParams) => void;
+    /**
+     * Ends the current sketching process and rolls back the staged updates. (the current shape that is not committed yet)
+     */
+    endDrawing: () => void;
+    /**
+     * Returns the updates to move a sketching point by relative offset with snapping.
+     * The sketching is transformed to the new position and the updates are returned.
+     */
+    getMoveSketchingPointUpdates: (params: MovePointParams) => StateUpdate<DomainEntity<string>, DomainEntity<string>>[];
+    /**
+     * returns updates of line's length, the sketching is automatically transformed to stay connected with other shapes
+     */
+    getLineLengthUpdates: (length: number, line: Line) => StateUpdate<DomainEntity<string>, DomainEntity<string>>[];
+    /**
+     * returns updates of rectangle's width, the sketching is automatically transformed to stay connected with other shapes
+     */
+    getRectangleWidthUpdates: (width: number, rectangle: Rectangle) => StateUpdate<DomainEntity<string>, DomainEntity<string>>[];
+    /**
+     * returns updates of rectangle's depth, the sketching is automatically transformed to stay connected with other shapes
+     */
+    getRectangleDepthUpdates: (depth: number, rectangle: Rectangle) => StateUpdate<DomainEntity<string>, DomainEntity<string>>[];
+    /**
+     * returns updates of connection's angle, the sketching is automatically transformed to stay connected with other shapes
+     */
+    getConnectionAngleUpdate: (value: number, connection: Connection, origin: Point) => StateUpdate<DomainEntity<string>, DomainEntity<string>>[];
+}
+export {};

package/dist/configurator/application-runtime/extensions/systems/sketching-system/sketching-system.js

@@ -0,0 +1 @@
+import{BehaviorSubject as t}from"rxjs";import{match as e}from"ts-pattern";import{isSketchingLineSnapshot as n,isSketchingRectangleSnapshot as o,sketchingLineComponent as a,sketchingRectangleComponent as i}from"#package/domain";import{getLineLengthUpdate as s,getLineLineConnectionUpdates as r,getLineMovementEndUpdate as h,getLineMovementStartUpdate as p,getLineRectangleBottomLeftConnectionUpdates as c,getLineRectangleBottomRightConnectionUpdates as l,getLineRectangleTopLeftConnectionUpdates as g,getLineRectangleTopRightConnectionUpdates as d,getMoveTerminalBottomLeftCornerUpdates as m,getMoveTerminalBottomRightCornerUpdates as y,getMoveTerminalLineEndPointUpdates as S,getMoveTerminalLineStartPointUpdates as w,getMoveTerminalTopLeftCornerUpdates as u,getMoveTerminalTopRightCornerUpdates as x,getRectangleBottomLeftBottomRightConnectionUpdates as f,getRectangleBottomLeftTopLeftConnectionUpdates as C,getRectangleDepthUpdate as _,getRectangleMovementEndUpdate as k,getRectangleMovementStartUpdate as v,getRectangleTopRightBottomRightConnectionUpdates as I,getRectangleTopRightTopLeftConnectionUpdates as R,getRectangleWidthUpdate as b,getSetInitialSketchingPointPositionUpdate as U,getSketchingTransformationUpdates as T,isAnySketchingPointUpdate as D}from"./sketching-updates.js";export class SketchingSystem{_context;_state=new t({emptySketchingPosition:[0,0],drawingState:null});state$=this._state;constructor(t){this._context=t,this._context.domainContextSelectors.getStoreSystem().stateSlices.committed.subscribe(t=>{this._state.value.drawingState&&("reset"!==t.kind&&t.updates.some(t=>D(t))||this.endDrawing())})}initialize=()=>{this._state.next({emptySketchingPosition:[0,0],drawingState:null})};setEmptySketchingPosition=t=>{this._state.next({...this._state.value,emptySketchingPosition:t})};prepareInitialDrawingUpdates=t=>{let{position:e,recipes:n,parentId:o,collection:s}=t,[r,h]=e,p=this._context.domainContextSelectors.getRecipeCookerSystem().prepareCreateUpdates(n,this._context.domainContextSelectors.getStoreSystem().stateSlices.committed.value.state,o,s),c=p.find(t=>t.parentId===o).entity.id,l=this._context.domainContextSelectors.getStoreSystem().prepareStateEmission(p,this._context.domainContextSelectors.getStoreSystem().stateSlices.committed.value.state,"staged"),g=this._context.domainContextSelectors.getComponentReader().readFirstComponent({entityIds:[c],componentTypes:[a,i]},l.state);if(!g)throw Error("Can not create shape recipe updates! The shape was not found in the prepared state! Check why it could not be created!");return{updates:[...p,U({x:r,y:h,component:g})],entityId:c}};startDrawing=t=>{let{position:e,recipes:n,parentId:o,fixedDrawingPoint:a,sketchingKey:i,collection:s}=t,[r,h]=e;this._context.configuratorExtensionSelectors.getCameraControlSystem().disable();let p=this.prepareInitialDrawingUpdates({position:e,recipes:n,parentId:o,collection:s}),c=this._context.domainContextSelectors.getStoreSystem().stage(p.updates);if(!c.validity.valid)throw this._context.domainServicesSelectors.getLogger().error("Can not start sketching! The shape recipe updates are not valid!",c.validity),Error("Can not start sketching! The shape recipe updates are not valid!");this._state.next({...this._state.value,drawingState:{position:[r,h],entityId:p.entityId,stagedCreateUpdates:p.updates,currentRecipes:n,currentParentId:o,currentCollection:s,fixedDrawingPoint:a,currentSketchingKey:i}})};commitShape=()=>{let t=this._state.value;if(!t.drawingState)throw Error("Can not commit shape! The sketching process is not in progress! This action should never be called while sketching is not active");this._context.domainContextSelectors.getStoreSystem().commit();let n=this._context.domainContextSelectors.getStoreSystem().stateSlices.committed.value.state,o=this._context.domainContextSelectors.getSketchingProjections().getSketching(n,t.drawingState.currentSketchingKey).shapes.find(e=>e.instance.entityId===t.drawingState?.entityId);if(!o||"rectangle"===o.type||e(t.drawingState.fixedDrawingPoint).with("start",()=>null!==o.start.connection).with("end",()=>null!==o.end.connection).exhaustive())return void this.endDrawing();let[a,i]=e(t.drawingState.fixedDrawingPoint).with("start",()=>[o.start.x,o.start.y]).with("end",()=>[o.end.x,o.end.y]).exhaustive(),s=this.prepareInitialDrawingUpdates({position:[a,i],recipes:t.drawingState.currentRecipes,parentId:t.drawingState.currentParentId,collection:t.drawingState.currentCollection});this._context.domainContextSelectors.getStoreSystem().stage(s.updates),this._state.next({...t,drawingState:{...t.drawingState,position:[a,i],entityId:s.entityId,stagedCreateUpdates:s.updates}})};updateDrawnShape=t=>{let{newPosition:s,angleSnapValue:r,distanceSnapValue:c}=t,l=this._state.value,g=this._context.domainContextSelectors.getStoreSystem().stateSlices.rendered.value.state,d=l.drawingState;if(!d)throw Error("Can not update sketching shape! The sketching process is not in progress! This action should never be called while sketching is not active");let m=this._context.domainContextSelectors.getComponentReader().readFirstComponent({entityIds:[d.entityId],componentTypes:[a,i]},g);if(!m)throw Error("Can not update sketching shape! The sketching shape was not found in the rendered state! Check why it could not be created!");let y=e(d.fixedDrawingPoint).with("start",()=>{let[t,a]=s,i=d.position[0],p=d.position[1];return e(m).when(n,e=>h({startX:t,startY:a,endX:i,endY:p,distanceSnapValue:c,angleSnapValue:r,componentInstance:e})).when(o,e=>k({startX:t,startY:a,endX:i,endY:p,distanceSnapValue:c,angleSnapValue:r,componentInstance:e})).otherwise(t=>{throw Error(`Can not update sketching shape! Unexpected sketching component type! ${t.componentInstance.componentType.name}!`)})}).with("end",()=>{let[t,a]=s,i=d.position[0],h=d.position[1];return e(m).when(n,e=>p({startX:i,startY:h,endX:t,endY:a,distanceSnapValue:c,angleSnapValue:r,componentInstance:e})).when(o,e=>v({startX:i,startY:h,endX:t,endY:a,distanceSnapValue:c,angleSnapValue:r,componentInstance:e})).otherwise(t=>{throw Error(`Can not update sketching shape! Unexpected sketching component type! ${t.componentInstance.componentType.name}!`)})}).exhaustive();this._context.domainContextSelectors.getStoreSystem().stage([...d.stagedCreateUpdates,y])};endDrawing=()=>{this._context.configuratorExtensionSelectors.getCameraControlSystem().enable(),this._state.next({...this._state.value,drawingState:null}),this._context.domainContextSelectors.getStoreSystem().rollback()};getMoveSketchingPointUpdates=t=>{let{offsetX:n,offsetZ:o,point:a,angleSnapValue:i,distanceSnapValue:s}=t;return e(a.connection).returnType().with(null,()=>e(a).with({shape:{type:"line"}},t=>e(t.type).with("line-start",()=>w({x:n,y:o},t.shape,s,i)).with("line-end",()=>S({x:n,y:o},t.shape,s,i)).exhaustive()).with({shape:{type:"rectangle"}},t=>e(t.type).with("rectangle-top-left",()=>u({x:n,y:o},t.shape,s,i)).with("rectangle-top-right",()=>x({x:n,y:o},t.shape,s,i)).with("rectangle-bottom-left",()=>m({x:n,y:o},t.shape,s,i)).with("rectangle-bottom-right",()=>y({x:n,y:o},t.shape,s,i)).exhaustive()).exhaustive()).otherwise(t=>e(t).with({from:{shape:{type:"line"}},to:{shape:{type:"line"}}},t=>r({fromLine:t.from.shape,toLine:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"line"}},to:{shape:{type:"rectangle"},type:"rectangle-top-left"}},t=>g({fromLine:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"line"}},to:{shape:{type:"rectangle"},type:"rectangle-bottom-right"}},t=>l({fromLine:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-bottom-left"},to:{shape:{type:"line"}}},t=>c({fromRectangle:t.from.shape,toLine:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-top-right"},to:{shape:{type:"line"}}},t=>d({fromRectangle:t.from.shape,toLine:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-bottom-left"},to:{shape:{type:"rectangle"},type:"rectangle-top-left"}},t=>C({fromRectangle:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-top-right"},to:{shape:{type:"rectangle"},type:"rectangle-bottom-right"}},t=>I({fromRectangle:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-top-right"},to:{shape:{type:"rectangle"},type:"rectangle-top-left"}},t=>R({fromRectangle:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).with({from:{shape:{type:"rectangle"},type:"rectangle-bottom-left"},to:{shape:{type:"rectangle"},type:"rectangle-bottom-right"}},t=>f({fromRectangle:t.from.shape,toRectangle:t.to.shape,offsetX:n,offsetZ:o,distanceSnapValue:s,angleSnapValue:i})).otherwise(t=>{throw Error(`Can not move connection sketching point. Unknown connection type encountered. From shape ${t.from.shape.type} to shape ${t.to.shape.type}!`)}))};getLineLengthUpdates=(t,e)=>{let n=(t-e.length)*Math.cos(e.angle),o=(e.length-t)*Math.sin(e.angle),a=[s({length:t,line:e})];return a.push(...T(e,[e.end.connection?.to.shape],{x:n,y:o,angle:null})),a};getRectangleWidthUpdates=(t,e)=>{let n=(t-e.width)*Math.cos(e.angle),o=(e.width-t)*Math.sin(e.angle),a=[b({width:t,rectangle:e})];return a.push(...T(e,[e.topRight.connection?.to.shape,e.bottomRight.connection?.from.shape],{x:n,y:o,angle:null})),a};getRectangleDepthUpdates=(t,e)=>{let n=(e.depth-t)*Math.sin(e.angle),o=(t-e.depth)*Math.cos(e.angle),a=[_({depth:t,rectangle:e})];return a.push(...T(e,[e.bottomLeft.connection?.to.shape,e.bottomRight.connection?.from.shape],{x:n,y:o,angle:null})),a};getConnectionAngleUpdate=(t,e,n)=>{let o=e.from.shape,a=e.to.shape;if(!a||!o)return[];let i=[];return i.push(...T(o,[a],{x:0,y:0,angle:{value:t-e.angle,origin:n}})),i}}