@reykjavik/webtools 0.1.11 → 0.1.13

package/esm/next/SiteImprove.d.ts

@@ -1,101 +1,11 @@
 import React from 'react';
-import { EitherObj } from '@reykjavik/hanna-utils';
-declare global {
-    interface Window {
-        _sz?: Array<SiteImproveEvent> & {
-            /**
-             * Set if posting a tracking event is attempted before SiteImprove has
-             * been initialized, and the window._sz array had to be initialized
-             * just-in-time.
-             */
-            _jit_defined_?: true;
-            core?: {
-                data: Array<SiteImproveEvent>;
-            };
-        };
-    }
-}
-type SiteImproveEvent = SiteImprovePageView | SiteImproveRequest | SiteImproveCustomEvent;
-type SiteImprovePageView = [
-    type: 'trackdynamic',
-    data: {
-        /** New page URL */
-        url: string;
-        /** The previous (referer) URL */
-        ref?: string;
-        /** New page title */
-        title?: string;
-    }
-];
-type SiteImproveRequest = [
-    type: 'request',
-    data: {
-        /** Outbound URL */
-        ourl: string;
-        /** The current page URL */
-        ref: string;
-        autoonclick?: 1;
-    }
-];
-type SiteImproveCustomEvent = [
-    type: 'event',
-    category: string,
-    action: string,
-    label?: string
-];
-/**
- * A small helper for tracking custom UI events and reporting them to SiteImrove.
- *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1##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/tree/v0.1##pingsiteimproveoutbound-helper
- */
-export declare const pingSiteImproveOutbound: (ourl: string) => void;
-export type SiteImproveProps = EitherObj<{
-    /**
-     * Your SiteImprove account ID.
-     *
-     * It's a random-looking numerical string, and it can usually be
-     * extracted from the script embed URL like this:
-     * `"https://siteimproveanalytics.com/js/siteanalyze_[ACCOUNT_ID].js"`
-     */
-    accountId: string;
-}, {
-    /**
-     * The full SiteImprove analytics script URL.
-     *
-     * Something like `"https://siteimproveanalytics.com/js/siteanalyze_[ACCOUNT_ID].js"`
-     */
-    scriptUrl: string;
-}> & {
-    /**
-     * Manual GDPR 'analytics' consent flag.
-     *
-     * A value of `false` prevents the analytics script being loaded.
-     *
-     * A value of `true` still defers to the 'analytics' consent state provided
-     * by the `CookieHubProvider` component (if present).
-     */
-    hasConstented?: boolean;
-    /**
-     * Custom callback for when the SiteImprove script has loaded.
-     */
-    onLoad?: (e: unknown) => void;
-    /**
-     * Error callback for if the SiteImprove script fails to load.
-     */
-    onError?: (e: unknown) => void;
-};
+import { SiteImproveProps } from './SiteImprove.privates.js';
+export type { SiteImproveProps } from './SiteImprove.privates.js';
+export { pingSiteImprove, pingSiteImproveOutbound } from './SiteImprove.privates.js';
 /**
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across Next.js routes.
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1##siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#siteimprove-component
  */
 export declare const SiteImprove: (props: SiteImproveProps) => React.JSX.Element | null;
-export {};

package/esm/next/SiteImprove.js

@@ -2,56 +2,13 @@ import React, { useEffect } from 'react';
 import { Router } from 'next/router.js';
 import NextScript from 'next/script.js';
 import { useCookieHubConsent } from '../CookieHubConsent.js';
+import { logOutboundLinks, makeScriptUrl, trackDynamicPageView, } from './SiteImprove.privates.js';
 // Fixes an issue with `next/script`'s types and mixture of default and named exports.
 // This workaround doesn't seem to be necessary in Next.js 13.5 (pages router), but
 // is definitely needed for the webpack bundler used by Next.js 11. (v12 is untested.)
 const Script = ('__esModule' in NextScript && 'default' in NextScript
     ? NextScript.default
     : NextScript);
-// END: Mock typing of SiteImprove's event tracking API
-// --------------------------------------------------------------------------
-//
-// ---------------------------------------------------------------------------
-const _emitEvent = typeof window === 'undefined'
-    ? () => undefined
-    : (event) => {
-        let _sz = window._sz;
-        if (!_sz) {
-            _sz = window._sz = [];
-            _sz._jit_defined_ = true;
-        }
-        _sz.push(event);
-        if (process.env.NODE_ENV === 'development') {
-            console.info('SiteImprove:', event);
-        }
-    };
-// ---------------------------------------------------------------------------
-/**
- * A small helper for tracking custom UI events and reporting them to SiteImrove.
- *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1##pingsiteimprove-helper
- */
-export const pingSiteImprove = (category, action, label) => {
-    if (process.env.NODE_ENV === 'development' &&
-        (!window._sz || window._sz._jit_defined_)) {
-        console.warn('`pingSiteImprove` was called before SiteImprove script was loaded.');
-    }
-    _emitEvent(['event', 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/tree/v0.1##pingsiteimproveoutbound-helper
- */
-export const pingSiteImproveOutbound = (ourl) => {
-    if (process.env.NODE_ENV === 'development' &&
-        (!window._sz || window._sz._jit_defined_)) {
-        console.warn('`pingSiteImproveOutbound` was called before SiteImprove script was loaded.');
-    }
-    _emitEvent(['request', { ourl, ref: document.location.href }]);
-};
 // ---------------------------------------------------------------------------
 /*
   SiteImprove's "trackdynamic" (page view) event requires both the new URL
@@ -64,59 +21,23 @@ export const pingSiteImproveOutbound = (ourl) => {
   and it is thus safe to simply store the old URL in a local variable.
   This may look dodgy, but should prove reasonably safe in practice.
 */
-let refUrl = '';
+let _refUrl = '';
 const captureRefUrl = () => {
-    refUrl = document.location.pathname + document.location.search;
+    _refUrl = document.location.pathname + document.location.search;
 };
-const sendRoutingEvent = (url) => _emitEvent([
-    'trackdynamic',
-    {
-        url,
-        // On `history.back()`/`history.forward()` the URL change happens before
-        // `routeChangeStart`, so `refUrl` and `url` become the same.
-        // in that case we suppress the `ref`
-        ref: refUrl !== url ? refUrl : undefined,
-        title: document.title,
-    },
-]);
-// ---------------------------------------------------------------------------
-const logOutboundLinks = () => {
-    const captureLinkClicks = (e) => {
-        const link = e.target.closest('a[href]');
-        if (!link || link.$$bound) {
-            return;
-        }
-        link.$$bound = true;
-        // Waiting for the bubble phase allows other click handlers to preventDefault()
-        link.addEventListener('click', (e) => {
-            var _a, _b;
-            if (e.defaultPrevented) {
-                return;
-            }
-            // Skip logging outbound request if SiteImprove has already done so.
-            // BTW, SiteImprove binds its autoonclick handlers on "mousedown"
-            // so they're guaranteed to have run before our "click" listener.
-            const events = (_b = (_a = window._sz) === null || _a === void 0 ? void 0 : _a.core) === null || _b === void 0 ? void 0 : _b.data;
-            const [type, data] = (events && events[events.length - 1]) || [];
-            if (type === 'request' && data.autoonclick && data.ourl === link.href) {
-                return;
-            }
-            pingSiteImproveOutbound(link.href);
-        });
-    };
-    const { body } = document;
-    // bind 'click' listener to the capture phase
-    body.addEventListener('click', captureLinkClicks, true);
-    return () => body.removeEventListener('click', captureLinkClicks, true);
+const sendRoutingEvent = (url) => {
+    // On `history.back()`/`history.forward()` the URL change happens before
+    // `routeChangeStart`, so `refUrl` and `url` become the same.
+    // in that case we suppress the `ref`
+    const refUrl = _refUrl !== url ? _refUrl : undefined;
+    trackDynamicPageView(url, refUrl, document.title);
 };
-// ---------------------------------------------------------------------------
-const idToken = '[ACCOUNT_ID]';
-const scriptUrlTemplate = `https://siteimproveanalytics.com/js/siteanalyze_${idToken}.js`;
+export { pingSiteImprove, pingSiteImproveOutbound } from './SiteImprove.privates.js';
 /**
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across Next.js routes.
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1##siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#siteimprove-component
  */
 export const SiteImprove = (props) => {
     const { analytics } = useCookieHubConsent();
@@ -149,8 +70,6 @@ export const SiteImprove = (props) => {
     if (!consented || process.env.NODE_ENV !== 'production') {
         return null;
     }
-    const scriptUrl = props.scriptUrl != null
-        ? props.scriptUrl
-        : scriptUrlTemplate.replace(idToken, props.accountId);
+    const scriptUrl = props.scriptUrl != null ? props.scriptUrl : makeScriptUrl(props.accountId);
     return (React.createElement(Script, { type: "text/javascript", strategy: "afterInteractive", src: scriptUrl, onLoad: props.onLoad, onError: props.onError }));
 };

package/esm/next/SiteImprove.privates.d.ts

@@ -0,0 +1,100 @@
+import { EitherObj } from '@reykjavik/hanna-utils';
+declare global {
+    interface Window {
+        _sz?: Array<SiteImproveEvent> & {
+            /**
+             * Set if posting a tracking event is attempted before SiteImprove has
+             * been initialized, and the window._sz array had to be initialized
+             * just-in-time.
+             */
+            _jit_defined_?: true;
+            core?: {
+                data: Array<SiteImproveEvent>;
+            };
+        };
+    }
+}
+export type SiteImproveEvent = SiteImprovePageView | SiteImproveRequest | SiteImproveCustomEvent;
+export type SiteImprovePageView = [
+    type: 'trackdynamic',
+    data: {
+        /** New page URL */
+        url: string;
+        /** The previous (referer) URL */
+        ref?: string;
+        /** New page title */
+        title?: string;
+    }
+];
+export type SiteImproveRequest = [
+    type: 'request',
+    data: {
+        /** Outbound URL */
+        ourl: string;
+        /** The current page URL */
+        ref: string;
+        autoonclick?: 1;
+    }
+];
+export type SiteImproveCustomEvent = [
+    type: 'event',
+    category: string,
+    action: string,
+    label?: string
+];
+/**
+ * A small helper to send "trackdynamic" page view/load events to SiteImrove.
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#pingsiteimprove-helper
+ */
+export declare const trackDynamicPageView: (url: string, refUrl?: string, title?: string) => void;
+/**
+ * A small helper for tracking custom UI events and reporting them to SiteImrove.
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.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.1/README-nextjs.md#pingsiteimproveoutbound-helper
+ */
+export declare const pingSiteImproveOutbound: (ourl: string) => void;
+export declare const logOutboundLinks: () => () => void;
+export declare const makeScriptUrl: (accountId: string) => string;
+export type SiteImproveProps = EitherObj<{
+    /**
+     * Your SiteImprove account ID.
+     *
+     * It's a random-looking numerical string, and it can usually be
+     * extracted from the script embed URL like this:
+     * `"https://siteimproveanalytics.com/js/siteanalyze_[ACCOUNT_ID].js"`
+     */
+    accountId: string;
+}, {
+    /**
+     * The full SiteImprove analytics script URL.
+     *
+     * Something like `"https://siteimproveanalytics.com/js/siteanalyze_[ACCOUNT_ID].js"`
+     */
+    scriptUrl: string;
+}> & {
+    /**
+     * Manual GDPR 'analytics' consent flag.
+     *
+     * A value of `false` prevents the analytics script being loaded.
+     *
+     * A value of `true` still defers to the 'analytics' consent state provided
+     * by the `CookieHubProvider` component (if present).
+     */
+    hasConstented?: boolean;
+    /**
+     * Custom callback for when the SiteImprove script has loaded.
+     */
+    onLoad?: (e: unknown) => void;
+    /**
+     * Error callback for if the SiteImprove script fails to load.
+     */
+    onError?: (e: unknown) => void;
+};

package/esm/next/SiteImprove.privates.js

@@ -0,0 +1,83 @@
+// END: Mock typing of SiteImprove's event tracking API
+// --------------------------------------------------------------------------
+//
+// ---------------------------------------------------------------------------
+const _emitEvent = typeof window === 'undefined'
+    ? () => undefined
+    : (event) => {
+        let _sz = window._sz;
+        if (!_sz) {
+            _sz = window._sz = [];
+            _sz._jit_defined_ = true;
+        }
+        _sz.push(event);
+        if (process.env.NODE_ENV === 'development') {
+            console.info('SiteImprove:', event);
+        }
+    };
+// ---------------------------------------------------------------------------
+/**
+ * A small helper to send "trackdynamic" page view/load events to SiteImrove.
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#pingsiteimprove-helper
+ */
+export const trackDynamicPageView = (url, refUrl, title) => _emitEvent(['trackdynamic', { url, ref: refUrl, title }]);
+// ---------------------------------------------------------------------------
+/**
+ * A small helper for tracking custom UI events and reporting them to SiteImrove.
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#pingsiteimprove-helper
+ */
+export const pingSiteImprove = (category, action, label) => {
+    if (process.env.NODE_ENV === 'development' &&
+        (!window._sz || window._sz._jit_defined_)) {
+        console.warn('`pingSiteImprove` was called before SiteImprove script was loaded.');
+    }
+    _emitEvent(['event', 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.1/README-nextjs.md#pingsiteimproveoutbound-helper
+ */
+export const pingSiteImproveOutbound = (ourl) => {
+    if (process.env.NODE_ENV === 'development' &&
+        (!window._sz || window._sz._jit_defined_)) {
+        console.warn('`pingSiteImproveOutbound` was called before SiteImprove script was loaded.');
+    }
+    _emitEvent(['request', { ourl, ref: document.location.href }]);
+};
+// ---------------------------------------------------------------------------
+export const logOutboundLinks = () => {
+    const captureLinkClicks = (e) => {
+        const link = e.target.closest('a[href]');
+        if (!link || link.$$bound) {
+            return;
+        }
+        link.$$bound = true;
+        // Waiting for the bubble phase allows other click handlers to preventDefault()
+        link.addEventListener('click', (e) => {
+            var _a, _b;
+            if (e.defaultPrevented) {
+                return;
+            }
+            // Skip logging outbound request if SiteImprove has already done so.
+            // BTW, SiteImprove binds its autoonclick handlers on "mousedown"
+            // so they're guaranteed to have run before our "click" listener.
+            const events = (_b = (_a = window._sz) === null || _a === void 0 ? void 0 : _a.core) === null || _b === void 0 ? void 0 : _b.data;
+            const [type, data] = (events && events[events.length - 1]) || [];
+            if (type === 'request' && data.autoonclick && data.ourl === link.href) {
+                return;
+            }
+            pingSiteImproveOutbound(link.href);
+        });
+    };
+    const { body } = document;
+    // bind 'click' listener to the capture phase
+    body.addEventListener('click', captureLinkClicks, true);
+    return () => body.removeEventListener('click', captureLinkClicks, true);
+};
+// ---------------------------------------------------------------------------
+export const makeScriptUrl = (accountId) => `https://siteimproveanalytics.com/js/siteanalyze_${accountId}.js`;

package/esm/next/http.d.ts

@@ -26,7 +26,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/tree/v0.1#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#makeerrorizeapphoc
  */
 export declare const makeErrorizeAppHOC: <EP extends Partial<ErrorProps>>(ErrorPage: React.FunctionComponent<EP>) => {
     <P extends {
@@ -48,7 +48,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/tree/v0.1#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/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/tree/v0.1#showerrorpage-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#showerrorpage-helper
  */
 const showErrorPage = (response, error, ttl = '2s') => {
     error =
@@ -33,7 +33,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/tree/v0.1#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#makeerrorizeapphoc
  */
 export const makeErrorizeAppHOC = (ErrorPage) => {
     // the HOC
@@ -62,7 +62,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/tree/v0.1#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README-nextjs.md#notmodified304-helper
  */
 export const notModified304 = (response) => {
     response = 'res' in response ? response.res : response;

package/esm/vanillaExtract.d.ts

@@ -0,0 +1,46 @@
+import { GlobalStyleRule } from '@vanilla-extract/css';
+/**
+ * Adds free-form CSS as a globalStyle
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/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.1/README.md#vanillaprops
+ */
+export declare const vanillaProps: (css: string) => GlobalStyleRule;
+/**
+ * Returns a scoped cssClassName styled with free-form CSS
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillaclass
+ */
+export declare function vanillaClass(css: string): string;
+export declare function vanillaClass(debugId: string, css: string): string;
+/**
+ * Replaces all `&` tokens with the given selector string, in a direct
+ * (read. "dumb") way. It's mainly useful when used with style-mixins, etc.
+ *
+ * NOTE: It does NOT support deeply nested blocks, or anything so fancy.
+ * It will also replace "&" characters inside values, comments, etc.
+ * If you need something more sophisticated, use a custom `postcss` config.
+ *
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillanest
+ */
+export declare const vanillaNest: (ampSelector: string, css: string) => string;
+/**
+ * Returns a scoped cssClassName styled with free-form CSS.
+ *
+ * It also automatically replaces all `&`-tokens with
+ * the selector for the auto-generated class-name.
+ *
+ * NOTE: All "bare" (un-nested) style properties must come first,
+ * before any nested blocks.
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillaclassnested
+ */
+export declare function vanillaClassNested(css: string): string;
+export declare function vanillaClassNested(debugId: string, css: string): string;

package/esm/vanillaExtract.js

@@ -0,0 +1,45 @@
+import { globalStyle, style } from '@vanilla-extract/css';
+/**
+ * Adds free-form CSS as a globalStyle
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillaglobal
+ */
+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.1/README.md#vanillaprops
+ */
+export const vanillaProps = (css) => ({ x: `; ${css}` });
+export function vanillaClass(cssOrDebugId, css) {
+    const debugId = css != null ? cssOrDebugId : undefined;
+    css = css != null ? css : cssOrDebugId;
+    return style(vanillaProps(css), debugId);
+}
+// ---------------------------------------------------------------------------
+/**
+ * Replaces all `&` tokens with the given selector string, in a direct
+ * (read. "dumb") way. It's mainly useful when used with style-mixins, etc.
+ *
+ * NOTE: It does NOT support deeply nested blocks, or anything so fancy.
+ * It will also replace "&" characters inside values, comments, etc.
+ * If you need something more sophisticated, use a custom `postcss` config.
+ *
+ *
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillanest
+ */
+export const vanillaNest = (ampSelector, css) => css.replace(/&/g, ampSelector);
+export function vanillaClassNested(cssOrDebugId, css) {
+    const debugId = css != null ? cssOrDebugId : undefined;
+    css = css != null ? css : cssOrDebugId;
+    const nestPoint = css.indexOf('&');
+    const bareStyles = nestPoint > -1 ? css.slice(0, nestPoint) : css;
+    const nestedStyles = nestPoint > -1 ? css.slice(nestPoint) : undefined;
+    const className = style(vanillaProps(bareStyles), debugId);
+    if (nestedStyles) {
+        vanillaGlobal(vanillaNest(`.${className}`, nestedStyles));
+    }
+    return className;
+}

package/fixIcelandicLocale.d.ts

@@ -0,0 +1,2 @@
+declare const locAliases: Record<string, string>;
+declare const mapLocales: (locales: string | Array<string> | undefined) => string[];

package/fixIcelandicLocale.js

@@ -0,0 +1,21 @@
+"use strict";
+const locAliases = {
+    // Danish is good enough substitution for Icelandic
+    is: 'da',
+    'is-is': 'da',
+};
+const mapLocales = (locales) => {
+    locales = typeof locales === 'string' ? [locales] : locales || [];
+    return locales.map((loc) => locAliases[loc.toLowerCase()] || loc);
+};
+// ---------------------------------------------------------------------------
+if ( /*#__PURE__*/'ö'.localeCompare('p', 'is') < 0) {
+    const _localeCompare = String.prototype.localeCompare;
+    /**
+     * Polyfill for String.prototype.localeCompare for the 'is' locale
+     * in browsers that don't support it (\*cough* Chrome \*cough*).
+     */
+    String.prototype.localeCompare = function (that, locales, options) {
+        return _localeCompare.call(this, that, mapLocales(locales), options);
+    };
+}

package/http.d.ts

@@ -153,21 +153,21 @@ type TTLObj = {
 /**
  * Configures quick TTL-related settings for a HTTP request object
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1#type-ttlconfig
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-ttlconfig
  */
 export type TTLConfig = TTL | TTLKeywords | TTLObj;
 /**
  * Converts a `TTL` (max-age) value into seconds, and returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#tosec-ttl-helper
  */
 export declare const toSec: (ttl: TTL) => number;
 /**
  * Use this function to quickly set the `Cache-Control` header with a `max-age=`
  * on a HTTP response
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1#getcssbundleurl
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#getcssbundleurl
  */
 export declare const cacheControl: (response: ServerResponse | {
     res: ServerResponse;

package/http.js

@@ -140,7 +140,7 @@ const unitToSeconds = {
  * Converts a `TTL` (max-age) value into seconds, and returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/tree/v0.1#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#tosec-ttl-helper
  */
 const toSec = (ttl) => {
     if (typeof ttl === 'string') {
@@ -173,7 +173,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/tree/v0.1#getcssbundleurl
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#getcssbundleurl
  */
 // eslint-disable-next-line complexity
 const cacheControl = (response, ttlCfg, eTag) => {

package/index.d.ts

@@ -1,4 +1,6 @@
+/// <reference path="./vanillaExtract.d.ts" />
 /// <reference path="./http.d.ts" />
+/// <reference path="./fixIcelandicLocale.d.ts" />
 /// <reference path="./CookieHubConsent.d.tsx" />
 /// <reference path="./next/SiteImprove.d.tsx" />
 /// <reference path="./next/http.d.tsx" />