aberdeen 0.2.4 → 0.5.0

package/dist/prediction.js

@@ -1,110 +1,94 @@
-import { withEmitHandler } from 'aberdeen';
+// src/prediction.ts
+import { withEmitHandler, defaultEmitHandler } from "./aberdeen.js";
 function recordPatch(func) {
-    const recordingPatch = new Map();
-    withEmitHandler(function (index, newData, oldData) {
-        addToPatch(recordingPatch, this, index, newData, oldData);
-    }, func);
-    return recordingPatch;
+  const recordingPatch = new Map;
+  withEmitHandler(function(target, index, newData, oldData) {
+    addToPatch(recordingPatch, target, index, newData, oldData);
+  }, func);
+  return recordingPatch;
 }
 function addToPatch(patch, collection, index, newData, oldData) {
-    let collectionMap = patch.get(collection);
-    if (!collectionMap) {
-        collectionMap = new Map();
-        patch.set(collection, collectionMap);
-    }
-    let prev = collectionMap.get(index);
-    if (prev)
-        oldData = prev[1];
-    if (newData === oldData)
-        collectionMap.delete(index);
-    else
-        collectionMap.set(index, [newData, oldData]);
+  let collectionMap = patch.get(collection);
+  if (!collectionMap) {
+    collectionMap = new Map;
+    patch.set(collection, collectionMap);
+  }
+  let prev = collectionMap.get(index);
+  if (prev)
+    oldData = prev[1];
+  if (newData === oldData)
+    collectionMap.delete(index);
+  else
+    collectionMap.set(index, [newData, oldData]);
 }
 function emitPatch(patch) {
-    for (let [collection, collectionMap] of patch) {
-        for (let [index, [newData, oldData]] of collectionMap) {
-            collection.emitChange(index, newData, oldData);
-        }
+  for (let [collection, collectionMap] of patch) {
+    for (let [index, [newData, oldData]] of collectionMap) {
+      defaultEmitHandler(collection, index, newData, oldData);
     }
+  }
 }
 function mergePatch(target, source, reverse = false) {
-    for (let [collection, collectionMap] of source) {
-        for (let [index, [newData, oldData]] of collectionMap) {
-            addToPatch(target, collection, index, reverse ? oldData : newData, reverse ? newData : oldData);
-        }
+  for (let [collection, collectionMap] of source) {
+    for (let [index, [newData, oldData]] of collectionMap) {
+      addToPatch(target, collection, index, reverse ? oldData : newData, reverse ? newData : oldData);
     }
+  }
 }
 function silentlyApplyPatch(patch, force = false) {
-    for (let [collection, collectionMap] of patch) {
-        for (let [index, [newData, oldData]] of collectionMap) {
-            let actualData = collection.rawGet(index);
-            if (actualData !== oldData) {
-                if (force)
-                    setTimeout(() => { throw new Error(`Applying invalid patch: data ${actualData} is unequal to expected old data ${oldData} for index ${index}`); }, 0);
-                else
-                    return false;
-            }
-        }
+  for (let [collection, collectionMap] of patch) {
+    for (let [index, [newData, oldData]] of collectionMap) {
+      let actualData = collection[index];
+      if (actualData !== oldData) {
+        if (force)
+          setTimeout(() => {
+            throw new Error(`Applying invalid patch: data ${actualData} is unequal to expected old data ${oldData} for index ${index}`);
+          }, 0);
+        else
+          return false;
+      }
     }
-    for (let [collection, collectionMap] of patch) {
-        for (let [index, [newData, oldData]] of collectionMap) {
-            collection.rawSet(index, newData);
-        }
+  }
+  for (let [collection, collectionMap] of patch) {
+    for (let [index, [newData, oldData]] of collectionMap) {
+      collection[index] = newData;
     }
-    return true;
+  }
+  return true;
 }
-const appliedPredictions = [];
-/**
- * Run the provided function, while treating all changes to Observables as predictions,
- * meaning they will be reverted when changes come back from the server (or some other
- * async source).
- * @param predictFunc The function to run. It will generally modify some Observables
- * 	to immediately reflect state (as closely as possible) that we expect the server
- *  to communicate back to us later on.
- * @returns A `Patch` object. Don't modify it. This is only meant to be passed to `applyCanon`.
- */
-export function applyPrediction(predictFunc) {
-    let patch = recordPatch(predictFunc);
-    appliedPredictions.push(patch);
-    emitPatch(patch);
-    return patch;
+var appliedPredictions = [];
+function applyPrediction(predictFunc) {
+  let patch = recordPatch(predictFunc);
+  appliedPredictions.push(patch);
+  emitPatch(patch);
+  return patch;
 }
-/**
- * Temporarily revert all outstanding predictions, optionally run the provided function
- * (which will generally make authoritative changes to the data based on a server response),
- * and then attempt to reapply the predictions on top of the new canonical state, dropping
- * any predictions that can no longer be applied cleanly (the data has been modified) or
- * that were specified in `dropPredictions`.
- *
- * All of this is done such that redraws are only triggered if the overall effect is an
- * actual change to an `Observable`.
- * @param canonFunc The function to run without any predictions applied. This will typically
- *  make authoritative changes to the data, based on a server response.
- * @param dropPredictions An optional list of predictions (as returned by `applyPrediction`)
- *  to undo. Typically, when a server response for a certain request is being handled,
- *  you'd want to drop the prediction that was done for that request.
- */
-export function applyCanon(canonFunc, dropPredictions = []) {
-    let resultPatch = new Map();
-    for (let prediction of appliedPredictions)
-        mergePatch(resultPatch, prediction, true);
-    silentlyApplyPatch(resultPatch, true);
-    for (let prediction of dropPredictions) {
-        let pos = appliedPredictions.indexOf(prediction);
-        if (pos >= 0)
-            appliedPredictions.splice(pos, 1);
-    }
-    if (canonFunc)
-        mergePatch(resultPatch, recordPatch(canonFunc));
-    for (let idx = 0; idx < appliedPredictions.length; idx++) {
-        if (silentlyApplyPatch(appliedPredictions[idx])) {
-            mergePatch(resultPatch, appliedPredictions[idx]);
-        }
-        else {
-            appliedPredictions.splice(idx, 1);
-            idx--;
-        }
+function applyCanon(canonFunc, dropPredictions = []) {
+  let resultPatch = new Map;
+  for (let prediction of appliedPredictions)
+    mergePatch(resultPatch, prediction, true);
+  silentlyApplyPatch(resultPatch, true);
+  for (let prediction of dropPredictions) {
+    let pos = appliedPredictions.indexOf(prediction);
+    if (pos >= 0)
+      appliedPredictions.splice(pos, 1);
+  }
+  if (canonFunc)
+    mergePatch(resultPatch, recordPatch(canonFunc));
+  for (let idx = 0;idx < appliedPredictions.length; idx++) {
+    if (silentlyApplyPatch(appliedPredictions[idx])) {
+      mergePatch(resultPatch, appliedPredictions[idx]);
+    } else {
+      appliedPredictions.splice(idx, 1);
+      idx--;
     }
-    emitPatch(resultPatch);
+  }
+  emitPatch(resultPatch);
 }
-//# sourceMappingURL=prediction.js.map
+export {
+  applyPrediction,
+  applyCanon
+};
+
+//# debugId=64BCD82AC2BC0BA664756E2164756E21
+//# sourceMappingURL=prediction.js.map

package/dist/prediction.js.map

@@ -1 +1,10 @@
-{"version":3,"file":"prediction.js","sourceRoot":"","sources":["../src/prediction.ts"],"names":[],"mappings":"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"}
+{
+  "version": 3,
+  "sources": ["../src/prediction.ts"],
+  "sourcesContent": [
+    "import {withEmitHandler, defaultEmitHandler} from './aberdeen.js'\nimport type { DatumType, TargetType } from './aberdeen.js';\n\n/** \n * Represents a set of changes that can be applied to proxied objects.\n * This is an opaque type - its internal structure is not part of the public API.\n * @private\n */\nexport type Patch = Map<TargetType, Map<any, [DatumType, DatumType]>>;\n\n\nfunction recordPatch(func: () => void): Patch {\n\tconst recordingPatch = new Map()\n\twithEmitHandler(function(target, index, newData, oldData) {\n\t\taddToPatch(recordingPatch, target, index, newData, oldData)\n\t}, func)\n\treturn recordingPatch\n}\n\nfunction addToPatch(patch: Patch, collection: TargetType, index: any, newData: DatumType, oldData: DatumType) {\n\tlet collectionMap = patch.get(collection)\n\tif (!collectionMap) {\n\t\tcollectionMap = new Map()\n\t\tpatch.set(collection, collectionMap)\n\t}\n\tlet prev = collectionMap.get(index)\n\tif (prev) oldData = prev[1]\n\tif (newData === oldData) collectionMap.delete(index)\n\telse collectionMap.set(index, [newData, oldData])\n}\n\nfunction emitPatch(patch: Patch) {\n\tfor(let [collection, collectionMap] of patch) {\n\t\tfor(let [index, [newData, oldData]] of collectionMap) {\n\t\t\tdefaultEmitHandler(collection, index, newData, oldData);\n\t\t}\n\t}\n}\n\nfunction mergePatch(target: Patch, source: Patch, reverse: boolean = false) {\n\tfor(let [collection, collectionMap] of source) {\n\t\tfor(let [index, [newData, oldData]] of collectionMap) {\n\t\t\taddToPatch(target, collection, index, reverse ? oldData : newData, reverse ? newData : oldData)\n\t\t}\n\t}\n}\n\nfunction silentlyApplyPatch(patch: Patch, force: boolean = false): boolean {\n\tfor(let [collection, collectionMap] of patch) {\n\t\tfor(let [index, [newData, oldData]] of collectionMap) {\n\t\t\tlet actualData = (collection as any)[index]\n\t\t\tif (actualData !== oldData) {\n\t\t\t\tif (force) setTimeout(() => { throw new Error(`Applying invalid patch: data ${actualData} is unequal to expected old data ${oldData} for index ${index}`)}, 0)\n\t\t\t\telse return false\n\t\t\t}\n\t\t}\n\t}\n\tfor(let [collection, collectionMap] of patch) {\n\t\tfor(let [index, [newData, oldData]] of collectionMap) {\n\t\t\t(collection as any)[index] = newData\n\t\t}\n\t}\n\treturn true\n}\n\n\nconst appliedPredictions: Array<Patch> = []\n\n/**\n * Run the provided function, while treating all changes to Observables as predictions,\n * meaning they will be reverted when changes come back from the server (or some other\n * async source).\n * @param predictFunc The function to run. It will generally modify some Observables\n * \tto immediately reflect state (as closely as possible) that we expect the server\n *  to communicate back to us later on.\n * @returns A `Patch` object. Don't modify it. This is only meant to be passed to `applyCanon`.\n */\nexport function applyPrediction(predictFunc: () => void): Patch {\n\tlet patch = recordPatch(predictFunc)\n\tappliedPredictions.push(patch)\n\temitPatch(patch)\n\treturn patch\n}\n\n/**\n * Temporarily revert all outstanding predictions, optionally run the provided function\n * (which will generally make authoritative changes to the data based on a server response),\n * and then attempt to reapply the predictions on top of the new canonical state, dropping \n * any predictions that can no longer be applied cleanly (the data has been modified) or\n * that were specified in `dropPredictions`.\n * \n * All of this is done such that redraws are only triggered if the overall effect is an\n * actual change to an `Observable`.\n * @param canonFunc The function to run without any predictions applied. This will typically\n *  make authoritative changes to the data, based on a server response.\n * @param dropPredictions An optional list of predictions (as returned by `applyPrediction`)\n *  to undo. Typically, when a server response for a certain request is being handled,\n *  you'd want to drop the prediction that was done for that request.\n */\nexport function applyCanon(canonFunc?: (() => void), dropPredictions: Array<Patch> = []) {\n\t\n\tlet resultPatch = new Map()\n\tfor(let prediction of appliedPredictions) mergePatch(resultPatch, prediction, true)\n\tsilentlyApplyPatch(resultPatch, true)\n\n\tfor(let prediction of dropPredictions) {\n\t\tlet pos = appliedPredictions.indexOf(prediction)\n\t\tif (pos >= 0) appliedPredictions.splice(pos, 1)\n\t}\n\tif (canonFunc) mergePatch(resultPatch, recordPatch(canonFunc))\n\n\tfor(let idx=0; idx<appliedPredictions.length; idx++) {\n\t\tif (silentlyApplyPatch(appliedPredictions[idx])) {\n\t\t\tmergePatch(resultPatch, appliedPredictions[idx])\n\t\t} else {\n\t\t\tappliedPredictions.splice(idx, 1)\n\t\t\tidx--\n\t\t}\n\t}\n\n\temitPatch(resultPatch)\n}\n"
+  ],
+  "mappings": ";AAAA;AAWA,SAAS,WAAW,CAAC,MAAyB;AAAA,EAC7C,MAAM,iBAAiB,IAAI;AAAA,EAC3B,gBAAgB,QAAQ,CAAC,QAAQ,OAAO,SAAS,SAAS;AAAA,IACzD,WAAW,gBAAgB,QAAQ,OAAO,SAAS,OAAO;AAAA,KACxD,IAAI;AAAA,EACP,OAAO;AAAA;AAGR,SAAS,UAAU,CAAC,OAAc,YAAwB,OAAY,SAAoB,SAAoB;AAAA,EAC7G,IAAI,gBAAgB,MAAM,IAAI,UAAU;AAAA,EACxC,KAAK,eAAe;AAAA,IACnB,gBAAgB,IAAI;AAAA,IACpB,MAAM,IAAI,YAAY,aAAa;AAAA,EACpC;AAAA,EACA,IAAI,OAAO,cAAc,IAAI,KAAK;AAAA,EAClC,IAAI;AAAA,IAAM,UAAU,KAAK;AAAA,EACzB,IAAI,YAAY;AAAA,IAAS,cAAc,OAAO,KAAK;AAAA,EAC9C;AAAA,kBAAc,IAAI,OAAO,CAAC,SAAS,OAAO,CAAC;AAAA;AAGjD,SAAS,SAAS,CAAC,OAAc;AAAA,EAChC,UAAS,YAAY,kBAAkB,OAAO;AAAA,IAC7C,UAAS,QAAQ,SAAS,aAAa,eAAe;AAAA,MACrD,mBAAmB,YAAY,OAAO,SAAS,OAAO;AAAA,IACvD;AAAA,EACD;AAAA;AAGD,SAAS,UAAU,CAAC,QAAe,QAAe,UAAmB,OAAO;AAAA,EAC3E,UAAS,YAAY,kBAAkB,QAAQ;AAAA,IAC9C,UAAS,QAAQ,SAAS,aAAa,eAAe;AAAA,MACrD,WAAW,QAAQ,YAAY,OAAO,UAAU,UAAU,SAAS,UAAU,UAAU,OAAO;AAAA,IAC/F;AAAA,EACD;AAAA;AAGD,SAAS,kBAAkB,CAAC,OAAc,QAAiB,OAAgB;AAAA,EAC1E,UAAS,YAAY,kBAAkB,OAAO;AAAA,IAC7C,UAAS,QAAQ,SAAS,aAAa,eAAe;AAAA,MACrD,IAAI,aAAc,WAAmB;AAAA,MACrC,IAAI,eAAe,SAAS;AAAA,QAC3B,IAAI;AAAA,UAAO,WAAW,MAAM;AAAA,YAAE,MAAM,IAAI,MAAM,gCAAgC,8CAA8C,qBAAqB,OAAO;AAAA,aAAI,CAAC;AAAA,QACxJ;AAAA,iBAAO;AAAA,MACb;AAAA,IACD;AAAA,EACD;AAAA,EACA,UAAS,YAAY,kBAAkB,OAAO;AAAA,IAC7C,UAAS,QAAQ,SAAS,aAAa,eAAe;AAAA,MACpD,WAAmB,SAAS;AAAA,IAC9B;AAAA,EACD;AAAA,EACA,OAAO;AAAA;AAIR,IAAM,qBAAmC,CAAC;AAWnC,SAAS,eAAe,CAAC,aAAgC;AAAA,EAC/D,IAAI,QAAQ,YAAY,WAAW;AAAA,EACnC,mBAAmB,KAAK,KAAK;AAAA,EAC7B,UAAU,KAAK;AAAA,EACf,OAAO;AAAA;AAkBD,SAAS,UAAU,CAAC,WAA0B,kBAAgC,CAAC,GAAG;AAAA,EAExF,IAAI,cAAc,IAAI;AAAA,EACtB,SAAQ,cAAc;AAAA,IAAoB,WAAW,aAAa,YAAY,IAAI;AAAA,EAClF,mBAAmB,aAAa,IAAI;AAAA,EAEpC,SAAQ,cAAc,iBAAiB;AAAA,IACtC,IAAI,MAAM,mBAAmB,QAAQ,UAAU;AAAA,IAC/C,IAAI,OAAO;AAAA,MAAG,mBAAmB,OAAO,KAAK,CAAC;AAAA,EAC/C;AAAA,EACA,IAAI;AAAA,IAAW,WAAW,aAAa,YAAY,SAAS,CAAC;AAAA,EAE7D,SAAQ,MAAI,EAAG,MAAI,mBAAmB,QAAQ,OAAO;AAAA,IACpD,IAAI,mBAAmB,mBAAmB,IAAI,GAAG;AAAA,MAChD,WAAW,aAAa,mBAAmB,IAAI;AAAA,IAChD,EAAO;AAAA,MACN,mBAAmB,OAAO,KAAK,CAAC;AAAA,MAChC;AAAA;AAAA,EAEF;AAAA,EAEA,UAAU,WAAW;AAAA;",
+  "debugId": "64BCD82AC2BC0BA664756E2164756E21",
+  "names": []
+}

package/dist/route.d.ts

@@ -1,16 +1,47 @@
-import { Store } from 'aberdeen';
 /**
- * A `Store` object that holds the following keys:
- * - `path`: The current path of the URL split into components. For instance `/` or `/users/123/feed`. Updates will be reflected in the URL and will *push* a new entry to the browser history.
- * - `p`: Array containing the path segments. For instance `[]` or `['users', 123, 'feed']`. Updates will be reflected in the URL and will *push* a new entry to the browser history. Also, the values of `p` and `path` will be synced.
- * - `search`: An observable object containing search parameters (a split up query string). For instance `{order: "date", title: "something"}` or just `{}`. Updates will be reflected in the URL, modifying the current history state.
- * - `hash`: The document hash part of the URL. For instance `"#section-title"`. It can also be an empty string. Updates will be reflected in the URL, modifying the current history state.
- * - `state`: The browser history *state* object for the current page. Creating or removing top-level keys will cause *pushing* a new entry to the browser history.
+ * The class for the singleton `route` object.
  *
- * The following key may also be written to `route` but will be immediately and silently removed:
- * - `mode`: As described above, this library takes a best guess about whether pushing an item to the browser history makes sense or not. When `mode` is...
- * 	  	- `"push"`: Force creation of a new browser history entry.
- * 	  	- `"replace"`: Update the current history entry, even when updates to other keys would normally cause a *push*.
- * 		- `"back"`: Unwind the history (like repeatedly pressing the *back* button) until we find a page that matches the given `path`, `search` and top-level `state` keys, and then *replace* that state by the full given state.
  */
-export declare const route: Store;
+export declare class Route {
+    /** The current path of the URL split into components. For instance `/` or `/users/123/feed`. Updates will be reflected in the URL and will *push* a new entry to the browser history. */
+    path: string;
+    /** Array containing the path segments. For instance `[]` or `['users', 123, 'feed']`. Updates will be reflected in the URL and will *push* a new entry to the browser history. Also, the values of `p` and `path` will be synced. */
+    p: string[];
+    /** An observable object containing search parameters (a split up query string). For instance `{order: "date", title: "something"}` or just `{}`. By default, updates will be reflected in the URL, replacing the current history state. */
+    hash: string;
+    /** A part of the browser history *state* that is considered part of the page *identify*, meaning changes will (by default) cause a history push, and when going *back*, it must match. */
+    search: Record<string, string>;
+    /** The `hash` interpreted as search parameters. So `"a=x&b=y"` becomes `{a: "x", b: "y"}`. */
+    id: Record<string, any>;
+    /** The auxiliary part of the browser history *state*, not considered part of the page *identity*. Changes will be reflected in the browser history using a replace. */
+    aux: Record<string, any>;
+    /** The navigation depth of the current session. Starts at 1. Writing to this property has no effect. */
+    depth: number;
+    /** The navigation action that got us to this page. Writing to this property has no effect.
+        - `"load"`: An initial page load.
+        - `"back"` or `"forward"`: When we navigated backwards or forwards in the stack.
+        - `"push"`: When we added a new page on top of the stack.
+    */
+    nav: 'load' | 'back' | 'forward' | 'push';
+    /** As described above, this library takes a best guess about whether pushing an item to the browser history makes sense or not. When `mode` is...
+        - `"push"`: Force creation of a new browser history entry.
+        - `"replace"`: Update the current history entry, even when updates to other keys would normally cause a *push*.
+        - `"back"`: Unwind the history (like repeatedly pressing the *back* button) until we find a page that matches the given `path` and `id` (or that is the first page in our stack), and then *replace* that state by the full given state.
+        The `mode` key can be written to `route` but will be immediately and silently removed.
+    */
+    mode: 'push' | 'replace' | 'back' | undefined;
+}
+/**
+ * The singleton {@link Route} object reflecting the current URL and browser history state. You can make changes to it to affect the URL and browser history. See {@link Route} for details.
+ */
+export declare const route: Route;
+/**
+ * Restore and store the vertical and horizontal scroll position for
+ * the parent element to the page state.
+ *
+ * @param {string} name - A unique (within this page) name for this
+ * scrollable element. Defaults to 'main'.
+ *
+ * The scroll position will be persisted in `route.aux.scroll.<name>`.
+ */
+export declare function persistScroll(name?: string): void;

package/dist/route.js

@@ -1,129 +1,155 @@
-import { Store, observe, immediateObserve, inhibitEffects } from 'aberdeen';
-/**
- * A `Store` object that holds the following keys:
- * - `path`: The current path of the URL split into components. For instance `/` or `/users/123/feed`. Updates will be reflected in the URL and will *push* a new entry to the browser history.
- * - `p`: Array containing the path segments. For instance `[]` or `['users', 123, 'feed']`. Updates will be reflected in the URL and will *push* a new entry to the browser history. Also, the values of `p` and `path` will be synced.
- * - `search`: An observable object containing search parameters (a split up query string). For instance `{order: "date", title: "something"}` or just `{}`. Updates will be reflected in the URL, modifying the current history state.
- * - `hash`: The document hash part of the URL. For instance `"#section-title"`. It can also be an empty string. Updates will be reflected in the URL, modifying the current history state.
- * - `state`: The browser history *state* object for the current page. Creating or removing top-level keys will cause *pushing* a new entry to the browser history.
- *
- * The following key may also be written to `route` but will be immediately and silently removed:
- * - `mode`: As described above, this library takes a best guess about whether pushing an item to the browser history makes sense or not. When `mode` is...
- * 	  	- `"push"`: Force creation of a new browser history entry.
- * 	  	- `"replace"`: Update the current history entry, even when updates to other keys would normally cause a *push*.
- * 		- `"back"`: Unwind the history (like repeatedly pressing the *back* button) until we find a page that matches the given `path`, `search` and top-level `state` keys, and then *replace* that state by the full given state.
- */
-export const route = new Store();
-// Contains url (path+search) and state for all history entries for this session, with the current
-// entry on top. It is used for `mode: "back"`, to know how many entries to go back.
-let stack = [];
-// Keep track of the initial history length, so we'll always know how long our `stack` should be.
-const initialHistoryLength = history.length;
-// Keep a copy of the last known history state, so we can tell if the user changed one of its
-// top-level keys, so we can decide between push/replace when `mode` is not set.
-let prevHistoryState;
-// Reflect changes to the browser URL (back/forward navigation) in the `route` and `stack`.
+// src/route.ts
+import { getParentElement, runQueue, clean, proxy, observe, immediateObserve, unproxy, clone } from "./aberdeen.js";
+
+class Route {
+  path;
+  p;
+  hash;
+  search;
+  id;
+  aux;
+  depth = 1;
+  nav = "load";
+  mode;
+}
+var route = proxy(new Route);
+var stateRoute = {
+  nonce: -1,
+  depth: 0
+};
 function handleLocationUpdate(event) {
-    const search = {};
-    for (let [k, v] of new URLSearchParams(location.search)) {
-        search[k] = v;
-    }
-    prevHistoryState = event ? (event.state || {}) : {};
-    stack.length = Math.max(1, history.length - initialHistoryLength + 1);
-    stack[stack.length - 1] = { url: location.pathname + location.search, state: prevHistoryState };
-    route.set({
-        path: location.pathname,
-        p: location.pathname.slice(1).split('/'),
-        search: search,
-        hash: location.hash,
-        state: prevHistoryState,
-    });
+  let state = event?.state || {};
+  let nav = "load";
+  if (state.route?.nonce == null) {
+    state.route = {
+      nonce: Math.floor(Math.random() * Number.MAX_SAFE_INTEGER),
+      depth: 1
+    };
+    history.replaceState(state, "");
+  } else if (stateRoute.nonce === state.route.nonce) {
+    nav = state.route.depth > stateRoute.depth ? "forward" : "back";
+  }
+  stateRoute = state.route;
+  if (unproxy(route).mode === "back") {
+    route.depth = stateRoute.depth;
+    updateHistory();
+    return;
+  }
+  const search = {};
+  for (let [k, v] of new URLSearchParams(location.search)) {
+    search[k] = v;
+  }
+  route.path = location.pathname;
+  route.p = location.pathname.slice(1).split("/");
+  route.search = search;
+  route.hash = location.hash;
+  route.id = state.id;
+  route.aux = state.aux;
+  route.depth = stateRoute.depth;
+  route.nav = nav;
+  if (event)
+    runQueue();
 }
 handleLocationUpdate();
 window.addEventListener("popstate", handleLocationUpdate);
-// These immediate-mode observers will rewrite the data in `route` to its canonical form.
-// We want to to this immediately, so that user-code running immediately after a user-code
-// initiated `set` will see the canonical form (instead of doing a rerender shortly after,
-// or crashing due to non-canonical data).
 function updatePath() {
-    let path = route.get('path');
-    if (path == null && route.peek('p')) {
-        return updateP();
-    }
-    path = '' + path;
-    if (!path.startsWith('/'))
-        path = '/' + path;
-    route.set('path', path);
-    route.set('p', path.slice(1).split('/'));
+  let path = route.path;
+  if (path == null && unproxy(route).p) {
+    return updateP();
+  }
+  path = "" + (path || "/");
+  if (!path.startsWith("/"))
+    path = "/" + path;
+  route.path = path;
+  route.p = path.slice(1).split("/");
 }
 immediateObserve(updatePath);
 function updateP() {
-    const p = route.get('p');
-    console.log('imm p', p);
-    if (p == null && route.peek('path')) {
-        return updatePath();
-    }
-    if (!(p instanceof Array)) {
-        console.error(`aberdeen route: 'p' must be a non-empty array, not ${JSON.stringify(p)}`);
-        route.set('p', ['']); // This will cause a recursive call this observer.
-    }
-    else if (p.length == 0) {
-        route.set('p', ['']); // This will cause a recursive call this observer.
-    }
-    else {
-        route.set('path', '/' + p.join('/'));
-    }
+  const p = route.p;
+  if (p == null && unproxy(route).path) {
+    return updatePath();
+  }
+  if (!(p instanceof Array)) {
+    console.error(`aberdeen route: 'p' must be a non-empty array, not ${JSON.stringify(p)}`);
+    route.p = [""];
+  } else if (p.length == 0) {
+    route.p = [""];
+  } else {
+    route.path = "/" + p.join("/");
+  }
 }
 immediateObserve(updateP);
 immediateObserve(() => {
-    if (route.getType('search') !== 'object')
-        route.set('search', {});
+  if (!route.search || typeof route.search !== "object")
+    route.search = {};
 });
 immediateObserve(() => {
-    if (route.getType('state') !== 'object')
-        route.set('state', {});
+  if (!route.id || typeof route.id !== "object")
+    route.id = {};
 });
 immediateObserve(() => {
-    let hash = '' + (route.get('hash') || '');
-    if (hash && !hash.startsWith('#'))
-        hash = '#' + hash;
-    route.set('hash', hash);
+  if (!route.aux || typeof route.aux !== "object")
+    route.aux = {};
 });
-// This deferred-mode observer will update the URL and history based on `route` changes.
-observe(() => {
-    // Get and delete mode without triggering anything.
-    const mode = route.get('mode');
-    if (mode)
-        inhibitEffects(() => route.delete('mode'));
-    const state = route.get('state');
-    // Construct the URL.
-    const path = route.get('path');
-    const search = new URLSearchParams(route.get('search')).toString();
-    const url = (search ? path + '?' + search : path) + route.get('hash');
-    // Change browser state, according to `mode`.
-    if (mode === 'back') {
-        let goDelta = 0;
-        while (stack.length > 1) {
-            const item = stack[stack.length - 1];
-            if (item.url === url && JSON.stringify(Object.keys(state || {})) === JSON.stringify(Object.keys(item.state || {})))
-                break; // Found it!
-            goDelta--;
-            stack.pop();
-        }
-        if (goDelta)
-            history.go(goDelta);
-        // We'll replace the state async, to give the history.go the time to take affect first.
-        setTimeout(() => history.replaceState(state, '', url), 0);
-        stack[stack.length - 1] = { url, state };
-    }
-    else if (mode === 'push' || (!mode && (location.pathname !== path || JSON.stringify(Object.keys(state || {})) !== JSON.stringify(Object.keys(prevHistoryState || {}))))) {
-        history.pushState(state, '', url);
-        stack.push({ url, state });
-    }
-    else {
-        history.replaceState(state, '', url);
-        stack[stack.length - 1] = { url, state };
-    }
-    prevHistoryState = state;
+immediateObserve(() => {
+  let hash = "" + (route.hash || "");
+  if (hash && !hash.startsWith("#"))
+    hash = "#" + hash;
+  route.hash = hash;
 });
-//# sourceMappingURL=route.js.map
+function isSamePage(path, state) {
+  return location.pathname === path && JSON.stringify(history.state.id) === JSON.stringify(state.id);
+}
+function updateHistory() {
+  let mode = route.mode;
+  const state = {
+    id: clone(route.id),
+    aux: clone(route.aux),
+    route: stateRoute
+  };
+  const path = route.path;
+  if (mode === "back") {
+    route.nav = "back";
+    if (!isSamePage(path, state) && (history.state.route?.depth || 0) > 1) {
+      history.back();
+      return;
+    }
+    mode = "replace";
+  }
+  if (mode)
+    route.mode = undefined;
+  const search = new URLSearchParams(route.search).toString();
+  const url = (search ? path + "?" + search : path) + route.hash;
+  if (mode === "push" || !mode && !isSamePage(path, state)) {
+    stateRoute.depth++;
+    history.pushState(state, "", url);
+    route.nav = "push";
+    route.depth = stateRoute.depth;
+  } else {
+    history.replaceState(state, "", url);
+  }
+}
+observe(updateHistory);
+function persistScroll(name = "main") {
+  const el = getParentElement();
+  el.addEventListener("scroll", onScroll);
+  clean(() => el.removeEventListener("scroll", onScroll));
+  let restore = unproxy(route).aux.scroll?.name;
+  if (restore) {
+    Object.assign(el, restore);
+  }
+  function onScroll() {
+    route.mode = "replace";
+    if (!route.aux.scroll)
+      route.aux.scroll = {};
+    route.aux.scroll[name] = { scrollTop: el.scrollTop, scrollLeft: el.scrollLeft };
+  }
+}
+export {
+  route,
+  persistScroll,
+  Route
+};
+
+//# debugId=917712AC1764DFEF64756E2164756E21
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

@@ -1 +1,10 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../src/route.ts"],"names":[],"mappings":"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"}
+{
+  "version": 3,
+  "sources": ["../src/route.ts"],
+  "sourcesContent": [
+    "import {getParentElement, runQueue, clean, proxy, observe, immediateObserve, unproxy, clone} from './aberdeen.js'\n\n/**\n * The class for the singleton `route` object.\n * \n */\n\nexport class Route {\n\t/** The current path of the URL split into components. For instance `/` or `/users/123/feed`. Updates will be reflected in the URL and will *push* a new entry to the browser history. */\n\tpath!: string\n\t/** Array containing the path segments. For instance `[]` or `['users', 123, 'feed']`. Updates will be reflected in the URL and will *push* a new entry to the browser history. Also, the values of `p` and `path` will be synced. */\n\tp!: string[]\n\t/** An observable object containing search parameters (a split up query string). For instance `{order: \"date\", title: \"something\"}` or just `{}`. By default, updates will be reflected in the URL, replacing the current history state. */\n\thash!: string\n\t/** A part of the browser history *state* that is considered part of the page *identify*, meaning changes will (by default) cause a history push, and when going *back*, it must match. */\n\tsearch!: Record<string, string>\n\t/** The `hash` interpreted as search parameters. So `\"a=x&b=y\"` becomes `{a: \"x\", b: \"y\"}`. */\n\tid!: Record<string, any>\n\t/** The auxiliary part of the browser history *state*, not considered part of the page *identity*. Changes will be reflected in the browser history using a replace. */\n\taux!: Record<string, any>\n\t/** The navigation depth of the current session. Starts at 1. Writing to this property has no effect. */\n\tdepth: number = 1\n\t/** The navigation action that got us to this page. Writing to this property has no effect.\n        - `\"load\"`: An initial page load.\n        - `\"back\"` or `\"forward\"`: When we navigated backwards or forwards in the stack.\n        - `\"push\"`: When we added a new page on top of the stack. \n    */\n    nav: 'load' | 'back' | 'forward' | 'push' = 'load'\n    /** As described above, this library takes a best guess about whether pushing an item to the browser history makes sense or not. When `mode` is... \n   \t    - `\"push\"`: Force creation of a new browser history entry. \n   \t    - `\"replace\"`: Update the current history entry, even when updates to other keys would normally cause a *push*.\n \t    - `\"back\"`: Unwind the history (like repeatedly pressing the *back* button) until we find a page that matches the given `path` and `id` (or that is the first page in our stack), and then *replace* that state by the full given state.\n        The `mode` key can be written to `route` but will be immediately and silently removed.\n    */\n\tmode: 'push' | 'replace' | 'back' | undefined\n}\n\n/**\n * The singleton {@link Route} object reflecting the current URL and browser history state. You can make changes to it to affect the URL and browser history. See {@link Route} for details.\n */\nexport const route = proxy(new Route())\n\nlet stateRoute = {\n\tnonce: -1,\n\tdepth: 0,\n}\n\n// Reflect changes to the browser URL (back/forward navigation) in the `route` and `stack`.\nfunction handleLocationUpdate(event?: PopStateEvent) {\n\tlet state = event?.state || {}\n\tlet nav: 'load' | 'back' | 'forward' | 'push' = 'load'\n\tif (state.route?.nonce == null) {\n\t\tstate.route = {\n\t\t\tnonce: Math.floor(Math.random() * Number.MAX_SAFE_INTEGER),\n\t\t\tdepth: 1,\n\t\t} \n\t\thistory.replaceState(state, '')\n\t} else if (stateRoute.nonce === state.route.nonce) {\n\t\tnav = state.route.depth > stateRoute.depth ? 'forward' : 'back'\n\t}\n\tstateRoute = state.route\n\n\tif (unproxy(route).mode === 'back') {\n\t\troute.depth = stateRoute.depth\n\t\t// We are still in the process of searching for a page in our navigation history..\n\t\tupdateHistory()\n\t\treturn\n\t}\n\n\tconst search: any= {}\n\tfor(let [k, v] of new URLSearchParams(location.search)) {\n\t\tsearch[k] = v\n\t}\n\n\troute.path =  location.pathname\n\troute.p =  location.pathname.slice(1).split('/')\n\troute.search = search\n\troute.hash =  location.hash\n\troute.id =  state.id\n\troute.aux =  state.aux\n\troute.depth =  stateRoute.depth\n\troute.nav = nav\n\n\t// Forward or back event. Redraw synchronously, because we can!\n\tif (event) runQueue();\n}\nhandleLocationUpdate()\nwindow.addEventListener(\"popstate\", handleLocationUpdate);\n\n// These immediate-mode observers will rewrite the data in `route` to its canonical form.\n// We want to to this immediately, so that user-code running immediately after a user-code\n// initiated `set` will see the canonical form (instead of doing a rerender shortly after,\n// or crashing due to non-canonical data).\nfunction updatePath(): void {\n\tlet path = route.path\n\tif (path == null && unproxy(route).p) {\n\t\treturn updateP()\n\t} \n\tpath = ''+(path || '/')\n\tif (!path.startsWith('/')) path = '/'+path\n\troute.path = path\n\troute.p = path.slice(1).split('/')\n}\nimmediateObserve(updatePath)\n\nfunction updateP(): void {\n\tconst p = route.p\n\tif (p == null && unproxy(route).path) {\n\t\treturn updatePath()\n\t}\n\tif (!(p instanceof Array)) {\n\t\tconsole.error(`aberdeen route: 'p' must be a non-empty array, not ${JSON.stringify(p)}`)\n\t\troute.p = [''] // This will cause a recursive call this observer.\n\t} else if (p.length == 0) {\n\t\troute.p = [''] // This will cause a recursive call this observer.\n\t} else {\n\t\troute.path = '/' + p.join('/')\n\t}\n}\nimmediateObserve(updateP)\n\nimmediateObserve(() => {\n\tif (!route.search || typeof route.search !== 'object') route.search = {}\n})\n\nimmediateObserve(() => {\n\tif (!route.id || typeof route.id !== 'object') route.id = {}\n})\n\nimmediateObserve(() => {\n\tif (!route.aux || typeof route.aux !== 'object') route.aux = {}\n})\n\nimmediateObserve(() => {\n\tlet hash = ''+(route.hash || '')\n\tif (hash && !hash.startsWith('#')) hash = '#'+hash\n\troute.hash = hash\n})\n\nfunction isSamePage(path: string, state: any): boolean {\n\treturn location.pathname === path && JSON.stringify(history.state.id) === JSON.stringify(state.id)\n}\n\nfunction updateHistory() {\n\t// Get and delete mode without triggering anything.\n\tlet mode = route.mode\n\tconst state = {\n\t\tid: clone(route.id),\n\t\taux: clone(route.aux),\n\t\troute: stateRoute,\n\t}\n\t\n\t// Construct the URL.\n\tconst path = route.path\n\n\t// Change browser state, according to `mode`.\n\tif (mode === 'back') {\n\t\troute.nav = 'back'\n\t\tif (!isSamePage(path, state) && (history.state.route?.depth||0) > 1) {\n\t\t\thistory.back()\n\t\t\treturn\n\t\t}\n\t\tmode = 'replace'\n\t\t// We'll replace the state async, to give the history.go the time to take affect first.\n\t\t//setTimeout(() => history.replaceState(state, '', url), 0)\n\t}\n\n\tif (mode) route.mode = undefined\n\tconst search = new URLSearchParams(route.search).toString()\n\tconst url = (search ? path+'?'+search : path) + route.hash\n\t\t\n\tif (mode === 'push' || (!mode && !isSamePage(path, state))) {\n\t\tstateRoute.depth++ // stateRoute === state.route\n\t\thistory.pushState(state, '', url)\n\t\troute.nav = 'push'\n\t\troute.depth = stateRoute.depth\n\t} else {\n\t\t// Default to `push` when the URL changed or top-level state keys changed.\n\t\thistory.replaceState(state, '', url)\n\t}\n}\n\n// This deferred-mode observer will update the URL and history based on `route` changes.\nobserve(updateHistory)\n\n\n/**\n * Restore and store the vertical and horizontal scroll position for\n * the parent element to the page state.\n * \n * @param {string} name - A unique (within this page) name for this\n * scrollable element. Defaults to 'main'.\n * \n * The scroll position will be persisted in `route.aux.scroll.<name>`.\n */\nexport function persistScroll(name: string = 'main') {\n\tconst el = getParentElement()\n\tel.addEventListener('scroll', onScroll)\n\tclean(() => el.removeEventListener('scroll', onScroll))\n\n\tlet restore = unproxy(route).aux.scroll?.name\n\tif (restore) {\n\t\tObject.assign(el, restore)\n\t}\n\n\tfunction onScroll() {\n\t\troute.mode = 'replace'\n\t\tif (!route.aux.scroll) route.aux.scroll = {}\n\t\troute.aux.scroll[name] = {scrollTop: el.scrollTop, scrollLeft: el.scrollLeft}\n\t}\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "917712AC1764DFEF64756E2164756E21",
+  "names": []
+}

package/dist/transitions.d.ts

@@ -6,7 +6,7 @@
 * The transition doesn't look great for table elements, and may have problems
 * for other specific cases as well.
 */
-export declare function grow(el: HTMLElement): void;
+export declare function grow(el: HTMLElement): Promise<void>;
 /** Do a shrink transition for the given element, and remove it from the DOM
 * afterwards. This is meant to be used as a handler for the `destroy` property.
 *
@@ -15,4 +15,4 @@ export declare function grow(el: HTMLElement): void;
 * The transition doesn't look great for table elements, and may have problems
 * for other specific cases as well.
 */
-export declare function shrink(el: HTMLElement): void;
+export declare function shrink(el: HTMLElement): Promise<void>;