tinybase 0.9.3 → 0.9.4

package/lib/common.d.ts

@@ -57,3 +57,59 @@ export type ParameterizedCallback<Parameter> = (parameter?: Parameter) => void;
  * @category Callback
  */
 export type Callback = () => void;
+
+/**
+ * The SortKey type represents a value that can be used by a sort function.
+ *
+ * @category Parameter
+ */
+export type SortKey = string | number | boolean;
+
+/**
+ * The defaultSorter function is provided as a convenience to sort keys
+ * alphanumerically, and can be provided to the `sliceIdSorter` and
+ * `rowIdSorter` parameters of the setIndexDefinition method in the indexes
+ * module, for example.
+ *
+ * @param sortKey1 The first item of the pair to compare.
+ * @param sortKey2 The second item of the pair to compare.
+ * @returns A number indicating how to sort the pair.
+ * @example
+ * This example creates an Indexes object.
+ *
+ * ```js
+ * const store = createStore();
+ * const indexes = createIndexes(store);
+ * console.log(indexes.getIndexIds());
+ * // -> []
+ * ```
+ * @example
+ * This example creates a Store, creates an Indexes object, and defines an
+ * Index based on the first letter of the pets' names. The Slice Ids (and Row
+ * Ids within them) are alphabetically sorted using the defaultSorter function.
+ *
+ * ```js
+ * const store = createStore().setTable('pets', {
+ *   fido: {species: 'dog'},
+ *   felix: {species: 'cat'},
+ *   cujo: {species: 'dog'},
+ * });
+ *
+ * const indexes = createIndexes(store);
+ * indexes.setIndexDefinition(
+ *   'byFirst', //              indexId
+ *   'pets', //                 tableId
+ *   (_, rowId) => rowId[0], // each Row's Slice Id
+ *   (_, rowId) => rowId, //    each Row's sort key
+ *   defaultSorter, //          sort Slice Ids
+ *   defaultSorter, //          sort Row Ids by sort key
+ * );
+ *
+ * console.log(indexes.getSliceIds('byFirst'));
+ * // -> ['c', 'f']
+ * console.log(indexes.getSliceRowIds('byFirst', 'f'));
+ * // -> ['felix', 'fido']
+ * ```
+ * @category Convenience
+ */
+export function defaultSorter(sortKey1: SortKey, sortKey2: SortKey): number;

package/lib/common.js

@@ -0,0 +1 @@
+const o=(o,t)=>o<t?-1:1;export{o as defaultSorter};

package/lib/debug/common.d.ts

@@ -57,3 +57,59 @@ export type ParameterizedCallback<Parameter> = (parameter?: Parameter) => void;
  * @category Callback
  */
 export type Callback = () => void;
+
+/**
+ * The SortKey type represents a value that can be used by a sort function.
+ *
+ * @category Parameter
+ */
+export type SortKey = string | number | boolean;
+
+/**
+ * The defaultSorter function is provided as a convenience to sort keys
+ * alphanumerically, and can be provided to the `sliceIdSorter` and
+ * `rowIdSorter` parameters of the setIndexDefinition method in the indexes
+ * module, for example.
+ *
+ * @param sortKey1 The first item of the pair to compare.
+ * @param sortKey2 The second item of the pair to compare.
+ * @returns A number indicating how to sort the pair.
+ * @example
+ * This example creates an Indexes object.
+ *
+ * ```js
+ * const store = createStore();
+ * const indexes = createIndexes(store);
+ * console.log(indexes.getIndexIds());
+ * // -> []
+ * ```
+ * @example
+ * This example creates a Store, creates an Indexes object, and defines an
+ * Index based on the first letter of the pets' names. The Slice Ids (and Row
+ * Ids within them) are alphabetically sorted using the defaultSorter function.
+ *
+ * ```js
+ * const store = createStore().setTable('pets', {
+ *   fido: {species: 'dog'},
+ *   felix: {species: 'cat'},
+ *   cujo: {species: 'dog'},
+ * });
+ *
+ * const indexes = createIndexes(store);
+ * indexes.setIndexDefinition(
+ *   'byFirst', //              indexId
+ *   'pets', //                 tableId
+ *   (_, rowId) => rowId[0], // each Row's Slice Id
+ *   (_, rowId) => rowId, //    each Row's sort key
+ *   defaultSorter, //          sort Slice Ids
+ *   defaultSorter, //          sort Row Ids by sort key
+ * );
+ *
+ * console.log(indexes.getSliceIds('byFirst'));
+ * // -> ['c', 'f']
+ * console.log(indexes.getSliceRowIds('byFirst', 'f'));
+ * // -> ['felix', 'fido']
+ * ```
+ * @category Convenience
+ */
+export function defaultSorter(sortKey1: SortKey, sortKey2: SortKey): number;

package/lib/debug/common.js

@@ -0,0 +1,3 @@
+const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
+
+export {defaultSorter};

package/lib/debug/indexes.d.ts

@@ -3,8 +3,8 @@
  * and track indexes of the data in Store objects.
  *
  * The main entry point to this module is the createIndexes function, which
- * returns a new Indexes object. From there, you can create new index
- * definitions, access the contents of those indexes directly, and register
+ * returns a new Indexes object. From there, you can create new Index
+ * definitions, access the contents of those Indexes directly, and register
  * listeners for when they change.
  *
  * @packageDocumentation
@@ -12,7 +12,7 @@
  */
 
 import {GetCell, Store} from './store.d';
-import {Id, IdOrNull, Ids} from './common.d';
+import {Id, IdOrNull, Ids, SortKey} from './common.d';
 
 /**
  * The Index type represents the concept of a map of Slice objects, keyed by Id.
@@ -43,13 +43,6 @@ export type Index = {[sliceId: Id]: Slice};
  */
 export type Slice = Ids;
 
-/**
- * The SortKey type represents a value that can be used by a sort function.
- *
- * @category Parameter
- */
-export type SortKey = string | number | boolean;
-
 /**
  * The SliceIdsListener type describes a function that is used to listen to
  * changes to the Slice Ids in an Index.
@@ -779,51 +772,3 @@ export interface Indexes {
  * @category Creation
  */
 export function createIndexes(store: Store): Indexes;
-
-/**
- * The defaultSorter function is provided as a convenience to sort keys
- * alphanumerically, and can be provided to the `sliceIdSorter` and
- * `rowIdSorter` parameters of the setIndexDefinition method, for example.
- *
- * @param sortKey1 The first item of the pair to compare.
- * @param sortKey2 The second item of the pair to compare.
- * @returns A number indicating how to sort the pair.
- * @example
- * This example creates an Indexes object.
- *
- * ```js
- * const store = createStore();
- * const indexes = createIndexes(store);
- * console.log(indexes.getIndexIds());
- * // -> []
- * ```
- * @example
- * This example creates a Store, creates an Indexes object, and defines an
- * Index based on the first letter of the pets' names. The Slice Ids (and Row
- * Ids within them) are alphabetically sorted using the defaultSorter function.
- *
- * ```js
- * const store = createStore().setTable('pets', {
- *   fido: {species: 'dog'},
- *   felix: {species: 'cat'},
- *   cujo: {species: 'dog'},
- * });
- *
- * const indexes = createIndexes(store);
- * indexes.setIndexDefinition(
- *   'byFirst', //              indexId
- *   'pets', //                 tableId
- *   (_, rowId) => rowId[0], // each Row's Slice Id
- *   (_, rowId) => rowId, //    each Row's sort key
- *   defaultSorter, //          sort Slice Ids
- *   defaultSorter, //          sort Row Ids by sort key
- * );
- *
- * console.log(indexes.getSliceIds('byFirst'));
- * // -> ['c', 'f']
- * console.log(indexes.getSliceRowIds('byFirst', 'f'));
- * // -> ['felix', 'fido']
- * ```
- * @category Convenience
- */
-export function defaultSorter(sortKey1: SortKey, sortKey2: SortKey): number;

package/lib/debug/indexes.js

@@ -168,6 +168,8 @@ const getCreateFunction = (getFunction) => {
   };
 };
 
+const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
+
 const addDeepSet = (deepSet, value, ids) =>
   arrayLength(ids) < 2
     ? setAdd(
@@ -276,7 +278,7 @@ const createIndexes = getCreateFunction((store) => {
     setDefinition(
       indexId,
       tableId,
-      (change, changedSliceIds, changedSortKeys, sliceIds, sortKeys) => {
+      (change, changedSliceIds, changedSortKeys, sliceIds, sortKeys, force) => {
         let sliceIdsChanged = 0;
         const changedSlices = setNew();
         const unsortedSlices = setNew();
@@ -305,12 +307,16 @@ const createIndexes = getCreateFunction((store) => {
           }
         });
         change();
-        mapForEach(changedSortKeys, (rowId) =>
-          ifNotUndefined(mapGet(sliceIds, rowId), (sliceId) =>
-            setAdd(unsortedSlices, sliceId),
-          ),
-        );
         if (!collIsEmpty(sortKeys)) {
+          if (force) {
+            mapForEach(index, (sliceId) => setAdd(unsortedSlices, sliceId));
+          } else {
+            mapForEach(changedSortKeys, (rowId) =>
+              ifNotUndefined(mapGet(sliceIds, rowId), (sliceId) =>
+                setAdd(unsortedSlices, sliceId),
+              ),
+            );
+          }
           collForEach(unsortedSlices, (sliceId) => {
             const rowIdArraySorter = (rowId1, rowId2) =>
               rowIdSorter(
@@ -329,7 +335,7 @@ const createIndexes = getCreateFunction((store) => {
             }
           });
         }
-        if (sliceIdsChanged) {
+        if (sliceIdsChanged || force) {
           if (!isUndefined(sliceIdArraySorter)) {
             const indexArray = [...index];
             if (!arrayIsSorted(indexArray, sliceIdArraySorter)) {
@@ -337,8 +343,11 @@ const createIndexes = getCreateFunction((store) => {
                 indexId,
                 mapNew(arraySort(indexArray, sliceIdArraySorter)),
               );
+              sliceIdsChanged = 1;
             }
           }
+        }
+        if (sliceIdsChanged) {
           callListeners(sliceIdsListeners, [indexId]);
         }
         collForEach(changedSlices, (sliceId) =>
@@ -385,6 +394,5 @@ const createIndexes = getCreateFunction((store) => {
   };
   return objFreeze(indexes);
 });
-const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
 
-export {createIndexes, defaultSorter};
+export {createIndexes};

package/lib/debug/metrics.d.ts

@@ -3,8 +3,8 @@
  * and track metrics and aggregates of the data in Store objects.
  *
  * The main entry point to this module is the createMetrics function, which
- * returns a new Metrics object. From there, you can create new metric
- * definitions, access the values of those metrics directly, and register
+ * returns a new Metrics object. From there, you can create new Metric
+ * definitions, access the values of those Metrics directly, and register
  * listeners for when they change.
  *
  * @packageDocumentation

package/lib/debug/persisters.d.ts

@@ -1,6 +1,6 @@
 /**
- * The persisters module of the TinyBase project provides a simple framework
- * for saving and loading Store data, to and from different destinations, or
+ * The persisters module of the TinyBase project provides a simple framework for
+ * saving and loading Store data, to and from different destinations, or
  * underlying storage types.
  *
  * Several entry points are provided, each of which returns a new Persister
@@ -24,7 +24,7 @@
  */
 
 import {Store, Tables} from './store.d';
-import {Callback} from './common';
+import {Callback} from './common.d';
 
 /**
  * The PersisterStats type describes the number of times a Persister object has
@@ -243,6 +243,7 @@ export interface Persister {
    * console.log(store.getTables());
    * // -> {pets: {toto: {species: 'dog'}}}
    *
+   * persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Load
@@ -284,6 +285,7 @@ export interface Persister {
    * // -> {pets: {toto: {species: 'dog'}}}
    * // Storage change has not been automatically loaded.
    *
+   * persister.destroy();
    * sessionStorage.clear();
    * ```
    * @category Load
@@ -650,8 +652,9 @@ export function createFilePersister(store: Store, filePath: string): Persister;
  * layer.
  *
  * The other creation functions (such as the createSessionPersister function and
- * createFilePersister function, for example) all use this under the covers. See
- * those implementations for ideas on how to implement your own Persister types.
+ * createFilePersister function, for example) all use this function under the
+ * covers. See those implementations for ideas on how to implement your own
+ * Persister types.
  *
  * @param store The Store to persist.
  * @param getPersisted An asynchronous function which will fetch JSON from the
@@ -664,9 +667,9 @@ export function createFilePersister(store: Store, filePath: string): Persister;
  * from the underlying changes to the persistence layer.
  * @returns A reference to the new Persister object.
  * @example
- * This example creates a Persister object and persists the Store to a local
- * string called `storeJson` and would automatically load by polling for changes
- * every second.
+ * This example creates a custom Persister object and persists the Store to a
+ * local string called `storeJson` and which would automatically load by polling
+ * for changes every second.
  *
  * ```js
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});

package/lib/debug/relationships.d.ts

@@ -4,7 +4,7 @@
  *
  * The main entry point to this module is the createRelationships function,
  * which returns a new Relationships object. From there, you can create new
- * relationship definitions, access the associations within those relationships
+ * Relationship definitions, access the associations within those Relationships
  * directly, and register listeners for when they change.
  *
  * @packageDocumentation

package/lib/debug/store.d.ts

@@ -17,11 +17,10 @@ import {Id, IdOrNull, Ids, Json} from './common.d';
  * The Tables type is the data structure representing all of the data in a
  * Store.
  *
- * A Tables object can be provided to the createStore function when first
- * creating the Store. It is also used when setting all of the tables together
- * with the setTables method, and when getting them back out again with the
- * getTables method. A Tables object is a regular JavaScript object containing
- * individual Table objects, keyed by their Id.
+ * A Tables object is used when setting all of the tables together with the
+ * setTables method, and when getting them back out again with the getTables
+ * method. A Tables object is a regular JavaScript object containing individual
+ * Table objects, keyed by their Id.
  *
  * @example
  * ```js
@@ -371,8 +370,8 @@ export type CellChange = [
  * Ids and the types of Cell that can exist within them.
  *
  * A Schema comprises a JavaScript object describing each Table, in turn a
- * nested JavaScript object containing the each Cell and its CellSchema. It is
- * provided to the createStore function or to the setSchema method.
+ * nested JavaScript object containing information about each Cell and its
+ * CellSchema. It is provided to the setSchema method.
  *
  * @example
  * When applied to a Store, this Schema only allows one Table called `pets`, in
@@ -1339,9 +1338,8 @@ export interface Store {
    * applied or as invalid Table, Row, or Cell objects are removed. These
    * changes will fire any listeners to that data, as expected.
    *
-   * You can also specify the Schema at the time of creation, as the second
-   * parameter of the createStore function. When no longer needed, you can also
-   * completely remove an existing Schema with the delSchema method.
+   * When no longer needed, you can also completely remove an existing Schema
+   * with the delSchema method.
    *
    * @param schema The Schema to be set for the Store.
    * @returns A reference to the Store.

package/lib/debug/tinybase.js

@@ -509,6 +509,8 @@ const createCheckpoints = getCreateFunction((store) => {
   return objFreeze(checkpoints.clear());
 });
 
+const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
+
 const createIndexes = getCreateFunction((store) => {
   const sliceIdsListeners = mapNew();
   const sliceRowIdsListeners = mapNew();
@@ -541,7 +543,7 @@ const createIndexes = getCreateFunction((store) => {
     setDefinition(
       indexId,
       tableId,
-      (change, changedSliceIds, changedSortKeys, sliceIds, sortKeys) => {
+      (change, changedSliceIds, changedSortKeys, sliceIds, sortKeys, force) => {
         let sliceIdsChanged = 0;
         const changedSlices = setNew();
         const unsortedSlices = setNew();
@@ -570,12 +572,16 @@ const createIndexes = getCreateFunction((store) => {
           }
         });
         change();
-        mapForEach(changedSortKeys, (rowId) =>
-          ifNotUndefined(mapGet(sliceIds, rowId), (sliceId) =>
-            setAdd(unsortedSlices, sliceId),
-          ),
-        );
         if (!collIsEmpty(sortKeys)) {
+          if (force) {
+            mapForEach(index, (sliceId) => setAdd(unsortedSlices, sliceId));
+          } else {
+            mapForEach(changedSortKeys, (rowId) =>
+              ifNotUndefined(mapGet(sliceIds, rowId), (sliceId) =>
+                setAdd(unsortedSlices, sliceId),
+              ),
+            );
+          }
           collForEach(unsortedSlices, (sliceId) => {
             const rowIdArraySorter = (rowId1, rowId2) =>
               rowIdSorter(
@@ -594,7 +600,7 @@ const createIndexes = getCreateFunction((store) => {
             }
           });
         }
-        if (sliceIdsChanged) {
+        if (sliceIdsChanged || force) {
           if (!isUndefined(sliceIdArraySorter)) {
             const indexArray = [...index];
             if (!arrayIsSorted(indexArray, sliceIdArraySorter)) {
@@ -602,8 +608,11 @@ const createIndexes = getCreateFunction((store) => {
                 indexId,
                 mapNew(arraySort(indexArray, sliceIdArraySorter)),
               );
+              sliceIdsChanged = 1;
             }
           }
+        }
+        if (sliceIdsChanged) {
           callListeners(sliceIdsListeners, [indexId]);
         }
         collForEach(changedSlices, (sliceId) =>
@@ -650,7 +659,6 @@ const createIndexes = getCreateFunction((store) => {
   };
   return objFreeze(indexes);
 });
-const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
 
 const aggregators = mapNew([
   [

package/lib/debug/ui-react.d.ts

@@ -14,7 +14,7 @@
  * @module ui-react
  */
 
-import {Callback, Id, IdOrNull, Ids, ParameterizedCallback} from './common';
+import {Callback, Id, IdOrNull, Ids, ParameterizedCallback} from './common.d';
 import {
   Cell,
   CellIdsListener,
@@ -2213,6 +2213,9 @@ export function useCellListener(
  * an array in the optional second parameter, just as you would for any React
  * hook with dependencies.
  *
+ * This hook ensures the Metrics object is destroyed whenever a new one is
+ * created or the component is unmounted.
+ *
  * @param store A reference to the Store for which to create a new Metrics
  * object.
  * @param create A function for performing the creation steps of the Metrics
@@ -2554,6 +2557,9 @@ export function useMetricListener(
  * an array in the optional second parameter, just as you would for any React
  * hook with dependencies.
  *
+ * This hook ensures the Indexes object is destroyed whenever a new one is
+ * created or the component is unmounted.
+ *
  * @param store A reference to the Store for which to create a new Indexes
  * object.
  * @param create A function for performing the creation steps of the Indexes
@@ -3104,6 +3110,9 @@ export function useSliceRowIdsListener(
  * them in an array in the optional second parameter, just as you would for any
  * React hook with dependencies.
  *
+ * This hook ensures the Relationships object is destroyed whenever a new one is
+ * created or the component is unmounted.
+ *
  * @param store A reference to the Store for which to create a new Relationships
  * object.
  * @param create An optional callback for performing post-creation steps on the
@@ -3900,6 +3909,9 @@ export function useLinkedRowIdsListener(
  * them in an array in the optional second parameter, just as you would for any
  * React hook with dependencies.
  *
+ * This hook ensures the Checkpoints object is destroyed whenever a new one is
+ * created or the component is unmounted.
+ *
  * @param store A reference to the Store for which to create a new Checkpoints
  * object.
  * @param create A function for performing the creation steps of the Checkpoints
@@ -4751,6 +4763,9 @@ export function useCheckpointListener(
  * an array in the fifth parameter. The Persister itself is used as a dependency
  * by default.
  *
+ * This hook ensures the Persister object is destroyed whenever a new one is
+ * created or the component is unmounted.
+ *
  * @param store A reference to the Store for which to create a new Persister
  * object.
  * @param create A function for performing the creation steps of the Persister
@@ -4795,10 +4810,12 @@ export function useCheckpointListener(
  *
  * // ... // !act
  * ReactDOM.render(<App />, app); // !act
- * // No second Checkpoints creation
+ * // No second Persister creation
  *
  * console.log(app.innerHTML);
  * // -> '<span>{\"pets\":{\"fido\":{\"species\":\"dog\"}}}</span>'
+ *
+ * ReactDOM.unmountComponentAtNode(app); // !act
  * ```
  * @example
  * This example creates a Persister at the top level of a React application. The
@@ -4841,6 +4858,8 @@ export function useCheckpointListener(
  * // ... // !act
  * console.log(app.innerHTML);
  * // -> '<span>{\"pets\":{\"cujo\":{\"species\":\"dog\"}}}</span>'
+ *
+ * ReactDOM.unmountComponentAtNode(app); // !act
  * ```
  *  @category Persister hooks
  */

package/lib/debug/ui-react.js

@@ -48,8 +48,11 @@ const useCheckpointsOrCheckpointsId = (checkpointsOrCheckpointsId) =>
   useThingOrThingId(checkpointsOrCheckpointsId, 8);
 
 const {useCallback, useEffect, useMemo: useMemo$1, useState} = React;
-const useCreate = (store, create, createDeps = []) =>
-  useMemo$1(() => create(store), [store, ...createDeps]);
+const useCreate = (store, create, createDeps = []) => {
+  const thing = useMemo$1(() => create(store), [store, ...createDeps]);
+  useEffect(() => () => thing.destroy(), [thing]);
+  return thing;
+};
 const useListenable = (listenable, thing, defaulted, ...args) => {
   const getListenable = thing?.['get' + listenable] ?? (() => defaulted);
   const immediateListenable = getListenable(...args);
@@ -654,6 +657,9 @@ const useCreatePersister = (
       setDone(1);
       return;
     })();
+    return () => {
+      persister.destroy();
+    };
   }, [persister, ...thenDeps]);
   return persister;
 };

package/lib/indexes.d.ts

@@ -3,8 +3,8 @@
  * and track indexes of the data in Store objects.
  *
  * The main entry point to this module is the createIndexes function, which
- * returns a new Indexes object. From there, you can create new index
- * definitions, access the contents of those indexes directly, and register
+ * returns a new Indexes object. From there, you can create new Index
+ * definitions, access the contents of those Indexes directly, and register
  * listeners for when they change.
  *
  * @packageDocumentation
@@ -12,7 +12,7 @@
  */
 
 import {GetCell, Store} from './store.d';
-import {Id, IdOrNull, Ids} from './common.d';
+import {Id, IdOrNull, Ids, SortKey} from './common.d';
 
 /**
  * The Index type represents the concept of a map of Slice objects, keyed by Id.
@@ -43,13 +43,6 @@ export type Index = {[sliceId: Id]: Slice};
  */
 export type Slice = Ids;
 
-/**
- * The SortKey type represents a value that can be used by a sort function.
- *
- * @category Parameter
- */
-export type SortKey = string | number | boolean;
-
 /**
  * The SliceIdsListener type describes a function that is used to listen to
  * changes to the Slice Ids in an Index.
@@ -779,51 +772,3 @@ export interface Indexes {
  * @category Creation
  */
 export function createIndexes(store: Store): Indexes;
-
-/**
- * The defaultSorter function is provided as a convenience to sort keys
- * alphanumerically, and can be provided to the `sliceIdSorter` and
- * `rowIdSorter` parameters of the setIndexDefinition method, for example.
- *
- * @param sortKey1 The first item of the pair to compare.
- * @param sortKey2 The second item of the pair to compare.
- * @returns A number indicating how to sort the pair.
- * @example
- * This example creates an Indexes object.
- *
- * ```js
- * const store = createStore();
- * const indexes = createIndexes(store);
- * console.log(indexes.getIndexIds());
- * // -> []
- * ```
- * @example
- * This example creates a Store, creates an Indexes object, and defines an
- * Index based on the first letter of the pets' names. The Slice Ids (and Row
- * Ids within them) are alphabetically sorted using the defaultSorter function.
- *
- * ```js
- * const store = createStore().setTable('pets', {
- *   fido: {species: 'dog'},
- *   felix: {species: 'cat'},
- *   cujo: {species: 'dog'},
- * });
- *
- * const indexes = createIndexes(store);
- * indexes.setIndexDefinition(
- *   'byFirst', //              indexId
- *   'pets', //                 tableId
- *   (_, rowId) => rowId[0], // each Row's Slice Id
- *   (_, rowId) => rowId, //    each Row's sort key
- *   defaultSorter, //          sort Slice Ids
- *   defaultSorter, //          sort Row Ids by sort key
- * );
- *
- * console.log(indexes.getSliceIds('byFirst'));
- * // -> ['c', 'f']
- * console.log(indexes.getSliceRowIds('byFirst', 'f'));
- * // -> ['felix', 'fido']
- * ```
- * @category Convenience
- */
-export function defaultSorter(sortKey1: SortKey, sortKey2: SortKey): number;