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

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

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

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

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

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

@@ -8,6 +8,7 @@ export * from './invalid-deployment/index.js';
 export * from './web-component/index.js';
 export * from './localizable/index.js';
 export * from './loading-state/index.js';
+export * from './responsive-state/index.js';
 export * from './elements/index.js';
 export * from './handlers/index.js';
 export * from './application-runtime/index.js';

package/dist/react-sdk/index.js

@@ -1 +1 @@
-export*from"./theme/index.js";export*from"./utils/index.js";export*from"./session/index.js";export*from"./domain-context/index.js";export*from"./domain-application-context/index.js";export*from"./domain-controls/index.js";export*from"./invalid-deployment/index.js";export*from"./web-component/index.js";export*from"./localizable/index.js";export*from"./loading-state/index.js";export*from"./elements/index.js";export*from"./handlers/index.js";export*from"./application-runtime/index.js";
+export*from"./theme/index.js";export*from"./utils/index.js";export*from"./session/index.js";export*from"./domain-context/index.js";export*from"./domain-application-context/index.js";export*from"./domain-controls/index.js";export*from"./invalid-deployment/index.js";export*from"./web-component/index.js";export*from"./localizable/index.js";export*from"./loading-state/index.js";export*from"./responsive-state/index.js";export*from"./elements/index.js";export*from"./handlers/index.js";export*from"./application-runtime/index.js";

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

@@ -22,10 +22,15 @@ export declare class LoadingStateManager {
     private readonly _phases$;
     private readonly _hasError$;
     private readonly _expectedPhases$;
+    private readonly _expectationCounts;
     readonly startPhase: (phase: LoadingPhase) => void;
     readonly endPhase: (id: string) => void;
     readonly reportError: () => void;
     readonly clearError: () => void;
+    /**
+     * Marks a phase as expected before it starts. Expectations are counted: the phase stays expected
+     * until every `expectPhase` call for it has been matched by a `dropExpectation`.
+     */
     readonly expectPhase: (id: string) => void;
     readonly dropExpectation: (id: string) => void;
     readonly state$: Observable<LoadingState>;

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

@@ -1 +1 @@
-var e;import{BehaviorSubject as s,combineLatest as a,distinctUntilChanged as t,map as h}from"rxjs";export var BuiltInLoadingPhase=((e={}).SessionAuth="session-auth",e.PublishedData="published-data",e.FrontendData="frontend-data",e.BackendData="backend-data",e.DataFetch="data-fetch",e.SceneAssets="scene-assets",e);export class LoadingStateManager{_phases$=new s(new Map);_hasError$=new s(!1);_expectedPhases$=new s(new Set);startPhase=e=>{let s=new Map(this._phases$.value);s.set(e.id,e),this._phases$.next(s)};endPhase=e=>{let s=this._phases$.value;if(!s.has(e))return;let a=new Map(s);a.delete(e),this._phases$.next(a)};reportError=()=>{this._hasError$.next(!0)};clearError=()=>{this._hasError$.next(!1)};expectPhase=e=>{let s=new Set(this._expectedPhases$.value);s.add(e),this._expectedPhases$.next(s)};dropExpectation=e=>{let s=this._expectedPhases$.value;if(!s.has(e))return;let a=new Set(s);a.delete(e),this._expectedPhases$.next(a)};state$=a([this._phases$,this._hasError$,this._expectedPhases$]).pipe(h(([e,s,a])=>{let t;return{isLoading:(t=Array.from(e.values())).length>0,hasError:s,phases:t,expectedPhaseIds:a}}),t((e,s)=>e.isLoading===s.isLoading&&e.hasError===s.hasError&&e.expectedPhaseIds===s.expectedPhaseIds&&e.phases.length===s.phases.length&&e.phases.every((e,a)=>e.id===s.phases[a]?.id&&e.progress===s.phases[a]?.progress&&e.label===s.phases[a]?.label)))}
+var e;import{BehaviorSubject as s,combineLatest as t,distinctUntilChanged as a,map as h}from"rxjs";export var BuiltInLoadingPhase=((e={}).SessionAuth="session-auth",e.PublishedData="published-data",e.FrontendData="frontend-data",e.BackendData="backend-data",e.DataFetch="data-fetch",e.SceneAssets="scene-assets",e);export class LoadingStateManager{_phases$=new s(new Map);_hasError$=new s(!1);_expectedPhases$=new s(new Set);_expectationCounts=new Map;startPhase=e=>{let s=new Map(this._phases$.value);s.set(e.id,e),this._phases$.next(s)};endPhase=e=>{let s=this._phases$.value;if(!s.has(e))return;let t=new Map(s);t.delete(e),this._phases$.next(t)};reportError=()=>{this._hasError$.next(!0)};clearError=()=>{this._hasError$.next(!1)};expectPhase=e=>{let s=this._expectationCounts.get(e)??0;if(this._expectationCounts.set(e,s+1),s>0)return;let t=new Set(this._expectedPhases$.value);t.add(e),this._expectedPhases$.next(t)};dropExpectation=e=>{let s=this._expectationCounts.get(e);if(void 0===s)return;if(s>1)return void this._expectationCounts.set(e,s-1);this._expectationCounts.delete(e);let t=new Set(this._expectedPhases$.value);t.delete(e),this._expectedPhases$.next(t)};state$=t([this._phases$,this._hasError$,this._expectedPhases$]).pipe(h(([e,s,t])=>{let a;return{isLoading:(a=Array.from(e.values())).length>0,hasError:s,phases:a,expectedPhaseIds:t}}),a((e,s)=>e.isLoading===s.isLoading&&e.hasError===s.hasError&&e.expectedPhaseIds===s.expectedPhaseIds&&e.phases.length===s.phases.length&&e.phases.every((e,t)=>e.id===s.phases[t]?.id&&e.progress===s.phases[t]?.progress&&e.label===s.phases[t]?.label)))}

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/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';

package/dist/ui-sdk/responsive-application/responsive-state-store.d.ts

@@ -0,0 +1,57 @@
+import type { BehaviorSubject, Observable } from 'rxjs';
+import type { CanvasPadding } from './ResponsiveProvider.js';
+/**
+ * The responsive state a `ResponsiveStateStore` holds.
+ *
+ * @internal Runtime plumbing behind the `store` prop of `ResponsiveApplicationProvider`, for the
+ * SDK's own configurator.
+ */
+export interface ResponsiveStateSnapshot {
+    readonly isPhone: boolean;
+    readonly isMobile: boolean;
+    readonly isTablet: boolean;
+    readonly isDesktop: boolean;
+    readonly isLandscape: boolean;
+    readonly isPortrait: boolean;
+    readonly canvasPadding: CanvasPadding;
+    readonly isExpanded: boolean;
+    readonly isHidden: boolean;
+    readonly isAnimating: boolean;
+}
+/**
+ * Responsive state owned outside the UI, which `ResponsiveApplicationProvider` measures its root
+ * container into and provides to `useResponsive()`. A mounted Phoenix application passes the
+ * `ResponsiveStateManager` of `@salsita-ai/sdk/react`, so its lifecycle reads the same state
+ * without the UI.
+ *
+ * Declared here by shape rather than imported, because `ui-sdk` depends on no other SDK package.
+ *
+ * @internal Runtime plumbing for the SDK's own configurator; a project mounting
+ * `ResponsiveApplicationProvider` leaves `store` out.
+ */
+export interface ResponsiveStateStore {
+    readonly state$: Observable<ResponsiveStateSnapshot>;
+    readonly viewport$: BehaviorSubject<{
+        width: number;
+        height: number;
+    }>;
+    readonly getState: () => ResponsiveStateSnapshot;
+    readonly setViewport: (viewport: {
+        readonly width: number;
+        readonly height: number;
+        readonly isLandscape: boolean;
+        readonly isPortrait: boolean;
+    }) => void;
+    readonly setBreakpoints: (breakpoints: {
+        readonly sm: number;
+        readonly md: number;
+        readonly lg: number;
+    }) => void;
+    readonly getCanvasPadding: () => CanvasPadding;
+    readonly setCanvasPadding: (padding: CanvasPadding) => void;
+    readonly expand: () => void;
+    readonly collapse: () => void;
+    readonly hide: () => void;
+    readonly show: () => void;
+    readonly setAnimating: (value: boolean) => void;
+}

package/dist/ui-sdk/responsive-application/responsive-state-store.js

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

package/dist/ui-sdk/responsive-application/use-store-responsive-info.d.ts

@@ -0,0 +1,7 @@
+import type { useResponsiveInfo } from './ResponsiveProvider.js';
+import type { ResponsiveStateStore } from './responsive-state-store.js';
+/**
+ * `useResponsiveInfo` over a store owned outside the UI: measures the container into the store,
+ * pushes the theme's breakpoints into it, and reads every value back from it.
+ */
+export declare const useStoreResponsiveInfo: (elementRef: React.MutableRefObject<HTMLElement | null>, store: ResponsiveStateStore) => ReturnType<typeof useResponsiveInfo>;

package/dist/ui-sdk/responsive-application/use-store-responsive-info.js

@@ -0,0 +1 @@
+import{useTheme as e}from"@mui/material";import{useCallback as t,useLayoutEffect as i,useMemo as a,useSyncExternalStore as s}from"react";import{isMobileOnly as n}from"react-device-detect";import{useResizeObserver as o}from"usehooks-ts";export const useStoreResponsiveInfo=(r,c)=>{let{sm:d,md:p,lg:l}=e().breakpoints.values,u=s(t(e=>{let t=c.state$.subscribe(e);return()=>{t.unsubscribe()}},[c]),c.getState);i(()=>{c.setBreakpoints({sm:d,md:p,lg:l})},[c,d,p,l]);let m=t(e=>{let{width:t,height:i}=e.getBoundingClientRect();c.setViewport({width:t,height:i,isLandscape:window.matchMedia("(orientation: landscape)").matches,isPortrait:window.matchMedia("(orientation: portrait)").matches})},[c]),b=t(e=>{c.setCanvasPadding("function"==typeof e?e(c.getCanvasPadding()):e)},[c]),g=t(()=>{r.current&&m(r.current)},[r,m]);return o({ref:r,onResize:()=>{null!=r.current&&m(r.current)}}),i(()=>{null!=r.current&&m(r.current)},[r,m]),a(()=>({...u,expand:c.expand,collapse:c.collapse,hide:c.hide,show:c.show,isMobileAndMobileLandscape:u.isMobile||u.isLandscape&&u.isTablet&&n,isDesktopExceptMobileLandscape:u.isDesktop&&!(u.isLandscape&&u.isTablet&&n),viewport$:c.viewport$,getCanvasPadding:c.getCanvasPadding,setCanvasPadding:b,update:g,setAnimating:c.setAnimating}),[u,c,b,g])};

package/dist/ui-sdk/theme/types.d.ts

@@ -44,7 +44,7 @@ declare module '@mui/material/styles' {
         PhxChat: 'root';
         PhxChatFooter: 'root' | 'formLayout' | 'input';
         PhxChatMessage: 'base' | 'assistant' | 'user' | 'widget' | 'error' | 'helper';
-        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'status' | 'separator' | 'earlierButton' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
+        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'entityLink' | 'referenceLink' | 'referenceDetails' | 'image' | 'form' | 'formGroup' | 'formGroupLabel' | 'formOptions' | 'formOptionsLabel' | 'formOptionsRow' | 'formReply' | 'formText' | 'formTextInput' | 'formSubmit' | 'formNote' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'undoButton' | 'status' | 'separator' | 'earlierButton' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
         PhxTopNavigation: 'root' | 'stepper' | 'step';
         PhxListSelector: 'root';
         PhxListSelectorItem: 'root' | 'radio' | 'title' | 'description' | 'formControlLabel';

package/dist/webhook/builders/webhook-builder.js

@@ -1 +1 @@
-import{initConsoleLogger as t}from"@salsita-ai/common/utils";import{routeWebhookRequests as e}from"@salsita-ai/contracts/webhook";import{buildAssistantManifest as n,generateAssistantPrompt as o}from"#package/domain";import{AdminFinalizeHandlerBuilder as i}from"./admin-finalize-handler-builder.js";import{AuthHandlerBuilder as s}from"./auth-handler-builder.js";import{CallbackBuilder as a}from"./callback-builder.js";import{ConfiguratorFinalizeHandlerBuilder as r}from"./configurator-finalize-handler-builder.js";import{DynamicResourcesFactory as d}from"./dynamic-resources-factory.js";import{PrefetchBuilder as l}from"./prefetch-builder.js";import{TaskFactory as h}from"./task-factory.js";export class WebhookBuilder{_context;_handlers;constructor(t,e){this._context=t,this._handlers=e}withAuthHook(t){return new WebhookBuilder(this._context,{...this._handlers,onAuth:t})}withConfiguratorFinalize(t){return new WebhookBuilder(this._context,{...this._handlers,...t})}withFetchBackendData(t){return new WebhookBuilder(this._context,{...this._handlers,onFetchBackendData:t})}build(){if(!this._handlers&&!this._context.assistantServerSettings)throw Error("Can not build webhook without any handlers! It would be very dumb!");let s=t(),a=new i(this._context).build();return e({onAuth:this._handlers?.onAuth!==void 0?(t,e)=>this._handlers.onAuth(t,{logger:s},e):void 0,admin:{onFinalize:(t,e)=>a(t,{logger:s},e)},configurator:{onAssistantSetup:this._context.assistantServerSettings?async()=>{let t=this._context.configuratorBuilder.buildConfig().assistant;if(!t)throw Error("Assistant setup operation is not configured for this webhook!");let e=n(t),i=this._context.assistantServerSettings;return{setup:{sdl:e.sdl,prompt:o(e),...i},...this._context.assistantStrictThreads&&{threadLock:"strict"}}}:void 0,onFetchBackendData:this._handlers?.onFetchBackendData?(t,e)=>this._handlers.onFetchBackendData(t,{logger:s},e):void 0,onFinalize:this._handlers?.onFinalize?async(t,e)=>{let n=await this._handlers?.onFetchBackendData?.({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls},{logger:s},e);return this._handlers.onFinalize({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls,data:t.data,locale:t.locale,configurationId:t.configurationId,entities:t.entities,modelVersion:t.modelVersion,revisionId:t.revisionId,rootEntityType:t.rootEntityType,backendData:n?.backendData},{logger:s},e)}:void 0,onCallback:this._handlers?.onCallback?(t,e)=>this._handlers.onCallback(t,{logger:s},e):void 0}},s)}}export const createDomainWebhook=t=>{let e=new s(t),n=new WebhookBuilder(t),o=new h(t),i=new d(t),c=new r(t,[]);return{authHandlerBuilder:e,webhookBuilder:n,taskFactory:o,finalizeHandlerBuilder:c,callbackBuilder:new a(t),dynamicResourcesFactory:i,prefetchBuilder:new l(t)}};
+import{initConsoleLogger as t}from"@salsita-ai/common/utils";import{routeWebhookRequests as e}from"@salsita-ai/contracts/webhook";import{applyAssistantSetup as n,buildAssistantManifest as s,generateAssistantPrompt as i,isAssistantSetupHandler as o,projectAssistantSetupManifest as a,resolveHandlerModules as r}from"#package/domain";import{AdminFinalizeHandlerBuilder as d}from"./admin-finalize-handler-builder.js";import{AuthHandlerBuilder as l}from"./auth-handler-builder.js";import{CallbackBuilder as h}from"./callback-builder.js";import{ConfiguratorFinalizeHandlerBuilder as c}from"./configurator-finalize-handler-builder.js";import{DynamicResourcesFactory as u}from"./dynamic-resources-factory.js";import{PrefetchBuilder as m}from"./prefetch-builder.js";import{TaskFactory as f}from"./task-factory.js";export class WebhookBuilder{_context;_handlers;constructor(t,e){this._context=t,this._handlers=e}withAuthHook(t){return new WebhookBuilder(this._context,{...this._handlers,onAuth:t})}withConfiguratorFinalize(t){return new WebhookBuilder(this._context,{...this._handlers,...t})}withFetchBackendData(t){return new WebhookBuilder(this._context,{...this._handlers,onFetchBackendData:t})}build(){if(!this._handlers&&!this._context.assistantServerSettings)throw Error("Can not build webhook without any handlers! It would be very dumb!");let l=t(),h=new d(this._context).build();return e({onAuth:this._handlers?.onAuth!==void 0?(t,e)=>this._handlers.onAuth(t,{logger:l},e):void 0,admin:{onFinalize:(t,e)=>h(t,{logger:l},e)},configurator:{onAssistantSetup:this._context.assistantServerSettings?async t=>{let e=this._context.configuratorBuilder.buildConfig(),d=e.assistant;if(!d)throw Error("Assistant setup operation is not configured for this webhook!");let l=this._context.assistantServerSettings,h=r(e.handlers).find(o),c=h?n(d,l,h.handler().handler({manifest:a(d,l),inputs:{role:t.sessionRole,sessionData:t.sessionPayload,access:t.access}})):{resolved:d,settings:l};if(!c)return{setup:null,...this._context.assistantStrictThreads&&{threadLock:"strict"}};let u=s(c.resolved);return{setup:{sdl:u.sdl,prompt:i(u),...c.settings,instructions:c.settings?.instructions??void 0},...this._context.assistantStrictThreads&&{threadLock:"strict"}}}:void 0,onFetchBackendData:this._handlers?.onFetchBackendData?(t,e)=>this._handlers.onFetchBackendData(t,{logger:l},e):void 0,onFinalize:this._handlers?.onFinalize?async(t,e)=>{let n=await this._handlers?.onFetchBackendData?.({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls},{logger:l},e);return this._handlers.onFinalize({deploymentId:t.deploymentId,frontendUrl:t.frontendUrl,frontendData:t.frontendData,sessionRole:t.sessionRole,sessionPayload:t.sessionPayload,publishedAdminRevisionPath:t.publishedAdminRevisionPath,publishedChunkUrls:t.publishedChunkUrls,data:t.data,locale:t.locale,configurationId:t.configurationId,entities:t.entities,modelVersion:t.modelVersion,revisionId:t.revisionId,rootEntityType:t.rootEntityType,backendData:n?.backendData},{logger:l},e)}:void 0,onCallback:this._handlers?.onCallback?(t,e)=>this._handlers.onCallback(t,{logger:l},e):void 0}},l)}}export const createDomainWebhook=t=>{let e=new l(t),n=new WebhookBuilder(t),s=new f(t),i=new u(t),o=new c(t,[]);return{authHandlerBuilder:e,webhookBuilder:n,taskFactory:s,finalizeHandlerBuilder:o,callbackBuilder:new h(t),dynamicResourcesFactory:i,prefetchBuilder:new m(t)}};