docs(text-editor): document that clear discards pending changes and the flush-first pattern

[john-traas]

What

Documents two facts about clear() that the JSDoc omits, on both
limel-text-editor and its ProseMirror adapter:

• clearing also discards any pending debounced change, so content typed just
  before the call is never reported;
• the pattern for capturing the final content anyway is to flush first:

await editor.flushPendingChanges(); // emits the final content
send(this.boundValue);
await editor.clear();

No behavior change.

Why

clear() silently swallows a pending change, and the only way to learn that
today is reading the implementation. The one in-tree consumer (the AI chat
composer in lime-crm-components) depends on the flush-first pattern for
correctness, but the pattern is not discoverable from the API docs — the next
consumer would have to rediscover it.

Verification

• Docs-only change; text-editor spec 268/268 and e2e 130/130 passing

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 13ba87f7-41ba-45e7-9ca8-8aa2363e4609

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[github-actions]

Documentation has been published to https://lundalogik.github.io/lime-elements/versions/PR-4239/