mobx-formkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Claudio Savino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,214 @@
+### [Documentation](https://foxhound87.github.io/mobx-formkit) • [Live Demo](https://foxhound87.github.io/mobx-formkit-demo) • [Demo Code](https://github.com/foxhound87/mobx-formkit-demo) • [NPM](https://www.npmjs.com/package/mobx-formkit) • [Skills](https://github.com/foxhound87/skills) • [Tutorial](https://medium.com/@foxhound87/automagically-manage-react-forms-state-with-mobx-and-automatic-validation-2b00a32b9769) • [Join Discord Channel](https://discord.gg/CVV8w4zat4)
+
+# MobX Formkit
+
+### Reactive MobX Form State Management
+
+[![NPM](https://nodei.co/npm/mobx-formkit.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/mobx-formkit)
+[![NPM Version](https://img.shields.io/npm/v/mobx-formkit?label=npm&logo=npm&style=for-the-badge)](https://www.npmjs.com/package/mobx-formkit)
+
+![GitHub Workflow Status (with branch)](https://img.shields.io/github/actions/workflow/status/foxhound87/mobx-formkit/ci.yml?branch=master)
+![GitHub release (latest by date)](https://img.shields.io/github/v/release/foxhound87/mobx-formkit)
+![npm bundle size](https://img.shields.io/bundlephobia/min/mobx-formkit)
+![npm bundle size (gzip)](https://img.shields.io/bundlephobia/minzip/mobx-formkit)
+[![Codecov Coverage](https://img.shields.io/codecov/c/github/foxhound87/mobx-formkit/master.svg)](https://codecov.io/gh/foxhound87/mobx-formkit)
+[![node](https://img.shields.io/node/v/mobx-formkit.svg)]()
+[![GitHub license](https://img.shields.io/github/license/foxhound87/mobx-formkit.svg)]()
+![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/foxhound87/mobx-formkit)
+![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/foxhound87/mobx-formkit)
+[![Downloads](https://img.shields.io/npm/dt/mobx-formkit.svg)]()
+[![Downloads](https://img.shields.io/npm/dm/mobx-formkit.svg)]()
+[![Backers on Open Collective](https://opencollective.com/mobx-react-form/backers/badge.svg)](#backers)
+[![Sponsors on Open Collective](https://opencollective.com/mobx-react-form/sponsors/badge.svg)](#sponsors)
+
+<br>
+
+## Migrating from mobx-react-form
+
+| What                 | Old                          | New                          |
+| -------------------- | ---------------------------- | ---------------------------- |
+| npm package          | `mobx-react-form`            | `mobx-formkit`              |
+| UMD globals          | `MobxReactForm*`             | `MobxFormkit*`              |
+| imports & everywhere | `mobx-react-form`            | `mobx-formkit`              |
+
+> **Breaking (UMD):** UMD bundle filenames and script-tag globals changed from
+> `MobxReactForm*` to `MobxFormkit*` — update `<script src>` paths and global
+> references accordingly. There is no alias; APIs are otherwise identical.
+
+## Features
+
+- Extensibles [Validation Plugins](https://foxhound87.github.io/mobx-formkit/validation/plugins.html).
+- Sync & Async Validation (w/ Promises & automatic errors).
+- Nested Fields (w/ Serialization & Validation).
+- Nested Forms (w/ Nested Submission & Validation Hooks).
+- [Event Hooks](https://foxhound87.github.io/mobx-formkit/events/event-hooks.html), [Event Handlers](https://foxhound87.github.io/mobx-formkit/events/event-handlers.html) & [Validation Hooks](https://foxhound87.github.io/mobx-formkit/events/validation-hooks.html)
+- Functional [Computed Field Props](https://foxhound87.github.io/mobx-formkit/extra/computed-props.html)
+- Field Props [Observers & Interceptors](https://foxhound87.github.io/mobx-formkit/extra/mobx-events.html)
+- Field [Props Bindings](https://foxhound87.github.io/mobx-formkit/bindings/README.html) for custom Components.
+- Support for Material UI, Ant Design, React Widgets, React Select, React Aria, Headless UI & more.
+- [AI Agent Skills](https://github.com/foxhound87/skills): installable guides for AI coding assistants
+- [Forms Composer](https://foxhound87.github.io/mobx-formkit/extra/composer.html): to handle multi-forms submit, validations and other actions
+- Dedicated [DevTools](https://github.com/foxhound87/mobx-formkit-devtools) Package.
+
+<br>
+
+## Quick Start
+
+[![Edit form-quickstart](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/nrrZgG8y4)
+
+```bash
+npm install --save mobx-formkit
+```
+
+> **MobX 6 & 7 support**: `mobx-formkit` works with both `mobx@6` and `mobx@7` (peer dependency: `^6.0.0 || ^7.0.0`). For MobX 7 use the matching React bindings (`mobx-react@^10`).
+
+#### Choose and Setup a Validation Plugin
+
+Below we are creating a `plugins` object using the `validatorjs` package to enable `DVR` functionalities (Declarative Validation Rules).
+
+```javascript
+import dvr from "mobx-formkit/lib/validators/DVR";
+import validatorjs from "validatorjs";
+
+const plugins = {
+  dvr: dvr({
+    package: validatorjs,
+  }),
+};
+```
+
+> See [Validation Plugins](https://foxhound87.github.io/mobx-formkit/validation/plugins.html) for more info on supported packages.
+
+#### Define the Form Fields
+
+Define the `fields` as a collection with a `rules` property for the validation.
+
+```javascript
+const fields = [
+  {
+    name: "email",
+    label: "Email",
+    placeholder: "Insert Email",
+    rules: "required|email|string|between:5,25",
+  },
+  {
+    name: "password",
+    label: "Password",
+    placeholder: "Insert Password",
+    rules: "required|string|between:5,25",
+    type: "password",
+  },
+  {
+    name: "passwordConfirm",
+    label: "Password Confirmation",
+    placeholder: "Confirm Password",
+    rules: "required|string|same:password",
+    type: "password",
+  },
+];
+```
+
+> See [Fields Definitions](https://foxhound87.github.io/mobx-formkit/fields/) and all available [Field Props](https://foxhound87.github.io/mobx-formkit/api-reference/fields-properties.html) on the docs.
+
+#### Define the Validation Hooks
+
+```javascript
+const hooks = {
+  onSuccess(form) {
+    alert("Form is valid! Send the request here.");
+    // get field values
+    console.log("Form Values!", form.values());
+  },
+  onError(form) {
+    alert("Form has errors!");
+    // get all form errors
+    console.log("All form errors", form.errors());
+  },
+};
+```
+
+> See more on the docs about the [Validation Hooks](https://foxhound87.github.io/mobx-formkit/events/validation-hooks.html) and the [Event Hooks](https://foxhound87.github.io/mobx-formkit/events/event-hooks.html)
+
+#### Initialize the Form
+
+Simply pass the `fields`, `plugins` and `hooks` objects to the constructor
+
+```javascript
+import MobxFormkit from "mobx-formkit";
+
+const myForm = new MobxFormkit({ fields }, { plugins, hooks });
+```
+
+> Learn more on the docs about the [Form Instance](https://foxhound87.github.io/mobx-formkit/form/) and the [Form Options](https://foxhound87.github.io/mobx-formkit/form/form-options.html)
+
+#### Pass the myForm to a react component
+
+The package provide some built-in and ready to use Event Handlers:
+
+`onSubmit(e)`, `onClear(e)`, `onReset(e)` & [more...](https://foxhound87.github.io/mobx-formkit/events/event-handlers.html)
+
+```javascript
+import React from "react";
+import { observer } from "mobx-react";
+
+export default observer(({ myForm }) => (
+  <form onSubmit={myForm.onSubmit}>
+    <label htmlFor={myForm.$("email").id}>{myForm.$("email").label}</label>
+    <input {...myForm.$("email").bind()} />
+    <p>{myForm.$("email").error}</p>
+
+    {/* ... other inputs ... */}
+
+    <button type="submit" onClick={myForm.onSubmit}>
+      Submit
+    </button>
+    <button type="button" onClick={myForm.onClear}>
+      Clear
+    </button>
+    <button type="button" onClick={myForm.onReset}>
+      Reset
+    </button>
+
+    <p>{myForm.error}</p>
+  </form>
+));
+```
+
+> See more on the docs about the [Field Props Bindings](https://foxhound87.github.io/mobx-formkit/bindings)
+
+###### Extending the Form class
+
+[See how to implement the same configuration of this quickstart extending the Form class](https://foxhound87.github.io/mobx-formkit/quick-start-class.html)
+
+<br>
+
+## Contributing
+
+1. Fork the repository
+2. Make applicable changes (with tests!)
+3. To run tests: `npm run test`
+4. Ensure builds succeed: `npm run build`
+5. Commit and run pre-commit checks: `npm run commit`
+
+### New Issues
+
+When opening new issues, provide the setup of your form in a [CodeSandbox](https://codesandbox.io/).
+
+These issues, and the ones which provides also PR with failing tests will get higher priority.
+
+### Contributors
+
+This project exists thanks to all the people who contribute.
+<a href="graphs/contributors"><img src="https://opencollective.com/mobx-react-form/contributors.svg?width=890&button=false" /></a>
+
+### Backers
+
+Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/mobx-react-form#backer)]
+
+<a href="https://opencollective.com/mobx-react-form#backers" target="_blank"><img src="https://opencollective.com/mobx-react-form/backers.svg?width=890"></a>
+
+### Sponsors
+
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/mobx-react-form#sponsor)]
+
+<img src="https://opencollective.com/mobx-react-form/sponsors.svg"/>

package/lib/ArrayMap.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ArrayMap: an ordered key-value collection backed by an observable array.
+ *
+ * Exposes the full ObservableMap-compatible API (get, set, has, delete,
+ * merge, forEach, keys, values, entries, intercept, etc.) while
+ * maintaining insertion order via an internal observable array.
+ *
+ * The observable array backing allows array-like operations such as
+ * `move(fromIndex, toIndex)` which directly re-orders entries via
+ * splice — fully MobX reactive.
+ */
+export declare class ArrayMap<K = string, V = any> {
+    /** Duck-typing marker for utility code */
+    _isArrayMap: boolean;
+    /** Internal observable array: entries stored as [key, value] pairs */
+    private _entries;
+    constructor(entries?: [K, V][] | null);
+    get size(): number;
+    get(key: K): V | undefined;
+    set(key: K, value: V): this;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    keys(): IterableIterator<K>;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[K, V]>;
+    forEach(callbackfn: (value: V, key: K, map: this) => void, thisArg?: any): void;
+    toJSON(): {
+        [key: string]: V;
+    };
+    toString(): string;
+    merge(other: any): this;
+    replace(values: any): this;
+    get intercept(): any;
+    [Symbol.iterator](): IterableIterator<[K, V]>;
+    /**
+     * Move an entry from `fromIndex` to `toIndex`.
+     *
+     * Directly splices the internal observable array, so MobX
+     * tracks the change as a single array splice operation.
+     */
+    move(fromIndex: number, toIndex: number): void;
+    /**
+     * Expose the underlying observable array for direct MobX
+     * observation (e.g. `observe(arr, cb)` from mobx).
+     */
+    toArray(): Array<[K, V]>;
+}
+export default ArrayMap;
+//# sourceMappingURL=ArrayMap.d.ts.map

package/lib/ArrayMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayMap.d.ts","sourceRoot":"","sources":["../src/ArrayMap.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG;IACvC,0CAA0C;IAC1C,WAAW,UAAQ;IAEnB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAA0D;gBAE9D,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAUrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAK1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAU3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IASvB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI3B,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI7B,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAInC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,EACjD,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAMP,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE;IAQ9B,QAAQ,IAAI,MAAM;IAIlB,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAsBvB,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAK1B,IAAI,SAAS,IAAI,GAAG,CAEnB;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAQ7C;;;;;OAKG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAW9C;;;OAGG;IACH,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAGzB;AAED,eAAe,QAAQ,CAAC"}

package/lib/ArrayMap.js

@@ -0,0 +1,151 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var mobx = require('mobx');
+
+/**
+ * ArrayMap: an ordered key-value collection backed by an observable array.
+ *
+ * Exposes the full ObservableMap-compatible API (get, set, has, delete,
+ * merge, forEach, keys, values, entries, intercept, etc.) while
+ * maintaining insertion order via an internal observable array.
+ *
+ * The observable array backing allows array-like operations such as
+ * `move(fromIndex, toIndex)` which directly re-orders entries via
+ * splice — fully MobX reactive.
+ */
+class ArrayMap {
+    /** Duck-typing marker for utility code */
+    _isArrayMap = true;
+    /** Internal observable array: entries stored as [key, value] pairs */
+    _entries = mobx.observable.array([]);
+    constructor(entries) {
+        if (entries && entries.length > 0) {
+            this._entries.replace(entries);
+        }
+    }
+    // ------------------------------------------------------------------
+    // ObservableMap-compatible API
+    // ------------------------------------------------------------------
+    get size() {
+        return this._entries.length;
+    }
+    get(key) {
+        const entry = this._entries.find(([k]) => k === key);
+        return entry ? entry[1] : undefined;
+    }
+    set(key, value) {
+        const existing = this._entries.find(([k]) => k === key);
+        if (existing) {
+            existing[1] = value;
+        }
+        else {
+            this._entries.push([key, value]);
+        }
+        return this;
+    }
+    has(key) {
+        return this._entries.some(([k]) => k === key);
+    }
+    delete(key) {
+        const index = this._entries.findIndex(([k]) => k === key);
+        if (index !== -1) {
+            this._entries.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    clear() {
+        this._entries.clear();
+    }
+    keys() {
+        return this._entries.map(([k]) => k)[Symbol.iterator]();
+    }
+    values() {
+        return this._entries.map(([, v]) => v)[Symbol.iterator]();
+    }
+    entries() {
+        return this._entries[Symbol.iterator]();
+    }
+    forEach(callbackfn, thisArg) {
+        this._entries.forEach(([key, value]) => {
+            callbackfn.call(thisArg, value, key, this);
+        });
+    }
+    toJSON() {
+        const result = {};
+        this._entries.forEach(([key, value]) => {
+            result[String(key)] = value;
+        });
+        return result;
+    }
+    toString() {
+        return `[object ArrayMap]`;
+    }
+    merge(other) {
+        if (other && typeof other === "object") {
+            if (other.forEach && typeof other.forEach === "function") {
+                // ObservableMap or Map-like
+                other.forEach((value, key) => {
+                    this.set(key, value);
+                });
+            }
+            else if (Array.isArray(other)) {
+                // Array of [key, value] pairs
+                other.forEach(([key, value]) => {
+                    this.set(key, value);
+                });
+            }
+            else {
+                // Plain object { key: value }
+                Object.keys(other).forEach((key) => {
+                    this.set(key, other[key]);
+                });
+            }
+        }
+        return this;
+    }
+    replace(values) {
+        this.clear();
+        return this.merge(values);
+    }
+    get intercept() {
+        return this._entries.intercept;
+    }
+    [Symbol.iterator]() {
+        return this._entries[Symbol.iterator]();
+    }
+    // ------------------------------------------------------------------
+    // Array-specific methods
+    // ------------------------------------------------------------------
+    /**
+     * Move an entry from `fromIndex` to `toIndex`.
+     *
+     * Directly splices the internal observable array, so MobX
+     * tracks the change as a single array splice operation.
+     */
+    move(fromIndex, toIndex) {
+        mobx.runInAction(() => {
+            if (fromIndex < 0 || fromIndex >= this._entries.length)
+                return;
+            if (toIndex < 0 || toIndex >= this._entries.length)
+                return;
+            if (fromIndex === toIndex)
+                return;
+            const [entry] = this._entries.splice(fromIndex, 1);
+            this._entries.splice(toIndex, 0, entry);
+        });
+    }
+    /**
+     * Expose the underlying observable array for direct MobX
+     * observation (e.g. `observe(arr, cb)` from mobx).
+     */
+    toArray() {
+        return this._entries;
+    }
+}
+
+exports.ArrayMap = ArrayMap;
+exports.default = ArrayMap;
+//# sourceMappingURL=ArrayMap.js.map

package/lib/ArrayMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayMap.js","sources":["../src/ArrayMap.ts"],"sourcesContent":[null],"names":["observable","runInAction"],"mappings":"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"}

package/lib/Base.d.ts

@@ -0,0 +1,237 @@
+import ArrayMap from "./ArrayMap";
+import { BaseInterface } from "./models/BaseInterface";
+import { StateInterface } from "./models/StateInterface";
+import { FieldInterface } from "./models/FieldInterface";
+import { ValidateOptions } from "./models/ValidatorInterface";
+import { SubmitHooks } from "./models/SharedActionsInterface";
+export default abstract class Base<F extends Record<string, any> = Record<string, any>> implements BaseInterface<F> {
+    noop: () => void;
+    state: StateInterface;
+    fields: ArrayMap;
+    path: string | undefined | null;
+    $submitted: number;
+    $submitting: boolean;
+    $validated: number;
+    $validating: boolean;
+    $clearing: boolean;
+    $resetting: boolean;
+    $touched: boolean;
+    $changed: number;
+    $hooks: any;
+    $handlers: any;
+    constructor();
+    execHook: (name: string, fallback?: any, ...args: any[]) => any;
+    execHandler: (name: string, args: any, fallback?: any, hook?: any, execHook?: boolean) => any;
+    get resetting(): boolean;
+    get clearing(): boolean;
+    get submitted(): number;
+    get submitting(): boolean;
+    get validated(): number;
+    get validating(): boolean;
+    get hasIncrementalKeys(): boolean;
+    get hasNestedFields(): boolean;
+    get size(): number;
+    get changed(): number;
+    /**
+      Interceptor
+    */
+    intercept: (opt: any) => any;
+    /**
+      Observer
+    */
+    observe: (opt: any) => any;
+    /**
+      Event Handler: On Clear
+    */
+    onClear: (...args: any) => any;
+    /**
+      Event Handler: On Reset
+    */
+    onReset: (...args: any) => any;
+    /**
+      Event Handler: On Submit
+     */
+    onSubmit: (...args: any) => any;
+    /**
+      Event Handler: On Add
+    */
+    onAdd: (...args: any) => any;
+    /**
+      Event Handler: On Del
+    */
+    onDel: (...args: any) => any;
+    /******************************************************************
+      Initializer
+    */
+    initFields(initial: any, update?: boolean): void;
+    initField(key: string, path: string, data: any, update?: boolean): any;
+    /******************************************************************
+      Actions
+    */
+    validate(opt?: ValidateOptions, obj?: ValidateOptions): Promise<any>;
+    /**
+      Submit
+    */
+    submit(hooks?: SubmitHooks, { execOnSubmitHook, execValidationHooks, validate, }?: {
+        execOnSubmitHook?: boolean | undefined;
+        execValidationHooks?: boolean | undefined;
+        validate?: boolean | undefined;
+    }): Promise<any>;
+    /**
+      Check Field Computed Values
+     */
+    check(prop: string, deep?: boolean): boolean;
+    deepCheck(type: string, prop: string, fields: any): any;
+    firstError(): string | null;
+    /**
+      Update Field Values recurisvely
+      OR Create Field if 'undefined'
+     */
+    update(fields: any): void;
+    deepUpdate(fields: any, path?: string, recursion?: boolean, raw?: any): void;
+    /**
+      Get Fields Props
+     */
+    get(prop?: any, strict?: boolean): any;
+    /**
+      Get Fields Props Recursively
+     */
+    deepGet(prop: any, fields: any, strict?: boolean): any;
+    /**
+      Set Fields Props
+     */
+    set(prop: any, data?: any): void;
+    /**
+      Set Fields Props Recursively
+     */
+    deepSet(prop: any, data: any, path?: string, recursion?: boolean): void;
+    /**
+      Add Field
+     */
+    add(obj?: any, execEvent?: boolean): any;
+    /**
+      Del Field
+     */
+    del($path?: string | null, execEvent?: boolean): any;
+    /******************************************************************
+      Events
+    */
+    /**
+      MobX Event (observe/intercept)
+     */
+    MOBXEvent({ prop, key, path, call, type, }: any): void;
+    /**
+      Dispose MOBX Events
+     */
+    dispose(opt?: any): void;
+    /**
+      Dispose All Events (observe/intercept)
+     */
+    disposeAll(): void;
+    /**
+      Dispose Single Event (observe/intercept)
+     */
+    disposeSingle({ type, key, path }: any): void;
+    /******************************************************************
+      Utils
+    */
+    /**
+      Fields Selector
+    */
+    select(path: string | number, fields?: any, isStrict?: boolean): any;
+    /**
+      Get Container
+     */
+    container($path?: string | null): any;
+    /**
+      Has Field
+     */
+    has(path: string): boolean;
+    /**
+      Map Fields
+    */
+    map(cb: any): ReadonlyArray<FieldInterface>;
+    /**
+     * Iterates deeply over fields and invokes `iteratee` for each element.
+     * The iteratee is invoked with three arguments: (value, index|key, depth).
+     *
+     * @param {Function} iteratee The function invoked per iteration.
+     * @param {Array|Object} [fields=form.fields] fields to iterate over.
+     * @param {number} [depth=1] The recursion depth for internal use.
+     * @returns {Array} Returns [fields.values()] of input [fields] parameter.
+     * @example
+     *
+     * JSON.stringify(form)
+     * // => {
+     *   "fields": {
+     *     "state": {
+     *       "fields": {
+     *         "city": {
+     *           "fields": { "places": {
+     *                "fields": {},
+     *                "key": "places", "path": "state.city.places", "$value": "NY Places"
+     *              }
+     *           },
+     *           "key": "city", "path": "state.city", "$value": "New York"
+     *         }
+     *       },
+     *       "key": "state", "path": "state", "$value": "USA"
+     *     }
+     *   }
+     * }
+     *
+     * const data = {};
+     * form.each(field => data[field.path] = field.value);
+     * // => {
+     *   "state": "USA",
+     *   "state.city": "New York",
+     *   "state.city.places": "NY Places"
+     * }
+     *
+     */
+    each(iteratee: any, fields?: any, depth?: number): void;
+    reduce(iteratee: any, acc: any): any;
+    /******************************************************************
+      Array Operations
+    */
+    /**
+      Move a field from one index to another (for sortable lists).
+     */
+    move(fromIndex: number, toIndex: number): void;
+    /******************************************************************
+      Helpers
+    */
+    /**
+      Fields Selector (alias of select)
+     */
+    $(key: string): any;
+    /**
+      Fields Values (recursive with Nested Fields)
+     */
+    values(): any;
+    /**
+      Fields Errors (recursive with Nested Fields)
+     */
+    errors(): any;
+    /**
+      Fields Labels (recursive with Nested Fields)
+     */
+    labels(): any;
+    /**
+      Fields Placeholders (recursive with Nested Fields)
+     */
+    placeholders(): any;
+    /**
+      Fields Default Values (recursive with Nested Fields)
+     */
+    defaults(): any;
+    /**
+      Fields Initial Values (recursive with Nested Fields)
+     */
+    initials(): any;
+    /**
+      Fields Types (recursive with Nested Fields)
+     */
+    types(): any;
+}
+//# sourceMappingURL=Base.d.ts.map