/**
 * DO NOT EDIT
 *
 * This file was automatically generated by
 *   https://github.com/Polymer/tools/tree/master/packages/gen-typescript-declarations
 *
 * To modify these typings, edit the source file(s):
 *   iron-validatable-behavior.js
 */

import {IronMeta} from '@polymer/iron-meta/iron-meta.js';

export {IronValidatableBehavior};

/**
 * `Use IronValidatableBehavior` to implement an element that validates
 * user input. Use the related `IronValidatorBehavior` to add custom
 * validation logic to an iron-input.
 *
 * By default, an `<iron-form>` element validates its fields when the user
 * presses the submit button. To validate a form imperatively, call the form's
 * `validate()` method, which in turn will call `validate()` on all its
 * children. By using `IronValidatableBehavior`, your custom element
 * will get a public `validate()`, which will return the validity of the
 * element, and a corresponding `invalid` attribute, which can be used for
 * styling.
 *
 * To implement the custom validation logic of your element, you must override
 * the protected `_getValidity()` method of this behaviour, rather than
 * `validate()`. See
 * [this](https://github.com/PolymerElements/iron-form/blob/master/demo/simple-element.html)
 * for an example.
 *
 * ### Accessibility
 *
 * Changing the `invalid` property, either manually or by calling `validate()`
 * will update the `aria-invalid` attribute.
 */
interface IronValidatableBehavior {

  /**
   * Name of the validator to use.
   */
  validator: string|null|undefined;

  /**
   * True if the last call to `validate` is invalid.
   */
  invalid: boolean|null|undefined;

  /**
   *  Recompute this every time it's needed, because we don't know if the
   * underlying IronValidatableBehaviorMeta has changed.
   */
  readonly _validator: any;
  registered(): void;
  _invalidChanged(): void;

  /**
   * @returns True if the validator `validator` exists.
   */
  hasValidator(): boolean;

  /**
   * Returns true if the `value` is valid, and updates `invalid`. If you want
   * your element to have custom validation logic, do not override this method;
   * override `_getValidity(value)` instead.
   *
   * @param value Deprecated: The value to be validated. By default,
   * it is passed to the validator's `validate()` function, if a validator is
   *    set.
   * If this argument is not specified, then the element's `value` property
   * is used, if it exists.
   * @returns True if `value` is valid.
   */
  validate(value: object|null): boolean;
  _getValidity(value: any): any;
}

declare const IronValidatableBehavior: object;