@salsita-ai/sdk 0.50.0-develop.d87b28256e → 0.50.0-develop.d9534cf412

package/dist/domain/spec/model/names/expression-name.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/names/index.d.ts

@@ -0,0 +1,9 @@
+export type * from './action-name.js';
+export type * from './alias-name.js';
+export type * from './entity-or-alias-name.js';
+export type * from './entity-type-name.js';
+export type * from './expression-name.js';
+export type * from './instance-name.js';
+export type * from './invariant-name.js';
+export type * from './shape-property-name.js';
+export type * from './violation-type-name.js';

package/dist/domain/spec/model/names/index.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/names/instance-name.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded component instance name.
+ * User-declared names must start with a letter (e.g. "default", "body", "main").
+ * SDK-derived names may include `$` prefix and `.` separators (e.g. "$top", "Table.$top").
+ */
+export type InstanceName = Branded<'InstanceName', string>;

package/dist/domain/spec/model/names/instance-name.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/names/invariant-name.d.ts

@@ -0,0 +1,3 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** A camelCase identifier for an invariant implementation declared in YAML. */
+export type InvariantName = Branded<'InvariantName', string>;

package/dist/domain/spec/model/names/invariant-name.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/names/shape-property-name.d.ts

@@ -0,0 +1,11 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded shape property name — the key under which an entity shape (or
+ * alias shape) declares a field, and the key under which `defaults:` attaches
+ * initial values. Must match /^[a-z]\w*$/: start with a lowercase letter,
+ * then word characters (letters, digits, underscore).
+ *
+ * Examples: `height`, `positionX`, `hoodId`. Rejected: `Height`, `$height`,
+ * `3D`, `height-px`.
+ */
+export type ShapePropertyName = Branded<'ShapePropertyName', string>;

package/dist/domain/spec/model/names/shape-property-name.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/names/violation-type-name.d.ts

@@ -0,0 +1,3 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** A stable violation discriminator returned by an invariant. */
+export type ViolationTypeName = Branded<'ViolationTypeName', string>;

package/dist/domain/spec/model/names/violation-type-name.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/model/presets.d.ts

@@ -0,0 +1,30 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * A single entity within a preset — id, type, and shape properties.
+ * Properties are validated against the entity's schema from ConfigurationSchema.
+ */
+export type PresetEntity = Branded<'PresetEntity', {
+    readonly id: string;
+    readonly type: string;
+    readonly properties: Readonly<Record<string, unknown>>;
+}>;
+/**
+ * A single parsed preset — the root entity type, initial entities, and optional metadata.
+ * Represents one initial configuration state for a configurator deployment. `application-spec`
+ * exports it as `Preset`.
+ */
+export type SpecPreset = Branded<'Preset', {
+    readonly rootEntityType: string;
+    readonly initialDomainEntities: readonly PresetEntity[];
+    readonly name?: string;
+    readonly description?: string;
+    readonly img?: string;
+    readonly imgAlt?: string;
+    readonly detailTitle?: string;
+    readonly detailDescription?: string;
+    readonly tags?: readonly string[];
+}>;
+/** All parsed presets for a parsed configurator or admin model. */
+export type Presets = Branded<'Presets', {
+    readonly presets: readonly SpecPreset[];
+}>;

package/dist/domain/spec/model/presets.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/actions.d.ts

@@ -0,0 +1,23 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { EnhancedJsonSchemaType } from '../../core/index.js';
+import type { JsonSchema } from '../json-schema.js';
+import type { ActionName } from '../model/index.js';
+/** One parameter of an action: its declared schema, and whether a call has to pass it (a nullable param is optional). */
+export interface ActionParam {
+    readonly schema: EnhancedJsonSchemaType;
+    readonly required: boolean;
+}
+/**
+ * One validated action declaration. `params` and `result` keep the enhanced schemas for codegen and
+ * for consumers that expose the action; `paramsSchema` is the AJV-ready object schema of the parameters, with the
+ * refs resolved into `$defs`, which the action system validates the arguments of a call against.
+ */
+export type Action = Branded<'Action', {
+    readonly name: ActionName;
+    readonly description?: string;
+    readonly params: Readonly<Record<string, ActionParam>>;
+    readonly result: Readonly<Record<string, EnhancedJsonSchemaType>>;
+    readonly paramsSchema: JsonSchema;
+}>;
+/** The validated `actions` section: every declared action by name, in declaration order; empty when the spec declares none. */
+export type Actions = Branded<'Actions', ReadonlyMap<ActionName, Action>>;

package/dist/domain/spec/sections/actions.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/app-metadata.d.ts

@@ -0,0 +1,18 @@
+import type { Branded } from '@salsita-ai/common/utils';
+import type { ApplicationVersion } from './application-version.js';
+/**
+ * Validated application metadata — version, auth, infrastructure settings.
+ * Used by codegen for ApplicationVersion export and builder chain methods.
+ */
+export type AppMetadata = Branded<'AppMetadata', {
+    readonly applicationVersion: ApplicationVersion;
+    readonly workspace: boolean;
+    readonly webComponentTag: string | undefined;
+    readonly pageTitle: string | undefined;
+    readonly useAuthHook: boolean;
+    readonly useClerk: boolean;
+    readonly enableAdminRelease: boolean;
+    readonly jsonSchemaValidator: 'ajv' | 'csp-compatible';
+    readonly gltfDecoder: 'js' | 'wasm';
+    readonly collectFinalizeData: boolean;
+}>;

package/dist/domain/spec/sections/app-metadata.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/application-version.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded semantic version (x.y.z) of the application.
+ * Exported by codegen as the `ApplicationVersion` constant and stored as
+ * `applicationVersion` on the deployment record.
+ */
+export type ApplicationVersion = Branded<'ApplicationVersion', string>;

package/dist/domain/spec/sections/application-version.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/chunks.d.ts

@@ -0,0 +1,23 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated published-data chunk name.
+ * Chunk names identify top-level partitions in generated `publishedData`. Data
+ * entries point to these names through their `chunk` field, and the parser adds
+ * the reserved `system` chunk when user chunks exist.
+ */
+export type ChunkName = Branded<'ChunkName', string>;
+/**
+ * A named partition of published data with a scope.
+ * `scope` is typically `'project'` (per-project data) or `'public'` (shared).
+ */
+export interface ChunkDefinition {
+    /** Visibility/storage scope used by runtime data publishing for this chunk. */
+    readonly scope: string;
+}
+/**
+ * Validated chunk definitions, keyed by chunk name.
+ * When any user-defined chunks are present, the reserved `system` chunk is
+ * auto-injected with `scope: 'public'` to carry admin presets/recipes schemas.
+ * When the input is empty, no system injection happens (mirrors domain-spec behavior).
+ */
+export type Chunks = Readonly<Record<ChunkName, ChunkDefinition>>;

package/dist/domain/spec/sections/data-spec/chunks.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.d.ts

@@ -0,0 +1,16 @@
+import type { DataCellValue, DataSchema } from '../../../core/index.js';
+/** Parsed `$data.custom` entry with validated definition and normalized row values. */
+export interface CustomDataSpecEntry {
+    /** Column/property schema for a custom data row, used by admin pages and published-data schemas. */
+    readonly definition: DataSchema;
+    /** Optional published-data chunk that receives this entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether data is manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default rows normalized to the same column order as `definition`. */
+    readonly values?: ReadonlyArray<readonly DataCellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/custom-data-spec-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/data-entry-key.d.ts

@@ -0,0 +1,9 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated `$data` entry key.
+ * This is the stable identifier for a data collection declared under `$data.custom`
+ * or `$data.swatchOptions`. The same key is used when extending published data,
+ * wiring connected/generated admin pages, and linking explicit admin pages through
+ * `connectedDataEntry`.
+ */
+export type DataEntryKey = Branded<'DataEntryKey', string>;

package/dist/domain/spec/sections/data-spec/data-entry-key.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './chunks.js';
+export type * from './custom-data-spec-entry.js';
+export type * from './data-entry-key.js';
+export type * from './parsed-data-spec-entries.js';
+export type * from './swatch-data-spec-entry.js';

package/dist/domain/spec/sections/data-spec/index.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.d.ts

@@ -0,0 +1,10 @@
+import type { CustomDataSpecEntry } from './custom-data-spec-entry.js';
+import type { DataEntryKey } from './data-entry-key.js';
+import type { SwatchDataSpecEntry } from './swatch-data-spec-entry.js';
+/** Validated `$data` entries grouped by their source section. */
+export interface ParsedDataSpecEntries {
+    /** Custom data entries with user-declared schemas. */
+    readonly custom: Readonly<Record<DataEntryKey, CustomDataSpecEntry>>;
+    /** Swatch data entries with the built-in swatch schema. */
+    readonly swatchOptions: Readonly<Record<DataEntryKey, SwatchDataSpecEntry>>;
+}

package/dist/domain/spec/sections/data-spec/parsed-data-spec-entries.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.d.ts

@@ -0,0 +1,14 @@
+import type { CellValue } from '@salsita-ai/contracts/webhook';
+/** Parsed `$data.swatchOptions` entry using the fixed swatch data shape. */
+export interface SwatchDataSpecEntry {
+    /** Optional published-data chunk that receives this swatch entry as an array property. */
+    readonly chunk?: string;
+    /** Ownership mode deciding whether swatches are manual, externally connected, or admin-generated. */
+    readonly kind: 'manual' | 'connected' | 'generated';
+    /** Optional human-readable label used by inferred admin pages and connected-data UI. */
+    readonly title?: string;
+    /** Optional icon name used in inferred admin navigation. */
+    readonly icon?: string;
+    /** Default swatch rows normalized to `SWATCH_DEFINITION` column order. */
+    readonly values?: ReadonlyArray<readonly CellValue[]>;
+}

package/dist/domain/spec/sections/data-spec/swatch-data-spec-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/index.d.ts

@@ -0,0 +1,9 @@
+export type * from './actions.js';
+export type * from './app-metadata.js';
+export type * from './application-version.js';
+export type * from './data-spec/index.js';
+export * from './infra/index.js';
+export type * from './state-value.js';
+export type * from './theme.js';
+export type * from './transformers.js';
+export type * from './ui.js';

package/dist/domain/spec/sections/index.js

@@ -0,0 +1 @@
+export*from"./infra/index.js";

package/dist/domain/spec/sections/infra/acl.d.ts

@@ -0,0 +1,12 @@
+/** The roles of `acl.canCreate`: the users who may create a configuration. */
+export declare const aclRoles: readonly ['anonymous', 'user', 'admin', 'superadmin'];
+/** One role of {@link aclRoles}. */
+export type AclRole = (typeof aclRoles)[number];
+/**
+ * The parsed `acl` section of the application spec: the roles that may create a configuration,
+ * all four when the spec declares none. Code generation passes it to the generated configurator
+ * builder, and the runtime spec carries it to the application.
+ */
+export interface Acl {
+    readonly canCreate: readonly AclRole[];
+}

package/dist/domain/spec/sections/infra/acl.js

@@ -0,0 +1 @@
+export const aclRoles=["anonymous","user","admin","superadmin"];

package/dist/domain/spec/sections/infra/index.d.ts

@@ -0,0 +1,3 @@
+export * from './acl.js';
+export type * from './resource-entry.js';
+export type * from './resources-config.js';

package/dist/domain/spec/sections/infra/index.js

@@ -0,0 +1 @@
+export*from"./acl.js";

package/dist/domain/spec/sections/infra/resource-entry.d.ts

@@ -0,0 +1,46 @@
+/** A resource that links to the configuration. */
+export interface ConfigurationLinkResource {
+    readonly type: 'ConfigurationLink';
+    readonly name: string;
+}
+/** A CSV document of the configuration, generated by the server or stored under `s3Key`. */
+export interface CsvResource {
+    readonly type: 'Csv';
+    readonly name: string;
+    readonly s3Key?: string;
+}
+/** A PDF document of the configuration, generated by the server or stored under `s3Key`. */
+export interface PdfResource {
+    readonly type: 'Pdf';
+    readonly name: string;
+    readonly s3Key?: string;
+}
+/** An image the client renders and uploads under `s3Key`. */
+export interface ClientGeneratedImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly clientGenerated: true;
+    readonly s3Key: string;
+}
+/** An image that already exists at `url`. */
+export interface ExistingImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly exists: true;
+    readonly url: string;
+}
+/** An image the server renders under `s3Key`. */
+export interface GeneratedImageResource {
+    readonly type: 'Image';
+    readonly name: string;
+    readonly s3Key: string;
+}
+/** One of the three kinds of image resource. */
+export type ImageResource = ClientGeneratedImageResource | ExistingImageResource | GeneratedImageResource;
+/**
+ * One entry of the `resources` section of the application spec: a generated or linked resource of a
+ * configuration. A name identifies one resource, so no two entries share a name. Code generation
+ * emits the entries as an array literal, and the union of their names is the type of a resource
+ * name in the project's webhook and frontend code.
+ */
+export type ResourceEntry = ConfigurationLinkResource | CsvResource | PdfResource | ImageResource;

package/dist/domain/spec/sections/infra/resource-entry.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/infra/resources-config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The parsed `resourcesConfig` section of the application spec: the host settings of the
+ * resources, such as the base resources URL and the texture URLs to prefetch. `domain` exports a
+ * different `ResourcesConfig`, the resources part of an application config.
+ */
+export interface SpecResourcesConfig {
+    readonly baseResourcesUrl?: string;
+    readonly prefetchTextureUrls?: readonly string[];
+    readonly deploymentQueryDisabled?: boolean;
+}

package/dist/domain/spec/sections/infra/resources-config.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/state-value.d.ts

@@ -0,0 +1,7 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Branded state value — a valid identifier used as a state enum entry
+ * (e.g. "Default", "overview", "detailView").
+ * Used across navigation, view, tool, and export state dimensions.
+ */
+export type StateValue = Branded<'StateValue', string>;

package/dist/domain/spec/sections/state-value.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/theme.d.ts

@@ -0,0 +1,10 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated theme configuration for the configurator UI.
+ * Preset identifies a built-in theme from getPhoenixThemes(),
+ * options provides partial overrides passed to the theme factory.
+ */
+export type Theme = Branded<'Theme', {
+    readonly preset: string;
+    readonly options: Readonly<Record<string, unknown>>;
+}>;

package/dist/domain/spec/sections/theme.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/transformers.d.ts

@@ -0,0 +1,15 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/** One declared transformer: the name its implementation is registered under, and its priority. */
+export interface TransformerEntry {
+    readonly name: string;
+    readonly priority?: number;
+}
+/**
+ * Validated transformer declarations. Each transformer is applied during
+ * domain state transitions to enforce business rules (e.g. "fixLegsForCircleTop").
+ * Every entry's name must match a file basename in `src/transformers/`
+ * (modulo case + dashes — kebab-case files and camelCase YAML names are
+ * treated as equivalent since runtime matching happens on the `.build('name')`
+ * label, not the filename). `application-spec` exports it as `Transformers`.
+ */
+export type SpecTransformers = Branded<'Transformers', readonly TransformerEntry[]>;

package/dist/domain/spec/sections/transformers.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/spec/sections/ui.d.ts

@@ -0,0 +1,12 @@
+import type { Branded } from '@salsita-ai/common/utils';
+/**
+ * Validated UI configuration for the configurator.
+ * Controls preview behavior, expansion mode, and locale settings.
+ */
+export type Ui = Branded<'Ui', {
+    readonly preview?: 'always' | 'never' | 'auto' | 'hide';
+    readonly alwaysExpand?: boolean;
+    readonly appLoader?: 'legacy' | 'universal';
+    readonly availableLocales: readonly string[];
+    readonly textLanguages?: readonly string[];
+}>;

package/dist/domain/spec/sections/ui.js

@@ -0,0 +1 @@
+export{};

package/dist/domain/system-definitions.js

@@ -1 +1 @@
-import{availableSystemComponents as e}from"./available-system-components.js";import{availableDefinitions as t}from"./core/index.js";export const getAllPhxDefinitions=()=>[...t,...e.map(e=>{let{definitions:t,...n}=e.schema;return n}),...e.flatMap(e=>Object.values(e.schema.definitions??{}).map(t=>{if("object"==typeof t&&"tsType"in t)return t;throw Error(`Schema definition in a component ${e.name} is not an extended json schema! Add a tsType to the schema.`)}))].reduce((e,t)=>{if(!t.tsType)throw Error(`Schema definition is not an extended json schema! Add a tsType to the schema. ${JSON.stringify(t)}`);return e[t.tsType]=t,e},{});
+import{availableSystemComponents as e}from"./available-system-components/index.js";import{availableDefinitions as t}from"./core/index.js";export const getAllPhxDefinitions=()=>[...t,...e.map(e=>{let{definitions:t,...n}=e.schema;return n}),...e.flatMap(e=>Object.values(e.schema.definitions??{}).map(t=>{if("object"==typeof t&&"tsType"in t)return t;throw Error(`Schema definition in a component ${e.name} is not an extended json schema! Add a tsType to the schema.`)}))].reduce((e,t)=>{if(!t.tsType)throw Error(`Schema definition is not an extended json schema! Add a tsType to the schema. ${JSON.stringify(t)}`);return e[t.tsType]=t,e},{});

package/dist/domain/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { memoEval } from './memo-eval.js';
+export { withProfilerLabel } from './profiler-label.js';

package/dist/domain/utils/index.js

@@ -0,0 +1 @@
+export{memoEval}from"./memo-eval.js";export{withProfilerLabel}from"./profiler-label.js";

package/dist/editor/domain-editors/DomainSpecContext.js

@@ -1 +1 @@
-import{jsx as e}from"react/jsx-runtime";import t from"lodash-es/debounce.js";import r from"promise-queue";import{createContext as o,useCallback as n,useContext as i,useEffect as a,useMemo as s,useRef as c,useState as m}from"react";import{match as l}from"ts-pattern";import{ApplicationRuntime as p,BinaryFile as u,RawProjectFiles as d,RuntimeReferenceStore as g,TextFile as f,buildPhoenixDefinitions as S,isConfiguratorModelSchemaCompatible as v,isTextFile as h,parseApplicationFiles as y}from"#package/application-spec";import{findActionImplementationConflicts as E,getAllPhxDefinitions as x}from"#package/domain";import{useApplicationRuntime as A,useMountGuard as C}from"#package/react-sdk";import{useEditorConnection as D}from"../services/EditorConnectionContext.js";import{trpc as I}from"../services/trpc.js";import{applyRuntimeReset as N,applySpecUpdate as w,prepareRuntimeRefresh as P,prepareRuntimeReset as _}from"./apply-spec-update.js";import{useDiagnostics as R}from"./use-diagnostics.js";import{useImplementationFiles as j}from"./use-implementation-files.js";import{getWasmSwcParsers as L}from"./wasm-swc-parsers.js";let k=o(null),T={debug:e=>console.debug(e)},M=e=>e instanceof Error?e.message:String(e);export const DomainSpecProvider=o=>{let{children:i,domainSpec:O,initialRawProjectFiles:b}=o,[$,F]=m(s(()=>O?[{fileName:"domain.yaml",content:O}]:b?b.files.filter(h).map(e=>({fileName:e.name,content:e.content})):[],[O,b])),[z,H]=m(null),q=s(()=>new g,[]),G=s(()=>S(x()),[]),U=c(null),Q=A(),{getImplementationFiles:B}=j(),{diagnostics:V,unreadDiagnosticCount:X,setDiagnostics:Y,pushDiagnostic:Z,clearDiagnostics:J,markDiagnosticsRead:K}=R(),W=s(()=>new r(1,1/0),[]),ee=c(0),et=c(null),{mutateAsync:er}=I.requestSpecFiles.useMutation(),{mutateAsync:eo}=I.save.useMutation(),en=C(),{localMode:ei,connectionStatus:ea}=D(),{data:es}=I.getEditorConfig.useQuery(void 0,{enabled:!ei&&"connected"===ea}),ec=ei||es?.specSync===!0,em=$.length>0?$:void 0,el=s(()=>$.map(e=>e.fileName),[$]),ep=s(()=>t(async e=>{if(!ei&&"connected"===ea&&0!==e.length)try{await eo(e.map(e=>({fileName:e.fileName,content:e.content})))}catch(e){console.error("[DomainSpecContext] Failed to save files to disk:",e)}},1e3),[ei,ea,eo]);a(()=>()=>{ep.cancel()},[ep]);let eu=n(()=>{H(null)},[]),ed=n(async(e,t)=>{F(r=>{let o=r.find(t=>t.fileName===e)?r.map(r=>r.fileName===e?{...r,content:t}:r):[...r,{fileName:e,content:t}];return ep(o),o})},[ep]),eg=n(async(e,t)=>{let r,o,n=()=>en()&&ee.current===t;if(!n())return;let i=d(e.rawProjectFiles.files.map(e=>l(e).with({kind:"text"},e=>f(e.name,e.content)).with({kind:"binary"},e=>u(e.name)).exhaustive()));F(i.files.filter(h).map(e=>({fileName:e.name,content:e.content})));try{r=await L()}catch(e){if(!n())return;Y([{code:"MODULE_ANALYZER_UNAVAILABLE",message:`The editor's module analyzer failed to load: ${e instanceof Error?e.message:String(e)}`,severity:"error",source:"spec",path:[]}]);return}if(!n())return;let a=y({rawProjectFiles:i,phxDefinitions:G},{analyzer:r.analyzer,evalExpressionParser:r.evalExpressionParser,referenceStore:q,logger:T});if(console.info(`[DomainSpecContext] Spec parsed: ${a.ok?"ok":"error"}, ${a.diagnostics.length} diagnostics`),!a.ok)return void Y([...a.errors,...a.diagnostics].map(e=>({...e,source:"spec"})));J();let{applicationSpec:s}=a.value,c=await B({application:a.value,projectRoot:e.projectRoot});if(!n())return;if(c.errors.length>0)return void Y(c.errors.map(e=>({code:e.code,message:e.message,severity:"error",source:"reload",path:[]})));let m=E([...s.configurator.actions.values()].map(e=>String(e.name)),c.actionImplementations??Q.getState().spec.configurator.actionImplementations);if(m.extra.length>0&&console.error(`[DomainSpecContext] Action implementations without a declaration: ${m.extra.join(", ")}`),m.missing.length>0){let e=`Missing action implementations: ${m.missing.join(", ")}. Add each to a default export of phx.domain.implementActions({ ... }) in src/actions/.`;console.error(`[DomainSpecContext] ${e}`),Z({code:"MISSING_ACTION_IMPLEMENTATIONS",message:e,severity:"error",source:"runtime"});return}let g=p(s,q,c.implementations,c.importedTransformers,c.invariantImplementations,c.adminImplementations);if(!g.ok){let e=`Missing expression implementations: ${g.missingExpressions.map(e=>`${e.entityType}.${e.exprName}`).join(", ")}`;console.error(`[DomainSpecContext] ${e}`),Z({code:"MISSING_EXPRESSION_IMPLEMENTATIONS",message:e,severity:"error",source:"runtime"});return}let{runtime:S}=g,x=null===U.current||v(U.current.configurator,s.configurator),A=Q.selectors.environment.getPersistenceConfig();if(!x){let e;if("server"===A.type)return void Z({code:"HOT_RELOAD_MODEL_CHANGE_REQUIRES_RESTART",message:"Domain model changes require an application restart and were not applied.",severity:"error",source:"runtime"});if(!Q.selectors.domainContext.configurator.getInitializationState().isCurrent)return void Q.selectors.domainServices.getLogger().debug("[DomainSpecContext] Skipping the model reset because no configurator session is initialized; the change applies once a session loads under the new spec.");try{e=_({runtime:S,implementationFiles:c,previousSpec:Q.getState().spec})}catch(e){Z({code:"HOT_RELOAD_PREPARE_FAILED",message:M(e),severity:"error",source:"runtime"});return}return Q.selectors.domainServices.getLogger().debug("[DomainSpecContext] Reseeding the reset session directly from the spec preset; onPresetLoadedHandler and ProductSelected analytics are intentionally skipped."),N(Q,e,Q.selectors.domainApplicationContext.configurator.getConfigurationPersistSystem().revisionId$.value),void(U.current=s)}try{o=P({runtime:S,implementationFiles:c,previousSpec:Q.getState().spec})}catch(e){Z({code:"HOT_RELOAD_PREPARE_FAILED",message:M(e),severity:"error",source:"runtime"});return}n()&&(w(Q,o),U.current=s)},[Q,B,en,G,Z,q,Y,J]),ef=c(null),eS=n(e=>{let t=ee.current+1;ee.current=t,et.current={data:e,generation:t},W.add(async()=>{let e=et.current;e&&e.data!==ef.current&&(et.current=null,ef.current=e.data,await eg(e.data,e.generation))})},[eg,W]);I.onSpecChange.useSubscription(void 0,{enabled:!ei&&ec,onData:eS}),a(()=>{!ei&&ec&&er().catch(()=>{console.warn("[DomainSpecContext] Failed to request spec files")})},[er,ei,ec]);let ev=s(()=>({files:em,fileNames:el,updateFile:ed,parsing:!1,parseError:z,clearParseError:eu,diagnostics:V,clearDiagnostics:J,unreadDiagnosticCount:X,markDiagnosticsRead:K}),[em,el,ed,z,eu,V,J,X,K]);return e(k.Provider,{value:ev,children:i})};export const useDomainSpecContext=()=>{let e=i(k);if(null===e)throw Error("useDomainSpecContext must be used within DomainSpecProvider");return e};
+import{jsx as e}from"react/jsx-runtime";import r from"lodash-es/debounce.js";import t from"promise-queue";import{createContext as o,useCallback as n,useContext as i,useEffect as s,useMemo as a,useRef as c,useState as l}from"react";import{match as m}from"ts-pattern";import{ApplicationRuntime as u,BinaryFile as p,RawProjectFiles as d,RuntimeReferenceStore as g,TextFile as f,buildPhoenixDefinitions as v,isConfiguratorModelSchemaCompatible as S,isTextFile as h,parseApplicationFiles as y}from"#package/application-spec";import{createImplementationErrorCollector as E,findActionImplementationConflicts as x,getAllPhxDefinitions as A}from"#package/domain";import{useApplicationRuntime as C,useMountGuard as D}from"#package/react-sdk";import{useEditorConnection as w}from"../services/EditorConnectionContext.js";import{trpc as N}from"../services/trpc.js";import{applyRuntimeReset as P,applySpecUpdate as R,prepareRuntimeRefresh as _,prepareRuntimeReset as j}from"./apply-spec-update.js";import{useDiagnostics as I}from"./use-diagnostics.js";import{useImplementationFiles as L}from"./use-implementation-files.js";import{getWasmSwcParsers as k}from"./wasm-swc-parsers.js";let b=o(null),M={debug:e=>console.debug(e)},O=e=>e instanceof Error?e.message:String(e);export const DomainSpecProvider=o=>{let{children:i,domainSpec:T,initialRawProjectFiles:$}=o,[F,z]=l(a(()=>T?[{fileName:"domain.yaml",content:T}]:$?$.files.filter(h).map(e=>({fileName:e.name,content:e.content})):[],[T,$])),[H,q]=l(null),U=a(()=>new g,[]),G=a(()=>v(A()),[]),Q=c(null),B=C(),{getImplementationFiles:V}=L(),{diagnostics:Y,unreadDiagnosticCount:Z,setDiagnostics:J,pushDiagnostic:K,clearDiagnostics:W,markDiagnosticsRead:X}=I(),ee=a(()=>new t(1,1/0),[]),er=c(0),et=c(null),{mutateAsync:eo}=N.requestSpecFiles.useMutation(),{mutateAsync:en}=N.save.useMutation(),ei=D(),{localMode:es,connectionStatus:ea}=w(),{data:ec}=N.getEditorConfig.useQuery(void 0,{enabled:!es&&"connected"===ea}),el=es||ec?.specSync===!0,em=F.length>0?F:void 0,eu=a(()=>F.map(e=>e.fileName),[F]),ep=a(()=>r(async e=>{if(!es&&"connected"===ea&&0!==e.length)try{await en(e.map(e=>({fileName:e.fileName,content:e.content})))}catch(e){console.error("[DomainSpecContext] Failed to save files to disk:",e)}},1e3),[es,ea,en]);s(()=>()=>{ep.cancel()},[ep]);let ed=n(()=>{q(null)},[]),eg=n(async(e,r)=>{z(t=>{let o=t.find(r=>r.fileName===e)?t.map(t=>t.fileName===e?{...t,content:r}:t):[...t,{fileName:e,content:r}];return ep(o),o})},[ep]),ef=n(async(e,r)=>{let t,o,n=()=>ei()&&er.current===r;if(!n())return;let i=d(e.rawProjectFiles.files.map(e=>m(e).with({kind:"text"},e=>f(e.name,e.content)).with({kind:"binary"},e=>p(e.name)).exhaustive()));z(i.files.filter(h).map(e=>({fileName:e.name,content:e.content})));try{t=await k()}catch(e){if(!n())return;J([{code:"MODULE_ANALYZER_UNAVAILABLE",message:`The editor's module analyzer failed to load: ${e instanceof Error?e.message:String(e)}`,severity:"error",source:"spec",path:[]}]);return}if(!n())return;let s=y({rawProjectFiles:i,phxDefinitions:G},{analyzer:t.analyzer,evalExpressionParser:t.evalExpressionParser,referenceStore:U,logger:M});if(console.info(`[DomainSpecContext] Spec parsed: ${s.ok?"ok":"error"}, ${s.diagnostics.length} diagnostics`),!s.ok)return void J([...s.errors,...s.diagnostics].map(e=>({...e,source:"spec"})));W();let{applicationSpec:a}=s.value,c=await V({application:s.value,projectRoot:e.projectRoot});if(!n())return;if(c.errors.length>0)return void J(c.errors.map(e=>({code:e.code,message:e.message,severity:"error",source:"reload",path:[]})));let l=x([...a.configurator.actions.values()].map(e=>String(e.name)),c.actionImplementations??B.getState().spec.configurator.actionImplementations);if(l.extra.length>0&&console.error(`[DomainSpecContext] Action implementations without a declaration: ${l.extra.join(", ")}`),l.missing.length>0){let e=`Missing action implementations: ${l.missing.join(", ")}. Add each to a default export of phx.domain.implementActions({ ... }) in src/actions/.`;console.error(`[DomainSpecContext] ${e}`),K({code:"MISSING_ACTION_IMPLEMENTATIONS",message:e,severity:"error",source:"runtime"});return}let g=E(),v=u(a,U,c.expressionModules,c.importedTransformers,c.invariantImplementations,c.adminExpressionModules,void 0,void 0,void 0,g);for(let e of g.recorded())console.error(`[DomainSpecContext] ${e.message}`),K({code:e.code,message:e.message,severity:"error",source:"runtime"});if(!v.ok)return void U.clear();let{runtime:A}=v,C=null===Q.current||S(Q.current.configurator,a.configurator),D=B.selectors.environment.getPersistenceConfig();if(!C){let e;if("server"===D.type)return void K({code:"HOT_RELOAD_MODEL_CHANGE_REQUIRES_RESTART",message:"Domain model changes require an application restart and were not applied.",severity:"error",source:"runtime"});if(!B.selectors.domainContext.configurator.getInitializationState().isCurrent)return void B.selectors.domainServices.getLogger().debug("[DomainSpecContext] Skipping the model reset because no configurator session is initialized; the change applies once a session loads under the new spec.");try{e=j({runtime:A,implementationFiles:c,previousSpec:B.getState().spec})}catch(e){K({code:"HOT_RELOAD_PREPARE_FAILED",message:O(e),severity:"error",source:"runtime"});return}for(let r of(B.selectors.domainServices.getLogger().debug("[DomainSpecContext] Reseeding the reset session directly from the spec preset; onPresetLoadedHandler and ProductSelected analytics are intentionally skipped."),P(B,e,B.selectors.domainApplicationContext.configurator.getConfigurationPersistSystem().revisionId$.value),Q.current=a,e.implementationErrors))K({code:r.code,message:r.message,severity:"error",source:"runtime"});return}try{o=_({runtime:A,implementationFiles:c,previousSpec:B.getState().spec})}catch(e){K({code:"HOT_RELOAD_PREPARE_FAILED",message:O(e),severity:"error",source:"runtime"});return}if(n())for(let e of(R(B,o),Q.current=a,o.implementationErrors))K({code:e.code,message:e.message,severity:"error",source:"runtime"})},[B,V,ei,G,K,U,J,W]),ev=c(null),eS=n(e=>{let r=er.current+1;er.current=r,et.current={data:e,generation:r},ee.add(async()=>{let e=et.current;e&&e.data!==ev.current&&(et.current=null,ev.current=e.data,await ef(e.data,e.generation))})},[ef,ee]);N.onSpecChange.useSubscription(void 0,{enabled:!es&&el,onData:eS}),s(()=>{!es&&el&&eo().catch(()=>{console.warn("[DomainSpecContext] Failed to request spec files")})},[eo,es,el]);let eh=a(()=>({files:em,fileNames:eu,updateFile:eg,parsing:!1,parseError:H,clearParseError:ed,diagnostics:Y,clearDiagnostics:W,unreadDiagnosticCount:Z,markDiagnosticsRead:X}),[em,eu,eg,H,ed,Y,W,Z,X]);return e(b.Provider,{value:eh,children:i})};export const useDomainSpecContext=()=>{let e=i(b);if(null===e)throw Error("useDomainSpecContext must be used within DomainSpecProvider");return e};

package/dist/editor/domain-editors/apply-spec-update.d.ts

@@ -1,11 +1,18 @@
-import type { ApplicationRuntime as GeneratedApplicationRuntime } from '#package/application-spec';
-import type { ApplicationSpec as RuntimeApplicationSpec } from '#package/domain';
+import { type ApplicationRuntime as GeneratedApplicationRuntime } from '#package/application-spec';
+import { type ImplementationError, type ApplicationSpec as RuntimeApplicationSpec } from '#package/domain';
 import type { ApplicationRuntime } from '#package/react-sdk';
 import type { ImplementationFiles } from './use-implementation-files.js';
 type ConfiguratorSpec = RuntimeApplicationSpec['configurator'];
 /** Schema-compatible replacement that refreshes live runtime inputs without rebuilding the factory. */
 export interface PreparedRuntimeRefresh {
     readonly nextSpec: RuntimeApplicationSpec;
+    /**
+     * The assistant form elements the next spec declares without a component, or registers without a
+     * declaration. They are reported, not refused: the YAML and the element files change in separate
+     * saves, and the update after the second save must still pair them, which a refused update would
+     * prevent by using up the section's change flag. The panel leaves such an element out.
+     */
+    readonly implementationErrors: readonly ImplementationError[];
 }
 /** Full runtime replacement used when an editor update changes the configurator model schema. */
 export interface PreparedRuntimeReset extends PreparedRuntimeRefresh {
@@ -16,6 +23,7 @@ export interface PrepareRuntimeRefreshInput {
     readonly implementationFiles: ImplementationFiles;
     readonly previousSpec: RuntimeApplicationSpec;
 }
+/** Refreshes the configurator sections of the live spec while the model's schema stays. */
 export declare const prepareRuntimeRefresh: (input: PrepareRuntimeRefreshInput) => PreparedRuntimeRefresh;
 /** Rebuilds every model-owned configurator field for an incompatible schema replacement. */
 export declare const prepareRuntimeReset: (input: PrepareRuntimeRefreshInput) => PreparedRuntimeReset;

package/dist/editor/domain-editors/apply-spec-update.js

@@ -1 +1 @@
-import{resolveImportedTransformers as e}from"#package/domain";import{getPhoenixThemes as t}from"#package/ui-sdk";import{getCustomComponentOptics as n}from"./use-implementation-files.js";let s=s=>{var o;let i,a,{runtime:r,implementationFiles:m,previousSpec:c}=s,p=r.configurator,l=c.configurator,u=m.handlers?.handlers??l.handlers,f=m.handlers?((e,t,n)=>{let s={};for(let o of e)s[o.name]=t?.[o.name]??n?.[o.name]??o.name;return s})(u,m.handlers.nameHashes,l.handlerHashes):l.handlerHashes,d=m.elements?.elements??l.elements,h=m.elements?((e,t,n)=>{let s={},o=0;for(let i of e)if("entity"===i.type||"layout"===i.type)s[i.name]=t?.[i.name]??n?.[i.name]??i.name;else{let e=`icon:${o}`;s[e]=t?.[e]??n?.[e]??`${e}:${i.elements.length}`,o+=1}return s})(d,m.elements.nameHashes,l.elementHashes):l.elementHashes,g=null!==m.customComponentOptics,R=p.componentOptics.changed||g?[...p.componentOptics.optics.map(e=>e.optic),...m.customComponentOptics??n(l.componentOptics)]:l.componentOptics,x=p.transformersRuntime.changed?t=>e(p.transformersRuntime.importedTransformers,p.transformersRuntime.specTransformers,t):l.createTransformers;return{presets:p.presetRuntime.changed?p.presetRuntime.presets:l.presets,theme:p.themeRuntime.changed?(o=p.themeRuntime,i=t(),a=Object.entries(i).find(([e])=>e===o.preset)?.[1]??{},Object.keys(o.options).length>0?{...a,...o.options}:a):l.theme,assistant:p.assistantRuntime.changed?p.assistantRuntime.assistant:l.assistant,navigationStates:p.statesRuntime.changed?p.statesRuntime.navigationStates:l.navigationStates,viewStates:p.statesRuntime.changed?p.statesRuntime.viewStates:l.viewStates,toolStates:p.statesRuntime.changed?p.statesRuntime.toolStates:l.toolStates,exportStates:p.statesRuntime.changed?p.statesRuntime.exportStates:l.exportStates,componentOptics:R,createTransformers:x,handlers:u,handlerHashes:f,elements:d,elementHashes:h}};export const prepareRuntimeRefresh=e=>{let{runtime:t,previousSpec:n}=e,o=n.configurator,i=s(e),a=t.configurator.expressionRuntime.changed?t.configurator.expressionRuntime.merged:o.expressions,r=t.configurator.actionsRuntime.changed?t.configurator.actionsRuntime.definitions:o.actions,m=e.implementationFiles.actionImplementations??o.actionImplementations;return{nextSpec:{...n,configurator:{...o,...i,expressions:a,actions:r,actionImplementations:m}}}};export const prepareRuntimeReset=e=>{let{runtime:t,previousSpec:n}=e,o=n.configurator,i=s(e),a=t.configurator.expressionRuntime.merged,r=t.configurator.actionsRuntime.definitions,m=e.implementationFiles.actionImplementations??o.actionImplementations,c=t.configurator.modelRuntime.domainBuilder.withExpressions(a).withActions(Object.values(r)).withActionImplementations(m).build(),p=i.presets[0];if(void 0===p)throw Error("Cannot reset the configurator after a model change because the application spec has no presets.");return{firstPreset:p,nextSpec:{...n,configurator:{...o,...i,modelVersion:c.context.modelVersion,factory:c,aliasMap:c.context.aliasMap,entityReflections:c.context.entityReflections,$entityReflections:c.context.$entityReflections,expressions:a,actions:r,actionImplementations:m,allowedRootEntityTypes:c.context.allowedRootEntityTypes,migrate:c.context.migrate}}}};let o=(e,t)=>{e.actions.spec.updateSpec(t)};export const applyRuntimeRefresh=(e,t)=>o(e,t.nextSpec);export const applyRuntimeReset=(e,t,n)=>{o(e,t.nextSpec),e.actions.loadedData.completeConfiguratorLoad({initialRevisionId:n,initialEntities:t.firstPreset.initialDomainEntities,modelVersion:t.nextSpec.configurator.modelVersion,rootEntityType:t.firstPreset.rootEntityType,schemaIdentity:t.nextSpec.configurator.factory})};export const applySpecUpdate=(e,t)=>o(e,t.nextSpec);
+import{applicationSpecSlice as e}from"#package/application-spec";import{findAssistantFormElementErrors as t}from"#package/domain";import{getPhoenixThemes as o}from"#package/ui-sdk";let n=e=>({handlers:e.handlers,elements:e.elements,customComponentOptics:e.customComponentOptics,actionImplementations:e.actionImplementations}),r=({configurator:e})=>t(e.assistant?.formElements??[],e.elements);export const prepareRuntimeRefresh=t=>{let i=e({runtime:t.runtime,modules:n(t.implementationFiles),themePresets:o(),previous:t.previousSpec,model:"keep"});return{nextSpec:i,implementationErrors:r(i)}};export const prepareRuntimeReset=t=>{let i=e({runtime:t.runtime,modules:n(t.implementationFiles),themePresets:o(),previous:t.previousSpec,model:"rebuild"}),s=i.configurator.presets[0];if(void 0===s)throw Error("Cannot reset the configurator after a model change because the application spec has no presets.");return{firstPreset:s,nextSpec:i,implementationErrors:r(i)}};let i=(e,t)=>{e.actions.spec.updateSpec(t)};export const applyRuntimeRefresh=(e,t)=>i(e,t.nextSpec);export const applyRuntimeReset=(e,t,o)=>{i(e,t.nextSpec),e.actions.loadedData.completeConfiguratorLoad({initialRevisionId:o,initialEntities:t.firstPreset.initialDomainEntities,modelVersion:t.nextSpec.configurator.modelVersion,rootEntityType:t.firstPreset.rootEntityType,schemaIdentity:t.nextSpec.configurator.factory})};export const applySpecUpdate=(e,t)=>i(e,t.nextSpec);

package/dist/editor/domain-editors/use-implementation-files.d.ts

@@ -1,4 +1,4 @@
-import type { Application, ExpressionImplementations, InvariantImplementations } from '#package/application-spec';
+import type { Application, InvariantImplementations } from '#package/application-spec';
 import { type AnyActionImplementations, type DomainComponentOptic, type DomainEntity, type ElementRegistration, type HandlerRegistration, type ImportedTransformer, type ProjectModule, type SystemComponentTypeConstraint } from '#package/domain';
 type RuntimeData = Record<string, unknown>;
 type RuntimeEntity = DomainEntity<string>;
@@ -21,15 +21,17 @@ export interface ReloadError {
 /**
  * The freshly reloaded (or cached) implementation files needed to build an `ApplicationRuntime`.
  *
- * `implementations`, `adminImplementations`, `invariantImplementations`, `importedTransformers` and `customComponentOptics` always contain the latest
+ * `expressionModules` and `adminExpressionModules` are the expression files as imported, unchecked:
+ * `ApplicationRuntime` checks and merges them with the aliases of the spec being edited.
+ * `expressionModules`, `adminExpressionModules`, `invariantImplementations`, `importedTransformers` and `customComponentOptics` always contain the latest
  * successfully loaded values. So does `actionImplementations`, which is `null` only until the first successful load: a round
  * that loaded them may be dropped before it is applied, and the next round must still carry them.
  * `handlers`/`elements` are `null` when their category did not change this round.
  */
 export interface ImplementationFiles {
-    readonly implementations: ExpressionImplementations;
+    readonly expressionModules: readonly ProjectModule[];
     readonly actionImplementations: AnyActionImplementations | null;
-    readonly adminImplementations?: ExpressionImplementations;
+    readonly adminExpressionModules?: readonly ProjectModule[];
     readonly invariantImplementations: InvariantImplementations;
     readonly importedTransformers: readonly ImportedTransformer[];
     readonly customComponentOptics: readonly ReloadedComponentOptic[] | null;
@@ -41,17 +43,7 @@ export interface GetImplementationFilesProps {
     readonly application: Application;
     readonly projectRoot: string;
 }
-type ResolvedExpressions = ExpressionImplementations;
-/**
- * Validates the expression modules through the resolver the domain builder uses, then expands their
- * aliases. The expansion stays here because the editor rebuilds expressions against the alias map of
- * the spec being edited, where the built app's domain builder holds its own.
- */
-export declare const mergeExpressionModules: (modules: readonly ProjectModule[], aliasMap: Record<string, readonly string[]>) => ResolvedExpressions;
 export declare const mergeComponentOptics: <ComponentOptic>(generatedComponentOptics: readonly ComponentOptic[], customComponentOptics: readonly ComponentOptic[]) => readonly ComponentOptic[];
-export declare const getCustomComponentOptics: <ComponentOptic extends {
-    readonly generated?: boolean;
-}>(componentOptics: readonly ComponentOptic[]) => readonly ComponentOptic[];
 /**
  * Owns the should-reload gating and cross-update caching for project implementation files
  * (expressions, actions, invariants, components, transformers, handlers, elements). Returns `getImplementationFiles`,