@uipath/apollo-wind 2.50.0 → 2.51.0

package/dist/components/forms/metadata-form.js

@@ -6,13 +6,14 @@ import { z } from "zod/v4";
 import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "../ui/accordion.js";
 import { Button } from "../ui/button.js";
 import { ScrollableTabsList, Tabs, TabsContent, TabsTrigger } from "../ui/tabs.js";
+import { TooltipProvider } from "../ui/tooltip.js";
 import { deepEqual, get } from "../../lib/index.js";
 import { DataFetcher } from "./data-fetcher.js";
 import { FormFieldRenderer } from "./field-renderer.js";
 import { RulesEngine } from "./rules-engine.js";
-import { validationConfigToZod } from "./validation-converter.js";
+import { isEmptyFieldValue, validationConfigToZod } from "./validation-converter.js";
 const DEFAULT_PLUGINS = [];
-function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className, disabled = false, autoComplete, stepVariant = 'wizard', sectionVariant = 'card', activeStepId, onActiveStepChange }) {
+function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className, disabled = false, autoComplete, stepVariant = 'wizard', sectionVariant = 'card', activeStepId, onActiveStepChange, container = 'form' }) {
     const [currentStep, setCurrentStep] = useState(0);
     const [customComponents, setCustomComponents] = useState({});
     const [isInitialized, setIsInitialized] = useState(false);
@@ -24,6 +25,15 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     }, [
         schema
     ]);
+    const hasFieldTooltip = useMemo(()=>{
+        const sections = [
+            ...stableSchema.sections ?? [],
+            ...(stableSchema.steps ?? []).flatMap((step)=>step.sections)
+        ];
+        return sections.some((section)=>section.fields.some((field)=>void 0 !== field.tooltip));
+    }, [
+        stableSchema
+    ]);
     const zodSchema = useMemo(()=>buildZodSchema(stableSchema), [
         stableSchema
     ]);
@@ -73,12 +83,12 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     ]);
     const contextRef = useRef(context);
     contextRef.current = context;
-    const isInitializedRef = useRef(isInitialized);
-    isInitializedRef.current = isInitialized;
+    const initializingRef = useRef(false);
     useEffect(()=>{
         const subscription = watch((value, { name })=>{
             valuesRef.current = value;
-            if (!name || !isInitializedRef.current) return;
+            if (!name) return;
+            if (initializingRef.current) return;
             pluginsRef.current.forEach((plugin)=>{
                 plugin.onValueChange?.(name, get(value, name), contextRef.current);
             });
@@ -92,9 +102,17 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
         const initializeForm = async ()=>{
             if (stableSchema.initialData) {
                 const data = await loadInitialData(stableSchema.initialData, contextRef.current);
-                reset(data);
+                initializingRef.current = true;
+                try {
+                    reset(data);
+                } finally{
+                    initializingRef.current = false;
+                }
+            }
+            for (const plugin of plugins){
+                const result = plugin.onFormInit?.(contextRef.current);
+                if (result instanceof Promise) await result;
             }
-            for (const plugin of plugins)await plugin.onFormInit?.(contextRef.current);
             setIsInitialized(true);
         };
         initializeForm();
@@ -111,51 +129,89 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     const handleReset = useCallback(()=>reset(), [
         reset
     ]);
+    const allCustomComponents = useMemo(()=>{
+        const fromPlugins = {};
+        for (const plugin of plugins)Object.assign(fromPlugins, plugin.components);
+        return {
+            ...fromPlugins,
+            ...customComponents
+        };
+    }, [
+        plugins,
+        customComponents
+    ]);
+    const enterSwallowRef = useRef(null);
+    useEffect(()=>{
+        const node = enterSwallowRef.current;
+        if (!node) return;
+        const swallowEnter = (event)=>{
+            if ('Enter' !== event.key || event.defaultPrevented) return;
+            const target = event.target;
+            if (target instanceof HTMLInputElement && 'button' !== target.type) event.preventDefault();
+        };
+        node.addEventListener('keydown', swallowEnter);
+        return ()=>node.removeEventListener('keydown', swallowEnter);
+    }, [
+        container
+    ]);
     const renderContent = ()=>{
         if (stableSchema.steps) {
             if ('tabs' === stepVariant) return /*#__PURE__*/ jsx(TabbedStepForm, {
                 schema: stableSchema,
                 context: context,
-                customComponents: customComponents,
+                customComponents: allCustomComponents,
                 disabled: disabled,
                 sectionVariant: sectionVariant,
                 activeStepId: activeStepId,
                 onActiveStepChange: onActiveStepChange,
-                onReset: handleReset
+                onReset: handleReset,
+                onSubmit: 'div' === container ? handleFormSubmit : void 0
             });
             return /*#__PURE__*/ jsx(metadata_form_MultiStepForm, {
                 schema: stableSchema,
                 context: context,
                 currentStep: currentStep,
                 setCurrentStep: setCurrentStep,
-                customComponents: customComponents,
+                customComponents: allCustomComponents,
                 disabled: disabled,
-                sectionVariant: sectionVariant
+                sectionVariant: sectionVariant,
+                onSubmit: 'div' === container ? handleFormSubmit : void 0
             });
         }
         return /*#__PURE__*/ jsx(metadata_form_SinglePageForm, {
             schema: stableSchema,
             context: context,
-            customComponents: customComponents,
+            customComponents: allCustomComponents,
             disabled: disabled,
             sectionVariant: sectionVariant
         });
     };
+    const content = /*#__PURE__*/ jsxs(Fragment, {
+        children: [
+            renderContent(),
+            !stableSchema.steps && /*#__PURE__*/ jsx(metadata_form_FormActions, {
+                schema: stableSchema,
+                context: context,
+                onReset: handleReset,
+                onSubmit: 'div' === container ? handleFormSubmit : void 0
+            })
+        ]
+    });
+    const body = 'div' === container ? /*#__PURE__*/ jsx("div", {
+        className: className,
+        ref: enterSwallowRef,
+        children: content
+    }) : /*#__PURE__*/ jsx("form", {
+        onSubmit: handleFormSubmit,
+        className: className,
+        autoComplete: autoComplete,
+        children: content
+    });
     return /*#__PURE__*/ jsx(FormProvider, {
         ...form,
-        children: /*#__PURE__*/ jsxs("form", {
-            onSubmit: handleFormSubmit,
-            className: className,
-            autoComplete: autoComplete,
-            children: [
-                renderContent(),
-                !stableSchema.steps && /*#__PURE__*/ jsx(metadata_form_FormActions, {
-                    schema: stableSchema,
-                    context: context,
-                    onReset: handleReset
-                })
-            ]
-        })
+        children: hasFieldTooltip ? /*#__PURE__*/ jsx(TooltipProvider, {
+            children: body
+        }) : body
     });
 }
 function conditionDependencies(conditionGroups) {
@@ -187,7 +243,7 @@ const metadata_form_SinglePageForm = /*#__PURE__*/ react.memo(function({ schema,
             }, section.id))
     });
 });
-const metadata_form_MultiStepForm = /*#__PURE__*/ react.memo(function({ schema, context, currentStep, setCurrentStep, customComponents, disabled, sectionVariant }) {
+const metadata_form_MultiStepForm = /*#__PURE__*/ react.memo(function({ schema, context, currentStep, setCurrentStep, customComponents, disabled, sectionVariant, onSubmit }) {
     const steps = schema.steps || [];
     const conditionFields = useMemo(()=>conditionDependencies(schema.steps?.map((step)=>step.conditions) ?? []), [
         schema
@@ -265,7 +321,8 @@ const metadata_form_MultiStepForm = /*#__PURE__*/ react.memo(function({ schema,
                         variant: "default",
                         children: "Next"
                     }) : /*#__PURE__*/ jsx(Button, {
-                        type: "submit",
+                        type: onSubmit ? 'button' : 'submit',
+                        onClick: onSubmit,
                         variant: "default",
                         children: "Submit"
                     })
@@ -274,7 +331,7 @@ const metadata_form_MultiStepForm = /*#__PURE__*/ react.memo(function({ schema,
         ]
     });
 });
-function TabbedStepForm({ schema, context, customComponents, disabled, sectionVariant, onReset, activeStepId, onActiveStepChange }) {
+function TabbedStepForm({ schema, context, customComponents, disabled, sectionVariant, onReset, activeStepId, onActiveStepChange, onSubmit }) {
     const steps = schema.steps || [];
     const conditionFields = useMemo(()=>conditionDependencies(schema.steps?.flatMap((step)=>[
                 step.conditions,
@@ -340,7 +397,7 @@ function TabbedStepForm({ schema, context, customComponents, disabled, sectionVa
                                             role: "img",
                                             "aria-label": `${errorCount} ${1 === errorCount ? 'issue' : 'issues'}`,
                                             title: `${errorCount} ${1 === errorCount ? 'issue' : 'issues'}`,
-                                            className: "grid h-4 min-w-4 place-items-center rounded-full bg-error px-1 text-[10px] font-semibold leading-none text-foreground-on-accent",
+                                            className: "grid h-4 min-w-4 place-items-center rounded-full bg-error px-1 text-[10px] font-semibold leading-none text-error-background",
                                             children: errorCount
                                         })
                                     ]
@@ -373,7 +430,8 @@ function TabbedStepForm({ schema, context, customComponents, disabled, sectionVa
             /*#__PURE__*/ jsx(metadata_form_FormActions, {
                 schema: schema,
                 context: context,
-                onReset: onReset
+                onReset: onReset,
+                onSubmit: onSubmit
             })
         ]
     });
@@ -455,7 +513,7 @@ const metadata_form_FormSection = /*#__PURE__*/ react.memo(function({ section, c
         ]
     });
 });
-const metadata_form_FormActions = /*#__PURE__*/ react.memo(function({ schema, context, onReset }) {
+const metadata_form_FormActions = /*#__PURE__*/ react.memo(function({ schema, context, onReset, onSubmit }) {
     const { isSubmitting } = useFormState({
         control: context.form.control
     });
@@ -484,7 +542,8 @@ const metadata_form_FormActions = /*#__PURE__*/ react.memo(function({ schema, co
                 children: action.label
             }, action.id);
             return /*#__PURE__*/ jsx(Button, {
-                type: 'submit' === action.type ? 'submit' : 'button',
+                type: 'submit' !== action.type || onSubmit ? 'button' : 'submit',
+                onClick: 'submit' === action.type && onSubmit ? onSubmit : void 0,
                 variant: action.variant || 'default',
                 disabled: action.disabled || 'submit' === action.type && isSubmitting,
                 children: action.loading && isSubmitting ? 'Loading...' : action.label
@@ -515,7 +574,7 @@ function buildZodSchema(schema) {
         } : shouldIncludeRequiredInBase ? {
             required: true
         } : void 0;
-        shape[field.name] = validationConfigToZod(validationConfig, field.type);
+        shape[field.name] = validationConfigToZod(validationConfig, field.type, 'custom' === field.type ? field.valueType : void 0);
     });
     const baseSchema = z.object(shape);
     if (0 === dynamicValidationFields.length) return baseSchema;
@@ -527,9 +586,7 @@ function buildZodSchema(schema) {
             const ruleResult = RulesEngine.applyRules(rules, values, {});
             const isRequired = true === ruleResult.required || staticRequired;
             if (isRequired) {
-                const value = values[name];
-                const isEmpty = null == value || '' === value || Array.isArray(value) && 0 === value.length;
-                if (isEmpty) ctx.addIssue({
+                if (isEmptyFieldValue(values[name])) ctx.addIssue({
                     code: z.ZodIssueCode.custom,
                     message: customRequiredMessage || 'This field is required',
                     path: [
@@ -544,4 +601,4 @@ async function loadInitialData(initialData, _context) {
     if (!initialData) return {};
     return initialData;
 }
-export { MetadataForm };
+export { MetadataForm, useWatch };

package/dist/components/forms/rules-engine.cjs

@@ -76,12 +76,23 @@ class RulesEngine {
         return state;
     }
     static evaluateExpression(expression, values) {
+        const result = RulesEngine.tryEvaluateExpression(expression, values);
+        if (result.ok) return result.value;
+        console.error('Expression evaluation error:', result.error);
+        return false;
+    }
+    static tryEvaluateExpression(expression, values) {
         try {
             const ast = external_jsep_default()(expression);
-            return RulesEngine.evaluateNode(ast, values);
+            return {
+                ok: true,
+                value: RulesEngine.evaluateNode(ast, values)
+            };
         } catch (error) {
-            console.error('Expression evaluation error:', error);
-            return false;
+            return {
+                ok: false,
+                error
+            };
         }
     }
     static evaluateNode(node, values) {

package/dist/components/forms/rules-engine.d.ts

@@ -33,6 +33,22 @@ export declare class RulesEngine {
      * - "total >= 100 ? 'discount' : 'regular'"
      */
     static evaluateExpression(expression: string, values: Record<string, unknown>): unknown;
+    /**
+     * Like `evaluateExpression`, but reports *why* there is no value.
+     *
+     * `evaluateExpression` returns `false` both for an expression that legitimately evaluates
+     * to false and for one the evaluator cannot handle at all — `value.some(x)` parses fine and
+     * then throws on the unsupported `CallExpression`. Callers that treat falsey as "failed the
+     * check" would turn an unsupported expression into a permanently failing one, so they need
+     * to tell the two apart.
+     */
+    static tryEvaluateExpression(expression: string, values: Record<string, unknown>): {
+        ok: true;
+        value: unknown;
+    } | {
+        ok: false;
+        error: unknown;
+    };
     /**
      * Minimal AST evaluator - only supports operators needed for form rules
      */

package/dist/components/forms/rules-engine.js

@@ -36,12 +36,23 @@ class RulesEngine {
         return state;
     }
     static evaluateExpression(expression, values) {
+        const result = RulesEngine.tryEvaluateExpression(expression, values);
+        if (result.ok) return result.value;
+        console.error('Expression evaluation error:', result.error);
+        return false;
+    }
+    static tryEvaluateExpression(expression, values) {
         try {
             const ast = jsep(expression);
-            return RulesEngine.evaluateNode(ast, values);
+            return {
+                ok: true,
+                value: RulesEngine.evaluateNode(ast, values)
+            };
         } catch (error) {
-            console.error('Expression evaluation error:', error);
-            return false;
+            return {
+                ok: false,
+                error
+            };
         }
     }
     static evaluateNode(node, values) {

package/dist/components/forms/schema-serializer.cjs

@@ -180,6 +180,8 @@ function serializeField(field) {
     if (field.grid) result.grid = field.grid;
     if (field.ariaLabel) result.ariaLabel = field.ariaLabel;
     if (field.ariaDescribedBy) result.ariaDescribedBy = field.ariaDescribedBy;
+    if (field.tooltip) result.tooltip = field.tooltip;
+    if (field.tooltipAriaLabel) result.tooltipAriaLabel = field.tooltipAriaLabel;
     if ('options' in field && field.options) result.options = serializeOptions(field.options);
     if ('rows' in field && field.rows) result.rows = field.rows;
     if ('min' in field && void 0 !== field.min) result.min = field.min;
@@ -191,7 +193,15 @@ function serializeField(field) {
     if ('maxSize' in field && field.maxSize) result.maxSize = field.maxSize;
     if ('showPreview' in field && field.showPreview) result.showPreview = field.showPreview;
     if ('use12Hour' in field && field.use12Hour) result.use12Hour = field.use12Hour;
+    if ('minRows' in field && void 0 !== field.minRows) result.minRows = field.minRows;
+    if ('maxLength' in field && void 0 !== field.maxLength) result.maxLength = field.maxLength;
+    if ('maxItems' in field && void 0 !== field.maxItems) result.maxItems = field.maxItems;
+    if ('emptyMessage' in field && field.emptyMessage) result.emptyMessage = field.emptyMessage;
+    if ('searchPlaceholder' in field && field.searchPlaceholder) result.searchPlaceholder = field.searchPlaceholder;
+    if ('addItemLabel' in field && field.addItemLabel) result.addItemLabel = field.addItemLabel;
+    if ('removeItemAriaLabel' in field && field.removeItemAriaLabel) result.removeItemAriaLabel = field.removeItemAriaLabel;
     if ('component' in field && field.component) result.component = field.component;
+    if ('valueType' in field && field.valueType) result.valueType = field.valueType;
     if ('componentProps' in field && field.componentProps) result.componentProps = field.componentProps;
     return result;
 }

package/dist/components/forms/schema-serializer.js

@@ -151,6 +151,8 @@ function serializeField(field) {
     if (field.grid) result.grid = field.grid;
     if (field.ariaLabel) result.ariaLabel = field.ariaLabel;
     if (field.ariaDescribedBy) result.ariaDescribedBy = field.ariaDescribedBy;
+    if (field.tooltip) result.tooltip = field.tooltip;
+    if (field.tooltipAriaLabel) result.tooltipAriaLabel = field.tooltipAriaLabel;
     if ('options' in field && field.options) result.options = serializeOptions(field.options);
     if ('rows' in field && field.rows) result.rows = field.rows;
     if ('min' in field && void 0 !== field.min) result.min = field.min;
@@ -162,7 +164,15 @@ function serializeField(field) {
     if ('maxSize' in field && field.maxSize) result.maxSize = field.maxSize;
     if ('showPreview' in field && field.showPreview) result.showPreview = field.showPreview;
     if ('use12Hour' in field && field.use12Hour) result.use12Hour = field.use12Hour;
+    if ('minRows' in field && void 0 !== field.minRows) result.minRows = field.minRows;
+    if ('maxLength' in field && void 0 !== field.maxLength) result.maxLength = field.maxLength;
+    if ('maxItems' in field && void 0 !== field.maxItems) result.maxItems = field.maxItems;
+    if ('emptyMessage' in field && field.emptyMessage) result.emptyMessage = field.emptyMessage;
+    if ('searchPlaceholder' in field && field.searchPlaceholder) result.searchPlaceholder = field.searchPlaceholder;
+    if ('addItemLabel' in field && field.addItemLabel) result.addItemLabel = field.addItemLabel;
+    if ('removeItemAriaLabel' in field && field.removeItemAriaLabel) result.removeItemAriaLabel = field.removeItemAriaLabel;
     if ('component' in field && field.component) result.component = field.component;
+    if ('valueType' in field && field.valueType) result.valueType = field.valueType;
     if ('componentProps' in field && field.componentProps) result.componentProps = field.componentProps;
     return result;
 }

package/dist/components/forms/string-list-field.cjs

@@ -0,0 +1,154 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    formatTemplate: ()=>formatTemplate,
+    StringListField: ()=>StringListField
+});
+const jsx_runtime_namespaceObject = require("react/jsx-runtime");
+const external_lucide_react_namespaceObject = require("lucide-react");
+const external_react_namespaceObject = require("react");
+const button_cjs_namespaceObject = require("../ui/button.cjs");
+const form_field_cjs_namespaceObject = require("../ui/form-field.cjs");
+const textarea_cjs_namespaceObject = require("../ui/textarea.cjs");
+function formatTemplate(template, values) {
+    return template.replace(/\{\{(\w+)\}\}/g, (match, token)=>token in values ? String(values[token]) : match);
+}
+function StringListField({ field, value, onChange, onBlur, error, disabled = false, required = false, inputRef }) {
+    const items = value ?? [];
+    const maxItems = field.maxItems ?? 1 / 0;
+    const canAdd = !disabled && items.length < maxItems;
+    const addItemLabel = field.addItemLabel ?? 'Add';
+    const removeItemAriaLabel = field.removeItemAriaLabel ?? 'Remove {{label}} {{position}}';
+    const [rowIds, setRowIds] = (0, external_react_namespaceObject.useState)(()=>items.map(()=>crypto.randomUUID()));
+    const [prevLength, setPrevLength] = (0, external_react_namespaceObject.useState)(items.length);
+    if (prevLength !== items.length) {
+        setPrevLength(items.length);
+        setRowIds((prev)=>prev.length < items.length ? [
+                ...prev,
+                ...Array.from({
+                    length: items.length - prev.length
+                }, ()=>crypto.randomUUID())
+            ] : prev.slice(0, items.length));
+    }
+    const addItem = (0, external_react_namespaceObject.useCallback)(()=>{
+        setRowIds((prev)=>[
+                ...prev,
+                crypto.randomUUID()
+            ]);
+        onChange([
+            ...items,
+            ''
+        ]);
+    }, [
+        items,
+        onChange
+    ]);
+    const removeItem = (0, external_react_namespaceObject.useCallback)((index)=>{
+        setRowIds((prev)=>prev.filter((_, i)=>i !== index));
+        onChange(items.filter((_, i)=>i !== index));
+    }, [
+        items,
+        onChange
+    ]);
+    const updateItem = (0, external_react_namespaceObject.useCallback)((index, next)=>{
+        onChange(items.map((item, i)=>i === index ? next : item));
+    }, [
+        items,
+        onChange
+    ]);
+    return /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)(form_field_cjs_namespaceObject.FormField, {
+        "data-slot": "string-list-field",
+        children: [
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(form_field_cjs_namespaceObject.FormFieldLabel, {
+                required: required,
+                tooltip: field.tooltip,
+                tooltipAriaLabel: field.tooltipAriaLabel,
+                children: field.label
+            }),
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("div", {
+                className: "grid gap-1.5",
+                children: items.map((item, index)=>/*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)("div", {
+                        className: "flex items-start gap-2",
+                        children: [
+                            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(textarea_cjs_namespaceObject.Textarea, {
+                                ref: 0 === index ? inputRef : void 0,
+                                value: item,
+                                onChange: (e)=>updateItem(index, e.target.value),
+                                onBlur: onBlur,
+                                minRows: field.minRows ?? 2,
+                                maxLength: field.maxLength,
+                                disabled: disabled,
+                                "aria-label": `${field.label} ${index + 1}`,
+                                "aria-invalid": error ? true : void 0,
+                                className: "flex-1"
+                            }),
+                            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(button_cjs_namespaceObject.Button, {
+                                type: "button",
+                                variant: "ghost",
+                                size: "sm",
+                                icon: true,
+                                disabled: disabled,
+                                onClick: ()=>removeItem(index),
+                                "aria-label": formatTemplate(removeItemAriaLabel, {
+                                    label: field.label,
+                                    position: index + 1
+                                }),
+                                className: "shrink-0 text-muted-foreground",
+                                children: /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(external_lucide_react_namespaceObject.Trash2, {})
+                            })
+                        ]
+                    }, rowIds[index] ?? index))
+            }),
+            canAdd && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("div", {
+                children: /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)(button_cjs_namespaceObject.Button, {
+                    type: "button",
+                    variant: "text",
+                    size: "2xs",
+                    onClick: addItem,
+                    children: [
+                        /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(external_lucide_react_namespaceObject.Plus, {}),
+                        addItemLabel
+                    ]
+                })
+            }),
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(form_field_cjs_namespaceObject.FormFieldDescription, {
+                children: field.description
+            }),
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(form_field_cjs_namespaceObject.FormFieldError, {
+                children: error
+            })
+        ]
+    });
+}
+exports.StringListField = __webpack_exports__.StringListField;
+exports.formatTemplate = __webpack_exports__.formatTemplate;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "StringListField",
+    "formatTemplate"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/components/forms/string-list-field.d.ts

@@ -0,0 +1,29 @@
+import type * as React from 'react';
+import type { StringListFieldMetadata } from './form-schema';
+/** Interpolate `{{token}}` placeholders; unknown tokens are left untouched. */
+export declare function formatTemplate(template: string, values: Record<string, string | number>): string;
+export interface StringListFieldProps {
+    field: StringListFieldMetadata;
+    value: string[] | undefined;
+    onChange: (value: string[]) => void;
+    /** Forwarded to every row so blur-mode validation and touched state work. */
+    onBlur?: () => void;
+    error?: string;
+    disabled?: boolean;
+    required?: boolean;
+    /**
+     * The Controller ref, attached to the first row. react-hook-form's `shouldFocusError`
+     * focuses the ref of the first invalid field on a failed submit; without this the list is
+     * the one built-in control it cannot reach, so the user is left with an error and no
+     * indication of where it is.
+     */
+    inputRef?: React.Ref<HTMLTextAreaElement>;
+}
+/**
+ * Repeated multiline rows with Add / Remove — the `string-list` field type.
+ *
+ * Rendering it standalone with `field.tooltip` set requires an ancestor `TooltipProvider`:
+ * the info trigger is a Radix tooltip, which throws without one. Inside `MetadataForm` this
+ * is handled for you — it mounts a provider for schemas that use tooltip metadata.
+ */
+export declare function StringListField({ field, value, onChange, onBlur, error, disabled, required, inputRef, }: StringListFieldProps): import("react/jsx-runtime").JSX.Element;