@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.8

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

@@ -0,0 +1,334 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-C5-IVaAZ.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-Dx5UE11l.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/Boolean`}),`
+`,(0,c.jsxs)(t.h1,{id:`boolean-и-abap-boolean-через-ryuzaki13react-foundation-libformatters`,children:[`Boolean и ABAP boolean через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Подмодуль `,(0,c.jsx)(t.code,{children:`boolean`}),` преобразует значения между JavaScript `,(0,c.jsx)(t.code,{children:`boolean`}),` и двухсимвольным ABAP-контрактом:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"X"`}),` — истина;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`один обычный пробел `,(0,c.jsx)(t.code,{children:`" "`}),` — ложь.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Также он предоставляет более широкий parser `,(0,c.jsx)(t.code,{children:`parseBoolean`}),` для простых пользовательских или transport-значений.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`README рассчитан на разработчика без доступа к исходному коду. Ниже описано точное, местами неочевидное поведение всех трёх публичных функций. Особенно важно не путать строгий `,(0,c.jsx)(t.code,{children:`parseAbapBoolean`}),`, расширенный `,(0,c.jsx)(t.code,{children:`parseBoolean`}),` и truthy-семантику `,(0,c.jsx)(t.code,{children:`toAbapBoolean`}),`.`]}),`
+`,(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%BC%D0%B8%D0%BD%D0%B8%D0%BC%D0%B0%D0%BB%D1%8C%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%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8E`,children:`Как выбрать функцию`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#parseabapboolean`,children:(0,c.jsx)(t.code,{children:`parseAbapBoolean`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#parseboolean`,children:(0,c.jsx)(t.code,{children:`parseBoolean`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#toabapboolean`,children:(0,c.jsx)(t.code,{children:`toAbapBoolean`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%B0%D0%BA%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5-%D1%80%D0%B5%D1%86%D0%B5%D0%BF%D1%82%D1%8B`,children:`Практические рецепты`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-%D0%B8-%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F`,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%BA%D1%80%D0%B0%D1%82%D0%BA%D0%B8%D0%B9-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA`,children:`Краткий справочник`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B-%D0%B8-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%8B`,children:`Вопросы и ответы`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.h3,{id:`что-делает-подмодуль`,children:`Что делает подмодуль`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`строго читает ABAP boolean `,(0,c.jsx)(t.code,{children:`"X"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`распознаёт небольшой набор строковых true-значений;`}),`
+`,(0,c.jsx)(t.li,{children:`применяет стандартную JavaScript truthy/falsy-семантику к нестроковым значениям;`}),`
+`,(0,c.jsxs)(t.li,{children:[`формирует `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),`, то есть `,(0,c.jsx)(t.code,{children:`"X" | " "`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-подмодуль-не-делает`,children:`Чего подмодуль не делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`не нормализует пробелы через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не принимает `,(0,c.jsx)(t.code,{children:`"да"`}),`, `,(0,c.jsx)(t.code,{children:`"нет"`}),`, `,(0,c.jsx)(t.code,{children:`"yes"`}),`, `,(0,c.jsx)(t.code,{children:`"no"`}),`, `,(0,c.jsx)(t.code,{children:`"on"`}),`, `,(0,c.jsx)(t.code,{children:`"off"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не валидирует внешний DTO целиком;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не сообщает, почему значение было интерпретировано как `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не отличает отсутствующее значение от явно переданного `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не сериализует JSON, URL или OData query;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не гарантирует, что широкий `,(0,c.jsx)(t.code,{children:`toAbapBoolean(unknown)`}),` подходит конкретному backend-контракту.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.p,{children:`Установите пакет:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Все boolean helpers импортируются из единственного опубликованного subpath `,(0,c.jsx)(t.code,{children:`/formatters`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { parseAbapBoolean, parseBoolean, toAbapBoolean } from "@ryuzaki13/react-foundation-lib/formatters";
+
+import type { AbapBoolean } from "@ryuzaki13/react-foundation-lib/types";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Отдельного package export `,(0,c.jsx)(t.code,{children:`/formatters/boolean`}),` нет:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { parseAbapBoolean } from "@ryuzaki13/react-foundation-lib/formatters/boolean";
+
+// Правильно.
+import { parseAbapBoolean } from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функции не зависят от React, DOM или browser API и могут выполняться в browser, Node.js и worker runtime.`}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`javascript-boolean`,children:`JavaScript boolean`}),`
+`,(0,c.jsxs)(t.p,{children:[`Тип `,(0,c.jsx)(t.code,{children:`boolean`}),` имеет только два значения:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const enabled: boolean = true;
+const disabled: boolean = false;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Строки `,(0,c.jsx)(t.code,{children:`"true"`}),` и `,(0,c.jsx)(t.code,{children:`"false"`}),` не являются boolean:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`typeof true; // "boolean"
+typeof "true"; // "string"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`truthy-и-falsy`,children:`Truthy и falsy`}),`
+`,(0,c.jsx)(t.p,{children:`JavaScript умеет приводить произвольное значение к boolean:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`Boolean(1); // true
+Boolean(0); // false
+Boolean("text"); // true
+Boolean(""); // false
+Boolean({}); // true
+Boolean([]); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Основные falsy-значения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`0`}),` и `,(0,c.jsx)(t.code,{children:`-0`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`0n`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`пустая строка `,(0,c.jsx)(t.code,{children:`""`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Почти всё остальное truthy. В частности, строки `,(0,c.jsx)(t.code,{children:`"false"`}),`, `,(0,c.jsx)(t.code,{children:`"0 "`}),`, объекты и массивы truthy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`abap-boolean`,children:`ABAP boolean`}),`
+`,(0,c.jsx)(t.p,{children:`Публичный тип пакета:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type AbapBoolean = "X" | " ";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ложь представлена не пустой строкой, а ровно одним пробелом. Это важно при сравнении, логировании и сериализации:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const value: AbapBoolean = " ";
+
+console.log(value.length); // 1
+console.log(value === ""); // false
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`unknown`,children:(0,c.jsx)(t.code,{children:`unknown`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Все три функции принимают `,(0,c.jsx)(t.code,{children:`unknown`}),`. Это означает, что caller может передать любое runtime-значение, а функция сама выберет ветку обработки.`]}),`
+`,(0,c.jsx)(t.p,{children:`Широкий вход удобен на transport boundary, но не превращает функцию в строгий validator. Если нужно отклонять неизвестные значения, сначала реализуйте явную validation policy.`}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-функцию`,children:`Как выбрать функцию`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Задача`}),(0,c.jsx)(t.th,{children:`Функция`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Прочитать точное backend-значение `,(0,c.jsx)(t.code,{children:`"X"`}),`/`,(0,c.jsx)(t.code,{children:`" "`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseAbapBoolean`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Прочитать `,(0,c.jsx)(t.code,{children:`true`}),`, `,(0,c.jsx)(t.code,{children:`"true"`}),`, `,(0,c.jsx)(t.code,{children:`"X"`}),`, `,(0,c.jsx)(t.code,{children:`"x"`}),`, `,(0,c.jsx)(t.code,{children:`1`}),`, `,(0,c.jsx)(t.code,{children:`"1"`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseBoolean`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Записать JavaScript boolean в ABAP `,(0,c.jsx)(t.code,{children:`"X"`}),`/`,(0,c.jsx)(t.code,{children:`" "`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toAbapBoolean`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Для DTO с известным ABAP-контрактом предпочтительная пара:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const enabled = parseAbapBoolean(dto.ENABLED);
+const payload = { ENABLED: toAbapBoolean(enabled) };
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не заменяйте строгий parser на `,(0,c.jsx)(t.code,{children:`parseBoolean`}),` без осознанного расширения контракта: lowercase `,(0,c.jsx)(t.code,{children:`"x"`}),` строгий parser отвергает, а расширенный принимает.`]}),`
+`,(0,c.jsx)(t.h2,{id:`parseabapboolean`,children:(0,c.jsx)(t.code,{children:`parseAbapBoolean`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseAbapBoolean(value: unknown): boolean;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает `,(0,c.jsx)(t.code,{children:`true`}),` только для строки, которая в точности равна uppercase `,(0,c.jsx)(t.code,{children:`"X"`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseAbapBoolean("X"); // true
+parseAbapBoolean(" "); // false
+`})}),`
+`,(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:`Результат`}),(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:`"X"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`точное допустимое значение`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"x"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`регистр отличается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`" X "`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsxs)(t.td,{children:[`функция не вызывает `,(0,c.jsx)(t.code,{children:`trim()`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"true"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`это не ABAP marker`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"1"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`это не ABAP marker`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`" "`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`ABAP false`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`""`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`пустая строка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsxs)(t.td,{children:[`функция требует строку `,(0,c.jsx)(t.code,{children:`"X"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`1`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsxs)(t.td,{children:[`функция требует строку `,(0,c.jsx)(t.code,{children:`"X"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`любое другое значение даёт false`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})}),(0,c.jsx)(t.td,{children:`любое другое значение даёт false`})]})]})]}),`
+`,(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:[`backend явно прислал `,(0,c.jsx)(t.code,{children:`" "`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`поле отсутствует;`}),`
+`,(0,c.jsxs)(t.li,{children:[`backend прислал ошибочное `,(0,c.jsx)(t.code,{children:`"x"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`backend прислал число;`}),`
+`,(0,c.jsxs)(t.li,{children:[`caller передал `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Во всех случаях результат равен `,(0,c.jsx)(t.code,{children:`false`}),`. Если различие важно, проверьте внешний контракт до вызова:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function assertAbapBoolean(value: unknown): asserts value is AbapBoolean {
+	if (value !== "X" && value !== " ") {
+		throw new TypeError("Ожидалось ABAP boolean: 'X' или один пробел");
+	}
+}
+
+assertAbapBoolean(dto.ENABLED);
+const enabled = parseAbapBoolean(dto.ENABLED);
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`parseboolean`,children:(0,c.jsx)(t.code,{children:`parseBoolean`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-1`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function parseBoolean(value: unknown): boolean;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`любое falsy-значение сразу превращается в `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`строка приводится к lowercase без `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`строка считается истинной только для `,(0,c.jsx)(t.code,{children:`"true"`}),`, `,(0,c.jsx)(t.code,{children:`"x"`}),` или `,(0,c.jsx)(t.code,{children:`"1"`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`нестроковое truthy-значение обрабатывается через `,(0,c.jsx)(t.code,{children:`Boolean(value)`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`строки`,children:`Строки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseBoolean("true"); // true
+parseBoolean("TRUE"); // true
+parseBoolean("X"); // true
+parseBoolean("x"); // true
+parseBoolean("1"); // true
+
+parseBoolean("false"); // false
+parseBoolean("0"); // false
+parseBoolean("yes"); // false
+parseBoolean(" true "); // false: пробелы не обрезаются
+parseBoolean(""); // false
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для строк функция не использует общую truthy-семантику. Например, обычная JavaScript-строка `,(0,c.jsx)(t.code,{children:`"false"`}),` truthy, но `,(0,c.jsx)(t.code,{children:`parseBoolean("false")`}),` специально возвращает `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`нестроковые-значения`,children:`Нестроковые значения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseBoolean(true); // true
+parseBoolean(false); // false
+parseBoolean(1); // true
+parseBoolean(-1); // true
+parseBoolean(0); // false
+parseBoolean({}); // true
+parseBoolean([]); // true
+parseBoolean(null); // false
+parseBoolean(undefined); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Объект и массив не означают логическую истину предметной области. Они лишь truthy по правилам JavaScript. Не передавайте произвольный JSON object, если ожидается строгий boolean scalar.`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-применять`,children:`Когда применять`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parseBoolean`}),` полезен, если входной контракт осознанно допускает несколько представлений:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FeatureFlagInput = boolean | 0 | 1 | "0" | "1" | "true" | "false" | "X" | " ";
+
+function readFeatureFlag(value: FeatureFlagInput): boolean {
+	return parseBoolean(value);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Но обратите внимание: строка `,(0,c.jsx)(t.code,{children:`" "`}),` даст `,(0,c.jsx)(t.code,{children:`false`}),` не потому, что специально распознана как ABAP false, а потому что её нет в списке true-строк.`]}),`
+`,(0,c.jsx)(t.h2,{id:`toabapboolean`,children:(0,c.jsx)(t.code,{children:`toAbapBoolean`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-2`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function toAbapBoolean(value: unknown): AbapBoolean;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм имеет отдельное правило для строк:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`если вход — строка, false означает только точная строка `,(0,c.jsx)(t.code,{children:`"0"`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`любая другая строка превращается в true;`}),`
+`,(0,c.jsx)(t.li,{children:`нестроковое значение проверяется стандартной truthy/falsy-семантикой;`}),`
+`,(0,c.jsxs)(t.li,{children:[`true возвращается как `,(0,c.jsx)(t.code,{children:`"X"`}),`, false — как один пробел `,(0,c.jsx)(t.code,{children:`" "`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`рекомендуемый-вход`,children:`Рекомендуемый вход`}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте настоящий boolean:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toAbapBoolean(true); // "X"
+toAbapBoolean(false); // " "
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это самый понятный и устойчивый сценарий.`}),`
+`,(0,c.jsx)(t.h3,{id:`строки-важная-ловушка`,children:`Строки: важная ловушка`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toAbapBoolean("0"); // " "
+
+toAbapBoolean("1"); // "X"
+toAbapBoolean("false"); // "X"
+toAbapBoolean(""); // "X"
+toAbapBoolean(" "); // "X"
+toAbapBoolean("00"); // "X"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Здесь `,(0,c.jsx)(t.code,{children:`"false"`}),` не парсится как false. Функция проверяет только неравенство строке `,(0,c.jsx)(t.code,{children:`"0"`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если внешний input может содержать текстовые boolean-значения, сначала примените нужный parser:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalized = parseBoolean(rawValue);
+const abapValue = toAbapBoolean(normalized);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результаты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toAbapBoolean(parseBoolean("false")); // " "
+toAbapBoolean(parseBoolean("true")); // "X"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`нестроковые-значения-1`,children:`Нестроковые значения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toAbapBoolean(1); // "X"
+toAbapBoolean(0); // " "
+toAbapBoolean(null); // " "
+toAbapBoolean(undefined); // " "
+toAbapBoolean({}); // "X"
+toAbapBoolean([]); // "X"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для объектов и массивов используется только truthiness. Функция не читает поля объекта и не проверяет длину массива.`}),`
+`,(0,c.jsx)(t.h2,{id:`практические-рецепты`,children:`Практические рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`dto--domain-model`,children:`DTO → domain model`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UserDto = {
+	IS_ACTIVE: "X" | " ";
+};
+
+type User = {
+	isActive: boolean;
+};
+
+function mapUserDto(dto: UserDto): User {
+	return {
+		isActive: parseAbapBoolean(dto.IS_ACTIVE)
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`domain-model--dto`,children:`Domain model → DTO`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type UpdateUserPayload = {
+	IS_ACTIVE: AbapBoolean;
+};
+
+function createUpdateUserPayload(isActive: boolean): UpdateUserPayload {
+	return {
+		IS_ACTIVE: toAbapBoolean(isActive)
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`строгая-проверка-неизвестного-transport-значения`,children:`Строгая проверка неизвестного transport-значения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readRequiredAbapBoolean(value: unknown): boolean {
+	if (value !== "X" && value !== " ") {
+		throw new TypeError("Некорректное ABAP boolean");
+	}
+
+	return parseAbapBoolean(value);
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`form-value-01--abap`,children:[`Form value `,(0,c.jsx)(t.code,{children:`"0"`}),`/`,(0,c.jsx)(t.code,{children:`"1"`}),` → ABAP`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function formValueToAbapBoolean(value: "0" | "1"): AbapBoolean {
+	return toAbapBoolean(value);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это безопасно только потому, что TypeScript contract заранее ограничил две допустимые строки.`}),`
+`,(0,c.jsxs)(t.h3,{id:`form-value-truefalse--abap`,children:[`Form value `,(0,c.jsx)(t.code,{children:`"true"`}),`/`,(0,c.jsx)(t.code,{children:`"false"`}),` → ABAP`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function textBooleanToAbap(value: "true" | "false"): AbapBoolean {
+	return toAbapBoolean(parseBoolean(value));
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Прямой `,(0,c.jsx)(t.code,{children:`toAbapBoolean("false")`}),` дал бы `,(0,c.jsx)(t.code,{children:`"X"`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ошибки-и-ограничения`,children:`Ошибки и ограничения`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функции обычно не бросают исключения: для любого обычного значения они возвращают boolean или `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Но это означает silent coercion:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ошибочная форма не отклоняется;`}),`
+`,(0,c.jsx)(t.li,{children:`неизвестное ABAP-значение превращается в false;`}),`
+`,(0,c.jsx)(t.li,{children:`объект превращается в true в широких функциях;`}),`
+`,(0,c.jsx)(t.li,{children:`внешние пробелы не нормализуются;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`toAbapBoolean("false")`}),` возвращает true marker.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Рекомендации:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`используйте `,(0,c.jsx)(t.code,{children:`parseAbapBoolean`}),` для точного ABAP read;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`передавайте boolean в `,(0,c.jsx)(t.code,{children:`toAbapBoolean`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`валидируйте `,(0,c.jsx)(t.code,{children:`unknown`}),`, если неверное значение должно считаться ошибкой;`]}),`
+`,(0,c.jsx)(t.li,{children:`не стройте бизнес-правило на общей truthy/falsy-семантике;`}),`
+`,(0,c.jsx)(t.li,{children:`не логируйте ABAP false без кавычек: один пробел визуально незаметен.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.p,{children:`Минимальная матрица consumer-теста:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(parseAbapBoolean("X")).toBe(true);
+expect(parseAbapBoolean("x")).toBe(false);
+expect(parseAbapBoolean(" ")).toBe(false);
+
+expect(parseBoolean("true")).toBe(true);
+expect(parseBoolean("X")).toBe(true);
+expect(parseBoolean("0")).toBe(false);
+expect(parseBoolean(" true ")).toBe(false);
+
+expect(toAbapBoolean(true)).toBe("X");
+expect(toAbapBoolean(false)).toBe(" ");
+expect(toAbapBoolean("0")).toBe(" ");
+expect(toAbapBoolean("false")).toBe("X");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если ваш DTO объявляет поле обязательным, отдельно тестируйте runtime validation отсутствующего и неизвестного значения. Успешный `,(0,c.jsx)(t.code,{children:`parseAbapBoolean(undefined) === false`}),` не доказывает корректность DTO.`]}),`
+`,(0,c.jsx)(t.h2,{id:`краткий-справочник`,children:`Краткий справочник`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{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:`parseAbapBoolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsxs)(t.td,{children:[`true только для точного `,(0,c.jsx)(t.code,{children:`"X"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseBoolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsxs)(t.td,{children:[`строки true только `,(0,c.jsx)(t.code,{children:`true`}),`, `,(0,c.jsx)(t.code,{children:`x`}),`, `,(0,c.jsx)(t.code,{children:`1`}),`; иначе truthiness`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toAbapBoolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AbapBoolean`})}),(0,c.jsxs)(t.td,{children:[`строка false только при точном `,(0,c.jsx)(t.code,{children:`"0"`})]})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-parseabapbooleanx-вернул-false`,children:[`Почему `,(0,c.jsx)(t.code,{children:`parseAbapBoolean("x")`}),` вернул false?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`ABAP parser регистрозависим и принимает только uppercase `,(0,c.jsx)(t.code,{children:`"X"`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-parseboolean-true--вернул-false`,children:[`Почему `,(0,c.jsx)(t.code,{children:`parseBoolean(" true ")`}),` вернул false?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция приводит строку к lowercase, но не вызывает `,(0,c.jsx)(t.code,{children:`trim()`}),`. Нормализуйте transport input заранее только если это разрешено его контрактом.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-toabapbooleanfalse-вернул-x`,children:[`Почему `,(0,c.jsx)(t.code,{children:`toAbapBoolean("false")`}),` вернул `,(0,c.jsx)(t.code,{children:`"X"`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для строк функция считает ложью только точное значение `,(0,c.jsx)(t.code,{children:`"0"`}),`. Передайте boolean либо сначала вызовите `,(0,c.jsx)(t.code,{children:`parseBoolean`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-abap-false-выглядит-как-пустота`,children:`Почему ABAP false выглядит как пустота?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Это один обычный пробел. Проверяйте через строгое равенство и показывайте в diagnostics с кавычками или через `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-сделать-round-trip`,children:`Можно ли сделать round trip?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для настоящего `,(0,c.jsx)(t.code,{children:`AbapBoolean`}),` — да:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toAbapBoolean(parseAbapBoolean("X")); // "X"
+toAbapBoolean(parseAbapBoolean(" ")); // " "
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для произвольной строки round trip не определён, потому что parsers и serializer используют разные правила.`}),`
+`,(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:`../strings/README.mdx`,children:`Строковая нормализация`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../pipeline/README.mdx`,children:`Formatter pipeline`})}),`
+`]})]})}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};