@koslibs/components 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @koslibs/components
 
+## 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/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/Popover/types.d.ts

@@ -2,7 +2,9 @@ import type { Placement } from '@popperjs/core';
 import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 export type PopoverPosition = Exclude<Placement, 'auto' | 'auto-start' | 'auto-end'>;
 export type PopoverProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'className' | 'style'> & {
-    /** Содержимое поповера. Оформление и прокрутка задаются вызывающим компонентом. */
+    /**
+     * Содержимое поповера. Оформление и прокрутка задаются вызывающим компонентом.
+     */
     children?: ReactNode;
     /**
      * Дополнительный класс внешнего контейнера.

package/dist/components/Typography/shared.d.ts

@@ -2,11 +2,17 @@ import type { CSSProperties, HTMLAttributes, ReactNode } from 'react';
 export type TypographyWeight = 'regular' | 'medium' | 'semibold' | 'bold';
 export type TypographyColor = 'inherit' | 'primary' | 'secondary' | 'inverse' | 'positive' | 'negative';
 export type BaseProps = Omit<HTMLAttributes<HTMLElement>, 'color' | 'children' | 'className' | 'style'> & {
-    /** Содержимое текста или заголовка. */
+    /**
+     * Содержимое текста или заголовка.
+     */
     children?: ReactNode;
-    /** Дополнительный CSS-класс корневого элемента. */
+    /**
+     * Дополнительный CSS-класс корневого элемента.
+     */
     className?: string;
-    /** Инлайн-стили корневого элемента. */
+    /**
+     * Инлайн-стили корневого элемента.
+     */
     style?: CSSProperties;
     /**
      * Цвет текста. По умолчанию наследуется от родителя.

package/dist/index.d.ts

@@ -6,3 +6,5 @@ export { Typography, TypographyText, TypographyTitle, Text, Title } from './comp
 export type { TextProps, TitleProps, TypographyColor, TypographyWeight, } from './components/Typography/index.js';
 export { Popover } from './components/Popover/index.js';
 export type { PopoverProps, PopoverPosition } from './components/Popover/index.js';
+export { Collapse } from './components/Collapse/index.js';
+export type { CollapseProps } from './components/Collapse/index.js';

package/dist/index.js

@@ -2,3 +2,4 @@ export { Button } from "./components/Button/index.js";
 export { Spinner } from "./components/Spinner/index.js";
 export { Text, Title, Typography, TypographyText, TypographyTitle } from "./components/Typography/index.js";
 export { Popover } from "./components/Popover/index.js";
+export { Collapse } from "./components/Collapse/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koslibs/components",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "description": "Shared React components for koslibs projects",
     "type": "module",
     "main": "./dist/index.js",
@@ -80,6 +80,7 @@
         "react-dom": "^18.3.1 || ^19.0.0"
     },
     "dependencies": {
+        "@koslibs/icons": "1.0.1",
         "@popperjs/core": "2.11.8",
         "classnames": "2.5.1"
     }