[vector_math] Document geometry filter APIs

packages/vector_math/lib/src/vector_math_geometry/filters/barycentric_filter.dart

@@ -2,12 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// Adds barycentric coordinates for each triangle vertex in a mesh.
 class BarycentricFilter extends GeometryFilter {
   @override
   List<VertexAttrib> get generates => <VertexAttrib>[VertexAttrib('BARYCENTRIC', 3, 'float')];

packages/vector_math/lib/src/vector_math_geometry/filters/color_filter.dart

@@ -2,14 +2,14 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// Assigns a single color to every vertex in a mesh.
 class ColorFilter extends GeometryFilter {
+  /// Creates a filter that writes [color] into the mesh `COLOR` attribute.
   ColorFilter(this.color);
+
+  /// The color written to each output vertex.
   Vector4 color;
 
   @override

packages/vector_math/lib/src/vector_math_geometry/filters/flat_shade_filter.dart

@@ -2,12 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// Expands a mesh to triangle vertices and generates flat-shaded normals.
 class FlatShadeFilter extends GeometryFilter {
   @override
   List<VertexAttrib> get requires => <VertexAttrib>[VertexAttrib('POSITION', 3, 'float')];

packages/vector_math/lib/src/vector_math_geometry/filters/geometry_filter.dart

@@ -2,21 +2,25 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// A filter that produces a transformed copy of a [MeshGeometry].
 abstract class GeometryFilter {
+  /// Whether this filter supports in-place modification of a mesh.
   bool get inplace => false;
-  List<VertexAttrib> get requires => <VertexAttrib>[];
-  List<VertexAttrib> get generates => <VertexAttrib>[];
+
+  /// Vertex attributes that must be present on the input mesh.
+  List<VertexAttrib> get requires => const <VertexAttrib>[];
+
+  /// Vertex attributes that this filter guarantees on the output mesh.
+  List<VertexAttrib> get generates => const <VertexAttrib>[];
 
   /// Returns a copy of the mesh with any filter transforms applied.
   MeshGeometry filter(MeshGeometry mesh);
 }
 
+/// A [GeometryFilter] that can apply its transformation directly to a mesh
+/// in-place.
 abstract class InplaceGeometryFilter extends GeometryFilter {
   @override
   bool get inplace => true;

packages/vector_math/lib/src/vector_math_geometry/filters/invert_filter.dart

@@ -2,12 +2,9 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// Reverses triangle winding and flips normals for a mesh.
 class InvertFilter extends InplaceGeometryFilter {
   @override
   void filterInplace(MeshGeometry mesh) {

packages/vector_math/lib/src/vector_math_geometry/filters/transform_filter.dart

@@ -2,14 +2,14 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
-// TODO(stuartmorgan): Remove this and fix violations. See
-//  https://github.com/flutter/flutter/issues/186827
-// ignore_for_file: public_member_api_docs
-
 part of '../../../vector_math_geometry.dart';
 
+/// Applies a matrix transform to each mesh position in-place.
 class TransformFilter extends InplaceGeometryFilter {
+  /// Creates a filter that transforms positions using [transform].
   TransformFilter(this.transform);
+
+  /// The transform applied to each position in the mesh.
   Matrix4 transform;
 
   @override