Improve copy/paste error handling and fix API documentation

[hluk]

Fixes #3428

Assisted-by: gpt-5.3-codex

[codecov]

Codecov Report

❌ Patch coverage is 38.88889% with 44 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.25%. Comparing base (3db98f5) to head (2f9ff75).
⚠️ Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
src/platform/x11/x11platformwindow.cpp	36.20%	37 Missing ⚠️
src/scriptable/scriptableproxy.cpp	33.33%	4 Missing ⚠️
src/scriptable/scriptable.cpp	0.00%	2 Missing ⚠️
src/tests/tests.cpp	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #3429      +/-   ##
==========================================
- Coverage   80.38%   80.25%   -0.13%     
==========================================
  Files         238      238              
  Lines       29878    29911      +33     
==========================================
- Hits        24016    24004      -12     
- Misses       5862     5907      +45     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.