tinybase 5.0.0-beta.17 → 5.0.0-beta.18

package/lib/types/store.d.ts

@@ -26,7 +26,9 @@ import {StoreAlias} from './internal/store.d.ts';
  * guaranteed to contain a boolean `sold` Cell that defaults to `false`.
  *
  * ```js
- * const tableSchema: TablesSchema = {
+ * import {TablesSchema} from 'tinybase';
+ *
+ * export const tableSchema: TablesSchema = {
  *   pets: {
  *     species: {type: 'string'},
  *     sold: {type: 'boolean', default: false},
@@ -56,7 +58,12 @@ export type TablesSchema = {[tableId: Id]: {[cellId: Id]: CellSchema}};
  * present, and defaults it to `false`.
  *
  * ```js
- * const requiredBoolean: CellSchema = {type: 'boolean', default: false};
+ * import {CellSchema} from 'tinybase';
+ *
+ * export const requiredBoolean: CellSchema = {
+ *   type: 'boolean',
+ *   default: false,
+ * };
  * ```
  * @category Schema
  */
@@ -76,7 +83,9 @@ export type CellSchema =
  * called `open`, that defaults to `false`.
  *
  * ```js
- * const valuesSchema: ValuesSchema = {
+ * import {ValuesSchema} from 'tinybase';
+ *
+ * export const valuesSchema: ValuesSchema = {
  *   open: {type: 'boolean', default: false},
  * };
  * ```
@@ -104,7 +113,12 @@ export type ValuesSchema = {[valueId: Id]: ValueSchema};
  * present, and defaults it to `false`.
  *
  * ```js
- * const requiredBoolean: ValueSchema = {type: 'boolean', default: false};
+ * import {ValueSchema} from 'tinybase';
+ *
+ * export const requiredBoolean: ValueSchema = {
+ *   type: 'boolean',
+ *   default: false,
+ * };
  * ```
  * @category Schema
  * @since v3.0.0
@@ -197,7 +211,9 @@ export type Content = [Tables, Values];
  * Table objects, keyed by their Id.
  * @example
  * ```js
- * const tables: Tables = {
+ * import {Tables} from 'tinybase';
+ *
+ * export const tables: Tables = {
  *   pets: {
  *     fido: {species: 'dog', color: 'brown'},
  *     felix: {species: 'cat'},
@@ -221,7 +237,9 @@ export type Tables = {[tableId: Id]: Table};
  * Id.
  * @example
  * ```js
- * const table: Table = {
+ * import {Table} from 'tinybase';
+ *
+ * export const table: Table = {
  *   fido: {species: 'dog', color: 'brown'},
  *   felix: {species: 'cat'},
  * };
@@ -238,7 +256,9 @@ export type Table = {[rowId: Id]: Row};
  * object containing individual Cell objects, keyed by their Id.
  * @example
  * ```js
- * const row: Row = {species: 'dog', color: 'brown'};
+ * import {Row} from 'tinybase';
+ *
+ * export const row: Row = {species: 'dog', color: 'brown'};
  * ```
  * @category Store
  */
@@ -252,7 +272,9 @@ export type Row = {[cellId: Id]: Cell};
  * number, or boolean.
  * @example
  * ```js
- * const cell: Cell = 'dog';
+ * import {Cell} from 'tinybase';
+ *
+ * export const cell: Cell = 'dog';
  * ```
  * @category Store
  */
@@ -279,7 +301,9 @@ export type CellOrUndefined = Cell | undefined;
  * their Id.
  * @example
  * ```js
- * const values: Values = {open: true, employees: 4};
+ * import {Values} from 'tinybase';
+ *
+ * export const values: Values = {open: true, employees: 4};
  * ```
  * @category Store
  * @since v3.0.0
@@ -295,7 +319,9 @@ export type Values = {[valueId: Id]: Value};
  * string, number, or boolean.
  * @example
  * ```js
- * const value: Value = 'dog';
+ * import {Value} from 'tinybase';
+ *
+ * export const value: Value = 'dog';
  * ```
  * @category Store
  * @since v3.0.0
@@ -1697,6 +1723,8 @@ export type StoreListenerStats = {
  * adding and getting some data, and then registering and removing a listener.
  *
  * ```js
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * console.log(store.getRow('pets', 'fido'));
  * // -> {species: 'dog'}
@@ -1734,6 +1762,8 @@ export interface Store {
    * This example retrieves the content of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog'}}})
    *   .setValues({open: true, employees: 3});
@@ -1745,6 +1775,8 @@ export interface Store {
    * empty objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getContent());
    * // -> [{}, {}]
@@ -1766,6 +1798,8 @@ export interface Store {
    * This example retrieves the tabular data in a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -1778,6 +1812,8 @@ export interface Store {
    * object.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getTables());
    * // -> {}
@@ -1796,6 +1832,8 @@ export interface Store {
    * This example retrieves the Table Ids in a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -1808,6 +1846,8 @@ export interface Store {
    * array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getTableIds());
    * // -> []
@@ -1829,6 +1869,8 @@ export interface Store {
    * This example retrieves the data in a single Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -1841,6 +1883,8 @@ export interface Store {
    * object.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getTable('employees'));
    * // -> {}
@@ -1861,6 +1905,8 @@ export interface Store {
    * This example retrieves the Cell Ids used across a whole Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog', color: 'brown'},
@@ -1876,6 +1922,8 @@ export interface Store {
    * exist, returning an empty array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getTableCellIds('species'));
    * // -> []
@@ -1898,6 +1946,8 @@ export interface Store {
    * This example retrieves the number of Row objects in the Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -1912,6 +1962,8 @@ export interface Store {
    * returning zero.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getRowCount('employees'));
    * // -> 0
@@ -1932,6 +1984,8 @@ export interface Store {
    * This example retrieves the Row Ids in a Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -1946,6 +2000,8 @@ export interface Store {
    * returning an empty array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getRowIds('employees'));
    * // -> []
@@ -1983,6 +2039,8 @@ export interface Store {
    * This example retrieves sorted Row Ids in a Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -1996,6 +2054,8 @@ export interface Store {
    * This example retrieves sorted Row Ids in a Table in reverse order.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -2010,6 +2070,8 @@ export interface Store {
    * This example retrieves two pages of Row Ids in a Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {price: 6},
@@ -2030,6 +2092,8 @@ export interface Store {
    * `cellId` parameter is undefined.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -2045,6 +2109,8 @@ export interface Store {
    * returning an empty array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getSortedRowIds('employees'));
    * // -> []
@@ -2074,6 +2140,8 @@ export interface Store {
    * This example retrieves the data in a single Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -2088,6 +2156,8 @@ export interface Store {
    * object.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getRow('pets', 'felix'));
    * // -> {}
@@ -2109,6 +2179,8 @@ export interface Store {
    * This example retrieves the Cell Ids in a Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog', color: 'brown'},
@@ -2122,6 +2194,8 @@ export interface Store {
    * an empty array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getCellIds('pets', 'felix'));
    * // -> []
@@ -2141,6 +2215,8 @@ export interface Store {
    * This example retrieves a single Cell.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2151,6 +2227,8 @@ export interface Store {
    * This example retrieves a Cell that does not exist, returning `undefined`.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getCell('pets', 'fido', 'color'));
    * // -> undefined
@@ -2171,6 +2249,8 @@ export interface Store {
    * This example retrieves the set of keyed Values in the Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValues());
    * // -> {open: true, employees: 3}
@@ -2180,6 +2260,8 @@ export interface Store {
    * empty object.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getValues());
    * // -> {}
@@ -2199,6 +2281,8 @@ export interface Store {
    * This example retrieves the Value Ids in a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValueIds());
    * // -> ['open', 'employees']
@@ -2208,6 +2292,8 @@ export interface Store {
    * returning an empty array.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getValueIds());
    * // -> []
@@ -2225,6 +2311,8 @@ export interface Store {
    * This example retrieves a single Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValue('employees'));
    * // -> 3
@@ -2233,6 +2321,8 @@ export interface Store {
    * This example retrieves a Value that does not exist, returning `undefined`.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValue('website'));
    * // -> undefined
@@ -2250,6 +2340,8 @@ export interface Store {
    * This example shows simple existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.hasTables());
    * // -> false
@@ -2270,6 +2362,8 @@ export interface Store {
    * This example shows two simple Table existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasTable('pets'));
    * // -> true
@@ -2290,6 +2384,8 @@ export interface Store {
    * This example shows two simple Cell existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}, felix: {legs: 4}},
    * });
@@ -2315,6 +2411,8 @@ export interface Store {
    * This example shows two simple Row existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasRow('pets', 'fido'));
    * // -> true
@@ -2336,6 +2434,8 @@ export interface Store {
    * This example shows two simple Cell existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasCell('pets', 'fido', 'species'));
    * // -> true
@@ -2354,6 +2454,8 @@ export interface Store {
    * This example shows simple existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.hasValues());
    * // -> false
@@ -2375,6 +2477,8 @@ export interface Store {
    * This example shows two simple Value existence checks.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * console.log(store.hasValue('open'));
    * // -> true
@@ -2394,6 +2498,8 @@ export interface Store {
    * This example serializes the contents of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getTablesJson());
    * // -> '{"pets":{"fido":{"species":"dog"}}}'
@@ -2402,6 +2508,8 @@ export interface Store {
    * This example serializes the contents of an empty Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getTablesJson());
    * // -> '{}'
@@ -2419,6 +2527,8 @@ export interface Store {
    * This example serializes the keyed value contents of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * console.log(store.getValuesJson());
    * // -> '{"open":true}'
@@ -2427,6 +2537,8 @@ export interface Store {
    * This example serializes the contents of an empty Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getValuesJson());
    * // -> '{}'
@@ -2449,6 +2561,8 @@ export interface Store {
    * This example serializes the tabular and keyed value contents of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog'}}})
    *   .setValues({open: true});
@@ -2459,6 +2573,8 @@ export interface Store {
    * This example serializes the contents of an empty Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getJson());
    * // -> '[{},{}]'
@@ -2479,6 +2595,8 @@ export interface Store {
    * This example serializes the TablesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -2492,6 +2610,8 @@ export interface Store {
    * This example serializes the TablesSchema of an empty Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getTablesSchemaJson());
    * // -> '{}'
@@ -2513,6 +2633,8 @@ export interface Store {
    * This example serializes the ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({
    *   open: {type: 'boolean', default: false},
    * });
@@ -2523,6 +2645,8 @@ export interface Store {
    * This example serializes the ValuesSchema of an empty Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getValuesSchemaJson());
    * // -> '{}'
@@ -2546,6 +2670,8 @@ export interface Store {
    * This example serializes the TablesSchema and ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTablesSchema({
    *     pets: {
@@ -2563,6 +2689,8 @@ export interface Store {
    * Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.getSchemaJson());
    * // -> '[{},{}]'
@@ -2579,6 +2707,8 @@ export interface Store {
    * This example sets a TablesSchema and checks that it is present.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {
    *     price: {type: 'number'},
@@ -2604,6 +2734,8 @@ export interface Store {
    * This example sets a ValuesSchema and checks that it is present.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({open: {type: 'boolean'}});
    * console.log(store.hasValuesSchema());
    * // -> true
@@ -2641,6 +2773,8 @@ export interface Store {
    * This example sets the data of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setContent([
    *   {pets: {fido: {species: 'dog'}}},
    *   {open: true, employees: 3},
@@ -2655,6 +2789,8 @@ export interface Store {
    * invalid, and then completely invalid objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setContent([
    *   {pets: {fido: {species: 'dog'}}},
    *   {open: true, employees: 3},
@@ -2697,6 +2833,8 @@ export interface Store {
    * This example sets the tabular data of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -2709,6 +2847,8 @@ export interface Store {
    * partly invalid, and then completely invalid, Tables objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setTables({pets: {felix: {species: 'cat', bug: []}}});
@@ -2747,6 +2887,8 @@ export interface Store {
    * This example sets the data of a single Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -2759,6 +2901,8 @@ export interface Store {
    * invalid, and then completely invalid, Table objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setTable('pets', {felix: {species: 'cat', bug: []}});
@@ -2799,6 +2943,8 @@ export interface Store {
    * This example sets the data of a single Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setRow('pets', 'fido', {species: 'dog'});
    * console.log(store.getTables());
    * // -> {pets: {fido: {species: 'dog'}}}
@@ -2808,6 +2954,8 @@ export interface Store {
    * invalid, and then completely invalid, Row objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setRow('pets', 'fido', {color: 'brown', bug: []});
@@ -2856,6 +3004,8 @@ export interface Store {
    * This example adds a single Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * console.log(store.addRow('pets', {species: 'dog'}));
    * // -> '0'
@@ -2867,6 +3017,8 @@ export interface Store {
    * and then completely invalid, Row objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {'0': {species: 'dog'}}});
    *
    * console.log(store.addRow('pets', {species: 'cat', bug: []}));
@@ -2908,6 +3060,8 @@ export interface Store {
    * This example sets some of the data of a single Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2920,6 +3074,8 @@ export interface Store {
    * partly invalid, and then completely invalid, Row objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setPartialRow('pets', 'fido', {color: 'brown', bug: []});
@@ -2961,6 +3117,8 @@ export interface Store {
    * This example sets the value of a single Cell.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setCell('pets', 'fido', 'species', 'dog');
    * console.log(store.getTables());
    * // -> {pets: {fido: {species: 'dog'}}}
@@ -2969,6 +3127,8 @@ export interface Store {
    * This example sets the data of a single Cell by mapping the existing value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const increment = (cell) => cell + 1;
    * const store = createStore().setTables({pets: {fido: {visits: 1}}});
    *
@@ -2981,6 +3141,8 @@ export interface Store {
    * Cell value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setCell('pets', 'fido', 'bug', []);
@@ -3014,6 +3176,8 @@ export interface Store {
    * This example sets the Values of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValues());
    * // -> {open: true, employees: 3}
@@ -3023,6 +3187,8 @@ export interface Store {
    * invalid, and then completely invalid, Values objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    *
    * store.setValues({employees: 3, bug: []});
@@ -3062,6 +3228,8 @@ export interface Store {
    * This example sets some of the keyed value data in a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * store.setPartialValues({employees: 3});
    * console.log(store.getValues());
@@ -3072,6 +3240,8 @@ export interface Store {
    * partly invalid, and then completely invalid, Values objects.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    *
    * store.setPartialValues({employees: 3, bug: []});
@@ -3110,6 +3280,8 @@ export interface Store {
    * This example sets a single Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValue('open', true);
    * console.log(store.getValues());
    * // -> {open: true}
@@ -3118,6 +3290,8 @@ export interface Store {
    * This example sets the data of a single Value by mapping the existing Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const increment = (value) => value + 1;
    * const store = createStore().setValues({employees: 3});
    *
@@ -3129,6 +3303,8 @@ export interface Store {
    * This example attempts to set an invalid Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({employees: 3});
    *
    * store.setValue('bug', []);
@@ -3164,6 +3340,8 @@ export interface Store {
    * removes a Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog', color: 'brown'}}})
    *   .setValues({open: true});
@@ -3193,6 +3371,8 @@ export interface Store {
    * This example sets the tabular contents of a Store from a serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setTablesJson('{"pets": {"fido": {"species": "dog"}}}');
    * console.log(store.getTables());
@@ -3203,6 +3383,8 @@ export interface Store {
    * invalid serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setTablesJson('{"pets": {"fido": {');
    * console.log(store.getTables());
@@ -3227,6 +3409,8 @@ export interface Store {
    * This example sets the keyed value contents of a Store from a serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setValuesJson('{"open": true}');
    * console.log(store.getValues());
@@ -3237,6 +3421,8 @@ export interface Store {
    * invalid serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setValuesJson('{"open": false');
    * console.log(store.getValues());
@@ -3270,6 +3456,8 @@ export interface Store {
    * serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setJson('[{"pets": {"fido": {"species": "dog"}}}, {"open": true}]');
    * console.log(store.getTables());
@@ -3282,6 +3470,8 @@ export interface Store {
    * legacy single-object serialization (compatible with v2.x and earlier).
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setJson('{"pets": {"fido": {"species": "dog"}}}');
    * console.log(store.getTables());
@@ -3294,6 +3484,8 @@ export interface Store {
    * Store from an invalid serialization.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.setValuesJson('[{"pets": {"fido": {"species": "do');
    * console.log(store.getTables());
@@ -3321,6 +3513,8 @@ export interface Store {
    * This example sets the TablesSchema of a Store after it has been created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -3353,6 +3547,8 @@ export interface Store {
    * This example sets the ValuesSchema of a Store after it has been created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({
    *   open: {type: 'boolean', default: false},
    * });
@@ -3387,6 +3583,8 @@ export interface Store {
    * been created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setSchema(
    *   {
    *     pets: {
@@ -3409,6 +3607,8 @@ export interface Store {
    * created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -3431,6 +3631,8 @@ export interface Store {
    * This example removes the data of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.delTables();
@@ -3449,6 +3651,8 @@ export interface Store {
    * This example removes a Table from a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -3473,6 +3677,8 @@ export interface Store {
    * This example removes a Row from a Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}, felix: {species: 'cat'}},
    * });
@@ -3516,6 +3722,8 @@ export interface Store {
    * This example removes a Cell from a Row without a TablesSchema.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', sold: true}},
    * });
@@ -3529,6 +3737,8 @@ export interface Store {
    * its value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', sold: true}},
@@ -3549,6 +3759,8 @@ export interface Store {
    * its value, but uses the `forceDel` parameter to override it.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', sold: true}, felix: {species: 'cat'}},
@@ -3579,6 +3791,8 @@ export interface Store {
    * This example removes all Values from a Store without a ValuesSchema.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * store.delValues();
    *
@@ -3590,6 +3804,8 @@ export interface Store {
    * defaults one of its values.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setValues({open: true, employees: 3})
    *   .setValuesSchema({
@@ -3618,6 +3834,8 @@ export interface Store {
    * This example removes a Value from a Store without a ValuesSchema.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * store.delValue('employees');
    *
@@ -3629,6 +3847,8 @@ export interface Store {
    * its value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setValues({open: true, employees: 3})
    *   .setValuesSchema({
@@ -3652,6 +3872,8 @@ export interface Store {
    * This example removes the TablesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {species: {type: 'string'}},
    * });
@@ -3670,6 +3892,8 @@ export interface Store {
    * This example removes the ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({
    *   sold: {type: 'boolean', default: false},
    * });
@@ -3692,6 +3916,8 @@ export interface Store {
    * This example removes the TablesSchema and ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTablesSchema({
    *     pets: {species: {type: 'string'}},
@@ -3743,6 +3969,8 @@ export interface Store {
    * once.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addRowListener('pets', 'fido', () => console.log('Fido changed'));
    *
@@ -3765,6 +3993,8 @@ export interface Store {
    * change.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addCellListener(
    *   'pets',
@@ -3796,6 +4026,8 @@ export interface Store {
    * judges that the transaction should be rolled back to its original state.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog', color: 'brown'}}})
    *   .setValues({open: true});
@@ -3863,6 +4095,8 @@ export interface Store {
    * second case, the Row listener is only called once.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addRowListener('pets', 'fido', () => console.log('Fido changed'));
    *
@@ -3896,6 +4130,8 @@ export interface Store {
    * detail about what changed is enumerated.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog', color: 'brown'}}})
    *   .setValues({open: true});
@@ -3930,6 +4166,8 @@ export interface Store {
    * detail about what changed is enumerated.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog', color: 'brown'}}})
    *   .setValues({open: true});
@@ -3996,6 +4234,8 @@ export interface Store {
    * second case, the Row listener is only called once.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addRowListener('pets', 'fido', () => console.log('Fido changed'));
    *
@@ -4019,6 +4259,8 @@ export interface Store {
    * the transaction should be rolled back to its original state.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({pets: {fido: {species: 'dog', color: 'brown'}}})
    *   .setValues({open: true});
@@ -4071,6 +4313,8 @@ export interface Store {
    * within them.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -4103,6 +4347,8 @@ export interface Store {
    * This example iterates over each Cell Id used across the whole Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}, felix: {species: 'cat', legs: 4}},
    * });
@@ -4132,6 +4378,8 @@ export interface Store {
    * within them.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -4165,6 +4413,8 @@ export interface Store {
    * This example iterates over each Cell in a Row, and lists its value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4190,6 +4440,8 @@ export interface Store {
    * This example iterates over each Value in a Store, and lists its value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * store.forEachValue((valueId, value) => {
    *   console.log(`${valueId}: ${value}`);
@@ -4230,6 +4482,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4250,6 +4504,8 @@ export interface Store {
    * removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const listenerId = store.addHasTablesListener(
    *   (store, hasTables) => store.setValue('hasTables', hasTables),
@@ -4296,6 +4552,8 @@ export interface Store {
    * Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4315,6 +4573,8 @@ export interface Store {
    * Store, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4362,6 +4622,8 @@ export interface Store {
    * Ids.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addTableIdsListener((store) => {
    *   console.log('Table Ids changed');
@@ -4379,6 +4641,8 @@ export interface Store {
    * Ids, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addTableIdsListener(
    *   (store) => store.setCell('meta', 'update', 'store', true),
@@ -4427,6 +4691,8 @@ export interface Store {
    * added or removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4450,6 +4716,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4472,6 +4740,8 @@ export interface Store {
    * added or removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4528,6 +4798,8 @@ export interface Store {
    * specific Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4550,6 +4822,8 @@ export interface Store {
    * Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4569,6 +4843,8 @@ export interface Store {
    * specific Table, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4627,6 +4903,8 @@ export interface Store {
    * Ids that appear anywhere in a Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4646,6 +4924,8 @@ export interface Store {
    * Ids that appear anywhere in any Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    *   species: {dog: {price: 5}},
@@ -4673,6 +4953,8 @@ export interface Store {
    * anywhere in a Table, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4736,6 +5018,8 @@ export interface Store {
    * added to or removed from the Table as a whole.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4762,6 +5046,8 @@ export interface Store {
    * added to or removed from the Table as a whole.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4788,6 +5074,8 @@ export interface Store {
    * added or removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -4846,6 +5134,8 @@ export interface Store {
    * of Row objects in a specific Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowCountListener(
    *   'pets',
@@ -4864,6 +5154,8 @@ export interface Store {
    * in the number of Row objects of any Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowCountListener(
    *   null,
@@ -4885,6 +5177,8 @@ export interface Store {
    * the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowCountListener(
    *   'pets',
@@ -4941,6 +5235,8 @@ export interface Store {
    * Ids of a specific Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener('pets', (store) => {
    *   console.log('Row Ids for pets table changed');
@@ -4958,6 +5254,8 @@ export interface Store {
    * Ids of any Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener(null, (store, tableId) => {
    *   console.log(`Row Ids for ${tableId} table changed`);
@@ -4978,6 +5276,8 @@ export interface Store {
    * Ids of a specific Table, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener(
    *   'pets',
@@ -5051,6 +5351,8 @@ export interface Store {
    * Row Ids of a specific Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     cujo: {species: 'wolf'},
@@ -5084,6 +5386,8 @@ export interface Store {
    * paginated section of the sorted Row Ids of a specific Table.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {price: 6},
@@ -5122,6 +5426,8 @@ export interface Store {
    * since the `cellId` parameter is explicitly undefined.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -5156,6 +5462,8 @@ export interface Store {
    * not changed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -5189,6 +5497,8 @@ export interface Store {
    * Row Ids of a specific Table, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {
    *     cujo: {species: 'wolf'},
@@ -5263,6 +5573,8 @@ export interface Store {
    * added or removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5289,6 +5601,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5314,6 +5628,8 @@ export interface Store {
    * added or removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5379,6 +5695,8 @@ export interface Store {
    * specific Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5401,6 +5719,8 @@ export interface Store {
    * This example registers a listener that responds to any changes to any Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5424,6 +5744,8 @@ export interface Store {
    * specific Row, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5490,6 +5812,8 @@ export interface Store {
    * Ids of a specific Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addCellIdsListener('pets', 'fido', (store) => {
    *   console.log('Cell Ids for fido row in pets table changed');
@@ -5507,6 +5831,8 @@ export interface Store {
    * Ids of any Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addCellIdsListener(
    *   null,
@@ -5531,6 +5857,8 @@ export interface Store {
    * Ids of a specific Row, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addCellIdsListener(
    *   'pets',
@@ -5595,6 +5923,8 @@ export interface Store {
    * added or removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5623,6 +5953,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5650,6 +5982,8 @@ export interface Store {
    * added or removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5719,6 +6053,8 @@ export interface Store {
    * specific Cell.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5744,6 +6080,8 @@ export interface Store {
    * This example registers a listener that responds to any changes to any Cell.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5770,6 +6108,8 @@ export interface Store {
    * specific Cell, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -5826,6 +6166,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addHasValuesListener((store, hasValues) => {
    *   console.log('Values ' + (hasValues ? 'added' : 'removed'));
@@ -5844,6 +6186,8 @@ export interface Store {
    * removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const listenerId = store.addHasValuesListener(
    *   (store, hasValues) => store.setValue('hasValues', hasValues),
@@ -5890,6 +6234,8 @@ export interface Store {
    * Store's Values.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addValuesListener((store, getValueChange) => {
    *   console.log('values changed');
@@ -5907,9 +6253,11 @@ export interface Store {
    * Store's Values, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addValuesListener(
-   *   (store, getValueChange) => store.setValue('updated', true),
+   *   (store) => store.setValue('updated', true),
    *   true,
    * );
    *
@@ -5953,6 +6301,8 @@ export interface Store {
    * Ids.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * const listenerId = store.addValueIdsListener((store) => {
    *   console.log('Value Ids changed');
@@ -5970,6 +6320,8 @@ export interface Store {
    * Ids, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * const listenerId = store.addValueIdsListener(
    *   (store) => store.setValue('updated', true),
@@ -6019,6 +6371,8 @@ export interface Store {
    * added or removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addHasValueListener(
    *   'employees',
@@ -6040,6 +6394,8 @@ export interface Store {
    * removed.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addHasValueListener(
    *   null,
@@ -6060,10 +6416,12 @@ export interface Store {
    * added or removed, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addHasValueListener(
    *   'employees',
-   *   (store, valueId) => store.setValue('updated', true),
+   *   (store) => store.setValue('updated', true),
    *   true,
    * );
    *
@@ -6113,6 +6471,8 @@ export interface Store {
    * specific Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addValueListener(
    *   'employees',
@@ -6135,6 +6495,8 @@ export interface Store {
    * Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addValueListener(null, (store, valueId) => {
    *   console.log(`${valueId} value changed`);
@@ -6152,10 +6514,12 @@ export interface Store {
    * specific Value, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    * const listenerId = store.addValueListener(
    *   'employees',
-   *   (store, valueId) => store.setValue('updated', true),
+   *   (store) => store.setValue('updated', true),
    *   true,
    * );
    *
@@ -6233,6 +6597,8 @@ export interface Store {
    * specific Cell.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -6259,6 +6625,8 @@ export interface Store {
    * or Tables objects are provided.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -6308,6 +6676,8 @@ export interface Store {
    * values in a Row.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -6370,6 +6740,8 @@ export interface Store {
    * specific Cell, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -6454,6 +6826,8 @@ export interface Store {
    * specific Value.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * const listenerId = store.addInvalidValueListener(
    *   'open',
@@ -6475,6 +6849,8 @@ export interface Store {
    * responds to cases where an empty Values object is provided.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * const listenerId = store.addInvalidValueListener(
    *   null,
@@ -6499,6 +6875,8 @@ export interface Store {
    * where missing parameters are provided for optional, and defaulted Values.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({
    *   open: {type: 'boolean', default: false},
    *   employees: {type: 'number'},
@@ -6556,6 +6934,8 @@ export interface Store {
    * specific Value, and which also mutates the Store itself.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true});
    * const listenerId = store.addInvalidValueListener(
    *   'open',
@@ -6599,16 +6979,16 @@ export interface Store {
    * transaction, just before its listeners will be called.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', color: 'brown'}},
    *   })
    *   .setValues({open: true, employees: 3});
-   * const listenerId = store.addStartTransactionListener(
-   *   (store, cellsTouched, valuesTouched) => {
-   *     console.log('Transaction started');
-   *   },
-   * );
+   * const listenerId = store.addStartTransactionListener(() => {
+   *   console.log('Transaction started');
+   * });
    *
    * store.transaction(() =>
    *   store.setCell('pets', 'fido', 'color', 'brown').setValue('employees', 3),
@@ -6659,6 +7039,8 @@ export interface Store {
    * the `cellsTouched` and `valuesTouched` parameters in the listener work.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', color: 'brown'}},
@@ -6755,6 +7137,8 @@ export interface Store {
    * the `cellsTouched` and `valuesTouched` parameters in the listener work.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', color: 'brown'}},
@@ -6833,6 +7217,8 @@ export interface Store {
    * condition to the existing data.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const validColors = ['walnut', 'brown', 'black'];
    * const store = createStore();
    * const listenerId = store.addCellListener(
@@ -6866,6 +7252,8 @@ export interface Store {
    * called and fires for two Tables in the Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -6886,6 +7274,8 @@ export interface Store {
    * and fires for two Values in the Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValues({open: true, employees: 3});
    *
    * const listenerId = store.addValueListener(
@@ -6907,6 +7297,8 @@ export interface Store {
    * receives empty arguments. The latter is not called at all.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    *
    * const listenerId = store.addWillFinishTransactionListener(
@@ -6946,6 +7338,8 @@ export interface Store {
    * This example registers a listener and then removes it.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -6982,6 +7376,8 @@ export interface Store {
    * This example gets the listener statistics of a small and simple Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore();
    * store.addTablesListener(() => console.log('Tables changed'));
    * store.addRowIdsListener(() => console.log('Row Ids changed'));
@@ -6995,6 +7391,15 @@ export interface Store {
    * @category Development
    */
   getListenerStats(): StoreListenerStats;
+
+  /**
+   * The isMergeable methods lets you know if the Store is mergeable.
+   *
+   * This will always be false for a Store, and true for a MergeableStore.
+   * @category Information
+   * @since v5.0.0
+   */
+  isMergeable: () => boolean;
   //
 }
 
@@ -7009,6 +7414,8 @@ export interface Store {
  * This example creates a Store.
  *
  * ```js
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore();
  * console.log(store.getTables());
  * // -> {}
@@ -7017,6 +7424,8 @@ export interface Store {
  * This example creates a Store with some initial data:
  *
  * ```js
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}}}
@@ -7025,6 +7434,8 @@ export interface Store {
  * This example creates a Store with some initial data and a TablesSchema:
  *
  * ```js
+ * import {createStore} from 'tinybase';
+ *
  * const store = createStore()
  *   .setTables({pets: {fido: {species: 'dog'}}})
  *   .setTablesSchema({