@salsita-ai/sdk 0.50.0-develop.b47f1774a2 → 0.50.0-develop.b5d443db78

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

@@ -1,6 +1,6 @@
-import type { ImportedTransformer, SpecTransformer } from '../../../application/index.js';
-import type { AnyDomainContextSystems, Transformers } from '../../../domain-context/index.js';
-import { type ProjectModule } from './project-modules.js';
+import type { ImportedTransformer, SpecTransformer } from '../../application/index.js';
+import type { AnyDomainContextSystems, Transformers } from '../../domain-context/index.js';
+import { type ProjectModule } from '../../spec/index.js';
 /**
  * The transformer of one `src/transformers/` file, named after the file. The spec's `transformers` section
  * selects a plain-function export by that name; a transformer made with `build(name)` registers under its own.

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

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

package/dist/domain/domain-runtime/spec/selectors.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentType, PropsWithChildren } from 'react';
-import { type CustomPhoenixEntityElementProps, type PhoenixHandlerDefinition, type SystemPhoenixAsyncHandlerDefinition, type SystemPhoenixHandlerDefinition } from './module-checks/index.js';
+import type { CustomPhoenixEntityElementProps, PhoenixHandlerDefinition, SystemPhoenixAsyncHandlerDefinition, SystemPhoenixHandlerDefinition } from '../../spec/index.js';
 import type { ApplicationSpec } from './types.js';
 /**
  * Structural slice of the runtime state the spec selectors read. The selectors are keyed on this
@@ -34,7 +34,7 @@ export declare const createSpecSelectors: (context: Context) => {
     selectPrefetchTextureUrls: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly string[]>;
     selectTextLanguages: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly string[]>;
     selectHandlerHashes: import("@salsita-ai/common/utils").Selector<SpecSelectorState, Record<string, string>>;
-    selectHandlers: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly import("./index.js").HandlerRegistration<any, any>[]>;
+    selectHandlers: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly import("../../index.js").HandlerRegistration<any, any>[]>;
     selectHandlerSlots: import("@salsita-ai/common/utils").Selector<SpecSelectorState, {
         handlers: Record<string, () => PhoenixHandlerDefinition>;
         systemHandlers: Record<string, () => SystemPhoenixHandlerDefinition<unknown, unknown>>;
@@ -42,7 +42,7 @@ export declare const createSpecSelectors: (context: Context) => {
         hashes: Record<string, string>;
     }>;
     selectElementHashes: import("@salsita-ai/common/utils").Selector<SpecSelectorState, Record<string, string>>;
-    selectElements: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly import("./index.js").ElementRegistration[]>;
+    selectElements: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly import("../../index.js").ElementRegistration[]>;
     selectElementSlots: import("@salsita-ai/common/utils").Selector<SpecSelectorState, {
         entityElements: Record<string, (props: CustomPhoenixEntityElementProps) => JSX.Element>;
         layoutElements: Record<string, (props: PropsWithChildren) => JSX.Element>;
@@ -78,7 +78,7 @@ export declare const createSpecSelectors: (context: Context) => {
     getPrefetchTextureUrls: () => readonly string[];
     getTextLanguages: () => readonly string[];
     getHandlerHashes: () => Record<string, string>;
-    getHandlers: () => readonly import("./index.js").HandlerRegistration<any, any>[];
+    getHandlers: () => readonly import("../../index.js").HandlerRegistration<any, any>[];
     getHandlerSlots: () => {
         handlers: Record<string, () => PhoenixHandlerDefinition>;
         systemHandlers: Record<string, () => SystemPhoenixHandlerDefinition<unknown, unknown>>;
@@ -86,7 +86,7 @@ export declare const createSpecSelectors: (context: Context) => {
         hashes: Record<string, string>;
     };
     getElementHashes: () => Record<string, string>;
-    getElements: () => readonly import("./index.js").ElementRegistration[];
+    getElements: () => readonly import("../../index.js").ElementRegistration[];
     getElementSlots: () => {
         entityElements: Record<string, (props: CustomPhoenixEntityElementProps) => JSX.Element>;
         layoutElements: Record<string, (props: PropsWithChildren) => JSX.Element>;

package/dist/domain/domain-runtime/spec/types.d.ts

@@ -1,9 +1,9 @@
 import type { ThemeOptions } from '@mui/material';
 import type { SessionRole } from '@salsita-ai/contracts/api';
-import type { AssistantResolvedManifest, ChunksSpec, DataSpec } from '../../application/index.js';
+import type { ChunksSpec, DataSpec } from '../../application/index.js';
 import type { ActionDefinitions, Any$EntityReflections, AnyActionImplementations, AnyAliasMap, AnyAllowedRootEntityTypes, AnyDomainComponentOptic, AnyDomainFactory, AnyEntityReflections, AnyExpressions, AnyProductPreset, DomainEntity, MigrateFunction } from '../../core/index.js';
 import type { AnyCreateTransformersFactory } from '../../domain-context/index.js';
-import type { ElementRegistration, HandlerRegistration } from './module-checks/index.js';
+import type { AssistantResolvedManifest, ElementRegistration, HandlerRegistration } from '../../spec/index.js';
 export interface ApplicationConfiguratorSpec {
     readonly modelVersion: number;
     readonly factory: AnyDomainFactory;

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

@@ -1,4 +1,10 @@
 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

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

@@ -1 +1 @@
-import{SystemComponentBuilder as t}from"../../core/index.js";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"},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();
+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/export-images/index.d.ts

@@ -1,3 +1,3 @@
-export { agentScreenshotComponent, type AgentScreenshotComponent, type AgentScreenshotComponentState, } from './agent-screenshot.js';
+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

@@ -1 +1 @@
-export{agentScreenshotComponent}from"./agent-screenshot.js";export{clientSideImageComponent}from"./client-side-image.js";export{saveTemplateThumbnailComponent}from"./save-template-thumbnail.js";
+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/index.d.ts

@@ -62,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 { agentScreenshotComponent, type AgentScreenshotComponent, type AgentScreenshotComponentState, clientSideImageComponent, type ClientSideImageComponent, type ClientSideImageComponentState, saveTemplateThumbnailComponent, type SaveTemplateThumbnailComponent, type SaveTemplateThumbnailComponentState, } from './export-images/index.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{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{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";
+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/extensions/scene-entity-delete-fab.d.ts

@@ -1,4 +1,4 @@
-import type { Localizable } from '@salsita-ai/common/utils';
+import { type Localizable } from '@salsita-ai/common/utils';
 import { type SceneEntityHtmlOpacityState, type SceneEntityHtmlPositionState, type SceneEntityHtmlTooltipState, type SceneEntityHtmlVisibilityState } from '../system-components/index.js';
 export type SceneEntityDeleteFabComponentState = SceneEntityHtmlPositionState & SceneEntityHtmlOpacityState & SceneEntityHtmlVisibilityState & SceneEntityHtmlTooltipState & {
     /**

package/dist/domain/extensions/scene-entity-delete-fab.js

@@ -1 +1 @@
-import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";import{SceneHtmlOpacityProperties as n,SceneHtmlPositionProperties as o,SceneHtmlTooltipProperties as i,SceneHtmlVisibilityProperties as p}from"../system-components/index.js";export const sceneEntityDeleteFabComponent=e.component("sceneEntityDeleteFab").withState({tsType:"SceneEntityDeleteFabComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityDeleteFabComponentState"}],type:"object",properties:{...o,...n,...p,...i,icon:{type:"string"}},required:[],additionalProperties:!1}).build();export const isSceneEntityDeleteFabComponentSnapshot=t(sceneEntityDeleteFabComponent);
+import{EnhancedLocalizableSchema as e}from"@salsita-ai/common/utils";import{SystemComponentBuilder as t,isSnapshotOfComponentType as n}from"../core/index.js";import{SceneHtmlOpacityProperties as o,SceneHtmlPositionProperties as i,SceneHtmlTooltipProperties as s,SceneHtmlVisibilityProperties as a}from"../system-components/index.js";export const sceneEntityDeleteFabComponent=t.component("sceneEntityDeleteFab").withState({tsType:"SceneEntityDeleteFabComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SceneEntityDeleteFabComponentState"}],type:"object",properties:{...i,...o,...a,...s,hiddenViolations:{type:"array",items:{type:"string"}},label:e,icon:{type:"string"}},required:[],additionalProperties:!1}).build();export const isSceneEntityDeleteFabComponentSnapshot=n(sceneEntityDeleteFabComponent);

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,19 @@ 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/application/index.js';
+export * from './spec/components/index.js';
+export * from './spec/enhanced-json/index.js';
+export * from './spec/errors/index.js';
+export * from './spec/expressions/index.js';
+export type * from './spec/invariants/index.js';
+export type * from './spec/json-schema.js';
+export * from './spec/markers/index.js';
+export type * from './spec/model/index.js';
+export { type PhoenixEntityElementProps, type PhoenixEntityElementRegistration, type PhoenixLayoutElementRegistration, type PhoenixIconRegistration, type AssistantFormElementRegistration, type ElementRegistration, type CustomPhoenixEntityElementProps, type PhoenixLayoutElementDefinition, type PhoenixEntityElementDefinition, type CreateCustomPhoenixLayoutElement, type CreateCustomPhoenixEntityElement, createPhoenixLayoutElement, createPhoenixEntityElement, createCustomPhoenixLayoutElement, createCustomPhoenixEntityElement, createAssistantFormElement, resolveElementModule, resolveElementModules, findAssistantFormElementErrors, type PhoenixHandlerDefinition, type SystemPhoenixHandlerDefinition, type PhoenixHandlerRegistration, type SystemPhoenixHandlerRegistration, type SystemPhoenixAsyncHandlerDefinition, type SystemPhoenixAsyncHandlerRegistration, type HandlerRegistration, type CreatePhoenixHandler, createPhoenixHandler, createSystemPhoenixHandler, createSystemPhoenixAsyncHandler, resolveHandlerModule, resolveHandlerModules, type ProjectModule, resolveActionModules, resolveComponentOpticModules, type ValuedExpressions, mergeExpressionModules, type ExpressionModule, resolveExpressionModules, resolveInvariantModules, } from './spec/modules/index.js';
+export * from './spec/runtime-spec/index.js';
+export * from './spec/sections/index.js';
+export { ActionsRuntime, type ApplicationModules, ApplicationRuntime, type ApplicationRuntimeResult, type ApplicationSpecSliceModules, AssistantRuntime, type ComponentOptic, ComponentOptics, DataRuntime, type ExpressionImplementations, ExpressionRuntime, FactoryDataRuntime, type InvariantImplementations, type MigrationModules, MigrationRuntime, type MissingExpression, PresetRuntime, type RecipeDefaults, RuntimeReferenceStore, type ScopedBuilder, type StaticViolations, ThemeRuntime, TransformersRuntime, applicationSpecSlice, createApplication, evaluateReflectionConstants, evaluateStaticMemoEvalPlan, findReflectionConstants, generateMemoEvalPlanRuntime, generateRuntimeInstance, isConfiguratorModelSchemaCompatible, } from './spec/runtime/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/application/index.js";export*from"./spec/components/index.js";export*from"./spec/enhanced-json/index.js";export*from"./spec/errors/index.js";export*from"./spec/expressions/index.js";export*from"./spec/markers/index.js";export{createPhoenixLayoutElement,createPhoenixEntityElement,createCustomPhoenixLayoutElement,createCustomPhoenixEntityElement,createAssistantFormElement,resolveElementModule,resolveElementModules,findAssistantFormElementErrors,createPhoenixHandler,createSystemPhoenixHandler,createSystemPhoenixAsyncHandler,resolveHandlerModule,resolveHandlerModules,resolveActionModules,resolveComponentOpticModules,mergeExpressionModules,resolveExpressionModules,resolveInvariantModules}from"./spec/modules/index.js";export*from"./spec/runtime-spec/index.js";export*from"./spec/sections/index.js";export{ActionsRuntime,ApplicationRuntime,AssistantRuntime,ComponentOptics,DataRuntime,ExpressionRuntime,FactoryDataRuntime,MigrationRuntime,PresetRuntime,RuntimeReferenceStore,ThemeRuntime,TransformersRuntime,applicationSpecSlice,createApplication,evaluateReflectionConstants,evaluateStaticMemoEvalPlan,findReflectionConstants,generateMemoEvalPlanRuntime,generateRuntimeInstance,isConfiguratorModelSchemaCompatible}from"./spec/runtime/index.js";

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

@@ -1,5 +1,5 @@
 import type { TransformersConfig } from '../application/index.js';
-import type { ProjectModule } from '../domain-runtime/index.js';
+import type { ProjectModule } from '../spec/index.js';
 /**
  * What a project's test adds to its generated application before it builds the config.
  *

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.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-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/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/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';