altum 0.0.5 → 0.0.7

package/docs/LAYOUT.md

@@ -32,7 +32,7 @@ import {
 | Чипы / теги / мелкие кнопки в ряд с переносом | **Inline** |
 | Слева заголовок, справа действия | **Split** |
 | Поля + Chip + Button в одной строке фильтров | **ControlRow** |
-| Одному ребёнку — `flex: 1` или «не сжимать» | **LayoutItem** (`ControlRow.Item` / `Layout.Item`) |
+| Одному ребёнку — `flex: 1` или «не сжимать» | **LayoutItem** (`ControlRow.Item`) |
 | Колонки сетки | **Grid** |
 | Оболочка input (label / prefix / clear) | **TextField** |
 
@@ -58,7 +58,7 @@ import {
 
 | Часть | Роль | Ключевые пропсы |
 |-------|------|-----------------|
-| `Layout` | Корень-scrollport (`overflow-y: auto`, flex-колонка) | `as` (по умолчанию `div`) |
+| `Layout` | Корень-scrollport (`overflow-y: auto`, flex-колонка) | `as`, `padding` (отступ корня), `gap` (между секциями). Оба: `sm` 12px, `md` 16px, `lg` 24px |
 | `Layout.Header` | Шапка | `sticky`, `as="header"` |
 | `Layout.Content` | Середина (без собственного overflow) | `as` |
 | `Layout.Footer` | Низ с действиями | `sticky`, `align` (`start` \| `center` \| `end` \| `space-between`), `as="footer"` |
@@ -100,11 +100,11 @@ import {
 </Layout>
 ```
 
-### Namespace
+### Состав объекта
 
-На `Layout` также висят алиасы: `Layout.Inline`, `.Split`, `.ControlRow`, `.Item`.
+На `Layout` висят только `Layout.Header`, `Layout.Content` и `Layout.Footer`.
 
-В приложении предпочтительны **именованные импорты**; `Layout.*` удобен, когда вы уже внутри панели.
+`Inline`, `Split`, `ControlRow` и `LayoutItem` — отдельные компоненты, их импортируют по имени.
 
 Также экспортируются: `LayoutRoot`, `LayoutHeader`, `LayoutContent`, `LayoutFooter`.
 
@@ -228,7 +228,7 @@ Flex-ячейка внутри Stack / Inline / Split / ControlRow.
 | `grow` | `false` | `flex: 1` — занять оставшееся место |
 | `shrink` | `true` | `false` — кнопка/чип не сжимаются |
 
-Алиасы: `ControlRow.Item`, `Layout.Item`.
+Алиас: `ControlRow.Item`.
 
 **Использовать:** поле поиска растягивается, кнопка — по контенту; иконка/чип с `shrink={false}`.
 

package/docs/THEMING.md

@@ -72,7 +72,7 @@ return (
 | `--altum-field-width-default` | Макс. ширина поля при `width="md"` (320px) |
 | `--altum-badge-size-sm` / `md` / `--altum-badge-font-size` / `--altum-badge-font-size-sm` | Компактный chrome счётчика (Badge / Tabs); sm-кегль для числового standalone |
 | `--altum-g-space-1` … `--altum-g-space-9` | Шкала отступов (4px … 36px) |
-| `--altum-shadow-sm` / `--altum-shadow-md` / `--altum-shadow-lg` | Лестница теней (алиасы `--altum-shadow-surface` / `--altum-shadow-dropdown` / deep) |
+| `--altum-shadow-surface` / `--altum-shadow-dropdown` / `--altum-shadow-lg` | Тени карточки, выпадающего слоя и глубокого возвышения |
 
 ### Типографика
 
@@ -97,15 +97,9 @@ return (
 
 | Переменная | По умолчанию | Назначение |
 |------------|--------------|------------|
-| `--altum-dialog-header-padding` | асимметричный `--altum-g-space-4` / `--altum-g-space-3` | Шапка Modal / Sheet |
-| `--altum-dialog-body-padding` | `--altum-g-space-4` | Тело Modal / Sheet |
-| `--altum-dialog-footer-padding` | асимметричный футер | Футер Modal / Sheet |
-| `--altum-dialog-title-size` | `--altum-g-font-size-lg` | Заголовок диалога |
-| `--altum-dialog-title-weight` | `--altum-g-font-weight-semibold` | Начертание заголовка |
 | `--altum-dialog-body-size` | `--altum-g-font-size-base` | Текст тела диалога |
-| `--altum-dialog-max-width-sm` / `md` / `lg` | 420 / 500 / 600 | Modal / Sheet |
+| `--altum-dialog-max-width-md` / `lg` | 500 / 600 | Modal / Sheet |
 | `--altum-dialog-max-height` | 85vh | Максимальная высота Modal |
-| `--altum-list-max-height` | 280px | Область скролла выпадающего списка |
 | `--altum-option-padding-y` / `--altum-option-padding-x` | `--altum-g-space-2` / `--altum-g-space-3` | Внутренние отступы опции списка |
 
 ### Тоггл / фокус / chrome оверлея
@@ -131,7 +125,7 @@ return (
 | `--altum-button-focus-inner` / `--altum-button-focus-outer` | light 1px / 3px; dark 2px / 4px | Ширины двойного кольца кнопки |
 | `--altum-opacity-disabled` | 0.5 | Отключённые контролы; **Button** — та же заливка × opacity |
 | `--altum-field-disabled-opacity` | 0.8 | Chrome отключённого поля (текст остаётся читаемым) |
-| `--altum-field-label-gap` / `--altum-field-message-gap` | `--altum-g-space-1` | Зазор внешнего лейбла / helper+ошибка |
+| `--altum-field-message-gap` | `--altum-g-space-1` | Зазор helper и ошибки |
 | `--altum-form-helper-indent` | `--altum-g-space-1` | Левый отступ helper / ошибки |
 | `--altum-field-placeholder` / `--altum-color-input-placeholder` | `color-mix(… label 88%, transparent)` | Текст плейсхолдера |
 | `--altum-switch-track-width/height/thumb-size-*` | sm/md/lg | Геометрия Switch (из toggle-box + inset) |
@@ -139,7 +133,6 @@ return (
 | `--altum-overlay-close-size` | 28px | Хит-зона закрытия Overlay / Alert / Notification |
 | `--altum-overlay-close-icon-size` | 16px | Кегль × в overlay-close |
 | `--altum-overlay-close-fg` / `--altum-overlay-close-fg-hover` / `--altum-overlay-close-bg` / `--altum-overlay-close-bg-hover` | тема | Голый крестик overlay (Modal / Sheet, `ButtonIcon` `diskClose`); chrome только на hover |
-| `--altum-overlay-arrow-size` | 8px | Стрелка Popover / tooltip |
 | `--altum-badge-overhang` | `space-1` + `control-inset` (6px) | Запас раскладки + смещение overlay-бейджа |
 | `--altum-badge-digit-nudge` | `0.5px` | Сдвиг цифры в круглом **Badge** вниз (оптический центр) |
 | `--altum-slider-track-height` | `3px` | Высота трека **Slider** |
@@ -272,10 +265,10 @@ TextField, Checkbox (`mode="task"`), Switch, Radio. Примитивы — ис
 | Поле | `--altum-color-field-bg`, `--altum-color-field-border`, `--altum-color-border-hover`, `--altum-color-field-text`, `--altum-field-label` |
 | Кнопка (secondary / tinted / ghost) | `--altum-color-button-secondary-bg`, `--altum-color-button-tinted-border`, `--altum-color-button-ghost-text` (muted, не secondary), `--altum-color-button-ghost-hover-bg` |
 | Chip | `--altum-color-chip-secondary-bg`, `--altum-color-chip-tinted-text` |
-| Segmented | `--altum-color-segmented-*`: колодец (`*-track-bg`) + приглушённый thumb (`*-slider-bg`, `--altum-color-segmented-slider-shadow`). Один thumb на secondary / tinted / ghost |
+| Segmented | `--altum-color-segmented-ghost-slider-bg`, `--altum-color-segmented-slider-shadow` |
 | Панель | `--altum-color-panel-bg`, `--altum-color-panel-border`, `--altum-color-panel-bg-hover` |
 | Типографика | `--altum-color-type`, `--altum-color-type-secondary`, `--altum-color-type-tertiary`, `--altum-color-type-muted` (`Title` / `Text`) |
-| Ссылка | `--altum-color-link-color`, `--altum-color-link-secondary`, `--altum-color-link-muted`, `--altum-color-link-danger`, `--altum-color-link-focus-ring` |
+| Ссылка | `--altum-color-link-color`, `--altum-color-link-secondary`, `--altum-color-link-muted`, `--altum-color-link-danger`. Фокус — `--altum-focus-ring-color` |
 | Tooltip | `--altum-color-tooltip-bg` / `--altum-color-tooltip-fg` (инверсия ink, не brand-кнопка) |
 | Индикатор Tabs / Pagination | `--altum-color-tabs-indicator` |
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "altum",
-	"version": "0.0.5",
+	"version": "0.0.7",
 	"description": "Библиотека React + TypeScript UI-компонентов: CSS Modules, токены ThemeProvider, адаптация overlay/sheet.",
 	"license": "MIT",
 	"author": "Alexander <azeeson@gmail.com>",
@@ -73,7 +73,8 @@
 		"lint:css": "stylelint \"src/**/*.css\"",
 		"lint:css:fix": "stylelint \"src/**/*.css\" --fix && node scripts/fix-css-brace-format.mjs && stylelint \"src/**/*.css\" --fix",
 		"lint:css-ownership": "node scripts/audit-css-ownership.mjs",
-		"scaffold": "node scripts/scaffold-component.mjs"
+		"scaffold": "node scripts/scaffold-component.mjs",
+		"catalog": "node scripts/component-catalog.mjs"
 	},
 	"browserslist": [
 		"chrome >= 100",

package/types/entries/icons.d.ts

@@ -105,6 +105,8 @@ declare const IconChevronRight: react.FC<IconProps>;
 
 declare const IconChevronUp: react.FC<IconProps>;
 
+declare const IconChevronUpDown: react.FC<IconProps>;
+
 declare const IconClipboard: react.FC<IconProps>;
 
 declare const IconClock: react.FC<IconProps>;
@@ -411,5 +413,5 @@ declare const IconZoomIn: react.FC<IconProps>;
 
 declare const IconZoomOut: react.FC<IconProps>;
 
-export { IconAlarm, IconAlignCenter, IconAlignJustify, IconAlignLeft, IconAlignRight, IconAnchor, IconArchive, IconArrowDown, IconArrowLeft, IconArrowRight, IconArrowThinDown, IconArrowThinLeft, IconArrowThinRight, IconArrowThinUp, IconArrowUp, IconArticle, IconBackspace, IconBasket, IconBasketball, IconBatteryEmpty, IconBatteryFull, IconBatteryLow, IconBatteryMedium, IconBell, IconBlog, IconBluetooth, IconBold, IconBookmark, IconBookmarks, IconBox, IconBriefcase, IconBrightnessLow, IconBrightnessMax, IconBrightnessMedium, IconBroadcast, IconBrowser, IconBrowserUpload, IconBrush, IconCalendar, IconCamcorder, IconCamera, IconCard, IconCart, IconChecklist, IconCheckmark, IconChevronDown, IconChevronLeft, IconChevronRight, IconChevronUp, IconClipboard, IconClock, IconClockwise, IconCloud, IconCloudDownload, IconCloudUpload, IconCode, IconContract, IconContract2, IconConversation, IconCopy, IconCrop, IconCross, IconCrosshair, IconCutlery, IconDeviceDesktop, IconDeviceMobile, IconDeviceTablet, IconDirection, IconDisc, IconDocument, IconDocumentDelete, IconDocumentEdit, IconDocumentNew, IconDocumentRemove, IconDot, IconDots2, IconDots3, IconDownload, IconDragHandle, IconDuplicate, IconEnter, IconExit, IconExpand, IconExpand2, IconExperiment, IconExport, IconFeed, IconFlag, IconFlashlight, IconFolder, IconFolderOpen, IconForward, IconGaming, IconGear, IconGraduation, IconGraphBar, IconGraphLine, IconGraphPie, IconHeadset, IconHeart, IconHelp, IconHome, IconHourglass, IconInbox, IconInformation, IconItalic, IconJewel, IconLifting, IconLightbulb, IconLink, IconLinkBroken, IconList, IconLoading, IconLocation, IconLock, IconLockOpen, IconMail, IconMap, IconMediaLoop, IconMediaNext, IconMediaPause, IconMediaPlay, IconMediaPrevious, IconMediaRecord, IconMediaShuffle, IconMediaStop, IconMedical, IconMenu, IconMessage, IconMeter, IconMicrophone, IconMinus, IconMonitor, IconMove, IconMusic, IconNetwork1, IconNetwork2, IconNetwork3, IconNetwork4, IconNetwork5, IconPamphlet, IconPaperclip, IconPencil, IconPhone, IconPhoto, IconPhotoGroup, IconPill, IconPin, IconPlus, IconPower, IconPreview, IconPreviewOff, IconPrint, IconPulse, IconQuestion, IconReply, IconReplyAll, IconReturn, IconRetweet, IconRocket, IconScale, IconSearch, IconShoppingBag, IconSkip, IconStack, IconStar, IconStopwatch, IconStore, IconSuitcase, IconSwap, IconTag, IconTagDelete, IconTags, IconThumbsDown, IconThumbsUp, IconTicket, IconTimeReverse, IconToDo, IconToggles, IconTrash, IconTrophy, IconUpload, IconUser, IconUserGroup, IconUserId, IconVibrate, IconViewApps, IconViewList, IconViewListLarge, IconViewThumb, IconVolumeFull, IconVolumeLow, IconVolumeMedium, IconVolumeOff, IconWallet, IconWarning, IconWeb, IconWeight, IconWifi, IconWrong, IconZoomIn, IconZoomOut, createIcon };
+export { IconAlarm, IconAlignCenter, IconAlignJustify, IconAlignLeft, IconAlignRight, IconAnchor, IconArchive, IconArrowDown, IconArrowLeft, IconArrowRight, IconArrowThinDown, IconArrowThinLeft, IconArrowThinRight, IconArrowThinUp, IconArrowUp, IconArticle, IconBackspace, IconBasket, IconBasketball, IconBatteryEmpty, IconBatteryFull, IconBatteryLow, IconBatteryMedium, IconBell, IconBlog, IconBluetooth, IconBold, IconBookmark, IconBookmarks, IconBox, IconBriefcase, IconBrightnessLow, IconBrightnessMax, IconBrightnessMedium, IconBroadcast, IconBrowser, IconBrowserUpload, IconBrush, IconCalendar, IconCamcorder, IconCamera, IconCard, IconCart, IconChecklist, IconCheckmark, IconChevronDown, IconChevronLeft, IconChevronRight, IconChevronUp, IconChevronUpDown, IconClipboard, IconClock, IconClockwise, IconCloud, IconCloudDownload, IconCloudUpload, IconCode, IconContract, IconContract2, IconConversation, IconCopy, IconCrop, IconCross, IconCrosshair, IconCutlery, IconDeviceDesktop, IconDeviceMobile, IconDeviceTablet, IconDirection, IconDisc, IconDocument, IconDocumentDelete, IconDocumentEdit, IconDocumentNew, IconDocumentRemove, IconDot, IconDots2, IconDots3, IconDownload, IconDragHandle, IconDuplicate, IconEnter, IconExit, IconExpand, IconExpand2, IconExperiment, IconExport, IconFeed, IconFlag, IconFlashlight, IconFolder, IconFolderOpen, IconForward, IconGaming, IconGear, IconGraduation, IconGraphBar, IconGraphLine, IconGraphPie, IconHeadset, IconHeart, IconHelp, IconHome, IconHourglass, IconInbox, IconInformation, IconItalic, IconJewel, IconLifting, IconLightbulb, IconLink, IconLinkBroken, IconList, IconLoading, IconLocation, IconLock, IconLockOpen, IconMail, IconMap, IconMediaLoop, IconMediaNext, IconMediaPause, IconMediaPlay, IconMediaPrevious, IconMediaRecord, IconMediaShuffle, IconMediaStop, IconMedical, IconMenu, IconMessage, IconMeter, IconMicrophone, IconMinus, IconMonitor, IconMove, IconMusic, IconNetwork1, IconNetwork2, IconNetwork3, IconNetwork4, IconNetwork5, IconPamphlet, IconPaperclip, IconPencil, IconPhone, IconPhoto, IconPhotoGroup, IconPill, IconPin, IconPlus, IconPower, IconPreview, IconPreviewOff, IconPrint, IconPulse, IconQuestion, IconReply, IconReplyAll, IconReturn, IconRetweet, IconRocket, IconScale, IconSearch, IconShoppingBag, IconSkip, IconStack, IconStar, IconStopwatch, IconStore, IconSuitcase, IconSwap, IconTag, IconTagDelete, IconTags, IconThumbsDown, IconThumbsUp, IconTicket, IconTimeReverse, IconToDo, IconToggles, IconTrash, IconTrophy, IconUpload, IconUser, IconUserGroup, IconUserId, IconVibrate, IconViewApps, IconViewList, IconViewListLarge, IconViewThumb, IconVolumeFull, IconVolumeLow, IconVolumeMedium, IconVolumeOff, IconWallet, IconWarning, IconWeb, IconWeight, IconWifi, IconWrong, IconZoomIn, IconZoomOut, createIcon };
 export type { IconProps };

package/types/entries/locales.d.ts

@@ -98,7 +98,6 @@ declare const ru: {
         readonly page: "Страница {page}";
         readonly summary: "{start}–{end} из {total}";
         readonly pageSizeLabel: "На странице";
-        readonly pageSizeAria: "Размер страницы";
     };
     readonly sortable: {
         readonly moveUp: "Переместить вверх";
@@ -156,7 +155,6 @@ declare const ru: {
         };
     };
     readonly numberField: {
-        readonly group: "Изменить значение";
         readonly decrement: "Уменьшить";
         readonly increment: "Увеличить";
     };
@@ -196,9 +194,6 @@ declare const ru: {
     readonly steps: {
         readonly ariaLabel: "Шаги";
     };
-    readonly segmentedControl: {
-        readonly ariaLabel: "Сегментированный контроль";
-    };
     readonly bubble: {
         readonly expand: "Ещё";
         readonly collapse: "Свернуть";
@@ -273,7 +268,7 @@ interface LocaleContextValue {
     messages: Messages;
     t: TranslateFn;
 }
-declare function useLocale(): LocaleContextValue;
+declare function useLocale(fallback?: MessageTree): LocaleContextValue;
 declare function useT(): TranslateFn;
 
 export { builtInMessages, deepMergeMessages, en, ru, translate, useLocale, useT };

package/types/entries/utils.d.ts

@@ -121,6 +121,7 @@ declare function startOfDay(date: Date): Date;
 declare function addDays(date: Date, days: number): Date;
 declare function isSameDay(a: Date, b: Date): boolean;
 declare function compareDay(a: Date, b: Date): number;
+declare function isExistingLocalDate(year: number, monthIndex: number, day: number): boolean;
 declare function parseLocalDate(value: string): Date | null;
 declare function formatLocalDate(date: Date): string;
 declare function formatHourLabel(hour: number, locale: LocaleCode): string;
@@ -233,5 +234,5 @@ type Density = 'default' | 'compact';
 
 type SurfaceVariant = 'primary' | 'tinted' | 'secondary' | 'ghost' | 'plain';
 
-export { DAY_SECONDS, DEFAULT_DRAG_BLOCKED_SELECTOR, DEFAULT_PORTAL_SELECTOR, HOUR_SECONDS, MINUTE_SECONDS, OVERLAY_Z_INDEX_DEFAULT, OverlayStackProvider, SPACING_TOKEN_CSS, Slot, WEEK_SECONDS, addDays, addToDate, adjustElementHeight, clamp, clampToViewport, cn, compareDay, composeEventHandlers, composeRefs, computeAnchorPosition, defaultListboxFilterFn, elevateAboveOverlayStack, filterListboxOptions, findEnabledListboxIndex, findListboxOption, flattenResolvedListboxGroups, formatAriaKeyShortcuts, formatBytes, formatHourLabel, formatHourTime, formatInTimeZone, formatKeyboardShortcut, formatLocalDate, formatTimezoneLabel, formatTimezoneOffset, getAnchorSideSpace, getBrowserTimezone, getDurationUnitAndValue, getFormControlState, getListboxDisplayValue, getListboxOptionDomId, getListboxOptionText, getListboxPath, getSupportedTimezones, getTextareaMinHeightPx, getTimezoneOffsetMinutes, getTranslateXFromTransform, getWeekDays, getWeekStart, getZonedParts, isDragBlockedTarget, isEditableTarget, isOutsideFormInteraction, isSameDay, isSameZonedDay, isValidTimeZone, liveStatus, localeToBcp47, matchListboxOption, matchesKeyboardShortcut, mergeSlotProps, mergeStyles, moveArrayItem, moveListboxHighlight, parseKeyboardShortcut, parseLocalDate, plural, pluralEn, pluralRu, renderChildren, resolveListboxGroups, resolveOverlayZIndex, resolvePreferredSide, resolveSpacingCss, resolveStackedOverlayZIndex, secondsToUnit, set, startOfDay, toCssSize, toPath, toggleSet, unitToSeconds, useOverlayStackZIndex };
+export { DAY_SECONDS, DEFAULT_DRAG_BLOCKED_SELECTOR, DEFAULT_PORTAL_SELECTOR, HOUR_SECONDS, MINUTE_SECONDS, OVERLAY_Z_INDEX_DEFAULT, OverlayStackProvider, SPACING_TOKEN_CSS, Slot, WEEK_SECONDS, addDays, addToDate, adjustElementHeight, clamp, clampToViewport, cn, compareDay, composeEventHandlers, composeRefs, computeAnchorPosition, defaultListboxFilterFn, elevateAboveOverlayStack, filterListboxOptions, findEnabledListboxIndex, findListboxOption, flattenResolvedListboxGroups, formatAriaKeyShortcuts, formatBytes, formatHourLabel, formatHourTime, formatInTimeZone, formatKeyboardShortcut, formatLocalDate, formatTimezoneLabel, formatTimezoneOffset, getAnchorSideSpace, getBrowserTimezone, getDurationUnitAndValue, getFormControlState, getListboxDisplayValue, getListboxOptionDomId, getListboxOptionText, getListboxPath, getSupportedTimezones, getTextareaMinHeightPx, getTimezoneOffsetMinutes, getTranslateXFromTransform, getWeekDays, getWeekStart, getZonedParts, isDragBlockedTarget, isEditableTarget, isExistingLocalDate, isOutsideFormInteraction, isSameDay, isSameZonedDay, isValidTimeZone, liveStatus, localeToBcp47, matchListboxOption, matchesKeyboardShortcut, mergeSlotProps, mergeStyles, moveArrayItem, moveListboxHighlight, parseKeyboardShortcut, parseLocalDate, plural, pluralEn, pluralRu, renderChildren, resolveListboxGroups, resolveOverlayZIndex, resolvePreferredSide, resolveSpacingCss, resolveStackedOverlayZIndex, secondsToUnit, set, startOfDay, toCssSize, toPath, toggleSet, unitToSeconds, useOverlayStackZIndex };
 export type { AnchorAlign, AnchorPositionResult, AnchorPositionStyle, AnchorSide, DateAddUnit, Density, DurationUnit, DurationUnitValue, EnrichedThroughChild, EnrichedThroughFn, GroupGap, KeyboardShortcutParts, ListboxFilterFn, ListboxGroup, ListboxOption, OverlayZIndexTier, PluralForms, PossibleRef, PropertyPath, RenderChildrenFn, RenderChildrenOptions, ResolvedListboxGroup, SlotProps, SpacingToken, SpacingValue, SurfaceVariant, WeekStartsOn, WithEnrichedChildren, ZonedDateParts };