@salsita-ai/sdk 0.50.0-develop.c28cfb7ded → 0.50.0-develop.c4848d224b

package/dist/react-sdk/responsive-state/ResponsiveStateProvider.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+import type { ResponsiveStateManager } from './responsive-state-manager.js';
+export declare const ResponsiveStateContext: import("react").Context<ResponsiveStateManager | null>;
+/**
+ * The props of `ResponsiveStateProvider`.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface ResponsiveStateProviderProps {
+    readonly children: ReactNode;
+    /** The responsive state of the application mounted inside. One per mounted application. */
+    readonly manager: ResponsiveStateManager;
+}
+/**
+ * Provides the responsive state of one mounted application to the lifecycle and UI inside it.
+ * Each mounted application has its own, because each has its own root container: an admin that
+ * embeds a configurator runs both in one application runtime.
+ *
+ * @internal Exists for the SDK's own UI, which reaches the runtime's responsive state through it.
+ * A project layout does not use it: it uses `useActiveViewports()` from `@salsita-ai/sdk/react`
+ * and `useSceneSafeArea()` from `@salsita-ai/sdk/configurator`.
+ */
+export declare const ResponsiveStateProvider: (props: ResponsiveStateProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/react-sdk/responsive-state/ResponsiveStateProvider.js

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

package/dist/react-sdk/responsive-state/canvas-padding.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The part of the canvas, in pixels from each edge, that overlay UI covers. The camera frames the
+ * scene inside what is left, so the scene stays visible beside a sidebar or under a preview body.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface CanvasPadding {
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly left: number;
+}

package/dist/react-sdk/responsive-state/canvas-padding.js

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

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

@@ -0,0 +1,5 @@
+export { type CanvasPadding } from './canvas-padding.js';
+export { type ResponsiveBreakpoints, type ResponsiveState, ResponsiveStateManager, type ResponsiveStateManagerOptions, type ResponsiveViewport, } from './responsive-state-manager.js';
+export { ResponsiveStateProvider, type ResponsiveStateProviderProps } from './ResponsiveStateProvider.js';
+export { useResponsiveState } from './use-responsive-state.js';
+export { useResponsiveStateManager } from './use-responsive-state-manager.js';

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

@@ -0,0 +1 @@
+export{ResponsiveStateManager}from"./responsive-state-manager.js";export{ResponsiveStateProvider}from"./ResponsiveStateProvider.js";export{useResponsiveState}from"./use-responsive-state.js";export{useResponsiveStateManager}from"./use-responsive-state-manager.js";

package/dist/react-sdk/responsive-state/responsive-state-manager.d.ts

@@ -0,0 +1,111 @@
+import { BehaviorSubject, type Observable } from 'rxjs';
+import type { CanvasPadding } from './canvas-padding.js';
+/**
+ * The widths, in pixels, that split the application's root container into phone, tablet and
+ * desktop. The theme decides them; the UI library pushes its theme's values in with
+ * `setBreakpoints`.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface ResponsiveBreakpoints {
+    readonly sm: number;
+    readonly md: number;
+    readonly lg: number;
+}
+/**
+ * One measurement of the application's root container. The orientation comes from the window,
+ * not from the container's aspect ratio.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface ResponsiveViewport {
+    readonly width: number;
+    readonly height: number;
+    readonly isLandscape: boolean;
+    readonly isPortrait: boolean;
+}
+/**
+ * The responsive state of one mounted application: the size classes of its root container, the
+ * canvas padding the scene is framed with, and whether the container is expanded over the host
+ * page, hidden, or in a layout animation.
+ *
+ * Every size class is `false` until the container is measured for the first time.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface ResponsiveState {
+    /** `width < sm` */
+    readonly isPhone: boolean;
+    /** `width <= md` */
+    readonly isMobile: boolean;
+    /** `sm < width < lg` */
+    readonly isTablet: boolean;
+    /** `width > md` */
+    readonly isDesktop: boolean;
+    readonly isLandscape: boolean;
+    readonly isPortrait: boolean;
+    readonly canvasPadding: CanvasPadding;
+    readonly isExpanded: boolean;
+    readonly isHidden: boolean;
+    readonly isAnimating: boolean;
+}
+/**
+ * How a `ResponsiveStateManager` starts.
+ *
+ * @internal Runtime plumbing behind `useResponsiveState`, for the SDK's own UI. A project layout
+ * uses `useActiveViewports()` from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from
+ * `@salsita-ai/sdk/configurator`.
+ */
+export interface ResponsiveStateManagerOptions {
+    /** A measurement to start from, for a test or a host that knows its size up front. */
+    readonly viewport?: ResponsiveViewport;
+    /** Defaults to the Phoenix theme's breakpoints: 480, 768 and 1024. */
+    readonly breakpoints?: ResponsiveBreakpoints;
+}
+/**
+ * Holds the responsive state of one mounted application, without any UI: the UI measures its root
+ * container into it and reads it back, and the lifecycle (preview, viewport sync, the loader) reads
+ * and sets it through `useResponsiveState` and `useResponsiveStateManager`. A test sets a fixed
+ * viewport with `setViewport` and renders no UI at all.
+ *
+ * `state$` emits only when a value in `ResponsiveState` changes; a resize within one size class
+ * reaches `viewport$` alone.
+ *
+ * @internal Exists for the SDK's own UI, which reaches the runtime's responsive state through it.
+ * A project layout does not use it: it uses `useActiveViewports()` from `@salsita-ai/sdk/react`
+ * and `useSceneSafeArea()` from `@salsita-ai/sdk/configurator`.
+ */
+export declare class ResponsiveStateManager {
+    private _viewport;
+    private _breakpoints;
+    private readonly _state$;
+    /** The measured size of the root container, rounded up to whole pixels. */
+    readonly viewport$: BehaviorSubject<{
+        width: number;
+        height: number;
+    }>;
+    readonly state$: Observable<ResponsiveState>;
+    constructor(options?: ResponsiveStateManagerOptions);
+    private readonly update;
+    readonly getState: () => ResponsiveState;
+    readonly setViewport: (viewport: ResponsiveViewport) => void;
+    readonly setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
+    readonly getCanvasPadding: () => CanvasPadding;
+    readonly setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+    /** Lays the root container over the host page. */
+    readonly expand: () => void;
+    readonly collapse: () => void;
+    readonly hide: () => void;
+    readonly show: () => void;
+    /**
+     * Whether a layout animation is in flight, so the root container clips the transient overflow
+     * of motion FLIP transforms instead of flashing scrollbars on the host page.
+     */
+    readonly setAnimating: (isAnimating: boolean) => void;
+}

package/dist/react-sdk/responsive-state/responsive-state-manager.js

@@ -0,0 +1 @@
+import{BehaviorSubject as t}from"rxjs";let i={sm:480,md:768,lg:1024},s={top:0,right:0,bottom:0,left:0},e={isPhone:!1,isMobile:!1,isTablet:!1,isDesktop:!1,isLandscape:!1,isPortrait:!1},a=(t,i)=>{if(!t)return e;let{width:s}=t;return{isPhone:s<i.sm,isMobile:s<=i.md,isTablet:s<i.lg&&s>i.sm,isDesktop:s>i.md,isLandscape:t.isLandscape,isPortrait:t.isPortrait}};export class ResponsiveStateManager{_viewport;_breakpoints;_state$;viewport$;state$;constructor(e={}){this._viewport=e.viewport??null,this._breakpoints=e.breakpoints??i,this.viewport$=new t({width:Math.ceil(this._viewport?.width??0),height:Math.ceil(this._viewport?.height??0)}),this._state$=new t({...a(this._viewport,this._breakpoints),canvasPadding:s,isExpanded:!1,isHidden:!1,isAnimating:!1}),this.state$=this._state$.asObservable()}update=t=>{let i=this._state$.value,s={...i,...a(this._viewport,this._breakpoints),...t};(i.isPhone!==s.isPhone||i.isMobile!==s.isMobile||i.isTablet!==s.isTablet||i.isDesktop!==s.isDesktop||i.isLandscape!==s.isLandscape||i.isPortrait!==s.isPortrait||i.isExpanded!==s.isExpanded||i.isHidden!==s.isHidden||i.isAnimating!==s.isAnimating||i.canvasPadding.top!==s.canvasPadding.top||i.canvasPadding.right!==s.canvasPadding.right||i.canvasPadding.bottom!==s.canvasPadding.bottom||i.canvasPadding.left!==s.canvasPadding.left)&&this._state$.next(s)};getState=()=>this._state$.value;setViewport=t=>{this._viewport=t,this.update({}),this.viewport$.next({width:Math.ceil(t.width),height:Math.ceil(t.height)})};setBreakpoints=t=>{this._breakpoints=t,this.update({})};getCanvasPadding=()=>this._state$.value.canvasPadding;setCanvasPadding=t=>{this.update({canvasPadding:t})};expand=()=>{this.update({isExpanded:!0})};collapse=()=>{this.update({isExpanded:!1})};hide=()=>{this.update({isHidden:!0})};show=()=>{this.update({isHidden:!1})};setAnimating=t=>{this.update({isAnimating:t})}}

package/dist/react-sdk/responsive-state/use-responsive-state-manager.d.ts

@@ -0,0 +1,10 @@
+import type { ResponsiveStateManager } from './responsive-state-manager.js';
+/**
+ * The responsive state manager of the application this component is mounted in, to set canvas
+ * padding, expand or hide the root container, or read the state without subscribing to it.
+ *
+ * @internal Exists for the SDK's own UI, which reaches the runtime's responsive state through it.
+ * A project layout does not use it: it uses `useActiveViewports()` from `@salsita-ai/sdk/react`
+ * and `useSceneSafeArea()` from `@salsita-ai/sdk/configurator`.
+ */
+export declare const useResponsiveStateManager: () => ResponsiveStateManager;

package/dist/react-sdk/responsive-state/use-responsive-state-manager.js

@@ -0,0 +1 @@
+import{useContext as e}from"react";import{ResponsiveStateContext as t}from"./ResponsiveStateProvider.js";export const useResponsiveStateManager=()=>{let o=e(t);if(!o)throw Error("useResponsiveStateManager() found no responsive state: it is used outside a ResponsiveStateProvider. Use it inside a mounted Phoenix application, or wrap a test in <ResponsiveStateProvider manager={new ResponsiveStateManager()}>.");return o};

package/dist/react-sdk/responsive-state/use-responsive-state.d.ts

@@ -0,0 +1,11 @@
+import type { ResponsiveState } from './responsive-state-manager.js';
+/**
+ * The responsive state of the application this component is mounted in: the size classes of its
+ * root container, the canvas padding, and whether the container is expanded, hidden or animating.
+ * Re-renders when any of them changes.
+ *
+ * @internal Exists for the SDK's own UI, which reaches the runtime's responsive state through it.
+ * A project layout does not use it: it uses `useActiveViewports()` from `@salsita-ai/sdk/react`
+ * and `useSceneSafeArea()` from `@salsita-ai/sdk/configurator`.
+ */
+export declare const useResponsiveState: () => ResponsiveState;

package/dist/react-sdk/responsive-state/use-responsive-state.js

@@ -0,0 +1 @@
+import{useCallback as e,useSyncExternalStore as t}from"react";import{useResponsiveStateManager as r}from"./use-responsive-state-manager.js";export const useResponsiveState=()=>{let s=r();return t(e(e=>{let t=s.state$.subscribe(e);return()=>{t.unsubscribe()}},[s]),s.getState)};

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/ui-sdk/responsive-application/ResponsiveApplicationProvider.d.ts

@@ -1,6 +1,15 @@
 import type { PropsWithChildren } from 'react';
+import type { ResponsiveStateStore } from './responsive-state-store.js';
 export interface ResponsiveApplicationProviderProps extends PropsWithChildren {
     containerZIndex: number;
+    /**
+     * Responsive state owned outside the UI. When given, the provider measures its container into
+     * it and `useResponsive()` reads from it; otherwise the provider keeps the state itself.
+     *
+     * @internal Runtime plumbing for the SDK's own configurator, which passes its runtime
+     * `ResponsiveStateManager`. A project mounting this provider leaves it out.
+     */
+    store?: ResponsiveStateStore;
 }
 /**
  * Root provider managing responsive app state and viewport.

package/dist/ui-sdk/responsive-application/ResponsiveApplicationProvider.js

@@ -1 +1 @@
-import{jsx as e,jsxs as o,Fragment as t}from"react/jsx-runtime";import{GlobalStyles as i,styled as r}from"@mui/material";import{useObservableEagerState as n}from"observable-hooks";import{useEffect as a,useRef as s}from"react";import{useResizeObserver as l}from"usehooks-ts";import{attrf as d,commonStyles as p}from"../common/index.js";import{ResponsiveContext as m,useResponsiveInfo as c}from"./ResponsiveProvider.js";let v="animating",f="expanded",y="hidden",u=e(i,{styles:({palette:e,typography:o})=>({":host":{all:"initial",interpolateSize:"allow-keywords",blockSize:"100%",boxSizing:"border-box",display:"block",overscrollBehavior:"contain",":where(*, *::after, *::before)":{boxSizing:"border-box"},backgroundColor:e.background.default,color:e.text.primary,fontFamily:o.fontFamily,...o.body1,MozOsxFontSmoothing:"grayscale",WebkitFontSmoothing:"antialiased",WebkitTextSizeAdjust:"100%"}})}),x=r("div")(()=>({...p.transition.fadeIn,blockSize:"100%",containerName:"app",containerType:"inline-size",contentVisibility:"auto",display:"grid",overflow:"auto",position:"relative",[`&[data-responsive-app*="${v}"]`]:{overflow:"clip"},[`&[data-responsive-app*="${f}"]`]:{inset:0,position:"fixed",zIndex:"var(--phx-app-index)"},[`&[data-responsive-app*="${y}"]`]:{contentVisibility:"hidden"}})),b=r("div")(()=>({position:"relative"}));export const ResponsiveApplicationProvider=i=>{let{children:r,containerZIndex:p}=i,h=s(null),w=c(h);l({ref:h,onResize:()=>{w.update()}});let{isAnimating:g,isExpanded:k,isHidden:z}=w,{height:S}=n(w.viewport$);return a(()=>{if(!k)return;let e=document.documentElement.style.overflow,o=document.body.style.overflow;return document.documentElement.style.setProperty("overflow","hidden"),document.body.style.setProperty("overflow","hidden"),()=>{document.documentElement.style.setProperty("overflow",e),document.body.style.setProperty("overflow",o)}},[k]),o(t,{children:[u,e(m.Provider,{value:w,children:e(x,{ref:h,"data-responsive-app":d({state:{[`${v}`]:g,[`${f}`]:k,[`${y}`]:z}}),inert:z?"":void 0,sx:{"--phx-app-index":p},children:e(b,{sx:{"--phx-app-height":S+"px"},children:r})})})]})};
+import{jsx as e,jsxs as o,Fragment as t}from"react/jsx-runtime";import{GlobalStyles as i,styled as r}from"@mui/material";import{useObservableEagerState as n}from"observable-hooks";import{useEffect as a,useRef as s}from"react";import{useResizeObserver as l}from"usehooks-ts";import{attrf as d,commonStyles as p}from"../common/index.js";import{ResponsiveContext as m,useResponsiveInfo as c}from"./ResponsiveProvider.js";import{useStoreResponsiveInfo as f}from"./use-store-responsive-info.js";let u="animating",v="expanded",x="hidden",y=e(i,{styles:({palette:e,typography:o})=>({":host":{all:"initial",interpolateSize:"allow-keywords",blockSize:"100%",boxSizing:"border-box",display:"block",overscrollBehavior:"contain",":where(*, *::after, *::before)":{boxSizing:"border-box"},backgroundColor:e.background.default,color:e.text.primary,fontFamily:o.fontFamily,...o.body1,MozOsxFontSmoothing:"grayscale",WebkitFontSmoothing:"antialiased",WebkitTextSizeAdjust:"100%"}})}),b=r("div")(()=>({...p.transition.fadeIn,blockSize:"100%",containerName:"app",containerType:"inline-size",contentVisibility:"auto",display:"grid",overflow:"auto",position:"relative",[`&[data-responsive-app*="${u}"]`]:{overflow:"clip"},[`&[data-responsive-app*="${v}"]`]:{inset:0,position:"fixed",zIndex:"var(--phx-app-index)"},[`&[data-responsive-app*="${x}"]`]:{contentVisibility:"hidden"}})),h=r("div")(()=>({position:"relative"})),w=i=>{let{children:r,containerRef:s,containerZIndex:p,info:c}=i;l({ref:s,onResize:()=>{c.update()}});let{isAnimating:f,isExpanded:w,isHidden:g}=c,{height:k}=n(c.viewport$);return a(()=>{if(!w)return;let e=document.documentElement.style.overflow,o=document.body.style.overflow;return document.documentElement.style.setProperty("overflow","hidden"),document.body.style.setProperty("overflow","hidden"),()=>{document.documentElement.style.setProperty("overflow",e),document.body.style.setProperty("overflow",o)}},[w]),o(t,{children:[y,e(m.Provider,{value:c,children:e(b,{ref:s,"data-responsive-app":d({state:{[`${u}`]:f,[`${v}`]:w,[`${x}`]:g}}),inert:g?"":void 0,sx:{"--phx-app-index":p},children:e(h,{sx:{"--phx-app-height":k+"px"},children:r})})})]})},g=o=>{let t=s(null),i=c(t);return e(w,{...o,containerRef:t,info:i})},k=o=>{let{store:t,...i}=o,r=s(null),n=f(r,t);return e(w,{...i,containerRef:r,info:n})};export const ResponsiveApplicationProvider=o=>{let{children:t,containerZIndex:i,store:r}=o;return r?e(k,{containerZIndex:i,store:r,children:t}):e(g,{containerZIndex:i,children:t})};

package/dist/ui-sdk/responsive-application/index.d.ts

@@ -1,2 +1,3 @@
 export { ResponsiveApplicationProvider, type ResponsiveApplicationProviderProps, } from './ResponsiveApplicationProvider.js';
 export { type CanvasPadding, Responsive, useResponsiveInfo, useResponsive, ResponsiveContext, type ResponsiveInfo, } from './ResponsiveProvider.js';
+export { type ResponsiveStateSnapshot, type ResponsiveStateStore } from './responsive-state-store.js';