@oazmi/kitchensink

A messy modular collection of personal utility functions that I use all the time. Written in Typescript with TypeDoc documents generator, highly minifiable when bundled, and has no external dependencies.

A wise billionaire once said: whenever you encounter a ~~(...func) => {tion}~~ that's called more than twice, you should "let that sink in" - Musk le Elon abu Twitter et al...

Installation

To get started for node/npm shadow repo clone jutsu the npm branch in your existing project directory:

pnpm add -D github:omar-azmi/kitchensink_ts#npm

And now, import whatever the heck you like:

// import { antigravity } from "[email protected]"
import { setDotPath } from "jsr:@oazmi/kitchensink/dotkeypath"
import { pack } from "jsr:@oazmi/kitchensink/eightpack"
import { downloadBuffer } from "jsr:@oazmi/kitchensink/browser"
// or why not use a single import?
// import { setDotPath, pack, downloadBuffer } from "jsr:@oazmi/kitchensink"

const statement = { I: { am: { very: { stupidly: undefined } } } }
let bin_str = ""
setDotPath(statement, "I.am.very.stupidly", "defined")
if (statement.I.am.very.stupidly === "defined") bin_str += "kermit da leap of faith no jutsu"
downloadBuffer(pack("str", bin_str), "i am very smart.txt", "text/plain")
alert("plz download the virus text file")

The submodule docs are available on github-pages, for you to figure out the REST api yourself.

Once your tradesecret™ functions are registered, stage the action transformation sequence, duel in the ancient egyptian era of merge conflicts, and finally Kermit neck rope - said Dumbledwarf calmly, knowing very well that MangoSoft was scheming to Copilot his consciousness into the copypasta ~~shadow~~ purple realm.

Non-mandatory example

/** TODO: someday, somewhere, sometime, somehow, something, sound, shall be around */

Compatibility

Works with: Deno 1, Deno 2, Browsers, Node >= 18, Cloudflare Workers, Bun? (it's too ugly for consideration; for the longest time, it didn't even work on windows)

Dino Specimen

Specimen A: I just needed an excuse to put this up.