tinybase 2.0.1 → 2.1.0

package/lib/checkpoints.js

@@ -1 +1 @@
-const e=(e,t)=>e.includes(t),t=(e,t)=>e.forEach(t),n=e=>e.length,r=e=>0==n(e),o=(e,...t)=>e.push(...t),s=e=>e.pop(),l=e=>e.shift(),c=e=>null==e,i=(e,t,n)=>c(e)?n?.():t(e),d=(e,t)=>e?.has(t)??!1,a=e=>c(e)||0==(e=>e.size)(e),u=(e,t)=>e?.forEach(t),h=(e,t)=>e?.delete(t),p=e=>new Map(e),C=(e,t)=>e?.get(t),g=(e,t,n)=>c(n)?(h(e,t),e):e?.set(t,n),k=(e,t,n)=>(d(e,t)||g(e,t,n()),C(e,t)),f=(e,t,r,o,s=0)=>i((r?k:C)(e,t[s],s>n(t)-2?r:p),(l=>{if(s>n(t)-2)return o?.(l)&&g(e,t[s]),l;const c=f(l,t,r,o,s+1);return a(l)&&g(e,t[s]),c})),v=e=>new Set(e),L=/^\d+$/,w=e=>{let r;const[s,d]=(()=>{const e=[];let t=0;return[()=>l(e)??""+t++,t=>{L.test(t)&&n(e)<1e3&&o(e,t)}]})(),k=p();return[(t,n,o)=>{r??=e();const l=s();var c,i;return g(k,l,[t,n,o]),c=f(n,o??[""],v),i=l,c?.add(i),l},(e,s,...l)=>t(((e,r=[""])=>{const s=[],l=(e,c)=>c==n(r)?o(s,e):null===r[c]?u(e,(e=>l(e,c+1))):t([r[c],null],(t=>l(C(e,t),c+1)));return l(e,0),s})(e,s),(e=>u(e,(e=>C(k,e)[0](r,...s??[],...l))))),e=>i(C(k,e),(([,t,n])=>(f(t,n??[""],void 0,(t=>(h(t,e),a(t)?1:0))),g(k,e),d(e),n))),(e,o,s)=>i(C(k,e),(([e,,l=[]])=>{const i=(...d)=>{const a=n(d);a==n(l)?e(r,...d,...s(d)):c(l[a])?t(o[a](...d),(e=>i(...d,e))):i(...d,l[a])};i()}))]},S=Object.freeze,z=(e=>{const t=new WeakMap;return n=>(t.has(n)||t.set(n,e(n)),t.get(n))})((h=>{let f,v,L,z=100,E=p(),I=1;const M=p(),b=p(),[j,x,y]=w((()=>Q)),B=p(),F=p(),O=[],T=[],W=(e,t)=>{I=0,h.transaction((()=>u(C(B,t),((t,n)=>u(t,((t,r)=>u(t,((t,o)=>((e,t,n,r,o)=>c(o)?e.delCell(t,n,r,!0):e.setCell(t,n,r,o))(h,n,r,o,t[e]))))))))),I=1},$=e=>{g(B,e),g(F,e),x(b,[e])},m=(e,r)=>t(((e,t)=>e.splice(0,t))(e,r??n(e)),$),q=()=>m(O,n(O)-z),A=h.addCellListener(null,null,null,((e,t,n,r,l,c)=>{if(I){i(f,(()=>{o(O,f),q(),m(T),f=void 0,L=1}));const e=k(E,t,p),d=k(e,n,p),u=k(d,r,(()=>[c,void 0]));u[1]=l,u[0]===l&&a(g(d,r))&&a(g(e,n))&&a(g(E,t))&&(f=s(O),L=1),J()}})),D=(e="")=>(c(f)&&(f=""+v++,g(B,f,E),N(f,e),E=p(),L=1),f),G=()=>{r(O)||(T.unshift(D()),W(0,f),f=s(O),L=1)},H=()=>{r(T)||(o(O,f),f=l(T),W(1,f),L=1)},J=()=>{L&&(x(M),L=0)},K=e=>{const t=D(e);return J(),t},N=(e,t)=>(P(e)&&C(F,e)!==t&&(g(F,e,t),x(b,[e])),Q),P=e=>d(B,e),Q={setSize:e=>(z=e,q(),Q),addCheckpoint:K,setCheckpoint:N,getStore:()=>h,getCheckpointIds:()=>[[...O],f,[...T]],forEachCheckpoint:e=>{return t=e,u(F,((e,n)=>t(n,e)));var t},hasCheckpoint:P,getCheckpoint:e=>C(F,e),goBackward:()=>(G(),J(),Q),goForward:()=>(H(),J(),Q),goTo:t=>{const n=e(O,t)?G:e(T,t)?H:null;for(;!c(n)&&t!=f;)n();return J(),Q},addCheckpointIdsListener:e=>j(e,M),addCheckpointListener:(e,t)=>j(t,b,[e]),delListener:e=>(y(e),Q),clear:()=>(m(O),m(T),c(f)||$(f),f=void 0,v=0,K(),Q),destroy:()=>{h.delListener(A)},getListenerStats:()=>({})};return S(Q.clear())}));export{z as createCheckpoints};
+const e=(e,t)=>e.includes(t),t=(e,t)=>e.forEach(t),n=e=>e.length,r=e=>0==n(e),s=(e,...t)=>e.push(...t),o=e=>e.pop(),l=e=>e.shift(),c=e=>null==e,i=(e,t,n)=>c(e)?n?.():t(e),a=(e,t)=>e?.has(t)??!1,d=e=>c(e)||0==(e=>e.size)(e),u=(e,t)=>e?.forEach(t),h=(e,t)=>e?.delete(t),p=e=>new Map(e),C=(e,t)=>e?.get(t),g=(e,t,n)=>c(n)?(h(e,t),e):e?.set(t,n),k=(e,t,n)=>(a(e,t)||g(e,t,n()),C(e,t)),f=(e,t,r,s,o=0)=>i((r?k:C)(e,t[o],o>n(t)-2?r:p),(l=>{if(o>n(t)-2)return s?.(l)&&g(e,t[o]),l;const c=f(l,t,r,s,o+1);return d(l)&&g(e,t[o]),c})),v=e=>new Set(Array.isArray(e)||c(e)?e:[e]),L=/^\d+$/,w=e=>{let r;const[o,a]=(()=>{const e=[];let t=0;return[()=>l(e)??""+t++,t=>{L.test(t)&&n(e)<1e3&&s(e,t)}]})(),k=p();return[(t,n,s)=>{r??=e();const l=o();var c,i;return g(k,l,[t,n,s]),c=f(n,s??[""],v),i=l,c?.add(i),l},(e,o,...l)=>t(((e,r=[""])=>{const o=[],l=(e,c)=>c==n(r)?s(o,e):null===r[c]?u(e,(e=>l(e,c+1))):t([r[c],null],(t=>l(C(e,t),c+1)));return l(e,0),o})(e,o),(e=>u(e,(e=>C(k,e)[0](r,...o??[],...l))))),e=>i(C(k,e),(([,t,n])=>(f(t,n??[""],void 0,(t=>(h(t,e),d(t)?1:0))),g(k,e),a(e),n))),(e,s,o)=>i(C(k,e),(([e,,l=[]])=>{const i=(...a)=>{const d=n(a);d==n(l)?e(r,...a,...o(a)):c(l[d])?t(s[d](...a),(e=>i(...a,e))):i(...a,l[d])};i()}))]},S=Object.freeze,y=(e=>{const t=new WeakMap;return n=>(t.has(n)||t.set(n,e(n)),t.get(n))})((h=>{let f,v,L,y=100,z=p(),E=1;const A=p(),I=p(),[M,b,j]=w((()=>Q)),x=p(),B=p(),F=[],O=[],T=(e,t)=>{E=0,h.transaction((()=>u(C(x,t),((t,n)=>u(t,((t,r)=>u(t,((t,s)=>((e,t,n,r,s)=>c(s)?e.delCell(t,n,r,!0):e.setCell(t,n,r,s))(h,n,r,s,t[e]))))))))),E=1},W=e=>{g(x,e),g(B,e),b(I,[e])},$=(e,r)=>t(((e,t)=>e.splice(0,t))(e,r??n(e)),W),m=()=>$(F,n(F)-y),q=h.addCellListener(null,null,null,((e,t,n,r,l,c)=>{if(E){i(f,(()=>{s(F,f),m(),$(O),f=void 0,L=1}));const e=k(z,t,p),a=k(e,n,p),u=k(a,r,(()=>[c,void 0]));u[1]=l,u[0]===l&&d(g(a,r))&&d(g(e,n))&&d(g(z,t))&&(f=o(F),L=1),J()}})),D=(e="")=>(c(f)&&(f=""+v++,g(x,f,z),N(f,e),z=p(),L=1),f),G=()=>{r(F)||(O.unshift(D()),T(0,f),f=o(F),L=1)},H=()=>{r(O)||(s(F,f),f=l(O),T(1,f),L=1)},J=()=>{L&&(b(A),L=0)},K=e=>{const t=D(e);return J(),t},N=(e,t)=>(P(e)&&C(B,e)!==t&&(g(B,e,t),b(I,[e])),Q),P=e=>a(x,e),Q={setSize:e=>(y=e,m(),Q),addCheckpoint:K,setCheckpoint:N,getStore:()=>h,getCheckpointIds:()=>[[...F],f,[...O]],forEachCheckpoint:e=>{return t=e,u(B,((e,n)=>t(n,e)));var t},hasCheckpoint:P,getCheckpoint:e=>C(B,e),goBackward:()=>(G(),J(),Q),goForward:()=>(H(),J(),Q),goTo:t=>{const n=e(F,t)?G:e(O,t)?H:null;for(;!c(n)&&t!=f;)n();return J(),Q},addCheckpointIdsListener:e=>M(e,A),addCheckpointListener:(e,t)=>M(t,I,[e]),delListener:e=>(j(e),Q),clear:()=>($(F),$(O),c(f)||W(f),f=void 0,v=0,K(),Q),destroy:()=>{h.delListener(q)},getListenerStats:()=>({})};return S(Q.clear())}));export{y as createCheckpoints};

package/lib/debug/checkpoints.js

@@ -13,6 +13,7 @@ const arrayShift = (array) => array.shift();
 const isUndefined = (thing) => thing == void 0;
 const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
+const isArray = (thing) => Array.isArray(thing);
 
 const collSizeN = (collSizer) => (coll) =>
   arrayReduce(collValues(coll), (total, coll2) => total + collSizer(coll2), 0);
@@ -58,7 +59,12 @@ const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
     },
   );
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const getCreateFunction = (getFunction) => {

package/lib/debug/indexes.d.ts

@@ -1,6 +1,6 @@
 /**
- * The indexes module of the TinyBase project provides the ability to create
- * and track indexes of the data in Store objects.
+ * The indexes module of the TinyBase project provides the ability to create and
+ * track indexes of the data in Store objects.
  *
  * The main entry point to this module is the createIndexes function, which
  * returns a new Indexes object. From there, you can create new Index
@@ -192,6 +192,7 @@ export type IndexesListenerStats = {
  * @see Rolling Dice demos
  * @see Country demo
  * @see Todo App demos
+ * @see Word Frequencies demo
  * @category Indexes
  */
 export interface Indexes {
@@ -209,11 +210,12 @@ export interface Indexes {
    * derived string value in common, as described by this method. Those values
    * are used as the key for each Slice in the overall Index object.
    *
-   * Without the third `getSliceId` parameter, the Index will simply have a
+   * Without the third `getSliceIdOrIds` parameter, the Index will simply have a
    * single Slice, keyed by an empty string. But more often you will specify a
    * Cell value containing the Slice Id that the Row should belong to.
    * Alternatively, a custom function can be provided that produces your own
-   * Slice Id from the local Row as a whole.
+   * Slice Id from the local Row as a whole. Since v2.1, the custom function can
+   * return an array of Slice Ids, each of which the Row will then belong to.
    *
    * The fourth `getSortKey` parameter specifies a Cell Id to get a value (or a
    * function that processes a whole Row to get a value) that is used to sort
@@ -241,11 +243,13 @@ export interface Indexes {
    *
    * @param indexId The Id of the Index to define.
    * @param tableId The Id of the Table the Index will be generated from.
-   * @param getSliceId Either the Id of the Cell containing, or a function that
-   * produces, the Id that is used to indicate which Slice in the Index the Row
-   * Id should be in. Defaults to a function that returns `''` (meaning that if
-   * this `getSliceId` parameter is omitted, the Index will simply contain a
-   * single Slice containing all the Row Ids in the Table).
+   * @param getSliceIdOrIds Either the Id of the Cell containing, or a function
+   * that produces, the Id that is used to indicate which Slice in the Index the
+   * Row Id should be in. Defaults to a function that returns `''` (meaning that
+   * if this `getSliceIdOrIds` parameter is omitted, the Index will simply
+   * contain a single Slice containing all the Row Ids in the Table). Since
+   * v2.1, this can return an array of Slice Ids, each of which the Row will
+   * then belong to.
    * @param getSortKey Either the Id of the Cell containing, or a function that
    * produces, the value that is used to sort the Row Ids in each Slice.
    * @param sliceIdSorter A function that takes two Slice Id values and returns
@@ -294,6 +298,29 @@ export interface Indexes {
    * ```
    * @example
    * This example creates a Store, creates an Indexes object, and defines an
+   * Index based on each of the letters present in the pets' names.
+   *
+   * ```js
+   * const store = createStore().setTable('pets', {
+   *   fido: {species: 'dog'},
+   *   felix: {species: 'cat'},
+   *   rex: {species: 'dog'},
+   * });
+   *
+   * const indexes = createIndexes(store);
+   * indexes.setIndexDefinition('containsLetter', 'pets', (_, rowId) =>
+   *   rowId.split(''),
+   * );
+   *
+   * console.log(indexes.getSliceIds('containsLetter'));
+   * // -> ['f', 'i', 'd', 'o', 'e', 'l', 'x', 'r']
+   * console.log(indexes.getSliceRowIds('containsLetter', 'i'));
+   * // -> ['fido', 'felix']
+   * console.log(indexes.getSliceRowIds('containsLetter', 'x'));
+   * // -> ['felix', 'rex']
+   * ```
+   * @example
+   * This example creates a Store, creates an Indexes object, and defines an
    * Index based on the first letter of the pets' names. The Slice Ids (and Row
    * Ids within them) are alphabetically sorted.
    *
@@ -324,7 +351,7 @@ export interface Indexes {
   setIndexDefinition(
     indexId: Id,
     tableId: Id,
-    getSliceId?: Id | ((getCell: GetCell, rowId: Id) => Id),
+    getSliceIdOrIds?: Id | ((getCell: GetCell, rowId: Id) => Id | Ids),
     getSortKey?: Id | ((getCell: GetCell, rowId: Id) => SortKey),
     sliceIdSorter?: (sliceId1: Id, sliceId2: Id) => number,
     rowIdSorter?: (sortKey1: SortKey, sortKey2: SortKey, sliceId: Id) => number,

package/lib/debug/indexes.js

@@ -1,8 +1,12 @@
 const getTypeOf = (thing) => typeof thing;
 const EMPTY_STRING = '';
 const STRING = getTypeOf(EMPTY_STRING);
+const id = (key) => EMPTY_STRING + key;
 
 const arrayEvery = (array, cb) => array.every(cb);
+const arrayIsEqual = (array1, array2) =>
+  arrayLength(array1) === arrayLength(array2) &&
+  arrayEvery(array1, (value1, index) => array2[index] === value1);
 const arrayIsSorted = (array, sorter) =>
   arrayEvery(
     array,
@@ -10,6 +14,7 @@ const arrayIsSorted = (array, sorter) =>
   );
 const arraySort = (array, sorter) => array.sort(sorter);
 const arrayForEach = (array, cb) => array.forEach(cb);
+const arrayMap = (array, cb) => array.map(cb);
 const arrayLength = (array) => array.length;
 const arrayIsEmpty = (array) => arrayLength(array) == 0;
 const arrayReduce = (array, cb, initial) => array.reduce(cb, initial);
@@ -20,6 +25,7 @@ const isUndefined = (thing) => thing == void 0;
 const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isString = (thing) => getTypeOf(thing) == STRING;
+const isArray = (thing) => Array.isArray(thing);
 
 const collSizeN = (collSizer) => (coll) =>
   arrayReduce(collValues(coll), (total, coll2) => total + collSizer(coll2), 0);
@@ -68,7 +74,12 @@ const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
     },
   );
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
@@ -133,7 +144,14 @@ const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
       const newRowValue = hasRow(tableId, rowId)
         ? validateRowValue(getRowValue(getCell, rowId))
         : void 0;
-      if (oldRowValue != newRowValue) {
+      if (
+        !(
+          oldRowValue === newRowValue ||
+          (isArray(oldRowValue) &&
+            isArray(newRowValue) &&
+            arrayIsEqual(oldRowValue, newRowValue))
+        )
+      ) {
         mapSet(changedRowValues, rowId, [oldRowValue, newRowValue]);
       }
       if (!isUndefined(getSortKey)) {
@@ -312,7 +330,11 @@ const createIndexes = getCreateFunction((store) => {
     delDefinition,
     destroy,
   ] = getDefinableFunctions(store, mapNew, (value) =>
-    isUndefined(value) ? EMPTY_STRING : value + EMPTY_STRING,
+    isUndefined(value)
+      ? EMPTY_STRING
+      : isArray(value)
+      ? arrayMap(value, id)
+      : id(value),
   );
   const [addListener, callListeners, delListenerImpl] = getListenerFunctions(
     () => indexes,
@@ -321,7 +343,7 @@ const createIndexes = getCreateFunction((store) => {
   const setIndexDefinition = (
     indexId,
     tableId,
-    getSliceId,
+    getSliceIdOrIds,
     getSortKey,
     sliceIdSorter,
     rowIdSorter = defaultSorter,
@@ -337,29 +359,39 @@ const createIndexes = getCreateFunction((store) => {
         const changedSlices = setNew();
         const unsortedSlices = setNew();
         const index = getIndex(indexId);
-        collForEach(changedSliceIds, ([oldSliceId, newSliceId], rowId) => {
-          if (!isUndefined(oldSliceId)) {
-            setAdd(changedSlices, oldSliceId);
-            ifNotUndefined(mapGet(index, oldSliceId), (oldSlice) => {
-              collDel(oldSlice, rowId);
-              if (collIsEmpty(oldSlice)) {
-                mapSet(index, oldSliceId);
+        collForEach(
+          changedSliceIds,
+          ([oldSliceIdOrIds, newSliceIdOrIds], rowId) => {
+            const oldSliceIds = setNew(oldSliceIdOrIds);
+            const newSliceIds = setNew(newSliceIdOrIds);
+            collForEach(oldSliceIds, (oldSliceId) =>
+              collDel(newSliceIds, oldSliceId)
+                ? collDel(oldSliceIds, oldSliceId)
+                : 0,
+            );
+            collForEach(oldSliceIds, (oldSliceId) => {
+              setAdd(changedSlices, oldSliceId);
+              ifNotUndefined(mapGet(index, oldSliceId), (oldSlice) => {
+                collDel(oldSlice, rowId);
+                if (collIsEmpty(oldSlice)) {
+                  mapSet(index, oldSliceId);
+                  sliceIdsChanged = 1;
+                }
+              });
+            });
+            collForEach(newSliceIds, (newSliceId) => {
+              setAdd(changedSlices, newSliceId);
+              if (!collHas(index, newSliceId)) {
+                mapSet(index, newSliceId, setNew());
                 sliceIdsChanged = 1;
               }
+              setAdd(mapGet(index, newSliceId), rowId);
+              if (!isUndefined(getSortKey)) {
+                setAdd(unsortedSlices, newSliceId);
+              }
             });
-          }
-          if (!isUndefined(newSliceId)) {
-            setAdd(changedSlices, newSliceId);
-            if (!collHas(index, newSliceId)) {
-              mapSet(index, newSliceId, setNew());
-              sliceIdsChanged = 1;
-            }
-            setAdd(mapGet(index, newSliceId), rowId);
-            if (!isUndefined(getSortKey)) {
-              setAdd(unsortedSlices, newSliceId);
-            }
-          }
-        });
+          },
+        );
         change();
         if (!collIsEmpty(sortKeys)) {
           if (force) {
@@ -408,7 +440,7 @@ const createIndexes = getCreateFunction((store) => {
           callListeners(sliceRowIdsListeners, [indexId, sliceId]),
         );
       },
-      getRowCellFunction(getSliceId),
+      getRowCellFunction(getSliceIdOrIds),
       ifNotUndefined(getSortKey, getRowCellFunction),
     );
     return indexes;

package/lib/debug/metrics.js

@@ -7,6 +7,10 @@ const AVG = 'avg';
 const MIN = 'min';
 const MAX = 'max';
 
+const arrayEvery = (array, cb) => array.every(cb);
+const arrayIsEqual = (array1, array2) =>
+  arrayLength(array1) === arrayLength(array2) &&
+  arrayEvery(array1, (value1, index) => array2[index] === value1);
 const arrayForEach = (array, cb) => array.forEach(cb);
 const arraySum = (array) => arrayReduce(array, (i, j) => i + j, 0);
 const arrayLength = (array) => array.length;
@@ -23,6 +27,7 @@ const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isString = (thing) => getTypeOf(thing) == STRING;
 const isFunction = (thing) => getTypeOf(thing) == FUNCTION;
+const isArray = (thing) => Array.isArray(thing);
 const getUndefined = () => void 0;
 
 const collSizeN = (collSizer) => (coll) =>
@@ -140,7 +145,12 @@ const getAggregateValue = (
     : aggregateValue;
 };
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
@@ -205,7 +215,14 @@ const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
       const newRowValue = hasRow(tableId, rowId)
         ? validateRowValue(getRowValue(getCell, rowId))
         : void 0;
-      if (oldRowValue != newRowValue) {
+      if (
+        !(
+          oldRowValue === newRowValue ||
+          (isArray(oldRowValue) &&
+            isArray(newRowValue) &&
+            arrayIsEqual(oldRowValue, newRowValue))
+        )
+      ) {
         mapSet(changedRowValues, rowId, [oldRowValue, newRowValue]);
       }
       if (!isUndefined(getSortKey)) {

package/lib/debug/queries.js

@@ -20,6 +20,9 @@ const CELL_IDS = 'CellIds';
 const CELL = 'Cell';
 
 const arrayEvery = (array, cb) => array.every(cb);
+const arrayIsEqual = (array1, array2) =>
+  arrayLength(array1) === arrayLength(array2) &&
+  arrayEvery(array1, (value1, index) => array2[index] === value1);
 const arrayForEach = (array, cb) => array.forEach(cb);
 const arraySum = (array) => arrayReduce(array, (i, j) => i + j, 0);
 const arrayLength = (array) => array.length;
@@ -36,6 +39,7 @@ const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isTypeStringOrBoolean = (type) => type == STRING || type == BOOLEAN;
 const isFunction = (thing) => getTypeOf(thing) == FUNCTION;
+const isArray = (thing) => Array.isArray(thing);
 const getUndefined = () => void 0;
 
 const collSize = (coll) => coll.size;
@@ -81,7 +85,12 @@ const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
     },
   );
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const numericAggregators = mapNew([
@@ -226,7 +235,14 @@ const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
       const newRowValue = hasRow(tableId, rowId)
         ? validateRowValue(getRowValue(getCell, rowId))
         : void 0;
-      if (oldRowValue != newRowValue) {
+      if (
+        !(
+          oldRowValue === newRowValue ||
+          (isArray(oldRowValue) &&
+            isArray(newRowValue) &&
+            arrayIsEqual(oldRowValue, newRowValue))
+        )
+      ) {
         mapSet(changedRowValues, rowId, [oldRowValue, newRowValue]);
       }
       if (!isUndefined(getSortKey)) {

package/lib/debug/relationships.js

@@ -2,6 +2,10 @@ const getTypeOf = (thing) => typeof thing;
 const EMPTY_STRING = '';
 const STRING = getTypeOf(EMPTY_STRING);
 
+const arrayEvery = (array, cb) => array.every(cb);
+const arrayIsEqual = (array1, array2) =>
+  arrayLength(array1) === arrayLength(array2) &&
+  arrayEvery(array1, (value1, index) => array2[index] === value1);
 const arrayForEach = (array, cb) => array.forEach(cb);
 const arrayLength = (array) => array.length;
 const arrayIsEmpty = (array) => arrayLength(array) == 0;
@@ -13,6 +17,7 @@ const isUndefined = (thing) => thing == void 0;
 const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isString = (thing) => getTypeOf(thing) == STRING;
+const isArray = (thing) => Array.isArray(thing);
 
 const collSizeN = (collSizer) => (coll) =>
   arrayReduce(collValues(coll), (total, coll2) => total + collSizer(coll2), 0);
@@ -61,7 +66,12 @@ const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
     },
   );
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
@@ -126,7 +136,14 @@ const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
       const newRowValue = hasRow(tableId, rowId)
         ? validateRowValue(getRowValue(getCell, rowId))
         : void 0;
-      if (oldRowValue != newRowValue) {
+      if (
+        !(
+          oldRowValue === newRowValue ||
+          (isArray(oldRowValue) &&
+            isArray(newRowValue) &&
+            arrayIsEqual(oldRowValue, newRowValue))
+        )
+      ) {
         mapSet(changedRowValues, rowId, [oldRowValue, newRowValue]);
       }
       if (!isUndefined(getSortKey)) {

package/lib/debug/store.js

@@ -55,6 +55,7 @@ const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isTypeStringOrBoolean = (type) => type == STRING || type == BOOLEAN;
 const isFunction = (thing) => getTypeOf(thing) == FUNCTION;
+const isArray = (thing) => Array.isArray(thing);
 
 const collSizeN = (collSizer) => (coll) =>
   arrayReduce(collValues(coll), (total, coll2) => total + collSizer(coll2), 0);
@@ -134,7 +135,12 @@ const objForEach = (obj, cb) =>
   arrayForEach(object.entries(obj), ([id, value]) => cb(value, id));
 const objIsEmpty = (obj) => arrayIsEmpty(objIds(obj));
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const INTEGER = /^\d+$/;

package/lib/debug/tinybase.js

@@ -76,6 +76,7 @@ const ifNotUndefined = (value, then, otherwise) =>
 const isTypeStringOrBoolean = (type) => type == STRING || type == BOOLEAN;
 const isString = (thing) => getTypeOf(thing) == STRING;
 const isFunction = (thing) => getTypeOf(thing) == FUNCTION;
+const isArray = (thing) => Array.isArray(thing);
 const getUndefined = () => void 0;
 
 const collSizeN = (collSizer) => (coll) =>
@@ -143,7 +144,12 @@ const visitTree = (node, path, ensureLeaf, pruneLeaf, p = 0) =>
     },
   );
 
-const setNew = (entries) => new Set(entries);
+const setNew = (entryOrEntries) =>
+  new Set(
+    isArray(entryOrEntries) || isUndefined(entryOrEntries)
+      ? entryOrEntries
+      : [entryOrEntries],
+  );
 const setAdd = (set, value) => set?.add(value);
 
 const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
@@ -208,7 +214,14 @@ const getDefinableFunctions = (store, getDefaultThing, validateRowValue) => {
       const newRowValue = hasRow(tableId, rowId)
         ? validateRowValue(getRowValue(getCell, rowId))
         : void 0;
-      if (oldRowValue != newRowValue) {
+      if (
+        !(
+          oldRowValue === newRowValue ||
+          (isArray(oldRowValue) &&
+            isArray(newRowValue) &&
+            arrayIsEqual(oldRowValue, newRowValue))
+        )
+      ) {
         mapSet(changedRowValues, rowId, [oldRowValue, newRowValue]);
       }
       if (!isUndefined(getSortKey)) {
@@ -605,7 +618,11 @@ const createIndexes = getCreateFunction((store) => {
     delDefinition,
     destroy,
   ] = getDefinableFunctions(store, mapNew, (value) =>
-    isUndefined(value) ? EMPTY_STRING : value + EMPTY_STRING,
+    isUndefined(value)
+      ? EMPTY_STRING
+      : isArray(value)
+      ? arrayMap(value, id)
+      : id(value),
   );
   const [addListener, callListeners, delListenerImpl] = getListenerFunctions(
     () => indexes,
@@ -614,7 +631,7 @@ const createIndexes = getCreateFunction((store) => {
   const setIndexDefinition = (
     indexId,
     tableId,
-    getSliceId,
+    getSliceIdOrIds,
     getSortKey,
     sliceIdSorter,
     rowIdSorter = defaultSorter,
@@ -630,29 +647,39 @@ const createIndexes = getCreateFunction((store) => {
         const changedSlices = setNew();
         const unsortedSlices = setNew();
         const index = getIndex(indexId);
-        collForEach(changedSliceIds, ([oldSliceId, newSliceId], rowId) => {
-          if (!isUndefined(oldSliceId)) {
-            setAdd(changedSlices, oldSliceId);
-            ifNotUndefined(mapGet(index, oldSliceId), (oldSlice) => {
-              collDel(oldSlice, rowId);
-              if (collIsEmpty(oldSlice)) {
-                mapSet(index, oldSliceId);
+        collForEach(
+          changedSliceIds,
+          ([oldSliceIdOrIds, newSliceIdOrIds], rowId) => {
+            const oldSliceIds = setNew(oldSliceIdOrIds);
+            const newSliceIds = setNew(newSliceIdOrIds);
+            collForEach(oldSliceIds, (oldSliceId) =>
+              collDel(newSliceIds, oldSliceId)
+                ? collDel(oldSliceIds, oldSliceId)
+                : 0,
+            );
+            collForEach(oldSliceIds, (oldSliceId) => {
+              setAdd(changedSlices, oldSliceId);
+              ifNotUndefined(mapGet(index, oldSliceId), (oldSlice) => {
+                collDel(oldSlice, rowId);
+                if (collIsEmpty(oldSlice)) {
+                  mapSet(index, oldSliceId);
+                  sliceIdsChanged = 1;
+                }
+              });
+            });
+            collForEach(newSliceIds, (newSliceId) => {
+              setAdd(changedSlices, newSliceId);
+              if (!collHas(index, newSliceId)) {
+                mapSet(index, newSliceId, setNew());
                 sliceIdsChanged = 1;
               }
+              setAdd(mapGet(index, newSliceId), rowId);
+              if (!isUndefined(getSortKey)) {
+                setAdd(unsortedSlices, newSliceId);
+              }
             });
-          }
-          if (!isUndefined(newSliceId)) {
-            setAdd(changedSlices, newSliceId);
-            if (!collHas(index, newSliceId)) {
-              mapSet(index, newSliceId, setNew());
-              sliceIdsChanged = 1;
-            }
-            setAdd(mapGet(index, newSliceId), rowId);
-            if (!isUndefined(getSortKey)) {
-              setAdd(unsortedSlices, newSliceId);
-            }
-          }
-        });
+          },
+        );
         change();
         if (!collIsEmpty(sortKeys)) {
           if (force) {
@@ -701,7 +728,7 @@ const createIndexes = getCreateFunction((store) => {
           callListeners(sliceRowIdsListeners, [indexId, sliceId]),
         );
       },
-      getRowCellFunction(getSliceId),
+      getRowCellFunction(getSliceIdOrIds),
       ifNotUndefined(getSortKey, getRowCellFunction),
     );
     return indexes;

package/lib/debug/ui-react.js

@@ -23,6 +23,7 @@ const isUndefined = (thing) => thing == void 0;
 const ifNotUndefined = (value, then, otherwise) =>
   isUndefined(value) ? otherwise?.() : then(value);
 const isString = (thing) => getTypeOf(thing) == STRING;
+const isArray = (thing) => Array.isArray(thing);
 const getUndefined = () => void 0;
 
 const objGet = (obj, id) => ifNotUndefined(obj, (obj2) => obj2[id]);
@@ -1012,7 +1013,7 @@ const Provider = ({
 };
 const wrap = (children, separator, encloseWithId, id) => {
   const separatedChildren =
-    isUndefined(separator) || !Array.isArray(children)
+    isUndefined(separator) || !isArray(children)
       ? children
       : arrayMap(children, (child, c) => (c > 0 ? [separator, child] : child));
   return encloseWithId ? [id, ':{', separatedChildren, '}'] : separatedChildren;

package/lib/es6/checkpoints.js

@@ -1 +1 @@
-const e=(e,n)=>e.includes(n),n=(e,n)=>e.forEach(n),t=e=>e.length,l=e=>0==t(e),r=(e,...n)=>e.push(...n),o=e=>e.pop(),s=e=>e.shift(),u=e=>null==e,i=(e,n,t)=>u(e)?null==t?void 0:t():n(e),d=(e,n)=>{var t;return null!=(t=null==e?void 0:e.has(n))&&t},c=e=>u(e)||0==(e=>e.size)(e),a=(e,n)=>null==e?void 0:e.forEach(n),h=(e,n)=>null==e?void 0:e.delete(n),p=e=>new Map(e),v=(e,n)=>null==e?void 0:e.get(n),C=(e,n,t)=>u(t)?(h(e,n),e):null==e?void 0:e.set(n,t),g=(e,n,t)=>(d(e,n)||C(e,n,t()),v(e,n)),k=(e,n,l,r,o=0)=>i((l?g:v)(e,n[o],o>t(n)-2?l:p),(s=>{if(o>t(n)-2)return(null==r?void 0:r(s))&&C(e,n[o]),s;const u=k(s,n,l,r,o+1);return c(s)&&C(e,n[o]),u})),f=e=>new Set(e),L=/^\d+$/,w=e=>{let l;const[o,d]=(()=>{const e=[];let n=0;return[()=>{var t;return null!=(t=s(e))?t:""+n++},n=>{L.test(n)&&t(e)<1e3&&r(e,n)}]})(),g=p();return[(n,t,r)=>{null!=l||(l=e());const s=o();var u,i;return C(g,s,[n,t,r]),u=k(t,null!=r?r:[""],f),i=s,null==u||u.add(i),s},(e,o,...s)=>n(((e,l=[""])=>{const o=[],s=(e,u)=>u==t(l)?r(o,e):null===l[u]?a(e,(e=>s(e,u+1))):n([l[u],null],(n=>s(v(e,n),u+1)));return s(e,0),o})(e,o),(e=>a(e,(e=>v(g,e)[0](l,...null!=o?o:[],...s))))),e=>i(v(g,e),(([,n,t])=>(k(n,null!=t?t:[""],void 0,(n=>(h(n,e),c(n)?1:0))),C(g,e),d(e),t))),(e,r,o)=>i(v(g,e),(([e,,s=[]])=>{const i=(...d)=>{const c=t(d);c==t(s)?e(l,...d,...o(d)):u(s[c])?n(r[c](...d),(e=>i(...d,e))):i(...d,s[c])};i()}))]},S=Object.freeze,z=(e=>{const n=new WeakMap;return t=>(n.has(t)||n.set(t,e(t)),n.get(t))})((h=>{let k,f,L,z=100,E=p(),I=1;const M=p(),b=p(),[j,x,y]=w((()=>Q)),B=p(),F=p(),O=[],T=[],W=(e,n)=>{I=0,h.transaction((()=>a(v(B,n),((n,t)=>a(n,((n,l)=>a(n,((n,r)=>((e,n,t,l,r)=>u(r)?e.delCell(n,t,l,!0):e.setCell(n,t,l,r))(h,t,l,r,n[e]))))))))),I=1},$=e=>{C(B,e),C(F,e),x(b,[e])},m=(e,l)=>n(((e,n)=>e.splice(0,n))(e,null!=l?l:t(e)),$),q=()=>m(O,t(O)-z),A=h.addCellListener(null,null,null,((e,n,t,l,s,u)=>{if(I){i(k,(()=>{r(O,k),q(),m(T),k=void 0,L=1}));const e=g(E,n,p),d=g(e,t,p),a=g(d,l,(()=>[u,void 0]));a[1]=s,a[0]===s&&c(C(d,l))&&c(C(e,t))&&c(C(E,n))&&(k=o(O),L=1),J()}})),D=(e="")=>(u(k)&&(k=""+f++,C(B,k,E),N(k,e),E=p(),L=1),k),G=()=>{l(O)||(T.unshift(D()),W(0,k),k=o(O),L=1)},H=()=>{l(T)||(r(O,k),k=s(T),W(1,k),L=1)},J=()=>{L&&(x(M),L=0)},K=e=>{const n=D(e);return J(),n},N=(e,n)=>(P(e)&&v(F,e)!==n&&(C(F,e,n),x(b,[e])),Q),P=e=>d(B,e),Q={setSize:e=>(z=e,q(),Q),addCheckpoint:K,setCheckpoint:N,getStore:()=>h,getCheckpointIds:()=>[[...O],k,[...T]],forEachCheckpoint:e=>{return n=e,a(F,((e,t)=>n(t,e)));var n},hasCheckpoint:P,getCheckpoint:e=>v(F,e),goBackward:()=>(G(),J(),Q),goForward:()=>(H(),J(),Q),goTo:n=>{const t=e(O,n)?G:e(T,n)?H:null;for(;!u(t)&&n!=k;)t();return J(),Q},addCheckpointIdsListener:e=>j(e,M),addCheckpointListener:(e,n)=>j(n,b,[e]),delListener:e=>(y(e),Q),clear:()=>(m(O),m(T),u(k)||$(k),k=void 0,f=0,K(),Q),destroy:()=>{h.delListener(A)},getListenerStats:()=>({})};return S(Q.clear())}));export{z as createCheckpoints};
+const e=(e,n)=>e.includes(n),n=(e,n)=>e.forEach(n),t=e=>e.length,l=e=>0==t(e),r=(e,...n)=>e.push(...n),o=e=>e.pop(),s=e=>e.shift(),u=e=>null==e,i=(e,n,t)=>u(e)?null==t?void 0:t():n(e),d=(e,n)=>{var t;return null!=(t=null==e?void 0:e.has(n))&&t},c=e=>u(e)||0==(e=>e.size)(e),a=(e,n)=>null==e?void 0:e.forEach(n),h=(e,n)=>null==e?void 0:e.delete(n),p=e=>new Map(e),v=(e,n)=>null==e?void 0:e.get(n),C=(e,n,t)=>u(t)?(h(e,n),e):null==e?void 0:e.set(n,t),g=(e,n,t)=>(d(e,n)||C(e,n,t()),v(e,n)),k=(e,n,l,r,o=0)=>i((l?g:v)(e,n[o],o>t(n)-2?l:p),(s=>{if(o>t(n)-2)return(null==r?void 0:r(s))&&C(e,n[o]),s;const u=k(s,n,l,r,o+1);return c(s)&&C(e,n[o]),u})),f=e=>new Set(Array.isArray(e)||u(e)?e:[e]),L=/^\d+$/,w=e=>{let l;const[o,d]=(()=>{const e=[];let n=0;return[()=>{var t;return null!=(t=s(e))?t:""+n++},n=>{L.test(n)&&t(e)<1e3&&r(e,n)}]})(),g=p();return[(n,t,r)=>{null!=l||(l=e());const s=o();var u,i;return C(g,s,[n,t,r]),u=k(t,null!=r?r:[""],f),i=s,null==u||u.add(i),s},(e,o,...s)=>n(((e,l=[""])=>{const o=[],s=(e,u)=>u==t(l)?r(o,e):null===l[u]?a(e,(e=>s(e,u+1))):n([l[u],null],(n=>s(v(e,n),u+1)));return s(e,0),o})(e,o),(e=>a(e,(e=>v(g,e)[0](l,...null!=o?o:[],...s))))),e=>i(v(g,e),(([,n,t])=>(k(n,null!=t?t:[""],void 0,(n=>(h(n,e),c(n)?1:0))),C(g,e),d(e),t))),(e,r,o)=>i(v(g,e),(([e,,s=[]])=>{const i=(...d)=>{const c=t(d);c==t(s)?e(l,...d,...o(d)):u(s[c])?n(r[c](...d),(e=>i(...d,e))):i(...d,s[c])};i()}))]},S=Object.freeze,y=(e=>{const n=new WeakMap;return t=>(n.has(t)||n.set(t,e(t)),n.get(t))})((h=>{let k,f,L,y=100,z=p(),E=1;const A=p(),I=p(),[M,b,j]=w((()=>Q)),x=p(),B=p(),F=[],O=[],T=(e,n)=>{E=0,h.transaction((()=>a(v(x,n),((n,t)=>a(n,((n,l)=>a(n,((n,r)=>((e,n,t,l,r)=>u(r)?e.delCell(n,t,l,!0):e.setCell(n,t,l,r))(h,t,l,r,n[e]))))))))),E=1},W=e=>{C(x,e),C(B,e),b(I,[e])},$=(e,l)=>n(((e,n)=>e.splice(0,n))(e,null!=l?l:t(e)),W),m=()=>$(F,t(F)-y),q=h.addCellListener(null,null,null,((e,n,t,l,s,u)=>{if(E){i(k,(()=>{r(F,k),m(),$(O),k=void 0,L=1}));const e=g(z,n,p),d=g(e,t,p),a=g(d,l,(()=>[u,void 0]));a[1]=s,a[0]===s&&c(C(d,l))&&c(C(e,t))&&c(C(z,n))&&(k=o(F),L=1),J()}})),D=(e="")=>(u(k)&&(k=""+f++,C(x,k,z),N(k,e),z=p(),L=1),k),G=()=>{l(F)||(O.unshift(D()),T(0,k),k=o(F),L=1)},H=()=>{l(O)||(r(F,k),k=s(O),T(1,k),L=1)},J=()=>{L&&(b(A),L=0)},K=e=>{const n=D(e);return J(),n},N=(e,n)=>(P(e)&&v(B,e)!==n&&(C(B,e,n),b(I,[e])),Q),P=e=>d(x,e),Q={setSize:e=>(y=e,m(),Q),addCheckpoint:K,setCheckpoint:N,getStore:()=>h,getCheckpointIds:()=>[[...F],k,[...O]],forEachCheckpoint:e=>{return n=e,a(B,((e,t)=>n(t,e)));var n},hasCheckpoint:P,getCheckpoint:e=>v(B,e),goBackward:()=>(G(),J(),Q),goForward:()=>(H(),J(),Q),goTo:n=>{const t=e(F,n)?G:e(O,n)?H:null;for(;!u(t)&&n!=k;)t();return J(),Q},addCheckpointIdsListener:e=>M(e,A),addCheckpointListener:(e,n)=>M(n,I,[e]),delListener:e=>(j(e),Q),clear:()=>($(F),$(O),u(k)||W(k),k=void 0,f=0,K(),Q),destroy:()=>{h.delListener(q)},getListenerStats:()=>({})};return S(Q.clear())}));export{y as createCheckpoints};