@koslibs/components 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @koslibs/components
 
+## 1.2.0
+
+### Minor Changes
+
+- [#3](https://github.com/koslibs/components/pull/3) [`a618f52`](https://github.com/koslibs/components/commit/a618f526010adc6203a708e73fac3906b555ac78) Thanks [@holypower777](https://github.com/holypower777)! - Перенесён Popover из GullEye с отдельным импортом `@koslibs/components/Popover`,
+  стилями, Docs и Playground. Сохранены управляемая видимость, позиционирование,
+  ограничение размеров и способы закрытия. Портал и позиционирование адаптированы
+  для самостоятельного использования в React 18 и 19.
+
+    Popover управляет позицией и размерами и рендерит children напрямую. Оформление
+    и прокрутка содержимого задаются вызывающим компонентом; colors и contentClassName
+    не входят в API. Прежнее оформление Storybook-примеров сохранено в их содержимом.
+    Тень задаёт сам Popover через CSS-переменную --popover-shadow.
+    Offset по умолчанию равен `[0, 0]`, без смещения и зазора между якорем и содержимым.
+
+    Документация каждого компонента собрана в его папке docs: stories, страницы Docs
+    и стили примеров. Папки документации исключены из JS-сборки и деклараций npm-пакета.
+
+## 1.1.0
+
+### Minor Changes
+
+- [#2](https://github.com/koslibs/components/pull/2) [`b09aeff`](https://github.com/koslibs/components/commit/b09aeffe06d9267aad1f689deb91a19412ff8448) Thanks [@holypower777](https://github.com/holypower777)! - Добавлен публичный Typography из GullEye: Text и Title, типы, CSS Modules,
+  Docs и Playground. Импорт из `@koslibs/components/Typography` подключает
+  только Typography и его стили.
+
+    Исправлены отступы содержимого вкладок Docs и сдвиг страницы при появлении
+    или исчезновении полосы прокрутки.
+
+    Закреплены правила историй компонентов: запись добавляется только для изменённого
+    компонента; общие изменения инфраструктуры и Storybook описываются в истории пакета.
+
+    Добавлена общая тема с `--font-primary: 'Inter', sans-serif` и локальными
+    WOFF2-файлами Inter. Typography и подпись Button подключают её автоматически;
+    приложение может переопределить семейство шрифта через CSS.
+
 ## 1.0.0
 
 ### Major Changes

package/README.md

@@ -1,5 +1,35 @@
 Демо: <https://koslibs.github.io/components/>
 
+## Основной шрифт
+
+Библиотека задаёт `--font-primary: 'Inter', sans-serif` в общей теме. Компоненты,
+использующие эту переменную, автоматически подключают тему и локальные WOFF2-файлы
+Inter. Поддерживаются веса 100–900, латиница и кириллица; внешние CDN не используются.
+Браузер загружает нужные языковые поднаборы по `unicode-range`, используется
+`font-display: swap`. Лицензия Inter включена в npm-пакет.
+
+Для использования темы в собственных элементах можно подключить её отдельно:
+
+```tsx
+import '@koslibs/components/theme.css';
+```
+
+Значение по умолчанию находится в CSS-слое `koslibs`, поэтому обычные стили приложения
+переопределяют его независимо от порядка подключения. Например:
+
+```css
+:root {
+    --font-primary: 'My App Font', sans-serif;
+}
+
+.alternate-font {
+    --font-primary: Georgia, serif;
+}
+```
+
+Файлы своего шрифта подключите в приложении. Тема задаёт только переменную и
+`@font-face`; она не изменяет шрифт `body` или элементов, которые её не используют.
+
 ## Добавление компонента
 
 Рекомендуемая структура:
@@ -9,9 +39,11 @@ src/components/Button/
     index.ts
     button.tsx
     button.module.css
-    button.stories.tsx
-    button.docs.tsx
     CHANGELOG.md
+    docs/
+        button.stories.tsx
+        button.docs.tsx
+        examples.module.css
 ```
 
 1. Перенесите компонент в `src/components/<Name>`; имя папки — PascalCase, например `Button`.
@@ -29,7 +61,9 @@ src/components/Button/
     }
     ```
 
-4. Добавьте Docs, Playground и `CHANGELOG.md` по [примеру документации](https://github.com/koslibs/components/blob/main/docs/component-changelogs.md).
+4. Добавьте Docs и Playground в папку компонента `docs`, а `CHANGELOG.md` оставьте
+   рядом с реализацией, по [примеру документации](https://github.com/koslibs/components/blob/main/docs/component-changelogs.md).
+   Папки `src/**/docs` исключены из npm-сборки. Общие блоки Storybook находятся в `src/docs`.
 5. Добавьте тесты поведения. `npm run test:unit` запускает unit-тесты через
    `koslibs-builder lib:test`; `npm test` также проверяет отдельные импорты.
 6. Выполните сборку и проверьте реальные пути JS, деклараций и CSS в `dist`.

package/dist/components/Button/index_module.css

@@ -1,3 +1,4 @@
+@import "../../styles/theme.css";
 @import "./vars.css";
 
 .component-vxc0gC {
@@ -224,7 +225,7 @@
   font-size: 14px;
   font-weight: 400;
   line-height: 18px;
-  font-family: var(--font-primary, "Inter", sans-serif);
+  font-family: var(--font-primary);
   color: var(--button-hint-color);
   display: block;
 }

package/dist/components/Popover/components/popover-surface/index.d.ts

@@ -0,0 +1,4 @@
+import type { PopoverProps } from '../../types.js';
+export declare const PopoverSurface: import("react").ForwardRefExoticComponent<Omit<PopoverProps, "open" | "getPortalContainer" | "anchorElement"> & {
+    anchorElement: HTMLElement;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Popover/components/popover-surface/index.js

@@ -0,0 +1,106 @@
+import { jsx } from "react/jsx-runtime";
+import classnames from "classnames";
+import { forwardRef, useEffect, useImperativeHandle, useMemo, useState } from "react";
+import { createSizeModifier } from "../../create-size-modifier.js";
+import { usePopoverPosition } from "../../use-popover-position.js";
+import index_module from "../../index.module.js";
+const DEFAULT_OFFSET = [
+    0,
+    0
+];
+const PopoverSurface = /*#__PURE__*/ forwardRef(({ anchorElement, position = 'bottom-start', offset = DEFAULT_OFFSET, useAnchorWidth = false, preventFlip = false, fallbackPlacements, preventOverflow = true, availableHeight = true, viewportPadding = 8, onClose, outsideClick = true, escapeKeyDown = true, className, style, children, dataTestId, ...restProps }, ref)=>{
+    const [popperElement, setPopperElement] = useState(null);
+    useImperativeHandle(ref, ()=>popperElement, [
+        popperElement
+    ]);
+    const padding = Math.max(0, viewportPadding);
+    const modifiers = useMemo(()=>[
+            {
+                name: 'offset',
+                options: {
+                    offset
+                }
+            },
+            {
+                name: 'flip',
+                enabled: !preventFlip,
+                options: {
+                    fallbackPlacements,
+                    boundary: [],
+                    padding
+                }
+            },
+            {
+                name: 'preventOverflow',
+                enabled: preventOverflow,
+                options: {
+                    boundary: [],
+                    padding
+                }
+            },
+            createSizeModifier({
+                availableHeight,
+                useAnchorWidth,
+                viewportPadding: padding
+            })
+        ], [
+        offset,
+        preventFlip,
+        fallbackPlacements,
+        preventOverflow,
+        availableHeight,
+        useAnchorWidth,
+        padding
+    ]);
+    const { styles: popperStyles, attributes, update } = usePopoverPosition(anchorElement, popperElement, position, modifiers);
+    useEffect(()=>{
+        if (update) update();
+    }, [
+        children,
+        style,
+        update
+    ]);
+    useEffect(()=>{
+        if (!onClose) return;
+        const ownerDocument = anchorElement.ownerDocument;
+        const handlePointerDown = (event)=>{
+            if (event.defaultPrevented) return;
+            const path = event.composedPath();
+            if (path.includes(anchorElement) || popperElement && path.includes(popperElement)) return;
+            onClose();
+        };
+        const handleKeyDown = (event)=>{
+            if ('Escape' !== event.key || event.defaultPrevented) return;
+            event.preventDefault();
+            event.stopPropagation();
+            onClose();
+        };
+        if (outsideClick) ownerDocument.addEventListener('pointerdown', handlePointerDown);
+        if (escapeKeyDown) ownerDocument.addEventListener('keydown', handleKeyDown);
+        return ()=>{
+            ownerDocument.removeEventListener('pointerdown', handlePointerDown);
+            ownerDocument.removeEventListener('keydown', handleKeyDown);
+        };
+    }, [
+        anchorElement,
+        popperElement,
+        onClose,
+        outsideClick,
+        escapeKeyDown
+    ]);
+    return /*#__PURE__*/ jsx("div", {
+        ...restProps,
+        ...attributes,
+        ref: setPopperElement,
+        className: classnames(index_module.component, className),
+        style: {
+            ...style,
+            ...popperStyles,
+            visibility: popperStyles?.transform ? style?.visibility : 'hidden'
+        },
+        "data-test-id": dataTestId,
+        children: children
+    });
+});
+PopoverSurface.displayName = 'PopoverSurface';
+export { PopoverSurface };

package/dist/components/Popover/create-size-modifier.d.ts

@@ -0,0 +1,8 @@
+import { type Modifier } from '@popperjs/core';
+type Options = {
+    availableHeight: boolean;
+    useAnchorWidth: boolean;
+    viewportPadding: number;
+};
+export declare const createSizeModifier: (options: Options) => Modifier<"availableSize", Options>;
+export {};

package/dist/components/Popover/create-size-modifier.js

@@ -0,0 +1,26 @@
+import { detectOverflow } from "@popperjs/core";
+const createSizeModifier = (options)=>({
+        name: 'availableSize',
+        enabled: true,
+        phase: 'beforeWrite',
+        requires: [
+            'computeStyles'
+        ],
+        options,
+        fn ({ state }) {
+            const { availableHeight, useAnchorWidth, viewportPadding } = options;
+            const documentElement = state.elements.popper.ownerDocument.documentElement;
+            const overflow = detectOverflow(state, {
+                boundary: [],
+                padding: viewportPadding
+            });
+            const side = state.placement.split('-')[0];
+            const height = 'top' === side || 'bottom' === side ? state.rects.popper.height - overflow[side] : documentElement.clientHeight - 2 * viewportPadding;
+            Object.assign(state.styles.popper, {
+                '--popover-viewport-padding': `${viewportPadding}px`,
+                '--popover-available-height': availableHeight ? `${Math.max(0, height)}px` : 'none'
+            });
+            if (useAnchorWidth) state.styles.popper.width = `${state.rects.reference.width}px`;
+        }
+    });
+export { createSizeModifier };

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

@@ -0,0 +1,2 @@
+export { Popover } from './popover.js';
+export type { PopoverProps, PopoverPosition } from './types.js';

package/dist/components/Popover/index.js

@@ -0,0 +1 @@
+export { Popover } from "./popover.js";

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

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

package/dist/components/Popover/index_module.css

@@ -0,0 +1,15 @@
+@import "./vars.css";
+
+.component-wBbNPp {
+  box-sizing: border-box;
+  z-index: var(--popover-z-index);
+  max-width: calc(100vw - var(--popover-viewport-padding, 8px) * 2);
+  min-width: 0;
+  min-height: 0;
+  max-height: var(--popover-available-height, none);
+  box-shadow: var(--popover-shadow);
+  flex-direction: column;
+  display: flex;
+  position: fixed;
+}
+

package/dist/components/Popover/popover.d.ts

@@ -0,0 +1,21 @@
+export type { PopoverProps, PopoverPosition } from './types.js';
+export declare const Popover: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLDivElement>, "className" | "style" | "children"> & {
+    children?: import("react").ReactNode;
+    className?: string;
+    style?: import("react").CSSProperties;
+    open: boolean;
+    anchorElement: HTMLElement | null;
+    position?: import("./types.js").PopoverPosition;
+    offset?: [number, number];
+    useAnchorWidth?: boolean;
+    preventFlip?: boolean;
+    fallbackPlacements?: import("./types.js").PopoverPosition[];
+    preventOverflow?: boolean;
+    availableHeight?: boolean;
+    viewportPadding?: number;
+    onClose?: VoidFunction;
+    outsideClick?: boolean;
+    escapeKeyDown?: boolean;
+    getPortalContainer?: () => Element | null;
+    dataTestId?: string;
+} & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/Popover/popover.js

@@ -0,0 +1,15 @@
+import { jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { createPortal } from "react-dom";
+import { PopoverSurface } from "./components/popover-surface/index.js";
+const Popover = /*#__PURE__*/ forwardRef(({ open, anchorElement, getPortalContainer, ...restProps }, ref)=>{
+    if (!open || !anchorElement) return null;
+    const container = getPortalContainer ? getPortalContainer() : anchorElement.ownerDocument.body;
+    return container ? /*#__PURE__*/ createPortal(/*#__PURE__*/ jsx(PopoverSurface, {
+        ...restProps,
+        anchorElement: anchorElement,
+        ref: ref
+    }), container) : null;
+});
+Popover.displayName = 'Popover';
+export { Popover };

package/dist/components/Popover/types.d.ts

@@ -0,0 +1,86 @@
+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;
+    /**
+     * Дополнительный класс внешнего контейнера.
+     */
+    className?: string;
+    /**
+     * Стили внешнего контейнера, включая ширину.
+     */
+    style?: CSSProperties;
+    /**
+     * Видимость поповера.
+     */
+    open: boolean;
+    /**
+     * Элемент, относительно которого открывается поповер.
+     */
+    anchorElement: HTMLElement | null;
+    /**
+     * Предпочтительная позиция относительно элемента.
+     * @default 'bottom-start'
+     */
+    position?: PopoverPosition;
+    /**
+     * Смещение вдоль элемента и расстояние от него, в пикселях.
+     * @default [0, 0]
+     */
+    offset?: [number, number];
+    /**
+     * Использовать ширину элемента, относительно которого открыт поповер.
+     * @default false
+     */
+    useAnchorWidth?: boolean;
+    /**
+     * Запретить смену стороны при недостатке места.
+     * @default false
+     */
+    preventFlip?: boolean;
+    /**
+     * Позиции, которые проверяются при недостатке места.
+     */
+    fallbackPlacements?: PopoverPosition[];
+    /**
+     * Удерживать поповер в пределах видимой области.
+     * @default true
+     */
+    preventOverflow?: boolean;
+    /**
+     * Ограничивать высоту доступным местом.
+     * Для прокрутки задайте содержимому min-height: 0 и overflow: auto.
+     * @default true
+     */
+    availableHeight?: boolean;
+    /**
+     * Минимальный отступ от границ видимой области, в пикселях.
+     * @default 8
+     */
+    viewportPadding?: number;
+    /**
+     * Обработчик запроса закрытия. Обновите open в вызывающем компоненте.
+     */
+    onClose?: VoidFunction;
+    /**
+     * Разрешить закрытие по нажатию вне поповера и его элемента.
+     * @default true
+     */
+    outsideClick?: boolean;
+    /**
+     * Разрешить закрытие по Escape.
+     * @default true
+     */
+    escapeKeyDown?: boolean;
+    /**
+     * Контейнер портала. По умолчанию — body документа anchorElement.
+     * Если функция возвращает null, поповер не рендерится.
+     */
+    getPortalContainer?: () => Element | null;
+    /**
+     * Идентификатор для автоматизированных тестов.
+     */
+    dataTestId?: string;
+};

package/dist/components/Popover/use-popover-position.d.ts

@@ -0,0 +1,8 @@
+import { type Modifier } from '@popperjs/core';
+import { type CSSProperties } from 'react';
+import type { PopoverPosition } from './types.js';
+export declare function usePopoverPosition(anchorElement: HTMLElement, popperElement: HTMLDivElement | null, position: PopoverPosition, modifiers: Partial<Modifier<string, object>>[]): {
+    update: () => Promise<Partial<import("@popperjs/core").State>> | undefined;
+    styles: CSSProperties;
+    attributes: Record<string, string | boolean>;
+};

package/dist/components/Popover/use-popover-position.js

@@ -0,0 +1,78 @@
+import { createPopper } from "@popperjs/core";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+const initialState = {
+    styles: {
+        position: 'fixed',
+        left: 0,
+        top: 0,
+        visibility: 'hidden'
+    },
+    attributes: {}
+};
+function usePopoverPosition(anchorElement, popperElement, position, modifiers) {
+    const [state, setState] = useState(initialState);
+    const instanceRef = useRef(null);
+    const updateState = useMemo(()=>({
+            name: 'reactStyles',
+            enabled: true,
+            phase: 'write',
+            requires: [
+                'computeStyles'
+            ],
+            fn: ({ state: popperState })=>{
+                setState({
+                    styles: {
+                        ...popperState.styles.popper
+                    },
+                    attributes: {
+                        ...popperState.attributes.popper
+                    }
+                });
+            }
+        }), []);
+    useEffect(()=>{
+        if (!popperElement) return;
+        let active = true;
+        setState(initialState);
+        const instance = createPopper(anchorElement, popperElement, {
+            placement: position,
+            strategy: 'fixed',
+            modifiers: [
+                ...modifiers,
+                {
+                    ...updateState,
+                    fn: (args)=>{
+                        if (active) updateState.fn(args);
+                    }
+                },
+                {
+                    name: 'applyStyles',
+                    enabled: false
+                }
+            ]
+        });
+        instanceRef.current = instance;
+        const ResizeObserverClass = anchorElement.ownerDocument.defaultView?.ResizeObserver;
+        const observer = ResizeObserverClass ? new ResizeObserverClass(()=>void instance.update()) : void 0;
+        observer?.observe(anchorElement);
+        observer?.observe(popperElement);
+        return ()=>{
+            active = false;
+            observer?.disconnect();
+            instance.destroy();
+            instanceRef.current = null;
+        };
+    }, [
+        anchorElement,
+        popperElement,
+        position,
+        modifiers,
+        updateState
+    ]);
+    const update = useCallback(()=>instanceRef.current?.update(), []);
+    return {
+        ...state,
+        update
+    };
+}
+export { usePopoverPosition };

package/dist/components/Popover/vars.css

@@ -0,0 +1,5 @@
+:root {
+  --popover-z-index: 1100;
+  --popover-shadow: 0 8px 24px #00000029;
+}
+

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

@@ -0,0 +1,10 @@
+import "./colors_module.css";
+const colors_module = {
+    inherit: "inherit-D2kX96",
+    primary: "primary-LVKi8J",
+    secondary: "secondary-eTdE4v",
+    inverse: "inverse-PTiWqH",
+    positive: "positive-a1clfd",
+    negative: "negative-IhTMOW"
+};
+export default colors_module;

package/dist/components/Typography/colors_module.css

@@ -0,0 +1,26 @@
+@import "./vars.css";
+
+.inherit-D2kX96 {
+  color: inherit;
+}
+
+.primary-LVKi8J {
+  color: var(--typography-primary-color);
+}
+
+.secondary-eTdE4v {
+  color: var(--typography-secondary-color);
+}
+
+.inverse-PTiWqH {
+  color: var(--typography-inverse-color);
+}
+
+.positive-a1clfd {
+  color: var(--typography-positive-color);
+}
+
+.negative-IhTMOW {
+  color: var(--typography-negative-color);
+}
+

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

@@ -0,0 +1,34 @@
+import { TypographyText } from './text.js';
+import { TypographyTitle } from './title.js';
+export { TypographyText, TypographyText as Text, TypographyTitle, TypographyTitle as Title };
+export type { TextProps, TitleProps, TypographyColor, TypographyWeight } from './shared.js';
+export declare const Typography: {
+    Text: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLElement>, "className" | "style" | "color" | "children"> & {
+        children?: import("react").ReactNode;
+        className?: string;
+        style?: import("react").CSSProperties;
+        color?: import("./shared.js").TypographyColor;
+        weight?: import("./shared.js").TypographyWeight;
+        caps?: boolean;
+        monospaceNumbers?: boolean;
+        rowLimit?: 1 | 2 | 3;
+        dataTestId?: string;
+    } & {
+        size?: 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 20;
+        tag?: "span" | "p" | "div" | "li";
+    } & import("react").RefAttributes<import("./shared.js").TextElement>>;
+    Title: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLElement>, "className" | "style" | "color" | "children"> & {
+        children?: import("react").ReactNode;
+        className?: string;
+        style?: import("react").CSSProperties;
+        color?: import("./shared.js").TypographyColor;
+        weight?: import("./shared.js").TypographyWeight;
+        caps?: boolean;
+        monospaceNumbers?: boolean;
+        rowLimit?: 1 | 2 | 3;
+        dataTestId?: string;
+    } & {
+        size?: 13 | 14 | 16 | 20 | 24 | 28 | 32;
+        tag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "div";
+    } & import("react").RefAttributes<import("./shared.js").TitleElement>>;
+};

package/dist/components/Typography/index.js

@@ -0,0 +1,7 @@
+import { TypographyText } from "./text.js";
+import { TypographyTitle } from "./title.js";
+const Typography = {
+    Text: TypographyText,
+    Title: TypographyTitle
+};
+export { Typography, TypographyText as Text, TypographyText, TypographyTitle as Title, TypographyTitle };

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

@@ -0,0 +1,18 @@
+import "./index_module.css";
+const index_module = {
+    component: "component-niqWjh",
+    "weight-regular": "weight-regular-cOlAcy",
+    weightRegular: "weight-regular-cOlAcy",
+    "weight-medium": "weight-medium-kDVEGI",
+    weightMedium: "weight-medium-kDVEGI",
+    "weight-semibold": "weight-semibold-euRksF",
+    weightSemibold: "weight-semibold-euRksF",
+    "weight-bold": "weight-bold-ZxTUEF",
+    weightBold: "weight-bold-ZxTUEF",
+    caps: "caps-AWFyAh",
+    monospaceNumbers: "monospaceNumbers-wR2ApQ",
+    rowLimit1: "rowLimit1-Es_q51",
+    rowLimit2: "rowLimit2-gODO9s",
+    rowLimit3: "rowLimit3-LvJseL"
+};
+export default index_module;

package/dist/components/Typography/index_module.css

@@ -0,0 +1,57 @@
+@import "../../styles/theme.css";
+@import "./vars.css";
+
+.component-niqWjh {
+  margin: var(--size-0, 0px);
+  padding: var(--size-0, 0px);
+  font-family: var(--font-primary);
+  font-style: normal;
+  line-height: var(--typography-line-height);
+  letter-spacing: var(--typography-letter-spacing);
+}
+
+.weight-regular-cOlAcy {
+  font-weight: var(--typography-regular-font-weight);
+}
+
+.weight-medium-kDVEGI {
+  font-weight: var(--typography-medium-font-weight);
+}
+
+.weight-semibold-euRksF {
+  font-weight: var(--typography-semibold-font-weight);
+}
+
+.weight-bold-ZxTUEF {
+  font-weight: var(--typography-bold-font-weight);
+}
+
+.caps-AWFyAh {
+  text-transform: uppercase;
+}
+
+.monospaceNumbers-wR2ApQ {
+  font-variant-numeric: tabular-nums lining-nums;
+}
+
+.rowLimit1-Es_q51 {
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  display: block;
+  overflow: hidden;
+}
+
+.rowLimit2-gODO9s, .rowLimit3-LvJseL {
+  -webkit-box-orient: vertical;
+  display: -webkit-box;
+  overflow: hidden;
+}
+
+.rowLimit2-gODO9s {
+  -webkit-line-clamp: 2;
+}
+
+.rowLimit3-LvJseL {
+  -webkit-line-clamp: 3;
+}
+

package/dist/components/Typography/preset.module.js

@@ -0,0 +1,30 @@
+import "./preset_module.css";
+const preset_module = {
+    "size-8": "size-8-NlI2Hs",
+    size8: "size-8-NlI2Hs",
+    "size-9": "size-9-j9FL3_",
+    size9: "size-9-j9FL3_",
+    "size-10": "size-10-GUrD5L",
+    size10: "size-10-GUrD5L",
+    "size-11": "size-11-foLp7Q",
+    size11: "size-11-foLp7Q",
+    "size-12": "size-12-E_PVmd",
+    size12: "size-12-E_PVmd",
+    "size-13": "size-13-Eu2_On",
+    size13: "size-13-Eu2_On",
+    "size-14": "size-14-OpEM1B",
+    size14: "size-14-OpEM1B",
+    "size-15": "size-15-DxWyW2",
+    size15: "size-15-DxWyW2",
+    "size-16": "size-16-OgafBi",
+    size16: "size-16-OgafBi",
+    "size-20": "size-20-eTO0D7",
+    size20: "size-20-eTO0D7",
+    "size-24": "size-24-lZpjdx",
+    size24: "size-24-lZpjdx",
+    "size-28": "size-28-CY10Yo",
+    size28: "size-28-CY10Yo",
+    "size-32": "size-32-QPCTWV",
+    size32: "size-32-QPCTWV"
+};
+export default preset_module;

package/dist/components/Typography/preset_module.css

@@ -0,0 +1,54 @@
+@import "./vars.css";
+
+.size-8-NlI2Hs {
+  font-size: var(--typography-font-size-8);
+}
+
+.size-9-j9FL3_ {
+  font-size: var(--typography-font-size-9);
+}
+
+.size-10-GUrD5L {
+  font-size: var(--typography-font-size-10);
+}
+
+.size-11-foLp7Q {
+  font-size: var(--typography-font-size-11);
+}
+
+.size-12-E_PVmd {
+  font-size: var(--typography-font-size-12);
+}
+
+.size-13-Eu2_On {
+  font-size: var(--typography-font-size-13);
+}
+
+.size-14-OpEM1B {
+  font-size: var(--typography-font-size-14);
+}
+
+.size-15-DxWyW2 {
+  font-size: var(--typography-font-size-15);
+}
+
+.size-16-OgafBi {
+  font-size: var(--typography-font-size-16);
+}
+
+.size-20-eTO0D7 {
+  font-size: var(--typography-font-size-20);
+}
+
+.size-24-lZpjdx {
+  font-size: var(--typography-font-size-24);
+}
+
+.size-28-CY10Yo {
+  font-size: var(--typography-font-size-28);
+}
+
+.size-32-QPCTWV {
+  font-size: var(--typography-font-size-32);
+}
+

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

@@ -0,0 +1,63 @@
+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-класс корневого элемента. */
+    className?: string;
+    /** Инлайн-стили корневого элемента. */
+    style?: CSSProperties;
+    /**
+     * Цвет текста. По умолчанию наследуется от родителя.
+     */
+    color?: TypographyColor;
+    /**
+     * Толщина шрифта.
+     */
+    weight?: TypographyWeight;
+    /**
+     * Преобразовать текст в верхний регистр.
+     */
+    caps?: boolean;
+    /**
+     * Сделать цифры одинаковой ширины для таблиц и показателей.
+     */
+    monospaceNumbers?: boolean;
+    /**
+     * Ограничить число видимых строк, сохранив полный текст в DOM.
+     */
+    rowLimit?: 1 | 2 | 3;
+    /**
+     * Идентификатор для автоматизированных тестов.
+     */
+    dataTestId?: string;
+};
+export type TextProps = BaseProps & {
+    /**
+     * Размер шрифта в пикселях.
+     * @default 13
+     */
+    size?: 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 20;
+    /**
+     * HTML-тег, определяющий семантику текста.
+     * @default span
+     */
+    tag?: 'span' | 'p' | 'div' | 'li';
+};
+export type TitleProps = BaseProps & {
+    /**
+     * Размер шрифта в пикселях.
+     * @default 28
+     */
+    size?: 13 | 14 | 16 | 20 | 24 | 28 | 32;
+    /**
+     * Уровень заголовка выбирается независимо от визуального размера.
+     */
+    tag: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'div';
+};
+export type TextElement = HTMLSpanElement | HTMLParagraphElement | HTMLDivElement | HTMLLIElement;
+export type TitleElement = HTMLHeadingElement | HTMLDivElement;
+export declare const getClassName: ({ size, weight, color, caps, monospaceNumbers, rowLimit, className, }: BaseProps & {
+    size: number;
+}) => string;

package/dist/components/Typography/shared.js

@@ -0,0 +1,10 @@
+import classnames from "classnames";
+import colors_module from "./colors.module.js";
+import index_module from "./index.module.js";
+import preset_module from "./preset.module.js";
+const getClassName = ({ size, weight, color, caps, monospaceNumbers, rowLimit, className })=>classnames(index_module.component, preset_module[`size-${size}`], weight && index_module[`weight-${weight}`], color && colors_module[color], {
+        [index_module.caps]: caps,
+        [index_module.monospaceNumbers]: monospaceNumbers,
+        [index_module[`rowLimit${rowLimit}`]]: rowLimit
+    }, className);
+export { getClassName };

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

@@ -0,0 +1,15 @@
+import { type TextElement } from './shared.js';
+export declare const TypographyText: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLElement>, "className" | "style" | "color" | "children"> & {
+    children?: import("react").ReactNode;
+    className?: string;
+    style?: import("react").CSSProperties;
+    color?: import("./shared.js").TypographyColor;
+    weight?: import("./shared.js").TypographyWeight;
+    caps?: boolean;
+    monospaceNumbers?: boolean;
+    rowLimit?: 1 | 2 | 3;
+    dataTestId?: string;
+} & {
+    size?: 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 20;
+    tag?: "span" | "p" | "div" | "li";
+} & import("react").RefAttributes<TextElement>>;

package/dist/components/Typography/text.js

@@ -0,0 +1,18 @@
+import { createElement, forwardRef } from "react";
+import { getClassName } from "./shared.js";
+const TypographyText = /*#__PURE__*/ forwardRef(({ size = 13, tag = 'span', weight = 'regular', color = 'inherit', caps = false, monospaceNumbers = false, rowLimit, className, dataTestId, children, ...restProps }, ref)=>/*#__PURE__*/ createElement(tag, {
+        ...restProps,
+        ref,
+        className: getClassName({
+            size,
+            weight,
+            color,
+            caps,
+            monospaceNumbers,
+            rowLimit,
+            className
+        }),
+        'data-test-id': dataTestId
+    }, children));
+TypographyText.displayName = 'TypographyText';
+export { TypographyText };

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

@@ -0,0 +1,15 @@
+import { type TitleElement } from './shared.js';
+export declare const TypographyTitle: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLElement>, "className" | "style" | "color" | "children"> & {
+    children?: import("react").ReactNode;
+    className?: string;
+    style?: import("react").CSSProperties;
+    color?: import("./shared.js").TypographyColor;
+    weight?: import("./shared.js").TypographyWeight;
+    caps?: boolean;
+    monospaceNumbers?: boolean;
+    rowLimit?: 1 | 2 | 3;
+    dataTestId?: string;
+} & {
+    size?: 13 | 14 | 16 | 20 | 24 | 28 | 32;
+    tag: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "div";
+} & import("react").RefAttributes<TitleElement>>;

package/dist/components/Typography/title.js

@@ -0,0 +1,18 @@
+import { createElement, forwardRef } from "react";
+import { getClassName } from "./shared.js";
+const TypographyTitle = /*#__PURE__*/ forwardRef(({ size = 28, tag, weight = 'bold', color = 'inherit', caps = false, monospaceNumbers = false, rowLimit, className, dataTestId, children, ...restProps }, ref)=>/*#__PURE__*/ createElement(tag, {
+        ...restProps,
+        ref,
+        className: getClassName({
+            size,
+            weight,
+            color,
+            caps,
+            monospaceNumbers,
+            rowLimit,
+            className
+        }),
+        'data-test-id': dataTestId
+    }, children));
+TypographyTitle.displayName = 'TypographyTitle';
+export { TypographyTitle };

package/dist/components/Typography/vars.css

@@ -0,0 +1,27 @@
+:root {
+  --typography-line-height: normal;
+  --typography-letter-spacing: 0;
+  --typography-regular-font-weight: 400;
+  --typography-medium-font-weight: 500;
+  --typography-semibold-font-weight: 600;
+  --typography-bold-font-weight: 700;
+  --typography-primary-color: #1c1a18;
+  --typography-secondary-color: #736554;
+  --typography-inverse-color: #f5f3ec;
+  --typography-positive-color: #4caf50;
+  --typography-negative-color: #ef5350;
+  --typography-font-size-8: 8px;
+  --typography-font-size-9: 9px;
+  --typography-font-size-10: 10px;
+  --typography-font-size-11: 11px;
+  --typography-font-size-12: 12px;
+  --typography-font-size-13: 13px;
+  --typography-font-size-14: 14px;
+  --typography-font-size-15: 15px;
+  --typography-font-size-16: 16px;
+  --typography-font-size-20: 20px;
+  --typography-font-size-24: 24px;
+  --typography-font-size-28: 28px;
+  --typography-font-size-32: 32px;
+}
+

package/dist/index.d.ts

@@ -2,3 +2,7 @@ export { Button } from './components/Button/index.js';
 export type { ButtonProps } from './components/Button/index.js';
 export { Spinner } from './components/Spinner/index.js';
 export type { SpinnerProps } from './components/Spinner/index.js';
+export { Typography, TypographyText, TypographyTitle, Text, Title } from './components/Typography/index.js';
+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';

package/dist/index.js

@@ -1,2 +1,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";

package/dist/styles/fonts/inter/LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter) Inter-Italic[opsz,wght].ttf: Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/styles/fonts.css

@@ -0,0 +1,63 @@
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-cyrillic-ext-wght-normal.woff2) format("woff2");
+  unicode-range: U+460-52F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-cyrillic-wght-normal.woff2) format("woff2");
+  unicode-range: U+301, U+400-45F, U+490-491, U+4B0-4B1, U+2116;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-greek-ext-wght-normal.woff2) format("woff2");
+  unicode-range: U+1F??;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-greek-wght-normal.woff2) format("woff2");
+  unicode-range: U+370-377, U+37A-37F, U+384-38A, U+38C, U+38E-3A1, U+3A3-3FF;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-vietnamese-wght-normal.woff2) format("woff2");
+  unicode-range: U+102-103, U+110-111, U+128-129, U+168-169, U+1A0-1A1, U+1AF-1B0, U+300-301, U+303-304, U+308-309, U+323, U+329, U+1EA0-1EF9, U+20AB;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-latin-ext-wght-normal.woff2) format("woff2");
+  unicode-range: U+100-2BA, U+2BD-2C5, U+2C7-2CC, U+2CE-2D7, U+2DD-2FF, U+304, U+308, U+329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: Inter;
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url(../static/font/inter-latin-wght-normal.woff2) format("woff2");
+  unicode-range: U+??, U+131, U+152-153, U+2BB-2BC, U+2C6, U+2DA, U+2DC, U+304, U+308, U+329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+

package/dist/styles/theme.css

@@ -0,0 +1,8 @@
+@import "./fonts.css";
+
+@layer koslibs {
+  :root {
+    --font-primary: "Inter", sans-serif;
+  }
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@koslibs/components",
-    "version": "1.0.0",
+    "version": "1.2.0",
     "description": "Shared React components for koslibs projects",
     "type": "module",
     "main": "./dist/index.js",
@@ -10,6 +10,7 @@
             "types": "./dist/index.d.ts",
             "import": "./dist/index.js"
         },
+        "./theme.css": "./dist/styles/theme.css",
         "./*": {
             "types": "./dist/components/*/index.d.ts",
             "import": "./dist/components/*/index.js"
@@ -79,6 +80,7 @@
         "react-dom": "^18.3.1 || ^19.0.0"
     },
     "dependencies": {
+        "@popperjs/core": "2.11.8",
         "classnames": "2.5.1"
     }
 }