@ryuzaki13/react-foundation-ui 1.8.5 → 1.8.7

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

@@ -0,0 +1,860 @@
+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/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-колонки.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`данные строки + упорядоченные зависимости
+                    ↓
+            зарегистрированная формула
+                    ↓
+             конечное число или
+      контролируемая причина ошибки выполнения
+`})}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика без доступа к исходному коду. Здесь описано точное поведение всего публичного API, включая преобразование значений, реестр, validation, ошибки и связь с formatter pipeline.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`Назначение и границы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F`,children:`Основные понятия`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D1%84%D0%BE%D1%80%D0%BC%D1%83%D0%BB%D1%8B`,children:`Описание формулы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%BD%D1%82%D0%B5%D0%BA%D1%81%D1%82-%D1%84%D0%BE%D1%80%D0%BC%D1%83%D0%BB%D1%8B`,children:`Контекст формулы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%87%D0%B8%D1%81%D0%BB%D0%BE%D0%B2%D0%BE%D0%B5-%D0%BF%D1%80%D0%B5%D0%BE%D0%B1%D1%80%D0%B0%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-ctxnum`,children:[`Числовое преобразование `,(0,c.jsx)(t.code,{children:`ctx.num`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0`,children:`Создание и установка реестра`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D1%82%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B0%D0%BA%D1%82%D0%B8%D0%B2%D0%BD%D0%BE%D0%B3%D0%BE-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0`,children:`Чтение активного реестра`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%84%D0%BE%D1%80%D0%BC%D1%83%D0%BB%D1%8B`,children:`Выполнение формулы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%B0%D1%8F-%D0%BA%D0%BE%D0%BC%D0%BF%D0%B8%D0%BB%D1%8F%D1%86%D0%B8%D1%8F`,children:`Предварительная компиляция`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D0%B0%D0%BB%D0%B8%D0%B4%D0%B0%D1%86%D0%B8%D1%8F-%D0%B7%D0%B0%D0%B2%D0%B8%D1%81%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D0%B5%D0%B9`,children:`Валидация зависимостей`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D1%81-formatter-pipeline`,children:`Интеграция с formatter pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%82%D0%BB%D0%B8%D1%87%D0%B8%D0%B5-%D0%BE%D1%82-row-based-formatter`,children:`Отличие от row-based formatter`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B0%D1%80%D1%85%D0%B8%D1%82%D0%B5%D0%BA%D1%82%D1%83%D1%80%D0%B0-%D0%B8-%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Архитектура и безопасность`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5`,children:`Тестирование`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D0%B8%D0%B7%D0%B2%D0%BE%D0%B4%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Производительность`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Частые ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0`,children:`API-справка`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.h3,{id:`что-делает-модуль`,children:`Что делает модуль`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`описывает типизированный контракт числовой формулы;`}),`
+`,(0,c.jsx)(t.li,{children:`связывает dependency indexes с полями текущей строки;`}),`
+`,(0,c.jsx)(t.li,{children:`создаёт нормализованный реестр формул host-приложения;`}),`
+`,(0,c.jsx)(t.li,{children:`хранит один активный реестр в текущем экземпляре модуля;`}),`
+`,(0,c.jsx)(t.li,{children:`выполняет формулы без выбрасывания их runtime-ошибок наружу;`}),`
+`,(0,c.jsx)(t.li,{children:`компилирует formula + keys в переиспользуемый executor;`}),`
+`,(0,c.jsx)(t.li,{children:`проверяет существование формулы и корректность выбранных dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`сообщает, какие dependency indexes реально использовала формула на тестовых данных.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-модуль-не-делает`,children:`Чего модуль не делает`}),`
+`,(0,c.jsxs)(t.ul,{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:`eval`}),` или `,(0,c.jsx)(t.code,{children:`new Function`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет произвольный пользовательский JavaScript;`}),`
+`,(0,c.jsx)(t.li,{children:`не загружает зависимости с сервера;`}),`
+`,(0,c.jsx)(t.li,{children:`не добавляет нужные поля в OData/HTTP-запрос;`}),`
+`,(0,c.jsx)(t.li,{children:`не форматирует результат для UI;`}),`
+`,(0,c.jsx)(t.li,{children:`не выбирает fallback для конкретной таблицы;`}),`
+`,(0,c.jsx)(t.li,{children:`не поддерживает асинхронные формулы;`}),`
+`,(0,c.jsx)(t.li,{children:`не хранит function body в JSON или БД.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Host-приложение владеет прикладными `,(0,c.jsx)(t.code,{children:`TableFormulaDefinition`}),`: оно объявляет их в коде, тестирует, собирает в реестр и устанавливает на старте приложения.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Сериализуемая конфигурация колонки хранит только стабильный `,(0,c.jsx)(t.code,{children:`formulaId`}),` и ordered dependencies. Реальная функция остаётся доверенным кодом приложения.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте только опубликованный package subpath `,(0,c.jsx)(t.code,{children:`/formulas`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	compileTableFormula,
+	configureTableFormulaRegistry,
+	createTableFormulaRegistry,
+	executeTableFormula,
+	getTableFormulaById,
+	getTableFormulaList,
+	validateTableFormulaDependencies
+} from "@ryuzaki13/react-foundation-lib/formulas";
+
+import type { TableFormulaDefinition, TableFormulaExecutionResult, TableFormulaRegistry } from "@ryuzaki13/react-foundation-lib/formulas";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета и private imports из исходников не поддерживаются:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+// import { executeTableFormula } from "@ryuzaki13/react-foundation-lib";
+// import { executeTableFormula } from "@ryuzaki13/react-foundation-lib/src/formulas/execute";
+
+// Правильно.
+import { executeTableFormula } from "@ryuzaki13/react-foundation-lib/formulas";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Публичный модуль не зависит от React, DOM или browser-only API. Его runtime можно использовать в browser, worker и Node.js.`}),`
+`,(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:`import type { TableFormulaDefinition } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const sumFormula: TableFormulaDefinition = {
+	id: "sum",
+	name: "Сумма",
+	description: "Складывает две выбранные зависимости: $0 + $1.",
+	args: ["первое слагаемое", "второе слагаемое"],
+	keywords: ["сложение", "арифметика"],
+	fn: (ctx) => ctx.num(0) + ctx.num(1)
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`2-создайте-и-установите-реестр`,children:`2. Создайте и установите реестр`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { configureTableFormulaRegistry, createTableFormulaRegistry } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const registry = createTableFormulaRegistry([sumFormula]);
+
+configureTableFormulaRegistry(registry);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это bootstrap-операция. Выполните её один раз до первого чтения, validation, compile или execute.`}),`
+`,(0,c.jsx)(t.h3,{id:`3-выполните-формулу`,children:`3. Выполните формулу`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = executeTableFormula({
+	formulaId: "sum",
+	keys: ["planned", "actual"],
+	rowData: {
+		planned: 100,
+		actual: "25"
+	}
+});
+
+if (result.ok) {
+	console.log(result.value); // 125
+} else {
+	console.error(result.reason);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Порядок `,(0,c.jsx)(t.code,{children:`keys`}),` определяет смысл indexes:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`ctx.num(0) → rowData.planned
+ctx.num(1) → rowData.actual
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Формула не знает имена выбранных полей заранее. Она знает только позиции аргументов.`}),`
+`,(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:`type TableFormulaRowData = Record<string, unknown>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это обычный JavaScript-объект, где ключ — id поля, а значение пока считается `,(0,c.jsx)(t.code,{children:`unknown`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rowData = {
+	planned: 100,
+	actual: "25",
+	label: "План"
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не копирует и не валидирует всю строку. Он читает только keys, к которым обращается formula context.`}),`
+`,(0,c.jsx)(t.h3,{id:`зависимости-и-keys`,children:`Зависимости и keys`}),`
+`,(0,c.jsx)(t.p,{children:`Dependencies — упорядоченный массив id полей:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const keys = ["planned", "actual"];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Позиция является частью контракта:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`0`}),` означает `,(0,c.jsx)(t.code,{children:`planned`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`1`}),` означает `,(0,c.jsx)(t.code,{children:`actual`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если поменять элементы местами, формула получит другой смысл без TypeScript-ошибки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Формула вычисляет $0 - $1.
+keys: ["planned", "actual"]; // planned - actual
+keys: ["actual", "planned"]; // actual - planned
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Названия `,(0,c.jsx)(t.code,{children:`keys`}),` и `,(0,c.jsx)(t.code,{children:`dependencies`}),` обозначают один и тот же ordered mapping в разных API:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`compileTableFormula`}),` и `,(0,c.jsx)(t.code,{children:`executeTableFormula`}),` принимают `,(0,c.jsx)(t.code,{children:`keys`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`validateTableFormulaDependencies`}),` принимает `,(0,c.jsx)(t.code,{children:`dependencies`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`formatter runtime field обычно хранит `,(0,c.jsx)(t.code,{children:`formulaDependencies`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`реестр`,children:`Реестр`}),`
+`,(0,c.jsxs)(t.p,{children:[`Registry связывает стабильный `,(0,c.jsx)(t.code,{children:`formulaId`}),` с definition-функцией:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`"sum"   → sumFormula
+"ratio" → ratioFormula
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поскольку function не сериализуется, сохранённая конфигурация должна содержать id, а приложение при запуске обязано установить реестр с соответствующим definition.`}),`
+`,(0,c.jsx)(t.h2,{id:`описание-формулы`,children:`Описание формулы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TableFormulaDefinition {
+	id: string;
+	name: string;
+	description: string;
+	args?: readonly string[];
+	keywords?: readonly string[];
+	fn: TableFormulaFn;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`id`,children:(0,c.jsx)(t.code,{children:`id`})}),`
+`,(0,c.jsx)(t.p,{children:`Устойчивый технический идентификатор:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`id: "share-of-total-percent";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Он:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`trim-ится при создании реестра;`}),`
+`,(0,c.jsx)(t.li,{children:`обязан быть непустым;`}),`
+`,(0,c.jsx)(t.li,{children:`обязан быть уникальным после trim;`}),`
+`,(0,c.jsx)(t.li,{children:`может сохраняться в пользовательских конфигурациях;`}),`
+`,(0,c.jsx)(t.li,{children:`должен оставаться стабильным после релиза.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте display name как id и не генерируйте случайный id при каждом запуске.`}),`
+`,(0,c.jsx)(t.h3,{id:`name`,children:(0,c.jsx)(t.code,{children:`name`})}),`
+`,(0,c.jsx)(t.p,{children:`Короткое название для каталога или select:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`name: "Процентная доля";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory удаляет внешние пробелы, но не запрещает пустое name. За качество пользовательского каталога отвечает host.`}),`
+`,(0,c.jsx)(t.h3,{id:`description`,children:(0,c.jsx)(t.code,{children:`description`})}),`
+`,(0,c.jsx)(t.p,{children:`Объясняет формулу и порядок зависимостей:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`description: "100 * $0 / ($0 + $1)";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Factory trim-ит строку, но не анализирует выражение. `,(0,c.jsx)(t.code,{children:`$0`}),`, `,(0,c.jsx)(t.code,{children:`$1`}),` — только принятая человеком нотация документации, а не parser syntax.`]}),`
+`,(0,c.jsx)(t.h3,{id:`args`,children:(0,c.jsx)(t.code,{children:`args`})}),`
+`,(0,c.jsx)(t.p,{children:`Необязательные подписи positional arguments:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`args: ["выбранный показатель", "остальная часть"];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Runtime не проверяет их количество и не связывает их с keys автоматически. Поле предназначено для редактора и документации.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущая factory сохраняет исходную ссылку на массив `,(0,c.jsx)(t.code,{children:`args`}),`; она не клонирует и не замораживает сам массив. Передавайте стабильный readonly-массив и не мутируйте его после создания registry.`]}),`
+`,(0,c.jsx)(t.h3,{id:`keywords`,children:(0,c.jsx)(t.code,{children:`keywords`})}),`
+`,(0,c.jsx)(t.p,{children:`Необязательные поисковые слова каталога:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`keywords: ["процент", "доля"];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory создаёт отдельную копию массива, но элементы не trim-ит, а сам вложенный массив глубоко не замораживает. Считайте metadata read-only.`}),`
+`,(0,c.jsx)(t.h3,{id:`fn`,children:(0,c.jsx)(t.code,{children:`fn`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableFormulaFn = (ctx: TableFormulaContext) => number;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция обязана:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`работать синхронно;`}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращать `,(0,c.jsx)(t.code,{children:`number`}),`;`]}),`
+`,(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.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ratioFormula: TableFormulaDefinition = {
+	id: "ratio",
+	name: "Отношение",
+	description: "$0 / $1",
+	args: ["делимое", "делитель"],
+	fn: (ctx) => {
+		const divisor = ctx.num(1);
+		return divisor === 0 ? 0 : ctx.num(0) / divisor;
+	}
+};
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`контекст-формулы`,children:`Контекст формулы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TableFormulaContext {
+	key: (index: number) => string | undefined;
+	value: (index: number) => unknown;
+	num: (index: number) => number;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ctxkeyindex`,children:(0,c.jsx)(t.code,{children:`ctx.key(index)`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает id dependency по индексу:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// keys = ["planned", "actual"]
+ctx.key(0); // "planned"
+ctx.key(1); // "actual"
+ctx.key(2); // undefined
+ctx.key(-1); // undefined
+ctx.key(1.5); // undefined
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Допустим только целый неотрицательный index в пределах массива.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая строка технически может вернуться из `,(0,c.jsx)(t.code,{children:`key`}),`, если она была передана в `,(0,c.jsx)(t.code,{children:`keys`}),`, но `,(0,c.jsx)(t.code,{children:`value`}),` и `,(0,c.jsx)(t.code,{children:`num`}),` считают пустой key отсутствующим. Используйте только непустые dependency ids.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ctxvalueindex`,children:(0,c.jsx)(t.code,{children:`ctx.value(index)`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает исходное значение без преобразования:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// rowData.actual === "25"
+ctx.value(1); // "25"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для неправильного индекса, пустого key или отсутствующего свойства возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`value`}),`, когда нужно отличать отсутствующее значение от нуля или применять собственный parser:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`fn: (ctx) => {
+	const raw = ctx.value(0);
+	if (raw === null || raw === undefined || raw === "") return 0;
+
+	const value = Number(raw);
+	return Number.isFinite(value) ? value : 0;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ctxnumindex`,children:(0,c.jsx)(t.code,{children:`ctx.num(index)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Читает значение и применяет обычный `,(0,c.jsx)(t.code,{children:`Number(value)`}),`. Если результат не конечный, возвращает `,(0,c.jsx)(t.code,{children:`0`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`ctx.num(0) + ctx.num(1);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точная coercion-семантика описана в следующем разделе.`}),`
+`,(0,c.jsx)(t.h3,{id:`createtableformulacontextargs`,children:(0,c.jsx)(t.code,{children:`createTableFormulaContext(args)`})}),`
+`,(0,c.jsx)(t.p,{children:`Создаёт context вручную. Основные сценарии — unit-тест своей formula и validation infrastructure:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createTableFormulaContext } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const context = createTableFormulaContext({
+	rowData: {
+		price: "12.5",
+		count: 4
+	},
+	keys: ["price", "count"]
+});
+
+context.value(0); // "12.5"
+context.num(0); // 12.5
+context.num(1); // 4
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`keys`}),` копируется при создании context. Изменение исходного массива после вызова не меняет mapping. `,(0,c.jsx)(t.code,{children:`rowData`}),` не копируется: context читает переданный объект.`]}),`
+`,(0,c.jsx)(t.h3,{id:`instrumentation`,children:`Instrumentation`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createTableFormulaContext`}),` принимает необязательные callbacks для наблюдения за indexes:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const usedIndexes: number[] = [];
+const invalidIndexes: number[] = [];
+
+const context = createTableFormulaContext({
+	rowData: { A: 10 },
+	keys: ["A"],
+	instrumentation: {
+		onReadIndex: (index) => usedIndexes.push(index),
+		onOutOfRangeIndex: (index) => invalidIndexes.push(index)
+	}
+});
+
+context.num(0); // usedIndexes получает 0
+context.num(2); // usedIndexes и invalidIndexes получают 2
+context.num(-1); // invalidIndexes получает -1
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для отрицательного, дробного или другого неправильного index вызывается только `,(0,c.jsx)(t.code,{children:`onOutOfRangeIndex`}),`. Для целого неотрицательного index сначала вызывается `,(0,c.jsx)(t.code,{children:`onReadIndex`}),`, даже если index оказался больше последнего элемента, а затем — `,(0,c.jsx)(t.code,{children:`onOutOfRangeIndex`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Тип instrumentation отдельно не экспортируется по имени, но TypeScript проверяет объект непосредственно в аргументах функции.`}),`
+`,(0,c.jsxs)(t.h2,{id:`числовое-преобразование-ctxnum`,children:[`Числовое преобразование `,(0,c.jsx)(t.code,{children:`ctx.num`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ctx.num`}),` не использует `,(0,c.jsx)(t.code,{children:`toFiniteNumber`}),` из formatter-ов. Внутри выполняется:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalized = Number(value);
+return Number.isFinite(normalized) ? normalized : 0;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Отсюда следует стандартная JavaScript-coercion:`}),`
+`,(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,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`ctx.num(index)`})}),(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:`10`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`10`})}),(0,c.jsx)(t.td,{children:`уже конечный number`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"10"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`10`})}),(0,c.jsx)(t.td,{children:`numeric string`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"12.5"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`12.5`})}),(0,c.jsxs)(t.td,{children:[`точка поддерживается `,(0,c.jsx)(t.code,{children:`Number`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`""`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Number("") === 0`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"   "`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsx)(t.td,{children:`whitespace string становится нулём`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Number(null) === 0`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`Number(undefined)`}),` даёт `,(0,c.jsx)(t.code,{children:`NaN`}),`, затем fallback`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`1`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Number(true) === 1`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Number(false) === 0`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"abc"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`, затем fallback`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Infinity`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsx)(t.td,{children:`не finite`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"1 234,5"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`0`})}),(0,c.jsxs)(t.td,{children:[`локализованная строка не поддержана `,(0,c.jsx)(t.code,{children:`Number`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Это удобно для простых числовых DTO, но не является строгой validation.`}),`
+`,(0,c.jsx)(t.p,{children:`Если строка может содержать пробелы группировки или запятую, выберите явную policy:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { toFiniteNumber } from "@ryuzaki13/react-foundation-lib/formatters";
+import type { TableFormulaDefinition } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const localizedNumberFormula: TableFormulaDefinition = {
+	id: "localized-value",
+	name: "Локализованное число",
+	description: "Читает первую зависимость через SAP-like parser.",
+	fn: (ctx) => toFiniteNumber(ctx.value(0)) ?? 0
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не добавляйте parser автоматически во все formulas, если transport уже возвращает numbers. Выбор зависит от контракта данных host-приложения.`}),`
+`,(0,c.jsx)(t.h2,{id:`создание-и-установка-реестра`,children:`Создание и установка реестра`}),`
+`,(0,c.jsx)(t.h3,{id:`createtableformularegistrydefinitions`,children:(0,c.jsx)(t.code,{children:`createTableFormulaRegistry(definitions)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function createTableFormulaRegistry(definitions: readonly TableFormulaDefinition[]): TableFormulaRegistry;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Factory проходит definitions в исходном порядке и для каждого элемента:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`trim-ит `,(0,c.jsx)(t.code,{children:`id`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`запрещает пустой id;`}),`
+`,(0,c.jsx)(t.li,{children:`запрещает повторный id после trim;`}),`
+`,(0,c.jsxs)(t.li,{children:[`trim-ит `,(0,c.jsx)(t.code,{children:`name`}),` и `,(0,c.jsx)(t.code,{children:`description`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`копирует `,(0,c.jsx)(t.code,{children:`keywords`}),`, если они заданы;`]}),`
+`,(0,c.jsx)(t.li,{children:`создаёт новый поверхностно замороженный definition;`}),`
+`,(0,c.jsxs)(t.li,{children:[`добавляет его в ordered `,(0,c.jsx)(t.code,{children:`list`}),` и lookup `,(0,c.jsx)(t.code,{children:`byId`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const registry = createTableFormulaRegistry([
+	{
+		id: "  sum  ",
+		name: "  Сумма  ",
+		description: "  $0 + $1  ",
+		fn: (ctx) => ctx.num(0) + ctx.num(1)
+	}
+]);
+
+registry.list[0].id; // "sum"
+registry.list[0].name; // "Сумма"
+registry.byId.get("sum") === registry.list[0]; // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустой или дублирующийся id приводит к fail-fast исключению:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createTableFormulaRegistry([{ id: " ", name: "Пустая", description: "", fn: () => 0 }]);
+// Error: Formula id не может быть пустым
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createTableFormulaRegistry([
+	{ id: "sum", name: "A", description: "", fn: () => 0 },
+	{ id: " sum ", name: "B", description: "", fn: () => 0 }
+]);
+// Error: дублирующийся formulaId
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`readonly-и-freeze`,children:`Readonly и freeze`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableFormulaRegistry = Readonly<{
+	list: readonly TableFormulaDefinition[];
+	byId: ReadonlyMap<string, TableFormulaDefinition>;
+}>;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Registry object, list и каждый definition поверхностно заморожены. Это защищает основные metadata fields от обычной мутации.`}),`
+`,(0,c.jsx)(t.p,{children:`Freeze не является глубоким:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`args`}),` сохраняет входную ссылку;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`keywords`}),` копируется, но сам массив не заморожен;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`byId`}),` типизирован как `,(0,c.jsx)(t.code,{children:`ReadonlyMap`}),`, однако runtime object остаётся обычным `,(0,c.jsx)(t.code,{children:`Map`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не обходите readonly casts и не мутируйте внутренности. Считайте registry полностью неизменяемым consumer-контрактом.`}),`
+`,(0,c.jsx)(t.h3,{id:`configuretableformularegistryregistry`,children:(0,c.jsx)(t.code,{children:`configureTableFormulaRegistry(registry)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`configureTableFormulaRegistry(registry);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Заменяет активный module-level registry. По умолчанию активен пустой реестр, поэтому без настройки любой formula id считается неизвестным.`}),`
+`,(0,c.jsx)(t.p,{children:`Правильный lifecycle:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`объявить definitions
+        ↓
+createTableFormulaRegistry
+        ↓
+configureTableFormulaRegistry
+        ↓
+validate configs
+        ↓
+compile runtime fields
+        ↓
+execute для строк
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Устанавливайте registry в composition root до первого React render или другого consumer runtime.`}),`
+`,(0,c.jsx)(t.h3,{id:`глобальность-реестра`,children:`Глобальность реестра`}),`
+`,(0,c.jsxs)(t.p,{children:[`Активный registry один для загруженного экземпляра ESM-модуля. `,(0,c.jsx)(t.code,{children:`configureTableFormulaRegistry`}),` не объединяет catalogs, а полностью заменяет текущий.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не переключайте registry:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`во время component render;`}),`
+`,(0,c.jsx)(t.li,{children:`для каждой таблицы;`}),`
+`,(0,c.jsx)(t.li,{children:`перед каждым execute;`}),`
+`,(0,c.jsx)(t.li,{children:`как способ хранить пользовательский state.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`В тестах замена допустима, но состояние нужно восстанавливать между test cases.`}),`
+`,(0,c.jsx)(t.h3,{id:`уже-скомпилированные-executors`,children:`Уже скомпилированные executors`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`compileTableFormula`}),` получает definition из активного registry и замыкает его функцию. Если после этого установить другой registry, ранее созданный executor продолжит выполнять старую formula function.`]}),`
+`,(0,c.jsx)(t.p,{children:`Новые compile/execute вызовы будут использовать новый активный registry.`}),`
+`,(0,c.jsx)(t.h2,{id:`чтение-активного-реестра`,children:`Чтение активного реестра`}),`
+`,(0,c.jsx)(t.h3,{id:`gettableformulalist`,children:(0,c.jsx)(t.code,{children:`getTableFormulaList()`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const formulas = getTableFormulaList();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает тот же readonly list активного registry, а не новую копию. Порядок совпадает с порядком definitions, переданных factory.`}),`
+`,(0,c.jsx)(t.p,{children:`Это удобно для UI-каталога:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const options = getTableFormulaList().map((formula) => ({
+	value: formula.id,
+	label: formula.name,
+	description: formula.description
+}));
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`gettableformulabyidformulaid`,children:(0,c.jsx)(t.code,{children:`getTableFormulaById(formulaId)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Trim-ит id и возвращает definition либо `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getTableFormulaById(" sum "); // definition с id "sum"
+getTableFormulaById(""); // undefined
+getTableFormulaById("   "); // undefined
+getTableFormulaById(undefined); // undefined
+getTableFormulaById("unknown"); // undefined
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращается объект из registry, не clone.`}),`
+`,(0,c.jsx)(t.h2,{id:`выполнение-формулы`,children:`Выполнение формулы`}),`
+`,(0,c.jsx)(t.h3,{id:`executetableformulaargs`,children:(0,c.jsx)(t.code,{children:`executeTableFormula(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = executeTableFormula({
+	formulaId: "ratio",
+	keys: ["amount", "count"],
+	rowData: row
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция сначала компилирует formula + keys, затем один раз выполняет полученный executor.`}),`
+`,(0,c.jsx)(t.p,{children:`Результат — discriminated union:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type TableFormulaExecutionResult =
+	| { ok: true; value: number }
+	| {
+			ok: false;
+			reason: "formula_not_found" | "invalid_result" | "runtime_error";
+	  };
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Всегда проверяйте `,(0,c.jsx)(t.code,{children:`ok`}),` перед чтением `,(0,c.jsx)(t.code,{children:`value`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = executeTableFormula(args);
+
+if (result.ok) {
+	return result.value;
+}
+
+switch (result.reason) {
+	case "formula_not_found":
+		return "Формула больше не доступна";
+	case "invalid_result":
+		return "Формула вернула некорректное число";
+	case "runtime_error":
+		return "Не удалось выполнить формулу";
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`formula_not_found`,children:(0,c.jsx)(t.code,{children:`formula_not_found`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращается, если:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`formulaId`}),` равен `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`id пуст после trim;`}),`
+`,(0,c.jsx)(t.li,{children:`id отсутствует в активном registry;`}),`
+`,(0,c.jsx)(t.li,{children:`registry ещё не установлен.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`invalid_result`,children:(0,c.jsx)(t.code,{children:`invalid_result`})}),`
+`,(0,c.jsx)(t.p,{children:`Formula function выполнилась без исключения, но вернула не конечный number:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`fn: () => Infinity;
+fn: () => NaN;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Даже если через ошибочный cast функция вернула строку `,(0,c.jsx)(t.code,{children:`"10"`}),`, результат будет invalid: `,(0,c.jsx)(t.code,{children:`Number.isFinite`}),` не выполняет coercion.`]}),`
+`,(0,c.jsx)(t.h3,{id:`runtime_error`,children:(0,c.jsx)(t.code,{children:`runtime_error`})}),`
+`,(0,c.jsx)(t.p,{children:`Formula function выбросила исключение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`fn: () => {
+	throw new Error("Ошибка расчёта");
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Исключение перехватывается. Публичный результат не содержит исходный `,(0,c.jsx)(t.code,{children:`Error`}),`, stack или message. Это безопасная runtime-граница, но не полноценная diagnostics-система. Тестируйте formulas отдельно, чтобы видеть настоящую причину до production.`]}),`
+`,(0,c.jsx)(t.h3,{id:`отсутствующие-keys`,children:`Отсутствующие keys`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`keys`}),` не переданы, context имеет пустой mapping. Formula всё равно компилируется, но `,(0,c.jsx)(t.code,{children:`ctx.num(index)`}),` возвращает `,(0,c.jsx)(t.code,{children:`0`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`executeTableFormula({
+	formulaId: "sum",
+	rowData: { A: 10, B: 20 }
+});
+// sum($0, $1) успешно вернёт 0 + 0 === 0
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не ошибка execution API. Ошибку недостаточного количества dependencies должен обнаружить `,(0,c.jsx)(t.code,{children:`validateTableFormulaDependencies`}),` до compile.`]}),`
+`,(0,c.jsx)(t.h2,{id:`предварительная-компиляция`,children:`Предварительная компиляция`}),`
+`,(0,c.jsx)(t.h3,{id:`compiletableformulaargs`,children:(0,c.jsx)(t.code,{children:`compileTableFormula(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const compiled = compileTableFormula({
+	formulaId: "ratio",
+	keys: ["amount", "count"]
+});
+
+if (!compiled.ok) {
+	// Единственная compile-причина — formula_not_found.
+	throw new Error("Формула не найдена");
+}
+
+const first = compiled.execute({ amount: 100, count: 20 });
+const second = compiled.execute({ amount: 120, count: 40 });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Compile result:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CompileResult = { ok: true; execute: TableFormulaCompiledExecutor } | { ok: false; reason: "formula_not_found" };
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`CompileResult`}),` показан для понимания, но отдельное именованное публичное type export для него отсутствует. TypeScript выводит тип из возвращаемого значения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-фиксируется-при-compile`,children:`Что фиксируется при compile`}),`
+`,(0,c.jsx)(t.p,{children:`Compiler:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`находит formula definition один раз;`}),`
+`,(0,c.jsxs)(t.li,{children:[`копирует массив `,(0,c.jsx)(t.code,{children:`keys`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`создаёт один context object;`}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает executor `,(0,c.jsx)(t.code,{children:`(rowData) => result`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Изменение исходного массива keys после compile не влияет на executor. Замена активного registry также не меняет уже найденную formula function.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-происходит-при-каждом-execute`,children:`Что происходит при каждом execute`}),`
+`,(0,c.jsx)(t.p,{children:`Executor:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`записывает ссылку на текущий `,(0,c.jsx)(t.code,{children:`rowData`}),` во внутренний context;`]}),`
+`,(0,c.jsx)(t.li,{children:`синхронно вызывает formula function;`}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяет `,(0,c.jsx)(t.code,{children:`Number.isFinite(result)`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращает success или controlled error.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`rowData`}),` не копируется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`когда-выбирать-compile`,children:`Когда выбирать compile`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для одной проверки или редкого расчёта допустим `,(0,c.jsx)(t.code,{children:`executeTableFormula`}),`. Для таблицы с десятками/сотнями строк компилируйте один раз на поле и переиспользуйте executor:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const compiled = compileTableFormula({ formulaId, keys });
+
+if (compiled.ok) {
+	for (const row of rows) {
+		const result = compiled.execute(row);
+		// обработка результата
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`executeTableFormula`}),` выполняет lookup и compile на каждом вызове, поэтому не является оптимальным горячим путём ячейки.`]}),`
+`,(0,c.jsx)(t.h3,{id:`синхронность-и-повторный-вход`,children:`Синхронность и повторный вход`}),`
+`,(0,c.jsxs)(t.p,{children:[`Compiled executor переиспользует один context с изменяемой внутренней ссылкой на `,(0,c.jsx)(t.code,{children:`rowData`}),`. Это безопасно для обычной синхронной формулы.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не делайте formula `,(0,c.jsx)(t.code,{children:`async`}),`, не сохраняйте `,(0,c.jsx)(t.code,{children:`ctx`}),` во внешнем state и не запускайте тот же executor рекурсивно из formula. Такой код нарушает lifecycle переиспользуемого context.`]}),`
+`,(0,c.jsx)(t.h2,{id:`валидация-зависимостей`,children:`Валидация зависимостей`}),`
+`,(0,c.jsx)(t.h3,{id:`validatetableformuladependenciesargs`,children:(0,c.jsx)(t.code,{children:`validateTableFormulaDependencies(args)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const validation = validateTableFormulaDependencies({
+	formulaId: "sum",
+	dependencies: ["planned", "actual"],
+	availableColumnIds: ["planned", "actual", "label"]
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface TableFormulaDependenciesValidationResult {
+	ok: boolean;
+	errors: TableFormulaValidationMessage[];
+	warnings: TableFormulaValidationMessage[];
+	usage: {
+		usedDependencyIndexes: number[];
+		usedDependencyIds: string[];
+		requiredDependencyCount: number;
+	};
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ok`}),` становится `,(0,c.jsx)(t.code,{children:`false`}),`, только если есть errors. Warnings не запрещают применение config.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-проверяется`,children:`Что проверяется`}),`
+`,(0,c.jsx)(t.p,{children:`Validator:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`ищет formula в активном registry;`}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяет, что каждый dependency id входит в `,(0,c.jsx)(t.code,{children:`availableColumnIds`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`запускает formula на положительных synthetic values;`}),`
+`,(0,c.jsx)(t.li,{children:`запускает formula на отрицательных synthetic values;`}),`
+`,(0,c.jsx)(t.li,{children:`через instrumentation собирает прочитанные indexes;`}),`
+`,(0,c.jsx)(t.li,{children:`обнаруживает обращения за пределы dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`сообщает неиспользованные dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`сообщает отсутствие чтения dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`сообщает исключение на synthetic data.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`errors`,children:`Errors`}),`
+`,(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.code,{children:`code`})}),(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:`formula_not_found`})}),(0,c.jsx)(t.td,{children:`Formula id отсутствует в registry`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dependency_not_available`})}),(0,c.jsx)(t.td,{children:`Dependency id отсутствует среди доступных колонок`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dependency_index_out_of_range`})}),(0,c.jsx)(t.td,{children:`Formula прочитала index, для которого dependency не передан`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`warnings`,children:`Warnings`}),`
+`,(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.code,{children:`code`})}),(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:`unused_dependencies`})}),(0,c.jsx)(t.td,{children:`Выбраны dependencies, которые formula не прочитала на test passes`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formula_does_not_use_dependencies`})}),(0,c.jsx)(t.td,{children:`Formula не прочитала ни одного index`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formula_runtime_error`})}),(0,c.jsx)(t.td,{children:`Formula выбросила исключение на synthetic data`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`usage`,children:`Usage`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`validation.usage.usedDependencyIndexes; // например [0, 1]
+validation.usage.usedDependencyIds; // например ["planned", "actual"]
+validation.usage.requiredDependencyCount; // 2
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`requiredDependencyCount`}),` равен `,(0,c.jsx)(t.code,{children:`максимальный использованный index + 1`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это полезно редактору:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`показать, сколько arguments ожидает formula;`}),`
+`,(0,c.jsx)(t.li,{children:`подсветить лишние dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`объяснить missing index;`}),`
+`,(0,c.jsx)(t.li,{children:`построить diagnostics без анализа JavaScript source.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`availablecolumnids-нужно-передавать-явно`,children:[(0,c.jsx)(t.code,{children:`availableColumnIds`}),` нужно передавать явно`]}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию список доступных колонок пуст. Если передать dependencies, но не передать `,(0,c.jsx)(t.code,{children:`availableColumnIds`}),`, каждый dependency будет считаться недоступным:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`validateTableFormulaDependencies({
+	formulaId: "sum",
+	dependencies: ["A", "B"]
+});
+// dependency_not_available для A и B
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если вы хотите проверить реальную конфигурацию колонки, передайте полный разрешённый набор field ids.`}),`
+`,(0,c.jsx)(t.h3,{id:`validator-выполняет-formula-function`,children:`Validator выполняет formula function`}),`
+`,(0,c.jsxs)(t.p,{children:[`Validation — не статический анализ. Она действительно вызывает `,(0,c.jsx)(t.code,{children:`fn`}),` как минимум два раза. Поэтому formula обязана быть чистой:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: validation и каждый row execution меняют внешний state.
+fn: (ctx) => {
+	counter += 1;
+	return ctx.num(0);
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не выполняйте в formula:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`сетевые запросы;`}),`
+`,(0,c.jsx)(t.li,{children:`запись в store;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM-операции;`}),`
+`,(0,c.jsxs)(t.li,{children:[`mutation `,(0,c.jsx)(t.code,{children:`rowData`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`logging на каждый вызов;`}),`
+`,(0,c.jsx)(t.li,{children:`генерацию случайных значений;`}),`
+`,(0,c.jsx)(t.li,{children:`чтение текущего времени как части результата.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`ограничения-validation`,children:`Ограничения validation`}),`
+`,(0,c.jsx)(t.p,{children:`Два synthetic passes повышают шанс пройти разные branches, но не доказывают корректность для всех данных.`}),`
+`,(0,c.jsx)(t.p,{children:`Validator не гарантирует:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`выполнение каждой условной ветки;`}),`
+`,(0,c.jsx)(t.li,{children:`корректность business formula;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствие деления на ноль на реальных данных;`}),`
+`,(0,c.jsx)(t.li,{children:`конечный numeric result;`}),`
+`,(0,c.jsxs)(t.li,{children:[`корректность `,(0,c.jsx)(t.code,{children:`args`}),` metadata;`]}),`
+`,(0,c.jsx)(t.li,{children:`уникальность/непустоту dependency ids;`}),`
+`,(0,c.jsxs)(t.li,{children:[`наличие fields в реальном `,(0,c.jsx)(t.code,{children:`rowData`}),` во время execute.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Особенно важно: validation игнорирует возвращаемое число и проверяет только runtime exception. Formula, возвращающая `,(0,c.jsx)(t.code,{children:`Infinity`}),`, может пройти dependency validation, но execution затем вернёт `,(0,c.jsx)(t.code,{children:`invalid_result`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому validator дополняет, а не заменяет unit-tests formula.`}),`
+`,(0,c.jsx)(t.h3,{id:`условные-dependencies`,children:`Условные dependencies`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`fn: (ctx) => (ctx.num(0) > 0 ? ctx.num(1) : ctx.num(2));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Положительный и отрицательный passes могут обнаружить indexes `,(0,c.jsx)(t.code,{children:`1`}),` и `,(0,c.jsx)(t.code,{children:`2`}),`, но сложные branches всё равно способны скрыть dependency. Документируйте полный positional contract в `,(0,c.jsx)(t.code,{children:`args`}),` и тестируйте все ветки самостоятельно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`повторяющиеся-ids`,children:`Повторяющиеся ids`}),`
+`,(0,c.jsx)(t.p,{children:`Validator не дедуплицирует dependencies. Если передать один field id в нескольких позициях, оба indexes будут читать одно и то же свойство rowData. Обычно это ошибка конфигурации, хотя технически она допустима.`}),`
+`,(0,c.jsx)(t.h2,{id:`интеграция-с-formatter-pipeline`,children:`Интеграция с formatter pipeline`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`formatters/pipeline`}),` умеет выполнять table formula до остальных шагов форматирования.`]}),`
+`,(0,c.jsx)(t.p,{children:`Минимальный runtime field:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	compileFormattersPipelineRuntime,
+	formatPipelineDisplayValue,
+	type FormattersPipelineRuntimeField
+} from "@ryuzaki13/react-foundation-lib/formatters";
+
+const field: FormattersPipelineRuntimeField = {
+	id: "total",
+	role: "measure",
+	type: "decimal",
+	formulaId: "sum",
+	formulaDependencies: ["planned", "actual"],
+	purelyDerived: true,
+	emptyWhenZero: false
+};
+
+compileFormattersPipelineRuntime(field);
+
+const display = formatPipelineDisplayValue({
+	field,
+	rawValue: undefined,
+	rowData: {
+		planned: 100,
+		actual: 25
+	},
+	rowKind: "plain"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Runtime flow:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`rawValue
+   ↓ table formula из /formulas
+   ↓ formatter pipeline steps
+   ↓ typed formatting / fallback
+display result
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Важно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`registry должен быть установлен до `,(0,c.jsx)(t.code,{children:`compileFormattersPipelineRuntime`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`поле должно содержать все `,(0,c.jsx)(t.code,{children:`formulaDependencies`}),` в `,(0,c.jsx)(t.code,{children:`rowData`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`pipeline compiler сохраняет formula executor в самом field object;`}),`
+`,(0,c.jsx)(t.li,{children:`invalid/missing formula не выбрасывается при display execution;`}),`
+`,(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:`purelyDerived`}),` ошибка откатывается к `,(0,c.jsx)(t.code,{children:`rawValue`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`emptyWhenZero`}),` может скрыть успешный нулевой source result.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Полный lifecycle и mutation-контракт runtime compiler описаны в `,(0,c.jsx)(t.a,{href:`../formatters/pipeline/README.mdx`,children:`README formatter pipeline`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`зависимости-должны-попасть-в-данные-строки`,children:`Зависимости должны попасть в данные строки`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formulaDependencies`}),` — это не request builder. Сам модуль не добавляет fields в OData select и не загружает их.`]}),`
+`,(0,c.jsx)(t.p,{children:`Owner таблицы/query обязан:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`проверить dependency ids относительно доступных columns;`}),`
+`,(0,c.jsx)(t.li,{children:`включить нужные fields в серверный запрос или локальный row model;`}),`
+`,(0,c.jsxs)(t.li,{children:[`передать полный `,(0,c.jsx)(t.code,{children:`rowData`}),` formatter runtime.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Иначе `,(0,c.jsx)(t.code,{children:`ctx.value`}),` вернёт `,(0,c.jsx)(t.code,{children:`undefined`}),`, а `,(0,c.jsx)(t.code,{children:`ctx.num`}),` — `,(0,c.jsx)(t.code,{children:`0`}),`, что может выглядеть как успешный, но неверный расчёт.`]}),`
+`,(0,c.jsx)(t.h2,{id:`отличие-от-row-based-formatter`,children:`Отличие от row-based formatter`}),`
+`,(0,c.jsxs)(t.p,{children:[`В пакете есть похожий, но отдельный реестр `,(0,c.jsx)(t.code,{children:`formatters/rowBased`}),`.`]}),`
+`,(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.jsxs)(t.th,{children:[`Table formula (`,(0,c.jsx)(t.code,{children:`/formulas`}),`)`]}),(0,c.jsxs)(t.th,{children:[`Row-based formatter (`,(0,c.jsx)(t.code,{children:`/formatters`}),`)`]})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Основная задача`}),(0,c.jsx)(t.td,{children:`Рассчитать numeric value колонки`}),(0,c.jsx)(t.td,{children:`Подменить текущее значение внутри formatter pipeline`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Результат function`}),(0,c.jsxs)(t.td,{children:[`Только `,(0,c.jsx)(t.code,{children:`number`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Context`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`key`}),`, `,(0,c.jsx)(t.code,{children:`value`}),`, `,(0,c.jsx)(t.code,{children:`num`})]}),(0,c.jsxs)(t.td,{children:[`дополнительно `,(0,c.jsx)(t.code,{children:`rawValue`}),`, `,(0,c.jsx)(t.code,{children:`rowData`}),`, `,(0,c.jsx)(t.code,{children:`columnId`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Место выполнения`}),(0,c.jsx)(t.td,{children:`До formatter pipeline`}),(0,c.jsxs)(t.td,{children:[`Шаг `,(0,c.jsx)(t.code,{children:`rowBasedOverride`}),` внутри pipeline`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Конфиг поля`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`formulaId`}),`, `,(0,c.jsx)(t.code,{children:`formulaDependencies`})]}),(0,c.jsxs)(t.td,{children:[`Pipeline step с `,(0,c.jsx)(t.code,{children:`formulaId`}),`, `,(0,c.jsx)(t.code,{children:`dependencyIds`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Registry`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`configureTableFormulaRegistry`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`configureRowBasedFormatterRegistry`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Error result`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`formula_not_found`}),`, `,(0,c.jsx)(t.code,{children:`invalid_result`}),`, `,(0,c.jsx)(t.code,{children:`runtime_error`})]}),(0,c.jsxs)(t.td,{children:[`Управляется `,(0,c.jsx)(t.code,{children:`fallbackToRaw`}),` pipeline step`]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте одинаковый id как доказательство, что formula автоматически доступна в обоих реестрах. Это независимые catalogs и APIs.`}),`
+`,(0,c.jsx)(t.p,{children:`Простое правило:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`вычисляемая числовая колонка → table formula;`}),`
+`,(0,c.jsx)(t.li,{children:`contextual display override внутри pipeline → row-based formatter.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`архитектура-и-безопасность`,children:`Архитектура и безопасность`}),`
+`,(0,c.jsx)(t.h3,{id:`где-размещать-definitions`,children:`Где размещать definitions`}),`
+`,(0,c.jsx)(t.p,{children:`Foundation-пакет предоставляет только механизм. Конкретные business formulas принадлежат host-приложению:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`app composition / registries
+  ├─ formula definitions
+  ├─ единый ordered catalog
+  ├─ createTableFormulaRegistry
+  └─ configureTableFormulaRegistry при bootstrap
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Формулу, специфичную для одной feature/entity, не следует переносить в foundation только потому, что она использует общий runtime.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-нет-formula-strings`,children:`Почему нет formula strings`}),`
+`,(0,c.jsxs)(t.p,{children:[`Конфигурация вида `,(0,c.jsx)(t.code,{children:`"$0 + $1"`}),` не исполняется как код. Это осознанная граница:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`нет `,(0,c.jsx)(t.code,{children:`eval`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`нет dynamic code generation;`}),`
+`,(0,c.jsx)(t.li,{children:`нет необходимости доверять тексту из БД;`}),`
+`,(0,c.jsx)(t.li,{children:`TypeScript проверяет написанные definitions;`}),`
+`,(0,c.jsx)(t.li,{children:`обычные unit-tests видят функцию напрямую.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`description`}),` может содержать формулу для человека, но runtime выполняет только `,(0,c.jsx)(t.code,{children:`fn`}),`, заранее включённую разработчиком в registry.`]}),`
+`,(0,c.jsx)(t.h3,{id:`доверенный-код-всё-равно-требует-дисциплины`,children:`Доверенный код всё равно требует дисциплины`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль перехватывает exceptions и invalid numbers, но не может отменить уже выполненный side effect. Если formula изменила store, отправила запрос или мутировала rowData, возврат `,(0,c.jsx)(t.code,{children:`runtime_error`}),` не откатит это действие.`]}),`
+`,(0,c.jsx)(t.p,{children:`Формулы должны быть чистыми вычислениями.`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильность-ids`,children:`Стабильность ids`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если id сохраняется в конфигурации пользователя, его переименование разорвёт связь и даст `,(0,c.jsx)(t.code,{children:`formula_not_found`}),`. Миграцию сохранённых configs должен выполнять владелец config boundary. Не добавляйте silent alias в foundation без отдельного требования.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`изоляция-глобального-реестра`,children:`Изоляция глобального реестра`}),`
+`,(0,c.jsx)(t.p,{children:`Registry не имеет отдельной reset-функции. Для теста установите нужный registry, а после теста верните пустой или application registry:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { afterEach, beforeEach } from "vitest";
+import { configureTableFormulaRegistry, createTableFormulaRegistry } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const testRegistry = createTableFormulaRegistry([sumFormula]);
+
+beforeEach(() => {
+	configureTableFormulaRegistry(testRegistry);
+});
+
+afterEach(() => {
+	configureTableFormulaRegistry(createTableFormulaRegistry([]));
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если тесты выполняются параллельно в одном module instance и меняют registry, централизуйте setup или избегайте concurrent cases.`}),`
+`,(0,c.jsx)(t.h3,{id:`unit-test-formula-без-registry`,children:`Unit-test formula без registry`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createTableFormulaContext } from "@ryuzaki13/react-foundation-lib/formulas";
+
+const context = createTableFormulaContext({
+	rowData: { A: 100, B: 25 },
+	keys: ["A", "B"]
+});
+
+expect(sumFormula.fn(context)).toBe(125);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Этот тест показывает настоящую thrown error и удобен для business cases.`}),`
+`,(0,c.jsx)(t.h3,{id:`integration-test-через-public-runtime`,children:`Integration-test через public runtime`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(
+	executeTableFormula({
+		formulaId: "sum",
+		rowData: { A: 100, B: 25 },
+		keys: ["A", "B"]
+	})
+).toEqual({ ok: true, value: 125 });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так проверяются registry lookup, context mapping и result boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`минимальная-матрица`,children:`Минимальная матрица`}),`
+`,(0,c.jsx)(t.p,{children:`Для каждой нетривиальной formula проверяйте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`обычные положительные values;`}),`
+`,(0,c.jsx)(t.li,{children:`нули;`}),`
+`,(0,c.jsx)(t.li,{children:`отрицательные values;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствующие properties;`}),`
+`,(0,c.jsx)(t.li,{children:`строки вместо numbers, если transport это допускает;`}),`
+`,(0,c.jsx)(t.li,{children:`деление на ноль;`}),`
+`,(0,c.jsx)(t.li,{children:`порядок dependencies;`}),`
+`,(0,c.jsx)(t.li,{children:`каждый conditional branch;`}),`
+`,(0,c.jsx)(t.li,{children:`конечность результата;`}),`
+`,(0,c.jsx)(t.li,{children:`validation с недостаточными и лишними dependencies.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для registry отдельно проверяйте уникальность ids и expected order каталога.`}),`
+`,(0,c.jsx)(t.h2,{id:`производительность`,children:`Производительность`}),`
+`,(0,c.jsx)(t.h3,{id:`горячий-путь-таблицы`,children:`Горячий путь таблицы`}),`
+`,(0,c.jsx)(t.p,{children:`Главная оптимизация — предварительная компиляция:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`медленнее: executeTableFormula для каждой ячейки
+быстрее:   compileTableFormula один раз → execute(rowData) для каждой строки
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Compiled executor переиспользует context и не делает registry lookup на каждую строку.`}),`
+`,(0,c.jsx)(t.p,{children:`Formatter pipeline уже использует этот подход: runtime field компилируется на construction-stage.`}),`
+`,(0,c.jsx)(t.h3,{id:`внутренние-benchmark-helpers`,children:`Внутренние benchmark helpers`}),`
+`,(0,c.jsxs)(t.p,{children:[`В исходном каталоге существуют `,(0,c.jsx)(t.code,{children:`runTableFormulaRuntimePerf`}),` и `,(0,c.jsx)(t.code,{children:`runTableFormulaV2PrecompilePerf`}),`, но `,(0,c.jsx)(t.code,{children:`src/formulas/index.ts`}),` их не экспортирует. Они предназначены для внутреннего perf-теста пакета и не являются публичным API `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formulas`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не делайте private import. Для измерения своего consumer-кода используйте собственный benchmark вокруг публичного `,(0,c.jsx)(t.code,{children:`compileTableFormula`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Абсолютные timings зависят от устройства и runtime; сравнивайте несколько прогретых запусков и относительную разницу.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`не-установить-registry-до-runtime`,children:`Не установить registry до runtime`}),`
+`,(0,c.jsxs)(t.p,{children:[`Результатом будет `,(0,c.jsx)(t.code,{children:`formula_not_found`}),`, даже если definition существует в файле приложения, но не был передан `,(0,c.jsx)(t.code,{children:`configureTableFormulaRegistry`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`перепутать-порядок-dependencies`,children:`Перепутать порядок dependencies`}),`
+`,(0,c.jsxs)(t.p,{children:[`Indexes не знают бизнес-названий. `,(0,c.jsx)(t.code,{children:`[A, B]`}),` и `,(0,c.jsx)(t.code,{children:`[B, A]`}),` — разные формулы для вычитания/деления.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-ctxnum-строгим-parser`,children:[`Считать `,(0,c.jsx)(t.code,{children:`ctx.num`}),` строгим parser`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),`, пустая строка и `,(0,c.jsx)(t.code,{children:`false`}),` превращаются в `,(0,c.jsx)(t.code,{children:`0`}),`, а `,(0,c.jsx)(t.code,{children:`true`}),` — в `,(0,c.jsx)(t.code,{children:`1`}),`. Локализованное `,(0,c.jsx)(t.code,{children:`"1 234,5"`}),` также даёт `,(0,c.jsx)(t.code,{children:`0`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`считать-missing-property-runtime-ошибкой`,children:`Считать missing property runtime-ошибкой`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ctx.value`}),` возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, а `,(0,c.jsx)(t.code,{children:`ctx.num`}),` — `,(0,c.jsx)(t.code,{children:`0`}),`. Поэтому неполный query может silently изменить результат. Проверяйте request dependencies у владельца таблицы.`]}),`
+`,(0,c.jsx)(t.h3,{id:`игнорировать-execution-result`,children:`Игнорировать execution result`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: value отсутствует в error branch.
+// const value = executeTableFormula(args).value;
+
+const result = executeTableFormula(args);
+const value = result.ok ? result.value : 0;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Fallback `,(0,c.jsx)(t.code,{children:`0`}),` в примере — решение consumer-а, а не рекомендация для всех бизнес-сценариев.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-что-validator-не-выполняет-formula`,children:`Ожидать, что validator не выполняет formula`}),`
+`,(0,c.jsx)(t.p,{children:`Он вызывает function на synthetic data. Любой side effect произойдёт уже при открытии/проверке редактора.`}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-что-validation-найдёт-infinity`,children:[`Ожидать, что validation найдёт `,(0,c.jsx)(t.code,{children:`Infinity`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Dependency validator не проверяет returned value. `,(0,c.jsx)(t.code,{children:`compile/execute`}),` проверяют и возвращают `,(0,c.jsx)(t.code,{children:`invalid_result`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`регистрировать-formulas-во-время-render`,children:`Регистрировать formulas во время render`}),`
+`,(0,c.jsx)(t.p,{children:`Это глобальная application configuration. Настраивайте её до render и compile runtime.`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-async-formula`,children:[`Использовать `,(0,c.jsx)(t.code,{children:`async`}),` formula`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Promise не является конечным number и даст `,(0,c.jsx)(t.code,{children:`invalid_result`}),`; сохранённый context также не рассчитан на чтение после `,(0,c.jsx)(t.code,{children:`await`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`хранить-function-в-json`,children:`Хранить function в JSON`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сохраняйте только `,(0,c.jsx)(t.code,{children:`formulaId`}),` и dependency ids. Function определяется доверенным application bundle.`]}),`
+`,(0,c.jsx)(t.h3,{id:`путать-table-formula-и-row-based-formatter`,children:`Путать table formula и row-based formatter`}),`
+`,(0,c.jsx)(t.p,{children:`Они используют разные registries, contexts и этапы runtime.`}),`
+`,(0,c.jsx)(t.h2,{id:`api-справка`,children:`API-справка`}),`
+`,(0,c.jsx)(t.h3,{id:`runtime-functions`,children:`Runtime functions`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(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:`createTableFormulaContext`})}),(0,c.jsx)(t.td,{children:`Создать context вручную`}),(0,c.jsxs)(t.td,{children:[`Копирует keys, но не rowData; `,(0,c.jsx)(t.code,{children:`num`}),` использует `,(0,c.jsx)(t.code,{children:`Number`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createTableFormulaRegistry`})}),(0,c.jsx)(t.td,{children:`Собрать нормализованный registry`}),(0,c.jsxs)(t.td,{children:[`Бросает `,(0,c.jsx)(t.code,{children:`Error`}),` для пустого/повторного id`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`configureTableFormulaRegistry`})}),(0,c.jsx)(t.td,{children:`Установить активный registry`}),(0,c.jsx)(t.td,{children:`Полностью заменяет module-level registry`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getTableFormulaList`})}),(0,c.jsx)(t.td,{children:`Получить ordered catalog`}),(0,c.jsx)(t.td,{children:`Возвращает тот же readonly list`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getTableFormulaById`})}),(0,c.jsx)(t.td,{children:`Найти definition`}),(0,c.jsxs)(t.td,{children:[`Trim id; `,(0,c.jsx)(t.code,{children:`undefined`}),` для пустого/неизвестного`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`compileTableFormula`})}),(0,c.jsx)(t.td,{children:`Подготовить reusable executor`}),(0,c.jsx)(t.td,{children:`Фиксирует formula и копирует keys`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`executeTableFormula`})}),(0,c.jsx)(t.td,{children:`Compile + один execute`}),(0,c.jsx)(t.td,{children:`Возвращает controlled result, не бросает formula error`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`validateTableFormulaDependencies`})}),(0,c.jsx)(t.td,{children:`Проверить mapping dependencies`}),(0,c.jsx)(t.td,{children:`Дважды исполняет formula на synthetic data`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`публичные-typescript-типы`,children:`Публичные TypeScript-типы`}),`
+`,(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:`TableFormulaRowData`})}),(0,c.jsxs)(t.td,{children:[`Строка `,(0,c.jsx)(t.code,{children:`Record<string, unknown>`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaContext`})}),(0,c.jsxs)(t.td,{children:[`Методы `,(0,c.jsx)(t.code,{children:`key`}),`, `,(0,c.jsx)(t.code,{children:`value`}),`, `,(0,c.jsx)(t.code,{children:`num`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaFn`})}),(0,c.jsxs)(t.td,{children:[`Синхронная function `,(0,c.jsx)(t.code,{children:`context → number`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaDefinition`})}),(0,c.jsx)(t.td,{children:`Metadata и function одной formula`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaRegistry`})}),(0,c.jsxs)(t.td,{children:[`Readonly `,(0,c.jsx)(t.code,{children:`list`}),` + `,(0,c.jsx)(t.code,{children:`byId`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaExecutionResult`})}),(0,c.jsx)(t.td,{children:`Success/error результат execute`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaCompiledExecutor`})}),(0,c.jsxs)(t.td,{children:[`Переиспользуемый `,(0,c.jsx)(t.code,{children:`(rowData) → result`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaValidationMessage`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`{ code, message }`}),` validation diagnostics`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`TableFormulaDependenciesValidationResult`})}),(0,c.jsx)(t.td,{children:`Errors, warnings и usage dependencies`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ValidationCode`}),`, instrumentation type и compile-result type не экспортируются как именованные публичные типы. Их конкретные значения доступны через публичные function signatures и unions, описанные выше.`]}),`
+`,(0,c.jsx)(t.h3,{id:`причины-execution-error`,children:`Причины execution error`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Reason`}),(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:`formula_not_found`})}),(0,c.jsx)(t.td,{children:`Formula отсутствует в активном registry`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`invalid_result`})}),(0,c.jsx)(t.td,{children:`Function вернула не конечный number`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`runtime_error`})}),(0,c.jsx)(t.td,{children:`Function выбросила исключение`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`validation-codes`,children:`Validation codes`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Code`}),(0,c.jsx)(t.th,{children:`Severity`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formula_not_found`})}),(0,c.jsx)(t.td,{children:`error`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dependency_index_out_of_range`})}),(0,c.jsx)(t.td,{children:`error`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dependency_not_available`})}),(0,c.jsx)(t.td,{children:`error`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unused_dependencies`})}),(0,c.jsx)(t.td,{children:`warning`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formula_does_not_use_dependencies`})}),(0,c.jsx)(t.td,{children:`warning`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formula_runtime_error`})}),(0,c.jsx)(t.td,{children:`warning`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-неизвестная-formula-не-бросает-исключение`,children:`Почему неизвестная formula не бросает исключение?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сохранённая конфигурация может ссылаться на удалённый id. Runtime представляет это как данные `,(0,c.jsx)(t.code,{children:`{ ok: false, reason: "formula_not_found" }`}),`, чтобы owner таблицы выбрал безопасный fallback.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-formula-с-пустыми-keys-успешно-вернула-0`,children:[`Почему formula с пустыми keys успешно вернула `,(0,c.jsx)(t.code,{children:`0`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ctx.num`}),` для отсутствующего index возвращает `,(0,c.jsx)(t.code,{children:`0`}),`. Execution проверяет result, а не полноту dependency mapping. Запускайте validation до compile.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-1-2345-стало-нулём`,children:[`Почему `,(0,c.jsx)(t.code,{children:`"1 234,5"`}),` стало нулём?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ctx.num`}),` использует встроенный `,(0,c.jsx)(t.code,{children:`Number`}),`, который не понимает такую локализованную запись. Читайте `,(0,c.jsx)(t.code,{children:`ctx.value`}),` и применяйте согласованный parser, если ваш transport действительно возвращает этот формат.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-добавить-пользовательский-formula-text-из-бд`,children:`Можно ли добавить пользовательский formula text из БД?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Модуль намеренно исполняет только functions, заранее включённые разработчиком в registry. Для пользовательского expression language нужен отдельный безопасный parser, grammar, validation и execution policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`нужно-ли-компилировать-каждую-строку`,children:`Нужно ли компилировать каждую строку?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Компилируйте один раз для комбинации formula id + ordered keys и переиспользуйте executor для строк.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-менять-registry-после-компиляции`,children:`Можно ли менять registry после компиляции?`}),`
+`,(0,c.jsx)(t.p,{children:`Можно технически, но существующие executors сохранят старую function, а новые получат новую. В приложении избегайте смешанного состояния: установите registry один раз при bootstrap.`}),`
+`,(0,c.jsx)(t.h2,{id:`связанная-документация`,children:`Связанная документация`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../../README.md`,children:`Обзор пакета`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../formatters/pipeline/README.mdx`,children:`Formatter pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../formatters/rowBased/README.mdx`,children:`Row-based formatter`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../formatters/number/README.mdx`,children:`Числовые formatter-ы`})}),`
+`]})]})}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};