faker-i18n 0.1.0

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mikefox10
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# faker-i18n
+
+✨ **faker-i18n** is a lightweight library for generating fake data in a simple, fast, and dependency-free way.  
+Perfect for **tests**, **seeders**, **mocking**, and **prototyping**.
+
+
+## 🌍 Supported Locales
+
+Currently supported locales:
+
+- EN – English (Default)
+
+- ES – Spanish
+
+- PT – Portuguese
+
+- FR – French
+
+- DE – German
+
+- RU – Russian
+
+- JA – Japanese
+
+- ZH – Chinese
+
+- TR – Turkish
+
+## 📦 Installation
+
+```bash
+npm install faker-i18n
+```
+
+## Basic Usage
+
+```bash
+import { faker } from "faker-i18n";
+
+const fake = faker("EN");
+
+console.log(fake.firstName());   // Mike
+console.log(fake.lastName());    // Taylor
+console.log(fake.company());     // Soft Inc
+console.log(fake.jobTitle());    // Designer
+```
+
+### Person
+
+```bash
+fake.firstName();   // Mike
+fake.lastName();    // Taylor
+fake.fullName();    // Mike Taylor
+fake.company();     // Soft Inc
+fake.jobTitle();    // Designer
+```
+
+### Internet
+```bash
+fake.email();       // vwvsqu@gmail.com
+fake.username();    // user_irp593
+fake.password();    // wriocxwhpxeb
+fake.domain();      // gmail.com
+fake.avatarUrl();   // https://i.pravatar.cc/131
+fake.url();         // https://site966.com
+fake.ip();          // 9.92.10.212
+fake.mac();         // zn:pl:mt
+```
+
+### Location
+```bash
+fake.city();       // Texas
+fake.zipCode();    // 88295
+fake.phone();      // +3 63080859
+```
+
+### Utilities
+```bash
+fake.uuid();               // fe4e9431-4fe1-47d1-a16c-8b58ce10bf4e
+fake.boolean();            // true
+fake.currency();           // USD
+fake.numberBetween(1, 4);  // 3
+fake.color();              // #823109
+fake.lorem();              // Lorem ipsum dolor sit amet
+
+```
+
+
+
+## 🎯 Project Goals
+
+🪶 Lightweight and fast
+
+📦 No unnecessary dependencies
+
+🌍 Multi-language support
+
+🧪 Ideal for tests and mocks
+
+💡 Simple and predictable API
+
+
+
+## Contributions are welcome 🙌
+Feel free to open issues or pull requests for:
+
+- New locales
+
+- New generators
+
+- Performance improvements
+
+- Bug fixes
+
+
+### 📄 License
+
+MIT © 2025

package/dist/core/random.d.ts

@@ -0,0 +1,4 @@
+export declare function pick<T>(items: readonly T[]): T;
+export declare function number(min?: number, max?: number): number;
+export declare function bool(): boolean;
+export declare function alpha(length?: number): string;

package/dist/core/random.js

@@ -0,0 +1,13 @@
+export function pick(items) {
+    return items[Math.floor(Math.random() * items.length)];
+}
+export function number(min = 0, max = 9999) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+export function bool() {
+    return Math.random() < 0.5;
+}
+export function alpha(length = 8) {
+    const chars = "abcdefghijklmnopqrstuvwxyz";
+    return Array.from({ length }, () => pick(chars.split(""))).join("");
+}

package/dist/fields/internet.d.ts

@@ -0,0 +1,11 @@
+export declare const internet: {
+    email: (l: any) => string;
+    username: () => string;
+    password: () => string;
+    domain: (l: any) => unknown;
+    url: () => string;
+    ip: () => string;
+    color: () => string;
+    avatarUrl: () => string;
+    mac: () => string;
+};

package/dist/fields/internet.js

@@ -0,0 +1,12 @@
+import { pick, number, alpha } from "../core/random.js";
+export const internet = {
+    email: (l) => `${alpha(6)}@${pick(l.domains)}`,
+    username: () => `user_${alpha(3)}${number(1, 999)}`,
+    password: () => alpha(12),
+    domain: (l) => pick(l.domains),
+    url: () => `https://site${number(1, 999)}.com`,
+    ip: () => `${number(1, 255)}.${number(1, 255)}.${number(1, 255)}.${number(1, 255)}`,
+    color: () => `#${number(100000, 999999)}`,
+    avatarUrl: () => `https://i.pravatar.cc/${number(100, 300)}`,
+    mac: () => `${alpha(2)}:${alpha(2)}:${alpha(2)}`
+};

package/dist/fields/misc.d.ts

@@ -0,0 +1,11 @@
+export declare const misc: {
+    city: (l: any) => unknown;
+    phone: () => string;
+    zipCode: () => string;
+    uuid: () => string;
+    boolean: () => boolean;
+    currency: () => string;
+    percentage: () => number;
+    numberBetween: (minNum: number, maxNum: number) => number;
+    lorem: () => string;
+};

package/dist/fields/misc.js

@@ -0,0 +1,12 @@
+import { pick, number } from "../core/random.js";
+export const misc = {
+    city: (l) => pick(l.cities),
+    phone: () => `+${number(1, 99)} ${number(60000000, 79999999)}`,
+    zipCode: () => number(10000, 99999).toString(),
+    uuid: () => crypto.randomUUID(),
+    boolean: () => Math.random() < 0.5,
+    currency: () => pick(["USD", "EUR", "BOB"]),
+    percentage: () => number(0, 100),
+    numberBetween: (minNum, maxNum) => number(minNum = 1, maxNum),
+    lorem: () => "Lorem ipsum dolor sit amet"
+};

package/dist/fields/person.d.ts

@@ -0,0 +1,7 @@
+import type { LocaleData } from "../types/locale";
+export declare const person: {
+    firstName: (l: LocaleData) => string;
+    lastName: (l: LocaleData) => string;
+    company: (l: LocaleData) => string;
+    jobTitle: () => string;
+};

package/dist/fields/person.js

@@ -0,0 +1,7 @@
+import { pick } from "../core/random.js";
+export const person = {
+    firstName: (l) => pick(l.firstNames),
+    lastName: (l) => pick(l.lastNames),
+    company: (l) => pick(l.companies),
+    jobTitle: () => pick(["Dev", "QA", "Manager", "Designer"])
+};

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+type Locale = "EN" | "ES" | "PT" | "FR" | "DE" | "RU" | "JA" | "ZH" | "TR";
+declare function faker(initialLocale?: Locale): {
+    firstName: () => string;
+    lastName: () => string;
+    company: () => string;
+    jobTitle: () => string;
+    email: () => string;
+    username: () => string;
+    password: () => string;
+    domain: () => unknown;
+    avatarUrl: () => string;
+    url: () => string;
+    ip: () => string;
+    mac: () => string;
+    color: () => string;
+    city: () => unknown;
+    zipCode: () => string;
+    phone: () => string;
+    uuid: () => string;
+    boolean: () => boolean;
+    currency: () => string;
+    numberBetween: (minNum: number, maxNum: number) => number;
+    lorem: () => string;
+    setLocale(locale: Locale): {
+        setLocale(locale: Locale): any;
+    };
+};
+export { faker };
+export default faker;

package/dist/index.js

@@ -0,0 +1,54 @@
+import { ES } from "./locales/es.js";
+import { EN } from "./locales/en.js";
+import { PT } from "./locales/pt.js";
+import { FR } from "./locales/fr.js";
+import { DE } from "./locales/de.js";
+import { RU } from "./locales/ru.js";
+import { JA } from "./locales/ja.js";
+import { ZH } from "./locales/zh.js";
+import { TR } from "./locales/tr.js";
+import { person } from "./fields/person.js";
+import { internet } from "./fields/internet.js";
+import { misc } from "./fields/misc.js";
+const locales = {
+    EN, ES, PT, FR, DE, RU, JA, ZH, TR
+};
+function faker(initialLocale = "EN") {
+    let currentLocale = initialLocale;
+    const api = {
+        setLocale(locale) {
+            currentLocale = locale;
+            return api;
+        }
+    };
+    const withLocale = (fn) => (...args) => fn(locales[currentLocale], ...args);
+    return {
+        ...api,
+        // PERSON
+        firstName: () => person.firstName(locales[currentLocale]),
+        lastName: () => person.lastName(locales[currentLocale]),
+        company: () => person.company(locales[currentLocale]),
+        jobTitle: () => person.jobTitle(),
+        // INTERNET
+        email: () => internet.email(locales[currentLocale]),
+        username: () => internet.username(),
+        password: () => internet.password(),
+        domain: () => internet.domain(locales[currentLocale]),
+        avatarUrl: () => internet.avatarUrl(),
+        url: () => internet.url(),
+        ip: () => internet.ip(),
+        mac: () => internet.mac(),
+        color: () => internet.color(),
+        // MISC
+        city: () => misc.city(locales[currentLocale]),
+        zipCode: () => misc.zipCode(),
+        phone: () => misc.phone(),
+        uuid: () => misc.uuid(),
+        boolean: () => misc.boolean(),
+        currency: () => misc.currency(),
+        numberBetween: misc.numberBetween,
+        lorem: () => misc.lorem()
+    };
+}
+export { faker };
+export default faker;

package/dist/locales/de.d.ts

@@ -0,0 +1,7 @@
+export declare const DE: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/de.js

@@ -0,0 +1,7 @@
+export const DE = {
+    firstNames: ["Hans", "Anna", "Peter", "Laura", "Max"],
+    lastNames: ["Müller", "Schmidt", "Schneider", "Fischer"],
+    cities: ["Berlin", "Hamburg", "Munich", "Frankfurt"],
+    companies: ["Technik GmbH", "Software AG"],
+    domains: ["mail.de", "beispiel.de"]
+};

package/dist/locales/en.d.ts

@@ -0,0 +1,7 @@
+export declare const EN: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/en.js

@@ -0,0 +1,7 @@
+export const EN = {
+    firstNames: ["John", "Jane", "Mike", "Anna", "Erick"],
+    lastNames: ["Smith", "Brown", "Taylor", "Doe"],
+    cities: ["New York", "Chicago", "Miami", "Texas"],
+    companies: ["Tech LLC", "Soft Inc", "TechLand Inc"],
+    domains: ["gmail.com", "example.com"]
+};

package/dist/locales/es.d.ts

@@ -0,0 +1,7 @@
+export declare const ES: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/es.js

@@ -0,0 +1,7 @@
+export const ES = {
+    firstNames: ["Juan", "María", "Carlos", "Ana", "Luis", "Pablo", "Daniel"],
+    lastNames: ["Pérez", "Gómez", "López", "Rojas", "Rios"],
+    cities: ["La Paz", "Caracas", "Lima", "Buenos Aires", "Santiago", "Bogotá"],
+    companies: ["Tech SRL", "Soluciones SA", "Avantic", "Alteza"],
+    domains: ["correo.com", "mail.com"]
+};

package/dist/locales/fr.d.ts

@@ -0,0 +1,7 @@
+export declare const FR: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/fr.js

@@ -0,0 +1,7 @@
+export const FR = {
+    firstNames: ["Jean", "Marie", "Pierre", "Anne", "Luc"],
+    lastNames: ["Martin", "Bernard", "Dubois", "Moreau"],
+    cities: ["Paris", "Lyon", "Marseille", "Nice"],
+    companies: ["Tech SARL", "Solutions SA"],
+    domains: ["email.fr", "exemple.fr"]
+};

package/dist/locales/ja.d.ts

@@ -0,0 +1,7 @@
+export declare const JA: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/ja.js

@@ -0,0 +1,7 @@
+export const JA = {
+    firstNames: ["Haruto", "Yuki", "Sakura", "Ren", "Aoi"],
+    lastNames: ["Sato", "Suzuki", "Takahashi", "Tanaka"],
+    cities: ["Tokyo", "Osaka", "Kyoto", "Yokohama"],
+    companies: ["テック株式会社", "ソリューションズ"],
+    domains: ["example.jp", "mail.jp"]
+};

package/dist/locales/pt.d.ts

@@ -0,0 +1,7 @@
+export declare const PT: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/pt.js

@@ -0,0 +1,7 @@
+export const PT = {
+    firstNames: ["João", "Maria", "Carlos", "Ana", "Lucas"],
+    lastNames: ["Silva", "Santos", "Oliveira", "Pereira"],
+    cities: ["São Paulo", "Rio de Janeiro", "Belo Horizonte"],
+    companies: ["Tecnologia Ltda", "Soluções SA"],
+    domains: ["email.com", "exemplo.com"]
+};

package/dist/locales/ru.d.ts

@@ -0,0 +1,7 @@
+export declare const RU: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/ru.js

@@ -0,0 +1,7 @@
+export const RU = {
+    firstNames: ["Ivan", "Olga", "Dmitry", "Anna", "Sergey"],
+    lastNames: ["Ivanov", "Smirnov", "Kuznetsov", "Popov"],
+    cities: ["Moscow", "Saint Petersburg", "Kazan"],
+    companies: ["Tech OOO", "Solutions LLC"],
+    domains: ["mail.ru", "example.ru"]
+};

package/dist/locales/tr.d.ts

@@ -0,0 +1,7 @@
+export declare const TR: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/tr.js

@@ -0,0 +1,7 @@
+export const TR = {
+    firstNames: ["Ahmet", "Mehmet", "Ayşe", "Fatma", "Emre", "Elif", "Kemal", "Nihan"],
+    lastNames: ["Yılmaz", "Kaya", "Demir", "Şahin", "Çelik"],
+    cities: ["İstanbul", "Ankara", "İzmir", "Bursa", "Antalya"],
+    companies: ["Teknoloji AŞ", "Yazılım Ltd"],
+    domains: ["mail.com.tr", "ornek.com", "example.tr"]
+};

package/dist/locales/zh.d.ts

@@ -0,0 +1,7 @@
+export declare const ZH: {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+};

package/dist/locales/zh.js

@@ -0,0 +1,7 @@
+export const ZH = {
+    firstNames: ["Wei", "Fang", "Jie", "Li", "Min"],
+    lastNames: ["Wang", "Li", "Zhang", "Liu", "Chen"],
+    cities: ["Beijing", "Shanghai", "Shenzhen", "Guangzhou"],
+    companies: ["科技有限公司", "软件公司"],
+    domains: ["example.cn", "mail.cn"]
+};

package/dist/types/locale.d.ts

@@ -0,0 +1,7 @@
+export interface LocaleData {
+    firstNames: string[];
+    lastNames: string[];
+    cities: string[];
+    companies: string[];
+    domains: string[];
+}

package/dist/types/locale.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "faker-i18n",
+  "version": "0.1.0",
+  "description": "Minimal fake data generator by field (ES, EN, PT, FR, DE, RU, JA, ZH, TR)",
+  "author": "mikefox10 <mikefoxtrotboa@gmail.com>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+ "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "test": "vitest",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "faker",
+    "mock",
+    "fake-data",
+    "testing",
+    "typescript"
+  ],
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0",
+    "@types/node": "^20.11.0"
+  }
+}