@salsita-ai/sdk 0.50.0-develop.5a0bcdee42 → 0.50.0-develop.5ac9723d62

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

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";import{createAccessInfoActions as t,createAccessInfoSelectors as n,initializeAccessInfo as a}from"./access/index.js";import{createDomainContextActions as o,createDomainContextSelectors as i,initializeDomainContext as s}from"./domain-context/index.js";import{createDomainDataActions as r,createDomainDataSelectors as m,initializeDomainData as l}from"./domain-data/index.js";import{createDomainServicesSelectors as d}from"./domain-services/index.js";import{createEnvironmentActions as c,createEnvironmentSelectors as u,initializeEnvironment as v}from"./environment/index.js";import{createLoadedDataActions as x,createLoadedDataSelectors as p,initializeLoadedData as S}from"./loaded-data/index.js";import{createOverridesActions as f,createOverridesSelectors as g,initializeOverrides as C}from"./overrides/index.js";import{createSessionContextActions as D,createSessionContextSelectors as b,initializeSessionContext as j}from"./session-context/index.js";import{createSpecActions as w,createSpecSelectors as y,initializeSpec as E}from"./spec/index.js";import{createWebComponentActions as z,createWebComponentSelectors as R,initializeWebComponent as T}from"./web-component/index.js";export function createDomainRuntimeSlices(e){let{config:h,getSubject:A,services:I,getExtensionSystems:L}=e,O=w({setSpec:e=>{let t=A(),n=e(t.value.spec);t.next({...t.value,spec:n})}}),W=y({getState:()=>A().value}),k=d({services:I,specSelectors:W}),q=f({setOverrides:e=>{let t=A(),n=e(t.value.overrides);t.next({...t.value,overrides:n})}}),B=g({getState:()=>A().value}),F=u({getState:()=>A().value,overridesSelectors:B}),G=c({setEnvironment:e=>{let t=A(),n=e(t.value.environment);t.next({...t.value,environment:n})}}),H=x({setLoadedData:e=>{let t=A(),n=e(t.value.loadedData);t.next({...t.value,loadedData:n})}}),J=p({getState:()=>A().value}),K=r({setDomainDataState:e=>{let t=A(),n=e(t.value.domainData);t.next({...t.value,domainData:n})}}),M=m({getState:()=>A().value,overridesSelectors:B}),N=D({setSessionContextState:e=>{let t=A(),n=e(t.value.sessionContext);t.next({...t.value,sessionContext:n})}}),P=b({getState:()=>A().value,overridesSelectors:B}),Q=t({setAccessInfoState:e=>{let t=A(),n=e(t.value.access);t.next({...t.value,access:n})}}),U=n({getState:()=>A().value,overridesSelectors:B}),V=z({setWebComponentState:e=>{let t=A(),n=e(t.value.webComponent);t.next({...t.value,webComponent:n})}}),X=R({getState:()=>A().value}),Y=o({setDomainContextState:e=>{let t=A(),n=e(t.value.domainContext);t.next({...t.value,domainContext:n})}}),Z={configurator:i({applicationType:"configurator",getState:()=>A().value,actions:Y.configurator,getExtensionSystems:()=>L?.("configurator")??[],specSelectors:W,accessSelectors:U,webComponentSelectors:X,domainDataSelectors:M,sessionContextSelectors:P,domainServicesSelectors:k,environmentSelectors:F}),admin:i({applicationType:"admin",getState:()=>A().value,actions:Y.admin,getExtensionSystems:()=>L?.("admin")??[],specSelectors:W,accessSelectors:U,webComponentSelectors:X,domainDataSelectors:M,sessionContextSelectors:P,domainServicesSelectors:k,environmentSelectors:F})};return{initialize:()=>({spec:E(h),overrides:C(),environment:v(h),loadedData:S(),domainData:l(),sessionContext:j(),access:a(),webComponent:T(),domainContext:s()}),selectors:{domainServices:k,spec:W,overrides:B,environment:F,loadedData:J,domainData:M,sessionContext:P,access:U,webComponent:X,domainContext:Z},actions:{spec:O,overrides:q,environment:G,loadedData:H,domainData:K,sessionContext:N,access:Q,webComponent:V,domainContext:Y}}}export const createDomainRuntime=t=>{let{config:n,services:a,getExtensionSystems:o}=t,i=null,s=createDomainRuntimeSlices({config:n,getSubject:()=>{if(!i)throw Error("Subject not yet initialized!");return i},services:a,getExtensionSystems:o});return i=new e(s.initialize()),{...s,getState:()=>i.value,subscribe:e=>{let t=i.subscribe(()=>e());return()=>t.unsubscribe()}}};
+import{BehaviorSubject as e}from"rxjs";import{createAccessInfoActions as t,createAccessInfoSelectors as n,initializeAccessInfo as o}from"./access/index.js";import{applicationFromConfig as a}from"./application.js";import{createDomainContextActions as i,createDomainContextSelectors as s,initializeDomainContext as r}from"./domain-context/index.js";import{createDomainDataActions as m,createDomainDataSelectors as l,initializeDomainData as c}from"./domain-data/index.js";import{createDomainServicesSelectors as d}from"./domain-services/index.js";import{createEnvironmentActions as u,createEnvironmentSelectors as v,initializeEnvironment as p}from"./environment/index.js";import{createLoadedDataActions as x,createLoadedDataSelectors as S,initializeLoadedData as g}from"./loaded-data/index.js";import{createOverridesActions as f,createOverridesSelectors as C,initializeOverrides as D}from"./overrides/index.js";import{createSessionContextActions as b,createSessionContextSelectors as j,initializeSessionContext as w}from"./session-context/index.js";import{createSpecActions as y,createSpecSelectors as E}from"./spec/index.js";import{createWebComponentActions as z,createWebComponentSelectors as R,initializeWebComponent as h}from"./web-component/index.js";export function createDomainRuntimeSlices(e){let{getSubject:A,services:H,getExtensionSystems:T,getHostSystems:I}=e,L=y({setSpec:e=>{let t=A(),n=e(t.value.spec);t.next({...t.value,spec:n})}}),M=E({getState:()=>A().value}),O=d({services:H,specSelectors:M}),W=f({setOverrides:e=>{let t=A(),n=e(t.value.overrides);t.next({...t.value,overrides:n})}}),k=C({getState:()=>A().value}),q=v({getState:()=>A().value,overridesSelectors:k}),B=u({setEnvironment:e=>{let t=A(),n=e(t.value.environment);t.next({...t.value,environment:n})}}),F=x({setLoadedData:e=>{let t=A(),n=e(t.value.loadedData);t.next({...t.value,loadedData:n})}}),G=S({getState:()=>A().value}),J=m({setDomainDataState:e=>{let t=A(),n=e(t.value.domainData);t.next({...t.value,domainData:n})}}),K=l({getState:()=>A().value,overridesSelectors:k}),N=b({setSessionContextState:e=>{let t=A(),n=e(t.value.sessionContext);t.next({...t.value,sessionContext:n})}}),P=j({getState:()=>A().value,overridesSelectors:k}),Q=t({setAccessInfoState:e=>{let t=A(),n=e(t.value.access);t.next({...t.value,access:n})}}),U=n({getState:()=>A().value,overridesSelectors:k}),{setLocale:V,...X}=z({setWebComponentState:e=>{let t=A(),n=e(t.value.webComponent);t.next({...t.value,webComponent:n})}}),Y=R({getState:()=>A().value}),Z=i({setDomainContextState:e=>{let t=A(),n=e(t.value.domainContext);t.next({...t.value,domainContext:n})}}),$={configurator:s({applicationType:"configurator",getState:()=>A().value,actions:Z.configurator,getExtensionSystems:()=>T?.("configurator")??[],getHostSystems:()=>I?.("configurator")??{},specSelectors:M,accessSelectors:U,webComponentSelectors:Y,domainDataSelectors:K,sessionContextSelectors:P,domainServicesSelectors:O,environmentSelectors:q}),admin:s({applicationType:"admin",getState:()=>A().value,actions:Z.admin,getExtensionSystems:()=>T?.("admin")??[],getHostSystems:()=>I?.("admin")??{},specSelectors:M,accessSelectors:U,webComponentSelectors:Y,domainDataSelectors:K,sessionContextSelectors:P,domainServicesSelectors:O,environmentSelectors:q})};return{initialize:()=>{let t=e.application??a(e.config);return{spec:t.spec,overrides:D(),environment:p(t.environment),loadedData:g(),domainData:c(),sessionContext:w(),access:o(),webComponent:h(),domainContext:r()}},selectors:{domainServices:O,spec:M,overrides:k,environment:q,loadedData:G,domainData:K,sessionContext:P,access:U,webComponent:Y,domainContext:$},actions:{spec:L,overrides:W,environment:B,loadedData:F,domainData:J,sessionContext:N,access:Q,webComponent:X,domainContext:Z},hostMirrorActions:{setLocale:V}}}export const createDomainRuntime=t=>{let n=null,o=createDomainRuntimeSlices({...t,getSubject:()=>{if(!n)throw Error("Subject not yet initialized!");return n}});return n=new e(o.initialize()),{...o,getState:()=>n.value,subscribe:e=>{let t=n.subscribe(()=>e());return()=>t.unsubscribe()}}};

package/dist/domain/domain-runtime/environment/actions.d.ts

@@ -6,6 +6,7 @@ export declare const createEnvironmentActions: (context: Context) => {
     updateEnvironment: (environment: ApplicationEnvironmentConfig) => void;
     setGodMode: (godMode: boolean) => void;
     setEditorMode: (editorMode: boolean) => void;
+    setAgentMode: (agentMode: boolean) => void;
 };
 export type EnvironmentActions = ReturnType<typeof createEnvironmentActions>;
 export {};

package/dist/domain/domain-runtime/environment/actions.js

@@ -1 +1 @@
-export const createEnvironmentActions=e=>{let{setEnvironment:t}=e;return{updateEnvironment:e=>t(t=>({...t,environment:e})),setGodMode:e=>{t(t=>({...t,godMode:e}))},setEditorMode:e=>{t(t=>({...t,editorMode:e}))}}};
+export const createEnvironmentActions=e=>{let{setEnvironment:t}=e;return{updateEnvironment:e=>t(t=>({...t,environment:e})),setGodMode:e=>{t(t=>({...t,godMode:e}))},setEditorMode:e=>{t(t=>({...t,editorMode:e}))},setAgentMode:e=>{t(t=>({...t,agentMode:e}))}}};

package/dist/domain/domain-runtime/environment/initialize.d.ts

@@ -2,4 +2,4 @@ import type { AnyApplicationConfig } from '../../application/index.js';
 import type { ApplicationEnvironmentConfig } from './types.js';
 export declare const GOD_MODE_SESSION_STORAGE_KEY = "salsita-god-mode";
 export declare const isNotRegisteredDeploymentId: (deploymentId: string) => boolean;
-export declare const initializeEnvironment: (config: AnyApplicationConfig) => ApplicationEnvironmentConfig;
+export declare const initializeEnvironment: (config: Pick<AnyApplicationConfig, 'defaultEnvs' | 'deploymentId' | 'isDev' | 'persistence'>) => ApplicationEnvironmentConfig;

package/dist/domain/domain-runtime/environment/initialize.js

@@ -1 +1 @@
-import{v4 as e}from"uuid";import{resolveIsDev as r}from"./selectors.js";export const GOD_MODE_SESSION_STORAGE_KEY="salsita-god-mode";let t="not-registered-";export const isNotRegisteredDeploymentId=e=>e.startsWith(t);export const initializeEnvironment=o=>{var s;let i=o.defaultEnvs;return{isDev:r(o),godMode:"u">typeof sessionStorage&&"true"===sessionStorage.getItem("salsita-god-mode"),editorMode:!1,deploymentId:void 0===(s=o.deploymentId??i?.deploymentId)?`${t}${e()}`:s,datadogEnabled:i?.datadogEnabled,datadogSite:i?.datadogSite,datadogClientToken:i?.datadogClientToken,serviceName:i?.serviceName,persistenceMode:i?.persistenceMode,serverUrl:i?.serverUrl,resourcesUrl:i?.resourcesUrl,gtmId:i?.gtmId,gtmDebug:i?.gtmDebug,persistenceConfig:((e,r)=>{if(e)return e;let t=r?.persistenceMode??(r?.serverUrl?"server":"memory");if("memory"===t)return{type:"memory"};if("local-storage"===t)return{type:"local-storage"};if(!r?.serverUrl)throw Error("SERVER_URL is required when using server persistence! Please provide SERVER_URL in the phoenix runtime config.");return{type:"server",serverUrl:r.serverUrl}})(o.persistence,i)}};
+import{v4 as e}from"uuid";import{resolveIsDev as r}from"./selectors.js";export const GOD_MODE_SESSION_STORAGE_KEY="salsita-god-mode";let t="not-registered-";export const isNotRegisteredDeploymentId=e=>e.startsWith(t);export const initializeEnvironment=o=>{var s;let i=o.defaultEnvs;return{isDev:r(o),godMode:"u">typeof sessionStorage&&"true"===sessionStorage.getItem("salsita-god-mode"),editorMode:!1,agentMode:!1,deploymentId:void 0===(s=o.deploymentId??i?.deploymentId)?`${t}${e()}`:s,datadogEnabled:i?.datadogEnabled,datadogSite:i?.datadogSite,datadogClientToken:i?.datadogClientToken,serviceName:i?.serviceName,persistenceMode:i?.persistenceMode,serverUrl:i?.serverUrl,resourcesUrl:i?.resourcesUrl,gtmId:i?.gtmId,gtmDebug:i?.gtmDebug,persistenceConfig:((e,r)=>{if(e)return e;let t=r?.persistenceMode??(r?.serverUrl?"server":"memory");if("memory"===t)return{type:"memory"};if("local-storage"===t)return{type:"local-storage"};if(!r?.serverUrl)throw Error("SERVER_URL is required when using server persistence! Please provide SERVER_URL in the phoenix runtime config.");return{type:"server",serverUrl:r.serverUrl}})(o.persistence,i)}};

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

@@ -20,6 +20,7 @@ export declare const createEnvironmentSelectors: (context: Context) => {
     selectEnvironmentIsDev: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, boolean>;
     selectGodMode: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, boolean>;
     selectEditorMode: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, boolean>;
+    selectAgentMode: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, boolean>;
     selectDeploymentId: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, string>;
     selectDatadogEnabled: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, boolean | undefined>;
     selectDatadogSite: import("@salsita-ai/common/utils").Selector<EnvironmentSelectorState, string | undefined>;
@@ -43,6 +44,7 @@ export declare const createEnvironmentSelectors: (context: Context) => {
     getEnvironmentIsDev: () => boolean;
     getGodMode: () => boolean;
     getEditorMode: () => boolean;
+    getAgentMode: () => boolean;
     getDeploymentId: () => string;
     getDatadogEnabled: () => boolean | undefined;
     getDatadogSite: () => string | undefined;

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

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";export const resolveIsDev=e=>e.isDev??e.defaultEnvs?.isDev??!1;let t={type:"memory"};export const createEnvironmentSelectors=o=>{let{getState:s,overridesSelectors:r}=o,n=e.withTypes(),g=n([n.leaf(e=>e.environment)],e=>e),i=n([g],e=>e.isDev),d=n([g],e=>e.godMode),a=n([g],e=>e.editorMode),l=n([g],e=>e.deploymentId),c=n([g],e=>e.datadogEnabled),m=n([g],e=>e.datadogSite),v=n([g],e=>e.datadogClientToken),D=n([g],e=>e.serviceName),p=n([g],e=>e.persistenceMode),f=n([g],e=>e.resourcesUrl),u=n([g],e=>e.serverUrl),y=n([g],e=>e.gtmId),C=n([g],e=>e.gtmDebug),E=n([g],e=>e.persistenceConfig),I=n([E,r.selectPersistenceConfig],(e,t)=>t??e),M=n([I,r.selectActive],(e,o)=>"memory"===e.type?e:o?t:e);return{selectEnvironment:g,selectEnvironmentIsDev:i,selectGodMode:d,selectEditorMode:a,selectDeploymentId:l,selectDatadogEnabled:c,selectDatadogSite:m,selectDatadogClientToken:v,selectServiceName:D,selectPersistenceMode:p,selectResourcesUrl:f,selectServerUrl:u,selectGtmId:y,selectGtmDebug:C,selectRawPersistenceConfig:E,selectBasePersistenceConfig:I,selectPersistenceConfig:M,getEnvironmentIsDev:()=>i(s()),getGodMode:()=>d(s()),getEditorMode:()=>a(s()),getDeploymentId:()=>l(s()),getDatadogEnabled:()=>c(s()),getDatadogSite:()=>m(s()),getDatadogClientToken:()=>v(s()),getServiceName:()=>D(s()),getPersistenceMode:()=>p(s()),getResourcesUrl:()=>f(s()),getServerUrl:()=>u(s()),getGtmId:()=>y(s()),getGtmDebug:()=>C(s()),getRawPersistenceConfig:()=>E(s()),getBasePersistenceConfig:()=>I(s()),getPersistenceConfig:()=>M(s())}};
+import{createSelector as e}from"@salsita-ai/common/utils";export const resolveIsDev=e=>e.isDev??e.defaultEnvs?.isDev??!1;let t={type:"memory"};export const createEnvironmentSelectors=o=>{let{getState:s,overridesSelectors:n}=o,r=e.withTypes(),g=r([r.leaf(e=>e.environment)],e=>e),i=r([g],e=>e.isDev),d=r([g],e=>e.godMode),a=r([g],e=>e.editorMode),l=r([g],e=>e.agentMode),c=r([g],e=>e.deploymentId),m=r([g],e=>e.datadogEnabled),v=r([g],e=>e.datadogSite),D=r([g],e=>e.datadogClientToken),p=r([g],e=>e.serviceName),f=r([g],e=>e.persistenceMode),M=r([g],e=>e.resourcesUrl),u=r([g],e=>e.serverUrl),y=r([g],e=>e.gtmId),C=r([g],e=>e.gtmDebug),E=r([g],e=>e.persistenceConfig),I=r([E,n.selectPersistenceConfig],(e,t)=>t??e),P=r([I,n.selectActive],(e,o)=>"memory"===e.type?e:o?t:e);return{selectEnvironment:g,selectEnvironmentIsDev:i,selectGodMode:d,selectEditorMode:a,selectAgentMode:l,selectDeploymentId:c,selectDatadogEnabled:m,selectDatadogSite:v,selectDatadogClientToken:D,selectServiceName:p,selectPersistenceMode:f,selectResourcesUrl:M,selectServerUrl:u,selectGtmId:y,selectGtmDebug:C,selectRawPersistenceConfig:E,selectBasePersistenceConfig:I,selectPersistenceConfig:P,getEnvironmentIsDev:()=>i(s()),getGodMode:()=>d(s()),getEditorMode:()=>a(s()),getAgentMode:()=>l(s()),getDeploymentId:()=>c(s()),getDatadogEnabled:()=>m(s()),getDatadogSite:()=>v(s()),getDatadogClientToken:()=>D(s()),getServiceName:()=>p(s()),getPersistenceMode:()=>f(s()),getResourcesUrl:()=>M(s()),getServerUrl:()=>u(s()),getGtmId:()=>y(s()),getGtmDebug:()=>C(s()),getRawPersistenceConfig:()=>E(s()),getBasePersistenceConfig:()=>I(s()),getPersistenceConfig:()=>P(s())}};

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

@@ -18,7 +18,7 @@ export interface ApplicationEnvironmentConfig {
     /**
      * Whether the maintenance "god mode" is enabled — it unlocks destructive admin tooling
      * (eg. the maintenance menu). Seeded from session storage during mount and toggled at
-     * runtime via the `window.__salsita.setGodMode` global (see `registerGodModeGlobal`).
+     * runtime via the `window.__salsita.setGodMode` global, per runtime (see `SetGodMode`).
      */
     readonly godMode: boolean;
     /**
@@ -27,6 +27,12 @@ export interface ApplicationEnvironmentConfig {
      * relaxed required-property checks, hot reload remounts) keys off this flag.
      */
     readonly editorMode: boolean;
+    /**
+     * Whether the application runs under `phoenix dev` in agent mode, inside the editor with its UI
+     * hidden. Seeded `false` during mount and set by the hidden editor while it is mounted — the dev
+     * error pages show the "Agent at work" screen in place of the error details when it is set.
+     */
+    readonly agentMode: boolean;
     /**
      * ID of the frontend deployment used to authenticate against the PhX server. Resolved
      * during mount from `config.deploymentId ?? config.defaultEnvs.deploymentId`; falls

package/dist/domain/domain-runtime/index.d.ts

@@ -1,4 +1,6 @@
 export * from './domain-runtime.js';
+export * from './action-factory.js';
+export { type Application, applicationFromConfig } from './application.js';
 export * from './domain-context/index.js';
 export * from './domain-services/index.js';
 export * from './spec/index.js';

package/dist/domain/domain-runtime/index.js

@@ -1 +1 @@
-export*from"./domain-runtime.js";export*from"./domain-context/index.js";export*from"./domain-services/index.js";export*from"./spec/index.js";export*from"./environment/index.js";export*from"./access/index.js";export*from"./overrides/index.js";export*from"./loaded-data/index.js";export*from"./domain-data/index.js";export*from"./session-context/index.js";export*from"./web-component/index.js";
+export*from"./domain-runtime.js";export*from"./action-factory.js";export{applicationFromConfig}from"./application.js";export*from"./domain-context/index.js";export*from"./domain-services/index.js";export*from"./spec/index.js";export*from"./environment/index.js";export*from"./access/index.js";export*from"./overrides/index.js";export*from"./loaded-data/index.js";export*from"./domain-data/index.js";export*from"./session-context/index.js";export*from"./web-component/index.js";

package/dist/domain/domain-runtime/spec/create-violation-expressions.d.ts

@@ -0,0 +1,24 @@
+import { type AnonymousExpression, type AnyAliasMap, type Violation } from '../../core/index.js';
+import { type AnyInvariant, type ProjectModule } from '../../spec/index.js';
+/**
+ * The `$violations` expression of every entity type that has invariants, keyed by entity type.
+ *
+ * The entity and data types are erased: the expression only passes its arguments on to the invariants,
+ * and `DomainBuilder.withExpressions` accepts it for any project.
+ */
+type ViolationExpressions = Readonly<Record<string, {
+    readonly $violations: AnonymousExpression<any, any, any, any, any, any, ReadonlyArray<Violation<string>>>;
+}>>;
+/**
+ * Creates the `$violations` expressions of a domain from its invariants.
+ *
+ * Takes the invariants of the `src/invariants/` files, as the generated barrel lists them, after
+ * checking each file against the folder's contract. An invariant declared for an alias applies to
+ * every entity type of the alias. The `$violations` expression of an entity type returns the
+ * violations of all its invariants: those of `commonInvariants` first, then those of the files in
+ * the order of the barrel.
+ *
+ * @param commonInvariants Invariants the SDK adds to the domain, such as the ones every admin domain has.
+ */
+export declare const createViolationExpressions: (aliasMap: AnyAliasMap, modules: readonly ProjectModule[], commonInvariants?: Readonly<Record<string, readonly AnyInvariant[]>>) => ViolationExpressions;
+export {};

package/dist/domain/domain-runtime/spec/create-violation-expressions.js

@@ -0,0 +1 @@
+import{expandAlias as e}from"../../core/index.js";import{resolveInvariantModules as t}from"../../spec/index.js";export const createViolationExpressions=(o,r,f={})=>{let i={};for(let l of[f,t(r)])for(let[t,r]of Object.entries(l))for(let f of e(o,t))i[f]=[...i[f]??[],...r];let l={};for(let[e,t]of Object.entries(i))l[e]={$violations:{evaluate:(e,o,r)=>t.flatMap(t=>t.evaluate(e,o,r)),meta:{}}};return l};

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

@@ -1,4 +1,9 @@
 export * from './selectors.js';
 export type * from './types.js';
 export * from './actions.js';
+export * from './create-violation-expressions.js';
 export * from './initialize.js';
+export * from './memoize-expression.js';
+export * from './prepare-action-implementations.js';
+export * from './prepare-domain-expressions.js';
+export * from './resolve-imported-transformers.js';

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

@@ -1 +1 @@
-export*from"./selectors.js";export*from"./actions.js";export*from"./initialize.js";
+export*from"./selectors.js";export*from"./actions.js";export*from"./create-violation-expressions.js";export*from"./initialize.js";export*from"./memoize-expression.js";export*from"./prepare-action-implementations.js";export*from"./prepare-domain-expressions.js";export*from"./resolve-imported-transformers.js";

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

@@ -1,3 +1,14 @@
 import type { AnyApplicationConfig } from '../../application/index.js';
 import type { ApplicationSpec } from './types.js';
+/**
+ * Builds the runtime spec of an application from its config.
+ *
+ * Project files reach the config unchecked; this is where each one is held to its folder's
+ * contract. Every file is checked on its own, and all the files that break their contract are
+ * thrown together as one `ImplementationErrors`. Its errors are ordered by folder (handlers,
+ * elements, transformers, configurator components, admin components) and inside a folder by the
+ * order of the config's list. No spec is returned when a file is wrong, so nothing that reads the
+ * spec, such as the transformer selection, runs on a list with a file missing and reports the
+ * mistake a second time.
+ */
 export declare const initializeSpec: (config: AnyApplicationConfig) => ApplicationSpec;

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

@@ -1 +1 @@
-import{SessionRole as e}from"@salsita-ai/contracts/api";let a=(e,a)=>{let t={};for(let n of e)t[n.name]=a?.[n.name]??n.name;return t},t=(e,a)=>{let t={},n=0;for(let o of e)if("entity"===o.type||"layout"===o.type)t[o.name]=a?.[o.name]??o.name;else{let e=`icon:${n}`;t[e]=a?.[e]??`${e}:${o.elements.length}`,n+=1}return t};export const initializeSpec=n=>{let o=n.adminDomain.presets[0];if(!o)throw Error("Cannot register application spec because admin preset is required.");return{version:n.version,dataConfig:n.dataSpec??null,chunks:n.chunks,publishedDataHash:n.publishedDataHash,initialPublishedData:n.initialPublishedData,canCreate:n.features?.acl?.canCreate??Object.values(e),enableAdminRelease:n.features?.enableAdminRelease??!1,textLanguages:n.domain.textLanguages??n.adminDomain.textLanguages??["en"],baseResourcesUrl:n.resources?.baseResourcesUrl??n.defaultEnvs?.resourcesUrl??"",configurator:{factory:n.domain.domainFactory,presets:n.domain.presets,aliasMap:n.domain.domainFactory.context.aliasMap,entityReflections:n.domain.domainFactory.context.entityReflections,$entityReflections:n.domain.domainFactory.context.$entityReflections,expressions:n.domain.domainFactory.context.expressions,actions:n.domain.domainFactory.context.actions,actionImplementations:n.domain.domainFactory.context.actionImplementations,allowedRootEntityTypes:n.domain.domainFactory.context.allowedRootEntityTypes,migrate:n.domain.domainFactory.context.migrate,componentOptics:n.domain.componentOptics,createTransformers:n.createTransformers??(()=>[]),navigationStates:n.navigation?.navigationStates??[],viewStates:n.navigation?.viewStates??[],toolStates:n.navigation?.toolStates??[],exportStates:n.navigation?.exportStates??[],handlers:n.handlers,handlerHashes:a(n.handlers),elements:n.elements,elementHashes:t(n.elements),appLoader:n.ui?.appLoader??"universal",preview:n.ui?.preview??"auto",alwaysExpand:n.ui?.alwaysExpand??!1,theme:n.ui?.theme??{},assistant:n.assistant??null,deploymentQueryDisabled:n.resources?.deploymentQueryDisabled??!1,prefetchTextureUrls:n.resources?.prefetchTextureUrls??[],modelVersion:n.domain.domainFactory.modelVersion},admin:{factory:n.adminDomain.domainFactory,modelVersion:n.adminDomain.domainFactory.modelVersion,aliasMap:n.adminDomain.domainFactory.context.aliasMap,entityReflections:n.adminDomain.domainFactory.context.entityReflections,$entityReflections:n.adminDomain.domainFactory.context.$entityReflections,expressions:n.adminDomain.domainFactory.context.expressions,actions:n.adminDomain.domainFactory.context.actions,actionImplementations:n.adminDomain.domainFactory.context.actionImplementations,allowedRootEntityTypes:n.adminDomain.domainFactory.context.allowedRootEntityTypes,migrate:n.adminDomain.domainFactory.context.migrate,preset:o,componentOptics:n.adminDomain.componentOptics,navigationStates:n.adminNavigation?.navigationStates??[],viewStates:n.adminNavigation?.viewStates??[],handlers:n.handlers,handlerHashes:a(n.handlers),elements:n.elements,elementHashes:t(n.elements)}}};
+import{SessionRole as e}from"@salsita-ai/contracts/api";import{createImplementationErrorCollector as t,resolveComponentOpticModules as a,resolveElementModule as n,resolveHandlerModule as o}from"../../spec/index.js";import{resolveImportedTransformers as i,resolveTransformerModule as s}from"./resolve-imported-transformers.js";let r=(e,t,a)=>e.flatMap(e=>a.attempt(()=>t(e),[]));export const initializeSpec=m=>{let c=m.adminDomain.presets[0];if(!c)throw Error("Cannot register application spec because admin preset is required.");let d=t(),l=r(m.handlers,o,d),p=r(m.elements,n,d),y=r(m.transformers?.importedTransformers??[],e=>[s(e)],d),u=r(m.domain.componentOptics,e=>a([e]),d),f=r(m.adminDomain.componentOptics,e=>a([e]),d);d.throwIfAny();let x=(e=>{let t={};for(let a of e)t[a.name]=(void 0)??a.name;return t})(l),v=(e=>{let t={},a=0;for(let n of e)if("assistantFormElement"!==n.type)if("entity"===n.type||"layout"===n.type)t[n.name]=(void 0)??n.name;else{let e=`icon:${a}`;t[e]=(void 0)??`${e}:${n.elements.length}`,a+=1}return t})(p),g=m.transformers?.specTransformers??[];return{version:m.version,dataConfig:m.dataSpec??null,chunks:m.chunks,publishedDataHash:m.publishedDataHash,initialPublishedData:m.initialPublishedData,canCreate:m.features?.acl?.canCreate??Object.values(e),enableAdminRelease:m.features?.enableAdminRelease??!1,textLanguages:m.domain.textLanguages??m.adminDomain.textLanguages??["en"],baseResourcesUrl:m.resources?.baseResourcesUrl??m.defaultEnvs?.resourcesUrl??"",configurator:{factory:m.domain.domainFactory,presets:m.domain.presets,aliasMap:m.domain.domainFactory.context.aliasMap,entityReflections:m.domain.domainFactory.context.entityReflections,$entityReflections:m.domain.domainFactory.context.$entityReflections,expressions:m.domain.domainFactory.context.expressions,actions:m.domain.domainFactory.context.actions,actionImplementations:m.domain.domainFactory.context.actionImplementations,allowedRootEntityTypes:m.domain.domainFactory.context.allowedRootEntityTypes,migrate:m.domain.domainFactory.context.migrate,componentOptics:u,createTransformers:e=>i(y,g,e),navigationStates:m.navigation?.navigationStates??[],viewStates:m.navigation?.viewStates??[],toolStates:m.navigation?.toolStates??[],exportStates:m.navigation?.exportStates??[],handlers:l,handlerHashes:x,elements:p,defaultElements:m.defaultElements??[],elementHashes:v,appLoader:m.ui?.appLoader??"universal",preview:m.ui?.preview??"auto",alwaysExpand:m.ui?.alwaysExpand??!1,theme:m.ui?.theme??{},assistant:m.assistant??null,deploymentQueryDisabled:m.resources?.deploymentQueryDisabled??!1,prefetchTextureUrls:m.resources?.prefetchTextureUrls??[],modelVersion:m.domain.domainFactory.modelVersion},admin:{factory:m.adminDomain.domainFactory,modelVersion:m.adminDomain.domainFactory.modelVersion,aliasMap:m.adminDomain.domainFactory.context.aliasMap,entityReflections:m.adminDomain.domainFactory.context.entityReflections,$entityReflections:m.adminDomain.domainFactory.context.$entityReflections,expressions:m.adminDomain.domainFactory.context.expressions,actions:m.adminDomain.domainFactory.context.actions,actionImplementations:m.adminDomain.domainFactory.context.actionImplementations,allowedRootEntityTypes:m.adminDomain.domainFactory.context.allowedRootEntityTypes,migrate:m.adminDomain.domainFactory.context.migrate,preset:c,componentOptics:f,navigationStates:m.adminNavigation?.navigationStates??[],viewStates:m.adminNavigation?.viewStates??[],handlers:l,handlerHashes:x,elements:p,elementHashes:v}}};

package/dist/domain/domain-runtime/spec/memoize-expression.d.ts

@@ -0,0 +1,16 @@
+import type { DomainEntity, DomainEntityId, Expression, ExpressionOrigin } from '../../core/index.js';
+export interface ExpressionTrace {
+    origin: ExpressionOrigin;
+    entityId: DomainEntityId<string>;
+}
+export declare const traceToString: (trace: ExpressionTrace) => string;
+export declare class ExpressionEvaluationError extends Error {
+    readonly _tag = "expression-evaluation-error";
+    constructor(trace: ExpressionTrace, error: any);
+}
+export declare class CircularDependencyError extends Error {
+    readonly _tag = "circular-dependency-error";
+    readonly path: ExpressionTrace[];
+    constructor(trace: ExpressionTrace, cause?: CircularDependencyError);
+}
+export declare const memoizeExpression: <ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, SELF extends ENTITIES, T>(expression: Expression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, SELF, T>) => Expression<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, SELF, T>;

package/dist/domain/domain-runtime/spec/prepare-action-implementations.d.ts

@@ -0,0 +1,15 @@
+import type { ActionDefinitions, AnyActionImplementations } from '../../core/index.js';
+/** The declared actions that have no implementation, and the implementations of undeclared names. */
+export interface ActionImplementationConflicts {
+    readonly missing: readonly string[];
+    readonly extra: readonly string[];
+}
+/** Compares the names of the declared actions with the implemented ones. */
+export declare const findActionImplementationConflicts: (declared: readonly string[], implementations: AnyActionImplementations) => ActionImplementationConflicts;
+/**
+ * Validates the implemented actions against the declared ones, as `prepareDomainExpressions` does
+ * for expressions: a declared action without an implementation throws, so the domain is not
+ * instantiated with an action that can only fail when it is called; an implementation of an
+ * undeclared name is logged. Returns the implementations unchanged.
+ */
+export declare const prepareActionImplementations: (definitions: ActionDefinitions, implementations: AnyActionImplementations) => AnyActionImplementations;

package/dist/domain/domain-runtime/spec/prepare-action-implementations.js

@@ -0,0 +1,5 @@
+export const findActionImplementationConflicts=(e,t)=>{let n=Object.entries(t).filter(([,e])=>"function"==typeof e).map(([e])=>e);return{missing:e.filter(e=>!n.includes(e)),extra:n.filter(t=>!e.includes(t))}};export const prepareActionImplementations=(e,t)=>{let{missing:n,extra:i}=findActionImplementationConflicts(Object.values(e).map(e=>e.name),t);if(0===n.length&&0===i.length)return t;let o=Error("Domain cannot be instantiated because there are conflicts between declared and implemented actions."+(n.length>0?`
+
+Missing actions: ${n.join(", ")}. Add each to a default export of phx.domain.implementActions({ ... }) in src/actions/.`:"")+(i.length>0?`
+
+Extra actions: ${i.join(", ")}. Declare each under "actions" in a spec file or remove its implementation.`:"")+"\n");if(n.length>0)throw o;return console.error(o),t};

package/dist/domain/domain-runtime/spec/prepare-domain-expressions.d.ts

@@ -0,0 +1,16 @@
+import type { AnyExpressions } from '../../core/index.js';
+interface DomainExpressionsSource {
+    readonly expressions: AnyExpressions;
+    readonly $entityReflections: Record<string, {
+        readonly expressions: readonly string[];
+    }>;
+}
+/**
+ * Derives the runnable expression table from the factory's spec data: validates the declared
+ * (reflection) expressions against the implemented ones — missing implementations throw, extra
+ * ones log — and wraps every expression in the per-state memoization. Pure with respect to its
+ * input, so it can back a registry selector keyed on the factory identity: a hot-reloaded factory
+ * produces a fresh table, an unchanged one keeps the memoized result.
+ */
+export declare const prepareDomainExpressions: (source: DomainExpressionsSource) => AnyExpressions;
+export {};

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

@@ -0,0 +1,22 @@
+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.
+ */
+export declare const resolveTransformerModule: (module: ProjectModule) => ImportedTransformer;
+/** Validates the `src/transformers/` files of an application config and names each after its file. */
+export declare const resolveTransformerModules: (modules: readonly ProjectModule[]) => readonly ImportedTransformer[];
+/**
+ * Resolves imported transformer modules against spec transformer declarations.
+ * Each imported transformer is registered/executed with the domain context,
+ * then matched by name against spec entries to apply priority ordering.
+ *
+ * Used both when the runtime spec is initialized from the application config and at hot-reload time
+ * (via domain-context subscription to registry changes).
+ *
+ * The transformers come from untyped project modules, so the context and the result have the open types of
+ * `AnyCreateTransformersFactory`, the slot of the runtime spec this function fills.
+ */
+export declare const resolveImportedTransformers: (importedTransformers: readonly ImportedTransformer[], specTransformers: readonly SpecTransformer[], ctx: AnyDomainContextSystems) => Transformers<any>;

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,6 +1,5 @@
-import type { PropsWithChildren } from 'react';
-import type { CustomPhoenixEntityElementProps } from '../../application/element-registration.js';
-import type { PhoenixHandlerDefinition, SystemPhoenixAsyncHandlerDefinition, SystemPhoenixHandlerDefinition } from '../../application/handler-registration.js';
+import type { ComponentType, PropsWithChildren } from 'react';
+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
@@ -22,7 +21,7 @@ export declare const createSpecSelectors: (context: Context) => {
     selectAdminPreset: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("../../index.js").AnyProductPreset>;
     selectAdminModelVersion: import("@salsita-ai/common/utils").Selector<SpecSelectorState, number>;
     selectThemeOptions: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("@mui/material").ThemeOptions>;
-    selectAssistant: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("../../index.js").AssistantManifest | null>;
+    selectAssistant: import("@salsita-ai/common/utils").Selector<SpecSelectorState, Required<import("../../index.js").AssistantManifest> | null>;
     selectConfiguratorFactory: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("../../index.js").AnyDomainFactory>;
     selectAdminFactory: import("@salsita-ai/common/utils").Selector<SpecSelectorState, import("../../index.js").AnyDomainFactory>;
     selectConfiguratorComponentOptics: import("@salsita-ai/common/utils").Selector<SpecSelectorState, readonly import("../../index.js").AnyDomainComponentOptic[]>;
@@ -47,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>;
@@ -65,7 +65,7 @@ export declare const createSpecSelectors: (context: Context) => {
     getAdminPreset: () => import("../../index.js").AnyProductPreset;
     getAdminModelVersion: () => number;
     getThemeOptions: () => import("@mui/material").ThemeOptions;
-    getAssistant: () => import("../../index.js").AssistantManifest | null;
+    getAssistant: () => Required<import("../../index.js").AssistantManifest> | null;
     getConfiguratorFactory: () => import("../../index.js").AnyDomainFactory;
     getAdminFactory: () => import("../../index.js").AnyDomainFactory;
     getConfiguratorComponentOptics: () => readonly import("../../index.js").AnyDomainComponentOptic[];
@@ -90,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{systemElementRegistry as t}from"../../application/element-registration.js";export const createSpecSelectors=n=>{let{getState:a}=n,s=e.withTypes(),r=s([s.leaf(e=>e.spec)],e=>e),o=s([r],e=>e.version),l=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),y=s([r],e=>e.textLanguages),h=s([i],e=>e.modelVersion),f=s([r],e=>e.admin),C=s([f],e=>e.preset),A=s([f],e=>e.modelVersion),E=s([i],e=>e.theme),b=s([i],e=>e.assistant),H=s([i],e=>e.factory),x=s([f],e=>e.factory),D=s([i],e=>e.componentOptics),P=s([f],e=>e.componentOptics),S=s([i],e=>e.appLoader),w=s([i],e=>e.preview),O=s([i],e=>e.alwaysExpand),T=s([i],e=>e.presets),V=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={},n={},a={};for(let s of e)"phoenix"===s.type&&(t[s.name]=s.handler),"system"===s.type&&(n[s.name]=s.handler),"system-async"===s.type&&(a[s.name]=s.handler);return{handlers:t,systemHandlers:n,systemAsyncHandlers:a}})(e),hashes:t})),k=s([i],e=>e.elementHashes),F=s([i],e=>e.elements),M=s([F,k],(e,n)=>({...(e=>{let n={},a={};for(let t of e)"layout"===t.type&&(n[t.name]=t.element),"entity"===t.type&&(a[t.name]=t.element);return{entityElements:{...t.entityElements,...a},layoutElements:{...t.layoutElements,...n}}})(e),hashes:n}));return{selectSpec:r,selectVersion:o,selectBaseResourcesUrl:l,selectConfiguratorSpec:i,selectConfiguratorModelVersion:h,selectAdminSpec:f,selectAdminPreset:C,selectAdminModelVersion:A,selectThemeOptions:E,selectAssistant:b,selectConfiguratorFactory:H,selectAdminFactory:x,selectConfiguratorComponentOptics:D,selectAdminComponentOptics:P,selectAppLoader:S,selectPreview:w,selectAlwaysExpand:O,selectPresetSeed:T,selectDeploymentQueryDisabled:V,selectPrefetchTextureUrls:L,selectTextLanguages:y,selectHandlerHashes:R,selectHandlers:U,selectHandlerSlots:v,selectElementHashes:k,selectElements:F,selectElementSlots:M,selectDataConfig:g,selectChunks:m,selectPublishedDataHash:p,selectInitialPublishedData:d,selectCanCreate:c,selectEnableAdminRelease:u,getVersion:()=>o(a()),getBaseResourcesUrl:()=>l(a()),getConfiguratorSpec:()=>i(a()),getConfiguratorModelVersion:()=>h(a()),getAdminSpec:()=>f(a()),getAdminPreset:()=>C(a()),getAdminModelVersion:()=>A(a()),getThemeOptions:()=>E(a()),getAssistant:()=>b(a()),getConfiguratorFactory:()=>H(a()),getAdminFactory:()=>x(a()),getConfiguratorComponentOptics:()=>D(a()),getAdminComponentOptics:()=>P(a()),getAppLoader:()=>S(a()),getPreview:()=>w(a()),getAlwaysExpand:()=>O(a()),getPresetSeed:()=>T(a()),getDeploymentQueryDisabled:()=>V(a()),getPrefetchTextureUrls:()=>L(a()),getTextLanguages:()=>y(a()),getHandlerHashes:()=>R(a()),getHandlers:()=>U(a()),getHandlerSlots:()=>v(a()),getElementHashes:()=>k(a()),getElements:()=>F(a()),getElementSlots:()=>M(a()),getDataConfig:()=>g(a()),getChunks:()=>m(a()),getPublishedDataHash:()=>p(a()),getInitialPublishedData:()=>d(a()),getCanCreate:()=>c(a()),getEnableAdminRelease:()=>u(a())}};
+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/spec/types.d.ts

@@ -1,9 +1,9 @@
 import type { ThemeOptions } from '@mui/material';
 import type { SessionRole } from '@salsita-ai/contracts/api';
-import type { AssistantManifest, ChunksSpec, DataSpec, ElementRegistration, HandlerRegistration } from '../../application/index.js';
-import type { AnyDomainComponentOptic } from '../../components/index.js';
-import type { ActionDefinitions, Any$EntityReflections, AnyActionImplementations, AnyAliasMap, AnyAllowedRootEntityTypes, AnyDomainFactory, AnyEntityReflections, AnyExpressions, AnyProductPreset, DomainEntity, MigrateFunction } from '../../core/index.js';
-import type { AnyCreateTransformersFactory } from '../../domain-context/store-system/store-system.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 { AssistantResolvedManifest, ElementRegistration, HandlerRegistration } from '../../spec/index.js';
 export interface ApplicationConfiguratorSpec {
     readonly modelVersion: number;
     readonly factory: AnyDomainFactory;
@@ -35,6 +35,8 @@ export interface ApplicationConfiguratorSpec {
      */
     readonly handlerHashes: Record<string, string>;
     readonly elements: readonly ElementRegistration[];
+    /** The SDK's default element registrations; an entry of `elements` with the same name replaces one. */
+    readonly defaultElements: readonly ElementRegistration[];
     /**
      * Per-element content hash. Used as remount key so only the specific element
      * whose source changed remounts. Unchanged elements keep their hash and stay mounted.
@@ -46,10 +48,10 @@ export interface ApplicationConfiguratorSpec {
     readonly alwaysExpand: boolean;
     readonly theme: ThemeOptions;
     /**
-     * Experimental assistant manifest with its generated GraphQL SDL, or `null` when the application
+     * Resolved assistant manifest used to rebuild GraphQL SDL, or `null` when the application
      * spec declares no `assistant` section. Replaced by editor hot reload when the section changes.
      */
-    readonly assistant: AssistantManifest | null;
+    readonly assistant: AssistantResolvedManifest | null;
     /**
      * When true, resource urls are not suffixed with the `?did=<deploymentId>` cache-busting
      * query — useful for demos serving local blob urls.

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/angle-indicator.d.ts

@@ -0,0 +1,21 @@
+import { type Localizable } from '@salsita-ai/common/utils';
+import { type ComponentSnapshot } from '../core/index.js';
+import { type AngleIndicatorBaseState } from './common/index.js';
+export type AngleIndicatorComponentState = AngleIndicatorBaseState & {
+    /**
+     * Indicator label. If no label is provided, the measured angle in degrees will be shown.
+     */
+    readonly label?: Localizable;
+    /**
+     * If true, the indicator will be visible. Default is true.
+     */
+    readonly visible?: boolean;
+    /**
+     * If true, the indicator will always be shown regardless of the global dimension indicator visibility setting.
+     */
+    readonly force?: boolean;
+};
+export declare const angleIndicatorComponent: import("../index.js").SystemComponentType<"angleIndicator", AngleIndicatorComponentState, never>;
+export type AngleIndicatorComponent = typeof angleIndicatorComponent;
+export type AngleIndicatorComponentSnapshot = ComponentSnapshot<AngleIndicatorComponent>;
+export declare const isAngleIndicatorSnapshot: (snapshot: ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is ComponentSnapshot<import("../index.js").SystemComponentType<"angleIndicator", AngleIndicatorComponentState, never>>;

package/dist/domain/extensions/angle-indicator.js

@@ -0,0 +1 @@
+import{EnhancedLocalizableSchema as o}from"@salsita-ai/common/utils";import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";import{AngleIndicatorProperties as n}from"./common/index.js";export const angleIndicatorComponent=t.component("angleIndicator").withState({tsType:"AngleIndicatorComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AngleIndicatorComponentState"}],type:"object",properties:{...n,label:o,visible:{type:"boolean"},force:{type:"boolean"}},required:["positionX","positionY","positionZ","startAngle","sweepAngle"],additionalProperties:!1}).build();export const isAngleIndicatorSnapshot=e(angleIndicatorComponent);

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

@@ -0,0 +1,8 @@
+export declare const AttributeSwitchValueSchema: {
+    readonly type: 'boolean';
+};
+export type AttributeSwitchComponentState = {
+    readonly value: boolean;
+};
+export declare const attributeSwitchComponent: import("../index.js").SystemComponentType<"attributeSwitch", AttributeSwitchComponentState, "value">;
+export type AttributeSwitchComponent = typeof attributeSwitchComponent;

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

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

package/dist/domain/extensions/autorotate-camera-component.d.ts

@@ -0,0 +1,19 @@
+import { type ComponentSnapshot } from '../core/index.js';
+export type AutorotateCameraComponentState = {
+    /**
+     * Speed of autorotation in radians per second.
+     */
+    readonly speed?: number | undefined;
+    /**
+     * Whether to pause autorotation on user interaction.
+     */
+    readonly pauseOnInteraction?: boolean | undefined;
+    /**
+     * Delay in milliseconds before resuming autorotation after user interaction.
+     */
+    readonly resumeDelay?: number | undefined;
+};
+export declare const AutorotateCameraComponentName = "autorotateCamera";
+export declare const autorotateCameraComponent: import("../index.js").SystemComponentType<"autorotateCamera", AutorotateCameraComponentState, never>;
+export type AutorotateCameraComponent = typeof autorotateCameraComponent;
+export declare const isAutorotateCameraComponent: (state: ComponentSnapshot<any>) => state is ComponentSnapshot<AutorotateCameraComponent>;

package/dist/domain/extensions/autorotate-camera-component.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as e}from"../core/index.js";export const AutorotateCameraComponentName="autorotateCamera";export const autorotateCameraComponent=e.component(AutorotateCameraComponentName).withState({type:"object",tsType:"AutorotateCameraComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"AutorotateCameraComponentState"}],properties:{speed:{type:"number"},pauseOnInteraction:{type:"boolean"},resumeDelay:{type:"number"}},required:[],additionalProperties:!1}).build();export const isAutorotateCameraComponent=e=>e.componentInstance.componentType.name===AutorotateCameraComponentName;

package/dist/domain/extensions/basic-sidebar-footer.d.ts

@@ -0,0 +1,8 @@
+import { type ComponentInstance, type ComponentSnapshot } from '../core/index.js';
+export type BasicSidebarFooterComponentState = Record<string, never>;
+export declare const basicSidebarFooterComponent: import("../index.js").SystemComponentType<"basicSidebarFooter", BasicSidebarFooterComponentState, never>;
+export type BasicSidebarFooterComponent = typeof basicSidebarFooterComponent;
+export type BasicSidebarFooterComponentSnapshot = ComponentSnapshot<BasicSidebarFooterComponent>;
+export type BasicSidebarFooterComponentInstance = ComponentInstance<BasicSidebarFooterComponent>;
+export declare const isBasicSidebarFooterSnapshot: (snapshot: ComponentSnapshot<import("../index.js").SystemComponentTypeConstraint>) => snapshot is ComponentSnapshot<import("../index.js").SystemComponentType<"basicSidebarFooter", BasicSidebarFooterComponentState, never>>;
+export declare const isBasicSidebarFooterInstance: (instance: ComponentInstance<import("../index.js").SystemComponentTypeConstraint>) => instance is ComponentInstance<import("../index.js").SystemComponentType<"basicSidebarFooter", BasicSidebarFooterComponentState, never>>;

package/dist/domain/extensions/basic-sidebar-footer.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as o,isInstanceOfComponentType as e,isSnapshotOfComponentType as t}from"../core/index.js";export const basicSidebarFooterComponent=o.component("basicSidebarFooter").withState({type:"object",tsType:"BasicSidebarFooterComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"BasicSidebarFooterComponentState"}],properties:{},required:[],additionalProperties:!1}).build();export const isBasicSidebarFooterSnapshot=t(basicSidebarFooterComponent);export const isBasicSidebarFooterInstance=e(basicSidebarFooterComponent);

package/dist/domain/extensions/camera-based-hidden-entity-object.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const cameraBasedHiddenEntityObjectComponent=e.component("cameraBasedHiddenEntityObject").withState({type:"object",tsType:"CameraBasedHiddenEntityObjectComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CameraBasedHiddenEntityObjectComponentState"}],properties:{normal:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},required:["x","y","z"],additionalProperties:!1},constant:{type:"number"},behind:{type:"boolean"}},required:["normal","constant"],additionalProperties:!1}).build();export const isCameraBasedHiddenEntityObjectComponent=t(cameraBasedHiddenEntityObjectComponent);

package/dist/domain/extensions/camera-based-hidden-entity.js

@@ -0,0 +1 @@
+import{SystemComponentBuilder as e,isSnapshotOfComponentType as t}from"../core/index.js";export const cameraBasedHiddenEntityComponent=e.component("cameraBasedHiddenEntity").withState({type:"object",tsType:"CameraBasedHiddenEntityComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"CameraBasedHiddenEntityComponentState"}],properties:{normal:{type:"object",properties:{x:{type:"number"},y:{type:"number"},z:{type:"number"}},required:["x","y","z"],additionalProperties:!1},constant:{type:"number"},behind:{type:"boolean"}},required:["normal","constant"],additionalProperties:!1}).build();export const isCameraBasedHiddenEntityComponent=t(cameraBasedHiddenEntityComponent);