@salsita-ai/sdk 0.50.0-develop.ae52227c7e → 0.50.0-develop.ae9a830ef0

package/dist/domain/extensions/fit-selection-orthographic-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitSelectionOrthographicCameraComponentName="fitSelectionOrthographicCamera";export const fitSelectionOrthographicCameraComponent=e.component("fitSelectionOrthographicCamera").withState({type:"object",tsType:"FitSelectionOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitSelectionOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitToBox:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},left:{type:"number"},bottom:{type:"number"},frustumSize:{type:"number"},near:{type:"number"},far:{type:"number"},focus:{type:"number"},distance:{type:"number"},minDistance:{type:"number"},maxDistance:{type:"number"},minZoom:{type:"number"},maxZoom:{type:"number"},polarAngle:{type:"number"},minPolarAngle:{type:"number"},maxPolarAngle:{type:"number"},azimuthAngle:{type:"number"},minAzimuthAngle:{type:"number"},maxAzimuthAngle:{type:"number"},smoothTime:{type:"number"},draggingSmoothTime:{type:"number"},maxSpeed:{type:"number"},azimuthRotateSpeed:{type:"number"},polarRotateSpeed:{type:"number"},dollySpeed:{type:"number"},dollyDragInverted:{type:"boolean"},truckSpeed:{type:"number"},mouseButtons:{type:"object",properties:{left:{type:"number"},middle:{type:"number"},right:{type:"number"},wheel:{type:"number"}},required:["left","middle","right"],additionalProperties:!1},touches:{type:"object",properties:{one:{type:"number"},two:{type:"number"},three:{type:"number"}},required:["one","two"],additionalProperties:!1},boundaryEnclosesCamera:{type:"boolean"},dollyToCursor:{type:"boolean"},dragToOffset:{type:"boolean"},verticalDragToForward:{type:"boolean"},boundary:{type:"object"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isFitSelectionOrthographicCameraComponent=t(fitSelectionOrthographicCameraComponent);
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitSelectionOrthographicCameraComponentName="fitSelectionOrthographicCamera";export const fitSelectionOrthographicCameraComponent=e.component("fitSelectionOrthographicCamera").withState({type:"object",tsType:"FitSelectionOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitSelectionOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitToBox:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},left:{type:"number"},bottom:{type:"number"},frustumSize:{type:"number"},near:{type:"number"},far:{type:"number"},distance:{type:"number"},minDistance:{type:"number"},maxDistance:{type:"number"},minZoom:{type:"number"},maxZoom:{type:"number"},polarAngle:{type:"number"},minPolarAngle:{type:"number"},maxPolarAngle:{type:"number"},azimuthAngle:{type:"number"},minAzimuthAngle:{type:"number"},maxAzimuthAngle:{type:"number"},smoothTime:{type:"number"},draggingSmoothTime:{type:"number"},maxSpeed:{type:"number"},azimuthRotateSpeed:{type:"number"},polarRotateSpeed:{type:"number"},dollySpeed:{type:"number"},dollyDragInverted:{type:"boolean"},truckSpeed:{type:"number"},mouseButtons:{type:"object",properties:{left:{type:"number",enum:[0,1,2,4,8,16]},middle:{type:"number",enum:[0,1,2,4,8,16]},right:{type:"number",enum:[0,1,2,4,8,16]},wheel:{type:"number",enum:[0,1,2,4,8,16]}},required:["left","middle","right","wheel"],additionalProperties:!1},touches:{type:"object",properties:{one:{type:"number",enum:[0,8,16,32,64,128]},two:{type:"number",enum:[0,32,64,128,256,512,1024,2048,4096,8192,16384,32768]},three:{type:"number",enum:[0,32,64,128,256,512,1024,2048,4096,8192,16384,32768]}},required:["one","two","three"],additionalProperties:!1},boundaryEnclosesCamera:{type:"boolean"},dollyToCursor:{type:"boolean"},dragToOffset:{type:"boolean"},verticalDragToForward:{type:"boolean"},boundary:{type:"object"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isFitSelectionOrthographicCameraComponent=t(fitSelectionOrthographicCameraComponent);

package/dist/domain/extensions/fit-selection-perspective-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitSelectionPerspectiveCameraComponentName="fitSelectionPerspectiveCamera";export const fitSelectionPerspectiveCameraComponent=e.component("fitSelectionPerspectiveCamera").withState({type:"object",tsType:"FitSelectionPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitSelectionPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitToBox:{type:"boolean"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fov:{type:"number"},far:{type:"number"},near:{type:"number"},focus:{type:"number"},distance:{type:"number"},minDistance:{type:"number"},maxDistance:{type:"number"},polarAngle:{type:"number"},minPolarAngle:{type:"number"},maxPolarAngle:{type:"number"},azimuthAngle:{type:"number"},minAzimuthAngle:{type:"number"},maxAzimuthAngle:{type:"number"},smoothTime:{type:"number"},draggingSmoothTime:{type:"number"},maxSpeed:{type:"number"},azimuthRotateSpeed:{type:"number"},polarRotateSpeed:{type:"number"},dollySpeed:{type:"number"},dollyDragInverted:{type:"boolean"},truckSpeed:{type:"number"},mouseButtons:{type:"object",properties:{left:{type:"number"},middle:{type:"number"},right:{type:"number"},wheel:{type:"number"}},required:["left","middle","right"],additionalProperties:!1},touches:{type:"object",properties:{one:{type:"number"},two:{type:"number"},three:{type:"number"}},required:["one","two"],additionalProperties:!1},boundaryEnclosesCamera:{type:"boolean"},dollyToCursor:{type:"boolean"},dragToOffset:{type:"boolean"},verticalDragToForward:{type:"boolean"},boundary:{type:"object"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isFitSelectionPerspectiveCameraComponent=t(fitSelectionPerspectiveCameraComponent);
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitSelectionPerspectiveCameraComponentName="fitSelectionPerspectiveCamera";export const fitSelectionPerspectiveCameraComponent=e.component("fitSelectionPerspectiveCamera").withState({type:"object",tsType:"FitSelectionPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitSelectionPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitToBox:{type:"boolean"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fov:{type:"number"},far:{type:"number"},near:{type:"number"},focus:{type:"number"},distance:{type:"number"},minDistance:{type:"number"},maxDistance:{type:"number"},polarAngle:{type:"number"},minPolarAngle:{type:"number"},maxPolarAngle:{type:"number"},azimuthAngle:{type:"number"},minAzimuthAngle:{type:"number"},maxAzimuthAngle:{type:"number"},smoothTime:{type:"number"},draggingSmoothTime:{type:"number"},maxSpeed:{type:"number"},azimuthRotateSpeed:{type:"number"},polarRotateSpeed:{type:"number"},dollySpeed:{type:"number"},dollyDragInverted:{type:"boolean"},truckSpeed:{type:"number"},mouseButtons:{type:"object",properties:{left:{type:"number",enum:[0,1,2,4,8,16]},middle:{type:"number",enum:[0,1,2,4,8,16]},right:{type:"number",enum:[0,1,2,4,8,16]},wheel:{type:"number",enum:[0,1,2,4,8,16]}},required:["left","middle","right","wheel"],additionalProperties:!1},touches:{type:"object",properties:{one:{type:"number",enum:[0,8,16,32,64,128]},two:{type:"number",enum:[0,32,64,128,256,512,1024,2048,4096,8192,16384,32768]},three:{type:"number",enum:[0,32,64,128,256,512,1024,2048,4096,8192,16384,32768]}},required:["one","two","three"],additionalProperties:!1},boundaryEnclosesCamera:{type:"boolean"},dollyToCursor:{type:"boolean"},dragToOffset:{type:"boolean"},verticalDragToForward:{type:"boolean"},boundary:{type:"object"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isFitSelectionPerspectiveCameraComponent=t(fitSelectionPerspectiveCameraComponent);

package/dist/domain/extensions/horizontal-tabs.d.ts

@@ -12,13 +12,13 @@ export interface HorizontalTab {
     /**
      * List of navigation states when the tab is active. First one will be used for activation.
      */
-    readonly navigationStates: string[];
+    readonly navigationStates: readonly string[];
 }
 export type HorizontalTabsComponentState = {
     /**
      * List of tabs in the horizontal tabs.
      */
-    readonly tabs: HorizontalTab[];
+    readonly tabs: readonly HorizontalTab[];
 };
 export declare const horizontalTabsComponent: import("../index.js").SystemComponentType<"horizontalTabs", HorizontalTabsComponentState, never>;
 export type HorizontalTabsComponent = typeof horizontalTabsComponent;

package/dist/domain/extensions/list-selector-dimension-indicator.d.ts

@@ -10,7 +10,7 @@ export type ListSelectorDimensionIndicatorComponentState = DimensionIndicatorSta
     /**
      * An array of fixable violations. They will be ignored in the violation hint.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * The title of the modal.
      */

package/dist/domain/extensions/navigation-steps.d.ts

@@ -7,13 +7,13 @@ export interface NavigationStep {
     /**
      * List of navigation states when the tab is active. First one will be used for activation.
      */
-    readonly navigationStates: string[];
+    readonly navigationStates: readonly string[];
 }
 export type NavigationStepsComponentState = {
     /**
      * List of steps in the top navigation.
      */
-    readonly steps: NavigationStep[];
+    readonly steps: readonly NavigationStep[];
 };
 export declare const navigationStepsComponent: import("../index.js").SystemComponentType<"navigationSteps", NavigationStepsComponentState, never>;
 export type NavigationStepsComponent = typeof navigationStepsComponent;

package/dist/domain/extensions/offset-indicator.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";import{DimensionUnitSchema as n,UnitsConfigSchema as r}from"../dimensions/index.js";import{DimensionIndicatorBaseProperties as i}from"./common/index.js";export const offsetIndicatorComponent=e.component("offsetIndicator").withState({tsType:"OffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"OffsetIndicatorComponentState"}],type:"object",properties:{...i,targetEntityOffsetAnchors:{type:"array",items:{type:"string"}},targetReferenceOffsetAnchors:{type:"array",items:{type:"string"}},referenceEntityIds:{type:"array",items:{type:"string"}},directionVector:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},additionalProperties:!1},directionVectorRelativeToEntityId:{type:"string"},maxDistance:{type:["number","null"]},minDistance:{type:["number","null"]},maxPerpendicularDistance:{type:["number","null"]},minPerpendicularDistance:{type:["number","null"]},visible:{type:"boolean"},force:{type:"boolean"},displayUnit:n,unitDisplayConfig:r},required:["targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isOffsetIndicatorSnapshot=t(offsetIndicatorComponent);
+import{DomainEntityIdSchema as e,SystemComponentBuilder as t,isSnapshotOfComponentType as n}from"../core/index.js";import{DimensionUnitSchema as r,UnitsConfigSchema as o}from"../dimensions/index.js";import{DimensionIndicatorBaseProperties as i}from"./common/index.js";export const offsetIndicatorComponent=t.component("offsetIndicator").withState({tsType:"OffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"OffsetIndicatorComponentState"}],type:"object",properties:{...i,targetEntityOffsetAnchors:{type:"array",items:{type:"string"}},targetReferenceOffsetAnchors:{type:"array",items:{type:"string"}},referenceEntityIds:{type:["array","null"],items:e},directionVector:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},additionalProperties:!1},directionVectorRelativeToEntityId:{anyOf:[e,{type:"null"}]},maxDistance:{type:["number","null"]},minDistance:{type:["number","null"]},maxPerpendicularDistance:{type:["number","null"]},minPerpendicularDistance:{type:["number","null"]},visible:{type:"boolean"},force:{type:"boolean"},displayUnit:r,unitDisplayConfig:o},required:["targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isOffsetIndicatorSnapshot=n(offsetIndicatorComponent);

package/dist/domain/extensions/rotation-handle.d.ts

@@ -1,8 +1,8 @@
 export type RotatableSurface = {
     /**
-     * Unique identifier for the surface.
+     * Identifier of the surface.
      */
-    readonly key: string;
+    readonly key?: string;
     /**
      * The widget rotation axis in normal form. Usually corresponds to the target object's rotation axis.
      */

package/dist/domain/extensions/save-template-thumbnail.d.ts

@@ -1,10 +1,10 @@
-import { type Color } from '@salsita-ai/common/utils';
+import { type HexColor } from '@salsita-ai/common/utils';
 export type SaveTemplateThumbnailComponentState = {
     readonly exportState: string;
     readonly width: number;
     readonly height: number;
     readonly fileFormat: 'PNG' | 'JPEG';
-    readonly backgroundColor?: Color;
+    readonly backgroundColor?: HexColor;
     readonly toolState: string;
     readonly viewState: string;
     readonly navigationState: string;

package/dist/domain/extensions/save-template-thumbnail.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const saveTemplateThumbnailComponent=t.component("saveTemplateThumbnail").withState({type:"object",tsType:"SaveTemplateThumbnailComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SaveTemplateThumbnailComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$"},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isSaveTemplateThumbnailComponentSnapshot=e(saveTemplateThumbnailComponent);
+import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const saveTemplateThumbnailComponent=t.component("saveTemplateThumbnail").withState({type:"object",tsType:"SaveTemplateThumbnailComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SaveTemplateThumbnailComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$",tsType:"HexColor",import:[{module:"@salsita-ai/sdk/common/utils",member:"HexColor"}]},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isSaveTemplateThumbnailComponentSnapshot=e(saveTemplateThumbnailComponent);

package/dist/domain/extensions/scene-entity-animation.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../core/index.js";export const sceneEntityAnimationComponent=e.component("sceneEntityAnimation").withState({type:"object",tsType:"SceneEntityAnimationComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityAnimationComponentState"}],properties:{fileUrl:{type:"string"},name:{type:"string"},type:{type:"string"},timeScale:{type:"number"}},required:["fileUrl","name","timeScale","type"],additionalProperties:!1}).build();
+import{SystemComponentBuilder as e}from"../core/index.js";export const sceneEntityAnimationComponent=e.component("sceneEntityAnimation").withState({type:"object",tsType:"SceneEntityAnimationComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityAnimationComponentState"}],properties:{fileUrl:{type:"string"},name:{type:"string"},type:{type:"string",enum:["reversable"]},timeScale:{type:"number"}},required:["fileUrl","name","timeScale","type"],additionalProperties:!1}).build();

package/dist/domain/mocks/create-mock-domain-context.d.ts

@@ -5,7 +5,7 @@ export interface MockTransformer<ENTITIES extends DomainEntity<string>, ALLOWED_
     transformer: RegistrableTransformer<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>;
     priority?: number;
 }
-export declare const createMockDomainContext: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, CHAT_CONTEXT extends Record<string, unknown>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>, ADMIN_NAVIGATION_STATES extends string, ADMIN_VIEW_STATES extends string>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, CHAT_CONTEXT, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>, mocks: {
+export declare const createMockDomainContext: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, any, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, any, any, any, any, any>, mocks: {
     frontendData: FRONTEND_DATA;
     publishedData: PUBLISHED_DATA;
     sessionData: SESSION_DATA;

package/dist/domain/mocks/create-mock-domain-runtime.d.ts

@@ -1,3 +1,4 @@
+import { AccessLevel } from '@salsita-ai/contracts/api';
 import type { ApplicationConfig } from '../application/index.js';
 import type { $DomainEntity, DomainEntity } from '../core/index.js';
 import type { RegistrableTransformer } from '../domain-context/index.js';
@@ -15,7 +16,7 @@ import type { RegistrableTransformer } from '../domain-context/index.js';
  *
  * Contributing no extension systems is the same shape webhook and finalize hosts run in.
  */
-export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, CHAT_CONTEXT extends Record<string, unknown>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>, ADMIN_NAVIGATION_STATES extends string, ADMIN_VIEW_STATES extends string>(config: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, CHAT_CONTEXT, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>, mocks: {
+export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>>(config: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, any, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, any, any, any, any, any>, mocks: {
     frontendData: FRONTEND_DATA;
     publishedData: PUBLISHED_DATA;
     sessionData: SESSION_DATA;
@@ -268,24 +269,28 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
         access: {
             selectConfiguratorRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("../index.js").AccessSelectorState, {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectAdminRawAccessInfo: import("@salsita-ai/common/utils").Selector<import("../index.js").AccessSelectorState, {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null>;
             selectConfiguratorAccessInfo: import("@salsita-ai/common/utils").Selector<import("../index.js").AccessSelectorState, {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             }>;
             selectAdminAccessInfo: import("@salsita-ai/common/utils").Selector<import("../index.js").AccessSelectorState, {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -298,24 +303,28 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
             selectAdminConfigurationId: import("@salsita-ai/common/utils").Selector<import("../index.js").AccessSelectorState, string>;
             getConfiguratorRawAccessInfo: () => {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getAdminRawAccessInfo: () => {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             } | null;
             getConfiguratorAccessInfo: () => {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
             };
             getAdminAccessInfo: () => {
                 raw: string;
+                access: AccessLevel;
                 viewMode: boolean;
                 revisionId: string | undefined;
                 configurationId: string;
@@ -361,9 +370,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -403,9 +412,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getMigrate: () => import("../index.js").MigrateFunction<DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };
@@ -470,9 +479,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 selectIsViewMode: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, boolean>;
                 selectInitializationState: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").DomainContextInitializationState>;
                 selectComponentOptics: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly import("../index.js").AnyDomainComponentOptic[]>;
-                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ComponentReaderIndexes<any, any, any, any, any>>;
+                selectComponentReaderIndexes: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ComponentReaderIndexes>;
                 selectStoreRuntimeDependencies: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, {
-                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 }>;
@@ -512,9 +521,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getMigrate: () => import("../index.js").MigrateFunction<DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
-                getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
-                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes<any, any, any, any, any>;
+                    componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
                     domainExpressions: import("../index.js").AnyExpressions;
                     allowedRootEntityTypes: import("../index.js").AnyAllowedRootEntityTypes;
                 };

package/dist/domain/mocks/create-mock-domain-runtime.js

@@ -1 +1 @@
-import{createDomainRuntime as o}from"../domain-runtime/index.js";import{createMockDomainRuntimeServices as t}from"./create-mock-domain-runtime-services.js";import{createMockSessionContext as e}from"./create-mock-session-context.js";export const createMockDomainRuntime=(a,i)=>{let{sessionData:n,mode:r,role:s}=i,c=o({config:a,services:t()}),m=c.getState().spec;return c.actions.spec.updateSpec({...m,configurator:{...m.configurator,createTransformers:o=>i.transformers.map(t=>t.transformer.register(o,t.priority??1/0))}}),c.actions.sessionContext.setSessionContext(e(s,n)),c.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",viewMode:"read"===r,revisionId:void 0,configurationId:"mock"}),c.actions.domainData.setDomainData({publishedData:i.publishedData,frontendData:i.frontendData,backendData:i.backendData}),c.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:i.entities,modelVersion:a.domain.domainFactory.modelVersion,rootEntityType:i.rootEntityType,schemaIdentity:a.domain.domainFactory}),c};
+import{AccessLevel as t}from"@salsita-ai/contracts/api";import{createDomainRuntime as e}from"../domain-runtime/index.js";import{createMockDomainRuntimeServices as o}from"./create-mock-domain-runtime-services.js";import{createMockSessionContext as a}from"./create-mock-session-context.js";export const createMockDomainRuntime=(i,n)=>{let{sessionData:r,mode:s,role:c}=n,m=e({config:i,services:o()}),d=m.getState().spec;return m.actions.spec.updateSpec({...d,configurator:{...d.configurator,createTransformers:t=>n.transformers.map(e=>e.transformer.register(t,e.priority??1/0))}}),m.actions.sessionContext.setSessionContext(a(c,r)),m.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===s?t.Read:t.Owner,viewMode:"read"===s,revisionId:void 0,configurationId:"mock"}),m.actions.domainData.setDomainData({publishedData:n.publishedData,frontendData:n.frontendData,backendData:n.backendData}),m.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:n.entities,modelVersion:i.domain.domainFactory.modelVersion,rootEntityType:n.rootEntityType,schemaIdentity:i.domain.domainFactory}),m};

package/dist/domain/mocks/create-mock-domain.d.ts

@@ -1,6 +1,6 @@
 import type { ApplicationConfig } from '../application/index.js';
 import type { $DomainEntity, Domain, DomainEntity, DomainMode } from '../core/index.js';
-export declare const createMockDomain: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, CHAT_CONTEXT extends Record<string, unknown>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>, ADMIN_NAVIGATION_STATES extends string, ADMIN_VIEW_STATES extends string>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, CHAT_CONTEXT, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>, mocks: {
+export declare const createMockDomain: <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>>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, any, any, any, any, any, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, any, any, any, any, any>, mocks: {
     frontendData: FRONTEND_DATA;
     publishedData: PUBLISHED_DATA;
     sessionData: SESSION_DATA;

package/dist/domain/mocks/create-mock-domain.js

@@ -1 +1 @@
-import{createDomainRuntime as o}from"../domain-runtime/index.js";import{createMockDomainRuntimeServices as e}from"./create-mock-domain-runtime-services.js";import{createMockSessionContext as t}from"./create-mock-session-context.js";export const createMockDomain=(i,n)=>{let{frontendData:s,publishedData:a,sessionData:c,backendData:r,mode:m,role:d}=n,f=o({config:i,services:e()});return f.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",viewMode:"read"===m,revisionId:void 0,configurationId:"mock-configuration"}),"finalize"===m&&f.actions.domainContext.configurator.setExecutionMode("finalize"),f.actions.domainData.setDomainData({publishedData:a,frontendData:s,backendData:r}),f.actions.sessionContext.setSessionContext(t(d,c)),f.selectors.domainContext.configurator.getDomain()};
+import{AccessLevel as o}from"@salsita-ai/contracts/api";import{createDomainRuntime as e}from"../domain-runtime/index.js";import{createMockDomainRuntimeServices as t}from"./create-mock-domain-runtime-services.js";import{createMockSessionContext as i}from"./create-mock-session-context.js";export const createMockDomain=(n,a)=>{let{frontendData:s,publishedData:c,sessionData:r,backendData:m,mode:d,role:f}=a,u=e({config:n,services:t()});return u.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===d?o.Read:o.Owner,viewMode:"read"===d,revisionId:void 0,configurationId:"mock-configuration"}),"finalize"===d&&u.actions.domainContext.configurator.setExecutionMode("finalize"),u.actions.domainData.setDomainData({publishedData:c,frontendData:s,backendData:m}),u.actions.sessionContext.setSessionContext(i(f,r)),u.selectors.domainContext.configurator.getDomain()};

package/dist/domain/mocks/create-mock-state.d.ts

@@ -1,6 +1,6 @@
 import type { ApplicationConfig } from '../application/index.js';
-import type { $DomainEntity, DomainEntity, DomainState } from '../core/index.js';
-export declare const createMockState: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string, CHAT_CONTEXT extends Record<string, unknown>, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, ADMIN_ENTITIES extends DomainEntity<string>, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>>, ADMIN_NAVIGATION_STATES extends string, ADMIN_VIEW_STATES extends string>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, CHAT_CONTEXT, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>, mocks: {
+import type { DomainEntity, DomainState } from '../core/index.js';
+export declare const createMockState: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES>(cfg: ApplicationConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, any, any, any, any, any, any, any, any, any, any, any, any, any, any>, mocks: {
     entities: ENTITIES[];
     rootEntityType: ALLOWED_ROOT_ENTITIES['type'];
 }) => DomainState<ENTITIES>;

package/dist/domain/mocks/create-test-application-config.d.ts

@@ -0,0 +1,59 @@
+import type { TransformersConfig } from '../application/index.js';
+import type { ProjectModule } from '../domain-runtime/index.js';
+/**
+ * What a project's test adds to its generated application before it builds the config.
+ *
+ * Each option names a part of the application config: the test states what it wants in the
+ * application, not how the application is assembled.
+ */
+export interface TestApplicationOptions {
+    /**
+     * Component files added after the components the generated application already has, for example
+     * the `customComponentOptics` of `.phoenix/configurator-domain-code.js`, which the configurator and
+     * the webhooks add to the domain the generated `configuratorBuilder` describes.
+     */
+    readonly componentModules?: readonly ProjectModule[];
+    /**
+     * The transformers of the application: the `src/transformers/` files the test runs, and the
+     * entries of the spec's `transformers` section that select and order them. Replaces the
+     * transformers the generated application has.
+     */
+    readonly transformers?: TransformersConfig;
+    /**
+     * The tag of the custom element the application mounts as. Without it the config keeps the tag of
+     * the generated application, which is `salsita-configurator` unless the application names another.
+     */
+    readonly tag?: string;
+}
+/**
+ * The shape of a generated application export (`configuratorBuilder` of `.phoenix/domain.js`,
+ * `configuratorConfig` of `.phoenix/configurator-config.js`) that the helper reads. `CONFIG` is the
+ * application config the export builds, with the project's types, so the result needs no type argument.
+ */
+interface GeneratedApplication<CONFIG> {
+    withComponentOptics(componentModules: readonly ProjectModule[]): GeneratedApplication<CONFIG>;
+    withTransformers(importedTransformers: TransformersConfig['importedTransformers'], specTransformers: TransformersConfig['specTransformers']): GeneratedApplication<CONFIG>;
+    withWebComponentTag(tag: string): GeneratedApplication<CONFIG>;
+    buildConfig(): CONFIG;
+}
+/**
+ * Builds the application config of a project for its tests, from the generated application export
+ * the test imports and the parts the test adds. The config carries the project's types, so it goes
+ * straight into `createDomainRuntime`, `createMockDomainContext`, `createMockState` or a mounted
+ * custom element, and its `initialPublishedData`, `domain.presets` and domain factories are the ones
+ * the deployed application starts with.
+ *
+ * This is the way a project's test builds its application. Its call does not depend on how the SDK
+ * assembles an application, so a test written against it needs no change when that assembly changes.
+ *
+ * @example
+ * const config = createTestApplicationConfig(configuratorBuilder, {
+ *   componentModules: customComponentOptics,
+ *   transformers: {
+ *     importedTransformers: [{ origin: 'src/transformers/add-cooking-top.ts', exports: addCookingTop }],
+ *     specTransformers: [{ name: 'addCookingTop', priority: 30 }],
+ *   },
+ * })
+ */
+export declare const createTestApplicationConfig: <CONFIG>(application: GeneratedApplication<CONFIG>, options?: TestApplicationOptions) => CONFIG;
+export {};

package/dist/domain/mocks/create-test-application-config.js

@@ -0,0 +1 @@
+export const createTestApplicationConfig=(e,o={})=>{let{componentModules:r,transformers:t,tag:n}=o,i=e;return r&&(i=i.withComponentOptics(r)),t&&(i=i.withTransformers(t.importedTransformers,t.specTransformers)),void 0!==n&&(i=i.withWebComponentTag(n)),i.buildConfig()};

package/dist/domain/mocks/index.d.ts

@@ -4,3 +4,4 @@ export { createMockDomainContext, type MockTransformer } from './create-mock-dom
 export { createMockDomainRuntime } from './create-mock-domain-runtime.js';
 export { createMockSessionContext } from './create-mock-session-context.js';
 export { createMockDomainRuntimeServices } from './create-mock-domain-runtime-services.js';
+export { type TestApplicationOptions, createTestApplicationConfig } from './create-test-application-config.js';

package/dist/domain/mocks/index.js

@@ -1 +1 @@
-export{createMockDomain}from"./create-mock-domain.js";export{createMockState}from"./create-mock-state.js";export{createMockDomainContext}from"./create-mock-domain-context.js";export{createMockDomainRuntime}from"./create-mock-domain-runtime.js";export{createMockSessionContext}from"./create-mock-session-context.js";export{createMockDomainRuntimeServices}from"./create-mock-domain-runtime-services.js";
+export{createMockDomain}from"./create-mock-domain.js";export{createMockState}from"./create-mock-state.js";export{createMockDomainContext}from"./create-mock-domain-context.js";export{createMockDomainRuntime}from"./create-mock-domain-runtime.js";export{createMockSessionContext}from"./create-mock-session-context.js";export{createMockDomainRuntimeServices}from"./create-mock-domain-runtime-services.js";export{createTestApplicationConfig}from"./create-test-application-config.js";

package/dist/domain/projections/blender-projections/camera.d.ts

@@ -8,4 +8,4 @@ export interface BlenderCameraProjectionContext {
     readonly dimensionSystem: Pick<AnyDimensionSystem, 'getDataDistanceUnit'>;
     readonly positionProjections: Pick<AnyPositionProjections, 'getEntityWorldMatrix'>;
 }
-export declare const projectBlenderCamera: <ENTITIES extends DomainEntity<string>>(state: DomainState<ENTITIES>, imageSize: BlenderImageSize, context: BlenderCameraProjectionContext) => BlenderCamera;
+export declare const projectBlenderCamera: (state: DomainState<DomainEntity<string>>, imageSize: BlenderImageSize, context: BlenderCameraProjectionContext) => BlenderCamera;

package/dist/domain/system-components/application-config.d.ts

@@ -38,7 +38,7 @@ export type ApplicationConfigComponentState = {
     /**
      * Array of available dimensions in the application. It will be possible to select them in toolbar if more than one is available.
      */
-    readonly availableDimensions?: DimensionUnit[];
+    readonly availableDimensions?: readonly DimensionUnit[];
     /**
      * When true, the sidebar will be split, it will show the tabs and the header, otherwise it will not.
      *
@@ -83,7 +83,7 @@ export type ApplicationConfigComponentState = {
     /**
      * Locales that user can select in the language switcher. Default ['en'].
      */
-    readonly availableLocales?: string[];
+    readonly availableLocales?: readonly string[];
     /**
      * Initial state of dimension indicators. Default false.
      */

package/dist/domain/system-components/child-entity-selection.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{SystemComponentBuilder as t}from"../core/index.js";import{recipeSchema as i}from"./common/recipes.js";export const childEntitySelectionComponent=t.component("childEntitySelection").withState({type:"object",tsType:"ChildEntitySelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntitySelectionComponentState"}],properties:{value:{type:"string"},options:{type:"array",items:{type:"object",properties:{label:e,description:e,img:e,recipes:{type:"array",items:i},keepChildren:{type:"boolean"}},required:["recipes","label"],additionalProperties:!0}}},required:["value","options"],additionalProperties:!1}).build();
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as t,SystemComponentBuilder as i}from"../core/index.js";import{recipeSchema as o}from"./common/recipes.js";export const childEntitySelectionComponent=i.component("childEntitySelection").withState({type:"object",tsType:"ChildEntitySelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntitySelectionComponentState"}],properties:{value:t,options:{type:"array",items:{type:"object",properties:{label:e,description:e,img:e,recipes:{type:"array",items:o},keepChildren:{type:"boolean"}},required:["recipes","label"],additionalProperties:!0}}},required:["value","options"],additionalProperties:!1}).build();

package/dist/domain/system-components/collision-box-geometry.d.ts

@@ -1,4 +1,3 @@
-import type { Color } from '@salsita-ai/common/utils';
 import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Axis-aligned box collision geometry, authored via per-axis start/end
@@ -14,7 +13,10 @@ export type CollisionBoxGeometryComponentState = {
     readonly endY: number;
     readonly startZ: number;
     readonly endZ: number;
-    readonly color: Color;
+    /**
+     * Colour of the collision mesh's wireframe material, any CSS colour string that three.js `Color` accepts.
+     */
+    readonly color: string;
 };
 export declare const collisionBoxGeometryComponent: import("../index.js").SystemComponentType<"collisionBoxGeometry", CollisionBoxGeometryComponentState, never>;
 export type CollisionBoxGeometryComponent = typeof collisionBoxGeometryComponent;

package/dist/domain/system-components/collision-geometry.d.ts

@@ -1,4 +1,3 @@
-import type { Color } from '@salsita-ai/common/utils';
 import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Mesh-backed collision geometry. The caller supplies a pre-built
@@ -10,7 +9,10 @@ import { type ComponentSnapshot } from '../core/index.js';
  */
 export type CollisionGeometryComponentState = {
     readonly geometry: THREE.BufferGeometry;
-    readonly color: Color;
+    /**
+     * Colour of the collision mesh's wireframe material, any CSS colour string that three.js `Color` accepts.
+     */
+    readonly color: string;
 };
 export declare const collisionGeometryComponent: import("../index.js").SystemComponentType<"collisionGeometry", CollisionGeometryComponentState, never>;
 export type CollisionGeometryComponent = typeof collisionGeometryComponent;

package/dist/domain/system-components/collision-point-geometry.d.ts

@@ -1,4 +1,3 @@
-import type { Color } from '@salsita-ai/common/utils';
 import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Zero-volume point collision geometry at a local `(x, y, z)`. Authored
@@ -12,7 +11,10 @@ export type CollisionPointGeometryComponentState = {
     readonly x: number;
     readonly y: number;
     readonly z: number;
-    readonly color: Color;
+    /**
+     * Colour of the collision mesh's wireframe material, any CSS colour string that three.js `Color` accepts.
+     */
+    readonly color: string;
 };
 export declare const collisionPointGeometryComponent: import("../index.js").SystemComponentType<"collisionPointGeometry", CollisionPointGeometryComponentState, never>;
 export type CollisionPointGeometryComponent = typeof collisionPointGeometryComponent;

package/dist/domain/system-components/common/material-override-schema.d.ts

@@ -100,8 +100,8 @@ export type MaterialOverrideBaseState = {
     clearcoatRoughnessMapUrl?: string | null | undefined;
     /** URL of the iridescence map texture. */
     iridescenceMapUrl?: string | null | undefined;
-    /** Range of iridescence thickness. */
-    iridescenceThicknessRange?: [number, number] | undefined;
+    /** Range of iridescence thickness: the minimum and the maximum, two numbers. */
+    iridescenceThicknessRange?: readonly number[] | undefined;
     /** URL of the iridescence thickness map texture. */
     iridescenceThicknessMapUrl?: string | null | undefined;
     /** URL of the sheen color map texture. */

package/dist/domain/system-components/common/recipes.d.ts

@@ -1,5 +1,5 @@
 import { type Localizable } from '@salsita-ai/common/utils';
-import type { DomainEntity, EntityRecipe } from '../../core/index.js';
+import { type DomainEntity, type EntityRecipe } from '../../core/index.js';
 export interface RecipeListItem {
     /**
      * Stable identifier of the recipe within its list, independent of the language and of the title.
@@ -29,8 +29,17 @@ export declare const recipeSchema: {
         readonly type: {
             readonly type: 'string';
         };
+        readonly id: {
+            readonly type: 'string';
+            readonly pattern: '^[A-Z]\\w*-\\d+$';
+            readonly import: [{
+                readonly module: '@salsita-ai/sdk/domain';
+                readonly member: 'DomainEntityId';
+            }];
+            readonly tsType: 'DomainEntityId';
+        };
     };
-    readonly required: ["type"];
+    readonly required: ["type", "id"];
     readonly additionalProperties: true;
 };
 export declare const recipeListItemSchema: {
@@ -89,8 +98,17 @@ export declare const recipeListItemSchema: {
                     readonly type: {
                         readonly type: 'string';
                     };
+                    readonly id: {
+                        readonly type: 'string';
+                        readonly pattern: '^[A-Z]\\w*-\\d+$';
+                        readonly import: [{
+                            readonly module: '@salsita-ai/sdk/domain';
+                            readonly member: 'DomainEntityId';
+                        }];
+                        readonly tsType: 'DomainEntityId';
+                    };
                 };
-                readonly required: ["type"];
+                readonly required: ["type", "id"];
                 readonly additionalProperties: true;
             };
         };

package/dist/domain/system-components/common/recipes.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";export const recipeSchema={type:"object",properties:{type:{type:"string"}},required:["type"],additionalProperties:!0};export const recipeListItemSchema={type:"object",properties:{key:{type:"string"},title:e,description:e,thumbnailUrl:e,recipes:{type:"array",items:recipeSchema}},required:["title","recipes"],additionalProperties:!1};export const GroupedRecipesSchema={type:"object",tsType:"GroupedRecipes",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipes"}],properties:{instanceNames:{type:"array",items:{type:"string"}}},required:["instanceNames"]};export const GroupedRecipeGroupSchema={type:"object",tsType:"GroupedRecipeGroup",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipeGroup"}],properties:{label:e,description:e,thumbnailUrl:e,children:{$ref:"#/definitions/GroupedRecipeItems"}},required:["label","children"],additionalProperties:!1};export const GroupedRecipeItemsSchema={tsType:"GroupedRecipeItems",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipeItems"}],anyOf:[{type:"array",items:GroupedRecipeGroupSchema},GroupedRecipesSchema]};
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as i}from"../../core/index.js";export const recipeSchema={type:"object",properties:{type:{type:"string"},id:i},required:["type","id"],additionalProperties:!0};export const recipeListItemSchema={type:"object",properties:{key:{type:"string"},title:e,description:e,thumbnailUrl:e,recipes:{type:"array",items:recipeSchema}},required:["title","recipes"],additionalProperties:!1};export const GroupedRecipesSchema={type:"object",tsType:"GroupedRecipes",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipes"}],properties:{instanceNames:{type:"array",items:{type:"string"}}},required:["instanceNames"]};export const GroupedRecipeGroupSchema={type:"object",tsType:"GroupedRecipeGroup",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipeGroup"}],properties:{label:e,description:e,thumbnailUrl:e,children:{$ref:"#/definitions/GroupedRecipeItems"}},required:["label","children"],additionalProperties:!1};export const GroupedRecipeItemsSchema={tsType:"GroupedRecipeItems",import:[{module:"@salsita-ai/sdk/domain",member:"GroupedRecipeItems"}],anyOf:[{type:"array",items:GroupedRecipeGroupSchema},GroupedRecipesSchema]};

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

@@ -13,25 +13,23 @@ export type SpatialPredicateName = 'disjoint' | 'touches' | 'within';
  * Authored in YAML via an expression that resolves to the container's
  * `DomainEntityId`, e.g. `container: { $read: $sceneId }`. If the
  * expression resolves to `null` / `undefined` / missing the rule is treated
- * as not-applicable (no clamp, no violation). `undefined` is included so
- * codegen-emitted reads (e.g. `SpatialConstraint['container']`, which
- * resolves to `SpatialConstraintContainer | undefined` because `container`
- * is absent on the `disjoint` / `touches` variants) round-trip back into a
- * `within` rule's `container` field without a cast.
+ * as not-applicable (no clamp, no violation).
  */
 export type SpatialConstraintContainer = string | null | undefined;
 /**
- * A single spatial constraint rule. Discriminated on `predicate`.
+ * A single spatial constraint rule. `predicate` decides which of the other fields it reads.
  *
- * `disjoint` / `touches` carry a required `group` string. Matching is
+ * `disjoint` / `touches` read `group`. Matching is
  * symmetric: a rule on entity A with `group: G` applies against every
  * *other* entity whose own constraint component declares the same predicate
  * with `group: G` — "both sides must opt in to the group". An entity can
  * join multiple groups by stacking rules. Declaring `disjoint group=G`
  * simultaneously means "I'm in G" and "I must not overlap anything else in
- * G". There is no wildcard: a rule with no matching peers no-ops.
+ * G". There is no wildcard: a rule with no matching peers no-ops. A rule
+ * without `group` matches the rules of the same predicate that have no
+ * `group` either.
  *
- * `within` carries an identity-based `container` and has no group — it
+ * `within` reads an identity-based `container` and ignores `group` — it
  * binds to one specific other entity, not a class.
  *
  * Optional `target` names a specific collision-geometry instance on
@@ -70,20 +68,9 @@ export type SpatialConstraintContainer = string | null | undefined;
  * perimeter.
  */
 export type SpatialConstraint = {
-    readonly predicate: 'disjoint';
-    readonly group: string;
-    readonly target?: string;
-    readonly container?: undefined;
-    readonly enforce?: boolean;
-} | {
-    readonly predicate: 'touches';
-    readonly group: string;
-    readonly target?: string;
-    readonly container?: undefined;
-    readonly enforce?: boolean;
-} | {
-    readonly predicate: 'within';
-    readonly container: SpatialConstraintContainer;
+    readonly predicate: SpatialPredicateName;
+    readonly group?: string;
+    readonly container?: SpatialConstraintContainer;
     readonly target?: string;
     readonly enforce?: boolean;
 };

package/dist/domain/system-components/drag-handle.d.ts

@@ -6,7 +6,7 @@ export type DragHandleComponentState = {
      * It is defined in hessian normal form: `normal.x * x + normal.y * y + normal.z * z + constant = 0`
      * see https://threejs.org/docs/#api/en/math/Plane
      */
-    readonly surfaces: DraggableSurface[];
+    readonly surfaces: readonly DraggableSurface[];
     /**
      * The x property to be updated when the drag handle is dragged.
      */