@salsita-ai/sdk 0.50.0-develop.c4848d224b → 0.50.0-develop.ca5894b56c

package/dist/domain/domain-runtime/spec/module-checks/index.js

@@ -1 +1 @@
-export{createPhoenixLayoutElement,createPhoenixEntityElement,createCustomPhoenixLayoutElement,createCustomPhoenixEntityElement,resolveElementModule,resolveElementModules}from"./element-registration.js";export{createPhoenixHandler,createSystemPhoenixHandler,createSystemPhoenixAsyncHandler,resolveHandlerModule,resolveHandlerModules}from"./handler-registration.js";export{resolveActionModules}from"./resolve-action-modules.js";export{resolveComponentOpticModules}from"./resolve-component-optic-modules.js";export{resolveExpressionModules}from"./resolve-expression-modules.js";export{resolveImportedTransformers,resolveTransformerModule,resolveTransformerModules}from"./resolve-imported-transformers.js";export{resolveInvariantModules}from"./resolve-invariant-modules.js";
+export{createPhoenixLayoutElement,createPhoenixEntityElement,createCustomPhoenixLayoutElement,createCustomPhoenixEntityElement,createAssistantFormElement,resolveElementModule,resolveElementModules}from"./element-registration.js";export{createPhoenixHandler,createSystemPhoenixHandler,createSystemPhoenixAsyncHandler,resolveHandlerModule,resolveHandlerModules}from"./handler-registration.js";export{findAssistantFormElementErrors}from"./find-assistant-form-element-errors.js";export{resolveActionModules}from"./resolve-action-modules.js";export{resolveComponentOpticModules}from"./resolve-component-optic-modules.js";export{mergeExpressionModules}from"./merge-expression-modules.js";export{resolveExpressionModules}from"./resolve-expression-modules.js";export{resolveImportedTransformers,resolveTransformerModule,resolveTransformerModules}from"./resolve-imported-transformers.js";export{resolveInvariantModules}from"./resolve-invariant-modules.js";

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

@@ -0,0 +1,23 @@
+import type { AnonymousExpression, AnyExpressions } from '../../../core/index.js';
+import { type ImplementationErrorCollector } from '../../errors/index.js';
+import { type ProjectModule } from './project-modules.js';
+type AnyAnonymousExpression = AnonymousExpression<any, any, any, any, any, any, unknown>;
+type AliasMap = Readonly<Record<string, readonly string[]>>;
+/** The expression names that already have a value, by entity type, so no project file may define them. */
+export type ValuedExpressions = ReadonlyMap<string, ReadonlySet<string>>;
+/** Whether a file's default export has the shape of the expressions folder contract. */
+export declare const isExpressionExport: (value: unknown) => value is Record<string, Record<string, AnyAnonymousExpression>>;
+/**
+ * Merges the `src/expressions/` files (or `src/admin/expressions/`) into the expressions of each
+ * entity type. It checks each file against the folder contract, rejects an expression that two
+ * files, or two keys of one file, define for one entity type after the aliases of `aliasMap` are
+ * expanded, and rejects an expression listed in `valued`, which the application gives a value
+ * already. Each accepted expression gets its `origin`: its name and the entity type or alias the
+ * file keys it by.
+ *
+ * Each file is checked on its own: a wrong file is recorded in `errors` with all its conflicts and
+ * left out, and the files after it still merge. Without `errors`, everything recorded is thrown at
+ * the end as one `ImplementationErrors`.
+ */
+export declare const mergeExpressionModules: (modules: readonly ProjectModule[], aliasMap: AliasMap, errors?: ImplementationErrorCollector, valued?: ValuedExpressions) => AnyExpressions;
+export {};

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

@@ -0,0 +1 @@
+import{ImplementationError as e,ImplementationErrors as o,createImplementationErrorCollector as t}from"../../errors/index.js";import{SHARED_FOLDER_HINT as i,createContractError as n,isRecord as r}from"./project-modules.js";let s={expected:"an object of expressions keyed by entity type or alias, then by expression name",fix:`Create it with phx.domain.implementCustomExpressions({ ... }) (phx.domain.admin.implementCustomExpressions({ ... }) under src/admin/), ${i}.`},a=e=>r(e)&&"function"==typeof e.evaluate,p=e=>r(e)&&Object.values(e).every(a);export const isExpressionExport=e=>r(e)&&Object.values(e).every(p);let l=(o,t,i)=>new e({code:"DUPLICATE_DEFINITION",origin:o,problem:`Duplicate expression ${t}`,fix:i}),d=(e,t,i,r)=>{if(!isExpressionExport(e.exports))throw n(e,s,e.exports);let a=[],p=new Map,d=[];for(let[o,n]of Object.entries(e.exports))for(let s of t[o]??[o])for(let[t,f]of Object.entries(n)){let n=`${s}.${t}`,h=p.get(n),m=i.get(n);r.get(s)?.has(t)?d.push(l(e.origin,n,"The application already gives it a value (an $eval, $msg or read in the spec, a relation, the $violations of its invariants, or a built-in expression of the SDK), so this implementation would be ignored. Remove it from the file, or declare the expression in the spec with a type and no value.")):void 0!==h?d.push(l(e.origin,n,`The file defines it on both ${h} and ${o}, so its value would depend on the order the definitions are merged in. Define it once, on the alias or on the entity type.`)):void 0!==m&&d.push(l(e.origin,n,`It is also defined in ${m}, so its value would depend on file order. Keep one definition and remove the other.`)),p.set(n,o),a.push({key:n,entityType:s,typeOrAlias:o,name:t,expression:f})}if(d.length>0)throw new o(d);return a};export const mergeExpressionModules=(e,o,i,n=new Map)=>{let r=i??t(),s=new Map,a={};for(let t of e)for(let{key:e,entityType:i,typeOrAlias:p,name:l,expression:f}of r.attempt(()=>d(t,o,s,n),[]))s.set(e,t.origin),a[i]={...a[i],[l]:{...f,origin:{name:l,typeOrAlias:p}}};return void 0===i&&r.throwIfAny(),a};

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

@@ -1,5 +1,5 @@
 import type { AnonymousExpression } from '../../../core/index.js';
-import { type ProjectModule } from './project-modules.js';
+import type { ProjectModule } from './project-modules.js';
 /** The expressions of one validated expression file, keyed by entity type or alias, then by expression name. */
 export interface ExpressionModule {
     readonly origin: string;
@@ -7,9 +7,8 @@ export interface ExpressionModule {
 }
 type AnyAnonymousExpression = AnonymousExpression<any, any, any, any, any, any, unknown>;
 /**
- * Validates the `src/expressions/` files and rejects an expression that two files define for the
- * same entity type. Merging stays with the caller, because the domain builder and the editor expand
- * aliases at different points; within one file the builder's own duplicate check applies.
+ * Validates the `src/expressions/` files with the checks of {@link mergeExpressionModules}, throws
+ * everything they find as one `ImplementationErrors`, and returns each file on its own, unmerged.
  */
 export declare const resolveExpressionModules: (modules: readonly ProjectModule[], aliasMap: Readonly<Record<string, readonly string[]>>) => readonly ExpressionModule[];
 export {};

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

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

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

@@ -1,4 +1,4 @@
-import type { PropsWithChildren } from 'react';
+import type { ComponentType, PropsWithChildren } from 'react';
 import { type CustomPhoenixEntityElementProps, type PhoenixHandlerDefinition, type SystemPhoenixAsyncHandlerDefinition, type SystemPhoenixHandlerDefinition } from './module-checks/index.js';
 import type { ApplicationSpec } from './types.js';
 /**
@@ -46,6 +46,7 @@ export declare const createSpecSelectors: (context: Context) => {
     selectElementSlots: import("@salsita-ai/common/utils").Selector<SpecSelectorState, {
         entityElements: Record<string, (props: CustomPhoenixEntityElementProps) => JSX.Element>;
         layoutElements: Record<string, (props: PropsWithChildren) => JSX.Element>;
+        assistantFormElements: Record<string, ComponentType<never>>;
         hashes: Record<string, string>;
     }>;
     selectDataConfig: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("../../index.js").DataSpec | null>;
@@ -89,6 +90,7 @@ export declare const createSpecSelectors: (context: Context) => {
     getElementSlots: () => {
         entityElements: Record<string, (props: CustomPhoenixEntityElementProps) => JSX.Element>;
         layoutElements: Record<string, (props: PropsWithChildren) => JSX.Element>;
+        assistantFormElements: Record<string, ComponentType<never>>;
         hashes: Record<string, string>;
     };
     getDataConfig: () => import("../../index.js").DataSpec | null;

package/dist/domain/domain-runtime/spec/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";import{buildAssistantManifest as t}from"../../application/assistant/index.js";export const createSpecSelectors=a=>{let{getState:n}=a,s=e.withTypes(),r=s([s.leaf(e=>e.spec)],e=>e),l=s([r],e=>e.version),o=s([r],e=>e.baseResourcesUrl),i=s([r],e=>e.configurator),g=s([r],e=>e.dataConfig),m=s([r],e=>e.chunks),p=s([r],e=>e.publishedDataHash),d=s([r],e=>e.initialPublishedData),c=s([r],e=>e.canCreate),u=s([r],e=>e.enableAdminRelease),h=s([r],e=>e.textLanguages),y=s([i],e=>e.modelVersion),f=s([r],e=>e.admin),C=s([f],e=>e.preset),A=s([f],e=>e.modelVersion),b=s([i],e=>e.theme),x=s([i],e=>e.assistant),E=s([x],e=>e?t(e):null),H=s([i],e=>e.factory),D=s([f],e=>e.factory),P=s([i],e=>e.componentOptics),S=s([f],e=>e.componentOptics),w=s([i],e=>e.appLoader),O=s([i],e=>e.preview),T=s([i],e=>e.alwaysExpand),V=s([i],e=>e.presets),L=s([i],e=>e.deploymentQueryDisabled),R=s([i],e=>e.prefetchTextureUrls),U=s([i],e=>e.handlerHashes),v=s([i],e=>e.handlers),k=s([v,U],(e,t)=>({...(e=>{let t={},a={},n={};for(let s of e)"phoenix"===s.type&&(t[s.name]=s.handler),"system"===s.type&&(a[s.name]=s.handler),"system-async"===s.type&&(n[s.name]=s.handler);return{handlers:t,systemHandlers:a,systemAsyncHandlers:n}})(e),hashes:t})),F=s([i],e=>e.elementHashes),M=s([i],e=>e.elements),Q=s([i],e=>e.defaultElements),j=s([Q,M,F],(e,t,a)=>({...(e=>{let t={},a={};for(let n of e)"layout"===n.type&&(t[n.name]=n.element),"entity"===n.type&&(a[n.name]=n.element);return{entityElements:a,layoutElements:t}})([...e,...t]),hashes:a}));return{selectSpec:r,selectVersion:l,selectBaseResourcesUrl:o,selectConfiguratorSpec:i,selectConfiguratorModelVersion:y,selectAdminSpec:f,selectAdminPreset:C,selectAdminModelVersion:A,selectThemeOptions:b,selectAssistant:E,selectConfiguratorFactory:H,selectAdminFactory:D,selectConfiguratorComponentOptics:P,selectAdminComponentOptics:S,selectAppLoader:w,selectPreview:O,selectAlwaysExpand:T,selectPresetSeed:V,selectDeploymentQueryDisabled:L,selectPrefetchTextureUrls:R,selectTextLanguages:h,selectHandlerHashes:U,selectHandlers:v,selectHandlerSlots:k,selectElementHashes:F,selectElements:M,selectElementSlots:j,selectDataConfig:g,selectChunks:m,selectPublishedDataHash:p,selectInitialPublishedData:d,selectCanCreate:c,selectEnableAdminRelease:u,getVersion:()=>l(n()),getBaseResourcesUrl:()=>o(n()),getConfiguratorSpec:()=>i(n()),getConfiguratorModelVersion:()=>y(n()),getAdminSpec:()=>f(n()),getAdminPreset:()=>C(n()),getAdminModelVersion:()=>A(n()),getThemeOptions:()=>b(n()),getAssistant:()=>E(n()),getConfiguratorFactory:()=>H(n()),getAdminFactory:()=>D(n()),getConfiguratorComponentOptics:()=>P(n()),getAdminComponentOptics:()=>S(n()),getAppLoader:()=>w(n()),getPreview:()=>O(n()),getAlwaysExpand:()=>T(n()),getPresetSeed:()=>V(n()),getDeploymentQueryDisabled:()=>L(n()),getPrefetchTextureUrls:()=>R(n()),getTextLanguages:()=>h(n()),getHandlerHashes:()=>U(n()),getHandlers:()=>v(n()),getHandlerSlots:()=>k(n()),getElementHashes:()=>F(n()),getElements:()=>M(n()),getElementSlots:()=>j(n()),getDataConfig:()=>g(n()),getChunks:()=>m(n()),getPublishedDataHash:()=>p(n()),getInitialPublishedData:()=>d(n()),getCanCreate:()=>c(n()),getEnableAdminRelease:()=>u(n())}};
+import{createSelector as e}from"@salsita-ai/common/utils";import{buildAssistantManifest as t}from"../../application/assistant/index.js";export const createSpecSelectors=a=>{let{getState:n}=a,s=e.withTypes(),r=s([s.leaf(e=>e.spec)],e=>e),l=s([r],e=>e.version),o=s([r],e=>e.baseResourcesUrl),i=s([r],e=>e.configurator),m=s([r],e=>e.dataConfig),g=s([r],e=>e.chunks),p=s([r],e=>e.publishedDataHash),d=s([r],e=>e.initialPublishedData),c=s([r],e=>e.canCreate),u=s([r],e=>e.enableAdminRelease),h=s([r],e=>e.textLanguages),y=s([i],e=>e.modelVersion),f=s([r],e=>e.admin),C=s([f],e=>e.preset),E=s([f],e=>e.modelVersion),A=s([i],e=>e.theme),b=s([i],e=>e.assistant),x=s([b],e=>e?t(e):null),H=s([i],e=>e.factory),D=s([f],e=>e.factory),P=s([i],e=>e.componentOptics),S=s([f],e=>e.componentOptics),w=s([i],e=>e.appLoader),O=s([i],e=>e.preview),T=s([i],e=>e.alwaysExpand),V=s([i],e=>e.presets),F=s([i],e=>e.deploymentQueryDisabled),L=s([i],e=>e.prefetchTextureUrls),R=s([i],e=>e.handlerHashes),U=s([i],e=>e.handlers),v=s([U,R],(e,t)=>({...(e=>{let t={},a={},n={};for(let s of e)"phoenix"===s.type&&(t[s.name]=s.handler),"system"===s.type&&(a[s.name]=s.handler),"system-async"===s.type&&(n[s.name]=s.handler);return{handlers:t,systemHandlers:a,systemAsyncHandlers:n}})(e),hashes:t})),k=s([i],e=>e.elementHashes),M=s([i],e=>e.elements),Q=s([i],e=>e.defaultElements),j=s([Q,M,k],(e,t,a)=>({...(e=>{let t={},a={},n={};for(let s of e)"layout"===s.type&&(t[s.name]=s.element),"entity"===s.type&&(a[s.name]=s.element),"assistantFormElement"===s.type&&(n[s.name]=s.element);return{entityElements:a,layoutElements:t,assistantFormElements:n}})([...e,...t]),hashes:a}));return{selectSpec:r,selectVersion:l,selectBaseResourcesUrl:o,selectConfiguratorSpec:i,selectConfiguratorModelVersion:y,selectAdminSpec:f,selectAdminPreset:C,selectAdminModelVersion:E,selectThemeOptions:A,selectAssistant:x,selectConfiguratorFactory:H,selectAdminFactory:D,selectConfiguratorComponentOptics:P,selectAdminComponentOptics:S,selectAppLoader:w,selectPreview:O,selectAlwaysExpand:T,selectPresetSeed:V,selectDeploymentQueryDisabled:F,selectPrefetchTextureUrls:L,selectTextLanguages:h,selectHandlerHashes:R,selectHandlers:U,selectHandlerSlots:v,selectElementHashes:k,selectElements:M,selectElementSlots:j,selectDataConfig:m,selectChunks:g,selectPublishedDataHash:p,selectInitialPublishedData:d,selectCanCreate:c,selectEnableAdminRelease:u,getVersion:()=>l(n()),getBaseResourcesUrl:()=>o(n()),getConfiguratorSpec:()=>i(n()),getConfiguratorModelVersion:()=>y(n()),getAdminSpec:()=>f(n()),getAdminPreset:()=>C(n()),getAdminModelVersion:()=>E(n()),getThemeOptions:()=>A(n()),getAssistant:()=>x(n()),getConfiguratorFactory:()=>H(n()),getAdminFactory:()=>D(n()),getConfiguratorComponentOptics:()=>P(n()),getAdminComponentOptics:()=>S(n()),getAppLoader:()=>w(n()),getPreview:()=>O(n()),getAlwaysExpand:()=>T(n()),getPresetSeed:()=>V(n()),getDeploymentQueryDisabled:()=>F(n()),getPrefetchTextureUrls:()=>L(n()),getTextLanguages:()=>h(n()),getHandlerHashes:()=>R(n()),getHandlers:()=>U(n()),getHandlerSlots:()=>v(n()),getElementHashes:()=>k(n()),getElements:()=>M(n()),getElementSlots:()=>j(n()),getDataConfig:()=>m(n()),getChunks:()=>g(n()),getPublishedDataHash:()=>p(n()),getInitialPublishedData:()=>d(n()),getCanCreate:()=>c(n()),getEnableAdminRelease:()=>u(n())}};

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

@@ -4,7 +4,10 @@ interface Context {
 }
 export declare const createWebComponentActions: (context: Context) => {
     setReadonly: (readonlyValue: boolean) => void;
+    setLocale: (locale: string) => void;
     startNewGeneration: () => void;
 };
 export type WebComponentActions = ReturnType<typeof createWebComponentActions>;
+/** The writers the host-property mirror needs: the public `setReadonly` and the internal `setLocale`. */
+export type WebComponentHostActions = Pick<WebComponentActions, 'setReadonly' | 'setLocale'>;
 export {};

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

@@ -1 +1 @@
-export const createWebComponentActions=e=>({setReadonly:t=>{e.setWebComponentState(e=>({...e,readonly:t}))},startNewGeneration:()=>{e.setWebComponentState(e=>({...e,webcomponentGeneration:e.webcomponentGeneration+1}))}});
+export const createWebComponentActions=e=>({setReadonly:t=>{e.setWebComponentState(e=>({...e,readonly:t}))},setLocale:t=>{e.setWebComponentState(e=>({...e,locale:t}))},startNewGeneration:()=>{e.setWebComponentState(e=>({...e,webcomponentGeneration:e.webcomponentGeneration+1}))}});

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

@@ -1,2 +1,3 @@
 import type { ApplicationWebComponentState } from './types.js';
+/** The initial state: `locale` is the host's property default, not resolved against the available locales. */
 export declare const initializeWebComponent: () => ApplicationWebComponentState;

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

@@ -1 +1 @@
-export const initializeWebComponent=()=>({readonly:!1,webcomponentGeneration:0});
+import{DEFAULT_FALLBACK_LOCALE as e}from"#package/i18n";export const initializeWebComponent=()=>({readonly:!1,locale:e,webcomponentGeneration:0});

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

@@ -8,6 +8,8 @@ interface Context {
 export declare const createWebComponentSelectors: (context: Context) => {
     selectReadonly: import("@salsita-ai/common/utils").Selector<WebComponentSelectorState, boolean>;
     getReadonly: () => boolean;
+    selectLocale: import("@salsita-ai/common/utils").Selector<WebComponentSelectorState, string>;
+    getLocale: () => string;
     getWebcomponentGeneration: () => number;
 };
 export type WebComponentSelectors = ReturnType<typeof createWebComponentSelectors>;

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,24 @@
+import { type HexColor } from '@salsita-ai/common/utils';
+/**
+ * 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 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();

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 { 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{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 { 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{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

@@ -16,3 +16,4 @@ 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 './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.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"./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/index.d.ts

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

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

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

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/enhanced-json-value.d.ts

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

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

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

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

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

package/dist/domain/spec/index.js

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

package/dist/domain/spec/json-schema.d.ts

@@ -0,0 +1,52 @@
+import type { JsonSchemaType } from '../core/index.js';
+/**
+ * Plain AJV-ready JSON Schema — the output of `toRuntimeSchema` in `application-spec`.
+ *
+ * Identical in structure to `EnhancedJsonSchemaType` except the Phoenix-only
+ * extensions (`tsType`, `import`, `references`) are gone; those are
+ * stripped by `stripCustomKeywords` before this type is produced. All `$ref`
+ * targets are local (`#/$defs/{name}`) — no external references remain. Shapes
+ * stored under `$defs` are themselves `JsonSchema`s.
+ *
+ * Use this type anywhere the runtime AJV shape is required (validators,
+ * serializers, migration tools). Schema producers (`Shapes`, `CommonTypes`,
+ * relation inference) keep using `EnhancedJsonSchemaType`.
+ */
+export interface JsonSchema {
+    readonly id?: string;
+    readonly $ref?: string;
+    readonly $schema?: string;
+    readonly $defs?: Readonly<Record<string, JsonSchema>>;
+    readonly title?: string;
+    readonly description?: string;
+    readonly default?: unknown;
+    readonly format?: string;
+    readonly multipleOf?: number;
+    readonly maximum?: number;
+    readonly exclusiveMaximum?: boolean;
+    readonly minimum?: number;
+    readonly exclusiveMinimum?: boolean;
+    readonly maxLength?: number;
+    readonly minLength?: number;
+    readonly pattern?: string;
+    readonly additionalItems?: boolean | JsonSchema;
+    readonly items?: JsonSchema | readonly JsonSchema[];
+    readonly maxItems?: number;
+    readonly minItems?: number;
+    readonly uniqueItems?: boolean;
+    readonly maxProperties?: number;
+    readonly minProperties?: number;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean | JsonSchema;
+    readonly definitions?: Readonly<Record<string, JsonSchema>>;
+    readonly properties?: Readonly<Record<string, JsonSchema>>;
+    readonly patternProperties?: Readonly<Record<string, JsonSchema>>;
+    readonly dependencies?: Readonly<Record<string, JsonSchema | readonly string[]>>;
+    readonly enum?: readonly unknown[];
+    readonly type?: JsonSchemaType | readonly JsonSchemaType[];
+    readonly allOf?: readonly JsonSchema[];
+    readonly anyOf?: readonly JsonSchema[];
+    readonly oneOf?: readonly JsonSchema[];
+    readonly not?: JsonSchema;
+    readonly [k: string]: unknown;
+}

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

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

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

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

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

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

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

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

package/dist/domain/spec/model/aliases.d.ts

@@ -0,0 +1,9 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { AliasName, EntityTypeName } from './names/index.js';
+/**
+ * Flattened alias map — each alias name maps to the concrete entity types it resolves to.
+ * Nested aliases (e.g. AllLegs → [SteelLegs, LegsOak] where SteelLegs is itself an alias)
+ * are fully resolved to leaf entity types. Includes the synthetic "AnyDomainEntity" alias
+ * that maps to all entity types in the version. `application-spec` exports it as `Aliases`.
+ */
+export type SpecAliases = Branded<'Aliases', ReadonlyMap<AliasName, readonly EntityTypeName[]>>;

package/dist/domain/spec/model/common-types.d.ts

@@ -0,0 +1,15 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EnhancedJsonSchemaType } from '../../core/index.js';
+import type { JsonSchema } from '../json-schema.js';
+/** A single common type definition with both enhanced schema (for type inference) and resolved runtime schema. */
+export type CommonType = Branded<'CommonType', {
+    readonly name: string;
+    readonly schema: EnhancedJsonSchemaType;
+    readonly runtimeSchema: JsonSchema;
+}>;
+/**
+ * Branded map of common type name to CommonType.
+ * Entries are in topo-sorted order (dependencies before dependents),
+ * so iterating the map yields types in valid emission order.
+ */
+export type CommonTypes = Branded<'CommonTypes', ReadonlyMap<string, CommonType>>;