/** * Спільний стильовий контракт усіх полів вводу. * * Це «cva без залежностей»: розміри, стани, панель випадайки, лейбл і текст * помилки живуть в одному місці, тож UiInput, UiTextarea, UiSelect і * UiMultiSelect лишаються візуально однаковими без копіювання довгих рядків * класів по компонентах. * * Чому не cva чи tailwind-variants: увесь потрібний функціонал — це пошук * у Record і склеювання рядків. Заради нього не варто вводити залежність, * яку доведеться тягнути в кожен проєкт разом із компонентом. * * Мобільні розміри вищі за десктопні (h-12 → md:h-9) — нижче 44px палець * промахується. Ієрархія розмірів на телефоні лишається в шрифті та * паддінгу, бо різна ВИСОТА полів пальцю нічого не дає. */ export type FieldSize = 'sm' | 'md' | 'lg' /* * Текст поля на мобільному — 16px у ПІКСЕЛЯХ, а не `text-base`. * * Корінь документа 15px, тож `text-base` (1rem) дає 15px, а iOS Safari при * фокусі на поле з font-size < 16px АВТОМАТИЧНО зумує сторінку. Так і * жилося: коментарі й документація обіцяли 16px, а кожне поле на iPhone * зумувало. rem тут не годиться саме тому, що він прив'язаний до кореня, * який бібліотека свідомо зменшила. `md:` повертає щільні десктопні розміри. * * Експортується окремо: складені поля (UiTagInput) і пошук у випадайці * мусять тримати той самий поріг, не маючи власного fieldClass. */ export const fieldTextSizes: Record = { sm: 'text-[16px] md:text-xs', md: 'text-[16px] md:text-sm', lg: 'text-[16px] md:text-base', } /* ------------------------------------------------------------------ */ /* Базове поле / тригер */ /* ------------------------------------------------------------------ */ /* * Фокус — межа акцентного кольору плюс м'яке кільце 3px на 30% альфи, а не * суцільне кільце 2px. Суцільне кільце на полі з межею читається як подвійна * рамка; м'яке — як «підсвітка», і при цьому лишається видимим (межа стає * акцентною — саме вона несе контраст). Наведення підсилює межу — поле має * відповідати на курсор ще до кліку. */ const fieldBase = 'w-full rounded-control border border-line bg-input text-ink placeholder:text-muted transition-[border-color,box-shadow,background-color] ' + 'not-disabled:hover:border-line-strong ' + 'focus:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/30 focus-visible:border-accent-solid focus-visible:hover:border-accent-solid' /* * Мобільні розміри ДОВЖЕ, а не вище: 45px (h-12 за кореня 15px) — це * фактичний мінімум цільової зони дотику, тож поля на телефоні рівно на * 44–45px і не «ховаються» під пальцем. Десктопні висоти повертає `md:`. * * `sm` на мобільному теж тримає 16px тексту (див. fieldTextSizes): з * `text-xs` iOS зумував би кожну форму з діалогом вибору. */ const fieldSizes: Record = { sm: `h-12 md:h-8 ${fieldTextSizes.sm}`, md: `h-12 md:h-9 ${fieldTextSizes.md}`, lg: `h-13 md:h-10 ${fieldTextSizes.lg}`, } /* * Горизонтальний паддінг живе окремо від решти розміру — і по одному класу * на бік. * * Причина суто в порядку правил у згенерованому CSS: `md:px-2.5` лежить у * медіазапиті, тобто НИЖЧЕ за будь-який базовий `pr-9`, дописаний через * extra. Специфічність однакова, тож на ≥768px розмір мовчки з'їдав місце, * зарезервоване під іконку: `pr-9` (36px) перетворювався на 9.375px, і текст * — а в UiMultiSelect лічильник обраних — наїжджав на шеврон. На мобільному * все виглядало правильно, тому баг і жив непоміченим. * * Лікується не «перебиванням», а відсутністю: бік, який зайняла іконка, * взагалі не отримує паддінг від розміру (див. padLeft/padRight у * fieldClass), тож конкурувати в медіазапиті нема з чим. */ const fieldPadLeft: Record = { sm: 'pl-2.5 md:pl-2', md: 'pl-3 md:pl-2.5', lg: 'pl-3.5 md:pl-3', } const fieldPadRight: Record = { sm: 'pr-2.5 md:pr-2', md: 'pr-3 md:pr-2.5', lg: 'pr-3.5 md:pr-3', } const fieldDisabled = 'opacity-50 cursor-not-allowed' const fieldError = 'border-danger not-disabled:hover:border-danger focus-visible:ring-danger/30 focus-visible:border-danger focus-visible:hover:border-danger' /* * Складене поле — обгортка, всередині якої живе справжній (мітки, * чіпи). Той самий контракт, що й fieldBase, але фокус приходить через * focus-within: сама обгортка фокуса не отримує, і з focus-visible кільце * не з'явилося б ніколи. Без спільного класу UiTagInput мав власне суцільне * кільце з відступом, яке в стані помилки лишалося синім. */ const fieldShellBase = 'w-full rounded-control border bg-input text-ink transition-[border-color,box-shadow,background-color] focus-within:ring-[3px]' const fieldShellIdle = 'border-line focus-within:ring-ring/30 focus-within:border-accent-solid focus-within:hover:border-accent-solid' const fieldShellError = 'border-danger focus-within:ring-danger/30' /* ------------------------------------------------------------------ */ /* Лейбл / підказка / помилка */ /* ------------------------------------------------------------------ */ export const labelClass = 'block text-sm font-medium text-ink mb-1' export const errorTextClass = 'mt-1 text-sm text-danger' export const helperTextClass = 'mt-1 text-sm text-muted' /* ------------------------------------------------------------------ */ /* Панель випадайки */ /* */ /* z-[1100] не випадкове: overlay-стек роздає шари з кроком 10 від */ /* 1000, тож перші ~10 оверлеїв лишаються НИЖЧЕ за випадайку. */ /* Без цього селект усередині модалки був би перекритий її панеллю. */ /* ------------------------------------------------------------------ */ /* * Панель завжди телепортована в і позиціонується `fixed` у * координатах вікна — top, left, ширину й max-height ставить * dropdownPanelStyle з utils/overlayPosition. Раніше тут був `absolute`: * UiTagInput, що не перебивав position інлайном, на прокрученій сторінці * відкривав підказки на висоту прокрутки ВИЩЕ поля, тобто за екраном. * * overscroll-contain: докрутивши список до кінця, палець інакше * прокручував сторінку під ним — поле від'їжджало, а панель їхала слідом. */ export const dropdownPanelClass = 'fixed z-[1100] max-h-80 overflow-y-auto overscroll-contain scrollbar-thin rounded-control origin-top ' + 'border border-line bg-dropdown shadow-overlay' export const dropdownEmptyClass = 'px-3 py-2 text-center text-sm text-muted' // Пошук усередині панелі — теж поле вводу: 13px на телефоні зумував би // сторінку щоразу, коли панель відкривається й віддає йому фокус. export const dropdownSearchInputClass = `w-full rounded-control border border-line bg-input px-2 py-1.5 ${fieldTextSizes.md} text-ink transition-[border-color,box-shadow] ` + 'placeholder:text-muted focus:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/30 focus-visible:border-accent-solid' /* ------------------------------------------------------------------ */ /* Дрібні кнопки всередині полів (очистити / видалити / показати) */ /* ------------------------------------------------------------------ */ /* * Невидима зона дотику 45×45 (h-12 за кореня 15px) навколо дрібної кнопки. * * Кнопка лишається 26px, щоб не роздувати поле, а палець влучає в 45. * Зона позиціонується відносно самої кнопки, тож `relative` чи `absolute` * додає місце використання: два position в одному рядку сперечалися б * порядком згенерованого CSS, а не порядком у рядку. */ export const touchTargetClass = "pointer-coarse:after:absolute pointer-coarse:after:left-1/2 pointer-coarse:after:top-1/2 pointer-coarse:after:h-12 pointer-coarse:after:w-12 pointer-coarse:after:-translate-x-1/2 pointer-coarse:after:-translate-y-1/2 pointer-coarse:after:content-['']" /* * Одна кнопка очищення на всю бібліотеку. Поки кожне поле малювало свою, * вони розійшлися на 19, 26, 30 і 34px — і жодна не дотягувала до 44px на * дотику. */ export const clearButtonClass = 'flex h-7 w-7 shrink-0 items-center justify-center rounded-control text-muted transition-colors ' + 'hover:bg-hover hover:text-ink focus:outline-none focus-visible:ring-2 focus-visible:ring-ring ' + touchTargetClass /* ------------------------------------------------------------------ */ /* Пункти випадайки */ /* ------------------------------------------------------------------ */ /* * На телефоні кожен пункт — 45px+ заввишки (py-3 + рядок 16px), незалежно * від розміру поля. Пункти стоять впритул один до одного, тож невидима * зона ::after тут не допоможе — вона накрила б сусідній пункт. Раніше * `md` давав 37.5px, а `sm` — 30px: пальцем обирали сусідній рядок. * Текст — той самий 16px, що й у полі над списком. `md:` повертає * десктопну щільність. */ const itemSizes: Record = { sm: `px-2.5 py-3 md:px-2 md:py-1.5 ${fieldTextSizes.sm}`, md: `px-3 py-3 md:py-2 ${fieldTextSizes.md}`, lg: `px-3 py-3 md:py-2.5 ${fieldTextSizes.lg}`, } export const itemBase = 'cursor-pointer transition-colors text-ink' /* * Пункт меню — UiMenu, UiContextMenu, UiSplitButton і пункти, які * споживач пише в слот `content`. Та сама логіка висоти, що й у пункту * випадайки: 45px на телефоні, щільно на десктопі. Колір тексту НЕ входить * (`text-ink` чи `text-danger` додає місце використання): два класи кольору * на одному елементі сперечалися б порядком у згенерованому CSS. */ export const menuItemClass = 'flex w-full items-center gap-2 px-3 py-3 text-left text-base transition-colors ' + 'hover:bg-hover active:bg-hover focus:outline-none focus-visible:bg-hover focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring ' + 'disabled:cursor-not-allowed disabled:opacity-50 aria-disabled:cursor-not-allowed aria-disabled:opacity-50 ' + 'md:py-2 md:text-sm' export const itemHover = 'hover:bg-hover' export const itemHighlighted = 'bg-primary-50 text-accent' export const itemSelected = 'font-medium' /* ------------------------------------------------------------------ */ /* Іконки (шеврон / очистити / галочка) */ /* ------------------------------------------------------------------ */ const iconSizes: Record = { sm: 'w-3.5 h-3.5', md: 'w-4 h-4', lg: 'w-5 h-5', } /* ------------------------------------------------------------------ */ /* Анімація випадайки */ /* */ /* Об'єкт розкладається прямо в , тож усі */ /* випадайки анімуються однаково без жодного спільного CSS. */ /* ------------------------------------------------------------------ */ export const dropdownTransitionProps = { enterActiveClass: 'transition duration-150 ease-out', enterFromClass: 'scale-[0.97] -translate-y-1 opacity-0', enterToClass: 'scale-100 translate-y-0 opacity-100', leaveActiveClass: 'transition duration-100 ease-in', leaveFromClass: 'scale-100 translate-y-0 opacity-100', leaveToClass: 'scale-[0.97] -translate-y-1 opacity-0', } /* ------------------------------------------------------------------ */ /* Складені хелпери */ /* ------------------------------------------------------------------ */ /** Повний рядок класів базового поля або тригера. */ export function fieldClass( size: FieldSize, opts?: { error?: boolean disabled?: boolean /** * Паддінг зліва/справа замість типового для розміру — місце під іконку, * кнопку очищення чи степери. * * Передається готовим класом (`'pr-9'`), а не числом: Tailwind сканує * вихідний код, і класу, склеєного в рантаймі з `pr-${n}`, у бандлі * просто не буде. */ padLeft?: string padRight?: string extra?: string }, ): string { const classes = [ fieldBase, fieldSizes[size], opts?.padLeft || fieldPadLeft[size], opts?.padRight || fieldPadRight[size], ] if (opts?.error) classes.push(fieldError) if (opts?.disabled) classes.push(fieldDisabled) if (opts?.extra) classes.push(opts.extra) return classes.join(' ') } /** Обгортка складеного поля: межа, фон і фокус через focus-within. */ export function fieldShellClass(opts?: { error?: boolean; disabled?: boolean }): string { const classes = [fieldShellBase, opts?.error ? fieldShellError : fieldShellIdle] if (opts?.disabled) classes.push(fieldDisabled) else if (!opts?.error) classes.push('hover:border-line-strong') return classes.join(' ') } /** * Розводить fallthrough-атрибути поля: `class` і `style` — на кореневу * обгортку (відступи й ширина в сітці форми), решта — на нативний контрол. * * Без цього `aria-label`, `maxlength`, `inputmode`, `autofocus` осідали на * `
` навколо поля: поле без видимого лейбла лишалося без доступної * назви, а бібліотека сама обходила це селектором `[data-…] input`. * * Читається всередині computed: proxy `useAttrs()` відстежує звертання, тож * нові атрибути від батька перераховують розподіл. */ export function splitFieldAttrs(attrs: Record): { root: Record control: Record } { const { class: rootClass, style: rootStyle, ...control } = attrs return { root: { class: rootClass, style: rootStyle }, control } } /** Класи пункту списку у випадайці. */ export function itemClass(size: FieldSize): string { return `${itemBase} ${itemSizes[size]} ${itemHover}` } /** Клас розміру іконки. */ export function iconClass(size: FieldSize): string { return iconSizes[size] }