Package Exports
- @herb-ert/mockkitjs
- @herb-ert/mockkitjs/src/mockkit.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@herb-ert/mockkitjs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
๐งช Mockkit.js
Mockkit.js is a deterministic mock data generator โ a small, fast utility to generate predictable, structured fake data for testing, seeding, prototyping, and demos.
โก Powered by a seedable pseudo-random generator for repeatable results.
๐ Features
- ๐ฒ Seeded randomness for predictable mock data
- ๐ฆ Lightweight and dependency-free
- ๐ง Structured fake data: numbers, names, and more (extensible)
- ๐ก Ideal for testing, seeding databases, or building demos
- ๐งฉ Modular design โ import only what you need
๐ฆ Installation
npm install @herb-ert/mockkitjs
๐ ๏ธ Usage
import { seed } from '@herb-ert/mockkitjs';
import { faker } from '@herb-ert/mockkitjs';
// Set a seed for deterministic results
seed(43);
// Use faker modules
console.log(faker.number.int(10, 50)); // Same number every time with same seed
console.log(faker.number.float(0, 1)); // e.g., 0.35
console.log(faker.number.dice(20)); // Roll a D20
๐ API
Core
seed(number)
Sets the global seed for deterministic randomness.
Faker Modules
faker.number.int(min, max)
Returns a random integer between min
and max
(inclusive).
faker.number.float(min, max, decimals)
Returns a random float with specified decimal precision.
faker.number.dice(sides)
Simulates rolling an N
-sided die.
More modules coming soon โ names, dates, strings, arrays, and more!
๐งช Why Deterministic?
Mockkit uses a seedable PRNG to give you consistent data across test runs or rebuilds.
Perfect for unit tests, snapshot testing, or consistent seeding during development.
๐ License
MIT โ ยฉ herb-ert
๐ค๏ธ Roadmap
- Number module
- Name generator
- Date & time mockers
- String / text generators
- Array & object builders
- Faker extensibility API
๐ Changelog
See CHANGELOG.md for version history and release notes.