@vaadin/hilla-lit-form 24.7.0-alpha9 → 24.7.0-beta3

package/Binder.d.ts

@@ -1,28 +1,7 @@
 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.js

@@ -1,29 +1,22 @@
-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;
-  }
+import { BinderRoot } from './BinderRoot.js';
+export class Binder extends BinderRoot {
+    constructor(context, Model, config) {
+        const changeCallback = config?.onChange ??
+            (typeof context.requestUpdate === 'function'
+                ? () => context.requestUpdate()
+                : undefined);
+        super(Model, {
+            ...(config ?? {}),
+            onChange: changeCallback,
+            context,
+        });
+        Object.defineProperty(this, "context", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.context = context;
+    }
 }
-export {
-  Binder
-};
-//# sourceMappingURL=Binder.js.map
+//# sourceMappingURL=Binder.js.map

package/Binder.js.map

@@ -1,7 +1 @@
-{
-  "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": []
-}
+{"version":3,"file":"Binder.js","sourceRoot":"","sources":["src/Binder.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWvE,MAAM,OAAO,MAAgC,SAAQ,UAAa;IAiBhE,YAAY,OAAgB,EAAE,KAAkC,EAAE,MAAsC;QACtG,MAAM,cAAc,GAClB,MAAM,EAAE,QAAQ;YAChB,CAAC,OAAQ,OAAsB,CAAC,aAAa,KAAK,UAAU;gBAC1D,CAAC,CAAC,GAAG,EAAE,CAAE,OAAsB,CAAC,aAAa,EAAE;gBAC/C,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjB,KAAK,CAAC,KAAK,EAAE;YACX,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;YACjB,QAAQ,EAAE,cAAc;YACxB,OAAO;SACR,CAAC,CAAC;QAzBL;;;;;WAAiB;QA0Bf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF","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"]}

package/BinderNode.d.ts

@@ -9,110 +9,32 @@ 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;
@@ -120,4 +42,3 @@ export declare class BinderNode<M extends AbstractModel = AbstractModel> extends
     protected [_updateValidation](): Promise<void>;
     initializeValue(forceInitialize?: boolean): void;
 }
-//# sourceMappingURL=BinderNode.d.ts.map