aberdeen 1.18.1 → 1.18.2

package/skill/aberdeen.md

@@ -1,4 +1,4 @@
-[**Aberdeen v1.18.1**](README.md)
+[**Aberdeen v1.18.2**](README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 
 ### PromiseProxy
 
-Defined in: [aberdeen.ts:1528](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1528)
+Defined in: [aberdeen.ts:1531](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1531)
 
 When `proxy` is called with a Promise, the returned object has this shape.
 
@@ -26,7 +26,7 @@ When `proxy` is called with a Promise, the returned object has this shape.
 
 > **busy**: `boolean`
 
-Defined in: [aberdeen.ts:1532](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1532)
+Defined in: [aberdeen.ts:1535](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1535)
 
 True if the promise is still pending, false if it has resolved or rejected.
 
@@ -34,7 +34,7 @@ True if the promise is still pending, false if it has resolved or rejected.
 
 > `optional` **error**: `any`
 
-Defined in: [aberdeen.ts:1540](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1540)
+Defined in: [aberdeen.ts:1543](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1543)
 
 If the promise has rejected, this contains the rejection error.
 
@@ -42,7 +42,7 @@ If the promise has rejected, this contains the rejection error.
 
 > `optional` **value**: `T`
 
-Defined in: [aberdeen.ts:1536](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1536)
+Defined in: [aberdeen.ts:1539](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1539)
 
 If the promise has resolved, this contains the resolved value.
 
@@ -52,7 +52,7 @@ If the promise has resolved, this contains the resolved value.
 
 > `const` **cssVars**: `Record`\<`string`, `string`\>
 
-Defined in: [aberdeen.ts:1972](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1972)
+Defined in: [aberdeen.ts:1975](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1975)
 
 A reactive object containing CSS variable definitions.
 
@@ -91,7 +91,7 @@ A('hr mt:$3'); // Sets margin-top to var(--m3)
 
 > `const` **CUSTOM\_DUMP**: *typeof* [`CUSTOM_DUMP`](#custom_dump)
 
-Defined in: [aberdeen.ts:3478](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3478)
+Defined in: [aberdeen.ts:3495](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3495)
 
 When set on an object or its prototype chain, [dump](#dump) calls this as a render function
 (with the object as `this`) instead of its default recursive rendering. If the value is not 
@@ -112,7 +112,7 @@ class Color {
 
 > **default**: (...`args`) => `undefined` \| `Element` & `object`
 
-Defined in: [aberdeen.ts:3572](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3572)
+Defined in: [aberdeen.ts:3589](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3589)
 
 The main Aberdeen API. `A` is itself a callable function for building reactive DOM trees
 (creating elements, setting attributes, adding content). All other Aberdeen functions and
@@ -2236,7 +2236,7 @@ A('div', () => {
 
 > `const` **NO\_COPY**: `symbol` = `OPAQUE`
 
-Defined in: [aberdeen.ts:1924](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1924)
+Defined in: [aberdeen.ts:1927](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1927)
 
 Use [OPAQUE](#opaque) instead. This is an alias kept for backward compatibility.
 
@@ -2248,7 +2248,7 @@ Use [OPAQUE](#opaque) instead. This is an alias kept for backward compatibility.
 
 > `const` **OPAQUE**: *typeof* [`OPAQUE`](#opaque)
 
-Defined in: [aberdeen.ts:1917](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1917)
+Defined in: [aberdeen.ts:1920](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1920)
 
 A symbol that controls how Aberdeen handles an object in copy operations and proxy wrapping.
 
@@ -2268,7 +2268,7 @@ The **value** of the symbol controls proxy wrapping when the object is read from
 
 > **A**(...`args`): `undefined` \| `Element`
 
-Defined in: [aberdeen.ts:2412](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2412)
+Defined in: [aberdeen.ts:2418](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2418)
 
 The core function for building reactive user interfaces in Aberdeen. It creates and inserts new DOM elements
 and sets attributes/properties/event listeners on DOM elements. It does so in a reactive way, meaning that
@@ -2338,6 +2338,8 @@ For conciseness, Aberdeen supports some CSS shortcuts when setting CSS propertie
 
 Also, when the value is a string starting with `$`, it is treated as a reference to a CSS variable, expanding to `var(--variableName)`. For numeric variable names (which can't be used directly as CSS custom property names), Aberdeen prefixes them with `m`, so `$3` expands to `var(--m3)`. This is primarily intended for use with [setSpacingCssVars](#setspacingcssvars), which initializes spacing variables named `0` through `12` with an exponential spacing scale.
 
+To *set* a CSS custom property inline on an element, use a `--name` or (symmetrically with the `$`-reference syntax above) a `$name` key. For example `A('div --primary:red')` and `A('div $primary:red')` both set `--primary` to `red`.
+
 #### Returns
 
 `undefined` \| `Element`
@@ -2400,7 +2402,7 @@ This is often used together with [ref](#ref), in order to use properties other t
 
 > **clean**(`cleaner`): `void`
 
-Defined in: [aberdeen.ts:2948](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2948)
+Defined in: [aberdeen.ts:2965](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2965)
 
 Registers a cleanup function to be executed just before the current reactive scope
 is destroyed or redraws.
@@ -2455,7 +2457,7 @@ setInterval(() => $numbers[rnd()] = rnd(), 1000);
 
 > **clone**\<`T`\>(`src`): `T`
 
-Defined in: [aberdeen.ts:2094](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2094)
+Defined in: [aberdeen.ts:2098](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2098)
 
 Clone an (optionally proxied) object or array.
 
@@ -2489,7 +2491,7 @@ A new unproxied array or object (of the same type as `src`), containing a deep c
 
 > **copy**\<`T`\>(`dst`, `src`): `boolean`
 
-Defined in: [aberdeen.ts:1709](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1709)
+Defined in: [aberdeen.ts:1712](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1712)
 
 Recursively copies properties or array items from `src` to `dst`.
 It's designed to work efficiently with reactive proxies created by [proxy](#proxy).
@@ -2548,7 +2550,7 @@ console.log($dest); // proxy({ a: 1, b: { e: 4 } })
 
 > **copy**\<`T`\>(`dst`, `dstKey`, `src`): `boolean`
 
-Defined in: [aberdeen.ts:1716](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1716)
+Defined in: [aberdeen.ts:1719](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1719)
 
 Like above, but copies `src` into `dst[dstKey]`. This is useful if you're unsure if dst[dstKey]
 already exists (as the right type of object) or if you don't want to subscribe to dst[dstKey].
@@ -2585,7 +2587,7 @@ Optional key in `dst` to copy into.
 
 > **count**(`proxied`): `ValueRef`\<`number`\>
 
-Defined in: [aberdeen.ts:1157](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1157)
+Defined in: [aberdeen.ts:1160](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1160)
 
 Reactively counts the number of properties in an object.
 
@@ -2630,7 +2632,7 @@ $items.z = 12;
 
 > **darkMode**(): `boolean`
 
-Defined in: [aberdeen.ts:2051](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2051)
+Defined in: [aberdeen.ts:2055](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2055)
 
 Returns whether the user's browser prefers a dark color scheme.
 
@@ -2665,7 +2667,7 @@ A('div bg:$bg fg:$fg p:1rem #Colors change based on system dark mode preference'
 
 > **derive**\<`T`\>(`func`): `ValueRef`\<`T`\>
 
-Defined in: [aberdeen.ts:3000](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3000)
+Defined in: [aberdeen.ts:3017](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3017)
 
 Creates a reactive scope that automatically re-executes the provided function
 whenever any proxied data (created by [proxy](#proxy)) read during its last execution changes, storing
@@ -2734,7 +2736,7 @@ A('h3', () => {
 
 > **disableCreateDestroy**(): `void`
 
-Defined in: [aberdeen.ts:2288](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2288)
+Defined in: [aberdeen.ts:2292](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2292)
 
 Make the `create` and `destroy` special properties no-ops.
 
@@ -2754,7 +2756,7 @@ once disabled.
 
 > **dump**\<`T`\>(`data`): `T`
 
-Defined in: [aberdeen.ts:3421](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3421)
+Defined in: [aberdeen.ts:3438](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3438)
 
 Renders a live, recursive dump of a proxied data structure (or any value)
 into the DOM at the current [A](#a) insertion point.
@@ -2807,7 +2809,7 @@ setTimeout(() => { $state.user.kids++; $state.items.push('c'); }, 2000);
 
 > **insertCss**(`style`): `string`
 
-Defined in: [aberdeen.ts:2610](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2610)
+Defined in: [aberdeen.ts:2616](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2616)
 
 Inserts CSS rules into the document, scoping them with a unique class name.
 
@@ -2892,7 +2894,7 @@ A(badge + ' span#Product Name');
 
 > **insertGlobalCss**(`style`): `void`
 
-Defined in: [aberdeen.ts:2762](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2762)
+Defined in: [aberdeen.ts:2768](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2768)
 
 Inserts CSS rules globally (unscoped).
 
@@ -2966,7 +2968,7 @@ A.insertGlobalCss({
 
 > **invertString**(`input`): `string`
 
-Defined in: [aberdeen.ts:192](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L192)
+Defined in: [aberdeen.ts:195](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L195)
 
 Creates a new string that has the opposite sort order compared to the input string.
 
@@ -3015,7 +3017,7 @@ A.onEach($users, ($user) => {
 
 > **isEmpty**(`proxied`): `boolean`
 
-Defined in: [aberdeen.ts:1095](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1095)
+Defined in: [aberdeen.ts:1098](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1098)
 
 Reactively checks if an observable array, object, Map, or Set is empty.
 
@@ -3117,7 +3119,7 @@ $users.u2.active = true;
 
 > **map**\<`K`, `IN`, `OUT`\>(`source`, `func`): `Map`\<`K`, `OUT`\>
 
-Defined in: [aberdeen.ts:3108](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3108)
+Defined in: [aberdeen.ts:3125](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3125)
 
 When using a Map as `source`.
 
@@ -3153,7 +3155,7 @@ When using a Map as `source`.
 
 > **map**\<`IN`, `OUT`\>(`source`, `func`): `OUT`[]
 
-Defined in: [aberdeen.ts:3113](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3113)
+Defined in: [aberdeen.ts:3130](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3130)
 
 When using an array as `source`.
 
@@ -3185,7 +3187,7 @@ When using an array as `source`.
 
 > **map**\<`IN`, `IN_KEY`, `OUT`\>(`source`, `func`): `Record`\<`string` \| `symbol`, `OUT`\>
 
-Defined in: [aberdeen.ts:3118](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3118)
+Defined in: [aberdeen.ts:3135](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3135)
 
 When using an object as `source`.
 
@@ -3225,7 +3227,7 @@ When using an object as `source`.
 
 > **merge**\<`T`\>(`dst`, `value`): `boolean`
 
-Defined in: [aberdeen.ts:1749](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1749)
+Defined in: [aberdeen.ts:1752](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1752)
 
 Like [copy](#copy), but uses merge semantics. Properties in `dst` not present in `src` are kept.
 `null`/`undefined` in `src` delete properties in `dst`.
@@ -3265,7 +3267,7 @@ console.log($dest); // proxy({ a: 1, b: { c: 99, x: 5, y: 6 }, c: { z: 7 } })
 
 > **merge**\<`T`\>(`dst`, `dstKey`, `value`): `boolean`
 
-Defined in: [aberdeen.ts:1750](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1750)
+Defined in: [aberdeen.ts:1753](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1753)
 
 Like [copy](#copy), but uses merge semantics. Properties in `dst` not present in `src` are kept.
 `null`/`undefined` in `src` delete properties in `dst`.
@@ -3311,7 +3313,7 @@ console.log($dest); // proxy({ a: 1, b: { c: 99, x: 5, y: 6 }, c: { z: 7 } })
 
 > **mount**(`parentElement`, `func`): `void`
 
-Defined in: [aberdeen.ts:3047](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3047)
+Defined in: [aberdeen.ts:3064](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3064)
 
 Attaches a reactive Aberdeen UI fragment to an existing DOM element. Without the use of
 this function, [A](#a) will assume `document.body` as its root.
@@ -3429,7 +3431,7 @@ $items.push({ id: 'c', value: 30 });
 
 > **multiMap**\<`IN`, `OUT`\>(`source`, `func`): `OUT`
 
-Defined in: [aberdeen.ts:3198](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3198)
+Defined in: [aberdeen.ts:3215](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3215)
 
 When using an array as `source`.
 
@@ -3461,7 +3463,7 @@ When using an array as `source`.
 
 > **multiMap**\<`K`, `IN`, `OUT`\>(`source`, `func`): `OUT`
 
-Defined in: [aberdeen.ts:3203](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3203)
+Defined in: [aberdeen.ts:3220](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3220)
 
 When using an object as `source`.
 
@@ -3497,7 +3499,7 @@ When using an object as `source`.
 
 > **multiMap**\<`K`, `IN`, `OUT`\>(`source`, `func`): `OUT`
 
-Defined in: [aberdeen.ts:3209](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3209)
+Defined in: [aberdeen.ts:3226](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3226)
 
 When using a Map as `source`.
 
@@ -3613,7 +3615,7 @@ setTimeout(() => $tags.add('reactive'), 2000);
 
 > **onEach**\<`K`, `T`\>(`target`, `render`, `makeKey?`): `void`
 
-Defined in: [aberdeen.ts:954](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L954)
+Defined in: [aberdeen.ts:957](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L957)
 
 ##### Type Parameters
 
@@ -3647,7 +3649,7 @@ Defined in: [aberdeen.ts:954](https://github.com/vanviegen/aberdeen/blob/55a4fa0
 
 > **onEach**\<`T`\>(`target`, `render`, `makeKey?`): `void`
 
-Defined in: [aberdeen.ts:959](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L959)
+Defined in: [aberdeen.ts:962](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L962)
 
 ##### Type Parameters
 
@@ -3677,7 +3679,7 @@ Defined in: [aberdeen.ts:959](https://github.com/vanviegen/aberdeen/blob/55a4fa0
 
 > **onEach**\<`T`\>(`target`, `render`, `makeKey?`): `void`
 
-Defined in: [aberdeen.ts:964](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L964)
+Defined in: [aberdeen.ts:967](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L967)
 
 ##### Type Parameters
 
@@ -3707,7 +3709,7 @@ readonly (`undefined` \| `T`)[]
 
 > **onEach**\<`K`, `T`\>(`target`, `render`, `makeKey?`): `void`
 
-Defined in: [aberdeen.ts:969](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L969)
+Defined in: [aberdeen.ts:972](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L972)
 
 ##### Type Parameters
 
@@ -3820,7 +3822,7 @@ console.log($usersByTag);
 
 > **partition**\<`OUT_K`, `IN_V`\>(`source`, `func`): `Record`\<`OUT_K`, `Record`\<`number`, `IN_V`\>\>
 
-Defined in: [aberdeen.ts:3273](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3273)
+Defined in: [aberdeen.ts:3290](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3290)
 
 When using an object as `array`.
 
@@ -3852,7 +3854,7 @@ When using an object as `array`.
 
 > **partition**\<`IN_K`, `OUT_K`, `IN_V`\>(`source`, `func`): `Record`\<`OUT_K`, `Record`\<`IN_K`, `IN_V`\>\>
 
-Defined in: [aberdeen.ts:3278](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3278)
+Defined in: [aberdeen.ts:3295](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3295)
 
 When using an object as `source`.
 
@@ -3888,7 +3890,7 @@ When using an object as `source`.
 
 > **partition**\<`IN_K`, `OUT_K`, `IN_V`\>(`source`, `func`): `Record`\<`OUT_K`, `Record`\<`IN_K`, `IN_V`\>\>
 
-Defined in: [aberdeen.ts:3287](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3287)
+Defined in: [aberdeen.ts:3304](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3304)
 
 When using a Map as `source`.
 
@@ -3928,7 +3930,7 @@ When using a Map as `source`.
 
 > **peek**\<`T`, `K`\>(`target`, `key`): `T`\[`K`\]
 
-Defined in: [aberdeen.ts:3089](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3089)
+Defined in: [aberdeen.ts:3106](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3106)
 
 Executes a function or retrieves a value *without* creating subscriptions in the current reactive scope, and returns its result.
 
@@ -3984,7 +3986,7 @@ $data.a = 2; // Triggers console.log (logs "A is 2, B was 3 when A changed.")
 
 > **peek**\<`K`, `V`\>(`target`, `key`): `undefined` \| `V`
 
-Defined in: [aberdeen.ts:3090](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3090)
+Defined in: [aberdeen.ts:3107](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3107)
 
 Executes a function or retrieves a value *without* creating subscriptions in the current reactive scope, and returns its result.
 
@@ -4040,7 +4042,7 @@ $data.a = 2; // Triggers console.log (logs "A is 2, B was 3 when A changed.")
 
 > **peek**\<`T`\>(`target`, `key`): `undefined` \| `T`
 
-Defined in: [aberdeen.ts:3091](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3091)
+Defined in: [aberdeen.ts:3108](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3108)
 
 Executes a function or retrieves a value *without* creating subscriptions in the current reactive scope, and returns its result.
 
@@ -4092,7 +4094,7 @@ $data.a = 2; // Triggers console.log (logs "A is 2, B was 3 when A changed.")
 
 > **peek**\<`T`\>(`target`): `T`
 
-Defined in: [aberdeen.ts:3092](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3092)
+Defined in: [aberdeen.ts:3109](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3109)
 
 Executes a function or retrieves a value *without* creating subscriptions in the current reactive scope, and returns its result.
 
@@ -4207,7 +4209,7 @@ setTimeout(() => $graph.grow(), 4000);
 
 > **proxy**\<`T`\>(`target`): [`PromiseProxy`](#promiseproxy)\<`T`\>
 
-Defined in: [aberdeen.ts:1543](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1543)
+Defined in: [aberdeen.ts:1546](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1546)
 
 ##### Type Parameters
 
@@ -4229,7 +4231,7 @@ Defined in: [aberdeen.ts:1543](https://github.com/vanviegen/aberdeen/blob/55a4fa
 
 > **proxy**\<`T`\>(`target`): `T` *extends* `number` ? `number` : `T` *extends* `string` ? `string` : `T` *extends* `boolean` ? `boolean` : `T`[]
 
-Defined in: [aberdeen.ts:1544](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1544)
+Defined in: [aberdeen.ts:1547](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1547)
 
 ##### Type Parameters
 
@@ -4251,7 +4253,7 @@ Defined in: [aberdeen.ts:1544](https://github.com/vanviegen/aberdeen/blob/55a4fa
 
 > **proxy**\<`T`\>(`target`): `T`
 
-Defined in: [aberdeen.ts:1545](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1545)
+Defined in: [aberdeen.ts:1548](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1548)
 
 ##### Type Parameters
 
@@ -4273,7 +4275,7 @@ Defined in: [aberdeen.ts:1545](https://github.com/vanviegen/aberdeen/blob/55a4fa
 
 > **proxy**\<`T`\>(`target`): `ValueRef`\<`T` *extends* `number` ? `number` : `T` *extends* `string` ? `string` : `T` *extends* `boolean` ? `boolean` : `T`\>
 
-Defined in: [aberdeen.ts:1546](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1546)
+Defined in: [aberdeen.ts:1549](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1549)
 
 ##### Type Parameters
 
@@ -4297,7 +4299,7 @@ Defined in: [aberdeen.ts:1546](https://github.com/vanviegen/aberdeen/blob/55a4fa
 
 > **ref**\<`T`, `K`\>(`target`, `index`): `ValueRef`\<`T`\[`K`\]\>
 
-Defined in: [aberdeen.ts:2156](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2156)
+Defined in: [aberdeen.ts:2160](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2160)
 
 Creates a reactive reference (`{ value: T }`-like object) to a specific value
 within a proxied object or array.
@@ -4359,7 +4361,7 @@ A(() => console.log($formData))
 
 > **runQueue**(): `void`
 
-Defined in: [aberdeen.ts:107](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L107)
+Defined in: [aberdeen.ts:110](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L110)
 
 Forces the immediate and synchronous execution of all pending reactive updates.
 
@@ -4402,7 +4404,7 @@ console.log(2, document.body.innerHTML); // after
 
 > **setErrorHandler**(`handler?`): `void`
 
-Defined in: [aberdeen.ts:2904](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2904)
+Defined in: [aberdeen.ts:2921](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2921)
 
 Sets a custom error handler function for errors that occur asynchronously
 within reactive scopes (e.g., during updates triggered by proxy changes in
@@ -4462,7 +4464,7 @@ A('div.box', () => {
 
 > **setSpacingCssVars**(`base`, `unit`): `void`
 
-Defined in: [aberdeen.ts:2000](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L2000)
+Defined in: [aberdeen.ts:2003](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L2003)
 
 Initializes `cssVars[0]` through `cssVars[12]` with an exponential spacing scale.
 
@@ -4511,7 +4513,7 @@ A.onEach(A.cssVars, (value, key) => {
 
 > **unmountAll**(): `void`
 
-Defined in: [aberdeen.ts:3058](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L3058)
+Defined in: [aberdeen.ts:3075](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L3075)
 
 Removes all Aberdeen-managed DOM nodes and stops all active reactive scopes
 (created by [mount](#mount), [derive](#derive), [A](#a) with functions, etc.).
@@ -4529,7 +4531,7 @@ automated tests, there should probably be little reason to call this function.
 
 > **unproxy**\<`T`\>(`target`): `T`
 
-Defined in: [aberdeen.ts:1668](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/aberdeen.ts#L1668)
+Defined in: [aberdeen.ts:1671](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/aberdeen.ts#L1671)
 
 Returns the original, underlying data target from a reactive proxy created by [proxy](#proxy).
 If the input `target` is not a proxy, it is returned directly.

package/skill/dispatcher.md

@@ -1,4 +1,4 @@
-[**Aberdeen v1.18.1**](README.md)
+[**Aberdeen v1.18.2**](README.md)
 
 ***
 
@@ -10,7 +10,7 @@
 
 ### Dispatcher
 
-Defined in: [dispatcher.ts:61](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/dispatcher.ts#L61)
+Defined in: [dispatcher.ts:61](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/dispatcher.ts#L61)
 
 Simple route matcher and dispatcher.
 
@@ -53,7 +53,7 @@ dispatcher.dispatch(["search", "classical", "piano"]);
 
 > **addRoute**\<`T`, `H`\>(...`args`): `void`
 
-Defined in: [dispatcher.ts:73](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/dispatcher.ts#L73)
+Defined in: [dispatcher.ts:73](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/dispatcher.ts#L73)
 
 Add a route with matchers and a handler function.
 
@@ -90,7 +90,7 @@ An array of matchers followed by a handler function. Each matcher can be:
 
 > **dispatch**(`segments`): `boolean`
 
-Defined in: [dispatcher.ts:94](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/dispatcher.ts#L94)
+Defined in: [dispatcher.ts:94](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/dispatcher.ts#L94)
 
 Dispatches the given segments to the first route handler that matches.
 
@@ -114,7 +114,7 @@ True if a matching route was found and handled, false otherwise.
 
 > `const` **MATCH\_FAILED**: unique `symbol`
 
-Defined in: [dispatcher.ts:4](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/dispatcher.ts#L4)
+Defined in: [dispatcher.ts:4](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/dispatcher.ts#L4)
 
 Symbol to return when a custom [Dispatcher.addRoute](#addroute) matcher cannot match a segment.
 
@@ -124,6 +124,6 @@ Symbol to return when a custom [Dispatcher.addRoute](#addroute) matcher cannot m
 
 > `const` **MATCH\_REST**: unique `symbol`
 
-Defined in: [dispatcher.ts:9](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/dispatcher.ts#L9)
+Defined in: [dispatcher.ts:9](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/dispatcher.ts#L9)
 
 Special [Dispatcher.addRoute](#addroute) matcher that matches the rest of the segments as an array of strings.

package/skill/prediction.md

@@ -1,4 +1,4 @@
-[**Aberdeen v1.18.1**](README.md)
+[**Aberdeen v1.18.2**](README.md)
 
 ***
 
@@ -12,7 +12,7 @@
 
 > **applyCanon**(`canonFunc?`, `dropPredictions?`): `void`
 
-Defined in: [prediction.ts:136](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/prediction.ts#L136)
+Defined in: [prediction.ts:136](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/prediction.ts#L136)
 
 Temporarily revert all outstanding predictions, optionally run the provided function
 (which will generally make authoritative changes to the data based on a server response),
@@ -50,7 +50,7 @@ An optional list of predictions (as returned by `applyPrediction`)
 
 > **applyPrediction**(`predictFunc`): `Patch`
 
-Defined in: [prediction.ts:114](https://github.com/vanviegen/aberdeen/blob/55a4fa0c4453a12cdb744d6fa13f1a739c06c0a0/src/prediction.ts#L114)
+Defined in: [prediction.ts:114](https://github.com/vanviegen/aberdeen/blob/ae96ee5d2bf101de8d04c7efc61a03e8fe8fe6f7/src/prediction.ts#L114)
 
 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