Task 02: Clipboard fallback migration

Make every web copy action tolerate an unavailable or rejected Clipboard API by sharing the existing dialog-aware DOM fallback.

Acceptance

Modern navigator.clipboard.writeText is preferred when available.
Missing or rejected Clipboard API requests use the DOM fallback and do not produce uncaught promise rejections or TypeErrors.
Existing copied indicators, toasts, and focus behavior remain intact across migrated call sites.
No direct navigator.clipboard.writeText(...) calls remain in application source outside the shared utility and its tests.

Files likely touched

apps/web/lib/utils/copy-to-clipboard.ts
apps/web/lib/utils/copy-to-clipboard.test.ts
apps/web/hooks/use-copy-to-clipboard.ts
apps/web/hooks/use-copy-to-clipboard.test.ts
apps/web/hooks/use-prompt-result-delivery.ts
apps/web/hooks/use-prompt-result-delivery.test.ts
Direct-copy settings, onboarding, task, diff/editor, review, and share components listed in the clipboard section of plan.md.

Verification

cd apps && pnpm --filter @kandev/web test -- --run lib/utils/copy-to-clipboard.test.ts hooks/use-copy-to-clipboard.test.ts components/settings components/task components/editors components/review components/diff app/settings
cd apps/web && pnpm run typecheck
rtk rg -n --glob '!**/*.test.*' --glob '!**/e2e/**' 'navigator\.clipboard(?:\?|\.)?\.writeText\s*\(' apps/web

Risks

The fallback is best effort on browsers that block execCommand; callers must retain their current failure/toast semantics and must not report success when the utility returns false.

Results

RED: the prompt-result delivery regression initially reported an error and skipped the DOM fallback when navigator.clipboard was unavailable.
GREEN: cd apps && pnpm --filter @kandev/web test -- --run lib/utils/copy-to-clipboard.test.ts hooks/use-copy-to-clipboard.test.ts hooks/use-prompt-result-delivery.test.ts passed (3 files, 21 tests).
The task-defined broader command passed (360 files, 2,647 tests, 4 skipped): cd apps && pnpm --filter @kandev/web test -- --run lib/utils/copy-to-clipboard.test.ts hooks/use-copy-to-clipboard.test.ts hooks/use-prompt-result-delivery.test.ts components/settings components/task components/editors components/review components/diff app/settings.
cd apps/web && pnpm run typecheck passed.
Targeted ESLint, Prettier, and i18n:ratchet checks passed.
Static audit leaves direct Clipboard API access only in the shared utility and tests/E2E helpers.

2.7 KiB Raw Blame History