@salsita-ai/sdk 0.50.0-develop.a4dde5f252 → 0.50.0-develop.a8cf9ffd01

package/dist/react-sdk/handlers/use-finalize-action.d.ts

@@ -0,0 +1,32 @@
+/**
+ * What a project layout needs to show and run one `finalizeAction` of the spec.
+ * - `run`: pushes the finalize-button analytics event, then runs the action's handler. Does nothing while
+ *   `disabled` or `isPending`. The promise it returns never rejects: it resolves after the handler has settled and
+ *   React has had the chance to render the outcome, or at once when the run does nothing; a failure is `error`.
+ * - `isPending`: the handler is running.
+ * - `error`: what the handler's last run rejected with, `null` after a run that resolved and while a new run is
+ *   pending. A rejection that is not an `Error` is wrapped in one, with the rejected value as its `cause`. No snackbar
+ *   is raised; the layout shows it its own way.
+ * - `disabled` and `hints`: from `useFinalizeViolations()`; the configuration cannot be finalized while it has
+ *   a `warning` or worse, or while it is out of sync with the server, and `hints` says why.
+ *
+ * `isPending` and `error` belong to the mounted component: when it unmounts during a run, the handler keeps
+ * running, and a component mounted afterwards starts with `isPending` false and no `error`.
+ */
+export interface UseFinalizeActionResult {
+    readonly run: () => Promise<void>;
+    readonly isPending: boolean;
+    readonly error: Error | null;
+    readonly disabled: boolean;
+    readonly hints: string | undefined;
+}
+export type UseFinalizeAction = (handler: string) => UseFinalizeActionResult;
+/**
+ * Runs the project handler a `finalizeAction` component names, with the state a finalize button shows.
+ *
+ * It calls `usePhoenixHandler(handler)`, which calls the project's handler factory and the hooks inside it, so:
+ * call it once per component, never in a loop or conditionally, render one component per action, and wrap that
+ * component in `<PhoenixHandlerBoundary name={handler}>` from `@salsita-ai/sdk/react`, so an edited handler takes
+ * effect without a reload. It does not check read mode; a layout hides finalization for a viewer.
+ */
+export declare const useFinalizeAction: UseFinalizeAction;

package/dist/react-sdk/handlers/use-finalize-action.js

@@ -0,0 +1 @@
+import{useMutation as r}from"@tanstack/react-query";import{useCallback as t,useRef as e}from"react";import{FrontendAnalyticsFactory as n,useAnalyticsService as i,useLogger as a}from"../application-runtime/index.js";import{useFinalizeViolations as o}from"../domain-context/index.js";import{usePhoenixHandler as c}from"./PhoenixHandler.js";export const useFinalizeAction=s=>{let{handler:l}=c(s),m=i(),u=a(),{disabled:f,hints:d}=o(),h=e(!1),{mutateAsync:p,isPending:w,error:y}=r({mutationFn:async()=>{try{await l()}catch(r){throw r instanceof Error?r:Error(null==r?"The finalize handler failed without a reason.":String(r),{cause:r})}finally{h.current=!1}},onError:r=>{u.error("Failed to finalize",{error:r.message})}});return{run:t(async()=>{if(!f&&!h.current){h.current=!0,m.push(n.FinalizeButtonClicked());try{await p()}catch{}await new Promise(r=>setTimeout(r,0))}},[m,f,p]),isPending:w,error:y,disabled:f,hints:d}};

package/dist/react-sdk/handlers/use-finalize-actions.d.ts

@@ -0,0 +1,53 @@
+import { type FinalizeActionComponentState } from '#package/domain';
+/**
+ * One active `finalizeAction` of the spec, ready to render and run.
+ * - `key`: the stable key of the component instance, for React's `key`.
+ * - `handler`: the name of the project handler the action runs.
+ * - `variant`, `label`, `title` and `icon`: the component's fields, `label` and `title` resolved to the current
+ *   language; `icon` is a `PhxIcon` name.
+ * - `run`: pushes the finalize-button analytics event and runs the handler, as `useFinalizeAction(handler).run`
+ *   does. It does nothing while `disabled` or `isPending`. The promise it returns never rejects: it resolves once
+ *   the entry shows the outcome of the run, or at once when the run does nothing.
+ * - `isPending`: the handler is running.
+ * - `error`: what the handler's last run rejected with, as an `Error`, or `null`; cleared when the action runs
+ *   again. It is also the error the handler threw while it was loaded, when it could not be loaded at all.
+ * - `disabled`: finalizing is blocked, as in `useFinalizeViolations()`, or the handler could not be loaded.
+ */
+export interface FinalizeActionEntry {
+    readonly key: string;
+    readonly handler: string;
+    readonly variant: FinalizeActionComponentState['variant'];
+    readonly label: string;
+    readonly title: string;
+    readonly icon: string;
+    readonly run: () => Promise<void>;
+    readonly isPending: boolean;
+    readonly error: Error | null;
+    readonly disabled: boolean;
+}
+/**
+ * The spec's finalize actions for a layout.
+ * - `actions`: every active `finalizeAction` component, in spec order.
+ * - `primary`: the first `'primary'` action, else the first action, else `null`; the built-in footer's button.
+ * - `secondary`: the other actions, in spec order; the built-in footer's menu.
+ * - `disabled` and `hints`: those of `useFinalizeViolations()`.
+ */
+export interface UseFinalizeActionsResult {
+    readonly actions: readonly FinalizeActionEntry[];
+    readonly primary: FinalizeActionEntry | null;
+    readonly secondary: readonly FinalizeActionEntry[];
+    readonly disabled: boolean;
+    readonly hints: string | undefined;
+}
+export type UseFinalizeActions = () => UseFinalizeActionsResult;
+/**
+ * The spec's finalize actions, each with its own `run`, for a layout that renders its own finalize buttons. The
+ * configurator runs the handlers itself, so a layout calls this hook anywhere, as often as it likes, and renders
+ * the entries in a loop. To run a single action the layout already knows, `useFinalizeAction(handler)` works too.
+ *
+ * It needs the configurator's `FinalizeActionsProvider` and `FinalizeActionsHost`, which are mounted around and
+ * beside every configurator layout, and also reach the dialogs a layout opens with `useModal`. Outside them it
+ * returns no actions and logs a warning. It does not check read mode; a layout hides finalization for a
+ * viewer.
+ */
+export declare const useFinalizeActions: UseFinalizeActions;

package/dist/react-sdk/handlers/use-finalize-actions.js

@@ -0,0 +1 @@
+import{useContext as e,useEffect as i,useMemo as t,useSyncExternalStore as r}from"react";import{finalizeActionComponent as n,getComponentSnapshotKey as o}from"#package/domain";import{useLogger as a}from"../application-runtime/index.js";import{useComponents as s,useFinalizeViolations as l}from"../domain-context/index.js";import{useResolveLocalizable as u}from"../localizable/index.js";import{FinalizeActionsContext as d}from"./finalize-actions-context.js";let m=()=>Promise.resolve(),p=new Map,c=()=>()=>{},f=()=>p;export const useFinalizeActions=()=>{let p=e(d),g=r(p?.subscribe??c,p?.getSnapshot??f),b=s({componentTypes:[n]}),{disabled:y,hints:x}=l(),z=u(),j=a(),h=null!==p;return i(()=>{h||j.warn("useFinalizeActions() is used outside the configurator layout and its dialogs, so it returns no finalize actions. Call it inside a ConfiguratorLayout element or a dialog it opens.")},[h,j]),t(()=>{if(!h)return{actions:[],primary:null,secondary:[],disabled:y,hints:x};let e=b.map(e=>{let i=o(e),{variant:t,label:r,title:n,icon:a,handler:s}=e.state,l=g.get(i),u={key:i,handler:s,variant:t,label:z(r),title:z(n),icon:a};if(l?.status==="ready"){let{run:e,isPending:i,error:t,disabled:r}=l.action;return{...u,run:e,isPending:i,error:t,disabled:r}}return{...u,run:m,isPending:!1,error:l?.status==="failed"?l.error:null,disabled:!0}}),i=e.find(e=>"primary"===e.variant)??e[0]??null,t=e.filter(e=>e!==i);return{actions:e,primary:i,secondary:t,disabled:y,hints:x}},[b,y,h,x,z,g])};

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

@@ -8,6 +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 './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"./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/loading-state-hooks.d.ts

@@ -0,0 +1,22 @@
+import { type LoadingPhase, type LoadingState } from '../application-runtime/index.js';
+/**
+ * Subscribe to the current aggregated loading state.
+ * 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` outside the application's loader host.
+ */
+export declare const useLoadingState: () => {
+    startPhase: (phase: LoadingPhase) => void;
+    endPhase: (id: string) => void;
+} | null;
+/**
+ * Convenience hook that reports a loading phase while a condition is true.
+ * Automatically calls `startPhase`/`endPhase` based on the `isLoading` flag.
+ */
+export declare const useLoadingPhase: (phase: LoadingPhase, isLoading: boolean) => void;
+export declare const useExpectPhase: (id: string) => void;
+export declare const useLoadingError: (hasError: boolean) => 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{};

package/dist/react-sdk/notifications/snackbar-action-button.d.ts

@@ -0,0 +1,30 @@
+import type { SnackbarKey } from 'notistack';
+import type { ReactNode } from 'react';
+/**
+ * A button a snackbar shows after its message, described as data instead of as an element.
+ *
+ * The code that raises a snackbar passes it as the `actionButton` option of notistack's `enqueueSnackbar`, so it
+ * needs no UI component. The themed snackbar of the configurator and the admin renders it in its `actionButton`
+ * slot, which the theme styles as `PhxSnackbar`. `onClick` receives the snackbar's key, for example to close the
+ * snackbar with `closeSnackbar`.
+ */
+export interface SnackbarActionButton {
+    /** The button's text. */
+    readonly label: ReactNode;
+    /** Called with the key of the snackbar whose button was clicked. */
+    readonly onClick: (key: SnackbarKey) => void;
+}
+type SnackbarActionButtonOptions = {
+    /** A button shown after the message, see `SnackbarActionButton`. */
+    readonly actionButton?: SnackbarActionButton;
+};
+declare module 'notistack' {
+    interface VariantOverrides {
+        default: SnackbarActionButtonOptions;
+        info: SnackbarActionButtonOptions;
+        success: SnackbarActionButtonOptions;
+        warning: SnackbarActionButtonOptions;
+        error: SnackbarActionButtonOptions;
+    }
+}
+export {};

package/dist/react-sdk/notifications/snackbar-action-button.js

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

package/dist/react-sdk/page-elements/ConfigurationNotFoundPagePropsProvider.d.ts

@@ -0,0 +1,17 @@
+import { type PropsWithChildren } from 'react';
+import type { ConfigurationNotFoundPageProps } from '../session/index.js';
+interface ConfigurationNotFoundPagePropsProviderProps extends PropsWithChildren {
+    readonly value: ConfigurationNotFoundPageProps;
+}
+/**
+ * @internal Runtime plumbing behind `createConfigurationNotFoundPage`, for the SDK's own UI. The
+ * configurator's renderer of the `ConfigurationNotFoundPage` element provides the page's props through
+ * it, because an element slot is typed as taking only `children`.
+ */
+export declare const ConfigurationNotFoundPagePropsProvider: (props: ConfigurationNotFoundPagePropsProviderProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * @internal Exists for the SDK's own UI and for `createConfigurationNotFoundPage`, which read the
+ * props of the `ConfigurationNotFoundPage` element through it.
+ */
+export declare const useConfigurationNotFoundPageProps: () => ConfigurationNotFoundPageProps;
+export {};

package/dist/react-sdk/page-elements/ConfigurationNotFoundPagePropsProvider.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{createContext as r,useContext as t}from"react";let e=r({});export const ConfigurationNotFoundPagePropsProvider=r=>{let{value:t,children:n}=r;return o(e.Provider,{value:t,children:n})};export const useConfigurationNotFoundPageProps=()=>t(e);

package/dist/react-sdk/page-elements/ConfiguratorErrorPagePropsProvider.d.ts

@@ -0,0 +1,17 @@
+import { type PropsWithChildren } from 'react';
+import type { ConfiguratorErrorPageProps } from './configurator-error-page-props.js';
+interface ConfiguratorErrorPagePropsProviderProps extends PropsWithChildren {
+    readonly value: ConfiguratorErrorPageProps;
+}
+/**
+ * @internal Runtime plumbing behind `createConfiguratorErrorPage`, for the SDK's own UI. The
+ * configurator's renderer of the `ConfiguratorErrorPage` element provides the page's props through it,
+ * because an element slot is typed as taking only `children`.
+ */
+export declare const ConfiguratorErrorPagePropsProvider: (props: ConfiguratorErrorPagePropsProviderProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * @internal Exists for the SDK's own UI and for `createConfiguratorErrorPage`, which read the props
+ * of the `ConfiguratorErrorPage` element through it.
+ */
+export declare const useConfiguratorErrorPageProps: () => ConfiguratorErrorPageProps;
+export {};

package/dist/react-sdk/page-elements/ConfiguratorErrorPagePropsProvider.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 ConfiguratorErrorPagePropsProvider=e=>{let{value:o,children:i}=e;return r(t.Provider,{value:o,children:i})};export const useConfiguratorErrorPageProps=()=>{let r=o(t);if(void 0===r)throw Error("The ConfiguratorErrorPage element was rendered without its props. Only the configurator renders this element, inside ConfiguratorErrorPagePropsProvider; render the element through the configurator instead of mounting it directly.");return r};

package/dist/react-sdk/page-elements/configurator-error-page-props.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Why the configurator shows its error page:
+ * - `uncaughtError`: rendering the configurator failed with an error nothing else handled;
+ * - `presetCreationFailed`: starting a configuration from a preset failed on a start screen that has
+ *   no preset grid to return to (a single preset).
+ */
+export type ConfiguratorErrorReason = 'uncaughtError' | 'presetCreationFailed';
+/**
+ * The props of the `ConfiguratorErrorPage` element, the page the configurator shows in production
+ * when it cannot go on; a project registers its page with `createConfiguratorErrorPage`. In
+ * development the configurator shows its detailed error pages instead.
+ */
+export interface ConfiguratorErrorPageProps {
+    readonly reason: ConfiguratorErrorReason;
+    /**
+     * Tries again: after an `uncaughtError` it renders the configurator again, after
+     * `presetCreationFailed` it reloads the page.
+     */
+    readonly onRetry: () => void;
+}

package/dist/react-sdk/page-elements/configurator-error-page-props.js

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

package/dist/react-sdk/page-elements/create-configuration-not-found-page.d.ts

@@ -0,0 +1,15 @@
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+import type { ConfigurationNotFoundPageProps } from '../session/index.js';
+/**
+ * The name a project registers a layout element under to replace the page shown when a configuration
+ * cannot be loaded or opened. Its default, the built-in `ConfigurationNotFoundPage`, is registered in
+ * `defaultConfiguratorElements`.
+ */
+export declare const ConfigurationNotFoundPageName = "ConfigurationNotFoundPage";
+/**
+ * Registers a project's "configuration not accessible" page as the `ConfigurationNotFoundPage`
+ * element, with its props typed. Registering a layout element under that name with
+ * `createCustomPhoenixLayoutElement` works too, but its component is typed as taking only `children`.
+ */
+export declare const createConfigurationNotFoundPage: (Element: (props: ConfigurationNotFoundPageProps) => JSX.Element) => PhoenixLayoutElementRegistration;
+export type CreateConfigurationNotFoundPage = (Element: (props: ConfigurationNotFoundPageProps) => JSX.Element) => PhoenixLayoutElementRegistration;

package/dist/react-sdk/page-elements/create-configuration-not-found-page.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as t}from"#package/domain";import{useConfigurationNotFoundPageProps as n}from"./ConfigurationNotFoundPagePropsProvider.js";export const ConfigurationNotFoundPageName="ConfigurationNotFoundPage";export const createConfigurationNotFoundPage=r=>t("ConfigurationNotFoundPage",()=>o(r,{...n()}));

package/dist/react-sdk/page-elements/create-configurator-error-page.d.ts

@@ -0,0 +1,14 @@
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+import type { ConfiguratorErrorPageProps } from './configurator-error-page-props.js';
+/**
+ * The name a project registers a layout element under to replace the configurator's production error
+ * page. Its default, the built-in error page, is registered in `defaultConfiguratorElements`.
+ */
+export declare const ConfiguratorErrorPageName = "ConfiguratorErrorPage";
+/**
+ * Registers a project's production error page as the `ConfiguratorErrorPage` element, with its props
+ * typed. Registering a layout element under that name with `createCustomPhoenixLayoutElement` works
+ * too, but its component is typed as taking only `children`.
+ */
+export declare const createConfiguratorErrorPage: (Element: (props: ConfiguratorErrorPageProps) => JSX.Element) => PhoenixLayoutElementRegistration;
+export type CreateConfiguratorErrorPage = (Element: (props: ConfiguratorErrorPageProps) => JSX.Element) => PhoenixLayoutElementRegistration;

package/dist/react-sdk/page-elements/create-configurator-error-page.js

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as o}from"#package/domain";import{useConfiguratorErrorPageProps as a}from"./ConfiguratorErrorPagePropsProvider.js";export const ConfiguratorErrorPageName="ConfiguratorErrorPage";export const createConfiguratorErrorPage=t=>o("ConfiguratorErrorPage",()=>r(t,{...a()}));

package/dist/react-sdk/page-elements/create-preset-ui.d.ts

@@ -0,0 +1,9 @@
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+/**
+ * The name a project registers a layout element under to replace the whole preset screen. Its
+ * default, the built-in preset screen, is registered in `defaultConfiguratorElements`.
+ */
+export declare const PresetUiName = "PresetUi";
+/** Registers a project's preset screen as the `PresetUi` element. */
+export declare const createPresetUi: (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;
+export type CreatePresetUi = (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;

package/dist/react-sdk/page-elements/create-preset-ui.js

@@ -0,0 +1 @@
+import{createCustomPhoenixLayoutElement as e}from"#package/domain";export const PresetUiName="PresetUi";export const createPresetUi=t=>e("PresetUi",t);

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

@@ -0,0 +1,6 @@
+export type { ConfiguratorErrorPageProps, ConfiguratorErrorReason } from './configurator-error-page-props.js';
+export { ConfiguratorErrorPagePropsProvider, useConfiguratorErrorPageProps, } from './ConfiguratorErrorPagePropsProvider.js';
+export { ConfiguratorErrorPageName, createConfiguratorErrorPage, type CreateConfiguratorErrorPage, } from './create-configurator-error-page.js';
+export { ConfigurationNotFoundPagePropsProvider, useConfigurationNotFoundPageProps, } from './ConfigurationNotFoundPagePropsProvider.js';
+export { ConfigurationNotFoundPageName, createConfigurationNotFoundPage, type CreateConfigurationNotFoundPage, } from './create-configuration-not-found-page.js';
+export { PresetUiName, createPresetUi, type CreatePresetUi } from './create-preset-ui.js';

package/dist/react-sdk/page-elements/index.js

@@ -0,0 +1 @@
+export{ConfiguratorErrorPagePropsProvider,useConfiguratorErrorPageProps}from"./ConfiguratorErrorPagePropsProvider.js";export{ConfiguratorErrorPageName,createConfiguratorErrorPage}from"./create-configurator-error-page.js";export{ConfigurationNotFoundPagePropsProvider,useConfigurationNotFoundPageProps}from"./ConfigurationNotFoundPagePropsProvider.js";export{ConfigurationNotFoundPageName,createConfigurationNotFoundPage}from"./create-configuration-not-found-page.js";export{PresetUiName,createPresetUi}from"./create-preset-ui.js";

package/dist/react-sdk/preset-selection/PresetSelectionProvider.js

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{useMutation as t}from"@tanstack/react-query";import{useSnackbar as i}from"notistack";import{useSubscription as r}from"observable-hooks";import{createContext as o,useCallback as n,useContext as s,useEffect as a,useMemo as l,useState as m}from"react";import{skip as p}from"rxjs";import{match as d}from"ts-pattern";import{AuthorizedClient as c,LocalStorageAuthorizedPhoenixApiClient as g,MemoryAuthorizedPhoenixApiClient as u}from"#package/client";import{SYSTEM_CHUNK_KEY as f,standardWebComponentProperties as h}from"#package/domain";import{ApplicationRoutes as y,FrontendAnalyticsFactory as x,useAnalyticsService as P,useAuthenticatedClient as v,useConfiguratorDomainFactory as w,useIsDev as C,useLogger as T,usePersistenceConfig as D,usePublishedData as S,useRoutingSelectors as k,useSessionService as E,useSpecPresetSeed as b,useWebComponentProperty$ as j}from"../application-runtime/index.js";import{useConfiguratorRouting as A}from"../configurator-routing/index.js";import{useOnPresetLoadedHandler as I}from"../domain-application-context/index.js";import{useEagerObservableValue as V}from"../domain-context/index.js";import{useResolveLocalizable as $}from"../localizable/index.js";let F={id:"sdk.presets.create.error.message",message:"Could not start configuring from this preset. Please try again."},M={id:"sdk.presets.create.error.dismiss.label",message:"Dismiss"},R="phx-preset-creation-error";export const PresetSelectionContext=o(null);export const usePresetSelection=()=>{let e=s(PresetSelectionContext);if(null===e)throw Error("usePresetSelection must be used within a PresetSelectionProvider!");return e};let q=e=>t=>null===e||void 0!==t.tags&&t.tags.some(t=>e.includes(t));export const PresetSelectionProvider=o=>{let{children:s}=o,[z,B]=m(null),[U,G]=m(null),H=b(),J=v(),K=P(),L=D(),N=w(),O=C(),Q=$(),{requestSessionToken:W}=E(),X=T(),Y=A(),Z=k(),_=S(),{enqueueSnackbar:ee,closeSnackbar:et}=i(),ei=j(h.presetTags),er=V(ei),eo=I();r(l(()=>ei.pipe(p(1)),[ei]),()=>{Z.getRoutingState().route!==y.Index&&Y.goToIndex()}),a(()=>{G(null),et(R)},[O,et]);let{mutate:en}=t({mutationFn:n(async e=>{let{getData:t,name:i}=e,{rootEntityType:r,entities:o,modelVersion:n}=await t(),s=N.validateAndMigrateState(o,n);K.push(x.ProductSelected(r,Q(i)));let a=eo?await eo(s):s;return J.createConfiguration({rootEntityType:r,data:a})},[N,K,Q,J,eo]),onSuccess:e=>{Y.goToConfigurationDetail(e.configurationId,e.accessToken)},onError:(e,t)=>{X.error("Failed to create a new configuration from a preset!",{name:t.name},e),G(e)},onSettled:()=>{B(null)}}),es=l(()=>{let e,t=(e=f in _?_[f].presetCategories:_.presetCategories,{publishedPresetCategories:(e??[]).map(e=>({...e,presets:e.presets.filter(q(er))})).filter(e=>e.presets.length>0),seedPresets:H.filter(q(er))});return t.publishedPresetCategories.length>0?t.publishedPresetCategories.map(e=>({id:e.id,name:e.name,description:e.description,img:e.img,imgAlt:e.imgAlt,presets:e.presets.map(e=>({id:e.configurationId,name:e.name,description:e.description,img:e?.img,imgAlt:e?.imgAlt,detailTitle:e?.detailTitle,detailDescription:e?.detailDescription,getData:async()=>{let t=d(L).with({type:"server"},t=>new c(t.serverUrl,()=>e.readToken,W)).with({type:"local-storage"},()=>new g(N.modelVersion)).with({type:"memory"},()=>new u(N.modelVersion)).exhaustive(),i=await t.getConfigurationRevision(e.configurationId,e.revisionId);return{entities:i.data,rootEntityType:i.rootEntityType,modelVersion:i.modelVersion}}}))})):t.seedPresets.length>0?[{id:"Default",name:"Default Category",presets:t.seedPresets.map((e,t)=>({id:`${t}`,name:e.name??`${e.rootEntityType} preset - ${t}`,description:e.description??"",img:e.img,imgAlt:e.imgAlt,detailTitle:e.detailTitle,detailDescription:e.detailDescription,getData:async()=>({entities:e.initialDomainEntities,rootEntityType:e.rootEntityType,modelVersion:N.modelVersion})}))}]:[]},[_,W,L,N,er,H]),ea=l(()=>es.flatMap(e=>e.presets),[es]),el=n(e=>{let t=ea.find(t=>t.id===e);if(void 0===t)throw Error(`Preset with id ${e} not found!`);let{getData:i,name:r}=t,o=!O&&ea.length>1;G(null),B(e),en({getData:i,name:r},{onError:()=>{o&&(et(R),ee(Q(F),{variant:"error",key:R,persist:!0,preventDuplicate:!0,actionButton:{label:Q(M),onClick:e=>{G(null),et(e)}}}))}})},[ea,O,en,ee,et,Q]),em=ea.length>1,ep=l(()=>({hasMultiplePresets:em,presetCategories:es,selectPreset:el,selectionError:U,creatingPresetId:z}),[el,em,es,U,z]);return e(PresetSelectionContext.Provider,{value:ep,children:s})};

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

@@ -0,0 +1 @@
+export { usePresetSelection, type UsePresetSelection, PresetSelectionProvider, type PresetSelectionProviderProps, } from './PresetSelectionProvider.js';

package/dist/react-sdk/preset-selection/index.js

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

package/dist/react-sdk/provider-slots/ConfiguratorProviderSlotHost.d.ts

@@ -0,0 +1,11 @@
+import type { PropsWithChildren } from 'react';
+import type { ConfiguratorProviderSlot } from './configurator-provider-slot.js';
+interface ConfiguratorProviderSlotHostProps extends PropsWithChildren {
+    readonly slot: ConfiguratorProviderSlot;
+}
+/**
+ * @internal Renders the provider registered under the slot's name around its children, and only the
+ * children when nothing is registered.
+ */
+export declare const ConfiguratorProviderSlotHost: ({ slot, children }: ConfiguratorProviderSlotHostProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/react-sdk/provider-slots/ConfiguratorProviderSlotHost.js

@@ -0,0 +1 @@
+import{jsx as e,Fragment as t}from"react/jsx-runtime";import{PhoenixLayoutElement as o}from"../elements/index.js";let r={};export const ConfiguratorProviderSlotHost=({slot:m,children:n})=>e(o,{name:m,elementProps:r,defaultSlot:t,children:n});

package/dist/react-sdk/provider-slots/configurator-provider-slot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @internal The named provider slots of the configurator, outside in, for the SDK's own UI. The
+ * configurator composes its runtime providers around them: a slot renders the provider registered
+ * under its name around its children, and only its children when nothing is registered, so the
+ * lifecycle runs without the UI.
+ *
+ * The configurator's UI registers its visual providers in `defaultConfiguratorElements`. Each slot
+ * sits where its provider sat before it was a slot, and the order is load-bearing: the theme wraps the
+ * loader host, the app loader wraps the preview, the session and the routing, and the scene resources
+ * wrap the `On*` lifecycle. The error boundary between the message host and the scene resources, and
+ * the dialog host inside `OnRoutingReady`, are runtime and never sit in a slot.
+ */
+export declare enum ConfiguratorProviderSlot {
+    /** The encapsulated MUI theme, around the loader host. */
+    Theme = "ConfiguratorThemeProvider",
+    /** The configurator's root container, which measures itself into the runtime's responsive state. */
+    Container = "ConfiguratorContainerProvider",
+    /** The app loader overlay, around the preview, the session and the routing. */
+    Loader = "ConfiguratorLoaderProvider",
+    /** The snackbar host, around the error boundary of the whole configurator. */
+    MessageHost = "ConfiguratorMessageHostProvider",
+    /** The scene's shared resources, inside the error boundary and around the `On*` lifecycle. */
+    SceneResources = "ConfiguratorSceneResourcesProvider"
+}

package/dist/react-sdk/provider-slots/configurator-provider-slot.js

@@ -0,0 +1 @@
+var r;export var ConfiguratorProviderSlot=((r={}).Theme="ConfiguratorThemeProvider",r.Container="ConfiguratorContainerProvider",r.Loader="ConfiguratorLoaderProvider",r.MessageHost="ConfiguratorMessageHostProvider",r.SceneResources="ConfiguratorSceneResourcesProvider",r);

package/dist/react-sdk/provider-slots/create-configurator-provider-slot.d.ts

@@ -0,0 +1,5 @@
+import type { PropsWithChildren } from 'react';
+import { type PhoenixLayoutElementRegistration } from '#package/domain';
+import type { ConfiguratorProviderSlot } from './configurator-provider-slot.js';
+/** @internal Registers the SDK's own UI as the provider of a slot. */
+export declare const createConfiguratorProviderSlot: (slot: ConfiguratorProviderSlot, Element: (props: PropsWithChildren) => JSX.Element) => PhoenixLayoutElementRegistration;

package/dist/react-sdk/provider-slots/create-configurator-provider-slot.js

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

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

@@ -0,0 +1,3 @@
+export { ConfiguratorProviderSlot } from './configurator-provider-slot.js';
+export { ConfiguratorProviderSlotHost } from './ConfiguratorProviderSlotHost.js';
+export { createConfiguratorProviderSlot } from './create-configurator-provider-slot.js';

package/dist/react-sdk/provider-slots/index.js

@@ -0,0 +1 @@
+export{ConfiguratorProviderSlot}from"./configurator-provider-slot.js";export{ConfiguratorProviderSlotHost}from"./ConfiguratorProviderSlotHost.js";export{createConfiguratorProviderSlot}from"./create-configurator-provider-slot.js";

package/dist/react-sdk/scene-control-elements/AddEntityFabElement.d.ts

@@ -0,0 +1,36 @@
+import type { Localizable } from '@salsita-ai/common/utils';
+import type { DomainEntityId } from '#package/domain';
+import type { SceneControlTooltipVisibility } from './scene-control-tooltip-visibility.js';
+/**
+ * The name of the entity element that renders a `sceneEntityAddFab`. Its default, the built-in
+ * add-entity FAB, is registered in `defaultConfiguratorElements`.
+ */
+export declare const AddEntityFabName = "AddEntityFab";
+/**
+ * Props of the `AddEntityFab` element, rendered for each `sceneEntityAddFab` of an entity, at the
+ * position the component sets. The recipes it can add are not computed up front: the built-in FAB
+ * reads them with `useGroupedRecipeOptions(entityId, instanceNames, fixableViolations)` when it
+ * opens its menu, and a replacement does the same.
+ */
+export interface AddEntityFabElementProps {
+    /** The entity the FAB adds children to. */
+    readonly entityId: DomainEntityId<string>;
+    /** The `childEntityRecipes` instances whose recipes the FAB offers; all of them when not set. */
+    readonly instanceNames?: readonly string[];
+    /** Violations a new entity may cause without disabling its recipe (the component's `hiddenViolations`). */
+    readonly fixableViolations?: readonly string[];
+    /** The name of a Phoenix icon. */
+    readonly icon?: string;
+    /** A visible text label. */
+    readonly label?: Localizable;
+    /** The tooltip text. */
+    readonly title?: Localizable;
+    /** When the tooltip shows: `on-hover` unless the component sets it. */
+    readonly tooltipVisibility: SceneControlTooltipVisibility;
+    /** Add the only recipe directly, without a menu. */
+    readonly skipMenuWhenOnlyOne?: boolean;
+    /** Render nothing when there is no recipe. */
+    readonly hideWhenNone?: boolean;
+}
+/** Renders the `AddEntityFab` element for an entity. */
+export declare const AddEntityFabElement: import("react").MemoExoticComponent<(props: AddEntityFabElementProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/react-sdk/scene-control-elements/AddEntityFabElement.js

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{memo as e,useMemo as n}from"react";import{PhoenixEntityElementWithChildren as r}from"../elements/index.js";export const AddEntityFabName="AddEntityFab";export const AddEntityFabElement=e(e=>{let{entityId:d,instanceNames:i,fixableViolations:m,icon:o,label:a,title:s,tooltipVisibility:p,skipMenuWhenOnlyOne:x,hideWhenNone:y}=e,E=n(()=>({instanceNames:i,fixableViolations:m,icon:o,label:a,title:s,tooltipVisibility:p,skipMenuWhenOnlyOne:x,hideWhenNone:y}),[i,m,o,a,s,p,x,y]);return t(r,{kind:"AddEntityFab",entityId:d,elementProps:E})});