@salsita-ai/sdk 0.49.0 → 0.50.0-develop.016963b09e

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

@@ -1,8 +1,8 @@
-import { type ApplicationTypeImportRegistrar } from '../common/index.js';
 interface GenerateConfiguratorCodeOptions {
     readonly expressionFiles: readonly string[];
+    readonly actionFiles: readonly string[];
     readonly invariantFiles: readonly string[];
     readonly componentFiles: readonly string[];
 }
-export declare const generateApplicationSpecConfiguratorCode: (options: GenerateConfiguratorCodeOptions, registerApplicationTypeImports?: ApplicationTypeImportRegistrar) => string;
+export declare const generateApplicationSpecConfiguratorCode: (options: GenerateConfiguratorCodeOptions) => string;
 export {};

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

@@ -1,17 +1,11 @@
-import{autoHeader as n}from"../common/file-headers.js";import{CodeImports as t,skipApplicationTypeImports as e}from"../common/index.js";let o=(n,t)=>n.map((n,e)=>{let o=`../${n.replace(/\.tsx?$/,".js")}`;return`import ${t}${e} from '${o}'`}),s=(n,t="\n")=>n.length>0?"\n"+n.join(t)+"\n":"";export const generateApplicationSpecConfiguratorCode=(a,i=e)=>{let{expressionFiles:r,invariantFiles:p,componentFiles:m}=a,d=new t;for(let n of["AliasedExpressions","AliasedInvariants","DomainComponentOptic","SystemComponentTypeConstraint"])d.addTypeImport("@salsita-ai/sdk/domain",n);i(d,["Aliases","AnyDomainEntity","FrontendData","PublishedData","RootEntity","SessionData"]);let c=[...o(r,"expressions"),...o(p,"invariants"),...o(m,"components")],y=r.map((n,t)=>`for (const [type, exprs] of Object.entries(expressions${t})) {
-  mergedExpressions[type] = { ...mergedExpressions[type], ...exprs }
-}`),l=p.map((n,t)=>`for (const [type, invs] of Object.entries(invariants${t})) {
-  mergedInvariants[type] = [...(mergedInvariants[type] ?? []), ...invs]
-}`),x=m.map((n,t)=>`components${t}`);return`${n("configurator-domain-code.ts","Barrel file for user-authored domain code — expressions, invariants and components. Needs only phx.domain.")}
+import{autoHeader as o}from"../common/file-headers.js";import{CodeImports as n,generateProjectModuleImports as e,generateProjectModuleList as t}from"../common/index.js";export const generateApplicationSpecConfiguratorCode=s=>{let{expressionFiles:r,actionFiles:i,invariantFiles:a,componentFiles:c}=s,d=new n;d.addTypeImport("@salsita-ai/sdk/domain","ProjectModule");let p=[...e(r,"expressions"),...e(i,"actions"),...e(a,"invariants"),...e(c,"components")];return`${o("configurator-domain-code.ts","Barrel file for user-authored domain code — expressions, actions, invariants and components. Needs only phx.domain.")}
 ${d.toString()}
-${s(c)}
-const mergedExpressions: Record<string, Record<string, unknown>> = {}
-${s(y,"\n\n")}
-export const customExpressions = mergedExpressions as AliasedExpressions<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>
+${p.length>0?"\n"+p.join("\n")+"\n":""}
+export const customExpressions: readonly ProjectModule[] = ${t(r,"expressions")}
 
-const mergedInvariants: Record<string, ReadonlyArray<unknown>> = {}
-${s(l,"\n\n")}
-export const customInvariants = mergedInvariants as AliasedInvariants<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases, string>
+export const customActions: readonly ProjectModule[] = ${t(i,"actions")}
 
-export const customComponentOptics: ReadonlyArray<DomainComponentOptic<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, AnyDomainEntity, SystemComponentTypeConstraint>> = [${x.join(", ")}].flat()
+export const customInvariants: readonly ProjectModule[] = ${t(a,"invariants")}
+
+export const customComponentOptics: readonly ProjectModule[] = ${t(c,"components")}
 `};

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

@@ -1,9 +1,8 @@
-import { type ApplicationTypeImportRegistrar } from '../common/index.js';
 interface GenerateConfiguratorFrontendCodeOptions {
     readonly transformerFiles: readonly string[];
     readonly handlerFiles: readonly string[];
     readonly elementFiles: readonly string[];
     readonly componentFiles: readonly string[];
 }
-export declare const generateApplicationSpecConfiguratorFrontendCode: (options: GenerateConfiguratorFrontendCodeOptions, registerApplicationTypeImports?: ApplicationTypeImportRegistrar) => string;
+export declare const generateApplicationSpecConfiguratorFrontendCode: (options: GenerateConfiguratorFrontendCodeOptions) => string;
 export {};

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

@@ -1,15 +1,13 @@
-import{autoHeader as t}from"../common/file-headers.js";import{CodeImports as n,skipApplicationTypeImports as o}from"../common/index.js";let e=(t,n)=>t.map((t,o)=>{let e=`../${t.replace(/\.tsx?$/,".js")}`;return`import ${n}${o} from '${e}'`});export const generateApplicationSpecConfiguratorFrontendCode=(r,a=o)=>{let{transformerFiles:s,handlerFiles:i,elementFiles:m,componentFiles:p}=r,l=new n;for(let t of["DomainComponentOptic","ElementRegistration","HandlerRegistration","ImportedTransformer","SystemComponentTypeConstraint"])l.addTypeImport("@salsita-ai/sdk/domain",t);a(l,["$Map","AnyDomainEntity","ExportState","FrontendData","NavigationState","PublishedData","RootEntity","SessionData","ToolState","ViewState"]);let d=[...e(s,"transformers"),...e(i,"handlers"),...e(m,"elements"),...e(p,"frontendComponents")],f=s.map((t,n)=>{let o=t.replace(/^.*\//,"").replace(/\.tsx?$/,"");return`  { name: '${o}', transformer: transformers${n} }`}),y=i.map((t,n)=>`handlers${n}`),c=m.map((t,n)=>`elements${n}`),$=p.map((t,n)=>`frontendComponents${n}`);return`${t("configurator-frontend-code.ts","Barrel file for user-authored frontend code — transformers, handlers, elements and frontend-only components. Needs phx.frontend.")}
-${l.toString()}
+import{autoHeader as o}from"../common/file-headers.js";import{CodeImports as e,generateProjectModuleImports as n,generateProjectModuleList as r}from"../common/index.js";export const generateApplicationSpecConfiguratorFrontendCode=t=>{let{transformerFiles:s,handlerFiles:d,elementFiles:l,componentFiles:a}=t,m=new e;m.addTypeImport("@salsita-ai/sdk/domain","ProjectModule");let c=[...n(s,"transformers"),...n(d,"handlers"),...n(l,"elements"),...n(a,"frontendComponents")];return`${o("configurator-frontend-code.ts","Barrel file for user-authored frontend code — transformers, handlers, elements and frontend-only components. Needs phx.frontend.")}
+${m.toString()}
 
 import './configurator-globals.js'
-${d.length>0?"\n"+d.join("\n")+"\n":""}
-export const customTransformers: ReadonlyArray<ImportedTransformer<AnyDomainEntity, RootEntity, $Map, NavigationState, ViewState, ToolState, ExportState>> = [
-${f.join(",\n")}
-]
+${c.length>0?"\n"+c.join("\n")+"\n":""}
+export const customTransformers: readonly ProjectModule[] = ${r(s,"transformers")}
 
-export const customHandlers: ReadonlyArray<HandlerRegistration<any, any>> = [${y.join(", ")}].flat()
+export const customHandlers: readonly ProjectModule[] = ${r(d,"handlers")}
 
-export const customElements: readonly ElementRegistration[] = [${c.join(", ")}].flat()
+export const customElements: readonly ProjectModule[] = ${r(l,"elements")}
 
-export const customFrontendComponentOptics: ReadonlyArray<DomainComponentOptic<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, AnyDomainEntity, SystemComponentTypeConstraint>> = [${$.join(", ")}].flat()
+export const customFrontendComponentOptics: readonly ProjectModule[] = ${r(a,"frontendComponents")}
 `};

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

@@ -1,6 +1,6 @@
 import type { AssistantSpec } from '../../../../parse-application-files/index.js';
 /**
- * Emits the `$assistant` constant handed to `baseConfiguratorBuilder.withAssistant()`: the parse-time
- * assistant manifest with its GraphQL SDL, or `null` when the spec declares no `assistant` section.
+ * Emits the `$assistant` constant handed to `baseConfiguratorBuilder.withAssistant()`: the resolved
+ * JSON manifest, or `null` when the spec declares no `assistant` section.
  */
 export declare const generateAssistantBlock: (assistant: AssistantSpec) => string;

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

@@ -1 +1 @@
-export const generateAssistantBlock=s=>`const $assistant: AssistantManifest | null = ${JSON.stringify(s,null,2)}`;
+export const generateAssistantBlock=s=>`const $assistant: AssistantResolvedManifest | null = ${JSON.stringify(s?.resolved??null,null,2)}`;

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-domain-block.d.ts

@@ -1,4 +1,4 @@
-import type { Components, Defaults, Expressions, Invariants, ModelVersion, Presets, ResolvedVersions } from '../../../../parse-application-files/index.js';
+import type { Actions, Components, Defaults, Expressions, Invariants, ModelVersion, Presets, ResolvedVersions } from '../../../../parse-application-files/index.js';
 import type { ApplicationTypeImportRegistrar, CodeImports } from '../../common/index.js';
 interface DomainBlockSpec {
     readonly components: Components;
@@ -11,6 +11,8 @@ interface DomainBlockSpec {
 export interface DomainBlockOptions {
     readonly domainSpec: DomainBlockSpec;
     readonly invariants: Invariants;
+    /** The declared actions of the configurator domain; `undefined` for the admin domain, which has none. */
+    readonly actions: Actions | undefined;
     readonly typePrefix: string;
     readonly versionNsPrefix: string;
     readonly isAdmin: boolean;

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

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

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

@@ -10,6 +10,7 @@ globalThis.phx.domain = {
   enhancedModel,
   implementCustomExpressions,
   implementCustomInvariants,
+  implementActions,
   attachComponent,
   createRecipe,
 
@@ -50,6 +51,7 @@ globalThis.phx.applicationTypes = {
   readonly enhancedModel: typeof enhancedModel
   readonly implementCustomExpressions: typeof implementCustomExpressions
   readonly implementCustomInvariants: typeof implementCustomInvariants
+  readonly implementActions: typeof implementActions
   readonly attachComponent: typeof attachComponent
   readonly createRecipe: typeof createRecipe
   readonly admin: {
@@ -69,6 +71,7 @@ globalThis.phx.applicationTypes = {
   enhancedModel,
   implementCustomExpressions,
   implementCustomInvariants,
+  implementActions,
   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.js

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

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

@@ -1,5 +1,5 @@
-import{CodeImports as i}from"../common/code-imports.js";import{autoHeader as n}from"../common/file-headers.js";let o=/v(\d+)\.ts$/,t=(i,n)=>i.versionedModels.filter(i=>void 0!==i.migrationFile).map(i=>({version:i.version,file:i.migrationFile,importName:n?`${n}MigrateToV${i.version}`:`migrateToV${i.version}`})),s=i=>i.map(i=>{let n=i.file.replace(o,`v${i.version}.js`),t=`migrateToV${i.version}`,s=i.importName!==t?` as ${i.importName}`:"";return`import { ${t}${s} } from '../${n}'`}).join("\n"),e=(i,n,o,t)=>[`const ${t}Migrations = {`,...i.map(i=>`  ${i.version}: ${i.importName},`),"}","",`const ${t} = MigrateFunctionBuilder`,`  .fromVersions(${n})`,`  .to(${o})`,`  .using(${t}Migrations)`,"  .build()"].join("\n");export const generateApplicationSpecDomainFile=o=>{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(o.configurator.expressions),c=p(o.admin.expressions),u=t(o.configurator.resolvedVersions,""),I=t(o.admin.resolvedVersions,"admin"),g=u.length>0,h=I.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(d,"customAdminExpressions"),r.addImport(d,"customAdminInvariants"),l&&r.addImport(a,"relationExpressions"),c&&r.addImport(a,"adminRelationExpressions"),(g||h)&&r.addImport("@salsita-ai/sdk/domain","MigrateFunctionBuilder"),g&&r.addImport(a,"modelVersions"),h&&r.addImport(a,"adminModelVersions");let x=[];g&&x.push(s(u)),h&&x.push(s(I));let v=x.length>0?"\n"+x.join("\n")+"\n":"",$=[];g&&$.push(e(u,"modelVersions",o.configurator.schemaVersion,"migrate")),h&&$.push(e(I,"adminModelVersions",o.admin.schemaVersion,"migrateAdmin"));let E=$.length>0?"\n"+$.join("\n\n")+"\n":"",f=["const domainFactory = domainBuilder",l?"  .withExpressions(relationExpressions)":null,"  .withExpressions(invariantBuilder.withInvariants(customInvariants).buildViolationExpressions())","  .withExpressions(customExpressions)",g?"  .withMigrate(migrate)":null,"  .build()"].filter(Boolean).join("\n"),w=["const adminDomainFactory = adminDomainBuilder",c?"  .withExpressions(adminRelationExpressions)":null,"  .withExpressions(adminInvariantBuilder.withInvariants(customAdminInvariants).buildViolationExpressions())","  .withExpressions(customAdminExpressions)",h?"  .withMigrate(migrateAdmin)":null,"  .build()"].filter(Boolean).join("\n");return`${n("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}
@@ -8,6 +8,6 @@ ${w}
 export const configuratorBuilder = baseConfiguratorBuilder
   .withDomainFactory(domainFactory)
   .withAdminDomainFactory(adminDomainFactory)
-  .withComponentOptics(componentOptics)
-  .withAdminComponentOptics(adminComponentOptics)
+  .withComponentOptics([{ origin: '.phoenix/domain-spec.ts', exports: componentOptics }])
+  .withAdminComponentOptics([{ origin: '.phoenix/domain-spec.ts', exports: adminComponentOptics }])
 `};

package/dist/application-spec/generate-application/code/templates/global-definition/generate-action-types.d.ts

@@ -0,0 +1,11 @@
+import type { PhoenixDefinitions } from '../../../../core/phoenix-definitions.js';
+import type { Actions, ModelVersion } from '../../../../parse-application-files/index.js';
+import type { CodeImports } from '../../common/code-imports.js';
+/**
+ * Generates the `ActionTypes` map of the declared actions (name → `{ params, result }`) and the
+ * `ActionName`, `ActionParams<NAME>` and `ActionResult<NAME>` types derived from it. A nullable
+ * param is optional. The `description` of an action, a param and a result member becomes the doc
+ * comment of its property, so it shows wherever the types are used. Without actions the map is
+ * empty, so `ActionName` is `never`.
+ */
+export declare const generateActionTypeDecls: (actions: Actions, model: ModelVersion, phxDefinitions: PhoenixDefinitions, imports: CodeImports, indent: number, typeOnlyImports?: boolean) => string;

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

@@ -0,0 +1,8 @@
+import{schemaToTypeString as e}from"../common/schema-to-type-string.js";let t=(e,t)=>{let n=(e??"").trim().replaceAll("*/","*\\/").split("\n").map(e=>e.trim());return""===n[0]||void 0===n[0]?[]:1===n.length?[`${t}/** ${n[0]} */`]:[`${t}/**`,...n.map(e=>`${t} * ${e}`.trimEnd()),`${t} */`]};export const generateActionTypeDecls=(n,r,o,a,p,s=!1)=>{let i=" ".repeat(p),$=" ".repeat(p+2),c=" ".repeat(p+4),l=" ".repeat(p+6),m={phxDefinitions:o,commonTypeNames:new Set(r.commonTypes.keys()),imports:a,typeOnlyImports:s},y=[...n.values()].map(n=>{let r=Object.entries(n.params).flatMap(([n,{schema:r,required:o}])=>[...t(r.description,l),`${l}readonly ${n}${o?"":"?"}: ${e(r,m)}`]),o=Object.entries(n.result).flatMap(([n,r])=>[...t(r.description,l),`${l}readonly ${n}: ${e(r,m)}`]),a=e=>e.length>0?`{
+${e.join("\n")}
+${c}}`:"Record<string, never>";return[...t(n.description,$),`${$}readonly ${n.name}: {`,`${c}readonly params: ${a(r)}`,`${c}readonly result: ${a(o)}`,`${$}}`].join("\n")}),A=y.length>0?`{
+${y.join("\n")}
+${i}}`:"Record<never, never>";return`${i}type ActionTypes = ${A}
+${i}type ActionName = keyof ActionTypes
+${i}type ActionParams<NAME extends ActionName> = ActionTypes[NAME]['params']
+${i}type ActionResult<NAME extends ActionName> = ActionTypes[NAME]['result']`};

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

@@ -1,3 +1,4 @@
+export { generateActionTypeDecls } from './generate-action-types.js';
 export { generateModelTypeDecls } from './generate-model-types.js';
 export { generateExpressionTypeDecls, generateEntityExpressionComposites } from './generate-expression-types.js';
 export { generateDataSchemaTypeDecls } from './generate-data-schema-types.js';

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

@@ -1 +1 @@
-export{generateModelTypeDecls}from"./generate-model-types.js";export{generateExpressionTypeDecls,generateEntityExpressionComposites}from"./generate-expression-types.js";export{generateDataSchemaTypeDecls}from"./generate-data-schema-types.js";
+export{generateActionTypeDecls}from"./generate-action-types.js";export{generateModelTypeDecls}from"./generate-model-types.js";export{generateExpressionTypeDecls,generateEntityExpressionComposites}from"./generate-expression-types.js";export{generateDataSchemaTypeDecls}from"./generate-data-schema-types.js";

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

@@ -73,6 +73,7 @@ ${h}
       readonly enhancedModel: typeof import('./domain-spec.js').enhancedModel
       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 attachComponent: typeof import('./domain-spec.js').attachComponent
       readonly createRecipe: typeof import('./domain-spec.js').createRecipe
 

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

@@ -12,7 +12,6 @@
  * @module
  */
 export { stripSdkMarkerContent } from './common/strip-sdk-marker-content.js';
-export { generateAgentsMd } from './agents-md.js';
 export { generateApplicationSpecAdminConfig } from './admin-config.js';
 export { generateApplicationSpecAdminCode } from './admin-domain-code.js';
 export { generateApplicationSpecAdminFrontendCode } from './admin-frontend-code.js';
@@ -30,8 +29,6 @@ export { generateApplicationSpecDomainFile } from './domain.js';
 export { generateApplicationSpecEditorFile } from './editor.js';
 export { generateApplicationSpecEmbeddedAdmin } from './embedded-admin.js';
 export { generateApplicationSpecEmbeddedConfigurator } from './embedded-configurator.js';
-export { generateApplicationSpecEnvCi } from './env-ci.js';
-export { generateApplicationSpecEnvExample } from './env-example.js';
 export { generateApplicationSpecEslintConfig } from './eslint-config.js';
 export { generateApplicationSpecFavicon } from './favicon.js';
 export { generateApplicationSpecFrontendConfig } from './frontend-config.js';
@@ -42,16 +39,13 @@ export { generateApplicationSpecHtmlIndex } from './html-index.js';
 export { generateLinguiRcFile } from './lingui-rc.js';
 export { generateApplicationSpecNvmrc } from './nvmrc.js';
 export { generateApplicationSpecPackageJson } from './package-json.js';
-export { generatePhoenixCliSkill } from './phoenix-cli-skill.js';
-export { generatePhoenixCreateConfiguratorSkill, generatePhoenixCreateConfiguratorSkillReferences, } from './phoenix-create-configurator-skill.js';
-export { generatePhoenixFeedbackSkill } from './phoenix-feedback-skill.js';
-export { generatePhoenixReviewSkill } from './phoenix-review-skill.js';
-export { type PhoenixSkillOptions, followsCanaryBuilds, generatePhoenixSkill } from './phoenix-skill.js';
+export { generatePhoenixCliSkill } from './skills/phoenix-cli-skill.js';
+export { generatePhoenixCreateConfiguratorSkill, generatePhoenixCreateConfiguratorSkillReferences, } from './skills/phoenix-create-configurator-skill.js';
+export { generatePhoenixFeedbackSkill } from './skills/phoenix-feedback-skill.js';
+export { generatePhoenixReviewSkill } from './skills/phoenix-review-skill.js';
+export { type PhoenixSkillOptions, followsCanaryBuilds, generatePhoenixSkill } from './skills/phoenix-skill.js';
+export { generatePhoenixVariantsSkill } from './skills/phoenix-variants-skill.js';
 export { generateApplicationSpecPrettierConfig } from './prettier-config.js';
-export { generateApplicationSpecPrettierIgnore } from './prettier-ignore.js';
-export { generateApplicationSpecPrivateAssetsReadme } from './private-assets-readme.js';
-export { generateApplicationSpecPublicAssetsReadme } from './public-assets-readme.js';
-export { generateApplicationSpecReadme } from './readme.js';
 export { generateApplicationSpecRobotsTxt } from './robots-txt.js';
 export { generateApplicationSpecStoryDevDeclaration, generateApplicationSpecStoryPhxModule, generateApplicationSpecStoryRawProjectFiles, generateApplicationSpecStoryWrapper, } from './story/index.js';
 export { generateApplicationSpecTsconfig } from './tsconfig.js';