@reykjavik/webtools 0.1.36 → 0.2.0

package/esm/errorhandling.d.ts

@@ -2,7 +2,7 @@
  * Error subclass for thrown values that got cought and turned into an actual
  * Error, with the thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
     payload?: unknown;
@@ -17,7 +17,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.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare const asError: (maybeError: unknown) => ErrorFromPayload;
 type SuccessResult<T> = [error: undefined, result: T] & {
@@ -31,14 +31,14 @@ type FailResult<E extends Error> = [error: E] & {
 /**
  * Simple bare-bones discriminated tuple type for a [error, result] pair.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-resulttuple
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttuple
  */
 export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E];
 /**
  * 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.1/README.md#type-resulttupleobj
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttupleobj
  */
 export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | FailResult<E>;
 /**
@@ -50,7 +50,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  *
  * Works on both promises and sync callback functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultcatch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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>;
@@ -58,19 +58,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.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 export declare const Result: {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success: <T>(result: T) => SuccessResult<T>;
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
     catch: typeof catch_;
@@ -79,14 +79,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.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: <T_1, T2, E_1 extends Error>(result: ResultTuple<T_1, E_1>, mapFn: (resultValue: T_1) => T2) => ResultTupleObj<T2, E_1>;
     /**
      * 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.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: <T_2>(result: ResultTuple<T_2, Error>) => T_2;
 };

package/esm/errorhandling.js

@@ -2,7 +2,7 @@
  * Error subclass for thrown values that got cought and turned into an actual
  * Error, with the thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export class ErrorFromPayload extends Error {
     constructor(payload) {
@@ -23,7 +23,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.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export const asError = (maybeError) => {
     if (maybeError instanceof Error) {
@@ -56,19 +56,19 @@ function catch_(something) {
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 export const Result = {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success,
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail,
     // NOTE: The JSDoc must be placed above the `catch_` function above.
@@ -78,7 +78,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.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: (result, mapFn) => {
         const [error, resultValue] = result;
@@ -91,7 +91,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.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: (result) => {
         if (result[0]) {

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.1/README.md#type-ttlconfig
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-ttlconfig
  */
 export type TTLConfig = TTL | TTLKeywords | TTLObj;
 /**
  * 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.1/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
  */
 export declare const toSec: (ttl: TTL) => number;
 /**
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
  */
 export declare const toMs: (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.1/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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.1/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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 unitToSeconds = {
  * 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.1/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
  */
 export const toSec = (ttl) => {
     if (typeof ttl === 'string') {
@@ -150,7 +150,7 @@ export const toSec = (ttl) => {
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
  */
 export const toMs = (ttl) => toSec(ttl) * 1000;
 const toRespnseStubHeaders = (response) => {
@@ -195,7 +195,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.1/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
  */
 // eslint-disable-next-line complexity
 export const cacheControl = (response, ttlCfg, eTag) => {
@@ -238,7 +238,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.1/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
  */
 export const cacheControlHeaders = (ttlCfg, eTag) => {
     const headers = new Map();

package/esm/index.d.ts

@@ -3,11 +3,10 @@
 /// <reference path="./async.d.ts" />
 /// <reference path="./fixIcelandicLocale.d.ts" />
 /// <reference path="./errorhandling.d.ts" />
-/// <reference path="./remix/http.d.ts" />
+/// <reference path="./react-router/http.d.ts" />
 /// <reference path="./SiteImprove.d.tsx" />
 /// <reference path="./CookieHubConsent.d.tsx" />
-/// <reference path="./remix/Wait.d.tsx" />
-/// <reference path="./next/SiteImprove.d.tsx" />
+/// <reference path="./react-router/Wait.d.tsx" />
 /// <reference path="./next/http.d.tsx" />
 
 export {};

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/blob/v0.1/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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/blob/v0.1/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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.1/README-nextjs.md#showerrorpage-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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/blob/v0.1/README-nextjs.md#makeerrorizeapphoc
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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/blob/v0.1/README-nextjs.md#notmodified304-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-nextjs.md#notmodified304-helper
  */
 export const notModified304 = (response) => {
     response = 'res' in response ? response.res : response;

package/{remix → 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.1/README-remix.md#type-waitcomponent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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.1/README-remix.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#wait-component
  */
 export declare const Wait: WaitComponent<WaitFallbacks>;
 export {};

package/esm/{remix → react-router}/Wait.js

@@ -1,5 +1,5 @@
 import React, { Suspense } from 'react';
-import { Await } from '@remix-run/react';
+import { Await } from 'react-router';
 /**
  * A thin wrapper around [Remix's `Await`](https://remix.run/docs/en/2/components/await)
  * component, to provide a more ergonomic API.
@@ -7,7 +7,7 @@ import { Await } from '@remix-run/react';
  * 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.1/README-remix.md#wait-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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/{remix → 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.1/README-remix.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
  */
 export declare const isClientFetch: (request: Request) => boolean;

package/esm/{remix → 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.1/README-remix.md#isclientfetch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README-rr.md#isclientfetch
  */
 export const isClientFetch = (request) => 
 // For info about this detection method:

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.1/README.md#vanillaglobal
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
  */
 export declare const vanillaProps: (css: string) => GlobalStyleRule;
 type ClassNameCallback = (
@@ -27,137 +27,8 @@ classNameSelector: string) => string;
  *
  * To opt out of the `&&` replacement, use the callback function signature.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#vanillaclass
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaclass
  */
 export declare function vanillaClass(css: string | ClassNameCallback): string;
 export declare function vanillaClass(debugId: string, css: string | ClassNameCallback): string;
-/**
- * @deprecated  (Will be removed in v0.2)
- *
- * 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:** `vanillaNest` 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.
- *
- * ```ts
- * // someCssHelper.ts
- * import { vanillaNest } from '@reykjavik/webtools/vanillaExtract';
- *
- * export const hoverGlow = (
- *   ampSelector: string,
- *   glowiness?: 'normal' | 'insane'
- * ) =>
- *   vanillaNest(
- *     ampSelector,
- *     `
- *     &:hover {
- *       box-shadow: 0 0 20px 5px ${
- *         glowiness === 'insane' ? 'hotpink' : 'salmon'
- *       };
- *     }
- *   `
- *   );
- *
- * // ...then, somewhere else in a *.css.ts file:
- *
- * import { hoverGlow } from '~/someCssHelper.js';
- * import { vanillaGlobal } from '@reykjavik/webtools/vanillaExtract';
- *
- * vanillaGlobal(`
- *   .MyComponent {
- *     border: 1px solid #ccc;
- *     padding: 1em;
- *   }
- *   ${hoverGlow('.MyComponent')}
- *
- *   .MyOtherComponent {
- *     border: 1px solid #ccc;
- *     padding: 1em;
- *   }
- *   ${hoverGlow('.MyOtherComponent', 'insane')}
- * `);
- * ```
- *
- * (This low-level utility function is used internally by `vanillaClassNested`.
- */
-export declare const vanillaNest: (ampSelector: string, css: string) => string;
-/**
- * @deprecated  (Will be removed in v0.2)
- *
- * Returns a scoped cssClassName styled with free-form CSS.
- *
- * It also automatically replaces all `&`-tokens with
- * the selector for the auto-generated class-name.
- *
- * ```ts
- * // someFile.css.ts
- * import { vanillaClassNested } from '@reykjavik/webtools/vanillaExtract';
- *
- * export const myClass = vanillaClassNested(`
- *   background-color: #ccc;
- *   padding: .5em 1em;
- *
- *   /* Nested blocks begin: *​​/
- *   &:hover {
- *     background-color: #666;
- *     color: white;
- *   }
- *   & > strong {
- *     color: maroon;
- *   }
- *   html[data-color-theme="unicorn"] & {
- *     background-color: pink;
- *   }
- * `);
- * ```
- *
- * **NOTE:** All "bare" (un-nested) style properties **must come first**,
- * before any nested blocks.
- *
- * **NOTE 2:** `vanillaClassNested` 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.
- */
-export declare function vanillaClassNested(css: string): string;
-/** @deprecated  (Will be removed in v0.2) */
-/**
- * Returns a scoped cssClassName styled with free-form CSS.
- *
- * It also automatically replaces all `&`-tokens with
- * the selector for the auto-generated class-name.
- *
- * ```ts
- * // someFile.css.ts
- * import { vanillaClassNested } from '@reykjavik/webtools/vanillaExtract';
- *
- * export const myClass = vanillaClassNested(`
- *   background-color: #ccc;
- *   padding: .5em 1em;
- *
- *   /* Nested blocks begin: *​​/
- *   &:hover {
- *     background-color: #666;
- *     color: white;
- *   }
- *   & > strong {
- *     color: maroon;
- *   }
- *   html[data-color-theme="unicorn"] & {
- *     background-color: pink;
- *   }
- * `);
- * ```
- *
- * **NOTE:** All "bare" (un-nested) style properties **must come first**,
- * before any nested blocks.
- *
- * **NOTE 2:** `vanillaClassNested` 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.
- */
-export declare function vanillaClassNested(debugId: string, css: string): string;
 export {};

package/esm/vanillaExtract.js

@@ -2,7 +2,7 @@ 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
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaglobal
  */
 export const vanillaGlobal = (css) => globalStyle('x', { x: `} ${css} x{x:` });
 // ---------------------------------------------------------------------------
@@ -10,7 +10,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.1/README.md#vanillaprops
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#vanillaprops
  */
 export const vanillaProps = (css) => ({ x: `; ${css}` });
 export function vanillaClass(cssOrDebugId, css) {
@@ -25,68 +25,3 @@ export function vanillaClass(cssOrDebugId, css) {
         : css.replace(/&&/g, `.${className}`));
     return className;
 }
-// ---------------------------------------------------------------------------
-/**
- * @deprecated  (Will be removed in v0.2)
- *
- * 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:** `vanillaNest` 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.
- *
- * ```ts
- * // someCssHelper.ts
- * import { vanillaNest } from '@reykjavik/webtools/vanillaExtract';
- *
- * export const hoverGlow = (
- *   ampSelector: string,
- *   glowiness?: 'normal' | 'insane'
- * ) =>
- *   vanillaNest(
- *     ampSelector,
- *     `
- *     &:hover {
- *       box-shadow: 0 0 20px 5px ${
- *         glowiness === 'insane' ? 'hotpink' : 'salmon'
- *       };
- *     }
- *   `
- *   );
- *
- * // ...then, somewhere else in a *.css.ts file:
- *
- * import { hoverGlow } from '~/someCssHelper.js';
- * import { vanillaGlobal } from '@reykjavik/webtools/vanillaExtract';
- *
- * vanillaGlobal(`
- *   .MyComponent {
- *     border: 1px solid #ccc;
- *     padding: 1em;
- *   }
- *   ${hoverGlow('.MyComponent')}
- *
- *   .MyOtherComponent {
- *     border: 1px solid #ccc;
- *     padding: 1em;
- *   }
- *   ${hoverGlow('.MyOtherComponent', 'insane')}
- * `);
- * ```
- *
- * (This low-level utility function is used internally by `vanillaClassNested`.
- */
-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/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.1/README.md#type-ttlconfig
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-ttlconfig
  */
 export type TTLConfig = TTL | TTLKeywords | TTLObj;
 /**
  * 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.1/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
  */
 export declare const toSec: (ttl: TTL) => number;
 /**
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
  */
 export declare const toMs: (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.1/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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.1/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/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 unitToSeconds = {
  * 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.1/README.md#tosec-ttl-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#tosec-ttl-helper
  */
 const toSec = (ttl) => {
     if (typeof ttl === 'string') {
@@ -155,7 +155,7 @@ exports.toSec = toSec;
  * Converts a `TTL` (duration) value into milliseconds. Returns `0` for bad
  * and/or negative input values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#toms-duration-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#toms-duration-helper
  */
 const toMs = (ttl) => (0, exports.toSec)(ttl) * 1000;
 exports.toMs = toMs;
@@ -201,7 +201,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.1/README.md#cachecontrol-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrol-helper
  */
 // eslint-disable-next-line complexity
 const cacheControl = (response, ttlCfg, eTag) => {
@@ -245,7 +245,7 @@ exports.cacheControl = cacheControl;
  * situations requiring a `HeadersInit` compatible object.
  *
  * Accepts the same arguments as `cacheControl()`.
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#cachecontrolheaders-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cachecontrolheaders-helper
  */
 const cacheControlHeaders = (ttlCfg, eTag) => {
     const headers = new Map();