@salsita-ai/sdk 0.50.0-develop.78a839cc7b → 0.50.0-develop.7c472a27fe

package/dist/legacy/phoenix-cli/project-gen/generators/file-templates/agents/shared-sdk-content.js

@@ -22,12 +22,18 @@ Declarative 3D product configurator built with Phoenix SDK. Domain model defined
 - \`src/components/\` — ECS system components (\`phx.domain.attachComponent.withEntity()\`)
 - \`src/elements/\` — Page-level React components (\`phx.frontend.createCustomPhoenixLayoutElement()\`)
   - \`ConfiguratorLayout\`: a layout element with this name replaces everything the built-in layout renders for a loaded configuration, in owner and read mode, finalization included. Prefer arranging the spec's layout components; write one for shell-level changes, such as moving the sidebar or adding an area the built-in layout has no place for
-    - Mount \`LayoutSlots.SharedCanvas\` (from \`@salsita-ai/sdk/configurator\`) in a positioned root covering the page, or the app loader stays on screen; put the UI above it, positioned and after it in the markup. Call \`useSceneSafeArea()\` (same import) and put \`containerRef\` on the element covering the whole canvas and \`safeAreaRef\` on the region the UI leaves free, with \`pointerEvents: 'none'\`, so the camera frames the scene there
+    - Mount \`LayoutSlots.SharedCanvas\` (from \`@salsita-ai/sdk/configurator\`) in a positioned root covering the page; put the UI above it, positioned and after it in the markup. With the canvas mounted the app loader waits until the scene has loaded; a layout without a canvas is not held by the loader. Call \`phx.frontend.useSceneSafeArea()\` and put \`containerRef\` on the element covering the whole canvas and \`safeAreaRef\` on the region the UI leaves free, with \`pointerEvents: 'none'\`, so the camera frames the scene there
     - Sidebar moved, contents as the spec configures them: mount \`LayoutSlots.DesktopSidebar\` in a positioned container that sets its size, with \`side="start"\` on the left; \`docs/layouts/sidebar/in-a-custom-layout.mdx\` is the whole layout
-    - Your own UI: "Hooks for a Project Layout" in \`docs/phoenix/configurator-interface.mdx\` lists the hooks with what each returns (\`pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx\`), \`docs/phoenix/layout-slots.mdx\` the built-in pieces you can still mount, and \`docs/layouts/custom-layout.mdx\` is a worked example
-    - Messages: mount \`LayoutSlots.Services\` for the built-in snackbars, or show violations, side-effect hints and errors yourself with \`phx.frontend.useConfiguratorMessages(onMessage)\`, not both. Either way mount a snackbar root (\`LayoutSlots.DesktopSnackbarsRoot\` or \`LayoutSlots.MobileSnackbarsRoot\`): save and built-in action errors are always snackbars
-    - Finalize over the spec's \`finalizeAction\` components, each naming a handler registered with \`phx.frontend.createPhoenixHandler\`: run each with \`phx.frontend.useFinalizeAction(handler)\` in a component of its own wrapped in \`PhoenixHandlerBoundary\` (from \`@salsita-ai/sdk/react\`), or mount \`FinalizeActions\` (from \`@salsita-ai/sdk/configurator\`) for the built-in buttons. \`finalizePage\` and \`finalizeButton\` are legacy
-    - Read mode and fullscreen are the layout's job, no hook enforces them: hide what a viewer must not change while \`phx.frontend.useAccessService().accessInfo.viewMode\` is \`true\`, and remove panels while \`phx.frontend.useIsFullscreenActive()\` is set; \`phx.frontend.useSetFullscreen()\` returns its setter
+    - Your own UI: "Hooks for a Project Layout" in \`docs/phoenix/configurator-interface.mdx\` lists the hooks with what each returns (\`pnpm phoenix docs -r docs/phoenix/configurator-interface.mdx\`), \`docs/phoenix/layout-slots.mdx\` the built-in pieces you can still mount, and \`docs/layouts/custom-layout.mdx\` is a worked example. Call the hooks as \`phx.frontend.useX()\`; besides those below, these are often needed: \`usePreview()\` (\`isPreview\` while the preview start screen shows), \`useCloseAction()\` (the host's close action or \`null\`), \`useActiveViewports()\` (the container's breakpoints, \`null\` until measured, \`desktop\` above 768 px: the desktop/phone switch), \`useResolveLocalizable()\` and \`useLocalizable(text)\` (spec texts to strings), \`useIsCloningAllowed()\` (a read-mode "edit a copy" action with \`LayoutSlots.CloneToEditDialog\`)
+    - Undo and redo: \`phx.frontend.useUndoRedo()\` returns \`{ canUndo, canRedo, undo, redo }\`; disable each button from \`canUndo\`/\`canRedo\`
+    - Tabs: \`phx.frontend.useTabNavigation()\` returns \`{ source, tabs, activeTab, select }\` for the spec's \`sidebarTabs\` (of the selected entity) or \`horizontalTabs\`; render \`tabs\` (each \`{ index, label, icon, state, isActive }\`, \`icon\` a PhxIcon name) and call \`select(tab.index)\` on click. Pass \`{ source: 'sidebarTabs' }\` or \`{ source: 'horizontalTabs' }\` when the layout shows one kind only. Not \`LayoutSlots.useSidebarTabs()\`: it serves the built-in sidebar and returns no tabs while its summary shows
+    - Steps: \`phx.frontend.useStepNavigation()\` returns \`{ steps, activeStep, activeIndex, isFirst, isLast, canGoNext, canGoPrevious, next, previous, goTo }\` for the spec's \`navigationSteps\`; render \`steps\` (each \`{ index, label, state, status }\`, \`status\` \`'complete' | 'active' | 'upcoming'\`), call \`next()\`/\`previous()\` for Back and Next and \`goTo(step.index)\` from a stepper. It enforces no order and no validity: enable only \`'complete'\` steps for an "earlier steps only" stepper, and to block moving on while the configuration has a problem, require \`phx.frontend.useStateValidity().severity !== 'warning'\` besides \`canGoNext\`: a change with a \`fixable\` or \`fatal\` violation is rejected, so the configuration is never invalid, and a \`warning\` is the problem that stays (it blocks finalizing too). \`useSteps\` and \`useHasSteps\` from \`@salsita-ai/sdk/configurator\` are deprecated
+    - Messages: mount \`LayoutSlots.Services\` for the built-in snackbars, or show violations, side-effect hints, errors and failed saves yourself with \`phx.frontend.useConfiguratorMessages(onMessage)\`, not both. A failed save arrives as \`saveError\`, the next successful save as \`saveRecovery\`; a layout that mounts neither shows no sign of a failed save. Either way mount a snackbar root (\`LayoutSlots.DesktopSnackbarsRoot\` or \`LayoutSlots.MobileSnackbarsRoot\`): errors of the built-in actions are always snackbars
+    - Finalize over the spec's \`finalizeAction\` components, each naming a handler registered with \`phx.frontend.createPhoenixHandler\`: \`phx.frontend.useFinalizeActions()\` returns \`{ actions, primary, secondary, disabled, hints }\`; render \`primary\` (and \`secondary\` in a menu or list) in a loop, each action \`{ key, label, title, icon, run, isPending, error, disabled }\`, and call \`action.run()\` on click (its promise never rejects; show \`action.error\` on failure). The configurator runs the handlers itself, outside the layout, so a handler must not rely on a provider the layout adds. For one known handler, \`phx.frontend.useFinalizeAction(handler)\` in a component wrapped in \`PhoenixHandlerBoundary\` (from \`@salsita-ai/sdk/react\`) works too; \`FinalizeActions\` (from \`@salsita-ai/sdk/configurator\`) mounts the built-in buttons. \`finalizePage\` and \`finalizeButton\` are legacy
+    - Read mode and fullscreen are the layout's job, no hook enforces them (\`useUndoRedo\`, \`useFinalizeActions\` and \`useStepNavigation\` included): hide undo, redo, finalization and whatever else a viewer must not change while \`phx.frontend.useAccessService().accessInfo.viewMode\` is \`true\` (tabs are navigation, so a viewer may switch them), and remove panels while \`phx.frontend.useIsFullscreenActive()\` is set; \`phx.frontend.useSetFullscreen()\` returns its setter
+  - \`ConfigurationNotFoundPage\`: \`phx.frontend.createConfigurationNotFoundPage(({ onBack }) => …)\` replaces the "configuration not accessible" page; show a way back only when the optional \`onBack\` is set. The not-authenticated page's default renders it too; only the admin's not-authorized page keeps the built-in page
+  - \`ConfiguratorErrorPage\`: \`phx.frontend.createConfiguratorErrorPage(({ reason, onRetry }) => …)\` replaces the production error page; \`reason\` is \`uncaughtError\` or \`presetCreationFailed\`. A page that throws falls back to the built-in one, and development keeps the detailed error pages, so the project page shows only in a production build. Register both pages with these helpers: \`createCustomPhoenixLayoutElement\` with the name works too, but types the component as taking only \`children\`, so the typed props do not compile there in a strict project
+  - \`AppLoaderContent\`: \`phx.frontend.createAppLoader(({ phases }) => …)\` replaces what the loading overlay shows (each phase \`{ id, label?, progress? }\`, the list possibly empty); Phoenix keeps the overlay itself
 - \`src/handlers/\` — Event & lifecycle handlers
 - \`src/webhooks/\` — Server-side webhook handlers (\`phx.webhooks.*Builder\`)
 - \`src/migrations/\` — Schema version migrations (v*.ts)

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

@@ -22,3 +22,5 @@ export * from './use-domain-application.js';
 export * from './use-web-component.js';
 export * from './use-web-component-readonly-sync.js';
 export * from './data/index.js';
+export * from './loading/index.js';
+export * from './responsive/index.js';

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

@@ -1 +1 @@
-export*from"./use-application-runtime-selector.js";export{AccessServiceProvider,useAccessInfoActions,useAccessService,useAdminRawAccessService,useAdminRawAccessInfo,useConfigurationId,useConfiguratorRawAccessService,useConfiguratorRawAccessInfo,useProvidedAccessService}from"./use-access-service.js";export*from"./use-logger.js";export*from"./use-analytics-service.js";export*from"./use-application-query-client.js";export*from"./use-i18n.js";export*from"./use-spec.js";export*from"./use-environment.js";export*from"./use-overrides.js";export*from"./use-domain-application-props.js";export*from"./use-resource-url.js";export*from"./use-integration.js";export*from"./use-routing.js";export*from"./use-loaded-data.js";export*from"./use-domain-data.js";export*from"./use-session.js";export*from"./use-authorized-client.js";export*from"./use-authenticated-client.js";export*from"./use-phoenix-element-slots.js";export*from"./use-phoenix-handler-slots.js";export*from"./use-domain-application.js";export*from"./use-web-component.js";export*from"./use-web-component-readonly-sync.js";export*from"./data/index.js";
+export*from"./use-application-runtime-selector.js";export{AccessServiceProvider,useAccessInfoActions,useAccessService,useAdminRawAccessService,useAdminRawAccessInfo,useConfigurationId,useConfiguratorRawAccessService,useConfiguratorRawAccessInfo,useProvidedAccessService}from"./use-access-service.js";export*from"./use-logger.js";export*from"./use-analytics-service.js";export*from"./use-application-query-client.js";export*from"./use-i18n.js";export*from"./use-spec.js";export*from"./use-environment.js";export*from"./use-overrides.js";export*from"./use-domain-application-props.js";export*from"./use-resource-url.js";export*from"./use-integration.js";export*from"./use-routing.js";export*from"./use-loaded-data.js";export*from"./use-domain-data.js";export*from"./use-session.js";export*from"./use-authorized-client.js";export*from"./use-authenticated-client.js";export*from"./use-phoenix-element-slots.js";export*from"./use-phoenix-handler-slots.js";export*from"./use-domain-application.js";export*from"./use-web-component.js";export*from"./use-web-component-readonly-sync.js";export*from"./data/index.js";export*from"./loading/index.js";export*from"./responsive/index.js";

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

@@ -0,0 +1,5 @@
+export { LoaderHostContext } from './loader-host-context.js';
+export { useIsAwaitingLoadingPhase } from './use-is-awaiting-loading-phase.js';
+export { useIsLoaderHosted } from './use-is-loader-hosted.js';
+export { useLoadingActions } from './use-loading-actions.js';
+export { useLoadingApplication } from './use-loading-application.js';

package/dist/react-sdk/application-runtime/hooks/loading/index.js

@@ -0,0 +1 @@
+export{LoaderHostContext}from"./loader-host-context.js";export{useIsAwaitingLoadingPhase}from"./use-is-awaiting-loading-phase.js";export{useIsLoaderHosted}from"./use-is-loader-hosted.js";export{useLoadingActions}from"./use-loading-actions.js";export{useLoadingApplication}from"./use-loading-application.js";

package/dist/react-sdk/application-runtime/hooks/loading/loader-host-context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Whether a component is mounted below the application's `LoaderHost`, which provides `true`. It is
+ * `false` everywhere else, as in the admin, which hosts no loader.
+ *
+ * It is a fact about the React tree, so it is a context and not part of the runtime's `loading`
+ * slice. It lives beside the hooks that read it rather than beside `LoaderHost`, because
+ * `loading-state/` imports from this folder and never the other way.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const LoaderHostContext: import("react").Context<boolean>;

package/dist/react-sdk/application-runtime/hooks/loading/loader-host-context.js

@@ -0,0 +1 @@
+import{createContext as o}from"react";export const LoaderHostContext=o(!1);

package/dist/react-sdk/application-runtime/hooks/loading/use-is-awaiting-loading-phase.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether the application this component is mounted in expects the loading phase `id` and that
+ * phase has not started since its loader host mounted. The loader stays up across that gap.
+ * `false` outside a loader host.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const useIsAwaitingLoadingPhase: (id: string) => boolean;

package/dist/react-sdk/application-runtime/hooks/loading/use-is-awaiting-loading-phase.js

@@ -0,0 +1 @@
+import{useCallback as e}from"react";import{useApplicationRuntimeSelector as o}from"../use-application-runtime-selector.js";import{useIsLoaderHosted as t}from"./use-is-loader-hosted.js";import{useLoadingApplication as s}from"./use-loading-application.js";export const useIsAwaitingLoadingPhase=i=>{let r=s(),a=t(),m=o(e(()=>r?.selectors.getIsAwaitingPhase(i)??!1,[r,i]));return a&&m};

package/dist/react-sdk/application-runtime/hooks/loading/use-is-loader-hosted.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether this component is mounted below the application's `LoaderHost`. Without one, the SDK's
+ * own UI shows its inline loaders, as the admin does.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const useIsLoaderHosted: () => boolean;

package/dist/react-sdk/application-runtime/hooks/loading/use-is-loader-hosted.js

@@ -0,0 +1 @@
+import{useContext as o}from"react";import{LoaderHostContext as t}from"./loader-host-context.js";export const useIsLoaderHosted=()=>o(t);

package/dist/react-sdk/application-runtime/hooks/loading/use-loading-actions.d.ts

@@ -0,0 +1,9 @@
+import type { LoadingActions } from '../../loading/index.js';
+/**
+ * The loading actions of the application this component is mounted in, or `null` outside its
+ * loader host, so that nothing reports phases no loader shows. Stable while the host stays mounted.
+ *
+ * @internal Runtime plumbing for the SDK's own UI. A project reports a phase with
+ * `phx.frontend.useLoadingState()`.
+ */
+export declare const useLoadingActions: () => LoadingActions | null;

package/dist/react-sdk/application-runtime/hooks/loading/use-loading-actions.js

@@ -0,0 +1 @@
+import{useIsLoaderHosted as o}from"./use-is-loader-hosted.js";import{useLoadingApplication as s}from"./use-loading-application.js";export const useLoadingActions=()=>{let t=s(),i=o();return null!==t&&i?t.actions:null};

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

@@ -0,0 +1,24 @@
+/**
+ * The selectors and actions of the loading state of the application this component is mounted in,
+ * chosen by its `ApplicationTypeProvider` as the domain context hooks choose theirs. `null` outside
+ * an `ApplicationRuntimeProvider` or an `ApplicationTypeProvider`: the session and data providers also run in trees without one, where
+ * no loader is hosted.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const useLoadingApplication: () => {
+    selectors: {
+        selectLoadingState: import("@salsita-ai/common/utils").Selector<import("../../loading/selectors.js").LoadingSelectorState, import("../../index.js").LoadingState>;
+        getLoadingState: () => import("../../index.js").LoadingState;
+        getIsAwaitingPhase: (id: string) => boolean;
+    };
+    actions: {
+        startPhase: (phase: import("../../index.js").LoadingPhase) => void;
+        endPhase: (id: string) => void;
+        reportError: () => void;
+        clearError: () => void;
+        expectPhase: (id: string) => void;
+        dropExpectation: (id: string) => void;
+        resetSlot: () => void;
+    };
+} | null;

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

@@ -0,0 +1 @@
+import{useMemo as o}from"react";import{useOptionalApplicationRuntime as i,useOptionalApplicationType as n}from"../../provider/index.js";import{ApplicationType as r}from"../../runtime/index.js";export const useLoadingApplication=()=>{let t=i(),e=n();return o(()=>null===t||null===e?null:e===r.Admin?{selectors:t.selectors.loading.admin,actions:t.actions.loading.admin}:{selectors:t.selectors.loading.configurator,actions:t.actions.loading.configurator},[t,e])};

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

@@ -0,0 +1,3 @@
+export { useResponsiveActions } from './use-responsive-actions.js';
+export { useResponsiveState } from './use-responsive-state.js';
+export { type ResponsiveStore, useResponsiveStore } from './use-responsive-store.js';

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

@@ -0,0 +1 @@
+export{useResponsiveActions}from"./use-responsive-actions.js";export{useResponsiveState}from"./use-responsive-state.js";export{useResponsiveStore}from"./use-responsive-store.js";

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

@@ -0,0 +1,9 @@
+import type { ResponsiveActions } from '../../responsive/index.js';
+/**
+ * The actions of the responsive state of the application this component is mounted in: set the canvas padding, expand, collapse, hide or
+ * show the root container. 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 useResponsiveActions: () => ResponsiveActions;

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

@@ -0,0 +1 @@
+import{useResponsiveApplication as e}from"./use-responsive-application.js";export const useResponsiveActions=()=>{let{actions:s}=e();return s};

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

@@ -0,0 +1,26 @@
+/**
+ * The selectors and actions of the responsive state of the application this component is mounted
+ * in, chosen by its `ApplicationTypeProvider` as the domain context hooks choose theirs.
+ */
+export declare const useResponsiveApplication: () => {
+    runtime: import("../../index.js").ApplicationRuntime;
+    selectors: {
+        selectResponsiveState: import("@salsita-ai/common/utils").Selector<import("../../responsive/selectors.js").ResponsiveSelectorState, import("../../index.js").ResponsiveState>;
+        selectViewportSize: import("@salsita-ai/common/utils").Selector<import("../../responsive/selectors.js").ResponsiveSelectorState, import("../../index.js").ResponsiveViewportSize>;
+        selectCanvasPadding: import("@salsita-ai/common/utils").Selector<import("../../responsive/selectors.js").ResponsiveSelectorState, import("../../index.js").CanvasPadding>;
+        getResponsiveState: () => import("../../index.js").ResponsiveState;
+        getViewportSize: () => import("../../index.js").ResponsiveViewportSize;
+        getCanvasPadding: () => import("../../index.js").CanvasPadding;
+    };
+    actions: {
+        setViewport: (viewport: import("../../index.js").ResponsiveViewport) => void;
+        setBreakpoints: (breakpoints: import("../../index.js").ResponsiveBreakpoints) => void;
+        setCanvasPadding: (canvasPadding: import("../../index.js").CanvasPadding) => void;
+        expand: () => void;
+        collapse: () => void;
+        hide: () => void;
+        show: () => void;
+        setAnimating: (isAnimating: boolean) => void;
+        reset: () => void;
+    };
+};

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

@@ -0,0 +1 @@
+import{useApplicationRuntime as e,useApplicationType as s}from"../../provider/index.js";import{ApplicationType as o}from"../../runtime/index.js";export const useResponsiveApplication=()=>{let i=e();return s()===o.Admin?{runtime:i,selectors:i.selectors.responsive.admin,actions:i.actions.responsive.admin}:{runtime:i,selectors:i.selectors.responsive.configurator,actions:i.actions.responsive.configurator}};

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

@@ -0,0 +1,10 @@
+import type { ResponsiveState } from '../../responsive/index.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, not on a resize within one size class.
+ *
+ * @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 useResponsiveState: () => ResponsiveState;

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

@@ -0,0 +1 @@
+import{useApplicationRuntimeSelector as e}from"../use-application-runtime-selector.js";import{useResponsiveApplication as t}from"./use-responsive-application.js";export const useResponsiveState=()=>{let{selectors:s}=t();return e(s.getResponsiveState)};

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,8 @@ 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 LoadingActions, type LoadingApplicationState, type LoadingPhase, type LoadingRuntimeState, type LoadingState, } from './loading/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/loading/actions.d.ts

@@ -0,0 +1,45 @@
+import type { DomainApplicationType } from '#package/domain';
+import type { LoadingPhase, LoadingRuntimeState } from './types.js';
+interface Context {
+    readonly setLoading: (fn: (state: LoadingRuntimeState) => LoadingRuntimeState) => 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) => {
+    startPhase: (phase: LoadingPhase) => void;
+    endPhase: (id: string) => void;
+    reportError: () => void;
+    clearError: () => void;
+    expectPhase: (id: string) => void;
+    dropExpectation: (id: string) => void;
+    resetSlot: () => void;
+};
+/** One set of actions per application, as the domain context keys its own. */
+export declare const createLoadingActions: (context: Context) => {
+    configurator: {
+        startPhase: (phase: LoadingPhase) => void;
+        endPhase: (id: string) => void;
+        reportError: () => void;
+        clearError: () => void;
+        expectPhase: (id: string) => void;
+        dropExpectation: (id: string) => void;
+        resetSlot: () => void;
+    };
+    admin: {
+        startPhase: (phase: LoadingPhase) => void;
+        endPhase: (id: string) => void;
+        reportError: () => void;
+        clearError: () => void;
+        expectPhase: (id: string) => void;
+        dropExpectation: (id: string) => void;
+        resetSlot: () => void;
+    };
+};
+/**
+ * @internal Runtime plumbing for the SDK's own UI. A project reports a phase with
+ * `phx.frontend.useLoadingState()`.
+ */
+export type LoadingActions = ReturnType<typeof createApplicationActions>;
+export {};

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

@@ -0,0 +1 @@
+import{initializeLoadingApplication as e}from"./initialize.js";let t=(e,t)=>e.has(t)?e:new Set([...e,t]),s=(s,r)=>{let a=e=>{s.setLoading(t=>{let s=t[r],a=e(s);return a===s?t:{...t,[r]:a}})},n=e=>{a(t=>t.hasError===e?t:{...t,hasError:e})};return{startPhase:e=>{a(s=>{let r=((e,t)=>{let s=e.findIndex(e=>e.id===t.id);if(-1===s)return[...e,t];let r=e[s];return void 0!==r&&r.id===t.id&&r.progress===t.progress&&r.label===t.label?e:e.map(e=>e.id===t.id?t:e)})(s.phases,e),a=t(s.seenPhaseIds,e.id);return r===s.phases&&a===s.seenPhaseIds?s:{...s,phases:r,seenPhaseIds:a}})},endPhase:e=>{a(t=>t.phases.some(t=>t.id===e)?{...t,phases:t.phases.filter(t=>t.id!==e)}:t)},reportError:()=>{n(!0)},clearError:()=>{n(!1)},expectPhase:e=>{a(s=>{let r=s.expectationCounts.get(e)??0,a=new Map(s.expectationCounts).set(e,r+1);return{...s,expectationCounts:a,expectedPhaseIds:t(s.expectedPhaseIds,e)}})},dropExpectation:e=>{a(t=>{let s=t.expectationCounts.get(e);if(void 0===s)return t;let r=new Map(t.expectationCounts);return s>1?(r.set(e,s-1),{...t,expectationCounts:r}):(r.delete(e),{...t,expectationCounts:r,expectedPhaseIds:((e,t)=>{if(!e.has(t))return e;let s=new Set(e);return s.delete(t),s})(t.expectedPhaseIds,e)})})},resetSlot:()=>{a(t=>0!==t.phases.length||t.hasError||0!==t.expectedPhaseIds.size||0!==t.seenPhaseIds.size?e():t)}}};export const createLoadingActions=e=>({configurator:s(e,"configurator"),admin:s(e,"admin")});

package/dist/react-sdk/application-runtime/loading/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/loading/index.js

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

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

@@ -0,0 +1,3 @@
+import type { LoadingApplicationState, LoadingRuntimeState } from './types.js';
+export declare const initializeLoadingApplication: () => LoadingApplicationState;
+export declare const initializeLoading: () => LoadingRuntimeState;

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

@@ -0,0 +1 @@
+export const initializeLoadingApplication=()=>({phases:[],hasError:!1,expectedPhaseIds:new Set,expectationCounts:new Map,seenPhaseIds:new Set});export const initializeLoading=()=>({configurator:initializeLoadingApplication(),admin:initializeLoadingApplication()});

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

@@ -0,0 +1,18 @@
+import type { DomainApplicationType } from '#package/domain';
+import type { LoadingRuntimeState, LoadingState } from './types.js';
+export interface LoadingSelectorState {
+    readonly loading: LoadingRuntimeState;
+}
+interface Context {
+    readonly getState: () => LoadingSelectorState;
+    readonly applicationType: DomainApplicationType;
+}
+/** The selectors of one application's loading state; the runtime creates one set per application. */
+export declare const createLoadingSelectors: (context: Context) => {
+    selectLoadingState: import("@salsita-ai/common/utils").Selector<LoadingSelectorState, LoadingState>;
+    getLoadingState: () => LoadingState;
+    /** Whether the phase `id` is expected and has not started since the last reset. */
+    getIsAwaitingPhase: (id: string) => boolean;
+};
+export type LoadingSelectors = ReturnType<typeof createLoadingSelectors>;
+export {};

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

@@ -0,0 +1 @@
+import{createSelector as e}from"@salsita-ai/common/utils";export const createLoadingSelectors=a=>{let{getState:s,applicationType:t}=a,i=e.withTypes(),o=i.leaf(e=>e.loading[t].phases),l=i.leaf(e=>e.loading[t].hasError),n=i.leaf(e=>e.loading[t].expectedPhaseIds),r=i.leaf(e=>e.loading[t].seenPhaseIds),g=i([o,l,n],(e,a,s)=>({isLoading:e.length>0,hasError:a,phases:e,expectedPhaseIds:s}));return{selectLoadingState:g,getLoadingState:()=>g(s()),getIsAwaitingPhase:e=>{let a=s();return n(a).has(e)&&!r(a).has(e)}}};

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

@@ -0,0 +1,59 @@
+/**
+ * One step of an application's load that the loader shows while it runs: authenticating the
+ * session, fetching data, loading the 3D scene, or a step a project reports itself.
+ */
+export interface LoadingPhase {
+    readonly id: string;
+    /** From 0 to 1, when the step can tell how far it is. */
+    readonly progress?: number;
+    readonly label?: string;
+}
+/**
+ * The aggregated loading state the loader renders: the running phases in the order they started,
+ * and whether the load failed.
+ */
+export interface LoadingState {
+    /** `true` while at least one phase runs. */
+    readonly isLoading: boolean;
+    readonly hasError: boolean;
+    readonly phases: readonly LoadingPhase[];
+    /** The phases the loader waits for before they start, so it does not flash off in between. */
+    readonly expectedPhaseIds: ReadonlySet<string>;
+}
+/**
+ * The loading state of one application.
+ *
+ * The loader host resets it when it mounts, which happens when the configurator is powered on or
+ * remounted; phases written before that are not shown. Whether a component is below the loader
+ * host is not part of it: that is a fact about the React tree, read with `useIsLoaderHosted()`.
+ *
+ * @internal Runtime plumbing for the SDK's own UI. A project reads the loading state with
+ * `phx.frontend.useLoadingStateValue()` and reports a phase with `phx.frontend.useLoadingState()`.
+ */
+export interface LoadingApplicationState {
+    /** The running phases, in the order they started. Restarting a phase keeps its position. */
+    readonly phases: readonly LoadingPhase[];
+    readonly hasError: boolean;
+    readonly expectedPhaseIds: ReadonlySet<string>;
+    /**
+     * How many callers expect each phase of `expectedPhaseIds`: the components that mount the canvas
+     * nest, and an inner one unmounting must not drop the phase an outer one still expects.
+     */
+    readonly expectationCounts: ReadonlyMap<string, number>;
+    /**
+     * Every phase that started since the last reset. An expected phase that was seen once is no
+     * longer waited for, so a second configuration does not wait for the scene again.
+     */
+    readonly seenPhaseIds: ReadonlySet<string>;
+}
+/**
+ * The `loading` slice, one entry per application: an admin that embeds a configurator runs both in
+ * one runtime, and only the configurator hosts a loader.
+ *
+ * @internal Runtime plumbing for the SDK's own UI. A project reads the loading state with
+ * `phx.frontend.useLoadingStateValue()` and reports a phase with `phx.frontend.useLoadingState()`.
+ */
+export interface LoadingRuntimeState {
+    readonly configurator: LoadingApplicationState;
+    readonly admin: LoadingApplicationState;
+}

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

package/dist/react-sdk/application-runtime/provider/ApplicationRuntime.d.ts

@@ -5,5 +5,11 @@ interface ApplicationRuntimeProviderProps {
     readonly runtime: ApplicationRuntime;
 }
 export declare const ApplicationRuntimeProvider: (props: ApplicationRuntimeProviderProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * The runtime, or `null` outside an `ApplicationRuntimeProvider`, for hooks that must work without one.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const useOptionalApplicationRuntime: () => ApplicationRuntime | null;
 export declare const useApplicationRuntime: () => ApplicationRuntime;
 export {};

package/dist/react-sdk/application-runtime/provider/ApplicationRuntime.js

@@ -1 +1 @@
-import{jsx as t}from"react/jsx-runtime";import{createContext as e,useContext as i}from"react";let r=e(null);export const ApplicationRuntimeProvider=e=>{let{children:i,runtime:o}=e;return t(r.Provider,{value:o,children:i})};export const useApplicationRuntime=()=>{let t=i(r);if(!t)throw Error("ApplicationRuntime context not found! useApplicationRuntime() must be used within an ApplicationRuntimeProvider. Use the hook appropriately.");return t};
+import{jsx as t}from"react/jsx-runtime";import{createContext as e,useContext as i}from"react";let o=e(null);export const ApplicationRuntimeProvider=e=>{let{children:i,runtime:r}=e;return t(o.Provider,{value:r,children:i})};export const useOptionalApplicationRuntime=()=>i(o);export const useApplicationRuntime=()=>{let t=i(o);if(!t)throw Error("ApplicationRuntime context not found! useApplicationRuntime() must be used within an ApplicationRuntimeProvider. Use the hook appropriately.");return t};

package/dist/react-sdk/application-runtime/provider/ApplicationType.d.ts

@@ -6,4 +6,11 @@ interface ApplicationTypeProviderProps {
 }
 export declare const ApplicationTypeProvider: (props: ApplicationTypeProviderProps) => import("react/jsx-runtime").JSX.Element;
 export declare const useApplicationType: () => ApplicationType;
+/**
+ * The application type of the nearest `ApplicationTypeProvider`, or `null` outside one, for the
+ * hooks that some application-agnostic providers call and that have nothing to do there.
+ *
+ * @internal Runtime plumbing for the SDK's own UI.
+ */
+export declare const useOptionalApplicationType: () => ApplicationType | null;
 export {};