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

package/lib/types/queries.d.ts

@@ -6,10 +6,9 @@
  * function, which returns a new Queries object. That object in turn has methods
  * that let you create new query definitions, access their results directly, and
  * register listeners for when those results change.
- *
  * @packageDocumentation
  * @module queries
- * @since v2.0
+ * @since v2.0.0
  */
 
 import {Cell, CellOrUndefined, GetCell, Store} from './store.d';
@@ -23,7 +22,6 @@ import {Id, IdOrNull, Ids} from './common.d';
  * addResultTableListener method. It is similar to the Table type in the store
  * module, but without schema-specific typing, and is a regular JavaScript
  * object containing individual ResultRow objects, keyed by their Id.
- *
  * @example
  * ```js
  * const resultTable: ResultTable = {
@@ -43,7 +41,6 @@ export type ResultTable = {[rowId: Id]: ResultRow};
  * addResultRowListener method. It is similar to the Row type in the store
  * module, but without schema-specific typing, and is a regular JavaScript
  * object containing individual ResultCell objects, keyed by their Id.
- *
  * @example
  * ```js
  * const resultRow: ResultRow = {species: 'dog', color: 'brown'};
@@ -60,7 +57,6 @@ export type ResultRow = {[cellId: Id]: ResultCell};
  * addResultCellListener method. It is similar to the Cell type in the store
  * module, but without schema-specific typing, and is a JavaScript string,
  * number, or boolean.
- *
  * @example
  * ```js
  * const resultCell: ResultCell = 'dog';
@@ -72,7 +68,6 @@ export type ResultCell = string | number | boolean;
 /**
  * The ResultCellOrUndefined type is the data structure representing a single
  * cell in the results of a query, or the value `undefined`.
- *
  * @category Result
  */
 export type ResultCellOrUndefined = ResultCell | undefined;
@@ -84,12 +79,11 @@ export type ResultCellOrUndefined = ResultCell | undefined;
  * There are a number of common predefined aggregators, such as for counting,
  * summing, and averaging values. This type is instead used for when you wish to
  * use a more complex aggregation of your own devising.
- *
  * @param cells The array of Cell values to be aggregated.
  * @param length The length of the array of Cell values to be aggregated.
  * @returns The value of the aggregation.
  * @category Aggregators
- * @since v2.0
+ * @since v2.0.0
  */
 export type Aggregate = (cells: Cell[], length: number) => ResultCell;
 
@@ -109,13 +103,12 @@ export type Aggregate = (cells: Cell[], length: number) => ResultCell;
  * Where possible, if you are providing a custom Aggregate, seek an
  * implementation of an AggregateAdd function that can reduce the complexity
  * cost of growing the input data set.
- *
  * @param current The current value of the aggregation.
  * @param add The Cell value being added to the aggregation.
  * @param length The length of the array of Cell values in the aggregation.
  * @returns The new value of the aggregation.
  * @category Aggregators
- * @since v2.0
+ * @since v2.0.0
  */
 export type AggregateAdd = (
   current: Cell,
@@ -142,13 +135,12 @@ export type AggregateAdd = (
  * Where possible, if you are providing a custom Aggregate, seek an
  * implementation of an AggregateRemove function that can reduce the complexity
  * cost of shrinking the input data set.
- *
  * @param current The current value of the aggregation.
  * @param remove The Cell value being removed from the aggregation.
  * @param length The length of the array of Cell values in the aggregation.
  * @returns The new value of the aggregation.
  * @category Aggregators
- * @since v2.0
+ * @since v2.0.0
  */
 export type AggregateRemove = (
   current: Cell,
@@ -173,14 +165,13 @@ export type AggregateRemove = (
  * Where possible, if you are providing a custom Aggregate, seek an
  * implementation of an AggregateReplace function that can reduce the complexity
  * cost of changing the input data set in place.
- *
  * @param current The current value of the aggregation.
  * @param add The Cell value being added to the aggregation.
  * @param remove The Cell value being removed from the aggregation.
  * @param length The length of the array of Cell values in the aggregation.
  * @returns The new value of the aggregation.
  * @category Aggregators
- * @since v2.0
+ * @since v2.0.0
  */
 export type AggregateReplace = (
   current: Cell,
@@ -195,10 +186,9 @@ export type AggregateReplace = (
  * A QueryCallback is provided when using the forEachQuery method, so that you
  * can do something based on every query in the Queries object. See that method
  * for specific examples.
- *
  * @param queryId The Id of the query that the callback can operate on.
  * @category Callback
- * @since v2.0
+ * @since v2.0.0
  */
 export type QueryCallback = (queryId: Id) => void;
 
@@ -209,7 +199,6 @@ export type QueryCallback = (queryId: Id) => void;
  * A ResultTableCallback is provided when using the forEachResultTable method,
  * so that you can do something based on every ResultTable in the Queries
  * object. See that method for specific examples.
- *
  * @param tableId The Id of the ResultTable that the callback can operate on.
  * @param forEachRow A function that will let you iterate over the ResultRow
  * objects in this ResultTable.
@@ -227,7 +216,6 @@ export type ResultTableCallback = (
  * A ResultRowCallback is provided when using the forEachResultRow method, so
  * that you can do something based on every ResultRow in a ResultTable. See that
  * method for specific examples.
- *
  * @param rowId The Id of the ResultRow that the callback can operate on.
  * @param forEachRow A function that will let you iterate over the ResultCell
  * values in this ResultRow.
@@ -245,7 +233,6 @@ export type ResultRowCallback = (
  * A ResultCellCallback is provided when using the forEachResultCell method, so
  * that you can do something based on every ResultCell in a ResultRow. See that
  * method for specific examples.
- *
  * @param cellId The Id of the ResultCell that the callback can operate on.
  * @param cell The value of the ResultCell.
  * @category Callback
@@ -263,14 +250,13 @@ export type ResultCellCallback = (cellId: Id, cell: ResultCell) => void;
  * object, the Id of the ResultTable that changed (which is the same as the
  * query Id), and a GetCellResultChange function that can be used to query
  * ResultCell values before and after the change.
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
  * @param getCellChange A function that returns information about any
  * ResultCell's changes.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultTableListener = (
   queries: Queries,
@@ -288,12 +274,11 @@ export type ResultTableListener = (
  * When called, a ResultRowIdsListener is given a reference to the Queries
  * object, and the Id of the ResultTable whose ResultRow Ids changed (which is
  * the same as the query Id).
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultRowIdsListener = (queries: Queries, tableId: Id) => void;
 
@@ -311,7 +296,6 @@ export type ResultRowIdsListener = (queries: Queries, tableId: Id) => void;
  * 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 getResultSortedRowIds.
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
@@ -322,7 +306,7 @@ export type ResultRowIdsListener = (queries: Queries, tableId: Id) => void;
  * @param limit The maximum number of ResultRow Ids returned.
  * @param sortedRowIds The sorted ResultRow Ids themselves.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultSortedRowIdsListener = (
   queries: Queries,
@@ -345,7 +329,6 @@ export type ResultSortedRowIdsListener = (
  * the Id of the ResultTable that changed (which is the same as the query Id),
  * the Id of the ResultRow that changed, and a GetCellResultChange function that
  * can be used to query ResultCell values before and after the change.
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
@@ -353,7 +336,7 @@ export type ResultSortedRowIdsListener = (
  * @param getCellChange A function that returns information about any
  * ResultCell's changes.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultRowListener = (
   queries: Queries,
@@ -372,13 +355,12 @@ export type ResultRowListener = (
  * When called, a ResultCellIdsListener is given a reference to the Queries
  * object, the Id of the ResultTable that changed (which is the same as the
  * query Id), and the Id of the ResultRow whose ResultCell Ids changed.
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
  * @param rowId The Id of the ResultRow that changed.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultCellIdsListener = (
   queries: Queries,
@@ -399,7 +381,6 @@ export type ResultCellIdsListener = (
  * It is also given the new value of the ResultCell, the old value of the
  * ResultCell, and a GetCellResultChange function that can be used to query
  * ResultCell values before and after the change.
- *
  * @param queries A reference to the Queries object that changed.
  * @param tableId The Id of the ResultTable that changed, which is also the
  * query Id.
@@ -410,7 +391,7 @@ export type ResultCellIdsListener = (
  * @param getCellChange A function that returns information about any
  * ResultCell's changes.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type ResultCellListener = (
   queries: Queries,
@@ -430,7 +411,6 @@ export type ResultCellListener = (
  * the Store changing. The listener can then fetch the previous value of a
  * ResultCell 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 ResultTable to inspect.
  * @param rowId The Id of the ResultRow to inspect.
  * @param cellId The Id of the ResultCell to inspect.
@@ -452,7 +432,6 @@ export type GetCellResultChange = (
  * every listener when called. This array contains the previous value of a
  * ResultCell before the current transaction, the new value after it, and a
  * convenience flag that indicates that the value has changed.
- *
  * @category Listener
  */
 export type ResultCellChange = [
@@ -467,9 +446,8 @@ export type ResultCellChange = [
  *
  * A QueriesListenerStats object is returned from the getListenerStats method,
  * and is only populated in a debug build.
- *
  * @category Development
- * @since v2.0
+ * @since v2.0.0
  */
 export type QueriesListenerStats = {
   /**
@@ -501,16 +479,14 @@ export type QueriesListenerStats = {
  * A GetTableCell can be provided when setting query definitions, specifically
  * in the Select and Where clauses when you want to create or filter on
  * calculated values. See those methods for specific examples.
- *
  * @category Callback
- * @since v2.0
+ * @since v2.0.0
  */
 export type GetTableCell = {
   /**
    * When called with one parameter, this function will return the value of
    * the specified Cell from the query's root Table for the Row being selected
    * or filtered.
-   *
    * @param cellId The Id of the Cell to fetch the value for.
    * @returns A Cell value or `undefined`.
    */
@@ -519,7 +495,6 @@ export type GetTableCell = {
    * When called with two parameters, this function will return the value of
    * the specified Cell from a Table that has been joined in the query, for
    * the Row being selected or filtered.
-   *
    * @param joinedTableId The Id of the Table to fetch the value from. If the
    * underlying Table was joined 'as' a different Id, that should instead be
    * used.
@@ -536,7 +511,6 @@ export type GetTableCell = {
  * The Select function is provided to the third `query` parameter of the
  * setQueryDefinition method. A query definition must call the Select function
  * at least once, otherwise it will be meaningless and return no data.
- *
  * @example
  * This example shows a query that selects two Cells from the main query Table.
  *
@@ -624,13 +598,12 @@ export type GetTableCell = {
  * // -> {cujo: {description: 'dog for Carol'}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type Select = {
   /**
    * Calling this function with one Id parameter will indicate that the query
    * should select the value of the specified Cell from the query's root Table.
-   *
    * @param cellId The Id of the Cell to fetch the value for.
    * @returns A SelectedAs object so that the selected Cell Id can be optionally
    * aliased.
@@ -640,7 +613,6 @@ export type Select = {
    * Calling this function with two parameters will indicate that the query
    * should select the value of the specified Cell from a Table that has been
    * joined in the query.
-   *
    * @param joinedTableId The Id of the Table to fetch the value from. If the
    * underlying Table was joined 'as' a different Id, that should instead be
    * used.
@@ -653,7 +625,6 @@ export type Select = {
    * Calling this function with one callback parameter will indicate that the
    * query should select a calculated value, based on one or more Cell values in
    * the root Table or a joined Table, or on the root Table's Row Id.
-   *
    * @param getCell A callback that takes a GetTableCell function and the main
    * Table's Row Id. These can be used to programmatically create a calculated
    * value from multiple Cell values and the Row Id.
@@ -676,7 +647,6 @@ export type Select = {
  * Note that if two Select clauses are both aliased to the same name (or if two
  * columns with the same underlying name are selected, both _without_ aliases),
  * only the latter of two will be used in the query.
- *
  * @example
  * This example shows a query that selects two Cells, one from a joined Table.
  * Both are aliased with the 'as' function:
@@ -710,7 +680,7 @@ export type Select = {
  * // -> {cujo: {petSpecies: 'dog', ownerName: 'Carol'}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type SelectedAs = {
   /**
@@ -740,7 +710,6 @@ export type SelectedAs = {
  * unfiltered query will only ever return the same number of Rows as the main
  * Table being queried, and indeed the resulting table (assuming it has not been
  * aggregated) will even preserve the root Table's original Row Ids.
- *
  * @example
  * This example shows a query that joins a single Table by using an Id present
  * in the main query Table.
@@ -883,14 +852,13 @@ export type SelectedAs = {
  * // -> {cujo: {description: 'dog in Washington'}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type Join = {
   /**
    * Calling this function with two Id parameters will indicate that the join to
    * a Row in an adjacent Table is made by finding its Id in a Cell of the
    * query's root Table.
-   *
    * @param joinedTableId The Id of the Table to join to.
    * @param on The Id of the Cell in the root Table that contains the joined
    * Table's Row Id.
@@ -902,7 +870,6 @@ export type Join = {
    * Calling this function with two parameters (where the second is a function)
    * will indicate that the join to a Row in an adjacent Table is made by
    * calculating its Id from the Cells and the Row Id of the query's root Table.
-   *
    * @param joinedTableId The Id of the Table to join to.
    * @param on A callback that takes a GetCell function and the root Table's Row
    * Id. These can be used to programmatically calculate the joined Table's Row
@@ -918,7 +885,6 @@ export type Join = {
    * Calling this function with three Id parameters will indicate that the join
    * to a Row in distant Table is made by finding its Id in a Cell of an
    * intermediately joined Table.
-   *
    * @param joinedTableId The Id of the distant Table to join to.
    * @param fromIntermediateJoinedTableId The Id of an intermediate Table (which
    * should have been in turn joined to the main query table via other Join
@@ -934,7 +900,6 @@ export type Join = {
    * will indicate that the join to a Row in distant Table is made by
    * calculating its Id from the Cells and the Row Id of an intermediately
    * joined Table.
-   *
    * @param joinedTableId The Id of the Table to join to.
    * @param fromIntermediateJoinedTableId The Id of an intermediate Table (which
    * should have been in turn joined to the main query table via other Join
@@ -965,7 +930,6 @@ export type Join = {
  *
  * For the purposes of clarity, it's recommended to use an alias that does not
  * collide with a real underlying Table (whether included in the query or not).
- *
  * @example
  * This example shows a query that joins the same underlying Table twice, for
  * different purposes. Both joins are aliased with the 'as' function to
@@ -1001,7 +965,7 @@ export type Join = {
  * // -> {cujo: {buyer: 'Carol', seller: 'Alice'}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type JoinedAs = {
   /**
@@ -1029,7 +993,6 @@ export type JoinedAs = {
  * describes conditions that should be met by underlying Cell values (whether
  * selected or not), and the latter describes conditions based on calculated and
  * aggregated values - after Group clauses have been applied.
- *
  * @example
  * This example shows a query that filters the results from a single Table by
  * comparing an underlying Cell from it with a value.
@@ -1124,14 +1087,13 @@ export type JoinedAs = {
  * // -> {cujo: {species: 'dog', state: 'WA'}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type Where = {
   /**
    * Calling this function with two parameters is used to include only those
    * Rows for which a specified Cell in the query's root Table has a specified
    * value.
-   *
    * @param cellId The Id of the Cell in the query's root Table to test.
    * @param equals The value that the Cell has to have for the Row to be
    * included in the result.
@@ -1140,7 +1102,6 @@ export type Where = {
   /**
    * Calling this function with three parameters is used to include only those
    * Rows for which a specified Cell in a joined Table has a specified value.
-   *
    * @param joinedTableId The Id of the joined Table to test a value in. If the
    * underlying Table was joined 'as' a different Id, that should instead be
    * used.
@@ -1153,7 +1114,6 @@ export type Where = {
    * Calling this function with one callback parameter is used to include only
    * those Rows which meet a calculated boolean condition, based on values in
    * the main and (optionally) joined Tables.
-   *
    * @param condition A callback that takes a GetTableCell function and that
    * should return `true` for the Row to be included in the result.
    */
@@ -1190,7 +1150,6 @@ export type Where = {
  * function's algorithmic complexity by providing shortcuts that can nudge an
  * aggregation result when a single value is added, removed, or replaced in the
  * input values.
- *
  * @param selectedCellId The Id of the Cell to aggregate. If the underlying Cell
  * was selected 'as' a different Id, that should instead be used.
  * @param aggregate Either a string representing one of a set of common
@@ -1330,7 +1289,7 @@ export type Where = {
  * // Both have a parrot at 3. Alice's worm at 1 is excluded from aggregation.
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type Group = (
   selectedCellId: Id,
@@ -1347,7 +1306,6 @@ export type Group = (
  * Note that if two Group clauses are both aliased to the same name (or if you
  * create two groups of the same underlying Cell, both _without_ aliases), only
  * the latter of two will be used in the query.
- *
  * @example
  * This example shows a query that groups the same underlying Cell twice, for
  * different purposes. Both groups are aliased with the 'as' function to
@@ -1376,7 +1334,7 @@ export type Group = (
  * // -> {1: {species: 'cat', minPrice: 3, maxPrice: 4}}
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type GroupedAs = {
   /**
@@ -1406,7 +1364,6 @@ export type GroupedAs = {
  * have not been grouped with a Group clause, you should expect it to be less
  * performant than using a Where clause, due to that being applied earlier in
  * the query process.
- *
  * @example
  * This example shows a query that filters the results from a grouped Table by
  * comparing a Cell from it with a value.
@@ -1471,14 +1428,13 @@ export type GroupedAs = {
  * // Parrots are filtered out because they have zero range in price.
  * ```
  * @category Definition
- * @since v2.0
+ * @since v2.0.0
  */
 export type Having = {
   /**
    * Calling this function with two parameters is used to include only those
    * Rows for which a specified Cell in the query's root Table has a specified
    * value.
-   *
    * @param selectedOrGroupedCellId The Id of the Cell in the query to test.
    * @param equals The value that the Cell has to have for the Row to be
    * included in the result.
@@ -1487,7 +1443,6 @@ export type Having = {
   /**
    * Calling this function with one callback parameter is used to include only
    * those Rows which meet a calculated boolean condition.
-   *
    * @param condition A callback that takes a GetCell function and that should
    * return `true` for the Row to be included in the result.
    */
@@ -1513,7 +1468,6 @@ export type Having = {
  * getResultCell method, and so on), and add listeners for when they change
  * (with the addResultTableListener method, the addResultRowListener method, the
  * addResultCellListener method, and so on).
- *
  * @example
  * This example shows a very simple lifecycle of a Queries object: from
  * creation, to adding definitions, getting their contents, and then registering
@@ -1589,7 +1543,7 @@ export type Having = {
  * @see Car Analysis demo
  * @see Movie Database demo
  * @category Queries
- * @since v2.0
+ * @since v2.0.0
  */
 export interface Queries {
   //
@@ -1626,7 +1580,6 @@ export interface Queries {
    *
    * Additionally, you can use the getResultSortedRowIds method and
    * addResultSortedRowIdsListener method to sort and paginate the results.
-   *
    * @param queryId The Id of the query to define.
    * @param tableId The Id of the root Table the query will be based on.
    * @param query A callback which can take a `keywords` object and which uses
@@ -1654,7 +1607,7 @@ export interface Queries {
    * // -> {fido: {color: 'brown'}, cujo: {color: 'black'}}
    * ```
    * @category Configuration
-   * @since v2.0
+   * @since v2.0.0
    */
   setQueryDefinition(
     queryId: Id,
@@ -1670,7 +1623,6 @@ export interface Queries {
 
   /**
    * The delQueryDefinition method removes an existing query definition.
-   *
    * @param queryId The Id of the query to remove.
    * @returns A reference to the Queries object.
    * @example
@@ -1697,14 +1649,13 @@ export interface Queries {
    * // -> []
    * ```
    * @category Configuration
-   * @since v2.0
+   * @since v2.0.0
    */
   delQueryDefinition(queryId: Id): Queries;
 
   /**
    * The getStore method returns a reference to the underlying Store that is
    * backing this Queries object.
-   *
    * @returns A reference to the Store.
    * @example
    * This example creates a Queries object against a newly-created Store and
@@ -1723,14 +1674,13 @@ export interface Queries {
    * // -> {fido: {color: 'brown'}}
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   getStore(): Store;
 
   /**
    * The getQueryIds method returns an array of the query Ids registered with
    * this Queries object.
-   *
    * @returns An array of Ids.
    * @example
    * This example creates a Queries object with two definitions, and then gets
@@ -1751,7 +1701,7 @@ export interface Queries {
    * // -> ['dogColors', 'catColors']
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   getQueryIds(): Ids;
 
@@ -1762,7 +1712,6 @@ export interface Queries {
    * This method is useful for iterating over all the queries in a functional
    * style. The `queryCallback` parameter is a QueryCallback function that will
    * be called with the Id of each query.
-   *
    * @param queryCallback The function that should be called for every query.
    * @example
    * This example iterates over each query in a Queries object.
@@ -1785,14 +1734,13 @@ export interface Queries {
    * // -> 'catColors'
    * ```
    * @category Iterator
-   * @since v2.0
+   * @since v2.0.0
    */
   forEachQuery(queryCallback: QueryCallback): void;
 
   /**
    * The hasQuery method returns a boolean indicating whether a given query
    * exists in the Queries object.
-   *
    * @param queryId The Id of a possible query in the Queries object.
    * @returns Whether a query with that Id exists.
    * @example
@@ -1814,7 +1762,7 @@ export interface Queries {
    * // -> false
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   hasQuery(queryId: Id): boolean;
 
@@ -1823,7 +1771,6 @@ export interface Queries {
    * backing a query.
    *
    * If the query Id is invalid, the method returns `undefined`.
-   *
    * @param queryId The Id of a query.
    * @returns The Id of the Table backing the query, or `undefined`.
    * @example
@@ -1847,7 +1794,7 @@ export interface Queries {
    * // -> undefined
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   getTableId(queryId: Id): Id | undefined;
 
@@ -1860,7 +1807,6 @@ export interface Queries {
    * returns a copy of, rather than a reference to the underlying data, so
    * changes made to the returned object are not made to the query results
    * themselves.
-   *
    * @param queryId The Id of a query.
    * @returns An object containing the entire data of the ResultTable of the
    * query.
@@ -1893,7 +1839,7 @@ export interface Queries {
    * // -> {}
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultTable(queryId: Id): ResultTable;
 
@@ -1905,7 +1851,6 @@ export interface Queries {
    * the query Id is invalid, the method returns an empty array. Similarly, it
    * returns a copy of, rather than a reference to the list of Ids, so changes
    * made to the list object are not made to the query results themselves.
-   *
    * @param queryId The Id of a query.
    * @returns An array of the Ids of every ResultRow in the result of the query.
    * @example
@@ -1936,7 +1881,7 @@ export interface Queries {
    * // -> []
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultRowIds(queryId: Id): Ids;
 
@@ -1957,7 +1902,6 @@ export interface Queries {
    * results yourself, especially when the ResultTable is large. For a
    * performant approach to tracking the sorted ResultRow Ids when they change,
    * use the addResultSortedRowIdsListener method.
-   *
    * @param queryId The Id of a query.
    * @param cellId The Id of the ResultCell whose values are used for the
    * sorting, or `undefined` to by sort the ResultRow Id itself.
@@ -1996,7 +1940,7 @@ export interface Queries {
    * // -> []
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultSortedRowIds(
     queryId: Id,
@@ -2015,7 +1959,6 @@ export interface Queries {
    * Similarly, it returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the query
    * results themselves.
-   *
    * @param queryId The Id of a query.
    * @param rowId The Id of the ResultRow in the ResultTable.
    * @returns An object containing the entire data of the ResultRow in the
@@ -2048,7 +1991,7 @@ export interface Queries {
    * // -> {}
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultRow(queryId: Id, rowId: Id): ResultRow;
 
@@ -2061,7 +2004,6 @@ export interface Queries {
    * Similarly, it returns a copy of, rather than a reference to the list of
    * Ids, so changes made to the list object are not made to the query results
    * themselves.
-   *
    * @param queryId The Id of a query.
    * @param rowId The Id of the ResultRow in the ResultTable.
    * @returns An array of the Ids of every ResultCell in the ResultRow in the
@@ -2094,7 +2036,7 @@ export interface Queries {
    * // -> []
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultCellIds(queryId: Id, rowId: Id): Ids;
 
@@ -2105,7 +2047,6 @@ export interface Queries {
    * This has the same behavior as a Store's getCell method. For example, if the
    * query, or ResultRow, or ResultCell Id is invalid, the method returns
    * `undefined`.
-   *
    * @param queryId The Id of a query.
    * @param rowId The Id of the ResultRow in the ResultTable.
    * @param cellId The Id of the ResultCell in the ResultRow.
@@ -2138,14 +2079,13 @@ export interface Queries {
    * // -> undefined
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   getResultCell(queryId: Id, rowId: Id, cellId: Id): ResultCellOrUndefined;
 
   /**
    * The hasResultTable method returns a boolean indicating whether a given
    * ResultTable exists.
-   *
    * @param queryId The Id of a possible query.
    * @returns Whether a ResultTable for that query Id exists.
    * @example
@@ -2173,14 +2113,13 @@ export interface Queries {
    * // -> false
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   hasResultTable(queryId: Id): boolean;
 
   /**
    * The hasResultRow method returns a boolean indicating whether a given
    * ResultRow exists.
-   *
    * @param queryId The Id of a possible query.
    * @param rowId The Id of a possible ResultRow.
    * @returns Whether a ResultRow for that Id exists.
@@ -2209,14 +2148,13 @@ export interface Queries {
    * // -> false
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   hasResultRow(queryId: Id, rowId: Id): boolean;
 
   /**
    * The hasResultCell method returns a boolean indicating whether a given
    * ResultCell exists.
-   *
    * @param queryId The Id of a possible query.
    * @param rowId The Id of a possible ResultRow.
    * @param cellId The Id of a possible ResultCell.
@@ -2246,7 +2184,7 @@ export interface Queries {
    * // -> false
    * ```
    * @category Result
-   * @since v2.0
+   * @since v2.0.0
    */
   hasResultCell(queryId: Id, rowId: Id, cellId: Id): boolean;
 
@@ -2259,7 +2197,6 @@ export interface Queries {
    * ResultTableCallback function that will be called with the Id of each
    * ResultTable, and with a function that can then be used to iterate over each
    * ResultRow of the ResultTable, should you wish.
-   *
    * @param tableCallback The function that should be called for every query's
    * ResultTable.
    * @example
@@ -2293,7 +2230,7 @@ export interface Queries {
    * // -> '- felix'
    * ```
    * @category Iterator
-   * @since v2.0
+   * @since v2.0.0
    */
   forEachResultTable(tableCallback: ResultTableCallback): void;
 
@@ -2306,7 +2243,6 @@ export interface Queries {
    * ResultRowCallback function that will be called with the Id of each
    * ResultRow, and with a function that can then be used to iterate over each
    * ResultCell of the ResultRow, should you wish.
-   *
    * @param queryId The Id of a query.
    * @param rowCallback The function that should be called for every ResultRow
    * of the query's ResultTable.
@@ -2339,7 +2275,7 @@ export interface Queries {
    * // -> '- color'
    * ```
    * @category Iterator
-   * @since v2.0
+   * @since v2.0.0
    */
   forEachResultRow(queryId: Id, rowCallback: ResultRowCallback): void;
 
@@ -2351,7 +2287,6 @@ export interface Queries {
    * of the query in a functional style. The `cellCallback` parameter is a
    * ResultCellCallback function that will be called with the Id and value of
    * each ResultCell.
-   *
    * @param queryId The Id of a query.
    * @param rowId The Id of a ResultRow in the query's ResultTable.
    * @param cellCallback The function that should be called for every ResultCell
@@ -2383,7 +2318,7 @@ export interface Queries {
    * // -> 'color: brown'
    * ```
    * @category Iterator
-   * @since v2.0
+   * @since v2.0.0
    */
   forEachResultCell(
     queryId: Id,
@@ -2403,7 +2338,6 @@ export interface Queries {
    * You can either listen to a single ResultTable (by specifying a query Id as
    * the method's first parameter) or changes to any ResultTable (by providing a
    * `null` wildcard).
-   *
    * @param queryId The Id of the query to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
    * matching ResultTable changes.
@@ -2478,7 +2412,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultTableListener(queryId: IdOrNull, listener: ResultTableListener): Id;
 
@@ -2498,7 +2432,6 @@ export interface Queries {
    * You can either listen to a single ResultTable (by specifying a query Id as
    * the method's first parameter) or changes to any ResultTable (by providing a
    * `null` wildcard).
-   *
    * @param queryId The Id of the query to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the ResultRow Ids
    * in the ResultTable change.
@@ -2573,7 +2506,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultRowIdsListener(
     queryId: IdOrNull,
@@ -2606,7 +2539,6 @@ export interface Queries {
    * should be in descending order. The `offset` and `limit` parameters are used
    * to paginate results, but default to `0` and `undefined` to return all
    * available ResultRow Ids if not specified.
-   *
    * @param queryId The Id of the query to listen to.
    * @param cellId The Id of the ResultCell whose values are used for the
    * sorting, or `undefined` to by sort the ResultRow Id itself.
@@ -2700,7 +2632,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultSortedRowIdsListener(
     queryId: Id,
@@ -2728,7 +2660,6 @@ export interface Queries {
    * wildcarded with `null`. You can listen to a specific ResultRow in a
    * specific query, any ResultRow in a specific query, a specific ResultRow in
    * any query, or any ResultRow in any query.
-   *
    * @param queryId The Id of the query to listen to, or `null` as a wildcard.
    * @param rowId The Id of the ResultRow to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
@@ -2806,7 +2737,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultRowListener(
     queryId: IdOrNull,
@@ -2835,7 +2766,6 @@ export interface Queries {
    * wildcarded with `null`. You can listen to a specific ResultRow in a
    * specific query, any ResultRow in a specific query, a specific ResultRow in
    * any query, or any ResultRow in any query.
-   *
    * @param queryId The Id of the query to listen to, or `null` as a wildcard.
    * @param rowId The Id of the ResultRow to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the ResultCell
@@ -2918,7 +2848,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultCellIdsListener(
     queryId: IdOrNull,
@@ -2945,7 +2875,6 @@ export interface Queries {
    * be wildcarded with `null`. You can listen to a specific ResultCell in a
    * specific ResultRow in a specific query, any ResultCell in any ResultRow in
    * any query, for example - or every other combination of wildcards.
-   *
    * @param queryId The Id of the query to listen to, or `null` as a wildcard.
    * @param rowId The Id of the ResultRow to listen to, or `null` as a wildcard.
    * @param cellId The Id of the ResultCell to listen to, or `null` as a
@@ -3034,7 +2963,7 @@ export interface Queries {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addResultCellListener(
     queryId: IdOrNull,
@@ -3049,7 +2978,6 @@ export interface Queries {
    *
    * Use the Id returned by the addMetricListener method. Note that the Queries
    * object 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 Queries object.
    * @example
@@ -3085,7 +3013,7 @@ export interface Queries {
    * // The listener is not called.
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   delListener(listenerId: Id): Queries;
 
@@ -3095,7 +3023,6 @@ export interface Queries {
    *
    * This guarantees that all of the listeners that the object registered with
    * the underlying Store are removed and it can be correctly garbage collected.
-   *
    * @example
    * This example creates a Store, adds a Queries object with a definition (that
    * registers a RowListener with the underlying Store), and then destroys it
@@ -3121,7 +3048,7 @@ export interface Queries {
    * // -> 0
    * ```
    * @category Lifecycle
-   * @since v2.0
+   * @since v2.0.0
    */
   destroy(): void;
 
@@ -3134,7 +3061,6 @@ export interface Queries {
    * 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 QueriesListenerStats object containing Queries listener
    * statistics.
    * @example
@@ -3151,7 +3077,7 @@ export interface Queries {
    * // -> 0
    * ```
    * @category Development
-   * @since v2.0
+   * @since v2.0.0
    */
   getListenerStats(): QueriesListenerStats;
   //
@@ -3164,7 +3090,6 @@ export interface Queries {
  * A given Store can only have one Queries object associated with it. If you
  * call this function twice on the same Store, your second call will return a
  * reference to the Queries object created by the first.
- *
  * @param store The Store for which to register query definitions.
  * @returns A reference to the new Queries object.
  * @example
@@ -3188,6 +3113,6 @@ export interface Queries {
  * // -> true
  * ```
  * @category Creation
- * @since v2.0
+ * @since v2.0.0
  */
 export function createQueries(store: Store): Queries;