@uipath/apollo-wind 2.50.0 → 2.52.0

package/dist/components/forms/form-schema.d.ts

@@ -1,4 +1,4 @@
-import type { UseFormReturn, FieldValues } from 'react-hook-form';
+import type { FieldValues, UseFormReturn } from 'react-hook-form';
 /**
  * Core Schema Types for Apollo-Wind Metadata Forms
  * Designed for enterprise automation workflows with extensibility
@@ -148,6 +148,10 @@ interface BaseFieldMetadata {
     grid?: GridConfig;
     ariaLabel?: string;
     ariaDescribedBy?: string;
+    /** Info tooltip rendered next to the field label. */
+    tooltip?: string;
+    /** Accessible name of the tooltip trigger (default 'More information'). */
+    tooltipAriaLabel?: string;
 }
 export interface TextFieldMetadata extends BaseFieldMetadata {
     type: 'text';
@@ -158,6 +162,10 @@ export interface EmailFieldMetadata extends BaseFieldMetadata {
 export interface TextareaFieldMetadata extends BaseFieldMetadata {
     type: 'textarea';
     rows?: number;
+    /** Autosize floor in rows; takes precedence over `rows` when set. */
+    minRows?: number;
+    /** DOM maxLength character cap. */
+    maxLength?: number;
 }
 export interface NumberFieldMetadata extends BaseFieldMetadata {
     type: 'number';
@@ -173,6 +181,10 @@ export interface MultiSelectFieldMetadata extends BaseFieldMetadata {
     type: 'multiselect';
     options?: FieldOption[];
     maxSelected?: number;
+    /** Shown when the search matches nothing (default 'No items found.'). */
+    emptyMessage?: string;
+    /** Placeholder of the search input (default 'Search...'). */
+    searchPlaceholder?: string;
 }
 export interface RadioFieldMetadata extends BaseFieldMetadata {
     type: 'radio';
@@ -220,16 +232,40 @@ export interface FileFieldMetadata extends BaseFieldMetadata {
     maxSize?: number;
     showPreview?: boolean;
 }
+export interface StringListFieldMetadata extends BaseFieldMetadata {
+    type: 'string-list';
+    /** Cap on how many rows can be added; the Add button hides at the cap. */
+    maxItems?: number;
+    /** Per-row character cap (DOM maxLength on each row's textarea). */
+    maxLength?: number;
+    /** Autosize floor for each row's textarea (default 2). */
+    minRows?: number;
+    /** Label of the Add button (default 'Add'). */
+    addItemLabel?: string;
+    /**
+     * Aria-label template of each row's remove button; `{{label}}` and `{{position}}` are
+     * interpolated (default 'Remove {{label}} {{position}}').
+     */
+    removeItemAriaLabel?: string;
+}
+/** Value shapes a `type: 'custom'` field can declare so metadata constraints apply to it. */
+export type CustomValueType = 'string' | 'number' | 'boolean' | 'string-array';
 export interface CustomFieldMetadata extends BaseFieldMetadata {
     type: 'custom';
     component: string;
     componentProps?: Record<string, unknown>;
+    /**
+     * Shape of the value the component owns. Without it the field validates as `z.any()`, so
+     * `required` (and `minItems` for lists) silently does nothing — declare it and the normal
+     * metadata constraints apply to custom components like any other field.
+     */
+    valueType?: CustomValueType;
 }
 /**
  * Discriminated union of all field types
  * TypeScript will enforce that only valid properties exist for each type
  */
-export type FieldMetadata = TextFieldMetadata | EmailFieldMetadata | TextareaFieldMetadata | NumberFieldMetadata | SelectFieldMetadata | MultiSelectFieldMetadata | RadioFieldMetadata | CheckboxFieldMetadata | SwitchFieldMetadata | SliderFieldMetadata | DateFieldMetadata | DateTimeFieldMetadata | FileFieldMetadata | CustomFieldMetadata;
+export type FieldMetadata = TextFieldMetadata | EmailFieldMetadata | TextareaFieldMetadata | NumberFieldMetadata | SelectFieldMetadata | MultiSelectFieldMetadata | RadioFieldMetadata | CheckboxFieldMetadata | SwitchFieldMetadata | SliderFieldMetadata | DateFieldMetadata | DateTimeFieldMetadata | FileFieldMetadata | StringListFieldMetadata | CustomFieldMetadata;
 /**
  * Extract the field type from FieldMetadata
  */

package/dist/components/forms/index.cjs

@@ -24,10 +24,12 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    useWatch: ()=>external_metadata_form_cjs_namespaceObject.useWatch,
     formattingPlugin: ()=>external_form_plugins_cjs_namespaceObject.formattingPlugin,
     isCustomField: ()=>external_form_schema_cjs_namespaceObject.isCustomField,
     isFileField: ()=>external_form_schema_cjs_namespaceObject.isFileField,
     validationPlugin: ()=>external_form_plugins_cjs_namespaceObject.validationPlugin,
+    StringListField: ()=>external_string_list_field_cjs_namespaceObject.StringListField,
     FormFieldRenderer: ()=>external_field_renderer_cjs_namespaceObject.FormFieldRenderer,
     analyticsPlugin: ()=>external_form_plugins_cjs_namespaceObject.analyticsPlugin,
     MetadataForm: ()=>external_metadata_form_cjs_namespaceObject.MetadataForm,
@@ -36,24 +38,26 @@ __webpack_require__.d(__webpack_exports__, {
     DataTransformers: ()=>external_data_fetcher_cjs_namespaceObject.DataTransformers,
     FetchAdapter: ()=>external_data_fetcher_cjs_namespaceObject.FetchAdapter,
     FormStateViewer: ()=>external_form_state_viewer_cjs_namespaceObject.FormStateViewer,
+    formatTemplate: ()=>external_string_list_field_cjs_namespaceObject.formatTemplate,
     RulesEngine: ()=>external_rules_engine_cjs_namespaceObject.RulesEngine,
     RuleBuilder: ()=>external_rules_engine_cjs_namespaceObject.RuleBuilder,
     auditPlugin: ()=>external_form_plugins_cjs_namespaceObject.auditPlugin,
     FormDesigner: ()=>external_form_designer_cjs_namespaceObject.FormDesigner,
-    autoSavePlugin: ()=>external_form_plugins_cjs_namespaceObject.autoSavePlugin,
     DataSourceBuilder: ()=>external_data_fetcher_cjs_namespaceObject.DataSourceBuilder,
     ExpressionBuilder: ()=>external_rules_engine_cjs_namespaceObject.ExpressionBuilder,
+    autoSavePlugin: ()=>external_form_plugins_cjs_namespaceObject.autoSavePlugin,
     hasMinMaxStep: ()=>external_form_schema_cjs_namespaceObject.hasMinMaxStep,
     workflowPlugin: ()=>external_form_plugins_cjs_namespaceObject.workflowPlugin
 });
-const external_metadata_form_cjs_namespaceObject = require("./metadata-form.cjs");
+const external_data_fetcher_cjs_namespaceObject = require("./data-fetcher.cjs");
 const external_field_renderer_cjs_namespaceObject = require("./field-renderer.cjs");
 const external_form_designer_cjs_namespaceObject = require("./form-designer.cjs");
-const external_rules_engine_cjs_namespaceObject = require("./rules-engine.cjs");
-const external_data_fetcher_cjs_namespaceObject = require("./data-fetcher.cjs");
-const external_form_state_viewer_cjs_namespaceObject = require("./form-state-viewer.cjs");
 const external_form_plugins_cjs_namespaceObject = require("./form-plugins.cjs");
 const external_form_schema_cjs_namespaceObject = require("./form-schema.cjs");
+const external_form_state_viewer_cjs_namespaceObject = require("./form-state-viewer.cjs");
+const external_metadata_form_cjs_namespaceObject = require("./metadata-form.cjs");
+const external_rules_engine_cjs_namespaceObject = require("./rules-engine.cjs");
+const external_string_list_field_cjs_namespaceObject = require("./string-list-field.cjs");
 exports.DataFetcher = __webpack_exports__.DataFetcher;
 exports.DataSourceBuilder = __webpack_exports__.DataSourceBuilder;
 exports.DataTransformers = __webpack_exports__.DataTransformers;
@@ -65,14 +69,17 @@ exports.FormStateViewer = __webpack_exports__.FormStateViewer;
 exports.MetadataForm = __webpack_exports__.MetadataForm;
 exports.RuleBuilder = __webpack_exports__.RuleBuilder;
 exports.RulesEngine = __webpack_exports__.RulesEngine;
+exports.StringListField = __webpack_exports__.StringListField;
 exports.analyticsPlugin = __webpack_exports__.analyticsPlugin;
 exports.auditPlugin = __webpack_exports__.auditPlugin;
 exports.autoSavePlugin = __webpack_exports__.autoSavePlugin;
+exports.formatTemplate = __webpack_exports__.formatTemplate;
 exports.formattingPlugin = __webpack_exports__.formattingPlugin;
 exports.hasMinMaxStep = __webpack_exports__.hasMinMaxStep;
 exports.hasOptions = __webpack_exports__.hasOptions;
 exports.isCustomField = __webpack_exports__.isCustomField;
 exports.isFileField = __webpack_exports__.isFileField;
+exports.useWatch = __webpack_exports__.useWatch;
 exports.validationPlugin = __webpack_exports__.validationPlugin;
 exports.workflowPlugin = __webpack_exports__.workflowPlugin;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
@@ -87,14 +94,17 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "MetadataForm",
     "RuleBuilder",
     "RulesEngine",
+    "StringListField",
     "analyticsPlugin",
     "auditPlugin",
     "autoSavePlugin",
+    "formatTemplate",
     "formattingPlugin",
     "hasMinMaxStep",
     "hasOptions",
     "isCustomField",
     "isFileField",
+    "useWatch",
     "validationPlugin",
     "workflowPlugin"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/components/forms/index.d.ts

@@ -2,12 +2,13 @@
  * Apollo-Wind Metadata Forms
  * Enterprise-grade metadata-driven form system
  */
-export { MetadataForm } from './metadata-form';
+export { type AdapterRequest, type AdapterResponse, type DataAdapter, DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter, } from './data-fetcher';
 export { FormFieldRenderer } from './field-renderer';
 export { FormDesigner } from './form-designer';
-export { RulesEngine, RuleBuilder, ExpressionBuilder } from './rules-engine';
-export { DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter, type DataAdapter, type AdapterRequest, type AdapterResponse, } from './data-fetcher';
+export { analyticsPlugin, auditPlugin, autoSavePlugin, formattingPlugin, validationPlugin, workflowPlugin, } from './form-plugins';
+export type { CustomFieldComponentProps, CustomValueType, DataSource, FieldCondition, FieldMetadata, FieldOption, FieldRule, FieldType, FormAction, FormContext, FormPlugin, FormSchema, FormSection, FormStep, StringListFieldMetadata, } from './form-schema';
+export { hasMinMaxStep, hasOptions, isCustomField, isFileField, } from './form-schema';
 export { FormStateViewer } from './form-state-viewer';
-export { analyticsPlugin, autoSavePlugin, validationPlugin, workflowPlugin, auditPlugin, formattingPlugin, } from './form-plugins';
-export type { FormSchema, FormSection, FormStep, FieldMetadata, FieldType, FieldCondition, FieldRule, DataSource, FormContext, FormPlugin, FormAction, CustomFieldComponentProps, FieldOption, } from './form-schema';
-export { hasOptions, hasMinMaxStep, isFileField, isCustomField, } from './form-schema';
+export { MetadataForm, type MetadataFormProps, useWatch } from './metadata-form';
+export { ExpressionBuilder, RuleBuilder, RulesEngine } from './rules-engine';
+export { formatTemplate, StringListField, type StringListFieldProps } from './string-list-field';

package/dist/components/forms/index.js

@@ -1,9 +1,10 @@
-import { MetadataForm } from "./metadata-form.js";
+import { DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter } from "./data-fetcher.js";
 import { FormFieldRenderer } from "./field-renderer.js";
 import { FormDesigner } from "./form-designer.js";
-import { ExpressionBuilder, RuleBuilder, RulesEngine } from "./rules-engine.js";
-import { DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter } from "./data-fetcher.js";
-import { FormStateViewer } from "./form-state-viewer.js";
 import { analyticsPlugin, auditPlugin, autoSavePlugin, formattingPlugin, validationPlugin, workflowPlugin } from "./form-plugins.js";
 import { hasMinMaxStep, hasOptions, isCustomField, isFileField } from "./form-schema.js";
-export { DataFetcher, DataSourceBuilder, DataTransformers, ExpressionBuilder, FetchAdapter, FormDesigner, FormFieldRenderer, FormStateViewer, MetadataForm, RuleBuilder, RulesEngine, analyticsPlugin, auditPlugin, autoSavePlugin, formattingPlugin, hasMinMaxStep, hasOptions, isCustomField, isFileField, validationPlugin, workflowPlugin };
+import { FormStateViewer } from "./form-state-viewer.js";
+import { MetadataForm, useWatch } from "./metadata-form.js";
+import { ExpressionBuilder, RuleBuilder, RulesEngine } from "./rules-engine.js";
+import { StringListField, formatTemplate } from "./string-list-field.js";
+export { DataFetcher, DataSourceBuilder, DataTransformers, ExpressionBuilder, FetchAdapter, FormDesigner, FormFieldRenderer, FormStateViewer, MetadataForm, RuleBuilder, RulesEngine, StringListField, analyticsPlugin, auditPlugin, autoSavePlugin, formatTemplate, formattingPlugin, hasMinMaxStep, hasOptions, isCustomField, isFileField, useWatch, validationPlugin, workflowPlugin };

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

@@ -33,7 +33,8 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    MetadataForm: ()=>MetadataForm
+    MetadataForm: ()=>MetadataForm,
+    useWatch: ()=>external_react_hook_form_namespaceObject.useWatch
 });
 const jsx_runtime_namespaceObject = require("react/jsx-runtime");
 const standard_schema_namespaceObject = require("@hookform/resolvers/standard-schema");
@@ -44,13 +45,14 @@ const v4_namespaceObject = require("zod/v4");
 const accordion_cjs_namespaceObject = require("../ui/accordion.cjs");
 const button_cjs_namespaceObject = require("../ui/button.cjs");
 const tabs_cjs_namespaceObject = require("../ui/tabs.cjs");
+const tooltip_cjs_namespaceObject = require("../ui/tooltip.cjs");
 const index_cjs_namespaceObject = require("../../lib/index.cjs");
 const external_data_fetcher_cjs_namespaceObject = require("./data-fetcher.cjs");
 const external_field_renderer_cjs_namespaceObject = require("./field-renderer.cjs");
 const external_rules_engine_cjs_namespaceObject = require("./rules-engine.cjs");
 const external_validation_converter_cjs_namespaceObject = require("./validation-converter.cjs");
 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] = (0, external_react_namespaceObject.useState)(0);
     const [customComponents, setCustomComponents] = (0, external_react_namespaceObject.useState)({});
     const [isInitialized, setIsInitialized] = (0, external_react_namespaceObject.useState)(false);
@@ -62,6 +64,15 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     }, [
         schema
     ]);
+    const hasFieldTooltip = (0, external_react_namespaceObject.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 = (0, external_react_namespaceObject.useMemo)(()=>buildZodSchema(stableSchema), [
         stableSchema
     ]);
@@ -111,12 +122,12 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     ]);
     const contextRef = (0, external_react_namespaceObject.useRef)(context);
     contextRef.current = context;
-    const isInitializedRef = (0, external_react_namespaceObject.useRef)(isInitialized);
-    isInitializedRef.current = isInitialized;
+    const initializingRef = (0, external_react_namespaceObject.useRef)(false);
     (0, external_react_namespaceObject.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, (0, index_cjs_namespaceObject.get)(value, name), contextRef.current);
             });
@@ -130,9 +141,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();
@@ -149,51 +168,89 @@ function MetadataForm({ schema, plugins = DEFAULT_PLUGINS, onSubmit, className,
     const handleReset = (0, external_react_namespaceObject.useCallback)(()=>reset(), [
         reset
     ]);
+    const allCustomComponents = (0, external_react_namespaceObject.useMemo)(()=>{
+        const fromPlugins = {};
+        for (const plugin of plugins)Object.assign(fromPlugins, plugin.components);
+        return {
+            ...fromPlugins,
+            ...customComponents
+        };
+    }, [
+        plugins,
+        customComponents
+    ]);
+    const enterSwallowRef = (0, external_react_namespaceObject.useRef)(null);
+    (0, external_react_namespaceObject.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__*/ (0, jsx_runtime_namespaceObject.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__*/ (0, jsx_runtime_namespaceObject.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__*/ (0, jsx_runtime_namespaceObject.jsx)(metadata_form_SinglePageForm, {
             schema: stableSchema,
             context: context,
-            customComponents: customComponents,
+            customComponents: allCustomComponents,
             disabled: disabled,
             sectionVariant: sectionVariant
         });
     };
+    const content = /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)(jsx_runtime_namespaceObject.Fragment, {
+        children: [
+            renderContent(),
+            !stableSchema.steps && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(metadata_form_FormActions, {
+                schema: stableSchema,
+                context: context,
+                onReset: handleReset,
+                onSubmit: 'div' === container ? handleFormSubmit : void 0
+            })
+        ]
+    });
+    const body = 'div' === container ? /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("div", {
+        className: className,
+        ref: enterSwallowRef,
+        children: content
+    }) : /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("form", {
+        onSubmit: handleFormSubmit,
+        className: className,
+        autoComplete: autoComplete,
+        children: content
+    });
     return /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(external_react_hook_form_namespaceObject.FormProvider, {
         ...form,
-        children: /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)("form", {
-            onSubmit: handleFormSubmit,
-            className: className,
-            autoComplete: autoComplete,
-            children: [
-                renderContent(),
-                !stableSchema.steps && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(metadata_form_FormActions, {
-                    schema: stableSchema,
-                    context: context,
-                    onReset: handleReset
-                })
-            ]
-        })
+        children: hasFieldTooltip ? /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(tooltip_cjs_namespaceObject.TooltipProvider, {
+            children: body
+        }) : body
     });
 }
 function conditionDependencies(conditionGroups) {
@@ -225,7 +282,7 @@ const metadata_form_SinglePageForm = /*#__PURE__*/ external_react_default().memo
             }, section.id))
     });
 });
-const metadata_form_MultiStepForm = /*#__PURE__*/ external_react_default().memo(function({ schema, context, currentStep, setCurrentStep, customComponents, disabled, sectionVariant }) {
+const metadata_form_MultiStepForm = /*#__PURE__*/ external_react_default().memo(function({ schema, context, currentStep, setCurrentStep, customComponents, disabled, sectionVariant, onSubmit }) {
     const steps = schema.steps || [];
     const conditionFields = (0, external_react_namespaceObject.useMemo)(()=>conditionDependencies(schema.steps?.map((step)=>step.conditions) ?? []), [
         schema
@@ -303,7 +360,8 @@ const metadata_form_MultiStepForm = /*#__PURE__*/ external_react_default().memo(
                         variant: "default",
                         children: "Next"
                     }) : /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(button_cjs_namespaceObject.Button, {
-                        type: "submit",
+                        type: onSubmit ? 'button' : 'submit',
+                        onClick: onSubmit,
                         variant: "default",
                         children: "Submit"
                     })
@@ -312,7 +370,7 @@ const metadata_form_MultiStepForm = /*#__PURE__*/ external_react_default().memo(
         ]
     });
 });
-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 = (0, external_react_namespaceObject.useMemo)(()=>conditionDependencies(schema.steps?.flatMap((step)=>[
                 step.conditions,
@@ -378,7 +436,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
                                         })
                                     ]
@@ -411,7 +469,8 @@ function TabbedStepForm({ schema, context, customComponents, disabled, sectionVa
             /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(metadata_form_FormActions, {
                 schema: schema,
                 context: context,
-                onReset: onReset
+                onReset: onReset,
+                onSubmit: onSubmit
             })
         ]
     });
@@ -493,7 +552,7 @@ const metadata_form_FormSection = /*#__PURE__*/ external_react_default().memo(fu
         ]
     });
 });
-const metadata_form_FormActions = /*#__PURE__*/ external_react_default().memo(function({ schema, context, onReset }) {
+const metadata_form_FormActions = /*#__PURE__*/ external_react_default().memo(function({ schema, context, onReset, onSubmit }) {
     const { isSubmitting } = (0, external_react_hook_form_namespaceObject.useFormState)({
         control: context.form.control
     });
@@ -522,7 +581,8 @@ const metadata_form_FormActions = /*#__PURE__*/ external_react_default().memo(fu
                 children: action.label
             }, action.id);
             return /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(button_cjs_namespaceObject.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
@@ -553,7 +613,7 @@ function buildZodSchema(schema) {
         } : shouldIncludeRequiredInBase ? {
             required: true
         } : void 0;
-        shape[field.name] = (0, external_validation_converter_cjs_namespaceObject.validationConfigToZod)(validationConfig, field.type);
+        shape[field.name] = (0, external_validation_converter_cjs_namespaceObject.validationConfigToZod)(validationConfig, field.type, 'custom' === field.type ? field.valueType : void 0);
     });
     const baseSchema = v4_namespaceObject.z.object(shape);
     if (0 === dynamicValidationFields.length) return baseSchema;
@@ -565,9 +625,7 @@ function buildZodSchema(schema) {
             const ruleResult = external_rules_engine_cjs_namespaceObject.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 ((0, external_validation_converter_cjs_namespaceObject.isEmptyFieldValue)(values[name])) ctx.addIssue({
                     code: v4_namespaceObject.z.ZodIssueCode.custom,
                     message: customRequiredMessage || 'This field is required',
                     path: [
@@ -583,8 +641,10 @@ async function loadInitialData(initialData, _context) {
     return initialData;
 }
 exports.MetadataForm = __webpack_exports__.MetadataForm;
+exports.useWatch = __webpack_exports__.useWatch;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "MetadataForm"
+    "MetadataForm",
+    "useWatch"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/components/forms/metadata-form.d.ts

@@ -1,9 +1,10 @@
 import type { FormPlugin, FormSchema } from './form-schema';
+export { useWatch } from 'react-hook-form';
 /**
  * Core MetadataForm Component
  * Renders forms from JSON/object schema with full RHF integration
  */
-interface MetadataFormProps {
+export interface MetadataFormProps {
     schema: FormSchema;
     plugins?: FormPlugin[];
     onSubmit?: (data: unknown) => void | Promise<void>;
@@ -42,6 +43,13 @@ interface MetadataFormProps {
      * and uncontrolled mode. Pair it with `activeStepId` to persist the selection.
      */
     onActiveStepChange?: (stepId: string) => void;
+    /**
+     * Render a `<div>` instead of a `<form>` — for hosts that embed the form inside their own
+     * chrome and own submission. Enter is swallowed for single-line inputs so it cannot trigger
+     * the host form's implicit submission, and schema submit actions become plain buttons.
+     *
+     * Suppressing the action row is the schema's job, not this prop's: pass `actions: []`.
+     */
+    container?: 'form' | 'div';
 }
-export declare function MetadataForm({ schema, plugins, onSubmit, className, disabled, autoComplete, stepVariant, sectionVariant, activeStepId, onActiveStepChange, }: MetadataFormProps): import("react/jsx-runtime").JSX.Element;
-export {};
+export declare function MetadataForm({ schema, plugins, onSubmit, className, disabled, autoComplete, stepVariant, sectionVariant, activeStepId, onActiveStepChange, container, }: MetadataFormProps): import("react/jsx-runtime").JSX.Element;