pkg/utf: fixed layout, added todos, updated docs and homepage pubspec links

pkg/utf/lib/src/utf/utf32.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of utf;
 
 /**
  * Decodes the UTF-32 bytes as an iterable. Thus, the consumer can only convert
  * as much of the input as needed. Determines the byte order from the BOM,
  * or uses big-endian as a default. This method always strips a leading BOM.
@@ skipping 177 matching lines @@
   final Utf32BytesDecoderProvider codeunitsProvider;
 
   IterableUtf32Decoder._(this.codeunitsProvider);
 
   Utf32BytesDecoder get iterator => codeunitsProvider();
 }
 
 /**
  * Abstrace parent class converts encoded bytes to codepoints.
  */
-abstract class Utf32BytesDecoder implements _ListRangeIterator {
-  final _ListRangeIterator utf32EncodedBytesIterator;
+abstract class Utf32BytesDecoder implements ListRangeIterator {
+  // TODO(kevmoo): should this field be private?
+  final ListRangeIterator utf32EncodedBytesIterator;
   final int replacementCodepoint;
   int _current = null;
 
   Utf32BytesDecoder._fromListRangeIterator(
       this.utf32EncodedBytesIterator, this.replacementCodepoint);
 
   factory Utf32BytesDecoder(List<int> utf32EncodedBytes, [
       int offset = 0, int length,
       int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) {
     if (length == null) {
@@ skipping 69 matching lines @@
 
 /**
  * Convert UTF-32BE encoded bytes to codepoints by grouping 4 bytes
  * to produce the unicode codepoint.
  */
 class Utf32beBytesDecoder extends Utf32BytesDecoder {
   Utf32beBytesDecoder(List<int> utf32EncodedBytes, [int offset = 0,
       int length, bool stripBom = true,
       int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) :
       super._fromListRangeIterator(
-          (new _ListRange(utf32EncodedBytes, offset, length)).iterator,
+          (new ListRange(utf32EncodedBytes, offset, length)).iterator,
           replacementCodepoint) {
     if (stripBom && hasUtf32beBom(utf32EncodedBytes, offset, length)) {
       skip();
     }
   }
 
   int decode() {
     utf32EncodedBytesIterator.moveNext();
     int value = utf32EncodedBytesIterator.current;
     utf32EncodedBytesIterator.moveNext();
     value = (value << 8) + utf32EncodedBytesIterator.current;
     utf32EncodedBytesIterator.moveNext();
     value = (value << 8) + utf32EncodedBytesIterator.current;
     utf32EncodedBytesIterator.moveNext();
     value = (value << 8) + utf32EncodedBytesIterator.current;
     return value;
   }
 }
 
 /**
  * Convert UTF-32BE encoded bytes to codepoints by grouping 4 bytes
  * to produce the unicode codepoint.
  */
 class Utf32leBytesDecoder extends Utf32BytesDecoder {
   Utf32leBytesDecoder(List<int> utf32EncodedBytes, [int offset = 0,
       int length, bool stripBom = true,
       int replacementCodepoint = UNICODE_REPLACEMENT_CHARACTER_CODEPOINT]) :
       super._fromListRangeIterator(
-          (new _ListRange(utf32EncodedBytes, offset, length)).iterator,
+          (new ListRange(utf32EncodedBytes, offset, length)).iterator,
           replacementCodepoint) {
     if (stripBom && hasUtf32leBom(utf32EncodedBytes, offset, length)) {
       skip();
     }
   }
 
   int decode() {
     utf32EncodedBytesIterator.moveNext();
     int value = utf32EncodedBytesIterator.current;
     utf32EncodedBytesIterator.moveNext();
     value += (utf32EncodedBytesIterator.current << 8);
     utf32EncodedBytesIterator.moveNext();
     value += (utf32EncodedBytesIterator.current << 16);
     utf32EncodedBytesIterator.moveNext();
     value += (utf32EncodedBytesIterator.current << 24);
     return value;
   }
 }
 
 bool _validCodepoint(int codepoint) {
   return (codepoint >= 0 && codepoint < UNICODE_UTF16_RESERVED_LO) ||
       (codepoint > UNICODE_UTF16_RESERVED_HI &&
       codepoint < UNICODE_VALID_RANGE_MAX);
 }