open-index/open-npm huggingface dataset:
npm package: @paperclover/lib
Description: high quality typescript libraries
Latest version: 1.0.0

# [clover's typescript library]

`lib` is a collection of high-quality typescript libraries for things missing in
either browsers or node.js. originally, these were helper functions used to
create my website, <https://paperclover.net>, but i started wanting them across
projects and at work.

```sh
# alias install "lib" using "@paperclover/lib"
npm install lib@npm:@paperclover/lib
```

all top-level namespaces stand alone as their own projects, and generally do not
depend on each other. there are no external dependencies; code is easy to audit.

the public api is simply all of the code. an overview:

<!-- - `async` -->
<!-- - `error` - interop with the `unknown` type in error handlers -->
<!-- - `fs` - rebuilt api for `node:fs` -->
<!-- - `lru` - least recently used cache -->
<!-- - `mime` - trimmed database of mime types -->
<!-- - `subprocess` - rebuilt api for `node:child_process` -->
<!-- - `testing` -->

- `assert`
- `log` - logging, terminal i/o, interactive widgets
- `log/ansi` - cursor and color constants
- `log/headless` - use `log` and `log/progress` without a tty
- `log/progress` - progress bar, spinner, and tree
- `log/stack` - stack trace parse and formatter
- `packaging` - workflows used for `lib`'s publications
- `queue` - priority queue with rescheduling
- `string`
- `ts` typescript types and general purpose code

these libraries are published as is, **without versioning or maintainance
guarantees**. every version is a breaking major release. please upgrade your
libraries with intent, considering api changes in [readme.changes.md].
individual modules may annotate their intended api and usage stability.

keep in mind there are [known bugs and missing features] in this release.

to contribute, please send bug reports or patches to <dev@paperclover.net>. new
features may not be accepted if they are complex and don't further my use cases.

[readme.changes.md]: ./readme.changes.md
[known bugs and missing features]: https://git.paperclover.net/clo/sitegen/issues?state=open&labels=4
[clover's typescript library]: https://git.paperclover.net/clo/sitegen/src/branch/master/lib