@salsita-ai/sdk 0.50.0-develop.c28cfb7ded → 0.50.0-develop.c402728d10

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

@@ -0,0 +1,168 @@
+import type { Acl, Actions, AdminPages, AdminStates, AppMetadata, AssistantResolvedManifest, Chunks, CommonTypes, Components, ConfiguratorStates, Defaults, EntityOrAliasName, EntityTypeName, EntityTypes, Expressions, Invariants, JsonSchema, ModelVersionKey, ParsedDataSpecEntries, Presets, ResourceEntry, SpecAliases, SpecResourcesConfig, SpecTransformers, Theme, Ui } from '#package/domain';
+/**
+ * The part of a parsed entity schema the runtime reads: the entity type and the schema of its
+ * shape, from which it builds the entity's reflection. The full schema with `id` and `type` is
+ * only registered with a deployment, and the compiled shape validators only check presets and
+ * defaults while parsing.
+ */
+export interface RuntimeEntitySchema {
+    readonly entityType: EntityTypeName;
+    readonly shapeSchema: JsonSchema;
+}
+/**
+ * The part of a parsed model version the runtime reads: the entity types, the aliases, the common
+ * types and the schema of every entity's shape. The shapes and the resolved shapes only serve the
+ * parser and the type generator, except the runtime schemas of the latest version's shapes (see
+ * `RuntimeLatestModelVersion`).
+ */
+export interface RuntimeModelVersion {
+    readonly versionKey: ModelVersionKey;
+    readonly entityTypes: EntityTypes;
+    /** Entity types allowed as preset root — members of the RootEntity alias, or all entity types if no RootEntity alias. */
+    readonly rootEntityTypes: readonly EntityTypeName[];
+    readonly aliases: SpecAliases;
+    readonly commonTypes: CommonTypes;
+    readonly entitySchemas: readonly RuntimeEntitySchema[];
+}
+/**
+ * The latest model version of a domain as the runtime reads it: a model version plus the runtime
+ * schema of every shape, which `phx.domain.model` reflects as `<Name>Shape`.
+ */
+export interface RuntimeLatestModelVersion extends RuntimeModelVersion {
+    readonly shapes: ReadonlyMap<EntityOrAliasName, RuntimeShapeSchema>;
+}
+/** The part of a parsed shape the runtime reads: its name and its runtime JSON schema. */
+export interface RuntimeShapeSchema {
+    readonly name: EntityOrAliasName;
+    readonly runtimeSchema: JsonSchema;
+}
+/**
+ * One model version of a domain as the runtime reads it, with the migration file that leads to it.
+ * `version` is the integer version number (1, 2, 3, …), `key` is always `v{N}`, never `latest`,
+ * `isLatest` marks the version of the `latest` model key, and `migrationFile` is the path of the
+ * migration file, present from v2 on.
+ */
+export interface RuntimeResolvedModelVersion {
+    readonly version: number;
+    readonly key: string;
+    readonly isLatest: boolean;
+    readonly modelVersion: RuntimeModelVersion;
+    readonly migrationFile: string | undefined;
+}
+/**
+ * Every model version of a domain as the runtime reads it; it builds the domain's migrations from
+ * them. `latestVersion` is the integer of the `latest` key, and `versionedModels` is sorted
+ * ascending by version number.
+ */
+export interface RuntimeResolvedVersions {
+    readonly latestVersion: number;
+    readonly versionedModels: readonly RuntimeResolvedModelVersion[];
+}
+/** The model of a domain as the runtime reads it: the latest version and every earlier one. */
+interface RuntimeDomainModel {
+    readonly latestModel: RuntimeLatestModelVersion;
+    readonly resolvedVersions: RuntimeResolvedVersions;
+}
+/** The part of a parsed data schema the runtime reads: the JSON schema it validates the data with. */
+export interface RuntimeDataSchemaEntry {
+    readonly runtimeSchema: JsonSchema;
+}
+/**
+ * The data schemas as the runtime reads them: the JSON schema of each kind of data and the hash of
+ * the published data. The enhanced schemas, with Phoenix references, only serve the type generator.
+ */
+export interface RuntimeDataSchemas {
+    readonly publishedData: RuntimeDataSchemaEntry;
+    readonly publishedDataHash: string;
+    readonly sessionData: RuntimeDataSchemaEntry;
+    readonly frontendData: RuntimeDataSchemaEntry;
+    readonly backendData: RuntimeDataSchemaEntry | undefined;
+    readonly finalizeData: RuntimeDataSchemaEntry;
+    readonly prefetchedFinalizeData: RuntimeDataSchemaEntry;
+    readonly finalizeResult: RuntimeDataSchemaEntry;
+    readonly callbackData: RuntimeDataSchemaEntry;
+}
+/**
+ * The assistant as the runtime reads it: its resolved manifest. The parsed assistant schema the
+ * manifest is resolved from only serves the parser.
+ */
+export type RuntimeAssistantSpec = {
+    readonly resolved: AssistantResolvedManifest;
+} | null;
+/**
+ * The data spec as the runtime reads it: the data entries and their chunks. The data entries and
+ * admin data pages the parser derives from them only serve the admin spec and the type generator.
+ */
+export interface RuntimeDataSpec {
+    /** Validated entries grouped by their source `$data` subsection for generated SDK config. */
+    readonly entries: ParsedDataSpecEntries;
+    /** Validated published-data chunks, including the auto-injected `system` chunk when needed. */
+    readonly chunks: Chunks;
+}
+/**
+ * The configurator part of the runtime spec. It leaves out the configuration schema and its
+ * version, which only a deployment registers, and the assistant's server settings (instructions
+ * and AI settings), which must never reach the browser of a customer.
+ */
+export interface RuntimeConfiguratorSpec extends RuntimeDomainModel {
+    readonly components: Components;
+    readonly presets: Presets;
+    readonly expressions: Expressions;
+    readonly actions: Actions;
+    readonly invariants: Invariants;
+    readonly defaults: Defaults;
+    readonly states: ConfiguratorStates;
+    readonly theme: Theme;
+    readonly ui: Ui;
+    readonly transformers: SpecTransformers;
+    readonly dataSchemas: RuntimeDataSchemas;
+    readonly assistant: RuntimeAssistantSpec;
+}
+/**
+ * The admin part of the runtime spec. It leaves out the configuration schema and its version, which
+ * only a deployment registers.
+ */
+export interface RuntimeAdminSpec extends RuntimeDomainModel {
+    readonly components: Components;
+    readonly presets: Presets;
+    readonly expressions: Expressions;
+    readonly invariants: Invariants;
+    readonly defaults: Defaults;
+    readonly states: AdminStates;
+    readonly adminPages: AdminPages;
+}
+/**
+ * The infrastructure settings the runtime reads: access control and resources. The environment
+ * variable declarations only drive the generated environment readers.
+ */
+export interface RuntimeInfra {
+    readonly acl: Acl;
+    readonly resources: readonly ResourceEntry[] | undefined;
+    readonly resourcesConfig: SpecResourcesConfig | undefined;
+}
+/**
+ * The parsed application spec as the runtime reads it: what `ApplicationRuntime` builds the
+ * configurator and admin runtimes from, and the sections an application needs besides its domains
+ * (data spec, app metadata, resources, access control, user interface settings, webhook data
+ * schemas, admin pages). `phoenix sync` and `phoenix build` write it to
+ * `.phoenix/application-spec.json` with `encodeRuntimeSpec`.
+ *
+ * Its sections are the spec data types of `domain`, the types the parser produces, so a parsed
+ * `ApplicationSpec` is assignable to it. It leaves out what only the parser, the type generator or
+ * a deployment use, and holds plain data, Maps and Sets only, so it can be encoded as JSON.
+ */
+export interface RuntimeSpec {
+    readonly appMetadata: AppMetadata;
+    readonly dataSpec: RuntimeDataSpec;
+    readonly configurator: RuntimeConfiguratorSpec;
+    readonly admin: RuntimeAdminSpec;
+    readonly infra: RuntimeInfra;
+}
+/**
+ * Takes from a parsed application spec the part the runtime reads. It reuses the sections it keeps
+ * whole, and builds trimmed copies of the model versions, data schemas, assistant and data spec
+ * without what the runtime does not read. It takes any `RuntimeSpec`, which a parsed
+ * `ApplicationSpec` is, and copies only what the type declares.
+ */
+export declare const toRuntimeSpec: (spec: RuntimeSpec) => RuntimeSpec;
+export {};

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

@@ -0,0 +1 @@
+let e=e=>({versionKey:e.versionKey,entityTypes:e.entityTypes,rootEntityTypes:e.rootEntityTypes,aliases:e.aliases,commonTypes:e.commonTypes,entitySchemas:e.entitySchemas.map(e=>({entityType:e.entityType,shapeSchema:e.shapeSchema}))}),s=e=>({runtimeSchema:e.runtimeSchema}),a=s=>{let a;return{latestModel:{...e(a=s.latestModel),shapes:new Map([...a.shapes].map(([e,s])=>[e,{name:s.name,runtimeSchema:s.runtimeSchema}]))},resolvedVersions:{latestVersion:s.resolvedVersions.latestVersion,versionedModels:s.resolvedVersions.versionedModels.map(s=>({version:s.version,key:s.key,isLatest:s.isLatest,migrationFile:s.migrationFile,modelVersion:e(s.modelVersion)}))}}};export const toRuntimeSpec=e=>{let t,{configurator:n,admin:i,infra:r}=e;return{configurator:{components:n.components,presets:n.presets,expressions:n.expressions,actions:n.actions,invariants:n.invariants,dataSchemas:{publishedDataHash:(t=n.dataSchemas).publishedDataHash,publishedData:s(t.publishedData),sessionData:s(t.sessionData),frontendData:s(t.frontendData),backendData:t.backendData&&s(t.backendData),finalizeData:s(t.finalizeData),prefetchedFinalizeData:s(t.prefetchedFinalizeData),finalizeResult:s(t.finalizeResult),callbackData:s(t.callbackData)},defaults:n.defaults,states:n.states,theme:n.theme,ui:n.ui,transformers:n.transformers,assistant:n.assistant&&{resolved:n.assistant.resolved},...a(n)},admin:{components:i.components,presets:i.presets,expressions:i.expressions,invariants:i.invariants,defaults:i.defaults,states:i.states,adminPages:i.adminPages,...a(i)},appMetadata:e.appMetadata,infra:{acl:r.acl,resources:r.resources,resourcesConfig:r.resourcesConfig},dataSpec:{entries:e.dataSpec.entries,chunks:e.dataSpec.chunks}}};

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

@@ -0,0 +1,40 @@
+import type { MemoEvalPlan } from '#package/domain';
+/**
+ * The id under which the generated `.phoenix/spec-code.ts` holds one piece of code written in YAML,
+ * and under which the runtime looks it up. Ids are unique within one domain; the configurator and
+ * the admin domain each have their own map.
+ *
+ * An id is computed from what the runtime spec already carries, by the functions of this file, on
+ * both sides: the generator that writes the closures and the runtime that reads them. It names the
+ * entity or alias that owns the code, the expression or the component instance, the position of the
+ * code inside that one value, and a hash of the code's text. So it stays the same when anything
+ * else in the spec changes, and it changes whenever the code itself changes: a module generated from
+ * another version of the spec does not hold it, and the runtime compiles the text instead of running
+ * the wrong closure.
+ */
+export type SpecCodeId = string;
+/**
+ * The part of an id that names a value expression: `KitchenRange.$maxWidth`. Its constant, when it
+ * is one, shares the plan and so the ids.
+ */
+export declare const specCodeExpressionKey: (typeOrAlias: string, expressionName: string) => string;
+/**
+ * The part of an id that names a component instance: `KitchenRange.main:detail`. The component
+ * belongs to it because an instance name is unique per component, not per entity: one entity can
+ * attach `main` of several components.
+ */
+export declare const specCodeComponentKey: (typeOrAlias: string, instanceName: string, componentName: string) => string;
+/**
+ * The id of each dependency of a plan, by dependency index: `<key>#<n>@<hash>` for the `n`-th
+ * `$eval` dependency, `undefined` for a read. `key` is the expression or component key of the value
+ * the plan builds. The ordinal counts the plan's `$eval` dependencies only, so a `$read` added to
+ * the same value does not renumber them.
+ */
+export declare const specCodeEvalIds: (plan: MemoEvalPlan, key: string) => ReadonlyArray<SpecCodeId | undefined>;
+/**
+ * Id of the `$eval` of one filter criterion of a component instance:
+ * `KitchenRange.label:textValue#filter0.active@<hash>`. `componentKey` comes from
+ * {@link specCodeComponentKey}; `branch` is the index of the filter among the `$or` alternatives,
+ * 0 when the filter has none; `code` is the criterion's code.
+ */
+export declare const specCodeFilterId: (componentKey: string, branch: number, criterion: string, code: string) => SpecCodeId;

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

@@ -0,0 +1 @@
+let e=e=>{let t=e.trim(),o=0x811c9dc5;for(let e=0;e<t.length;e++)o^=t.charCodeAt(e),o=Math.imul(o,0x1000193)>>>0;return o.toString(16).padStart(8,"0")};export const specCodeExpressionKey=(e,t)=>`${e}.${t}`;export const specCodeComponentKey=(e,t,o)=>`${e}.${t}:${o}`;export const specCodeEvalIds=(t,o)=>{let r=0;return t.deps.map(t=>"eval"===t.kind?`${o}#${r++}@${e(t.code)}`:void 0)};export const specCodeFilterId=(t,o,r,d)=>`${t}#filter${o}.${r}@${e(d)}`;

package/dist/application-spec/parse-application-files/categorize/categorize-files.d.ts

@@ -70,6 +70,34 @@ export type CategorizedFiles = Branded<'CategorizedFiles', {
     readonly mockTemplatesChanged: boolean;
     readonly projectFiles: readonly CategorizedFile[];
     readonly projectFilesChanged: boolean;
+    /**
+     * One-time migration: true only on a checkout's first sync with an SDK that contains this field;
+     * delete it once projects have synced with such an SDK.
+     *
+     * Whether the project's root `tsconfig.json` is the full file earlier SDK versions generated on
+     * every sync, before the TypeScript settings moved to `.phoenix/tsconfig.json`. Generation reads
+     * it to replace that file with the one-line `tsconfig.json` that extends `.phoenix/tsconfig.json`;
+     * any other root `tsconfig.json` is the project's own and is left as it is.
+     */
+    readonly hasEarlierGeneratedTsconfig: boolean;
+    /**
+     * One-time migration: true only on a checkout's first sync with an SDK that contains this field;
+     * delete it once projects have synced with such an SDK.
+     *
+     * Whether the project's root `eslint.config.js` is the file earlier SDK versions generated on
+     * every sync, before it became the project's. Generation reads it to replace that file once with
+     * the current one; any other root `eslint.config.js` is the project's own and is left as it is.
+     */
+    readonly hasEarlierGeneratedEslintConfig: boolean;
+    /**
+     * One-time migration: true only on a checkout's first sync with an SDK that contains this field;
+     * delete it once projects have synced with such an SDK.
+     *
+     * Whether the project's root `prettier.config.js` is the file earlier SDK versions generated on
+     * every sync, before it became the project's. Generation reads it to replace that file once with
+     * the current one; any other root `prettier.config.js` is the project's own and is left as it is.
+     */
+    readonly hasEarlierGeneratedPrettierConfig: boolean;
     readonly customCode: readonly CategorizedFile[];
     readonly customCodeChanged: boolean;
     readonly envs: Record<string, unknown>;

package/dist/application-spec/parse-application-files/categorize/categorize-files.js

@@ -1 +1 @@
-import e from"lodash-es/isEqual.js";import{Branded as n}from"@salsita-ai/common/utils";import{computeFileDepHashes as s}from"../../caching/index.js";import{DiagnosticCode as o,diagnosticMessages as a}from"../../errors/index.js";import{findWebhookHandlerRegistration as i}from"./module-analysis.js";import{findWebhookSafetyViolation as t}from"./webhook-safety.js";export const buildProjectFileIndex=e=>new Map([...e.spec,...e.expressions,...e.actions,...e.handlers,...e.elements,...e.transformers,...e.components,...e.invariants,...e.migrations,...e.adminMigrations,...e.adminExpressions,...e.adminInvariants,...e.adminComponents,...e.adminElements,...e.webhooks,...e.locales,...e.mockTemplates,...e.projectFiles,...e.customCode].map(e=>[e.file.name,e]));let r=e=>/\/_[^/]+\//.test(e),m=[{path:"spec/",key:"spec"},{path:"src/admin/expressions/",key:"adminExpressions"},{path:"src/admin/invariants/",key:"adminInvariants"},{path:"src/admin/components/",key:"adminComponents"},{path:"src/admin/elements/",key:"adminElements"},{path:"src/admin/migrations/",key:"adminMigrations"},{path:"src/expressions/",key:"expressions"},{path:"src/actions/",key:"actions"},{path:"src/handlers/",key:"handlers"},{path:"src/elements/",key:"elements"},{path:"src/transformers/",key:"transformers"},{path:"src/components/",key:"components"},{path:"src/invariants/",key:"invariants"},{path:"src/migrations/",key:"migrations"},{path:"src/webhooks/",key:"webhooks"},{path:"src/locales/",key:"locales"},{path:"mocks/",key:"mockTemplates"}],l=new Set(["package.json",".gitignore","CLAUDE.md",".cursor/rules/phoenix.mdc"]),d=new Set(["migrations","adminMigrations"]),c=m.filter(({path:e,key:n})=>e.startsWith("src/")&&d.has(n)),p=(e,n)=>{let s=e.slice(n.length).split("/");return!(s.length<=1)&&s.slice(0,-1).some(e=>!e.startsWith("_"))},h=/\.(ts|tsx|js|jsx)$/,f=(e,n)=>{if("components"===e||"adminComponents"===e)return n.hasUseWebhookDirective?{membership:"pinned",logSuffix:"webhook ('use webhook' directive)"}:{membership:"frontend",logSuffix:"frontend only (no 'use webhook' directive)"};if("handlers"===e){let e=i(n);return void 0!==e?{membership:"named-handler",logSuffix:`webhook (the ${e} registration)`}:n.hasUseWebhookDirective?{membership:"pinned",logSuffix:"webhook ('use webhook' directive)"}:{membership:"frontend",logSuffix:"frontend only (not a named handler or pin)"}}};export const CategorizedFiles=(i,d,g,u)=>{let k={spec:[],expressions:[],actions:[],handlers:[],elements:[],transformers:[],components:[],invariants:[],migrations:[],adminMigrations:[],adminExpressions:[],adminInvariants:[],adminComponents:[],adminElements:[],webhooks:[],locales:[],mockTemplates:[],projectFiles:[],customCode:[]},b=[];for(let e of i.files){if("text"!==e.kind)continue;if(r(e.name)){k.customCode.push({file:e,category:"customCode"});continue}if(l.has(e.name)){k.projectFiles.push({file:e,category:"projectFiles"});continue}let n=!1;for(let{path:s,key:o}of m)if(e.name.startsWith(s)){k[o].push({file:e,category:o}),n=!0;break}n||b.push(e.name)}for(let e of b)e.startsWith("src/")&&g.error(o.UNKNOWN_SRC_PATH,a.UNKNOWN_SRC_PATH(e));for(let{path:e,key:n}of c)for(let s of k[n])p(s.file.name,e)&&g.error(o.INVALID_SUBDIRECTORY,a.INVALID_SUBDIRECTORY(s.file.name,e));let C=k.webhooks.some(e=>"src/webhooks/index.ts"===e.file.name);if(k.webhooks.length>0&&!C&&g.error(o.MISSING_WEBHOOK_INDEX,a.MISSING_WEBHOOK_INDEX()),g.hasErrors)return;let v=[];for(let e of Object.values(k))for(let n of e)v.push(n.file.name);let x=s(i,v),{analyzer:y,logger:E}=u,I=d.createBuilder("categorizedFiles/moduleAnalysis",{build:e=>{try{return{analysis:y(e.name,e.content)}}catch(e){return{error:e instanceof Error?e.message:String(e)}}},getKey:e=>e.name,compare:(e,n)=>e.content===n.content}),w=new Set,S=e=>{if(!h.test(e.name))return;w.add(e.name);let n=I.build({name:e.name,content:e.content}).output;return void 0!==n.error?void g.error(o.MODULE_ANALYSIS_FAILED,a[o.MODULE_ANALYSIS_FAILED](e.name,n.error)):n.analysis},j={},_={};for(let[e,s]of Object.entries(k)){let o=d.createBuilder(`categorizedFiles/${e}`,{build:e=>e,getKey:e=>e.name,compare:(e,n)=>e.depHash===n.depHash}),a=new Set;j[e]=s.map(e=>{let s=x[e.file.name]??{deps:[],hash:""},{changed:i}=o.build({name:e.file.name,depHash:s.hash});a.add(e.file.name);let t=S(e.file),r=void 0===t?void 0:f(e.category,t);return void 0!==r&&E.debug(`Webhook membership: ${e.file.name} -> ${r.logSuffix}`),n({file:e.file,category:e.category,deps:s.deps,depHash:s.hash,changed:i,analysis:t,webhookMembership:r?.membership})}),_[e]=o.cleanup(a)}I.cleanup(w);let F=(e,n)=>n.some(e=>e.changed)||!0===_[e],M=d.createBuilder("categorizedFiles/envs",{build:e=>e.envs,getKey:()=>"singleton",compare:(n,s)=>e(n.envs,s.envs)}).build({envs:i.envs}),O=n({spec:j.spec,specChanged:F("spec",j.spec),expressions:j.expressions,expressionsChanged:F("expressions",j.expressions),actions:j.actions,actionsChanged:F("actions",j.actions),handlers:j.handlers,handlersChanged:F("handlers",j.handlers),elements:j.elements,elementsChanged:F("elements",j.elements),transformers:j.transformers,transformersChanged:F("transformers",j.transformers),components:j.components,componentsChanged:F("components",j.components),invariants:j.invariants,invariantsChanged:F("invariants",j.invariants),migrations:j.migrations,migrationsChanged:F("migrations",j.migrations),adminMigrations:j.adminMigrations,adminMigrationsChanged:F("adminMigrations",j.adminMigrations),adminExpressions:j.adminExpressions,adminExpressionsChanged:F("adminExpressions",j.adminExpressions),adminInvariants:j.adminInvariants,adminInvariantsChanged:F("adminInvariants",j.adminInvariants),adminComponents:j.adminComponents,adminComponentsChanged:F("adminComponents",j.adminComponents),adminElements:j.adminElements,adminElementsChanged:F("adminElements",j.adminElements),webhooks:j.webhooks,webhooksChanged:F("webhooks",j.webhooks),hasWebhookEntry:C,locales:j.locales,localesChanged:F("locales",j.locales),mockTemplates:j.mockTemplates,mockTemplatesChanged:F("mockTemplates",j.mockTemplates),projectFiles:j.projectFiles,projectFilesChanged:F("projectFiles",j.projectFiles),customCode:j.customCode,customCodeChanged:F("customCode",j.customCode),envs:M.output,envsChanged:M.changed}),N=buildProjectFileIndex(O);for(let e of N.values()){if("pinned"!==e.webhookMembership&&"named-handler"!==e.webhookMembership)continue;let n=t(e,N);void 0!==n&&g.error(o.WEBHOOK_UNSAFE_IMPORT,a[o.WEBHOOK_UNSAFE_IMPORT](n.fileName,n.inclusionReason,n.importer,n.specifier))}return O};
+import e from"lodash-es/isEqual.js";import{Branded as n}from"@salsita-ai/common/utils";import{computeFileDepHashes as s}from"../../caching/index.js";import{DiagnosticCode as o,diagnosticMessages as i}from"../../errors/index.js";import{isEarlierGeneratedEslintConfig as t,isEarlierGeneratedPrettierConfig as a}from"./earlier-generated-editor-configs.js";import{isEarlierGeneratedTsconfig as r}from"./earlier-generated-tsconfig.js";import{findWebhookHandlerRegistration as m}from"./module-analysis.js";import{findWebhookSafetyViolation as l}from"./webhook-safety.js";export const buildProjectFileIndex=e=>new Map([...e.spec,...e.expressions,...e.actions,...e.handlers,...e.elements,...e.transformers,...e.components,...e.invariants,...e.migrations,...e.adminMigrations,...e.adminExpressions,...e.adminInvariants,...e.adminComponents,...e.adminElements,...e.webhooks,...e.locales,...e.mockTemplates,...e.projectFiles,...e.customCode].map(e=>[e.file.name,e]));let d=e=>/\/_[^/]+\//.test(e),c=[{path:"spec/",key:"spec"},{path:"src/admin/expressions/",key:"adminExpressions"},{path:"src/admin/invariants/",key:"adminInvariants"},{path:"src/admin/components/",key:"adminComponents"},{path:"src/admin/elements/",key:"adminElements"},{path:"src/admin/migrations/",key:"adminMigrations"},{path:"src/expressions/",key:"expressions"},{path:"src/actions/",key:"actions"},{path:"src/handlers/",key:"handlers"},{path:"src/elements/",key:"elements"},{path:"src/transformers/",key:"transformers"},{path:"src/components/",key:"components"},{path:"src/invariants/",key:"invariants"},{path:"src/migrations/",key:"migrations"},{path:"src/webhooks/",key:"webhooks"},{path:"src/locales/",key:"locales"},{path:"mocks/",key:"mockTemplates"}],p="tsconfig.json",h="eslint.config.js",f="prettier.config.js",g=new Set([".gitignore",p,h,f,"CLAUDE.md",".cursor/rules/phoenix.mdc"]),u=new Set(["migrations","adminMigrations"]),k=c.filter(({path:e,key:n})=>e.startsWith("src/")&&u.has(n)),b=(e,n)=>{let s=e.slice(n.length).split("/");return!(s.length<=1)&&s.slice(0,-1).some(e=>!e.startsWith("_"))},C=/\.(ts|tsx|js|jsx)$/,v=(e,n)=>{if("components"===e||"adminComponents"===e)return n.hasUseWebhookDirective?{membership:"pinned",logSuffix:"webhook ('use webhook' directive)"}:{membership:"frontend",logSuffix:"frontend only (no 'use webhook' directive)"};if("handlers"===e){let e=m(n);return void 0!==e?{membership:"named-handler",logSuffix:`webhook (the ${e} registration)`}:n.hasUseWebhookDirective?{membership:"pinned",logSuffix:"webhook ('use webhook' directive)"}:{membership:"frontend",logSuffix:"frontend only (not a named handler or pin)"}}};export const CategorizedFiles=(m,u,x,y)=>{let E={spec:[],expressions:[],actions:[],handlers:[],elements:[],transformers:[],components:[],invariants:[],migrations:[],adminMigrations:[],adminExpressions:[],adminInvariants:[],adminComponents:[],adminElements:[],webhooks:[],locales:[],mockTemplates:[],projectFiles:[],customCode:[]},j=[];for(let e of m.files){if("text"!==e.kind)continue;if(d(e.name)){E.customCode.push({file:e,category:"customCode"});continue}if(g.has(e.name)){E.projectFiles.push({file:e,category:"projectFiles"});continue}let n=!1;for(let{path:s,key:o}of c)if(e.name.startsWith(s)){E[o].push({file:e,category:o}),n=!0;break}n||j.push(e.name)}for(let e of j)e.startsWith("src/")&&x.error(o.UNKNOWN_SRC_PATH,i.UNKNOWN_SRC_PATH(e));for(let{path:e,key:n}of k)for(let s of E[n])b(s.file.name,e)&&x.error(o.INVALID_SUBDIRECTORY,i.INVALID_SUBDIRECTORY(s.file.name,e));let I=E.webhooks.some(e=>"src/webhooks/index.ts"===e.file.name);if(E.webhooks.length>0&&!I&&x.error(o.MISSING_WEBHOOK_INDEX,i.MISSING_WEBHOOK_INDEX()),x.hasErrors)return;let w=E.projectFiles.find(e=>e.file.name===p),S=void 0!==w&&r(w.file.content),F=E.projectFiles.find(e=>e.file.name===h),_=void 0!==F&&t(F.file.content),M=E.projectFiles.find(e=>e.file.name===f),O=void 0!==M&&a(M.file.content),N=[];for(let e of Object.values(E))for(let n of e)N.push(n.file.name);let A=s(m,N),{analyzer:T,logger:D}=y,W=u.createBuilder("categorizedFiles/moduleAnalysis",{build:e=>{try{return{analysis:T(e.name,e.content)}}catch(e){return{error:e instanceof Error?e.message:String(e)}}},getKey:e=>e.name,compare:(e,n)=>e.content===n.content}),U=new Set,H=e=>{if(!C.test(e.name))return;U.add(e.name);let n=W.build({name:e.name,content:e.content}).output;return void 0!==n.error?void x.error(o.MODULE_ANALYSIS_FAILED,i[o.MODULE_ANALYSIS_FAILED](e.name,n.error)):n.analysis},B={},K={};for(let[e,s]of Object.entries(E)){let o=u.createBuilder(`categorizedFiles/${e}`,{build:e=>e,getKey:e=>e.name,compare:(e,n)=>e.depHash===n.depHash}),i=new Set;B[e]=s.map(e=>{let s=A[e.file.name]??{deps:[],hash:""},{changed:t}=o.build({name:e.file.name,depHash:s.hash});i.add(e.file.name);let a=H(e.file),r=void 0===a?void 0:v(e.category,a);return void 0!==r&&D.debug(`Webhook membership: ${e.file.name} -> ${r.logSuffix}`),n({file:e.file,category:e.category,deps:s.deps,depHash:s.hash,changed:t,analysis:a,webhookMembership:r?.membership})}),K[e]=o.cleanup(i)}W.cleanup(U);let L=(e,n)=>n.some(e=>e.changed)||!0===K[e],R=u.createBuilder("categorizedFiles/envs",{build:e=>e.envs,getKey:()=>"singleton",compare:(n,s)=>e(n.envs,s.envs)}).build({envs:m.envs}),P=n({spec:B.spec,specChanged:L("spec",B.spec),expressions:B.expressions,expressionsChanged:L("expressions",B.expressions),actions:B.actions,actionsChanged:L("actions",B.actions),handlers:B.handlers,handlersChanged:L("handlers",B.handlers),elements:B.elements,elementsChanged:L("elements",B.elements),transformers:B.transformers,transformersChanged:L("transformers",B.transformers),components:B.components,componentsChanged:L("components",B.components),invariants:B.invariants,invariantsChanged:L("invariants",B.invariants),migrations:B.migrations,migrationsChanged:L("migrations",B.migrations),adminMigrations:B.adminMigrations,adminMigrationsChanged:L("adminMigrations",B.adminMigrations),adminExpressions:B.adminExpressions,adminExpressionsChanged:L("adminExpressions",B.adminExpressions),adminInvariants:B.adminInvariants,adminInvariantsChanged:L("adminInvariants",B.adminInvariants),adminComponents:B.adminComponents,adminComponentsChanged:L("adminComponents",B.adminComponents),adminElements:B.adminElements,adminElementsChanged:L("adminElements",B.adminElements),webhooks:B.webhooks,webhooksChanged:L("webhooks",B.webhooks),hasWebhookEntry:I,locales:B.locales,localesChanged:L("locales",B.locales),mockTemplates:B.mockTemplates,mockTemplatesChanged:L("mockTemplates",B.mockTemplates),projectFiles:B.projectFiles,projectFilesChanged:L("projectFiles",B.projectFiles),hasEarlierGeneratedTsconfig:S,hasEarlierGeneratedEslintConfig:_,hasEarlierGeneratedPrettierConfig:O,customCode:B.customCode,customCodeChanged:L("customCode",B.customCode),envs:R.output,envsChanged:R.changed}),$=buildProjectFileIndex(P);for(let e of $.values()){if("pinned"!==e.webhookMembership&&"named-handler"!==e.webhookMembership)continue;let n=l(e,$);void 0!==n&&x.error(o.WEBHOOK_UNSAFE_IMPORT,i[o.WEBHOOK_UNSAFE_IMPORT](n.fileName,n.inclusionReason,n.importer,n.specifier))}return P};

package/dist/application-spec/parse-application-files/categorize/earlier-generated-editor-configs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * One-time migration, see the top of this module: true only before a checkout's first sync with this SDK.
+ *
+ * Whether the content of a project's root `eslint.config.js` is the file earlier SDK versions
+ * generated. Whitespace, semicolons and the quote style do not count; any other difference makes the
+ * file the project's own.
+ */
+export declare const isEarlierGeneratedEslintConfig: (content: string) => boolean;
+/**
+ * One-time migration, see the top of this module: true only before a checkout's first sync with this SDK.
+ *
+ * Whether the content of a project's root `prettier.config.js` is the file earlier SDK versions
+ * generated. Whitespace, semicolons and the quote style do not count; any other difference makes the
+ * file the project's own.
+ */
+export declare const isEarlierGeneratedPrettierConfig: (content: string) => boolean;

package/dist/application-spec/parse-application-files/categorize/earlier-generated-editor-configs.js

@@ -0,0 +1,9 @@
+let e=`/**
+ * Auto-generated file.
+ * Do not modify this file manually.
+ * Version: 1
+ */`,t=["@salsita-ai/sdk/common","@salsita-ai/platform-common","@salsita-ai/common"],a=(a,r)=>t.map(t=>`${e}
+import { ${a} } from '${t}/${r}'
+
+export default ${a}
+`),r=e=>e.replace(/\s+/g,"").replace(/;/g,"").replace(/"/g,"'"),i=new Set(a("eslintrc","eslint").map(r)),o=new Set(a("prettierrc","prettier").map(r));export const isEarlierGeneratedEslintConfig=e=>i.has(r(e));export const isEarlierGeneratedPrettierConfig=e=>o.has(r(e));

package/dist/application-spec/parse-application-files/categorize/earlier-generated-tsconfig.d.ts

@@ -0,0 +1,9 @@
+/**
+ * One-time migration, see the top of this module: true only before a checkout's first sync with this SDK.
+ *
+ * Whether the content of a project's root `tsconfig.json` is the file earlier SDK versions generated.
+ * The comparison is by meaning: comments, formatting and key order do not count, so a generated
+ * file that an editor or formatter rewrote is still recognised. Content that does not parse, or that
+ * differs in any setting, is the project's own.
+ */
+export declare const isEarlierGeneratedTsconfig: (content: string) => boolean;

package/dist/application-spec/parse-application-files/categorize/earlier-generated-tsconfig.js

@@ -0,0 +1 @@
+import e from"lodash-es/isEqual.js";let l={compilerOptions:{noEmit:!0,module:"ESNext",moduleResolution:"Bundler",lib:["ES2022","DOM"],esModuleInterop:!0,isolatedModules:!0,resolveJsonModule:!0,allowJs:!1,skipLibCheck:!0,strict:!0,noImplicitOverride:!0,noImplicitReturns:!0,noPropertyAccessFromIndexSignature:!0,noUncheckedIndexedAccess:!0,allowUnreachableCode:!1,allowUnusedLabels:!1,noFallthroughCasesInSwitch:!0,noUnusedLocals:!0,noUnusedParameters:!0,useDefineForClassFields:!0,jsx:"react-jsx",paths:{}},include:["src",".phoenix","prettier.config.js","eslint.config.js","./.phoenix/globals.d.ts"]},s=(e,l)=>{let s=l+1;for(;s<e.length&&'"'!==e[s];)s+="\\"===e[s]?2:1;return s+1};export const isEarlierGeneratedTsconfig=t=>e((e=>{try{return JSON.parse((e=>{let l="",t=0;for(;t<e.length;){let n=e[t];if('"'===n){let n=s(e,t);l+=e.slice(t,n),t=n;continue}","===n&&/^\s*[}\]]/.test(e.slice(t+1))||(l+=n),t++}return l})((e=>{let l="",t=0;for(;t<e.length;){let n=e[t],o=e[t+1];if('"'===n){let n=s(e,t);l+=e.slice(t,n),t=n}else if("/"===n&&"/"===o){let l=e.indexOf("\n",t);t=-1===l?e.length:l}else if("/"===n&&"*"===o){let l=e.indexOf("*/",t+2);t=-1===l?e.length:l+2}else l+=n,t++}return l})(e)))}catch{return}})(t),l);

package/dist/application-spec/parse-application-files/merge/merged-assistant.d.ts

@@ -1,13 +1,22 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { AssistantAiSettings } from '@salsita-ai/contracts/assistant';
 import type { ParseContext } from '../../core/index.js';
 import type { RawAssistant } from '../raw-spec/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /**
- * The singular `assistant` manifest after merge, or `null` when no spec file declares one. `origin`
- * names the declaring spec file so manifest diagnostics point at it.
+ * The assistant manifest merged from every spec file that declares an `assistant` block. Each file
+ * may leave `ai` out, but the merged manifest has it: the deployment cannot run its assistant
+ * without the provider, model tier and reasoning level.
+ */
+export type MergedAssistantManifest = RawAssistant & {
+    readonly ai: AssistantAiSettings;
+};
+/**
+ * The `assistant` manifest merged from every spec file that declares an `assistant` block, or `null`
+ * when none does or when none of them declares `ai`. Manifest diagnostics raised after the merge
+ * carry the YAML path but no file, as in every other merged section.
  */
 export type MergedAssistant = Branded<'MergedAssistant', {
-    readonly manifest: RawAssistant | null;
-    readonly origin: string | null;
+    readonly manifest: MergedAssistantManifest | null;
 }>;
 export declare const MergedAssistant: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedAssistant;

package/dist/application-spec/parse-application-files/merge/merged-assistant.js

@@ -1 +1 @@
-import{Branded as t}from"@salsita-ai/common/utils";import{DiagnosticCode as n,diagnosticMessages as o}from"../../errors/index.js";export const MergedAssistant=(r,i)=>{let s,e=null;for(let t of r)if(void 0!==t.content.assistant){if(s){i.error(n.CONFLICTING_ASSISTANT,o.CONFLICTING_ASSISTANT(s,t.name));continue}s=t.name,e=t.content.assistant}return t({manifest:e,origin:s??null})};
+import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as t,diagnosticMessages as s}from"../../errors/index.js";let i=(e,i,n,r)=>{let l=i.flatMap(e=>{let t=n(e.manifest);return t?[{file:e.file,entries:t}]:[]});if(0===l.length)return;let a={},o=new Map;for(let{file:i,entries:n}of l)for(let[l,f]of Object.entries(n)){let n=o.get(l);if(n){r.at("assistant",e,l).error(t.ASSISTANT_MERGE_CONFLICT,s.ASSISTANT_MERGE_CONFLICT(e,l,n,i));continue}o.set(l,i),a[l]=f}return a},n=(e,i,n,r)=>{let l,a;for(let o of i){let i=n(o.manifest);if(void 0!==i){if(l){r.at("assistant",e).error(t.DUPLICATE_ASSISTANT_FIELD,s.DUPLICATE_ASSISTANT_FIELD(e,l,o.file));continue}l=o.file,a=i}}return a};export const MergedAssistant=(r,l)=>{let a=r.flatMap(e=>e.content.assistant?[{file:e.name,manifest:e.content.assistant}]:[]);if(0===a.length)return e({manifest:null});let o={entities:i("entities",a,e=>e.entities,l),deletable:i("deletable",a,e=>e.deletable,l),writable:i("writable",a,e=>e.writable,l),childRecipes:i("childRecipes",a,e=>e.childRecipes,l),replaceRecipes:i("replaceRecipes",a,e=>e.replaceRecipes,l),actions:i("actions",a,e=>e.actions,l),screenshots:i("screenshots",a,e=>e.screenshots,l),formElements:i("formElements",a,e=>e.formElements,l),lenses:n("lenses",a,e=>e.lenses,l),instructions:n("instructions",a,e=>e.instructions,l),ai:n("ai",a,e=>e.ai,l)},{ai:f}=o;return f?e({manifest:{...o,ai:f}}):(l.at("assistant","ai").error(t.ASSISTANT_MISSING_AI,s.ASSISTANT_MISSING_AI()),e({manifest:null}))};

package/dist/application-spec/parse-application-files/merge/merged-infra.d.ts

@@ -1,8 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { Acl, ResourceEntry, SpecResourcesConfig } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
-import type { AclRole } from '../raw-spec/raw-acl.js';
 import type { RawEnvVarEntry } from '../raw-spec/raw-env.js';
-import type { RawResourceEntry } from '../raw-spec/raw-resources.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /** Merged infrastructure settings (env, ACL, resources). */
 export type MergedInfra = Branded<'MergedInfra', {
@@ -10,14 +9,8 @@ export type MergedInfra = Branded<'MergedInfra', {
         readonly frontend?: Readonly<Record<string, RawEnvVarEntry>>;
         readonly webhook?: Readonly<Record<string, RawEnvVarEntry>>;
     };
-    readonly acl: {
-        readonly canCreate: readonly AclRole[];
-    };
-    readonly resources?: readonly RawResourceEntry[];
-    readonly resourcesConfig?: {
-        readonly baseResourcesUrl?: string;
-        readonly prefetchTextureUrls?: readonly string[];
-        readonly deploymentQueryDisabled?: boolean;
-    };
+    readonly acl: Acl;
+    readonly resources?: readonly ResourceEntry[];
+    readonly resourcesConfig?: SpecResourcesConfig;
 }>;
 export declare const MergedInfra: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedInfra;

package/dist/application-spec/parse-application-files/merge/merged-transformers.d.ts

@@ -1,10 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { TransformerEntry } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
-export interface TransformerEntry {
-    readonly name: string;
-    readonly priority?: number;
-}
+export type { TransformerEntry } from '#package/domain';
 /** Merged transformers. The "transformers" section is singular — only one file may declare it. */
 export type MergedTransformers = Branded<'MergedTransformers', readonly TransformerEntry[]>;
 export declare const MergedTransformers: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedTransformers;

package/dist/application-spec/parse-application-files/parse-application-files.js

@@ -1 +1 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{CategorizedFiles as t}from"./categorize/index.js";import{MergedSpec as i}from"./merge/index.js";import{RawSpecFiles as r}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as p}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as a}from"./resolve/index.js";import{ApplicationSpec as o}from"./spec/index.js";export const parseApplicationFiles=(l,n)=>{let{rawProjectFiles:m,phxDefinitions:c}=l,{evalExpressionParser:d,referenceStore:f,parsingContext:F}=n,u=F??new s,S=u.startSpan("parseApplicationFiles","build","parse-application-files.ts"),g=t(m,f,u,n);if(!g)return S(),u.toResult(void 0);let w=u.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),A=r(g.spec,u);w();let R=u.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),j=p(g.mockTemplates,u);if(R(),!A)return S(),u.toResult(void 0);let v=u.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),x=a(A,m,u);v();let k=u.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),M=i(x,u);if(k(),u.hasErrors)return S(),u.toResult(void 0);let T=u.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),b=o({merged:M,migrationFiles:g.migrations,adminMigrationFiles:g.adminMigrations,transformerFiles:g.transformers.map(e=>e.file.name),phxDefinitions:c,evalExpressionParser:d},u);return(T(),b)?(S(),u.toResult(e({rawProjectFiles:m,categorizedFiles:g,rawMockTemplates:j,applicationSpec:b}))):(S(),u.toResult(void 0))};
+import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{DiagnosticCode as t,diagnosticMessages as r}from"../errors/index.js";import{CategorizedFiles as i}from"./categorize/index.js";import{MergedSpec as a}from"./merge/index.js";import{RawSpecFiles as p}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as o}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as l}from"./resolve/index.js";import{ApplicationSpec as n}from"./spec/index.js";export const parseApplicationFiles=(m,c)=>{let{rawProjectFiles:d,phxDefinitions:f}=m,{evalExpressionParser:u,referenceStore:F,parsingContext:A}=c,g=A??new s,w=g.startSpan("parseApplicationFiles","build","parse-application-files.ts"),R=i(d,F,g,c);if(!R)return w(),g.toResult(void 0);let S=g.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),T=p(R.spec,g);S();let j=g.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),O=o(R.mockTemplates,g);if(j(),!T)return w(),g.toResult(void 0);let k=g.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),v=l(T,d,g);k();let x=g.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),H=a(v,g);if(x(),g.hasErrors)return w(),g.toResult(void 0);let E=g.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),M=n({merged:H,migrationFiles:R.migrations,adminMigrationFiles:R.adminMigrations,transformerFiles:R.transformers.map(e=>e.file.name),phxDefinitions:f,evalExpressionParser:u},g);return(E(),M)?(!R.hasWebhookEntry&&(M.appMetadata.useAuthHook||M.appMetadata.useClerk)&&g.warning(t.AUTH_WITHOUT_PROJECT_WEBHOOK,r.AUTH_WITHOUT_PROJECT_WEBHOOK()),w(),g.toResult(e({rawProjectFiles:d,categorizedFiles:R,rawMockTemplates:O,applicationSpec:M}))):(w(),g.toResult(void 0))};

package/dist/application-spec/parse-application-files/raw-spec/parse-yaml-spec-file.js

@@ -1 +1 @@
-import{parse as r}from"yaml";import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as t,diagnosticMessages as n}from"../../errors/index.js";export const parseYamlSpecFile=(o,a)=>{try{let i=r(o.file.content,{merge:!0});if(null===i)return a.warning(t.EMPTY_SPEC_FILE,n.EMPTY_SPEC_FILE()),e({name:o.file.name,content:{}});if("object"!=typeof i||Array.isArray(i))return void a.error(t.YAML_PARSE_ERROR,n.YAML_PARSE_ERROR("File did not parse to an object"));return e({name:o.file.name,content:i})}catch(r){a.error(t.YAML_PARSE_ERROR,n.YAML_PARSE_ERROR(r instanceof Error?r.message:String(r)));return}};
+import{parse as r}from"yaml";import{Branded as e}from"@salsita-ai/common/utils";import{DiagnosticCode as t,diagnosticMessages as n}from"../../errors/index.js";let o=(r,e,i)=>{if("number"==typeof r)return!Number.isFinite(r)&&(i.at(...e).error(t.NON_FINITE_NUMBER,n.NON_FINITE_NUMBER(e.join("."),String(r))),!0);if("object"!=typeof r||null===r)return!1;let a=!1;for(let[t,n]of Object.entries(r))a=o(n,[...e,t],i)||a;return a};export const parseYamlSpecFile=(i,a)=>{try{let E=r(i.file.content,{merge:!0});if(null===E)return a.warning(t.EMPTY_SPEC_FILE,n.EMPTY_SPEC_FILE()),e({name:i.file.name,content:{}});if("object"!=typeof E||Array.isArray(E))return void a.error(t.YAML_PARSE_ERROR,n.YAML_PARSE_ERROR("File did not parse to an object"));if(o(E,[],a))return;return e({name:i.file.name,content:E})}catch(r){a.error(t.YAML_PARSE_ERROR,n.YAML_PARSE_ERROR(r instanceof Error?r.message:String(r)));return}};

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-export declare const aclRoles: readonly ['anonymous', 'user', 'admin', 'superadmin'];
-export type AclRole = (typeof aclRoles)[number];
+import { type AclRole } from '#package/domain';
+export { type AclRole, aclRoles } from '#package/domain';
 export type RawAcl = {
     readonly canCreate?: readonly AclRole[];
 };

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.js

@@ -1 +1 @@
-import{z as o}from"zod";export const aclRoles=["anonymous","user","admin","superadmin"];export const rawAclSchema=o.object({canCreate:o.array(o.enum(aclRoles)).optional()});
+import{z as o}from"zod";import{aclRoles as a}from"#package/domain";export{aclRoles}from"#package/domain";export const rawAclSchema=o.object({canCreate:o.array(o.enum(a)).optional()});

package/dist/application-spec/parse-application-files/raw-spec/raw-admin-pages.d.ts

@@ -1,26 +1,5 @@
 import { z } from 'zod';
-export interface RawAdminPages {
-    readonly presets?: boolean | {
-        readonly categoryNavigationState?: string;
-        readonly presetNavigationState?: string;
-    };
-    readonly recipes?: ReadonlyArray<{
-        readonly name: string;
-        readonly navigationState?: string;
-    }>;
-    readonly pages?: ReadonlyArray<{
-        readonly key: string;
-        readonly title: string;
-        readonly icon?: string;
-        readonly navigationState?: string;
-        readonly entity?: string;
-        readonly component?: string;
-        readonly actionsComponent?: string;
-        readonly connectedDataEntry?: string;
-        readonly sidebar?: {
-            readonly title: string;
-            readonly component: string;
-        };
-    }>;
-}
+import type { AdminPagesSection } from '#package/domain';
+/** The `$adminPages` section of an admin spec file as written; see {@link AdminPagesSection} in `domain`. */
+export type RawAdminPages = AdminPagesSection;
 export declare const rawAdminPagesSchema: z.ZodType<RawAdminPages, z.ZodTypeDef, unknown>;