@ryuzaki13/react-foundation-lib 2.34.0 → 2.35.0

package/dist/binary/binaryToBlob.d.ts

@@ -4,6 +4,10 @@
  * Data URL с префиксом `data:*;base64,` поддерживается, сам URL здесь не создаётся.
  */
 export declare const binaryToBlob: (binaryData: string, mimeType?: string, isBase64?: boolean) => Blob;
+/**
+ * Ищет MIME-тип по метаданным или сигнатуре без подстановки значения по умолчанию.
+ */
+export declare const findMimeType: (fileName?: string, binaryData?: string) => string | null;
 /**
  * Определяет MIME-тип по имени файла, data URL или сигнатуре base64-данных.
  *

package/dist/binary/binaryToBlob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binaryToBlob.d.ts","sourceRoot":"","sources":["../../src/binary/binaryToBlob.ts"],"names":[],"mappings":"AAoMA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,WAAU,MAA+B,EAAE,kBAAe,KAAG,IAmB7G,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,MAwBvE,CAAC"}
+{"version":3,"file":"binaryToBlob.d.ts","sourceRoot":"","sources":["../../src/binary/binaryToBlob.ts"],"names":[],"mappings":"AA8MA;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,WAAU,MAA+B,EAAE,kBAAe,KAAG,IAmB7G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,MAAM,GAAG,IAwB9E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,KAAG,MAA6D,CAAC"}

package/dist/binary/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./binaryToBlob";
+export { binaryToBlob, detectMimeType } from "./binaryToBlob";
 export { getBase64DecodedSize } from "./getBase64DecodedSize";
-export * from "./useBinaryFile";
+export { useBinaryFile, type UseBinaryFileResult } from "./useBinaryFile";
 //# sourceMappingURL=index.d.ts.map

package/dist/binary/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/binary/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/binary/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/binary/index.js

@@ -1,32 +1,32 @@
 import { l as e } from "../chunks/utils-DW0Yso1Q.js";
 import { a as t, c as n, d as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "../chunks/mimeTypeConstants-BzONV-b1.js";
 import { t as g } from "../chunks/hasSignatureBytes-D2wO_Myl.js";
-import { useEffect as _, useEffectEvent as v, useState as y } from "react";
+import { useEffect as _, useMemo as v } from "react";
 //#region src/binary/binaryToBlob.ts
-var b = /^data:([^,]*);base64,([\s\S]*)$/i, x = 128, S = 16, C = [
+var y = /^data:([^,]*);base64,([\s\S]*)$/i, b = 128, x = 16, S = [
 	37,
 	80,
 	68,
 	70
-], w = [
+], C = [
 	255,
 	216,
 	255
-], T = [
+], w = [
 	137,
 	80,
 	78,
 	71
-], E = [
+], T = [
 	71,
 	73,
 	70
-], D = [
+], E = [
 	82,
 	73,
 	70,
 	70
-], O = [80, 75], k = {
+], D = [80, 75], O = {
 	bmp: "image/bmp",
 	csv: "text/csv",
 	doc: p,
@@ -48,12 +48,12 @@ var b = /^data:([^,]*);base64,([\s\S]*)$/i, x = 128, S = 16, C = [
 	xlsx: c,
 	xml: a,
 	zip: i
-}, A = (e) => {
+}, k = (e) => {
 	let t = e.replace(/\s/g, "").replace(/-/g, "+").replace(/_/g, "/"), n = t.length % 4;
 	if (n === 1 || !/^[A-Za-z0-9+/]*={0,2}$/.test(t)) throw Error("Некорректный формат base64");
 	return n === 0 ? t : `${t}${"=".repeat(4 - n)}`;
-}, j = (e) => {
-	let t = e.match(b);
+}, A = (e) => {
+	let t = e.match(y);
 	if (!t) return {
 		data: e,
 		mimeType: null
@@ -63,68 +63,72 @@ var b = /^data:([^,]*);base64,([\s\S]*)$/i, x = 128, S = 16, C = [
 		data: r,
 		mimeType: n.split(";")[0].trim() || null
 	};
-}, M = (e) => {
-	let t = j(e);
+}, j = (e) => {
+	let t = A(e);
 	return {
-		data: A(t.data),
+		data: k(t.data),
 		mimeType: t.mimeType
 	};
-}, N = (e) => {
-	let t = e.match(b);
+}, M = (e) => {
+	let t = e.match(y);
 	return t && t[1].split(";")[0].trim() || null;
-}, P = (e) => {
-	let { data: t } = M(e), n = atob(t), r = new Uint8Array(n.length);
+}, N = (e) => {
+	let { data: t } = j(e), n = atob(t), r = new Uint8Array(n.length);
 	for (let e = 0; e < n.length; e++) r[e] = n.charCodeAt(e);
 	return r;
-}, F = (e) => {
+}, P = (e) => {
 	let t = new Uint8Array(e.length);
 	for (let n = 0; n < e.length; n++) t[n] = e.charCodeAt(n);
 	return t;
-}, I = (e) => {
+}, F = (e) => {
 	let t = new ArrayBuffer(e.byteLength);
 	return new Uint8Array(t).set(e), t;
-}, L = (e) => {
+}, I = (e) => {
 	try {
-		let { data: t } = j(e), n = t.slice(0, x);
-		return atob(A(n));
+		let { data: t } = A(e), n = "";
+		for (let e = 0; e < t.length && n.length < b; e++) {
+			let r = t[e];
+			/\s/.test(r) || (n += r);
+		}
+		return atob(k(n));
 	} catch {
 		return null;
 	}
-}, R = (e) => {
-	let t = L(e);
+}, L = (e) => {
+	let t = I(e);
 	if (!t) return null;
 	let n = new Uint8Array(t.length);
 	for (let e = 0; e < t.length; e++) n[e] = t.charCodeAt(e);
-	if (g(n, C)) return s;
-	if (g(n, w)) return f;
-	if (g(n, T)) return o;
-	if (g(n, E)) return l;
-	if (g(n, D)) return u;
-	if (g(n, O)) return i;
-	let r = t.replace(/^\uFEFF/, "").trimStart().slice(0, S);
+	if (g(n, S)) return s;
+	if (g(n, C)) return f;
+	if (g(n, w)) return o;
+	if (g(n, T)) return l;
+	if (g(n, E)) return u;
+	if (g(n, D)) return i;
+	let r = t.replace(/^\uFEFF/, "").trimStart().slice(0, x);
 	return r.startsWith("<?xml") || r.startsWith("<") ? a : null;
-}, z = (e, t = n, r = !0) => {
+}, R = (e, t = n, r = !0) => {
 	if (!e) throw Error("Не переданы бинарные данные");
 	try {
-		let n = r ? P(e) : F(e);
+		let n = r ? N(e) : P(e);
 		if (n.length === 0) throw Error("После преобразования не осталось данных");
-		return new Blob([I(n)], { type: t.trim() || "application/octet-stream" });
+		return new Blob([F(n)], { type: t.trim() || "application/octet-stream" });
 	} catch (e) {
 		throw e instanceof Error ? e : Error("Некорректный формат бинарных данных");
 	}
-}, B = (e, t) => {
+}, z = (e, t) => {
 	if (e) {
 		let t = e.toLowerCase().split(".").pop();
-		if (t && k[t]) return k[t];
+		if (t && O[t]) return O[t];
 	}
 	if (t) {
-		let e = N(t);
+		let e = M(t);
 		if (e) return e;
-		let n = R(t);
+		let n = L(t);
 		if (n) return n;
 	}
-	return s;
-}, V = /[^A-Za-z0-9+/=]/;
+	return null;
+}, B = (e, t) => z(e, t) ?? "application/pdf", V = /[^A-Za-z0-9+/=]/;
 function H(e) {
 	if (e.length % 4 != 0 || V.test(e)) return null;
 	let t = e.endsWith("==") ? 2 : +!!e.endsWith("="), n = e.indexOf("=");
@@ -133,24 +137,39 @@ function H(e) {
 //#endregion
 //#region src/binary/useBinaryFile.ts
 function U(t) {
-	let [n, r] = y(null), [i, a] = y(null), o = v((e) => r(e)), s = v((e) => a(e));
-	return _(() => {
-		if (t) try {
-			let e = B(void 0, t), n = z(t, e, !0);
-			o({
-				blob: n,
-				mime: e
-			}), s(null);
-		} catch (t) {
-			e(t), s(String(t)), o(null);
+	let { data: n, failure: r } = v(() => {
+		if (!t) return {
+			data: null,
+			failure: null
+		};
+		try {
+			let e = z(void 0, t), n = e ?? "application/octet-stream";
+			return {
+				data: {
+					blob: R(t, n, !0),
+					mime: n,
+					isMimeDetected: e !== null
+				},
+				failure: null
+			};
+		} catch (e) {
+			return {
+				data: null,
+				failure: {
+					cause: e,
+					message: String(e)
+				}
+			};
 		}
-		else o(null), s(null);
-	}, [t]), {
+	}, [t]);
+	return _(() => {
+		r && e(r.cause);
+	}, [r]), {
 		data: n,
-		error: i
+		error: r?.message ?? null
 	};
 }
 //#endregion
-export { z as binaryToBlob, B as detectMimeType, H as getBase64DecodedSize, U as useBinaryFile };
+export { R as binaryToBlob, B as detectMimeType, H as getBase64DecodedSize, U as useBinaryFile };
 
 //# sourceMappingURL=index.js.map

package/dist/binary/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/binary/binaryToBlob.ts","../../src/binary/getBase64DecodedSize.ts","../../src/binary/useBinaryFile.ts"],"sourcesContent":["import {\n\tMIME_TYPE_DOCX,\n\tMIME_TYPE_IMAGE_GIF,\n\tMIME_TYPE_IMAGE_JPEG,\n\tMIME_TYPE_IMAGE_PNG,\n\tMIME_TYPE_IMAGE_TIFF,\n\tMIME_TYPE_IMAGE_WEBP,\n\tMIME_TYPE_MSWORD,\n\tMIME_TYPE_OCTET_STREAM,\n\tMIME_TYPE_PDF,\n\tMIME_TYPE_PPT,\n\tMIME_TYPE_PPTX,\n\tMIME_TYPE_XLS,\n\tMIME_TYPE_XLSX,\n\tMIME_TYPE_XML,\n\tMIME_TYPE_ZIP\n} from \"../file/mimeTypeConstants\";\nimport { hasSignatureBytes } from \"../file/signature/hasSignatureBytes\";\n\nimport { BASE64_ENCODED_BLOCK_CHARACTERS, BASE64_PADDING } from \"./base64Constants\";\n\nconst BASE64_DATA_URL_PATTERN = /^data:([^,]*);base64,([\\s\\S]*)$/i;\nconst BASE64_HEADER_SCAN_CHARACTERS = 128;\nconst XML_HEADER_SCAN_CHARACTERS = 16;\n// Здесь распознаётся только прежний короткий prefix, без усиления проверки формата.\nconst PDF_HEADER_PREFIX = [0x25, 0x50, 0x44, 0x46];\nconst JPEG_HEADER_PREFIX = [0xff, 0xd8, 0xff];\nconst PNG_HEADER_PREFIX = [0x89, 0x50, 0x4e, 0x47];\nconst GIF_HEADER_PREFIX = [0x47, 0x49, 0x46];\nconst WEBP_HEADER_PREFIX = [0x52, 0x49, 0x46, 0x46];\nconst ZIP_HEADER_PREFIX = [0x50, 0x4b];\n\nconst MIME_TYPE_BY_EXTENSION: Record<string, string> = {\n\tbmp: \"image/bmp\",\n\tcsv: \"text/csv\",\n\tdoc: MIME_TYPE_MSWORD,\n\tdocx: MIME_TYPE_DOCX,\n\tgif: MIME_TYPE_IMAGE_GIF,\n\tjpeg: MIME_TYPE_IMAGE_JPEG,\n\tjpg: MIME_TYPE_IMAGE_JPEG,\n\tjson: \"application/json\",\n\tpdf: MIME_TYPE_PDF,\n\tpng: MIME_TYPE_IMAGE_PNG,\n\tppt: MIME_TYPE_PPT,\n\tpptx: MIME_TYPE_PPTX,\n\tsvg: \"image/svg+xml\",\n\ttif: MIME_TYPE_IMAGE_TIFF,\n\ttiff: MIME_TYPE_IMAGE_TIFF,\n\ttxt: \"text/plain\",\n\twebp: MIME_TYPE_IMAGE_WEBP,\n\txls: MIME_TYPE_XLS,\n\txlsx: MIME_TYPE_XLSX,\n\txml: MIME_TYPE_XML,\n\tzip: MIME_TYPE_ZIP\n};\n\nconst normalizeBase64 = (value: string): string => {\n\tconst normalized = value.replace(/\\s/g, \"\").replace(/-/g, \"+\").replace(/_/g, \"/\");\n\tconst paddingRest = normalized.length % BASE64_ENCODED_BLOCK_CHARACTERS;\n\n\tif (paddingRest === 1 || !/^[A-Za-z0-9+/]*={0,2}$/.test(normalized)) {\n\t\tthrow new Error(\"Некорректный формат base64\");\n\t}\n\n\treturn paddingRest === 0 ? normalized : `${normalized}${BASE64_PADDING.repeat(BASE64_ENCODED_BLOCK_CHARACTERS - paddingRest)}`;\n};\n\nconst getBase64RawPayload = (binaryData: string): { data: string; mimeType: string | null } => {\n\tconst dataUrlMatch = binaryData.match(BASE64_DATA_URL_PATTERN);\n\n\tif (!dataUrlMatch) {\n\t\treturn { data: binaryData, mimeType: null };\n\t}\n\n\tconst [, rawMimeType, rawData] = dataUrlMatch;\n\tconst mimeType = rawMimeType.split(\";\")[0].trim();\n\n\treturn {\n\t\tdata: rawData,\n\t\tmimeType: mimeType || null\n\t};\n};\n\nconst getBase64Payload = (binaryData: string): { data: string; mimeType: string | null } => {\n\tconst payload = getBase64RawPayload(binaryData);\n\n\treturn {\n\t\tdata: normalizeBase64(payload.data),\n\t\tmimeType: payload.mimeType\n\t};\n};\n\nconst getDataUrlMimeType = (binaryData: string): string | null => {\n\tconst dataUrlMatch = binaryData.match(BASE64_DATA_URL_PATTERN);\n\n\tif (!dataUrlMatch) {\n\t\treturn null;\n\t}\n\n\tconst mimeType = dataUrlMatch[1].split(\";\")[0].trim();\n\n\treturn mimeType || null;\n};\n\nconst decodeBase64ToBytes = (binaryData: string): Uint8Array => {\n\tconst { data } = getBase64Payload(binaryData);\n\tconst binaryString = atob(data);\n\tconst byteArray = new Uint8Array(binaryString.length);\n\n\tfor (let index = 0; index < binaryString.length; index++) {\n\t\tbyteArray[index] = binaryString.charCodeAt(index);\n\t}\n\n\treturn byteArray;\n};\n\nconst binaryStringToBytes = (binaryData: string): Uint8Array => {\n\tconst byteArray = new Uint8Array(binaryData.length);\n\n\tfor (let index = 0; index < binaryData.length; index++) {\n\t\tbyteArray[index] = binaryData.charCodeAt(index);\n\t}\n\n\treturn byteArray;\n};\n\nconst copyBytesToArrayBuffer = (byteArray: Uint8Array): ArrayBuffer => {\n\tconst buffer = new ArrayBuffer(byteArray.byteLength);\n\tconst view = new Uint8Array(buffer);\n\n\tview.set(byteArray);\n\n\treturn buffer;\n};\n\nconst decodeHeaderFromBase64 = (binaryData: string): string | null => {\n\ttry {\n\t\tconst { data } = getBase64RawPayload(binaryData);\n\t\tconst headerData = data.slice(0, BASE64_HEADER_SCAN_CHARACTERS);\n\t\tconst binaryString = atob(normalizeBase64(headerData));\n\n\t\treturn binaryString;\n\t} catch {\n\t\treturn null;\n\t}\n};\n\nconst detectMimeTypeBySignature = (binaryData: string): string | null => {\n\tconst header = decodeHeaderFromBase64(binaryData);\n\n\tif (!header) {\n\t\treturn null;\n\t}\n\n\tconst bytes = new Uint8Array(header.length);\n\n\tfor (let index = 0; index < header.length; index++) {\n\t\tbytes[index] = header.charCodeAt(index);\n\t}\n\n\tif (hasSignatureBytes(bytes, PDF_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_PDF;\n\t}\n\n\tif (hasSignatureBytes(bytes, JPEG_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_JPEG;\n\t}\n\n\tif (hasSignatureBytes(bytes, PNG_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_PNG;\n\t}\n\n\tif (hasSignatureBytes(bytes, GIF_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_GIF;\n\t}\n\n\tif (hasSignatureBytes(bytes, WEBP_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_WEBP;\n\t}\n\n\tif (hasSignatureBytes(bytes, ZIP_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_ZIP;\n\t}\n\n\tconst textHeader = header\n\t\t.replace(/^\\uFEFF/, \"\")\n\t\t.trimStart()\n\t\t.slice(0, XML_HEADER_SCAN_CHARACTERS);\n\n\tif (textHeader.startsWith(\"<?xml\") || textHeader.startsWith(\"<\")) {\n\t\treturn MIME_TYPE_XML;\n\t}\n\n\treturn null;\n};\n\n/**\n * Преобразует base64 или бинарную строку в Blob.\n *\n * Data URL с префиксом `data:*;base64,` поддерживается, сам URL здесь не создаётся.\n */\nexport const binaryToBlob = (binaryData: string, mimeType: string = MIME_TYPE_OCTET_STREAM, isBase64 = true): Blob => {\n\tif (!binaryData) {\n\t\tthrow new Error(\"Не переданы бинарные данные\");\n\t}\n\n\ttry {\n\t\tconst byteArray = isBase64 ? decodeBase64ToBytes(binaryData) : binaryStringToBytes(binaryData);\n\n\t\tif (byteArray.length === 0) {\n\t\t\tthrow new Error(\"После преобразования не осталось данных\");\n\t\t}\n\n\t\treturn new Blob([copyBytesToArrayBuffer(byteArray)], { type: mimeType.trim() || MIME_TYPE_OCTET_STREAM });\n\t} catch (error) {\n\t\tif (error instanceof Error) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new Error(\"Некорректный формат бинарных данных\");\n\t}\n};\n\n/**\n * Определяет MIME-тип по имени файла, data URL или сигнатуре base64-данных.\n *\n * Если определить тип не удалось, используется PDF: большинство документов в этом контуре приходят именно так.\n */\nexport const detectMimeType = (fileName?: string, binaryData?: string): string => {\n\tif (fileName) {\n\t\tconst extension = fileName.toLowerCase().split(\".\").pop();\n\n\t\tif (extension && MIME_TYPE_BY_EXTENSION[extension]) {\n\t\t\treturn MIME_TYPE_BY_EXTENSION[extension];\n\t\t}\n\t}\n\n\tif (binaryData) {\n\t\tconst dataUrlMimeType = getDataUrlMimeType(binaryData);\n\n\t\tif (dataUrlMimeType) {\n\t\t\treturn dataUrlMimeType;\n\t\t}\n\n\t\tconst signatureMimeType = detectMimeTypeBySignature(binaryData);\n\n\t\tif (signatureMimeType) {\n\t\t\treturn signatureMimeType;\n\t\t}\n\t}\n\n\treturn MIME_TYPE_PDF;\n};\n","import { BASE64_DECODED_BLOCK_BYTES, BASE64_DOUBLE_PADDING, BASE64_ENCODED_BLOCK_CHARACTERS, BASE64_PADDING } from \"./base64Constants\";\n\nconst INVALID_BASE64_CHARACTER_PATTERN = /[^A-Za-z0-9+/=]/;\n\n/**\n * Проверяет стандартную Base64-форму и считает байты без декодирования или создания Buffer/Blob.\n * Невалидный payload возвращает null, пустая строка — 0; допустимый размер определяет вызывающий контракт.\n * Data URL, whitespace, URL-safe алфавит и отсутствующий padding здесь не нормализуются.\n */\nexport function getBase64DecodedSize(value: string): number | null {\n\tif (value.length % BASE64_ENCODED_BLOCK_CHARACTERS !== 0 || INVALID_BASE64_CHARACTER_PATTERN.test(value)) return null;\n\tconst paddingLength = value.endsWith(BASE64_DOUBLE_PADDING) ? 2 : value.endsWith(BASE64_PADDING) ? 1 : 0;\n\tconst firstPaddingIndex = value.indexOf(BASE64_PADDING);\n\tif (firstPaddingIndex !== -1 && firstPaddingIndex !== value.length - paddingLength) return null;\n\treturn Math.floor((value.length * BASE64_DECODED_BLOCK_BYTES) / BASE64_ENCODED_BLOCK_CHARACTERS) - paddingLength;\n}\n","import { useEffect, useEffectEvent, useState } from \"react\";\n\nimport { logError } from \"../utils\";\n\nimport { binaryToBlob, detectMimeType } from \"./binaryToBlob\";\n\nexport function useBinaryFile(bin: string | undefined) {\n\tconst [entry, setEntry] = useState<{ blob: Blob; mime: string } | null>(null);\n\tconst [error, setError] = useState<string | null>(null);\n\n\tconst updateEntry = useEffectEvent((data: { blob: Blob; mime: string } | null) => setEntry(data));\n\tconst updateError = useEffectEvent((error: string | null) => setError(error));\n\n\tuseEffect(() => {\n\t\tif (bin) {\n\t\t\ttry {\n\t\t\t\tconst mime = detectMimeType(undefined, bin);\n\t\t\t\tconst blob = binaryToBlob(bin, mime, true);\n\n\t\t\t\tupdateEntry({ blob, mime });\n\t\t\t\tupdateError(null);\n\t\t\t} catch (e) {\n\t\t\t\tlogError(e);\n\n\t\t\t\tupdateError(String(e));\n\t\t\t\tupdateEntry(null);\n\t\t\t}\n\t\t} else {\n\t\t\tupdateEntry(null);\n\t\t\tupdateError(null);\n\t\t}\n\t}, [bin]);\n\n\treturn { data: entry, error };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/binary/binaryToBlob.ts","../../src/binary/getBase64DecodedSize.ts","../../src/binary/useBinaryFile.ts"],"sourcesContent":["import {\n\tMIME_TYPE_DOCX,\n\tMIME_TYPE_IMAGE_GIF,\n\tMIME_TYPE_IMAGE_JPEG,\n\tMIME_TYPE_IMAGE_PNG,\n\tMIME_TYPE_IMAGE_TIFF,\n\tMIME_TYPE_IMAGE_WEBP,\n\tMIME_TYPE_MSWORD,\n\tMIME_TYPE_OCTET_STREAM,\n\tMIME_TYPE_PDF,\n\tMIME_TYPE_PPT,\n\tMIME_TYPE_PPTX,\n\tMIME_TYPE_XLS,\n\tMIME_TYPE_XLSX,\n\tMIME_TYPE_XML,\n\tMIME_TYPE_ZIP\n} from \"../file/mimeTypeConstants\";\nimport { hasSignatureBytes } from \"../file/signature/hasSignatureBytes\";\n\nimport { BASE64_ENCODED_BLOCK_CHARACTERS, BASE64_PADDING } from \"./base64Constants\";\n\nconst BASE64_DATA_URL_PATTERN = /^data:([^,]*);base64,([\\s\\S]*)$/i;\nconst BASE64_HEADER_SCAN_CHARACTERS = 128;\nconst XML_HEADER_SCAN_CHARACTERS = 16;\n// Здесь распознаётся только прежний короткий prefix, без усиления проверки формата.\nconst PDF_HEADER_PREFIX = [0x25, 0x50, 0x44, 0x46];\nconst JPEG_HEADER_PREFIX = [0xff, 0xd8, 0xff];\nconst PNG_HEADER_PREFIX = [0x89, 0x50, 0x4e, 0x47];\nconst GIF_HEADER_PREFIX = [0x47, 0x49, 0x46];\nconst WEBP_HEADER_PREFIX = [0x52, 0x49, 0x46, 0x46];\nconst ZIP_HEADER_PREFIX = [0x50, 0x4b];\n\nconst MIME_TYPE_BY_EXTENSION: Record<string, string> = {\n\tbmp: \"image/bmp\",\n\tcsv: \"text/csv\",\n\tdoc: MIME_TYPE_MSWORD,\n\tdocx: MIME_TYPE_DOCX,\n\tgif: MIME_TYPE_IMAGE_GIF,\n\tjpeg: MIME_TYPE_IMAGE_JPEG,\n\tjpg: MIME_TYPE_IMAGE_JPEG,\n\tjson: \"application/json\",\n\tpdf: MIME_TYPE_PDF,\n\tpng: MIME_TYPE_IMAGE_PNG,\n\tppt: MIME_TYPE_PPT,\n\tpptx: MIME_TYPE_PPTX,\n\tsvg: \"image/svg+xml\",\n\ttif: MIME_TYPE_IMAGE_TIFF,\n\ttiff: MIME_TYPE_IMAGE_TIFF,\n\ttxt: \"text/plain\",\n\twebp: MIME_TYPE_IMAGE_WEBP,\n\txls: MIME_TYPE_XLS,\n\txlsx: MIME_TYPE_XLSX,\n\txml: MIME_TYPE_XML,\n\tzip: MIME_TYPE_ZIP\n};\n\nconst normalizeBase64 = (value: string): string => {\n\tconst normalized = value.replace(/\\s/g, \"\").replace(/-/g, \"+\").replace(/_/g, \"/\");\n\tconst paddingRest = normalized.length % BASE64_ENCODED_BLOCK_CHARACTERS;\n\n\tif (paddingRest === 1 || !/^[A-Za-z0-9+/]*={0,2}$/.test(normalized)) {\n\t\tthrow new Error(\"Некорректный формат base64\");\n\t}\n\n\treturn paddingRest === 0 ? normalized : `${normalized}${BASE64_PADDING.repeat(BASE64_ENCODED_BLOCK_CHARACTERS - paddingRest)}`;\n};\n\nconst getBase64RawPayload = (binaryData: string): { data: string; mimeType: string | null } => {\n\tconst dataUrlMatch = binaryData.match(BASE64_DATA_URL_PATTERN);\n\n\tif (!dataUrlMatch) {\n\t\treturn { data: binaryData, mimeType: null };\n\t}\n\n\tconst [, rawMimeType, rawData] = dataUrlMatch;\n\tconst mimeType = rawMimeType.split(\";\")[0].trim();\n\n\treturn {\n\t\tdata: rawData,\n\t\tmimeType: mimeType || null\n\t};\n};\n\nconst getBase64Payload = (binaryData: string): { data: string; mimeType: string | null } => {\n\tconst payload = getBase64RawPayload(binaryData);\n\n\treturn {\n\t\tdata: normalizeBase64(payload.data),\n\t\tmimeType: payload.mimeType\n\t};\n};\n\nconst getDataUrlMimeType = (binaryData: string): string | null => {\n\tconst dataUrlMatch = binaryData.match(BASE64_DATA_URL_PATTERN);\n\n\tif (!dataUrlMatch) {\n\t\treturn null;\n\t}\n\n\tconst mimeType = dataUrlMatch[1].split(\";\")[0].trim();\n\n\treturn mimeType || null;\n};\n\nconst decodeBase64ToBytes = (binaryData: string): Uint8Array => {\n\tconst { data } = getBase64Payload(binaryData);\n\tconst binaryString = atob(data);\n\tconst byteArray = new Uint8Array(binaryString.length);\n\n\tfor (let index = 0; index < binaryString.length; index++) {\n\t\tbyteArray[index] = binaryString.charCodeAt(index);\n\t}\n\n\treturn byteArray;\n};\n\nconst binaryStringToBytes = (binaryData: string): Uint8Array => {\n\tconst byteArray = new Uint8Array(binaryData.length);\n\n\tfor (let index = 0; index < binaryData.length; index++) {\n\t\tbyteArray[index] = binaryData.charCodeAt(index);\n\t}\n\n\treturn byteArray;\n};\n\nconst copyBytesToArrayBuffer = (byteArray: Uint8Array): ArrayBuffer => {\n\tconst buffer = new ArrayBuffer(byteArray.byteLength);\n\tconst view = new Uint8Array(buffer);\n\n\tview.set(byteArray);\n\n\treturn buffer;\n};\n\nconst decodeHeaderFromBase64 = (binaryData: string): string | null => {\n\ttry {\n\t\tconst { data } = getBase64RawPayload(binaryData);\n\t\tlet headerData = \"\";\n\n\t\t// Пробелы и переносы допустимы в Base64 и не должны обрывать блок заголовка.\n\t\tfor (let index = 0; index < data.length && headerData.length < BASE64_HEADER_SCAN_CHARACTERS; index++) {\n\t\t\tconst character = data[index];\n\n\t\t\tif (!/\\s/.test(character)) {\n\t\t\t\theaderData += character;\n\t\t\t}\n\t\t}\n\n\t\tconst binaryString = atob(normalizeBase64(headerData));\n\n\t\treturn binaryString;\n\t} catch {\n\t\treturn null;\n\t}\n};\n\nconst detectMimeTypeBySignature = (binaryData: string): string | null => {\n\tconst header = decodeHeaderFromBase64(binaryData);\n\n\tif (!header) {\n\t\treturn null;\n\t}\n\n\tconst bytes = new Uint8Array(header.length);\n\n\tfor (let index = 0; index < header.length; index++) {\n\t\tbytes[index] = header.charCodeAt(index);\n\t}\n\n\tif (hasSignatureBytes(bytes, PDF_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_PDF;\n\t}\n\n\tif (hasSignatureBytes(bytes, JPEG_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_JPEG;\n\t}\n\n\tif (hasSignatureBytes(bytes, PNG_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_PNG;\n\t}\n\n\tif (hasSignatureBytes(bytes, GIF_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_GIF;\n\t}\n\n\tif (hasSignatureBytes(bytes, WEBP_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_IMAGE_WEBP;\n\t}\n\n\tif (hasSignatureBytes(bytes, ZIP_HEADER_PREFIX)) {\n\t\treturn MIME_TYPE_ZIP;\n\t}\n\n\tconst textHeader = header\n\t\t.replace(/^\\uFEFF/, \"\")\n\t\t.trimStart()\n\t\t.slice(0, XML_HEADER_SCAN_CHARACTERS);\n\n\tif (textHeader.startsWith(\"<?xml\") || textHeader.startsWith(\"<\")) {\n\t\treturn MIME_TYPE_XML;\n\t}\n\n\treturn null;\n};\n\n/**\n * Преобразует base64 или бинарную строку в Blob.\n *\n * Data URL с префиксом `data:*;base64,` поддерживается, сам URL здесь не создаётся.\n */\nexport const binaryToBlob = (binaryData: string, mimeType: string = MIME_TYPE_OCTET_STREAM, isBase64 = true): Blob => {\n\tif (!binaryData) {\n\t\tthrow new Error(\"Не переданы бинарные данные\");\n\t}\n\n\ttry {\n\t\tconst byteArray = isBase64 ? decodeBase64ToBytes(binaryData) : binaryStringToBytes(binaryData);\n\n\t\tif (byteArray.length === 0) {\n\t\t\tthrow new Error(\"После преобразования не осталось данных\");\n\t\t}\n\n\t\treturn new Blob([copyBytesToArrayBuffer(byteArray)], { type: mimeType.trim() || MIME_TYPE_OCTET_STREAM });\n\t} catch (error) {\n\t\tif (error instanceof Error) {\n\t\t\tthrow error;\n\t\t}\n\t\tthrow new Error(\"Некорректный формат бинарных данных\");\n\t}\n};\n\n/**\n * Ищет MIME-тип по метаданным или сигнатуре без подстановки значения по умолчанию.\n */\nexport const findMimeType = (fileName?: string, binaryData?: string): string | null => {\n\tif (fileName) {\n\t\tconst extension = fileName.toLowerCase().split(\".\").pop();\n\n\t\tif (extension && MIME_TYPE_BY_EXTENSION[extension]) {\n\t\t\treturn MIME_TYPE_BY_EXTENSION[extension];\n\t\t}\n\t}\n\n\tif (binaryData) {\n\t\tconst dataUrlMimeType = getDataUrlMimeType(binaryData);\n\n\t\tif (dataUrlMimeType) {\n\t\t\treturn dataUrlMimeType;\n\t\t}\n\n\t\tconst signatureMimeType = detectMimeTypeBySignature(binaryData);\n\n\t\tif (signatureMimeType) {\n\t\t\treturn signatureMimeType;\n\t\t}\n\t}\n\n\treturn null;\n};\n\n/**\n * Определяет MIME-тип по имени файла, data URL или сигнатуре base64-данных.\n *\n * Если определить тип не удалось, используется PDF: большинство документов в этом контуре приходят именно так.\n */\nexport const detectMimeType = (fileName?: string, binaryData?: string): string => findMimeType(fileName, binaryData) ?? MIME_TYPE_PDF;\n","import { BASE64_DECODED_BLOCK_BYTES, BASE64_DOUBLE_PADDING, BASE64_ENCODED_BLOCK_CHARACTERS, BASE64_PADDING } from \"./base64Constants\";\n\nconst INVALID_BASE64_CHARACTER_PATTERN = /[^A-Za-z0-9+/=]/;\n\n/**\n * Проверяет стандартную Base64-форму и считает байты без декодирования или создания Buffer/Blob.\n * Невалидный payload возвращает null, пустая строка — 0; допустимый размер определяет вызывающий контракт.\n * Data URL, whitespace, URL-safe алфавит и отсутствующий padding здесь не нормализуются.\n */\nexport function getBase64DecodedSize(value: string): number | null {\n\tif (value.length % BASE64_ENCODED_BLOCK_CHARACTERS !== 0 || INVALID_BASE64_CHARACTER_PATTERN.test(value)) return null;\n\tconst paddingLength = value.endsWith(BASE64_DOUBLE_PADDING) ? 2 : value.endsWith(BASE64_PADDING) ? 1 : 0;\n\tconst firstPaddingIndex = value.indexOf(BASE64_PADDING);\n\tif (firstPaddingIndex !== -1 && firstPaddingIndex !== value.length - paddingLength) return null;\n\treturn Math.floor((value.length * BASE64_DECODED_BLOCK_BYTES) / BASE64_ENCODED_BLOCK_CHARACTERS) - paddingLength;\n}\n","import { useEffect, useMemo } from \"react\";\n\nimport { MIME_TYPE_OCTET_STREAM } from \"../file/mimeTypeConstants\";\nimport { logError } from \"../utils\";\n\nimport { binaryToBlob, findMimeType } from \"./binaryToBlob\";\n\ntype BinaryFileData = {\n\tblob: Blob;\n\tmime: string;\n\t/** MIME взят из data URL или определён по сигнатуре. Значение false обозначает подстановку нейтрального MIME. */\n\tisMimeDetected: boolean;\n};\n\nexport type UseBinaryFileResult = {\n\tdata: BinaryFileData | null;\n\terror: string | null;\n};\n\n/**\n * Декодирует текущий bin при рендере. Мемоизация позволяет просмотрщику\n * переиспользовать Blob при повторном рендере с тем же входом.\n */\nexport function useBinaryFile(bin: string | undefined): UseBinaryFileResult {\n\tconst { data, failure } = useMemo(() => {\n\t\tif (!bin) {\n\t\t\treturn { data: null, failure: null };\n\t\t}\n\n\t\ttry {\n\t\t\tconst detectedMime = findMimeType(undefined, bin);\n\t\t\tconst mime = detectedMime ?? MIME_TYPE_OCTET_STREAM;\n\t\t\tconst blob = binaryToBlob(bin, mime, true);\n\n\t\t\treturn { data: { blob, mime, isMimeDetected: detectedMime !== null }, failure: null };\n\t\t} catch (cause) {\n\t\t\treturn { data: null, failure: { cause, message: String(cause) } };\n\t\t}\n\t}, [bin]);\n\n\tuseEffect(() => {\n\t\tif (failure) {\n\t\t\tlogError(failure.cause);\n\t\t}\n\t}, [failure]);\n\n\treturn { data, error: failure?.message ?? null };\n}\n"],"mappings":"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"}

package/dist/binary/useBinaryFile.d.ts

@@ -1,8 +1,17 @@
-export declare function useBinaryFile(bin: string | undefined): {
-    data: {
-        blob: Blob;
-        mime: string;
-    } | null;
+type BinaryFileData = {
+    blob: Blob;
+    mime: string;
+    /** MIME взят из data URL или определён по сигнатуре. Значение false обозначает подстановку нейтрального MIME. */
+    isMimeDetected: boolean;
+};
+export type UseBinaryFileResult = {
+    data: BinaryFileData | null;
     error: string | null;
 };
+/**
+ * Декодирует текущий bin при рендере. Мемоизация позволяет просмотрщику
+ * переиспользовать Blob при повторном рендере с тем же входом.
+ */
+export declare function useBinaryFile(bin: string | undefined): UseBinaryFileResult;
+export {};
 //# sourceMappingURL=useBinaryFile.d.ts.map

package/dist/binary/useBinaryFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBinaryFile.d.ts","sourceRoot":"","sources":["../../src/binary/useBinaryFile.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;;cACT,IAAI;cAAQ,MAAM;;;EA2B7D"}
+{"version":3,"file":"useBinaryFile.d.ts","sourceRoot":"","sources":["../../src/binary/useBinaryFile.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iHAAiH;IACjH,cAAc,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAwB1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ryuzaki13/react-foundation-lib",
-	"version": "2.34.0",
+	"version": "2.35.0",
 	"description": "Reusable React and TypeScript foundation utilities, hooks, and primitives.",
 	"license": "MIT",
 	"author": "Ryuzaki13",

package/src/binary/README.mdx

@@ -4,7 +4,7 @@ import { Meta } from "@storybook/addon-docs/blocks";
 
 # Работа с бинарными данными
 
-Модуль `binary` преобразует строковое бинарное содержимое в браузерный `Blob`, определяет предполагаемый MIME-тип документа и предоставляет React hook для типового сценария «base64 → `{ blob, mime }`». Отдельная pure function `getBase64DecodedSize` проверяет стандартный Base64 payload и считает размер без декодирования в browser или server runtime.
+Модуль `binary` преобразует строковое бинарное содержимое в браузерный `Blob`, определяет предполагаемый MIME-тип документа и предоставляет React hook, результат которого показывает, удалось ли определить MIME. Отдельная pure function `getBase64DecodedSize` проверяет стандартный Base64 payload и считает размер без декодирования в browser или server runtime.
 
 Основной сценарий:
 
@@ -278,7 +278,7 @@ const raw = String.fromCharCode(65, 66, 67);
 | Превратить base64 data URL в `Blob`                    | `binaryToBlob`                                    |
 | Превратить raw binary string в `Blob`                  | `binaryToBlob(..., ..., false)`                   |
 | Предположить MIME по имени и данным                    | `detectMimeType`                                  |
-| В React получить `{ blob, mime }` из base64 prop/state | `useBinaryFile`                                   |
+| В React получить `Blob` и результат определения MIME   | `useBinaryFile`                                   |
 | Скачать готовый `Blob`                                 | `downloadFileFromBlob` из `/dom`                  |
 | Прочитать пользовательский `File`                      | `readFile` или `readImageFile` из `/file`         |
 | Использовать известные filename и MIME                 | Вызвать `detectMimeType`/`binaryToBlob` вручную   |
@@ -762,70 +762,41 @@ Fallback PDF является осознанным предметно-незав
 ### Сигнатура
 
 ```ts
-function useBinaryFile(bin: string | undefined): {
+type UseBinaryFileResult = {
 	data: {
 		blob: Blob;
 		mime: string;
+		isMimeDetected: boolean;
 	} | null;
 	error: string | null;
 };
-```
-
-Hook принимает только base64/base64 data URL. Он всегда вызывает:
 
-```ts
-const mime = detectMimeType(undefined, bin);
-const blob = binaryToBlob(bin, mime, true);
+function useBinaryFile(bin: string | undefined): UseBinaryFileResult;
 ```
 
-Filename передать нельзя, raw binary mode использовать нельзя.
+Hook принимает base64 или base64 data URL. Имя файла и MIME можно передать отдельно через `detectMimeType` и `binaryToBlob`.
 
 ### Возвращаемое состояние
 
-| Поле    | Значение         | Смысл                                |
-| ------- | ---------------- | ------------------------------------ |
-| `data`  | `{ blob, mime }` | Декодирование завершилось успешно    |
-| `data`  | `null`           | Нет результата либо произошла ошибка |
-| `error` | `string`         | Строковое представление ошибки       |
-| `error` | `null`           | Ошибки нет                           |
-
-### Lifecycle
-
-Преобразование выполняется после commit в React effect:
-
-1. первый render возвращает `{ data: null, error: null }`;
-2. после commit effect обрабатывает `bin`;
-3. успех записывает `{ blob, mime }` и очищает ошибку;
-4. ошибка очищает `data` и записывает `String(error)`;
-5. `undefined` или пустая строка очищают оба поля.
-
-Пример последовательности:
-
-| `bin`                 | Состояние после effect                                     |
-| --------------------- | ---------------------------------------------------------- |
-| `undefined`           | `{ data: null, error: null }`                              |
-| `""`                  | `{ data: null, error: null }`                              |
-| Корректный base64 PDF | `{ data: { blob, mime: "application/pdf" }, error: null }` |
-| Некорректный base64   | `{ data: null, error: "Error: ..." }`                      |
-| Строка из пробелов    | Ошибка после удаления пробелов                             |
-
-У hook нет отдельного `isLoading`/`isProcessing`. На первом render `data: null` и `error: null` может означать как отсутствие входа, так и ещё не выполненный effect.
-
-### Смена `bin`
+| Поле    | Значение                        | Смысл                                |
+| ------- | ------------------------------- | ------------------------------------ |
+| `data`  | `{ blob, mime, isMimeDetected }` | Декодирование завершилось успешно    |
+| `data`  | `null`                          | Нет результата либо произошла ошибка |
+| `error` | `string`                        | Строковое представление ошибки       |
+| `error` | `null`                          | Ошибки нет                           |
 
-При смене одного непустого `bin` на другой предыдущие `data`/`error` могут оставаться видимыми до выполнения следующего effect. Hook не очищает состояние синхронно во время render.
+### Результат при рендере
 
-Если нельзя кратковременно показать предыдущий документ:
+Хук синхронно декодирует текущий `bin` при рендере. При смене `bin` результат сразу относится к новому входу. Мемоизация позволяет повторно использовать `Blob` при рендере с тем же `bin`.
 
-- разместите hook в компоненте, который remount-ится по стабильному ID документа;
-- или выполните преобразование на явной границе загрузки;
-- или добавьте внешний state machine с identity результата.
-
-Не используйте саму большую base64-строку как React `key`. Используйте безопасный стабильный ID документа:
-
-```tsx
-<BinaryDocument key={document.id} bin={document.content} />
-```
+| `bin`                              | Результат                                                               |
+| ---------------------------------- | ----------------------------------------------------------------------- |
+| `undefined`                        | `{ data: null, error: null }`                                             |
+| `""`                               | `{ data: null, error: null }`                                             |
+| Корректный base64 PDF              | `data.mime === "application/pdf"`, `data.isMimeDetected === true`          |
+| Корректный base64 неизвестного типа | `data.mime === "application/octet-stream"`, `data.isMimeDetected === false` |
+| Некорректный base64                | `{ data: null, error: "Error: ..." }`                                     |
+| Строка из пробелов                 | Ошибка после удаления пробелов                                          |
 
 ### Определение MIME внутри hook
 
@@ -833,27 +804,22 @@ Hook не знает filename. Приоритет будет таким:
 
 1. MIME из data URL;
 2. сигнатура;
-3. fallback `application/pdf`.
+3. fallback `application/octet-stream`.
 
-Обычный base64 текста без data URL и известной сигнатуры станет `Blob` с `application/pdf`:
+Проверяйте `data.isMimeDetected` перед выбором просмотрщика. Значение `true` означает, что MIME взят из data URL или определён по сигнатуре. Значение `false` означает, что hook подставил нейтральный MIME и сохранил декодированные байты.
 
 ```tsx
 const { data } = useBinaryFile("SGVsbG8=");
 
-// После effect:
-// data?.mime === "application/pdf"
+// data?.mime === "application/octet-stream"
+// data?.isMimeDetected === false
 ```
 
 Если известны имя или MIME, вызывайте `detectMimeType` и `binaryToBlob` вручную.
 
 ### Ошибки и logging
 
-При ошибке hook:
-
-1. вызывает внутренний `logError(error)`;
-2. `logError` пишет ошибку в `console.error`;
-3. возвращает `error: String(error)`;
-4. очищает `data`.
+При ошибке хук возвращает `{ data: null, error: String(error) }` во время рендера. После commit эффект передаёт исходную ошибку в `logError`, который пишет её в `console.error`.
 
 Для обычного `Error` строка включает имя:
 
@@ -879,12 +845,12 @@ export function BinaryDocument(props: BinaryDocumentProps) {
 		return <p role="alert">Не удалось подготовить документ</p>;
 	}
 
-	if (!props.bin) {
+	if (!data) {
 		return <p>Документ не передан</p>;
 	}
 
-	if (!data) {
-		return <p>Подготовка документа…</p>;
+	if (!data.isMimeDetected) {
+		return <p>Формат файла не распознан</p>;
 	}
 
 	return <DocumentViewer blob={data.blob} mime={data.mime} />;
@@ -936,7 +902,7 @@ Effect синхронизирует React с внешним browser API и си
 Не используйте `useBinaryFile`, если:
 
 - код выполняется вне React;
-- MIME уже известен и не равен PDF fallback;
+- MIME передаётся отдельно от base64;
 - нужно учитывать filename;
 - данные являются raw binary string;
 - результат нужен немедленно в event handler;
@@ -1148,19 +1114,13 @@ const mime = detectMimeType(fileName, payload);
 const blob = binaryToBlob(payload, mime);
 ```
 
-### Hook определил текст как PDF
-
-Причина: `useBinaryFile` не получает filename, сигнатура текста неизвестна, поэтому применяется PDF fallback.
-
-Решения:
+### Hook вернул `isMimeDetected: false`
 
-- передать data URL с MIME;
-- вызвать функции вручную с известным MIME;
-- не использовать hook для этого контракта.
+Байты успешно декодированы. Их можно скачать как `application/octet-stream`. Если тип известен из метаданных, передайте его в data URL или вызовите `binaryToBlob` с этим MIME.
 
 ### MIME не совпал с содержимым
 
-Проверьте приоритет:
+Проверьте порядок определения MIME в `detectMimeType`:
 
 1. filename;
 2. data URL;
@@ -1185,7 +1145,7 @@ data:<mime>,<percent-encoded-payload>
 
 ### Ошибка появляется в `console.error`
 
-Это текущее поведение `useBinaryFile`: hook логирует пойманную ошибку перед записью `error` state. Для ручного `binaryToBlob` logging не выполняется.
+`useBinaryFile` логирует пойманную ошибку после commit. При прямом вызове `binaryToBlob` за журналирование отвечает вызывающий код.
 
 ### Object URL перестал работать
 
@@ -1260,7 +1220,7 @@ Base64 обычно примерно на треть больше исходно
 
 ### `detectMimeType` декодирует только начало
 
-Signature detection декодирует ограниченное начало base64, поэтому дешевле полного декодирования. При этом распознавание data URL выполняется регулярным выражением над входной строкой и может просканировать весь payload. Последующий `binaryToBlob` в любом случае обрабатывает полный payload.
+Для поиска сигнатуры декодируются первые 128 непробельных символов Base64. Распознавание data URL выполняется регулярным выражением над входной строкой и может просканировать весь payload. Последующий `binaryToBlob` обрабатывает полный payload.
 
 ### Рекомендации
 
@@ -1344,8 +1304,8 @@ import { binaryToBlob, detectMimeType, useBinaryFile } from "@ryuzaki13/react-fo
 | `binaryToBlob` MIME                | `application/octet-stream` |
 | `binaryToBlob` input mode          | base64                     |
 | `detectMimeType` fallback          | `application/pdf`          |
-| `useBinaryFile` initial `data`     | `null`                     |
-| `useBinaryFile` initial `error`    | `null`                     |
+| `useBinaryFile` fallback           | `application/octet-stream` |
+| `useBinaryFile` без входа          | `{ data: null, error: null }` |
 | `useBinaryFile` raw binary support | Нет                        |
 | Автоматическое создание object URL | Нет                        |