@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.8

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

@@ -0,0 +1,876 @@
+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/Binary`}),`
+`,(0,c.jsxs)(t.h1,{id:`работа-с-бинарными-данными-через-ryuzaki13react-foundation-libbinary`,children:[`Работа с бинарными данными через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`binary`}),` преобразует строковое бинарное содержимое в браузерный `,(0,c.jsx)(t.code,{children:`Blob`}),`, определяет предполагаемый MIME-тип документа и предоставляет React hook для типового сценария «base64 → `,(0,c.jsx)(t.code,{children:`{ blob, mime }`}),`».`]}),`
+`,(0,c.jsx)(t.p,{children:`Основной сценарий:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`backend возвращает содержимое файла строкой base64;`}),`
+`,(0,c.jsx)(t.li,{children:`приложение определяет MIME-тип по имени файла, data URL или сигнатуре данных;`}),`
+`,(0,c.jsx)(t.li,{children:`base64 декодируется в байты;`}),`
+`,(0,c.jsxs)(t.li,{children:[`из байтов создаётся `,(0,c.jsx)(t.code,{children:`Blob`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывающий код передаёт `,(0,c.jsx)(t.code,{children:`Blob`}),` просмотрщику, скачивает файл или отправляет его дальше.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль является предметно-независимым foundation-слоем. Он не знает бизнес-коды документов, не выполняет HTTP/OData-запросы, не загружает файлы с диска, не создаёт viewer и не проверяет, безопасно ли содержимое.`}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия, все публичные функции, точный приоритет MIME, поддерживаемые форматы, ошибки, React lifecycle, безопасность и управление object URL.`}),`
+`,(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-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F`,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-api`,children:`Как выбрать API`})}),`
+`,(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%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5-%D0%B2%D1%85%D0%BE%D0%B4%D0%BD%D1%8B%D0%B5-%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D1%8B`,children:`Поддерживаемые входные форматы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#binarytoblob`,children:(0,c.jsx)(t.code,{children:`binaryToBlob`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#detectmimetype`,children:(0,c.jsx)(t.code,{children:`detectMimeType`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#usebinaryfile`,children:(0,c.jsx)(t.code,{children:`useBinaryFile`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8B%D0%BC-blob`,children:[`Работа с готовым `,(0,c.jsx)(t.code,{children:`Blob`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8B%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%B4%D0%B8%D0%B0%D0%B3%D0%BD%D0%BE%D1%81%D1%82%D0%B8%D0%BA%D0%B0`,children:`Ошибки и диагностика`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%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:`#%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-%D0%B8-%D0%BF%D0%B0%D0%BC%D1%8F%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%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-api`,children:`Краткий справочник API`})}),`
+`,(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.jsxs)(t.h3,{id:`что-делает-binary`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`binary`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`принимает base64, base64 data URL или raw binary string;`}),`
+`,(0,c.jsx)(t.li,{children:`нормализует пробелы, URL-safe алфавит и отсутствующий base64 padding;`}),`
+`,(0,c.jsxs)(t.li,{children:[`создаёт `,(0,c.jsx)(t.code,{children:`Blob`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`предполагает MIME по имени файла, объявлению data URL или небольшой сигнатуре;`}),`
+`,(0,c.jsx)(t.li,{children:`предоставляет React hook для base64-данных.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-модуль-не-делает`,children:`Чего модуль не делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не отправляет запросы и не получает данные с backend;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не читает пользовательский `,(0,c.jsx)(t.code,{children:`File`}),` через `,(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не скачивает `,(0,c.jsx)(t.code,{children:`Blob`}),` автоматически;`]}),`
+`,(0,c.jsx)(t.li,{children:`не создаёт и не освобождает object URL;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет полную проверку формата файла;`}),`
+`,(0,c.jsx)(t.li,{children:`не сканирует файл на вредоносное содержимое;`}),`
+`,(0,c.jsx)(t.li,{children:`не преобразует обычный Unicode-текст в UTF-8;`}),`
+`,(0,c.jsx)(t.li,{children:`не распаковывает ZIP, DOCX, XLSX или другие контейнеры;`}),`
+`,(0,c.jsx)(t.li,{children:`не исправляет ошибочный MIME из внешнего источника.`}),`
+`]}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Декодировать строковый base64/data URL в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Прочитать выбранный пользователем `,(0,c.jsx)(t.code,{children:`File`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/file`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скачать готовый `,(0,c.jsx)(t.code,{children:`Blob`}),` или object URL`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/dom`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Преобразовать base64 непосредственно в `,(0,c.jsx)(t.code,{children:`Blob`}),` без MIME-detection`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Полностью проверить структуру PDF, изображения или архива`}),(0,c.jsx)(t.td,{children:`Специализированный parser/validator на доверенной boundary`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не копируйте логику скачивания рядом с `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),`. Для готового `,(0,c.jsx)(t.code,{children:`Blob`}),` уже существует `,(0,c.jsx)(t.code,{children:`downloadFileFromBlob`}),` в `,(0,c.jsx)(t.code,{children:`/dom`}),`.`]}),`
+`,(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:[`Импортируйте API только из опубликованного subpath `,(0,c.jsx)(t.code,{children:`/binary`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { binaryToBlob, detectMimeType, useBinaryFile } from "@ryuzaki13/react-foundation-lib/binary";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { binaryToBlob } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { binaryToBlob } from "@ryuzaki13/react-foundation-lib/binary";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`react-peer-зависимость`,children:`React peer-зависимость`}),`
+`,(0,c.jsxs)(t.p,{children:[`Entrypoint `,(0,c.jsx)(t.code,{children:`/binary`}),` экспортирует `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),` и поэтому загружает React API. В текущем контракте пакета consumer должен предоставить совместимый React peer `,(0,c.jsx)(t.code,{children:`>=19.2.0 <20.0.0`}),`, даже если конкретный файл импортирует только `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` или `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для React-приложения зависимость обычно уже установлена:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install react react-dom
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не подключайте отдельную вторую копию React ради этого модуля. Версия должна согласовываться с React host-приложения.`}),`
+`,(0,c.jsx)(t.h3,{id:`runtime`,children:`Runtime`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль ориентирован на браузер и использует:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`atob`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Blob`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Uint8Array`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`React 19 hooks для `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`В тестовой или серверной среде эти Web APIs могут отсутствовать либо вести себя иначе. Наличие похожих globals в конкретной версии Node.js не превращает browser contract в гарантированный server API.`}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`байт`,children:`Байт`}),`
+`,(0,c.jsxs)(t.p,{children:[`Байт — целое число от `,(0,c.jsx)(t.code,{children:`0`}),` до `,(0,c.jsx)(t.code,{children:`255`}),`. Файл на низком уровне является последовательностью байтов.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Например, ASCII-строка `,(0,c.jsx)(t.code,{children:`"ABC"`}),` представлена байтами:`]}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`A`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`65`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`B`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`66`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`C`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:(0,c.jsx)(t.code,{children:`67`})})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`бинарные-данные`,children:`Бинарные данные`}),`
+`,(0,c.jsx)(t.p,{children:`Бинарные данные — произвольные байты файла: PDF, изображения, архивы, офисные документы и так далее. Не каждый набор байтов является корректным текстом.`}),`
+`,(0,c.jsx)(t.h3,{id:`base64`,children:`Base64`}),`
+`,(0,c.jsx)(t.p,{children:`Base64 кодирует байты ограниченным набором печатных символов:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`ABCDEFGHIJKLMNOPQRSTUVWXYZ
+abcdefghijklmnopqrstuvwxyz
+0123456789
++/
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`байты текста "Hello" → SGVsbG8=
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Base64 не шифрует данные и не делает их безопасными. Любой, кто получил строку, может декодировать содержимое.`}),`
+`,(0,c.jsxs)(t.h3,{id:`padding-`,children:[`Padding `,(0,c.jsx)(t.code,{children:`=`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`В конце стандартного base64 могут находиться один или два символа `,(0,c.jsx)(t.code,{children:`=`}),`. Они дополняют длину строки до блока из четырёх символов.`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль умеет добавить отсутствующий padding:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`SGVsbG8   → SGVsbG8=
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Строка, длина которой после нормализации даёт остаток `,(0,c.jsx)(t.code,{children:`1`}),` при делении на `,(0,c.jsx)(t.code,{children:`4`}),`, не может быть корректно дополнена и отклоняется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`url-safe-base64`,children:`URL-safe base64`}),`
+`,(0,c.jsx)(t.p,{children:`URL-safe вариант заменяет:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`+`}),` на `,(0,c.jsx)(t.code,{children:`-`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/`}),` на `,(0,c.jsx)(t.code,{children:`_`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль возвращает эти символы в стандартный base64-алфавит перед декодированием.`}),`
+`,(0,c.jsx)(t.h3,{id:`data-url`,children:`Data URL`}),`
+`,(0,c.jsx)(t.p,{children:`Data URL содержит metadata и данные в одной строке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`data:application/pdf;base64,JVBERi0xLjc...
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Структура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`data:<MIME>;base64,<payload>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль поддерживает только base64 data URL с обязательным маркером `,(0,c.jsx)(t.code,{children:`;base64,`}),`. Обычный percent-encoded data URL вида `,(0,c.jsx)(t.code,{children:`data:text/plain,Hello%20world`}),` не поддерживается.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mime-тип`,children:`MIME-тип`}),`
+`,(0,c.jsx)(t.p,{children:`MIME сообщает, как интерпретировать содержимое:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`MIME`}),(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:`application/pdf`})}),(0,c.jsx)(t.td,{children:`PDF`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/png`})}),(0,c.jsx)(t.td,{children:`PNG`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text/plain`})}),(0,c.jsx)(t.td,{children:`Обычный текст`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/zip`})}),(0,c.jsx)(t.td,{children:`ZIP`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/octet-stream`})}),(0,c.jsx)(t.td,{children:`Неопределённые бинарные данные`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`MIME — metadata, а не доказательство реального формата. Строка может заявлять `,(0,c.jsx)(t.code,{children:`image/png`}),`, хотя внутри находится другой файл.`]}),`
+`,(0,c.jsx)(t.h3,{id:`blob`,children:(0,c.jsx)(t.code,{children:`Blob`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Blob`}),` — браузерный объект, который хранит последовательность байтов и MIME:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = new Blob([new Uint8Array([65, 66, 67])], { type: "text/plain" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`У `,(0,c.jsx)(t.code,{children:`Blob`}),` есть:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.type`}),` — MIME;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.size`}),` — размер в байтах;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.text()`}),` — прочитать как текст;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.arrayBuffer()`}),` — получить байты.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`object-url`,children:`Object URL`}),`
+`,(0,c.jsxs)(t.p,{children:[`Object URL — временная браузерная ссылка на `,(0,c.jsx)(t.code,{children:`Blob`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const objectUrl = URL.createObjectURL(blob);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Она похожа на:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`blob:https://example.test/...
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Object URL не содержит base64 и не является data URL. После использования его нужно освободить:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`URL.revokeObjectURL(objectUrl);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сам `,(0,c.jsx)(t.code,{children:`Blob`}),` не требует ручного `,(0,c.jsx)(t.code,{children:`revoke`}),`; освобождать нужно созданные через `,(0,c.jsx)(t.code,{children:`URL.createObjectURL`}),` URL.`]}),`
+`,(0,c.jsx)(t.h3,{id:`raw-binary-string`,children:`Raw binary string`}),`
+`,(0,c.jsx)(t.p,{children:`Raw binary string — JavaScript-строка, в которой код каждого символа рассматривается как один байт.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const raw = String.fromCharCode(65, 66, 67);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это не обычная Unicode-строка и не UTF-8. Режим нужен только для legacy API, которые уже вернули байты в такой форме.`}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-api`,children:`Как выбрать API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Нужно`}),(0,c.jsx)(t.th,{children:`Использовать`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Превратить base64 в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binaryToBlob`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Превратить base64 data URL в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binaryToBlob`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Превратить raw binary string в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binaryToBlob(..., ..., false)`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Предположить MIME по имени и данным`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`detectMimeType`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`В React получить `,(0,c.jsx)(t.code,{children:`{ blob, mime }`}),` из base64 prop/state`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useBinaryFile`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скачать готовый `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`downloadFileFromBlob`}),` из `,(0,c.jsx)(t.code,{children:`/dom`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Прочитать пользовательский `,(0,c.jsx)(t.code,{children:`File`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`readFile`}),` или `,(0,c.jsx)(t.code,{children:`readImageFile`}),` из `,(0,c.jsx)(t.code,{children:`/file`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Использовать известные filename и MIME`}),(0,c.jsxs)(t.td,{children:[`Вызвать `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`/`,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` вручную`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Полностью проверить файл`}),(0,c.jsxs)(t.td,{children:[`Специализированный validator, не `,(0,c.jsx)(t.code,{children:`detectMimeType`})]})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`base64-и-имя-файла`,children:`Base64 и имя файла`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { binaryToBlob, detectMimeType } from "@ryuzaki13/react-foundation-lib/binary";
+import { downloadFileFromBlob } from "@ryuzaki13/react-foundation-lib/dom";
+
+type BackendFile = {
+	fileName: string;
+	fileContent: string;
+};
+
+function downloadBackendFile(file: BackendFile) {
+	const mime = detectMimeType(file.fileName, file.fileContent);
+	const blob = binaryToBlob(file.fileContent, mime);
+
+	downloadFileFromBlob(file.fileName, blob);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`base64-data-url`,children:`Base64 data URL`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:text/plain;base64,SGVsbG8=";
+
+const mime = detectMimeType(undefined, dataUrl);
+const blob = binaryToBlob(dataUrl, mime);
+
+console.log(mime); // "text/plain"
+console.log(blob.type); // "text/plain"
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важно: `,(0,c.jsx)(t.code,{children:`binaryToBlob(dataUrl)`}),` самостоятельно не возьмёт MIME из data URL. Без второго аргумента `,(0,c.jsx)(t.code,{children:`blob.type`}),` будет `,(0,c.jsx)(t.code,{children:`application/octet-stream`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`общий-поток`,children:`Общий поток`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`fileName ───────────────────────┐
+                               ├─> detectMimeType ─> MIME ─┐
+base64 / base64 data URL ──────┘                           │
+                                                          ├─> Blob
+base64 / base64 data URL ─────────> binaryToBlob ─────────┘
+                                                             │
+                                                             ├─> viewer
+                                                             ├─> download
+                                                             └─> FormData
+`})}),`
+`,(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.jsx)(t.th,{children:`Пример/комментарий`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Стандартный base64`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SGVsbG8=`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Base64 без padding`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`SGVsbG8`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Base64 с пробелами и переносами`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:`Пробельные символы удаляются`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`URL-safe base64`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`-`}),` и `,(0,c.jsx)(t.code,{children:`_`}),` заменяются на `,(0,c.jsx)(t.code,{children:`+`}),` и `,(0,c.jsx)(t.code,{children:`/`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Base64 data URL`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`data:image/png;base64,...`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Data URL с параметрами`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`data:text/plain;charset=utf-8;base64,...`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Data URL без MIME`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`data:;base64,...`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Raw binary string`}),(0,c.jsxs)(t.td,{children:[`Да, только с `,(0,c.jsx)(t.code,{children:`isBase64 = false`})]}),(0,c.jsx)(t.td,{children:`Каждый JS-символ превращается в один байт`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Обычная Unicode-строка`}),(0,c.jsx)(t.td,{children:`Нет как raw binary`}),(0,c.jsx)(t.td,{children:`Это не UTF-8 encoder`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Percent-encoded data URL`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`data:text/plain,Hello%20world`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Hex-строка`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`25504446`}),` не трактуется как байты PDF`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Uint8Array`})}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsxs)(t.td,{children:[`API принимает `,(0,c.jsx)(t.code,{children:`string`}),`; создайте `,(0,c.jsx)(t.code,{children:`Blob`}),` напрямую`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ArrayBuffer`})}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsxs)(t.td,{children:[`API принимает `,(0,c.jsx)(t.code,{children:`string`}),`; создайте `,(0,c.jsx)(t.code,{children:`Blob`}),` напрямую`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Пустая строка`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Выбрасывается ошибка`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`binarytoblob`,children:(0,c.jsx)(t.code,{children:`binaryToBlob`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function binaryToBlob(binaryData: string, mimeType?: string, isBase64?: boolean): Blob;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Фактические значения по умолчанию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`mimeType = "application/octet-stream";
+isBase64 = true;
+`})}),`
+`,(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.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:`binaryData`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`Обязательный`}),(0,c.jsx)(t.td,{children:`Base64/data URL или raw binary string`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`mimeType`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/octet-stream`})}),(0,c.jsxs)(t.td,{children:[`MIME создаваемого `,(0,c.jsx)(t.code,{children:`Blob`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isBase64`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})}),(0,c.jsx)(t.td,{children:`Декодировать base64 или читать коды символов как байты`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`результат`,children:`Результат`}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращается новый непустой `,(0,c.jsx)(t.code,{children:`Blob`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("SGVsbG8=", "text/plain");
+
+console.log(blob.size); // 5
+console.log(blob.type); // "text/plain"
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция синхронная. Методы чтения самого `,(0,c.jsx)(t.code,{children:`Blob`}),`, например `,(0,c.jsx)(t.code,{children:`text()`}),` и `,(0,c.jsx)(t.code,{children:`arrayBuffer()`}),`, возвращают `,(0,c.jsx)(t.code,{children:`Promise`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-происходит-в-base64-режиме`,children:`Что происходит в base64-режиме`}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`isBase64 = true`}),` функция:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`проверяет, не является ли строка base64 data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`для data URL отделяет payload после запятой;`}),`
+`,(0,c.jsx)(t.li,{children:`удаляет все пробельные символы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`заменяет URL-safe `,(0,c.jsx)(t.code,{children:`-`}),` и `,(0,c.jsx)(t.code,{children:`_`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`проверяет допустимый алфавит и padding;`}),`
+`,(0,c.jsx)(t.li,{children:`добавляет отсутствующий padding;`}),`
+`,(0,c.jsxs)(t.li,{children:[`декодирует строку браузерным `,(0,c.jsx)(t.code,{children:`atob`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`переносит коды полученной binary string в `,(0,c.jsx)(t.code,{children:`Uint8Array`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`копирует байты в отдельный `,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаёт `,(0,c.jsx)(t.code,{children:`Blob`}),` с переданным MIME.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`обычный-base64`,children:`Обычный base64`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("SGVsbG8=", "text/plain");
+
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`пробелы-и-переносы-строк`,children:`Пробелы и переносы строк`}),`
+`,(0,c.jsx)(t.p,{children:`Пробельные символы удаляются во всей base64-строке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("SGVs\\n bG8=\\t", "text/plain");
+
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это удобно для MIME-wrapped base64, но не исправляет данные, в которых символ `,(0,c.jsx)(t.code,{children:`+`}),` был случайно заменён пробелом при URL/form-декодировании. В таком случае байт будет потерян.`]}),`
+`,(0,c.jsx)(t.h3,{id:`отсутствующий-padding`,children:`Отсутствующий padding`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("SGVsbG8", "text/plain");
+
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`url-safe-base64-1`,children:`URL-safe base64`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("__8", "application/octet-stream");
+
+const bytes = new Uint8Array(await blob.arrayBuffer());
+
+console.log([...bytes]); // [255, 255]
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`data-url-1`,children:`Data URL`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:text/plain;base64,SGVsbG8=";
+
+const blob = binaryToBlob(dataUrl, "text/plain");
+
+console.log(await blob.text()); // "Hello"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживается data URL с дополнительными параметрами:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:text/plain;charset=utf-8;base64,SGVsbG8=";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Распознавание префикса выполняется без учёта регистра для `,(0,c.jsx)(t.code,{children:`data:`}),` и `,(0,c.jsx)(t.code,{children:`base64`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mime-data-url-не-применяется-автоматически`,children:`MIME data URL не применяется автоматически`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` отделяет payload data URL, но намеренно использует только аргумент `,(0,c.jsx)(t.code,{children:`mimeType`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:image/png;base64,iVBORw0KGgo=";
+
+const blob = binaryToBlob(dataUrl);
+
+console.log(blob.type);
+// "application/octet-stream"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для использования MIME из data URL сначала вызовите `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mime = detectMimeType(undefined, dataUrl);
+const blob = binaryToBlob(dataUrl, mime);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`пустой-mime`,children:`Пустой MIME`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`, пустая строка или строка только из пробелов приводят к `,(0,c.jsx)(t.code,{children:`application/octet-stream`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`binaryToBlob("SGVsbG8=", undefined).type;
+// "application/octet-stream"
+
+binaryToBlob("SGVsbG8=", "").type;
+// "application/octet-stream"
+
+binaryToBlob("SGVsbG8=", "   ").type;
+// "application/octet-stream"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Непустой MIME передаётся в конструктор `,(0,c.jsx)(t.code,{children:`Blob`}),` после `,(0,c.jsx)(t.code,{children:`trim()`}),`. Окончательная нормализация `,(0,c.jsx)(t.code,{children:`blob.type`}),` выполняется браузерной реализацией `,(0,c.jsx)(t.code,{children:`Blob`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`raw-binary-string-1`,children:`Raw binary string`}),`
+`,(0,c.jsx)(t.p,{children:`Чтобы отключить base64-декодирование:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob("ABC", "application/octet-stream", false);
+
+const bytes = new Uint8Array(await blob.arrayBuffer());
+
+console.log([...bytes]); // [65, 66, 67]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый UTF-16 code unit строки записывается в `,(0,c.jsx)(t.code,{children:`Uint8Array`}),`. Значения больше `,(0,c.jsx)(t.code,{children:`255`}),` обрезаются до младшего байта.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому обычный Unicode-текст нельзя передавать как raw binary:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно для UTF-8.
+binaryToBlob("Привет", "text/plain", false);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для текста используйте `,(0,c.jsx)(t.code,{children:`TextEncoder`}),` и создайте `,(0,c.jsx)(t.code,{children:`Blob`}),` напрямую:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const bytes = new TextEncoder().encode("Привет");
+const blob = new Blob([bytes], { type: "text/plain;charset=utf-8" });
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`функция-не-выполняет-mime-detection`,children:`Функция не выполняет MIME-detection`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob(pdfBase64);
+
+console.log(blob.type);
+// "application/octet-stream", даже если внутри PDF.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если MIME неизвестен:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mime = detectMimeType(fileName, pdfBase64);
+const blob = binaryToBlob(pdfBase64, mime);
+`})}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`binaryData === ""`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Не переданы бинарные данные`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`После удаления префикса/пробелов payload пуст`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`После преобразования не осталось данных`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Недопустимый base64-символ`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Некорректный формат base64`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Длина base64 имеет невозможный остаток`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Некорректный формат base64`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`atob`}),` отклонил редкий синтаксически прошедший вариант`]}),(0,c.jsxs)(t.td,{children:[`Сообщение browser `,(0,c.jsx)(t.code,{children:`DOMException`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Низкоуровневый API выбросил не-`,(0,c.jsx)(t.code,{children:`Error`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Некорректный формат бинарных данных`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Пример обработки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`try {
+	const blob = binaryToBlob(payload, "application/pdf");
+
+	showDocument(blob);
+} catch (error) {
+	const message = error instanceof Error ? error.message : "Не удалось декодировать файл";
+
+	showError(message);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не включайте исходную base64-строку в сообщение, лог или error report: она может содержать персональные или конфиденциальные данные.`}),`
+`,(0,c.jsx)(t.h2,{id:`detectmimetype`,children:(0,c.jsx)(t.code,{children:`detectMimeType`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-1`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function detectMimeType(fileName?: string, binaryData?: string): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция всегда возвращает строку и не выбрасывает ошибку для неизвестного либо некорректного base64. Если MIME определить не удалось, возвращается `,(0,c.jsx)(t.code,{children:`application/pdf`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`приоритет-источников`,children:`Приоритет источников`}),`
+`,(0,c.jsx)(t.p,{children:`Проверки выполняются строго в таком порядке:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{style:{textAlign:`right`},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,{style:{textAlign:`right`},children:`1`}),(0,c.jsxs)(t.td,{children:[`Расширение `,(0,c.jsx)(t.code,{children:`fileName`})]}),(0,c.jsx)(t.td,{children:`Расширение известно таблице`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`MIME из base64 data URL`}),(0,c.jsx)(t.td,{children:`Filename не дал известный MIME`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`3`}),(0,c.jsx)(t.td,{children:`Сигнатура декодированных данных`}),(0,c.jsx)(t.td,{children:`Data URL не объявил непустой MIME`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`4`}),(0,c.jsx)(t.td,{children:`Fallback PDF`}),(0,c.jsx)(t.td,{children:`Ничего не распознано`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Первый успешный источник побеждает. Функция не сравнивает источники между собой.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const pngDataUrl = "data:image/png;base64,iVBORw0KGgo=";
+
+detectMimeType("report.pdf", pngDataUrl);
+// "application/pdf": расширение filename имеет приоритет.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`mime-по-расширению-файла`,children:`MIME по расширению файла`}),`
+`,(0,c.jsx)(t.p,{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:`MIME`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`bmp`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/bmp`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`csv`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text/csv`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`doc`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/msword`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`docx`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.openxmlformats-officedocument.wordprocessingml.document`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`gif`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/gif`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`jpeg`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/jpeg`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`jpg`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/jpeg`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`json`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/json`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pdf`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/pdf`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`png`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/png`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ppt`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.ms-powerpoint`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pptx`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.openxmlformats-officedocument.presentationml.presentation`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`svg`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/svg+xml`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`tif`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/tiff`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`tiff`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/tiff`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`txt`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text/plain`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`webp`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/webp`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`xls`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.ms-excel`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`xlsx`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`xml`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/xml`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`zip`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/zip`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`detectMimeType("report.xlsx");
+// "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
+
+detectMimeType("PHOTO.JPG");
+// "image/jpeg"
+
+detectMimeType("archive.backup.zip");
+// "application/zip"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Filename не очищается от query/hash и пробелов:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`detectMimeType("photo.jpg?download=1");
+// "application/pdf", если binaryData не передан.
+
+detectMimeType("photo.jpg ");
+// "application/pdf", если binaryData не передан.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте именно имя файла, а не URL. Если есть URL, сначала безопасно извлеките pathname/filename на соответствующей boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`mime-из-data-url`,children:`MIME из data URL`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:image/png;base64,iVBORw0KGgo=";
+
+detectMimeType(undefined, dataUrl);
+// "image/png"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для параметров используется только часть до первого `,(0,c.jsx)(t.code,{children:`;`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:text/plain;charset=utf-8;base64,SGVsbG8=";
+
+detectMimeType(undefined, dataUrl);
+// "text/plain"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если MIME пуст:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataUrl = "data:;base64,JVBERi0xLjc=";
+
+detectMimeType(undefined, dataUrl);
+// Проверка продолжится по сигнатуре.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Объявленный MIME возвращается без декодирования и проверки payload:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`detectMimeType(undefined, "data:image/png;base64,not-valid-base64");
+// "image/png"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому data URL MIME нельзя считать доказательством формата.`}),`
+`,(0,c.jsx)(t.h3,{id:`mime-по-сигнатуре`,children:`MIME по сигнатуре`}),`
+`,(0,c.jsx)(t.p,{children:`Если filename и data URL не дали тип, функция пытается декодировать начало base64. Ошибка декодирования скрывается, после чего используется fallback.`}),`
+`,(0,c.jsx)(t.p,{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.jsxs)(t.td,{children:[`bytes `,(0,c.jsx)(t.code,{children:`25 50 44 46`}),` (`,(0,c.jsx)(t.code,{children:`%PDF`}),`)`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/pdf`})}),(0,c.jsx)(t.td,{children:`Проверяются только первые четыре байта`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`bytes `,(0,c.jsx)(t.code,{children:`FF D8 FF`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/jpeg`})}),(0,c.jsx)(t.td,{children:`Проверяются только первые три байта`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`bytes `,(0,c.jsx)(t.code,{children:`89 50 4E 47`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/png`})}),(0,c.jsx)(t.td,{children:`Полная восьмибайтовая PNG signature не проверяется`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`текст `,(0,c.jsx)(t.code,{children:`GIF`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/gif`})}),(0,c.jsxs)(t.td,{children:[`Версия `,(0,c.jsx)(t.code,{children:`87a/89a`}),` не проверяется`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`текст `,(0,c.jsx)(t.code,{children:`RIFF`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/webp`})}),(0,c.jsxs)(t.td,{children:[`Маркер `,(0,c.jsx)(t.code,{children:`WEBP`}),` дальше в header не проверяется`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`bytes `,(0,c.jsx)(t.code,{children:`50 4B`}),` (`,(0,c.jsx)(t.code,{children:`PK`}),`)`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/zip`})}),(0,c.jsx)(t.td,{children:`OOXML-файлы без filename тоже выглядят как ZIP`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`первый непустой текст начинается с `,(0,c.jsx)(t.code,{children:`<?xml`}),` или `,(0,c.jsx)(t.code,{children:`<`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/xml`})}),(0,c.jsx)(t.td,{children:`HTML и SVG тоже могут попасть в эту ветку`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Примеры:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`detectMimeType(undefined, pdfBase64);
+// "application/pdf"
+
+detectMimeType(undefined, jpegBase64);
+// "image/jpeg"
+
+detectMimeType(undefined, zipBase64);
+// "application/zip"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`DOCX, XLSX и PPTX являются ZIP-контейнерами. Без имени файла они обычно определятся как `,(0,c.jsx)(t.code,{children:`application/zip`}),`, а не как конкретный Office MIME.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Любое RIFF-содержимое соответствует текущей короткой проверке и может быть ошибочно определено как `,(0,c.jsx)(t.code,{children:`image/webp`}),`. Например, WAV/AVI без filename не должны доверять этому результату.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Текст, начинающийся после пробелов с `,(0,c.jsx)(t.code,{children:`<`}),`, считается XML-подобным. Это эвристика, а не XML parser.`]}),`
+`,(0,c.jsx)(t.h3,{id:`fallback`,children:`Fallback`}),`
+`,(0,c.jsx)(t.p,{children:`Если ничего не распознано:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`detectMimeType();
+// "application/pdf"
+
+detectMimeType(undefined, "не base64");
+// "application/pdf"
+
+detectMimeType("unknown.bin");
+// "application/pdf"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Fallback PDF является осознанным предметно-независимым default текущего контракта, оптимизированным под документные сценарии пакета. Это не означает, что неизвестные данные действительно являются PDF.`}),`
+`,(0,c.jsx)(t.p,{children:`Если вызывающий код не может принимать такое предположение, он должен:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`требовать известный MIME от backend;`}),`
+`,(0,c.jsx)(t.li,{children:`валидировать формат специализированным parser;`}),`
+`,(0,c.jsx)(t.li,{children:`или применять собственный fallback после отдельной проверки.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`detectmimetype-не-является-validator`,children:[(0,c.jsx)(t.code,{children:`detectMimeType`}),` не является validator`]}),`
+`,(0,c.jsx)(t.p,{children:`Функция отвечает только на вопрос «какой MIME предположить». Она не отвечает на вопросы:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`полностью ли корректен файл;`}),`
+`,(0,c.jsx)(t.li,{children:`соответствует ли содержимое расширению;`}),`
+`,(0,c.jsx)(t.li,{children:`безопасно ли показывать файл;`}),`
+`,(0,c.jsx)(t.li,{children:`не повреждён ли архив;`}),`
+`,(0,c.jsx)(t.li,{children:`разрешён ли тип бизнес-правилами;`}),`
+`,(0,c.jsx)(t.li,{children:`можно ли доверять MIME из внешнего источника.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`usebinaryfile`,children:(0,c.jsx)(t.code,{children:`useBinaryFile`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-2`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function useBinaryFile(bin: string | undefined): {
+	data: {
+		blob: Blob;
+		mime: string;
+	} | null;
+	error: string | null;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Hook принимает только base64/base64 data URL. Он всегда вызывает:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mime = detectMimeType(undefined, bin);
+const blob = binaryToBlob(bin, mime, true);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Filename передать нельзя, raw binary mode использовать нельзя.`}),`
+`,(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:`data`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ blob, mime }`})}),(0,c.jsx)(t.td,{children:`Декодирование завершилось успешно`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`data`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:`Нет результата либо произошла ошибка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`error`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`Строковое представление ошибки`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`error`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})}),(0,c.jsx)(t.td,{children:`Ошибки нет`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`lifecycle`,children:`Lifecycle`}),`
+`,(0,c.jsx)(t.p,{children:`Преобразование выполняется после commit в React effect:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`первый render возвращает `,(0,c.jsx)(t.code,{children:`{ data: null, error: null }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`после commit effect обрабатывает `,(0,c.jsx)(t.code,{children:`bin`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`успех записывает `,(0,c.jsx)(t.code,{children:`{ blob, mime }`}),` и очищает ошибку;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`ошибка очищает `,(0,c.jsx)(t.code,{children:`data`}),` и записывает `,(0,c.jsx)(t.code,{children:`String(error)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),` или пустая строка очищают оба поля.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{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.code,{children:`bin`})}),(0,c.jsx)(t.th,{children:`Состояние после effect`})]})}),(0,c.jsxs)(t.tbody,{children:[(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:`{ data: null, error: null }`})})]}),(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:`{ data: null, error: null }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Корректный base64 PDF`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ data: { blob, mime: "application/pdf" }, error: null }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Некорректный base64`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ data: null, error: "Error: ..." }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Строка из пробелов`}),(0,c.jsx)(t.td,{children:`Ошибка после удаления пробелов`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`У hook нет отдельного `,(0,c.jsx)(t.code,{children:`isLoading`}),`/`,(0,c.jsx)(t.code,{children:`isProcessing`}),`. На первом render `,(0,c.jsx)(t.code,{children:`data: null`}),` и `,(0,c.jsx)(t.code,{children:`error: null`}),` может означать как отсутствие входа, так и ещё не выполненный effect.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`смена-bin`,children:[`Смена `,(0,c.jsx)(t.code,{children:`bin`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`При смене одного непустого `,(0,c.jsx)(t.code,{children:`bin`}),` на другой предыдущие `,(0,c.jsx)(t.code,{children:`data`}),`/`,(0,c.jsx)(t.code,{children:`error`}),` могут оставаться видимыми до выполнения следующего effect. Hook не очищает состояние синхронно во время render.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если нельзя кратковременно показать предыдущий документ:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`разместите hook в компоненте, который remount-ится по стабильному ID документа;`}),`
+`,(0,c.jsx)(t.li,{children:`или выполните преобразование на явной границе загрузки;`}),`
+`,(0,c.jsx)(t.li,{children:`или добавьте внешний state machine с identity результата.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте саму большую base64-строку как React `,(0,c.jsx)(t.code,{children:`key`}),`. Используйте безопасный стабильный ID документа:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<BinaryDocument key={document.id} bin={document.content} />
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`определение-mime-внутри-hook`,children:`Определение MIME внутри hook`}),`
+`,(0,c.jsx)(t.p,{children:`Hook не знает filename. Приоритет будет таким:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`MIME из data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`сигнатура;`}),`
+`,(0,c.jsxs)(t.li,{children:[`fallback `,(0,c.jsx)(t.code,{children:`application/pdf`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычный base64 текста без data URL и известной сигнатуры станет `,(0,c.jsx)(t.code,{children:`Blob`}),` с `,(0,c.jsx)(t.code,{children:`application/pdf`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const { data } = useBinaryFile("SGVsbG8=");
+
+// После effect:
+// data?.mime === "application/pdf"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если известны имя или MIME, вызывайте `,(0,c.jsx)(t.code,{children:`detectMimeType`}),` и `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` вручную.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-и-logging`,children:`Ошибки и logging`}),`
+`,(0,c.jsx)(t.p,{children:`При ошибке hook:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`вызывает внутренний `,(0,c.jsx)(t.code,{children:`logError(error)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`logError`}),` пишет ошибку в `,(0,c.jsx)(t.code,{children:`console.error`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`error: String(error)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`очищает `,(0,c.jsx)(t.code,{children:`data`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обычного `,(0,c.jsx)(t.code,{children:`Error`}),` строка включает имя:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Error: Некорректный формат base64
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не сравнивайте `,(0,c.jsx)(t.code,{children:`error`}),` с точным текстом browser `,(0,c.jsx)(t.code,{children:`DOMException`}),`: сообщение низкоуровневого `,(0,c.jsx)(t.code,{children:`atob`}),` может отличаться между средами.`]}),`
+`,(0,c.jsx)(t.h3,{id:`базовое-использование`,children:`Базовое использование`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useBinaryFile } from "@ryuzaki13/react-foundation-lib/binary";
+
+type BinaryDocumentProps = {
+	readonly bin: string | undefined;
+};
+
+export function BinaryDocument(props: BinaryDocumentProps) {
+	const { data, error } = useBinaryFile(props.bin);
+
+	if (error) {
+		return <p role="alert">Не удалось подготовить документ</p>;
+	}
+
+	if (!props.bin) {
+		return <p>Документ не передан</p>;
+	}
+
+	if (!data) {
+		return <p>Подготовка документа…</p>;
+	}
+
+	return <DocumentViewer blob={data.blob} mime={data.mime} />;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DocumentViewer`}),` в примере — компонент host-приложения. Пакет `,(0,c.jsx)(t.code,{children:`binary`}),` его не предоставляет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`hook-не-создаёт-object-url`,children:`Hook не создаёт object URL`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Blob`}),` можно передать компоненту, который принимает его напрямую. Если viewer требует строковый URL, вызывающий компонент отвечает за создание и cleanup.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Корректная синхронизация с `,(0,c.jsx)(t.code,{children:`iframe`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useEffect, useRef } from "react";
+
+type BlobFrameProps = {
+	readonly blob: Blob;
+	readonly title: string;
+};
+
+export function BlobFrame(props: BlobFrameProps) {
+	const frameRef = useRef<HTMLIFrameElement>(null);
+
+	useEffect(() => {
+		const frame = frameRef.current;
+
+		if (!frame) return;
+
+		const objectUrl = URL.createObjectURL(props.blob);
+
+		frame.src = objectUrl;
+
+		return () => {
+			frame.removeAttribute("src");
+			URL.revokeObjectURL(objectUrl);
+		};
+	}, [props.blob]);
+
+	return <iframe ref={frameRef} title={props.title} />;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Effect синхронизирует React с внешним browser API и симметрично освобождает URL. Такой cleanup устойчив к повторному setup/cleanup в React Strict Mode.`}),`
+`,(0,c.jsx)(t.h3,{id:`когда-hook-не-подходит`,children:`Когда hook не подходит`}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),`, если:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`код выполняется вне React;`}),`
+`,(0,c.jsx)(t.li,{children:`MIME уже известен и не равен PDF fallback;`}),`
+`,(0,c.jsx)(t.li,{children:`нужно учитывать filename;`}),`
+`,(0,c.jsx)(t.li,{children:`данные являются raw binary string;`}),`
+`,(0,c.jsx)(t.li,{children:`результат нужен немедленно в event handler;`}),`
+`,(0,c.jsx)(t.li,{children:`нужен явный processing/error state machine;`}),`
+`,(0,c.jsx)(t.li,{children:`преобразование большого payload нужно вынести с main thread.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`работа-с-готовым-blob`,children:[`Работа с готовым `,(0,c.jsx)(t.code,{children:`Blob`})]}),`
+`,(0,c.jsx)(t.h3,{id:`скачать-файл`,children:`Скачать файл`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`/dom`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { downloadFileFromBlob } from "@ryuzaki13/react-foundation-lib/dom";
+
+downloadFileFromBlob(fileName, blob);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Helper создаёт object URL, запускает скачивание и освобождает URL.`}),`
+`,(0,c.jsx)(t.h3,{id:`передать-в-viewer`,children:`Передать в viewer`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если viewer принимает `,(0,c.jsx)(t.code,{children:`Blob`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<DocumentViewer blob={blob} mime={blob.type} />
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если viewer принимает URL, создайте object URL на его lifecycle boundary и обязательно выполните cleanup.`}),`
+`,(0,c.jsx)(t.h3,{id:`прочитать-байты`,children:`Прочитать байты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const buffer = await blob.arrayBuffer();
+const bytes = new Uint8Array(buffer);
+
+console.log(bytes.length);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`прочитать-текст`,children:`Прочитать текст`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const text = await blob.text();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`blob.text()`}),` декодирует данные как текст. Для PDF, ZIP и изображений результат не имеет полезного смысла.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`отправить-через-formdata`,children:[`Отправить через `,(0,c.jsx)(t.code,{children:`FormData`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const formData = new FormData();
+
+formData.append("file", blob, fileName);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Transport, authentication и обработка ответа не принадлежат модулю `,(0,c.jsx)(t.code,{children:`binary`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`object-url-cleanup`,children:`Object URL cleanup`}),`
+`,(0,c.jsx)(t.p,{children:`Неправильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const src = URL.createObjectURL(blob);
+image.src = src;
+
+// URL никогда не освобождается.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const src = URL.createObjectURL(blob);
+image.src = src;
+
+// Когда URL больше не нужен:
+image.removeAttribute("src");
+URL.revokeObjectURL(src);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не вызывайте `,(0,c.jsx)(t.code,{children:`revokeObjectURL`}),` до того, как consumer закончил использовать URL.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовые-рецепты`,children:`Готовые рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`скачать-backend-файл-с-известным-именем`,children:`Скачать backend-файл с известным именем`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { binaryToBlob, detectMimeType } from "@ryuzaki13/react-foundation-lib/binary";
+import { downloadFileFromBlob } from "@ryuzaki13/react-foundation-lib/dom";
+
+function downloadFile(fileName: string, fileContent: string) {
+	const mime = detectMimeType(fileName, fileContent);
+	const blob = binaryToBlob(fileContent, mime);
+
+	downloadFileFromBlob(fileName, blob);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`создать-pdf-blob-при-известном-контракте-backend`,children:`Создать PDF Blob при известном контракте backend`}),`
+`,(0,c.jsx)(t.p,{children:`Если backend-контракт гарантирует PDF, detection не нужен:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob(fileContent, "application/pdf");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это надёжнее эвристики, если MIME гарантирован и проверяется владельцем transport/domain boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`обработать-data-url`,children:`Обработать data URL`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function dataUrlToBlob(dataUrl: string) {
+	const mime = detectMimeType(undefined, dataUrl);
+
+	return binaryToBlob(dataUrl, mime);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`обработать-url-safe-base64`,children:`Обработать URL-safe base64`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob(urlSafePayload, "application/octet-stream");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Дополнительных замен в consumer-коде не требуется.`}),`
+`,(0,c.jsx)(t.h3,{id:`обработать-raw-binary-string`,children:`Обработать raw binary string`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob(rawBinaryString, "application/pdf", false);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте только когда upstream явно гарантирует raw binary string.`}),`
+`,(0,c.jsx)(t.h3,{id:`показать-base64-документ-в-react`,children:`Показать base64-документ в React`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function DocumentPanel(props: { readonly documentId: string; readonly base64: string | undefined }) {
+	return <BinaryDocument key={props.documentId} bin={props.base64} />;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`отладочно-проверить-первые-байты`,children:`Отладочно проверить первые байты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = binaryToBlob(payload, "application/octet-stream");
+const bytes = new Uint8Array(await blob.arrayBuffer());
+
+console.log([...bytes.slice(0, 8)]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не оставляйте logging бинарного содержимого в production-коде.`}),`
+`,(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-ts`,children:`binaryToBlob("");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Решение: различайте отсутствие payload и корректное содержимое до вызова функции.`}),`
+`,(0,c.jsx)(t.h3,{id:`после-преобразования-не-осталось-данных`,children:`«После преобразования не осталось данных»`}),`
+`,(0,c.jsx)(t.p,{children:`Причины:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`data URL имеет пустой payload;`}),`
+`,(0,c.jsx)(t.li,{children:`base64 состоит только из пробелов;`}),`
+`,(0,c.jsx)(t.li,{children:`после удаления whitespace не осталось символов.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`binaryToBlob("data:text/plain;base64,");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`некорректный-формат-base64`,children:`«Некорректный формат base64»`}),`
+`,(0,c.jsx)(t.p,{children:`Причины:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`присутствуют недопустимые символы;`}),`
+`,(0,c.jsx)(t.li,{children:`строка имеет невозможную длину;`}),`
+`,(0,c.jsx)(t.li,{children:`передан обычный текст вместо base64;`}),`
+`,(0,c.jsx)(t.li,{children:`передан percent-encoded data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`payload был повреждён transport-слоем.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`binaryToBlob("not valid *");
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`base64-из-queryform-потерял-`,children:[`Base64 из query/form потерял `,(0,c.jsx)(t.code,{children:`+`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`application/x-www-form-urlencoded`}),` символ `,(0,c.jsx)(t.code,{children:`+`}),` может интерпретироваться как пробел. Модуль удалит пробел и не сможет восстановить потерянный байт.`]}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте base64:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`в JSON body;`}),`
+`,(0,c.jsx)(t.li,{children:`как URL-safe base64;`}),`
+`,(0,c.jsx)(t.li,{children:`или с корректным percent-encoding.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`blobtype-равен-applicationoctet-stream`,children:[(0,c.jsx)(t.code,{children:`Blob.type`}),` равен `,(0,c.jsx)(t.code,{children:`application/octet-stream`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Причина: `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` не выполняет detection и не использует MIME data URL автоматически.`]}),`
+`,(0,c.jsx)(t.p,{children:`Решение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mime = detectMimeType(fileName, payload);
+const blob = binaryToBlob(payload, mime);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`hook-определил-текст-как-pdf`,children:`Hook определил текст как PDF`}),`
+`,(0,c.jsxs)(t.p,{children:[`Причина: `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),` не получает filename, сигнатура текста неизвестна, поэтому применяется PDF fallback.`]}),`
+`,(0,c.jsx)(t.p,{children:`Решения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`передать data URL с MIME;`}),`
+`,(0,c.jsx)(t.li,{children:`вызвать функции вручную с известным MIME;`}),`
+`,(0,c.jsx)(t.li,{children:`не использовать hook для этого контракта.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`mime-не-совпал-с-содержимым`,children:`MIME не совпал с содержимым`}),`
+`,(0,c.jsx)(t.p,{children:`Проверьте приоритет:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`filename;`}),`
+`,(0,c.jsx)(t.li,{children:`data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`signature;`}),`
+`,(0,c.jsx)(t.li,{children:`PDF fallback.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Известное расширение filename всегда выигрывает, даже если данные заявляют другой тип.`}),`
+`,(0,c.jsx)(t.h3,{id:`data-url-не-распознан`,children:`Data URL не распознан`}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживается форма:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`data:<mime>[;parameters];base64,<payload>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`data:<mime>,<percent-encoded-payload>
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`ошибка-появляется-в-consoleerror`,children:[`Ошибка появляется в `,(0,c.jsx)(t.code,{children:`console.error`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это текущее поведение `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),`: hook логирует пойманную ошибку перед записью `,(0,c.jsx)(t.code,{children:`error`}),` state. Для ручного `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` logging не выполняется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`object-url-перестал-работать`,children:`Object URL перестал работать`}),`
+`,(0,c.jsx)(t.p,{children:`Проверьте, что:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`URL не был освобождён слишком рано;`}),`
+`,(0,c.jsx)(t.li,{children:`cleanup старого URL не затронул новый URL;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Blob`}),` ещё соответствует текущему документу;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`browser CSP/viewer разрешает `,(0,c.jsx)(t.code,{children:`blob:`}),` source.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`безопасность`,children:`Безопасность`}),`
+`,(0,c.jsx)(t.h3,{id:`mime-нельзя-использовать-как-проверку-безопасности`,children:`MIME нельзя использовать как проверку безопасности`}),`
+`,(0,c.jsx)(t.p,{children:`Следующие источники контролируемы внешними данными:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`filename;`}),`
+`,(0,c.jsx)(t.li,{children:`MIME data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`первые байты payload.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`detectMimeType`}),` не гарантирует, что файл безопасен или соответствует типу.`]}),`
+`,(0,c.jsx)(t.h3,{id:`активное-содержимое`,children:`Активное содержимое`}),`
+`,(0,c.jsx)(t.p,{children:`SVG, HTML, XML и некоторые PDF могут содержать активные или внешние ссылки. Не вставляйте непроверенное содержимое напрямую в DOM.`}),`
+`,(0,c.jsx)(t.p,{children:`Для недоверенных файлов:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`используйте безопасный viewer;`}),`
+`,(0,c.jsx)(t.li,{children:`учитывайте sandbox/CSP;`}),`
+`,(0,c.jsx)(t.li,{children:`запрещайте опасные типы на доверенной server boundary;`}),`
+`,(0,c.jsx)(t.li,{children:`не полагайтесь только на расширение;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняйте содержимое как script/module.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`ограничивайте-размер`,children:`Ограничивайте размер`}),`
+`,(0,c.jsx)(t.p,{children:`Перед декодированием проверяйте допустимый размер ответа на transport/domain boundary. Base64 и несколько промежуточных копий могут значительно увеличить потребление памяти.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-логируйте-payload`,children:`Не логируйте payload`}),`
+`,(0,c.jsx)(t.p,{children:`Base64 может содержать:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`персональные данные;`}),`
+`,(0,c.jsx)(t.li,{children:`договоры и документы;`}),`
+`,(0,c.jsx)(t.li,{children:`изображения;`}),`
+`,(0,c.jsx)(t.li,{children:`токены, если upstream ошибочно включил их;`}),`
+`,(0,c.jsx)(t.li,{children:`другие чувствительные сведения.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`В diagnostics передавайте безопасные metadata: источник, ожидаемый тип, размер строки и технический код ошибки — без самого содержимого.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-доверяйте-filename`,children:`Не доверяйте filename`}),`
+`,(0,c.jsx)(t.p,{children:`Filename может содержать нежелательные символы или обманное расширение. Санитизация имени и бизнес-политика разрешённых форматов принадлежат boundary, которая принимает внешний файл.`}),`
+`,(0,c.jsx)(t.h2,{id:`производительность-и-память`,children:`Производительность и память`}),`
+`,(0,c.jsx)(t.h3,{id:`синхронное-декодирование`,children:`Синхронное декодирование`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` синхронно:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`нормализует всю строку;`}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`atob`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаёт `,(0,c.jsx)(t.code,{children:`Uint8Array`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаёт отдельный `,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаёт `,(0,c.jsx)(t.code,{children:`Blob`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Большой payload может заблокировать main thread и временно существовать в нескольких представлениях одновременно.`}),`
+`,(0,c.jsx)(t.h3,{id:`base64-больше-исходных-байтов`,children:`Base64 больше исходных байтов`}),`
+`,(0,c.jsx)(t.p,{children:`Base64 обычно примерно на треть больше исходного binary payload, не считая префикса data URL и JavaScript string storage.`}),`
+`,(0,c.jsxs)(t.h3,{id:`detectmimetype-декодирует-только-начало`,children:[(0,c.jsx)(t.code,{children:`detectMimeType`}),` декодирует только начало`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Signature detection декодирует ограниченное начало base64, поэтому дешевле полного декодирования. При этом распознавание data URL выполняется регулярным выражением над входной строкой и может просканировать весь payload. Последующий `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` в любом случае обрабатывает полный payload.`]}),`
+`,(0,c.jsx)(t.h3,{id:`рекомендации`,children:`Рекомендации`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ограничивайте размер на backend и transport boundary;`}),`
+`,(0,c.jsx)(t.li,{children:`не декодируйте один payload несколько раз без причины;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не храните одновременно много больших base64-строк и `,(0,c.jsx)(t.code,{children:`Blob`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`освобождайте object URL;`}),`
+`,(0,c.jsx)(t.li,{children:`для действительно больших файлов предпочитайте streaming/download endpoint;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняйте тяжёлое декодирование каждого render;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не используйте `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),` как cache больших backend-файлов.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`сложность`,children:`Сложность`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для payload длины `,(0,c.jsx)(t.code,{children:`n`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`время `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` — `,(0,c.jsx)(t.code,{children:`O(n)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`дополнительная память — `,(0,c.jsx)(t.code,{children:`O(n)`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`detectMimeType`}),` — `,(0,c.jsx)(t.code,{children:`O(n)`}),` в худшем случае из-за разбора data URL, хотя для signature декодируется только ограниченный header.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`тесты-consumer-кода`,children:`Тесты consumer-кода`}),`
+`,(0,c.jsx)(t.p,{children:`Проверяйте:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.type`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`blob.size`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`текст для текстового fixture;`}),`
+`,(0,c.jsxs)(t.li,{children:[`байты через `,(0,c.jsx)(t.code,{children:`arrayBuffer()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`ожидаемые ошибки;`}),`
+`,(0,c.jsx)(t.li,{children:`cleanup object URL в UI boundary.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+
+import { binaryToBlob, detectMimeType } from "@ryuzaki13/react-foundation-lib/binary";
+
+describe("binary document", () => {
+	it("создаёт текстовый Blob", async () => {
+		const blob = binaryToBlob("SGVsbG8=", "text/plain");
+
+		expect(blob.type).toBe("text/plain");
+		expect(await blob.text()).toBe("Hello");
+	});
+
+	it("определяет PDF по имени", () => {
+		expect(detectMimeType("report.pdf")).toBe("application/pdf");
+	});
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Тестовая среда должна предоставлять `,(0,c.jsx)(t.code,{children:`Blob`}),`, `,(0,c.jsx)(t.code,{children:`atob`}),` и при UI-тестах React DOM. В пакете pure-функции проверяются в `,(0,c.jsx)(t.code,{children:`jsdom`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`узкий-тест-пакета`,children:`Узкий тест пакета`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm run test -- src/binary/binaryToBlob.test.ts
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`краткий-справочник-api`,children:`Краткий справочник API`}),`
+`,(0,c.jsx)(t.p,{children:`Полный импорт:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { binaryToBlob, detectMimeType, useBinaryFile } from "@ryuzaki13/react-foundation-lib/binary";
+`})}),`
+`,(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:`binaryToBlob`})}),(0,c.jsx)(t.td,{children:`Строка, MIME, base64/raw флаг`}),(0,c.jsxs)(t.td,{children:[`Непустой `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsxs)(t.td,{children:[`Выбрасывает `,(0,c.jsx)(t.code,{children:`Error`}),`/browser decode error`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`detectMimeType`})}),(0,c.jsx)(t.td,{children:`Filename и/или base64/data URL`}),(0,c.jsx)(t.td,{children:`MIME string`}),(0,c.jsx)(t.td,{children:`Не выбрасывает; fallback PDF`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useBinaryFile`})}),(0,c.jsxs)(t.td,{children:[`Base64/data URL или `,(0,c.jsx)(t.code,{children:`undefined`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ data, error }`})}),(0,c.jsx)(t.td,{children:`Логирует и возвращает строку ошибки`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`defaults`,children:`Defaults`}),`
+`,(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:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` MIME`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/octet-stream`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` input mode`]}),(0,c.jsx)(t.td,{children:`base64`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`detectMimeType`}),` fallback`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/pdf`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useBinaryFile`}),` initial `,(0,c.jsx)(t.code,{children:`data`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useBinaryFile`}),` initial `,(0,c.jsx)(t.code,{children:`error`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useBinaryFile`}),` raw binary support`]}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Автоматическое создание object URL`}),(0,c.jsx)(t.td,{children:`Нет`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsx)(t.h3,{id:`base64--это-шифрование`,children:`Base64 — это шифрование?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Это текстовое кодирование байтов. Оно не обеспечивает секретность, целостность или подлинность.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-binarytoblob-не-определяет-mime-сам`,children:[`Почему `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` не определяет MIME сам?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Преобразование байтов и выбор MIME являются разными ответственностями. Вызывающий код может знать MIME точнее любой эвристики. Для предположения существует отдельная `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-fallback-у-binarytoblob-и-detectmimetype-разный`,children:[`Почему fallback у `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` и `,(0,c.jsx)(t.code,{children:`detectMimeType`}),` разный?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` без информации создаёт нейтральный `,(0,c.jsx)(t.code,{children:`application/octet-stream`}),`. `,(0,c.jsx)(t.code,{children:`detectMimeType`}),` ориентирован на документный контур и возвращает `,(0,c.jsx)(t.code,{children:`application/pdf`}),`, если эвристики не сработали.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-mime-data-url-не-попал-в-blob`,children:[`Почему MIME data URL не попал в `,(0,c.jsx)(t.code,{children:`Blob`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`binaryToBlob`}),` использует data URL только для извлечения base64 payload. Передайте MIME вторым аргументом:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mime = detectMimeType(undefined, dataUrl);
+const blob = binaryToBlob(dataUrl, mime);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`почему-docx-определился-как-zip`,children:`Почему DOCX определился как ZIP?`}),`
+`,(0,c.jsxs)(t.p,{children:[`DOCX, XLSX и PPTX технически являются ZIP-контейнерами. Без filename короткая signature видит только `,(0,c.jsx)(t.code,{children:`PK`}),`. Передавайте корректное имя или известный MIME.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-неизвестный-файл-определился-как-pdf`,children:`Почему неизвестный файл определился как PDF?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Это fallback `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`. Он не доказывает, что файл является PDF.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-передать-uint8array`,children:[`Можно ли передать `,(0,c.jsx)(t.code,{children:`Uint8Array`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет, публичный API принимает строку. Для готовых байтов создайте `,(0,c.jsx)(t.code,{children:`Blob`}),` напрямую:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const blob = new Blob([bytes], { type: mime });
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-передать-обычный-текст`,children:`Можно ли передать обычный текст?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если текст уже корректно закодирован в base64 — да. Raw mode не является UTF-8 encoder. Для обычного Unicode-текста используйте `,(0,c.jsx)(t.code,{children:`TextEncoder`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-вручную-освобождать-blob`,children:[`Нужно ли вручную освобождать `,(0,c.jsx)(t.code,{children:`Blob`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Нужно освобождать object URL, созданный через `,(0,c.jsx)(t.code,{children:`URL.createObjectURL(blob)`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`создаёт-ли-usebinaryfile-object-url`,children:[`Создаёт ли `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),` object URL?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Hook возвращает только `,(0,c.jsx)(t.code,{children:`Blob`}),` и MIME.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-использовать-usebinaryfile-вне-react-компонента`,children:[`Можно ли использовать `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),` вне React-компонента?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Это React hook, к нему применяются Rules of Hooks. Для обычной функции используйте `,(0,c.jsx)(t.code,{children:`binaryToBlob`}),` и `,(0,c.jsx)(t.code,{children:`detectMimeType`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-entrypoint-требует-react-если-нужна-только-pure-функция`,children:`Почему entrypoint требует React, если нужна только pure-функция?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущий `,(0,c.jsx)(t.code,{children:`/binary`}),` entrypoint также экспортирует `,(0,c.jsx)(t.code,{children:`useBinaryFile`}),`, а собранный ESM-модуль импортирует React. Поэтому React должен быть доступен при разрешении entrypoint.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`валидирует-ли-detectmimetype-файл`,children:[`Валидирует ли `,(0,c.jsx)(t.code,{children:`detectMimeType`}),` файл?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Это только эвристический выбор MIME.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-результат-для-проверки-разрешённого-типа`,children:`Можно ли использовать результат для проверки разрешённого типа?`}),`
+`,(0,c.jsx)(t.p,{children:`Не как единственную проверку. Политику разрешённых форматов и проверку недоверенного содержимого выполняйте на доверенной boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-выбрать-data-url-или-object-url`,children:`Что выбрать: data URL или object URL?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Data URL содержит данные внутри строки и часто приходит извне. Object URL является временной ссылкой браузера на уже созданный `,(0,c.jsx)(t.code,{children:`Blob`}),`. Для отображения большого `,(0,c.jsx)(t.code,{children:`Blob`}),` обычно удобнее object URL с обязательным cleanup.`]})]})}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};