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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/sdk",
-  "version": "0.50.0-develop.f81ab6ac76",
+  "version": "0.50.0-develop.f9cd9b3a12",
   "description": "TypeScript SDK and CLI for building, running, and deploying Phoenix configurator applications.",
   "keywords": [
     "salsita",
@@ -207,6 +207,16 @@
     "schema",
     "CHANGELOG.md"
   ],
+  "nx": {
+    "targets": {
+      "build": {
+        "outputs": [
+          "{projectRoot}/dist",
+          "{projectRoot}/src/i18n/locales/*/messages.ts"
+        ]
+      }
+    }
+  },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "14.1.1",
     "@aws-sdk/client-s3": "3.1054.0",
@@ -298,8 +308,8 @@
     "yaml": "2.9.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.f81ab6ac76",
-    "@salsita-ai/contracts": "0.50.0-develop.f81ab6ac76"
+    "@salsita-ai/common": "0.50.0-develop.f9cd9b3a12",
+    "@salsita-ai/contracts": "0.50.0-develop.f9cd9b3a12"
   },
   "devDependencies": {
     "@clerk/clerk-react": "5.61.8",

package/schema/domain-spec.json

@@ -13959,6 +13959,53 @@
       "required": ["exportState", "width", "height", "fileFormat", "toolState", "viewState", "navigationState"],
       "additionalProperties": false
     },
+    "AgentScreenshotComponentState": {
+      "type": "object",
+      "tsType": "AgentScreenshotComponentState",
+      "import": [
+        {
+          "module": "@salsita-ai/sdk/domain",
+          "member": "AgentScreenshotComponentState"
+        }
+      ],
+      "properties": {
+        "exportState": {
+          "type": "string"
+        },
+        "width": {
+          "type": "number"
+        },
+        "height": {
+          "type": "number"
+        },
+        "fileFormat": {
+          "type": "string",
+          "enum": ["PNG", "JPEG"]
+        },
+        "backgroundColor": {
+          "type": "string",
+          "pattern": "^#[0-9a-fA-F]{6}$",
+          "tsType": "HexColor",
+          "import": [
+            {
+              "module": "@salsita-ai/sdk/common/utils",
+              "member": "HexColor"
+            }
+          ]
+        },
+        "toolState": {
+          "type": "string"
+        },
+        "viewState": {
+          "type": "string"
+        },
+        "navigationState": {
+          "type": "string"
+        }
+      },
+      "required": ["exportState", "width", "height", "fileFormat", "toolState", "viewState", "navigationState"],
+      "additionalProperties": false
+    },
     "ProjectedEntitiesComponentState": {
       "type": "object",
       "tsType": "ProjectedEntitiesComponentState",
@@ -44102,6 +44149,99 @@
                 ]
               }
             },
+            "agentScreenshot": {
+              "type": "object",
+              "additionalProperties": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "tsType": "AgentScreenshotComponentState",
+                    "import": [
+                      {
+                        "module": "@salsita-ai/sdk/domain",
+                        "member": "AgentScreenshotComponentState"
+                      }
+                    ],
+                    "properties": {
+                      "exportState": {
+                        "$ref": "#/definitions/EnhancedStringRead"
+                      },
+                      "width": {
+                        "$ref": "#/definitions/EnhancedNumberRead"
+                      },
+                      "height": {
+                        "$ref": "#/definitions/EnhancedNumberRead"
+                      },
+                      "fileFormat": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": ["PNG", "JPEG"]
+                          },
+                          {
+                            "$ref": "#/definitions/ReadEnhancement"
+                          }
+                        ]
+                      },
+                      "backgroundColor": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "pattern": "^#[0-9a-fA-F]{6}$",
+                            "tsType": "HexColor",
+                            "import": [
+                              {
+                                "module": "@salsita-ai/sdk/common/utils",
+                                "member": "HexColor"
+                              }
+                            ]
+                          },
+                          {
+                            "$ref": "#/definitions/ReadEnhancement"
+                          }
+                        ]
+                      },
+                      "toolState": {
+                        "$ref": "#/definitions/EnhancedStringRead"
+                      },
+                      "viewState": {
+                        "$ref": "#/definitions/EnhancedStringRead"
+                      },
+                      "navigationState": {
+                        "$ref": "#/definitions/EnhancedStringRead"
+                      },
+                      "$filter": {
+                        "$ref": "#/definitions/ComponentSystemFilter"
+                      }
+                    },
+                    "required": [
+                      "exportState",
+                      "width",
+                      "height",
+                      "fileFormat",
+                      "toolState",
+                      "viewState",
+                      "navigationState"
+                    ],
+                    "additionalProperties": false
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "$read": {
+                        "type": "string",
+                        "pattern": "^\\$?[a-z]\\w*$"
+                      },
+                      "$filter": {
+                        "$ref": "#/definitions/ComponentSystemFilter"
+                      }
+                    },
+                    "required": ["$read"],
+                    "additionalProperties": false
+                  }
+                ]
+              }
+            },
             "projectedEntities": {
               "type": "object",
               "additionalProperties": {

package/dist/configurator/ui/assistant/form/built-in-form-registry.d.ts

@@ -1,10 +0,0 @@
-import type { FormElementDefinition } from './form-element-definition.js';
-import { type FormRegistry } from './form-registry.js';
-/** The elements of every assistant form: the built-ins the SDK prompt lists, with their components. */
-export declare const BUILT_IN_FORM_ELEMENTS: readonly FormElementDefinition[];
-/**
- * The registry of the built-in elements, built on the first form rather than when the module loads:
- * compiling validators while the bundle evaluates would break a configurator on a page whose CSP
- * forbids eval, even one without an assistant.
- */
-export declare const getBuiltInFormRegistry: () => FormRegistry;

package/dist/configurator/ui/assistant/form/built-in-form-registry.js

@@ -1 +0,0 @@
-let o;import{match as t}from"ts-pattern";import{ASSISTANT_BUILT_IN_FORM_ELEMENTS as e,extendedSchemaValidator as r}from"#package/domain";import{FormGroup as i,FormOptions as m,FormReply as n,FormText as p}from"../form-elements/index.js";import{createFormRegistry as c}from"./form-registry.js";export const BUILT_IN_FORM_ELEMENTS=e.map(o=>t(o.role).with("group",t=>({...o,role:t,component:i})).with("choice","choices",t=>({...o,role:t,component:m})).with("option",t=>({...o,role:t,component:n})).with("input",t=>({...o,role:t,component:p})).exhaustive());export const getBuiltInFormRegistry=()=>o??=c(BUILT_IN_FORM_ELEMENTS,{schemaValidator:r});

package/dist/configurator/ui/assistant/form/form-registry.js

@@ -1,8 +0,0 @@
-let e=new Set(`a abbr acronym address applet area article aside audio b base basefont bdi bdo big blink blockquote body br
-  button canvas caption center cite code col colgroup data datalist dd del details dfn dialog dir div dl dt em
-  embed fieldset figcaption figure font footer form frame frameset h1 h2 h3 h4 h5 h6 head header hgroup hr html
-  i iframe image img input ins kbd keygen label legend li link main map mark marquee math menu menuitem meta
-  meter nav nobr noembed noframes noscript object ol optgroup option output p param picture plaintext pre
-  progress q rb rp rt rtc ruby s samp script search section select slot small source span strike strong style
-  sub summary sup svg table tbody td template textarea tfoot th thead time title tr track tt u ul var video wbr
-  xmp`.split(/\s+/)),t=/^[a-z][a-z0-9-]*$/,r={type:"string"},a=({role:e,attributes:t})=>Object.entries({label:r,..."option"===e||"input"===e?{value:r}:{},...t}),o=(e,t)=>{let r=e.get(t);if(r?.definition.role!==t)throw Error(`The form registry has no "${t}" element with the role "${t}". Forms wrap implicit content in it. Register the built-in "${t}".`);return r};export const createFormRegistry=(r,{schemaValidator:n})=>{let i=new Map;for(let o of r){if(!t.test(o.name)||e.has(o.name))throw Error(`The form element "${o.name}" cannot be registered: its name must be lowercase and must not be an HTML element name, so form markup is never read as HTML. Rename the element.`);if(i.has(o.name))throw Error(`The form element "${o.name}" is registered twice. Each tag names one element. Remove or rename one of them.`);let r=new Map(a(o).map(([e,t])=>[e,{attribute:t,validate:n.compile({type:t.type,...t.enum?{enum:t.enum}:{}})}]));i.set(o.name,{definition:o,attributes:r})}return{group:o(i,"group"),choice:o(i,"choice"),choices:o(i,"choices"),get:e=>i.get(e)}};

package/dist/configurator/ui/phoenix-layout-elements/language/use-locale-options.d.ts

@@ -1,4 +0,0 @@
-export declare const useLocaleOptions: () => {
-    locale: string;
-    displayName: string;
-}[];

package/dist/configurator/ui/phoenix-layout-elements/language/use-locale-options.js

@@ -1 +0,0 @@
-import{useMemo as a}from"react";import{applicationConfigComponent as e}from"#package/domain";import{useFirstRootComponent as t}from"#package/react-sdk";export const useLocaleOptions=()=>{let o=t(e),r=a(()=>o?.state.availableLocales??["en"],[o]);return a(()=>r.map(a=>{let e=new Intl.DisplayNames([a],{type:"language",fallback:"code"});return{locale:a,displayName:e.of(a)??a}}),[r])};

package/dist/configurator/ui/phoenix-layout-elements/measurements/use-measurements-visibility.d.ts

@@ -1,4 +0,0 @@
-export declare const useMeasurementsVisibility: (showIndicatorSwitch?: boolean) => {
-    indicatorSwitchShown: boolean;
-    measurementsShown: boolean;
-};

package/dist/configurator/ui/phoenix-layout-elements/measurements/use-measurements-visibility.js

@@ -1 +0,0 @@
-import{applicationConfigComponent as e}from"#package/domain";import{useDimensionConfig as t,useFirstRootComponent as r}from"#package/react-sdk";export const useMeasurementsVisibility=a=>{let i=r(e),{availableDimensions:o}=t(),s=a??i?.state.indicatorSwitch??!0,m=o.length>1;return{indicatorSwitchShown:s,measurementsShown:s||m}};

package/dist/domain/application/assistant/assistant-form-elements.d.ts

@@ -1,28 +0,0 @@
-/**
- * What an element of an assistant form collects: a `group` all its children, a `choice` exactly one
- * of its options, a `choices` any number of them; an `option` is something to pick and an `input` a
- * free value.
- */
-export type AssistantFormRole = 'group' | 'choice' | 'choices' | 'option' | 'input';
-/** The type an attribute of a form element is validated and coerced to; the model writes every attribute as a string. */
-export interface AssistantFormAttribute {
-    readonly type: 'string' | 'number' | 'integer' | 'boolean';
-    readonly enum?: readonly string[];
-}
-/**
- * An element the assistant can write inside a ```` ```form ```` fence of its reply to ask the user
- * something. The panel renders it, and the SDK prompt lists it, so the model and the panel agree on
- * one set of elements.
- */
-export interface AssistantFormElementDescriptor {
-    /** The tag: lowercase, and never the name of an HTML element. */
-    readonly name: string;
-    readonly role: AssistantFormRole;
-    /** What the element is for, printed in the prompt after its signature. */
-    readonly description: string;
-    /** Attributes beyond the built-in `label` and, on an option or an input, `value`. */
-    readonly attributes: Readonly<Record<string, AssistantFormAttribute>>;
-    readonly required?: readonly string[];
-}
-/** The elements every assistant form understands, in the order the prompt lists them. */
-export declare const ASSISTANT_BUILT_IN_FORM_ELEMENTS: readonly AssistantFormElementDescriptor[];

package/dist/domain/application/assistant/assistant-form-elements.js

@@ -1 +0,0 @@
-export const ASSISTANT_BUILT_IN_FORM_ELEMENTS=[{name:"group",role:"group",description:"Puts related questions together under its label.",attributes:{}},{name:"choice",role:"choice",description:"The user picks exactly one of its options.",attributes:{}},{name:"choices",role:"choices",description:"The user picks any number of its options.",attributes:{}},{name:"reply",role:"option",description:"A short answer shown as a button.",attributes:{}},{name:"text",role:"input",description:"A single line the user types.",attributes:{placeholder:{type:"string"}}}];

package/dist/domain/extensions/client-side-image.js

@@ -1 +0,0 @@
-import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const clientSideImageComponent=t.component("clientSideImage").withState({type:"object",tsType:"ClientSideImageComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"ClientSideImageComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$",tsType:"HexColor",import:[{module:"@salsita-ai/sdk/common/utils",member:"HexColor"}]},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isClientSideImageComponentSnapshot=e(clientSideImageComponent);

package/dist/domain/extensions/save-template-thumbnail.js

@@ -1 +0,0 @@
-import{SystemComponentBuilder as t,isSnapshotOfComponentType as e}from"../core/index.js";export const saveTemplateThumbnailComponent=t.component("saveTemplateThumbnail").withState({type:"object",tsType:"SaveTemplateThumbnailComponentState",import:[{module:"@salsita-ai/sdk/domain",member:"SaveTemplateThumbnailComponentState"}],properties:{exportState:{type:"string"},width:{type:"number"},height:{type:"number"},fileFormat:{type:"string",enum:["PNG","JPEG"]},backgroundColor:{type:"string",pattern:"^#[0-9a-fA-F]{6}$",tsType:"HexColor",import:[{module:"@salsita-ai/sdk/common/utils",member:"HexColor"}]},toolState:{type:"string"},viewState:{type:"string"},navigationState:{type:"string"}},required:["exportState","width","height","fileFormat","toolState","viewState","navigationState"],additionalProperties:!1}).build();export const isSaveTemplateThumbnailComponentSnapshot=e(saveTemplateThumbnailComponent);

package/dist/react-sdk/application-runtime/runtime/god-mode.d.ts

@@ -1,19 +0,0 @@
-import { type EnvironmentActions } from '#package/domain';
-declare global {
-    interface Window {
-        __salsita: {
-            setGodMode: (godMode: boolean) => void;
-        };
-    }
-}
-interface Context {
-    readonly environmentActions: EnvironmentActions;
-}
-/**
- * Installs the `window.__salsita.setGodMode` global toggle for the given registry. The
- * toggle persists the value in session storage (so it survives reloads, see
- * {@link resolveGodMode}) and publishes it to the runtime spec, where consumers read it
- * via `useRuntimeSpecGodMode`.
- */
-export declare const registerGodModeGlobal: (context: Context) => void;
-export {};

package/dist/react-sdk/application-runtime/runtime/god-mode.js

@@ -1 +0,0 @@
-import{GOD_MODE_SESSION_STORAGE_KEY as o}from"#package/domain";export const registerGodModeGlobal=e=>{window.__salsita={...window.__salsita,setGodMode:t=>{sessionStorage.setItem(o,t.toString()),e.environmentActions.setGodMode(t)}}};