@thi.ng/api 8.9.29 → 8.9.30

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-03-09T09:18:17Z
+- **Last updated**: 2024-03-13T14:04:31Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/deref.d.ts

@@ -18,7 +18,7 @@ export type Derefed<T> = T extends IDeref<any> ? ReturnType<T["deref"]> : T;
  * attempts to resolve each given key via {@link Derefed}.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/deref.ts
  * import type { DerefedKeys, IDeref } from "@thi.ng/api";
  *
  * interface Foo {

package/equiv.d.ts

@@ -1,7 +1,9 @@
 export interface IEquiv {
     /**
      * Returns `true` if this *value* is equivalent to `o`. Also see
-     * {@link ICompare.compare} and {@link IHash.hash}.
+     * [ICompare.compare](https://docs.thi.ng/umbrella/api/interfaces/ICompare.html#compare)
+     * and
+     * [IHash.hash](https://docs.thi.ng/umbrella/api/interfaces/IHash.html#hash).
      *
      * @param o - value to check for equivalence
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.9.29",
+  "version": "8.9.30",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -39,11 +39,11 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.40.1",
-    "esbuild": "^0.20.0",
+    "@microsoft/api-extractor": "^7.42.3",
+    "esbuild": "^0.20.1",
     "rimraf": "^5.0.5",
-    "typedoc": "^0.25.7",
-    "typescript": "^5.3.3"
+    "typedoc": "^0.25.12",
+    "typescript": "^5.4.2"
   },
   "keywords": [
     "assert",
@@ -226,5 +226,5 @@
       "default": "./watch.js"
     }
   },
-  "gitHead": "69100942474942f7446ac645d59d91e7dfc352f9\n"
+  "gitHead": "7f3fcbd6c0462b0ce45afa141fe163d1f297fd51\n"
 }

package/typedarray.d.ts

@@ -116,11 +116,18 @@ export interface BigTypedArrayTypeMap extends Record<BigType, BigTypedArray> {
  * attempting to resolve it as {@link GLType} enum.
  *
  * @example
- * ```ts
- * import { asNativeType } from "@thi.ng/api";
+ * ```ts tangle:../export/as-native-type.ts
+ * import { asNativeType, GLType } from "@thi.ng/api";
  *
- * asNativeType(GLType.F32) => "f32"
- * asNativeType("f32") => "f32"
+ * console.log(
+ *   asNativeType(GLType.F32)
+ * );
+ * // "f32"
+ *
+ * console.log(
+ *   asNativeType("f32")
+ * );
+ * // "f32"
  * ```
  *
  * @param type -
@@ -130,11 +137,18 @@ export declare const asNativeType: (type: GLType | Type) => Type;
  * Returns suitable {@link GLType} enum of `type`.
  *
  * @example
- * ```ts
- * import { asGLType } from "@thi.ng/api";
+ * ```ts tangle:../export/as-gl-type.ts
+ * import { asGLType, GLType } from "@thi.ng/api";
+ *
+ * console.log(
+ *   asGLType("f32")
+ * );
+ * // 5126 (aka GLType.F32)
  *
- * asGLType("f32") => GLType.F32
- * asGLType(GLType.F32) => GLType.F32
+ * console.log(
+ *   asGLType(GLType.F32)
+ * );
+ * // 5126 (aka GLType.F32)
  * ```
  *
  * @param type -
@@ -172,15 +186,19 @@ export declare function typedArray<T extends BigType>(type: T, buf: ArrayBufferL
  * item/vector given.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/typed-array.ts
  * import { typedArrayOfVec } from "@thi.ng/api";
  *
  * // inferred stride=2 (2d vectors)
- * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]]);
+ * console.log(
+ *   typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]])
+ * );
  * // Float32Array(6) [ 1, 2, 3, 4, -10, 20 ]
  *
  * // with custom stride=4
- * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]], 4);
+ * console.log(
+ *   typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]], 4)
+ * );
  * // Float32Array(12) [ 1, 2, 0, 0, 3,4, 0, 0, -10, 20, 0, 0 ]
  * ```
  *