@aglyn/shared-ui-jsx-forms 1.0.0-beta.143

package/src/lib/mapper/select.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type FormFieldGridProps } from './form-field-grid';
+import type { BaseFieldProps, OptionValue, SelectOption } from './types';
+export interface SelectProps<T = OptionValue> extends BaseFieldProps {
+    options?: SelectOption<T>[];
+    loadOptions?: (inputValue: string) => Promise<SelectOption<T>[]>;
+    isSearchable?: boolean;
+    isMulti?: boolean;
+    multiple?: boolean;
+    isClearable?: boolean;
+    disableClearable?: boolean;
+    hideSelectedOptions?: boolean;
+    closeMenuOnSelect?: boolean;
+    isFetching?: boolean;
+    noOptionsMessage?: () => string;
+    noOptionsText?: () => string;
+    loadingMessage?: string;
+    loadingText?: string;
+    placeholder?: string;
+    /** Offer the reset-to-unset affordance (AGL-2486). */
+    clearable?: boolean;
+    FormFieldGridProps?: FormFieldGridProps;
+    TextFieldProps?: Record<string, any>;
+    inputProps?: Record<string, any>;
+    onInputChange?: (value: string, reason?: string) => void;
+    /**
+     * A schema field's own hook on the search box, beside DDF's.
+     *
+     * `onInputChange` cannot be one. `@data-driven-forms/common/select` owns
+     * that prop for its `loadOptions` support and assigns it AFTER spreading the
+     * field's props, so a handler declared on a schema field is overwritten
+     * before it reaches this component — silently, since a dropdown with a
+     * dropped handler still opens, still filters and still selects. A field
+     * whose typing was supposed to fetch more simply fetches nothing.
+     *
+     * This name is not taken, so it survives the spread. Both are called.
+     */
+    onSearchInput?: (value: string, reason?: string) => void;
+}
+/** Returns label of the selected option. */
+export declare function getOptionLabel<T = OptionValue>(option: T | SelectOption<T> | undefined, options: SelectOption<T>[]): string;
+/** Creates the DDF select value format. */
+export declare function createValue<T = OptionValue>(option: T | SelectOption<T> | (T | SelectOption<T>)[] | null, isMulti: boolean): T | SelectOption<T> | (T | SelectOption<T>)[] | null | undefined;
+export declare function Select<T = OptionValue>(props: SelectProps<T>): import("react").JSX.Element;
+export default Select;

package/src/lib/mapper/select.js

@@ -0,0 +1,203 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and
+ * updated for the current MUI API (`slotProps`-shaped Autocomplete
+ * `renderInput` params instead of `inputProps`).
+ */ import { useMemo } from "react";
+import { Autocomplete, CircularProgress, TextField } from "@mui/material";
+import ArrowDropDownIcon from "@mui/icons-material/ArrowDropDown";
+import DDFSelectImport from "@data-driven-forms/common/select";
+import parseInternalValue from "@data-driven-forms/common/select/parse-internal-value";
+import { useFieldApi } from "../vendor/data-driven-forms.js";
+import FormFieldGrid, { buildFieldClear } from "./form-field-grid.js";
+import { validationError } from "./validation-error.js";
+/** Returns label of the selected option. */ export function getOptionLabel(option, options) {
+    if (typeof option === 'undefined') {
+        return '';
+    }
+    if (option === '') {
+        return '';
+    }
+    if (Array.isArray(option) && option.length === 0) {
+        return '';
+    }
+    if (typeof option === 'object' && option !== null) {
+        return String(option.label);
+    }
+    const item = options.find(({ value })=>value === option);
+    return item && String(item.label) || '';
+}
+/** Creates the DDF select value format. */ export function createValue(option, isMulti) {
+    if (isMulti) {
+        return Array.isArray(option) ? option.map((item)=>typeof item === 'object' ? item : {
+                value: item
+            }) : option;
+    }
+    return option;
+}
+function InternalSelect(_0) {
+    let { value, options, label, helperText, validateOnMount, meta, isSearchable, description, isMulti, placeholder = 'Please choose', onInputChange, onSearchInput, isFetching, noOptionsMessage, hideSelectedOptions, closeMenuOnSelect: _closeMenuOnSelect, required, onChange, onFocus, onBlur, help, FormFieldGridProps = {}, TextFieldProps: _ref = {} } = _0, { inputProps: textFieldInputProps } = _ref, TextFieldProps = _object_without_properties_loose(_ref, [
+        "inputProps"
+    ]), { inputProps = {}, isClearable, isDisabled, clearable, loadingText = 'Loading...', // @data-driven-forms/common always injects classNamePrefix (a
+    // react-select concern) into its SelectComponent; keep it out of the
+    // Autocomplete spread so it never reaches the DOM (AGL-590).
+    classNamePrefix: _classNamePrefix } = _0, rest = _object_without_properties_loose(_0, [
+        "value",
+        "options",
+        "label",
+        "helperText",
+        "validateOnMount",
+        "meta",
+        "isSearchable",
+        "description",
+        "isMulti",
+        "placeholder",
+        "onInputChange",
+        "onSearchInput",
+        "isFetching",
+        "noOptionsMessage",
+        "hideSelectedOptions",
+        "closeMenuOnSelect",
+        "required",
+        "onChange",
+        "onFocus",
+        "onBlur",
+        "help",
+        "FormFieldGridProps",
+        "TextFieldProps",
+        "inputProps",
+        "isClearable",
+        "isDisabled",
+        "clearable",
+        "loadingText",
+        "classNamePrefix"
+    ]);
+    const invalid = validationError(meta, validateOnMount);
+    // When isMulti is true, parseInternalValue always creates a new array; keep
+    // the reference stable across renders.
+    const internalValue = useMemo(()=>parseInternalValue(value, isMulti), [
+        value,
+        isMulti
+    ]);
+    // Selects ship with `disableClearable` on by default here, so the
+    // Autocomplete's own ✕ never appears and a chosen option could not be
+    // taken back off (AGL-2486). One affordance for every field type beats
+    // flipping that default, which would move the control for some fields
+    // and not others.
+    const clear = buildFieldClear({
+        clearable,
+        label,
+        hasValue: Array.isArray(internalValue) ? internalValue.length > 0 : internalValue !== undefined && internalValue !== null && internalValue !== '',
+        locked: Boolean(isDisabled),
+        onClear: ()=>onChange(createValue(null, !!isMulti))
+    });
+    return /*#__PURE__*/ _jsx(FormFieldGrid, _extends({
+        help: help,
+        clear: clear
+    }, FormFieldGridProps, {
+        children: /*#__PURE__*/ _jsx(Autocomplete, _extends({
+            filterSelectedOptions: hideSelectedOptions,
+            disabled: isDisabled,
+            disableClearable: isClearable,
+            popupIcon: isFetching ? /*#__PURE__*/ _jsx(CircularProgress, {
+                size: 20,
+                color: "inherit"
+            }) : /*#__PURE__*/ _jsx(ArrowDropDownIcon, {}),
+            fullWidth: true,
+            loadingText: loadingText
+        }, rest, {
+            renderInput: (params)=>{
+                var _params_slotProps;
+                return /*#__PURE__*/ _jsx(TextField, _extends({
+                    onFocus: onFocus,
+                    onBlur: onBlur
+                }, params, {
+                    required: required,
+                    error: !!invalid,
+                    helperText: invalid || (meta.touched || validateOnMount) && meta.warning || helperText || description,
+                    label: label,
+                    margin: "normal"
+                }, TextFieldProps, {
+                    slotProps: _extends({}, params.slotProps, TextFieldProps.slotProps, {
+                        htmlInput: _extends({}, (_params_slotProps = params.slotProps) == null ? void 0 : _params_slotProps.htmlInput, textFieldInputProps, inputProps, {
+                            readOnly: !isSearchable,
+                            placeholder: !internalValue || internalValue.length === 0 ? placeholder : undefined
+                        })
+                    })
+                }));
+            },
+            noOptionsText: noOptionsMessage && noOptionsMessage(),
+            /*
+         * The REASON travels with the text.
+         *
+         * Autocomplete emits this for a typed character (`input`), for the
+         * field taking its own value back (`reset` — which fires on mount and
+         * again on every selection) and for the clear button (`clear`). A
+         * handler that treats all three alike cannot tell somebody searching
+         * from the field describing itself, and one that spends a read per
+         * query would spend one on simply opening the panel.
+         */ onInputChange: (_event, value, reason)=>{
+                onInputChange == null ? void 0 : onInputChange(value, reason);
+                onSearchInput == null ? void 0 : onSearchInput(value, reason);
+            },
+            options: options,
+            multiple: isMulti,
+            getOptionLabel: (option)=>getOptionLabel(option, options),
+            value: typeof internalValue === 'undefined' ? null : internalValue,
+            onChange: (_event, option)=>onChange(createValue(option, !!isMulti)),
+            loading: isFetching
+        }))
+    }));
+}
+// The common Select's prop types are renderer-version specific; pass through.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const DDFSelect = DDFSelectImport;
+export function Select(props) {
+    const _useFieldApi = useFieldApi(props), { input, isRequired, isDisabled, isReadOnly, disabled, multiple, isMulti, isClearable, disableClearable, loadingMessage, loadingText, noOptionsMessage, noOptionsText, closeMenuOnSelect } = _useFieldApi, rest = _object_without_properties_loose(_useFieldApi, [
+        "input",
+        "isRequired",
+        "isDisabled",
+        "isReadOnly",
+        "disabled",
+        "multiple",
+        "isMulti",
+        "isClearable",
+        "disableClearable",
+        "loadingMessage",
+        "loadingText",
+        "noOptionsMessage",
+        "noOptionsText",
+        "closeMenuOnSelect"
+    ]);
+    return /*#__PURE__*/ _jsx(DDFSelect, _extends({}, input, {
+        isMulti: multiple || isMulti,
+        required: isRequired,
+        disabled: isDisabled || isReadOnly || disabled,
+        disableClearable: !isClearable || disableClearable,
+        loadingText: loadingMessage || loadingText,
+        noOptionsMessage: noOptionsMessage || noOptionsText,
+        closeMenuOnSelect: closeMenuOnSelect
+    }, rest, {
+        SelectComponent: InternalSelect
+    }));
+}
+export default Select;
+
+//# sourceMappingURL=select.js.map

package/src/lib/mapper/select.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx-forms/src/lib/mapper/select.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and\n * updated for the current MUI API (`slotProps`-shaped Autocomplete\n * `renderInput` params instead of `inputProps`).\n */\n\nimport { useMemo } from 'react'\n\nimport {\n  Autocomplete,\n  CircularProgress,\n  TextField,\n} from '@mui/material'\n\nimport ArrowDropDownIcon from '@mui/icons-material/ArrowDropDown'\n\nimport DDFSelectImport from '@data-driven-forms/common/select'\nimport parseInternalValue from '@data-driven-forms/common/select/parse-internal-value'\n\nimport { useFieldApi } from '../vendor/data-driven-forms'\nimport FormFieldGrid, {\n  buildFieldClear,\n  type FormFieldGridProps,\n} from './form-field-grid'\nimport type { BaseFieldProps, OptionValue, SelectOption, SelectValue } from './types'\nimport { type ExtendedFieldMeta, validationError } from './validation-error'\n\nexport interface SelectProps<T = OptionValue> extends BaseFieldProps {\n  options?: SelectOption<T>[]\n  loadOptions?: (inputValue: string) => Promise<SelectOption<T>[]>\n  isSearchable?: boolean\n  isMulti?: boolean\n  multiple?: boolean\n  isClearable?: boolean\n  disableClearable?: boolean\n  hideSelectedOptions?: boolean\n  closeMenuOnSelect?: boolean\n  isFetching?: boolean\n  noOptionsMessage?: () => string\n  noOptionsText?: () => string\n  loadingMessage?: string\n  loadingText?: string\n  placeholder?: string\n  /** Offer the reset-to-unset affordance (AGL-2486). */\n  clearable?: boolean\n  FormFieldGridProps?: FormFieldGridProps\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TextFieldProps?: Record<string, any>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  inputProps?: Record<string, any>\n  onInputChange?: (value: string, reason?: string) => void\n  /**\n   * A schema field's own hook on the search box, beside DDF's.\n   *\n   * `onInputChange` cannot be one. `@data-driven-forms/common/select` owns\n   * that prop for its `loadOptions` support and assigns it AFTER spreading the\n   * field's props, so a handler declared on a schema field is overwritten\n   * before it reaches this component — silently, since a dropdown with a\n   * dropped handler still opens, still filters and still selects. A field\n   * whose typing was supposed to fetch more simply fetches nothing.\n   *\n   * This name is not taken, so it survives the spread. Both are called.\n   */\n  onSearchInput?: (value: string, reason?: string) => void\n}\n\n/** Returns label of the selected option. */\nexport function getOptionLabel<T = OptionValue>(\n  option: T | SelectOption<T> | undefined,\n  options: SelectOption<T>[],\n): string {\n  if (typeof option === 'undefined') {\n    return ''\n  }\n\n  if ((option as unknown) === '') {\n    return ''\n  }\n\n  if (Array.isArray(option) && option.length === 0) {\n    return ''\n  }\n\n  if (typeof option === 'object' && option !== null) {\n    return String((option as SelectOption<T>).label)\n  }\n\n  const item = options.find(({ value }) => value === option)\n  return (item && String(item.label)) || ''\n}\n\n/** Creates the DDF select value format. */\nexport function createValue<T = OptionValue>(\n  option: T | SelectOption<T> | (T | SelectOption<T>)[] | null,\n  isMulti: boolean,\n): T | SelectOption<T> | (T | SelectOption<T>)[] | null | undefined {\n  if (isMulti) {\n    return Array.isArray(option)\n      ? option.map((item) =>\n          typeof item === 'object' ? item : ({ value: item } as SelectOption<T>),\n        )\n      : option\n  }\n\n  return option\n}\n\ninterface InternalSelectProps<T = OptionValue> {\n  value: SelectValue<T>\n  options: SelectOption<T>[]\n  label?: string\n  helperText?: string\n  validateOnMount?: boolean\n  meta: ExtendedFieldMeta\n  isSearchable?: boolean\n  description?: string\n  isMulti?: boolean\n  placeholder?: string\n  onInputChange?: (value: string, reason?: string) => void\n  onSearchInput?: (value: string, reason?: string) => void\n  isFetching?: boolean\n  noOptionsMessage?: () => string\n  hideSelectedOptions?: boolean\n  closeMenuOnSelect?: boolean\n  required?: boolean\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  onChange: (value: any) => void\n  onFocus?: () => void\n  onBlur?: () => void\n  FormFieldGridProps?: FormFieldGridProps\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TextFieldProps?: Record<string, any>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  inputProps?: Record<string, any>\n  isClearable?: boolean\n  isDisabled?: boolean\n  loadingText?: string\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  [key: string]: any\n}\n\nfunction InternalSelect<T = OptionValue>({\n  value,\n  options,\n  label,\n  helperText,\n  validateOnMount,\n  meta,\n  isSearchable,\n  description,\n  isMulti,\n  placeholder = 'Please choose',\n  onInputChange,\n  onSearchInput,\n  isFetching,\n  noOptionsMessage,\n  hideSelectedOptions,\n  closeMenuOnSelect: _closeMenuOnSelect,\n  required,\n  onChange,\n  onFocus,\n  onBlur,\n  help,\n  FormFieldGridProps = {},\n  TextFieldProps: { inputProps: textFieldInputProps, ...TextFieldProps } = {},\n  inputProps = {},\n  isClearable,\n  isDisabled,\n  clearable,\n  loadingText = 'Loading...',\n  // @data-driven-forms/common always injects classNamePrefix (a\n  // react-select concern) into its SelectComponent; keep it out of the\n  // Autocomplete spread so it never reaches the DOM (AGL-590).\n  classNamePrefix: _classNamePrefix,\n  ...rest\n}: InternalSelectProps<T>) {\n  const invalid = validationError(meta, validateOnMount)\n  // When isMulti is true, parseInternalValue always creates a new array; keep\n  // the reference stable across renders.\n  const internalValue = useMemo(\n    () => parseInternalValue(value, isMulti),\n    [value, isMulti],\n  )\n\n  // Selects ship with `disableClearable` on by default here, so the\n  // Autocomplete's own ✕ never appears and a chosen option could not be\n  // taken back off (AGL-2486). One affordance for every field type beats\n  // flipping that default, which would move the control for some fields\n  // and not others.\n  const clear = buildFieldClear({\n    clearable,\n    label,\n    hasValue: Array.isArray(internalValue)\n      ? internalValue.length > 0\n      : internalValue !== undefined &&\n        internalValue !== null &&\n        internalValue !== '',\n    locked: Boolean(isDisabled),\n    onClear: () => onChange(createValue(null, !!isMulti)),\n  })\n\n  return (\n    <FormFieldGrid help={help} clear={clear} {...FormFieldGridProps}>\n      <Autocomplete\n        filterSelectedOptions={hideSelectedOptions}\n        disabled={isDisabled}\n        disableClearable={isClearable}\n        popupIcon={\n          isFetching ? (\n            <CircularProgress size={20} color=\"inherit\" />\n          ) : (\n            <ArrowDropDownIcon />\n          )\n        }\n        fullWidth\n        loadingText={loadingText}\n        {...rest}\n        renderInput={(params) => (\n          <TextField\n            onFocus={onFocus}\n            onBlur={onBlur}\n            {...params}\n            required={required}\n            error={!!invalid}\n            helperText={\n              invalid ||\n              ((meta.touched || validateOnMount) && meta.warning) ||\n              helperText ||\n              description\n            }\n            label={label}\n            margin=\"normal\"\n            {...TextFieldProps}\n            slotProps={{\n              ...params.slotProps,\n              ...TextFieldProps.slotProps,\n              htmlInput: {\n                ...params.slotProps?.htmlInput,\n                ...textFieldInputProps,\n                ...inputProps,\n                readOnly: !isSearchable,\n                placeholder:\n                  !internalValue ||\n                  (internalValue as unknown[]).length === 0\n                    ? placeholder\n                    : undefined,\n              },\n            }}\n          />\n        )}\n        noOptionsText={noOptionsMessage && noOptionsMessage()}\n        /*\n         * The REASON travels with the text.\n         *\n         * Autocomplete emits this for a typed character (`input`), for the\n         * field taking its own value back (`reset` — which fires on mount and\n         * again on every selection) and for the clear button (`clear`). A\n         * handler that treats all three alike cannot tell somebody searching\n         * from the field describing itself, and one that spends a read per\n         * query would spend one on simply opening the panel.\n         */\n        onInputChange={(_event, value, reason) => {\n          onInputChange?.(value, reason)\n          onSearchInput?.(value, reason)\n        }}\n        options={options}\n        multiple={isMulti}\n        getOptionLabel={(option) =>\n          getOptionLabel(option as T | SelectOption<T>, options)\n        }\n        value={typeof internalValue === 'undefined' ? null : internalValue}\n        onChange={(_event, option) =>\n          onChange(createValue(option as SelectOption<T> | null, !!isMulti))\n        }\n        loading={isFetching}\n      />\n    </FormFieldGrid>\n  )\n}\n\n// The common Select's prop types are renderer-version specific; pass through.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst DDFSelect = DDFSelectImport as React.ComponentType<any>\n\nexport function Select<T = OptionValue>(props: SelectProps<T>) {\n  const {\n    input,\n    isRequired,\n    isDisabled,\n    isReadOnly,\n    disabled,\n    multiple,\n    isMulti,\n    isClearable,\n    disableClearable,\n    loadingMessage,\n    loadingText,\n    noOptionsMessage,\n    noOptionsText,\n    closeMenuOnSelect,\n    ...rest\n  } = useFieldApi(props)\n\n  return (\n    <DDFSelect\n      {...input}\n      isMulti={multiple || isMulti}\n      required={isRequired}\n      disabled={isDisabled || isReadOnly || disabled}\n      disableClearable={!isClearable || disableClearable}\n      loadingText={loadingMessage || loadingText}\n      noOptionsMessage={noOptionsMessage || noOptionsText}\n      closeMenuOnSelect={closeMenuOnSelect}\n      {...rest}\n      SelectComponent={InternalSelect}\n    />\n  )\n}\n\nexport default Select\n"],"names":["useMemo","Autocomplete","CircularProgress","TextField","ArrowDropDownIcon","DDFSelectImport","parseInternalValue","useFieldApi","FormFieldGrid","buildFieldClear","validationError","getOptionLabel","option","options","Array","isArray","length","String","label","item","find","value","createValue","isMulti","map","InternalSelect","helperText","validateOnMount","meta","isSearchable","description","placeholder","onInputChange","onSearchInput","isFetching","noOptionsMessage","hideSelectedOptions","closeMenuOnSelect","_closeMenuOnSelect","required","onChange","onFocus","onBlur","help","FormFieldGridProps","TextFieldProps","inputProps","textFieldInputProps","isClearable","isDisabled","clearable","loadingText","classNamePrefix","_classNamePrefix","rest","invalid","internalValue","clear","hasValue","undefined","locked","Boolean","onClear","filterSelectedOptions","disabled","disableClearable","popupIcon","size","color","fullWidth","renderInput","params","error","touched","warning","margin","slotProps","htmlInput","readOnly","noOptionsText","_event","reason","multiple","loading","DDFSelect","Select","props","input","isRequired","isReadOnly","loadingMessage","SelectComponent"],"mappings":"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"}

package/src/lib/mapper/slider.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and
+ * updated for the current MUI Grid API.
+ */
+import type { ReactNode } from 'react';
+import { type FormControlProps, type FormGroupProps, type FormHelperTextProps, type FormLabelProps, type GridProps, type SliderProps as MuiSliderProps } from '@mui/material';
+import { type FormFieldGridProps } from './form-field-grid';
+import type { BaseFieldProps } from './types';
+export interface SliderProps extends BaseFieldProps {
+    FormFieldGridProps?: FormFieldGridProps;
+    FormControlProps?: FormControlProps;
+    FormGroupProps?: FormGroupProps;
+    FormLabelProps?: FormLabelProps;
+    FormHelperTextProps?: FormHelperTextProps;
+    before?: ReactNode;
+    after?: ReactNode;
+    InputGridProps?: GridProps;
+    BeforeGridProps?: GridProps;
+    SliderGridProps?: GridProps;
+    AfterGridProps?: GridProps;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Offer the reset-to-unset affordance (AGL-2486). */
+    clearable?: boolean;
+    SliderProps?: Omit<MuiSliderProps, 'name' | 'value' | 'onChange' | 'onBlur' | 'onFocus'>;
+}
+export declare const Slider: (props: SliderProps) => import("react").JSX.Element;
+export default Slider;

package/src/lib/mapper/slider.js

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and
+ * updated for the current MUI Grid API.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FormControl, FormGroup, FormHelperText, FormLabel, Grid, Slider as MuiSlider } from "@mui/material";
+import { useFieldApi } from "../vendor/data-driven-forms.js";
+import FormFieldGrid, { buildFieldClear } from "./form-field-grid.js";
+import { validationError } from "./validation-error.js";
+export const Slider = (props)=>{
+    const _useFieldApi = useFieldApi(props), { input, isReadOnly, isDisabled, isRequired, label, helperText, description, validateOnMount, meta, help, FormFieldGridProps = {}, FormControlProps = {}, FormGroupProps = {}, FormLabelProps = {}, FormHelperTextProps = {}, before, after, InputGridProps = {}, BeforeGridProps = {}, SliderGridProps = {}, AfterGridProps = {}, min = 0, max = 100, clearable, SliderProps = {} } = _useFieldApi, rest = _object_without_properties_loose(_useFieldApi, [
+        "input",
+        "isReadOnly",
+        "isDisabled",
+        "isRequired",
+        "label",
+        "helperText",
+        "description",
+        "validateOnMount",
+        "meta",
+        "help",
+        "FormFieldGridProps",
+        "FormControlProps",
+        "FormGroupProps",
+        "FormLabelProps",
+        "FormHelperTextProps",
+        "before",
+        "after",
+        "InputGridProps",
+        "BeforeGridProps",
+        "SliderGridProps",
+        "AfterGridProps",
+        "min",
+        "max",
+        "clearable",
+        "SliderProps"
+    ]);
+    const invalid = validationError(meta, validateOnMount);
+    const text = invalid || (meta.touched || validateOnMount) && meta.warning || helperText || description;
+    const defaultValue = (max + min) / 2;
+    // `0` is a position a slider can hold, so only nothing at all shows the
+    // midpoint — a falsy test drew a stored 0 in the middle of the track.
+    const unset = input.value === '' || input.value === undefined || input.value === null;
+    const clear = buildFieldClear({
+        clearable,
+        label,
+        hasValue: !unset,
+        locked: Boolean(isDisabled || isReadOnly),
+        onClear: ()=>input.onChange(undefined)
+    });
+    return /*#__PURE__*/ _jsx(FormFieldGrid, _extends({
+        help: help,
+        clear: clear
+    }, FormFieldGridProps, {
+        children: /*#__PURE__*/ _jsx(FormControl, _extends({
+            fullWidth: true,
+            required: isRequired,
+            error: !!invalid,
+            component: "fieldset"
+        }, FormControlProps, {
+            children: /*#__PURE__*/ _jsxs(FormGroup, _extends({}, FormGroupProps, {
+                children: [
+                    /*#__PURE__*/ _jsx(FormLabel, _extends({
+                        component: "legend"
+                    }, FormLabelProps, {
+                        children: label
+                    })),
+                    /*#__PURE__*/ _jsxs(Grid, _extends({
+                        container: true,
+                        spacing: 2,
+                        alignItems: "center"
+                    }, InputGridProps, {
+                        children: [
+                            before && /*#__PURE__*/ _jsx(Grid, _extends({}, BeforeGridProps, {
+                                children: before
+                            })),
+                            /*#__PURE__*/ _jsx(Grid, _extends({
+                                size: "grow"
+                            }, SliderGridProps, {
+                                children: /*#__PURE__*/ _jsx(MuiSlider, _extends({}, input, {
+                                    value: unset ? defaultValue : input.value,
+                                    min: min,
+                                    max: max,
+                                    disabled: isDisabled || isReadOnly,
+                                    onChange: (_e, value)=>input.onChange(value)
+                                }, SliderProps, rest))
+                            })),
+                            after && /*#__PURE__*/ _jsx(Grid, _extends({}, AfterGridProps, {
+                                children: after
+                            }))
+                        ]
+                    })),
+                    text && /*#__PURE__*/ _jsx(FormHelperText, _extends({}, FormHelperTextProps, {
+                        children: text
+                    }))
+                ]
+            }))
+        }))
+    }));
+};
+export default Slider;
+
+//# sourceMappingURL=slider.js.map

package/src/lib/mapper/slider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx-forms/src/lib/mapper/slider.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and\n * updated for the current MUI Grid API.\n */\n\nimport type { ReactNode } from 'react'\n\nimport {\n  FormControl,\n  type FormControlProps,\n  FormGroup,\n  type FormGroupProps,\n  FormHelperText,\n  type FormHelperTextProps,\n  FormLabel,\n  type FormLabelProps,\n  Grid,\n  type GridProps,\n  Slider as MuiSlider,\n  type SliderProps as MuiSliderProps,\n} from '@mui/material'\n\nimport { useFieldApi } from '../vendor/data-driven-forms'\nimport FormFieldGrid, {\n  buildFieldClear,\n  type FormFieldGridProps,\n} from './form-field-grid'\nimport type { BaseFieldProps } from './types'\nimport { type ExtendedFieldMeta, validationError } from './validation-error'\n\nexport interface SliderProps extends BaseFieldProps {\n  FormFieldGridProps?: FormFieldGridProps\n  FormControlProps?: FormControlProps\n  FormGroupProps?: FormGroupProps\n  FormLabelProps?: FormLabelProps\n  FormHelperTextProps?: FormHelperTextProps\n  before?: ReactNode\n  after?: ReactNode\n  InputGridProps?: GridProps\n  BeforeGridProps?: GridProps\n  SliderGridProps?: GridProps\n  AfterGridProps?: GridProps\n  min?: number\n  max?: number\n  step?: number\n  /** Offer the reset-to-unset affordance (AGL-2486). */\n  clearable?: boolean\n  SliderProps?: Omit<\n    MuiSliderProps,\n    'name' | 'value' | 'onChange' | 'onBlur' | 'onFocus'\n  >\n}\n\nexport const Slider = (props: SliderProps) => {\n  const {\n    input,\n    isReadOnly,\n    isDisabled,\n    isRequired,\n    label,\n    helperText,\n    description,\n    validateOnMount,\n    meta,\n    help,\n    FormFieldGridProps = {},\n    FormControlProps = {},\n    FormGroupProps = {},\n    FormLabelProps = {},\n    FormHelperTextProps = {},\n    before,\n    after,\n    InputGridProps = {},\n    BeforeGridProps = {},\n    SliderGridProps = {},\n    AfterGridProps = {},\n    min = 0,\n    max = 100,\n    clearable,\n    SliderProps = {},\n    ...rest\n  } = useFieldApi(props)\n\n  const invalid = validationError(meta as ExtendedFieldMeta, validateOnMount)\n  const text =\n    invalid ||\n    ((meta.touched || validateOnMount) && meta.warning) ||\n    helperText ||\n    description\n\n  const defaultValue = (max + min) / 2\n  // `0` is a position a slider can hold, so only nothing at all shows the\n  // midpoint — a falsy test drew a stored 0 in the middle of the track.\n  const unset =\n    input.value === '' || input.value === undefined || input.value === null\n  const clear = buildFieldClear({\n    clearable,\n    label,\n    hasValue: !unset,\n    locked: Boolean(isDisabled || isReadOnly),\n    onClear: () => input.onChange(undefined),\n  })\n\n  return (\n    <FormFieldGrid help={help} clear={clear} {...FormFieldGridProps}>\n      <FormControl\n        fullWidth\n        required={isRequired}\n        error={!!invalid}\n        component=\"fieldset\"\n        {...FormControlProps}\n      >\n        <FormGroup {...FormGroupProps}>\n          <FormLabel component=\"legend\" {...FormLabelProps}>\n            {label}\n          </FormLabel>\n          <Grid container spacing={2} alignItems=\"center\" {...InputGridProps}>\n            {before && <Grid {...BeforeGridProps}>{before}</Grid>}\n            <Grid size=\"grow\" {...SliderGridProps}>\n              <MuiSlider\n                {...input}\n                value={unset ? defaultValue : input.value}\n                min={min}\n                max={max}\n                disabled={isDisabled || isReadOnly}\n                onChange={(_e, value) => input.onChange(value)}\n                {...SliderProps}\n                {...rest}\n              />\n            </Grid>\n            {after && <Grid {...AfterGridProps}>{after}</Grid>}\n          </Grid>\n          {text && (\n            <FormHelperText {...FormHelperTextProps}>{text}</FormHelperText>\n          )}\n        </FormGroup>\n      </FormControl>\n    </FormFieldGrid>\n  )\n}\n\nexport default Slider\n"],"names":["FormControl","FormGroup","FormHelperText","FormLabel","Grid","Slider","MuiSlider","useFieldApi","FormFieldGrid","buildFieldClear","validationError","props","input","isReadOnly","isDisabled","isRequired","label","helperText","description","validateOnMount","meta","help","FormFieldGridProps","FormControlProps","FormGroupProps","FormLabelProps","FormHelperTextProps","before","after","InputGridProps","BeforeGridProps","SliderGridProps","AfterGridProps","min","max","clearable","SliderProps","rest","invalid","text","touched","warning","defaultValue","unset","value","undefined","clear","hasValue","locked","Boolean","onClear","onChange","fullWidth","required","error","component","container","spacing","alignItems","size","disabled","_e"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;CAGC;;;AAID,SACEA,WAAW,EAEXC,SAAS,EAETC,cAAc,EAEdC,SAAS,EAETC,IAAI,EAEJC,UAAUC,SAAS,QAEd,gBAAe;AAEtB,SAASC,WAAW,QAAQ,iCAA6B;AACzD,OAAOC,iBACLC,eAAe,QAEV,uBAAmB;AAE1B,SAAiCC,eAAe,QAAQ,wBAAoB;AAyB5E,OAAO,MAAML,SAAS,CAACM;IACrB,MA2BIJ,eAAAA,YAAYI,QA3BV,EACJC,KAAK,EACLC,UAAU,EACVC,UAAU,EACVC,UAAU,EACVC,KAAK,EACLC,UAAU,EACVC,WAAW,EACXC,eAAe,EACfC,IAAI,EACJC,IAAI,EACJC,qBAAqB,CAAC,CAAC,EACvBC,mBAAmB,CAAC,CAAC,EACrBC,iBAAiB,CAAC,CAAC,EACnBC,iBAAiB,CAAC,CAAC,EACnBC,sBAAsB,CAAC,CAAC,EACxBC,MAAM,EACNC,KAAK,EACLC,iBAAiB,CAAC,CAAC,EACnBC,kBAAkB,CAAC,CAAC,EACpBC,kBAAkB,CAAC,CAAC,EACpBC,iBAAiB,CAAC,CAAC,EACnBC,MAAM,CAAC,EACPC,MAAM,GAAG,EACTC,SAAS,EACTC,cAAc,CAAC,CAAC,EAEjB,GAAG7B,cADC8B,wCACD9B;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEJ,MAAM+B,UAAU5B,gBAAgBU,MAA2BD;IAC3D,MAAMoB,OACJD,WACC,AAAClB,CAAAA,KAAKoB,OAAO,IAAIrB,eAAc,KAAMC,KAAKqB,OAAO,IAClDxB,cACAC;IAEF,MAAMwB,eAAe,AAACR,CAAAA,MAAMD,GAAE,IAAK;IACnC,wEAAwE;IACxE,sEAAsE;IACtE,MAAMU,QACJ/B,MAAMgC,KAAK,KAAK,MAAMhC,MAAMgC,KAAK,KAAKC,aAAajC,MAAMgC,KAAK,KAAK;IACrE,MAAME,QAAQrC,gBAAgB;QAC5B0B;QACAnB;QACA+B,UAAU,CAACJ;QACXK,QAAQC,QAAQnC,cAAcD;QAC9BqC,SAAS,IAAMtC,MAAMuC,QAAQ,CAACN;IAChC;IAEA,qBACE,KAACrC;QAAca,MAAMA;QAAMyB,OAAOA;OAAWxB;kBAC3C,cAAA,KAACtB;YACCoD,SAAS;YACTC,UAAUtC;YACVuC,OAAO,CAAC,CAAChB;YACTiB,WAAU;WACNhC;sBAEJ,cAAA,MAACtB,wBAAcuB;;kCACb,KAACrB;wBAAUoD,WAAU;uBAAa9B;kCAC/BT;;kCAEH,MAACZ;wBAAKoD,SAAS;wBAACC,SAAS;wBAAGC,YAAW;uBAAa7B;;4BACjDF,wBAAU,KAACvB,mBAAS0B;0CAAkBH;;0CACvC,KAACvB;gCAAKuD,MAAK;+BAAW5B;0CACpB,cAAA,KAACzB,wBACKM;oCACJgC,OAAOD,QAAQD,eAAe9B,MAAMgC,KAAK;oCACzCX,KAAKA;oCACLC,KAAKA;oCACL0B,UAAU9C,cAAcD;oCACxBsC,UAAU,CAACU,IAAIjB,QAAUhC,MAAMuC,QAAQ,CAACP;mCACpCR,aACAC;;4BAGPT,uBAAS,KAACxB,mBAAS4B;0CAAiBJ;;;;oBAEtCW,sBACC,KAACrC,6BAAmBwB;kCAAsBa;;;;;;AAMtD,EAAC;AAED,eAAelC,OAAM"}

package/src/lib/mapper/stored-field-value.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Whether a field holds a value of its own, read from the form rather than
+ * from `input`: final-form hands a checkbox or a radio group `checked`, and
+ * `input.value` there is the option's value, not the stored one. `false` is a
+ * value someone chose; only nothing at all is unset.
+ */
+export declare function useStoredFieldHasValue(name: string): boolean;

package/src/lib/mapper/stored-field-value.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { useFormApi } from "../vendor/data-driven-forms.js";
+/**
+ * Whether a field holds a value of its own, read from the form rather than
+ * from `input`: final-form hands a checkbox or a radio group `checked`, and
+ * `input.value` there is the option's value, not the stored one. `false` is a
+ * value someone chose; only nothing at all is unset.
+ */ export function useStoredFieldHasValue(name) {
+    var _formApi_getFieldState, _formApi_getFieldState1;
+    const formApi = useFormApi();
+    const stored = formApi == null ? void 0 : (_formApi_getFieldState1 = formApi.getFieldState) == null ? void 0 : (_formApi_getFieldState = _formApi_getFieldState1.call(formApi, name)) == null ? void 0 : _formApi_getFieldState.value;
+    return stored !== undefined && stored !== null && stored !== '';
+}
+
+//# sourceMappingURL=stored-field-value.js.map

package/src/lib/mapper/stored-field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx-forms/src/lib/mapper/stored-field-value.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useFormApi } from '../vendor/data-driven-forms'\n\n/**\n * Whether a field holds a value of its own, read from the form rather than\n * from `input`: final-form hands a checkbox or a radio group `checked`, and\n * `input.value` there is the option's value, not the stored one. `false` is a\n * value someone chose; only nothing at all is unset.\n */\nexport function useStoredFieldHasValue(name: string): boolean {\n  const formApi = useFormApi()\n  const stored = formApi?.getFieldState?.(name)?.value\n  return stored !== undefined && stored !== null && stored !== ''\n}\n"],"names":["useFormApi","useStoredFieldHasValue","name","formApi","stored","getFieldState","value","undefined"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,UAAU,QAAQ,iCAA6B;AAExD;;;;;CAKC,GACD,OAAO,SAASC,uBAAuBC,IAAY;QAElCC,wBAAAA;IADf,MAAMA,UAAUH;IAChB,MAAMI,SAASD,4BAAAA,0BAAAA,QAASE,aAAa,sBAAtBF,yBAAAA,6BAAAA,SAAyBD,0BAAzBC,uBAAgCG,KAAK;IACpD,OAAOF,WAAWG,aAAaH,WAAW,QAAQA,WAAW;AAC/D"}

package/src/lib/mapper/sub-form.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Ported from `@data-driven-forms/mui-component-mapper` (Apache-2.0) and
+ * updated for the current MUI APIs (Grid `size`, no Typography `paragraph`).
+ */
+import { type HelpTipContent } from '@aglyn/shared-ui-jsx';
+import type { ReactNode } from 'react';
+import { type GridProps, type TypographyProps } from '@mui/material';
+import { type FieldSchema } from '../vendor/data-driven-forms';
+export interface SubFormProps extends Omit<GridProps, 'component' | 'title'> {
+    fields: FieldSchema[];
+    title?: ReactNode;
+    description?: ReactNode;
+    component?: string;
+    /** Contextual help affordance rendered beside the section title (AGL-601). */
+    help?: HelpTipContent;
+    TitleGridProps?: GridProps;
+    TitleProps?: TypographyProps;
+    DescriptionProps?: TypographyProps;
+    DescriptionGridProps?: GridProps;
+    ItemsGridProps?: GridProps;
+}
+export declare const SubForm: ({ fields, title, description, component: _component, help, TitleGridProps, TitleProps, DescriptionProps, DescriptionGridProps, ItemsGridProps, ...rest }: SubFormProps) => import("react").JSX.Element;
+export default SubForm;