@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.7

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

@@ -0,0 +1,288 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-CViB2sFm.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B8F5vBhs.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,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/Value State`}),`
+`,(0,c.jsx)(t.h1,{id:`value-state`,children:`Value state`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`valueState`}),` преобразует обычное значение в семантическое состояние интерфейса:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type State = "" | "none" | "information" | "success" | "warning" | "error";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Например, статус `,(0,c.jsx)(t.code,{children:`DONE`}),` можно связать с `,(0,c.jsx)(t.code,{children:`success`}),`, а число меньше 50 — с `,(0,c.jsx)(t.code,{children:`error`}),`. Модуль ничего не рисует: он вычисляет state, предоставляет CSS class/token helpers и используется formatter pipeline.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функции импортируются из `,(0,c.jsx)(t.code,{children:`formatters`}),`, а общий тип `,(0,c.jsx)(t.code,{children:`State`}),` — из `,(0,c.jsx)(t.code,{children:`types`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createFixedResolver, createThresholdResolver, resolveValueState } from "@ryuzaki13/react-foundation-lib/formatters";
+import type { State } from "@ryuzaki13/react-foundation-lib/types";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Отдельного package subpath `,(0,c.jsx)(t.code,{children:`formatters/valueState`}),` нет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-выбор`,children:`Быстрый выбор`}),`
+`,(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:`API`}),(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.td,{children:(0,c.jsx)(t.code,{children:`createFixedResolver`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DONE → success`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Числовые диапазоны`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createThresholdResolver`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`< 50 → error`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен сериализуемый короткий id`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`registerFixedResolver`}),`, `,(0,c.jsx)(t.code,{children:`registerThresholdResolver`})]}),(0,c.jsx)(t.td,{children:`id для runtime-конфига`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Применить resolver по id`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveValueState`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`(id, value) → State`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить CSS class`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveValueStateClassName`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`success → statusSuccess`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить цветовой token`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`VALUE_STATE_COLOR_TOKENS`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`success → CSS variable`})})]})]})]}),`
+`,(0,c.jsxs)(t.h2,{id:`что-означает-каждый-state`,children:[`Что означает каждый `,(0,c.jsx)(t.code,{children:`State`})]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`State`}),(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:`""`})}),(0,c.jsx)(t.td,{children:`Пустое состояние; поддержано базовым контрактом`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`none`})}),(0,c.jsx)(t.td,{children:`Нейтральное значение без специального статуса`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`information`})}),(0,c.jsx)(t.td,{children:`Информационное состояние`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`success`})}),(0,c.jsx)(t.td,{children:`Успех или нормальное положительное значение`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`warning`})}),(0,c.jsx)(t.td,{children:`Предупреждение, требующее внимания`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`error`})}),(0,c.jsx)(t.td,{children:`Ошибка или критическое значение`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Смысл остаётся семантическим. Конкретный цвет, иконку и доступный текст определяет UI.`}),`
+`,(0,c.jsx)(t.h2,{id:`fixed-resolver-точное-сопоставление`,children:`Fixed resolver: точное сопоставление`}),`
+`,(0,c.jsx)(t.h3,{id:`createfixedresolverconfig`,children:(0,c.jsx)(t.code,{children:`createFixedResolver(config)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает функцию `,(0,c.jsx)(t.code,{children:`(value: unknown) => State`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolveStatus = createFixedResolver({
+	entries: {
+		DONE: "success",
+		WAITING: "warning",
+		FAILED: "error"
+	},
+	fallbackState: "none"
+});
+
+resolveStatus("DONE"); // "success"
+resolveStatus("WAITING"); // "warning"
+resolveStatus("UNKNOWN"); // "none"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fallbackState`}),` по умолчанию равен `,(0,c.jsx)(t.code,{children:`none`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-сравниваются-значения`,children:`Как сравниваются значения`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` сразу возвращается fallback. Остальные значения превращаются через `,(0,c.jsx)(t.code,{children:`String(value)`}),` и ищутся по точному ключу `,(0,c.jsx)(t.code,{children:`entries`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolve = createFixedResolver({
+	entries: {
+		"1": "success",
+		true: "information",
+		" DONE ": "warning"
+	}
+});
+
+resolve(1); // "success"
+resolve("1"); // "success"
+resolve(true); // "information"
+resolve("DONE"); // "none"
+resolve(" DONE "); // "warning"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Trim, изменение регистра и глубокая сериализация объектов не выполняются. Объект обычно превращается в `,(0,c.jsx)(t.code,{children:`"[object Object]"`}),`, поэтому fixed resolver предназначен прежде всего для scalar-кодов.`]}),`
+`,(0,c.jsx)(t.h3,{id:`snapshot-entries`,children:`Snapshot entries`}),`
+`,(0,c.jsxs)(t.p,{children:[`При создании resolver-а entries копируются во внутренний `,(0,c.jsx)(t.code,{children:`Map`}),`. Последующая мутация исходного объекта не меняет уже созданную функцию:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const entries = { A: "success" as const };
+const resolve = createFixedResolver({ entries });
+
+entries.A = "error"; // если тип был насильно ослаблен
+resolve("A"); // всё ещё исходный state
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`threshold-resolver-числовые-сегменты`,children:`Threshold resolver: числовые сегменты`}),`
+`,(0,c.jsx)(t.h3,{id:`простые-пороги`,children:`Простые пороги`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolveProgress = createThresholdResolver({
+	thresholds: [50, 80],
+	states: ["error", "warning", "success"],
+	invalidState: "none"
+});
+
+resolveProgress(20); // "error"
+resolveProgress(50); // "warning"
+resolveProgress(79); // "warning"
+resolveProgress(80); // "success"
+resolveProgress(100); // "success"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пороги сортируются по возрастанию. Для `,(0,c.jsx)(t.code,{children:`N`}),` thresholds всегда нужно передать `,(0,c.jsx)(t.code,{children:`N + 1`}),` states:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`(-∞, threshold 1) → states[0]
+[threshold 1, threshold 2) → states[1]
+[threshold 2, +∞) → states[2]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если количество не совпадает, создание/регистрация выбрасывает `,(0,c.jsx)(t.code,{children:`Error`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`граница-upper-и-lower`,children:[`Граница `,(0,c.jsx)(t.code,{children:`upper`}),` и `,(0,c.jsx)(t.code,{children:`lower`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Число в `,(0,c.jsx)(t.code,{children:`thresholds`}),` эквивалентно объекту с `,(0,c.jsx)(t.code,{children:`boundary: "upper"`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`50
+// то же самое:
+{ value: 50, boundary: "upper" }
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`upper`}),`: само пороговое значение относится к верхнему сегменту;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`lower`}),`: само пороговое значение остаётся в нижнем сегменте.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const upper = createThresholdResolver({
+	thresholds: [{ value: 50, boundary: "upper" }],
+	states: ["error", "success"]
+});
+
+upper(49); // "error"
+upper(50); // "success"
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const lower = createThresholdResolver({
+	thresholds: [{ value: 50, boundary: "lower" }],
+	states: ["error", "success"]
+});
+
+lower(50); // "error"
+lower(51); // "success"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`преобразование-входа-в-число`,children:`Преобразование входа в число`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка, `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` сразу дают `,(0,c.jsx)(t.code,{children:`invalidState`}),`. Остальное преобразуется унарным `,(0,c.jsx)(t.code,{children:`+`}),` и должно стать конечным числом:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolve = createThresholdResolver({
+	thresholds: [10],
+	states: ["warning", "success"],
+	invalidState: "error"
+});
+
+resolve("9"); // "warning"
+resolve("10"); // "success"
+resolve(""); // "error"
+resolve("abc"); // "error"
+resolve(Infinity); // "error"
+resolve(false); // "warning", потому что +false === 0
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это JavaScript-преобразование, а не SAP-like `,(0,c.jsx)(t.code,{children:`parseNumber`}),`: строка `,(0,c.jsx)(t.code,{children:`"1 234,5"`}),` не будет прочитана как число. Нормализуйте внешний источник заранее, если это требуется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сортировка-и-states`,children:`Сортировка и states`}),`
+`,(0,c.jsxs)(t.p,{children:[`Thresholds сортируются, но массив `,(0,c.jsx)(t.code,{children:`states`}),` не переставляется. Он уже должен описывать сегменты в возрастающем порядке:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createThresholdResolver({
+	thresholds: [80, 50], // будет отсортировано как [50, 80]
+	states: ["error", "warning", "success"] // порядок сегментов остаётся таким
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Дублирующиеся числовые пороги допускаются, но приводят к `,(0,c.jsx)(t.code,{children:`console.warn`}),`. Лучше не использовать их: между одинаковыми границами получается пустой сегмент.`]}),`
+`,(0,c.jsx)(t.p,{children:`Threshold values не проверяются отдельно на finite. Передавайте только конечные числа.`}),`
+`,(0,c.jsx)(t.h2,{id:`прямая-функция-и-регистрация-по-id`,children:`Прямая функция и регистрация по id`}),`
+`,(0,c.jsx)(t.p,{children:`У обоих видов есть две формы API:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const fn = createFixedResolver(config);
+const id = registerFixedResolver(config);
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`когда-использовать-create`,children:[`Когда использовать `,(0,c.jsx)(t.code,{children:`create*`})]}),`
+`,(0,c.jsx)(t.p,{children:`Когда resolver нужен непосредственно в коде:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const state = resolveStatus(row.status);
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`когда-использовать-register`,children:[`Когда использовать `,(0,c.jsx)(t.code,{children:`register*`})]}),`
+`,(0,c.jsx)(t.p,{children:`Когда нужно хранить короткий id и разрешать функцию через общий runtime:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolverId = registerThresholdResolver(config);
+const state = resolveValueState(resolverId, row.value);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обе формы регистрируют resolver в общем module-level реестре. `,(0,c.jsx)(t.code,{children:`create*`}),` не является изолированной функцией вне реестра.`]}),`
+`,(0,c.jsx)(t.h2,{id:`дедупликация`,children:`Дедупликация`}),`
+`,(0,c.jsx)(t.p,{children:`Идентичные конфигурации используют одну регистрацию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const firstId = registerFixedResolver({
+	entries: { A: "success", B: "error" }
+});
+
+const secondId = registerFixedResolver({
+	entries: { B: "error", A: "success" }
+});
+
+firstId === secondId; // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для fixed resolver ключи entries сортируются. Для threshold resolver пороги нормализуются и сортируются. В канонический ключ также входят states, границы и fallback/invalid state.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Идентичные вызовы `,(0,c.jsx)(t.code,{children:`create*`}),` возвращают одну и ту же function reference:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createFixedResolver(config) === createFixedResolver(config); // true
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`реестр-resolver-ов`,children:`Реестр resolver-ов`}),`
+`,(0,c.jsx)(t.h3,{id:`resolvevaluestateid-value`,children:(0,c.jsx)(t.code,{children:`resolveValueState(id, value)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Находит функцию и применяет её. Неизвестный id безопасно возвращает `,(0,c.jsx)(t.code,{children:`none`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveValueState("unknown", 10); // "none"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`getvaluestateresolverid`,children:(0,c.jsx)(t.code,{children:`getValueStateResolver(id)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает функцию либо `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const resolver = getValueStateResolver(id);
+const state = resolver?.(value) ?? "none";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`getvaluestateresolverids`,children:(0,c.jsx)(t.code,{children:`getValueStateResolverIds()`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает новый массив всех id в порядке регистрации.`}),`
+`,(0,c.jsx)(t.h3,{id:`resetvaluestateresolvers`,children:(0,c.jsx)(t.code,{children:`resetValueStateResolvers()`})}),`
+`,(0,c.jsx)(t.p,{children:`Полностью очищает оба индекса. Функция предназначена прежде всего для тестов.`}),`
+`,(0,c.jsx)(t.p,{children:`После сброса:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`старый id больше не разрешается через `,(0,c.jsx)(t.code,{children:`resolveValueState`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`уже полученная function reference продолжает работать;`}),`
+`,(0,c.jsx)(t.li,{children:`повторная регистрация снова создаст запись.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не очищайте реестр в работающем приложении, если pipeline executors зависят от id.`}),`
+`,(0,c.jsx)(t.h2,{id:`низкоуровневый-registry-api`,children:`Низкоуровневый registry API`}),`
+`,(0,c.jsx)(t.h3,{id:`computeshorthashinput`,children:(0,c.jsx)(t.code,{children:`computeShortHash(input)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Вычисляет детерминированный djb2-подобный 32-bit hash и кодирует его в base36 с префиксом `,(0,c.jsx)(t.code,{children:`id_`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = computeShortHash("fixed|A:success|none");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это не криптографический hash. Он не подходит для паролей, подписей, контроля целостности и security-решений.`}),`
+`,(0,c.jsx)(t.p,{children:`Коллизии отдельно не разрешаются: два разных canonical keys теоретически могут получить одинаковый id. Поэтому id — runtime-деталь дедупликации, а не долговечный бизнес-идентификатор или ключ БД.`}),`
+`,(0,c.jsx)(t.h3,{id:`registerresolvercanonicalkey-compilefunction`,children:(0,c.jsx)(t.code,{children:`registerResolver(canonicalKey, compileFunction)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Низкоуровневая регистрация произвольного `,(0,c.jsx)(t.code,{children:`ValueStateResolver`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const registration = registerResolver("custom|v1", () => (value) => (value === "ok" ? "success" : "none"));
+
+registration.id;
+registration.isNew;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если canonical key уже известен, `,(0,c.jsx)(t.code,{children:`compileFunction`}),` не вызывается и возвращается `,(0,c.jsx)(t.code,{children:`{ isNew: false }`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Выбирайте canonical key детерминированно и включайте в него все параметры, влияющие на результат. В обычном приложении предпочитайте `,(0,c.jsx)(t.code,{children:`registerFixedResolver`}),` или `,(0,c.jsx)(t.code,{children:`registerThresholdResolver`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`findresolverbycanonicalkeycanonicalkey`,children:(0,c.jsx)(t.code,{children:`findResolverByCanonicalKey(canonicalKey)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает существующую функцию по точному canonical key либо `,(0,c.jsx)(t.code,{children:`undefined`}),`. Это инфраструктурный helper для дедупликации.`]}),`
+`,(0,c.jsx)(t.h2,{id:`presentation-api`,children:`Presentation API`}),`
+`,(0,c.jsx)(t.h3,{id:`default_value_states`,children:(0,c.jsx)(t.code,{children:`DEFAULT_VALUE_STATES`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`["none", "information", "success", "warning", "error"];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Список подходит для UI выбора state. Пустой state `,(0,c.jsx)(t.code,{children:`""`}),` намеренно не включён.`]}),`
+`,(0,c.jsx)(t.h3,{id:`value_state_color_tokens`,children:(0,c.jsx)(t.code,{children:`VALUE_STATE_COLOR_TOKENS`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	"": "transparent",
+	none: "var(--content-1)",
+	information: "var(--status-info-text)",
+	success: "var(--status-success-text)",
+	warning: "var(--status-warning-text)",
+	error: "var(--status-error-text)"
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объект экспортируется как изменяемый `,(0,c.jsx)(t.code,{children:`Record`}),`, но его следует считать общей read-only таблицей. Не мутируйте токены глобально; тему меняйте через значения CSS variables.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const color = VALUE_STATE_COLOR_TOKENS[state];
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`resolvevaluestateclassnamestate-fallbackclassname`,children:(0,c.jsx)(t.code,{children:`resolveValueStateClassName(state, fallbackClassName?)`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`State`}),(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:`success`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`statusSuccess`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`warning`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`statusWarning`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`error`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`statusError`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`information`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`statusInfo`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`none`}),` или `,(0,c.jsx)(t.code,{children:`""`})]}),(0,c.jsxs)(t.td,{children:[`fallback либо `,(0,c.jsx)(t.code,{children:`undefined`})]})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveValueStateClassName("success"); // "statusSuccess"
+resolveValueStateClassName("none"); // undefined
+resolveValueStateClassName("none", "neutral"); // "neutral"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция возвращает имена классов, но не импортирует CSS и не гарантирует наличие стилей в consumer.`}),`
+`,(0,c.jsx)(t.h2,{id:`использование-с-formatter-pipeline`,children:`Использование с formatter pipeline`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const pipeline = {
+	version: 1,
+	plan: {
+		steps: [
+			{
+				id: "state",
+				type: "resolveValueState",
+				config: {
+					resolver: {
+						kind: "threshold",
+						thresholds: [50, 80],
+						states: ["error", "warning", "success"]
+					},
+					icon: {
+						enabled: true,
+						showValue: true,
+						position: "left"
+					}
+				}
+			}
+		]
+	}
+} as const;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Pipeline регистрирует resolver на этапе компиляции, вычисляет state до typed formatting и возвращает state/icon-параметры UI. Подробности: `,(0,c.jsx)(t.a,{href:`../pipeline/README.mdx#%D1%88%D0%B0%D0%B3-resolvevaluestate`,children:`pipeline/README.mdx`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.p,{children:`Изолируйте глобальный реестр:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { beforeEach } from "vitest";
+import { resetValueStateResolvers } from "@ryuzaki13/react-foundation-lib/formatters";
+
+beforeEach(() => {
+	resetValueStateResolvers();
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для threshold resolver обязательно проверяйте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`значение меньше первого порога;`}),`
+`,(0,c.jsx)(t.li,{children:`точное равенство каждому порогу;`}),`
+`,(0,c.jsx)(t.li,{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:`lower`}),` и `,(0,c.jsx)(t.code,{children:`upper`}),`, если граница настраивается.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для fixed resolver проверяйте точный регистр, пробелы, numeric/string keys и fallback.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-trim-и-case-insensitive-fixed-lookup`,children:`Ожидать trim и case-insensitive fixed lookup`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`"DONE"`}),`, `,(0,c.jsx)(t.code,{children:`"done"`}),` и `,(0,c.jsx)(t.code,{children:`" DONE "`}),` — разные ключи. Нормализуйте значение отдельно, только если это часть вашего контракта.`]}),`
+`,(0,c.jsx)(t.h3,{id:`перепутать-количество-states`,children:`Перепутать количество states`}),`
+`,(0,c.jsx)(t.p,{children:`Два порога образуют три сегмента, поэтому нужны три states.`}),`
+`,(0,c.jsx)(t.h3,{id:`неправильно-понять-boundary`,children:`Неправильно понять boundary`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`upper`}),` означает, что точный threshold уже относится к верхнему сегменту. Для включения порога в нижний используйте `,(0,c.jsx)(t.code,{children:`lower`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сохранить-hash-id-как-вечный-бизнес-ключ`,children:`Сохранить hash id как вечный бизнес-ключ`}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм не криптографический и не обрабатывает коллизии. Храните сериализуемую resolver-конфигурацию, а id считайте runtime-производной.`}),`
+`,(0,c.jsx)(t.h3,{id:`очищать-реестр-после-компиляции`,children:`Очищать реестр после компиляции`}),`
+`,(0,c.jsxs)(t.p,{children:[`Pipeline executor хранит id и после reset начнёт получать `,(0,c.jsx)(t.code,{children:`none`}),`.`]}),`
+`,(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:`Публичный API`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Fixed`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createFixedResolver`}),`, `,(0,c.jsx)(t.code,{children:`registerFixedResolver`}),`, `,(0,c.jsx)(t.code,{children:`FixedValueStateResolverConfig`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Threshold`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createThresholdResolver`}),`, `,(0,c.jsx)(t.code,{children:`registerThresholdResolver`}),`, `,(0,c.jsx)(t.code,{children:`ThresholdBoundary`}),`, `,(0,c.jsx)(t.code,{children:`ThresholdDefinition`}),`, `,(0,c.jsx)(t.code,{children:`ThresholdValueStateResolverConfig`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Registry`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`computeShortHash`}),`, `,(0,c.jsx)(t.code,{children:`registerResolver`}),`, `,(0,c.jsx)(t.code,{children:`findResolverByCanonicalKey`}),`, `,(0,c.jsx)(t.code,{children:`resolveValueState`}),`, `,(0,c.jsx)(t.code,{children:`getValueStateResolver`}),`, `,(0,c.jsx)(t.code,{children:`getValueStateResolverIds`}),`, `,(0,c.jsx)(t.code,{children:`resetValueStateResolvers`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Presentation`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`DEFAULT_VALUE_STATES`}),`, `,(0,c.jsx)(t.code,{children:`VALUE_STATE_COLOR_TOKENS`}),`, `,(0,c.jsx)(t.code,{children:`resolveValueStateClassName`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Function type`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ValueStateResolver`})})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`связанная-документация`,children:`Связанная документация`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`../README.mdx`,children:[`Обзор `,(0,c.jsx)(t.code,{children:`formatters`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../pipeline/README.mdx`,children:`Formatter pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../number/README.mdx`,children:`Числовые форматтеры`})}),`
+`]})]})}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};