@salsita-ai/sdk 0.50.0-develop.dfac20c66b → 0.50.0-develop.e54f47e4bf

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

@@ -10,8 +10,9 @@
  *
  * Each group module documents the criterion that decides its membership, so a new template
  * self-classifies into exactly one of them. This module owns only the aggregate and adds no files of
- * its own: it concatenates the two application-file groups, in that order, into the `.phoenix`
- * output, and spreads the scaffolding group's project-root buckets alongside them.
+ * its own: it concatenates the two application-file groups and the scaffolding group's `.phoenix`
+ * files, in that order, into the `.phoenix` output, and spreads the scaffolding group's project-root
+ * buckets alongside them.
  *
  * Generated projects always bind phx globally, so the aggregate selects `globalPhxBindingStrategy`.
  * A module-scoped binding is only meaningful to a consumer calling the domain-runtime group on its

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

@@ -1 +1 @@
-import{GeneratedApplication as o}from"../../core/index.js";import{generateDomainRuntimeFiles as e,globalPhxBindingStrategy as i}from"./domain-runtime-files.js";import{generateProjectScaffolding as r}from"./project-scaffolding.js";import{generateStandaloneAppFiles as t}from"./standalone-app-files.js";export const generateApplicationCode=m=>o({files:[...e(m,i),...t(m)],...r(m)});
+import{GeneratedApplication as o}from"../../core/index.js";import{generateDomainRuntimeFiles as e,globalPhxBindingStrategy as r}from"./domain-runtime-files.js";import{generateProjectScaffolding as i}from"./project-scaffolding.js";import{generateStandaloneAppFiles as t}from"./standalone-app-files.js";export const generateApplicationCode=m=>{let{phoenixFiles:n,...p}=i(m);return o({files:[...e(m,r),...t(m),...n],...p})};

package/dist/application-spec/generate-application/code/project-scaffolding.d.ts

@@ -2,7 +2,7 @@
  * Generates the files that configure the generated project itself.
  *
  * Membership criterion: a file belongs to this group when it describes the project rather than the
- * application — dependency and toolchain configuration, formatting rules, agent instructions, and
+ * application — toolchain configuration, formatting rules, agent skills, and
  * the initial content a fresh project starts with. Nothing here is imported by the running
  * configurator or served by the deployed application.
  *
@@ -24,35 +24,43 @@ export declare const agentSkillRoots: readonly ['.claude/skills', '.agents/skill
 /**
  * Inputs required by generated-project configuration and initial project files.
  *
- * The SDK version pins the generated `package.json` dependency, `cliUseWorkspace` lets an explicit
- * CLI flag override the spec's workspace mode, and the optional name and description populate the
- * project metadata. The categorized files carry the project's existing `package.json` and `.gitignore`
- * so those templates can merge rather than clobber, and the legacy cursor rules and `CLAUDE.md` so the
- * SDK block can be stripped from them.
+ * The SDK version and the workspace mode decide whether the agent skills tell the agent to follow the
+ * canary builds; `cliUseWorkspace` lets an explicit CLI flag override the spec's workspace mode. The
+ * categorized files carry the project's existing `.gitignore` so its template can merge rather than
+ * clobber, the legacy cursor rules and `CLAUDE.md` so the
+ * SDK block can be stripped from them, and whether the root `tsconfig.json`, `eslint.config.js` and
+ * `prettier.config.js` are the ones earlier SDK versions generated, so they can be replaced.
+ *
+ * `projectInGitRepository` says whether the project folder is inside a git work tree. `.gitignore` is
+ * generated only then: a project that is not under git has no use for the file, and one it already
+ * has is left as it is. The caller finds this out, because generation reads no file system. The
+ * option defaults to `true`: these options are public through the `application-spec` entry, and a
+ * caller that does not pass it keeps getting `.gitignore`, as every caller did before the option existed.
  */
 export interface GenerateProjectScaffoldingOptions {
     readonly applicationSpec: ApplicationSpec;
     readonly categorizedFiles: CategorizedFiles;
     readonly sdkVersion: string;
+    readonly projectInGitRepository?: boolean;
     readonly cliUseWorkspace?: boolean;
-    readonly name?: string;
-    readonly description?: string;
 }
 /**
- * Project-root file buckets produced independently from the application runtime files.
+ * Project-root file buckets produced independently from the application runtime files, and the
+ * project configuration that lives in `.phoenix/`.
  *
  * The buckets are kept apart because they carry different write intent, which the caching layer
- * acts on: `generatedProjectFiles` are content-diffed and rewritten whenever they differ,
- * `initialProjectFiles` are written only when absent and are the project's to edit afterwards, and
- * `prettierFiles` are separated so a writer can emit the formatting configuration ahead of the
- * output it formats. `removedProjectFiles` lists project-relative paths of files earlier SDK versions
+ * acts on: `phoenixFiles` are paths relative to `.phoenix/` and join the application files there,
+ * rewritten whenever they differ and removed with the rest of the folder's stale output;
+ * `generatedProjectFiles` are content-diffed and rewritten whenever they differ, and
+ * `initialProjectFiles` are written only when absent and are the project's to edit afterwards.
+ * `removedProjectFiles` lists project-relative paths of files earlier SDK versions
  * generated that must no longer exist. As in the generated application bundle these buckets flow
  * into, they express that intent without implementing the write behavior themselves.
  */
 export interface GeneratedProjectScaffolding {
+    readonly phoenixFiles: readonly GeneratedApplicationFile[];
     readonly generatedProjectFiles: readonly GeneratedApplicationFile[];
     readonly initialProjectFiles: readonly GeneratedApplicationFile[];
-    readonly prettierFiles: readonly GeneratedApplicationFile[];
     readonly removedProjectFiles: readonly string[];
 }
 export declare const generateProjectScaffolding: (options: GenerateProjectScaffoldingOptions) => GeneratedProjectScaffolding;

package/dist/application-spec/generate-application/code/project-scaffolding.js

@@ -1,6 +1,6 @@
-import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as t,generateAgentsMd as n,generateApplicationSpecEnvCi as r,generateApplicationSpecEnvExample as o,generateApplicationSpecEslintConfig as i,generateApplicationSpecFavicon as a,generateApplicationSpecGitignore as s,generateApplicationSpecNvmrc as c,generateApplicationSpecPackageJson as l,generateApplicationSpecPrettierConfig as p,generateApplicationSpecPrettierIgnore as m,generateApplicationSpecPrivateAssetsReadme as f,generateApplicationSpecPublicAssetsReadme as d,generateApplicationSpecReadme as g,generateApplicationSpecRobotsTxt as u,generateApplicationSpecTsconfig as x,generateApplicationSpecWebhookImplementation as h,generateLinguiRcFile as v,generatePhoenixCliSkill as j,generatePhoenixCreateConfiguratorSkill as k,generatePhoenixCreateConfiguratorSkillReferences as b,generatePhoenixFeedbackSkill as E,generatePhoenixReviewSkill as F,generatePhoenixSkill as M,stripSdkMarkerContent as P}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let w=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
+import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as r,generateApplicationSpecEslintConfig as t,generateApplicationSpecFavicon as i,generateApplicationSpecGitignore as n,generateApplicationSpecPrettierConfig as a,generateApplicationSpecRobotsTxt as o,generateApplicationSpecRootTsconfig as l,generateApplicationSpecTsconfig as s,generateLinguiRcFile as c,generatePhoenixCliSkill as f,generatePhoenixCreateConfiguratorSkill as p,generatePhoenixCreateConfiguratorSkillReferences as d,generatePhoenixFeedbackSkill as m,generatePhoenixReviewSkill as g,generatePhoenixSkill as h,generatePhoenixVariantsSkill as u,stripSdkMarkerContent as j}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let x=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
 description: Phoenix SDK project rules
 globs:
 alwaysApply: true
 ---
-`}],A=[".claude/commands/review.md",".cursor/commands/review.md"],S=(e,t)=>e.projectFiles.find(e=>e.file.name===t)?.file.content;export const generateProjectScaffolding=C=>{let D,{applicationSpec:L,categorizedFiles:R,sdkVersion:$,cliUseWorkspace:y,name:K,description:G}=C,I=S(R,"package.json"),N=S(R,".gitignore"),T=void 0!==y?y:L.appMetadata.workspace,U=(t=>{let n=[],r=[...A];for(let{path:o,generatedPrefix:i}of w){let a=S(t,o);if(void 0===a)continue;let s=P(a,i);void 0===s?r.push(o):s!==a&&n.push(e(o,s,{format:!1}))}return{strippedFiles:n,removedFiles:r}})(R);return{generatedProjectFiles:[e("package.json",l({sdkVersion:$,useWorkspace:T,useClerk:L.appMetadata.useClerk??!1,name:K,description:G,existingContent:I})),e(".nvmrc",c(),{format:!1}),e(".linguirc",v(L.configurator.ui.availableLocales),{format:!1}),e("tsconfig.json",x()),e("eslint.config.js",i()),e(".gitignore",s(N)),...(D=[{name:"phoenix",content:M({checkLatestCanary:t({useWorkspace:T,sdkVersion:$})}),references:[]},{name:"phoenix-cli",content:j(),references:[]},{name:"phoenix-create-configurator",content:k(),references:b()},{name:"phoenix-feedback",content:E(),references:[]},{name:"phoenix-review",content:F(),references:[]}],agentSkillRoots.flatMap(t=>D.flatMap(n=>[e(`${t}/${n.name}/SKILL.md`,n.content),...n.references.map(r=>e(`${t}/${n.name}/${r.path}`,r.content))]))),...U.strippedFiles],initialProjectFiles:[e("README.md",g(K)),e("AGENTS.md",n()),e(".env.ci",r()),e(".env.example",o()),e("public/favicon.ico",a(),{binary:!0}),e("public/robots.txt",u(),{format:!1}),e("assets/public/README.md",d()),e("assets/private/README.md",f()),e("src/webhooks/index.ts",h())],prettierFiles:[e("prettier.config.js",p()),e(".prettierignore",m(),{format:!1})],removedProjectFiles:U.removedFiles}};
+`}],P=[".claude/commands/review.md",".cursor/commands/review.md"],v=(e,r)=>e.projectFiles.find(e=>e.file.name===r)?.file.content;export const generateProjectScaffolding=F=>{let E,G,{applicationSpec:b,categorizedFiles:k,sdkVersion:w,projectInGitRepository:L=!0,cliUseWorkspace:S}=F,$=v(k,".gitignore"),y=void 0!==S?S:b.appMetadata.workspace,C=(r=>{let t=[],i=[...P];for(let{path:n,generatedPrefix:a}of x){let o=v(r,n);if(void 0===o)continue;let l=j(o,a);void 0===l?i.push(n):l!==o&&t.push(e(n,l,{format:!1}))}return{strippedFiles:t,removedFiles:i}})(k),M={generatedProjectFiles:(E=[{file:e("tsconfig.json",l()),hasEarlierGenerated:k.hasEarlierGeneratedTsconfig},{file:e("eslint.config.js",t()),hasEarlierGenerated:k.hasEarlierGeneratedEslintConfig},{file:e("prettier.config.js",a()),hasEarlierGenerated:k.hasEarlierGeneratedPrettierConfig}]).filter(e=>e.hasEarlierGenerated).map(e=>e.file),initialProjectFiles:E.filter(e=>!e.hasEarlierGenerated).map(e=>e.file)};return{phoenixFiles:[e("tsconfig.json",s()),e(".linguirc",c(b.configurator.ui.availableLocales),{format:!1})],generatedProjectFiles:[...M.generatedProjectFiles,...L?[e(".gitignore",n($))]:[],...(G=[{name:"phoenix",content:h({checkLatestCanary:r({useWorkspace:y,sdkVersion:w})}),references:[]},{name:"phoenix-cli",content:f(),references:[]},{name:"phoenix-create-configurator",content:p(),references:d()},{name:"phoenix-feedback",content:m(),references:[]},{name:"phoenix-review",content:g(),references:[]},{name:"phoenix-variants",content:u(),references:[]}],agentSkillRoots.flatMap(r=>G.flatMap(t=>[e(`${r}/${t.name}/SKILL.md`,t.content),...t.references.map(i=>e(`${r}/${t.name}/${i.path}`,i.content))]))),...C.strippedFiles],initialProjectFiles:[...M.initialProjectFiles,e("public/favicon.ico",i(),{binary:!0}),e("public/robots.txt",o(),{format:!1})],removedProjectFiles:C.removedFiles}};

package/dist/application-spec/generate-application/code/standalone-app-files.d.ts

@@ -18,8 +18,8 @@ import type { ApplicationSpec, CategorizedFiles, RawMockTemplates } from '../../
  * The project and environment slugs address the deployed environment the embedding bootstraps talk
  * to, and `enableEditor` together with `inlineTemplates` and the raw mock templates decide whether
  * and how the optional editor entry point is emitted. The categorized files are needed only to find
- * the authored handlers that are implicitly registered or explicitly pinned into the webhook, not
- * to bind the runtime.
+ * the authored handlers that are implicitly registered or explicitly pinned into the webhook, and
+ * to read whether the project has its own webhook entry, not to bind the runtime.
  */
 export interface GenerateStandaloneAppFilesOptions {
     readonly applicationSpec: ApplicationSpec;

package/dist/application-spec/generate-application/code/standalone-app-files.js

@@ -1 +1 @@
-import{GeneratedApplicationFile as e}from"../../core/index.js";import{generateApplicationSpecAdminConfig as t,generateApplicationSpecAdminFile as a,generateApplicationSpecConfiguratorFile as o,generateApplicationSpecEditorFile as n,generateApplicationSpecEmbeddedAdmin as d,generateApplicationSpecEmbeddedConfigurator as p,generateApplicationSpecFrontendConfig as s,generateApplicationSpecHtmlAdminIndex as i,generateApplicationSpecHtmlIndex as m,generateApplicationSpecWebhookBuilders as r,generateApplicationSpecWebhookIndex as l,generateApplicationSpecWebhooksConfig as f}from"./templates/index.js";import{getWebhookHandlerFileNames as g}from"./webhook-safe-files.js";export const generateStandaloneAppFiles=b=>{let{applicationSpec:c,categorizedFiles:h,projectSlug:w,environmentSlug:x,enableEditor:M,inlineTemplates:T,rawMockTemplates:k}=b,u=k.templates,j=g(h.handlers);return[e("index.html",m(c.appMetadata.webComponentTag,M,c.appMetadata.pageTitle)),e("configurator.ts",o(c.appMetadata.webComponentTag)),e("admin.html",i(c.appMetadata.pageTitle)),e("admin.ts",a()),e("admin-config.ts",t()),e("frontend.config.ts",s(c)),e("webhooks.config.ts",f(c)),e("webhook.ts",l()),e("webhook-builders.ts",r(c,j)),e("embedded-admin.ts",d(w,x)),e("embedded-configurator.ts",p(w,x)),...M?[e("editor.tsx",n(c.appMetadata.webComponentTag,T,u,x))]:[]]};
+import{GeneratedApplicationFile as e}from"../../core/index.js";import{generateApplicationSpecAdminConfig as t,generateApplicationSpecAdminFile as a,generateApplicationSpecConfiguratorFile as o,generateApplicationSpecEditorFile as n,generateApplicationSpecEmbeddedAdmin as s,generateApplicationSpecEmbeddedConfigurator as d,generateApplicationSpecFrontendConfig as p,generateApplicationSpecHtmlAdminIndex as i,generateApplicationSpecHtmlIndex as r,generateApplicationSpecWebhookBuilders as m,generateApplicationSpecWebhookIndex as b,generateApplicationSpecWebhooksConfig as l}from"./templates/index.js";import{getWebhookHandlerFileNames as f}from"./webhook-safe-files.js";export const generateStandaloneAppFiles=g=>{let{applicationSpec:h,categorizedFiles:c,projectSlug:w,environmentSlug:k,enableEditor:x,inlineTemplates:M,rawMockTemplates:T}=g,u=T.templates,j=f(c.handlers);return[e("index.html",r(h.appMetadata.webComponentTag,x,h.appMetadata.pageTitle)),e("configurator.ts",o(h.appMetadata.webComponentTag)),e("admin.html",i(h.appMetadata.pageTitle)),e("admin.ts",a()),e("admin-config.ts",t()),e("frontend.config.ts",p(h)),e("webhooks.config.ts",l(h)),e("webhook.ts",b({hasWebhookEntry:c.hasWebhookEntry})),e("webhook-builders.ts",m(h,j)),e("embedded-admin.ts",s(w,k)),e("embedded-configurator.ts",d(w,k)),...x?[e("editor.tsx",n(h.appMetadata.webComponentTag,M,u,k))]:[]]};

package/dist/application-spec/generate-application/code/story-files.js

@@ -1 +1 @@
-import{GeneratedApplicationFile as e,isTextFile as t}from"../../core/index.js";import{generateDomainRuntimeFiles as i,modulePhxBindingStrategy as r}from"./domain-runtime-files.js";import{generateApplicationSpecStoryDevDeclaration as o,generateApplicationSpecStoryPhxModule as a,generateApplicationSpecStoryRawProjectFiles as n,generateApplicationSpecStoryWrapper as s,generateLinguiRcFile as l}from"./templates/index.js";let p=".phoenix";export const getStoryTextFiles=e=>{let i=e.files.find(e=>"binary"===e.kind);if(i)throw Error(`Cannot build application-spec story: "${i.name}" is binary. Stories inline text project files only; remove the binary asset or demonstrate this project in a demo instead.`);return e.files.filter(t)};export const generateApplicationSpecStoryFiles=t=>{let{application:c,phxDefinitions:m,rawProjectFiles:f,storyFolderName:d,storyName:u}=t,y=getStoryTextFiles(f);return[...i({applicationSpec:c.applicationSpec,categorizedFiles:c.categorizedFiles,phxDefinitions:m,includeDefaultEnvs:!1},r).map(t=>e(`${p}/${t.path}`,t.content,{binary:t.binary,format:t.format})),e(".linguirc",l([...c.applicationSpec.configurator.ui.availableLocales]),{format:!1}),e(`${p}/phx.ts`,a()),e(`${p}/raw-project-files.ts`,n(y,f.envs)),e(`${p}/${u}.tsx`,s(d,c.rawMockTemplates.templates)),e(`${p}/story-dev-virtual-module.d.ts`,o(d))]};
+import{GeneratedApplicationFile as e,isTextFile as t}from"../../core/index.js";import{generateDomainRuntimeFiles as i,modulePhxBindingStrategy as r}from"./domain-runtime-files.js";import{generateApplicationSpecStoryDevDeclaration as o,generateApplicationSpecStoryPhxModule as a,generateApplicationSpecStoryRawProjectFiles as n,generateApplicationSpecStoryWrapper as s,generateLinguiRcFile as l}from"./templates/index.js";let p=".phoenix";export const getStoryTextFiles=e=>{let i=e.files.find(e=>"binary"===e.kind);if(i)throw Error(`Cannot build application-spec story: "${i.name}" is binary. Stories inline text project files only; remove the binary asset or demonstrate this project in a demo instead.`);return e.files.filter(t)};export const generateApplicationSpecStoryFiles=t=>{let{application:c,phxDefinitions:m,rawProjectFiles:f,storyFolderName:d,storyName:u}=t,y=getStoryTextFiles(f);return[...i({applicationSpec:c.applicationSpec,categorizedFiles:c.categorizedFiles,phxDefinitions:m,includeDefaultEnvs:!1},r).map(t=>e(`${p}/${t.path}`,t.content,{binary:t.binary,format:t.format})),e(".linguirc",l([...c.applicationSpec.configurator.ui.availableLocales]),{format:!1}),e(`${p}/phx.ts`,a(c.applicationSpec)),e(`${p}/raw-project-files.ts`,n(y,f.envs)),e(`${p}/${u}.tsx`,s(d,c.rawMockTemplates.templates)),e(`${p}/story-dev-virtual-module.d.ts`,o(d))]};

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

@@ -1,4 +1,6 @@
 import{autoHeader as n}from"../common/file-headers.js";export const generateApplicationSpecAdminConfig=()=>`${n("admin-config.ts","Admin configurator config — builds admin interface and wires admin components/elements.")}
+import { defaultAdminElements } from '@salsita-ai/sdk/admin'
+
 import { configuratorConfig } from './configurator-config.js'
 import { adminInterface } from './admin-globals.js'
 import { customAdminComponentOptics } from './admin-domain-code.js'
@@ -9,5 +11,6 @@ export const adminConfig = configuratorConfig
   .withInterface(adminInterface)
   .withAdminComponentOptics(customAdminComponentOptics)
   .withAdminComponentOptics(customFrontendAdminComponentOptics)
+  .withDefaultElements(defaultAdminElements)
   .withElements([...customElements, ...customAdminElements])
 `;

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

@@ -1,8 +1,7 @@
-import { type ApplicationTypeImportRegistrar } from '../common/index.js';
 interface GenerateAdminCodeOptions {
     readonly adminExpressionFiles: readonly string[];
     readonly adminInvariantFiles: readonly string[];
     readonly adminComponentFiles: readonly string[];
 }
-export declare const generateApplicationSpecAdminCode: (options: GenerateAdminCodeOptions, registerApplicationTypeImports?: ApplicationTypeImportRegistrar) => string;
+export declare const generateApplicationSpecAdminCode: (options: GenerateAdminCodeOptions) => string;
 export {};

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

@@ -1,17 +1,9 @@
-import{autoHeader as n}from"../common/file-headers.js";import{CodeImports as t,skipApplicationTypeImports as e}from"../common/index.js";let s=(n,t)=>n.map((n,e)=>{let s=`../${n.replace(/\.tsx?$/,".js")}`;return`import ${t}${e} from '${s}'`}),i=(n,t="\n")=>n.length>0?"\n"+n.join(t)+"\n":"";export const generateApplicationSpecAdminCode=(o,a=e)=>{let{adminExpressionFiles:r,adminInvariantFiles:m,adminComponentFiles:d}=o,p=new t;for(let n of["AliasedExpressions","AliasedInvariants","DomainComponentOptic","SystemComponentTypeConstraint"])p.addTypeImport("@salsita-ai/sdk/domain",n);a(p,["Admin","FrontendData","PublishedData","SessionData"]);let c=[...s(r,"adminExpressions"),...s(m,"adminInvariants"),...s(d,"adminComponents")],A=r.map((n,t)=>`for (const [type, exprs] of Object.entries(adminExpressions${t})) {
-  mergedExpressions[type] = { ...mergedExpressions[type], ...exprs }
-}`),y=m.map((n,t)=>`for (const [type, invs] of Object.entries(adminInvariants${t})) {
-  mergedInvariants[type] = [...(mergedInvariants[type] ?? []), ...invs]
-}`),l=d.map((n,t)=>`adminComponents${t}`);return`${n("admin-domain-code.ts","Barrel file for user-authored admin domain code — expressions, invariants and components.")}
-${p.toString()}
-${i(c)}
-const mergedExpressions: Record<string, Record<string, unknown>> = {}
-${i(A,"\n\n")}
-export const customAdminExpressions = mergedExpressions as AliasedExpressions<Admin.AnyDomainEntity, Admin.RootEntity, PublishedData, SessionData, FrontendData, Admin.Aliases>
+import{autoHeader as n}from"../common/file-headers.js";import{CodeImports as o,generateProjectModuleImports as e,generateProjectModuleList as t}from"../common/index.js";export const generateApplicationSpecAdminCode=i=>{let{adminExpressionFiles:s,adminInvariantFiles:r,adminComponentFiles:a}=i,d=new o;d.addTypeImport("@salsita-ai/sdk/domain","ProjectModule");let m=[...e(s,"adminExpressions"),...e(r,"adminInvariants"),...e(a,"adminComponents")];return`${n("admin-domain-code.ts","Barrel file for user-authored admin domain code — expressions, invariants and components.")}
+${d.toString()}
+${m.length>0?"\n"+m.join("\n")+"\n":""}
+export const customAdminExpressions: readonly ProjectModule[] = ${t(s,"adminExpressions")}
 
-const mergedInvariants: Record<string, ReadonlyArray<unknown>> = {}
-${i(y,"\n\n")}
-export const customAdminInvariants = mergedInvariants as AliasedInvariants<Admin.AnyDomainEntity, Admin.RootEntity, PublishedData, SessionData, FrontendData, Admin.Aliases, string>
+export const customAdminInvariants: readonly ProjectModule[] = ${t(r,"adminInvariants")}
 
-export const customAdminComponentOptics: ReadonlyArray<DomainComponentOptic<Admin.AnyDomainEntity, Admin.RootEntity, PublishedData, SessionData, FrontendData, Admin.AnyDomainEntity, SystemComponentTypeConstraint>> = [${l.join(", ")}].flat()
+export const customAdminComponentOptics: readonly ProjectModule[] = ${t(a,"adminComponents")}
 `};

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

@@ -1,7 +1,6 @@
-import { type ApplicationTypeImportRegistrar } from '../common/index.js';
 interface GenerateAdminFrontendCodeOptions {
     readonly adminElementFiles: readonly string[];
     readonly adminComponentFiles: readonly string[];
 }
-export declare const generateApplicationSpecAdminFrontendCode: (options: GenerateAdminFrontendCodeOptions, registerApplicationTypeImports?: ApplicationTypeImportRegistrar) => string;
+export declare const generateApplicationSpecAdminFrontendCode: (options: GenerateAdminFrontendCodeOptions) => string;
 export {};

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

@@ -1,9 +1,9 @@
-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}'`});export const generateApplicationSpecAdminFrontendCode=(m,i=e)=>{let{adminElementFiles:a,adminComponentFiles:r}=m,d=new t;for(let n of["DomainComponentOptic","ElementRegistration","SystemComponentTypeConstraint"])d.addTypeImport("@salsita-ai/sdk/domain",n);i(d,["Admin","FrontendData","PublishedData","SessionData"]);let s=[...o(a,"adminElements"),...o(r,"frontendAdminComponents")],p=a.map((n,t)=>`adminElements${t}`),l=r.map((n,t)=>`frontendAdminComponents${t}`);return`${n("admin-frontend-code.ts","Barrel file for user-authored admin frontend code — elements and frontend-only components. Needs phx.frontend.admin.")}
-${d.toString()}
+import{autoHeader as n}from"../common/file-headers.js";import{CodeImports as e,generateProjectModuleImports as o,generateProjectModuleList as t}from"../common/index.js";export const generateApplicationSpecAdminFrontendCode=d=>{let{adminElementFiles:m,adminComponentFiles:r}=d,i=new e;i.addTypeImport("@salsita-ai/sdk/domain","ProjectModule");let s=[...o(m,"adminElements"),...o(r,"frontendAdminComponents")];return`${n("admin-frontend-code.ts","Barrel file for user-authored admin frontend code — elements and frontend-only components. Needs phx.frontend.admin.")}
+${i.toString()}
 
 import './admin-globals.js'
 ${s.length>0?"\n"+s.join("\n")+"\n":""}
-export const customAdminElements: readonly ElementRegistration[] = [${p.join(", ")}].flat()
+export const customAdminElements: readonly ProjectModule[] = ${t(m,"adminElements")}
 
-export const customFrontendAdminComponentOptics: ReadonlyArray<DomainComponentOptic<Admin.AnyDomainEntity, Admin.RootEntity, PublishedData, SessionData, FrontendData, Admin.AnyDomainEntity, SystemComponentTypeConstraint>> = [${l.join(", ")}].flat()
+export const customFrontendAdminComponentOptics: readonly ProjectModule[] = ${t(r,"frontendAdminComponents")}
 `};

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

@@ -1,9 +1,9 @@
-import{CodeImports as e}from"../common/code-imports.js";import{autoHeader as o}from"../common/file-headers.js";import{generateStateTypeDecls as t}from"./domain-spec/index.js";import{generateActionTypeDecls as n,generateDataSchemaTypeDecls as i,generateEntityExpressionComposites as a,generateExpressionTypeDecls as s,generateModelTypeDecls as r}from"./global-definition/index.js";export const generateApplicationSpecTypeDeclarations=(o,p,l)=>{let d=new e,m=l+2,c=" ".repeat(l),f=r(o.configurator.latestModel,p,d,l),$=[];for(let e of o.configurator.resolvedVersions.versionedModels){let o=`ModelV${e.version}`,t=r(e.modelVersion,p,d,m);$.push(`${c}namespace ${o} {
-${t}${c}}`)}let g=r(o.admin.latestModel,p,d,m),u=`${c}namespace Admin {
-${g}${c}}`,y=[];for(let e of o.admin.resolvedVersions.versionedModels){let o=`AdminV${e.version}`,t=r(e.modelVersion,p,d,m);y.push(`${c}namespace ${o} {
-${t}${c}}`)}let x=s(o.configurator.expressions,p,d,l),M=a(o.configurator.latestModel,o.configurator.expressions,d,l,""),v=[s(o.admin.expressions,p,d,m),a(o.admin.latestModel,o.admin.expressions,d,m,"Admin")].filter(Boolean).join("\n\n"),A=v?`${c}namespace Admin {
-${v}
-${c}}`:"",S=n(o.configurator.actions,o.configurator.latestModel,p,d,l),j=i(o,p,d,l),V=t({configuratorStates:o.configurator.states,adminStates:o.admin.states},l);return d.addTypeImport("@salsita-ai/sdk/domain","DomainEntityId"),{imports:d,declarations:[f,x,M,S,j,V,...$,u,A,...y].filter(Boolean).join("\n\n")}};export const generateApplicationSpecTypesModule=(e,t)=>{let{declarations:n,imports:i}=generateApplicationSpecTypeDeclarations(e,t,0);return`${o("application-types.ts","Story-local application, model and state types derived from the spec.")}
+import{CodeImports as e}from"../common/code-imports.js";import{autoHeader as o}from"../common/file-headers.js";import{generateStateTypeDecls as t}from"./domain-spec/index.js";import{generateActionTypeDecls as n,generateAssistantFormElementTypeDecls as i,generateDataSchemaTypeDecls as a,generateEntityExpressionComposites as s,generateExpressionTypeDecls as r,generateModelTypeDecls as l}from"./global-definition/index.js";export const generateApplicationSpecTypeDeclarations=(o,p,d)=>{let m=new e,c=d+2,f=" ".repeat(d),$=l(o.configurator.latestModel,p,m,d),g=[];for(let e of o.configurator.resolvedVersions.versionedModels){let o=`ModelV${e.version}`,t=l(e.modelVersion,p,m,c);g.push(`${f}namespace ${o} {
+${t}${f}}`)}let u=l(o.admin.latestModel,p,m,c),y=`${f}namespace Admin {
+${u}${f}}`,x=[];for(let e of o.admin.resolvedVersions.versionedModels){let o=`AdminV${e.version}`,t=l(e.modelVersion,p,m,c);x.push(`${f}namespace ${o} {
+${t}${f}}`)}let M=r(o.configurator.expressions,p,m,d),v=s(o.configurator.latestModel,o.configurator.expressions,m,d,""),A=[r(o.admin.expressions,p,m,c),s(o.admin.latestModel,o.admin.expressions,m,c,"Admin")].filter(Boolean).join("\n\n"),S=A?`${f}namespace Admin {
+${A}
+${f}}`:"",j=n(o.configurator.actions,o.configurator.latestModel,p,m,d),V=i(o.configurator.assistant?.resolved.formElements??[],p,m,d),h=a(o,p,m,d),T=t({configuratorStates:o.configurator.states,adminStates:o.admin.states},d);return m.addTypeImport("@salsita-ai/sdk/domain","DomainEntityId"),{imports:m,declarations:[$,M,v,j,V,h,T,...g,y,S,...x].filter(Boolean).join("\n\n")}};export const generateApplicationSpecTypesModule=(e,t)=>{let{declarations:n,imports:i}=generateApplicationSpecTypeDeclarations(e,t,0);return`${o("application-types.ts","Story-local application, model and state types derived from the spec.")}
 ${i.toTypeOnlyString(".phoenix/application-types.ts")}
 
 ${n.replace(/^(\s*)(type|interface|namespace) /gm,"$1export $2 ")}

package/dist/application-spec/generate-application/code/templates/common/doc-comment.d.ts

@@ -0,0 +1,2 @@
+/** The doc comment lines of a declared description at `pad`; none when there is no description. */
+export declare const docComment: (description: string | undefined, pad: string) => readonly string[];

package/dist/application-spec/generate-application/code/templates/common/doc-comment.js

@@ -0,0 +1 @@
+export const docComment=(t,e)=>{let m=(t??"").trim().replaceAll("*/","*\\/").split("\n").map(t=>t.trim());return""===m[0]||void 0===m[0]?[]:1===m.length?[`${e}/** ${m[0]} */`]:[`${e}/**`,...m.map(t=>`${e} * ${t}`.trimEnd()),`${e} */`]};

package/dist/application-spec/generate-application/code/templates/common/format-property-key.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Writes a property name taken from the YAML spec (a key of a JSON schema's `properties`) as the
+ * key of a generated TypeScript type member. An ASCII identifier stays bare, so generated code for
+ * such names reads as before; any other name (`my-key`, `Children's`, `1st`, `with space`, `größe`)
+ * becomes a string literal, which TypeScript accepts for every name.
+ */
+export declare const formatPropertyKey: (key: string) => string;

package/dist/application-spec/generate-application/code/templates/common/format-property-key.js

@@ -0,0 +1 @@
+let t=/^[A-Za-z_$][\w$]*$/;export const formatPropertyKey=e=>t.test(e)?e:JSON.stringify(e);

package/dist/application-spec/generate-application/code/templates/common/schema-to-type-string.js

@@ -1,3 +1,3 @@
-import{COMMON_SHORT_PREFIX as e,INTERNAL_REF_PATTERN as r,extractPhxDefName as n}from"../../../../core/index.js";let t=(e,r,n)=>{let t=e.importModuleOverrides?.[n]??r;e.typeOnlyImports?e.imports?.addTypeImport(t,n):e.imports?.addImport(t,n)},i={string:"string",number:"number",integer:"number",boolean:"boolean",null:"null",object:"Record<string, unknown>",array:"readonly unknown[]"},o=e=>null===e?"null":"string"==typeof e?`'${e}'`:"number"==typeof e||"boolean"==typeof e?String(e):"unknown",a=(e,r)=>{if("object"==typeof e.additionalProperties){let n=schemaToTypeString(e.additionalProperties,r);return`Readonly<Record<string, ${n}>>`}if(!e.properties)return"Record<string, unknown>";let n=new Set(e.required??[]),t=Object.entries(e.properties);if(0===t.length)return"Record<string, never>";let i=t.map(([e,t])=>{let i=schemaToTypeString(t,r),o=n.has(e)?"":"?";return`  readonly ${e}${o}: ${i}`});return`{
-${i.join("\n")}
-}`},p=(e,r)=>{let{items:n}=e;if(Array.isArray(n)){let e=n.map(e=>schemaToTypeString(e,r)).join(", ");return`readonly [${e}]`}let t=schemaToTypeString(n,r);return t.includes(" | ")||t.includes(" & ")?`readonly (${t})[]`:`readonly ${t}[]`};export const schemaToTypeString=(l,m)=>{if(l.tsType){if(m.imports&&l.import)for(let e of l.import)t(m,e.module,e.member);return l.tsType}if(l.$ref){let e=n(l.$ref);if(void 0!==e){var s;let r,n,i=m.phxDefinitions[e];if(m.imports&&i?.import)for(let e of i.import)t(m,e.module,e.member);return s=l.references,r=m.phxDefinitions[e],"DomainEntityId"===(n=r?.tsType)?s?`${s}['id']`:"DomainEntityId<string>":"DomainEntity"===n?s??"DomainEntity<string>":"$DomainEntity"===n?s?`$${s}`:"$DomainEntity<string>":n||"unknown"}}if(l.$ref){if(l.$ref.startsWith(e))return l.$ref.slice(e.length);let n=r.exec(l.$ref);return n?n[2]??"unknown":"unknown"}if(l.enum)return l.enum.map(o).join(" | ");if(l.anyOf)return l.anyOf.map(e=>schemaToTypeString(e,m)).join(" | ");if(l.oneOf)return l.oneOf.map(e=>schemaToTypeString(e,m)).join(" | ");if(l.allOf)return l.allOf.map(e=>{let r=schemaToTypeString(e,m);return r.includes("|")?`(${r})`:r}).join(" & ");if("array"===l.type&&l.items)return p(l,m);if("object"===l.type)return a(l,m);if("string"==typeof l.type)return i[l.type]??"unknown";if(Array.isArray(l.type)){let e;return e=l.type,e.map(e=>"array"===e&&l.items?p(l,m):"object"===e?a(l,m):i[e]??"unknown").join(" | ")}return"unknown"};
+import{COMMON_SHORT_PREFIX as e,INTERNAL_REF_PATTERN as r,extractPhxDefName as n}from"../../../../core/index.js";import{formatPropertyKey as t}from"./format-property-key.js";let i=(e,r,n)=>{let t=e.importModuleOverrides?.[n]??r;e.typeOnlyImports?e.imports?.addTypeImport(t,n):e.imports?.addImport(t,n)},o={string:"string",number:"number",integer:"number",boolean:"boolean",null:"null",object:"Record<string, unknown>",array:"readonly unknown[]"},l=e=>null===e?"null":"string"==typeof e?`'${e.replaceAll("\\","\\\\").replaceAll("'","\\'").replaceAll("\n","\\n").replaceAll("\r","\\r")}'`:"number"==typeof e||"boolean"==typeof e?String(e):"unknown",p=(e,r)=>{if("object"==typeof e.additionalProperties){let n=schemaToTypeString(e.additionalProperties,r);return`Readonly<Record<string, ${n}>>`}if(!e.properties)return"Record<string, unknown>";let n=new Set(e.required??[]),i=Object.entries(e.properties);if(0===i.length)return"Record<string, never>";let o=i.map(([e,i])=>{let o=schemaToTypeString(i,r),l=n.has(e)?"":"?";return`  readonly ${t(e)}${l}: ${o}`});return`{
+${o.join("\n")}
+}`},a=(e,r)=>{let{items:n}=e;if(Array.isArray(n)){let e=n.map(e=>schemaToTypeString(e,r)).join(", ");return`readonly [${e}]`}let t=schemaToTypeString(n,r);return t.includes(" | ")||t.includes(" & ")?`readonly (${t})[]`:`readonly ${t}[]`};export const schemaToTypeString=(t,m)=>{if(t.tsType){if(m.imports&&t.import)for(let e of t.import)i(m,e.module,e.member);return t.tsType}if(t.$ref){let e=n(t.$ref);if(void 0!==e){var s;let r,n,o=m.phxDefinitions[e];if(m.imports&&o?.import)for(let e of o.import)i(m,e.module,e.member);return s=t.references,r=m.phxDefinitions[e],"DomainEntityId"===(n=r?.tsType)?s?`${s}['id']`:"DomainEntityId<string>":"DomainEntity"===n?s??"DomainEntity<string>":"$DomainEntity"===n?s?`$${s}`:"$DomainEntity<string>":n||"unknown"}}if(t.$ref){if(t.$ref.startsWith(e))return t.$ref.slice(e.length);let n=r.exec(t.$ref);return n?n[2]??"unknown":"unknown"}if(t.enum)return t.enum.map(l).join(" | ");if(t.anyOf)return t.anyOf.map(e=>schemaToTypeString(e,m)).join(" | ");if(t.oneOf)return t.oneOf.map(e=>schemaToTypeString(e,m)).join(" | ");if(t.allOf)return t.allOf.map(e=>{let r=schemaToTypeString(e,m);return r.includes("|")?`(${r})`:r}).join(" & ");if("array"===t.type&&t.items)return a(t,m);if("object"===t.type)return p(t,m);if("string"==typeof t.type)return o[t.type]??"unknown";if(Array.isArray(t.type)){let e;return e=t.type,e.map(e=>"array"===e&&t.items?a(t,m):"object"===e?p(t,m):o[e]??"unknown").join(" | ")}return"unknown"};

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

@@ -1,4 +1,4 @@
-import{autoHeader as e}from"../common/file-headers.js";export const generateApplicationSpecConfiguratorConfig=(o,n)=>{let t=o.configurator.transformers,r=n?.includeDefaultEnvs===!1?"":`
+import{autoHeader as e}from"../common/file-headers.js";export const generateApplicationSpecConfiguratorConfig=(t,o)=>{let n=t.configurator.transformers,r=o?.includeDefaultEnvs===!1?"":`
   .withDefaultEnvs({
     isDev: phx.frontendEnv.IS_DEV,
     deploymentId: phx.frontendEnv.DEPLOYMENT_ID,
@@ -13,6 +13,7 @@ import{autoHeader as e}from"../common/file-headers.js";export const generateAppl
     gtmDebug: phx.frontendEnv.GTM_DEBUG,
   })`;return`${e("configurator-config.ts","Configurator config — builds the interface and wires handlers, elements, transformers, components and theme.")}
 import { getPhoenixThemes } from '@salsita-ai/sdk/ui'
+import { defaultConfiguratorElements } from '@salsita-ai/sdk/configurator'
 
 // Import order matters — each step sets globals needed by the next:
 // 1. domain.js → domain-spec.ts runs → sets phx.domain
@@ -28,9 +29,10 @@ export const configuratorConfig = configuratorBuilder
   .withComponentOptics(customComponentOptics)
   .withComponentOptics(customFrontendComponentOptics)
   .withHandlers(customHandlers)
+  .withDefaultElements(defaultConfiguratorElements)
   .withElements(customElements)
-  .withTransformers(customTransformers, ${JSON.stringify(t)})${r}
-  ${(e=>{let{theme:o}=e.configurator;return Object.keys(o.options).length>0?`.withTheme({ ...getPhoenixThemes().${o.preset}, ...${JSON.stringify(o.options)} })`:`.withTheme(getPhoenixThemes().${o.preset})`})(o)}${(e=>{let{ui:o}=e.configurator,n=[];return(void 0!==o.preview&&n.push(`preview: '${o.preview}'`),void 0!==o.alwaysExpand&&n.push(`alwaysExpand: ${o.alwaysExpand}`),void 0!==o.appLoader&&n.push(`appLoader: '${o.appLoader}'`),0===n.length)?"":`
-  .withUi({ ${n.join(", ")} })`})(o)}${!o.appMetadata.enableAdminRelease?"":`
+  .withTransformers(customTransformers, ${JSON.stringify(n)})${r}
+  ${(e=>{let{theme:t}=e.configurator;return Object.keys(t.options).length>0?`.withTheme({ ...getPhoenixThemes().${t.preset}, ...${JSON.stringify(t.options)} })`:`.withTheme(getPhoenixThemes().${t.preset})`})(t)}${(e=>{let{ui:t}=e.configurator,o=[];return(void 0!==t.preview&&o.push(`preview: '${t.preview}'`),void 0!==t.alwaysExpand&&o.push(`alwaysExpand: ${t.alwaysExpand}`),void 0!==t.appLoader&&o.push(`appLoader: '${t.appLoader}'`),0===o.length)?"":`
+  .withUi({ ${o.join(", ")} })`})(t)}${!t.appMetadata.enableAdminRelease?"":`
   .withAdminRelease(true)`}
 `};

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

@@ -1,9 +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,20 +1,11 @@
-import{autoHeader as t}from"../common/file-headers.js";import{CodeImports as n,skipApplicationTypeImports as e}from"../common/index.js";let o=(t,n)=>t.map((t,e)=>{let o=`../${t.replace(/\.tsx?$/,".js")}`;return`import ${n}${e} from '${o}'`}),a=(t,n="\n")=>t.length>0?"\n"+t.join(n)+"\n":"";export const generateApplicationSpecConfiguratorCode=(i,s=e)=>{let{expressionFiles:r,actionFiles:p,invariantFiles:m,componentFiles:d}=i,c=new n;for(let t of["ActionImplementations","AliasedExpressions","AliasedInvariants","DomainComponentOptic","SystemComponentTypeConstraint"])c.addTypeImport("@salsita-ai/sdk/domain",t);s(c,["$Map","ActionTypes","Aliases","AnyDomainEntity","ExportState","FrontendData","NavigationState","PublishedData","RootEntity","SessionData","ToolState","ViewState"]);let l=[...o(r,"expressions"),...o(p,"actions"),...o(m,"invariants"),...o(d,"components")],y=p.map((t,n)=>`...actions${n}`),D=r.map((t,n)=>`for (const [type, exprs] of Object.entries(expressions${n})) {
-  mergedExpressions[type] = { ...mergedExpressions[type], ...exprs }
-}`),x=m.map((t,n)=>`for (const [type, invs] of Object.entries(invariants${n})) {
-  mergedInvariants[type] = [...(mergedInvariants[type] ?? []), ...invs]
-}`),A=d.map((t,n)=>`components${n}`);return`${t("configurator-domain-code.ts","Barrel file for user-authored domain code — expressions, actions, invariants and components. Needs only phx.domain.")}
-${c.toString()}
-${a(l)}
-const mergedExpressions: Record<string, Record<string, unknown>> = {}
-${a(D,"\n\n")}
-export const customExpressions = mergedExpressions as AliasedExpressions<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases>
+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()}
+${p.length>0?"\n"+p.join("\n")+"\n":""}
+export const customExpressions: readonly ProjectModule[] = ${t(r,"expressions")}
 
-// A declared action without an implementation fails here; an implementation of an undeclared action fails in its own file.
-export const customActions: ActionImplementations<AnyDomainEntity, RootEntity, $Map, PublishedData, SessionData, FrontendData, NavigationState, ViewState, ToolState, ExportState, ActionTypes> = { ${y.join(", ")} }
+export const customActions: readonly ProjectModule[] = ${t(i,"actions")}
 
-const mergedInvariants: Record<string, ReadonlyArray<unknown>> = {}
-${a(x,"\n\n")}
-export const customInvariants = mergedInvariants as AliasedInvariants<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, Aliases, string>
+export const customInvariants: readonly ProjectModule[] = ${t(a,"invariants")}
 
-export const customComponentOptics: ReadonlyArray<DomainComponentOptic<AnyDomainEntity, RootEntity, PublishedData, SessionData, FrontendData, AnyDomainEntity, SystemComponentTypeConstraint>> = [${A.join(", ")}].flat()
+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/configurator-globals.d.ts

@@ -1,3 +1,4 @@
+import { type ApplicationTypeImportRegistrar } from '../common/index.js';
 export type ConfiguratorBindingBlockGenerator = () => string;
 export declare const generateConfiguratorGlobalBindingBlock: ConfiguratorBindingBlockGenerator;
-export declare const generateApplicationSpecConfiguratorGlobals: (generateBindingBlock?: ConfiguratorBindingBlockGenerator, description?: string) => string;
+export declare const generateApplicationSpecConfiguratorGlobals: (generateBindingBlock: ConfiguratorBindingBlockGenerator, description: string, registerApplicationTypeImports: ApplicationTypeImportRegistrar) => string;

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

@@ -1,10 +1,23 @@
-import{autoHeader as o}from"../common/file-headers.js";export const generateConfiguratorGlobalBindingBlock=()=>`
+import{CodeImports as e,autoHeader as t}from"../common/index.js";export const generateConfiguratorGlobalBindingBlock=()=>`
 // @ts-ignore - Initialize the globals
 globalThis.phx.frontend = configuratorInterface
-`;export const generateApplicationSpecConfiguratorGlobals=(r=generateConfiguratorGlobalBindingBlock,e="Creates the configurator interface and sets phx.frontend — must run before any user code imports.")=>`${o("configurator-globals.ts",e)}
-import { createConfiguratorInterface } from '@salsita-ai/sdk/configurator'
-
+`;export const generateApplicationSpecConfiguratorGlobals=(r,o,n)=>{let a=new e;n(a,["AssistantFormElementTypes"]);let s=a.toString();return`${t("configurator-globals.ts",o)}
+import {
+  type CreateAssistantFormElement,
+  createAssistantFormElementFactory,
+  createConfiguratorInterface,
+} from '@salsita-ai/sdk/configurator'
+${s?`${s}
+`:""}
 import { baseConfiguratorBuilder } from './domain-spec.js'
 
-export const configuratorInterface = createConfiguratorInterface(baseConfiguratorBuilder)
-${r()}`;
+const baseConfiguratorInterface = createConfiguratorInterface(baseConfiguratorBuilder)
+
+// The project's own assistant form elements type createAssistantFormElement by name, from the YAML.
+export const configuratorInterface: typeof baseConfiguratorInterface & {
+  readonly createAssistantFormElement: CreateAssistantFormElement<AssistantFormElementTypes>
+} = {
+  ...baseConfiguratorInterface,
+  createAssistantFormElement: createAssistantFormElementFactory<AssistantFormElementTypes>(),
+}
+${r()}`};

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

@@ -0,0 +1,35 @@
+import type { Expressions, ModelVersion } from '../../../../../parse-application-files/index.js';
+/**
+ * The types one generated domain closes its factories and reflections with.
+ *
+ * `domain-spec.ts` writes them where it builds the domain's values, and the `phx` declarations
+ * (`globals.d.ts`, a story's `phx.ts`) write them where they declare those values' types, so both
+ * name the same types.
+ */
+export interface DomainFactoryTypes {
+    /** Entities, root entities, `$Map`, the three data types and the aliases, in the factories' order. */
+    readonly typeArguments: string;
+    /** What the domain runtime adds to the expression context. */
+    readonly contextExtension: string;
+    /** The systems the domain runtime hands to an action. */
+    readonly systems: string;
+    /** The type of the domain's `model`: one reflection per entity, alias, common type and shape. */
+    readonly modelType: string;
+    /** The type of the domain's `enhancedModel`: one enhanced reflection per entity and alias. */
+    readonly enhancedModelType: string;
+    /** The enhanced reflection type of one entity or alias, with the names of its constant expressions. */
+    readonly enhancedReflectionType: (reflectionClass: EnhancedReflectionClass, name: string) => string;
+}
+/** Enhanced reflection classes that receive module-level constants through their constructor. */
+export type EnhancedReflectionClass = '$DomainEntityReflection' | 'EnhancedAliasReflection';
+interface DomainFactoryTypesSpec {
+    readonly latestModel: ModelVersion;
+    readonly expressions: Expressions;
+}
+/**
+ * Builds the type strings of a domain.
+ *
+ * @param typePrefix The namespace the domain's types live in (`Admin` for the admin domain), or `''`.
+ */
+export declare const getDomainFactoryTypes: (domainSpec: DomainFactoryTypesSpec, typePrefix: string) => DomainFactoryTypes;
+export {};

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

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

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

@@ -0,0 +1 @@
+export { getDomainFactoryTypes, type DomainFactoryTypes, type EnhancedReflectionClass } from './domain-factory-types.js';

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

@@ -0,0 +1 @@
+export{getDomainFactoryTypes}from"./domain-factory-types.js";

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-component-optics.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentEntry } from '../../../../parse-application-files/spec/index.js';
-import type { CodeImports } from '../../common/index.js';
+import { type CodeImports } from '../../common/index.js';
 /**
  * Generates the `componentOptics` array code from unified ComponentEntry[].
  * Walks all entries and dispatches on implementation.kind.

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

@@ -1,10 +1,10 @@
-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{toSingleQuotedString as i}from"../../common/index.js";import{generateMemoEvalPlanCode as a}from"./generate-memo-eval-plan-code.js";let r="@salsita-ai/sdk/domain",n={createAdminCustomPageRead:r,createAdminCustomSidebarRead:r,createAdminDataPageRead:r,createAdminDataTableSidebarRead:r,createAdminNavigationPanelRead:r,createAdminPresetCategoryPageRead:r,createAdminPresetCategorySelectionRead:r,createAdminPresetCategorySelectionWrite:r,createAdminPresetCategorySidebarRead:r,createAdminPresetListPageRead:r,createAdminPresetSidebarRead:r,createAdminRecipeCollectionPageRead:r,createAdminRecipeSidebarRead:r},d=(e,a)=>{a.addImport(n[e.sdkFunction]??r,e.sdkFunction);let d=e.params.map(e=>t(e)?e.$codeRef:"string"==typeof e?i(e):JSON.stringify(e));return`${e.sdkFunction}(${d.join(", ")})`},o=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(""),s=(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=>`(${s(e,i)})`).join(" || ")).with({kind:"none"},()=>"true").exhaustive(),m=(t,i)=>{if(0===t.length)return"() => ({})";let a=t.map(t=>e(t.assertion).with({kind:"primitive"},({assertFn:e})=>(i.addImport(r,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=s(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match its declared schema')`}).with({kind:"anyOf"},e=>{let i=s(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===a.length?`(state) => ({ ${n} })`:`(state) => { ${a.join("; ")}; return { ${n} } }`},l="      ";export const generateComponentOpticsCode=(t,i)=>{let n=[];for(let s of t){let t=s.isAlias?"withAlias":"withEntity",p=`${s.componentName}Component`;i.addImport(r,p);let $=`    attachComponent.withComponent(${p}, '${s.instanceName}', true).${t}('${s.typeOrAlias}')`;e(s.implementation).with({kind:"userBound"},({implementation:e,filters:t,plan:r})=>{let d=o(t.items),s=`${$}${d}`,p=m("composite"===e.kind?e.writeBindings:[],i),c=a(r,i).replaceAll("\n",`
+${l}`);n.push(`${s}.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(
-      ${s},
+${l}${p}
+    )`)}).with({kind:"sdk"},({readFactory:e,writeFactory:t})=>{let a=o(s.implementation.filters.items),r=`${$}${a}`,m=d(e,i),l=d(t,i);n.push(`${r}.attach(
+      ${m},
       ${l}
-    )`)}).exhaustive()}return 0===o.length?"[] as const":`[
-${o.join(",\n")}
+    )`)}).exhaustive()}return 0===n.length?"[] as const":`[
+${n.join(",\n")}
   ] as const`};