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

package/lib/types/with-schemas/checkpoints.d.ts

@@ -137,6 +137,8 @@ export type CheckpointsListenerStats = {
  * registering and removing a listener for them.
  *
  * ```js
+ * import {createCheckpoints, createStore} from 'tinybase';
+ *
  * const store = createStore()
  *   .setTables({pets: {fido: {sold: false}}})
  *   .setValue('open', true);
@@ -178,7 +180,6 @@ export type CheckpointsListenerStats = {
  * // Previous redo of checkpoints '1' and '2' are now not possible.
  *
  * checkpoints.delListener(listenerId);
- * checkpoints.destroy();
  * ```
  * @see Relationships And Checkpoints guides
  * @see Todo App demos
@@ -209,6 +210,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * number of checkpoints to demonstrate the oldest being pruned.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {views: 0}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -253,6 +256,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoints, one with a label.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -307,6 +312,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoints, one with a label, which are both then re-labelled.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -355,6 +362,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const checkpoints = createCheckpoints(createStore());
    * checkpoints.getStore().setCell('pets', 'fido', 'species', 'dog');
    * checkpoints.addCheckpoint();
@@ -381,6 +390,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * Ids of the checkpoints as it sets them and moves around the stack.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -418,6 +429,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * This example iterates over each Checkpoint in a Checkpoints object.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    * const checkpoints = createCheckpoints(store);
    * store.setCell('pets', 'fido', 'sold', true);
@@ -443,6 +456,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * This example shows two simple Checkpoint existence checks.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    * const checkpoints = createCheckpoints(store);
    * console.log(checkpoints.hasCheckpoint('0'));
@@ -469,6 +484,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoint with a label, before retrieving it again.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -485,6 +502,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoint return an `undefined` label.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -525,6 +544,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to the checkpoints.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -553,7 +574,6 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [['0'], '1', []]
    *
    * checkpoints.delListener(listenerId);
-   * checkpoints.destroy();
    * ```
    * @category Listener
    */
@@ -591,6 +611,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * including when the checkpoint no longer exists.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -621,7 +643,6 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // The checkpoint no longer exists.
    *
    * checkpoints.delListener(listenerId);
-   * checkpoints.destroy();
    * ```
    * @category Listener
    */
@@ -649,6 +670,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * and then removes it.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -692,6 +715,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * goes backward to the state of the Store before the change.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -736,6 +761,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * forward again to restore the state with the changes.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -766,6 +793,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * has no effect.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -818,6 +847,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * tries to go to a checkpoint that does not exist.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -878,6 +909,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * a change and then clears the checkpoints.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -909,6 +942,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> {pets: {fido: {sold: true, color: 'brown'}}}
    * console.log(checkpoints.getCheckpointIds());
    * // -> [[], '0', []]
+   *
+   * checkpoints.delListener(listenerId);
    * ```
    * @category Lifecycle
    */
@@ -937,6 +972,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * a change and then clears the forward checkpoints.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -968,6 +1005,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    *
    * console.log(checkpoints.getCheckpointIds());
    * // -> [['0'], '1', []]
+   *
+   * checkpoints.delListener(listenerId);
    * ```
    * @category Lifecycle
    * @since v4.5.3
@@ -986,6 +1025,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * removing the listener.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore().setTables({pets: {fido: {sold: false}}});
    *
    * const checkpoints = createCheckpoints(store);
@@ -1019,6 +1060,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * This example gets the listener statistics of a Checkpoints object.
    *
    * ```js
+   * import {createCheckpoints, createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const checkpoints = createCheckpoints(store);
    * checkpoints.addCheckpointIdsListener(() => {
@@ -1055,6 +1098,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
  * This example creates a Checkpoints object.
  *
  * ```js
+ * import {createCheckpoints, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const checkpoints = createCheckpoints(store);
  * console.log(checkpoints.getCheckpointIds());
@@ -1065,6 +1110,8 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
  * time for the same Store to return the same object.
  *
  * ```js
+ * import {createCheckpoints, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const checkpoints1 = createCheckpoints(store);
  * const checkpoints2 = createCheckpoints(store);

package/lib/types/with-schemas/common.d.ts

@@ -69,6 +69,8 @@ export type SortKey = string | number | boolean;
  * This example creates an Indexes object.
  *
  * ```js
+ * import {createIndexes, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const indexes = createIndexes(store);
  * console.log(indexes.getIndexIds());
@@ -80,6 +82,8 @@ export type SortKey = string | number | boolean;
  * Ids within them) are alphabetically sorted using the defaultSorter function.
  *
  * ```js
+ * import {createIndexes, createStore, defaultSorter} from 'tinybase';
+ *
  * const store = createStore().setTable('pets', {
  *   fido: {species: 'dog'},
  *   felix: {species: 'cat'},

package/lib/types/with-schemas/indexes.d.ts

@@ -217,6 +217,8 @@ export type IndexesListenerStats = {
  * and removing a listener for it.
  *
  * ```js
+ * import {createIndexes, createStore} from 'tinybase';
+ *
  * const store = createStore().setTable('pets', {
  *   fido: {species: 'dog'},
  *   felix: {species: 'cat'},
@@ -331,6 +333,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * simple Index based on the values in the `species` Cell.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -350,6 +354,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * Index based on the first letter of the pets' names.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -369,6 +375,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * Index based on each of the letters present in the pets' names.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -393,6 +401,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * Ids within them) are alphabetically sorted.
    *
    * ```js
+   * import {createIndexes, createStore, defaultSorter} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -444,6 +454,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -478,6 +490,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const indexes = createIndexes(createStore());
    * indexes.setIndexDefinition('bySpecies', 'pets', 'species');
    * indexes.getStore().setCell('pets', 'fido', 'species', 'dog');
@@ -497,6 +511,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * the Ids of the definitions.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const indexes = createIndexes(createStore())
    *   .setIndexDefinition('bySpecies', 'pets', 'species')
    *   .setIndexDefinition('byColor', 'pets', 'color');
@@ -529,6 +545,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * Slice Id within them.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog', color: 'brown'},
    *   felix: {species: 'cat', color: 'black'},
@@ -573,6 +591,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * This example iterates over each Row in a Slice, and lists its Id.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -604,6 +624,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * This example shows two simple Index existence checks.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const indexes = createIndexes(createStore());
    * indexes.setIndexDefinition('bySpecies', 'pets', 'species');
    * console.log(indexes.hasIndex('bySpecies'));
@@ -625,6 +647,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * This example shows two simple Index existence checks.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -659,6 +683,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * queries it (and a non-existent definition) to get the underlying Table Id.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const indexes = createIndexes(createStore());
    * indexes.setIndexDefinition('bySpecies', 'pets', 'species');
    *
@@ -686,6 +712,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * the Index (and also the Slice Ids in an Index that has not been defined).
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -719,6 +747,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * (and also the Row Ids in Slices that do not exist).
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -760,6 +790,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * definition.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -810,6 +842,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to a specific Index.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -819,13 +853,10 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * const indexes = createIndexes(store);
    * indexes.setIndexDefinition('bySpecies', 'pets', 'species');
    *
-   * const listenerId = indexes.addSliceIdsListener(
-   *   'bySpecies',
-   *   (indexes, indexId) => {
-   *     console.log('Slice Ids for bySpecies index changed');
-   *     console.log(indexes.getSliceIds('bySpecies'));
-   *   },
-   * );
+   * const listenerId = indexes.addSliceIdsListener('bySpecies', (indexes) => {
+   *   console.log('Slice Ids for bySpecies index changed');
+   *   console.log(indexes.getSliceIds('bySpecies'));
+   * });
    *
    * store.setRow('pets', 'lowly', {species: 'worm'});
    * // -> 'Slice Ids for bySpecies index changed'
@@ -838,6 +869,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to any Index.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog', color: 'brown'},
    *   felix: {species: 'cat', color: 'black'},
@@ -907,6 +940,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to a specific Slice.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -919,7 +954,7 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * const listenerId = indexes.addSliceRowIdsListener(
    *   'bySpecies',
    *   'dog',
-   *   (indexes, indexId, sliceId) => {
+   *   (indexes) => {
    *     console.log('Row Ids for dog slice in bySpecies index changed');
    *     console.log(indexes.getSliceRowIds('bySpecies', 'dog'));
    *   },
@@ -936,6 +971,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * listener that responds to any changes to any Slice.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog', color: 'brown'},
    *   felix: {species: 'cat', color: 'black'},
@@ -993,6 +1030,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * then removes it.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -1002,12 +1041,9 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * const indexes = createIndexes(store);
    * indexes.setIndexDefinition('bySpecies', 'pets', 'species');
    *
-   * const listenerId = indexes.addSliceIdsListener(
-   *   'bySpecies',
-   *   (indexes, indexId) => {
-   *     console.log('Slice Ids for bySpecies index changed');
-   *   },
-   * );
+   * const listenerId = indexes.addSliceIdsListener('bySpecies', () => {
+   *   console.log('Slice Ids for bySpecies index changed');
+   * });
    *
    * store.setRow('pets', 'lowly', {species: 'worm'});
    * // -> 'Slice Ids for bySpecies index changed'
@@ -1034,6 +1070,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * and then destroys it again, removing the listener.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -1072,6 +1110,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
    * This example gets the listener statistics of an Indexes object.
    *
    * ```js
+   * import {createIndexes, createStore} from 'tinybase';
+   *
    * const store = createStore();
    * const indexes = createIndexes(store);
    * indexes.addSliceIdsListener(null, () => {
@@ -1108,6 +1148,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
  * This example creates an Indexes object.
  *
  * ```js
+ * import {createIndexes, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const indexes = createIndexes(store);
  * console.log(indexes.getIndexIds());
@@ -1118,6 +1160,8 @@ export interface Indexes<in out Schemas extends OptionalSchemas> {
  * for the same Store to return the same object.
  *
  * ```js
+ * import {createIndexes, createStore} from 'tinybase';
+ *
  * const store = createStore();
  * const indexes1 = createIndexes(store);
  * const indexes2 = createIndexes(store);

package/lib/types/with-schemas/mergeable-store.d.ts

@@ -278,6 +278,15 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    */
   merge(mergeableStore: MergeableStore<Schemas>): MergeableStore<Schemas>;
 
+  /**
+   * 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;
+
   /**
    * The setTablesSchema method lets you specify the TablesSchema of the tabular
    * part of the Store.
@@ -294,6 +303,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * 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'},
@@ -328,6 +339,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * 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},
    * });
@@ -364,6 +377,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * been created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setSchema(
    *   {
    *     pets: {
@@ -386,6 +401,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * created.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -418,6 +435,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * This example removes the TablesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setTablesSchema({
    *   pets: {species: {type: 'string'}},
    * });
@@ -438,6 +457,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * This example removes the ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore().setValuesSchema({
    *   sold: {type: 'boolean', default: false},
    * });
@@ -462,6 +483,8 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * This example removes the TablesSchema and ValuesSchema of a Store.
    *
    * ```js
+   * import {createStore} from 'tinybase';
+   *
    * const store = createStore()
    *   .setTablesSchema({
    *     pets: {species: {type: 'string'}},