@d3plus/locales 3.0.16 → 3.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 D3plus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,5 @@
 # @d3plus/locales
-  
+
 International localizations for number, date, and UI labels.
 
 ## Installing
@@ -7,10 +7,10 @@ International localizations for number, date, and UI labels.
 If using npm, `npm install @d3plus/locales`. Otherwise, you can download the [latest release from GitHub](https://github.com/d3plus/d3plus/releases/latest) or load from a [CDN](https://cdn.jsdelivr.net/npm/@d3plus/locales).
 
 ```js
-import modules from "@d3plus/locales";
+import {*} from "@d3plus/locales";
 ```
 
-In vanilla JavaScript, a `d3plus` global is exported from the pre-bundled version:
+In a vanilla environment, a `d3plus` global is exported from the pre-bundled version:
 
 ```html
 <script src="https://cdn.jsdelivr.net/npm/@d3plus/locales"></script>
@@ -21,22 +21,151 @@ In vanilla JavaScript, a `d3plus` global is exported from the pre-bundled versio
 
 ## Examples
 
-Live examples can be found on [d3plus.org](https://d3plus.org/), which includes a collection of example visualizations using @d3plus/react.
+Live examples can be found on [d3plus.org](https://d3plus.org/), which includes a collection of example visualizations using [@d3plus/react](https://github.com/d3plus/d3plus/tree/main/packages/react).
 
 ## API Reference
 
-##### 
-* [formatLocale](#formatLocale) - A set of default locale formatters used when assigning suffixes and currency in numbers.
+| Functions | Description |
+| --- | --- |
+| [`findLocale`](#findlocale) | Converts a 2-letter language code into a full language-region locale string (e.g., "en" to "en-US"). |
 
----
+| Variables | Description |
+| --- | --- |
+| [`formatLocale`](#formatlocale) |  |
+| [`locale`](#locale) |  |
+| [`translateLocale`](#translatelocale) |  |
 
-<a name="formatLocale"></a>
-#### **formatLocale** [<>](https://github.com/d3plus/d3plus/blob/main/packages/locales/src/dictionaries/formatLocale.js#L1)
+| Interfaces | Description |
+| --- | --- |
+| [`FormatLocaleDefinition`](#formatlocaledefinition) | formatLocale |
+| [`TimeLocaleDefinition`](#timelocaledefinition) |  |
+| [`TranslationStrings`](#translationstrings) |  |
 
-A set of default locale formatters used when assigning suffixes and currency in numbers.
+## Functions
+
+<a id="findlocale"></a>
+
+### findLocale()
+
+> **findLocale**(`locale`: `string`): `string`
+
+Defined in: [findLocale.ts:49](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/findLocale.ts#L49)
+
+Converts a 2-letter language code into a full language-region locale string (e.g., "en" to "en-US").
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `locale` | `string` | A 2-letter language code (e.g., "en", "fr"). |
+
+#### Returns
+
+`string`
+
+## Variables
+
+<a id="formatlocale"></a>
+
+### formatLocale
+
+> `const` **formatLocale**: `Record`\<`string`, [`FormatLocaleDefinition`](#formatlocaledefinition)\>
 
+Defined in: [dictionaries/formatLocale.ts:17](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L17)
 
-This is a global namespace
+***
 
----
+<a id="locale"></a>
+
+### locale
+
+> `const` **locale**: `Record`\<`string`, [`TimeLocaleDefinition`](#timelocaledefinition)\>
+
+Defined in: [dictionaries/timeLocale.ts:39](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L39)
+
+***
+
+<a id="translatelocale"></a>
+
+### translateLocale
+
+> `const` **translateLocale**: `Record`\<`string`, [`TranslationStrings`](#translationstrings)\>
+
+Defined in: [dictionaries/translateLocale.ts:21](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L21)
+
+## Interfaces
+
+<a id="formatlocaledefinition"></a>
+
+### FormatLocaleDefinition
+
+Defined in: [dictionaries/formatLocale.ts:6](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L6)
+
+**`Namespace`**
+
+formatLocale
+A set of default locale formatters used when assigning suffixes and currency in numbers.
 
+#### Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="property-currency"></a> `currency` | \[`string`, `string`\] | [dictionaries/formatLocale.ts:14](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L14) |
+| <a id="property-delimiters"></a> `delimiters` | `object` | [dictionaries/formatLocale.ts:10](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L10) |
+| `delimiters.decimal` | `string` | [dictionaries/formatLocale.ts:12](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L12) |
+| `delimiters.thousands` | `string` | [dictionaries/formatLocale.ts:11](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L11) |
+| <a id="property-grouping"></a> `grouping` | `number`[] | [dictionaries/formatLocale.ts:9](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L9) |
+| <a id="property-separator"></a> `separator?` | `string` | [dictionaries/formatLocale.ts:7](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L7) |
+| <a id="property-suffixes"></a> `suffixes` | `string`[] | [dictionaries/formatLocale.ts:8](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/formatLocale.ts#L8) |
+
+***
+
+<a id="timelocaledefinition"></a>
+
+### TimeLocaleDefinition
+
+Defined in: [dictionaries/timeLocale.ts:1](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L1)
+
+#### Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="property-date"></a> `date` | `string` | [dictionaries/timeLocale.ts:3](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L3) |
+| <a id="property-datetime"></a> `dateTime` | `string` | [dictionaries/timeLocale.ts:2](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L2) |
+| <a id="property-days"></a> `days` | \[`string`, `string`, `string`, `string`, `string`, `string`, `string`\] | [dictionaries/timeLocale.ts:7](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L7) |
+| <a id="property-months"></a> `months` | \[`string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`\] | [dictionaries/timeLocale.ts:9](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L9) |
+| <a id="property-periods"></a> `periods` | \[`string`, `string`\] | [dictionaries/timeLocale.ts:6](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L6) |
+| <a id="property-quarter"></a> `quarter` | `string` | [dictionaries/timeLocale.ts:5](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L5) |
+| <a id="property-shortdays"></a> `shortDays` | \[`string`, `string`, `string`, `string`, `string`, `string`, `string`\] | [dictionaries/timeLocale.ts:8](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L8) |
+| <a id="property-shortmonths"></a> `shortMonths` | \[`string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`, `string`\] | [dictionaries/timeLocale.ts:23](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L23) |
+| <a id="property-time"></a> `time` | `string` | [dictionaries/timeLocale.ts:4](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/timeLocale.ts#L4) |
+
+***
+
+<a id="translationstrings"></a>
+
+### TranslationStrings
+
+Defined in: [dictionaries/translateLocale.ts:1](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L1)
+
+#### Properties
+
+| Property | Type | Defined in |
+| ------ | ------ | ------ |
+| <a id="property-and"></a> `and` | `string` | [dictionaries/translateLocale.ts:2](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L2) |
+| <a id="property-back"></a> `Back` | `string` | [dictionaries/translateLocale.ts:3](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L3) |
+| <a id="property-click-to-expand"></a> `Click to Expand` | `string` | [dictionaries/translateLocale.ts:4](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L4) |
+| <a id="property-click-to-hide"></a> `Click to Hide` | `string` | [dictionaries/translateLocale.ts:5](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L5) |
+| <a id="property-click-to-highlight"></a> `Click to Highlight` | `string` | [dictionaries/translateLocale.ts:6](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L6) |
+| <a id="property-click-to-show"></a> `Click to Show` | `string` | [dictionaries/translateLocale.ts:7](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L7) |
+| <a id="property-click-to-show-all"></a> `Click to Show All` | `string` | [dictionaries/translateLocale.ts:8](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L8) |
+| <a id="property-download"></a> `Download` | `string` | [dictionaries/translateLocale.ts:9](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L9) |
+| <a id="property-loading-visualization"></a> `Loading Visualization` | `string` | [dictionaries/translateLocale.ts:10](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L10) |
+| <a id="property-more"></a> `more` | `string` | [dictionaries/translateLocale.ts:11](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L11) |
+| <a id="property-no-data-available"></a> `No Data Available` | `string` | [dictionaries/translateLocale.ts:12](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L12) |
+| <a id="property-powered-by-d3plus"></a> `Powered by D3plus` | `string` | [dictionaries/translateLocale.ts:13](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L13) |
+| <a id="property-share"></a> `Share` | `string` | [dictionaries/translateLocale.ts:14](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L14) |
+| <a id="property-shiftclick-to-hide"></a> `Shift+Click to Hide` | `string` | [dictionaries/translateLocale.ts:15](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L15) |
+| <a id="property-shiftclick-to-highlight"></a> `Shift+Click to Highlight` | `string` | [dictionaries/translateLocale.ts:16](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L16) |
+| <a id="property-total"></a> `Total` | `string` | [dictionaries/translateLocale.ts:17](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L17) |
+| <a id="property-values"></a> `Values` | `string` | [dictionaries/translateLocale.ts:18](https://github.com/d3plus/d3plus/blob/e9db3c74352143cd7b6bdc8d0786477ea971eb6d/packages/locales/src/dictionaries/translateLocale.ts#L18) |

package/es/src/dictionaries/formatLocale.js

@@ -1,7 +1,7 @@
 /**
     @namespace {Object} formatLocale
-    @desc A set of default locale formatters used when assigning suffixes and currency in numbers.
-*/ export default {
+    A set of default locale formatters used when assigning suffixes and currency in numbers.
+*/ var formatLocale = {
     "ar-SA": {
         separator: "",
         suffixes: [
@@ -11,17 +11,17 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
-            " ألف",
-            " مليون",
-            " بليون",
-            " تريليون",
-            " كوادريليون",
-            " كوينتيليون",
-            " سكستليون",
-            "سبتيليون"
+            " \u0623\u0644\u0641",
+            " \u0645\u0644\u064a\u0648\u0646",
+            " \u0628\u0644\u064a\u0648\u0646",
+            " \u062a\u0631\u064a\u0644\u064a\u0648\u0646",
+            " \u0643\u0648\u0627\u062f\u0631\u064a\u0644\u064a\u0648\u0646",
+            " \u0643\u0648\u064a\u0646\u062a\u064a\u0644\u064a\u0648\u0646",
+            " \u0633\u0643\u0633\u062a\u0644\u064a\u0648\u0646",
+            "\u0633\u0628\u062a\u064a\u0644\u064a\u0648\u0646"
         ],
         grouping: [
             3
@@ -44,7 +44,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -64,7 +64,7 @@
             decimal: "."
         },
         currency: [
-            "£",
+            "\u00a3",
             ""
         ]
     },
@@ -77,7 +77,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -110,7 +110,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             " thousand",
@@ -143,7 +143,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -176,7 +176,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -209,7 +209,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -229,7 +229,7 @@
             decimal: ","
         },
         currency: [
-            "€",
+            "\u20ac",
             ""
         ]
     },
@@ -242,7 +242,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "tuhat",
@@ -274,7 +274,7 @@
             "f",
             "p",
             "n",
-            "µ",
+            "\u00b5",
             "m",
             "",
             "k",
@@ -294,30 +294,30 @@
             decimal: ","
         },
         currency: [
-            "€",
+            "\u20ac",
             ""
         ]
     },
     "zh-CN": {
         separator: "",
         suffixes: [
-            "幺",
-            "仄",
-            "阿",
-            "飞",
-            "皮",
-            "纳",
-            "微",
-            "毫",
+            "\u5e7a",
+            "\u4ed4",
+            "\u963f",
+            "\u98de",
+            "\u76ae",
+            "\u7eb3",
+            "\u5fae",
+            "\u6beb",
             "",
-            "千",
-            "兆",
-            "吉",
-            "太",
-            "拍",
-            "艾",
-            "泽",
-            "尧"
+            "\u5343",
+            "\u5146",
+            "\u5409",
+            "\u592a",
+            "\u62cd",
+            "\u827e",
+            "\u6cfd",
+            "\u5c27"
         ],
         grouping: [
             3
@@ -327,8 +327,9 @@
             decimal: "."
         },
         currency: [
-            "¥",
+            "\u00a5",
             ""
         ]
     }
 };
+export default formatLocale;