tinybase 1.0.1 → 1.0.2

package/lib/checkpoints.js

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

package/lib/common.d.ts

@@ -1,115 +0,0 @@
-/**
- * The common module of the TinyBase project provides a small collection of
- * common types used across other modules.
- *
- * @packageDocumentation
- * @module common
- */
-
-/**
- * The Json type is a simple alias for a string, but is used to indicate that
- * the string should be considered to be a JSON serialization of an object.
- *
- * @category General
- */
-export type Json = string;
-
-/**
- * The Ids type is a simple alias for an array of strings, but is used to
- * indicate that the strings should be considered to be the keys of objects
- * (such as the Row Id strings used in a Table).
- *
- * @category Identity
- */
-export type Ids = Id[];
-
-/**
- * The Id type is a simple alias for a string, but is used to indicate that the
- * string should be considered to be the key of an object (such as a Row Id
- * string used in a Table).
- *
- * @category Identity
- */
-export type Id = string;
-
-/**
- * The Id type is a simple alias for the union of a string or `null` value,
- * where the string should be considered to be the key of an objects (such as a
- * Row Id string used in a Table), and typically `null` indicates a wildcard -
- * such as when used in the Store addRowListener method.
- *
- * @category Identity
- */
-export type IdOrNull = Id | null;
-
-/**
- * The ParameterizedCallback type represents a generic function that will take
- * an optional parameter - such as the handler of a DOM event.
- *
- * @category Callback
- */
-export type ParameterizedCallback<Parameter> = (parameter?: Parameter) => void;
-
-/**
- * The Callback type represents a function that is used as a callback and which
- * does not take a parameter.
- *
- * @category Callback
- */
-export type Callback = () => void;
-
-/**
- * The SortKey type represents a value that can be used by a sort function.
- *
- * @category Parameter
- */
-export type SortKey = string | number | boolean;
-
-/**
- * The defaultSorter function is provided as a convenience to sort keys
- * alphanumerically, and can be provided to the `sliceIdSorter` and
- * `rowIdSorter` parameters of the setIndexDefinition method in the indexes
- * module, for example.
- *
- * @param sortKey1 The first item of the pair to compare.
- * @param sortKey2 The second item of the pair to compare.
- * @returns A number indicating how to sort the pair.
- * @example
- * This example creates an Indexes object.
- *
- * ```js
- * const store = createStore();
- * const indexes = createIndexes(store);
- * console.log(indexes.getIndexIds());
- * // -> []
- * ```
- * @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 using the defaultSorter function.
- *
- * ```js
- * const store = createStore().setTable('pets', {
- *   fido: {species: 'dog'},
- *   felix: {species: 'cat'},
- *   cujo: {species: 'dog'},
- * });
- *
- * const indexes = createIndexes(store);
- * indexes.setIndexDefinition(
- *   'byFirst', //              indexId
- *   'pets', //                 tableId
- *   (_, rowId) => rowId[0], // each Row's Slice Id
- *   (_, rowId) => rowId, //    each Row's sort key
- *   defaultSorter, //          sort Slice Ids
- *   defaultSorter, //          sort Row Ids by sort key
- * );
- *
- * console.log(indexes.getSliceIds('byFirst'));
- * // -> ['c', 'f']
- * console.log(indexes.getSliceRowIds('byFirst', 'f'));
- * // -> ['felix', 'fido']
- * ```
- * @category Convenience
- */
-export function defaultSorter(sortKey1: SortKey, sortKey2: SortKey): number;

package/lib/common.js

@@ -1 +0,0 @@
-const o=(o,t)=>o<t?-1:1;export{o as defaultSorter};

package/lib/debug/checkpoints.js

@@ -1,326 +0,0 @@
-const arrayHas = (array, value) => array.includes(value);
-const arrayForEach = (array, cb) => array.forEach(cb);
-const arrayLength = (array) => array.length;
-const arrayIsEmpty = (array) => arrayLength(array) == 0;
-const arrayReduce = (array, cb, initial) => array.reduce(cb, initial);
-const arrayFromSecond = (ids) => ids.slice(1);
-const arrayClear = (array, to) => array.splice(0, to);
-
-const isUndefined = (thing) => thing == void 0;
-const ifNotUndefined = (value, then, otherwise) =>
-  isUndefined(value) ? otherwise?.() : then(value);
-
-const collSizeN = (collSizer) => (coll) =>
-  arrayReduce(collValues(coll), (total, coll2) => total + collSizer(coll2), 0);
-const collSize = (coll) => coll.size;
-const collSize2 = collSizeN(collSize);
-const collHas = (coll, keyOrValue) => coll?.has(keyOrValue) ?? false;
-const collIsEmpty = (coll) => isUndefined(coll) || collSize(coll) == 0;
-const collValues = (coll) => [...(coll?.values() ?? [])];
-const collForEach = (coll, cb) => coll?.forEach(cb);
-const collDel = (coll, keyOrValue) => coll?.delete(keyOrValue);
-
-const mapNew = (entries) => new Map(entries);
-const mapGet = (map, key) => map?.get(key);
-const mapSet = (map, key, value) =>
-  isUndefined(value) ? (collDel(map, key), map) : map?.set(key, value);
-const mapEnsure = (map, key, defaultValue, onWillAdd) => {
-  if (!collHas(map, key)) {
-    onWillAdd?.(defaultValue);
-    map.set(key, defaultValue);
-  }
-  return mapGet(map, key);
-};
-
-const setNew = (entries) => new Set(entries);
-const setAdd = (set, value) => set?.add(value);
-
-const getCreateFunction = (getFunction) => {
-  const getFunctionsByStore = /* @__PURE__ */ new WeakMap();
-  return (store) => {
-    if (!getFunctionsByStore.has(store)) {
-      getFunctionsByStore.set(store, getFunction(store));
-    }
-    return getFunctionsByStore.get(store);
-  };
-};
-
-const addDeepSet = (deepSet, value, ids) =>
-  arrayLength(ids) < 2
-    ? setAdd(
-        arrayIsEmpty(ids) ? deepSet : mapEnsure(deepSet, ids[0], setNew()),
-        value,
-      )
-    : addDeepSet(
-        mapEnsure(deepSet, ids[0], mapNew()),
-        value,
-        arrayFromSecond(ids),
-      );
-const forDeepSet = (valueDo) => {
-  const deep = (deepIdSet, arg, ...ids) =>
-    ifNotUndefined(deepIdSet, (deepIdSet2) =>
-      arrayIsEmpty(ids)
-        ? valueDo(deepIdSet2, arg)
-        : arrayForEach([ids[0], null], (id) =>
-            deep(mapGet(deepIdSet2, id), arg, ...arrayFromSecond(ids)),
-          ),
-    );
-  return deep;
-};
-const getListenerFunctions = (getThing) => {
-  let thing;
-  let nextId = 0;
-  const listenerPool = [];
-  const allListeners = mapNew();
-  const addListener = (listener, deepSet, idOrNulls = []) => {
-    thing ??= getThing();
-    const id = listenerPool.pop() ?? '' + nextId++;
-    mapSet(allListeners, id, [listener, deepSet, idOrNulls]);
-    addDeepSet(deepSet, id, idOrNulls);
-    return id;
-  };
-  const callListeners = (deepSet, ids = [], ...extraArgs) =>
-    forDeepSet(collForEach)(
-      deepSet,
-      (id) =>
-        ifNotUndefined(mapGet(allListeners, id), ([listener]) =>
-          listener(thing, ...ids, ...extraArgs),
-        ),
-      ...ids,
-    );
-  const delListener = (id) =>
-    ifNotUndefined(
-      mapGet(allListeners, id),
-      ([, deepSet, idOrNulls]) => {
-        forDeepSet(collDel)(deepSet, id, ...idOrNulls);
-        mapSet(allListeners, id);
-        if (arrayLength(listenerPool) < 1e3) {
-          listenerPool.push(id);
-        }
-        return idOrNulls;
-      },
-      () => [],
-    );
-  const callListener = (id, idNullGetters, extraArgsGetter) =>
-    ifNotUndefined(mapGet(allListeners, id), ([listener, , idOrNulls]) => {
-      const callWithIds = (...ids) => {
-        const index = arrayLength(ids);
-        index == arrayLength(idOrNulls)
-          ? listener(thing, ...ids, ...extraArgsGetter(ids))
-          : isUndefined(idOrNulls[index])
-          ? arrayForEach(idNullGetters[index](...ids), (id2) =>
-              callWithIds(...ids, id2),
-            )
-          : callWithIds(...ids, idOrNulls[index]);
-      };
-      callWithIds();
-    });
-  return [addListener, callListeners, delListener, callListener];
-};
-
-const object = Object;
-const objFreeze = object.freeze;
-
-const createCheckpoints = getCreateFunction((store) => {
-  let backwardIdsSize = 100;
-  let currentId;
-  let delta = mapNew();
-  let listening = 1;
-  let nextCheckpointId;
-  let checkpointsChanged;
-  const checkpointIdsListeners = setNew();
-  const checkpointListeners = mapNew();
-  const [addListener, callListeners, delListenerImpl] = getListenerFunctions(
-    () => checkpoints,
-  );
-  const deltas = mapNew();
-  const labels = mapNew();
-  const backwardIds = [];
-  const forwardIds = [];
-  const updateStore = (oldOrNew, checkpointId) => {
-    listening = 0;
-    store.transaction(() =>
-      collForEach(mapGet(deltas, checkpointId), (table, tableId) =>
-        collForEach(table, (row, rowId) =>
-          collForEach(row, (oldNew, cellId) =>
-            isUndefined(oldNew[oldOrNew])
-              ? store.delCell(tableId, rowId, cellId, true)
-              : store.setCell(tableId, rowId, cellId, oldNew[oldOrNew]),
-          ),
-        ),
-      ),
-    );
-    listening = 1;
-  };
-  const clearCheckpointId = (checkpointId) => {
-    mapSet(deltas, checkpointId);
-    mapSet(labels, checkpointId);
-    callListeners(checkpointListeners, [checkpointId]);
-  };
-  const clearCheckpointIds = (checkpointIds, to) =>
-    arrayForEach(
-      arrayClear(checkpointIds, to ?? arrayLength(checkpointIds)),
-      clearCheckpointId,
-    );
-  const trimBackwardsIds = () =>
-    clearCheckpointIds(backwardIds, arrayLength(backwardIds) - backwardIdsSize);
-  const listenerId = store.addCellListener(
-    null,
-    null,
-    null,
-    (_store, tableId, rowId, cellId, newCell, oldCell) => {
-      if (listening) {
-        ifNotUndefined(currentId, () => {
-          backwardIds.push(currentId);
-          trimBackwardsIds();
-          clearCheckpointIds(forwardIds);
-          currentId = void 0;
-          checkpointsChanged = 1;
-        });
-        const table = mapEnsure(delta, tableId, mapNew());
-        const row = mapEnsure(table, rowId, mapNew());
-        const oldNew = mapEnsure(
-          row,
-          cellId,
-          [void 0, void 0],
-          (addOldNew) => (addOldNew[0] = oldCell),
-        );
-        oldNew[1] = newCell;
-        if (oldNew[0] === oldNew[1]) {
-          if (collIsEmpty(mapSet(row, cellId))) {
-            if (collIsEmpty(mapSet(table, rowId))) {
-              if (collIsEmpty(mapSet(delta, tableId))) {
-                currentId = backwardIds.pop();
-                checkpointsChanged = 1;
-              }
-            }
-          }
-        }
-        callListenersIfChanged();
-      }
-    },
-  );
-  const addCheckpointImpl = (label = '') => {
-    if (isUndefined(currentId)) {
-      currentId = '' + nextCheckpointId++;
-      mapSet(deltas, currentId, delta);
-      setCheckpoint(currentId, label);
-      delta = mapNew();
-      checkpointsChanged = 1;
-    }
-    return currentId;
-  };
-  const goBackwardImpl = () => {
-    if (!arrayIsEmpty(backwardIds)) {
-      forwardIds.unshift(addCheckpointImpl());
-      updateStore(0, currentId);
-      currentId = backwardIds.pop();
-      checkpointsChanged = 1;
-    }
-  };
-  const goForwardImpl = () => {
-    if (!arrayIsEmpty(forwardIds)) {
-      backwardIds.push(currentId);
-      currentId = forwardIds.shift();
-      updateStore(1, currentId);
-      checkpointsChanged = 1;
-    }
-  };
-  const callListenersIfChanged = () => {
-    if (checkpointsChanged) {
-      callListeners(checkpointIdsListeners);
-      checkpointsChanged = 0;
-    }
-  };
-  const setSize = (size) => {
-    backwardIdsSize = size;
-    trimBackwardsIds();
-    return checkpoints;
-  };
-  const addCheckpoint = (label) => {
-    const id = addCheckpointImpl(label);
-    callListenersIfChanged();
-    return id;
-  };
-  const setCheckpoint = (checkpointId, label) => {
-    if (
-      collHas(deltas, checkpointId) &&
-      mapGet(labels, checkpointId) !== label
-    ) {
-      mapSet(labels, checkpointId, label);
-      callListeners(checkpointListeners, [checkpointId]);
-    }
-    return checkpoints;
-  };
-  const getStore = () => store;
-  const getCheckpointIds = () => [[...backwardIds], currentId, [...forwardIds]];
-  const getCheckpoint = (checkpointId) => mapGet(labels, checkpointId);
-  const goBackward = () => {
-    goBackwardImpl();
-    callListenersIfChanged();
-    return checkpoints;
-  };
-  const goForward = () => {
-    goForwardImpl();
-    callListenersIfChanged();
-    return checkpoints;
-  };
-  const goTo = (checkpointId) => {
-    const action = arrayHas(backwardIds, checkpointId)
-      ? goBackwardImpl
-      : arrayHas(forwardIds, checkpointId)
-      ? goForwardImpl
-      : null;
-    while (!isUndefined(action) && checkpointId != currentId) {
-      action();
-    }
-    callListenersIfChanged();
-    return checkpoints;
-  };
-  const addCheckpointIdsListener = (listener) =>
-    addListener(listener, checkpointIdsListeners);
-  const addCheckpointListener = (checkpointId, listener) =>
-    addListener(listener, checkpointListeners, [checkpointId]);
-  const delListener = (listenerId2) => {
-    delListenerImpl(listenerId2);
-    return checkpoints;
-  };
-  const clear = () => {
-    clearCheckpointIds(backwardIds);
-    clearCheckpointIds(forwardIds);
-    if (!isUndefined(currentId)) {
-      clearCheckpointId(currentId);
-    }
-    currentId = void 0;
-    nextCheckpointId = 0;
-    addCheckpoint();
-    return checkpoints;
-  };
-  const destroy = () => {
-    store.delListener(listenerId);
-  };
-  const getListenerStats = () => ({
-    checkpointIds: collSize(checkpointIdsListeners),
-    checkpoint: collSize2(checkpointListeners),
-  });
-  const checkpoints = {
-    setSize,
-    addCheckpoint,
-    setCheckpoint,
-    getStore,
-    getCheckpointIds,
-    getCheckpoint,
-    goBackward,
-    goForward,
-    goTo,
-    addCheckpointIdsListener,
-    addCheckpointListener,
-    delListener,
-    clear,
-    destroy,
-    getListenerStats,
-  };
-  return objFreeze(checkpoints.clear());
-});
-
-export {createCheckpoints};

package/lib/debug/common.js

@@ -1,3 +0,0 @@
-const defaultSorter = (sortKey1, sortKey2) => (sortKey1 < sortKey2 ? -1 : 1);
-
-export {defaultSorter};