@1337exp/taoui 5.16.2 → 5.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,73 @@
1
1
  # Changelog
2
2
 
3
+ ## 5.20.0
4
+
5
+ Nothing to migrate; the library does not change.
6
+
7
+ - **Showcase: a section "Contrast & keyboard".** What the README only promised can be tried now. A live look reads the colour roles of this very page from the computed styles and judges every pair with `contrastRatio()` and `apcaContrast()` (the numbers follow the palette and the mode in the header). A pair picker shows the two questions on one colour, with the well-known green `#2ea85c` where WCAG 2 and the eye disagree. A palette lab turns four stops into a whole theme with `applyTaoPalette()` on a preview (or on the page, and takes it off again) and rates the roles it made. A key map lists what the keys do in toolbars, menus, trees and lists, and the numbers the palettes are tested for. Every key line is one a test of the component or its code shows.
8
+ - The section is a frame (`showcase/components/DemoA11y.vue`); each block and its data live apart in `showcase/a11y/`, and `tests/showcase.a11y.test.ts` keeps the roles it reads real and its promises equal to the palette constants.
9
+
10
+ ## 5.19.3
11
+
12
+ A fix; nothing to migrate.
13
+
14
+ - **`TaoCounter`: a fast run of increments no longer leaves empty and half-rolled slots.** A new value that came while the digits were still rolling cut the roll short and piled several digits in one slot. Now the wheels take the next value only when the last digit has landed: the parent already holds the sum of the increments, so the counter rolls once to the latest value, and again if more came during that roll. `aria-label` tells the real value at once. The gate is `createRollGate` in `src/counterRoll.ts`.
15
+
16
+ ## 5.19.2
17
+
18
+ A polish; nothing to migrate.
19
+
20
+ - **`TaoCounter`: the digits roll in turn, not all at once.** All the digits that changed started at the same moment, and `+1337` looked like four wheels jerked together. Now the one on the right goes first and the others follow to the left, 55 ms apart, so they land one after another like an odometer. Only the digits that change take a turn: `1000 → 2000` does not wait for the three that stay. `--tao-counter-stagger` sets the step (`0` brings the old all-at-once back). With `prefers-reduced-motion` the digits change at once. The order is `src/counterRoll.ts`.
21
+
22
+ ## 5.19.1
23
+
24
+ A fix; nothing to migrate.
25
+
26
+ - **`toast()` has no accent bar on the left.** The 5.17.2 bar kept away from the rounded corners, and that left a gap between it and the progress line in the lower left corner. The bar told nothing the icon, the tinted background and the progress line do not: it is gone, and `.tao-toast__accent` with it. The progress line keeps its distance from the corners (`--tao-toast-edge`).
27
+ - Showcase: the buttons in the header of the comments sheet use `icon` (a square of the control height), not an icon in the slot, so the icons sit in the middle.
28
+
29
+ ## 5.19.0
30
+
31
+ Nothing to migrate.
32
+
33
+ - **`TaoDrawer` as a bottom sheet of your own.** A sheet (`side="bottom"`) is pulled down by its grip and header now (`swipeToClose`, on by default): it closes when pulled a third of its height or flung, comes back otherwise, and the backdrop lets go as it goes. The pull starts only from the grip and the header, never from a button or a field in it, so the content still scrolls. It needs `closable`, and if the parent keeps `v-model` open the sheet returns.
34
+ - **`show-close="false"` hides only the cross.** `closable="false"` still means that only the parent closes it (no cross, no backdrop, no Escape, no pull); `showClose` is just the cross, the rest keeps working: a sheet with no cross that is pulled down.
35
+ - **`#header="{ close }"` replaces the whole header** (a title with a counter, a filter, a cross of your own). Name the panel for a screen reader with `aria-label`. The showcase has the comments of a video built from this, with `#footer` as the line to type in.
36
+ - The pull-down is plain pointer events, no dependency on TaoUX; the maths is `src/sheetDrag.ts`.
37
+
38
+ ## 5.18.0
39
+
40
+ One visible change on a phone: a tap no longer flashes.
41
+
42
+ - **No system flash on a tap.** Phone browsers paint a blue (or grey) square over a tapped link or button, and it differs by the shell and fights the theme. `styles.css` sets `-webkit-tap-highlight-color` from the new token `--tao-tap-highlight` (`transparent`) on `<html>`; the property is inherited, so every element gets it. A colour in the token brings a flash of your own back, anywhere in the tree. The kit gives a tap its own feedback instead of leaving it to the system; a row of `TaoList` has none yet, it is next.
43
+
44
+ ## 5.17.2
45
+
46
+ A fix; nothing to migrate.
47
+
48
+ - **`toast()`: a loading toast turns into its result smoothly.** The tone changed at once when the work finished: the bar, the icon and the tinted background jumped from the accent to green or red. Now the colours follow in 0.3 s, the ring gives way to the result icon that comes in, and with `prefers-reduced-motion` nothing is animated.
49
+ - **`toast()`: the accent bar and the progress line are not cut by a large radius.** With `--tao-radius-panel` of 20px and more the curve of the corners cut both marks down to a hair. They keep away from the corners now by 60% of the radius (up to 24px) and have rounded ends, so they lie on the straight part with any radius. `--tao-toast-edge` sets the distance (`0` brings the flush look back). `TaoCard` `stripe` stays clipped by the corners: it is a decoration, the toast marks tell the tone and the time.
50
+
51
+ ## 5.17.1
52
+
53
+ A fix; nothing to migrate.
54
+
55
+ - **`TaoTree` does not loop on a repeated id.** An id is unique in the whole tree. When `load(node)` answered with the same ids at every level (the showcase did: opening `vue` under `node_modules` handed back a `vue`), the node inside its own ancestor sent the walk round in a circle: `RangeError: Maximum call stack size exceeded`. A node whose id is already one of its ancestors is a leaf now. The showcase `load` gives path ids.
56
+ - Inside the repository: `docs/v5-plan.md` (the ideas journal of the 5.0 design) is removed; MIGRATION-5.md no longer points to it.
57
+
58
+ ## 5.17.0
59
+
60
+ Nothing to migrate.
61
+
62
+ - **`TaoFileDrop` `reject` event.** A file that did not pass `accept` was dropped without a word: no `change`, no sign, and the user saw nothing happen. Now `reject` brings the refused files (`File[]`); they are still not in `v-model`, and in a mixed batch the good files go to `change` as before. Say why in your own words (the zone does not guess a message). The `accept` matching moved to `src/fileAccept.ts` with tests. Found by Next Up.
63
+
64
+ ## 5.16.3
65
+
66
+ A fix; nothing to migrate.
67
+
68
+ - **`TaoDivider` follows the theme.** The solid and dashed line read the primitive `--tao-gray-300`, the one thing a component must not read, so a theme or a palette could not recolour it. It reads `--tao-color-text-muted` now (the same grey in the dark theme, a little darker in the light one), at the same 20% opacity.
69
+ - Inside the repository: `tests/component-styles.test.ts` holds that a component reads roles and not primitives, writes no colour of its own, and adds no spacing pixels beyond the recorded ones; the rules in `CONTRIBUTING.md` are regrouped (colour, then component rules).
70
+
3
71
  ## 5.16.2
4
72
 
5
73
  A fix; nothing to migrate.
@@ -230,7 +298,7 @@ Two small additions, nothing to migrate.
230
298
 
231
299
  ## 5.0.0
232
300
 
233
- A foundation release: shared mechanisms instead of per-component copies, and a clean API. Everything deprecated since 2.0 is removed, so read [MIGRATION-5.md](MIGRATION-5.md) first. Why and how: `docs/v5-plan.md`.
301
+ A foundation release: shared mechanisms instead of per-component copies, and a clean API. Everything deprecated since 2.0 is removed, so read [MIGRATION-5.md](MIGRATION-5.md) first.
234
302
 
235
303
  In numbers: the tarball is 329 KB (560 KB before the ESM-only build), 451 tests (183 before), one floating-panel engine instead of eight copies, 27 built-in icons instead of three icon mechanisms, one tone mechanism instead of six. TaoUX 0.2.0 and taofx follow it.
236
304
 
package/MIGRATION-5.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  5.0 is a deliberate breaking release: shared mechanisms instead of per-component copies (one tone, one floating-panel
4
4
  engine, one icon set), and everything that 2.0 deprecated is deleted. Nothing is hidden behind a warning any more, so
5
- go through this page once. The reasons are in `docs/v5-plan.md`; the short list is in [CHANGELOG.md](CHANGELOG.md).
5
+ go through this page once. The short list is in [CHANGELOG.md](CHANGELOG.md).
6
6
 
7
7
  ## The quick pass
8
8
 
package/README.md CHANGED
@@ -28,7 +28,7 @@
28
28
 
29
29
  - **Tokens first.** Colours, radii, spacing and type come from CSS variables in three layers (primitives, semantic, theme). Re-theme the kit, or one panel of it, without touching a component. Size and density are contexts too: set them once on a panel and everything inside follows.
30
30
  - **Palettes.** Seven ready palettes built from four colours each, or your own at run time (`applyTaoPalette`). The status colours step away from the accent by themselves, and the charts recolour with the theme.
31
- - **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white.
31
+ - **Contrast you can trust.** The colour pairs of the themes and palettes are checked by tests against WCAG 2 (4.5:1 for text, 3:1 for a label on a fill); APCA picks whether a label is dark or white. The showcase section **Contrast & keyboard** measures the page you are on, lets you build a palette from four stops with `applyTaoPalette()`, and lists what the keys do.
32
32
  - **Adapts without JS.** `TaoNav` turns from a bottom bar into a rail and a side panel, the bento grid reflows, the main action moves with the navigation — by the width of their own container (container queries), not of the window. Nothing jumps after hydration.
33
33
  - **Keyboard and screen readers.** Menus, the menu bar, the toolbar, the tree and the navigation follow the WAI-ARIA patterns: one Tab stop and arrows inside (roving tabindex), `aria-pressed` toggles, `role="meter"`, focus traps in overlays.
34
34
  - **Charts the honest way.** Small `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` for cards and lines of text; for real charts `taoChartTheme()` hands the theme colours to Chart.js, ECharts or uPlot.
@@ -59,7 +59,7 @@
59
59
  - **TaoInput** — text field with v-model, validation, and `#prefix` / `#suffix` slots (icon or text inside the frame); `variant` `outline` / `filled` / `plain` (no frame: an item of a list being edited; `TaoInputNumber`, `TaoCombobox` and `TaoTextarea` take it too)
60
60
  - **TaoInputGroup** — outer glue: `#before` | field | `#after` (protocol, unit, button)
61
61
  - **TaoModal** — modal with animation and slots; `fullscreen` (or `fullscreen="narrow"`: a page on a phone, a dialog on a computer); `surface="grain"` / `"glass"`, class and attributes on the dialog panel; the content scrolls under a header and a footer that stay
62
- - **TaoDrawer** — side panel (filters, settings), or a bottom sheet with `side="bottom"`. Esc, backdrop click, focus trap — same as the modal; `surface`, class and attributes on the panel
62
+ - **TaoDrawer** — side panel (filters, settings), or a bottom sheet with `side="bottom"`. Esc, backdrop click, focus trap — same as the modal; `surface`, class and attributes on the panel. The sheet is pulled down by its grip and header (`swipeToClose`); `show-close="false"` hides only the cross, `#header` is a header of your own
63
63
  - **TaoSpoiler** — disclosure. `v-model` and `aria-expanded`. Neighbours do not close each other
64
64
  - **TaoSpoilerGroup** — accordion: `v-model` is the open panel key (`null` = all closed); spoilers take `name`. Without `v-model` the group keeps that key itself
65
65
  - **TaoTabs** — tabbed sections
@@ -98,7 +98,7 @@
98
98
  - **TaoSlider** / **TaoRangeSlider** — one thumb (`v-model` is a number) or two (`[from, to]`, `minGap`). Mouse, touch, arrows. `marks` (ticks, numbers, `{ value, label }`), `discrete` for stepped scales, `vertical`, `flat`, `format`; `variant="thin"` is a thin track for seek / volume
99
99
  - **TaoColorPicker** — saturation / brightness square, hue and opacity strips, swatches, eyedropper (where the browser has `EyeDropper`), HEX / RGB / HSL input modes. `v-model` is a hex string; `colorModel()` adapts your own colour storage
100
100
  - **TaoColorInput** — a field with a swatch and the hex text; the picker opens in a popover
101
- - **TaoFileDrop** — drop zone (drag & drop + click). File names listed under the zone, `v-model` is `File[]`. Clearing the whole batch is the parent’s job (`clear-request`)
101
+ - **TaoFileDrop** — drop zone (drag & drop + click). File names listed under the zone, `v-model` is `File[]`. Clearing the whole batch is the parent’s job (`clear-request`); a file that does not fit `accept` comes back in `reject`
102
102
 
103
103
  ### Data display
104
104
 
@@ -637,11 +637,12 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
637
637
  | `tokens/primitives.css` | Raw palette, space / radius / shadow scales (`--tao-orange-400`, `--tao-space-3`…) | Usually no |
638
638
  | `tokens/semantic.css` | Theme-independent roles: radii, shadows, type, motion | Rarely |
639
639
  | `themes/dark.css` | The colour roles of the default (dark) theme: `--tao-color-accent`, `--tao-color-surface`, … | **Yes — this is the theming API** |
640
- | `themes/light.css` | The same roles under `[data-tao-theme="light"]` | Yes, as a sample |
640
+ | `themes/light.css` | The same roles under `[data-tao-mode="light"]` (or the old `[data-tao-theme="light"]`) | Yes, as a sample |
641
641
  | `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` and `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: what a control reads to know its size, colour and material | Rarely |
642
642
  | `base.css` | Global reset (scrollbar, links, box-sizing) | Rarely |
643
643
 
644
- Everything comes in through `@1337exp/taoui/styles.css` (dark and light both: light turns on with `data-tao-theme="light"`).
644
+ Everything comes in through `@1337exp/taoui/styles.css` (dark and light both: light turns on with `data-tao-mode="light"`).
645
+ A tap on a phone paints no system flash over a link or a button: `--tao-tap-highlight` is `transparent` on `<html>`; a colour there brings a flash of your own back.
645
646
  The raw files are importable as `@1337exp/taoui/styles/tokens/primitives.css` and so on.
646
647
 
647
648
  ### Your own theme
package/README.ru.md CHANGED
@@ -28,7 +28,7 @@
28
28
 
29
29
  - **Сначала токены.** Цвета, радиусы, отступы и шрифты — CSS-переменные в три слоя (примитивы, семантика, тема). Перекрасить набор или одну панель можно, не трогая компоненты. Размер и плотность — тоже контексты: задайте их один раз на панели, и всё внутри последует.
30
30
  - **Палитры.** Семь готовых палитр, каждая из четырёх цветов, или своя в рантайме (`applyTaoPalette`). Статусные цвета сами отходят от акцента, а графики перекрашиваются вместе с темой.
31
- - **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA.
31
+ - **Контраст, которому можно верить.** Цветовые пары тем и палитр проверяются тестами по WCAG 2 (4.5:1 для текста, 3:1 для подписи на заливке); тёмной или белой быть подписи, решает APCA. Раздел витрины **Контраст и клавиатура** измеряет страницу, на которой вы стоите, собирает палитру из четырёх стопов через `applyTaoPalette()` и перечисляет, что делают клавиши.
32
32
  - **Подстраивается без JS.** `TaoNav` превращается из нижней панели в рейку и боковую панель, bento-сетка перестраивается, главное действие переезжает вместе с навигацией — по ширине своего контейнера (container queries), а не окна. После гидратации ничего не прыгает.
33
33
  - **Клавиатура и скринридеры.** Меню, полоса меню, панель инструментов, дерево и навигация сделаны по шаблонам WAI-ARIA: одна остановка Tab и стрелки внутри (roving tabindex), переключатели с `aria-pressed`, `role="meter"`, ловушки фокуса в оверлеях.
34
34
  - **Графики по-честному.** Маленькие `TaoSparkline` / `TaoMeter` / `TaoDonut` / `TaoHeatmap` для карточек и строк текста; для настоящих графиков `taoChartTheme()` отдаёт цвета темы в Chart.js, ECharts или uPlot.
@@ -59,7 +59,7 @@
59
59
  - **TaoInput** — поле ввода с поддержкой v-model, валидации и слотов `#prefix` / `#suffix` (иконка или текст внутри рамки); `variant` `outline` / `filled` / `plain` (без рамки: пункт списка в правке; его берут и `TaoInputNumber`, `TaoCombobox`, `TaoTextarea`)
60
60
  - **TaoInputGroup** — склейка снаружи: `#before` | поле | `#after` (протокол, единица, кнопка)
61
61
  - **TaoModal** — модальное окно с анимацией и слотами; `fullscreen` (или `fullscreen="narrow"`: страница на телефоне, окно на компьютере); `surface="grain"` / `"glass"`, класс и атрибуты — на панели окна; прокручивается содержимое под шапкой и подвалом, которые на месте
62
- - **TaoDrawer** — боковая панель (фильтры, настройки) или нижний лист с `side="bottom"`. Esc, клик по фону, ловушка фокуса — как у модалки; `surface`, класс и атрибуты — на панели
62
+ - **TaoDrawer** — боковая панель (фильтры, настройки) или нижний лист с `side="bottom"`. Esc, клик по фону, ловушка фокуса — как у модалки; `surface`, класс и атрибуты — на панели. Лист тянут вниз за ручку и шапку (`swipeToClose`); `show-close="false"` прячет только крестик, `#header` — своя шапка
63
63
  - **TaoSpoiler** — раскрывающийся блок. `v-model` и `aria-expanded`. Несколько подряд сами друг друга не закрывают
64
64
  - **TaoSpoilerGroup** — аккордеон: `v-model` — ключ открытой панели (`null` — все закрыты), у спойлера `name`. Без `v-model` группа помнит ключ сама
65
65
  - **TaoTabs** — вкладки для переключения между секциями контента
@@ -98,7 +98,7 @@
98
98
  - **TaoSlider** / **TaoRangeSlider** — один бегунок (`v-model` — число) или два (`[от, до]`, `minGap`). Мышь, тач, стрелки. `marks` (деления, числа, `{ value, label }`), `discrete` для ступенчатых шкал, `vertical`, `flat`, `format`; `variant="thin"` — тонкий трек для seek / громкости
99
99
  - **TaoColorPicker** — квадрат насыщенности и яркости, полосы тона и прозрачности, образцы, пипетка (где есть `EyeDropper`), режимы ввода HEX / RGB / HSL. `v-model` — строка hex; `colorModel()` подключает ваше собственное хранилище цвета
100
100
  - **TaoColorInput** — поле с образцом и hex-текстом; палитра открывается в поповере
101
- - **TaoFileDrop** — зона загрузки (drag & drop + клик). Список имён под зоной, `v-model` — `File[]`. Очистку всей пачки решает родитель (`clear-request`)
101
+ - **TaoFileDrop** — зона загрузки (drag & drop + клик). Список имён под зоной, `v-model` — `File[]`. Очистку всей пачки решает родитель (`clear-request`); файл, не подошедший под `accept`, приходит в `reject`
102
102
 
103
103
  ### Отображение данных
104
104
 
@@ -638,11 +638,12 @@ tokens/primitives.css → tokens/semantic.css → themes/*.css → contexts/*.cs
638
638
  | `tokens/primitives.css` | Сырая палитра, шкалы отступов/радиусов/теней (`--tao-orange-400`, `--tao-space-3`...) | Обычно нет |
639
639
  | `tokens/semantic.css` | Роли, не зависящие от темы: скругления, тени, шрифт, движение | Редко |
640
640
  | `themes/dark.css` | Цветовые роли темы по умолчанию (dark): `--tao-color-accent`, `--tao-color-surface`, ... | **Да — это и есть API темизации** |
641
- | `themes/light.css` | Те же роли под `[data-tao-theme="light"]` | Да, как образец |
641
+ | `themes/light.css` | Те же роли под `[data-tao-mode="light"]` (или старым `[data-tao-theme="light"]`) | Да, как образец |
642
642
  | `contexts/size.css`, `tone.css`, `surface.css` | `.tao-size-*` и `.tao-density-*`, `.tao-tone-*`, `.tao-surface-*`: что контрол читает, чтобы знать размер, цвет и материал | Редко |
643
643
  | `base.css` | Глобальный reset (скроллбар, ссылки, box-sizing) | Редко |
644
644
 
645
- Всё подключается одним файлом `@1337exp/taoui/styles.css` (и dark, и light: light включается атрибутом `data-tao-theme="light"`).
645
+ Всё подключается одним файлом `@1337exp/taoui/styles.css` (и dark, и light: light включается атрибутом `data-tao-mode="light"`).
646
+ Нажатие на телефоне не даёт системной вспышки поверх ссылки или кнопки: `--tao-tap-highlight` на `<html>` равен `transparent`; свой цвет возвращает вспышку.
646
647
  Сырые файлы доступны как `@1337exp/taoui/styles/tokens/primitives.css` и так далее.
647
648
 
648
649
  ### Как сделать свою тему
package/dist/index.d.ts CHANGED
@@ -815,6 +815,7 @@ list: boolean;
815
815
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
816
816
  change: (files: File[]) => void;
817
817
  "update:modelValue": (files: File[]) => void;
818
+ reject: (files: File[]) => void;
818
819
  "clear-request": () => void;
819
820
  }, string, PublicProps, Readonly<ExtractPropTypes<__VLS_WithDefaults_31<__VLS_TypePropsToRuntimeProps_35<Props_15>, {
820
821
  modelValue: () => never[];
@@ -825,6 +826,7 @@ list: boolean;
825
826
  }>>> & Readonly<{
826
827
  onChange?: ((files: File[]) => any) | undefined;
827
828
  "onUpdate:modelValue"?: ((files: File[]) => any) | undefined;
829
+ onReject?: ((files: File[]) => any) | undefined;
828
830
  "onClear-request"?: (() => any) | undefined;
829
831
  }>, {
830
832
  list: boolean;
@@ -2756,13 +2758,31 @@ side?: "left" | "right" | "bottom";
2756
2758
  * стекло (сплошное, где размытия нет).
2757
2759
  */
2758
2760
  surface?: TaoSurface;
2761
+ /**
2762
+ * The user can close it: the cross, a click on the backdrop, Escape and the pull-down of a sheet. `false`: only the
2763
+ * parent closes it.
2764
+ * Пользователь может его закрыть: крестик, клик по подложке, Escape и жест «потянуть вниз» у листа. `false`: закрывает только родитель.
2765
+ */
2759
2766
  closable?: boolean;
2767
+ /**
2768
+ * The cross in the header. `false` hides only the cross: the backdrop, Escape and the pull-down still close it.
2769
+ * Крестик в шапке. `false` прячет только крестик: подложка, Escape и жест «вниз» по-прежнему закрывают.
2770
+ */
2771
+ showClose?: boolean;
2772
+ /**
2773
+ * `side="bottom"`: the sheet is pulled down by its grip and header, and closes when pulled far enough or flung; it
2774
+ * comes back otherwise. Needs `closable`.
2775
+ * `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
2776
+ */
2777
+ swipeToClose?: boolean;
2760
2778
  closeLabel?: string;
2761
2779
  }>, {
2762
2780
  title: string;
2763
2781
  side: string;
2764
2782
  surface: string;
2765
2783
  closable: boolean;
2784
+ showClose: boolean;
2785
+ swipeToClose: boolean;
2766
2786
  }>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
2767
2787
  close: (...args: any[]) => void;
2768
2788
  "update:modelValue": (...args: any[]) => void;
@@ -2783,13 +2803,31 @@ side?: "left" | "right" | "bottom";
2783
2803
  * стекло (сплошное, где размытия нет).
2784
2804
  */
2785
2805
  surface?: TaoSurface;
2806
+ /**
2807
+ * The user can close it: the cross, a click on the backdrop, Escape and the pull-down of a sheet. `false`: only the
2808
+ * parent closes it.
2809
+ * Пользователь может его закрыть: крестик, клик по подложке, Escape и жест «потянуть вниз» у листа. `false`: закрывает только родитель.
2810
+ */
2786
2811
  closable?: boolean;
2812
+ /**
2813
+ * The cross in the header. `false` hides only the cross: the backdrop, Escape and the pull-down still close it.
2814
+ * Крестик в шапке. `false` прячет только крестик: подложка, Escape и жест «вниз» по-прежнему закрывают.
2815
+ */
2816
+ showClose?: boolean;
2817
+ /**
2818
+ * `side="bottom"`: the sheet is pulled down by its grip and header, and closes when pulled far enough or flung; it
2819
+ * comes back otherwise. Needs `closable`.
2820
+ * `side="bottom"`: лист тянут вниз за ручку и шапку; он закрывается, если утянут далеко или брошен, иначе возвращается. Нужен `closable`.
2821
+ */
2822
+ swipeToClose?: boolean;
2787
2823
  closeLabel?: string;
2788
2824
  }>, {
2789
2825
  title: string;
2790
2826
  side: string;
2791
2827
  surface: string;
2792
2828
  closable: boolean;
2829
+ showClose: boolean;
2830
+ swipeToClose: boolean;
2793
2831
  }>>> & Readonly<{
2794
2832
  onClose?: ((...args: any[]) => any) | undefined;
2795
2833
  "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
@@ -2798,6 +2836,8 @@ title: string;
2798
2836
  surface: TaoSurface;
2799
2837
  closable: boolean;
2800
2838
  side: "left" | "right" | "bottom";
2839
+ showClose: boolean;
2840
+ swipeToClose: boolean;
2801
2841
  }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
2802
2842
 
2803
2843
  declare const __VLS_component_66: DefineComponent<ExtractPropTypes<__VLS_WithDefaults_72<__VLS_TypePropsToRuntimeProps_77<{
@@ -4007,6 +4047,9 @@ declare function __VLS_template_64(): {
4007
4047
  };
4008
4048
 
4009
4049
  declare function __VLS_template_65(): {
4050
+ header?(_: {
4051
+ close: typeof close_2;
4052
+ }): any;
4010
4053
  "close-icon"?(_: {}): any;
4011
4054
  default?(_: {}): any;
4012
4055
  footer?(_: {}): any;
@@ -5685,6 +5728,8 @@ export declare function apcaContrast(text: string, background: string): number;
5685
5728
  */
5686
5729
  export declare function applyTaoPalette(def: TaoPaletteDef, mode: TaoPaletteMode, el?: HTMLElement): () => void;
5687
5730
 
5731
+ declare function close_2(): void;
5732
+
5688
5733
  /** Способ ввода цвета в палитре: строка hex, числа RGB или числа HSL. */
5689
5734
  export declare type ColorMode = 'hex' | 'rgb' | 'hsl';
5690
5735