@thi.ng/api 8.6.2 → 8.7.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-12-22T21:47:07Z
+- **Last updated**: 2023-02-05T14:42:21Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ 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.7.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.7.0) (2023-02-05)
+
+#### 🚀 Features
+
+- add narrow/widenType() fns ([5ce9938](https://github.com/thi-ng/umbrella/commit/5ce9938))
+
 ## [8.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.6.0) (2022-12-16)
 
 #### 🚀 Features

package/README.md

@@ -83,4 +83,4 @@ If this project contributes to an academic publication, please cite it as:
 
 ## License
 
-© 2016 - 2022 Karsten Schmidt // Apache License 2.0
+© 2016 - 2023 Karsten Schmidt // Apache License 2.0

package/decorators/configurable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurable.d.ts","sourceRoot":"","sources":["../src/decorators/configurable.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,eAG5C,CAAC"}

package/decorators/deprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.d.ts","sourceRoot":"","sources":["../src/decorators/deprecated.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,SAAU,MAAM;;;MAAsB,eAgB3D,CAAC"}

package/decorators/nomixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nomixin.d.ts","sourceRoot":"","sources":["../src/decorators/nomixin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,MAAO,GAAG,MAAM,MAAM,cAAc,kBAAkB,SAEzE,CAAC"}

package/decorators/sealed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealed.d.ts","sourceRoot":"","sources":["../src/decorators/sealed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM,gBAAiB,QAAQ,SAG3C,CAAC"}

package/mixins/ienable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ienable.d.ts","sourceRoot":"","sources":["../src/mixins/ienable.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,qBAmBvB,CAAC"}

package/mixins/igrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"igrid.d.ts","sourceRoot":"","sources":["../src/mixins/igrid.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,YAAY,qBAmCvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,qBAwCvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,qBAmDvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,qBAsDvB,CAAC"}

package/mixins/inotify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inotify.d.ts","sourceRoot":"","sources":["../src/mixins/inotify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAqB,MAAM,aAAa,CAAC;AAS5D,eAAO,MAAM,gBAAgB,cAAe,GAAG,EAAE,EAAE,KAAK,KAAK,YAU5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,qBA4CvB,CAAC"}

package/mixins/iterable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable.d.ts","sourceRoot":"","sources":["../src/mixins/iterable.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,SAAU,WAAW,wBAKvC,CAAC"}

package/mixins/iwatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwatch.d.ts","sourceRoot":"","sources":["../src/mixins/iwatch.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW,qBA0BtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.6.2",
+  "version": "8.7.0",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -37,12 +37,12 @@
     "test": "testament test"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.33.7",
-    "@thi.ng/testament": "^0.3.8",
-    "rimraf": "^3.0.2",
+    "@microsoft/api-extractor": "^7.34.2",
+    "@thi.ng/testament": "^0.3.10",
+    "rimraf": "^4.1.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.23.22",
-    "typescript": "^4.9.4"
+    "typedoc": "^0.23.24",
+    "typescript": "^4.9.5"
   },
   "keywords": [
     "assert",
@@ -225,5 +225,5 @@
       "default": "./watch.js"
     }
   },
-  "gitHead": "bc6f7f5e2765bb96fe64db804eaf4b2443b47fc6\n"
+  "gitHead": "50ba9c87676fac60c46d2bc0e4d2c7711a374a68\n"
 }

package/typedarray.d.ts

@@ -191,4 +191,63 @@ export declare const uintTypeForBits: (x: number) => UintType;
  * @param x -
  */
 export declare const intTypeForBits: (x: number) => IntType;
+/**
+ * Returns the next smaller {@link IntType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @param t
+ */
+export declare const narrowInt: (t: IntType | "i64") => "i32" | "i8" | "i16";
+/**
+ * Returns the next larger {@link IntType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenInt: (t: IntType) => "i32" | "i64" | "i16";
+/**
+ * Returns the next smaller {@link UintType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @remarks
+ * If type is `u8c`, returns `u8`.
+ *
+ * @param t
+ */
+export declare const narrowUint: (t: UintType | "u64") => "u8" | "u16" | "u32";
+/**
+ * Returns the next larger {@link UintType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenUint: (t: UintType) => "u16" | "u32" | "u64";
+/**
+ * Returns the next smaller {@link FloatType} for given type (or the same type
+ * if already the narrowest).
+ *
+ * @param t
+ */
+export declare const narrowFloat: (t: FloatType) => string;
+/**
+ * Returns the next larger {@link FloatType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenFloat: (t: FloatType) => string;
+/**
+ * Returns the next smaller type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the smallest).
+ *
+ * @param t
+ */
+export declare const narrowType: (t: Type | BigType) => string;
+/**
+ * Returns the next larger type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the widest).
+ *
+ * @param t
+ */
+export declare const widenType: (t: Type | BigType) => string;
 //# sourceMappingURL=typedarray.d.ts.map

package/typedarray.js

@@ -190,3 +190,76 @@ export const uintTypeForBits = (x) => x > 16 ? "u32" : x > 8 ? "u16" : "u8";
  * @param x -
  */
 export const intTypeForBits = (x) => x > 16 ? "i32" : x > 8 ? "i16" : "i8";
+/**
+ * Returns the next smaller {@link IntType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @param t
+ */
+export const narrowInt = (t) => t === "i64" ? "i32" : t === "i32" ? "i16" : t === "i16" ? "i8" : "i8";
+/**
+ * Returns the next larger {@link IntType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export const widenInt = (t) => t === "i8" ? "i16" : t === "i16" ? "i32" : t === "i32" ? "i64" : "i64";
+/**
+ * Returns the next smaller {@link UintType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @remarks
+ * If type is `u8c`, returns `u8`.
+ *
+ * @param t
+ */
+export const narrowUint = (t) => t === "u64" ? "u32" : t === "u32" ? "u16" : t === "u16" ? "u8" : "u8";
+/**
+ * Returns the next larger {@link UintType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export const widenUint = (t) => t === "u8" || t === "u8c"
+    ? "u16"
+    : t === "u16"
+        ? "u32"
+        : t === "u32"
+            ? "u64"
+            : "u64";
+/**
+ * Returns the next smaller {@link FloatType} for given type (or the same type
+ * if already the narrowest).
+ *
+ * @param t
+ */
+export const narrowFloat = (t) => (t === "f64" ? "f32" : "f32");
+/**
+ * Returns the next larger {@link FloatType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export const widenFloat = (t) => (t === "f32" ? "f64" : "f64");
+/**
+ * Returns the next smaller type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the smallest).
+ *
+ * @param t
+ */
+export const narrowType = (t) => t[0] === "i"
+    ? narrowInt(t)
+    : t[0] === "u"
+        ? narrowUint(t)
+        : narrowFloat(t);
+/**
+ * Returns the next larger type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the widest).
+ *
+ * @param t
+ */
+export const widenType = (t) => t[0] === "i"
+    ? widenInt(t)
+    : t[0] === "u"
+        ? widenUint(t)
+        : widenFloat(t);