@salsita-ai/sdk 0.50.0-develop.f42416a4e6 → 0.50.0-develop.f5b66685b9

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

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

package/dist/application-spec/generate-application/code/templates/global-definition/generate-assistant-form-element-types.d.ts

@@ -0,0 +1,12 @@
+import type { AssistantFormElementDescriptor } from '#package/domain';
+import type { PhoenixDefinitions } from '../../../../core/phoenix-definitions.js';
+import type { CodeImports } from '../../common/code-imports.js';
+/**
+ * Generates the `AssistantFormElementTypes` map of the project's own assistant form elements (name →
+ * `{ role, attributes }`), and the `AssistantFormElementName` and `AssistantFormElementProps<NAME>`
+ * types derived from it, which `phx.frontend.createAssistantFormElement` is typed by. An attribute
+ * outside `required` is optional and an enum is a union of its values. The `description` of an element becomes the doc
+ * comment of its property. Without elements the map is empty, so `AssistantFormElementName` is
+ * `never`.
+ */
+export declare const generateAssistantFormElementTypeDecls: (formElements: readonly AssistantFormElementDescriptor[], phxDefinitions: PhoenixDefinitions, imports: CodeImports, indent: number) => string;

package/dist/application-spec/generate-application/code/templates/global-definition/generate-assistant-form-element-types.js

@@ -0,0 +1,7 @@
+import{docComment as e}from"../common/doc-comment.js";import{formatPropertyKey as t}from"../common/format-property-key.js";import{schemaToTypeString as n}from"../common/schema-to-type-string.js";export const generateAssistantFormElementTypeDecls=(o,r,s,m)=>{let a=" ".repeat(m),p=" ".repeat(m+2),l=" ".repeat(m+4),i=" ".repeat(m+6),$={phxDefinitions:r,commonTypeNames:new Set,imports:s},y=o.map(({name:o,role:r,description:s,attributes:m,required:a=[]})=>{let y=Object.entries(m).map(([e,o])=>`${i}readonly ${t(e)}${a.includes(e)?"":"?"}: ${n({...o},$)}`);return[...e(s,p),`${p}readonly ${t(o)}: {`,`${l}readonly role: '${r}'`,`${l}readonly attributes: ${y.length>0?`{
+${y.join("\n")}
+${l}}`:"Record<never, never>"}`,`${p}}`].join("\n")});s.addTypeImport("@salsita-ai/sdk/configurator","AssistantFormElementRoleProps");let c=y.length>0?`{
+${y.join("\n")}
+${a}}`:"Record<never, never>";return`${a}type AssistantFormElementTypes = ${c}
+${a}type AssistantFormElementName = keyof AssistantFormElementTypes
+${a}type AssistantFormElementProps<NAME extends AssistantFormElementName, STATE = unknown> = AssistantFormElementRoleProps<AssistantFormElementTypes[NAME], STATE>`};

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

@@ -0,0 +1,43 @@
+import type { ApplicationSpec } from '../../../../parse-application-files/index.js';
+import type { CodeImports } from '../../common/index.js';
+/**
+ * The types of the `phx` members, stated from SDK types and the project's generated types alone.
+ *
+ * Each member that the generated code builds with an SDK factory is declared as that factory's
+ * result for the type arguments the generated call states (`ReturnType<typeof factory<…>>`), so the
+ * declared type is the very type of the generated value; each member that is an SDK function as is
+ * is declared as that function's type; the model reflections are declared member by member.
+ *
+ * The factory results are named by type aliases local to the declaring file, and the members refer
+ * to those names. An editor cannot name a local alias where `phx` is used, so it shows the type
+ * itself, as it did when the members referred to the generated values; a member written as
+ * `ReturnType<typeof factory<…>>` in place would be shown as written, and printing it overflows the
+ * stack of the TypeScript 6 type printer.
+ */
+export interface PhxTypes {
+    /** Declarations the member types refer to, to emit once beside them, outside `declare global`. */
+    readonly declarations: string;
+    /** `phx.domain`, its admin part included. */
+    readonly domainType: string;
+    /** `phx.frontend` without its admin part. */
+    readonly configuratorInterfaceType: string;
+    /** The generated application types the member types refer to. */
+    readonly applicationTypeNames: readonly string[];
+}
+/** The types of a generated project's global `phx`, which also has `phx.frontend.admin` and `phx.webhooks`. */
+export interface GlobalPhxTypes extends PhxTypes {
+    /** `phx.frontend.admin`. */
+    readonly adminInterfaceType: string;
+    /** `phx.webhooks`. */
+    readonly webhooksType: string;
+}
+/**
+ * Generates the types of the `phx` members a story's module binding has (`domain` and
+ * `frontend`) and registers the SDK imports they need.
+ */
+export declare const generatePhxTypes: (spec: ApplicationSpec, imports: CodeImports) => PhxTypes;
+/**
+ * Generates the types of the members of a generated project's global `phx`, `phx.frontend.admin` and
+ * `phx.webhooks` included, and registers the SDK imports they need.
+ */
+export declare const generateGlobalPhxTypes: (spec: ApplicationSpec, imports: CodeImports) => GlobalPhxTypes;

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

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

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

@@ -1,4 +1,6 @@
 export { generateActionTypeDecls } from './generate-action-types.js';
+export { generateAssistantFormElementTypeDecls } from './generate-assistant-form-element-types.js';
 export { generateModelTypeDecls } from './generate-model-types.js';
 export { generateExpressionTypeDecls, generateEntityExpressionComposites } from './generate-expression-types.js';
 export { generateDataSchemaTypeDecls } from './generate-data-schema-types.js';
+export { generateGlobalPhxTypes, generatePhxTypes, type GlobalPhxTypes, type PhxTypes } from './generate-phx-types.js';

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

@@ -1 +1 @@
-export{generateActionTypeDecls}from"./generate-action-types.js";export{generateModelTypeDecls}from"./generate-model-types.js";export{generateExpressionTypeDecls,generateEntityExpressionComposites}from"./generate-expression-types.js";export{generateDataSchemaTypeDecls}from"./generate-data-schema-types.js";
+export{generateActionTypeDecls}from"./generate-action-types.js";export{generateAssistantFormElementTypeDecls}from"./generate-assistant-form-element-types.js";export{generateModelTypeDecls}from"./generate-model-types.js";export{generateExpressionTypeDecls,generateEntityExpressionComposites}from"./generate-expression-types.js";export{generateDataSchemaTypeDecls}from"./generate-data-schema-types.js";export{generateGlobalPhxTypes,generatePhxTypes}from"./generate-phx-types.js";

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

@@ -1,17 +1,17 @@
-import{autoHeader as e}from"../common/file-headers.js";import{generateApplicationSpecTypeDeclarations as a}from"./application-types.js";export const generateApplicationSpecGlobals=(o,n)=>{let t,i,l,r,d,s,p,m,y,{declarations:c,imports:f}=a(o,n,2);f.addTypeImport("@salsita-ai/sdk/domain","EnumLike");let h=[c,(t=o.configurator.latestModel,i=o.admin.latestModel,l=t.entityTypes.map(String),r=[...t.aliases].map(([e])=>String(e)),d=[...t.commonTypes].map(([e])=>String(e)),s=i.entityTypes.map(String),p=[...i.aliases].map(([e])=>String(e)),m=[...i.commonTypes].map(([e])=>String(e)),y=(e,a)=>e.map(e=>`    ${a(e)}`).join("\n"),`  interface Model {
-${y([...l,...d,...r],e=>`readonly ${e}: ${e}`)}
+import{autoHeader as e}from"../common/file-headers.js";import{generateApplicationSpecTypeDeclarations as a}from"./application-types.js";import{generateGlobalPhxTypes as n}from"./global-definition/index.js";export const generateApplicationSpecGlobals=(t,o)=>{let i,l,d,r,s,p,c,y,m,{declarations:h,imports:f}=a(t,o,2);f.addTypeImport("@salsita-ai/sdk/domain","EnumLike");let g=n(t,f),S=[h,(i=t.configurator.latestModel,l=t.admin.latestModel,d=i.entityTypes.map(String),r=[...i.aliases].map(([e])=>String(e)),s=[...i.commonTypes].map(([e])=>String(e)),p=l.entityTypes.map(String),c=[...l.aliases].map(([e])=>String(e)),y=[...l.commonTypes].map(([e])=>String(e)),m=(e,a)=>e.map(e=>`    ${a(e)}`).join("\n"),`  interface Model {
+${m([...d,...s,...r],e=>`readonly ${e}: ${e}`)}
   }
 
   interface EnhancedModel {
-${y([...l,...r],e=>`readonly $${e}: $${e}`)}
+${m([...d,...r],e=>`readonly $${e}: $${e}`)}
   }
 
   interface AdminModel {
-${y([...s,...m,...p],e=>`readonly ${e}: Admin.${e}`)}
+${m([...p,...y,...c],e=>`readonly ${e}: Admin.${e}`)}
   }
 
   interface AdminEnhancedModel {
-${y([...s,...p],e=>`readonly $${e}: Admin.$${e}`)}
+${m([...p,...c],e=>`readonly $${e}: Admin.$${e}`)}
   }
 
   interface ApplicationTypes {
@@ -36,23 +36,33 @@ ${y([...s,...p],e=>`readonly $${e}: Admin.$${e}`)}
     readonly AdminModel: AdminModel
     readonly AdminEnhancedModel: AdminEnhancedModel
     readonly ApplicationTypes: ApplicationTypes
-  }`)].filter(Boolean).join("\n\n");return`${e("globals.d.ts","Global type declarations for the phx namespace, env configs and domain types.")}
+  }`)].filter(Boolean).join("\n\n"),D=(e,a)=>e.replaceAll("\n",`
+${a}`);return`${e("globals.d.ts","Global type declarations for the phx namespace, env configs and domain types.")}
 /* eslint-disable @typescript-eslint/triple-slash-reference, @typescript-eslint/consistent-type-imports */
-/// <reference types="vite/client" />
 /// <reference types="@salsita-ai/sdk/globals" />
+// The project's tsconfig includes \`.phoenix\`, but TypeScript checks a file under a dot folder only
+// when it is named or imported. These declarations import none of the generated modules, and the
+// project's own code need not either, so the modules are named here to keep them type-checked.
+/// <reference path="./spec-code.ts" />
+/// <reference path="./domain-spec.ts" />
+/// <reference path="./configurator-globals.ts" />
+/// <reference path="./admin-globals.ts" />
+/// <reference path="./webhook-builders.ts" />
 
 ${f.toTypeOnlyString(".phoenix/globals.d.ts")}
 
+${g.declarations}
+
 declare global {
-${h}
+${S}
 
   interface PhxGlobal {
     readonly frontendEnv: import('./frontend.config.js').RuntimeConfig
     readonly webhooksEnv: import('./webhooks.config.js').RuntimeConfig
 
     readonly applicationTypes: {
-      readonly ApplicationVersion: typeof import('./domain-spec.js').ApplicationVersion
-      readonly PublishedDataHash: typeof import('./domain-spec.js').PublishedDataHash
+      readonly ApplicationVersion: ${JSON.stringify(t.appMetadata.applicationVersion)}
+      readonly PublishedDataHash: ${JSON.stringify(t.configurator.dataSchemas.publishedDataHash)}
       readonly PublishedData: PublishedData
       readonly SessionData: SessionData
       readonly FrontendData: FrontendData
@@ -68,42 +78,13 @@ ${h}
       readonly AdminNavigationState: EnumLike<AdminNavigationState>
     }
 
-    readonly domain: {
-      readonly model: typeof import('./domain-spec.js').model
-      readonly enhancedModel: typeof import('./domain-spec.js').enhancedModel
-      readonly implementCustomExpressions: typeof import('./domain-spec.js').implementCustomExpressions
-      readonly implementCustomInvariants: typeof import('./domain-spec.js').implementCustomInvariants
-      readonly implementActions: typeof import('./domain-spec.js').implementActions
-      readonly attachComponent: typeof import('./domain-spec.js').attachComponent
-      readonly createRecipe: typeof import('./domain-spec.js').createRecipe
-
-      readonly admin: {
-        readonly model: typeof import('./domain-spec.js').adminModel
-        readonly enhancedModel: typeof import('./domain-spec.js').adminEnhancedModel
-        readonly implementCustomExpressions: typeof import('./domain-spec.js').implementAdminCustomExpressions
-        readonly implementCustomInvariants: typeof import('./domain-spec.js').implementCustomAdminInvariants
-        readonly attachComponent: typeof import('./domain-spec.js').attachAdminComponent
-        readonly createMapPublishedRevisionDataHandler: typeof import('./domain-spec.js').createMapPublishedRevisionDataHandler
-        readonly createMapPublishedChunkedDataHandler: typeof import('./domain-spec.js').createMapPublishedChunkedDataHandler
-        readonly createDataRowValidatorHandler: typeof import('./domain-spec.js').createDataRowValidatorHandler
-        readonly createSheetValidatorHandler: typeof import('./domain-spec.js').createSheetValidatorHandler
-        readonly createRecipe: typeof import('./domain-spec.js').createAdminRecipe
-      }
-    }
+    readonly domain: ${D(g.domainType,"    ")}
 
-    readonly frontend: typeof import('./configurator-globals.js').configuratorInterface & {
-      readonly admin: typeof import('./admin-globals.js').adminInterface
+    readonly frontend: ${g.configuratorInterfaceType} & {
+      readonly admin: ${g.adminInterfaceType}
     }
 
-    readonly webhooks: {
-      readonly authHandlerBuilder: typeof import('./webhook-builders.js').authHandlerBuilder
-      readonly webhookBuilder: typeof import('./webhook-builders.js').webhookBuilder
-      readonly taskFactory: typeof import('./webhook-builders.js').taskFactory
-      readonly finalizeHandlerBuilder: typeof import('./webhook-builders.js').finalizeHandlerBuilder
-      readonly callbackBuilder: typeof import('./webhook-builders.js').callbackBuilder
-      readonly prefetchBuilder: typeof import('./webhook-builders.js').prefetchBuilder
-      readonly dynamicResourcesFactory: typeof import('./webhook-builders.js').dynamicResourcesFactory
-    }
+    readonly webhooks: ${D(g.webhooksType,"    ")}
   }
 }
 `};

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

@@ -12,7 +12,6 @@
  * @module
  */
 export { stripSdkMarkerContent } from './common/strip-sdk-marker-content.js';
-export { generateAgentsMd } from './skills/agents-md.js';
 export { generateApplicationSpecAdminConfig } from './admin-config.js';
 export { generateApplicationSpecAdminCode } from './admin-domain-code.js';
 export { generateApplicationSpecAdminFrontendCode } from './admin-frontend-code.js';
@@ -30,8 +29,6 @@ export { generateApplicationSpecDomainFile } from './domain.js';
 export { generateApplicationSpecEditorFile } from './editor.js';
 export { generateApplicationSpecEmbeddedAdmin } from './embedded-admin.js';
 export { generateApplicationSpecEmbeddedConfigurator } from './embedded-configurator.js';
-export { generateApplicationSpecEnvCi } from './env-ci.js';
-export { generateApplicationSpecEnvExample } from './env-example.js';
 export { generateApplicationSpecEslintConfig } from './eslint-config.js';
 export { generateApplicationSpecFavicon } from './favicon.js';
 export { generateApplicationSpecFrontendConfig } from './frontend-config.js';
@@ -40,22 +37,15 @@ export { generateApplicationSpecGlobals } from './globals.js';
 export { generateApplicationSpecHtmlAdminIndex } from './html-admin-index.js';
 export { generateApplicationSpecHtmlIndex } from './html-index.js';
 export { generateLinguiRcFile } from './lingui-rc.js';
-export { generateApplicationSpecNvmrc } from './nvmrc.js';
-export { generateApplicationSpecPackageJson } from './package-json.js';
-export { generatePhoenixCliSkill } from './skills/phoenix-cli-skill.js';
-export { generatePhoenixCreateConfiguratorSkill, generatePhoenixCreateConfiguratorSkillReferences, } from './skills/phoenix-create-configurator-skill.js';
-export { generatePhoenixFeedbackSkill } from './skills/phoenix-feedback-skill.js';
-export { generatePhoenixReviewSkill } from './skills/phoenix-review-skill.js';
-export { type PhoenixSkillOptions, followsCanaryBuilds, generatePhoenixSkill } from './skills/phoenix-skill.js';
+export { generatePhoenixSkillBundle } from './skills/phoenix-skill-bundle.js';
+export { type PhoenixSkillOptions, followsCanaryBuilds } from './skills/phoenix-skill.js';
 export { generateApplicationSpecPrettierConfig } from './prettier-config.js';
-export { generateApplicationSpecPrettierIgnore } from './prettier-ignore.js';
-export { generateApplicationSpecPrivateAssetsReadme } from './private-assets-readme.js';
-export { generateApplicationSpecPublicAssetsReadme } from './public-assets-readme.js';
-export { generateApplicationSpecReadme } from './readme.js';
 export { generateApplicationSpecRobotsTxt } from './robots-txt.js';
+export { generateApplicationSpecRootTsconfig } from './root-tsconfig.js';
 export { generateApplicationSpecStoryDevDeclaration, generateApplicationSpecStoryPhxModule, generateApplicationSpecStoryRawProjectFiles, generateApplicationSpecStoryWrapper, } from './story/index.js';
+export { generateApplicationSpecCodeFile } from './spec-code/index.js';
+export { generateApplicationSpecMessagesFile } from './spec-messages/index.js';
 export { generateApplicationSpecTsconfig } from './tsconfig.js';
 export { generateApplicationSpecWebhookBuilders } from './webhook-builders.js';
-export { generateApplicationSpecWebhookImplementation } from './webhook-implementation.js';
 export { generateApplicationSpecWebhookIndex } from './webhook-index.js';
 export { generateApplicationSpecWebhooksConfig } from './webhooks-config.js';

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

@@ -1 +1 @@
-export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateAgentsMd}from"./skills/agents-md.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEnvCi}from"./env-ci.js";export{generateApplicationSpecEnvExample}from"./env-example.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generateApplicationSpecNvmrc}from"./nvmrc.js";export{generateApplicationSpecPackageJson}from"./package-json.js";export{generatePhoenixCliSkill}from"./skills/phoenix-cli-skill.js";export{generatePhoenixCreateConfiguratorSkill,generatePhoenixCreateConfiguratorSkillReferences}from"./skills/phoenix-create-configurator-skill.js";export{generatePhoenixFeedbackSkill}from"./skills/phoenix-feedback-skill.js";export{generatePhoenixReviewSkill}from"./skills/phoenix-review-skill.js";export{followsCanaryBuilds,generatePhoenixSkill}from"./skills/phoenix-skill.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecPrettierIgnore}from"./prettier-ignore.js";export{generateApplicationSpecPrivateAssetsReadme}from"./private-assets-readme.js";export{generateApplicationSpecPublicAssetsReadme}from"./public-assets-readme.js";export{generateApplicationSpecReadme}from"./readme.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookImplementation}from"./webhook-implementation.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";
+export{stripSdkMarkerContent}from"./common/strip-sdk-marker-content.js";export{generateApplicationSpecAdminConfig}from"./admin-config.js";export{generateApplicationSpecAdminCode}from"./admin-domain-code.js";export{generateApplicationSpecAdminFrontendCode}from"./admin-frontend-code.js";export{generateAdminGlobalBindingBlock,generateApplicationSpecAdminGlobals}from"./admin-globals.js";export{generateApplicationSpecTypesModule}from"./application-types.js";export{generateApplicationSpecAdminFile}from"./admin.js";export{generateApplicationSpecConfiguratorConfig}from"./configurator-config.js";export{generateApplicationSpecConfiguratorCode}from"./configurator-domain-code.js";export{generateApplicationSpecConfiguratorFrontendCode}from"./configurator-frontend-code.js";export{generateApplicationSpecConfiguratorGlobals,generateConfiguratorGlobalBindingBlock}from"./configurator-globals.js";export{generateApplicationSpecConfiguratorFile}from"./configurator.js";export{generateApplicationSpecDomainSpecFile}from"./domain-spec.js";export{generateImportedStateConstants,generatePhxExportsBlock,generatePhxGlobalsBlock,generateStateConstants}from"./domain-spec/index.js";export{generateApplicationSpecDomainFile}from"./domain.js";export{generateApplicationSpecEditorFile}from"./editor.js";export{generateApplicationSpecEmbeddedAdmin}from"./embedded-admin.js";export{generateApplicationSpecEmbeddedConfigurator}from"./embedded-configurator.js";export{generateApplicationSpecEslintConfig}from"./eslint-config.js";export{generateApplicationSpecFavicon}from"./favicon.js";export{generateApplicationSpecFrontendConfig}from"./frontend-config.js";export{generateApplicationSpecGitignore}from"./gitignore.js";export{generateApplicationSpecGlobals}from"./globals.js";export{generateApplicationSpecHtmlAdminIndex}from"./html-admin-index.js";export{generateApplicationSpecHtmlIndex}from"./html-index.js";export{generateLinguiRcFile}from"./lingui-rc.js";export{generatePhoenixSkillBundle}from"./skills/phoenix-skill-bundle.js";export{followsCanaryBuilds}from"./skills/phoenix-skill.js";export{generateApplicationSpecPrettierConfig}from"./prettier-config.js";export{generateApplicationSpecRobotsTxt}from"./robots-txt.js";export{generateApplicationSpecRootTsconfig}from"./root-tsconfig.js";export{generateApplicationSpecStoryDevDeclaration,generateApplicationSpecStoryPhxModule,generateApplicationSpecStoryRawProjectFiles,generateApplicationSpecStoryWrapper}from"./story/index.js";export{generateApplicationSpecCodeFile}from"./spec-code/index.js";export{generateApplicationSpecMessagesFile}from"./spec-messages/index.js";export{generateApplicationSpecTsconfig}from"./tsconfig.js";export{generateApplicationSpecWebhookBuilders}from"./webhook-builders.js";export{generateApplicationSpecWebhookIndex}from"./webhook-index.js";export{generateApplicationSpecWebhooksConfig}from"./webhooks-config.js";

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

@@ -1 +1,6 @@
+/**
+ * The project's Lingui configuration, generated to `.phoenix/.linguirc` and, for a Storybook story, to
+ * the story's root. Lingui resolves its paths against the directory it runs in, the project or story
+ * root, so they hold in either place; `<rootDir>` would be the folder that holds the file.
+ */
 export declare const generateLinguiRcFile: (availableLocales: readonly string[]) => string;

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

@@ -1,12 +1,12 @@
-import{DEFAULT_FALLBACK_LOCALE as e,LOCALE_FALLBACK_MAP as a}from"#package/i18n";export const generateLinguiRcFile=o=>{let s;return`{
+import{DEFAULT_FALLBACK_LOCALE as e,LOCALE_FALLBACK_MAP as a}from"#package/i18n";export const generateLinguiRcFile=s=>{let o;return`{
   "sourceLocale": "en",
-  "locales": [${o.map(e=>`"${e}"`).join(", ")}],
+  "locales": [${s.map(e=>`"${e}"`).join(", ")}],
   "fallbackLocales": {
-${(s=Object.entries(a).map(([e,a])=>{let o=Array.isArray(a)?`[${a.map(e=>`"${e}"`).join(", ")}]`:`"${a}"`;return`    "${e}": ${o}`})).push(`    "default": "${e}"`),s.join(",\n")}
+${(o=Object.entries(a).map(([e,a])=>{let s=Array.isArray(a)?`[${a.map(e=>`"${e}"`).join(", ")}]`:`"${a}"`;return`    "${e}": ${s}`})).push(`    "default": "${e}"`),o.join(",\n")}
   },
   "catalogs": [
     {
-      "path": "<rootDir>/src/locales/{locale}/messages",
+      "path": "./src/locales/{locale}/messages",
       "include": [
         "./src",
         "./.phoenix"

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

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

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * The project's root `tsconfig.json`, written once when the project has none: it extends the
+ * generated settings in `.phoenix/tsconfig.json`, so editors and tools that look for a
+ * `tsconfig.json` in the project root find them. It is the project's afterwards, to add to.
+ */
+export declare const generateApplicationSpecRootTsconfig: () => string;

package/dist/application-spec/generate-application/code/templates/root-tsconfig.js

@@ -0,0 +1,2 @@
+export const generateApplicationSpecRootTsconfig=()=>`{ "extends": "./.phoenix/tsconfig.json" }
+`;

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

@@ -1 +1 @@
-import{renderAgentSkill as n}from"./agent-skill.js";import{sdkGuidanceSections as e}from"./sdk-content.js";export const generatePhoenixCliSkill=()=>n({name:"phoenix-cli",description:"Phoenix CLI tooling for building and inspecting this configurator, covering build, dev and sync commands, dev logs, glTF asset inspection, screenshots, runtime state, data and scene inspection, and Playwright MCP setup. Use when building, debugging build or runtime errors, checking 3D assets, or inspecting the running configurator.",sections:[e.buildCommands,e.devLogs,e.assetInspection,e.screenshotCli,e.inspectState,e.inspectData,e.inspectScene,e.playwrightMcpSetup]});
+import{renderAgentSkill as e}from"./agent-skill.js";import{sdkGuidanceSections as n}from"./sdk-content.js";export const generatePhoenixCliSkill=()=>e({name:"phoenix-cli",description:"Phoenix CLI tooling for building and inspecting this configurator, covering build, dev, sync and deps commands, dev logs, glTF asset inspection, screenshots, runtime state, data and scene inspection, variant previews, and Playwright MCP setup. Use when building, debugging build or runtime errors, checking 3D assets, or inspecting the running configurator.",sections:[n.packageManager,n.buildCommands,n.devLogs,n.assetInspection,n.screenshotCli,n.inspectState,n.inspectData,n.inspectScene,n.variantPreviews,n.playwrightMcpSetup]});