Generators

A collection of minimal, dependency-free generators for developers, testers, and AI builders.

Overview

Generators provides fast, auditable modules for creating random or structured content — passwords, fake data, prompts, datasets, colors, and more — without large dependencies or opaque APIs. Each module is designed for portability, reproducibility, and simplicity.

Available modules:

• generate-avatar — SVG avatar and placeholder generator with initials or geometric patterns
  

• generate-card-number — Valid Luhn-compliant card number generator with realistic expiry and CVC for testing.
  

• generate-color — Random or deterministic color palette generator (HEX, RGB, HSL)
  

• generate-dataset — Generate structured JSON, JSONL, or CSV datasets for model fine-tuning or testing.
  

• generate-fake-data — Seedable, dependency-free fake data generator.
  

• generate-hash — Cryptographic and legacy hash generator (SHA-256, MD5) for text inputs.
  

• generate-lorem — Deterministic Lorem Ipsum text generator for placeholders, tests, and AI datasets.
  

• generate-password — Credit card validator with Luhn check and brand detection (Visa, Mastercard, Amex, etc.).
  

• generate-phone-number — US phone number generator with state filtering, city filtering, and bulk generation.
  

• generate-prompt — Template-based AI prompt generator for text, code, and image models.
  

• generate-ssn — Synthetic US Social Security number generator for fixtures and test data only.
  

• generate-token — Cryptographically secure token and UUID generator for authentication, API keys, and identifiers.
  

All helpers are designed for use in:

• Browsers (ESM)
• Node.js / Deno / Bun (import)
• Edge runtimes (Cloudflare Workers, Vercel Edge, etc.)

Each module has its own README.md, tests, and can be imported individually.

🔗 Live Demos (GitHub Pages)

You can try each generator interactively in your browser:

• Generate Avatar Test
• Generate Card Number Test
• Generate Color Test
• Generate Dataset Test
• Generate Fake Data Test
• Generate Hash Test
• Generate Lorem Ipsum Test
• Generate Password Test
• Generate Phone Number Test
• Generate Prompt Test
• Generate SSN Test
• Generate Token Test

Each page loads its respective module and allows interactive validation.

Install

npm i @yvancg/generators # or per-module packages when published

API Guarantees

• No eval or dynamic code.
• Regexes fuzz-tested for catastrophic backtracking.

Design Principles

1. Deterministic randomness: Supports fixed seeds for reproducibility.
2. Zero dependencies: Small and secure.
3. Cross-runtime: Runs anywhere ESM works.
4. Predictable output: Always valid and formatted.
5. Composable: Each generator is a pure function.

Example Usage

import { generateAvatar } from './generate-avatar/avatar.js';
import { generateCard } from './card.js';
import { generatePalette } from './generate-color/color.js';
import { generateDataset } from './generate-dataset/dataset.js';
import { rows, user } from './generate-fake-data/fake.js';
import { generateHash } from './generate-hash/hash.js';
import { generateLorem } from './generate-lorem/lorem.js';
import { generatePassword } from './generate-password/password.js';
import { generatePhoneNumber } from './generate-phone-number/phone.js';
import { generatePrompt } from './generate-prompt/prompt.js';
import { generateSSN } from './generate-ssn/ssn.js';
import { generateToken } from './generate-token/token.js';

console.log(generateAvatar({ text: 'AI', size: 128, seed: 'demo' }));
// → '<svg width="128" height="128" ...>…</svg>'

console.log(generateCard({ brand: 'visa' }));
// → { number: '4111111111111111', brand: 'visa', expiry: '08/28', cvc: '123' }

console.log(generatePalette({ base: '#3366ff', scheme: 'triadic', count: 5 }));
// → { base: '#3366ff', scheme: 'triadic', colors: ['#3366ff','#ff33cc','#33ff66'], textOnBase: '#ffffff' }

console.log(generateDataset({ count: 3, format: 'jsonl', seed: 'demo' }));
// → '{"id":"...","text":"Lorem ipsum ..."}'

console.log(rows(3, 42));
// → array of 3 fake user objects (deterministic)

console.log(user());
// → { id: "u_123456", name: "Ava Johnson", ... }

console.log(await generateHash('hello world', 'sha-256'));
// → 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'

console.log(generateLorem({ units: 'sentences', count: 2 }));
// → 'Lorem ipsum dolor sit amet consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.'

console.log(generatePassword({ length: 16, symbols: true }));
// → 'fP8!cN9^hK2@xQ4?'

console.log(generatePhoneNumber({ state: 'CA', count: 3 }));
// → ['415-555-1283', '818-555-9022', '323-555-4410']

console.log(generatePrompt('text', 'Write a {tone} tweet about {topic}', { tone: 'funny', topic: 'AI startups' }));
// → "Write a funny tweet about AI startups"

console.log(generateSSN({ count: 3, seed: 'demo' }));
// → ['123-45-6789', '...', '...']

console.log(generateToken({ type: 'hex', length: 32 }));
// → 'b1f94e1d28a2ef3e3a6f0b8e7e9cc041'

Folder Structure

generators/
  ├─ .github/
  │   ├─ workflows/
  │   └─ FUNDING.yml
  ├─ LICENSE
  ├─ README.md
  ├─ SECURITY.md
  ├─ package.json
  ├─ scripts/
  │   └─ bench.mjs
  ├─ generate-avatar/
  ├─ generate-card-number/
  ├─ generate-color/
  ├─ generate-fake-data/
  ├─ generate-hash/
  ├─ generate-lorem/
  ├─ generate-password/
  ├─ generate-phone-number/
  ├─ generate-prompt/
  ├─ generate-ssn/
  └─ generate-token/

Security Notes

• Uses crypto.getRandomValues or crypto.randomBytes for entropy.
• No external network requests.
• All JSON/YAML outputs sanitized.

Contributing

Pull requests for additional safe validators (e.g., IBAN, domain names, etc.) are welcome. Please maintain the following rules:

• Pure ESM or TypeScript modules
• No external dependencies
• 100% test coverage
• Keep logic under 150 lines per module

License

Licensed under the MIT License — see LICENSE.

Funding

If you find this project useful, please consider sponsoring its continued maintenance and security audits.

You can sponsor this project through:

• GitHub Sponsors: https://github.com/sponsors/yvancg
• Or any link listed in .github/FUNDING.yml

---

© 2025 Y Consulting LLC / Validators Project