feat: 🔥 add i18n firstname locale

[pumano]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/ngneat/falso/blob/master/CONTRIBUTING.md#commit
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

[ ] Bugfix
[X] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Build related changes
[ ] CI related changes
[ ] Documentation content changes
[ ] Other... Please describe:

What is the current behavior?

Issue Number: N/A

What is the new behavior?

add support for i18n 'ru' locale for first name

Does this PR introduce a breaking change?

[ ] Yes
[X] No

Other information

[NetanelBasal]

We have discussed this approach in #212. The issue is that we don't have a single source of truth. It'll be better to find a way to use the same functions with different data.

[pumano]

@NetanelBasal single source of truth is really best idea here. But a little problems can be here.

In current case firstname generating with or without accents randomly, while russian locale names (and many others) don't have accents, in that case I need to manually set withAccents: false every time by default. I suggest to broke that default random scenario and generate as "without accents" by default, while, in specific cases when someone needed that extravagant names, they set it to withAccents: true manually.

Also I suggest to:

add locale into core:

export interface LocaleData {
  data: any | string[];
}
export interface FakeOptions {
  length?: number;
  locale?: LocaleData;
}

because it's needed for all rand functions, and when someone want to support locale, just extend from FakeOptions (mostly rand functions extend FakeOptions)

If it's OK, I can provide changes today

[NetanelBasal]

Can you please show an example of the usage?

[pumano]

As you mentioned in #212

import { randBird } from '@ngneat/falso';
import ruBird from '@ngneat/falso/i18n/ru/bird';

randBird({ locale: ruBird })

but for randFirstName

[NetanelBasal]

Ok, let's give it a shot.