added library-level description for dart:indexed_db

tools/dom/templates/html/dart2js/indexed_db_dart2js.darttemplate

 // 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.
 
 // DO NOT EDIT - unless you are editing documentation as per:
 // https://code.google.com/p/dart/wiki/ContributingHTMLDocumentation
 // Auto-generated dart:svg library.
 
+/**
+ * A client-side storage mechanism with efficient data retrieval and search.
+ *
+ * The classes in this library provide an interface
+ * to the browser's indexed database, if it has one.
+ * To use this library in your code:
+ *
+ *     import 'dart:indexed_db';
+ *
+ * A web app can determine if the browser has an
+ * indexed database by using the `supported` property from
+ * the [IdbFactory] class:
+ *
+ *     if (IdbFactory.supported)
+ *       // Use indexeddb.
+ *     else
+ *       // Find an alternative.
+ *
+ * Open an indexed database using the top-level [Window] object for the app.
+ * For example:
+ *
+ *     Future open() {
+ *       return window.indexedDB.open('myIndexedDB',
+ *           version: 1,
+ *           onUpgradeNeeded: /* Initalize the database. */ )
+ *         .then( /* Load data from the database. */ );
+ *     }
+ *
+ * ## Other resources
+ *
+ * For a tutorial about using this library,
+ * check out
+ * [Use IndexedDB](https://www.dartlang.org/docs/tutorials/indexeddb/).
+ */
 library dart.dom.indexed_db;
 
 import 'dart:async';
 import 'dart:html';
 import 'dart:html_common';
 import 'dart:typed_data';
 import 'dart:_js_helper' show Creates, Returns, JSName, Null;
 import 'dart:_foreign_helper' show JS;
 import 'dart:_interceptors' show Interceptor, JSExtendableArray;
 
@@ skipping 106 matching lines @@
 
 /// May modify original.  If so, action is idempotent.
 _convertNativeToDart_IDBAny(object) {
   return convertNativeToDart_AcceptStructuredClone(object, mustCopy: false);
 }
 
 // TODO(sra): Add DateTime.
 const String _idbKey = 'JSExtendableArray|=Object|num|String';
 const _annotation_Creates_IDBKey = const Creates(_idbKey);
 const _annotation_Returns_IDBKey = const Returns(_idbKey);