@pithyjs/ui-kit 0.1.0-beta.0

package/dist/atoms/forms/select/Select.js

@@ -0,0 +1,457 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.select",
+  "title": "<Select> Form Atom",
+  "category": "feature"
+}
+*/
+import { effect } from '@pithyjs/signals';
+import { CONTROL_SIZES, } from '../../../shared/types';
+import { generateSelectId } from '../../../shared/select';
+import { CHEVRON_DOWN_ICON } from '../../../shared/icons';
+import { createHelperElement, createErrorElement, createStateIcon, wrapFormControl, } from '../../../shared/form-elements';
+import { createFormStateTracker, applyFormState, cleanupFormState, } from '../../../shared/form-state';
+import { renderOptions, selectValue, closeDropdown, toggleDropdown, createListboxClickHandler, positionDropdown, } from './select-dropdown';
+import { createTriggerKeydownHandler, createSearchKeydownHandler, } from './select-keyboard';
+/**
+ * Accessible custom select atom with searchable dropdown, keyboard navigation,
+ * and polished micro-interactions.
+ *
+ * Renders a trigger button with a dropdown listbox. Supports search filtering,
+ * success/error states with shake animation and state icons, helper text, error
+ * message, clear button, and loading spinner.
+ *
+ * This is a pure visual atom — no validation logic. Error/success states are
+ * driven externally via props.
+ *
+ * @param props - Select configuration
+ * @returns `{ el, destroy }` — mounted element and cleanup function
+ *
+ * @example
+ * ```html
+ * <Select label="'Country'" options="countries" placeholder="'Select a country'" />
+ * <Select label="'Status'" options="statuses" searchable="true" />
+ * <Select label="'Priority'" options="priorities" clearable="true" />
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.select","name":"Select","stability":"stable","signature":"(props: SelectProps) => { el: HTMLElement | DocumentFragment; destroy: () => void }"} */
+export function Select({ id: externalId, name, options: optionsProp, value, placeholder, disabled = false, readonly: readonlyProp = false, required = false, error = false, errorMessage, helperText, success = false, size: rawSize = 'md', label, searchable = false, clearable = false, loading = false, onChange, onBlur, onFocus, }) {
+    // -- Prop validation -------------------------------------------------------
+    const validSize = CONTROL_SIZES.includes(rawSize);
+    if (import.meta.env?.DEV) {
+        if (!validSize) {
+            const valid = CONTROL_SIZES.join(', ');
+            console.warn(`[<Select>] Invalid size: "${rawSize}". Expected one of: ${valid}. Falling back to "md".`);
+        }
+        if (!label) {
+            console.warn(`[<Select>] Empty label — all selects require an accessible name. Pass a non-empty label string.`);
+        }
+        const opts = typeof optionsProp === 'function' ? optionsProp() : optionsProp;
+        if (opts.some(o => o.value === '')) {
+            console.warn(`[<Select>] Option with empty string value detected. Empty string is reserved as the "no selection" sentinel and will be treated as "cleared".`);
+        }
+    }
+    const size = validSize ? rawSize : 'md';
+    const selectId = externalId ?? generateSelectId();
+    const listboxId = `${selectId}-listbox`;
+    // -- Shared state & callbacks ----------------------------------------------
+    // Internal value for uncontrolled mode. A non-function `value` is treated
+    // as the initial uncontrolled value; only function-valued `value` props are
+    // controlled/reactive.
+    let internalValue = typeof value === 'function' ? undefined : value;
+    const isControlled = typeof value === 'function';
+    const readOptions = () => typeof optionsProp === 'function' ? optionsProp() : optionsProp;
+    const readValue = () => {
+        if (typeof value === 'function')
+            return value();
+        return internalValue;
+    };
+    const readDisabled = () => typeof disabled === 'function' ? disabled() : disabled;
+    const readReadonly = () => typeof readonlyProp === 'function' ? readonlyProp() : readonlyProp;
+    const readError = () => (typeof error === 'function' ? error() : error);
+    const readErrorMessage = () => typeof errorMessage === 'function' ? errorMessage() : errorMessage;
+    const readSuccess = () => typeof success === 'function' ? success() : success;
+    const readLoading = () => typeof loading === 'function' ? loading() : loading;
+    const state = {
+        isOpen: false,
+        activeIndex: -1,
+        searchQuery: '',
+        filteredOptions: [],
+    };
+    // -- Element creation ------------------------------------------------------
+    const wrapper = document.createElement('div');
+    wrapper.classList.add('ui-select', 'u-radius-md');
+    wrapper.setAttribute('data-size', size);
+    // Hidden native select for form submission only (not constraint validation).
+    // aria-required + custom error states handle validation; native validation is
+    // skipped to avoid browser popover on a non-interactive element.
+    const hiddenSelect = document.createElement('select');
+    hiddenSelect.hidden = true;
+    hiddenSelect.tabIndex = -1;
+    hiddenSelect.setAttribute('aria-hidden', 'true');
+    if (name != null)
+        hiddenSelect.name = name;
+    wrapper.appendChild(hiddenSelect);
+    // Trigger — uses <div> instead of <button> so nested clear <button> is valid HTML.
+    // role="combobox" + tabindex="0" provides the same keyboard/screen-reader contract.
+    const trigger = document.createElement('div');
+    trigger.id = selectId;
+    trigger.classList.add('ui-select-trigger');
+    trigger.setAttribute('role', 'combobox');
+    trigger.tabIndex = 0;
+    trigger.setAttribute('aria-haspopup', 'listbox');
+    trigger.setAttribute('aria-expanded', 'false');
+    trigger.setAttribute('aria-controls', listboxId);
+    trigger.setAttribute('aria-label', label);
+    // Value display
+    const valueDisplay = document.createElement('span');
+    valueDisplay.classList.add('ui-select-value');
+    trigger.appendChild(valueDisplay);
+    // Clear button
+    let clearBtnEl;
+    let clearClickHandler;
+    let clearKeydownHandler;
+    if (clearable) {
+        clearBtnEl = document.createElement('button');
+        clearBtnEl.type = 'button';
+        clearBtnEl.classList.add('ui-select-clear');
+        clearBtnEl.setAttribute('aria-label', 'Clear selection');
+        clearBtnEl.textContent = '\u00D7'; // ×
+        clearBtnEl.toggleAttribute('data-hidden', true);
+        clearBtnEl.tabIndex = -1;
+        clearBtnEl.setAttribute('aria-hidden', 'true');
+        clearClickHandler = (e) => {
+            e.stopPropagation();
+            selectValue('', undefined, els, cbs);
+            trigger.focus();
+        };
+        clearKeydownHandler = (e) => {
+            // Stop all keydown propagation — prevents trigger's combobox keyboard
+            // handler from intercepting Arrow/Escape/Home/End while clear is focused.
+            e.stopPropagation();
+        };
+        clearBtnEl.addEventListener('click', clearClickHandler);
+        clearBtnEl.addEventListener('keydown', clearKeydownHandler);
+        trigger.appendChild(clearBtnEl);
+    }
+    // State icon (success checkmark / error alert)
+    const stateIconEl = createStateIcon('ui-select-state-icon');
+    trigger.appendChild(stateIconEl);
+    // Chevron
+    const chevronEl = document.createElement('span');
+    chevronEl.classList.add('ui-select-chevron');
+    chevronEl.innerHTML = CHEVRON_DOWN_ICON;
+    trigger.appendChild(chevronEl);
+    if (required) {
+        wrapper.setAttribute('data-required', '');
+        trigger.setAttribute('aria-required', 'true');
+    }
+    wrapper.appendChild(trigger);
+    // -- Dropdown --------------------------------------------------------------
+    const dropdown = document.createElement('div');
+    dropdown.classList.add('ui-select-dropdown');
+    dropdown.setAttribute('data-size', size);
+    dropdown.hidden = true;
+    // Search input (when searchable)
+    let searchInput;
+    let searchInputHandler;
+    if (searchable) {
+        const searchWrapper = document.createElement('div');
+        searchWrapper.classList.add('ui-select-search');
+        searchInput = document.createElement('input');
+        searchInput.type = 'text';
+        searchInput.classList.add('ui-select-search-input');
+        searchInput.setAttribute('role', 'searchbox');
+        searchInput.setAttribute('aria-label', `Search ${label}`);
+        searchInput.setAttribute('aria-autocomplete', 'list');
+        searchInput.setAttribute('aria-controls', listboxId);
+        searchInput.setAttribute('autocomplete', 'off');
+        searchInput.placeholder = 'Search\u2026';
+        searchInputHandler = () => {
+            state.searchQuery = searchInput.value;
+            renderOptions(state, els, cbs);
+        };
+        searchInput.addEventListener('input', searchInputHandler);
+        searchWrapper.appendChild(searchInput);
+        dropdown.appendChild(searchWrapper);
+    }
+    // Listbox
+    const listbox = document.createElement('ul');
+    listbox.id = listboxId;
+    listbox.setAttribute('role', 'listbox');
+    listbox.setAttribute('aria-label', label);
+    listbox.classList.add('ui-select-listbox');
+    listbox.tabIndex = -1;
+    dropdown.appendChild(listbox);
+    // Empty state
+    const emptyEl = document.createElement('li');
+    emptyEl.classList.add('ui-select-empty');
+    emptyEl.textContent = 'No options found';
+    emptyEl.setAttribute('role', 'presentation');
+    emptyEl.hidden = true;
+    listbox.appendChild(emptyEl);
+    // Live region — announces filtered option count to screen readers
+    const liveRegion = document.createElement('span');
+    liveRegion.setAttribute('role', 'status');
+    liveRegion.setAttribute('aria-live', 'polite');
+    liveRegion.setAttribute('aria-atomic', 'true');
+    liveRegion.classList.add('u-sr-only');
+    wrapper.appendChild(liveRegion);
+    wrapper.appendChild(dropdown);
+    // -- Wire up shared structs ------------------------------------------------
+    const els = {
+        wrapper,
+        trigger,
+        dropdown,
+        listbox,
+        emptyEl,
+        searchInput,
+        chevronEl,
+        clearBtnEl,
+        liveRegion,
+    };
+    const cbs = {
+        readOptions,
+        readValue,
+        readDisabled,
+        readReadonly,
+        readLoading,
+        selectId,
+        onChange: (val, opt) => {
+            if (!isControlled) {
+                internalValue = val;
+                updateValueDisplay();
+            }
+            onChange?.(val, opt);
+        },
+    };
+    // -- Keyboard handlers -----------------------------------------------------
+    const triggerKeydown = createTriggerKeydownHandler(state, els, cbs);
+    const triggerKeydownHandler = triggerKeydown.handler;
+    const searchKeydownHandler = searchInput
+        ? createSearchKeydownHandler(state, els, cbs)
+        : undefined;
+    // -- Delegated listbox click ------------------------------------------------
+    const listboxClickHandler = createListboxClickHandler(state, els, cbs);
+    listbox.addEventListener('click', listboxClickHandler);
+    // -- Event listeners -------------------------------------------------------
+    const toggleHandler = () => toggleDropdown(state, els, cbs);
+    trigger.addEventListener('click', toggleHandler);
+    trigger.addEventListener('keydown', triggerKeydownHandler);
+    if (searchInput && searchKeydownHandler) {
+        searchInput.addEventListener('keydown', searchKeydownHandler);
+    }
+    const blurHandler = (e) => {
+        const related = e.relatedTarget;
+        // Wrapper + portaled dropdown are one focus unit.
+        if (related && (wrapper.contains(related) || dropdown.contains(related)))
+            return;
+        if (state.isOpen)
+            closeDropdown(state, els);
+        onBlur?.(e);
+    };
+    const focusHandler = (e) => {
+        onFocus?.(e);
+    };
+    wrapper.addEventListener('focusout', blurHandler);
+    trigger.addEventListener('focus', focusHandler);
+    // Close on outside click
+    const outsideClickHandler = (e) => {
+        if (!state.isOpen)
+            return;
+        const t = e.target;
+        // Clicks inside wrapper OR the portaled dropdown are "inside" the Select.
+        if (wrapper.contains(t) || dropdown.contains(t))
+            return;
+        closeDropdown(state, els);
+    };
+    document.addEventListener('click', outsideClickHandler);
+    // Reposition (don't close) on ancestor scroll — closing breaks UX when the Select
+    // sits inside a scrollable panel (e.g. studio properties list). rAF-coalesced
+    // because capture-phase scroll fires for every scrollable ancestor.
+    let scrollRaf = 0;
+    const scrollRepositionHandler = (e) => {
+        if (!state.isOpen || e.target === listbox || scrollRaf)
+            return;
+        scrollRaf = requestAnimationFrame(() => {
+            scrollRaf = 0;
+            if (state.isOpen)
+                positionDropdown(els);
+        });
+    };
+    document.addEventListener('scroll', scrollRepositionHandler, true);
+    // Reposition on viewport changes — the dropdown is position:fixed, so window
+    // resize / rotation / soft-keyboard show detaches it from the trigger.
+    const resizeRepositionHandler = () => {
+        if (!state.isOpen)
+            return;
+        positionDropdown(els);
+    };
+    window.addEventListener('resize', resizeRepositionHandler);
+    window.visualViewport?.addEventListener('resize', resizeRepositionHandler);
+    // Close on cross-component dismiss — the dropdown is portaled to <body>, so
+    // [inert]/[hidden] on the trigger's ancestors doesn't reach it via normal events.
+    const dismissPopoversHandler = () => {
+        if (state.isOpen)
+            closeDropdown(state, els);
+    };
+    document.addEventListener('pithy:dismiss-popovers', dismissPopoversHandler);
+    // -- Helper text ------------------------------------------------------------
+    const helperId = `${selectId}-helper`;
+    const helperEl = createHelperElement(helperId, helperText);
+    // -- Error message ----------------------------------------------------------
+    const errorMsgId = `${selectId}-error`;
+    const errorMsgEl = createErrorElement(errorMsgId, errorMessage);
+    // -- Reactive state --------------------------------------------------------
+    const isReactive = typeof value === 'function' ||
+        typeof optionsProp === 'function' ||
+        typeof disabled === 'function' ||
+        typeof readonlyProp === 'function' ||
+        typeof error === 'function' ||
+        typeof errorMessage === 'function' ||
+        typeof success === 'function' ||
+        typeof loading === 'function';
+    const formTracker = createFormStateTracker();
+    function updateValueDisplay() {
+        const currentVal = readValue();
+        const selected = currentVal
+            ? readOptions().find(o => o.value === currentVal)
+            : undefined;
+        if (selected) {
+            valueDisplay.textContent = selected.label;
+            valueDisplay.classList.remove('ui-select-placeholder');
+            wrapper.setAttribute('data-filled', '');
+        }
+        else {
+            valueDisplay.textContent = placeholder ?? '';
+            if (placeholder) {
+                valueDisplay.classList.add('ui-select-placeholder');
+            }
+            wrapper.removeAttribute('data-filled');
+        }
+        // Update hidden select for form submission — only when a matching option exists
+        hiddenSelect.innerHTML = '';
+        if (selected) {
+            const nativeOpt = document.createElement('option');
+            nativeOpt.value = selected.value;
+            nativeOpt.selected = true;
+            hiddenSelect.appendChild(nativeOpt);
+        }
+        // Clear button visibility — also remove from tab order when hidden
+        if (clearBtnEl) {
+            const show = !!selected && !readDisabled() && !readReadonly();
+            clearBtnEl.toggleAttribute('data-hidden', !show);
+            clearBtnEl.tabIndex = show ? 0 : -1;
+            clearBtnEl.setAttribute('aria-hidden', show ? 'false' : 'true');
+        }
+    }
+    const applyState = () => {
+        // Always read options so signal dependency is tracked even when dropdown is closed
+        readOptions();
+        // Value display
+        updateValueDisplay();
+        // Disabled — div has no native disabled; use tabIndex + aria-disabled
+        const isDisabled = readDisabled();
+        trigger.tabIndex = isDisabled ? -1 : 0;
+        hiddenSelect.disabled = !!isDisabled;
+        if (isDisabled) {
+            trigger.setAttribute('aria-disabled', 'true');
+            wrapper.setAttribute('data-disabled', '');
+        }
+        else {
+            trigger.removeAttribute('aria-disabled');
+            wrapper.removeAttribute('data-disabled');
+        }
+        // Readonly
+        const isReadonly = readReadonly();
+        if (isReadonly) {
+            trigger.setAttribute('aria-readonly', 'true');
+            wrapper.setAttribute('data-readonly', '');
+        }
+        else {
+            trigger.removeAttribute('aria-readonly');
+            wrapper.removeAttribute('data-readonly');
+        }
+        // Error / success state, icons, shake, pop, helper/error text swap
+        applyFormState({ wrapper, control: trigger, stateIconEl, helperEl, errorMsgEl }, { readError, readErrorMessage, readSuccess }, { helperId, errorMsgId }, { shakeClass: 'ui-select-shake', iconPrefix: 'ui-select-state-icon' }, formTracker);
+        // Loading — announce state change to screen readers via live region
+        const isLoading = readLoading();
+        wrapper.classList.toggle('ui-select-loading', !!isLoading);
+        if (isLoading) {
+            trigger.setAttribute('aria-busy', 'true');
+            chevronEl.hidden = true;
+            if (liveRegion)
+                liveRegion.textContent = 'Loading';
+        }
+        else {
+            trigger.removeAttribute('aria-busy');
+            chevronEl.hidden = false;
+            if (liveRegion && liveRegion.textContent === 'Loading') {
+                liveRegion.textContent = '';
+            }
+        }
+        if (clearBtnEl && isLoading) {
+            clearBtnEl.toggleAttribute('data-hidden', true);
+            clearBtnEl.tabIndex = -1;
+            clearBtnEl.setAttribute('aria-hidden', 'true');
+        }
+        // Close dropdown if disabled/readonly/loading became true while open
+        if (state.isOpen && (isDisabled || isReadonly || isLoading)) {
+            closeDropdown(state, els);
+        }
+        // Re-render options if dropdown is open (reactive options)
+        if (state.isOpen) {
+            renderOptions(state, els, cbs);
+        }
+        formTracker.firstRun = false;
+    };
+    const cleanupEffect = isReactive
+        ? effect(applyState)
+        : (applyState(), undefined);
+    // -- Return ----------------------------------------------------------------
+    const { root, needsContainer: needsWrapper } = wrapFormControl(wrapper, {
+        helperEl,
+        errorMsgEl,
+        containerClass: 'ui-select-wrapper',
+    });
+    return {
+        el: root,
+        destroy: () => {
+            cleanupEffect?.();
+            triggerKeydown.destroy();
+            clearTimeout(state.closeFallbackTimer);
+            document.removeEventListener('click', outsideClickHandler);
+            document.removeEventListener('scroll', scrollRepositionHandler, true);
+            if (scrollRaf)
+                cancelAnimationFrame(scrollRaf);
+            window.removeEventListener('resize', resizeRepositionHandler);
+            window.visualViewport?.removeEventListener('resize', resizeRepositionHandler);
+            document.removeEventListener('pithy:dismiss-popovers', dismissPopoversHandler);
+            trigger.removeEventListener('click', toggleHandler);
+            trigger.removeEventListener('keydown', triggerKeydownHandler);
+            trigger.removeEventListener('focus', focusHandler);
+            wrapper.removeEventListener('focusout', blurHandler);
+            if (searchInput && searchInputHandler) {
+                searchInput.removeEventListener('input', searchInputHandler);
+            }
+            if (searchInput && searchKeydownHandler) {
+                searchInput.removeEventListener('keydown', searchKeydownHandler);
+            }
+            listbox.removeEventListener('click', listboxClickHandler);
+            if (clearBtnEl && clearClickHandler) {
+                clearBtnEl.removeEventListener('click', clearClickHandler);
+            }
+            if (clearBtnEl && clearKeydownHandler) {
+                clearBtnEl.removeEventListener('keydown', clearKeydownHandler);
+            }
+            cleanupFormState(wrapper, stateIconEl, formTracker);
+            // Dropdown was portaled to <body> in openDropdown — release explicitly.
+            dropdown.remove();
+            wrapper.replaceChildren();
+            if (needsWrapper) {
+                root.replaceChildren();
+            }
+        },
+    };
+}
+//# sourceMappingURL=Select.js.map

package/dist/atoms/forms/select/Select.js.map

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

package/dist/atoms/forms/select/select-dropdown.d.ts

@@ -0,0 +1,49 @@
+/** @codex { "id": "pithy.ui-kit.select-dropdown", "title": "Select Dropdown State", "category": "feature" } */
+/**
+ * Dropdown state management for <Select> — open/close, option rendering,
+ * active-descendant tracking, and scroll-into-view.
+ *
+ * @internal — not part of public API. Exports are consumed only by Select.ts.
+ */
+import type { SelectOption } from '../../../shared/select';
+export interface DropdownState {
+    isOpen: boolean;
+    activeIndex: number;
+    searchQuery: string;
+    filteredOptions: SelectOption[];
+    /** Close-animation fallback timer — cleared on destroy to prevent stale callbacks */
+    closeFallbackTimer?: ReturnType<typeof setTimeout>;
+}
+export interface DropdownElements {
+    wrapper: HTMLElement;
+    trigger: HTMLElement;
+    dropdown: HTMLElement;
+    listbox: HTMLUListElement;
+    emptyEl: HTMLLIElement;
+    searchInput?: HTMLInputElement;
+    chevronEl: HTMLSpanElement;
+    clearBtnEl?: HTMLButtonElement;
+    liveRegion?: HTMLElement;
+}
+export interface DropdownCallbacks {
+    readOptions: () => SelectOption[];
+    readValue: () => string | undefined;
+    readDisabled: () => boolean | undefined;
+    readReadonly: () => boolean | undefined;
+    readLoading: () => boolean | undefined;
+    selectId: string;
+    onChange?: (value: string, option: SelectOption | undefined) => void;
+}
+export declare function renderOptions(state: DropdownState, els: DropdownElements, cbs: DropdownCallbacks): void;
+export declare function selectValue(val: string, opt: SelectOption | undefined, els: DropdownElements, cbs: DropdownCallbacks): void;
+export declare function openDropdown(state: DropdownState, els: DropdownElements, cbs: DropdownCallbacks): void;
+export declare function positionDropdown(els: DropdownElements): void;
+export declare function closeDropdown(state: DropdownState, els: DropdownElements): void;
+export declare function toggleDropdown(state: DropdownState, els: DropdownElements, cbs: DropdownCallbacks): void;
+export declare function moveActive(state: DropdownState, els: DropdownElements, cbs: DropdownCallbacks, delta: number): void;
+/**
+ * Single delegated click handler for the listbox. Attach once to `els.listbox`
+ * instead of per-option listeners — cleaner cleanup and O(1) listener count.
+ */
+export declare function createListboxClickHandler(state: DropdownState, els: DropdownElements, cbs: DropdownCallbacks): (e: MouseEvent) => void;
+//# sourceMappingURL=select-dropdown.d.ts.map

package/dist/atoms/forms/select/select-dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-dropdown.d.ts","sourceRoot":"","sources":["../../../../src/atoms/forms/select/select-dropdown.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAE/G;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,SAAS,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,YAAY,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACxC,YAAY,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACxC,WAAW,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,KAAK,IAAI,CAAC;CACtE;AAID,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,GACrB,IAAI,CAmEN;AAID,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,GACrB,IAAI,CAEN;AAID,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,GACrB,IAAI,CA4CN;AAaD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAuB5D;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,GACpB,IAAI,CA0EN;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,GACrB,IAAI,CAMN;AAyCD,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,MAAM,GACZ,IAAI,CAqBN;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,iBAAiB,GACrB,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAmBzB"}