@reykjavik/webtools 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -4,13 +4,21 @@
 
 - ... <!-- Add new lines here. -->
 
-## 0.3.1
+## 0.3.3
 
-_2025-11-10_
+_2026-02-13_
+
+- feat: Make `ResultFail` better infer its error type from the argument
+
+## 0.3.2
 
-- docs: Update JSDoc @see links to point to new version branch
+_2025-12-01_
+
+- `@reykjavik/webtools/errorhandling`:
+  - feat: Add type `Result.PayloadOf<T>` to extract the successful payload
+    type from a `ResultTuple<T>` or a `ResultTuple`-returning function
 
-## 0.3.0
+## 0.3.0 – 0.3.1
 
 _2025-11-10_
 
@@ -26,7 +34,7 @@ _2025-09-30_
 
 - `@reykjavik/webtools/next/vanillaExtract`:
   - feat: Make `vanillaVars` return a type-safe `setVars()` helper to avoid
-    offending VSCode's CSS syntax parser too much.
+    offending VSCode's CSS syntax parser too much
 
 ## 0.2.8
 

package/README.md

@@ -46,6 +46,7 @@ bun add @reykjavik/webtools
   - [`Result.Success`](#resultsuccess)
   - [`Result.Fail`](#resultfail)
   - [`Result.throw`](#resultthrow)
+  - [Type `Result.PayloadOf`](#type-resultpayloadof)
 - [`@reykjavik/webtools/SiteImprove`](#reykjavikwebtoolssiteimprove)
   - [`SiteImprove` component](#siteimprove-component)
   - [`pingSiteImprove` helper](#pingsiteimprove-helper)
@@ -838,6 +839,29 @@ try {
 
 This function acts as the inverse of [`Result.catch()`](#resultcatch).
 
+### Type `Result.PayloadOf`
+
+**Syntax:**
+`Result.PayloadOf<T extends | ResultTuple<unknown> | Promise<ResultTuple<unknown>> | ((...args: Array<any>) => ResultTuple<unknown> | Promise<ResultTuple<unknown>>)>`
+
+This utility type extracts the successful payload type `T` from a
+`Result.Tuple<T>`-like type, a `Promise` of such type, or a function returning
+either of those.
+
+```ts
+import { Result } from '@reykjavik/webtools/errorhandling';
+
+type ResTpl = Result.Tuple<string, Error>;
+type ResTplPromise = Promise<Result.Tuple<number, Error>>;
+type ResTplFn = (arg: unknown) => Result.Tuple<boolean, Error>;
+type ResTplPromiseFn = (arg: unknown) => Promise<Result.Tuple<Date, Error>>;
+
+type Payload1 = Result.PayloadOf<ResTpl>; // string
+type Payload2 = Result.PayloadOf<ResTplPromise>; // number
+type Payload3 = Result.PayloadOf<ResTplFn>; // boolean
+type Payload4 = Result.PayloadOf<ResTplPromiseFn>; // Date
+```
+
 ---
 
 ## `@reykjavik/webtools/SiteImprove`
@@ -1192,11 +1216,15 @@ const myStyle = style({
 ### `vanillaVars`
 
 **Syntax:**
-`` vanillaVars(...varNames: Array<T>): Record <`var${Capitalize<T>}`, string> ``
+`` vanillaVars(...varNames: Array<T>): Record <`var${Capitalize<T>}`, string> & { setVars: (Partial<Record<`var${Capitalize<T>}`, unknown>>) => string} ``
 
 Returns an object with privately scoped CSS variables props. Pass them around
 and use them in your CSS.
 
+The object also has a `setVars` method for generating a CSS string that sets
+all or some of the variables in CSS, without offending VSCode's CSS syntax
+parser too much.
+
 ```ts
 // MyComponent.css.ts
 import {

package/errorhandling.d.ts

@@ -51,6 +51,8 @@ export type ResultTuple<T, E extends Error = Error> = [error: undefined, result:
  * @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>;
+declare function Fail<E extends Error = Error>(e: E): FailResult<E>;
+declare function Fail<E extends Error = Error>(e: unknown): FailResult<E>;
 /**
  * Error handling utility that wraps a promise or a callback function.
  *
@@ -82,7 +84,7 @@ export declare const Result: {
      *
      * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
-    Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
+    Fail: typeof Fail;
     catch: typeof catch_;
     ify: typeof catch_;
     /**
@@ -106,5 +108,12 @@ export declare namespace Result {
     type TupleObj<T, E extends Error = Error> = ResultTupleObj<T, E>;
     type SuccessObj<T> = SuccessResult<T>;
     type FailObj<E extends Error> = FailResult<E>;
+    /**
+     * Extracts the successful payload type `T` from a `Result.Tuple<T>`-like
+     * type, a `Promise` of such type, or a function returning either of those.
+     *
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resultpayloadof
+     */
+    type PayloadOf<T extends ResultTuple<unknown> | Promise<ResultTuple<unknown>> | ((...args: Array<any>) => ResultTuple<unknown> | Promise<ResultTuple<unknown>>)> = T extends [undefined, infer P] | Promise<ResultTuple<infer P>> | ((...args: Array<any>) => ResultTuple<infer P> | Promise<ResultTuple<infer P>>) ? P : never;
 }
 export {};

package/errorhandling.js

@@ -48,12 +48,12 @@ const Success = (result) => {
     return tuple;
 };
 /*#__NO_SIDE_EFFECTS__*/
-const Fail = (e) => {
+function Fail(e) {
     const tuple = [(0, exports.asError)(e)];
     tuple.error = tuple[0];
     tuple.mapTo = () => tuple;
     return tuple;
-};
+}
 /*#__NO_SIDE_EFFECTS__*/
 function catch_(something) {
     if (something instanceof Promise) {

package/esm/errorhandling.d.ts

@@ -51,6 +51,8 @@ export type ResultTuple<T, E extends Error = Error> = [error: undefined, result:
  * @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>;
+declare function Fail<E extends Error = Error>(e: E): FailResult<E>;
+declare function Fail<E extends Error = Error>(e: unknown): FailResult<E>;
 /**
  * Error handling utility that wraps a promise or a callback function.
  *
@@ -82,7 +84,7 @@ export declare const Result: {
      *
      * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#resultsfail
      */
-    Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
+    Fail: typeof Fail;
     catch: typeof catch_;
     ify: typeof catch_;
     /**
@@ -106,5 +108,12 @@ export declare namespace Result {
     type TupleObj<T, E extends Error = Error> = ResultTupleObj<T, E>;
     type SuccessObj<T> = SuccessResult<T>;
     type FailObj<E extends Error> = FailResult<E>;
+    /**
+     * Extracts the successful payload type `T` from a `Result.Tuple<T>`-like
+     * type, a `Promise` of such type, or a function returning either of those.
+     *
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#type-resultpayloadof
+     */
+    type PayloadOf<T extends ResultTuple<unknown> | Promise<ResultTuple<unknown>> | ((...args: Array<any>) => ResultTuple<unknown> | Promise<ResultTuple<unknown>>)> = T extends [undefined, infer P] | Promise<ResultTuple<infer P>> | ((...args: Array<any>) => ResultTuple<infer P> | Promise<ResultTuple<infer P>>) ? P : never;
 }
 export {};

package/esm/errorhandling.js

@@ -43,12 +43,12 @@ const Success = (result) => {
     return tuple;
 };
 /*#__NO_SIDE_EFFECTS__*/
-const Fail = (e) => {
+function Fail(e) {
     const tuple = [asError(e)];
     tuple.error = tuple[0];
     tuple.mapTo = () => tuple;
     return tuple;
-};
+}
 /*#__NO_SIDE_EFFECTS__*/
 function catch_(something) {
     if (something instanceof Promise) {

package/esm/vanillaExtract.d.ts

@@ -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.3/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillavars
  */
 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

@@ -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.3/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillavars
  */
 export const vanillaVars = (...varNames) => {
     const id = vanillaClass(``);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.3.1",
+	"version": "0.3.3",
 	"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/vanillaExtract.d.ts

@@ -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.3/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillavars
  */
 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

@@ -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.3/README.md#vanillacvars
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.3/README.md#vanillavars
  */
 const vanillaVars = (...varNames) => {
     const id = vanillaClass(``);