@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.8

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

@@ -0,0 +1,1309 @@
+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/File`}),`
+`,(0,c.jsxs)(t.h1,{id:`работа-с-пользовательскими-файлами-через-ryuzaki13react-foundation-libfile`,children:[`Работа с пользовательскими файлами через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/file`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`file`}),` содержит browser helpers для четырёх связанных задач:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`прочитать выбранный пользователем `,(0,c.jsx)(t.code,{children:`File`}),` как data URL или `,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`проверить MIME-тип и размер файла перед чтением;`}),`
+`,(0,c.jsx)(t.li,{children:`прочитать изображение и получить его естественные размеры;`}),`
+`,(0,c.jsxs)(t.li,{children:[`определить MIME по расширению и безопаснее сформировать HTTP-заголовок `,(0,c.jsx)(t.code,{children:`Content-Disposition`}),` с Unicode-именем файла.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль является низкоуровневым foundation-слоем. Он не рисует `,(0,c.jsx)(t.code,{children:`<input type="file">`}),`, не отправляет файл на backend, не показывает preview или progress, не проверяет реальное содержимое файла и не заменяет серверную валидацию.`]}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Поэтому ниже отдельно объясняются базовые понятия JavaScript/TypeScript, точный порядок проверок, структура результатов, все публичные функции и типы, фактические классы ошибок, ограничения безопасности и известные особенности текущей реализации.`}),`
+`,(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:`#runtime-%D0%B8-browser-boundary`,children:`Runtime и browser boundary`})}),`
+`,(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:`#readfile`,children:(0,c.jsx)(t.code,{children:`readFile`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%80%D0%B5%D0%B6%D0%B8%D0%BC-data-url`,children:[`Режим `,(0,c.jsx)(t.code,{children:`data-url`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%80%D0%B5%D0%B6%D0%B8%D0%BC-array-buffer`,children:[`Режим `,(0,c.jsx)(t.code,{children:`array-buffer`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BA%D0%B0-%D1%82%D0%B8%D0%BF%D0%B0-%D0%B8-%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%80%D0%B0`,children:`Проверка типа и размера`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BE%D1%82%D0%BC%D0%B5%D0%BD%D0%B0-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-abortsignal`,children:[`Отмена через `,(0,c.jsx)(t.code,{children:`AbortSignal`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-readfile`,children:[`Ошибки `,(0,c.jsx)(t.code,{children:`readFile`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#readimagefile`,children:(0,c.jsx)(t.code,{children:`readImageFile`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8-readimagefile`,children:[`Ошибки `,(0,c.jsx)(t.code,{children:`readImageFile`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolvemimetypebyextension`,children:(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#helpers-%D0%B4%D0%BB%D1%8F-content-disposition`,children:[`Helpers для `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B8%D0%B7%D0%BA%D0%BE%D1%83%D1%80%D0%BE%D0%B2%D0%BD%D0%B5%D0%B2%D1%8B%D0%B5-helpers`,children:`Низкоуровневые helpers`})}),`
+`,(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%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%B8%D0%B7%D0%B2%D0%B5%D1%81%D1%82%D0%BD%D1%8B%D0%B5-%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:`#%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:`что-делает-file`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`file`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`запускает браузерный `,(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращает строго типизированный результат чтения;`}),`
+`,(0,c.jsxs)(t.li,{children:[`сохраняет исходный объект `,(0,c.jsx)(t.code,{children:`File`}),` в результате;`]}),`
+`,(0,c.jsx)(t.li,{children:`создаёт snapshot основных metadata файла;`}),`
+`,(0,c.jsx)(t.li,{children:`ограничивает допустимые MIME и максимальный размер;`}),`
+`,(0,c.jsxs)(t.li,{children:[`связывает `,(0,c.jsx)(t.code,{children:`AbortSignal`}),` с `,(0,c.jsx)(t.code,{children:`FileReader.abort()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяет, что файл объявлен как `,(0,c.jsx)(t.code,{children:`image/*`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`получает `,(0,c.jsx)(t.code,{children:`naturalWidth`}),` и `,(0,c.jsx)(t.code,{children:`naturalHeight`}),` изображения в режиме data URL;`]}),`
+`,(0,c.jsx)(t.li,{children:`сопоставляет ограниченный список расширений с MIME;`}),`
+`,(0,c.jsxs)(t.li,{children:[`формирует `,(0,c.jsx)(t.code,{children:`Content-Disposition`}),` одновременно с ASCII fallback и UTF-8 `,(0,c.jsx)(t.code,{children:`filename*`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-модуль-не-делает`,children:`Чего модуль не делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не создаёт UI выбора файла;`}),`
+`,(0,c.jsx)(t.li,{children:`не управляет React state;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет HTTP/OData-запрос;`}),`
+`,(0,c.jsx)(t.li,{children:`не загружает файл на сервер;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не скачивает `,(0,c.jsx)(t.code,{children:`Blob`}),` в браузере;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не превращает произвольный base64 в `,(0,c.jsx)(t.code,{children:`Blob`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не читает файл потоково и не сообщает progress;`}),`
+`,(0,c.jsx)(t.li,{children:`не проверяет magic bytes, структуру PDF, ZIP, изображения или документа;`}),`
+`,(0,c.jsx)(t.li,{children:`не обнаруживает вирусы и вредоносное содержимое;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не гарантирует, что `,(0,c.jsx)(t.code,{children:`File.type`}),` соответствует байтам;`]}),`
+`,(0,c.jsx)(t.li,{children:`не сжимает и не изменяет изображение;`}),`
+`,(0,c.jsx)(t.li,{children:`не ограничивает ширину, высоту или количество декодированных пикселей;`}),`
+`,(0,c.jsx)(t.li,{children:`не удаляет потенциально опасное содержимое из SVG;`}),`
+`,(0,c.jsx)(t.li,{children:`не нормализует путь для записи файла на диск;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не создаёт HTTP `,(0,c.jsx)(t.code,{children:`Response`}),` и не устанавливает заголовки автоматически.`]}),`
+`]}),`
+`,(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:[`Прочитать выбранный пользователем `,(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:[`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:`Blob`}),`, JSON или 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.jsx)(t.td,{children:`Скопировать обычный текст в clipboard`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Прочитать файл через готовый React UI`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/input-file`}),` или `,(0,c.jsx)(t.code,{children:`drop-zone`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Выбрать изображение через готовый React UI`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/input-image`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Проверить формат по реальному содержимому`}),(0,c.jsx)(t.td,{children:`Специализированный parser на доверенной boundary`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Выполнить окончательную проверку перед сохранением`}),(0,c.jsx)(t.td,{children:`Backend`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужен только обычный upload через `,(0,c.jsx)(t.code,{children:`multipart/form-data`}),`, браузерный `,(0,c.jsx)(t.code,{children:`File`}),` можно положить в `,(0,c.jsx)(t.code,{children:`FormData`}),` напрямую. Предварительное чтение всего файла через `,(0,c.jsx)(t.code,{children:`readFile`}),` для этого не обязательно.`]}),`
+`,(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:`/file`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createContentDispositionHeader, readFile, readImageFile, resolveMimeTypeByExtension } from "@ryuzaki13/react-foundation-lib/file";
+
+import type { ImageMime, ReadFileOptions, ReadFileResult, ReadImageResult } from "@ryuzaki13/react-foundation-lib/file";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { readFile } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { readFile } from "@ryuzaki13/react-foundation-lib/file";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не импортируйте внутренние файлы `,(0,c.jsx)(t.code,{children:`read-file/readFile`}),` или `,(0,c.jsx)(t.code,{children:`image/readImageFile`}),`. Они не являются отдельными опубликованными entrypoints:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: приватный путь исходников.
+import { readFile } from "@ryuzaki13/react-foundation-lib/src/file/read-file/readFile";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль поставляется как ESM.`}),`
+`,(0,c.jsx)(t.h3,{id:`нужен-ли-react`,children:`Нужен ли React`}),`
+`,(0,c.jsxs)(t.p,{children:[`Сам entrypoint `,(0,c.jsx)(t.code,{children:`/file`}),` не использует React и подходит обычному browser TypeScript/JavaScript-коду. Однако пакет в целом объявляет React peer dependency. В React-приложении она обычно уже предоставлена host-приложением.`]}),`
+`,(0,c.jsx)(t.h2,{id:`runtime-и-browser-boundary`,children:`Runtime и browser boundary`}),`
+`,(0,c.jsx)(t.p,{children:`Основные функции чтения используют Web APIs:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`File`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Image`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`AbortController`}),` и `,(0,c.jsx)(t.code,{children:`AbortSignal`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`data URL.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому `,(0,c.jsx)(t.code,{children:`readFile`}),` и `,(0,c.jsx)(t.code,{children:`readImageFile`}),` предназначены прежде всего для браузера. Обычная Node.js-среда, server action, SSR loader или тестовый runner могут не иметь полного `,(0,c.jsx)(t.code,{children:`FileReader`}),`/`,(0,c.jsx)(t.code,{children:`Image`}),` API.`]}),`
+`,(0,c.jsx)(t.p,{children:`Чистые helpers не зависят от DOM:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`sanitizeFileName`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createAsciiFilenameFallback`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`encodeFilenameRFC5987`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`createContentDispositionHeader`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Их можно вызывать на серверной boundary, если runtime предоставляет стандартные строковые функции и `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Важно различать:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`импорт модуля;`}),`
+`,(0,c.jsx)(t.li,{children:`фактический вызов browser-функции.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Сам импорт не начинает чтение файла. Browser API используется только при вызове соответствующей функции.`}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsxs)(t.h3,{id:`что-такое-file`,children:[`Что такое `,(0,c.jsx)(t.code,{children:`File`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`File`}),` — браузерный объект, который представляет выбранный или созданный файл. Он наследуется от `,(0,c.jsx)(t.code,{children:`Blob`}),` и содержит байты плюс metadata:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const file = new File(["Привет"], "hello.txt", {
+	type: "text/plain",
+	lastModified: Date.now()
+});
+`})}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.name`})}),(0,c.jsxs)(t.td,{children:[`Имя, например `,(0,c.jsx)(t.code,{children:`report.pdf`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.type`})}),(0,c.jsxs)(t.td,{children:[`Заявленный MIME, например `,(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:`file.size`})}),(0,c.jsx)(t.td,{children:`Размер в байтах`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.lastModified`})}),(0,c.jsx)(t.td,{children:`Время изменения в миллисекундах от Unix epoch`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`File`}),` обычно получают из `,(0,c.jsx)(t.code,{children:`<input type="file">`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const input = document.querySelector<HTMLInputElement>("#document");
+
+input?.addEventListener("change", () => {
+	const file = input.files?.[0];
+
+	if (!file) {
+		return;
+	}
+
+	console.log(file.name, file.type, file.size);
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`files?.[0]`}),` может быть `,(0,c.jsx)(t.code,{children:`undefined`}),`, если пользователь закрыл диалог или очистил поле. Проверяйте это до вызова `,(0,c.jsx)(t.code,{children:`readFile`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-такое-mime-тип`,children:`Что такое MIME-тип`}),`
+`,(0,c.jsx)(t.p,{children:`MIME — строковая metadata о предполагаемом типе содержимого:`}),`
+`,(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:`image/jpeg`})}),(0,c.jsx)(t.td,{children:`JPEG`})]}),(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/octet-stream`})}),(0,c.jsx)(t.td,{children:`Неизвестные байты`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`У MIME две части, разделённые `,(0,c.jsx)(t.code,{children:`/`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`image/png
+^^^^^ ^^^
+type  subtype
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение `,(0,c.jsx)(t.code,{children:`File.type`}),` нельзя считать доказательством формата. Оно может быть пустым, ошибочным или подделанным. Клиентская MIME-проверка улучшает UX, но не является security boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`mime-и-расширение--не-одно-и-то-же`,children:`MIME и расширение — не одно и то же`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для файла `,(0,c.jsx)(t.code,{children:`photo.jpeg`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`расширение — `,(0,c.jsx)(t.code,{children:`jpeg`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`MIME — `,(0,c.jsx)(t.code,{children:`image/jpeg`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Переименование `,(0,c.jsx)(t.code,{children:`malware.exe`}),` в `,(0,c.jsx)(t.code,{children:`photo.jpeg`}),` не превращает содержимое в изображение. Окончательное решение должен принимать backend или специализированный parser.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`что-такое-filereader`,children:[`Что такое `,(0,c.jsx)(t.code,{children:`FileReader`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`FileReader`}),` — browser API, который асинхронно загружает весь `,(0,c.jsx)(t.code,{children:`Blob`}),`/`,(0,c.jsx)(t.code,{children:`File`}),` в память. Этот модуль скрывает обработчики `,(0,c.jsx)(t.code,{children:`load`}),`, `,(0,c.jsx)(t.code,{children:`error`}),` и `,(0,c.jsx)(t.code,{children:`abort`}),` за обычным `,(0,c.jsx)(t.code,{children:`Promise`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Вместо ручного кода:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const reader = new FileReader();
+
+reader.onload = () => {
+	console.log(reader.result);
+};
+
+reader.readAsArrayBuffer(file);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`используется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, { mode: "array-buffer" });
+console.log(result.buffer);
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`что-такое-promise-async-и-await`,children:[`Что такое `,(0,c.jsx)(t.code,{children:`Promise`}),`, `,(0,c.jsx)(t.code,{children:`async`}),` и `,(0,c.jsx)(t.code,{children:`await`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Чтение не завершается мгновенно. `,(0,c.jsx)(t.code,{children:`readFile`}),` возвращает `,(0,c.jsx)(t.code,{children:`Promise`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const promise = readFile(file);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`await`}),` ожидает результат внутри `,(0,c.jsx)(t.code,{children:`async`}),`-функции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function handleFile(file: File) {
+	try {
+		const result = await readFile(file);
+		console.log(result.dataUrl);
+	} catch (error) {
+		console.error(error);
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Без `,(0,c.jsx)(t.code,{children:`await`}),` переменная содержит не результат, а Promise:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+const result = readFile(file);
+// result.dataUrl недоступен: result — Promise.
+`})}),`
+`,(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:image/png;base64,iVBORw0KGgoAAA...
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Его удобно передать в `,(0,c.jsx)(t.code,{children:`src`}),` изображения:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`imageElement.src = result.dataUrl;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Base64 увеличивает текстовое представление байтов примерно на треть. Для больших файлов data URL расходует заметно больше памяти, чем исходный `,(0,c.jsx)(t.code,{children:`File`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`что-такое-arraybuffer`,children:[`Что такое `,(0,c.jsx)(t.code,{children:`ArrayBuffer`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ArrayBuffer`}),` — непрерывный участок памяти с байтами. Сам буфер не предоставляет удобного доступа к отдельным байтам; обычно создают typed view:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, { mode: "array-buffer" });
+const bytes = new Uint8Array(result.buffer);
+
+console.log(bytes[0]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ArrayBuffer`}),` подходит бинарным parsers, Web APIs и transport-коду, которому нужны именно байты.`]}),`
+`,(0,c.jsx)(t.h3,{id:`что-такое-discriminated-union`,children:`Что такое discriminated union`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ReadFileResult`}),` может иметь одну из двух форм. Поле `,(0,c.jsx)(t.code,{children:`mode`}),` является discriminator:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function consume(result: ReadFileResult) {
+	if (result.mode === "data-url") {
+		console.log(result.dataUrl);
+		return;
+	}
+
+	console.log(result.buffer);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`После проверки `,(0,c.jsx)(t.code,{children:`mode`}),` TypeScript понимает, какое поле доступно. Не обращайтесь к `,(0,c.jsx)(t.code,{children:`dataUrl`}),` и `,(0,c.jsx)(t.code,{children:`buffer`}),` одновременно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`размеры-в-байтах`,children:`Размеры в байтах`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`maxBytes`}),` задаётся в байтах:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ONE_MEBIBYTE = 1024 * 1024;
+const FIVE_MEBIBYTES = 5 * ONE_MEBIBYTE;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для ограничения около 5 MiB:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await readFile(file, { maxBytes: 5 * 1024 * 1024 });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверка сравнивает `,(0,c.jsx)(t.code,{children:`file.size > maxBytes`}),`. Файл размером ровно `,(0,c.jsx)(t.code,{children:`maxBytes`}),` разрешён.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-api`,children:`Как выбрать API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Требование`}),(0,c.jsx)(t.th,{children:`API или режим`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Показать маленькое изображение через `,(0,c.jsx)(t.code,{children:`<img src>`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),`, режим `,(0,c.jsx)(t.code,{children:`data-url`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Узнать ширину и высоту изображения`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),`, режим `,(0,c.jsx)(t.code,{children:`data-url`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Передать байты parser/worker/криптографическому API`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`readFile`}),`, режим `,(0,c.jsx)(t.code,{children:`array-buffer`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Сохранить выбранный файл в `,(0,c.jsx)(t.code,{children:`FormData`})]}),(0,c.jsxs)(t.td,{children:[`Использовать исходный `,(0,c.jsx)(t.code,{children:`File`}),` напрямую`]})]}),(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:`allowedMime`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Ограничить размер`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`maxBytes`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Отменить активное чтение`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AbortController`})})]}),(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:`resolveMimeTypeByExtension`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Сформировать filename в HTTP `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createContentDispositionHeader`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Превратить уже полученный base64 в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsxs)(t.td,{children:[`Соседний модуль `,(0,c.jsx)(t.code,{children:`/binary`})]})]}),(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:`/dom`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Практический default:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`для обычных документов предпочитайте `,(0,c.jsx)(t.code,{children:`array-buffer`}),`, если байты действительно нужны;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`для preview изображения используйте `,(0,c.jsx)(t.code,{children:`readImageFile`}),` с небольшим `,(0,c.jsx)(t.code,{children:`maxBytes`}),` и явным `,(0,c.jsx)(t.code,{children:`allowedMime`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`для обычного multipart upload вообще не читайте файл заранее;`}),`
+`,(0,c.jsxs)(t.li,{children:[`для проверки типа предпочитайте `,(0,c.jsx)(t.code,{children:`allowedMime`}),`, потому что поведение `,(0,c.jsx)(t.code,{children:`accept`}),` внутри `,(0,c.jsx)(t.code,{children:`readFile`}),` не совпадает с HTML `,(0,c.jsx)(t.code,{children:`accept`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsxs)(t.h3,{id:`прочитать-один-pdf-как-arraybuffer`,children:[`Прочитать один PDF как `,(0,c.jsx)(t.code,{children:`ArrayBuffer`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { ReadFileError, readFile } from "@ryuzaki13/react-foundation-lib/file";
+
+const input = document.querySelector<HTMLInputElement>("#pdf-input");
+
+input?.addEventListener("change", async () => {
+	const file = input.files?.[0];
+
+	if (!file) {
+		return;
+	}
+
+	try {
+		const result = await readFile(file, {
+			mode: "array-buffer",
+			allowedMime: ["application/pdf"],
+			maxBytes: 10 * 1024 * 1024
+		});
+
+		console.log(result.meta.name);
+		console.log(result.buffer.byteLength);
+	} catch (error) {
+		if (error instanceof ReadFileError) {
+			console.error(error.code, error.message);
+			return;
+		}
+
+		throw error;
+	}
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`HTML:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-html`,children:`<input id="pdf-input" type="file" accept="application/pdf,.pdf" />
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`HTML `,(0,c.jsx)(t.code,{children:`accept`}),` помогает фильтровать диалог выбора. `,(0,c.jsx)(t.code,{children:`allowedMime`}),` повторно проверяет выбранный объект перед чтением. Ни одна из этих проверок не заменяет backend.`]}),`
+`,(0,c.jsx)(t.h3,{id:`прочитать-изображение-для-preview`,children:`Прочитать изображение для preview`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { readImageFile } from "@ryuzaki13/react-foundation-lib/file";
+
+async function createPreview(file: File, image: HTMLImageElement) {
+	const result = await readImageFile(file, {
+		allowedMime: ["image/jpeg", "image/png", "image/webp"],
+		maxBytes: 5 * 1024 * 1024
+	});
+
+	image.src = result.dataUrl;
+
+	if (result.dimensions) {
+		console.log(\`\${result.dimensions.width} × \${result.dimensions.height}\`);
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`dimensions`}),` отмечено в публичном типе как optional, поэтому безопасный consumer проверяет его наличие, хотя текущая успешная реализация data URL возвращает объект размеров.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`сформировать-content-disposition`,children:[`Сформировать `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { createContentDispositionHeader } from "@ryuzaki13/react-foundation-lib/file";
+
+const contentDisposition = createContentDispositionHeader({
+	disposition: "attachment",
+	filename: "Отчёт за август.pdf",
+	asciiFallback: "report-august.pdf"
+});
+
+console.log(contentDisposition);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат содержит два параметра:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`attachment; filename="_____ __ ______.pdf"; filename*=UTF-8''%D0%9E%D1%82...
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Точное количество `,(0,c.jsx)(t.code,{children:`_`}),` зависит от Unicode-символов. Важно: `,(0,c.jsx)(t.code,{children:`asciiFallback`}),` не переопределяет ASCII-вариант непустого Unicode-имени. Текущая реализация использует его только тогда, когда имя после первичной обработки пустое либо ASCII-результат оказался пустым.`]}),`
+`,(0,c.jsx)(t.h2,{id:`readfile`,children:(0,c.jsx)(t.code,{children:`readFile`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readFile`}),` применяет выбранные ограничения, читает файл через `,(0,c.jsx)(t.code,{children:`FileReader`}),` и возвращает исходный `,(0,c.jsx)(t.code,{children:`File`}),`, metadata и представление данных выбранного режима. Синтаксические assert helpers автоматически не вызываются.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатуры`,children:`Сигнатуры`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readFile(file: File, opts?: Omit<ReadFileOptions, "mode"> & { mode?: "data-url" }): Promise<ReadFileAsDataUrlResult>;
+
+function readFile(file: File, opts: Omit<ReadFileOptions, "mode"> & { mode: "array-buffer" }): Promise<ReadFileAsArrayBufferResult>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Перегрузки связывают литеральный `,(0,c.jsx)(t.code,{children:`mode`}),` с точным типом результата:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const dataResult = await readFile(file);
+dataResult.dataUrl;
+
+const bufferResult = await readFile(file, { mode: "array-buffer" });
+bufferResult.buffer;
+`})}),`
+`,(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:`file`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`File`})}),(0,c.jsx)(t.td,{children:`Обязательный файл для проверки и чтения`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`opts`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileOptions`})}),(0,c.jsxs)(t.td,{children:[`Необязательные режим, ограничения и `,(0,c.jsx)(t.code,{children:`AbortSignal`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте реальный `,(0,c.jsx)(t.code,{children:`File`}),`. Значение `,(0,c.jsx)(t.code,{children:`undefined`}),` не является поддерживаемым аргументом:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const file = input.files?.[0];
+
+if (!file) {
+	return;
+}
+
+await readFile(file);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Несмотря на публичный код ошибки `,(0,c.jsx)(t.code,{children:`NO_FILE`}),`, текущая функция сама не проверяет отсутствующий аргумент. При обходе TypeScript runtime может вернуть обычный `,(0,c.jsx)(t.code,{children:`TypeError`}),` как rejected Promise.`]}),`
+`,(0,c.jsx)(t.h3,{id:`options`,children:`Options`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Option`}),(0,c.jsx)(t.th,{children:`Тип`}),(0,c.jsx)(t.th,{children:`Default`}),(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:`mode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadMode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"data-url"`})}),(0,c.jsxs)(t.td,{children:[`Выбирает `,(0,c.jsx)(t.code,{children:`dataUrl`}),` или `,(0,c.jsx)(t.code,{children:`buffer`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`allowedMime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly string[]`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsxs)(t.td,{children:[`Точное case-insensitive сравнение с `,(0,c.jsx)(t.code,{children:`file.type`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`accept`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly string[]`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Legacy-проверка по включению суффикса имени; см. предупреждение`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`maxBytes`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsxs)(t.td,{children:[`Ошибка, если `,(0,c.jsx)(t.code,{children:`file.size > maxBytes`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`signal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AbortSignal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsxs)(t.td,{children:[`Отменяет `,(0,c.jsx)(t.code,{children:`FileReader`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-выполнения`,children:`Порядок выполнения`}),`
+`,(0,c.jsxs)(t.p,{children:[`При вызове `,(0,c.jsx)(t.code,{children:`readFile`}),` происходит следующее:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`проверяется, не был ли `,(0,c.jsx)(t.code,{children:`signal`}),` уже отменён;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`если `,(0,c.jsx)(t.code,{children:`allowedMime`}),` непустой, сравнивается `,(0,c.jsx)(t.code,{children:`file.type`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`иначе, если `,(0,c.jsx)(t.code,{children:`accept`}),` непустой, выполняется legacy-проверка суффикса;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяется `,(0,c.jsx)(t.code,{children:`maxBytes`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаётся snapshot `,(0,c.jsx)(t.code,{children:`meta`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`создаётся `,(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`к нему подключается `,(0,c.jsx)(t.code,{children:`AbortSignal`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывается `,(0,c.jsx)(t.code,{children:`readAsDataURL`}),` или `,(0,c.jsx)(t.code,{children:`readAsArrayBuffer`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`listener отмены удаляется после `,(0,c.jsx)(t.code,{children:`load`}),`, `,(0,c.jsx)(t.code,{children:`error`}),` или `,(0,c.jsx)(t.code,{children:`abort`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращается типизированный объект либо отклоняется Promise.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверки выполняются до чтения байтов, поэтому неподходящий файл не загружается в память через `,(0,c.jsx)(t.code,{children:`FileReader`}),`.`]}),`
+`,(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:`type CommonResult = {
+	mode: "data-url" | "array-buffer";
+	meta: FileMeta;
+	file: File;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`file`}),` — тот же объект, который был передан функции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file);
+
+console.log(result.file === file); // true
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`meta`}),` — новый обычный объект со snapshot четырёх полей:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type FileMeta = {
+	mime: string;
+	size: number;
+	name: string;
+	lastModified: number;
+};
+`})}),`
+`,(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.jsxs)(t.th,{children:[(0,c.jsx)(t.code,{children:`meta`}),` поле`]}),(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:`meta.mime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.type`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`meta.size`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.size`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`meta.name`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.name`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`meta.lastModified`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.lastModified`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Metadata не очищается, не нормализуется и не подтверждается по содержимому.`}),`
+`,(0,c.jsxs)(t.h2,{id:`режим-data-url`,children:[`Режим `,(0,c.jsx)(t.code,{children:`data-url`})]}),`
+`,(0,c.jsx)(t.p,{children:`Это default:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`То же самое явно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, { mode: "data-url" });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReadFileAsDataUrlResult = {
+	mode: "data-url";
+	meta: FileMeta;
+	dataUrl: string;
+	file: File;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`preview небольшого изображения;`}),`
+`,(0,c.jsx)(t.li,{children:`API, которому требуется data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`локальное встраивание небольших ресурсов;`}),`
+`,(0,c.jsx)(t.li,{children:`временное отображение содержимого в browser UI.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример`,children:`Пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, {
+	allowedMime: ["image/png"]
+});
+
+preview.src = result.dataUrl;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-не-использовать`,children:`Когда не использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`для большого видео;`}),`
+`,(0,c.jsx)(t.li,{children:`для крупного архива;`}),`
+`,(0,c.jsxs)(t.li,{children:[`если downstream принимает `,(0,c.jsx)(t.code,{children:`File`}),`, `,(0,c.jsx)(t.code,{children:`Blob`}),` или `,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`только ради обычного `,(0,c.jsx)(t.code,{children:`FormData`}),` upload;`]}),`
+`,(0,c.jsx)(t.li,{children:`для долгого хранения в state/cache без необходимости.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Data URL является строкой и обычно содержит base64. Это создаёт дополнительную копию данных и увеличивает размер представления.`}),`
+`,(0,c.jsxs)(t.h2,{id:`режим-array-buffer`,children:[`Режим `,(0,c.jsx)(t.code,{children:`array-buffer`})]}),`
+`,(0,c.jsx)(t.p,{children:`Включается только явным литералом:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, {
+	mode: "array-buffer"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReadFileAsArrayBufferResult = {
+	mode: "array-buffer";
+	meta: FileMeta;
+	buffer: ArrayBuffer;
+	file: File;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать-1`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`бинарный parser;`}),`
+`,(0,c.jsx)(t.li,{children:`вычисление checksum через Web Crypto;`}),`
+`,(0,c.jsxs)(t.li,{children:[`отправка байтов API, которое не принимает `,(0,c.jsx)(t.code,{children:`File`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`передача данных Web Worker;`}),`
+`,(0,c.jsx)(t.li,{children:`анализ заголовка файла.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`прочитать-первые-байты`,children:`Прочитать первые байты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, { mode: "array-buffer" });
+const bytes = new Uint8Array(result.buffer);
+
+console.log(bytes.slice(0, 8));
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`переменный-режим`,children:`Переменный режим`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если mode хранится в широкой переменной `,(0,c.jsx)(t.code,{children:`ReadMode`}),`, безопаснее разделить вызовы:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { ReadFileResult, ReadMode } from "@ryuzaki13/react-foundation-lib/file";
+
+async function readByMode(file: File, mode: ReadMode): Promise<ReadFileResult> {
+	if (mode === "array-buffer") {
+		return readFile(file, { mode: "array-buffer" });
+	}
+
+	return readFile(file);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так каждая перегрузка получает литеральное значение, а не union.`}),`
+`,(0,c.jsx)(t.h2,{id:`проверка-типа-и-размера`,children:`Проверка типа и размера`}),`
+`,(0,c.jsxs)(t.h3,{id:`allowedmime--рекомендуемая-проверка-типа`,children:[(0,c.jsx)(t.code,{children:`allowedMime`}),` — рекомендуемая проверка типа`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`allowedMime`}),` выполняет точное сравнение MIME после `,(0,c.jsx)(t.code,{children:`trim()`}),` и `,(0,c.jsx)(t.code,{children:`toLowerCase()`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await readFile(file, {
+	allowedMime: ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"]
+});
+`})}),`
+`,(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:`file.type`})}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`allowedMime`})}),(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:(0,c.jsx)(t.code,{children:`['application/pdf']`})}),(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/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.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:` application/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.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/png`})}),(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.jsx)(t.td,{children:`пустая строка`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`['application/pdf']`})}),(0,c.jsx)(t.td,{children:`ошибка`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Непустой `,(0,c.jsx)(t.code,{children:`allowedMime`}),` имеет приоритет над `,(0,c.jsx)(t.code,{children:`accept`}),`: если переданы оба, `,(0,c.jsx)(t.code,{children:`accept`}),` внутри `,(0,c.jsx)(t.code,{children:`readFile`}),` не проверяется.`]}),`
+`,(0,c.jsx)(t.p,{children:`Пустой массив не ограничивает MIME:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await readFile(file, { allowedMime: [] });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если одновременно передан непустой `,(0,c.jsx)(t.code,{children:`accept`}),`, пустой `,(0,c.jsx)(t.code,{children:`allowedMime`}),` не блокирует его применение.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`валидация-конфигурации-allowedmime`,children:[`Валидация конфигурации `,(0,c.jsx)(t.code,{children:`allowedMime`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readFile`}),` не вызывает `,(0,c.jsx)(t.code,{children:`assertValidAllowedMime`}),` автоматически. Если список строится динамически, проверьте его отдельно:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { assertValidAllowedMime, readFile } from "@ryuzaki13/react-foundation-lib/file";
+
+const allowedMime = ["application/pdf", "image/png"] as const;
+
+assertValidAllowedMime(allowedMime);
+const result = await readFile(file, { allowedMime });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Валидный элемент должен быть полным MIME без wildcard и параметров:`}),`
+`,(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:`application/pdf`})}),(0,c.jsx)(t.td,{children:`да`})]}),(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:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/*`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text/plain; charset=UTF-8`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(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.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:` application/pdf`})}),(0,c.jsx)(t.td,{children:`нет`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`assertValidAllowedMime`}),` не обрезает строку и при ошибке бросает обычный `,(0,c.jsx)(t.code,{children:`Error`}),`, а не `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`accept--важное-отличие-от-html`,children:[(0,c.jsx)(t.code,{children:`accept`}),` — важное отличие от HTML`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В HTML атрибут `,(0,c.jsx)(t.code,{children:`accept`}),` является подсказкой нативному file picker:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-html`,children:`<input type="file" accept=".pdf,application/pdf,image/*" />
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`readFile`}),` option `,(0,c.jsx)(t.code,{children:`accept`}),` имеет текущую legacy-семантику и не повторяет правила HTML:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`из `,(0,c.jsx)(t.code,{children:`file.name`}),` берётся часть после последней точки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`если она пустая, берётся subtype из `,(0,c.jsx)(t.code,{children:`file.type`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`каждый accept-элемент нормализуется;`}),`
+`,(0,c.jsxs)(t.li,{children:[`файл разрешён, если хотя бы одна строка `,(0,c.jsx)(t.code,{children:`accept`}),` содержит полученный суффикс через `,(0,c.jsx)(t.code,{children:`includes`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Примеры текущего поведения для `,(0,c.jsx)(t.code,{children:`photo.png`}),`:`]}),`
+`,(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:`accept`})}),(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:`['.png']`})}),(0,c.jsx)(t.td,{children:`разрешён`}),(0,c.jsxs)(t.td,{children:[`строка `,(0,c.jsx)(t.code,{children:`.png`}),` содержит `,(0,c.jsx)(t.code,{children:`png`})]})]}),(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:`разрешён`}),(0,c.jsxs)(t.td,{children:[`строка `,(0,c.jsx)(t.code,{children:`image/png`}),` содержит `,(0,c.jsx)(t.code,{children:`png`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`['image/*']`})}),(0,c.jsx)(t.td,{children:`ошибка`}),(0,c.jsxs)(t.td,{children:[`строка `,(0,c.jsx)(t.code,{children:`image/*`}),` не содержит `,(0,c.jsx)(t.code,{children:`png`})]})]}),(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.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`.jpg`}),` не содержит `,(0,c.jsx)(t.code,{children:`png`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Дополнительные особенности:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`имя без точки, например `,(0,c.jsx)(t.code,{children:`photo`}),`, трактуется как найденный суффикс `,(0,c.jsx)(t.code,{children:`photo`}),`, поэтому MIME fallback обычно не используется;`]}),`
+`,(0,c.jsx)(t.li,{children:`используется substring-проверка, а не строгое сравнение;`}),`
+`,(0,c.jsxs)(t.li,{children:[`wildcard `,(0,c.jsx)(t.code,{children:`image/*`}),` проходит `,(0,c.jsx)(t.code,{children:`assertValidAccept`}),`, но обычно не разрешает файл `,(0,c.jsx)(t.code,{children:`photo.png`}),` внутри `,(0,c.jsx)(t.code,{children:`readFile`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`строка с несколькими specifiers через запятую не поддерживается: каждый specifier должен быть отдельным элементом массива;`}),`
+`,(0,c.jsxs)(t.li,{children:[`если непустой `,(0,c.jsx)(t.code,{children:`allowedMime`}),` уже передан, `,(0,c.jsx)(t.code,{children:`accept`}),` игнорируется.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому для runtime-проверки файла используйте `,(0,c.jsx)(t.code,{children:`allowedMime`}),`. `,(0,c.jsx)(t.code,{children:`accept`}),` удобно передавать UI-компоненту или нативному `,(0,c.jsx)(t.code,{children:`<input>`}),`, а затем отдельно проверять MIME.`]}),`
+`,(0,c.jsx)(t.h3,{id:`assertvalidaccept`,children:(0,c.jsx)(t.code,{children:`assertValidAccept`})}),`
+`,(0,c.jsx)(t.p,{children:`Helper проверяет синтаксис массива:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`assertValidAccept([".pdf", "application/pdf", "image/*"]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Допускаются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`расширение с начальной точкой: `,(0,c.jsx)(t.code,{children:`.pdf`}),`, `,(0,c.jsx)(t.code,{children:`.tar.gz`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`полный MIME: `,(0,c.jsx)(t.code,{children:`application/pdf`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`MIME wildcard: `,(0,c.jsx)(t.code,{children:`image/*`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не допускаются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`расширение без точки: `,(0,c.jsx)(t.code,{children:`pdf`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`запятая внутри одного элемента: `,(0,c.jsx)(t.code,{children:`.pdf,.docx`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пробелы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`параметры MIME: `,(0,c.jsx)(t.code,{children:`text/plain; charset=UTF-8`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это только синтаксическая проверка. Она не гарантирует, что `,(0,c.jsx)(t.code,{children:`readFile`}),` применит HTML-семантику wildcard.`]}),`
+`,(0,c.jsx)(t.h3,{id:`maxbytes`,children:(0,c.jsx)(t.code,{children:`maxBytes`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await readFile(file, {
+	maxBytes: 5 * 1024 * 1024
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Условие ошибки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`file.size > maxBytes;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Следовательно:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ровно допустимый размер проходит;`}),`
+`,(0,c.jsxs)(t.li,{children:[`ограничение применяется до `,(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`значение должно задаваться в байтах;`}),`
+`,(0,c.jsx)(t.li,{children:`функция не проверяет, является ли option положительным конечным числом.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте осмысленное положительное значение. Отрицательное число отклонит даже пустой файл, `,(0,c.jsx)(t.code,{children:`NaN`}),` фактически отключит сравнение, а `,(0,c.jsx)(t.code,{children:`Infinity`}),` снимет предел.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-нужны-обе-границы`,children:`Почему нужны обе границы`}),`
+`,(0,c.jsx)(t.p,{children:`Типичный UI использует две разные проверки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ACCEPT = ".pdf,application/pdf";
+const ALLOWED_MIME = ["application/pdf"] as const;
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`accept`}),` в HTML фильтрует диалог и улучшает UX;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`allowedMime`}),` в `,(0,c.jsx)(t.code,{children:`readFile`}),` проверяет browser object;`]}),`
+`,(0,c.jsx)(t.li,{children:`backend проверяет реальные байты, политику, права и допустимый размер заново.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`отмена-через-abortsignal`,children:[`Отмена через `,(0,c.jsx)(t.code,{children:`AbortSignal`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`AbortController`}),` создаёт signal, который можно отменить:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const controller = new AbortController();
+
+const promise = readFile(file, {
+	mode: "array-buffer",
+	signal: controller.signal
+});
+
+controller.abort();
+
+try {
+	await promise;
+} catch (error) {
+	console.error(error);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если signal отменён до вызова, `,(0,c.jsx)(t.code,{children:`readFile`}),` сразу возвращает rejected Promise с `,(0,c.jsx)(t.code,{children:`ReadFileError`}),` и code `,(0,c.jsx)(t.code,{children:`READ_ABORTED`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если отмена происходит во время работы `,(0,c.jsx)(t.code,{children:`FileReader`}),`, helper вызывает `,(0,c.jsx)(t.code,{children:`reader.abort()`}),`. Затем Promise отклоняется с `,(0,c.jsx)(t.code,{children:`READ_ABORTED`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`отменять-предыдущее-чтение-при-новом-выборе`,children:`Отменять предыдущее чтение при новом выборе`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`let activeController: AbortController | undefined;
+
+async function selectFile(file: File) {
+	activeController?.abort();
+
+	const controller = new AbortController();
+	activeController = controller;
+
+	try {
+		return await readFile(file, {
+			mode: "array-buffer",
+			signal: controller.signal
+		});
+	} finally {
+		if (activeController === controller) {
+			activeController = undefined;
+		}
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`AbortSignal`}),` отменяет чтение, но не удаляет выбранный `,(0,c.jsx)(t.code,{children:`File`}),`, не очищает `,(0,c.jsx)(t.code,{children:`<input>`}),` и не отменяет последующий HTTP upload, если он уже запущен другим API.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`readImageFile`}),` отмена имеет дополнительное ограничение: signal связан с `,(0,c.jsx)(t.code,{children:`FileReader`}),`, но не прерывает ожидание `,(0,c.jsx)(t.code,{children:`Image.onload`}),`/`,(0,c.jsx)(t.code,{children:`Image.onerror`}),` во время определения размеров. Подробнее это описано в разделе об изображениях.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`ошибки-readfile`,children:[`Ошибки `,(0,c.jsx)(t.code,{children:`readFile`})]}),`
+`,(0,c.jsxs)(t.h3,{id:`класс-readfileerror`,children:[`Класс `,(0,c.jsx)(t.code,{children:`ReadFileError`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`class ReadFileError extends Error {
+	readonly code: ReadFileErrorCode;
+	readonly cause?: unknown;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обрабатывайте `,(0,c.jsx)(t.code,{children:`unknown`}),`, а не делайте небезопасный cast:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`try {
+	const result = await readFile(file, options);
+	return result;
+} catch (error) {
+	if (error instanceof ReadFileError) {
+		console.error(error.code, error.message, error.cause);
+		return;
+	}
+
+	throw error;
+}
+`})}),`
+`,(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:`Code`}),(0,c.jsxs)(t.th,{children:[`Когда фактически возникает в `,(0,c.jsx)(t.code,{children:`readFile`})]})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`MIME_NOT_ALLOWED`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`allowedMime`}),` или legacy `,(0,c.jsx)(t.code,{children:`accept`}),` отклонил файл`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FILE_TOO_LARGE`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`file.size > maxBytes`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`READ_ABORTED`})}),(0,c.jsxs)(t.td,{children:[`signal уже отменён или `,(0,c.jsx)(t.code,{children:`FileReader`}),` получил abort`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`READ_FAILED`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FileReader`}),` завершился ошибкой, бросил исключение или дал неожиданный result`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NO_FILE`})}),(0,c.jsxs)(t.td,{children:[`Есть в публичном union, но текущий `,(0,c.jsx)(t.code,{children:`readFile`}),` его не создаёт`]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`cause`,children:(0,c.jsx)(t.code,{children:`cause`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для некоторых `,(0,c.jsx)(t.code,{children:`READ_FAILED`}),` поле `,(0,c.jsx)(t.code,{children:`cause`}),` содержит исходную ошибку `,(0,c.jsx)(t.code,{children:`FileReader`}),`. Его удобно отправлять в технический logger, но не показывать пользователю без преобразования:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`if (error instanceof ReadFileError) {
+	logger.error("Ошибка чтения файла", {
+		code: error.code,
+		cause: error.cause
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`преобразование-в-пользовательский-текст`,children:`Преобразование в пользовательский текст`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getReadFileMessage(error: ReadFileError): string {
+	switch (error.code) {
+		case "MIME_NOT_ALLOWED":
+			return "Выберите файл поддерживаемого формата.";
+		case "FILE_TOO_LARGE":
+			return "Размер файла превышает допустимый.";
+		case "READ_ABORTED":
+			return "Чтение файла отменено.";
+		case "READ_FAILED":
+			return "Браузеру не удалось прочитать файл.";
+		case "NO_FILE":
+			return "Файл не выбран.";
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте `,(0,c.jsx)(t.code,{children:`message`}),` как стабильный программный код. Для ветвления предназначено поле `,(0,c.jsx)(t.code,{children:`code`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`какие-ошибки-не-являются-readfileerror`,children:[`Какие ошибки не являются `,(0,c.jsx)(t.code,{children:`ReadFileError`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`assertValidAllowedMime`}),` и `,(0,c.jsx)(t.code,{children:`assertValidAccept`}),` бросают обычный `,(0,c.jsx)(t.code,{children:`Error`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`передача `,(0,c.jsx)(t.code,{children:`undefined`}),` вместо `,(0,c.jsx)(t.code,{children:`File`}),` может привести к обычному `,(0,c.jsx)(t.code,{children:`TypeError`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`ошибочный consumer-код внутри собственного callback тоже не становится `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому неизвестную ошибку нельзя молча считать ошибкой формата файла.`}),`
+`,(0,c.jsx)(t.h2,{id:`readimagefile`,children:(0,c.jsx)(t.code,{children:`readImageFile`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),` — надстройка над `,(0,c.jsx)(t.code,{children:`readFile`}),` для файлов, чей `,(0,c.jsx)(t.code,{children:`file.type`}),` начинается с точной строки `,(0,c.jsx)(t.code,{children:`image/`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатуры-1`,children:`Сигнатуры`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function readImageFile(file: File, opts?: Omit<ReadImageOptions, "mode"> & { mode?: "data-url" }): Promise<ReadImageAsDataUrlResult>;
+
+function readImageFile(file: File, opts: Omit<ReadImageOptions, "mode"> & { mode: "array-buffer" }): Promise<ReadImageAsArrayBufferResult>;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`поддерживаемый-typed-список-mime`,children:`Поддерживаемый typed список MIME`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ImageMime = "image/png" | "image/jpeg" | "image/webp" | "image/gif" | "image/svg+xml" | "image/avif";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Этот union ограничивает `,(0,c.jsx)(t.code,{children:`allowedMime`}),` на уровне TypeScript:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await readImageFile(file, {
+	allowedMime: ["image/jpeg", "image/png"]
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`allowedMime`}),` не передан или пуст, первичная runtime-проверка разрешает любой MIME, который начинается с `,(0,c.jsx)(t.code,{children:`image/`}),`, включая MIME вне `,(0,c.jsx)(t.code,{children:`ImageMime`}),`, например `,(0,c.jsx)(t.code,{children:`image/bmp`}),`. Возможность успешного определения размеров затем зависит от браузерного decoder.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`проверка-image`,children:[`Проверка `,(0,c.jsx)(t.code,{children:`image/*`})]}),`
+`,(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:`file.type`})}),(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:`image/png`})}),(0,c.jsx)(t.td,{children:`проходит`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/svg+xml`})}),(0,c.jsx)(t.td,{children:`проходит`})]}),(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:(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`})})]}),(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:(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`пустая строка`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`После неё непустой `,(0,c.jsx)(t.code,{children:`allowedMime`}),` проверяется внутри `,(0,c.jsx)(t.code,{children:`readFile`}),` по точному нормализованному сравнению.`]}),`
+`,(0,c.jsx)(t.h3,{id:`options-1`,children:`Options`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Option`}),(0,c.jsx)(t.th,{children:`Тип`}),(0,c.jsx)(t.th,{children:`Default`}),(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:`mode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadMode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"data-url"`})}),(0,c.jsx)(t.td,{children:`Выбирает data URL с dimensions или buffer`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`allowedMime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly ImageMime[]`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Ограничивает точные MIME изображений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`maxBytes`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsxs)(t.td,{children:[`Передаётся в `,(0,c.jsx)(t.code,{children:`readFile`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`signal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`AbortSignal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsxs)(t.td,{children:[`Передаётся в `,(0,c.jsx)(t.code,{children:`readFile`}),`; проверяется до/после decode`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`accept`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly string[]`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Присутствует в типе, но текущая функция его не передаёт и не применяет`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не рассчитывайте на `,(0,c.jsx)(t.code,{children:`accept`}),` в `,(0,c.jsx)(t.code,{children:`readImageFile`}),`. Для фактического ограничения используйте `,(0,c.jsx)(t.code,{children:`allowedMime`}),`, а для нативного picker установите HTML `,(0,c.jsx)(t.code,{children:`accept`}),` отдельно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`режим-data-url-и-dimensions`,children:`Режим data URL и dimensions`}),`
+`,(0,c.jsx)(t.p,{children:`Default-сценарий:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`проверить `,(0,c.jsx)(t.code,{children:`file.type.startsWith('image/')`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`прочитать файл как data URL;`}),`
+`,(0,c.jsxs)(t.li,{children:[`создать browser `,(0,c.jsx)(t.code,{children:`Image`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`назначить `,(0,c.jsx)(t.code,{children:`img.src = dataUrl`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`дождаться `,(0,c.jsx)(t.code,{children:`onload`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вернуть `,(0,c.jsx)(t.code,{children:`naturalWidth`}),` и `,(0,c.jsx)(t.code,{children:`naturalHeight`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readImageFile(file, {
+	allowedMime: ["image/jpeg", "image/png"],
+	maxBytes: 5 * 1024 * 1024
+});
+
+console.log(result.mode); // "data-url"
+console.log(result.dataUrl);
+
+if (result.dimensions) {
+	console.log(result.dimensions.width);
+	console.log(result.dimensions.height);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип результата:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReadImageAsDataUrlResult = ReadFileAsDataUrlResult & {
+	dimensions?: {
+		width: number;
+		height: number;
+	};
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`width`}),` и `,(0,c.jsx)(t.code,{children:`height`}),` — естественные размеры изображения в пикселях, а не CSS-размер элемента на странице.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`режим-array-buffer-1`,children:[`Режим `,(0,c.jsx)(t.code,{children:`array-buffer`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readImageFile(file, {
+	mode: "array-buffer",
+	allowedMime: ["image/png"]
+});
+
+console.log(result.buffer);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В этом режиме:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`файл проверяется как `,(0,c.jsx)(t.code,{children:`image/*`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`применяются `,(0,c.jsx)(t.code,{children:`allowedMime`}),` и `,(0,c.jsx)(t.code,{children:`maxBytes`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`выполняется только `,(0,c.jsx)(t.code,{children:`readFile`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`browser `,(0,c.jsx)(t.code,{children:`Image`}),` не создаётся;`]}),`
+`,(0,c.jsx)(t.li,{children:`размеры не декодируются и не возвращаются.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Если нужны размеры, выбирайте data URL либо специализированный image decoder.`}),`
+`,(0,c.jsx)(t.h3,{id:`ограничения-dimensions`,children:`Ограничения dimensions`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`animated GIF возвращает естественный размер изображения, а не данные каждого кадра;`}),`
+`,(0,c.jsx)(t.li,{children:`SVG зависит от того, может ли браузер определить intrinsic dimensions;`}),`
+`,(0,c.jsx)(t.li,{children:`большой сжатый файл может занимать мало байтов, но требовать огромную память после decode;`}),`
+`,(0,c.jsx)(t.li,{children:`модуль не проверяет максимальные width/height/pixel count;`}),`
+`,(0,c.jsxs)(t.li,{children:[`abort во время ожидания `,(0,c.jsx)(t.code,{children:`Image.onload`}),` не отменяет сам `,(0,c.jsx)(t.code,{children:`Image`}),` и не завершает ожидание немедленно;`]}),`
+`,(0,c.jsx)(t.li,{children:`data URL и decoded bitmap могут одновременно находиться в памяти.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`ошибки-readimagefile`,children:[`Ошибки `,(0,c.jsx)(t.code,{children:`readImageFile`})]}),`
+`,(0,c.jsx)(t.p,{children:`Публично экспортирован отдельный класс:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`class ReadImageError extends Error {
+	readonly code: ReadImageErrorCode;
+	readonly cause?: unknown;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ReadImageError`}),` не наследуется от `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`.`]}),`
+`,(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:`Тип rejected value`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`file.type`}),` не начинается с `,(0,c.jsx)(t.code,{children:`image/`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ReadImageError`}),` с code `,(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`MIME из `,(0,c.jsx)(t.code,{children:`allowedMime`}),` не подошёл`]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ReadFileError`}),` с code `,(0,c.jsx)(t.code,{children:`MIME_NOT_ALLOWED`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`файл превышает `,(0,c.jsx)(t.code,{children:`maxBytes`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ReadFileError`}),` с code `,(0,c.jsx)(t.code,{children:`FILE_TOO_LARGE`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`чтение отменено`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ReadFileError`}),` с code `,(0,c.jsx)(t.code,{children:`READ_ABORTED`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`FileReader`}),` завершился ошибкой`]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`ReadFileError`}),` с code `,(0,c.jsx)(t.code,{children:`READ_FAILED`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`browser `,(0,c.jsx)(t.code,{children:`Image`}),` вызвал `,(0,c.jsx)(t.code,{children:`onerror`})]}),(0,c.jsx)(t.td,{children:`необёрнутое значение browser event`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ReadImageErrorCode`}),` также включает `,(0,c.jsx)(t.code,{children:`IMAGE_DECODE_FAILED`}),` и коды `,(0,c.jsx)(t.code,{children:`ReadFileErrorCode`}),`, но текущая реализация не оборачивает ими ошибки `,(0,c.jsx)(t.code,{children:`readFile`}),` и decode. Код `,(0,c.jsx)(t.code,{children:`IMAGE_DECODE_FAILED`}),` сейчас самой функцией не создаётся.`]}),`
+`,(0,c.jsx)(t.p,{children:`Поэтому надёжный consumer обрабатывает оба класса и оставляет fallback для неизвестной ошибки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { ReadFileError, ReadImageError, readImageFile } from "@ryuzaki13/react-foundation-lib/file";
+
+try {
+	const result = await readImageFile(file, {
+		allowedMime: ["image/jpeg", "image/png"],
+		maxBytes: 5 * 1024 * 1024
+	});
+
+	return result;
+} catch (error) {
+	if (error instanceof ReadImageError) {
+		console.error("Проверка изображения", error.code);
+		return;
+	}
+
+	if (error instanceof ReadFileError) {
+		console.error("Чтение файла", error.code);
+		return;
+	}
+
+	console.error("Браузер не смог декодировать изображение", error);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не пишите обработчик, который ловит только `,(0,c.jsx)(t.code,{children:`ReadImageError`}),`: он пропустит ограничения MIME/размера и ошибки `,(0,c.jsx)(t.code,{children:`FileReader`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`resolvemimetypebyextension`,children:(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция принимает только расширение без имени файла и без начальной точки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function resolveMimeTypeByExtension(extension: string): string;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`примеры`,children:`Примеры`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveMimeTypeByExtension("pdf");
+// "application/pdf"
+
+resolveMimeTypeByExtension(" JPG ");
+// "image/jpeg"
+
+resolveMimeTypeByExtension("unknown");
+// "application/octet-stream"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неправильная форма входа:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveMimeTypeByExtension(".pdf");
+// "application/octet-stream"
+
+resolveMimeTypeByExtension("report.pdf");
+// "application/octet-stream"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Чтобы взять расширение из имени:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function getExtension(fileName: string): string {
+	const dotIndex = fileName.lastIndexOf(".");
+
+	if (dotIndex < 0 || dotIndex === fileName.length - 1) {
+		return "";
+	}
+
+	return fileName.slice(dotIndex + 1);
+}
+
+const mime = resolveMimeTypeByExtension(getExtension("report.PDF"));
+`})}),`
+`,(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:`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:`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:`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:`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:`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:`txt`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`text/plain; charset=UTF-8`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rtf`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/rtf`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odt`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.oasis.opendocument.text`})})]}),(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.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rar`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`application/vnd.rar`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`jpg`}),`, `,(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:`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:`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:`webp`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`image/webp`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Любое другое значение возвращает `,(0,c.jsx)(t.code,{children:`application/octet-stream`}),`. Функция:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`обрезает внешние пробелы;`}),`
+`,(0,c.jsx)(t.li,{children:`приводит регистр к lowercase;`}),`
+`,(0,c.jsx)(t.li,{children:`не бросает ошибку для неизвестного расширения;`}),`
+`,(0,c.jsx)(t.li,{children:`не анализирует имя файла;`}),`
+`,(0,c.jsx)(t.li,{children:`не читает байты;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не использует `,(0,c.jsx)(t.code,{children:`File.type`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не доказывает реальный формат.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Обратите внимание: `,(0,c.jsx)(t.code,{children:`ImageMime`}),` и таблица расширений не идентичны. Например, `,(0,c.jsx)(t.code,{children:`image/avif`}),` и `,(0,c.jsx)(t.code,{children:`image/svg+xml`}),` есть в `,(0,c.jsx)(t.code,{children:`ImageMime`}),`, но расширения `,(0,c.jsx)(t.code,{children:`avif`}),` и `,(0,c.jsx)(t.code,{children:`svg`}),` отсутствуют в resolver и дадут fallback.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`helpers-для-content-disposition`,children:[`Helpers для `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]}),`
+`,(0,c.jsxs)(t.h3,{id:`что-такое-content-disposition`,children:[`Что такое `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]}),`
+`,(0,c.jsx)(t.p,{children:`HTTP-заголовок сообщает клиенту, как обрабатывать response body:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Content-Disposition: attachment; filename="report.pdf"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Основные варианты:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`attachment`}),` — предложить скачивание;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`inline`}),` — предложить показать содержимое внутри браузера, если он умеет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Это рекомендация браузеру, а не абсолютная команда. Итоговое поведение зависит от browser, MIME, security policy и response headers.`}),`
+`,(0,c.jsx)(t.h3,{id:`createcontentdispositionheader`,children:(0,c.jsx)(t.code,{children:`createContentDispositionHeader`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ContentDispositionKind = "inline" | "attachment";
+
+type ContentDispositionOptions = {
+	readonly disposition: ContentDispositionKind;
+	readonly filename: string;
+	readonly asciiFallback?: string;
+};
+
+function createContentDispositionHeader(options: ContentDispositionOptions): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример для server response:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const filename = "Отчёт № 42.pdf";
+
+const headers = new Headers({
+	"Content-Type": "application/pdf",
+	"Content-Disposition": createContentDispositionHeader({
+		disposition: "attachment",
+		filename,
+		asciiFallback: "report-42.pdf"
+	})
+});
+
+return new Response(pdfBytes, { headers });
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция создаёт оба параметра:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`attachment; filename="_____ _ 42.pdf"; filename*=UTF-8''%D0%9E%D1%82%D1%87%D1%91%D1%82%20%E2%84%96%2042.pdf
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`filename=`}),` нужен старым/ограниченным клиентам и содержит ASCII;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`filename*=`}),` содержит UTF-8 имя, percent-encoded по RFC 5987-подобному формату.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Default `,(0,c.jsx)(t.code,{children:`asciiFallback`}),` равен `,(0,c.jsx)(t.code,{children:`file.bin`}),`. Это резерв для пустого/неполучившегося имени, а не принудительная замена legacy-параметра для любого Unicode filename.`]}),`
+`,(0,c.jsx)(t.h3,{id:`sanitizefilename`,children:(0,c.jsx)(t.code,{children:`sanitizeFileName`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function sanitizeFileName(value: string, fallback = "file"): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`заменяет `,(0,c.jsx)(t.code,{children:`\\r`}),` и `,(0,c.jsx)(t.code,{children:`\\n`}),` на пробел;`]}),`
+`,(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:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращает fallback, если строка стала пустой.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`sanitizeFileName('  "report"\\n.pdf  ');
+// "'report' .pdf"
+
+sanitizeFileName("\\n\\r", "document.bin");
+// "document.bin"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это узкий helper для header filename. Он не является полноценным sanitizer пути или имени файла операционной системы:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`не удаляет `,(0,c.jsx)(t.code,{children:`/`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`не удаляет `,(0,c.jsx)(t.code,{children:`..`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не удаляет все системные запрещённые символы;`}),`
+`,(0,c.jsx)(t.li,{children:`не предотвращает path traversal при записи на диск;`}),`
+`,(0,c.jsx)(t.li,{children:`не гарантирует уникальность;`}),`
+`,(0,c.jsx)(t.li,{children:`не ограничивает длину.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Никогда не используйте результат как доверенный server filesystem path. На backend создавайте собственное безопасное имя/ID и храните пользовательское имя только как metadata.`}),`
+`,(0,c.jsx)(t.h3,{id:`createasciifilenamefallback`,children:(0,c.jsx)(t.code,{children:`createAsciiFilenameFallback`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function createAsciiFilenameFallback(value: string, fallback = "file.bin"): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`заменяет CR/LF пробелом;`}),`
+`,(0,c.jsxs)(t.li,{children:[`заменяет `,(0,c.jsx)(t.code,{children:`"`}),` и `,(0,c.jsx)(t.code,{children:`\\`}),` символом `,(0,c.jsx)(t.code,{children:`_`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`заменяет каждый символ вне printable ASCII `,(0,c.jsx)(t.code,{children:`0x20–0x7E`}),` на `,(0,c.jsx)(t.code,{children:`_`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`схлопывает последовательности whitespace в один пробел;`}),`
+`,(0,c.jsx)(t.li,{children:`обрезает края;`}),`
+`,(0,c.jsx)(t.li,{children:`возвращает fallback для пустого результата.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createAsciiFilenameFallback("Отчёт 42.pdf");
+// "_____ 42.pdf"
+
+createAsciiFilenameFallback('report\\\\"42.pdf');
+// "report__42.pdf"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Unicode не транслитерируется. Кириллица не превращается в латиницу, а заменяется `,(0,c.jsx)(t.code,{children:`_`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Параметр `,(0,c.jsx)(t.code,{children:`fallback`}),` используется только тогда, когда итоговая строка пуста. Он не заменяет непустой результат из подчёркиваний:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createAsciiFilenameFallback("   ", "contract.pdf");
+// "contract.pdf"
+
+createAsciiFilenameFallback("Договор.pdf", "contract.pdf");
+// "_______.pdf", а не "contract.pdf"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому текущий `,(0,c.jsx)(t.code,{children:`createContentDispositionHeader`}),` не позволяет одновременно принудительно задать отдельное красивое legacy-имя и сохранить другое Unicode-имя в `,(0,c.jsx)(t.code,{children:`filename*`}),`. Для Unicode filename legacy-параметр обычно содержит `,(0,c.jsx)(t.code,{children:`_`}),`, а современный клиент должен использовать корректный `,(0,c.jsx)(t.code,{children:`filename*`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`encodefilenamerfc5987`,children:(0,c.jsx)(t.code,{children:`encodeFilenameRFC5987`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function encodeFilenameRFC5987(value: string): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper использует `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`, дополнительно percent-encode символы `,(0,c.jsx)(t.code,{children:`'`}),`, `,(0,c.jsx)(t.code,{children:`(`}),`, `,(0,c.jsx)(t.code,{children:`)`}),`, `,(0,c.jsx)(t.code,{children:`*`}),` и оставляет percent hex в uppercase для этих дополнительных замен.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`encodeFilenameRFC5987("Отчёт (1).pdf");
+// percent-encoded UTF-8 строка
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает только encoded filename, без префикса `,(0,c.jsx)(t.code,{children:`UTF-8''`}),` и без `,(0,c.jsx)(t.code,{children:`filename*=`}),`. Для готового заголовка почти всегда выбирайте `,(0,c.jsx)(t.code,{children:`createContentDispositionHeader`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Как и `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`, helper может бросить `,(0,c.jsx)(t.code,{children:`URIError`}),` для некорректной Unicode-строки с одиночным surrogate code unit.`]}),`
+`,(0,c.jsx)(t.h3,{id:`порядок-сборки-заголовка`,children:`Порядок сборки заголовка`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createContentDispositionHeader`}),`:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`sanitizeFileName(filename, asciiFallback)`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`создаёт ASCII-вариант;`}),`
+`,(0,c.jsx)(t.li,{children:`encode исходное очищенное Unicode-имя;`}),`
+`,(0,c.jsxs)(t.li,{children:[`собирает `,(0,c.jsx)(t.code,{children:`disposition`}),`, `,(0,c.jsx)(t.code,{children:`filename`}),` и `,(0,c.jsx)(t.code,{children:`filename*`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение `,(0,c.jsx)(t.code,{children:`disposition`}),` ограничено TypeScript union, но runtime-функция отдельно не валидирует вход. Не обходите тип через `,(0,c.jsx)(t.code,{children:`as`}),` и не принимайте это поле напрямую из недоверенного request.`]}),`
+`,(0,c.jsx)(t.h2,{id:`низкоуровневые-helpers`,children:`Низкоуровневые helpers`}),`
+`,(0,c.jsxs)(t.p,{children:[`Большинству приложений достаточно `,(0,c.jsx)(t.code,{children:`readFile`}),` и `,(0,c.jsx)(t.code,{children:`readImageFile`}),`. Следующие функции экспортированы для инфраструктуры, UI primitives и тестов.`]}),`
+`,(0,c.jsx)(t.h3,{id:`buildmeta`,children:(0,c.jsx)(t.code,{children:`buildMeta`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function buildMeta(file: File): FileMeta;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт новый объект из четырёх полей `,(0,c.jsx)(t.code,{children:`File`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const meta = buildMeta(file);
+
+console.log(meta.name);
+console.log(meta.mime);
+console.log(meta.size);
+console.log(meta.lastModified);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция не читает байты и не валидирует metadata.`}),`
+`,(0,c.jsx)(t.h3,{id:`assertnotaborted`,children:(0,c.jsx)(t.code,{children:`assertNotAborted`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function assertNotAborted(signal?: AbortSignal): void;
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ничего не делает без signal;`}),`
+`,(0,c.jsx)(t.li,{children:`ничего не делает для активного signal;`}),`
+`,(0,c.jsxs)(t.li,{children:[`бросает `,(0,c.jsx)(t.code,{children:`ReadFileError('READ_ABORTED')`}),`, если `,(0,c.jsx)(t.code,{children:`signal.aborted === true`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const controller = new AbortController();
+controller.abort();
+
+assertNotAborted(controller.signal);
+// throw ReadFileError
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`attachabort`,children:(0,c.jsx)(t.code,{children:`attachAbort`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function attachAbort(signal: AbortSignal | undefined, reader: FileReader): (() => void) | undefined;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция подписывает signal на `,(0,c.jsx)(t.code,{children:`reader.abort()`}),` и возвращает cleanup:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const reader = new FileReader();
+const detach = attachAbort(controller.signal, reader);
+
+try {
+	reader.readAsArrayBuffer(file);
+} finally {
+	detach?.();
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Важные детали:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`без signal возвращается `,(0,c.jsx)(t.code,{children:`undefined`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`listener использует `,(0,c.jsx)(t.code,{children:`{ once: true }`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`исключение от `,(0,c.jsx)(t.code,{children:`reader.abort()`}),` игнорируется;`]}),`
+`,(0,c.jsx)(t.li,{children:`helper сам не проверяет уже отменённый signal;`}),`
+`,(0,c.jsxs)(t.li,{children:[`при прямом использовании сначала вызовите `,(0,c.jsx)(t.code,{children:`assertNotAborted(signal)`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`вызывающий код отвечает за cleanup после success/error, если использует helper отдельно.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`assert-helpers`,children:`Assert helpers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function assertValidAllowedMime(allowedMime?: readonly string[]): void;
+function assertValidAccept(accept?: readonly string[]): void;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Они проверяют конфигурацию и бросают обычный `,(0,c.jsx)(t.code,{children:`Error`}),`. Они не проверяют `,(0,c.jsx)(t.code,{children:`File`}),`, не читают байты и автоматически не вызываются из `,(0,c.jsx)(t.code,{children:`readFile`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовые-рецепты`,children:`Готовые рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`обычный-multipart-upload-без-предварительного-чтения`,children:`Обычный multipart upload без предварительного чтения`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если backend принимает `,(0,c.jsx)(t.code,{children:`multipart/form-data`}),`, используйте исходный `,(0,c.jsx)(t.code,{children:`File`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function uploadDocument(file: File) {
+	const body = new FormData();
+	body.append("document", file, file.name);
+
+	const response = await fetch("/api/documents", {
+		method: "POST",
+		body
+	});
+
+	if (!response.ok) {
+		throw new Error(\`Upload failed: \${response.status}\`);
+	}
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readFile`}),` нужен только если перед upload требуется client-side представление, preview или специальный бинарный contract.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`проверить-файл-и-оставить-исходный-file`,children:[`Проверить файл и оставить исходный `,(0,c.jsx)(t.code,{children:`File`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, {
+	allowedMime: ["application/pdf"],
+	maxBytes: 10 * 1024 * 1024,
+	mode: "array-buffer"
+});
+
+const body = new FormData();
+body.append("document", result.file, result.meta.name);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Но помните: чтение буфера уже создало полную дополнительную копию файла в памяти. Не делайте этого без необходимости.`}),`
+`,(0,c.jsx)(t.h3,{id:`безопасно-разобрать-union-результата`,children:`Безопасно разобрать union результата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function describeResult(result: ReadFileResult): string {
+	if (result.mode === "data-url") {
+		return \`Data URL length: \${result.dataUrl.length}\`;
+	}
+
+	return \`Buffer bytes: \${result.buffer.byteLength}\`;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`preview-изображения-с-проверкой-размеров`,children:`Preview изображения с проверкой размеров`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function validateAvatar(file: File) {
+	const result = await readImageFile(file, {
+		allowedMime: ["image/jpeg", "image/png", "image/webp"],
+		maxBytes: 2 * 1024 * 1024
+	});
+
+	if (!result.dimensions) {
+		throw new Error("Не удалось определить размеры изображения");
+	}
+
+	const { width, height } = result.dimensions;
+
+	if (width < 256 || height < 256) {
+		throw new Error("Изображение должно быть не меньше 256 × 256 пикселей");
+	}
+
+	if (width * height > 16_000_000) {
+		throw new Error("Изображение содержит слишком много пикселей");
+	}
+
+	return result;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Проверка после decode полезна для UX, но backend всё равно должен проверять файл сам.`}),`
+`,(0,c.jsx)(t.h3,{id:`последовательная-обработка-нескольких-файлов`,children:`Последовательная обработка нескольких файлов`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`async function readDocuments(files: readonly File[]) {
+	const results: ReadFileResult[] = [];
+
+	for (const file of files) {
+		try {
+			const result = await readFile(file, {
+				mode: "array-buffer",
+				allowedMime: ["application/pdf"],
+				maxBytes: 10 * 1024 * 1024
+			});
+
+			results.push(result);
+		} catch (error) {
+			console.error(\`Не удалось прочитать \${file.name}\`, error);
+		}
+	}
+
+	return results;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Последовательное чтение ограничивает пик одновременной памяти. `,(0,c.jsx)(t.code,{children:`Promise.all(files.map(...))`}),` запускает все `,(0,c.jsx)(t.code,{children:`FileReader`}),` сразу и может быть тяжёлым для больших файлов.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`mime-и-content-disposition-для-response`,children:[`MIME и `,(0,c.jsx)(t.code,{children:`Content-Disposition`}),` для response`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function createDownloadHeaders(fileName: string): Headers {
+	const dotIndex = fileName.lastIndexOf(".");
+	const extension = dotIndex >= 0 ? fileName.slice(dotIndex + 1) : "";
+
+	return new Headers({
+		"Content-Type": resolveMimeTypeByExtension(extension),
+		"Content-Disposition": createContentDispositionHeader({
+			disposition: "attachment",
+			filename: fileName,
+			asciiFallback: "download.bin"
+		})
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это определяет MIME только по имени. Для server response надёжнее использовать подтверждённый MIME из trusted storage/parser, если он доступен.`}),`
+`,(0,c.jsx)(t.h3,{id:`скачать-прочитанный-файл`,children:`Скачать прочитанный файл`}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`/file`}),` читает, но не скачивает. Для `,(0,c.jsx)(t.code,{children:`Blob`}),` используйте `,(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";
+import { readFile } from "@ryuzaki13/react-foundation-lib/file";
+
+const result = await readFile(file, { mode: "array-buffer" });
+const blob = new Blob([result.buffer], { type: result.meta.mime });
+
+downloadFileFromBlob(blob, result.meta.name);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если у вас уже есть исходный `,(0,c.jsx)(t.code,{children:`File`}),`, он сам является `,(0,c.jsx)(t.code,{children:`Blob`}),`, поэтому повторное чтение обычно не нужно:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`downloadFileFromBlob(file, file.name);
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`безопасность`,children:`Безопасность`}),`
+`,(0,c.jsx)(t.h3,{id:`client-side-проверка-не-является-защитой-backend`,children:`Client-side проверка не является защитой backend`}),`
+`,(0,c.jsx)(t.p,{children:`Пользователь контролирует browser request. Он может:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`изменить filename;`}),`
+`,(0,c.jsx)(t.li,{children:`изменить MIME;`}),`
+`,(0,c.jsx)(t.li,{children:`обойти UI;`}),`
+`,(0,c.jsx)(t.li,{children:`отправить request напрямую;`}),`
+`,(0,c.jsx)(t.li,{children:`поместить недопустимые байты в разрешённое расширение.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Backend обязан повторно проверить:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`authentication и authorization;`}),`
+`,(0,c.jsx)(t.li,{children:`размер request/file;`}),`
+`,(0,c.jsx)(t.li,{children:`реальный формат;`}),`
+`,(0,c.jsx)(t.li,{children:`допустимый MIME;`}),`
+`,(0,c.jsx)(t.li,{children:`структуру содержимого;`}),`
+`,(0,c.jsx)(t.li,{children:`имя и storage key;`}),`
+`,(0,c.jsx)(t.li,{children:`антивирусную/контентную policy, если она нужна продукту.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`filetype-недоверенный`,children:[(0,c.jsx)(t.code,{children:`File.type`}),` недоверенный`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`allowedMime`}),` сравнивает только `,(0,c.jsx)(t.code,{children:`file.type`}),`. Модуль не открывает заголовок файла, чтобы подтвердить PNG/PDF/ZIP signature.`]}),`
+`,(0,c.jsx)(t.h3,{id:`расширение-недоверенное`,children:`Расширение недоверенное`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension('pdf')`}),` всегда вернёт `,(0,c.jsx)(t.code,{children:`application/pdf`}),`, даже если реальные байты являются executable. Это mapping, не detector.`]}),`
+`,(0,c.jsx)(t.h3,{id:`svg-требует-отдельной-policy`,children:`SVG требует отдельной policy`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ImageMime`}),` включает `,(0,c.jsx)(t.code,{children:`image/svg+xml`}),`. SVG является активным XML-based форматом и может содержать ссылки и поведение, опасное в некоторых контекстах embedding/rendering. Не считайте разрешённый MIME достаточной sanitization.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если продукту не нужен SVG, не добавляйте его в `,(0,c.jsx)(t.code,{children:`allowedMime`}),`. Если нужен — применяйте отдельную доверенную sanitization и строгую content security policy.`]}),`
+`,(0,c.jsx)(t.h3,{id:`размер-файла-не-равен-размеру-после-decode`,children:`Размер файла не равен размеру после decode`}),`
+`,(0,c.jsx)(t.p,{children:`Маленький compressed image может развернуться в огромный bitmap. Например, приблизительная память RGBA:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`width × height × 4 bytes
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Изображение 10 000 × 10 000 может потребовать около 400 MB только для пикселей. Ограничивайте не только `,(0,c.jsx)(t.code,{children:`maxBytes`}),`, но и dimensions/pixel count после decode; backend должен делать собственную проверку до тяжёлой обработки.`]}),`
+`,(0,c.jsx)(t.h3,{id:`filename-и-header-injection`,children:`Filename и header injection`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`sanitizeFileName`}),` заменяет CR/LF и кавычки для header-сценария. Это снижает риск сырого переноса строки в создаваемом filename, но не делает значение безопасным filesystem path.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте короткий управляемый `,(0,c.jsx)(t.code,{children:`asciiFallback`}),` на случай пустого имени. Не ожидайте, что он переопределит legacy-вариант непустого Unicode filename. Не разрешайте внешнему input управлять `,(0,c.jsx)(t.code,{children:`disposition`}),` через unsafe cast.`]}),`
+`,(0,c.jsx)(t.h3,{id:`data-url-может-содержать-чувствительные-данные`,children:`Data URL может содержать чувствительные данные`}),`
+`,(0,c.jsx)(t.p,{children:`Не отправляйте data URL в analytics, logs или error reports. Он содержит весь файл. Не вставляйте произвольный data URL в опасные execution contexts.`}),`
+`,(0,c.jsx)(t.h2,{id:`производительность-и-память`,children:`Производительность и память`}),`
+`,(0,c.jsxs)(t.h3,{id:`filereader-читает-файл-целиком`,children:[(0,c.jsx)(t.code,{children:`FileReader`}),` читает файл целиком`]}),`
+`,(0,c.jsx)(t.p,{children:`Оба режима создают полное представление данных в памяти:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`array-buffer`}),` — буфер размером примерно с файл;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`data-url`}),` — большая строка с base64;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`результат также сохраняет ссылку на исходный `,(0,c.jsx)(t.code,{children:`File`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для очень больших файлов нужен streaming/chunked API, которого в этом модуле нет.`}),`
+`,(0,c.jsx)(t.h3,{id:`data-url-дороже`,children:`Data URL дороже`}),`
+`,(0,c.jsx)(t.p,{children:`Base64 обычно увеличивает payload примерно на 33%, затем JavaScript engine хранит строку в своём внутреннем формате. Не держите несколько больших data URLs в React state, query cache или global store.`}),`
+`,(0,c.jsx)(t.h3,{id:`изображение-декодируется-дополнительно`,children:`Изображение декодируется дополнительно`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),` в data URL режиме одновременно может удерживать:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`исходный `,(0,c.jsx)(t.code,{children:`File`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`data URL;`}),`
+`,(0,c.jsx)(t.li,{children:`decoded image bitmap;`}),`
+`,(0,c.jsx)(t.li,{children:`объект результата.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Устанавливайте небольшой `,(0,c.jsx)(t.code,{children:`maxBytes`}),`, ограничивайте dimensions и освобождайте ненужные ссылки.`]}),`
+`,(0,c.jsx)(t.h3,{id:`несколько-файлов`,children:`Несколько файлов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Не запускайте неограниченный `,(0,c.jsx)(t.code,{children:`Promise.all`}),` для большого списка. Используйте последовательную или ограниченно-параллельную обработку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`upload-без-чтения`,children:`Upload без чтения`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`fetch`}),`/`,(0,c.jsx)(t.code,{children:`FormData`}),` умеют отправить `,(0,c.jsx)(t.code,{children:`File`}),` напрямую. Это часто быстрее и экономнее, чем `,(0,c.jsx)(t.code,{children:`File → ArrayBuffer → Blob → upload`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`что-тестировать-у-consumer`,children:`Что тестировать у consumer`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`отсутствие выбранного файла;`}),`
+`,(0,c.jsx)(t.li,{children:`допустимый MIME;`}),`
+`,(0,c.jsx)(t.li,{children:`запрещённый MIME;`}),`
+`,(0,c.jsxs)(t.li,{children:[`размер меньше, равный и больше `,(0,c.jsx)(t.code,{children:`maxBytes`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`оба режима результата;`}),`
+`,(0,c.jsx)(t.li,{children:`abort до начала и во время чтения;`}),`
+`,(0,c.jsxs)(t.li,{children:[`обработку каждого `,(0,c.jsx)(t.code,{children:`ReadFileError.code`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`отдельную обработку `,(0,c.jsx)(t.code,{children:`ReadImageError`}),` и `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`decode failure изображения;`}),`
+`,(0,c.jsxs)(t.li,{children:[`Unicode filename в `,(0,c.jsx)(t.code,{children:`Content-Disposition`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`неизвестное расширение MIME resolver.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h3,{id:`создание-file-в-browser-like-тесте`,children:[`Создание `,(0,c.jsx)(t.code,{children:`File`}),` в browser-like тесте`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const file = new File([new Uint8Array([1, 2, 3])], "example.bin", {
+	type: "application/octet-stream",
+	lastModified: 1_700_000_000_000
+});
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`проверка-readfile`,children:[`Проверка `,(0,c.jsx)(t.code,{children:`readFile`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("читает файл как ArrayBuffer", async () => {
+	const file = new File([new Uint8Array([1, 2, 3])], "example.bin", {
+		type: "application/octet-stream"
+	});
+
+	const result = await readFile(file, { mode: "array-buffer" });
+
+	expect(result.mode).toBe("array-buffer");
+	expect([...new Uint8Array(result.buffer)]).toEqual([1, 2, 3]);
+	expect(result.file).toBe(file);
+	expect(result.meta.name).toBe("example.bin");
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-ошибки-размера`,children:`Проверка ошибки размера`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("отклоняет слишком большой файл", async () => {
+	const file = new File([new Uint8Array([1, 2, 3])], "example.bin");
+
+	await expect(readFile(file, { maxBytes: 2 })).rejects.toMatchObject({
+		name: "ReadFileError",
+		code: "FILE_TOO_LARGE"
+	});
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-pure-helpers`,children:`Проверка pure helpers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(resolveMimeTypeByExtension(" PDF ")).toBe("application/pdf");
+expect(resolveMimeTypeByExtension("csv")).toBe("application/octet-stream");
+
+const contentDisposition = createContentDispositionHeader({
+	disposition: "attachment",
+	filename: "Отчёт.pdf",
+	asciiFallback: "report.pdf"
+});
+
+expect(contentDisposition).toContain('filename="_____.pdf"');
+expect(contentDisposition).toContain("filename*=UTF-8''%D0%9E");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`особенности-test-environment`,children:`Особенности test environment`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`в Node environment может не быть `,(0,c.jsx)(t.code,{children:`FileReader`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`jsdom может реализовать не все детали browser decode;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),` использует глобальный `,(0,c.jsx)(t.code,{children:`Image`}),`, который обычно требуется mock;`]}),`
+`,(0,c.jsx)(t.li,{children:`не подменяйте только типы: тест должен иметь runtime implementation;`}),`
+`,(0,c.jsxs)(t.li,{children:[`browser integration test надёжнее проверяет реальный `,(0,c.jsx)(t.code,{children:`Image.onload`}),` и data URL.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для unit test `,(0,c.jsx)(t.code,{children:`readImageFile`}),` можно подменить `,(0,c.jsx)(t.code,{children:`globalThis.Image`}),` контролируемым fake, который вызывает `,(0,c.jsx)(t.code,{children:`onload`}),`/`,(0,c.jsx)(t.code,{children:`onerror`}),` и задаёт `,(0,c.jsx)(t.code,{children:`naturalWidth`}),`/`,(0,c.jsx)(t.code,{children:`naturalHeight`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`известные-ограничения`,children:`Известные ограничения`}),`
+`,(0,c.jsx)(t.p,{children:`Это не скрытые детали, а часть фактического поведения, которую consumer должен учитывать:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`accept`}),` внутри `,(0,c.jsx)(t.code,{children:`readFile`}),` использует substring-проверку суффикса и не реализует HTML wildcard semantics.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Непустой `,(0,c.jsx)(t.code,{children:`allowedMime`}),` имеет приоритет и отключает проверку `,(0,c.jsx)(t.code,{children:`accept`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),` игнорирует option `,(0,c.jsx)(t.code,{children:`accept`}),`, хотя поле присутствует в унаследованном типе.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`readImageFile`}),` проверяет `,(0,c.jsx)(t.code,{children:`file.type.startsWith('image/')`}),` регистрозависимо и без `,(0,c.jsx)(t.code,{children:`trim()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`ReadImageError`}),` создаётся только для `,(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`}),`; file errors остаются `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Browser decode error сейчас отклоняет Promise необёрнутым event, а не `,(0,c.jsx)(t.code,{children:`IMAGE_DECODE_FAILED`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Коды `,(0,c.jsx)(t.code,{children:`NO_FILE`}),` и `,(0,c.jsx)(t.code,{children:`IMAGE_DECODE_FAILED`}),` публичны, но текущие основные функции их не создают.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Abort не прерывает ожидание `,(0,c.jsx)(t.code,{children:`Image.onload`}),`/`,(0,c.jsx)(t.code,{children:`Image.onerror`}),` после завершения `,(0,c.jsx)(t.code,{children:`FileReader`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`assertValidAllowedMime`}),` и `,(0,c.jsx)(t.code,{children:`assertValidAccept`}),` не вызываются автоматически.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`maxBytes`}),` не валидируется как положительное конечное число.`]}),`
+`,(0,c.jsx)(t.li,{children:`Файл читается целиком; progress и streaming отсутствуют.`}),`
+`,(0,c.jsx)(t.li,{children:`MIME и extension не сверяются с реальными bytes.`}),`
+`,(0,c.jsx)(t.li,{children:`Resolver принимает только расширение без точки и поддерживает ограниченную таблицу.`}),`
+`,(0,c.jsx)(t.li,{children:`Filename helpers предназначены для header, а не для безопасного filesystem path.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Для нового consumer-кода рекомендуемый безопасный baseline:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, {
+	mode: "array-buffer",
+	allowedMime: ["application/pdf"],
+	maxBytes: 10 * 1024 * 1024,
+	signal
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`А для изображения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readImageFile(file, {
+	allowedMime: ["image/jpeg", "image/png", "image/webp"],
+	maxBytes: 5 * 1024 * 1024,
+	signal
+});
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`краткий-справочник-api`,children:`Краткий справочник API`}),`
+`,(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:`API`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readFile`})}),(0,c.jsxs)(t.td,{children:[`Проверяет и читает `,(0,c.jsx)(t.code,{children:`File`}),` как data URL или `,(0,c.jsx)(t.code,{children:`ArrayBuffer`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readImageFile`})}),(0,c.jsxs)(t.td,{children:[`Проверяет `,(0,c.jsx)(t.code,{children:`image/*`}),`, читает файл и в data URL режиме даёт размеры`]})]})]})]}),`
+`,(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:`API`}),(0,c.jsx)(t.th,{children:`Назначение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`assertValidAllowedMime`})}),(0,c.jsx)(t.td,{children:`Проверяет синтаксис полных MIME без wildcard`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`assertValidAccept`})}),(0,c.jsx)(t.td,{children:`Проверяет синтаксис extension/MIME/wildcard specifiers`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`assertNotAborted`})}),(0,c.jsxs)(t.td,{children:[`Бросает `,(0,c.jsx)(t.code,{children:`READ_ABORTED`}),` для уже отменённого signal`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`attachAbort`})}),(0,c.jsxs)(t.td,{children:[`Связывает signal с `,(0,c.jsx)(t.code,{children:`FileReader.abort()`}),` и возвращает cleanup`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`buildMeta`})}),(0,c.jsxs)(t.td,{children:[`Копирует четыре metadata-поля `,(0,c.jsx)(t.code,{children:`File`}),` в новый объект`]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`mime-и-http-filename`,children:`MIME и HTTP filename`}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension`})}),(0,c.jsx)(t.td,{children:`Известное расширение без точки → MIME или octet-stream`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`sanitizeFileName`})}),(0,c.jsx)(t.td,{children:`Узкая очистка CR/LF/кавычек для header filename`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createAsciiFilenameFallback`})}),(0,c.jsxs)(t.td,{children:[`Printable ASCII fallback для legacy `,(0,c.jsx)(t.code,{children:`filename=`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`encodeFilenameRFC5987`})}),(0,c.jsx)(t.td,{children:`Percent-encode Unicode filename`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createContentDispositionHeader`})}),(0,c.jsxs)(t.td,{children:[`Готовая строка `,(0,c.jsx)(t.code,{children:`inline/attachment; filename=...; filename*=...`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`error-classes`,children:`Error classes`}),`
+`,(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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileError`})}),(0,c.jsxs)(t.td,{children:[`Typed ошибка MIME, размера, отмены или `,(0,c.jsx)(t.code,{children:`FileReader`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageError`})}),(0,c.jsxs)(t.td,{children:[`Отдельная image-ошибка; сейчас основной runtime code — `,(0,c.jsx)(t.code,{children:`NOT_AN_IMAGE`})]})]})]})]}),`
+`,(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:`ReadMode`})}),(0,c.jsxs)(t.td,{children:[`Литералы `,(0,c.jsx)(t.code,{children:`"data-url"`}),` и `,(0,c.jsx)(t.code,{children:`"array-buffer"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`FileMeta`})}),(0,c.jsx)(t.td,{children:`MIME, size, name, lastModified`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileOptionsBase`})}),(0,c.jsx)(t.td,{children:`Общие accept/MIME/size/signal options`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileAsDataUrlOptions`})}),(0,c.jsx)(t.td,{children:`Options режима data URL`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileAsArrayBufferOptions`})}),(0,c.jsx)(t.td,{children:`Options режима ArrayBuffer`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileOptions`})}),(0,c.jsx)(t.td,{children:`Union обоих вариантов options`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileAsDataUrlResult`})}),(0,c.jsxs)(t.td,{children:[`Результат с `,(0,c.jsx)(t.code,{children:`dataUrl`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileAsArrayBufferResult`})}),(0,c.jsxs)(t.td,{children:[`Результат с `,(0,c.jsx)(t.code,{children:`buffer`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileResult`})}),(0,c.jsx)(t.td,{children:`Union обоих результатов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadFileErrorCode`})}),(0,c.jsxs)(t.td,{children:[`Union кодов `,(0,c.jsx)(t.code,{children:`ReadFileError`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`публичные-image-типы`,children:`Публичные image-типы`}),`
+`,(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:`ImageMime`})}),(0,c.jsx)(t.td,{children:`Разрешённый TypeScript union MIME изображений`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ImageDimensions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ width, height }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageOptionsBase`})}),(0,c.jsx)(t.td,{children:`Общие image options`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageAsDataUrlOptions`})}),(0,c.jsx)(t.td,{children:`Image options data URL режима`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageAsArrayBufferOptions`})}),(0,c.jsx)(t.td,{children:`Image options ArrayBuffer режима`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageOptions`})}),(0,c.jsx)(t.td,{children:`Union image options`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageAsDataUrlResult`})}),(0,c.jsx)(t.td,{children:`Data URL result с optional dimensions`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageAsArrayBufferResult`})}),(0,c.jsx)(t.td,{children:`Alias ArrayBuffer file result`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageResult`})}),(0,c.jsx)(t.td,{children:`Union image results`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReadImageErrorCode`})}),(0,c.jsx)(t.td,{children:`File error codes плюс image-specific codes`})]})]})]}),`
+`,(0,c.jsxs)(t.h3,{id:`публичные-типы-content-disposition`,children:[`Публичные типы `,(0,c.jsx)(t.code,{children:`Content-Disposition`})]}),`
+`,(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:`ContentDispositionKind`})}),(0,c.jsxs)(t.td,{children:[`Литералы `,(0,c.jsx)(t.code,{children:`"inline"`}),` и `,(0,c.jsx)(t.code,{children:`"attachment"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ContentDispositionOptions`})}),(0,c.jsx)(t.td,{children:`disposition, Unicode filename, fallback для пустого ASCII-результата`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-readfile-не-видит-выбранный-файл`,children:[`Почему `,(0,c.jsx)(t.code,{children:`readFile`}),` не видит выбранный файл?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала получите элемент `,(0,c.jsx)(t.code,{children:`[0]`}),` и проверьте его:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const file = event.currentTarget.files?.[0];
+
+if (!file) {
+	return;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не передавайте весь `,(0,c.jsx)(t.code,{children:`FileList`}),` и не используйте non-null assertion без проверки.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-typescript-не-даёт-прочитать-buffer`,children:[`Почему TypeScript не даёт прочитать `,(0,c.jsx)(t.code,{children:`buffer`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`В default режиме возвращается data URL. Передайте литеральный mode:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = await readFile(file, { mode: "array-buffer" });
+console.log(result.buffer);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для union сначала проверьте `,(0,c.jsx)(t.code,{children:`result.mode`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-image-не-работает-в-readfile-accept-`,children:[`Почему `,(0,c.jsx)(t.code,{children:`image/*`}),` не работает в `,(0,c.jsx)(t.code,{children:`readFile({ accept })`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущая runtime-проверка `,(0,c.jsx)(t.code,{children:`accept`}),` не повторяет HTML semantics. Для `,(0,c.jsx)(t.code,{children:`photo.png`}),` она ищет строку `,(0,c.jsx)(t.code,{children:`png`}),` внутри каждого specifier, а `,(0,c.jsx)(t.code,{children:`image/*`}),` её не содержит. Используйте HTML `,(0,c.jsx)(t.code,{children:`accept="image/*"`}),` только в picker, а в `,(0,c.jsx)(t.code,{children:`readFile`}),` передайте точный `,(0,c.jsx)(t.code,{children:`allowedMime`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-readimagefile-отклонил-imagepng`,children:[`Почему `,(0,c.jsx)(t.code,{children:`readImageFile`}),` отклонил `,(0,c.jsx)(t.code,{children:`IMAGE/PNG`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Первичная проверка регистрозависимо ожидает начало `,(0,c.jsx)(t.code,{children:`image/`}),`. Обычный браузер обычно создаёт lowercase MIME, но вручную созданный `,(0,c.jsx)(t.code,{children:`File`}),` может содержать другое значение.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-readimagefile-бросил-readfileerror-а-не-readimageerror`,children:[`Почему `,(0,c.jsx)(t.code,{children:`readImageFile`}),` бросил `,(0,c.jsx)(t.code,{children:`ReadFileError`}),`, а не `,(0,c.jsx)(t.code,{children:`ReadImageError`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Потому что функция делегирует MIME, size, abort и чтение в `,(0,c.jsx)(t.code,{children:`readFile`}),` без оборачивания. Обрабатывайте оба error class.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-decode-failure-не-имеет-code-image_decode_failed`,children:[`Почему decode failure не имеет code `,(0,c.jsx)(t.code,{children:`IMAGE_DECODE_FAILED`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Этот code присутствует в публичном типе, но текущий browser `,(0,c.jsx)(t.code,{children:`Image.onerror`}),` отклоняет Promise исходным event. Оставляйте fallback-ветку для неизвестной ошибки.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-читать-file-перед-отправкой-через-formdata`,children:[`Нужно ли читать `,(0,c.jsx)(t.code,{children:`File`}),` перед отправкой через `,(0,c.jsx)(t.code,{children:`FormData`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. `,(0,c.jsx)(t.code,{children:`File`}),` уже является `,(0,c.jsx)(t.code,{children:`Blob`}),` и может быть добавлен напрямую. Читайте файл только для preview, client-side анализа или другого API contract.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-доверять-filetype`,children:[`Можно ли доверять `,(0,c.jsx)(t.code,{children:`file.type`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Это полезная browser metadata для UX, но не security proof. Backend должен проверить реальное содержимое.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-resolvemimetypebyextensionpdf-вернул-octet-stream`,children:[`Почему `,(0,c.jsx)(t.code,{children:`resolveMimeTypeByExtension('.pdf')`}),` вернул octet-stream?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция ожидает `,(0,c.jsx)(t.code,{children:`pdf`}),`, без точки. Она также не принимает полное имя `,(0,c.jsx)(t.code,{children:`report.pdf`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-использовать-sanitizefilename-перед-записью-на-серверный-диск`,children:[`Можно ли использовать `,(0,c.jsx)(t.code,{children:`sanitizeFileName`}),` перед записью на серверный диск?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Helper предназначен для узкой подготовки header filename. Для storage создавайте server-controlled key и применяйте отдельную filesystem policy.`}),`
+`,(0,c.jsx)(t.h3,{id:`что-выбрать-для-preview-data-url-или-object-url`,children:`Что выбрать для preview: data URL или object URL?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Этот модуль возвращает data URL и через него умеет получить dimensions. Для больших файлов object URL обычно экономнее, но его нужно создать через `,(0,c.jsx)(t.code,{children:`URL.createObjectURL(file)`}),` и обязательно освободить через `,(0,c.jsx)(t.code,{children:`URL.revokeObjectURL`}),`. Это отдельный lifecycle, который `,(0,c.jsx)(t.code,{children:`readFile`}),` не управляет.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-читать-очень-большие-файлы`,children:`Можно ли читать очень большие файлы?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Технически `,(0,c.jsx)(t.code,{children:`FileReader`}),` попробует загрузить файл целиком, но это может привести к зависанию или нехватке памяти. Для больших данных используйте streaming/chunked решение и устанавливайте `,(0,c.jsx)(t.code,{children:`maxBytes`}),` до чтения.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-вручную-удалять-listener-abortsignal`,children:[`Нужно ли вручную удалять listener `,(0,c.jsx)(t.code,{children:`AbortSignal`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При обычном использовании `,(0,c.jsx)(t.code,{children:`readFile`}),` — нет: функция снимает listener после `,(0,c.jsx)(t.code,{children:`load`}),`, `,(0,c.jsx)(t.code,{children:`error`}),` или `,(0,c.jsx)(t.code,{children:`abort`}),`. При прямом использовании `,(0,c.jsx)(t.code,{children:`attachAbort`}),` вызывайте возвращённый cleanup самостоятельно.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`возвращается-копия-file`,children:[`Возвращается копия `,(0,c.jsx)(t.code,{children:`File`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Поле `,(0,c.jsx)(t.code,{children:`result.file`}),` ссылается на тот же `,(0,c.jsx)(t.code,{children:`File`}),`. Новый объект создаётся только для `,(0,c.jsx)(t.code,{children:`meta`}),` и прочитанного представления данных.`]})]})}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};