@salsita-ai/sdk 0.50.0-develop.bc4bdb2ffc → 0.50.0-develop.bc7f924bd6

package/README.md

@@ -4,7 +4,7 @@ TypeScript SDK and `phoenix` command line for building 3D product configurators
 
 ## Installation
 
-The package is public on npm. Start a new project with the CLI, which writes a `package.json` and a starter spec:
+The package is public on npm and needs Node.js 22.13 or newer (`engines.node`). The `phoenix` binary checks the running Node.js version first and stops with a message naming the required range; the legacy binaries rely on package managers checking `engines.node` on install. A project installs with any package manager; the commands below use pnpm, and with npm they are `npm install` and `npx phoenix …`. Phoenix writes no package-manager settings: a project on pnpm 11 adds a `pnpm-workspace.yaml` that allows the build scripts of `@swc/core` and `esbuild` and denies the one of `es5-ext` (see Project Structure in the Storybook docs). Start a new project with the CLI, which writes a starter spec and a `package.json` with the SDK, the packages the SDK requires as peers, ESLint and Prettier:
 
 ```sh
 npx -p @salsita-ai/sdk phoenix init my-configurator
@@ -17,13 +17,17 @@ pnpm phoenix dev
 
 `@salsita-ai/sdk` is the only Salsita package a project declares. The shared utilities and contracts it builds on are its own dependencies and are imported through it, as `@salsita-ai/sdk/common/*` and `@salsita-ai/sdk/contracts/*`.
 
-To add the SDK to an existing project, install it and let `phoenix sync` align the rest of the dependency set:
+To add the SDK to an existing project, install it, let `phoenix deps` add the packages it requires as peers, and install again before the first sync. With pnpm (with npm: `npm install @salsita-ai/sdk`, `npx phoenix deps`, `npm install`, `npx phoenix sync`):
 
 ```sh
 pnpm add @salsita-ai/sdk
+pnpm phoenix deps
+pnpm install
 pnpm phoenix sync
 ```
 
+Run `phoenix deps` and install after every SDK update too. The project's `package.json` is its own: `phoenix sync`, `dev` and `build` never write it, and they stop with a list of the peers it does not declare at a version the SDK supports.
+
 ## Project layout
 
 ```text
@@ -42,17 +46,18 @@ Generated code exposes the `phx` global in project files: `phx.domain` for the m
 
 Run the CLI through the project's package manager so its version matches the installed SDK.
 
-| Command                        | What it does                                                                                                      |
-| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
-| `phoenix init [folder]`        | Starts a project: `package.json` when missing, and a starter spec.                                                |
-| `phoenix sync`                 | Regenerates project files and aligns dependencies and scripts.                                                    |
-| `phoenix dev`                  | Development server with hot reload, webhook tunnel and the editor.                                                |
-| `phoenix build`                | Production build of the frontend and the webhooks.                                                                |
-| `phoenix check` / `fix`        | Type check, lint and format; `fix` applies the automatic fixes.                                                   |
-| `phoenix login <workspace>`    | Signs in through Studio; the token is kept in `~/.phoenix/credentials.json`.                                      |
-| `phoenix deploy`               | Uploads the project sources for a platform build.                                                                 |
-| `phoenix docs`                 | Searches and reads the SDK documentation bundled with the package.                                                |
-| `phoenix feedback "<message>"` | Sends feedback about the SDK, CLI, documentation or Studio to Salsita; `--file <path>` sends a text file instead. |
+| Command                        | What it does                                                                                                         |
+| ------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `phoenix init [folder]`        | Starts a project: a starter spec and the `package.json` entries it lacks (SDK, peers, ESLint, Prettier, scripts).    |
+| `phoenix sync`                 | Regenerates project files; stops when `package.json` does not declare the SDK's peers.                               |
+| `phoenix deps`                 | Adds the SDK's missing peer dependencies to `package.json` and moves out-of-range ones into range; installs nothing. |
+| `phoenix dev`                  | Development server with hot reload, webhook tunnel and the editor.                                                   |
+| `phoenix build`                | Production build of the frontend and the webhooks.                                                                   |
+| `phoenix check` / `fix`        | Type check, lint and format; `fix` applies the automatic fixes.                                                      |
+| `phoenix login <workspace>`    | Signs in through Studio; the token is kept in `~/.phoenix/credentials.json`.                                         |
+| `phoenix deploy`               | Uploads the project sources for a platform build.                                                                    |
+| `phoenix docs`                 | Searches and reads the SDK documentation bundled with the package.                                                   |
+| `phoenix feedback "<message>"` | Sends feedback about the SDK, CLI, documentation or Studio to Salsita; `--file <path>` sends a text file instead.    |
 
 Every frontend `.js` file `phoenix build` emits starts with a comment naming the application version from `spec/application.yaml`, the git commit when the build runs in a checkout, and the SDK version. `--banner <text>` replaces the application line with your own text. The line is public in every bundle:
 
@@ -88,7 +93,7 @@ import { getPhoenixThemes } from '@salsita-ai/sdk/ui'
 | `webhook`          | Webhook builders, finalization task factories, templates, and backend handlers.           |
 | `application-spec` | Application-spec parsing, validation, code generation, and runtime generation.            |
 | `i18n`             | SDK catalogs, locale fallback, and catalog-merging utilities.                             |
-| `globals`          | Global runtime and asset-module TypeScript declarations.                                  |
+| `globals`          | Global runtime and asset-module TypeScript declarations, including Vite's client types.   |
 | `watch`            | File watching and glob matching used by the toolchain.                                    |
 | `common/*`         | `utils`, `env`, `eslint` and `prettier` from `@salsita-ai/common`.                        |
 | `contracts/*`      | `api`, `clerk`, `domain`, `chat`, `assistant` and `webhook` from `@salsita-ai/contracts`. |
@@ -98,7 +103,7 @@ The `package.json` `exports` map is the machine-readable list, and the TypeScrip
 ## Documentation and support
 
 - `pnpm phoenix docs -s "<topic>"` searches the bundled documentation; `phoenix docs -r <path>` reads a page.
-- `phoenix sync` generates agent skills into `.claude/skills/` and `.agents/skills/`, so coding agents know the project conventions and the CLI.
+- `phoenix sync` generates one `phoenix` skill under `.claude/skills/` and `.agents/skills/`, with task-specific project, CLI, workflow, review, variants and feedback guides linked from its entry point.
 - The builder docs at [docs.salsita.ai](https://docs.salsita.ai) have the guides for getting started and the CLI reference; Studio is where you sign in and manage projects.
 - `pnpm phoenix feedback "<message>"` reaches the team directly.
 

package/dist/admin/default-admin-elements.d.ts

@@ -0,0 +1,9 @@
+import { type ElementRegistration } from '#package/domain';
+/**
+ * The admin's default element registrations, passed to `withDefaultElements`: the configurator's
+ * defaults, because the admin mounts a full configurator, followed by the admin's built-in pages,
+ * sidebars and actions under the spec kinds that YAML names. `withDefaultElements` replaces the
+ * defaults it was given before, so an admin config passes this list instead of
+ * `defaultConfiguratorElements`. A project element registered under the same name replaces one.
+ */
+export declare const defaultAdminElements: readonly ElementRegistration[];

package/dist/admin/default-admin-elements.js

@@ -0,0 +1 @@
+import{defaultConfiguratorElements as e}from"#package/configurator";import{adminConnectedResourcePageSchema as m,adminDataTableActionsSchema as o,adminDataTablePageSchema as i,adminDataTableSidebarSchema as t,adminPresetActionsSchema as n,adminPresetCategoryActionsSchema as r,adminPresetCategoryPageSchema as a,adminPresetCategorySidebarSchema as p,adminPresetListPageSchema as d,adminPresetSidebarSchema as f,adminRecipeActionsSchema as s,adminRecipeCollectionPageSchema as l,adminRecipeSidebarSchema as c}from"#package/domain";import{builtInEntityElement as u,builtInLayoutElement as x}from"./default-elements/index.js";import{AdminConnectedResourcePage as g,AdminDataTableActions as j,AdminDataTablePage as k,AdminDataTableSidebar as h,AdminPresetActions as A,AdminPresetCategoryActions as E,AdminPresetCategoryPage as b,AdminPresetCategorySidebar as q,AdminPresetListPage as v,AdminPresetSidebar as w,AdminRecipeActions as y,AdminRecipeCollectionPage as z,AdminRecipeSidebar as B}from"./ui/phoenix-admin-elements/index.js";export const defaultAdminElements=[...e,x(m,g),x(o,j),x(i,k),u(t,h),x(n,A),x(r,E),x(a,b),u(p,q),x(d,v),u(f,w),x(s,y),x(l,z),u(c,B)];

package/dist/admin/default-elements/built-in-entity-element.d.ts

@@ -0,0 +1,10 @@
+import { type PhoenixEntityElementDefinition, type PhoenixEntityElementRegistration } from '#package/domain';
+/**
+ * Registers a built-in entity element under the `kind` of its schema, with the component that the
+ * element's module exports. The schema type argument ties the schema and the
+ * component's props together, as in `createPhoenixEntityElement`.
+ */
+export declare const builtInEntityElement: <SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+} = never>(schema: PhoenixEntityElementDefinition<SCHEMA>['schema'], component: PhoenixEntityElementDefinition<SCHEMA>['component']) => PhoenixEntityElementRegistration;

package/dist/admin/default-elements/built-in-entity-element.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as t}from"#package/domain";export const builtInEntityElement=(e,n)=>t(e.properties.kind.enum[0],n);

package/dist/admin/default-elements/built-in-layout-element.d.ts

@@ -0,0 +1,10 @@
+import { type PhoenixLayoutElementDefinition, type PhoenixLayoutElementRegistration } from '#package/domain';
+/**
+ * Registers a built-in layout element under the `kind` of its schema, with the component that the
+ * element's module exports. The schema type argument ties the schema and the
+ * component's props together, as in `createPhoenixLayoutElement`.
+ */
+export declare const builtInLayoutElement: <SCHEMA extends {
+    kind: string;
+    props?: Record<string, unknown>;
+} = never>(schema: PhoenixLayoutElementDefinition<SCHEMA>['schema'], component: PhoenixLayoutElementDefinition<SCHEMA>['component']) => PhoenixLayoutElementRegistration;

package/dist/admin/default-elements/built-in-layout-element.js

@@ -0,0 +1 @@
+import{createCustomPhoenixLayoutElement as e}from"#package/domain";export const builtInLayoutElement=(o,t)=>e(o.properties.kind.enum[0],t);

package/dist/admin/default-elements/index.d.ts

@@ -0,0 +1,2 @@
+export { builtInEntityElement } from './built-in-entity-element.js';
+export { builtInLayoutElement } from './built-in-layout-element.js';

package/dist/admin/default-elements/index.js

@@ -0,0 +1 @@
+export{builtInEntityElement}from"./built-in-entity-element.js";export{builtInLayoutElement}from"./built-in-layout-element.js";

package/dist/admin/index.d.ts

@@ -3,6 +3,7 @@ export { StandaloneAdmin } from './StandaloneAdmin.js';
 export { createAdminPages, type AdminPagesConfig } from './create-admin-pages.js';
 export { createAdminPagesFromSpec } from './create-admin-pages-from-spec.js';
 export { createAdminInterface } from './common/admin-interface.js';
+export { defaultAdminElements } from './default-admin-elements.js';
 export { ConnectedResourcePage } from './pages/connected/ConnectedResourcePage.js';
 export { ConnectedDataValidationDialog } from './pages/connected/ConnectedDataValidationDialog.js';
 export { type ConnectedDataValidationIssue } from './common/use-connected-data-validation.js';

package/dist/admin/index.js

@@ -1 +1 @@
-export{EmbeddedAdmin}from"./EmbeddedAdmin.js";export{StandaloneAdmin}from"./StandaloneAdmin.js";export{createAdminPages}from"./create-admin-pages.js";export{createAdminPagesFromSpec}from"./create-admin-pages-from-spec.js";export{createAdminInterface}from"./common/admin-interface.js";export{ConnectedResourcePage}from"./pages/connected/ConnectedResourcePage.js";export{ConnectedDataValidationDialog}from"./pages/connected/ConnectedDataValidationDialog.js";export{DataTablePage}from"./pages/data-table/DataTablePage.js";export{EntityRow}from"./ui/list/EntityRow.js";export{AdminLayout}from"./ui/layout/AdminLayout.js";export{EditEntityMenuItem}from"./ui/menu/EditEntityMenuItem.js";export{DeleteEntityMenuItem}from"./ui/menu/DeleteEntityMenuItem.js";export{ShowEntityMenuItem}from"./ui/menu/ShowEntityMenuItem.js";export{Application}from"./legacy-admin/Application.js";export{useLegacyAdminRouting}from"./legacy-admin/LegacyAdminRoutingProvider.js";export{LegacyAdminLayout}from"./legacy-admin/LegacyAdminLayout.js";export*from"./ui/phoenix-admin-elements/index.js";export*from"./integration/index.js";export*from"./EncapsulatedAdminTheme.js";
+export{EmbeddedAdmin}from"./EmbeddedAdmin.js";export{StandaloneAdmin}from"./StandaloneAdmin.js";export{createAdminPages}from"./create-admin-pages.js";export{createAdminPagesFromSpec}from"./create-admin-pages-from-spec.js";export{createAdminInterface}from"./common/admin-interface.js";export{defaultAdminElements}from"./default-admin-elements.js";export{ConnectedResourcePage}from"./pages/connected/ConnectedResourcePage.js";export{ConnectedDataValidationDialog}from"./pages/connected/ConnectedDataValidationDialog.js";export{DataTablePage}from"./pages/data-table/DataTablePage.js";export{EntityRow}from"./ui/list/EntityRow.js";export{AdminLayout}from"./ui/layout/AdminLayout.js";export{EditEntityMenuItem}from"./ui/menu/EditEntityMenuItem.js";export{DeleteEntityMenuItem}from"./ui/menu/DeleteEntityMenuItem.js";export{ShowEntityMenuItem}from"./ui/menu/ShowEntityMenuItem.js";export{Application}from"./legacy-admin/Application.js";export{useLegacyAdminRouting}from"./legacy-admin/LegacyAdminRoutingProvider.js";export{LegacyAdminLayout}from"./legacy-admin/LegacyAdminLayout.js";export*from"./ui/phoenix-admin-elements/index.js";export*from"./integration/index.js";export*from"./EncapsulatedAdminTheme.js";

package/dist/application/index.d.ts

@@ -1,3 +1,4 @@
 export { mountApplication, 
 /** @deprecated Use embedded admin in Editor instead */
 mountStandaloneAdminApplication, mountConfiguratorApplication, mountEmbeddedAdminApplication, mountEmbeddedConfiguratorApplication, embeddedModuleSchema, } from './mount-application.js';
+export { mountConfigurator } from './mount-configurator.js';

package/dist/application/index.js

@@ -1 +1 @@
-export{mountApplication,mountStandaloneAdminApplication,mountConfiguratorApplication,mountEmbeddedAdminApplication,mountEmbeddedConfiguratorApplication,embeddedModuleSchema}from"./mount-application.js";
+export{mountApplication,mountStandaloneAdminApplication,mountConfiguratorApplication,mountEmbeddedAdminApplication,mountEmbeddedConfiguratorApplication,embeddedModuleSchema}from"./mount-application.js";export{mountConfigurator}from"./mount-configurator.js";

package/dist/application/mount-application.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { $DomainEntity, ApplicationConfig, DomainEntity } from '#package/domain';
+import { type $DomainEntity, type ApplicationConfig, type DomainEntity } from '#package/domain';
 export declare const embeddedModuleSchema: z.ZodObject<{
     default: z.ZodObject<{
         mount: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodString>;

package/dist/application/mount-application.js

@@ -1 +1 @@
-import{jsx as o}from"react/jsx-runtime";import{z as t}from"zod";import{Application as n,EmbeddedAdmin as e,StandaloneAdmin as i}from"#package/admin";import{ConfiguratorApp as p,createConfiguratorExtensions as a}from"#package/configurator";import{createApplicationRuntime as m,createWebComponent as r}from"#package/react-sdk";export const embeddedModuleSchema=t.object({default:t.object({mount:t.function().returns(t.string()),config:t.unknown()})});let c=(o,t)=>{customElements.get(o)?console.error(`Web component with tag name "${o}" is already registered.`):customElements.define(o,t)};export const mountApplication=t=>{let e=t.mount.Application?t.mount.Application(t):()=>o(n,{});c(t.mount.tag,r({RootComponent:e,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountConfiguratorApplication=t=>{let n=t.mount.Application?t.mount.Application(t):()=>o(p,{});c(t.mount.tag,r({RootComponent:n,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountStandaloneAdminApplication=t=>{c("salsita-admin",r({RootComponent:()=>o(i,{}),webComponentOptions:{},embeddedIntegration:!1,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountEmbeddedAdminApplication=(t,n,i)=>{c(`salsita-admin-${n}-${i}`,r({RootComponent:()=>o(e,{}),webComponentOptions:{},embeddedIntegration:!0,applicationRuntimeFactory:o=>m(t,o,a)}))};export const mountEmbeddedConfiguratorApplication=(t,n,e)=>{c(`salsita-configurator-${n}-${e}`,r({RootComponent:t.mount.Application?t.mount.Application(t):()=>o(p,{}),webComponentOptions:t.mount.options,embeddedIntegration:!0,applicationRuntimeFactory:o=>m(t,o,a)}))};
+import{jsx as o}from"react/jsx-runtime";import{z as t}from"zod";import{Application as n,EmbeddedAdmin as i,StandaloneAdmin as e}from"#package/admin";import{ConfiguratorApp as p}from"#package/configurator";import{applicationFromConfig as m}from"#package/domain";import{createWebComponent as a}from"#package/react-sdk";import{createMountedApplicationRuntime as r}from"./mounted-application-runtime.js";import{registerWebComponent as c}from"./register-web-component.js";export const embeddedModuleSchema=t.object({default:t.object({mount:t.function().returns(t.string()),config:t.unknown()})});export const mountApplication=t=>{let i=t.mount.Application?t.mount.Application(t):()=>o(n,{});c(t.mount.tag,a({RootComponent:i,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountConfiguratorApplication=t=>{let n=t.mount.Application?t.mount.Application(t):()=>o(p,{});c(t.mount.tag,a({RootComponent:n,webComponentOptions:t.mount.options,embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountStandaloneAdminApplication=t=>{c("salsita-admin",a({RootComponent:()=>o(e,{}),webComponentOptions:{},embeddedIntegration:!1,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountEmbeddedAdminApplication=(t,n,e)=>{c(`salsita-admin-${n}-${e}`,a({RootComponent:()=>o(i,{}),webComponentOptions:{},embeddedIntegration:!0,applicationRuntimeFactory:o=>r(m(t),o)}))};export const mountEmbeddedConfiguratorApplication=(t,n,i)=>{c(`salsita-configurator-${n}-${i}`,a({RootComponent:t.mount.Application?t.mount.Application(t):()=>o(p,{}),webComponentOptions:t.mount.options,embeddedIntegration:!0,applicationRuntimeFactory:o=>r(m(t),o)}))};

package/dist/application/mount-configurator.d.ts

@@ -0,0 +1,19 @@
+import { type Application } from '#package/domain';
+/**
+ * Declares the web component of a configurator application built from its runtime spec
+ * (`createApplication` of `@salsita-ai/sdk/application-spec`), with no `ApplicationConfig`.
+ *
+ * It registers `application.tag`; every `<tag></tag>` element in the DOM renders the configurator
+ * in a closed shadow DOM. The web component's properties and events and the wrapper of the
+ * application come from the project's `GetWebComponentOptions` and `GetApplicationWrapper` handlers.
+ * With `embedded`, the configurator integrates with the page that embeds it, as
+ * `mountEmbeddedConfiguratorApplication` does; the embedding host looks for the tag
+ * `salsita-configurator-<project slug>-<environment slug>`, which the caller passes to
+ * `createApplication` as `tag`.
+ *
+ * It runs the same runtime as `mountConfiguratorApplication`, which converts its config to an
+ * application first.
+ */
+export declare const mountConfigurator: <TYPES>(application: Application<TYPES>, options?: {
+    readonly embedded?: boolean;
+}) => void;

package/dist/application/mount-configurator.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{ConfiguratorApp as r}from"#package/configurator";import{isGetApplicationWrapperHandler as t,isGetWebComponentOptionsHandler as e}from"#package/domain";import{createWebComponent as n}from"#package/react-sdk";import{createMountedApplicationRuntime as a}from"./mounted-application-runtime.js";import{registerWebComponent as i}from"./register-web-component.js";export const mountConfigurator=(m,p={})=>{let{handlers:d}=m.spec.configurator,c=d.find(t)?.handler().handler,f=d.find(e)?.handler().handler(void 0),s=c?c(m):()=>o(r,{});i(m.tag,n({RootComponent:s,webComponentOptions:f??{},embeddedIntegration:p.embedded??!1,applicationRuntimeFactory:o=>a(m,o)}))};

package/dist/application/mounted-application-runtime.d.ts

@@ -0,0 +1,4 @@
+import { type AnyConfiguratorExtensionSystems } from '#package/configurator';
+import type { Application } from '#package/domain';
+import { type ApplicationRuntime, type ApplicationRuntimeBootConfig } from '#package/react-sdk';
+export declare const createMountedApplicationRuntime: (application: Application, bootConfig: ApplicationRuntimeBootConfig) => ApplicationRuntime<AnyConfiguratorExtensionSystems>;

package/dist/application/mounted-application-runtime.js

@@ -0,0 +1 @@
+import{createConfiguratorExtensions as o}from"#package/configurator";import{createApplicationRuntime as t}from"#package/react-sdk";export const createMountedApplicationRuntime=(r,a)=>t(r,a,o);

package/dist/application/register-web-component.d.ts

@@ -0,0 +1,2 @@
+/** Defines the custom element of a mounted application, unless its tag is taken. */
+export declare const registerWebComponent: (tag: string, element: CustomElementConstructor) => void;

package/dist/application/register-web-component.js

@@ -0,0 +1 @@
+export const registerWebComponent=(e,t)=>{customElements.get(e)?console.error(`Web component with tag name "${e}" is already registered.`):customElements.define(e,t)};

package/dist/application-spec/caching/content-diff.js

@@ -1 +1 @@
-import e from"spark-md5";import{GeneratedApplicationFile as t}from"../core/index.js";let r=t=>e.hash(t);export const createContentDiffTracker=e=>{let n=new Map,i=(t,i)=>{let o=[],a=i?.mode??"content";for(let s of t){let t=r(s.content),f=n.get(s.path);if(i?.force&&"content"===a){o.push(s),n.set(s.path,t);continue}if(void 0===f&&e?.readDiskContent){let t=e.readDiskContent(s.path);void 0!==t&&(f=r(t))}if(void 0===f){o.push(s),n.set(s.path,t);continue}"content"===a&&t!==f&&o.push(s),n.set(s.path,t)}return o};return{getChangedFiles:i,getChangedApplicationFiles:(e,r)=>{let n=i(e.files.map(e=>{let n,i;return n=r.generatedFilesPathPrefix,i={format:!1},t(`${n}${e.path}`,e.content,{binary:e.binary,format:i?.format??e.format})}),{force:r.force}),o=new Set(n.map(e=>e.path));return{changedGeneratedFiles:e.files.filter(e=>o.has(`${r.generatedFilesPathPrefix}${e.path}`)),filesToWrite:[...n,...i([...e.generatedProjectFiles,...e.prettierFiles],{force:r.force}),...i(e.initialProjectFiles,{mode:"missing"})]}}}};
+import e from"spark-md5";import{GeneratedApplicationFile as t}from"../core/index.js";let r=t=>e.hash(t);export const createContentDiffTracker=e=>{let n=new Map,o=(t,o)=>{let i=[],a=o?.mode??"content";for(let f of t){let t=r(f.content),s=n.get(f.path);if(o?.force&&"content"===a){i.push(f),n.set(f.path,t);continue}if(void 0===s&&e?.readDiskContent){let t=e.readDiskContent(f.path);void 0!==t&&(s=r(t))}if(void 0===s){i.push(f),n.set(f.path,t);continue}"content"===a&&t!==s&&i.push(f),n.set(f.path,t)}return i};return{getChangedFiles:o,getChangedApplicationFiles:(e,r)=>{let n=o(e.files.map(e=>{let n,o;return n=r.generatedFilesPathPrefix,o={format:!1},t(`${n}${e.path}`,e.content,{binary:e.binary,format:o?.format??e.format})}),{force:r.force}),i=new Set(n.map(e=>e.path));return{changedGeneratedFiles:e.files.filter(e=>i.has(`${r.generatedFilesPathPrefix}${e.path}`)),filesToWrite:[...n,...o(e.generatedProjectFiles,{force:r.force}),...o(e.initialProjectFiles,{mode:"missing"})]}}}};

package/dist/application-spec/core/application-file.d.ts

@@ -39,14 +39,12 @@ export type GeneratedApplication = Branded<'GeneratedApplication', {
     readonly files: readonly GeneratedApplicationFile[];
     readonly generatedProjectFiles: readonly GeneratedApplicationFile[];
     readonly initialProjectFiles: readonly GeneratedApplicationFile[];
-    readonly prettierFiles: readonly GeneratedApplicationFile[];
     readonly removedProjectFiles: readonly string[];
 }>;
 interface GeneratedApplicationProps {
     readonly files: readonly GeneratedApplicationFile[];
     readonly generatedProjectFiles: readonly GeneratedApplicationFile[];
     readonly initialProjectFiles: readonly GeneratedApplicationFile[];
-    readonly prettierFiles: readonly GeneratedApplicationFile[];
     readonly removedProjectFiles: readonly string[];
 }
 /**

package/dist/application-spec/core/application-file.js

@@ -1 +1 @@
-import{Branded as e}from"@salsita-ai/common/utils";export const GeneratedApplicationFile=(i,t,r)=>e({path:i,content:t,...r?.binary!==void 0?{binary:r.binary}:{},...r?.format!==void 0?{format:r.format}:{}});export const GeneratedApplication=i=>e({files:i.files,generatedProjectFiles:i.generatedProjectFiles,initialProjectFiles:i.initialProjectFiles,prettierFiles:i.prettierFiles,removedProjectFiles:i.removedProjectFiles});
+import{Branded as e}from"@salsita-ai/common/utils";export const GeneratedApplicationFile=(i,t,o)=>e({path:i,content:t,...o?.binary!==void 0?{binary:o.binary}:{},...o?.format!==void 0?{format:o.format}:{}});export const GeneratedApplication=i=>e({files:i.files,generatedProjectFiles:i.generatedProjectFiles,initialProjectFiles:i.initialProjectFiles,removedProjectFiles:i.removedProjectFiles});

package/dist/application-spec/core/enhanced-json-value.d.ts

@@ -1,29 +1,6 @@
 import { z } from 'zod';
-import { type EnhancedJsonSchemaType } from './enhanced-json-schema.js';
-import type { EvalExpressionParser } from './eval-expression-parser.js';
-import { type EvalMarker } from './markers/eval-marker.js';
-import { type MsgMarker } from './markers/msg-marker.js';
-import type { ParseContext } from './spec-diagnostic.js';
-/**
- * A JSON-serialisable value augmented with Phoenix structural markers:
- * `$msg` (i18n) and `$eval` (self-scoped code).
- *
- * Single shared shape across components, expressions, and defaults — lowered
- * either to TypeScript source via {@link stringifyEnhancedJsonValue} or to a
- * runtime value via {@link resolveEnhancedJsonValue}.
- *
- * Which markers are allowed at a given slot is controlled by
- * {@link EnhancedJsonValueCaps}, not by the type — all markers parse
- * identically, capability checks kick in at lowering time.
- */
-export type EnhancedJsonValue = string | number | boolean | null | MsgMarker | EvalMarker | EnhancedJsonArray | EnhancedJsonObject;
-/** Array form of {@link EnhancedJsonValue} — extracted as a named interface so `z.lazy` can close the recursion. */
-export interface EnhancedJsonArray extends ReadonlyArray<EnhancedJsonValue> {
-}
-/** Object form of {@link EnhancedJsonValue} — extracted for the same reason as {@link EnhancedJsonArray}. */
-export interface EnhancedJsonObject {
-    readonly [key: string]: EnhancedJsonValue;
-}
+import { type EnhancedJsonObject, type EnhancedJsonValue } from '#package/domain';
+export { type EnhancedJsonArray, type EnhancedJsonObject, type EnhancedJsonValue, type SelfAccessor, canonicalEnhancedJsonValueKey, } from '#package/domain';
 /** Historical component-value shape used by domain-spec to import a project module member. */
 export interface ImportRefShape {
     readonly $importRef: {
@@ -66,83 +43,9 @@ export declare const CONSTANT_CAPS: EnhancedJsonValueCaps;
 export interface ImportSink {
     addImport(module: string, member: string): void;
 }
-/** Runtime `self` accessor — shape-agnostic entity state. */
-export type SelfAccessor = object;
 /**
  * Type guard that narrows an {@link EnhancedJsonValue} to the generic
  * {@link EnhancedJsonObject} branch — excludes primitives, arrays, and the
  * known structural markers (`$eval`, `$msg`).
  */
 export declare const isEnhancedJsonObject: (value: EnhancedJsonValue) => value is EnhancedJsonObject;
-/**
- * Deterministic string key for a value — sorted object keys, JSON-encoded.
- * Used by the expression runtime's reference store to preserve an evaluator when the
- * underlying value is structurally unchanged (mirrors the content-hash pattern
- * used for components).
- */
-export declare const canonicalEnhancedJsonValueKey: (value: EnhancedJsonValue) => string;
-/**
- * Lowers an {@link EnhancedJsonValue} to its runtime form.
- *
- * - `$msg` → `{ id?, message }` i18n descriptor
- * - `$eval` → `new Function('self', 'return (…)')` invoked with `self`
- *
- * Validates caps up front via {@link validateEnhancedJsonValueCaps}; any
- * disallowed marker produces a parse diagnostic via `ctx.error(...)` and
- * causes this function to return `undefined`. Non-marker values recurse
- * (arrays, objects) or pass through (primitives).
- *
- * Note: a successful resolution may also return `undefined` legitimately
- * (e.g. `$eval: 'self.missing'` evaluates to `undefined`). Callers that need
- * to distinguish "capability violation" from "value is undefined" should
- * check `ctx.hasErrors` after the call.
- */
-export declare const resolveEnhancedJsonValue: (value: EnhancedJsonValue, self: SelfAccessor | undefined, caps: EnhancedJsonValueCaps, ctx: ParseContext) => unknown | undefined;
-/**
- * Serializes an {@link EnhancedJsonValue} to a TypeScript literal, lowering
- * markers:
- *
- * - `$msg` → `` msg`…` `` (or `msg({ id, message })` with `$msgId`); registers
- *   `msg` from `@lingui/core/macro` via the supplied {@link ImportSink}.
- * - `$eval` → the code verbatim. Callers are responsible for deciding whether
- *   the emitted code belongs in a self-scoped wrapper.
- *
- * Validates caps up front; on any violation, emits a parse diagnostic via
- * `ctx.error(...)` and returns `undefined`.
- */
-export declare const stringifyEnhancedJsonValue: (value: EnhancedJsonValue, imports: ImportSink, caps: EnhancedJsonValueCaps, ctx: ParseContext) => string | undefined;
-/**
- * Derives an `EnhancedJsonSchemaType` that describes the runtime shape of an
- * {@link EnhancedJsonValue}. Used by `UserExpressions()` to synthesise an
- * expression schema from a YAML value without leaking codegen-output paths
- * into the spec layer.
- *
- * Primitives become `{ type }`. Arrays become JSON-Schema tuples. Objects
- * become `{ type: 'object', properties, required, additionalProperties: false }`.
- *
- * Marker-aware branches:
- * - `$msg` (with or without `$msgId`) → `{ $ref: 'phx:MessageDescriptor' }`, a ref to the
- *   phoenix definition that codegen resolves to the `MessageDescriptor` type emitted via `msg\`…\``.
- * - `$eval` → when the code references `self`, returns `{}` (intentional
- *   "no static info" fallback — the value depends on runtime state).
- *   Otherwise the injected SWC parser and static folder infer literals,
- *   constant operators, and deterministic `Math` expressions without executing
- *   authored code. Anything else emits
- *   `ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE` and returns `undefined`.
- *
- * `$importRef` is intentionally unsupported at the value level; an object
- * with that shape serializes structurally.
- */
-export declare const schemaFromValue: (value: InferableValue, ctx: ParseContext, parseEvalExpression: EvalExpressionParser) => EnhancedJsonSchemaType | undefined;
-/**
- * Walks raw spec content and reports every legacy `$codeRef: { code: … }` block.
- *
- * That shape was documented as an inline static-math escape hatch but no parser stage ever
- * evaluated it: it validates as an ordinary nested object and serializes verbatim, so a spec using
- * it silently ships `{ "$codeRef": { "code": "4 * 25.4" } }` where the author expected a number.
- * `$eval` now covers the use case, so the shape is rejected outright rather than left inert.
- *
- * Only the object form is reported. `{ $codeRef: <string> }` is a live internal codegen shape for
- * SDK factory params (see `SdkCodeRef`), produced by the parser itself and never authored in YAML.
- */
-export declare const validateNoLegacyCodeRef: (value: unknown, ctx: ParseContext) => void;

package/dist/application-spec/core/enhanced-json-value.js

@@ -1 +1 @@
-import{z as e}from"zod";import{DiagnosticCode as r,diagnosticMessages as t}from"../errors/index.js";import{PHX_SHORT_PREFIX as o}from"./enhanced-json-schema.js";import{evalCodeUsesSelf as n}from"./eval-code-uses-self.js";import{evalToConstant as a}from"./eval-to-constant.js";import{evalMarkerSchema as i,isEvalMarker as l}from"./markers/eval-marker.js";import{createMessageDescriptor as s,isMsgMarker as f,msgMarkerSchema as c,stringifyMsgMacroCode as u}from"./markers/msg-marker.js";let E=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>E.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),c,i,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!f(e)&&!l(e);export const canonicalEnhancedJsonValueKey=e=>{let r=e=>{if(null===e||"object"!=typeof e)return e;if(Array.isArray(e))return e.map(r);let t={};for(let o of Object.keys(e).sort())t[o]=r(e[o]);return t};return JSON.stringify(r(e))};let _=(e,o,n)=>{if(f(e))return!!o.localizable||(n.error(r.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED,t[r.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED]()),!1);if(l(e))return!!o.selfScoped||(n.error(r.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED,t[r.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED]()),!1);if(null===e||"object"!=typeof e)return!0;if(Array.isArray(e)){let r=!0;for(let[t,a]of e.entries())_(a,o,n.at(String(t)))||(r=!1);return r}let a=!0;for(let[r,t]of Object.entries(e))_(t,o,n.at(r))||(a=!1);return a},p=(e,r)=>{if(null===e||"object"!=typeof e)return e;if(f(e))return s(e);if(l(e))return Function("self",`return (${e.$eval})`)(r??{});if(Array.isArray(e))return e.map(e=>p(e,r));let t={};for(let[o,n]of Object.entries(e))t[o]=p(n,r);return t};export const resolveEnhancedJsonValue=(e,r,t,o)=>{if(_(e,t,o))return p(e,r)};let m="__ENHANCED_JSON_VALUE_PLACEHOLDER__",A=RegExp(`"${m}(\\d+)"`,"g");export const stringifyEnhancedJsonValue=(e,r,t,o)=>{if(!_(e,t,o))return;let n=[],a=e=>(n.push(e),`${m}${n.length-1}`);return JSON.stringify(e,(e,t)=>f(t)?(r.addImport("@lingui/core/macro","msg"),a(u(t))):l(t)?a(t.$eval):t,2).replaceAll(A,(e,r)=>{let t=n[Number(r)];if(void 0===t)throw Error(`stringifyEnhancedJsonValue: missing replacement for placeholder index ${r}. This is a logic bug in the serialiser — replacements array shorter than referenced index.`);return t})};export const schemaFromValue=(e,i,s)=>{if(f(e))return{$ref:`${o}MessageDescriptor`};if(l(e)){if(n(e.$eval))return{};let o=a(e.$eval,s);return o.ok?schemaFromValue(o.value,i,s):void i.error(r.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE,t[r.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE](e.$eval))}if(null===e)return{type:"null"};if("string"==typeof e)return{type:"string"};if("number"==typeof e)return{type:"number"};if("boolean"==typeof e)return{type:"boolean"};if(Array.isArray(e)){let r=[];for(let[t,o]of e.entries()){let e=schemaFromValue(o,i.at(String(t)),s);if(void 0===e)return;r.push(e)}return{type:"array",items:r}}if("object"==typeof e){let r=Object.entries(e),t={};for(let[e,o]of r){let r=schemaFromValue(o,i.at(e),s);if(void 0===r)return;t[e]=r}return{type:"object",properties:t,required:r.map(([e])=>e),additionalProperties:!1}}return{}};export const validateNoLegacyCodeRef=(e,o)=>{if(null!==e&&"object"==typeof e){if(Array.isArray(e))return void e.forEach((e,r)=>validateNoLegacyCodeRef(e,o.at(String(r))));for(let[n,a]of Object.entries(e)){if("$codeRef"===n&&null!==a&&"object"==typeof a&&"code"in a){o.at(n).error(r.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED,t[r.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED]());continue}validateNoLegacyCodeRef(a,o.at(n))}}};
+import{z as e}from"zod";import{evalMarkerSchema as o,isEvalMarker as n,isMsgMarker as a,msgMarkerSchema as r}from"#package/domain";export{canonicalEnhancedJsonValueKey}from"#package/domain";let c=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>c.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),r,o,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!a(e)&&!n(e);

package/dist/application-spec/core/index.d.ts

@@ -1,6 +1,6 @@
+export { ApplicationInstance, FILTER_CRITERION_KEYS, type FilterCriterion, type RelationExpressionParams, type SdkCodeRef, type SdkExpressionImplementation, type SpecComponentFilter as ComponentFilter, isSdkCodeRef, isSdkExpressionImplementation, } from '#package/domain';
 export * from './application-file.js';
 export * from './specification-files.js';
-export * from './application-instance.js';
 export * from './spec-diagnostic.js';
 export * from './enhanced-json-schema.js';
 export * from './enhanced-json-value.js';

package/dist/application-spec/core/index.js

@@ -1 +1 @@
-export*from"./application-file.js";export*from"./specification-files.js";export*from"./application-instance.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";
+export{ApplicationInstance,FILTER_CRITERION_KEYS,isSdkCodeRef,isSdkExpressionImplementation}from"#package/domain";export*from"./application-file.js";export*from"./specification-files.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";

package/dist/application-spec/core/json-schema.d.ts

@@ -1,55 +1,5 @@
-import type { JsonSchemaType } from './enhanced-json-schema.js';
-/**
- * Plain AJV-ready JSON Schema — the output of {@link import('./enhanced-json-schema.js').toRuntimeSchema}.
- *
- * Identical in structure to `EnhancedJsonSchemaType` except the Phoenix-only
- * extensions (`tsType`, `import`, `references`) are gone; those are
- * stripped by `stripCustomKeywords` before this type is produced. All `$ref`
- * targets are local (`#/$defs/{name}`) — no external references remain. Shapes
- * stored under `$defs` are themselves `JsonSchema`s.
- *
- * Use this type anywhere the runtime AJV shape is required (validators,
- * serializers, migration tools). Schema producers (`Shapes`, `CommonTypes`,
- * relation inference) keep using `EnhancedJsonSchemaType`.
- */
-export interface JsonSchema {
-    readonly id?: string;
-    readonly $ref?: string;
-    readonly $schema?: string;
-    readonly $defs?: Readonly<Record<string, JsonSchema>>;
-    readonly title?: string;
-    readonly description?: string;
-    readonly default?: unknown;
-    readonly format?: string;
-    readonly multipleOf?: number;
-    readonly maximum?: number;
-    readonly exclusiveMaximum?: boolean;
-    readonly minimum?: number;
-    readonly exclusiveMinimum?: boolean;
-    readonly maxLength?: number;
-    readonly minLength?: number;
-    readonly pattern?: string;
-    readonly additionalItems?: boolean | JsonSchema;
-    readonly items?: JsonSchema | readonly JsonSchema[];
-    readonly maxItems?: number;
-    readonly minItems?: number;
-    readonly uniqueItems?: boolean;
-    readonly maxProperties?: number;
-    readonly minProperties?: number;
-    readonly required?: readonly string[];
-    readonly additionalProperties?: boolean | JsonSchema;
-    readonly definitions?: Readonly<Record<string, JsonSchema>>;
-    readonly properties?: Readonly<Record<string, JsonSchema>>;
-    readonly patternProperties?: Readonly<Record<string, JsonSchema>>;
-    readonly dependencies?: Readonly<Record<string, JsonSchema | readonly string[]>>;
-    readonly enum?: readonly unknown[];
-    readonly type?: JsonSchemaType | readonly JsonSchemaType[];
-    readonly allOf?: readonly JsonSchema[];
-    readonly anyOf?: readonly JsonSchema[];
-    readonly oneOf?: readonly JsonSchema[];
-    readonly not?: JsonSchema;
-    readonly [k: string]: unknown;
-}
+import type { JsonSchema } from '#package/domain';
+export type { JsonSchema } from '#package/domain';
 /**
  * Clones `schema` with top-level `required` cleared. Nested object schemas
  * keep their own `required` arrays — only the outer one is relaxed. Used by

package/dist/application-spec/core/json-value.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * A plain JSON-serialisable value — no Phoenix markers, no functions, no
  * symbols. Output shape of `$codeRef` evaluation and of
- * {@link ./enhanced-json-value.ts} `resolveEnhancedJsonValue`. Pure subset of
+ * {@link ../enhanced-json/resolve-enhanced-json-value.ts} `resolveEnhancedJsonValue`. Pure subset of
  * `EnhancedJsonValue`.
  */
 export type JsonValue = string | number | boolean | null | JsonArray | JsonObject;

package/dist/application-spec/core/markers/index.d.ts

@@ -1,4 +1,4 @@
-export * from './eval-marker.js';
+export { EVAL_MARKER_KEY, type EvalMarker, evalMarkerSchema, isEvalMarker } from '#package/domain';
 export * from './filter-keys.js';
 export * from './msg-marker.js';
 export * from './raw-bind-marker.js';

package/dist/application-spec/core/markers/index.js

@@ -1 +1 @@
-export*from"./eval-marker.js";export*from"./filter-keys.js";export*from"./msg-marker.js";export*from"./raw-bind-marker.js";export*from"./raw-data-ref-marker.js";export*from"./raw-eval-write-marker.js";export*from"./raw-read-marker.js";export*from"./raw-read-write-marker.js";export*from"./raw-write-marker.js";
+export{EVAL_MARKER_KEY,evalMarkerSchema,isEvalMarker}from"#package/domain";export*from"./filter-keys.js";export*from"./msg-marker.js";export*from"./raw-bind-marker.js";export*from"./raw-data-ref-marker.js";export*from"./raw-eval-write-marker.js";export*from"./raw-read-marker.js";export*from"./raw-read-write-marker.js";export*from"./raw-write-marker.js";

package/dist/application-spec/core/markers/msg-marker.d.ts

@@ -1,31 +1,5 @@
-import type { MessageDescriptor } from '@lingui/core';
-import { z } from 'zod';
-/** Key literal for the `$msg` marker in raw YAML. */
-export declare const MSG_MARKER_KEY: '$msg';
-/** Key literal for the optional `$msgId` qualifier on `$msg`. */
-export declare const MSG_ID_MARKER_KEY: '$msgId';
-/**
- * YAML marker produced by `$msg: 'text'` / `$msg: 'text', $msgId: 'id'` entries.
- * `$msgId` is a qualifier on `$msg`, not a standalone marker.
- */
-export interface MsgMarker {
-    readonly $msg: string;
-    readonly $msgId?: string;
-}
-/** Zod decoder for {@link MsgMarker}. Strict — rejects extra keys. */
-export declare const msgMarkerSchema: z.ZodObject<{
-    $msg: z.ZodString;
-    $msgId: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    $msg: string;
-    $msgId?: string | undefined;
-}, {
-    $msg: string;
-    $msgId?: string | undefined;
-}>;
-/** Structural type guard for {@link MsgMarker}. */
-export declare const isMsgMarker: (value: unknown) => value is MsgMarker;
-export declare const createMessageDescriptor: (marker: MsgMarker) => MessageDescriptor;
+import type { MsgMarker } from '#package/domain';
+export { MSG_ID_MARKER_KEY, MSG_MARKER_KEY, type MsgMarker, createMessageDescriptor, isMsgMarker, msgMarkerSchema, } from '#package/domain';
 /**
  * Serializes a {@link MsgMarker} to lingui macro source — `` msg`…` `` or
  * `msg({ id, message })` with `$msgId` — escaping template-literal syntax in

package/dist/application-spec/core/markers/msg-marker.js

@@ -1 +1 @@
-import{generateMessageId as s}from"@lingui/message-utils/generateMessageId";import{z as e}from"zod";export const MSG_MARKER_KEY="$msg";export const MSG_ID_MARKER_KEY="$msgId";export const msgMarkerSchema=e.object({$msg:e.string(),$msgId:e.string().optional()}).strict();export const isMsgMarker=s=>msgMarkerSchema.safeParse(s).success;export const createMessageDescriptor=e=>({id:e.$msgId??s(e.$msg),message:e.$msg});export const stringifyMsgMacroCode=s=>void 0!==s.$msgId?`msg({ id: ${JSON.stringify(s.$msgId)}, message: ${JSON.stringify(s.$msg)} })`:`msg\`${s.$msg.replaceAll("\\","\\\\").replaceAll("`","\\`").replaceAll("${","\\${")}\``;
+export{MSG_ID_MARKER_KEY,MSG_MARKER_KEY,createMessageDescriptor,isMsgMarker,msgMarkerSchema}from"#package/domain";export const stringifyMsgMacroCode=e=>void 0!==e.$msgId?`msg({ id: ${JSON.stringify(e.$msgId)}, message: ${JSON.stringify(e.$msg)} })`:`msg\`${e.$msg.replaceAll("\\","\\\\").replaceAll("`","\\`").replaceAll("${","\\${")}\``;

package/dist/application-spec/core/markers/raw-eval-write-marker.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { type EvalMarker } from './eval-marker.js';
+import { type EvalMarker } from '#package/domain';
 import { type RawWriteMarker } from './raw-write-marker.js';
 /**
  * YAML marker produced by `$eval: '…', $write: 'fieldName'` — computed read via

package/dist/application-spec/core/markers/raw-eval-write-marker.js

@@ -1 +1 @@
-import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"./eval-marker.js";import{WRITE_MARKER_KEY as a}from"./raw-write-marker.js";export const rawEvalWriteMarkerSchema=r.object({[e]:r.string(),[a]:r.string()}).strict();export const isRawEvalWriteMarker=r=>rawEvalWriteMarkerSchema.safeParse(r).success;
+import{z as r}from"zod";import{EVAL_MARKER_KEY as a}from"#package/domain";import{WRITE_MARKER_KEY as e}from"./raw-write-marker.js";export const rawEvalWriteMarkerSchema=r.object({[a]:r.string(),[e]:r.string()}).strict();export const isRawEvalWriteMarker=r=>rawEvalWriteMarkerSchema.safeParse(r).success;

package/dist/application-spec/core/markers/raw-read-write-marker.js

@@ -1 +1 @@
-import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"./eval-marker.js";import{bindMarkerDefinition as t}from"./raw-bind-marker.js";import{READ_MARKER_KEY as i,readMarkerDefinition as o}from"./raw-read-marker.js";import{WRITE_MARKER_KEY as a,writeMarkerDefinition as s}from"./raw-write-marker.js";export const rawReadWriteMarkerSchema=r.object({[i]:r.string(),[a]:r.string()}).strict();export const isRawReadWriteMarker=r=>rawReadWriteMarkerSchema.safeParse(r).success;export const readWriteMarkerDefinition={anyOf:[t,{type:"object",properties:{...o.properties??{},...s.properties??{}},required:o.required,additionalProperties:!1},{type:"object",properties:{[e]:{type:"string"},...s.properties??{}},required:[e,...s.required??[]],additionalProperties:!1}]};
+import{z as r}from"zod";import{EVAL_MARKER_KEY as e}from"#package/domain";import{bindMarkerDefinition as t}from"./raw-bind-marker.js";import{READ_MARKER_KEY as i,readMarkerDefinition as o}from"./raw-read-marker.js";import{WRITE_MARKER_KEY as a,writeMarkerDefinition as p}from"./raw-write-marker.js";export const rawReadWriteMarkerSchema=r.object({[i]:r.string(),[a]:r.string()}).strict();export const isRawReadWriteMarker=r=>rawReadWriteMarkerSchema.safeParse(r).success;export const readWriteMarkerDefinition={anyOf:[t,{type:"object",properties:{...o.properties??{},...p.properties??{}},required:o.required,additionalProperties:!1},{type:"object",properties:{[e]:{type:"string"},...p.properties??{}},required:[e,...p.required??[]],additionalProperties:!1}]};

package/dist/application-spec/{core → enhanced-json}/eval-to-constant.d.ts

@@ -1,4 +1,4 @@
-import type { EvalExpressionParser } from './eval-expression-parser.js';
+import type { EvalExpressionParser } from '../core/index.js';
 type FoldedValue = string | number | boolean | null | undefined | readonly FoldedValue[] | {
     readonly [key: string]: FoldedValue;
 };

package/dist/application-spec/enhanced-json/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveEnhancedJsonValue } from './resolve-enhanced-json-value.js';
+export { schemaFromValue } from './schema-from-value.js';
+export { stringifyEnhancedJsonValue } from './stringify-enhanced-json-value.js';
+export { validateNoLegacyCodeRef } from './validate-no-legacy-code-ref.js';

package/dist/application-spec/enhanced-json/index.js

@@ -0,0 +1 @@
+export{resolveEnhancedJsonValue}from"./resolve-enhanced-json-value.js";export{schemaFromValue}from"./schema-from-value.js";export{stringifyEnhancedJsonValue}from"./stringify-enhanced-json-value.js";export{validateNoLegacyCodeRef}from"./validate-no-legacy-code-ref.js";

package/dist/application-spec/enhanced-json/is-enhanced-json-array.d.ts

@@ -0,0 +1,2 @@
+import type { EnhancedJsonArray, EnhancedJsonValue } from '../core/index.js';
+export declare const isEnhancedJsonArray: (value: EnhancedJsonValue) => value is EnhancedJsonArray;

package/dist/application-spec/enhanced-json/is-enhanced-json-array.js

@@ -0,0 +1 @@
+export const isEnhancedJsonArray=r=>Array.isArray(r);

package/dist/application-spec/enhanced-json/resolve-enhanced-json-value.d.ts

@@ -0,0 +1,18 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ParseContext, type SelfAccessor } from '../core/index.js';
+/**
+ * Lowers an {@link EnhancedJsonValue} to its runtime form.
+ *
+ * - `$msg` → `{ id?, message }` i18n descriptor
+ * - `$eval` → `new Function('self', 'return (…)')` invoked with `self`
+ *
+ * Validates caps up front via {@link validateEnhancedJsonValueCaps}; any
+ * disallowed marker produces a parse diagnostic via `ctx.error(...)` and
+ * causes this function to return `undefined`. Non-marker values recurse
+ * (arrays, objects) or pass through (primitives).
+ *
+ * Note: a successful resolution may also return `undefined` legitimately
+ * (e.g. `$eval: 'self.missing'` evaluates to `undefined`). Callers that need
+ * to distinguish "capability violation" from "value is undefined" should
+ * check `ctx.hasErrors` after the call.
+ */
+export declare const resolveEnhancedJsonValue: (value: EnhancedJsonValue, self: SelfAccessor | undefined, caps: EnhancedJsonValueCaps, ctx: ParseContext) => unknown | undefined;

package/dist/application-spec/enhanced-json/resolve-enhanced-json-value.js

@@ -0,0 +1 @@
+import{createMessageDescriptor as e,isEvalMarker as r,isMsgMarker as n}from"../core/index.js";import{isEnhancedJsonArray as t}from"./is-enhanced-json-array.js";import{validateEnhancedJsonValueCaps as o}from"./validate-enhanced-json-value-caps.js";let i=(o,a)=>{if(null===o||"object"!=typeof o)return o;if(n(o))return e(o);if(r(o))return Function("self",`return (${o.$eval})`)(a??{});if(t(o))return o.map(e=>i(e,a));let f={};for(let[e,r]of Object.entries(o))f[e]=i(r,a);return f};export const resolveEnhancedJsonValue=(e,r,n,t)=>{if(o(e,n,t))return i(e,r)};