@dpuse/dpuse-shared 1.0.2 → 1.0.105

package/README.md

@@ -79,19 +79,83 @@ try {
 
 ### Encoding
 
-Character encoding types with detection and decodability flags, a static catalogue of all supported encodings loaded from JSON, and an action to retrieve them in sorted order. |
+Character encoding types with detection and decodability flags, a catalogue of every supported encoding with the name browsers decode it as, and actions to check an encoding id and list the encodings in sorted order.
+
+<!-- ENCODINGS_START -->
+
+The table below lists every supported encoding.
+
+- **Detectable** — the encoding can be identified from a file's contents.
+- **Decodable** — the browser's built-in `TextDecoder` can decode it. The four that cannot are refused by all the major browsers: `iso-2022-cn` and `iso-2022-kr` are blocked by the WHATWG Encoding Standard for security reasons, and UTF-32 is not part of the standard.
+- **Decoded As** — the encoding browsers actually use, where it differs from the name. The Encoding Standard treats some names as aliases, so for example `latin1` and `ascii` are decoded as `windows-1252`. The practical effects: bytes 0x80–0x9F decode as Windows-1252 characters (such as `€` and curly quotes) rather than control codes, `ascii` never rejects bytes above 0x7F, and a big-endian UTF-16 file read as `utf-16` decodes as little-endian and comes out garbled.
+
+The major browsers all follow the Encoding Standard, so these columns hold for each of them. This was confirmed by running `TextDecoder` against every encoding in Chrome 154, Edge 154, Firefox 156 and Safari 26.6 (October 2026), and all four gave identical results. To re-check them on a Mac, run `npm run check:browsers` after a build.
+
+| Group               | Encoding       | Detectable | Decodable | Decoded As   |
+| :------------------ | :------------- | :--------: | :-------: | :----------- |
+| —                   | ascii          |     ✅     |    ✅     | windows-1252 |
+| —                   | utf-8          |     ✅     |    ✅     | —            |
+| Arabic              | iso-8859-6     |     ✅     |    ✅     | —            |
+| Arabic              | windows-1256   |     ✅     |    ✅     | —            |
+| Baltic              | iso-8859-13    |     ❌     |    ✅     | —            |
+| Baltic              | iso-8859-4     |     ❌     |    ✅     | —            |
+| Baltic              | windows-1257   |     ✅     |    ✅     | —            |
+| Celtic              | iso-8859-14    |     ❌     |    ✅     | —            |
+| Central European    | iso-8859-2     |     ✅     |    ✅     | —            |
+| Central European    | windows-1250   |     ✅     |    ✅     | —            |
+| Chinese Simplified  | gb18030        |     ✅     |    ✅     | —            |
+| Chinese Simplified  | gbk            |     ❌     |    ✅     | —            |
+| Chinese Simplified  | iso-2022-cn    |     ✅     |    ❌     | —            |
+| Chinese Traditional | big5           |     ✅     |    ✅     | —            |
+| Cyrillic            | ibm866         |     ❌     |    ✅     | —            |
+| Cyrillic            | iso-8859-5     |     ✅     |    ✅     | —            |
+| Cyrillic            | koi8-r         |     ✅     |    ✅     | —            |
+| Cyrillic            | koi8-u         |     ❌     |    ✅     | —            |
+| Cyrillic            | windows-1251   |     ✅     |    ✅     | —            |
+| Cyrillic            | x-mac-cyrillic |     ❌     |    ✅     | —            |
+| Greek               | iso-8859-7     |     ✅     |    ✅     | —            |
+| Greek               | windows-1253   |     ✅     |    ✅     | —            |
+| Hebrew              | iso-8859-8     |     ✅     |    ✅     | —            |
+| Hebrew              | windows-1255   |     ✅     |    ✅     | —            |
+| Japanese            | euc-jp         |     ✅     |    ✅     | —            |
+| Japanese            | iso-2022-jp    |     ✅     |    ✅     | —            |
+| Japanese            | shift_jis      |     ✅     |    ✅     | —            |
+| Korean              | euc-kr         |     ✅     |    ✅     | —            |
+| Korean              | iso-2022-kr    |     ✅     |    ❌     | —            |
+| Nordic              | iso-8859-10    |     ❌     |    ✅     | —            |
+| Other               | x-user-defined |     ❌     |    ✅     | —            |
+| Romanian            | iso-8859-16    |     ❌     |    ✅     | —            |
+| Southern European   | iso-8859-3     |     ❌     |    ✅     | —            |
+| Thai                | iso-8859-11    |     ❌     |    ✅     | windows-874  |
+| Thai                | tis-620        |     ❌     |    ✅     | windows-874  |
+| Thai                | windows-874    |     ✅     |    ✅     | —            |
+| Turkish             | iso-8859-9     |     ✅     |    ✅     | windows-1254 |
+| Turkish             | windows-1254   |     ✅     |    ✅     | —            |
+| Unicode 16          | utf-16         |     ❌     |    ✅     | utf-16le     |
+| Unicode 16          | utf-16be       |     ✅     |    ✅     | —            |
+| Unicode 16          | utf-16le       |     ✅     |    ✅     | —            |
+| Unicode 32          | utf-32be       |     ✅     |    ❌     | —            |
+| Unicode 32          | utf-32le       |     ✅     |    ❌     | —            |
+| Vietnamese          | windows-1258   |     ✅     |    ✅     | —            |
+| Western             | iso-8859-1     |     ✅     |    ✅     | windows-1252 |
+| Western             | iso-8859-15    |     ❌     |    ✅     | —            |
+| Western             | latin1         |     ❌     |    ✅     | windows-1252 |
+| Western             | macintosh      |     ❌     |    ✅     | —            |
+| Western             | windows-1252   |     ✅     |    ✅     | —            |
+
+<!-- ENCODINGS_END -->
 
 ### Errors
 
-A typed error hierarchy (`DPUseError`, `AppError`, `APIError`, `EngineError`, `ConnectorError`, `FetchError`) with serialisation and deserialisation for transporting errors across API and worker boundaries, plus utilities for normalising unknown throwables, constructing errors from HTTP responses, and suppressing best-effort cleanup errors. |
+A typed error hierarchy (`DPUseError`, `AppError`, `APIError`, `EngineError`, `ConnectorError`, `FetchError`) with serialisation and deserialisation for transporting errors across API and worker boundaries, plus utilities for normalising unknown throwables, constructing errors from HTTP responses, and suppressing best-effort cleanup errors.
 
 ### Locale
 
-Locale and flag identifiers, localised label, description and verb types, Valibot schemas for locale fields, supported language constants, and actions for resolving and applying locale-specific values to configuration objects. |
+Locale and flag identifiers, localised label, description and verb types, Valibot schemas for locale fields, supported language constants, and actions for resolving and applying locale-specific values to configuration objects.
 
 ### Utilities
 
-OData-to-internal type conversion, file path name and extension extraction, number formatting as decimal, whole number, compact size, storage size and duration, and MIME type lookup by file extension. |
+OData-to-internal type conversion, file path name and extension extraction, number formatting as decimal, whole number, compact size, storage size and duration, and MIME type lookup by file extension.
 
 ## API Reference
 
@@ -125,14 +189,14 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
 
 | Chunk/Module/File                                                           | Composition                                 |
 | :-------------------------------------------------------------------------- | :------------------------------------------ |
-| **dist/dpuse-shared.es.js**                                                 | 33.1 kB · gzip 8.6 kB · 100.0% of the build |
-| &nbsp;&nbsp;&nbsp;&nbsp;src                                                 | `█████████████░░░░░░░` 64.3% · 21.3 kB      |
-| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ index.ts                  | `▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░` 53.7% · 17.8 kB      |
-| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ connectorConfig.schema.ts | `▒░░░░░░░░░░░░░░░░░░░` 3.6% · 1.2 kB        |
-| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ componentConfig.schema.ts | `▒░░░░░░░░░░░░░░░░░░░` 2.8% · 936 B         |
-| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ 7 smaller files           | `▒░░░░░░░░░░░░░░░░░░░` 4.3% · 1.4 kB        |
-| &nbsp;&nbsp;&nbsp;&nbsp;valibot → dist/index.mjs                            | `████░░░░░░░░░░░░░░░░` 21.2% · 7.0 kB       |
-| &nbsp;&nbsp;&nbsp;&nbsp;(bundler output, whitespace & JSON)                 | `███░░░░░░░░░░░░░░░░░` 14.5% · 4.8 kB       |
+| **dist/dpuse-shared.es.js**                                                 | 34.1 kB · gzip 8.7 kB · 100.0% of the build |
+| &nbsp;&nbsp;&nbsp;&nbsp;src                                                 | `█████████████░░░░░░░` 65.0% · 22.2 kB      |
+| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ index.ts                  | `▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░` 54.8% · 18.7 kB      |
+| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ connectorConfig.schema.ts | `▒░░░░░░░░░░░░░░░░░░░` 3.5% · 1.2 kB        |
+| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ componentConfig.schema.ts | `▒░░░░░░░░░░░░░░░░░░░` 2.7% · 936 B         |
+| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;↳ 7 smaller files           | `▒░░░░░░░░░░░░░░░░░░░` 4.1% · 1.4 kB        |
+| &nbsp;&nbsp;&nbsp;&nbsp;valibot → dist/index.mjs                            | `████░░░░░░░░░░░░░░░░` 20.6% · 7.0 kB       |
+| &nbsp;&nbsp;&nbsp;&nbsp;(bundler output, whitespace & JSON)                 | `███░░░░░░░░░░░░░░░░░` 14.4% · 4.9 kB       |
 
 Bars show each row's share of its output file. ↳ rows are part of the row above.
 
@@ -187,9 +251,6 @@ This section is updated each time `npm run document` is run. Settings come from
 
 This project is working towards the [OpenSSF Best Practices](https://www.bestpractices.dev) Passing badge, a self-certification covering security policy, vulnerability reporting, build processes, code quality, and more. Currently the [OpenSSF Scorecard](https://scorecard.dev) provides an independent automated assessment of the project's security practices and is an ongoing area of improvement.
 
-> [!NOTE]
-> Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use.
-
 ### Reporting Vulnerabilities
 
 Please do not open public GitHub issues for security vulnerabilities. Use [GitHub private vulnerability reporting](https://github.com/dpuse/dpuse-shared/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.

package/dist/dpuse-shared.es.js

@@ -1024,310 +1024,360 @@ var Be = {
 	ascii: {
 		id: "ascii",
 		groupId: null,
-		isDetectable: !1,
-		isDecodable: !0
+		isDetectable: !0,
+		isDecodable: !0,
+		decoderId: "windows-1252"
 	},
 	big5: {
 		id: "big5",
 		groupId: "chineseTraditional",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"euc-jp": {
 		id: "euc-jp",
 		groupId: "japanese",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"euc-kr": {
 		id: "euc-kr",
 		groupId: "korean",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	gb18030: {
 		id: "gb18030",
 		groupId: "chineseSimplified",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	gbk: {
 		id: "gbk",
 		groupId: "chineseSimplified",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	ibm866: {
 		id: "ibm866",
 		groupId: "cyrillic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-2022-cn": {
 		id: "iso-2022-cn",
 		groupId: "chineseSimplified",
 		isDetectable: !0,
-		isDecodable: !1
+		isDecodable: !1,
+		decoderId: null
 	},
 	"iso-2022-jp": {
 		id: "iso-2022-jp",
 		groupId: "japanese",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-2022-kr": {
 		id: "iso-2022-kr",
 		groupId: "korean",
 		isDetectable: !0,
-		isDecodable: !1
+		isDecodable: !1,
+		decoderId: null
 	},
 	"iso-8859-1": {
 		id: "iso-8859-1",
 		groupId: "western",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "windows-1252"
 	},
 	"iso-8859-2": {
 		id: "iso-8859-2",
 		groupId: "centralEuropean",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-3": {
 		id: "iso-8859-3",
 		groupId: "southernEuropean",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-4": {
 		id: "iso-8859-4",
 		groupId: "baltic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-5": {
 		id: "iso-8859-5",
 		groupId: "cyrillic",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-6": {
 		id: "iso-8859-6",
 		groupId: "arabic",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-7": {
 		id: "iso-8859-7",
 		groupId: "greek",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-8": {
 		id: "iso-8859-8",
 		groupId: "hebrew",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-9": {
 		id: "iso-8859-9",
 		groupId: "turkish",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "windows-1254"
 	},
 	"iso-8859-10": {
 		id: "iso-8859-10",
 		groupId: "nordic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-11": {
 		id: "iso-8859-11",
 		groupId: "thai",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "windows-874"
 	},
 	"iso-8859-13": {
 		id: "iso-8859-13",
 		groupId: "baltic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-14": {
 		id: "iso-8859-14",
 		groupId: "celtic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-15": {
 		id: "iso-8859-15",
 		groupId: "western",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"iso-8859-16": {
 		id: "iso-8859-16",
 		groupId: "romanian",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"koi8-r": {
 		id: "koi8-r",
 		groupId: "cyrillic",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"koi8-u": {
 		id: "koi8-u",
 		groupId: "cyrillic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	latin1: {
 		id: "latin1",
 		groupId: "western",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "windows-1252"
 	},
 	macintosh: {
 		id: "macintosh",
 		groupId: "western",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	shift_jis: {
 		id: "shift_jis",
 		groupId: "japanese",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"tis-620": {
 		id: "tis-620",
 		groupId: "thai",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "windows-874"
 	},
 	"utf-16": {
 		id: "utf-16",
 		groupId: "unicode16",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: "utf-16le"
 	},
 	"utf-16be": {
 		id: "utf-16be",
 		groupId: "unicode16",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"utf-16le": {
 		id: "utf-16le",
 		groupId: "unicode16",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"utf-32be": {
 		id: "utf-32be",
 		groupId: "unicode32",
 		isDetectable: !0,
-		isDecodable: !1
+		isDecodable: !1,
+		decoderId: null
 	},
 	"utf-32le": {
 		id: "utf-32le",
 		groupId: "unicode32",
 		isDetectable: !0,
-		isDecodable: !1
+		isDecodable: !1,
+		decoderId: null
 	},
 	"utf-8": {
 		id: "utf-8",
 		groupId: null,
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1250": {
 		id: "windows-1250",
 		groupId: "centralEuropean",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1251": {
 		id: "windows-1251",
 		groupId: "cyrillic",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1252": {
 		id: "windows-1252",
 		groupId: "western",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1253": {
 		id: "windows-1253",
 		groupId: "greek",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1254": {
 		id: "windows-1254",
 		groupId: "turkish",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1255": {
 		id: "windows-1255",
 		groupId: "hebrew",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1256": {
 		id: "windows-1256",
 		groupId: "arabic",
 		isDetectable: !0,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1257": {
 		id: "windows-1257",
 		groupId: "baltic",
-		isDetectable: !1,
-		isDecodable: !0
+		isDetectable: !0,
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-1258": {
 		id: "windows-1258",
 		groupId: "vietnamese",
-		isDetectable: !1,
-		isDecodable: !0
+		isDetectable: !0,
+		isDecodable: !0,
+		decoderId: null
 	},
 	"windows-874": {
 		id: "windows-874",
 		groupId: "thai",
-		isDetectable: !1,
-		isDecodable: !0
+		isDetectable: !0,
+		isDecodable: !0,
+		decoderId: null
 	},
 	"x-mac-cyrillic": {
 		id: "x-mac-cyrillic",
 		groupId: "cyrillic",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	},
 	"x-user-defined": {
 		id: "x-user-defined",
 		groupId: "other",
 		isDetectable: !1,
-		isDecodable: !0
+		isDecodable: !0,
+		decoderId: null
 	}
 }, K = Be, q = Ve;
 function He(e) {
 	return Object.hasOwn(q, e);
 }
 function Ue(e = "en") {
-	return Array.from(Object.values(q), ({ groupId: t, id: n, isDecodable: r, isDetectable: i }) => {
-		let a = t == null ? "" : We(t, e);
+	return Array.from(Object.values(q), ({ decoderId: t, groupId: n, id: r, isDecodable: i, isDetectable: a }) => {
+		let o = n == null ? "" : We(n, e);
 		return {
-			id: n,
-			groupLabel: a,
-			label: a ? `${a} (${n})` : n,
-			isDetectable: i,
-			isDecodable: r
+			id: r,
+			groupLabel: o,
+			label: o ? `${o} (${r})` : r,
+			isDetectable: a,
+			isDecodable: i,
+			decoderId: t
 		};
 	}).toSorted((t, n) => t.groupLabel.localeCompare(n.groupLabel, e) || t.label.localeCompare(n.label, e));
 }