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

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

@@ -2,13 +2,16 @@ export { useDomain, type UseDomainContext } from './common-hooks/use-domain-cont
 export { useStoreSelector, useRenderedSelector, useRenderedSelector$, useStoreSelector$, type UseSynchronizedSelector, type UseSynchronizedSelector$, } from './common-hooks/use-store-selector.js';
 export { useEagerObservableSelector, usePatientObservableSelector, usePatientObservableValue, useEagerObservableValue, } from './common-hooks/use-observable-selector.js';
 export { useStateValidity, type UseStateValidity, useMapViolationHints, type UseMapViolationHints, useControlViolations, type UseControlViolations, useFinalizeViolations, type UseFinalizeViolations, } from './common-hooks/use-state-validity.js';
+export { useConfiguratorMessages, type UseConfiguratorMessages, type ConfiguratorMessage, } from './common-hooks/use-configurator-messages.js';
 export { useComponent, useRenderedComponent, type UseComponent, useComponents, useDynamicComponents, useRenderedComponents, type UseComponents, useRootComponents, useRootRenderedComponents, type UseRootComponents, useFirstComponent, useFirstRenderedComponent, type UseFirstComponent, useFirstRootComponent, useFirstRootRenderedComponent, type UseFirstRootComponent, } from './component-hooks/use-component.js';
 export { useCommittedState, useCommittedSlice, useRenderedSlice, useRenderedState, type UseSlice, type UseState, } from './common-hooks/use-slices.js';
 export { useDomainEntityState, useDomainEntityRenderedState, type UseDomainEntityState, } from './entity-hooks/use-domain-entity-state.js';
 export { useEntityPrice, useRootEntityPrice, type UseEntityPrice, type UseRootEntityPrice, } from './entity-hooks/use-entity-price.js';
 export { useSelectEntity, type UseSelectEntity, useSelectedEntity, type UseSelectedEntity, useSelectedEntityId, type UseSelectedEntityId, useSelectedDomainEntityId, type UseSelectedDomainEntityId, useDeselect, type UseDeselect, useSelectParent, type UseSelectParent, } from './system-hooks/selection-hooks.js';
-export { useActiveNavigationState, type UseActiveNavigationState, useActiveViewState, type UseActiveViewState, useActiveToolState, type UseActiveToolState, useIsFullscreenActive, type UseIsFullscreenActive, useActiveViewports, type UseActiveViewports, useDraggedDomainEntityId, type UseDraggedDomainEntityId, useNavigate, type UseNavigate, usePushNavigate, type UsePushNavigate, usePopNavigate, type UsePopNavigate, } from './system-hooks/navigation-hooks.js';
+export { useActiveNavigationState, type UseActiveNavigationState, useActiveViewState, type UseActiveViewState, useSetViewState, type UseSetViewState, useActiveToolState, type UseActiveToolState, useIsFullscreenActive, type UseIsFullscreenActive, useSetFullscreen, type UseSetFullscreen, useActiveViewports, type UseActiveViewports, useDraggedDomainEntityId, type UseDraggedDomainEntityId, useNavigate, type UseNavigate, usePushNavigate, type UsePushNavigate, usePopNavigate, type UsePopNavigate, } from './system-hooks/navigation-hooks.js';
 export { useComposition, type UseComposition } from './system-hooks/composition-hooks.js';
+export { useUndoRedo, type UseUndoRedo, type UseUndoRedoResult } from './system-hooks/undo-redo-hooks.js';
+export { useTabNavigation, type TabEntry, type TabSource, type UseTabNavigation, type UseTabNavigationOptions, type UseTabNavigationResult, } from './system-hooks/tab-navigation-hooks.js';
 export { useHoveredDomainEntityId, useHoveredEntity, useHoveredEntityId, type UseHoveredDomainEntityId, type UseHoveredEntity, type UseHoveredEntityId, } from './system-hooks/hover-hooks.js';
 export { type UseRootEntityState, useRootEntityState, useRootEntityRenderedState, } from './entity-hooks/use-root-entity-state.js';
 export { type UseRootEntityId, useRootEntityId, useRootEntityRenderedId } from './entity-hooks/use-root-entity-id.js';

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

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

package/dist/react-sdk/domain-context/system-hooks/navigation-hooks.d.ts

@@ -9,6 +9,11 @@ export type UseActiveViewState<VIEW_STATE extends string> = () => VIEW_STATE;
  * Get the currently active view state
  */
 export declare const useActiveViewState: () => string;
+export type UseSetViewState<VIEW_STATE extends string> = () => (state: VIEW_STATE) => void;
+/**
+ * Hook to make the given view state the active one. Setting the state that is already active keeps it
+ */
+export declare const useSetViewState: () => (state: string) => void;
 export type UseActiveToolState<TOOL_STATE extends string> = () => TOOL_STATE;
 /**
  * Get the currently active tool state
@@ -19,6 +24,12 @@ export type UseIsFullscreenActive = () => boolean;
  * Get the currently active fullscreen state
  */
 export declare const useIsFullscreenActive: () => boolean;
+export type UseSetFullscreen = () => (enabled: boolean) => void;
+/**
+ * Hook to turn the fullscreen state on or off. The state is a flag the layout reads with `useIsFullscreenActive`;
+ * it does not put the browser into fullscreen
+ */
+export declare const useSetFullscreen: () => (enabled: boolean) => void;
 export type UseDraggedDomainEntityId = () => DomainEntityId<string> | null;
 /**
  * Get the id of the entity currently being dragged in the scene, or `null` while nothing is dragged

package/dist/react-sdk/domain-context/system-hooks/navigation-hooks.js

@@ -1 +1 @@
-import{useCallback as t}from"react";import{useDomain as e}from"../common-hooks/use-domain-context.js";import{useStoreSelector as o}from"../common-hooks/use-store-selector.js";export const useActiveNavigationState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveNavigationState(e.state),[t])};export const useActiveViewState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewState(e.state),[t])};export const useActiveToolState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveToolState(e.state),[t])};export const useIsFullscreenActive=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveFullscreenState(e.state),[t])};export const useDraggedDomainEntityId=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveDragState(e.state),[t])};export const useActiveViewports=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewportState(e.state),[t])};export const useNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(t=>{o.stageAndCommit([a.getNavigationUpdate(t)])},[o,a])};export const usePushNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(t=>{o.stageAndCommit([a.getPushNavigationUpdate(t,o.stateSlices.committed.value.state)])},[o,a])};export const usePopNavigate=()=>{let{storeSystem:o,navigationSystem:a}=e();return t(()=>{let t=a.getPopNavigationUpdate(o.stateSlices.committed.value.state);t&&o.stageAndCommit([t])},[o,a])};
+import{useCallback as t}from"react";import{useDomain as e}from"../common-hooks/use-domain-context.js";import{useStoreSelector as o}from"../common-hooks/use-store-selector.js";export const useActiveNavigationState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveNavigationState(e.state),[t])};export const useActiveViewState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewState(e.state),[t])};export const useSetViewState=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getViewUpdate(t)])},[o,s])};export const useActiveToolState=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveToolState(e.state),[t])};export const useIsFullscreenActive=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveFullscreenState(e.state),[t])};export const useSetFullscreen=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getFullscreenUpdate(t)])},[o,s])};export const useDraggedDomainEntityId=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveDragState(e.state),[t])};export const useActiveViewports=()=>{let{navigationSystem:t}=e();return o(e=>t.getActiveViewportState(e.state),[t])};export const useNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getNavigationUpdate(t)])},[o,s])};export const usePushNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(t=>{o.stageAndCommit([s.getPushNavigationUpdate(t,o.stateSlices.committed.value.state)])},[o,s])};export const usePopNavigate=()=>{let{storeSystem:o,navigationSystem:s}=e();return t(()=>{let t=s.getPopNavigationUpdate(o.stateSlices.committed.value.state);t&&o.stageAndCommit([t])},[o,s])};

package/dist/react-sdk/domain-context/system-hooks/tab-navigation-hooks.d.ts

@@ -0,0 +1,61 @@
+import { type ReactNode } from 'react';
+import { type DomainEntityId } from '#package/domain';
+/**
+ * The spec component a layout's tabs come from: the `sidebarTabs` of an entity, or the configurator's
+ * `horizontalTabs`.
+ */
+export type TabSource = 'sidebarTabs' | 'horizontalTabs';
+/**
+ * One tab of the spec, ready to render.
+ */
+export interface TabEntry<NAVIGATION_STATE extends string = string> {
+    /** Position of the tab in `tabs`; what `select` takes */
+    readonly index: number;
+    /** The tab's label, resolved for the active locale */
+    readonly label: string;
+    /** A PhxIcon name, when the spec gives the icon as a string */
+    readonly icon: string | undefined;
+    /** A React node, when TypeScript spec code gives the icon as one (`sidebarTabs` only) */
+    readonly iconNode: ReactNode | undefined;
+    /** The tab's navigation states; the tab is active while one of them is */
+    readonly navigationStates: readonly NAVIGATION_STATE[];
+    /** `navigationStates[0]`, the state `select` enters */
+    readonly state: NAVIGATION_STATE;
+    readonly isActive: boolean;
+}
+/**
+ * Which tabs `useTabNavigation` reads.
+ * - `source`: `'auto'` (default) reads the entity's `sidebarTabs` and, without any, the `horizontalTabs`.
+ * - `entityId`: whose `sidebarTabs` are read; the selected entity by default (the root while nothing is selected).
+ */
+export interface UseTabNavigationOptions {
+    readonly source?: 'auto' | TabSource;
+    readonly entityId?: DomainEntityId<string>;
+}
+/**
+ * The tabs of the spec and the means to switch between them.
+ * - `source`: the component the tabs come from, or `null` when no active instance of it exists.
+ * - `tabs`: the tabs in spec order. `activeTab`: the first tab whose navigation states include the active one.
+ * - `select`: enters a tab, given by its index or by any of its navigation states; an unknown tab does nothing.
+ */
+export interface UseTabNavigationResult<NAVIGATION_STATE extends string = string> {
+    readonly source: TabSource | null;
+    readonly tabs: readonly TabEntry<NAVIGATION_STATE>[];
+    readonly activeTab: TabEntry<NAVIGATION_STATE> | null;
+    readonly select: (tab: number | NAVIGATION_STATE) => void;
+}
+export type UseTabNavigation<NAVIGATION_STATE extends string> = (options?: UseTabNavigationOptions) => UseTabNavigationResult<NAVIGATION_STATE>;
+/**
+ * Hook to read the tabs the spec declares, `sidebarTabs` or `horizontalTabs`, and to switch between them, as the
+ * built-in tabs do.
+ * - `sidebarTabs`: every active instance on the entity, flattened in spec order. `horizontalTabs`: the first active
+ *   instance, on any entity.
+ * - With `source: 'auto'` and both kinds active, `sidebarTabs` win; several active `horizontalTabs` use the first.
+ *   Both log a warning in development and never throw.
+ * - A tab without navigation states cannot be entered and is left out, with a warning in development.
+ * - `select` enters the tab's first navigation state. For `horizontalTabs` it pushes the analytics event the
+ *   built-in horizontal tabs push; for `sidebarTabs` none, as the built-in sidebar tabs.
+ *
+ * It does not check read mode: switching tabs is navigation, not editing.
+ */
+export declare const useTabNavigation: (options?: UseTabNavigationOptions) => UseTabNavigationResult;

package/dist/react-sdk/domain-context/system-hooks/tab-navigation-hooks.js

@@ -0,0 +1 @@
+import{useCallback as t,useEffect as o,useMemo as a}from"react";import{horizontalTabsComponent as e,sidebarTabsComponent as i}from"#package/domain";import{FrontendAnalyticsFactory as n,useAnalyticsService as s,useIsDev as r}from"../../application-runtime/index.js";import{useResolveLocalizable as l}from"../../localizable/index.js";import{useDomain as m}from"../common-hooks/use-domain-context.js";import{useComponents as c}from"../component-hooks/use-component.js";import{useActiveNavigationState as p}from"./navigation-hooks.js";import{useSelectedDomainEntityId as b}from"./selection-hooks.js";let h=(t,a)=>{let e=r();o(()=>{e&&t&&console.warn(a)},[e,t,a])};export const useTabNavigation=(o={})=>{let{source:r="auto",entityId:v}=o,g=p(),d=b(),f=l(),u=s(),{navigationSystem:T,storeSystem:z}=m(),S=c({componentTypes:[i],entityIds:[v??d]}),j=c({componentTypes:[e]}),N="horizontalTabs"!==r&&S.length>0,k="sidebarTabs"!==r&&j.length>0,y=N?"sidebarTabs":k?"horizontalTabs":null;h(N&&k,"Both sidebarTabs and horizontalTabs are active, so useTabNavigation shows the sidebarTabs. Remove one of them from the spec, or pass `source` to choose."),h("horizontalTabs"===y&&j.length>1,"Several horizontalTabs are active, so useTabNavigation shows the first one. Keep one active, for example with $filter.");let x=a(()=>"sidebarTabs"===y?S.flatMap(t=>t.state.tabs):"horizontalTabs"===y?j[0]?.state.tabs??[]:[],[y,S,j]),w=x.filter(t=>0===t.navigationStates.length);h(w.length>0,`The ${y} tabs ${w.map(t=>`"${f(t.label)}"`).join(", ")} have no navigation states, so useTabNavigation leaves them out. Give each tab at least one navigation state.`);let $=a(()=>x.flatMap(t=>{let o=t.navigationStates[0];return void 0===o?[]:[{tab:t,state:o}]}).map(({tab:t,state:o},a)=>({index:a,label:f(t.label),icon:"string"==typeof t.icon?t.icon:void 0,iconNode:"string"==typeof t.icon||null===t.icon?void 0:t.icon,navigationStates:t.navigationStates,state:o,isActive:t.navigationStates.includes(g)})),[x,g,f]),A=$.find(t=>t.isActive)??null,C=t(t=>{let o="number"==typeof t?$[t]:$.find(o=>o.navigationStates.includes(t));o&&("horizontalTabs"===y&&u.push(n.TopNavigationStepClicked(o.state)),z.stageAndCommit([T.getNavigationUpdate(o.state)]))},[$,y,u,z,T]);return{source:y,tabs:$,activeTab:A,select:C}};

package/dist/react-sdk/domain-context/system-hooks/undo-redo-hooks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a project layout needs to offer undo and redo.
+ * - `canUndo` and `canRedo`: whether the undo history has a step to go back or forward to; they follow every change.
+ * - `undo`: returns to the previous step and pushes the undo-button analytics event; does nothing while `canUndo`
+ *   is false.
+ * - `redo`: returns to the next step and pushes the redo-button analytics event; does nothing while `canRedo` is
+ *   false.
+ */
+export interface UseUndoRedoResult {
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly undo: () => void;
+    readonly redo: () => void;
+}
+export type UseUndoRedo = () => UseUndoRedoResult;
+/**
+ * Hook to undo and redo changes of the configuration, as the built-in toolbar's undo and redo buttons do. It does
+ * not check read mode; a layout hides undo and redo for a viewer.
+ */
+export declare const useUndoRedo: UseUndoRedo;

package/dist/react-sdk/domain-context/system-hooks/undo-redo-hooks.js

@@ -0,0 +1 @@
+import{useCallback as o}from"react";import{FrontendAnalyticsFactory as e,useAnalyticsService as n}from"../../application-runtime/index.js";import{useDomain as t}from"../common-hooks/use-domain-context.js";import{useEagerObservableValue as r}from"../common-hooks/use-observable-selector.js";export const useUndoRedo=()=>{let d=n(),{undoSystem:m}=t(),{canUndo:s,canRedo:c}=r(m.can$);return{canUndo:s,canRedo:c,undo:o(()=>{m.canUndo()&&(d.push(e.UndoButtonClicked()),m.undo())},[d,m]),redo:o(()=>{m.canRedo()&&(d.push(e.RedoButtonClicked()),m.redo())},[d,m])}};

package/dist/react-sdk/domain-controls/hooks/use-angle-dimension.d.ts

@@ -2,7 +2,7 @@ import { type AnalyticsEvent, type AngleDimensionComponent, AngleUnit, type Comp
 export declare const AngleDimensionSliderUpdateTag = "setAngleDimension";
 export type IsAngleDimensionUpdate<ENTITIES extends DomainEntity<string>> = (update: StateUpdate<ENTITIES, ENTITIES>, types: ReadonlyArray<ENTITIES['type']>, instanceName: string) => update is ComponentModification<AngleDimensionComponent>;
 export declare const isAngleDimensionUpdate: (update: StateUpdate<DomainEntity<string>, DomainEntity<string>>, types: readonly string[], instanceName: string) => update is ComponentModification<AngleDimensionComponent>;
-export declare const useAngleDimension: (entityId: DomainEntityId<string>, instanceName: string, fixableViolations?: string[], createAnalyticsEvent?: (instanceName: string, entityId: DomainEntityId<string>, value: number) => AnalyticsEvent, stageOnUpdate?: boolean) => {
+export declare const useAngleDimension: (entityId: DomainEntityId<string>, instanceName: string, fixableViolations?: readonly string[], createAnalyticsEvent?: (instanceName: string, entityId: DomainEntityId<string>, value: number) => AnalyticsEvent, stageOnUpdate?: boolean) => {
     value: number;
     min: number | undefined;
     max: number | undefined;

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

@@ -1,2 +1,3 @@
 export { usePhoenixHandler, useSystemPhoenixHandler, useSystemPhoenixAsyncHandler } from './PhoenixHandler.js';
 export { PhoenixHandlerBoundary } from './PhoenixHandlerBoundary.js';
+export { type UseFinalizeAction, type UseFinalizeActionResult, useFinalizeAction } from './use-finalize-action.js';

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

@@ -1 +1 @@
-export{usePhoenixHandler,useSystemPhoenixHandler,useSystemPhoenixAsyncHandler}from"./PhoenixHandler.js";export{PhoenixHandlerBoundary}from"./PhoenixHandlerBoundary.js";
+export{usePhoenixHandler,useSystemPhoenixHandler,useSystemPhoenixAsyncHandler}from"./PhoenixHandler.js";export{PhoenixHandlerBoundary}from"./PhoenixHandlerBoundary.js";export{useFinalizeAction}from"./use-finalize-action.js";

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/sdk",
-  "version": "0.50.0-develop.f03b563886",
+  "version": "0.50.0-develop.f81ab6ac76",
   "description": "TypeScript SDK and CLI for building, running, and deploying Phoenix configurator applications.",
   "keywords": [
     "salsita",
@@ -13,6 +13,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.13"
+  },
   "type": "module",
   "imports": {
     "#package/admin": {
@@ -196,7 +199,7 @@
     "domain-cli": "dist/legacy/domain-cli/cli.js",
     "embedding-cli": "dist/legacy/embedding-cli/cli.js",
     "webhook-cli": "dist/legacy/webhook-cli/cli.js",
-    "phoenix": "dist/phoenix/cli.js"
+    "phoenix": "dist/phoenix/bin.js"
   },
   "files": [
     "dist",
@@ -212,12 +215,14 @@
     "@emotion/cache": "11.11.0",
     "@fontsource-variable/roboto": "5.2.5",
     "@gltf-transform/core": "4.3.0",
-    "@gltf-transform/functions": "4.3.0",
+    "@lingui/babel-plugin-lingui-macro": "5.9.5",
+    "@lingui/cli": "5.9.5",
+    "@lingui/conf": "5.9.5",
     "@lingui/message-utils": "5.9.5",
+    "@lingui/swc-plugin": "5.11.0",
     "@lingui/vite-plugin": "5.9.5",
     "@monaco-editor/react": "4.7.0",
     "@mui/utils": "5.17.1",
-    "@phosphor-icons/core": "2.1.1",
     "@swc/core": "1.15.40",
     "@swc/wasm-web": "1.15.40",
     "@tanstack/ai": "0.64.0",
@@ -226,6 +231,7 @@
     "@trpc/react-query": "11.17.0",
     "@trpc/server": "11.17.0",
     "@types/aws-lambda": "8.10.133",
+    "@typescript/native": "npm:typescript@7.0.2",
     "@uiw/color-convert": "2.9.6",
     "@uiw/react-color-hue": "2.9.6",
     "@uiw/react-color-saturation": "2.9.6",
@@ -241,10 +247,12 @@
     "dotenv-expand": "10.0.0",
     "envalid": "8.1.1",
     "esbuild": "0.25.12",
+    "eslint": "9.39.4",
     "fs-extra": "11.2.0",
     "globby": "14.0.2",
     "graphql": "16.14.2",
     "html-to-text": "10.0.0",
+    "htmlparser2": "10.1.0",
     "ink": "5.2.1",
     "its-fine": "1.2.5",
     "jiti": "2.7.0",
@@ -254,37 +262,35 @@
     "lodash-es": "4.18.1",
     "mime-types": "2.1.35",
     "monaco-editor": "0.52.2",
+    "motion": "12.34.0",
     "mui-modal-provider": "2.4.6",
     "notistack": "3.0.2",
     "observable-hooks": "4.2.3",
     "openai": "7.23.0",
     "openapi-fetch": "0.9.2",
     "picomatch": "4.0.4",
-    "postprocessing": "6.36.3",
+    "prettier": "3.8.3",
     "promise-queue": "2.2.5",
     "react-device-detect": "2.2.3",
     "react-dnd": "16.0.1",
     "react-dnd-html5-backend": "16.0.1",
     "react-dropzone": "14.3.8",
     "react-error-boundary": "4.0.12",
-    "react-hook-form": "7.53.0",
     "react-json-tree": "0.20.0",
     "react-markdown": "9.0.1",
     "remark": "15.0.1",
     "remark-gfm": "4.0.0",
-    "rxjs": "7.8.2",
     "semver": "7.6.3",
     "spark-md5": "3.0.2",
     "tar-stream": "3.1.7",
-    "three": "0.160.1",
     "three-mesh-bvh": "0.8.0",
     "three-stdlib": "2.36.1",
     "troika-three-text": "0.47.2",
     "ts-pattern": "5.9.0",
+    "typescript": "6.0.3",
     "use-font-face-observer": "1.2.2",
     "usehooks-ts": "3.1.0",
     "uuid": "14.0.0",
-    "vaul": "1.1.2",
     "vite": "6.4.3",
     "vite-plugin-css-injected-by-js": "3.5.2",
     "vite-plugin-restart": "2.0.0",
@@ -292,19 +298,22 @@
     "yaml": "2.9.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.f03b563886",
-    "@salsita-ai/contracts": "0.50.0-develop.f03b563886"
+    "@salsita-ai/common": "0.50.0-develop.f81ab6ac76",
+    "@salsita-ai/contracts": "0.50.0-develop.f81ab6ac76"
   },
   "devDependencies": {
     "@clerk/clerk-react": "5.61.8",
     "@emotion/react": "11.11.3",
-    "@lingui/cli": "5.9.5",
+    "@emotion/styled": "11.11.0",
     "@lingui/core": "5.9.5",
     "@lingui/format-po": "5.9.5",
     "@lingui/macro": "5.9.5",
-    "@lingui/swc-plugin": "5.11.0",
+    "@lingui/react": "5.9.5",
     "@mui/material": "5.15.5",
     "@mui/system": "5.16.7",
+    "@phosphor-icons/core": "2.1.1",
+    "@react-three/drei": "9.97.6",
+    "@react-three/fiber": "8.15.16",
     "@react-three/postprocessing": "2.16.3",
     "@storybook/react-vite": "10.4.1",
     "@svgr/cli": "8.1.0",
@@ -333,37 +342,39 @@
     "babel-plugin-macros": "3.1.0",
     "buffer": "6.0.3",
     "chokidar-cli": "3.0.0",
-    "eslint": "9.39.4",
     "happy-dom": "20.9.0",
     "ink-testing-library": "4.0.0",
-    "motion": "12.34.0",
     "openapi-typescript": "7.4.1",
-    "prettier": "3.8.3",
+    "postprocessing": "6.36.3",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "rxjs": "7.8.2",
     "storybook": "10.4.1",
+    "three": "0.160.1",
     "tsx": "4.22.3",
-    "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.11",
     "server": "1.64.0"
   },
   "peerDependencies": {
-    "@clerk/clerk-react": "5.61.8",
-    "@emotion/react": "11.11.3",
-    "@emotion/styled": "11.11.0",
-    "@lingui/core": "5.9.5",
-    "@lingui/react": "5.9.5",
-    "@mui/material": "5.15.5",
-    "@mui/system": "5.16.7",
-    "@react-three/drei": "9.97.6",
-    "@react-three/fiber": "8.15.16",
-    "@react-three/postprocessing": "2.16.3",
-    "@tanstack/react-query": "5.100.14",
-    "@vitejs/plugin-react": "5.2.0",
-    "envalid": "8.1.1",
-    "motion": "12.34.0",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
-    "three": "0.160.1",
-    "uuid": "14.0.0"
+    "@clerk/clerk-react": "^5.61.8",
+    "@emotion/react": "^11.11.3",
+    "@emotion/styled": "^11.11.0",
+    "@lingui/core": "^5.9.5",
+    "@lingui/react": "^5.9.5",
+    "@mui/material": "^5.15.5",
+    "@mui/system": "^5.16.7",
+    "@react-three/drei": "^9.97.6",
+    "@react-three/fiber": "^8.15.16",
+    "@react-three/postprocessing": "^2.16.3",
+    "@tanstack/react-query": "^5.100.14",
+    "@types/react": "^18.3.8",
+    "@types/react-dom": "^18.3.0",
+    "@types/three": "^0.160.0",
+    "postprocessing": "~6.36.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rxjs": "^7.8.2",
+    "three": "^0.160.1"
   },
   "peerDependenciesMeta": {
     "@clerk/clerk-react": {
@@ -395,6 +406,7 @@
     "prettify:fix": "prettier --write .",
     "verify:fix": "pnpm build && pnpm run ts:check && pnpm docs:verify && pnpm lint:fix && pnpm prettify:fix && pnpm test",
     "test": "vitest run",
-    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1"
+    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1 && pnpm ts:check:tests",
+    "ts:check:tests": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.test.json --noEmit --checkers 1"
   }
 }