@salsita-ai/sdk 0.50.0-develop.ae9a830ef0 → 0.50.0-develop.afbc5157e1

package/dist/legacy/domain-spec/__generated/domain-schema.d.ts

@@ -3549,20 +3549,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3590,20 +3590,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3641,20 +3641,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3684,20 +3684,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3707,6 +3707,8 @@ export interface DomainSpecification {
                     showWhen?: ('selected' | 'unselected')[] | ReadEnhancement;
                     title?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                     tooltipVisibility?: ('on-hover' | 'forced' | 'forced-when-still' | 'hidden') | ReadEnhancement;
+                    hiddenViolations?: string[] | ReadEnhancement;
+                    label?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                     icon?: EnhancedStringRead;
                     $filter?: ComponentSystemFilter;
                 } | {
@@ -3722,20 +3724,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3759,20 +3761,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -3799,20 +3801,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -4539,9 +4541,8 @@ export interface DomainSpecification {
                             id: string | ReadEnhancement;
                             [k: string]: unknown;
                         }[] | ReadEnhancement;
-                        keepChildren?: EnhancedBooleanRead;
-                        [k: string]: unknown;
                     }[] | ReadEnhancement;
+                    keepChildren?: EnhancedBooleanRead;
                     $filter?: ComponentSystemFilter;
                 } | {
                     $read: string;
@@ -4723,20 +4724,20 @@ export interface DomainSpecification {
                     screenSized?: EnhancedBooleanRead;
                     angleUnit?: ('degree' | 'radian') | ReadEnhancement;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -4815,20 +4816,20 @@ export interface DomainSpecification {
                     labelPrefix?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                     labelPrefixFontColor?: (string | number) | ReadEnhancement;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -4973,20 +4974,20 @@ export interface DomainSpecification {
                         }) | ReadEnhancement;
                     } | ReadEnhancement;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -5065,20 +5066,20 @@ export interface DomainSpecification {
                     labelPrefix?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                     labelPrefixFontColor?: (string | number) | ReadEnhancement;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -5157,20 +5158,20 @@ export interface DomainSpecification {
                     labelPrefix?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                     labelPrefixFontColor?: (string | number) | ReadEnhancement;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -5197,20 +5198,20 @@ export interface DomainSpecification {
                     screenOffsetHorizontal?: EnhancedNumberRead;
                     screenOffsetVertical?: EnhancedNumberRead;
                     azimuthAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     polarAngleLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
                     distanceLimits?: {
-                        min?: EnhancedNumberRead;
-                        max?: EnhancedNumberRead;
+                        min: EnhancedNumberRead;
+                        max: EnhancedNumberRead;
                         smoothZone?: EnhancedNumberRead;
                         minOpacity?: EnhancedNumberRead;
                     } | ReadEnhancement;
@@ -5286,6 +5287,22 @@ export interface DomainSpecification {
                     $filter?: ComponentSystemFilter;
                 };
             };
+            agentScreenshot?: {
+                [k: string]: {
+                    exportState: EnhancedStringRead;
+                    width: number | ReadEnhancement;
+                    height: number | ReadEnhancement;
+                    fileFormat: ('PNG' | 'JPEG') | ReadEnhancement;
+                    backgroundColor?: string | ReadEnhancement;
+                    toolState: EnhancedStringRead;
+                    viewState: EnhancedStringRead;
+                    navigationState: EnhancedStringRead;
+                    $filter?: ComponentSystemFilter;
+                } | {
+                    $read: string;
+                    $filter?: ComponentSystemFilter;
+                };
+            };
             projectedEntities?: {
                 [k: string]: {
                     blueprints: {

package/dist/legacy/domain-spec/spec/domain-spec.js

@@ -1 +1 @@
-import{dereference as e}from"@apidevtools/json-schema-ref-parser";import t from"lodash-es/cloneDeep.js";import r from"lodash-es/isEqual.js";import{P as i,match as n}from"ts-pattern";import{ComponentSystemFilterSchema as o,availableSystemComponents as a,getAllPhxDefinitions as s,getExtendedSchemaValidator as d}from"#package/domain";import{domainSpecTemplate as f,requiredSpecs as p}from"./domain-spec-template.js";let m={anyOf:[{$ref:"#/definitions/Read"},{$ref:"#/definitions/ImportRef"},{$ref:"#/definitions/CodeRef"},{$ref:"#/definitions/DataRef"},{$ref:"#/definitions/Eval"}]},c={anyOf:[{$ref:"#/definitions/ReadWrite"},{$ref:"#/definitions/ImportRef"},{$ref:"#/definitions/CodeRef"}]},l=[{readName:"EnhancedStringRead",readWriteName:"EnhancedStringReadWrite",schema:{type:"string"}},{readName:"EnhancedNumberRead",readWriteName:"EnhancedNumberReadWrite",schema:{type:"number"}},{readName:"EnhancedBooleanRead",readWriteName:"EnhancedBooleanReadWrite",schema:{type:"boolean"}}],h=(e,t)=>({anyOf:[$(e,[]),t?{$ref:"#/definitions/ReadWriteEnhancement"}:{$ref:"#/definitions/ReadEnhancement"}]}),y=(e,t)=>{let i=l.find(t=>r(e,t.schema));return i?{$ref:`#/definitions/${t?i.readWriteName:i.readName}`}:h(e,t)},$=(e,t)=>({...e,...n(e).with({type:"object",properties:i.not(i.nullish).select()},e=>({properties:Object.fromEntries(Object.entries(e).map(([e,r])=>[e,y(r,t.includes(e))]))})).with({type:"object",additionalProperties:i.not(i.nullish.or(i.boolean)).select()},e=>({additionalProperties:y(e,!1)})).with({type:"object",patternProperties:i.not(i.nullish).select()},e=>({patternProperties:Object.fromEntries(Object.entries(e).map(([e,t])=>[e,y(t,!1)]))})).with({type:"array",items:i.not(i.nullish).select()},e=>({items:$(e,[])})).with({anyOf:i.array().select()},e=>({anyOf:e.map(e=>$(e,[]))})).with({oneOf:i.array().select()},e=>({oneOf:e.map(e=>$(e,[]))})).otherwise(()=>({}))}),u={anyOf:[...$(o,[]).anyOf,{$ref:"#/definitions/Read"}]},j=Object.fromEntries(l.flatMap(e=>[[e.readName,h(e.schema,!1)],[e.readWriteName,h(e.schema,!0)]])),b=e=>{let{definitions:t,...r}=$(e.schema,e.writableKeys);return{type:"object",additionalProperties:{anyOf:[{...r,properties:{...r.properties,$filter:{$ref:"#/definitions/ComponentSystemFilter"}}},{type:"object",properties:{$read:{type:"string",pattern:"^\\$?[a-z]\\w*$"},$filter:{$ref:"#/definitions/ComponentSystemFilter"}},required:["$read"],additionalProperties:!1}]}}},O=e=>{let t=a.find(t=>t.name===e);if(!t)throw Error(`Component ${e} not found!`);return b(t)},E=e=>{for(let t of Object.values(e))for(let[e,r]of Object.entries(t)){let t={...O(e).additionalProperties,definitions:{...f.definitions,...s(),...j,ComponentSystemFilter:u,ReadEnhancement:m,ReadWriteEnhancement:c}},i=d().compile(t);for(let[t,n]of Object.entries(r))if(!i(n))throw Error(`Component validation failed ${e} ${t}, ${JSON.stringify(i.errors,null,2)}`)}};export const getDomainSpec=(e=!0)=>t({$comment:"This schema is generated from the domain-spec-template.json file, do not modify it directly.",...f,properties:{...f.properties,components:{type:"object",patternProperties:{"^[A-Z]\\w*$":{type:"object",properties:e?Object.fromEntries(a.map(e=>{let t=b(e);return[e.name,t]})):{},additionalProperties:!e}},additionalProperties:!1}},definitions:{...f.definitions,...s(),...j,ComponentSystemFilter:u,ReadEnhancement:m,ReadWriteEnhancement:c}});let R=getDomainSpec(!1),w=d().compile(R),g=d().compile({...R,$id:"https://salsita.ai/phoenix/schemas/domain-spec.json!complete",required:[...p]});export const getValidatePartialSpecification=()=>e=>{let t=w(e);return(E(e.components??{}),t)?{success:!0,value:e}:{success:!1,errors:w.errors}};export const getValidateMergedSpecification=()=>e=>{let t=g(e);return(E(e.components??{}),t)?{success:!0,value:e}:{success:!1,errors:g.errors}};export const dereferenceDomainSpec=async r=>{var i;let n,o;return r.definitions={...t(s()),...r.definitions??{}},i=e=>{"object"==typeof e&&null!==e&&"$ref"in e&&"string"==typeof e.$ref&&(e.$ref=e.$ref.replace("https://salsita.ai/phoenix/schemas/types.json#","#"))},n=new Set,(o=e=>{if(!n.has(e)){if(n.add(e),i(e),Array.isArray(e))for(let t of e)o(t);else if("object"==typeof e&&null!==e)for(let t of Object.values(e))o(t)}})(r),await e(r,{resolve:{http:!1,file:!1,common:{order:2}}}),delete r.definitions,r};
+import{dereference as e}from"@apidevtools/json-schema-ref-parser";import t from"lodash-es/cloneDeep.js";import r from"lodash-es/isEqual.js";import{P as i,match as n}from"ts-pattern";import{ComponentSystemFilterSchema as o,availableSystemComponents as a,getAllPhxDefinitions as s,getExtendedSchemaValidator as f}from"#package/domain";import{domainSpecTemplate as p,requiredSpecs as d}from"./domain-spec-template.js";let l={anyOf:[{$ref:"#/definitions/Read"},{$ref:"#/definitions/ImportRef"},{$ref:"#/definitions/CodeRef"},{$ref:"#/definitions/DataRef"},{$ref:"#/definitions/Eval"}]},m={anyOf:[{$ref:"#/definitions/ReadWrite"},{$ref:"#/definitions/ImportRef"},{$ref:"#/definitions/CodeRef"}]},c=[{readName:"EnhancedStringRead",readWriteName:"EnhancedStringReadWrite",schema:{type:"string"}},{readName:"EnhancedNumberRead",readWriteName:"EnhancedNumberReadWrite",schema:{type:"number"}},{readName:"EnhancedBooleanRead",readWriteName:"EnhancedBooleanReadWrite",schema:{type:"boolean"}}],h=(e,t)=>({anyOf:[$(e,[]),t?{$ref:"#/definitions/ReadWriteEnhancement"}:{$ref:"#/definitions/ReadEnhancement"}]}),y=(e,t)=>{let i=c.find(t=>r(e,t.schema));return i?{$ref:`#/definitions/${t?i.readWriteName:i.readName}`}:h(e,t)},$=(e,t)=>({...e,...n(e).with({type:"object",properties:i.not(i.nullish).select()},e=>({properties:Object.fromEntries(Object.entries(e).map(([e,r])=>[e,y(r,t.includes(e))]))})).with({type:"object",additionalProperties:i.not(i.nullish.or(i.boolean)).select()},e=>({additionalProperties:y(e,!1)})).with({type:"object",patternProperties:i.not(i.nullish).select()},e=>({patternProperties:Object.fromEntries(Object.entries(e).map(([e,t])=>[e,y(t,!1)]))})).with({type:"array",items:i.not(i.nullish).select()},e=>({items:$(e,[])})).with({anyOf:i.array().select()},e=>({anyOf:e.map(e=>$(e,[]))})).with({oneOf:i.array().select()},e=>({oneOf:e.map(e=>$(e,[]))})).otherwise(()=>({}))}),u={anyOf:[...$(o,[]).anyOf,{$ref:"#/definitions/Read"}]},j=Object.fromEntries(c.flatMap(e=>[[e.readName,h(e.schema,!1)],[e.readWriteName,h(e.schema,!0)]])),b=e=>{let{definitions:t,...r}=$(e.schema,e.writableKeys);return{type:"object",additionalProperties:{anyOf:[{...r,properties:{...r.properties,$filter:{$ref:"#/definitions/ComponentSystemFilter"}}},{type:"object",properties:{$read:{type:"string",pattern:"^\\$?[a-z]\\w*$"},$filter:{$ref:"#/definitions/ComponentSystemFilter"}},required:["$read"],additionalProperties:!1}]}}},O=new Map,E=e=>{let t=`${globalThis.PHX_SCHEMA_VALIDATOR??"ajv"}:${e}`,r=O.get(t);if(r)return r;let i={...(e=>{let t=a.find(t=>t.name===e);if(!t)throw Error(`Component ${e} not found!`);return b(t)})(e).additionalProperties,definitions:{...p.definitions,...s(),...j,ComponentSystemFilter:u,ReadEnhancement:l,ReadWriteEnhancement:m}},n=f().compile(i);return O.set(t,n),n},R=e=>{for(let t of Object.values(e))for(let[e,r]of Object.entries(t)){let t=E(e);for(let[i,n]of Object.entries(r))if(!t(n))throw Error(`Component validation failed ${e} ${i}, ${JSON.stringify(t.errors,null,2)}`)}};export const getDomainSpec=(e=!0)=>t({$comment:"This schema is generated from the domain-spec-template.json file, do not modify it directly.",...p,properties:{...p.properties,components:{type:"object",patternProperties:{"^[A-Z]\\w*$":{type:"object",properties:e?Object.fromEntries(a.map(e=>{let t=b(e);return[e.name,t]})):{},additionalProperties:!e}},additionalProperties:!1}},definitions:{...p.definitions,...s(),...j,ComponentSystemFilter:u,ReadEnhancement:l,ReadWriteEnhancement:m}});let g=getDomainSpec(!1),w=f().compile(g),S=f().compile({...g,$id:"https://salsita.ai/phoenix/schemas/domain-spec.json!complete",required:[...d]});export const getValidatePartialSpecification=()=>e=>{let t=w(e);return(R(e.components??{}),t)?{success:!0,value:e}:{success:!1,errors:w.errors}};export const getValidateMergedSpecification=()=>e=>{let t=S(e);return(R(e.components??{}),t)?{success:!0,value:e}:{success:!1,errors:S.errors}};export const dereferenceDomainSpec=async r=>{var i;let n,o;return r.definitions={...t(s()),...r.definitions??{}},i=e=>{"object"==typeof e&&null!==e&&"$ref"in e&&"string"==typeof e.$ref&&(e.$ref=e.$ref.replace("https://salsita.ai/phoenix/schemas/types.json#","#"))},n=new Set,(o=e=>{if(!n.has(e)){if(n.add(e),i(e),Array.isArray(e))for(let t of e)o(t);else if("object"==typeof e&&null!==e)for(let t of Object.values(e))o(t)}})(r),await e(r,{resolve:{http:!1,file:!1,common:{order:2}}}),delete r.definitions,r};

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  - A layout element named `ConfiguratorLayout` replaces everything the built-in layout renders for a loaded configuration, finalization 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, and call `useSceneSafeArea()` (same import) with its `containerRef` on the element covering the whole canvas and its `safeAreaRef` on the region the layout's UI leaves free, so the camera frames the scene there, and to keep the spec's tabs, property pages, sidebar footer and assistant panel while moving them, mount `LayoutSlots.DesktopSidebar` (same import) in a positioned container that sets its size, with `side=\"start\"` when it is on the left\n    - The hooks such a layout reads, with what each returns, are listed under \"Hooks for a Project Layout\" in `docs/phoenix/configurator-interface.mdx` (read it with `pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx`), and the `LayoutSlots` members in `docs/phoenix/layout-slots.mdx`; it finalizes over the spec's `finalizeAction` components, since `finalizePage` and `finalizeButton` are legacy\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  - `ConfiguratorLayout`: a layout element with this name replaces everything the built-in layout renders for a loaded configuration, in owner and read mode, finalization included. Prefer arranging the spec's layout components; write one for shell-level changes, such as moving the sidebar or adding an area the built-in layout has no place for\n    - Mount `LayoutSlots.SharedCanvas` (from `@salsita-ai/sdk/configurator`) in a positioned root covering the page; put the UI above it, positioned and after it in the markup. With the canvas mounted the app loader waits until the scene has loaded; a layout without a canvas is not held by the loader. Call `phx.frontend.useSceneSafeArea()` and put `containerRef` on the element covering the whole canvas and `safeAreaRef` on the region the UI leaves free, with `pointerEvents: 'none'`, so the camera frames the scene there\n    - Sidebar moved, contents as the spec configures them: mount `LayoutSlots.DesktopSidebar` in a positioned container that sets its size, with `side=\"start\"` on the left; `docs/layouts/sidebar/in-a-custom-layout.mdx` is the whole layout\n    - Your own UI: \"Hooks for a Project Layout\" in `docs/phoenix/configurator-interface.mdx` lists the hooks with what each returns (`pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx`), `docs/phoenix/layout-slots.mdx` the built-in pieces you can still mount, and `docs/layouts/custom-layout.mdx` is a worked example. Call the hooks as `phx.frontend.useX()`; besides those below, these are often needed: `usePreview()` (`isPreview` while the preview start screen shows), `useCloseAction()` (the host's close action or `null`), `useActiveViewports()` (the container's breakpoints, `null` until measured, `desktop` above 768 px: the desktop/phone switch), `useResolveLocalizable()` and `useLocalizable(text)` (spec texts to strings), `useIsCloningAllowed()` (a read-mode \"edit a copy\" action with `LayoutSlots.CloneToEditDialog`)\n    - Undo and redo: `phx.frontend.useUndoRedo()` returns `{ canUndo, canRedo, undo, redo }`; disable each button from `canUndo`/`canRedo`\n    - Tabs: `phx.frontend.useTabNavigation()` returns `{ source, tabs, activeTab, select }` for the spec's `sidebarTabs` (of the selected entity) or `horizontalTabs`; render `tabs` (each `{ index, label, icon, state, isActive }`, `icon` a PhxIcon name) and call `select(tab.index)` on click. Pass `{ source: 'sidebarTabs' }` or `{ source: 'horizontalTabs' }` when the layout shows one kind only. Not `LayoutSlots.useSidebarTabs()`: it serves the built-in sidebar and returns no tabs while its summary shows\n    - Steps: `phx.frontend.useStepNavigation()` returns `{ steps, activeStep, activeIndex, isFirst, isLast, canGoNext, canGoPrevious, next, previous, goTo }` for the spec's `navigationSteps`; render `steps` (each `{ index, label, state, status }`, `status` `'complete' | 'active' | 'upcoming'`), call `next()`/`previous()` for Back and Next and `goTo(step.index)` from a stepper. It enforces no order and no validity: enable only `'complete'` steps for an \"earlier steps only\" stepper, and to block moving on while the configuration has a problem, require `phx.frontend.useStateValidity().severity !== 'warning'` besides `canGoNext`: a change with a `fixable` or `fatal` violation is rejected, so the configuration is never invalid, and a `warning` is the problem that stays (it blocks finalizing too). `useSteps` and `useHasSteps` from `@salsita-ai/sdk/configurator` are deprecated\n    - Messages: mount `LayoutSlots.Services` for the built-in snackbars, or show violations, side-effect hints, errors and failed saves yourself with `phx.frontend.useConfiguratorMessages(onMessage)`, not both. A failed save arrives as `saveError`, the next successful save as `saveRecovery`; a layout that mounts neither shows no sign of a failed save. Either way mount a snackbar root (`LayoutSlots.DesktopSnackbarsRoot` or `LayoutSlots.MobileSnackbarsRoot`): errors of the built-in actions are always snackbars\n    - Finalize over the spec's `finalizeAction` components, each naming a handler registered with `phx.frontend.createPhoenixHandler`: `phx.frontend.useFinalizeActions()` returns `{ actions, primary, secondary, disabled, hints }`; render `primary` (and `secondary` in a menu or list) in a loop, each action `{ key, label, title, icon, run, isPending, error, disabled }`, and call `action.run()` on click (its promise never rejects; show `action.error` on failure). The configurator runs the handlers itself, outside the layout, so a handler must not rely on a provider the layout adds. For one known handler, `phx.frontend.useFinalizeAction(handler)` in a component wrapped in `PhoenixHandlerBoundary` (from `@salsita-ai/sdk/react`) works too; `FinalizeActions` (from `@salsita-ai/sdk/configurator`) mounts the built-in buttons. `finalizePage` and `finalizeButton` are legacy\n    - Read mode and fullscreen are the layout's job, no hook enforces them (`useUndoRedo`, `useFinalizeActions` and `useStepNavigation` included): hide undo, redo, finalization and whatever else a viewer must not change while `phx.frontend.useAccessService().accessInfo.viewMode` is `true` (tabs are navigation, so a viewer may switch them), and remove panels while `phx.frontend.useIsFullscreenActive()` is set; `phx.frontend.useSetFullscreen()` returns its setter\n  - `ConfigurationNotFoundPage`: `phx.frontend.createConfigurationNotFoundPage(({ onBack }) => \u2026)` replaces the \"configuration not accessible\" page; show a way back only when the optional `onBack` is set. The not-authenticated page's default renders it too; only the admin's not-authorized page keeps the built-in page\n  - `ConfiguratorErrorPage`: `phx.frontend.createConfiguratorErrorPage(({ reason, onRetry }) => \u2026)` replaces the production error page; `reason` is `uncaughtError` or `presetCreationFailed`. A page that throws falls back to the built-in one, and development keeps the detailed error pages, so the project page shows only in a production build. Register both pages with these helpers: `createCustomPhoenixLayoutElement` with the name works too, but types the component as taking only `children`, so the typed props do not compile there in a strict project\n  - `AppLoaderContent`: `phx.frontend.createAppLoader(({ phases }) => \u2026)` replaces what the loading overlay shows (each phase `{ id, label?, progress? }`, the list possibly empty); Phoenix keeps the overlay itself\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";

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

@@ -1,2 +1,2 @@
 export declare const mergeCursorRulesContent: (existingContent: string | undefined) => string;
-export declare const cursorRulesFile = "---\ndescription: Phoenix SDK project rules\nglobs:\nalwaysApply: true\n---\n\n[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, finalization 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, and call `useSceneSafeArea()` (same import) with its `containerRef` on the element covering the whole canvas and its `safeAreaRef` on the region the layout's UI leaves free, so the camera frames the scene there, and to keep the spec's tabs, property pages, sidebar footer and assistant panel while moving them, mount `LayoutSlots.DesktopSidebar` (same import) in a positioned container that sets its size, with `side=\"start\"` when it is on the left\n    - The hooks such a layout reads, with what each returns, are listed under \"Hooks for a Project Layout\" in `docs/phoenix/configurator-interface.mdx` (read it with `pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx`), and the `LayoutSlots` members in `docs/phoenix/layout-slots.mdx`; it finalizes over the spec's `finalizeAction` components, since `finalizePage` and `finalizeButton` are legacy\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 cursorRulesFile = "---\ndescription: Phoenix SDK project rules\nglobs:\nalwaysApply: true\n---\n\n[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  - `ConfiguratorLayout`: a layout element with this name replaces everything the built-in layout renders for a loaded configuration, in owner and read mode, finalization included. Prefer arranging the spec's layout components; write one for shell-level changes, such as moving the sidebar or adding an area the built-in layout has no place for\n    - Mount `LayoutSlots.SharedCanvas` (from `@salsita-ai/sdk/configurator`) in a positioned root covering the page; put the UI above it, positioned and after it in the markup. With the canvas mounted the app loader waits until the scene has loaded; a layout without a canvas is not held by the loader. Call `phx.frontend.useSceneSafeArea()` and put `containerRef` on the element covering the whole canvas and `safeAreaRef` on the region the UI leaves free, with `pointerEvents: 'none'`, so the camera frames the scene there\n    - Sidebar moved, contents as the spec configures them: mount `LayoutSlots.DesktopSidebar` in a positioned container that sets its size, with `side=\"start\"` on the left; `docs/layouts/sidebar/in-a-custom-layout.mdx` is the whole layout\n    - Your own UI: \"Hooks for a Project Layout\" in `docs/phoenix/configurator-interface.mdx` lists the hooks with what each returns (`pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx`), `docs/phoenix/layout-slots.mdx` the built-in pieces you can still mount, and `docs/layouts/custom-layout.mdx` is a worked example. Call the hooks as `phx.frontend.useX()`; besides those below, these are often needed: `usePreview()` (`isPreview` while the preview start screen shows), `useCloseAction()` (the host's close action or `null`), `useActiveViewports()` (the container's breakpoints, `null` until measured, `desktop` above 768 px: the desktop/phone switch), `useResolveLocalizable()` and `useLocalizable(text)` (spec texts to strings), `useIsCloningAllowed()` (a read-mode \"edit a copy\" action with `LayoutSlots.CloneToEditDialog`)\n    - Undo and redo: `phx.frontend.useUndoRedo()` returns `{ canUndo, canRedo, undo, redo }`; disable each button from `canUndo`/`canRedo`\n    - Tabs: `phx.frontend.useTabNavigation()` returns `{ source, tabs, activeTab, select }` for the spec's `sidebarTabs` (of the selected entity) or `horizontalTabs`; render `tabs` (each `{ index, label, icon, state, isActive }`, `icon` a PhxIcon name) and call `select(tab.index)` on click. Pass `{ source: 'sidebarTabs' }` or `{ source: 'horizontalTabs' }` when the layout shows one kind only. Not `LayoutSlots.useSidebarTabs()`: it serves the built-in sidebar and returns no tabs while its summary shows\n    - Steps: `phx.frontend.useStepNavigation()` returns `{ steps, activeStep, activeIndex, isFirst, isLast, canGoNext, canGoPrevious, next, previous, goTo }` for the spec's `navigationSteps`; render `steps` (each `{ index, label, state, status }`, `status` `'complete' | 'active' | 'upcoming'`), call `next()`/`previous()` for Back and Next and `goTo(step.index)` from a stepper. It enforces no order and no validity: enable only `'complete'` steps for an \"earlier steps only\" stepper, and to block moving on while the configuration has a problem, require `phx.frontend.useStateValidity().severity !== 'warning'` besides `canGoNext`: a change with a `fixable` or `fatal` violation is rejected, so the configuration is never invalid, and a `warning` is the problem that stays (it blocks finalizing too). `useSteps` and `useHasSteps` from `@salsita-ai/sdk/configurator` are deprecated\n    - Messages: mount `LayoutSlots.Services` for the built-in snackbars, or show violations, side-effect hints, errors and failed saves yourself with `phx.frontend.useConfiguratorMessages(onMessage)`, not both. A failed save arrives as `saveError`, the next successful save as `saveRecovery`; a layout that mounts neither shows no sign of a failed save. Either way mount a snackbar root (`LayoutSlots.DesktopSnackbarsRoot` or `LayoutSlots.MobileSnackbarsRoot`): errors of the built-in actions are always snackbars\n    - Finalize over the spec's `finalizeAction` components, each naming a handler registered with `phx.frontend.createPhoenixHandler`: `phx.frontend.useFinalizeActions()` returns `{ actions, primary, secondary, disabled, hints }`; render `primary` (and `secondary` in a menu or list) in a loop, each action `{ key, label, title, icon, run, isPending, error, disabled }`, and call `action.run()` on click (its promise never rejects; show `action.error` on failure). The configurator runs the handlers itself, outside the layout, so a handler must not rely on a provider the layout adds. For one known handler, `phx.frontend.useFinalizeAction(handler)` in a component wrapped in `PhoenixHandlerBoundary` (from `@salsita-ai/sdk/react`) works too; `FinalizeActions` (from `@salsita-ai/sdk/configurator`) mounts the built-in buttons. `finalizePage` and `finalizeButton` are legacy\n    - Read mode and fullscreen are the layout's job, no hook enforces them (`useUndoRedo`, `useFinalizeActions` and `useStepNavigation` included): hide undo, redo, finalization and whatever else a viewer must not change while `phx.frontend.useAccessService().accessInfo.viewMode` is `true` (tabs are navigation, so a viewer may switch them), and remove panels while `phx.frontend.useIsFullscreenActive()` is set; `phx.frontend.useSetFullscreen()` returns its setter\n  - `ConfigurationNotFoundPage`: `phx.frontend.createConfigurationNotFoundPage(({ onBack }) => \u2026)` replaces the \"configuration not accessible\" page; show a way back only when the optional `onBack` is set. The not-authenticated page's default renders it too; only the admin's not-authorized page keeps the built-in page\n  - `ConfiguratorErrorPage`: `phx.frontend.createConfiguratorErrorPage(({ reason, onRetry }) => \u2026)` replaces the production error page; `reason` is `uncaughtError` or `presetCreationFailed`. A page that throws falls back to the built-in one, and development keeps the detailed error pages, so the project page shows only in a production build. Register both pages with these helpers: `createCustomPhoenixLayoutElement` with the name works too, but types the component as taking only `children`, so the typed props do not compile there in a strict project\n  - `AppLoaderContent`: `phx.frontend.createAppLoader(({ phases }) => \u2026)` replaces what the loading overlay shows (each phase `{ id, label?, progress? }`, the list possibly empty); Phoenix keeps the overlay itself\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";