@salsita-ai/sdk 0.50.0-develop.9feae4851f → 0.50.0-develop.a4dde5f252

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

@@ -0,0 +1,4 @@
+import type { AnyActionImplementations } from '../../../core/index.js';
+import { type ProjectModule } from './project-modules.js';
+/** Validates the `src/actions/` files and merges their implementations by action name; a later file wins. */
+export declare const resolveActionModules: (modules: readonly ProjectModule[]) => AnyActionImplementations;

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

@@ -0,0 +1 @@
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as o}from"./project-modules.js";let i={expected:"an object of action implementations keyed by action name",fix:`Create it with phx.domain.implementActions({ ... }), ${e}.`},n=e=>"function"==typeof e;export const resolveActionModules=e=>e.reduce((e,r)=>{let c;if(!(o(c=r.exports)&&Object.values(c).every(n)))throw t(r.origin,i,r.exports);return{...e,...r.exports}},{});

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

@@ -0,0 +1,4 @@
+import type { AnyDomainComponentOptic } from '../../../core/index.js';
+import { type ProjectModule } from './project-modules.js';
+/** Validates the `src/components/` files, or the optics a generated file lists, and flattens them. */
+export declare const resolveComponentOpticModules: (modules: readonly ProjectModule[]) => readonly AnyDomainComponentOptic[];

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

@@ -0,0 +1 @@
+import{SHARED_FOLDER_HINT as t,isRecord as e,resolveListModule as n}from"./project-modules.js";let o={expected:"an attached component, or an array of them",fix:`Create it with phx.domain.attachComponent(...) (phx.domain.admin.attachComponent(...) under src/admin/), ${t}.`},a=t=>e(t)&&("simple"===t.kind||"dynamic"===t.kind)&&"string"==typeof t.instanceName&&"function"==typeof t.read;export const resolveComponentOpticModules=t=>t.flatMap(t=>n(t,o,a));

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

@@ -0,0 +1,15 @@
+import type { AnonymousExpression } from '../../../core/index.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;
+    readonly expressions: Readonly<Record<string, Readonly<Record<string, AnyAnonymousExpression>>>>;
+}
+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.
+ */
+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

@@ -0,0 +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.origin,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}})};

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

@@ -1,8 +1,7 @@
-import type { $DomainEntity, DomainEntity } from '../core/index.js';
-import type { DomainContextSystems } from '../domain-context/domain-context-systems.js';
-import type { Transformers } from '../domain-context/store-system/store-system.js';
-import { type ProjectModule } from '../project-modules/index.js';
-import type { ImportedTransformer, SpecTransformer } from './application-config.js';
+import type { ImportedTransformer, SpecTransformer } from '../../../application/index.js';
+import type { $DomainEntity, DomainEntity } from '../../../core/index.js';
+import type { DomainContextSystems, Transformers } from '../../../domain-context/index.js';
+import { type ProjectModule } from './project-modules.js';
 type AnyImportedTransformer = ImportedTransformer<any, any, any, any, any, any, any>;
 /**
  * The transformer of one `src/transformers/` file, named after the file. The spec's `transformers` section

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

@@ -0,0 +1 @@
+import{SHARED_FOLDER_HINT as r,createContractError as e,isRecord as t}from"./project-modules.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.origin,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/module-checks/resolve-invariant-modules.d.ts

@@ -0,0 +1,6 @@
+import type { Invariant } from '../../../core/index.js';
+import { type ProjectModule } from './project-modules.js';
+type AnyInvariant = Invariant<any, any, any, any, any, any, string>;
+/** Validates the `src/invariants/` files and concatenates their invariants per entity type or alias. */
+export declare const resolveInvariantModules: (modules: readonly ProjectModule[]) => Readonly<Record<string, readonly AnyInvariant[]>>;
+export {};

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

@@ -0,0 +1 @@
+import{SHARED_FOLDER_HINT as e,createContractError as t,isRecord as r}from"./project-modules.js";let o={expected:"an object of invariant lists keyed by entity type or alias",fix:`Create it with phx.domain.implementCustomInvariants({ ... }) (phx.domain.admin.implementCustomInvariants({ ... }) under src/admin/), ${e}.`},i=e=>r(e)&&"function"==typeof e.evaluate,n=e=>r(e)&&Object.values(e).every(e=>Array.isArray(e)&&e.every(i));export const resolveInvariantModules=e=>{let r={};for(let i of e){if(!n(i.exports))throw t(i.origin,o,i.exports);for(let[e,t]of Object.entries(i.exports))r[e]=[...r[e]??[],...t]}return r};

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

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

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

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

@@ -1,8 +1,9 @@
 import type { ThemeOptions } from '@mui/material';
 import type { SessionRole } from '@salsita-ai/contracts/api';
-import type { AssistantResolvedManifest, ChunksSpec, DataSpec, ElementRegistration, HandlerRegistration } from '../../application/index.js';
+import type { AssistantResolvedManifest, 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/store-system/store-system.js';
+import type { AnyCreateTransformersFactory } from '../../domain-context/index.js';
+import type { ElementRegistration, HandlerRegistration } from './module-checks/index.js';
 export interface ApplicationConfiguratorSpec {
     readonly modelVersion: number;
     readonly factory: AnyDomainFactory;

package/dist/domain/index.d.ts

@@ -11,7 +11,6 @@ export * from './sketching/index.js';
 export * from './projections/index.js';
 export * from './admin-domain/index.js';
 export * from './application/index.js';
-export { type ProjectModule, resolveActionModules, resolveExpressionModules } from './project-modules/index.js';
 export * from './scene/index.js';
 export { getAllPhxDefinitions } from './system-definitions.js';
 export { availableSystemComponents, componentsByName } from './available-system-components.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{resolveActionModules,resolveExpressionModules}from"./project-modules/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";

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

@@ -1,2 +1,2 @@
-import type { DomainRuntimeServices } from '../domain-runtime/domain-services/index.js';
+import type { DomainRuntimeServices } from '../domain-runtime/index.js';
 export declare const createMockDomainRuntimeServices: (overrides?: Partial<DomainRuntimeServices>) => DomainRuntimeServices;

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

@@ -371,7 +371,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 selectViewStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
                 selectToolStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
                 selectExportStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
-                selectCreateTransformers: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../domain-context/store-system/store-system.js").AnyCreateTransformersFactory>;
+                selectCreateTransformers: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").AnyCreateTransformersFactory>;
                 selectLatestLoadedData: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData | null>;
                 selectLoadedData: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData>;
                 selectInitialDomainState: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").DomainState<any>>;
@@ -413,7 +413,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getViewStates: () => readonly string[];
                 getToolStates: () => readonly string[];
                 getExportStates: () => readonly string[];
-                getCreateTransformers: () => import("../domain-context/store-system/store-system.js").AnyCreateTransformersFactory | undefined;
+                getCreateTransformers: () => import("../index.js").AnyCreateTransformersFactory | undefined;
                 getLoadedData: () => import("../index.js").ConfiguratorLoadedData;
                 getInitialDomainState: () => import("../index.js").DomainState<any>;
                 getFrontendData: () => Record<string, unknown>;
@@ -432,9 +432,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getSnappingProjections: () => import("../index.js").AnySnappingProjections;
                 getConstraintProjections: () => import("../index.js").AnyConstraintProjections;
                 getProjectedEntitiesProjections: () => import("../index.js").AnyProjectedEntitiesProjections;
-                getStoreSystem: () => import("../domain-context/store-system/store-system.js").AnyStoreSystem;
-                getNavigationSystem: () => import("../domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
-                getUndoSystem: () => import("../domain-context/undo-system.js").AnyUndoSystem;
+                getStoreSystem: () => import("../index.js").AnyStoreSystem;
+                getNavigationSystem: () => import("../index.js").AnyNavigationSystem;
+                getUndoSystem: () => import("../index.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("../index.js").AnyRecipeCookerSystem;
                 getActionSystem: () => import("../index.js").AnyActionSystem;
                 getBlenderProjections: () => import("../index.js").AnyBlenderProjections;
@@ -480,7 +480,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 selectViewStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
                 selectToolStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
                 selectExportStates: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, readonly string[]>;
-                selectCreateTransformers: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../domain-context/store-system/store-system.js").AnyCreateTransformersFactory>;
+                selectCreateTransformers: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, undefined> | import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").AnyCreateTransformersFactory>;
                 selectLatestLoadedData: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData | null>;
                 selectLoadedData: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").ConfiguratorLoadedData>;
                 selectInitialDomainState: import("@salsita-ai/common/utils").Selector<import("../index.js").DomainContextSelectorState, import("../index.js").DomainState<any>>;
@@ -522,7 +522,7 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getViewStates: () => readonly string[];
                 getToolStates: () => readonly string[];
                 getExportStates: () => readonly string[];
-                getCreateTransformers: () => import("../domain-context/store-system/store-system.js").AnyCreateTransformersFactory | undefined;
+                getCreateTransformers: () => import("../index.js").AnyCreateTransformersFactory | undefined;
                 getLoadedData: () => import("../index.js").ConfiguratorLoadedData;
                 getInitialDomainState: () => import("../index.js").DomainState<any>;
                 getFrontendData: () => Record<string, unknown>;
@@ -541,9 +541,9 @@ export declare const createMockDomainRuntime: <ENTITIES extends DomainEntity<str
                 getSnappingProjections: () => import("../index.js").AnySnappingProjections;
                 getConstraintProjections: () => import("../index.js").AnyConstraintProjections;
                 getProjectedEntitiesProjections: () => import("../index.js").AnyProjectedEntitiesProjections;
-                getStoreSystem: () => import("../domain-context/store-system/store-system.js").AnyStoreSystem;
-                getNavigationSystem: () => import("../domain-context/navigation-system/navigation-system.js").AnyNavigationSystem;
-                getUndoSystem: () => import("../domain-context/undo-system.js").AnyUndoSystem;
+                getStoreSystem: () => import("../index.js").AnyStoreSystem;
+                getNavigationSystem: () => import("../index.js").AnyNavigationSystem;
+                getUndoSystem: () => import("../index.js").AnyUndoSystem;
                 getRecipeCookerSystem: () => import("../index.js").AnyRecipeCookerSystem;
                 getActionSystem: () => import("../index.js").AnyActionSystem;
                 getBlenderProjections: () => import("../index.js").AnyBlenderProjections;

package/dist/domain/projections/blender-projections/blender-projections.d.ts

@@ -1,7 +1,6 @@
 import type { BlenderLight } from '@salsita-ai/contracts/webhook';
 import { type DomainEntity, type DomainState } from '../../core/index.js';
-import type { DomainContextSelectors } from '../../domain-runtime/domain-context/index.js';
-import type { DomainServicesSelectors } from '../../domain-runtime/domain-services/index.js';
+import type { DomainContextSelectors, DomainServicesSelectors } from '../../domain-runtime/index.js';
 import type { BlenderCamera, BlenderImageConfig, BlenderImageSize, BlenderSceneConfig, BlenderSceneObject, SceneEntityNode } from './types.js';
 /**
  * Constructor context of a `BlenderProjections`. It reaches its domain collaborators through the

package/dist/domain/projections/blender-projections/camera.d.ts

@@ -1,6 +1,6 @@
 import type { DomainEntity, DomainState } from '../../core/index.js';
 import type { AnyDimensionSystem } from '../../domain-context/index.js';
-import type { AnyComponentReader } from '../../domain-runtime/domain-context/index.js';
+import type { AnyComponentReader } from '../../domain-runtime/index.js';
 import type { AnyPositionProjections } from '../position-projections.js';
 import type { BlenderCamera, BlenderImageSize } from './types.js';
 export interface BlenderCameraProjectionContext {

package/dist/domain/projections/collision-projections.d.ts

@@ -1,6 +1,6 @@
 import { Matrix4, Mesh, Vector3 } from 'three';
 import { type DomainEntity, type DomainState, type EntityId } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 import { type AnyCollisionGeometrySnapshot } from '../system-components/index.js';
 /**
  * DE-9IM-style classification of the spatial relationship between two

package/dist/domain/projections/composition-projections.d.ts

@@ -1,6 +1,6 @@
 import { type Localizable } from '@salsita-ai/common/utils';
 import { type DomainEntity, type DomainEntityId, type DomainState, type EntityId, type VirtualEntityId } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 export declare class CompositionCycleError extends Error {
     constructor(entityId: DomainEntityId<string>);
 }

package/dist/domain/projections/constraint-projections.d.ts

@@ -1,5 +1,5 @@
 import type { DomainEntity, DomainState } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 import { type SpatialPredicateName } from '../system-components/index.js';
 /**
  * Constructor context of `ConstraintProjections`. It carries no `selectors` member because every

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

@@ -5,7 +5,7 @@ export { CollisionProjections, type CollisionMesh, type Collision, type SpatialR
 export { ConstraintProjections, type AnyConstraintProjections } from './constraint-projections.js';
 export { CompositionProjections, type AnyCompositionProjections, EntityCompositionNode, CompositionCycleError, EntityNotPartOfCompositionTreeError, type CompositionTreeWithIndex, } from './composition-projections.js';
 export { SnappingProjections, type AnySnapMatch, type WorldSnapPoint, type SnapMatch, type FindSnapOptions, type WorldSnapEdge, type EdgeSnapMatch, type WorldSnapPlane, type PlaneSnapMatch, type WorldSnapAxis, type AxisSnapMatch, type AnySnappingProjections, } from './snapping-projections.js';
-export { ValidationProjections, type AnyValidationProjections, type ValidationProjectionsContext, type StateValidationResult, type SystemViolation, } from './validation-projections.js';
+export { ValidationProjections, type AnyValidationProjections, type ValidationProjectionsContext, type SystemViolation, } from './validation-projections.js';
 export { findBestPointSnap, findAllPointSnaps, findBestEdgeSnap, findBestPlaneSnap, findBestAxisSnap, snapScore, extractYRotationFromMatrix, type AutoRotateContext, } from './snap-matching.js';
 export { computeWorldMatrix, computeWorldSnapPoints, computeWorldSnapEdges, computeWorldSnapPlanes, computeWorldSnapAxes, toMmBounds, } from './snap-utils.js';
 export { ProjectedEntitiesProjections, type AnyProjectedEntitiesProjections } from './projected-entities-projections.js';

package/dist/domain/projections/position-projections.d.ts

@@ -1,6 +1,6 @@
 import { Euler, Matrix4, Quaternion, Vector3 } from 'three';
 import type { DomainEntity, DomainEntityId, DomainState } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 /**
  * Override for an entity's position during an active drag or rotation.
  * This is a simplified view of the dragging state — only the fields

package/dist/domain/projections/projected-entities-projections.d.ts

@@ -1,5 +1,5 @@
 import type { DomainEntity, DomainEntityId, DomainState } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 /**
  * Constructor context of `ProjectedEntitiesProjections`. It carries no `selectors` member because
  * every registry read is transitive through collaborators that own their own registry window. A

package/dist/domain/projections/snapping-projections.d.ts

@@ -1,5 +1,5 @@
 import { type DomainEntity, type DomainState, type EntityId } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 import { type AnySnapMatch, type AxisSnapMatch, type EdgeSnapMatch, type FindSnapOptions, type PlaneSnapMatch, type SnapMatch, type WorldSnapAxis, type WorldSnapEdge, type WorldSnapPlane, type WorldSnapPoint } from './snap-matching.js';
 export type { AnySnapMatch, WorldSnapPoint, SnapMatch, FindSnapOptions, WorldSnapEdge, EdgeSnapMatch, WorldSnapPlane, PlaneSnapMatch, WorldSnapAxis, AxisSnapMatch, };
 /**

package/dist/domain/projections/validation-projections.d.ts

@@ -1,23 +1,7 @@
-import { type $DomainEntity, type DomainEntity, type DomainState, type EntityViolation, type ViolationTypesOf$Entity } from '../core/index.js';
-import type { AngleDimensionViolation, DistanceDimensionViolation, GenericDimensionViolation } from '../domain-context/dimension-system/dimension-system.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import { type $DomainEntity, type DomainEntity, type DomainState, type StateValidationResult, type ViolationTypesOf$Entity } from '../core/index.js';
+import type { AngleDimensionViolation, DistanceDimensionViolation, GenericDimensionViolation } from '../domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 export type SystemViolation = AngleDimensionViolation | DistanceDimensionViolation | GenericDimensionViolation;
-export type StateValidationResult<ENTITIES extends DomainEntity<string>, VIOLATION_TYPE extends string> = {
-    readonly valid: true;
-    readonly severity: null;
-} | {
-    readonly valid: true;
-    readonly severity: 'warning' | 'notice';
-    readonly entityViolations: ReadonlyArray<EntityViolation<ENTITIES, VIOLATION_TYPE>>;
-} | {
-    readonly valid: false;
-    readonly severity: 'uncaught';
-    readonly error: Error;
-} | {
-    readonly valid: false;
-    readonly severity: 'fatal' | 'fixable';
-    readonly entityViolations: ReadonlyArray<EntityViolation<ENTITIES, VIOLATION_TYPE>>;
-};
 /**
  * Constructor context of `ValidationProjections`. Runtime dependencies are resolved through
  * selectors on every read so a hot-reloaded spec is observed without rebuilding the projections.

package/dist/domain/sketching/sketching-projections.d.ts

@@ -1,5 +1,5 @@
 import type { DomainEntity, DomainState, EntityId } from '../core/index.js';
-import type { DomainContextSelectors } from '../domain-runtime/domain-context/index.js';
+import type { DomainContextSelectors } from '../domain-runtime/index.js';
 import { type Shape, type Sketching, type SketchingPoint } from './sketching.js';
 /**
  * Constructor context of `SketchingProjections`. It carries no `selectors` member because every

package/dist/domain/system-components/phoenix-entity-elements/admin-data-table-sidebar.d.ts

@@ -1,4 +1,4 @@
-import type { DataSchema } from '../../application/application-config.js';
+import type { DataSchema } from '../../core/index.js';
 export interface AdminDataTableSidebarSchema {
     readonly kind: 'adminDataTableSidebar';
     readonly visible?: boolean;

package/dist/domain/system-components/phoenix-layout-elements/admin-connected-resource-page.d.ts

@@ -1,4 +1,4 @@
-import type { DataCellValue, DataSchema } from '../../application/application-config.js';
+import type { DataCellValue, DataSchema } from '../../core/index.js';
 export interface AdminConnectedResourcePageSchema {
     readonly kind: 'adminConnectedResourcePage';
     readonly props: {

package/dist/domain/system-components/phoenix-layout-elements/admin-data-table-actions.d.ts

@@ -1,4 +1,4 @@
-import type { DataCellValue, DataSchema } from '../../application/application-config.js';
+import type { DataCellValue, DataSchema } from '../../core/index.js';
 export interface AdminDataTableActionsSchema {
     readonly kind: 'adminDataTableActions';
     readonly props: {

package/dist/domain/system-components/phoenix-layout-elements/admin-data-table-page.d.ts

@@ -1,4 +1,4 @@
-import type { DataCellValue, DataSchema } from '../../application/application-config.js';
+import type { DataCellValue, DataSchema } from '../../core/index.js';
 export interface AdminDataTablePageSchema {
     readonly kind: 'adminDataTablePage';
     readonly props: {

package/dist/domain/utils/memo-eval.d.ts

@@ -1,4 +1,4 @@
-import type { $DomainEntity, DomainEntity, DomainState, ExpressionContext } from '../core/index.js';
+import type { $DomainEntity, DomainEntity, DomainState, OpenExpressionContext } from '../core/index.js';
 declare const MemoizedValueSymbol: unique symbol;
 export type MemoizedArray<T extends readonly unknown[]> = {
     readonly [MemoizedValueSymbol]: 'array';
@@ -19,7 +19,7 @@ export interface MemoEval {
      * In addition to performance optimizations, this helper is useful for custom expressions that produce non-primitive
      * results and therefore break any downstream memoization.
      */
-    <ENTITIES extends DomainEntity<string>, $ENTITY extends $DomainEntity<ENTITIES>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, const DEPS extends any[], RES>(calculateDeps: (self: $ENTITY, state: DomainState<ENTITIES>, ctx: ExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>) => DEPS, evaluate: (...deps: DEPS) => RES): (self: $ENTITY, state: DomainState<ENTITIES>, ctx: ExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>) => RES;
+    <ENTITIES extends DomainEntity<string>, $ENTITY extends $DomainEntity<ENTITIES>, ALLOWED_ROOT_ENTITIES extends ENTITIES, PUBLISHED_DATA extends Record<string, unknown>, SESSION_DATA extends Record<string, unknown>, FRONTEND_DATA extends Record<string, unknown>, const DEPS extends any[], RES, CONTEXT_EXTENSION = unknown>(calculateDeps: (self: $ENTITY, state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>) => DEPS, evaluate: (...deps: DEPS) => RES): (self: $ENTITY, state: DomainState<ENTITIES>, ctx: OpenExpressionContext<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, CONTEXT_EXTENSION>) => RES;
     /**
      * Tags an array so that it is compared by contents rather than reference.
      * Use in the deps collection phase.

package/dist/legacy/domain-cli/gen/constant-expressions.js

@@ -1,4 +1,2 @@
-import{DOMAIN_SDK_MODULE as e}from"./imports.js";export const generateConstantExpressions=(t,n)=>(t.importMembers(e,"createConstantExpressionFactory"),t.importMembers(n?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),t.importMembers(n?"./admin-enhanced-model.js":"./enhanced-model.js","constants"),`export const constantExpressions = createConstantExpressionFactory<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>(
-  {}, // insert expression metas here, once ready
-)(constants)
+import{DOMAIN_SDK_MODULE as t}from"./imports.js";export const generateConstantExpressions=(n,s)=>(n.importMembers(t,"createConstantExpressionFactory"),n.importMembers(s?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),n.importMembers(s?"./admin-enhanced-model.js":"./enhanced-model.js","constants"),`export const constantExpressions = createConstantExpressionFactory<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>()(constants)
 `);

package/dist/legacy/domain-cli/gen/implementation.js

@@ -1,12 +1,8 @@
-import{generateConstantExpressions as t}from"./constant-expressions.js";import{generateDataExpressions as e}from"./data-expressions.js";import{generateDefaults as a}from"./defaults.js";import{DOMAIN_SDK_MODULE as s,Imports as n}from"./imports.js";import{generateInvariants as o}from"./invariants.js";import{generateRelations as i}from"./relations.js";export const generateImplementation=async(r,m,p,d,l)=>{let D=[],u=new n(d?"./admin-implementation.js":"./implementation.js",l);return u.importMembers("@salsita-ai/sdk/domain","AliasedExpressions","createConstantExpressionFactory","DomainComponentOpticBuilder","createCustomExpressionFactory","DomainBuilder"),u.importMembers(d?"./admin-enhanced-model.js":"./enhanced-model.js","$entityReflections","$Map"),u.importMembers(d?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity","aliases","entities","RootEntity","modelVersion"),u.importMembers("./application-types.js","PublishedData","SessionData","FrontendData"),d||u.importMembers("./application-types.js","BackendData"),D.push(i(r.relations,u,d)),D.push(t(u,d)),D.push(a(r.defaults,u,d)),D.push(o(r.invariants,p,u,d)),d?D.push(`
-  export const attachAdminComponent = DomainComponentOpticBuilder.from<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)`):D.push(`
-export const attachComponent = DomainComponentOpticBuilder.from<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)`),d?D.push(`
-export const implementAdminCustomExpressions = createCustomExpressionFactory<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(
-  {} // TODO pass in meta-data once we have them
-)`):D.push(`
-export const implementCustomExpressions = createCustomExpressionFactory<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(
-  {} // TODO pass in meta-data once we have them
-)`),D.push(e(m,d,u)),d?(u.importMembers(s,"commonAdminCustomExpressions","createMapPublishedRevisionDataHandlerFactory","createMapPublishedChunkedDataHandlerFactory"),D.push(`
+import{generateConstantExpressions as t}from"./constant-expressions.js";import{generateDataExpressions as e}from"./data-expressions.js";import{generateDefaults as n}from"./defaults.js";import{DOMAIN_SDK_MODULE as s,Imports as i}from"./imports.js";import{generateInvariants as a}from"./invariants.js";import{generateRelations as o}from"./relations.js";export const generateImplementation=async(r,m,p,d,l)=>{let u=[],D=new i(d?"./admin-implementation.js":"./implementation.js",l);return D.importMembers("@salsita-ai/sdk/domain","AliasedExpressions","createConstantExpressionFactory","DomainComponentOpticBuilder","createCustomExpressionFactory","DomainBuilder","RuntimeExpressionContext"),D.importMembers(d?"./admin-enhanced-model.js":"./enhanced-model.js","$entityReflections","$Map"),D.importMembers(d?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity","aliases","entities","RootEntity","modelVersion"),D.importMembers("./application-types.js","PublishedData","SessionData","FrontendData"),d||D.importMembers("./application-types.js","BackendData"),u.push(o(r.relations,D,d)),u.push(t(D,d)),u.push(n(r.defaults,D,d)),u.push(a(r.invariants,p,D,d)),d?u.push(`
+  export const attachAdminComponent = DomainComponentOpticBuilder.from<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases, RuntimeExpressionContext<AnyDomainEntity>>(aliases)`):u.push(`
+export const attachComponent = DomainComponentOpticBuilder.from<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases, RuntimeExpressionContext<AnyDomainEntity>>(aliases)`),d?u.push(`
+export const implementAdminCustomExpressions = createCustomExpressionFactory<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases, RuntimeExpressionContext<AnyDomainEntity>>()`):u.push(`
+export const implementCustomExpressions = createCustomExpressionFactory<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases, RuntimeExpressionContext<AnyDomainEntity>>()`),u.push(e(m,d,D)),d?(D.importMembers(s,"commonAdminCustomExpressions","createMapPublishedRevisionDataHandlerFactory","createMapPublishedChunkedDataHandlerFactory"),u.push(`
 export const createMapPublishedRevisionDataHandler = createMapPublishedRevisionDataHandlerFactory<
   AnyDomainEntity,
   RootEntity,
@@ -36,7 +32,7 @@ export const adminDomainBuilder = DomainBuilder.from<AnyDomainEntity, RootEntity
 )
   .withExpressions(constantExpressions)
   .withExpressions(relationExpressions)
-  .withExpressions(implementAdminCustomExpressions(commonAdminCustomExpressions))`)):D.push(`
+  .withExpressions(implementAdminCustomExpressions(commonAdminCustomExpressions))`)):u.push(`
       export const domainBuilder = DomainBuilder.from<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(
         entities,
         aliases,
@@ -51,4 +47,4 @@ export const adminDomainBuilder = DomainBuilder.from<AnyDomainEntity, RootEntity
       )
         .withExpressions(constantExpressions)
         .withExpressions(relationExpressions)
-        .withExpressions(dataExpressions)`),{modulePath:u.targetModule,content:["/* eslint-disable */",u.toString(),...D].join("\n")}};
+        .withExpressions(dataExpressions)`),{modulePath:D.targetModule,content:["/* eslint-disable */",D.toString(),...u].join("\n")}};

package/dist/legacy/domain-cli/gen/invariants.js

@@ -6,7 +6,8 @@ import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAnd
       SessionData,
       FrontendData,
       Aliases,
-      CustomInvariantBlueprints
+      CustomInvariantBlueprints,
+      RuntimeExpressionContext<AnyDomainEntity>
     >()(staticViolations)
     `):o.push(`export const implementCustomInvariants = createCustomInvariantFactory<
   AnyDomainEntity,
@@ -16,7 +17,8 @@ import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAnd
   SessionData,
   FrontendData,
   Aliases,
-  CustomInvariantBlueprints
+  CustomInvariantBlueprints,
+  RuntimeExpressionContext<AnyDomainEntity>
 >()(staticViolations)
-`),e.importMembers(t,"createCustomInvariantFactory"),e.importMembers(s?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),e.importMembers(s?"./admin-enhanced-model.js":"./enhanced-model.js","$Map"),s?(e.importMembers(t,"commonAdminViolationExpressions"),o.push(`export const adminInvariantBuilder = new InvariantBuilder<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)
+`),e.importMembers(t,"createCustomInvariantFactory","RuntimeExpressionContext"),e.importMembers(s?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),e.importMembers(s?"./admin-enhanced-model.js":"./enhanced-model.js","$Map"),s?(e.importMembers(t,"commonAdminViolationExpressions"),o.push(`export const adminInvariantBuilder = new InvariantBuilder<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)
         .withInvariants(implementCustomAdminInvariants(commonAdminViolationExpressions))`)):o.push("export const invariantBuilder = new InvariantBuilder<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)"),e.importMembers(t,"InvariantBuilder"),o.join("\n")};

package/dist/legacy/domain-cli/utils/cache.d.ts

@@ -1,3 +1,3 @@
-export declare const cacheVersion = 759;
+export declare const cacheVersion = 761;
 export declare const needsRebuild: (fileContents: string[], outputDirectory: string) => Promise<boolean>;
 export declare const writeCacheInfo: (fileContents: string[], outputDirectory: string) => Promise<void>;

package/dist/legacy/domain-cli/utils/cache.js

@@ -1 +1 @@
-import{createHash as e}from"crypto";import{existsSync as r}from"fs";import{readFile as t}from"fs/promises";import{isEqualArray as o}from"@salsita-ai/common/utils";import{writeFormatted as i}from"../gen/write-formatted.js";export const cacheVersion=759;let s=r=>({version:759,files:r.map(r=>e("md5").update(r).digest("base64")).sort()});export const needsRebuild=async(e,i)=>{let a=`${i}/cache.json`;if(!r(a))return!0;try{let r=JSON.parse(await t(a,"utf-8")),i=s(e);return 759!==r.version||!o(r.files,i.files)}catch(e){return console.error("Failed to read cache file, forcing rebuild",e),!0}};export const writeCacheInfo=async(e,r)=>{let t=`${r}/cache.json`,o=s(e);await i(t,JSON.stringify(o,null,2))};
+import{createHash as e}from"crypto";import{existsSync as r}from"fs";import{readFile as t}from"fs/promises";import{isEqualArray as o}from"@salsita-ai/common/utils";import{writeFormatted as i}from"../gen/write-formatted.js";export const cacheVersion=761;let s=r=>({version:761,files:r.map(r=>e("md5").update(r).digest("base64")).sort()});export const needsRebuild=async(e,i)=>{let a=`${i}/cache.json`;if(!r(a))return!0;try{let r=JSON.parse(await t(a,"utf-8")),i=s(e);return 761!==r.version||!o(r.files,i.files)}catch(e){return console.error("Failed to read cache file, forcing rebuild",e),!0}};export const writeCacheInfo=async(e,r)=>{let t=`${r}/cache.json`,o=s(e);await i(t,JSON.stringify(o,null,2))};

package/dist/legacy/phoenix-cli/project-gen/generators/file-templates/agents/claude-md.d.ts

@@ -1,2 +1,2 @@
 export declare const mergeClaudeMdContent: (existingContent: string | undefined) => string;
-export declare const claudeMdFile = "[PHOENIX-SDK-START]\n## Phoenix Configurator Project\n\nDeclarative 3D product configurator built with Phoenix SDK. Domain model defined in YAML, custom logic in TypeScript.\n\n## Build Commands\n- `pnpm phoenix build` \u2014 Full production build\n- `pnpm phoenix dev` \u2014 Development mode with hot reload\n- `pnpm phoenix sync` \u2014 Sync generated files without full build\n\n## Dev Logs\n- `pnpm phoenix dev` writes all logs to `.phoenix/phoenix-dev.log`\n- Contains: spec parse errors, build errors, browser runtime errors, file watcher events\n- After making changes, always check the log for errors: `tail -50 .phoenix/phoenix-dev.log` or `grep ERROR .phoenix/phoenix-dev.log`\n- Rotated automatically at 10MB (`.log.1`, `.log.2` are older rotations)\n\n## Project Structure\n- `spec/` \u2014 Domain YAML specs (entities, relations, expressions, invariants, components, application config)\n- `src/expressions/` \u2014 Computed/derived entity properties (`phx.domain.implementCustomExpressions()`)\n- `src/invariants/` \u2014 Business rule constraints (`phx.domain.implementCustomInvariants()`)\n- `src/transformers/` \u2014 Automatic state fixers (`phx.frontend.transformerBuilder`)\n- `src/components/` \u2014 ECS system components (`phx.domain.attachComponent.withEntity()`)\n- `src/elements/` \u2014 Page-level React components (`phx.frontend.createCustomPhoenixLayoutElement()`)\n- `src/handlers/` \u2014 Event & lifecycle handlers\n- `src/webhooks/` \u2014 Server-side webhook handlers (`phx.webhooks.*Builder`)\n- `src/migrations/` \u2014 Schema version migrations (v*.ts)\n- `src/locales/` \u2014 Locale catalogs (authored .po sources; compiled .ts, do not edit)\n- `src/admin/` \u2014 Admin interface (mirrors main src/ structure)\n- `src/_shared/` \u2014 Shared utilities (NOT auto-imported, requires explicit imports)\n- `.phoenix/` \u2014 Auto-generated files (DO NOT EDIT)\n- `public/` \u2014 Static assets (3D models, textures, images, HDRI maps, fonts)\n- `assets/` \u2014 Uploadable resources (PDF templates, email assets)\n\n## Architecture Principles\n- YAML-first: 99% of configuration in spec/*.yaml, custom code is last resort\n- ECS pattern: entities (domain objects) + components (behavior/UI) + systems (SDK runtime)\n- Reactive state: immutable domain state flows through RxJS pipelines\n- Data binding: `$read` (read-only), `$write` (write-only), `$bind` (bidirectional) connect components to domain\n- memoEval: all component implementations must use memoEval for stable object references\n\n## Key Patterns\n- Expressions = computed properties on entities (prefix: `$`), implemented per-entity in src/expressions/\n- Invariants = validation rules returning violations, static or dynamic\n- Transformers = auto-fixers maintaining consistency after state changes\n- Components defined in YAML with `$read`/`$bind` bindings, or custom in src/components/ using attachComponent builder\n- Webhooks = server-side finalization tasks (PDF, email, CSV, image rendering)\n- Filters = contextual component activation via navigationStates, viewStates, modes, selectedEntityIds\n\n## File Conventions\n- Components: PascalCase (.tsx)\n- Utilities: kebab-case (.ts)\n- Expressions: entity-name.ts\n- Migrations: v*.ts (sequential)\n- Specs: kebab-case.yaml\n- Underscore folders (_shared/, _utils/) are NOT auto-imported\n\n## Export Rules\nAll files in src/expressions/, src/invariants/, src/transformers/, src/components/, src/handlers/, src/webhooks/ MUST use default exports. Can be a single item or an array. Named exports are ignored by the SDK auto-import system.\n\n## Webhook Membership\n- User-authored components, admin components, and handlers are frontend-only by default.\n- A handler that registers `createMapPublishedRevisionDataHandler`, `createMapPublishedChunkedDataHandler`, `createDataRowValidatorHandler`, or `createSheetValidatorHandler` is included in the webhook automatically.\n- To include another component or handler in the webhook, put `'use webhook'` as its first statement (leading comments are allowed).\n- A webhook-included file and its runtime local-import closure must not import browser SDK entrypoints (`application`, `admin`, `configurator`, `editor`, `react`, `ui`) or style/font/image assets. Spec parsing reports the unsafe import and inclusion reason as a diagnostic.\n- Keep browser rendering in an unpinned file. Move shared server-safe logic into a separate module when both frontend and webhook code need it.\n\n## Do Not Edit\n- `.phoenix/` directory \u2014 completely regenerated on each build\n- `tsconfig.json`, `eslint.config.js`, `prettier.config.js`, `.prettierignore`, `.linguirc`, `.nvmrc`\n- `src/locales/` .ts files \u2014 compiled from .po files\n\n## Code Review\nUse `/review` command to review code changes before committing.\n\n## SDK Documentation\n\nAlways search SDK docs for relevant examples before implementing Phoenix features.\n\n### Commands\n- `pnpm phoenix docs` \u2014 Full documentation index with descriptions\n- `pnpm phoenix docs -s <term>` \u2014 Search all doc content and metadata (case-insensitive)\n- `pnpm phoenix docs --dir` \u2014 Print the absolute docs directory for grep or ripgrep\n- `pnpm phoenix docs -r <path>` \u2014 Read specific doc (raw text to stdout)\n- `pnpm phoenix docs -c <category>` \u2014 List docs in a category\n- `pnpm phoenix docs -l` \u2014 List all doc paths with titles\n\n### 3D Asset Inspection\n\nRun `pnpm phoenix inspect:assets` to discover all glTF/GLB files in `public/` and get a summary table. Use `--file <path>` for detailed single-file inspection.\n\n**When to use:** before writing YAML/code that references objectName, materialsToOverride, morphTargetInfluences, or object positioning.\n\n**What it shows per node:**\n- Name, type (Mesh/Light/Camera/Empty), children\n- Transform: `pos=`, `rot=`, `scale=` (only non-default values shown)\n- Per-node morph targets: `morphs=Width,Height`\n- Bounding box: `bounds=WxHxD` (width x height x depth in meters)\n- Origin placement: `origin=center`, `bottom-center`, `top-center`, `bottom-corner`, etc. with numerical offset\n\n**Use cases:**\n- Find exact node names for `objectName` in scene entity components\n- Find material names for `materialsToOverride`\n- Find morph target names for `morphTargetInfluences`\n- Check model dimensions (bounds) for positioning, dimension indicators, or invariants\n- Check origin placement to understand how models anchor (center vs bottom-center)\n- Use `--json` for programmatic access to all data\n\n**Flags:** `--objects`, `--materials`, `--morphs`, `--animations`, `--json`\n\n### Screenshot CLI\n\nCapture 3D canvas screenshots from a running dev server via `pnpm phoenix screenshot`.\n\n**Prerequisites:**\n1. `phoenix dev` must be running (starts the WebSocket server on port 3020)\n2. Configurator must be open in a browser (the browser does the actual rendering)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (default: `./screenshot.png`)\n- `--width, -w` \u2014 Width in pixels (default: 1920)\n- `--height` \u2014 Height in pixels (default: 1080)\n- `--format, -f` \u2014 Image format: PNG or JPEG (default: PNG)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Example workflow:**\n1. Start dev server: `pnpm phoenix dev`\n2. Open configurator in browser (or via Playwright MCP)\n3. Take screenshot: `pnpm phoenix screenshot -o ./render.png -w 2560 --height 1440`\n\n**Use cases:** visual regression testing, generating product images, debugging 3D renders\n\n### Inspect: State\n\nGet the current editor runtime state as JSON via `pnpm phoenix inspect:state`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--sections, -s` \u2014 Comma-separated: entities, navigation, validation (default: all)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Example:** `pnpm phoenix inspect:state -o ./state.json -s entities,navigation`\n\n**Lifecycle status:** Always included in response. Shows which systems are ready:\n- `domainLoaded` \u2014 domain data loaded\n- `domainContextReady` \u2014 domain context initialized (entities available)\n- `configuratorReady` \u2014 3D configurator initialized\n- `sessionAuthenticated` \u2014 session service active\n- `editorMode` \u2014 editor mode enabled\n\n**Tips:** Use `--sections` to limit payload size. Pipe through `head`/`tail` for partial output (e.g., `pnpm phoenix inspect:state | head -50`).\n\n**Use cases:** AI agent context, debugging entity state, inspecting navigation/validation\n\n### Inspect: Data\n\nGet the current editor context data as JSON via `pnpm phoenix inspect:data`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Returns:** publishedData, frontendData, backendData, sessionData, accessData, webComponentProperties\n\n**Example:** `pnpm phoenix inspect:data -o ./data.json`\n\n**Tips:** Pipe through `head`/`tail` for partial output (e.g., `pnpm phoenix inspect:data | head -30`).\n\n**Use cases:** AI agent context, debugging published/session/access data\n\n### Inspect: Scene\n\nGet the current Three.js scene graph as JSON via `pnpm phoenix inspect:scene`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Returns:** Recursive scene tree with per-node: name, type, visible, position, rotation, scale, userData (entityId), and for meshes: geometry name, bounding box, material properties (color, metalness, roughness, opacity, textures), morph target influences. Lights include color, intensity, and type-specific properties.\n\n**Example:** `pnpm phoenix inspect:scene -o ./scene.json`\n\n**Tips:** Scene graphs can be large. Pipe through `head`/`tail` for partial output.\n\n**Use cases:** AI agent context, debugging 3D scene layout, inspecting materials and lighting\n\n### Key Docs\n- `docs/phoenix/getting-started.mdx` \u2014 Setup, prerequisites, first project\n- `docs/phoenix/quickstart.mdx` \u2014 End-to-end tutorial building a configurator\n- `docs/phoenix/domain-model.mdx` \u2014 Entities, attributes, relations, specs\n- `docs/phoenix/components.mdx` \u2014 ECS pattern, YAML components, custom components\n- `docs/phoenix/project-structure.mdx` \u2014 Files, folders, conventions\n- `docs/phoenix/best-practices.mdx` \u2014 YAML-first, code patterns, common pitfalls\n- `docs/phoenix/state-management.mdx` \u2014 Reactive state, RxJS pipelines, data flow\n- `docs/phoenix/expression-context.mdx` \u2014 Expression API, context object, helpers\n- `docs/phoenix/webhooks.mdx` \u2014 Server-side finalization workflows\n- `docs/phoenix/finalization.mdx` \u2014 Finalization system, PDF/email/CSV generation\n- `docs/phoenix/migrations.mdx` \u2014 Schema versioning, migration files\n\n### Agent Workflow\n1. Find relevant docs by content: `pnpm phoenix docs -s \"camera\"`\n2. Read matching doc: `pnpm phoenix docs -r docs/3d-scene/cameras/transitions.mdx`\n3. Search within a doc: `pnpm phoenix docs -r <path> | grep \"example\"`\n4. Search titles only as a fallback: `pnpm phoenix docs -l | grep \"camera\"`\n5. Search generated files directly when needed: `grep -rn \"camera\" \"$(pnpm phoenix docs --dir)\"`\n6. Browse a topic area: `pnpm phoenix docs -c \"Layouts\"`\n\n### Playwright MCP Setup (for AI agents)\n\nTo interact with the 3D configurator in a browser, Playwright MCP needs GPU-enabled flags for WebGL rendering. Add to `~/.claude/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@playwright/mcp@latest\",\n        \"--headed\",\n        \"--launch-options\",\n        \"{\\\"args\\\":[\\\"--use-gl=swiftshader\\\",\\\"--enable-webgl\\\",\\\"--ignore-gpu-blocklist\\\"]}\"\n      ]\n    }\n  }\n}\n```\n\nKey flags:\n- `--headed` \u2014 visible browser (required for GPU rendering)\n- `--use-gl=swiftshader` \u2014 software GPU fallback for environments without a physical GPU\n- `--enable-webgl` + `--ignore-gpu-blocklist` \u2014 ensure WebGL is available\n[PHOENIX-SDK-END]\n";
+export declare const claudeMdFile = "[PHOENIX-SDK-START]\n## Phoenix Configurator Project\n\nDeclarative 3D product configurator built with Phoenix SDK. Domain model defined in YAML, custom logic in TypeScript.\n\n## Build Commands\n- `pnpm phoenix build` \u2014 Full production build\n- `pnpm phoenix dev` \u2014 Development mode with hot reload\n- `pnpm phoenix sync` \u2014 Sync generated files without full build\n\n## Dev Logs\n- `pnpm phoenix dev` writes all logs to `.phoenix/phoenix-dev.log`\n- Contains: spec parse errors, build errors, browser runtime errors, file watcher events\n- After making changes, always check the log for errors: `tail -50 .phoenix/phoenix-dev.log` or `grep ERROR .phoenix/phoenix-dev.log`\n- Rotated automatically at 10MB (`.log.1`, `.log.2` are older rotations)\n\n## Project Structure\n- `spec/` \u2014 Domain YAML specs (entities, relations, expressions, invariants, components, application config)\n- `src/expressions/` \u2014 Computed/derived entity properties (`phx.domain.implementCustomExpressions()`)\n- `src/invariants/` \u2014 Business rule constraints (`phx.domain.implementCustomInvariants()`)\n- `src/transformers/` \u2014 Automatic state fixers (`phx.frontend.transformerBuilder`)\n- `src/components/` \u2014 ECS system components (`phx.domain.attachComponent.withEntity()`)\n- `src/elements/` \u2014 Page-level React components (`phx.frontend.createCustomPhoenixLayoutElement()`)\n  - A layout element named `ConfiguratorLayout` replaces everything the built-in layout renders for a loaded configuration, the finalize page included, so prefer arranging the layout in the spec; when you register it, mount `LayoutSlots.SharedCanvas` (from `@salsita-ai/sdk/configurator`) in it, or the app loader stays on screen\n- `src/handlers/` \u2014 Event & lifecycle handlers\n- `src/webhooks/` \u2014 Server-side webhook handlers (`phx.webhooks.*Builder`)\n- `src/migrations/` \u2014 Schema version migrations (v*.ts)\n- `src/locales/` \u2014 Locale catalogs (authored .po sources; compiled .ts, do not edit)\n- `src/admin/` \u2014 Admin interface (mirrors main src/ structure)\n- `src/_shared/` \u2014 Shared utilities (NOT auto-imported, requires explicit imports)\n- `.phoenix/` \u2014 Auto-generated files (DO NOT EDIT)\n- `public/` \u2014 Static assets (3D models, textures, images, HDRI maps, fonts)\n- `assets/` \u2014 Uploadable resources (PDF templates, email assets)\n\n## Architecture Principles\n- YAML-first: 99% of configuration in spec/*.yaml, custom code is last resort\n- ECS pattern: entities (domain objects) + components (behavior/UI) + systems (SDK runtime)\n- Reactive state: immutable domain state flows through RxJS pipelines\n- Data binding: `$read` (read-only), `$write` (write-only), `$bind` (bidirectional) connect components to domain\n- memoEval: all component implementations must use memoEval for stable object references\n\n## Key Patterns\n- Expressions = computed properties on entities (prefix: `$`), implemented per-entity in src/expressions/\n- Invariants = validation rules returning violations, static or dynamic\n- Transformers = auto-fixers maintaining consistency after state changes\n- Components defined in YAML with `$read`/`$bind` bindings, or custom in src/components/ using attachComponent builder\n- Webhooks = server-side finalization tasks (PDF, email, CSV, image rendering)\n- Filters = contextual component activation via navigationStates, viewStates, modes, selectedEntityIds\n\n## File Conventions\n- Components: PascalCase (.tsx)\n- Utilities: kebab-case (.ts)\n- Expressions: entity-name.ts\n- Migrations: v*.ts (sequential)\n- Specs: kebab-case.yaml\n- Underscore folders (_shared/, _utils/) are NOT auto-imported\n\n## Export Rules\nAll files in src/expressions/, src/invariants/, src/transformers/, src/components/, src/handlers/, src/webhooks/ MUST use default exports. Can be a single item or an array. Named exports are ignored by the SDK auto-import system.\n\n## Webhook Membership\n- User-authored components, admin components, and handlers are frontend-only by default.\n- A handler that registers `createMapPublishedRevisionDataHandler`, `createMapPublishedChunkedDataHandler`, `createDataRowValidatorHandler`, or `createSheetValidatorHandler` is included in the webhook automatically.\n- To include another component or handler in the webhook, put `'use webhook'` as its first statement (leading comments are allowed).\n- A webhook-included file and its runtime local-import closure must not import browser SDK entrypoints (`application`, `admin`, `configurator`, `editor`, `react`, `ui`) or style/font/image assets. Spec parsing reports the unsafe import and inclusion reason as a diagnostic.\n- Keep browser rendering in an unpinned file. Move shared server-safe logic into a separate module when both frontend and webhook code need it.\n\n## Do Not Edit\n- `.phoenix/` directory \u2014 completely regenerated on each build\n- `tsconfig.json`, `eslint.config.js`, `prettier.config.js`, `.prettierignore`, `.linguirc`, `.nvmrc`\n- `src/locales/` .ts files \u2014 compiled from .po files\n\n## Code Review\nUse `/review` command to review code changes before committing.\n\n## SDK Documentation\n\nAlways search SDK docs for relevant examples before implementing Phoenix features.\n\n### Commands\n- `pnpm phoenix docs` \u2014 Full documentation index with descriptions\n- `pnpm phoenix docs -s <term>` \u2014 Search all doc content and metadata (case-insensitive)\n- `pnpm phoenix docs --dir` \u2014 Print the absolute docs directory for grep or ripgrep\n- `pnpm phoenix docs -r <path>` \u2014 Read specific doc (raw text to stdout)\n- `pnpm phoenix docs -c <category>` \u2014 List docs in a category\n- `pnpm phoenix docs -l` \u2014 List all doc paths with titles\n\n### 3D Asset Inspection\n\nRun `pnpm phoenix inspect:assets` to discover all glTF/GLB files in `public/` and get a summary table. Use `--file <path>` for detailed single-file inspection.\n\n**When to use:** before writing YAML/code that references objectName, materialsToOverride, morphTargetInfluences, or object positioning.\n\n**What it shows per node:**\n- Name, type (Mesh/Light/Camera/Empty), children\n- Transform: `pos=`, `rot=`, `scale=` (only non-default values shown)\n- Per-node morph targets: `morphs=Width,Height`\n- Bounding box: `bounds=WxHxD` (width x height x depth in meters)\n- Origin placement: `origin=center`, `bottom-center`, `top-center`, `bottom-corner`, etc. with numerical offset\n\n**Use cases:**\n- Find exact node names for `objectName` in scene entity components\n- Find material names for `materialsToOverride`\n- Find morph target names for `morphTargetInfluences`\n- Check model dimensions (bounds) for positioning, dimension indicators, or invariants\n- Check origin placement to understand how models anchor (center vs bottom-center)\n- Use `--json` for programmatic access to all data\n\n**Flags:** `--objects`, `--materials`, `--morphs`, `--animations`, `--json`\n\n### Screenshot CLI\n\nCapture 3D canvas screenshots from a running dev server via `pnpm phoenix screenshot`.\n\n**Prerequisites:**\n1. `phoenix dev` must be running (starts the WebSocket server on port 3020)\n2. Configurator must be open in a browser (the browser does the actual rendering)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (default: `./screenshot.png`)\n- `--width, -w` \u2014 Width in pixels (default: 1920)\n- `--height` \u2014 Height in pixels (default: 1080)\n- `--format, -f` \u2014 Image format: PNG or JPEG (default: PNG)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Example workflow:**\n1. Start dev server: `pnpm phoenix dev`\n2. Open configurator in browser (or via Playwright MCP)\n3. Take screenshot: `pnpm phoenix screenshot -o ./render.png -w 2560 --height 1440`\n\n**Use cases:** visual regression testing, generating product images, debugging 3D renders\n\n### Inspect: State\n\nGet the current editor runtime state as JSON via `pnpm phoenix inspect:state`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--sections, -s` \u2014 Comma-separated: entities, navigation, validation (default: all)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Example:** `pnpm phoenix inspect:state -o ./state.json -s entities,navigation`\n\n**Lifecycle status:** Always included in response. Shows which systems are ready:\n- `domainLoaded` \u2014 domain data loaded\n- `domainContextReady` \u2014 domain context initialized (entities available)\n- `configuratorReady` \u2014 3D configurator initialized\n- `sessionAuthenticated` \u2014 session service active\n- `editorMode` \u2014 editor mode enabled\n\n**Tips:** Use `--sections` to limit payload size. Pipe through `head`/`tail` for partial output (e.g., `pnpm phoenix inspect:state | head -50`).\n\n**Use cases:** AI agent context, debugging entity state, inspecting navigation/validation\n\n### Inspect: Data\n\nGet the current editor context data as JSON via `pnpm phoenix inspect:data`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Returns:** publishedData, frontendData, backendData, sessionData, accessData, webComponentProperties\n\n**Example:** `pnpm phoenix inspect:data -o ./data.json`\n\n**Tips:** Pipe through `head`/`tail` for partial output (e.g., `pnpm phoenix inspect:data | head -30`).\n\n**Use cases:** AI agent context, debugging published/session/access data\n\n### Inspect: Scene\n\nGet the current Three.js scene graph as JSON via `pnpm phoenix inspect:scene`.\n\n**Prerequisites:** same as screenshot (dev server running + browser open)\n\n**Options:**\n- `--output, -o` \u2014 Output file path (prints to stdout if omitted)\n- `--pretty` \u2014 Pretty-print JSON (default: true)\n- `--port` \u2014 WebSocket server port (default: 3020)\n\n**Returns:** Recursive scene tree with per-node: name, type, visible, position, rotation, scale, userData (entityId), and for meshes: geometry name, bounding box, material properties (color, metalness, roughness, opacity, textures), morph target influences. Lights include color, intensity, and type-specific properties.\n\n**Example:** `pnpm phoenix inspect:scene -o ./scene.json`\n\n**Tips:** Scene graphs can be large. Pipe through `head`/`tail` for partial output.\n\n**Use cases:** AI agent context, debugging 3D scene layout, inspecting materials and lighting\n\n### Key Docs\n- `docs/phoenix/getting-started.mdx` \u2014 Setup, prerequisites, first project\n- `docs/phoenix/quickstart.mdx` \u2014 End-to-end tutorial building a configurator\n- `docs/phoenix/domain-model.mdx` \u2014 Entities, attributes, relations, specs\n- `docs/phoenix/components.mdx` \u2014 ECS pattern, YAML components, custom components\n- `docs/phoenix/project-structure.mdx` \u2014 Files, folders, conventions\n- `docs/phoenix/best-practices.mdx` \u2014 YAML-first, code patterns, common pitfalls\n- `docs/phoenix/state-management.mdx` \u2014 Reactive state, RxJS pipelines, data flow\n- `docs/phoenix/expression-context.mdx` \u2014 Expression API, context object, helpers\n- `docs/phoenix/webhooks.mdx` \u2014 Server-side finalization workflows\n- `docs/phoenix/finalization.mdx` \u2014 Finalization system, PDF/email/CSV generation\n- `docs/phoenix/migrations.mdx` \u2014 Schema versioning, migration files\n\n### Agent Workflow\n1. Find relevant docs by content: `pnpm phoenix docs -s \"camera\"`\n2. Read matching doc: `pnpm phoenix docs -r docs/3d-scene/cameras/transitions.mdx`\n3. Search within a doc: `pnpm phoenix docs -r <path> | grep \"example\"`\n4. Search titles only as a fallback: `pnpm phoenix docs -l | grep \"camera\"`\n5. Search generated files directly when needed: `grep -rn \"camera\" \"$(pnpm phoenix docs --dir)\"`\n6. Browse a topic area: `pnpm phoenix docs -c \"Layouts\"`\n\n### Playwright MCP Setup (for AI agents)\n\nTo interact with the 3D configurator in a browser, Playwright MCP needs GPU-enabled flags for WebGL rendering. Add to `~/.claude/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@playwright/mcp@latest\",\n        \"--headed\",\n        \"--launch-options\",\n        \"{\\\"args\\\":[\\\"--use-gl=swiftshader\\\",\\\"--enable-webgl\\\",\\\"--ignore-gpu-blocklist\\\"]}\"\n      ]\n    }\n  }\n}\n```\n\nKey flags:\n- `--headed` \u2014 visible browser (required for GPU rendering)\n- `--use-gl=swiftshader` \u2014 software GPU fallback for environments without a physical GPU\n- `--enable-webgl` + `--ignore-gpu-blocklist` \u2014 ensure WebGL is available\n[PHOENIX-SDK-END]\n";