@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.7

package/storybook-static/assets/README-1RIcD7RV.js

@@ -0,0 +1,694 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-CViB2sFm.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B8F5vBhs.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Copy`}),`
+`,(0,c.jsxs)(t.h1,{id:`копирование-текста-через-ryuzaki13react-foundation-libcopy`,children:[`Копирование текста через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`copy`}),` содержит React hooks для копирования текста в системный буфер обмена, чтения текста из DOM-элемента и показа короткого состояния «скопировано».`]}),`
+`,(0,c.jsx)(t.p,{children:`Основные сценарии:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`скопировать готовую строку;`}),`
+`,(0,c.jsx)(t.li,{children:`скопировать текст, который сейчас находится внутри элемента;`}),`
+`,(0,c.jsx)(t.li,{children:`на две секунды заменить подпись или иконку кнопки после успешного копирования.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль ориентирован на браузер. Он скрывает технический выбор между современным Clipboard API и legacy fallback, но не отменяет браузерные разрешения и ограничения безопасности.`}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия React и DOM, точное поведение каждого hook, обработка ошибок, доступность, тестирование и известные ограничения.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F`,children:`Назначение и границы модуля`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BC%D0%B8%D0%BD%D0%B8%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F`,children:`Минимальные понятия`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-api`,children:`Как выбрать API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#usecopytext`,children:(0,c.jsx)(t.code,{children:`useCopyText`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#useelementtext`,children:(0,c.jsx)(t.code,{children:`useElementText`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#usecopyelementtext`,children:(0,c.jsx)(t.code,{children:`useCopyElementText`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#usecopyfeedback`,children:(0,c.jsx)(t.code,{children:`useCopyFeedback`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#usecopyelementtextwithfeedback`,children:(0,c.jsx)(t.code,{children:`useCopyElementTextWithFeedback`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D0%B8%D1%80%D0%B0%D0%B5%D1%82%D1%81%D1%8F-%D1%81%D0%BF%D0%BE%D1%81%D0%BE%D0%B1-%D0%BA%D0%BE%D0%BF%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F`,children:`Как выбирается способ копирования`})}),`
+`,(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%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-ux`,children:`Доступность и UX`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#ssr-%D0%B8-browser-boundary`,children:`SSR и browser boundary`})}),`
+`,(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%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%B8-%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Ограничения и частые ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%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:`что-делает-copy`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`copy`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`копирует непустую строку через `,(0,c.jsx)(t.code,{children:`navigator.clipboard.writeText`}),`, когда это возможно;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`использует fallback через временный DOM-элемент и `,(0,c.jsx)(t.code,{children:`document.execCommand("copy")`}),`, если современный Clipboard API недоступен или страница не является secure context;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`Promise<boolean>`}),`, чтобы вызывающий код узнал об успехе или неудаче;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`читает актуальный `,(0,c.jsx)(t.code,{children:`textContent`}),` DOM-элемента через React ref;`]}),`
+`,(0,c.jsx)(t.li,{children:`объединяет чтение элемента и копирование;`}),`
+`,(0,c.jsxs)(t.li,{children:[`предоставляет двухсекундное состояние `,(0,c.jsx)(t.code,{children:`isCopied`}),` для UI-feedback.`]}),`
+`]}),`
+`,(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:`не копирует изображения, файлы, HTML или произвольные MIME-данные;`}),`
+`,(0,c.jsx)(t.li,{children:`не запрашивает разрешение отдельным диалогом и не обходит политику браузера;`}),`
+`,(0,c.jsx)(t.li,{children:`не гарантирует работу вне пользовательского действия;`}),`
+`,(0,c.jsx)(t.li,{children:`не показывает toast, tooltip или иконку самостоятельно;`}),`
+`,(0,c.jsx)(t.li,{children:`не предоставляет React-компонент кнопки;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не копирует `,(0,c.jsx)(t.code,{children:`value`}),` из `,(0,c.jsx)(t.code,{children:`<input>`}),` или `,(0,c.jsx)(t.code,{children:`<textarea>`}),` через element hooks;`]}),`
+`,(0,c.jsx)(t.li,{children:`не сообщает причину ошибки отдельным объектом;`}),`
+`,(0,c.jsx)(t.li,{children:`не повторяет операцию автоматически;`}),`
+`,(0,c.jsx)(t.li,{children:`не синхронизирует feedback между несколькими кнопками.`}),`
+`]}),`
+`,(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.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скачать готовый `,(0,c.jsx)(t.code,{children:`Blob`}),` или JSON-файл`]}),(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:`Прочитать пользовательский файл`}),(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 в `,(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.jsx)(t.td,{children:`Реализовать визуальную кнопку/tooltip`}),(0,c.jsx)(t.td,{children:`UI-компонент приложения или foundation UI-пакет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Скопировать изображение или rich HTML`}),(0,c.jsx)(t.td,{children:`Отдельная реализация Clipboard API для нужного формата`})]})]})]}),`
+`,(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.jsx)(t.p,{children:`Модуль использует React hooks. Приложение должно предоставить совместимые peer-зависимости React:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install react react-dom
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущий контракт пакета требует React `,(0,c.jsx)(t.code,{children:`>=19.2.0 <20.0.0`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Импортируйте API только из опубликованного subpath `,(0,c.jsx)(t.code,{children:`/copy`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	useCopyElementText,
+	useCopyElementTextWithFeedback,
+	useCopyFeedback,
+	useCopyText,
+	useElementText
+} from "@ryuzaki13/react-foundation-lib/copy";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { useCopyText } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { useCopyText } from "@ryuzaki13/react-foundation-lib/copy";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль поставляется как ESM и использует browser APIs:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`navigator.clipboard`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`window.isSecureContext`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`window.getSelection`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`document.createElement`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`document.createRange`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`document.execCommand`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`буфер-обмена`,children:`Буфер обмена`}),`
+`,(0,c.jsx)(t.p,{children:`Буфер обмена — системное временное хранилище, которое используется командами Copy и Paste. После успешного вызова пользователь сможет вставить скопированную строку в другое поле или приложение.`}),`
+`,(0,c.jsx)(t.h3,{id:`react-hook`,children:`React hook`}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook — функция React, имя которой начинается с `,(0,c.jsx)(t.code,{children:`use`}),`. Hook вызывают только:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`на верхнем уровне React-компонента;`}),`
+`,(0,c.jsx)(t.li,{children:`внутри другого custom hook.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нельзя вызывать hook внутри `,(0,c.jsx)(t.code,{children:`if`}),`, цикла, обработчика клика или обычной utility-функции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CopyButton() {
+	// Правильно: hook вызывается при рендере компонента.
+	const { copyToClipboard } = useCopyText();
+
+	const handleClick = async () => {
+		// Правильно: обработчик вызывает функцию, полученную из hook.
+		await copyToClipboard("Текст");
+	};
+
+	return (
+		<button type="button" onClick={() => void handleClick()}>
+			Копировать
+		</button>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`асинхронный-результат-и-promiseboolean`,children:[`Асинхронный результат и `,(0,c.jsx)(t.code,{children:`Promise<boolean>`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Копирование может завершиться не сразу. Поэтому функции возвращают `,(0,c.jsx)(t.code,{children:`Promise<boolean>`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const success = await copyToClipboard("Текст");
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`true`}),` — операция сообщила об успехе;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`false`}),` — строка была пустой либо браузерный способ копирования не сработал.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не проверяйте сам `,(0,c.jsx)(t.code,{children:`Promise`}),` как boolean:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: result является Promise, а не итоговым boolean.
+const result = copyToClipboard("Текст");
+if (result) {
+	// Эта ветка не означает успешное копирование.
+}
+
+// Правильно.
+const success = await copyToClipboard("Текст");
+if (success) {
+	// Копирование завершилось успешно.
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`react-ref`,children:`React ref`}),`
+`,(0,c.jsx)(t.p,{children:`Ref хранит ссылку на реальный DOM-элемент:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const ref = useRef<HTMLSpanElement>(null);
+
+return <span ref={ref}>Текст</span>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`До монтирования элемента `,(0,c.jsx)(t.code,{children:`ref.current`}),` равен `,(0,c.jsx)(t.code,{children:`null`}),`. После монтирования React помещает туда `,(0,c.jsx)(t.code,{children:`HTMLSpanElement`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`textcontent`,children:(0,c.jsx)(t.code,{children:`textContent`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Element hooks читают свойство `,(0,c.jsx)(t.code,{children:`textContent`}),`. Оно объединяет текст самого элемента и всех его потомков:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-html`,children:`<span>Заказ <strong>№ 42</strong></span>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Заказ № 42
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это не то же самое, что визуально отрисованный текст:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`CSS не участвует в формировании результата;`}),`
+`,(0,c.jsx)(t.li,{children:`текст скрытого потомка тоже может попасть в результат;`}),`
+`,(0,c.jsx)(t.li,{children:`подписи вложенных кнопок тоже попадают в результат;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`value`}),` у `,(0,c.jsx)(t.code,{children:`<input>`}),` и `,(0,c.jsx)(t.code,{children:`<textarea>`}),` не является их `,(0,c.jsx)(t.code,{children:`textContent`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`переносы, созданные только layout/CSS, не добавляются автоматически.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`secure-context`,children:`Secure context`}),`
+`,(0,c.jsx)(t.p,{children:`Современный Clipboard API доступен только в безопасном контексте. Обычно это:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`страница по HTTPS;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`localhost`}),` в режиме разработки;`]}),`
+`,(0,c.jsx)(t.li,{children:`среда, которую браузер отдельно признаёт доверенной.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Обычная production-страница по HTTP обычно не является secure context.`}),`
+`,(0,c.jsx)(t.h3,{id:`пользовательское-действие`,children:`Пользовательское действие`}),`
+`,(0,c.jsx)(t.p,{children:`Браузер может разрешать запись в буфер только во время явного действия пользователя: клика, нажатия клавиши или команды меню. Поэтому вызывайте копирование непосредственно из обработчика такого действия.`}),`
+`,(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.jsx)(t.td,{children:`Скопировать уже имеющуюся строку`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyText`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Прочитать `,(0,c.jsx)(t.code,{children:`textContent`}),` из собственного ref`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useElementText`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить готовый ref и скопировать текст элемента`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyElementText`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Только показать состояние «готово» на две секунды`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyFeedback`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скопировать текст элемента и показать `,(0,c.jsx)(t.code,{children:`isCopied`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyElementTextWithFeedback`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скопировать текущее значение `,(0,c.jsx)(t.code,{children:`<input>`}),` или `,(0,c.jsx)(t.code,{children:`<textarea>`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`useCopyText`}),` с переменной `,(0,c.jsx)(t.code,{children:`value`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Скопировать строку, которой ещё нет в DOM`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyText`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Копировать HTML, изображение или файл`}),(0,c.jsx)(t.td,{children:`Этот модуль не подходит`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`копирование-готовой-строки`,children:`Копирование готовой строки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useState } from "react";
+import { useCopyText } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function CopyOrderNumber() {
+	const { copyToClipboard } = useCopyText();
+	const [message, setMessage] = useState("");
+
+	const handleCopy = async () => {
+		const success = await copyToClipboard("ORDER-42");
+		setMessage(success ? "Номер скопирован" : "Не удалось скопировать");
+	};
+
+	return (
+		<div>
+			<button type="button" onClick={() => void handleCopy()}>
+				Копировать номер
+			</button>
+			<span aria-live="polite">{message}</span>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`копирование-текста-элемента-с-feedback`,children:`Копирование текста элемента с feedback`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useCopyElementTextWithFeedback } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function CopyAddress() {
+	const { containerRef, copyElementText, isCopied } = useCopyElementTextWithFeedback<HTMLSpanElement>();
+
+	return (
+		<div>
+			<span ref={containerRef}>г. Екатеринбург, ул. Ленина, 1</span>
+			<button type="button" onClick={() => void copyElementText()}>
+				{isCopied ? "Скопировано" : "Копировать адрес"}
+			</button>
+			<span className="visually-hidden" aria-live="polite">
+				{isCopied ? "Адрес скопирован" : ""}
+			</span>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ref установлен только на `,(0,c.jsx)(t.code,{children:`<span>`}),` с адресом. Если поставить его на общий `,(0,c.jsx)(t.code,{children:`<div>`}),`, в копируемую строку может попасть текст кнопки и live region.`]}),`
+`,(0,c.jsx)(t.h2,{id:`usecopytext`,children:(0,c.jsx)(t.code,{children:`useCopyText`})}),`
+`,(0,c.jsx)(t.p,{children:`Копирует переданную строку и возвращает результат операции.`}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const useCopyText: () => {
+	copyToClipboard: (text: string) => Promise<boolean>;
+};
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`параметр-text`,children:[`Параметр `,(0,c.jsx)(t.code,{children:`text`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`text`}),` — строка, которую нужно поместить в буфер обмена.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await copyToClipboard("INV-2026-0001");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`возвращаемое-значение`,children:`Возвращаемое значение`}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook возвращает объект с функцией `,(0,c.jsx)(t.code,{children:`copyToClipboard`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Сама функция возвращает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`true`}),`, если `,(0,c.jsx)(t.code,{children:`navigator.clipboard.writeText`}),` завершился без ошибки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`результат `,(0,c.jsx)(t.code,{children:`document.execCommand("copy")`}),`, если был выбран fallback;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`false`}),`, если строка пустая, состоит только из whitespace или произошла ошибка.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция стабильна между рендерами компонента: она создаётся через `,(0,c.jsx)(t.code,{children:`useCallback`}),` без зависимостей.`]}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-пустой-строки`,children:`Проверка пустой строки`}),`
+`,(0,c.jsxs)(t.p,{children:[`Перед копированием выполняется проверка `,(0,c.jsx)(t.code,{children:`text.trim()`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await copyToClipboard(""); // false
+await copyToClipboard("   "); // false
+await copyToClipboard("\\n\\t"); // false
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`trim()`}),` используется только для проверки. Непустой исходный текст копируется без обрезки:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`await copyToClipboard("  ABC  \\n");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`В буфер попадёт строка с двумя пробелами в начале, двумя пробелами и переводом строки в конце.`}),`
+`,(0,c.jsx)(t.h3,{id:`обработка-ошибок`,children:`Обработка ошибок`}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook не выбрасывает ошибку копирования вызывающему коду. Он возвращает `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если современный `,(0,c.jsx)(t.code,{children:`navigator.clipboard.writeText`}),` выбросил ошибку, она дополнительно записывается в консоль:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Failed to copy text: <исходная ошибка>
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ошибки legacy fallback поглощаются без записи в консоль.`}),`
+`,(0,c.jsx)(t.h3,{id:`важное-правило-fallback`,children:`Важное правило fallback`}),`
+`,(0,c.jsxs)(t.p,{children:[`Fallback выбирается только заранее, если Clipboard API отсутствует или `,(0,c.jsx)(t.code,{children:`window.isSecureContext`}),` равен `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если современный `,(0,c.jsx)(t.code,{children:`writeText`}),` существует, но отклоняет операцию из-за разрешения, iframe policy или отсутствия user activation, повторной попытки через `,(0,c.jsx)(t.code,{children:`execCommand`}),` не будет. Итогом станет `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример-с-полем-ввода`,children:`Пример с полем ввода`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`<input>`}),` передавайте его `,(0,c.jsx)(t.code,{children:`value`}),` напрямую:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useState } from "react";
+import { useCopyText } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function CopyInputValue() {
+	const [value, setValue] = useState("Пользовательский текст");
+	const { copyToClipboard } = useCopyText();
+
+	return (
+		<label>
+			Текст
+			<input value={value} onChange={(event) => setValue(event.target.value)} />
+			<button type="button" onClick={() => void copyToClipboard(value)}>
+				Копировать
+			</button>
+		</label>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не используйте для этого `,(0,c.jsx)(t.code,{children:`useCopyElementText<HTMLInputElement>`}),`: `,(0,c.jsx)(t.code,{children:`textContent`}),` input-элемента не содержит введённое `,(0,c.jsx)(t.code,{children:`value`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`useelementtext`,children:(0,c.jsx)(t.code,{children:`useElementText`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает функцию, которая читает актуальный `,(0,c.jsx)(t.code,{children:`textContent`}),` переданного DOM ref.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-1`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const useElementText: <T extends HTMLElement = HTMLElement>(
+	ref: RefObject<T | null>
+) => {
+	getElementText: () => string;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`параметр`,children:`Параметр`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`ref`}),` — React ref на `,(0,c.jsx)(t.code,{children:`HTMLElement`}),` или его конкретный тип.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const paragraphRef = useRef<HTMLParagraphElement>(null);
+const { getElementText } = useElementText(paragraphRef);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Generic `,(0,c.jsx)(t.code,{children:`T`}),` помогает TypeScript проверить, к какому элементу прикрепляется ref. Если конкретный тип не важен, используется `,(0,c.jsx)(t.code,{children:`HTMLElement`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`точное-поведение`,children:`Точное поведение`}),`
+`,(0,c.jsxs)(t.p,{children:[`При каждом вызове `,(0,c.jsx)(t.code,{children:`getElementText()`}),` hook:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`читает текущее `,(0,c.jsx)(t.code,{children:`ref.current`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`читает `,(0,c.jsx)(t.code,{children:`ref.current.textContent`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`обрезает whitespace по краям через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращает пустую строку, если ref ещё не установлен или текста нет.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const text = getElementText();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Текст не сохраняется во время рендера. Он читается именно в момент вызова, поэтому изменения DOM до клика будут учтены.`}),`
+`,(0,c.jsx)(t.h3,{id:`пример-без-копирования`,children:`Пример без копирования`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useRef, useState } from "react";
+import { useElementText } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function InspectText() {
+	const ref = useRef<HTMLDivElement>(null);
+	const { getElementText } = useElementText(ref);
+	const [result, setResult] = useState("");
+
+	return (
+		<div>
+			<div ref={ref}>
+				Заказ <strong>№ 42</strong>
+			</div>
+			<button type="button" onClick={() => setResult(getElementText())}>
+				Прочитать DOM-текст
+			</button>
+			<output>{result}</output>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`textcontent-и-скрытый-текст`,children:[(0,c.jsx)(t.code,{children:`textContent`}),` и скрытый текст`]}),`
+`,(0,c.jsx)(t.p,{children:`Если внутри контейнера есть скрытая подпись, она всё равно может быть прочитана:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<span ref={ref}>
+	ABC
+	<span className="visually-hidden">Служебное пояснение</span>
+</span>
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат будет содержать и `,(0,c.jsx)(t.code,{children:`ABC`}),`, и «Служебное пояснение». Если копировать нужно строго определённое значение, безопаснее передать эту строку в `,(0,c.jsx)(t.code,{children:`useCopyText`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`usecopyelementtext`,children:(0,c.jsx)(t.code,{children:`useCopyElementText`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Создаёт ref, читает `,(0,c.jsx)(t.code,{children:`textContent`}),` соответствующего элемента и копирует его.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-2`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const useCopyElementText: <T extends HTMLElement = HTMLElement>() => {
+	containerRef: RefObject<T | null>;
+	copyElementText: () => Promise<boolean>;
+	getElementText: () => string;
+};
+`})}),`
+`,(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:`containerRef`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RefObject<T | null>`})}),(0,c.jsx)(t.td,{children:`Установить на элемент с копируемым текстом.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`copyElementText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`() => Promise<boolean>`})}),(0,c.jsx)(t.td,{children:`Прочитать элемент и скопировать его текст.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getElementText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`() => string`})}),(0,c.jsx)(t.td,{children:`Только получить текущий текст без копирования.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`алгоритм`,children:`Алгоритм`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`copyElementText()`}),`:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`getElementText()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`получает trimmed `,(0,c.jsx)(t.code,{children:`textContent`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`false`}),`, если результат пустой;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`иначе передаёт строку в `,(0,c.jsx)(t.code,{children:`copyToClipboard`}),` из `,(0,c.jsx)(t.code,{children:`useCopyText`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращает итоговый boolean.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поскольку `,(0,c.jsx)(t.code,{children:`useElementText`}),` уже применил `,(0,c.jsx)(t.code,{children:`trim()`}),`, при копировании из элемента внешний whitespace удаляется. Это отличается от прямого `,(0,c.jsx)(t.code,{children:`useCopyText`}),`, который сохраняет внешний whitespace непустой строки.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример-с-проверкой-результата`,children:`Пример с проверкой результата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useState } from "react";
+import { useCopyElementText } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function CopyCustomerName() {
+	const { containerRef, copyElementText } = useCopyElementText<HTMLSpanElement>();
+	const [status, setStatus] = useState("");
+
+	const handleCopy = async () => {
+		const success = await copyElementText();
+		setStatus(success ? "Имя скопировано" : "Копирование недоступно");
+	};
+
+	return (
+		<div>
+			<span ref={containerRef}>Анна Иванова</span>
+			<button type="button" onClick={() => void handleCopy()}>
+				Копировать имя
+			</button>
+			<span aria-live="polite">{status}</span>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`где-ставить-ref`,children:`Где ставить ref`}),`
+`,(0,c.jsxs)(t.p,{children:[`Ставьте `,(0,c.jsx)(t.code,{children:`containerRef`}),` на самый узкий элемент, содержащий только нужный текст:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Правильно: кнопка находится вне копируемого элемента.
+<div>
+	<span ref={containerRef}>{code}</span>
+	<button type="button" onClick={() => void copyElementText()}>
+		Копировать
+	</button>
+</div>
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Рискованно: подпись кнопки тоже является textContent общего div.
+<div ref={containerRef}>
+	<span>{code}</span>
+	<button type="button" onClick={() => void copyElementText()}>
+		Копировать
+	</button>
+</div>
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`usecopyfeedback`,children:(0,c.jsx)(t.code,{children:`useCopyFeedback`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Предоставляет boolean-состояние, которое становится `,(0,c.jsx)(t.code,{children:`true`}),` и автоматически переключается обратно в `,(0,c.jsx)(t.code,{children:`false`}),` через 2000 миллисекунд.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-3`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const useCopyFeedback: () => {
+	isCopied: boolean;
+	showFeedback: () => () => void;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`точное-поведение-1`,children:`Точное поведение`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`начальное значение `,(0,c.jsx)(t.code,{children:`isCopied`}),` — `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`showFeedback()`}),` сразу запрашивает установку `,(0,c.jsx)(t.code,{children:`isCopied = true`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`затем создаёт timer на 2000 мс;`}),`
+`,(0,c.jsxs)(t.li,{children:[`timer устанавливает `,(0,c.jsx)(t.code,{children:`isCopied = false`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`showFeedback()`}),` возвращает cleanup-функцию, отменяющую именно созданный timer.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const { isCopied, showFeedback } = useCopyFeedback();
+
+const handleAction = () => {
+	showFeedback();
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook ничего не копирует. Название `,(0,c.jsx)(t.code,{children:`isCopied`}),` описывает типовой UI-сценарий, но вызывающий код сам решает, когда вызывать `,(0,c.jsx)(t.code,{children:`showFeedback`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`cleanup-функция`,children:`Cleanup-функция`}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат `,(0,c.jsx)(t.code,{children:`showFeedback()`}),` имеет тип `,(0,c.jsx)(t.code,{children:`() => void`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const cancelTimer = showFeedback();
+cancelTimer();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Cleanup только отменяет переход в `,(0,c.jsx)(t.code,{children:`false`}),`. Он не сбрасывает `,(0,c.jsx)(t.code,{children:`isCopied`}),` сразу. Если вызвать cleanup, пока компонент продолжает жить, состояние может остаться `,(0,c.jsx)(t.code,{children:`true`}),` до другого обновления. Поэтому не используйте cleanup как команду «скрыть сообщение».`]}),`
+`,(0,c.jsx)(t.p,{children:`Текущая реализация hook не сохраняет cleanup автоматически и не отменяет timer при unmount. Это важно для компонентов с очень коротким жизненным циклом.`}),`
+`,(0,c.jsx)(t.h3,{id:`повторные-вызовы`,children:`Повторные вызовы`}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый вызов `,(0,c.jsx)(t.code,{children:`showFeedback()`}),` создаёт отдельный timer. Timers не заменяют друг друга.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если вызвать функцию второй раз через одну секунду, timer первого вызова всё равно сможет установить `,(0,c.jsx)(t.code,{children:`false`}),` ещё через одну секунду. Поэтому feedback не гарантирует «ровно две секунды после последнего вызова».`]}),`
+`,(0,c.jsx)(t.p,{children:`Для редких пользовательских кликов это обычно незаметно. Для частых программных вызовов нужен отдельный feedback hook с last-write-wins timer policy.`}),`
+`,(0,c.jsx)(t.h2,{id:`usecopyelementtextwithfeedback`,children:(0,c.jsx)(t.code,{children:`useCopyElementTextWithFeedback`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объединяет `,(0,c.jsx)(t.code,{children:`useCopyElementText`}),` и `,(0,c.jsx)(t.code,{children:`useCopyFeedback`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-4`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare const useCopyElementTextWithFeedback: <T extends HTMLElement = HTMLElement>() => {
+	containerRef: RefObject<T | null>;
+	copyElementText: () => Promise<boolean>;
+	getElementText: () => string;
+	isCopied: boolean;
+};
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`точное-поведение-2`,children:`Точное поведение`}),`
+`,(0,c.jsxs)(t.p,{children:[`При вызове `,(0,c.jsx)(t.code,{children:`copyElementText()`}),`:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`читается trimmed `,(0,c.jsx)(t.code,{children:`textContent`}),` элемента;`]}),`
+`,(0,c.jsx)(t.li,{children:`выполняется попытка копирования;`}),`
+`,(0,c.jsxs)(t.li,{children:[`если получен `,(0,c.jsx)(t.code,{children:`true`}),`, вызывается `,(0,c.jsx)(t.code,{children:`showFeedback()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isCopied`}),` становится `,(0,c.jsx)(t.code,{children:`true`}),` примерно на две секунды;`]}),`
+`,(0,c.jsx)(t.li,{children:`возвращается тот же boolean-результат копирования.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`false`}),` feedback не показывается.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример-с-иконкой-и-доступной-подписью`,children:`Пример с иконкой и доступной подписью`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { useCopyElementTextWithFeedback } from "@ryuzaki13/react-foundation-lib/copy";
+
+export function CopyReference({ value }: { value: string }) {
+	const { containerRef, copyElementText, isCopied } = useCopyElementTextWithFeedback<HTMLCodeElement>();
+
+	return (
+		<div>
+			<code ref={containerRef}>{value}</code>
+			<button type="button" onClick={() => void copyElementText()} aria-label={isCopied ? "Скопировано" : "Копировать значение"}>
+				{isCopied ? "✓" : "⧉"}
+			</button>
+			<span className="visually-hidden" aria-live="polite">
+				{isCopied ? "Значение скопировано" : ""}
+			</span>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Hook наследует ограничения `,(0,c.jsx)(t.code,{children:`useCopyFeedback`}),`: timers не объединяются, cleanup не вызывается автоматически при unmount.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбирается-способ-копирования`,children:`Как выбирается способ копирования`}),`
+`,(0,c.jsxs)(t.p,{children:[`Упрощённый алгоритм `,(0,c.jsx)(t.code,{children:`useCopyText`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`text.trim() пустой?
+├─ да  → false
+└─ нет
+   ├─ navigator.clipboard существует И window.isSecureContext === true
+   │  ├─ writeText завершился → true
+   │  └─ writeText выбросил ошибку → console.error + false
+   └─ иначе
+      ├─ execCommand("copy") вернул true → true
+      └─ вернул false или произошла ошибка → false
+`})}),`
+`,(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:`await navigator.clipboard.writeText(text);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`На результат могут влиять:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`HTTPS/secure context;`}),`
+`,(0,c.jsx)(t.li,{children:`user activation;`}),`
+`,(0,c.jsx)(t.li,{children:`разрешение браузера;`}),`
+`,(0,c.jsx)(t.li,{children:`Permissions Policy родительской страницы;`}),`
+`,(0,c.jsx)(t.li,{children:`настройки iframe;`}),`
+`,(0,c.jsx)(t.li,{children:`настройки пользователя или корпоративного браузера.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`legacy-fallback`,children:`Legacy fallback`}),`
+`,(0,c.jsx)(t.p,{children:`Fallback:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`создаёт невидимый `,(0,c.jsx)(t.code,{children:`contentEditable`}),` `,(0,c.jsx)(t.code,{children:`<div>`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`помещает его в `,(0,c.jsx)(t.code,{children:`document.body`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`записывает строку в `,(0,c.jsx)(t.code,{children:`textContent`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`выделяет содержимое через `,(0,c.jsx)(t.code,{children:`Range`}),` и `,(0,c.jsx)(t.code,{children:`Selection`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`document.execCommand("copy")`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`при обычном завершении снимает выделение и удаляет временный элемент.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`document.execCommand`}),` является устаревшим и browser-dependent API. Наличие fallback не означает поддержку любого старого браузера.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если внутри fallback произойдёт исключение после добавления временного элемента, текущая реализация не использует `,(0,c.jsx)(t.code,{children:`finally`}),`. В таком редком случае она вернёт `,(0,c.jsx)(t.code,{children:`false`}),`, но не гарантирует очистку временного элемента и selection.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовые-рецепты`,children:`Готовые рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`копирование-вычисленного-значения`,children:`Копирование вычисленного значения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CopyCoordinates({ latitude, longitude }: { latitude: number; longitude: number }) {
+	const { copyToClipboard } = useCopyText();
+	const value = \`\${latitude}, \${longitude}\`;
+
+	return (
+		<button type="button" onClick={() => void copyToClipboard(value)}>
+			Копировать координаты
+		</button>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`отдельная-обработка-ошибки`,children:`Отдельная обработка ошибки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CopyToken({ token }: { token: string }) {
+	const { copyToClipboard } = useCopyText();
+	const [error, setError] = useState("");
+
+	const handleCopy = async () => {
+		const success = await copyToClipboard(token);
+		setError(success ? "" : "Разрешите доступ к буферу обмена или скопируйте значение вручную");
+	};
+
+	return (
+		<div>
+			<button type="button" onClick={() => void handleCopy()}>
+				Копировать
+			</button>
+			{error ? <p role="alert">{error}</p> : null}
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`клавиатурная-команда`,children:`Клавиатурная команда`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CopyOnShortcut({ value }: { value: string }) {
+	const { copyToClipboard } = useCopyText();
+
+	const handleKeyDown = (event: React.KeyboardEvent) => {
+		if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === "c") {
+			event.preventDefault();
+			void copyToClipboard(value);
+		}
+	};
+
+	return (
+		<div tabIndex={0} onKeyDown={handleKeyDown}>
+			Нажмите Ctrl/Cmd+C, чтобы скопировать значение
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не перехватывайте стандартный Ctrl/Cmd+C глобально без явной необходимости: пользователь может копировать выделенный им текст.`}),`
+`,(0,c.jsx)(t.h3,{id:`копирование-текста-который-меняется-в-dom`,children:`Копирование текста, который меняется в DOM`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CopyLiveCounter({ count }: { count: number }) {
+	const { containerRef, copyElementText } = useCopyElementText<HTMLOutputElement>();
+
+	return (
+		<div>
+			<output ref={containerRef}>Обработано: {count}</output>
+			<button type="button" onClick={() => void copyElementText()}>
+				Копировать текущий результат
+			</button>
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При клике будет прочитан текст с актуальным `,(0,c.jsx)(t.code,{children:`count`}),`, а не значение первого рендера.`]}),`
+`,(0,c.jsx)(t.h2,{id:`доступность-и-ux`,children:`Доступность и UX`}),`
+`,(0,c.jsx)(t.h3,{id:`используйте-настоящую-кнопку`,children:`Используйте настоящую кнопку`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для команды копирования предпочтителен `,(0,c.jsx)(t.code,{children:`<button type="button">`}),`, а не кликабельный `,(0,c.jsx)(t.code,{children:`<div>`}),`. Кнопка уже поддерживает клавиатуру, фокус и семантику действия.`]}),`
+`,(0,c.jsx)(t.h3,{id:`не-передавайте-успех-только-цветом-или-иконкой`,children:`Не передавайте успех только цветом или иконкой`}),`
+`,(0,c.jsx)(t.p,{children:`Текст «Скопировано» понятнее, чем одна смена цвета. Для screen reader добавьте live region:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`<span aria-live="polite">{isCopied ? "Скопировано" : ""}</span>
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`не-показывайте-успех-до-завершения-await`,children:[`Не показывайте успех до завершения `,(0,c.jsx)(t.code,{children:`await`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Операция может быть отклонена. Показывайте успешный feedback только после `,(0,c.jsx)(t.code,{children:`true`}),`. `,(0,c.jsx)(t.code,{children:`useCopyElementTextWithFeedback`}),` делает это автоматически.`]}),`
+`,(0,c.jsx)(t.h3,{id:`оставьте-ручной-способ-копирования`,children:`Оставьте ручной способ копирования`}),`
+`,(0,c.jsx)(t.p,{children:`Если значение важно, оставьте его видимым и выделяемым. Тогда пользователь сможет скопировать его вручную, даже если browser API заблокирован.`}),`
+`,(0,c.jsx)(t.h3,{id:`осторожно-с-чувствительными-данными`,children:`Осторожно с чувствительными данными`}),`
+`,(0,c.jsx)(t.p,{children:`Не копируйте пароль, token или персональные данные без явного действия пользователя. Буфер обмена доступен другим приложениям и может сохраняться менеджером истории clipboard.`}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-и-browser-boundary`,children:`SSR и browser boundary`}),`
+`,(0,c.jsx)(t.p,{children:`Hooks можно импортировать в React-код, но фактическое копирование требует browser globals.`}),`
+`,(0,c.jsx)(t.p,{children:`Следуйте правилам:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`вызывайте `,(0,c.jsx)(t.code,{children:`copyToClipboard`}),` и `,(0,c.jsx)(t.code,{children:`copyElementText`}),` только на клиенте;`]}),`
+`,(0,c.jsx)(t.li,{children:`связывайте вызов с пользовательским событием после монтирования;`}),`
+`,(0,c.jsx)(t.li,{children:`не вызывайте копирование во время render;`}),`
+`,(0,c.jsx)(t.li,{children:`не вызывайте его в server loader, server action или Node-only utility;`}),`
+`,(0,c.jsx)(t.li,{children:`в тестовой среде предоставляйте DOM и mock Clipboard API.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getElementText()`}),` безопасно вернёт пустую строку, пока ref равен `,(0,c.jsx)(t.code,{children:`null`}),`. Но это не означает, что сам сценарий копирования является server API.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`что-стоит-проверять-в-consumer-компоненте`,children:`Что стоит проверять в consumer-компоненте`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`правильная строка передаётся в `,(0,c.jsx)(t.code,{children:`navigator.clipboard.writeText`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`UI показывает успех только после результата `,(0,c.jsx)(t.code,{children:`true`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`при `,(0,c.jsx)(t.code,{children:`false`}),` отображается сообщение об ошибке;`]}),`
+`,(0,c.jsx)(t.li,{children:`ref установлен на нужный элемент;`}),`
+`,(0,c.jsx)(t.li,{children:`hidden/button text не попадает в копируемое значение;`}),`
+`,(0,c.jsx)(t.li,{children:`feedback исчезает после 2000 мс;`}),`
+`,(0,c.jsx)(t.li,{children:`повторные клики соответствуют ожидаемой UX-policy.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`mock-современного-clipboard-api`,children:`Mock современного Clipboard API`}),`
+`,(0,c.jsx)(t.p,{children:`Пример для Vitest и DOM test environment:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { vi } from "vitest";
+
+const writeText = vi.fn().mockResolvedValue(undefined);
+
+Object.defineProperty(navigator, "clipboard", {
+	configurable: true,
+	value: { writeText }
+});
+
+Object.defineProperty(window, "isSecureContext", {
+	configurable: true,
+	value: true
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`После пользовательского клика:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(writeText).toHaveBeenCalledWith("ORDER-42");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-ошибки`,children:`Проверка ошибки`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`writeText.mockRejectedValueOnce(new DOMException("Not allowed", "NotAllowedError"));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поскольку hook пишет ошибку в `,(0,c.jsx)(t.code,{children:`console.error`}),`, в тесте можно временно установить spy, а после теста обязательно восстановить его.`]}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-feedback-через-fake-timers`,children:`Проверка feedback через fake timers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`vi.useFakeTimers();
+
+// После showFeedback() или успешного клика ожидается isCopied === true.
+vi.advanceTimersByTime(2000);
+// После React update ожидается isCopied === false.
+
+vi.useRealTimers();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При работе с React Testing Library изменение времени нужно выполнять внутри `,(0,c.jsx)(t.code,{children:`act`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ограничения-и-частые-ошибки`,children:`Ограничения и частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`вызов-вне-пользовательского-события`,children:`Вызов вне пользовательского события`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`useEffect(() => {
+	void copyToClipboard(value);
+}, [copyToClipboard, value]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Браузер может заблокировать такой вызов. Кроме того, неожиданное изменение clipboard при открытии страницы является плохим UX.`}),`
+`,(0,c.jsxs)(t.h3,{id:`игнорирование-promise`,children:[`Игнорирование `,(0,c.jsx)(t.code,{children:`Promise`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Ошибка: UI сразу говорит об успехе.
+copyToClipboard(value);
+setMessage("Скопировано");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правильно дождаться результата:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const success = await copyToClipboard(value);
+setMessage(success ? "Скопировано" : "Не удалось скопировать");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ref-охватывает-лишний-ui`,children:`Ref охватывает лишний UI`}),`
+`,(0,c.jsxs)(t.p,{children:[`В `,(0,c.jsx)(t.code,{children:`textContent`}),` попадут подписи вложенных элементов. Установите ref только на значение либо используйте `,(0,c.jsx)(t.code,{children:`useCopyText(value)`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`попытка-прочитать-inputvalue-через-textcontent`,children:[`Попытка прочитать `,(0,c.jsx)(t.code,{children:`input.value`}),` через `,(0,c.jsx)(t.code,{children:`textContent`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Element hooks не читают значение form control. Передавайте controlled state или `,(0,c.jsx)(t.code,{children:`inputRef.current?.value`}),` в `,(0,c.jsx)(t.code,{children:`useCopyText`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-rich-clipboard`,children:`Ожидание rich clipboard`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль пишет plain text. Форматирование HTML, изображение и файлы не сохраняются.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-fallback-после-отказа-clipboard-api`,children:`Ожидание fallback после отказа Clipboard API`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`navigator.clipboard.writeText`}),` был выбран и выбросил ошибку, legacy fallback не запускается.`]}),`
+`,(0,c.jsx)(t.h3,{id:`несколько-быстрых-feedback-вызовов`,children:`Несколько быстрых feedback-вызовов`}),`
+`,(0,c.jsx)(t.p,{children:`Timers независимы. Более ранний timer может скрыть сообщение раньше, чем через две секунды после последнего клика.`}),`
+`,(0,c.jsxs)(t.h3,{id:`слепое-доверие-true`,children:[`Слепое доверие `,(0,c.jsx)(t.code,{children:`true`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`true`}),` означает, что выбранный browser API сообщил об успехе. Модуль не читает clipboard обратно и не сравнивает содержимое.`]}),`
+`,(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:`API`}),(0,c.jsx)(t.th,{children:`Вход`}),(0,c.jsx)(t.th,{children:`Результат`}),(0,c.jsx)(t.th,{children:`Главное ограничение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyText`})}),(0,c.jsxs)(t.td,{children:[`Строка в `,(0,c.jsx)(t.code,{children:`copyToClipboard`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Promise<boolean>`})}),(0,c.jsx)(t.td,{children:`Только plain text; зависит от browser policy.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useElementText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RefObject<T | null>`})}),(0,c.jsxs)(t.td,{children:[`Trimmed `,(0,c.jsx)(t.code,{children:`textContent`}),` или `,(0,c.jsx)(t.code,{children:`""`})]}),(0,c.jsxs)(t.td,{children:[`Не читает `,(0,c.jsx)(t.code,{children:`input.value`}),`; учитывает hidden descendants.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyElementText`})}),(0,c.jsx)(t.td,{children:`Generic типа элемента`}),(0,c.jsx)(t.td,{children:`Ref, getter и async copy`}),(0,c.jsx)(t.td,{children:`Внешний whitespace элемента обрезается.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyFeedback`})}),(0,c.jsxs)(t.td,{children:[`Вызов `,(0,c.jsx)(t.code,{children:`showFeedback()`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`isCopied = true`}),`, затем `,(0,c.jsx)(t.code,{children:`false`}),` через 2000 мс`]}),(0,c.jsx)(t.td,{children:`Timers не объединяются и не очищаются автоматически.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`useCopyElementTextWithFeedback`})}),(0,c.jsx)(t.td,{children:`Generic типа элемента`}),(0,c.jsxs)(t.td,{children:[`Ref, getter, async copy и `,(0,c.jsx)(t.code,{children:`isCopied`})]}),(0,c.jsx)(t.td,{children:`Наследует ограничения element text и feedback timer.`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Все hooks должны вызываться по правилам React hooks.`}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-функция-возвращает-false-на-строке-из-пробелов`,children:[`Почему функция возвращает `,(0,c.jsx)(t.code,{children:`false`}),` на строке из пробелов?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Потому что перед копированием проверяется `,(0,c.jsx)(t.code,{children:`text.trim()`}),`. Whitespace-only строка считается отсутствующим полезным текстом.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`обрезает-ли-usecopytext-пробелы-у-нормальной-строки`,children:[`Обрезает ли `,(0,c.jsx)(t.code,{children:`useCopyText`}),` пробелы у нормальной строки?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. `,(0,c.jsx)(t.code,{children:`trim()`}),` используется только для проверки пустоты. Исходная непустая строка копируется буквально.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`обрезает-ли-usecopyelementtext-пробелы`,children:[`Обрезает ли `,(0,c.jsx)(t.code,{children:`useCopyElementText`}),` пробелы?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Да. `,(0,c.jsx)(t.code,{children:`useElementText`}),` возвращает `,(0,c.jsx)(t.code,{children:`textContent.trim()`}),`, и именно этот результат передаётся на копирование.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-на-localhost-работает-а-на-http-стенде-нет`,children:`Почему на localhost работает, а на HTTP-стенде нет?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`localhost`}),` обычно считается доверенным контекстом, а обычный HTTP-хост — нет. На стенде может использоваться legacy fallback, который браузер также вправе заблокировать.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-копирование-не-работает-внутри-iframe`,children:`Почему копирование не работает внутри iframe?`}),`
+`,(0,c.jsx)(t.p,{children:`Родительская страница или Permissions Policy может запрещать clipboard-write. Проверьте настройки iframe и вызывайте операцию из пользовательского события.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-копировать-значение-input`,children:`Можно ли копировать значение input?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Да, но через `,(0,c.jsx)(t.code,{children:`useCopyText(inputValue)`}),`, а не через `,(0,c.jsx)(t.code,{children:`useCopyElementText`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-hook-без-feedback`,children:`Можно ли использовать hook без feedback?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Да. Используйте `,(0,c.jsx)(t.code,{children:`useCopyText`}),` или `,(0,c.jsx)(t.code,{children:`useCopyElementText`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-feedback-для-другой-успешной-команды`,children:`Можно ли использовать feedback для другой успешной команды?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Технически да: `,(0,c.jsx)(t.code,{children:`useCopyFeedback`}),` только переключает boolean. Учитывайте фиксированные 2000 мс и независимые timers.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-изменить-длительность-двух-секунд`,children:`Можно ли изменить длительность двух секунд?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. В текущем публичном API длительность не настраивается.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-showfeedback-возвращает-функцию`,children:[`Почему `,(0,c.jsx)(t.code,{children:`showFeedback`}),` возвращает функцию?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Она отменяет созданный timer. Hook не вызывает её автоматически. Отмена timer не устанавливает `,(0,c.jsx)(t.code,{children:`isCopied`}),` обратно в `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`что-выбрать-usecopyelementtext-или-usecopytext`,children:[`Что выбрать: `,(0,c.jsx)(t.code,{children:`useCopyElementText`}),` или `,(0,c.jsx)(t.code,{children:`useCopyText`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если исходная строка уже есть в state, props или переменной, выбирайте `,(0,c.jsx)(t.code,{children:`useCopyText`}),`: результат будет предсказуемее. Element hook удобен, когда источником действительно является собранный DOM-текст.`]})]})}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};