@salsita-ai/sdk 0.50.0-develop.f42416a4e6 → 0.50.0-develop.f5b66685b9

package/dist/domain/spec/components/component-filter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A single filter criterion — static value, dynamic `$read` reference, or
+ * inline `$eval` expression evaluated against `self` at runtime.
+ *
+ * The `target` field on the `'dynamic'` variant is a bare name (matches the
+ * same pattern as prop-level reads); codegen emits `self.target`, runtime
+ * reads `self[target]`.
+ */
+export type FilterCriterion<T> = {
+    readonly kind: 'static';
+    readonly value: T;
+} | {
+    readonly kind: 'dynamic';
+    readonly target: string;
+} | {
+    readonly kind: 'eval';
+    readonly code: string;
+};
+/**
+ * Parsed component filter controlling when the component is active, as the application spec
+ * declares it under `$filter`; `application-spec` exports it as `ComponentFilter`. Two
+ * mutually-exclusive shapes:
+ *
+ * - `'gradual'` — zero or more per-criterion fields; compiles to one entry per
+ *   set key inside `.withGradualFilter({…})`. The preferred form.
+ * - `'root'` — the entire filter is a single `$read` at the root (legacy
+ *   form `$filter: { $read: '$x' }`); compiles to `.withFilter(self => (self.target))`.
+ *   Distinct codegen because the SDK's `withFilter` and `withGradualFilter`
+ *   methods have different evaluation semantics (whole-closure vs per-key).
+ *
+ * See `components.md §"Simple expression filter"` / `§"Declarative filter"`.
+ */
+export type SpecComponentFilter = {
+    readonly kind: 'gradual';
+    readonly navigationStates?: FilterCriterion<readonly string[]>;
+    readonly viewStates?: FilterCriterion<readonly string[]>;
+    readonly toolStates?: FilterCriterion<readonly string[]>;
+    readonly exportStates?: FilterCriterion<readonly string[]>;
+    readonly modes?: FilterCriterion<readonly string[]>;
+    readonly roles?: FilterCriterion<readonly string[]>;
+    readonly selectedEntityIds?: FilterCriterion<unknown>;
+    readonly hoveredEntityIds?: FilterCriterion<unknown>;
+    readonly draggedEntityIds?: FilterCriterion<unknown>;
+    readonly exportedEntityIds?: FilterCriterion<unknown>;
+    readonly active?: FilterCriterion<boolean>;
+    readonly fullscreen?: FilterCriterion<boolean>;
+    readonly debug?: FilterCriterion<boolean>;
+    readonly viewports?: FilterCriterion<unknown>;
+} | {
+    readonly kind: 'root';
+    readonly target: string;
+};
+/** Criterion field names on the gradual variant — used for parse and iteration. */
+export declare const FILTER_CRITERION_KEYS: readonly ["navigationStates", "viewStates", "toolStates", "exportStates", "modes", "roles", "selectedEntityIds", "hoveredEntityIds", "draggedEntityIds", "exportedEntityIds", "active", "fullscreen", "debug", "viewports"];

package/dist/domain/spec/components/component-filter.js

@@ -0,0 +1 @@
+export const FILTER_CRITERION_KEYS=["navigationStates","viewStates","toolStates","exportStates","modes","roles","selectedEntityIds","hoveredEntityIds","draggedEntityIds","exportedEntityIds","active","fullscreen","debug","viewports"];

package/dist/domain/spec/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component-filter.js';
+export * from './sdk-code-ref.js';

package/dist/domain/spec/components/index.js

@@ -0,0 +1 @@
+export*from"./component-filter.js";export*from"./sdk-code-ref.js";

package/dist/domain/spec/components/sdk-code-ref.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A parameter that should be emitted as an unquoted code reference in codegen
+ * (e.g. an entity reflection variable like `Top`).
+ * At runtime, the string value is resolved to the actual object (e.g. entity reflection).
+ */
+export interface SdkCodeRef {
+    readonly $codeRef: string;
+}
+export declare const isSdkCodeRef: (value: unknown) => value is SdkCodeRef;

package/dist/domain/spec/components/sdk-code-ref.js

@@ -0,0 +1 @@
+export const isSdkCodeRef=e=>"object"==typeof e&&null!==e&&"$codeRef"in e&&"string"==typeof e.$codeRef;

package/dist/domain/spec/enhanced-json-value.d.ts

@@ -0,0 +1,30 @@
+import type { EvalMarker, MsgMarker } from './markers/index.js';
+/**
+ * A JSON-serialisable value augmented with Phoenix structural markers:
+ * `$msg` (i18n) and `$eval` (self-scoped code).
+ *
+ * Single shared shape across components, expressions, and defaults — lowered
+ * either to TypeScript source via `stringifyEnhancedJsonValue` or to a
+ * runtime value via `resolveEnhancedJsonValue`, both of `application-spec`.
+ *
+ * Which markers are allowed at a given slot is controlled by
+ * `EnhancedJsonValueCaps` of `application-spec`, not by the type — all markers parse
+ * identically, capability checks kick in at lowering time.
+ */
+export type EnhancedJsonValue = string | number | boolean | null | MsgMarker | EvalMarker | EnhancedJsonArray | EnhancedJsonObject;
+/** Array form of {@link EnhancedJsonValue} — extracted as a named interface so `z.lazy` can close the recursion. */
+export interface EnhancedJsonArray extends ReadonlyArray<EnhancedJsonValue> {
+}
+/** Object form of {@link EnhancedJsonValue} — extracted for the same reason as {@link EnhancedJsonArray}. */
+export interface EnhancedJsonObject {
+    readonly [key: string]: EnhancedJsonValue;
+}
+/** Runtime `self` accessor — shape-agnostic entity state. */
+export type SelfAccessor = object;
+/**
+ * Deterministic string key for a value — sorted object keys, JSON-encoded.
+ * Used by the expression runtime's reference store to preserve an evaluator when the
+ * underlying value is structurally unchanged (mirrors the content-hash pattern
+ * used for components).
+ */
+export declare const canonicalEnhancedJsonValueKey: (value: EnhancedJsonValue) => string;

package/dist/domain/spec/enhanced-json-value.js

@@ -0,0 +1 @@
+export const canonicalEnhancedJsonValueKey=r=>{let e=r=>{if(null===r||"object"!=typeof r)return r;if(Array.isArray(r))return r.map(e);let t={};for(let n of Object.keys(r).sort())t[n]=e(r[n]);return t};return JSON.stringify(e(r))};

package/dist/domain/spec/expressions/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './relation-expression-params.js';
+export * from './sdk-expression-implementation.js';

package/dist/domain/spec/expressions/index.js

@@ -0,0 +1 @@
+export*from"./sdk-expression-implementation.js";

package/dist/domain/spec/expressions/relation-expression-params.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The relation factory's single positional param: the relation's kind, the entity type or alias it
+ * points to and its cardinality, plus the id field for `direct` and `indirect` relations. The
+ * assistant schema reads `target` and `cardinality` to type a relation edge.
+ */
+export interface RelationExpressionParams {
+    readonly kind: 'direct' | 'indirect' | 'allOfType';
+    readonly target: string;
+    readonly cardinality: '0-1' | '1-1' | '0-N' | '1-N';
+    readonly field?: string;
+}

package/dist/domain/spec/expressions/relation-expression-params.js

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

package/dist/domain/spec/expressions/sdk-expression-implementation.d.ts

@@ -0,0 +1,24 @@
+import type { RelationExpressionParams } from './relation-expression-params.js';
+/**
+ * An expression implementation built by an SDK factory at runtime. The kind is the
+ * semantic source of the expression, declared by the section that generated it —
+ * codegen and runtime dispatch on it instead of inspecting factory-function names.
+ * - `relation`: generated from a `relations:` declaration
+ * - `violations`: generated from `invariants:` declarations (the `$violations` expression)
+ */
+export type SdkExpressionImplementation = {
+    readonly kind: 'relation';
+    readonly params: readonly [RelationExpressionParams];
+} | {
+    readonly kind: 'violations';
+    readonly params: readonly unknown[];
+};
+/**
+ * Narrows to implementations that are built by an SDK expression factory at runtime. It checks
+ * `kind` only, so it narrows to the members of the caller's own type that are SDK implementations,
+ * such as those of the parser's `ExpressionImplementation`, and never adds the `params` a value
+ * of another type does not have.
+ */
+export declare const isSdkExpressionImplementation: <IMPLEMENTATION extends {
+    readonly kind: string;
+}>(implementation: IMPLEMENTATION) => implementation is Extract<IMPLEMENTATION, SdkExpressionImplementation>;

package/dist/domain/spec/expressions/sdk-expression-implementation.js

@@ -0,0 +1 @@
+export const isSdkExpressionImplementation=i=>"relation"===i.kind||"violations"===i.kind;

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

@@ -0,0 +1,5 @@
+export * from './application/index.js';
+export * from './components/index.js';
+export * from './enhanced-json-value.js';
+export * from './expressions/index.js';
+export * from './markers/index.js';

package/dist/domain/spec/index.js

@@ -0,0 +1 @@
+export*from"./application/index.js";export*from"./components/index.js";export*from"./enhanced-json-value.js";export*from"./expressions/index.js";export*from"./markers/index.js";

package/dist/domain/spec/markers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './eval-marker.js';
+export * from './msg-marker.js';

package/dist/domain/spec/markers/index.js

@@ -0,0 +1 @@
+export*from"./eval-marker.js";export*from"./msg-marker.js";

package/dist/domain/spec/markers/msg-marker.d.ts

@@ -0,0 +1,28 @@
+import type { MessageDescriptor } from '@lingui/core';
+import { z } from 'zod';
+/** Key literal for the `$msg` marker in raw YAML. */
+export declare const MSG_MARKER_KEY: '$msg';
+/** Key literal for the optional `$msgId` qualifier on `$msg`. */
+export declare const MSG_ID_MARKER_KEY: '$msgId';
+/**
+ * YAML marker produced by `$msg: 'text'` / `$msg: 'text', $msgId: 'id'` entries.
+ * `$msgId` is a qualifier on `$msg`, not a standalone marker.
+ */
+export interface MsgMarker {
+    readonly $msg: string;
+    readonly $msgId?: string;
+}
+/** Zod decoder for {@link MsgMarker}. Strict — rejects extra keys. */
+export declare const msgMarkerSchema: z.ZodObject<{
+    $msg: z.ZodString;
+    $msgId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    $msg: string;
+    $msgId?: string | undefined;
+}, {
+    $msg: string;
+    $msgId?: string | undefined;
+}>;
+/** Structural type guard for {@link MsgMarker}. */
+export declare const isMsgMarker: (value: unknown) => value is MsgMarker;
+export declare const createMessageDescriptor: (marker: MsgMarker) => MessageDescriptor;

package/dist/domain/spec/markers/msg-marker.js

@@ -0,0 +1 @@
+import{generateMessageId as s}from"@lingui/message-utils/generateMessageId";import{z as e}from"zod";export const MSG_MARKER_KEY="$msg";export const MSG_ID_MARKER_KEY="$msgId";export const msgMarkerSchema=e.object({$msg:e.string(),$msgId:e.string().optional()}).strict();export const isMsgMarker=s=>msgMarkerSchema.safeParse(s).success;export const createMessageDescriptor=e=>({id:e.$msgId??s(e.$msg),message:e.$msg});

package/dist/domain/system-components/admin-sidebar.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type DomainEntityId } from '../core/model.js';
+import { type DomainEntityId } from '../core/index.js';
 import { type PhoenixEntityElement } from './phoenix-entity-elements/index.js';
 export type AdminSidebarComponentState = {
     /**

package/dist/domain/system-components/admin-sidebar.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../components/system-component-builder.js";import{DomainEntityIdSchema as t}from"../core/model.js";import{ReactNodeSchema as i}from"./common/react-node-schema.js";import{PhoenixEntityElementSchema as o}from"./phoenix-entity-elements/index.js";export const adminSidebarComponent=e.component("adminSidebar").withState({type:"object",tsType:"AdminSidebarComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AdminSidebarComponentState"}],properties:{page:i,children:{type:"array",items:{$ref:"#/definitions/PhoenixEntityElement"}},title:{type:"string"},fallbackId:t},definitions:{PhoenixEntityElement:o},required:["title"],additionalProperties:!1}).build();
+import{DomainEntityIdSchema as e,SystemComponentBuilder as t}from"../core/index.js";import{ReactNodeSchema as i}from"./common/react-node-schema.js";import{PhoenixEntityElementSchema as n}from"./phoenix-entity-elements/index.js";export const adminSidebarComponent=t.component("adminSidebar").withState({type:"object",tsType:"AdminSidebarComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AdminSidebarComponentState"}],properties:{page:i,children:{type:"array",items:{$ref:"#/definitions/PhoenixEntityElement"}},title:{type:"string"},fallbackId:e},definitions:{PhoenixEntityElement:n},required:["title"],additionalProperties:!1}).build();

package/dist/domain/system-components/angle-dimension.js

@@ -1 +1 @@
-import{SystemComponentBuilder as n}from"../components/system-component-builder.js";import{isInstanceOfComponentType as o,isSnapshotOfComponentType as e}from"../core/index.js";import{AngleValueSchema as i}from"../dimensions/index.js";export const angleDimensionComponent=n.component("angleDimension").withState(i).withWritableKeys(["value"]).build();export const isAngleDimensionSnapshot=e(angleDimensionComponent);export const isAngleDimensionInstance=o(angleDimensionComponent);
+import{SystemComponentBuilder as n,isInstanceOfComponentType as e,isSnapshotOfComponentType as o}from"../core/index.js";import{AngleValueSchema as i}from"../dimensions/index.js";export const angleDimensionComponent=n.component("angleDimension").withState(i).withWritableKeys(["value"]).build();export const isAngleDimensionSnapshot=o(angleDimensionComponent);export const isAngleDimensionInstance=e(angleDimensionComponent);

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

@@ -1,4 +1,4 @@
-import { type ComponentInstance, type ComponentSnapshot } from '../core/component.js';
+import { type ComponentInstance, type ComponentSnapshot } from '../core/index.js';
 import { DimensionUnit, type UnitsConfig } from '../dimensions/index.js';
 export type ApplicationConfigComponentState = {
     readonly showCollisionWarnings?: boolean;
@@ -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/application-config.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../components/system-component-builder.js";import{isInstanceOfComponentType as n,isSnapshotOfComponentType as t}from"../core/component.js";import{DimensionUnit as o,UnitsConfigSchema as i}from"../dimensions/index.js";export const applicationConfigComponent=e.component("applicationConfig").withState({type:"object",tsType:"ApplicationConfigComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ApplicationConfigComponentState"}],properties:{showCollisionWarnings:{type:"boolean"},collisionWarningIcon:{type:"string"},sidebarBackIcon:{type:"string"},hamburgerIcon:{type:"string"},readonlyBannerIcon:{type:"string"},toolbarCloseIcon:{type:"string"},layout:{type:"string",enum:["simple","tabs","steps","custom","universal"]},ignoreSelectionInSidebar:{type:"boolean"},miniSidebar:{type:"boolean"},initialGlobalUnit:{type:"string",enum:Object.values(o)},distanceDataUnit:{type:"string",enum:Object.values(o)},unitDisplayConfig:i,availableDimensions:{type:"array",items:{type:"string",enum:Object.values(o)}},splitSidebar:{type:"boolean"},showSelectionBackButton:{type:"boolean"},disableDefaultCamera:{type:"boolean"},shareDisabled:{type:"boolean"},shareOwnerLinkDisabled:{type:"boolean"},shareReadRevisionLinkDisabled:{type:"boolean"},shareExpiration:{type:"number"},shareCloneToEdit:{type:"boolean"},shareStrategy:{type:"string",enum:["deployment-registered","current-frontend"]},availableLocales:{type:"array",items:{type:"string"}},initialIndicatorShown:{type:"boolean"},chatEnabled:{type:"boolean"},indicatorSwitch:{type:"boolean"},disableRelativeDragging:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isApplicationConfigSnapshot=t(applicationConfigComponent);export const isApplicationConfigInstance=n(applicationConfigComponent);
+import{SystemComponentBuilder as e,isInstanceOfComponentType as n,isSnapshotOfComponentType as t}from"../core/index.js";import{DimensionUnit as o,UnitsConfigSchema as i}from"../dimensions/index.js";export const applicationConfigComponent=e.component("applicationConfig").withState({type:"object",tsType:"ApplicationConfigComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ApplicationConfigComponentState"}],properties:{showCollisionWarnings:{type:"boolean"},collisionWarningIcon:{type:"string"},sidebarBackIcon:{type:"string"},hamburgerIcon:{type:"string"},readonlyBannerIcon:{type:"string"},toolbarCloseIcon:{type:"string"},layout:{type:"string",enum:["simple","tabs","steps","custom","universal"]},ignoreSelectionInSidebar:{type:"boolean"},miniSidebar:{type:"boolean"},initialGlobalUnit:{type:"string",enum:Object.values(o)},distanceDataUnit:{type:"string",enum:Object.values(o)},unitDisplayConfig:i,availableDimensions:{type:"array",items:{type:"string",enum:Object.values(o)}},splitSidebar:{type:"boolean"},showSelectionBackButton:{type:"boolean"},disableDefaultCamera:{type:"boolean"},shareDisabled:{type:"boolean"},shareOwnerLinkDisabled:{type:"boolean"},shareReadRevisionLinkDisabled:{type:"boolean"},shareExpiration:{type:"number"},shareCloneToEdit:{type:"boolean"},shareStrategy:{type:"string",enum:["deployment-registered","current-frontend"]},availableLocales:{type:"array",items:{type:"string"}},initialIndicatorShown:{type:"boolean"},chatEnabled:{type:"boolean"},indicatorSwitch:{type:"boolean"},disableRelativeDragging:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isApplicationConfigSnapshot=t(applicationConfigComponent);export const isApplicationConfigInstance=n(applicationConfigComponent);

package/dist/domain/system-components/attribute-selection.js

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e}from"../components/system-component-builder.js";import{isSnapshotOfComponentType as o}from"../core/component.js";export const attributeSelectionComponent=e.component("attributeSelection").withState({type:"object",tsType:"AttributeSelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSelectionComponentState"}],properties:{value:{type:["string","number","boolean","null"]},options:{type:"array",items:{type:"object",properties:{label:t,description:t,img:t,value:{type:["string","number","boolean"]}},required:["value","label"],additionalProperties:!0}}},required:["value","options"],additionalProperties:!1}).withWritableKeys(["value"]).build();export const isAttributeSelectionSnapshot=o(attributeSelectionComponent);
+import{EnhancedLocalizableSchema as t}from"@salsita-ai/common/utils";import{SystemComponentBuilder as e,isSnapshotOfComponentType as o}from"../core/index.js";export const attributeSelectionComponent=e.component("attributeSelection").withState({type:"object",tsType:"AttributeSelectionComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AttributeSelectionComponentState"}],properties:{value:{type:["string","number","boolean","null"]},options:{type:"array",items:{type:"object",properties:{label:t,description:t,img:t,value:{type:["string","number","boolean"]}},required:["value","label"],additionalProperties:!0}}},required:["value","options"],additionalProperties:!1}).withWritableKeys(["value"]).build();export const isAttributeSelectionSnapshot=o(attributeSelectionComponent);

package/dist/domain/system-components/bounding-box-component.d.ts

@@ -1,5 +1,5 @@
 import { type Box3 } from 'three';
-import type { ComponentSnapshot } from '../core/component.js';
+import { type ComponentSnapshot } from '../core/index.js';
 export type BoundingBoxComponentState = {
     /**
      * Three.js Box3 object defining the custom bounding box for camera fitting.

package/dist/domain/system-components/bounding-box-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../components/system-component-builder.js";export const boundingBoxComponent=e.component("boundingBox").withState({type:"object",tsType:"BoundingBoxComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"BoundingBoxComponentState"}],properties:{shape:{type:"object"},minX:{type:"number"},minY:{type:"number"},minZ:{type:"number"},maxX:{type:"number"},maxY:{type:"number"},maxZ:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isBoundingBoxComponent=e=>"boundingBox"===e.componentInstance.componentType.name;
+import{SystemComponentBuilder as e}from"../core/index.js";export const boundingBoxComponent=e.component("boundingBox").withState({type:"object",tsType:"BoundingBoxComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"BoundingBoxComponentState"}],properties:{shape:{type:"object"},minX:{type:"number"},minY:{type:"number"},minZ:{type:"number"},maxX:{type:"number"},maxY:{type:"number"},maxZ:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isBoundingBoxComponent=e=>"boundingBox"===e.componentInstance.componentType.name;

package/dist/domain/system-components/bounding-sphere-component.d.ts

@@ -1,5 +1,5 @@
 import { type Sphere } from 'three';
-import type { ComponentSnapshot } from '../core/component.js';
+import { type ComponentSnapshot } from '../core/index.js';
 export type BoundingSphereComponentState = {
     /**
      * Three.js Sphere object defining the custom bounding sphere for camera fitting.

package/dist/domain/system-components/bounding-sphere-component.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../components/system-component-builder.js";export const boundingSphereComponent=e.component("boundingSphere").withState({type:"object",tsType:"BoundingSphereComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"BoundingSphereComponentState"}],properties:{shape:{type:"object"},centerX:{type:"number"},centerY:{type:"number"},centerZ:{type:"number"},radius:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isBoundingSphereComponent=e=>"boundingSphere"===e.componentInstance.componentType.name;
+import{SystemComponentBuilder as e}from"../core/index.js";export const boundingSphereComponent=e.component("boundingSphere").withState({type:"object",tsType:"BoundingSphereComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"BoundingSphereComponentState"}],properties:{shape:{type:"object"},centerX:{type:"number"},centerY:{type:"number"},centerZ:{type:"number"},radius:{type:"number"},relative:{type:"boolean"}},required:[],additionalProperties:!1}).build();export const isBoundingSphereComponent=e=>"boundingSphere"===e.componentInstance.componentType.name;

package/dist/domain/system-components/child-entity-recipes.d.ts

@@ -1,5 +1,5 @@
 import { type Localizable } from '@salsita-ai/common/utils';
-import type { ComponentInstance, ComponentSnapshot, SystemComponentTypeConstraint } from '../core/index.js';
+import { type ComponentInstance, type ComponentSnapshot, type SystemComponentTypeConstraint } from '../core/index.js';
 import { type RecipeListItem } from './common/recipes.js';
 export type ChildEntityRecipesComponentState = {
     /**

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

@@ -1 +1 @@
-import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{SystemComponentBuilder as t}from"../components/system-component-builder.js";import{recipeListItemSchema as i}from"./common/recipes.js";export const childEntityRecipesComponent=t.component("childEntityRecipes").withState({type:"object",tsType:"ChildEntityRecipesComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntityRecipesComponentState"}],properties:{collection:{type:"string"},recipes:{type:"array",items:i},groupLabel:e,groupDescription:e},required:["recipes"],additionalProperties:!1}).build();export const isChildEntityRecipesSnapshot=e=>e.componentInstance.componentType===childEntityRecipesComponent;export const isChildEntityRecipesInstance=e=>e.componentType===childEntityRecipesComponent;
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{SystemComponentBuilder as t}from"../core/index.js";import{recipeListItemSchema as i}from"./common/recipes.js";export const childEntityRecipesComponent=t.component("childEntityRecipes").withState({type:"object",tsType:"ChildEntityRecipesComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ChildEntityRecipesComponentState"}],properties:{collection:{type:"string"},recipes:{type:"array",items:i},groupLabel:e,groupDescription:e},required:["recipes"],additionalProperties:!1}).build();export const isChildEntityRecipesSnapshot=e=>e.componentInstance.componentType===childEntityRecipesComponent;export const isChildEntityRecipesInstance=e=>e.componentType===childEntityRecipesComponent;

package/dist/domain/system-components/child-entity-selection.d.ts

@@ -1,6 +1,5 @@
 import { type Localizable } from '@salsita-ai/common/utils';
-import type { DomainEntity, DomainEntityId } from '../core/model.js';
-import type { EntityRecipe } from '../domain-context/recipe-system/recipes.js';
+import { type DomainEntity, type DomainEntityId, type EntityRecipe } from '../core/index.js';
 export interface ChildEntitySelectionOption {
     /**
      * The label of the option

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"../components/system-component-builder.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,5 +1,4 @@
-import type { Color } from '@salsita-ai/common/utils';
-import type { ComponentSnapshot } from '../core/component.js';
+import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Axis-aligned box collision geometry, authored via per-axis start/end
  * coordinates in the entity's local frame (before `sceneEntityProperties`
@@ -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-box-geometry.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e}from"../components/system-component-builder.js";export const collisionBoxGeometryComponent=e.component("collisionBoxGeometry").withState({type:"object",tsType:"CollisionBoxGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionBoxGeometryComponentState"}],properties:{startX:{type:"number"},endX:{type:"number"},startY:{type:"number"},endY:{type:"number"},startZ:{type:"number"},endZ:{type:"number"},color:{type:"string"}},required:["startX","endX","startY","endY","startZ","endZ","color"],additionalProperties:!1}).build();export const isCollisionBoxGeometryComponent=e=>"collisionBoxGeometry"===e.componentInstance.componentType.name;
+import{SystemComponentBuilder as e}from"../core/index.js";export const collisionBoxGeometryComponent=e.component("collisionBoxGeometry").withState({type:"object",tsType:"CollisionBoxGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionBoxGeometryComponentState"}],properties:{startX:{type:"number"},endX:{type:"number"},startY:{type:"number"},endY:{type:"number"},startZ:{type:"number"},endZ:{type:"number"},color:{type:"string"}},required:["startX","endX","startY","endY","startZ","endZ","color"],additionalProperties:!1}).build();export const isCollisionBoxGeometryComponent=e=>"collisionBoxGeometry"===e.componentInstance.componentType.name;

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

@@ -1,5 +1,5 @@
 import { type BufferGeometry } from 'three';
-import type { ComponentSnapshot } from '../core/component.js';
+import type { ComponentSnapshot } from '../core/index.js';
 import { type DimensionUnit } from '../dimensions/dimensions.js';
 import { type CollisionBoxGeometryComponent } from './collision-box-geometry.js';
 import type { CollisionGeometryComponent } from './collision-geometry.js';

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

@@ -1,5 +1,4 @@
-import type { Color } from '@salsita-ai/common/utils';
-import type { ComponentSnapshot } from '../core/component.js';
+import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Mesh-backed collision geometry. The caller supplies a pre-built
  * `BufferGeometry` — used for arbitrary meshes (extruded outlines,
@@ -10,7 +9,10 @@ import type { ComponentSnapshot } from '../core/component.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-geometry.js

@@ -1 +1 @@
-import{SystemComponentBuilder as o}from"../components/system-component-builder.js";export const collisionGeometryComponent=o.component("collisionGeometry").withState({type:"object",tsType:"CollisionGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionGeometryComponentState"}],properties:{geometry:{type:"object"},color:{type:"string"}},required:["geometry","color"],additionalProperties:!1}).build();export const isCollisionGeometryComponent=o=>"collisionGeometry"===o.componentInstance.componentType.name;
+import{SystemComponentBuilder as o}from"../core/index.js";export const collisionGeometryComponent=o.component("collisionGeometry").withState({type:"object",tsType:"CollisionGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionGeometryComponentState"}],properties:{geometry:{type:"object"},color:{type:"string"}},required:["geometry","color"],additionalProperties:!1}).build();export const isCollisionGeometryComponent=o=>"collisionGeometry"===o.componentInstance.componentType.name;

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

@@ -1,5 +1,4 @@
-import type { Color } from '@salsita-ai/common/utils';
-import type { ComponentSnapshot } from '../core/component.js';
+import { type ComponentSnapshot } from '../core/index.js';
 /**
  * Zero-volume point collision geometry at a local `(x, y, z)`. Authored
  * via the position in the entity's local frame. Internally rendered as a
@@ -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/collision-point-geometry.js

@@ -1 +1 @@
-import{SystemComponentBuilder as o}from"../components/system-component-builder.js";export const collisionPointGeometryComponent=o.component("collisionPointGeometry").withState({type:"object",tsType:"CollisionPointGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionPointGeometryComponentState"}],properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"},color:{type:"string"}},required:["x","y","z","color"],additionalProperties:!1}).build();export const isCollisionPointGeometryComponent=o=>"collisionPointGeometry"===o.componentInstance.componentType.name;
+import{SystemComponentBuilder as o}from"../core/index.js";export const collisionPointGeometryComponent=o.component("collisionPointGeometry").withState({type:"object",tsType:"CollisionPointGeometryComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CollisionPointGeometryComponentState"}],properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"},color:{type:"string"}},required:["x","y","z","color"],additionalProperties:!1}).build();export const isCollisionPointGeometryComponent=o=>"collisionPointGeometry"===o.componentInstance.componentType.name;

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

@@ -1,10 +1,6 @@
-export { type AngleIndicatorBaseState, AngleIndicatorProperties } from './angle-indicator-schema.js';
 export { type RecipeListItem, recipeListItemSchema } from './recipes.js';
 export { ReactNodeSchema, type ReactNodeSchemaType } from './react-node-schema.js';
 export { type SceneEntityHtmlPositionState, type SceneEntityHtmlOpacityState, type SceneEntityHtmlVisibilityState, type SceneEntityHtmlOpacityLimits, type SceneEntityHtmlTooltipState, SceneHtmlPositionProperties, SceneHtmlOpacityProperties, SceneHtmlVisibilityProperties, SceneHtmlTooltipProperties, } from './scene-entity-control-schema.js';
 export { type DraggableSurface, DraggableSurfaceSchema } from './dragging.js';
-export { ArrowHeadType, ArrowHeadTypeSchema } from './dimension-indicators.js';
-export { type EditableIndicatorButtonVariant, EditableIndicatorButtonVariantSchema, } from './editable-indicator-button-variant.js';
-export { type DimensionIndicatorBaseState, type DimensionIndicatorState, DimensionIndicatorBaseProperties, DimensionIndicatorProperties, } from './dimension-indicator-schema.js';
 export { type MaterialOverrideBaseState, MaterialOverrideProperties } from './material-override-schema.js';
 export { type GroupedRecipeItems, type GroupedRecipeGroup, type GroupedRecipes, GroupedRecipeItemsSchema, GroupedRecipeGroupSchema, GroupedRecipesSchema, } from './recipes.js';

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

@@ -1 +1 @@
-export{AngleIndicatorProperties}from"./angle-indicator-schema.js";export{recipeListItemSchema,GroupedRecipeItemsSchema,GroupedRecipeGroupSchema,GroupedRecipesSchema}from"./recipes.js";export{ReactNodeSchema}from"./react-node-schema.js";export{SceneHtmlPositionProperties,SceneHtmlOpacityProperties,SceneHtmlVisibilityProperties,SceneHtmlTooltipProperties}from"./scene-entity-control-schema.js";export{DraggableSurfaceSchema}from"./dragging.js";export{ArrowHeadType,ArrowHeadTypeSchema}from"./dimension-indicators.js";export{EditableIndicatorButtonVariantSchema}from"./editable-indicator-button-variant.js";export{DimensionIndicatorBaseProperties,DimensionIndicatorProperties}from"./dimension-indicator-schema.js";export{MaterialOverrideProperties}from"./material-override-schema.js";
+export{recipeListItemSchema,GroupedRecipeItemsSchema,GroupedRecipeGroupSchema,GroupedRecipesSchema}from"./recipes.js";export{ReactNodeSchema}from"./react-node-schema.js";export{SceneHtmlPositionProperties,SceneHtmlOpacityProperties,SceneHtmlVisibilityProperties,SceneHtmlTooltipProperties}from"./scene-entity-control-schema.js";export{DraggableSurfaceSchema}from"./dragging.js";export{MaterialOverrideProperties}from"./material-override-schema.js";

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,6 +1,5 @@
 import { type Localizable } from '@salsita-ai/common/utils';
-import type { DomainEntity } from '../../core/index.js';
-import { type EntityRecipe } from '../../domain-context/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.
@@ -30,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: {
@@ -90,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"]}};