@salsita-ai/sdk 0.50.0-develop.5f7528aea8 → 0.50.0-develop.600437cb2f

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}},required:["recipes","label"],additionalProperties:!1}},keepChildren:{type:"boolean"}},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/common/scene-entity-control-schema.d.ts

@@ -115,6 +115,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly polarAngleLimits: {
@@ -138,6 +139,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly distanceLimits: {
@@ -161,6 +163,7 @@ declare const SceneHtmlOpacityPropertiesTmp: {
                 readonly type: 'number';
             };
         };
+        readonly required: readonly ['min', 'max'];
         readonly additionalProperties: false;
     };
     readonly minInteractiveOpacity: {

package/dist/domain/system-components/common/scene-entity-control-schema.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";let t={type:"object",tsType:"SceneEntityHtmlOpacityLimits",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityHtmlOpacityLimits"}],properties:{min:{type:"number"},max:{type:"number"},smoothZone:{type:"number"},minOpacity:{type:"number"}},additionalProperties:!1};export const SceneHtmlOpacityProperties={azimuthAngleLimits:t,polarAngleLimits:t,distanceLimits:t,minInteractiveOpacity:{type:"number"}};export const SceneHtmlPositionProperties={offsetX:{type:"number"},offsetY:{type:"number"},offsetZ:{type:"number"},screenOffsetHorizontal:{type:"number"},screenOffsetVertical:{type:"number"}};export const SceneHtmlVisibilityProperties={hideWhileDragging:{type:"boolean"},occlude:{type:"boolean"},showWhen:{type:"array",items:{type:"string",enum:["selected","unselected"]}}};export const SceneHtmlTooltipProperties={title:e,tooltipVisibility:{type:["string"],enum:["on-hover","forced","forced-when-still","hidden"]}};
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";let t={type:"object",tsType:"SceneEntityHtmlOpacityLimits",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityHtmlOpacityLimits"}],properties:{min:{type:"number"},max:{type:"number"},smoothZone:{type:"number"},minOpacity:{type:"number"}},required:["min","max"],additionalProperties:!1};export const SceneHtmlOpacityProperties={azimuthAngleLimits:t,polarAngleLimits:t,distanceLimits:t,minInteractiveOpacity:{type:"number"}};export const SceneHtmlPositionProperties={offsetX:{type:"number"},offsetY:{type:"number"},offsetZ:{type:"number"},screenOffsetHorizontal:{type:"number"},screenOffsetVertical:{type:"number"}};export const SceneHtmlVisibilityProperties={hideWhileDragging:{type:"boolean"},occlude:{type:"boolean"},showWhen:{type:"array",items:{type:"string",enum:["selected","unselected"]}}};export const SceneHtmlTooltipProperties={title:e,tooltipVisibility:{type:["string"],enum:["on-hover","forced","forced-when-still","hidden"]}};

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.
      */

package/dist/domain/system-components/drag-handle.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isInstanceOfComponentType as a,isSnapshotOfComponentType as t}from"../core/index.js";import{DraggableSurfaceSchema as r}from"./common/index.js";export const dragHandleComponent=e.component("dragHandle").withState({tsType:"DragHandleComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"DragHandleComponentState"}],type:"object",properties:{surfaces:{type:"array",items:r},target:{type:"string"},draggableX:{type:"number"},draggableY:{type:"number"},draggableZ:{type:"number"},draggableRotationY:{type:"number"}},required:["surfaces"],additionalProperties:!1}).withWritableKeys(["draggableX","draggableY","draggableZ","draggableRotationY"]).build();export const DraggableUpdateTag="Draggable.update";export const TransientDraggableUpdateTag="Draggable.update.transient";export const isDragHandleSnapshot=t(dragHandleComponent);export const isDragHandleInstance=a(dragHandleComponent);
+import{SystemComponentBuilder as e,isInstanceOfComponentType as a,isSnapshotOfComponentType as t}from"../core/index.js";import{DraggableSurfaceSchema as r}from"./common/index.js";export const dragHandleComponent=e.component("dragHandle").withState({tsType:"DragHandleComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"DragHandleComponentState"}],type:"object",properties:{surfaces:{type:"array",items:r},draggableX:{type:"number"},draggableY:{type:"number"},draggableZ:{type:"number"},draggableRotationY:{type:"number"}},required:["surfaces"],additionalProperties:!1}).withWritableKeys(["draggableX","draggableY","draggableZ","draggableRotationY"]).build();export const DraggableUpdateTag="Draggable.update";export const TransientDraggableUpdateTag="Draggable.update.transient";export const isDragHandleSnapshot=t(dragHandleComponent);export const isDragHandleInstance=a(dragHandleComponent);

package/dist/domain/system-components/fit-entity-orthographic-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isInstanceOfComponentType as t,isSnapshotOfComponentType as o}from"../core/index.js";export const FitEntityOrthographicCameraComponentName="fitEntityOrthographicCamera";export const fitEntityOrthographicCameraComponent=e.component("fitEntityOrthographicCamera").withState({type:"object",tsType:"FitEntityOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitEntityOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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"},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 isFitEntityOrthographicCameraComponentSnapshot=o(fitEntityOrthographicCameraComponent);export const isFitEntityOrthographicCameraComponentInstance=t(fitEntityOrthographicCameraComponent);
+import{SystemComponentBuilder as e,isInstanceOfComponentType as t,isSnapshotOfComponentType as o}from"../core/index.js";export const FitEntityOrthographicCameraComponentName="fitEntityOrthographicCamera";export const fitEntityOrthographicCameraComponent=e.component("fitEntityOrthographicCamera").withState({type:"object",tsType:"FitEntityOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitEntityOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitEntityOrthographicCameraComponentSnapshot=o(fitEntityOrthographicCameraComponent);export const isFitEntityOrthographicCameraComponentInstance=t(fitEntityOrthographicCameraComponent);

package/dist/domain/system-components/fit-entity-perspective-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isInstanceOfComponentType as t,isSnapshotOfComponentType as n}from"../core/index.js";export const FitEntityPerspectiveCameraComponentName="fitEntityPerspectiveCamera";export const fitEntityPerspectiveCameraComponent=e.component("fitEntityPerspectiveCamera").withState({type:"object",tsType:"FitEntityPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitEntityPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitEntityPerspectiveCameraComponentSnapshot=n(fitEntityPerspectiveCameraComponent);export const isFitEntityPerspectiveCameraComponentInstance=t(fitEntityPerspectiveCameraComponent);
+import{SystemComponentBuilder as e,isInstanceOfComponentType as t,isSnapshotOfComponentType as n}from"../core/index.js";export const FitEntityPerspectiveCameraComponentName="fitEntityPerspectiveCamera";export const fitEntityPerspectiveCameraComponent=e.component("fitEntityPerspectiveCamera").withState({type:"object",tsType:"FitEntityPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitEntityPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitEntityPerspectiveCameraComponentSnapshot=n(fitEntityPerspectiveCameraComponent);export const isFitEntityPerspectiveCameraComponentInstance=t(fitEntityPerspectiveCameraComponent);

package/dist/domain/system-components/fit-root-orthographic-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitRootOrthographicCameraComponentName="fitRootOrthographicCamera";export const fitRootOrthographicCameraComponent=e.component("fitRootOrthographicCamera").withState({type:"object",tsType:"FitRootOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitRootOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitRootOrthographicCameraComponent=t(fitRootOrthographicCameraComponent);
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitRootOrthographicCameraComponentName="fitRootOrthographicCamera";export const fitRootOrthographicCameraComponent=e.component("fitRootOrthographicCamera").withState({type:"object",tsType:"FitRootOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitRootOrthographicCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitRootOrthographicCameraComponent=t(fitRootOrthographicCameraComponent);

package/dist/domain/system-components/fit-root-perspective-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitRootPerspectiveCameraComponentName="fitRootPerspectiveCamera";export const fitRootPerspectiveCameraComponent=e.component("fitRootPerspectiveCamera").withState({type:"object",tsType:"FitRootPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitRootPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitRootPerspectiveCameraComponent=t(fitRootPerspectiveCameraComponent);
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const FitRootPerspectiveCameraComponentName="fitRootPerspectiveCamera";export const fitRootPerspectiveCameraComponent=e.component("fitRootPerspectiveCamera").withState({type:"object",tsType:"FitRootPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"FitRootPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},fitMeshChanges:{type:"boolean"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},distanceLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},fitToBox:{type:"boolean"},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 isFitRootPerspectiveCameraComponent=t(fitRootPerspectiveCameraComponent);

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

@@ -12,7 +12,7 @@ export type HotspotDragHandleComponentState = SceneEntityHtmlPositionState & Sce
      * 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[];
     /**
      * Size of the hotspot drag handle ring in pixels. It should match the size of the drag hotspot used. Default is 40px.
      */

package/dist/domain/system-components/hotspot-drag-handle.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t,isComponentModificationOfType as e,isInstanceOfComponentType as o,isSnapshotOfComponentType as a}from"../core/index.js";import{DraggableSurfaceSchema as n,SceneHtmlOpacityProperties as r,SceneHtmlPositionProperties as p,SceneHtmlVisibilityProperties as s}from"./common/index.js";export const HotspotDragHandleVariant={Point:"point",Fab:"fab"};export const hotspotDragHandleComponent=t.component("hotspotDragHandle").withState({tsType:"HotspotDragHandleComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"HotspotDragHandleComponentState"}],type:"object",properties:{...p,...r,...s,surfaces:{type:"array",items:n},target:{type:"string"},handleSize:{type:"number"},variant:{type:"string",enum:Object.values(HotspotDragHandleVariant)},icon:{type:"string"},draggableX:{type:"number"},draggableY:{type:"number"},draggableZ:{type:"number"}},required:["surfaces"],additionalProperties:!1}).withWritableKeys(["draggableX","draggableY","draggableZ"]).build();export const isHotspotDragHandleSnapshot=a(hotspotDragHandleComponent);export const isHotspotDragHandleInstance=o(hotspotDragHandleComponent);export const isHotspotDragHandleModification=e(hotspotDragHandleComponent);
+import{SystemComponentBuilder as t,isComponentModificationOfType as e,isInstanceOfComponentType as o,isSnapshotOfComponentType as a}from"../core/index.js";import{DraggableSurfaceSchema as n,SceneHtmlOpacityProperties as r,SceneHtmlPositionProperties as p,SceneHtmlVisibilityProperties as s}from"./common/index.js";export const HotspotDragHandleVariant={Point:"point",Fab:"fab"};export const hotspotDragHandleComponent=t.component("hotspotDragHandle").withState({tsType:"HotspotDragHandleComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"HotspotDragHandleComponentState"}],type:"object",properties:{...p,...r,...s,surfaces:{type:"array",items:n},handleSize:{type:"number"},variant:{type:"string",enum:Object.values(HotspotDragHandleVariant)},icon:{type:"string"},draggableX:{type:"number"},draggableY:{type:"number"},draggableZ:{type:"number"}},required:["surfaces"],additionalProperties:!1}).withWritableKeys(["draggableX","draggableY","draggableZ"]).build();export const isHotspotDragHandleSnapshot=a(hotspotDragHandleComponent);export const isHotspotDragHandleInstance=o(hotspotDragHandleComponent);export const isHotspotDragHandleModification=e(hotspotDragHandleComponent);

package/dist/domain/system-components/material-swatch.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e,isSnapshotOfComponentType as a}from"../core/index.js";export const materialSwatchComponent=e.component("materialSwatch").withState({type:"object",tsType:"MaterialSwatchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"MaterialSwatchComponentState"}],properties:{swatches:{type:"object",additionalProperties:{type:"object",properties:{color:{type:"string",pattern:"^#[0-9a-fA-F]{6}$"},swatchName:t,thumbnailUrl:t},required:["swatchName","color"],additionalProperties:!1}},selectedSwatchKey:{type:["string","null"]}},required:["swatches","selectedSwatchKey"],additionalProperties:!1}).withWritableKeys(["selectedSwatchKey"]).build();export const isMaterialSwatchSnapshot=a(materialSwatchComponent);
+import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e,isSnapshotOfComponentType as a}from"../core/index.js";export const materialSwatchComponent=e.component("materialSwatch").withState({type:"object",tsType:"MaterialSwatchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"MaterialSwatchComponentState"}],properties:{swatches:{type:"object",additionalProperties:{type:"object",properties:{color:{type:"string",pattern:"^#[0-9a-fA-F]{6}$",tsType:"Color",import:[{module:"@salsita-ai/sdk/common/utils",member:"Color"}]},swatchName:t,thumbnailUrl:t},required:["swatchName","color"],additionalProperties:!1}},selectedSwatchKey:{type:["string","null"]}},required:["swatches","selectedSwatchKey"],additionalProperties:!1}).withWritableKeys(["selectedSwatchKey"]).build();export const isMaterialSwatchSnapshot=a(materialSwatchComponent);

package/dist/domain/system-components/scene-entity-material-override.d.ts

@@ -1,7 +1,7 @@
 import { type Material } from 'three';
 export type SceneEntityMaterialOverrideComponentState = {
     material: Material;
-    materialsToOverride: string[];
+    materialsToOverride: readonly string[];
 };
 export declare const sceneEntityMaterialOverrideComponent: import("../index.js").SystemComponentType<"sceneEntityMaterialOverride", SceneEntityMaterialOverrideComponentState, never>;
 export type SceneEntityMaterialOverrideComponent = typeof sceneEntityMaterialOverrideComponent;

package/dist/domain/system-components/scene-entity-object-material-override.d.ts

@@ -1,7 +1,7 @@
 import { type Material } from 'three';
 export type SceneEntityObjectMaterialOverrideComponentState = {
     material: Material;
-    materialsToOverride: string[];
+    materialsToOverride: readonly string[];
 };
 export declare const sceneEntityObjectMaterialOverrideComponent: import("../index.js").SystemComponentType<"sceneEntityObjectMaterialOverride", SceneEntityObjectMaterialOverrideComponentState, never>;
 export type SceneEntityObjectMaterialOverrideComponent = typeof sceneEntityObjectMaterialOverrideComponent;

package/dist/domain/system-components/scene-entity-object-text-decal.d.ts

@@ -12,7 +12,7 @@ export type SceneEntityObjectTextDecalComponentState = {
     readonly positionX?: number | undefined;
     readonly positionY?: number | undefined;
     readonly positionZ?: number | undefined;
-    readonly preloadFonts?: string[] | undefined;
+    readonly preloadFonts?: readonly string[] | undefined;
     readonly rotationX?: number | undefined;
     readonly rotationY?: number | undefined;
     readonly rotationZ?: number | undefined;

package/dist/domain/system-components/scene-entity-object-transimissive-material-override.d.ts

@@ -1,5 +1,5 @@
 export type SceneEntityObjectTransmissiveMaterialOverrideComponentState = {
-    materialsToOverride: string[];
+    materialsToOverride: readonly string[];
     transmission?: number;
     thickness?: number;
     roughness?: number;

package/dist/domain/system-components/scene-entity-transimissive-material-override.d.ts

@@ -1,5 +1,5 @@
 export type SceneEntityTransmissiveMaterialOverrideComponentState = {
-    materialsToOverride: string[];
+    materialsToOverride: readonly string[];
     transmission?: number;
     thickness?: number;
     roughness?: number;

package/dist/domain/system-components/static-orthographic-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../core/index.js";export const StaticOrthographicCameraComponentName="staticOrthographicCamera";export const staticOrthographicCameraComponent=e.component(StaticOrthographicCameraComponentName).withState({type:"object",tsType:"StaticOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"StaticOrthographicCameraComponentState"}],properties:{priority:{type:"number"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},left:{type:"number"},bottom:{type:"number"},frustumSize:{type:"number"},far:{type:"number"},near:{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"},lookAtX:{type:"number"},lookAtY:{type:"number"},lookAtZ:{type:"number"}},required:[],additionalProperties:!1}).build();export const isStaticOrthographicCameraComponent=e=>e.componentInstance.componentType.name===StaticOrthographicCameraComponentName;
+import{SystemComponentBuilder as e}from"../core/index.js";export const StaticOrthographicCameraComponentName="staticOrthographicCamera";export const staticOrthographicCameraComponent=e.component(StaticOrthographicCameraComponentName).withState({type:"object",tsType:"StaticOrthographicCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"StaticOrthographicCameraComponentState"}],properties:{priority:{type:"number"},animateOnLoad:{type:"boolean"},animateTransition:{type:"boolean"},zoomLockGroup:{type:["string","null"]},rotationLockGroup:{type:["string","null"]},left:{type:"number"},bottom:{type:"number"},frustumSize:{type:"number"},far:{type:"number"},near:{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"},lookAtX:{type:"number"},lookAtY:{type:"number"},lookAtZ:{type:"number"}},required:[],additionalProperties:!1}).build();export const isStaticOrthographicCameraComponent=e=>e.componentInstance.componentType.name===StaticOrthographicCameraComponentName;

package/dist/domain/system-components/static-perspective-camera-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../core/index.js";export const StaticPerspectiveCameraComponentName="staticPerspectiveCamera";export const staticPerspectiveCameraComponent=e.component(StaticPerspectiveCameraComponentName).withState({type:"object",tsType:"StaticPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"StaticPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},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"},lookAtX:{type:"number"},lookAtY:{type:"number"},lookAtZ:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isStaticPerspectiveCameraComponent=e=>e.componentInstance.componentType.name===StaticPerspectiveCameraComponentName;
+import{SystemComponentBuilder as e}from"../core/index.js";export const StaticPerspectiveCameraComponentName="staticPerspectiveCamera";export const staticPerspectiveCameraComponent=e.component(StaticPerspectiveCameraComponentName).withState({type:"object",tsType:"StaticPerspectiveCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"StaticPerspectiveCameraComponentState"}],properties:{priority:{type:"number"},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"},lookAtX:{type:"number"},lookAtY:{type:"number"},lookAtZ:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isStaticPerspectiveCameraComponent=e=>e.componentInstance.componentType.name===StaticPerspectiveCameraComponentName;

package/dist/domain/utils/eval-cache.d.ts

@@ -3,7 +3,7 @@ import type { DomainEntity, DomainState } from '../core/index.js';
  * Clone the evaluation cache from one state to another.
  * You should not need to use this function manually as it is used internally by the framework.
  */
-export declare const cloneEvalCache: <ENTITIES extends DomainEntity<string>>(originalState: DomainState<ENTITIES>, newState: DomainState<ENTITIES>) => void;
+export declare const cloneEvalCache: (originalState: DomainState<DomainEntity<string>>, newState: DomainState<DomainEntity<string>>) => void;
 /**
  * A unique token that can be used to retrieve an evaluation cache from a state.
  * The token carries type information about the cache's key and value types.

package/dist/domain/utils/map-nested-object.d.ts

@@ -1 +1 @@
-export declare const mapNestedObject: <TI, TO, KI extends string, KO extends string = KI>() => <REC extends Partial<Record<KI, Record<string, TI>>>>(record: REC, map: (entry: [key1: KI, key2: string, value: TI]) => Array<[key1: KO, key2: string, value: TO]>, onDuplicate?: (previousValue: TO, newValue: TO, key1: KO, key2: string) => void) => Record<KO, Record<string, TO>>;
+export declare const mapNestedObject: <TI, TO, KI extends string, KO extends string = KI>() => (record: Partial<Record<KI, Record<string, TI>>>, map: (entry: [key1: KI, key2: string, value: TI]) => Array<[key1: KO, key2: string, value: TO]>, onDuplicate?: (previousValue: TO, newValue: TO, key1: KO, key2: string) => void) => Record<KO, Record<string, TO>>;

package/dist/editor/Editor.d.ts

@@ -32,6 +32,13 @@ export interface EditorProps {
     readonly mockTemplates?: MockTemplateDefinition[];
     /** If true, automatically apply the first template when templates are initialized */
     readonly autoApplyTemplate?: boolean;
+    /**
+     * Key of the mock template to apply on mount, in place of the template stored for this page.
+     * Applying it does not store it, so it never changes what an editor without this prop opens.
+     * An unknown key logs a warning and falls back to the stored template, or to the first template
+     * when `autoApplyTemplate` is set.
+     */
+    readonly initialTemplateKey?: string;
     /** Key used to scope localStorage template persistence (e.g. environment slug) */
     readonly environmentKey?: string;
     /** Web component tag name for creating and discovering reflection systems. */