@codeleap/form 7.0.0 → 7.0.2

package/dist/lib/Field.js

@@ -0,0 +1,351 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Field = exports.ValidationError = void 0;
+const nanostores_1 = require("nanostores");
+const types_1 = require("@codeleap/types");
+const react_1 = require("@nanostores/react");
+const useFieldBinding_1 = require("./useFieldBinding");
+const react_2 = require("react");
+const logger_1 = require("@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.
+ */
+class ValidationError extends Error {
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * 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`.
+ */
+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 = (0, react_2.createRef)();
+        this.loadState();
+        this.errorRevealed = (0, nanostores_1.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 = (0, react_1.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) {
+        (0, useFieldBinding_1.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 (types_1.TypeGuards.isFunction(this.options.defaultValue)) {
+            const v = this.options.defaultValue();
+            if (types_1.TypeGuards.isPromise(v)) {
+                defaultValuePromise = v;
+            }
+            else {
+                defaultValue = v;
+            }
+        }
+        else {
+            const v = (_a = this.options) === null || _a === void 0 ? void 0 : _a.defaultValue;
+            if (types_1.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 : (0, nanostores_1.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 (types_1.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 = types_1.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 = (0, react_1.useStore)(this.errorRevealed);
+        const isUnset = typeof value === 'undefined';
+        const startedUnset = (0, react_2.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] = (0, react_2.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_1.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);
+    }
+}
+exports.Field = Field;
+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.d.ts

@@ -34,7 +34,7 @@ declare class Form<T extends FormDef> {
     get isChanged(): boolean;
     changed(): boolean;
     get isValid(): boolean;
-    slice<K extends FieldPaths<T>>(field: K): import("nanostores").WritableAtom<unknown>;
+    slice<K extends FieldPaths<T>>(field: K): import("nanostores", { with: { "resolution-mode": "import" } }).WritableAtom<unknown>;
     iterFields<V>(cb: (field: FieldTuples<T>, index: number) => V): V[];
     /**
      * Bulk-sets field values from a partial record. Boolean fields require an
@@ -62,7 +62,7 @@ declare class Form<T extends FormDef> {
      * the field key does not exist in this form's shape, making typos a runtime
      * error rather than a silent no-op.
      */
-    register(field: FieldPaths<T>): import("..").IFieldProps;
+    register(field: FieldPaths<T>): import("../types").IFieldProps;
     use<Selected>(selector: FormSelector<T, Selected>): Selected;
     useReset(): void;
     useShared<Selected>(selector: FormSelector<T, Selected>): Selected;

package/dist/lib/Form.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useForm = useForm;
+exports.form = form;
+const store_1 = require("@codeleap/store");
+const types_1 = require("@codeleap/types");
+const react_1 = require("react");
+const hooks_1 = require("@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 = (0, store_1.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 = (0, store_1.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' && types_1.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) => !types_1.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() {
+        (0, hooks_1.useUnmount)(() => {
+            this.resetValues();
+        });
+    }
+    useShared(selector) {
+        const [selected, setSelected] = (0, react_1.useState)(() => selector(this));
+        const reselect = (0, react_1.useCallback)(() => {
+            setSelected(selector(this));
+        }, [selector]);
+        (0, react_1.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.
+ */
+function useForm(name, def) {
+    const form = (0, react_1.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.
+ */
+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,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fieldFactory = fieldFactory;
+/**
+ * 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.
+ */
+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":";;AAcA,oCAUC;AAlBD;;;;;;;GAOG;AACH,SAAgB,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,21 @@
+"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 });
+exports.Field = void 0;
+__exportStar(require("./Form"), exports);
+var Field_1 = require("./Field");
+Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return Field_1.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,yCAAsB;AACtB,iCAA6B;AAArB,8FAAA,KAAK,OAAA"}