tinybase 4.0.0-beta.3 → 4.0.0-beta.5

package/lib/types/store.d.ts

@@ -6,7 +6,6 @@
  * returns a new Store. From there, you can set and get data, register
  * listeners, and use other modules to build an entire app around the state and
  * tabular data within.
- *
  * @packageDocumentation
  * @module store
  */
@@ -20,7 +19,6 @@ import {Id, IdOrNull, Ids, Json} from './common.d';
  * A TablesSchema comprises a JavaScript object describing each Table, in turn a
  * nested JavaScript object containing information about each Cell and its
  * CellSchema. It is provided to the setTablesSchema method.
- *
  * @example
  * When applied to a Store, this TablesSchema only allows one Table called
  * `pets`, in which each Row may contain a string `species` Cell, and is
@@ -52,7 +50,6 @@ export type TablesSchema = {[tableId: Id]: {[cellId: Id]: CellSchema}};
  * If the default value is _not_ provided (or its type is incorrect), the Cell
  * may be missing from the Row, but when present you can be guaranteed it is of
  * the correct type.
- *
  * @example
  * When applied to a Store, this CellSchema ensures a boolean Cell is always
  * present, and defaults it to `false`.
@@ -73,7 +70,6 @@ export type CellSchema =
  *
  * A ValuesSchema comprises a JavaScript object describing each Value and its
  * ValueSchema. It is provided to the setValuesSchema method.
- *
  * @example
  * When applied to a Store, this ValuesSchema only allows one boolean Value
  * called `open`, that defaults to `false`.
@@ -84,7 +80,7 @@ export type CellSchema =
  * };
  * ```
  * @category Schema
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValuesSchema = {[valueId: Id]: ValueSchema};
 
@@ -102,7 +98,6 @@ export type ValuesSchema = {[valueId: Id]: ValueSchema};
  * If the default value is _not_ provided (or its type is incorrect), the Value
  * may not be present in the Store, but when present you can be guaranteed it is
  * of the correct type.
- *
  * @example
  * When applied to a Store, this ValueSchema ensures a boolean Value is always
  * present, and defaults it to `false`.
@@ -111,7 +106,7 @@ export type ValuesSchema = {[valueId: Id]: ValueSchema};
  * const requiredBoolean: ValueSchema = {type: 'boolean', default: false};
  * ```
  * @category Schema
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueSchema =
   | {type: 'string'; default?: string}
@@ -121,7 +116,6 @@ export type ValueSchema =
 /**
  * The NoTablesSchema type is a TablesSchema-like type for when one has not been
  * provided.
- *
  * @category Schema
  */
 export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
@@ -129,7 +123,6 @@ export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
 /**
  * The NoValuesSchema type is a ValuesSchema-like type for when one has not been
  * provided.
- *
  * @category Schema
  */
 export type NoValuesSchema = {[valueId: Id]: {type: 'any'}};
@@ -137,7 +130,6 @@ export type NoValuesSchema = {[valueId: Id]: {type: 'any'}};
 /**
  * The OptionalTablesSchema type is used by generic types that can optionally
  * take a TablesSchema.
- *
  * @category Schema
  */
 export type OptionalTablesSchema = TablesSchema | NoTablesSchema;
@@ -145,7 +137,6 @@ export type OptionalTablesSchema = TablesSchema | NoTablesSchema;
 /**
  * The OptionalValuesSchema type is used by generic types that can optionally
  * take a ValuesSchema.
- *
  * @category Schema
  */
 export type OptionalValuesSchema = ValuesSchema | NoValuesSchema;
@@ -153,7 +144,6 @@ export type OptionalValuesSchema = ValuesSchema | NoValuesSchema;
 /**
  * The OptionalSchemas type is used by generic types that can optionally take
  * either or both of a TablesSchema and ValuesSchema.
- *
  * @category Schema
  */
 export type OptionalSchemas = [OptionalTablesSchema, OptionalValuesSchema];
@@ -161,7 +151,6 @@ export type OptionalSchemas = [OptionalTablesSchema, OptionalValuesSchema];
 /**
  * The NoSchemas type is used as a default by generic types that can optionally
  * take either or both of a TablesSchema and ValuesSchema.
- *
  * @category Schema
  */
 export type NoSchemas = [NoTablesSchema, NoValuesSchema];
@@ -174,7 +163,6 @@ export type NoSchemas = [NoTablesSchema, NoValuesSchema];
  * 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
  * const tables: Tables = {
@@ -199,7 +187,6 @@ export type Tables = {[tableId: Id]: Table};
  * getting it back out again with the getTable method. A Table object is a
  * regular JavaScript object containing individual Row objects, keyed by their
  * Id.
- *
  * @example
  * ```js
  * const table: Table = {
@@ -217,7 +204,6 @@ export type Table = {[rowId: Id]: Row};
  * A Row is used when setting a row with the setRow method, and when getting it
  * back out again with the getRow method. A Row object is a regular JavaScript
  * object containing individual Cell objects, keyed by their Id.
- *
  * @example
  * ```js
  * const row: Row = {species: 'dog', color: 'brown'};
@@ -232,7 +218,6 @@ export type Row = {[cellId: Id]: Cell};
  * A Cell is used when setting a cell with the setCell method, and when getting
  * it back out again with the getCell method. A Cell is a JavaScript string,
  * number, or boolean.
- *
  * @example
  * ```js
  * const cell: Cell = 'dog';
@@ -248,7 +233,6 @@ export type Cell = string | number | boolean;
  * This is used when describing a Cell that is present _or_ that is not present,
  * such as when it has been deleted, or when describing a previous state where
  * the Cell value has since been added.
- *
  * @category Store
  */
 export type CellOrUndefined = Cell | undefined;
@@ -261,13 +245,12 @@ export type CellOrUndefined = Cell | undefined;
  * when getting them back out again with the getValues method. A Values object
  * is a regular JavaScript object containing individual Value objects, keyed by
  * their Id.
- *
  * @example
  * ```js
  * const values: Values = {open: true, employees: 4};
  * ```
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type Values = {[valueId: Id]: Value};
 
@@ -278,13 +261,12 @@ export type Values = {[valueId: Id]: Value};
  * A Value is used when setting a value with the setValue method, and when
  * getting it back out again with the getValue method. A Value is a JavaScript
  * string, number, or boolean.
- *
  * @example
  * ```js
  * const value: Value = 'dog';
  * ```
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type Value = string | number | boolean;
 
@@ -295,9 +277,8 @@ export type Value = string | number | boolean;
  * This is used when describing a Value that is present _or_ that is not
  * present, such as when it has been deleted, or when describing a previous
  * state where the Value has since been added.
- *
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueOrUndefined = Value | undefined;
 
@@ -308,7 +289,6 @@ export type ValueOrUndefined = Value | undefined;
  * A TableCallback is provided when using the forEachTable method, so that you
  * 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.
@@ -319,6 +299,19 @@ export type TableCallback = (
   forEachRow: (rowCallback: RowCallback) => void,
 ) => void;
 
+/**
+ * The TableCellCallback type describes a function that takes a Cell's Id and
+ * the count of times it appears across a whole Table.
+ *
+ * A TableCellCallback is provided when using the forEachTableCell method, so
+ * that you can do something based on every Cell used across a Table. See that
+ * method for specific examples.
+ * @param cellId The Id of the Cell that the callback can operate on.
+ * @param count The number of times this Cell is used across a whole Table.
+ * @category Callback
+ */
+export type TableCellCallback = (cellId: Id, count: number) => void;
+
 /**
  * The RowCallback type describes a function that takes a Row's Id and a
  * callback to loop over each Cell within it.
@@ -326,7 +319,6 @@ export type TableCallback = (
  * A RowCallback is provided when using the forEachRow method, so that you can
  * 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.
@@ -344,7 +336,6 @@ export type RowCallback = (
  * A CellCallback is provided when using the forEachCell method, so that you can
  * 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
@@ -358,11 +349,10 @@ export type CellCallback = (cellId: Id, cell: Cell) => void;
  * A ValueCallback is provided when using the forEachValue method, so that you
  * can do something based on every Value in a Store. See that method for
  * specific examples.
- *
  * @param valueId The Id of the Value that the callback can operate on.
  * @param value The Value itself.
  * @category Callback
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueCallback = (valueId: Id, value: Value) => void;
 
@@ -373,7 +363,6 @@ export type ValueCallback = (valueId: Id, value: Value) => void;
  * A MapCell can be provided in the setCell method to map an existing value to a
  * 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
  */
@@ -386,10 +375,9 @@ export type MapCell = (cell: CellOrUndefined) => Cell;
  * A MapValue can be provided in the setValue method to map an existing Value to
  * a new one, such as when incrementing a number. See that method for specific
  * examples.
- *
  * @param value The current Value to map to a new Value.
  * @category Callback
- * @since v3.0
+ * @since v3.0.0
  */
 export type MapValue = (value: ValueOrUndefined) => Value;
 
@@ -400,7 +388,6 @@ export type MapValue = (value: ValueOrUndefined) => Value;
  * A GetCell can be provided when setting definitions, as in the
  * 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
  */
@@ -497,7 +484,6 @@ export type ChangedValueIds = {[valueId: Id]: IdAddedOrRemoved};
  * call to get information about the changes made within the transaction (in
  * order to decide whether to do the rollback). See the GetTransactionChanges
  * and GetTransactionLog function types for more details.
- *
  * @param getTransactionChanges A function to be called to get the changes made
  * to the Store during the transaction, since v4.0.
  * @param getTransactionChanges A function to be called to get a more detailed
@@ -521,7 +507,6 @@ export type DoRollback = (
  * and, since v4.0, two functions that you can call to get information about the
  * changes made within the transaction. See the GetTransactionChanges and
  * GetTransactionLog function types for more details.
- *
  * @param store A reference to the Store that is completing a transaction.
  * @param getTransactionChanges A function to be called to get the changes made
  * to the Store during the transaction, since v4.0.
@@ -549,7 +534,6 @@ export type TransactionListener = (
  * Note that if the listener was manually forced to be called (with the
  * 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.
@@ -569,10 +553,17 @@ export type TablesListener = (
  *
  * When called, a TableIdsListener is given a reference to the Store.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
-export type TableIdsListener = (store: Store) => void;
+export type TableIdsListener = (
+  store: Store,
+  getIdChanges: GetIdChanges | undefined,
+) => void;
 
 /**
  * The TableListener type describes a function that is used to listen to changes
@@ -588,7 +579,6 @@ export type TableIdsListener = (store: Store) => void;
  * Note that if the listener was manually forced to be called (with the
  * 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
@@ -601,6 +591,28 @@ export type TableListener = (
   getCellChange: GetCellChange | undefined,
 ) => void;
 
+/**
+ * The TableCellIdsListener type describes a function that is used to listen to
+ * changes to the Cell Ids that appear anywhere in a Table.
+ *
+ * A TableCellIdsListener is provided when using the addTableCellIdsListener
+ * method. See that method for specific examples.
+ *
+ * When called, a TableCellIdsListener is given a reference to the Store, the Id
+ * of the Table whose Cell Ids changed, and a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param getIdChanges A function that returns information about the Id changes.
+ * @category Listener
+ * @since v3.3.0
+ */
+export type TableCellIdsListener = (
+  store: Store,
+  tableId: Id,
+  getIdChanges: GetIdChanges | undefined,
+) => void;
+
 /**
  * The RowIdsListener type describes a function that is used to listen to
  * changes to the Row Ids in a Table.
@@ -611,11 +623,19 @@ export type TableListener = (
  * When called, a RowIdsListener is given a reference to the Store, and the Id
  * of the Table whose Row Ids changed.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
-export type RowIdsListener = (store: Store, tableId: Id) => void;
+export type RowIdsListener = (
+  store: Store,
+  tableId: Id,
+  getIdChanges: GetIdChanges | undefined,
+) => void;
 
 /**
  * The SortedRowIdsListener type describes a function that is used to listen to
@@ -630,7 +650,6 @@ export type RowIdsListener = (store: Store, tableId: Id) => void;
  * Ids returned, for pagination purposes. It also receives the sorted array of
  * Ids itself, so that you can use them in the listener without the additional
  * cost of an explicit call to getSortedRowIds.
- *
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table whose sorted Row Ids changed.
  * @param cellId The Id of the Cell whose values were used for the sorting.
@@ -639,7 +658,7 @@ export type RowIdsListener = (store: Store, tableId: Id) => void;
  * @param limit The maximum number of Row Ids returned.
  * @param sortedRowIds The sorted Row Ids themselves.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type SortedRowIdsListener = (
   store: Store,
@@ -666,7 +685,6 @@ export type SortedRowIdsListener = (
  * Note that if the listener was manually forced to be called (with the
  * 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.
@@ -691,12 +709,21 @@ 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.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @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 getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
-export type CellIdsListener = (store: Store, tableId: Id, rowId: Id) => void;
+export type CellIdsListener = (
+  store: Store,
+  tableId: Id,
+  rowId: Id,
+  getIdChanges: GetIdChanges | undefined,
+) => void;
 
 /**
  * The CellListener type describes a function that is used to listen to changes
@@ -715,7 +742,6 @@ export type CellIdsListener = (store: Store, tableId: Id, rowId: Id) => void;
  * callListener method rather than due to a real change in the Store), the
  * 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.
@@ -750,7 +776,6 @@ export type CellListener = (
  * Note that if the listener was manually forced to be called (with the
  * callListener method rather than due to a real change in the Store), the
  * GetValueChange function will not be present.
- *
  * @param store A reference to the Store that changed.
  * @param getValueChange A function that returns information about any Value's
  * changes.
@@ -770,10 +795,17 @@ export type ValuesListener = (
  *
  * When called, a ValueIdsListener is given a reference to the Store.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
-export type ValueIdsListener = (store: Store) => void;
+export type ValueIdsListener = (
+  store: Store,
+  getIdChanges: GetIdChanges | undefined,
+) => void;
 
 /**
  * The ValueListener type describes a function that is used to listen to changes
@@ -791,7 +823,6 @@ export type ValueIdsListener = (store: Store) => void;
  * callListener method rather than due to a real change in the Store), the
  * GetValueChange function will not be present and the new and old values of the
  * Value will be the same.
- *
  * @param store A reference to the Store that changed.
  * @param valueId The Id of the Value that changed.
  * @param newValue The new value of the Value that changed.
@@ -799,7 +830,7 @@ export type ValueIdsListener = (store: Store) => void;
  * @param getValueChange A function that returns information about any Value's
  * changes.
  * @category Listener
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueListener = (
   store: Store,
@@ -822,14 +853,13 @@ export type ValueListener = (
  * have been of absolutely any type. Since there could have been multiple failed
  * attempts to set the Cell within a single transaction, this is an array
  * containing each attempt, chronologically.
- *
  * @param store A reference to the Store that was being changed.
  * @param tableId The Id of the Table that was being changed.
  * @param rowId The Id of the Row that was being changed.
  * @param cellId The Id of the Cell that was being changed.
  * @param invalidCells An array of the values of the Cell that were invalid.
  * @category Listener
- * @since v1.1
+ * @since v1.1.0
  */
 export type InvalidCellListener = (
   store: Store,
@@ -852,12 +882,11 @@ export type InvalidCellListener = (
  * Since there could have been multiple failed attempts to set the Value within
  * a single transaction, this is an array containing each attempt,
  * chronologically.
- *
  * @param store A reference to the Store that was being changed.
  * @param valueId The Id of the Value that was being changed.
  * @param invalidValues An array of the Values that were invalid.
  * @category Listener
- * @since v3.0
+ * @since v3.0.0
  */
 export type InvalidValueListener = (
   store: Store,
@@ -865,6 +894,22 @@ export type InvalidValueListener = (
   invalidValues: any[],
 ) => void;
 
+/**
+ * The GetIdChanges type describes a function that returns information about the
+ * changes to a set of Ids during a transaction.
+ *
+ * A GetIdChanges function is provided to every listener when called due Ids in
+ * the Store changing. It returns an object where each key is an Id that
+ * changed. The listener can then easily identify which Ids have been added
+ * (those with the value `1`), and which have been removed (those with the value
+ * `-1`).
+ * @returns An object keyed by Id with a numerical value. 1 means the Id was
+ * added, and 1 means it was removed.
+ * @category Listener
+ * @since v3.3.0
+ */
+export type GetIdChanges = () => {[id: Id]: 1 | -1};
+
 /**
  * The GetCellChange type describes a function that returns information about
  * any Cell's changes during a transaction.
@@ -873,7 +918,6 @@ export type InvalidValueListener = (
  * 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.
@@ -889,7 +933,6 @@ export type GetCellChange = (tableId: Id, rowId: Id, cellId: Id) => CellChange;
  * 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 = [
@@ -906,7 +949,6 @@ export type CellChange = [
  * Store changing. The listener can then fetch the previous value of a Value
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
- *
  * @param valueId The Id of the Value to inspect.
  * @returns A ValueChange array containing information about the Value's
  * changes.
@@ -921,7 +963,6 @@ export type GetValueChange = (valueId: Id) => ValueChange;
  * listener when called. This array contains the previous value of a Value
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
- *
  * @category Listener
  */
 export type ValueChange = [
@@ -951,9 +992,8 @@ export type ValueChange = [
  * two-part array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Cell was changed to a
  * different value and then changed back.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type ChangedCells = {
   [tableId: Id]: {[rowId: Id]: {[cellId: Id]: ChangedCell}};
@@ -975,9 +1015,8 @@ export type ChangedCells = {
  * two-part array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Cell was changed to a
  * different value and then changed back.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type ChangedCell = [CellOrUndefined, CellOrUndefined];
 
@@ -994,9 +1033,8 @@ export type ChangedCell = [CellOrUndefined, CellOrUndefined];
  * the Tables object, but one for which Cell values are listed in array (much
  * like the InvalidCellListener type) so that multiple failed attempts to change
  * a Cell during the transaction are described.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type InvalidCells = {
   [tableId: Id]: {[rowId: Id]: {[cellId: Id]: any[]}};
@@ -1022,9 +1060,8 @@ export type InvalidCells = {
  * array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Value was changed to
  * a different value and then changed back.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type ChangedValues = {
   [valueId: Id]: ChangedValue;
@@ -1046,9 +1083,8 @@ export type ChangedValues = {
  * array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Value was changed to
  * a different value and then changed back.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type ChangedValue = [ValueOrUndefined, ValueOrUndefined];
 
@@ -1064,9 +1100,8 @@ export type ChangedValue = [ValueOrUndefined, ValueOrUndefined];
  * This type is an object containing each invalid Value's attempt listed in
  * array (much like the InvalidValueListener type) so that multiple failed
  * attempts to change a Value during the transaction are described.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type InvalidValues = {[valueId: Id]: any[]};
 
@@ -1095,7 +1130,6 @@ export type InvalidValues = {[valueId: Id]: any[]};
  * If not empty, the second object has an entry for each Value in a Store that
  * has had a change. If the entry is null, the Value was deleted, otherwise it
  * will contain the new Value it was changed to during the transaction.
- *
  * @example
  * The following is a valid TransactionChanges array that conveys the following:
  * ```json
@@ -1113,9 +1147,8 @@ export type InvalidValues = {[valueId: Id]: any[]};
  *   {},                   // no changes to keyed value data in the Store
  * ]
  * ```
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type TransactionChanges = [
   {[tableId: Id]: {[rowId: Id]: {[cellId: Id]: Cell | null} | null} | null},
@@ -1129,9 +1162,8 @@ export type TransactionChanges = [
  * It is provided to the DoRollback callback and to a TransactionListener
  * listener when a transaction completes. See the TransactionChanges type for
  * more information and an example of the returned data structure.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type GetTransactionChanges = () => TransactionChanges;
 
@@ -1156,9 +1188,8 @@ export type GetTransactionChanges = () => TransactionChanges;
  * all changes have been reverted.
  *
  * See the documentation for the types of the inner objects for other details.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type TransactionLog = {
   cellsTouched: boolean;
@@ -1180,9 +1211,8 @@ export type TransactionLog = {
  * It is provided to the DoRollback callback and to a TransactionListener
  * listener when a transaction completes. See the TransactionLog type for more
  * information.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type GetTransactionLog = () => TransactionLog;
 
@@ -1194,7 +1224,6 @@ export type GetTransactionLog = () => TransactionLog;
  * listener. Totals include both mutator and non-mutator listeners. A
  * StoreListenerStats object is returned from the getListenerStats method, and
  * is only populated in a debug build.
- *
  * @category Development
  */
 export type StoreListenerStats = {
@@ -1210,6 +1239,11 @@ export type StoreListenerStats = {
    * The number of TableListener functions registered with the Store.
    */
   table?: number;
+  /**
+   * The number of TableCellIdsListener functions registered with the Store,
+   * since v3.3.
+   */
+  tableCellIds?: number;
   /**
    * The number of RowIdsListener functions registered with the Store.
    */
@@ -1350,6 +1384,7 @@ export type StoreListenerStats = {
  * |Tables|getTables|setTables|delTables|addTablesListener|
  * |Table Ids|getTableIds|-|-|addTableIdsListener|
  * |Table|getTable|setTable|delTable|addTableListener|
+ * |Table Cell Ids|getTableCellIds|-|-|addTableCellIdsListener|
  * |Row Ids|getRowIds|-|-|addRowIdsListener|
  * |Row Ids (sorted)|getSortedRowIds|-|-|addSortedRowIdsListener|
  * |Row|getRow|setRow|delRow|addRowListener|
@@ -1410,7 +1445,6 @@ export type StoreListenerStats = {
  *
  * Finally, the getListenerStats method describes the current state of the
  * Store's listeners for debugging purposes.
- *
  * @example
  * 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.
@@ -1448,7 +1482,6 @@ export interface Store {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned objects are not made to the Store
    * itself.
-   *
    * @returns An array of a Tables object and a Values object.
    * @example
    * This example retrieves the content of a Store.
@@ -1470,7 +1503,7 @@ export interface Store {
    * // -> [{}, {}]
    * ```
    * @category Getter
-   * @since v4.0
+   * @since v4.0.0
    */
   getContent(): [Tables, Values];
 
@@ -1481,7 +1514,6 @@ export interface Store {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @returns A Tables object containing the tabular data of the Store.
    * @example
    * This example retrieves the tabular data in a Store.
@@ -1512,7 +1544,6 @@ export interface Store {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @returns An array of the Ids of every Table in the Store.
    * @example
    * This example retrieves the Table Ids in a Store.
@@ -1545,7 +1576,6 @@ export interface Store {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @returns An object containing the entire data of the Table.
    * @example
@@ -1573,11 +1603,46 @@ export interface Store {
   getTable(tableId: Id): Table;
 
   /**
-   * The getRowIds method returns the Ids of every Row in a given Table.
+   * The getTableCellIds method returns the Ids of every Cell used across the
+   * whole Table.
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
+   * @param tableId The Id of the Table in the Store.
+   * @returns An array of the Ids of every Cell used across the whole Table.
+   * @example
+   * This example retrieves the Cell Ids used across a whole Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {
+   *     fido: {species: 'dog', color: 'brown'},
+   *     felix: {species: 'cat', legs: 4},
+   *     cujo: {dangerous: true},
+   *   },
+   * });
+   * console.log(store.getTableCellIds('pets'));
+   * // -> ['species', 'color', 'legs', 'dangerous']
+   * ```
+   * @example
+   * This example retrieves the Cell Ids used across a Table that does not
+   * exist, returning an empty array.
+   *
+   * ```js
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * console.log(store.getTableCellIds('species'));
+   * // -> []
+   * ```
+   * @category Getter
+   * @since v3.3.0
+   */
+  getTableCellIds(tableId: Id): Ids;
+
+  /**
+   * The getRowIds method returns the Ids of every Row in a given Table.
    *
+   * Note that this returns a copy of, rather than a reference, to the list of
+   * Ids, so changes made to the list are not made to the Store itself.
    * @param tableId The Id of the Table in the Store.
    * @returns An array of the Ids of every Row in the Table.
    * @example
@@ -1622,7 +1687,6 @@ export interface Store {
    * addSortedRowIdsListener method.
    *
    * If the Table does not exist, an empty array is returned.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param cellId The Id of the Cell whose values are used for the sorting, or
    * `undefined` to sort by the Row Id itself.
@@ -1703,7 +1767,7 @@ export interface Store {
    * // -> []
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   getSortedRowIds(
     tableId: Id,
@@ -1720,7 +1784,6 @@ export interface Store {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns An object containing the entire data of the Row.
@@ -1751,12 +1814,11 @@ export interface Store {
   getRow(tableId: Id, rowId: Id): Row;
 
   /**
-   * The getCellIds method returns the Ids of every Cell in a given Row, in a
+   * The getCellIds method returns the Ids of every Cell in a given Row in a
    * given Table.
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns An array of the Ids of every Cell in the Row.
@@ -1773,8 +1835,8 @@ export interface Store {
    * // -> ['species', 'color']
    * ```
    * @example
-   * This example retrieves the Cell Ids of a Cell that does not exist,
-   * returning an empty array.
+   * This example retrieves the Cell Ids of a Row that does not exist, returning
+   * an empty array.
    *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -1788,7 +1850,6 @@ export interface Store {
   /**
    * The getCell method returns the value of a single Cell in a given Row, in a
    * given Table.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -1822,7 +1883,6 @@ export interface Store {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @returns An object containing the set of keyed Values in the Store.
    * @example
    * This example retrieves the set of keyed Values in the Store.
@@ -1842,7 +1902,7 @@ export interface Store {
    * // -> {}
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValues(): Values;
 
@@ -1851,7 +1911,6 @@ export interface Store {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @returns An array of the Ids of every Value in the Store.
    * @example
    * This example retrieves the Value Ids in a Store.
@@ -1871,13 +1930,12 @@ export interface Store {
    * // -> []
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValueIds(): Ids;
 
   /**
    * The getValue method returns a single keyed Value in the Store.
-   *
    * @param valueId The Id of the Value in the Store.
    * @returns The Value, or `undefined`.
    * @example
@@ -1897,14 +1955,13 @@ export interface Store {
    * // -> undefined
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValue(valueId: Id): ValueOrUndefined;
 
   /**
    * The hasTables method returns a boolean indicating whether any Table objects
    * exist in the Store.
-   *
    * @returns Whether any Tables exist.
    * @example
    * This example shows simple existence checks.
@@ -1924,7 +1981,6 @@ export interface Store {
   /**
    * The hasTable method returns a boolean indicating whether a given Table
    * exists in the Store.
-   *
    * @param tableId The Id of a possible Table in the Store.
    * @returns Whether a Table with that Id exists.
    * @example
@@ -1941,10 +1997,34 @@ export interface Store {
    */
   hasTable(tableId: Id): boolean;
 
+  /**
+   * The hasTableCell method returns a boolean indicating whether a given Cell
+   * exists anywhere in a Table, not just in a specific Row.
+   * @param tableId The Id of a possible Table in the Store.
+   * @param cellId The Id of a possible Cell in the Table.
+   * @returns Whether a Cell with that Id exists anywhere in that Table.
+   * @example
+   * This example shows two simple Cell existence checks.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog'}, felix: {legs: 4}},
+   * });
+   * console.log(store.hasTableCell('pets', 'species'));
+   * // -> true
+   * console.log(store.hasTableCell('pets', 'legs'));
+   * // -> true
+   * console.log(store.hasTableCell('pets', 'color'));
+   * // -> false
+   * ```
+   * @category Getter
+   * @since v3.3.0
+   */
+  hasTableCell(tableId: Id, cellId: Id): boolean;
+
   /**
    * The hasRow method returns a boolean indicating whether a given Row exists
    * in the Store.
-   *
    * @param tableId The Id of a possible Table in the Store.
    * @param rowId The Id of a possible Row in the Table.
    * @returns Whether a Row with that Id exists in that Table.
@@ -1964,8 +2044,7 @@ export interface Store {
 
   /**
    * The hasCell method returns a boolean indicating whether a given Cell exists
-   * in the Store.
-   *
+   * in a given Row in a given Table.
    * @param tableId The Id of a possible Table in the Store.
    * @param rowId The Id of a possible Row in the Table.
    * @param cellId The Id of a possible Cell in the Row.
@@ -1987,7 +2066,6 @@ export interface Store {
   /**
    * The hasTables method returns a boolean indicating whether any Values exist
    * in the Store.
-   *
    * @returns Whether any Values exist.
    * @example
    * This example shows simple existence checks.
@@ -2001,14 +2079,13 @@ export interface Store {
    * // -> true
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   hasValues(): boolean;
 
   /**
    * The hasValue method returns a boolean indicating whether a given Value
    * exists in the Store.
-   *
    * @param valueId The Id of a possible Value in the Store.
    * @returns Whether a Value with that Id exists in the Store.
    * @example
@@ -2022,14 +2099,13 @@ export interface Store {
    * // -> false
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   hasValue(valueId: Id): boolean;
 
   /**
    * The getTablesJson method returns a string serialization of all of the
    * Tables in the Store.
-   *
    * @returns A string serialization of all of the Tables in the Store.
    * @example
    * This example serializes the contents of a Store.
@@ -2048,14 +2124,13 @@ export interface Store {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getTablesJson(): Json;
 
   /**
    * The getValuesJson method returns a string serialization of all of the keyed
    * Values in the Store.
-   *
    * @returns A string serialization of all of the Values in the Store.
    * @example
    * This example serializes the keyed value contents of a Store.
@@ -2074,7 +2149,7 @@ export interface Store {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValuesJson(): Json;
 
@@ -2086,7 +2161,6 @@ export interface Store {
    * first is the Tables object, the second the Values. In previous versions
    * (before the existence of the Values data structure), it was a sole object
    * of Tables.
-   *
    * @returns A string serialization of the Tables and Values in the Store.
    * @example
    * This example serializes the tabular and keyed value contents of a Store.
@@ -2117,7 +2191,6 @@ export interface Store {
    * If no TablesSchema has been set on the Store (or if it has been removed
    * with the delTablesSchema method), then it will return the serialization of
    * an empty object, `{}`.
-   *
    * @returns A string serialization of the TablesSchema of the Store.
    * @example
    * This example serializes the TablesSchema of a Store.
@@ -2141,7 +2214,7 @@ export interface Store {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getTablesSchemaJson(): Json;
 
@@ -2152,7 +2225,6 @@ export interface Store {
    * If no ValuesSchema has been set on the Store (or if it has been removed
    * with the delValuesSchema method), then it will return the serialization of
    * an empty object, `{}`.
-   *
    * @returns A string serialization of the ValuesSchema of the Store.
    * @example
    * This example serializes the ValuesSchema of a Store.
@@ -2173,7 +2245,7 @@ export interface Store {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValuesSchemaJson(): Json;
 
@@ -2185,7 +2257,6 @@ export interface Store {
    * first is the TablesSchema object, the second the ValuesSchema. In previous
    * versions (before the existence of the ValuesSchema data structure), it was
    * a sole object of TablesSchema.
-   *
    * @returns A string serialization of the TablesSchema and ValuesSchema of the
    * Store.
    * @example
@@ -2235,7 +2306,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param content An array containing the tabular and keyed-value data of the
    * Store to be set.
    * @example
@@ -2272,7 +2342,7 @@ export interface Store {
    * // -> {pets: {felix: {species: 'cat'}}}
    * ```
    * @category Setter
-   * @since v4.0
+   * @since v4.0.0
    */
   setContent([tables, values]: [Tables, Values]): Store;
 
@@ -2293,7 +2363,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param tables The data of the Store to be set.
    * @example
    * This example sets the tabular data of a Store.
@@ -2343,7 +2412,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param table The data of a single Table to be set.
    * @example
@@ -2394,7 +2462,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param row The data of a single Row to be set.
@@ -2451,7 +2518,6 @@ export interface Store {
    * if you specify `reuseRowIds` to be `false`, then the Id will be a
    * monotonically increasing string representation of an increasing integer,
    * regardless of any you may have previously deleted.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param row The data of a single Row to be added.
    * @param reuseRowIds Whether Ids should be recycled from previously deleted
@@ -2505,7 +2571,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param partialRow The partial data of a single Row to be set.
@@ -2557,7 +2622,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -2615,7 +2679,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param values The Values object to be set.
    * @returns A reference to the Store.
    * @example
@@ -2642,7 +2705,7 @@ export interface Store {
    * // -> {employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValues(values: Values): Store;
 
@@ -2664,7 +2727,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param partialValues The Values to be set.
    * @returns A reference to the Store.
    * @example
@@ -2692,7 +2754,7 @@ export interface Store {
    * // -> {open: true, employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setPartialValues(partialValues: Values): Store;
 
@@ -2712,7 +2774,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param valueId The Id of the Value in the Store.
    * @param value The Value to be set, or a MapValue function to update it.
    * @returns A reference to the Store.
@@ -2746,7 +2807,7 @@ export interface Store {
    * // -> {employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValue(valueId: Id, value: Value | MapValue): Store;
 
@@ -2766,7 +2827,6 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
-   *
    * @param transactionChanges The TransactionChanges to apply to the Store.
    * @returns A reference to the Store.
    * @example
@@ -2788,7 +2848,7 @@ export interface Store {
    * // -> {}
    * ```
    * @category Setter
-   * @since v4.0
+   * @since v4.0.0
    */
   setTransactionChanges(transactionChanges: TransactionChanges): Store;
 
@@ -2800,7 +2860,6 @@ export interface Store {
    * it will then be subject to the same validation rules as the setTables
    * method (according to the Tables type, and matching any TablesSchema
    * associated with the Store).
-   *
    * @param tablesJson A string serialization of all of the Tables in the Store.
    * @returns A reference to the Store.
    * @example
@@ -2823,7 +2882,7 @@ export interface Store {
    * // -> {}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setTablesJson(tablesJson: Json): Store;
 
@@ -2835,7 +2894,6 @@ export interface Store {
    * it will then be subject to the same validation rules as the setValues
    * method (according to the Values type, and matching any ValuesSchema
    * associated with the Store).
-   *
    * @param valuesJson A string serialization of all of the Values in the Store.
    * @returns A reference to the Store.
    * @example
@@ -2858,7 +2916,7 @@ export interface Store {
    * // -> {}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValuesJson(valuesJson: Json): Store;
 
@@ -2877,7 +2935,6 @@ export interface Store {
    * method (according to the Tables type, and matching any TablesSchema
    * associated with the Store), and the setValues method (according to the
    * Values type, and matching any ValuesSchema associated with the Store).
-   *
    * @param tablesAndValuesJson A string serialization of all of the Tables and
    * Values in the Store.
    * @returns A reference to the Store.
@@ -2931,7 +2988,6 @@ export interface Store {
    *
    * When no longer needed, you can also completely remove an existing
    * TablesSchema with the delTablesSchema method.
-   *
    * @param tablesSchema The TablesSchema to be set for the Store.
    * @returns A reference to the Store.
    * @example
@@ -2950,7 +3006,7 @@ export interface Store {
    * // -> {pets: {0: {species: 'dog', sold: false}}}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setTablesSchema(tablesSchema: TablesSchema): Store;
 
@@ -2964,7 +3020,6 @@ export interface Store {
    *
    * When no longer needed, you can also completely remove an existing
    * ValuesSchema with the delValuesSchema method.
-   *
    * @param valuesSchema The ValuesSchema to be set for the Store.
    * @returns A reference to the Store.
    * @example
@@ -2980,7 +3035,7 @@ export interface Store {
    * // -> {open: false}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValuesSchema(valuesSchema: ValuesSchema): Store;
 
@@ -2997,7 +3052,6 @@ export interface Store {
    * (before the existence of the ValuesSchema data structure), only the first
    * was present. For backwards compatibility the new second parameter is
    * optional.
-   *
    * @param tablesSchema The TablesSchema to be set for the Store.
    * @param valuesSchema The ValuesSchema to be set for the Store.
    * @returns A reference to the Store.
@@ -3045,7 +3099,6 @@ export interface Store {
 
   /**
    * The delTables method lets you remove all of the data in a Store.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes the data of a Store.
@@ -3063,7 +3116,6 @@ export interface Store {
 
   /**
    * The delTable method lets you remove a single Table from the Store.
-   *
    * @param tableId The Id of the Table in the Store.
    * @returns A reference to the Store.
    * @example
@@ -3087,7 +3139,6 @@ export interface Store {
    * The delRow method lets you remove a single Row from a Table.
    *
    * If this is the last Row in its Table, then that Table will be removed.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns A reference to the Store.
@@ -3127,7 +3178,6 @@ export interface Store {
    * invalid Row (according to the TablesSchema), in fact the whole Row is
    * deleted to retain the integrity of the Table. Therefore, this flag should
    * be used with caution.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -3197,7 +3247,6 @@ export interface Store {
    * If there is a ValuesSchema applied to the Store and it specifies a default
    * value for any Value Id, then deletion will result in it being set back to
    * its default value.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes all Values from a Store without a ValuesSchema.
@@ -3226,7 +3275,7 @@ export interface Store {
    * // -> {open: false}
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValues(): Store;
 
@@ -3236,7 +3285,6 @@ export interface Store {
    * If there is a ValuesSchema applied to the Store and it specifies a default
    * value for this Value Id, then deletion will result in it being set back to
    * its default value.
-   *
    * @param valueId The Id of the Value in the Row.
    * @returns A reference to the Store.
    * @example
@@ -3266,13 +3314,12 @@ export interface Store {
    * // -> {open: false, employees: 3}
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValue(valueId: Id): Store;
 
   /**
    * The delTablesSchema method lets you remove the TablesSchema of the Store.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes the TablesSchema of a Store.
@@ -3291,7 +3338,6 @@ export interface Store {
 
   /**
    * The delValuesSchema method lets you remove the ValuesSchema of the Store.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes the ValuesSchema of a Store.
@@ -3305,7 +3351,7 @@ export interface Store {
    * // -> '{}'
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValuesSchema(): Store;
 
@@ -3314,7 +3360,6 @@ export interface Store {
    * of the Store.
    *
    * Prior to v3.0, this method removed the TablesSchema only.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes the TablesSchema and ValuesSchema of a Store.
@@ -3332,7 +3377,7 @@ export interface Store {
    * // -> '[{},{}]'
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delSchema(): Store;
 
@@ -3364,7 +3409,6 @@ export interface Store {
    * `getTransactionLog` parameters, which inform you of the net changes that
    * have been made during the transaction, at different levels of detail. See
    * the DoRollback documentation for more details.
-   *
    * @param actions The function to be executed as a transaction.
    * @param doRollback An optional callback that should return `true` if you
    * want to rollback the transaction at the end. Since v1.2.
@@ -3488,7 +3532,6 @@ export interface Store {
    * that are asynchronous or not occurring inline to your code. You must
    * remember to also call the finishTransaction method explicitly when it is
    * done, of course.
-   *
    * @returns A reference to the Store.
    * @example
    * This example makes changes to two Cells, first outside, and secondly
@@ -3513,7 +3556,7 @@ export interface Store {
    * // -> 'Fido changed'
    * ```
    * @category Transaction
-   * @since v1.3
+   * @since v1.3.0
    */
   startTransaction(): Store;
 
@@ -3545,7 +3588,6 @@ export interface Store {
    * `getTransactionLog` parameters, which inform you of the net changes that
    * have been made during the transaction, at different levels of detail. See
    * the DoRollback documentation for more details.
-   *
    * @param doRollback An optional callback that should return `true` if you
    * want to rollback the transaction at the end.
    * @returns A reference to the Store.
@@ -3611,7 +3653,7 @@ export interface Store {
    * // -> {open: true}
    * ```
    * @category Transaction
-   * @since v1.3
+   * @since v1.3.0
    */
   finishTransaction(doRollback?: DoRollback): Store;
 
@@ -3624,7 +3666,6 @@ export interface Store {
    * function that will be called with the Id of each Table, and with a function
    * that can then be used to iterate over each Row of the Table, should you
    * wish.
-   *
    * @param tableCallback The function that should be called for every Table.
    * @example
    * This example iterates over each Table in a Store, and lists each Row Id
@@ -3648,6 +3689,35 @@ export interface Store {
    */
   forEachTable(tableCallback: TableCallback): void;
 
+  /**
+   * The forEachTableCell method takes a function that it will then call for
+   * each Cell used across the whole Table.
+   *
+   * This method is useful for iterating over the Cell structure of the Table in
+   * a functional style. The `tableCellCallback` parameter is a
+   * TableCellCallback function that will be called with the Id of each Cell and
+   * the count of Rows in the Table in which it appears.
+   * @param tableId The Id of the Table containing the Cells to iterate over.
+   * @param tableCellCallback The function that should be called for every Cell
+   * Id used across the whole Table.
+   * @example
+   * This example iterates over each Cell Id used across the whole Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog'}, felix: {species: 'cat', legs: 4}},
+   * });
+   * store.forEachTableCell('pets', (cellId, count) => {
+   *   console.log(`${cellId}: ${count}`);
+   * });
+   * // -> 'species: 2'
+   * // -> 'legs: 1'
+   * ```
+   * @category Iterator
+   * @since v3.3.0
+   */
+  forEachTableCell(tableId: Id, tableCellCallback: TableCellCallback): void;
+
   /**
    * The forEachRow method takes a function that it will then call for each Row
    * in a specified Table.
@@ -3656,7 +3726,6 @@ export interface Store {
    * a functional style. The `rowCallback` parameter is a RowCallback function
    * that will be called with the Id of each Row, and with a function that can
    * then be used to iterate over each Cell of the Row, should you wish.
-   *
    * @param tableId The Id of the Table to iterate over.
    * @param rowCallback The function that should be called for every Row.
    * @example
@@ -3690,7 +3759,6 @@ export interface Store {
    * This method is useful for iterating over the Cell structure of the Row in a
    * functional style. The `cellCallback` parameter is a CellCallback function
    * that will be called with the Id and value of each Cell.
-   *
    * @param tableId The Id of the Table containing the Row to iterate over.
    * @param rowId The Id of the Row to iterate over.
    * @param cellCallback The function that should be called for every Cell.
@@ -3718,7 +3786,6 @@ export interface Store {
    * This method is useful for iterating over the Value structure of the Store
    * in a functional style. The `valueCallback` parameter is a ValueCallback
    * function that will be called with the Id and value of each Value.
-   *
    * @param valueCallback The function that should be called for every Value.
    * @example
    * This example iterates over each Value in a Store, and lists its value.
@@ -3732,7 +3799,7 @@ export interface Store {
    * // -> 'employees: 3'
    * ```
    * @category Iterator
-   * @since v3.0
+   * @since v3.0.0
    */
   forEachValue(valueCallback: ValueCallback): void;
 
@@ -3751,7 +3818,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever data in the Store
    * changes.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -3818,7 +3884,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever the Table Ids in
    * the Store change.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -3883,7 +3948,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
    * matching Table changes.
@@ -3960,6 +4024,110 @@ export interface Store {
     mutator?: boolean,
   ): Id;
 
+  /**
+   * The addTableCellIdsListener method registers a listener function with the
+   * Store that will be called whenever the Cell Ids that appear anywhere in a
+   * Table change.
+   *
+   * The provided listener is a TableCellIdsListener function, and will be
+   * called with a reference to the Store and the Id of the Table that changed.
+   *
+   * By default, such a listener is only called when a Cell Id is added or
+   * removed from the whole of the Table. To listen to all changes in the Table,
+   * use the addTableListener method.
+   *
+   * You can either listen to a single Table (by specifying its Id as the
+   * method's first parameter) or changes to any Table (by providing a `null`
+   * wildcard).
+   *
+   * Use the optional mutator parameter to indicate that there is code in the
+   * listener that will mutate Store data. If set to `false` (or omitted), such
+   * mutations will be silently ignored. All relevant mutator listeners (with
+   * this flag set to `true`) are called _before_ any non-mutator listeners
+   * (since the latter may become relevant due to changes made in the former).
+   * The changes made by mutator listeners do not fire other mutating listeners,
+   * though they will fire non-mutator listeners.
+   * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
+   * @param listener The function that will be called whenever the Cell Ids that
+   * appear anywhere in a Table change.
+   * @param mutator An optional boolean that indicates that the listener mutates
+   * Store data.
+   * @returns A unique Id for the listener that can later be used to call it
+   * explicitly, or to remove it.
+   * @example
+   * This example registers a listener that responds to any change to the Cell
+   * Ids that appear anywhere in a Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   * });
+   * const listenerId = store.addTableCellIdsListener('pets', (store) => {
+   *   console.log('Cell Ids in pets table changed');
+   *   console.log(store.getTableCellIds('pets'));
+   * });
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * // -> 'Cell Ids in pets table changed'
+   * // -> ['species', 'color', 'legs']
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @example
+   * This example registers a listener that responds to any change to the Cell
+   * Ids that appear anywhere in any Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   *   species: {dog: {price: 5}},
+   * });
+   * const listenerId = store.addTableCellIdsListener(
+   *   null,
+   *   (store, tableId) => {
+   *     console.log(`Cell Ids in ${tableId} table changed`);
+   *     console.log(store.getTableCellIds(tableId));
+   *   },
+   * );
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * // -> 'Cell Ids in pets table changed'
+   * // -> ['species', 'color', 'legs']
+   *
+   * store.setRow('species', 'cat', {price: 4, friendly: true});
+   * // -> 'Cell Ids in species table changed'
+   * // -> ['price', 'friendly']
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @example
+   * This example registers a listener that responds to the Cell Ids that appear
+   * anywhere in a Table, and which also mutates the Store itself.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   * });
+   * const listenerId = store.addTableCellIdsListener(
+   *   'pets',
+   *   (store, tableId) => store.setCell('meta', 'update', tableId, true),
+   *   true, // mutator
+   * );
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * console.log(store.getTable('meta'));
+   * // -> {update: {pets: true}}
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @category Listener
+   */
+  addTableCellIdsListener(
+    tableId: IdOrNull,
+    listener: TableCellIdsListener,
+    mutator?: boolean,
+  ): Id;
+
   /**
    * The addRowIdsListener method registers a listener function with the Store
    * that will be called whenever the Row Ids in a Table change.
@@ -3981,7 +4149,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the Row Ids in
    * the Table change.
@@ -4085,7 +4252,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to.
    * @param cellId The Id of the Cell whose values are used for the sorting, or
    * `undefined` to sort by the Row Id itself.
@@ -4134,7 +4300,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @example
-   * This 111example registers a listener that responds to any change to a
+   * This example registers a listener that responds to any change to a
    * paginated section of the sorted Row Ids of a specific Table.
    *
    * ```js
@@ -4266,7 +4432,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addSortedRowIdsListener(
     tableId: Id,
@@ -4303,7 +4469,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
@@ -4415,7 +4580,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the Cell Ids in
@@ -4520,7 +4684,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param cellId The Id of the Cell to listen to, or `null` as a wildcard.
@@ -4629,7 +4792,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever data in the
    * Values changes.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -4671,7 +4833,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValuesListener(listener: ValuesListener, mutator?: boolean): Id;
 
@@ -4693,7 +4855,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever the Value Ids in
    * the Store change.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -4735,7 +4896,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValueIdsListener(listener: ValueIdsListener, mutator?: boolean): Id;
 
@@ -4758,7 +4919,6 @@ export interface Store {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param valueId The Id of the Value to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
    * matching Value changes.
@@ -4824,7 +4984,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValueListener(
     valueId: IdOrNull,
@@ -4877,7 +5037,6 @@ export interface Store {
    *
    * To help understand all of these schema-based conditions, please see the
    * TablesSchema example below.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param cellId The Id of the Cell to listen to, or `null` as a wildcard.
@@ -5053,7 +5212,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v1.1
+   * @since v1.1.0
    */
   addInvalidCellListener(
     tableId: IdOrNull,
@@ -5101,7 +5260,6 @@ export interface Store {
    *
    * To help understand all of these schema-based conditions, please see the
    * ValuesSchema example below.
-   *
    * @param valueId The Id of the Value to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever an attempt to
    * write invalid data to the matching Value was made.
@@ -5231,7 +5389,7 @@ export interface Store {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addInvalidValueListener(
     valueId: IdOrNull,
@@ -5239,6 +5397,50 @@ export interface Store {
     mutator?: boolean,
   ): Id;
 
+  /**
+   * The addStartTransactionListener method registers a listener function with
+   * the Store that will be called at the start of a transaction.
+   *
+   * The provided TransactionListener will receive a reference to the Store and
+   * two booleans to indicate whether Cell or Value data has been touched during
+   * the transaction. Since this is called at the start, they will both be
+   * `false`!
+   *
+   * Note that a TransactionListener added to the Store with this method can
+   * mutate the Store, and its changes will be treated as part of the
+   * transaction that is starting.
+   * @returns A unique Id for the listener that can later be used to remove it.
+   * @example
+   * This example registers a listener that is called at start end of the
+   * transaction, just before its listeners will be called.
+   *
+   * ```js
+   * 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');
+   *   },
+   * );
+   *
+   * store.transaction(() =>
+   *   store.setCell('pets', 'fido', 'color', 'brown').setValue('employees', 3),
+   * );
+   * // -> 'Transaction started'
+   *
+   * store.callListener(listenerId);
+   * // -> 'Transaction started'
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @category Listener
+   * @since v3.2.0
+   */
+  addStartTransactionListener(listener: TransactionListener): Id;
+
   /**
    * The addWillFinishTransactionListener method registers a listener function
    * with the Store that will be called just before other non-mutating listeners
@@ -5259,6 +5461,10 @@ export interface Store {
    * value of `cellsTouched` and `valuesTouched` in the listener will be `false`
    * because all changes have been reverted.
    *
+   * Note that a TransactionListener added to the Store with this method can
+   * mutate the Store itself, and its changes will be treated as part of the
+   * transaction that is starting (and may fire non-mutating listeners after
+   * this).
    * @returns A unique Id for the listener that can later be used to remove it.
    * @example
    * This example registers a listener that is called at the end of the
@@ -5328,7 +5534,7 @@ export interface Store {
    *   .delListener(listenerId3);
    * ```
    * @category Listener
-   * @since v1.3
+   * @since v1.3.0
    */
   addWillFinishTransactionListener(listener: TransactionListener): Id;
 
@@ -5353,6 +5559,8 @@ export interface Store {
    * value of `cellsTouched` and `valuesTouched` in the listener will be `false`
    * because all changes have been reverted.
    *
+   * Note that a TransactionListener added to the Store with this method
+   * _cannot_ mutate the Store itself, and attempts to do so will fail silently.
    * @returns A unique Id for the listener that can later be used to remove it.
    * @example
    * This example registers a listener that is called at the end of the
@@ -5422,7 +5630,7 @@ export interface Store {
    *   .delListener(listenerId3);
    * ```
    * @category Listener
-   * @since v1.3
+   * @since v1.3.0
    */
   addDidFinishTransactionListener(listener: TransactionListener): Id;
 
@@ -5433,7 +5641,6 @@ export interface Store {
    * This is useful when you are using mutator listeners to guarantee that data
    * conforms to programmatic conditions, and those conditions change such that
    * you need to update the Store in bulk.
-   *
    * @param listenerId The Id of the listener to call.
    * @returns A reference to the Store.
    * @example
@@ -5549,7 +5756,6 @@ export interface Store {
    *
    * Use the Id returned by whichever method was used to add the listener. Note
    * that the Store may re-use this Id for future listeners added to it.
-   *
    * @param listenerId The Id of the listener to remove.
    * @returns A reference to the Store.
    * @example
@@ -5587,7 +5793,6 @@ export interface Store {
    * return an empty object. The method is intended to be used during
    * development to ensure your application is not leaking listener
    * registrations, for example.
-   *
    * @returns A StoreListenerStats object containing Store listener statistics.
    * @example
    * This example gets the listener statistics of a small and simple Store.
@@ -5615,7 +5820,6 @@ export interface Store {
  *
  * Since (or perhaps _because_) it is the most important function in the whole
  * module, it is trivially simple.
- *
  * @returns A reference to the new Store.
  * @example
  * This example creates a Store.