@thi.ng/api 8.9.31 → 8.10.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-03-27T09:53:45Z
+- **Last updated**: 2024-04-08T14:59:29Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,14 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [8.10.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.10.0) (2024-04-08)
+
+#### 🚀 Features
+
+- add async types ([35ad820](https://github.com/thi-ng/umbrella/commit/35ad820))
+- add async function types ([afb4200](https://github.com/thi-ng/umbrella/commit/afb4200))
+- add Values<T> ([8a799ea](https://github.com/thi-ng/umbrella/commit/8a799ea))
+
 ## [8.9.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.9.0) (2023-08-04)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 190 standalone projects, maintained as part
+> This is one of 191 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -46,7 +46,13 @@ defines:
 yarn add @thi.ng/api
 ```
 
-ES module import:
+ESM import:
+
+```ts
+import * as api from "@thi.ng/api";
+```
+
+Browser ESM import:
 
 ```html
 <script type="module" src="https://cdn.skypack.dev/@thi.ng/api"></script>
@@ -60,7 +66,7 @@ For Node.js REPL:
 const api = await import("@thi.ng/api");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.37 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.41 KB
 
 ## Dependencies
 

package/async.d.ts

@@ -0,0 +1,27 @@
+import type { Fn, Fn0, Fn10, Fn2, Fn3, Fn4, Fn5, Fn6, Fn7, Fn8, Fn9, FnAny } from "./fn.js";
+export type MaybePromise<T> = T | Promise<T>;
+export type MaybeAsyncIterable<T> = Iterable<T> | AsyncIterable<T>;
+export type MaybeAsyncGenerator<T> = IterableIterator<T> | AsyncIterableIterator<T>;
+export type AsyncPredicate<T> = FnA<T, boolean>;
+export type AsyncPredicate2<T> = FnA2<T, T, boolean>;
+export type AsyncStatefulPredicate<T> = Fn0<AsyncPredicate<T>>;
+export type AsyncStatefulPredicate2<T> = Fn0<AsyncPredicate2<T>>;
+export type Fn0A<A> = Fn0<Promise<A>>;
+export type FnA<A, B> = Fn<A, Promise<B>>;
+export type FnA2<A, B, C> = Fn2<A, B, Promise<C>>;
+export type FnA3<A, B, C, D> = Fn3<A, B, C, Promise<D>>;
+export type FnA4<A, B, C, D, E> = Fn4<A, B, C, D, Promise<E>>;
+export type FnA5<A, B, C, D, E, F> = Fn5<A, B, C, D, E, Promise<F>>;
+export type FnA6<A, B, C, D, E, F, G> = Fn6<A, B, C, D, E, F, Promise<G>>;
+export type FnA7<A, B, C, D, E, F, G, H> = Fn7<A, B, C, D, E, F, G, Promise<H>>;
+export type FnA8<A, B, C, D, E, F, G, H, I> = Fn8<A, B, C, D, E, F, G, H, Promise<I>>;
+export type FnA9<A, B, C, D, E, F, G, H, I, J> = Fn9<A, B, C, D, E, F, G, H, I, Promise<J>>;
+export type FnA10<A, B, C, D, E, F, G, H, I, J, K> = Fn10<A, B, C, D, E, F, G, H, I, J, Promise<K>>;
+export type FnAnyA<T> = FnAny<Promise<T>>;
+/**
+ * Async version of {@link identity}.
+ *
+ * @param x
+ */
+export declare const asyncIdentity: <T>(x: T) => Promise<T>;
+//# sourceMappingURL=async.d.ts.map

package/async.js

@@ -0,0 +1,4 @@
+const asyncIdentity = async (x) => x;
+export {
+  asyncIdentity
+};

package/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./assoc.js";
+export * from "./async.js";
 export * from "./bind.js";
 export * from "./buffered.js";
 export * from "./clear.js";

package/index.js

@@ -1,4 +1,5 @@
 export * from "./assoc.js";
+export * from "./async.js";
 export * from "./bind.js";
 export * from "./buffered.js";
 export * from "./clear.js";

package/keyval.d.ts

@@ -41,6 +41,10 @@ type KeysNReducer<T, L, R extends unknown[]> = L extends keyof T ? {
  * Generalised version of Keys0 - Keys7.
  */
 export type KeysN<T, L extends unknown[]> = L extends [] ? Keys<T> : KeysNReducer<T, Head<L>, Tail<L>>;
+/**
+ * Type union of values of all keys in T.
+ */
+export type Values<T> = Val1<T, Keys<T>>;
 export type Val1<T, A extends Keys<T>> = T[A];
 export type Val2<T, A extends Keys<T>, B extends Keys1<T, A>> = ValN<T, [A, B]>;
 export type Val3<T, A extends Keys<T>, B extends Keys1<T, A>, C extends Keys2<T, A, B>> = ValN<T, [A, B, C]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.9.31",
+  "version": "8.10.0",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -81,6 +81,9 @@
     "./assoc": {
       "default": "./assoc.js"
     },
+    "./async": {
+      "default": "./async.js"
+    },
     "./bind": {
       "default": "./bind.js"
     },
@@ -226,5 +229,5 @@
       "default": "./watch.js"
     }
   },
-  "gitHead": "feb3b24654f2c931cd3c3308c1c0c807ee14d0e4\n"
+  "gitHead": "85ac4bd4d6d89f8e3689e2863d5bea0cecdb371c\n"
 }