@ryuzaki13/react-foundation-ui 1.8.5 → 1.8.7

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

@@ -0,0 +1,420 @@
+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`,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/Pipeline`}),`
+`,(0,c.jsx)(t.h1,{id:`formatter-pipeline`,children:`Formatter pipeline`}),`
+`,(0,c.jsx)(t.p,{children:`Formatter pipeline — конфигурируемая последовательность преобразований значения ячейки. Она умеет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`взять значение из другого поля строки или вычислить его row-based формулой;`}),`
+`,(0,c.jsx)(t.li,{children:`нормализовать ведущие нули;`}),`
+`,(0,c.jsxs)(t.li,{children:[`назначить семантическое состояние `,(0,c.jsx)(t.code,{children:`success`}),`, `,(0,c.jsx)(t.code,{children:`warning`}),`, `,(0,c.jsx)(t.code,{children:`error`}),` и другие;`]}),`
+`,(0,c.jsx)(t.li,{children:`настроить статусную иконку;`}),`
+`,(0,c.jsx)(t.li,{children:`выполнить финальное форматирование по OData-типу колонки;`}),`
+`,(0,c.jsx)(t.li,{children:`скомпилировать сериализуемую конфигурацию один раз и быстро применять её ко многим строкам.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Pipeline не является React-компонентом и не рисует UI. На выходе он возвращает данные, которые UI может отобразить.`}),`
+`,(0,c.jsx)(t.p,{children:`Все функции и типы импортируются из единственного публичного entrypoint:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	compileFormattersPipelineExecutor,
+	compileFormattersPipelineRuntime,
+	formatPipelineDisplayValue,
+	normalizeFormattersPipelineConfig,
+	validateFormattersPipelineConfig,
+	type FormattersPipelineConfig,
+	type FormattersPipelineRuntimeField
+} from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Импорта `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters/pipeline`}),` нет.`]}),`
+`,(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:`Хранить конфигурацию`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Принять конфиг из JSON/БД`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Показать ошибки редактора`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`validateFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Скомпилировать один pipeline вручную`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`compileFormattersPipelineExecutor`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Подготовить поля таблицы`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntimeFields`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Форматировать ячейку в обычном consumer`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatPipelineDisplayValue`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Собрать дополнительные поля запроса`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`collectRuntimeFieldDependencyIds`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Скопировать конфиг для store`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`cloneFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Переиздать технические id копии`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rekeyFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Построить UI-каталог шагов`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getFormattersPipelineDefinitions`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Большинству приложений нужен путь «нормализовать → валидировать → скомпилировать поля → форматировать ячейки». Низкоуровневый executor полезен инфраструктурному коду.`}),`
+`,(0,c.jsx)(t.h2,{id:`модель-данных`,children:`Модель данных`}),`
+`,(0,c.jsx)(t.h3,{id:`конфигурация-версии-1`,children:`Конфигурация версии 1`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FormattersPipelineConfig = {
+	version: 1;
+	graph?: FormattersPipelineGraph;
+	plan?: FormattersPipelinePlan;
+};
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`version`}),` обязана быть ровно `,(0,c.jsx)(t.code,{children:`1`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`plan`}),` — линейная последовательность runtime-шагов;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`graph`}),` — полное представление для визуального редактора;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`должен присутствовать хотя бы `,(0,c.jsx)(t.code,{children:`plan`}),` или `,(0,c.jsx)(t.code,{children:`graph`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Pipeline поддерживает только линейное выполнение. Graph не допускает ветвлений и в итоге также превращается в plan.`}),`
+`,(0,c.jsx)(t.h3,{id:`plan`,children:`Plan`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const config: FormattersPipelineConfig = {
+	version: 1,
+	plan: {
+		steps: [
+			{
+				id: "zeros",
+				type: "normalizeLeadingZeros",
+				config: { fixed: 6 }
+			},
+			{
+				id: "format",
+				type: "typedValueFormat",
+				config: { numberPresetName: "integer" }
+			}
+		]
+	}
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`id`}),` — технический уникальный идентификатор шага. `,(0,c.jsx)(t.code,{children:`type`}),` выбирает один из четырёх видов formatter-а. Порядок элементов массива — порядок выполнения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`graph`,children:`Graph`}),`
+`,(0,c.jsx)(t.p,{children:`Graph хранит:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`nodes`}),`: узлы `,(0,c.jsx)(t.code,{children:`source`}),`, `,(0,c.jsx)(t.code,{children:`sink`}),` и formatter-узлы;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`edges`}),`: связи `,(0,c.jsx)(t.code,{children:`{ id, source, target }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`необязательный `,(0,c.jsx)(t.code,{children:`viewport`}),` редактора `,(0,c.jsx)(t.code,{children:`{ x, y, zoom }`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Корректный граф имеет вид:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`source → formatter → formatter → sink
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`У него должен быть ровно один `,(0,c.jsx)(t.code,{children:`source`}),` и один `,(0,c.jsx)(t.code,{children:`sink`}),`; все formatter-узлы имеют по одному входу и выходу; все узлы входят в единственный путь; циклы запрещены.`]}),`
+`,(0,c.jsx)(t.h3,{id:`приоритет-plan-и-graph`,children:`Приоритет plan и graph`}),`
+`,(0,c.jsxs)(t.p,{children:[`При валидации корректный `,(0,c.jsx)(t.code,{children:`plan`}),` имеет приоритет. Если plan семантически невалиден, но присутствует graph, validator пытается построить plan из graph и добавляет warning `,(0,c.jsx)(t.code,{children:`path_broken`}),` о fallback.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для сохранённого конфига разумно держать оба представления синхронизированными в редакторе. Runtime не объединяет шаги из двух источников.`}),`
+`,(0,c.jsx)(t.h2,{id:`рекомендуемый-порядок-шагов`,children:`Рекомендуемый порядок шагов`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`rowBasedOverride
+        ↓
+normalizeLeadingZeros
+        ↓
+resolveValueState
+        ↓
+typedValueFormat
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так state вычисляется по ещё не превращённому в красивую строку значению, а типизированный formatter завершает pipeline.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Validator запрещает только один критичный вариант: `,(0,c.jsx)(t.code,{children:`typedValueFormat`}),` не может стоять раньше `,(0,c.jsx)(t.code,{children:`resolveValueState`}),`. Остальной смысл порядка остаётся ответственностью автора конфига.`]}),`
+`,(0,c.jsx)(t.p,{children:`Каждый из четырёх типов может присутствовать не более одного раза.`}),`
+`,(0,c.jsxs)(t.h2,{id:`шаг-rowbasedoverride`,children:[`Шаг `,(0,c.jsx)(t.code,{children:`rowBasedOverride`})]}),`
+`,(0,c.jsx)(t.p,{children:`Подменяет текущее значение данными текущей строки.`}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-field`,children:[`Режим `,(0,c.jsx)(t.code,{children:`field`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "override",
+	type: "rowBasedOverride",
+	config: {
+		mode: "field",
+		fieldKey: "displayAmount",
+		fallbackToRaw: true
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для строк `,(0,c.jsx)(t.code,{children:`plain`}),`, `,(0,c.jsx)(t.code,{children:`tree`}),` и `,(0,c.jsx)(t.code,{children:`group`}),` шаг читает `,(0,c.jsx)(t.code,{children:`rowData[fieldKey]`}),`. Для строки `,(0,c.jsx)(t.code,{children:`totals`}),` field-режим не применяется.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если поле вернуло `,(0,c.jsx)(t.code,{children:`null`}),` или `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`fallbackToRaw: true`}),` или отсутствие настройки сохраняет текущее значение;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`fallbackToRaw: false`}),` заменяет его на `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка, `,(0,c.jsx)(t.code,{children:`0`}),` и `,(0,c.jsx)(t.code,{children:`false`}),` являются настоящими значениями и не запускают fallback.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-formula`,children:[`Режим `,(0,c.jsx)(t.code,{children:`formula`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "override",
+	type: "rowBasedOverride",
+	config: {
+		mode: "formula",
+		formulaId: "completion-percent",
+		dependencyIds: ["planned", "actual"],
+		fallbackToRaw: true
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Формула берётся из глобального row-based реестра. В отличие от field-режима, она выполняется для всех `,(0,c.jsx)(t.code,{children:`rowKind`}),`, включая `,(0,c.jsx)(t.code,{children:`totals`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`dependencyIds`}),` становятся индексами контекста формулы: `,(0,c.jsx)(t.code,{children:`ctx.num(0)`}),` читает `,(0,c.jsx)(t.code,{children:`planned`}),`, `,(0,c.jsx)(t.code,{children:`ctx.num(1)`}),` — `,(0,c.jsx)(t.code,{children:`actual`}),`. Если формула вернула `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` или выбросила ошибку, применяется политика `,(0,c.jsx)(t.code,{children:`fallbackToRaw`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`До валидации и компиляции нужно настроить реестр. Подробный контракт описан в `,(0,c.jsx)(t.a,{href:`../rowBased/README.mdx`,children:`rowBased/README.mdx`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`шаг-normalizeleadingzeros`,children:[`Шаг `,(0,c.jsx)(t.code,{children:`normalizeLeadingZeros`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "zeros",
+	type: "normalizeLeadingZeros",
+	config: { fixed: 6 }
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Вызывает `,(0,c.jsx)(t.code,{children:`normalizeLeadingZeros(currentValue, fixed)`}),`. Например, числовая строка `,(0,c.jsx)(t.code,{children:`"42"`}),` при `,(0,c.jsx)(t.code,{children:`fixed: 6`}),` превращается в `,(0,c.jsx)(t.code,{children:`"000042"`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте положительное целое `,(0,c.jsx)(t.code,{children:`fixed`}),`. Structural validator проверяет только тип `,(0,c.jsx)(t.code,{children:`number`}),`, а сама функция имеет широкую JavaScript-семантику преобразования. Все ограничения разобраны в `,(0,c.jsx)(t.a,{href:`../README.mdx#%D0%B2%D0%B5%D0%B4%D1%83%D1%89%D0%B8%D0%B5-%D0%BD%D1%83%D0%BB%D0%B8`,children:`обзоре formatters`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`шаг-resolvevaluestate`,children:[`Шаг `,(0,c.jsx)(t.code,{children:`resolveValueState`})]}),`
+`,(0,c.jsx)(t.p,{children:`Вычисляет состояние по текущему значению. Поддержаны fixed- и threshold-резолверы.`}),`
+`,(0,c.jsx)(t.h3,{id:`fixed`,children:`Fixed`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "state",
+	type: "resolveValueState",
+	config: {
+		resolver: {
+			kind: "fixed",
+			entries: {
+				DONE: "success",
+				WAITING: "warning",
+				FAILED: "error"
+			},
+			fallbackState: "none"
+		},
+		icon: {
+			enabled: true,
+			showValue: true,
+			position: "left"
+		}
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Fixed-сопоставление выполняется по точному `,(0,c.jsx)(t.code,{children:`String(value)`}),`, без trim и изменения регистра.`]}),`
+`,(0,c.jsx)(t.h3,{id:`threshold`,children:`Threshold`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "state",
+	type: "resolveValueState",
+	config: {
+		resolver: {
+			kind: "threshold",
+			thresholds: [50, 80],
+			states: ["error", "warning", "success"],
+			invalidState: "none"
+		},
+		icon: { enabled: true, showValue: false, position: "right" }
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`N`}),` порогов требуется ровно `,(0,c.jsx)(t.code,{children:`N + 1`}),` состояний. Подробности границ `,(0,c.jsx)(t.code,{children:`lower`}),`/`,(0,c.jsx)(t.code,{children:`upper`}),` приведены в `,(0,c.jsx)(t.a,{href:`../valueState/README.mdx`,children:`valueState/README.mdx`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`настройки-иконки`,children:`Настройки иконки`}),`
+`,(0,c.jsx)(t.p,{children:`Значения по умолчанию:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`enabled: false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`showValue: true`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`position: "left"`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Иконка создаётся только для `,(0,c.jsx)(t.code,{children:`information`}),`, `,(0,c.jsx)(t.code,{children:`success`}),`, `,(0,c.jsx)(t.code,{children:`warning`}),`, `,(0,c.jsx)(t.code,{children:`error`}),`. Состояния `,(0,c.jsx)(t.code,{children:`""`}),` и `,(0,c.jsx)(t.code,{children:`none`}),` не имеют icon value.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если указать `,(0,c.jsx)(t.code,{children:`enabled: false`}),` и `,(0,c.jsx)(t.code,{children:`showValue: false`}),`, UI не сможет показать ни текст, ни иконку; validator сообщает warning `,(0,c.jsx)(t.code,{children:`step_value_hidden_without_icon`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`шаг-typedvalueformat`,children:[`Шаг `,(0,c.jsx)(t.code,{children:`typedValueFormat`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`{
+	id: "typed",
+	type: "typedValueFormat",
+	config: {
+		numberPresetName: "decimal-2",
+		datePresetName: "date-long"
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Runtime определяет базовый тип из OData metadata поля:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`число → `,(0,c.jsx)(t.code,{children:`formatNumber`}),`, по умолчанию preset `,(0,c.jsx)(t.code,{children:`decimal`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`дата → `,(0,c.jsx)(t.code,{children:`parseDate`}),`, затем `,(0,c.jsx)(t.code,{children:`formatDate`}),`, по умолчанию preset `,(0,c.jsx)(t.code,{children:`date`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`остальные типы → безопасное строковое представление;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` → `,(0,c.jsx)(t.code,{children:`""`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для числового preset validator требует непустое зарегистрированное имя. На runtime неизвестное имя всё равно заменяется на `,(0,c.jsx)(t.code,{children:`decimal`}),`. Для неизвестного date preset runtime использует `,(0,c.jsx)(t.code,{children:`date`}),`; текущая валидация отдельно его не отклоняет.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если pipeline не содержит `,(0,c.jsx)(t.code,{children:`typedValueFormat`}),`, верхнеуровневый runtime автоматически выполняет стандартное форматирование по типу после executor-а.`]}),`
+`,(0,c.jsx)(t.h2,{id:`валидация`,children:`Валидация`}),`
+`,(0,c.jsx)(t.h3,{id:`validateformatterspipelineconfigconfig`,children:(0,c.jsx)(t.code,{children:`validateFormattersPipelineConfig(config)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = validateFormattersPipelineConfig(config);
+
+if (!result.ok) {
+	for (const error of result.errors) {
+		console.error(error.code, error.message);
+	}
+}
+
+for (const warning of result.warnings) {
+	console.warn(warning.code, warning.message);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FormattersPipelineValidationResult = {
+	ok: boolean;
+	errors: FormattersPipelineValidationMessage[];
+	warnings: FormattersPipelineValidationMessage[];
+	plan?: FormattersPipelinePlan;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ok`}),` зависит от ошибок, но warnings не делают результат невалидным. При успехе используйте возвращённый `,(0,c.jsx)(t.code,{children:`plan`}),`: для graph он уже построен в правильном порядке.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Низкоуровневые `,(0,c.jsx)(t.code,{children:`validateFormattersPipelinePlan(plan)`}),` и `,(0,c.jsx)(t.code,{children:`validateFormattersPipelineGraph(graph)`}),` нужны редактору, который проверяет представления отдельно.`]}),`
+`,(0,c.jsx)(t.h3,{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:`Примеры code`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Конфиг`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`config_not_defined`}),`, `,(0,c.jsx)(t.code,{children:`unsupported_version`}),`, `,(0,c.jsx)(t.code,{children:`graph_or_plan_required`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Идентификаторы`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`node_id_duplicate`}),`, `,(0,c.jsx)(t.code,{children:`edge_id_duplicate`}),`, `,(0,c.jsx)(t.code,{children:`step_id_duplicate`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Структура graph`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`source_count_invalid`}),`, `,(0,c.jsx)(t.code,{children:`node_degree_invalid`}),`, `,(0,c.jsx)(t.code,{children:`path_cycle_detected`}),`, `,(0,c.jsx)(t.code,{children:`path_disconnected_nodes`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Повтор шагов`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`step_*_multiple`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Порядок`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`step_typed_before_value_state`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Row-based`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`step_row_based_override_formula_not_found`}),`, `,(0,c.jsx)(t.code,{children:`step_row_based_override_dependency_index_out_of_range`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Value state`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`step_threshold_states_count_invalid`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Preset`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`step_typed_value_format_preset_empty`}),`, `,(0,c.jsx)(t.code,{children:`step_typed_value_format_preset_not_found`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Validator запускает row-based формулу дважды на синтетических положительных и отрицательных значениях. Так он обнаруживает обращение за границы dependencies, неиспользуемые зависимости и некоторые runtime-ошибки. Формула обязана быть чистой и синхронной.`}),`
+`,(0,c.jsx)(t.p,{children:`Проверка тестовыми данными не доказывает корректность всех условных веток; бизнес-формулы всё равно требуют собственных тестов.`}),`
+`,(0,c.jsx)(t.h2,{id:`нормализация-внешнего-json`,children:`Нормализация внешнего JSON`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizeformatterspipelineconfigvalue`,children:(0,c.jsx)(t.code,{children:`normalizeFormattersPipelineConfig(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const config = normalizeFormattersPipelineConfig(JSON.parse(payload));
+
+if (!config) {
+	// payload имеет неправильную форму или семантически невалиден
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`принимает `,(0,c.jsx)(t.code,{children:`unknown`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`проверяет структуру и типы всех известных полей;`}),`
+`,(0,c.jsxs)(t.li,{children:[`поддерживает только версию `,(0,c.jsx)(t.code,{children:`1`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`выполняет семантическую валидацию;`}),`
+`,(0,c.jsx)(t.li,{children:`возвращает глубокую копию известных конфигурационных структур;`}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),` при любой невалидности.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Она не исправляет значения, не trim-ит id и не мигрирует версии. Для UI с подробными сообщениями сначала нужен отдельный structural parser либо уже типизированный config + `,(0,c.jsx)(t.code,{children:`validateFormattersPipelineConfig`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`компиляция-одного-executor-а`,children:`Компиляция одного executor-а`}),`
+`,(0,c.jsx)(t.h3,{id:`compileformatterspipelineexecutorargs`,children:(0,c.jsx)(t.code,{children:`compileFormattersPipelineExecutor(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const compiled = compileFormattersPipelineExecutor({
+	config,
+	column: {
+		role: "Data",
+		type: "Edm.Decimal"
+	}
+});
+
+if (!compiled.ok) {
+	console.error(compiled.reason);
+} else {
+	const result = compiled.executor.execute({
+		value: 72.5,
+		rowData: { planned: 100, actual: 72.5 },
+		rowKind: "plain",
+		isGroupRow: false,
+		isTotalsRow: false,
+		rowLevel: 0,
+		groupingIds: [],
+		columnId: "progress"
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ошибка компиляции имеет одну из причин:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`pipeline_invalid`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`row_based_formula_not_found`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Executor сообщает флаги `,(0,c.jsx)(t.code,{children:`hasRowBasedOverride`}),` и `,(0,c.jsx)(t.code,{children:`hasTypedValueFormat`}),`. Поля `,(0,c.jsx)(t.code,{children:`isGroupRow`}),` и `,(0,c.jsx)(t.code,{children:`isTotalsRow`}),` в execution context устарели; новый код передаёт достоверный `,(0,c.jsx)(t.code,{children:`rowKind`}),` и производные флаги только для совместимости контракта.`]}),`
+`,(0,c.jsx)(t.h2,{id:`высокоуровневый-runtime-полей`,children:`Высокоуровневый runtime полей`}),`
+`,(0,c.jsx)(t.h3,{id:`контракт-поля`,children:`Контракт поля`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FormattersPipelineRuntimeField = {
+	id: string;
+	role: ColumnRole;
+	type: ODataMetaType;
+	formattersPipeline?: FormattersPipelineConfig;
+	formulaId?: string;
+	formulaDependencies?: readonly string[];
+	purelyDerived?: boolean;
+	emptyWhenZero?: boolean;
+	overflowTooltip?: boolean;
+	formulaExecutor?: TableFormulaCompiledExecutor;
+	formattersPipelineExecutor?: FormattersPipelineExecutor;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formulaId`}),` здесь относится к общему модулю table formulas и выполняется до formatter pipeline. Это не то же самое, что row-based formula внутри шага `,(0,c.jsx)(t.code,{children:`rowBasedOverride`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`compileformatterspipelineruntimefield`,children:(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntime(field)`})}),`
+`,(0,c.jsx)(t.p,{children:`Компилирует formula и pipeline и записывает executors прямо в исходный объект:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const sameField = compileFormattersPipelineRuntime(field);
+
+sameField === field; // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это намеренная мутация construction-stage. Вызывайте функцию до помещения полей в readonly context, memoized snapshot или cache. Не вызывайте её на замороженном объекте и не воспринимайте как чистый clone-helper.`}),`
+`,(0,c.jsx)(t.p,{children:`Если pipeline невалиден, executor удаляется, и дальнейшее отображение использует стандартный typed fallback. Поэтому для диагностики обязательно валидируйте пользовательский конфиг отдельно: runtime деградирует безопасно и не возвращает подробные ошибки.`}),`
+`,(0,c.jsx)(t.h3,{id:`compileformatterspipelineruntimefieldsfieldsbyid`,children:(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntimeFields(fieldsById)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const runtimeFields = compileFormattersPipelineRuntimeFields(fieldsById);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает новую record-карту, пропускает `,(0,c.jsx)(t.code,{children:`undefined`}),`, но сами поля не копирует: каждое исходное поле компилируется с описанной выше мутацией.`]}),`
+`,(0,c.jsx)(t.h3,{id:`formatpipelinedisplayvalueargs`,children:(0,c.jsx)(t.code,{children:`formatPipelineDisplayValue(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const display = formatPipelineDisplayValue({
+	field: runtimeFields.amount,
+	rawValue: row.amount,
+	rowData: row,
+	rowKind: "plain",
+	rowLevel: 0,
+	groupingIds: []
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат содержит:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FormattersPipelineDisplayValue = {
+	value: unknown;
+	state: State;
+	icon?: "information" | "success" | "warning" | "error";
+	showIcon: boolean;
+	showValue: boolean;
+	iconPosition: "left" | "right";
+	overflowTooltip?: boolean;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок верхнеуровневого runtime:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`rawValue
+  ↓ table formula, если задана
+  ↓ formatter pipeline, если скомпилирован
+  ↓ typed fallback, если pipeline сам не форматировал тип
+  ↓ purelyDerived / emptyWhenZero post-processing
+display result
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если formula завершилась ошибкой:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`purelyDerived: true`}),` даёт пустое отображение;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`иначе используется исходный `,(0,c.jsx)(t.code,{children:`rawValue`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`emptyWhenZero`}),` проверяет source value после table formula, а не позднюю подмену `,(0,c.jsx)(t.code,{children:`rowBasedOverride`}),`. Оно очищает только `,(0,c.jsx)(t.code,{children:`display.value`}),`; state и настройки иконки сохраняются.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`field`}),` не передан, `,(0,c.jsx)(t.code,{children:`rawValue`}),` безопасно преобразуется в строку с состоянием `,(0,c.jsx)(t.code,{children:`none`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`зависимости-полей`,children:`Зависимости полей`}),`
+`,(0,c.jsx)(t.h3,{id:`collectformatterspipelinedependencyidsconfig`,children:(0,c.jsx)(t.code,{children:`collectFormattersPipelineDependencyIds(config)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает уникальные непустые зависимости `,(0,c.jsx)(t.code,{children:`rowBasedOverride`}),` в порядке первого появления:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`fieldKey`}),` из field-режима;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`каждый `,(0,c.jsx)(t.code,{children:`dependencyId`}),` из formula-режима.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для невалидного pipeline возвращается пустой массив.`}),`
+`,(0,c.jsx)(t.h3,{id:`collectruntimefielddependencyidsfieldids-fieldsbyid`,children:(0,c.jsx)(t.code,{children:`collectRuntimeFieldDependencyIds(fieldIds, fieldsById)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Дополнительно учитывает `,(0,c.jsx)(t.code,{children:`cellRenderer.bindings`}),` и разделяет найденные id:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dependencies = collectRuntimeFieldDependencyIds(visibleIds, fieldsById);
+
+dependencies.requiredColumnIds; // существующие поля, которые нужны runtime
+dependencies.missingColumnIds; // ссылки на неизвестные поля
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте результат при построении серверного select/query, иначе formatter может получить неполную строку.`}),`
+`,(0,c.jsx)(t.h2,{id:`клонирование-и-новые-id`,children:`Клонирование и новые id`}),`
+`,(0,c.jsx)(t.h3,{id:`cloneformatterspipelineconfigconfig`,children:(0,c.jsx)(t.code,{children:`cloneFormattersPipelineConfig(config)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт независимые копии plan, graph, positions, edges, массивов dependencies, threshold definitions, states, entries, icon и viewport. `,(0,c.jsx)(t.code,{children:`undefined`}),` остаётся `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция только клонирует: она не валидирует и не нормализует значения.`}),`
+`,(0,c.jsx)(t.p,{children:`Более узкие helpers:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneTypedValueFormatConfig`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneNormalizeLeadingZerosConfig`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneRowBasedOverrideConfig`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneResolveValueStateConfig`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneFormatterPipelinePlanStep`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneFormatterPipelinePlanStepToNode`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`rekeyformatterspipelineconfigconfig-idfactory`,children:(0,c.jsx)(t.code,{children:`rekeyFormattersPipelineConfig(config, idFactory?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт копию с новыми техническими id пользовательских formatter-узлов, plan steps и edges. `,(0,c.jsx)(t.code,{children:`source`}),` и `,(0,c.jsx)(t.code,{children:`sink`}),` сохраняют исходные id как служебные якоря.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию id создаёт `,(0,c.jsx)(t.code,{children:`uuidv4`}),`. В тесте можно передать детерминированную фабрику:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"let id = 0;\nconst copy = rekeyFormattersPipelineConfig(config, () => `new-${++id}`);\n"})}),`
+`,(0,c.jsx)(t.p,{children:`Если новый graph валиден, plan перестраивается из него. Иначе переиздаётся существующий plan.`}),`
+`,(0,c.jsx)(t.h2,{id:`каталог-шагов`,children:`Каталог шагов`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const definitions = getFormattersPipelineDefinitions();
+const typed = getFormattersPipelineDefinitionById("typedValueFormat");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Каталог содержит `,(0,c.jsx)(t.code,{children:`id`}),`, русское `,(0,c.jsx)(t.code,{children:`name`}),` и `,(0,c.jsx)(t.code,{children:`description`}),` для четырёх поддерживаемых типов. Он удобен для редактора, но не заменяет конфигурационные типы каждого шага.`]}),`
+`,(0,c.jsx)(t.h2,{id:`formattypedcellvalue`,children:(0,c.jsx)(t.code,{children:`formatTypedCellValue`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Низкоуровневая функция форматирует одно значение по `,(0,c.jsx)(t.code,{children:`{ role, type }`}),` и optional typed config. Её можно применять без полного pipeline:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const text = formatTypedCellValue(1234.5, { role: "Data", type: "Edm.Decimal" }, { numberPresetName: "decimal-2" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обычной таблицы используйте `,(0,c.jsx)(t.code,{children:`formatPipelineDisplayValue`}),`, чтобы не пропустить formulas, states и post-processing.`]}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`компилировать-pipeline-для-каждой-ячейки`,children:`Компилировать pipeline для каждой ячейки`}),`
+`,(0,c.jsx)(t.p,{children:`Компиляция валидирует конфиг, разрешает presets/formulas и создаёт resolvers. Выполняйте её один раз при построении набора полей, а не в цикле рендера строк.`}),`
+`,(0,c.jsx)(t.h3,{id:`считать-runtime-validation-ui-диагностикой`,children:`Считать runtime validation UI-диагностикой`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntime`}),` молча удаляет executor невалидного pipeline и включает fallback. Сначала вызовите validator и покажите `,(0,c.jsx)(t.code,{children:`errors`}),` пользователю редактора.`]}),`
+`,(0,c.jsx)(t.h3,{id:`забыть-row-based-реестр`,children:`Забыть row-based реестр`}),`
+`,(0,c.jsxs)(t.p,{children:[`Formula-режим не скомпилируется, пока host не вызвал `,(0,c.jsx)(t.code,{children:`configureRowBasedFormatterRegistry`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`вычислять-state-после-превращения-числа-в-строку`,children:`Вычислять state после превращения числа в строку`}),`
+`,(0,c.jsx)(t.p,{children:`Если typed formatter выполнен раньше state, резолвер увидит локализованную строку. Validator запрещает этот порядок; придерживайтесь рекомендуемой последовательности.`}),`
+`,(0,c.jsx)(t.h3,{id:`мутировать-поле-после-публикации-snapshot`,children:`Мутировать поле после публикации snapshot`}),`
+`,(0,c.jsx)(t.p,{children:`Runtime compiler изменяет объект поля. Компилируйте до заморозки и передачи потребителям.`}),`
+`,(0,c.jsx)(t.h3,{id:`считать-graph-произвольным-workflow`,children:`Считать graph произвольным workflow`}),`
+`,(0,c.jsx)(t.p,{children:`Ветвления, циклы и несколько независимых цепочек не поддерживаются. Graph — редактируемое представление строго линейного pipeline.`}),`
+`,(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:`Исполнение`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`compileFormattersPipelineExecutor`}),`, `,(0,c.jsx)(t.code,{children:`formatTypedCellValue`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Runtime полей`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntime`}),`, `,(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntimeFields`}),`, `,(0,c.jsx)(t.code,{children:`formatPipelineDisplayValue`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Валидация`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`validateFormattersPipelineConfig`}),`, `,(0,c.jsx)(t.code,{children:`validateFormattersPipelinePlan`}),`, `,(0,c.jsx)(t.code,{children:`validateFormattersPipelineGraph`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Внешние данные`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Зависимости`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`collectFormattersPipelineDependencyIds`}),`, `,(0,c.jsx)(t.code,{children:`collectRuntimeFieldDependencyIds`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Клонирование`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`cloneFormattersPipelineConfig`}),` и узкие clone helpers`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Переиздание id`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rekeyFormattersPipelineConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Каталог`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`getFormattersPipelineDefinitions`}),`, `,(0,c.jsx)(t.code,{children:`getFormattersPipelineDefinitionById`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`каталог-публичных-типов`,children:`Каталог публичных типов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Все типы импортируются из `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`}),`.`]}),`
+`,(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:`Идентификаторы и UI`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineFormatterId`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineIconPosition`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineValueIcon`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineValueStateIconSettings`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Общий config`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineGraph`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelinePlan`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineStep`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Graph`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineEdge`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineSourceNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineSinkNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineNormalizeLeadingZerosNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineRowBasedOverrideNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineResolveValueStateNode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineTypedValueFormatNode`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Plan steps`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineNormalizeLeadingZerosStep`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineRowBasedOverrideStep`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineResolveValueStateStep`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineTypedValueFormatStep`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Leading zeros`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FormattersPipelineNormalizeLeadingZerosConfig`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Row override`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineRowBasedOverrideConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineRowBasedOverrideFieldConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineRowBasedOverrideFormulaConfig`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Value state`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineResolveValueStateConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineValueStateResolverConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineFixedValueStateConfig`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineThresholdValueStateConfig`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Typed formatting`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineTypedValueContext`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineTypedValueFormatConfig`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Execution`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineRowKind`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineExecutionContext`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineExecutionResult`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineExecutor`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Runtime`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineRuntimeField`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineRuntimeFields`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineDisplayValue`}),`, `,(0,c.jsx)(t.code,{children:`FormatPipelineDisplayValueArgs`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Dependencies`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`RuntimeDependencyField`}),`, `,(0,c.jsx)(t.code,{children:`RuntimeFieldDependenciesPlan`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Validation`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FormattersPipelineValidationCode`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineValidationMessage`}),`, `,(0,c.jsx)(t.code,{children:`FormattersPipelineValidationResult`})]})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type {
+	FormattersPipelineConfig,
+	FormattersPipelineRuntimeField,
+	FormattersPipelineValidationResult
+} from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(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:`../rowBased/README.mdx`,children:`Row-based формулы и реестр`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../valueState/README.mdx`,children:`Value state`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../number/README.mdx`,children:`Числовые форматтеры`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../date/README.mdx`,children:`Даты`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../strings/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};