@salsita-ai/sdk 0.50.0-develop.f03b563886 → 0.50.0-develop.f16492b14e

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/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})});

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

@@ -0,0 +1,44 @@
+import { type SyntheticEvent } from 'react';
+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 `sceneEntityDeleteFab`. Its default, the built-in
+ * delete-entity FAB, is registered in `defaultConfiguratorElements`.
+ */
+export declare const DeleteEntityFabName = "DeleteEntityFab";
+/**
+ * Props of the `DeleteEntityFab` element, rendered for each `sceneEntityDeleteFab` of an entity, at
+ * the position the component sets.
+ */
+export interface DeleteEntityFabElementProps {
+    /** The entity the FAB deletes. */
+    readonly entityId: DomainEntityId<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;
+    /**
+     * Deletes the entity and pushes the delete analytics event. Pass it straight to `onClick`: given
+     * an event, it stops the event's propagation so the click does not reach the scene.
+     */
+    readonly onDelete: (event?: SyntheticEvent) => void;
+    /** True when deleting would cause a violation the component does not allow. */
+    readonly disabled: boolean;
+    /** Why deleting is disabled, when it is. */
+    readonly disabledHint: string | undefined;
+    /** Logs the dry run of the deletion to the console, for debugging. */
+    readonly trace: () => void;
+}
+type DeleteEntityFabElementConfig = Omit<DeleteEntityFabElementProps, 'onDelete' | 'disabled' | 'disabledHint' | 'trace'>;
+interface Props extends DeleteEntityFabElementConfig {
+    /** Violations deleting may cause without disabling the FAB (the component's `hiddenViolations`). */
+    readonly fixableViolations?: readonly string[];
+}
+/** Renders the `DeleteEntityFab` element for an entity, with the deletion it performs. */
+export declare const DeleteEntityFabElement: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{memo as e,useCallback as i,useMemo as o}from"react";import{FrontendAnalyticsFactory as n}from"../application-runtime/index.js";import{useDeletedEntity as r}from"../domain-controls/index.js";import{PhoenixEntityElementWithChildren as m}from"../elements/index.js";export const DeleteEntityFabName="DeleteEntityFab";export const DeleteEntityFabElement=e(e=>{let{entityId:a,fixableViolations:s,icon:l,label:p,title:d,tooltipVisibility:c}=e,x=i(()=>n.EntityDeleteHotspotClicked(a),[a]),{disabled:y,hints:E,remove:b,trace:f}=r(a,s,x),j=i(t=>{t?.stopPropagation(),b()},[b]),D=o(()=>({icon:l,label:p,title:d,tooltipVisibility:c,onDelete:j,disabled:y,disabledHint:E,trace:f}),[l,p,d,c,j,y,E,f]);return t(m,{kind:"DeleteEntityFab",entityId:a,elementProps:D})});

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

@@ -0,0 +1,38 @@
+import { type SyntheticEvent } from 'react';
+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 `sceneEntityNavigationHotspot`. Its default, the
+ * built-in navigation hotspot, is registered in `defaultConfiguratorElements`.
+ */
+export declare const NavigationHotspotName = "NavigationHotspot";
+/**
+ * Props of the `NavigationHotspot` element, rendered for each `sceneEntityNavigationHotspot` of an
+ * entity, at the position the component sets.
+ */
+export interface NavigationHotspotElementProps {
+    /** The entity the hotspot is attached to. */
+    readonly entityId: DomainEntityId<string>;
+    /** The navigation state the hotspot goes to. */
+    readonly navigationState: string;
+    /** The tooltip text. */
+    readonly title?: Localizable;
+    /** When the tooltip shows: `on-hover` unless the component sets it. */
+    readonly tooltipVisibility: SceneControlTooltipVisibility;
+    /**
+     * Goes to `navigationState`, pushed onto the navigation stack or replacing the current state as
+     * the component sets. Pass it straight to `onClick`: given an event, it prevents the event's
+     * default and stops its propagation so the click does not reach the scene.
+     */
+    readonly onNavigate: (event?: SyntheticEvent) => void;
+}
+interface Props extends Omit<NavigationHotspotElementProps, 'onNavigate'> {
+    /** Push `navigationState` onto the navigation stack instead of replacing the current state. */
+    readonly pushToStack?: boolean;
+    /** The states `navigationState` can be stacked onto. */
+    readonly canStackOnto?: readonly string[];
+}
+/** Renders the `NavigationHotspot` element for an entity, with the navigation it performs. */
+export declare const NavigationHotspotElement: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{memo as e,useCallback as o,useMemo as a}from"react";import{useDomain as i}from"../domain-context/index.js";import{PhoenixEntityElementWithChildren as n}from"../elements/index.js";export const NavigationHotspotName="NavigationHotspot";export const NavigationHotspotElement=e(e=>{let{entityId:s,navigationState:m,pushToStack:r,canStackOnto:p,title:g,tooltipVisibility:d}=e,{navigationSystem:l,storeSystem:v}=i(),c=o(t=>{t?.preventDefault(),t?.stopPropagation();let e=r?l.getPushNavigationUpdate(m,v.stateSlices.committed.value.state,{canStackOnto:p}):l.getNavigationUpdate(m);v.stageAndCommit([e])},[l,m,r,v,p]);return t(n,{kind:"NavigationHotspot",entityId:s,elementProps:a(()=>({navigationState:m,title:g,tooltipVisibility:d,onNavigate:c}),[m,g,d,c])})});

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

@@ -0,0 +1,30 @@
+import { type SyntheticEvent } from 'react';
+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 `sceneEntitySelectHotspot`. Its default, the
+ * built-in selection hotspot, is registered in `defaultConfiguratorElements`.
+ */
+export declare const SelectionHotspotName = "SelectionHotspot";
+/**
+ * Props of the `SelectionHotspot` element, rendered for each `sceneEntitySelectHotspot` of an
+ * entity, at the position the component sets.
+ */
+export interface SelectionHotspotElementProps {
+    /** The entity the hotspot selects. */
+    readonly entityId: DomainEntityId<string>;
+    /** The tooltip text. */
+    readonly title?: Localizable;
+    /** When the tooltip shows: `on-hover` unless the component sets it. */
+    readonly tooltipVisibility: SceneControlTooltipVisibility;
+    /**
+     * Selects the entity and pushes the selection-hotspot analytics event. Pass it straight to
+     * `onClick`: given an event, it stops the event's propagation so the click does not reach the scene.
+     */
+    readonly onSelect: (event?: SyntheticEvent) => void;
+}
+type Props = Omit<SelectionHotspotElementProps, 'onSelect'>;
+/** Renders the `SelectionHotspot` element for an entity, with the selection it performs. */
+export declare const SelectionHotspotElement: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{memo as o,useCallback as e,useMemo as i}from"react";import{FrontendAnalyticsFactory as n}from"../application-runtime/index.js";import{useSelectEntity as r}from"../domain-context/index.js";import{PhoenixEntityElementWithChildren as m}from"../elements/index.js";export const SelectionHotspotName="SelectionHotspot";export const SelectionHotspotElement=o(o=>{let{entityId:p,title:s,tooltipVisibility:c}=o,l=r(n.SelectionHotspotClicked),a=e(t=>{t?.stopPropagation(),l(p)},[p,l]);return t(m,{kind:"SelectionHotspot",entityId:p,elementProps:i(()=>({title:s,tooltipVisibility:c,onSelect:a}),[s,c,a])})});

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

@@ -0,0 +1,30 @@
+import type { Localizable } from '@salsita-ai/common/utils';
+import type { DomainEntityId, ToolMenuFabOption } from '#package/domain';
+import type { SceneControlTooltipVisibility } from './scene-control-tooltip-visibility.js';
+/**
+ * The name of the entity element that renders a `toolMenuFab`. Its default, the built-in tool-menu
+ * FAB, is registered in `defaultConfiguratorElements`.
+ */
+export declare const ToolMenuFabName = "ToolMenuFab";
+/**
+ * Props of the `ToolMenuFab` element, rendered for each `toolMenuFab` of an entity, at the position
+ * the component sets.
+ */
+export interface ToolMenuFabElementProps {
+    /** The entity the FAB is attached to. */
+    readonly entityId: DomainEntityId<string>;
+    /** The tools the menu offers, each with its `label`, optional `icon` and `toolState`. */
+    readonly options: readonly ToolMenuFabOption[];
+    /** The name of a Phoenix icon; the built-in FAB shows `PencilSimpleBold` when it is not set. */
+    readonly icon?: string;
+    /** The tooltip text, which the built-in menu also shows as its heading. */
+    readonly title?: Localizable;
+    /** When the tooltip shows: `on-hover` unless the component sets it. */
+    readonly tooltipVisibility: SceneControlTooltipVisibility;
+    /** Switches to the given tool state, the `toolState` of one of the `options`. */
+    readonly onSelectTool: (toolState: string) => void;
+}
+type Props = Omit<ToolMenuFabElementProps, 'onSelectTool'>;
+/** Renders the `ToolMenuFab` element for an entity, with the tool switch it performs. */
+export declare const ToolMenuFabElement: import("react").MemoExoticComponent<(props: Props) => import("react/jsx-runtime").JSX.Element>;
+export {};

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

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{memo as o,useCallback as t,useMemo as n}from"react";import{useDomain as m}from"../domain-context/index.js";import{PhoenixEntityElementWithChildren as r}from"../elements/index.js";export const ToolMenuFabName="ToolMenuFab";export const ToolMenuFabElement=o(o=>{let{entityId:a,options:i,icon:s,title:l,tooltipVisibility:p}=o,{navigationSystem:d,storeSystem:x}=m(),u=t(e=>{x.stageAndCommit([d.getToolUpdate(e)])},[d,x]);return e(r,{kind:"ToolMenuFab",entityId:a,elementProps:n(()=>({options:i,icon:s,title:l,tooltipVisibility:p,onSelectTool:u}),[i,s,l,p,u])})});

package/dist/react-sdk/scene-control-elements/create-add-entity-fab.d.ts

@@ -0,0 +1,9 @@
+import { type PhoenixEntityElementRegistration } from '#package/domain';
+import { type AddEntityFabElementProps } from './AddEntityFabElement.js';
+/**
+ * Registers a project's add-entity FAB as the `AddEntityFab` entity element, with its props typed.
+ * Registering an entity element under that name with `createCustomPhoenixEntityElement` works too,
+ * but its component is then typed as taking only `entityId` and `children`.
+ */
+export declare const createAddEntityFab: (Element: (props: AddEntityFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;
+export type CreateAddEntityFab = (Element: (props: AddEntityFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;

package/dist/react-sdk/scene-control-elements/create-add-entity-fab.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as t}from"#package/domain";import{AddEntityFabName as o}from"./AddEntityFabElement.js";export const createAddEntityFab=a=>t(o,a);

package/dist/react-sdk/scene-control-elements/create-delete-entity-fab.d.ts

@@ -0,0 +1,9 @@
+import { type PhoenixEntityElementRegistration } from '#package/domain';
+import { type DeleteEntityFabElementProps } from './DeleteEntityFabElement.js';
+/**
+ * Registers a project's delete-entity FAB as the `DeleteEntityFab` entity element, with its props
+ * typed. Registering an entity element under that name with `createCustomPhoenixEntityElement`
+ * works too, but its component is then typed as taking only `entityId` and `children`.
+ */
+export declare const createDeleteEntityFab: (Element: (props: DeleteEntityFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;
+export type CreateDeleteEntityFab = (Element: (props: DeleteEntityFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;

package/dist/react-sdk/scene-control-elements/create-delete-entity-fab.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as e}from"#package/domain";import{DeleteEntityFabName as t}from"./DeleteEntityFabElement.js";export const createDeleteEntityFab=o=>e(t,o);

package/dist/react-sdk/scene-control-elements/create-navigation-hotspot.d.ts

@@ -0,0 +1,10 @@
+import { type PhoenixEntityElementRegistration } from '#package/domain';
+import { type NavigationHotspotElementProps } from './NavigationHotspotElement.js';
+/**
+ * Registers a project's navigation hotspot as the `NavigationHotspot` entity element, with its
+ * props typed. Registering an entity element under that name with
+ * `createCustomPhoenixEntityElement` works too, but its component is then typed as taking only
+ * `entityId` and `children`.
+ */
+export declare const createNavigationHotspot: (Element: (props: NavigationHotspotElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;
+export type CreateNavigationHotspot = (Element: (props: NavigationHotspotElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;

package/dist/react-sdk/scene-control-elements/create-navigation-hotspot.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as o}from"#package/domain";import{NavigationHotspotName as t}from"./NavigationHotspotElement.js";export const createNavigationHotspot=a=>o(t,a);

package/dist/react-sdk/scene-control-elements/create-selection-hotspot.d.ts

@@ -0,0 +1,9 @@
+import { type PhoenixEntityElementRegistration } from '#package/domain';
+import { type SelectionHotspotElementProps } from './SelectionHotspotElement.js';
+/**
+ * Registers a project's selection hotspot as the `SelectionHotspot` entity element, with its props
+ * typed. Registering an entity element under that name with `createCustomPhoenixEntityElement`
+ * works too, but its component is then typed as taking only `entityId` and `children`.
+ */
+export declare const createSelectionHotspot: (Element: (props: SelectionHotspotElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;
+export type CreateSelectionHotspot = (Element: (props: SelectionHotspotElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;

package/dist/react-sdk/scene-control-elements/create-selection-hotspot.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as o}from"#package/domain";import{SelectionHotspotName as t}from"./SelectionHotspotElement.js";export const createSelectionHotspot=e=>o(t,e);

package/dist/react-sdk/scene-control-elements/create-tool-menu-fab.d.ts

@@ -0,0 +1,9 @@
+import { type PhoenixEntityElementRegistration } from '#package/domain';
+import { type ToolMenuFabElementProps } from './ToolMenuFabElement.js';
+/**
+ * Registers a project's tool-menu FAB as the `ToolMenuFab` entity element, with its props typed.
+ * Registering an entity element under that name with `createCustomPhoenixEntityElement` works too,
+ * but its component is then typed as taking only `entityId` and `children`.
+ */
+export declare const createToolMenuFab: (Element: (props: ToolMenuFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;
+export type CreateToolMenuFab = (Element: (props: ToolMenuFabElementProps) => JSX.Element | null) => PhoenixEntityElementRegistration;

package/dist/react-sdk/scene-control-elements/create-tool-menu-fab.js

@@ -0,0 +1 @@
+import{createCustomPhoenixEntityElement as o}from"#package/domain";import{ToolMenuFabName as e}from"./ToolMenuFabElement.js";export const createToolMenuFab=a=>o(e,a);

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

@@ -0,0 +1,11 @@
+export { AddEntityFabElement, AddEntityFabName, type AddEntityFabElementProps } from './AddEntityFabElement.js';
+export { DeleteEntityFabElement, DeleteEntityFabName, type DeleteEntityFabElementProps, } from './DeleteEntityFabElement.js';
+export { NavigationHotspotElement, NavigationHotspotName, type NavigationHotspotElementProps, } from './NavigationHotspotElement.js';
+export { SelectionHotspotElement, SelectionHotspotName, type SelectionHotspotElementProps, } from './SelectionHotspotElement.js';
+export { ToolMenuFabElement, ToolMenuFabName, type ToolMenuFabElementProps } from './ToolMenuFabElement.js';
+export { createAddEntityFab, type CreateAddEntityFab } from './create-add-entity-fab.js';
+export { createDeleteEntityFab, type CreateDeleteEntityFab } from './create-delete-entity-fab.js';
+export { createNavigationHotspot, type CreateNavigationHotspot } from './create-navigation-hotspot.js';
+export { createSelectionHotspot, type CreateSelectionHotspot } from './create-selection-hotspot.js';
+export { createToolMenuFab, type CreateToolMenuFab } from './create-tool-menu-fab.js';
+export { type SceneControlTooltipVisibility } from './scene-control-tooltip-visibility.js';

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

@@ -0,0 +1 @@
+export{AddEntityFabElement,AddEntityFabName}from"./AddEntityFabElement.js";export{DeleteEntityFabElement,DeleteEntityFabName}from"./DeleteEntityFabElement.js";export{NavigationHotspotElement,NavigationHotspotName}from"./NavigationHotspotElement.js";export{SelectionHotspotElement,SelectionHotspotName}from"./SelectionHotspotElement.js";export{ToolMenuFabElement,ToolMenuFabName}from"./ToolMenuFabElement.js";export{createAddEntityFab}from"./create-add-entity-fab.js";export{createDeleteEntityFab}from"./create-delete-entity-fab.js";export{createNavigationHotspot}from"./create-navigation-hotspot.js";export{createSelectionHotspot}from"./create-selection-hotspot.js";export{createToolMenuFab}from"./create-tool-menu-fab.js";

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

@@ -0,0 +1,5 @@
+/**
+ * When an in-scene control shows its tooltip: `on-hover` on hover, `forced` always once the camera
+ * has been still, `forced-when-still` while the camera is still, `hidden` never.
+ */
+export type SceneControlTooltipVisibility = 'on-hover' | 'forced' | 'forced-when-still' | 'hidden';

package/dist/react-sdk/scene-control-elements/scene-control-tooltip-visibility.js

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

package/dist/react-sdk/session/NotAuthenticatedPage.d.ts

@@ -1,4 +1,8 @@
 import { type PhoenixLayoutElementRegistration } from '#package/domain';
 export declare const createNotAuthenticatedPage: (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;
 export type CreateNotAuthenticatedPage = (Element: () => JSX.Element) => PhoenixLayoutElementRegistration;
+/**
+ * Renders the `NotAuthenticatedPage` element. Its default, the configurator's built-in page, comes from
+ * `defaultConfiguratorElements`; a project element registered under the name replaces it.
+ */
 export declare const NotAuthenticatedPage: () => import("react/jsx-runtime").JSX.Element;

package/dist/react-sdk/session/NotAuthenticatedPage.js

@@ -1 +1 @@
-import{jsx as t}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as e}from"#package/domain";import{PhoenixLayoutElement as o}from"../elements/index.js";import{ConfigurationNotFoundPage as a}from"./ConfigurationNotFoundPage.js";let r="NotAuthenticatedPage";export const createNotAuthenticatedPage=t=>e(r,t);let n=()=>t(a,{});export const NotAuthenticatedPage=()=>t(o,{name:r,elementProps:{},defaultSlot:n});
+import{jsx as e}from"react/jsx-runtime";import{createCustomPhoenixLayoutElement as t}from"#package/domain";import{PhoenixLayoutElement as o}from"../elements/index.js";let a="NotAuthenticatedPage";export const createNotAuthenticatedPage=e=>t(a,e);export const NotAuthenticatedPage=()=>e(o,{name:a,elementProps:{}});

package/dist/react-sdk/session/SessionServiceProvider.js

@@ -1 +1 @@
-import{jsx as e}from"react/jsx-runtime";import{useCallback as t,useEffect as o,useMemo as i}from"react";import{distinctUntilChanged as n,filter as a,skip as r}from"rxjs";import{match as s}from"ts-pattern";import{standardWebComponentEvents as l,standardWebComponentProperties as d}from"#package/domain";import{Loader as c}from"#package/ui-sdk";import{DomainSessionProvider as u,INTEGRATION_MODE_SETTINGS as h,SessionProvider as m,useApplicationRuntime as g,useApplicationRuntimeSelector as p,useDispatchWebComponentEvent as f,useLogger as S,useRawSession as k,useSessionService as v,useWebComponentProperty$ as x,useWebComponentPropertyValue as w}from"../application-runtime/index.js";import{usePatientObservableValue as T}from"../domain-context/index.js";import{BuiltInLoadingPhase as j,useLoadingPhase as b,useLoadingStateManager as C}from"../loading-state/index.js";import{NotAuthenticatedPage as A}from"./NotAuthenticatedPage.js";let U="code";export const SessionServiceProvider=E=>{let{children:P,notAuthenticatedFallback:z=A}=E,F=g(),$=S(),q=v(),M=k(),N=p(F.selectors.session.getSession),R=p(F.selectors.sessionContext.getSessionContext),y=w(d.sessionToken),L=w(d.adminSessionToken),W=w(d.refreshToken),B=x(d.integrationMode),D=x(d.authorizationCode),G=t(()=>{if(D.value){let e=B.value;"local-storage"===h[e].authenticationStorage&&$.warn(`authorizationCode WC prop used in '${e}' mode. This is discouraged — tokens stored in localStorage leak across tabs. Use 'handoff' or 'headless' mode instead.`);let t=D.value;return D.next(void 0),t}if(h[B.value].consumeCodeFromUrl){let e=new URL(window.location.href),t=e.searchParams.get(U);return e.searchParams.delete(U),history.replaceState(null,"",e),t??void 0}},[D,B,$]),H=T(i(()=>D.pipe(r(1),a(e=>void 0!==e),n()),[D]),void 0),I=h[w(d.integrationMode)].authenticationStorage,J=f(l.authenticationFailed),K=i(()=>s(I).with("local-storage",()=>localStorage).with("session-storage",()=>sessionStorage).exhaustive(),[I]);o(()=>{q.configure({initialSessionToken:y,initialAdminSessionToken:L,initialRefreshToken:W,retrieveAuthorizationCode:G,dispatchAuthenticationFailed:J,storage:K})},[q,y,L,W,G,J,K]),o(()=>{"loading"===M.authenticated&&q.requestSessionToken().catch(e=>{let t=e instanceof Error?e:Error(`Unknown error ${e}`);$.warn("Session could not be authenticated",{},t)})},[q,M.authenticated,$]),o(()=>{H&&($.debug("New authorization code received, re-authenticating session"),q.requestSessionToken().catch(e=>{let t=e instanceof Error?e:Error(`Unknown error ${e}`);$.warn("Session could not be authenticated",{},t)}))},[H,q,$]);let O=null!==C();return(b({id:j.SessionAuth,label:"Authenticating session…"},"loading"===M.authenticated),"loading"===M.authenticated)?O?null:e(c,{}):"error"===M.authenticated?e(m,{value:M,children:e(z,{})}):null===R?null:e(m,{value:N,children:e(u,{value:R,children:P})})};
+import{jsx as e}from"react/jsx-runtime";import{useCallback as t,useEffect as o,useMemo as i}from"react";import{distinctUntilChanged as n,filter as a,skip as r}from"rxjs";import{match as s}from"ts-pattern";import{standardWebComponentEvents as l,standardWebComponentProperties as d}from"#package/domain";import{Loader as c}from"#package/ui-sdk";import{DomainSessionProvider as u,INTEGRATION_MODE_SETTINGS as h,SessionProvider as m,useApplicationRuntime as g,useApplicationRuntimeSelector as p,useDispatchWebComponentEvent as f,useIsLoaderHosted as S,useLogger as k,useRawSession as v,useSessionService as x,useWebComponentProperty$ as w,useWebComponentPropertyValue as T}from"../application-runtime/index.js";import{usePatientObservableValue as j}from"../domain-context/index.js";import{BuiltInLoadingPhase as b,useLoadingPhase as C}from"../loading-state/index.js";import{NotAuthenticatedPage as A}from"./NotAuthenticatedPage.js";let U="code";export const SessionServiceProvider=E=>{let{children:P,notAuthenticatedFallback:z=A}=E,F=g(),$=k(),q=x(),M=v(),N=p(F.selectors.session.getSession),R=p(F.selectors.sessionContext.getSessionContext),y=T(d.sessionToken),L=T(d.adminSessionToken),W=T(d.refreshToken),B=w(d.integrationMode),D=w(d.authorizationCode),G=t(()=>{if(D.value){let e=B.value;"local-storage"===h[e].authenticationStorage&&$.warn(`authorizationCode WC prop used in '${e}' mode. This is discouraged — tokens stored in localStorage leak across tabs. Use 'handoff' or 'headless' mode instead.`);let t=D.value;return D.next(void 0),t}if(h[B.value].consumeCodeFromUrl){let e=new URL(window.location.href),t=e.searchParams.get(U);return e.searchParams.delete(U),history.replaceState(null,"",e),t??void 0}},[D,B,$]),H=j(i(()=>D.pipe(r(1),a(e=>void 0!==e),n()),[D]),void 0),I=h[T(d.integrationMode)].authenticationStorage,J=f(l.authenticationFailed),K=i(()=>s(I).with("local-storage",()=>localStorage).with("session-storage",()=>sessionStorage).exhaustive(),[I]);o(()=>{q.configure({initialSessionToken:y,initialAdminSessionToken:L,initialRefreshToken:W,retrieveAuthorizationCode:G,dispatchAuthenticationFailed:J,storage:K})},[q,y,L,W,G,J,K]),o(()=>{"loading"===M.authenticated&&q.requestSessionToken().catch(e=>{let t=e instanceof Error?e:Error(`Unknown error ${e}`);$.warn("Session could not be authenticated",{},t)})},[q,M.authenticated,$]),o(()=>{H&&($.debug("New authorization code received, re-authenticating session"),q.requestSessionToken().catch(e=>{let t=e instanceof Error?e:Error(`Unknown error ${e}`);$.warn("Session could not be authenticated",{},t)}))},[H,q,$]);let O=S();return(C({id:b.SessionAuth,label:"Authenticating session…"},"loading"===M.authenticated),"loading"===M.authenticated)?O?null:e(c,{}):"error"===M.authenticated?e(m,{value:M,children:e(z,{})}):null===R?null:e(m,{value:N,children:e(u,{value:R,children:P})})};

package/dist/react-sdk/web-component/create-web-component.js

@@ -1 +1 @@
-import{jsx as e}from"react/jsx-runtime";import{createRoot as t}from"react-dom/client";import{Subject as r,Subscription as o,filter as s,scan as i}from"rxjs";import{v4 as n}from"uuid";import{standardWebComponentEvents as a,standardWebComponentProperties as l}from"#package/domain";import{WebComponentApp as c}from"./WebComponentApp.js";import{createEventDispatcher as u,createStorage as p,createWebComponentApi as h}from"./create-web-component-api.js";import{createAttributeNameToPropertyMap as b,createEventTypeByDescriptorMap as d,deriveWebComponentContract as m}from"./web-component-contract.js";let f=Symbol("storagesByPropertyDescriptor"),y=Symbol("reactRoot"),g=Symbol("pendingDisconnection"),v=Symbol("setProperty"),j=Symbol("activeSubscriptions"),S=Symbol("propertiesWithStorages"),P=Symbol("container"),w=Symbol("applicationRuntime"),C=Symbol("webComponentApi"),A=Symbol("PreviousPropertyValues"),E=Symbol("Events"),O=Symbol("Uuid"),$=(e,t,r)=>{let o=t?.attributeParser;if(!o)throw Error("Attribute parser is not defined");try{let e=o(r);return{success:!0,data:e}}catch(t){return console.error(`Failed to parse attribute ${e}, ignoring`,t),{success:!1}}};export const createWebComponent=x=>{let{RootComponent:k,webComponentOptions:D,embeddedIntegration:B,applicationRuntimeFactory:W}=x,F=m(D),{properties:M,events:V}=F,q=b(M),N=d(V),R=class Salsita3dConfigurator extends HTMLElement{[f];[y];[g]=null;[j]=[];[S];[P];[w];[C];[A]=new Map;[E]=new r;[O]=n();get applicationRuntime(){return this[w]}static observedAttributes=Array.from(q.keys());[v](e,t,r){let o=t.schema.safeParse(r);if(!o.success)return void console.error(`Invalid value provided for property ${e}, ignoring`,o.error);let s=this[f].get(t);if(!s)return void console.error(`Subject not found for property descriptor of ${e}`);let i=s.isSet;s.isSet=!0,i&&s.subject.value===o.data||s.subject.next(o.data)}constructor(){super(),this[P]=this.attachShadow({mode:"closed"}),this[S]=Object.entries(M).map(([e,t])=>{if(Object.prototype.hasOwnProperty.call(this,e)){let r=t.schema.safeParse(this[e]);if(delete this[e],r.success)return{name:e,propertyDescriptor:t,storage:p(t,r.data)};console.error(`Failed to validate property ${e}, ignoring`,r.error)}if(t.attributeParser&&t.attributeNames){let r=t.attributeNames.map(e=>this.getAttribute(e)).find(e=>null!==e)??null;if(null!==r){let o=$(e,t,r);if(o.success){let r=t.schema.safeParse(o.data);if(r.success)return{name:e,propertyDescriptor:t,storage:p(t,r.data)};console.error(`Failed to validate attribute ${e}, ignoring`,r.error)}}}return{name:e,propertyDescriptor:t,storage:p(t,t.defaultValue)}}),this[f]=new Map(this[S].map(({propertyDescriptor:e,storage:t})=>[e,t])),this[C]=h({element:this,eventTypeByDescriptor:N,events:this[E],propertiesWithStorages:this[S],storagesByPropertyDescriptor:this[f]}),this[w]=W({webComponentOptions:F,webComponentApi:this[C]})}connectedCallback(){let r;if(null!==this[g]){this[g]=null,this[w].actions.webComponent.startNewGeneration();return}let n=this[w],p=this[C],h=u({element:this,eventTypeByDescriptor:N,storagesByPropertyDescriptor:this[f]},!0),b=this[S].map(({name:e,storage:t})=>t.subject.pipe(i((e,t)=>[e[1],t],[t.subject.value,t.subject.value]),s(([e,t])=>e!==t)).subscribe(([t,r])=>{h(a.propertyChanged,{name:e,oldValue:t,newValue:r})})),d=e=>{if(e)for(let[t,r]of Object.entries(e)){let e=this[S].find(({name:e})=>e===t);if(e){let{storage:o,propertyDescriptor:s}=e;this[A].has(t)||this[A].set(t,o.subject.value);let i=s.schema.safeParse(r);i.success?(o.subject.next(i.data),o.isSet=!0):console.error(`Failed to apply web component property override for "${t}":`,i.error)}}else{for(let[e,t]of this[A]){let r=this[S].find(({name:t})=>t===e);if(r){let{storage:e}=r;e.subject.next(t)}}this[A].clear()}},m=new o(n.subscribe(()=>{let e=n.selectors.overrides.getWebComponentProperties();e!==r&&(r=e,d(e))}));this[j]=[...b,m],this[y]=t(this[P]),this[y].render(e(c,{runtime:n,container:this[P],children:e(k,{})}));let v=p.getPropertyValue(l.onAttached);if(v)try{v(this)}catch(e){console.error("Error in onAttached handler",e)}this.dispatchEvent(new CustomEvent("attached",{bubbles:!0}))}disconnectedCallback(){let e={};this[g]=e,queueMicrotask(()=>{this[g]===e&&(this[g]=null,this[j].forEach(e=>{e.unsubscribe()}),this[y]?.unmount(),this[y]=void 0)})}attributeChangedCallback(e,t,r){let o=q.get(e);if(!o)throw Error(`Property descriptor not found for attribute: ${e}, despite the attribute being observed`);if(null===r)return o.required?void console.error(`Cannot unset a required attribute ${e}, ignoring`):void this[v](e,o,o.defaultValue);let s=$(e,o,r);s.success&&this[v](e,o,s.data)}};return Object.entries(M).forEach(([e,t])=>{Object.defineProperty(R.prototype,e,{enumerable:!0,configurable:!1,get(){return this[f].get(t).subject.value},set(r){this[v](e,t,r)}})}),B&&(Object.defineProperty(R.prototype,"$events",{enumerable:!1,configurable:!1,get(){return this[E]}}),Object.defineProperty(R.prototype,"uuid",{enumerable:!1,configurable:!1,get(){return this[O]}})),R};
+import{jsx as e}from"react/jsx-runtime";import{createRoot as t}from"react-dom/client";import{Subject as r,Subscription as o,filter as s,scan as i}from"rxjs";import{v4 as n}from"uuid";import{standardWebComponentEvents as a,standardWebComponentProperties as l,webComponentAttributeParsers as c}from"#package/domain";import{WebComponentApp as u}from"./WebComponentApp.js";import{createEventDispatcher as p,createStorage as h,createWebComponentApi as b}from"./create-web-component-api.js";import{registerGodModeTarget as d}from"./god-mode/index.js";import{createAttributeNameToPropertyMap as m,createEventTypeByDescriptorMap as f,deriveWebComponentContract as y}from"./web-component-contract.js";let g=Symbol("storagesByPropertyDescriptor"),v=Symbol("reactRoot"),j=Symbol("pendingDisconnection"),S=Symbol("setProperty"),P=Symbol("activeSubscriptions"),w=Symbol("propertiesWithStorages"),C=Symbol("container"),A=Symbol("applicationRuntime"),x=Symbol("webComponentApi"),E=Symbol("PreviousPropertyValues"),O=Symbol("Events"),$=Symbol("Uuid"),k=(e,t,r)=>{let o=t?.attributeParser;if(!o)throw Error("Attribute parser is not defined");let s=o===c.boolean&&r===e?"":r;try{let e=o(s);return{success:!0,data:e}}catch(t){return console.error(`Failed to parse attribute ${e}, ignoring`,t),{success:!1}}};export const createWebComponent=c=>{let{RootComponent:D,webComponentOptions:B,embeddedIntegration:M,applicationRuntimeFactory:W}=c,F=y(B),{properties:V,events:q}=F,N=m(V),R=f(q),T=class Salsita3dConfigurator extends HTMLElement{[g];[v];[j]=null;[P]=[];[w];[C];[A];[x];[E]=new Map;[O]=new r;[$]=n();get applicationRuntime(){return this[A]}static observedAttributes=Array.from(N.keys());[S](e,t,r){let o=t.schema.safeParse(r);if(!o.success)return void console.error(`Invalid value provided for property ${e}, ignoring`,o.error);let s=this[g].get(t);if(!s)return void console.error(`Subject not found for property descriptor of ${e}`);let i=s.isSet;s.isSet=!0,i&&s.subject.value===o.data||s.subject.next(o.data)}constructor(){super(),this[C]=this.attachShadow({mode:"closed"}),this[w]=Object.entries(V).map(([e,t])=>{if(Object.prototype.hasOwnProperty.call(this,e)){let r=t.schema.safeParse(this[e]);if(delete this[e],r.success)return{name:e,propertyDescriptor:t,storage:h(t,r.data)};console.error(`Failed to validate property ${e}, ignoring`,r.error)}if(t.attributeParser&&t.attributeNames){let r=t.attributeNames.find(e=>this.hasAttribute(e)),o=void 0===r?null:this.getAttribute(r);if(void 0!==r&&null!==o){let s=k(r,t,o);if(s.success){let o=t.schema.safeParse(s.data);if(o.success)return{name:e,propertyDescriptor:t,storage:h(t,o.data)};console.error(`Failed to validate attribute ${r}, ignoring`,o.error)}}}return{name:e,propertyDescriptor:t,storage:h(t,t.defaultValue)}}),this[g]=new Map(this[w].map(({propertyDescriptor:e,storage:t})=>[e,t])),this[x]=b({element:this,eventTypeByDescriptor:R,events:this[O],propertiesWithStorages:this[w],storagesByPropertyDescriptor:this[g]}),this[A]=W({webComponentOptions:F,webComponentApi:this[x]})}connectedCallback(){let r;if(null!==this[j]){this[j]=null,this[A].actions.webComponent.startNewGeneration();return}let n=this[A],c=this[x],h=p({element:this,eventTypeByDescriptor:R,storagesByPropertyDescriptor:this[g]},!0),b=this[w].map(({name:e,storage:t})=>t.subject.pipe(i((e,t)=>[e[1],t],[t.subject.value,t.subject.value]),s(([e,t])=>e!==t)).subscribe(([t,r])=>{h(a.propertyChanged,{name:e,oldValue:t,newValue:r})})),m=e=>{if(e)for(let[t,r]of Object.entries(e)){let e=this[w].find(({name:e})=>e===t);if(e){let{storage:o,propertyDescriptor:s}=e;this[E].has(t)||this[E].set(t,o.subject.value);let i=s.schema.safeParse(r);i.success?(o.subject.next(i.data),o.isSet=!0):console.error(`Failed to apply web component property override for "${t}":`,i.error)}}else{for(let[e,t]of this[E]){let r=this[w].find(({name:t})=>t===e);if(r){let{storage:e}=r;e.subject.next(t)}}this[E].clear()}},f=new o(n.subscribe(()=>{let e=n.selectors.overrides.getWebComponentProperties();e!==r&&(r=e,m(e))})),y=new o(d(this,n.actions.environment.setGodMode));this[P]=[...b,f,y],this[v]=t(this[C]),this[v].render(e(u,{runtime:n,container:this[C],children:e(D,{})}));let S=c.getPropertyValue(l.onAttached);if(S)try{S(this)}catch(e){console.error("Error in onAttached handler",e)}this.dispatchEvent(new CustomEvent("attached",{bubbles:!0}))}disconnectedCallback(){let e={};this[j]=e,queueMicrotask(()=>{this[j]===e&&(this[j]=null,this[P].forEach(e=>{e.unsubscribe()}),this[v]?.unmount(),this[v]=void 0)})}attributeChangedCallback(e,t,r){let o=N.get(e);if(!o)throw Error(`Property descriptor not found for attribute: ${e}, despite the attribute being observed`);if(null===r)return o.required?void console.error(`Cannot unset a required attribute ${e}, ignoring`):void this[S](e,o,o.defaultValue);let s=k(e,o,r);s.success&&this[S](e,o,s.data)}};return Object.entries(V).forEach(([e,t])=>{Object.defineProperty(T.prototype,e,{enumerable:!0,configurable:!1,get(){return this[g].get(t).subject.value},set(r){this[S](e,t,r)}})}),M&&(Object.defineProperty(T.prototype,"$events",{enumerable:!1,configurable:!1,get(){return this[O]}}),Object.defineProperty(T.prototype,"uuid",{enumerable:!1,configurable:!1,get(){return this[$]}})),T};

package/dist/react-sdk/web-component/god-mode/god-mode-registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Turns god mode on or off from the browser console, for the applications mounted on the page.
+ *
+ * - `window.__salsita.setGodMode(true)` switches every mounted application and remembers the value
+ *   for the tab's session, so applications created later, and after a reload, start with it.
+ * - `window.__salsita.setGodMode(true, $0)` switches only the application whose custom element is
+ *   given, here the one selected in the browser's element inspector.
+ * - `window.__salsita.setGodMode(false, 'my-configurator')` switches only the application whose
+ *   custom element is the first match of the CSS selector.
+ *
+ * A targeted call is not remembered. A target that matches no mounted application changes
+ * nothing and logs an error.
+ */
+export type SetGodMode = (godMode: boolean, target?: Element | string) => void;
+declare global {
+    interface Window {
+        __salsita: {
+            setGodMode: SetGodMode;
+        };
+    }
+}
+/**
+ * Makes a mounted application reachable through `window.__salsita.setGodMode` (see
+ * {@link SetGodMode}) and installs the global. Returns the function that removes the application
+ * again.
+ *
+ * @param element The application's custom element, which a targeted call names.
+ * @param setRuntimeGodMode Publishes the value to the application's own runtime.
+ */
+export declare const registerGodModeTarget: (element: Element, setRuntimeGodMode: (godMode: boolean) => void) => (() => void);