@opentf/std

A lightweight, high-accuracy, runtime-agnostic collection of essential utilities.

Installation

Install @opentf/std using your preferred package manager:

# Bun
bun add @opentf/std

# pnpm
pnpm add @opentf/std

# npm
npm install @opentf/std

# Deno
deno add @opentf/std

# yarn
yarn add @opentf/std

Quick Start

Beyond the everyday helpers, @opentf/std ships capabilities you'd normally reach for a separate package to get:

import {
  DateTime,
  Decimal,
  color,
  colorContrast,
  formatBytes,
  formatCurrency,
  uuidv7,
  stringWidth,
} from "@opentf/std";

// 🕒 Dates in any IANA zone — no time-zone database, no dependency
const t = new DateTime("2026-03-07T12:00", { timeZone: "America/New_York" });
t.add({ days: 1 }).format("HH:mm ZZ"); //=> "12:00 -04:00"  DST-safe: 23 real hours
t.withTimeZone("Asia/Kolkata").format("EEE d MMM, HH:mm"); //=> "Sat 7 Mar, 22:30"
new DateTime("2028-02-10").endOf("month"); //=> 2028-02-29  leap-year aware

// 🎯 Exact decimal math — no floating-point errors
new Decimal("0.1").add("0.2").toString(); //=> "0.3"

// 🎨 Color parsing, conversion & WCAG accessibility
color("rebeccapurple", "hex"); //=> "#663399"
colorContrast("white", "black"); //=> 21  (WCAG ratio)

// 💾 Human-readable, locale-aware formatting
formatBytes(1234567); //=> "1.18 MiB"
formatCurrency(1200, "EUR", { locale: "de-DE" }); //=> "1.200,00 €"

// 🆔 Time-sortable UUID via runtime-agnostic crypto
uuidv7(); //=> "0195e2a4-8c3d-7000-…"

// 📏 Emoji & CJK aware string width (terminal-safe)
stringWidth("🔥こんにちは"); //=> 12

Next Steps

• Try the Interactive Playground — visualize idleRun, paceRun, batchRun, rateLimitRun & retryRun in real time.
• Explore standout utilities: DateTime, Decimal, color, uuidv7, formatCurrency, lazy Iterators and set math.
• Browse every utility by category in the Repository Documentation (or on the Website).

License

This project is licensed under the MIT License.