@habit.analytics/habit-claims-journey-components 2.3.3 → 2.3.4

package/README.md

@@ -420,6 +420,51 @@ See [docs/SCHEMAS.md](./docs/SCHEMAS.md) for the full reference of required fiel
 | `v2_phone-1` | Phone with country code | Length check |
 | `v2_email-1` | Email input | Format regex |
 
+### Upload Configuration (`uploadConfig`)
+
+```ts
+interface UploadConfig {
+  accept?: string;           // MIME types or extensions (e.g. "image/*,.pdf")
+  maxSizeMB?: number;        // Max file size in MB
+  multiple?: boolean;        // When true, allows multiple files
+  maxFiles?: number;         // Max number of files (when multiple is true)
+}
+```
+
+Single-file upload (default): `uploadConfig` without `multiple` or with `multiple: false`.
+Multi-file upload: set `uploadConfig.multiple: true`. When `maxFiles` is set, the widget enforces the limit.
+
+### Multi-File Upload Example
+
+```ts
+{
+  "field_id": "f-photos",
+  "namespace": "claim.photos",
+  "label": "Photos",
+  "schema": "v2_single_asset_upload",
+  "widget": "upload",
+  "uploadConfig": {
+    "accept": "image/*,.pdf",
+    "maxSizeMB": 10,
+    "multiple": true,
+    "maxFiles": 5
+  }
+}
+```
+
+When `multiple: true`, the answer value in `onSubmit` is an array of `UploadResult`:
+
+```json
+{
+  "claim.photos": [
+    { "filename": "photo1.jpg", "url": "https://...", "mimetype": "image/jpeg", "size": 12345 },
+    { "filename": "photo2.jpg", "url": "https://...", "mimetype": "image/jpeg", "size": 67890 }
+  ]
+}
+```
+
+See [docs/MULTI-UPLOAD.md](./docs/MULTI-UPLOAD.md) for a full migration guide.
+
 Fields can override the default widget via `widget` (e.g. a `v1_string` rendered as `"textarea"` or `"email"`).
 
 ---

package/dist/components/journey-builder/preview-widgets/MultiUploadWidget.d.ts

@@ -0,0 +1,20 @@
+import { UploadResult } from '../../../types/journey';
+interface MultiUploadWidgetProps {
+    label: string;
+    value: UploadResult[];
+    onChange: (value: UploadResult[]) => void;
+    onFileSelect?: (file: File) => Promise<string | UploadResult | void> | void;
+    helpText?: string;
+    accept?: string;
+    maxSizeMB?: number;
+    maxFiles?: number;
+}
+/**
+ * Multi-file upload widget.
+ *
+ * Renders a drag-and-drop zone that accepts multiple files. Each selected
+ * file is validated (size + type) and then processed through `onFileSelect`.
+ * The widget maintains an internal array of uploaded results.
+ */
+export declare function MultiUploadWidget({ label, value, onChange, onFileSelect, helpText, accept, maxSizeMB, maxFiles, }: MultiUploadWidgetProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/i18n/locales/en.d.ts

@@ -89,6 +89,7 @@ declare const en: {
     readonly upload_accepted_types_placeholder: "e.g. image/*,.pdf";
     readonly upload_max_size: "Max file size (MB)";
     readonly upload_max_size_placeholder: "e.g. 10";
+    readonly upload_max_files: "Max number of files";
     readonly edge_props_title: "Edge Properties";
     readonly edge_connection: "Connection";
     readonly edge_default: "Default Edge";
@@ -130,7 +131,10 @@ declare const en: {
     readonly create_node_namespace_hint: "Auto-generated from label. Override if needed.";
     readonly create_node_schema: "Schema Type";
     readonly upload_drag_drop: "Drag & drop a file here, or click to select";
+    readonly upload_drag_drop_multiple: "Drag & drop files here, or click to select";
     readonly upload_uploading: "Uploading…";
+    readonly upload_files_count: "{{count}} file(s) uploaded";
+    readonly upload_max_reached: "Maximum {{max}} files reached";
     readonly widget_unknown_schema: "Unknown schema type: {{schema}}";
     readonly widget_yes: "Yes";
     readonly widget_no: "No";