Person & Identity Data

/**
 * Generate a random first name
 * @param sex - Optional gender specification
 * @returns Random first name
 */
firstName(sex?: SexType): string;

/**
 * Generate a random last name
 * @param sex - Optional gender specification for gendered surnames
 * @returns Random last name
 */
lastName(sex?: SexType): string;

/**
 * Generate a random middle name
 * @param sex - Optional gender specification
 * @returns Random middle name
 */
middleName(sex?: SexType): string;

/**
 * Generate a complete full name
 * @param options - Configuration options
 * @returns Full name string
 */
fullName(options?: {
  firstName?: string;
  lastName?: string;
  sex?: SexType;
}): string;

/**
 * Generate a name prefix/title
 * @param sex - Optional gender specification
 * @returns Name prefix (Mr., Mrs., Dr., etc.)
 */
prefix(sex?: SexType): string;

/**
 * Generate a name suffix
 * @returns Name suffix (Jr., Sr., PhD, etc.)
 */
suffix(): string;

import { faker } from "@faker-js/faker";

// Basic name generation
const firstName = faker.person.firstName();
const lastName = faker.person.lastName();

// Gender-specific names
const femaleName = faker.person.firstName('female');
const maleName = faker.person.firstName('male');

// Complete names with options
const fullName = faker.person.fullName({
  firstName: 'Jane',
  sex: 'female'
});

// Formal names with prefix and suffix
const formalName = `${faker.person.prefix('male')} ${faker.person.firstName('male')} ${faker.person.lastName('male')} ${faker.person.suffix()}`;

/**
 * Generate a gender identity
 * @returns Gender identity string
 */
gender(): string;

/**
 * Generate a binary sex value (localized)
 * @returns Localized sex string
 */
sex(): string;

/**
 * Generate a sex type enum value
 * @returns Sex enum value
 */
sexType(): SexType;

/**
 * Generate a zodiac sign
 * @returns Zodiac sign name
 */
zodiacSign(): string;

/**
 * Generate a realistic job title
 * @returns Job title string
 */
jobTitle(): string;

/**
 * Generate a job descriptor (adjective describing the job)
 * @returns Job descriptor word
 */
jobDescriptor(): string;

/**
 * Generate a job area/department
 * @returns Job area name
 */
jobArea(): string;

/**
 * Generate a job type/category
 * @returns Job type description
 */
jobType(): string;

import { faker } from "@faker-js/faker";

// Generate complete professional profile
const professionalProfile = {
  name: faker.person.fullName(),
  jobTitle: faker.person.jobTitle(),
  jobArea: faker.person.jobArea(),
  jobType: faker.person.jobType(),
  descriptor: faker.person.jobDescriptor()
};

// Example output:
// {
//   name: "Sarah Johnson",
//   jobTitle: "Senior Software Engineer",
//   jobArea: "Technology",
//   jobType: "Developer",
//   descriptor: "Lead"
// }

/**
 * Generate a short biographical description
 * @returns Biography text
 */
bio(): string;

import { faker } from "@faker-js/faker";

// Generate complete person profile
const personProfile = {
  firstName: faker.person.firstName(),
  lastName: faker.person.lastName(),
  gender: faker.person.gender(),
  zodiacSign: faker.person.zodiacSign(),
  jobTitle: faker.person.jobTitle(),
  bio: faker.person.bio()
};

// Example output:
// {
//   firstName: "Michael",
//   lastName: "Brown",
//   gender: "Male",
//   zodiacSign: "Leo",
//   jobTitle: "Product Manager", 
//   bio: "Passionate about creating innovative solutions that make a difference in people's lives."
// }

type SexType = 'female' | 'male';

enum Sex {
  Female = 'female',
  Male = 'male'
}