@xlabs-store/core 0.0.1

package/dist/collection/components/x-tabs/x-tabs.js

@@ -0,0 +1,1264 @@
+import { Host, h } from "@stencil/core";
+/**
+ * @component x-tabs
+ * @description Tabs make it easy to explore and switch between different views.
+ *
+ * @slot - x-tab-pane children components
+ *
+ * @example
+ * <x-tabs active-key="1">
+ *   <x-tab-pane key="1" tab="Tab 1">Content of Tab 1</x-tab-pane>
+ *   <x-tab-pane key="2" tab="Tab 2">Content of Tab 2</x-tab-pane>
+ *   <x-tab-pane key="3" tab="Tab 3">Content of Tab 3</x-tab-pane>
+ * </x-tabs>
+ */
+export class XTabs {
+    /**
+     * Host element reference for reading child panes.
+     */
+    el;
+    /**
+     * Nav list element reference for ink bar positioning.
+     */
+    navListEl;
+    /**
+     * Flag to prevent recursive updates.
+     */
+    isUpdatingTabs = false;
+    // ==================== Props ====================
+    /**
+     * Current active tab key (controlled mode).
+     * @example
+     * <x-tabs active-key="profile"></x-tabs>
+     */
+    activeKey;
+    /**
+     * Initial active tab key (uncontrolled mode).
+     * @example
+     * <x-tabs defaultActiveKey="settings"></x-tabs>
+     */
+    defaultActiveKey;
+    /**
+     * Position/placement of tabs.
+     * @default 'top'
+     * @example
+     * <x-tabs tabPlacement="bottom"></x-tabs>
+     */
+    tabPlacement = 'top';
+    /**
+     * Type/style of tabs.
+     * @default 'line'
+     * @example
+     * <x-tabs type="card"></x-tabs>
+     */
+    type = 'line';
+    /**
+     * Size of tabs.
+     * @default 'middle'
+     * @example
+     * <x-tabs size="small"></x-tabs>
+     */
+    size = 'middle';
+    /**
+     * Whether to center tabs.
+     * @default false
+     * @example
+     * <x-tabs centered></x-tabs>
+     */
+    centered = false;
+    /**
+     * Tab items configuration (alternative to slots).
+     * @example
+     * <x-tabs items={[{ key: '1', label: 'Tab' }]}></x-tabs>
+     */
+    items;
+    /**
+     * Indicator configuration.
+     * @example
+     * <x-tabs indicator={{ size: 20, align: 'center' }}></x-tabs>
+     */
+    indicator;
+    /**
+     * Whether tabs are animated.
+     * @default true
+     * @example
+     * <x-tabs animated={false}></x-tabs>
+     */
+    animated = true;
+    /**
+     * Gap between tabs.
+     * @example
+     * <x-tabs tabBarGutter={12}></x-tabs>
+     */
+    tabBarGutter;
+    /**
+     * Tab bar style object.
+     * @example
+     * <x-tabs tabBarStyle={{ background: '#fff' }}></x-tabs>
+     */
+    tabBarStyle;
+    /**
+     * Extra content in tab bar (left/right).
+     * @example
+     * <x-tabs tabBarExtraContent="Extra"></x-tabs>
+     */
+    tabBarExtraContent;
+    /**
+     * Customize add icon, only works with type="editable-card".
+     * @example
+     * <x-tabs type="editable-card" addIcon="plus"></x-tabs>
+     */
+    addIcon;
+    /**
+     * Customize remove icon, only works with type="editable-card".
+     * @example
+     * <x-tabs type="editable-card" removeIcon="close"></x-tabs>
+     */
+    removeIcon;
+    /**
+     * Whether to hide add button (only for editable-card).
+     * @default false
+     * @example
+     * <x-tabs type="editable-card" hideAdd></x-tabs>
+     */
+    hideAdd = false;
+    /**
+     * Whether to destroy inactive tab panes.
+     * @default false
+     * @example
+     * <x-tabs destroyInactiveTabPane></x-tabs>
+     */
+    destroyInactiveTabPane = false;
+    /**
+     * Custom class names for parts.
+     * @example
+     * <x-tabs classNames={{ root: 'my-tabs' }}></x-tabs>
+     */
+    classNames;
+    /**
+     * Custom styles for parts.
+     * @example
+     * <x-tabs styles={{ header: { background: '#fff' } }}></x-tabs>
+     */
+    styles;
+    // ==================== Events ====================
+    /**
+     * Callback when active tab changes.
+     * @example
+     * <x-tabs onXChange={(ev) => console.log(ev.detail)}></x-tabs>
+     */
+    xChange;
+    /**
+     * Callback when tab is clicked.
+     * @example
+     * <x-tabs onXTabClick={(ev) => console.log(ev.detail)}></x-tabs>
+     */
+    xTabClick;
+    /**
+     * Callback when tab is added or removed (only for editable-card).
+     * @example
+     * <x-tabs onXEdit={(ev) => console.log(ev.detail)} type="editable-card"></x-tabs>
+     */
+    xEdit;
+    /**
+     * Callback when tab scroll.
+     * @example
+     * <x-tabs onXTabScroll={(ev) => console.log(ev.detail)}></x-tabs>
+     */
+    xTabScroll;
+    // ==================== State ====================
+    /**
+     * Internal tab metadata list.
+     */
+    tabs = [];
+    /**
+     * Ink bar inline style.
+     */
+    inkBarStyle = {};
+    // ==================== Lifecycle ====================
+    componentWillLoad() {
+        if (!this.activeKey && this.defaultActiveKey) {
+            this.activeKey = this.defaultActiveKey;
+        }
+    }
+    componentDidLoad() {
+        this.updateTabs();
+        this.updateInkBar();
+    }
+    componentDidUpdate() {
+        this.updateInkBar();
+    }
+    // ==================== Watchers ====================
+    handleActiveKeyChange(newValue) {
+        this.updateChildren(newValue);
+        this.updateInkBar();
+    }
+    handleItemsChange() {
+        this.updateTabs();
+    }
+    // ==================== Methods ====================
+    /**
+     * Get current active key.
+     * @returns Promise<string | undefined>
+     * @example
+     * const key = await el.getActiveKey()
+     */
+    async getActiveKey() {
+        return this.activeKey;
+    }
+    /**
+     * Set active tab by key.
+     * @param key - Tab key to activate.
+     * @returns Promise<void>
+     * @example
+     * await el.setActiveKey('profile')
+     */
+    async setActiveKey(key) {
+        const previousKey = this.activeKey;
+        this.activeKey = key;
+        this.xChange.emit({ activeKey: key, previousKey });
+    }
+    // ==================== Private Methods ====================
+    /**
+     * Synchronizes internal tab state from `items` prop or slotted `x-tab-pane` children.
+     *
+     * Flow:
+     * 1. Checks `isUpdatingTabs` flag to prevent recursive updates.
+     * 2. If `items` prop is present:
+     *    - Maps items to internal tab objects.
+     * 3. If `items` prop is missing:
+     *    - Queries for `x-tab-pane` elements in the light DOM.
+     *    - Extracts attributes (key, tab, disabled, closable, etc.) from panes.
+     * 4. Compares new tabs with current `tabs` state.
+     * 5. Updates `tabs` state if changed.
+     * 6. Sets initial `activeKey` if not set.
+     * 7. Calls `updateChildren` to sync active state to panes.
+     */
+    updateTabs() {
+        // Prevent infinite loop
+        if (this.isUpdatingTabs)
+            return;
+        this.isUpdatingTabs = true;
+        try {
+            let newTabs = [];
+            if (this.items && this.items.length > 0) {
+                newTabs = this.items.map(item => ({
+                    key: item.key,
+                    label: item.label,
+                    disabled: !!item.disabled,
+                    closable: item.closable !== false,
+                    icon: item.icon,
+                    forceRender: item.forceRender,
+                }));
+            }
+            else {
+                // Query slotted children from light DOM
+                const tabPanes = Array.from(this.el.children).filter((child) => child.tagName.toLowerCase() === 'x-tab-pane');
+                newTabs = tabPanes.map((pane) => ({
+                    key: pane.tabKey || pane.getAttribute('tab-key') || pane.getAttribute('key') || '',
+                    label: pane.tab || pane.getAttribute('tab') || '',
+                    disabled: pane.disabled || pane.hasAttribute('disabled'),
+                    closable: pane.closable !== false && pane.getAttribute('closable') !== 'false',
+                    icon: pane.icon || pane.getAttribute('icon') || undefined,
+                    forceRender: pane.forceRender || pane.hasAttribute('force-render'),
+                }));
+            }
+            // Only update if tabs changed
+            const tabsChanged = JSON.stringify(newTabs) !== JSON.stringify(this.tabs);
+            if (tabsChanged) {
+                this.tabs = newTabs;
+            }
+            if (!this.activeKey && this.tabs.length > 0) {
+                this.activeKey = this.tabs[0].key;
+            }
+            this.updateChildren(this.activeKey);
+        }
+        finally {
+            this.isUpdatingTabs = false;
+        }
+    }
+    /**
+     * Updates the active state of child `x-tab-pane` elements.
+     *
+     * Flow:
+     * 1. Finds all `x-tab-pane` children.
+     * 2. Iterates through each pane.
+     * 3. Compares pane's key with `activeKey`.
+     * 4. Sets the pane's `active` property.
+     * 5. Sets the pane's `destroyInactiveTabPane` property based on parent config.
+     *
+     * @param activeKey - The key of the currently active tab.
+     */
+    updateChildren(activeKey) {
+        const tabPanes = Array.from(this.el.children).filter((child) => child.tagName.toLowerCase() === 'x-tab-pane');
+        tabPanes.forEach((pane) => {
+            const key = pane.getAttribute('key') || pane.getAttribute('tab-key') || pane.tabKey;
+            const isActive = key === activeKey;
+            if (pane.active !== isActive) {
+                pane.active = isActive;
+            }
+            if (this.destroyInactiveTabPane && !pane.destroyInactiveTabPane) {
+                pane.destroyInactiveTabPane = true;
+            }
+        });
+    }
+    /**
+     * Updates the position and size of the ink bar (active indicator).
+     *
+     * Flow:
+     * 1. Checks if type is 'line' and nav list exists.
+     * 2. Finds the currently active tab element in the nav list.
+     * 3. If no active tab, hides the ink bar.
+     * 4. Calculates position (top/left) and size (height/width) based on:
+     *    - Tab placement (vertical vs horizontal).
+     *    - Active tab's offset and dimensions.
+     *    - Custom indicator size and alignment configuration.
+     * 5. Updates `inkBarStyle` state if changed.
+     */
+    updateInkBar() {
+        if (this.type !== 'line' || !this.navListEl)
+            return;
+        const activeTab = this.navListEl.querySelector('.x-tabs-tab-active');
+        if (!activeTab) {
+            if (Object.keys(this.inkBarStyle).length > 0) {
+                this.inkBarStyle = {};
+            }
+            return;
+        }
+        const isVertical = this.tabPlacement === 'start' || this.tabPlacement === 'end';
+        let newStyle = {};
+        if (isVertical) {
+            newStyle = {
+                top: `${activeTab.offsetTop}px`,
+                height: `${activeTab.offsetHeight}px`,
+            };
+        }
+        else {
+            let width = activeTab.offsetWidth;
+            let left = activeTab.offsetLeft;
+            if (this.indicator?.size !== undefined) {
+                width = typeof this.indicator.size === 'number' ? this.indicator.size : width;
+            }
+            if (this.indicator?.align) {
+                const diff = activeTab.offsetWidth - width;
+                if (this.indicator.align === 'center') {
+                    left += diff / 2;
+                }
+                else if (this.indicator.align === 'end') {
+                    left += diff;
+                }
+            }
+            newStyle = {
+                left: `${left}px`,
+                width: `${width}px`,
+            };
+        }
+        // Only update if style changed
+        const styleChanged = JSON.stringify(newStyle) !== JSON.stringify(this.inkBarStyle);
+        if (styleChanged) {
+            this.inkBarStyle = newStyle;
+        }
+    }
+    /**
+     * Handle click on a tab item.
+     *
+     * Flow:
+     * 1. Checks if the tab is disabled; if so, returns early.
+     * 2. Emits `xTabClick` event with the clicked key and native event.
+     * 3. If the clicked tab is not currently active:
+     *    - Updates `activeKey` to the new key.
+     *    - Emits `xChange` event to notify parent of the switch.
+     *
+     * @param key - Tab key.
+     * @param disabled - Whether tab is disabled.
+     * @param e - Mouse event.
+     * @returns void
+     */
+    handleTabClick = (key, disabled, e) => {
+        if (disabled)
+            return;
+        this.xTabClick.emit({ key, nativeEvent: e });
+        if (this.activeKey !== key) {
+            const previousKey = this.activeKey;
+            this.activeKey = key;
+            this.xChange.emit({ activeKey: key, previousKey });
+        }
+    };
+    /**
+     * Emit add action for editable-card tabs.
+     * @param e - Mouse event.
+     * @returns void
+     */
+    handleAddClick = (e) => {
+        e.stopPropagation();
+        this.xEdit.emit({ targetKey: '', action: 'add' });
+    };
+    /**
+     * Emit remove action for editable-card tabs.
+     * @param key - Target tab key.
+     * @param e - Mouse event.
+     * @returns void
+     */
+    handleRemoveClick = (key, e) => {
+        e.stopPropagation();
+        this.xEdit.emit({ targetKey: key, action: 'remove' });
+    };
+    /**
+     * Compute gutter style based on orientation.
+     * @returns Record<string, string>
+     */
+    getTabBarGutterStyle() {
+        if (this.tabBarGutter === undefined)
+            return {};
+        const isVertical = this.tabPlacement === 'start' || this.tabPlacement === 'end';
+        if (isVertical) {
+            return { marginBottom: `${this.tabBarGutter}px` };
+        }
+        return { marginRight: `${this.tabBarGutter}px` };
+    }
+    /**
+     * Determine whether ink bar should animate.
+     * @returns boolean
+     */
+    isInkBarAnimated() {
+        if (typeof this.animated === 'boolean') {
+            return this.animated;
+        }
+        return this.animated?.inkBar !== false;
+    }
+    /**
+     * Render remove icon for editable-card tabs.
+     * @returns JSX.Element
+     */
+    renderRemoveIcon() {
+        if (this.removeIcon) {
+            return h("x-icon", { name: this.removeIcon });
+        }
+        // Default close icon (CloseOutlined)
+        return (h("svg", { viewBox: "64 64 896 896", width: "1em", height: "1em", fill: "currentColor" }, h("path", { d: "M563.8 512l262.5-312.9c4.4-5.2.7-13.1-6.1-13.1h-79.8c-4.7 0-9.2 2.1-12.3 5.7L511.6 449.8 295.1 191.7c-3-3.6-7.5-5.7-12.3-5.7H203c-6.8 0-10.5 7.9-6.1 13.1L459.4 512 196.9 824.9A7.95 7.95 0 00203 838h79.8c4.7 0 9.2-2.1 12.3-5.7l216.5-258.1 216.5 258.1c3 3.6 7.5 5.7 12.3 5.7h79.8c6.8 0 10.5-7.9 6.1-13.1L563.8 512z" })));
+    }
+    /**
+     * Render add icon for editable-card tabs.
+     * @returns JSX.Element
+     */
+    renderAddIcon() {
+        if (this.addIcon) {
+            return h("x-icon", { name: this.addIcon });
+        }
+        // Default plus icon (PlusOutlined)
+        return (h("svg", { viewBox: "64 64 896 896", width: "1em", height: "1em", fill: "currentColor" }, h("path", { d: "M482 152h60q8 0 8 8v704q0 8-8 8h-60q-8 0-8-8V160q0-8 8-8z" }), h("path", { d: "M176 474h672q8 0 8 8v60q0 8-8 8H176q-8 0-8-8v-60q0-8 8-8z" })));
+    }
+    /**
+     * Render extra content in tab bar.
+     * @param position - 'left' or 'right' side.
+     * @returns JSX.Element | null
+     */
+    renderExtraContent(position) {
+        if (!this.tabBarExtraContent)
+            return null;
+        if (typeof this.tabBarExtraContent === 'string') {
+            // String means right position by default
+            if (position === 'right') {
+                return h("div", { class: "x-tabs-extra-content" }, this.tabBarExtraContent);
+            }
+            return null;
+        }
+        const content = this.tabBarExtraContent[position];
+        if (!content)
+            return null;
+        return h("div", { class: `x-tabs-extra-content x-tabs-extra-content-${position}` }, content);
+    }
+    // ==================== Render ====================
+    /**
+     * Renders the tab buttons in the navigation bar.
+     *
+     * Flow:
+     * 1. Iterates through the `tabs` state.
+     * 2. For each tab:
+     *    - Determines active and disabled state.
+     *    - Applies styling classes and gutter styles.
+     *    - Sets ARIA attributes for accessibility.
+     *    - Renders icon (if present) and label.
+     *    - If type is 'editable-card' and tab is closable, renders a remove button.
+     *
+     * @returns JSX.Element[] - Array of tab button elements.
+     */
+    renderTabs() {
+        const gutterStyle = this.getTabBarGutterStyle();
+        return this.tabs.map((tab) => (h("div", { "data-key": tab.key, class: {
+                'x-tabs-tab': true,
+                'x-tabs-tab-active': this.activeKey === tab.key,
+                'x-tabs-tab-disabled': tab.disabled,
+                [this.classNames?.item ?? '']: !!this.classNames?.item,
+            }, style: { ...gutterStyle, ...this.styles?.item }, onClick: (e) => this.handleTabClick(tab.key, tab.disabled, e), role: "tab", "aria-selected": this.activeKey === tab.key ? 'true' : 'false', "aria-disabled": tab.disabled ? 'true' : 'false', tabindex: tab.disabled ? -1 : 0 }, h("div", { class: "x-tabs-tab-btn" }, tab.icon && h("x-icon", { name: tab.icon, class: "x-tabs-tab-icon" }), h("span", { class: "x-tabs-tab-label" }, tab.label)), this.type === 'editable-card' && tab.closable && (h("button", { type: "button", class: {
+                'x-tabs-tab-remove': true,
+                [this.classNames?.remove ?? '']: !!this.classNames?.remove,
+            }, style: this.styles?.remove, onClick: (e) => this.handleRemoveClick(tab.key, e), "aria-label": "Remove tab" }, this.renderRemoveIcon())))));
+    }
+    /**
+     * Render add button for editable-card tabs.
+     * @returns JSX.Element | null
+     */
+    renderAddButton() {
+        if (this.type !== 'editable-card' || this.hideAdd)
+            return null;
+        return (h("button", { type: "button", class: {
+                'x-tabs-nav-add': true,
+                [this.classNames?.add ?? '']: !!this.classNames?.add,
+            }, style: this.styles?.add, onClick: this.handleAddClick, "aria-label": "Add tab" }, this.renderAddIcon()));
+    }
+    /**
+     * Handle slot changes by updating tabs.
+     * @returns void
+     */
+    handleSlotChange = () => {
+        // Use requestAnimationFrame to debounce and prevent synchronous state updates
+        requestAnimationFrame(() => {
+            this.updateTabs();
+        });
+    };
+    /**
+     * Renders the content panels for the tabs.
+     *
+     * Flow:
+     * 1. If using `items` prop:
+     *    - Iterates through items.
+     *    - Checks if item is active.
+     *    - Implements lazy rendering logic:
+     *      - If not active and `destroyInactiveTabPane` is true (and not forced), renders null.
+     *    - Renders the content wrapper with display style (block/none).
+     * 2. If using slots:
+     *    - Renders a slot element with a change listener to detect pane updates.
+     *
+     * @returns JSX.Element | JSX.Element[]
+     */
+    renderContent() {
+        // If using items prop, render content programmatically
+        if (this.items && this.items.length > 0) {
+            return this.items.map(item => {
+                const isActive = item.key === this.activeKey;
+                // Logic: if not active and destroyInactiveTabPane is true, don't render.
+                // Unless forceRender is true.
+                if (!isActive && !item.forceRender && this.destroyInactiveTabPane) {
+                    return null;
+                }
+                return (h("div", { class: {
+                        'x-tabs-tabpane': true,
+                        'x-tabs-tabpane-active': isActive
+                    }, key: item.key, role: "tabpanel", "aria-hidden": !isActive ? 'true' : 'false', style: { display: isActive ? 'block' : 'none' } }, item.children));
+            });
+        }
+        // Fallback to slot projection
+        return h("slot", { onSlotchange: this.handleSlotChange });
+    }
+    /**
+     * Main render method for the Tabs component.
+     *
+     * Flow:
+     * 1. Determines layout orientation (vertical vs horizontal) based on `tabPlacement`.
+     * 2. Constructs host classes based on props (type, size, placement, centered).
+     * 3. Renders the Navigation section (`x-tabs-nav`):
+     *    - Renders extra content (left side).
+     *    - Renders the nav wrapper and list (`x-tabs-nav-list`).
+     *    - Calls `renderTabs` to generate individual tab buttons.
+     *    - Calls `renderAddButton` if editable.
+     *    - Renders the ink bar (active indicator) if type is 'line'.
+     *    - Renders extra content (right side).
+     * 4. Renders the Content section (`x-tabs-content-holder`):
+     *    - Calls `renderContent` to generate or project tab panels.
+     *
+     * @returns {JSX.Element} The full component tree.
+     */
+    render() {
+        const isVertical = this.tabPlacement === 'start' || this.tabPlacement === 'end';
+        const classes = {
+            'x-tabs': true,
+            [`x-tabs-${this.tabPlacement}`]: true,
+            [`x-tabs-${this.type}`]: true,
+            [`x-tabs-${this.size}`]: this.size !== 'middle',
+            'x-tabs-centered': this.centered,
+            'x-tabs-vertical': isVertical,
+            [this.classNames?.root ?? '']: !!this.classNames?.root,
+        };
+        const navStyle = {
+            ...this.tabBarStyle,
+            ...this.styles?.header,
+        };
+        return (h(Host, { key: '75b714ece12fb1a6f975efdc28fb39ec0dfc206a', class: classes, style: this.styles?.root }, h("div", { key: '333885c06f2da2589fcb55c98367ea5364a615a5', class: {
+                'x-tabs-nav': true,
+                [this.classNames?.header ?? '']: !!this.classNames?.header,
+            }, style: navStyle, role: "tablist" }, this.renderExtraContent('left'), h("div", { key: '982e919f467ebf5f170378cbbe7539d50234e66c', class: {
+                'x-tabs-nav-wrap': true,
+                [this.classNames?.nav ?? '']: !!this.classNames?.nav,
+            }, style: this.styles?.nav }, h("div", { key: '03d3159c78338984bb822c2d26a28b7bcd4413f5', class: "x-tabs-nav-list", ref: (el) => (this.navListEl = el) }, this.renderTabs(), this.renderAddButton(), this.type === 'line' && (h("div", { key: '7fa84f3fa0f53299e83c9c28c54344f7883bb284', class: {
+                'x-tabs-ink-bar': true,
+                'x-tabs-ink-bar-animated': this.isInkBarAnimated(),
+                [this.classNames?.indicator ?? '']: !!this.classNames?.indicator,
+            }, style: { ...this.inkBarStyle, ...this.styles?.indicator } })))), this.renderExtraContent('right')), h("div", { key: '362ef70990f92f33d63398cc2eca2019a03f605d', class: {
+                'x-tabs-content-holder': true,
+                [this.classNames?.content ?? '']: !!this.classNames?.content,
+            }, style: this.styles?.content }, h("div", { key: 'f930efcfc080942790e636f826cb293f72d23b7c', class: "x-tabs-content" }, this.renderContent()))));
+    }
+    static get is() { return "x-tabs"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["x-tabs.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["x-tabs.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "activeKey": {
+                "type": "string",
+                "mutable": true,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs active-key=\"profile\"></x-tabs>"
+                        }],
+                    "text": "Current active tab key (controlled mode)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "active-key"
+            },
+            "defaultActiveKey": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs defaultActiveKey=\"settings\"></x-tabs>"
+                        }],
+                    "text": "Initial active tab key (uncontrolled mode)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "default-active-key"
+            },
+            "tabPlacement": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsPlacement",
+                    "resolved": "\"bottom\" | \"end\" | \"start\" | \"top\"",
+                    "references": {
+                        "TabsPlacement": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsPlacement",
+                            "referenceLocation": "TabsPlacement"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "'top'"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs tabPlacement=\"bottom\"></x-tabs>"
+                        }],
+                    "text": "Position/placement of tabs."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "tab-placement",
+                "defaultValue": "'top'"
+            },
+            "type": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsType",
+                    "resolved": "\"card\" | \"editable-card\" | \"line\"",
+                    "references": {
+                        "TabsType": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsType",
+                            "referenceLocation": "TabsType"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "'line'"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs type=\"card\"></x-tabs>"
+                        }],
+                    "text": "Type/style of tabs."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "type",
+                "defaultValue": "'line'"
+            },
+            "size": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsSize",
+                    "resolved": "\"large\" | \"middle\" | \"small\"",
+                    "references": {
+                        "TabsSize": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsSize",
+                            "referenceLocation": "TabsSize"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "'middle'"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs size=\"small\"></x-tabs>"
+                        }],
+                    "text": "Size of tabs."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "size",
+                "defaultValue": "'middle'"
+            },
+            "centered": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs centered></x-tabs>"
+                        }],
+                    "text": "Whether to center tabs."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "centered",
+                "defaultValue": "false"
+            },
+            "items": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabItem[]",
+                    "resolved": "TabItem[]",
+                    "references": {
+                        "TabItem": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabItem",
+                            "referenceLocation": "TabItem"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs items={[{ key: '1', label: 'Tab' }]}></x-tabs>"
+                        }],
+                    "text": "Tab items configuration (alternative to slots)."
+                },
+                "getter": false,
+                "setter": false
+            },
+            "indicator": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsIndicator",
+                    "resolved": "TabsIndicator",
+                    "references": {
+                        "TabsIndicator": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsIndicator",
+                            "referenceLocation": "TabsIndicator"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs indicator={{ size: 20, align: 'center' }}></x-tabs>"
+                        }],
+                    "text": "Indicator configuration."
+                },
+                "getter": false,
+                "setter": false
+            },
+            "animated": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean | { inkBar?: boolean; tabPane?: boolean }",
+                    "resolved": "boolean | { inkBar?: boolean; tabPane?: boolean; }",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "true"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs animated={false}></x-tabs>"
+                        }],
+                    "text": "Whether tabs are animated."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "animated",
+                "defaultValue": "true"
+            },
+            "tabBarGutter": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs tabBarGutter={12}></x-tabs>"
+                        }],
+                    "text": "Gap between tabs."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "tab-bar-gutter"
+            },
+            "tabBarStyle": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "{ [key: string]: string }",
+                    "resolved": "{ [key: string]: string; }",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs tabBarStyle={{ background: '#fff' }}></x-tabs>"
+                        }],
+                    "text": "Tab bar style object."
+                },
+                "getter": false,
+                "setter": false
+            },
+            "tabBarExtraContent": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | TabBarExtraContent",
+                    "resolved": "TabBarExtraContent | string",
+                    "references": {
+                        "TabBarExtraContent": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabBarExtraContent",
+                            "referenceLocation": "TabBarExtraContent"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs tabBarExtraContent=\"Extra\"></x-tabs>"
+                        }],
+                    "text": "Extra content in tab bar (left/right)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "tab-bar-extra-content"
+            },
+            "addIcon": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs type=\"editable-card\" addIcon=\"plus\"></x-tabs>"
+                        }],
+                    "text": "Customize add icon, only works with type=\"editable-card\"."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "add-icon"
+            },
+            "removeIcon": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs type=\"editable-card\" removeIcon=\"close\"></x-tabs>"
+                        }],
+                    "text": "Customize remove icon, only works with type=\"editable-card\"."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "remove-icon"
+            },
+            "hideAdd": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs type=\"editable-card\" hideAdd></x-tabs>"
+                        }],
+                    "text": "Whether to hide add button (only for editable-card)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "hide-add",
+                "defaultValue": "false"
+            },
+            "destroyInactiveTabPane": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }, {
+                            "name": "example",
+                            "text": "<x-tabs destroyInactiveTabPane></x-tabs>"
+                        }],
+                    "text": "Whether to destroy inactive tab panes."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "destroy-inactive-tab-pane",
+                "defaultValue": "false"
+            },
+            "classNames": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsClassNames",
+                    "resolved": "TabsClassNames",
+                    "references": {
+                        "TabsClassNames": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsClassNames",
+                            "referenceLocation": "TabsClassNames"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs classNames={{ root: 'my-tabs' }}></x-tabs>"
+                        }],
+                    "text": "Custom class names for parts."
+                },
+                "getter": false,
+                "setter": false
+            },
+            "styles": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "TabsStyles",
+                    "resolved": "TabsStyles",
+                    "references": {
+                        "TabsStyles": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsStyles",
+                            "referenceLocation": "TabsStyles"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs styles={{ header: { background: '#fff' } }}></x-tabs>"
+                        }],
+                    "text": "Custom styles for parts."
+                },
+                "getter": false,
+                "setter": false
+            }
+        };
+    }
+    static get states() {
+        return {
+            "tabs": {},
+            "inkBarStyle": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "xChange",
+                "name": "xChange",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs onXChange={(ev) => console.log(ev.detail)}></x-tabs>"
+                        }],
+                    "text": "Callback when active tab changes."
+                },
+                "complexType": {
+                    "original": "TabsChangeEventDetail",
+                    "resolved": "TabsChangeEventDetail",
+                    "references": {
+                        "TabsChangeEventDetail": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsChangeEventDetail",
+                            "referenceLocation": "TabsChangeEventDetail"
+                        }
+                    }
+                }
+            }, {
+                "method": "xTabClick",
+                "name": "xTabClick",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs onXTabClick={(ev) => console.log(ev.detail)}></x-tabs>"
+                        }],
+                    "text": "Callback when tab is clicked."
+                },
+                "complexType": {
+                    "original": "TabsClickEventDetail",
+                    "resolved": "TabsClickEventDetail",
+                    "references": {
+                        "TabsClickEventDetail": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsClickEventDetail",
+                            "referenceLocation": "TabsClickEventDetail"
+                        }
+                    }
+                }
+            }, {
+                "method": "xEdit",
+                "name": "xEdit",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs onXEdit={(ev) => console.log(ev.detail)} type=\"editable-card\"></x-tabs>"
+                        }],
+                    "text": "Callback when tab is added or removed (only for editable-card)."
+                },
+                "complexType": {
+                    "original": "TabsEditEventDetail",
+                    "resolved": "TabsEditEventDetail",
+                    "references": {
+                        "TabsEditEventDetail": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsEditEventDetail",
+                            "referenceLocation": "TabsEditEventDetail"
+                        }
+                    }
+                }
+            }, {
+                "method": "xTabScroll",
+                "name": "xTabScroll",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "example",
+                            "text": "<x-tabs onXTabScroll={(ev) => console.log(ev.detail)}></x-tabs>"
+                        }],
+                    "text": "Callback when tab scroll."
+                },
+                "complexType": {
+                    "original": "TabsScrollEventDetail",
+                    "resolved": "TabsScrollEventDetail",
+                    "references": {
+                        "TabsScrollEventDetail": {
+                            "location": "import",
+                            "path": "./types",
+                            "id": "src/components/x-tabs/types.ts::TabsScrollEventDetail",
+                            "referenceLocation": "TabsScrollEventDetail"
+                        }
+                    }
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "getActiveKey": {
+                "complexType": {
+                    "signature": "() => Promise<string | undefined>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<string>"
+                },
+                "docs": {
+                    "text": "Get current active key.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Promise<string | undefined>"
+                        }, {
+                            "name": "example",
+                            "text": "const key = await el.getActiveKey()"
+                        }]
+                }
+            },
+            "setActiveKey": {
+                "complexType": {
+                    "signature": "(key: string) => Promise<void>",
+                    "parameters": [{
+                            "name": "key",
+                            "type": "string",
+                            "docs": "- Tab key to activate."
+                        }],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Set active tab by key.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "key - Tab key to activate."
+                        }, {
+                            "name": "returns",
+                            "text": "Promise<void>"
+                        }, {
+                            "name": "example",
+                            "text": "await el.setActiveKey('profile')"
+                        }]
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "activeKey",
+                "methodName": "handleActiveKeyChange"
+            }, {
+                "propName": "items",
+                "methodName": "handleItemsChange"
+            }];
+    }
+}