@goodie-forms/core 1.0.0-alpha

package/dist/form/Field.d.ts

@@ -0,0 +1,17 @@
+export declare namespace Field {
+    type Paths<TShape extends object> = {
+        [K in keyof TShape & string]: NonNullable<TShape[K]> extends (...args: any[]) => any ? never : NonNullable<TShape[K]> extends object ? K | `${K}.${Paths<NonNullable<TShape[K]>>}` : K;
+    }[keyof TShape & string];
+    type GetValue<TShape extends object, TPath extends string> = TPath extends `${infer K}.${infer Rest}` ? K extends keyof TShape ? GetValue<NonNullable<TShape[K]>, Rest> : never : TPath extends keyof TShape ? TShape[TPath] : never;
+    function getValue<TShape extends object, TPath extends Field.Paths<TShape>>(data: TShape, path: TPath): Field.GetValue<TShape, TPath> | undefined;
+    function deepEqual(a: any, b: any, customComparator?: (a: any, b: any) => boolean | undefined): boolean;
+    function diff<T>(prev: readonly T[], next: readonly T[], equals: (a: T, b: T) => boolean, filter?: (a: T) => boolean): {
+        added: T[];
+        removed: T[];
+        unchanged: T[];
+    };
+    function setValue<TShape extends object, TPath extends Field.Paths<TShape>>(data: TShape, key: TPath, value: Field.GetValue<TShape, TPath>): void;
+    function modifyValue<TShape extends object, TPath extends Field.Paths<TShape>>(data: TShape, key: TPath, modifier: (currentValue: Field.GetValue<TShape, TPath>) => Field.GetValue<TShape, TPath> | void): void;
+    function deleteValue<TShape extends object, TPath extends Field.Paths<TShape>>(data: TShape, key: TPath): void;
+}
+//# sourceMappingURL=Field.d.ts.map

package/dist/form/Field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/form/Field.ts"],"names":[],"mappings":"AAAA,yBAAiB,KAAK,CAAC;IACrB,KAAY,KAAK,CAAC,MAAM,SAAS,MAAM,IAAI;SACxC,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAC3D,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,GACJ,KAAK,GACL,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAC3C,CAAC;KACR,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC;IAEzB,KAAY,QAAQ,CAClB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,MAAM,IAClB,KAAK,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GACxC,CAAC,SAAS,MAAM,MAAM,GACpB,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GACtC,KAAK,GACP,KAAK,SAAS,MAAM,MAAM,GACxB,MAAM,CAAC,KAAK,CAAC,GACb,KAAK,CAAC;IAEZ,SAAgB,QAAQ,CACtB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EACjC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,SAAS,CAatE;IAED,SAAgB,SAAS,CACvB,CAAC,EAAE,GAAG,EACN,CAAC,EAAE,GAAG,EACN,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,OAAO,GAAG,SAAS,WAkE3D;IAED,SAAgB,IAAI,CAAC,CAAC,EACpB,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,EAC/B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO;;;;MAqB3B;IAED,SAAgB,QAAQ,CACtB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EACjC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,QAE/D;IAED,SAAgB,WAAW,CACzB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAEjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,KAAK,EACV,QAAQ,EAAE,CACR,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,KACxC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,QAoB1C;IAED,SAAgB,WAAW,CACzB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EACjC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,QAczB;CACF"}

package/dist/form/FormController.d.ts

@@ -0,0 +1,62 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { Field } from '../form/Field';
+import { DeepPartial } from '../types/DeepPartial';
+import { FormField } from './FormField';
+export declare namespace Form {
+    type Status = "idle" | "validating" | "submitting";
+    type FormConfigs<TShape extends object> = ConstructorParameters<typeof FormController<TShape>>[0];
+    interface PreventableEvent {
+        preventDefault(): void;
+    }
+    type SubmitSuccessHandler<TShape extends object, TEvent extends PreventableEvent> = (data: TShape, event: TEvent, abortSignal: AbortSignal) => void | Promise<void>;
+    type SubmitErrorHandler<TEvent extends PreventableEvent> = (issues: StandardSchemaV1.Issue[], event: TEvent, abortSignal: AbortSignal) => void | Promise<void>;
+}
+export declare class FormController<TShape extends object = object> {
+    _status: Form.Status;
+    _fields: Map<Field.Paths<TShape>, FormField<TShape, any>>;
+    _initialData: DeepPartial<TShape>;
+    _data: DeepPartial<TShape>;
+    _issues: StandardSchemaV1.Issue[];
+    equalityComparators?: Record<any, (a: any, b: any) => boolean>;
+    validationSchema?: StandardSchemaV1<TShape, TShape>;
+    readonly events: import('nanoevents').Emitter<{
+        statusChanged(newStatus: Form.Status, oldStatus: Form.Status): void;
+        fieldBound(fieldPath: Field.Paths<TShape>): void;
+        fieldUnbound(fieldPath: Field.Paths<TShape>): void;
+        fieldTouchUpdated(path: Field.Paths<TShape>): void;
+        fieldDirtyUpdated(path: Field.Paths<TShape>): void;
+        elementBound(fieldPath: Field.Paths<TShape>, el: HTMLElement): void;
+        elementUnbound(fieldPath: Field.Paths<TShape>): void;
+        validationTriggered(fieldPath: Field.Paths<TShape>): void;
+        validationIssuesUpdated(fieldPath: Field.Paths<TShape>): void;
+        valueChanged(path: Field.Paths<TShape>, newValue: Field.GetValue<TShape, Field.Paths<TShape>> | undefined, oldValue: Field.GetValue<TShape, Field.Paths<TShape>> | undefined): void;
+    }>;
+    constructor(config: {
+        initialData?: DeepPartial<TShape>;
+        validationSchema?: StandardSchemaV1<TShape, TShape>;
+        equalityComparators?: Record<any, (a: any, b: any) => boolean>;
+    });
+    get isDirty(): boolean;
+    get isValid(): boolean;
+    get isSubmitting(): boolean;
+    protected setStatus(newStatus: Form.Status): void;
+    _unsafeSetFieldValue<TPath extends Field.Paths<TShape>>(path: TPath, value: Field.GetValue<TShape, TPath>, config?: {
+        updateInitialValue?: boolean;
+    }): void;
+    bindField<TPath extends Field.Paths<TShape>>(path: TPath, config?: {
+        defaultValue?: Field.GetValue<TShape, TPath>;
+        domElement?: HTMLElement;
+    }): FormField<TShape, TPath>;
+    unbindField(path: Field.Paths<TShape>): void;
+    reset(newInitialData?: DeepPartial<TShape>): void;
+    getField<TPath extends Field.Paths<TShape>>(path: TPath, config: {
+        bindIfMissing: true;
+    }): FormField<TShape, TPath>;
+    getField<TPath extends Field.Paths<TShape>>(path: TPath): FormField<TShape, TPath> | undefined;
+    clearFieldIssues<TPath extends Field.Paths<TShape>>(path: TPath): void;
+    private applyValidation;
+    validateField<TPath extends Field.Paths<TShape>>(path: TPath): Promise<void>;
+    validateForm(): Promise<void>;
+    createSubmitHandler<TEvent extends Form.PreventableEvent>(onSuccess?: Form.SubmitSuccessHandler<TShape, TEvent>, onError?: Form.SubmitErrorHandler<TEvent>): (event: TEvent) => Promise<void>;
+}
+//# sourceMappingURL=FormController.d.ts.map

package/dist/form/FormController.d.ts.map

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

package/dist/form/FormField.d.ts

@@ -0,0 +1,34 @@
+import { Field } from './Field';
+import { FormController } from './FormController';
+export declare class FormField<TShape extends object, TPath extends Field.Paths<TShape>> {
+    readonly controller: FormController<TShape>;
+    readonly path: TPath;
+    readonly id: number;
+    protected target?: HTMLElement;
+    protected _isTouched: boolean;
+    protected _isDirty: boolean;
+    constructor(controller: FormController<TShape>, path: TPath);
+    get value(): Field.GetValue<TShape, TPath> | undefined;
+    get boundElement(): HTMLElement | undefined;
+    get issues(): import("@standard-schema/spec").StandardSchemaV1.Issue[];
+    get isTouched(): boolean;
+    get isDirty(): boolean;
+    get isValid(): boolean;
+    protected _setTouched(isTouched: boolean): void;
+    protected _setDirty(isDirty: boolean): void;
+    bindElement(el: HTMLElement | undefined): void;
+    protected static ensureImmerability(value: any): void;
+    setValue(value: Field.GetValue<TShape, TPath>, opts?: Parameters<typeof this.modifyValue>[1]): void;
+    modifyValue(modifier: (currentValue: Field.GetValue<TShape, TPath>, field: this) => Field.GetValue<TShape, TPath> | void, opts?: {
+        shouldTouch?: boolean;
+        shouldMarkDirty?: boolean;
+    }): void;
+    reset(): void;
+    touch(): void;
+    markDirty(): void;
+    triggerValidation(): void;
+    focus(opts?: {
+        shouldTouch?: boolean;
+    }): void;
+}
+//# sourceMappingURL=FormField.d.ts.map

package/dist/form/FormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../src/form/FormField.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,SAAS,CACpB,MAAM,SAAS,MAAM,EACrB,KAAK,SAAS,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;aAUf,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC;aAClC,IAAI,EAAE,KAAK;IAT7B,SAAgB,EAAE,SAAW;IAE7B,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE/B,SAAS,CAAC,UAAU,UAAS;IAC7B,SAAS,CAAC,QAAQ,UAAS;gBAGT,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,EAClC,IAAI,EAAE,KAAK;IAG7B,IAAI,KAAK,8CAKR;IAED,IAAI,YAAY,4BAEf;IAED,IAAI,MAAM,6DAIT;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,OAAO,YAEV;IAED,IAAI,OAAO,YAEV;IAED,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO;IAMxC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO;IAMpC,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS;IAMvC,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG;IA6B9C,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EACpC,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAK/C,WAAW,CACT,QAAQ,EAAE,CACR,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EAC3C,KAAK,EAAE,IAAI,KACR,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,EACzC,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IA0DH,KAAK;IAKL,KAAK;IAIL,SAAS;IAKT,iBAAiB;IAIjB,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './form/Field';
+export * from './form/FormField';
+export * from './form/FormController';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}