@optiaxiom/proteus 0.2.4 → 0.2.6

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: [
@@ -4663,24 +4717,31 @@ var definitions = {
 				description: "Chart layout direction"
 			},
 			series: {
-				description: "Data series configuration",
-				items: {
-					properties: {
-						dataKey: {
-							description: "Key in data records for this series",
-							type: "string"
+				anyOf: [
+					{
+						description: "Data series configuration",
+						items: {
+							properties: {
+								dataKey: {
+									description: "Key in data records for this series",
+									type: "string"
+								},
+								name: {
+									description: "Display name for legend",
+									type: "string"
+								}
+							},
+							required: [
+								"dataKey"
+							],
+							type: "object"
 						},
-						name: {
-							description: "Display name for legend",
-							type: "string"
-						}
+						type: "array"
 					},
-					required: [
-						"dataKey"
-					],
-					type: "object"
-				},
-				type: "array"
+					{
+						$ref: "#/definitions/ProteusExpression"
+					}
+				]
 			},
 			type: {
 				anyOf: [
@@ -5049,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: [
 			{

package/dist/index.d.ts

@@ -38,7 +38,7 @@ type ProteusChartProps = {
     /**
      * Data series configuration
      */
-    series: Series[];
+    series?: Series[];
     /**
      * Chart type
      */
@@ -57,7 +57,7 @@ type ProteusDataTableProps = {
     /**
      * Column definitions
      */
-    columns: ColumnDef[];
+    columns?: ColumnDef[];
     /**
      * Column data
      */
@@ -77,6 +77,28 @@ declare const ProteusDataTable: {
     displayName: string;
 };
 
+type ProteusFileUploadProps = {
+    /**
+     * File types to accept; array of MIME types or extensions.
+     *
+     * @example ["image/*", ".pdf"]
+     */
+    accept?: string[];
+    /**
+     * The name of the form control element. The resolved URL is written at
+     * `parentPath/name` in form data once the host's `onUpload` resolves.
+     */
+    name?: string;
+    /**
+     * Whether a file is required.
+     */
+    required?: boolean;
+};
+declare function ProteusFileUpload({ accept, name }: ProteusFileUploadProps): react_jsx_runtime.JSX.Element;
+declare namespace ProteusFileUpload {
+    var displayName: string;
+}
+
 type ProteusImageCarouselProps = {
     /**
      * Array of image data to display in the carousel.
@@ -213,6 +235,7 @@ type ProteusValueProps = {
     path: string;
 };
 
+type UploadFile = (file: File) => Promise<string>;
 type UseResource = (resource: string) => {
     data: undefined | {
         mimeType: string;
@@ -249,13 +272,20 @@ type ProteusDocumentShellProps = Pick<ComponentPropsWithoutRef<typeof Disclosure
      */
     onInteraction?: (name: string, params?: Record<string, unknown>) => Promise<unknown> | unknown;
     /**
-     * Callback when user sends a message action
+     * Callback when user sends a message action. The payload may be a plain
+     * string or a structured object (parts + optional files), depending on
+     * what the document declares for `Action.onClick.message`.
      */
-    onMessage?: (message: string) => Promise<void> | void;
+    onMessage?: (message: string | StructuredMessage) => Promise<void> | void;
     /**
      * Callback when an analytics event is fired
      */
     onTrack?: (event: string, properties: Record<string, string>) => void;
+    /**
+     * Async upload callback used by FileUpload elements. Receives a File and
+     * resolves to a URL string the document writes into form data.
+     */
+    onUpload?: UploadFile;
     /**
      * Whether form is readonly
      */
@@ -280,7 +310,7 @@ type ProteusDocument$2 = {
     title?: ReactNode;
     titleIcon?: string;
 };
-declare function ProteusDocumentShell({ collapsible: collapsibleProp, data, defaultOpen, element, onDataChange, onDownload, onInteraction, onMessage, onOpenChange, onTrack, open: openProp, readOnly, strict, useResource, }: ProteusDocumentShellProps): react_jsx_runtime.JSX.Element;
+declare function ProteusDocumentShell({ collapsible: collapsibleProp, data, defaultOpen, element, onDataChange, onDownload, onInteraction, onMessage, onOpenChange, onTrack, onUpload, open: openProp, readOnly, strict, useResource, }: ProteusDocumentShellProps): react_jsx_runtime.JSX.Element;
 declare namespace ProteusDocumentShell {
     var displayName: string;
 }
@@ -294,7 +324,14 @@ type ProteusEventHandler = {
     interaction: string;
     params?: Record<string, unknown>;
 } | {
-    message: string;
+    message: string | StructuredMessage;
+};
+type StructuredMessage = {
+    files?: string[];
+    parts: Array<{
+        content: string;
+        type: "text";
+    }>;
 };
 type ProteusDocument$1 = ProteusDocumentShellProps["element"] & {
     $type: "Document";
@@ -358,5 +395,5 @@ declare namespace ProteusTextarea {
 
 declare function useProteusValue(element: ProteusValueProps): any;
 
-export { ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDocumentRenderer, ProteusDocumentShell, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusMap, ProteusSelect, ProteusShow, ProteusTextarea, safeParseDocument, useProteusValue };
-export type { ProteusDocumentRendererProps, ProteusDocumentShellProps };
+export { ProteusAction, ProteusBridge, ProteusChart, ProteusDataTable, ProteusDocumentRenderer, ProteusDocumentShell, ProteusFileUpload, ProteusImage, ProteusImageCarousel, ProteusInput, ProteusMap, ProteusSelect, ProteusShow, ProteusTextarea, safeParseDocument, useProteusValue };
+export type { ProteusDocumentRendererProps, ProteusDocumentShellProps, ProteusFileUploadProps, StructuredMessage, UploadFile };