tinybase 9.0.0 → 9.1.0-beta.1

package/@types/ui-react-inspector/with-schemas/index.d.ts

@@ -46,7 +46,7 @@ export type InspectorProps = {
  *
  * See the <Inspector /> (React) demo for this component in action:
  *
- * ![Inspector example](https://tinybase.org/shots/inspector-react-demo.png
+ * ![Inspector example](https://beta.tinybase.org/shots/inspector-react-demo.png
  * "Inspector example")
  *
  * The component displays a nub in the corner of the screen which you may then

package/@types/ui-solid/index.d.ts

@@ -38,6 +38,7 @@ import type {
   IdOrNull,
   Ids,
   ParameterizedCallback,
+  Sorter,
 } from '../common/index.d.ts';
 import type {
   Indexes,
@@ -1418,6 +1419,8 @@ export function useRowIds(
  * @param descending Whether the sorting should be in descending order.
  * @param offset The number of Row Ids to skip for pagination purposes, if any.
  * @param limit The maximum number of Row Ids to return, or `undefined` for all.
+ * @param sorter A custom function for comparing the sorting values, or
+ * `undefined` to use the default alphanumeric sorting.
  * @param storeOrStoreId The Store to be accessed: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -1441,6 +1444,7 @@ export function useRowIds(
  *     false,
  *     0,
  *     undefined,
+ *     undefined,
  *     store,
  *   );
  *   console.log(JSON.stringify(rowIds()));
@@ -1457,6 +1461,7 @@ export function useSortedRowIds(
   descending?: MaybeAccessor<boolean | undefined>,
   offset?: MaybeAccessor<number | undefined>,
   limit?: MaybeAccessor<number | undefined>,
+  sorter?: Sorter,
   storeOrStoreId?: MaybeAccessor<StoreOrStoreId | undefined>,
 ): Accessor<Ids>;
 
@@ -1464,7 +1469,8 @@ export function useSortedRowIds(
  * When called with an object as the first argument, the useSortedRowIds method
  * destructures it to make it easier to skip optional parameters.
  * @param args A SortedRowIdsArgs object containing the Id of the Table in the
- * Store, and optional `cellId`, `descending`, `offset`, and `limit` parameters.
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
  * @param storeOrStoreId The Store to be accessed: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4517,7 +4523,8 @@ export function useSortedRowIdsListener(
  * When called with an object as the first argument, the useSortedRowIds method
  * destructures it to make it easier to skip optional parameters.
  * @param args A SortedRowIdsArgs object containing the Id of the Table in the
- * Store, and optional `cellId`, `descending`, `offset`, and `limit` parameters.
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
  * @param listener The function that will be called whenever the sorted Row Ids
  * in the Table change.
  * @param mutator An optional boolean that indicates that the listener mutates

package/@types/ui-solid/with-schemas/index.d.ts

@@ -84,6 +84,7 @@ import type {
   IdOrNull,
   Ids,
   ParameterizedCallback,
+  Sorter,
 } from '../../common/with-schemas/index.d.ts';
 import type {
   Indexes,
@@ -1635,6 +1636,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *   descending?: MaybeAccessor<boolean | undefined>,
  *   offset?: MaybeAccessor<number | undefined>,
  *   limit?: MaybeAccessor<number | undefined>,
+ *   sorter?: Sorter,
  *   storeOrStoreId?: MaybeAccessor<StoreOrStoreId | undefined>,
  * ): Accessor<Ids>;
  * ```
@@ -1654,6 +1656,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param descending Whether the sorting should be in descending order.
  * @param offset The number of Row Ids to skip for pagination purposes, if any.
  * @param limit The maximum number of Row Ids to return, or `undefined` for all.
+ * @param sorter A custom function for comparing the sorting values, or
+ * `undefined` to use the default alphanumeric sorting.
  * @param storeOrStoreId The Store to be accessed: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -1677,6 +1681,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *     false,
  *     0,
  *     undefined,
+ *     undefined,
  *     store,
  *   );
  *   console.log(JSON.stringify(rowIds()));
@@ -1697,6 +1702,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
       descending?: MaybeAccessor<boolean | undefined>,
       offset?: MaybeAccessor<number | undefined>,
       limit?: MaybeAccessor<number | undefined>,
+      sorter?: Sorter,
       storeOrStoreId?: MaybeAccessor<StoreOrStoreId<Schemas> | undefined>,
     ): Accessor<Ids>;
 
@@ -1704,7 +1710,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * When called with an object as the first argument, the useSortedRowIds method
  * destructures it to make it easier to skip optional parameters.
  * @param args A SortedRowIdsArgs object containing the Id of the Table in the
- * Store, and optional `cellId`, `descending`, `offset`, and `limit` parameters.
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
  * @param storeOrStoreId The Store to be accessed: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -5274,7 +5281,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * When called with an object as the first argument, the useSortedRowIds method
  * destructures it to make it easier to skip optional parameters.
  * @param args A SortedRowIdsArgs object containing the Id of the Table in the
- * Store, and optional `cellId`, `descending`, `offset`, and `limit` parameters.
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
  * @param listener The function that will be called whenever the sorted Row Ids
  * in the Table change.
  * @param mutator An optional boolean that indicates that the listener mutates

package/@types/ui-solid-dom/index.d.ts

@@ -692,7 +692,7 @@ export type SortedTablePaginatorProps = {
  *
  * See the <TableInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![TableInHtmlTable example](https://tinybase.org/shots/tableinhtmltable-solid-demo.png
+ * ![TableInHtmlTable example](https://beta.tinybase.org/shots/tableinhtmltable-solid-demo.png
  * "TableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -836,7 +836,7 @@ export function TableInHtmlTable(
  * See the <SortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![SortedTableInHtmlTable example](https://tinybase.org/shots/sortedtableinhtmltable-solid-demo.png
+ * ![SortedTableInHtmlTable example](https://beta.tinybase.org/shots/sortedtableinhtmltable-solid-demo.png
  * "SortedTableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -1007,7 +1007,7 @@ export function SortedTableInHtmlTable(
  *
  * See the <ValuesInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![ValuesInHtmlTable example](https://tinybase.org/shots/valuesinhtmltable-solid-demo.png
+ * ![ValuesInHtmlTable example](https://beta.tinybase.org/shots/valuesinhtmltable-solid-demo.png
  * "ValuesInHtmlTable example")
  *
  * The component's props identify which Row to render based on Table Id, Row Id,
@@ -1136,7 +1136,7 @@ export function ValuesInHtmlTable(
  *
  * See the <SliceInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![SliceInHtmlTable example](https://tinybase.org/shots/sliceinhtmltable-solid-demo.png
+ * ![SliceInHtmlTable example](https://beta.tinybase.org/shots/sliceinhtmltable-solid-demo.png
  * "SliceInHtmlTable example")
  *
  * The component's props identify which Slice to render based on Index Id, Slice
@@ -1292,7 +1292,7 @@ export function SliceInHtmlTable(
  * See the <RelationshipInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![RelationshipInHtmlTable example](https://tinybase.org/shots/relationshipinhtmltable-solid-demo.png
+ * ![RelationshipInHtmlTable example](https://beta.tinybase.org/shots/relationshipinhtmltable-solid-demo.png
  * "RelationshipInHtmlTable example")
  *
  * The component's props identify which Relationship to render based on
@@ -1466,7 +1466,7 @@ export function RelationshipInHtmlTable(
  * See the <ResultTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![ResultTableInHtmlTable example](https://tinybase.org/shots/resulttableinhtmltable-solid-demo.png
+ * ![ResultTableInHtmlTable example](https://beta.tinybase.org/shots/resulttableinhtmltable-solid-demo.png
  * "ResultTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1617,7 +1617,7 @@ export function ResultTableInHtmlTable(
  * See the <ResultSortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![ResultSortedTableInHtmlTable example](https://tinybase.org/shots/resultsortedtableinhtmltable-solid-demo.png
+ * ![ResultSortedTableInHtmlTable example](https://beta.tinybase.org/shots/resultsortedtableinhtmltable-solid-demo.png
  * "ResultSortedTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1789,7 +1789,7 @@ export function ResultSortedTableInHtmlTable(
  *
  * See the <EditableCellView /> (Solid) demo for this component in action:
  *
- * ![EditableCellView example](https://tinybase.org/shots/editablecellview-solid-demo.png
+ * ![EditableCellView example](https://beta.tinybase.org/shots/editablecellview-solid-demo.png
  * "EditableCellView example")
  *
  * The component's props identify which Cell to render based on Table Id, Row
@@ -1859,7 +1859,7 @@ export function EditableCellView(
  *
  * See the <EditableValueView /> (Solid) demo for this component in action:
  *
- * ![EditableValueView example](https://tinybase.org/shots/editablevalueview-solid-demo.png
+ * ![EditableValueView example](https://beta.tinybase.org/shots/editablevalueview-solid-demo.png
  * "EditableValueView example")
  *
  * The component's props identify which Value to render based on Table Id, Row
@@ -1929,7 +1929,7 @@ export function EditableValueView(
  * See the <SortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![SortedTablePaginator example](https://tinybase.org/shots/sortedtablepaginator-solid-demo.png
+ * ![SortedTablePaginator example](https://beta.tinybase.org/shots/sortedtablepaginator-solid-demo.png
  * "SortedTablePaginator example")
  *
  * The component displays 'previous' and 'next' buttons for paging through the

package/@types/ui-solid-dom/with-schemas/index.d.ts

@@ -666,7 +666,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <TableInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![TableInHtmlTable example](https://tinybase.org/shots/tableinhtmltable-solid-demo.png
+ * ![TableInHtmlTable example](https://beta.tinybase.org/shots/tableinhtmltable-solid-demo.png
  * "TableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -818,7 +818,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![SortedTableInHtmlTable example](https://tinybase.org/shots/sortedtableinhtmltable-solid-demo.png
+ * ![SortedTableInHtmlTable example](https://beta.tinybase.org/shots/sortedtableinhtmltable-solid-demo.png
  * "SortedTableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -997,7 +997,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <ValuesInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![ValuesInHtmlTable example](https://tinybase.org/shots/valuesinhtmltable-solid-demo.png
+ * ![ValuesInHtmlTable example](https://beta.tinybase.org/shots/valuesinhtmltable-solid-demo.png
  * "ValuesInHtmlTable example")
  *
  * The component's props identify which Row to render based on Table Id, Row Id,
@@ -1134,7 +1134,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <SliceInHtmlTable /> (Solid) demo for this component in action:
  *
- * ![SliceInHtmlTable example](https://tinybase.org/shots/sliceinhtmltable-solid-demo.png
+ * ![SliceInHtmlTable example](https://beta.tinybase.org/shots/sliceinhtmltable-solid-demo.png
  * "SliceInHtmlTable example")
  *
  * The component's props identify which Slice to render based on Index Id, Slice
@@ -1298,7 +1298,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <RelationshipInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![RelationshipInHtmlTable example](https://tinybase.org/shots/relationshipinhtmltable-solid-demo.png
+ * ![RelationshipInHtmlTable example](https://beta.tinybase.org/shots/relationshipinhtmltable-solid-demo.png
  * "RelationshipInHtmlTable example")
  *
  * The component's props identify which Relationship to render based on
@@ -1480,7 +1480,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![ResultTableInHtmlTable example](https://tinybase.org/shots/resulttableinhtmltable-solid-demo.png
+ * ![ResultTableInHtmlTable example](https://beta.tinybase.org/shots/resulttableinhtmltable-solid-demo.png
  * "ResultTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1639,7 +1639,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultSortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![ResultSortedTableInHtmlTable example](https://tinybase.org/shots/resultsortedtableinhtmltable-solid-demo.png
+ * ![ResultSortedTableInHtmlTable example](https://beta.tinybase.org/shots/resultsortedtableinhtmltable-solid-demo.png
  * "ResultSortedTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1819,7 +1819,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableCellView /> (Solid) demo for this component in action:
  *
- * ![EditableCellView example](https://tinybase.org/shots/editablecellview-solid-demo.png
+ * ![EditableCellView example](https://beta.tinybase.org/shots/editablecellview-solid-demo.png
  * "EditableCellView example")
  *
  * The component's props identify which Cell to render based on Table Id, Row
@@ -1903,7 +1903,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableValueView /> (Solid) demo for this component in action:
  *
- * ![EditableValueView example](https://tinybase.org/shots/editablevalueview-solid-demo.png
+ * ![EditableValueView example](https://beta.tinybase.org/shots/editablevalueview-solid-demo.png
  * "EditableValueView example")
  *
  * The component's props identify which Value to render based on Table Id, Row
@@ -1973,7 +1973,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (Solid) demo for this component in
  * action:
  *
- * ![SortedTablePaginator example](https://tinybase.org/shots/sortedtablepaginator-solid-demo.png
+ * ![SortedTablePaginator example](https://beta.tinybase.org/shots/sortedtablepaginator-solid-demo.png
  * "SortedTablePaginator example")
  *
  * The component displays 'previous' and 'next' buttons for paging through the

package/@types/ui-solid-inspector/index.d.ts

@@ -46,7 +46,7 @@ export type InspectorProps = {
  *
  * See the <Inspector /> (Solid) demo for this component in action:
  *
- * ![Inspector example](https://tinybase.org/shots/inspector-solid-demo.png
+ * ![Inspector example](https://beta.tinybase.org/shots/inspector-solid-demo.png
  * "Inspector example")
  *
  * The component displays a nub in the corner of the screen which you may then

package/@types/ui-solid-inspector/with-schemas/index.d.ts

@@ -46,7 +46,7 @@ export type InspectorProps = {
  *
  * See the <Inspector /> (Solid) demo for this component in action:
  *
- * ![Inspector example](https://tinybase.org/shots/inspector-solid-demo.png
+ * ![Inspector example](https://beta.tinybase.org/shots/inspector-solid-demo.png
  * "Inspector example")
  *
  * The component displays a nub in the corner of the screen which you may then

package/@types/ui-svelte/index.d.ts

@@ -35,7 +35,7 @@ import type {
   CheckpointListener,
   Checkpoints,
 } from '../checkpoints/index.d.ts';
-import type {Id, IdOrNull, Ids} from '../common/index.d.ts';
+import type {Id, IdOrNull, Ids, Sorter} from '../common/index.d.ts';
 import type {
   Indexes,
   SliceIdsListener,
@@ -82,6 +82,7 @@ import type {
   RowCountListener,
   RowIdsListener,
   RowListener,
+  SortedRowIdsArgs,
   SortedRowIdsListener,
   Store,
   Table,
@@ -2893,6 +2894,8 @@ export function getRowIds(
  * @param descending Whether to sort descending (or a getter returning it).
  * @param offset The starting Row offset (or a getter returning it).
  * @param limit The maximum number of Rows to return (or a getter returning it).
+ * @param sorter A custom function for comparing the sorting values, or
+ * `undefined` to use the default alphanumeric sorting.
  * @param storeOrStoreId The Store to use (plain value or getter), or its Id.
  * @returns A reactive object with a `current` Ids property.
  * @example
@@ -2907,7 +2910,15 @@ export function getRowIds(
  *
  *   let {store} = $props();
  *
- *   const result = getSortedRowIds('pets', 'sold', false, 0, undefined, store);
+ *   const result = getSortedRowIds(
+ *     'pets',
+ *     'sold',
+ *     false,
+ *     0,
+ *     undefined,
+ *     undefined,
+ *     store,
+ *   );
  * </script>
  *
  * {JSON.stringify(result.current)}
@@ -2941,6 +2952,23 @@ export function getSortedRowIds(
   descending?: MaybeGetter<boolean>,
   offset?: MaybeGetter<number>,
   limit?: MaybeGetter<number | undefined>,
+  sorter?: Sorter,
+  storeOrStoreId?: MaybeGetter<StoreOrStoreId | undefined>,
+): {readonly current: Ids};
+
+/**
+ * When called with an object as the first argument, the getSortedRowIds
+ * function destructures it to make it easier to skip optional parameters.
+ * @param args A SortedRowIdsArgs object containing the Id of the Table in the
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
+ * @param storeOrStoreId The Store to use (plain value or getter), or its Id.
+ * @returns A reactive object with a `current` Ids property.
+ * @category Getter
+ * @since v9.1.0
+ */
+export function getSortedRowIds(
+  args: SortedRowIdsArgs,
   storeOrStoreId?: MaybeGetter<StoreOrStoreId | undefined>,
 ): {readonly current: Ids};
 
@@ -6936,6 +6964,26 @@ export function onSortedRowIds(
   storeOrStoreId?: MaybeGetter<StoreOrStoreId | undefined>,
 ): void;
 
+/**
+ * When called with an object as the first argument, the onSortedRowIds function
+ * destructures it to make it easier to skip optional parameters.
+ * @param args A SortedRowIdsArgs object containing the Id of the Table in the
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
+ * @param listener The function to call when sorted Row Ids change.
+ * @param mutator An optional boolean indicating the listener mutates Store
+ * data.
+ * @param storeOrStoreId The Store to use, or its Id.
+ * @category Listener
+ * @since v9.1.0
+ */
+export function onSortedRowIds(
+  args: SortedRowIdsArgs,
+  listener: SortedRowIdsListener,
+  mutator?: boolean,
+  storeOrStoreId?: MaybeGetter<StoreOrStoreId | undefined>,
+): void;
+
 /**
  * The onHasRow function registers a listener that is called whenever a
  * specified Row is added to or removed from a Table.

package/@types/ui-svelte/with-schemas/index.d.ts

@@ -23,7 +23,12 @@ import type {
   CheckpointListener,
   Checkpoints,
 } from '../../checkpoints/with-schemas/index.d.ts';
-import type {Id, IdOrNull, Ids} from '../../common/with-schemas/index.d.ts';
+import type {
+  Id,
+  IdOrNull,
+  Ids,
+  Sorter,
+} from '../../common/with-schemas/index.d.ts';
 import type {
   Indexes,
   SliceIdsListener,
@@ -77,6 +82,7 @@ import type {
   RowCountListener,
   RowIdsListener,
   RowListener,
+  SortedRowIdsArgs,
   SortedRowIdsListener,
   Store,
   Table,
@@ -3151,7 +3157,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
     storeOrStoreId?: StoreOrStoreId<Schemas>,
   ) => {readonly current: Ids};
 
-  /**
+  getSortedRowIds: {
+    /**
  * The getSortedRowIds function returns a reactive object reflecting the sorted
  * Row Ids in a Table, and registers a listener so that any changes will update
  * `current`.
@@ -3160,6 +3167,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param descending Whether to sort descending (or a getter returning it).
  * @param offset The starting Row offset (or a getter returning it).
  * @param limit The maximum number of Rows to return (or a getter returning it).
+ * @param sorter A custom function for comparing the sorting values, or
+ * `undefined` to use the default alphanumeric sorting.
  * @param storeOrStoreId The Store to use (plain value or getter), or its Id.
  * @returns A reactive object with a `current` Ids property.
  * @example
@@ -3175,6 +3184,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *   descending?: MaybeGetter<boolean>,
  *   offset?: MaybeGetter<number>,
  *   limit?: MaybeGetter<number | undefined>,
+ *   sorter?: Sorter,
  *   storeOrStoreId?: MaybeGetter<StoreOrStoreId | undefined>,
  * ): {readonly current: Ids};
  * ```
@@ -3187,7 +3197,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  *   let {store} = $props();
  *
- *   const result = getSortedRowIds('pets', 'sold', false, 0, undefined, store);
+ *   const result = getSortedRowIds(
+ *     'pets',
+ *     'sold',
+ *     false,
+ *     0,
+ *     undefined,
+ *     undefined,
+ *     store,
+ *   );
  * </script>
  *
  * {JSON.stringify(result.current)}
@@ -3215,14 +3233,32 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Getter
  * @since v8.1.0
  */
-  getSortedRowIds: <TableId extends TableIdFromSchema<Schemas[0]>>(
-    tableId: MaybeGetter<TableId>,
-    cellId?: MaybeGetter<CellIdFromSchema<Schemas[0], TableId> | undefined>,
-    descending?: MaybeGetter<boolean>,
-    offset?: MaybeGetter<number>,
-    limit?: MaybeGetter<number | undefined>,
-    storeOrStoreId?: StoreOrStoreId<Schemas>,
-  ) => {readonly current: Ids};
+    <TableId extends TableIdFromSchema<Schemas[0]>>(
+      tableId: MaybeGetter<TableId>,
+      cellId?: MaybeGetter<CellIdFromSchema<Schemas[0], TableId> | undefined>,
+      descending?: MaybeGetter<boolean>,
+      offset?: MaybeGetter<number>,
+      limit?: MaybeGetter<number | undefined>,
+      sorter?: Sorter,
+      storeOrStoreId?: StoreOrStoreId<Schemas>,
+    ): {readonly current: Ids};
+
+    /**
+ * When called with an object as the first argument, the getSortedRowIds
+ * function destructures it to make it easier to skip optional parameters.
+ * @param args A SortedRowIdsArgs object containing the Id of the Table in the
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
+ * @param storeOrStoreId The Store to use (plain value or getter), or its Id.
+ * @returns A reactive object with a `current` Ids property.
+ * @category Getter
+ * @since v9.1.0
+ */
+    <TableId extends TableIdFromSchema<Schemas[0]>>(
+      args: SortedRowIdsArgs<Schemas[0], TableId>,
+      storeOrStoreId?: StoreOrStoreId<Schemas>,
+    ): {readonly current: Ids};
+  };
 
   /**
  * The hasRow function returns a reactive object indicating whether a Row exists
@@ -7745,7 +7781,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
     storeOrStoreId?: StoreOrStoreId<Schemas>,
   ) => void;
 
-  /**
+  onSortedRowIds: {
+    /**
  * The onSortedRowIds function registers a listener that is called whenever the
  * sorted Row Ids in a Table change.
  * @param tableId The Id of the Table to listen to.
@@ -7818,19 +7855,45 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Listener
  * @since v8.1.0
  */
-  onSortedRowIds: <
-    TableId extends TableIdFromSchema<Schemas[0]>,
-    CellIdOrUndefined extends CellIdFromSchema<Schemas[0], TableId> | undefined,
-  >(
-    tableId: MaybeGetter<TableId>,
-    cellId: MaybeGetter<CellIdOrUndefined>,
-    descending: MaybeGetter<boolean>,
-    offset: MaybeGetter<number>,
-    limit: MaybeGetter<number | undefined>,
-    listener: SortedRowIdsListener<Schemas, TableId, CellIdOrUndefined>,
-    mutator?: boolean,
-    storeOrStoreId?: StoreOrStoreId<Schemas>,
-  ) => void;
+    <
+      TableId extends TableIdFromSchema<Schemas[0]>,
+      CellIdOrUndefined extends
+        CellIdFromSchema<Schemas[0], TableId> | undefined,
+    >(
+      tableId: MaybeGetter<TableId>,
+      cellId: MaybeGetter<CellIdOrUndefined>,
+      descending: MaybeGetter<boolean>,
+      offset: MaybeGetter<number>,
+      limit: MaybeGetter<number | undefined>,
+      listener: SortedRowIdsListener<Schemas, TableId, CellIdOrUndefined>,
+      mutator?: boolean,
+      storeOrStoreId?: StoreOrStoreId<Schemas>,
+    ): void;
+
+    /**
+ * When called with an object as the first argument, the onSortedRowIds function
+ * destructures it to make it easier to skip optional parameters.
+ * @param args A SortedRowIdsArgs object containing the Id of the Table in the
+ * Store, and optional `cellId`, `descending`, `offset`, `limit`, and `sorter`
+ * parameters.
+ * @param listener The function to call when sorted Row Ids change.
+ * @param mutator An optional boolean indicating the listener mutates Store
+ * data.
+ * @param storeOrStoreId The Store to use, or its Id.
+ * @category Listener
+ * @since v9.1.0
+ */
+    <
+      TableId extends TableIdFromSchema<Schemas[0]>,
+      CellIdOrUndefined extends
+        CellIdFromSchema<Schemas[0], TableId> | undefined,
+    >(
+      args: SortedRowIdsArgs<Schemas[0], TableId, CellIdOrUndefined>,
+      listener: SortedRowIdsListener<Schemas, TableId, CellIdOrUndefined>,
+      mutator?: boolean,
+      storeOrStoreId?: StoreOrStoreId<Schemas>,
+    ): void;
+  };
 
   /**
  * The onHasRow function registers a listener that is called whenever a