@koslibs/components 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @koslibs/components
 
+## 1.4.0
+
+### Minor Changes
+
+- [#5](https://github.com/koslibs/components/pull/5) [`68d3460`](https://github.com/koslibs/components/commit/68d34608d599582acf4115d31f64fb0168213edb) Thanks [@holypower777](https://github.com/holypower777)! - Перенесён Modal из GullEye core-components с Header, Content, Footer и Controls.
+  Добавлены прямой импорт `@koslibs/components/Modal`, размеры 480/600/720/960/fullscreen,
+  управляемое закрытие, блокировка прокрутки и поддержка вложенных окон.
+  Docs содержат вкладки документации, Props, CSS-переменных и истории изменений,
+  а также примеры длинного контента и Popover внутри нативного dialog.
+  Блокировка прокрутки учитывает `scrollbar-gutter: stable`, чтобы контент страницы
+  не смещался из-за двойной компенсации места под скроллбар.
+
+    Modal синхронизирован с документацией Figma: типографика Header 20 px semibold /
+    14 px regular, крестик 18 px в области 48 × 32 px, Header без нижнего и Footer
+    без верхнего отступа. В строковых Controls две Button с block=true делят ширину
+    одной строки поровну с учётом gap; column растягивает кнопки по ширине вертикально.
+
+    Убран `Header.onClose`: крестик вызывает общий `Modal.onClose` через внутренний
+    React Context. Вложенный Header использует обработчик ближайшего Modal;
+    обработчик больше не нужно передавать отдельно в заголовок.
+
+    Header, Content, Footer и Controls наследуют `Modal.dataTestId` с суффиксами
+    `-header`, `-content`, `-footer`, `-controls`. Явный dataTestId части имеет приоритет;
+    вложенные окна используют только свой базовый идентификатор.
+
+    Добавлен отдельный Portal с `getPortalContainer`, `immediateMount`, ref на контейнер
+    и немедленным монтированием по умолчанию (`immediateMount=true`). Значение false
+    позволяет дождаться DOM-контейнера из ref. Modal и Popover используют
+    общий Portal; прямой импорт доступен через `@koslibs/components/Portal`.
+
+## 1.3.0
+
+### Minor Changes
+
+- [#4](https://github.com/koslibs/components/pull/4) [`b37f3b0`](https://github.com/koslibs/components/commit/b37f3b008be8ffea80908557c13ea77d6d55c792) Thanks [@holypower777](https://github.com/holypower777)! - Перенесён Collapse из core-components GullEye с отдельным импортом
+  `@koslibs/components/Collapse`, внутренним и внешним управлением, сохранением
+  содержимого, анимацией и поддержкой reduced motion. Проп `colors` убран:
+  оформление кнопки настраивается через CSS-переменные. Добавлены документация
+  с тремя вкладками, Playground и история компонента. Стрелка подключается
+  отдельным импортом из `@koslibs/icons`.
+
+    Подписи `collapsedLabel` и `expandedLabel` не имеют дефолтных значений.
+    Добавлены `showRightChevron` (по умолчанию `true`) и `showLeftChevron`
+    (по умолчанию `false`): можно независимо показывать шевроны или скрыть оба.
+    Левый шеврон смотрит вправо в закрытом состоянии и вниз в раскрытом,
+    правый сохраняет поворот вниз → вверх.
+
+    Комментарии публичных пропсов приведены к единому многострочному формату JSDoc
+    с отдельной строкой для `@default`.
+
 ## 1.2.0
 
 ### Minor Changes

package/dist/components/Button/button.js

@@ -76,6 +76,7 @@ const Button = /*#__PURE__*/ forwardRef(({ view = 'primary', shape = 'rectangula
             [colors_module.loading]: showLoader
         }, className),
         "data-test-id": dataTestId,
+        "data-block": block || void 0,
         type: type,
         disabled: disabled || showLoader,
         "aria-busy": showLoader,

package/dist/components/Collapse/collapse.d.ts

@@ -0,0 +1,91 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+export type CollapseProps = Omit<HTMLAttributes<HTMLDivElement>, 'onTransitionEnd'> & {
+    /**
+     * Состояние controlled-компонента.
+     */
+    expanded?: boolean;
+    /**
+     * Начальное состояние uncontrolled-компонента.
+     * @default false
+     */
+    defaultExpanded?: boolean;
+    /**
+     * Подпись кнопки, когда содержимое скрыто.
+     */
+    collapsedLabel?: ReactNode;
+    /**
+     * Подпись кнопки, когда содержимое раскрыто.
+     */
+    expandedLabel?: ReactNode;
+    /**
+     * Показывать шеврон справа от подписи: вниз при закрытии, вверх при раскрытии.
+     * @default true
+     */
+    showRightChevron?: boolean;
+    /**
+     * Показывать шеврон слева от подписи: вправо при закрытии, вниз при раскрытии.
+     * @default false
+     */
+    showLeftChevron?: boolean;
+    /**
+     * Запрос изменения состояния. В controlled-режиме обновите expanded.
+     */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Завершение раскрытия/сворачивания; без анимации вызывается сразу.
+     */
+    onTransitionEnd?: (expanded: boolean) => void;
+    /**
+     * Дополнительный класс внутреннего контейнера содержимого.
+     */
+    expandedContentClassName?: string;
+    /**
+     * Идентификатор корневого элемента для автоматизированных тестов.
+     */
+    dataTestId?: string;
+};
+export declare const Collapse: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "onTransitionEnd"> & {
+    /**
+     * Состояние controlled-компонента.
+     */
+    expanded?: boolean;
+    /**
+     * Начальное состояние uncontrolled-компонента.
+     * @default false
+     */
+    defaultExpanded?: boolean;
+    /**
+     * Подпись кнопки, когда содержимое скрыто.
+     */
+    collapsedLabel?: ReactNode;
+    /**
+     * Подпись кнопки, когда содержимое раскрыто.
+     */
+    expandedLabel?: ReactNode;
+    /**
+     * Показывать шеврон справа от подписи: вниз при закрытии, вверх при раскрытии.
+     * @default true
+     */
+    showRightChevron?: boolean;
+    /**
+     * Показывать шеврон слева от подписи: вправо при закрытии, вниз при раскрытии.
+     * @default false
+     */
+    showLeftChevron?: boolean;
+    /**
+     * Запрос изменения состояния. В controlled-режиме обновите expanded.
+     */
+    onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Завершение раскрытия/сворачивания; без анимации вызывается сразу.
+     */
+    onTransitionEnd?: (expanded: boolean) => void;
+    /**
+     * Дополнительный класс внутреннего контейнера содержимого.
+     */
+    expandedContentClassName?: string;
+    /**
+     * Идентификатор корневого элемента для автоматизированных тестов.
+     */
+    dataTestId?: string;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Collapse/collapse.js

@@ -0,0 +1,103 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ChevronDownIcon } from "@koslibs/icons/ChevronDownIcon";
+import classnames from "classnames";
+import { forwardRef, useId, useLayoutEffect, useRef, useState } from "react";
+import index_module from "./index.module.js";
+const Collapse = /*#__PURE__*/ forwardRef(({ expanded, defaultExpanded = false, collapsedLabel, expandedLabel, showRightChevron = true, showLeftChevron = false, onExpandedChange, onTransitionEnd, expandedContentClassName, dataTestId, className, children, ...restProps }, ref)=>{
+    const [expandedState, setExpandedState] = useState(defaultExpanded);
+    const isExpanded = expanded ?? expandedState;
+    const contentId = `collapse-${useId()}`;
+    const contentRef = useRef(null);
+    const innerRef = useRef(null);
+    const toggleRef = useRef(null);
+    const previousExpanded = useRef(isExpanded);
+    const pendingTransition = useRef(false);
+    const transitionCallback = useRef(onTransitionEnd);
+    const label = isExpanded ? expandedLabel || collapsedLabel : collapsedLabel || expandedLabel;
+    useLayoutEffect(()=>{
+        transitionCallback.current = onTransitionEnd;
+    }, [
+        onTransitionEnd
+    ]);
+    useLayoutEffect(()=>{
+        const content = contentRef.current;
+        if (!content) return;
+        if (!isExpanded && content.contains(content.ownerDocument.activeElement)) toggleRef.current?.focus();
+        content.inert = !isExpanded;
+        if (previousExpanded.current === isExpanded) return;
+        previousExpanded.current = isExpanded;
+        pendingTransition.current = true;
+        const transitionDuration = content.ownerDocument.defaultView?.getComputedStyle(content).transitionDuration;
+        if (innerRef.current?.scrollHeight === 0 || 0 === parseFloat(transitionDuration ?? '0')) {
+            pendingTransition.current = false;
+            transitionCallback.current?.(isExpanded);
+        }
+    }, [
+        isExpanded
+    ]);
+    const handleToggle = ()=>{
+        const nextExpanded = !isExpanded;
+        if (void 0 === expanded) setExpandedState(nextExpanded);
+        onExpandedChange?.(nextExpanded);
+    };
+    const handleTransitionEnd = (event)=>{
+        if (event.target === event.currentTarget && 'grid-template-rows' === event.propertyName && pendingTransition.current) {
+            pendingTransition.current = false;
+            transitionCallback.current?.(isExpanded);
+        }
+    };
+    return /*#__PURE__*/ jsxs("div", {
+        ...restProps,
+        ref: ref,
+        className: classnames(index_module.component, className),
+        "data-test-id": dataTestId,
+        children: [
+            label && /*#__PURE__*/ jsxs("button", {
+                ref: toggleRef,
+                type: "button",
+                className: index_module.toggle,
+                "aria-expanded": isExpanded,
+                "aria-controls": contentId,
+                onClick: handleToggle,
+                "data-test-id": dataTestId ? `${dataTestId}-toggle` : void 0,
+                children: [
+                    showLeftChevron && /*#__PURE__*/ jsx(ChevronDownIcon, {
+                        className: classnames(index_module.icon, index_module.leftIcon, {
+                            [index_module.rotated]: isExpanded
+                        }),
+                        "aria-hidden": "true"
+                    }),
+                    /*#__PURE__*/ jsx("span", {
+                        children: label
+                    }),
+                    showRightChevron && /*#__PURE__*/ jsx(ChevronDownIcon, {
+                        className: classnames(index_module.icon, {
+                            [index_module.rotated]: isExpanded
+                        }),
+                        "aria-hidden": "true"
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsx("div", {
+                ref: contentRef,
+                id: contentId,
+                className: classnames(index_module.content, {
+                    [index_module.expanded]: isExpanded
+                }),
+                "aria-hidden": !isExpanded,
+                "data-test-id": dataTestId ? `${dataTestId}-content` : void 0,
+                onTransitionEnd: handleTransitionEnd,
+                children: /*#__PURE__*/ jsx("div", {
+                    className: index_module.clip,
+                    children: /*#__PURE__*/ jsx("div", {
+                        ref: innerRef,
+                        className: expandedContentClassName,
+                        children: children
+                    })
+                })
+            })
+        ]
+    });
+});
+Collapse.displayName = 'Collapse';
+export { Collapse };

package/dist/components/Collapse/index.d.ts

@@ -0,0 +1,2 @@
+export { Collapse } from './collapse.js';
+export type { CollapseProps } from './collapse.js';

package/dist/components/Collapse/index.js

@@ -0,0 +1 @@
+export { Collapse } from "./collapse.js";

package/dist/components/Collapse/index.module.js

@@ -0,0 +1,12 @@
+import "./index_module.css";
+const index_module = {
+    component: "component-tPiInR",
+    content: "content-D8E_z9",
+    expanded: "expanded-rqGMOG",
+    clip: "clip-D3ydtQ",
+    toggle: "toggle-YA8uJB",
+    icon: "icon-wFeaQN",
+    rotated: "rotated-sRw5l2",
+    leftIcon: "leftIcon-PGZrVM"
+};
+export default index_module;

package/dist/components/Collapse/index_module.css

@@ -0,0 +1,82 @@
+@import "../../styles/theme.css";
+@import "./vars.css";
+
+.component-tPiInR {
+  min-width: 0;
+  font-family: var(--font-primary);
+}
+
+.content-D8E_z9 {
+  visibility: hidden;
+  grid-template-rows: 0fr;
+  transition: grid-template-rows .2s, visibility 0s linear .2s;
+  display: grid;
+}
+
+.expanded-rqGMOG {
+  visibility: visible;
+  grid-template-rows: 1fr;
+  transition-delay: 0s;
+}
+
+.clip-D3ydtQ {
+  min-height: 0;
+  overflow: hidden;
+}
+
+.toggle-YA8uJB {
+  align-items: center;
+  gap: var(--size-4, 4px);
+  max-width: 100%;
+  padding: var(--size-8, 8px) 0;
+  color: var(--collapse-color);
+  font: inherit;
+  text-align: left;
+  overflow-wrap: anywhere;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  margin: 0;
+  font-size: 13px;
+  line-height: 20px;
+  display: inline-flex;
+
+  &:hover {
+    color: var(--collapse-hover-color);
+  }
+
+  &:hover span {
+    text-underline-offset: 3px;
+    text-decoration: underline;
+  }
+
+  &:focus-visible {
+    outline: 2px solid var(--collapse-focus-color);
+    outline-offset: 2px;
+    border-radius: var(--border-radius-4, 4px);
+  }
+}
+
+.icon-wFeaQN {
+  flex-shrink: 0;
+  transition: transform .2s;
+}
+
+.rotated-sRw5l2 {
+  transform: rotate(180deg);
+}
+
+.leftIcon-PGZrVM {
+  transform: rotate(-90deg);
+
+  &.rotated-sRw5l2 {
+    transform: rotate(0);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .content-D8E_z9, .icon-wFeaQN {
+    transition: none;
+  }
+}
+

package/dist/components/Collapse/vars.css

@@ -0,0 +1,6 @@
+:root {
+  --collapse-color: #1c1a18;
+  --collapse-hover-color: #686d63;
+  --collapse-focus-color: #7967f2;
+}
+

package/dist/components/Modal/colors.module.js

@@ -0,0 +1,5 @@
+import "./colors_module.css";
+const colors_module = {
+    component: "component-NzhSoV"
+};
+export default colors_module;

package/dist/components/Modal/colors_module.css

@@ -0,0 +1,10 @@
+.component-NzhSoV {
+  background-color: var(--modal-background-color);
+  color: var(--modal-color);
+
+  &::backdrop {
+    background-color: var(--modal-backdrop-color);
+    backdrop-filter: blur(var(--modal-backdrop-blur));
+  }
+}
+

package/dist/components/Modal/components/content/index.d.ts

@@ -0,0 +1,15 @@
+import { type HTMLAttributes } from 'react';
+export type ContentProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -content.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+};
+export declare const Content: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -content.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Modal/components/content/index.js

@@ -0,0 +1,18 @@
+import { jsx } from "react/jsx-runtime";
+import classnames from "classnames";
+import { forwardRef, useContext } from "react";
+import { ModalContext } from "../../context.js";
+import index_module from "./index.module.js";
+const Content = /*#__PURE__*/ forwardRef(({ children, className, dataTestId, ...restProps }, ref)=>{
+    const { dataTestId: modalDataTestId } = useContext(ModalContext);
+    const testId = dataTestId ?? modalDataTestId;
+    return /*#__PURE__*/ jsx("div", {
+        ...restProps,
+        ref: ref,
+        className: classnames(index_module.component, className),
+        "data-test-id": testId ? `${testId}-content` : void 0,
+        children: children
+    });
+});
+Content.displayName = 'ModalContent';
+export { Content };

package/dist/components/Modal/components/content/index.module.js

@@ -0,0 +1,5 @@
+import "./index_module.css";
+const index_module = {
+    component: "component-Xoedpj"
+};
+export default index_module;

package/dist/components/Modal/components/content/index_module.css

@@ -0,0 +1,12 @@
+.component-Xoedpj {
+  gap: var(--size-24, 24px);
+  min-height: 0;
+  padding: var(--modal-padding);
+  overscroll-behavior: contain;
+  overflow-wrap: anywhere;
+  flex-direction: column;
+  flex: auto;
+  display: flex;
+  overflow: auto;
+}
+

package/dist/components/Modal/components/controls/index.d.ts

@@ -0,0 +1,56 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import React from 'react';
+export type ControlsProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Основное действие, отображается после дополнительного.
+     */
+    primary?: ReactNode;
+    /**
+     * Дополнительное действие.
+     */
+    secondary?: ReactNode;
+    /**
+     * Выравнивание действий.
+     * В строковых раскладках block-кнопки делят свободную ширину поровну.
+     * В column кнопки занимают всю ширину и располагаются друг под другом.
+     * @default 'end'
+     */
+    layout?: 'start' | 'end' | 'center' | 'space-between' | 'column';
+    /**
+     * Расстояние между действиями.
+     * @default 12
+     */
+    gap?: 8 | 12 | 16 | 24;
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -controls.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+};
+export declare const Controls: React.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Основное действие, отображается после дополнительного.
+     */
+    primary?: ReactNode;
+    /**
+     * Дополнительное действие.
+     */
+    secondary?: ReactNode;
+    /**
+     * Выравнивание действий.
+     * В строковых раскладках block-кнопки делят свободную ширину поровну.
+     * В column кнопки занимают всю ширину и располагаются друг под другом.
+     * @default 'end'
+     */
+    layout?: "start" | "end" | "center" | "space-between" | "column";
+    /**
+     * Расстояние между действиями.
+     * @default 12
+     */
+    gap?: 8 | 12 | 16 | 24;
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -controls.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+} & React.RefAttributes<HTMLDivElement>>;

package/dist/components/Modal/components/controls/index.js

@@ -0,0 +1,23 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import classnames from "classnames";
+import react, { forwardRef, useContext } from "react";
+import { ModalContext } from "../../context.js";
+import index_module from "./index.module.js";
+const Controls = /*#__PURE__*/ forwardRef(({ primary, secondary, layout = 'end', gap = 12, className, children, dataTestId, ...restProps }, ref)=>{
+    const { dataTestId: modalDataTestId } = useContext(ModalContext);
+    const testId = dataTestId ?? modalDataTestId;
+    return /*#__PURE__*/ jsx("div", {
+        ...restProps,
+        ref: ref,
+        className: classnames(index_module.component, index_module[layout], index_module[`gap-${gap}`], className),
+        "data-test-id": testId ? `${testId}-controls` : void 0,
+        children: children ?? /*#__PURE__*/ jsxs(react.Fragment, {
+            children: [
+                secondary,
+                primary
+            ]
+        })
+    });
+});
+Controls.displayName = 'ModalControls';
+export { Controls };

package/dist/components/Modal/components/controls/index.module.js

@@ -0,0 +1,19 @@
+import "./index_module.css";
+const index_module = {
+    component: "component-IPNCFT",
+    column: "column-dBeQXP",
+    start: "start-ouHlcU",
+    end: "end-TYAvEX",
+    center: "center-I4ALjs",
+    "space-between": "space-between-OxpVhA",
+    spaceBetween: "space-between-OxpVhA",
+    "gap-8": "gap-8-xwhlts",
+    gap8: "gap-8-xwhlts",
+    "gap-12": "gap-12-IFyQQK",
+    gap12: "gap-12-IFyQQK",
+    "gap-16": "gap-16-iZpxeN",
+    gap16: "gap-16-iZpxeN",
+    "gap-24": "gap-24-eEhuId",
+    gap24: "gap-24-eEhuId"
+};
+export default index_module;

package/dist/components/Modal/components/controls/index_module.css

@@ -0,0 +1,52 @@
+.component-IPNCFT {
+  flex-wrap: wrap;
+  align-items: center;
+  width: 100%;
+  display: flex;
+}
+
+.component-IPNCFT:not(.column-dBeQXP) > button[data-block="true"] {
+  flex: 1 1 0;
+}
+
+.start-ouHlcU {
+  justify-content: flex-start;
+}
+
+.end-TYAvEX {
+  justify-content: flex-end;
+}
+
+.center-I4ALjs {
+  justify-content: center;
+}
+
+.space-between-OxpVhA {
+  justify-content: space-between;
+}
+
+.column-dBeQXP {
+  flex-direction: column;
+  align-items: stretch;
+}
+
+.column-dBeQXP > button {
+  width: 100%;
+}
+
+.gap-8-xwhlts {
+  gap: var(--size-8, 8px);
+}
+
+.gap-12-IFyQQK {
+  gap: var(--size-12, 12px);
+}
+
+.gap-16-iZpxeN {
+  gap: var(--size-16, 16px);
+}
+
+.gap-24-eEhuId {
+  gap: var(--size-24, 24px);
+}
+

package/dist/components/Modal/components/footer/index.d.ts

@@ -0,0 +1,15 @@
+import { type HTMLAttributes } from 'react';
+export type FooterProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -footer.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+};
+export declare const Footer: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /**
+     * Базовый идентификатор для автоматизированных тестов с суффиксом -footer.
+     * По умолчанию наследуется от ближайшего Modal; явно заданный имеет приоритет.
+     */
+    dataTestId?: string;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Modal/components/footer/index.js

@@ -0,0 +1,18 @@
+import { jsx } from "react/jsx-runtime";
+import classnames from "classnames";
+import { forwardRef, useContext } from "react";
+import { ModalContext } from "../../context.js";
+import index_module from "./index.module.js";
+const Footer = /*#__PURE__*/ forwardRef(({ children, className, dataTestId, ...restProps }, ref)=>{
+    const { dataTestId: modalDataTestId } = useContext(ModalContext);
+    const testId = dataTestId ?? modalDataTestId;
+    return /*#__PURE__*/ jsx("div", {
+        ...restProps,
+        ref: ref,
+        className: classnames(index_module.component, className),
+        "data-test-id": testId ? `${testId}-footer` : void 0,
+        children: children
+    });
+});
+Footer.displayName = 'ModalFooter';
+export { Footer };

package/dist/components/Modal/components/footer/index.module.js

@@ -0,0 +1,5 @@
+import "./index_module.css";
+const index_module = {
+    component: "component-ZDJl0C"
+};
+export default index_module;

package/dist/components/Modal/components/footer/index_module.css

@@ -0,0 +1,9 @@
+.component-ZDJl0C {
+  justify-content: flex-end;
+  align-items: center;
+  gap: var(--size-12, 12px);
+  padding: 0 var(--modal-padding) var(--modal-padding);
+  flex-shrink: 0;
+  display: flex;
+}
+