@salsita-ai/sdk 0.50.0-develop.bb71259564 → 0.50.0-develop.bc204720a8

package/dist/application-spec/generate-application/code/templates/admin-config.js

@@ -1,5 +1,6 @@
-import{autoHeader as n}from"../common/file-headers.js";export const generateApplicationSpecAdminConfig=()=>`${n("admin-config.ts","Admin configurator config — builds admin interface and wires admin components/elements.")}
+import{autoHeader as n}from"../common/file-headers.js";export const generateApplicationSpecAdminConfig=t=>`${n("admin-config.ts","Admin configurator config — builds admin interface and wires admin components/elements.")}
 import { defaultAdminElements } from '@salsita-ai/sdk/admin'
+${t?"import { CognitoSignInPage } from '@salsita-ai/sdk/extras/cognito'":""}
 
 import { configuratorConfig } from './configurator-config.js'
 import { adminInterface } from './admin-globals.js'
@@ -11,6 +12,6 @@ export const adminConfig = configuratorConfig
   .withInterface(adminInterface)
   .withAdminComponentOptics(customAdminComponentOptics)
   .withAdminComponentOptics(customFrontendAdminComponentOptics)
-  .withDefaultElements(defaultAdminElements)
+  .withDefaultElements(${t?"[...defaultAdminElements.filter(element => element.name !== 'NotAuthorizedAdminPage'), adminInterface.createNotAuthorizedAdminPage(CognitoSignInPage)]":"defaultAdminElements"})
   .withElements([...customElements, ...customAdminElements])
 `;

package/dist/application-spec/generate-application/code/templates/configurator-config.js

@@ -14,6 +14,7 @@ import{autoHeader as e}from"../common/file-headers.js";export const generateAppl
   })`;return`${e("configurator-config.ts","Configurator config — builds the interface and wires handlers, elements, transformers, components and theme.")}
 import { getPhoenixThemes } from '@salsita-ai/sdk/ui'
 import { defaultConfiguratorElements } from '@salsita-ai/sdk/configurator'
+${t.appMetadata.useCognito?"import { CognitoSignInPage } from '@salsita-ai/sdk/extras/cognito'":""}
 
 // Import order matters — each step sets globals needed by the next:
 // 1. domain.js → domain-spec.ts runs → sets phx.domain
@@ -29,7 +30,7 @@ export const configuratorConfig = configuratorBuilder
   .withComponentOptics(customComponentOptics)
   .withComponentOptics(customFrontendComponentOptics)
   .withHandlers(customHandlers)
-  .withDefaultElements(defaultConfiguratorElements)
+  .withDefaultElements(${t.appMetadata.useCognito?"[...defaultConfiguratorElements.filter(element => element.name !== 'NotAuthenticatedPage'), configuratorInterface.createNotAuthenticatedPage(CognitoSignInPage)]":"defaultConfiguratorElements"})
   .withElements(customElements)
   .withTransformers(customTransformers, ${JSON.stringify(n)})${r}
   ${(e=>{let{theme:t}=e.configurator;return Object.keys(t.options).length>0?`.withTheme({ ...getPhoenixThemes().${t.preset}, ...${JSON.stringify(t.options)} })`:`.withTheme(getPhoenixThemes().${t.preset})`})(t)}${(e=>{let{ui:t}=e.configurator,o=[];return(void 0!==t.preview&&o.push(`preview: '${t.preview}'`),void 0!==t.alwaysExpand&&o.push(`alwaysExpand: ${t.alwaysExpand}`),void 0!==t.appLoader&&o.push(`appLoader: '${t.appLoader}'`),0===o.length)?"":`

package/dist/application-spec/generate-application/code/templates/domain-spec/factory-types/domain-factory-types.d.ts

@@ -11,8 +11,8 @@ export interface DomainFactoryTypes {
     readonly typeArguments: string;
     /** What the domain runtime adds to the expression context. */
     readonly contextExtension: string;
-    /** The systems the domain runtime hands to an action. */
-    readonly systems: string;
+    /** Project types and the host extension contract supplied to the runtime action factory. */
+    readonly actionTypeArguments: string;
     /** The type of the domain's `model`: one reflection per entity, alias, common type and shape. */
     readonly modelType: string;
     /** The type of the domain's `enhancedModel`: one enhanced reflection per entity and alias. */
@@ -26,10 +26,11 @@ interface DomainFactoryTypesSpec {
     readonly latestModel: ModelVersion;
     readonly expressions: Expressions;
 }
-/**
- * Builds the type strings of a domain.
- *
- * @param typePrefix The namespace the domain's types live in (`Admin` for the admin domain), or `''`.
- */
-export declare const getDomainFactoryTypes: (domainSpec: DomainFactoryTypesSpec, typePrefix: string) => DomainFactoryTypes;
+/** The domain's type namespace and whether its factories belong to the admin domain. */
+interface DomainFactoryTypesOptions {
+    readonly typePrefix: string;
+    readonly isAdmin: boolean;
+}
+/** Builds the type strings of a domain; namespace qualification and domain capabilities are explicit. */
+export declare const getDomainFactoryTypes: (domainSpec: DomainFactoryTypesSpec, options: DomainFactoryTypesOptions) => DomainFactoryTypes;
 export {};

package/dist/application-spec/generate-application/code/templates/domain-spec/factory-types/domain-factory-types.js

@@ -1,5 +1,5 @@
-export const getDomainFactoryTypes=(e,t)=>{let n=t?`${t}.`:"",{entityTypes:a}=e.latestModel,o=[...e.latestModel.aliases].map(([e])=>String(e)),i=[...e.latestModel.commonTypes],$=[...e.latestModel.shapes].map(([e])=>`${e}Shape`),s=new Map([...e.expressions.constants].map(([e,t])=>[String(e),t])),l=(e,t)=>{let a=[...s.get(t)?.keys()??[]],o=a.length>0?`, ${a.map(e=>`'${e}'`).join(" | ")}`:"";return`${e}<${n}$${t}${o}>`},m=[...a.map(e=>`  readonly ${String(e)}: DomainEntityReflection<${n}${String(e)}>`),...o.map(e=>`  readonly ${e}: RawAliasReflection<${n}${e}>`),...i.map(([e,t])=>{let a,o=(a=t.schema.enum,a?.length&&a.every(e=>"string"==typeof e))?"EnumLike":"SchemaReflection";return`  readonly ${e}: ${o}<${n}${e}>`}),...$.map(e=>`  readonly ${e}: SchemaReflection<unknown>`)].join("\n"),r=[...a.map(e=>`  readonly $${String(e)}: ${l("$DomainEntityReflection",String(e))}`),...o.map(e=>`  readonly $${e}: ${l("EnhancedAliasReflection",e)}`)].join("\n");return{typeArguments:`${n}AnyDomainEntity, ${n}RootEntity, ${n}$Map, PublishedData, SessionData, FrontendData, ${n}Aliases`,contextExtension:`RuntimeExpressionContext<${n}AnyDomainEntity>`,systems:`DomainContextSystems<${n}AnyDomainEntity, ${n}RootEntity, ${n}$Map, NavigationState, ViewState, ToolState, ExportState>`,modelType:`{
+export const getDomainFactoryTypes=(t,e)=>{let{typePrefix:n,isAdmin:a}=e,o=n?`${n}.`:"",{entityTypes:i}=t.latestModel,$=[...t.latestModel.aliases].map(([t])=>String(t)),s=[...t.latestModel.commonTypes],l=[...t.latestModel.shapes].map(([t])=>`${t}Shape`),r=new Map([...t.expressions.constants].map(([t,e])=>[String(t),e])),y=(t,e)=>{let n=[...r.get(e)?.keys()??[]],a=n.length>0?`, ${n.map(t=>`'${t}'`).join(" | ")}`:"";return`${t}<${o}$${e}${a}>`},m=[...i.map(t=>`  readonly ${String(t)}: DomainEntityReflection<${o}${String(t)}>`),...$.map(t=>`  readonly ${t}: RawAliasReflection<${o}${t}>`),...s.map(([t,e])=>{let n,a=(n=e.schema.enum,n?.length&&n.every(t=>"string"==typeof t))?"EnumLike":"SchemaReflection";return`  readonly ${t}: ${a}<${o}${t}>`}),...l.map(t=>`  readonly ${t}: SchemaReflection<unknown>`)].join("\n"),p=[...i.map(t=>`  readonly $${String(t)}: ${y("$DomainEntityReflection",String(t))}`),...$.map(t=>`  readonly $${t}: ${y("EnhancedAliasReflection",t)}`)].join("\n");return{typeArguments:`${o}AnyDomainEntity, ${o}RootEntity, ${o}$Map, PublishedData, SessionData, FrontendData, ${o}Aliases`,contextExtension:`RuntimeExpressionContext<${o}AnyDomainEntity>`,actionTypeArguments:`${o}AnyDomainEntity, ${o}RootEntity, ${o}$Map, NavigationState, ViewState, ToolState, ExportState, PublishedData, SessionData, FrontendData, ActionTypes${a?"":`, ConfiguratorExtensionSystems<${o}AnyDomainEntity, ${o}RootEntity, ${o}$Map, NavigationState, ViewState, ToolState, ExportState>`}`,modelType:`{
 ${m}
 }`,enhancedModelType:`{
-${r}
-}`,enhancedReflectionType:l}};
+${p}
+}`,enhancedReflectionType:y}};

package/dist/application-spec/generate-application/code/templates/domain-spec/generate-base-configurator-builder.js

@@ -1,4 +1,4 @@
-import{CodeImports as t,skipApplicationTypeImports as e}from"../../common/index.js";import{generateAclCall as a}from"./generate-acl.js";import{generatePresetsCode as i}from"./generate-presets.js";import{generateResourcesConfigCall as n}from"./generate-resources-config.js";import{generateResourcesCodegen as o}from"./generate-resources.js";import{generateTextLanguagesCall as r}from"./generate-text-languages.js";export const generateBaseConfiguratorBuilder=(s,l=new t,m=e)=>{m(l,["AnyDomainEntity","RootEntity","$Map","PublishedData","SessionData","FrontendData","Admin","PrefetchedFinalizeData","FinalizeData","FinalizeResult","CallbackData"]);let d=o(s),h=r(s),p=a(s),c=n(s),u=i(s.configurator.presets,s.configurator.latestModel,""),w=i(s.admin.presets,s.admin.latestModel,"Admin")??"[]",D=u?`
+import{CodeImports as t,skipApplicationTypeImports as e}from"../../common/index.js";import{generateAclCall as a}from"./generate-acl.js";import{generatePresetsCode as i}from"./generate-presets.js";import{generateResourcesConfigCall as n}from"./generate-resources-config.js";import{generateResourcesCodegen as o}from"./generate-resources.js";import{generateTextLanguagesCall as r}from"./generate-text-languages.js";export const generateBaseConfiguratorBuilder=(s,l=new t,m=e)=>{m(l,["AnyDomainEntity","RootEntity","$Map","PublishedData","SessionData","FrontendData","Admin","PrefetchedFinalizeData","FinalizeData","FinalizeResult","CallbackData","ActionTypes"]);let d=o(s),h=r(s),p=a(s),c=n(s),u=i(s.configurator.presets,s.configurator.latestModel,""),w=i(s.admin.presets,s.admin.latestModel,"Admin")??"[]",D=u?`
   .withPresets(${u} as never)`:"",g=`
   .withAdminPresets(${w} as never)`,f=`export const baseConfiguratorBuilder = new ConfiguratorBuilder<
   AnyDomainEntity,
@@ -8,6 +8,7 @@ import{CodeImports as t,skipApplicationTypeImports as e}from"../../common/index.
   PublishedData,
   SessionData,
   FrontendData,
+  ActionTypes,
   Admin.AnyDomainEntity,
   Admin.RootEntity,
   Admin.$Map

package/dist/application-spec/generate-application/code/templates/domain-spec/generate-domain-block.js

@@ -1,7 +1,7 @@
-import{skipApplicationTypeImports as e}from"../../common/index.js";import{getDomainFactoryTypes as n}from"./factory-types/index.js";import{generateComponentOpticsCode as t}from"./generate-component-optics.js";import{generateDefaultsBlock as a}from"./generate-defaults.js";import{generateInvariantsBlock as o}from"./generate-invariants.js";import{generateRelationExpressionsCode as i}from"./generate-relation-expressions.js";import{generateStaticValueCode as s}from"./generate-static-value-code.js";import{generateValueExpressionsCode as r}from"./generate-value-expressions.js";let m="@salsita-ai/sdk/domain",l=(e,n,t)=>{let a=[],o=[];for(let i of e.modelVersion.entitySchemas){let e=JSON.stringify(i.shapeSchema,null,2);a.push(`${t}const ${i.entityType} = new DomainEntityReflection<${n}${i.entityType}>('${i.entityType}', [${e}])`),o.push(String(i.entityType))}return{entityDecls:a.join("\n"),entityNames:o}};export const generateDomainBlock=p=>{let{domainSpec:c,invariants:$,actions:d,typePrefix:u,versionNsPrefix:y,isAdmin:h,modelVersionsExportName:f,relationExpressionsExportName:D,componentOpticsExportName:S,valueExpressionsExportName:E,createRecipeExportName:A,imports:R,registerApplicationTypeImports:x=e}=p;R.addImport(m,"$DomainEntityReflection"),R.addImport(m,"DomainBuilder"),R.addImport(m,"DomainComponentOpticBuilder"),R.addImport(m,"DomainEntityReflection"),R.addImport(m,"EnhancedAliasReflection"),R.addImport(m,"RawAliasReflection"),R.addImport(m,"SchemaReflection"),R.addImport(m,"createCustomExpressionFactory"),R.addImport(m,"createCustomInvariantFactory"),h&&(R.addImport(m,"commonAdminCustomExpressions"),R.addImport(m,"commonAdminViolationExpressions"),R.addImport(m,"createMapPublishedRevisionDataHandlerFactory"),R.addImport(m,"createMapPublishedChunkedDataHandlerFactory"),R.addImport(m,"createDataRowValidatorHandler"),R.addImport(m,"createSheetValidatorHandler")),h||R.addImport(m,"createAssistantSetupHandlerFactory"),R.addTypeImport(m,"RuntimeExpressionContext"),R.addTypeImport(m,"SchemaOfObject"),d&&(R.addImport(m,"createActionFactory"),R.addTypeImport(m,"ActionDefinition"),R.addTypeImport(m,"DomainContextSystems"));let{entityTypes:g,entitySchemas:v}=c.latestModel,I=[...c.latestModel.aliases],j=I.map(([e])=>String(e)),C=j.includes("RootEntity")?"RootEntity":"AnyDomainEntity",{resolvedVersions:M}=c,H=M.latestVersion,F=u?`${u}.`:"",P=new Map([...c.expressions.constants].map(([e,n])=>[String(e),n])),b=n(c,u),{enhancedReflectionType:w}=b,T=e=>{let n=P.get(e);if(!n)return"{}";let t=[...n].map(([e,n])=>{let t=s(n,R).replaceAll("\n","\n    ");return`    ${e}: ${t},`});return`{
+import{skipApplicationTypeImports as e}from"../../common/index.js";import{getDomainFactoryTypes as n}from"./factory-types/index.js";import{generateComponentOpticsCode as t}from"./generate-component-optics.js";import{generateDefaultsBlock as a}from"./generate-defaults.js";import{generateInvariantsBlock as o}from"./generate-invariants.js";import{generateRelationExpressionsCode as i}from"./generate-relation-expressions.js";import{generateStaticValueCode as s}from"./generate-static-value-code.js";import{generateValueExpressionsCode as r}from"./generate-value-expressions.js";let m="@salsita-ai/sdk/domain",l=(e,n,t)=>{let a=[],o=[];for(let i of e.modelVersion.entitySchemas){let e=JSON.stringify(i.shapeSchema,null,2);a.push(`${t}const ${i.entityType} = new DomainEntityReflection<${n}${i.entityType}>('${i.entityType}', [${e}])`),o.push(String(i.entityType))}return{entityDecls:a.join("\n"),entityNames:o}};export const generateDomainBlock=p=>{let{domainSpec:c,invariants:$,actions:d,typePrefix:u,versionNsPrefix:y,isAdmin:h,modelVersionsExportName:f,relationExpressionsExportName:S,componentOpticsExportName:D,valueExpressionsExportName:E,createRecipeExportName:g,imports:A,registerApplicationTypeImports:x=e}=p;A.addImport(m,"$DomainEntityReflection"),A.addImport(m,"DomainBuilder"),A.addImport(m,"DomainComponentOpticBuilder"),A.addImport(m,"DomainEntityReflection"),A.addImport(m,"EnhancedAliasReflection"),A.addImport(m,"RawAliasReflection"),A.addImport(m,"SchemaReflection"),A.addImport(m,"createCustomExpressionFactory"),A.addImport(m,"createCustomInvariantFactory"),h&&(A.addImport(m,"commonAdminCustomExpressions"),A.addImport(m,"commonAdminViolationExpressions"),A.addImport(m,"createMapPublishedRevisionDataHandlerFactory"),A.addImport(m,"createMapPublishedChunkedDataHandlerFactory"),A.addImport(m,"createDataRowValidatorHandler"),A.addImport(m,"createSheetValidatorHandler")),h||A.addImport(m,"createAssistantSetupHandlerFactory"),A.addTypeImport(m,"RuntimeExpressionContext"),A.addTypeImport(m,"SchemaOfObject"),d&&(A.addImport(m,"createActionFactory"),A.addTypeImport(m,"ActionDefinition"),A.addTypeImport("@salsita-ai/sdk/configurator","ConfiguratorExtensionSystems"));let{entityTypes:R,entitySchemas:v}=c.latestModel,I=[...c.latestModel.aliases],j=I.map(([e])=>String(e)),C=j.includes("RootEntity")?"RootEntity":"AnyDomainEntity",{resolvedVersions:M}=c,H=M.latestVersion,F=u?`${u}.`:"",P=new Map([...c.expressions.constants].map(([e,n])=>[String(e),n])),b=n(c,{typePrefix:u,isAdmin:h}),{enhancedReflectionType:w}=b,T=e=>{let n=P.get(e);if(!n)return"{}";let t=[...n].map(([e,n])=>{let t=s(n,A).replaceAll("\n","\n    ");return`    ${e}: ${t},`});return`{
 ${t.join("\n")}
-  }`},k=v.map(e=>{let n=JSON.stringify(e.shapeSchema,null,2);return`  const ${e.entityType} = new DomainEntityReflection<${F}${e.entityType}>('${e.entityType}', [${n}])`}),O=I.map(([e,n])=>{let t=n.map(String).join(", ");return`  const ${e} = new RawAliasReflection<${F}${e}>('${e}', [${t}])`}),V=[...c.latestModel.commonTypes],B=V.map(([e])=>String(e)),N=M.versionedModels.filter(e=>!e.isLatest).map(e=>`${y}${e.version}`);x(R,[...h?["Admin",...N]:[...g.map(String),...j,...B,...g.map(e=>`$${String(e)}`),...j.map(e=>`$${e}`),"Aliases","$Map",...N,...d?["ActionTypes","NavigationState","ViewState","ToolState","ExportState"]:[]],"PublishedData","SessionData","FrontendData",...h?[]:["BackendData"]]);let J=V.map(([e,n])=>{let t=JSON.stringify(n.runtimeSchema,null,2);return n.schema.enum?.length&&n.schema.enum.every(e=>"string"==typeof e)?`  const ${e}: EnumLike<${F}${e}> = new EnumReflection('${e}', ${t}) as EnumLike<${F}${e}>`:`  const ${e}: SchemaReflection<${F}${e}> = new SchemaReflection('${e}', ${t})`}),L=[...c.latestModel.shapes],_=L.map(([e,n])=>{let t=JSON.stringify(n.runtimeSchema,null,2);return`  const ${e}Shape = new SchemaReflection('${e}Shape', ${t})`}),z=L.map(([e])=>`${e}Shape`),G=j.map(e=>`    ${e}: ${e}.types,`).join("\n"),q=j.map(e=>`    ${e},`).join("\n"),K=B.map(e=>`    ${e},`).join("\n"),Q=z.map(e=>`    ${e},`).join("\n"),U=g.map(e=>`    ${e},`).join("\n"),W=[];for(let[e,n]of c.expressions.expressions)n.size>0&&W.push(`  const ${e}Expressions = ${JSON.stringify([...n.keys()])}`);let X=g.map(e=>{let n=c.expressions.entityExpressions.get(e),t=(n?.shapeGroups??[]).map(e=>`${e}Expressions`),a=t.length>0?t.map(e=>`...${e}`).join(", "):"",o=w("$DomainEntityReflection",String(e));return`  const $${e}: ${o} = new ${o}('${e}', [${a}], ${T(String(e))})`}).join("\n"),Y=g.map(e=>`    ${e}: $${e},`).join("\n"),Z=I.map(([e,n])=>{let t=n.map(e=>JSON.stringify(String(e))).join(", "),a=w("EnhancedAliasReflection",String(e));return`  const $${e}: ${a} = new ${a}('$${e}', [${t}], ${T(String(e))})`}).join("\n"),ee=[...g.map(String),...j].map(e=>`    $${e},`).join("\n"),en=[],et=[];for(let e of M.versionedModels)if(e.isLatest)en.push(`  ${e.version}: entities,`),et.push(`  readonly ${e.version}: {
-${g.map(e=>`    readonly ${String(e)}: DomainEntityReflection<${F}${String(e)}>`).join("\n")}
+  }`},k=v.map(e=>{let n=JSON.stringify(e.shapeSchema,null,2);return`  const ${e.entityType} = new DomainEntityReflection<${F}${e.entityType}>('${e.entityType}', [${n}])`}),O=I.map(([e,n])=>{let t=n.map(String).join(", ");return`  const ${e} = new RawAliasReflection<${F}${e}>('${e}', [${t}])`}),V=[...c.latestModel.commonTypes],B=V.map(([e])=>String(e)),N=M.versionedModels.filter(e=>!e.isLatest).map(e=>`${y}${e.version}`);x(A,[...h?["Admin",...N]:[...R.map(String),...j,...B,...R.map(e=>`$${String(e)}`),...j.map(e=>`$${e}`),"Aliases","$Map",...N,...d?["ActionTypes","NavigationState","ViewState","ToolState","ExportState"]:[]],"PublishedData","SessionData","FrontendData",...h?[]:["BackendData"]]);let J=V.map(([e,n])=>{let t=JSON.stringify(n.runtimeSchema,null,2);return n.schema.enum?.length&&n.schema.enum.every(e=>"string"==typeof e)?`  const ${e}: EnumLike<${F}${e}> = new EnumReflection('${e}', ${t}) as EnumLike<${F}${e}>`:`  const ${e}: SchemaReflection<${F}${e}> = new SchemaReflection('${e}', ${t})`}),L=[...c.latestModel.shapes],_=L.map(([e,n])=>{let t=JSON.stringify(n.runtimeSchema,null,2);return`  const ${e}Shape = new SchemaReflection('${e}Shape', ${t})`}),z=L.map(([e])=>`${e}Shape`),G=j.map(e=>`    ${e}: ${e}.types,`).join("\n"),q=j.map(e=>`    ${e},`).join("\n"),K=B.map(e=>`    ${e},`).join("\n"),Q=z.map(e=>`    ${e},`).join("\n"),U=R.map(e=>`    ${e},`).join("\n"),W=[];for(let[e,n]of c.expressions.expressions)n.size>0&&W.push(`  const ${e}Expressions = ${JSON.stringify([...n.keys()])}`);let X=R.map(e=>{let n=c.expressions.entityExpressions.get(e),t=(n?.shapeGroups??[]).map(e=>`${e}Expressions`),a=t.length>0?t.map(e=>`...${e}`).join(", "):"",o=w("$DomainEntityReflection",String(e));return`  const $${e}: ${o} = new ${o}('${e}', [${a}], ${T(String(e))})`}).join("\n"),Y=R.map(e=>`    ${e}: $${e},`).join("\n"),Z=I.map(([e,n])=>{let t=n.map(e=>JSON.stringify(String(e))).join(", "),a=w("EnhancedAliasReflection",String(e));return`  const $${e}: ${a} = new ${a}('$${e}', [${t}], ${T(String(e))})`}).join("\n"),ee=[...R.map(String),...j].map(e=>`    $${e},`).join("\n"),en=[],et=[];for(let e of M.versionedModels)if(e.isLatest)en.push(`  ${e.version}: entities,`),et.push(`  readonly ${e.version}: {
+${R.map(e=>`    readonly ${String(e)}: DomainEntityReflection<${F}${String(e)}>`).join("\n")}
   }`);else{let n=`${y}${e.version}.`,{entityDecls:t,entityNames:a}=l(e,n,"    "),o=a.map(e=>`      ${e},`).join("\n");en.push(`  ${e.version}: (() => {
 ${t}
     return {
@@ -9,21 +9,21 @@ ${o}
     } as const
   })(),`),et.push(`  readonly ${e.version}: {
 ${a.map(e=>`    readonly ${e}: DomainEntityReflection<${n}${e}>`).join("\n")}
-  }`)}let ea=h?"adminDomainBuilder":"domainBuilder",eo=h?"attachAdminComponent":"attachComponent",ei=h?"implementAdminCustomExpressions":"implementCustomExpressions",es=h?"implementCustomAdminInvariants":"implementCustomInvariants",er=h?"adminAliases":"aliases",em=h?"adminModel":"model",el=h?"adminEnhancedModel":"enhancedModel",ep=h?"implementAdminRelation":"implementRelation",ec=h?"__adminDomain":"__configuratorDomain",e$=b.typeArguments,ed=`<${e$}>`,{contextExtension:eu,systems:ey}=b,eh=`<${e$}, ${eu}>`,ef=o($,e$,eu,R),eD=(e,n)=>e===n?e:`${e}: ${n}`,eS=[...c.expressions.expressions.values()].some(e=>[...e.values()].some(e=>"relation"===e.implementation.kind));eS&&R.addImport(m,"createRelationFactory");let eE=eS?`
+  }`)}let ea=h?"adminDomainBuilder":"domainBuilder",eo=h?"attachAdminComponent":"attachComponent",ei=h?"implementAdminCustomExpressions":"implementCustomExpressions",es=h?"implementCustomAdminInvariants":"implementCustomInvariants",er=h?"adminAliases":"aliases",em=h?"adminModel":"model",el=h?"adminEnhancedModel":"enhancedModel",ep=h?"implementAdminRelation":"implementRelation",ec=h?"__adminDomain":"__configuratorDomain",e$=b.typeArguments,ed=`<${e$}>`,{contextExtension:eu}=b,ey=`<${e$}, ${eu}>`,eh=o($,e$,eu,A),ef=(e,n)=>e===n?e:`${e}: ${n}`,eS=[...c.expressions.expressions.values()].some(e=>[...e.values()].some(e=>"relation"===e.implementation.kind));eS&&A.addImport(m,"createRelationFactory");let eD=eS?`
   const ${ep} = createRelationFactory(aliases)
 
-  const relationExpressions = ${i(c.expressions,ep)}`:"\n  const relationExpressions = {} as const",eA=`
-  const componentOptics = ${t(c.components,R)}`,eR=`
-  const valueExpressions = ${r(c.expressions,R,"implementCustomExpressions",h?{PresetCategory:"commonAdminCustomExpressions.PresetCategory"}:{})}`;R.addImport(m,"createRecipeFactory");let ex=a(c.defaults,R),eg=[...d?.values()??[]].map(e=>({name:String(e.name),...void 0===e.description?{}:{description:e.description},params:e.paramsSchema})),ev=d?`
-  const actionDefinitions: readonly ActionDefinition[] = ${JSON.stringify(eg,null,2).replaceAll("\n","\n  ")}
+  const relationExpressions = ${i(c.expressions,ep)}`:"\n  const relationExpressions = {} as const",eE=`
+  const componentOptics = ${t(c.components,A)}`,eg=`
+  const valueExpressions = ${r(c.expressions,A,"implementCustomExpressions",h?{PresetCategory:"commonAdminCustomExpressions.PresetCategory"}:{})}`;A.addImport(m,"createRecipeFactory");let eA=a(c.defaults,A),ex=[...d?.values()??[]].map(e=>({name:String(e.name),...void 0===e.description?{}:{description:e.description},params:e.paramsSchema})),eR=d?`
+  const actionDefinitions: readonly ActionDefinition[] = ${JSON.stringify(ex,null,2).replaceAll("\n","\n  ")}
 
-  const implementActions = createActionFactory<${F}AnyDomainEntity, ${F}RootEntity, PublishedData, SessionData, FrontendData, ActionTypes, ${eu}, ${ey}>()`:"",eI=`
-  const createRecipe = createRecipeFactory<${F}AnyDomainEntity>(aliases, AnyDomainEntity.reflections, defaults)`,{modelType:ej,enhancedModelType:eC}=b,eM=`{
+  const implementActions = createActionFactory<${b.actionTypeArguments}>()`:"",ev=`
+  const createRecipe = createRecipeFactory<${F}AnyDomainEntity>(aliases, AnyDomainEntity.reflections, defaults)`,{modelType:eI,enhancedModelType:ej}=b,eC=`{
 ${et.join("\n")}
 }`;return`const ${ec} = (() => {
   const modelVersion = ${H}
 
-  ${ex}
+  ${eA}
 
 ${k.join("\n")}
 
@@ -59,22 +59,22 @@ ${Y}
 ${ee}
   } as const
 
-  const implementCustomExpressions = createCustomExpressionFactory${eh}()
-${ev}${eE}
-${eR}
+  const implementCustomExpressions = createCustomExpressionFactory${ey}()
+${eR}${eD}
+${eg}
 
   const modelVersions = {
 ${en.join("\n")}
   } as const
-  const attachComponent = DomainComponentOpticBuilder.from${eh}(aliases)
+  const attachComponent = DomainComponentOpticBuilder.from${ey}(aliases)
 
-${ef}
+${eh}
 ${h?`  const commonInvariants = implementCustomInvariants(commonAdminViolationExpressions)
 
   const createMapPublishedRevisionDataHandler = createMapPublishedRevisionDataHandlerFactory<${F}AnyDomainEntity, ${F}RootEntity, ${F}$Map, PublishedData>()
   const createMapPublishedChunkedDataHandler = createMapPublishedChunkedDataHandlerFactory<${F}AnyDomainEntity, ${F}RootEntity, ${F}$Map>()
-`:"\n  const createAssistantSetupHandler = createAssistantSetupHandlerFactory<SessionData, AnyDomainEntity, $Map, ActionTypes>()\n"}${eA}
-${eI}
+`:"\n  const createAssistantSetupHandler = createAssistantSetupHandlerFactory<SessionData, AnyDomainEntity, $Map, ActionTypes>()\n"}${eE}
+${ev}
 
   return {
     domainBuilder: DomainBuilder.from${ed}(
@@ -107,23 +107,23 @@ ${eI}
 })()
 
 const {
-  ${eD("domainBuilder",ea)},
-  ${eD("attachComponent",eo)},
-  ${eD("implementCustomExpressions",ei)},
-  ${eD("implementCustomInvariants",es)},
-  ${eD("aliases",er)},${h?`
+  ${ef("domainBuilder",ea)},
+  ${ef("attachComponent",eo)},
+  ${ef("implementCustomExpressions",ei)},
+  ${ef("implementCustomInvariants",es)},
+  ${ef("aliases",er)},${h?`
   commonInvariants: commonAdminInvariants,
   createMapPublishedRevisionDataHandler,
   createMapPublishedChunkedDataHandler,`:`
   implementActions,
   createAssistantSetupHandler,`}
-  ${eD("relationExpressions",D)},
-  ${eD("valueExpressions",E)},
-  ${eD("componentOptics",S)},
-  ${eD("createRecipe",A)},
+  ${ef("relationExpressions",S)},
+  ${ef("valueExpressions",E)},
+  ${ef("componentOptics",D)},
+  ${ef("createRecipe",g)},
 } = ${ec}
 
-const ${em}: ${ej} = ${ec}.model
-const ${el}: ${eC} = ${ec}.enhancedModel
-const ${f}: ${eM} = ${ec}.modelVersions
-export { ${ea}, ${eo}, ${ei}, ${es}, ${er}, ${h?"commonAdminInvariants, ":""}${em}, ${el}, ${D}, ${E}, ${S}, ${f}, ${A}${h?", createMapPublishedRevisionDataHandler, createMapPublishedChunkedDataHandler, createDataRowValidatorHandler, createSheetValidatorHandler":", implementActions, createAssistantSetupHandler"} }`};
+const ${em}: ${eI} = ${ec}.model
+const ${el}: ${ej} = ${ec}.enhancedModel
+const ${f}: ${eC} = ${ec}.modelVersions
+export { ${ea}, ${eo}, ${ei}, ${es}, ${er}, ${h?"commonAdminInvariants, ":""}${em}, ${el}, ${S}, ${E}, ${D}, ${f}, ${g}${h?", createMapPublishedRevisionDataHandler, createMapPublishedChunkedDataHandler, createDataRowValidatorHandler, createSheetValidatorHandler":", implementActions, createAssistantSetupHandler"} }`};

package/dist/application-spec/generate-application/code/templates/domain-spec/generate-locale.js

@@ -2,4 +2,4 @@ export const generateLocaleCodegen=e=>{let a,s=e.length>0?`
 ${e.map(e=>`import { messages as ${e.replace(/-/g,"")} } from '../src/locales/${e}/messages.js'`).join("\n")}`:"";return{importBlock:s,catalogBlock:`${a=e.map(e=>{let a=e.replace(/-/g,"");return e.includes("-")?`  '${e}': ${a},`:`  ${a},`}).join("\n"),`const catalog = {
 ${a}
 }`}
-const messages = mergeCatalogs([sdkCatalog, catalog])`,createI18nExport:`export const createI18n = () => setupI18n({ messages, locale: '${e[0]}' })`}};
+const messages = mergeCatalogs([sdkCatalog, catalog], Object.keys(catalog))`,createI18nExport:`export const createI18n = () => setupI18n({ messages, locale: '${e[0]}' })`}};

package/dist/application-spec/generate-application/code/templates/editor.d.ts

@@ -1,2 +1,2 @@
 import type { MockTemplateDefinition } from '../../../mock-template-definition.js';
-export declare const generateApplicationSpecEditorFile: (tagName?: string, inlineTemplates?: boolean, mockTemplates?: readonly MockTemplateDefinition[], environmentSlug?: string) => string;
+export declare const generateApplicationSpecEditorFile: (tagName: string | undefined, inlineTemplates: boolean | undefined, mockTemplates: readonly MockTemplateDefinition[] | undefined, environmentSlug: string | undefined, hideUi: boolean) => string;

package/dist/application-spec/generate-application/code/templates/editor.js

@@ -1,4 +1,17 @@
-export const generateApplicationSpecEditorFile=(t="salsita-configurator",e=!1,o=[],r)=>{let i=r?` environmentKey="${r}"`:"";return e?`import { StrictMode } from 'react'
+export const generateApplicationSpecEditorFile=(t="salsita-configurator",e=!1,o=[],r,i)=>{let a=r?` environmentKey="${r}"`:"";return!e&&i?`import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+
+import { Editor, startConsoleCapture } from '@salsita-ai/sdk/editor'
+
+// Agent mode: the errors of a configurator that fails to start reach the terminal too
+startConsoleCapture()
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <Editor tagName="${t}"${a} hideUi />
+  </StrictMode>
+)
+`:e?`import { StrictMode } from 'react'
 import { createRoot } from 'react-dom/client'
 
 import { Editor, type MockTemplateDefinition } from '@salsita-ai/sdk/editor'
@@ -7,7 +20,7 @@ const mockTemplates: readonly MockTemplateDefinition[] = ${0===o.length?"[]":`[$
 
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
-    <Editor localMode tagName="${t}" mockTemplates={mockTemplates}${i} />
+    <Editor localMode tagName="${t}" mockTemplates={mockTemplates}${a} />
   </StrictMode>
 )
 `:`import { StrictMode } from 'react'
@@ -17,7 +30,7 @@ import { Editor } from '@salsita-ai/sdk/editor'
 
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
-    <Editor tagName="${t}"${i} />
+    <Editor tagName="${t}"${a} />
   </StrictMode>
 )
 `};

package/dist/application-spec/generate-application/code/templates/gitignore.js

@@ -48,7 +48,8 @@ phoenix-api.yaml
 *.blend1
 
 # Auto-generated files
-.phoenix
+**/.phoenix/*
+!**/.phoenix/workspace/
 **/locales/*/*.ts
 phoenix.config.ts
 .prettierignore

package/dist/application-spec/generate-application/code/templates/global-definition/generate-phx-types.js

@@ -1,18 +1,18 @@
-import{generateInvariantBlueprintMembers as e,getDomainFactoryTypes as t}from"../domain-spec/index.js";let a="@salsita-ai/sdk/configurator",n="CustomInvariantBlueprints",o="AdminCustomInvariantBlueprints",i=["authHandlerBuilder","webhookBuilder","taskFactory","finalizeHandlerBuilder","callbackBuilder","prefetchBuilder","dynamicResourcesFactory"],r=(e,t)=>e.replaceAll("\n",`
-${t}`),s=e=>{let t=(e.infra.resources??[]).map(e=>JSON.stringify(e.name));return["AnyDomainEntity","RootEntity","$Map","NavigationState","ViewState","ToolState","ExportState","PublishedData","SessionData","FrontendData","Admin.AnyDomainEntity","Admin.RootEntity","Admin.$Map","AdminNavigationState","never","FinalizeData","PrefetchedFinalizeData","FinalizeResult","CallbackData",t.length>0?[...new Set(t)].join(" | "):"never"].join(", ")},l=()=>{let e=new Map;return{member:(t,a)=>(e.set(t,a),t),declarations:()=>[...e].map(([e,t])=>`type ${e} = ${t}`).join("\n")}},d=(i,l,d)=>{for(let e of["$DomainEntityReflection","DomainComponentOpticBuilder","DomainContextSystems","DomainEntityReflection","EnhancedAliasReflection","EnumLike","RawAliasReflection","RuntimeExpressionContext","SchemaReflection","createActionFactory","createAssistantSetupHandlerFactory","createCustomExpressionFactory","createCustomInvariantFactory","createDataRowValidatorHandler","createMapPublishedChunkedDataHandlerFactory","createMapPublishedRevisionDataHandlerFactory","createRecipeFactory","createSheetValidatorHandler"])l.addTypeImport("@salsita-ai/sdk/domain",e);l.addTypeImport(a,"createConfiguratorInterface"),l.addTypeImport(a,"CreateAssistantFormElement");let p=t(i.configurator,""),m=t(i.admin,"Admin"),y=s(i),c=(e,t)=>t?`interface ${e} {
+import{generateInvariantBlueprintMembers as e,getDomainFactoryTypes as t}from"../domain-spec/index.js";let a="@salsita-ai/sdk/configurator",n="CustomInvariantBlueprints",o="AdminCustomInvariantBlueprints",r=["authHandlerBuilder","webhookBuilder","taskFactory","finalizeHandlerBuilder","callbackBuilder","prefetchBuilder","dynamicResourcesFactory"],i=(e,t)=>e.replaceAll("\n",`
+${t}`),s=(e,t)=>{let a=(e.infra.resources??[]).map(e=>JSON.stringify(e.name));return["AnyDomainEntity","RootEntity","$Map","NavigationState","ViewState","ToolState","ExportState","PublishedData","SessionData","FrontendData",...t?["ActionTypes"]:[],"Admin.AnyDomainEntity","Admin.RootEntity","Admin.$Map","AdminNavigationState","never","FinalizeData","PrefetchedFinalizeData","FinalizeResult","CallbackData",a.length>0?[...new Set(a)].join(" | "):"never"].join(", ")},d=()=>{let e=new Map;return{member:(t,a)=>(e.set(t,a),t),declarations:()=>[...e].map(([e,t])=>`type ${e} = ${t}`).join("\n")}},p=(r,d,p)=>{for(let e of["$DomainEntityReflection","DomainComponentOpticBuilder","DomainEntityReflection","EnhancedAliasReflection","EnumLike","RawAliasReflection","RuntimeExpressionContext","SchemaReflection","createActionFactory","createAssistantSetupHandlerFactory","createCustomExpressionFactory","createCustomInvariantFactory","createDataRowValidatorHandler","createMapPublishedChunkedDataHandlerFactory","createMapPublishedRevisionDataHandlerFactory","createRecipeFactory","createSheetValidatorHandler"])d.addTypeImport("@salsita-ai/sdk/domain",e);d.addTypeImport(a,"createConfiguratorInterface"),d.addTypeImport(a,"CreateAssistantFormElement"),d.addTypeImport(a,"ConfiguratorExtensionSystems");let l=t(r.configurator,{typePrefix:"",isAdmin:!1}),m=t(r.admin,{typePrefix:"Admin",isAdmin:!0}),y=s(r,!0),c=(e,t)=>t?`interface ${e} {
 ${t}
-}`:`interface ${e} {}`,{member:u}=d,$=`{
-  readonly model: ${r(p.modelType,"  ")}
-  readonly enhancedModel: ${r(p.enhancedModelType,"  ")}
-  readonly implementCustomExpressions: ${u("PhxImplementCustomExpressions",`ReturnType<typeof createCustomExpressionFactory<${p.typeArguments}, ${p.contextExtension}>>`)}
-  readonly implementCustomInvariants: ${u("PhxImplementCustomInvariants",`ReturnType<ReturnType<typeof createCustomInvariantFactory<${p.typeArguments}, ${n}, ${p.contextExtension}>>>`)}
-  readonly implementActions: ${u("PhxImplementActions",`ReturnType<typeof createActionFactory<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, ActionTypes, ${p.contextExtension}, ${p.systems}>>`)}
+}`:`interface ${e} {}`,{member:u}=p,A=`{
+  readonly model: ${i(l.modelType,"  ")}
+  readonly enhancedModel: ${i(l.enhancedModelType,"  ")}
+  readonly implementCustomExpressions: ${u("PhxImplementCustomExpressions",`ReturnType<typeof createCustomExpressionFactory<${l.typeArguments}, ${l.contextExtension}>>`)}
+  readonly implementCustomInvariants: ${u("PhxImplementCustomInvariants",`ReturnType<ReturnType<typeof createCustomInvariantFactory<${l.typeArguments}, ${n}, ${l.contextExtension}>>>`)}
+  readonly implementActions: ${u("PhxImplementActions",`ReturnType<typeof createActionFactory<${l.actionTypeArguments}>>`)}
   readonly createAssistantSetupHandler: ${u("PhxCreateAssistantSetupHandler","ReturnType<typeof createAssistantSetupHandlerFactory<SessionData, AnyDomainEntity, $Map, ActionTypes>>")}
-  readonly attachComponent: ${u("PhxAttachComponent",`ReturnType<typeof DomainComponentOpticBuilder.from<${p.typeArguments}, ${p.contextExtension}>>`)}
+  readonly attachComponent: ${u("PhxAttachComponent",`ReturnType<typeof DomainComponentOpticBuilder.from<${l.typeArguments}, ${l.contextExtension}>>`)}
   readonly createRecipe: ${u("PhxCreateRecipe","ReturnType<typeof createRecipeFactory<AnyDomainEntity>>")}
   readonly admin: {
-    readonly model: ${r(m.modelType,"    ")}
-    readonly enhancedModel: ${r(m.enhancedModelType,"    ")}
+    readonly model: ${i(m.modelType,"    ")}
+    readonly enhancedModel: ${i(m.enhancedModelType,"    ")}
     readonly implementCustomExpressions: ${u("PhxAdminImplementCustomExpressions",`ReturnType<typeof createCustomExpressionFactory<${m.typeArguments}, ${m.contextExtension}>>`)}
     readonly implementCustomInvariants: ${u("PhxAdminImplementCustomInvariants",`ReturnType<ReturnType<typeof createCustomInvariantFactory<${m.typeArguments}, ${o}, ${m.contextExtension}>>>`)}
     readonly attachComponent: ${u("PhxAdminAttachComponent",`ReturnType<typeof DomainComponentOpticBuilder.from<${m.typeArguments}, ${m.contextExtension}>>`)}
@@ -22,12 +22,12 @@ ${t}
     readonly createSheetValidatorHandler: typeof createSheetValidatorHandler
     readonly createRecipe: ${u("PhxAdminCreateRecipe","ReturnType<typeof createRecipeFactory<Admin.AnyDomainEntity>>")}
   }
-}`,A=u("PhxFrontend",`ReturnType<typeof createConfiguratorInterface<${y}>> & {
+}`,$=u("PhxFrontend",`ReturnType<typeof createConfiguratorInterface<${y}>> & {
   readonly createAssistantFormElement: CreateAssistantFormElement<AssistantFormElementTypes>
-}`),{latestModel:h}=i.configurator;return{declarations:[c(n,e(i.configurator.invariants,"  ")),c(o,e(i.admin.invariants,"  "))].join("\n\n"),domainType:$,configuratorInterfaceType:A,applicationTypeNames:[...h.entityTypes.map(String),...[...h.aliases].map(([e])=>String(e)),...[...h.commonTypes].map(([e])=>String(e)),...h.entityTypes.map(e=>`$${String(e)}`),...[...h.aliases].map(([e])=>`$${String(e)}`),"Aliases","$Map","ActionTypes","AssistantFormElementTypes","Admin","PublishedData","SessionData","FrontendData","BackendData","FinalizeData","PrefetchedFinalizeData","FinalizeResult","CallbackData","NavigationState","ViewState","ToolState","ExportState","AdminNavigationState"]}};export const generatePhxTypes=(e,t)=>{let a=l(),n=d(e,t,a);return{...n,declarations:`${n.declarations}
+}`),{latestModel:h}=r.configurator;return{declarations:[c(n,e(r.configurator.invariants,"  ")),c(o,e(r.admin.invariants,"  "))].join("\n\n"),domainType:A,configuratorInterfaceType:$,applicationTypeNames:[...h.entityTypes.map(String),...[...h.aliases].map(([e])=>String(e)),...[...h.commonTypes].map(([e])=>String(e)),...h.entityTypes.map(e=>`$${String(e)}`),...[...h.aliases].map(([e])=>`$${String(e)}`),"Aliases","$Map","ActionTypes","AssistantFormElementTypes","Admin","PublishedData","SessionData","FrontendData","BackendData","FinalizeData","PrefetchedFinalizeData","FinalizeResult","CallbackData","NavigationState","ViewState","ToolState","ExportState","AdminNavigationState"]}};export const generatePhxTypes=(e,t)=>{let a=d(),n=p(e,t,a);return{...n,declarations:`${n.declarations}
 
-${a.declarations()}`}};export const generateGlobalPhxTypes=(e,t)=>{let a=l(),{member:n}=a,o=d(e,t,a);t.addTypeImport("@salsita-ai/sdk/admin","createAdminInterface"),t.addTypeImport("@salsita-ai/sdk/webhook","createDomainWebhook");let r=s(e),p=n("PhxFrontendAdmin",`ReturnType<typeof createAdminInterface<${r}>>`),m=n("PhxWebhookBuilders",`ReturnType<typeof createDomainWebhook<${r}>>`),y=i.map(e=>`  readonly ${e}: ${n(`PhxWebhooks${e.charAt(0).toUpperCase()}${e.slice(1)}`,`${m}['${e}']`)}`);return{...o,declarations:`${o.declarations}
+${a.declarations()}`}};export const generateGlobalPhxTypes=(e,t)=>{let a=d(),{member:n}=a,o=p(e,t,a);t.addTypeImport("@salsita-ai/sdk/admin","createAdminInterface"),t.addTypeImport("@salsita-ai/sdk/webhook","createDomainWebhook");let i=s(e,!1),l=n("PhxFrontendAdmin",`ReturnType<typeof createAdminInterface<${i}>>`),m=n("PhxWebhookBuilders",`ReturnType<typeof createDomainWebhook<${i}>>`),y=r.map(e=>`  readonly ${e}: ${n(`PhxWebhooks${e.charAt(0).toUpperCase()}${e.slice(1)}`,`${m}['${e}']`)}`);return{...o,declarations:`${o.declarations}
 
-${a.declarations()}`,adminInterfaceType:p,webhooksType:`{
+${a.declarations()}`,adminInterfaceType:l,webhooksType:`{
 ${y.join("\n")}
 }`}};

package/dist/application-spec/generate-application/code/templates/html-index.d.ts

@@ -1 +1,12 @@
-export declare const generateApplicationSpecHtmlIndex: (webComponentTag?: string, enableEditor?: boolean, pageTitle?: string) => string;
+/**
+ * What the generated `index.html` puts around the configurator.
+ *
+ * `editor` mounts the Phoenix editor, which hosts the configurator; `agent` mounts the editor with
+ * its UI hidden, so it still serves the CLI's inspect commands, and runs agent mode, which shows the
+ * "Agent at work" screen in place of dev errors; `plain` mounts the configurator
+ * alone, as a build deploys it. `phoenix dev` picks one by the credentials and the editor setting;
+ * `phoenix sync`, `build` and `clean` keep an agent-mode page dev generated, and otherwise pick
+ * `editor` or `plain`.
+ */
+export type PageExperience = 'editor' | 'agent' | 'plain';
+export declare const generateApplicationSpecHtmlIndex: (webComponentTag: string | undefined, experience: PageExperience, pageTitle: string | undefined) => string;

package/dist/application-spec/generate-application/code/templates/html-index.js

@@ -1,16 +1,17 @@
-let t="Auto-generated file. Do not modify this file manually. Version: 1";export const generateApplicationSpecHtmlIndex=(e="salsita-configurator",i=!1,o="Phoenix configurator")=>i?`<!doctype html>
+let t="Auto-generated file. Do not modify this file manually. Version: 1";export const generateApplicationSpecHtmlIndex=(e,i,o)=>{let n=e??"salsita-configurator",r=o??"Phoenix configurator";return"plain"===i?`<!doctype html>
 <!-- ${t} -->
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0, interactive-widget=resizes-content" />
-    <title>${o} - Editor</title>
+    <title>${r}</title>
   </head>
   <body style="margin: 0">
-    <div id="root" style="block-size: 100dvb"></div>
+    <div style="block-size: 100dvb">
+      <${n}></${n}>
+    </div>
     <script type="module" src="./configurator.ts"></script>
-    <script type="module" src="./editor.tsx"></script>
   </body>
 </html>
 `:`<!doctype html>
@@ -20,13 +21,11 @@ let t="Auto-generated file. Do not modify this file manually. Version: 1";export
     <meta charset="UTF-8" />
     <link rel="icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0, interactive-widget=resizes-content" />
-    <title>${o}</title>
+    <title>${"editor"===i?`${r} - Editor`:r}</title>
   </head>
   <body style="margin: 0">
-    <div style="block-size: 100dvb">
-      <${e}></${e}>
-    </div>
-    <script type="module" src="./configurator.ts"></script>
+    <div id="root" style="block-size: 100dvb"></div>
+${("agent"===i?["./editor.tsx","./configurator.ts"]:["./configurator.ts","./editor.tsx"]).map(t=>`    <script type="module" src="${t}"></script>`).join("\n")}
   </body>
 </html>
-`;
+`};

package/dist/application-spec/generate-application/code/templates/index.d.ts

@@ -35,10 +35,10 @@ export { generateApplicationSpecFrontendConfig } from './frontend-config.js';
 export { generateApplicationSpecGitignore } from './gitignore.js';
 export { generateApplicationSpecGlobals } from './globals.js';
 export { generateApplicationSpecHtmlAdminIndex } from './html-admin-index.js';
-export { generateApplicationSpecHtmlIndex } from './html-index.js';
+export { type PageExperience, generateApplicationSpecHtmlIndex } from './html-index.js';
 export { generateLinguiRcFile } from './lingui-rc.js';
 export { generatePhoenixSkillBundle } from './skills/phoenix-skill-bundle.js';
-export { type PhoenixSkillOptions, followsCanaryBuilds } from './skills/phoenix-skill.js';
+export { type PhoenixSkillOptions, followsCanaryBuilds } from './skills/processes/index.js';
 export { generateApplicationSpecPrettierConfig } from './prettier-config.js';
 export { generateApplicationSpecRobotsTxt } from './robots-txt.js';
 export { generateApplicationSpecRootTsconfig } from './root-tsconfig.js';

package/dist/application-spec/generate-application/code/templates/index.js

@@ -1 +1 @@
-export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generatePhoenixSkillBundle}from"./skills/phoenix-skill-bundle.js";export{followsCanaryBuilds}from"./skills/phoenix-skill.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecRootTsconfig}from"./root-tsconfig.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecCodeFile}from"./spec-code/index.js";export{generateApplicationSpecMessagesFile}from"./spec-messages/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";
+export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generatePhoenixSkillBundle}from"./skills/phoenix-skill-bundle.js";export{followsCanaryBuilds}from"./skills/processes/index.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecRootTsconfig}from"./root-tsconfig.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecCodeFile}from"./spec-code/index.js";export{generateApplicationSpecMessagesFile}from"./spec-messages/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";

package/dist/application-spec/generate-application/code/templates/lingui-rc.js

@@ -1,8 +1,8 @@
-import{DEFAULT_FALLBACK_LOCALE as e,LOCALE_FALLBACK_MAP as a}from"#package/i18n";export const generateLinguiRcFile=s=>{let o;return`{
+import{DEFAULT_FALLBACK_LOCALE as e,LOCALE_FALLBACK_MAP as a}from"#package/i18n";export const generateLinguiRcFile=o=>{let s;return`{
   "sourceLocale": "en",
-  "locales": [${s.map(e=>`"${e}"`).join(", ")}],
+  "locales": [${o.map(e=>`"${e}"`).join(", ")}],
   "fallbackLocales": {
-${(o=Object.entries(a).map(([e,a])=>{let s=Array.isArray(a)?`[${a.map(e=>`"${e}"`).join(", ")}]`:`"${a}"`;return`    "${e}": ${s}`})).push(`    "default": "${e}"`),o.join(",\n")}
+${(s=Object.entries(a).map(([e,a])=>{let o=Array.isArray(a)?`[${a.map(e=>`"${e}"`).join(", ")}]`:`"${a}"`;return`    "${e}": ${o}`})).push(`    "default": "${e}"`),s.join(",\n")}
   },
   "catalogs": [
     {
@@ -13,7 +13,8 @@ ${(o=Object.entries(a).map(([e,a])=>{let s=Array.isArray(a)?`[${a.map(e=>`"${e}"
       ],
       "exclude": [
         "**/node_modules/**",
-        "**/dist/**"
+        "**/dist/**",
+        "**/.phoenix/workspace/**"
       ]
     }
   ],

package/dist/application-spec/generate-application/code/templates/skills/core/cli.d.ts

@@ -0,0 +1,2 @@
+import { type PhoenixGuide } from '../guide.js';
+export declare const generatePhoenixCliCore: () => PhoenixGuide;

package/dist/application-spec/generate-application/code/templates/skills/core/cli.js

@@ -0,0 +1 @@
+import{createPhoenixTopicGuide as e}from"../guide.js";export const generatePhoenixCliCore=()=>e({path:"core/cli.md",title:"CLI",summary:"tooling, identity, project structure and ownership, local development and deployment",sections:["## Tooling and dependencies\n\nCommands use pnpm notation; use the project's package manager identified by its lockfile or `packageManager` in `package.json`, and ask when neither identifies it. Keep the SDK on its intended release channel: stable, PR beta and workspace-linked projects must not be moved to canary.\n\n`phoenix deps` aligns missing or out-of-range peer dependencies in `package.json` but installs nothing. Install with the project's package manager, then `phoenix sync` regenerates project files and guidance. Refresh changed guidance after sync. An install with pnpm 11 that skips build scripts leaves placeholder entries under `allowBuilds` in `pnpm-workspace.yaml`; decide them, `true` for `@swc/core` and `esbuild` and `false` for `es5-ext`, because the platform build stops on a placeholder and `phoenix deploy` refuses one. [CLI and setup documentation](../features/index.md#cli-access-and-deployment) owns flags and installation details.\n\n## Identity and authentication\n\nA workspace contains projects, and a project has target environments and deployments. Confirm ambiguous identity before mutations or deploys. `phoenix login` authorizes the CLI across currently permitted Builder projects; set an explicit project slug in the spec for dev and deploy. `phoenix whoami` shows current access. The legacy `phoenix login <workspace>` form keeps workspace-bound credentials. Consult [project and authentication documentation](../features/index.md#cli-access-and-deployment) for local versus remote setup.\n\n## Project structure\n\n- `spec/` — domain, relations, expressions, invariants, components and application YAML.\n- `src/expressions/`, `actions/`, `invariants/`, `transformers/` — typed implementations of domain behavior and consistency rules.\n- `src/components/`, `elements/`, `handlers/` — runtime components, custom UI and layout elements, event and lifecycle handlers. See [Custom project layout](../features/custom-layout/index.md) and [Domain controls](../features/domain-controls/index.md).\n- `src/webhooks/` — the server side. The entry is the default export of `index.ts`, the only file imported; it imports the others. Without it the SDK supplies anonymous auth, or invitation-only Phoenix auth when `useCognito: true`; enabling custom or Clerk auth without it reports `AUTH_WITHOUT_PROJECT_WEBHOOK`. See [Webhooks](../features/webhooks/index.md).\n- `src/migrations/` — versioned model migrations; `src/admin/` mirrors the main source structure for Admin.\n- `src/locales/` — authored PO catalogs and generated TS catalogs.\n- `src/_shared/`, `src/_utils/` and other `_`-prefixed folders — helpers and supporting modules. Phoenix skips these folders during auto-import; import their modules explicitly.\n- `public/` — static models, textures, images and fonts; `assets/` — uploadable resources such as templates and email assets.\n- `docs/` — rendered specification PDFs for the client.\n- `tools/` — reproducible project scripts, such as model conversion or rendering the specification PDFs. One-off scripts, screenshots and downloads stay in the agent's scratch space outside the project.\n- `.phoenix/` — generated files, with the project-owned exceptions below. The root `tsconfig.json` belongs to the project and extends `.phoenix/tsconfig.json`.\n\nDo not edit generated output or compiled locale TS. `.phoenix/workspace/` holds the specification sources and project records; application-spec sync, build and clean preserve it, and the generated Git ignore rules leave it available for version control. Deploy includes `.phoenix/workspace/` and `docs/` in the private deployment sources, outside application inputs and public assets. `.phoenix/variants/` option files survive rebuilds. Legacy tooling has a separate lifecycle.\n\nSync rewrites and prunes Phoenix's `phoenix` and `phoenix-*` skill folders under `.claude/skills/` and `.agents/skills/`; keep custom skills under another name. Root `AGENTS.md` and client source documents are client-owned. Components use PascalCase TSX, utilities kebab-case TS, expressions entity-name TS, migrations sequential `v*.ts` and specs kebab-case YAML. `docs/phoenix/project-structure.mdx` has the full reference; the [capability index](../features/index.md#project-and-customization) lists it.\n\n### Source conventions\n\n- Auto-imported expressions, actions, invariants, transformers, components, handlers and elements must default-export their folder's phx factory result, as one item or an array. Named exports are ignored.\n- `phx` is a global in every project: use it without importing it.\n- Keep plain helpers in underscore folders and import them explicitly.\n- Use relative imports: dev, build and webhook bundling do not resolve tsconfig `paths` aliases.\n\n## Local development\n\n`phoenix dev` runs the live preview, `sync` regenerates without bundling, `build` produces the production build, and `check` checks project quality.\n\n### Keep the preview in front of the client\n\nThe client should see the configurator change while it is built. Before the first change in a conversation, make sure `pnpm phoenix dev` is running, starting it in the background when it is not, and wait for the `Preview: <url>` line it prints and writes to `.phoenix/phoenix-dev.log`. The log keeps the lines of earlier runs, so use the last one written after the start.\n\nFor a new project, start by understanding the client’s product and what they want to configure before asking them to sign in; then make the preview reflect that before showing it, rather than presenting the generated starter scene.\n\nOpen the address where the client can see it: in the agent application's built-in browser when it has one the client sees, otherwise in the client's browser with `open '<url>'` on macOS, `xdg-open '<url>'` on Linux or `Start-Process '<url>'` in PowerShell. Keep the quotes; the shell would otherwise read a `?` in the address as a pattern. Then tell the client in one line where the preview is and that it updates by itself as the work goes on. Variant comparisons open in the same preview, so say there what to compare and how to choose.\n\nOpen it once: the preview reloads on every change. A domain model change is the exception. Dev registers the model with the server only when it starts and logs an error asking for a restart; restart it, wait for the new `Preview:` line and open that address in place of the old tab, whose `?cid=` names a configuration of the earlier model.\n\n### Logs and inspection\n\nLogs in `.phoenix/phoenix-dev.log` contain spec, build and runtime errors and watcher events; check them after changes. Signed in, `phoenix dev` runs in agent mode: the preview hides the editor, a corner badge shows when the latest change didn't build, and any dev error shows an \"Agent at work\" screen with no details, so the client never sees them. The details are only in the log; the page recovers by itself after the next successful rebuild. `--editor` shows the editor and the detailed error pages. [Inspection tools](../features/inspection.md) cover assets, state, data, scene and screenshots. Runtime inspection needs dev running and the preview open in a browser; a screenshot of the canvas does not verify the surrounding interface.\n\n## Deployment\n\n`pnpm phoenix deploy` sends the project sources for a server build and waits for the target environment to go live. Run it so its output can be read while it runs: right after `Build <id> started` it prints `Follow the build in Studio: <url>`. Open that link where the client sees it, as with the preview, so they can follow the build. When the line is missing, the sign-in predates the link: the build is listed under Deployments in Studio, and `pnpm phoenix login <workspace>` brings the link back.\n\nA successful local preview does not establish deployed model compatibility. The deploy is refused before the upload when the domain model changed under a version that is already deployed, such as a starter deployed before the first draft; [Model migration](../processes/model-migration.md) handles that. When the build fails, tell the client the cause and the next step. Record each deploy and its outcome in the project record. [Deployment documentation](../features/index.md#cli-access-and-deployment) covers status and environment details.\n\n## Internal beta\n\nPhoenix is in an internal beta. Read [Beta](../processes/beta.md) before each deploy and when a deploy goes live; a project on the `canary` SDK build also reads it once per conversation before changing anything.\n\n## Interactive and support tools\n\n[Variants](../features/variants.md) compares frontend alternatives over the live preview and applies the choice. [Feedback](../processes/feedback/index.md) submits an approved issue or evaluation. The [workflow](workflow.md) owns when either is useful and how much client interaction fits the task."]});

package/dist/application-spec/generate-application/code/templates/skills/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './workflow.js';
+export * from './sdk.js';
+export * from './cli.js';

package/dist/application-spec/generate-application/code/templates/skills/core/index.js

@@ -0,0 +1 @@
+export*from"./workflow.js";export*from"./sdk.js";export*from"./cli.js";

package/dist/application-spec/generate-application/code/templates/skills/core/sdk.d.ts

@@ -0,0 +1,2 @@
+import { type PhoenixGuide } from '../guide.js';
+export declare const generatePhoenixSdkCore: () => PhoenixGuide;