@vaadin/hilla-lit-form 24.4.0-alpha1

package/.lintstagedrc.js

@@ -0,0 +1,6 @@
+import { commands, extensions } from '../../../.lintstagedrc.js';
+
+export default {
+  [`src/**/*.{${extensions}}`]: commands,
+  [`test/**/*.{${extensions}}`]: commands,
+};

package/Binder.d.ts

@@ -0,0 +1,28 @@
+import { type BinderConfiguration, BinderRoot } from './BinderRoot.js';
+import type { AbstractModel, DetachedModelConstructor, Value } from './Models.js';
+/**
+ * A Binder controls all aspects of a single form.
+ * Typically, it is used to get and set the form value,
+ * access the form model, validate, reset, and submit the form.
+ *
+ * @typeParam T - Type of the value that binds to a form
+ * @typeParam M - Type of the model that describes the structure of the value
+ */
+export declare class Binder<M extends AbstractModel> extends BinderRoot<M> {
+    readonly ['constructor']: Omit<typeof Binder<M>, 'constructor'>;
+    context: Element;
+    /**
+     *
+     * @param context - The form view component instance to update.
+     * @param Model - The constructor (the class reference) of the form model. The Binder instantiates the top-level model
+     * @param config - The options object, which can be used to config the onChange and onSubmit callbacks.
+     *
+     * ```
+     * binder = new Binder(orderView, OrderModel);
+     * or
+     * binder = new Binder(orderView, OrderModel, {onSubmit: async (order) => {endpoint.save(order)}});
+     * ```
+     */
+    constructor(context: Element, Model: DetachedModelConstructor<M>, config?: BinderConfiguration<Value<M>>);
+}
+//# sourceMappingURL=Binder.d.ts.map

package/Binder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Binder.d.ts","sourceRoot":"","sources":["src/Binder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;GAOG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAChE,SAAiB,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAExE,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;OAWG;gBACS,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAczG"}

package/Binder.js

@@ -0,0 +1,29 @@
+import { BinderRoot } from "./BinderRoot.js";
+class Binder extends BinderRoot {
+  context;
+  /**
+   *
+   * @param context - The form view component instance to update.
+   * @param Model - The constructor (the class reference) of the form model. The Binder instantiates the top-level model
+   * @param config - The options object, which can be used to config the onChange and onSubmit callbacks.
+   *
+   * ```
+   * binder = new Binder(orderView, OrderModel);
+   * or
+   * binder = new Binder(orderView, OrderModel, {onSubmit: async (order) => {endpoint.save(order)}});
+   * ```
+   */
+  constructor(context, Model, config) {
+    const changeCallback = config?.onChange ?? (typeof context.requestUpdate === "function" ? () => context.requestUpdate() : void 0);
+    super(Model, {
+      ...config ?? {},
+      onChange: changeCallback,
+      context
+    });
+    this.context = context;
+  }
+}
+export {
+  Binder
+};
+//# sourceMappingURL=Binder.js.map

package/Binder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/Binder.ts"],
+  "sourcesContent": ["import type { LitElement } from 'lit';\nimport { type BinderConfiguration, BinderRoot } from './BinderRoot.js';\nimport type { AbstractModel, DetachedModelConstructor, Value } from './Models.js';\n\n/**\n * A Binder controls all aspects of a single form.\n * Typically, it is used to get and set the form value,\n * access the form model, validate, reset, and submit the form.\n *\n * @typeParam T - Type of the value that binds to a form\n * @typeParam M - Type of the model that describes the structure of the value\n */\nexport class Binder<M extends AbstractModel> extends BinderRoot<M> {\n  declare readonly ['constructor']: Omit<typeof Binder<M>, 'constructor'>;\n\n  context: Element;\n\n  /**\n   *\n   * @param context - The form view component instance to update.\n   * @param Model - The constructor (the class reference) of the form model. The Binder instantiates the top-level model\n   * @param config - The options object, which can be used to config the onChange and onSubmit callbacks.\n   *\n   * ```\n   * binder = new Binder(orderView, OrderModel);\n   * or\n   * binder = new Binder(orderView, OrderModel, {onSubmit: async (order) => {endpoint.save(order)}});\n   * ```\n   */\n  constructor(context: Element, Model: DetachedModelConstructor<M>, config?: BinderConfiguration<Value<M>>) {\n    const changeCallback =\n      config?.onChange ??\n      (typeof (context as LitElement).requestUpdate === 'function'\n        ? () => (context as LitElement).requestUpdate()\n        : undefined);\n\n    super(Model, {\n      ...(config ?? {}),\n      onChange: changeCallback,\n      context,\n    });\n    this.context = context;\n  }\n}\n"],
+  "mappings": "AACA,SAAmC,kBAAkB;AAW9C,MAAM,eAAwC,WAAc;AAAA,EAGjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,YAAY,SAAkB,OAAoC,QAAwC;AACxG,UAAM,iBACJ,QAAQ,aACP,OAAQ,QAAuB,kBAAkB,aAC9C,MAAO,QAAuB,cAAc,IAC5C;AAEN,UAAM,OAAO;AAAA,MACX,GAAI,UAAU,CAAC;AAAA,MACf,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,SAAK,UAAU;AAAA,EACjB;AACF;",
+  "names": []
+}

package/BinderNode.d.ts

@@ -0,0 +1,123 @@
+import type { BinderRoot } from './BinderRoot.js';
+import { AbstractModel, type ArrayItemModel, type Value } from './Models.js';
+import type { ClassStaticProperties } from './types.js';
+import type { Validator, ValueError } from './Validation.js';
+import { _validity } from './Validity.js';
+export declare const _updateValidation: unique symbol;
+export declare const _update: unique symbol;
+export declare const _setErrorsWithDescendants: unique symbol;
+export declare const _clearValidation: unique symbol;
+export declare function getBinderNode<M extends AbstractModel>(model: M): BinderNode<M>;
+export declare const CHANGED: Event;
+/**
+ * The BinderNode\<M\> class provides the form binding related APIs
+ * with respect to a particular model instance.
+ *
+ * Structurally, model instances form a tree, in which the object
+ * and array models have child nodes of field and array item model
+ * instances.
+ */
+export declare class BinderNode<M extends AbstractModel = AbstractModel> extends EventTarget {
+    #private;
+    readonly ['constructor']: ClassStaticProperties<typeof BinderNode<M>>;
+    readonly model: M;
+    /**
+     * The validity state read from the bound element, if any. Represents the
+     * HTML element internal validation.
+     *
+     * For elements with `validity.valid === false`, the value in the
+     * bound element is considered as invalid.
+     */
+    [_validity]?: ValidityState;
+    constructor(model: M);
+    /**
+     * The binder for the top-level model.
+     */
+    get binder(): BinderRoot;
+    /**
+     * The default value related to the model
+     */
+    get defaultValue(): Value<M> | undefined;
+    /**
+     * True if the current value is different from the defaultValue.
+     */
+    get dirty(): boolean;
+    /**
+     * The combined array of all errors for this node’s model and all its nested
+     * models
+     */
+    get errors(): readonly ValueError[];
+    /**
+     * Indicates if there is any error for the node's model.
+     */
+    get invalid(): boolean;
+    /**
+     * The name generated from the model structure, used to set the name
+     * attribute on the field components.
+     */
+    get name(): string;
+    /**
+     * The array of validation errors directly related with the model.
+     */
+    get ownErrors(): ReadonlyArray<ValueError<Value<M>>>;
+    /**
+     * The parent node, if this binder node corresponds to a nested model,
+     * otherwise undefined for the top-level binder.
+     */
+    get parent(): BinderNode | undefined;
+    /**
+     * True if the value is required to be non-empty.
+     */
+    get required(): boolean;
+    /**
+     * The array of validators for the model. The default value is defined in the
+     * model.
+     */
+    get validators(): ReadonlyArray<Validator<Value<M>>>;
+    set validators(validators: ReadonlyArray<Validator<Value<M>>>);
+    /**
+     * The current value related to the model
+     */
+    get value(): Value<M> | undefined;
+    set value(value: Value<M> | undefined);
+    /**
+     * True if the bound field was ever focused and blurred by the user.
+     */
+    get visited(): boolean;
+    set visited(v: boolean);
+    /**
+     * A helper method to add a validator
+     *
+     * @param validator - a validator
+     */
+    addValidator(validator: Validator<Value<M>>): void;
+    /**
+     * Append an item to the array value.
+     *
+     * Requires the context model to be an array reference.
+     *
+     * @param item - optional new item value, an empty item is
+     * appended if the argument is omitted
+     */
+    appendItem(item?: Value<ArrayItemModel<M>>): void;
+    /**
+     * Returns a binder node for the nested model instance.
+     *
+     * @param model - The nested model instance
+     */
+    for<N extends AbstractModel>(model: N): BinderNode<N>;
+    prependItem(item?: Value<ArrayItemModel<M>>): void;
+    removeSelf(): void;
+    /**
+     * Runs all validation callbacks potentially affecting this
+     * or any nested model. Returns the combined array of all
+     * errors as in the errors property.
+     */
+    validate(): Promise<readonly ValueError[]>;
+    protected [_clearValidation](): boolean;
+    protected [_setErrorsWithDescendants](errors?: readonly ValueError[]): void;
+    protected [_update](_?: Value<M>): void;
+    protected [_updateValidation](): Promise<void>;
+    initializeValue(forceInitialize?: boolean): void;
+}
+//# sourceMappingURL=BinderNode.d.ts.map

package/BinderNode.d.ts.map

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

package/BinderNode.js

@@ -0,0 +1,414 @@
+import {
+  _createEmptyItemValue,
+  _key,
+  _parent,
+  _validators,
+  AbstractModel,
+  ArrayModel,
+  getObjectModelOwnAndParentGetters,
+  ObjectModel
+} from "./Models.js";
+import { ValidityStateValidator } from "./Validators.js";
+import { _validity } from "./Validity.js";
+const _updateValidation = Symbol("updateValidation");
+const _update = Symbol("update");
+const _setErrorsWithDescendants = Symbol("setErrorsWithDescendants");
+const _clearValidation = Symbol("clearValidation");
+const nodes = /* @__PURE__ */ new WeakMap();
+function getBinderNode(model) {
+  let node = nodes.get(model);
+  if (!node) {
+    node = new BinderNode(model);
+    nodes.set(model, node);
+  }
+  return node;
+}
+function getErrorPropertyName(valueError) {
+  return typeof valueError.property === "string" ? valueError.property : getBinderNode(valueError.property).name;
+}
+function updateObjectOrArrayKey(model, value, key, keyValue) {
+  if (model instanceof ObjectModel) {
+    return {
+      ...value,
+      [key]: keyValue
+    };
+  }
+  if (keyValue === void 0) {
+    throw new TypeError("Unexpected undefined value");
+  }
+  if (model instanceof ArrayModel) {
+    const array = value.slice();
+    array[key] = keyValue;
+    return array;
+  }
+  throw new TypeError(`Unknown model type ${model.constructor.name}`);
+}
+const CHANGED = new Event("binder-node-changed");
+class NotArrayModelError extends Error {
+  constructor() {
+    super("The model does not represent array");
+  }
+}
+class NotArrayItemModelError extends Error {
+  constructor() {
+    super("The model does not represent array item");
+  }
+}
+const defaultArrayItemCache = /* @__PURE__ */ new WeakMap();
+class BinderNode extends EventTarget {
+  model;
+  /**
+   * The validity state read from the bound element, if any. Represents the
+   * HTML element internal validation.
+   *
+   * For elements with `validity.valid === false`, the value in the
+   * bound element is considered as invalid.
+   */
+  [_validity];
+  #ownErrors;
+  #validators;
+  #validityStateValidator;
+  #visited = false;
+  constructor(model) {
+    super();
+    this.model = model;
+    nodes.set(model, this);
+    this.#validityStateValidator = new ValidityStateValidator();
+    this.#validators = model[_validators];
+    if (this.constructor === BinderNode) {
+      this.initializeValue();
+    }
+  }
+  /**
+   * The binder for the top-level model.
+   */
+  get binder() {
+    const binder = this.parent?.binder;
+    if (!binder) {
+      throw new TypeError("BinderNode is detached");
+    }
+    return binder;
+  }
+  /**
+   * The default value related to the model
+   */
+  get defaultValue() {
+    const key = this.model[_key];
+    const parentDefaultValue = this.parent.defaultValue;
+    if (this.#isArrayItem() && !(key in parentDefaultValue)) {
+      if (defaultArrayItemCache.has(this.parent)) {
+        return defaultArrayItemCache.get(this.parent);
+      }
+      const value = this.model.constructor.createEmptyValue();
+      defaultArrayItemCache.set(this.parent, value);
+      return value;
+    }
+    return parentDefaultValue[key];
+  }
+  /**
+   * True if the current value is different from the defaultValue.
+   */
+  get dirty() {
+    return this.value !== this.defaultValue;
+  }
+  /**
+   * The combined array of all errors for this node’s model and all its nested
+   * models
+   */
+  get errors() {
+    return [...Array.from(this.#getChildBinderNodes(), (node) => node.errors).flat(), ...this.ownErrors];
+  }
+  /**
+   * Indicates if there is any error for the node's model.
+   */
+  get invalid() {
+    return this.errors.length > 0;
+  }
+  /**
+   * The name generated from the model structure, used to set the name
+   * attribute on the field components.
+   */
+  get name() {
+    let { model } = this;
+    let name = "";
+    while (model[_parent] instanceof AbstractModel) {
+      name = `${String(model[_key])}${name ? `.${name}` : ""}`;
+      model = model[_parent];
+    }
+    return name;
+  }
+  /**
+   * The array of validation errors directly related with the model.
+   */
+  get ownErrors() {
+    return this.#ownErrors ? this.#ownErrors : [];
+  }
+  /**
+   * The parent node, if this binder node corresponds to a nested model,
+   * otherwise undefined for the top-level binder.
+   */
+  get parent() {
+    const modelParent = this.model[_parent];
+    return modelParent instanceof AbstractModel ? getBinderNode(modelParent) : void 0;
+  }
+  /**
+   * True if the value is required to be non-empty.
+   */
+  get required() {
+    return this.#validators.some((validator) => validator.impliesRequired);
+  }
+  /**
+   * The array of validators for the model. The default value is defined in the
+   * model.
+   */
+  get validators() {
+    return this.#validators;
+  }
+  set validators(validators) {
+    this.#validators = validators;
+    this.dispatchEvent(CHANGED);
+  }
+  /**
+   * The current value related to the model
+   */
+  get value() {
+    if (!this.parent) {
+      return void 0;
+    }
+    let { value } = this.parent;
+    if (value === void 0) {
+      this.parent.initializeValue(true);
+      ({ value } = this.parent);
+    }
+    const key = this.model[_key];
+    return value[key];
+  }
+  set value(value) {
+    this.initializeValue();
+    this.#setValueState(value, void 0);
+  }
+  /**
+   * True if the bound field was ever focused and blurred by the user.
+   */
+  get visited() {
+    return this.#visited;
+  }
+  set visited(v) {
+    if (this.#visited !== v) {
+      this.#visited = v;
+      this[_updateValidation]().catch(() => {
+      });
+      this.dispatchEvent(CHANGED);
+    }
+  }
+  /**
+   * A helper method to add a validator
+   *
+   * @param validator - a validator
+   */
+  addValidator(validator) {
+    this.validators = [...this.#validators, validator];
+    this.dispatchEvent(CHANGED);
+  }
+  /**
+   * Append an item to the array value.
+   *
+   * Requires the context model to be an array reference.
+   *
+   * @param item - optional new item value, an empty item is
+   * appended if the argument is omitted
+   */
+  appendItem(item) {
+    if (this.#isArray()) {
+      const itemValueOrEmptyValue = item ?? this.model[_createEmptyItemValue]();
+      const newValue = [...this.value ?? [], itemValueOrEmptyValue];
+      const newDefaultValue = [...this.defaultValue ?? [], itemValueOrEmptyValue];
+      this.#setValueState(newValue, newDefaultValue);
+    } else {
+      throw new NotArrayModelError();
+    }
+  }
+  /**
+   * Returns a binder node for the nested model instance.
+   *
+   * @param model - The nested model instance
+   */
+  for(model) {
+    const binderNode = getBinderNode(model);
+    if (binderNode.binder !== this.binder) {
+      throw new Error("Unknown binder");
+    }
+    return binderNode;
+  }
+  prependItem(item) {
+    if (this.#isArray()) {
+      const itemValueOrEmptyValue = item ?? this.model[_createEmptyItemValue]();
+      const newValue = [itemValueOrEmptyValue, ...this.value ?? []];
+      const newDefaultValue = [itemValueOrEmptyValue, ...this.defaultValue ?? []];
+      this.#setValueState(newValue, newDefaultValue);
+    } else {
+      throw new NotArrayModelError();
+    }
+  }
+  removeSelf() {
+    if (this.#isArrayItem()) {
+      const newValue = (this.parent.value ?? []).filter((_, i) => i !== this.model[_key]);
+      const newDefaultValue = (this.parent.defaultValue ?? []).filter((_, i) => i !== this.model[_key]);
+      this.parent.#setValueState(newValue, newDefaultValue);
+    } else {
+      throw new NotArrayItemModelError();
+    }
+  }
+  /**
+   * Runs all validation callbacks potentially affecting this
+   * or any nested model. Returns the combined array of all
+   * errors as in the errors property.
+   */
+  async validate() {
+    const errors = await Promise.all([
+      ...this.#requestValidationOfDescendants(),
+      ...this.#requestValidationWithAncestors()
+    ]).then((arr) => arr.flat());
+    this[_setErrorsWithDescendants](errors.length ? errors : void 0);
+    this[_update]();
+    return errors;
+  }
+  [_clearValidation]() {
+    if (this.#visited) {
+      this.#visited = false;
+      this.dispatchEvent(CHANGED);
+    }
+    let needsUpdate = false;
+    if (this.#ownErrors) {
+      this.#ownErrors = void 0;
+      needsUpdate = true;
+      this.dispatchEvent(CHANGED);
+    }
+    if ([...this.#getChildBinderNodes()].filter((childBinderNode) => childBinderNode[_clearValidation]()).length > 0) {
+      needsUpdate = true;
+    }
+    return needsUpdate;
+  }
+  [_setErrorsWithDescendants](errors) {
+    const { name } = this;
+    const ownErrors = errors ? errors.filter((valueError) => getErrorPropertyName(valueError) === name) : void 0;
+    const relatedErrors = errors ? errors.filter((valueError) => getErrorPropertyName(valueError).startsWith(name)) : void 0;
+    this.#ownErrors = ownErrors;
+    for (const childBinderNode of this.#getChildBinderNodes()) {
+      childBinderNode[_setErrorsWithDescendants](relatedErrors);
+    }
+    this.dispatchEvent(CHANGED);
+  }
+  [_update](_) {
+    if (this.parent) {
+      this.parent[_update]();
+    }
+  }
+  async [_updateValidation]() {
+    if (this.#visited) {
+      await this.validate();
+    } else if (this.dirty || this.invalid) {
+      await Promise.all(
+        [...this.#getChildBinderNodes()].map(async (childBinderNode) => childBinderNode[_updateValidation]())
+      );
+    }
+  }
+  *#getChildBinderNodes() {
+    if (this.value === void 0 || this.defaultValue === void 0) {
+      return;
+    }
+    if (this.#isObject()) {
+      for (const [, getter] of getObjectModelOwnAndParentGetters(this.model)) {
+        const childModel = getter.call(this.model);
+        if (childModel[_key] in this.defaultValue) {
+          yield getBinderNode(childModel);
+        }
+      }
+    } else if (this.#isArray()) {
+      for (const childBinderNode of this.model) {
+        yield childBinderNode;
+      }
+    }
+  }
+  #isArray() {
+    return this.model instanceof ArrayModel;
+  }
+  #isArrayItem() {
+    return this.model[_parent] instanceof ArrayModel;
+  }
+  #isObject() {
+    return this.model instanceof ObjectModel;
+  }
+  *#requestValidationOfDescendants() {
+    for (const node of this.#getChildBinderNodes()) {
+      yield* node.#runOwnValidators();
+      yield* node.#requestValidationOfDescendants();
+    }
+  }
+  *#requestValidationWithAncestors() {
+    yield* this.#runOwnValidators();
+    if (this.parent) {
+      yield* this.parent.#requestValidationWithAncestors();
+    }
+  }
+  *#runOwnValidators() {
+    const hasInvalidState = this[_validity] && !this[_validity].valid;
+    const hasBadInput = !!this[_validity]?.badInput;
+    if (hasInvalidState && !hasBadInput || !hasInvalidState) {
+      for (const validator of this.#validators) {
+        yield this.binder.requestValidation(this.model, validator);
+      }
+    }
+    if (hasInvalidState) {
+      yield this.binder.requestValidation(this.model, this.#validityStateValidator);
+    }
+  }
+  initializeValue(forceInitialize = false) {
+    if (this.parent && (this.parent.value === void 0 || this.parent.defaultValue === void 0)) {
+      this.parent.initializeValue(true);
+    }
+    const key = this.model[_key];
+    let value = this.parent ? this.parent.value[this.model[_key]] : void 0;
+    const defaultValue = this.parent ? this.parent.defaultValue[this.model[_key]] : void 0;
+    if (value === void 0) {
+      if (forceInitialize || !this.parent) {
+        value = this.model.constructor.createEmptyValue();
+        this.#setValueState(value, defaultValue === void 0 ? value : defaultValue);
+      } else if (this.parent.model instanceof ObjectModel && !(key in (this.parent.value || {}))) {
+        this.#setValueState(void 0, defaultValue === void 0 ? value : defaultValue);
+      }
+    }
+  }
+  #setValueState(value, defaultValue) {
+    const { parent } = this;
+    if (parent) {
+      const key = this.model[_key];
+      const parentValue = updateObjectOrArrayKey(parent.model, parent.value, key, value);
+      const keepPristine = value === defaultValue && parent.value === parent.defaultValue;
+      if (keepPristine) {
+        parent.#setValueState(parentValue, parentValue);
+      } else if (defaultValue !== void 0) {
+        const parentDefaultValue = updateObjectOrArrayKey(parent.model, parent.defaultValue, key, defaultValue);
+        parent.#setValueState(parentValue, parentDefaultValue);
+      } else {
+        parent.#setValueState(parentValue, void 0);
+      }
+    } else {
+      const binder = this;
+      if (defaultValue !== void 0) {
+        binder.defaultValue = defaultValue;
+      }
+      binder.value = value;
+    }
+  }
+}
+export {
+  BinderNode,
+  CHANGED,
+  _clearValidation,
+  _setErrorsWithDescendants,
+  _update,
+  _updateValidation,
+  getBinderNode
+};
+//# sourceMappingURL=BinderNode.js.map