@anil-labs/factory 0.1.0

package/dist/prng/types.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Pseudo-random number generator interface.
+ *
+ * All randomness in the package flows through this single contract — swap
+ * the implementation (`Mulberry32`, `Sfc32`, an external PRNG) without
+ * touching any consumer code.
+ */
+export interface Prng {
+    /** Boolean with probability `chance` of `true` (default 0.5). */
+    bool(chance?: number): boolean;
+    /** Read the current seed (useful for snapshot / debug). */
+    readonly currentSeed: number;
+    /** Float in `[min, max)` with `decimals` fixed digits. */
+    float(min: number, max: number, decimals?: number): number;
+    /** Integer in `[min, max]` inclusive. */
+    int(min: number, max: number): number;
+    /** Float in `[0, 1)` — the primitive every other method derives from. */
+    next(): number;
+    /** Pick a random element from a non-empty array. */
+    pick<T>(items: readonly T[]): T;
+    /** Reseed the generator. Resets the internal state to the new seed. */
+    seed(seed: number): void;
+}

package/dist/prng/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pseudo-random number generator interface.
+ *
+ * All randomness in the package flows through this single contract — swap
+ * the implementation (`Mulberry32`, `Sfc32`, an external PRNG) without
+ * touching any consumer code.
+ */
+export interface Prng {
+    /** Boolean with probability `chance` of `true` (default 0.5). */
+    bool(chance?: number): boolean;
+    /** Read the current seed (useful for snapshot / debug). */
+    readonly currentSeed: number;
+    /** Float in `[min, max)` with `decimals` fixed digits. */
+    float(min: number, max: number, decimals?: number): number;
+    /** Integer in `[min, max]` inclusive. */
+    int(min: number, max: number): number;
+    /** Float in `[0, 1)` — the primitive every other method derives from. */
+    next(): number;
+    /** Pick a random element from a non-empty array. */
+    pick<T>(items: readonly T[]): T;
+    /** Reseed the generator. Resets the internal state to the new seed. */
+    seed(seed: number): void;
+}

package/dist/snapshot/index.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Snapshot helpers.
+ *
+ * The package doesn't write files itself — it just normalises payloads so
+ * test runners (vitest, jest) can snapshot them deterministically.
+ *
+ * @example
+ * ```ts
+ * import { snapshot } from '@anil-labs/factory'
+ *
+ * const items = UserFactory.seed(42).count(3).make()
+ * expect(snapshot(items)).toMatchSnapshot()
+ * ```
+ */
+/** Recursively normalise dates, undefineds, and key order so snapshots are stable. */
+export declare function snapshot(value: unknown): unknown;

package/dist/snapshot/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Snapshot helpers.
+ *
+ * The package doesn't write files itself — it just normalises payloads so
+ * test runners (vitest, jest) can snapshot them deterministically.
+ *
+ * @example
+ * ```ts
+ * import { snapshot } from '@anil-labs/factory'
+ *
+ * const items = UserFactory.seed(42).count(3).make()
+ * expect(snapshot(items)).toMatchSnapshot()
+ * ```
+ */
+/** Recursively normalise dates, undefineds, and key order so snapshots are stable. */
+export declare function snapshot(value: unknown): unknown;

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "@anil-labs/factory",
+  "version": "0.1.0",
+  "description": "Laravel-inspired model factory + faceted faker for TypeScript. Seedable, locale-aware, framework-agnostic, zero runtime deps.",
+  "type": "module",
+  "license": "MIT",
+  "author": {
+    "name": "Anil Kumar Thakur",
+    "url": "https://github.com/anilkumarthakur60"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anilkumarthakur60/factory.git"
+  },
+  "homepage": "https://github.com/anilkumarthakur60/factory#readme",
+  "bugs": {
+    "url": "https://github.com/anilkumarthakur60/factory/issues"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.mjs"
+    },
+    "./faker": {
+      "import": {
+        "types": "./dist/faker/index.d.ts",
+        "default": "./dist/faker.mjs"
+      },
+      "require": {
+        "types": "./dist/faker/index.d.cts",
+        "default": "./dist/faker.cjs"
+      },
+      "default": "./dist/faker.mjs"
+    },
+    "./persist": {
+      "import": {
+        "types": "./dist/persist/index.d.ts",
+        "default": "./dist/persist.mjs"
+      },
+      "require": {
+        "types": "./dist/persist/index.d.cts",
+        "default": "./dist/persist.cjs"
+      },
+      "default": "./dist/persist.mjs"
+    },
+    "./locales/en": {
+      "import": {
+        "types": "./dist/locales/en.d.ts",
+        "default": "./dist/locales/en.mjs"
+      },
+      "require": {
+        "types": "./dist/locales/en.d.cts",
+        "default": "./dist/locales/en.cjs"
+      },
+      "default": "./dist/locales/en.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist coverage",
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "verify": "npm run typecheck && npm run lint && npm run format:check && npm test",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "npm run clean && npm run verify && npm run build",
+    "prepack": "node -e \"const f=require('./package.json').files;console.log('\\n[prepack] tarball will include only:',f.join(', '));console.log('[prepack] docs/, src/, tests/, configs are excluded.\\n')\""
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@microsoft/api-extractor": "^7.58.7",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "eslint": "^10.4.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-perfectionist": "^5.9.0",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.4",
+    "vite": "^8.0.13",
+    "vite-plugin-dts": "^5.0.1",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "factory",
+    "faker",
+    "test-data",
+    "laravel",
+    "eloquent",
+    "seeder",
+    "mock",
+    "typescript",
+    "fixtures",
+    "seedable",
+    "locale",
+    "esm",
+    "cjs",
+    "isomorphic",
+    "browser",
+    "node",
+    "bun",
+    "deno"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}