@salsita-ai/sdk 0.50.0-develop.97a772d197 → 0.50.0-develop.98166fe7c3

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

@@ -1,8 +1,8 @@
-import{match as e}from"ts-pattern";import{isSdkCodeRef as t}from"../../../../parse-application-files/spec/index.js";import{generateMemoEvalPlanCode as i}from"./generate-memo-eval-plan-code.js";let a="@salsita-ai/sdk/domain",r={createAdminCustomPageRead:a,createAdminCustomSidebarRead:a,createAdminDataPageRead:a,createAdminDataTableSidebarRead:a,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:a,createAdminPresetCategorySelectionRead:a,createAdminPresetCategorySelectionWrite:a,createAdminPresetCategorySidebarRead:a,createAdminPresetListPageRead:a,createAdminPresetSidebarRead:a,createAdminRecipeCollectionPageRead:a,createAdminRecipeSidebarRead:a},n=(e,i)=>{i.addImport(r[e.sdkFunction]??a,e.sdkFunction);let n=e.params.map(e=>t(e)?e.$codeRef:"string"==typeof e?`'${e}'`:JSON.stringify(e));return`${e.sdkFunction}(${n.join(", ")})`},d=e=>0===e.length?"":e.map(e=>{if("root"===e.kind)return`.withFilter(self => (self.${e.target}))`;let t=Object.entries(e).filter(([e,t])=>"kind"!==e&&void 0!==t).map(([e,t])=>`${e}: ${"dynamic"===t.kind?`self => (self.${t.target})`:"eval"===t.kind?`self => (${t.code})`:JSON.stringify(t.value)}`);return`.withGradualFilter({ ${t.join(", ")} })`}).join(""),o=(t,i)=>e(t).with({kind:"primitive"},({assertFn:e})=>`typeof ${i} === '${"assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string"}'`).with({kind:"declaredType"},({typeName:e})=>`${e}.is(${i})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.isId(${i})`).with({kind:"literal"},({value:e})=>`${i} === ${JSON.stringify(e)}`).with({kind:"anyOf"},({assertions:e})=>e.map(e=>`(${o(e,i)})`).join(" || ")).with({kind:"none"},()=>"true").exhaustive(),s=(t,i)=>{if(0===t.length)return"() => ({})";let r=t.map(t=>e(t.assertion).with({kind:"primitive"},({assertFn:e})=>(i.addImport(a,e),`${e}(state.${t.propKey})`)).with({kind:"declaredType"},({typeName:e})=>`${e}.assert(state.${t.propKey})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.assertId(state.${t.propKey})`).with({kind:"literal"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match its declared schema')`}).with({kind:"anyOf"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match one of its declared schemas')`}).with({kind:"none"},()=>void 0).exhaustive()).filter(e=>void 0!==e),n=t.map(e=>`${JSON.stringify(e.entityField)}: state.${e.propKey}`).join(", ");return 0===r.length?`(state) => ({ ${n} })`:`(state) => { ${r.join("; ")}; return { ${n} } }`},l="      ";export const generateComponentOpticsCode=(t,r)=>{let o=[];for(let p of t){let t=p.isAlias?"withAlias":"withEntity",m=`${p.componentName}Component`;r.addImport(a,m);let $=`    attachComponent.withComponent(${m}, '${p.instanceName}', true).${t}('${p.typeOrAlias}')`;e(p.implementation).with({kind:"userBound"},({implementation:e,filters:t,plan:a})=>{let n=d(t.items),p=`${$}${n}`,m=s("composite"===e.kind?e.writeBindings:[],r),c=i(a,r).replaceAll("\n",`
-${l}`);o.push(`${p}.attach(
+import{match as e}from"ts-pattern";import{isSdkCodeRef as t}from"../../../../core/index.js";import{generateMemoEvalPlanCode as i}from"./generate-memo-eval-plan-code.js";let a="@salsita-ai/sdk/domain",r={createAdminCustomPageRead:a,createAdminCustomSidebarRead:a,createAdminDataPageRead:a,createAdminDataTableSidebarRead:a,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:a,createAdminPresetCategorySelectionRead:a,createAdminPresetCategorySelectionWrite:a,createAdminPresetCategorySidebarRead:a,createAdminPresetListPageRead:a,createAdminPresetSidebarRead:a,createAdminRecipeCollectionPageRead:a,createAdminRecipeSidebarRead:a},n=(e,i)=>{i.addImport(r[e.sdkFunction]??a,e.sdkFunction);let n=e.params.map(e=>t(e)?e.$codeRef:"string"==typeof e?`'${e}'`:JSON.stringify(e));return`${e.sdkFunction}(${n.join(", ")})`},d=e=>0===e.length?"":e.map(e=>{if("root"===e.kind)return`.withFilter(self => (self.${e.target}))`;let t=Object.entries(e).filter(([e,t])=>"kind"!==e&&void 0!==t).map(([e,t])=>`${e}: ${"dynamic"===t.kind?`self => (self.${t.target})`:"eval"===t.kind?`self => (${t.code})`:JSON.stringify(t.value)}`);return`.withGradualFilter({ ${t.join(", ")} })`}).join(""),o=(t,i)=>e(t).with({kind:"primitive"},({assertFn:e})=>`typeof ${i} === '${"assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string"}'`).with({kind:"declaredType"},({typeName:e})=>`${e}.is(${i})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.isId(${i})`).with({kind:"literal"},({value:e})=>`${i} === ${JSON.stringify(e)}`).with({kind:"anyOf"},({assertions:e})=>e.map(e=>`(${o(e,i)})`).join(" || ")).with({kind:"none"},()=>"true").exhaustive(),s=(t,i)=>{if(0===t.length)return"() => ({})";let r=t.map(t=>e(t.assertion).with({kind:"primitive"},({assertFn:e})=>(i.addImport(a,e),`${e}(state.${t.propKey})`)).with({kind:"declaredType"},({typeName:e})=>`${e}.assert(state.${t.propKey})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.assertId(state.${t.propKey})`).with({kind:"literal"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match its declared schema')`}).with({kind:"anyOf"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match one of its declared schemas')`}).with({kind:"none"},()=>void 0).exhaustive()).filter(e=>void 0!==e),n=t.map(e=>`${JSON.stringify(e.entityField)}: state.${e.propKey}`).join(", ");return 0===r.length?`(state) => ({ ${n} })`:`(state) => { ${r.join("; ")}; return { ${n} } }`},l="      ";export const generateComponentOpticsCode=(t,r)=>{let o=[];for(let m of t){let t=m.isAlias?"withAlias":"withEntity",p=`${m.componentName}Component`;r.addImport(a,p);let $=`    attachComponent.withComponent(${p}, '${m.instanceName}', true).${t}('${m.typeOrAlias}')`;e(m.implementation).with({kind:"userBound"},({implementation:e,filters:t,plan:a})=>{let n=d(t.items),m=`${$}${n}`,p=s("composite"===e.kind?e.writeBindings:[],r),c=i(a,r).replaceAll("\n",`
+${l}`);o.push(`${m}.attach(
 ${l}${c},
-${l}${m}
-    )`)}).with({kind:"sdk"},({readFactory:e,writeFactory:t})=>{let i=d(p.implementation.filters.items),a=`${$}${i}`,s=n(e,r),l=n(t,r);o.push(`${a}.attach(
+${l}${p}
+    )`)}).with({kind:"sdk"},({readFactory:e,writeFactory:t})=>{let i=d(m.implementation.filters.items),a=`${$}${i}`,s=n(e,r),l=n(t,r);o.push(`${a}.attach(
       ${s},
       ${l}
     )`)}).exhaustive()}return 0===o.length?"[] as const":`[

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

@@ -7,7 +7,9 @@ import type { CodeImports } from '../../common/index.js';
  * `$msg`; rejects `$eval` since defaults are static).
  *
  * **Deprecated feature.** Kept for legacy parity; prefer `$data` for new specs.
- * The `as const` assertion preserves literal types so `RecipeFactoryBuilder
- * .withDefaults(defaults)` can type-check the defaults against entity shapes.
+ * The declaration is the third argument of `createRecipeFactory`, which validates
+ * each entry against the entity's schema when the generated module loads. The
+ * compiler does not check the entries: the spec parser reports a wrong or
+ * incomplete entry at its key under `defaults:`.
  */
 export declare const generateDefaultsBlock: (defaults: Defaults, imports: CodeImports) => string;

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

@@ -1 +1 @@
-import{CONSTANT_CAPS as e,ParseContext as t,stringifyEnhancedJsonValue as r}from"../../../../core/index.js";export const generateDefaultsBlock=(a,n)=>{let o=new t,s=r({...a.entries},n,e,o);if(void 0===s){let e=o.errors.map(e=>`${e.code}: ${e.message}`).join("; ");throw Error(`generateDefaultsBlock: stringifyEnhancedJsonValue returned undefined. Parse-time capability validation should have caught this — caps: CONSTANT_CAPS. ${e}`)}return`const defaults = ${s} as const`};
+import{CONSTANT_CAPS as e,ParseContext as t}from"../../../../core/index.js";import{stringifyEnhancedJsonValue as n}from"../../../../enhanced-json/index.js";export const generateDefaultsBlock=(r,o)=>{let s=new t,a=n({...r.entries},o,e,s);if(void 0===a){let e=s.errors.map(e=>`${e.code}: ${e.message}`).join("; ");throw Error(`generateDefaultsBlock: stringifyEnhancedJsonValue returned undefined. Parse-time capability validation should have caught this — caps: CONSTANT_CAPS. ${e}`)}return`const defaults = ${a} as const`};

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

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

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

@@ -1,4 +1,4 @@
 import type { Invariants } from '../../../../parse-application-files/index.js';
 import type { CodeImports } from '../../common/index.js';
 /** Emits the custom-invariant blueprint and factory declarations for one generated domain block. */
-export declare const generateInvariantsBlock: (invariants: Invariants, factoryGenerics: string, imports: CodeImports) => string;
+export declare const generateInvariantsBlock: (invariants: Invariants, factoryGenerics: string, contextExtension: string, imports: CodeImports) => string;

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

@@ -1 +1 @@
-import{stringifyMsgMacroCode as t}from"../../../../core/index.js";let i=(i,o)=>"string"==typeof i?JSON.stringify(i):(o.addImport("@lingui/core/macro","msg"),t(i)),o=t=>"static"===t.kind?"boolean":t.violationTypes.map(t=>JSON.stringify(String(t))).join(" | ");export const generateInvariantsBlock=(t,e,n)=>{let{entries:r}=t,s=["  interface CustomInvariantBlueprints {"];for(let[t,i]of Object.entries(r)){for(let[e,n]of(s.push(`    ${t}: {`),Object.entries(i)))s.push(`      ${e}: ${o(n)}`);s.push("    }")}for(let[t,o]of(s.push("  }","  const staticViolations = {"),Object.entries(r))){let e=Object.values(o).filter(t=>"static"===t.kind);if(0!==e.length){for(let o of(s.push(`    ${t}: {`),e)){let t=[`type: ${JSON.stringify(String(o.violationType))}`,`severity: ${JSON.stringify(o.severity)}`,`message: ${i(o.message,n)}`];void 0!==o.controlViolationPriority&&t.push(`controlViolationPriority: ${o.controlViolationPriority}`),s.push(`      ${o.name}: { ${t.join(", ")} },`)}s.push("    },")}}return s.push("  } as const",`  const implementCustomInvariants = createCustomInvariantFactory<${e}, CustomInvariantBlueprints>()(staticViolations)`),s.join("\n")};
+import{stringifyMsgMacroCode as t}from"../../../../core/index.js";let i=(i,o)=>"string"==typeof i?JSON.stringify(i):(o.addImport("@lingui/core/macro","msg"),t(i)),o=t=>"static"===t.kind?"boolean":t.violationTypes.map(t=>JSON.stringify(String(t))).join(" | ");export const generateInvariantsBlock=(t,e,n,r)=>{let{entries:s}=t,a=["  interface CustomInvariantBlueprints {"];for(let[t,i]of Object.entries(s)){for(let[e,n]of(a.push(`    ${t}: {`),Object.entries(i)))a.push(`      ${e}: ${o(n)}`);a.push("    }")}for(let[t,o]of(a.push("  }","  const staticViolations = {"),Object.entries(s))){let e=Object.values(o).filter(t=>"static"===t.kind);if(0!==e.length){for(let o of(a.push(`    ${t}: {`),e)){let t=[`type: ${JSON.stringify(String(o.violationType))}`,`severity: ${JSON.stringify(o.severity)}`,`message: ${i(o.message,r)}`];void 0!==o.controlViolationPriority&&t.push(`controlViolationPriority: ${o.controlViolationPriority}`),a.push(`      ${o.name}: { ${t.join(", ")} },`)}a.push("    },")}}return a.push("  } as const",`  const implementCustomInvariants = createCustomInvariantFactory<${e}, CustomInvariantBlueprints, ${n}>()(staticViolations)`),a.join("\n")};

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

@@ -11,6 +11,7 @@ globalThis.phx.domain = {
   implementCustomExpressions,
   implementCustomInvariants,
   implementActions,
+  createAssistantSetupHandler,
   attachComponent,
   createRecipe,
 
@@ -52,6 +53,7 @@ globalThis.phx.applicationTypes = {
   readonly implementCustomExpressions: typeof implementCustomExpressions
   readonly implementCustomInvariants: typeof implementCustomInvariants
   readonly implementActions: typeof implementActions
+  readonly createAssistantSetupHandler: typeof createAssistantSetupHandler
   readonly attachComponent: typeof attachComponent
   readonly createRecipe: typeof createRecipe
   readonly admin: {
@@ -72,6 +74,7 @@ globalThis.phx.applicationTypes = {
   implementCustomExpressions,
   implementCustomInvariants,
   implementActions,
+  createAssistantSetupHandler,
   attachComponent,
   createRecipe,
 

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

@@ -1,4 +1,4 @@
-export const generateRelationExpressionsCode=(e,n)=>{let t=new Map;for(let[n,o]of e.expressions)for(let[,e]of o){if("relation"!==e.implementation.kind)continue;let o=String(n);t.has(o)||t.set(o,[]);let[r]=e.implementation.params;t.get(o).push({relName:String(e.name),rawRelation:r})}if(0===t.size)return"{} as const";let o=[];for(let[e,r]of t){let t=r.map(({relName:t,rawRelation:o})=>{let{target:r}=o,i=JSON.stringify(o,null,2).replace(/\n/g,"\n      ");return`    ${t}: ${n}<'${e}', '${r}'>(${i}),`});o.push(`  ${e}: {
+export const generateRelationExpressionsCode=(e,n)=>{let t=new Map;for(let[n,o]of e.expressions)for(let[,e]of o){if("relation"!==e.implementation.kind)continue;let o=String(n);t.has(o)||t.set(o,[]);let[r]=e.implementation.params;t.get(o).push({relName:String(e.name),rawRelation:r})}if(0===t.size)return"{} as const";let o=[];for(let[e,r]of t){let t=r.map(({relName:e,rawRelation:t})=>{let o=JSON.stringify(t,null,2).replace(/\n/g,"\n      ");return`    ${e}: ${n}(${o}),`});o.push(`  ${e}: {
 ${t.join("\n")}
   },`)}return`{
 ${o.join("\n")}

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

@@ -1,20 +1,18 @@
 import type { ApplicationSpec } from '../../../../parse-application-files/index.js';
 import type { RawResourceEntry } from '../../../../parse-application-files/raw-spec/raw-resources.js';
 /**
- * Emits a `new ResourceBuilder().addX({...})...build()` chain mirroring the
- * declared resources. The builder's `const` generics carry every resource name
- * as a string literal, so `typeof generatedResources` infers the full typed
- * union that the downstream `ConfiguratorBuilder.withResources(...)` call
- * propagates into webhook handlers and frontend code.
+ * Emits the declared resources as an array literal with `as const`. The assertion
+ * keeps every resource name as a string literal, so `typeof generatedResources`
+ * carries the union of names that the downstream `ConfiguratorBuilder.withResources(...)`
+ * call propagates into webhook handlers and frontend code. That call is also what
+ * checks each entry against the resource types.
  */
-export declare const generateResourceBuilderChain: (resources: readonly RawResourceEntry[]) => string;
+export declare const generateResourcesLiteral: (resources: readonly RawResourceEntry[]) => string;
 export interface ResourcesCodegen {
     /** Block to inject before the `baseConfiguratorBuilder` declaration — empty when no resources. */
     readonly preBlock: string;
     /** Chain call to append to the builder — empty when no resources. */
     readonly builderCall: string;
-    /** True when the spec declares at least one resource and `ResourceBuilder` must be imported. */
-    readonly hasResources: boolean;
 }
 /**
  * Builds the full resources codegen surface: the `export const generatedResources`

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

@@ -1,34 +1,34 @@
-import{P as e,match as t}from"ts-pattern";export const generateResourceBuilderChain=r=>{let n=r.map(r=>t(r).with({type:"ConfigurationLink"},e=>`  .addLink({
+import{P as e,match as t}from"ts-pattern";export const generateResourcesLiteral=r=>{let n=r.map(r=>t(r).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());return`new ResourceBuilder()
+  },`).exhaustive());return`[
 ${n.join("\n")}
-  .build()`};export const generateResourcesCodegen=e=>{let t=e.infra.resources;if(!(void 0!==t&&t.length>0))return{preBlock:"",builderCall:"",hasResources:!1};let r=generateResourceBuilderChain(t);return{preBlock:`
+] as const`};export const generateResourcesCodegen=e=>{let t=e.infra.resources;if(void 0===t||0===t.length)return{preBlock:"",builderCall:""};let r=generateResourcesLiteral(t);return{preBlock:`
 // ---- Resources ----
 
 export const generatedResources = ${r}
 
 export type Resource = (typeof generatedResources)[number]['name']
-`,builderCall:"\n  .withResources(generatedResources)",hasResources:!0}};
+`,builderCall:"\n  .withResources(generatedResources)"}};

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

@@ -13,7 +13,7 @@ export { generatePhxExportsBlock, generatePhxGlobalsBlock } from './generate-phx
 export { generatePresetsCode } from './generate-presets.js';
 export { generateRelationExpressionsCode } from './generate-relation-expressions.js';
 export { generateMemoEvalPlanCode } from './generate-memo-eval-plan-code.js';
-export { generateResourceBuilderChain, generateResourcesCodegen, type ResourcesCodegen } from './generate-resources.js';
+export { generateResourcesLiteral, generateResourcesCodegen, type ResourcesCodegen } from './generate-resources.js';
 export { generateResourcesConfigCall } from './generate-resources-config.js';
 export { generateImportedStateConstants, generateStateConstants, generateStateTypeDecls, type StateConstantsGenerator, } from './generate-states.js';
 export { generateTextLanguagesCall } from './generate-text-languages.js';

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

@@ -1 +1 @@
-export{generateAclCall}from"./generate-acl.js";export{generateApplicationMetadataBlock}from"./generate-application-metadata.js";export{generateAssistantBlock}from"./generate-assistant.js";export{generateBaseConfiguratorBuilder}from"./generate-base-configurator-builder.js";export{generateComponentOpticsCode}from"./generate-component-optics.js";export{generateDataSchemaConstants}from"./generate-data-schemas.js";export{generateChunksSpec,generateDataSpec}from"./generate-data-spec.js";export{generateDefaultsBlock}from"./generate-defaults.js";export{generateDomainBlock}from"./generate-domain-block.js";export{generateInvariantsBlock}from"./generate-invariants.js";export{generateLocaleCodegen}from"./generate-locale.js";export{generatePhxExportsBlock,generatePhxGlobalsBlock}from"./generate-phx-globals.js";export{generatePresetsCode}from"./generate-presets.js";export{generateRelationExpressionsCode}from"./generate-relation-expressions.js";export{generateMemoEvalPlanCode}from"./generate-memo-eval-plan-code.js";export{generateResourceBuilderChain,generateResourcesCodegen}from"./generate-resources.js";export{generateResourcesConfigCall}from"./generate-resources-config.js";export{generateImportedStateConstants,generateStateConstants,generateStateTypeDecls}from"./generate-states.js";export{generateTextLanguagesCall}from"./generate-text-languages.js";
+export{generateAclCall}from"./generate-acl.js";export{generateApplicationMetadataBlock}from"./generate-application-metadata.js";export{generateAssistantBlock}from"./generate-assistant.js";export{generateBaseConfiguratorBuilder}from"./generate-base-configurator-builder.js";export{generateComponentOpticsCode}from"./generate-component-optics.js";export{generateDataSchemaConstants}from"./generate-data-schemas.js";export{generateChunksSpec,generateDataSpec}from"./generate-data-spec.js";export{generateDefaultsBlock}from"./generate-defaults.js";export{generateDomainBlock}from"./generate-domain-block.js";export{generateInvariantsBlock}from"./generate-invariants.js";export{generateLocaleCodegen}from"./generate-locale.js";export{generatePhxExportsBlock,generatePhxGlobalsBlock}from"./generate-phx-globals.js";export{generatePresetsCode}from"./generate-presets.js";export{generateRelationExpressionsCode}from"./generate-relation-expressions.js";export{generateMemoEvalPlanCode}from"./generate-memo-eval-plan-code.js";export{generateResourcesLiteral,generateResourcesCodegen}from"./generate-resources.js";export{generateResourcesConfigCall}from"./generate-resources-config.js";export{generateImportedStateConstants,generateStateConstants,generateStateTypeDecls}from"./generate-states.js";export{generateTextLanguagesCall}from"./generate-text-languages.js";

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

@@ -1,38 +1,38 @@
-import{CodeImports as e,autoHeader as a,skipApplicationTypeImports as i}from"../common/index.js";import{generateApplicationMetadataBlock as o,generateAssistantBlock as n,generateBaseConfiguratorBuilder as t,generateChunksSpec as s,generateDataSchemaConstants as r,generateDataSpec as p,generateDomainBlock as m,generateLocaleCodegen as d,generatePhxGlobalsBlock as c,generateResourcesCodegen as l,generateStateConstants as u}from"./domain-spec/index.js";let x="@salsita-ai/sdk/domain",g="@salsita-ai/sdk/i18n";export const globalDomainSpecPhxBinding={generateBindingBlock:c,generateStateConstants:u,registerApplicationTypeImports:i};export const generateApplicationSpecDomainSpecFile=(i,c=globalDomainSpecPhxBinding)=>{let u=new e,{registerApplicationTypeImports:f}=c,E=m({domainSpec:i.configurator,invariants:i.configurator.invariants,actions:i.configurator.actions,typePrefix:"",versionNsPrefix:"ModelV",isAdmin:!1,modelVersionsExportName:"modelVersions",relationExpressionsExportName:"relationExpressions",componentOpticsExportName:"componentOptics",valueExpressionsExportName:"valueExpressions",createRecipeExportName:"createRecipe",imports:u,registerApplicationTypeImports:f}),S=m({domainSpec:i.admin,invariants:i.admin.invariants,actions:void 0,typePrefix:"Admin",versionNsPrefix:"AdminV",isAdmin:!0,modelVersionsExportName:"adminModelVersions",relationExpressionsExportName:"adminRelationExpressions",componentOpticsExportName:"adminComponentOptics",valueExpressionsExportName:"adminValueExpressions",createRecipeExportName:"createAdminRecipe",imports:u,registerApplicationTypeImports:f}),{hasResources:$}=l(i);u.addImport(x,"ConfiguratorBuilder"),u.addImport(x,"EnumReflection"),u.addTypeImport(x,"AssistantResolvedManifest"),u.addTypeImport(x,"ChunksSpec"),u.addTypeImport(x,"DataSpec"),u.addTypeImport(x,"EnumLike"),$&&u.addImport(x,"ResourceBuilder"),u.addImport(g,"mergeCatalogs"),u.addImport(g,"sdkCatalog"),u.addImport("@lingui/core","setupI18n");let v=r(i.configurator.dataSchemas,u,f),k=c.generateStateConstants({configuratorStates:i.configurator.states,adminStates:i.admin.states},u,f),I=o(i),{importBlock:N,catalogBlock:h,createI18nExport:A}=d(i.configurator.ui.availableLocales),{preBlock:B,builderBlock:C}=t(i,u,f),R=c.generateBindingBlock();return`${a("domain-spec.ts","Domain builders, model schemas, component optics and expression definitions derived from the spec.")}
-${u.toString()}${N}
+import{CodeImports as e,autoHeader as a,skipApplicationTypeImports as i}from"../common/index.js";import{generateApplicationMetadataBlock as o,generateAssistantBlock as n,generateBaseConfiguratorBuilder as t,generateChunksSpec as s,generateDataSchemaConstants as r,generateDataSpec as p,generateDomainBlock as m,generateLocaleCodegen as d,generatePhxGlobalsBlock as c,generateStateConstants as l}from"./domain-spec/index.js";let x="@salsita-ai/sdk/domain",u="@salsita-ai/sdk/i18n";export const globalDomainSpecPhxBinding={generateBindingBlock:c,generateStateConstants:l,registerApplicationTypeImports:i};export const generateApplicationSpecDomainSpecFile=(i,c=globalDomainSpecPhxBinding)=>{let l=new e,{registerApplicationTypeImports:g}=c,f=m({domainSpec:i.configurator,invariants:i.configurator.invariants,actions:i.configurator.actions,typePrefix:"",versionNsPrefix:"ModelV",isAdmin:!1,modelVersionsExportName:"modelVersions",relationExpressionsExportName:"relationExpressions",componentOpticsExportName:"componentOptics",valueExpressionsExportName:"valueExpressions",createRecipeExportName:"createRecipe",imports:l,registerApplicationTypeImports:g}),E=m({domainSpec:i.admin,invariants:i.admin.invariants,actions:void 0,typePrefix:"Admin",versionNsPrefix:"AdminV",isAdmin:!0,modelVersionsExportName:"adminModelVersions",relationExpressionsExportName:"adminRelationExpressions",componentOpticsExportName:"adminComponentOptics",valueExpressionsExportName:"adminValueExpressions",createRecipeExportName:"createAdminRecipe",imports:l,registerApplicationTypeImports:g});l.addImport(x,"ConfiguratorBuilder"),l.addImport(x,"EnumReflection"),l.addTypeImport(x,"AssistantResolvedManifest"),l.addTypeImport(x,"ChunksSpec"),l.addTypeImport(x,"DataSpec"),l.addTypeImport(x,"EnumLike"),l.addImport(u,"mergeCatalogs"),l.addImport(u,"sdkCatalog"),l.addImport("@lingui/core","setupI18n");let S=r(i.configurator.dataSchemas,l,g),$=c.generateStateConstants({configuratorStates:i.configurator.states,adminStates:i.admin.states},l,g),v=o(i),{importBlock:k,catalogBlock:N,createI18nExport:I}=d(i.configurator.ui.availableLocales),{preBlock:h,builderBlock:A}=t(i,l,g),B=c.generateBindingBlock();return`${a("domain-spec.ts","Domain builders, model schemas, component optics and expression definitions derived from the spec.")}
+${l.toString()}${k}
 
 // ---- Data schemas ----
 
-${v}
+${S}
 
 // ---- Admin domain ----
 
-${S}
+${E}
 
 // ---- Configurator domain ----
 
-${E}
+${f}
 
 // ---- i18n ----
 
-${h}
+${N}
 
-${A}
+${I}
 
 // ---- Application metadata ----
 
-${I}
+${v}
 
 // ---- State enums ----
 
-${k}
+${$}
 
 const $dataSpec: DataSpec = ${p(i.dataSpec.entries)}
 
 const $chunks: ChunksSpec = ${s(i.dataSpec.chunks)}
 
 ${n(i.configurator.assistant)}
-${B}
-${C}
+${h}
+${A}
 
-${R}`};
+${B}`};

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

@@ -1,9 +1,9 @@
-import{CodeImports as i}from"../common/code-imports.js";import{autoHeader as o}from"../common/file-headers.js";let n=/v(\d+)\.ts$/,t=(i,o)=>i.versionedModels.filter(i=>void 0!==i.migrationFile).map(i=>({version:i.version,file:i.migrationFile,importName:o?`${o}MigrateToV${i.version}`:`migrateToV${i.version}`})),s=i=>i.map(i=>{let o=i.file.replace(n,`v${i.version}.js`),t=`migrateToV${i.version}`,s=i.importName!==t?` as ${i.importName}`:"";return`import { ${t}${s} } from '../${o}'`}).join("\n"),e=(i,o,n,t)=>[`const ${t}Migrations = {`,...i.map(i=>`  ${i.version}: ${i.importName},`),"}","",`const ${t} = MigrateFunctionBuilder`,`  .fromVersions(${o})`,`  .to(${n})`,`  .using(${t}Migrations)`,"  .build()"].join("\n");export const generateApplicationSpecDomainFile=n=>{let r=new i,a="./domain-spec.js",m="./configurator-domain-code.js",d="./admin-domain-code.js",p=i=>[...i.expressions.values()].some(i=>[...i.values()].some(i=>"relation"===i.implementation.kind)),l=p(n.configurator.expressions),c=p(n.admin.expressions),u=t(n.configurator.resolvedVersions,""),g=t(n.admin.resolvedVersions,"admin"),h=u.length>0,I=g.length>0;r.addImport(a,"baseConfiguratorBuilder"),r.addImport(a,"domainBuilder"),r.addImport(a,"adminDomainBuilder"),r.addImport(a,"attachComponent"),r.addImport(a,"attachAdminComponent"),r.addImport(a,"implementCustomExpressions"),r.addImport(a,"implementAdminCustomExpressions"),r.addImport(a,"createI18n"),r.addImport(a,"componentOptics"),r.addImport(a,"adminComponentOptics"),r.addImport(a,"invariantBuilder"),r.addImport(a,"adminInvariantBuilder"),r.addImport(m,"customExpressions"),r.addImport(m,"customInvariants"),r.addImport(m,"customActions"),r.addImport(d,"customAdminExpressions"),r.addImport(d,"customAdminInvariants"),l&&r.addImport(a,"relationExpressions"),c&&r.addImport(a,"adminRelationExpressions"),(h||I)&&r.addImport("@salsita-ai/sdk/domain","MigrateFunctionBuilder"),h&&r.addImport(a,"modelVersions"),I&&r.addImport(a,"adminModelVersions");let x=[];h&&x.push(s(u)),I&&x.push(s(g));let v=x.length>0?"\n"+x.join("\n")+"\n":"",$=[];h&&$.push(e(u,"modelVersions",n.configurator.schemaVersion,"migrate")),I&&$.push(e(g,"adminModelVersions",n.admin.schemaVersion,"migrateAdmin"));let E=$.length>0?"\n"+$.join("\n\n")+"\n":"",f=["const domainFactory = domainBuilder",l?"  .withExpressions(relationExpressions)":null,"  .withExpressions(invariantBuilder.withInvariantModules(customInvariants).buildViolationExpressions())","  .withExpressionModules(customExpressions)","  .withActionModules(customActions)",h?"  .withMigrate(migrate)":null,"  .build()"].filter(Boolean).join("\n"),A=["const adminDomainFactory = adminDomainBuilder",c?"  .withExpressions(adminRelationExpressions)":null,"  .withExpressions(adminInvariantBuilder.withInvariantModules(customAdminInvariants).buildViolationExpressions())","  .withExpressionModules(customAdminExpressions)",I?"  .withMigrate(migrateAdmin)":null,"  .build()"].filter(Boolean).join("\n");return`${o("domain.ts","Assembles domain and admin domain factories from builders, migrations, expressions and invariants.")}
-${r.toString()}
+import{CodeImports as o}from"../common/code-imports.js";import{autoHeader as i}from"../common/file-headers.js";let n=/v(\d+)\.ts$/,s=(o,i)=>o.versionedModels.filter(o=>void 0!==o.migrationFile).map(o=>({version:o.version,file:o.migrationFile,importName:i?`${i}MigrateToV${o.version}`:`migrateToV${o.version}`})),t=o=>o.map(o=>{let i=o.file.replace(n,`v${o.version}.js`),s=`migrateToV${o.version}`,t=o.importName!==s?` as ${o.importName}`:"";return`import { ${s}${t} } from '../${i}'`}).join("\n"),e=(o,i,n,s)=>[`const ${s}Migrations = {`,...o.map(o=>`  ${o.version}: ${o.importName},`),"}","",`const ${s} = createMigrateFunction(${i}, ${n}, ${s}Migrations)`].join("\n");export const generateApplicationSpecDomainFile=n=>{let a=new o,r="./domain-spec.js",m="./configurator-domain-code.js",d="./admin-domain-code.js",p="@salsita-ai/sdk/domain",l=o=>[...o.expressions.values()].some(o=>[...o.values()].some(o=>"relation"===o.implementation.kind)),c=l(n.configurator.expressions),u=l(n.admin.expressions),x=s(n.configurator.resolvedVersions,""),I=s(n.admin.resolvedVersions,"admin"),g=x.length>0,h=I.length>0;a.addImport(r,"baseConfiguratorBuilder"),a.addImport(r,"domainBuilder"),a.addImport(r,"adminDomainBuilder"),a.addImport(r,"attachComponent"),a.addImport(r,"attachAdminComponent"),a.addImport(r,"implementCustomExpressions"),a.addImport(r,"implementAdminCustomExpressions"),a.addImport(r,"createI18n"),a.addImport(r,"componentOptics"),a.addImport(r,"adminComponentOptics"),a.addImport(r,"aliases"),a.addImport(r,"adminAliases"),a.addImport(r,"commonAdminInvariants"),a.addImport(p,"createViolationExpressions"),a.addImport(m,"customExpressions"),a.addImport(m,"customInvariants"),a.addImport(m,"customActions"),a.addImport(d,"customAdminExpressions"),a.addImport(d,"customAdminInvariants"),c&&a.addImport(r,"relationExpressions"),u&&a.addImport(r,"adminRelationExpressions"),(g||h)&&a.addImport(p,"createMigrateFunction"),g&&a.addImport(r,"modelVersions"),h&&a.addImport(r,"adminModelVersions");let $=[];g&&$.push(t(x)),h&&$.push(t(I));let v=$.length>0?"\n"+$.join("\n")+"\n":"",A=[];g&&A.push(e(x,"modelVersions",n.configurator.schemaVersion,"migrate")),h&&A.push(e(I,"adminModelVersions",n.admin.schemaVersion,"migrateAdmin"));let E=A.length>0?"\n"+A.join("\n\n")+"\n":"",f=["const domainFactory = domainBuilder",c?"  .withExpressions(relationExpressions)":null,"  .withExpressions(createViolationExpressions(aliases, customInvariants))","  .withExpressionModules(customExpressions)","  .withActionModules(customActions)",g?"  .withMigrate(migrate)":null,"  .build()"].filter(Boolean).join("\n"),w=["const adminDomainFactory = adminDomainBuilder",u?"  .withExpressions(adminRelationExpressions)":null,"  .withExpressions(createViolationExpressions(adminAliases, customAdminInvariants, commonAdminInvariants))","  .withExpressionModules(customAdminExpressions)",h?"  .withMigrate(migrateAdmin)":null,"  .build()"].filter(Boolean).join("\n");return`${i("domain.ts","Assembles domain and admin domain factories from builders, migrations, expressions and invariants.")}
+${a.toString()}
 ${v}export { attachComponent, attachAdminComponent, implementCustomExpressions, implementAdminCustomExpressions, createI18n }
 ${E}
 ${f}
-${A}
+${w}
 
 export const configuratorBuilder = baseConfiguratorBuilder
   .withDomainFactory(domainFactory)

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

@@ -1 +1,6 @@
+/**
+ * The project's `eslint.config.js`, written once when the project has none. It re-exports the SDK's
+ * shared ESLint configuration so editors find it in the project root; the project may change it
+ * afterwards. `phoenix check` and `phoenix fix` use the SDK's configuration when the file is missing.
+ */
 export declare const generateApplicationSpecEslintConfig: () => string;

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

@@ -1,8 +1,7 @@
-let e=`/**
- * Auto-generated file.
- * Do not modify this file manually.
- * Version: 1
- */`;export const generateApplicationSpecEslintConfig=()=>`${e}
+export const generateApplicationSpecEslintConfig=()=>`/**
+ * The project's ESLint configuration. It re-exports the shared configuration of the Phoenix SDK;
+ * change it to adjust the rules for this project.
+ */
 import { eslintrc } from '@salsita-ai/sdk/common/eslint'
 
 export default eslintrc

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

@@ -1,9 +1,7 @@
-import{generateEnvReader as e}from"../common/env-reader.js";import{autoHeader as t}from"../common/file-headers.js";let o={IS_DEV:{type:"bool",default:!1,devDefault:!0},SERVER_URL:{type:"str",devDefault:"http://localhost:3000"},ENVIRONMENT_ID:{type:"str"},DEPLOYMENT_ID:{type:"str"},GTM_ID:{type:"str"},GTM_DEBUG:{type:"bool",default:!1,devDefault:!0},PERSISTENCE_MODE:{type:"str",default:"server",devDefault:"server",choices:["memory","local-storage","server"]},DATADOG_SITE:{type:"str"},DATADOG_CLIENT_TOKEN:{type:"str"},DATADOG_ENABLED:{type:"bool",default:!0,devDefault:!1},SERVICE_NAME:{type:"str",devDefault:"local"},RESOURCES_URL:{type:"str",devDefault:"http://localhost:5173"}},r={CLERK_PUBLISHABLE_KEY:{type:"str",required:!0}};export const generateApplicationSpecFrontendConfig=a=>{let n=a.infra.env?.frontend??{},d=a.appMetadata.useClerk?r:{},{imports:l,config:i}=e({...o,...d,...n}),p=l.length>0?`import { ${l.join(", ")} } from 'envalid'
+import{generateEnvReader as e}from"../common/env-reader.js";import{autoHeader as t}from"../common/file-headers.js";let o={IS_DEV:{type:"bool",default:!1,devDefault:!0},SERVER_URL:{type:"str",devDefault:"http://localhost:3000"},ENVIRONMENT_ID:{type:"str"},DEPLOYMENT_ID:{type:"str"},GTM_ID:{type:"str"},GTM_DEBUG:{type:"bool",default:!1,devDefault:!0},PERSISTENCE_MODE:{type:"str",default:"server",devDefault:"server",choices:["memory","local-storage","server"]},DATADOG_SITE:{type:"str"},DATADOG_CLIENT_TOKEN:{type:"str"},DATADOG_ENABLED:{type:"bool",default:!0,devDefault:!1},SERVICE_NAME:{type:"str",devDefault:"local"},RESOURCES_URL:{type:"str",devDefault:"http://localhost:5173"}},r={CLERK_PUBLISHABLE_KEY:{type:"str",required:!0}};export const generateApplicationSpecFrontendConfig=a=>{let n=a.infra.env?.frontend??{},d=a.appMetadata.useClerk?r:{},{imports:l,config:p}=e({...o,...d,...n}),i=[...l,"createEnvReader"].sort();return`${t("frontend.config.ts","Runtime environment config for the frontend (Vite-injected env vars).")}
+import { ${i.join(", ")} } from '@salsita-ai/sdk/common/env'
 
-`:"";return`${t("frontend.config.ts","Runtime environment config for the frontend (Vite-injected env vars).")}
-${p}import { createEnvReader } from '@salsita-ai/sdk/common/env'
-
-export const readRuntimeConfig = createEnvReader(${i})
+export const readRuntimeConfig = createEnvReader(${p})
 
 export type RuntimeConfig = ReturnType<typeof readRuntimeConfig>
 

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

@@ -51,9 +51,6 @@ phoenix-api.yaml
 .phoenix
 **/locales/*/*.ts
 phoenix.config.ts
-prettier.config.js
-eslint.config.js
-tsconfig.json
 .prettierignore
 .linguirc
 public/robots.txt

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

@@ -1,9 +1,9 @@
-import{autoHeader as e}from"../common/file-headers.js";import{generateApplicationSpecTypeDeclarations as a}from"./application-types.js";export const generateApplicationSpecGlobals=(o,n)=>{let t,i,l,r,d,s,p,m,y,{declarations:c,imports:f}=a(o,n,2);f.addTypeImport("@salsita-ai/sdk/domain","EnumLike");let h=[c,(t=o.configurator.latestModel,i=o.admin.latestModel,l=t.entityTypes.map(String),r=[...t.aliases].map(([e])=>String(e)),d=[...t.commonTypes].map(([e])=>String(e)),s=i.entityTypes.map(String),p=[...i.aliases].map(([e])=>String(e)),m=[...i.commonTypes].map(([e])=>String(e)),y=(e,a)=>e.map(e=>`    ${a(e)}`).join("\n"),`  interface Model {
-${y([...l,...d,...r],e=>`readonly ${e}: ${e}`)}
+import{autoHeader as e}from"../common/file-headers.js";import{generateApplicationSpecTypeDeclarations as a}from"./application-types.js";export const generateApplicationSpecGlobals=(o,t)=>{let n,i,r,d,l,s,p,m,y,{declarations:c,imports:f}=a(o,t,2);f.addTypeImport("@salsita-ai/sdk/domain","EnumLike");let h=[c,(n=o.configurator.latestModel,i=o.admin.latestModel,r=n.entityTypes.map(String),d=[...n.aliases].map(([e])=>String(e)),l=[...n.commonTypes].map(([e])=>String(e)),s=i.entityTypes.map(String),p=[...i.aliases].map(([e])=>String(e)),m=[...i.commonTypes].map(([e])=>String(e)),y=(e,a)=>e.map(e=>`    ${a(e)}`).join("\n"),`  interface Model {
+${y([...r,...l,...d],e=>`readonly ${e}: ${e}`)}
   }
 
   interface EnhancedModel {
-${y([...l,...r],e=>`readonly $${e}: $${e}`)}
+${y([...r,...d],e=>`readonly $${e}: $${e}`)}
   }
 
   interface AdminModel {
@@ -38,8 +38,10 @@ ${y([...s,...p],e=>`readonly $${e}: Admin.$${e}`)}
     readonly ApplicationTypes: ApplicationTypes
   }`)].filter(Boolean).join("\n\n");return`${e("globals.d.ts","Global type declarations for the phx namespace, env configs and domain types.")}
 /* eslint-disable @typescript-eslint/triple-slash-reference, @typescript-eslint/consistent-type-imports */
-/// <reference types="vite/client" />
 /// <reference types="@salsita-ai/sdk/globals" />
+// The project's tsconfig includes \`.phoenix\`, but TypeScript checks a file under a dot folder only
+// when it is named or imported. Nothing imports the module of YAML code yet, so it is named here.
+/// <reference path="./spec-code.ts" />
 
 ${f.toTypeOnlyString(".phoenix/globals.d.ts")}
 
@@ -74,6 +76,7 @@ ${h}
       readonly implementCustomExpressions: typeof import('./domain-spec.js').implementCustomExpressions
       readonly implementCustomInvariants: typeof import('./domain-spec.js').implementCustomInvariants
       readonly implementActions: typeof import('./domain-spec.js').implementActions
+      readonly createAssistantSetupHandler: typeof import('./domain-spec.js').createAssistantSetupHandler
       readonly attachComponent: typeof import('./domain-spec.js').attachComponent
       readonly createRecipe: typeof import('./domain-spec.js').createRecipe