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

package/dist/react-sdk/configurator-ui-elements/ErrorFallbackPropsProvider.d.ts

@@ -0,0 +1,18 @@
+import { type PropsWithChildren } from 'react';
+/** @internal What an error boundary hands its error page: the error it caught and the retry of its children. */
+export interface ErrorFallbackProps {
+    readonly error: unknown;
+    readonly resetErrorBoundary: () => void;
+}
+interface ErrorFallbackPropsProviderProps extends PropsWithChildren {
+    readonly value: ErrorFallbackProps;
+}
+/**
+ * @internal Runtime plumbing for the SDK's own UI. The configurator's error boundaries provide their
+ * props to the error page registered for them through it, because an element slot is typed as taking
+ * only `children`.
+ */
+export declare const ErrorFallbackPropsProvider: (props: ErrorFallbackPropsProviderProps) => import("react/jsx-runtime").JSX.Element;
+/** @internal Exists for the SDK's own UI, whose error pages read their boundary's props through it. */
+export declare const useErrorFallbackProps: () => ErrorFallbackProps;
+export {};

package/dist/react-sdk/configurator-ui-elements/ErrorFallbackPropsProvider.js

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{createContext as e,useContext as o}from"react";let t=e(void 0);export const ErrorFallbackPropsProvider=e=>{let{value:o,children:i}=e;return r(t.Provider,{value:o,children:i})};export const useErrorFallbackProps=()=>{let r=o(t);if(void 0===r)throw Error("An error page of the configurator was rendered without its boundary's props. Only the configurator's error boundaries render these elements, inside ErrorFallbackPropsProvider; render the page through the configurator instead of mounting it directly.");return r};

package/dist/react-sdk/configurator-ui-elements/PlainErrorFallback.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @internal What the error boundary of the whole configurator shows when the UI registers no page for
+ * it: plain markup, so the runtime renders it without a UI library, with a button that retries.
+ */
+export declare const PlainErrorFallback: () => import("react/jsx-runtime").JSX.Element;

package/dist/react-sdk/configurator-ui-elements/PlainErrorFallback.js

@@ -0,0 +1 @@
+import{jsx as r,jsxs as o}from"react/jsx-runtime";import{useCallback as e}from"react";import{useErrorFallbackProps as t}from"./ErrorFallbackPropsProvider.js";export const PlainErrorFallback=()=>{let{resetErrorBoundary:a}=t(),i=e(()=>{a()},[a]);return o("div",{role:"alert",children:[r("p",{children:"The configurator stopped because of an error."}),r("button",{type:"button",onClick:i,children:"Try again"})]})};

package/dist/react-sdk/configurator-ui-elements/configurator-ui-element.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @internal The named elements through which the configurator's runtime renders UI, for the SDK's own
+ * UI. The runtime renders each where the UI belongs, and the configurator's UI registers them in
+ * `defaultConfiguratorElements`, so a project element registered under the same name replaces one.
+ *
+ * With nothing registered the runtime still runs: an error page falls back to plain markup, and the
+ * others render nothing.
+ */
+export declare enum ConfiguratorUiElement {
+    /**
+     * The page the error boundary of the whole configurator shows; it reads the error and the retry from
+     * `useErrorFallbackProps()`.
+     */
+    GeneralErrorFallback = "GeneralErrorFallback",
+    /** The dialog that asks to reload the page once the session finds its deployment replaced. */
+    InvalidDeploymentReload = "InvalidDeploymentReload"
+}

package/dist/react-sdk/configurator-ui-elements/configurator-ui-element.js

@@ -0,0 +1 @@
+var a;export var ConfiguratorUiElement=((a={}).GeneralErrorFallback="GeneralErrorFallback",a.InvalidDeploymentReload="InvalidDeploymentReload",a);

package/dist/react-sdk/configurator-ui-elements/create-configurator-ui-element.d.ts

@@ -0,0 +1,5 @@
+import type { PropsWithChildren } from 'react';
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+import type { ConfiguratorUiElement } from './configurator-ui-element.js';
+/** @internal Registers the SDK's own UI under one of the configurator's named elements. */
+export declare const createConfiguratorUiElement: (name: ConfiguratorUiElement, Element: (props: PropsWithChildren) => JSX.Element) => PhoenixLayoutElementRegistration;

package/dist/react-sdk/configurator-ui-elements/create-configurator-ui-element.js

@@ -0,0 +1 @@
+import{createCustomPhoenixLayoutElement as o}from"#package/domain";export const createConfiguratorUiElement=(e,r)=>o(e,r);

package/dist/react-sdk/configurator-ui-elements/index.d.ts

@@ -0,0 +1,6 @@
+export { ConfiguratorUiElement } from './configurator-ui-element.js';
+export { ConfiguratorUiElementHost } from './ConfiguratorUiElementHost.js';
+export { createConfiguratorUiElement } from './create-configurator-ui-element.js';
+export { ErrorFallbackElement } from './ErrorFallbackElement.js';
+export { type ErrorFallbackProps, useErrorFallbackProps } from './ErrorFallbackPropsProvider.js';
+export { PlainErrorFallback } from './PlainErrorFallback.js';

package/dist/react-sdk/configurator-ui-elements/index.js

@@ -0,0 +1 @@
+export{ConfiguratorUiElement}from"./configurator-ui-element.js";export{ConfiguratorUiElementHost}from"./ConfiguratorUiElementHost.js";export{createConfiguratorUiElement}from"./create-configurator-ui-element.js";export{ErrorFallbackElement}from"./ErrorFallbackElement.js";export{useErrorFallbackProps}from"./ErrorFallbackPropsProvider.js";export{PlainErrorFallback}from"./PlainErrorFallback.js";

package/dist/react-sdk/domain-application-context/BackendDataProvider.js

@@ -1 +1 @@
-import{jsx as a}from"react/jsx-runtime";import{useQuery as e}from"@tanstack/react-query";import{useCallback as r}from"react";import{Loader as t}from"#package/ui-sdk";import{BackendDataValueProvider as n,useProvidedFrontendData as o}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as i,useApplicationRuntimeSelector as d,useAuthenticatedClient as c,useConfiguratorDomainFactory as s,useDomainDataActions as l,useFrontendData as u,useLogger as k}from"../application-runtime/index.js";import{BuiltInLoadingPhase as m,useLoadingPhase as f,useLoadingStateManager as h}from"../loading-state/index.js";let D=e=>a(n,{backendData:d(i().selectors.domainData.getConfiguratorBackendData),children:e.children}),p=n=>{let i=k(),d=s(),p=l(),y=c(),v=u(),{frontendDataLoadKey:w}=o();if(!d)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering BackendDataProvider.");if(void 0===w)throw Error("Frontend data load key not found! Render BackendDataProvider inside FrontendDataProvider so data reloads together.");let B=r(async a=>{try{return{success:!0,data:await y.getBackendData(a)}}catch(e){let a=e instanceof Error?e:Error(`Unknown error ${e}`);return i.warn("Failed to fetch backend data:",{},a),{success:!1}}},[y,i]),b=r(async(a,e)=>{if(!d.hasBackendData)return void p.setBackendData(void 0);let r=await B(a);if(e.throwIfAborted(),!r.success)return void p.setBackendData(void 0);try{let a=d.parseBackendData(r.data);return p.setBackendData(a),a}catch(e){let a=e instanceof Error?e:Error(`Unknown error ${e}`);i.error("Failed to parse backend data:",{backendData:r},a),p.setBackendData(void 0);return}},[d,B,i,p]),{data:g,error:F,isFetching:E}=e({queryKey:["get-backend-data",w],queryFn:async({signal:a})=>({backendData:await b(v,a)}),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1}),x=null!==h();if(f({id:m.BackendData,label:"Loading backend data…"},(void 0===g||E)&&!F),F)throw F;return void 0===g||E?x?null:a(t,{}):a(D,{children:n.children},w)};export const BackendDataProvider=e=>a(p,{...e});
+import{jsx as a}from"react/jsx-runtime";import{useQuery as e}from"@tanstack/react-query";import{useCallback as r}from"react";import{BackendDataValueProvider as t,useProvidedFrontendData as n}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as o,useApplicationRuntimeSelector as d,useAuthenticatedClient as i,useConfiguratorDomainFactory as c,useDomainDataActions as s,useFrontendData as l,useLogger as u}from"../application-runtime/index.js";import{BuiltInLoadingPhase as k,useLoadingPhase as f}from"../loading-state/index.js";let m=e=>a(t,{backendData:d(o().selectors.domainData.getConfiguratorBackendData),children:e.children}),h=t=>{let o=u(),d=c(),h=s(),D=i(),p=l(),{frontendDataLoadKey:y}=n();if(!d)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering BackendDataProvider.");if(void 0===y)throw Error("Frontend data load key not found! Render BackendDataProvider inside FrontendDataProvider so data reloads together.");let v=r(async a=>{try{return{success:!0,data:await D.getBackendData(a)}}catch(e){let a=e instanceof Error?e:Error(`Unknown error ${e}`);return o.warn("Failed to fetch backend data:",{},a),{success:!1}}},[D,o]),w=r(async(a,e)=>{if(!d.hasBackendData)return void h.setBackendData(void 0);let r=await v(a);if(e.throwIfAborted(),!r.success)return void h.setBackendData(void 0);try{let a=d.parseBackendData(r.data);return h.setBackendData(a),a}catch(e){let a=e instanceof Error?e:Error(`Unknown error ${e}`);o.error("Failed to parse backend data:",{backendData:r},a),h.setBackendData(void 0);return}},[d,v,o,h]),{data:B,error:b,isFetching:g}=e({queryKey:["get-backend-data",y],queryFn:async({signal:a})=>({backendData:await w(p,a)}),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1});if(f({id:k.BackendData,label:"Loading backend data…"},(void 0===B||g)&&!b),b)throw b;return void 0===B||g?null:a(m,{children:t.children},y)};export const BackendDataProvider=e=>a(h,{...e});

package/dist/react-sdk/domain-application-context/ConfigurationPersistSystemFailureHandler.js

@@ -1 +1 @@
-import{jsx as r}from"react/jsx-runtime";import{Trans as i}from"@lingui/react";import{Button as e}from"@mui/material";import{useSnackbar as t}from"notistack";import{useCallback as s,useEffect as o,useMemo as n}from"react";import{pairwise as a,startWith as m}from"rxjs";import{P as l,match as p}from"ts-pattern";import{useDomainApplication as u}from"../application-runtime/index.js";import{usePatientObservableValue as c}from"../domain-context/index.js";let d="phx-configuration-persist-system-failure";export const ConfigurationPersistSystemFailureHandler=f=>((f=>{let{disabled:g=!1}=f,{configurationPersistSystem:x}=u(),{enqueueSnackbar:h,closeSnackbar:y}=t(),k=c(n(()=>x.failure$.pipe(a(),m([null,null])),[x.failure$]),[null,null],!g),j=s((t,s)=>{p([t,s]).with([null,null],()=>{}).with([l._,{error:l._}],()=>{h(r(i,{id:"sdk.persist.system.error.message",message:"An error occured when trying to update a configuration"}),{variant:"error",key:d,persist:!0,preventDuplicate:!0,action:t=>r(e,{color:"inherit",size:"small",onClick:()=>{y(t)},children:r(i,{id:"sdk.persist.system.error.dismiss",message:"Dismiss"})})})}).with([{error:l._},null],()=>{y(d),h(r(i,{id:"sdk.persist.system.error.recovered",message:"Configuration updated"}),{variant:"info"})}).exhaustive()},[h,y]),v=s(()=>{y(d)},[y]);o(()=>{g?v():j(k[0],k[1])},[g,k,j,v])})(f),null);
+import{jsx as r}from"react/jsx-runtime";import{Trans as e}from"@lingui/react";import{useSnackbar as i}from"notistack";import{useCallback as t,useEffect as s,useMemo as o}from"react";import{pairwise as n,startWith as a}from"rxjs";import{P as m,match as l}from"ts-pattern";import{useDomainApplication as u}from"../application-runtime/index.js";import{usePatientObservableValue as p}from"../domain-context/index.js";let d="phx-configuration-persist-system-failure";export const ConfigurationPersistSystemFailureHandler=f=>((f=>{let{disabled:c=!1}=f,{configurationPersistSystem:g}=u(),{enqueueSnackbar:x,closeSnackbar:y}=i(),h=p(o(()=>g.failure$.pipe(n(),a([null,null])),[g.failure$]),[null,null],!c),k=t((i,t)=>{l([i,t]).with([null,null],()=>{}).with([m._,{error:m._}],()=>{x(r(e,{id:"sdk.persist.system.error.message",message:"An error occured when trying to update a configuration"}),{variant:"error",key:d,persist:!0,preventDuplicate:!0,actionButton:{label:r(e,{id:"sdk.persist.system.error.dismiss",message:"Dismiss"}),onClick:r=>{y(r)}}})}).with([{error:m._},null],()=>{y(d),x(r(e,{id:"sdk.persist.system.error.recovered",message:"Configuration updated"}),{variant:"info"})}).exhaustive()},[x,y]),j=t(()=>{y(d)},[y]);s(()=>{c?j():k(h[0],h[1])},[c,h,k,j])})(f),null);

package/dist/react-sdk/domain-application-context/FrontendDataProvider.js

@@ -1 +1 @@
-import{jsx as t}from"react/jsx-runtime";import{useQuery as e}from"@tanstack/react-query";import{useCallback as r}from"react";import{Loader as a}from"#package/ui-sdk";import{FrontendDataValueProvider as n,useProvidedPublishedData as o}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as d,useApplicationRuntimeSelector as i,useConfiguratorDomainFactory as s,useDomainDataActions as c,useLogger as l,usePublishedData as u,useSession as f,useWebComponentApi as m}from"../application-runtime/index.js";import{BuiltInLoadingPhase as h,useLoadingPhase as D,useLoadingStateManager as y}from"../loading-state/index.js";import{CollectFrontendDataHandlerBoundary as p,useCollectFrontendDataHandler as F}from"./CollectFrontendDataHandler.js";let w=e=>t(n,{frontendData:i(d().selectors.domainData.getConfiguratorFrontendData),frontendDataLoadKey:e.frontendDataLoadKey,children:e.children}),g=n=>{let d=l(),i=s(),p=c(),g=f(),v=u(),{publishedDataLoadKey:P}=o(),{getPropertyValue:b}=m(),k=F();if(!i)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering FrontendDataProvider.");if(void 0===P)throw Error("Published data load key not found! Render FrontendDataProvider inside PublishedDataProvider so data reloads together.");let E=r(async t=>{if(null==k)return{success:!1};try{return{success:!0,data:await k({sessionData:g.sessionPayload?.data??{},publishedData:t,getWebComponentPropertyValue:b})}}catch(e){let t=e instanceof Error?e:Error(`Unknown error ${e}`);return d.warn("Failed to collect frontend data, the collectFrontendData function threw an error, have you provided collectFrontendData function? Does it return data matching the frontendData spec defined in your domain?",{},t),{success:!1}}},[k,b,d,g.sessionPayload?.data]),j=r(async(t,e)=>{let r=await E(t);if(e.throwIfAborted(),!r.success)return p.setFrontendData({}),{};try{let t=i.parseFrontendData(r.data);return d.debug("Collected frontend data:",t),p.setFrontendData(t),t}catch(e){let t=e instanceof Error?e:Error(`Unknown error ${e}`);return d.error("Failed to parse frontend data:",{frontendData:r},t),p.setFrontendData({}),{}}},[i,E,d,p]),{data:x,error:K,isFetching:L}=e({queryKey:["get-frontend-data",P],queryFn:async({signal:t})=>j(v,t),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1}),q=null!==y();if(D({id:h.FrontendData,label:"Loading frontend data…"},(void 0===x||L)&&!K),K)throw K;return void 0===x||L?q?null:t(a,{}):t(w,{frontendDataLoadKey:P,children:n.children},P)};export const FrontendDataProvider=e=>t(p,{children:t(g,{...e})});
+import{jsx as t}from"react/jsx-runtime";import{useQuery as e}from"@tanstack/react-query";import{useCallback as r}from"react";import{FrontendDataValueProvider as a,useProvidedPublishedData as n}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as o,useApplicationRuntimeSelector as d,useConfiguratorDomainFactory as i,useDomainDataActions as s,useLogger as c,usePublishedData as l,useSession as u,useWebComponentApi as f}from"../application-runtime/index.js";import{BuiltInLoadingPhase as h,useLoadingPhase as m}from"../loading-state/index.js";import{CollectFrontendDataHandlerBoundary as D,useCollectFrontendDataHandler as y}from"./CollectFrontendDataHandler.js";let p=e=>t(a,{frontendData:d(o().selectors.domainData.getConfiguratorFrontendData),frontendDataLoadKey:e.frontendDataLoadKey,children:e.children}),F=a=>{let o=c(),d=i(),D=s(),F=u(),w=l(),{publishedDataLoadKey:g}=n(),{getPropertyValue:v}=f(),P=y();if(!d)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering FrontendDataProvider.");if(void 0===g)throw Error("Published data load key not found! Render FrontendDataProvider inside PublishedDataProvider so data reloads together.");let b=r(async t=>{if(null==P)return{success:!1};try{return{success:!0,data:await P({sessionData:F.sessionPayload?.data??{},publishedData:t,getWebComponentPropertyValue:v})}}catch(e){let t=e instanceof Error?e:Error(`Unknown error ${e}`);return o.warn("Failed to collect frontend data, the collectFrontendData function threw an error, have you provided collectFrontendData function? Does it return data matching the frontendData spec defined in your domain?",{},t),{success:!1}}},[P,v,o,F.sessionPayload?.data]),E=r(async(t,e)=>{let r=await b(t);if(e.throwIfAborted(),!r.success)return D.setFrontendData({}),{};try{let t=d.parseFrontendData(r.data);return o.debug("Collected frontend data:",t),D.setFrontendData(t),t}catch(e){let t=e instanceof Error?e:Error(`Unknown error ${e}`);return o.error("Failed to parse frontend data:",{frontendData:r},t),D.setFrontendData({}),{}}},[d,b,o,D]),{data:j,error:x,isFetching:k}=e({queryKey:["get-frontend-data",g],queryFn:async({signal:t})=>E(w,t),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1});if(m({id:h.FrontendData,label:"Loading frontend data…"},(void 0===j||k)&&!x),x)throw x;return void 0===j||k?null:t(p,{frontendDataLoadKey:g,children:a.children},g)};export const FrontendDataProvider=e=>t(D,{children:t(F,{...e})});

package/dist/react-sdk/domain-application-context/OnPresetLoadedHandler.js

@@ -0,0 +1 @@
+import{createSystemPhoenixAsyncHandler as e}from"#package/domain";import{useSystemPhoenixAsyncHandler as r}from"../handlers/index.js";let d="OnPresetLoadedHandler";export const createOnPresetLoadedHandler=r=>e(d,r);export const useOnPresetLoadedHandler=()=>r(d)?.handler;

package/dist/react-sdk/domain-application-context/PublishedDataProvider.js

@@ -1 +1 @@
-import{jsx as e}from"react/jsx-runtime";import{useQuery as t}from"@tanstack/react-query";import r from"lodash-es/uniq.js";import{useCallback as a,useMemo as i}from"react";import{SYSTEM_CHUNK_KEY as n}from"#package/domain";import{Loader as s}from"#package/ui-sdk";import{PublishedDataValueProvider as o}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as l,useApplicationRuntimeSelector as d,useAuthenticatedClient as u,useConfiguratorDomainFactory as h,useDomainDataActions as c,useLogger as p,usePersistenceConfig as m,useSession as f,useSpecChunks as b,useSpecInitialPublishedData as y,useSpecPublishedDataHash as k}from"../application-runtime/index.js";import{BuiltInLoadingPhase as g,useLoadingPhase as P,useLoadingStateManager as w}from"../loading-state/index.js";import{FilterPublishedChunksHandlerBoundary as D,useFilterPublishedChunksHandler as v}from"./FilterPublishedChunksHandler.js";export const getAccessibleChunkKeys=(e,t)=>{let r=new Set((t??[]).map(String));return Object.keys(e).filter(t=>{if(t===n)return!0;let a=e[t];return null!=a&&r.has(a.scope)})};export const resolveChunkKeysToFetch=e=>{let{chunksSpec:t,chunkScopes:a,filteredChunkKeys:i}=e,s=i??getAccessibleChunkKeys(t,a);if(null!=i){let e=i.filter(e=>e!==n&&null==t[e]);if(e.length>0)throw Error(`createFilterPublishedChunksHandler returned unknown chunk keys: ${e.join(", ")}.`)}return r([...s,n].map(String))};let j=t=>e(o,{publishedData:d(l().selectors.domainData.getConfiguratorPublishedData),publishedDataLoadKey:t.publishedDataLoadKey,children:t.children}),F=r=>{let n=f(),o=p(),l=m(),d=b(),D=k(),F=y(),C=u(),E=h(),x=c();if(!E)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering PublishedDataProvider.");let S=v(),K=n.sessionPayload?.chunkScopes,O=i(()=>{if(null==d||0===Object.keys(d).length)return;if(null==D)throw Error("publishedDataHash is required when chunks are defined. Use withPublishedDataHash() in ConfiguratorBuilder.");let e=S?.();return resolveChunkKeysToFetch({chunksSpec:d,chunkScopes:K,filteredChunkKeys:e})},[d,K,S,D]),A=i(()=>JSON.stringify(O??null),[O]),R=i(()=>JSON.stringify(F),[F]),q=a(async e=>{let t=await Promise.all(e.map(async e=>{try{let t=await C.getPublishedChunk(e,D);if(null==t){let t=F[e];if(t&&"object"==typeof t)return{key:e,data:t};return{key:e,data:{}}}return{key:e,data:t}}catch(t){return o.error("Failed to fetch published chunk",{key:e},t instanceof Error?t:Error(String(t))),{key:e,data:{}}}})),r={};for(let e of t)r[e.key]=e.data;return{success:!0,data:r}},[C,o,F,D]),H=a(async()=>{if("memory"===l.type||"local-storage"===l.type)return{success:!0,data:F};if(null!=O)return 0===O.length?{success:!0,data:{}}:q(O);let e=n.sessionPayload?.publishedAdminRevisionPath;if(null==e)return{success:!1};try{let t=await fetch(e);return{success:!0,data:await t.json()}}catch(r){let t=r instanceof Error?r:Error(`Unknown error ${r}`);return o.warn("Failed to fetch published data, the published data endpoint returned an error, have you published data from the admin? Check if the published data is accessible.",{path:e},t),{success:!1}}},[o,l,F,n.sessionPayload?.publishedAdminRevisionPath,O,q]),L=a(async e=>{let t=await H();if(e.throwIfAborted(),!t.success)return x.setPublishedData(F),F;try{let e=E.parsePublishedData(t.data);return o.debug("Fetched published admin revision data:",e),x.setPublishedData(e),e}catch(r){let e=r instanceof Error?r:Error(`Unknown error ${r}`);return o.error("Failed to parse published data, the data structure does not match the expected schema, does the published data match the publishedData schema defined in your domain?",{json:t},e),x.setPublishedData(F),F}},[o,E,H,F,x]),J=i(()=>["get-published-admin-data",n.sessionPayload?.publishedAdminRevisionPath,A,D,R],[A,R,D,n.sessionPayload?.publishedAdminRevisionPath]),N=i(()=>JSON.stringify(J),[J]),{data:U,error:$,isFetching:T}=t({queryKey:J,queryFn:({signal:e})=>L(e),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1}),B=null!==w();if(P({id:g.PublishedData,label:"Loading published data…"},(void 0===U||T)&&!$),$)throw $;return void 0===U||T?B?null:e(s,{}):e(j,{publishedDataLoadKey:N,children:r.children},N)};export const PublishedDataProvider=t=>e(D,{children:e(F,{...t})});
+import{jsx as e}from"react/jsx-runtime";import{useQuery as t}from"@tanstack/react-query";import r from"lodash-es/uniq.js";import{useCallback as a,useMemo as i}from"react";import{SYSTEM_CHUNK_KEY as n}from"#package/domain";import{PublishedDataValueProvider as s}from"../application-runtime/hooks/data/index.js";import{useApplicationRuntime as o,useApplicationRuntimeSelector as l,useAuthenticatedClient as d,useConfiguratorDomainFactory as u,useDomainDataActions as h,useLogger as c,usePersistenceConfig as p,useSession as f,useSpecChunks as m,useSpecInitialPublishedData as b,useSpecPublishedDataHash as y}from"../application-runtime/index.js";import{BuiltInLoadingPhase as P,useLoadingPhase as g}from"../loading-state/index.js";import{FilterPublishedChunksHandlerBoundary as k,useFilterPublishedChunksHandler as w}from"./FilterPublishedChunksHandler.js";export const getAccessibleChunkKeys=(e,t)=>{let r=new Set((t??[]).map(String));return Object.keys(e).filter(t=>{if(t===n)return!0;let a=e[t];return null!=a&&r.has(a.scope)})};export const resolveChunkKeysToFetch=e=>{let{chunksSpec:t,chunkScopes:a,filteredChunkKeys:i}=e,s=i??getAccessibleChunkKeys(t,a);if(null!=i){let e=i.filter(e=>e!==n&&null==t[e]);if(e.length>0)throw Error(`createFilterPublishedChunksHandler returned unknown chunk keys: ${e.join(", ")}.`)}return r([...s,n].map(String))};let D=t=>e(s,{publishedData:l(o().selectors.domainData.getConfiguratorPublishedData),publishedDataLoadKey:t.publishedDataLoadKey,children:t.children}),v=r=>{let n=f(),s=c(),o=p(),l=m(),k=y(),v=b(),j=d(),F=u(),C=h();if(!F)throw Error("DomainFactory is not available in the runtime registry. Ensure replaceDomainRuntime() is called with domainFactory before rendering PublishedDataProvider.");let E=w(),x=n.sessionPayload?.chunkScopes,S=i(()=>{if(null==l||0===Object.keys(l).length)return;if(null==k)throw Error("publishedDataHash is required when chunks are defined. Use withPublishedDataHash() in ConfiguratorBuilder.");let e=E?.();return resolveChunkKeysToFetch({chunksSpec:l,chunkScopes:x,filteredChunkKeys:e})},[l,x,E,k]),K=i(()=>JSON.stringify(S??null),[S]),O=i(()=>JSON.stringify(v),[v]),A=a(async e=>{let t=await Promise.all(e.map(async e=>{try{let t=await j.getPublishedChunk(e,k);if(null==t){let t=v[e];if(t&&"object"==typeof t)return{key:e,data:t};return{key:e,data:{}}}return{key:e,data:t}}catch(t){return s.error("Failed to fetch published chunk",{key:e},t instanceof Error?t:Error(String(t))),{key:e,data:{}}}})),r={};for(let e of t)r[e.key]=e.data;return{success:!0,data:r}},[j,s,v,k]),R=a(async()=>{if("memory"===o.type||"local-storage"===o.type)return{success:!0,data:v};if(null!=S)return 0===S.length?{success:!0,data:{}}:A(S);let e=n.sessionPayload?.publishedAdminRevisionPath;if(null==e)return{success:!1};try{let t=await fetch(e);return{success:!0,data:await t.json()}}catch(r){let t=r instanceof Error?r:Error(`Unknown error ${r}`);return s.warn("Failed to fetch published data, the published data endpoint returned an error, have you published data from the admin? Check if the published data is accessible.",{path:e},t),{success:!1}}},[s,o,v,n.sessionPayload?.publishedAdminRevisionPath,S,A]),q=a(async e=>{let t=await R();if(e.throwIfAborted(),!t.success)return C.setPublishedData(v),v;try{let e=F.parsePublishedData(t.data);return s.debug("Fetched published admin revision data:",e),C.setPublishedData(e),e}catch(r){let e=r instanceof Error?r:Error(`Unknown error ${r}`);return s.error("Failed to parse published data, the data structure does not match the expected schema, does the published data match the publishedData schema defined in your domain?",{json:t},e),C.setPublishedData(v),v}},[s,F,R,v,C]),H=i(()=>["get-published-admin-data",n.sessionPayload?.publishedAdminRevisionPath,K,k,O],[K,O,k,n.sessionPayload?.publishedAdminRevisionPath]),L=i(()=>JSON.stringify(H),[H]),{data:J,error:N,isFetching:U}=t({queryKey:H,queryFn:({signal:e})=>q(e),refetchOnMount:"always",refetchOnWindowFocus:!1,refetchOnReconnect:!1});if(g({id:P.PublishedData,label:"Loading published data…"},(void 0===J||U)&&!N),N)throw N;return void 0===J||U?null:e(D,{publishedDataLoadKey:L,children:r.children},L)};export const PublishedDataProvider=t=>e(k,{children:e(v,{...t})});

package/dist/react-sdk/domain-application-context/chat-hooks.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @internal Runtime plumbing for the SDK's own legacy chat UI, which reads it to show or hide the chat.
+ */
+export declare const useChatEnabled: () => boolean;

package/dist/react-sdk/domain-application-context/chat-hooks.js

@@ -0,0 +1 @@
+import{useMemo as t}from"react";import{applicationConfigComponent as n}from"#package/domain";import{useLogger as o}from"../application-runtime/index.js";import{useComponents as e}from"../domain-context/index.js";export const useChatEnabled=()=>{let i=o(),a=e({componentTypes:[n]});return t(()=>(a.length>1&&i.warn("Multiple application configs found, using the first one!",{applicationConfigs:a}),a[0]?.state.chatEnabled??!0),[a,i])};

package/dist/react-sdk/domain-application-context/index.d.ts

@@ -5,3 +5,5 @@ export { BackendDataProvider, type BackendDataProviderProps } from './BackendDat
 export { createCollectFrontendDataHandler, useCollectFrontendDataHandler, CollectFrontendDataHandlerBoundary, type CollectFrontendDataContext, type CreateCollectFrontendDataHandler, } from './CollectFrontendDataHandler.js';
 export { createFilterPublishedChunksHandler, useFilterPublishedChunksHandler, FilterPublishedChunksHandlerBoundary, type CreateFilterPublishedChunksHandler, } from './FilterPublishedChunksHandler.js';
 export { createIsUndoableHandler, type CreateIsUndoableHandler } from './IsUndoableHandler.js';
+export { useOnPresetLoadedHandler, createOnPresetLoadedHandler, type CreateOnPresetLoadedHandler, } from './OnPresetLoadedHandler.js';
+export { useChatEnabled } from './chat-hooks.js';

package/dist/react-sdk/domain-application-context/index.js

@@ -1 +1 @@
-export{DomainLifecycleBoundary}from"./DomainLifecycleBoundary.js";export{PublishedDataProvider}from"./PublishedDataProvider.js";export{FrontendDataProvider}from"./FrontendDataProvider.js";export{BackendDataProvider}from"./BackendDataProvider.js";export{createCollectFrontendDataHandler,useCollectFrontendDataHandler,CollectFrontendDataHandlerBoundary}from"./CollectFrontendDataHandler.js";export{createFilterPublishedChunksHandler,useFilterPublishedChunksHandler,FilterPublishedChunksHandlerBoundary}from"./FilterPublishedChunksHandler.js";export{createIsUndoableHandler}from"./IsUndoableHandler.js";
+export{DomainLifecycleBoundary}from"./DomainLifecycleBoundary.js";export{PublishedDataProvider}from"./PublishedDataProvider.js";export{FrontendDataProvider}from"./FrontendDataProvider.js";export{BackendDataProvider}from"./BackendDataProvider.js";export{createCollectFrontendDataHandler,useCollectFrontendDataHandler,CollectFrontendDataHandlerBoundary}from"./CollectFrontendDataHandler.js";export{createFilterPublishedChunksHandler,useFilterPublishedChunksHandler,FilterPublishedChunksHandlerBoundary}from"./FilterPublishedChunksHandler.js";export{createIsUndoableHandler}from"./IsUndoableHandler.js";export{useOnPresetLoadedHandler,createOnPresetLoadedHandler}from"./OnPresetLoadedHandler.js";export{useChatEnabled}from"./chat-hooks.js";

package/dist/react-sdk/domain-context/common-hooks/index.d.ts

@@ -1,3 +1,4 @@
+export * from './use-configuration-save-state.js';
 export * from './use-configurator-messages.js';
 export * from './use-domain-context.js';
 export * from './use-entity-selector.js';

package/dist/react-sdk/domain-context/common-hooks/index.js

@@ -1 +1 @@
-export*from"./use-configurator-messages.js";export*from"./use-domain-context.js";export*from"./use-entity-selector.js";export*from"./use-observable-selector.js";export*from"./use-slices.js";export*from"./use-state-slice.js";export*from"./use-state-validity.js";export*from"./use-store-selector.js";
+export*from"./use-configuration-save-state.js";export*from"./use-configurator-messages.js";export*from"./use-domain-context.js";export*from"./use-entity-selector.js";export*from"./use-observable-selector.js";export*from"./use-slices.js";export*from"./use-state-slice.js";export*from"./use-state-validity.js";export*from"./use-store-selector.js";

package/dist/react-sdk/domain-context/common-hooks/use-configuration-save-state.d.ts

@@ -0,0 +1,23 @@
+import { type ConfigurationPersistSystemFailure } from '../../application-runtime/index.js';
+/**
+ * The save status of the configuration, as `useConfigurationSaveState()` returns it.
+ */
+export interface ConfigurationSaveState {
+    /** The revision the configuration is at: the loaded one, then the one the latest save created. */
+    readonly revisionId: string;
+    /** Whether a save is running. */
+    readonly isSaving: boolean;
+    /**
+     * The latest failed save, `{ error, timestamp }` with `timestamp` in milliseconds since the epoch, or `null` once a
+     * later save succeeds or another configuration loads.
+     */
+    readonly failure: ConfigurationPersistSystemFailure | null;
+}
+export type UseConfigurationSaveState = () => ConfigurationSaveState;
+/**
+ * The save status of the configuration of the application this component is mounted in, read from its persist system:
+ * `revisionId`, `isSaving` and `failure`. An editable configuration saves committed changes on its own, three seconds
+ * after the last one; a read-only one never saves. Loading a configuration resets the status. Re-renders when any of
+ * the three changes; the returned object keeps its identity otherwise.
+ */
+export declare const useConfigurationSaveState: UseConfigurationSaveState;

package/dist/react-sdk/domain-context/common-hooks/use-configuration-save-state.js

@@ -0,0 +1 @@
+import{useMemo as e}from"react";import{useDomainApplication as r}from"../../application-runtime/index.js";import{useEagerObservableValue as o}from"./use-observable-selector.js";export const useConfigurationSaveState=()=>{let{configurationPersistSystem:t}=r(),i=o(t.revisionId$),a=o(t.saving$),n=o(t.failure$);return e(()=>({revisionId:i,isSaving:a,failure:n}),[i,a,n])};

package/dist/react-sdk/domain-context/common-hooks/use-domain-context.d.ts

@@ -69,6 +69,7 @@ export declare const useDomainContextSelectors: () => {
     getMigrate: () => import("#package/domain").MigrateFunction<DomainEntity<string>>;
     getActiveMode: () => import("#package/domain").DomainMode;
     getIsInitialized: () => boolean;
+    getIsViewMode: () => boolean;
     getComponentReaderIndexes: () => import("#package/domain").ComponentReaderIndexes;
     getStoreRuntimeDependencies: () => {
         componentReaderIndexes: import("#package/domain").ComponentReaderIndexes;

package/dist/react-sdk/domain-context/common-hooks/use-state-validity.d.ts

@@ -1,7 +1,13 @@
 import type { $DomainEntity, DomainEntity, EntityViolation, StateEmission, StateValidationResult, ViolationTypesOf$Entity } from '#package/domain';
+/** The validity of the last committed emission, as `useStateValidity` returns it. */
 export type UseStateValidity<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = StateValidationResult<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>;
 export declare const useStateValidity: () => StateValidationResult<DomainEntity<string>, never>;
-export type UseMapViolationHints<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = (ignoreViolationTypes: readonly string[], stateEmission: StateEmission<ENTITIES, $MAP>) => (violations: ReadonlyArray<EntityViolation<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>>) => string;
+/**
+ * Returns a function that turns violations into one translated hint: the messages of the violations at the highest
+ * priority among all of them, leaving out the ignored types, each formatted for the given state emission. When the
+ * top-priority violations are all ignored, the hint is empty.
+ */
+export type UseMapViolationHints<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = (ignoreViolationTypes?: readonly string[]) => (violations: ReadonlyArray<EntityViolation<ENTITIES, ViolationTypesOf$Entity<$MAP[ENTITIES['type']]>>>, stateEmission: StateEmission<ENTITIES, $MAP>) => string;
 export declare const useMapViolationHints: (ignoreViolationTypes?: readonly string[]) => (violations: ReadonlyArray<EntityViolation<DomainEntity<string>, never>>, stateEmission: StateEmission<DomainEntity<string>, Record<string, $DomainEntity<DomainEntity<string>>>>) => string;
 export type UseControlViolations<ENTITIES extends DomainEntity<string>, $MAP extends Record<ENTITIES['type'], $DomainEntity<ENTITIES>>> = (ignoreViolationTypes: string[]) => (prepared: StateEmission<ENTITIES, $MAP>) => {
     disabled: boolean;

package/dist/react-sdk/domain-context/index.d.ts

@@ -2,6 +2,7 @@ export { useDomain, type UseDomainContext } from './common-hooks/use-domain-cont
 export { useStoreSelector, useRenderedSelector, useRenderedSelector$, useStoreSelector$, type UseSynchronizedSelector, type UseSynchronizedSelector$, } from './common-hooks/use-store-selector.js';
 export { useEagerObservableSelector, usePatientObservableSelector, usePatientObservableValue, useEagerObservableValue, } from './common-hooks/use-observable-selector.js';
 export { useStateValidity, type UseStateValidity, useMapViolationHints, type UseMapViolationHints, useControlViolations, type UseControlViolations, useFinalizeViolations, type UseFinalizeViolations, } from './common-hooks/use-state-validity.js';
+export { useConfigurationSaveState, type UseConfigurationSaveState, type ConfigurationSaveState, } from './common-hooks/use-configuration-save-state.js';
 export { useConfiguratorMessages, type UseConfiguratorMessages, type ConfiguratorMessage, } from './common-hooks/use-configurator-messages.js';
 export { useComponent, useRenderedComponent, type UseComponent, useComponents, useDynamicComponents, useRenderedComponents, type UseComponents, useRootComponents, useRootRenderedComponents, type UseRootComponents, useFirstComponent, useFirstRenderedComponent, type UseFirstComponent, useFirstRootComponent, useFirstRootRenderedComponent, type UseFirstRootComponent, } from './component-hooks/use-component.js';
 export { useCommittedState, useCommittedSlice, useRenderedSlice, useRenderedState, type UseSlice, type UseState, } from './common-hooks/use-slices.js';

package/dist/react-sdk/domain-context/index.js

@@ -1 +1 @@
-export{useDomain}from"./common-hooks/use-domain-context.js";export{useStoreSelector,useRenderedSelector,useRenderedSelector$,useStoreSelector$}from"./common-hooks/use-store-selector.js";export{useEagerObservableSelector,usePatientObservableSelector,usePatientObservableValue,useEagerObservableValue}from"./common-hooks/use-observable-selector.js";export{useStateValidity,useMapViolationHints,useControlViolations,useFinalizeViolations}from"./common-hooks/use-state-validity.js";export{useConfiguratorMessages}from"./common-hooks/use-configurator-messages.js";export{useComponent,useRenderedComponent,useComponents,useDynamicComponents,useRenderedComponents,useRootComponents,useRootRenderedComponents,useFirstComponent,useFirstRenderedComponent,useFirstRootComponent,useFirstRootRenderedComponent}from"./component-hooks/use-component.js";export{useCommittedState,useCommittedSlice,useRenderedSlice,useRenderedState}from"./common-hooks/use-slices.js";export{useDomainEntityState,useDomainEntityRenderedState}from"./entity-hooks/use-domain-entity-state.js";export{useEntityPrice,useRootEntityPrice}from"./entity-hooks/use-entity-price.js";export{useSelectEntity,useSelectedEntity,useSelectedEntityId,useSelectedDomainEntityId,useDeselect,useSelectParent}from"./system-hooks/selection-hooks.js";export{useActiveNavigationState,useActiveViewState,useSetViewState,useActiveToolState,useIsFullscreenActive,useSetFullscreen,useActiveViewports,useDraggedDomainEntityId,useNavigate,usePushNavigate,usePopNavigate}from"./system-hooks/navigation-hooks.js";export{useComposition}from"./system-hooks/composition-hooks.js";export{useUndoRedo}from"./system-hooks/undo-redo-hooks.js";export{useTabNavigation}from"./system-hooks/tab-navigation-hooks.js";export{useStepNavigation}from"./system-hooks/step-navigation-hooks.js";export{useLocaleSwitch}from"./system-hooks/locale-switch-hooks.js";export{useGenerateShareLink}from"./system-hooks/generate-share-link-hooks.js";export{useShareLinks}from"./system-hooks/share-links-hooks.js";export{useHoveredDomainEntityId,useHoveredEntity,useHoveredEntityId}from"./system-hooks/hover-hooks.js";export{useRootEntityState,useRootEntityRenderedState}from"./entity-hooks/use-root-entity-state.js";export{useRootEntityId,useRootEntityRenderedId}from"./entity-hooks/use-root-entity-id.js";export{useEntitySelector,useRootEntitySelector,useRenderedEntitySelector,useRenderedRootEntitySelector}from"./common-hooks/use-entity-selector.js";export{useDimensionState,useDimensions,useDimensionConfig}from"./system-hooks/dimension-hooks.js";
+export{useDomain}from"./common-hooks/use-domain-context.js";export{useStoreSelector,useRenderedSelector,useRenderedSelector$,useStoreSelector$}from"./common-hooks/use-store-selector.js";export{useEagerObservableSelector,usePatientObservableSelector,usePatientObservableValue,useEagerObservableValue}from"./common-hooks/use-observable-selector.js";export{useStateValidity,useMapViolationHints,useControlViolations,useFinalizeViolations}from"./common-hooks/use-state-validity.js";export{useConfigurationSaveState}from"./common-hooks/use-configuration-save-state.js";export{useConfiguratorMessages}from"./common-hooks/use-configurator-messages.js";export{useComponent,useRenderedComponent,useComponents,useDynamicComponents,useRenderedComponents,useRootComponents,useRootRenderedComponents,useFirstComponent,useFirstRenderedComponent,useFirstRootComponent,useFirstRootRenderedComponent}from"./component-hooks/use-component.js";export{useCommittedState,useCommittedSlice,useRenderedSlice,useRenderedState}from"./common-hooks/use-slices.js";export{useDomainEntityState,useDomainEntityRenderedState}from"./entity-hooks/use-domain-entity-state.js";export{useEntityPrice,useRootEntityPrice}from"./entity-hooks/use-entity-price.js";export{useSelectEntity,useSelectedEntity,useSelectedEntityId,useSelectedDomainEntityId,useDeselect,useSelectParent}from"./system-hooks/selection-hooks.js";export{useActiveNavigationState,useActiveViewState,useSetViewState,useActiveToolState,useIsFullscreenActive,useSetFullscreen,useActiveViewports,useDraggedDomainEntityId,useNavigate,usePushNavigate,usePopNavigate}from"./system-hooks/navigation-hooks.js";export{useComposition}from"./system-hooks/composition-hooks.js";export{useUndoRedo}from"./system-hooks/undo-redo-hooks.js";export{useTabNavigation}from"./system-hooks/tab-navigation-hooks.js";export{useStepNavigation}from"./system-hooks/step-navigation-hooks.js";export{useLocaleSwitch}from"./system-hooks/locale-switch-hooks.js";export{useGenerateShareLink}from"./system-hooks/generate-share-link-hooks.js";export{useShareLinks}from"./system-hooks/share-links-hooks.js";export{useHoveredDomainEntityId,useHoveredEntity,useHoveredEntityId}from"./system-hooks/hover-hooks.js";export{useRootEntityState,useRootEntityRenderedState}from"./entity-hooks/use-root-entity-state.js";export{useRootEntityId,useRootEntityRenderedId}from"./entity-hooks/use-root-entity-id.js";export{useEntitySelector,useRootEntitySelector,useRenderedEntitySelector,useRenderedRootEntitySelector}from"./common-hooks/use-entity-selector.js";export{useDimensionState,useDimensions,useDimensionConfig}from"./system-hooks/dimension-hooks.js";

package/dist/react-sdk/domain-controls/ChildEntityCardSelector.d.ts

@@ -22,9 +22,8 @@ export interface ChildEntityCardSelectorProps {
      */
     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.
      */
     fixableViolations?: readonly string[];
     /**

package/dist/react-sdk/domain-controls/ChildEntityListSelector.d.ts

@@ -20,9 +20,8 @@ export interface ChildEntityListSelectorProps {
      */
     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.
      */
     fixableViolations?: readonly string[];
     /**

package/dist/react-sdk/domain-controls/ChildEntityToggleSelector.d.ts

@@ -21,9 +21,8 @@ export interface ChildEntityToggleSelectorProps {
      */
     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.
      */
     fixableViolations?: readonly string[];
     /**

package/dist/react-sdk/domain-controls/hooks/use-cook-replace-recipes.d.ts

@@ -1,5 +1,5 @@
 import type { AnalyticsEvent, DomainEntity, DomainEntityId, EntityRecipe } from '#package/domain';
-export type UseCookedReplaceRecipes<ENTITIES extends DomainEntity<string>> = (entityId: ENTITIES['id'], recipes: ReadonlyArray<EntityRecipe<DomainEntity<string>>>, keepChildren?: boolean, fixableViolations?: string[], createAnalyticsEvent?: (entityId: ENTITIES['id'], recipes: readonly ENTITIES[]) => AnalyticsEvent) => (recipes: ReadonlyArray<EntityRecipe<ENTITIES>>, collection?: string) => {
+export type UseCookedReplaceRecipes<ENTITIES extends DomainEntity<string>> = (entityId: ENTITIES['id'], recipes: ReadonlyArray<EntityRecipe<DomainEntity<string>>>, keepChildren?: boolean, fixableViolations?: string[], createAnalyticsEvent?: (entityId: ENTITIES['id'], recipes: readonly ENTITIES[]) => AnalyticsEvent) => {
     disabled: boolean;
     hints: string | undefined;
     replace: () => void;
@@ -7,7 +7,7 @@ export type UseCookedReplaceRecipes<ENTITIES extends DomainEntity<string>> = (en
      * The original recipes, useful for introspection in custom UI components,
      * for example to highlight certain recipes in the menu.
      */
-    recipes: ReadonlyArray<EntityRecipe<ENTITIES>>;
+    recipes: ReadonlyArray<EntityRecipe<DomainEntity<string>>>;
 };
 export declare const useCookedReplaceRecipes: (entityId: DomainEntityId<string>, recipes: ReadonlyArray<EntityRecipe<DomainEntity<string>>>, keepChildren?: boolean, fixableViolations?: string[], createAnalyticsEvent?: (entityId: DomainEntityId<string>, recipes: ReadonlyArray<DomainEntity<string>>) => AnalyticsEvent) => {
     disabled: boolean;

package/dist/react-sdk/elements/PhoenixEntityElement.js

@@ -1 +1 @@
-import{jsx as e,jsxs as i,Fragment as n}from"react/jsx-runtime";import{Box as t}from"@mui/material";import{memo as r,useMemo as o}from"react";import{usePhoenixElementSlots as l}from"../application-runtime/index.js";export const PhoenixEntityElement=r(n=>{let{name:r,children:o,elementProps:d}=n,{entityElements:m,hashes:h}=l(),p=m[r];return p?e(p,{...d,children:o},h[r]??r):i(t,{component:"div",sx:{p:2,backgroundColor:"red",color:"white"},children:["PhoenixEntityElement ",r," not found! Have you defined it?"]})});export const PhoenixEntityElementWithChildren=i=>{let{kind:n,entityId:t,elementProps:r,children:l,visible:d}=i,m=o(()=>({entityId:t,...r}),[t,r]),h=o(()=>l?.map((i,n)=>e(PhoenixEntityElementWithChildren,{kind:i.kind,entityId:t,elementProps:"props"in i?i.props:void 0,children:"children"in i?i.children:void 0,visible:i.visible},`${i.kind}-${n}`)),[l,t]);return!1===d?null:e(PhoenixEntityElement,{entityId:t,name:n,elementProps:m,children:h})};export const PhoenixEntityElements=i=>{let{elements:t,entityId:r,fallback:o}=i;return void 0===t?e(n,{children:o}):e(n,{children:t.map((i,n)=>e(PhoenixEntityElementWithChildren,{kind:i.kind,entityId:r,elementProps:"props"in i?i.props:void 0,children:"children"in i?i.children:void 0,visible:i.visible},`${i.kind}-${n}`))})};
+import{jsx as e,jsxs as i,Fragment as n}from"react/jsx-runtime";import{memo as t,useMemo as r}from"react";import{usePhoenixElementSlots as o}from"../application-runtime/index.js";let l={padding:16,backgroundColor:"red",color:"white"};export const PhoenixEntityElement=t(n=>{let{name:t,children:r,elementProps:d}=n,{entityElements:h,hashes:s}=o(),m=h[t];return m?e(m,{...d,children:r},s[t]??t):i("div",{style:l,children:["PhoenixEntityElement ",t," not found! Have you defined it?"]})});export const PhoenixEntityElementWithChildren=i=>{let{kind:n,entityId:t,elementProps:o,children:l,visible:d}=i,h=r(()=>({entityId:t,...o}),[t,o]),s=r(()=>l?.map((i,n)=>e(PhoenixEntityElementWithChildren,{kind:i.kind,entityId:t,elementProps:"props"in i?i.props:void 0,children:"children"in i?i.children:void 0,visible:i.visible},`${i.kind}-${n}`)),[l,t]);return!1===d?null:e(PhoenixEntityElement,{entityId:t,name:n,elementProps:h,children:s})};export const PhoenixEntityElements=i=>{let{elements:t,entityId:r,fallback:o}=i;return void 0===t?e(n,{children:o}):e(n,{children:t.map((i,n)=>e(PhoenixEntityElementWithChildren,{kind:i.kind,entityId:r,elementProps:"props"in i?i.props:void 0,children:"children"in i?i.children:void 0,visible:i.visible},`${i.kind}-${n}`))})};

package/dist/react-sdk/elements/PhoenixLayoutElement.js

@@ -1 +1 @@
-import{jsx as e,jsxs as n,Fragment as i}from"react/jsx-runtime";import{Box as o}from"@mui/material";import{memo as t}from"react";import{usePhoenixElementSlots as r}from"../application-runtime/index.js";export const PhoenixLayoutElement=t(i=>{let{name:t,children:d,elementProps:l,defaultSlot:m}=i,{layoutElements:h,hashes:p}=r(),s=h[t]??m;return s?e(s,{...l??{},children:d},p[t]??t):n(o,{component:"div",sx:{p:2,backgroundColor:"red",color:"white"},children:["PhoenixLayoutElement ",t," not found! Have you defined it?"]})});export const PhoenixLayoutElementWithChildren=n=>{let{kind:i,elementProps:o,children:t}=n;return e(PhoenixLayoutElement,{name:i,elementProps:o,children:t?.map((n,i)=>e(PhoenixLayoutElementWithChildren,{kind:n.kind,elementProps:"props"in n?n.props:void 0,children:"children"in n?n.children:void 0},`${n.kind}-${i}`))})};export const PhoenixLayoutElements=n=>{let{elements:o,fallback:t}=n;return void 0===o?e(i,{children:t}):e(i,{children:o.map((n,i)=>e(PhoenixLayoutElementWithChildren,{kind:n.kind,elementProps:"props"in n?n.props:void 0,children:"children"in n?n.children:void 0},`${n.kind}-${i}`))})};export const usePhoenixLayoutElementExists=e=>{let{layoutElements:n}=r();return void 0!==n[e]};
+import{jsx as e,jsxs as n,Fragment as i}from"react/jsx-runtime";import{memo as t}from"react";import{usePhoenixElementSlots as o}from"../application-runtime/index.js";let r={padding:16,backgroundColor:"red",color:"white"};export const PhoenixLayoutElement=t(i=>{let{name:t,children:d,elementProps:l,defaultSlot:h}=i,{layoutElements:s,hashes:m}=o(),p=s[t]??h;return p?e(p,{...l??{},children:d},m[t]??t):n("div",{style:r,children:["PhoenixLayoutElement ",t," not found! Have you defined it?"]})});export const PhoenixLayoutElementWithChildren=n=>{let{kind:i,elementProps:t,children:o}=n;return e(PhoenixLayoutElement,{name:i,elementProps:t,children:o?.map((n,i)=>e(PhoenixLayoutElementWithChildren,{kind:n.kind,elementProps:"props"in n?n.props:void 0,children:"children"in n?n.children:void 0},`${n.kind}-${i}`))})};export const PhoenixLayoutElements=n=>{let{elements:t,fallback:o}=n;return void 0===t?e(i,{children:o}):e(i,{children:t.map((n,i)=>e(PhoenixLayoutElementWithChildren,{kind:n.kind,elementProps:"props"in n?n.props:void 0,children:"children"in n?n.children:void 0},`${n.kind}-${i}`))})};export const usePhoenixLayoutElementExists=e=>{let{layoutElements:n}=o();return void 0!==n[e]};

package/dist/react-sdk/elements/index.d.ts

@@ -1,3 +1,2 @@
-export type { ConfiguratorErrorPageProps, ConfiguratorErrorReason } from './configurator-error-page-props.js';
 export { PhoenixEntityElement, PhoenixEntityElements, PhoenixEntityElementWithChildren, type PhoenixEntityElementProps, type PhoenixEntityElementsProps, type PhoenixEntityElementWithChildrenProps, } from './PhoenixEntityElement.js';
 export { PhoenixLayoutElement, PhoenixLayoutElements, PhoenixLayoutElementWithChildren, usePhoenixLayoutElementExists, type PhoenixLayoutElementProps, type PhoenixLayoutElementsProps, type PhoenixLayoutElementWithChildrenProps, } from './PhoenixLayoutElement.js';

package/dist/react-sdk/index.d.ts

@@ -8,8 +8,15 @@ export * from './invalid-deployment/index.js';
 export * from './web-component/index.js';
 export * from './localizable/index.js';
 export * from './loading-state/index.js';
-export * from './responsive-state/index.js';
+export * from './configurator-routing/index.js';
+export * from './integration/index.js';
+export type * from './notifications/index.js';
 export * from './elements/index.js';
 export * from './scene-control-elements/index.js';
+export * from './page-elements/index.js';
+export * from './lifecycle-providers/index.js';
+export * from './provider-slots/index.js';
+export * from './configurator-ui-elements/index.js';
+export * from './preset-selection/index.js';
 export * from './handlers/index.js';
 export * from './application-runtime/index.js';

package/dist/react-sdk/index.js

@@ -1 +1 @@
-export*from"./theme/index.js";export*from"./utils/index.js";export*from"./session/index.js";export*from"./domain-context/index.js";export*from"./domain-application-context/index.js";export*from"./domain-controls/index.js";export*from"./invalid-deployment/index.js";export*from"./web-component/index.js";export*from"./localizable/index.js";export*from"./loading-state/index.js";export*from"./responsive-state/index.js";export*from"./elements/index.js";export*from"./scene-control-elements/index.js";export*from"./handlers/index.js";export*from"./application-runtime/index.js";
+export*from"./theme/index.js";export*from"./utils/index.js";export*from"./session/index.js";export*from"./domain-context/index.js";export*from"./domain-application-context/index.js";export*from"./domain-controls/index.js";export*from"./invalid-deployment/index.js";export*from"./web-component/index.js";export*from"./localizable/index.js";export*from"./loading-state/index.js";export*from"./configurator-routing/index.js";export*from"./integration/index.js";export*from"./elements/index.js";export*from"./scene-control-elements/index.js";export*from"./page-elements/index.js";export*from"./lifecycle-providers/index.js";export*from"./provider-slots/index.js";export*from"./configurator-ui-elements/index.js";export*from"./preset-selection/index.js";export*from"./handlers/index.js";export*from"./application-runtime/index.js";

package/dist/react-sdk/integration/IntegrationSubscription.js

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{useEffect as t}from"react";import{useRecipeEmbeddedState as i}from"../application-runtime/index.js";import{useSelectEntity as o}from"../domain-context/index.js";export const IntegrationSubscription=e=>{let{children:n}=e,m=i()?.rootRecipeId,p=o();return t(()=>{m&&p(m)},[m,p]),r("div",{children:n})};

package/dist/react-sdk/integration/index.d.ts

@@ -0,0 +1 @@
+export { IntegrationSubscription, type IntegrationSubscriptionProps } from './IntegrationSubscription.js';

package/dist/react-sdk/integration/index.js

@@ -0,0 +1 @@
+export{IntegrationSubscription}from"./IntegrationSubscription.js";

package/dist/react-sdk/lifecycle-providers/ConfiguratorDataProvider.d.ts

@@ -0,0 +1,8 @@
+import type { PropsWithChildren } from 'react';
+/**
+ * Runs the configurator's data stages in order, published, frontend and backend data, each
+ * followed by its `On*DataReady` provider.
+ *
+ * @internal Runtime plumbing for the SDK's own configurator application, which runs it at its root.
+ */
+export declare const ConfiguratorDataProvider: ({ children }: PropsWithChildren) => import("react/jsx-runtime").JSX.Element;

package/dist/react-sdk/lifecycle-providers/ConfiguratorDataProvider.js

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{BackendDataProvider as i,FrontendDataProvider as e,PublishedDataProvider as o}from"../domain-application-context/index.js";import{OnBackendDataReadyProvider as n,OnFrontendDataReadyProvider as c,OnPublishedDataReadyProvider as t}from"./LifecycleProviders.js";export const ConfiguratorDataProvider=({children:d})=>r(o,{children:r(t,{children:r(e,{children:r(c,{children:r(i,{children:r(n,{children:d})})})})})});

package/dist/react-sdk/lifecycle-providers/LifecycleProviders.js

@@ -0,0 +1 @@
+import{jsx as e,Fragment as r}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as t}from"#package/domain";import{PhoenixLayoutElement as o}from"../elements/index.js";let n={},a="OnConfiguratorReadyProvider";export const createOnConfiguratorReadyProvider=e=>t(a,e);export const OnConfiguratorReadyProvider=({children:t})=>e(o,{name:a,elementProps:n,defaultSlot:r,children:t});let d="OnSessionReadyProvider";export const createOnSessionReadyProvider=e=>t(d,e);export const OnSessionReadyProvider=({children:t})=>e(o,{name:d,elementProps:n,defaultSlot:r,children:t});let i="OnPublishedDataReadyProvider";export const createOnPublishedDataReadyProvider=e=>t(i,e);export const OnPublishedDataReadyProvider=({children:t})=>e(o,{name:i,elementProps:n,defaultSlot:r,children:t});let l="OnApplicationStartProvider";export const createOnApplicationStartProvider=e=>t(l,e);export const OnApplicationStartProvider=({children:t})=>e(o,{name:l,elementProps:n,defaultSlot:r,children:t});let c="OnRoutingReadyProvider";export const createOnRoutingReadyProvider=e=>t(c,e);export const OnRoutingReadyProvider=({children:t})=>e(o,{name:c,elementProps:n,defaultSlot:r,children:t});let s="OnFrontendDataReadyProvider";export const createOnFrontendDataReadyProvider=e=>t(s,e);export const OnFrontendDataReadyProvider=({children:t})=>e(o,{name:s,elementProps:n,defaultSlot:r,children:t});let p="OnBackendDataReadyProvider";export const createOnBackendDataReadyProvider=e=>t(p,e);export const OnBackendDataReadyProvider=({children:t})=>e(o,{name:p,elementProps:n,defaultSlot:r,children:t});

package/dist/react-sdk/lifecycle-providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './LifecycleProviders.js';
+export { ConfiguratorDataProvider } from './ConfiguratorDataProvider.js';

package/dist/react-sdk/lifecycle-providers/index.js

@@ -0,0 +1 @@
+export*from"./LifecycleProviders.js";export{ConfiguratorDataProvider}from"./ConfiguratorDataProvider.js";

package/dist/react-sdk/loading-state/LoaderHost.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+/**
+ * Hosts the application's loader: the loading hooks below it report to the runtime's `loading`
+ * slice, and the SDK's own UI below it leaves its inline loaders out (`useIsLoaderHosted()`). The
+ * configurator mounts the one host, inside its `ApplicationTypeProvider`, while it is powered on.
+ *
+ * It resets the slice when it mounts and not again while it stays mounted, so the loading state
+ * starts over at power-on and on remount, and only there.
+ *
+ * Its children mount once the reset is done, so their first render and their first phases already
+ * see the host, and the reset cannot wipe phases they started. The host resets in a layout effect
+ * and then sets local state, which React renders synchronously before the browser paints, whatever
+ * the lane of the first render. StrictMode repeats that layout effect before the children mount, so
+ * the second reset wipes nothing either.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const LoaderHost: ({ children }: {
+    readonly children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/react-sdk/loading-state/LoaderHost.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{useLayoutEffect as r,useState as i}from"react";import{LoaderHostContext as t,useLoadingApplication as e}from"../application-runtime/index.js";export const LoaderHost=({children:n})=>{let a=e(),[p,d]=i(!1);if(null===a)throw Error("LoaderHost has no application whose loader it could host: it is mounted outside an ApplicationRuntimeProvider or an ApplicationTypeProvider. Render LoaderHost inside both an ApplicationRuntimeProvider and an ApplicationTypeProvider, as ConfiguratorApp does.");return(r(()=>{a.actions.resetSlot(),d(!0)},[a]),p)?o(t.Provider,{value:!0,children:n}):null};

package/dist/react-sdk/loading-state/built-in-loading-phase.d.ts

@@ -0,0 +1,9 @@
+/** The ids of the loading phases the SDK reports itself. A project reports its own under other ids. */
+export declare enum BuiltInLoadingPhase {
+    SessionAuth = "session-auth",
+    PublishedData = "published-data",
+    FrontendData = "frontend-data",
+    BackendData = "backend-data",
+    DataFetch = "data-fetch",
+    SceneAssets = "scene-assets"
+}

package/dist/react-sdk/loading-state/built-in-loading-phase.js

@@ -0,0 +1 @@
+var a;export var BuiltInLoadingPhase=((a={}).SessionAuth="session-auth",a.PublishedData="published-data",a.FrontendData="frontend-data",a.BackendData="backend-data",a.DataFetch="data-fetch",a.SceneAssets="scene-assets",a);

package/dist/react-sdk/loading-state/create-app-loader.d.ts

@@ -0,0 +1,18 @@
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+import type { LoadingPhase } from '../application-runtime/index.js';
+/**
+ * The name a project registers a layout element under to replace what the app loader overlay shows.
+ * Its default, the built-in loader content, is registered in `defaultConfiguratorElements`.
+ */
+export declare const AppLoaderContentName = "AppLoaderContent";
+/** The props of the content a project registers with `createAppLoader`. */
+export interface AppLoaderContentProps {
+    /** The loading phases running now; empty while the loader waits for the scene to start loading. */
+    readonly phases: readonly LoadingPhase[];
+}
+/**
+ * Registers a project's app loader content as the `AppLoaderContent` element. The SDK keeps the
+ * overlay, its place over the scene's safe area and its fade-in; the component is only what it shows.
+ */
+export declare const createAppLoader: (Element: (props: AppLoaderContentProps) => JSX.Element) => readonly PhoenixLayoutElementRegistration[];
+export type CreateAppLoader = (Element: (props: AppLoaderContentProps) => JSX.Element) => readonly PhoenixLayoutElementRegistration[];

package/dist/react-sdk/loading-state/create-app-loader.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as t}from"#package/domain";import{useLoadingStateValue as e}from"./loading-state-hooks.js";export const AppLoaderContentName="AppLoaderContent";export const createAppLoader=r=>[t("AppLoaderContent",()=>{let{phases:t}=e();return o(r,{phases:t})})];

package/dist/react-sdk/loading-state/index.d.ts

@@ -1,2 +1,4 @@
-export { BuiltInLoadingPhase, type LoadingPhase, type LoadingState, LoadingStateManager, } from './loading-state-manager.js';
-export { LoadingStateProvider, useLoadingState, type UseLoadingState, useLoadingStateManager, useLoadingStateValue, useLoadingPhase, useExpectPhase, useLoadingError, } from './LoadingStateProvider.js';
+export { BuiltInLoadingPhase } from './built-in-loading-phase.js';
+export { LoaderHost } from './LoaderHost.js';
+export { useLoadingState, type UseLoadingState, useLoadingStateValue, useLoadingPhase, useExpectPhase, useLoadingError, } from './loading-state-hooks.js';
+export { AppLoaderContentName, type AppLoaderContentProps, createAppLoader, type CreateAppLoader, } from './create-app-loader.js';

package/dist/react-sdk/loading-state/index.js

@@ -1 +1 @@
-export{BuiltInLoadingPhase,LoadingStateManager}from"./loading-state-manager.js";export{LoadingStateProvider,useLoadingState,useLoadingStateManager,useLoadingStateValue,useLoadingPhase,useExpectPhase,useLoadingError}from"./LoadingStateProvider.js";
+export{BuiltInLoadingPhase}from"./built-in-loading-phase.js";export{LoaderHost}from"./LoaderHost.js";export{useLoadingState,useLoadingStateValue,useLoadingPhase,useExpectPhase,useLoadingError}from"./loading-state-hooks.js";export{AppLoaderContentName,createAppLoader}from"./create-app-loader.js";

package/dist/react-sdk/loading-state/{LoadingStateProvider.d.ts → loading-state-hooks.d.ts}

@@ -1,22 +1,13 @@
-import type { ReactNode } from 'react';
-import { type LoadingPhase, type LoadingState, LoadingStateManager } from './loading-state-manager.js';
-export declare const LoadingStateProvider: ({ children }: {
-    readonly children: ReactNode;
-}) => import("react/jsx-runtime").JSX.Element;
-/**
- * Returns the loading state manager if available.
- * Returns `null` when used outside of `LoadingStateProvider` (e.g. in admin app).
- */
-export declare const useLoadingStateManager: () => LoadingStateManager | null;
+import { type LoadingPhase, type LoadingState } from '../application-runtime/index.js';
 /**
  * Subscribe to the current aggregated loading state.
- * Returns the default (not loading) state when used outside of `LoadingStateProvider`.
+ * Returns the default (not loading) state outside the application's loader host.
  */
 export declare const useLoadingStateValue: () => LoadingState;
 export type UseLoadingState = typeof useLoadingState;
 /**
  * Returns loading phase control functions.
- * Returns `null` when used outside of `LoadingStateProvider`.
+ * Returns `null` outside the application's loader host.
  */
 export declare const useLoadingState: () => {
     startPhase: (phase: LoadingPhase) => void;

package/dist/react-sdk/loading-state/loading-state-hooks.js

@@ -0,0 +1 @@
+import{useEffect as e,useMemo as t,useRef as r,useSyncExternalStore as n}from"react";import{useIsLoaderHosted as s,useLoadingActions as a,useLoadingApplication as o,useOptionalApplicationRuntime as u}from"../application-runtime/index.js";let c={isLoading:!1,hasError:!1,phases:[],expectedPhaseIds:new Set},l=()=>c,i=()=>()=>{};export const useLoadingStateValue=()=>{let e=o(),t=s(),r=u(),a=n(r?.subscribe??i,e?.selectors.getLoadingState??l);return t?a:c};export const useLoadingState=()=>{let e=a();return t(()=>e?{startPhase:e.startPhase,endPhase:e.endPhase}:null,[e])};export const useLoadingPhase=(t,n)=>{let s=a(),o=r(t);o.current=t;let u=r(null);e(()=>{if(s)return n?(u.current=o.current.id,s.startPhase(o.current)):null!==u.current&&(s.endPhase(u.current),u.current=null),()=>{null!==u.current&&(s.endPhase(u.current),u.current=null)}},[s,n,t.id])};export const useExpectPhase=t=>{let r=a();e(()=>{if(r)return r.expectPhase(t),()=>{r.dropExpectation(t)}},[r,t])};export const useLoadingError=t=>{let r=a();e(()=>{r&&t&&r.reportError()},[r,t])};

package/dist/react-sdk/notifications/index.d.ts

@@ -0,0 +1 @@
+export type { SnackbarActionButton } from './snackbar-action-button.js';

package/dist/react-sdk/notifications/index.js

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