@salsita-ai/sdk 0.50.0-develop.ae52227c7e → 0.50.0-develop.aec0f535bf

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
@@ -33,7 +37,9 @@ src/invariants/       validation rules
 src/elements/         custom React elements for the configurator and admin UI
 src/handlers/         actions, themes and other handlers
 src/webhooks/         server-side finalization and integration handlers
-.phoenix/             generated code, rebuilt by `phoenix sync`; never edit by hand
+.phoenix/             generated code, rebuilt by `phoenix sync`; never edit generated files
+.phoenix/workspace/   project-owned records in application-spec projects; safe to edit and commit
+docs/                 client documents, such as rendered specification PDFs; deployed with the private sources
 ```
 
 Generated code exposes the `phx` global in project files: `phx.domain` for the model and expressions, `phx.frontend` for elements and handlers, `phx.webhooks` for webhook builders, and the `Phx` type namespace for the generated types.
@@ -42,17 +48,22 @@ 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, the five project scripts it lacks, and a starter spec.             |
-| `phoenix sync`                 | Regenerates project files and aligns dependencies.                                                                |
-| `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.    |
+
+### CLI telemetry
+
+Recognized `phoenix` commands send operational telemetry by default. Commands are anonymous until a successful login associates the installation with a Phoenix account and workspace. Set `PHOENIX_TELEMETRY_DISABLED=1` to opt out. See [Phoenix CLI](<../../apps/storybook/src/Phoenix CLI.mdx#cli-telemetry>) for the stored state, exact payload, delivery behavior and privacy boundaries.
 
 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 +99,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 +109,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/`, and rewrites these SDK-owned files on every sync. Keep custom skills in folders whose names do not start with `phoenix`.
 - 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/AdminShell.js

@@ -1 +1 @@
-import{jsx as r,jsxs as i}from"react/jsx-runtime";import"@fontsource-variable/roboto/index.css";import{I18nProvider as e}from"@lingui/react";import{QueryClientProvider as o}from"@tanstack/react-query";import{useRef as t}from"react";import{ErrorBoundary as n}from"react-error-boundary";import{ApplicationType as a,ApplicationTypeProvider as d,BackendDataValueProvider as m,FrontendDataValueProvider as c,PublishedDataValueProvider as l,SessionServiceProvider as p,useAdminDomainData as s,useApplicationQueryClient as h,useI18n as f}from"#package/react-sdk";import{ResponsiveContext as u,SnackbarProvider as v,useResponsiveInfo as b}from"#package/ui-sdk";import{EncapsulatedAdminTheme as j}from"./EncapsulatedAdminTheme.js";import{AdminContextProvider as k}from"./providers/AdminContextProvider.js";import{ConfiguratorIntegrationProvider as A}from"./providers/ConfiguratorIntegrationProvider.js";import{ConnectedDataValidationProvider as g}from"./providers/ConnectedDataValidationProvider.js";import{InitialStateProvider as y}from"./providers/InitialStateProvider.js";import{AdminInvalidDeploymentReload as D}from"./ui/AdminInvalidDeploymentReload.js";import{NotAuthenticatedAdminPage as x}from"./ui/NotAuthenticatedAdminPage.js";import{AdminErrorPage as P}from"./ui/layout/AdminErrorPage.js";export const AdminShell=C=>{let{children:I}=C,S=f(),E=h(),F=s(),T=b(t(document.body));return r(d,{type:a.Admin,children:r(j,{children:r(u.Provider,{value:T,children:r(e,{i18n:S,children:r(v,{maxSnack:5,anchorOrigin:{horizontal:"right",vertical:"bottom"},children:r(n,{FallbackComponent:P,children:r(o,{client:E,children:r(p,{notAuthenticatedFallback:x,children:r(l,{publishedData:F.publishedData,children:r(c,{frontendData:F.frontendData,children:r(m,{backendData:F.backendData,children:r(y,{entityType:"Admin",children:r(k,{children:r(g,{children:i(A,{children:[I,r(D,{})]})})})})})})})})})})})})})})})};
+import{jsx as r,jsxs as i}from"react/jsx-runtime";import"@fontsource-variable/roboto/index.css";import{I18nProvider as e}from"@lingui/react";import{QueryClientProvider as o}from"@tanstack/react-query";import{useRef as t}from"react";import{ErrorBoundary as n}from"react-error-boundary";import{ApplicationType as a,ApplicationTypeProvider as d,BackendDataValueProvider as m,FrontendDataValueProvider as c,PublishedDataValueProvider as l,SessionServiceProvider as p,useAdminDomainData as s,useApplicationQueryClient as h,useI18n as f}from"#package/react-sdk";import{Loader as u,ResponsiveContext as v,SnackbarProvider as b,useResponsiveInfo as j}from"#package/ui-sdk";import{EncapsulatedAdminTheme as k}from"./EncapsulatedAdminTheme.js";import{AdminContextProvider as g}from"./providers/AdminContextProvider.js";import{ConfiguratorIntegrationProvider as A}from"./providers/ConfiguratorIntegrationProvider.js";import{ConnectedDataValidationProvider as y}from"./providers/ConnectedDataValidationProvider.js";import{InitialStateProvider as D}from"./providers/InitialStateProvider.js";import{AdminInvalidDeploymentReload as x}from"./ui/AdminInvalidDeploymentReload.js";import{NotAuthenticatedAdminPage as P}from"./ui/NotAuthenticatedAdminPage.js";import{AdminErrorPage as C}from"./ui/layout/AdminErrorPage.js";export const AdminShell=F=>{let{children:I}=F,S=f(),E=h(),T=s(),q=j(t(document.body));return r(d,{type:a.Admin,children:r(k,{children:r(v.Provider,{value:q,children:r(e,{i18n:S,children:r(b,{maxSnack:5,anchorOrigin:{horizontal:"right",vertical:"bottom"},children:r(n,{FallbackComponent:C,children:r(o,{client:E,children:r(p,{notAuthenticatedFallback:P,loadingFallback:u,children:r(l,{publishedData:T.publishedData,children:r(c,{frontendData:T.frontendData,children:r(m,{backendData:T.backendData,children:r(D,{entityType:"Admin",children:r(g,{children:r(y,{children:i(A,{children:[I,r(x,{})]})})})})})})})})})})})})})})})};

package/dist/admin/common/admin-interface.d.ts

@@ -1,4 +1,4 @@
-import { type $DomainEntity, type ConfiguratorBuilder, type DomainEntity, type IsCreateRecipeUpdate, type IsReplaceRecipeUpdate, type TransformerFactory, type UpdateFactory, getIdSequence } from '#package/domain';
+import { type $DomainEntity, type ActionTypes, type ConfiguratorBuilder, type DomainEntity, type IsCreateRecipeUpdate, type IsReplaceRecipeUpdate, type TransformerFactory, type UpdateFactory, getIdSequence } from '#package/domain';
 import { type IsAngleDimensionUpdate, type IsAttributeSelectionUpdate, type IsAttributeSwitchUpdate, type IsDeleteEntityUpdate, type IsDistanceDimensionUpdate, type IsGenericDimensionUpdate, type IsSwatchSelectionUpdate, type IsTextValueUpdate, type UseAccessService, type UseActiveNavigationState, type UseActiveViewState, type UseAnalyticsService, type UseAngleDimension, type UseAttributeSelection, type UseAttributeSwitch, type UseAuthenticatedClient, type UseAuthorizedClient, type UseComponent, type UseComponents, type UseComposition, type UseConfigurationId, type UseControlViolations, type UseCookRecipes, type UseCookReplaceRecipes, type UseCookedRecipes, type UseCookedReplaceRecipes, type UseDeleteEntity, type UseDeletedEntity, type UseDeselect, type UseDistanceDimension, type UseDistanceDimensionSelection, type UseDomainApplicationContext, type UseDomainApplicationProps, type UseDomainContext, type UseDomainEntityState, type UseEntitySelector, type UseFirstComponent, type UseFirstRootComponent, type UseGenericDimension, type UseGroupedRecipeOptions, type UseIntegrationService, type UseIsFullscreenActive, type UseLoadedData, type UseMapViolationHints, type UseNavigate, type UseReplaceEntityRecipeOptions, type UseRootComponents, type UseRootEntityId, type UseRootEntitySelector, type UseRootEntityState, type UseSelectEntity, type UseSelectParent, type UseSelectedDomainEntityId, type UseSelectedEntity, type UseSelectedEntityId, type UseSession, type UseSessionRole, type UseSessionService, type UseSlice, type UseState, type UseStateValidity, type UseSwatchSelection, type UseSynchronizedSelector, type UseSynchronizedSelector$, type UseTextValue, type UseUpdateControl, type UseUpdatedControl } from '#package/react-sdk';
 import { type CreatePrePublishAdminHandler } from '../handlers/PrePublishAdminHandler.js';
 import { type UseConfiguratorIntegration } from '../providers/ConfiguratorIntegrationProvider.js';
@@ -324,7 +324,7 @@ export interface AdminInterface<ENTITIES extends DomainEntity<string>, ALLOWED_R
     /**
      * Returns validity of the last committed emission
      */
-    useStateValidity: UseStateValidity<ENTITIES, $MAP>;
+    useStateValidity: () => UseStateValidity<ENTITIES, $MAP>;
     /**
      * Returns a function used to reduce violations to translated hints
      */
@@ -377,4 +377,4 @@ export interface AdminInterface<ENTITIES extends DomainEntity<string>, ALLOWED_R
 /**
  * Creates a set of domain-aware hooks for easy and type-safe access to the system state.
  */
-export declare const createAdminInterface: <ENTITIES extends DomainEntity<string> = never, ALLOWED_ROOT_ENTITIES extends ENTITIES = never, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>> = never, NAVIGATION_STATES extends string = never, VIEW_STATES extends string = never, TOOL_STATES extends string = never, EXPORT_STATES extends string = never, PUBLISHED_DATA extends Record<string, unknown> = never, SESSION_DATA extends Record<string, unknown> = never, FRONTEND_DATA extends Record<string, unknown> = never, ADMIN_ENTITIES extends DomainEntity<string> = never, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES = never, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>> = never, ADMIN_NAVIGATION_STATES extends string = never, ADMIN_VIEW_STATES extends string = never, FINALIZE_DATA extends Record<string, unknown> = never, PREFETCHED_FINALIZE_DATA extends Record<string, unknown> = never, FINALIZE_RESULT extends Record<string, unknown> = never, CALLBACK_DATA extends Record<string, unknown> = never, RESOURCE extends string = never>(_configurationBuilder: ConfiguratorBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, FINALIZE_RESULT, PREFETCHED_FINALIZE_DATA, CALLBACK_DATA, RESOURCE>) => AdminInterface<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>;
+export declare const createAdminInterface: <ENTITIES extends DomainEntity<string> = never, ALLOWED_ROOT_ENTITIES extends ENTITIES = never, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>> = never, NAVIGATION_STATES extends string = never, VIEW_STATES extends string = never, TOOL_STATES extends string = never, EXPORT_STATES extends string = never, PUBLISHED_DATA extends Record<string, unknown> = never, SESSION_DATA extends Record<string, unknown> = never, FRONTEND_DATA extends Record<string, unknown> = never, ADMIN_ENTITIES extends DomainEntity<string> = never, ADMIN_ALLOWED_ROOT_ENTITIES extends ADMIN_ENTITIES = never, ADMIN_$MAP extends Record<ADMIN_ENTITIES['type'], $DomainEntity<ADMIN_ENTITIES>> = never, ADMIN_NAVIGATION_STATES extends string = never, ADMIN_VIEW_STATES extends string = never, FINALIZE_DATA extends Record<string, unknown> = never, PREFETCHED_FINALIZE_DATA extends Record<string, unknown> = never, FINALIZE_RESULT extends Record<string, unknown> = never, CALLBACK_DATA extends Record<string, unknown> = never, RESOURCE extends string = never>(_configurationBuilder: ConfiguratorBuilder<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ActionTypes, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES, FINALIZE_DATA, FINALIZE_RESULT, PREFETCHED_FINALIZE_DATA, CALLBACK_DATA, RESOURCE>) => AdminInterface<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>;

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/admin/legacy-admin/Application.js

@@ -1 +1 @@
-import{jsx as r}from"react/jsx-runtime";import"@fontsource-variable/roboto/index.css";import{I18nProvider as o}from"@lingui/react";import{QueryClientProvider as i}from"@tanstack/react-query";import{useRef as t}from"react";import{ErrorBoundary as e}from"react-error-boundary";import{SessionServiceProvider as n,useApplicationQueryClient as m,useI18n as a}from"#package/react-sdk";import{ResponsiveContext as c,SnackbarProvider as d,useResponsiveInfo as p}from"#package/ui-sdk";import{EncapsulatedAdminTheme as l}from"../EncapsulatedAdminTheme.js";import{ConfiguratorIntegrationProvider as s}from"../providers/ConfiguratorIntegrationProvider.js";import{InitialStateProvider as f}from"../providers/InitialStateProvider.js";import{AdminErrorPage as h}from"../ui/layout/AdminErrorPage.js";import{LegacyAdminContextProvider as u}from"./LegacyAdminContextProvider.js";export const Application=()=>{let g=a(),v=m(),j=p(t(document.body));return r(l,{children:r(c.Provider,{value:j,children:r(o,{i18n:g,children:r(d,{maxSnack:5,anchorOrigin:{vertical:"bottom",horizontal:"right"},children:r(e,{FallbackComponent:h,children:r(i,{client:v,children:r(n,{children:r(f,{entityType:"Admin",children:r(s,{children:r(u,{})})})})})})})})})})};
+import{jsx as r}from"react/jsx-runtime";import"@fontsource-variable/roboto/index.css";import{I18nProvider as o}from"@lingui/react";import{QueryClientProvider as i}from"@tanstack/react-query";import{useRef as t}from"react";import{ErrorBoundary as e}from"react-error-boundary";import{SessionServiceProvider as n,useApplicationQueryClient as a,useI18n as m}from"#package/react-sdk";import{Loader as c,ResponsiveContext as d,SnackbarProvider as l,useResponsiveInfo as p}from"#package/ui-sdk";import{EncapsulatedAdminTheme as s}from"../EncapsulatedAdminTheme.js";import{ConfiguratorIntegrationProvider as f}from"../providers/ConfiguratorIntegrationProvider.js";import{InitialStateProvider as h}from"../providers/InitialStateProvider.js";import{AdminErrorPage as u}from"../ui/layout/AdminErrorPage.js";import{LegacyAdminContextProvider as g}from"./LegacyAdminContextProvider.js";export const Application=()=>{let v=m(),k=a(),b=p(t(document.body));return r(s,{children:r(d.Provider,{value:b,children:r(o,{i18n:v,children:r(l,{maxSnack:5,anchorOrigin:{vertical:"bottom",horizontal:"right"},children:r(e,{FallbackComponent:u,children:r(i,{client:k,children:r(n,{loadingFallback:c,children:r(h,{entityType:"Admin",children:r(f,{children:r(g,{})})})})})})})})})})};

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/caching/index.d.ts

@@ -1,4 +1,9 @@
+export { RuntimeReferenceStore, type ScopedBuilder } from '#package/domain';
+/**
+ * @deprecated Use {@link RuntimeReferenceStore}. This compatibility alias will be removed in a
+ * future breaking project-sdk release.
+ */
+export { RuntimeReferenceStore as ApplicationSpecCache } from '#package/domain';
 export * from './file-hash.js';
 export * from './content-diff.js';
-export * from './runtime-reference-store.js';
 export * from './file-dep-hash.js';

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

@@ -1 +1 @@
-export*from"./file-hash.js";export*from"./content-diff.js";export*from"./runtime-reference-store.js";export*from"./file-dep-hash.js";
+export{RuntimeReferenceStore,RuntimeReferenceStore as ApplicationSpecCache}from"#package/domain";export*from"./file-hash.js";export*from"./content-diff.js";export*from"./file-dep-hash.js";

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";