Merge branch 'next' into extend-locale-location

.eslintrc.cjs

@@ -95,6 +95,16 @@ module.exports = defineConfig({
       { blankLine: 'always', prev: 'block-like', next: '*' },
     ],
     '@typescript-eslint/prefer-regexp-exec': 'error',
+    '@typescript-eslint/restrict-plus-operands': [
+      'error',
+      {
+        allowAny: false,
+        allowBoolean: false,
+        allowNullish: false,
+        allowNumberAndString: true,
+        allowRegExp: false,
+      },
+    ],
     '@typescript-eslint/restrict-template-expressions': [
       'error',
       { allowNumber: true, allowBoolean: true },

.github/renovate.json5

@@ -55,12 +55,7 @@
     },
     {
       "groupName": "doc-dependencies",
-      "matchPackageNames": [
-        "@algolia/client-search",
-        "typedoc",
-        "typedoc-plugin-missing-exports",
-        "vitepress"
-      ]
+      "matchPackageNames": ["@algolia/client-search", "ts-morph", "vitepress"]
     }
   ],
   "vulnerabilityAlerts": {

.github/workflows/ci.yml

@@ -210,7 +210,7 @@ jobs:
         run: pnpm vitest run --coverage
 
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@54bcd8715eee62d40e33596ef5e8f0f48dbbccab # v4.1.0
+        uses: codecov/codecov-action@c16abc29c95fcf9174b58eb7e1abf4c866893bc8 # v4.1.1
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true

.prettierignore

@@ -1,7 +1,7 @@
 .pnpm-store/
 coverage/
 dist/
-test/scripts/apidoc/temp/
+test/scripts/apidocs/temp/
 CHANGELOG.md
 CHANGELOG_old.md
 pnpm-lock.yaml

docs/.vitepress/components/api-docs/method-parameters.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
-import type { MethodParameter } from './method';
+import type { ApiDocsMethodParameter } from './method';
 
-const props = defineProps<{ parameters: MethodParameter[] }>();
+const props = defineProps<{ parameters: ApiDocsMethodParameter[] }>();
 </script>
 
 <template>

docs/.vitepress/components/api-docs/method.ts

@@ -1,19 +1,19 @@
-export interface Method {
+export interface ApiDocsMethod {
   readonly name: string;
+  readonly deprecated: string | undefined; // HTML
   readonly description: string; // HTML
-  readonly parameters: MethodParameter[];
+  readonly since: string;
+  readonly parameters: ApiDocsMethodParameter[];
   readonly returns: string;
+  readonly throws: string | undefined; // HTML
   readonly examples: string; // HTML
-  readonly deprecated?: string; // HTML
-  readonly since: string;
-  readonly sourcePath: string; // URL-Suffix
   readonly seeAlsos: string[];
-  readonly throws?: string; // HTML
+  readonly sourcePath: string; // URL-Suffix
 }
 
-export interface MethodParameter {
+export interface ApiDocsMethodParameter {
   readonly name: string;
-  readonly type?: string;
-  readonly default?: string;
+  readonly type: string | undefined;
+  readonly default: string | undefined;
   readonly description: string; // HTML
 }

docs/.vitepress/components/api-docs/method.vue

@@ -1,10 +1,10 @@
 <script setup lang="ts">
-import type { Method } from './method';
+import type { ApiDocsMethod } from './method';
 import MethodParameters from './method-parameters.vue';
 import { slugify } from '../../shared/utils/slugify';
 import { sourceBaseUrl } from '../../../api/source-base-url';
 
-const props = defineProps<{ method: Method }>();
+const props = defineProps<{ method: ApiDocsMethod }>();
 
 function seeAlsoToUrl(see: string): string {
   const [, module, method] = see.replace(/\(.*/, '').split('\.');

docs/guide/upgrading_v9/2756.md

@@ -0,0 +1,6 @@
+### Changed default mode from birthdate
+
+Previously, the method had defaults that were unclear in their specific impact.
+Now, the method requires either none or all of the `min`, `max` and `mode` options.
+
+We also improved the error messages in case of invalid min/max age/year ranges.

package.json

@@ -65,13 +65,12 @@
     "build:types": "tsc --project tsconfig.build.json",
     "build": "run-s build:clean build:code build:types",
     "generate": "run-s generate:locales generate:api-docs",
-    "generate:api-docs": "tsx ./scripts/apidoc.ts",
+    "generate:api-docs": "tsx ./scripts/apidocs.ts",
     "generate:locales": "tsx ./scripts/generate-locales.ts",
-    "docs:build": "run-s docs:prepare docs:build:run",
+    "docs:build": "run-s generate:api-docs docs:build:run",
     "docs:build:run": "vitepress build docs",
     "docs:build:ci": "run-s build docs:build",
-    "docs:prepare": "run-s generate:api-docs",
-    "docs:dev": "run-s docs:prepare docs:dev:run",
+    "docs:dev": "run-s generate:api-docs docs:dev:run",
     "docs:dev:run": "vitepress dev docs",
     "docs:serve": "vitepress serve docs --port 5173",
     "docs:diff": "tsx ./scripts/diff.ts",
@@ -91,19 +90,19 @@
   },
   "devDependencies": {
     "@actions/github": "6.0.0",
-    "@algolia/client-search": "4.22.1",
+    "@algolia/client-search": "4.23.2",
     "@eslint-types/deprecation": "2.0.0-1",
-    "@eslint-types/jsdoc": "48.2.0",
+    "@eslint-types/jsdoc": "48.2.1",
     "@eslint-types/prettier": "5.1.3",
-    "@eslint-types/typescript-eslint": "7.0.2",
+    "@eslint-types/typescript-eslint": "7.2.0",
     "@eslint-types/unicorn": "51.0.1",
     "@types/markdown-it": "13.0.7",
-    "@types/node": "20.11.30",
+    "@types/node": "20.12.2",
     "@types/sanitize-html": "2.11.0",
     "@types/semver": "7.5.8",
     "@types/validator": "13.11.9",
-    "@typescript-eslint/eslint-plugin": "7.2.0",
-    "@typescript-eslint/parser": "7.2.0",
+    "@typescript-eslint/eslint-plugin": "7.4.0",
+    "@typescript-eslint/parser": "7.4.0",
     "@vitest/coverage-v8": "1.4.0",
     "@vitest/ui": "1.4.0",
     "@vueuse/core": "10.9.0",
@@ -114,24 +113,24 @@
     "eslint-define-config": "2.1.0",
     "eslint-gitignore": "0.1.0",
     "eslint-plugin-deprecation": "2.0.0",
-    "eslint-plugin-jsdoc": "48.2.1",
+    "eslint-plugin-jsdoc": "48.2.2",
     "eslint-plugin-prettier": "5.1.3",
     "eslint-plugin-unicorn": "51.0.1",
-    "eslint-plugin-vitest": "0.3.26",
-    "glob": "10.3.10",
+    "eslint-plugin-vitest": "0.4.1",
+    "glob": "10.3.12",
     "npm-run-all2": "6.1.2",
     "prettier": "3.2.5",
     "prettier-plugin-organize-imports": "3.2.4",
     "rimraf": "5.0.5",
     "sanitize-html": "2.13.0",
     "semver": "7.6.0",
     "standard-version": "9.5.0",
+    "ts-morph": "22.0.0",
     "tsup": "8.0.2",
     "tsx": "4.7.1",
-    "typedoc": "0.25.12",
     "typescript": "5.4.3",
     "validator": "13.11.0",
-    "vite": "5.2.6",
+    "vite": "5.2.7",
     "vitepress": "1.0.1",
     "vitest": "1.4.0",
     "vue": "3.4.21"