refactor(core): expose core.locale as LocaleProxy

[ST-DDT]

Alternative to #3189 and #3819

• feat: de-proxy locale access #3189
• feat: introduce resolveLocaleData utility function #3819

---

• Expose the locale data as LocaleProxy in FakerCore.
• New raw attribute to get access to the raw LocaleDefinitions (to avoid issues with locale data existence checks)

[netlify]

✅ Deploy Preview for fakerjs ready!

Name	Link
🔨 Latest commit	7d34d0d
🔍 Latest deploy log	https://app.netlify.com/projects/fakerjs/deploys/69e6a7bcccc8ec0009dd92b7
😎 Deploy Preview	https://deploy-preview-3820.fakerjs.dev
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[ST-DDT]

I marked this as P2, because it needs to be decided on prior to the next release.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.84%. Comparing base (c53c1fe) to head (7d34d0d).
⚠️ Report is 4 commits behind head on next.

Additional details and impacted files

@@            Coverage Diff             @@
##             next    #3820      +/-   ##
==========================================
- Coverage   98.90%   98.84%   -0.07%     
==========================================
  Files         897      898       +1     
  Lines        3103     3113      +10     
  Branches      556      559       +3     
==========================================
+ Hits         3069     3077       +8     
- Misses         30       32       +2     
  Partials        4        4              

Files with missing lines	Coverage Δ
src/core.ts	100.00% <100.00%> (ø)
src/faker.ts	100.00% <100.00%> (ø)
src/internal/locale-proxy.ts	100.00% <100.00%> (ø)
src/modules/helpers/eval.ts	95.65% <100.00%> (ø)
src/modules/person/index.ts	94.02% <100.00%> (ø)

... and 3 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[ST-DDT]

Benefits of this over #3189:

• No duplidated keys
• Implicit locale data checks

Benefits of #3189 over this:

• Does not use Proxy
• Slightly less RAM usage

[Copilot]

Pull request overview

This PR refactors locale handling so FakerCore exposes locale data as a LocaleProxy, and adds a raw escape hatch to access underlying LocaleDefinition data without proxy behavior.

Changes:

• Change FakerCore.locale to be a LocaleProxy and wrap locales via createLocaleProxy() in createFakerCore().
• Add raw (and an internal tag) to LocaleProxy, and allow createLocaleProxy() to accept an existing LocaleProxy.
• Update modules/tests to use definitions.raw where non-throwing access to locale definitions is needed.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
test/internal/locale-proxy.spec.ts	Adds a test for passing a LocaleProxy into createLocaleProxy().
src/modules/person/index.ts	Switches last-name pattern lookup to use raw definitions.
src/modules/helpers/eval.ts	Updates fakeEval default entrypoints to use raw definitions.
src/internal/locale-proxy.ts	Extends LocaleProxy with raw + tag and updates proxy creation logic.
src/faker.ts	Removes stored definitions field; exposes definitions/rawDefinitions via getters.
src/core.ts	Makes FakerCore.locale a LocaleProxy and ensures core construction proxies locales.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.