From 7e950787e49ddd079b3603a62a8c4d1e035dab44 Mon Sep 17 00:00:00 2001
From: John Betancur <1385932+jbetancur@users.noreply.github.com>
Date: Wed, 20 May 2026 19:58:47 -0400
Subject: [PATCH 1/3] feat: add localization support for pagination, filtering,
 and expandable rows (#1322)

- Introduced a new Localization type to manage user-visible strings for pagination, filtering, and expandable rows.
- Updated TableCol, TablePaginationFooter, TableRow, HeadContext, and RowContext components to accept localization props.
- Added localization support in various locales including Arabic, German, English, Spanish, French, Hebrew, Japanese, Korean, Portuguese, Ukrainian, and Chinese.
- Created a new locales index file to export all localization files.
- Updated types to include localization options in relevant components and hooks.
- Enhanced the build configuration to include a locales bundle.
- Adjusted test coverage settings to exclude locale files.
---
 apps/docs/src/layouts/DocsLayout.astro      |   1 +
 apps/docs/src/pages/docs/expandable.astro   |  37 ++
 apps/docs/src/pages/docs/filtering.astro    |  40 ++
 apps/docs/src/pages/docs/localization.astro | 176 ++++++++
 apps/docs/src/pages/docs/pagination.astro   |  46 +-
 apps/docs/src/pages/docs/rtl.astro          |  30 ++
 apps/docs/tsconfig.json                     |   3 +-
 package-lock.json                           | 475 ++++++++++----------
 package.json                                |  13 +-
 src/__tests__/ColumnFilter.test.tsx         | 123 +++++
 src/__tests__/Pagination.test.tsx           |  80 ++++
 src/components/ColumnFilter.tsx             |  77 ++--
 src/components/DataTable.tsx                |   5 +
 src/components/DataTableHead.tsx            |   2 +
 src/components/ExpanderButton.tsx           |  12 +-
 src/components/Pagination.tsx               |  14 +-
 src/components/TableCellExpander.tsx        |   7 +-
 src/components/TableCol.tsx                 |   8 +-
 src/components/TablePaginationFooter.tsx    |   5 +-
 src/components/TableRow.tsx                 |   2 +
 src/context/HeadContext.tsx                 |  11 +-
 src/context/RowContext.tsx                  |   2 +
 src/hooks/useHeadContextValue.ts            |   1 +
 src/hooks/useRowContextValue.ts             |   1 +
 src/index.ts                                |   1 +
 src/locales/ar-EG.ts                        |  52 +++
 src/locales/ar-LV.ts                        |  52 +++
 src/locales/ar.ts                           |  52 +++
 src/locales/de.ts                           |  52 +++
 src/locales/en.ts                           |  52 +++
 src/locales/es.ts                           |  52 +++
 src/locales/fr.ts                           |  52 +++
 src/locales/he.ts                           |  52 +++
 src/locales/index.ts                        |  14 +
 src/locales/ja.ts                           |  52 +++
 src/locales/ko.ts                           |  52 +++
 src/locales/pt-BR.ts                        |  52 +++
 src/locales/uk.ts                           |  52 +++
 src/locales/zh-CN.ts                        |  52 +++
 src/locales/zh-TW.ts                        |  52 +++
 src/types.ts                                |  78 ++++
 tsup.config.ts                              |  10 +
 vitest.config.ts                            |   2 +-
 43 files changed, 1715 insertions(+), 289 deletions(-)
 create mode 100644 apps/docs/src/pages/docs/localization.astro
 create mode 100644 src/locales/ar-EG.ts
 create mode 100644 src/locales/ar-LV.ts
 create mode 100644 src/locales/ar.ts
 create mode 100644 src/locales/de.ts
 create mode 100644 src/locales/en.ts
 create mode 100644 src/locales/es.ts
 create mode 100644 src/locales/fr.ts
 create mode 100644 src/locales/he.ts
 create mode 100644 src/locales/index.ts
 create mode 100644 src/locales/ja.ts
 create mode 100644 src/locales/ko.ts
 create mode 100644 src/locales/pt-BR.ts
 create mode 100644 src/locales/uk.ts
 create mode 100644 src/locales/zh-CN.ts
 create mode 100644 src/locales/zh-TW.ts

diff --git a/apps/docs/src/layouts/DocsLayout.astro b/apps/docs/src/layouts/DocsLayout.astro
index b06e1655..57e88215 100644
--- a/apps/docs/src/layouts/DocsLayout.astro
+++ b/apps/docs/src/layouts/DocsLayout.astro
@@ -59,6 +59,7 @@ const nav = [
     links: [
       { label: 'Animations', href: '/docs/animations' },
       { label: 'Accessibility', href: '/docs/accessibility' },
+      { label: 'Localization', href: '/docs/localization' },
       { label: 'RTL Support', href: '/docs/rtl' },
       { label: 'Mobile', href: '/docs/mobile' },
     ],
diff --git a/apps/docs/src/pages/docs/expandable.astro b/apps/docs/src/pages/docs/expandable.astro
index 79015e14..32e0ea35 100644
--- a/apps/docs/src/pages/docs/expandable.astro
+++ b/apps/docs/src/pages/docs/expandable.astro
@@ -250,6 +250,43 @@ export default function App() {
       <tr><td><code>expandableInheritConditionalStyles</code></td><td><code>boolean</code></td><td>Apply the parent row's <code>conditionalRowStyles</code> to the expander row</td></tr>
       <tr><td><code>onRowExpandToggled</code></td><td><code>(expanded: boolean, row: T) =&gt; void</code></td><td>Fired when a row is expanded or collapsed</td></tr>
       <tr><td><code>animateRows</code></td><td><code>boolean</code></td><td>Animate expand/collapse (respects <code>prefers-reduced-motion</code>)</td></tr>
+      <tr><td><code>localization</code></td><td><code>Localization</code></td><td>Localizable aria-labels for the expand/collapse button — see Localization below.</td></tr>
     </tbody>
   </table>
+
+  <h2>Localization</h2>
+  <p>
+    Override the aria-labels on the expand/collapse button via the <code>localization</code> prop.
+    Use a pre-built locale or supply your own — every key is optional.
+  </p>
+
+  <CodeBlock code={`// Drop-in locale
+import DataTable from 'react-data-table-component';
+import { fr } from 'react-data-table-component/locales';
+
+<DataTable
+  columns={columns}
+  data={data}
+  expandableRows
+  expandableRowsComponent={MyExpander}
+  localization={fr}
+/>`} />
+
+  <CodeBlock code={`// Custom aria-labels only
+import type { Localization } from 'react-data-table-component';
+
+const custom: Localization = {
+  expandable: {
+    expandRowAriaLabel:   'Ouvrir la ligne',
+    collapseRowAriaLabel: 'Fermer la ligne',
+  },
+};
+
+<DataTable
+  columns={columns}
+  data={data}
+  expandableRows
+  expandableRowsComponent={MyExpander}
+  localization={custom}
+/>`} />
 </DocsLayout>
diff --git a/apps/docs/src/pages/docs/filtering.astro b/apps/docs/src/pages/docs/filtering.astro
index 92601677..e2f1b664 100644
--- a/apps/docs/src/pages/docs/filtering.astro
+++ b/apps/docs/src/pages/docs/filtering.astro
@@ -205,6 +205,46 @@ isFilterActive({ condition1: { operator: 'contains' } });           // false —
 isFilterActive({ condition1: { operator: 'contains', value: 'a' } }); // true
 isFilterActive({ condition1: { operator: 'blank' } });               // true — no value needed`} />
 
+  <h2>Localization</h2>
+  <p>
+    Use the <code>localization</code> prop to swap every string in the table UI.
+    Import a pre-built locale or build your own — all keys are optional and fall
+    back to English defaults.
+  </p>
+
+  <CodeBlock code={`// Drop-in locale
+import DataTable from 'react-data-table-component';
+import { fr } from 'react-data-table-component/locales';
+
+<DataTable columns={columns} data={data} localization={fr} />`} />
+
+  <CodeBlock code={`// Custom / partial override — spread a locale and replace only what you need
+import { fr } from 'react-data-table-component/locales';
+import type { Localization } from 'react-data-table-component';
+
+const myLocale: Localization = {
+  ...fr,
+  filter: {
+    ...fr.filter,
+    applyLabel: 'Valider',   // override one key
+  },
+};
+
+<DataTable columns={columns} data={data} localization={myLocale} />`} />
+
+  <CodeBlock code={`// Built from scratch — every key is optional
+import type { Localization } from 'react-data-table-component';
+
+const custom: Localization = {
+  filter: {
+    clearLabel: 'Reset',
+    applyLabel: 'Go',
+    operators: { contains: 'has', equals: 'is' },
+  },
+};
+
+<DataTable columns={columns} data={data} localization={custom} />`} />
+
   <h2>Headless usage</h2>
   <p>
     Use <code>useColumnFilter</code> directly when building a custom table with the headless hooks.
diff --git a/apps/docs/src/pages/docs/localization.astro b/apps/docs/src/pages/docs/localization.astro
new file mode 100644
index 00000000..cfdcb1df
--- /dev/null
+++ b/apps/docs/src/pages/docs/localization.astro
@@ -0,0 +1,176 @@
+---
+import DocsLayout from '../../layouts/DocsLayout.astro';
+import CodeBlock from '../../components/CodeBlock.astro';
+---
+
+<DocsLayout title="Localization | react-data-table-component">
+  <h1>Localization</h1>
+
+  <p>
+    Pass a <code>localization</code> object to <code>DataTable</code> to override every
+    string and aria-label rendered by the table — filter panel, pagination navigation, and
+    expand/collapse buttons. All keys are optional and fall back to English defaults.
+  </p>
+
+  <h2>Quick start</h2>
+  <p>
+    Import one of the pre-built locales from the <code>/locales</code> subpath and pass it as
+    <code>localization</code>. That's all you need for a fully translated table.
+  </p>
+
+  <CodeBlock code={`import DataTable from 'react-data-table-component';
+import { fr } from 'react-data-table-component/locales';
+
+<DataTable columns={columns} data={data} localization={fr} />`} />
+
+  <h2>Built-in locales</h2>
+
+  <table>
+    <thead>
+      <tr>
+        <th>Export</th>
+        <th>Language</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr><td><code>en</code></td><td>English (default)</td></tr>
+      <tr><td><code>fr</code></td><td>French</td></tr>
+      <tr><td><code>es</code></td><td>Spanish</td></tr>
+      <tr><td><code>de</code></td><td>German</td></tr>
+      <tr><td><code>ptBR</code></td><td>Brazilian Portuguese</td></tr>
+      <tr><td><code>ar</code></td><td>Arabic (Modern Standard)</td></tr>
+      <tr><td><code>he</code></td><td>Hebrew</td></tr>
+      <tr><td><code>arEG</code></td><td>Arabic (Egyptian)</td></tr>
+      <tr><td><code>arLV</code></td><td>Arabic (Levantine)</td></tr>
+      <tr><td><code>zhCN</code></td><td>Chinese (Simplified)</td></tr>
+      <tr><td><code>zhTW</code></td><td>Chinese (Traditional)</td></tr>
+      <tr><td><code>ja</code></td><td>Japanese</td></tr>
+      <tr><td><code>ko</code></td><td>Korean</td></tr>
+      <tr><td><code>uk</code></td><td>Ukrainian</td></tr>
+    </tbody>
+  </table>
+
+  <p>
+    Each locale is a standalone module. Only the locale you import enters your bundle — the
+    rest are tree-shaken away.
+  </p>
+
+  <h2>Partial override</h2>
+  <p>
+    Spread an existing locale and replace only the keys you need.
+  </p>
+
+  <CodeBlock code={`import { fr } from 'react-data-table-component/locales';
+import type { Localization } from 'react-data-table-component';
+
+const myLocale: Localization = {
+  ...fr,
+  filter: {
+    ...fr.filter,
+    applyLabel: 'Valider',
+    clearLabel: 'Effacer',
+  },
+};
+
+<DataTable columns={columns} data={data} localization={myLocale} />`} />
+
+  <h2>Custom locale from scratch</h2>
+  <p>
+    Build a locale object from the <code>Localization</code> type. Every key is optional —
+    any omitted key falls back to the English default.
+  </p>
+
+  <CodeBlock code={`import type { Localization } from 'react-data-table-component';
+
+const custom: Localization = {
+  pagination: {
+    navigationAriaLabel:   'Paginación de la tabla',
+    firstPageAriaLabel:    'Primera página',
+    previousPageAriaLabel: 'Página anterior',
+    nextPageAriaLabel:     'Página siguiente',
+    lastPageAriaLabel:     'Última página',
+  },
+  filter: {
+    applyLabel: 'Aplicar',
+    clearLabel: 'Limpiar',
+    addConditionLabel: '+ Añadir condición',
+    andLabel: 'Y',
+    orLabel: 'O',
+    operators: {
+      contains: 'Contiene',
+      equals:   'Igual a',
+      blank:    'Vacío',
+    },
+  },
+  expandable: {
+    expandRowAriaLabel:   'Expandir fila',
+    collapseRowAriaLabel: 'Contraer fila',
+  },
+};
+
+<DataTable columns={columns} data={data} localization={custom} />`} />
+
+  <h2>The Localization type</h2>
+  <p>
+    All three sub-objects are optional. Each key within them is also optional.
+  </p>
+
+  <CodeBlock code={`interface Localization {
+  pagination?: {
+    navigationAriaLabel?:   string;  // default: 'Table pagination'
+    firstPageAriaLabel?:    string;  // default: 'First Page'
+    previousPageAriaLabel?: string;  // default: 'Previous Page'
+    nextPageAriaLabel?:     string;  // default: 'Next Page'
+    lastPageAriaLabel?:     string;  // default: 'Last Page'
+  };
+
+  filter?: {
+    filterColumnAriaLabel?:    string;  // default: 'Filter column'
+    filterActiveAriaLabel?:    string;  // default: 'Filter active'
+    filterPanelAriaLabel?:     string;  // default: 'Filter panel'
+    operatorAriaLabel?:        string;  // default: 'Filter operator'
+    valuePlaceholder?:         string;  // default: 'Value'
+    valueAriaLabel?:           string;  // default: 'Filter value'
+    value2Placeholder?:        string;  // default: 'Value'
+    value2AriaLabel?:          string;  // default: 'Second filter value'
+    betweenSeparatorText?:     string;  // default: 'and'
+    removeConditionAriaLabel?: string;  // default: 'Remove condition'
+    addConditionAriaLabel?:    string;  // default: 'Add second condition'
+    addConditionLabel?:        string;  // default: '+ Add condition'
+    clearLabel?:               string;  // default: 'Clear'
+    applyLabel?:               string;  // default: 'Apply'
+    andLabel?:                 string;  // default: 'AND'
+    orLabel?:                  string;  // default: 'OR'
+    operators?: {
+      contains?:    string;  // default: 'Contains'
+      notContains?: string;  // default: 'Does not contain'
+      equals?:      string;  // default: 'Equals'
+      notEquals?:   string;  // default: 'Does not equal'
+      startsWith?:  string;  // default: 'Begins with'
+      endsWith?:    string;  // default: 'Ends with'
+      blank?:       string;  // default: 'Blank'
+      notBlank?:    string;  // default: 'Not blank'
+      gt?:          string;  // default: 'Greater than'
+      gte?:         string;  // default: '≥'
+      lt?:          string;  // default: 'Less than'
+      lte?:         string;  // default: '≤'
+      between?:     string;  // default: 'Between'
+      before?:      string;  // default: 'Before'
+      after?:       string;  // default: 'After'
+    };
+  };
+
+  expandable?: {
+    expandRowAriaLabel?:   string;  // default: 'Expand Row'
+    collapseRowAriaLabel?: string;  // default: 'Collapse Row'
+  };
+}`} />
+
+  <h2>Scope</h2>
+  <p>
+    <code>localization</code> covers strings rendered by the table's built-in UI. Visible text
+    in the pagination bar (<code>rowsPerPageText</code>, <code>rangeSeparatorText</code>,
+    <code>selectAllRowsItemText</code>) is still controlled by
+    <code>paginationComponentOptions</code>, since those affect layout as well as text.
+  </p>
+</DocsLayout>
diff --git a/apps/docs/src/pages/docs/pagination.astro b/apps/docs/src/pages/docs/pagination.astro
index d4713bc8..b806d08a 100644
--- a/apps/docs/src/pages/docs/pagination.astro
+++ b/apps/docs/src/pages/docs/pagination.astro
@@ -572,7 +572,7 @@ function MyPagination({ rowsPerPage, rowCount, currentPage, onChangePage }: Pagi
         <td><code>paginationComponentOptions</code></td>
         <td><code>PaginationOptions</code></td>
         <td>-</td>
-        <td>Options forwarded to the default pagination component (label customisation, etc.).</td>
+        <td>Options forwarded to the default pagination component. Covers visible text (<code>rowsPerPageText</code>, <code>rangeSeparatorText</code>, <code>selectAllRowsItemText</code>). Navigation aria-labels are set via the <code>localization</code> prop.</td>
       </tr>
       <tr>
         <td><code>paginationIconFirstPage</code></td>
@@ -612,4 +612,48 @@ function MyPagination({ rowsPerPage, rowCount, currentPage, onChangePage }: Pagi
       </tr>
     </tbody>
   </table>
+
+  <h2>Localization</h2>
+  <p>
+    All navigation aria-labels on the built-in pagination bar are controlled via the
+    <code>localization</code> prop. Use a pre-built locale or supply your own — every key is
+    optional and falls back to the English default. Visible text such as
+    <code>rowsPerPageText</code> and <code>rangeSeparatorText</code> is still set via
+    <code>paginationComponentOptions</code>.
+  </p>
+
+  <CodeBlock code={`// Drop-in locale
+import DataTable from 'react-data-table-component';
+import { fr } from 'react-data-table-component/locales';
+
+<DataTable columns={columns} data={data} pagination localization={fr} />`} />
+
+  <CodeBlock code={`// Partial override — spread a locale and replace only what you need
+import { fr } from 'react-data-table-component/locales';
+import type { Localization } from 'react-data-table-component';
+
+const myLocale: Localization = {
+  ...fr,
+  pagination: {
+    ...fr.pagination,
+    nextPageAriaLabel: 'Suivant',
+  },
+};
+
+<DataTable columns={columns} data={data} pagination localization={myLocale} />`} />
+
+  <CodeBlock code={`// Built from scratch — every key is optional
+import type { Localization } from 'react-data-table-component';
+
+const custom: Localization = {
+  pagination: {
+    navigationAriaLabel:   'Table navigation',
+    firstPageAriaLabel:    'First',
+    previousPageAriaLabel: 'Prev',
+    nextPageAriaLabel:     'Next',
+    lastPageAriaLabel:     'Last',
+  },
+};
+
+<DataTable columns={columns} data={data} pagination localization={custom} />`} />
 </DocsLayout>
diff --git a/apps/docs/src/pages/docs/rtl.astro b/apps/docs/src/pages/docs/rtl.astro
index 83258e04..5a891f4b 100644
--- a/apps/docs/src/pages/docs/rtl.astro
+++ b/apps/docs/src/pages/docs/rtl.astro
@@ -84,6 +84,36 @@ import RTLDemo from '../../components/demos/RTLDemo.tsx';
     <li>Column <code>right: true</code> alignment continues to work as expected. Align numbers relative to the reading direction of the cell content, not the page.</li>
   </ul>
 
+  <h2>Pairing with localization</h2>
+  <p>
+    <code>direction</code> controls layout; <code>localization</code> controls strings. For a
+    fully translated RTL table, use both together. The library keeps them separate on purpose —
+    you may want French strings without changing layout direction, or an Arabic locale on a
+    mixed-direction page where you manage <code>dir</code> yourself.
+  </p>
+
+  <CodeBlock code={`import DataTable, { Direction } from 'react-data-table-component';
+import { ar } from 'react-data-table-component/locales';
+
+<DataTable
+  columns={columns}
+  data={data}
+  direction={Direction.RTL}
+  localization={ar}
+/>`} />
+
+  <p>
+    If your app already sets <code>&lt;html dir="rtl"&gt;</code>, use <code>Direction.AUTO</code>
+    so the table follows the page without an explicit prop:
+  </p>
+
+  <CodeBlock code={`<DataTable
+  columns={columns}
+  data={data}
+  direction={Direction.AUTO}
+  localization={ar}
+/>`} />
+
   <h2>Prop reference</h2>
 
   <table>
diff --git a/apps/docs/tsconfig.json b/apps/docs/tsconfig.json
index 7e633708..f01ba595 100644
--- a/apps/docs/tsconfig.json
+++ b/apps/docs/tsconfig.json
@@ -4,7 +4,8 @@
     "jsx": "react-jsx",
     "jsxImportSource": "react",
     "paths": {
-      "react-data-table-component": ["../../src/index.ts"]
+      "react-data-table-component": ["../../src/index.ts"],
+      "react-data-table-component/locales": ["../../src/locales/index.ts"]
     }
   }
 }
diff --git a/package-lock.json b/package-lock.json
index 2f1bb0f5..dbee524a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "react-data-table-component",
-  "version": "8.0.1",
+  "version": "8.2.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "react-data-table-component",
-      "version": "8.0.1",
+      "version": "8.2.0",
       "license": "Apache-2.0",
       "devDependencies": {
         "@testing-library/dom": "^10.4.1",
@@ -14,9 +14,9 @@
         "@testing-library/react": "^16.3.2",
         "@types/react": "^18.3.18",
         "@types/react-dom": "^18.3.5",
-        "@typescript-eslint/eslint-plugin": "^8.59.2",
-        "@typescript-eslint/parser": "^8.59.2",
-        "@vitest/coverage-v8": "^4.1.6",
+        "@typescript-eslint/eslint-plugin": "^8.59.4",
+        "@typescript-eslint/parser": "^8.59.4",
+        "@vitest/coverage-v8": "^4.1.7",
         "concurrently": "^9.2.1",
         "eslint": "^9.39.4",
         "eslint-config-prettier": "^10.1.8",
@@ -30,7 +30,7 @@
         "react-dom": "^18.3.1",
         "tsup": "^8.5.1",
         "typescript": "^6.0.3",
-        "vitest": "^4.1.6"
+        "vitest": "^4.1.7"
       },
       "peerDependencies": {
         "react": ">=18.0.0",
@@ -2195,17 +2195,17 @@
       }
     },
     "node_modules/@typescript-eslint/eslint-plugin": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.3.tgz",
-      "integrity": "sha512-PwFvSKsXGShKGW6n5bZOhGHEcCZXM8HofLK9fNsEwZXzFRjoY+XT1Vsf1zgyXdwTr0ZYz1/2tkZ0DBTT9jZjhw==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.59.4.tgz",
+      "integrity": "sha512-PegsU+XfyJJNjd4+u/k6f9yTyp0lEXXiPopUNobZcIAUJFGICFLN+sP0Rb3JehVmiij1Ph0dFGYqODoRo/2+6A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@eslint-community/regexpp": "^4.12.2",
-        "@typescript-eslint/scope-manager": "8.59.3",
-        "@typescript-eslint/type-utils": "8.59.3",
-        "@typescript-eslint/utils": "8.59.3",
-        "@typescript-eslint/visitor-keys": "8.59.3",
+        "@typescript-eslint/scope-manager": "8.59.4",
+        "@typescript-eslint/type-utils": "8.59.4",
+        "@typescript-eslint/utils": "8.59.4",
+        "@typescript-eslint/visitor-keys": "8.59.4",
         "ignore": "^7.0.5",
         "natural-compare": "^1.4.0",
         "ts-api-utils": "^2.5.0"
@@ -2218,7 +2218,7 @@
         "url": "https://opencollective.com/typescript-eslint"
       },
       "peerDependencies": {
-        "@typescript-eslint/parser": "^8.59.3",
+        "@typescript-eslint/parser": "^8.59.4",
         "eslint": "^8.57.0 || ^9.0.0 || ^10.0.0",
         "typescript": ">=4.8.4 <6.1.0"
       }
@@ -2234,16 +2234,16 @@
       }
     },
     "node_modules/@typescript-eslint/parser": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.59.3.tgz",
-      "integrity": "sha512-HPwA+hVkfcriajbNvTmZv4VRauibay+cWArYUYq7u7W7PmGShMxbPxLvrwDme55a6d5alG3nrYfhyJ/G28XlLg==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.59.4.tgz",
+      "integrity": "sha512-zORHqO/tuhxY1zWuTvMUqddRxpiFJ72xVfcNoWpqdLjs6lfPbuQBJuW4pk+49/uBMy7Ssr4bzgjiKmmDB1UbZQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/scope-manager": "8.59.3",
-        "@typescript-eslint/types": "8.59.3",
-        "@typescript-eslint/typescript-estree": "8.59.3",
-        "@typescript-eslint/visitor-keys": "8.59.3",
+        "@typescript-eslint/scope-manager": "8.59.4",
+        "@typescript-eslint/types": "8.59.4",
+        "@typescript-eslint/typescript-estree": "8.59.4",
+        "@typescript-eslint/visitor-keys": "8.59.4",
         "debug": "^4.4.3"
       },
       "engines": {
@@ -2259,14 +2259,14 @@
       }
     },
     "node_modules/@typescript-eslint/project-service": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.59.3.tgz",
-      "integrity": "sha512-ECiUWa/KYRGDFUqTNehaRgzDshnJfkTABJxVemHk4ko22gcr0ukloKjWvyQ64g8YCV/UI47kN1dbmjf/GaQYng==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.59.4.tgz",
+      "integrity": "sha512-Ly00Vu4oAacfDeHp2Zg85ioNG6l8HG+tN1D7J+xTHSxu9y0awYKJ2zH1rFBn8ZSfuGK+7FxK3Cgl3uAz0aZZLg==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/tsconfig-utils": "^8.59.3",
-        "@typescript-eslint/types": "^8.59.3",
+        "@typescript-eslint/tsconfig-utils": "^8.59.4",
+        "@typescript-eslint/types": "^8.59.4",
         "debug": "^4.4.3"
       },
       "engines": {
@@ -2281,14 +2281,14 @@
       }
     },
     "node_modules/@typescript-eslint/scope-manager": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.59.3.tgz",
-      "integrity": "sha512-t2LvZnoEfzKtnPjgeEu41xw5gxq9mQVfYy4OoZ4Vlt0sk3JwxmhCca/AR7DwOiHrjWgjAj6as4AhRLKSDfvZIA==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.59.4.tgz",
+      "integrity": "sha512-mUeR/3H1WrTAddJrwut8OoPjfauaztMQmRwV5fQTUyNVJCLiUXXe4lGEyYIL2oFDpP7UtgbGJXCt72wT0z2S3Q==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.59.3",
-        "@typescript-eslint/visitor-keys": "8.59.3"
+        "@typescript-eslint/types": "8.59.4",
+        "@typescript-eslint/visitor-keys": "8.59.4"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -2299,9 +2299,9 @@
       }
     },
     "node_modules/@typescript-eslint/tsconfig-utils": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.59.3.tgz",
-      "integrity": "sha512-PcIJHjmaREXLgIAIzLnSY9VucEzz8FKXsRgFa1DmdGCK/5tJpW03TKJF01Q6VZd1lLdz2sIKPWaDUZN9dp//dw==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.59.4.tgz",
+      "integrity": "sha512-DLCpnKgD4alVxTBSKulK+gU1KCqOgUXfDRDXh2mZgzokQKa/70ax93I2uVO3m/LLvIAtWZIFoiifudmIqAxpMA==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -2316,15 +2316,15 @@
       }
     },
     "node_modules/@typescript-eslint/type-utils": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.59.3.tgz",
-      "integrity": "sha512-g71d8QD8UaiHGvrJwyIS1hCX5r63w6Jll+4VEYhEAHXTDIqX1JgxhTAbEHtKntL9kuc4jRo7/GWw5xfCepSccQ==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.59.4.tgz",
+      "integrity": "sha512-uonTuPAAKr9XaBGqJ3LjYTh72zy5DyGesljO9gtmk/eFW0W1fRHjnwVYKB35Lm8d5Q5CluEW3gPHjTvZTmgrfA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.59.3",
-        "@typescript-eslint/typescript-estree": "8.59.3",
-        "@typescript-eslint/utils": "8.59.3",
+        "@typescript-eslint/types": "8.59.4",
+        "@typescript-eslint/typescript-estree": "8.59.4",
+        "@typescript-eslint/utils": "8.59.4",
         "debug": "^4.4.3",
         "ts-api-utils": "^2.5.0"
       },
@@ -2341,9 +2341,9 @@
       }
     },
     "node_modules/@typescript-eslint/types": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.59.3.tgz",
-      "integrity": "sha512-ePFoH0g4ludssdRFqqDxQePCxU4WQyRa9+XVwjm7yLn0FKhMeoetC+qBEEI1Eyb1pGSDveTIT09Bvw2WhlGayg==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.59.4.tgz",
+      "integrity": "sha512-F1o7WJcCq+bc8dwcO/YsSEOudAH8RDtaOhM6wcAQhcUsFhnWQl81JKy48q1hoxAU0qrzM89+31GYh1515Zde3Q==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -2355,16 +2355,16 @@
       }
     },
     "node_modules/@typescript-eslint/typescript-estree": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.59.3.tgz",
-      "integrity": "sha512-CbRjVRAf7Lr9Kr8RopKcbY45p2VfmmHrm0ygOCYFi7oU8q19m0Fs/6iHS7kNOmwpp+ob07ZVcAqlxUod9lYdmg==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.59.4.tgz",
+      "integrity": "sha512-F+RuOmcDXo4+TPdfd/TCLS3m2nw8gE9XXyZLrA3JBfaA5tz9TtdkyD3YJFmPxulyc2cKbEok/CvFE3MgSLWnag==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/project-service": "8.59.3",
-        "@typescript-eslint/tsconfig-utils": "8.59.3",
-        "@typescript-eslint/types": "8.59.3",
-        "@typescript-eslint/visitor-keys": "8.59.3",
+        "@typescript-eslint/project-service": "8.59.4",
+        "@typescript-eslint/tsconfig-utils": "8.59.4",
+        "@typescript-eslint/types": "8.59.4",
+        "@typescript-eslint/visitor-keys": "8.59.4",
         "debug": "^4.4.3",
         "minimatch": "^10.2.2",
         "semver": "^7.7.3",
@@ -2383,16 +2383,16 @@
       }
     },
     "node_modules/@typescript-eslint/utils": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.59.3.tgz",
-      "integrity": "sha512-JAvT14goBzRzzzZyqq3P9BLArIxTtQURUtFgQ/V7FO+eU+Gg6ES+5ymOPP1wRxXcxAYeivCk4uS3jCKWI1K8Zg==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.59.4.tgz",
+      "integrity": "sha512-cYXeNAUsG4lJo5dbc1FcKm+JwIWrj1/UpTORsC6tGMjEZ81DYcvIr9/ueikhMa/Y/gDQYGp+YX9/xQrXje5BJw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.9.1",
-        "@typescript-eslint/scope-manager": "8.59.3",
-        "@typescript-eslint/types": "8.59.3",
-        "@typescript-eslint/typescript-estree": "8.59.3"
+        "@typescript-eslint/scope-manager": "8.59.4",
+        "@typescript-eslint/types": "8.59.4",
+        "@typescript-eslint/typescript-estree": "8.59.4"
       },
       "engines": {
         "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -2407,13 +2407,13 @@
       }
     },
     "node_modules/@typescript-eslint/visitor-keys": {
-      "version": "8.59.3",
-      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.59.3.tgz",
-      "integrity": "sha512-f1UQF7ggd42YiwI5wGrRaPsa+P0CINBlrkLPmGfpq/u/I/oVtecoEIfFR9ag/oa1sLOsRNZ6xehf6qMZhQGBDg==",
+      "version": "8.59.4",
+      "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.59.4.tgz",
+      "integrity": "sha512-U3gxVaDVnuZKhSspW/MzMxE1kq7zOdc072FcSNoqA1I9p8HyKbBFfEHoWckBAMgNMph4MamwS5iTVzFmrnt8TQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@typescript-eslint/types": "8.59.3",
+        "@typescript-eslint/types": "8.59.4",
         "eslint-visitor-keys": "^5.0.0"
       },
       "engines": {
@@ -2438,14 +2438,14 @@
       }
     },
     "node_modules/@vitest/coverage-v8": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-4.1.6.tgz",
-      "integrity": "sha512-36l628fQ/9a/8ihy97eOtEnvWQEdqULQOJtcaxtoNq0G1w3Mxd4szSahOaMM9/NGyZ+hyKcMtIW/WIxq0XQViQ==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-4.1.7.tgz",
+      "integrity": "sha512-qsYPeXc5Q9dFLd1i8Ap+Bx8sQgcp+rFVQo4R0dDsWNBzl26ldVF1qOO+RL24K7FDrR6pA+50XedRLSoSG24bVQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@bcoe/v8-coverage": "^1.0.2",
-        "@vitest/utils": "4.1.6",
+        "@vitest/utils": "4.1.7",
         "ast-v8-to-istanbul": "^1.0.0",
         "istanbul-lib-coverage": "^3.2.2",
         "istanbul-lib-report": "^3.0.1",
@@ -2459,8 +2459,8 @@
         "url": "https://opencollective.com/vitest"
       },
       "peerDependencies": {
-        "@vitest/browser": "4.1.6",
-        "vitest": "4.1.6"
+        "@vitest/browser": "4.1.7",
+        "vitest": "4.1.7"
       },
       "peerDependenciesMeta": {
         "@vitest/browser": {
@@ -2479,16 +2479,16 @@
       }
     },
     "node_modules/@vitest/expect": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.6.tgz",
-      "integrity": "sha512-7EHDquPthALSV0jhhjgEW8FXaviMx7rSqu8W6oqCoAuOhKov814P99QDV1pxMA3QPv21YudvJngIhjrNI4opLg==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.7.tgz",
+      "integrity": "sha512-1R+tw0ortHEbZDGMymm+pN7/AFQ/RkFFdtd7EN+VBpynKmLbP8A3rpEXdshBJ7+8hQ9zBJh/i1s0yKNtxAnU7w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@standard-schema/spec": "^1.1.0",
         "@types/chai": "^5.2.2",
-        "@vitest/spy": "4.1.6",
-        "@vitest/utils": "4.1.6",
+        "@vitest/spy": "4.1.7",
+        "@vitest/utils": "4.1.7",
         "chai": "^6.2.2",
         "tinyrainbow": "^3.1.0"
       },
@@ -2496,10 +2496,37 @@
         "url": "https://opencollective.com/vitest"
       }
     },
+    "node_modules/@vitest/mocker": {
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.7.tgz",
+      "integrity": "sha512-vY7nuamKgfvpA1Koa3oYIw/k7D6kZnpGyNMZW8loow2bsBYla1TFdqTaXncWdRn4pgwNs+90RhnXhJScDwQeJA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/spy": "4.1.7",
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.21"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "msw": "^2.4.9",
+        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "msw": {
+          "optional": true
+        },
+        "vite": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/@vitest/pretty-format": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.6.tgz",
-      "integrity": "sha512-h5SxD/IzNhZYnrSZRsUZQIC+vD0GY8cUvq0iwsmkFKixRCKLLWqCXa/FIQ4S1R+sI+PGoojkHsdNrbZiM9Qpgw==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.7.tgz",
+      "integrity": "sha512-umgCarTOYQWIaDMvGDRZij+6b9oVeLIyJzfN+AS88e0ZOU3QTgNNSTtjQOpcvWr3np1N0j4WgZj+sb3oYBDscw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -2510,13 +2537,13 @@
       }
     },
     "node_modules/@vitest/runner": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.6.tgz",
-      "integrity": "sha512-nOPCmn2+yD0ZNmKdsXGv/UxMMWbMuKeD6GyYncNwdkYDxpQvrPSKYj2rWuDjC2Y4b6w6hjip5dBKFzEUuZe3vA==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.7.tgz",
+      "integrity": "sha512-BapjmAQ2aI78WdMEfeUWivnfVzB+VPGwWRQcJE0OUq7qEeEcBsCSf+0T5iREBNE5nBb4wA5Ya0W6IA+sghdEFw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@vitest/utils": "4.1.6",
+        "@vitest/utils": "4.1.7",
         "pathe": "^2.0.3"
       },
       "funding": {
@@ -2524,14 +2551,14 @@
       }
     },
     "node_modules/@vitest/snapshot": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.6.tgz",
-      "integrity": "sha512-YhsdE6xAVfTDmzjxL2ZDUvjj+ZsgyOKe+TdQzqkD72wIOmHka8NuGQ6NpTNZv9D2Z63fbwWKJPeVpEw4EQgYxw==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.7.tgz",
+      "integrity": "sha512-ZacLzja+TmJeZ1h14xW2FB/WpeimUD3haBXQPyJqxvo8jQTmfeA8zv58mtjN2C7EHXZDYVcVYdYmAxjkWVvKCw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@vitest/pretty-format": "4.1.6",
-        "@vitest/utils": "4.1.6",
+        "@vitest/pretty-format": "4.1.7",
+        "@vitest/utils": "4.1.7",
         "magic-string": "^0.30.21",
         "pathe": "^2.0.3"
       },
@@ -2540,9 +2567,9 @@
       }
     },
     "node_modules/@vitest/spy": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.6.tgz",
-      "integrity": "sha512-JFKxMx6udhwKh/Ldo270e17QX710vgunMkuPAvXjHSvC6oqLWAHhVhjg/I71q0u0CBSErIODV1Kjv0FQNSWjdg==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.7.tgz",
+      "integrity": "sha512-kbkI5LMWakyuTIvs6fUJ5qdIVb1XVKsYJAT4OJ938cHMROYMSfmoQdZy0aaAnjbbc8F61vkoTqz/Az+/HiIu5Q==",
       "dev": true,
       "license": "MIT",
       "funding": {
@@ -2550,13 +2577,13 @@
       }
     },
     "node_modules/@vitest/utils": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.6.tgz",
-      "integrity": "sha512-FxIY+U81R3LGKCxaHHFRQ5+g6/iRgGLmeHWdp2Amj4ljQRrEIWHmZyDfDYBRZlpyqA7qKxtS9DD1dhk8RnRIVQ==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.7.tgz",
+      "integrity": "sha512-T532WBu791cBxJlCl6SO+J14l81DQx6uQHm1bQbmCDY7nqlEIgkza/UFnSBNaUtSf41unldDFjdOBYEQC4b5Hw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@vitest/pretty-format": "4.1.6",
+        "@vitest/pretty-format": "4.1.7",
         "convert-source-map": "^2.0.0",
         "tinyrainbow": "^3.1.0"
       },
@@ -3575,6 +3602,13 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/es-module-lexer": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.1.0.tgz",
+      "integrity": "sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/es-object-atoms": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
@@ -6129,6 +6163,19 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/pirates": {
       "version": "4.0.7",
       "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz",
@@ -7115,19 +7162,6 @@
         }
       }
     },
-    "node_modules/tinyglobby/node_modules/picomatch": {
-      "version": "4.0.4",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
-      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
     "node_modules/tinyrainbow": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.0.tgz",
@@ -8038,20 +8072,98 @@
         "punycode": "^2.1.0"
       }
     },
+    "node_modules/vite": {
+      "version": "8.0.13",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.13.tgz",
+      "integrity": "sha512-MFtjBYgzmSxmgA4RAfjIyXWpGe1oALnjgUTzzV7QLx/TKxCzjtMH6Fd9/eVK+5Fg1qNoz5VAwsmMs/NofrmJvw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "lightningcss": "^1.32.0",
+        "picomatch": "^4.0.4",
+        "postcss": "^8.5.14",
+        "rolldown": "1.0.1",
+        "tinyglobby": "^0.2.16"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^20.19.0 || >=22.12.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^20.19.0 || >=22.12.0",
+        "@vitejs/devtools": "^0.1.18",
+        "esbuild": "^0.27.0 || ^0.28.0",
+        "jiti": ">=1.21.0",
+        "less": "^4.0.0",
+        "sass": "^1.70.0",
+        "sass-embedded": "^1.70.0",
+        "stylus": ">=0.54.8",
+        "sugarss": "^5.0.0",
+        "terser": "^5.16.0",
+        "tsx": "^4.8.1",
+        "yaml": "^2.4.2"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "@vitejs/devtools": {
+          "optional": true
+        },
+        "esbuild": {
+          "optional": true
+        },
+        "jiti": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        },
+        "tsx": {
+          "optional": true
+        },
+        "yaml": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/vitest": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.6.tgz",
-      "integrity": "sha512-6lvjbS3p9b4CrdCmguzbh2/4uoXhGE2q71R4OX5sqF9R1bo9Xd6fGrMAfvp5wnCzlBnFVdCOp6onuTQVbo8iUQ==",
+      "version": "4.1.7",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.7.tgz",
+      "integrity": "sha512-flYyaFd2CgoCoU+0UKt3pxksgC+S02iTDN0n3LtqaMeXsI9SBcdNujc2k0DeFLzUn/0k538yNjOSdwgCqcrwJA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@vitest/expect": "4.1.6",
-        "@vitest/mocker": "4.1.6",
-        "@vitest/pretty-format": "4.1.6",
-        "@vitest/runner": "4.1.6",
-        "@vitest/snapshot": "4.1.6",
-        "@vitest/spy": "4.1.6",
-        "@vitest/utils": "4.1.6",
+        "@vitest/expect": "4.1.7",
+        "@vitest/mocker": "4.1.7",
+        "@vitest/pretty-format": "4.1.7",
+        "@vitest/runner": "4.1.7",
+        "@vitest/snapshot": "4.1.7",
+        "@vitest/spy": "4.1.7",
+        "@vitest/utils": "4.1.7",
         "es-module-lexer": "^2.0.0",
         "expect-type": "^1.3.0",
         "magic-string": "^0.30.21",
@@ -8079,12 +8191,12 @@
         "@edge-runtime/vm": "*",
         "@opentelemetry/api": "^1.9.0",
         "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0",
-        "@vitest/browser-playwright": "4.1.6",
-        "@vitest/browser-preview": "4.1.6",
-        "@vitest/browser-webdriverio": "4.1.6",
-        "@vitest/coverage-istanbul": "4.1.6",
-        "@vitest/coverage-v8": "4.1.6",
-        "@vitest/ui": "4.1.6",
+        "@vitest/browser-playwright": "4.1.7",
+        "@vitest/browser-preview": "4.1.7",
+        "@vitest/browser-webdriverio": "4.1.7",
+        "@vitest/coverage-istanbul": "4.1.7",
+        "@vitest/coverage-v8": "4.1.7",
+        "@vitest/ui": "4.1.7",
         "happy-dom": "*",
         "jsdom": "*",
         "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
@@ -8128,53 +8240,6 @@
         }
       }
     },
-    "node_modules/vitest/node_modules/@vitest/mocker": {
-      "version": "4.1.6",
-      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.6.tgz",
-      "integrity": "sha512-MCFc63czMjEInOlcY2cpQCvCN+KgbAn+60xu9cMgP4sKaLC5JNAKw7JH8QdAnoAC88hW1IiSNZ+GgVXlN1UcMQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/spy": "4.1.6",
-        "estree-walker": "^3.0.3",
-        "magic-string": "^0.30.21"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      },
-      "peerDependencies": {
-        "msw": "^2.4.9",
-        "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
-      },
-      "peerDependenciesMeta": {
-        "msw": {
-          "optional": true
-        },
-        "vite": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/vitest/node_modules/es-module-lexer": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.1.0.tgz",
-      "integrity": "sha512-n27zTYMjYu1aj4MjCWzSP7G9r75utsaoc8m61weK+W8JMBGGQybd43GstCXZ3WNmSFtGT9wi59qQTW6mhTR5LQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/vitest/node_modules/picomatch": {
-      "version": "4.0.4",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
-      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
     "node_modules/vitest/node_modules/tinyexec": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.1.2.tgz",
@@ -8185,84 +8250,6 @@
         "node": ">=18"
       }
     },
-    "node_modules/vitest/node_modules/vite": {
-      "version": "8.0.13",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.13.tgz",
-      "integrity": "sha512-MFtjBYgzmSxmgA4RAfjIyXWpGe1oALnjgUTzzV7QLx/TKxCzjtMH6Fd9/eVK+5Fg1qNoz5VAwsmMs/NofrmJvw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "lightningcss": "^1.32.0",
-        "picomatch": "^4.0.4",
-        "postcss": "^8.5.14",
-        "rolldown": "1.0.1",
-        "tinyglobby": "^0.2.16"
-      },
-      "bin": {
-        "vite": "bin/vite.js"
-      },
-      "engines": {
-        "node": "^20.19.0 || >=22.12.0"
-      },
-      "funding": {
-        "url": "https://github.com/vitejs/vite?sponsor=1"
-      },
-      "optionalDependencies": {
-        "fsevents": "~2.3.3"
-      },
-      "peerDependencies": {
-        "@types/node": "^20.19.0 || >=22.12.0",
-        "@vitejs/devtools": "^0.1.18",
-        "esbuild": "^0.27.0 || ^0.28.0",
-        "jiti": ">=1.21.0",
-        "less": "^4.0.0",
-        "sass": "^1.70.0",
-        "sass-embedded": "^1.70.0",
-        "stylus": ">=0.54.8",
-        "sugarss": "^5.0.0",
-        "terser": "^5.16.0",
-        "tsx": "^4.8.1",
-        "yaml": "^2.4.2"
-      },
-      "peerDependenciesMeta": {
-        "@types/node": {
-          "optional": true
-        },
-        "@vitejs/devtools": {
-          "optional": true
-        },
-        "esbuild": {
-          "optional": true
-        },
-        "jiti": {
-          "optional": true
-        },
-        "less": {
-          "optional": true
-        },
-        "sass": {
-          "optional": true
-        },
-        "sass-embedded": {
-          "optional": true
-        },
-        "stylus": {
-          "optional": true
-        },
-        "sugarss": {
-          "optional": true
-        },
-        "terser": {
-          "optional": true
-        },
-        "tsx": {
-          "optional": true
-        },
-        "yaml": {
-          "optional": true
-        }
-      }
-    },
     "node_modules/w3c-xmlserializer": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
diff --git a/package.json b/package.json
index ff3c042c..b2e61b89 100644
--- a/package.json
+++ b/package.json
@@ -11,6 +11,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
+    "./locales": {
+      "types": "./dist/locales/index.d.ts",
+      "import": "./dist/locales/index.mjs",
+      "require": "./dist/locales/index.js"
+    },
     "./css": "./dist/DataTable.css"
   },
   "files": [
@@ -50,9 +55,9 @@
     "@testing-library/react": "^16.3.2",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
-    "@typescript-eslint/eslint-plugin": "^8.59.2",
-    "@typescript-eslint/parser": "^8.59.2",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@typescript-eslint/eslint-plugin": "^8.59.4",
+    "@typescript-eslint/parser": "^8.59.4",
+    "@vitest/coverage-v8": "^4.1.7",
     "concurrently": "^9.2.1",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
@@ -66,7 +71,7 @@
     "react-dom": "^18.3.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
diff --git a/src/__tests__/ColumnFilter.test.tsx b/src/__tests__/ColumnFilter.test.tsx
index 12b1d836..2ec5a373 100644
--- a/src/__tests__/ColumnFilter.test.tsx
+++ b/src/__tests__/ColumnFilter.test.tsx
@@ -244,3 +244,126 @@ describe('ColumnFilter:date filter type', () => {
 		expect(input.type).toBe('date');
 	});
 });
+
+describe('ColumnFilter:localization (options prop)', () => {
+	const options = {
+		filterColumnAriaLabel: 'test-filter-col',
+		filterActiveAriaLabel: 'test-filter-active',
+		filterPanelAriaLabel: 'test-filter-panel',
+		operatorAriaLabel: 'test-operator',
+		valuePlaceholder: 'test-placeholder',
+		valueAriaLabel: 'test-value',
+		value2AriaLabel: 'test-value2',
+		value2Placeholder: 'test-placeholder2',
+		betweenSeparatorText: 'test-sep',
+		removeConditionAriaLabel: 'test-remove',
+		addConditionAriaLabel: 'test-add',
+		addConditionLabel: 'test-add-label',
+		clearLabel: 'test-clear',
+		applyLabel: 'test-apply',
+		andLabel: 'test-and',
+		orLabel: 'test-or',
+		operators: { contains: 'test-contains', equals: 'test-equals' },
+	};
+
+	test('filter icon button uses custom aria-label', () => {
+		const { container } = setup({ options });
+		const btn = container.querySelector('button') as HTMLButtonElement;
+		expect(btn.getAttribute('aria-label')).toBe('test-filter-col');
+	});
+
+	test('active filter uses custom active aria-label', () => {
+		const { container } = setup({
+			options,
+			filterValue: { condition1: { operator: 'contains', value: 'x' } },
+		});
+		const btn = container.querySelector('button') as HTMLButtonElement;
+		expect(btn.getAttribute('aria-label')).toBe('test-filter-active');
+	});
+
+	function openPanelByClass(container: HTMLElement) {
+		const btn = container.querySelector('button.rdt_filterIcon') as HTMLElement;
+		fireEvent.click(btn);
+	}
+
+	test('panel uses custom aria-label', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		expect(container.querySelector('[role="dialog"]')?.getAttribute('aria-label')).toBe('test-filter-panel');
+	});
+
+	test('operator select uses custom aria-label', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		expect(container.querySelector('select')?.getAttribute('aria-label')).toBe('test-operator');
+	});
+
+	test('value input uses custom placeholder and aria-label', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		const input = container.querySelector('input') as HTMLInputElement;
+		expect(input.getAttribute('aria-label')).toBe('test-value');
+		expect(input.placeholder).toBe('test-placeholder');
+	});
+
+	test('custom operator labels appear in select; untranslated keys fall back to default', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		const select = container.querySelector('select') as HTMLSelectElement;
+		const optionTexts = Array.from(select.options).map(o => o.text);
+		expect(optionTexts).toContain('test-contains');
+		expect(optionTexts).toContain('test-equals');
+		expect(optionTexts).toContain('Does not contain'); // untranslated key falls back to English default
+	});
+
+	test('Apply and Clear buttons use custom labels', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		const btns = Array.from(container.querySelectorAll('.rdt_filterActions button')).map(b => b.textContent);
+		expect(btns).toContain('test-clear');
+		expect(btns).toContain('test-apply');
+	});
+
+	test('add-condition button uses custom label and aria-label', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		const addBtn = container.querySelector('.rdt_filterAddCondition') as HTMLButtonElement;
+		expect(addBtn.textContent).toBe('test-add-label');
+		expect(addBtn.getAttribute('aria-label')).toBe('test-add');
+	});
+
+	test('AND / OR buttons use custom labels', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		fireEvent.click(container.querySelector('.rdt_filterAddCondition') as HTMLElement);
+		const logicBtns = Array.from(container.querySelectorAll('.rdt_filterLogicBtn')).map(b => b.textContent);
+		expect(logicBtns).toContain('test-and');
+		expect(logicBtns).toContain('test-or');
+	});
+
+	test('remove-condition button uses custom aria-label', () => {
+		const { container } = setup({ options });
+		openPanelByClass(container);
+		fireEvent.click(container.querySelector('.rdt_filterAddCondition') as HTMLElement);
+		const removeBtn = container.querySelector('.rdt_filterRemoveBtn') as HTMLButtonElement;
+		expect(removeBtn.getAttribute('aria-label')).toBe('test-remove');
+	});
+
+	test('between separator uses custom text', () => {
+		const { container } = setup({ options, filterType: 'number', filterValue: emptyFilterState('number') });
+		openPanelByClass(container);
+		const select = container.querySelector('select') as HTMLSelectElement;
+		fireEvent.change(select, { target: { value: 'between' } });
+		expect(container.querySelector('.rdt_filterBetweenSep')?.textContent).toBe('test-sep');
+	});
+
+	test('second value input uses custom aria-label and placeholder', () => {
+		const { container } = setup({ options, filterType: 'number', filterValue: emptyFilterState('number') });
+		openPanelByClass(container);
+		const select = container.querySelector('select') as HTMLSelectElement;
+		fireEvent.change(select, { target: { value: 'between' } });
+		const input2 = container.querySelector('input[aria-label="test-value2"]') as HTMLInputElement;
+		expect(input2).not.toBeNull();
+		expect(input2.placeholder).toBe('test-placeholder2');
+	});
+});
diff --git a/src/__tests__/Pagination.test.tsx b/src/__tests__/Pagination.test.tsx
index 26cbc74f..c1507253 100644
--- a/src/__tests__/Pagination.test.tsx
+++ b/src/__tests__/Pagination.test.tsx
@@ -204,6 +204,86 @@ describe('when changing rows per page', () => {
 	});
 });
 
+describe('Pagination:localization', () => {
+	const localization = {
+		navigationAriaLabel: 'test-nav',
+		firstPageAriaLabel: 'test-first',
+		previousPageAriaLabel: 'test-prev',
+		nextPageAriaLabel: 'test-next',
+		lastPageAriaLabel: 'test-last',
+	};
+
+	test('navigation nav uses custom navigationAriaLabel', () => {
+		const { container } = renderWithTheme(
+			<Pagination
+				currentPage={1}
+				rowsPerPage={10}
+				rowCount={40}
+				onChangePage={vi.fn()}
+				onChangeRowsPerPage={vi.fn()}
+				localization={localization}
+			/>,
+		);
+		expect(container.querySelector('nav')?.getAttribute('aria-label')).toBe('test-nav');
+	});
+
+	test('first-page button uses custom firstPageAriaLabel', () => {
+		const { container } = renderWithTheme(
+			<Pagination
+				currentPage={2}
+				rowsPerPage={10}
+				rowCount={40}
+				onChangePage={vi.fn()}
+				onChangeRowsPerPage={vi.fn()}
+				localization={localization}
+			/>,
+		);
+		expect(container.querySelector('#pagination-first-page')?.getAttribute('aria-label')).toBe('test-first');
+	});
+
+	test('previous-page button uses custom previousPageAriaLabel', () => {
+		const { container } = renderWithTheme(
+			<Pagination
+				currentPage={2}
+				rowsPerPage={10}
+				rowCount={40}
+				onChangePage={vi.fn()}
+				onChangeRowsPerPage={vi.fn()}
+				localization={localization}
+			/>,
+		);
+		expect(container.querySelector('#pagination-previous-page')?.getAttribute('aria-label')).toBe('test-prev');
+	});
+
+	test('next-page button uses custom nextPageAriaLabel', () => {
+		const { container } = renderWithTheme(
+			<Pagination
+				currentPage={1}
+				rowsPerPage={10}
+				rowCount={40}
+				onChangePage={vi.fn()}
+				onChangeRowsPerPage={vi.fn()}
+				localization={localization}
+			/>,
+		);
+		expect(container.querySelector('#pagination-next-page')?.getAttribute('aria-label')).toBe('test-next');
+	});
+
+	test('last-page button uses custom lastPageAriaLabel', () => {
+		const { container } = renderWithTheme(
+			<Pagination
+				currentPage={1}
+				rowsPerPage={10}
+				rowCount={40}
+				onChangePage={vi.fn()}
+				onChangeRowsPerPage={vi.fn()}
+				localization={localization}
+			/>,
+		);
+		expect(container.querySelector('#pagination-last-page')?.getAttribute('aria-label')).toBe('test-last');
+	});
+});
+
 describe('when the screensize is small', () => {
 	test('paginationComponentOption noRowsPerPage should be respected', () => {
 		globalThis.innerWidth = 500;
diff --git a/src/components/ColumnFilter.tsx b/src/components/ColumnFilter.tsx
index 63745390..bfecad29 100644
--- a/src/components/ColumnFilter.tsx
+++ b/src/components/ColumnFilter.tsx
@@ -1,11 +1,13 @@
 import * as React from 'react';
 import '../DataTable.css';
-import type { FilterState, FilterCondition, FilterOperator, FilterType } from '../types';
+import type { FilterState, FilterCondition, FilterOperator, FilterType, Localization } from '../types';
+
+type ColumnFilterOptions = NonNullable<Localization['filter']>;
 import { emptyFilterState, isFilterActive } from '../hooks/useColumnFilter';
 
 type OperatorOption = { value: FilterOperator; label: string; noInput?: boolean; twoInputs?: boolean };
 
-const TEXT_OPERATORS: OperatorOption[] = [
+const DEFAULT_TEXT_OPERATORS: OperatorOption[] = [
 	{ value: 'contains', label: 'Contains' },
 	{ value: 'notContains', label: 'Does not contain' },
 	{ value: 'equals', label: 'Equals' },
@@ -16,7 +18,7 @@ const TEXT_OPERATORS: OperatorOption[] = [
 	{ value: 'notBlank', label: 'Not blank', noInput: true },
 ];
 
-const NUMBER_OPERATORS: OperatorOption[] = [
+const DEFAULT_NUMBER_OPERATORS: OperatorOption[] = [
 	{ value: 'equals', label: 'Equals' },
 	{ value: 'notEquals', label: 'Does not equal' },
 	{ value: 'gt', label: 'Greater than' },
@@ -28,7 +30,7 @@ const NUMBER_OPERATORS: OperatorOption[] = [
 	{ value: 'notBlank', label: 'Not blank', noInput: true },
 ];
 
-const DATE_OPERATORS: OperatorOption[] = [
+const DEFAULT_DATE_OPERATORS: OperatorOption[] = [
 	{ value: 'equals', label: 'Equals' },
 	{ value: 'before', label: 'Before' },
 	{ value: 'after', label: 'After' },
@@ -37,10 +39,15 @@ const DATE_OPERATORS: OperatorOption[] = [
 	{ value: 'notBlank', label: 'Not blank', noInput: true },
 ];
 
-function operatorsFor(filterType: FilterType): OperatorOption[] {
-	if (filterType === 'number') return NUMBER_OPERATORS;
-	if (filterType === 'date') return DATE_OPERATORS;
-	return TEXT_OPERATORS;
+function operatorsFor(filterType: FilterType, overrides?: ColumnFilterOptions['operators']): OperatorOption[] {
+	const base =
+		filterType === 'number'
+			? DEFAULT_NUMBER_OPERATORS
+			: filterType === 'date'
+				? DEFAULT_DATE_OPERATORS
+				: DEFAULT_TEXT_OPERATORS;
+	if (!overrides) return base;
+	return base.map(op => (overrides[op.value] ? { ...op, label: overrides[op.value]! } : op));
 }
 
 function defaultOperator(filterType: FilterType): FilterOperator {
@@ -54,12 +61,13 @@ function emptyCondition(filterType: FilterType): FilterCondition {
 type ConditionRowProps = {
 	condition: FilterCondition;
 	filterType: FilterType;
+	options: ColumnFilterOptions;
 	onChange: (next: FilterCondition) => void;
 	onRemove?: () => void;
 };
 
-function ConditionRow({ condition, filterType, onChange, onRemove }: ConditionRowProps): JSX.Element {
-	const operators = operatorsFor(filterType);
+function ConditionRow({ condition, filterType, options, onChange, onRemove }: ConditionRowProps): JSX.Element {
+	const operators = operatorsFor(filterType, options.operators);
 	const selected = operators.find(o => o.value === condition.operator) ?? operators[0];
 	const inputType = filterType === 'number' ? 'number' : filterType === 'date' ? 'date' : 'text';
 
@@ -69,7 +77,7 @@ function ConditionRow({ condition, filterType, onChange, onRemove }: ConditionRo
 				className="rdt_filterSelect"
 				value={condition.operator}
 				onChange={e => onChange({ operator: e.target.value as FilterOperator })}
-				aria-label="Filter operator"
+				aria-label={options.operatorAriaLabel ?? 'Filter operator'}
 			>
 				{operators.map(op => (
 					<option key={op.value} value={op.value}>
@@ -83,30 +91,35 @@ function ConditionRow({ condition, filterType, onChange, onRemove }: ConditionRo
 					className="rdt_filterInput"
 					type={inputType}
 					value={condition.value ?? ''}
-					placeholder="Value"
+					placeholder={options.valuePlaceholder ?? 'Value'}
 					onChange={e => onChange({ ...condition, value: e.target.value })}
 					onKeyDown={e => e.stopPropagation()}
-					aria-label="Filter value"
+					aria-label={options.valueAriaLabel ?? 'Filter value'}
 				/>
 			)}
 
 			{selected.twoInputs && (
 				<>
-					<span className="rdt_filterBetweenSep">and</span>
+					<span className="rdt_filterBetweenSep">{options.betweenSeparatorText ?? 'and'}</span>
 					<input
 						className="rdt_filterInput"
 						type={inputType}
 						value={condition.value2 ?? ''}
-						placeholder="Value"
+						placeholder={options.value2Placeholder ?? 'Value'}
 						onChange={e => onChange({ ...condition, value2: e.target.value })}
 						onKeyDown={e => e.stopPropagation()}
-						aria-label="Filter second value"
+						aria-label={options.value2AriaLabel ?? 'Filter second value'}
 					/>
 				</>
 			)}
 
 			{onRemove && (
-				<button type="button" className="rdt_filterRemoveBtn" onClick={onRemove} aria-label="Remove condition">
+				<button
+					type="button"
+					className="rdt_filterRemoveBtn"
+					onClick={onRemove}
+					aria-label={options.removeConditionAriaLabel ?? 'Remove condition'}
+				>
 					✕
 				</button>
 			)}
@@ -118,6 +131,7 @@ type ColumnFilterProps = {
 	columnId: string | number;
 	filterValue: FilterState;
 	filterType?: FilterType;
+	options?: ColumnFilterOptions;
 	onFilterChange: (columnId: string | number, filter: FilterState) => void;
 };
 
@@ -125,6 +139,7 @@ export default function ColumnFilter({
 	columnId,
 	filterValue,
 	filterType = 'text',
+	options = {},
 	onFilterChange,
 }: ColumnFilterProps): JSX.Element {
 	const [open, setOpen] = React.useState(false);
@@ -216,7 +231,11 @@ export default function ColumnFilter({
 				ref={buttonRef}
 				type="button"
 				className={['rdt_filterIcon', isActive && 'rdt_filterIconActive'].filter(Boolean).join(' ')}
-				aria-label={isActive ? 'Filter active' : 'Filter column'}
+				aria-label={
+					isActive
+						? (options.filterActiveAriaLabel ?? 'Filter active')
+						: (options.filterColumnAriaLabel ?? 'Filter column')
+				}
 				aria-pressed={open}
 				onClick={e => {
 					e.stopPropagation();
@@ -243,10 +262,15 @@ export default function ColumnFilter({
 					ref={panelRef}
 					className="rdt_filterPanel"
 					role="dialog"
-					aria-label="Column filter"
+					aria-label={options.filterPanelAriaLabel ?? 'Column filter'}
 					style={{ position: 'fixed', top: panelPos.top, left: panelPos.left }}
 				>
-					<ConditionRow condition={pending.condition1} filterType={filterType} onChange={handleCondition1Change} />
+					<ConditionRow
+						condition={pending.condition1}
+						filterType={filterType}
+						options={options}
+						onChange={handleCondition1Change}
+					/>
 
 					{pending.condition2 ? (
 						<>
@@ -259,7 +283,7 @@ export default function ColumnFilter({
 									aria-pressed={pending.logic !== 'OR'}
 									onClick={() => handleLogicChange('AND')}
 								>
-									AND
+									{options.andLabel ?? 'AND'}
 								</button>
 								<button
 									type="button"
@@ -269,12 +293,13 @@ export default function ColumnFilter({
 									aria-pressed={pending.logic === 'OR'}
 									onClick={() => handleLogicChange('OR')}
 								>
-									OR
+									{options.orLabel ?? 'OR'}
 								</button>
 							</div>
 							<ConditionRow
 								condition={pending.condition2}
 								filterType={filterType}
+								options={options}
 								onChange={handleCondition2Change}
 								onRemove={handleRemoveCondition2}
 							/>
@@ -283,19 +308,19 @@ export default function ColumnFilter({
 						<button
 							type="button"
 							className="rdt_filterAddCondition"
-							aria-label="Add a second filter condition"
+							aria-label={options.addConditionAriaLabel ?? 'Add a second filter condition'}
 							onClick={handleAddCondition}
 						>
-							+ Add condition
+							{options.addConditionLabel ?? '+ Add condition'}
 						</button>
 					)}
 
 					<div className="rdt_filterActions">
 						<button type="button" className="rdt_filterBtn" onClick={handleClear}>
-							Clear
+							{options.clearLabel ?? 'Clear'}
 						</button>
 						<button type="button" className="rdt_filterBtn rdt_filterBtnPrimary" onClick={handleApply}>
-							Apply
+							{options.applyLabel ?? 'Apply'}
 						</button>
 					</div>
 				</div>
diff --git a/src/components/DataTable.tsx b/src/components/DataTable.tsx
index 01242f2b..dd9c4c8f 100644
--- a/src/components/DataTable.tsx
+++ b/src/components/DataTable.tsx
@@ -109,6 +109,7 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 		columnGroups,
 		filterValues: controlledFilterValues,
 		onFilterChange: onFilterChangeProp,
+		localization = {},
 		resizable = false,
 		initialColumnWidths,
 		onColumnResize,
@@ -370,6 +371,7 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 		selectableRowDisabled,
 		expandableRows,
 		expandableIcon,
+		localization: localization.expandable ?? {},
 		expandableRowsComponent,
 		expandableRowsComponentProps,
 		expandableRowsHideExpander,
@@ -411,6 +413,7 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 		draggingColumnId,
 		draggingGroupKey,
 		filterValues,
+		localization: localization.filter ?? {},
 		columnWidths,
 		pinnedOffsets,
 		resizable,
@@ -480,6 +483,7 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 								paginationRowsPerPageOptions={paginationRowsPerPageOptions}
 								paginationIcons={paginationIcons}
 								paginationComponentOptions={paginationComponentOptions}
+								localization={localization.pagination}
 								position="top"
 							/>
 						)}
@@ -562,6 +566,7 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 								paginationRowsPerPageOptions={paginationRowsPerPageOptions}
 								paginationIcons={paginationIcons}
 								paginationComponentOptions={paginationComponentOptions}
+								localization={localization.pagination}
 							/>
 						)}
 					</div>
diff --git a/src/components/DataTableHead.tsx b/src/components/DataTableHead.tsx
index 6640c200..bd57ca2f 100644
--- a/src/components/DataTableHead.tsx
+++ b/src/components/DataTableHead.tsx
@@ -44,6 +44,7 @@ function DataTableHead<T>({
 		draggingColumnId,
 		draggingGroupKey,
 		filterValues,
+		localization: filterLocalization,
 		columnWidths,
 		pinnedOffsets,
 		resizable,
@@ -156,6 +157,7 @@ function DataTableHead<T>({
 		sortIcon,
 		sortServer,
 		filterValue: filterValues[column.id!] ?? emptyFilterState(column.filterType),
+		filterLocalization,
 		resizedWidth: columnWidths[column.id!],
 		onSort,
 		onFilterChange,
diff --git a/src/components/ExpanderButton.tsx b/src/components/ExpanderButton.tsx
index 5bb7e44b..949044da 100644
--- a/src/components/ExpanderButton.tsx
+++ b/src/components/ExpanderButton.tsx
@@ -1,12 +1,15 @@
 import * as React from 'react';
 import '../DataTable.css';
 import { useStyles } from '../context/StylesContext';
-import type { ExpandableIcon } from '../types';
+import type { ExpandableIcon, Localization } from '../types';
+
+type ExpandableRowsOptions = NonNullable<Localization['expandable']>;
 
 type ExpanderButtonProps<T> = {
 	disabled?: boolean;
 	expanded?: boolean;
 	expandableIcon: ExpandableIcon;
+	expandableRowsOptions?: ExpandableRowsOptions;
 	id: string | number;
 	row: T;
 	onToggled?: (row: T) => void;
@@ -16,6 +19,7 @@ function ExpanderButton<T>({
 	disabled = false,
 	expanded = false,
 	expandableIcon,
+	expandableRowsOptions,
 	id,
 	row,
 	onToggled,
@@ -32,7 +36,11 @@ function ExpanderButton<T>({
 			onClick={handleToggle}
 			data-testid={`expander-button-${id}`}
 			disabled={disabled}
-			aria-label={expanded ? 'Collapse Row' : 'Expand Row'}
+			aria-label={
+				expanded
+					? (expandableRowsOptions?.collapseRowAriaLabel ?? 'Collapse Row')
+					: (expandableRowsOptions?.expandRowAriaLabel ?? 'Expand Row')
+			}
 			type="button"
 		>
 			{icon}
diff --git a/src/components/Pagination.tsx b/src/components/Pagination.tsx
index c6b7e63b..0d4f5791 100644
--- a/src/components/Pagination.tsx
+++ b/src/components/Pagination.tsx
@@ -6,7 +6,7 @@ import { getNumberOfPages } from '../util';
 import useWindowSize from '../hooks/useWindowSize';
 import useRTL from '../hooks/useRTL';
 import { Direction } from '../constants';
-import type { PaginationIcons, PaginationOptions, PaginationChangePage } from '../types';
+import type { PaginationIcons, PaginationOptions, PaginationChangePage, Localization } from '../types';
 import { defaultProps, DEFAULT_PAGINATION_ICONS } from '../defaultProps';
 
 const defaultComponentOptions = {
@@ -25,6 +25,7 @@ interface PaginationProps {
 	paginationRowsPerPageOptions?: number[];
 	paginationIcons?: PaginationIcons;
 	paginationComponentOptions?: PaginationOptions;
+	localization?: Localization['pagination'];
 	onChangePage: PaginationChangePage;
 	onChangeRowsPerPage: (numRows: number, currentPage: number) => void;
 }
@@ -37,6 +38,7 @@ function Pagination({
 	paginationRowsPerPageOptions = defaultProps.paginationRowsPerPageOptions,
 	paginationIcons = DEFAULT_PAGINATION_ICONS,
 	paginationComponentOptions = defaultProps.paginationComponentOptions,
+	localization,
 	onChangeRowsPerPage = defaultProps.onChangeRowsPerPage,
 	onChangePage = defaultProps.onChangePage,
 }: PaginationProps): JSX.Element {
@@ -102,7 +104,7 @@ function Pagination({
 	return (
 		<nav
 			className={['rdt_pagination', 'rdt_Pagination'].join(' ')}
-			aria-label="Table pagination"
+			aria-label={localization?.navigationAriaLabel ?? 'Table pagination'}
 			style={customStyles.pagination?.style}
 		>
 			{!options.noRowsPerPage && shouldShow && (
@@ -116,7 +118,7 @@ function Pagination({
 				<button
 					id="pagination-first-page"
 					type="button"
-					aria-label="First Page"
+					aria-label={localization?.firstPageAriaLabel ?? 'First Page'}
 					aria-disabled={disabledLesser}
 					onClick={handleFirst}
 					disabled={disabledLesser}
@@ -128,7 +130,7 @@ function Pagination({
 				<button
 					id="pagination-previous-page"
 					type="button"
-					aria-label="Previous Page"
+					aria-label={localization?.previousPageAriaLabel ?? 'Previous Page'}
 					aria-disabled={disabledLesser}
 					onClick={handlePrevious}
 					disabled={disabledLesser}
@@ -141,7 +143,7 @@ function Pagination({
 				<button
 					id="pagination-next-page"
 					type="button"
-					aria-label="Next Page"
+					aria-label={localization?.nextPageAriaLabel ?? 'Next Page'}
 					aria-disabled={disabledGreater}
 					onClick={handleNext}
 					disabled={disabledGreater}
@@ -153,7 +155,7 @@ function Pagination({
 				<button
 					id="pagination-last-page"
 					type="button"
-					aria-label="Last Page"
+					aria-label={localization?.lastPageAriaLabel ?? 'Last Page'}
 					aria-disabled={disabledGreater}
 					onClick={handleLast}
 					disabled={disabledGreater}
diff --git a/src/components/TableCellExpander.tsx b/src/components/TableCellExpander.tsx
index 54b43cb5..4c449563 100644
--- a/src/components/TableCellExpander.tsx
+++ b/src/components/TableCellExpander.tsx
@@ -3,12 +3,15 @@ import '../DataTable.css';
 import { useStyles } from '../context/StylesContext';
 import { CellBase } from './Cell';
 import ExpanderButton from './ExpanderButton';
-import type { ExpandableIcon } from '../types';
+import type { ExpandableIcon, Localization } from '../types';
+
+type ExpandableRowsOptions = NonNullable<Localization['expandable']>;
 
 type CellExpanderProps<T> = {
 	disabled: boolean;
 	expanded: boolean;
 	expandableIcon: ExpandableIcon;
+	expandableRowsOptions?: ExpandableRowsOptions;
 	id: string | number;
 	row: T;
 	onToggled: (row: T) => void;
@@ -18,6 +21,7 @@ function CellExpander<T>({
 	row,
 	expanded = false,
 	expandableIcon,
+	expandableRowsOptions,
 	id,
 	onToggled,
 	disabled = false,
@@ -36,6 +40,7 @@ function CellExpander<T>({
 				row={row}
 				expanded={expanded}
 				expandableIcon={expandableIcon}
+				expandableRowsOptions={expandableRowsOptions}
 				disabled={disabled}
 				onToggled={onToggled}
 			/>
diff --git a/src/components/TableCol.tsx b/src/components/TableCol.tsx
index 1fee4a9f..0a8ddc4e 100644
--- a/src/components/TableCol.tsx
+++ b/src/components/TableCol.tsx
@@ -7,7 +7,9 @@ import ColumnFilter from './ColumnFilter';
 import { equalizeId, getPinnedCellMeta } from '../util';
 import type { PinnedOffsets } from '../util';
 import { SortOrder } from '../types';
-import type { TableColumn, SortAction, FilterState } from '../types';
+import type { TableColumn, SortAction, FilterState, Localization } from '../types';
+
+type FilterLocalization = NonNullable<Localization['filter']>;
 
 type TableColProps<T> = {
 	column: TableColumn<T>;
@@ -22,6 +24,7 @@ type TableColProps<T> = {
 	sortServer: boolean;
 	selectableRowsVisibleOnly: boolean;
 	filterValue: FilterState;
+	filterLocalization: FilterLocalization;
 	onSort: (action: SortAction<T>) => void;
 	onFilterChange: (columnId: string | number, filter: FilterState) => void;
 	onDragStart: (e: React.DragEvent<HTMLDivElement>) => void;
@@ -50,6 +53,7 @@ function TableCol<T>({
 	persistSelectedOnSort,
 	selectableRowsVisibleOnly,
 	filterValue,
+	filterLocalization,
 	onSort,
 	onFilterChange,
 	onDragStart,
@@ -242,6 +246,7 @@ function TableCol<T>({
 					columnId={column.id}
 					filterValue={filterValue}
 					filterType={column.filterType}
+					options={filterLocalization}
 					onFilterChange={onFilterChange}
 				/>
 			)}
@@ -264,6 +269,7 @@ function areColPropsEqual<T>(prevProps: TableColProps<T>, nextProps: TableColPro
 		if (prevIsDragging !== nextIsDragging) return false;
 	}
 	if (prevProps.filterValue !== nextProps.filterValue) return false;
+	if (prevProps.filterLocalization !== nextProps.filterLocalization) return false;
 	if (prevProps.resizedWidth !== nextProps.resizedWidth) return false;
 	if (prevProps.disabled !== nextProps.disabled) return false;
 	if (prevProps.sortIcon !== nextProps.sortIcon) return false;
diff --git a/src/components/TablePaginationFooter.tsx b/src/components/TablePaginationFooter.tsx
index 2fd7dad9..e13d098c 100644
--- a/src/components/TablePaginationFooter.tsx
+++ b/src/components/TablePaginationFooter.tsx
@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { PaginationComponent, PaginationIcons, PaginationOptions } from '../types';
+import type { PaginationComponent, PaginationIcons, PaginationOptions, Localization } from '../types';
 import { Direction } from '../constants';
 
 interface TablePaginationFooterProps {
@@ -13,6 +13,7 @@ interface TablePaginationFooterProps {
 	paginationRowsPerPageOptions: number[];
 	paginationIcons?: PaginationIcons;
 	paginationComponentOptions: PaginationOptions;
+	localization?: Localization['pagination'];
 	position?: 'top' | 'bottom' | 'both';
 }
 
@@ -27,6 +28,7 @@ function TablePaginationFooter({
 	paginationRowsPerPageOptions,
 	paginationIcons,
 	paginationComponentOptions,
+	localization,
 	position,
 }: TablePaginationFooterProps): JSX.Element {
 	const border = '1px solid var(--rdt-color-divider, rgba(0, 0, 0, 0.12))';
@@ -44,6 +46,7 @@ function TablePaginationFooter({
 				paginationRowsPerPageOptions={paginationRowsPerPageOptions}
 				paginationIcons={paginationIcons}
 				paginationComponentOptions={paginationComponentOptions}
+				localization={localization}
 			/>
 		</div>
 	);
diff --git a/src/components/TableRow.tsx b/src/components/TableRow.tsx
index df3a124d..347e3a5b 100644
--- a/src/components/TableRow.tsx
+++ b/src/components/TableRow.tsx
@@ -43,6 +43,7 @@ function Row<T>({
 		conditionalRowStyles,
 		dense,
 		expandableIcon,
+		localization,
 		expandableRows,
 		expandableRowsComponent,
 		expandableRowsComponentProps,
@@ -273,6 +274,7 @@ function Row<T>({
 					<TableCellExpander
 						id={rowKeyField as string}
 						expandableIcon={expandableIcon}
+						expandableRowsOptions={localization}
 						expanded={expanded}
 						row={row}
 						onToggled={handleExpanded}
diff --git a/src/context/HeadContext.tsx b/src/context/HeadContext.tsx
index deb0bc8c..2e7d1afc 100644
--- a/src/context/HeadContext.tsx
+++ b/src/context/HeadContext.tsx
@@ -1,6 +1,14 @@
 import * as React from 'react';
 import { SortOrder } from '../types';
-import type { TableColumn, SortAction, AllRowsAction, RowState, ComponentProps, FilterState } from '../types';
+import type {
+	TableColumn,
+	SortAction,
+	AllRowsAction,
+	RowState,
+	ComponentProps,
+	FilterState,
+	Localization,
+} from '../types';
 import type { PinnedOffsets } from '../util';
 
 export interface HeadContextValue<T> {
@@ -28,6 +36,7 @@ export interface HeadContextValue<T> {
 	draggingColumnId: string | number;
 	draggingGroupKey: string;
 	filterValues: Record<string | number, FilterState>;
+	localization: NonNullable<Localization['filter']>;
 	columnWidths: Record<string | number, number>;
 	pinnedOffsets: PinnedOffsets;
 	resizable: boolean;
diff --git a/src/context/RowContext.tsx b/src/context/RowContext.tsx
index 321fd9af..8bfc74ec 100644
--- a/src/context/RowContext.tsx
+++ b/src/context/RowContext.tsx
@@ -4,6 +4,7 @@ import type {
 	ConditionalStyles,
 	ExpandableIcon,
 	ExpandableRowsComponent,
+	Localization,
 	RowState,
 	SingleRowAction,
 	RangeRowAction,
@@ -27,6 +28,7 @@ export interface RowContextValue<T> {
 	selectableRowDisabled: RowState<T>;
 	expandableRows: boolean;
 	expandableIcon: ExpandableIcon;
+	localization: NonNullable<Localization['expandable']>;
 	expandableRowsComponent: ExpandableRowsComponent<T> | undefined;
 	expandableRowsComponentProps: ComponentProps | undefined;
 	expandableRowsHideExpander: boolean;
diff --git a/src/hooks/useHeadContextValue.ts b/src/hooks/useHeadContextValue.ts
index ee193f5b..ad13056d 100644
--- a/src/hooks/useHeadContextValue.ts
+++ b/src/hooks/useHeadContextValue.ts
@@ -52,6 +52,7 @@ export default function useHeadContextValue<T>(options: HeadContextValue<T>): He
 			options.onGroupDragEnter,
 			options.onGroupDragOver,
 			options.onGroupDragEnd,
+			options.localization,
 		],
 	);
 }
diff --git a/src/hooks/useRowContextValue.ts b/src/hooks/useRowContextValue.ts
index 47187e64..7a4498e3 100644
--- a/src/hooks/useRowContextValue.ts
+++ b/src/hooks/useRowContextValue.ts
@@ -51,6 +51,7 @@ export default function useRowContextValue<T>(options: RowContextValue<T>): RowC
 			options.columnWidths,
 			options.pinnedOffsets,
 			options.animateRows,
+			options.localization,
 		],
 	);
 }
diff --git a/src/index.ts b/src/index.ts
index d2bdde8f..ee2c39d2 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -34,6 +34,7 @@ export type {
 	ThemeIcons,
 	PaginationOptions,
 	PaginationServerOptions,
+	Localization,
 	SortFunction,
 	Selector,
 	FilterType,
diff --git a/src/locales/ar-EG.ts b/src/locales/ar-EG.ts
new file mode 100644
index 00000000..ee5fc2a5
--- /dev/null
+++ b/src/locales/ar-EG.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const arEG: Localization = {
+	pagination: {
+		navigationAriaLabel: 'التنقل في الجدول',
+		firstPageAriaLabel: 'الصفحة الأولى',
+		previousPageAriaLabel: 'الصفحة اللي فاتت',
+		nextPageAriaLabel: 'الصفحة الجاية',
+		lastPageAriaLabel: 'آخر صفحة',
+	},
+	filter: {
+		filterColumnAriaLabel: 'فلتر العمود',
+		filterActiveAriaLabel: 'الفلتر شغال',
+		filterPanelAriaLabel: 'لوحة الفلتر',
+		operatorAriaLabel: 'نوع الفلتر',
+		valuePlaceholder: 'قيمة',
+		valueAriaLabel: 'قيمة الفلتر',
+		value2Placeholder: 'قيمة',
+		value2AriaLabel: 'القيمة التانية',
+		betweenSeparatorText: 'و',
+		removeConditionAriaLabel: 'شيل الشرط',
+		addConditionAriaLabel: 'ضيف شرط تاني',
+		addConditionLabel: '+ ضيف شرط',
+		clearLabel: 'امسح',
+		applyLabel: 'طبّق',
+		andLabel: 'و',
+		orLabel: 'أو',
+		operators: {
+			contains: 'بيحتوي على',
+			notContains: 'مش بيحتوي على',
+			equals: 'يساوي',
+			notEquals: 'مش يساوي',
+			startsWith: 'بيبدأ بـ',
+			endsWith: 'بينتهي بـ',
+			blank: 'فاضي',
+			notBlank: 'مش فاضي',
+			gt: 'أكبر من',
+			gte: 'أكبر من أو يساوي',
+			lt: 'أصغر من',
+			lte: 'أصغر من أو يساوي',
+			between: 'بين',
+			before: 'قبل',
+			after: 'بعد',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'افتح الصف',
+		collapseRowAriaLabel: 'اقفل الصف',
+	},
+};
+
+export default arEG;
diff --git a/src/locales/ar-LV.ts b/src/locales/ar-LV.ts
new file mode 100644
index 00000000..cb34f9c8
--- /dev/null
+++ b/src/locales/ar-LV.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const arLV: Localization = {
+	pagination: {
+		navigationAriaLabel: 'التنقل بالجدول',
+		firstPageAriaLabel: 'أول صفحة',
+		previousPageAriaLabel: 'الصفحة اللي قبل',
+		nextPageAriaLabel: 'الصفحة الجاية',
+		lastPageAriaLabel: 'آخر صفحة',
+	},
+	filter: {
+		filterColumnAriaLabel: 'فلتر العمود',
+		filterActiveAriaLabel: 'الفلتر فعّال',
+		filterPanelAriaLabel: 'لوحة الفلتر',
+		operatorAriaLabel: 'نوع الفلتر',
+		valuePlaceholder: 'قيمة',
+		valueAriaLabel: 'قيمة الفلتر',
+		value2Placeholder: 'قيمة',
+		value2AriaLabel: 'القيمة التانية',
+		betweenSeparatorText: 'و',
+		removeConditionAriaLabel: 'شيل الشرط',
+		addConditionAriaLabel: 'ضيف شرط تاني',
+		addConditionLabel: '+ ضيف شرط',
+		clearLabel: 'امسح',
+		applyLabel: 'طبّق',
+		andLabel: 'و',
+		orLabel: 'أو',
+		operators: {
+			contains: 'بيحتوي على',
+			notContains: 'ما بيحتوي على',
+			equals: 'يساوي',
+			notEquals: 'ما بيساوي',
+			startsWith: 'بيبلش بـ',
+			endsWith: 'بينتهي بـ',
+			blank: 'فاضي',
+			notBlank: 'مش فاضي',
+			gt: 'أكبر من',
+			gte: 'أكبر من أو يساوي',
+			lt: 'أصغر من',
+			lte: 'أصغر من أو يساوي',
+			between: 'بين',
+			before: 'قبل',
+			after: 'بعد',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'بسّط الصف',
+		collapseRowAriaLabel: 'اطوي الصف',
+	},
+};
+
+export default arLV;
diff --git a/src/locales/ar.ts b/src/locales/ar.ts
new file mode 100644
index 00000000..62d481ce
--- /dev/null
+++ b/src/locales/ar.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const ar: Localization = {
+	pagination: {
+		navigationAriaLabel: 'التنقل بين صفحات الجدول',
+		firstPageAriaLabel: 'الصفحة الأولى',
+		previousPageAriaLabel: 'الصفحة السابقة',
+		nextPageAriaLabel: 'الصفحة التالية',
+		lastPageAriaLabel: 'الصفحة الأخيرة',
+	},
+	filter: {
+		filterColumnAriaLabel: 'تصفية العمود',
+		filterActiveAriaLabel: 'التصفية نشطة',
+		filterPanelAriaLabel: 'لوحة التصفية',
+		operatorAriaLabel: 'عامل التصفية',
+		valuePlaceholder: 'قيمة',
+		valueAriaLabel: 'قيمة التصفية',
+		value2Placeholder: 'قيمة',
+		value2AriaLabel: 'قيمة التصفية الثانية',
+		betweenSeparatorText: 'و',
+		removeConditionAriaLabel: 'إزالة الشرط',
+		addConditionAriaLabel: 'إضافة شرط ثانٍ',
+		addConditionLabel: '+ إضافة شرط',
+		clearLabel: 'مسح',
+		applyLabel: 'تطبيق',
+		andLabel: 'و',
+		orLabel: 'أو',
+		operators: {
+			contains: 'يحتوي على',
+			notContains: 'لا يحتوي على',
+			equals: 'يساوي',
+			notEquals: 'لا يساوي',
+			startsWith: 'يبدأ بـ',
+			endsWith: 'ينتهي بـ',
+			blank: 'فارغ',
+			notBlank: 'غير فارغ',
+			gt: 'أكبر من',
+			gte: 'أكبر من أو يساوي',
+			lt: 'أصغر من',
+			lte: 'أصغر من أو يساوي',
+			between: 'بين',
+			before: 'قبل',
+			after: 'بعد',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'توسيع الصف',
+		collapseRowAriaLabel: 'طي الصف',
+	},
+};
+
+export default ar;
diff --git a/src/locales/de.ts b/src/locales/de.ts
new file mode 100644
index 00000000..30a54082
--- /dev/null
+++ b/src/locales/de.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const de: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Tabellen-Paginierung',
+		firstPageAriaLabel: 'Erste Seite',
+		previousPageAriaLabel: 'Vorherige Seite',
+		nextPageAriaLabel: 'Nächste Seite',
+		lastPageAriaLabel: 'Letzte Seite',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Spalte filtern',
+		filterActiveAriaLabel: 'Filter aktiv',
+		filterPanelAriaLabel: 'Filterbereich',
+		operatorAriaLabel: 'Filteroperator',
+		valuePlaceholder: 'Wert',
+		valueAriaLabel: 'Filterwert',
+		value2Placeholder: 'Wert',
+		value2AriaLabel: 'Zweiter Filterwert',
+		betweenSeparatorText: 'und',
+		removeConditionAriaLabel: 'Bedingung entfernen',
+		addConditionAriaLabel: 'Zweite Bedingung hinzufügen',
+		addConditionLabel: '+ Bedingung hinzufügen',
+		clearLabel: 'Zurücksetzen',
+		applyLabel: 'Anwenden',
+		andLabel: 'UND',
+		orLabel: 'ODER',
+		operators: {
+			contains: 'Enthält',
+			notContains: 'Enthält nicht',
+			equals: 'Gleich',
+			notEquals: 'Ungleich',
+			startsWith: 'Beginnt mit',
+			endsWith: 'Endet mit',
+			blank: 'Leer',
+			notBlank: 'Nicht leer',
+			gt: 'Größer als',
+			gte: 'Größer oder gleich',
+			lt: 'Kleiner als',
+			lte: 'Kleiner oder gleich',
+			between: 'Zwischen',
+			before: 'Vor',
+			after: 'Nach',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Zeile aufklappen',
+		collapseRowAriaLabel: 'Zeile zuklappen',
+	},
+};
+
+export default de;
diff --git a/src/locales/en.ts b/src/locales/en.ts
new file mode 100644
index 00000000..f54ad5a9
--- /dev/null
+++ b/src/locales/en.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const en: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Table pagination',
+		firstPageAriaLabel: 'First Page',
+		previousPageAriaLabel: 'Previous Page',
+		nextPageAriaLabel: 'Next Page',
+		lastPageAriaLabel: 'Last Page',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Filter column',
+		filterActiveAriaLabel: 'Filter active',
+		filterPanelAriaLabel: 'Column filter',
+		operatorAriaLabel: 'Filter operator',
+		valuePlaceholder: 'Value',
+		valueAriaLabel: 'Filter value',
+		value2Placeholder: 'Value',
+		value2AriaLabel: 'Filter second value',
+		betweenSeparatorText: 'and',
+		removeConditionAriaLabel: 'Remove condition',
+		addConditionAriaLabel: 'Add a second filter condition',
+		addConditionLabel: '+ Add condition',
+		clearLabel: 'Clear',
+		applyLabel: 'Apply',
+		andLabel: 'AND',
+		orLabel: 'OR',
+		operators: {
+			contains: 'Contains',
+			notContains: 'Does not contain',
+			equals: 'Equals',
+			notEquals: 'Does not equal',
+			startsWith: 'Begins with',
+			endsWith: 'Ends with',
+			blank: 'Blank',
+			notBlank: 'Not blank',
+			gt: 'Greater than',
+			gte: 'Greater than or equal',
+			lt: 'Less than',
+			lte: 'Less than or equal',
+			between: 'Between',
+			before: 'Before',
+			after: 'After',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Expand Row',
+		collapseRowAriaLabel: 'Collapse Row',
+	},
+};
+
+export default en;
diff --git a/src/locales/es.ts b/src/locales/es.ts
new file mode 100644
index 00000000..5f29ccc4
--- /dev/null
+++ b/src/locales/es.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const es: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Paginación de la tabla',
+		firstPageAriaLabel: 'Primera página',
+		previousPageAriaLabel: 'Página anterior',
+		nextPageAriaLabel: 'Página siguiente',
+		lastPageAriaLabel: 'Última página',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Filtrar columna',
+		filterActiveAriaLabel: 'Filtro activo',
+		filterPanelAriaLabel: 'Panel de filtro',
+		operatorAriaLabel: 'Operador de filtro',
+		valuePlaceholder: 'Valor',
+		valueAriaLabel: 'Valor del filtro',
+		value2Placeholder: 'Valor',
+		value2AriaLabel: 'Segundo valor del filtro',
+		betweenSeparatorText: 'y',
+		removeConditionAriaLabel: 'Eliminar condición',
+		addConditionAriaLabel: 'Agregar una segunda condición',
+		addConditionLabel: '+ Agregar condición',
+		clearLabel: 'Limpiar',
+		applyLabel: 'Aplicar',
+		andLabel: 'Y',
+		orLabel: 'O',
+		operators: {
+			contains: 'Contiene',
+			notContains: 'No contiene',
+			equals: 'Igual a',
+			notEquals: 'Diferente de',
+			startsWith: 'Comienza con',
+			endsWith: 'Termina con',
+			blank: 'Vacío',
+			notBlank: 'No vacío',
+			gt: 'Mayor que',
+			gte: 'Mayor o igual que',
+			lt: 'Menor que',
+			lte: 'Menor o igual que',
+			between: 'Entre',
+			before: 'Antes de',
+			after: 'Después de',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Expandir fila',
+		collapseRowAriaLabel: 'Contraer fila',
+	},
+};
+
+export default es;
diff --git a/src/locales/fr.ts b/src/locales/fr.ts
new file mode 100644
index 00000000..4990c292
--- /dev/null
+++ b/src/locales/fr.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const fr: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Pagination du tableau',
+		firstPageAriaLabel: 'Première page',
+		previousPageAriaLabel: 'Page précédente',
+		nextPageAriaLabel: 'Page suivante',
+		lastPageAriaLabel: 'Dernière page',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Filtrer la colonne',
+		filterActiveAriaLabel: 'Filtre actif',
+		filterPanelAriaLabel: 'Panneau de filtre',
+		operatorAriaLabel: 'Opérateur de filtre',
+		valuePlaceholder: 'Valeur',
+		valueAriaLabel: 'Valeur du filtre',
+		value2Placeholder: 'Valeur',
+		value2AriaLabel: 'Deuxième valeur du filtre',
+		betweenSeparatorText: 'et',
+		removeConditionAriaLabel: 'Supprimer la condition',
+		addConditionAriaLabel: 'Ajouter une deuxième condition',
+		addConditionLabel: '+ Ajouter une condition',
+		clearLabel: 'Effacer',
+		applyLabel: 'Appliquer',
+		andLabel: 'ET',
+		orLabel: 'OU',
+		operators: {
+			contains: 'Contient',
+			notContains: 'Ne contient pas',
+			equals: 'Égal à',
+			notEquals: 'Différent de',
+			startsWith: 'Commence par',
+			endsWith: 'Se termine par',
+			blank: 'Vide',
+			notBlank: 'Non vide',
+			gt: 'Supérieur à',
+			gte: 'Supérieur ou égal à',
+			lt: 'Inférieur à',
+			lte: 'Inférieur ou égal à',
+			between: 'Entre',
+			before: 'Avant',
+			after: 'Après',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Développer la ligne',
+		collapseRowAriaLabel: 'Réduire la ligne',
+	},
+};
+
+export default fr;
diff --git a/src/locales/he.ts b/src/locales/he.ts
new file mode 100644
index 00000000..860cdc02
--- /dev/null
+++ b/src/locales/he.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const he: Localization = {
+	pagination: {
+		navigationAriaLabel: 'ניווט בין דפי הטבלה',
+		firstPageAriaLabel: 'עמוד ראשון',
+		previousPageAriaLabel: 'עמוד קודם',
+		nextPageAriaLabel: 'עמוד הבא',
+		lastPageAriaLabel: 'עמוד אחרון',
+	},
+	filter: {
+		filterColumnAriaLabel: 'סינון עמודה',
+		filterActiveAriaLabel: 'סינון פעיל',
+		filterPanelAriaLabel: 'לוח סינון',
+		operatorAriaLabel: 'אופרטור סינון',
+		valuePlaceholder: 'ערך',
+		valueAriaLabel: 'ערך סינון',
+		value2Placeholder: 'ערך',
+		value2AriaLabel: 'ערך סינון שני',
+		betweenSeparatorText: 'ו',
+		removeConditionAriaLabel: 'הסר תנאי',
+		addConditionAriaLabel: 'הוסף תנאי שני',
+		addConditionLabel: '+ הוסף תנאי',
+		clearLabel: 'נקה',
+		applyLabel: 'החל',
+		andLabel: 'וגם',
+		orLabel: 'או',
+		operators: {
+			contains: 'מכיל',
+			notContains: 'אינו מכיל',
+			equals: 'שווה ל',
+			notEquals: 'אינו שווה ל',
+			startsWith: 'מתחיל ב',
+			endsWith: 'מסתיים ב',
+			blank: 'ריק',
+			notBlank: 'אינו ריק',
+			gt: 'גדול מ',
+			gte: 'גדול מ או שווה ל',
+			lt: 'קטן מ',
+			lte: 'קטן מ או שווה ל',
+			between: 'בין',
+			before: 'לפני',
+			after: 'אחרי',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'הרחב שורה',
+		collapseRowAriaLabel: 'כווץ שורה',
+	},
+};
+
+export default he;
diff --git a/src/locales/index.ts b/src/locales/index.ts
new file mode 100644
index 00000000..014cc9db
--- /dev/null
+++ b/src/locales/index.ts
@@ -0,0 +1,14 @@
+export { default as en } from './en';
+export { default as fr } from './fr';
+export { default as es } from './es';
+export { default as de } from './de';
+export { default as ptBR } from './pt-BR';
+export { default as ar } from './ar';
+export { default as he } from './he';
+export { default as arEG } from './ar-EG';
+export { default as arLV } from './ar-LV';
+export { default as zhCN } from './zh-CN';
+export { default as zhTW } from './zh-TW';
+export { default as ja } from './ja';
+export { default as ko } from './ko';
+export { default as uk } from './uk';
diff --git a/src/locales/ja.ts b/src/locales/ja.ts
new file mode 100644
index 00000000..ae0e69a5
--- /dev/null
+++ b/src/locales/ja.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const ja: Localization = {
+	pagination: {
+		navigationAriaLabel: 'テーブルのページネーション',
+		firstPageAriaLabel: '最初のページ',
+		previousPageAriaLabel: '前のページ',
+		nextPageAriaLabel: '次のページ',
+		lastPageAriaLabel: '最後のページ',
+	},
+	filter: {
+		filterColumnAriaLabel: '列をフィルター',
+		filterActiveAriaLabel: 'フィルター適用中',
+		filterPanelAriaLabel: 'フィルターパネル',
+		operatorAriaLabel: 'フィルター演算子',
+		valuePlaceholder: '値',
+		valueAriaLabel: 'フィルター値',
+		value2Placeholder: '値',
+		value2AriaLabel: '2番目のフィルター値',
+		betweenSeparatorText: 'から',
+		removeConditionAriaLabel: '条件を削除',
+		addConditionAriaLabel: '2番目の条件を追加',
+		addConditionLabel: '+ 条件を追加',
+		clearLabel: 'クリア',
+		applyLabel: '適用',
+		andLabel: 'かつ',
+		orLabel: 'または',
+		operators: {
+			contains: '含む',
+			notContains: '含まない',
+			equals: '等しい',
+			notEquals: '等しくない',
+			startsWith: 'で始まる',
+			endsWith: 'で終わる',
+			blank: '空白',
+			notBlank: '空白でない',
+			gt: 'より大きい',
+			gte: '以上',
+			lt: 'より小さい',
+			lte: '以下',
+			between: 'の間',
+			before: '以前',
+			after: '以降',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: '行を展開',
+		collapseRowAriaLabel: '行を折りたたむ',
+	},
+};
+
+export default ja;
diff --git a/src/locales/ko.ts b/src/locales/ko.ts
new file mode 100644
index 00000000..d1c08509
--- /dev/null
+++ b/src/locales/ko.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const ko: Localization = {
+	pagination: {
+		navigationAriaLabel: '테이블 페이지 탐색',
+		firstPageAriaLabel: '첫 번째 페이지',
+		previousPageAriaLabel: '이전 페이지',
+		nextPageAriaLabel: '다음 페이지',
+		lastPageAriaLabel: '마지막 페이지',
+	},
+	filter: {
+		filterColumnAriaLabel: '열 필터',
+		filterActiveAriaLabel: '필터 활성화됨',
+		filterPanelAriaLabel: '필터 패널',
+		operatorAriaLabel: '필터 연산자',
+		valuePlaceholder: '값',
+		valueAriaLabel: '필터 값',
+		value2Placeholder: '값',
+		value2AriaLabel: '두 번째 필터 값',
+		betweenSeparatorText: '및',
+		removeConditionAriaLabel: '조건 제거',
+		addConditionAriaLabel: '두 번째 조건 추가',
+		addConditionLabel: '+ 조건 추가',
+		clearLabel: '초기화',
+		applyLabel: '적용',
+		andLabel: '그리고',
+		orLabel: '또는',
+		operators: {
+			contains: '포함',
+			notContains: '포함하지 않음',
+			equals: '같음',
+			notEquals: '같지 않음',
+			startsWith: '시작 문자',
+			endsWith: '끝 문자',
+			blank: '비어 있음',
+			notBlank: '비어 있지 않음',
+			gt: '초과',
+			gte: '이상',
+			lt: '미만',
+			lte: '이하',
+			between: '사이',
+			before: '이전',
+			after: '이후',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: '행 펼치기',
+		collapseRowAriaLabel: '행 접기',
+	},
+};
+
+export default ko;
diff --git a/src/locales/pt-BR.ts b/src/locales/pt-BR.ts
new file mode 100644
index 00000000..58ae2b90
--- /dev/null
+++ b/src/locales/pt-BR.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const ptBR: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Paginação da tabela',
+		firstPageAriaLabel: 'Primeira página',
+		previousPageAriaLabel: 'Página anterior',
+		nextPageAriaLabel: 'Próxima página',
+		lastPageAriaLabel: 'Última página',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Filtrar coluna',
+		filterActiveAriaLabel: 'Filtro ativo',
+		filterPanelAriaLabel: 'Painel de filtro',
+		operatorAriaLabel: 'Operador de filtro',
+		valuePlaceholder: 'Valor',
+		valueAriaLabel: 'Valor do filtro',
+		value2Placeholder: 'Valor',
+		value2AriaLabel: 'Segundo valor do filtro',
+		betweenSeparatorText: 'e',
+		removeConditionAriaLabel: 'Remover condição',
+		addConditionAriaLabel: 'Adicionar segunda condição',
+		addConditionLabel: '+ Adicionar condição',
+		clearLabel: 'Limpar',
+		applyLabel: 'Aplicar',
+		andLabel: 'E',
+		orLabel: 'OU',
+		operators: {
+			contains: 'Contém',
+			notContains: 'Não contém',
+			equals: 'Igual a',
+			notEquals: 'Diferente de',
+			startsWith: 'Começa com',
+			endsWith: 'Termina com',
+			blank: 'Vazio',
+			notBlank: 'Não vazio',
+			gt: 'Maior que',
+			gte: 'Maior ou igual a',
+			lt: 'Menor que',
+			lte: 'Menor ou igual a',
+			between: 'Entre',
+			before: 'Antes de',
+			after: 'Depois de',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Expandir linha',
+		collapseRowAriaLabel: 'Recolher linha',
+	},
+};
+
+export default ptBR;
diff --git a/src/locales/uk.ts b/src/locales/uk.ts
new file mode 100644
index 00000000..628c5232
--- /dev/null
+++ b/src/locales/uk.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const uk: Localization = {
+	pagination: {
+		navigationAriaLabel: 'Навігація по сторінках таблиці',
+		firstPageAriaLabel: 'Перша сторінка',
+		previousPageAriaLabel: 'Попередня сторінка',
+		nextPageAriaLabel: 'Наступна сторінка',
+		lastPageAriaLabel: 'Остання сторінка',
+	},
+	filter: {
+		filterColumnAriaLabel: 'Фільтр стовпця',
+		filterActiveAriaLabel: 'Фільтр активний',
+		filterPanelAriaLabel: 'Панель фільтрів',
+		operatorAriaLabel: 'Оператор фільтра',
+		valuePlaceholder: 'Значення',
+		valueAriaLabel: 'Значення фільтра',
+		value2Placeholder: 'Значення',
+		value2AriaLabel: 'Друге значення фільтра',
+		betweenSeparatorText: 'і',
+		removeConditionAriaLabel: 'Видалити умову',
+		addConditionAriaLabel: 'Додати другу умову',
+		addConditionLabel: '+ Додати умову',
+		clearLabel: 'Очистити',
+		applyLabel: 'Застосувати',
+		andLabel: 'І',
+		orLabel: 'АБО',
+		operators: {
+			contains: 'Містить',
+			notContains: 'Не містить',
+			equals: 'Дорівнює',
+			notEquals: 'Не дорівнює',
+			startsWith: 'Починається з',
+			endsWith: 'Закінчується на',
+			blank: 'Порожньо',
+			notBlank: 'Не порожньо',
+			gt: 'Більше ніж',
+			gte: 'Більше або дорівнює',
+			lt: 'Менше ніж',
+			lte: 'Менше або дорівнює',
+			between: 'Між',
+			before: 'До',
+			after: 'Після',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: 'Розгорнути рядок',
+		collapseRowAriaLabel: 'Згорнути рядок',
+	},
+};
+
+export default uk;
diff --git a/src/locales/zh-CN.ts b/src/locales/zh-CN.ts
new file mode 100644
index 00000000..66f8b63f
--- /dev/null
+++ b/src/locales/zh-CN.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const zhCN: Localization = {
+	pagination: {
+		navigationAriaLabel: '表格分页',
+		firstPageAriaLabel: '第一页',
+		previousPageAriaLabel: '上一页',
+		nextPageAriaLabel: '下一页',
+		lastPageAriaLabel: '最后一页',
+	},
+	filter: {
+		filterColumnAriaLabel: '筛选列',
+		filterActiveAriaLabel: '筛选已激活',
+		filterPanelAriaLabel: '筛选面板',
+		operatorAriaLabel: '筛选运算符',
+		valuePlaceholder: '值',
+		valueAriaLabel: '筛选值',
+		value2Placeholder: '值',
+		value2AriaLabel: '第二筛选值',
+		betweenSeparatorText: '和',
+		removeConditionAriaLabel: '删除条件',
+		addConditionAriaLabel: '添加第二个条件',
+		addConditionLabel: '+ 添加条件',
+		clearLabel: '清除',
+		applyLabel: '应用',
+		andLabel: '且',
+		orLabel: '或',
+		operators: {
+			contains: '包含',
+			notContains: '不包含',
+			equals: '等于',
+			notEquals: '不等于',
+			startsWith: '开头为',
+			endsWith: '结尾为',
+			blank: '为空',
+			notBlank: '不为空',
+			gt: '大于',
+			gte: '大于或等于',
+			lt: '小于',
+			lte: '小于或等于',
+			between: '介于',
+			before: '早于',
+			after: '晚于',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: '展开行',
+		collapseRowAriaLabel: '收起行',
+	},
+};
+
+export default zhCN;
diff --git a/src/locales/zh-TW.ts b/src/locales/zh-TW.ts
new file mode 100644
index 00000000..270a9811
--- /dev/null
+++ b/src/locales/zh-TW.ts
@@ -0,0 +1,52 @@
+import type { Localization } from '../types';
+
+const zhTW: Localization = {
+	pagination: {
+		navigationAriaLabel: '表格分頁',
+		firstPageAriaLabel: '第一頁',
+		previousPageAriaLabel: '上一頁',
+		nextPageAriaLabel: '下一頁',
+		lastPageAriaLabel: '最後一頁',
+	},
+	filter: {
+		filterColumnAriaLabel: '篩選欄位',
+		filterActiveAriaLabel: '篩選已啟用',
+		filterPanelAriaLabel: '篩選面板',
+		operatorAriaLabel: '篩選運算子',
+		valuePlaceholder: '值',
+		valueAriaLabel: '篩選值',
+		value2Placeholder: '值',
+		value2AriaLabel: '第二篩選值',
+		betweenSeparatorText: '和',
+		removeConditionAriaLabel: '移除條件',
+		addConditionAriaLabel: '新增第二個條件',
+		addConditionLabel: '+ 新增條件',
+		clearLabel: '清除',
+		applyLabel: '套用',
+		andLabel: '且',
+		orLabel: '或',
+		operators: {
+			contains: '包含',
+			notContains: '不包含',
+			equals: '等於',
+			notEquals: '不等於',
+			startsWith: '開頭為',
+			endsWith: '結尾為',
+			blank: '為空',
+			notBlank: '不為空',
+			gt: '大於',
+			gte: '大於或等於',
+			lt: '小於',
+			lte: '小於或等於',
+			between: '介於',
+			before: '早於',
+			after: '晚於',
+		},
+	},
+	expandable: {
+		expandRowAriaLabel: '展開列',
+		collapseRowAriaLabel: '收合列',
+	},
+};
+
+export default zhTW;
diff --git a/src/types.ts b/src/types.ts
index 60b3aedb..7d7cc77d 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -1,3 +1,4 @@
+import type React from 'react';
 import { Alignment, Direction, Media } from './constants';
 
 export type CSSObject = React.CSSProperties;
@@ -65,6 +66,7 @@ export type PaginationComponentProps = {
 	paginationRowsPerPageOptions?: number[];
 	paginationIcons?: PaginationIcons;
 	paginationComponentOptions?: PaginationOptions;
+	localization?: Localization['pagination'];
 };
 export type PaginationComponent = React.ComponentType<PaginationComponentProps>;
 
@@ -242,6 +244,8 @@ type BaseTableProps<T> = {
 	filterValues?: Record<string | number, FilterState>;
 	/** Called when the user clicks Apply in a column filter popup. */
 	onFilterChange?: (columnId: string | number, filter: FilterState) => void;
+	/** Override every user-visible string in DataTable. Pass a pre-built locale or build your own. */
+	localization?: Localization;
 	onColumnOrderChange?: (nextOrder: TableColumn<T>[]) => void;
 	/** Called after a group drag reorder with the new group order and matching column order. */
 	onColumnGroupOrderChange?: (nextGroups: ColumnGroup[], nextColumns: TableColumn<T>[]) => void;
@@ -478,6 +482,80 @@ export interface PaginationOptions {
 	selectAllRowsItemText?: string;
 }
 
+/** All user-visible strings rendered by DataTable, grouped by feature area. */
+export interface Localization {
+	pagination?: {
+		/** aria-label for the pagination nav element. Default: "Table pagination" */
+		navigationAriaLabel?: string;
+		/** aria-label for the First Page button. Default: "First Page" */
+		firstPageAriaLabel?: string;
+		/** aria-label for the Previous Page button. Default: "Previous Page" */
+		previousPageAriaLabel?: string;
+		/** aria-label for the Next Page button. Default: "Next Page" */
+		nextPageAriaLabel?: string;
+		/** aria-label for the Last Page button. Default: "Last Page" */
+		lastPageAriaLabel?: string;
+	};
+	filter?: {
+		/** aria-label for the filter icon button when no filter is active. Default: "Filter column" */
+		filterColumnAriaLabel?: string;
+		/** aria-label for the filter icon button when a filter is active. Default: "Filter active" */
+		filterActiveAriaLabel?: string;
+		/** aria-label for the filter panel dialog. Default: "Column filter" */
+		filterPanelAriaLabel?: string;
+		/** aria-label for the operator select element. Default: "Filter operator" */
+		operatorAriaLabel?: string;
+		/** Placeholder for the first value input. Default: "Value" */
+		valuePlaceholder?: string;
+		/** aria-label for the first value input. Default: "Filter value" */
+		valueAriaLabel?: string;
+		/** Placeholder for the second value input. Default: "Value" */
+		value2Placeholder?: string;
+		/** aria-label for the second value input (between operator). Default: "Filter second value" */
+		value2AriaLabel?: string;
+		/** Separator text between the two inputs for the "between" operator. Default: "and" */
+		betweenSeparatorText?: string;
+		/** aria-label for the remove-condition button. Default: "Remove condition" */
+		removeConditionAriaLabel?: string;
+		/** aria-label for the add-condition button. Default: "Add a second filter condition" */
+		addConditionAriaLabel?: string;
+		/** Label for the add-condition button. Default: "+ Add condition" */
+		addConditionLabel?: string;
+		/** Label for the Clear button. Default: "Clear" */
+		clearLabel?: string;
+		/** Label for the Apply button. Default: "Apply" */
+		applyLabel?: string;
+		/** Label for the AND logic button. Default: "AND" */
+		andLabel?: string;
+		/** Label for the OR logic button. Default: "OR" */
+		orLabel?: string;
+		/** Labels for filter operators. */
+		operators?: {
+			contains?: string;
+			notContains?: string;
+			equals?: string;
+			notEquals?: string;
+			startsWith?: string;
+			endsWith?: string;
+			blank?: string;
+			notBlank?: string;
+			gt?: string;
+			gte?: string;
+			lt?: string;
+			lte?: string;
+			between?: string;
+			before?: string;
+			after?: string;
+		};
+	};
+	expandable?: {
+		/** aria-label for the expand button. Default: "Expand Row" */
+		expandRowAriaLabel?: string;
+		/** aria-label for the collapse button. Default: "Collapse Row" */
+		collapseRowAriaLabel?: string;
+	};
+}
+
 export interface PaginationServerOptions {
 	persistSelectedOnSort?: boolean;
 	persistSelectedOnPageChange?: boolean;
diff --git a/tsup.config.ts b/tsup.config.ts
index 3d33db0b..85901ddd 100644
--- a/tsup.config.ts
+++ b/tsup.config.ts
@@ -16,6 +16,16 @@ export default defineConfig([
 		minify: true,
 		onSuccess: 'node scripts/use-client-banner.mjs',
 	},
+	// Locales bundle — pure data, no React, no CSS.
+	{
+		entry: { 'locales/index': 'src/locales/index.ts' },
+		format: ['esm', 'cjs'],
+		dts: true,
+		sourcemap: true,
+		external: ['react', 'react-dom'],
+		treeshake: true,
+		minify: true,
+	},
 	// CSS-only build — emits dist/DataTable.css for SSR consumers (e.g. Next.js App Router)
 	// that need to import the stylesheet explicitly in a layout to avoid FOUC.
 	{
diff --git a/vitest.config.ts b/vitest.config.ts
index 79cf84b7..7d9b013b 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -11,7 +11,7 @@ export default defineConfig({
 		coverage: {
 			provider: 'v8',
 			include: ['src/**/*.{ts,tsx}'],
-			exclude: ['src/**/__tests__/**', 'src/index.ts'],
+			exclude: ['src/**/__tests__/**', 'src/index.ts', 'src/locales/**'],
 			thresholds: {
 				branches: 80,
 				functions: 80,

From 4285b66cd32172bc53f879eaccf87f5f56c81d48 Mon Sep 17 00:00:00 2001
From: John Betancur <1385932+jbetancur@users.noreply.github.com>
Date: Wed, 20 May 2026 20:15:05 -0400
Subject: [PATCH 2/3] feat: add localization support and deprecate old props in
 DataTable (#1323)

---
 apps/docs/package-lock.json              | 34 ++++++++++++++--
 apps/docs/package.json                   |  1 +
 apps/docs/src/pages/docs/api.md          |  8 ++++
 apps/docs/src/pages/docs/changelog.astro | 50 ++++++++++++++++++++++++
 src/components/DataTable.tsx             | 10 ++++-
 src/index.ts                             |  4 ++
 src/types.ts                             | 18 +++++++++
 7 files changed, 120 insertions(+), 5 deletions(-)

diff --git a/apps/docs/package-lock.json b/apps/docs/package-lock.json
index 651f4fc9..de6b984b 100644
--- a/apps/docs/package-lock.json
+++ b/apps/docs/package-lock.json
@@ -10,6 +10,7 @@
       "dependencies": {
         "@astrojs/react": "^4.2.0",
         "@astrojs/tailwind": "^5.1.4",
+        "@shikijs/langs": "^4.1.0",
         "astro": "^5.7.0",
         "react": "^18.3.1",
         "react-data-table-component": "*",
@@ -1989,12 +1990,28 @@
       }
     },
     "node_modules/@shikijs/langs": {
-      "version": "3.23.0",
-      "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-3.23.0.tgz",
-      "integrity": "sha512-2Ep4W3Re5aB1/62RSYQInK9mM3HsLeB91cHqznAJMuylqjzNVAVCMnNWRHFtcNHXsoNRayP9z1qj4Sq3nMqYXg==",
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-4.1.0.tgz",
+      "integrity": "sha512-nwOMruEkbgdZfQ/b8CgpNBVOpvG1k0N5tbmgiFeqsan401+x3ILqlzZJowSla4Agmq4hG2Uf2wh5jLTEhR8VSg==",
       "license": "MIT",
       "dependencies": {
-        "@shikijs/types": "3.23.0"
+        "@shikijs/types": "4.1.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@shikijs/langs/node_modules/@shikijs/types": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-4.1.0.tgz",
+      "integrity": "sha512-3EQWX54fMpniOrDblzAhiwiJwpiTMW6+B9DWyUd9ska483tbayFYuw47UxwuPknI31bKnySfVQ/QW+jFL4rFdA==",
+      "license": "MIT",
+      "dependencies": {
+        "@shikijs/vscode-textmate": "^10.0.2",
+        "@types/hast": "^3.0.4"
+      },
+      "engines": {
+        "node": ">=20"
       }
     },
     "node_modules/@shikijs/themes": {
@@ -6143,6 +6160,15 @@
         "@types/hast": "^3.0.4"
       }
     },
+    "node_modules/shiki/node_modules/@shikijs/langs": {
+      "version": "3.23.0",
+      "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-3.23.0.tgz",
+      "integrity": "sha512-2Ep4W3Re5aB1/62RSYQInK9mM3HsLeB91cHqznAJMuylqjzNVAVCMnNWRHFtcNHXsoNRayP9z1qj4Sq3nMqYXg==",
+      "license": "MIT",
+      "dependencies": {
+        "@shikijs/types": "3.23.0"
+      }
+    },
     "node_modules/sisteransi": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
diff --git a/apps/docs/package.json b/apps/docs/package.json
index 4dbaebb3..4217ad81 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -11,6 +11,7 @@
   "dependencies": {
     "@astrojs/react": "^4.2.0",
     "@astrojs/tailwind": "^5.1.4",
+    "@shikijs/langs": "^4.1.0",
     "astro": "^5.7.0",
     "react": "^18.3.1",
     "react-data-table-component": "*",
diff --git a/apps/docs/src/pages/docs/api.md b/apps/docs/src/pages/docs/api.md
index b1c518eb..eb2ad88f 100644
--- a/apps/docs/src/pages/docs/api.md
+++ b/apps/docs/src/pages/docs/api.md
@@ -165,6 +165,14 @@ Column-level footers live on each [`TableColumn<T>`](#tablecolumnt) as the `foot
 | `onColumnOrderChange` | `(columns: TableColumn<T>[]) => void` | - | Called after a drag-to-reorder column operation with the new column order. |
 | `onColumnGroupOrderChange` | `(groups: ColumnGroup[], columns: TableColumn<T>[]) => void` | - | Called after a group drag-reorder with the new group order and the matching updated column order. |
 
+### Localization
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `localization` | `Localization` | - | Override every user-visible string and aria-label in the table. Pass a pre-built locale or build your own. See [Localization](/docs/localization). |
+| ~~`columnFilterOptions`~~ | `ColumnFilterOptions` | - | **Deprecated.** Use `localization={{ filter: { ... } }}` instead. Will be removed in v9. |
+| ~~`expandableRowsOptions`~~ | `ExpandableRowsOptions` | - | **Deprecated.** Use `localization={{ expandable: { ... } }}` instead. Will be removed in v9. |
+
 ## ColumnGroup
 
 Defines a spanning group header above one or more columns. Pass an array to the `columnGroups` prop.
diff --git a/apps/docs/src/pages/docs/changelog.astro b/apps/docs/src/pages/docs/changelog.astro
index 61d80de5..4f1a286c 100644
--- a/apps/docs/src/pages/docs/changelog.astro
+++ b/apps/docs/src/pages/docs/changelog.astro
@@ -11,6 +11,56 @@ import CodeBlock from '../../components/CodeBlock.astro';
     <a href="https://github.com/jbetancur/react-data-table-component/commits/master" target="_blank" rel="noreferrer">repository on GitHub</a>.
   </p>
 
+  <h2>8.3.0</h2>
+
+  <h3>New features</h3>
+  <ul>
+    <li>
+      <strong>Localization</strong> — new <code>localization</code> prop on <code>DataTable</code>
+      replaces the three separate option props (<code>columnFilterOptions</code>,
+      <code>expandableRowsOptions</code>, and pagination aria-label fields on
+      <code>paginationComponentOptions</code>). Pass a single object to translate every string and
+      aria-label in the table — filter panel, pagination navigation, and expand/collapse buttons.
+      → <a href="/docs/localization">Localization docs</a>
+    </li>
+    <li>
+      <strong>Built-in locales</strong> — import pre-built translations from the
+      <code>react-data-table-component/locales</code> subpath. Ships with:
+      English (<code>en</code>), French (<code>fr</code>), Spanish (<code>es</code>),
+      German (<code>de</code>), Brazilian Portuguese (<code>ptBR</code>),
+      Arabic — Modern Standard (<code>ar</code>), Egyptian (<code>arEG</code>), Levantine (<code>arLV</code>),
+      Hebrew (<code>he</code>),
+      Chinese Simplified (<code>zhCN</code>), Chinese Traditional (<code>zhTW</code>),
+      Japanese (<code>ja</code>), Korean (<code>ko</code>), Ukrainian (<code>uk</code>).
+      Each locale is individually tree-shakeable.
+    </li>
+    <li>
+      New utility exports: <code>emptyFilterState(type)</code> and <code>isFilterActive(filter)</code>.
+      → <a href="/docs/filtering#utility-exports">Filtering docs</a>
+    </li>
+  </ul>
+
+  <h3>Deprecations</h3>
+  <p>The following will continue to work in 8.x but will be removed in v9. TypeScript will show a deprecation hint.</p>
+  <ul>
+    <li>
+      <code>columnFilterOptions</code> prop — use <code>localization</code> with a <code>filter</code> key instead.
+    </li>
+    <li>
+      <code>expandableRowsOptions</code> prop — use <code>localization</code> with an <code>expandable</code> key instead.
+    </li>
+    <li>
+      Pagination aria-label fields on <code>paginationComponentOptions</code>
+      (<code>navigationAriaLabel</code>, <code>firstPageAriaLabel</code>, <code>previousPageAriaLabel</code>,
+      <code>nextPageAriaLabel</code>, <code>lastPageAriaLabel</code>) —
+      use <code>localization</code> with a <code>pagination</code> key instead.
+    </li>
+    <li>
+      <code>ColumnFilterOptions</code> and <code>ExpandableRowsOptions</code> types —
+      use <code>Localization['filter']</code> and <code>Localization['expandable']</code> instead.
+    </li>
+  </ul>
+
   <h2>8.2.0</h2>
 
   <h3>New features</h3>
diff --git a/src/components/DataTable.tsx b/src/components/DataTable.tsx
index dd9c4c8f..54eb9019 100644
--- a/src/components/DataTable.tsx
+++ b/src/components/DataTable.tsx
@@ -109,7 +109,9 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 		columnGroups,
 		filterValues: controlledFilterValues,
 		onFilterChange: onFilterChangeProp,
-		localization = {},
+		localization: localizationProp = {},
+		columnFilterOptions,
+		expandableRowsOptions,
 		resizable = false,
 		initialColumnWidths,
 		onColumnResize,
@@ -122,6 +124,12 @@ function DataTableInner<T>(props: TableProps<T>, ref: React.ForwardedRef<DataTab
 		ariaLabel,
 	} = props;
 
+	const localization = {
+		...localizationProp,
+		filter: { ...columnFilterOptions, ...localizationProp.filter },
+		expandable: { ...expandableRowsOptions, ...localizationProp.expandable },
+	};
+
 	// Intentionally reading @deprecated props for backward compat; cast prevents TS hint 6385 here
 	const {
 		sortIcon: sortIconProp,
diff --git a/src/index.ts b/src/index.ts
index ee2c39d2..cadfee0f 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -35,6 +35,10 @@ export type {
 	PaginationOptions,
 	PaginationServerOptions,
 	Localization,
+	/** @deprecated Use `Localization['filter']` instead. Will be removed in v9. */
+	ColumnFilterOptions,
+	/** @deprecated Use `Localization['expandable']` instead. Will be removed in v9. */
+	ExpandableRowsOptions,
 	SortFunction,
 	Selector,
 	FilterType,
diff --git a/src/types.ts b/src/types.ts
index 7d7cc77d..f9b635bc 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -165,6 +165,10 @@ type ExpandableProps<T> = {
 	expandOnRowClicked?: boolean;
 	expandOnRowDoubleClicked?: boolean;
 	onRowExpandToggled?: ExpandRowToggled<T>;
+	/**
+	 * @deprecated Use the `localization` prop instead: `localization={{ expandable: { ... } }}`. Will be removed in v9.
+	 */
+	expandableRowsOptions?: ExpandableRowsOptions;
 };
 
 type SortProps<T> = {
@@ -246,6 +250,10 @@ type BaseTableProps<T> = {
 	onFilterChange?: (columnId: string | number, filter: FilterState) => void;
 	/** Override every user-visible string in DataTable. Pass a pre-built locale or build your own. */
 	localization?: Localization;
+	/**
+	 * @deprecated Use the `localization` prop instead: `localization={{ filter: { ... } }}`. Will be removed in v9.
+	 */
+	columnFilterOptions?: ColumnFilterOptions;
 	onColumnOrderChange?: (nextOrder: TableColumn<T>[]) => void;
 	/** Called after a group drag reorder with the new group order and matching column order. */
 	onColumnGroupOrderChange?: (nextGroups: ColumnGroup[], nextColumns: TableColumn<T>[]) => void;
@@ -482,6 +490,16 @@ export interface PaginationOptions {
 	selectAllRowsItemText?: string;
 }
 
+/**
+ * @deprecated Use `Localization['filter']` instead. Will be removed in v9.
+ */
+export type ColumnFilterOptions = NonNullable<Localization['filter']>;
+
+/**
+ * @deprecated Use `Localization['expandable']` instead. Will be removed in v9.
+ */
+export type ExpandableRowsOptions = NonNullable<Localization['expandable']>;
+
 /** All user-visible strings rendered by DataTable, grouped by feature area. */
 export interface Localization {
 	pagination?: {

From 58a474c204d06c8f700d0ac0a25b0f0d2666b382 Mon Sep 17 00:00:00 2001
From: John Betancur <1385932+jbetancur@users.noreply.github.com>
Date: Wed, 20 May 2026 20:19:06 -0400
Subject: [PATCH 3/3] bump version

---
 package-lock.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package-lock.json b/package-lock.json
index dbee524a..f985a324 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "react-data-table-component",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {