@codeleap/form 7.0.0 → 7.0.1

package/dist/fields/bool.js

@@ -0,0 +1,15 @@
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+/**
+ * Field for boolean values (checkboxes, toggles). `Form.setValues` treats
+ * this field specially: it will only set a value when the incoming value is
+ * strictly `boolean`, because falsy coercion would prevent setting `false`.
+ */
+export class BooleanField extends Field {
+    constructor(options) {
+        super(Object.assign({ validate: zodValidator(z.boolean()) }, options));
+        this._type = "BOOLEAN";
+    }
+}
+//# sourceMappingURL=bool.js.map

package/dist/fields/bool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../src/fields/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAS5C;;;;GAIG;AACH,MAAM,OAAO,YAAgD,SAAQ,KAAwB;IAG3F,YAAY,OAAsC;QAChD,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAwB,IACvD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,SAAS,CAAA;IAOjB,CAAC;CACF"}

package/dist/fields/date.js

@@ -0,0 +1,56 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+import dayjs from 'dayjs';
+function normalizeToDate(val) {
+    if (!val)
+        return undefined;
+    if (val instanceof Date)
+        return val;
+    if (dayjs.isDayjs(val))
+        return val.startOf('day').toDate();
+    if (typeof val === 'string') {
+        const parsed = dayjs(val);
+        return parsed.isValid() ? parsed.startOf('day').toDate() : undefined;
+    }
+    return undefined;
+}
+/**
+ * Field for `Date` values with optional `minimumDate` / `maximumDate` bounds.
+ * The built-in validator normalises the raw input via `dayjs` before running
+ * boundary checks, so it transparently accepts `Date` objects, dayjs instances,
+ * and ISO date strings. Invalid or unparseable values are normalised to
+ * `undefined`, which fails the `z.date()` check. Bounds are enforced at the
+ * start of the day (`startOf('day')`) for dayjs inputs.
+ */
+export class DateField extends Field {
+    constructor(options) {
+        const { minimumDate, maximumDate } = options, rest = __rest(options, ["minimumDate", "maximumDate"]);
+        const schema = z.preprocess((val) => {
+            const normalized = normalizeToDate(val);
+            if (!normalized || isNaN(normalized.getTime()))
+                return undefined;
+            return normalized;
+        }, z.date()
+            .refine(d => !minimumDate || d >= minimumDate, {
+            message: `Date must be on or after ${minimumDate === null || minimumDate === void 0 ? void 0 : minimumDate.toDateString()}`,
+        })
+            .refine(d => !maximumDate || d <= maximumDate, {
+            message: `Date must be on or before ${maximumDate === null || maximumDate === void 0 ? void 0 : maximumDate.toDateString()}`,
+        }));
+        super(Object.assign({ validate: zodValidator(schema) }, options));
+        this._type = "DATE";
+    }
+}
+//# sourceMappingURL=date.js.map

package/dist/fields/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/fields/date.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAE1B,IAAI,GAAG,YAAY,IAAI;QAAE,OAAO,GAAG,CAAA;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAA;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QACzB,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IACtE,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,SAA0C,SAAQ,KAAqB;IAGlF,YAAY,OAAmC;QAC7C,MAAM,EAAE,WAAW,EAAE,WAAW,KAAc,OAAO,EAAhB,IAAI,UAAK,OAAO,EAA/C,8BAAqC,CAAU,CAAA;QAErD,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAY,EAAE,EAAE;YAC3C,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;YAEvC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAA;YAChE,OAAO,UAAU,CAAA;QACnB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;aACR,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,WAAW,EAAE;YAC7C,OAAO,EAAE,4BAA4B,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,YAAY,EAAE,EAAE;SACnE,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,WAAW,EAAE;YAC7C,OAAO,EAAE,6BAA6B,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,YAAY,EAAE,EAAE;SACpE,CAAC,CACH,CAAA;QAED,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAwB,IAClD,OAAO,EACV,CAAA;QAtBJ,UAAK,GAAG,MAAM,CAAA;IAuBd,CAAC;CACF"}

package/dist/fields/file.js

@@ -0,0 +1,16 @@
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+/**
+ * Field for file uploads. The value type is `any` because the shape of a
+ * "file" differs between web (`File` / `FileList`) and React Native (asset
+ * descriptor objects). Supply a custom `validate` function to enforce whatever
+ * shape your platform produces.
+ */
+export class FileField extends Field {
+    constructor(options) {
+        super(Object.assign({ validate: zodValidator(z.any()) }, options));
+        this._type = "FILE";
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/fields/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/fields/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAO5C;;;;;GAKG;AACH,MAAM,OAAO,SAA0C,SAAQ,KAAoB;IAGjF,YAAY,OAAmC;QAC7C,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,CAAwB,IACnD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,MAAM,CAAA;IAOd,CAAC;CACF"}

package/dist/fields/group.js

@@ -0,0 +1,16 @@
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+/**
+ * Field that represents a selected group or category, stored as a string key.
+ * Structurally identical to `TextField` but carries the `"group"` type tag so
+ * platform renderers can distinguish it and render a group-picker control
+ * instead of a free-text input.
+ */
+export class GroupField extends Field {
+    constructor(options) {
+        super(Object.assign({ validate: zodValidator(z.string()) }, options));
+        this._type = "group";
+    }
+}
+//# sourceMappingURL=group.js.map

package/dist/fields/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../src/fields/group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAQ5C;;;;;GAKG;AACH,MAAM,OAAO,UAA4C,SAAQ,KAAuB;IAGtF,YAAY,OAAoC;QAC9C,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAwB,IACtD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,OAAO,CAAA;IAOf,CAAC;CACF"}

package/dist/fields/index.js

@@ -0,0 +1,33 @@
+import { fieldFactory } from "../lib/factories";
+import { TextField } from "./text";
+import { ListField, listFieldFactory } from "./list";
+import { NumberField } from "./number";
+import { BooleanField } from "./bool";
+import { SelectableField } from "./selectable";
+import { DateField } from "./date";
+import { FileField } from "./file";
+/**
+ * Convenience namespace that exposes factory functions for every built-in field
+ * type. Prefer these over calling constructors directly — they provide better
+ * generic inference for the `validate` option.
+ *
+ * ```ts
+ * const emailField = fields.text({ validate: zodValidator(z.string().email()) })
+ * const tagsField  = fields.list({ item: fields.text(), defaultValue: [] })
+ * ```
+ *
+ * Note: `fields.list` is the only entry that is not wrapped with
+ * `fieldFactory`, because `ListField` requires the `item` option's type to be
+ * inferred at the call site.
+ */
+export const fields = {
+    text: fieldFactory(TextField),
+    list: listFieldFactory,
+    number: fieldFactory(NumberField),
+    boolean: fieldFactory(BooleanField),
+    selectable: fieldFactory(SelectableField),
+    date: fieldFactory(DateField),
+    file: fieldFactory(FileField),
+};
+export { TextField, ListField, NumberField, BooleanField, SelectableField, DateField, FileField, };
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,SAAS,EAAG,gBAAgB,EAAC,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAGlC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC;IAC7B,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC;IACjC,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC;IACnC,UAAU,EAAE,YAAY,CAAC,eAAe,CAAC;IACzC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC;CAC9B,CAAA;AAED,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,GACV,CAAA"}

package/dist/fields/list.js

@@ -0,0 +1,50 @@
+import { Field } from "../lib/Field";
+/**
+ * Field that holds an array of values, each validated by a delegate `item`
+ * field. The built-in validator iterates every element through
+ * `options.item.validate` and collects all failures into an error array. The
+ * list is considered valid only when every element passes. If `item` has no
+ * validator, the list is always valid.
+ *
+ * The `item` field acts as a prototype — it is not mounted independently and
+ * does not own its own atom. Do not call `use()` on it directly.
+ */
+export class ListField extends Field {
+    constructor(options) {
+        super(Object.assign(Object.assign({}, options), { validate: ((v, form) => {
+                var _a, _b, _c;
+                if (!((_a = options.item) === null || _a === void 0 ? void 0 : _a.validate))
+                    return {
+                        isValid: true
+                    };
+                const errors = [];
+                for (const value of v) {
+                    const validation = (_c = (_b = options.item) === null || _b === void 0 ? void 0 : _b.validate) === null || _c === void 0 ? void 0 : _c.call(_b, value);
+                    if (!validation.isValid) {
+                        errors.push(validation);
+                    }
+                }
+                if (errors.length) {
+                    return {
+                        isValid: false,
+                        error: errors,
+                    };
+                }
+                return {
+                    isValid: true,
+                };
+            }) }));
+        this._type = "LIST";
+    }
+}
+/**
+ * Convenience factory for `ListField`. Unlike `fieldFactory`-based helpers,
+ * `ListField` requires an `item` option whose generic type must be inferred at
+ * the call site, so it cannot share the same factory wrapper. This function
+ * exists to provide a consistent `fields.list(...)` call signature alongside
+ * the other entries in the `fields` namespace.
+ */
+export function listFieldFactory(options) {
+    return new ListField(options);
+}
+//# sourceMappingURL=list.js.map

package/dist/fields/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/fields/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AA6BpC;;;;;;;;;GASG;AACH,MAAM,OAAO,SAAqC,SAAQ,KAAiD;IAGzG,YAAY,OAA4B;QACtC,KAAK,CAAC,gCACD,OAAO,KACV,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;;gBACrB,IAAI,CAAC,CAAA,MAAA,OAAO,CAAC,IAAI,0CAAE,QAAQ,CAAA;oBAAE,OAAO;wBAClC,OAAO,EAAE,IAAI;qBACd,CAAA;gBAED,MAAM,MAAM,GAAG,EAAE,CAAA;gBAEjB,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;oBACtB,MAAM,UAAU,GAAG,MAAA,MAAA,OAAO,CAAC,IAAI,0CAAE,QAAQ,mDAAG,KAAK,CAAC,CAAA;oBAElD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;wBACxB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;oBACzB,CAAC;gBACH,CAAC;gBAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAClB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,MAAM;qBACd,CAAA;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAI;iBACd,CAAA;YACH,CAAC,CAAuB,GAC8C,CAAC,CAAA;QA/B3E,UAAK,GAAG,MAAM,CAAA;IAgCd,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAA2B,OAA4B;IACrF,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC"}

package/dist/fields/number.js

@@ -0,0 +1,35 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+const MAX_VALID_DIGITS = 1000000000000000; // maximum number of digits that the input supports to perform operations
+/**
+ * Field for numeric values. Supports both single numbers and arrays of numbers
+ * (range / multi-handle sliders) — the mode is inferred from whether
+ * `defaultValue` is an array. `min` defaults to `0` and `max` defaults to
+ * `1_000_000_000_000_000` (the maximum safe integer range the underlying input
+ * supports for arithmetic operations). Values outside the range fail
+ * validation.
+ */
+export class NumberField extends Field {
+    constructor(options) {
+        const { min = 0, max = MAX_VALID_DIGITS, defaultValue } = options, others = __rest(options, ["min", "max", "defaultValue"]);
+        const isMultiple = Array.isArray(defaultValue);
+        const zScheme = z.number().min(min).max(max);
+        super(Object.assign({ validate: zodValidator(isMultiple ? z.array(zScheme) : zScheme), min,
+            max,
+            defaultValue }, others));
+        this._type = "NUMBER";
+    }
+}
+//# sourceMappingURL=number.js.map

package/dist/fields/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/fields/number.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAY5C,MAAM,gBAAgB,GAAG,gBAAgB,CAAA,CAAC,yEAAyE;AAEnH;;;;;;;GAOG;AACH,MAAM,OAAO,WAA8C,SAAQ,KAAkC;IAGnG,YAAY,OAAqC;QAC/C,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,gBAAgB,EAAE,YAAY,KAAgB,OAAO,EAAlB,MAAM,UAAK,OAAO,EAAtE,8BAA4D,CAAU,CAAA;QAE5E,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QAE9C,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE5C,KAAK,CAAC,gBACJ,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAwB,EACtF,GAAG;YACH,GAAG;YACH,YAAY,IACT,MAAM,CACsB,CAAC,CAAA;QAfpC,UAAK,GAAG,QAAQ,CAAA;IAgBhB,CAAC;CACF"}

package/dist/fields/selectable.js

@@ -0,0 +1,22 @@
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+/**
+ * Field for single or multi-select inputs whose options are a fixed list of
+ * string/number keys. `minItems` defaults to `1` (at least one selection
+ * required) and `maxItems` defaults to the length of the provided `options`
+ * array (all items selectable). The built-in validator accepts either a single
+ * value or an array, so the same field type covers both radio-style and
+ * checkbox-style UIs.
+ */
+export class SelectableField extends Field {
+    constructor(options) {
+        var _a;
+        const { minItems = 1, maxItems = (_a = options === null || options === void 0 ? void 0 : options.options) === null || _a === void 0 ? void 0 : _a.length } = options;
+        const zScheme = z.string().or(z.number());
+        super(Object.assign({ validate: zodValidator(z.array(zScheme).min(minItems).max(maxItems).or(zScheme)), minItems,
+            maxItems }, options));
+        this._type = "SELECTABLE";
+    }
+}
+//# sourceMappingURL=selectable.js.map

package/dist/fields/selectable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectable.js","sourceRoot":"","sources":["../../src/fields/selectable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAc5C;;;;;;;GAOG;AACH,MAAM,OAAO,eAA0E,SAAQ,KAAkB;IAG/G,YAAY,OAA4C;;QACtD,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,0CAAE,MAAM,EAAE,GAAG,OAAO,CAAA;QAErE,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;QAEzC,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAwB,EACvG,QAAQ;YACR,QAAQ,IACL,OAAO,EACV,CAAA;QAZJ,UAAK,GAAG,YAAY,CAAA;IAapB,CAAC;CACF"}

package/dist/fields/text.js

@@ -0,0 +1,16 @@
+import { Field } from "../lib/Field";
+import { z } from 'zod';
+import { zodValidator } from "../validators";
+/**
+ * Field for plain string values. Ships with a `z.string()` fallback validator
+ * so the field is always valid when no custom `validate` option is provided.
+ * Accepts `secure` (password masking) and `multiline` hints that are forwarded
+ * as props to the underlying input component.
+ */
+export class TextField extends Field {
+    constructor(options) {
+        super(Object.assign({ validate: zodValidator(z.string().optional()) }, options));
+        this._type = "TEXT";
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/fields/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/fields/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAY5C;;;;;GAKG;AACH,MAAM,OAAO,SAA0C,SAAQ,KAAuB;IAGpF,YAAY,OAAmC;QAC7C,KAAK,iBACH,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAwB,IACjE,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,MAAM,CAAA;IAOd,CAAC;CACF"}

package/dist/hooks/index.js

@@ -0,0 +1,3 @@
+export { useField } from './useField';
+export { useValidate } from './useValidate';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/hooks/useField.js

@@ -0,0 +1,24 @@
+import { useMemo } from "react";
+/**
+ * Convenience hook for components that accept an optional `field` prop. When
+ * `field` is provided it is used directly; when it is absent (falsy), a
+ * temporary field created by `defaultField` is memoised for the component's
+ * lifetime.
+ *
+ * This lets components remain uncontrolled by default (using their own
+ * internal field) while still accepting external control when a `field` prop
+ * is supplied — without conditional hook calls.
+ *
+ * `params` are forwarded to `field.use()` in either branch, so imperative
+ * ref bindings work regardless of which field is active.
+ */
+export function useField(field, params, defaultField) {
+    if (field) {
+        return field.use(params === null || params === void 0 ? void 0 : params[0], params === null || params === void 0 ? void 0 : params[1]);
+    }
+    const tempField = useMemo(() => {
+        return defaultField();
+    }, []);
+    return tempField.use(params[0], params === null || params === void 0 ? void 0 : params[1]);
+}
+//# sourceMappingURL=useField.js.map

package/dist/hooks/useField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useField.js","sourceRoot":"","sources":["../../src/hooks/useField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG/B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAkC,KAAQ,EAAE,MAA4B,EAAE,YAAqB;IACrH,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,CAAC,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,CAAC,CAAyB,CAAA;IACpE,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,OAAO,YAAY,EAAE,CAAA;IACvB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,CAAC,CAAyB,CAAA;AACtE,CAAC"}

package/dist/hooks/useValidate.js

@@ -0,0 +1,54 @@
+import { useCallback, useRef, useState } from 'react';
+import { ValidationError } from '../lib/Field';
+/**
+ * Standalone validation hook for values managed outside a `Field` instance.
+ * Useful when you have a raw state value and a validator function but do not
+ * want to create a full `Field` object.
+ *
+ * Error display follows the same blur policy as `Field.useValidation`: if
+ * `value` is `undefined` on the first render (`startedUnset`), the error is
+ * hidden until the user has blurred the input. Call the returned
+ * `onInputBlurred` handler on the input's blur event to trigger visibility.
+ *
+ * `message` is resolved from `readableError` first, then from the first
+ * element's `.message` when `error` is an array.
+ *
+ * A {@link ValidationError} thrown by `providedValidate` is caught and
+ * normalised; other exceptions propagate.
+ */
+export const useValidate = (value, providedValidate) => {
+    var _a, _b, _c, _d;
+    const [hasBlurred, setHasBlurred] = useState(false);
+    const isUnset = typeof value === 'undefined';
+    const startedUnset = useRef(isUnset).current;
+    const validate = useCallback((value) => {
+        try {
+            const result = providedValidate === null || providedValidate === void 0 ? void 0 : providedValidate(value, {});
+            return result;
+        }
+        catch (e) {
+            if (e instanceof ValidationError) {
+                return {
+                    isValid: false,
+                    error: e.data
+                };
+            }
+            throw e;
+        }
+    }, []);
+    const onInputBlurred = useCallback(() => {
+        setHasBlurred(true);
+    }, []);
+    const validation = validate(value);
+    const isValid = (_a = validation === null || validation === void 0 ? void 0 : validation.isValid) !== null && _a !== void 0 ? _a : true;
+    const isInvalid = !isValid;
+    const message = (_b = validation === null || validation === void 0 ? void 0 : validation.readableError) !== null && _b !== void 0 ? _b : (_d = (_c = validation === null || validation === void 0 ? void 0 : validation.error) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.message;
+    const errorDisplayRequiresBlur = startedUnset;
+    const showError = isInvalid && (errorDisplayRequiresBlur ? hasBlurred : true);
+    return {
+        onInputBlurred,
+        showError,
+        message,
+    };
+};
+//# sourceMappingURL=useValidate.js.map

package/dist/hooks/useValidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValidate.js","sourceRoot":"","sources":["../../src/hooks/useValidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAsC,KAAQ,EAAE,gBAAmB,EAAE,EAAE;;IAChG,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEnD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,WAAW,CAAA;IAE5C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAA;IAE5C,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,KAAQ,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAG,KAAK,EAAE,EAAE,CAAC,CAAA;YAE5C,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,eAAe,EAAE,CAAC;gBACjC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,IAAI;iBACd,CAAA;YACH,CAAC;YAED,MAAM,CAAC,CAAA;QACT,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAElC,MAAM,OAAO,GAAG,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,OAAO,mCAAI,IAAI,CAAA;IAE3C,MAAM,SAAS,GAAG,CAAC,OAAO,CAAA;IAE1B,MAAM,OAAO,GAAG,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,aAAa,mCAAI,MAAA,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,KAAK,0CAAG,CAAC,CAAC,0CAAE,OAAO,CAAA;IAE5E,MAAM,wBAAwB,GAAG,YAAY,CAAA;IAE7C,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAE7E,OAAO;QACL,cAAc;QACd,SAAS;QACT,OAAO;KACR,CAAA;AACH,CAAC,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './fields';
+export * from './types';
+export * from './lib';
+export * from './validators';
+export * from './hooks';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/lib/Field.js

@@ -0,0 +1,346 @@
+import { atom } from 'nanostores';
+import { TypeGuards } from '@codeleap/types';
+import { useStore } from '@nanostores/react';
+import { useFieldBinding } from './useFieldBinding';
+import { createRef, useRef, useState } from 'react';
+import { logger } from '@codeleap/logger';
+/**
+ * Thrown inside a validator function to signal a structured validation failure
+ * without propagating as an unhandled exception. The `data` payload is forwarded
+ * verbatim as the `error` field of the resulting {@link ValidationResult}.
+ *
+ * Throw this instead of returning `{ isValid: false }` when you need to exit
+ * validation from a nested helper that cannot easily return a value.
+ */
+export class ValidationError extends Error {
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+/**
+ * Base class for all form fields. Owns the nanostores atom that holds the
+ * field's current value, runs synchronous validation on demand, and exposes
+ * React hooks (`use`, `useValue`, `useValidation`) that components call to
+ * subscribe to reactive updates.
+ *
+ * **Validation lifecycle**
+ * Validation is always synchronous and called eagerly — there is no deferred
+ * or debounced step. `validate()` runs against the current atom value each
+ * time it is called, so repeated calls are cheap but not memoised. Error
+ * visibility is decoupled from validity: errors are hidden until
+ * `revealError()` is called (or the field has been blurred while starting
+ * with an undefined value), allowing UX to control when messages appear.
+ *
+ * **Initialization order constraint**
+ * The constructor calls `loadState()` synchronously. If `defaultValue` is a
+ * Promise or a function that returns a Promise, the atom is initialised with
+ * `undefined` immediately and the resolved value is set asynchronously once
+ * the promise settles. Do not read `initialValue` before the promise resolves.
+ *
+ * **Platform methods**
+ * `measurePosition`, `scrollTo`, and `getPadding` delegate to static method
+ * slots (`methodMeasurePosition`, `methodScrollTo`, `methodGetPadding`) that
+ * must be assigned by the platform layer (web or mobile) before use; calling
+ * them without an implementation throws.
+ *
+ * **Prop transformers**
+ * `props()` pipes the field's properties through every registered transformer
+ * in insertion order. Transformers are global and shared across all field
+ * instances via `Field.transformers`.
+ */
+export class Field {
+    /**
+     * Marks the field's error as visible. Typically called by `Form.validate`
+     * when `revealErrors: true` is passed, or imperatively after a failed submit.
+     * Has no effect on the underlying validity — only on whether the error
+     * message is shown to the user.
+     */
+    revealError() {
+        this.errorRevealed.set(true);
+    }
+    /**
+     * Resets error visibility to hidden without changing the field's value or
+     * validity state. Useful when clearing a form section programmatically
+     * while preserving the current value.
+     */
+    hideError() {
+        this.errorRevealed.set(false);
+    }
+    get isErrorRevealed() {
+        return this.errorRevealed.get();
+    }
+    constructor(options) {
+        this.properties = {};
+        this.options = options;
+        this.ref = createRef();
+        this.loadState();
+        this.errorRevealed = atom(false);
+        this.setValue = this.setValue.bind(this);
+        this.use = this.use.bind(this);
+        this.useBinding = this.useBinding.bind(this);
+        this.revealError = this.revealError.bind(this);
+        this.hideError = this.hideError.bind(this);
+        this.properties = this.toInternalProperties(options);
+    }
+    get name() {
+        return this.options.name;
+    }
+    get value() {
+        return this.state.get();
+    }
+    get isValid() {
+        const res = this.validate();
+        return res.isValid;
+    }
+    toInternalProperties(options) {
+        const internalKeys = new Set(['name', 'defaultValue', 'state', 'validate', 'loader', 'onValueChange']);
+        const values = Object.assign({ name: this.name }, Object.fromEntries(Object.entries(options).filter(([key]) => !internalKeys.has(key))));
+        return Object.assign({ field: this }, values);
+    }
+    /**
+     * Replaces the field's internal atom with a slice of the owning `Form`'s
+     * global state atom and migrates the current value into it. Called
+     * automatically by `Form.attachState()` during construction — do not call
+     * this manually unless you are building a custom form container.
+     */
+    attach(to) {
+        const val = this.value;
+        this.state = to;
+        this.setValue(val);
+    }
+    setValue(to) {
+        if (this.options.onValueChange)
+            this.options.onValueChange(to);
+        return this.state.set(to);
+    }
+    useValue() {
+        const value = useStore(this.state);
+        return value;
+    }
+    resetValue() {
+        this.setValue(this.initialValue);
+        this.errorRevealed.set(false);
+    }
+    /**
+     * Primary React hook for consuming a field inside a component. Subscribes to
+     * the field's value atom and validation state, and optionally wires an
+     * imperative ref handle via `useFieldBinding`. Must be called
+     * unconditionally at the component's top level.
+     *
+     * The `changed` flag compares the current value to the value captured at
+     * field construction time (or after the last `resetValue`), not to any
+     * previous render.
+     */
+    use(impl, deps) {
+        const value = this.useValue();
+        const validation = this.useValidation();
+        // Yes, this is dangerous and doesn't follow the rules, but not passing an implementation to imperative handle after passing it once would break the app anyway
+        if (impl) {
+            this.useBinding(impl, deps);
+        }
+        const changed = value != this.initialValue;
+        return {
+            validation,
+            value,
+            setValue: this.setValue,
+            changed,
+            representation: this.toRepresentation(value),
+            options: this.options,
+        };
+    }
+    useBinding(...args) {
+        useFieldBinding(this.ref, ...args);
+    }
+    changed() {
+        return this.state.get() != this.initialValue;
+    }
+    // If we make this async, the js engine will not delay further execution while the funcion is not done. This way we wait until we know wheter there's a promise or not
+    loadState() {
+        var _a, _b, _c;
+        let defaultValuePromise = undefined;
+        let defaultValue = undefined;
+        if (TypeGuards.isFunction(this.options.defaultValue)) {
+            const v = this.options.defaultValue();
+            if (TypeGuards.isPromise(v)) {
+                defaultValuePromise = v;
+            }
+            else {
+                defaultValue = v;
+            }
+        }
+        else {
+            const v = (_a = this.options) === null || _a === void 0 ? void 0 : _a.defaultValue;
+            if (TypeGuards.isPromise(v)) {
+                defaultValuePromise = v;
+            }
+            else {
+                defaultValue = v;
+            }
+        }
+        this.state = (_c = (_b = this === null || this === void 0 ? void 0 : this.options) === null || _b === void 0 ? void 0 : _b.state) !== null && _c !== void 0 ? _c : atom(defaultValue);
+        if (!defaultValuePromise) {
+            this.initialValue = defaultValue;
+        }
+        if (!!defaultValuePromise) {
+            this.log('debug', 'Waiting for initial value');
+            return defaultValuePromise
+                .then((v) => {
+                this.state.set(v);
+                this.initialValue = v;
+                this.log('debug', `Got initial value`, v);
+            })
+                .catch(e => {
+                this.log('error', `Failed to resolve default value`, e);
+            });
+        }
+        else {
+            return Promise.resolve();
+        }
+    }
+    formatLog(...args) {
+        const [firstArgument, ...otherArgs] = args;
+        let PREFIX = `(FIELD: ${this.name})`;
+        if (TypeGuards.isString(firstArgument)) {
+            PREFIX += ` ${firstArgument}`;
+        }
+        else {
+            otherArgs.unshift(firstArgument);
+        }
+        const logArgs = [
+            PREFIX,
+            ...otherArgs
+        ];
+        return logArgs;
+    }
+    /**
+     * Runs the field's validator synchronously against `value` (or the current
+     * atom value when omitted). A {@link ValidationError} thrown inside the
+     * validator is caught and converted to `{ isValid: false, error: e.data }`;
+     * any other exception is re-thrown.
+     *
+     * This method is called on every render inside `useValidation` — keep
+     * validators fast and free of side effects.
+     */
+    validate(value) {
+        const validate = this.options.validate;
+        const valueToCheck = TypeGuards.isUndefined(value) ? this.state.get() : this.toInternalValue(value);
+        try {
+            const result = validate(valueToCheck, {});
+            return result;
+        }
+        catch (e) {
+            if (e instanceof ValidationError) {
+                return {
+                    isValid: false,
+                    error: e.data
+                };
+            }
+            throw e;
+        }
+    }
+    /**
+     * React hook that returns reactive validation state for the field's current
+     * value. Error display policy:
+     * - If the field started with an `undefined` value (`startedUnset`), the
+     *   error is hidden until the user has blurred the input **or** until
+     *   `revealError()` has been called.
+     * - If the field started with a defined value, the error is shown
+     *   immediately whenever the field is invalid.
+     *
+     * `message` is resolved from `readableError` first, falling back to the
+     * first element's `.message` when `error` is an array.
+     */
+    useValidation() {
+        var _a, _b;
+        const value = this.useValue();
+        const revealed = useStore(this.errorRevealed);
+        const isUnset = typeof value === 'undefined';
+        const startedUnset = useRef(isUnset).current;
+        const isSet = !isUnset;
+        const validation = this.validate(value);
+        const isValid = validation.isValid;
+        const isInvalid = !isValid;
+        const hasChanged = this.initialValue != value;
+        const message = (_a = validation.readableError) !== null && _a !== void 0 ? _a : (Array.isArray(validation.error) ? (_b = validation.error[0]) === null || _b === void 0 ? void 0 : _b.message : undefined);
+        const errorDisplayRequiresBlur = startedUnset;
+        const [hasBlurred, setHasBlurred] = useState(false);
+        const showError = isInvalid && (errorDisplayRequiresBlur ? revealed || hasBlurred : true);
+        return {
+            onInputBlurred() {
+                setHasBlurred(true);
+            },
+            hasBlurred,
+            hasChanged,
+            startedUnset,
+            isSet,
+            isInvalid,
+            isValid,
+            message,
+            showError,
+            isUnset,
+            validation,
+            value
+        };
+    }
+    log(level = 'log', ...args) {
+        if (Field.enableLogs)
+            logger[level](...this.formatLog(...args));
+    }
+    toInternalValue(v) {
+        return v;
+    }
+    toRepresentation(v) {
+        return v;
+    }
+    /**
+     * Registers a global prop transformer under `key`. Transformers are applied
+     * in insertion order by `props()`. Re-registering an existing key replaces
+     * the previous function.
+     */
+    static attachTransformer(key, fn) {
+        Field.transformers.set(key, fn);
+    }
+    /**
+     * Removes the transformer registered under `key`. Idempotent — no-op if the
+     * key is not present.
+     */
+    static detachTransformer(key) {
+        Field.transformers.delete(key);
+    }
+    /**
+     * Returns the field's properties after running them through every registered
+     * global transformer. The raw `properties` object is built from `options`
+     * with internal keys (`name`, `defaultValue`, `state`, `validate`, `loader`,
+     * `onValueChange`) stripped out, plus a `field` reference to `this`.
+     * Use this when passing field metadata to a component that does not use the
+     * `use()` hook directly.
+     */
+    props() {
+        return Array.from(Field.transformers.values()).reduce((acc, transformer) => transformer(acc), this.properties);
+    }
+    measurePosition(wrapperRef) {
+        return Field.methodMeasurePosition(this, wrapperRef);
+    }
+    scrollTo(scrollRef, measure) {
+        return Field.methodScrollTo(this, scrollRef, measure);
+    }
+    getPadding() {
+        return Field.methodGetPadding(this);
+    }
+}
+Field.transformers = new Map();
+Field.enableLogs = false;
+Field.getProps = (field) => {
+    throw new Error('Field.getProps not implemented');
+};
+Field.methodMeasurePosition = (field, wrapperRef) => {
+    throw new Error('Field.measurePosition not implemented');
+};
+Field.methodScrollTo = (field, scrollRef, measure) => {
+    throw new Error('Field.scrollTo not implemented');
+};
+Field.methodGetPadding = (field) => {
+    throw new Error('Field.getPadding not implemented');
+};
+//# sourceMappingURL=Field.js.map

package/dist/lib/Field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.js","sourceRoot":"","sources":["../../src/lib/Field.ts"],"names":[],"mappings":"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"}

package/dist/lib/Form.js

@@ -0,0 +1,197 @@
+import { createStateSlice, globalState } from "@codeleap/store";
+import { TypeGuards } from "@codeleap/types";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useUnmount } from "@codeleap/hooks";
+function buildState(def) {
+    const stateArg = {};
+    for (const [name, field] of Object.entries(def)) {
+        stateArg[name] = field.value;
+    }
+    return stateArg;
+}
+/**
+ * Container that owns the shared nanostores `GlobalState` atom for a group of
+ * fields and wires each field's individual atom to a slice of that shared
+ * state. This ensures a single source of truth: reading `form.values` always
+ * reflects the live atom values of every field.
+ *
+ * **Initialization order**
+ * The constructor calls `attachState()` synchronously, which replaces each
+ * field's own atom with a derived slice and sets the field's `name` from its
+ * object key in the shape. Fields must therefore be fully constructed before
+ * being passed to `Form`.
+ *
+ * **React usage**
+ * - `use(selector)` — mounts the form in a component, subscribes to state
+ *   changes via `selector`, and resets all field values on unmount. Prefer
+ *   this for full-page forms.
+ * - `useShared(selector)` — subscribes without the unmount-reset side-effect.
+ *   Use when the form outlives the component (e.g. a global singleton).
+ *
+ * **Validation**
+ * `validate()` runs every field's synchronous validator and returns a map of
+ * results keyed by field name. Pass `revealErrors: true` to simultaneously
+ * flip `errorRevealed` on every field, triggering error display in the UI.
+ */
+class Form {
+    constructor(id, shape) {
+        this.id = id;
+        this.fields = shape;
+        this.state = globalState(buildState(this.fields));
+        this.attachState();
+        this.use = this.use.bind(this);
+        this.useShared = this.useShared.bind(this);
+        this.useReset = this.useReset.bind(this);
+    }
+    get values() {
+        return this.state.get();
+    }
+    get isChanged() {
+        return this.changed();
+    }
+    changed() {
+        for (const [fieldName, field] of Object.entries(this.fields)) {
+            if (field.changed())
+                return true;
+        }
+        return false;
+    }
+    get isValid() {
+        const res = this.validate();
+        return Object.values(res).every((result) => result.isValid);
+    }
+    slice(field) {
+        const fieldSlice = createStateSlice(this.state, (v) => v[field], (value) => {
+            return {
+                [field]: value
+            };
+        });
+        return fieldSlice;
+    }
+    iterFields(cb) {
+        const results = [];
+        let index = 0;
+        for (const [name, field] of Object.entries(this.fields)) {
+            const result = cb([name, field], index);
+            results.push(result);
+            index++;
+        }
+        return results;
+    }
+    /**
+     * Bulk-sets field values from a partial record. Boolean fields require an
+     * explicit `boolean` value; all other fields skip `undefined` and falsy
+     * values. Use `resetValues()` to restore all fields to their initial values.
+     */
+    setValues(values) {
+        this.iterFields(([name, field]) => {
+            const value = values === null || values === void 0 ? void 0 : values[name];
+            if (field._type === 'BOOLEAN' && TypeGuards.isBoolean(value))
+                field.setValue(value);
+            else if (value)
+                field.setValue(value);
+        });
+    }
+    resetValues() {
+        this.iterFields(([name, field]) => {
+            field.resetValue();
+        });
+    }
+    attachState() {
+        this.iterFields(([name, field]) => {
+            field.options.name = name;
+            field.attach(this.slice(name));
+        });
+    }
+    /**
+     * Returns the first field (in definition order) that fails validation, along
+     * with its `ValidationResult`. Returns `undefined` when all fields are
+     * valid. Useful for scrolling to the first error on submit.
+     */
+    firstInvalid() {
+        for (const [fieldName, field] of Object.entries(this.fields)) {
+            const validation = field.validate();
+            if (!validation.isValid)
+                return {
+                    field,
+                    validation,
+                };
+        }
+    }
+    validate(options) {
+        const { fields, revealErrors } = options !== null && options !== void 0 ? options : {};
+        const validateFields = fields !== null && fields !== void 0 ? fields : Object.keys(this.fields);
+        const results = this.iterFields(([name, field]) => {
+            if (!validateFields.includes(name))
+                return null;
+            return [name, field.validate()];
+        });
+        const resultMap = Object.fromEntries(results.filter((v) => !TypeGuards.isNil(v)));
+        if (revealErrors) {
+            this.iterFields(([_, field]) => {
+                field.revealError();
+            });
+        }
+        return resultMap;
+    }
+    /**
+     * Returns the transformed props for `field` via `Field.props()`. Throws if
+     * the field key does not exist in this form's shape, making typos a runtime
+     * error rather than a silent no-op.
+     */
+    register(field) {
+        if (!this.fields[field]) {
+            throw new Error(`Field "${field}" not found in "${this.id}" form`);
+        }
+        return this.fields[field].props();
+    }
+    use(selector) {
+        const value = this.useShared(selector);
+        this.useReset();
+        return value;
+    }
+    useReset() {
+        useUnmount(() => {
+            this.resetValues();
+        });
+    }
+    useShared(selector) {
+        const [selected, setSelected] = useState(() => selector(this));
+        const reselect = useCallback(() => {
+            setSelected(selector(this));
+        }, [selector]);
+        useEffect(() => {
+            return this.state.listen((value, previous) => {
+                if (value != previous) {
+                    reselect();
+                }
+            });
+        }, [reselect]);
+        return selected;
+    }
+}
+/**
+ * Creates a `Form` instance that is stable for the lifetime of the component
+ * (memoised on `name`). Use this when the form is local to a single mounted
+ * component. For forms that must survive unmounts (e.g. multi-step flows),
+ * construct the `Form` outside React via `form()`.
+ *
+ * Note: `def` is only read on the first render — changing it after mount has
+ * no effect.
+ */
+export function useForm(name, def) {
+    const form = useMemo(() => {
+        return new Form(name, def);
+    }, [name]);
+    return form;
+}
+/**
+ * Constructs a `Form` outside of React — suitable for module-level singletons,
+ * server-side construction, or multi-step flows where the form must outlive
+ * any individual component. Values are **not** automatically reset on unmount;
+ * call `resetValues()` explicitly when needed.
+ */
+export function form(...args) {
+    return new Form(...args);
+}
+//# sourceMappingURL=Form.js.map

package/dist/lib/Form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../src/lib/Form.ts"],"names":[],"mappings":"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"}

package/dist/lib/factories.js

@@ -0,0 +1,15 @@
+/**
+ * Wraps a `Field` subclass constructor in a factory function, eliminating the
+ * need to call `new` at the call site and improving inference of the
+ * `validate` option's generic type. The returned factory accepts the same
+ * options as the class constructor and produces a fully typed `Field` instance.
+ *
+ * All entries in the `fields` namespace are built with this helper.
+ */
+export function fieldFactory(cls) {
+    return (options) => {
+        // @ts-expect-error
+        return new cls(options !== null && options !== void 0 ? options : {});
+    };
+}
+//# sourceMappingURL=factories.js.map

package/dist/lib/factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.js","sourceRoot":"","sources":["../../src/lib/factories.tsx"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAI1B,GAAM;IACN,OAAO,CAAwC,OAAW,EAAgC,EAAE;QAE1F,mBAAmB;QACnB,OAAO,IAAI,GAAG,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC,CAAA;IAC/B,CAAC,CAAA;AACH,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,3 @@
+export * from './Form';
+export { Field } from './Field';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAC,KAAK,EAAC,MAAM,SAAS,CAAA"}

package/dist/lib/useFieldBinding.js

@@ -0,0 +1,48 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useImperativeHandle } from "react";
+/**
+ * Attaches an imperative handle to `ref` via `useImperativeHandle`. Every
+ * method in {@link IFieldRef} is given a default implementation that throws
+ * `"ref.<method> not implemented"`, so callers get a clear error rather than a
+ * silent no-op when a method is missing from `impl`.
+ *
+ * `impl` is a partial override — only supply the methods your component
+ * actually supports. Unimplemented methods remain as throwing stubs.
+ * `deps` is forwarded directly to `useImperativeHandle`; include anything
+ * `impl` closes over that can change between renders.
+ */
+export function useFieldBinding(ref, impl, deps = []) {
+    const notImplemented = (method) => {
+        throw new Error(`ref.${method} not implemented`);
+    };
+    useImperativeHandle(ref, () => (Object.assign({ blur: () => {
+            notImplemented('blur');
+        }, emit: () => {
+            notImplemented('emit');
+        }, focus: () => {
+            notImplemented('focus');
+        }, 
+        // @ts-expect-error
+        getValue: () => {
+            notImplemented('getValue');
+        }, scrollIntoView: () => __awaiter(this, void 0, void 0, function* () {
+            notImplemented('scrollIntoView');
+        }), hideValue() {
+            notImplemented('hideValue');
+        },
+        revealValue() {
+            notImplemented('revealValue');
+        },
+        toggleValueVisibility() {
+            notImplemented('toggleValueVisibility');
+        } }, impl)), deps);
+}
+//# sourceMappingURL=useFieldBinding.js.map

package/dist/lib/useFieldBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldBinding.js","sourceRoot":"","sources":["../../src/lib/useFieldBinding.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAG3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAI,GAA+C,EAAE,IAA2B,EAAE,OAA6B,EAAE;IAE9I,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;QACxC,MAAM,IAAI,KAAK,CAAC,OAAO,MAAM,kBAAkB,CAAC,CAAA;IAClD,CAAC,CAAA;IAGD,mBAAmB,CAAC,GAAG,EAAE,GAAI,EAAE,CAAC,iBAC9B,IAAI,EAAE,GAAG,EAAE;YACT,cAAc,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC,EACD,IAAI,EAAE,GAAG,EAAE;YACT,cAAc,CAAC,MAAM,CAAC,CAAA;QACxB,CAAC,EACD,KAAK,EAAE,GAAG,EAAE;YACV,cAAc,CAAC,OAAO,CAAC,CAAA;QACzB,CAAC;QACD,mBAAmB;QACnB,QAAQ,EAAE,GAAG,EAAE;YACb,cAAc,CAAC,UAAU,CAAC,CAAA;QAC5B,CAAC,EACD,cAAc,EAAE,GAAS,EAAE;YACzB,cAAc,CAAC,gBAAgB,CAAC,CAAA;QAClC,CAAC,CAAA,EACD,SAAS;YACP,cAAc,CAAC,WAAW,CAAC,CAAA;QAC7B,CAAC;QACD,WAAW;YACT,cAAc,CAAC,aAAa,CAAC,CAAA;QAC/B,CAAC;QACD,qBAAqB;YACnB,cAAc,CAAC,uBAAuB,CAAC,CAAA;QACzC,CAAC,IACE,IAAI,EACP,EAAE,IAAI,CAAC,CAAA;AAEX,CAAC"}

package/dist/types/field.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=field.js.map

package/dist/types/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/types/field.ts"],"names":[],"mappings":""}

package/dist/types/form.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=form.js.map

package/dist/types/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/types/form.ts"],"names":[],"mappings":""}

package/dist/types/globals.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=globals.js.map

package/dist/types/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../src/types/globals.ts"],"names":[],"mappings":""}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":""}

package/dist/validators/index.js

@@ -0,0 +1,2 @@
+export * from './zod';
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

package/dist/validators/zod.js

@@ -0,0 +1,43 @@
+import { TypeGuards } from '@codeleap/types';
+/**
+ * Adapts a Zod schema into the `Validator` contract expected by `Field` and
+ * `useValidate`. Uses `safeParse` internally so Zod errors are captured as
+ * `{ isValid: false, error: ZodIssue[] }` rather than thrown exceptions.
+ *
+ * The returned function is synchronous — async Zod schemas (`z.promise`,
+ * `.parseAsync`) are not supported.
+ */
+export function zodValidator(model) {
+    return (value) => {
+        var _a;
+        const result = model.safeParse(value);
+        return {
+            isValid: result.success,
+            error: (_a = result.error) === null || _a === void 0 ? void 0 : _a.issues,
+            result: result.data
+        };
+    };
+}
+const isZodIssue = (val) => {
+    return ['code', 'expected', 'received', 'path', 'message'].every(x => x in val);
+};
+/**
+ * Type guard that narrows a `ValidationResult`-shaped value to one produced by
+ * `zodValidator`. A valid result must have `result` present; an invalid result
+ * must have `error` as an array of `ZodIssue` objects. Use this to
+ * distinguish Zod results from results produced by custom validators when
+ * handling errors generically.
+ */
+export function isZodValidationResult(val) {
+    const isValidABoolean = TypeGuards.isBoolean(val.isValid);
+    if (isValidABoolean) {
+        if (!val.isValid) {
+            return TypeGuards.isArray(val.error) && val.error.every(isZodIssue);
+        }
+        else {
+            return 'result' in val;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=zod.js.map

package/dist/validators/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/validators/zod.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAsB,KAAQ;IACxD,OAAO,CAAC,KAAc,EAA0B,EAAE;;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAErC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAA,MAAM,CAAC,KAAK,0CAAE,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,IAAI;SACpB,CAAA;IACH,CAAC,CAAA;AACH,CAAC;AAGD,MAAM,UAAU,GAAG,CAAC,GAAQ,EAAmB,EAAE;IAC/C,OAAO,CAAC,MAAM,EAAC,UAAU,EAAC,UAAU,EAAC,MAAM,EAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,CAAA;AAC7E,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAQ;IAC5C,MAAM,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEzD,IAAG,eAAe,EAAE,CAAC;QACnB,IAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACrE,CAAC;aAAM,CAAC;YACN,OAAO,QAAQ,IAAI,GAAG,CAAA;QACxB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AAEd,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/form",
-  "version": "7.0.0",
-  "main": "src/index.ts",
+  "version": "7.0.1",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,10 +22,10 @@
     "directory": "packages/form"
   },
   "devDependencies": {
-    "@codeleap/config": "7.0.0",
-    "@codeleap/types": "7.0.0",
-    "@codeleap/store": "7.0.0",
-    "@codeleap/hooks": "7.0.0",
+    "@codeleap/config": "7.0.1",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/store": "7.0.1",
+    "@codeleap/hooks": "7.0.1",
     "zod": "4.4.3",
     "ts-node-dev": "1.1.8"
   },
@@ -35,10 +35,10 @@
     "playground": "bun src/test.ts"
   },
   "peerDependencies": {
-    "@codeleap/types": "7.0.0",
-    "@codeleap/store": "7.0.0",
-    "@codeleap/logger": "7.0.0",
-    "@codeleap/hooks": "7.0.0",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/store": "7.0.1",
+    "@codeleap/logger": "7.0.1",
+    "@codeleap/hooks": "7.0.1",
     "zod": "*",
     "react": "19.1.0",
     "typescript": "5.5.2"