/**
 * @license
 * Copyright (c) 2017 - 2026 Vaadin Ltd.
 * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
 */
import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js';
import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
import { TabsMixin, TabsOrientation } from './vaadin-tabs-mixin.js';

export { TabsOrientation };

/**
 * Fired when the `items` property changes.
 */
export type TabsItemsChangedEvent = CustomEvent<{ value: Element[] }>;

/**
 * Fired when the `selected` property changes.
 */
export type TabsSelectedChangedEvent = CustomEvent<{ value: number }>;

export interface TabsCustomEventMap {
  'items-changed': TabsItemsChangedEvent;

  'selected-changed': TabsSelectedChangedEvent;
}

export interface TabsEventMap extends HTMLElementEventMap, TabsCustomEventMap {}

/**
 * `<vaadin-tabs>` is a Web Component for organizing and grouping content into sections.
 *
 * ```html
 * <vaadin-tabs selected="4">
 *   <vaadin-tab>Page 1</vaadin-tab>
 *   <vaadin-tab>Page 2</vaadin-tab>
 *   <vaadin-tab>Page 3</vaadin-tab>
 *   <vaadin-tab>Page 4</vaadin-tab>
 * </vaadin-tabs>
 * ```
 *
 * ### Styling
 *
 * The following shadow DOM parts are available for styling:
 *
 * Part name         | Description
 * ------------------|--------------------------------------
 * `back-button`     | Button for moving the scroll back
 * `tabs`            | The tabs container
 * `forward-button`  | Button for moving the scroll forward
 *
 * The following state attributes are available for styling:
 *
 * Attribute      | Description
 * ---------------|--------------------------------------
 * `orientation`  | Tabs disposition, valid values are `horizontal` and `vertical`
 * `overflow`     | It's set to `start`, `end`, none or both.
 *
 * The following custom CSS properties are available for styling:
 *
 * Custom CSS property              |
 * :--------------------------------|
 * | `--vaadin-tabs-background`     |
 * | `--vaadin-tabs-border-color`   |
 * | `--vaadin-tabs-border-radius`  |
 * | `--vaadin-tabs-border-width`   |
 * | `--vaadin-tabs-font-size`      |
 * | `--vaadin-tabs-font-weight`    |
 * | `--vaadin-tabs-gap`            |
 * | `--vaadin-tabs-padding`        |
 *
 * See [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.
 *
 * @fires {CustomEvent} items-changed - Fired when the `items` property changes.
 * @fires {CustomEvent} selected-changed - Fired when the `selected` property changes.
 */
declare class Tabs extends TabsMixin(ElementMixin(ThemableMixin(HTMLElement))) {
  addEventListener<K extends keyof TabsEventMap>(
    type: K,
    listener: (this: Tabs, ev: TabsEventMap[K]) => void,
    options?: AddEventListenerOptions | boolean,
  ): void;

  removeEventListener<K extends keyof TabsEventMap>(
    type: K,
    listener: (this: Tabs, ev: TabsEventMap[K]) => void,
    options?: EventListenerOptions | boolean,
  ): void;
}

declare global {
  interface HTMLElementTagNameMap {
    'vaadin-tabs': Tabs;
  }
}

export { Tabs };
