@brightspot/ui 1.10.0 → 3.0.0

package/dist/components/tabs/Tabs.js

@@ -0,0 +1,390 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { LitElement, html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { EventEmitterMixin } from '../../util/EventEmitterMixin.js';
+import { ReadyMixin } from '../../util/ReadyMixin.js';
+import { RovingTabindexMixin } from '../../util/RovingTabindexMixin.js';
+import '../badge/Badge.js';
+import '../dropdown/Dropdown.js';
+import '../dropdown/DropdownItem.js';
+import '../dropdown/DropdownMenu.js';
+import '../icon/Icon.js';
+/**
+ * A container component for managing a group of tabs.
+ *
+ * Provides selection state management, size propagation to child tabs,
+ * and keyboard navigation following the WAI-ARIA Tabs pattern.
+ *
+ * When a tab becomes active, direct sibling elements that share the same
+ * `name` value are shown; other siblings with a `name` attribute are
+ * hidden. Only direct siblings are managed — nested tab groups control their
+ * own panels independently.
+ *
+ * @element btu-tabs
+ *
+ * @fires {CustomEvent} btu-tabs-ready - Fired after first render and initialization
+ * @fires {CustomEvent<{name: string}>} btu-tabs-show - Fired when a tab becomes active
+ * @fires {CustomEvent<{name: string}>} btu-tabs-hide - Fired when a tab is deactivated
+ * @fires {CustomEvent<{name: string}>} btu-tab-change - Fired when a tab is selected (bubbles from btu-tab)
+ * @fires {CustomEvent} btu-tab-ready - Fired when a child tab finishes initialization (bubbles from btu-tab)
+ *
+ * @cssprop --tabs-active-color - Text and icon color of the active tab (default: gray-700)
+ * @cssprop --tabs-active-indicator-color - Color of the active tab underline indicator (default: primary-500 → primary-700 → primary-900 gradient)
+ * @cssprop --tabs-border-color - Color of the bottom border divider (default: gray-200)
+ * @cssprop --tabs-color - Text and icon color for all tabs (default: gray-500; active/hover tabs use gray-700)
+ * @cssprop --tabs-background - Background color for all tab buttons (default: transparent)
+ * @cssprop --tabs-container-background - Background color of the tabs container (default: theme white)
+ * @cssprop --tabs-hover-background - Background color of a tab on hover (default: gray-100)
+ * @cssprop --tabs-hover-color - Text and icon color of a tab on hover (default: gray-700)
+ * @cssprop --tabs-gap - Spacing between tabs (default: 1rem)
+ *
+ * @example
+ * ```html
+ * <div>
+ *   <btu-tabs size="md" active-tab="main">
+ *     <btu-tab name="main" label="Main"></btu-tab>
+ *     <btu-tab name="seo" label="SEO"></btu-tab>
+ *     <btu-tab name="overrides" label="Overrides"></btu-tab>
+ *   </btu-tabs>
+ *   <div name="main" role="tabpanel">Main content</div>
+ *   <div name="seo" role="tabpanel">SEO content</div>
+ *   <div name="overrides" role="tabpanel">Overrides content</div>
+ * </div>
+ * ```
+ */
+export default class Tabs extends RovingTabindexMixin(EventEmitterMixin(ReadyMixin(LitElement))) {
+    constructor() {
+        super(...arguments);
+        /**
+         * Size variant applied to all child tabs.
+         * @attr
+         */
+        this.size = 'md';
+        /**
+         * Layout variant.
+         * - 'full': tabs scroll horizontally when they overflow (default)
+         * - 'menu': all tabs are hidden; the active tab label and a chevron dropdown are shown instead
+         * @attr
+         */
+        this.variant = 'full';
+        /** @internal */
+        this.initialClasses = [];
+        /** @internal Bound event handler for cleanup */
+        this.boundHandleTabChange = this.handleTabChange.bind(this);
+        /** @internal Bound event handler for cleanup */
+        this.boundHandleKeyDown = this.handleKeyDown.bind(this);
+        /** @internal Menu variant state */
+        this.rafId = null;
+        this.menuWrapper = null;
+        this.menuDropdown = null;
+        this.menuLabel = null;
+        this.menuIcon = null;
+        this.menuErrorBadge = null;
+    }
+    static get tagName() {
+        return 'BTU-TABS';
+    }
+    /** @internal */
+    _getRovingTargets() {
+        const buttons = [];
+        for (const tab of this.getTabs()) {
+            if (tab.style.display === 'none')
+                continue;
+            const btn = tab.querySelector('button');
+            if (btn)
+                buttons.push(btn);
+        }
+        return buttons;
+    }
+    // Dropdown doesn't accept 'xs'; floor the tabs 'xs' size to 'sm' when forwarding.
+    get _dropdownSize() {
+        return this.size === 'xs' ? 'sm' : this.size;
+    }
+    // Menu-variant icon is always small relative to the tab label, regardless of tabs size.
+    get _menuIconSize() {
+        return this.size === 'lg' ? 'md' : 'sm';
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (this.className) {
+            this.initialClasses = this.className.split(' ').filter(c => c.trim());
+        }
+        this.setAttribute('role', 'tablist');
+        this.addEventListener('btu-tab-change', this.boundHandleTabChange);
+        this.addEventListener('keydown', this.boundHandleKeyDown);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        if (this.rafId) {
+            cancelAnimationFrame(this.rafId);
+            this.rafId = null;
+        }
+        this.removeEventListener('btu-tab-change', this.boundHandleTabChange);
+        this.removeEventListener('keydown', this.boundHandleKeyDown);
+    }
+    createRenderRoot() {
+        return this;
+    }
+    willUpdate() {
+        this.className = [
+            ...this.initialClasses,
+            'btu-tabs',
+            `btu-tabs-${this.size}`,
+            this.variant === 'menu' ? 'btu-tabs-menu-mode' : '',
+        ]
+            .filter(Boolean)
+            .join(' ');
+    }
+    firstUpdated() {
+        if (!this.activeTab) {
+            const firstEnabled = this.getTabs().find(t => !t.disabled);
+            if (firstEnabled)
+                this.activeTab = firstEnabled.name;
+        }
+        this.syncTabs();
+        this.syncPanels();
+        if (this.variant === 'menu') {
+            this.initMenu();
+        }
+        else {
+            this.emit('btu-tabs-ready');
+        }
+    }
+    updated(changedProperties) {
+        if (changedProperties.has('activeTab') && !this.activeTab) {
+            const firstEnabled = this.getTabs().find(t => !t.disabled);
+            if (firstEnabled)
+                this.activeTab = firstEnabled.name;
+        }
+        if (changedProperties.has('activeTab') || changedProperties.has('size')) {
+            this.syncTabs();
+        }
+        if (changedProperties.has('activeTab')) {
+            this.syncPanels();
+        }
+        if (changedProperties.has('size') && this.menuDropdown) {
+            this.menuDropdown.size = this._dropdownSize;
+        }
+        if (changedProperties.has('variant') && changedProperties.get('variant') !== undefined) {
+            this.teardownVariant(changedProperties.get('variant'));
+            if (this.variant === 'menu')
+                this.initMenu();
+        }
+    }
+    /** @internal Tear down a variant's DOM and state before switching to another */
+    teardownVariant(previous) {
+        if (previous === 'menu') {
+            this.menuWrapper?.remove();
+            this.menuWrapper = null;
+            this.menuDropdown = null;
+            this.menuLabel = null;
+            this.menuIcon = null;
+            this.menuErrorBadge = null;
+            this.getTabs().forEach(tab => tab.style.removeProperty('display'));
+        }
+    }
+    /** @internal */
+    syncTabs() {
+        this.getTabs().forEach(tab => {
+            tab.size = this.size;
+            tab._active = tab.name === this.activeTab;
+            tab._tabindex = tab.name === this.activeTab ? 0 : -1;
+            tab.requestUpdate();
+        });
+        if (this.variant === 'menu') {
+            this.syncMenuState();
+        }
+    }
+    /** @internal Show/hide panel elements that are direct siblings with a matching name value */
+    syncPanels() {
+        if (!this.activeTab || !this.parentElement)
+            return;
+        Array.from(this.parentElement.children).forEach(child => {
+            if (child === this || !(child instanceof HTMLElement))
+                return;
+            // data-tab is a deprecated fallback for compat — use name instead
+            const panelName = child.getAttribute('name') ?? child.dataset.tab;
+            if (!panelName)
+                return;
+            child.hidden = panelName !== this.activeTab;
+        });
+    }
+    /** @internal */
+    getTabs() {
+        return Array.from(this.querySelectorAll('btu-tab'));
+    }
+    /** @internal */
+    activateTab(name) {
+        const newTab = this.getTabs().find(t => t.name === name);
+        if (!newTab || newTab.disabled) {
+            const available = this.getTabs()
+                .map(t => t.name)
+                .filter(Boolean);
+            console.warn(`[btu-tabs] Tab "${name}" not found or is disabled. Available tabs: ${available.join(', ')}`);
+            return;
+        }
+        if (name === this.activeTab)
+            return;
+        const oldName = this.activeTab;
+        if (oldName) {
+            this.emit('btu-tabs-hide', { name: oldName });
+        }
+        this.activeTab = name;
+        this.emit('btu-tabs-show', { name });
+        this.syncTabs();
+        this.syncPanels();
+    }
+    /** @internal */
+    handleTabChange(event) {
+        this.activateTab(event.detail.name);
+    }
+    /** @internal Keyboard navigation following WAI-ARIA Tabs pattern */
+    handleKeyDown(event) {
+        switch (event.key) {
+            case 'ArrowRight':
+                event.preventDefault();
+                this._rovingNext();
+                break;
+            case 'ArrowLeft':
+                event.preventDefault();
+                this._rovingPrev();
+                break;
+            case 'Home':
+                event.preventDefault();
+                this._rovingFirst();
+                break;
+            case 'End':
+                event.preventDefault();
+                this._rovingLast();
+                break;
+        }
+    }
+    // ─── Menu variant ────────────────────────────────────────────────────────────
+    /** @internal */
+    initMenu() {
+        // Hide all tab buttons — they're only accessible via the dropdown
+        this.getTabs().forEach(tab => (tab.style.display = 'none'));
+        const activeTab = this.getTabs().find(t => t.name === this.activeTab);
+        this.menuWrapper = document.createElement('div');
+        const wrapper = this.menuWrapper;
+        wrapper.className = 'btu-tab-menu-wrapper';
+        this.menuIcon = document.createElement('btu-icon');
+        this.menuIcon.setAttribute('size', this._menuIconSize);
+        this.menuIcon.setAttribute('symbol', activeTab?.symbol ?? '');
+        this.menuIcon.hidden = !activeTab?.symbol;
+        this.menuLabel = document.createElement('span');
+        this.menuLabel.className = 'btu-tab-menu-label';
+        this.menuLabel.textContent = activeTab?.label ?? '';
+        if (activeTab?.iconPosition === 'trailing') {
+            wrapper.appendChild(this.menuLabel);
+            wrapper.appendChild(this.menuIcon);
+        }
+        else {
+            wrapper.appendChild(this.menuIcon);
+            wrapper.appendChild(this.menuLabel);
+        }
+        this.menuErrorBadge = document.createElement('btu-badge');
+        this.menuErrorBadge.setAttribute('size', 'sm');
+        this.menuErrorBadge.setAttribute('variant', 'error');
+        this.menuErrorBadge.textContent = '!';
+        this.menuErrorBadge.hidden = !activeTab?.error;
+        wrapper.appendChild(this.menuErrorBadge);
+        const dropdownMenu = document.createElement('btu-dropdown-menu');
+        this.menuDropdown = document.createElement('btu-dropdown');
+        this.menuDropdown.label = 'Tabs';
+        this.menuDropdown.iconOnly = true;
+        this.menuDropdown.noChevron = false;
+        this.menuDropdown.variant = 'tertiary';
+        this.menuDropdown.placement = 'bottom-start';
+        this.menuDropdown.size = this._dropdownSize;
+        this.menuDropdown.appendChild(dropdownMenu);
+        this.menuDropdown.addEventListener('btu-dropdown-item-select', (e) => {
+            e.stopPropagation();
+            const item = e.target.closest('btu-dropdown-item');
+            const name = item?.dataset.name;
+            if (name)
+                this.activateTab(name);
+        });
+        wrapper.appendChild(this.menuDropdown);
+        this.appendChild(wrapper);
+        // Defer population to allow btu-dropdown to finish its firstUpdated lifecycle
+        this.rafId = requestAnimationFrame(() => {
+            this.rafId = null;
+            this.updateMenuItems();
+            this.emit('btu-tabs-ready');
+        });
+    }
+    /** @internal */
+    updateMenuItems() {
+        if (!this.isConnected)
+            return;
+        const menu = this.menuDropdown?.querySelector('btu-dropdown-menu');
+        if (!menu)
+            return;
+        menu.innerHTML = '';
+        const tabs = this.getTabs();
+        const hasIcons = tabs.some(t => !!t.symbol);
+        tabs.forEach(tab => {
+            const item = document.createElement('btu-dropdown-item');
+            item.dataset.name = tab.name ?? '';
+            item.label = tab.label ?? tab.name ?? '';
+            item.selected = tab.name === this.activeTab;
+            item.disabled = tab.disabled;
+            item.error = tab.error;
+            if (tab.symbol)
+                item.symbol = tab.symbol;
+            menu.appendChild(item);
+            item._configure({ checkbox: false, icon: hasIcons, symbol: '', favorites: false, shortcuts: false });
+        });
+    }
+    /** @internal */
+    syncMenuState() {
+        const activeTab = this.getTabs().find(t => t.name === this.activeTab);
+        if (this.menuLabel) {
+            this.menuLabel.textContent = activeTab?.label ?? '';
+        }
+        if (this.menuIcon) {
+            const symbol = activeTab?.symbol ?? '';
+            this.menuIcon.setAttribute('symbol', symbol);
+            this.menuIcon.setAttribute('size', this._menuIconSize);
+            this.menuIcon.hidden = !symbol;
+            // Reposition if icon-position changed
+            const wrapper = this.menuIcon.parentElement;
+            if (wrapper && this.menuLabel) {
+                if (activeTab?.iconPosition === 'trailing') {
+                    wrapper.insertBefore(this.menuIcon, this.menuErrorBadge);
+                }
+                else {
+                    wrapper.insertBefore(this.menuIcon, this.menuLabel);
+                }
+            }
+        }
+        if (this.menuErrorBadge) {
+            this.menuErrorBadge.hidden = !activeTab?.error;
+        }
+        this.menuDropdown?.querySelectorAll('btu-dropdown-item').forEach(item => {
+            item.selected = item.dataset.name === this.activeTab;
+        });
+    }
+    render() {
+        return html ``;
+    }
+}
+__decorate([
+    property({ type: String })
+], Tabs.prototype, "size", void 0);
+__decorate([
+    property({ type: String, attribute: 'active-tab' })
+], Tabs.prototype, "activeTab", void 0);
+__decorate([
+    property({ type: String })
+], Tabs.prototype, "variant", void 0);
+if (!customElements.get('btu-tabs')) {
+    customElements.define('btu-tabs', Tabs);
+}
+//# sourceMappingURL=Tabs.js.map

package/dist/components/tabs/Tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.js","sourceRoot":"","sources":["../../../src/components/tabs/Tabs.ts"],"names":[],"mappings":"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"}

package/dist/components/upload/Upload.d.ts

@@ -0,0 +1,157 @@
+import { LitElement } from 'lit';
+import '../icon/Icon.js';
+import './UploadItem.js';
+import type { FileState, FileStatus, FileStatusSettable } from './UploadItem.js';
+export type { FileState, FileStatus, FileStatusSettable };
+declare const Upload_base: (new (...args: any[]) => import("../../util/EventEmitterMixin.js").EventEmitterMixinInterface) & (new (...args: any[]) => import("../../util/ReadyMixin.js").ReadyMixinInterface) & typeof LitElement;
+/**
+ * A file upload component with drop zone and file list.
+ *
+ * The component is presentation + file-selection only. It handles file browsing,
+ * drag-and-drop reception, client-side validation, and rendering the file list
+ * with progress bars. It does not perform network requests — the consumer listens
+ * for events, performs their own upload, and drives state back via imperative methods.
+ *
+ * @element btu-upload
+ *
+ * @fires {CustomEvent<unknown>} btu-upload-ready - Fired when the component has completed first render
+ * @fires {CustomEvent<{id: string, file: File}>} btu-upload-file-added - Fired when a file passes validation and is added
+ * @fires {CustomEvent<{id: string, file: File}>} btu-upload-file-removed - Fired when a file is removed (user action, programmatic, or on disconnect for in-flight uploads)
+ * @fires {CustomEvent<{id: string, file: File}>} btu-upload-file-retry - Fired when user clicks "Try again" on a failed upload
+ * @fires {CustomEvent<{file: File, reason: 'type' | 'size' | 'count'}>} btu-upload-file-rejected - Fired when a file fails client-side validation or the queue is full
+ * @fires {CustomEvent<{id: string, file: File}>} btu-upload-file-completed - Fired when a file's status transitions into 'complete'
+ * @fires {CustomEvent<{method: string, id: string, reason: 'unknown-id' | 'invalid-transition', message: string}>} btu-upload-api-error - Fired when an imperative API call references an unknown id or an illegal status transition
+ *
+ * @cssprop --upload-dropzone-bg - Drop zone background color (default: gray-25)
+ * @cssprop --upload-dropzone-border-color - Drop zone border color (default: gray-300; gray-200 when disabled, gray-400 in high-contrast)
+ * @cssprop --upload-dropzone-border-radius - Drop zone border radius (default: borderRadius.lg)
+ * @cssprop --upload-dropzone-hover-bg - Drop zone hover background (hover default: gray-50; drag-over default: primary-25)
+ * @cssprop --upload-dropzone-hover-border-color - Drop zone hover/focus border color (default: primary-300; drag-over uses primary-400)
+ * @cssprop --upload-dropzone-focus-ring-color - Drop zone focus ring color (default: primary-100)
+ * @cssprop --upload-item-bg - Item background color (default: white)
+ * @cssprop --upload-item-border-color - Item border color (default: gray-200)
+ * @cssprop --upload-item-active-border-color - Item active/in-progress border (default: gray-300)
+ * @cssprop --upload-item-complete-border-color - Item completed border color (default: primary-500)
+ * @cssprop --upload-item-error-bg - Item error background (default: error-25)
+ * @cssprop --upload-item-error-border-color - Item error border color (default: error-300)
+ */
+export default class Upload extends Upload_base {
+    /**
+     * Accepted file types, matching the HTML `<input accept>` attribute format.
+     * Client-side filter only — the browser's file picker uses this as a hint,
+     * and drag-drop is enforced by this component. Server-side validation is
+     * still required.
+     *
+     * Supported forms (comma-separated, any combination):
+     * - `image/*` — MIME wildcard (any image)
+     * - `application/pdf` — exact MIME type
+     * - `.pdf`, `.docx` — file extension (case-insensitive)
+     *
+     * Examples:
+     * - `accept="image/*"` — any image
+     * - `accept="image/*,application/pdf"` — images and PDFs
+     * - `accept=".jpg,.jpeg,.png,.heic"` — specific extensions
+     * - `accept=""` (or omitted) — allow all
+     *
+     * Note: users can bypass the file picker's filter (most browsers offer an
+     * "All Files" option), so this attribute is a UX filter, not a security
+     * boundary.
+     *
+     * @attr
+     */
+    accept: string;
+    /**
+     * Maximum file size in bytes. Files exceeding this are rejected. 0 means unlimited.
+     * @attr max-file-size
+     */
+    maxFileSize: number;
+    /**
+     * Maximum number of files allowed. When omitted, uploads are unlimited.
+     * `max-files="1"` enters single-file mode (selecting a new file replaces the existing one).
+     * `max-files="0"` allows zero files. Values above 1 cap the queue at that many files.
+     * @attr max-files
+     */
+    maxFiles: number;
+    /**
+     * Disables all interaction — file selection, drag-and-drop, and action buttons.
+     * @attr
+     */
+    disabled: boolean;
+    /**
+     * Disables drag-and-drop. File selection via click still works.
+     * @attr no-drag
+     */
+    noDrag: boolean;
+    private _files;
+    private _items;
+    private _milestones;
+    private _dragOver;
+    private _dragCounter;
+    private get _inputEl();
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    private _handleInputChange;
+    private _handleSelectClick;
+    private _handleDropzoneClick;
+    private _handleDragEnter;
+    private _handleDragOver;
+    private _handleDragLeave;
+    private _handleDrop;
+    private _processFiles;
+    private _rejectCount;
+    private _validateFile;
+    private _addFile;
+    private _reportUnknownId;
+    private _getOrReport;
+    private _renderItem;
+    /**
+     * Update the progress of a file upload.
+     * Clamps value to 0-100 and coerces non-finite inputs to 0. Announces milestones
+     * (25%, 50%, 75%) to screen readers; 100% completion is announced by setFileStatus('complete').
+     *
+     * Status transitions:
+     * - `pending` → `uploading` (auto — first progress report starts the upload)
+     * - `uploading` → `uploading` (progress updates)
+     * - `error` → `error` (progress updates only; status is preserved so a stale late
+     *   callback can't wipe the error UI. To recover from error, call
+     *   `setFileStatus(id, 'uploading')` first, then report progress.)
+     * - `complete` → ignored (terminal state)
+     */
+    setFileProgress(id: string, percent: number): void;
+    /**
+     * Set the status of a file.
+     * Valid statuses: 'uploading', 'complete', 'error'. For 'error' status, an
+     * optional message can be provided.
+     *
+     * Transitions from 'complete' are rejected (terminal state) — a late-resolving
+     * XHR cannot overwrite a prior success. Rejected calls emit `btu-upload-api-error`
+     * with reason: 'invalid-transition'.
+     */
+    setFileStatus(id: string, status: FileStatusSettable, message?: string): void;
+    /**
+     * Override the icon symbol for a file.
+     */
+    setFileSymbol(id: string, symbol: string): void;
+    /**
+     * Remove a file programmatically. Fires `btu-upload-file-removed`.
+     */
+    removeFile(id: string): void;
+    /**
+     * Get a snapshot of all current files and their states.
+     * States are readonly; mutations on the returned array's elements are ineffective.
+     */
+    getFiles(): readonly FileState[];
+    private get _dropzoneFull();
+    private get _interactionBlocked();
+    private get _showCountPill();
+    private _renderSelectButton;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'btu-upload': Upload;
+    }
+}
+//# sourceMappingURL=Upload.d.ts.map

package/dist/components/upload/Upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Upload.d.ts","sourceRoot":"","sources":["../../../src/components/upload/Upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAA;AAO/C,OAAO,iBAAiB,CAAA;AACxB,OAAO,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEhF,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAA;;AAIzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAyC;IAC3E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAEH,MAAM,EAAE,MAAM,CAAK;IAEnB;;;OAGG;IAEH,WAAW,EAAE,MAAM,CAAI;IAEvB;;;;;OAKG;IAgBH,QAAQ,EAAE,MAAM,CAAW;IAE3B;;;OAGG;IAEH,QAAQ,EAAE,OAAO,CAAQ;IAEzB;;;OAGG;IAEH,MAAM,EAAE,OAAO,CAAQ;IAEvB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,WAAW,CAAsC;IAGzD,OAAO,CAAC,SAAS,CAAiB;IAElC,OAAO,CAAC,YAAY,CAAY;IAEhC,OAAO,KAAK,QAAQ,GAEnB;IAED,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAgB5B,YAAY,IAAI,IAAI;IAqBpB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;IAanB;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiClD;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAgD7E;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAU/C;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAe5B;;;OAGG;IACH,QAAQ,IAAI,SAAS,SAAS,EAAE;IAIhC,OAAO,KAAK,aAAa,GAKxB;IAED,OAAO,KAAK,mBAAmB,GAE9B;IAED,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,CAAC,mBAAmB;IAW3B,MAAM;CAoEP;AAMD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,MAAM,CAAA;KACrB;CACF"}