feat(types): provide strong typing for locales

src/address.ts

@@ -235,6 +235,7 @@ export class Address {
    */
   secondaryAddress(): string {
     return this.Helpers.replaceSymbolWithNumber(
+      // TODO ST-DDT 2022-01-30: this.faker.definitions.address.secondary_address
       this.faker.random.arrayElement(['Apt. ###', 'Suite ###'])
     );
   }

src/definitions/address.ts

@@ -0,0 +1,114 @@
+import type { Format, Formats, Texts } from './utils';
+import { allOf } from './utils';
+
+/**
+ * The possible definitions related to addresses.
+ */
+export interface AddressDefinitions {
+  /**
+   * Postcodes patterns by state
+   */
+  // TODO ST-DDT 2022-01-31: address.zipCodeByState() expects only { [state: string]: Range }
+  postcode_by_state: Formats | { [state: string]: Range };
+  /**
+   * Postcodes patterns
+   */
+  postcode: Format | Formats;
+
+  /**
+   * Names of actual cities
+   */
+  city_name?: Texts;
+  /**
+   * Common city prefixes
+   */
+  city_prefix: Texts;
+  /**
+   * Common city suffixes
+   */
+  city_suffix: Texts;
+
+  /**
+   * The names of all countries
+   */
+  country: Texts;
+  /**
+   * The names of this country's states
+   */
+  state: Texts;
+  /**
+   * The abbreviated names of this country's states
+   */
+  state_abbr: Texts;
+  /**
+   * The names of counties inside the country or state
+   */
+  county: Texts;
+
+  /**
+   * The names of the compass directions.
+   * First the 4 cardinal directions, then the 4 ordinal directions
+   */
+  direction: Texts;
+  /**
+   * The abbreviated names of the compass directions.
+   * First the 4 cardinal directions, then the 4 ordinal directions
+   */
+  direction_abbr: Texts;
+
+  /**
+   * Common street prefixes
+   */
+  street_prefix: Texts;
+  /**
+   * Common street suffixes
+   */
+  street_suffix: Texts;
+
+  /**
+   * The address "inside" an address/e.g. an apartment or office.
+   */
+  secondary_address: Texts;
+
+  /**
+   * The ISO-3166-1 ALPHA-2 country codes
+   */
+  country_code: Texts;
+  /**
+   * The ISO-3166-1 ALPHA-3 country codes
+   */
+  country_code_alpha_3: Texts;
+
+  // A list of timezones names.
+  time_zone: Texts;
+}
+
+/**
+ * Internal: A list of all keys for the AddressDefinitions.
+ */
+export const address = allOf<keyof AddressDefinitions>()(
+  'postcode_by_state',
+  'postcode',
+
+  'city_name',
+  'city_prefix',
+  'city_suffix',
+
+  'country',
+  'state',
+  'state_abbr',
+  'county',
+
+  'direction_abbr',
+  'direction',
+
+  'street_prefix',
+  'street_suffix',
+
+  'secondary_address',
+
+  'country_code',
+  'country_code_alpha_3',
+
+  'time_zone'
+);

src/definitions/animal.ts

@@ -0,0 +1,42 @@
+import type { Texts } from './utils';
+import { allOf } from './utils';
+
+/**
+ * The possible definitions related to animals.
+ */
+export interface AnimalDefinitions {
+  bear: Texts;
+  bird: Texts;
+  cat: Texts;
+  cetacean: Texts;
+  cow: Texts;
+  crocodilia: Texts;
+  dog: Texts;
+  fish: Texts;
+  horse: Texts;
+  insect: Texts;
+  lion: Texts;
+  rabbit: Texts;
+  snake: Texts;
+  type: Texts;
+}
+
+/**
+ * Internal: A list of all keys for the AnimalDefinitions.
+ */
+export const animal = allOf<keyof AnimalDefinitions>()(
+  'dog',
+  'cat',
+  'snake',
+  'bear',
+  'lion',
+  'cetacean',
+  'insect',
+  'crocodilia',
+  'cow',
+  'bird',
+  'fish',
+  'rabbit',
+  'horse',
+  'type'
+);

src/definitions/commerce.ts

@@ -0,0 +1,52 @@
+import type { Texts } from '.';
+import { allOf } from './utils';
+
+/**
+ * The possible definitions related to commerce.
+ */
+export interface CommerceDefinitions {
+  /**
+   * Human readable color names
+   */
+  color: Texts;
+  /**
+   * Department names inside a shop.
+   */
+  department: Texts;
+  /**
+   * Product name generation definitions.
+   */
+  product_name: CommerceProductNameDefinitions;
+  /**
+   * Descriptions for products.
+   */
+  product_description: Texts;
+}
+
+/**
+ * The possible definitions related to product name generation.
+ */
+export interface CommerceProductNameDefinitions {
+  /**
+   * Adjectives describing a product (e.g. tasty).
+   */
+  adjective: Texts;
+  /**
+   * Materials describing a product (e.g. wood).
+   */
+  material: Texts;
+  /**
+   * Types of products (e.g. chair).
+   */
+  product: Texts;
+}
+
+/**
+ * Internal: A list of all keys for the CommerceDefinitions.
+ */
+export const commerce = allOf<keyof CommerceDefinitions>()(
+  'color',
+  'department',
+  'product_name',
+  'product_description'
+);

src/definitions/company.ts

@@ -0,0 +1,33 @@
+import type { Texts } from '.';
+import { allOf } from './utils';
+
+/**
+ * The possible definitions related to companies.
+ */
+export interface CompanyDefinitions {
+  // Business/products related words
+  bs_adjective: Texts;
+  bs_noun;
+  bs_verb;
+  // Catch phrases
+  adjective: Texts;
+  descriptor: Texts;
+  noun: Texts;
+  // Company suffixes
+  suffix: Texts;
+}
+
+/**
+ * Internal: A list of all keys for the CompanyDefinitions.
+ */
+export const company = allOf<keyof CompanyDefinitions>()(
+  'bs_adjective',
+  'bs_noun',
+  'bs_verb',
+
+  'adjective',
+  'descriptor',
+  'noun',
+
+  'suffix'
+);