Skip to content

feat: support adding words to dictionary with a callback#95

Open
andrew-bekhiet-solid wants to merge 16 commits into
solid-software:mainfrom
andrew-bekhiet-solid:feat-support-adding-words-to-dictionary
Open

feat: support adding words to dictionary with a callback#95
andrew-bekhiet-solid wants to merge 16 commits into
solid-software:mainfrom
andrew-bekhiet-solid:feat-support-adding-words-to-dictionary

Conversation

@andrew-bekhiet-solid

Copy link
Copy Markdown
Collaborator

No description provided.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary of Changes

Hello @andrew-bekhiet-solid, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the spell-checking capabilities by allowing users to maintain a personal dictionary. This feature enables the system to learn and ignore specific words, such as proper nouns or domain-specific terminology, thereby improving the precision and user experience of the spell checker. The changes involve new service implementations, controller updates, and UI adjustments to support this functionality.

Highlights

  • Custom Dictionary Support: Introduced the ability to add words to a custom dictionary directly from the mistake popup, enhancing spell-checking accuracy and reducing false positives.
  • In-Memory Dictionary Service: Implemented a new InMemoryDictionaryLanguageCheckService that filters spell-check suggestions based on a user-defined, dynamic dictionary.
  • Text Re-evaluation: Added a recheckText method to LanguageToolController to explicitly re-evaluate the text for mistakes, useful after dictionary updates or configuration changes.
  • Mistake Popup Enhancements: Improved the LanguageToolMistakePopup by adding an 'add to dictionary' action and refining its visual layout with adjusted icon sizes and padding.
  • Example Application Update: The example application now includes a UI for managing the in-memory dictionary, demonstrating the new functionality.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a great new feature for adding words to a custom dictionary, which will be very useful. The implementation is solid, with a new InMemoryDictionaryLanguageCheckService and UI hooks in the mistake popup. I've provided a few suggestions to improve robustness and flexibility, mainly around error handling for the dictionary callback and making the new service more composable. The example app has also been updated well to showcase the feature, though I have a minor suggestion to prevent potential UI overflows.

Comment thread lib/src/utils/mistake_popup.dart Outdated
Comment thread example/lib/main.dart Outdated
Comment thread lib/src/wrappers/in_memory_dictionary_language_check_service.dart Outdated
@illia-romanenko

Copy link
Copy Markdown
Contributor

Thanks @andrew-bekhiet-solid - could you please also add a screenshot? I'm assuming that should be some UI button with it.

@andrew-bekhiet-solid

Copy link
Copy Markdown
Collaborator Author

Sure here they are:

Add to dictionary button hovered Close button hovered
image image

@solid-maxim solid-maxim left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey, @andrew-bekhiet-solid. I've added small suggestions, take a look please.

Comment thread lib/src/wrappers/in_memory_dictionary_language_check_service.dart Outdated
Comment thread lib/src/wrappers/in_memory_dictionary_language_check_service.dart Outdated
Comment thread lib/src/utils/mistake_popup.dart Outdated
@illia-romanenko

Copy link
Copy Markdown
Contributor

@solid-maxim can you please fix suggestions yourself as well?

@andrew-bekhiet-solid andrew-bekhiet-solid force-pushed the feat-support-adding-words-to-dictionary branch from f8bd4de to 587d5dc Compare June 8, 2026 20:30
Comment thread lib/src/wrappers/in_memory_dictionary_language_check_service.dart Outdated
refactor: decouple in memory dictionary from throttling services
refactor: move invalid mistakes offset check to ThrottlingLanguageCheckService
@andrew-bekhiet-solid

Copy link
Copy Markdown
Collaborator Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds support for adding words to a dictionary via an addWordToDictionary callback in LanguageToolMistakePopup, introduces an InMemoryDictionaryLanguageCheckService to post-filter mistakes, and exposes a recheckText method on LanguageToolController. Feedback on these changes identifies a potential race condition in _addWordToDictionaryAndFix that could lead to crashes, and an issue where throttled requests can return stale mistakes, causing incorrect highlights. Additionally, the reviewer suggested calling recheckText() in the example app when adding a word to clear other highlights, and correcting a misleading docstring in InMemoryDictionaryLanguageCheckService.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread lib/src/utils/mistake_popup.dart
Comment on lines 30 to 46
Future<Result<List<Mistake>>?> findMistakes(String text) async {
return await _throttling
final result = await _throttling
.throttle(() => _languageCheckService.findMistakes(text));

return result?.map(
(mistakes) => mistakes.where(
(mistake) {
final mistakeHasInvalidOffset = mistake.offset < 0 ||
mistake.offset >= text.length ||
mistake.endOffset < 0 ||
mistake.endOffset > text.length;

return !mistakeHasInvalidOffset;
},
).toList(growable: false),
);
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

When Throttling.throttle throttles a call, it returns the result of the previous execution (which was for an older version of the text).

While the added bounds check prevents crashes (by filtering out mistakes that are physically out of bounds of the new text), it does not prevent incorrect highlights if the old mistake's offsets happen to be within the bounds of the new text. For example, if the user changes the text from 'helo' to 'them', the old mistake for 'helo' (at offset 0-4) is still within the bounds of 'them' (length 4), so 'them' will be incorrectly highlighted as a mistake with the suggestion 'hello'.

To fix this, we should keep track of the text for which the mistakes were actually retrieved, and return null if the current text does not match.

Here is an example of how this can be implemented by adding a _lastCheckedText field to the class:

String? _lastCheckedText;

@override
Future<Result<List<Mistake>>?> findMistakes(String text) async {
  final result = await _throttling.throttle(() async {
    _lastCheckedText = text;
    return _languageCheckService.findMistakes(text);
  });

  if (_lastCheckedText != text) {
    return null;
  }

  return result?.map(...);
}

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The whole point here is to keep the stale highlights while api fetch is in progress
If we keep checking the latest text, mistakes highlights will keep flashing while the user is typing, so I guess this is a good compromise

Comment thread lib/src/wrappers/in_memory_dictionary_language_check_service.dart
Comment thread example/lib/main.dart
final mistakeStillExists =
controller.text.substring(mistake.offset, mistake.endOffset) == word;
if (mistakeStillExists) {
_fixTheMistake(mistake, word);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why do we need to fix it there? Is it just to clear the error while text won't change? If yes - let's add a comment about that because it's not obvious

Comment thread example/lib/main.dart
Comment on lines +26 to +46
LanguageToolController? _spellCheckController;

LanguageToolController _nonNullController() {
return _spellCheckController ??= LanguageToolController(
languageCheckService: InMemoryDictionaryLanguageCheckService(
languageCheckService: ThrottlingLanguageCheckService(
LanguageToolService(LanguageToolClient()),
const Duration(milliseconds: 250),
),
shouldIgnoreMistake: (mistake, text) {
final word = text.substring(mistake.offset, mistake.endOffset);

return _dictionary.contains(word);
},
),
);
}

@override
Widget build(BuildContext context) {
final spellCheckController = _nonNullController();

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why not initialise it right away?

/// This class does not throttle or debounce requests. Wrap it in
/// [ThrottlingLanguageCheckService] or [DebounceLanguageCheckService] when
/// needed.
class InMemoryDictionaryLanguageCheckService extends LanguageCheckService {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FilteredLanguageCheckService is probably more correct naming now

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants