@uipath/apollo-wind 2.60.1 → 2.61.0

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

@@ -1,4 +1,9 @@
 import type { FieldValues, UseFormReturn } from 'react-hook-form';
+import type { ValueMode } from '../ui/field-addons/value-mode-strings';
+import type { VariablePickerItem } from '../ui/variable-picker';
+import type { FieldActionRegistry, FieldActionsPluginConfig } from './field-actions';
+import type { MetadataFormStringOverrides, MetadataFormStrings } from './form-strings';
+import type { FieldControlRegistration, ValueModeControlHandle, ValueModeRegistry, ValueModesPluginConfig } from './value-modes';
 /**
  * Core Schema Types for Apollo-Wind Metadata Forms
  * Designed for enterprise automation workflows with extensibility
@@ -133,6 +138,65 @@ export interface ValidationConfig {
     custom?: string;
     messages?: ValidationMessages;
 }
+/** A value mode's id. apollo-wind ships `literal`, `expression`, `variable` and `prompt`. */
+/** A built-in mode or one a plugin defines. Built-in ids autocomplete; any string is accepted. */
+export type ValueModeId = ValueMode | (string & {});
+/**
+ * A control by the name it is registered under in `FormPlugin.valueModes.controlRegistry`, optionally
+ * with props of its own. A name rather than the component keeps the schema JSON-serializable.
+ *
+ * @example 'rich-text'
+ * @example { component: 'rich-text', componentProps: { toolbar: false } }
+ */
+export type ValueModeControlRef = string | {
+    component: string;
+    componentProps?: Record<string, unknown>;
+};
+/**
+ * The modes a field's value can be written in, such as a fixed value or an expression.
+ * JSON-serializable: behaviour and geometry come from `FormPlugin.valueModes`.
+ *
+ * Stored shape, with the default codec:
+ * - every write is an envelope, `{ $mode, value }`, fixed values included;
+ * - a cleared value keeps its envelope without `value`, `{ $mode }`, so its mode survives;
+ * - a raw value is read as a fixed value, on read only: it lets existing data load, and the first
+ *   write wraps it. Whatever reads the form's values (submit handlers, plugins, saved drafts) must
+ *   expect the envelope once a field adopts value modes; that migration is the host's to make.
+ *
+ * Rules, conditions and data sources read a field's fixed value only. In any other mode its value
+ * is `VALUE_MODE_OPAQUE`: set, but equal to nothing, whatever the codec stores.
+ */
+export interface ValueModesConfig {
+    /** Offered modes in menu order. The first is the mode of an empty value without `defaultMode`. */
+    modes: ValueModeId[];
+    /** The mode of an empty value. */
+    defaultMode?: ValueModeId;
+    /** Whether the menu offers the modes. Defaults to more than one mode. */
+    switchable?: boolean;
+    /**
+     * The value's type as the modes describe it, such as `object` or `array`. Picks the built-in
+     * Fixed value description and reaches the codec as `CodecContext.expectedType`. Defaults to
+     * the field type's own (`number`, `boolean`) or a custom field's `valueType`.
+     */
+    expectedType?: string;
+    /** Whether a glyph ahead of the value marks a mode other than `literal`. Defaults to true. */
+    indicator?: boolean;
+    /**
+     * This field's control per mode, `literal` included: keys are mode ids, values name controls
+     * registered in `FormPlugin.valueModes.controlRegistry`. Takes precedence over the plugin's
+     * `literalControls` and the mode definition's `control`.
+     *
+     * @example { literal: 'rich-text', expression: 'code' }
+     */
+    controls?: Partial<Record<ValueModeId, ValueModeControlRef>>;
+    /** A codec registered in `FormPlugin.valueModes.codecs`. Defaults to `'default'`. */
+    codec?: string;
+    /** Per-field overrides of a mode's title and description. */
+    labels?: Partial<Record<ValueModeId, {
+        title?: string;
+        description?: string;
+    }>>;
+}
 /**
  * Base metadata common to all field types
  */
@@ -152,6 +216,14 @@ interface BaseFieldMetadata {
     tooltip?: string;
     /** Accessible name of the tooltip trigger (default 'More information'). */
     tooltipAriaLabel?: string;
+    /** Renders the field with a mode menu and writes its value through a codec. */
+    valueModes?: ValueModesConfig;
+    /** Actions behind the label, by id from `FormPlugin.fieldActions.header`, in render order. */
+    headerActions?: string[];
+    /** Rows of the trailing menu, by id from `FormPlugin.fieldActions.menu`, in render order. */
+    menuActions?: string[];
+    /** Text after the label, such as the value's type. Renders the field anatomy's header. */
+    badge?: string;
 }
 export interface TextFieldMetadata extends BaseFieldMetadata {
     type: 'text';
@@ -196,6 +268,13 @@ export interface CheckboxFieldMetadata extends BaseFieldMetadata {
 export interface SwitchFieldMetadata extends BaseFieldMetadata {
     type: 'switch';
 }
+/**
+ * True / False radios with an unset state: a boolean that may have no value, which a switch or
+ * checkbox cannot show.
+ */
+export interface BooleanFieldMetadata extends BaseFieldMetadata {
+    type: 'boolean';
+}
 /**
  * Reference to another form field's value, used to drive a numeric property
  * (e.g. a slider's `max`) at render time.
@@ -265,7 +344,7 @@ export interface CustomFieldMetadata extends BaseFieldMetadata {
  * 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 | StringListFieldMetadata | CustomFieldMetadata;
+export type FieldMetadata = TextFieldMetadata | EmailFieldMetadata | TextareaFieldMetadata | NumberFieldMetadata | SelectFieldMetadata | MultiSelectFieldMetadata | RadioFieldMetadata | CheckboxFieldMetadata | SwitchFieldMetadata | BooleanFieldMetadata | SliderFieldMetadata | DateFieldMetadata | DateTimeFieldMetadata | FileFieldMetadata | StringListFieldMetadata | CustomFieldMetadata;
 /**
  * Extract the field type from FieldMetadata
  */
@@ -347,6 +426,10 @@ export interface MultiStepFormSchema extends BaseFormSchema {
  */
 export type FormSchema = SinglePageFormSchema | MultiStepFormSchema;
 export interface CustomFieldComponentProps {
+    /**
+     * The stored value; in the field anatomy (a field with `valueModes`, field actions or a badge),
+     * the fixed value, decoded.
+     */
     value: unknown;
     onChange: (value: unknown) => void;
     onBlur: () => void;
@@ -355,8 +438,17 @@ export interface CustomFieldComponentProps {
     disabled?: boolean;
     required?: boolean;
     error?: string;
+    /**
+     * In the field anatomy: the handle Insert variable writes through. A component registered as
+     * `insertable` without a text input carrying the field's name as its id attaches one.
+     */
+    controlRef?: React.Ref<ValueModeControlHandle>;
+    /** In the field anatomy: the label's id, for a component registered with `labelTarget: 'labelledby'`. */
+    labelId?: string;
     [key: string]: unknown;
 }
+/** Custom components by name, each bare or with its geometry inside the field anatomy. */
+export type CustomComponents = Record<string, React.ComponentType<CustomFieldComponentProps> | FieldControlRegistration<CustomFieldComponentProps>>;
 export interface FormContext<T extends FieldValues = FieldValues> {
     schema: FormSchema;
     form: UseFormReturn<T>;
@@ -368,7 +460,23 @@ export interface FormContext<T extends FieldValues = FieldValues> {
     evaluateConditions: (conditions: FieldCondition[]) => boolean;
     fetchData: (source: DataSource) => Promise<FieldOption[]>;
     registerCustomComponent: (name: string, component: React.ComponentType<CustomFieldComponentProps>) => void;
+    /** Codecs, mode definitions and controls merged from every plugin. */
+    valueModes?: ValueModeRegistry;
+    /** Field actions merged from every plugin. */
+    fieldActions?: FieldActionRegistry;
+    /** Every plugin's `strings` over the English defaults. */
+    strings?: MetadataFormStrings;
+    /** The last plugin's `variables`. */
+    variables?: FormVariables;
 }
+/**
+ * The variables a form offers, rendered as supplied, to Insert variable and the `variable` mode's
+ * control. A function is called each time a picker opens, never during render, so a host can hand
+ * over a live source without re-rendering its fields.
+ */
+export type FormVariables = VariablePickerItem[] | ((ctx: {
+    field: FieldMetadata;
+}) => VariablePickerItem[]);
 export interface FormPlugin<T extends FieldValues = FieldValues> {
     name: string;
     version?: string;
@@ -377,7 +485,18 @@ export interface FormPlugin<T extends FieldValues = FieldValues> {
     onValueChange?: (fieldName: string, value: unknown, context: FormContext<T>) => void;
     onSubmit?: (data: T, context: FormContext<T>) => T | Promise<T>;
     validators?: Record<string, ValidationConfig>;
-    components?: Record<string, React.ComponentType<CustomFieldComponentProps>>;
+    components?: CustomComponents;
+    /** Codecs, mode definitions and controls for fields with `valueModes`. */
+    valueModes?: ValueModesPluginConfig;
+    /** Actions for fields with `headerActions` or `menuActions`. */
+    fieldActions?: FieldActionsPluginConfig;
+    /**
+     * Strings for every built-in, by group; later plugins win per string. A factory's own
+     * `strings` still override these for its action.
+     */
+    strings?: MetadataFormStringOverrides;
+    /** The form's variables; the last plugin that gives them wins. */
+    variables?: FormVariables;
     customConditions?: Record<string, (value: unknown, condition: unknown) => boolean>;
     customEffects?: Record<string, (field: FieldMetadata, context: FormContext<T>) => void>;
 }

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

@@ -0,0 +1,67 @@
+"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__, {
+    buildFormStrings: ()=>buildFormStrings,
+    DEFAULT_METADATA_FORM_STRINGS: ()=>DEFAULT_METADATA_FORM_STRINGS
+});
+const boolean_radio_group_cjs_namespaceObject = require("../ui/boolean-radio-group.cjs");
+const ai_assist_action_cjs_namespaceObject = require("../ui/field-actions/ai-assist-action.cjs");
+const insert_variable_action_cjs_namespaceObject = require("../ui/field-actions/insert-variable-action.cjs");
+const value_mode_strings_cjs_namespaceObject = require("../ui/field-addons/value-mode-strings.cjs");
+const DEFAULT_METADATA_FORM_STRINGS = {
+    valueModes: value_mode_strings_cjs_namespaceObject.DEFAULT_VALUE_MODE_STRINGS,
+    boolean: boolean_radio_group_cjs_namespaceObject.DEFAULT_BOOLEAN_RADIO_GROUP_STRINGS,
+    insertVariable: insert_variable_action_cjs_namespaceObject.DEFAULT_INSERT_VARIABLE_ACTION_STRINGS,
+    aiAssist: ai_assist_action_cjs_namespaceObject.DEFAULT_AI_ASSIST_ACTION_STRINGS,
+    clear: {
+        label: 'Clear value'
+    },
+    validation: {
+        required: 'This field is required'
+    }
+};
+function buildFormStrings(plugins) {
+    const strings = {
+        ...DEFAULT_METADATA_FORM_STRINGS
+    };
+    for (const plugin of plugins)for (const [group, overrides] of Object.entries(plugin.strings ?? {})){
+        const key = group;
+        strings[key] = {
+            ...strings[key],
+            ...overrides
+        };
+    }
+    return strings;
+}
+exports.DEFAULT_METADATA_FORM_STRINGS = __webpack_exports__.DEFAULT_METADATA_FORM_STRINGS;
+exports.buildFormStrings = __webpack_exports__.buildFormStrings;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "DEFAULT_METADATA_FORM_STRINGS",
+    "buildFormStrings"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -0,0 +1,30 @@
+import { type BooleanRadioGroupStrings } from '../ui/boolean-radio-group';
+import { type AiAssistActionStrings } from '../ui/field-actions/ai-assist-action';
+import { type InsertVariableActionStrings } from '../ui/field-actions/insert-variable-action';
+import { type ValueModeStrings } from '../ui/field-addons/value-mode-strings';
+import type { FormPlugin } from './form-schema';
+export interface ClearActionStrings {
+    label: string;
+}
+export interface FormValidationStrings {
+    /** A required field with no value, in any mode. */
+    required: string;
+}
+/** Every string MetadataForm's built-ins show, by the built-in that shows it. */
+export interface MetadataFormStrings {
+    /** Mode titles and descriptions, the mode menu and the lossy-switch dialog. */
+    valueModes: ValueModeStrings;
+    /** The `boolean` field type's radios, with or without value modes. */
+    boolean: BooleanRadioGroupStrings;
+    insertVariable: InsertVariableActionStrings;
+    aiAssist: AiAssistActionStrings;
+    clear: ClearActionStrings;
+    validation: FormValidationStrings;
+}
+/** Any subset of any group, as `FormPlugin.strings` takes them. */
+export type MetadataFormStringOverrides = {
+    [Group in keyof MetadataFormStrings]?: Partial<MetadataFormStrings[Group]>;
+};
+export declare const DEFAULT_METADATA_FORM_STRINGS: MetadataFormStrings;
+/** Every plugin's `strings` over the English defaults, later plugins winning per string. */
+export declare function buildFormStrings(plugins: readonly FormPlugin[]): MetadataFormStrings;

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

@@ -0,0 +1,30 @@
+import { DEFAULT_BOOLEAN_RADIO_GROUP_STRINGS } from "../ui/boolean-radio-group.js";
+import { DEFAULT_AI_ASSIST_ACTION_STRINGS } from "../ui/field-actions/ai-assist-action.js";
+import { DEFAULT_INSERT_VARIABLE_ACTION_STRINGS } from "../ui/field-actions/insert-variable-action.js";
+import { DEFAULT_VALUE_MODE_STRINGS } from "../ui/field-addons/value-mode-strings.js";
+const DEFAULT_METADATA_FORM_STRINGS = {
+    valueModes: DEFAULT_VALUE_MODE_STRINGS,
+    boolean: DEFAULT_BOOLEAN_RADIO_GROUP_STRINGS,
+    insertVariable: DEFAULT_INSERT_VARIABLE_ACTION_STRINGS,
+    aiAssist: DEFAULT_AI_ASSIST_ACTION_STRINGS,
+    clear: {
+        label: 'Clear value'
+    },
+    validation: {
+        required: 'This field is required'
+    }
+};
+function buildFormStrings(plugins) {
+    const strings = {
+        ...DEFAULT_METADATA_FORM_STRINGS
+    };
+    for (const plugin of plugins)for (const [group, overrides] of Object.entries(plugin.strings ?? {})){
+        const key = group;
+        strings[key] = {
+            ...strings[key],
+            ...overrides
+        };
+    }
+    return strings;
+}
+export { DEFAULT_METADATA_FORM_STRINGS, buildFormStrings };

package/dist/components/forms/index.cjs

@@ -24,86 +24,130 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    useWatch: ()=>external_metadata_form_cjs_namespaceObject.useWatch,
+    isValueModeEnvelope: ()=>external_value_modes_cjs_namespaceObject.isValueModeEnvelope,
+    ModeAwareField: ()=>external_mode_aware_field_cjs_namespaceObject.ModeAwareField,
     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,
+    MetadataForm: ()=>external_metadata_form_cjs_namespaceObject.MetadataForm,
+    FetchAdapter: ()=>external_data_fetcher_cjs_namespaceObject.FetchAdapter,
+    FormStateViewer: ()=>external_form_state_viewer_cjs_namespaceObject.FormStateViewer,
+    FIELD_CONTROL_GEOMETRY: ()=>external_field_control_cjs_namespaceObject.FIELD_CONTROL_GEOMETRY,
+    formatTemplate: ()=>external_string_list_field_cjs_namespaceObject.formatTemplate,
+    createInsertVariableAction: ()=>external_field_actions_cjs_namespaceObject.createInsertVariableAction,
+    resolveVariables: ()=>external_field_actions_cjs_namespaceObject.resolveVariables,
+    FormDesigner: ()=>external_form_designer_cjs_namespaceObject.FormDesigner,
+    FieldControl: ()=>external_field_control_cjs_namespaceObject.FieldControl,
+    auditPlugin: ()=>external_form_plugins_cjs_namespaceObject.auditPlugin,
+    createClearAction: ()=>external_field_actions_cjs_namespaceObject.createClearAction,
+    envelopeCodec: ()=>external_value_modes_cjs_namespaceObject.envelopeCodec,
+    useWatch: ()=>external_metadata_form_cjs_namespaceObject.useWatch,
+    validationPlugin: ()=>external_form_plugins_cjs_namespaceObject.validationPlugin,
+    DEFAULT_METADATA_FORM_STRINGS: ()=>external_form_strings_cjs_namespaceObject.DEFAULT_METADATA_FORM_STRINGS,
     FormFieldRenderer: ()=>external_field_renderer_cjs_namespaceObject.FormFieldRenderer,
     analyticsPlugin: ()=>external_form_plugins_cjs_namespaceObject.analyticsPlugin,
-    MetadataForm: ()=>external_metadata_form_cjs_namespaceObject.MetadataForm,
+    VALUE_MODE_OPAQUE: ()=>external_value_modes_cjs_namespaceObject.VALUE_MODE_OPAQUE,
     hasOptions: ()=>external_form_schema_cjs_namespaceObject.hasOptions,
     DataFetcher: ()=>external_data_fetcher_cjs_namespaceObject.DataFetcher,
     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,
+    createAiAssistAction: ()=>external_field_actions_cjs_namespaceObject.createAiAssistAction,
     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,
     DataSourceBuilder: ()=>external_data_fetcher_cjs_namespaceObject.DataSourceBuilder,
-    ExpressionBuilder: ()=>external_rules_engine_cjs_namespaceObject.ExpressionBuilder,
     autoSavePlugin: ()=>external_form_plugins_cjs_namespaceObject.autoSavePlugin,
+    ExpressionBuilder: ()=>external_rules_engine_cjs_namespaceObject.ExpressionBuilder,
+    literalValues: ()=>external_value_modes_cjs_namespaceObject.literalValues,
     hasMinMaxStep: ()=>external_form_schema_cjs_namespaceObject.hasMinMaxStep,
+    isEmptyModeValue: ()=>external_value_modes_cjs_namespaceObject.isEmptyModeValue,
     workflowPlugin: ()=>external_form_plugins_cjs_namespaceObject.workflowPlugin
 });
 const external_data_fetcher_cjs_namespaceObject = require("./data-fetcher.cjs");
+const external_field_actions_cjs_namespaceObject = require("./field-actions.cjs");
+const external_field_control_cjs_namespaceObject = require("./field-control.cjs");
 const external_field_renderer_cjs_namespaceObject = require("./field-renderer.cjs");
 const external_form_designer_cjs_namespaceObject = require("./form-designer.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_form_strings_cjs_namespaceObject = require("./form-strings.cjs");
 const external_metadata_form_cjs_namespaceObject = require("./metadata-form.cjs");
+const external_mode_aware_field_cjs_namespaceObject = require("./mode-aware-field.cjs");
 const external_rules_engine_cjs_namespaceObject = require("./rules-engine.cjs");
 const external_string_list_field_cjs_namespaceObject = require("./string-list-field.cjs");
+const external_value_modes_cjs_namespaceObject = require("./value-modes.cjs");
+exports.DEFAULT_METADATA_FORM_STRINGS = __webpack_exports__.DEFAULT_METADATA_FORM_STRINGS;
 exports.DataFetcher = __webpack_exports__.DataFetcher;
 exports.DataSourceBuilder = __webpack_exports__.DataSourceBuilder;
 exports.DataTransformers = __webpack_exports__.DataTransformers;
 exports.ExpressionBuilder = __webpack_exports__.ExpressionBuilder;
+exports.FIELD_CONTROL_GEOMETRY = __webpack_exports__.FIELD_CONTROL_GEOMETRY;
 exports.FetchAdapter = __webpack_exports__.FetchAdapter;
+exports.FieldControl = __webpack_exports__.FieldControl;
 exports.FormDesigner = __webpack_exports__.FormDesigner;
 exports.FormFieldRenderer = __webpack_exports__.FormFieldRenderer;
 exports.FormStateViewer = __webpack_exports__.FormStateViewer;
 exports.MetadataForm = __webpack_exports__.MetadataForm;
+exports.ModeAwareField = __webpack_exports__.ModeAwareField;
 exports.RuleBuilder = __webpack_exports__.RuleBuilder;
 exports.RulesEngine = __webpack_exports__.RulesEngine;
 exports.StringListField = __webpack_exports__.StringListField;
+exports.VALUE_MODE_OPAQUE = __webpack_exports__.VALUE_MODE_OPAQUE;
 exports.analyticsPlugin = __webpack_exports__.analyticsPlugin;
 exports.auditPlugin = __webpack_exports__.auditPlugin;
 exports.autoSavePlugin = __webpack_exports__.autoSavePlugin;
+exports.createAiAssistAction = __webpack_exports__.createAiAssistAction;
+exports.createClearAction = __webpack_exports__.createClearAction;
+exports.createInsertVariableAction = __webpack_exports__.createInsertVariableAction;
+exports.envelopeCodec = __webpack_exports__.envelopeCodec;
 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.isEmptyModeValue = __webpack_exports__.isEmptyModeValue;
 exports.isFileField = __webpack_exports__.isFileField;
+exports.isValueModeEnvelope = __webpack_exports__.isValueModeEnvelope;
+exports.literalValues = __webpack_exports__.literalValues;
+exports.resolveVariables = __webpack_exports__.resolveVariables;
 exports.useWatch = __webpack_exports__.useWatch;
 exports.validationPlugin = __webpack_exports__.validationPlugin;
 exports.workflowPlugin = __webpack_exports__.workflowPlugin;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "DEFAULT_METADATA_FORM_STRINGS",
     "DataFetcher",
     "DataSourceBuilder",
     "DataTransformers",
     "ExpressionBuilder",
+    "FIELD_CONTROL_GEOMETRY",
     "FetchAdapter",
+    "FieldControl",
     "FormDesigner",
     "FormFieldRenderer",
     "FormStateViewer",
     "MetadataForm",
+    "ModeAwareField",
     "RuleBuilder",
     "RulesEngine",
     "StringListField",
+    "VALUE_MODE_OPAQUE",
     "analyticsPlugin",
     "auditPlugin",
     "autoSavePlugin",
+    "createAiAssistAction",
+    "createClearAction",
+    "createInsertVariableAction",
+    "envelopeCodec",
     "formatTemplate",
     "formattingPlugin",
     "hasMinMaxStep",
     "hasOptions",
     "isCustomField",
+    "isEmptyModeValue",
     "isFileField",
+    "isValueModeEnvelope",
+    "literalValues",
+    "resolveVariables",
     "useWatch",
     "validationPlugin",
     "workflowPlugin"

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

@@ -3,12 +3,17 @@
  * Enterprise-grade metadata-driven form system
  */
 export { type AdapterRequest, type AdapterResponse, type DataAdapter, DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter, } from './data-fetcher';
+export { type AiAssistActionOptions, type ClearActionOptions, createAiAssistAction, createClearAction, createInsertVariableAction, type FieldActionContext, type FieldActionGenerate, type FieldActionRegistry, type FieldActionsPluginConfig, type FieldHeaderAction, type FieldMenuAction, type InsertVariableActionOptions, resolveVariables, type ValueModeVariable, } from './field-actions';
+export { FIELD_CONTROL_GEOMETRY, FieldControl, type FieldControlFormField, type FieldControlGeometry, type FieldControlLabelTarget, type FieldControlProps, } from './field-control';
 export { FormFieldRenderer } from './field-renderer';
 export { FormDesigner } from './form-designer';
 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 type { CustomComponents, CustomFieldComponentProps, CustomValueType, DataSource, FieldCondition, FieldMetadata, FieldOption, FieldRule, FieldType, FormAction, FormContext, FormPlugin, FormSchema, FormSection, FormStep, FormVariables, StringListFieldMetadata, ValueModeControlRef, ValueModeId, ValueModesConfig, } from './form-schema';
 export { hasMinMaxStep, hasOptions, isCustomField, isFileField, } from './form-schema';
 export { FormStateViewer } from './form-state-viewer';
+export { type ClearActionStrings, DEFAULT_METADATA_FORM_STRINGS, type FormValidationStrings, type MetadataFormStringOverrides, type MetadataFormStrings, } from './form-strings';
 export { MetadataForm, type MetadataFormProps, useWatch } from './metadata-form';
+export { ModeAwareField, type ModeAwareFieldProps, } from './mode-aware-field';
 export { ExpressionBuilder, RuleBuilder, RulesEngine } from './rules-engine';
 export { formatTemplate, StringListField, type StringListFieldProps } from './string-list-field';
+export { type CodecContext, type ConvertResult, type DecodedValue, envelopeCodec, type FieldControlRegistration, isEmptyModeValue, isValueModeEnvelope, literalValues, VALUE_MODE_OPAQUE, type ValueModeCodec, type ValueModeControlHandle, type ValueModeControlProps, type ValueModeControlRegistration, type ValueModeDefinition, type ValueModeEnvelope, type ValueModeRegistry, type ValueModesPluginConfig, } from './value-modes';

package/dist/components/forms/index.js

@@ -1,10 +1,15 @@
 import { DataFetcher, DataSourceBuilder, DataTransformers, FetchAdapter } from "./data-fetcher.js";
+import { createAiAssistAction, createClearAction, createInsertVariableAction, resolveVariables } from "./field-actions.js";
+import { FIELD_CONTROL_GEOMETRY, FieldControl } from "./field-control.js";
 import { FormFieldRenderer } from "./field-renderer.js";
 import { FormDesigner } from "./form-designer.js";
 import { analyticsPlugin, auditPlugin, autoSavePlugin, formattingPlugin, validationPlugin, workflowPlugin } from "./form-plugins.js";
 import { hasMinMaxStep, hasOptions, isCustomField, isFileField } from "./form-schema.js";
 import { FormStateViewer } from "./form-state-viewer.js";
+import { DEFAULT_METADATA_FORM_STRINGS } from "./form-strings.js";
 import { MetadataForm, useWatch } from "./metadata-form.js";
+import { ModeAwareField } from "./mode-aware-field.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 };
+import { VALUE_MODE_OPAQUE, envelopeCodec, isEmptyModeValue, isValueModeEnvelope, literalValues } from "./value-modes.js";
+export { DEFAULT_METADATA_FORM_STRINGS, DataFetcher, DataSourceBuilder, DataTransformers, ExpressionBuilder, FIELD_CONTROL_GEOMETRY, FetchAdapter, FieldControl, FormDesigner, FormFieldRenderer, FormStateViewer, MetadataForm, ModeAwareField, RuleBuilder, RulesEngine, StringListField, VALUE_MODE_OPAQUE, analyticsPlugin, auditPlugin, autoSavePlugin, createAiAssistAction, createClearAction, createInsertVariableAction, envelopeCodec, formatTemplate, formattingPlugin, hasMinMaxStep, hasOptions, isCustomField, isEmptyModeValue, isFileField, isValueModeEnvelope, literalValues, resolveVariables, useWatch, validationPlugin, workflowPlugin };

package/dist/components/forms/literal-value-context.cjs

@@ -0,0 +1,37 @@
+"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__, {
+    LiteralValueContext: ()=>LiteralValueContext
+});
+const external_react_namespaceObject = require("react");
+const LiteralValueContext = (0, external_react_namespaceObject.createContext)((_name, stored)=>stored);
+exports.LiteralValueContext = __webpack_exports__.LiteralValueContext;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "LiteralValueContext"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/components/forms/literal-value-context.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Reads another field's value the way rules and data sources do: its fixed value when it has value
+ * modes. MetadataForm provides it; a control outside one reads values as stored.
+ */
+export declare const LiteralValueContext: import("react").Context<(name: string, stored: unknown) => unknown>;

package/dist/components/forms/literal-value-context.js

@@ -0,0 +1,3 @@
+import { createContext } from "react";
+const LiteralValueContext = createContext((_name, stored)=>stored);
+export { LiteralValueContext };