@salsita-ai/sdk 0.50.0-develop.d6ed5efd42 → 0.50.0-develop.d7ce7f7857

package/dist/legacy/domain-cli/gen/configurator-builder.js

@@ -1,30 +1,31 @@
-import{P as e,match as t}from"ts-pattern";import{Imports as a}from"./imports.js";export const generateConfigBuilder=(i,n,o,s,r,d,l,m,p,h,c,u,g)=>{let y=[],C=new a("./configurator-builder.js",g);C.importMembers("./application-types.js","PrefetchedFinalizeData","FinalizeData","FinalizeResult","NavigationState","ViewState","ToolState","ExportState","CallbackData","AdminNavigationState","AdminViewState","ApplicationVersion","PublishedDataHash","$dataSpec");let w=(a=>{if(!a||0===a.length)return"";let i=[];for(let n of a){let a=t(n).with({type:"ConfigurationLink"},e=>`  .addLink({
+import{P as e,match as t}from"ts-pattern";import{Imports as a}from"./imports.js";export const generateConfigBuilder=(i,n,o,s,r,d,m,l,p,h,c,u,g)=>{let y=[],w=new a("./configurator-builder.js",g);w.importMembers("./application-types.js","PrefetchedFinalizeData","FinalizeData","FinalizeResult","NavigationState","ViewState","ToolState","ExportState","CallbackData","AdminNavigationState","AdminViewState","ApplicationVersion","PublishedDataHash","$dataSpec");let C=(a=>{if(!a||0===a.length)return"";let i=[],n=new Set;for(let o of a){if(n.has(o.name))throw Error(`Resource with name ${o.name} already exists!`);n.add(o.name);let a=t(o).with({type:"ConfigurationLink"},e=>`  {
     type: 'ConfigurationLink',
     name: '${e.name}',
-  })`).with({type:"Csv"},e=>{let t=e.s3Key?`,
-    s3Key: '${e.s3Key}'`:"";return`  .addCsv({
+  },`).with({type:"Csv"},e=>{let t=e.s3Key?`,
+    s3Key: '${e.s3Key}'`:"";return`  {
     type: 'Csv',
     name: '${e.name}'${t},
-  })`}).with({type:"Pdf"},e=>{let t=e.s3Key?`,
-    s3Key: '${e.s3Key}'`:"";return`  .addPdf({
+  },`}).with({type:"Pdf"},e=>{let t=e.s3Key?`,
+    s3Key: '${e.s3Key}'`:"";return`  {
     type: 'Pdf',
     name: '${e.name}'${t},
-  })`}).with({type:"Image",clientGenerated:!0,s3Key:e.string},e=>`  .addClientGeneratedImage({
+  },`}).with({type:"Image",clientGenerated:!0,s3Key:e.string},e=>`  {
     type: 'Image',
     name: '${e.name}',
     clientGenerated: true,
     s3Key: '${e.s3Key}',
-  })`).with({type:"Image",exists:!0,url:e.string},e=>`  .addExistingImage({
+  },`).with({type:"Image",exists:!0,url:e.string},e=>`  {
     type: 'Image',
     name: '${e.name}',
     exists: true,
     url: '${e.url}',
-  })`).with({type:"Image"},e=>`  .addGeneratedImage({
+  },`).with({type:"Image"},e=>`  {
     type: 'Image',
     name: '${e.name}',
     s3Key: '${e.s3Key}',
-  })`).exhaustive();i.push(a)}return`const generatedResources = new ResourceBuilder()${i.join("\n")}
-  .build()`})(s);if(w&&y.push(w),y.push(`
+  },`).exhaustive();i.push(a)}return`const generatedResources = [
+${i.join("\n")}
+] as const`})(s);if(C&&y.push(C),y.push(`
     // The generated optics reach the builder as untyped project modules, so the entity and data types
     // they used to carry by inference are stated here.
     export const generatedConfiguratorBuilder = new ConfiguratorBuilder<
@@ -55,7 +56,7 @@ import{P as e,match as t}from"ts-pattern";import{Imports as a}from"./imports.js"
       .withDataSpec($dataSpec)
       .withPublishedDataHash(PublishedDataHash)
       .withVersion(ApplicationVersion)${c?`
-      .withTextLanguages(${JSON.stringify(c)})`:""}`),o&&y.push(`.withWebComponentTag('${o}')`),i&&(y.push(".withPresets(generatedPresets)"),C.importMembers("./presets.js","generatedPresets")),n&&(y.push(".withAdminPresets(generatedAdminPresets)"),C.importMembers("./admin-presets.js","generatedAdminPresets")),w&&y.push(".withResources(generatedResources)"),r?.canCreate&&y.push(`.withAcl({ canCreate: [${r.canCreate.map(e=>`'${e}'`).join(", ")}] })`),d&&y.push(".withAdminRelease(true)"),void 0!==l||void 0!==m||void 0!==p){let e=[];void 0!==l&&e.push(`appLoader: '${l}'`),void 0!==m&&e.push(`preview: '${m}'`),void 0!==p&&e.push(`alwaysExpand: ${p}`),e.length>0&&y.push(`.withUi({ ${e.join(", ")} })`)}if(h){let e=[];if(void 0!==h.baseResourcesUrl&&e.push(`baseResourcesUrl: ${JSON.stringify(h.baseResourcesUrl)}`),void 0!==h.prefetchTextureUrls){let t=h.prefetchTextureUrls.map(e=>JSON.stringify(e)).join(", ");e.push(`prefetchTextureUrls: [${t}]`)}void 0!==h.deploymentQueryDisabled&&e.push(`deploymentQueryDisabled: ${h.deploymentQueryDisabled}`),e.length>0&&y.push(`.withResourcesConfig({ ${e.join(", ")} })`)}if(u&&Object.keys(u).length>0){let e=JSON.stringify(u);y.push(`.withChunks(${e})`)}let b=["ConfiguratorBuilder"];return w&&b.push("ResourceBuilder"),C.importMembers("@salsita-ai/sdk/domain",...b),C.importMembers("./components/index.js","generatedComponents"),C.importMembers("./admin-components/index.js","adminGeneratedComponents"),C.importMembers("./implementation.js","createRecipe","implementCustomInvariants","attachComponent","implementCustomExpressions"),C.importMembers("./admin-implementation.js","createAdminRecipe","implementCustomAdminInvariants","attachAdminComponent","implementAdminCustomExpressions","createMapPublishedRevisionDataHandler","createMapPublishedChunkedDataHandler","createDataRowValidatorHandler","createSheetValidatorHandler"),y.push(`
+      .withTextLanguages(${JSON.stringify(c)})`:""}`),o&&y.push(`.withWebComponentTag('${o}')`),i&&(y.push(".withPresets(generatedPresets)"),w.importMembers("./presets.js","generatedPresets")),n&&(y.push(".withAdminPresets(generatedAdminPresets)"),w.importMembers("./admin-presets.js","generatedAdminPresets")),C&&y.push(".withResources(generatedResources)"),r?.canCreate&&y.push(`.withAcl({ canCreate: [${r.canCreate.map(e=>`'${e}'`).join(", ")}] })`),d&&y.push(".withAdminRelease(true)"),void 0!==m||void 0!==l||void 0!==p){let e=[];void 0!==m&&e.push(`appLoader: '${m}'`),void 0!==l&&e.push(`preview: '${l}'`),void 0!==p&&e.push(`alwaysExpand: ${p}`),e.length>0&&y.push(`.withUi({ ${e.join(", ")} })`)}if(h){let e=[];if(void 0!==h.baseResourcesUrl&&e.push(`baseResourcesUrl: ${JSON.stringify(h.baseResourcesUrl)}`),void 0!==h.prefetchTextureUrls){let t=h.prefetchTextureUrls.map(e=>JSON.stringify(e)).join(", ");e.push(`prefetchTextureUrls: [${t}]`)}void 0!==h.deploymentQueryDisabled&&e.push(`deploymentQueryDisabled: ${h.deploymentQueryDisabled}`),e.length>0&&y.push(`.withResourcesConfig({ ${e.join(", ")} })`)}if(u&&Object.keys(u).length>0){let e=JSON.stringify(u);y.push(`.withChunks(${e})`)}return w.importMembers("@salsita-ai/sdk/domain","ConfiguratorBuilder"),w.importMembers("./components/index.js","generatedComponents"),w.importMembers("./admin-components/index.js","adminGeneratedComponents"),w.importMembers("./implementation.js","createRecipe","implementCustomInvariants","attachComponent","implementCustomExpressions"),w.importMembers("./admin-implementation.js","createAdminRecipe","implementCustomAdminInvariants","attachAdminComponent","implementAdminCustomExpressions","createMapPublishedRevisionDataHandler","createMapPublishedChunkedDataHandler","createDataRowValidatorHandler","createSheetValidatorHandler"),y.push(`
     import * as AdminEnhancenModel from './admin-enhanced-model.js'
     import * as AdminModel from './admin-model/index.js'
     import * as EnhancedModel from './enhanced-model.js'
@@ -101,4 +102,4 @@ import{P as e,match as t}from"ts-pattern";import{Imports as a}from"./imports.js"
         createSheetValidatorHandler: createSheetValidatorHandler,
       },
     }
-  `),{modulePath:C.targetModule,content:["/* eslint-disable */",C.toString(),...y].join("\n")}};
+  `),{modulePath:w.targetModule,content:["/* eslint-disable */",w.toString(),...y].join("\n")}};

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

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

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

@@ -1,7 +1 @@
-import{DOMAIN_SDK_MODULE as e}from"./imports.js";import{stringifyWithCodeRefsAndI18n as i}from"./stringify-with-code-refs-and-i18n.js";export const generateDefaults=(t,s,n)=>(s.importMembers(e,"RecipeFactoryBuilder"),s.importMembers(n?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","aliases"),n)?`export const createAdminRecipe = RecipeFactoryBuilder.forAliases<AnyDomainEntity, Aliases>(aliases)
-    .forEntities(AnyDomainEntity.reflections)
-    .withDefaults(${i(t,s)})
-    .build()`:`export const createRecipe = RecipeFactoryBuilder.forAliases<AnyDomainEntity, Aliases>(aliases)
-    .forEntities(AnyDomainEntity.reflections)
-    .withDefaults(${i(t,s)})
-    .build()`;
+import{DOMAIN_SDK_MODULE as e}from"./imports.js";import{stringifyWithCodeRefsAndI18n as i}from"./stringify-with-code-refs-and-i18n.js";export const generateDefaults=(t,r,n)=>(r.importMembers(e,"createRecipeFactory"),r.importMembers(n?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","aliases"),`export const ${n?"createAdminRecipe":"createRecipe"} = createRecipeFactory<AnyDomainEntity>(aliases, AnyDomainEntity.reflections, ${i(t,r)})`);

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

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

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

@@ -1,4 +1,4 @@
-import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAndI18n as n}from"./stringify-with-code-refs-and-i18n.js";export const generateInvariants=(i,a,e,s)=>{let o=[];for(let[t,n]of(o.push("interface CustomInvariantBlueprints {"),Object.entries(a))){for(let i of(o.push(`  ${t}: {`),n))o.push(`    ${i.name}: ${i.valueType}`);o.push("  }")}for(let[t,s]of(o.push("}"),o.push("const staticViolations = {"),Object.entries(a))){if(!s.some(t=>t.isStatic))continue;let a=i?.[t];if(a){for(let i of(o.push(`  ${t}: {`),s))if(i.isStatic){let t=a[i.name];t&&o.push(`    ${i.name}: ${n(t,e)},`)}o.push("  },")}}return o.push("} as const"),s?o.push(`export const implementCustomAdminInvariants = createCustomInvariantFactory<
+import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAndI18n as n}from"./stringify-with-code-refs-and-i18n.js";export const generateInvariants=(i,o,e,s)=>{let a=[];for(let[t,n]of(a.push("interface CustomInvariantBlueprints {"),Object.entries(o))){for(let i of(a.push(`  ${t}: {`),n))a.push(`    ${i.name}: ${i.valueType}`);a.push("  }")}for(let[t,s]of(a.push("}"),a.push("const staticViolations = {"),Object.entries(o))){if(!s.some(t=>t.isStatic))continue;let o=i?.[t];if(o){for(let i of(a.push(`  ${t}: {`),s))if(i.isStatic){let t=o[i.name];t&&a.push(`    ${i.name}: ${n(t,e)},`)}a.push("  },")}}return a.push("} as const"),s?a.push(`export const implementCustomAdminInvariants = createCustomInvariantFactory<
       AnyDomainEntity,
       RootEntity,
       $Map,
@@ -6,9 +6,10 @@ import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAnd
       SessionData,
       FrontendData,
       Aliases,
-      CustomInvariantBlueprints
+      CustomInvariantBlueprints,
+      RuntimeExpressionContext<AnyDomainEntity>
     >()(staticViolations)
-    `):o.push(`export const implementCustomInvariants = createCustomInvariantFactory<
+    `):a.push(`export const implementCustomInvariants = createCustomInvariantFactory<
   AnyDomainEntity,
   RootEntity,
   $Map,
@@ -16,7 +17,7 @@ import{DOMAIN_SDK_MODULE as t}from"./imports.js";import{stringifyWithCodeRefsAnd
   SessionData,
   FrontendData,
   Aliases,
-  CustomInvariantBlueprints
+  CustomInvariantBlueprints,
+  RuntimeExpressionContext<AnyDomainEntity>
 >()(staticViolations)
-`),e.importMembers(t,"createCustomInvariantFactory"),e.importMembers(s?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),e.importMembers(s?"./admin-enhanced-model.js":"./enhanced-model.js","$Map"),s?(e.importMembers(t,"commonAdminViolationExpressions"),o.push(`export const adminInvariantBuilder = new InvariantBuilder<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)
-        .withInvariants(implementCustomAdminInvariants(commonAdminViolationExpressions))`)):o.push("export const invariantBuilder = new InvariantBuilder<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)"),e.importMembers(t,"InvariantBuilder"),o.join("\n")};
+`),e.importMembers(t,"createCustomInvariantFactory","RuntimeExpressionContext"),e.importMembers(s?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),e.importMembers(s?"./admin-enhanced-model.js":"./enhanced-model.js","$Map"),s&&(e.importMembers(t,"commonAdminViolationExpressions"),a.push("export const commonAdminInvariants = implementCustomAdminInvariants(commonAdminViolationExpressions)")),a.join("\n")};

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

@@ -1 +1 @@
-import e from"lodash-es/omit.js";import{DOMAIN_SDK_MODULE as t}from"./imports.js";export const generateRelations=(s,n,o)=>{let i=Object.keys(s).length>0;n.importMembers(t,"AliasedExpressions"),n.importMembers(o?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity"),n.importMembers(o?"./admin-enhanced-model.js":"./enhanced-model.js","$Map");let a=[];return i&&(n.importMembers(t,"createRelationFactory"),a.push("const implementRelation = createRelationFactory<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, Aliases>(aliases)")),a.push("export const relationExpressions = {"),Object.entries(s).forEach(([t,s])=>{a.push(`  ${t}: {`),Object.entries(s).forEach(([s,n])=>{a.push(`    ${s}: implementRelation<'${t}', '${n.target}'>(${JSON.stringify(e(n,"composedOf"),null,2)}),`)}),a.push("  },")}),a.push("} as const satisfies AliasedExpressions<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>"),a.push("\n"),a.join("\n")};
+import e from"lodash-es/omit.js";import{DOMAIN_SDK_MODULE as s}from"./imports.js";export const generateRelations=(t,o,i)=>{let n=Object.keys(t).length>0;o.importMembers(s,"AliasedExpressions"),o.importMembers(i?"./admin-model/index.js":"./model/index.js","AnyDomainEntity","Aliases","RootEntity");let a=[];return n&&(o.importMembers(s,"createRelationFactory"),a.push("const implementRelation = createRelationFactory(aliases)")),a.push("export const relationExpressions = {"),Object.entries(t).forEach(([s,t])=>{a.push(`  ${s}: {`),Object.entries(t).forEach(([s,t])=>{a.push(`    ${s}: implementRelation(${JSON.stringify(e(t,"composedOf"),null,2)}),`)}),a.push("  },")}),a.push("} as const satisfies AliasedExpressions<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>"),a.push("\n"),a.join("\n")};

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

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

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

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

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

@@ -1134,7 +1134,9 @@ export type GroupedRecipeItems = {
     instanceNames: string[];
     [k: string]: unknown;
 };
+export type DomainEntityId = string;
 export type EnhancedStringReadWrite = string | ReadWriteEnhancement;
+export type EnhancedBooleanReadWrite = boolean | ReadWriteEnhancement;
 export interface DomainSpecification {
     $admin?: boolean;
     model: {
@@ -1973,7 +1975,6 @@ export interface DomainSpecification {
                         } | ReadEnhancement;
                         constant: EnhancedNumberRead;
                     }[] | ReadEnhancement;
-                    target?: EnhancedStringRead;
                     draggableX?: EnhancedNumberReadWrite;
                     draggableY?: EnhancedNumberReadWrite;
                     draggableZ?: EnhancedNumberReadWrite;
@@ -2047,6 +2048,7 @@ export interface DomainSpecification {
                         thumbnailUrl?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         recipes: {
                             type: EnhancedStringRead;
+                            id: string | ReadEnhancement;
                             [k: string]: unknown;
                         }[] | ReadEnhancement;
                     }[] | ReadEnhancement;
@@ -2790,7 +2792,7 @@ export interface DomainSpecification {
                 [k: string]: {
                     fileUrl: EnhancedStringRead;
                     name: EnhancedStringRead;
-                    type: EnhancedStringRead;
+                    type: 'reversable' | ReadEnhancement;
                     timeScale: EnhancedNumberRead;
                     $filter?: ComponentSystemFilter;
                 } | {
@@ -2875,15 +2877,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -2913,7 +2915,6 @@ export interface DomainSpecification {
                     frustumSize?: EnhancedNumberRead;
                     near?: EnhancedNumberRead;
                     far?: EnhancedNumberRead;
-                    focus?: EnhancedNumberRead;
                     distance?: EnhancedNumberRead;
                     minDistance?: EnhancedNumberRead;
                     maxDistance?: EnhancedNumberRead;
@@ -2934,15 +2935,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -2989,15 +2990,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -3047,15 +3048,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -3102,15 +3103,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -3138,7 +3139,6 @@ export interface DomainSpecification {
                     frustumSize?: EnhancedNumberRead;
                     near?: EnhancedNumberRead;
                     far?: EnhancedNumberRead;
-                    focus?: EnhancedNumberRead;
                     distance?: EnhancedNumberRead;
                     minDistance?: EnhancedNumberRead;
                     maxDistance?: EnhancedNumberRead;
@@ -3159,15 +3159,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -3212,15 +3212,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -3271,15 +3271,15 @@ export interface DomainSpecification {
                     dollyDragInverted?: EnhancedBooleanRead;
                     truckSpeed?: EnhancedNumberRead;
                     mouseButtons?: {
-                        left: EnhancedNumberRead;
-                        middle: EnhancedNumberRead;
-                        right: EnhancedNumberRead;
-                        wheel?: EnhancedNumberRead;
+                        left: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        middle: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        right: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
+                        wheel: (0 | 1 | 2 | 4 | 8 | 16) | ReadEnhancement;
                     } | ReadEnhancement;
                     touches?: {
-                        one: EnhancedNumberRead;
-                        two: EnhancedNumberRead;
-                        three?: EnhancedNumberRead;
+                        one: (0 | 8 | 16 | 32 | 64 | 128) | ReadEnhancement;
+                        two: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
+                        three: (0 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768) | ReadEnhancement;
                     } | ReadEnhancement;
                     boundaryEnclosesCamera?: EnhancedBooleanRead;
                     dollyToCursor?: EnhancedBooleanRead;
@@ -4081,6 +4081,7 @@ export interface DomainSpecification {
                         thumbnailUrl?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         recipes: {
                             type: EnhancedStringRead;
+                            id: string | ReadEnhancement;
                             [k: string]: unknown;
                         }[] | ReadEnhancement;
                     }[] | ReadEnhancement;
@@ -4121,6 +4122,7 @@ export interface DomainSpecification {
                         thumbnailUrl?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         recipes: {
                             type: EnhancedStringRead;
+                            id: string | ReadEnhancement;
                             [k: string]: unknown;
                         }[] | ReadEnhancement;
                     }[] | ReadEnhancement;
@@ -4232,13 +4234,13 @@ export interface DomainSpecification {
                     labelPrefixFontColor?: (string | number) | ReadEnhancement;
                     targetEntityOffsetAnchors: string[] | ReadEnhancement;
                     targetReferenceOffsetAnchors: string[] | ReadEnhancement;
-                    referenceEntityIds?: string[] | ReadEnhancement;
+                    referenceEntityIds?: (DomainEntityId[] | null) | ReadEnhancement;
                     directionVector: {
                         x?: EnhancedNumberRead;
                         y?: EnhancedNumberRead;
                         z?: EnhancedNumberRead;
                     } | ReadEnhancement;
-                    directionVectorRelativeToEntityId?: EnhancedStringRead;
+                    directionVectorRelativeToEntityId?: (string | null) | ReadEnhancement;
                     maxDistance?: (number | null) | ReadEnhancement;
                     minDistance?: (number | null) | ReadEnhancement;
                     maxPerpendicularDistance?: (number | null) | ReadEnhancement;
@@ -4518,7 +4520,7 @@ export interface DomainSpecification {
             };
             attributeSwitch?: {
                 [k: string]: {
-                    value: (string | number | boolean) | ReadWriteEnhancement;
+                    value: EnhancedBooleanReadWrite;
                     $filter?: ComponentSystemFilter;
                 } | {
                     $read: string;
@@ -4527,13 +4529,14 @@ export interface DomainSpecification {
             };
             childEntitySelection?: {
                 [k: string]: {
-                    value: EnhancedStringRead;
+                    value: string | ReadEnhancement;
                     options: {
                         label: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         description?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         img?: (string | EnhancedMessageDescriptor | MultilingualString) | ReadEnhancement;
                         recipes: {
                             type: EnhancedStringRead;
+                            id: string | ReadEnhancement;
                             [k: string]: unknown;
                         }[] | ReadEnhancement;
                         keepChildren?: EnhancedBooleanRead;
@@ -4900,13 +4903,13 @@ export interface DomainSpecification {
                     labelPrefixFontColor?: (string | number) | ReadEnhancement;
                     targetEntityOffsetAnchors: string[] | ReadEnhancement;
                     targetReferenceOffsetAnchors: string[] | ReadEnhancement;
-                    referenceEntityIds?: string[] | ReadEnhancement;
+                    referenceEntityIds?: (DomainEntityId[] | null) | ReadEnhancement;
                     directionVector: {
                         x?: EnhancedNumberRead;
                         y?: EnhancedNumberRead;
                         z?: EnhancedNumberRead;
                     } | ReadEnhancement;
-                    directionVectorRelativeToEntityId?: EnhancedStringRead;
+                    directionVectorRelativeToEntityId?: (string | null) | ReadEnhancement;
                     maxDistance?: (number | null) | ReadEnhancement;
                     minDistance?: (number | null) | ReadEnhancement;
                     maxPerpendicularDistance?: (number | null) | ReadEnhancement;
@@ -5224,7 +5227,6 @@ export interface DomainSpecification {
                         } | ReadEnhancement;
                         constant: EnhancedNumberRead;
                     }[] | ReadEnhancement;
-                    target?: EnhancedStringRead;
                     handleSize?: EnhancedNumberRead;
                     variant?: ('point' | 'fab') | ReadEnhancement;
                     icon?: EnhancedStringRead;
@@ -5307,7 +5309,18 @@ export interface DomainSpecification {
                     violations: {
                         type: EnhancedStringRead;
                         severity: ('fatal' | 'fixable' | 'warning' | 'notice') | ReadEnhancement;
-                        message?: EnhancedStringRead;
+                        message?: (string | {
+                            id: EnhancedStringRead;
+                            comment?: EnhancedStringRead;
+                            message?: EnhancedStringRead;
+                            values?: {
+                                [k: string]: unknown;
+                            } | ReadEnhancement;
+                        } | {
+                            $lang: {
+                                [k: string]: EnhancedStringRead;
+                            } | ReadEnhancement;
+                        }) | ReadEnhancement;
                         controlViolationPriority?: EnhancedNumberRead;
                     }[] | ReadEnhancement;
                     $filter?: ComponentSystemFilter;

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

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