@opentf/std

✨ Features

• 🎨 Intuitive API: Designed for clarity, simplicity, and ease of use.
• 🌍 Runtime Agnostic: Seamless execution across all JavaScript environments.
• ⚡ High Performance: Optimized for speed without sacrificing accuracy.
• ⏳ Modern Async: Advanced tools for managing complex asynchronous flows.
• 🛡️ Full Type Safety: Built with TypeScript for deep, native type inference.
• 📦 Zero Dependencies: Lightweight, tree-shakeable, and ESM/CJS ready.
• 🌲 Broad Compatibility: Future-proof code with broad environment support.

🤔 Why @opentf/std?

While JavaScript has come a long way, many native methods still have quirks or lack deep comparison/cloning capabilities. @opentf/std aims to fill those gaps with a focus on:

1. Accuracy First 🎯: We prioritize correct results over extreme micro-optimizations.
2. Deep Everything 🧬: Built-in support for complex types like Map, Set, Date, and RegExp in equality and cloning.
3. Consistent API 🤝: The same behavior across all runtimes, so you can write once and run anywhere.
4. Zero Bloat 🧊: Only the code you use ends up in your bundle.
5. Modern Anywhere 🚀: Get modern language features in any environment without polluting the global namespace.

📦 Installation

Install @opentf/std using your preferred package manager:

bun add @opentf/std 

🛠 Usage

Explore the library's capabilities with these common patterns:

1. Robust Type Checking

import { isNumber } from "@opentf/std";
 
isNumber(NaN); //=> false
isNumber('1'); //=> false
isNumber('1', true); //=> true (strict numeric string check)
isNumber(1); //=> true

2. String Manipulation

import { pascalCase } from "@opentf/std";
 
pascalCase("hello world"); //=> "HelloWorld"

3. Advanced Sorting

import { sort } from "@opentf/std";
 
sort([1, 10, 21, 2], "desc"); //=> [21, 10, 2, 1]

4. Deep Cloning

import { clone } from "@opentf/std";
 
const obj = { a: 1, b: "abc", c: new Map([["key", "val"]]) };
const newObj = clone(obj); // Deeply cloned with Map support

5. Smart Equality

import { isEql, isUnorderedEqual } from "@opentf/std";
 
isEql({a: 1}, {a: 1}); //=> true
 
const mapA = new Map([["a", 1], ["b", 2]]);
const mapB = new Map([["b", 2], ["a", 1]]);
isEql(mapA, mapB); //=> false (Map order matters for equality)
 
// Compare Arrays ignoring order
isUnorderedEqual([1, 2, 3], [2, 3, 1]); //=> true

6. Modern Async

import { sleep, withResolvers } from "@opentf/std";
 
// Externalized Promise resolution
const { promise, resolve } = withResolvers();
setTimeout(() => resolve("Done!"), 1000);
await promise;
 
await sleep(1000); // Suspends execution for 1 second

7. Functional Patterns

import { pipe } from "@opentf/std";
 
const result = pipe(
  1,
  (x) => x + 1,
  (x) => x * 5
); //=> 10

8. Object Transformation

import { pick, omit } from '@opentf/std';
 
const obj = { a: 1, b: 2, c: 3 };
 
pick(obj, 'a', 'c'); //=> { a: 1, c: 3 }
omit(obj, 'a', 'c'); //=> { b: 2 }

📊 Benchmarks

We prioritize reliability and accuracy while maintaining highly competitive speeds.

clone

sortBy

isEql

[!TIP] Run your own benchmarks: bun run build && bun benchmark.js

❓ FAQ

1. Why another standard library?

Native methods are great, but they often lack depth (e.g., Object.assign is shallow) or have inconsistent behavior across environments. @opentf/std provides a unified, high-fidelity API.

2. Is it production-ready?

Yes. The library is 100% tested, strictly typed, and used in production across the Open Tech Foundation ecosystem.

3. Does it support tree-shaking?

Yes. Every utility is exported individually, ensuring your final bundle only contains what you actually use.

📖 Articles

Dive deeper into our philosophy:

• Introducing Our New JavaScript Standard Library (opens in a new tab)
• You Don't Need JavaScript Native Methods (opens in a new tab)

📄 License

This project is licensed under the MIT License (opens in a new tab).