aberdeen 1.4.3 → 1.6.0

package/dist-min/route.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/route.ts"],
   "sourcesContent": [
-    "import {clean, getParentElement, $, proxy, runQueue, unproxy, copy, merge, clone, leakScope} from \"./aberdeen.js\";\n\ntype NavType = \"load\" | \"back\" | \"forward\" | \"go\" | \"push\";\n\n/**\n* The class for the global `route` object.\n*/\nexport interface Route {\n\t/** The current path of the URL as a string. For instance `\"/\"` or `\"/users/123/feed\"`. Paths are normalized to always start with a `/` and never end with a `/` (unless it's the root path). */\n\tpath: string;\n\t/** An convenience array containing path segments, mapping to `path`. For instance `[]` (for `\"/\"`) or `['users', '123', 'feed']` (for `\"/users/123/feed\"`). */\n\tp: string[];\n\t/** The hash fragment including the leading `#`, or an empty string. For instance `\"#my_section\"` or `\"\"`. */\n\thash: string;\n\t/** The query string interpreted as search parameters. So `\"a=x&b=y\"` becomes `{a: \"x\", b: \"y\"}`. */\n\tsearch: Record<string, string>;\n\t/** An object to be used for any additional data you want to associate with the current page. Data should be JSON-compatible. */\n\tstate: 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;\n\t/** The navigation action that got us to this page. Writing to this property has no effect.\n\t- `\"load\"`: An initial page load.\n\t- `\"back\"` or `\"forward\"`: When we navigated backwards or forwards in the stack.\n\t- `\"go\"`: When we added a new page on top of the stack.\n\t- `\"push\"`: When we added a new page on top of the stack, merging with the current page.\n\tMostly useful for page transition animations. Writing to this property has no effect.\n\t*/\n\tnav: NavType;\n}\n\nlet log: (...args: any) => void = () => {};\n\n/**\n * Configure logging on route changes.\n * @param value `true` to enable logging to console, `false` to disable logging, or a custom logging function. Defaults to `false`.\n */\nexport function setLog(value: boolean | ((...args: any[]) => void)) {\n\tif (value === true) {\n\t\tlog = console.log.bind(console, 'aberdeen router');\n\t} else if (value === false) {\n\t\tlog = () => {};\n\t} else {\n\t\tlog = value;\n\t}\n}\n\nfunction getRouteFromBrowser(): Route {\n\treturn toCanonRoute({\n\t\tpath: location.pathname,\n\t\thash: location.hash,\n\t\tsearch: Object.fromEntries(new URLSearchParams(location.search)),\n\t\tstate: history.state?.state || {},\n\t}, \"load\", (history.state?.stack?.length || 0) + 1);\n}\n\n/**\n* Deep compare `a` and `b`. If `partial` is true, objects contained in `b` may be a subset\n* of their counterparts in `a` and still be considered equal.\n*/\nfunction equal(a: any, b: any, partial: boolean): boolean {\n\tif (a===b) return true;\n\tif (typeof a !== \"object\" || !a || typeof b !== \"object\" || !b) return false; // otherwise they would have been equal\n\tif (a.constructor !== b.constructor) return false;\n\tif (b instanceof Array) {\n\t\tif (a.length !== b.length) return false;\n\t\tfor(let i = 0; i < b.length; i++) {\n\t\t\tif (!equal(a[i], b[i], partial)) return false;\n\t\t}\n\t} else {\n\t\tfor(const k of Object.keys(b)) {\n\t\t\tif (!equal(a[k], b[k], partial)) return false;\n\t\t}\n\t\tif (!partial) {\n\t\t\tfor(const k of Object.keys(a)) {\n\t\t\t\tif (!b.hasOwnProperty(k)) return false;\n\t\t\t}\n\t\t}\n\t}\n\treturn true;\n}\n\nfunction getUrl(target: Route) {\n\tconst search = new URLSearchParams(target.search).toString();\n\treturn (search ? `${target.path}?${search}` : target.path) + target.hash;\n}\n\nfunction toCanonRoute(target: Partial<Route>, nav: NavType, depth: number): Route {\n\tlet path = target.path || (target.p || []).join(\"/\") || \"/\";\n\tpath = (\"\"+path).replace(/\\/+$/, \"\");\n\tif (!path.startsWith(\"/\")) path = `/${path}`;\n\t\n\treturn {\n\t\tpath,\n\t\thash: target.hash && target.hash !==\"#\" ? (target.hash.startsWith(\"#\") ? target.hash : \"#\" + target.hash) : \"\",\n\t\tp: path.length > 1 ? path.slice(1).replace(/\\/+$/, \"\").split(\"/\") : [],\n\t\tnav,\n\t\tsearch: typeof target.search === 'object' && target.search ? clone(target.search) : {},\n\t\tstate: typeof target.state === 'object' && target.state ? clone(target.state) : {},\n\t\tdepth,\n\t};\n}\n\n\ntype RouteTarget = string | (string|number)[] | Partial<Omit<Omit<Route,\"p\">,\"search\"> & {\n\t/** An convenience array containing path segments, mapping to `path`. For instance `[]` (for `\"/\"`) or `['users', 123, 'feed']` (for `\"/users/123/feed\"`). Values may be integers but will be converted to strings.*/\n\tp: (string|number)[],\n\t/** The query string interpreted as search parameters. So `\"a=x&b=y\"` becomes `{a: \"x\", b: \"y\", c: 42}`. Values may be integers but will be converted to strings. */\n\tsearch: Record<string,string|number>,\n}>;\n\nfunction targetToPartial(target: RouteTarget) {\n\t// Convert shortcut values to objects\n\tif (typeof target === 'string') {\n\t\ttarget = {path: target};\n\t} else if (target instanceof Array) {\n\t\ttarget = {p: target};\n\t}\n\t// Convert numbers in p and search to strings\n\tif (target.p) {\n\t\ttarget.p = target.p.map(String);\n\t}\n\tif (target.search) {\n\t\tfor(const key of Object.keys(target.search)) {\n\t\t\ttarget.search[key] = String(target.search[key]);\n\t\t}\n\t}\n\treturn target as Partial<Route>;\n}\n\n\n/**\n* Navigate to a new URL by pushing a new history entry.\n* \n* Note that this happens synchronously, immediately updating `route` and processing any reactive updates based on that.\n* \n* @param target A subset of the {@link Route} properties to navigate to. If neither `p` nor `path` is given, the current path is used. For other properties, an empty/default value is assumed if not given. For convenience:\n* - You may pass a string instead of an object, which is interpreted as the `path`.\n* - You may pass an array instead of an object, which is interpreted as the `p` array.\n* - If you pass `p`, it may contain numbers, which will be converted to strings.\n* - If you pass `search`, its values may be numbers, which will be converted to strings.\n* \n* Examples:\n* ```js\n* // Navigate to /users/123\n* route.go(\"/users/123\");\n* \n* // Navigate to /users/123?tab=feed#top\n* route.go({p: [\"users\", 123], search: {tab: \"feed\"}, hash: \"top\"});\n* ```\n*/\nexport function go(target: RouteTarget, nav: NavType = \"go\"): void {\n\tconst stack: string[] = history.state?.stack || [];\n\n\tprevStack = stack.concat(JSON.stringify(unproxy(current)));\n\t\n\tconst newRoute: Route = toCanonRoute(targetToPartial(target), nav, prevStack.length + 1);\n\tcopy(current, newRoute);\n\t\n\tlog(nav, newRoute);\n\thistory.pushState({state: newRoute.state, stack: prevStack}, \"\", getUrl(newRoute));\n\t\n\trunQueue();\n}\n\n/**\n * Modify the current route by merging `target` into it (using {@link merge}), pushing a new history entry.\n * \n * This is useful for things like opening modals or side panels, where you want a browser back action to return to the previous state.\n * \n * @param target Same as for {@link go}, but merged into the current route instead deleting all state.\n */\nexport function push(target: RouteTarget): void {\n\tlet copy = clone(unproxy(current));\n\tmerge(copy, targetToPartial(target));\n\tgo(copy);\n}\n\n/**\n * Try to go back in history to the first entry that matches the given target. If none is found, the given state will replace the current page. This is useful for \"cancel\" or \"close\" actions that should return to the previous page if possible, but create a new page if not (for instance when arriving at the current page through a direct link).\n * \n * Consider using {@link up} to go up in the path hierarchy.\n * \n * @param target The target route to go back to. May be a subset of {@link Route}, or a string (for `path`), or an array of strings (for `p`).\n */\nexport function back(target: RouteTarget = {}): void {\n\tconst partial = targetToPartial(target);\n\tconst stack: string[] = history.state?.stack || [];\n\tfor(let i = stack.length - 1; i >= 0; i--) {\n\t\tconst histRoute: Route = JSON.parse(stack[i]);\n\t\tif (equal(histRoute, partial, true)) {\n\t\t\tconst pages = i - stack.length;\n\t\t\tlog(`back`, pages, histRoute);\n\t\t\thistory.go(pages);\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconst newRoute = toCanonRoute(partial, \"back\", stack.length + 1);\n\tlog(`back not found, replacing`, partial);\n\tcopy(current, newRoute);\n}\n\n/**\n* Navigate up in the path hierarchy, by going back to the first history entry\n* that has a shorter path than the current one. If there's none, we just shorten\n* the current path.\n* \n* Note that going back in browser history happens asynchronously, so `route` will not be updated immediately.\n*/\nexport function up(stripCount: number = 1): void {\n\tconst currentP = unproxy(current).p;\n\tconst stack: string[] = history.state?.stack || [];\n\tfor(let i = stack.length - 1; i >= 0; i--) {\n\t\tconst histRoute: Route = JSON.parse(stack[i]);\n\t\tif (histRoute.p.length < currentP.length && equal(histRoute.p, currentP.slice(0, histRoute.p.length), false)) {\n\t\t\t// This route is shorter and matches the start of the current path\n\t\t\tlog(`up to ${i+1} / ${stack.length}`, histRoute);\n\t\t\thistory.go(i - stack.length);\n\t\t\treturn;\n\t\t}\n\t}\n\t// Replace current route with /\n\tconst newRoute = toCanonRoute({p: currentP.slice(0, currentP.length - stripCount)}, \"back\", stack.length + 1);\n\tlog(`up not found, replacing`, newRoute);\n\tcopy(current, newRoute);\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 = \"main\") {\n\tconst el = getParentElement();\n\tel.addEventListener(\"scroll\", onScroll);\n\tclean(() => el.removeEventListener(\"scroll\", onScroll));\n\t\n\tconst restore = unproxy(current).state.scroll?.[name];\n\tif (restore) {\n\t\tlog(\"restoring scroll\", name, restore);\n\t\tObject.assign(el, restore);\n\t}\n\t\n\tfunction onScroll() {\n\t\t(current.state.scroll ||= {})[name] = {\n\t\t\tscrollTop: el.scrollTop,\n\t\t\tscrollLeft: el.scrollLeft,\n\t\t};\n\t}\n}\n\nlet prevStack: string[];\n\n/**\n* The global {@link Route} object reflecting the current URL and browser history state. Changes you make to this affect the current browser history item (modifying the URL if needed).\n*/\nexport const current: Route = proxy({}) as Route;\n\n/**\n * Reset the router to its initial state, based on the current browser state. Intended for testing purposes only.\n * @internal\n * */\nexport function reset() {\n\tprevStack = history.state?.stack || [];\n\tconst initRoute = getRouteFromBrowser();\n\tlog('initial', initRoute);\n\tcopy(unproxy(current), initRoute);\n}\nreset();\n\n// Handle browser history back and forward\nwindow.addEventListener(\"popstate\", function(event: PopStateEvent) {\n\tconst newRoute = getRouteFromBrowser();\n\t\n\t// If the stack length changes, and at least the top-most shared entry is the same,\n\t// we'll interpret this as a \"back\" or \"forward\" navigation.\n\tconst stack: string[] = history.state?.stack || [];\n\tif (stack.length !== prevStack.length) {\n\t\tconst maxIndex = Math.min(prevStack.length, stack.length) - 1;\n\t\tif (maxIndex < 0 || stack[maxIndex] === prevStack[maxIndex]) {\n\t\t\tnewRoute.nav = stack.length < prevStack.length ? \"back\" : \"forward\";\n\t\t}\n\t}\n\t// else nav will be \"load\"\n\t\n\tprevStack = stack;\n\tlog('popstate', newRoute);\n\tcopy(current, newRoute);\n\t\n\trunQueue();\n});\n\n// Make sure these observers are never cleaned up, not even by `unmountAll`.\nleakScope(() => {\n\t// Sync `p` to `path`. We need to do this in a separate, higher-priority observer,\n\t// so that setting `route.p` will not be immediately overruled by the pre-existing `route.path`.\n\t$(() => {\n\t\tcurrent.path = \"/\" + Array.from(current.p).join(\"/\");\n\t});\n\n\t// Do a replaceState based on changes to proxy\n\t$(() => {\n\n\t\t// First normalize `route`\n\t\tconst stack = history.state?.stack || [];\n\t\tconst newRoute = toCanonRoute(current, unproxy(current).nav, stack.length + 1);\n\t\tcopy(current, newRoute);\n\t\t\n\t\t// Then replace the current browser state if something actually changed\n\t\tconst state = {state: newRoute.state, stack};\n\t\tconst url = getUrl(newRoute);\n\t\tif (url !== location.pathname + location.search + location.hash || !equal(history.state, state, false)) {\n\t\t\tlog('replaceState', newRoute, state, url);\n\t\t\thistory.replaceState(state, \"\", url);\n\t\t}\n\t});\n});\n"
+    "import {clean, getParentElement, $, proxy, runQueue, unproxy, copy, merge, clone, leakScope} from \"./aberdeen.js\";\n\ntype NavType = \"load\" | \"back\" | \"forward\" | \"go\" | \"push\";\n\n/**\n* The class for the global `route` object.\n*/\nexport interface Route {\n\t/** The current path of the URL as a string. For instance `\"/\"` or `\"/users/123/feed\"`. Paths are normalized to always start with a `/` and never end with a `/` (unless it's the root path). */\n\tpath: string;\n\t/** An convenience array containing path segments, mapping to `path`. For instance `[]` (for `\"/\"`) or `['users', '123', 'feed']` (for `\"/users/123/feed\"`). */\n\tp: string[];\n\t/** The hash fragment including the leading `#`, or an empty string. For instance `\"#my_section\"` or `\"\"`. */\n\thash: string;\n\t/** The query string interpreted as search parameters. So `\"a=x&b=y\"` becomes `{a: \"x\", b: \"y\"}`. */\n\tsearch: Record<string, string>;\n\t/** An object to be used for any additional data you want to associate with the current page. Data should be JSON-compatible. */\n\tstate: 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;\n\t/** The navigation action that got us to this page. Writing to this property has no effect.\n\t- `\"load\"`: An initial page load.\n\t- `\"back\"` or `\"forward\"`: When we navigated backwards or forwards in the stack.\n\t- `\"go\"`: When we added a new page on top of the stack.\n\t- `\"push\"`: When we added a new page on top of the stack, merging with the current page.\n\tMostly useful for page transition animations. Writing to this property has no effect.\n\t*/\n\tnav: NavType;\n}\n\nlet log: (...args: any) => void = () => {};\n\n/**\n * Configure logging on route changes.\n * @param value `true` to enable logging to console, `false` to disable logging, or a custom logging function. Defaults to `false`.\n */\nexport function setLog(value: boolean | ((...args: any[]) => void)) {\n\tif (value === true) {\n\t\tlog = console.log.bind(console, 'aberdeen router');\n\t} else if (value === false) {\n\t\tlog = () => {};\n\t} else {\n\t\tlog = value;\n\t}\n}\n\nfunction getRouteFromBrowser(): Route {\n\treturn toCanonRoute({\n\t\tpath: location.pathname,\n\t\thash: location.hash,\n\t\tsearch: Object.fromEntries(new URLSearchParams(location.search)),\n\t\tstate: history.state?.state || {},\n\t}, \"load\", (history.state?.stack?.length || 0) + 1);\n}\n\n/**\n* Deep compare `a` and `b`. If `partial` is true, objects contained in `b` may be a subset\n* of their counterparts in `a` and still be considered equal.\n*/\nfunction equal(a: any, b: any, partial: boolean): boolean {\n\tif (a===b) return true;\n\tif (typeof a !== \"object\" || !a || typeof b !== \"object\" || !b) return false; // otherwise they would have been equal\n\tif (a.constructor !== b.constructor) return false;\n\tif (b instanceof Array) {\n\t\tif (a.length !== b.length) return false;\n\t\tfor(let i = 0; i < b.length; i++) {\n\t\t\tif (!equal(a[i], b[i], partial)) return false;\n\t\t}\n\t} else {\n\t\tfor(const k of Object.keys(b)) {\n\t\t\tif (!equal(a[k], b[k], partial)) return false;\n\t\t}\n\t\tif (!partial) {\n\t\t\tfor(const k of Object.keys(a)) {\n\t\t\t\tif (!b.hasOwnProperty(k)) return false;\n\t\t\t}\n\t\t}\n\t}\n\treturn true;\n}\n\nfunction getUrl(target: Route) {\n\tconst search = new URLSearchParams(target.search).toString();\n\treturn (search ? `${target.path}?${search}` : target.path) + target.hash;\n}\n\nfunction toCanonRoute(target: Partial<Route>, nav: NavType, depth: number): Route {\n\tlet path = target.path || (target.p || []).join(\"/\") || \"/\";\n\tpath = (\"\"+path).replace(/\\/+$/, \"\");\n\tif (!path.startsWith(\"/\")) path = `/${path}`;\n\t\n\treturn {\n\t\tpath,\n\t\thash: target.hash && target.hash !==\"#\" ? (target.hash.startsWith(\"#\") ? target.hash : \"#\" + target.hash) : \"\",\n\t\tp: path.length > 1 ? path.slice(1).replace(/\\/+$/, \"\").split(\"/\") : [],\n\t\tnav,\n\t\tsearch: typeof target.search === 'object' && target.search ? clone(target.search) : {},\n\t\tstate: typeof target.state === 'object' && target.state ? clone(target.state) : {},\n\t\tdepth,\n\t};\n}\n\n\ntype RouteTarget = string | (string|number)[] | Partial<Omit<Omit<Route,\"p\">,\"search\"> & {\n\t/** An convenience array containing path segments, mapping to `path`. For instance `[]` (for `\"/\"`) or `['users', 123, 'feed']` (for `\"/users/123/feed\"`). Values may be integers but will be converted to strings.*/\n\tp: (string|number)[],\n\t/** The query string interpreted as search parameters. So `\"a=x&b=y\"` becomes `{a: \"x\", b: \"y\", c: 42}`. Values may be integers but will be converted to strings. */\n\tsearch: Record<string,string|number>,\n}>;\n\nfunction targetToPartial(target: RouteTarget) {\n\t// Convert shortcut values to objects\n\tif (typeof target === 'string') {\n\t\ttarget = {path: target};\n\t} else if (target instanceof Array) {\n\t\ttarget = {p: target};\n\t}\n\t// Convert numbers in p and search to strings\n\tif (target.p) {\n\t\ttarget.p = target.p.map(String);\n\t}\n\tif (target.search) {\n\t\tfor(const key of Object.keys(target.search)) {\n\t\t\ttarget.search[key] = String(target.search[key]);\n\t\t}\n\t}\n\treturn target as Partial<Route>;\n}\n\n\n/**\n* Navigate to a new URL by pushing a new history entry.\n* \n* Note that this happens synchronously, immediately updating `route` and processing any reactive updates based on that.\n* \n* @param target A subset of the {@link Route} properties to navigate to. If neither `p` nor `path` is given, the current path is used. For other properties, an empty/default value is assumed if not given. For convenience:\n* - You may pass a string instead of an object, which is interpreted as the `path`.\n* - You may pass an array instead of an object, which is interpreted as the `p` array.\n* - If you pass `p`, it may contain numbers, which will be converted to strings.\n* - If you pass `search`, its values may be numbers, which will be converted to strings.\n* \n* Examples:\n* ```js\n* // Navigate to /users/123\n* route.go(\"/users/123\");\n* \n* // Navigate to /users/123?tab=feed#top\n* route.go({p: [\"users\", 123], search: {tab: \"feed\"}, hash: \"top\"});\n* ```\n*/\nexport function go(target: RouteTarget, nav: NavType = \"go\"): void {\n\tconst stack: string[] = history.state?.stack || [];\n\n\tprevStack = stack.concat(JSON.stringify(unproxy(current)));\n\t\n\tconst newRoute: Route = toCanonRoute(targetToPartial(target), nav, prevStack.length + 1);\n\tcopy(current, newRoute);\n\t\n\tlog(nav, newRoute);\n\thistory.pushState({state: newRoute.state, stack: prevStack}, \"\", getUrl(newRoute));\n\t\n\trunQueue();\n}\n\n/**\n * Modify the current route by merging `target` into it (using {@link merge}), pushing a new history entry.\n * \n * This is useful for things like opening modals or side panels, where you want a browser back action to return to the previous state.\n * \n * @param target Same as for {@link go}, but merged into the current route instead deleting all state.\n */\nexport function push(target: RouteTarget): void {\n\tconst c = clone(unproxy(current));\n\tmerge(c, targetToPartial(target));\n\tgo(c);\n}\n\n/**\n * Try to go back in history to the first entry that matches the given target. If none is found, the given state will replace the current page. This is useful for \"cancel\" or \"close\" actions that should return to the previous page if possible, but create a new page if not (for instance when arriving at the current page through a direct link).\n * \n * Consider using {@link up} to go up in the path hierarchy.\n * \n * @param target The target route to go back to. May be a subset of {@link Route}, or a string (for `path`), or an array of strings (for `p`).\n */\nexport function back(target: RouteTarget = {}): void {\n\tconst partial = targetToPartial(target);\n\tconst stack: string[] = history.state?.stack || [];\n\tfor(let i = stack.length - 1; i >= 0; i--) {\n\t\tconst histRoute: Route = JSON.parse(stack[i]);\n\t\tif (equal(histRoute, partial, true)) {\n\t\t\tconst pages = i - stack.length;\n\t\t\tlog(`back`, pages, histRoute);\n\t\t\thistory.go(pages);\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconst newRoute = toCanonRoute(partial, \"back\", stack.length + 1);\n\tlog(`back not found, replacing`, partial);\n\tcopy(current, newRoute);\n}\n\n/**\n* Navigate up in the path hierarchy, by going back to the first history entry\n* that has a shorter path than the current one. If there's none, we just shorten\n* the current path.\n* \n* Note that going back in browser history happens asynchronously, so `route` will not be updated immediately.\n*/\nexport function up(stripCount: number = 1): void {\n\tconst currentP = unproxy(current).p;\n\tconst stack: string[] = history.state?.stack || [];\n\tfor(let i = stack.length - 1; i >= 0; i--) {\n\t\tconst histRoute: Route = JSON.parse(stack[i]);\n\t\tif (histRoute.p.length < currentP.length && equal(histRoute.p, currentP.slice(0, histRoute.p.length), false)) {\n\t\t\t// This route is shorter and matches the start of the current path\n\t\t\tlog(`up to ${i+1} / ${stack.length}`, histRoute);\n\t\t\thistory.go(i - stack.length);\n\t\t\treturn;\n\t\t}\n\t}\n\t// Replace current route with /\n\tconst newRoute = toCanonRoute({p: currentP.slice(0, currentP.length - stripCount)}, \"back\", stack.length + 1);\n\tlog(`up not found, replacing`, newRoute);\n\tcopy(current, newRoute);\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 = \"main\") {\n\tconst el = getParentElement();\n\tel.addEventListener(\"scroll\", onScroll);\n\tclean(() => el.removeEventListener(\"scroll\", onScroll));\n\t\n\tconst restore = unproxy(current).state.scroll?.[name];\n\tif (restore) {\n\t\tlog(\"restoring scroll\", name, restore);\n\t\tObject.assign(el, restore);\n\t}\n\t\n\tfunction onScroll() {\n\t\t(current.state.scroll ||= {})[name] = {\n\t\t\tscrollTop: el.scrollTop,\n\t\t\tscrollLeft: el.scrollLeft,\n\t\t};\n\t}\n}\n\nlet prevStack: string[];\n\n/**\n* The global {@link Route} object reflecting the current URL and browser history state. Changes you make to this affect the current browser history item (modifying the URL if needed).\n*/\nexport const current: Route = proxy({}) as Route;\n\n/**\n * Reset the router to its initial state, based on the current browser state. Intended for testing purposes only.\n * @internal\n * */\nexport function reset() {\n\tprevStack = history.state?.stack || [];\n\tconst initRoute = getRouteFromBrowser();\n\tlog('initial', initRoute);\n\tcopy(unproxy(current), initRoute);\n}\nreset();\n\n// Handle browser history back and forward\nwindow.addEventListener(\"popstate\", function(event: PopStateEvent) {\n\tconst newRoute = getRouteFromBrowser();\n\t\n\t// If the stack length changes, and at least the top-most shared entry is the same,\n\t// we'll interpret this as a \"back\" or \"forward\" navigation.\n\tconst stack: string[] = history.state?.stack || [];\n\tif (stack.length !== prevStack.length) {\n\t\tconst maxIndex = Math.min(prevStack.length, stack.length) - 1;\n\t\tif (maxIndex < 0 || stack[maxIndex] === prevStack[maxIndex]) {\n\t\t\tnewRoute.nav = stack.length < prevStack.length ? \"back\" : \"forward\";\n\t\t}\n\t}\n\t// else nav will be \"load\"\n\t\n\tprevStack = stack;\n\tlog('popstate', newRoute);\n\tcopy(current, newRoute);\n\t\n\trunQueue();\n});\n\n// Make sure these observers are never cleaned up, not even by `unmountAll`.\nleakScope(() => {\n\t// Sync `p` to `path`. We need to do this in a separate, higher-priority observer,\n\t// so that setting `route.p` will not be immediately overruled by the pre-existing `route.path`.\n\t$(() => {\n\t\tcurrent.path = \"/\" + Array.from(current.p).join(\"/\");\n\t});\n\n\t// Do a replaceState based on changes to proxy\n\t$(() => {\n\n\t\t// First normalize `route`\n\t\tconst stack = history.state?.stack || [];\n\t\tconst newRoute = toCanonRoute(current, unproxy(current).nav, stack.length + 1);\n\t\tcopy(current, newRoute);\n\t\t\n\t\t// Then replace the current browser state if something actually changed\n\t\tconst state = {state: newRoute.state, stack};\n\t\tconst url = getUrl(newRoute);\n\t\tif (url !== location.pathname + location.search + location.hash || !equal(history.state, state, false)) {\n\t\t\tlog('replaceState', newRoute, state, url);\n\t\t\thistory.replaceState(state, \"\", url);\n\t\t}\n\t});\n});\n"
   ],
-  "mappings": "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",
+  "mappings": "AAAA,gBAAQ,sBAAO,OAAkB,WAAG,cAAO,aAAU,UAAS,WAAM,WAAO,eAAO,sBA8BlF,IAAI,EAA8B,IAAM,GAMjC,SAAS,CAAM,CAAC,EAA6C,CACnE,GAAI,IAAU,GACb,EAAM,QAAQ,IAAI,KAAK,QAAS,iBAAiB,EAC3C,QAAI,IAAU,GACpB,EAAM,IAAM,GAEZ,OAAM,EAIR,SAAS,CAAmB,EAAU,CACrC,OAAO,EAAa,CACnB,KAAM,SAAS,SACf,KAAM,SAAS,KACf,OAAQ,OAAO,YAAY,IAAI,gBAAgB,SAAS,MAAM,CAAC,EAC/D,MAAO,QAAQ,OAAO,OAAS,CAAC,CACjC,EAAG,QAAS,QAAQ,OAAO,OAAO,QAAU,GAAK,CAAC,EAOnD,SAAS,CAAK,CAAC,EAAQ,EAAQ,EAA2B,CACzD,GAAI,IAAI,EAAG,MAAO,GAClB,GAAI,OAAO,IAAM,UAAY,CAAC,GAAK,OAAO,IAAM,UAAY,CAAC,EAAG,MAAO,GACvE,GAAI,EAAE,cAAgB,EAAE,YAAa,MAAO,GAC5C,GAAI,aAAa,MAAO,CACvB,GAAI,EAAE,SAAW,EAAE,OAAQ,MAAO,GAClC,QAAQ,EAAI,EAAG,EAAI,EAAE,OAAQ,IAC5B,GAAI,CAAC,EAAM,EAAE,GAAI,EAAE,GAAI,CAAO,EAAG,MAAO,GAEnC,KACN,QAAU,KAAK,OAAO,KAAK,CAAC,EAC3B,GAAI,CAAC,EAAM,EAAE,GAAI,EAAE,GAAI,CAAO,EAAG,MAAO,GAEzC,GAAI,CAAC,GACJ,QAAU,KAAK,OAAO,KAAK,CAAC,EAC3B,GAAI,CAAC,EAAE,eAAe,CAAC,EAAG,MAAO,IAIpC,MAAO,GAGR,SAAS,CAAM,CAAC,EAAe,CAC9B,IAAM,EAAS,IAAI,gBAAgB,EAAO,MAAM,EAAE,SAAS,EAC3D,OAAQ,EAAS,GAAG,EAAO,QAAQ,IAAW,EAAO,MAAQ,EAAO,KAGrE,SAAS,CAAY,CAAC,EAAwB,EAAc,EAAsB,CACjF,IAAI,EAAO,EAAO,OAAS,EAAO,GAAK,CAAC,GAAG,KAAK,GAAG,GAAK,IAExD,GADA,GAAQ,GAAG,GAAM,QAAQ,OAAQ,EAAE,EAC/B,CAAC,EAAK,WAAW,GAAG,EAAG,EAAO,IAAI,IAEtC,MAAO,CACN,OACA,KAAM,EAAO,MAAQ,EAAO,OAAQ,IAAO,EAAO,KAAK,WAAW,GAAG,EAAI,EAAO,KAAO,IAAM,EAAO,KAAQ,GAC5G,EAAG,EAAK,OAAS,EAAI,EAAK,MAAM,CAAC,EAAE,QAAQ,OAAQ,EAAE,EAAE,MAAM,GAAG,EAAI,CAAC,EACrE,MACA,OAAQ,OAAO,EAAO,SAAW,UAAY,EAAO,OAAS,EAAM,EAAO,MAAM,EAAI,CAAC,EACrF,MAAO,OAAO,EAAO,QAAU,UAAY,EAAO,MAAQ,EAAM,EAAO,KAAK,EAAI,CAAC,EACjF,OACD,EAWD,SAAS,CAAe,CAAC,EAAqB,CAE7C,GAAI,OAAO,IAAW,SACrB,EAAS,CAAC,KAAM,CAAM,EAChB,QAAI,aAAkB,MAC5B,EAAS,CAAC,EAAG,CAAM,EAGpB,GAAI,EAAO,EACV,EAAO,EAAI,EAAO,EAAE,IAAI,MAAM,EAE/B,GAAI,EAAO,OACV,QAAU,KAAO,OAAO,KAAK,EAAO,MAAM,EACzC,EAAO,OAAO,GAAO,OAAO,EAAO,OAAO,EAAI,EAGhD,OAAO,EAwBD,SAAS,CAAE,CAAC,EAAqB,EAAe,KAAY,CAGlE,GAFwB,QAAQ,OAAO,OAAS,CAAC,GAE/B,OAAO,KAAK,UAAU,EAAQ,CAAO,CAAC,CAAC,EAEzD,IAAM,EAAkB,EAAa,EAAgB,CAAM,EAAG,EAAK,EAAU,OAAS,CAAC,EACvF,EAAK,EAAS,CAAQ,EAEtB,EAAI,EAAK,CAAQ,EACjB,QAAQ,UAAU,CAAC,MAAO,EAAS,MAAO,MAAO,CAAS,EAAG,GAAI,EAAO,CAAQ,CAAC,EAEjF,EAAS,EAUH,SAAS,CAAI,CAAC,EAA2B,CAC/C,IAAM,EAAI,EAAM,EAAQ,CAAO,CAAC,EAChC,EAAM,EAAG,EAAgB,CAAM,CAAC,EAChC,EAAG,CAAC,EAUE,SAAS,CAAI,CAAC,EAAsB,CAAC,EAAS,CACpD,IAAM,EAAU,EAAgB,CAAM,EAChC,EAAkB,QAAQ,OAAO,OAAS,CAAC,EACjD,QAAQ,EAAI,EAAM,OAAS,EAAG,GAAK,EAAG,IAAK,CAC1C,IAAM,EAAmB,KAAK,MAAM,EAAM,EAAE,EAC5C,GAAI,EAAM,EAAW,EAAS,EAAI,EAAG,CACpC,IAAM,EAAQ,EAAI,EAAM,OACxB,EAAI,OAAQ,EAAO,CAAS,EAC5B,QAAQ,GAAG,CAAK,EAChB,QAIF,IAAM,EAAW,EAAa,EAAS,OAAQ,EAAM,OAAS,CAAC,EAC/D,EAAI,4BAA6B,CAAO,EACxC,EAAK,EAAS,CAAQ,EAUhB,SAAS,CAAE,CAAC,EAAqB,EAAS,CAChD,IAAM,EAAW,EAAQ,CAAO,EAAE,EAC5B,EAAkB,QAAQ,OAAO,OAAS,CAAC,EACjD,QAAQ,EAAI,EAAM,OAAS,EAAG,GAAK,EAAG,IAAK,CAC1C,IAAM,EAAmB,KAAK,MAAM,EAAM,EAAE,EAC5C,GAAI,EAAU,EAAE,OAAS,EAAS,QAAU,EAAM,EAAU,EAAG,EAAS,MAAM,EAAG,EAAU,EAAE,MAAM,EAAG,EAAK,EAAG,CAE7G,EAAI,SAAS,EAAE,OAAO,EAAM,SAAU,CAAS,EAC/C,QAAQ,GAAG,EAAI,EAAM,MAAM,EAC3B,QAIF,IAAM,EAAW,EAAa,CAAC,EAAG,EAAS,MAAM,EAAG,EAAS,OAAS,CAAU,CAAC,EAAG,OAAQ,EAAM,OAAS,CAAC,EAC5G,EAAI,0BAA2B,CAAQ,EACvC,EAAK,EAAS,CAAQ,EAYhB,SAAS,CAAa,CAAC,EAAO,OAAQ,CAC5C,IAAM,EAAK,EAAiB,EAC5B,EAAG,iBAAiB,SAAU,CAAQ,EACtC,EAAM,IAAM,EAAG,oBAAoB,SAAU,CAAQ,CAAC,EAEtD,IAAM,EAAU,EAAQ,CAAO,EAAE,MAAM,SAAS,GAChD,GAAI,EACH,EAAI,mBAAoB,EAAM,CAAO,EACrC,OAAO,OAAO,EAAI,CAAO,EAG1B,SAAS,CAAQ,EAAG,EAClB,EAAQ,MAAM,SAAW,CAAC,GAAG,GAAQ,CACrC,UAAW,EAAG,UACd,WAAY,EAAG,UAChB,GAIF,IAAI,EAKS,EAAiB,EAAM,CAAC,CAAC,EAM/B,SAAS,CAAK,EAAG,CACvB,EAAY,QAAQ,OAAO,OAAS,CAAC,EACrC,IAAM,EAAY,EAAoB,EACtC,EAAI,UAAW,CAAS,EACxB,EAAK,EAAQ,CAAO,EAAG,CAAS,EAEjC,EAAM,EAGN,OAAO,iBAAiB,WAAY,QAAQ,CAAC,EAAsB,CAClE,IAAM,EAAW,EAAoB,EAI/B,EAAkB,QAAQ,OAAO,OAAS,CAAC,EACjD,GAAI,EAAM,SAAW,EAAU,OAAQ,CACtC,IAAM,EAAW,KAAK,IAAI,EAAU,OAAQ,EAAM,MAAM,EAAI,EAC5D,GAAI,EAAW,GAAK,EAAM,KAAc,EAAU,GACjD,EAAS,IAAM,EAAM,OAAS,EAAU,OAAS,OAAS,UAK5D,EAAY,EACZ,EAAI,WAAY,CAAQ,EACxB,EAAK,EAAS,CAAQ,EAEtB,EAAS,EACT,EAGD,EAAU,IAAM,CAGf,EAAE,IAAM,CACP,EAAQ,KAAO,IAAM,MAAM,KAAK,EAAQ,CAAC,EAAE,KAAK,GAAG,EACnD,EAGD,EAAE,IAAM,CAGP,IAAM,EAAQ,QAAQ,OAAO,OAAS,CAAC,EACjC,EAAW,EAAa,EAAS,EAAQ,CAAO,EAAE,IAAK,EAAM,OAAS,CAAC,EAC7E,EAAK,EAAS,CAAQ,EAGtB,IAAM,EAAQ,CAAC,MAAO,EAAS,MAAO,OAAK,EACrC,EAAM,EAAO,CAAQ,EAC3B,GAAI,IAAQ,SAAS,SAAW,SAAS,OAAS,SAAS,MAAQ,CAAC,EAAM,QAAQ,MAAO,EAAO,EAAK,EACpG,EAAI,eAAgB,EAAU,EAAO,CAAG,EACxC,QAAQ,aAAa,EAAO,GAAI,CAAG,EAEpC,EACD",
   "debugId": "4AFCE83BFB8282B064756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "aberdeen",
-  "version": "1.4.3",
+  "version": "1.6.0",
   "author": "Frank van Viegen",
   "main": "dist-min/aberdeen.js",
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/bun": "latest",
     "typedoc": "^0.28.2",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.8.3"
   },
   "exports": {
@@ -49,8 +50,10 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "bun run build:dist && typedoc && rm -rf dist-docs/assets/aberdeen && cp -r dist dist-docs/assets/aberdeen",
+    "build": "bun run build:dist && bun run build:docs && bun run build:skill",
     "build:dist": "rm -rf dist dist-min && bun build src/*.ts --sourcemap --target browser --external '*/aberdeen.js' --outdir dist/ && bun build src/*.ts --minify --sourcemap --target browser --external '*/aberdeen.js' --outdir dist-min/ && npx tsc --emitDeclarationOnly && cd dist-min && ln -s ../dist/*.d.ts .",
+    "build:docs": "typedoc && rm -rf dist-docs/assets/aberdeen && cp -r dist dist-docs/assets/aberdeen",
+    "build:skill": "typedoc --plugin typedoc-plugin-markdown --out skill --tsconfig tsconfig.json --entryPoints src/*.ts --excludeInternal --excludePrivate --hideGenerator --readme none --router module && rm -rf skill/assets skill/documents skill/README.md && cat SKILL.md > skill/SKILL.md && awk '/^-+$/ { count++; next } count >= 2' docs/Tutorial.md >> skill/SKILL.md",
     "test": "bun test --bail",
     "prepack": "bun test && bun run build"
   },