@salsita-ai/sdk 0.50.0-develop.f6390cb584 → 0.50.0-develop.f9cd9b3a12

package/dist/react-sdk/application-runtime/hooks/responsive/use-responsive-store.d.ts

@@ -0,0 +1,24 @@
+import type { CanvasPadding, ResponsiveActions, ResponsiveState, ResponsiveViewportSize } from '../../responsive/index.js';
+/**
+ * The runtime's responsive state in the shape `ResponsiveApplicationProvider` of
+ * `@salsita-ai/sdk/ui` takes as its `store`, which that package declares by shape because it imports
+ * no other SDK package.
+ *
+ * @internal Runtime plumbing 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 ResponsiveStore extends Omit<ResponsiveActions, 'reset'> {
+    /** Calls `onChange` after every change of the runtime; returns the unsubscribe. */
+    readonly subscribe: (onChange: () => void) => () => void;
+    readonly getState: () => ResponsiveState;
+    readonly getViewportSize: () => ResponsiveViewportSize;
+    readonly getCanvasPadding: () => CanvasPadding;
+}
+/**
+ * The responsive state of the application this component is mounted in, as the store its root
+ * container measures into and `useResponsive()` reads from. Stable for the runtime's lifetime.
+ *
+ * @internal Runtime plumbing for the SDK's own UI. A project layout uses `useActiveViewports()`
+ * from `@salsita-ai/sdk/react` and `useSceneSafeArea()` from `@salsita-ai/sdk/configurator`.
+ */
+export declare const useResponsiveStore: () => ResponsiveStore;

package/dist/react-sdk/application-runtime/hooks/responsive/use-responsive-store.js

@@ -0,0 +1 @@
+import{useMemo as e}from"react";import{useResponsiveApplication as t}from"./use-responsive-application.js";export const useResponsiveStore=()=>{let{runtime:s,selectors:i,actions:a}=t();return e(()=>({setViewport:a.setViewport,setBreakpoints:a.setBreakpoints,setCanvasPadding:a.setCanvasPadding,expand:a.expand,collapse:a.collapse,hide:a.hide,show:a.show,setAnimating:a.setAnimating,subscribe:s.subscribe,getState:i.getResponsiveState,getViewportSize:i.getViewportSize,getCanvasPadding:i.getCanvasPadding}),[s,i,a])};

package/dist/react-sdk/application-runtime/hooks/use-access-service.d.ts

@@ -6,6 +6,11 @@ interface AccessServiceProviderProps {
 }
 export declare const AccessServiceProvider: (props: AccessServiceProviderProps) => import("react/jsx-runtime").JSX.Element;
 export declare const useProvidedAccessService: () => AccessService;
+/**
+ * The provided access service with `accessInfo.viewMode` set by the application's read-only rule,
+ * the domain-context selector `getIsViewMode`: the access opens the configuration for viewing only,
+ * or the host element is `readonly`. The assistant's `apply` follows the same selector.
+ */
 export declare const useAccessService: () => AccessService;
 export declare const useConfigurationId: () => string;
 export declare const useConfiguratorRawAccessService: () => AccessService | null;

package/dist/react-sdk/application-runtime/hooks/use-access-service.js

@@ -1 +1 @@
-import{jsx as e}from"react/jsx-runtime";import{createContext as s,useContext as c,useMemo as o}from"react";import{standardWebComponentProperties as r}from"#package/domain";import{useApplicationRuntime as t}from"../provider/index.js";import{useApplicationRuntimeSelector as i}from"./use-application-runtime-selector.js";import{useWebComponentPropertyValue as n}from"./use-web-component.js";let a=s(null);export const AccessServiceProvider=s=>e(a.Provider,{value:s.value,children:s.children});export const useProvidedAccessService=()=>{let e=c(a);if(null===e)throw Error("Access service not found! Render access-dependent hooks inside AccessServiceProvider.");return e};export const useAccessService=()=>{let e=n(r.readonly),s=useProvidedAccessService();return o(()=>({...s,accessInfo:{...s.accessInfo,viewMode:s.accessInfo.viewMode||e}}),[s,e])};export const useConfigurationId=()=>useProvidedAccessService().configurationId;export const useConfiguratorRawAccessService=()=>i(t().selectors.access.getConfiguratorRawAccessService);export const useAdminRawAccessService=()=>i(t().selectors.access.getAdminRawAccessService);export const useConfiguratorRawAccessInfo=()=>i(t().selectors.access.getConfiguratorRawAccessInfo);export const useAdminRawAccessInfo=()=>i(t().selectors.access.getAdminRawAccessInfo);export const useAccessInfoActions=()=>t().actions.access;
+import{jsx as e}from"react/jsx-runtime";import{createContext as s,useContext as c,useMemo as o}from"react";import{standardWebComponentProperties as r}from"#package/domain";import{useApplicationRuntime as t,useApplicationType as i}from"../provider/index.js";import{ApplicationType as n}from"../runtime/index.js";import{useApplicationRuntimeSelector as a}from"./use-application-runtime-selector.js";import{useWebComponentPropertyValue as d}from"./use-web-component.js";let u=s(null);export const AccessServiceProvider=s=>e(u.Provider,{value:s.value,children:s.children});export const useProvidedAccessService=()=>{let e=c(u);if(null===e)throw Error("Access service not found! Render access-dependent hooks inside AccessServiceProvider.");return e};export const useAccessService=()=>{let e=i(),s=t(),c=useProvidedAccessService(),u=e===n.Admin,m=a(u?s.selectors.domainContext.admin.getIsViewMode:s.selectors.domainContext.configurator.getIsViewMode),f=d(r.readonly),p=m||u&&f;return o(()=>({...c,accessInfo:{...c.accessInfo,viewMode:p}}),[c,p])};export const useConfigurationId=()=>useProvidedAccessService().configurationId;export const useConfiguratorRawAccessService=()=>a(t().selectors.access.getConfiguratorRawAccessService);export const useAdminRawAccessService=()=>a(t().selectors.access.getAdminRawAccessService);export const useConfiguratorRawAccessInfo=()=>a(t().selectors.access.getConfiguratorRawAccessInfo);export const useAdminRawAccessInfo=()=>a(t().selectors.access.getAdminRawAccessInfo);export const useAccessInfoActions=()=>t().actions.access;

package/dist/react-sdk/application-runtime/hooks/use-phoenix-element-slots.d.ts

@@ -1,8 +1,9 @@
-import type { PropsWithChildren } from 'react';
+import type { ComponentType, PropsWithChildren } from 'react';
 import type { CustomPhoenixEntityElementProps } from '#package/domain';
 export interface PhoenixElementSlots {
     readonly entityElements: Record<string, (props: CustomPhoenixEntityElementProps) => JSX.Element>;
     readonly layoutElements: Record<string, (props: PropsWithChildren) => JSX.Element>;
+    readonly assistantFormElements: Record<string, ComponentType<never>>;
     readonly hashes: Record<string, string>;
 }
 export declare const usePhoenixElementSlots: () => PhoenixElementSlots;

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

@@ -5,6 +5,7 @@ export * from './web-component/index.js';
 export * from './common-services/index.js';
 export * from './domain-application-context/index.js';
 export * from './integration/index.js';
+export { type CanvasPadding, type ResponsiveApplicationState, type ResponsiveBreakpoints, type ResponsiveRuntimeState, type ResponsiveState, type ResponsiveViewport, type ResponsiveViewportSize, } from './responsive/index.js';
 export * from './routing/index.js';
 export * from './session/index.js';
 export * from './mocks/index.js';

package/dist/react-sdk/application-runtime/integration/initialize.d.ts

@@ -1,7 +1,8 @@
-import type { IntegrationActions } from './actions.js';
 import type { IntegrationState } from './types.js';
-interface Context {
-    readonly actions: IntegrationActions;
-}
-export declare const initializeIntegration: (context: Context) => IntegrationState;
-export {};
+/**
+ * The integration slice's initial state. The admin integration service is not part of it: the
+ * integration selectors own it.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const initializeIntegration: () => IntegrationState;

package/dist/react-sdk/application-runtime/integration/initialize.js

@@ -1 +1 @@
-import{AdminIntegrationService as e}from"./admin-integration-service.js";export const initializeIntegration=i=>{let{actions:n}=i;return{adminIntegrationService:new e({actions:n}),embeddedView:null}};
+export const initializeIntegration=()=>({embeddedView:null});

package/dist/react-sdk/application-runtime/integration/selectors.d.ts

@@ -1,17 +1,26 @@
+import type { IntegrationActions } from './actions.js';
+import { AdminIntegrationService } from './admin-integration-service.js';
 import type { IntegrationState } from './types.js';
 export interface IntegrationSelectorState {
     readonly integration: IntegrationState;
 }
 interface Context {
     readonly getState: () => IntegrationSelectorState;
+    /** The actions the selector-owned admin integration service calls. */
+    readonly actions: IntegrationActions;
 }
+/**
+ * The integration selectors. They own the runtime's admin integration service, built from the
+ * given actions.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
 export declare const createIntegrationSelectors: (context: Context) => {
-    selectAdminIntegrationService: import("@salsita-ai/common/utils").Selector<IntegrationSelectorState, import("./admin-integration-service.js").AdminIntegrationService>;
     selectIntegrationState: import("@salsita-ai/common/utils").Selector<IntegrationSelectorState, IntegrationState>;
     selectEmbeddedView: import("@salsita-ai/common/utils").Selector<IntegrationSelectorState, import("./types.js").EmbeddedView>;
     selectPresetEmbeddedState: import("@salsita-ai/common/utils").Selector<IntegrationSelectorState, import("./types.js").PresetEmbeddedView | null>;
     selectRecipeEmbeddedState: import("@salsita-ai/common/utils").Selector<IntegrationSelectorState, import("./types.js").RecipeEmbeddedView | null>;
-    getAdminIntegrationService: () => import("./admin-integration-service.js").AdminIntegrationService;
+    getAdminIntegrationService: () => AdminIntegrationService;
     getIntegrationState: () => IntegrationState;
     getEmbeddedView: () => import("./types.js").EmbeddedView;
     getPresetEmbeddedState: () => import("./types.js").PresetEmbeddedView | null;

package/dist/react-sdk/application-runtime/integration/selectors.js

@@ -1 +1 @@
-import{createSelector as e}from"@salsita-ai/common/utils";export const createIntegrationSelectors=t=>{let{getState:i}=t,n=e.withTypes(),r=n.leaf(e=>e.integration.adminIntegrationService),a=n.leaf(e=>e.integration),d=n.leaf(e=>e.integration.embeddedView),o=n([d],e=>e?.type==="recipe"?e:null),g=n([d],e=>e?.type==="preset"?e:null);return{selectAdminIntegrationService:r,selectIntegrationState:a,selectEmbeddedView:d,selectPresetEmbeddedState:g,selectRecipeEmbeddedState:o,getAdminIntegrationService:()=>r(i()),getIntegrationState:()=>a(i()),getEmbeddedView:()=>d(i()),getPresetEmbeddedState:()=>g(i()),getRecipeEmbeddedState:()=>o(i())}};
+import{createSelector as e}from"@salsita-ai/common/utils";import{AdminIntegrationService as t}from"./admin-integration-service.js";export const createIntegrationSelectors=i=>{let{getState:n,actions:r}=i,a=e.withTypes(),o=new t({actions:r}),d=a.leaf(e=>e.integration),m=a.leaf(e=>e.integration.embeddedView),g=a([m],e=>e?.type==="recipe"?e:null),l=a([m],e=>e?.type==="preset"?e:null);return{selectIntegrationState:d,selectEmbeddedView:m,selectPresetEmbeddedState:l,selectRecipeEmbeddedState:g,getAdminIntegrationService:()=>o,getIntegrationState:()=>d(n()),getEmbeddedView:()=>m(n()),getPresetEmbeddedState:()=>l(n()),getRecipeEmbeddedState:()=>g(n())}};

package/dist/react-sdk/application-runtime/integration/types.d.ts

@@ -1,5 +1,4 @@
 import type { DomainEntityId, Preset, Recipe } from '#package/domain';
-import type { AdminIntegrationService } from './admin-integration-service.js';
 export interface PresetEmbeddedView {
     readonly type: 'preset';
     readonly presetId: Preset['id'];
@@ -11,7 +10,11 @@ export interface RecipeEmbeddedView {
     readonly rootRecipeId?: DomainEntityId<string>;
 }
 export type EmbeddedView = PresetEmbeddedView | RecipeEmbeddedView | null;
+/**
+ * The integration slice's state, as the runtime state and `useIntegrationState()` hold it. The admin
+ * integration service is not part of it: the integration selectors own it, and
+ * `getAdminIntegrationService()` returns it.
+ */
 export interface IntegrationState {
-    readonly adminIntegrationService: AdminIntegrationService;
     readonly embeddedView: EmbeddedView;
 }

package/dist/react-sdk/application-runtime/mocks/create-mock-application-runtime.js

@@ -1 +1 @@
-import{memoOnce as e}from"@salsita-ai/common/utils";import{AccessLevel as t}from"@salsita-ai/contracts/api";import{createDomainRuntime as o,createMockDomainRuntimeServices as n,createMockSessionContext as s}from"#package/domain";import{createCommonServicesSelectors as i}from"../common-services/index.js";import{createDomainApplicationContextSelectors as a}from"../domain-application-context/index.js";import{createIntegrationActions as r,createIntegrationSelectors as c,initializeIntegration as m}from"../integration/index.js";import{createRoutingActions as d,createRoutingSelectors as p,initializeRouting as l}from"../routing/index.js";import{SessionService as S,createSessionRuntimeActions as g,createSessionRuntimeSelectors as v,initializeSessionRuntime as u}from"../session/index.js";import{createMockWebComponentApi as f}from"../web-component/index.js";export const createMockApplicationRuntime=(C,x)=>{var b;let w,y,A,D,k,E,I,R,h,j,O,T,L,F,M,{sessionData:U,mode:V,role:z}=x,q=n(),B=(b={webComponentOptions:x.webComponentOptions??C.mount.options,webComponentApi:x.webComponentApi??f()},A=u(),D=o({config:C,services:q,getExtensionSystems:e=>M[e].getInitializableSystems()}),k=new Set,E=()=>{k.forEach(e=>{e()})},w=m({actions:I=r({setIntegration:e=>{w=e(w),E()}})}),R=c({getState:()=>({integration:w})}),h=d({setRouting:e=>{y=e(y),E()}}),y=l(),j=p({getState:()=>({...D.getState(),routing:y}),actions:h,accessActions:D.actions.access,loadedDataActions:D.actions.loadedData,domainServicesSelectors:D.selectors.domainServices,overridesSelectors:D.selectors.overrides}),O=i({getState:()=>({...D.getState(),session:A}),environmentSelectors:D.selectors.environment,specSelectors:D.selectors.spec,accessSelectors:D.selectors.access,domainServicesSelectors:D.selectors.domainServices,webComponentOptions:b.webComponentOptions,webComponentApi:b.webComponentApi,getSessionService:()=>F(),routingSelectors:j}),T=g({setSessionRuntime:e=>{A=e(A),E()}}),L=v({getState:()=>({...D.getState(),session:A}),sessionContextSelectors:D.selectors.sessionContext}),F=e(()=>new S({getLogger:()=>D.selectors.domainServices.getLogger(),getAnalyticsService:()=>D.selectors.domainServices.getAnalyticsService(),getUnauthenticatedClient:O.getUnauthenticatedClient,environmentSelectors:D.selectors.environment,sessionActions:T,setSessionContext:D.actions.sessionContext.setSessionContext,sessionSelectors:L,specSelectors:D.selectors.spec})),M={configurator:a({applicationType:"configurator",commonServicesSelectors:O,domainServicesSelectors:D.selectors.domainServices,domainContextSelectors:D.selectors.domainContext.configurator,getApplicationRuntimeExtensions:()=>[]}),admin:a({applicationType:"admin",commonServicesSelectors:O,domainServicesSelectors:D.selectors.domainServices,domainContextSelectors:D.selectors.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})},{subscribe:e=>{k.add(e);let t=D.subscribe(e);return()=>{k.delete(e),t()}},getState:()=>({...D.getState(),integration:w,routing:y,session:A}),selectors:{...D.selectors,commonServices:O,integration:R,routing:j,session:L,domainApplicationContext:M},actions:{...D.actions,integration:I,routing:h,session:T}}),G=B.getState().spec;return B.actions.spec.updateSpec({...G,configurator:{...G.configurator,createTransformers:e=>x.transformers.map(t=>t.transformer.register(e,t.priority??1/0))}}),B.actions.sessionContext.setSessionContext(s(z,U)),B.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===V?t.Read:t.Owner,viewMode:"read"===V,revisionId:void 0,configurationId:"mock"}),B.actions.domainData.setDomainData({publishedData:x.publishedData,frontendData:x.frontendData,backendData:x.backendData}),B.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:x.entities,modelVersion:C.domain.domainFactory.modelVersion,rootEntityType:x.rootEntityType,schemaIdentity:C.domain.domainFactory}),B};
+import{memoOnce as e}from"@salsita-ai/common/utils";import{AccessLevel as t}from"@salsita-ai/contracts/api";import{createDomainRuntime as o,createMockDomainRuntimeServices as i,createMockSessionContext as n}from"#package/domain";import{createCommonServicesSelectors as s}from"../common-services/index.js";import{createDomainApplicationContextSelectors as a}from"../domain-application-context/index.js";import{createIntegrationActions as r,createIntegrationSelectors as c,initializeIntegration as m}from"../integration/index.js";import{createResponsiveActions as p,createResponsiveSelectors as d,initializeResponsive as l}from"../responsive/index.js";import{createRoutingActions as g,createRoutingSelectors as S,initializeRouting as v}from"../routing/index.js";import{SessionService as u,createSessionRuntimeActions as f,createSessionRuntimeSelectors as x,initializeSessionRuntime as C}from"../session/index.js";import{createMockWebComponentApi as b}from"../web-component/index.js";export const createMockApplicationRuntime=(y,w)=>{var A;let D,k,R,j,E,I,T,h,O,L,F,M,U,V,z,q,B,G,{sessionData:H,mode:J,role:K}=w,N=i(),P=(A={webComponentOptions:w.webComponentOptions??y.mount.options,webComponentApi:w.webComponentApi??b()},R=C(),j=o({config:y,services:N,getExtensionSystems:e=>G[e].getInitializableSystems()}),E=new Set,I=()=>{E.forEach(e=>{e()})},T=r({setIntegration:e=>{D=e(D),I()}}),D=m(),h=c({getState:()=>({integration:D}),actions:T}),O=g({setRouting:e=>{k=e(k),I()}}),k=v(),L=S({getState:()=>({...j.getState(),routing:k}),actions:O,accessActions:j.actions.access,loadedDataActions:j.actions.loadedData,domainServicesSelectors:j.selectors.domainServices,overridesSelectors:j.selectors.overrides}),F=l(),M=p({setResponsive:e=>{let t=e(F);t!==F&&(F=t,I())}}),U={configurator:d({getState:()=>({responsive:F}),applicationType:"configurator"}),admin:d({getState:()=>({responsive:F}),applicationType:"admin"})},V=s({getState:()=>({...j.getState(),session:R}),environmentSelectors:j.selectors.environment,specSelectors:j.selectors.spec,accessSelectors:j.selectors.access,domainServicesSelectors:j.selectors.domainServices,webComponentOptions:A.webComponentOptions,webComponentApi:A.webComponentApi,getSessionService:()=>B(),routingSelectors:L}),z=f({setSessionRuntime:e=>{R=e(R),I()}}),q=x({getState:()=>({...j.getState(),session:R}),sessionContextSelectors:j.selectors.sessionContext}),B=e(()=>new u({getLogger:()=>j.selectors.domainServices.getLogger(),getAnalyticsService:()=>j.selectors.domainServices.getAnalyticsService(),getUnauthenticatedClient:V.getUnauthenticatedClient,environmentSelectors:j.selectors.environment,sessionActions:z,setSessionContext:j.actions.sessionContext.setSessionContext,sessionSelectors:q,specSelectors:j.selectors.spec})),G={configurator:a({applicationType:"configurator",commonServicesSelectors:V,domainServicesSelectors:j.selectors.domainServices,domainContextSelectors:j.selectors.domainContext.configurator,getApplicationRuntimeExtensions:()=>[]}),admin:a({applicationType:"admin",commonServicesSelectors:V,domainServicesSelectors:j.selectors.domainServices,domainContextSelectors:j.selectors.domainContext.admin,getApplicationRuntimeExtensions:()=>[]})},{subscribe:e=>{E.add(e);let t=j.subscribe(e);return()=>{E.delete(e),t()}},getState:()=>({...j.getState(),integration:D,responsive:F,routing:k,session:R}),selectors:{...j.selectors,commonServices:V,integration:h,responsive:U,routing:L,session:q,domainApplicationContext:G},actions:{...j.actions,integration:T,responsive:M,routing:O,session:z}}),Q=P.getState().spec;return P.actions.spec.updateSpec({...Q,configurator:{...Q.configurator,createTransformers:e=>w.transformers.map(t=>t.transformer.register(e,t.priority??1/0))}}),P.actions.sessionContext.setSessionContext(n(K,H)),P.actions.access.setConfiguratorAccessInfo({raw:"mock-access-token",access:"read"===J?t.Read:t.Owner,viewMode:"read"===J,revisionId:void 0,configurationId:"mock"}),P.actions.domainData.setDomainData({publishedData:w.publishedData,frontendData:w.frontendData,backendData:w.backendData}),P.actions.loadedData.completeConfiguratorLoad({initialRevisionId:"mock-revision",initialEntities:w.entities,modelVersion:y.domain.domainFactory.modelVersion,rootEntityType:w.rootEntityType,schemaIdentity:y.domain.domainFactory}),P};

package/dist/react-sdk/application-runtime/responsive/actions.d.ts

@@ -0,0 +1,47 @@
+import type { DomainApplicationType } from '#package/domain';
+import type { CanvasPadding, ResponsiveBreakpoints, ResponsiveRuntimeState, ResponsiveViewport } from './types.js';
+interface Context {
+    readonly setResponsive: (fn: (state: ResponsiveRuntimeState) => ResponsiveRuntimeState) => void;
+}
+/**
+ * Every action returns the slice unchanged when the value is already set, so the runtime publishes
+ * nothing and no subscriber recomputes.
+ */
+declare const createApplicationActions: (context: Context, applicationType: DomainApplicationType) => {
+    setViewport: (viewport: ResponsiveViewport) => void;
+    setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
+    setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+    expand: () => void;
+    collapse: () => void;
+    hide: () => void;
+    show: () => void;
+    setAnimating: (isAnimating: boolean) => void;
+    reset: () => void;
+};
+/** One set of actions per application, as the domain context keys its own. */
+export declare const createResponsiveActions: (context: Context) => {
+    configurator: {
+        setViewport: (viewport: ResponsiveViewport) => void;
+        setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
+        setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+        expand: () => void;
+        collapse: () => void;
+        hide: () => void;
+        show: () => void;
+        setAnimating: (isAnimating: boolean) => void;
+        reset: () => void;
+    };
+    admin: {
+        setViewport: (viewport: ResponsiveViewport) => void;
+        setBreakpoints: (breakpoints: ResponsiveBreakpoints) => void;
+        setCanvasPadding: (canvasPadding: CanvasPadding) => void;
+        expand: () => void;
+        collapse: () => void;
+        hide: () => void;
+        show: () => void;
+        setAnimating: (isAnimating: boolean) => void;
+        reset: () => void;
+    };
+};
+export type ResponsiveActions = ReturnType<typeof createApplicationActions>;
+export {};

package/dist/react-sdk/application-runtime/responsive/actions.js

@@ -0,0 +1 @@
+import{initializeResponsiveApplication as t}from"./initialize.js";let e=(e,i)=>{let n=t=>{e.setResponsive(e=>{let n=e[i],s=t(n);return s===n?e:{...e,[i]:s}})},s=t=>{n(e=>e.isExpanded===t?e:{...e,isExpanded:t})},r=t=>{n(e=>e.isHidden===t?e:{...e,isHidden:t})};return{setViewport:t=>{n(e=>{let i;return(i=e.viewport,null!==i&&i.width===t.width&&i.height===t.height&&i.isLandscape===t.isLandscape&&i.isPortrait===t.isPortrait)?e:{...e,viewport:t}})},setBreakpoints:t=>{n(e=>{let i;return(i=e.breakpoints,i.sm===t.sm&&i.md===t.md&&i.lg===t.lg)?e:{...e,breakpoints:t}})},setCanvasPadding:t=>{n(e=>{let i;return(i=e.canvasPadding,i.top===t.top&&i.right===t.right&&i.bottom===t.bottom&&i.left===t.left)?e:{...e,canvasPadding:t}})},expand:()=>{s(!0)},collapse:()=>{s(!1)},hide:()=>{r(!0)},show:()=>{r(!1)},setAnimating:t=>{n(e=>e.isAnimating===t?e:{...e,isAnimating:t})},reset:()=>{n(()=>t())}}};export const createResponsiveActions=t=>({configurator:e(t,"configurator"),admin:e(t,"admin")});

package/dist/react-sdk/application-runtime/responsive/index.d.ts

@@ -0,0 +1,4 @@
+export * from './actions.js';
+export * from './initialize.js';
+export * from './selectors.js';
+export type * from './types.js';

package/dist/react-sdk/application-runtime/responsive/index.js

@@ -0,0 +1 @@
+export*from"./actions.js";export*from"./initialize.js";export*from"./selectors.js";

package/dist/react-sdk/application-runtime/responsive/initialize.d.ts

@@ -0,0 +1,3 @@
+import type { ResponsiveApplicationState, ResponsiveRuntimeState } from './types.js';
+export declare const initializeResponsiveApplication: () => ResponsiveApplicationState;
+export declare const initializeResponsive: () => ResponsiveRuntimeState;

package/dist/react-sdk/application-runtime/responsive/initialize.js

@@ -0,0 +1 @@
+export const initializeResponsiveApplication=()=>({viewport:null,breakpoints:{sm:480,md:768,lg:1024},canvasPadding:{top:0,right:0,bottom:0,left:0},isExpanded:!1,isHidden:!1,isAnimating:!1});export const initializeResponsive=()=>({configurator:initializeResponsiveApplication(),admin:initializeResponsiveApplication()});

package/dist/react-sdk/application-runtime/responsive/selectors.d.ts

@@ -0,0 +1,20 @@
+import type { DomainApplicationType } from '#package/domain';
+import type { ResponsiveRuntimeState, ResponsiveState, ResponsiveViewportSize } from './types.js';
+export interface ResponsiveSelectorState {
+    readonly responsive: ResponsiveRuntimeState;
+}
+interface Context {
+    readonly getState: () => ResponsiveSelectorState;
+    readonly applicationType: DomainApplicationType;
+}
+/** The selectors of one application's responsive state; the runtime creates one set per application. */
+export declare const createResponsiveSelectors: (context: Context) => {
+    selectResponsiveState: import("@salsita-ai/common/utils").Selector<ResponsiveSelectorState, ResponsiveState>;
+    selectViewportSize: import("@salsita-ai/common/utils").Selector<ResponsiveSelectorState, ResponsiveViewportSize>;
+    selectCanvasPadding: import("@salsita-ai/common/utils").Selector<ResponsiveSelectorState, import("./types.js").CanvasPadding>;
+    getResponsiveState: () => ResponsiveState;
+    getViewportSize: () => ResponsiveViewportSize;
+    getCanvasPadding: () => import("./types.js").CanvasPadding;
+};
+export type ResponsiveSelectors = ReturnType<typeof createResponsiveSelectors>;
+export {};

package/dist/react-sdk/application-runtime/responsive/selectors.js

@@ -0,0 +1 @@
+import{createSelector as e}from"@salsita-ai/common/utils";export const createResponsiveSelectors=i=>{let{getState:s,applicationType:t}=i,a=e.withTypes(),o=a.leaf(e=>null!==e.responsive[t].viewport),n=a.leaf(e=>e.responsive[t].viewport?.width??0),r=a.leaf(e=>e.responsive[t].viewport?.height??0),p=a.leaf(e=>e.responsive[t].viewport?.isLandscape??!1),l=a.leaf(e=>e.responsive[t].viewport?.isPortrait??!1),v=a.leaf(e=>e.responsive[t].breakpoints),d=a.leaf(e=>e.responsive[t].canvasPadding),f=a.leaf(e=>e.responsive[t].isExpanded),g=a.leaf(e=>e.responsive[t].isHidden),h=a.leaf(e=>e.responsive[t].isAnimating),m=a([o,n,v],(e,i,s)=>e&&i<s.sm),w=a([o,n,v],(e,i,s)=>e&&i<=s.md),c=a([o,n,v],(e,i,s)=>e&&i<s.lg&&i>s.sm),u=a([o,n,v],(e,i,s)=>e&&i>s.md),P=a([m,w,c,u,p,l,d,f,g,h],(e,i,s,t,a,o,n,r,p,l)=>({isPhone:e,isMobile:i,isTablet:s,isDesktop:t,isLandscape:a,isPortrait:o,canvasPadding:n,isExpanded:r,isHidden:p,isAnimating:l})),S=a([n,r],(e,i)=>({width:Math.ceil(e),height:Math.ceil(i)}));return{selectResponsiveState:P,selectViewportSize:S,selectCanvasPadding:d,getResponsiveState:()=>P(s()),getViewportSize:()=>S(s()),getCanvasPadding:()=>d(s())}};

package/dist/react-sdk/application-runtime/responsive/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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 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;
+}
+/**
+ * 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 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 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 size of the application's root container, rounded up to whole pixels.
+ *
+ * @internal Runtime plumbing 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 ResponsiveViewportSize {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The responsive state of one mounted application: what it measured of its root container, the
+ * breakpoints that classify it, the canvas padding the scene is framed with, and whether the
+ * container is expanded over the host page, hidden, or in a layout animation.
+ *
+ * The configurator's root container writes it while it is mounted and resets it when it unmounts.
+ *
+ * @internal Runtime plumbing 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 ResponsiveApplicationState {
+    /** `null` until the root container is measured for the first time. */
+    readonly viewport: ResponsiveViewport | null;
+    readonly breakpoints: ResponsiveBreakpoints;
+    readonly canvasPadding: CanvasPadding;
+    readonly isExpanded: boolean;
+    readonly isHidden: boolean;
+    readonly isAnimating: boolean;
+}
+/**
+ * The `responsive` slice, one entry per application: an admin that embeds a configurator runs both
+ * in one runtime, and each has its own root container.
+ *
+ * @internal Runtime plumbing 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 ResponsiveRuntimeState {
+    readonly configurator: ResponsiveApplicationState;
+    readonly admin: ResponsiveApplicationState;
+}
+/**
+ * The responsive state the UI and the lifecycle read: the size classes of the root container, the
+ * canvas padding, and whether the container is expanded, hidden or animating.
+ *
+ * Every size class is `false` until the container is measured for the first time.
+ *
+ * @internal Runtime plumbing 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;
+}

package/dist/react-sdk/application-runtime/routing/routing-service.d.ts

@@ -17,11 +17,43 @@ interface RoutingServiceContext {
 }
 export declare class RoutingService {
     private readonly context;
-    private onGoToIndex;
-    private onNavigated;
+    private readonly onGoToIndexRegistrations;
+    private readonly onNavigatedRegistrations;
+    private unregisterSetOnGoToIndex;
+    private unregisterSetOnNavigated;
     constructor(context: RoutingServiceContext);
+    /**
+     * Registers the handler `goToIndex` calls instead of navigating; the handler navigates by calling
+     * `next`. The most recent registration is the active one. The returned function removes only this
+     * registration, so the one registered before it becomes active again.
+     * @internal Plumbing for `ConfiguratorRoutingProvider`; projects intercept `goToIndex` with
+     * `createOnGoToIndexHandler`.
+     */
+    registerOnGoToIndex: (handler: OnGoToIndexHandler) => (() => void);
+    /**
+     * Registers the callback told about each navigation `goToIndex` and `goToConfigurationDetail`
+     * make. The most recent registration is the active one, and it replaces the SDK's own reporting
+     * to the host (the `route` property, the configuration id in the URL and the `navigated` event)
+     * rather than listening beside it. The returned function removes only this registration, so the
+     * one registered before it becomes active again.
+     * @internal Plumbing for `ConfiguratorRoutingProvider`, which does that reporting.
+     */
+    registerOnNavigated: (handler: OnNavigatedHandler) => (() => void);
+    /**
+     * Replaces the handler this method registered before, on top of the other registrations; `null`
+     * removes it. Registrations made with `registerOnGoToIndex` stay.
+     * @deprecated Intercept `goToIndex` with a handler made by `createOnGoToIndexHandler` instead. This
+     * API will be removed in a future version.
+     */
     setOnGoToIndex: (handler: OnGoToIndexHandler | null) => void;
+    /**
+     * Replaces the callback this method registered before, on top of the other registrations; `null`
+     * removes it. Registrations made with `registerOnNavigated` stay.
+     * @deprecated Listen to the `navigated` event of the web component instead; a callback set here
+     * replaces the SDK's own reporting to the host. This API will be removed in a future version.
+     */
     setOnNavigated: (handler: OnNavigatedHandler | null) => void;
+    private notifyNavigated;
     routeTo: (routingState: RoutingState) => void;
     goToIndex: () => void;
     goToConfigurationDetail: (configurationId: string, accessToken?: string) => void;

package/dist/react-sdk/application-runtime/routing/routing-service.js

@@ -1 +1 @@
-import{InvalidAccessKeyError as t}from"#package/client";import{AnalyticsEventFactory as o,decodeAccessInfo as e}from"#package/domain";import{getAccessInfo as n,getAccessTokenFromLocalStorage as i,putAccessTokenToLocalStorage as s,removeAccessTokenFromLocalStorage as a}from"./access-service.js";import{ApplicationRoutes as c}from"./types.js";export class RoutingService{context;onGoToIndex=null;onNavigated=null;constructor(t){this.context=t}setOnGoToIndex=t=>{this.onGoToIndex=t};setOnNavigated=t=>{this.onNavigated=t};routeTo=t=>{var o;if(o=this.context.getRoutingState(),o.route===c.Index||t.route===c.Index?o.route===t.route:o.configurationId===t.configurationId&&o.accessToken===t.accessToken)return;if(this.context.loadedDataActions.resetConfiguratorLoad(),t.route===c.Index){this.context.accessActions.setConfiguratorAccessInfo(null),this.context.actions.setRoutingState(t);return}let e=n(t.configurationId,t.accessToken);this.context.accessActions.setConfiguratorAccessInfo(e),this.context.actions.setRoutingState(t),t.accessToken&&s(t.configurationId,t.accessToken)};goToIndex=()=>{let t=()=>{this.context.getAnalytics().push(o.NavigationEvent({navigationState:"productPage"})),this.context.getLogger().appendToGlobalContext({navigationState:"productPage"});let t={route:c.Index};this.routeTo(t),this.onNavigated?.(t)};null==this.onGoToIndex?t():this.onGoToIndex({next:t})};goToConfigurationDetail=(t,o)=>{let e={route:c.Configuration,configurationId:t,accessToken:o};this.routeTo(e),this.onNavigated?.(e)};rejectAccessToken=(t,o)=>{i(t)===o&&a(t)};requestAccessToken=(o,n)=>{if(null!==e(n,o))return n;let i=new t;throw this.rejectAccessToken(o,n),this.context.loadedDataActions.failConfiguratorLoad(i),i}}
+import{InvalidAccessKeyError as t}from"#package/client";import{AnalyticsEventFactory as e,decodeAccessInfo as o}from"#package/domain";import{getAccessInfo as n,getAccessTokenFromLocalStorage as i,putAccessTokenToLocalStorage as s,removeAccessTokenFromLocalStorage as a}from"./access-service.js";import{ApplicationRoutes as r}from"./types.js";let c=(t,e)=>{let o={handler:e};return t.push(o),()=>{let e=t.indexOf(o);-1!==e&&t.splice(e,1)}},g=t=>t.at(-1)?.handler??null;export class RoutingService{context;onGoToIndexRegistrations=[];onNavigatedRegistrations=[];unregisterSetOnGoToIndex=null;unregisterSetOnNavigated=null;constructor(t){this.context=t}registerOnGoToIndex=t=>c(this.onGoToIndexRegistrations,t);registerOnNavigated=t=>c(this.onNavigatedRegistrations,t);setOnGoToIndex=t=>{this.unregisterSetOnGoToIndex?.(),this.unregisterSetOnGoToIndex=null===t?null:this.registerOnGoToIndex(t)};setOnNavigated=t=>{this.unregisterSetOnNavigated?.(),this.unregisterSetOnNavigated=null===t?null:this.registerOnNavigated(t)};notifyNavigated=t=>{g(this.onNavigatedRegistrations)?.(t)};routeTo=t=>{var e;if(e=this.context.getRoutingState(),e.route===r.Index||t.route===r.Index?e.route===t.route:e.configurationId===t.configurationId&&e.accessToken===t.accessToken)return;if(this.context.loadedDataActions.resetConfiguratorLoad(),t.route===r.Index){this.context.accessActions.setConfiguratorAccessInfo(null),this.context.actions.setRoutingState(t);return}let o=n(t.configurationId,t.accessToken);this.context.accessActions.setConfiguratorAccessInfo(o),this.context.actions.setRoutingState(t),t.accessToken&&s(t.configurationId,t.accessToken)};goToIndex=()=>{let t=()=>{this.context.getAnalytics().push(e.NavigationEvent({navigationState:"productPage"})),this.context.getLogger().appendToGlobalContext({navigationState:"productPage"});let t={route:r.Index};this.routeTo(t),this.notifyNavigated(t)},o=g(this.onGoToIndexRegistrations);null==o?t():o({next:t})};goToConfigurationDetail=(t,e)=>{let o={route:r.Configuration,configurationId:t,accessToken:e};this.routeTo(o),this.notifyNavigated(o)};rejectAccessToken=(t,e)=>{i(t)===e&&a(t)};requestAccessToken=(e,n)=>{if(null!==o(n,e))return n;let i=new t;throw this.rejectAccessToken(e,n),this.context.loadedDataActions.failConfiguratorLoad(i),i}}