@codeleap/form 7.0.0 → 7.0.2

package/dist/fields/bool.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BooleanField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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`.
+ */
+class BooleanField extends Field_1.Field {
+    constructor(options) {
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(zod_1.z.boolean()) }, options));
+        this._type = "BOOLEAN";
+    }
+}
+exports.BooleanField = BooleanField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAS5C;;;;GAIG;AACH,MAAa,YAAgD,SAAQ,aAAwB;IAG3F,YAAY,OAAsC;QAChD,KAAK,iBACH,QAAQ,EAAE,IAAA,yBAAY,EAAC,OAAC,CAAC,OAAO,EAAE,CAAwB,IACvD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,SAAS,CAAA;IAOjB,CAAC;CACF;AATD,oCASC"}

package/dist/fields/date.js

@@ -0,0 +1,63 @@
+"use strict";
+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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../validators");
+const dayjs_1 = __importDefault(require("dayjs"));
+function normalizeToDate(val) {
+    if (!val)
+        return undefined;
+    if (val instanceof Date)
+        return val;
+    if (dayjs_1.default.isDayjs(val))
+        return val.startOf('day').toDate();
+    if (typeof val === 'string') {
+        const parsed = (0, dayjs_1.default)(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.
+ */
+class DateField extends Field_1.Field {
+    constructor(options) {
+        const { minimumDate, maximumDate } = options, rest = __rest(options, ["minimumDate", "maximumDate"]);
+        const schema = zod_1.z.preprocess((val) => {
+            const normalized = normalizeToDate(val);
+            if (!normalized || isNaN(normalized.getTime()))
+                return undefined;
+            return normalized;
+        }, zod_1.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: (0, validators_1.zodValidator)(schema) }, options));
+        this._type = "DATE";
+    }
+}
+exports.DateField = DateField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAC5C,kDAAyB;AAUzB,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAE1B,IAAI,GAAG,YAAY,IAAI;QAAE,OAAO,GAAG,CAAA;IACnC,IAAI,eAAK,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,IAAA,eAAK,EAAC,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,MAAa,SAA0C,SAAQ,aAAqB;IAGlF,YAAY,OAAmC;QAC7C,MAAM,EAAE,WAAW,EAAE,WAAW,KAAc,OAAO,EAAhB,IAAI,UAAK,OAAO,EAA/C,8BAAqC,CAAU,CAAA;QAErD,MAAM,MAAM,GAAG,OAAC,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,OAAC,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,IAAA,yBAAY,EAAC,MAAM,CAAwB,IAClD,OAAO,EACV,CAAA;QAtBJ,UAAK,GAAG,MAAM,CAAA;IAuBd,CAAC;CACF;AAzBD,8BAyBC"}

package/dist/fields/file.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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.
+ */
+class FileField extends Field_1.Field {
+    constructor(options) {
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(zod_1.z.any()) }, options));
+        this._type = "FILE";
+    }
+}
+exports.FileField = FileField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAO5C;;;;;GAKG;AACH,MAAa,SAA0C,SAAQ,aAAoB;IAGjF,YAAY,OAAmC;QAC7C,KAAK,iBACH,QAAQ,EAAE,IAAA,yBAAY,EAAC,OAAC,CAAC,GAAG,EAAE,CAAwB,IACnD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,MAAM,CAAA;IAOd,CAAC;CACF;AATD,8BASC"}

package/dist/fields/group.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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.
+ */
+class GroupField extends Field_1.Field {
+    constructor(options) {
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(zod_1.z.string()) }, options));
+        this._type = "group";
+    }
+}
+exports.GroupField = GroupField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAQ5C;;;;;GAKG;AACH,MAAa,UAA4C,SAAQ,aAAuB;IAGtF,YAAY,OAAoC;QAC9C,KAAK,iBACH,QAAQ,EAAE,IAAA,yBAAY,EAAC,OAAC,CAAC,MAAM,EAAE,CAAwB,IACtD,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,OAAO,CAAA;IAOf,CAAC;CACF;AATD,gCASC"}

package/dist/fields/index.d.ts

@@ -23,7 +23,7 @@ export declare const fields: {
     text: <A extends {
         name?: string;
         defaultValue?: string | null | undefined;
-        state?: import("nanostores").WritableAtom<string> | undefined;
+        state?: import("nanostores", { with: { "resolution-mode": "import" } }).WritableAtom<string> | undefined;
         validate?: import("./text").TextValidator<any, any> | undefined;
         loader?: ((form: any) => Partial<Omit<import("..").FieldOptions<string, import("./text").TextValidator<any, any>>, "loader">>) | undefined;
         onValueChange?: ((newValue: string) => void) | undefined;
@@ -46,7 +46,7 @@ export declare const fields: {
     boolean: <A extends {
         name?: string;
         defaultValue?: boolean | null | undefined;
-        state?: import("nanostores").WritableAtom<boolean> | undefined;
+        state?: import("nanostores", { with: { "resolution-mode": "import" } }).WritableAtom<boolean> | undefined;
         validate?: import("./bool").BooleanValidator<any, any> | undefined;
         loader?: ((form: any) => Partial<Omit<import("..").FieldOptions<boolean, import("./bool").BooleanValidator<any, any>>, "loader">>) | undefined;
         onValueChange?: ((newValue: boolean) => void) | undefined;
@@ -54,7 +54,7 @@ export declare const fields: {
     selectable: <A extends {
         name?: string;
         defaultValue?: (string | number) | null | undefined;
-        state?: import("nanostores").WritableAtom<string | number> | undefined;
+        state?: import("nanostores", { with: { "resolution-mode": "import" } }).WritableAtom<string | number> | undefined;
         validate?: import("./selectable").SelectableValidator<string | number, any, any> | undefined;
         loader?: ((form: any) => Partial<Omit<import("..").FieldOptions<string | number, import("./selectable").SelectableValidator<string | number, any, any>>, "loader">>) | undefined;
         onValueChange?: ((newValue: string | number) => void) | undefined;

package/dist/fields/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileField = exports.DateField = exports.SelectableField = exports.BooleanField = exports.NumberField = exports.ListField = exports.TextField = exports.fields = void 0;
+const factories_1 = require("../lib/factories");
+const text_1 = require("./text");
+Object.defineProperty(exports, "TextField", { enumerable: true, get: function () { return text_1.TextField; } });
+const list_1 = require("./list");
+Object.defineProperty(exports, "ListField", { enumerable: true, get: function () { return list_1.ListField; } });
+const number_1 = require("./number");
+Object.defineProperty(exports, "NumberField", { enumerable: true, get: function () { return number_1.NumberField; } });
+const bool_1 = require("./bool");
+Object.defineProperty(exports, "BooleanField", { enumerable: true, get: function () { return bool_1.BooleanField; } });
+const selectable_1 = require("./selectable");
+Object.defineProperty(exports, "SelectableField", { enumerable: true, get: function () { return selectable_1.SelectableField; } });
+const date_1 = require("./date");
+Object.defineProperty(exports, "DateField", { enumerable: true, get: function () { return date_1.DateField; } });
+const file_1 = require("./file");
+Object.defineProperty(exports, "FileField", { enumerable: true, get: function () { return file_1.FileField; } });
+/**
+ * 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.
+ */
+exports.fields = {
+    text: (0, factories_1.fieldFactory)(text_1.TextField),
+    list: list_1.listFieldFactory,
+    number: (0, factories_1.fieldFactory)(number_1.NumberField),
+    boolean: (0, factories_1.fieldFactory)(bool_1.BooleanField),
+    selectable: (0, factories_1.fieldFactory)(selectable_1.SelectableField),
+    date: (0, factories_1.fieldFactory)(date_1.DateField),
+    file: (0, factories_1.fieldFactory)(file_1.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,gDAA+C;AAC/C,iCAAkC;AAkChC,0FAlCO,gBAAS,OAkCP;AAjCX,iCAAoD;AAkClD,0FAlCO,gBAAS,OAkCP;AAjCX,qCAAsC;AAkCpC,4FAlCO,oBAAW,OAkCP;AAjCb,iCAAqC;AAkCnC,6FAlCO,mBAAY,OAkCP;AAjCd,6CAA8C;AAkC5C,gGAlCO,4BAAe,OAkCP;AAjCjB,iCAAkC;AAkChC,0FAlCO,gBAAS,OAkCP;AAjCX,iCAAkC;AAkChC,0FAlCO,gBAAS,OAkCP;AA/BX;;;;;;;;;;;;;GAaG;AACU,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,IAAA,wBAAY,EAAC,gBAAS,CAAC;IAC7B,IAAI,EAAE,uBAAgB;IACtB,MAAM,EAAE,IAAA,wBAAY,EAAC,oBAAW,CAAC;IACjC,OAAO,EAAE,IAAA,wBAAY,EAAC,mBAAY,CAAC;IACnC,UAAU,EAAE,IAAA,wBAAY,EAAC,4BAAe,CAAC;IACzC,IAAI,EAAE,IAAA,wBAAY,EAAC,gBAAS,CAAC;IAC7B,IAAI,EAAE,IAAA,wBAAY,EAAC,gBAAS,CAAC;CAC9B,CAAA"}

package/dist/fields/list.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListField = void 0;
+exports.listFieldFactory = listFieldFactory;
+const Field_1 = require("../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.
+ */
+class ListField extends Field_1.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";
+    }
+}
+exports.ListField = ListField;
+/**
+ * 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.
+ */
+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":";;;AAkFA,4CAEC;AApFD,wCAAoC;AA6BpC;;;;;;;;;GASG;AACH,MAAa,SAAqC,SAAQ,aAAiD;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;AAlCD,8BAkCC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAA2B,OAA4B;IACrF,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC"}

package/dist/fields/number.js

@@ -0,0 +1,39 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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.
+ */
+class NumberField extends Field_1.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 = zod_1.z.number().min(min).max(max);
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(isMultiple ? zod_1.z.array(zScheme) : zScheme), min,
+            max,
+            defaultValue }, others));
+        this._type = "NUMBER";
+    }
+}
+exports.NumberField = NumberField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAY5C,MAAM,gBAAgB,GAAG,gBAAgB,CAAA,CAAC,yEAAyE;AAEnH;;;;;;;GAOG;AACH,MAAa,WAA8C,SAAQ,aAAkC;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,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE5C,KAAK,CAAC,gBACJ,QAAQ,EAAE,IAAA,yBAAY,EAAC,UAAU,CAAC,CAAC,CAAC,OAAC,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;AAlBD,kCAkBC"}

package/dist/fields/selectable.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectableField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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.
+ */
+class SelectableField extends Field_1.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 = zod_1.z.string().or(zod_1.z.number());
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(zod_1.z.array(zScheme).min(minItems).max(maxItems).or(zScheme)), minItems,
+            maxItems }, options));
+        this._type = "SELECTABLE";
+    }
+}
+exports.SelectableField = SelectableField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAc5C;;;;;;;GAOG;AACH,MAAa,eAA0E,SAAQ,aAAkB;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,OAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAA;QAEzC,KAAK,iBACH,QAAQ,EAAE,IAAA,yBAAY,EAAC,OAAC,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;AAfD,0CAeC"}

package/dist/fields/text.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextField = void 0;
+const Field_1 = require("../lib/Field");
+const zod_1 = require("zod");
+const validators_1 = require("../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.
+ */
+class TextField extends Field_1.Field {
+    constructor(options) {
+        super(Object.assign({ validate: (0, validators_1.zodValidator)(zod_1.z.string().optional()) }, options));
+        this._type = "TEXT";
+    }
+}
+exports.TextField = TextField;
+//# 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,wCAAoC;AACpC,6BAAuB;AAEvB,8CAA4C;AAY5C;;;;;GAKG;AACH,MAAa,SAA0C,SAAQ,aAAuB;IAGpF,YAAY,OAAmC;QAC7C,KAAK,iBACH,QAAQ,EAAE,IAAA,yBAAY,EAAC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAwB,IACjE,OAAO,EACV,CAAA;QANJ,UAAK,GAAG,MAAM,CAAA;IAOd,CAAC;CACF;AATD,8BASC"}

package/dist/hooks/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useValidate = exports.useField = void 0;
+var useField_1 = require("./useField");
+Object.defineProperty(exports, "useField", { enumerable: true, get: function () { return useField_1.useField; } });
+var useValidate_1 = require("./useValidate");
+Object.defineProperty(exports, "useValidate", { enumerable: true, get: function () { return useValidate_1.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,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,6CAA2C;AAAlC,0GAAA,WAAW,OAAA"}

package/dist/hooks/useField.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useField = useField;
+const react_1 = require("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.
+ */
+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 = (0, react_1.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":";;AAgBA,4BAUC;AA1BD,iCAA+B;AAG/B;;;;;;;;;;;;GAYG;AACH,SAAgB,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,IAAA,eAAO,EAAC,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,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useValidate = void 0;
+const react_1 = require("react");
+const Field_1 = require("../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.
+ */
+const useValidate = (value, providedValidate) => {
+    var _a, _b, _c, _d;
+    const [hasBlurred, setHasBlurred] = (0, react_1.useState)(false);
+    const isUnset = typeof value === 'undefined';
+    const startedUnset = (0, react_1.useRef)(isUnset).current;
+    const validate = (0, react_1.useCallback)((value) => {
+        try {
+            const result = providedValidate === null || providedValidate === void 0 ? void 0 : providedValidate(value, {});
+            return result;
+        }
+        catch (e) {
+            if (e instanceof Field_1.ValidationError) {
+                return {
+                    isValid: false,
+                    error: e.data
+                };
+            }
+            throw e;
+        }
+    }, []);
+    const onInputBlurred = (0, react_1.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,
+    };
+};
+exports.useValidate = useValidate;
+//# 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,iCAAqD;AAErD,wCAA8C;AAE9C;;;;;;;;;;;;;;;GAeG;AACI,MAAM,WAAW,GAAG,CAAsC,KAAQ,EAAE,gBAAmB,EAAE,EAAE;;IAChG,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAA;IAEnD,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,WAAW,CAAA;IAE5C,MAAM,YAAY,GAAG,IAAA,cAAM,EAAC,OAAO,CAAC,CAAC,OAAO,CAAA;IAE5C,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,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,uBAAe,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,IAAA,mBAAW,EAAC,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;AA7CY,QAAA,WAAW,eA6CvB"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fields"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./lib"), exports);
+__exportStar(require("./validators"), exports);
+__exportStar(require("./hooks"), exports);
+//# 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,2CAAwB;AACxB,0CAAuB;AACvB,wCAAqB;AACrB,+CAA4B;AAC5B,0CAAuB"}

package/dist/lib/Field.d.ts

@@ -90,7 +90,7 @@ export declare class Field<T, Validate extends Validator<T, any, any>, Result =
      */
     attach(to: FieldState<T>): void;
     setValue(to: T): void;
-    useValue(): T | import("nanostores").StoreValue<T extends object ? import("nanostores").MapStore<T> : never>;
+    useValue(): T | import("nanostores", { with: { "resolution-mode": "import" } }).StoreValue<T extends object ? import("nanostores", { with: { "resolution-mode": "import" } }).MapStore<T> : never>;
     resetValue(): void;
     /**
      * Primary React hook for consuming a field inside a component. Subscribes to
@@ -115,9 +115,9 @@ export declare class Field<T, Validate extends Validator<T, any, any>, Result =
             showError: boolean;
             isUnset: boolean;
             validation: ValidationResult<Result, Err>;
-            value: T | import("nanostores").StoreValue<T extends object ? import("nanostores").MapStore<T> : never>;
+            value: T | import("nanostores", { with: { "resolution-mode": "import" } }).StoreValue<T extends object ? import("nanostores", { with: { "resolution-mode": "import" } }).MapStore<T> : never>;
         };
-        value: T | import("nanostores").StoreValue<T extends object ? import("nanostores").MapStore<T> : never>;
+        value: T | import("nanostores", { with: { "resolution-mode": "import" } }).StoreValue<T extends object ? import("nanostores", { with: { "resolution-mode": "import" } }).MapStore<T> : never>;
         setValue: (to: T) => void;
         changed: boolean;
         representation: any;
@@ -161,7 +161,7 @@ export declare class Field<T, Validate extends Validator<T, any, any>, Result =
         showError: boolean;
         isUnset: boolean;
         validation: ValidationResult<Result, Err>;
-        value: T | import("nanostores").StoreValue<T extends object ? import("nanostores").MapStore<T> : never>;
+        value: T | import("nanostores", { with: { "resolution-mode": "import" } }).StoreValue<T extends object ? import("nanostores", { with: { "resolution-mode": "import" } }).MapStore<T> : never>;
     };
     log(level?: string, ...args: any[]): void;
     toInternalValue(v: any): T;