tinybase 8.1.0-beta.2 → 8.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/@types/ui-svelte/index.d.ts +268 -325
  2. package/@types/ui-svelte/with-schemas/index.d.ts +265 -322
  3. package/index.js +1 -1
  4. package/mergeable-store/index.js +1 -1
  5. package/mergeable-store/with-schemas/index.js +1 -1
  6. package/min/index.js +1 -1
  7. package/min/index.js.gz +0 -0
  8. package/min/mergeable-store/index.js +1 -1
  9. package/min/mergeable-store/index.js.gz +0 -0
  10. package/min/mergeable-store/with-schemas/index.js +1 -1
  11. package/min/mergeable-store/with-schemas/index.js.gz +0 -0
  12. package/min/omni/index.js +1 -1
  13. package/min/omni/index.js.gz +0 -0
  14. package/min/omni/with-schemas/index.js +1 -1
  15. package/min/omni/with-schemas/index.js.gz +0 -0
  16. package/min/persisters/persister-remote/index.js +1 -1
  17. package/min/persisters/persister-remote/index.js.gz +0 -0
  18. package/min/persisters/persister-remote/with-schemas/index.js +1 -1
  19. package/min/persisters/persister-remote/with-schemas/index.js.gz +0 -0
  20. package/min/queries/index.js +1 -1
  21. package/min/queries/index.js.gz +0 -0
  22. package/min/queries/with-schemas/index.js +1 -1
  23. package/min/queries/with-schemas/index.js.gz +0 -0
  24. package/min/store/index.js +1 -1
  25. package/min/store/index.js.gz +0 -0
  26. package/min/store/with-schemas/index.js +1 -1
  27. package/min/store/with-schemas/index.js.gz +0 -0
  28. package/min/ui-react/index.js +1 -1
  29. package/min/ui-react/index.js.gz +0 -0
  30. package/min/ui-react/with-schemas/index.js +1 -1
  31. package/min/ui-react/with-schemas/index.js.gz +0 -0
  32. package/min/ui-react-dom/index.js +1 -1
  33. package/min/ui-react-dom/index.js.gz +0 -0
  34. package/min/ui-react-dom/with-schemas/index.js +1 -1
  35. package/min/ui-react-dom/with-schemas/index.js.gz +0 -0
  36. package/min/ui-react-inspector/index.js +1 -1
  37. package/min/ui-react-inspector/index.js.gz +0 -0
  38. package/min/ui-react-inspector/with-schemas/index.js +1 -1
  39. package/min/ui-react-inspector/with-schemas/index.js.gz +0 -0
  40. package/min/with-schemas/index.js +1 -1
  41. package/min/with-schemas/index.js.gz +0 -0
  42. package/omni/index.js +5 -2
  43. package/omni/with-schemas/index.js +5 -2
  44. package/package.json +1 -1
  45. package/persisters/persister-remote/index.js +4 -1
  46. package/persisters/persister-remote/with-schemas/index.js +4 -1
  47. package/queries/index.js +1 -1
  48. package/queries/with-schemas/index.js +1 -1
  49. package/readme.md +3 -3
  50. package/releases.md +16 -5
  51. package/store/index.js +1 -1
  52. package/store/with-schemas/index.js +1 -1
  53. package/ui-react/index.js +7 -6
  54. package/ui-react/with-schemas/index.js +7 -6
  55. package/ui-react-dom/index.js +7 -6
  56. package/ui-react-dom/with-schemas/index.js +7 -6
  57. package/ui-react-inspector/index.js +29 -21
  58. package/ui-react-inspector/with-schemas/index.js +29 -21
  59. package/ui-svelte/index.js +1 -1
  60. package/ui-svelte/with-schemas/index.js +1 -1
  61. package/with-schemas/index.js +1 -1
@@ -109,8 +109,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
109
109
  MaybeGetter: <T>(t: T) => T | (() => T);
110
110
 
111
111
  /**
112
- * The StoreOrStoreId type is used when you need to refer to a Store in a
113
- * Svelte hook or component.
112
+ * The StoreOrStoreId type is used when you need to refer to a Store in a Svelte
113
+ * hook or component.
114
114
  *
115
115
  * This has schema-based typing. The following is a simplified representation:
116
116
  *
@@ -2457,8 +2457,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2457
2457
  /**
2458
2458
  * The useCheckpointsOrCheckpointsById hook is used to get a reference to a
2459
2459
  * Checkpoints object from a Provider context, or have it passed directly.
2460
- * @param checkpointsOrCheckpointsId The Checkpoints object, its Id, or a
2461
- * getter returning either.
2460
+ * @param checkpointsOrCheckpointsId The Checkpoints object, its Id, or a getter
2461
+ * returning either.
2462
2462
  * @returns A getter function returning the Checkpoints object, or `undefined`.
2463
2463
  * @category Hook
2464
2464
  * @since v8.1.0
@@ -2637,14 +2637,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2637
2637
  ) => {readonly current: Status};
2638
2638
 
2639
2639
  /**
2640
- * The useHasTablesListener hook registers a listener that is
2641
- * called whenever any Tables are added to or removed from the
2642
- * Store. The listener is tied to the component's `$effect`
2643
- * lifecycle and is removed when the component unmounts.
2644
- * @param listener The function to call when table presence
2645
- * changes.
2646
- * @param mutator An optional boolean indicating the listener
2647
- * mutates Store data.
2640
+ * The useHasTablesListener hook registers a listener that is called whenever
2641
+ * any Tables are added to or removed from the Store. The listener is tied to
2642
+ * the component's `$effect` lifecycle and is removed when the component
2643
+ * unmounts.
2644
+ * @param listener The function to call when table presence changes.
2645
+ * @param mutator An optional boolean indicating the listener mutates Store
2646
+ * data.
2648
2647
  * @param storeOrStoreId The Store to use, or its Id.
2649
2648
  * @category Hook
2650
2649
  * @since v8.1.0
@@ -2656,11 +2655,11 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2656
2655
  ) => void;
2657
2656
 
2658
2657
  /**
2659
- * The useTablesListener hook registers a listener that is
2660
- * called whenever tabular data in the Store changes.
2658
+ * The useTablesListener hook registers a listener that is called whenever
2659
+ * tabular data in the Store changes.
2661
2660
  * @param listener The function to call when Tables change.
2662
- * @param mutator An optional boolean indicating the listener
2663
- * mutates Store data.
2661
+ * @param mutator An optional boolean indicating the listener mutates Store
2662
+ * data.
2664
2663
  * @param storeOrStoreId The Store to use, or its Id.
2665
2664
  * @category Hook
2666
2665
  * @since v8.1.0
@@ -2672,11 +2671,11 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2672
2671
  ) => void;
2673
2672
 
2674
2673
  /**
2675
- * The useTableIdsListener hook registers a listener that is
2676
- * called whenever the set of Table Ids in the Store changes.
2674
+ * The useTableIdsListener hook registers a listener that is called whenever the
2675
+ * set of Table Ids in the Store changes.
2677
2676
  * @param listener The function to call when Table Ids change.
2678
- * @param mutator An optional boolean indicating the listener
2679
- * mutates Store data.
2677
+ * @param mutator An optional boolean indicating the listener mutates Store
2678
+ * data.
2680
2679
  * @param storeOrStoreId The Store to use, or its Id.
2681
2680
  * @category Hook
2682
2681
  * @since v8.1.0
@@ -2688,14 +2687,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2688
2687
  ) => void;
2689
2688
 
2690
2689
  /**
2691
- * The useHasTableListener hook registers a listener that is
2692
- * called whenever a specified Table is added to or removed
2693
- * from the Store.
2694
- * @param tableId The Id of the Table to listen to, or `null`
2695
- * to listen to any Table.
2690
+ * The useHasTableListener hook registers a listener that is called whenever a
2691
+ * specified Table is added to or removed from the Store.
2692
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2693
+ * Table.
2696
2694
  * @param listener The function to call when the Table changes.
2697
- * @param mutator An optional boolean indicating the listener
2698
- * mutates Store data.
2695
+ * @param mutator An optional boolean indicating the listener mutates Store
2696
+ * data.
2699
2697
  * @param storeOrStoreId The Store to use, or its Id.
2700
2698
  * @category Hook
2701
2699
  * @since v8.1.0
@@ -2710,13 +2708,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2710
2708
  ) => void;
2711
2709
 
2712
2710
  /**
2713
- * The useTableListener hook registers a listener that is
2714
- * called whenever data in a specified Table changes.
2715
- * @param tableId The Id of the Table to listen to, or `null`
2716
- * to listen to any Table.
2711
+ * The useTableListener hook registers a listener that is called whenever data
2712
+ * in a specified Table changes.
2713
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2714
+ * Table.
2717
2715
  * @param listener The function to call when the Table changes.
2718
- * @param mutator An optional boolean indicating the listener
2719
- * mutates Store data.
2716
+ * @param mutator An optional boolean indicating the listener mutates Store
2717
+ * data.
2720
2718
  * @param storeOrStoreId The Store to use, or its Id.
2721
2719
  * @category Hook
2722
2720
  * @since v8.1.0
@@ -2731,13 +2729,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2731
2729
  ) => void;
2732
2730
 
2733
2731
  /**
2734
- * The useTableCellIdsListener hook registers a listener that
2735
- * is called whenever the Cell Ids used across a Table change.
2736
- * @param tableId The Id of the Table to listen to, or `null`
2737
- * to listen to any Table.
2732
+ * The useTableCellIdsListener hook registers a listener that is called whenever
2733
+ * the Cell Ids used across a Table change.
2734
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2735
+ * Table.
2738
2736
  * @param listener The function to call when Cell Ids change.
2739
- * @param mutator An optional boolean indicating the listener
2740
- * mutates Store data.
2737
+ * @param mutator An optional boolean indicating the listener mutates Store
2738
+ * data.
2741
2739
  * @param storeOrStoreId The Store to use, or its Id.
2742
2740
  * @category Hook
2743
2741
  * @since v8.1.0
@@ -2752,17 +2750,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2752
2750
  ) => void;
2753
2751
 
2754
2752
  /**
2755
- * The useHasTableCellListener hook registers a listener that
2756
- * is called whenever a specified Cell Id is added to or
2757
- * removed from across a Table.
2758
- * @param tableId The Id of the Table to listen to, or `null`
2759
- * to listen to any Table.
2760
- * @param cellId The Id of the Cell to listen to, or `null`
2761
- * to listen to any Cell Id.
2762
- * @param listener The function to call when the Cell Id
2763
- * changes.
2764
- * @param mutator An optional boolean indicating the listener
2765
- * mutates Store data.
2753
+ * The useHasTableCellListener hook registers a listener that is called whenever
2754
+ * a specified Cell Id is added to or removed from across a Table.
2755
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2756
+ * Table.
2757
+ * @param cellId The Id of the Cell to listen to, or `null` to listen to any
2758
+ * Cell Id.
2759
+ * @param listener The function to call when the Cell Id changes.
2760
+ * @param mutator An optional boolean indicating the listener mutates Store
2761
+ * data.
2766
2762
  * @param storeOrStoreId The Store to use, or its Id.
2767
2763
  * @category Hook
2768
2764
  * @since v8.1.0
@@ -2783,14 +2779,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2783
2779
  ) => void;
2784
2780
 
2785
2781
  /**
2786
- * The useRowCountListener hook registers a listener that is
2787
- * called whenever the count of Rows in a Table changes.
2788
- * @param tableId The Id of the Table to listen to, or `null`
2789
- * to listen to any Table.
2790
- * @param listener The function to call when the Row count
2791
- * changes.
2792
- * @param mutator An optional boolean indicating the listener
2793
- * mutates Store data.
2782
+ * The useRowCountListener hook registers a listener that is called whenever the
2783
+ * count of Rows in a Table changes.
2784
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2785
+ * Table.
2786
+ * @param listener The function to call when the Row count changes.
2787
+ * @param mutator An optional boolean indicating the listener mutates Store
2788
+ * data.
2794
2789
  * @param storeOrStoreId The Store to use, or its Id.
2795
2790
  * @category Hook
2796
2791
  * @since v8.1.0
@@ -2805,13 +2800,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2805
2800
  ) => void;
2806
2801
 
2807
2802
  /**
2808
- * The useRowIdsListener hook registers a listener that is
2809
- * called whenever the Row Ids in a Table change.
2810
- * @param tableId The Id of the Table to listen to, or `null`
2811
- * to listen to any Table.
2803
+ * The useRowIdsListener hook registers a listener that is called whenever the
2804
+ * Row Ids in a Table change.
2805
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2806
+ * Table.
2812
2807
  * @param listener The function to call when Row Ids change.
2813
- * @param mutator An optional boolean indicating the listener
2814
- * mutates Store data.
2808
+ * @param mutator An optional boolean indicating the listener mutates Store
2809
+ * data.
2815
2810
  * @param storeOrStoreId The Store to use, or its Id.
2816
2811
  * @category Hook
2817
2812
  * @since v8.1.0
@@ -2826,19 +2821,17 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2826
2821
  ) => void;
2827
2822
 
2828
2823
  /**
2829
- * The useSortedRowIdsListener hook registers a listener that
2830
- * is called whenever the sorted Row Ids in a Table change.
2824
+ * The useSortedRowIdsListener hook registers a listener that is called whenever
2825
+ * the sorted Row Ids in a Table change.
2831
2826
  * @param tableId The Id of the Table to listen to.
2832
- * @param cellId The Id of the Cell to sort by, or `undefined`
2833
- * for default order.
2827
+ * @param cellId The Id of the Cell to sort by, or `undefined` for default
2828
+ * order.
2834
2829
  * @param descending Whether to sort descending.
2835
2830
  * @param offset The index of the first Row to include.
2836
- * @param limit The maximum number of Rows to include, or
2837
- * `undefined` for all.
2838
- * @param listener The function to call when sorted Row Ids
2839
- * change.
2840
- * @param mutator An optional boolean indicating the listener
2841
- * mutates Store data.
2831
+ * @param limit The maximum number of Rows to include, or `undefined` for all.
2832
+ * @param listener The function to call when sorted Row Ids change.
2833
+ * @param mutator An optional boolean indicating the listener mutates Store
2834
+ * data.
2842
2835
  * @param storeOrStoreId The Store to use, or its Id.
2843
2836
  * @category Hook
2844
2837
  * @since v8.1.0
@@ -2858,16 +2851,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2858
2851
  ) => void;
2859
2852
 
2860
2853
  /**
2861
- * The useHasRowListener hook registers a listener that is
2862
- * called whenever a specified Row is added to or removed from
2863
- * a Table.
2864
- * @param tableId The Id of the Table to listen to, or `null`
2865
- * to listen to any Table.
2866
- * @param rowId The Id of the Row to listen to, or `null` to
2867
- * listen to any Row.
2854
+ * The useHasRowListener hook registers a listener that is called whenever a
2855
+ * specified Row is added to or removed from a Table.
2856
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2857
+ * Table.
2858
+ * @param rowId The Id of the Row to listen to, or `null` to listen to any Row.
2868
2859
  * @param listener The function to call when the Row changes.
2869
- * @param mutator An optional boolean indicating the listener
2870
- * mutates Store data.
2860
+ * @param mutator An optional boolean indicating the listener mutates Store
2861
+ * data.
2871
2862
  * @param storeOrStoreId The Store to use, or its Id.
2872
2863
  * @category Hook
2873
2864
  * @since v8.1.0
@@ -2884,15 +2875,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2884
2875
  ) => void;
2885
2876
 
2886
2877
  /**
2887
- * The useRowListener hook registers a listener that is called
2888
- * whenever data in a specified Row changes.
2889
- * @param tableId The Id of the Table to listen to, or `null`
2890
- * to listen to any Table.
2891
- * @param rowId The Id of the Row to listen to, or `null` to
2892
- * listen to any Row.
2878
+ * The useRowListener hook registers a listener that is called whenever data in
2879
+ * a specified Row changes.
2880
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2881
+ * Table.
2882
+ * @param rowId The Id of the Row to listen to, or `null` to listen to any Row.
2893
2883
  * @param listener The function to call when the Row changes.
2894
- * @param mutator An optional boolean indicating the listener
2895
- * mutates Store data.
2884
+ * @param mutator An optional boolean indicating the listener mutates Store
2885
+ * data.
2896
2886
  * @param storeOrStoreId The Store to use, or its Id.
2897
2887
  * @category Hook
2898
2888
  * @since v8.1.0
@@ -2909,15 +2899,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2909
2899
  ) => void;
2910
2900
 
2911
2901
  /**
2912
- * The useCellIdsListener hook registers a listener that is
2913
- * called whenever the Cell Ids in a Row change.
2914
- * @param tableId The Id of the Table to listen to, or `null`
2915
- * to listen to any Table.
2916
- * @param rowId The Id of the Row to listen to, or `null` to
2917
- * listen to any Row.
2902
+ * The useCellIdsListener hook registers a listener that is called whenever the
2903
+ * Cell Ids in a Row change.
2904
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2905
+ * Table.
2906
+ * @param rowId The Id of the Row to listen to, or `null` to listen to any Row.
2918
2907
  * @param listener The function to call when Cell Ids change.
2919
- * @param mutator An optional boolean indicating the listener
2920
- * mutates Store data.
2908
+ * @param mutator An optional boolean indicating the listener mutates Store
2909
+ * data.
2921
2910
  * @param storeOrStoreId The Store to use, or its Id.
2922
2911
  * @category Hook
2923
2912
  * @since v8.1.0
@@ -2934,18 +2923,16 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2934
2923
  ) => void;
2935
2924
 
2936
2925
  /**
2937
- * The useHasCellListener hook registers a listener that is
2938
- * called whenever a specified Cell is added to or removed from
2939
- * a Row.
2940
- * @param tableId The Id of the Table to listen to, or `null`
2941
- * to listen to any Table.
2942
- * @param rowId The Id of the Row to listen to, or `null` to
2943
- * listen to any Row.
2944
- * @param cellId The Id of the Cell to listen to, or `null` to
2945
- * listen to any Cell.
2926
+ * The useHasCellListener hook registers a listener that is called whenever a
2927
+ * specified Cell is added to or removed from a Row.
2928
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2929
+ * Table.
2930
+ * @param rowId The Id of the Row to listen to, or `null` to listen to any Row.
2931
+ * @param cellId The Id of the Cell to listen to, or `null` to listen to any
2932
+ * Cell.
2946
2933
  * @param listener The function to call when the Cell changes.
2947
- * @param mutator An optional boolean indicating the listener
2948
- * mutates Store data.
2934
+ * @param mutator An optional boolean indicating the listener mutates Store
2935
+ * data.
2949
2936
  * @param storeOrStoreId The Store to use, or its Id.
2950
2937
  * @category Hook
2951
2938
  * @since v8.1.0
@@ -2973,17 +2960,16 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
2973
2960
  ) => void;
2974
2961
 
2975
2962
  /**
2976
- * The useCellListener hook registers a listener that is called
2977
- * whenever the value of a specified Cell changes.
2978
- * @param tableId The Id of the Table to listen to, or `null`
2979
- * to listen to any Table.
2980
- * @param rowId The Id of the Row to listen to, or `null` to
2981
- * listen to any Row.
2982
- * @param cellId The Id of the Cell to listen to, or `null` to
2983
- * listen to any Cell.
2963
+ * The useCellListener hook registers a listener that is called whenever the
2964
+ * value of a specified Cell changes.
2965
+ * @param tableId The Id of the Table to listen to, or `null` to listen to any
2966
+ * Table.
2967
+ * @param rowId The Id of the Row to listen to, or `null` to listen to any Row.
2968
+ * @param cellId The Id of the Cell to listen to, or `null` to listen to any
2969
+ * Cell.
2984
2970
  * @param listener The function to call when the Cell changes.
2985
- * @param mutator An optional boolean indicating the listener
2986
- * mutates Store data.
2971
+ * @param mutator An optional boolean indicating the listener mutates Store
2972
+ * data.
2987
2973
  * @param storeOrStoreId The Store to use, or its Id.
2988
2974
  * @category Hook
2989
2975
  * @since v8.1.0
@@ -3006,13 +2992,11 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3006
2992
  ) => void;
3007
2993
 
3008
2994
  /**
3009
- * The useHasValuesListener hook registers a listener that is
3010
- * called whenever any Values are added to or removed from the
3011
- * Store.
3012
- * @param listener The function to call when value presence
3013
- * changes.
3014
- * @param mutator An optional boolean indicating the listener
3015
- * mutates Store data.
2995
+ * The useHasValuesListener hook registers a listener that is called whenever
2996
+ * any Values are added to or removed from the Store.
2997
+ * @param listener The function to call when value presence changes.
2998
+ * @param mutator An optional boolean indicating the listener mutates Store
2999
+ * data.
3016
3000
  * @param storeOrStoreId The Store to use, or its Id.
3017
3001
  * @category Hook
3018
3002
  * @since v8.1.0
@@ -3024,11 +3008,11 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3024
3008
  ) => void;
3025
3009
 
3026
3010
  /**
3027
- * The useValuesListener hook registers a listener that is
3028
- * called whenever any Values in the Store change.
3011
+ * The useValuesListener hook registers a listener that is called whenever any
3012
+ * Values in the Store change.
3029
3013
  * @param listener The function to call when Values change.
3030
- * @param mutator An optional boolean indicating the listener
3031
- * mutates Store data.
3014
+ * @param mutator An optional boolean indicating the listener mutates Store
3015
+ * data.
3032
3016
  * @param storeOrStoreId The Store to use, or its Id.
3033
3017
  * @category Hook
3034
3018
  * @since v8.1.0
@@ -3040,11 +3024,11 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3040
3024
  ) => void;
3041
3025
 
3042
3026
  /**
3043
- * The useValueIdsListener hook registers a listener that is
3044
- * called whenever the Value Ids in the Store change.
3027
+ * The useValueIdsListener hook registers a listener that is called whenever the
3028
+ * Value Ids in the Store change.
3045
3029
  * @param listener The function to call when Value Ids change.
3046
- * @param mutator An optional boolean indicating the listener
3047
- * mutates Store data.
3030
+ * @param mutator An optional boolean indicating the listener mutates Store
3031
+ * data.
3048
3032
  * @param storeOrStoreId The Store to use, or its Id.
3049
3033
  * @category Hook
3050
3034
  * @since v8.1.0
@@ -3056,14 +3040,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3056
3040
  ) => void;
3057
3041
 
3058
3042
  /**
3059
- * The useHasValueListener hook registers a listener that is
3060
- * called whenever a specified Value is added to or removed
3061
- * from the Store.
3062
- * @param valueId The Id of the Value to listen to, or `null`
3063
- * to listen to any Value.
3043
+ * The useHasValueListener hook registers a listener that is called whenever a
3044
+ * specified Value is added to or removed from the Store.
3045
+ * @param valueId The Id of the Value to listen to, or `null` to listen to any
3046
+ * Value.
3064
3047
  * @param listener The function to call when the Value changes.
3065
- * @param mutator An optional boolean indicating the listener
3066
- * mutates Store data.
3048
+ * @param mutator An optional boolean indicating the listener mutates Store
3049
+ * data.
3067
3050
  * @param storeOrStoreId The Store to use, or its Id.
3068
3051
  * @category Hook
3069
3052
  * @since v8.1.0
@@ -3078,13 +3061,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3078
3061
  ) => void;
3079
3062
 
3080
3063
  /**
3081
- * The useValueListener hook registers a listener that is
3082
- * called whenever the value of a specified Value changes.
3083
- * @param valueId The Id of the Value to listen to, or `null`
3084
- * to listen to any Value.
3064
+ * The useValueListener hook registers a listener that is called whenever the
3065
+ * value of a specified Value changes.
3066
+ * @param valueId The Id of the Value to listen to, or `null` to listen to any
3067
+ * Value.
3085
3068
  * @param listener The function to call when the Value changes.
3086
- * @param mutator An optional boolean indicating the listener
3087
- * mutates Store data.
3069
+ * @param mutator An optional boolean indicating the listener mutates Store
3070
+ * data.
3088
3071
  * @param storeOrStoreId The Store to use, or its Id.
3089
3072
  * @category Hook
3090
3073
  * @since v8.1.0
@@ -3099,8 +3082,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3099
3082
  ) => void;
3100
3083
 
3101
3084
  /**
3102
- * The useStartTransactionListener hook registers a listener
3103
- * that is called at the start of every Store transaction.
3085
+ * The useStartTransactionListener hook registers a listener that is called at
3086
+ * the start of every Store transaction.
3104
3087
  * @param listener The function to call at transaction start.
3105
3088
  * @param storeOrStoreId The Store to use, or its Id.
3106
3089
  * @category Hook
@@ -3112,8 +3095,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3112
3095
  ) => void;
3113
3096
 
3114
3097
  /**
3115
- * The useWillFinishTransactionListener hook registers a
3116
- * listener called just before a Store transaction completes.
3098
+ * The useWillFinishTransactionListener hook registers a listener called just
3099
+ * before a Store transaction completes.
3117
3100
  * @param listener The function to call before transaction end.
3118
3101
  * @param storeOrStoreId The Store to use, or its Id.
3119
3102
  * @category Hook
@@ -3125,8 +3108,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3125
3108
  ) => void;
3126
3109
 
3127
3110
  /**
3128
- * The useDidFinishTransactionListener hook registers a
3129
- * listener called just after a Store transaction completes.
3111
+ * The useDidFinishTransactionListener hook registers a listener called just
3112
+ * after a Store transaction completes.
3130
3113
  * @param listener The function to call after transaction end.
3131
3114
  * @param storeOrStoreId The Store to use, or its Id.
3132
3115
  * @category Hook
@@ -3138,14 +3121,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3138
3121
  ) => void;
3139
3122
 
3140
3123
  /**
3141
- * The useMetricListener hook registers a listener that is
3142
- * called whenever a specified Metric value changes.
3143
- * @param metricId The Id of the Metric to listen to, or
3144
- * `null` to listen to any Metric.
3145
- * @param listener The function to call when the Metric
3146
- * changes.
3147
- * @param metricsOrMetricsId The Metrics object to use, or
3148
- * its Id.
3124
+ * The useMetricListener hook registers a listener that is called whenever a
3125
+ * specified Metric value changes.
3126
+ * @param metricId The Id of the Metric to listen to, or `null` to listen to any
3127
+ * Metric.
3128
+ * @param listener The function to call when the Metric changes.
3129
+ * @param metricsOrMetricsId The Metrics object to use, or its Id.
3149
3130
  * @category Hook
3150
3131
  * @since v8.1.0
3151
3132
  */
@@ -3156,13 +3137,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3156
3137
  ) => void;
3157
3138
 
3158
3139
  /**
3159
- * The useSliceIdsListener hook registers a listener that is
3160
- * called whenever the Slice Ids in an Index change.
3161
- * @param indexId The Id of the Index to listen to, or `null`
3162
- * to listen to any Index.
3140
+ * The useSliceIdsListener hook registers a listener that is called whenever the
3141
+ * Slice Ids in an Index change.
3142
+ * @param indexId The Id of the Index to listen to, or `null` to listen to any
3143
+ * Index.
3163
3144
  * @param listener The function to call when Slice Ids change.
3164
- * @param indexesOrIndexesId The Indexes object to use, or its
3165
- * Id.
3145
+ * @param indexesOrIndexesId The Indexes object to use, or its Id.
3166
3146
  * @category Hook
3167
3147
  * @since v8.1.0
3168
3148
  */
@@ -3173,16 +3153,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3173
3153
  ) => void;
3174
3154
 
3175
3155
  /**
3176
- * The useSliceRowIdsListener hook registers a listener that
3177
- * is called whenever the Row Ids in a Slice change.
3178
- * @param indexId The Id of the Index to listen to, or `null`
3179
- * to listen to any Index.
3180
- * @param sliceId The Id of the Slice to listen to, or `null`
3181
- * to listen to any Slice.
3182
- * @param listener The function to call when Slice Row Ids
3183
- * change.
3184
- * @param indexesOrIndexesId The Indexes object to use, or its
3185
- * Id.
3156
+ * The useSliceRowIdsListener hook registers a listener that is called whenever
3157
+ * the Row Ids in a Slice change.
3158
+ * @param indexId The Id of the Index to listen to, or `null` to listen to any
3159
+ * Index.
3160
+ * @param sliceId The Id of the Slice to listen to, or `null` to listen to any
3161
+ * Slice.
3162
+ * @param listener The function to call when Slice Row Ids change.
3163
+ * @param indexesOrIndexesId The Indexes object to use, or its Id.
3186
3164
  * @category Hook
3187
3165
  * @since v8.1.0
3188
3166
  */
@@ -3194,17 +3172,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3194
3172
  ) => void;
3195
3173
 
3196
3174
  /**
3197
- * The useRemoteRowIdListener hook registers a listener that
3198
- * is called whenever the remote Row Id for a local Row
3199
- * changes.
3200
- * @param relationshipId The Id of the Relationship, or `null`
3201
- * to listen to any Relationship.
3202
- * @param localRowId The Id of the local Row, or `null` to
3203
- * listen to any local Row.
3204
- * @param listener The function to call when the remote Row Id
3205
- * changes.
3206
- * @param relationshipsOrRelationshipsId The Relationships
3207
- * object to use, or its Id.
3175
+ * The useRemoteRowIdListener hook registers a listener that is called whenever
3176
+ * the remote Row Id for a local Row changes.
3177
+ * @param relationshipId The Id of the Relationship, or `null` to listen to any
3178
+ * Relationship.
3179
+ * @param localRowId The Id of the local Row, or `null` to listen to any local
3180
+ * Row.
3181
+ * @param listener The function to call when the remote Row Id changes.
3182
+ * @param relationshipsOrRelationshipsId The Relationships object to use, or its
3183
+ * Id.
3208
3184
  * @category Hook
3209
3185
  * @since v8.1.0
3210
3186
  */
@@ -3216,17 +3192,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3216
3192
  ) => void;
3217
3193
 
3218
3194
  /**
3219
- * The useLocalRowIdsListener hook registers a listener that
3220
- * is called whenever the local Row Ids for a remote Row
3221
- * change.
3222
- * @param relationshipId The Id of the Relationship, or `null`
3223
- * to listen to any Relationship.
3224
- * @param remoteRowId The Id of the remote Row, or `null` to
3225
- * listen to any remote Row.
3226
- * @param listener The function to call when local Row Ids
3227
- * change.
3228
- * @param relationshipsOrRelationshipsId The Relationships
3229
- * object to use, or its Id.
3195
+ * The useLocalRowIdsListener hook registers a listener that is called whenever
3196
+ * the local Row Ids for a remote Row change.
3197
+ * @param relationshipId The Id of the Relationship, or `null` to listen to any
3198
+ * Relationship.
3199
+ * @param remoteRowId The Id of the remote Row, or `null` to listen to any
3200
+ * remote Row.
3201
+ * @param listener The function to call when local Row Ids change.
3202
+ * @param relationshipsOrRelationshipsId The Relationships object to use, or its
3203
+ * Id.
3230
3204
  * @category Hook
3231
3205
  * @since v8.1.0
3232
3206
  */
@@ -3238,15 +3212,13 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3238
3212
  ) => void;
3239
3213
 
3240
3214
  /**
3241
- * The useLinkedRowIdsListener hook registers a listener that
3242
- * is called whenever the linked Row Ids for a first Row
3243
- * change.
3215
+ * The useLinkedRowIdsListener hook registers a listener that is called whenever
3216
+ * the linked Row Ids for a first Row change.
3244
3217
  * @param relationshipId The Id of the Relationship.
3245
3218
  * @param firstRowId The Id of the first Row.
3246
- * @param listener The function to call when linked Row Ids
3247
- * change.
3248
- * @param relationshipsOrRelationshipsId The Relationships
3249
- * object to use, or its Id.
3219
+ * @param listener The function to call when linked Row Ids change.
3220
+ * @param relationshipsOrRelationshipsId The Relationships object to use, or its
3221
+ * Id.
3250
3222
  * @category Hook
3251
3223
  * @since v8.1.0
3252
3224
  */
@@ -3258,14 +3230,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3258
3230
  ) => void;
3259
3231
 
3260
3232
  /**
3261
- * The useResultTableListener hook registers a listener that
3262
- * is called whenever the result Table of a query changes.
3263
- * @param queryId The Id of the query to listen to, or `null`
3264
- * to listen to any query.
3265
- * @param listener The function to call when the result Table
3266
- * changes.
3267
- * @param queriesOrQueriesId The Queries object to use, or its
3268
- * Id.
3233
+ * The useResultTableListener hook registers a listener that is called whenever
3234
+ * the result Table of a query changes.
3235
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3236
+ * query.
3237
+ * @param listener The function to call when the result Table changes.
3238
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3269
3239
  * @category Hook
3270
3240
  * @since v8.1.0
3271
3241
  */
@@ -3276,14 +3246,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3276
3246
  ) => void;
3277
3247
 
3278
3248
  /**
3279
- * The useResultTableCellIdsListener hook registers a listener
3280
- * that is called whenever the Cell Ids across a result Table
3281
- * change.
3282
- * @param queryId The Id of the query to listen to, or `null`
3283
- * to listen to any query.
3249
+ * The useResultTableCellIdsListener hook registers a listener that is called
3250
+ * whenever the Cell Ids across a result Table change.
3251
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3252
+ * query.
3284
3253
  * @param listener The function to call when Cell Ids change.
3285
- * @param queriesOrQueriesId The Queries object to use, or its
3286
- * Id.
3254
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3287
3255
  * @category Hook
3288
3256
  * @since v8.1.0
3289
3257
  */
@@ -3294,13 +3262,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3294
3262
  ) => void;
3295
3263
 
3296
3264
  /**
3297
- * The useResultRowCountListener hook registers a listener that
3298
- * is called whenever the count of result Rows changes.
3299
- * @param queryId The Id of the query to listen to, or `null`
3300
- * to listen to any query.
3265
+ * The useResultRowCountListener hook registers a listener that is called
3266
+ * whenever the count of result Rows changes.
3267
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3268
+ * query.
3301
3269
  * @param listener The function to call when the count changes.
3302
- * @param queriesOrQueriesId The Queries object to use, or its
3303
- * Id.
3270
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3304
3271
  * @category Hook
3305
3272
  * @since v8.1.0
3306
3273
  */
@@ -3311,14 +3278,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3311
3278
  ) => void;
3312
3279
 
3313
3280
  /**
3314
- * The useResultRowIdsListener hook registers a listener that
3315
- * is called whenever the result Row Ids of a query change.
3316
- * @param queryId The Id of the query to listen to, or `null`
3317
- * to listen to any query.
3318
- * @param listener The function to call when result Row Ids
3319
- * change.
3320
- * @param queriesOrQueriesId The Queries object to use, or its
3321
- * Id.
3281
+ * The useResultRowIdsListener hook registers a listener that is called whenever
3282
+ * the result Row Ids of a query change.
3283
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3284
+ * query.
3285
+ * @param listener The function to call when result Row Ids change.
3286
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3322
3287
  * @category Hook
3323
3288
  * @since v8.1.0
3324
3289
  */
@@ -3329,19 +3294,16 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3329
3294
  ) => void;
3330
3295
 
3331
3296
  /**
3332
- * The useResultSortedRowIdsListener hook registers a listener
3333
- * that is called whenever the sorted result Row Ids change.
3297
+ * The useResultSortedRowIdsListener hook registers a listener that is called
3298
+ * whenever the sorted result Row Ids change.
3334
3299
  * @param queryId The Id of the query to listen to.
3335
- * @param cellId The Id of the Cell to sort by, or `undefined`
3336
- * for default order.
3300
+ * @param cellId The Id of the Cell to sort by, or `undefined` for default
3301
+ * order.
3337
3302
  * @param descending Whether to sort descending.
3338
3303
  * @param offset The index of the first Row to include.
3339
- * @param limit The maximum number of Rows to include, or
3340
- * `undefined` for all.
3341
- * @param listener The function to call when sorted Row Ids
3342
- * change.
3343
- * @param queriesOrQueriesId The Queries object to use, or its
3344
- * Id.
3304
+ * @param limit The maximum number of Rows to include, or `undefined` for all.
3305
+ * @param listener The function to call when sorted Row Ids change.
3306
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3345
3307
  * @category Hook
3346
3308
  * @since v8.1.0
3347
3309
  */
@@ -3356,16 +3318,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3356
3318
  ) => void;
3357
3319
 
3358
3320
  /**
3359
- * The useResultRowListener hook registers a listener that is
3360
- * called whenever a result Row changes.
3361
- * @param queryId The Id of the query to listen to, or `null`
3362
- * to listen to any query.
3363
- * @param rowId The Id of the result Row to listen to, or
3364
- * `null` to listen to any result Row.
3365
- * @param listener The function to call when the result Row
3366
- * changes.
3367
- * @param queriesOrQueriesId The Queries object to use, or its
3368
- * Id.
3321
+ * The useResultRowListener hook registers a listener that is called whenever a
3322
+ * result Row changes.
3323
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3324
+ * query.
3325
+ * @param rowId The Id of the result Row to listen to, or `null` to listen to
3326
+ * any result Row.
3327
+ * @param listener The function to call when the result Row changes.
3328
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3369
3329
  * @category Hook
3370
3330
  * @since v8.1.0
3371
3331
  */
@@ -3377,15 +3337,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3377
3337
  ) => void;
3378
3338
 
3379
3339
  /**
3380
- * The useResultCellIdsListener hook registers a listener that
3381
- * is called whenever the Cell Ids in a result Row change.
3382
- * @param queryId The Id of the query to listen to, or `null`
3383
- * to listen to any query.
3384
- * @param rowId The Id of the result Row to listen to, or
3385
- * `null` to listen to any result Row.
3340
+ * The useResultCellIdsListener hook registers a listener that is called
3341
+ * whenever the Cell Ids in a result Row change.
3342
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3343
+ * query.
3344
+ * @param rowId The Id of the result Row to listen to, or `null` to listen to
3345
+ * any result Row.
3386
3346
  * @param listener The function to call when Cell Ids change.
3387
- * @param queriesOrQueriesId The Queries object to use, or its
3388
- * Id.
3347
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3389
3348
  * @category Hook
3390
3349
  * @since v8.1.0
3391
3350
  */
@@ -3397,18 +3356,16 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3397
3356
  ) => void;
3398
3357
 
3399
3358
  /**
3400
- * The useResultCellListener hook registers a listener that is
3401
- * called whenever the value of a result Cell changes.
3402
- * @param queryId The Id of the query to listen to, or `null`
3403
- * to listen to any query.
3404
- * @param rowId The Id of the result Row to listen to, or
3405
- * `null` to listen to any result Row.
3406
- * @param cellId The Id of the result Cell to listen to, or
3407
- * `null` to listen to any result Cell.
3408
- * @param listener The function to call when the result Cell
3409
- * changes.
3410
- * @param queriesOrQueriesId The Queries object to use, or its
3411
- * Id.
3359
+ * The useResultCellListener hook registers a listener that is called whenever
3360
+ * the value of a result Cell changes.
3361
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3362
+ * query.
3363
+ * @param rowId The Id of the result Row to listen to, or `null` to listen to
3364
+ * any result Row.
3365
+ * @param cellId The Id of the result Cell to listen to, or `null` to listen to
3366
+ * any result Cell.
3367
+ * @param listener The function to call when the result Cell changes.
3368
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3412
3369
  * @category Hook
3413
3370
  * @since v8.1.0
3414
3371
  */
@@ -3421,14 +3378,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3421
3378
  ) => void;
3422
3379
 
3423
3380
  /**
3424
- * The useParamValuesListener hook registers a listener that
3425
- * is called whenever the parameter values for a query change.
3426
- * @param queryId The Id of the query to listen to, or `null`
3427
- * to listen to any query.
3428
- * @param listener The function to call when parameter values
3429
- * change.
3430
- * @param queriesOrQueriesId The Queries object to use, or its
3431
- * Id.
3381
+ * The useParamValuesListener hook registers a listener that is called whenever
3382
+ * the parameter values for a query change.
3383
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3384
+ * query.
3385
+ * @param listener The function to call when parameter values change.
3386
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3432
3387
  * @category Hook
3433
3388
  * @since v8.1.0
3434
3389
  */
@@ -3439,17 +3394,14 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3439
3394
  ) => void;
3440
3395
 
3441
3396
  /**
3442
- * The useParamValueListener hook registers a listener that is
3443
- * called whenever a specific parameter value for a query
3444
- * changes.
3445
- * @param queryId The Id of the query to listen to, or `null`
3446
- * to listen to any query.
3447
- * @param paramId The Id of the parameter to listen to, or
3448
- * `null` to listen to any parameter.
3449
- * @param listener The function to call when the parameter
3450
- * value changes.
3451
- * @param queriesOrQueriesId The Queries object to use, or its
3452
- * Id.
3397
+ * The useParamValueListener hook registers a listener that is called whenever a
3398
+ * specific parameter value for a query changes.
3399
+ * @param queryId The Id of the query to listen to, or `null` to listen to any
3400
+ * query.
3401
+ * @param paramId The Id of the parameter to listen to, or `null` to listen to
3402
+ * any parameter.
3403
+ * @param listener The function to call when the parameter value changes.
3404
+ * @param queriesOrQueriesId The Queries object to use, or its Id.
3453
3405
  * @category Hook
3454
3406
  * @since v8.1.0
3455
3407
  */
@@ -3461,12 +3413,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3461
3413
  ) => void;
3462
3414
 
3463
3415
  /**
3464
- * The useCheckpointIdsListener hook registers a listener that
3465
- * is called whenever the Checkpoint Ids change.
3466
- * @param listener The function to call when Checkpoint Ids
3467
- * change.
3468
- * @param checkpointsOrCheckpointsId The Checkpoints object to
3469
- * use, or its Id.
3416
+ * The useCheckpointIdsListener hook registers a listener that is called
3417
+ * whenever the Checkpoint Ids change.
3418
+ * @param listener The function to call when Checkpoint Ids change.
3419
+ * @param checkpointsOrCheckpointsId The Checkpoints object to use, or its Id.
3470
3420
  * @category Hook
3471
3421
  * @since v8.1.0
3472
3422
  */
@@ -3476,14 +3426,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3476
3426
  ) => void;
3477
3427
 
3478
3428
  /**
3479
- * The useCheckpointListener hook registers a listener that is
3480
- * called whenever the label of a specified Checkpoint changes.
3481
- * @param checkpointId The Id of the Checkpoint to listen to,
3482
- * or `null` to listen to any Checkpoint.
3483
- * @param listener The function to call when the Checkpoint
3484
- * label changes.
3485
- * @param checkpointsOrCheckpointsId The Checkpoints object to
3486
- * use, or its Id.
3429
+ * The useCheckpointListener hook registers a listener that is called whenever
3430
+ * the label of a specified Checkpoint changes.
3431
+ * @param checkpointId The Id of the Checkpoint to listen to, or `null` to
3432
+ * listen to any Checkpoint.
3433
+ * @param listener The function to call when the Checkpoint label changes.
3434
+ * @param checkpointsOrCheckpointsId The Checkpoints object to use, or its Id.
3487
3435
  * @category Hook
3488
3436
  * @since v8.1.0
3489
3437
  */
@@ -3494,12 +3442,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3494
3442
  ) => void;
3495
3443
 
3496
3444
  /**
3497
- * The usePersisterStatusListener hook registers a listener
3498
- * that is called whenever the status of a Persister changes.
3499
- * @param listener The function to call when the status
3500
- * changes.
3501
- * @param persisterOrPersisterId The Persister to use, or its
3502
- * Id.
3445
+ * The usePersisterStatusListener hook registers a listener that is called
3446
+ * whenever the status of a Persister changes.
3447
+ * @param listener The function to call when the status changes.
3448
+ * @param persisterOrPersisterId The Persister to use, or its Id.
3503
3449
  * @category Hook
3504
3450
  * @since v8.1.0
3505
3451
  */
@@ -3511,13 +3457,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
3511
3457
  ) => void;
3512
3458
 
3513
3459
  /**
3514
- * The useSynchronizerStatusListener hook registers a listener
3515
- * that is called whenever the status of a Synchronizer
3516
- * changes.
3517
- * @param listener The function to call when the status
3518
- * changes.
3519
- * @param synchronizerOrSynchronizerId The Synchronizer to use,
3520
- * or its Id.
3460
+ * The useSynchronizerStatusListener hook registers a listener that is called
3461
+ * whenever the status of a Synchronizer changes.
3462
+ * @param listener The function to call when the status changes.
3463
+ * @param synchronizerOrSynchronizerId The Synchronizer to use, or its Id.
3521
3464
  * @category Hook
3522
3465
  * @since v8.1.0
3523
3466
  */