Vielzeug

Appearance

Random Utilities ​

Random utilities provide tools to generate random values, shuffle data, and create unique identifiers. These helpers are designed for everyday tasks like sampling, randomization, and unique key generation.

📚 Quick Reference ​

Problem ​

Implement 📚 quick reference in a production-friendly way with @vielzeug/toolkit while keeping setup and cleanup explicit.

Runnable Example ​

The snippet below is copy-paste runnable in a TypeScript project with @vielzeug/toolkit installed.

MethodDescription
randomGenerate a random integer between a minimum and maximum value.
drawPick a random element from an array.
shuffleCreate a new array with the elements of the original array in random order.
uuidGenerate a cryptographically strong unique identifier (v4).

💡 Practical Examples ​

Sampling & Randomization ​

ts
import { random, draw, shuffle } from '@vielzeug/toolkit';

// 1. Random number in range
const dieRoll = random(1, 6);

// 2. Pick a winner from an array
const contestants = ['Alice', 'Bob', 'Charlie', 'David'];
const winner = draw(contestants);

// 3. Randomize a list (original array is not modified)
const deck = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
const shuffledDeck = shuffle(deck);

Unique Identifiers ​

ts
import { uuid } from '@vielzeug/toolkit';

// Generate a unique ID for a new record
const newUserId = uuid();
// "f47ac10b-58cc-4372-a567-0e02b2c3d479"

🔗 All Random Utilities ​

Expected Output ​

  • The example runs without type errors in a standard TypeScript setup.
  • The main flow produces the behavior described in the recipe title.

Common Pitfalls ​

  • Forgetting cleanup/dispose calls can leak listeners or stale state.
  • Skipping explicit typing can hide integration issues until runtime.
  • Not handling error branches makes examples harder to adapt safely.