@e280/stz 0.0.0-32 → 0.0.0-34

package/README.md

@@ -10,7 +10,6 @@ zero dependencies.
 <br/>
 
 ## 🧰 STZ PRIMITIVES
-> cool concepts we use all over the place
 
 ### 🍏 MapG
 > extended js map
@@ -122,8 +121,7 @@ import {pub, sub} from "@e280/stz"
 
 <br/>
 
-## 🧰 FN TOOLS
-> function-oriented tools
+## 🧰 STZ FN TOOLS
 
 ### 🍏 `queue(fn)`
 > execute calls in sequence (not concurrent)
@@ -171,6 +169,26 @@ await fn()
   // DeadlineError: deadline exceeded (0.1 seconds)
 ```
 
+### 🍏 `debounce(100, fn)`
+> wait some time before actually executing the fn (absorbing redundant calls)
+
+we use `debounce` a lot in ui code, like on a user's keyboard input in a form field, but rendering the form input can actually be slow enough that it causes problems when they type fast — to eliminate the jank, we `debounce` with like 400 ms, so we wait for the user to finish typing for a moment before actually running the validation.
+
+```ts
+import {debounce} from "@e280/stz"
+
+const fn = debounce(100, async() => {
+  await coolAction()
+})
+
+// each fn() call resets the timer
+fn()
+fn()
+fn()
+
+// coolAction is only called once here, other calls are redundant
+```
+
 ### 🍏 `repeat(fn)`
 > execute a function over and over again, back to back
 
@@ -193,11 +211,44 @@ stop()
 
 <br/>
 
-## 🧰 DATA UTILITIES
-> transforming and representing binary data
+## 🧰 STZ DATA UTILITIES
+
+### 🍏 Hex
+> convert to/from hexadecimal string format
+- `Hex.fromBytes(bytes)` — bytes to hex string
+- `Hex.toBytes(string)` — hex string to bytes
+- `Hex.random(32)` — generate random hex string (32 bytes)
+
+### 🍏 Base64
+> convert to/from base64 string format
+- `Base64.fromBytes(bytes)` — bytes to string
+- `Base64.toBytes(string)` — string to bytes
+- `Base64.random(32)` — generate random string (32 bytes)
+
+### 🍏 Base64url
+> convert to/from base64 string format
+- `Base64url.fromBytes(bytes)` — bytes to string
+- `Base64url.toBytes(string)` — string to bytes
+- `Base64url.random(32)` — generate random string (32 bytes)
+
+### 🍏 Base58
+> convert to/from base64 string format
+- `Base58.fromBytes(bytes)` — bytes to string
+- `Base58.toBytes(string)` — string to bytes
+- `Base58.random(32)` — generate random string (32 bytes)
+
+### 🍏 Txt
+> convert to/from utf8 string format
+- `Txt.fromBytes(bytes)` — bytes to string
+- `Txt.toBytes(string)` — string to bytes
+
+### 🍏 Bytes
+> utilities for dealing with Uint8Array
+- `Bytes.eq(bytesA, bytesB)` — check if two byte arrays are equal
+- `Bytes.random(32)` — generate crypto-random bytes
 
 ### 🍏 BaseX
-> represent data in arbitrary encodings
+> convert data into arbitrary data encodings
 - make a BaseX instance
   ```ts
   import {BaseX} from "@e280/stz"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-32",
+	"version": "0.0.0-34",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -26,7 +26,7 @@
 		"_tscw": "tsc -w"
 	},
 	"devDependencies": {
-		"@e280/science": "^0.0.5",
+		"@e280/science": "^0.0.6",
 		"@types/node": "^24.2.0",
 		"npm-run-all": "^4.1.5",
 		"typescript": "^5.9.2"