@reykjavik/webtools 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.3.1
+
+_2025-11-10_
+
+- docs: Update JSDoc @see links to point to new version branch
+
 ## 0.3.0
 
 _2025-11-10_

package/CookieHubConsent.d.ts

@@ -220,14 +220,14 @@ export type CookieHubProviderProps = EitherObj<{
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cookiehubprovider-component
  */
 export declare const CookieHubProvider: (props: CookieHubProviderProps) => React.JSX.Element;
 /**
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usecookiehubconsent
  */
 export declare const useCookieHubConsent: () => Partial<CookieHubContextState["consent"]>;
 export {};

package/CookieHubConsent.js

@@ -71,7 +71,7 @@ const moveCookiehubScriptInDomTree = () => {
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cookiehubprovider-component
  */
 const CookieHubProvider = (props) => {
     const [state, setState] = (0, react_1.useState)(initialConsentState);
@@ -159,7 +159,7 @@ exports.CookieHubProvider = CookieHubProvider;
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usecookiehubconsent
  */
 const useCookieHubConsent = () => { var _a; return ((_a = (0, react_1.useContext)(CookieHubContext)) === null || _a === void 0 ? void 0 : _a.consent) || {}; };
 exports.useCookieHubConsent = useCookieHubConsent;

package/SiteImprove.d.ts

@@ -45,14 +45,14 @@ type SiteImproveCustomEvent = [
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimprove-helper
  */
 export declare const pingSiteImprove: (category: string, action: string, label?: string) => void;
 /**
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimproveoutbound-helper
  */
 export declare const pingSiteImproveOutbound: (ourl: string) => void;
 export type SiteImproveProps = EitherObj<{
@@ -94,7 +94,7 @@ export type SiteImproveProps = EitherObj<{
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#siteimprove-component
  */
 export declare const SiteImprove: (props: SiteImproveProps) => null;
 export {};

package/SiteImprove.js

@@ -29,7 +29,7 @@ const trackDynamicPageView = (url, refUrl, title) => _emitEvent(['trackdynamic',
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimprove-helper
  */
 const pingSiteImprove = (category, action, label) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -44,7 +44,7 @@ exports.pingSiteImprove = pingSiteImprove;
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimproveoutbound-helper
  */
 const pingSiteImproveOutbound = (ourl) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -125,7 +125,7 @@ const loc = typeof document !== 'undefined' ? document.location : {};
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#siteimprove-component
  */
 const SiteImprove = (props) => {
     const consented = useResolvedAnalyticsConsent(props.hasConsented);

package/async.d.ts

@@ -18,7 +18,7 @@ export declare const addLag: (length: number, opts?: {
  * Resolves as soon as all of the passed `promises` have resolved/settled,
  * or after `timeout` milliseconds — whichever comes first.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#maxwait
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#maxwait
  */
 export declare function maxWait(timeout: number, promises: Array<unknown>): Promise<void>;
 export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, promises: PromiseMap): Promise<{
@@ -28,7 +28,7 @@ export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, pr
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#promiseallobject
  */
 export declare const promiseAllObject: <T extends PlainObj>(promisesMap: T) => Promise<{ -readonly [K in keyof T]: Awaited<T[K]>; }>;
 type Cancellable<A extends Array<unknown>> = ((...args: A) => void) & {
@@ -44,7 +44,7 @@ type Cancellable<A extends Array<unknown>> = ((...args: A) => void) & {
  * of quiet-time.  \
  * The returned function also has a nice `.cancel()` method.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#debounce
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#debounce
  */
 export declare const debounce: {
     <A extends Array<unknown>>(func: (...args: A) => void, delay: number, immediate?: boolean): Cancellable<A>;
@@ -64,7 +64,7 @@ type Finishable<A extends Array<unknown>> = ((...args: A) => void) & {
  * The returned function also has a nice `.finish()` method to reset the
  * throttle timer
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#throttle
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#throttle
  */
 export declare const throttle: {
     <A extends Array<unknown>>(func: (...args: A) => void, delay: number, skipFirst?: boolean): Finishable<A>;

package/async.js

@@ -67,7 +67,7 @@ function maxWait(timeout, promises) {
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#promiseallobject
  */
 /*#__NO_SIDE_EFFECTS__*/
 const promiseAllObject = (promisesMap) => Promise.all(Object.values(promisesMap)).then((results) => {
@@ -84,7 +84,7 @@ exports.promiseAllObject = promiseAllObject;
  * of quiet-time.  \
  * The returned function also has a nice `.cancel()` method.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#debounce
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#debounce
  */
 /*#__NO_SIDE_EFFECTS__*/
 const debounce = (
@@ -136,7 +136,7 @@ exports.debounce.d = (delay, immediate) => (0, exports.debounce)(function (fn, .
  * The returned function also has a nice `.finish()` method to reset the
  * throttle timer
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#throttle
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#throttle
  */
 /*#__NO_SIDE_EFFECTS__*/
 const throttle = (

package/errorhandling.d.ts

@@ -2,7 +2,7 @@
  * Error subclass for thrown NON-Error values that got turned into an actual
  * Error, with the original thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
     /**
@@ -25,7 +25,7 @@ export declare class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 export declare const asError: (maybeError: unknown) => ErrorFromPayload;
 type SuccessResult<T> = [error: undefined, result: T] & {
@@ -41,14 +41,14 @@ type FailResult<E extends Error> = [error: E, result?: undefined] & {
 /**
  * Simple bare-bones discriminated tuple type for a [error, result] pair.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttuple
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resulttuple
  */
 export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E, result?: undefined];
 /**
  * Discriminated tuple type for a `[error, result]` pair (same as `ResultTuple`)
  * but with named properties `error` and `result` attached for dev convenience.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttupleobj
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resulttupleobj
  */
 export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | FailResult<E>;
 /**
@@ -60,7 +60,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  *
  * Works on both promises and (synchronous) callback functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultcatch
  */
 declare function catch_<T, E extends Error = ErrorFromPayload>(promise: Promise<T>): Promise<ResultTupleObj<T, E>>;
 declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T): ResultTupleObj<T, E>;
@@ -68,19 +68,19 @@ declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#result-singleton
  */
 export declare const Result: {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsuccess
      */
     Success: <T>(result: T) => SuccessResult<T>;
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
     Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
     catch: typeof catch_;
@@ -90,14 +90,14 @@ export declare const Result: {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulmap
      */
     map: <T, T2, E extends Error>(result: ResultTuple<T, E>, mapFn: (resultValue: T) => T2) => ResultTupleObj<T2, E>;
     /**
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulthrow
      */
     throw: <T>(result: ResultTuple<T>) => T;
 };

package/errorhandling.js

@@ -5,7 +5,7 @@ exports.Result = exports.asError = exports.ErrorFromPayload = void 0;
  * Error subclass for thrown NON-Error values that got turned into an actual
  * Error, with the original thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 /*#__NO_SIDE_EFFECTS__*/
 class ErrorFromPayload extends Error {
@@ -28,7 +28,7 @@ exports.ErrorFromPayload = ErrorFromPayload;
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 /*#__NO_SIDE_EFFECTS__*/
 const asError = (maybeError) => {
@@ -79,19 +79,19 @@ mapFn) => {
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#result-singleton
  */
 exports.Result = {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsuccess
      */
     Success,
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
     Fail,
     // NOTE: The JSDoc must be placed above the `catch_` function above.
@@ -102,7 +102,7 @@ exports.Result = {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulmap
      */
     /*#__NO_SIDE_EFFECTS__*/
     map: (result, mapFn) => {
@@ -116,7 +116,7 @@ exports.Result = {
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulthrow
      */
     /*#__NO_SIDE_EFFECTS__*/
     throw: (result) => {

package/esm/CookieHubConsent.d.ts

@@ -220,14 +220,14 @@ export type CookieHubProviderProps = EitherObj<{
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cookiehubprovider-component
  */
 export declare const CookieHubProvider: (props: CookieHubProviderProps) => React.JSX.Element;
 /**
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usecookiehubconsent
  */
 export declare const useCookieHubConsent: () => Partial<CookieHubContextState["consent"]>;
 export {};

package/esm/CookieHubConsent.js

@@ -35,7 +35,7 @@ const moveCookiehubScriptInDomTree = () => {
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cookiehubprovider-component
  */
 export const CookieHubProvider = (props) => {
     const [state, setState] = useState(initialConsentState);
@@ -122,6 +122,6 @@ export const CookieHubProvider = (props) => {
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usecookiehubconsent
  */
 export const useCookieHubConsent = () => { var _a; return ((_a = useContext(CookieHubContext)) === null || _a === void 0 ? void 0 : _a.consent) || {}; };

package/esm/SiteImprove.d.ts

@@ -45,14 +45,14 @@ type SiteImproveCustomEvent = [
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimprove-helper
  */
 export declare const pingSiteImprove: (category: string, action: string, label?: string) => void;
 /**
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimproveoutbound-helper
  */
 export declare const pingSiteImproveOutbound: (ourl: string) => void;
 export type SiteImproveProps = EitherObj<{
@@ -94,7 +94,7 @@ export type SiteImproveProps = EitherObj<{
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#siteimprove-component
  */
 export declare const SiteImprove: (props: SiteImproveProps) => null;
 export {};

package/esm/SiteImprove.js

@@ -26,7 +26,7 @@ const trackDynamicPageView = (url, refUrl, title) => _emitEvent(['trackdynamic',
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimprove-helper
  */
 export const pingSiteImprove = (category, action, label) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -40,7 +40,7 @@ export const pingSiteImprove = (category, action, label) => {
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#pingsiteimproveoutbound-helper
  */
 export const pingSiteImproveOutbound = (ourl) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -120,7 +120,7 @@ const loc = typeof document !== 'undefined' ? document.location : {};
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#siteimprove-component
  */
 export const SiteImprove = (props) => {
     const consented = useResolvedAnalyticsConsent(props.hasConsented);

package/esm/async.d.ts

@@ -18,7 +18,7 @@ export declare const addLag: (length: number, opts?: {
  * Resolves as soon as all of the passed `promises` have resolved/settled,
  * or after `timeout` milliseconds — whichever comes first.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#maxwait
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#maxwait
  */
 export declare function maxWait(timeout: number, promises: Array<unknown>): Promise<void>;
 export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, promises: PromiseMap): Promise<{
@@ -28,7 +28,7 @@ export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, pr
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#promiseallobject
  */
 export declare const promiseAllObject: <T extends PlainObj>(promisesMap: T) => Promise<{ -readonly [K in keyof T]: Awaited<T[K]>; }>;
 type Cancellable<A extends Array<unknown>> = ((...args: A) => void) & {
@@ -44,7 +44,7 @@ type Cancellable<A extends Array<unknown>> = ((...args: A) => void) & {
  * of quiet-time.  \
  * The returned function also has a nice `.cancel()` method.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#debounce
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#debounce
  */
 export declare const debounce: {
     <A extends Array<unknown>>(func: (...args: A) => void, delay: number, immediate?: boolean): Cancellable<A>;
@@ -64,7 +64,7 @@ type Finishable<A extends Array<unknown>> = ((...args: A) => void) & {
  * The returned function also has a nice `.finish()` method to reset the
  * throttle timer
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#throttle
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#throttle
  */
 export declare const throttle: {
     <A extends Array<unknown>>(func: (...args: A) => void, delay: number, skipFirst?: boolean): Finishable<A>;

package/esm/async.js

@@ -61,7 +61,7 @@ export function maxWait(timeout, promises) {
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#promiseallobject
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const promiseAllObject = (promisesMap) => Promise.all(Object.values(promisesMap)).then((results) => {
@@ -77,7 +77,7 @@ export const promiseAllObject = (promisesMap) => Promise.all(Object.values(promi
  * of quiet-time.  \
  * The returned function also has a nice `.cancel()` method.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#debounce
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#debounce
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const debounce = (
@@ -128,7 +128,7 @@ debounce.d = (delay, immediate) => debounce(function (fn, ...args) {
  * The returned function also has a nice `.finish()` method to reset the
  * throttle timer
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#throttle
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#throttle
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const throttle = (

package/esm/errorhandling.d.ts

@@ -2,7 +2,7 @@
  * Error subclass for thrown NON-Error values that got turned into an actual
  * Error, with the original thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
     /**
@@ -25,7 +25,7 @@ export declare class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 export declare const asError: (maybeError: unknown) => ErrorFromPayload;
 type SuccessResult<T> = [error: undefined, result: T] & {
@@ -41,14 +41,14 @@ type FailResult<E extends Error> = [error: E, result?: undefined] & {
 /**
  * Simple bare-bones discriminated tuple type for a [error, result] pair.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttuple
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resulttuple
  */
 export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E, result?: undefined];
 /**
  * Discriminated tuple type for a `[error, result]` pair (same as `ResultTuple`)
  * but with named properties `error` and `result` attached for dev convenience.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttupleobj
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resulttupleobj
  */
 export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | FailResult<E>;
 /**
@@ -60,7 +60,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  *
  * Works on both promises and (synchronous) callback functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultcatch
  */
 declare function catch_<T, E extends Error = ErrorFromPayload>(promise: Promise<T>): Promise<ResultTupleObj<T, E>>;
 declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T): ResultTupleObj<T, E>;
@@ -68,19 +68,19 @@ declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#result-singleton
  */
 export declare const Result: {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsuccess
      */
     Success: <T>(result: T) => SuccessResult<T>;
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
     Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
     catch: typeof catch_;
@@ -90,14 +90,14 @@ export declare const Result: {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulmap
      */
     map: <T, T2, E extends Error>(result: ResultTuple<T, E>, mapFn: (resultValue: T) => T2) => ResultTupleObj<T2, E>;
     /**
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulthrow
      */
     throw: <T>(result: ResultTuple<T>) => T;
 };

package/esm/errorhandling.js

@@ -2,7 +2,7 @@
  * Error subclass for thrown NON-Error values that got turned into an actual
  * Error, with the original thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 /*#__NO_SIDE_EFFECTS__*/
 export class ErrorFromPayload extends Error {
@@ -24,7 +24,7 @@ export class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#aserror
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const asError = (maybeError) => {
@@ -74,19 +74,19 @@ mapFn) => {
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#result-singleton
  */
 export const Result = {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsuccess
      */
     Success,
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
     Fail,
     // NOTE: The JSDoc must be placed above the `catch_` function above.
@@ -97,7 +97,7 @@ export const Result = {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulmap
      */
     /*#__NO_SIDE_EFFECTS__*/
     map: (result, mapFn) => {
@@ -111,7 +111,7 @@ export const Result = {
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resulthrow
      */
     /*#__NO_SIDE_EFFECTS__*/
     throw: (result) => {

package/esm/hooks.d.ts

@@ -6,7 +6,7 @@
  * **NOTE:** The supplied callback does not need to be memoized. The debouncer
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usedebounced
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usedebounced
  */
 export declare const useDebounced: <A extends Array<unknown>>(
 /** The function to debounce */
@@ -23,7 +23,7 @@ immediate?: boolean) => ((...args: A) => void) & {
  * **NOTE:** The supplied callback does not need to be memoized. The throttler
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usethrottled
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usethrottled
  */
 export declare const useThrottled: <A extends Array<unknown>>(
 /** The function to throttle */

package/esm/hooks.js

@@ -8,7 +8,7 @@ import { debounce, throttle } from './async.js';
  * **NOTE:** The supplied callback does not need to be memoized. The debouncer
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usedebounced
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usedebounced
  */
 export const useDebounced = (
 /** The function to debounce */
@@ -29,7 +29,7 @@ immediate) => {
  * **NOTE:** The supplied callback does not need to be memoized. The throttler
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usethrottled
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usethrottled
  */
 export const useThrottled = (
 /** The function to throttle */

package/esm/http.d.ts

@@ -154,21 +154,21 @@ type TTLObj = {
 /**
  * Configures quick TTL-related settings for a HTTP request object
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-ttlconfig
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-ttlconfig
  */
 export type TTLConfig = TTL | TTLKeywords | TTLObj;
 /**
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#toms-duration-helper
  */
 export declare const toMs: (ttl: TTL) => number;
 /**
  * Converts a `TTL` (max-age) value into seconds. Returns `0` for bad and/or
  * negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#tosec-ttl-helper
  */
 export declare const toSec: (ttl: TTL) => number;
 type ServerResponseStub = Pick<ServerResponse, 'setHeader' | 'getHeader' | 'removeHeader'> & {
@@ -181,7 +181,7 @@ type ResponseStub = {
  * Use this function to quickly set the `Cache-Control` header with a `max-age=`
  * on a HTTP response
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrol-helper
  */
 export declare const cacheControl: (response: ServerResponseStub | ResponseStub | Map<string, string> | {
     res: ServerResponseStub | ResponseStub;
@@ -191,7 +191,7 @@ export declare const cacheControl: (response: ServerResponseStub | ResponseStub
  * situations requiring a `HeadersInit` compatible object.
  *
  * Accepts the same arguments as `cacheControl()`.
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrolheaders-helper
  */
 export declare const cacheControlHeaders: (ttlCfg: TTLConfig, eTag?: string | number) => Record<string, string>;
 export {};

package/esm/http.js

@@ -136,7 +136,7 @@ const unitToMilliseconds = {
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#toms-duration-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const toMs = (ttl) => {
@@ -154,7 +154,7 @@ export const toMs = (ttl) => {
  * Converts a `TTL` (max-age) value into seconds. Returns `0` for bad and/or
  * negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#tosec-ttl-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const toSec = (ttl) => {
@@ -207,7 +207,7 @@ const setCC = (response, cc) => {
  * Use this function to quickly set the `Cache-Control` header with a `max-age=`
  * on a HTTP response
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrol-helper
  */
 /*#__NO_SIDE_EFFECTS__*/ // eslint-disable-next-line complexity
 export const cacheControl = (response, ttlCfg, eTag) => {
@@ -250,7 +250,7 @@ export const cacheControl = (response, ttlCfg, eTag) => {
  * situations requiring a `HeadersInit` compatible object.
  *
  * Accepts the same arguments as `cacheControl()`.
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrolheaders-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const cacheControlHeaders = (ttlCfg, eTag) => {

package/esm/next/http.d.ts

@@ -25,7 +25,7 @@ export type InferErrorPageProps<SEP extends ShowErrorPageFn<any>> = Cleanup<Retu
  * cases when `getServerSideProps` returns an `__error` prop with `statusCode`
  * and optional friendly `message`.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#makeerrorizeapphoc
  */
 export declare const makeErrorizeAppHOC: <EP extends Partial<ErrorProps>>(ErrorPage: FunctionComponent<EP>) => {
     <P extends {
@@ -47,7 +47,7 @@ export declare const makeErrorizeAppHOC: <EP extends Partial<ErrorProps>>(ErrorP
  * to return an `HTTP_304_NotModified` response with an empty props object,
  * in a way that doesn't make TypeScript shout at you.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#notmodified304-helper
  */
 export declare const notModified304: (response: ServerResponse | NextContextLike) => {
     readonly props: any;

package/esm/next/http.js

@@ -9,7 +9,7 @@ export * from '../http.js';
  * Use this method inside a `getServerSideProps` method (or API route)
  * to return an error page with proper HTTP status code and all the shit.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#showerrorpage-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#showerrorpage-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const showErrorPage = (response, error, ttl = '2s') => {
@@ -34,7 +34,7 @@ const showErrorPage = (response, error, ttl = '2s') => {
  * cases when `getServerSideProps` returns an `__error` prop with `statusCode`
  * and optional friendly `message`.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#makeerrorizeapphoc
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const makeErrorizeAppHOC = (ErrorPage) => {
@@ -64,7 +64,7 @@ export const makeErrorizeAppHOC = (ErrorPage) => {
  * to return an `HTTP_304_NotModified` response with an empty props object,
  * in a way that doesn't make TypeScript shout at you.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#notmodified304-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const notModified304 = (response) => {

package/esm/react-router/Wait.d.ts

@@ -31,7 +31,7 @@ export type WaitProps<T> = WaitPropsBase<T> & WaitFallbacks;
  * custom properties for `meanwhile` and `error` fallbacks, and/or other
  * behaviors.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#type-waitcomponent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#type-waitcomponent
  */
 export type WaitComponent<CustomProps extends Record<string, unknown> = Record<never, never>> = (<T>(props: WaitPropsBase<T> & CustomProps) => ReactElement) & {
     displayName?: string;
@@ -43,7 +43,7 @@ export type WaitComponent<CustomProps extends Record<string, unknown> = Record<n
  * If the awaited promise (`props.for`) resolves to an object with a truthy
  * `$error` property, the `$error` will be thrown.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#wait-component
  */
 export declare const Wait: WaitComponent<WaitFallbacks>;
 export {};

package/esm/react-router/Wait.js

@@ -7,7 +7,7 @@ import { Await } from 'react-router';
  * If the awaited promise (`props.for`) resolves to an object with a truthy
  * `$error` property, the `$error` will be thrown.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#wait-component
  */
 export const Wait = (props) => (React.createElement(Suspense, { fallback: props.meanwhile || 'Loading...' },
     React.createElement(Await, { resolve: props.for, errorElement: props.error || 'An error occurred.' }, (value) => {

package/esm/react-router/http.d.ts

@@ -2,6 +2,6 @@
  * Detects if the request is a client fetch, or an initial/full-page load.
  * Useful for deciding whether to defer data fetching or not.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#isclientfetch
  */
 export declare const isClientFetch: (request: Request) => boolean;

package/esm/react-router/http.js

@@ -2,7 +2,7 @@
  * Detects if the request is a client fetch, or an initial/full-page load.
  * Useful for deciding whether to defer data fetching or not.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#isclientfetch
  */
 /*#__NO_SIDE_EFFECTS__*/
 export const isClientFetch = (request) => 

package/esm/vanillaExtract.d.ts

@@ -2,14 +2,14 @@ import { GlobalStyleRule } from '@vanilla-extract/css';
 /**
  * Adds free-form CSS as a globalStyle
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaglobal
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaglobal
  */
 export declare const vanillaGlobal: (css: string) => void;
 /**
  * Spreads the return value into a style object, to inject free-form CSS
  * properties (or nested blocks)
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaprops
  */
 export declare const vanillaProps: (css: string) => GlobalStyleRule;
 type ClassNameCallback = (
@@ -27,7 +27,7 @@ classNameSelector: string) => string;
  *
  * To opt out of the `&&` replacement, use the callback function signature.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaclass
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaclass
  */
 export declare function vanillaClass(css: string | ClassNameCallback): string;
 export declare function vanillaClass(debugId: string, css: string | ClassNameCallback): string;
@@ -35,7 +35,7 @@ export declare function vanillaClass(debugId: string, css: string | ClassNameCal
  * Returns an object with privately scoped CSS variables props.
  * Pass them around and use them in your CSS.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillacvars
  */
 export declare const vanillaVars: <T extends string>(...varNames: Array<T>) => Record<`var${Capitalize<T>}`, string> & {
     /** Allows initializing all or some of the variables in CSS, without offending VSCode's CSS syntax parser too much. */

package/esm/vanillaExtract.js

@@ -3,7 +3,7 @@ import { globalStyle, style } from '@vanilla-extract/css';
 /**
  * Adds free-form CSS as a globalStyle
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaglobal
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaglobal
  */
 export const vanillaGlobal = (css) => globalStyle('x', { x: `} ${css} x{x:` });
 // ---------------------------------------------------------------------------
@@ -11,7 +11,7 @@ export const vanillaGlobal = (css) => globalStyle('x', { x: `} ${css} x{x:` });
  * Spreads the return value into a style object, to inject free-form CSS
  * properties (or nested blocks)
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaprops
  */
 export const vanillaProps = (css) => ({ x: `; ${css}` });
 export function vanillaClass(cssOrDebugId, css) {
@@ -31,7 +31,7 @@ export function vanillaClass(cssOrDebugId, css) {
  * Returns an object with privately scoped CSS variables props.
  * Pass them around and use them in your CSS.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillacvars
  */
 export const vanillaVars = (...varNames) => {
     const id = vanillaClass(``);

package/hooks.d.ts

@@ -6,7 +6,7 @@
  * **NOTE:** The supplied callback does not need to be memoized. The debouncer
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usedebounced
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usedebounced
  */
 export declare const useDebounced: <A extends Array<unknown>>(
 /** The function to debounce */
@@ -23,7 +23,7 @@ immediate?: boolean) => ((...args: A) => void) & {
  * **NOTE:** The supplied callback does not need to be memoized. The throttler
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usethrottled
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usethrottled
  */
 export declare const useThrottled: <A extends Array<unknown>>(
 /** The function to throttle */

package/hooks.js

@@ -11,7 +11,7 @@ const async_js_1 = require("./async.js");
  * **NOTE:** The supplied callback does not need to be memoized. The debouncer
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usedebounced
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usedebounced
  */
 const useDebounced = (
 /** The function to debounce */
@@ -33,7 +33,7 @@ exports.useDebounced = useDebounced;
  * **NOTE:** The supplied callback does not need to be memoized. The throttler
  * will always invoke the last supplied version.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usethrottled
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#usethrottled
  */
 const useThrottled = (
 /** The function to throttle */

package/http.d.ts

@@ -154,21 +154,21 @@ type TTLObj = {
 /**
  * Configures quick TTL-related settings for a HTTP request object
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-ttlconfig
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-ttlconfig
  */
 export type TTLConfig = TTL | TTLKeywords | TTLObj;
 /**
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#toms-duration-helper
  */
 export declare const toMs: (ttl: TTL) => number;
 /**
  * Converts a `TTL` (max-age) value into seconds. Returns `0` for bad and/or
  * negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#tosec-ttl-helper
  */
 export declare const toSec: (ttl: TTL) => number;
 type ServerResponseStub = Pick<ServerResponse, 'setHeader' | 'getHeader' | 'removeHeader'> & {
@@ -181,7 +181,7 @@ type ResponseStub = {
  * Use this function to quickly set the `Cache-Control` header with a `max-age=`
  * on a HTTP response
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrol-helper
  */
 export declare const cacheControl: (response: ServerResponseStub | ResponseStub | Map<string, string> | {
     res: ServerResponseStub | ResponseStub;
@@ -191,7 +191,7 @@ export declare const cacheControl: (response: ServerResponseStub | ResponseStub
  * situations requiring a `HeadersInit` compatible object.
  *
  * Accepts the same arguments as `cacheControl()`.
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrolheaders-helper
  */
 export declare const cacheControlHeaders: (ttlCfg: TTLConfig, eTag?: string | number) => Record<string, string>;
 export {};

package/http.js

@@ -140,7 +140,7 @@ const unitToMilliseconds = {
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#toms-duration-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const toMs = (ttl) => {
@@ -159,7 +159,7 @@ exports.toMs = toMs;
  * Converts a `TTL` (max-age) value into seconds. Returns `0` for bad and/or
  * negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#tosec-ttl-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const toSec = (ttl) => {
@@ -213,7 +213,7 @@ const setCC = (response, cc) => {
  * Use this function to quickly set the `Cache-Control` header with a `max-age=`
  * on a HTTP response
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrol-helper
  */
 /*#__NO_SIDE_EFFECTS__*/ // eslint-disable-next-line complexity
 const cacheControl = (response, ttlCfg, eTag) => {
@@ -257,7 +257,7 @@ exports.cacheControl = cacheControl;
  * situations requiring a `HeadersInit` compatible object.
  *
  * Accepts the same arguments as `cacheControl()`.
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#cachecontrolheaders-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const cacheControlHeaders = (ttlCfg, eTag) => {

package/next/http.d.ts

@@ -25,7 +25,7 @@ export type InferErrorPageProps<SEP extends ShowErrorPageFn<any>> = Cleanup<Retu
  * cases when `getServerSideProps` returns an `__error` prop with `statusCode`
  * and optional friendly `message`.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#makeerrorizeapphoc
  */
 export declare const makeErrorizeAppHOC: <EP extends Partial<ErrorProps>>(ErrorPage: FunctionComponent<EP>) => {
     <P extends {
@@ -47,7 +47,7 @@ export declare const makeErrorizeAppHOC: <EP extends Partial<ErrorProps>>(ErrorP
  * to return an `HTTP_304_NotModified` response with an empty props object,
  * in a way that doesn't make TypeScript shout at you.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#notmodified304-helper
  */
 export declare const notModified304: (response: ServerResponse | NextContextLike) => {
     readonly props: any;

package/next/http.js

@@ -29,7 +29,7 @@ __exportStar(require("../http.js"), exports);
  * Use this method inside a `getServerSideProps` method (or API route)
  * to return an error page with proper HTTP status code and all the shit.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#showerrorpage-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#showerrorpage-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const showErrorPage = (response, error, ttl = '2s') => {
@@ -54,7 +54,7 @@ const showErrorPage = (response, error, ttl = '2s') => {
  * cases when `getServerSideProps` returns an `__error` prop with `statusCode`
  * and optional friendly `message`.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#makeerrorizeapphoc
  */
 /*#__NO_SIDE_EFFECTS__*/
 const makeErrorizeAppHOC = (ErrorPage) => {
@@ -85,7 +85,7 @@ exports.makeErrorizeAppHOC = makeErrorizeAppHOC;
  * to return an `HTTP_304_NotModified` response with an empty props object,
  * in a way that doesn't make TypeScript shout at you.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-nextjs.md#notmodified304-helper
  */
 /*#__NO_SIDE_EFFECTS__*/
 const notModified304 = (response) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Misc. JS/TS helpers used by Reykjavík City's web dev teams.",
 	"main": "index.js",
 	"repository": "ssh://git@github.com:reykjavikcity/webtools.git",

package/react-router/Wait.d.ts

@@ -31,7 +31,7 @@ export type WaitProps<T> = WaitPropsBase<T> & WaitFallbacks;
  * custom properties for `meanwhile` and `error` fallbacks, and/or other
  * behaviors.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#type-waitcomponent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#type-waitcomponent
  */
 export type WaitComponent<CustomProps extends Record<string, unknown> = Record<never, never>> = (<T>(props: WaitPropsBase<T> & CustomProps) => ReactElement) & {
     displayName?: string;
@@ -43,7 +43,7 @@ export type WaitComponent<CustomProps extends Record<string, unknown> = Record<n
  * If the awaited promise (`props.for`) resolves to an object with a truthy
  * `$error` property, the `$error` will be thrown.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#wait-component
  */
 export declare const Wait: WaitComponent<WaitFallbacks>;
 export {};

package/react-router/Wait.js

@@ -43,7 +43,7 @@ const react_router_1 = require("react-router");
  * If the awaited promise (`props.for`) resolves to an object with a truthy
  * `$error` property, the `$error` will be thrown.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#wait-component
  */
 const Wait = (props) => (react_1.default.createElement(react_1.Suspense, { fallback: props.meanwhile || 'Loading...' },
     react_1.default.createElement(react_router_1.Await, { resolve: props.for, errorElement: props.error || 'An error occurred.' }, (value) => {

package/react-router/http.d.ts

@@ -2,6 +2,6 @@
  * Detects if the request is a client fetch, or an initial/full-page load.
  * Useful for deciding whether to defer data fetching or not.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#isclientfetch
  */
 export declare const isClientFetch: (request: Request) => boolean;

package/react-router/http.js

@@ -5,7 +5,7 @@ exports.isClientFetch = void 0;
  * Detects if the request is a client fetch, or an initial/full-page load.
  * Useful for deciding whether to defer data fetching or not.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README-rr.md#isclientfetch
  */
 /*#__NO_SIDE_EFFECTS__*/
 const isClientFetch = (request) => 

package/vanillaExtract.d.ts

@@ -2,14 +2,14 @@ import { GlobalStyleRule } from '@vanilla-extract/css';
 /**
  * Adds free-form CSS as a globalStyle
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaglobal
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaglobal
  */
 export declare const vanillaGlobal: (css: string) => void;
 /**
  * Spreads the return value into a style object, to inject free-form CSS
  * properties (or nested blocks)
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaprops
  */
 export declare const vanillaProps: (css: string) => GlobalStyleRule;
 type ClassNameCallback = (
@@ -27,7 +27,7 @@ classNameSelector: string) => string;
  *
  * To opt out of the `&&` replacement, use the callback function signature.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaclass
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaclass
  */
 export declare function vanillaClass(css: string | ClassNameCallback): string;
 export declare function vanillaClass(debugId: string, css: string | ClassNameCallback): string;
@@ -35,7 +35,7 @@ export declare function vanillaClass(debugId: string, css: string | ClassNameCal
  * Returns an object with privately scoped CSS variables props.
  * Pass them around and use them in your CSS.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillacvars
  */
 export declare const vanillaVars: <T extends string>(...varNames: Array<T>) => Record<`var${Capitalize<T>}`, string> & {
     /** Allows initializing all or some of the variables in CSS, without offending VSCode's CSS syntax parser too much. */

package/vanillaExtract.js

@@ -7,7 +7,7 @@ const css_1 = require("@vanilla-extract/css");
 /**
  * Adds free-form CSS as a globalStyle
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaglobal
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaglobal
  */
 const vanillaGlobal = (css) => (0, css_1.globalStyle)('x', { x: `} ${css} x{x:` });
 exports.vanillaGlobal = vanillaGlobal;
@@ -16,7 +16,7 @@ exports.vanillaGlobal = vanillaGlobal;
  * Spreads the return value into a style object, to inject free-form CSS
  * properties (or nested blocks)
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillaprops
  */
 const vanillaProps = (css) => ({ x: `; ${css}` });
 exports.vanillaProps = vanillaProps;
@@ -37,7 +37,7 @@ function vanillaClass(cssOrDebugId, css) {
  * Returns an object with privately scoped CSS variables props.
  * Pass them around and use them in your CSS.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillacvars
  */
 const vanillaVars = (...varNames) => {
     const id = vanillaClass(``);