Skip to content

silvermine/toolbox

Folders and files

NameName
Last commit message
Last commit date
Aug 5, 2024
Sep 3, 2024
Sep 3, 2024
Feb 14, 2022
Mar 24, 2019
Mar 24, 2019
May 27, 2022
Mar 24, 2019
May 3, 2019
May 2, 2024
Mar 24, 2019
Sep 3, 2024
May 27, 2022
Mar 24, 2019
May 27, 2022
Feb 14, 2022
Sep 13, 2024
Sep 13, 2024
Aug 5, 2024
Feb 14, 2022

Repository files navigation

Silvermine Toolbox - TypeScript Types and Utilities

Tools such as a protractor, calculator, pencil, and a pen inside a shirt pocket.

NPM Version License Build Status Coverage Status Dependency Status Dev Dependency Status Conventional Commits

What?

A collection of common types, type guards, and utilities for our TypeScript codebases.

Why?

We found that in many TypeScript projects we needed some of the same basic constructs, e.g. an object that had string keys and string values. These types are easy enough to define in each project (e.g. { [k: string]: string }), but then you might need a type guard, too. And if you need a type guard, you need unit tests for that type guard. So, we collect frequently-used types in this repo, and use this project in our other projects.

While we wanted to focus primarily on types, and we don't want this to become the "junk drawer" of every tool we ever need, there was also the need for a few helper / utility functions in our codebases. For example, in some codebases we don't want to use Underscore or lodash because we only need one or two functions and can't afford the extra bloat of a full-blown library comprised of mostly things we don't need; those functions will be implemented in this toolbox. This codebase is not a replacement for Underscore or lodash; it's primarily a collection of types and type guards, with a few additional utilities sprinkled in.

More details about the specific types and utilities will be included at a later time when we get a doc-build system integrated.

License

This software is released under the MIT license. See the license file for more details.