@optiaxiom/proteus 0.2.5 → 0.2.7

package/dist/esm/assets/src/proteus-chart/{ProteusChart.css.ts.vanilla-DnNIn_rc.css → ProteusChart.css.ts.vanilla-BO0-TwP_.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1l0xsvj;
-@layer optiaxiom._1l0xsvj {
+@layer optiaxiom._1fgw1dd;
+@layer optiaxiom._1fgw1dd {
   .ProteusChart__jmlqij1 {
     border-radius: 16px;
   }

package/dist/esm/assets/src/proteus-chart/{ProteusChartTooltipContent.css.ts.vanilla-DoWJUTMo.css → ProteusChartTooltipContent.css.ts.vanilla-ETMXhILd.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1l0xsvj;
-@layer optiaxiom._1l0xsvj {
+@layer optiaxiom._1fgw1dd;
+@layer optiaxiom._1fgw1dd {
   .ProteusChartTooltipContent__1gsvq810 {
     min-width: 128px;
     position: absolute;

package/dist/esm/assets/src/proteus-document/{ProteusDocumentShell.css.ts.vanilla-DcaxxIIv.css → ProteusDocumentShell.css.ts.vanilla-CDxANCyw.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1l0xsvj;
-@layer optiaxiom._1l0xsvj {
+@layer optiaxiom._1fgw1dd;
+@layer optiaxiom._1fgw1dd {
   .ProteusDocumentShell__vpuvfj1 {
     margin: -4px;
   }

package/dist/esm/assets/src/proteus-image-carousel/{ProteusImageCarousel.css.ts.vanilla-DasQYQWd.css → ProteusImageCarousel.css.ts.vanilla-CVLALefb.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1l0xsvj;
-@layer optiaxiom._1l0xsvj {
+@layer optiaxiom._1fgw1dd;
+@layer optiaxiom._1fgw1dd {
   .ProteusImageCarousel__1t6qej70 {
     outline: none;
     user-select: none;

package/dist/esm/assets/src/proteus-question/{ProteusQuestion.css.ts.vanilla-DyMq_aV3.css → ProteusQuestion.css.ts.vanilla-DKDk8HIF.css}

@@ -1,5 +1,5 @@
-@layer optiaxiom._1l0xsvj;
-@layer optiaxiom._1l0xsvj {
+@layer optiaxiom._1fgw1dd;
+@layer optiaxiom._1fgw1dd {
   .ProteusQuestion__8f590p0 {
     outline: none;
   }

package/dist/esm/hooks/useObserveValue.js

@@ -0,0 +1,33 @@
+import { useEffect } from 'react';
+
+const useObserveValue = (inputRef, setValue) => {
+  useEffect(() => {
+    const input = inputRef.current;
+    if (!input) {
+      return;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(
+      input.constructor.prototype,
+      "value"
+    );
+    Object.defineProperty(input, "value", {
+      configurable: true,
+      enumerable: true,
+      get: function() {
+        return descriptor?.get?.call(input);
+      },
+      set: function(value) {
+        descriptor?.set?.call(input, value);
+      }
+    });
+  }, [inputRef, setValue]);
+  return (value) => {
+    if (!inputRef.current) {
+      return;
+    }
+    inputRef.current.value = value;
+    inputRef.current.dispatchEvent(new Event("change", { bubbles: true }));
+  };
+};
+
+export { useObserveValue };

package/dist/esm/index.js

@@ -5,6 +5,7 @@ export { ProteusDataTable } from './proteus-data-table/ProteusDataTable.js';
 export { ProteusDocumentRenderer } from './proteus-document/ProteusDocumentRenderer.js';
 export { ProteusDocumentShell } from './proteus-document/ProteusDocumentShell.js';
 export { safeParseDocument } from './proteus-document/schemas.js';
+export { ProteusFileUpload } from './proteus-file-upload/ProteusFileUpload.js';
 export { ProteusImage } from './proteus-image/ProteusImage.js';
 export { ProteusImageCarousel } from './proteus-image-carousel/ProteusImageCarousel.js';
 export { ProteusInput } from './proteus-input/ProteusInput.js';

package/dist/esm/proteus-chart/ProteusChart-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-DnNIn_rc.css';
+import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-BO0-TwP_.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var chart = recipe({base:[{border:'1',borderColor:'border.tertiary',fontSize:'sm',p:'16'},'ProteusChart__jmlqij1','ProteusChart__jmlqij0']});

package/dist/esm/proteus-chart/ProteusChart.js

@@ -69,7 +69,7 @@ const ProteusChart = ({
         portal: document.body
       }
     ),
-    series.map((s, i) => /* @__PURE__ */ jsx(
+    series?.map((s, i) => /* @__PURE__ */ jsx(
       Chart,
       {
         dataKey: (row) => get(row, "/" + s.dataKey),

package/dist/esm/proteus-chart/ProteusChartTooltipContent-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-DoWJUTMo.css';
+import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-ETMXhILd.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var tooltip = recipe({base:[{bg:'bg.default',border:'1',borderColor:'border.secondary',display:'grid',fontSize:'sm',gap:'6',pointerEvents:'none',px:'8',py:'10',rounded:'lg',shadow:'lg',transition:'all',z:'popover'},'ProteusChartTooltipContent__1gsvq810']});

package/dist/esm/proteus-data-table/ProteusDataTable.js

@@ -8,7 +8,7 @@ import { applyFormatter } from '../proteus-document/getProteusValue.js';
 const ProteusDataTable = ({ columns, data }) => {
   const tableData = data;
   const columnHelper = createColumnHelper();
-  const columnDefs = columns.map((col) => {
+  const columnDefs = (columns || []).map((col) => {
     return columnHelper.accessor(
       (row) => {
         const value = get(row, "/" + col.accessorKey);

package/dist/esm/proteus-document/ProteusDocumentShell-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-DcaxxIIv.css';
+import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-CDxANCyw.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var body = recipe({base:[{flexDirection:'column',gap:'16'},'ProteusDocumentShell__vpuvfj0'],variants:{truncate:{false:{},true:[{maxH:'sm',overflow:'auto',p:'4'},'ProteusDocumentShell__vpuvfj1']}}});

package/dist/esm/proteus-document/ProteusDocumentShell.js

@@ -21,6 +21,7 @@ function ProteusDocumentShell({
   onMessage,
   onOpenChange,
   onTrack,
+  onUpload,
   open: openProp,
   readOnly = false,
   strict,
@@ -101,6 +102,7 @@ function ProteusDocumentShell({
           onTrack?.(event, properties);
         }
       ),
+      onUpload,
       readOnly,
       strict,
       useResource,

package/dist/esm/proteus-document/resolveProteusValue.js

@@ -88,11 +88,13 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
       }
       const resolvedPath = value.path.startsWith("/") ? value.path : `${parentPath}/${value.path}`;
       const items = array.map(
-        (_, index) => resolveProteusValue(value.children, data, `${resolvedPath}/${index}`, [
-          ...mapIndices,
-          index
-        ])
-      );
+        (_, index) => resolveProteusValue(
+          value.children,
+          data,
+          `${resolvedPath}/${index}`,
+          [...mapIndices, index]
+        )
+      ).filter((v) => v !== void 0);
       if ("separator" in value) {
         const sep = resolveProteusValue(
           value.separator,
@@ -122,8 +124,18 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
         (child) => resolveProteusValue(child, data, parentPath, mapIndices)
       ).filter((v) => v !== void 0).join("");
     }
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((v) => resolveProteusValue(v, data, parentPath, mapIndices)).filter((v) => v !== void 0);
+  }
+  const resolved = {};
+  for (const [k, v] of Object.entries(value)) {
+    const r = resolveProteusValue(v, data, parentPath, mapIndices);
+    if (r !== void 0)
+      resolved[k] = r;
   }
-  return value;
+  return resolved;
 }
 
 export { evaluateCondition, resolveProteusValue };

package/dist/esm/proteus-element/ProteusElement.js

@@ -11,6 +11,7 @@ import { useProteusDocumentContext } from '../proteus-document/ProteusDocumentCo
 import { useProteusDocumentPathContext } from '../proteus-document/ProteusDocumentPathContext.js';
 import { resolveProteusProp } from '../proteus-document/resolveProteusProp.js';
 import { safeParseElement } from '../proteus-document/schemas.js';
+import { ProteusFileUpload } from '../proteus-file-upload/ProteusFileUpload.js';
 import { ProteusImageCarousel } from '../proteus-image-carousel/ProteusImageCarousel.js';
 import { ProteusImage } from '../proteus-image/ProteusImage.js';
 import { ProteusInput } from '../proteus-input/ProteusInput.js';
@@ -97,6 +98,8 @@ const ProteusElement = ({
       );
     case "Field":
       return /* @__PURE__ */ jsx(Field, { ...resolve(element) });
+    case "FileUpload":
+      return /* @__PURE__ */ jsx(ProteusFileUpload, { ...resolve(element) });
     case "Group":
       return /* @__PURE__ */ jsx(Group, { ...resolve(element) });
     case "Heading":

package/dist/esm/proteus-file-upload/ProteusFileUpload.js

@@ -0,0 +1,94 @@
+"use client";
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { Flex } from '@optiaxiom/react';
+import { FileUpload, VisuallyHidden, FileUploadList, FileUploadDropzone, FileUploadTrigger } from '@optiaxiom/react/unstable';
+import { useRef, useState, useCallback } from 'react';
+import { useObserveValue } from '../hooks/useObserveValue.js';
+import { useProteusDocumentContext } from '../proteus-document/ProteusDocumentContext.js';
+import { useProteusDocumentPathContext } from '../proteus-document/ProteusDocumentPathContext.js';
+
+function ProteusFileUpload({
+  accept,
+  name,
+  required
+}) {
+  const { onDataChange, onUpload, readOnly } = useProteusDocumentContext(
+    "@optiaxiom/proteus/ProteusFileUpload"
+  );
+  const { path: parentPath } = useProteusDocumentPathContext(
+    "@optiaxiom/proteus/ProteusFileUpload"
+  );
+  const inputRef = useRef(null);
+  const [item, setItem] = useState(null);
+  const forceValueChange = useObserveValue(inputRef);
+  const writeUrl = useCallback(
+    (url) => {
+      if (!name)
+        return;
+      onDataChange?.(`${parentPath}/${name}`, url);
+    },
+    [name, onDataChange, parentPath]
+  );
+  const handleFilesDrop = useCallback(
+    async (incoming) => {
+      if (!onUpload || readOnly || incoming.length === 0) {
+        return;
+      }
+      const file = incoming[0];
+      setItem({ file, status: "uploading" });
+      writeUrl(null);
+      if (inputRef.current) {
+        forceValueChange("");
+      }
+      try {
+        const url = await onUpload(file);
+        setItem(
+          (curr) => curr?.file === file ? { file, status: "complete" } : curr
+        );
+        writeUrl(url);
+        if (inputRef.current) {
+          forceValueChange("1");
+        }
+      } catch {
+        setItem(
+          (curr) => curr?.file === file ? { file, status: "error" } : curr
+        );
+      }
+    },
+    [forceValueChange, onUpload, readOnly, writeUrl]
+  );
+  const handleRemove = useCallback(() => {
+    setItem(null);
+    writeUrl(null);
+    if (inputRef.current) {
+      forceValueChange("");
+    }
+  }, [forceValueChange, writeUrl]);
+  return /* @__PURE__ */ jsxs(
+    FileUpload,
+    {
+      accept,
+      disabled: !onUpload || readOnly,
+      onFilesDrop: handleFilesDrop,
+      children: [
+        /* @__PURE__ */ jsx(VisuallyHidden, { asChild: true, children: /* @__PURE__ */ jsx(
+          "input",
+          {
+            "aria-hidden": true,
+            name,
+            ref: inputRef,
+            required,
+            tabIndex: -1
+          }
+        ) }),
+        item ? /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: "8", children: [
+          /* @__PURE__ */ jsx(FileUploadList, { items: [item], onRemove: handleRemove }),
+          /* @__PURE__ */ jsx(FileUploadDropzone, { overlay: true })
+        ] }) : /* @__PURE__ */ jsx(FileUploadDropzone, { children: /* @__PURE__ */ jsx(FileUploadTrigger, {}) })
+      ]
+    }
+  );
+}
+ProteusFileUpload.displayName = "@optiaxiom/proteus/ProteusFileUpload";
+
+export { ProteusFileUpload };

package/dist/esm/proteus-image-carousel/ProteusImageCarousel-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-DasQYQWd.css';
+import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-CVLALefb.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var carousel = recipe({base:[{flexDirection:'column',gap:'12'},'ProteusImageCarousel__1t6qej70']});

package/dist/esm/proteus-question/ProteusQuestion-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-DyMq_aV3.css';
+import './../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-DKDk8HIF.css';
 import { recipe } from '@optiaxiom/react/css-runtime';
 
 var addon = recipe({base:[{display:'grid',fontWeight:'500',placeItems:'center',rounded:'lg',size:'md',transition:'colors'},'ProteusQuestion__8f590p3'],variants:{cursor:{pointer:{cursor:'pointer'}}}});

package/dist/esm/schema/public-schema.json.js

@@ -2734,6 +2734,9 @@ var definitions = {
 			{
 				$ref: "#/definitions/ProteusField"
 			},
+			{
+				$ref: "#/definitions/ProteusFileUpload"
+			},
 			{
 				$ref: "#/definitions/ProteusGroup"
 			},
@@ -2833,9 +2836,12 @@ var definitions = {
 							},
 							{
 								type: "string"
+							},
+							{
+								$ref: "#/definitions/ProteusStructuredMessage"
 							}
 						],
-						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, or a Map expression."
+						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, a Map expression, or a structured payload with parts and files."
 					}
 				},
 				required: [
@@ -2932,6 +2938,56 @@ var definitions = {
 		],
 		description: "A Proteus node can be a string, number, boolean, null, a single element, or an array of these types (similar to ReactNode)"
 	},
+	ProteusStructuredMessage: {
+		additionalProperties: false,
+		description: "Structured message payload that lets file URLs travel as a typed list alongside the text parts, instead of being joined into the text.",
+		properties: {
+			files: {
+				anyOf: [
+					{
+						items: {
+							type: "string"
+						},
+						type: "array"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "List of file URLs (typically signed URLs from a host upload)."
+			},
+			parts: {
+				items: {
+					additionalProperties: false,
+					properties: {
+						content: {
+							anyOf: [
+								{
+									type: "string"
+								},
+								{
+									$ref: "#/definitions/ProteusExpression"
+								}
+							]
+						},
+						type: {
+							"const": "text"
+						}
+					},
+					required: [
+						"type",
+						"content"
+					],
+					type: "object"
+				},
+				type: "array"
+			}
+		},
+		required: [
+			"parts"
+		],
+		type: "object"
+	},
 	ProteusZip: {
 		additionalProperties: false,
 		description: "Zips multiple parallel arrays into an array of objects. Each key in 'sources' becomes a property in the resulting row objects.",
@@ -5087,6 +5143,53 @@ var definitions = {
 		],
 		type: "object"
 	},
+	ProteusFileUpload: {
+		additionalProperties: false,
+		examples: [
+			{
+				$type: "FileUpload",
+				name: "value"
+			}
+		],
+		properties: {
+			$type: {
+				"const": "FileUpload"
+			},
+			accept: {
+				description: "File types to accept; array of MIME types or extensions.",
+				items: {
+					type: "string"
+				},
+				type: "array"
+			},
+			name: {
+				anyOf: [
+					{
+						type: "string"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "The name of the form control element. The resolved URL is written at parentPath/name in form data."
+			},
+			required: {
+				anyOf: [
+					{
+						type: "boolean"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "Whether a file is required."
+			}
+		},
+		required: [
+			"$type"
+		],
+		type: "object"
+	},
 	ProteusGroup: {
 		additionalProperties: false,
 		examples: [

package/dist/esm/schema/runtime-schema.json.js

@@ -2722,6 +2722,9 @@ var definitions = {
 			{
 				$ref: "#/definitions/ProteusField"
 			},
+			{
+				$ref: "#/definitions/ProteusFileUpload"
+			},
 			{
 				$ref: "#/definitions/ProteusGroup"
 			},
@@ -2819,9 +2822,12 @@ var definitions = {
 							},
 							{
 								type: "string"
+							},
+							{
+								$ref: "#/definitions/ProteusStructuredMessage"
 							}
 						],
-						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, or a Map expression."
+						description: "Message to send to LLM via sendNewMessage(). Can be a string, a Value reference, a Map expression, or a structured payload with parts and files."
 					}
 				},
 				required: [
@@ -2917,6 +2923,54 @@ var definitions = {
 		],
 		description: "A Proteus node can be a string, number, boolean, null, a single element, or an array of these types (similar to ReactNode)"
 	},
+	ProteusStructuredMessage: {
+		description: "Structured message payload that lets file URLs travel as a typed list alongside the text parts, instead of being joined into the text.",
+		properties: {
+			files: {
+				anyOf: [
+					{
+						items: {
+							type: "string"
+						},
+						type: "array"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "List of file URLs (typically signed URLs from a host upload)."
+			},
+			parts: {
+				items: {
+					properties: {
+						content: {
+							anyOf: [
+								{
+									type: "string"
+								},
+								{
+									$ref: "#/definitions/ProteusExpression"
+								}
+							]
+						},
+						type: {
+							"const": "text"
+						}
+					},
+					required: [
+						"type",
+						"content"
+					],
+					type: "object"
+				},
+				type: "array"
+			}
+		},
+		required: [
+			"parts"
+		],
+		type: "object"
+	},
 	ProteusZip: {
 		description: "Zips multiple parallel arrays into an array of objects. Each key in 'sources' becomes a property in the resulting row objects.",
 		examples: [
@@ -5056,6 +5110,52 @@ var definitions = {
 		],
 		type: "object"
 	},
+	ProteusFileUpload: {
+		examples: [
+			{
+				$type: "FileUpload",
+				name: "value"
+			}
+		],
+		properties: {
+			$type: {
+				"const": "FileUpload"
+			},
+			accept: {
+				description: "File types to accept; array of MIME types or extensions.",
+				items: {
+					type: "string"
+				},
+				type: "array"
+			},
+			name: {
+				anyOf: [
+					{
+						type: "string"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "The name of the form control element. The resolved URL is written at parentPath/name in form data."
+			},
+			required: {
+				anyOf: [
+					{
+						type: "boolean"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "Whether a file is required."
+			}
+		},
+		required: [
+			"$type"
+		],
+		type: "object"
+	},
 	ProteusGroup: {
 		examples: [
 			{