@salsita-ai/sdk 0.50.0-develop.ca72986c39 → 0.50.0-develop.cba048b0d7

package/dist/ui-sdk/responsive-application/responsive-state-store.d.ts

@@ -0,0 +1,59 @@
+import type { CanvasPadding } from './ResponsiveProvider.js';
+/**
+ * The responsive state a `ResponsiveStateStore` holds.
+ *
+ * @internal Runtime plumbing behind the `store` prop of `ResponsiveApplicationProvider`, for the
+ * SDK's own configurator.
+ */
+export interface ResponsiveStateSnapshot {
+    readonly isPhone: boolean;
+    readonly isMobile: boolean;
+    readonly isTablet: boolean;
+    readonly isDesktop: boolean;
+    readonly isLandscape: boolean;
+    readonly isPortrait: boolean;
+    readonly canvasPadding: CanvasPadding;
+    readonly isExpanded: boolean;
+    readonly isHidden: boolean;
+    readonly isAnimating: boolean;
+}
+/**
+ * Responsive state owned outside the UI, which `ResponsiveApplicationProvider` measures its root
+ * container into and provides to `useResponsive()`. A mounted Phoenix configurator passes its
+ * application runtime's responsive state (`useResponsiveStore()` of `@salsita-ai/sdk/react`), so
+ * its lifecycle reads the same state without the UI.
+ *
+ * Declared here by shape rather than imported, because `ui-sdk` depends on no other SDK package.
+ *
+ * @internal Runtime plumbing for the SDK's own configurator; a project mounting
+ * `ResponsiveApplicationProvider` leaves `store` out.
+ */
+export interface ResponsiveStateStore {
+    /** Calls `onChange` after every change of the store; returns the unsubscribe. */
+    readonly subscribe: (onChange: () => void) => () => void;
+    /** The same object until a value in it changes. */
+    readonly getState: () => ResponsiveStateSnapshot;
+    /** The container's size rounded up to whole pixels; the same object until it changes. */
+    readonly getViewportSize: () => {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly setViewport: (viewport: {
+        readonly width: number;
+        readonly height: number;
+        readonly isLandscape: boolean;
+        readonly isPortrait: boolean;
+    }) => void;
+    readonly setBreakpoints: (breakpoints: {
+        readonly sm: number;
+        readonly md: number;
+        readonly lg: number;
+    }) => void;
+    readonly getCanvasPadding: () => CanvasPadding;
+    readonly setCanvasPadding: (padding: CanvasPadding) => void;
+    readonly expand: () => void;
+    readonly collapse: () => void;
+    readonly hide: () => void;
+    readonly show: () => void;
+    readonly setAnimating: (value: boolean) => void;
+}

package/dist/ui-sdk/responsive-application/responsive-state-store.js

@@ -0,0 +1 @@
+export{};

package/dist/ui-sdk/responsive-application/use-store-responsive-info.d.ts

@@ -0,0 +1,7 @@
+import type { useResponsiveInfo } from './ResponsiveProvider.js';
+import type { ResponsiveStateStore } from './responsive-state-store.js';
+/**
+ * `useResponsiveInfo` over a store owned outside the UI: measures the container into the store,
+ * pushes the theme's breakpoints into it, and reads every value back from it.
+ */
+export declare const useStoreResponsiveInfo: (elementRef: React.MutableRefObject<HTMLElement | null>, store: ResponsiveStateStore) => ReturnType<typeof useResponsiveInfo>;

package/dist/ui-sdk/responsive-application/use-store-responsive-info.js

@@ -0,0 +1 @@
+import{useTheme as e}from"@mui/material";import{useCallback as t,useLayoutEffect as i,useMemo as a,useState as n,useSyncExternalStore as s}from"react";import{isMobileOnly as r}from"react-device-detect";import{BehaviorSubject as o}from"rxjs";import{useResizeObserver as c}from"usehooks-ts";export const useStoreResponsiveInfo=(p,d)=>{let{sm:l,md:u,lg:m}=e().breakpoints.values,g=s(d.subscribe,d.getState),[b]=n(()=>new o(d.getViewportSize()));i(()=>{let e=()=>{let e=d.getViewportSize();e!==b.value&&b.next(e)};return e(),d.subscribe(e)},[d,b]),i(()=>{d.setBreakpoints({sm:l,md:u,lg:m})},[d,l,u,m]);let w=t(e=>{let{width:t,height:i}=e.getBoundingClientRect();d.setViewport({width:t,height:i,isLandscape:window.matchMedia("(orientation: landscape)").matches,isPortrait:window.matchMedia("(orientation: portrait)").matches})},[d]),f=t(e=>{d.setCanvasPadding("function"==typeof e?e(d.getCanvasPadding()):e)},[d]),h=t(()=>{p.current&&w(p.current)},[p,w]);return c({ref:p,onResize:()=>{null!=p.current&&w(p.current)}}),i(()=>{null!=p.current&&w(p.current)},[p,w]),a(()=>({...g,expand:d.expand,collapse:d.collapse,hide:d.hide,show:d.show,isMobileAndMobileLandscape:g.isMobile||g.isLandscape&&g.isTablet&&r,isDesktopExceptMobileLandscape:g.isDesktop&&!(g.isLandscape&&g.isTablet&&r),viewport$:b,getCanvasPadding:d.getCanvasPadding,setCanvasPadding:f,update:h,setAnimating:d.setAnimating}),[g,d,b,f,h])};

package/dist/ui-sdk/theme/types.d.ts

@@ -44,7 +44,8 @@ declare module '@mui/material/styles' {
         PhxChat: 'root';
         PhxChatFooter: 'root' | 'formLayout' | 'input';
         PhxChatMessage: 'base' | 'assistant' | 'user' | 'widget' | 'error' | 'helper';
-        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'entityLink' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'undoButton' | 'status' | 'separator' | 'earlierButton' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
+        PhxAssistantPanel: 'root' | 'header' | 'title' | 'closeButton' | 'thread' | 'greeting' | 'messages' | 'userMessage' | 'assistantMessage' | 'alert' | 'entityLink' | 'referenceLink' | 'referenceDetails' | 'image' | 'screenshotsLink' | 'screenshots' | 'form' | 'formGroup' | 'formGroupLabel' | 'formOptions' | 'formOptionsLabel' | 'formOptionsRow' | 'formReply' | 'formCard' | 'formCardImage' | 'formCardLabel' | 'formCardDescription' | 'formCardCheck' | 'formSwatch' | 'formSwatchImage' | 'formSwatchCheck' | 'formText' | 'formTextInput' | 'formNumber' | 'formConfirm' | 'formConfirmButtons' | 'formConfirmButton' | 'formSubmit' | 'formNote' | 'chips' | 'activity' | 'activityIcon' | 'chip' | 'undoButton' | 'status' | 'separator' | 'earlierButton' | 'notice' | 'newReplyButton' | 'composer' | 'inputFrame' | 'input' | 'sendButton' | 'stopButton' | 'hint';
+        PhxExportingOverlay: 'root' | 'message';
         PhxTopNavigation: 'root' | 'stepper' | 'step';
         PhxListSelector: 'root';
         PhxListSelectorItem: 'root' | 'radio' | 'title' | 'description' | 'formControlLabel';
@@ -113,6 +114,9 @@ declare module '@mui/material/styles' {
         PhxAssistantPanel?: {
             styleOverrides?: ComponentsOverrides<Theme>['PhxAssistantPanel'];
         };
+        PhxExportingOverlay?: {
+            styleOverrides?: ComponentsOverrides<Theme>['PhxExportingOverlay'];
+        };
         PhxPreviewLayout?: {
             styleOverrides?: ComponentsOverrides<Theme>['PhxPreviewLayout'];
         };

package/dist/watch/glob-matcher.d.ts

@@ -4,7 +4,7 @@ interface PathOperations {
     readonly sep: string;
 }
 /**
- * Build a chokidar v4 `ignored` callback from include + exclude glob arrays.
+ * Build a chokidar `ignored` callback from include + exclude glob arrays.
  *
  * Internal helper for {@link watch | the watch shim} in `./watch.ts`. Not part of the
  * public surface — consumers pass glob strings to `watch(...)` and this conversion
@@ -14,15 +14,15 @@ interface PathOperations {
  * - excludes are checked first against every path (file or directory). Patterns ending in
  *   `/**` are auto-expanded to also match the bare directory form so chokidar prunes the
  *   subtree instead of walking it.
- * - for directories, includes are not applied — chokidar must descend to find matching files.
- * - for files (or when stats is unavailable), includes are required when non-empty.
+ * - directories descend only towards an included literal file or within an included glob's prefix.
+ * - files require an include match when non-empty; discovery without stats remains permissive.
  */
 export declare const createWatchIgnoreMatcher: (params: {
     readonly includes?: readonly string[];
     readonly excludes?: readonly string[];
     /**
      * If set, absolute paths passed to the predicate are converted to paths relative to
-     * this directory before being matched. Chokidar v4 passes absolute paths to `ignored`
+     * this directory before being matched. Chokidar passes absolute paths to `ignored`
      * even when `cwd` is set, but the include/exclude globs in this codebase are written
      * relative to the project root — this option bridges that.
      */

package/dist/watch/glob-matcher.js

@@ -1 +1 @@
-import*as t from"node:path";import e from"picomatch";export const createWatchIgnoreMatcher=o=>{let{includes:r=[],excludes:n=[],cwd:l,pathOperations:s=t}=o,i=r.length>0?e([...r]):null,c=n.length>0?e((t=>{let e=[];for(let o of t)e.push(o),o.endsWith("/**")&&e.push(o.slice(0,-3));return e})(n)):null;return(t,e)=>{let o,r=(""===(o=l?s.relative(l,t):t)?".":o).split(s.sep).join("/");return!!c?.(r)||!!e&&!!e.isFile()&&!(!i||i(r))}};export const deriveWatchRoot=t=>{let e=t.split("/"),o=e.findIndex(t=>/[*?[{]/.test(t));return -1===o?t:0===o?".":e.slice(0,o).join("/")};let o=/[*?[{]/;export const containsGlob=t=>o.test(t);export const isRecursiveGlob=t=>t.includes("**");
+import*as e from"node:path";import t from"picomatch";export const createWatchIgnoreMatcher=o=>{let{includes:s=[],excludes:r=[],cwd:i,pathOperations:l=e}=o,n="\\"===l.sep?e.win32.isAbsolute:e.posix.isAbsolute,p=e=>{let t=i?l.relative(i,e):e;return(""===t?".":t).split(l.sep).join("/")},c=s.map(e=>(i&&n(e)?p(e):e.split(l.sep).join("/")).replace(/^\.\/+/,"")),a=c.length>0?t(c):null,h=r.length>0?t((e=>{let t=[];for(let o of e)t.push(o),o.endsWith("/**")&&t.push(o.slice(0,-3));return t})(r)):null,u=c.map(e=>({path:deriveWatchRoot(e),isGlob:containsGlob(e)})),m=(e,t)=>{let o=l.relative(t,e);return""!==o&&".."!==o&&!o.startsWith(`..${l.sep}`)&&!n(o)};return(e,t)=>{let o=p(e);return!!h?.(o)||(t?.isDirectory()&&u.length>0?!u.some(({path:e,isGlob:t})=>m(e,o)||t&&(""===l.relative(e,o)||m(o,e))):!!t&&!!t.isFile()&&!(!a||a(o)))}};export const deriveWatchRoot=e=>{let t=e.split("/"),o=t.findIndex(e=>/[*?[{]/.test(e));return -1===o?e:0===o?".":t.slice(0,o).join("/")};let o=/[*?[{]/;export const containsGlob=e=>o.test(e);export const isRecursiveGlob=e=>e.includes("**");

package/dist/watch/watch.d.ts

@@ -16,10 +16,11 @@ export interface WatchOptions {
  * Watch files/directories with the chokidar v3 calling convention — accepts glob
  * strings for both `paths` and `ignored`.
  *
- * Backed by chokidar v4 internally (v4 dropped glob support; this shim restores it).
+ * Backed by chokidar's current concrete-path API; this shim supplies the glob filters.
  * Each input glob is classified:
  *
- * - **Concrete path** (no glob chars): added to watch roots as-is.
+ * - **Concrete path** (no glob chars): added as-is; with active glob filters an existing file's parent
+ *   is watched instead, while the file's exact path stays in the include filter.
  * - **Recursive glob** (contains `**`): the prefix is used as the watch root, the full
  *   pattern stays as an include filter so new files matching the glob still trigger events.
  *   Example: `spec/**\/*.{yaml,yml}` → watches `spec/`, filters to `*.yaml`/`*.yml`.
@@ -27,8 +28,7 @@ export interface WatchOptions {
  *   root, the full pattern stays as an include filter so new files matching the glob
  *   still trigger events.
  *
- * Watch roots that don't exist at call time are dropped silently (chokidar v4 emits
- * `error` events for missing paths otherwise).
+ * Native roots missing at call time are dropped; other explicit inputs may still cover later files.
  *
  * Returns chokidar's `FSWatcher` — the `.on()` / `.close()` event API is unchanged.
  */

package/dist/watch/watch.js

@@ -1 +1 @@
-import{watch as e}from"chokidar";import{statSync as t}from"node:fs";import{resolve as r}from"node:path";import{containsGlob as o,createWatchIgnoreMatcher as n,deriveWatchRoot as i,isRecursiveGlob as l}from"./glob-matcher.js";export const watch=(d,f)=>{let a=f?.cwd??process.cwd(),h=f?.ignored==null?[]:"string"==typeof f.ignored?[f.ignored]:f.ignored,p=[],g=[],c=new Set;for(let e of"string"==typeof d?[d]:d){if(!o(e)){t(r(a,e),{throwIfNoEntry:!1})&&(c.add(e),g.push(e));continue}if(!l(e)){p.push(e);let o=i(e);t(r(a,o),{throwIfNoEntry:!1})&&c.add(o);continue}p.push(e);let n=i(e);t(r(a,n),{throwIfNoEntry:!1})&&c.add(n)}if(p.length>0)for(let e of g){let o=t(r(a,e),{throwIfNoEntry:!1});p.push(o?.isDirectory()?`${e}/**/*`:e)}let u=[...c];return 0===u.length?s():e(u,{cwd:a,persistent:f?.persistent,ignoreInitial:f?.ignoreInitial,usePolling:f?.usePolling,interval:f?.interval,ignored:n({includes:p.length>0?p:void 0,excludes:h,cwd:a})})};let s=()=>{let t=e([],{persistent:!1});return setImmediate(()=>t.emit("ready")),t};
+import{watch as e}from"chokidar";import{statSync as t}from"node:fs";import{dirname as r,resolve as o}from"node:path";import{containsGlob as i,createWatchIgnoreMatcher as n,deriveWatchRoot as l,isRecursiveGlob as s}from"./glob-matcher.js";export const watch=(a,f)=>{let p=f?.cwd??process.cwd(),g=f?.ignored==null?[]:"string"==typeof f.ignored?[f.ignored]:f.ignored,h=[],c=new Map,m=new Set;for(let e of"string"==typeof a?[a]:a){if(!i(e)){let r=t(o(p,e),{throwIfNoEntry:!1});r&&(m.add(e),c.set(e,r));continue}if(!s(e)){let r=l(e);t(o(p,r),{throwIfNoEntry:!1})&&(m.add(r),h.push(e));continue}let r=l(e);t(o(p,r),{throwIfNoEntry:!1})&&(m.add(r),h.push(e))}if(h.length>0)for(let[e,t]of c)h.push(t.isDirectory()?`${e}/**/*`:e),t.isFile()&&(m.delete(e),m.add(r(e)));let u=[...m];return 0===u.length?d():e(u,{cwd:p,persistent:f?.persistent,ignoreInitial:f?.ignoreInitial,usePolling:f?.usePolling,interval:f?.interval,ignored:n({includes:h.length>0?h:void 0,excludes:g,cwd:p})})};let d=()=>{let t=e([],{persistent:!1});return setImmediate(()=>t.emit("ready")),t};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salsita-ai/sdk",
-  "version": "0.50.0-develop.ca72986c39",
+  "version": "0.50.0-develop.cba048b0d7",
   "description": "TypeScript SDK and CLI for building, running, and deploying Phoenix configurator applications.",
   "keywords": [
     "salsita",
@@ -13,6 +13,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.13"
+  },
   "type": "module",
   "imports": {
     "#package/admin": {
@@ -196,7 +199,7 @@
     "domain-cli": "dist/legacy/domain-cli/cli.js",
     "embedding-cli": "dist/legacy/embedding-cli/cli.js",
     "webhook-cli": "dist/legacy/webhook-cli/cli.js",
-    "phoenix": "dist/phoenix/cli.js"
+    "phoenix": "dist/phoenix/bin.js"
   },
   "files": [
     "dist",
@@ -204,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",
@@ -212,7 +225,11 @@
     "@emotion/cache": "11.11.0",
     "@fontsource-variable/roboto": "5.2.5",
     "@gltf-transform/core": "4.3.0",
+    "@lingui/babel-plugin-lingui-macro": "5.9.5",
+    "@lingui/cli": "5.9.5",
+    "@lingui/conf": "5.9.5",
     "@lingui/message-utils": "5.9.5",
+    "@lingui/swc-plugin": "5.11.0",
     "@lingui/vite-plugin": "5.9.5",
     "@monaco-editor/react": "4.7.0",
     "@mui/utils": "5.17.1",
@@ -224,6 +241,7 @@
     "@trpc/react-query": "11.17.0",
     "@trpc/server": "11.17.0",
     "@types/aws-lambda": "8.10.133",
+    "@typescript/native": "npm:typescript@7.0.2",
     "@uiw/color-convert": "2.9.6",
     "@uiw/react-color-hue": "2.9.6",
     "@uiw/react-color-saturation": "2.9.6",
@@ -239,10 +257,12 @@
     "dotenv-expand": "10.0.0",
     "envalid": "8.1.1",
     "esbuild": "0.25.12",
+    "eslint": "9.39.4",
     "fs-extra": "11.2.0",
     "globby": "14.0.2",
     "graphql": "16.14.2",
     "html-to-text": "10.0.0",
+    "htmlparser2": "10.1.0",
     "ink": "5.2.1",
     "its-fine": "1.2.5",
     "jiti": "2.7.0",
@@ -259,6 +279,7 @@
     "openai": "7.23.0",
     "openapi-fetch": "0.9.2",
     "picomatch": "4.0.4",
+    "prettier": "3.8.3",
     "promise-queue": "2.2.5",
     "react-device-detect": "2.2.3",
     "react-dnd": "16.0.1",
@@ -276,6 +297,7 @@
     "three-stdlib": "2.36.1",
     "troika-three-text": "0.47.2",
     "ts-pattern": "5.9.0",
+    "typescript": "6.0.3",
     "use-font-face-observer": "1.2.2",
     "usehooks-ts": "3.1.0",
     "uuid": "14.0.0",
@@ -286,19 +308,17 @@
     "yaml": "2.9.0",
     "yargs": "17.7.2",
     "zod": "3.25.76",
-    "@salsita-ai/common": "0.50.0-develop.ca72986c39",
-    "@salsita-ai/contracts": "0.50.0-develop.ca72986c39"
+    "@salsita-ai/common": "0.50.0-develop.cba048b0d7",
+    "@salsita-ai/contracts": "0.50.0-develop.cba048b0d7"
   },
   "devDependencies": {
     "@clerk/clerk-react": "5.61.8",
     "@emotion/react": "11.11.3",
     "@emotion/styled": "11.11.0",
-    "@lingui/cli": "5.9.5",
     "@lingui/core": "5.9.5",
     "@lingui/format-po": "5.9.5",
     "@lingui/macro": "5.9.5",
     "@lingui/react": "5.9.5",
-    "@lingui/swc-plugin": "5.11.0",
     "@mui/material": "5.15.5",
     "@mui/system": "5.16.7",
     "@phosphor-icons/core": "2.1.1",
@@ -332,19 +352,16 @@
     "babel-plugin-macros": "3.1.0",
     "buffer": "6.0.3",
     "chokidar-cli": "3.0.0",
-    "eslint": "9.39.4",
     "happy-dom": "20.9.0",
     "ink-testing-library": "4.0.0",
     "openapi-typescript": "7.4.1",
     "postprocessing": "6.36.3",
-    "prettier": "3.8.3",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "rxjs": "7.8.2",
     "storybook": "10.4.1",
     "three": "0.160.1",
     "tsx": "4.22.3",
-    "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "4.1.11",
     "server": "1.64.0"
   },
@@ -363,7 +380,7 @@
     "@types/react": "^18.3.8",
     "@types/react-dom": "^18.3.0",
     "@types/three": "^0.160.0",
-    "postprocessing": "^6.36.3",
+    "postprocessing": "~6.36.3",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "rxjs": "^7.8.2",
@@ -399,6 +416,7 @@
     "prettify:fix": "prettier --write .",
     "verify:fix": "pnpm build && pnpm run ts:check && pnpm docs:verify && pnpm lint:fix && pnpm prettify:fix && pnpm test",
     "test": "vitest run",
-    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1"
+    "ts:check": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.build.json --emitDeclarationOnly --noEmit --checkers 1 && pnpm ts:check:tests",
+    "ts:check:tests": "NODE_OPTIONS=\"--max-old-space-size=8192\" tsc --project ./tsconfig.test.json --noEmit --checkers 1"
   }
 }