@salsita-ai/sdk 0.50.0-develop.f101f4c3c9 → 0.50.0-develop.f354d3576d

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,10 @@
+export type * from './actions.js';
+export type * from './app-metadata.js';
+export type * from './application-version.js';
+export * from './assistant/index.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"./assistant/index.js";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-components/phoenix-entity-elements/child-entity-card-selector.d.ts

@@ -23,9 +23,8 @@ export interface ChildEntityCardSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as fixable errors.
-         * Options that only trigger these violation types will remain enabled but show warnings.
-         * Other violation types will disable the option completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

package/dist/domain/system-components/phoenix-entity-elements/child-entity-list-selector.d.ts

@@ -20,9 +20,8 @@ export interface ChildEntityListSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as warnings rather than errors.
-         * Options that trigger only these violations will remain selectable but show warning tooltips.
-         * Options triggering other violations will be disabled completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

package/dist/domain/system-components/phoenix-entity-elements/child-entity-toggle-selector.d.ts

@@ -20,9 +20,8 @@ export interface ChildEntityToggleSelectorSchema {
          */
         readonly instanceName: string;
         /**
-         * Array of violation type names that should be treated as warnings rather than errors.
-         * Options that trigger only these violations will remain selectable but show warning tooltips.
-         * Options triggering other violations will be disabled completely.
+         * Violation types to leave out of an option's tooltip. An option that would cause a `fatal` or `fixable`
+         * violation stays disabled whatever its type; a transformer that repairs the violation makes the option selectable.
          */
         readonly fixableViolations?: readonly string[];
         /**

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`,

package/dist/editor/domain-editors/use-implementation-files.js

@@ -1 +1 @@
-import{useCallback as e,useRef as n}from"react";import{expandAlias as t,resolveActionModules as a,resolveComponentOpticModules as r,resolveElementModule as o,resolveExpressionModules as s,resolveHandlerModule as i,resolveInvariantModules as l,resolveTransformerModule as m}from"#package/domain";import{importImplementationFile as c}from"./import-implementation-file.js";let p=e=>e instanceof Error?e.message:String(e),f=async(e,n)=>{let t=Date.now();return Promise.all(e.map(async e=>({origin:e,exports:await c(`/@fs/${n}/${e}?t=${t}`)})))},d=async(e,n)=>a(await f(e,n));export const mergeExpressionModules=(e,n)=>{let a={};for(let{expressions:t}of s(e,n))for(let[e,n]of Object.entries(t))a[e]={...a[e],...n};let r={};for(let[e,o]of Object.entries(a))for(let a of t(n,e)){let n=r[a]??{};for(let[t,a]of Object.entries(o))n[t]={...a,origin:{name:t,typeOrAlias:e}};r[a]=n}return r};export const mergeComponentOptics=(e,n)=>e.concat(n);export const getCustomComponentOptics=e=>e.filter(e=>!0!==e.generated);let u=async(e,n,t)=>mergeExpressionModules(await f(e,t),n),g=async(e,n)=>r(await f(e,n)),h=async(e,n)=>l(await f(e,n)),E=async(e,n)=>(await f(e,n)).map(m),F=async(e,n)=>(await f(e,n)).map(e=>({filePath:e.origin,registrations:i(e)})),w=async(e,n)=>(await f(e,n)).map(e=>({filePath:e.origin,registrations:o(e)}));export const useImplementationFiles=()=>{let t=n({}),a=n(null),r=n({}),o=n(0),s=n(null),i=n({}),l=n(null),m=n(null),c=n(null),f=n([]),I=n(null),y=n(null),O=n(new Map),A=n(new Map);return{getImplementationFiles:e(async e=>{let{application:n,projectRoot:R}=e,C=++o.current,{applicationSpec:D,categorizedFiles:L}=n,S=[],x=t.current,M=r.current,_=i.current,$=c.current,b=f.current,v=L.expressionsChanged,N=L.actionsChanged,j=L.componentsChanged,P=L.transformersChanged,H=L.handlersChanged,T=L.elementsChanged,k=Object.fromEntries(L.invariants.map(e=>[e.file.name,e.depHash])),J=l.current,X=JSON.stringify(D.configurator.invariants.entries),V=null===J||m.current!==X||Object.keys(J).length!==L.invariants.length||L.invariants.some(e=>J[e.file.name]!==e.depHash);if(console.info(`[useImplementationFiles] Changed: spec=${L.specChanged}, expressions=${L.expressionsChanged}, actions=${L.actionsChanged}, adminExpressions=${L.adminExpressionsChanged}, transformers=${L.transformersChanged}, handlers=${L.handlersChanged}, elements=${L.elementsChanged}`),v){console.info("[useImplementationFiles] Reloading expression implementations");try{let e=Object.fromEntries(D.configurator.latestModel.aliases);t.current=x=await u(L.expressions.map(e=>e.file.name),e,R)}catch(e){console.warn("[useImplementationFiles] Failed to reload expressions:",e),S.push({code:"RELOAD_EXPRESSIONS_FAILED",message:p(e)})}}let q=a.current;if(N){console.info("[useImplementationFiles] Reloading action implementations");try{a.current=q=await d(L.actions.map(e=>e.file.name),R)}catch(e){console.warn("[useImplementationFiles] Failed to reload actions:",e),S.push({code:"RELOAD_ACTIONS_FAILED",message:p(e)})}}let z=JSON.stringify({projectRoot:R,files:L.adminExpressions.map(e=>[e.file.name,e.depHash]),aliases:[...D.admin.latestModel.aliases]});if(C===o.current&&s.current!==z)try{M=await u(L.adminExpressions.map(e=>e.file.name),Object.fromEntries(D.admin.latestModel.aliases),R),C===o.current&&(r.current=M,s.current=z)}catch(e){S.push({code:"RELOAD_ADMIN_EXPRESSIONS_FAILED",message:p(e)})}if(j){console.info("[useImplementationFiles] Reloading component optics");try{c.current=$=await g(L.components.map(e=>e.file.name),R)}catch(e){console.warn("[useImplementationFiles] Failed to reload components:",e),S.push({code:"RELOAD_COMPONENTS_FAILED",message:p(e)})}}if(V){console.info("[useImplementationFiles] Reloading invariant implementations");try{i.current=_=await h(L.invariants.map(e=>e.file.name),R),l.current=k,m.current=X}catch(e){console.warn("[useImplementationFiles] Failed to reload invariants:",e),S.push({code:"RELOAD_INVARIANTS_FAILED",message:p(e)})}}if(P){console.info("[useImplementationFiles] Reloading transformer implementations");try{f.current=b=await E(L.transformers.map(e=>e.file.name),R)}catch(e){console.warn("[useImplementationFiles] Failed to reload transformers:",e),S.push({code:"RELOAD_TRANSFORMERS_FAILED",message:p(e)})}}let B=null;if(H){console.info("[useImplementationFiles] Reloading handler implementations");try{let e=Object.fromEntries(L.handlers.map(e=>[e.file.name,e.depHash])),n=I.current,t=t=>null===n||n[t]!==e[t],a=A.current,r=L.handlers.map(e=>e.file.name),o=r.filter(e=>t(e)||!a.has(e)),s=await F(o,R),i=new Map(s.map(e=>[e.filePath,e])),l=r.map(e=>{let n=i.get(e)??a.get(e);if(!n)throw Error(`Handler file "${e}" was neither re-imported nor cached from a previous round. This is a hot-reload bookkeeping bug — reload the editor page to recover.`);return n}),m=l.flatMap(e=>e.registrations),c={};for(let{filePath:n,registrations:a}of l){let r=t(n)?e[n]:void 0;if(r)for(let e of a)c[e.name]=r}console.info(`[useImplementationFiles] Staged handlers for registry (${m.length} total)`),B={handlers:m,nameHashes:c},A.current=new Map(l.map(e=>[e.filePath,e])),I.current=e}catch(e){console.warn("[useImplementationFiles] Failed to reload handlers:",e),S.push({code:"RELOAD_HANDLERS_FAILED",message:p(e)})}}let G=null;if(T){console.info("[useImplementationFiles] Reloading element implementations");try{let e=Object.fromEntries(L.elements.map(e=>[e.file.name,e.depHash])),n=y.current,t=t=>null===n||n[t]!==e[t],a=O.current,r=L.elements.map(e=>e.file.name),o=r.filter(e=>t(e)||!a.has(e)),s=await w(o,R),i=new Map(s.map(e=>[e.filePath,e])),l=r.map(e=>{let n=i.get(e)??a.get(e);if(!n)throw Error(`Element file "${e}" was neither re-imported nor cached from a previous round. This is a hot-reload bookkeeping bug — reload the editor page to recover.`);return n}),m=l.flatMap(e=>e.registrations),c={},p=0;for(let{filePath:n,registrations:a}of l){let r=t(n)?e[n]:void 0;for(let e of a){if("entity"===e.type||"layout"===e.type){r&&(c[e.name]=r);continue}r&&(c[`icon:${p}`]=r),p+=1}}console.info(`[useImplementationFiles] Staged elements for registry (${m.length} total)`),G={elements:m,nameHashes:c},O.current=new Map(l.map(e=>[e.filePath,e])),y.current=e}catch(e){console.warn("[useImplementationFiles] Failed to reload elements:",e),S.push({code:"RELOAD_ELEMENTS_FAILED",message:p(e)})}}return{implementations:x,actionImplementations:q,adminImplementations:M,invariantImplementations:_,importedTransformers:b,customComponentOptics:$,handlers:B,elements:G,errors:S}},[])}};
+import{useCallback as e,useRef as n}from"react";import{resolveActionModules as t,resolveComponentOpticModules as a,resolveElementModule as r,resolveHandlerModule as o,resolveInvariantModules as i,resolveTransformerModule as s}from"#package/domain";import{importImplementationFile as l}from"./import-implementation-file.js";let m=e=>e instanceof Error?e.message:String(e),c=async(e,n)=>{let t=Date.now();return Promise.all(e.map(async e=>({origin:e,exports:await l(`/@fs/${n}/${e}?t=${t}`)})))},p=async(e,n)=>t(await c(e,n));export const mergeComponentOptics=(e,n)=>e.concat(n);let u=async(e,n)=>a(await c(e,n)),d=async(e,n)=>i(await c(e,n)),f=async(e,n)=>(await c(e,n)).map(s),h=async(e,n)=>(await c(e,n)).map(e=>({filePath:e.origin,registrations:o(e)})),g=async(e,n)=>(await c(e,n)).map(e=>({filePath:e.origin,registrations:r(e)}));export const useImplementationFiles=()=>{let t=n([]),a=n(null),r=n([]),o=n(0),i=n(null),s=n({}),l=n(null),E=n(null),F=n(null),w=n([]),I=n(null),y=n(null),A=n(new Map),R=n(new Map);return{getImplementationFiles:e(async e=>{let{application:n,projectRoot:O}=e,D=++o.current,{applicationSpec:L,categorizedFiles:S}=n,C=[],_=t.current,$=r.current,v=s.current,x=F.current,N=w.current,M=S.expressionsChanged,P=S.actionsChanged,b=S.componentsChanged,H=S.transformersChanged,T=S.handlersChanged,k=S.elementsChanged,j=Object.fromEntries(S.invariants.map(e=>[e.file.name,e.depHash])),J=l.current,X=JSON.stringify(L.configurator.invariants.entries),V=null===J||E.current!==X||Object.keys(J).length!==S.invariants.length||S.invariants.some(e=>J[e.file.name]!==e.depHash);if(console.info(`[useImplementationFiles] Changed: spec=${S.specChanged}, expressions=${S.expressionsChanged}, actions=${S.actionsChanged}, adminExpressions=${S.adminExpressionsChanged}, transformers=${S.transformersChanged}, handlers=${S.handlersChanged}, elements=${S.elementsChanged}`),M){console.info("[useImplementationFiles] Reloading expression implementations");try{t.current=_=await c(S.expressions.map(e=>e.file.name),O)}catch(e){console.warn("[useImplementationFiles] Failed to reload expressions:",e),C.push({code:"RELOAD_EXPRESSIONS_FAILED",message:m(e)})}}let q=a.current;if(P){console.info("[useImplementationFiles] Reloading action implementations");try{a.current=q=await p(S.actions.map(e=>e.file.name),O)}catch(e){console.warn("[useImplementationFiles] Failed to reload actions:",e),C.push({code:"RELOAD_ACTIONS_FAILED",message:m(e)})}}let z=JSON.stringify({projectRoot:O,files:S.adminExpressions.map(e=>[e.file.name,e.depHash])});if(D===o.current&&i.current!==z)try{$=await c(S.adminExpressions.map(e=>e.file.name),O),D===o.current&&(r.current=$,i.current=z)}catch(e){C.push({code:"RELOAD_ADMIN_EXPRESSIONS_FAILED",message:m(e)})}if(b){console.info("[useImplementationFiles] Reloading component optics");try{F.current=x=await u(S.components.map(e=>e.file.name),O)}catch(e){console.warn("[useImplementationFiles] Failed to reload components:",e),C.push({code:"RELOAD_COMPONENTS_FAILED",message:m(e)})}}if(V){console.info("[useImplementationFiles] Reloading invariant implementations");try{s.current=v=await d(S.invariants.map(e=>e.file.name),O),l.current=j,E.current=X}catch(e){console.warn("[useImplementationFiles] Failed to reload invariants:",e),C.push({code:"RELOAD_INVARIANTS_FAILED",message:m(e)})}}if(H){console.info("[useImplementationFiles] Reloading transformer implementations");try{w.current=N=await f(S.transformers.map(e=>e.file.name),O)}catch(e){console.warn("[useImplementationFiles] Failed to reload transformers:",e),C.push({code:"RELOAD_TRANSFORMERS_FAILED",message:m(e)})}}let B=null;if(T){console.info("[useImplementationFiles] Reloading handler implementations");try{let e=Object.fromEntries(S.handlers.map(e=>[e.file.name,e.depHash])),n=I.current,t=t=>null===n||n[t]!==e[t],a=R.current,r=S.handlers.map(e=>e.file.name),o=r.filter(e=>t(e)||!a.has(e)),i=await h(o,O),s=new Map(i.map(e=>[e.filePath,e])),l=r.map(e=>{let n=s.get(e)??a.get(e);if(!n)throw Error(`Handler file "${e}" was neither re-imported nor cached from a previous round. This is a hot-reload bookkeeping bug — reload the editor page to recover.`);return n}),m=l.flatMap(e=>e.registrations),c={};for(let{filePath:n,registrations:a}of l){let r=t(n)?e[n]:void 0;if(r)for(let e of a)c[e.name]=r}console.info(`[useImplementationFiles] Staged handlers for registry (${m.length} total)`),B={handlers:m,nameHashes:c},R.current=new Map(l.map(e=>[e.filePath,e])),I.current=e}catch(e){console.warn("[useImplementationFiles] Failed to reload handlers:",e),C.push({code:"RELOAD_HANDLERS_FAILED",message:m(e)})}}let G=null;if(k){console.info("[useImplementationFiles] Reloading element implementations");try{let e=Object.fromEntries(S.elements.map(e=>[e.file.name,e.depHash])),n=y.current,t=t=>null===n||n[t]!==e[t],a=A.current,r=S.elements.map(e=>e.file.name),o=r.filter(e=>t(e)||!a.has(e)),i=await g(o,O),s=new Map(i.map(e=>[e.filePath,e])),l=r.map(e=>{let n=s.get(e)??a.get(e);if(!n)throw Error(`Element file "${e}" was neither re-imported nor cached from a previous round. This is a hot-reload bookkeeping bug — reload the editor page to recover.`);return n}),m=l.flatMap(e=>e.registrations),c={},p=0;for(let{filePath:n,registrations:a}of l){let r=t(n)?e[n]:void 0;for(let e of a)if("assistantFormElement"!==e.type){if("entity"===e.type||"layout"===e.type){r&&(c[e.name]=r);continue}r&&(c[`icon:${p}`]=r),p+=1}}console.info(`[useImplementationFiles] Staged elements for registry (${m.length} total)`),G={elements:m,nameHashes:c},A.current=new Map(l.map(e=>[e.filePath,e])),y.current=e}catch(e){console.warn("[useImplementationFiles] Failed to reload elements:",e),C.push({code:"RELOAD_ELEMENTS_FAILED",message:m(e)})}}return{expressionModules:_,actionImplementations:q,adminExpressionModules:$,invariantImplementations:v,importedTransformers:N,customComponentOptics:x,handlers:B,elements:G,errors:C}},[])}};

package/dist/editor/graphql/GraphQLPanel.js

@@ -1 +1 @@
-import{jsx as e,jsxs as t}from"react/jsx-runtime";import o from"@monaco-editor/react";import{Box as r,Checkbox as i,FormControlLabel as a,Stack as n,Typography as s}from"@mui/material";import{useState as l}from"react";import{EditorButton as m}from"../common/EditorButton.js";import{jsonEditorOptions as d}from"../common/monaco-config.js";import{useOptionalConfigurator as c,useOptionalDomain as p}from"../hooks/use-optional-runtime.js";import{splitOperations as u}from"./split-operations.js";let h={fontSize:"12px",fontWeight:600,color:"text.secondary"};export const GraphQLPanel=()=>{let f=c()?.graphQLSystem,g=p()?.storeSystem,[x,y]=l("query { root { id type } }"),[b,v]=l(""),[S,k]=l(!1),[j,N]=l(null),[C,w]=l(null),[z,J]=l(!1),O=async()=>{let e=u(x),t=(e=>{if(""===e.trim())return{ok:!0,variables:void 0};try{let t=JSON.parse(e);return"object"!=typeof t||null===t||Array.isArray(t)?{ok:!1,message:"Variables must be a JSON object. Wrap them in {} or clear the field."}:{ok:!0,variables:t}}catch(e){return{ok:!1,message:`Variables are not valid JSON: ${e instanceof Error?e.message:String(e)}. Fix the JSON or clear the field.`}}})(b);if(f){if(w(null),!e.ok)return void N(e.message);if(!t.ok)return void N(t.message);if(S&&!g?.isInitialized)return void N("The configuration is not loaded yet, so there is no state to run against. Run again once the configurator has finished loading.");J(!0);try{let o=e.operations.map(e=>({...e,variables:t.variables})),r=S&&g?await f.prepare(g.stateSlices.committed.value.state,o):void 0,{results:i,committed:a,message:n,sideEffects:s}=r?{results:r.map(({result:e})=>e),committed:!1,message:"Dry run: nothing was committed.",sideEffects:f.readSideEffects(r)}:await f.execute(o),l=i.map((t,o)=>({operationName:e.operations[o]?.operationName??null,...t}));N(JSON.stringify(s.length>0?{results:l,sideEffects:s}:l,null,2)),w(a?"Committed as one undo step.":n??"Nothing was committed.")}finally{J(!1)}}};return t(n,{direction:"column",spacing:1.5,sx:{px:1.5,py:1},children:[e(s,{variant:"subtitle2",sx:h,children:"Query"}),e(r,{component:"div",sx:{height:160,border:"1px solid #dee2e6"},children:e(o,{language:"graphql",value:x,onChange:e=>y(e??""),options:d})}),e(s,{variant:"subtitle2",sx:h,children:"Variables (JSON)"}),e(r,{component:"div",sx:{height:80,border:"1px solid #dee2e6"},children:e(o,{language:"json",value:b,onChange:e=>v(e??""),options:d})}),e(a,{control:e(i,{size:"small",checked:S,onChange:e=>{k(e.target.checked)},sx:{p:.5}}),label:"Dry run",sx:{ml:-.5,mr:0,"& .MuiFormControlLabel-label":{fontSize:"12px",color:"#212529"}}}),e(m,{fullWidth:!0,disabled:!f||z,onClick:()=>void O(),children:f?"Run":"Configurator is not ready"}),null!==C&&e(s,{"data-testid":"graphql-status",sx:{fontSize:"12px",color:"text.secondary"},children:C}),null!==j&&e(r,{component:"pre","data-testid":"graphql-result",sx:{m:0,p:1,fontSize:"12px",backgroundColor:"#f8f9fa",overflow:"auto",whiteSpace:"pre-wrap"},children:j})]})};
+import{jsx as e,jsxs as t}from"react/jsx-runtime";import o from"@monaco-editor/react";import{Box as r,Checkbox as i,FormControlLabel as a,Stack as n,Typography as s}from"@mui/material";import{useState as l}from"react";import{EditorButton as m}from"../common/EditorButton.js";import{jsonEditorOptions as d}from"../common/monaco-config.js";import{useOptionalConfigurator as c,useOptionalDomain as p}from"../hooks/use-optional-runtime.js";import{splitOperations as u}from"./split-operations.js";let h={fontSize:"12px",fontWeight:600,color:"text.secondary"};export const GraphQLPanel=()=>{let g=c()?.graphQLSystem,f=p()?.storeSystem,[x,v]=l("query { root { id type } }"),[y,b]=l(""),[S,k]=l(!1),[j,N]=l(null),[w,C]=l(null),[z,J]=l(!1),O=async()=>{let e=u(x),t=(e=>{if(""===e.trim())return{ok:!0,variables:void 0};try{let t=JSON.parse(e);return"object"!=typeof t||null===t||Array.isArray(t)?{ok:!1,message:"Variables must be a JSON object. Wrap them in {} or clear the field."}:{ok:!0,variables:t}}catch(e){return{ok:!1,message:`Variables are not valid JSON: ${e instanceof Error?e.message:String(e)}. Fix the JSON or clear the field.`}}})(y);if(g){if(C(null),!e.ok)return void N(e.message);if(!t.ok)return void N(t.message);if(S&&!f?.isInitialized)return void N("The configuration is not loaded yet, so there is no state to run against. Run again once the configurator has finished loading.");J(!0);try{let o=e.operations.map(e=>({...e,variables:t.variables})),r=S?f?.stateSlices.committed.value.state:void 0,i=r?await g.prepare(r,o):void 0,{results:a,committed:n,message:s,sideEffects:l,warnings:m}=i&&r?{results:i.map(({result:e})=>e),committed:!1,message:"Dry run: nothing was committed.",sideEffects:g.readSideEffects(i),warnings:g.readWarnings(r,i)}:await g.execute(o),d=a.map((t,o)=>({operationName:e.operations[o]?.operationName??null,...t}));N(JSON.stringify(l.length>0||m.length>0?{results:d,...l.length>0?{sideEffects:l}:{},...m.length>0?{warnings:m}:{}}:d,null,2)),C(n?"Committed as one undo step.":s??"Nothing was committed.")}finally{J(!1)}}};return t(n,{direction:"column",spacing:1.5,sx:{px:1.5,py:1},children:[e(s,{variant:"subtitle2",sx:h,children:"Query"}),e(r,{component:"div",sx:{height:160,border:"1px solid #dee2e6"},children:e(o,{language:"graphql",value:x,onChange:e=>v(e??""),options:d})}),e(s,{variant:"subtitle2",sx:h,children:"Variables (JSON)"}),e(r,{component:"div",sx:{height:80,border:"1px solid #dee2e6"},children:e(o,{language:"json",value:y,onChange:e=>b(e??""),options:d})}),e(a,{control:e(i,{size:"small",checked:S,onChange:e=>{k(e.target.checked)},sx:{p:.5}}),label:"Dry run",sx:{ml:-.5,mr:0,"& .MuiFormControlLabel-label":{fontSize:"12px",color:"#212529"}}}),e(m,{fullWidth:!0,disabled:!g||z,onClick:()=>void O(),children:g?"Run":"Configurator is not ready"}),null!==w&&e(s,{"data-testid":"graphql-status",sx:{fontSize:"12px",color:"text.secondary"},children:w}),null!==j&&e(r,{component:"pre","data-testid":"graphql-result",sx:{m:0,p:1,fontSize:"12px",backgroundColor:"#f8f9fa",overflow:"auto",whiteSpace:"pre-wrap"},children:j})]})};

package/dist/editor/screenshot/ScreenshotHandler.js

@@ -1 +1 @@
-import{memo as e,useCallback as r,useRef as t}from"react";import{useOptionalConfigurator as n}from"../hooks/use-optional-runtime.js";import{useEditorConnection as o}from"../services/EditorConnectionContext.js";import{trpc as a}from"../services/trpc.js";export const ScreenshotHandler=e(()=>{let{localMode:e}=o(),i=n(),s=a.submitScreenshot.useMutation(),c=t(!1),l=r(async e=>{if(!c.current){c.current=!0;try{if(!i)return void console.warn("[ScreenshotHandler] configurator context not ready");let r=i.canvasSystem.r3fHandle$.value;if(!r)return void console.warn("[ScreenshotHandler] R3F handle not ready");let{camera:t}=r.get(),n=t.clone(),o=await i.imageRenderingSystem.renderImage({width:e.width,height:e.height,fileFormat:e.fileFormat,camera:n}),a=await o.arrayBuffer(),c=new Uint8Array(a),l="";for(let e=0;e<c.length;e++)l+=String.fromCharCode(c[e]);let u=btoa(l);await s.mutateAsync({requestId:e.requestId,imageBase64:u,fileFormat:e.fileFormat})}catch(e){console.error("[ScreenshotHandler] Failed to capture screenshot:",e)}finally{c.current=!1}}},[i,s]),u=t(l);return u.current=l,a.onScreenshotRequest.useSubscription(void 0,{enabled:!e,onData:e=>{u.current(e)}}),null});
+import{memo as e,useCallback as r,useRef as t}from"react";import{useOptionalConfigurator as o}from"../hooks/use-optional-runtime.js";import{useEditorConnection as n}from"../services/EditorConnectionContext.js";import{trpc as a}from"../services/trpc.js";export const ScreenshotHandler=e(()=>{let{localMode:e}=n(),i=o(),s=a.submitScreenshot.useMutation(),c=t(!1),l=r(async e=>{if(!c.current){c.current=!0;try{if(!i)return void console.warn("[ScreenshotHandler] configurator context not ready");let{camera:r}=(i.canvasSystem.r3fHandle$.value??await i.canvasSystem.waitForCanvas()).get(),t=r.clone(),o=await i.imageRenderingSystem.renderImage({width:e.width,height:e.height,fileFormat:e.fileFormat,camera:t}),n=await o.arrayBuffer(),a=new Uint8Array(n),c="";for(let e=0;e<a.length;e++)c+=String.fromCharCode(a[e]);let l=btoa(c);await s.mutateAsync({requestId:e.requestId,imageBase64:l,fileFormat:e.fileFormat})}catch(e){console.error("[ScreenshotHandler] Failed to capture screenshot:",e)}finally{c.current=!1}}},[i,s]),u=t(l);return u.current=l,a.onScreenshotRequest.useSubscription(void 0,{enabled:!e,onData:e=>{u.current(e)}}),null});