@salsita-ai/sdk 0.50.0-develop.5a0bcdee42 → 0.50.0-develop.6310349f36

package/dist/docs/phoenix/project-structure.mdx

@@ -49,6 +49,12 @@ project-root/
 | `locales/`      | Locale catalogs (`.po` sources; compiled `.ts`, do not edit)           |
 | `_*`            | Shared code folders at any depth (not auto-imported)                   |
 
+Every file in `components/`, `elements/`, `expressions/`, `actions/`, `invariants/`, `transformers/` and `handlers/`
+(and their `admin/` counterparts) is imported by its location, so its default export must be what that folder's `phx`
+factory returns, or an array of those. A file that exports anything else, such as a plain React component in
+`elements/`, stops the application at start with an `Invalid default export in <file>` error that names the expected
+shape. Keep plain components and helpers in a `_*` folder.
+
 ### Admin Folders (src/admin/)
 
 The `admin/` folder supports these admin-specific categories:

package/dist/docs/phoenix/sdk-builder-workflow.mdx

@@ -36,7 +36,7 @@ The starter `spec/application.yaml` begins with `project: default`, which means
 pnpm phoenix login <workspace>
 ```
 
-`phoenix login` opens Studio, where you name the token and approve the sign-in. The CLI suggests `phoenix CLI on <computer>`; a name of your own, such as the agent and the machine, tells your tokens apart later. Studio sends a one-time code back to the CLI on `127.0.0.1`, the CLI exchanges it for a personal token and returns the browser to Studio, which confirms the sign-in. The code only works for the CLI that asked for it and expires after five minutes. **Deny** stops the waiting CLI at once and creates no token. Use `--no-open` to print the link instead of opening a browser.
+`phoenix login` opens Studio, where you name the token and approve the sign-in. Only a super admin of the workspace can open Studio, so only a super admin can approve it. The CLI suggests `phoenix CLI on <computer>`; a name of your own, such as the agent and the machine, tells your tokens apart later. Studio sends a one-time code back to the CLI on `127.0.0.1`, the CLI exchanges it for a personal token and returns the browser to Studio, which confirms the sign-in. The code only works for the CLI that asked for it and expires after five minutes. **Deny** stops the waiting CLI at once and creates no token. Use `--no-open` to print the link instead of opening a browser.
 
 The CLI stores the token in `~/.phoenix/credentials.json`, readable only by you, with one entry per server. `PHOENIX_CREDENTIALS_FILE` moves the file. The token acts for you in your workspace until you revoke it. It stops working when you are removed from the workspace or banned.
 
@@ -44,12 +44,12 @@ The CLI stores the token in `~/.phoenix/credentials.json`, readable only by you,
 
 `login`, `logout` and `deploy` follow the region, not the `SERVER_URL` in the project's `.env`. `dev` follows the region too when `.env` has no `SERVER_URL`:
 
-| Flag                  | Default                              | Description                                      |
-| --------------------- | ------------------------------------ | ------------------------------------------------ |
-| `--region`            | `eu`                                 | Phoenix region of the workspace: `eu` or `us`    |
-| `--serverUrl` / `-su` | the region's server                  | Phoenix server URL, for a local or custom server |
-| `--studioUrl`         | the workspace's Studio in the region | Studio URL of the workspace (`login`)            |
-| `--open`              | `true`                               | Open the approval page in your browser (`login`) |
+| Flag                   | Default                              | Description                                      |
+| ---------------------- | ------------------------------------ | ------------------------------------------------ |
+| `--region`             | `eu`                                 | Phoenix region of the workspace: `eu` or `us`    |
+| `--serverUrl` / `--su` | the region's server                  | Phoenix server URL, for a local or custom server |
+| `--studioUrl`          | the workspace's Studio in the region | Studio URL of the workspace (`login`)            |
+| `--open`               | `true`                               | Open the approval page in your browser (`login`) |
 
 ## 3. Develop
 
@@ -59,7 +59,7 @@ pnpm phoenix dev
 
 Signed in, `phoenix dev` needs no `.env` and nothing set up in Studio. When it starts, it asks the server for your development environment in the project the spec names. The server creates that environment the first time and finds it again on every later run. `phoenix dev` prints the workspace, project and environment it works in, prepares a development deployment there and opens the webhook tunnel, as for any Phoenix project (see [Phoenix CLI](?path=/docs/phoenix-phoenix-cli--docs)). It then prints the address of the preview as `Preview: <url>`; the preview talks to the server the deployment was prepared on.
 
-Every user of the workspace gets their own development environment, so a teammate who clones the project and signs in doesn't overwrite your schema or take over your webhooks. The development environment is separate from `production`: nothing you do in `phoenix dev` changes the live configurator.
+Every user who signs the CLI in gets their own development environment, so a teammate (a super admin of the workspace, like you) who clones the project and signs in doesn't overwrite your schema or take over your webhooks. The development environment is separate from `production`: nothing you do in `phoenix dev` changes the live configurator.
 
 `pnpm dev:local` still runs the project without any server, with state kept in the browser.
 
@@ -107,4 +107,5 @@ Coding agents working in your project use the same command, guided by the genera
 - `phoenix deploy` always deploys to the workspace's default project; it doesn't read `project` from the spec yet.
 - Only `phoenix dev` works from the sign-in. `phoenix deployment:prepare-dev` still needs the `.env` block of a Studio development environment.
 - Every deploy uploads the whole project; there are no incremental uploads.
-- Your own environment variables can't use platform names such as `LAMBDA_FUNCTION_NAME` or the `AWS_` prefix. A deploy that sets them fails before it registers.
+- Your own environment variables are set in Studio under Environment, by a super admin of the workspace, and apply from the next deploy. `phoenix dev` doesn't receive them: your development environment has its own variables. A build reads them from `process.env`; a webhook reads the ones the spec declares under `env.webhook`, through `phx.webhooksEnv` (see [Webhooks](?path=/docs/phoenix-webhooks--docs)). They can't use platform names such as `LAMBDA_FUNCTION_NAME`, the `AWS_` prefix, the identity provider settings such as `CLERK_API_KEY`, or names the CLI and the deploy tooling read themselves, such as `SERVER_URL` or `NODE_OPTIONS`; Studio refuses those names.
+- Only super admins of a workspace can open its Studio. Admins and users see a page that says so.

package/dist/docs/recipes-and-delete/recipe-hierarchy-selection.mdx

@@ -160,21 +160,23 @@ Room: {
 
 ### Entity Replacement Transformer
 
-Configure transformers to handle entity deselection when replacement occurs. This ensures clean state transitions:
+Add a transformer to handle entity deselection when replacement occurs. This ensures clean state transitions:
 
 ```typescript
-const config = configuratorBuilder
-  .withTransformers(ctx => {
-    return [
-      phx.frontend.transformerBuilder.when
-        .entity(['RedSpecialConsole', 'BlueSpecialConsole'])
-        .replacedWith(['RedSpecialConsole', 'BlueSpecialConsole'])
-        .then.deselect()
-        .build('Deselect special console on replacement')
-        .register(ctx),
-    ]
-  })
-  .buildConfig()
+// src/transformers/deselect-special.ts
+export default phx.frontend.transformerBuilder.when
+  .entity(['RedSpecialConsole', 'BlueSpecialConsole'])
+  .replacedWith(['RedSpecialConsole', 'BlueSpecialConsole'])
+  .then.deselect()
+  .build('deselect-special')
+```
+
+Each file in `src/transformers/` default-exports one transformer and is picked up by its location. The `transformers` section of the spec turns it on by name. For a transformer made with `build(name)` that is the name passed to `build(...)`, which must match the file name with case and dashes ignored (`fix-finish.ts` and `fixFinish` match). For a plain-function export it is the file name:
+
+```yaml
+# spec/application.yaml
+transformers:
+  - name: deselect-special
 ```
 
 ### Initial Configuration

package/dist/docs/relations/hierarchy.mdx

@@ -69,8 +69,19 @@ relations:
 
 Consider enabling select-parent-on-deselection to keep selection stable:
 
-```ts
-.withTransformers(ctx => [{ priority: 101, transformer: createSelectParentOnDeselectionTransformer(ctx) }])
+```typescript
+// src/transformers/select-parent.ts
+import { createSelectParentOnDeselectionTransformer } from '@salsita-ai/sdk/domain'
+
+export default createSelectParentOnDeselectionTransformer
+```
+
+Each file in `src/transformers/` default-exports one transformer and is picked up by its location. The `transformers` section of the spec turns it on by name. For a transformer made with `build(name)` that is the name passed to `build(...)`, which must match the file name with case and dashes ignored (`fix-finish.ts` and `fixFinish` match). For a plain-function export it is the file name:
+
+```yaml
+# spec/application.yaml
+transformers:
+  - name: select-parent
 ```
 
 ## Example

package/dist/domain/admin-domain/__generated/enhanced-model.d.ts

@@ -3,8 +3,7 @@
  * @file enhanced-model.ts
  * @description Standalone common-admin enhanced model types.
  */
-import type { $DomainEntity } from '../../core/model.js';
-import type { Violation } from '../../invariants/violation.js';
+import type { $DomainEntity, Violation } from '../../core/index.js';
 import type { Admin, ConnectedDataConfig, DataTable, DummyDoNotUse, Preset, PresetCategory, Recipe } from './model/index.js';
 export type PresetCategoryExpressions = {
     readonly $isDraft: boolean;

package/dist/domain/admin-domain/__generated/model/versions/v1.d.ts

@@ -3,7 +3,7 @@
  * @file model/versions/v1.ts
  * @description Historical domain model types for the migration chain.
  */
-import type { DomainEntityId } from '../../../../core/model.js';
+import type { DomainEntityId } from '../../../../core/index.js';
 export interface Admin {
     readonly id: DomainEntityId<'Admin'>;
     readonly type: 'Admin';

package/dist/domain/admin-domain/__generated/model/versions/v2.d.ts

@@ -3,7 +3,7 @@
  * @file model/versions/v2.ts
  * @description Historical domain model types for the migration chain.
  */
-import type { DomainEntityId } from '../../../../core/model.js';
+import type { DomainEntityId } from '../../../../core/index.js';
 export type GenericDomainEntity = {
     readonly id: DomainEntityId<string>;
     readonly type: string;

package/dist/domain/admin-domain/__generated/model/versions/v3.d.ts

@@ -3,7 +3,7 @@
  * @file model/versions/v3.ts
  * @description Historical domain model types for the migration chain.
  */
-import type { DomainEntityId } from '../../../../core/model.js';
+import type { DomainEntityId } from '../../../../core/index.js';
 export type GenericDomainEntity = {
     readonly id: DomainEntityId<string>;
     readonly type: string;

package/dist/domain/admin-domain/__generated/model/versions/v4.d.ts

@@ -4,7 +4,7 @@
  * @description Historical domain model types for the migration chain.
  */
 import type { MultilingualString } from '@salsita-ai/common/utils';
-import type { DomainEntityId } from '../../../../core/model.js';
+import type { DomainEntityId } from '../../../../core/index.js';
 export type GenericDomainEntity = {
     readonly id: DomainEntityId<string>;
     readonly type: string;

package/dist/domain/admin-domain/__generated/model/versions/v5.d.ts

@@ -4,7 +4,7 @@
  * @description Historical domain model types for the migration chain.
  */
 import type { MultilingualString } from '@salsita-ai/common/utils';
-import type { DomainEntityId } from '../../../../core/model.js';
+import type { DomainEntityId } from '../../../../core/index.js';
 export type GenericDomainEntity = {
     readonly id: DomainEntityId<string>;
     readonly type: string;

package/dist/domain/admin-domain/__generated/model/versions/v6.d.ts

@@ -4,8 +4,8 @@
  * @description Standalone versioned domain model and reflections.
  */
 import type { MultilingualString } from '@salsita-ai/common/utils';
-import type { DomainEntityId } from '../../../../core/model.js';
-import { DomainEntityReflection, RawAliasReflection } from '../../../../core/reflection.js';
+import type { DomainEntityId } from '../../../../core/index.js';
+import { DomainEntityReflection, RawAliasReflection } from '../../../../core/index.js';
 export declare const modelVersion = 6;
 export type GenericDomainEntity = {
     readonly id: DomainEntityId<string>;

package/dist/domain/admin-domain/__generated/model/versions/v6.js

@@ -1 +1 @@
-import{DomainEntityReflection as e,RawAliasReflection as t}from"../../../../core/reflection.js";export const modelVersion=6;export const Admin=new e("Admin",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]}},required:["commonAdminModelVersion"],additionalProperties:!1}]);export const Preset=new e("Preset",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},description:{$ref:"#/$defs/MultilingualString"},index:{type:"number"},visible:{type:"boolean"},categoryId:{oneOf:[{$ref:"#/$defs/DomainEntityId"},{type:"null"}]},configurationId:{oneOf:[{type:"string"},{type:"null"}]},revisionId:{oneOf:[{type:"string"},{type:"null"}]},ownerToken:{oneOf:[{type:"string"},{type:"null"}]},readToken:{oneOf:[{type:"string"},{type:"null"}]},thumbnailUrl:{oneOf:[{type:"string"},{type:"null"}]},customThumbnailUrl:{oneOf:[{type:"string"},{type:"null"}]},tags:{type:"array",items:{type:"string"}}},required:["commonAdminModelVersion","name","description","index","visible","categoryId","configurationId","revisionId","ownerToken","readToken","thumbnailUrl","customThumbnailUrl","tags"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1},DomainEntityId:{type:"string",pattern:"^[A-Z]\\w*-\\d+$"}}}]);export const PresetCategory=new e("PresetCategory",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},index:{type:"number"},visible:{type:"boolean"},description:{$ref:"#/$defs/MultilingualString"}},required:["commonAdminModelVersion","name","index","visible","description"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1}}}]);export const Recipe=new e("Recipe",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},description:{$ref:"#/$defs/MultilingualString"},collection:{type:"string"},index:{type:"number"},visible:{type:"boolean"},configuration:{anyOf:[{$ref:"#/$defs/RecipeConfiguration"},{type:"null"}]}},required:["commonAdminModelVersion","name","description","collection","index","visible","configuration"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1},RecipeConfiguration:{type:"object",properties:{modelVersion:{type:"integer"},entities:{type:"array",items:{$ref:"#/$defs/GenericDomainEntity"}},rootEntityType:{type:"string"},rootRecipeId:{type:"string"},recipeIds:{type:"array",items:{type:"string"}},configurationId:{type:"string"},revisionId:{type:"string"},ownerToken:{type:"string"}},additionalProperties:!1,required:["entities","rootEntityType","rootRecipeId","recipeIds","modelVersion","configurationId","revisionId","ownerToken"]},GenericDomainEntity:{type:"object",properties:{id:{$ref:"#/$defs/DomainEntityId"},type:{type:"string"}},additionalProperties:!0,required:["id","type"]},DomainEntityId:{type:"string",pattern:"^[A-Z]\\w*-\\d+$"}}}]);export const ConnectedDataConfig=new e("ConnectedDataConfig",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},dataEntryKey:{type:"string"},provider:{type:"string"},externalFileId:{type:"string"},fileLabel:{type:"string"},driveId:{oneOf:[{type:"string"},{type:"null"}]},tabSelection:{type:"array",items:{type:"string"}},headerRowIndex:{oneOf:[{type:"integer"},{type:"null"}]}},required:["commonAdminModelVersion","dataEntryKey","provider","externalFileId","fileLabel","driveId","tabSelection","headerRowIndex"],additionalProperties:!1}]);export const DataTable=new e("DataTable",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},dataEntryKey:{type:"string"},data:{type:"object"}},required:["commonAdminModelVersion","dataEntryKey","data"],additionalProperties:!1}]);export const DummyDoNotUse=new e("DummyDoNotUse",[{type:"object",properties:{},required:[],additionalProperties:!1}]);export const RootEntity=new t("RootEntity",[Admin]);export const CommonAdminEntity=new t("CommonAdminEntity",[Admin,Preset,PresetCategory,Recipe,ConnectedDataConfig,DataTable]);export const AnyDomainEntity=new t("AnyDomainEntity",[Admin,Preset,PresetCategory,Recipe,ConnectedDataConfig,DataTable,DummyDoNotUse]);export const aliases={RootEntity:RootEntity.types,CommonAdminEntity:CommonAdminEntity.types,AnyDomainEntity:AnyDomainEntity.types};
+import{DomainEntityReflection as e,RawAliasReflection as t}from"../../../../core/index.js";export const modelVersion=6;export const Admin=new e("Admin",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]}},required:["commonAdminModelVersion"],additionalProperties:!1}]);export const Preset=new e("Preset",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},description:{$ref:"#/$defs/MultilingualString"},index:{type:"number"},visible:{type:"boolean"},categoryId:{oneOf:[{$ref:"#/$defs/DomainEntityId"},{type:"null"}]},configurationId:{oneOf:[{type:"string"},{type:"null"}]},revisionId:{oneOf:[{type:"string"},{type:"null"}]},ownerToken:{oneOf:[{type:"string"},{type:"null"}]},readToken:{oneOf:[{type:"string"},{type:"null"}]},thumbnailUrl:{oneOf:[{type:"string"},{type:"null"}]},customThumbnailUrl:{oneOf:[{type:"string"},{type:"null"}]},tags:{type:"array",items:{type:"string"}}},required:["commonAdminModelVersion","name","description","index","visible","categoryId","configurationId","revisionId","ownerToken","readToken","thumbnailUrl","customThumbnailUrl","tags"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1},DomainEntityId:{type:"string",pattern:"^[A-Z]\\w*-\\d+$"}}}]);export const PresetCategory=new e("PresetCategory",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},index:{type:"number"},visible:{type:"boolean"},description:{$ref:"#/$defs/MultilingualString"}},required:["commonAdminModelVersion","name","index","visible","description"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1}}}]);export const Recipe=new e("Recipe",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},name:{$ref:"#/$defs/MultilingualString"},description:{$ref:"#/$defs/MultilingualString"},collection:{type:"string"},index:{type:"number"},visible:{type:"boolean"},configuration:{anyOf:[{$ref:"#/$defs/RecipeConfiguration"},{type:"null"}]}},required:["commonAdminModelVersion","name","description","collection","index","visible","configuration"],additionalProperties:!1,$defs:{MultilingualString:{type:"object",properties:{$lang:{type:"object",additionalProperties:{type:"string"}}},required:["$lang"],additionalProperties:!1},RecipeConfiguration:{type:"object",properties:{modelVersion:{type:"integer"},entities:{type:"array",items:{$ref:"#/$defs/GenericDomainEntity"}},rootEntityType:{type:"string"},rootRecipeId:{type:"string"},recipeIds:{type:"array",items:{type:"string"}},configurationId:{type:"string"},revisionId:{type:"string"},ownerToken:{type:"string"}},additionalProperties:!1,required:["entities","rootEntityType","rootRecipeId","recipeIds","modelVersion","configurationId","revisionId","ownerToken"]},GenericDomainEntity:{type:"object",properties:{id:{$ref:"#/$defs/DomainEntityId"},type:{type:"string"}},additionalProperties:!0,required:["id","type"]},DomainEntityId:{type:"string",pattern:"^[A-Z]\\w*-\\d+$"}}}]);export const ConnectedDataConfig=new e("ConnectedDataConfig",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},dataEntryKey:{type:"string"},provider:{type:"string"},externalFileId:{type:"string"},fileLabel:{type:"string"},driveId:{oneOf:[{type:"string"},{type:"null"}]},tabSelection:{type:"array",items:{type:"string"}},headerRowIndex:{oneOf:[{type:"integer"},{type:"null"}]}},required:["commonAdminModelVersion","dataEntryKey","provider","externalFileId","fileLabel","driveId","tabSelection","headerRowIndex"],additionalProperties:!1}]);export const DataTable=new e("DataTable",[{type:"object",properties:{commonAdminModelVersion:{enum:[6]},dataEntryKey:{type:"string"},data:{type:"object"}},required:["commonAdminModelVersion","dataEntryKey","data"],additionalProperties:!1}]);export const DummyDoNotUse=new e("DummyDoNotUse",[{type:"object",properties:{},required:[],additionalProperties:!1}]);export const RootEntity=new t("RootEntity",[Admin]);export const CommonAdminEntity=new t("CommonAdminEntity",[Admin,Preset,PresetCategory,Recipe,ConnectedDataConfig,DataTable]);export const AnyDomainEntity=new t("AnyDomainEntity",[Admin,Preset,PresetCategory,Recipe,ConnectedDataConfig,DataTable,DummyDoNotUse]);export const aliases={RootEntity:RootEntity.types,CommonAdminEntity:CommonAdminEntity.types,AnyDomainEntity:AnyDomainEntity.types};

package/dist/domain/admin-domain/implementation/common-admin-expressions.d.ts

@@ -1,7 +1,4 @@
-import type { ExpressionContext } from '../../core/expression.js';
-import type { DomainEntity } from '../../core/model.js';
-import type { DomainState } from '../../core/state.js';
-import type { Violation } from '../../invariants/violation.js';
+import type { DomainEntity, DomainState, ExpressionContext, Violation } from '../../core/index.js';
 import type { ChildEntitySelectionOption } from '../../system-components/child-entity-selection.js';
 import type { RecipeListItem } from '../../system-components/index.js';
 import type { SwatchOptionMap } from '../../system-components/material-swatch.js';

package/dist/domain/admin-domain/implementation/common-admin-migrations.d.ts

@@ -1,4 +1,4 @@
-import type { DomainEntity } from '../../core/model.js';
+import type { DomainEntity } from '../../core/index.js';
 import { AnyDomainEntity as V1Entity } from '../__generated/model/versions/v1.js';
 import { AnyDomainEntity as V2Entity } from '../__generated/model/versions/v2.js';
 import { AnyDomainEntity as V3Entity } from '../__generated/model/versions/v3.js';

package/dist/domain/admin-domain/index.d.ts

@@ -1,6 +1,5 @@
 import type { ConfiguratorBuilder } from '../application/configurator-builder.js';
-import { DomainComponentOpticBuilder } from '../components/domain-component-optic.js';
-import type { $DomainEntity, DomainEntity } from '../core/model.js';
+import { type $DomainEntity, DomainComponentOpticBuilder, type DomainEntity } from '../core/index.js';
 import type { FinalizeData, FinalizeResult, FrontendData, NavigationState, PublishedData, SessionData, ViewState } from './__generated/application-types.js';
 import type { $Map } from './__generated/enhanced-model.js';
 import type { Aliases, CommonAdminEntity, RootEntity } from './__generated/model/index.js';
@@ -11,9 +10,9 @@ export * from './__generated/model/index.js';
 export * from './implementation/common-admin-expressions.js';
 export * from './implementation/common-admin-publish.js';
 export * from './schema/index.js';
-export declare const createCommonAdminRecipe: import("../domain-context/recipe-system/recipes.js").RecipeFactory<AnyDomainEntity>;
+export declare const createCommonAdminRecipe: import("../index.js").RecipeFactory<AnyDomainEntity>;
 export declare const attachCommonAdminDomainComponent: DomainComponentOpticBuilder<AnyDomainEntity, import("./index.js").Admin, $Map, PublishedData, SessionData, Record<string, unknown>, Aliases, never, never, never>;
-export declare const commonAdminComponents: import("../components/domain-component-optic.js").DomainComponentSimpleOptic<AnyDomainEntity, import("./index.js").Admin, PublishedData, SessionData, Record<string, unknown>, import("./index.js").Preset, import("../index.js").SystemComponentType<"attributeSelection", import("../index.js").AttributeSelectionComponentState, "value">>[];
+export declare const commonAdminComponents: import("../index.js").DomainComponentSimpleOptic<AnyDomainEntity, import("./index.js").Admin, PublishedData, SessionData, Record<string, unknown>, import("./index.js").Preset, import("../index.js").SystemComponentType<"attributeSelection", import("../index.js").AttributeSelectionComponentState, "value">>[];
 /**
  * Type-level carrier for the common-admin builder shape consumed by `createAdminInterface`.
  *

package/dist/domain/admin-domain/index.js

@@ -1 +1 @@
-import{DomainComponentOpticBuilder as o}from"../components/domain-component-optic.js";import{RecipeFactoryBuilder as e}from"../domain-context/index.js";import{attributeSelectionComponent as n}from"../system-components/index.js";import{AnyDomainEntity as m,PresetCategory as t,aliases as i}from"./__generated/model/index.js";import{DraftId as a}from"./implementation/common-admin-expressions.js";export{migrateCommonAdminDomain}from"./implementation/common-admin-migrations.js";export*from"./__generated/model/index.js";export*from"./implementation/common-admin-expressions.js";export*from"./implementation/common-admin-publish.js";export*from"./schema/index.js";export const createCommonAdminRecipe=e.forAliases(i).forEntities(m.reflections).withDefaults({}).build();export const attachCommonAdminDomainComponent=o.from(i);export const commonAdminComponents=[attachCommonAdminDomainComponent.withEntity("Preset").withComponent(n,"category").attach((o,e)=>{let n=e.entities.filter(t.is);return null===o.categoryId?{value:a,options:n.map(o=>({value:o.id,label:o.name})).concat([{value:a,label:{$lang:{en:"Draft"}}}])}:{value:o.categoryId,options:n.map(o=>({value:o.id,label:o.name}))}},o=>({categoryId:o.value===a?null:o.value}))];export const configuratorBuilder=null;
+import{DomainComponentOpticBuilder as o,RecipeFactoryBuilder as e}from"../core/index.js";import{attributeSelectionComponent as n}from"../system-components/index.js";import{AnyDomainEntity as m,PresetCategory as t,aliases as i}from"./__generated/model/index.js";import{DraftId as a}from"./implementation/common-admin-expressions.js";export{migrateCommonAdminDomain}from"./implementation/common-admin-migrations.js";export*from"./__generated/model/index.js";export*from"./implementation/common-admin-expressions.js";export*from"./implementation/common-admin-publish.js";export*from"./schema/index.js";export const createCommonAdminRecipe=e.forAliases(i).forEntities(m.reflections).withDefaults({}).build();export const attachCommonAdminDomainComponent=o.from(i);export const commonAdminComponents=[attachCommonAdminDomainComponent.withEntity("Preset").withComponent(n,"category").attach((o,e)=>{let n=e.entities.filter(t.is);return null===o.categoryId?{value:a,options:n.map(o=>({value:o.id,label:o.name})).concat([{value:a,label:{$lang:{en:"Draft"}}}])}:{value:o.categoryId,options:n.map(o=>({value:o.id,label:o.name}))}},o=>({categoryId:o.value===a?null:o.value}))];export const configuratorBuilder=null;

package/dist/domain/application/admin-page-factories.d.ts

@@ -1,4 +1,4 @@
-import type { DomainEntityId } from '../core/model.js';
+import type { DomainEntityId } from '../core/index.js';
 import type { AttributeSelectionComponentState } from '../system-components/attribute-selection.js';
 import type { NavigationListItem, NestedNavigationListItem } from '../system-components/navigation-panel-list.js';
 import type { DataCellValue, DataSchema } from './application-config.js';

package/dist/domain/application/application-config.d.ts

@@ -6,12 +6,11 @@ import type { Logger } from '@salsita-ai/common/utils';
 import type { SessionRole, SessionTokenPayload } from '@salsita-ai/contracts/api';
 import type { CellValue } from '@salsita-ai/contracts/webhook';
 import type { AdminIntegrationService } from '#package/react-sdk';
-import type { DomainComponentOptic } from '../components/domain-component-optic.js';
-import type { $DomainEntity, DomainEntity, DomainFactory, ProductPreset, SystemComponentTypeConstraint } from '../core/index.js';
-import type { AnalyticsSystem, DomainContextSystems, TransformerFactory, Transformers } from '../domain-context/index.js';
+import type { $DomainEntity, DomainEntity, DomainFactory, ProductPreset } from '../core/index.js';
+import type { AnalyticsSystem, TransformerFactory } from '../domain-context/index.js';
 import type { RegistrableTransformer } from '../domain-context/transformers/index.js';
-import type { ElementRegistration } from './element-registration.js';
-import type { HandlerRegistration } from './handler-registration.js';
+import type { ProjectModule } from '../project-modules/index.js';
+import type { AssistantResolvedManifest } from './assistant/index.js';
 import type { WebComponentEventDescriptor } from './web-component-event.js';
 import type { WebComponentPropertyDescriptor } from './web-component-property.js';
 export type ImportedTransformer<ENTITIES extends DomainEntity<string>, ALLOWED_ROOT_ENTITIES extends ENTITIES, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>, NAVIGATION_STATES extends string, VIEW_STATES extends string, TOOL_STATES extends string, EXPORT_STATES extends string> = {
@@ -22,6 +21,17 @@ export type SpecTransformer = {
     name: string;
     priority?: number;
 };
+/**
+ * The transformers of an application: the `src/transformers/` files as project modules, and the spec's
+ * `transformers` section, which selects them by name and orders them by priority. A plain-function
+ * export is selected by its file name; a transformer made with `build(name)` by that name, which the spec
+ * parser requires to match the file name with case and dashes ignored. The runtime spec resolves the two
+ * into the factory the store system calls on every update.
+ */
+export interface TransformersConfig {
+    readonly importedTransformers: readonly ProjectModule[];
+    readonly specTransformers: readonly SpecTransformer[];
+}
 export interface DataSchemaPrimitiveField {
     readonly type: 'string' | 'number' | 'integer' | 'boolean';
     readonly enum?: ReadonlyArray<string | number>;
@@ -64,67 +74,6 @@ export type DataSpec = {
 export type ChunksSpec = Readonly<Record<string, {
     readonly scope: string;
 }>>;
-/**
- * Where one exposed assistant GraphQL field reads its value on the `$` entity: a stored field name,
- * or an expression name including its `$`. `localized` marks a localizable value that resolves to a
- * string in the current locale.
- */
-export interface AssistantFieldSource {
-    readonly source: string;
-    readonly localized?: true;
-}
-/**
- * One recipe group the assistant manifest exposes on an entity type: a `childEntityRecipes` instance
- * under `childRecipes`, a `replaceEntityRecipes` instance under `replaceRecipes`. `groupId` is the
- * name the agent addresses the group by, `instanceName` the component instance it reads,
- * `description` the manifest's text replacing the component's group description, and `dryRuns`
- * whether the recipes of the group can be dry-run.
- */
-export interface AssistantRecipeGroup {
-    readonly groupId: string;
-    readonly instanceName: string;
-    readonly description?: string;
-    readonly dryRuns: boolean;
-}
-/**
- * The options edge of one writable field the assistant manifest links to its component. `field` is
- * the delta field of `modify<Type>` the choices are for, `edgeName` the field of `<Type>Meta` that
- * lists them, `componentType` and `instanceName` the component instance they are read from, and
- * `validate` whether `modify<Type>` rejects a value that is not among them, and `dryRuns` whether
- * the choices can be dry-run.
- */
-export interface AssistantFieldOptions {
-    readonly field: string;
-    readonly edgeName: string;
-    readonly componentType: 'materialSwatch' | 'attributeSelection' | 'distanceDimensionSelect';
-    readonly instanceName: string;
-    readonly validate: boolean;
-    readonly dryRuns: boolean;
-}
-/**
- * Experimental assistant manifest generated from the application spec `assistant` section. `sdl` is
- * the GraphQL schema text prepared at parse time; `fields` maps each GraphQL object type's exposed
- * fields (type name → GraphQL field name) to the stored field or expression its resolvers read;
- * `deletableTypes` lists the entity types the `deleteEntity` mutation may delete, with aliases
- * already expanded, and absent means none; `writableFields` maps, per entity type with a
- * `modify<Type>` mutation, each field of its delta input to the stored property it writes, and
- * absent means no entity type is writable; `childRecipes` lists, per entity type with a `meta` field,
- * the recipe groups `meta { childRecipes }` and `addChild` expose, in manifest order, and absent
- * means none; `replaceRecipes` lists the same for `meta { replaceRecipes }` and `replaceEntity`;
- * `fieldOptions` lists, per entity type, the options edges `meta` exposes for its
- * writable fields, and absent means none; `actions` maps each custom `Mutation` field to the
- * declared action it runs, and absent means none. Consumed by the configurator GraphQL system.
- */
-export interface AssistantManifest {
-    readonly sdl: string;
-    readonly fields: Readonly<Record<string, Readonly<Record<string, AssistantFieldSource>>>>;
-    readonly deletableTypes?: readonly string[];
-    readonly writableFields?: Readonly<Record<string, Readonly<Record<string, string>>>>;
-    readonly childRecipes?: Readonly<Record<string, readonly AssistantRecipeGroup[]>>;
-    readonly replaceRecipes?: Readonly<Record<string, readonly AssistantRecipeGroup[]>>;
-    readonly fieldOptions?: Readonly<Record<string, readonly AssistantFieldOptions[]>>;
-    readonly actions?: Readonly<Record<string, string>>;
-}
 export type AdminPagesSpec = {
     readonly presets?: boolean | {
         readonly categoryNavigationState?: string;
@@ -171,9 +120,11 @@ export interface DomainConfig<ENTITIES extends DomainEntity<string>, ALLOWED_ROO
      */
     readonly domainFactory: DomainFactory<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
     /**
-     * Components attached to the domain used for the Application to work.
+     * Components attached to the domain used for the Application to work, as project modules: the
+     * `src/components/` files and the optics a generated file lists. The runtime spec validates and
+     * flattens them.
      */
-    readonly componentOptics: ReadonlyArray<DomainComponentOptic<ENTITIES, ALLOWED_ROOT_ENTITIES, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ENTITIES, SystemComponentTypeConstraint>>;
+    readonly componentOptics: readonly ProjectModule[];
     /**
      * List of languages that the user will be able to provide in multi-lingual text fields in the Admin UI
      */
@@ -352,15 +303,14 @@ export interface ApplicationConfig<ENTITIES extends DomainEntity<string>, ALLOWE
     readonly chunks?: ChunksSpec;
     readonly dataSpec?: DataSpec;
     readonly publishedDataHash?: string;
-    readonly assistant?: AssistantManifest | null;
-    /**
-     * Factory for transformers that will be registered in the store system and called on any update.
-     */
-    readonly createTransformers?: (ctx: DomainContextSystems<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES>) => Transformers<ENTITIES>;
+    readonly assistant?: AssistantResolvedManifest | null;
+    /** The project's transformers; the runtime spec validates the files and builds the store's transformer factory from them. */
+    readonly transformers?: TransformersConfig;
     readonly adminNavigation?: AdminNavigationConfig<ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES> | undefined;
     readonly adminDomain: DomainConfig<ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA>;
-    readonly handlers: ReadonlyArray<HandlerRegistration<any, any>>;
-    readonly elements: readonly ElementRegistration[];
+    /** The `src/handlers/` and `src/elements/` files as project modules; the runtime spec validates and flattens both. */
+    readonly handlers: readonly ProjectModule[];
+    readonly elements: readonly ProjectModule[];
     readonly mount: MountConfig<ENTITIES, ALLOWED_ROOT_ENTITIES, $MAP, NAVIGATION_STATES, VIEW_STATES, TOOL_STATES, EXPORT_STATES, CHAT_CONTEXT, PUBLISHED_DATA, SESSION_DATA, FRONTEND_DATA, ADMIN_ENTITIES, ADMIN_ALLOWED_ROOT_ENTITIES, ADMIN_$MAP, ADMIN_NAVIGATION_STATES, ADMIN_VIEW_STATES>;
 }
 export {};

package/dist/domain/application/assistant/assistant-manifest.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Where one exposed assistant GraphQL field reads its value on the `$` entity: a stored field name,
+ * or an expression name including its `$`. `localized` marks a localizable value that resolves to a
+ * string in the current locale.
+ */
+export interface AssistantFieldSource {
+    readonly source: string;
+    readonly localized?: true;
+}
+/**
+ * One recipe group the assistant manifest exposes on an entity type: a `childEntityRecipes` instance
+ * under `childRecipes`, a `replaceEntityRecipes` instance under `replaceRecipes`. `groupId` is the
+ * name the agent addresses the group by, `instanceName` the component instance it reads,
+ * `description` the manifest's text replacing the component's group description, and `dryRuns`
+ * whether the recipes of the group can be dry-run.
+ */
+export interface AssistantRecipeGroup {
+    readonly groupId: string;
+    readonly instanceName: string;
+    readonly description?: string;
+    readonly dryRuns: boolean;
+}
+/**
+ * The options edge of one writable field the assistant manifest links to its component. `field` is
+ * the delta field of `modify<Type>` the choices are for, `edgeName` the field of `<Type>Meta` that
+ * lists them, `componentType` and `instanceName` the component instance they are read from, and
+ * `validate` whether `modify<Type>` rejects a value that is not among them, and `dryRuns` whether
+ * the choices can be dry-run.
+ */
+export interface AssistantFieldOptions {
+    readonly field: string;
+    readonly edgeName: string;
+    readonly componentType: 'materialSwatch' | 'attributeSelection' | 'distanceDimensionSelect';
+    readonly instanceName: string;
+    readonly validate: boolean;
+    readonly dryRuns: boolean;
+}
+/**
+ * Experimental assistant manifest generated from the application spec `assistant` section. `sdl` is
+ * the GraphQL schema text rebuilt from the resolved manifest; `fields` maps each GraphQL object type's exposed
+ * fields (type name → GraphQL field name) to the stored field or expression its resolvers read;
+ * `deletableTypes` lists the entity types the `deleteEntity` mutation may delete, with aliases
+ * already expanded, and absent means none; `writableFields` maps, per entity type with a
+ * `modify<Type>` mutation, each field of its delta input to the stored property it writes, and
+ * absent means no entity type is writable; `childRecipes` lists, per entity type with a `meta` field,
+ * the recipe groups `meta { childRecipes }` and `addChild` expose, in manifest order, and absent
+ * means none; `replaceRecipes` lists the same for `meta { replaceRecipes }` and `replaceEntity`;
+ * `fieldOptions` lists, per entity type, the options edges `meta` exposes for its
+ * writable fields, and absent means none; `actions` maps each custom `Mutation` field to the
+ * declared action it runs, and absent means none. Consumed by the configurator GraphQL system.
+ */
+export interface AssistantManifest {
+    readonly sdl: string;
+    /** Navigation state fields exposed by the schema; absent means none. Values stay in the SDL. */
+    readonly navigationFields?: ReadonlyArray<'navigationState' | 'viewState' | 'toolState'>;
+    readonly fields: Readonly<Record<string, Readonly<Record<string, AssistantFieldSource>>>>;
+    readonly deletableTypes?: readonly string[];
+    readonly writableFields?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly childRecipes?: Readonly<Record<string, readonly AssistantRecipeGroup[]>>;
+    readonly replaceRecipes?: Readonly<Record<string, readonly AssistantRecipeGroup[]>>;
+    readonly fieldOptions?: Readonly<Record<string, readonly AssistantFieldOptions[]>>;
+    readonly actions?: Readonly<Record<string, string>>;
+}

package/dist/domain/application/assistant/assistant-resolved-manifest.d.ts

@@ -0,0 +1,95 @@
+import type { AssistantFieldOptions, AssistantRecipeGroup } from './assistant-manifest.js';
+/** JSON description of a scalar or recursively nested list, including nullability at each level. */
+export type AssistantValueType = {
+    readonly kind: 'scalar';
+    readonly name: 'Int' | 'Float' | 'String' | 'Boolean' | 'ID' | 'JSON';
+    readonly nonNull: boolean;
+} | {
+    readonly kind: 'list';
+    readonly item: AssistantValueType;
+    readonly nonNull: boolean;
+};
+/** A relation edge resolved against the model at parse time, linked to GraphQL types only during building. */
+export interface AssistantRelationType {
+    readonly kind: 'edge';
+    readonly target: string;
+    readonly cardinality: '1-1' | '0-1' | '0-N' | '1-N';
+}
+/** A field's source and resolved type, carried in the application bundle without GraphQL instances. */
+export interface AssistantResolvedField {
+    readonly name: string;
+    readonly source: string;
+    readonly type: {
+        readonly kind: 'value';
+        readonly type: AssistantValueType;
+    } | AssistantRelationType;
+    readonly localized: boolean;
+    readonly description?: string;
+}
+/** Declared UI state values used to describe the navigation query. */
+export interface AssistantStates {
+    readonly navigationStates: readonly string[];
+    readonly viewStates: readonly string[];
+    readonly toolStates: readonly string[];
+}
+/** Serializable resolved whitelist from which the browser or backend constructs the assistant schema. */
+export interface AssistantResolvedManifest {
+    readonly entityTypes: readonly string[];
+    readonly aliases: Readonly<Record<string, readonly string[]>>;
+    readonly exampleType?: string;
+    readonly fields: Readonly<Record<string, readonly AssistantResolvedField[]>>;
+    readonly states: AssistantStates;
+    readonly deletableTypes: readonly string[];
+    readonly writableTypes: readonly AssistantWritableType[];
+    readonly childRecipes: Readonly<Record<string, AssistantResolvedRecipes>>;
+    readonly replaceRecipes: Readonly<Record<string, AssistantResolvedRecipes>>;
+    readonly optionsEdges: Readonly<Record<string, readonly AssistantResolvedOptionsEdge[]>>;
+    readonly actionFields: readonly AssistantResolvedAction[];
+}
+/** Optional mutation input for one stored field, using its exposed name. */
+export interface AssistantWritableField {
+    readonly name: string;
+    readonly property: string;
+    readonly type: AssistantValueType;
+    readonly description?: string;
+}
+/** One entity type's writable fields, in manifest order. */
+export interface AssistantWritableType {
+    readonly entityType: string;
+    readonly fields: readonly AssistantWritableField[];
+}
+/** Description hints resolved from recipe/option entries; no parse context is retained. */
+export type AssistantResolvedHint = 'sameForAllInstances' | 'constantDuringSession';
+/** Recipe groups and their description hints for one entity type. */
+export interface AssistantResolvedRecipes {
+    readonly groups: readonly AssistantRecipeGroup[];
+    readonly hints: readonly AssistantResolvedHint[];
+}
+/** One options edge, carrying the write-validation contract and schema description hints. */
+export interface AssistantResolvedOptionsEdge {
+    readonly options: AssistantFieldOptions;
+    readonly hints: readonly AssistantResolvedHint[];
+}
+/** An action result field, either an entity edge or a plain JSON-described value. */
+export type AssistantResolvedActionResult = {
+    readonly kind: 'edge';
+    readonly target: string;
+    readonly list: boolean;
+    readonly nullable: boolean;
+    readonly description?: string;
+} | {
+    readonly kind: 'value';
+    readonly type: AssistantValueType;
+    readonly description?: string;
+};
+/** A custom mutation resolved against the declared action, independent of its implementation. */
+export interface AssistantResolvedAction {
+    readonly fieldName: string;
+    readonly actionName: string;
+    readonly description?: string;
+    readonly args: Readonly<Record<string, {
+        readonly type: AssistantValueType;
+        readonly description?: string;
+    }>>;
+    readonly result: Readonly<Record<string, AssistantResolvedActionResult>>;
+}

package/dist/domain/application/assistant/assistant-value-type.d.ts

@@ -0,0 +1,9 @@
+import { type GraphQLInputType, type GraphQLOutputType, GraphQLScalarType } from 'graphql';
+import type { AssistantValueType } from './assistant-resolved-manifest.js';
+/**
+ * Opaque scalar for values the assistant schema does not type: objects, custom TypeScript types and
+ * loose unions. A value is plain serializable data and passes through unchanged.
+ */
+export declare const GraphQLJSON: GraphQLScalarType<unknown, unknown>;
+/** Recreates a GraphQL value type from the JSON descriptor, preserving every list and nullability layer. */
+export declare const createAssistantValueType: (descriptor: AssistantValueType) => GraphQLInputType & GraphQLOutputType;

package/dist/domain/application/assistant/assistant-value-type.js

@@ -0,0 +1 @@
+import{GraphQLBoolean as e,GraphQLFloat as n,GraphQLID as t,GraphQLInt as a,GraphQLList as r,GraphQLNonNull as l,GraphQLScalarType as i,GraphQLString as s}from"graphql";export const GraphQLJSON=new i({name:"JSON",description:"Any JSON value, returned unchanged as plain serializable data."});let o={Int:a,Float:n,String:s,Boolean:e,ID:t,JSON:GraphQLJSON};export const createAssistantValueType=e=>{let n="list"===e.kind?new r(createAssistantValueType(e.item)):o[e.name];return e.nonNull?new l(n):n};

package/dist/domain/application/assistant/build-assistant-manifest.d.ts

@@ -0,0 +1,4 @@
+import type { AssistantManifest } from './assistant-manifest.js';
+import type { AssistantResolvedManifest } from './assistant-resolved-manifest.js';
+/** Constructs the schema and runtime sources exclusively from serializable resolved data. */
+export declare const buildAssistantManifest: (resolved: AssistantResolvedManifest) => Required<AssistantManifest>;