@salsita-ai/sdk 0.50.0-develop.b9eb39baf0 → 0.50.0-develop.bb1eefaada

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`. |
@@ -99,7 +104,7 @@ The `package.json` `exports` map is the machine-readable list, and the TypeScrip
 
 - `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.
-- Studio, where you sign in and manage projects, has builder guides for getting started, the CLI and deployments.
+- 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.
 
 Existing projects may still call the legacy `domain-cli`, `webhook-cli`, `deployment-cli` and `embedding-cli` binaries, which remain installed for compatibility. New automation uses `phoenix`.

package/dist/admin/create-admin-pages-from-spec.d.ts

@@ -2,7 +2,7 @@ import type { AdminPagesSpec, DataSpec, DomainComponentOptic, NavigationListItem
 type AdminPageComponent = DomainComponentOptic<any, any, any, any, any, any, SystemComponentTypeConstraint>;
 type AdminPageNavigationItem = NavigationListItem | NestedNavigationListItem;
 export declare const createAdminPagesFromSpec: (spec: AdminPagesSpec, dataSpec?: DataSpec) => {
-    components: (import("../domain/components/domain-component-optic.js").DomainComponentSimpleOptic<import("#package/domain").AnyDomainEntity, import("#package/domain").Admin, import("../domain/admin-domain/__generated/application-types.js").PublishedData, import("../domain/admin-domain/__generated/application-types.js").SessionData, Record<string, unknown>, import("#package/domain").Admin, import("#package/domain").SystemComponentType<"navigationPanelList", import("#package/domain").NavigationPanelListComponentState, never>> | import("../domain/components/domain-component-optic.js").DomainComponentSimpleOptic<import("#package/domain").AnyDomainEntity, import("#package/domain").Admin, import("../domain/admin-domain/__generated/application-types.js").PublishedData, import("../domain/admin-domain/__generated/application-types.js").SessionData, Record<string, unknown>, import("#package/domain").Preset, import("#package/domain").SystemComponentType<"attributeSelection", import("#package/domain").AttributeSelectionComponentState, "value">> | AdminPageComponent)[];
+    components: (import("#package/domain").DomainComponentSimpleOptic<import("#package/domain").AnyDomainEntity, import("#package/domain").Admin, import("../domain/admin-domain/__generated/application-types.js").PublishedData, import("../domain/admin-domain/__generated/application-types.js").SessionData, Record<string, unknown>, import("#package/domain").Admin, import("#package/domain").SystemComponentType<"navigationPanelList", import("#package/domain").NavigationPanelListComponentState, never>, unknown> | import("#package/domain").DomainComponentSimpleOptic<import("#package/domain").AnyDomainEntity, import("#package/domain").Admin, import("../domain/admin-domain/__generated/application-types.js").PublishedData, import("../domain/admin-domain/__generated/application-types.js").SessionData, Record<string, unknown>, import("#package/domain").Preset, import("#package/domain").SystemComponentType<"attributeSelection", import("#package/domain").AttributeSelectionComponentState, "value">, unknown> | AdminPageComponent)[];
     pages: AdminPageNavigationItem[];
 };
 export {};

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-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/components/component-filter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A single filter criterion — static value, dynamic `$read` reference, or
+ * inline `$eval` expression evaluated against `self` at runtime.
+ *
+ * The `target` field on the `'dynamic'` variant is a bare name (matches the
+ * same pattern as prop-level reads); codegen emits `self.target`, runtime
+ * reads `self[target]`.
+ */
+export type FilterCriterion<T> = {
+    readonly kind: 'static';
+    readonly value: T;
+} | {
+    readonly kind: 'dynamic';
+    readonly target: string;
+} | {
+    readonly kind: 'eval';
+    readonly code: string;
+};
+/**
+ * Parsed component filter controlling when the component is active. Two
+ * mutually-exclusive shapes:
+ *
+ * - `'gradual'` — zero or more per-criterion fields; compiles to one entry per
+ *   set key inside `.withGradualFilter({…})`. The preferred form.
+ * - `'root'` — the entire filter is a single `$read` at the root (legacy
+ *   form `$filter: { $read: '$x' }`); compiles to `.withFilter(self => (self.target))`.
+ *   Distinct codegen because the SDK's `withFilter` and `withGradualFilter`
+ *   methods have different evaluation semantics (whole-closure vs per-key).
+ *
+ * See `components.md §"Simple expression filter"` / `§"Declarative filter"`.
+ */
+export type ComponentFilter = {
+    readonly kind: 'gradual';
+    readonly navigationStates?: FilterCriterion<readonly string[]>;
+    readonly viewStates?: FilterCriterion<readonly string[]>;
+    readonly toolStates?: FilterCriterion<readonly string[]>;
+    readonly exportStates?: FilterCriterion<readonly string[]>;
+    readonly modes?: FilterCriterion<readonly string[]>;
+    readonly roles?: FilterCriterion<readonly string[]>;
+    readonly selectedEntityIds?: FilterCriterion<unknown>;
+    readonly hoveredEntityIds?: FilterCriterion<unknown>;
+    readonly draggedEntityIds?: FilterCriterion<unknown>;
+    readonly exportedEntityIds?: FilterCriterion<unknown>;
+    readonly active?: FilterCriterion<boolean>;
+    readonly fullscreen?: FilterCriterion<boolean>;
+    readonly debug?: FilterCriterion<boolean>;
+    readonly viewports?: FilterCriterion<unknown>;
+} | {
+    readonly kind: 'root';
+    readonly target: string;
+};
+/** Criterion field names on the gradual variant — used for parse and iteration. */
+export declare const FILTER_CRITERION_KEYS: readonly ["navigationStates", "viewStates", "toolStates", "exportStates", "modes", "roles", "selectedEntityIds", "hoveredEntityIds", "draggedEntityIds", "exportedEntityIds", "active", "fullscreen", "debug", "viewports"];

package/dist/application-spec/core/components/component-filter.js

@@ -0,0 +1 @@
+export const FILTER_CRITERION_KEYS=["navigationStates","viewStates","toolStates","exportStates","modes","roles","selectedEntityIds","hoveredEntityIds","draggedEntityIds","exportedEntityIds","active","fullscreen","debug","viewports"];

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

@@ -0,0 +1,2 @@
+export * from './component-filter.js';
+export * from './sdk-code-ref.js';

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

@@ -0,0 +1 @@
+export*from"./component-filter.js";export*from"./sdk-code-ref.js";

package/dist/application-spec/core/components/sdk-code-ref.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A parameter that should be emitted as an unquoted code reference in codegen
+ * (e.g. an entity reflection variable like `Top`).
+ * At runtime, the string value is resolved to the actual object (e.g. entity reflection).
+ */
+export interface SdkCodeRef {
+    readonly $codeRef: string;
+}
+export declare const isSdkCodeRef: (value: unknown) => value is SdkCodeRef;

package/dist/application-spec/core/components/sdk-code-ref.js

@@ -0,0 +1 @@
+export const isSdkCodeRef=e=>"object"==typeof e&&null!==e&&"$codeRef"in e&&"string"==typeof e.$codeRef;

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

@@ -1,9 +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).
@@ -81,68 +78,3 @@ export declare const isEnhancedJsonObject: (value: EnhancedJsonValue) => value i
  * 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 r,isEvalMarker as o}from"./markers/eval-marker.js";import{isMsgMarker as t,msgMarkerSchema as n}from"./markers/msg-marker.js";let s=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>s.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),n,r,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)&&!t(e)&&!o(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 o={};for(let t of Object.keys(e).sort())o[t]=r(e[t]);return o};return JSON.stringify(r(e))};

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

@@ -0,0 +1,2 @@
+export type * from './relation-expression-params.js';
+export * from './sdk-expression-implementation.js';

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

@@ -0,0 +1 @@
+export*from"./sdk-expression-implementation.js";

package/dist/application-spec/core/expressions/relation-expression-params.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The relation factory's single positional param: the relation's kind, the entity type or alias it
+ * points to and its cardinality, plus the id field for `direct` and `indirect` relations. The
+ * assistant schema reads `target` and `cardinality` to type a relation edge.
+ */
+export interface RelationExpressionParams {
+    readonly kind: 'direct' | 'indirect' | 'allOfType';
+    readonly target: string;
+    readonly cardinality: '0-1' | '1-1' | '0-N' | '1-N';
+    readonly field?: string;
+}

package/dist/application-spec/core/expressions/sdk-expression-implementation.d.ts

@@ -0,0 +1,24 @@
+import type { RelationExpressionParams } from './relation-expression-params.js';
+/**
+ * An expression implementation built by an SDK factory at runtime. The kind is the
+ * semantic source of the expression, declared by the section that generated it —
+ * codegen and runtime dispatch on it instead of inspecting factory-function names.
+ * - `relation`: generated from a `relations:` declaration
+ * - `violations`: generated from `invariants:` declarations (the `$violations` expression)
+ */
+export type SdkExpressionImplementation = {
+    readonly kind: 'relation';
+    readonly params: readonly [RelationExpressionParams];
+} | {
+    readonly kind: 'violations';
+    readonly params: readonly unknown[];
+};
+/**
+ * Narrows to implementations that are built by an SDK expression factory at runtime. It checks
+ * `kind` only, so it narrows to the members of the caller's own type that are SDK implementations,
+ * such as those of the parser's `ExpressionImplementation`, and never adds the `params` a value
+ * of another type does not have.
+ */
+export declare const isSdkExpressionImplementation: <IMPLEMENTATION extends {
+    readonly kind: string;
+}>(implementation: IMPLEMENTATION) => implementation is Extract<IMPLEMENTATION, SdkExpressionImplementation>;

package/dist/application-spec/core/expressions/sdk-expression-implementation.js

@@ -0,0 +1 @@
+export const isSdkExpressionImplementation=i=>"relation"===i.kind||"violations"===i.kind;

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

@@ -1,4 +1,6 @@
 export * from './application-file.js';
+export * from './components/index.js';
+export * from './expressions/index.js';
 export * from './specification-files.js';
 export * from './application-instance.js';
 export * from './spec-diagnostic.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*from"./application-file.js";export*from"./components/index.js";export*from"./expressions/index.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";

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 → 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)};

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

@@ -0,0 +1,24 @@
+import { type EnhancedJsonSchemaType, type EvalExpressionParser, type InferableValue, type ParseContext } from '../core/index.js';
+/**
+ * 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;

package/dist/application-spec/enhanced-json/schema-from-value.js

@@ -0,0 +1 @@
+import{PHX_SHORT_PREFIX as e,isEvalMarker as r,isMsgMarker as t}from"../core/index.js";import{DiagnosticCode as o,diagnosticMessages as i}from"../errors/index.js";import{evalCodeUsesSelf as n}from"./eval-code-uses-self.js";import{evalToConstant as a}from"./eval-to-constant.js";export const schemaFromValue=(f,l,s)=>{if(t(f))return{$ref:`${e}MessageDescriptor`};if(r(f)){if(n(f.$eval))return{};let e=a(f.$eval,s);return e.ok?schemaFromValue(e.value,l,s):void l.error(o.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE,i[o.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE](f.$eval))}if(null===f)return{type:"null"};if("string"==typeof f)return{type:"string"};if("number"==typeof f)return{type:"number"};if("boolean"==typeof f)return{type:"boolean"};if(Array.isArray(f)){let e=[];for(let[r,t]of f.entries()){let o=schemaFromValue(t,l.at(String(r)),s);if(void 0===o)return;e.push(o)}return{type:"array",items:e}}if("object"==typeof f){let e=Object.entries(f),r={};for(let[t,o]of e){let e=schemaFromValue(o,l.at(t),s);if(void 0===e)return;r[t]=e}return{type:"object",properties:r,required:e.map(([e])=>e),additionalProperties:!1}}return{}};

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

@@ -0,0 +1,14 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ImportSink, type ParseContext } from '../core/index.js';
+/**
+ * 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;

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

@@ -0,0 +1 @@
+import{isEvalMarker as e,isMsgMarker as r,stringifyMsgMacroCode as n}from"../core/index.js";import{validateEnhancedJsonValueCaps as i}from"./validate-enhanced-json-value-caps.js";let t="__ENHANCED_JSON_VALUE_PLACEHOLDER__",a=RegExp(`"${t}(\\d+)"`,"g");export const stringifyEnhancedJsonValue=(o,s,l,c)=>{if(!i(o,l,c))return;let d=[],g=e=>(d.push(e),`${t}${d.length-1}`);return JSON.stringify(o,(i,t)=>r(t)?(s.addImport("@lingui/core/macro","msg"),g(n(t))):e(t)?g(t.$eval):t,2).replaceAll(a,(e,r)=>{let n=d[Number(r)];if(void 0===n)throw Error(`stringifyEnhancedJsonValue: missing replacement for placeholder index ${r}. This is a logic bug in the serialiser — replacements array shorter than referenced index.`);return n})};

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

@@ -0,0 +1,12 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ParseContext } from '../core/index.js';
+/**
+ * Walks an {@link EnhancedJsonValue} and emits a parse diagnostic for every
+ * `$msg` / `$eval` marker that violates the supplied caps. Returns `true` if
+ * no violation was found. Each diagnostic is scoped to the offending position
+ * via `ctx.at(...)` so users see the full path (e.g. `Table.color`).
+ *
+ * Called as the first step of {@link resolveEnhancedJsonValue} and
+ * {@link stringifyEnhancedJsonValue} — once this passes, the downstream
+ * recursion is free of capability checks and never throws for user input.
+ */
+export declare const validateEnhancedJsonValueCaps: (value: EnhancedJsonValue, caps: EnhancedJsonValueCaps, ctx: ParseContext) => boolean;

package/dist/application-spec/enhanced-json/validate-enhanced-json-value-caps.js

@@ -0,0 +1 @@
+import{isEvalMarker as e,isMsgMarker as r}from"../core/index.js";import{DiagnosticCode as t,diagnosticMessages as n}from"../errors/index.js";import{isEnhancedJsonArray as o}from"./is-enhanced-json-array.js";export const validateEnhancedJsonValueCaps=(a,E,_)=>{if(r(a))return!!E.localizable||(_.error(t.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED,n[t.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED]()),!1);if(e(a))return!!E.selfScoped||(_.error(t.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED,n[t.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED]()),!1);if(null===a||"object"!=typeof a)return!0;if(o(a)){let e=!0;for(let[r,t]of a.entries())validateEnhancedJsonValueCaps(t,E,_.at(String(r)))||(e=!1);return e}let i=!0;for(let[e,r]of Object.entries(a))validateEnhancedJsonValueCaps(r,E,_.at(e))||(i=!1);return i};

package/dist/application-spec/enhanced-json/validate-no-legacy-code-ref.d.ts

@@ -0,0 +1,13 @@
+import type { ParseContext } from '../core/index.js';
+/**
+ * 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/enhanced-json/validate-no-legacy-code-ref.js

@@ -0,0 +1 @@
+import{DiagnosticCode as e,diagnosticMessages as o}from"../errors/index.js";export const validateNoLegacyCodeRef=(r,t)=>{if(null!==r&&"object"==typeof r){if(Array.isArray(r))return void r.forEach((e,o)=>validateNoLegacyCodeRef(e,t.at(String(o))));for(let[a,i]of Object.entries(r)){if("$codeRef"===a&&null!==i&&"object"==typeof i&&"code"in i){t.at(a).error(e.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED,o[e.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED]());continue}validateNoLegacyCodeRef(i,t.at(a))}}};