@arrai-innovations/reactive-helpers 20.1.1 → 20.1.3

package/index.js

@@ -30,6 +30,7 @@ export * from "./utils/compact.js";
 export * from "./utils/deepUnref.js";
 export * from "./utils/deleteKey.js";
 export * from "./utils/flattenPaths.js";
+export * from "./utils/flattenPathsWithValues.js";
 export * from "./utils/getFakePk.js";
 export * from "./utils/keepAliveTry.js";
 export * from "./utils/keyDiff.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@arrai-innovations/reactive-helpers",
-    "version": "20.1.1",
+    "version": "20.1.3",
     "description": "VueJS 3 utility composition functions to help manipulate objects and lists.",
     "main": "index.js",
     "type": "module",

package/types/index.d.ts

@@ -29,6 +29,7 @@ export * from "./utils/compact.js";
 export * from "./utils/deepUnref.js";
 export * from "./utils/deleteKey.js";
 export * from "./utils/flattenPaths.js";
+export * from "./utils/flattenPathsWithValues.js";
 export * from "./utils/getFakePk.js";
 export * from "./utils/keepAliveTry.js";
 export * from "./utils/keyDiff.js";

package/types/use/list.d.ts

@@ -102,7 +102,7 @@ export type ListOptions = {
     /**
      * - Indicates whether old pages should be kept when paginating.
      */
-    keepOldPages: boolean;
+    keepOldPages: import("vue").Ref<boolean> | boolean;
     /**
      * - Indicates whether the list should be cleared when the list intent is triggered.
      */

package/types/use/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../use/list.js"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AAEH;;GAEG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;AAmHM,sCAPI;IACV,CAAO,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC7B,GACS;IACZ,CAAM,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC5B,CASH;AAcM,6JAJI,WAAW,GACT,WAAW,CAwHvB;;;;;;;;YAvPa,MAAM;;;;WACN,MAAM;;;;YACN,MAAM;;;;kBACN,OAAO;;;;uBACP,OAAO;;;;yBACP,OAAO,kBAAkB,EAAE,gBAAgB;;;;4BAC3C,OAAO,qBAAqB,EAAE,mBAAmB;;;;mBACjD,OAAO,iBAAiB,EAAE,uBAAuB;;;;oBACjD,OAAO,iBAAiB,EAAE,wBAAwB;;;;qBAClD,OAAO,iBAAiB,EAAE,eAAe;;;;qBACzC,MAAM;;;;2BACN,MAAM;;;;yBACN,MAAM;;;;kBACN,OAAO,eAAe,EAAE,WAAW,EAAE;;;;;;WAKrC,YAAY;;;;cACZ,OAAO,uBAAuB,EAAE,gBAAgB;;;;WAChD,OAAO;;;;kBACP,OAAO;;;;oCACP,OAAO;;;;oBACP,MAAM;;;;sBACN,MAAM;;;;4BACN,OAAO;;;;;;2BAOR,CACZ,CACA,OAAiB,mBAAmB,EAAE,oBAAoB,GAC1D,OAAiB,4BAA4B,EAAE,yBAAyB,CACjE,GACP,OAAa,uBAAuB,EAAE,wBAAwB,GAC9D,OAAa,kBAAkB,EAAE,mBAAmB,GACpD,OAAa,qBAAqB,EAAE,sBAAsB,GAC1D,OAAa,iBAAiB,EAAE,kBAAkB,GAClD,OAAa,iBAAiB,EAAE,kBAAkB,GAClD,OAAa,eAAe,EAAE,gBAAgB,CAC3C;;;;;wBAOS,OAAO,KAAK,EAAE,gBAAgB,CAAC,YAAY,CAAC;;;;0BAM5C;IACN,YAAY,EAAE,OAAO,mBAAmB,EAAE,YAAY,GAAG,OAAO,4BAA4B,EAAE,iBAAiB,CAAC;IAChH,gBAAgB,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,CAAC;IACnE,WAAW,EAAE,OAAO,kBAAkB,EAAE,WAAW,CAAC;IACpD,cAAc,EAAE,OAAO,qBAAqB,EAAE,cAAc,CAAC;IAC7D,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,CAAC;IACjD,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,CAAC;IACjD,QAAQ,EAAE,OAAO,eAAe,EAAE,QAAQ,CAAA;CAC7C;;;;4BAMS,CACZ,OAAa,mBAAmB,EAAE,qBAAqB,GAC/C,OAAO,uBAAuB,EAAE,yBAAyB,CAC9D;;;;;;;;;aAcU,WAAW;;;;WACX,SAAS;;;;iBACT,OAAO,KAAK,EAAE,WAAW;;;;;;0BAO1B,aAAa,GAAG,qBAAqB"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../use/list.js"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AAEH;;GAEG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;AAmHM,sCAPI;IACV,CAAO,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC7B,GACS;IACZ,CAAM,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC5B,CASH;AAcM,6JAJI,WAAW,GACT,WAAW,CAwHvB;;;;;;;;YAvPa,MAAM;;;;WACN,MAAM;;;;YACN,MAAM;;;;kBACN,OAAO;;;;uBACP,OAAO;;;;yBACP,OAAO,kBAAkB,EAAE,gBAAgB;;;;4BAC3C,OAAO,qBAAqB,EAAE,mBAAmB;;;;mBACjD,OAAO,iBAAiB,EAAE,uBAAuB;;;;oBACjD,OAAO,iBAAiB,EAAE,wBAAwB;;;;qBAClD,OAAO,iBAAiB,EAAE,eAAe;;;;qBACzC,MAAM;;;;2BACN,MAAM;;;;yBACN,MAAM;;;;kBACN,OAAO,eAAe,EAAE,WAAW,EAAE;;;;;;WAKrC,YAAY;;;;cACZ,OAAO,uBAAuB,EAAE,gBAAgB;;;;WAChD,OAAO;;;;kBACP,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAC,OAAO;;;;oCAClC,OAAO;;;;oBACP,MAAM;;;;sBACN,MAAM;;;;4BACN,OAAO;;;;;;2BAOR,CACZ,CACA,OAAiB,mBAAmB,EAAE,oBAAoB,GAC1D,OAAiB,4BAA4B,EAAE,yBAAyB,CACjE,GACP,OAAa,uBAAuB,EAAE,wBAAwB,GAC9D,OAAa,kBAAkB,EAAE,mBAAmB,GACpD,OAAa,qBAAqB,EAAE,sBAAsB,GAC1D,OAAa,iBAAiB,EAAE,kBAAkB,GAClD,OAAa,iBAAiB,EAAE,kBAAkB,GAClD,OAAa,eAAe,EAAE,gBAAgB,CAC3C;;;;;wBAOS,OAAO,KAAK,EAAE,gBAAgB,CAAC,YAAY,CAAC;;;;0BAM5C;IACN,YAAY,EAAE,OAAO,mBAAmB,EAAE,YAAY,GAAG,OAAO,4BAA4B,EAAE,iBAAiB,CAAC;IAChH,gBAAgB,EAAE,OAAO,uBAAuB,EAAE,gBAAgB,CAAC;IACnE,WAAW,EAAE,OAAO,kBAAkB,EAAE,WAAW,CAAC;IACpD,cAAc,EAAE,OAAO,qBAAqB,EAAE,cAAc,CAAC;IAC7D,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,CAAC;IACjD,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,CAAC;IACjD,QAAQ,EAAE,OAAO,eAAe,EAAE,QAAQ,CAAA;CAC7C;;;;4BAMS,CACZ,OAAa,mBAAmB,EAAE,qBAAqB,GAC/C,OAAO,uBAAuB,EAAE,yBAAyB,CAC9D;;;;;;;;;aAcU,WAAW;;;;WACX,SAAS;;;;iBACT,OAAO,KAAK,EAAE,WAAW;;;;;;0BAO1B,aAAa,GAAG,qBAAqB"}

package/types/use/listInstance.d.ts

@@ -20,7 +20,7 @@
  *  function.
  * @property {import('../config/listCrud.js').CrudListSubscribeFn} [handlers.subscribe] - Provide the implementation for the
  *  subscribe function.
- * @property {boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
  */
 /**
  * The objects by pk.
@@ -210,7 +210,7 @@ export type ListInstanceOptions = {
     /**
      * - If true, pages will not be cleared when defaultPageCallback is called.
      */
-    keepOldPages: boolean;
+    keepOldPages: import("vue").Ref<boolean> | boolean;
 };
 /**
  * The objects by pk.

package/types/use/listInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listInstance.d.ts","sourceRoot":"","sources":["../../use/listInstance.js"],"names":[],"mappings":"AAwCA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,mDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAC,GAClC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CASzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,mEALW,mBAAmB,GAEjB,YAAY,CAmTxB;AAlfD;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;;;;;;;;WAMa,MAAM;;;;YACN,MAAM;;;;YACN,MAAM;;;;;;;;;WAON,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;eAE5D;QAAiE,IAAI,GAA1D,OAAO,uBAAuB,EAAE,UAAU;QAEmB,UAAU,GAAtE,OAAO,uBAAuB,EAAE,gBAAgB;QAEgB,aAAa,GAA5E,OAAO,uBAAuB,EAAE,mBAAmB;QAEU,SAAS,GAAxE,OAAO,uBAAuB,EAAE,mBAAmB;KAE9D;;;;kBAAW,OAAO;;;;;0BAMR;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;CAAC;;;;6BAM1B,OAAO,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;;;;wBAMvC,OAAO,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;;;;;UAQ7C;QAAwB,IAAI,EAAjB,MAAM;QACU,IAAI;KAC/B;;;;WAAW,MAAM;;;;YACN,MAAM;;;;aACN,WAAW;;;;aACX,OAAO;;;;cACP,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;aACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;WACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;WACvC,SAAS;;;;oBACT,cAAc;;;;;gCAMf,OAAO,KAAK,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;;;;;;;;yBAOnD,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;kBAClC,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;mBAClC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI;;;;eAC1B,MAAM,IAAI;;;;eACV,MAAM,MAAM;;;;UACZ,MAAM,OAAO,gCAAgC,EAAE,uBAAuB,CAAC,OAAO,GAAC,KAAK,CAAC;;;;gBACrF,MAAM,OAAO,CAAC,OAAO,CAAC;;;;mBACtB,MAAM,OAAO,CAAC,MAAM,GAAC,MAAM,GAAC,KAAK,CAAC;;;;;qCAMnC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAC;;;;2BAM1B,sBAAsB,GAAG,qBAAqB;;;;;yBAlH9C;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC"}
+{"version":3,"file":"listInstance.d.ts","sourceRoot":"","sources":["../../use/listInstance.js"],"names":[],"mappings":"AAwCA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,mDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAC,GAClC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CASzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,mEALW,mBAAmB,GAEjB,YAAY,CAmTxB;AAlfD;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;;;;;;;;WAMa,MAAM;;;;YACN,MAAM;;;;YACN,MAAM;;;;;;;;;WAON,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;eAE5D;QAAiE,IAAI,GAA1D,OAAO,uBAAuB,EAAE,UAAU;QAEmB,UAAU,GAAtE,OAAO,uBAAuB,EAAE,gBAAgB;QAEgB,aAAa,GAA5E,OAAO,uBAAuB,EAAE,mBAAmB;QAEU,SAAS,GAAxE,OAAO,uBAAuB,EAAE,mBAAmB;KAE9D;;;;kBAAW,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAC,OAAO;;;;;0BAMnC;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;CAAC;;;;6BAM1B,OAAO,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;;;;wBAMvC,OAAO,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;;;;;UAQ7C;QAAwB,IAAI,EAAjB,MAAM;QACU,IAAI;KAC/B;;;;WAAW,MAAM;;;;YACN,MAAM;;;;aACN,WAAW;;;;aACX,OAAO;;;;cACP,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;aACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;WACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;WACvC,SAAS;;;;oBACT,cAAc;;;;;gCAMf,OAAO,KAAK,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;;;;;;;;yBAOnD,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;kBAClC,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;mBAClC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI;;;;eAC1B,MAAM,IAAI;;;;eACV,MAAM,MAAM;;;;UACZ,MAAM,OAAO,gCAAgC,EAAE,uBAAuB,CAAC,OAAO,GAAC,KAAK,CAAC;;;;gBACrF,MAAM,OAAO,CAAC,OAAO,CAAC;;;;mBACtB,MAAM,OAAO,CAAC,MAAM,GAAC,MAAM,GAAC,KAAK,CAAC;;;;;qCAMnC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAC;;;;2BAM1B,sBAAsB,GAAG,qBAAqB;;;;;yBAlH9C;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC"}

package/types/use/listSubscription.d.ts

@@ -47,7 +47,7 @@
  * @typedef {object & import("./listInstance.js").ListInstanceOptions} ListSubscriptionOptions
  * @property {import("./listInstance.js").ListInstance} listInstance - A list instance to use instead of creating one.
  * @property {boolean} clearListOnListIntentTriggered - If true, the list will be cleared when the list intent is triggered. Default is false.
- * @property {boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
  */
 /**
  * A Vue composition function that creates multiple list subscriptions, and returns them as an object.

package/types/use/paginatedListInstance.d.ts

@@ -8,7 +8,7 @@ export type PagedListListanceOptions = {
     /**
      * - Whether to keep old pages.
      */
-    keepOldPages: boolean;
+    keepOldPages: import("vue").Ref<boolean> | boolean;
 };
 export type PaginatedRawState = {
     /**

package/types/use/paginatedListInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paginatedListInstance.d.ts","sourceRoot":"","sources":["../../use/paginatedListInstance.js"],"names":[],"mappings":"AA4DA;;;;GAIG;AACH,+EAHW,wBAAwB,GAAG,OAAO,mBAAmB,EAAE,mBAAmB,GACxE,iBAAiB,CA8D7B;;;;;kBAnHa,OAAO;;;;;;kBAKP,MAAM;;;;gBACN,MAAM;;;;aACN,MAAM;;;;eACN,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;;6BAItB,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;;kBAKhD,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;gBACzB,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;aACzB,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;eACzB,OAAO,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;wCAIzC,OAAO,mBAAmB,EAAE,oBAAoB,GAAG,+BAA+B;;;;;;WASjF,sBAAsB;;gCAIvB,OAAO,mBAAmB,EAAE,YAAY,GAAG,oBAAoB;yBA9C3C,KAAK"}
+{"version":3,"file":"paginatedListInstance.d.ts","sourceRoot":"","sources":["../../use/paginatedListInstance.js"],"names":[],"mappings":"AA4DA;;;;GAIG;AACH,+EAHW,wBAAwB,GAAG,OAAO,mBAAmB,EAAE,mBAAmB,GACxE,iBAAiB,CA8D7B;;;;;kBAnHa,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,GAAC,OAAO;;;;;;kBAKlC,MAAM;;;;gBACN,MAAM;;;;aACN,MAAM;;;;eACN,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;;6BAItB,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;;kBAKhD,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;gBACzB,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;aACzB,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;;;;eACzB,OAAO,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;wCAIzC,OAAO,mBAAmB,EAAE,oBAAoB,GAAG,+BAA+B;;;;;;WASjF,sBAAsB;;gCAIvB,OAAO,mBAAmB,EAAE,YAAY,GAAG,oBAAoB;yBA9CpC,KAAK"}

package/types/utils/deepUnref.d.ts

@@ -1,26 +1,6 @@
+export function deepUnref<T>(val: T): DeepUnwrap<T> | T;
 /**
  * Recursively unwraps refs from a nested object, array, or primitive.
- *
- * @template T
- * @typedef {T extends import('vue').Ref<infer U>
- *   ? DeepUnwrap<U>
- *   : T extends Array<infer V>
- *     ? Array<DeepUnwrap<V>>
- *     : T extends object
- *       ? { [K in keyof T]: DeepUnwrap<T[K]> }
- *       : T
- * } DeepUnwrap
  */
-/**
- * Safe, recursively-typed deep unref.
- *
- * @template T
- * @param {T} val - The value to deeply unwrap.
- * @returns {DeepUnwrap<T>} - The deeply unwrapped value.
- */
-export const deepUnref: any;
-/**
- * Recursively unwraps refs from a nested object, array, or primitive.
- */
-export type DeepUnwrap<T_1> = T_1 extends import("vue").Ref<infer U> ? DeepUnwrap<U> : T_1 extends Array<infer V> ? Array<DeepUnwrap<V>> : T_1 extends object ? { [K in keyof T_1]: DeepUnwrap<T_1[K]>; } : T_1;
+export type DeepUnwrap<T> = T extends import("vue").Ref<infer U> ? DeepUnwrap<U> : T extends Array<infer V> ? Array<DeepUnwrap<V>> : T extends object ? { [K in keyof T]: DeepUnwrap<T[K]>; } : T;
 //# sourceMappingURL=deepUnref.d.ts.map

package/types/utils/deepUnref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepUnref.d.ts","sourceRoot":"","sources":["../../utils/deepUnref.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAIH;;;;;;GAMG;AACH,4BAAoC;;;;8BAnBvB,GAAC,SAAS,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAC1C,UAAU,CAAC,CAAC,CAAC,GACb,GAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACpB,GAAC,SAAS,MAAM,GACd,GAAG,CAAC,IAAI,MAAM,GAAC,GAAG,UAAU,CAAC,GAAC,CAAC,CAAC,CAAC,CAAC,GAAE,GACpC,GAAC"}
+{"version":3,"file":"deepUnref.d.ts","sourceRoot":"","sources":["../../utils/deepUnref.js"],"names":[],"mappings":"AA2BO,0BAJM,CAAC,OACH,CAAC,GACC,UAAU,CAAC,CAAC,CAAC,GAAC,CAAC,CAe3B;;;;uBAjCY,CAAC,IACD,CAAC,SAAS,OAAO,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAC1C,UAAU,CAAC,CAAC,CAAC,GACb,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACpB,CAAC,SAAS,MAAM,GACd,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAE,GACpC,CAAC"}

package/types/utils/deleteKey.d.ts

@@ -11,6 +11,7 @@ export function lodashLikePathSplit(string: string, object: object): string[];
  *
  * @param {object} obj - The object to modify.
  * @param {string} path - The key to delete.
+ * @returns {boolean} Returns true if the key was deleted, false otherwise.
  */
-export function del(obj: object, path: string): void;
+export function del(obj: object, path: string): boolean;
 //# sourceMappingURL=deleteKey.d.ts.map

package/types/utils/deleteKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteKey.d.ts","sourceRoot":"","sources":["../../utils/deleteKey.js"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,4CAJW,MAAM,UACN,MAAM,GACJ,MAAM,EAAE,CAkBpB;AAED;;;;;GAKG;AACH,yBAHW,MAAM,QACN,MAAM,QAiBhB"}
+{"version":3,"file":"deleteKey.d.ts","sourceRoot":"","sources":["../../utils/deleteKey.js"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,4CAJW,MAAM,UACN,MAAM,GACJ,MAAM,EAAE,CAkBpB;AAED;;;;;;GAMG;AACH,yBAJW,MAAM,QACN,MAAM,GACJ,OAAO,CAkBnB"}

package/types/utils/flattenPathsWithValues.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Get all primitive paths and their corresponding values from an array or object.
+ *
+ * @module utils/flattenPathsWithValues.js
+ */
+/**
+ * Turn an array or object into an array of `[path, value]` pairs (for primitives)
+ * and a list of container paths (for arrays and objects).
+ *
+ * Array indexes are wrapped in square brackets and object keys are prefixed with a period.
+ *
+ * @param {any[] | object} arrayOrObject - Array or object to flatten.
+ * @param {object} [options] - Options.
+ * @param {string} [options.currentPath=""] - Current path, for recursion or as a starting point.
+ * @param {number} [options.depth=0] - Current depth, for recursion.
+ * @param {number} [options.limit=0] - Limit the depth of recursion.
+ * @returns {{
+ *   pathValues: [string, any][],
+ *   containerPaths: string[]
+ * }} - Paths and their corresponding values.
+ */
+export function flattenPathsWithValues(arrayOrObject: any[] | object, { currentPath, depth, limit }?: {
+    currentPath?: string;
+    depth?: number;
+    limit?: number;
+}): {
+    pathValues: [string, any][];
+    containerPaths: string[];
+};
+//# sourceMappingURL=flattenPathsWithValues.d.ts.map

package/types/utils/flattenPathsWithValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenPathsWithValues.d.ts","sourceRoot":"","sources":["../../utils/flattenPathsWithValues.js"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,sDAVW,GAAG,EAAE,GAAG,MAAM,kCAEtB;IAAyB,WAAW,GAA5B,MAAM;IACW,KAAK,GAAtB,MAAM;IACW,KAAK,GAAtB,MAAM;CACd,GAAU;IACR,UAAU,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB,CAyCH"}

package/types/utils/keyDiff.d.ts

@@ -8,23 +8,23 @@
  * Result object of keyDiff and keyDiffDeep.
  *
  * @typedef {object} KeyDiffResult
- * @property {Set} [sameKeys] - If sameKeys option is true, return keys that are the same.
- * @property {Set} [removedKeys] - If removedKeys option is true, return keys that are removed.
- * @property {Set} [addedKeys] - If addedKeys option is true, return keys that are added.
+ * @property {Set<string>} [sameKeys] - If sameKeys option is true, return keys that are the same.
+ * @property {Set<string>} [removedKeys] - If removedKeys option is true, return keys that are removed.
+ * @property {Set<string>} [addedKeys] - If addedKeys option is true, return keys that are added.
  */
 /**
  * Calculate the difference between two arrays of keys, in terms of what keys
  * are the same, what keys are removed, and what keys are added.
  *
- * @param {string[]|Set} newKeys - Keys to consider as new.
- * @param {string[]|Set} oldKeys - Keys to consider as old.
+ * @param {string[]|Set<string>} newKeys - Keys to consider as new.
+ * @param {string[]|Set<string>} oldKeys - Keys to consider as old.
  * @param {object} [options] - Which differences are returned.
  * @param {boolean} [options.sameKeys=true] - If true, return keys that are the same.
  * @param {boolean} [options.removedKeys=true] - If true, return keys that are removed.
  * @param {boolean} [options.addedKeys=true] - If true, return keys that are added.
  * @returns {KeyDiffResult} - The differences.
  */
-export function keyDiff(newKeys: string[] | Set<any>, oldKeys: string[] | Set<any>, { sameKeys, removedKeys, addedKeys }?: {
+export function keyDiff(newKeys: string[] | Set<string>, oldKeys: string[] | Set<string>, { sameKeys, removedKeys, addedKeys }?: {
     sameKeys?: boolean;
     removedKeys?: boolean;
     addedKeys?: boolean;
@@ -50,14 +50,14 @@ export type KeyDiffResult = {
     /**
      * - If sameKeys option is true, return keys that are the same.
      */
-    sameKeys?: Set<any>;
+    sameKeys?: Set<string>;
     /**
      * - If removedKeys option is true, return keys that are removed.
      */
-    removedKeys?: Set<any>;
+    removedKeys?: Set<string>;
     /**
      * - If addedKeys option is true, return keys that are added.
      */
-    addedKeys?: Set<any>;
+    addedKeys?: Set<string>;
 };
 //# sourceMappingURL=keyDiff.d.ts.map

package/types/utils/keyDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyDiff.d.ts","sourceRoot":"","sources":["../../utils/keyDiff.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,iCARW,MAAM,EAAE,WAAI,WACZ,MAAM,EAAE,WAAI,yCAEpB;IAA0B,QAAQ,GAA1B,OAAO;IACW,WAAW,GAA7B,OAAO;IACW,SAAS,GAA3B,OAAO;CACf,GAAU,aAAa,CAgBzB;AAED;;;;;;;;;;;;GAYG;AACH,oCATW,MAAM,UACN,MAAM,YACN,MAAM,GAKJ,aAAa,CAUzB"}
+{"version":3,"file":"keyDiff.d.ts","sourceRoot":"","sources":["../../utils/keyDiff.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,iCARW,MAAM,EAAE,GAAC,GAAG,CAAC,MAAM,CAAC,WACpB,MAAM,EAAE,GAAC,GAAG,CAAC,MAAM,CAAC,yCAE5B;IAA0B,QAAQ,GAA1B,OAAO;IACW,WAAW,GAA7B,OAAO;IACW,SAAS,GAA3B,OAAO;CACf,GAAU,aAAa,CAgBzB;AAED;;;;;;;;;;;;GAYG;AACH,oCATW,MAAM,UACN,MAAM,YACN,MAAM,GAKJ,aAAa,CAUzB;;;;;;;;eAtDa,GAAG,CAAC,MAAM,CAAC;;;;kBACX,GAAG,CAAC,MAAM,CAAC;;;;gBACX,GAAG,CAAC,MAAM,CAAC"}

package/use/list.js

@@ -68,7 +68,7 @@ export class ListError extends Error {
  * @property {ListRawProps} props - The properties for configuring the list.
  * @property {import('../config/listCrud.js').ListCrudHandlers} handlers - Additional handlers to be included in the list manager.
  * @property {boolean} paged - Indicates whether the list should be paginated.
- * @property {boolean} keepOldPages - Indicates whether old pages should be kept when paginating.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - Indicates whether old pages should be kept when paginating.
  * @property {boolean} clearListOnListIntentTriggered - Indicates whether the list should be cleared when the list intent is triggered.
  * @property {number} searchThrottle - The throttle time for text search.
  * @property {number} sortThrottleWait - The throttle time for sorting.

package/use/listInstance.js

@@ -61,7 +61,7 @@ export class ListInstanceError extends Error {
  *  function.
  * @property {import('../config/listCrud.js').CrudListSubscribeFn} [handlers.subscribe] - Provide the implementation for the
  *  subscribe function.
- * @property {boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
  */
 
 /**
@@ -287,7 +287,7 @@ export function useListInstance({ props, handlers = {}, keepOldPages }) {
 
     const defaultPageCallback = (/** @type {ListObject[]} */ newObjects) => {
         // with keepOldPages, you are responsible for clearing the list as needed
-        if (!keepOldPages) {
+        if (!unref(keepOldPages)) {
             // display one page at a time, clear the list
             clearList();
         }

package/use/listSubscription.js

@@ -86,7 +86,7 @@ export class ListSubscriptionError extends Error {
  * @typedef {object & import("./listInstance.js").ListInstanceOptions} ListSubscriptionOptions
  * @property {import("./listInstance.js").ListInstance} listInstance - A list instance to use instead of creating one.
  * @property {boolean} clearListOnListIntentTriggered - If true, the list will be cleared when the list intent is triggered. Default is false.
- * @property {boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - If true, pages will not be cleared when defaultPageCallback is called.
  */
 
 /**

package/use/paginatedListInstance.js

@@ -1,5 +1,5 @@
 import { useListInstance } from "./listInstance.js";
-import { reactive, toRefs } from "vue";
+import { reactive, toRefs, unref } from "vue";
 
 /**
  * @module use/paginatedListInstance.js
@@ -8,7 +8,7 @@ import { reactive, toRefs } from "vue";
 
 /**
  * @typedef {object} PagedListListanceOptions
- * @property {boolean} keepOldPages - Whether to keep old pages.
+ * @property {import('vue').Ref<boolean>|boolean} keepOldPages - Whether to keep old pages.
  */
 
 /**
@@ -94,7 +94,7 @@ export function usePagedListInstance({ keepOldPages, ...useListInstanceArgs }) {
         /** @type {import('../config/listCrud.js').PaginateInfo} */ { page, totalRecords, totalPages, perPage }
     ) => {
         // with keepOldPages, you are responsible for clearing the list as needed
-        if (!keepOldPages) {
+        if (!unref(keepOldPages)) {
             // display one page at a time, clear the list
             paginatedListInstance.clearList();
         }

package/utils/deepUnref.js

@@ -23,6 +23,19 @@ import { deepUnref as _deepUnref } from "vue-deepunref";
  *
  * @template T
  * @param {T} val - The value to deeply unwrap.
- * @returns {DeepUnwrap<T>} - The deeply unwrapped value.
+ * @returns {DeepUnwrap<T>|T} - The deeply unwrapped value.
  */
-export const deepUnref = _deepUnref;
+export const deepUnref = (val) => {
+    if (
+        val instanceof Date ||
+        val instanceof RegExp ||
+        val instanceof Map ||
+        val instanceof Set ||
+        val instanceof WeakMap ||
+        val instanceof WeakSet
+    ) {
+        return val;
+    }
+
+    return _deepUnref(val);
+};

package/utils/deleteKey.js

@@ -44,10 +44,11 @@ export function lodashLikePathSplit(string, object) {
  *
  * @param {object} obj - The object to modify.
  * @param {string} path - The key to delete.
+ * @returns {boolean} Returns true if the key was deleted, false otherwise.
  */
 export function del(obj, path) {
     if (!obj) {
-        return;
+        return false;
     }
     const pathArray = lodashLikePathSplit(path, obj);
     let index = 0;
@@ -57,7 +58,8 @@ export function del(obj, path) {
         obj = obj[toKey(pathArray[index++])];
     }
     if (!obj) {
-        return;
+        return false;
     }
     delete obj[toKey(pathArray[index])];
+    return true;
 }

package/utils/flattenPathsWithValues.js

@@ -0,0 +1,65 @@
+import isArray from "lodash-es/isArray.js";
+import isObject from "lodash-es/isObject.js";
+
+/**
+ * Get all primitive paths and their corresponding values from an array or object.
+ *
+ * @module utils/flattenPathsWithValues.js
+ */
+
+/**
+ * Turn an array or object into an array of `[path, value]` pairs (for primitives)
+ * and a list of container paths (for arrays and objects).
+ *
+ * Array indexes are wrapped in square brackets and object keys are prefixed with a period.
+ *
+ * @param {any[] | object} arrayOrObject - Array or object to flatten.
+ * @param {object} [options] - Options.
+ * @param {string} [options.currentPath=""] - Current path, for recursion or as a starting point.
+ * @param {number} [options.depth=0] - Current depth, for recursion.
+ * @param {number} [options.limit=0] - Limit the depth of recursion.
+ * @returns {{
+ *   pathValues: [string, any][],
+ *   containerPaths: string[]
+ * }} - Paths and their corresponding values.
+ */
+export function flattenPathsWithValues(arrayOrObject, { currentPath = "", depth = 0, limit = 0 } = {}) {
+    /** @type {[string, any][]} */
+    const pathValues = [];
+    /** @type {string[]} */
+    const containerPaths = [];
+
+    const keysOrIndexes = isArray(arrayOrObject);
+    const dotOrNot = currentPath ? "." : "";
+
+    if (limit && depth >= limit) {
+        return { pathValues, containerPaths };
+    }
+
+    if (isObject(arrayOrObject)) {
+        if (currentPath) {
+            containerPaths.push(currentPath);
+        }
+
+        for (const [key, value] of Object.entries(arrayOrObject)) {
+            const keyPath = keysOrIndexes ? `[${key}]` : `${dotOrNot}${key}`;
+            const nextPath = `${currentPath}${keyPath}`;
+
+            if (isObject(value) || isArray(value)) {
+                const { pathValues: childValues, containerPaths: childContainers } = flattenPathsWithValues(value, {
+                    currentPath: nextPath,
+                    depth: depth + 1,
+                    limit,
+                });
+                pathValues.push(...childValues);
+                containerPaths.push(...childContainers);
+            } else {
+                pathValues.push([nextPath, value]);
+            }
+        }
+    } else if (currentPath) {
+        pathValues.push([currentPath, arrayOrObject]);
+    }
+
+    return { pathValues, containerPaths };
+}

package/utils/keyDiff.js

@@ -12,17 +12,17 @@ import { difference, intersection } from "./set.js";
  * Result object of keyDiff and keyDiffDeep.
  *
  * @typedef {object} KeyDiffResult
- * @property {Set} [sameKeys] - If sameKeys option is true, return keys that are the same.
- * @property {Set} [removedKeys] - If removedKeys option is true, return keys that are removed.
- * @property {Set} [addedKeys] - If addedKeys option is true, return keys that are added.
+ * @property {Set<string>} [sameKeys] - If sameKeys option is true, return keys that are the same.
+ * @property {Set<string>} [removedKeys] - If removedKeys option is true, return keys that are removed.
+ * @property {Set<string>} [addedKeys] - If addedKeys option is true, return keys that are added.
  */
 
 /**
  * Calculate the difference between two arrays of keys, in terms of what keys
  * are the same, what keys are removed, and what keys are added.
  *
- * @param {string[]|Set} newKeys - Keys to consider as new.
- * @param {string[]|Set} oldKeys - Keys to consider as old.
+ * @param {string[]|Set<string>} newKeys - Keys to consider as new.
+ * @param {string[]|Set<string>} oldKeys - Keys to consider as old.
  * @param {object} [options] - Which differences are returned.
  * @param {boolean} [options.sameKeys=true] - If true, return keys that are the same.
  * @param {boolean} [options.removedKeys=true] - If true, return keys that are removed.