@optiaxiom/proteus 0.2.11 → 0.2.12

package/dist/esm/assets/src/proteus-chart/{ProteusChart.css.ts.vanilla-Bhea5BpW.css → ProteusChart.css.ts.vanilla-B_WDPh7C.css}

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

package/dist/esm/assets/src/proteus-chart/{ProteusChartTooltipContent.css.ts.vanilla-7xvqKrcf.css → ProteusChartTooltipContent.css.ts.vanilla-UZNvVvUU.css}

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-Bhea5BpW.css';
+import './../assets/src/proteus-chart/ProteusChart.css.ts.vanilla-B_WDPh7C.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/ProteusChartTooltipContent-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-7xvqKrcf.css';
+import './../assets/src/proteus-chart/ProteusChartTooltipContent.css.ts.vanilla-UZNvVvUU.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-document/ProteusDocumentShell-css.js

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-Bil1PxGV.css';
+import './../assets/src/proteus-document/ProteusDocumentShell.css.ts.vanilla-N08uRH65.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/resolveProteusValue.js

@@ -95,6 +95,7 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
           [...mapIndices, index]
         )
       ).filter((v) => v !== void 0);
+      const result = "flat" in value && value.flat ? items.flat() : items;
       if ("separator" in value) {
         const sep = resolveProteusValue(
           value.separator,
@@ -102,9 +103,9 @@ function resolveProteusValue(value, data, parentPath, mapIndices = []) {
           parentPath,
           mapIndices
         );
-        return items.join(typeof sep === "string" ? sep : "");
+        return result.join(typeof sep === "string" ? sep : "");
       }
-      return items;
+      return result;
     }
     if (value.$type === "Show" && "when" in value && "children" in value) {
       const conditions = Array.isArray(value.when) ? value.when : [value.when];

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

@@ -1,7 +1,8 @@
 "use client";
 import { jsxs, jsx } from 'react/jsx-runtime';
+import { IconPlus } from '@optiaxiom/icons';
 import { Flex } from '@optiaxiom/react';
-import { FileUpload, VisuallyHidden, FileUploadList, FileUploadDropzone, FileUploadTrigger } from '@optiaxiom/react/unstable';
+import { FileUpload, VisuallyHidden, FileUploadTrigger, FileUploadList, FileUploadDropzone } from '@optiaxiom/react/unstable';
 import { useRef, useState, useCallback } from 'react';
 import { useObserveValue } from '../hooks/useObserveValue.js';
 import { useProteusDocumentContext } from '../proteus-document/ProteusDocumentContext.js';
@@ -9,8 +10,9 @@ import { useProteusDocumentPathContext } from '../proteus-document/ProteusDocume
 
 function ProteusFileUpload({
   accept,
-  name,
-  required
+  maxFiles,
+  minFiles = 0,
+  name
 }) {
   const { onDataChange, onUpload, readOnly } = useProteusDocumentContext(
     "@optiaxiom/proteus/ProteusFileUpload"
@@ -19,71 +21,100 @@ function ProteusFileUpload({
     "@optiaxiom/proteus/ProteusFileUpload"
   );
   const inputRef = useRef(null);
-  const [item, setItem] = useState(null);
+  const itemsRef = useRef([]);
+  const [items, setItems] = useState([]);
   const forceValueChange = useObserveValue(inputRef);
-  const writeUrl = useCallback(
-    (url) => {
-      if (!name)
-        return;
-      onDataChange?.(`${parentPath}/${name}`, url);
-    },
-    [name, onDataChange, parentPath]
-  );
+  const multiple = maxFiles !== 1;
+  const atMax = multiple && maxFiles !== void 0 && items.length >= maxFiles;
+  const writeValue = useCallback(() => {
+    setItems(itemsRef.current);
+    if (inputRef.current) {
+      forceValueChange(
+        itemsRef.current.filter((item) => item.status === "complete").length.toString()
+      );
+    }
+    if (name) {
+      const value = itemsRef.current.filter((item) => item.status === "complete").map((item) => item.metadata).filter((metadata) => !!metadata);
+      onDataChange?.(`${parentPath}/${name}`, value);
+    }
+  }, [forceValueChange, name, onDataChange, parentPath]);
   const handleFilesDrop = useCallback(
     async (incoming) => {
+      if (multiple) {
+        incoming = maxFiles !== void 0 ? incoming.slice(0, Math.max(0, maxFiles - itemsRef.current.length)) : incoming;
+      } else {
+        incoming = incoming.slice(0, 1);
+      }
       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
-        );
-      }
+      itemsRef.current = [
+        ...multiple ? itemsRef.current : [],
+        ...incoming.map((file) => ({ file, status: "uploading" }))
+      ];
+      writeValue();
+      const result = new Map(
+        await Promise.all(
+          incoming.map(
+            (file) => onUpload(file).then(
+              (metadata) => [
+                file,
+                {
+                  file,
+                  metadata,
+                  status: "complete"
+                }
+              ]
+            ).catch(
+              () => [
+                file,
+                {
+                  file,
+                  status: "error"
+                }
+              ]
+            )
+          )
+        )
+      );
+      itemsRef.current = itemsRef.current.map(
+        (item) => result.get(item.file) ?? item
+      );
+      writeValue();
     },
-    [forceValueChange, onUpload, readOnly, writeUrl]
+    [maxFiles, multiple, onUpload, readOnly, writeValue]
+  );
+  const handleRemove = useCallback(
+    (item) => {
+      itemsRef.current = itemsRef.current.filter((i) => i !== item);
+      writeValue();
+    },
+    [writeValue]
   );
-  const handleRemove = useCallback(() => {
-    setItem(null);
-    writeUrl(null);
-    if (inputRef.current) {
-      forceValueChange("");
-    }
-  }, [forceValueChange, writeUrl]);
   return /* @__PURE__ */ jsxs(
     FileUpload,
     {
       accept,
-      disabled: !onUpload || readOnly,
+      disabled: !onUpload || readOnly || atMax,
       onFilesDrop: handleFilesDrop,
       children: [
         /* @__PURE__ */ jsx(VisuallyHidden, { asChild: true, children: /* @__PURE__ */ jsx(
           "input",
           {
             "aria-hidden": true,
+            defaultValue: 0,
+            max: maxFiles !== void 0 ? String(maxFiles) : void 0,
+            min: String(minFiles),
             name,
             ref: inputRef,
-            required,
-            tabIndex: -1
+            tabIndex: -1,
+            type: "number"
           }
         ) }),
-        item ? /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: "8", children: [
-          /* @__PURE__ */ jsx(FileUploadList, { items: [item], onRemove: handleRemove }),
-          /* @__PURE__ */ jsx(FileUploadDropzone, { overlay: true })
+        items.length > 0 ? /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: "8", children: [
+          multiple && !atMax && /* @__PURE__ */ jsx(FileUploadTrigger, { alignSelf: "end", icon: /* @__PURE__ */ jsx(IconPlus, {}), children: "Add File" }),
+          /* @__PURE__ */ jsx(FileUploadList, { items, onRemove: handleRemove }),
+          !atMax && /* @__PURE__ */ jsx(FileUploadDropzone, { overlay: true })
         ] }) : /* @__PURE__ */ jsx(FileUploadDropzone, { children: /* @__PURE__ */ jsx(FileUploadTrigger, {}) })
       ]
     }

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

@@ -1,4 +1,4 @@
-import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-CKWS5NjD.css';
+import './../assets/src/proteus-image-carousel/ProteusImageCarousel.css.ts.vanilla-DPgPnDmb.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-B04UzIcJ.css';
+import './../assets/src/proteus-question/ProteusQuestion.css.ts.vanilla-BAhvFxEB.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

@@ -2194,8 +2194,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2231,8 +2231,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2268,8 +2268,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2305,8 +2305,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2342,8 +2342,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2379,8 +2379,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2461,7 +2461,7 @@ var definitions = {
 						items: {
 							$ref: "#/definitions/ProteusCondition"
 						},
-						minItems: 1,
+						minFiles: 1,
 						type: "array"
 					}
 				},
@@ -2482,7 +2482,7 @@ var definitions = {
 								}
 							]
 						},
-						minItems: 1,
+						minFiles: 1,
 						type: "array"
 					}
 				},
@@ -2979,13 +2979,25 @@ var definitions = {
 	},
 	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.",
+		description: "Structured message payload that lets file metadata travel as a typed list alongside the text parts, instead of being joined into the text.",
 		properties: {
 			files: {
 				anyOf: [
 					{
 						items: {
-							type: "string"
+							properties: {
+								link: {
+									type: "string"
+								},
+								name: {
+									type: "string"
+								}
+							},
+							required: [
+								"name",
+								"link"
+							],
+							type: "object"
 						},
 						type: "array"
 					},
@@ -2993,7 +3005,7 @@ var definitions = {
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "List of file URLs (typically signed URLs from a host upload)."
+				description: "List of uploaded file metadata objects (typically the host's onUpload return value). Hosts may attach additional fields beyond `name` and `link`."
 			},
 			parts: {
 				items: {
@@ -5233,27 +5245,38 @@ var definitions = {
 				},
 				type: "array"
 			},
-			name: {
+			maxFiles: {
 				anyOf: [
 					{
-						type: "string"
+						type: "number"
 					},
 					{
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "The name of the form control element. The resolved URL is written at parentPath/name in form data."
+				description: "Maximum number of files allowed. When set to 1 the field is in single-file mode; any other value (or omitted) allows multiple uploads."
 			},
-			required: {
+			minFiles: {
 				anyOf: [
 					{
-						type: "boolean"
+						type: "number"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "Minimum number of files required."
+			},
+			name: {
+				anyOf: [
+					{
+						type: "string"
 					},
 					{
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "Whether a file is required."
+				description: "The name of the form control element. The resolved metadata array is written at parentPath/name in form data."
 			}
 		},
 		required: [
@@ -6745,6 +6768,10 @@ var definitions = {
 				$ref: "#/definitions/ProteusNode",
 				description: "Template object to render for each item in the array. Value paths inside this template are relative to the current item (e.g., path='title' resolves to each item's 'title' field). Use a leading '/' to reference top-level data (e.g., path='/title' resolves to the root data's 'title')."
 			},
+			flat: {
+				description: "When true, flattens the result array by one level. Useful when each mapped item resolves to an array and you want a single flat list.",
+				type: "boolean"
+			},
 			path: {
 				description: "JSON pointer path to the source array in the data (e.g., '/results')",
 				type: "string"

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

@@ -2192,8 +2192,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2228,8 +2228,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2264,8 +2264,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2300,8 +2300,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2336,8 +2336,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2372,8 +2372,8 @@ var definitions = {
 								}
 							]
 						},
-						maxItems: 2,
-						minItems: 2,
+						maxFiles: 2,
+						minFiles: 2,
 						type: "array"
 					}
 				},
@@ -2451,7 +2451,7 @@ var definitions = {
 						items: {
 							$ref: "#/definitions/ProteusCondition"
 						},
-						minItems: 1,
+						minFiles: 1,
 						type: "array"
 					}
 				},
@@ -2471,7 +2471,7 @@ var definitions = {
 								}
 							]
 						},
-						minItems: 1,
+						minFiles: 1,
 						type: "array"
 					}
 				},
@@ -2962,13 +2962,25 @@ 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.",
+		description: "Structured message payload that lets file metadata travel as a typed list alongside the text parts, instead of being joined into the text.",
 		properties: {
 			files: {
 				anyOf: [
 					{
 						items: {
-							type: "string"
+							properties: {
+								link: {
+									type: "string"
+								},
+								name: {
+									type: "string"
+								}
+							},
+							required: [
+								"name",
+								"link"
+							],
+							type: "object"
 						},
 						type: "array"
 					},
@@ -2976,7 +2988,7 @@ var definitions = {
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "List of file URLs (typically signed URLs from a host upload)."
+				description: "List of uploaded file metadata objects (typically the host's onUpload return value). Hosts may attach additional fields beyond `name` and `link`."
 			},
 			parts: {
 				items: {
@@ -5197,27 +5209,38 @@ var definitions = {
 				},
 				type: "array"
 			},
-			name: {
+			maxFiles: {
 				anyOf: [
 					{
-						type: "string"
+						type: "number"
 					},
 					{
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "The name of the form control element. The resolved URL is written at parentPath/name in form data."
+				description: "Maximum number of files allowed. When set to 1 the field is in single-file mode; any other value (or omitted) allows multiple uploads."
 			},
-			required: {
+			minFiles: {
 				anyOf: [
 					{
-						type: "boolean"
+						type: "number"
+					},
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				],
+				description: "Minimum number of files required."
+			},
+			name: {
+				anyOf: [
+					{
+						type: "string"
 					},
 					{
 						$ref: "#/definitions/ProteusExpression"
 					}
 				],
-				description: "Whether a file is required."
+				description: "The name of the form control element. The resolved metadata array is written at parentPath/name in form data."
 			}
 		},
 		required: [
@@ -6700,6 +6723,10 @@ var definitions = {
 				$ref: "#/definitions/ProteusNode",
 				description: "Template object to render for each item in the array. Value paths inside this template are relative to the current item (e.g., path='title' resolves to each item's 'title' field). Use a leading '/' to reference top-level data (e.g., path='/title' resolves to the root data's 'title')."
 			},
+			flat: {
+				description: "When true, flattens the result array by one level. Useful when each mapped item resolves to an array and you want a single flat list.",
+				type: "boolean"
+			},
 			path: {
 				description: "JSON pointer path to the source array in the data (e.g., '/results')",
 				type: "string"