Document public members, where it is necessary

lib/domain/language_check_service.dart

@@ -1,7 +1,10 @@
 import 'package:languagetool_textfield/domain/mistake.dart';
 
+/// Base language check service.
 abstract class LanguageCheckService {
+ /// Creates a new instance of the [LanguageCheckService] class.
  const LanguageCheckService();
 
+ /// Returns found mistakes in the given [text].
  Future<List<Mistake>> findMistakes(String text);
 }

lib/domain/mistake.dart

@@ -1,10 +1,23 @@
+/// A data model class that stores information about a single writing mistake.
 class Mistake {
+ /// A brief description of the mistake.
  final String message;
+
+ /// A type of this mistake.
  final String type;
+
+ /// A position of the beginning of this mistake.
  final int offset;
+
+ /// Length of this mistake after the offset.
  final int length;
+
+ /// A list of suggestions for replacing this mistake.
+ ///
+ /// Sorted by probability.
  final List<String> replacements;
 
+ /// Creates a new instance of the [Mistake] class
  const Mistake({
  required this.message,
  required this.type,

lib/implementations/debounce_lang_tool_service.dart

@@ -2,10 +2,15 @@ import 'package:languagetool_textfield/domain/language_check_service.dart';
 import 'package:languagetool_textfield/domain/mistake.dart';
 import 'package:throttling/throttling.dart';
 
+/// Implementation of language check service with debouncing.
 class DebounceLangToolService extends LanguageCheckService {
+ /// Base language check service.
  final LanguageCheckService baseService;
+
+ /// A debouncing used to debounce the API calls.
  final Debouncing debouncing;
 
+ /// Implementation of language check service with debouncing.
  DebounceLangToolService(
  this.baseService,
  Duration debouncingDuration,

lib/implementations/lang_tool_service.dart

@@ -2,9 +2,12 @@ import 'package:language_tool/language_tool.dart';
 import 'package:languagetool_textfield/domain/language_check_service.dart';
 import 'package:languagetool_textfield/domain/mistake.dart';
 
+/// Implementation of language check service with language tool service.
 class LangToolService extends LanguageCheckService {
+ /// Objects of this class are used to interact with LanguageTool API.
  final LanguageTool languageTool;
 
+ /// Implementation of language check service with language tool service.
  const LangToolService(this.languageTool);
 
  @override

lib/implementations/throttling_lang_tool_service.dart

@@ -2,10 +2,15 @@ import 'package:languagetool_textfield/domain/language_check_service.dart';
 import 'package:languagetool_textfield/domain/mistake.dart';
 import 'package:throttling/throttling.dart';
 
+/// Implementation of language check service with throttling.
 class ThrottlingLangToolService extends LanguageCheckService {
+ /// Base language check service.
  final LanguageCheckService baseService;
+
+ /// A throttling used to throttle the API calls.
  final Throttling throttling;
 
+ /// Implementation of LanguageCheckService with throttling.
  ThrottlingLangToolService(
  this.baseService,
  Duration throttlingDuration,

lib/presentation/language_tool_text_field.dart

@@ -1,12 +1,21 @@
 import 'package:flutter/material.dart';
 import 'package:languagetool_textfield/domain/language_check_service.dart';
 
+/// Widget for checking grammar errors.
 class LanguageToolTextField extends StatefulWidget {
+ /// Service for checking errors.
  final LanguageCheckService langService;
+
+ /// The style to use for the text being edited.
  final TextStyle style;
+
+ /// Decoration of widget
  final InputDecoration decoration;
+
+ /// Will build custom errors based on state.
  final Widget Function()? mistakeBuilder;
 
+ /// Creates a widget that checks grammar errors.
  const LanguageToolTextField({
  Key? key,
  required this.langService,
@@ -20,7 +29,6 @@ class LanguageToolTextField extends StatefulWidget {
 }
 
 class _LanguageToolTextFieldState extends State<LanguageToolTextField> {
-
  @override
  Widget build(BuildContext context) {
  return const Placeholder();