@quartzds/core 1.0.0-beta.12 → 1.0.0-beta.121

package/dist/types/components/input/input.d.ts

@@ -1,8 +1,9 @@
 import type { ComponentInterface } from '../../stencil-public-runtime';
-import type { AutoCapitalize, EnterKeyHint, InputMode, SelectDirection, Value } from '../controls';
-export type InputAutoComplete = 'additional-name' | 'address-level1' | 'address-level2' | 'address-level3' | 'address-level4' | 'address-line1' | 'address-line2' | 'address-line3' | 'bday-day' | 'bday-month' | 'bday-year' | 'bday' | 'cc-additional-name' | 'cc-csc' | 'cc-exp-month' | 'cc-exp-year' | 'cc-exp' | 'cc-family-name' | 'cc-given-name' | 'cc-name' | 'cc-number' | 'cc-type' | 'country-name' | 'country' | 'current-password' | 'email' | 'family-name' | 'given-name' | 'honorific-prefix' | 'honorific-suffix' | 'impp' | 'language' | 'name' | 'new-password' | 'nickname' | 'off' | 'on' | 'one-time-code' | 'organization-title' | 'organization' | 'photo' | 'postal-code' | 'sex' | 'street-address' | 'tel-area-code' | 'tel-country-code' | 'tel-extension' | 'tel-local' | 'tel-national' | 'tel' | 'transaction-amount' | 'transaction-currency' | 'url' | 'username';
-export type InputType = 'color' | 'date' | 'datetime-local' | 'email' | 'month' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'time' | 'url' | 'week';
-export type InputSize = 'large' | 'small' | 'standard';
+import type { AutoComplete, EnterKeyHint, InputMode, Value } from '../controls';
+import type { Size, Status } from '../shared';
+export type Capture = '' | 'environment' | 'user';
+export type InputType = 'color' | 'date' | 'datetime-local' | 'email' | 'file' | 'month' | 'number' | 'password' | 'search' | 'tel' | 'text' | 'time' | 'url' | 'week';
+export type InputStatus = Exclude<Status, 'info'>;
 /**
  * The `<qds-input>` element is used to create interactive controls for
  * web-based forms in order to accept data from the user; a wide variety of
@@ -13,369 +14,441 @@ export type InputSize = 'large' | 'small' | 'standard';
  * @see https://quartz.se.com/build/components/input
  */
 export declare class Input implements ComponentInterface {
-  /**
-   * Defines if the input is in an invalid state. Validity is determined by
-   * attributes such as `type`, `pattern`, `min`, `max`, `required`, `step`,
-   * `minlength`, and `maxlength` using
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation).
-   */
-  invalid?: boolean;
-  /**
-   * The input's size.
-   *
-   * > **_NOTE:_** The native
-   * [`size` HTML attribute](https://developer.mozilla.org/docs/Web/HTML/Attributes/size)
-   * is not supported. CSS `width` should be used instead if this functionality
-   * is needed.
-   */
-  readonly size: InputSize;
-  /**
-   * Controls whether and how input is automatically capitalized as it is
-   * entered/edited by the user. Only valid for `search`, `tel`, and `text`
-   * inputs. Possible values:
-   *
-   * - `"off"` or `"none"`: No auto-capitalization is applied (all letters
-   * default to lowercase).
-   * - `"on"` or `"sentences"`: The first letter of each sentence defaults to a
-   * capital letter; all other letters default to lowercase.
-   * - `"words"`: The first letter of each word defaults to a capital letter;
-   * all other letters default to lowercase.
-   * - `"characters"`: All letters default to uppercase.
-   *
-   * @webnative
-   */
-  readonly autoCapitalize?: AutoCapitalize;
-  /**
-   * Indicates whether the value of the input can be automatically completed by
-   * the browser.
-   *
-   * @webnative
-   */
-  readonly autoComplete?: InputAutoComplete;
-  /**
-   * Specify whether the input should have focus when the page loads.
-   *
-   * @webnative
-   */
-  readonly autoFocus?: boolean;
-  /**
-   * Prevents the input from being interacted with: it cannot be pressed or
-   * focused.
-   *
-   * @webnative
-   */
-  disabled?: boolean;
-  /**
-   * What action label (or icon) to present for the enter key on virtual
-   * keyboards. Possible values:
-   *
-   * - `"done"`: Typically meaning there is nothing more to input and the input
-   * method editor (IME) will be closed.
-   * - `"enter"`:	Typically inserting a new line.
-   * - `"go"`: 	Typically meaning to take the user to the target of the text
-   * they typed.
-   * - `"next"`: 	Typically taking the user to the next field that will accept
-   * text.
-   * - `"previous"`: Typically taking the user to the previous field that will
-   * accept text.
-   * - `"search"`: Typically taking the user to the results of searching for
-   * the text they have typed.
-   * - `"send"`: Typically delivering the text to its target.
-   *
-   * @webnative
-   */
-  readonly enterkeyhint?: EnterKeyHint;
-  /**
-   * The [`<form>`](https://developer.mozilla.org/docs/Web/HTML/Element/form)
-   * element to associate the input with (its form owner).
-   *
-   * The value of this attribute must be the id of a `<form>` in the same
-   * document. If this attribute is not set, the `<qds-input>` is associated
-   * with its ancestor `<form>` element, if any.
-   *
-   * This attribute lets you associate `<qds-input>` elements to `<form>`s
-   * anywhere in the document, not just inside a `<form>`. It can also override
-   * an ancestor `<form>` element.
-   *
-   * @webnative
-   */
-  readonly form?: string;
-  /**
-   * Provide a hint to browsers as to the type of virtual keyboard
-   * configuration to use when editing this element or its contents.
-   *
-   * @webnative
-   */
-  readonly inputmode?: InputMode;
-  /**
-   * Defines the greatest value in the range of permitted values. If the
-   * `value` entered into the input exceeds this, the input fails
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation).
-   * Only valid for `date`, `datetime-local`, `month`, `time`, and `week`
-   * inputs.
-   *
-   * If this value isn't a valid number, then the input has no maximum value.
-   *
-   * @webnative
-   */
-  readonly max?: number | string;
-  /**
-   * The maximum number of characters (as UTF-16 code units) the user can enter
-   * into the input. This must be an non-negative integer value. If no
-   * `maxlength` is specified, or an invalid value is specified, the input has
-   * no maximum length. Only valid for `email`, `password`, `search`, `tel`,
-   * `text`, and `url` inputs.
-   *
-   * The input will fail
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation)
-   * if the length of the text entered into the field is greater than
-   * `maxlength` UTF-16 code units long. By default, browsers prevent users
-   * from entering more characters than allowed by the `maxlength` attribute. See
-   * [Client-side validation](https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation)
-   * for more information.
-   *
-   * @webnative
-   */
-  readonly maxLength?: number;
-  /**
-   * Defines the most negative value in the range of permitted values. If the
-   * `value` entered into the input is less than this, the input fails
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation).
-   * Only valid for `date`, `datetime-local`, `month`, `time`, and `week`
-   * inputs.
-   *
-   * This value must be less than or equal to the value of the `max` attribute.
-   * If this value isn't a valid number, then the input has no minimum value.
-   *
-   * @webnative
-   */
-  readonly min?: number | string;
-  /**
-   * The minimum number of characters (as UTF-16 code units) the user can enter
-   * into the input. This must be an non-negative integer value smaller than or
-   * equal to the value specified by `maxlength`. If no `minlength` is
-   * specified, or an invalid value is specified, the input has no minimum
-   * length. Only valid for `email`, `password`, `search`, `tel`, `text`, and
-   * `url` inputs.
-   *
-   * The input will fail
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation)
-   * if the length of the text entered into the field is fewer than `minlength`
-   * UTF-16 code units long, preventing form submission. See
-   * [Client-side validation](https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation)
-   * for more information.
-   *
-   * @webnative
-   */
-  readonly minLength?: number;
-  /**
-   * Specifies if multiple comma-separated email addresses can be entered. Only
-   * valid for `email` inputs.
-   *
-   * @webnative
-   */
-  readonly multiple?: boolean;
-  /**
-   * The name of the control, which is submitted with the form data. An
-   * incrementing input ID is used by default.
-   *
-   * @webnative
-   */
-  readonly name: string;
-  /**
-   * Defines a regular expression that the input's `value` must match in order
-   * for the value to pass
-   * [constraint validation](https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation).
-   * It must be a valid JavaScript regular expression, as used by the
-   * [`RegExp`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp)
-   * type, and as documented in MDN's
-   * [guide on regular expressions](https://developer.mozilla.org/docs/Web/JavaScript/Guide/Regular_Expressions);
-   * the `'u'` flag is specified when compiling the regular expression, so that
-   * the pattern is treated as a sequence of Unicode code points, instead of as
-   * ASCII. No forward slashes should be specified around the pattern text.
-   * Only valid for `email`, `password`, `search`, `tel`, `text`, and `url`
-   * inputs.
-   *
-   * If the `pattern` is invalid, no regular expression is applied and this
-   * property is ignored. If the pattern is valid and a non-empty value does
-   * not match the pattern, constraint validation will prevent form submission.
-   *
-   * @webnative
-   */
-  readonly pattern?: string;
-  /**
-   * Text that appears in the input when it has no value set. Only valid for
-   * `email`, `number`, `password`, `search`, `tel`, `text`, and `url` inputs.
-   *
-   * @webnative
-   */
-  readonly placeholder?: string;
-  /**
-   * The value of the input cannot be edited. Not valid for `color` inputs.
-   *
-   * @webnative
-   */
-  readonly readOnly?: boolean;
-  /**
-   * A value must be specified for the input before the owning form can be
-   * submitted. Not valid for `color` inputs.
-   *
-   * See
-   * [Client-side validation](https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation)
-   * and the
-   * [HTML attribute: `required`](https://developer.mozilla.org/docs/Web/HTML/Attributes/required)
-   * for more information.
-   *
-   * @webnative
-   */
-  readonly required?: boolean;
-  /**
-   * Defines whether the input may be checked for spelling errors.
-   *
-   * @webnative
-   */
-  readonly spellCheck?: boolean;
-  /**
-   * Specifies the granularity that the `value` must adhere to. Only valid for
-   * `date`, `datetime-local`, `month`, `number`, `time`, and `week` inputs.
-   *
-   * The value must be a positive number—integer or float—or the special value
-   * `any`, which means no stepping is implied, and any value is allowed
-   * (barring other constraints, such as `min` and `max`).
-   *
-   * If `any` is not explicitly set, valid values for the `number` are the
-   * basis for stepping — the `min` value and increments of the step value, up
-   * to the `max` value, if specified.
-   *
-   * @webnative
-   */
-  readonly step?: number | 'any';
-  /**
-   * The type of input to render:
-   *
-   * - `"date"`: An input for entering a date (year, month, and day, with no
-   * time). Opens a date picker or numeric wheels for year, month, day when
-   * active in supporting browsers.
-   * - `"datetime-local"`: An input for entering a date and time, with no time
-   * zone. Opens a date picker or numeric wheels for date and time components
-   * when active in supporting browsers.
-   * - `"email"`: An input for editing an email address. Looks like a `"text"`
-   * input, but has validation parameters and relevant keyboard in supporting
-   * browsers and devices with dynamic keyboards.
-   * - `"month"`: An input for entering a month and year, with no time zone.
-   * - `"number"`: An input for entering a number. Displays a spinner and adds
-   * default validation when supported. Displays a numeric keypad in some
-   * devices with dynamic keypads.
-   * - `"password"`: A single-line text input whose value is obscured. Will
-   * alert user if site is not secure.
-   * - `"search"`: A single-line text input for entering search strings.
-   * Line-breaks are automatically removed from the input value. May include a
-   * delete icon in supporting browsers that can be used to clear the input.
-   * Displays a search icon instead of enter key on some devices with dynamic
-   * keypads.
-   * - `"tel"`: An input for entering a telephone number. Displays a telephone
-   * keypad in some devices with dynamic keypads.
-   * - `"text"`: A single-line text input. Line-breaks are automatically
-   * removed from the input value.
-   * - `"time"`: An input for entering a time value with no time zone.
-   * - `"url"`: An input for entering a URL. Looks like a `"text"` input, but
-   * has validation parameters and relevant keyboard in supporting browsers and
-   * devices with dynamic keyboards.
-   * - `"week"`: An input for entering a date consisting of a week-year number
-   * and a week number with no time zone.
-   *
-   * @webnative
-   */
-  readonly type?: InputType;
-  /**
-   * The value of the input.
-   *
-   * @webnative
-   */
-  value?: Value;
-  /**
-   * Emitted when the input loses focus.
-   */
-  private readonly blurEmitter;
-  /**
-   * Emitted when an alteration to the input's value is committed by the user.
-   */
-  private readonly changeEmitter;
-  /**
-   * Emitted when the input gains focus.
-   */
-  private readonly focusEmitter;
-  /**
-   * Emitted when the input's value changes.
-   */
-  private readonly inputEmitter;
-  private readonly element;
-  private inheritedAttributes;
-  private input?;
-  private get computedDisabled();
-  /**
-   * Returns true if the element's value passes validity checks; otherwise,
-   * returns false, fires an invalid event at the element, and (if the event
-   * isn't canceled) reports the problem to the user.
-   */
-  reportValidity(): Promise<boolean>;
-  /**
-   * Selects the entire content of the `<qds-input>` element if the element's
-   * content is selectable.
-   */
-  select(): Promise<void>;
-  /**
-   * Sets a custom validity message for the input. If this message is not the
-   * empty string, then the element is considered invalid.
-   */
-  setCustomValidity(message: string): Promise<void>;
-  /**
-   * Sets the contents of the specified range of characters in the input element to a given string.
-   *
-   * @param replacement The string to insert.
-   * @param start The 0-based index of the first character to replace. Defaults to the current selectionStart value (the start of the user's current selection).
-   * @param end The 0-based index of the character _after_ the last character to replace. Defaults to the current selectionEnd value (the end of the user's current selection).
-   * @param selectionMode A string defining how the selection should be set after the text has been replaced. Possible values:
-   *
-   * - `"select"` selects the newly inserted text.
-   * - `"start"` moves the selection to just before the inserted text.
-   * - `"end"` moves the selection to just after the inserted text.
-   * - `"preserve"` attempts to preserve the selection.
-   */
-  setRangeText(replacement: string, start: number, end: number, selectionMode?: SelectionMode): Promise<void>;
-  /**
-   * Selects the specified range of characters within the input.
-   *
-   * @param start The offset into the input for the start of the selection.
-   * @param end The offset into the input for the end of the selection.
-   * @param direction The direction in which the selection is performed.
-   */
-  setSelectionRange(start: number | null, end: number | null, direction?: SelectDirection): Promise<void>;
-  /**
-   * Decrements the `value` by (`step` * n), where n defaults to 1 if not
-   * specified.
-   *
-   * @param n Amount to decrement the value by.
-   */
-  stepDown(n?: number): Promise<void>;
-  /**
-   * Increments the `value` by (`step` * n), where n defaults to 1 if not
-   * specified.
-   *
-   * @param n Amount to increment the value by.
-   */
-  stepUp(n?: number): Promise<void>;
-  protected disabledChanged(): void;
-  protected stepChanged(): void;
-  protected valueChanged(): void;
-  componentWillLoad(): void;
-  render(): any;
-  private readonly ref;
-  private readonly onBlur;
-  private readonly onChange;
-  private readonly onClick;
-  private readonly onFocus;
-  private readonly onInput;
-  private readonly onInvalid;
+    #private;
+    /**
+     * The input's status.
+     */
+    readonly status?: InputStatus;
+    /**
+     * Prevents the user from changing the value of the input.
+     *
+     * @webnative
+     */
+    readonly readonly?: boolean;
+    /**
+     * Shows a clear button that allows the user to clear the input's value.
+     *
+     * For `search` inputs, the clear button is always shown when the input
+     * has a value, regardless of this property.
+     *
+     */
+    readonly clearable?: boolean;
+    /**
+     * @deprecated The no-icon property is deprecated and will be removed by September 2026.
+     *
+     * Hide the input type's icon.
+     *
+     * > **_NOTE:_** Due to browser limitations, the icon may not be hidden in
+     * all browsers.
+     */
+    readonly noIcon?: boolean;
+    /**
+     * The input's size.
+     *
+     * > **_NOTE:_** The native [`size` HTML attribute][size] is not supported.
+     * CSS `width` should be used instead if this functionality is needed.
+     *
+     * [size]: https://developer.mozilla.org/docs/Web/HTML/Attributes/size
+     */
+    readonly size?: Size;
+    /**
+     * Defines the file types the `file` type input should accept. This is a
+     * comma-separated list of [unique file type specifiers][]. Because a given
+     * file type may be identified in more than one manner, it's useful to
+     * provide a thorough set of type specifiers when you files of a given format
+     * are needed.
+     *
+     * For instance, there are a number of ways Microsoft Word files can be
+     * identified, so a site that accepts Word files might use a `<qds-input>`
+     * like this:
+     *
+     * @example
+     * <qds-input
+     *   type="file"
+     *   accept=".doc,.docx,.xml,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+     * ></qds-input>
+     *
+     * [unique file type specifiers]: https://developer.mozilla.org/docs/Web/HTML/Element/input/file#unique_file_type_specifiers
+     *
+     * @webnative
+     */
+    readonly accept?: string;
+    /**
+     * Provides a hint for a [user agent's][] autocomplete feature. See
+     * [the HTML `autocomplete` attribute][autocomplete] for a complete list of
+     * values and details on how to use `autoComplete`.
+     *
+     * [user agent's]: https://developer.mozilla.org/docs/Glossary/User_agent
+     * [autocomplete]: https://developer.mozilla.org/docs/Web/HTML/Attributes/autocomplete
+     *
+     * @webnative
+     */
+    readonly autoComplete?: AutoComplete;
+    /**
+     * Specifies that a new file should be captured and which device should be
+     * used to capture that new media of the type defined by `accept`.
+     *
+     * Values include `user`, `environment`, and `''`:
+     *
+     * - `user`: The user-facing camera and/or microphone should be used.
+     * - `environment`: The outward-facing camera and/or microphone should be
+     * used.
+     * - `''`: The implementation-specific capture state.
+     *
+     * @webnative
+     */
+    readonly capture?: Capture;
+    /**
+     * Prevents the input from being interacted with: it cannot be pressed or
+     * focused.
+     *
+     * @webnative
+     */
+    readonly disabled?: boolean;
+    /**
+     * What action label (or icon) to present for the enter key on virtual
+     * keyboards. Possible values:
+     *
+     * - `"done"`: Typically meaning there is nothing more to input and the input
+     * method editor (IME) will be closed.
+     * - `"enter"`:	Typically inserting a new line.
+     * - `"go"`: 	Typically meaning to take the user to the target of the text
+     * they typed.
+     * - `"next"`: 	Typically taking the user to the next field that will accept
+     * text.
+     * - `"previous"`: Typically taking the user to the previous field that will
+     * accept text.
+     * - `"search"`: Typically taking the user to the results of searching for
+     * the text they have typed.
+     * - `"send"`: Typically delivering the text to its target.
+     *
+     * @webnative
+     */
+    readonly enterkeyhint?: EnterKeyHint;
+    /**
+     * Returns a file list for a `file` type input.
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly files: HTMLInputElement['files'];
+    /**
+     * The [`<form>`][] element to associate the input with (its form owner).
+     *
+     * The value of this attribute must be the id of a `<form>` in the same
+     * document. If this attribute is not set, the `<qds-input>` is associated
+     * with its ancestor `<form>` element, if any.
+     *
+     * This attribute lets you associate `<qds-input>` elements to `<form>`s
+     * anywhere in the document, not just inside a `<form>`. It can also override
+     * an ancestor `<form>` element.
+     *
+     * [`<form>`]: https://developer.mozilla.org/docs/Web/HTML/Element/form
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly form: ElementInternals['form'] | string;
+    /**
+     * Provide a hint to browsers as to the type of virtual keyboard
+     * configuration to use when editing this element or its contents.
+     *
+     * @webnative
+     */
+    readonly inputmode?: InputMode;
+    /**
+     * Returns a list of the [`<label>`][] elements associated with the
+     * `qds-input` element.
+     *
+     * [`<label>`]: https://developer.mozilla.org/docs/Web/HTML/Element/label
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly labels: ElementInternals['labels'];
+    /**
+     * Defines the greatest value in the range of permitted values. If the
+     * `value` entered into the input exceeds this, the input fails
+     * [constraint validation][]. Only valid for `date`, `datetime-local`,
+     * `month`, `time`, and `week` inputs.
+     *
+     * If this value isn't a valid number, then the input has no maximum value.
+     *
+     * [constraint validation]: https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation
+     *
+     * @webnative
+     */
+    readonly max?: number | string;
+    /**
+     * The maximum number of characters (as UTF-16 code units) the user can enter
+     * into the input. This must be an non-negative integer value. If no
+     * `maxlength` is specified, or an invalid value is specified, the input has
+     * no maximum length. Only valid for `email`, `password`, `search`, `tel`,
+     * `text`, and `url` inputs.
+     *
+     * The input will fail [constraint validation][] if the length of the text
+     * entered into the field is greater than `maxlength` UTF-16 code units long.
+     * By default, browsers prevent users from entering more characters than
+     * allowed by the `maxlength` attribute. See [Client-side validation][] for
+     * more information.
+     *
+     * [constraint validation]: https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation
+     * [Client-side validation]: https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation
+     *
+     * @webnative
+     */
+    readonly maxLength?: number;
+    /**
+     * Defines the most negative value in the range of permitted values. If the
+     * `value` entered into the input is less than this, the input fails
+     * [constraint validation][]. Only valid for `date`, `datetime-local`,
+     * `month`, `time`, and `week` inputs.
+     *
+     * This value must be less than or equal to the value of the `max` attribute.
+     * If this value isn't a valid number, then the input has no minimum value.
+     *
+     * [constraint validation]: https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation
+     *
+     * @webnative
+     */
+    readonly min?: number | string;
+    /**
+     * The minimum number of characters (as UTF-16 code units) the user can enter
+     * into the input. This must be an non-negative integer value smaller than or
+     * equal to the value specified by `maxlength`. If no `minlength` is
+     * specified, or an invalid value is specified, the input has no minimum
+     * length. Only valid for `email`, `password`, `search`, `tel`, `text`, and
+     * `url` inputs.
+     *
+     * The input will fail [constraint validation][] if the length of the text
+     * entered into the field is fewer than `minlength` UTF-16 code units long,
+     * preventing form submission. See [Client-side validation][] for more
+     * information.
+     *
+     * [constraint validation]: https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation
+     * [Client-side validation]: https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation
+     *
+     * @webnative
+     */
+    readonly minLength?: number;
+    /**
+     * For `email` inputs, specifies if multiple comma-separated email addresses
+     * can be entered. For `file` inputs, specifies if the user is allowed to
+     * select more than one file.
+     *
+     * Only valid for `email` or `file` inputs.
+     *
+     * @webnative
+     */
+    readonly multiple?: boolean;
+    /**
+     * The name of the input, which is submitted with the form data.
+     *
+     * @webnative
+     */
+    readonly name?: string;
+    /**
+     * Defines a regular expression that the input's `value` must match in order
+     * for the value to pass [constraint validation][]. It must be a valid
+     * JavaScript regular expression, as used by the [`RegExp`][] type, and as
+     * documented in MDN's [guide on regular expressions][]; the `'u'` flag is
+     * specified when compiling the regular expression, so that the pattern is
+     * treated as a sequence of Unicode code points, instead of as ASCII. No
+     * forward slashes should be specified around the pattern text. Only valid
+     * for `email`, `password`, `search`, `tel`, `text`, and `url` inputs.
+     *
+     * If the `pattern` is invalid, no regular expression is applied and this
+     * property is ignored. If the pattern is valid and a non-empty value does
+     * not match the pattern, constraint validation will prevent form submission.
+     *
+     * [constraint validation]: https://developer.mozilla.org/docs/Web/Guide/HTML/Constraint_validation
+     * [`RegExp`]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+     * [guide on regular expressions]: https://developer.mozilla.org/docs/Web/JavaScript/Guide/Regular_Expressions
+     *
+     * @webnative
+     */
+    readonly pattern?: string;
+    /**
+     * Text that appears in the input when it has no value set. Only valid for
+     * `email`, `number`, `password`, `search`, `tel`, `text`, and `url` inputs.
+     *
+     * @webnative
+     */
+    readonly placeholder?: string;
+    /**
+     * A value must be specified for the input before the owning form can be
+     * submitted. Not valid for `color` inputs.
+     *
+     * See [Client-side validation][] and the
+     * [HTML attribute: `required`][required] for more information.
+     *
+     * [Client-side validation]: https://developer.mozilla.org/docs/Web/HTML/Element/input#client-side_validation
+     * [required]: https://developer.mozilla.org/docs/Web/HTML/Attributes/required
+     *
+     * @webnative
+     */
+    readonly required?: boolean;
+    /**
+     * Get or set the selection direction of a text selection.
+     *
+     * > **_NOTE:_** This property has no effect when used as an attribute.
+     *
+     * @webnative
+     */
+    selectionDirection: HTMLInputElement['selectionDirection'];
+    /**
+     * Get or set the ending position or offset of a text selection.
+     *
+     * > **_NOTE:_** This property has no effect when used as an attribute.
+     *
+     * @webnative
+     */
+    selectionEnd: HTMLInputElement['selectionEnd'];
+    /**
+     * Get or set the starting position or offset of a text selection.
+     *
+     * > **_NOTE:_** This property has no effect when used as an attribute.
+     *
+     * @webnative
+     */
+    selectionStart: HTMLInputElement['selectionStart'];
+    /**
+     * Specifies the granularity that the `value` must adhere to. Only valid for
+     * `date`, `datetime-local`, `month`, `number`, `time`, and `week` inputs.
+     *
+     * The value must be a positive number—integer or float—or the special value
+     * `any`, which means no stepping is implied, and any value is allowed
+     * (barring other constraints, such as `min` and `max`).
+     *
+     * If `any` is not explicitly set, valid values for the `number` are the
+     * basis for stepping — the `min` value and increments of the step value, up
+     * to the `max` value, if specified.
+     *
+     * @webnative
+     */
+    readonly step?: number | 'any';
+    /**
+     * The type of input to render:
+     *
+     * - `"date"`: An input for entering a date (year, month, and day, with no
+     * time). Opens a date picker or numeric wheels for year, month, day when
+     * active in supporting browsers.
+     * - `"datetime-local"`: An input for entering a date and time, with no time
+     * zone. Opens a date picker or numeric wheels for date and time components
+     * when active in supporting browsers.
+     * - `"email"`: An input for editing an email address. Looks like a `"text"`
+     * input, but has validation parameters and relevant keyboard in supporting
+     * browsers and devices with dynamic keyboards.
+     * - `"month"`: An input for entering a month and year, with no time zone.
+     * - `"number"`: An input for entering a number. Displays a spinner and adds
+     * default validation when supported. Displays a numeric keypad in some
+     * devices with dynamic keypads.
+     * - `"password"`: A single-line text input whose value is obscured. Will
+     * alert user if site is not secure.
+     * - `"search"`: A single-line text input for entering search strings.
+     * Line-breaks are automatically removed from the input value. May include a
+     * delete icon in supporting browsers that can be used to clear the input.
+     * Displays a search icon instead of enter key on some devices with dynamic
+     * keypads.
+     * - `"tel"`: An input for entering a telephone number. Displays a telephone
+     * keypad in some devices with dynamic keypads.
+     * - `"text"`: A single-line text input. Line-breaks are automatically
+     * removed from the input value.
+     * - `"time"`: An input for entering a time value with no time zone.
+     * - `"url"`: An input for entering a URL. Looks like a `"text"` input, but
+     * has validation parameters and relevant keyboard in supporting browsers and
+     * devices with dynamic keyboards.
+     * - `"week"`: An input for entering a date consisting of a week-year number
+     * and a week number with no time zone.
+     *
+     * @webnative
+     */
+    readonly type?: InputType;
+    /**
+     * The error message that would be shown to the user if the `<qds-input>`
+     * was to be checked for validity.
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly validationMessage: ElementInternals['validationMessage'];
+    /**
+     * The [`ValidityState`][] object for this `<qds-input>`.
+     *
+     * [`ValidityState`]: https://developer.mozilla.org/docs/Web/API/ValidityState
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly validity: ElementInternals['validity'];
+    /**
+     * The value of the input.
+     *
+     * @webnative
+     */
+    value?: Value;
+    /**
+     * True if `<qds-input>` will be validated when the form is submitted; false
+     * otherwise.
+     *
+     * @readonly
+     * @webnative
+     */
+    readonly willValidate: ElementInternals['willValidate'];
+    private readonly internals;
+    /**
+     * Emitted when the input loses focus.
+     */
+    private readonly blurEmitter;
+    /**
+     * Emitted when the user cancels the file picker via the <kbd>Esc</kbd> key
+     * or the cancel button and when the user re-selects the same files that were
+     * previously selected.
+     */
+    private readonly cancelEmitter;
+    /** Emitted when the user performs a search (Enter, clear, or search button). */
+    private readonly searchEmitter;
+    /**
+     * Emitted when an alteration to the input's value is committed by the user.
+     */
+    private readonly changeEmitter;
+    /**
+     * Emitted when the input gains focus.
+     */
+    private readonly focusEmitter;
+    /**
+     * Emitted when the input's value changes.
+     */
+    private readonly inputEmitter;
+    private readonly host;
+    private tabIndex?;
+    private isPasswordVisible;
+    protected onClick(event: MouseEvent): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected ariaLabelChanged(newValue: string | null): void;
+    protected statusChanged(): void;
+    protected disabledChanged(): void;
+    protected selectionDirectionChanged(): void;
+    protected selectionEndChanged(): void;
+    protected selectionStartChanged(): void;
+    protected tabindexChanged(newValue: string): void;
+    protected validationChanged(): void;
+    protected valueChanged(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    render(): any;
+    checkValidity: ElementInternals['checkValidity'];
+    reportValidity: ElementInternals['reportValidity'];
+    setCustomValidity: HTMLInputElement['setCustomValidity'];
+    select: HTMLInputElement['select'];
+    getSelectionDirection: () => HTMLInputElement['selectionDirection'];
+    getSelectionStart: () => HTMLInputElement['selectionStart'];
+    getSelectionEnd: () => HTMLInputElement['selectionEnd'];
+    setRangeText: (replacement: string, start: number, end: number, selectionMode?: SelectionMode) => void;
+    setSelectionRange: HTMLInputElement['setSelectionRange'];
+    stepDown: HTMLInputElement['stepDown'];
+    stepUp: HTMLInputElement['stepUp'];
+    showPicker: HTMLInputElement['showPicker'];
 }
 //# sourceMappingURL=input.d.ts.map