@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.13

package/storybook-static/assets/README-C3Is3a3B.js

@@ -0,0 +1,208 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Data/Number Scale`}),`
+`,(0,c.jsx)(t.h1,{id:`number-scale`,children:`Number Scale`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/number-scale`}),` содержит чистую математику для slider, range, числовой шкалы и управления значением с клавиатуры. Модуль не содержит React-компонентов и не рисует ползунок.`]}),`
+`,(0,c.jsx)(t.p,{children:`Он решает четыре связанные задачи:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`нормализует границы и шаг;`}),`
+`,(0,c.jsx)(t.li,{children:`ограничивает и округляет значение;`}),`
+`,(0,c.jsxs)(t.li,{children:[`преобразует значение в позицию `,(0,c.jsx)(t.code,{children:`0..100%`}),` и обратно;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`работает с дискретными точками `,(0,c.jsx)(t.code,{children:`marks`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	offsetNumberScaleValue,
+	percentToSnappedNumberScaleValue,
+	prepareNumberScaleMarks,
+	snapNumberScaleValue,
+	valueToNumberScalePercent,
+	type NumberScaleMark,
+	type NumberScaleOptions
+} from "@ryuzaki13/react-foundation-lib/number-scale";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Все функции синхронные, не меняют DOM и подходят для браузера, сервера и тестов.`}),`
+`,(0,c.jsx)(t.h2,{id:`две-модели-шкалы`,children:`Две модели шкалы`}),`
+`,(0,c.jsx)(t.h3,{id:`шаговая-шкала`,children:`Шаговая шкала`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = {
+	min: 0,
+	max: 100,
+	step: 5
+};
+
+snapNumberScaleValue(17, options); // 15
+snapNumberScaleValue(18, options); // 20
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Когда `,(0,c.jsx)(t.code,{children:`marks`}),` отсутствуют, допустимые точки идут от `,(0,c.jsx)(t.code,{children:`min`}),` с интервалом `,(0,c.jsx)(t.code,{children:`step`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`шкала-с-marks`,children:`Шкала с marks`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const marks = [
+	{ value: 1, label: "1 час" },
+	{ value: 3, label: "3 часа" },
+	{ value: 6, label: "6 часов" },
+	{ value: 12, label: "12 часов" },
+	{ value: 24, label: "Сутки" }
+];
+
+snapNumberScaleValue(10, { min: 1, max: 24, marks }); // 12
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если после подготовки остаётся хотя бы один mark, `,(0,c.jsx)(t.code,{children:`marks`}),` полностью заменяют `,(0,c.jsx)(t.code,{children:`step`}),` для snap-логики.`]}),`
+`,(0,c.jsx)(t.h2,{id:`базовые-типы`,children:`Базовые типы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type NumberScaleMarksPosition = "value" | "index";
+
+interface NumberScaleMark {
+	value: number;
+}
+
+interface NumberScaleOptions<TMark extends NumberScaleMark = NumberScaleMark> {
+	min: number;
+	max: number;
+	step?: number;
+	marks?: readonly TMark[];
+	marksPosition?: NumberScaleMarksPosition;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Mark может иметь дополнительные поля: `,(0,c.jsx)(t.code,{children:`label`}),`, `,(0,c.jsx)(t.code,{children:`disabled`}),`, `,(0,c.jsx)(t.code,{children:`description`}),` и любые данные UI. Функции требуют только числовой `,(0,c.jsx)(t.code,{children:`value`}),` и сохраняют исходный объект.`]}),`
+`,(0,c.jsx)(t.h2,{id:`границы-clamp-и-шаг`,children:`Границы, clamp и шаг`}),`
+`,(0,c.jsx)(t.h3,{id:`resolvenumberscaleboundsmin-max`,children:(0,c.jsx)(t.code,{children:`resolveNumberScaleBounds(min, max)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`{ min, max }`}),` в правильном порядке.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveNumberScaleBounds(0, 100); // { min: 0, max: 100 }
+resolveNumberScaleBounds(100, 0); // { min: 0, max: 100 }
+resolveNumberScaleBounds(NaN, 10); // { min: 0, max: 100 }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если хотя бы одна граница не является конечным числом, используются безопасные значения `,(0,c.jsx)(t.code,{children:`0`}),` и `,(0,c.jsx)(t.code,{children:`100`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`clampnumberscalevaluevalue-min-max`,children:(0,c.jsx)(t.code,{children:`clampNumberScaleValue(value, min, max)`})}),`
+`,(0,c.jsx)(t.p,{children:`Ограничивает число переданными границами.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`clampNumberScaleValue(-10, 0, 100); // 0
+clampNumberScaleValue(120, 0, 100); // 100
+clampNumberScaleValue(NaN, 10, 100); // 10
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция не переставляет `,(0,c.jsx)(t.code,{children:`min`}),` и `,(0,c.jsx)(t.code,{children:`max`}),`. Если они могут прийти в обратном порядке, сначала вызовите `,(0,c.jsx)(t.code,{children:`resolveNumberScaleBounds`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizenumberscalestepstep`,children:(0,c.jsx)(t.code,{children:`normalizeNumberScaleStep(step)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`step`}),`, если это конечное положительное число. Для `,(0,c.jsx)(t.code,{children:`undefined`}),`, `,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),`, нуля и отрицательного значения возвращает `,(0,c.jsx)(t.code,{children:`1`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`подготовка-marks`,children:`Подготовка marks`}),`
+`,(0,c.jsx)(t.h3,{id:`preparenumberscalemarksmarks-min-max`,children:(0,c.jsx)(t.code,{children:`prepareNumberScaleMarks(marks, min, max)`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`удаляет marks с `,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),` и значениями вне диапазона;`]}),`
+`,(0,c.jsx)(t.li,{children:`создаёт новый массив;`}),`
+`,(0,c.jsxs)(t.li,{children:[`сортирует его по `,(0,c.jsx)(t.code,{children:`value`}),` по возрастанию;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет повторные `,(0,c.jsx)(t.code,{children:`value`}),`, сохраняя первый объект.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const prepared = prepareNumberScaleMarks(
+	[
+		{ value: 75, label: "75" },
+		{ value: 25, label: "первый 25" },
+		{ value: 25, label: "повтор" },
+		{ value: 200, label: "вне шкалы" }
+	],
+	0,
+	100
+);
+
+// [{ value: 25, label: "первый 25" }, { value: 75, label: "75" }]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Исходный массив не сортируется и не изменяется. Границы считаются уже нормализованными.`}),`
+`,(0,c.jsx)(t.h2,{id:`привязка-значения-к-допустимой-точке`,children:`Привязка значения к допустимой точке`}),`
+`,(0,c.jsx)(t.h3,{id:`snapnumberscalevaluetostepvalue-min-max-step`,children:(0,c.jsx)(t.code,{children:`snapNumberScaleValueToStep(value, min, max, step?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала ограничивает значение, затем округляет его к ближайшему шагу, отсчитываемому от `,(0,c.jsx)(t.code,{children:`min`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`snapNumberScaleValueToStep(16, 0, 100, 5); // 15
+snapNumberScaleValueToStep(18, 0, 100, 5); // 20
+snapNumberScaleValueToStep(16.24, 0, 100, 0.25); // 16.25
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Десятичная точность вычисляется из `,(0,c.jsx)(t.code,{children:`min`}),`, `,(0,c.jsx)(t.code,{children:`max`}),` и `,(0,c.jsx)(t.code,{children:`step`}),`, что уменьшает типичные артефакты вроде `,(0,c.jsx)(t.code,{children:`0.30000000000000004`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При точном равенстве расстояний используется `,(0,c.jsx)(t.code,{children:`Math.round`}),`: выбирается точка с большим смещением от `,(0,c.jsx)(t.code,{children:`min`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`findclosestnumberscalemarkvalue-marks`,children:(0,c.jsx)(t.code,{children:`findClosestNumberScaleMark(value, marks)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает ближайший объект mark или `,(0,c.jsx)(t.code,{children:`undefined`}),` для пустого массива. При равном расстоянии остаётся первый элемент массива. Обычно перед этим следует подготовить marks, чтобы первый означал меньшее значение.`]}),`
+`,(0,c.jsx)(t.h3,{id:`snapnumberscalevaluetomarksvalue-marks-min-max`,children:(0,c.jsx)(t.code,{children:`snapNumberScaleValueToMarks(value, marks, min, max)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ограничивает значение и возвращает `,(0,c.jsx)(t.code,{children:`value`}),` ближайшего mark. Для пустого массива возвращает только ограниченное значение без округления к шагу.`]}),`
+`,(0,c.jsx)(t.h3,{id:`snapnumberscalevaluevalue-options`,children:(0,c.jsx)(t.code,{children:`snapNumberScaleValue(value, options)`})}),`
+`,(0,c.jsx)(t.p,{children:`Высокоуровневая функция. Она сама нормализует границы и marks, затем выбирает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`snap к `,(0,c.jsx)(t.code,{children:`marks`}),`, если после фильтрации они есть;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`snap к `,(0,c.jsx)(t.code,{children:`step`}),`, если marks нет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для большинства форм и reducer это основной метод.`}),`
+`,(0,c.jsx)(t.h2,{id:`значение-и-проценты`,children:`Значение и проценты`}),`
+`,(0,c.jsx)(t.h3,{id:`valuetonumberscalepercentvalue-min-max`,children:(0,c.jsx)(t.code,{children:`valueToNumberScalePercent(value, min, max)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Преобразует число шкалы в позицию от `,(0,c.jsx)(t.code,{children:`0`}),` до `,(0,c.jsx)(t.code,{children:`100`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`valueToNumberScalePercent(25, 0, 100); // 25
+valueToNumberScalePercent(6, 1, 24); // около 21.739
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`max <= min`}),`, возвращается `,(0,c.jsx)(t.code,{children:`0`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`percenttonumberscalevaluepercent-min-max`,children:(0,c.jsx)(t.code,{children:`percentToNumberScaleValue(percent, min, max)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Выполняет обратное преобразование. Процент ограничивается диапазоном `,(0,c.jsx)(t.code,{children:`0..100`}),`. Если `,(0,c.jsx)(t.code,{children:`max <= min`}),`, возвращается `,(0,c.jsx)(t.code,{children:`min`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`percentToNumberScaleValue(50, 0, 10); // 5
+percentToNumberScaleValue(150, 0, 10); // 10
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Эта функция не делает snap. Для значения от pointer обычно нужен `,(0,c.jsx)(t.code,{children:`percentToSnappedNumberScaleValue`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`позиционирование-marks`,children:`Позиционирование marks`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`marksPosition`}),` определяет только визуальное расположение marks и выбор ближайшего mark по проценту.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-value`,children:[`Режим `,(0,c.jsx)(t.code,{children:`value`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Значения располагаются пропорционально числовой шкале. Например, `,(0,c.jsx)(t.code,{children:`1, 3, 6, 12, 24`}),` будут сгруппированы ближе к началу.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-index`,children:[`Режим `,(0,c.jsx)(t.code,{children:`index`})]}),`
+`,(0,c.jsx)(t.p,{children:`Все точки располагаются равномерно независимо от числового расстояния:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`1        3        6        12       24
+0%      25%      50%      75%      100%
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это полезно для категориальной шкалы, где каждое значение — отдельный выбор, а не физическое расстояние.`}),`
+`,(0,c.jsx)(t.h3,{id:`getnumberscalemarkpercentindex-marks-min-max-marksposition`,children:(0,c.jsx)(t.code,{children:`getNumberScaleMarkPercent(index, marks, min, max, marksPosition?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает процент позиции одного mark. В режиме `,(0,c.jsx)(t.code,{children:`index`}),` единственный mark находится на `,(0,c.jsx)(t.code,{children:`0%`}),`. В режиме `,(0,c.jsx)(t.code,{children:`value`}),` используется `,(0,c.jsx)(t.code,{children:`marks[index]?.value`}),`; при неверном индексе — `,(0,c.jsx)(t.code,{children:`min`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`findclosestnumberscalemarkbypercent`,children:(0,c.jsx)(t.code,{children:`findClosestNumberScaleMarkByPercent(...)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Находит mark, визуально ближайший к переданному проценту. Процент ограничивается `,(0,c.jsx)(t.code,{children:`0..100`}),`; для пустого массива возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`. При равном расстоянии выбирается первый mark.`]}),`
+`,(0,c.jsx)(t.h3,{id:`percenttosnappednumberscalevaluepercent-options`,children:(0,c.jsx)(t.code,{children:`percentToSnappedNumberScaleValue(percent, options)`})}),`
+`,(0,c.jsx)(t.p,{children:`Основная функция для pointer-события:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const nextValue = percentToSnappedNumberScaleValue(pointerPercent, {
+	min: 1,
+	max: 24,
+	marks,
+	marksPosition: "index"
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`С marks она выбирает ближайшую визуальную точку. Без marks преобразует процент в число и округляет его к `,(0,c.jsx)(t.code,{children:`step`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`клавиатура-и-смещение`,children:`Клавиатура и смещение`}),`
+`,(0,c.jsx)(t.h3,{id:`offsetnumberscalevaluecurrentvalue-offset-options-lowerbound-upperbound`,children:(0,c.jsx)(t.code,{children:`offsetNumberScaleValue(currentValue, offset, options, lowerBound?, upperBound?)`})}),`
+`,(0,c.jsx)(t.p,{children:`Сдвигает значение на количество шагов или marks.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`offsetNumberScaleValue(34, 1, {
+	min: 0,
+	max: 100,
+	marks: [{ value: 0 }, { value: 30 }, { value: 80 }]
+}); // 80
+
+offsetNumberScaleValue(34, 2, {
+	min: 0,
+	max: 100,
+	step: 10
+}); // 50
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`offset = -1`}),` подходит для `,(0,c.jsx)(t.code,{children:`ArrowLeft`}),`/`,(0,c.jsx)(t.code,{children:`ArrowDown`}),`, `,(0,c.jsx)(t.code,{children:`offset = 1`}),` — для `,(0,c.jsx)(t.code,{children:`ArrowRight`}),`/`,(0,c.jsx)(t.code,{children:`ArrowUp`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`lowerBound`}),` и `,(0,c.jsx)(t.code,{children:`upperBound`}),` позволяют временно сузить допустимую область, например чтобы левый thumb не пересёк правый.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для шкалы с marks передавайте целое смещение. Дробный индекс не является корректной позицией массива и может привести к `,(0,c.jsx)(t.code,{children:`undefined`}),` на уровне JavaScript, хотя тип функции выводится как число.`]}),`
+`,(0,c.jsx)(t.h2,{id:`пример-reducer-для-slider`,children:`Пример reducer для slider`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = { min: 0, max: 100, step: 5 } as const;
+
+function fromPointer(clientX: number, left: number, width: number) {
+	const percent = width > 0 ? ((clientX - left) / width) * 100 : 0;
+	return percentToSnappedNumberScaleValue(percent, options);
+}
+
+function fromKeyboard(current: number, key: string) {
+	if (key === "ArrowLeft" || key === "ArrowDown") {
+		return offsetNumberScaleValue(current, -1, options);
+	}
+
+	if (key === "ArrowRight" || key === "ArrowUp") {
+		return offsetNumberScaleValue(current, 1, options);
+	}
+
+	return current;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`UI отдельно отвечает за `,(0,c.jsx)(t.code,{children:`role="slider"`}),`, `,(0,c.jsx)(t.code,{children:`aria-valuemin`}),`, `,(0,c.jsx)(t.code,{children:`aria-valuemax`}),`, `,(0,c.jsx)(t.code,{children:`aria-valuenow`}),`, фокус и обработку клавиатуры.`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Передавать ненормализованные обратные границы напрямую в низкоуровневый `,(0,c.jsx)(t.code,{children:`clamp`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Ожидать, что `,(0,c.jsx)(t.code,{children:`step`}),` действует одновременно с непустыми `,(0,c.jsx)(t.code,{children:`marks`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`marksPosition: "index"`}),` изменением самих числовых значений. Меняется только визуальная геометрия выбора.`]}),`
+`,(0,c.jsx)(t.li,{children:`Изменять исходные marks после мемоизации UI. Подготовка возвращает новый массив, но сами объекты не клонирует.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Передавать дробный `,(0,c.jsx)(t.code,{children:`offset`}),` при работе с marks.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`краткая-карта-api`,children:`Краткая карта API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Функция`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveNumberScaleBounds`})}),(0,c.jsx)(t.td,{children:`Безопасные границы в правильном порядке`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`clampNumberScaleValue`})}),(0,c.jsx)(t.td,{children:`Значение внутри границ`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeNumberScaleStep`})}),(0,c.jsxs)(t.td,{children:[`Положительный конечный шаг или `,(0,c.jsx)(t.code,{children:`1`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`prepareNumberScaleMarks`})}),(0,c.jsx)(t.td,{children:`Отфильтрованные, отсортированные и уникальные marks`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`snapNumberScaleValueToStep`})}),(0,c.jsx)(t.td,{children:`Ближайшая точка шага`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findClosestNumberScaleMark`})}),(0,c.jsx)(t.td,{children:`Ближайший объект mark`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`snapNumberScaleValueToMarks`})}),(0,c.jsx)(t.td,{children:`Значение ближайшего mark`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`snapNumberScaleValue`})}),(0,c.jsx)(t.td,{children:`Snap по marks либо step`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`valueToNumberScalePercent`})}),(0,c.jsx)(t.td,{children:`Число → процент`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`percentToNumberScaleValue`})}),(0,c.jsx)(t.td,{children:`Процент → число без snap`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getNumberScaleMarkPercent`})}),(0,c.jsx)(t.td,{children:`Визуальная позиция mark`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findClosestNumberScaleMarkByPercent`})}),(0,c.jsx)(t.td,{children:`Ближайший mark по track`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`percentToSnappedNumberScaleValue`})}),(0,c.jsx)(t.td,{children:`Процент → готовое допустимое значение`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`offsetNumberScaleValue`})}),(0,c.jsx)(t.td,{children:`Смещение по step или marks`})]})]})]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

package/storybook-static/assets/{README-C0BwTe5N.js → README-C6prwAXw.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Number`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Number`}),`
 `,(0,c.jsx)(t.h1,{id:`числовые-форматтеры`,children:`Числовые форматтеры`}),`
 `,(0,c.jsx)(t.p,{children:`Модуль форматирует числа для интерфейса, читает распространённые SAP-подобные числовые строки и управляет реестром именованных presets.`}),`
 `,(0,c.jsx)(t.p,{children:`Все API доступны через один публичный entrypoint:`}),`

package/storybook-static/assets/{README-BzVni2ve.js → README-C9S83J_G.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formulas`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formulas`}),`
 `,(0,c.jsx)(t.h1,{id:`табличные-формулы`,children:`Табличные формулы`}),`
 `,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formulas`}),` предоставляет безопасную инфраструктуру для заранее написанных клиентских формул таблицы.`]}),`
 `,(0,c.jsx)(t.p,{children:`Формула получает значения других полей текущей строки, выполняет синхронный расчёт и возвращает конечное JavaScript-число. Например, она может вычислить сумму, разницу, отношение или процент для calculated-колонки.`}),`

package/storybook-static/assets/{README-BHw6MVjD.js → README-CGgxP5Zo.js}

@@ -1,4 +1,4 @@
-import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-Sr0umHM6.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-DndFRxxW.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Row-Based`}),`
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-o7sH2IXC.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-BY40djCc.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Row-Based`}),`
 `,(0,c.jsx)(t.h1,{id:`row-based-форматтеры`,children:`Row-based форматтеры`}),`
 `,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`rowBased`}),` — небольшой runtime-слой для формул, которые вычисляют отображаемое значение одной ячейки на основании других полей той же строки.`]}),`
 `,(0,c.jsxs)(t.p,{children:[`Он используется шагом `,(0,c.jsx)(t.code,{children:`rowBasedOverride`}),` в `,(0,c.jsx)(t.a,{href:`../pipeline/README.mdx`,children:`formatter pipeline`}),`. Сам модуль не содержит бизнес-формул: host-приложение создаёт их, собирает в реестр и один раз передаёт реестр библиотеке.`]}),`