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

package/dist/domain/domain-runtime/spec/module-checks/project-modules.d.ts

@@ -1,3 +1,4 @@
+import { ImplementationError } from '../../errors/index.js';
 /**
  * The default export of one file in a project convention folder (`src/elements/`, `src/handlers/`,
  * `src/expressions/`, …), paired with the project-relative path it was imported from.
@@ -17,7 +18,13 @@ export interface ProjectModuleContract {
 }
 export declare const SHARED_FOLDER_HINT = "or move the file to an underscore-prefixed folder such as src/_shared/ when it is shared code";
 export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
-export declare const createContractError: (origin: string, contract: ProjectModuleContract, received: unknown) => Error;
+/**
+ * The error of a file whose default export does not match its folder's contract. `received` is the
+ * value the message reports: the export itself, or the item of an array export that fails. The
+ * code is `MISSING_EXPORT` when the file has no default export at all, and `INVALID_EXPORT`
+ * otherwise, also when an item of an array export is `undefined`.
+ */
+export declare const createContractError: (module: ProjectModule, contract: ProjectModuleContract, received: unknown) => ImplementationError;
 /**
  * Checks a file of a folder whose contract is one item or an array of them, and returns its items.
  * The first item that fails the check is the value the error reports.

package/dist/domain/domain-runtime/spec/module-checks/project-modules.js

@@ -1 +1 @@
-export const SHARED_FOLDER_HINT="or move the file to an underscore-prefixed folder such as src/_shared/ when it is shared code";export const isRecord=e=>"object"==typeof e&&null!==e&&!Array.isArray(e);export const createContractError=(e,r,t)=>Error(`Invalid default export in ${e}: expected ${r.expected}, but got ${(e=>{if(void 0===e)return"nothing (the file has no default export)";if(null===e)return"null";if("function"==typeof e)return e.name?`the function "${e.name}"`:"an anonymous function";if(Array.isArray(e))return`an array of ${e.length} item(s)`;if(isRecord(e)){let r=Object.keys(e);return r.length>0?`an object with the keys ${r.join(", ")}`:"an empty object"}return`the ${typeof e} ${JSON.stringify(e)}`})(t)}. Every file in this folder is loaded by convention, so each one must default-export that shape. ${r.fix}`);export const resolveListModule=(e,r,t)=>{let o=Array.isArray(e.exports)?e.exports:[e.exports],n=[];for(let i of o){if(!t(i))throw createContractError(e.origin,r,i);n.push(i)}return n};
+import{ImplementationError as e}from"../../errors/index.js";export const SHARED_FOLDER_HINT="or move the file to an underscore-prefixed folder such as src/_shared/ when it is shared code";export const isRecord=e=>"object"==typeof e&&null!==e&&!Array.isArray(e);export const createContractError=(r,t,o)=>new e({code:void 0===r.exports?"MISSING_EXPORT":"INVALID_EXPORT",origin:r.origin,problem:"Invalid default export",expected:t.expected,received:(e=>{if(void 0===e)return"nothing (the file has no default export)";if(null===e)return"null";if("function"==typeof e)return e.name?`the function "${e.name}"`:"an anonymous function";if(Array.isArray(e))return`an array of ${e.length} item(s)`;if(isRecord(e)){let r=Object.keys(e);return r.length>0?`an object with the keys ${r.join(", ")}`:"an empty object"}return`the ${typeof e} ${JSON.stringify(e)}`})(o),fix:`Every file in this folder is loaded by convention, so each one must default-export that shape. ${t.fix}`});export const resolveListModule=(e,r,t)=>{let o=Array.isArray(e.exports)?e.exports:[e.exports],n=[];for(let i of o){if(!t(i))throw createContractError(e,r,i);n.push(i)}return n};

package/dist/domain/domain-runtime/spec/module-checks/resolve-action-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as o}from"./project-modules.js";let i={expected:"an object of action implementations keyed by action name",fix:`Create it with phx.domain.implementActions({ ... }), ${e}.`},n=e=>"function"==typeof e;export const resolveActionModules=e=>e.reduce((e,r)=>{let c;if(!(o(c=r.exports)&&Object.values(c).every(n)))throw t(r.origin,i,r.exports);return{...e,...r.exports}},{});
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as o}from"./project-modules.js";let i={expected:"an object of action implementations keyed by action name",fix:`Create it with phx.domain.implementActions({ ... }), ${e}.`},n=e=>"function"==typeof e;export const resolveActionModules=e=>e.reduce((e,r)=>{let c;if(!(o(c=r.exports)&&Object.values(c).every(n)))throw t(r,i,r.exports);return{...e,...r.exports}},{});

package/dist/domain/domain-runtime/spec/module-checks/resolve-expression-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as o,isRecord as t}from"./project-modules.js";let i={expected:"an object of expressions keyed by entity type or alias, then by expression name",fix:`Create it with phx.domain.implementCustomExpressions({ ... }) (phx.domain.admin.implementCustomExpressions({ ... }) under src/admin/), ${e}.`},r=e=>t(e)&&"function"==typeof e.evaluate,n=e=>t(e)&&Object.values(e).every(r);export const resolveExpressionModules=(e,r)=>{let s=new Map;return e.map(e=>{let p;if(!(t(p=e.exports)&&Object.values(p).every(n)))throw o(e.origin,i,e.exports);for(let[o,t]of Object.entries(e.exports))for(let i of r[o]??[o])for(let o of Object.keys(t)){let t=`${i}.${o}`,r=s.get(t);if(void 0!==r&&r!==e.origin)throw Error(`Duplicate expression ${t}: it is defined in both ${r} and ${e.origin}, which would make its value depend on file order. Keep one definition and remove the other.`);s.set(t,e.origin)}return{origin:e.origin,expressions:e.exports}})};
+import{SHARED_FOLDER_HINT as e,createContractError as o,isRecord as t}from"./project-modules.js";let i={expected:"an object of expressions keyed by entity type or alias, then by expression name",fix:`Create it with phx.domain.implementCustomExpressions({ ... }) (phx.domain.admin.implementCustomExpressions({ ... }) under src/admin/), ${e}.`},r=e=>t(e)&&"function"==typeof e.evaluate,n=e=>t(e)&&Object.values(e).every(r);export const resolveExpressionModules=(e,r)=>{let s=new Map;return e.map(e=>{let p;if(!(t(p=e.exports)&&Object.values(p).every(n)))throw o(e,i,e.exports);for(let[o,t]of Object.entries(e.exports))for(let i of r[o]??[o])for(let o of Object.keys(t)){let t=`${i}.${o}`,r=s.get(t);if(void 0!==r&&r!==e.origin)throw Error(`Duplicate expression ${t}: it is defined in both ${r} and ${e.origin}, which would make its value depend on file order. Keep one definition and remove the other.`);s.set(t,e.origin)}return{origin:e.origin,expressions:e.exports}})};

package/dist/domain/domain-runtime/spec/module-checks/resolve-imported-transformers.d.ts

@@ -1,15 +1,13 @@
 import type { ImportedTransformer, SpecTransformer } from '../../../application/index.js';
-import type { $DomainEntity, DomainEntity } from '../../../core/index.js';
-import type { DomainContextSystems, Transformers } from '../../../domain-context/index.js';
+import type { AnyDomainContextSystems, Transformers } from '../../../domain-context/index.js';
 import { type ProjectModule } from './project-modules.js';
-type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
 /**
  * The transformer of one `src/transformers/` file, named after the file. The spec's `transformers` section
  * selects a plain-function export by that name; a transformer made with `build(name)` registers under its own.
  */
-export declare const resolveTransformerModule: (module: ProjectModule) => AnyImportedTransformer;
+export declare const resolveTransformerModule: (module: ProjectModule) => ImportedTransformer;
 /** Validates the `src/transformers/` files of an application config and names each after its file. */
-export declare const resolveTransformerModules: (modules: readonly ProjectModule[]) => readonly AnyImportedTransformer[];
+export declare const resolveTransformerModules: (modules: readonly ProjectModule[]) => readonly ImportedTransformer[];
 /**
  * Resolves imported transformer modules against spec transformer declarations.
  * Each imported transformer is registered/executed with the domain context,
@@ -17,6 +15,8 @@ export declare const resolveTransformerModules: (modules: readonly ProjectModule
  *
  * Used both when the runtime spec is initialized from the application config and at hot-reload time
  * (via domain-context subscription to registry changes).
+ *
+ * The transformers come from untyped project modules, so the context and the result have the open types of
+ * `AnyCreateTransformersFactory`, the slot of the runtime spec this function fills.
  */
-export declare const resolveImportedTransformers: <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>(importedTransformers: ReadonlyArray<ImportedTransformer<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>>, specTransformers: readonly SpecTransformer[], ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => Transformers<ENTITIES>;
-export {};
+export declare const resolveImportedTransformers: (importedTransformers: readonly ImportedTransformer[], specTransformers: readonly SpecTransformer[], ctx: AnyDomainContextSystems) => Transformers<any>;

package/dist/domain/domain-runtime/spec/module-checks/resolve-imported-transformers.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as r,createContractError as e,isRecord as t}from"./project-modules.js";let o={expected:"a transformer (a function of the domain context, or an object with a register method), or an array of them",fix:`Create it with phx.frontend.transformerBuilder, ${r}.`},n=r=>"function"==typeof r||t(r)&&"function"==typeof r.register;export const resolveTransformerModule=r=>{let t;if(!(Array.isArray(t=r.exports)?t.every(n):n(t)))throw e(r.origin,o,r.exports);return{name:r.origin.replace(/^.*\//,"").replace(/\.tsx?$/,""),transformer:r.exports}};export const resolveTransformerModules=r=>r.map(resolveTransformerModule);export const resolveImportedTransformers=(r,e,t)=>{let o=r.flatMap(({name:r,transformer:e})=>{if(Array.isArray(e))return e.map((e,o)=>{if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:`${r}[${o}]`};throw Error(`Transformer '${r}[${o}]' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)});if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:r};throw Error(`Transformer '${r}' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)}),n=[];for(let r of e){let e=o.find(e=>e.name===r.name);if(!e){let e=o.map(r=>r.name).filter(Boolean).join(", ");throw Error(`Transformer '${r.name}' not found in imported transformer files. Available transformers: ${e||"none"}`)}n.push({priority:r.priority??1/0,transformer:e.transformer,name:r.name})}return n};
+import{SHARED_FOLDER_HINT as r,createContractError as e,isRecord as t}from"./project-modules.js";let o={expected:"a transformer (a function of the domain context, or an object with a register method), or an array of them",fix:`Create it with phx.frontend.transformerBuilder, ${r}.`},n=r=>"function"==typeof r||t(r)&&"function"==typeof r.register;export const resolveTransformerModule=r=>{let t;if(!(Array.isArray(t=r.exports)?t.every(n):n(t)))throw e(r,o,r.exports);return{name:r.origin.replace(/^.*\//,"").replace(/\.tsx?$/,""),transformer:r.exports}};export const resolveTransformerModules=r=>r.map(resolveTransformerModule);export const resolveImportedTransformers=(r,e,t)=>{let o=r.flatMap(({name:r,transformer:e})=>{if(Array.isArray(e))return e.map((e,o)=>{if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:`${r}[${o}]`};throw Error(`Transformer '${r}[${o}]' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)});if("register"in e)return e.register(t);if("function"==typeof e)return{priority:1/0,transformer:e(t),name:r};throw Error(`Transformer '${r}' must be either a RegistrableTransformer (with register method) or a TransformerFactory (function)`)}),n=[];for(let r of e){let e=o.find(e=>e.name===r.name);if(!e){let e=o.map(r=>r.name).filter(Boolean).join(", ");throw Error(`Transformer '${r.name}' not found in imported transformer files. Available transformers: ${e||"none"}`)}n.push({priority:r.priority??1/0,transformer:e.transformer,name:r.name})}return n};

package/dist/domain/domain-runtime/spec/module-checks/resolve-invariant-modules.d.ts

@@ -1,6 +1,6 @@
 import type { Invariant } from '../../../core/index.js';
 import { type ProjectModule } from './project-modules.js';
-type AnyInvariant = Invariant<any, any, any, any, any, any, string>;
+/** An invariant of any project: a file's default export does not carry the project's entity and data types. */
+export type AnyInvariant = Invariant<any, any, any, any, any, any, string>;
 /** Validates the `src/invariants/` files and concatenates their invariants per entity type or alias. */
 export declare const resolveInvariantModules: (modules: readonly ProjectModule[]) => Readonly<Record<string, readonly AnyInvariant[]>>;
-export {};

package/dist/domain/domain-runtime/spec/module-checks/resolve-invariant-modules.js

@@ -1 +1 @@
-import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as r}from"./project-modules.js";let o={expected:"an object of invariant lists keyed by entity type or alias",fix:`Create it with phx.domain.implementCustomInvariants({ ... }) (phx.domain.admin.implementCustomInvariants({ ... }) under src/admin/), ${e}.`},i=e=>r(e)&&"function"==typeof e.evaluate,n=e=>r(e)&&Object.values(e).every(e=>Array.isArray(e)&&e.every(i));export const resolveInvariantModules=e=>{let r={};for(let i of e){if(!n(i.exports))throw t(i.origin,o,i.exports);for(let[e,t]of Object.entries(i.exports))r[e]=[...r[e]??[],...t]}return r};
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as r}from"./project-modules.js";let o={expected:"an object of invariant lists keyed by entity type or alias",fix:`Create it with phx.domain.implementCustomInvariants({ ... }) (phx.domain.admin.implementCustomInvariants({ ... }) under src/admin/), ${e}.`},i=e=>r(e)&&"function"==typeof e.evaluate,n=e=>r(e)&&Object.values(e).every(e=>Array.isArray(e)&&e.every(i));export const resolveInvariantModules=e=>{let r={};for(let i of e){if(!n(i.exports))throw t(i,o,i.exports);for(let[e,t]of Object.entries(i.exports))r[e]=[...r[e]??[],...t]}return r};

package/dist/domain/extensions/attribute-switch.d.ts

@@ -1,5 +1,5 @@
 export declare const AttributeSwitchValueSchema: {
-    readonly type: ["string", "number", "boolean"];
+    readonly type: 'boolean';
 };
 export type AttributeSwitchComponentState = {
     readonly value: boolean;

package/dist/domain/extensions/attribute-switch.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t}from"../core/index.js";export const AttributeSwitchValueSchema={type:["string","number","boolean"]};export const attributeSwitchComponent=t.component("attributeSwitch").withState({type:"object",properties:{value:AttributeSwitchValueSchema},tsType:"AttributeSwitchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSwitchComponentState"}],required:["value"],additionalProperties:!1}).withWritableKeys(["value"]).build();
+import{SystemComponentBuilder as t}from"../core/index.js";export const AttributeSwitchValueSchema={type:"boolean"};export const attributeSwitchComponent=t.component("attributeSwitch").withState({type:"object",properties:{value:AttributeSwitchValueSchema},tsType:"AttributeSwitchComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSwitchComponentState"}],required:["value"],additionalProperties:!1}).withWritableKeys(["value"]).build();

package/dist/domain/extensions/canvas-config.d.ts

@@ -41,7 +41,7 @@ export type CanvasConfigComponentState = {
     /**
      * Can be "high-performance", "low-power" or "default"
      */
-    readonly powerPreference?: string | undefined;
+    readonly powerPreference?: 'high-performance' | 'low-power' | 'default' | undefined;
     /**
      * default is true.
      */

package/dist/domain/extensions/client-side-image.d.ts

@@ -1,10 +1,10 @@
-import { type Color } from '@salsita-ai/common/utils';
+import { type HexColor } from '@salsita-ai/common/utils';
 export type ClientSideImageComponentState = {
     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/client-side-image.js

@@ -1 +1 @@
-import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const clientSideImageComponent=t.component("clientSideImage").withState({type:"object",tsType:"ClientSideImageComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ClientSideImageComponentState"}],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 isClientSideImageComponentSnapshot=e(clientSideImageComponent);
+import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const clientSideImageComponent=t.component("clientSideImage").withState({type:"object",tsType:"ClientSideImageComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ClientSideImageComponentState"}],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 isClientSideImageComponentSnapshot=e(clientSideImageComponent);

package/dist/domain/extensions/common/angle-indicator-schema.d.ts

@@ -71,9 +71,9 @@ export type AngleIndicatorBaseState = {
      */
     readonly labelFontStyle?: 'normal' | 'italic';
     /**
-     * Font weight, which can be a numeric value, 'normal', or 'bold'.
+     * Font weight: a number, or a keyword such as 'normal' or 'bold'.
      */
-    readonly labelFontWeight?: number | 'normal' | 'bold';
+    readonly labelFontWeight?: number | string;
     /**
      * Spacing between letters. Default is 0.
      */

package/dist/domain/extensions/common/dimension-indicator-schema.d.ts

@@ -119,10 +119,10 @@ export type DimensionIndicatorBaseState = {
      */
     readonly labelFontStyle?: 'normal' | 'italic';
     /**
-     * Font weight, which can be a numeric value, 'normal', or 'bold'.
+     * Font weight: a number, or a keyword such as 'normal' or 'bold'.
      * See https://protectwise.github.io/troika/troika-three-text/
      */
-    readonly labelFontWeight?: number | 'normal' | 'bold';
+    readonly labelFontWeight?: number | string;
     /**
      * Spacing between letters. Default is 0.
      * See https://protectwise.github.io/troika/troika-three-text/

package/dist/domain/extensions/editable-angle-indicator.d.ts

@@ -10,7 +10,7 @@ export type EditableAngleIndicatorComponentState = AngleIndicatorBaseState & Sce
     /**
      * An array of fixable violations. They will be ignored in the violation hint.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * The label of the input field.
      */

package/dist/domain/extensions/editable-distance-dimension-indicator.d.ts

@@ -10,7 +10,7 @@ export type EditableDistanceDimensionIndicatorComponentState = DimensionIndicato
     /**
      * An array of fixable violations. They will be ignored in the violation hint.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * The label of the input field.
      */

package/dist/domain/extensions/editable-offset-indicator.d.ts

@@ -13,7 +13,7 @@ export type EditableOffsetIndicatorComponentState = OffsetIndicatorComponentStat
     /**
      * Violation names to ignore when computing hints for the edit input.
      */
-    readonly fixableViolations?: string[];
+    readonly fixableViolations?: readonly string[];
     /**
      * Label displayed on the edit input field.
      */

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

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e,isSnapshotOfComponentType as i}from"../core/index.js";import{DimensionUnitSchema as n,UnitsConfigSchema as r}from"../dimensions/index.js";import{SceneHtmlOpacityProperties as o,SceneHtmlVisibilityProperties as a}from"../system-components/index.js";import{DimensionIndicatorBaseProperties as s,EditableIndicatorButtonVariantSchema as p}from"./common/index.js";export const editableOffsetIndicatorComponent=e.component("editableOffsetIndicator").withState({tsType:"EditableOffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"EditableOffsetIndicatorComponentState"}],type:"object",properties:{...s,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,...o,...a,targetOffset:{type:"string"},fixableViolations:{type:"array",items:{type:"string"}},inputLabel:t,modalTitle:t,modalText:t,helperText:t,buttonVariant:p},required:["targetOffset","targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isEditableOffsetIndicatorSnapshot=i(editableOffsetIndicatorComponent);
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{DomainEntityIdSchema as t,SystemComponentBuilder as i,isSnapshotOfComponentType as n}from"../core/index.js";import{DimensionUnitSchema as r,UnitsConfigSchema as o}from"../dimensions/index.js";import{SceneHtmlOpacityProperties as a,SceneHtmlVisibilityProperties as s}from"../system-components/index.js";import{DimensionIndicatorBaseProperties as p,EditableIndicatorButtonVariantSchema as m}from"./common/index.js";export const editableOffsetIndicatorComponent=i.component("editableOffsetIndicator").withState({tsType:"EditableOffsetIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"EditableOffsetIndicatorComponentState"}],type:"object",properties:{...p,targetEntityOffsetAnchors:{type:"array",items:{type:"string"}},targetReferenceOffsetAnchors:{type:"array",items:{type:"string"}},referenceEntityIds:{type:["array","null"],items:t},directionVector:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},additionalProperties:!1},directionVectorRelativeToEntityId:{anyOf:[t,{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,...a,...s,targetOffset:{type:"string"},fixableViolations:{type:"array",items:{type:"string"}},inputLabel:e,modalTitle:e,modalText:e,helperText:e,buttonVariant:m},required:["targetOffset","targetEntityOffsetAnchors","targetReferenceOffsetAnchors","directionVector"],additionalProperties:!1}).build();export const isEditableOffsetIndicatorSnapshot=n(editableOffsetIndicatorComponent);

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()};