Merge branch 'next' into word-any

src/locales/ar/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'كَانُون ٱلثَّانِي',

src/locales/ar/date/weekday.ts

@@ -1,6 +1,5 @@
 import type { DateEntryDefinition } from '../../../definitions';
 
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'الأحَد',

src/locales/az/date/month.ts

@@ -1,4 +1,3 @@
-// source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/ru.xml#L1734
 export default {
   wide: [
     'yanvar',

src/locales/az/date/weekday.ts

@@ -1,4 +1,3 @@
-// source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/ru.xml#L1825
 export default {
   wide: [
     'Bazar',

src/locales/cz/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Leden',

src/locales/cz/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: ['Pondělí', 'Úterý', 'Středa', 'čtvrtek', 'Pátek', 'Sobota', 'Neděle'],
   // Property "wide_context" is optional, if not set then "wide" will be used instead

src/locales/de/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Januar',

src/locales/de/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'Sonntag',

src/locales/en/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'January',

src/locales/en/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'Sunday',

src/locales/es/date/month.ts

@@ -1,4 +1,4 @@
-// Sources: https://www.unicode.org/cldr/cldr-aux/charts/28/summary/es.html and https://www.wikilengua.org/index.php/Abreviaciones_en_fechas
+// Sources: https://www.wikilengua.org/index.php/Abreviaciones_en_fechas
 export default {
   wide: [
     'enero',

src/locales/es/date/weekday.ts

@@ -1,4 +1,4 @@
-// Sources: https://www.unicode.org/cldr/cldr-aux/charts/28/summary/es.html and https://www.wikilengua.org/index.php/Abreviaciones_en_fechas
+// Sources: https://www.wikilengua.org/index.php/Abreviaciones_en_fechas
 export default {
   wide: [
     'domingo',

src/locales/fa/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: ['شنبه', 'یکشنبه', 'دوشنبه', 'سه شنبه', 'چهارشنبه', 'پتچشنبه', 'جمعه'],
   wide_context: [

src/locales/fr/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Janvier',

src/locales/fr/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'Dimanche',

src/locales/fr_CH/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Janvier',

src/locales/fr_CH/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'Dimanche',

src/locales/he/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'ינואר',

src/locales/he/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'יום ראשון',

src/locales/hr/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'siječanj',

src/locales/hr/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'nedjelja',

src/locales/mk/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'јануари',

src/locales/mk/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'недела',

src/locales/nl/date/month.ts

@@ -1,4 +1,3 @@
-// source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'januari',

src/locales/nl/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'zondag',

src/locales/pt_BR/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Janeiro',

src/locales/pt_BR/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: ['Domingo', 'Segunda', 'Terça', 'Quarta', 'Quinta', 'Sexta', 'Sábado'],
   // Property "wide_context" is optional, if not set then "wide" will be used instead

src/locales/pt_PT/date/month.ts

@@ -1,4 +1,3 @@
-// Source: https://unicode.org/cldr/trac/browser/trunk/common/main/pt.xml?rev=14409#L1811
 export default {
   wide: [
     'Janeiro',

src/locales/pt_PT/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: https://unicode.org/cldr/trac/browser/trunk/common/main/pt_PT.xml?rev=14409#L491
 export default {
   wide: ['Segunda', 'Terça', 'Quarta', 'Quinta', 'Sexta', 'Sábado', 'Domingo'],
   abbr: ['Seg', 'Ter', 'Qua', 'Qui', 'Sex', 'Sáb', 'Dom'],

src/locales/ru/date/month.ts

@@ -1,4 +1,3 @@
-// source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/ru.xml#L1734
 export default {
   wide: [
     'январь',

src/locales/ru/date/weekday.ts

@@ -1,4 +1,3 @@
-// source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/ru.xml#L1825
 export default {
   wide: [
     'Воскресенье',

src/locales/sv/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'januari',

src/locales/sv/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: ['söndag', 'måndag', 'tisdag', 'onsdag', 'torsdag', 'fredag', 'lördag'],
   abbr: ['sön', 'mån', 'tis', 'ons', 'tor', 'fre', 'lör'],

src/locales/vi/date/month.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1799
 export default {
   wide: [
     'Tháng Giêng',

src/locales/vi/date/weekday.ts

@@ -1,4 +1,3 @@
-// Source: http://unicode.org/cldr/trac/browser/tags/release-27/common/main/en.xml#L1847
 export default {
   wide: [
     'Chủ nhật',

src/modules/date/index.ts

@@ -47,10 +47,14 @@ export class DateModule {
    * @since 2.0.1
    */
   past(years?: number, refDate?: string | Date | number): Date {
+    if (years <= 0) {
+      throw new FakerError('Years must be greater than 0.');
+    }
+
     const date = toDate(refDate);
     const range = {
       min: 1000,
-      max: (years || 1) * 365 * 24 * 3600 * 1000,
+      max: (years ?? 1) * 365 * 24 * 3600 * 1000,
     };
 
     let past = date.getTime();
@@ -76,10 +80,14 @@ export class DateModule {
    * @since 2.0.1
    */
   future(years?: number, refDate?: string | Date | number): Date {
+    if (years <= 0) {
+      throw new FakerError('Years must be greater than 0.');
+    }
+
     const date = toDate(refDate);
     const range = {
       min: 1000,
-      max: (years || 1) * 365 * 24 * 3600 * 1000,
+      max: (years ?? 1) * 365 * 24 * 3600 * 1000,
     };
 
     let future = date.getTime();
@@ -157,10 +165,14 @@ export class DateModule {
    * @since 2.0.1
    */
   recent(days?: number, refDate?: string | Date | number): Date {
+    if (days <= 0) {
+      throw new FakerError('Days must be greater than 0.');
+    }
+
     const date = toDate(refDate);
     const range = {
       min: 1000,
-      max: (days || 1) * 24 * 3600 * 1000,
+      max: (days ?? 1) * 24 * 3600 * 1000,
     };
 
     let future = date.getTime();
@@ -186,10 +198,14 @@ export class DateModule {
    * @since 5.0.0
    */
   soon(days?: number, refDate?: string | Date | number): Date {
+    if (days <= 0) {
+      throw new FakerError('Days must be greater than 0.');
+    }
+
     const date = toDate(refDate);
     const range = {
       min: 1000,
-      max: (days || 1) * 24 * 3600 * 1000,
+      max: (days ?? 1) * 24 * 3600 * 1000,
     };
 
     let future = date.getTime();

src/modules/git/index.ts

@@ -75,7 +75,7 @@ export class GitModule {
     } = {}
   ): string {
     const {
-      merge = this.faker.datatype.number({ min: 0, max: 4 }) === 0,
+      merge = this.faker.datatype.boolean({ probability: 0.2 }),
       eol = 'CRLF',
       refDate,
     } = options;

test/date.spec.ts

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, it } from 'vitest';
-import { faker } from '../src';
+import { faker, FakerError } from '../src';
 import { seededTests } from './support/seededRuns';
 
 const converterMap = [
@@ -130,11 +130,11 @@ describe('date', () => {
           expect(date).greaterThanOrEqual(yearsAgo);
         });
 
-        it('should return a past date when years 0', () => {
+        it('should throw an error when years = 0', () => {
           const refDate = new Date();
-          const date = faker.date.past(0, refDate.toISOString());
-
-          expect(date).lessThan(refDate);
+          expect(() => faker.date.past(0, refDate.toISOString())).toThrow(
+            new FakerError('Years must be greater than 0.')
+          );
         });
 
         it.each(converterMap)(
@@ -158,11 +158,11 @@ describe('date', () => {
           expect(date).greaterThan(new Date());
         });
 
-        it('should return a future date when years 0', () => {
+        it('should throw an error when years = 0', () => {
           const refDate = new Date();
-          const date = faker.date.future(0, refDate.toISOString());
-
-          expect(date).greaterThan(refDate); // date should be after the date given
+          expect(() => faker.date.future(0, refDate.toISOString())).toThrow(
+            new FakerError('Years must be greater than 0.')
+          );
         });
 
         it.each(converterMap)(
@@ -218,6 +218,13 @@ describe('date', () => {
           expect(date).lessThanOrEqual(new Date());
         });
 
+        it('should throw an error when days = 0', () => {
+          const refDate = new Date();
+          expect(() => faker.date.recent(0, refDate.toISOString())).toThrow(
+            new FakerError('Days must be greater than 0.')
+          );
+        });
+
         it.each(converterMap)(
           'should return a date N days from the recent past, starting from refDate',
           (converter) => {
@@ -249,6 +256,13 @@ describe('date', () => {
           expect(date).greaterThanOrEqual(new Date());
         });
 
+        it('should throw an error when days = 0', () => {
+          const refDate = new Date();
+          expect(() => faker.date.soon(0, refDate.toISOString())).toThrow(
+            new FakerError('Days must be greater than 0.')
+          );
+        });
+
         it.each(converterMap)(
           'should return a date N days from the recent future, starting from refDate',
           (converter) => {

test/scripts/apidoc/.gitignore

@@ -1,2 +1 @@
-*.actuals.json
 temp/