rename + add docs

lib/core/background.dart

@@ -1,5 +1,7 @@
 import 'package:flutter/material.dart';
+import './render.dart';
 
+/// Abstract definition for a [LazyCanvas] background.
 abstract class CanvasBackground {
   /// the fill color of background
   final Color bgColor;

lib/core/controller/controller.dart

@@ -1,18 +1,19 @@
 import 'dart:collection';
 
 import 'package:flutter/material.dart';
-import 'package:infinite_lazy_2d_grid/utils/measure_size.dart';
+import '../../utils/measure_size.dart';
 import '../spatial_hashing.dart';
 import '../../utils/offset_extensions.dart';
 import '../../utils/size_extensions.dart';
 import '../../utils/conversions.dart';
 import '../../utils/styles.dart';
+import '../render.dart';
 
 part 'debug.dart';
 part 'types.dart';
 
-/// Every canvas view needs one and this handles the positioning logic
-class CanvasController with ChangeNotifier {
+/// Controller for [LazyCanvas]
+class LazyCanvasController with ChangeNotifier {
   int _nextId = 0; // surely we won't run out of IDs, Clueless
   Offset _gsTopLeftOffset = Offset.zero;
   Offset? _lastProcessedOffset;
@@ -30,7 +31,7 @@ class CanvasController with ChangeNotifier {
 
   bool debug;
 
-  CanvasController({this.debug = false, Offset? buildCacheExtent, Size hashCellSize = const Size(100, 100)})
+  LazyCanvasController({this.debug = false, Offset? buildCacheExtent, Size hashCellSize = const Size(100, 100)})
     : _hashCellSize = hashCellSize,
       _buildCacheExtent = buildCacheExtent != null ? buildCacheExtent + Offset(50, 50) : null
   // only top left is considered so if a widget has long width, it'll not be rendered
@@ -64,10 +65,12 @@ class CanvasController with ChangeNotifier {
     }
   }
 
+  /// Called when a child widget's size changes.
   void onChildSizeChange(int id, Size size) {
     _children[id]!.lastRenderedSize = size;
   }
 
+  /// Set the ticker provider for animations.
   void setTickerProvider(TickerProvider ticker) {
     _ticker = ticker;
   }
@@ -139,7 +142,7 @@ class CanvasController with ChangeNotifier {
     notifyListeners();
   }
 
-  /// Increment or decrement the scale by a delta value.
+  /// Increment or decrement the scale by an additive delta value.
   void updateScalebyDelta(double delta) {
     final focalPoint = Offset(canvasSize.width / 2, canvasSize.height / 2);
     final newScale = _scale + delta;
@@ -259,6 +262,7 @@ class CanvasController with ChangeNotifier {
 
   // ==================== Animation ====================
 
+  /// Animate the canvas to a new offset and scale
   Future<void> animateToOffsetAndScale({
     required Offset offset,
     required double scale,

lib/core/render.dart

@@ -1,23 +1,24 @@
 import 'package:flutter/material.dart';
 import 'package:flutter/rendering.dart';
-import 'package:infinite_lazy_2d_grid/core/controller/controller.dart';
-import 'package:infinite_lazy_2d_grid/utils/offset_extensions.dart';
-import 'package:infinite_lazy_2d_grid/utils/styles.dart';
+import '../utils/offset_extensions.dart';
 
+import '../utils/styles.dart';
 import 'background.dart';
+import 'controller/controller.dart';
 
 /// An infinite canvas that places all the children at the specified positions.
-class CanvasView extends StatefulWidget {
+/// Needs a [LazyCanvasController] to control the canvas and a [CanvasBackground] to draw the background.
+class LazyCanvas extends StatefulWidget {
   final CanvasBackground canvasBackground;
-  final CanvasController controller;
+  final LazyCanvasController controller;
 
-  const CanvasView({required this.controller, required this.canvasBackground, super.key});
+  const LazyCanvas({required this.controller, required this.canvasBackground, super.key});
 
   @override
-  State<CanvasView> createState() => _CanvasViewState();
+  State<LazyCanvas> createState() => _LazyCanvasState();
 }
 
-class _CanvasViewState extends State<CanvasView> with TickerProviderStateMixin<CanvasView> {
+class _LazyCanvasState extends State<LazyCanvas> with TickerProviderStateMixin<LazyCanvas> {
   @override
   void initState() {
     super.initState();

lib/core/spatial_hashing.dart

@@ -12,6 +12,8 @@ class PointData<T> {
   PointData(this.point, this.data);
 }
 
+/// Data structure for spatial hashing to get widgets to be built quickly
+/// based on their position in a 2D grid.
 class SpatialHashing<T> {
   final Size cellSize;
   final HashMap<Point, T> _pointData = HashMap<Point, T>();