@salsita-ai/sdk 0.50.0-develop.6d8967bc99 → 0.50.0-develop.6fc83d7732

package/dist/phoenix/utils/package-info.js

@@ -1 +1 @@
-import{existsSync as e,lstatSync as t,readFileSync as r,readdirSync as s,writeFileSync as o}from"fs";import{dirname as a,join as i,resolve as l}from"path";import{isMap as n,isScalar as c,isSeq as d,parse as p,parseDocument as m}from"yaml";let u="pnpm-workspace.yaml",f="@salsita-ai/";export const readPackageJson=(t=".")=>{let s=l(t,"package.json");if(!e(s))throw Error(`package.json not found at ${s}`);return JSON.parse(r(s,"utf8"))};let g=(t=process.cwd())=>{let r=l(t);for(;;){let t=i(r,u);if(e(t))return t;let s=a(r);if(s===r)return;r=s}},k=()=>g()??i(process.cwd(),u),h=()=>{try{let e=g();if(!e)return{};let t=p(r(e,"utf8"));return t?.overrides??{}}catch{return{}}};export const getWorkspaceDir=()=>a(k());export const addWorkspaceOverrides=t=>{let s=k(),a=m(e(s)?r(s,"utf8"):"");Object.entries(t).forEach(([e,t])=>{a.setIn(["overrides",e],t)}),a.setIn(["optimisticRepeatInstall"],!1),o(s,a.toString())};export const removeWorkspaceOverrides=e=>{let t=g();if(!t)return;let s=m(r(t,"utf8"));e.forEach(e=>{s.deleteIn(["overrides",e])});let a=s.getIn(["overrides"]);n(a)&&0===a.items.length&&s.delete("overrides"),s.delete("optimisticRepeatInstall"),o(t,s.toString())};let x={"@swc/core":!0,esbuild:!0,"es5-ext":!1},y=`${f}*`;export const ensureWorkspaceInstallSettings=t=>{let s=i(t,u);if(!e(s)&&g(t))return;let a=e(s)?r(s,"utf8"):"",l=m(a);n(l.get("allowBuilds"))||l.set("allowBuilds",l.createNode({})),Object.entries(x).forEach(([e,t])=>{"boolean"!=typeof l.getIn(["allowBuilds",e])&&l.setIn(["allowBuilds",e],t)});let p=l.getIn(["minimumReleaseAgeExclude"]);d(p)?p.items.some(e=>c(e)&&e.value===y)||p.add(y):l.setIn(["minimumReleaseAgeExclude"],l.createNode([y]));let f=l.toString();f!==a&&o(s,f)};export const hasLocalOverrides=()=>Object.keys(h()).some(e=>e.startsWith(f));export const getLocalOverrides=()=>Object.keys(h()).filter(e=>e.startsWith(f));let v=["@salsita-ai/common","@salsita-ai/contracts","@salsita-ai/sdk"];export const hasLocalSymlinks=()=>v.some(e=>{let r=l("node_modules",e);try{return t(r).isSymbolicLink()}catch{return!1}});export const isUsingLocalSdk=()=>hasLocalOverrides()||hasLocalSymlinks();export const getSdkPackages=t=>{let r=l(t,"packages/libs");if(!e(r))throw Error(`SDK libs directory not found at ${r}`);return s(r,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(e=>{let t=i(r,e),s=readPackageJson(t);if(!s.name)throw Error(`Package at ${t} has no name in package.json`);return{name:s.name,path:t}})};
+import{existsSync as e,lstatSync as t,readFileSync as r,readdirSync as s,writeFileSync as o}from"fs";import{dirname as a,join as i,resolve as n}from"path";import{isMap as c,parse as l,parseDocument as p}from"yaml";let m="pnpm-workspace.yaml",d="@salsita-ai/";export const readPackageJson=(t=".")=>{let s=n(t,"package.json");if(!e(s))throw Error(`package.json not found at ${s}`);return JSON.parse(r(s,"utf8"))};let f=(t=process.cwd())=>{let r=n(t);for(;;){let t=i(r,m);if(e(t))return t;let s=a(r);if(s===r)return;r=s}},k=()=>f()??i(process.cwd(),m),h=()=>{try{let e=f();if(!e)return{};let t=l(r(e,"utf8"));return t?.overrides??{}}catch{return{}}};export const getWorkspaceDir=()=>a(k());export const addWorkspaceOverrides=t=>{let s=k(),a=p(e(s)?r(s,"utf8"):"");Object.entries(t).forEach(([e,t])=>{a.setIn(["overrides",e],t)}),a.setIn(["optimisticRepeatInstall"],!1),o(s,a.toString())};export const removeWorkspaceOverrides=e=>{let t=f();if(!t)return;let s=p(r(t,"utf8"));e.forEach(e=>{s.deleteIn(["overrides",e])});let a=s.getIn(["overrides"]);c(a)&&0===a.items.length&&s.delete("overrides"),s.delete("optimisticRepeatInstall"),o(t,s.toString())};export const hasLocalOverrides=()=>Object.keys(h()).some(e=>e.startsWith(d));export const getLocalOverrides=()=>Object.keys(h()).filter(e=>e.startsWith(d));let u=["@salsita-ai/common","@salsita-ai/contracts","@salsita-ai/sdk"];export const hasLocalSymlinks=()=>u.some(e=>{let r=n("node_modules",e);try{return t(r).isSymbolicLink()}catch{return!1}});export const isUsingLocalSdk=()=>hasLocalOverrides()||hasLocalSymlinks();export const getSdkPackages=t=>{let r=n(t,"packages/libs");if(!e(r))throw Error(`SDK libs directory not found at ${r}`);return s(r,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(e=>{let t=i(r,e),s=readPackageJson(t);if(!s.name)throw Error(`Package at ${t} has no name in package.json`);return{name:s.name,path:t}})};

package/dist/phoenix/utils/package-manager/index.d.ts

@@ -0,0 +1,2 @@
+export { type PackageManagerCommands, findPackageManagerCommands } from './package-manager-commands.js';
+export { assertPnpmProject } from './pnpm-project.js';

package/dist/phoenix/utils/package-manager/index.js

@@ -0,0 +1 @@
+export{findPackageManagerCommands}from"./package-manager-commands.js";export{assertPnpmProject}from"./pnpm-project.js";

package/dist/phoenix/utils/package-manager/package-manager-commands.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The commands of a package manager the CLI names in the next steps it prints, so a developer can copy the one for
+ * the package manager they use. Phoenix works with any package manager; these only phrase the hints.
+ */
+export interface PackageManagerCommands {
+    /** Installs the project's dependencies, such as `npm install`. */
+    readonly install: string;
+    /** Adds a package to the project's dependencies, such as `npm install @salsita-ai/sdk`. */
+    readonly add: (packageName: string) => string;
+    /** Runs a `phoenix` command from the project's install, such as `npx phoenix sync`. */
+    readonly phoenix: (args: string) => string;
+}
+/**
+ * The commands of the package manager that started the CLI, read from the `npm_config_user_agent` value npm, pnpm,
+ * Yarn and Bun set for the binaries they run (`pnpm/11.1.3 npm/? node/v22.13.0 linux x64`). `undefined` when the CLI
+ * was started some other way, such as straight from `node_modules/.bin`, or by a package manager it does not know;
+ * the hint then names no package manager.
+ */
+export declare const findPackageManagerCommands: (userAgent: string | undefined) => PackageManagerCommands | undefined;

package/dist/phoenix/utils/package-manager/package-manager-commands.js

@@ -0,0 +1 @@
+let n=new Map([["pnpm",{install:"pnpm install",add:n=>`pnpm add ${n}`,phoenix:n=>`pnpm phoenix ${n}`}],["npm",{install:"npm install",add:n=>`npm install ${n}`,phoenix:n=>`npx phoenix ${n}`}],["yarn",{install:"yarn install",add:n=>`yarn add ${n}`,phoenix:n=>`yarn phoenix ${n}`}],["bun",{install:"bun install",add:n=>`bun add ${n}`,phoenix:n=>`bunx phoenix ${n}`}]]);export const findPackageManagerCommands=a=>{let p=a?.split("/")[0]?.trim();return void 0===p?void 0:n.get(p)};

package/dist/phoenix/utils/package-manager/pnpm-project.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stops a pnpm-only command in a project that clearly installs with another package manager: one with another
+ * package manager's lockfile and no `pnpm-lock.yaml`. A project without any lockfile is let through, as it has not
+ * installed yet. Only the project folder is looked at.
+ */
+export declare const assertPnpmProject: (props: {
+    readonly projectRoot: string;
+    readonly command: string;
+}) => void;

package/dist/phoenix/utils/package-manager/pnpm-project.js

@@ -0,0 +1 @@
+import{existsSync as o}from"fs";import{join as t}from"path";let n=["package-lock.json","npm-shrinkwrap.json","yarn.lock","bun.lock","bun.lockb"];export const assertPnpmProject=r=>{if(o(t(r.projectRoot,"pnpm-lock.yaml")))return;let a=n.find(n=>o(t(r.projectRoot,n)));if(void 0!==a)throw Error(`phoenix ${r.command} works with pnpm only, and this project installs with another package manager: it has ${a} and no pnpm-lock.yaml. It is an internal tool for linking a local SDK checkout through the overrides in pnpm-workspace.yaml. Use it in a project that installs with pnpm.`)};

package/dist/phoenix/utils/run-command.d.ts

@@ -1,4 +1,5 @@
 import type { Logger } from './logger.js';
+import { type SdkTool } from './sdk-tool/index.js';
 export interface RunCommandProps {
     readonly command: string;
     readonly args: readonly string[];
@@ -7,6 +8,16 @@ export interface RunCommandProps {
     readonly cwd?: string;
     readonly extraEnv?: Record<string, string>;
 }
+export interface RunSdkToolProps extends Omit<RunCommandProps, 'command'> {
+    readonly tool: SdkTool;
+}
 export declare const runCommand: (props: RunCommandProps, context?: {
     readonly logger: Logger;
 }) => Promise<void>;
+/**
+ * Runs a tool from the SDK's own installation with the Node.js that runs the CLI. It starts no shell, so paths
+ * with spaces reach the tool unchanged.
+ */
+export declare const runSdkTool: (props: RunSdkToolProps, context?: {
+    readonly logger: Logger;
+}) => Promise<void>;

package/dist/phoenix/utils/run-command.js

@@ -1 +1 @@
-import{spawn as e}from"node:child_process";import{createLogger as r}from"./logger.js";export const runCommand=async(o,t)=>{let n=t?.logger??r(),{command:s,args:i,description:a,quiet:l=!1,cwd:c,extraEnv:d}=o;l?n.isDebug&&n.debug(`Running: ${s} ${i.join(" ")}`):n.step(a);let u=n.isDebug?"inherit":l?"pipe":"inherit";await new Promise((r,o)=>{let t=e(s,i,{stdio:u,shell:!0,cwd:c,env:d?{...process.env,...d}:void 0}),l=[],f=[],m=!1;t.stdout?.on("data",e=>l.push(Buffer.from(e))),t.stderr?.on("data",e=>f.push(Buffer.from(e))),t.once("error",e=>{m=!0,n.error(`${a} failed to execute`),n.error(`Error: ${e.message}`),o(Error(`Failed to execute command '${s}': ${e.message}. Ensure the command is installed and available in PATH.`))}),t.once("close",(e,t)=>{if(!m){if(0!==e){let r=null!==e?`exit code ${e}`:"unknown error (process was terminated or failed to start)";n.error(`${a} failed with ${r}`),t&&n.error(`Process was killed with signal: ${t}`),l.length>0&&console.error(Buffer.concat(l).toString()),f.length>0&&console.error(Buffer.concat(f).toString()),o(Error(`${a} failed with ${r}`));return}r()}})}),(!l||n.isDebug)&&n.success(`${a} completed`)};
+import{spawn as e}from"node:child_process";import{createLogger as r}from"./logger.js";import{resolveSdkToolBin as o}from"./sdk-tool/index.js";let t=async(o,t)=>{let s=t?.logger??r(),{command:n,file:i,shell:a,startFailureHint:l,args:c,description:d,quiet:m=!1,cwd:u,extraEnv:f}=o;m?s.isDebug&&s.debug(`Running: ${n} ${c.join(" ")}`):s.step(d);let g=s.isDebug?"inherit":m?"pipe":"inherit";await new Promise((r,o)=>{let t=e(i,c,{stdio:g,shell:a,cwd:u,env:f?{...process.env,...f}:void 0}),m=[],p=[],h=!1;t.stdout?.on("data",e=>m.push(Buffer.from(e))),t.stderr?.on("data",e=>p.push(Buffer.from(e))),t.once("error",e=>{h=!0,s.error(`${d} failed to execute`),s.error(`Error: ${e.message}`),o(Error(`Failed to execute command '${n}': ${e.message}. ${l}`))}),t.once("close",(e,t)=>{if(!h){if(0!==e){let r=null!==e?`exit code ${e}`:"unknown error (process was terminated or failed to start)";s.error(`${d} failed with ${r}`),t&&s.error(`Process was killed with signal: ${t}`),m.length>0&&console.error(Buffer.concat(m).toString()),p.length>0&&console.error(Buffer.concat(p).toString()),o(Error(`${d} failed with ${r}`));return}r()}})}),(!m||s.isDebug)&&s.success(`${d} completed`)};export const runCommand=async(e,r)=>{await t({...e,file:e.command,shell:!0,startFailureHint:"Ensure the command is installed and available in PATH."},r)};export const runSdkTool=async(e,r)=>{let{tool:s,args:n,...i}=e;await t({...i,command:s.binName,file:process.execPath,args:[o(s),...n],shell:!1,startFailureHint:"Ensure Node.js can start this process."},r)};

package/dist/phoenix/utils/sdk-tool/index.d.ts

@@ -0,0 +1 @@
+export { type SdkTool, resolveSdkToolBin } from './resolve-sdk-tool-bin.js';

package/dist/phoenix/utils/sdk-tool/index.js

@@ -0,0 +1 @@
+export{resolveSdkToolBin}from"./resolve-sdk-tool-bin.js";

package/dist/phoenix/utils/sdk-tool/resolve-sdk-tool-bin.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A command-line tool the CLI runs, such as `tsc` for `phoenix check`. The SDK installs every such tool as one of
+ * its own `dependencies` and runs that copy, so the versions a project installs do not decide them.
+ */
+export interface SdkTool {
+    /** The name the SDK's `package.json` lists the package under, the alias where the SDK installs it under one */
+    readonly packageName: string;
+    /** The name of the binary in the package's `bin` field */
+    readonly binName: string;
+}
+/**
+ * Returns the absolute path of a tool's binary in the SDK's own installation. It never looks at `PATH` or the
+ * project's `node_modules`, so the CLI runs the same tool in every project.
+ */
+export declare const resolveSdkToolBin: (tool: SdkTool) => string;

package/dist/phoenix/utils/sdk-tool/resolve-sdk-tool-bin.js

@@ -0,0 +1 @@
+import{existsSync as e,readFileSync as o}from"node:fs";import{createRequire as t}from"node:module";import{join as n,resolve as i}from"node:path";import{z as a}from"zod";let r=a.object({name:a.string(),bin:a.union([a.string(),a.record(a.string())]).optional()}),s=t(import.meta.url);export const resolveSdkToolBin=t=>{var a,p;let d=(o=>{let t=(s.resolve.paths(o)??[]).map(e=>n(e,o)).find(o=>e(n(o,"package.json")));if(void 0===t)throw Error(`Cannot find the package '${o}' in the installation of @salsita-ai/sdk. The SDK runs its own copy of it, so it is one of the SDK's dependencies. Reinstall the project's dependencies.`);return t})(t.packageName),l=(a=r.parse(JSON.parse(o(n(d,"package.json"),"utf-8"))),p=t.binName,"string"==typeof a.bin?a.name.replace(/^@[^/]+\//,"")===p?a.bin:void 0:a.bin?.[p]);if(void 0===l)throw Error(`The package '${t.packageName}' in the installation of @salsita-ai/sdk has no binary '${t.binName}'. The SDK expects it there to run it. Reinstall the project's dependencies.`);return i(d,l)};

package/dist/react-sdk/application-runtime/common-services/analytics/analytics-service.d.ts

@@ -17,5 +17,5 @@ export declare const CommonAnalyticsFactory: {
     Initialized: typeof Initialized;
     ConfigurationLoaded: typeof ConfigurationLoaded;
 };
-export declare const initializeAnalyticsService: (config: AnyApplicationConfig, logger: Logger, isDev: boolean) => AnalyticsSystem;
+export declare const initializeAnalyticsService: (config: Pick<AnyApplicationConfig, 'services' | 'defaultEnvs'>, logger: Logger, isDev: boolean) => AnalyticsSystem;
 export {};

package/dist/react-sdk/application-runtime/common-services/analytics/frontend-analytics.d.ts

@@ -0,0 +1,52 @@
+import { type EntityId } from '#package/domain';
+declare const CloseConfiguratorClicked: () => import("#package/domain").UserActionEvent;
+declare const PreviousStepButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const NextStepButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const FinalizeButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const SummaryButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const TopNavigationStepClicked: (step: string) => import("#package/domain").UserActionEvent;
+declare const HorizontalTabClicked: (tab: string) => import("#package/domain").UserActionEvent;
+declare const GoToProductsClicked: () => import("#package/domain").UserActionEvent;
+declare const ExpandedViewClosed: () => import("#package/domain").UserActionEvent;
+declare const ProductSelected: (productType: string, productName: string) => import("#package/domain").UserActionEvent;
+declare const SelectionHotspotClicked: (id: string) => import("#package/domain").UserActionEvent;
+declare const AssistantEntityLinkClicked: (id: string) => import("#package/domain").UserActionEvent;
+declare const RedoButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const UndoButtonClicked: () => import("#package/domain").UserActionEvent;
+declare const GlobalDimensionsButtonClicked: (dimensionUnit: string) => import("#package/domain").UserActionEvent;
+declare const MeasurementsMenuToggled: () => import("#package/domain").UserActionEvent;
+declare const MeasurementsMenuClosed: () => import("#package/domain").UserActionEvent;
+declare const DimensionIndicatorsToggled: () => import("#package/domain").UserActionEvent;
+declare const FullScreenModeToggled: () => import("#package/domain").UserActionEvent;
+declare const HelpDialogOpened: () => import("#package/domain").UserActionEvent;
+declare const HelpDialogClosed: () => import("#package/domain").UserActionEvent;
+declare const EntityDeleteHotspotClicked: (id: EntityId) => import("#package/domain").UserActionEvent;
+export declare const FrontendAnalyticsFactory: {
+    CloseConfiguratorClicked: typeof CloseConfiguratorClicked;
+    PreviousStepButtonClicked: typeof PreviousStepButtonClicked;
+    NextStepButtonClicked: typeof NextStepButtonClicked;
+    FinalizeButtonClicked: typeof FinalizeButtonClicked;
+    SummaryButtonClicked: typeof SummaryButtonClicked;
+    TopNavigationStepClicked: typeof TopNavigationStepClicked;
+    /**
+     * @deprecated The SDK never pushes this event: a click on a horizontal tab pushes `TopNavigationStepClicked`.
+     * Use `TopNavigationStepClicked` instead. This API will be removed in the breaking release before v1.
+     */
+    HorizontalTabClicked: typeof HorizontalTabClicked;
+    GoToProductsClicked: typeof GoToProductsClicked;
+    ProductSelected: typeof ProductSelected;
+    SelectionHotspotClicked: typeof SelectionHotspotClicked;
+    AssistantEntityLinkClicked: typeof AssistantEntityLinkClicked;
+    RedoButtonClicked: typeof RedoButtonClicked;
+    UndoButtonClicked: typeof UndoButtonClicked;
+    GlobalDimensionsButtonClicked: typeof GlobalDimensionsButtonClicked;
+    MeasurementsMenuToggled: typeof MeasurementsMenuToggled;
+    MeasurementsMenuClosed: typeof MeasurementsMenuClosed;
+    DimensionIndicatorsToggled: typeof DimensionIndicatorsToggled;
+    FullScreenModeToggled: typeof FullScreenModeToggled;
+    HelpDialogOpened: typeof HelpDialogOpened;
+    HelpDialogClosed: typeof HelpDialogClosed;
+    EntityDeleteHotspotClicked: typeof EntityDeleteHotspotClicked;
+    ExpandedViewClosed: typeof ExpandedViewClosed;
+};
+export {};

package/dist/react-sdk/application-runtime/common-services/analytics/frontend-analytics.js

@@ -0,0 +1 @@
+import{AnalyticsEventFactory as e,domainEntityTypeFromId as t,isVirtualEntityId as o}from"#package/domain";export const FrontendAnalyticsFactory={CloseConfiguratorClicked:()=>e.UserActionEvent({section:"topNavigation",element:"button",action:"click",result:"User requested to close the configurator."}),PreviousStepButtonClicked:()=>e.UserActionEvent({section:"sidebar",element:"previousStepButton",action:"click",result:"User clicked on previous step button."}),NextStepButtonClicked:()=>e.UserActionEvent({section:"sidebar",element:"nextStepButton",action:"click",result:"User clicked on next step button."}),FinalizeButtonClicked:()=>e.UserActionEvent({section:"sidebar",element:"finalizeButton",action:"click",result:"User clicked on finalize button."}),SummaryButtonClicked:()=>e.UserActionEvent({section:"sidebar",element:"summaryButton",action:"click",result:"User clicked go to summary button."}),TopNavigationStepClicked:t=>e.UserActionEvent({section:"topNavigation",element:"step",action:"click",result:"User clicked on top navigation step.",data:{step:t}}),HorizontalTabClicked:t=>e.UserActionEvent({section:"topNavigation",element:"horizontalTab",action:"click",result:"User clicked on horizontal tab.",data:{tab:t}}),GoToProductsClicked:()=>e.UserActionEvent({section:"topNavigation",element:"button",action:"click",result:"User requested to go to the product page."}),ProductSelected:(t,o)=>e.UserActionEvent({section:"productPage",element:"selectCardButton",action:"click",data:{productType:t,productName:o},result:"User has selected a product."}),SelectionHotspotClicked:t=>e.UserActionEvent({section:"canvas",element:"selectionHotspot",action:"click",result:"User clicked on selection hotspot of an entity.",data:{id:t}}),AssistantEntityLinkClicked:t=>e.UserActionEvent({section:"chat",element:"entityLink",action:"click",result:"User clicked on a link to an entity in a reply of the assistant.",data:{id:t}}),RedoButtonClicked:()=>e.UserActionEvent({section:"bottomToolbar",element:"redoButton",action:"click",result:"User clicked on redo button."}),UndoButtonClicked:()=>e.UserActionEvent({section:"bottomToolbar",element:"undoButton",action:"click",result:"User clicked on undo button."}),GlobalDimensionsButtonClicked:t=>e.UserActionEvent({section:"bottomToolbar",element:"measurementUnitButton",action:"click",data:{dimensionUnit:t},result:"Global measurement units were changed."}),MeasurementsMenuToggled:()=>e.UserActionEvent({section:"bottomToolbar",element:"measurementsMenu",action:"click",result:"User opened the measurements menu."}),MeasurementsMenuClosed:()=>e.UserActionEvent({section:"bottomToolbar",element:"measurementsMenu",action:"click",result:"User closed the measurements menu."}),DimensionIndicatorsToggled:()=>e.UserActionEvent({section:"bottomToolbar",element:"dimensionIndicatorsToggle",action:"click",result:"User toggled dimension indicators visibility."}),FullScreenModeToggled:()=>e.UserActionEvent({section:"bottomToolbar",element:"fullscreenButton",action:"click",result:"User toggled fullscreen mode."}),HelpDialogOpened:()=>e.UserActionEvent({section:"bottomToolbar",element:"helpButton",action:"click",result:"Help dialog opened."}),HelpDialogClosed:()=>e.UserActionEvent({section:"bottomToolbar",element:"helpDialog",action:"click",result:"Help dialog closed."}),EntityDeleteHotspotClicked:n=>{let i=o(n)?"":t(n);return e.UserActionEvent({section:"canvas",element:"deleteEntityHotspot",action:"click",data:{id:n,type:i},result:"User has deleted an entity."})},ExpandedViewClosed:()=>e.UserActionEvent({section:"topNavigation",element:"button",action:"click",result:"User requested to close the expanded view."})};

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

@@ -1,2 +1,3 @@
 export * from './analytics-service.js';
 export * from './domain-controls-analytics.js';
+export * from './frontend-analytics.js';

package/dist/react-sdk/application-runtime/common-services/analytics/index.js

@@ -1 +1 @@
-export*from"./analytics-service.js";export*from"./domain-controls-analytics.js";
+export*from"./analytics-service.js";export*from"./domain-controls-analytics.js";export*from"./frontend-analytics.js";

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

@@ -2,6 +2,6 @@ import type { I18n } from '@lingui/core';
 import { QueryClient } from '@tanstack/react-query';
 import { type Logger } from '@salsita-ai/common/utils';
 import type { AnyApplicationConfig } from '#package/domain';
-export declare const initializeLogger: (config: AnyApplicationConfig, isDev: boolean) => Logger;
-export declare const initializeI18n: (config: AnyApplicationConfig) => I18n;
+export declare const initializeLogger: (config: Pick<AnyApplicationConfig, 'services' | 'defaultEnvs' | 'version'>, isDev: boolean) => Logger;
+export declare const initializeI18n: (config: Pick<AnyApplicationConfig, 'services'>) => I18n;
 export declare const createQueryClient: (logger: Logger) => QueryClient;

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,18 +6,25 @@ 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;
 export declare const useAdminRawAccessService: () => AccessService | null;
 export declare const useConfiguratorRawAccessInfo: () => {
     raw: string;
+    access: import("@salsita-ai/contracts/api").AccessLevel;
     viewMode: boolean;
     revisionId: string | undefined;
     configurationId: string;
 } | null;
 export declare const useAdminRawAccessInfo: () => {
     raw: string;
+    access: import("@salsita-ai/contracts/api").AccessLevel;
     viewMode: boolean;
     revisionId: string | undefined;
     configurationId: string;

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{useApplicationRuntime as r,useApplicationType as t}from"../provider/index.js";import{ApplicationType as i}from"../runtime/index.js";import{useApplicationRuntimeSelector as n}from"./use-application-runtime-selector.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=t(),s=r(),c=useProvidedAccessService(),a=n(e===i.Admin?s.selectors.domainContext.admin.getIsViewMode:s.selectors.domainContext.configurator.getIsViewMode);return o(()=>({...c,accessInfo:{...c.accessInfo,viewMode:a}}),[c,a])};export const useConfigurationId=()=>useProvidedAccessService().configurationId;export const useConfiguratorRawAccessService=()=>n(r().selectors.access.getConfiguratorRawAccessService);export const useAdminRawAccessService=()=>n(r().selectors.access.getAdminRawAccessService);export const useConfiguratorRawAccessInfo=()=>n(r().selectors.access.getConfiguratorRawAccessInfo);export const useAdminRawAccessInfo=()=>n(r().selectors.access.getAdminRawAccessInfo);export const useAccessInfoActions=()=>r().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/hooks/use-web-component-readonly-sync.d.ts

@@ -1,15 +1,8 @@
 /**
- * Mirrors the host's `readonly` web-component property into runtime state, where the domain reads it
- * as part of the effective mode.
+ * Does nothing. The application runtime mirrors the host's `readonly` web-component property into
+ * runtime state itself, from its construction on, so no component has to.
  *
- * Call it once at the application root. The configurator does; the admin application deliberately
- * does not, because `readonly` is a property of the custom element a host embeds and admin is not
- * embedded that way.
- *
- * Root placement means a domain lifecycle mounting in the same commit can initialize before the
- * first value lands, since React runs child effects before parent effects. That is harmless: nothing
- * reads the effective mode while initializing — persistence reads it per save request, and the
- * domain context picks a later change up through the expression context, whose identity `reconcile`
- * compares on every runtime notification.
+ * @deprecated The runtime keeps `readonly` in sync without it; remove the call. This hook will be
+ * removed in a future version.
  */
 export declare const useWebComponentReadonlySync: () => void;

package/dist/react-sdk/application-runtime/hooks/use-web-component-readonly-sync.js

@@ -1 +1 @@
-import{useEffect as e}from"react";import{standardWebComponentProperties as o}from"#package/domain";import{useApplicationRuntime as r}from"../provider/index.js";import{useWebComponentProperty$ as n}from"./use-web-component.js";export const useWebComponentReadonlySync=()=>{let t=r(),m=n(o.readonly);e(()=>{let e=m.subscribe(t.actions.webComponent.setReadonly);return()=>{e.unsubscribe()}},[t,m])};
+export const useWebComponentReadonlySync=()=>{};

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

@@ -7,6 +7,11 @@ export declare const useWebComponentApi: () => WebComponentApi;
 export declare function useWebComponentProperty$<T>(property: WebComponentPropertyDescriptor<T>): BehaviorSubject<T>;
 export declare function useWebComponentPropertySetter<T>(property: WebComponentPropertyDescriptor<T>): Dispatch<SetStateAction<T>>;
 export declare const useWebComponentPropertyState: <T>(property: WebComponentPropertyDescriptor<T>) => [value: T, setValue: Dispatch<SetStateAction<T>>];
+/**
+ * The property's current value; re-renders when it changes. A standard property the runtime
+ * mirrors is read from the slice its scope names, `hostProperties` or the domain's `webComponent`;
+ * any other property from its storage.
+ */
 export declare const useWebComponentPropertyValue: <T>(property: WebComponentPropertyDescriptor<T>) => T;
 export declare const useDispatchWebComponentEvent: <T, R>(event: WebComponentEventDescriptor<T, R>) => (payload: T) => Promise<R | undefined>;
 export declare const useWebcomponentGeneration: () => number;

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

@@ -1 +1 @@
-import{useCallback as e}from"react";import{useEagerObservableValue as o}from"../../domain-context/common-hooks/use-observable-selector.js";import{useApplicationRuntime as t}from"../provider/index.js";import{useApplicationRuntimeSelector as n}from"./use-application-runtime-selector.js";export const useWebComponentOptions=()=>t().selectors.commonServices.getWebComponentOptions();export const useWebComponentApi=()=>t().selectors.commonServices.getWebComponentApi();export function useWebComponentProperty$(e){return useWebComponentApi().getPropertyStorage(e).subject}export function useWebComponentPropertySetter(o){let t=useWebComponentProperty$(o);return e(e=>{let o="function"==typeof e?e(t.value):e;o!==t.value&&t.next(o)},[t])}export const useWebComponentPropertyState=e=>{let t=useWebComponentProperty$(e),n=useWebComponentPropertySetter(e);return[o(t),n]};export const useWebComponentPropertyValue=e=>o(useWebComponentProperty$(e));export const useDispatchWebComponentEvent=o=>{let t=useWebComponentApi();return e(async e=>t.dispatchEvent(o,e),[o,t])};export const useWebcomponentGeneration=()=>n(t().selectors.webComponent.getWebcomponentGeneration);
+import{useCallback as e}from"react";import{useEagerObservableValue as o}from"../../domain-context/common-hooks/use-observable-selector.js";import{findMirroredHostPropertyReader as t}from"../host-properties/index.js";import{useApplicationRuntime as n}from"../provider/index.js";import{useApplicationRuntimeSelector as r}from"./use-application-runtime-selector.js";export const useWebComponentOptions=()=>n().selectors.commonServices.getWebComponentOptions();export const useWebComponentApi=()=>n().selectors.commonServices.getWebComponentApi();export function useWebComponentProperty$(e){return useWebComponentApi().getPropertyStorage(e).subject}export function useWebComponentPropertySetter(o){let t=useWebComponentProperty$(o);return e(e=>{let o="function"==typeof e?e(t.value):e;o!==t.value&&t.next(o)},[t])}export const useWebComponentPropertyState=e=>[useWebComponentPropertyValue(e),useWebComponentPropertySetter(e)];export const useWebComponentPropertyValue=e=>{let p=n(),s=useWebComponentProperty$(e),m=t(e),u=o(s,null===m);return r(()=>null===m?u:m(p.selectors))};export const useDispatchWebComponentEvent=o=>{let t=useWebComponentApi();return e(async e=>t.dispatchEvent(o,e),[o,t])};export const useWebcomponentGeneration=()=>r(n().selectors.webComponent.getWebcomponentGeneration);

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

@@ -0,0 +1,15 @@
+import type { HostPropertyName } from './host-property-scopes.js';
+import type { HostPropertiesState, HostPropertyValue } from './types.js';
+interface Context {
+    readonly setHostProperties: (update: (state: HostPropertiesState) => HostPropertiesState) => void;
+}
+/**
+ * Internal to the runtime: only the subscription `connectHostProperties` sets up calls these. The
+ * runtime does not expose them on `actions`, because the host writes properties through the
+ * element.
+ */
+export declare const createHostPropertiesActions: (context: Context) => {
+    setHostProperty: <NAME extends HostPropertyName>(name: NAME, value: HostPropertyValue<NAME>) => void;
+};
+export type HostPropertiesActions = ReturnType<typeof createHostPropertiesActions>;
+export {};

package/dist/react-sdk/application-runtime/host-properties/actions.js

@@ -0,0 +1 @@
+import{isShallowEqual as t}from"@salsita-ai/common/utils";export const createHostPropertiesActions=o=>{let{setHostProperties:r}=o;return{setHostProperty:(o,e)=>{r(r=>t(r[o],e)?r:{...r,[o]:e})}}};

package/dist/react-sdk/application-runtime/host-properties/connect-host-properties.d.ts

@@ -0,0 +1,30 @@
+import type { WebComponentHostActions, WebComponentSelectors } from '#package/domain';
+import type { WebComponentApi } from '../web-component/index.js';
+import type { HostPropertiesActions } from './actions.js';
+interface Context {
+    readonly webComponentApi: WebComponentApi;
+    readonly actions: HostPropertiesActions;
+    /** The domain's `webComponent` slice, which keeps the domain-scoped properties. */
+    readonly domainSelectors: WebComponentSelectors;
+    readonly domainActions: WebComponentHostActions;
+}
+/**
+ * The runtime-owned subscription behind the mirrored host properties: mirrors each mirrored
+ * property storage of the element into the slice its scope names, the application-scoped ones
+ * into `hostProperties` and the domain-scoped ones into the domain's `webComponent`. Either slice
+ * publishes only when a value changes, equal meaning shallowly equal.
+ *
+ * The runtime calls it once, right after its subject exists, and keeps it for its whole lifetime,
+ * as long as the element that owns the storages. The storages are `BehaviorSubject`s, so the first
+ * emissions replay the values the slices were initialized with and publish nothing, except a
+ * domain-scoped property the host set before the runtime existed. The admin application gets the
+ * domain-scoped properties too: its element never sets `readonly`, so the value stays `false`.
+ *
+ * Interim: the element's property storages are still the store and these slices a read mirror,
+ * so every mirrored value is held twice. CON-3142 makes the slice the only store (the element's
+ * setters and attribute parsing write it) and removes the storages and this subscription.
+ *
+ * @returns the unsubscribe, for tests and runtimes that end before their element.
+ */
+export declare const connectHostProperties: (context: Context) => (() => void);
+export {};

package/dist/react-sdk/application-runtime/host-properties/connect-host-properties.js

@@ -0,0 +1 @@
+import{isShallowEqual as r}from"@salsita-ai/common/utils";import{getDomainHostProperty as o,setDomainHostProperty as t}from"./domain-host-properties.js";import{hostPropertyDescriptors as s}from"./host-property-descriptors.js";import{domainHostPropertyNames as e,hostPropertyNames as p}from"./host-property-scopes.js";export const connectHostProperties=i=>{let{webComponentApi:m,actions:c,domainSelectors:a,domainActions:b}=i,u=[...p.map(r=>m.getPropertyStorage(s[r]).subject.subscribe(o=>{c.setHostProperty(r,o)})),...e.map(e=>m.getPropertyStorage(s[e]).subject.subscribe(s=>{r(o(a,e),s)||t(b,e,s)}))];return()=>{u.forEach(r=>{r.unsubscribe()})}};