tinybase 0.9.2 → 0.9.3

package/lib/debug/store.d.ts

@@ -24,7 +24,7 @@ import {Id, IdOrNull, Ids, Json} from './common.d';
  * individual Table objects, keyed by their Id.
  *
  * @example
- * ```tsx
+ * ```js
  * const tables: Tables = {
  *   pets: {
  *     fido: {species: 'dog', color: 'brown'},
@@ -49,7 +49,7 @@ export type Tables = {[tableId: Id]: Table};
  * Id.
  *
  * @example
- * ```tsx
+ * ```js
  * const table: Table = {
  *   fido: {species: 'dog', color: 'brown'},
  *   felix: {species: 'cat'},
@@ -67,7 +67,7 @@ export type Table = {[rowId: Id]: Row};
  * object containing individual Cell objects, keyed by their Id.
  *
  * @example
- * ```tsx
+ * ```js
  * const row: Row = {species: 'dog', color: 'brown'};
  * ```
  * @category Store
@@ -82,7 +82,7 @@ export type Row = {[cellId: Id]: Cell};
  * number, or boolean.
  *
  * @example
- * ```tsx
+ * ```js
  * const cell: Cell = 'dog';
  * ```
  * @category Store
@@ -97,6 +97,9 @@ export type Cell = string | number | boolean;
  * can do something based on every Table in the Store. See that method for
  * specific examples.
  *
+ * @param tableId The Id of the Table that the callback can operate on.
+ * @param forEachRow A function that will let you iterate over the Row objects
+ * in this Table.
  * @category Callback
  */
 export type TableCallback = (
@@ -112,6 +115,9 @@ export type TableCallback = (
  * do something based on every Row in a Table. See that method for specific
  * examples.
  *
+ * @param rowId The Id of the Row that the callback can operate on.
+ * @param forEachRow A function that will let you iterate over the Cell values
+ * in this Row.
  * @category Callback
  */
 export type RowCallback = (
@@ -127,6 +133,8 @@ export type RowCallback = (
  * do something based on every Cell in a Row. See that method for specific
  * examples.
  *
+ * @param cellId The Id of the Cell that the callback can operate on.
+ * @param cell The value of the Cell.
  * @category Callback
  */
 export type CellCallback = (cellId: Id, cell: Cell) => void;
@@ -139,6 +147,7 @@ export type CellCallback = (cellId: Id, cell: Cell) => void;
  * new one, such as when incrementing a number. See that method for specific
  * examples.
  *
+ * @param cell The current value of the Cell to map to a new value.
  * @category Callback
  */
 export type MapCell = (cell: Cell | undefined) => Cell;
@@ -151,6 +160,7 @@ export type MapCell = (cell: Cell | undefined) => Cell;
  * setMetricDefinition method of a Metrics object, or the setIndexDefinition
  * method of an Indexes object. See those methods for specific examples.
  *
+ * @param cellId The Id of the Cell to fetch the value for.
  * @category Callback
  */
 export type GetCell = (cellId: Id) => Cell | undefined;
@@ -170,6 +180,9 @@ export type GetCell = (cellId: Id) => Cell | undefined;
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
  *
+ * @param store A reference to the Store that changed.
+ * @param getCellChange A function that returns information about any Cell's
+ * changes.
  * @category Listener
  */
 export type TablesListener = (
@@ -186,6 +199,7 @@ export type TablesListener = (
  *
  * When called, a TableIdsListener is given a reference to the Store.
  *
+ * @param store A reference to the Store that changed.
  * @category Listener
  */
 export type TableIdsListener = (store: Store) => void;
@@ -205,6 +219,10 @@ export type TableIdsListener = (store: Store) => void;
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
  *
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param getCellChange A function that returns information about any Cell's
+ * changes.
  * @category Listener
  */
 export type TableListener = (
@@ -223,6 +241,8 @@ export type TableListener = (
  * When called, a RowIdsListener is given a reference to the Store, and the Id
  * of the Table whose Row Ids changed.
  *
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
  * @category Listener
  */
 export type RowIdsListener = (store: Store, tableId: Id) => void;
@@ -243,6 +263,11 @@ export type RowIdsListener = (store: Store, tableId: Id) => void;
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
  *
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param rowId The Id of the Row that changed.
+ * @param getCellChange A function that returns information about any Cell's
+ * changes.
  * @category Listener
  */
 export type RowListener = (
@@ -262,6 +287,10 @@ export type RowListener = (
  * When called, a CellIdsListener is given a reference to the Store, the Id of
  * the Table that changed, and the Id of the Row whose Cell Ids changed.
  *
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param rowId The Id of the Row that changed.
+ * changes.
  * @category Listener
  */
 export type CellIdsListener = (store: Store, tableId: Id, rowId: Id) => void;
@@ -284,6 +313,14 @@ export type CellIdsListener = (store: Store, tableId: Id, rowId: Id) => void;
  * GetCellChange function will not be present and the new and old values of the
  * Cell will be the same.
  *
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param rowId The Id of the Row that changed.
+ * @param cellId The Id of the Cell that changed.
+ * @param newCell The new value of the Cell that changed.
+ * @param oldCell The old value of the Cell that changed.
+ * @param getCellChange A function that returns information about any Cell's
+ * changes.
  * @category Listener
  */
 export type CellListener = (
@@ -297,21 +334,37 @@ export type CellListener = (
 ) => void;
 
 /**
- * The GetCellChange type describes a function that returns information about a
- * Cell's changes during a transaction.
+ * The GetCellChange type describes a function that returns information about
+ * any Cell's changes during a transaction.
  *
  * A GetCellChange function is provided to every listener when called due the
  * Store changing. The listener can then fetch the previous value of a Cell
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
  *
+ * @param tableId The Id of the Table to inspect.
+ * @param rowId The Id of the Row to inspect.
+ * @param cellId The Id of the Cell to inspect.
+ * @returns A CellChange array containing information about the Cell's changes.
  * @category Listener
  */
-export type GetCellChange = (
-  tableId: Id,
-  rowId: Id,
-  cellId: Id,
-) => [changed: boolean, oldCell: Cell | undefined, newCell: Cell | undefined];
+export type GetCellChange = (tableId: Id, rowId: Id, cellId: Id) => CellChange;
+
+/**
+ * The CellChange type describes a Cell's changes during a transaction.
+ *
+ * This is returned by the GetCellChange function that is provided to every
+ * listener when called. This array contains the previous value of a Cell
+ * before the current transaction, the new value after it, and a convenience
+ * flag that indicates that the value has changed.
+ *
+ * @category Listener
+ */
+export type CellChange = [
+  changed: boolean,
+  oldCell: Cell | undefined,
+  newCell: Cell | undefined,
+];
 
 /**
  * The Schema type describes the structure of a Store in terms of valid Table
@@ -326,7 +379,7 @@ export type GetCellChange = (
  * which each Row may contain a string `species` Cell, and is guaranteed to
  * contain a boolean `sold` Cell that defaults to `false`.
  *
- *```tsx
+ *```js
  * const schema: Schema = {
  *   pets: {
  *     species: {type: 'string'},
@@ -361,7 +414,7 @@ export type Schema = {
  * When applied to a Store, this CellSchema ensures a boolean Cell is always
  * present, and defaults it to `false`.
  *
- *```tsx
+ *```js
  * const requiredBoolean: CellSchema = {type: 'boolean', default: false};
  * ```
  * @category Schema
@@ -392,12 +445,33 @@ export type CellSchema =
  * @category Development
  */
 export type StoreListenerStats = {
+  /**
+   * The number of TablesListeners registered with the Store.
+   */
   tables?: number;
+  /**
+   * The number of TableIdsListeners registered with the Store.
+   */
   tableIds?: number;
+  /**
+   * The number of TableListeners registered with the Store.
+   */
   table?: number;
+  /**
+   * The number of RowIdsListeners registered with the Store.
+   */
   rowIds?: number;
+  /**
+   * The number of RowListeners registered with the Store.
+   */
   row?: number;
+  /**
+   * The number of CellIdsListeners registered with the Store.
+   */
   cellIds?: number;
+  /**
+   * The number of CellListeners registered with the Store.
+   */
   cell?: number;
 };
 
@@ -467,10 +541,10 @@ export type StoreListenerStats = {
  * |Cell Ids|getCellIds|-|-|addCellIdsListener|
  * |Cell|getCell|setCell|delCell|addCellListener|
  *
- * Additionally, there are two extra methods to manipulate a Row. The addRow
- * method is like the setRow method but automatically assigns it a new unique
- * Id. And the setPartialRow method lets you update multiple Cell values in a
- * Row without affecting the others.
+ * Additionally, there are two extra methods to manipulate Row objects. The
+ * addRow method is like the setRow method but automatically assigns it a new
+ * unique Id. And the setPartialRow method lets you update multiple Cell values
+ * in a Row without affecting the others.
  *
  * The transaction method is used to wrap multiple changes to the Store so that
  * the relevant listeners only fire once.
@@ -521,7 +595,7 @@ export type StoreListenerStats = {
  * This example shows a very simple lifecycle of a Store: from creation, to
  * adding and getting some data, and then registering and removing a listener.
  *
- * ```tsx
+ * ```js
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * console.log(store.getRow('pets', 'fido'));
  * // -> {species: 'dog'}
@@ -539,6 +613,7 @@ export type StoreListenerStats = {
  *
  * store.delListener(listenerId);
  * ```
+ * @category Store
  */
 export interface Store {
   /**
@@ -553,7 +628,7 @@ export interface Store {
    * @example
    * This example retrieves the data in a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -565,7 +640,7 @@ export interface Store {
    * This example retrieves the Tables of an empty Store, returning an empty
    * object.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * console.log(store.getTables());
    * // -> {}
@@ -590,7 +665,7 @@ export interface Store {
    * @example
    * This example retrieves the Table Ids in a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -602,7 +677,7 @@ export interface Store {
    * This example retrieves the Table Ids of an empty Store, returning an empty
    * array.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * console.log(store.getTableIds());
    * // -> []
@@ -624,7 +699,7 @@ export interface Store {
    * @example
    * This example retrieves the data in a single Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -636,7 +711,7 @@ export interface Store {
    * This example retrieves a Table that does not exist, returning an empty
    * object.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getTable('employees'));
    * // -> {}
@@ -658,7 +733,7 @@ export interface Store {
    * @example
    * This example retrieves the Row Ids in a Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -672,7 +747,7 @@ export interface Store {
    * This example retrieves the Row Ids of a Table that does not exist,
    * returning an empty array.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getRowIds('employees'));
    * // -> []
@@ -695,7 +770,7 @@ export interface Store {
    * @example
    * This example retrieves the data in a single Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -709,7 +784,7 @@ export interface Store {
    * This example retrieves a Row that does not exist, returning an empty
    * object.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getRow('pets', 'felix'));
    * // -> {}
@@ -733,7 +808,7 @@ export interface Store {
    * @example
    * This example retrieves the Cell Ids in a Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog', color: 'brown'},
@@ -746,7 +821,7 @@ export interface Store {
    * This example retrieves the Cell Ids of a Cell that does not exist,
    * returning an empty array.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getCellIds('pets', 'felix'));
    * // -> []
@@ -770,7 +845,7 @@ export interface Store {
    * @example
    * This example retrieves a single Cell.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -780,7 +855,7 @@ export interface Store {
    * @example
    * This example retrieves a Cell that does not exist, returning `undefined`.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getCell('pets', 'fido', 'color'));
    * // -> undefined
@@ -798,7 +873,7 @@ export interface Store {
    * @example
    * This example shows two simple Table existence checks.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasTable('pets'));
    * // -> true
@@ -819,7 +894,7 @@ export interface Store {
    * @example
    * This example shows two simple Row existence checks.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasRow('pets', 'fido'));
    * // -> true
@@ -841,7 +916,7 @@ export interface Store {
    * @example
    * This example shows two simple Cell existence checks.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasCell('pets', 'fido', 'species'));
    * // -> true
@@ -860,7 +935,7 @@ export interface Store {
    * @example
    * This example serializes the contents of a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.getJson());
    * // -> '{"pets":{"fido":{"species":"dog"}}}'
@@ -868,7 +943,7 @@ export interface Store {
    * @example
    * This example serializes the contents of an empty Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * console.log(store.getJson());
    * // -> '{}'
@@ -889,7 +964,7 @@ export interface Store {
    * @example
    * This example serializes the Schema of a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -902,7 +977,7 @@ export interface Store {
    * @example
    * This example serializes the Schema of an empty Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * console.log(store.getSchemaJson());
    * // -> '{}'
@@ -932,7 +1007,7 @@ export interface Store {
    * @example
    * This example sets the data of a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -944,7 +1019,7 @@ export interface Store {
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid, Tables objects.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setTables({pets: {felix: {species: 'cat', bug: []}}});
@@ -983,7 +1058,7 @@ export interface Store {
    * @example
    * This example sets the data of a single Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTable('pets', {
    *   fido: {species: 'dog'},
    *   felix: {species: 'cat'},
@@ -995,7 +1070,7 @@ export interface Store {
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid, Table objects.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setTable('pets', {felix: {species: 'cat', bug: []}});
@@ -1036,7 +1111,7 @@ export interface Store {
    * @example
    * This example sets the data of a single Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setRow('pets', 'fido', {species: 'dog'});
    * console.log(store.getTables());
    * // -> {pets: {fido: {species: 'dog'}}}
@@ -1045,7 +1120,7 @@ export interface Store {
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid, Row objects.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setRow('pets', 'fido', {color: 'brown', bug: []});
@@ -1085,7 +1160,7 @@ export interface Store {
    * @example
    * This example adds a single Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * console.log(store.addRow('pets', {species: 'dog'}));
    * // -> '0'
@@ -1096,7 +1171,7 @@ export interface Store {
    * This example attempts to add Rows to an existing Store with partly invalid,
    * and then completely invalid, Row objects.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {'0': {species: 'dog'}}});
    *
    * console.log(store.addRow('pets', {species: 'cat', bug: []}));
@@ -1138,7 +1213,7 @@ export interface Store {
    * @example
    * This example sets some of the data of a single Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1150,7 +1225,7 @@ export interface Store {
    * This example attempts to set some of the data of an existing Store with
    * partly invalid, and then completely invalid, Row objects.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setPartialRow('pets', 'fido', {color: 'brown', bug: []});
@@ -1192,7 +1267,7 @@ export interface Store {
    * @example
    * This example sets the value of a single Cell.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setCell('pets', 'fido', 'species', 'dog');
    * console.log(store.getTables());
    * // -> {pets: {fido: {species: 'dog'}}}
@@ -1200,7 +1275,7 @@ export interface Store {
    * @example
    * This example sets the data of a single Cell by mapping the existing value.
    *
-   * ```tsx
+   * ```js
    * const increment = (cell) => cell + 1;
    * const store = createStore().setTables({pets: {fido: {visits: 1}}});
    *
@@ -1212,7 +1287,7 @@ export interface Store {
    * This example attempts to set the data of an existing Store with an invalid
    * Cell value.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.setCell('pets', 'fido', 'bug', []);
@@ -1237,7 +1312,7 @@ export interface Store {
    * @example
    * This example sets the contents of a Store from a serialization.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * store.setJson('{"pets":{"fido":{"species":"dog"}}}');
    * console.log(store.getTables());
@@ -1247,7 +1322,7 @@ export interface Store {
    * This example attempts to set the contents of a Store from an invalid
    * serialization.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * store.setJson('{"pets":{"fido":{');
    * console.log(store.getTables());
@@ -1273,7 +1348,7 @@ export interface Store {
    * @example
    * This example sets the Schema of a Store after it has been created.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setSchema({
    *   pets: {
    *     species: {type: 'string'},
@@ -1295,7 +1370,7 @@ export interface Store {
    * @example
    * This example removes the data of a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
    * store.delTables();
@@ -1314,7 +1389,7 @@ export interface Store {
    * @example
    * This example removes a Table from a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -1339,7 +1414,7 @@ export interface Store {
    * @example
    * This example removes a Row from a Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}, felix: {species: 'cat'}},
    * });
@@ -1382,7 +1457,7 @@ export interface Store {
    * @example
    * This example removes a Cell from a Row without a Schema.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', sold: true}},
    * });
@@ -1395,7 +1470,7 @@ export interface Store {
    * This example removes a Cell from a Row with a Schema that defaults its
    * value.
    *
-   * ```tsx
+   * ```js
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', sold: true}},
@@ -1415,7 +1490,7 @@ export interface Store {
    * This example removes a Cell from a Row with a Schema that defaults its
    * value, but uses the `forceDel` parameter to override it.
    *
-   * ```tsx
+   * ```js
    * const store = createStore()
    *   .setTables({
    *     pets: {fido: {species: 'dog', sold: true}, felix: {species: 'cat'}},
@@ -1442,7 +1517,7 @@ export interface Store {
    * @example
    * This example removes the Schema of a Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setSchema({pets: {species: {type: 'string'}}});
    * store.delSchema();
    * console.log(store.getSchemaJson());
@@ -1481,7 +1556,7 @@ export interface Store {
    * within, a transaction. In the second case, the Row listener is only called
    * once.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addRowListener('pets', 'fido', () => console.log('Fido changed'));
    *
@@ -1501,7 +1576,7 @@ export interface Store {
    * called once - and with the final value - only if there is a net overall
    * change.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * store.addCellListener(
    *   'pets',
@@ -1543,7 +1618,7 @@ export interface Store {
    * This example iterates over each Table in a Store, and lists each Row Id
    * within them.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
    *   species: {dog: {price: 5}},
@@ -1575,7 +1650,7 @@ export interface Store {
    * This example iterates over each Row in a Table, and lists each Cell Id
    * within them.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {
    *     fido: {species: 'dog'},
@@ -1607,7 +1682,7 @@ export interface Store {
    * @example
    * This example iterates over each Cell in a Row, and lists its value.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1647,7 +1722,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to the whole
    * Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1666,7 +1741,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to the whole
    * Store, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1713,7 +1788,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Table
    * Ids.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addTableIdsListener((store) => {
    *   console.log('Table Ids changed');
@@ -1730,7 +1805,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Table
    * Ids, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addTableIdsListener(
    *   (store) => store.setCell('meta', 'update', 'store', true),
@@ -1743,6 +1818,7 @@ export interface Store {
    *
    * store.delListener(listenerId);
    * ```
+   * @category Listener
    */
   addTableIdsListener(listener: TableIdsListener, mutator?: boolean): Id;
 
@@ -1778,7 +1854,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1800,7 +1876,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to any
    * Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1819,7 +1895,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Table, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1875,7 +1951,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Row
    * Ids of a specific Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener('pets', (store) => {
    *   console.log('Row Ids for pets table changed');
@@ -1892,7 +1968,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Row
    * Ids of any Table.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener(null, (store, tableId) => {
    *   console.log(`Row Ids for ${tableId} table changed`);
@@ -1912,7 +1988,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Row
    * Ids of a specific Table, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addRowIdsListener(
    *   'pets',
@@ -1926,6 +2002,7 @@ export interface Store {
    *
    * store.delListener(listenerId);
    * ```
+   * @category Listener
    */
   addRowIdsListener(
     tableId: IdOrNull,
@@ -1971,7 +2048,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -1993,7 +2070,7 @@ export interface Store {
    * @example
    * This example registers a listener that responds to any changes to any Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2016,7 +2093,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Row, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2083,7 +2160,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Cell
    * Ids of a specific Row.
    *
-   * ```tsx
+   * ```js
    * 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');
@@ -2100,7 +2177,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Cell
    * Ids of any Row.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addCellIdsListener(
    *   null,
@@ -2124,7 +2201,7 @@ export interface Store {
    * This example registers a listener that responds to any change to the Cell
    * Ids of a specific Row, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * const listenerId = store.addCellIdsListener(
    *   'pets',
@@ -2140,6 +2217,7 @@ export interface Store {
    *
    * store.delListener(listenerId);
    * ```
+   * @category Listener
    */
   addCellIdsListener(
     tableId: IdOrNull,
@@ -2188,7 +2266,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Cell.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2213,7 +2291,7 @@ export interface Store {
    * @example
    * This example registers a listener that responds to any changes to any Cell.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2239,7 +2317,7 @@ export interface Store {
    * This example registers a listener that responds to any changes to a
    * specific Cell, and which also mutates the Store itself.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2283,7 +2361,7 @@ export interface Store {
    * valid values. After that list changes, the listener is called to apply the
    * condition to the existing data.
    *
-   * ```tsx
+   * ```js
    * const validColors = ['walnut', 'brown', 'black'];
    * const store = createStore();
    * const listenerId = store.addCellListener(
@@ -2328,7 +2406,7 @@ export interface Store {
    * @example
    * This example registers a listener and then removes it.
    *
-   * ```tsx
+   * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
    * });
@@ -2365,7 +2443,7 @@ export interface Store {
    * @example
    * This example gets the listener statistics of a small and simple Store.
    *
-   * ```tsx
+   * ```js
    * const store = createStore();
    * store.addTablesListener(() => console.log('Tables changed'));
    * store.addRowIdsListener(() => console.log('Row Ids changed'));
@@ -2392,7 +2470,7 @@ export interface Store {
  * @example
  * This example creates a Store.
  *
- * ```tsx
+ * ```js
  * const store = createStore();
  * console.log(store.getTables());
  * // -> {}
@@ -2400,7 +2478,7 @@ export interface Store {
  * @example
  * This example creates a Store with some initial data:
  *
- * ```tsx
+ * ```js
  * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog'}}}
@@ -2408,7 +2486,7 @@ export interface Store {
  * @example
  * This example creates a Store with some initial data and a Schema:
  *
- * ```tsx
+ * ```js
  * const store = createStore()
  *   .setTables({pets: {fido: {species: 'dog'}}})
  *   .setSchema({
@@ -2420,5 +2498,6 @@ export interface Store {
  * console.log(store.getTables());
  * // -> {pets: {fido: {species: 'dog', sold: false}}}
  * ```
+ * @category Creation
  */
 export function createStore(): Store;