@astral/ui 4.74.0 → 4.75.0

package/node/components/DialogActions/styles.js

@@ -8,6 +8,8 @@ const DialogActions_1 = __importDefault(require("@mui/material/DialogActions"));
 const Grid_1 = require("../Grid");
 const styled_1 = require("../styled");
 exports.StyledDialogActions = (0, styled_1.styled)(DialogActions_1.default) `
+  z-index: ${({ theme }) => theme.zIndex.modal};
+
   padding-top: ${({ theme }) => theme.spacing(6)};
 
   ${({ theme }) => theme.breakpoints.down('sm')} {

package/node/components/DonutChart/DonutChart.d.ts

@@ -0,0 +1,2 @@
+import type { DonutChartProps } from './types';
+export declare const DonutChart: ({ value, maxValue, children, color, colorIntensity, className, style, }: DonutChartProps) => import("react/jsx-runtime").JSX.Element;

package/node/components/DonutChart/DonutChart.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DonutChart = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const classNames_1 = require("../utils/classNames");
+const constants_1 = require("./constants");
+const styles_1 = require("./styles");
+const useLogic_1 = require("./useLogic");
+const DonutChart = ({ value, maxValue, children, color = 'primary', colorIntensity = '700', className, style, }) => {
+    const { rootRef, svgViewBox, arcCx, arcCy, donutParams, meterAriaValue } = (0, useLogic_1.useLogic)({ value, maxValue, color, colorIntensity });
+    return ((0, jsx_runtime_1.jsxs)(styles_1.Wrapper, { ref: rootRef, className: (0, classNames_1.classNames)(constants_1.donutChartClassnames.root, className), role: "meter", "aria-label": meterAriaValue.label, "aria-valuemin": meterAriaValue.min, "aria-valuemax": meterAriaValue.max, "aria-valuenow": meterAriaValue.now, style: { ...donutParams?.cssVars, ...style }, children: [donutParams && ((0, jsx_runtime_1.jsxs)(styles_1.Svg, { className: constants_1.donutChartClassnames.svg, viewBox: svgViewBox, "aria-hidden": true, children: [(0, jsx_runtime_1.jsx)(styles_1.TrackArc, { className: constants_1.donutChartClassnames.track, cx: arcCx, cy: arcCy, r: donutParams.arcR }), (0, jsx_runtime_1.jsx)(styles_1.ProgressArc, { className: constants_1.donutChartClassnames.progress, d: donutParams.arcPath, pathLength: 1, strokeDasharray: 1, strokeDashoffset: donutParams.progressOffset })] })), children && ((0, jsx_runtime_1.jsx)(styles_1.Content, { className: constants_1.donutChartClassnames.content, children: children }))] }));
+};
+exports.DonutChart = DonutChart;

package/node/components/DonutChart/constants.d.ts

@@ -0,0 +1,15 @@
+/** Нормализованная система координат SVG. Масштаб — через CSS 100%. */
+export declare const DONUT_CHART_VIEWBOX = 100;
+/** Центр дуги в координатах viewBox (cx, cy). */
+export declare const DONUT_CHART_VIEWBOX_CENTER: number;
+/** Толщина обводки на экране (px), пересчитывается в единицы viewBox через getGeometry. */
+export declare const DONUT_CHART_STROKE_WIDTH = 8;
+/** Атрибут viewBox SVG (квадрат DONUT_CHART_VIEWBOX × DONUT_CHART_VIEWBOX). */
+export declare const DONUT_CHART_SVG_VIEWBOX: "0 0 100 100";
+export declare const donutChartClassnames: {
+    root: string;
+    svg: string;
+    track: string;
+    progress: string;
+    content: string;
+};

package/node/components/DonutChart/constants.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.donutChartClassnames = exports.DONUT_CHART_SVG_VIEWBOX = exports.DONUT_CHART_STROKE_WIDTH = exports.DONUT_CHART_VIEWBOX_CENTER = exports.DONUT_CHART_VIEWBOX = void 0;
+const createUIKitClassname_1 = require("../utils/createUIKitClassname");
+/** Нормализованная система координат SVG. Масштаб — через CSS 100%. */
+exports.DONUT_CHART_VIEWBOX = 100;
+/** Центр дуги в координатах viewBox (cx, cy). */
+exports.DONUT_CHART_VIEWBOX_CENTER = exports.DONUT_CHART_VIEWBOX / 2;
+/** Толщина обводки на экране (px), пересчитывается в единицы viewBox через getGeometry. */
+exports.DONUT_CHART_STROKE_WIDTH = 8;
+/** Атрибут viewBox SVG (квадрат DONUT_CHART_VIEWBOX × DONUT_CHART_VIEWBOX). */
+exports.DONUT_CHART_SVG_VIEWBOX = `0 0 ${exports.DONUT_CHART_VIEWBOX} ${exports.DONUT_CHART_VIEWBOX}`;
+exports.donutChartClassnames = {
+    root: (0, createUIKitClassname_1.createUIKitClassname)('donut-chart'),
+    svg: (0, createUIKitClassname_1.createUIKitClassname)('donut-chart__svg'),
+    track: (0, createUIKitClassname_1.createUIKitClassname)('donut-chart__track'),
+    progress: (0, createUIKitClassname_1.createUIKitClassname)('donut-chart__progress'),
+    content: (0, createUIKitClassname_1.createUIKitClassname)('donut-chart__content'),
+};

package/node/components/DonutChart/index.d.ts

@@ -0,0 +1,3 @@
+export { DonutChart } from './DonutChart';
+export type { DonutChartProps } from './types';
+export { donutChartClassnames } from './constants';

package/node/components/DonutChart/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.donutChartClassnames = exports.DonutChart = void 0;
+var DonutChart_1 = require("./DonutChart");
+Object.defineProperty(exports, "DonutChart", { enumerable: true, get: function () { return DonutChart_1.DonutChart; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "donutChartClassnames", { enumerable: true, get: function () { return constants_1.donutChartClassnames; } });

package/node/components/DonutChart/public.d.ts

@@ -0,0 +1,3 @@
+export { donutChartClassnames } from './constants';
+export { DonutChart } from './DonutChart';
+export type { DonutChartProps } from './types';

package/node/components/DonutChart/public.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DonutChart = exports.donutChartClassnames = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "donutChartClassnames", { enumerable: true, get: function () { return constants_1.donutChartClassnames; } });
+var DonutChart_1 = require("./DonutChart");
+Object.defineProperty(exports, "DonutChart", { enumerable: true, get: function () { return DonutChart_1.DonutChart; } });

package/node/components/DonutChart/styles.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+export declare const Wrapper: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const Svg: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").SVGProps<SVGSVGElement>, {}>;
+export declare const TrackArc: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").SVGProps<SVGCircleElement>, {}>;
+export declare const ProgressArc: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").SVGProps<SVGPathElement>, {}>;
+export declare const Content: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/node/components/DonutChart/styles.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Content = exports.ProgressArc = exports.TrackArc = exports.Svg = exports.Wrapper = void 0;
+const styled_1 = require("../styled");
+exports.Wrapper = styled_1.styled.div `
+  position: relative;
+
+  aspect-ratio: 1 / 1;
+  width: 100%;
+`;
+exports.Svg = styled_1.styled.svg `
+  /* Старт дуги (точка 3 часа) переносим наверх. */
+  transform: rotate(-90deg);
+
+  display: block;
+
+  width: 100%;
+  height: 100%;
+`;
+exports.TrackArc = styled_1.styled.circle `
+  fill: none;
+  stroke: ${({ theme }) => theme.palette.grey[100]};
+  stroke-linecap: round;
+  stroke-width: var(--donut-chart-stroke-width);
+`;
+exports.ProgressArc = styled_1.styled.path `
+  fill: none;
+  stroke: var(--donut-chart-progress-color);
+  stroke-linecap: round;
+  stroke-width: var(--donut-chart-stroke-width);
+
+  transition: stroke-dashoffset
+    ${({ theme }) => theme.transitions.duration.standard}ms ease-in-out;
+`;
+exports.Content = styled_1.styled.div `
+  position: absolute;
+  inset: 0;
+
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  padding: ${({ theme }) => theme.spacing(4)};
+`;

package/node/components/DonutChart/types.d.ts

@@ -0,0 +1,27 @@
+import { type CSSProperties, type ReactNode } from 'react';
+export type DonutChartColor = 'primary' | 'success' | 'warning' | 'error' | 'grey' | 'red' | 'green' | 'yellow';
+export type DonutChartColorIntensity = '900' | '800' | '700' | '600' | '500' | '400' | '300' | '200' | '100';
+export type DonutChartProps = {
+    value: number;
+    maxValue: number;
+    /**
+     * Контент в центре. Можно передать другой `DonutChart`.
+     */
+    children?: ReactNode;
+    /**
+     * Цвет.
+     */
+    color?: DonutChartColor;
+    /**
+     * Интенсивность цвета.
+     */
+    colorIntensity?: DonutChartColorIntensity;
+    /**
+     * CSS-класс для корневого элемента.
+     */
+    className?: string;
+    /**
+     * Стили для корневого элемента.
+     */
+    style?: CSSProperties;
+};

package/node/components/DonutChart/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node/components/DonutChart/useLogic/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './useRenderWidth';

package/node/components/DonutChart/useLogic/hooks/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useRenderWidth"), exports);

package/node/components/DonutChart/useLogic/hooks/useRenderWidth/index.d.ts

@@ -0,0 +1 @@
+export * from './useRenderWidth';

package/node/components/DonutChart/useLogic/hooks/useRenderWidth/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useRenderWidth"), exports);

package/node/components/DonutChart/useLogic/hooks/useRenderWidth/useRenderWidth.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+/**
+ * Отслеживает ширину элемента и обновляет значение при resize.
+ * @returns Объект с ref для присоединения к элементу и текущей шириной в пикселях
+ */
+export declare const useRenderWidth: () => {
+    rootRef: import("react").RefObject<HTMLDivElement | null>;
+    renderWidth: number | null;
+};

package/node/components/DonutChart/useLogic/hooks/useRenderWidth/useRenderWidth.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRenderWidth = void 0;
+const react_1 = require("react");
+/**
+ * Отслеживает ширину элемента и обновляет значение при resize.
+ * @returns Объект с ref для присоединения к элементу и текущей шириной в пикселях
+ */
+const useRenderWidth = () => {
+    const rootRef = (0, react_1.useRef)(null);
+    const [renderWidth, setRenderWidth] = (0, react_1.useState)(null);
+    (0, react_1.useLayoutEffect)(() => {
+        const node = rootRef.current;
+        if (!node) {
+            return;
+        }
+        const initialWidth = node.getBoundingClientRect().width;
+        if (initialWidth > 0) {
+            setRenderWidth(initialWidth);
+        }
+        const resizeObserver = new ResizeObserver((entries) => {
+            const width = entries[0]?.contentRect.width ?? 0;
+            if (width > 0) {
+                setRenderWidth(width);
+            }
+        });
+        resizeObserver.observe(node);
+        return () => {
+            resizeObserver.disconnect();
+        };
+    }, []);
+    return { rootRef, renderWidth };
+};
+exports.useRenderWidth = useRenderWidth;

package/node/components/DonutChart/useLogic/index.d.ts

@@ -0,0 +1 @@
+export * from './useLogic';

package/node/components/DonutChart/useLogic/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useLogic"), exports);

package/node/components/DonutChart/useLogic/useLogic.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import type { DonutChartProps } from '../types';
+export declare const useLogic: ({ value, maxValue, color, colorIntensity, }: DonutChartProps) => {
+    rootRef: import("react").RefObject<HTMLDivElement | null>;
+    svgViewBox: "0 0 100 100";
+    arcCx: number;
+    arcCy: number;
+    donutParams: {
+        arcR: number;
+        arcPath: string;
+        progressOffset: number;
+        cssVars: import("react").CSSProperties;
+    } | null;
+    meterAriaValue: import("./utils/getMeterAriaValue").MeterAriaValue;
+};

package/node/components/DonutChart/useLogic/useLogic.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLogic = void 0;
+const react_1 = require("react");
+const useTheme_1 = require("../../theme/hooks/useTheme");
+const constants_1 = require("../constants");
+const hooks_1 = require("./hooks");
+const getDonutChartCssVars_1 = require("./utils/getDonutChartCssVars");
+const getGeometry_1 = require("./utils/getGeometry");
+const getMeterAriaValue_1 = require("./utils/getMeterAriaValue");
+const getProgressCirclePath_1 = require("./utils/getProgressCirclePath");
+const getProgressOffset_1 = require("./utils/getProgressOffset");
+const getProgressPercent_1 = require("./utils/getProgressPercent");
+const useLogic = ({ value, maxValue, color = 'primary', colorIntensity = '700', }) => {
+    const theme = (0, useTheme_1.useTheme)();
+    const { rootRef, renderWidth } = (0, hooks_1.useRenderWidth)();
+    const progressPercent = (0, getProgressPercent_1.getProgressPercent)(value, maxValue);
+    const meterAriaValue = (0, getMeterAriaValue_1.getMeterAriaValue)(value, maxValue);
+    const donutParams = (0, react_1.useMemo)(() => {
+        if (renderWidth === null) {
+            return null;
+        }
+        const { stroke, radius, roundCapPercent } = (0, getGeometry_1.getGeometry)(renderWidth);
+        return {
+            arcR: radius,
+            arcPath: (0, getProgressCirclePath_1.getProgressCirclePath)(constants_1.DONUT_CHART_VIEWBOX_CENTER, constants_1.DONUT_CHART_VIEWBOX_CENTER, radius),
+            progressOffset: (0, getProgressOffset_1.getProgressOffset)(progressPercent, roundCapPercent),
+            cssVars: (0, getDonutChartCssVars_1.getDonutChartCssVars)(theme, {
+                color,
+                colorIntensity,
+                strokeWidth: stroke,
+            }),
+        };
+    }, [renderWidth, progressPercent, color, colorIntensity, theme]);
+    return {
+        rootRef,
+        svgViewBox: constants_1.DONUT_CHART_SVG_VIEWBOX,
+        arcCx: constants_1.DONUT_CHART_VIEWBOX_CENTER,
+        arcCy: constants_1.DONUT_CHART_VIEWBOX_CENTER,
+        donutParams,
+        meterAriaValue,
+    };
+};
+exports.useLogic = useLogic;

package/node/components/DonutChart/useLogic/utils/getDonutChartCssVars/getDonutChartCssVars.d.ts

@@ -0,0 +1,16 @@
+import type { CSSProperties } from 'react';
+import type { Theme } from '../../../../theme/types';
+import type { DonutChartColor, DonutChartColorIntensity } from '../../../types';
+type GetDonutChartCssVarsParams = {
+    color: DonutChartColor;
+    colorIntensity: DonutChartColorIntensity;
+    strokeWidth: number;
+};
+/**
+ * Генерирует CSS переменные для стилизации DonutChart по теме и цвету.
+ * @param theme - Объект темы с палитрой цветов
+ * @param params - Параметры цвета, интенсивности и ширины stroke
+ * @returns CSS свойства для диаграммы
+ */
+export declare const getDonutChartCssVars: (theme: Theme, { color, colorIntensity, strokeWidth }: GetDonutChartCssVarsParams) => CSSProperties;
+export {};

package/node/components/DonutChart/useLogic/utils/getDonutChartCssVars/getDonutChartCssVars.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDonutChartCssVars = void 0;
+/**
+ * Генерирует CSS переменные для стилизации DonutChart по теме и цвету.
+ * @param theme - Объект темы с палитрой цветов
+ * @param params - Параметры цвета, интенсивности и ширины stroke
+ * @returns CSS свойства для диаграммы
+ */
+const getDonutChartCssVars = (theme, { color, colorIntensity, strokeWidth }) => ({
+    '--donut-chart-stroke-width': String(strokeWidth),
+    '--donut-chart-progress-color': theme.palette[color][colorIntensity],
+});
+exports.getDonutChartCssVars = getDonutChartCssVars;

package/node/components/DonutChart/useLogic/utils/getDonutChartCssVars/index.d.ts

@@ -0,0 +1 @@
+export { getDonutChartCssVars } from './getDonutChartCssVars';

package/node/components/DonutChart/useLogic/utils/getDonutChartCssVars/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDonutChartCssVars = void 0;
+var getDonutChartCssVars_1 = require("./getDonutChartCssVars");
+Object.defineProperty(exports, "getDonutChartCssVars", { enumerable: true, get: function () { return getDonutChartCssVars_1.getDonutChartCssVars; } });

package/node/components/DonutChart/useLogic/utils/getGeometry/getGeometry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Вычисляет геометрию дуги в координатах viewBox по ширине контейнера.
+ * @param renderWidth - Ширина контейнера в пикселях
+ * @returns Геометрия дуги со stroke, радиусом и процентом round cap для расчетов
+ */
+export declare const getGeometry: (renderWidth: number) => {
+    stroke: number;
+    radius: number;
+    roundCapPercent: number;
+};

package/node/components/DonutChart/useLogic/utils/getGeometry/getGeometry.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGeometry = void 0;
+const constants_1 = require("../../../constants");
+/**
+ * Вычисляет геометрию дуги в координатах viewBox по ширине контейнера.
+ * @param renderWidth - Ширина контейнера в пикселях
+ * @returns Геометрия дуги со stroke, радиусом и процентом round cap для расчетов
+ */
+const getGeometry = (renderWidth) => {
+    const stroke = (constants_1.DONUT_CHART_STROKE_WIDTH * constants_1.DONUT_CHART_VIEWBOX) / renderWidth;
+    const radius = constants_1.DONUT_CHART_VIEWBOX_CENTER - stroke / 2;
+    const circumference = 2 * Math.PI * radius;
+    const roundCapPercent = (stroke / circumference) * 100;
+    return { stroke, radius, roundCapPercent };
+};
+exports.getGeometry = getGeometry;

package/node/components/DonutChart/useLogic/utils/getGeometry/index.d.ts

@@ -0,0 +1 @@
+export { getGeometry } from './getGeometry';

package/node/components/DonutChart/useLogic/utils/getGeometry/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGeometry = void 0;
+var getGeometry_1 = require("./getGeometry");
+Object.defineProperty(exports, "getGeometry", { enumerable: true, get: function () { return getGeometry_1.getGeometry; } });

package/node/components/DonutChart/useLogic/utils/getMeterAriaValue/getMeterAriaValue.d.ts

@@ -0,0 +1,13 @@
+export type MeterAriaValue = {
+    min: number;
+    max: number;
+    now: number;
+    label: string;
+};
+/**
+ * Нормализует value/maxValue для ARIA role="meter" с проверкой границ.
+ * @param value - Текущее значение
+ * @param maxValue - Максимальное значение (должно быть положительным и конечным)
+ * @returns ARIA атрибуты с свойствами min, max, now для role="meter"
+ */
+export declare const getMeterAriaValue: (value: number, maxValue: number) => MeterAriaValue;

package/node/components/DonutChart/useLogic/utils/getMeterAriaValue/getMeterAriaValue.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMeterAriaValue = void 0;
+/**
+ * Нормализует value/maxValue для ARIA role="meter" с проверкой границ.
+ * @param value - Текущее значение
+ * @param maxValue - Максимальное значение (должно быть положительным и конечным)
+ * @returns ARIA атрибуты с свойствами min, max, now для role="meter"
+ */
+const getMeterAriaValue = (value, maxValue) => {
+    const min = 0;
+    if (!Number.isFinite(maxValue) || maxValue <= 0) {
+        return { min, max: 1, now: 0, label: '0 / 1' };
+    }
+    if (!Number.isFinite(value)) {
+        return { min, max: maxValue, now: 0, label: `0 / ${maxValue}` };
+    }
+    const now = Math.max(min, Math.min(maxValue, value));
+    return {
+        min,
+        max: maxValue,
+        now,
+        label: `${now} / ${maxValue}`,
+    };
+};
+exports.getMeterAriaValue = getMeterAriaValue;

package/node/components/DonutChart/useLogic/utils/getMeterAriaValue/index.d.ts

@@ -0,0 +1 @@
+export { getMeterAriaValue, type MeterAriaValue } from './getMeterAriaValue';

package/node/components/DonutChart/useLogic/utils/getMeterAriaValue/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMeterAriaValue = void 0;
+var getMeterAriaValue_1 = require("./getMeterAriaValue");
+Object.defineProperty(exports, "getMeterAriaValue", { enumerable: true, get: function () { return getMeterAriaValue_1.getMeterAriaValue; } });

package/node/components/DonutChart/useLogic/utils/getProgressCirclePath/getProgressCirclePath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Строит `d` полного круга из двух полудуг.
+ * Без `Z` — открытый путь без шва, поэтому нет 1px-артефакта на стыке.
+ * @param cx - Центр по X
+ * @param cy - Центр по Y
+ * @param r - Радиус
+ * @returns Значение атрибута `d`
+ */
+export declare const getProgressCirclePath: (cx: number, cy: number, r: number) => string;

package/node/components/DonutChart/useLogic/utils/getProgressCirclePath/getProgressCirclePath.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProgressCirclePath = void 0;
+/** Точка на окружности по углу (0° — 3 часа, далее по часовой: y растёт вниз). */
+const polarToCartesian = (cx, cy, r, angleDeg) => {
+    const angleRad = (angleDeg * Math.PI) / 180;
+    return {
+        x: cx + r * Math.cos(angleRad),
+        y: cy + r * Math.sin(angleRad),
+    };
+};
+/**
+ * Строит `d` полного круга из двух полудуг.
+ * Без `Z` — открытый путь без шва, поэтому нет 1px-артефакта на стыке.
+ * @param cx - Центр по X
+ * @param cy - Центр по Y
+ * @param r - Радиус
+ * @returns Значение атрибута `d`
+ */
+const getProgressCirclePath = (cx, cy, r) => {
+    const start = polarToCartesian(cx, cy, r, 0);
+    const half = polarToCartesian(cx, cy, r, 180);
+    // Округляем координаты.
+    const f = (n) => Number(n.toFixed(3));
+    // Две полудуги (0°→180°→360°). Конец совпадает со стартом, но без `Z` —
+    // путь остаётся открытым, поэтому шва-стыка (источник 1px) не возникает.
+    return [
+        `M ${f(start.x)} ${f(start.y)}`,
+        `A ${f(r)} ${f(r)} 0 0 1 ${f(half.x)} ${f(half.y)}`,
+        `A ${f(r)} ${f(r)} 0 0 1 ${f(start.x)} ${f(start.y)}`,
+    ].join(' ');
+};
+exports.getProgressCirclePath = getProgressCirclePath;

package/node/components/DonutChart/useLogic/utils/getProgressCirclePath/index.d.ts

@@ -0,0 +1 @@
+export { getProgressCirclePath } from './getProgressCirclePath';

package/node/components/DonutChart/useLogic/utils/getProgressCirclePath/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProgressCirclePath = void 0;
+var getProgressCirclePath_1 = require("./getProgressCirclePath");
+Object.defineProperty(exports, "getProgressCirclePath", { enumerable: true, get: function () { return getProgressCirclePath_1.getProgressCirclePath; } });

package/node/components/DonutChart/useLogic/utils/getProgressOffset/getProgressOffset.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Вычисляет stroke-dashoffset для SVG дуги с компенсацией round linecap.
+ * Выше 90% слегка уменьшает дисплей-процент, чтобы кэп не переливал за 100%.
+ * @param percent - Процент прогресса (0–100)
+ * @param roundCapPercent - Визуальная ширина round cap в процентах от окружности
+ * @returns Значение offset от 0 (полностью видно) до 1 (скрыто)
+ */
+export declare const getProgressOffset: (percent: number, roundCapPercent: number) => number;

package/node/components/DonutChart/useLogic/utils/getProgressOffset/getProgressOffset.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProgressOffset = void 0;
+/** С какого процента начинаем компенсировать round linecap у конца дуги */
+const ROUND_CAP_RAMP_START = 90;
+/**
+ * Вычисляет stroke-dashoffset для SVG дуги с компенсацией round linecap.
+ * Выше 90% слегка уменьшает дисплей-процент, чтобы кэп не переливал за 100%.
+ * @param percent - Процент прогресса (0–100)
+ * @param roundCapPercent - Визуальная ширина round cap в процентах от окружности
+ * @returns Значение offset от 0 (полностью видно) до 1 (скрыто)
+ */
+const getProgressOffset = (percent, roundCapPercent) => {
+    if (percent >= 100) {
+        return 0;
+    }
+    if (percent <= 0) {
+        return 1;
+    }
+    const roundCapRampProgress = Math.max(0, (percent - ROUND_CAP_RAMP_START) / (100 - ROUND_CAP_RAMP_START));
+    const displayPercent = percent - roundCapPercent * roundCapRampProgress;
+    const offset = 1 - displayPercent / 100;
+    return Math.round(offset * 1000) / 1000;
+};
+exports.getProgressOffset = getProgressOffset;

package/node/components/DonutChart/useLogic/utils/getProgressOffset/index.d.ts

@@ -0,0 +1 @@
+export { getProgressOffset } from './getProgressOffset';

package/node/components/DonutChart/useLogic/utils/getProgressOffset/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProgressOffset = void 0;
+var getProgressOffset_1 = require("./getProgressOffset");
+Object.defineProperty(exports, "getProgressOffset", { enumerable: true, get: function () { return getProgressOffset_1.getProgressOffset; } });

package/node/components/DonutChart/useLogic/utils/getProgressPercent/getProgressPercent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Преобразует value/maxValue в целый процент 0–100.
+ * Дробная часть отбрасывается вниз, некорректные значения дают 0.
+ * @param value - Текущее значение
+ * @param maxValue - Максимальное значение (должно быть положительным и конечным)
+ * @returns Целый процент от 0 до 100
+ */
+export declare const getProgressPercent: (value: number, maxValue: number) => number;