@salsita-ai/sdk 0.50.0-develop.30ea3b5e1a → 0.50.0-develop.32ab4dfdc8

package/dist/domain/domain-runtime/web-component/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";export const createWebComponentSelectors=o=>{let{getState:n}=o,t=e.withTypes(),a=t([t.leaf(e=>e.webComponent.readonly)],e=>e),r=t([t.leaf(e=>e.webComponent.webcomponentGeneration)],e=>e);return{selectReadonly:a,getReadonly:()=>a(n()),getWebcomponentGeneration:()=>r(n())}};
+import{createSelector as e}from"@salsita-ai/common/utils";export const createWebComponentSelectors=o=>{let{getState:n}=o,t=e.withTypes(),a=t([t.leaf(e=>e.webComponent.readonly)],e=>e),l=t.leaf(e=>e.webComponent.locale),m=t([t.leaf(e=>e.webComponent.webcomponentGeneration)],e=>e);return{selectReadonly:a,getReadonly:()=>a(n()),selectLocale:l,getLocale:()=>l(n()),getWebcomponentGeneration:()=>m(n())}};

package/dist/domain/domain-runtime/web-component/types.d.ts

@@ -1,12 +1,15 @@
 /**
  * Runtime-owned web-component state shared by configurator and admin applications.
  *
- * CON-2493 moves the complete property and lifecycle surface into the runtime. Until then,
- * `readonly` is synchronized from the host property so non-React domain systems can derive the
- * current effective mode from runtime selectors.
+ * The application runtime mirrors the host properties a domain system reads, `readonly` and
+ * `locale`, from the element into this slice, so non-React domain systems read them from runtime
+ * selectors. The element's property storage stays their source.
  */
 export interface ApplicationWebComponentState {
+    /** The host's `readonly` property; the effective mode derives from it. */
     readonly readonly: boolean;
+    /** The host's `locale` property as set, not resolved against the available locales. */
+    readonly locale: string;
     /**
      * Bumped when the host moves the custom element in the DOM and the element is reconnected with
      * its React tree retained. A move resets the CSSOM of every speedy emotion `<style>` tag inside

package/dist/domain/extensions/export-images/agent-screenshot.d.ts

@@ -0,0 +1,30 @@
+import { type HexColor } from '@salsita-ai/common/utils';
+/**
+ * The largest width and height of an assistant screenshot, in pixels. The provider fits every image
+ * within 2048 × 2048 before the model reads it, and then reads it at a short side of 768, so a
+ * larger screenshot would only cost render and upload time.
+ */
+export declare const AGENT_SCREENSHOT_MAX_SIDE = 2048;
+/**
+ * How the AI assistant photographs an entity from one predefined view: the export state, size and
+ * format of the picture and the UI states it is taken in. Evaluated per entity like any component
+ * state, so it may be expression-driven.
+ */
+export type AgentScreenshotComponentState = {
+    readonly exportState: string;
+    readonly width: number;
+    readonly height: number;
+    readonly fileFormat: 'PNG' | 'JPEG';
+    readonly backgroundColor?: HexColor;
+    readonly toolState: string;
+    readonly viewState: string;
+    readonly navigationState: string;
+};
+/**
+ * A view the AI assistant can take a screenshot of an entity from, under `meta { screenshot }` of
+ * its GraphQL schema. The instance name is the view name, and the `assistant.screenshots` manifest
+ * exposes it. Same shape as `clientSideImage`, but a distinct type, so the finalization images
+ * never render it.
+ */
+export declare const agentScreenshotComponent: import("../../index.js").SystemComponentType<"agentScreenshot", AgentScreenshotComponentState, never>;
+export type AgentScreenshotComponent = typeof agentScreenshotComponent;

package/dist/domain/extensions/export-images/agent-screenshot.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as t}from"../../core/index.js";export const AGENT_SCREENSHOT_MAX_SIDE=2048;export const agentScreenshotComponent=t.component("agentScreenshot").withState({type:"object",tsType:"AgentScreenshotComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AgentScreenshotComponentState"}],properties:{exportState:{type:"string"},width:{type:"number",maximum:2048},height:{type:"number",maximum:2048},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();

package/dist/domain/extensions/{client-side-image.d.ts → export-images/client-side-image.d.ts}

@@ -9,6 +9,6 @@ export type ClientSideImageComponentState = {
     readonly viewState: string;
     readonly navigationState: string;
 };
-export declare const clientSideImageComponent: import("../index.js").SystemComponentType<"clientSideImage", ClientSideImageComponentState, never>;
+export declare const clientSideImageComponent: import("../../index.js").SystemComponentType<"clientSideImage", ClientSideImageComponentState, never>;
 export type ClientSideImageComponent = typeof clientSideImageComponent;
-export declare const isClientSideImageComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"clientSideImage", ClientSideImageComponentState, never>>;
+export declare const isClientSideImageComponentSnapshot: (snapshot: import("../../index.js").ComponentSnapshot<import("../../index.js").SystemComponentTypeConstraint>) => snapshot is import("../../index.js").ComponentSnapshot<import("../../index.js").SystemComponentType<"clientSideImage", ClientSideImageComponentState, never>>;

package/dist/domain/extensions/export-images/client-side-image.js

@@ -0,0 +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}$",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/export-images/index.d.ts

@@ -0,0 +1,3 @@
+export { AGENT_SCREENSHOT_MAX_SIDE, agentScreenshotComponent, type AgentScreenshotComponent, type AgentScreenshotComponentState, } from './agent-screenshot.js';
+export { clientSideImageComponent, type ClientSideImageComponent, type ClientSideImageComponentState, } from './client-side-image.js';
+export { saveTemplateThumbnailComponent, type SaveTemplateThumbnailComponent, type SaveTemplateThumbnailComponentState, } from './save-template-thumbnail.js';

package/dist/domain/extensions/export-images/index.js

@@ -0,0 +1 @@
+export{AGENT_SCREENSHOT_MAX_SIDE,agentScreenshotComponent}from"./agent-screenshot.js";export{clientSideImageComponent}from"./client-side-image.js";export{saveTemplateThumbnailComponent}from"./save-template-thumbnail.js";

package/dist/domain/extensions/{save-template-thumbnail.d.ts → export-images/save-template-thumbnail.d.ts}

@@ -9,6 +9,6 @@ export type SaveTemplateThumbnailComponentState = {
     readonly viewState: string;
     readonly navigationState: string;
 };
-export declare const saveTemplateThumbnailComponent: import("../index.js").SystemComponentType<"saveTemplateThumbnail", SaveTemplateThumbnailComponentState, never>;
+export declare const saveTemplateThumbnailComponent: import("../../index.js").SystemComponentType<"saveTemplateThumbnail", SaveTemplateThumbnailComponentState, never>;
 export type SaveTemplateThumbnailComponent = typeof saveTemplateThumbnailComponent;
-export declare const isSaveTemplateThumbnailComponentSnapshot: (snapshot: import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is import("../index.js").ComponentSnapshot<import("../index.js").SystemComponentType<"saveTemplateThumbnail", SaveTemplateThumbnailComponentState, never>>;
+export declare const isSaveTemplateThumbnailComponentSnapshot: (snapshot: import("../../index.js").ComponentSnapshot<import("../../index.js").SystemComponentTypeConstraint>) => snapshot is import("../../index.js").ComponentSnapshot<import("../../index.js").SystemComponentType<"saveTemplateThumbnail", SaveTemplateThumbnailComponentState, never>>;

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

@@ -0,0 +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}$",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/index.d.ts

@@ -30,7 +30,6 @@ export { offsetComponent, isOffsetSnapshot, isOffsetInstance, type OffsetCompone
 export { navigationStepsComponent, type NavigationStep, type NavigationStepsComponent, type NavigationStepsComponentState, } from './navigation-steps.js';
 export { propertyPageComponent, type PropertyPageComponent, type PropertyPageComponentState, type PropertyPageComponentSnapshot, type PropertyPageComponentInstance, isPropertyPageSnapshot, isPropertyPageInstance, } from './property-page.js';
 export { rotationHandleComponent, type RotatableSurface, type RotationHandleComponent, type RotationHandleComponentState, } from './rotation-handle.js';
-export { saveTemplateThumbnailComponent, type SaveTemplateThumbnailComponent, type SaveTemplateThumbnailComponentState, } from './save-template-thumbnail.js';
 export { sceneEntityAnimationComponent, type SceneEntityAnimationComponent, type SceneEntityAnimationComponentState, } from './scene-entity-animation.js';
 export { sidebarTabsComponent, type SidebarTab, type SidebarTabsComponent, type SidebarTabsComponentState, type SidebarTabsComponentSnapshot, type SidebarTabsComponentInstance, isSidebarTabsSnapshot, isSidebarTabsInstance, } from './sidebar-tabs.js';
 export { isSimpleSummaryComponentSnapshot, simpleSummaryComponent, type SimpleSummaryComponent, type SimpleSummaryComponentState, type SimpleSummaryItem, } from './simple-summary.js';
@@ -63,7 +62,7 @@ export { canvasPresetEnvironmentComponent, isCanvasPresetEnvironmentInstance, is
 export { canvasCustomEnvironmentComponent, isCanvasCustomEnvironmentInstance, isCanvasCustomEnvironmentSnapshot, type CanvasCustomEnvironmentComponent, type CanvasCustomEnvironmentComponentInstance, type CanvasCustomEnvironmentComponentSnapshot, type CanvasCustomEnvironmentComponentState, } from './canvas-custom-environment.js';
 export { toolMenuFabComponent, isToolMenuFabComponentSnapshot, isToolMenuFabComponentInstance, type ToolMenuFabOption, type ToolMenuFabComponent, type ToolMenuFabComponentInstance, type ToolMenuFabComponentSnapshot, type ToolMenuFabComponentState, } from './tool-menu-fab.js';
 export { exitToolModeFabComponent, isExitToolModeFabComponentSnapshot, isExitToolModeFabComponentInstance, type ExitToolModeFabComponent, type ExitToolModeFabComponentInstance, type ExitToolModeFabComponentSnapshot, type ExitToolModeFabComponentState, } from './exit-tool-mode-fab.js';
-export { clientSideImageComponent, type ClientSideImageComponent, type ClientSideImageComponentState, } from './client-side-image.js';
+export { AGENT_SCREENSHOT_MAX_SIDE, agentScreenshotComponent, type AgentScreenshotComponent, type AgentScreenshotComponentState, clientSideImageComponent, type ClientSideImageComponent, type ClientSideImageComponentState, saveTemplateThumbnailComponent, type SaveTemplateThumbnailComponent, type SaveTemplateThumbnailComponentState, } from './export-images/index.js';
 export { cameraBasedHiddenEntityComponent, type CameraBasedHiddenEntityComponent, type CameraBasedHiddenEntityComponentState, isCameraBasedHiddenEntityComponent, } from './camera-based-hidden-entity.js';
 export { cameraBasedHiddenEntityObjectComponent, type CameraBasedHiddenEntityObjectComponent, type CameraBasedHiddenEntityObjectComponentState, isCameraBasedHiddenEntityObjectComponent, } from './camera-based-hidden-entity-object.js';
 export { sceneEntityControlComponent, isSceneEntityControlComponentSnapshot, isSceneEntityControlComponentInstance, type SceneEntityControlComponentSnapshot, type SceneEntityControlComponentInstance, type SceneEntityControlComponent, type SceneEntityControlComponentState, } from './scene-entity-control.js';

package/dist/domain/extensions/index.js

@@ -1 +1 @@
-export*from"./common/index.js";export{attributeSwitchComponent}from"./attribute-switch.js";export{childEntityRecipeHierarchyComponent,isChildEntityRecipeHierarchySnapshot,isChildEntityRecipeHierarchyInstance}from"./child-entity-recipe-hierarchy.js";export{dimensionIndicatorComponent,isDimensionIndicatorSnapshot}from"./dimension-indicator.js";export{angleIndicatorComponent,isAngleIndicatorSnapshot}from"./angle-indicator.js";export{editableAngleIndicatorComponent,isEditableAngleIndicatorSnapshot}from"./editable-angle-indicator.js";export{editableDistanceDimensionIndicatorComponent,isEditableDistanceDimensionIndicatorSnapshot}from"./editable-distance-dimension-indicator.js";export{editableSizeIndicatorComponent,isEditableSizeIndicatorSnapshot}from"./editable-size-indicator.js";export{editableOffsetIndicatorComponent,isEditableOffsetIndicatorSnapshot}from"./editable-offset-indicator.js";export{offsetAnchorsComponent,isOffsetAnchorsSnapshot}from"./offset-anchors.js";export{offsetIndicatorComponent,isOffsetIndicatorSnapshot}from"./offset-indicator.js";export{listSelectorDimensionIndicatorComponent,isListSelectorDimensionIndicatorSnapshot}from"./list-selector-dimension-indicator.js";export{replaceEntityRecipeHierarchyComponent,isReplaceEntityRecipeHierarchySnapshot,isReplaceEntityRecipeHierarchyInstance}from"./replace-entity-recipe-hierarchy.js";export{rotatableComponent}from"./rotatable.js";export{isSceneEntityAddFabComponentSnapshot,sceneEntityAddFabComponent}from"./scene-entity-add-fab.js";export{isSceneEntityDeleteFabComponentSnapshot,sceneEntityDeleteFabComponent}from"./scene-entity-delete-fab.js";export{isSceneEntityNavigationHotspotComponentSnapshot,sceneEntityNavigationHotspotComponent}from"./scene-entity-navigation-hotspot.js";export{htmlHotspotComponent,isHtmlHotspotComponentSnapshot,isHtmlHotspotComponentInstance}from"./scene-entity-html-hotspot.js";export{sceneEntityObjectHtmlHotspotComponent,isSceneEntityObjectHtmlHotspotComponentSnapshot,isSceneEntityObjectHtmlHotspotComponentInstance}from"./scene-entity-object-html-hotspot.js";export{isSceneEntitySelectHotspotComponentSnapshot,sceneEntitySelectHotspotComponent}from"./scene-entity-select-hotspot.js";export{customPriceFooterComponent}from"./custom-price-footer.js";export{entityHeaderComponent}from"./entity-header.js";export{finalizeButtonComponent,finalizePageComponent}from"./finalize-component.js";export{fitSelectionOrthographicCameraComponent,isFitSelectionOrthographicCameraComponent}from"./fit-selection-orthographic-camera-component.js";export{fitSelectionPerspectiveCameraComponent,isFitSelectionPerspectiveCameraComponent}from"./fit-selection-perspective-camera-component.js";export{autorotateCameraComponent,isAutorotateCameraComponent}from"./autorotate-camera-component.js";export{selectableComponent}from"./selectable-component.js";export{sizeComponent,isSizeSnapshot,isSizeInstance}from"./size.js";export{offsetComponent,isOffsetSnapshot,isOffsetInstance}from"./offset.js";export{navigationStepsComponent}from"./navigation-steps.js";export{propertyPageComponent,isPropertyPageSnapshot,isPropertyPageInstance}from"./property-page.js";export{rotationHandleComponent}from"./rotation-handle.js";export{saveTemplateThumbnailComponent}from"./save-template-thumbnail.js";export{sceneEntityAnimationComponent}from"./scene-entity-animation.js";export{sidebarTabsComponent,isSidebarTabsSnapshot,isSidebarTabsInstance}from"./sidebar-tabs.js";export{isSimpleSummaryComponentSnapshot,simpleSummaryComponent}from"./simple-summary.js";export{customSummaryPageComponent,isCustomSummaryComponentSnapshot}from"./summary-component.js";export{colorValueComponent}from"./color-value.js";export{textValueComponent}from"./text-value.js";export{toolControlsComponent}from"./tool-controls.js";export{viewControlsComponent}from"./view-controls.js";export{multilingualTextValueComponent}from"./multilingual-text-value.js";export{isSceneEntityFloorObjectComponent,sceneEntityFloorObjectComponent}from"./scene-entity-floor-object.js";export{isSceneEntityWallObjectComponent,sceneEntityWallObjectComponent}from"./scene-entity-wall-object.js";export{isSketchingDrawSnapshot,isSketchingDrawInstance,sketchingDrawComponent}from"./sketching-draw.js";export{isSketchingEditSnapshot,isSketchingEditInstance,sketchingEditComponent}from"./sketching-edit.js";export{toolbarComponent,isToolbarSnapshot,isToolbarInstance}from"./toolbar.js";export{finalizeActionComponent,isFinalizeActionSnapshot,isFinalizeActionInstance}from"./finalize-action.js";export{otherActionComponent,isOtherActionSnapshot,isOtherActionInstance}from"./other-action.js";export{hiddenSidebarFooterComponent,isHiddenSidebarFooterSnapshot,isHiddenSidebarFooterInstance}from"./hidden-sidebar-footer.js";export{universalSidebarFooterComponent,isUniversalSidebarFooterSnapshot,isUniversalSidebarFooterInstance}from"./universal-sidebar-footer.js";export{basicSidebarFooterComponent,isBasicSidebarFooterSnapshot,isBasicSidebarFooterInstance}from"./basic-sidebar-footer.js";export{readSidebarFooterComponent,isReadSidebarFooterSnapshot,isReadSidebarFooterInstance}from"./read-sidebar-footer.js";export{customSidebarFooterComponent,isCustomSidebarFooterSnapshot,isCustomSidebarFooterInstance}from"./custom-sidebar-footer.js";export{canvasPaddingComponent,isCanvasPaddingInstance,isCanvasPaddingSnapshot}from"./canvas-padding.js";export{floatingHeaderComponent,isFloatingHeaderSnapshot,isFloatingHeaderInstance}from"./floating-header.js";export{customHeaderComponent,isCustomHeaderSnapshot,isCustomHeaderInstance}from"./custom-header.js";export{fixedHeaderComponent,isFixedHeaderSnapshot,isFixedHeaderInstance}from"./fixed-header.js";export{hiddenHeaderComponent,isHiddenHeaderSnapshot,isHiddenHeaderInstance}from"./hidden-header.js";export{horizontalTabsComponent,isHorizontalTabsSnapshot,isHorizontalTabsInstance}from"./horizontal-tabs.js";export{canvasConfigComponent,isCanvasConfigInstance,isCanvasConfigSnapshot}from"./canvas-config.js";export{canvasPresetEnvironmentComponent,isCanvasPresetEnvironmentInstance,isCanvasPresetEnvironmentSnapshot}from"./canvas-preset-environment.js";export{canvasCustomEnvironmentComponent,isCanvasCustomEnvironmentInstance,isCanvasCustomEnvironmentSnapshot}from"./canvas-custom-environment.js";export{toolMenuFabComponent,isToolMenuFabComponentSnapshot,isToolMenuFabComponentInstance}from"./tool-menu-fab.js";export{exitToolModeFabComponent,isExitToolModeFabComponentSnapshot,isExitToolModeFabComponentInstance}from"./exit-tool-mode-fab.js";export{clientSideImageComponent}from"./client-side-image.js";export{cameraBasedHiddenEntityComponent,isCameraBasedHiddenEntityComponent}from"./camera-based-hidden-entity.js";export{cameraBasedHiddenEntityObjectComponent,isCameraBasedHiddenEntityObjectComponent}from"./camera-based-hidden-entity-object.js";export{sceneEntityControlComponent,isSceneEntityControlComponentSnapshot,isSceneEntityControlComponentInstance}from"./scene-entity-control.js";
+export*from"./common/index.js";export{attributeSwitchComponent}from"./attribute-switch.js";export{childEntityRecipeHierarchyComponent,isChildEntityRecipeHierarchySnapshot,isChildEntityRecipeHierarchyInstance}from"./child-entity-recipe-hierarchy.js";export{dimensionIndicatorComponent,isDimensionIndicatorSnapshot}from"./dimension-indicator.js";export{angleIndicatorComponent,isAngleIndicatorSnapshot}from"./angle-indicator.js";export{editableAngleIndicatorComponent,isEditableAngleIndicatorSnapshot}from"./editable-angle-indicator.js";export{editableDistanceDimensionIndicatorComponent,isEditableDistanceDimensionIndicatorSnapshot}from"./editable-distance-dimension-indicator.js";export{editableSizeIndicatorComponent,isEditableSizeIndicatorSnapshot}from"./editable-size-indicator.js";export{editableOffsetIndicatorComponent,isEditableOffsetIndicatorSnapshot}from"./editable-offset-indicator.js";export{offsetAnchorsComponent,isOffsetAnchorsSnapshot}from"./offset-anchors.js";export{offsetIndicatorComponent,isOffsetIndicatorSnapshot}from"./offset-indicator.js";export{listSelectorDimensionIndicatorComponent,isListSelectorDimensionIndicatorSnapshot}from"./list-selector-dimension-indicator.js";export{replaceEntityRecipeHierarchyComponent,isReplaceEntityRecipeHierarchySnapshot,isReplaceEntityRecipeHierarchyInstance}from"./replace-entity-recipe-hierarchy.js";export{rotatableComponent}from"./rotatable.js";export{isSceneEntityAddFabComponentSnapshot,sceneEntityAddFabComponent}from"./scene-entity-add-fab.js";export{isSceneEntityDeleteFabComponentSnapshot,sceneEntityDeleteFabComponent}from"./scene-entity-delete-fab.js";export{isSceneEntityNavigationHotspotComponentSnapshot,sceneEntityNavigationHotspotComponent}from"./scene-entity-navigation-hotspot.js";export{htmlHotspotComponent,isHtmlHotspotComponentSnapshot,isHtmlHotspotComponentInstance}from"./scene-entity-html-hotspot.js";export{sceneEntityObjectHtmlHotspotComponent,isSceneEntityObjectHtmlHotspotComponentSnapshot,isSceneEntityObjectHtmlHotspotComponentInstance}from"./scene-entity-object-html-hotspot.js";export{isSceneEntitySelectHotspotComponentSnapshot,sceneEntitySelectHotspotComponent}from"./scene-entity-select-hotspot.js";export{customPriceFooterComponent}from"./custom-price-footer.js";export{entityHeaderComponent}from"./entity-header.js";export{finalizeButtonComponent,finalizePageComponent}from"./finalize-component.js";export{fitSelectionOrthographicCameraComponent,isFitSelectionOrthographicCameraComponent}from"./fit-selection-orthographic-camera-component.js";export{fitSelectionPerspectiveCameraComponent,isFitSelectionPerspectiveCameraComponent}from"./fit-selection-perspective-camera-component.js";export{autorotateCameraComponent,isAutorotateCameraComponent}from"./autorotate-camera-component.js";export{selectableComponent}from"./selectable-component.js";export{sizeComponent,isSizeSnapshot,isSizeInstance}from"./size.js";export{offsetComponent,isOffsetSnapshot,isOffsetInstance}from"./offset.js";export{navigationStepsComponent}from"./navigation-steps.js";export{propertyPageComponent,isPropertyPageSnapshot,isPropertyPageInstance}from"./property-page.js";export{rotationHandleComponent}from"./rotation-handle.js";export{sceneEntityAnimationComponent}from"./scene-entity-animation.js";export{sidebarTabsComponent,isSidebarTabsSnapshot,isSidebarTabsInstance}from"./sidebar-tabs.js";export{isSimpleSummaryComponentSnapshot,simpleSummaryComponent}from"./simple-summary.js";export{customSummaryPageComponent,isCustomSummaryComponentSnapshot}from"./summary-component.js";export{colorValueComponent}from"./color-value.js";export{textValueComponent}from"./text-value.js";export{toolControlsComponent}from"./tool-controls.js";export{viewControlsComponent}from"./view-controls.js";export{multilingualTextValueComponent}from"./multilingual-text-value.js";export{isSceneEntityFloorObjectComponent,sceneEntityFloorObjectComponent}from"./scene-entity-floor-object.js";export{isSceneEntityWallObjectComponent,sceneEntityWallObjectComponent}from"./scene-entity-wall-object.js";export{isSketchingDrawSnapshot,isSketchingDrawInstance,sketchingDrawComponent}from"./sketching-draw.js";export{isSketchingEditSnapshot,isSketchingEditInstance,sketchingEditComponent}from"./sketching-edit.js";export{toolbarComponent,isToolbarSnapshot,isToolbarInstance}from"./toolbar.js";export{finalizeActionComponent,isFinalizeActionSnapshot,isFinalizeActionInstance}from"./finalize-action.js";export{otherActionComponent,isOtherActionSnapshot,isOtherActionInstance}from"./other-action.js";export{hiddenSidebarFooterComponent,isHiddenSidebarFooterSnapshot,isHiddenSidebarFooterInstance}from"./hidden-sidebar-footer.js";export{universalSidebarFooterComponent,isUniversalSidebarFooterSnapshot,isUniversalSidebarFooterInstance}from"./universal-sidebar-footer.js";export{basicSidebarFooterComponent,isBasicSidebarFooterSnapshot,isBasicSidebarFooterInstance}from"./basic-sidebar-footer.js";export{readSidebarFooterComponent,isReadSidebarFooterSnapshot,isReadSidebarFooterInstance}from"./read-sidebar-footer.js";export{customSidebarFooterComponent,isCustomSidebarFooterSnapshot,isCustomSidebarFooterInstance}from"./custom-sidebar-footer.js";export{canvasPaddingComponent,isCanvasPaddingInstance,isCanvasPaddingSnapshot}from"./canvas-padding.js";export{floatingHeaderComponent,isFloatingHeaderSnapshot,isFloatingHeaderInstance}from"./floating-header.js";export{customHeaderComponent,isCustomHeaderSnapshot,isCustomHeaderInstance}from"./custom-header.js";export{fixedHeaderComponent,isFixedHeaderSnapshot,isFixedHeaderInstance}from"./fixed-header.js";export{hiddenHeaderComponent,isHiddenHeaderSnapshot,isHiddenHeaderInstance}from"./hidden-header.js";export{horizontalTabsComponent,isHorizontalTabsSnapshot,isHorizontalTabsInstance}from"./horizontal-tabs.js";export{canvasConfigComponent,isCanvasConfigInstance,isCanvasConfigSnapshot}from"./canvas-config.js";export{canvasPresetEnvironmentComponent,isCanvasPresetEnvironmentInstance,isCanvasPresetEnvironmentSnapshot}from"./canvas-preset-environment.js";export{canvasCustomEnvironmentComponent,isCanvasCustomEnvironmentInstance,isCanvasCustomEnvironmentSnapshot}from"./canvas-custom-environment.js";export{toolMenuFabComponent,isToolMenuFabComponentSnapshot,isToolMenuFabComponentInstance}from"./tool-menu-fab.js";export{exitToolModeFabComponent,isExitToolModeFabComponentSnapshot,isExitToolModeFabComponentInstance}from"./exit-tool-mode-fab.js";export{AGENT_SCREENSHOT_MAX_SIDE,agentScreenshotComponent,clientSideImageComponent,saveTemplateThumbnailComponent}from"./export-images/index.js";export{cameraBasedHiddenEntityComponent,isCameraBasedHiddenEntityComponent}from"./camera-based-hidden-entity.js";export{cameraBasedHiddenEntityObjectComponent,isCameraBasedHiddenEntityObjectComponent}from"./camera-based-hidden-entity-object.js";export{sceneEntityControlComponent,isSceneEntityControlComponentSnapshot,isSceneEntityControlComponentInstance}from"./scene-entity-control.js";

package/dist/domain/index.d.ts

@@ -1,5 +1,5 @@
 export * from './core/index.js';
-export { DomainBuilder } from './domain-builder.js';
+export { DomainBuilder } from './domain-builder/index.js';
 export { memoEval, isMemoizedArray, isMemoizedObject, type MemoizedArray, type MemoizedObject, } from './utils/memo-eval.js';
 export { cloneEvalCache, getEvalCache, setEvalCache, type EvalCacheToken, createEvalCacheToken, } from './utils/eval-cache.js';
 export { areProfilerLabelsEnabled, setProfilerLabelsEnabled } from './utils/profiler-label.js';
@@ -13,6 +13,7 @@ export * from './admin-domain/index.js';
 export * from './application/index.js';
 export * from './scene/index.js';
 export { getAllPhxDefinitions } from './system-definitions.js';
-export { availableSystemComponents, componentsByName } from './available-system-components.js';
+export { availableSystemComponents, componentsByName } from './available-system-components/index.js';
 export * from './mocks/index.js';
 export * from './domain-runtime/index.js';
+export * from './spec/index.js';

package/dist/domain/index.js

@@ -1 +1 @@
-export*from"./core/index.js";export{DomainBuilder}from"./domain-builder.js";export{memoEval,isMemoizedArray,isMemoizedObject}from"./utils/memo-eval.js";export{cloneEvalCache,getEvalCache,setEvalCache,createEvalCacheToken}from"./utils/eval-cache.js";export{areProfilerLabelsEnabled,setProfilerLabelsEnabled}from"./utils/profiler-label.js";export*from"./dimensions/index.js";export*from"./domain-context/index.js";export*from"./system-components/index.js";export*from"./extensions/index.js";export*from"./sketching/index.js";export*from"./projections/index.js";export*from"./admin-domain/index.js";export*from"./application/index.js";export*from"./scene/index.js";export{getAllPhxDefinitions}from"./system-definitions.js";export{availableSystemComponents,componentsByName}from"./available-system-components.js";export*from"./mocks/index.js";export*from"./domain-runtime/index.js";
+export*from"./core/index.js";export{DomainBuilder}from"./domain-builder/index.js";export{memoEval,isMemoizedArray,isMemoizedObject}from"./utils/memo-eval.js";export{cloneEvalCache,getEvalCache,setEvalCache,createEvalCacheToken}from"./utils/eval-cache.js";export{areProfilerLabelsEnabled,setProfilerLabelsEnabled}from"./utils/profiler-label.js";export*from"./dimensions/index.js";export*from"./domain-context/index.js";export*from"./system-components/index.js";export*from"./extensions/index.js";export*from"./sketching/index.js";export*from"./projections/index.js";export*from"./admin-domain/index.js";export*from"./application/index.js";export*from"./scene/index.js";export{getAllPhxDefinitions}from"./system-definitions.js";export{availableSystemComponents,componentsByName}from"./available-system-components/index.js";export*from"./mocks/index.js";export*from"./domain-runtime/index.js";export*from"./spec/index.js";

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

@@ -83,6 +83,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
             selectElementSlots: import("@salsita-ai/common/utils").Selector<import("../index.js").SpecSelectorState, {
                 entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             }>;
             selectDataConfig: import("@salsita-ai/common/utils").Selector<import("../index.js").SpecSelectorState, import("../index.js").DataSpec | null>;
@@ -126,6 +127,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
             getElementSlots: () => {
                 entityElements: Record<string, (props: import("../index.js").CustomPhoenixEntityElementProps) => JSX.Element>;
                 layoutElements: Record<string, (props: import("react").PropsWithChildren) => JSX.Element>;
+                assistantFormElements: Record<string, import("react").ComponentType<never>>;
                 hashes: Record<string, string>;
             };
             getDataConfig: () => import("../index.js").DataSpec | null;
@@ -339,6 +341,8 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
         webComponent: {
             selectReadonly: import("@salsita-ai/common/utils").Selector<import("../index.js").WebComponentSelectorState, boolean>;
             getReadonly: () => boolean;
+            selectLocale: import("@salsita-ai/common/utils").Selector<import("../index.js").WebComponentSelectorState, string>;
+            getLocale: () => string;
             getWebcomponentGeneration: () => number;
         };
         domainContext: {
@@ -412,6 +416,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getMigrate: () => import("../index.js").MigrateFunction<DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
@@ -521,6 +526,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getMigrate: () => import("../index.js").MigrateFunction<DomainEntity<string>>;
                 getActiveMode: () => import("../index.js").DomainMode;
                 getIsInitialized: () => boolean;
+                getIsViewMode: () => boolean;
                 getComponentReaderIndexes: () => import("../index.js").ComponentReaderIndexes;
                 getStoreRuntimeDependencies: () => {
                     componentReaderIndexes: import("../index.js").ComponentReaderIndexes;
@@ -625,6 +631,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
             };
         };
     };
+    hostMirrorActions: {
+        setLocale: (locale: string) => void;
+    };
     getState: () => import("../index.js").DomainRuntimeState;
     subscribe: (callback: () => void) => () => void;
 };

package/dist/domain/spec/application/admin-pages-section.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The `$adminPages` section of an admin spec file as it is written, which the parsed admin pages
+ * keep as their `spec`. `application-spec` exports it as `RawAdminPages`, and the application
+ * config takes it as `AdminPagesSpec`.
+ */
+export interface AdminPagesSection {
+    readonly presets?: boolean | {
+        readonly categoryNavigationState?: string;
+        readonly presetNavigationState?: string;
+    };
+    readonly recipes?: ReadonlyArray<{
+        readonly name: string;
+        readonly navigationState?: string;
+    }>;
+    readonly pages?: ReadonlyArray<{
+        readonly key: string;
+        readonly title: string;
+        readonly icon?: string;
+        readonly navigationState?: string;
+        readonly entity?: string;
+        readonly component?: string;
+        readonly actionsComponent?: string;
+        readonly connectedDataEntry?: string;
+        readonly sidebar?: {
+            readonly title: string;
+            readonly component: string;
+        };
+    }>;
+}

package/dist/domain/spec/application/admin-pages-section.js

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

package/dist/domain/spec/application/admin-pages.d.ts

@@ -0,0 +1,26 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { ComponentEntry } from '../components/index.js';
+import type { AdminPagesSection } from './admin-pages-section.js';
+/**
+ * The parsed admin pages of an admin spec: the `$adminPages` section as written, the components
+ * the pages attach, the items of the admin navigation and the navigation states the pages add.
+ */
+export type AdminPages = Branded<'AdminPages', {
+    readonly spec: AdminPagesSection;
+    readonly components: readonly ComponentEntry[];
+    readonly navigationItems: readonly AdminNavigationItem[];
+    readonly navigationStates: readonly string[];
+}>;
+interface AdminNavigationListItem {
+    readonly label: string;
+    readonly icon?: string;
+    readonly navigationStates: readonly string[];
+}
+interface AdminNestedNavigationListItem {
+    readonly label: string;
+    readonly icon?: string;
+    readonly items: ReadonlyArray<Omit<AdminNavigationListItem, 'icon'>>;
+}
+/** One item of the admin navigation: a list item, or a nested list of them. */
+export type AdminNavigationItem = AdminNavigationListItem | AdminNestedNavigationListItem;
+export {};

package/dist/domain/spec/application/admin-pages.js

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

package/dist/domain/spec/application/admin-states.d.ts

@@ -0,0 +1,5 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { StateValue } from '../sections/index.js';
+export type AdminStates = Branded<'AdminStates', {
+    readonly navigationStates: readonly StateValue[];
+}>;

package/dist/domain/spec/application/admin-states.js

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

package/dist/domain/spec/application/configurator-states.d.ts

@@ -0,0 +1,8 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { StateValue } from '../sections/index.js';
+export type ConfiguratorStates = Branded<'ConfiguratorStates', {
+    readonly navigationStates: readonly StateValue[];
+    readonly viewStates: readonly StateValue[];
+    readonly toolStates: readonly StateValue[];
+    readonly exportStates: readonly StateValue[];
+}>;

package/dist/domain/spec/application/configurator-states.js

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

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

@@ -0,0 +1,5 @@
+export type * from './admin-pages.js';
+export type * from './admin-pages-section.js';
+export type * from './admin-states.js';
+export * from './application-instance.js';
+export type * from './configurator-states.js';

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

@@ -0,0 +1 @@
+export*from"./application-instance.js";

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

@@ -0,0 +1,2 @@
+export type * from './read-binding.js';
+export type * from './write-binding.js';

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

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

package/dist/domain/spec/components/bindings/read-binding.d.ts

@@ -0,0 +1,13 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * A validated `$read` dependency found anywhere in the component props tree.
+ * Used for memoEval dependency tracking — the target becomes `self.target` in generated code.
+ * Field targets are validated against the entity shape; expression targets ($-prefixed)
+ * are accepted without validation (they may be inferred during Phase C).
+ */
+export type ComponentReadBinding = Branded<'ComponentReadBinding', {
+    /** The raw target string from `$read` (e.g. "height" or "$price"). */
+    readonly target: string;
+    /** Whether the target is an expression (starts with `$`) or a shape field. */
+    readonly isExpression: boolean;
+}>;

package/dist/domain/spec/components/bindings/read-binding.js

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

package/dist/domain/spec/components/bindings/write-binding.d.ts

@@ -0,0 +1,32 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Runtime type assertion to emit in the write callback.
+ * Resolved from the target entity field's schema during parsing.
+ */
+export type AssertionKind = {
+    readonly kind: 'declaredType';
+    readonly typeName: string;
+} | {
+    readonly kind: 'declaredTypeId';
+    readonly referencedType: string;
+} | {
+    readonly kind: 'primitive';
+    readonly assertFn: 'assertString' | 'assertNumber' | 'assertBoolean';
+} | {
+    readonly kind: 'literal';
+    readonly value: null;
+} | {
+    readonly kind: 'anyOf';
+    readonly assertions: readonly AssertionKind[];
+} | {
+    readonly kind: 'none';
+};
+/**
+ * A validated `$write` or `$bind` mapping from a component state key to an entity field.
+ * Includes the resolved assertion kind for runtime type checking in the write callback.
+ */
+export type ComponentWriteBinding = Branded<'ComponentWriteBinding', {
+    readonly propKey: string;
+    readonly entityField: string;
+    readonly assertion: AssertionKind;
+}>;

package/dist/domain/spec/components/bindings/write-binding.js

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

package/dist/{application-spec/parse-application-files → domain}/spec/components/component-entry.d.ts

@@ -1,9 +1,9 @@
 import type { Branded } from '@salsita-ai/common/utils';
-import type { SdkCodeRef } from '../../../core/index.js';
-import type { MemoEvalPlan, MemoEvalPlanInput } from '../expressions/memo-eval-plan.js';
+import type { MemoEvalPlan, MemoEvalPlanInput } from '../expressions/index.js';
 import type { EntityOrAliasName, InstanceName } from '../model/index.js';
 import type { ComponentReadBinding, ComponentWriteBinding } from './bindings/index.js';
-import type { ComponentFilters } from './component-filter.js';
+import type { ComponentFilters } from './component-filters.js';
+import type { SdkCodeRef } from './sdk-code-ref.js';
 /**
  * Root-level `$read` variant — the entire instance state is driven by a single
  * `$read` at the root (components.md §"Root-Level $read"). No `resolvedProps`

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

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

package/dist/{application-spec/core → domain/spec}/components/component-filter.d.ts

@@ -17,7 +17,8 @@ export type FilterCriterion<T> = {
     readonly code: string;
 };
 /**
- * Parsed component filter controlling when the component is active. Two
+ * 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
@@ -29,7 +30,7 @@ export type FilterCriterion<T> = {
  *
  * See `components.md §"Simple expression filter"` / `§"Declarative filter"`.
  */
-export type ComponentFilter = {
+export type SpecComponentFilter = {
     readonly kind: 'gradual';
     readonly navigationStates?: FilterCriterion<readonly string[]>;
     readonly viewStates?: FilterCriterion<readonly string[]>;

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

@@ -0,0 +1,10 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { SpecComponentFilter } from './component-filter.js';
+/**
+ * Validated set of `$filter` entries on a user-bound component instance. Each
+ * {@link SpecComponentFilter} represents one alternative filter condition; multiple
+ * entries arise from `$or`. Empty `items` means no filter is applied.
+ */
+export type ComponentFilters = Branded<'ComponentFilters', {
+    readonly items: readonly SpecComponentFilter[];
+}>;

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

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

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

@@ -0,0 +1,4 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { ComponentEntry } from './component-entry.js';
+/** Final merged components for a domain, including SDK/spec-derived entries. */
+export type Components = Branded<'Components', readonly ComponentEntry[]>;

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

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

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

@@ -0,0 +1,6 @@
+export type * from './bindings/index.js';
+export type * from './component-entry.js';
+export * from './component-filter.js';
+export type * from './component-filters.js';
+export type * from './components.js';
+export * from './sdk-code-ref.js';

package/dist/domain/spec/enhanced-json/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/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/enhanced-json/index.d.ts

@@ -0,0 +1 @@
+export * from './enhanced-json-value.js';

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

@@ -0,0 +1 @@
+export*from"./enhanced-json-value.js";

package/dist/{application-spec/parse-application-files → domain}/spec/expressions/expression.d.ts

@@ -1,7 +1,9 @@
 import type { Branded } from '@salsita-ai/common/utils';
-import type { EnhancedJsonSchemaType, EnhancedJsonValue, SdkExpressionImplementation } from '../../../core/index.js';
+import type { EnhancedJsonSchemaType } from '../../core/index.js';
+import type { EnhancedJsonValue } from '../enhanced-json/index.js';
 import type { EntityOrAliasName, ExpressionName } from '../model/index.js';
 import type { MemoEvalPlan } from './memo-eval-plan.js';
+import type { SdkExpressionImplementation } from './sdk-expression-implementation.js';
 /**
  * How an expression's runtime implementation is provided.
  * - `user`: implementation from `src/expressions/*.ts` (dynamic import)
@@ -22,8 +24,12 @@ export type ExpressionImplementation = {
     readonly value: EnhancedJsonValue;
     readonly plan: MemoEvalPlan;
 };
-/** A single parsed expression declaration. */
-export type Expression = Branded<'Expression', {
+/**
+ * A single parsed expression declaration of the application spec: the entity or alias it belongs
+ * to, its name, its schemas and how its implementation is provided. `application-spec` exports it
+ * as `Expression`.
+ */
+export type SpecExpression = Branded<'Expression', {
     readonly entityKey: EntityOrAliasName;
     readonly name: ExpressionName;
     /**

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

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

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

@@ -0,0 +1,27 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EntityOrAliasName, EntityTypeName, ExpressionName } from '../model/index.js';
+import type { SpecExpression } from './expression.js';
+import type { MemoEvalPlan } from './memo-eval-plan.js';
+/**
+ * Resolved expressions for a single entity type. Holds the ordered list of
+ * shape source keys (entity itself + aliases it belongs to) — codegen appends
+ * `"Expressions"` to each key to reference the typed expression group.
+ */
+export type EntityExpressions = Branded<'EntityExpressions', {
+    /** Entity/alias keys whose expressions this entity inherits. Codegen appends "Expressions" suffix. */
+    readonly shapeGroups: readonly EntityOrAliasName[];
+}>;
+/**
+ * Final merged expressions for a domain — user-declared + inferred.
+ * The internal `expressions` map groups by entity/alias for codegen/runtime lookups.
+ * `entityExpressions` provides per-entity alias expansion.
+ * `constants` projects the self-free `constants:` values, grouped like `expressions`;
+ * codegen passes them to the enhanced entity/alias reflections so they are readable at
+ * module level (`phx.domain.enhancedModel.$Wall.$maxWidth`). A constant whose plan uses
+ * `self` needs an instance, so it stays an ordinary value expression and is absent here.
+ */
+export type Expressions = Branded<'Expressions', {
+    readonly expressions: ReadonlyMap<EntityOrAliasName, ReadonlyMap<ExpressionName, SpecExpression>>;
+    readonly entityExpressions: ReadonlyMap<EntityTypeName, EntityExpressions>;
+    readonly constants: ReadonlyMap<EntityOrAliasName, ReadonlyMap<ExpressionName, MemoEvalPlan>>;
+}>;

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

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

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

@@ -0,0 +1,5 @@
+export type * from './expression.js';
+export type * from './expressions.js';
+export type * from './memo-eval-plan.js';
+export type * from './relation-expression-params.js';
+export * from './sdk-expression-implementation.js';