@thi.ng/units 0.4.33 → 0.4.35

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-25T14:07:53Z
+- **Last updated**: 2024-03-02T14:05:53Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/units](https://media.thi.ng/umbrella/banners-20230807/thing-units.svg?576826a0)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/units.svg)](https://www.npmjs.com/package/@thi.ng/units)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -104,6 +93,8 @@ most dimensions' base units usually using a factor of 1 and no offset.
 For example, here's how we can define kilograms and meters:
 
 ```ts
+import { coherent, unit } from "@thi.ng/units";
+
 // kilogram, SI dimension 0
 const KG = coherent(0);
 // { dim: [ 1, 0, 0, 0, 0, 0, 0 ], scale: 1, offset: 0, coherent: true }
@@ -125,6 +116,8 @@ More complex units like electrical resistance (e.g. ohm) are based on more than
 a single dimension:
 
 ```ts
+import { div, A, V } from "@thi.ng/units";
+
 // ohm = volt / ampere
 div(V, A)
 // { dim: [ 1, 2, -3, -2, 0, 0,  0 ], scale: 1, offset: 0, coherent: true }
@@ -140,6 +133,8 @@ Btw. The
 function can be used to format a unit's dimension vector:
 
 ```ts
+import { div, formatSI, A, V } from "@thi.ng/units";
+
 formatSI(div(V, A));
 // "kg·m2·s-3·A-2"
 ```
@@ -422,6 +417,8 @@ Existing coherent units can be
 produce derived versions:
 
 ```ts
+import { prefix, Hz } from "@thi.ng/units";
+
 // define micrometer (also available as preset)
 prefix("µ", "m")
 // { dim: [ 0, 1, 0, 0, 0, 0, 0 ], scale: 0.000001, offset: 0, coherent: false }
@@ -446,6 +443,8 @@ The following combinators can be used to derive scaled and/or more complex units
   Creates reciprocal of given unit (e.g. Hz ⇒ 1/second)
 
 ```ts
+import { div, mul, pow, prefix, reciprocal, bit, m, s } from "@thi.ng/units";
+
 // acceleration (meter per second squared)
 const m_s2 = div(m, pow(s, 2));
 // { dim: [ 0, 1, -2, 0, 0, 0,  0 ], scale: 1, offset: 0, coherent: false }
@@ -475,6 +474,8 @@ nonsense).
 Units can be specified in various ways:
 
 ```ts
+import { convert, div, reciprocal, h, km_h, mph, yd } from "@thi.ng/units";
+
 // convert from km/h to mph using unit names
 convert(100, "km/h", "mph");
 // 62.13711922373341
@@ -496,6 +497,8 @@ Another example using dimensionless units (here angles, arc second ⇒ radian) t
 compute the distance of 10 arcsec on the earth surface (in meters):
 
 ```ts
+import { convert, R } from "@thi.ng/units";
+
 // earth radius in meters
 // (also available as quantity EARTH_RADIUS, see section below)
 const R = 6371000;
@@ -520,6 +523,8 @@ Quantities are created via
  quantities). Use [`convert()`](#unit-conversions) otherwise!
 
  ```ts
+import { convert, div, quantity } from "@thi.ng/units";
+
 // (also available as preset)
 const speedOfLight = quantity(299792458, "m/s");
 
@@ -531,6 +536,8 @@ convert(div(speedOfLight, quantity(2.4,"GHz")), "mm");
 Some examples using vector quantities:
 
 ```ts
+import { convert, mul, quantity, NONE } from "@thi.ng/units";
+
 // DIN A4 paper size (also available as preset)
 const A4 = quantity([210, 297], "mm");
 
@@ -552,6 +559,8 @@ mul(A4, quantity(300, "dpi")).deref()
 When combining different quantities, their units do not need to be the same:
 
 ```ts
+import { convert, mul, quantity } from "@thi.ng/units";
+
 // compute 10 mm x 2 inch and convert to square centimeter
 convert(mul(quantity(10, "mm"), quantity(2, "in")), "cm2")
 // 5.08

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/units",
-  "version": "0.4.33",
+  "version": "0.4.35",
   "description": "Extensible SI unit creation, conversions, quantities & calculations (incl. ~170 predefined units & constants)",
   "type": "module",
   "module": "./index.js",
@@ -35,10 +35,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.26",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/equiv": "^2.1.49",
-    "@thi.ng/errors": "^2.4.18"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/equiv": "^2.1.50",
+    "@thi.ng/errors": "^2.4.19"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
@@ -179,5 +179,5 @@
     "status": "beta",
     "year": 2021
   },
-  "gitHead": "6e20f80dd9df1c8055ffa3c1e4d6f7598add0c0b\n"
+  "gitHead": "df9e312af741d87e6b450afcfea6a6e381662b1e\n"
 }