@salsita-ai/sdk 0.50.0-develop.6d8967bc99 → 0.50.0-develop.6fc83d7732

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,generatePhoenixVariantsSkill as P,stripSdkMarkerContent as w}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let A=[{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
 ---
-`}],S=[".claude/commands/review.md",".cursor/commands/review.md"],C=(e,t)=>e.projectFiles.find(e=>e.file.name===t)?.file.content;export const generateProjectScaffolding=D=>{let L,{applicationSpec:R,categorizedFiles:$,sdkVersion:y,cliUseWorkspace:K,name:G,description:I}=D,N=C($,"package.json"),T=C($,".gitignore"),U=void 0!==K?K:R.appMetadata.workspace,q=(t=>{let n=[],r=[...S];for(let{path:o,generatedPrefix:i}of A){let a=C(t,o);if(void 0===a)continue;let s=w(a,i);void 0===s?r.push(o):s!==a&&n.push(e(o,s,{format:!1}))}return{strippedFiles:n,removedFiles:r}})($);return{generatedProjectFiles:[e("package.json",l({sdkVersion:y,useWorkspace:U,useClerk:R.appMetadata.useClerk??!1,name:G,description:I,existingContent:N})),e(".nvmrc",c(),{format:!1}),e(".linguirc",v(R.configurator.ui.availableLocales),{format:!1}),e("tsconfig.json",x()),e("eslint.config.js",i()),e(".gitignore",s(T)),...(L=[{name:"phoenix",content:M({checkLatestCanary:t({useWorkspace:U,sdkVersion:y})}),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:[]},{name:"phoenix-variants",content:P(),references:[]}],agentSkillRoots.flatMap(t=>L.flatMap(n=>[e(`${t}/${n.name}/SKILL.md`,n.content),...n.references.map(r=>e(`${t}/${n.name}/${r.path}`,r.content))]))),...q.strippedFiles],initialProjectFiles:[e("README.md",g(G)),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:q.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/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-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-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`};

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

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

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

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