@gravity-ui/dynamic-forms 3.1.0 → 3.3.0

package/build/cjs/lib/core/components/Form/Controller/Controller.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Controller = void 0;
+const tslib_1 = require("tslib");
+const react_1 = tslib_1.__importDefault(require("react"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const hooks_1 = require("../hooks");
+const utils_1 = require("./utils");
+const Controller = ({ spec: _spec, name, value: valueFromParent, parentOnChange, parentOnUnmount, }) => {
+    const { config, tools, mutators, __mirror } = (0, hooks_1.useDynamicFormsCtx)();
+    const firstRenderRef = react_1.default.useRef(true);
+    const [store, setStore] = react_1.default.useState((0, utils_1.initializeStore)({
+        name,
+        spec: _spec,
+        mutators,
+        config,
+        valueFromParent,
+        tools,
+        parentOnChange,
+        parentOnUnmount,
+    }));
+    const { methods, fieldMethods } = react_1.default.useMemo(() => {
+        const fieldMethods = (0, utils_1.getFieldMethods)();
+        const onChange = (valOrSetter, childErrors, errorMutator) => {
+            setStore((store) => fieldMethods.onChange(store, { valOrSetter, childErrors, errorMutator }));
+        };
+        const onDrop = () => {
+            setStore((store) => fieldMethods.onDrop(store, undefined));
+        };
+        const onBlur = () => {
+            setStore((store) => fieldMethods.onBlur(store, undefined));
+        };
+        const onFocus = () => {
+            setStore((store) => fieldMethods.onFocus(store, undefined));
+        };
+        const parentOnUnmount = (childName) => {
+            setStore((store) => fieldMethods.parentOnUnmount(store, childName));
+        };
+        const onItemAdd = (value) => {
+            setStore((store) => fieldMethods.onItemAdd(store, value));
+        };
+        const onItemRemove = (idx) => {
+            setStore((store) => fieldMethods.onItemRemove(store, idx));
+        };
+        return {
+            methods: {
+                onChange,
+                onDrop,
+                onBlur,
+                onFocus,
+                parentOnUnmount,
+                onItemAdd,
+                onItemRemove,
+            },
+            fieldMethods,
+        };
+    }, [setStore]);
+    const renderProps = react_1.default.useMemo(() => ({
+        input: {
+            name: store.name,
+            value: store.state.value,
+            onChange: methods.onChange,
+            onBlur: methods.onBlur,
+            onFocus: methods.onFocus,
+            onDrop: methods.onDrop,
+            parentOnUnmount: methods.parentOnUnmount,
+        },
+        arrayInput: {
+            name: store.name,
+            value: store.state.value,
+            onItemAdd: methods.onItemAdd,
+            onItemRemove: methods.onItemRemove,
+            onDrop: methods.onDrop,
+        },
+        meta: Object.assign(Object.assign({}, lodash_1.default.omit(store.state, 'value')), { submitFailed: store.tools.submitFailed }),
+    }), [methods, store.name, store.state, store.tools.submitFailed]);
+    const withSearch = (0, hooks_1.useSearch)(store.spec, store.state.value, store.name);
+    (0, hooks_1.useControllerMirror)(store.name, {
+        useField: renderProps,
+        useSearch: withSearch,
+    }, __mirror);
+    react_1.default.useEffect(() => {
+        var _a;
+        (_a = store.afterStoreUpdateCB) === null || _a === void 0 ? void 0 : _a.call(store);
+    }, [store.afterStoreUpdateCB]);
+    react_1.default.useEffect(() => {
+        if (!firstRenderRef.current) {
+            (0, utils_1.updateStore)({
+                store,
+                setStore,
+                spec: _spec,
+                name,
+                parentOnChange,
+                parentOnUnmount,
+                mutators,
+                config,
+                tools,
+                methodOnChange: fieldMethods.onChange,
+                valueFromParent,
+            });
+        }
+    }, [
+        _spec,
+        name,
+        parentOnChange,
+        parentOnUnmount,
+        mutators,
+        config,
+        tools.onChange,
+        tools.onUnmount,
+    ]);
+    react_1.default.useEffect(() => {
+        firstRenderRef.current = false;
+        return () => {
+            (0, utils_1.callUnmout)(store);
+        };
+    }, []);
+    return withSearch(store.render(renderProps));
+};
+exports.Controller = Controller;

package/build/cjs/lib/core/components/Form/Controller/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./Controller"), exports);

package/build/cjs/lib/core/components/Form/Controller/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/cjs/lib/core/components/Form/Controller/utils.js

@@ -0,0 +1,305 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateStore = exports.initializeStore = exports.getFieldMethods = exports.getFieldInitials = exports.getValidate = exports.getRender = exports.getComponents = exports.getSpec = exports.callUnmout = exports.updateParentStore = void 0;
+const tslib_1 = require("tslib");
+const react_1 = tslib_1.__importDefault(require("react"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const react_is_1 = require("react-is");
+const constants_1 = require("../../../constants");
+const helpers_1 = require("../../../helpers");
+const constants_2 = require("../constants");
+const utils_1 = require("../utils");
+const isErrorMutatorCorrect = (errorMutator) => errorMutator !== constants_2.EMPTY_MUTATOR && (lodash_1.default.isString(errorMutator) || lodash_1.default.isBoolean(errorMutator));
+const isValueMutatorCorrect = (valueMutator, spec) => valueMutator !== constants_2.EMPTY_MUTATOR &&
+    (typeof valueMutator === spec.type ||
+        (lodash_1.default.isArray(valueMutator) && spec.type === constants_1.SpecTypes.Array));
+const updateParentStore = (store) => {
+    (store.parentOnChange ? store.parentOnChange : store.tools.onChange)(store.name, store.state.value, Object.assign(Object.assign({}, store.state.childErrors), { [store.name]: store.state.error }));
+};
+exports.updateParentStore = updateParentStore;
+const callUnmout = (store) => {
+    (store.parentOnUnmount ? store.parentOnUnmount : store.tools.onUnmount)(store.name);
+};
+exports.callUnmout = callUnmout;
+const getSpec = ({ name, spec, mutators, }) => {
+    const mutator = lodash_1.default.get(mutators.spec, name, constants_2.EMPTY_MUTATOR);
+    if (mutator !== constants_2.EMPTY_MUTATOR) {
+        const mutatedSpec = lodash_1.default.merge(lodash_1.default.cloneDeep(spec), mutator);
+        if ((0, helpers_1.isCorrectSpec)(mutatedSpec)) {
+            return mutatedSpec;
+        }
+    }
+    return spec;
+};
+exports.getSpec = getSpec;
+const getComponents = ({ spec, config, }) => {
+    const result = {};
+    if ((0, utils_1.isCorrectConfig)(config) && (0, helpers_1.isCorrectSpec)(spec)) {
+        const { inputs, layouts } = config[spec.type];
+        if (inputs) {
+            const entity = inputs[spec.viewSpec.type];
+            if ((0, react_is_1.isValidElementType)(entity === null || entity === void 0 ? void 0 : entity.Component)) {
+                result.inputEntity = entity;
+            }
+        }
+        if (layouts && lodash_1.default.isString(spec.viewSpec.layout)) {
+            const Component = layouts[spec.viewSpec.layout];
+            if ((0, react_is_1.isValidElementType)(Component)) {
+                result.Layout = Component;
+            }
+        }
+    }
+    return result;
+};
+exports.getComponents = getComponents;
+const getRender = ({ name, spec, inputEntity, Layout, }) => {
+    const render = (props) => {
+        if (inputEntity && (0, helpers_1.isCorrectSpec)(spec) && lodash_1.default.isString(name)) {
+            if (!spec.viewSpec.hidden) {
+                if (inputEntity.independent) {
+                    const InputComponent = inputEntity.Component;
+                    return react_1.default.createElement(InputComponent, Object.assign({ spec: spec, name: name, Layout: Layout }, props));
+                }
+                const InputComponent = inputEntity.Component;
+                const input = react_1.default.createElement(InputComponent, Object.assign({ spec: spec, name: name }, props));
+                if (Layout) {
+                    return (react_1.default.createElement(Layout, Object.assign({ spec: spec, name: name }, props), input));
+                }
+                return input;
+            }
+        }
+        return null;
+    };
+    return render;
+};
+exports.getRender = getRender;
+const getValidate = ({ spec, config, }) => {
+    let validate = () => undefined;
+    if ((0, utils_1.isCorrectConfig)(config) && (0, helpers_1.isCorrectSpec)(spec)) {
+        const { validators } = config[spec.type];
+        if (validators) {
+            if ((!lodash_1.default.isString(spec.validator) || !spec.validator.length) &&
+                lodash_1.default.isFunction(validators.base)) {
+                validate = (value) => validators.base(spec, value);
+            }
+            if (lodash_1.default.isString(spec.validator) && lodash_1.default.isFunction(validators[spec.validator])) {
+                validate = (value) => validators[spec.validator](spec, value);
+            }
+        }
+    }
+    return validate;
+};
+exports.getValidate = getValidate;
+const getFieldInitials = ({ name, spec, valueFromParent, initialValue, validate, mutators, }) => {
+    const valueMutator = (0, utils_1.transformArrIn)(lodash_1.default.get(mutators.values, name, constants_2.EMPTY_MUTATOR));
+    let value = lodash_1.default.cloneDeep(valueFromParent);
+    if (isValueMutatorCorrect(valueMutator, spec)) {
+        value = valueMutator;
+    }
+    if (lodash_1.default.isNil(value)) {
+        if (spec.defaultValue) {
+            value = (0, utils_1.transformArrIn)(spec.defaultValue);
+        }
+        // if the spec with type array or object, and this spec has "required === true",
+        // we immediately exclude empty value
+        else if (spec.required) {
+            if ((0, helpers_1.isArraySpec)(spec)) {
+                value = { [constants_2.OBJECT_ARRAY_FLAG]: true, [constants_2.OBJECT_ARRAY_CNT]: 0 };
+            }
+            else if ((0, helpers_1.isObjectSpec)(spec)) {
+                value = {};
+            }
+        }
+    }
+    let errorMutator = lodash_1.default.get(mutators.errors, name, constants_2.EMPTY_MUTATOR);
+    if (!isErrorMutatorCorrect(errorMutator)) {
+        errorMutator = undefined;
+    }
+    const error = (validate === null || validate === void 0 ? void 0 : validate((0, utils_1.transformArrOut)(value))) || errorMutator;
+    const dirty = !lodash_1.default.isEqual(value, initialValue);
+    return {
+        initialValue,
+        active: false,
+        dirty,
+        error,
+        invalid: Boolean(error),
+        modified: dirty,
+        pristine: true,
+        touched: false,
+        valid: !error,
+        value,
+        visited: false,
+        childErrors: {},
+    };
+};
+exports.getFieldInitials = getFieldInitials;
+const getFieldMethods = () => {
+    const onChange = (store, { valOrSetter, childErrors, errorMutator }) => {
+        const { state, validate, spec } = store;
+        const _value = lodash_1.default.isFunction(valOrSetter) ? valOrSetter(state.value) : valOrSetter;
+        const error = (validate === null || validate === void 0 ? void 0 : validate((0, utils_1.transformArrOut)(_value))) || errorMutator;
+        let value = (0, utils_1.transformArrIn)(_value);
+        if ((0, helpers_1.isNumberSpec)(spec) && !error) {
+            value = (value ? Number(value) : undefined);
+        }
+        let newChildErrors = Object.assign({}, state.childErrors);
+        if (childErrors) {
+            const nearestChildName = lodash_1.default.keys(childErrors).sort((a, b) => a.length - b.length)[0];
+            if (nearestChildName) {
+                const existingСhildNames = lodash_1.default.keys(newChildErrors).filter((childName) => childName.startsWith(nearestChildName));
+                newChildErrors = Object.assign(Object.assign({}, lodash_1.default.omit(newChildErrors, existingСhildNames)), childErrors);
+            }
+        }
+        const nextStore = Object.assign(Object.assign({}, store), { state: Object.assign(Object.assign({}, store.state), { dirty: !lodash_1.default.isEqual(value, state.initialValue), error, invalid: Boolean(error), modified: true, pristine: value === state.initialValue, touched: true, valid: !error, value, visited: true, childErrors: newChildErrors }) });
+        nextStore.afterStoreUpdateCB = () => (0, exports.updateParentStore)(nextStore);
+        return nextStore;
+    };
+    const onDrop = (store) => {
+        const { name } = store;
+        if ((0, utils_1.isArrayItem)(name)) {
+            const afterStoreUpdateCB = () => (0, exports.callUnmout)(store);
+            return Object.assign(Object.assign({}, store), { afterStoreUpdateCB });
+        }
+        return onChange(store, {
+            valOrSetter: undefined,
+            childErrors: { [name]: false },
+        });
+    };
+    const onBlur = (store) => {
+        return Object.assign(Object.assign({}, store), { state: Object.assign(Object.assign({}, store.state), { active: false, touched: true }) });
+    };
+    const onFocus = (store) => {
+        return Object.assign(Object.assign({}, store), { state: Object.assign(Object.assign({}, store.state), { active: true, visited: true }) });
+    };
+    const parentOnUnmount = (store, childName) => {
+        const { name, spec } = store;
+        if ((0, helpers_1.isArraySpec)(spec) || (0, helpers_1.isObjectSpec)(spec)) {
+            return onChange(store, {
+                valOrSetter: (currentValue) => currentValue
+                    ? lodash_1.default.omit(currentValue, childName.split(`${name}.`)[1])
+                    : currentValue,
+                childErrors: { [childName]: false },
+            });
+        }
+        return store;
+    };
+    const onItemAdd = (store, _value) => {
+        const { validate, state } = store;
+        const stateValue = (state.value || {
+            [constants_2.OBJECT_ARRAY_FLAG]: true,
+            [constants_2.OBJECT_ARRAY_CNT]: 0,
+        });
+        const value = Object.assign(Object.assign({}, stateValue), { [`<${stateValue[constants_2.OBJECT_ARRAY_CNT]}>`]: (0, utils_1.transformArrIn)(_value), [constants_2.OBJECT_ARRAY_CNT]: stateValue[constants_2.OBJECT_ARRAY_CNT] + 1 });
+        const error = validate === null || validate === void 0 ? void 0 : validate((0, utils_1.transformArrOut)(value));
+        const nextStore = Object.assign(Object.assign({}, store), { state: Object.assign(Object.assign({}, store.state), { dirty: !lodash_1.default.isEqual(value, store.state.initialValue), error, invalid: Boolean(error), modified: true, pristine: value === store.state.initialValue, touched: true, valid: !error, value, visited: true }) });
+        nextStore.afterStoreUpdateCB = () => (0, exports.updateParentStore)(nextStore);
+        return nextStore;
+    };
+    const onItemRemove = (store, idx) => {
+        return parentOnUnmount(store, `${store.name}.<${idx}>`);
+    };
+    return {
+        onChange,
+        onDrop,
+        onBlur,
+        onFocus,
+        parentOnUnmount,
+        onItemAdd,
+        onItemRemove,
+    };
+};
+exports.getFieldMethods = getFieldMethods;
+const initializeStore = ({ name, spec: _spec, mutators, config, valueFromParent, tools, parentOnChange, parentOnUnmount, }) => {
+    const spec = (0, exports.getSpec)({ name, spec: _spec, mutators });
+    const components = (0, exports.getComponents)({ spec, config });
+    const render = (0, exports.getRender)(Object.assign({ name, spec }, components));
+    const validate = (0, exports.getValidate)({ spec, config });
+    const state = (0, exports.getFieldInitials)({
+        name,
+        spec,
+        valueFromParent,
+        validate,
+        mutators,
+        initialValue: lodash_1.default.get(tools.initialValue, name),
+    });
+    const initialsStore = {
+        name,
+        spec,
+        initialSpec: _spec,
+        config,
+        tools,
+        mutators,
+        render,
+        validate,
+        parentOnChange,
+        parentOnUnmount,
+        state,
+    };
+    if (!lodash_1.default.isEqual(valueFromParent, state.value) || state.error) {
+        initialsStore.afterStoreUpdateCB = () => (0, exports.updateParentStore)(initialsStore);
+    }
+    return initialsStore;
+};
+exports.initializeStore = initializeStore;
+const updateStore = ({ store, setStore, spec: _spec, name, parentOnChange, parentOnUnmount, mutators, valueFromParent, config, tools, methodOnChange, }) => {
+    const storeSpecMutator = lodash_1.default.get(store.mutators.spec, store.name, constants_2.EMPTY_MUTATOR);
+    const storeValueMutator = lodash_1.default.get(store.mutators.values, store.name, constants_2.EMPTY_MUTATOR);
+    const storeErrorMutator = lodash_1.default.get(store.mutators.errors, store.name, constants_2.EMPTY_MUTATOR);
+    const specMutator = lodash_1.default.get(mutators.errors, name, constants_2.EMPTY_MUTATOR);
+    const valueMutator = lodash_1.default.get(mutators.values, name, constants_2.EMPTY_MUTATOR);
+    const errorMutator = lodash_1.default.get(mutators.errors, name, constants_2.EMPTY_MUTATOR);
+    const valueMutatorUpdated = isValueMutatorCorrect(valueMutator, (0, exports.getSpec)({ name, spec: _spec, mutators })) &&
+        valueMutator !== storeValueMutator;
+    const errorMutatorUpdated = isErrorMutatorCorrect(errorMutator) && errorMutator !== storeErrorMutator;
+    const updateState = valueMutatorUpdated || errorMutatorUpdated;
+    const updateNonCritical = parentOnChange !== store.parentOnChange ||
+        parentOnUnmount !== store.parentOnUnmount ||
+        tools.onChange !== store.tools.onChange ||
+        tools.onUnmount !== store.tools.onUnmount;
+    const updateAllStore = !lodash_1.default.isEqual(_spec, store.initialSpec) ||
+        config !== store.config ||
+        (specMutator !== constants_2.EMPTY_MUTATOR && specMutator !== storeSpecMutator);
+    const updateAllStoreAndClearParentValues = name !== store.name;
+    if (updateAllStoreAndClearParentValues) {
+        (0, exports.callUnmout)(store);
+        setStore((0, exports.initializeStore)({
+            name,
+            spec: _spec,
+            mutators,
+            config,
+            valueFromParent,
+            tools,
+            parentOnChange,
+            parentOnUnmount,
+        }));
+    }
+    else if (updateAllStore) {
+        let nextStore = Object.assign(Object.assign({}, (0, exports.initializeStore)({
+            name,
+            spec: _spec,
+            mutators,
+            config,
+            valueFromParent,
+            tools,
+            parentOnChange,
+            parentOnUnmount,
+        })), { state: store.state });
+        if (updateState) {
+            nextStore = methodOnChange(nextStore, Object.assign({ valOrSetter: (value) => valueMutatorUpdated ? valueMutator : value }, (errorMutatorUpdated ? { errorMutator } : {})));
+        }
+        setStore(nextStore);
+    }
+    else if (updateNonCritical) {
+        let nextStore = Object.assign(Object.assign({}, store), { parentOnChange,
+            parentOnUnmount,
+            tools });
+        if (updateState) {
+            nextStore = methodOnChange(nextStore, Object.assign({ valOrSetter: (value) => valueMutatorUpdated ? valueMutator : value }, (errorMutatorUpdated ? { errorMutator } : {})));
+        }
+        setStore(nextStore);
+    }
+    else if (updateState) {
+        setStore(methodOnChange(store, Object.assign({ valOrSetter: (value) => valueMutatorUpdated ? valueMutator : value }, (errorMutatorUpdated ? { errorMutator } : {}))));
+    }
+};
+exports.updateStore = updateStore;

package/build/cjs/lib/core/components/Form/DynamicField.js

@@ -9,20 +9,22 @@ const helpers_1 = require("../../helpers");
 const Controller_1 = require("./Controller");
 const hooks_1 = require("./hooks");
 const utils_1 = require("./utils");
-const DynamicField = ({ name, spec, config, Monaco, generateRandomValue, search, withoutInsertFFDebounce, errors: externalErrors, __mirror, }) => {
+const DynamicField = ({ name, spec, config, Monaco, generateRandomValue, search, withoutInsertFFDebounce, mutators: externalMutators, __mirror, }) => {
     const DynamicFormsCtx = (0, hooks_1.useCreateContext)();
     const SearchContext = (0, hooks_1.useCreateSearchContext)();
     const { tools, store } = (0, hooks_1.useStore)(name);
     const watcher = (0, hooks_1.useIntegrationFF)(store, withoutInsertFFDebounce);
+    const { mutators, mutateDFState } = (0, hooks_1.useMutators)(externalMutators);
     const { store: searchStore, setField, removeField, isHiddenField } = (0, hooks_1.useSearchStore)();
     const context = react_1.default.useMemo(() => ({
         config,
         Monaco: (0, react_is_1.isValidElementType)(Monaco) ? Monaco : undefined,
         generateRandomValue,
-        tools,
-        externalErrors,
+        tools: Object.assign(Object.assign({}, tools), { mutateDFState }),
+        store,
+        mutators,
         __mirror,
-    }), [tools, config, Monaco, __mirror, generateRandomValue, externalErrors]);
+    }), [tools, config, Monaco, __mirror, generateRandomValue, mutators, mutateDFState, store]);
     const searchContext = react_1.default.useMemo(() => ({
         setField,
         removeField,

package/build/cjs/lib/core/components/Form/constants.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SPEC_TYPE_FOR_GENERATE_BUTTON = exports.OBJECT_ARRAY_CNT = exports.OBJECT_ARRAY_FLAG = void 0;
+exports.EMPTY_MUTATOR = exports.SPEC_TYPE_FOR_GENERATE_BUTTON = exports.OBJECT_ARRAY_CNT = exports.OBJECT_ARRAY_FLAG = void 0;
 exports.OBJECT_ARRAY_FLAG = '____arr-obj';
 exports.OBJECT_ARRAY_CNT = '____arr-obj-cnt';
 exports.SPEC_TYPE_FOR_GENERATE_BUTTON = ['base', 'password', 'textarea'];
+exports.EMPTY_MUTATOR = '____empty-mutator';

package/build/cjs/lib/core/components/Form/hooks/index.js

@@ -1,17 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./useComponents"), exports);
 tslib_1.__exportStar(require("./useControllerMirror"), exports);
 tslib_1.__exportStar(require("./useCreateContext"), exports);
 tslib_1.__exportStar(require("./useDynamicFieldMirror"), exports);
 tslib_1.__exportStar(require("./useDynamicFormsCtx"), exports);
-tslib_1.__exportStar(require("./useField"), exports);
 tslib_1.__exportStar(require("./useGenerateRandomValue"), exports);
 tslib_1.__exportStar(require("./useIntegrationFF"), exports);
-tslib_1.__exportStar(require("./useRender"), exports);
+tslib_1.__exportStar(require("./useMutateDFState"), exports);
+tslib_1.__exportStar(require("./useMutators"), exports);
 tslib_1.__exportStar(require("./useStore"), exports);
-tslib_1.__exportStar(require("./useValidate"), exports);
+tslib_1.__exportStar(require("./useStoreValue"), exports);
 tslib_1.__exportStar(require("./useMonaco"), exports);
 tslib_1.__exportStar(require("./useSearchStore"), exports);
 tslib_1.__exportStar(require("./useSearchContext"), exports);

package/build/cjs/lib/core/components/Form/hooks/useMutateDFState.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMutateDFState = void 0;
+const useDynamicFormsCtx_1 = require("./useDynamicFormsCtx");
+const useMutateDFState = () => (0, useDynamicFormsCtx_1.useDynamicFormsCtx)().tools.mutateDFState;
+exports.useMutateDFState = useMutateDFState;

package/build/cjs/lib/core/components/Form/hooks/useMutators.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMutators = void 0;
+const tslib_1 = require("tslib");
+const react_1 = tslib_1.__importDefault(require("react"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const useMutators = (externalMutators) => {
+    const firstRenderRef = react_1.default.useRef(true);
+    const [store, setStore] = react_1.default.useState(externalMutators || {});
+    const mutateDFState = react_1.default.useCallback((mutators) => {
+        const mergeSpec = (a, b) => {
+            const result = lodash_1.default.cloneDeep(a);
+            const getKeys = (parent) => {
+                if (lodash_1.default.isObjectLike(parent)) {
+                    return lodash_1.default.keys(parent).reduce((acc, parentKey) => {
+                        const childKeys = getKeys(parent[parentKey]);
+                        return [
+                            ...acc,
+                            ...(childKeys.length ? [] : [[parentKey]]),
+                            ...childKeys.map((childKey) => [parentKey, ...childKey]),
+                        ];
+                    }, []);
+                }
+                return [];
+            };
+            getKeys(b).forEach((key) => {
+                lodash_1.default.set(result, key, lodash_1.default.get(b, key));
+            });
+            return result;
+        };
+        setStore((store) => (Object.assign(Object.assign(Object.assign(Object.assign({}, store), (mutators.errors ? { errors: lodash_1.default.merge(store.errors, mutators.errors) } : {})), (mutators.values ? { values: lodash_1.default.merge(store.values, mutators.values) } : {})), (mutators.spec ? { spec: mergeSpec(store.spec || {}, mutators.spec) } : {}))));
+    }, [setStore]);
+    react_1.default.useEffect(() => {
+        if (firstRenderRef.current) {
+            firstRenderRef.current = false;
+        }
+        else if (externalMutators) {
+            mutateDFState(externalMutators);
+        }
+    }, [externalMutators]);
+    return { mutators: store, mutateDFState };
+};
+exports.useMutators = useMutators;

package/build/cjs/lib/core/components/Form/hooks/useStoreValue.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStoreValue = void 0;
+const useDynamicFormsCtx_1 = require("./useDynamicFormsCtx");
+const useStoreValue = () => (0, useDynamicFormsCtx_1.useDynamicFormsCtx)().store;
+exports.useStoreValue = useStoreValue;

package/build/cjs/lib/core/components/Form/index.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStoreValue = exports.useMutateDFState = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./constants"), exports);
 tslib_1.__exportStar(require("./Controller"), exports);
 tslib_1.__exportStar(require("./DynamicField"), exports);
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useMutateDFState", { enumerable: true, get: function () { return hooks_1.useMutateDFState; } });
+Object.defineProperty(exports, "useStoreValue", { enumerable: true, get: function () { return hooks_1.useStoreValue; } });
 tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./utils"), exports);

package/build/cjs/lib/core/components/Form/types/index.js

@@ -9,6 +9,7 @@ tslib_1.__exportStar(require("./field"), exports);
 tslib_1.__exportStar(require("./input"), exports);
 tslib_1.__exportStar(require("./layout"), exports);
 tslib_1.__exportStar(require("./mirror"), exports);
+tslib_1.__exportStar(require("./mutators"), exports);
 tslib_1.__exportStar(require("./number"), exports);
 tslib_1.__exportStar(require("./object"), exports);
 tslib_1.__exportStar(require("./store"), exports);

package/build/cjs/lib/core/components/Form/types/mutators.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/esm/lib/core/components/Form/Controller/Controller.d.ts

@@ -0,0 +1,10 @@
+import { FormValue, Spec } from '../../../types';
+import { FieldValue, ValidateError } from '../types';
+export interface ControllerProps<DirtyValue extends FieldValue, SpecType extends Spec> {
+    spec: SpecType;
+    name: string;
+    value: DirtyValue;
+    parentOnChange: ((childName: string, childValue: FieldValue, childErrors: Record<string, ValidateError>) => void) | null;
+    parentOnUnmount: ((childName: string) => void) | null;
+}
+export declare const Controller: <DirtyValue extends FieldValue, Value extends FormValue, SpecType extends Spec>({ spec: _spec, name, value: valueFromParent, parentOnChange, parentOnUnmount, }: ControllerProps<DirtyValue, SpecType>) => JSX.Element | null;