npm - @dpuse/dpuse-shared - Versions diffs - 0.3.821 → 0.3.823 - Mend

@dpuse/dpuse-shared 0.3.821 → 0.3.823

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +52 -9
package/dist/dpuse-shared-encoding.es.js +10 -6
package/dist/dpuse-shared-encoding.es.js.map +1 -1
package/dist/dpuse-shared-errors.es.js.map +1 -1
package/dist/dpuse-shared-utilities.es.js.map +1 -1
package/dist/types/src/component/module/engine/index.d.ts +2 -2
package/dist/types/src/encoding/index.d.ts +450 -5
package/package.json +6 -5

package/README.md CHANGED Viewed

@@ -32,6 +32,22 @@ DPUse (Data Positioning & Use) is an in-browser application that positions your
 <!-- OPENING_END -->
+<!-- USAGE_START -->
+This connector is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
+You may view or clone this repository for your own purposes, such as building a new, similar connector, though there is currently no process to accept third-party connectors into DPUse at this stage. Cloned or forked code is unsupported and isn't guaranteed to remain compatible with the DPUse Engine as it evolves.
+```bash
+git clone https://github.com/dpuse/dpuse-shared.git
+cd dpuse-shared
+npm install
+```
+_Requires [Node.js](https://nodejs.org/) 24 or later, [npm](https://www.npmjs.com/) 12 or later, and [TypeScript](https://www.typescriptlang.org/) 6.0.3 or later._
+<!-- USAGE_END -->
 ## Table of Contents
 ## Prerequisites
@@ -115,10 +131,22 @@ License data is collected automatically on each release using [license-checker](
 <!-- DEPENDENCY_LICENSES_START -->
-License data is collected automatically on each release using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). The following table lists all production dependencies. These dependencies (including transitive ones) have been checked and confirmed to use MIT — all permissive, commercially-friendly licenses. Users of the uploaded library are covered by these checks; developers cloning this repository should independently verify development dependencies.
-| Dependency | Version | License(s) | Document |
-| :--------- | :-----: | :--------- | :------- |
+License data is collected automatically on each release using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). The following table lists all production dependencies. These dependencies (including transitive ones) have been checked and confirmed to use Apache-2.0, BSD-3-Clause, or MIT — all permissive, commercially-friendly licenses. Users of the uploaded library are covered by these checks; developers cloning this repository should independently verify development dependencies.
+|Dependency|Version|License(s)|Document|
+|:-|:-:|:-|:-|
+|[@borewit/text-codec](https://github.com/Borewit/text-codec)|0.2.2|MIT|[LICENSE](licenses/downloads/@borewit/text-codec@0.2.2-LICENSE.txt)|
+|[@tokenizer/inflate](https://github.com/Borewit/tokenizer-inflate)|0.4.1|MIT|[LICENSE](licenses/downloads/@tokenizer/inflate@0.4.1-LICENSE.txt)|
+|[@tokenizer/token](https://github.com/Borewit/tokenizer-token)|0.3.0|MIT|[LICENSE](licenses/downloads/@tokenizer/token@0.3.0-LICENSE.txt)|
+|[debug](https://github.com/debug-js/debug)|4.4.3|MIT|[LICENSE](licenses/downloads/debug@4.4.3-LICENSE.txt)|
+|[file-type](https://github.com/sindresorhus/file-type)|22.1.1|MIT|[LICENSE](licenses/downloads/file-type@22.1.1-LICENSE.txt)|
+|[ieee754](https://github.com/feross/ieee754)|1.2.1|BSD-3-Clause|[LICENSE](licenses/downloads/ieee754@1.2.1-LICENSE.txt)|
+|[ms](https://github.com/vercel/ms)|2.1.3|MIT|[LICENSE](licenses/downloads/ms@2.1.3-LICENSE.txt)|
+|[strtok3](https://github.com/Borewit/strtok3)|10.3.5|MIT|[LICENSE](licenses/downloads/strtok3@10.3.5-LICENSE.txt)|
+|[token-types](https://github.com/Borewit/token-types)|6.1.2|MIT|[LICENSE](licenses/downloads/token-types@6.1.2-LICENSE.txt)|
+|[typescript](https://github.com/microsoft/TypeScript)|6.0.3|Apache-2.0|[LICENSE](licenses/downloads/typescript@6.0.3-LICENSE.txt)|
+|[uint8array-extras](https://github.com/sindresorhus/uint8array-extras)|1.5.0|MIT|[LICENSE](licenses/downloads/uint8array-extras@1.5.0-LICENSE.txt)|
+|[valibot](https://github.com/open-circle/valibot)|1.5.0|MIT|[LICENSE](licenses/downloads/valibot@1.5.0-LICENSE.txt)|
 <!-- DEPENDENCY_LICENSES_END -->
@@ -130,6 +158,21 @@ The dependency tree below lists every package in this project — direct and tra
 The dependency tree below lists every package in this project — direct and transitive — along with its installed version, release date, and update status. Packages flagged ❗ have a newer version available; ⚠️ indicates a package that hasn't been updated in the last 6 months or longer. Neither flag necessarily indicates a problem: we let new releases stabilise before upgrading, and some packages are simply mature and stable, requiring no active development.
+- **[file-type](https://github.com/sindresorhus/file-type)** 22.1.1 — this month: 2026-09-17
+  - **[@tokenizer/inflate](https://github.com/Borewit/tokenizer-inflate)** 0.4.1 — **10 months** ago: 2025-11-18 ⚠️
+    - **[debug](https://github.com/debug-js/debug)** 4.4.3 — **12 months** ago: 2025-09-13 ⚠️
+      - **[ms](https://github.com/vercel/ms)** 2.1.3 — **69 months** ago: 2020-12-08 ⚠️
+    - **[token-types](https://github.com/Borewit/token-types)** 6.1.2 — **8 months** ago: 2026-01-01 ⚠️
+  - **[strtok3](https://github.com/Borewit/strtok3)** 10.3.5 — **6 months** ago: 2026-03-21
+    - **[@tokenizer/token](https://github.com/Borewit/tokenizer-token)** 0.3.0 — **62 months** ago: 2021-07-12 ⚠️
+  - **[token-types](https://github.com/Borewit/token-types)** 6.1.2 — **8 months** ago: 2026-01-01 ⚠️
+    - **[@borewit/text-codec](https://github.com/Borewit/text-codec)** 0.2.2 — **6 months** ago: 2026-03-11
+    - **[@tokenizer/token](https://github.com/Borewit/tokenizer-token)** 0.3.0 — **62 months** ago: 2021-07-12 ⚠️
+    - **[ieee754](https://github.com/feross/ieee754)** 1.2.1 — **70 months** ago: 2020-10-27 ⚠️
+  - **[uint8array-extras](https://github.com/sindresorhus/uint8array-extras)** 1.5.0 — **13 months** ago: 2025-08-22 ⚠️
+- **[valibot](https://github.com/open-circle/valibot)** 1.5.0 — this month: 2026-09-09
+  - **[typescript](https://github.com/microsoft/TypeScript)** 6.0.3 — **5 months** ago: 2026-04-16 → **latest**: 7.0.2 — **2 months** ago: 2026-07-08 ❗
 <!-- DEPENDENCY_TREE_END -->
 ## Bundle Analysis
@@ -143,16 +186,16 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
 |Chunk/Module/File|Composition|
 |:------ |:-----------|
 | dist/componentConfig.schema-DT3mO5rS.js | 10.2 kB · brotli 2.3 kB |
-| &nbsp;&nbsp;&nbsp;&nbsp;valibot → dist/index.mjs | `████░░░░░░░░░░░░░░░░` 21.4% |
+| &nbsp;&nbsp;&nbsp;&nbsp;valibot → dist/index.mjs | `████░░░░░░░░░░░░░░░░` 21.3% |
 | &nbsp;&nbsp;&nbsp;&nbsp;(unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 5.4% |
 | &nbsp;&nbsp;&nbsp;&nbsp;src | `█░░░░░░░░░░░░░░░░░░░` 4.3% |
-| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;componentConfig.schema.ts | `█░░░░░░░░░░░░░░░░░░░` 2.8% |
+| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;componentConfig.schema.ts | `█░░░░░░░░░░░░░░░░░░░` 2.7% |
 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;locale.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.8% |
 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;baseConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.6% |
 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.2% |
-| dist/dpuse-shared-encoding.es.js | 7.3 kB · brotli 1.3 kB |
-| &nbsp;&nbsp;&nbsp;&nbsp;(unassigned) → [unassigned] | `████░░░░░░░░░░░░░░░░` 20.9% |
-| &nbsp;&nbsp;&nbsp;&nbsp;src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.3% |
+| dist/dpuse-shared-encoding.es.js | 7.4 kB · brotli 1.3 kB |
+| &nbsp;&nbsp;&nbsp;&nbsp;src → index.ts | `████░░░░░░░░░░░░░░░░` 19.4% |
+| &nbsp;&nbsp;&nbsp;&nbsp;(unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 3.0% |
 | dist/dpuse-shared-componentModuleConnector.es.js | 3.6 kB · brotli 1.2 kB |
 | &nbsp;&nbsp;&nbsp;&nbsp;src | `██░░░░░░░░░░░░░░░░░░` 8.6% |
 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;index.ts | `█░░░░░░░░░░░░░░░░░░░` 6.2% |

package/dist/dpuse-shared-encoding.es.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import "./label-DexpXrnC.js";
+//#region src/encoding/index.ts
 var e = {
 	arabic: {
 		id: "arabic",
@@ -443,21 +444,24 @@ var e = {
 		isDecodable: !0
 	}
 }, n = e, r = t;
-function i(e = "en") {
+function i(e) {
+	return Object.hasOwn(r, e);
+}
+function a(e = "en") {
 	return Array.from(Object.values(r), ({ groupId: t, id: n, isDecodable: r, isDetectable: i }) => {
-		let o = t == null ? "" : a(t, e);
+		let a = t == null ? "" : o(t, e);
 		return {
 			id: n,
-			groupLabel: o,
-			label: o ? `${o} (${n})` : n,
+			groupLabel: a,
+			label: a ? `${a} (${n})` : n,
 			isDetectable: i,
 			isDecodable: r
 		};
 	}).toSorted((t, n) => t.groupLabel.localeCompare(n.groupLabel, e) || t.label.localeCompare(n.label, e));
 }
-function a(e, t) {
+function o(e, t) {
 	let r = n[e].label;
 	return r[t] ?? r.en ?? e;
 }
 //#endregion
-export { n as ENCODING_GROUP_CONFIG_MAP, r as ENCODING_TYPE_CONFIG_MAP, i as getEncodingTypeConfigs };
+export { n as ENCODING_GROUP_CONFIG_MAP, r as ENCODING_TYPE_CONFIG_MAP, a as getEncodingTypeConfigs, i as isEncodingTypeId };

package/dist/dpuse-shared-encoding.es.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dpuse-shared-encoding.es.js","names":[],"sources":["../src/encoding/encodingGroupConfigs.json","../src/encoding/encodingTypeConfigs.json","../src/encoding/index.ts"],"sourcesContent":["{\n \"arabic\": { \"id\": \"arabic\", \"label\": { \"en\": \"Arabic\", \"es\": \"Árabe\" } },\n \"baltic\": { \"id\": \"baltic\", \"label\": { \"en\": \"Baltic\", \"es\": \"Báltico\" } },\n \"celtic\": { \"id\": \"celtic\", \"label\": { \"en\": \"Celtic\", \"es\": \"Celta\" } },\n \"centralEuropean\": { \"id\": \"centralEuropean\", \"label\": { \"en\": \"Central European\", \"es\": \"Centroeuropeo\" } },\n \"chineseSimplified\": { \"id\": \"chineseSimplified\", \"label\": { \"en\": \"Chinese Simplified\", \"es\": \"Chino simplificado\" } },\n \"chineseTraditional\": { \"id\": \"chineseTraditional\", \"label\": { \"en\": \"Chinese Traditional\", \"es\": \"Chino tradicional\" } },\n \"cyrillic\": { \"id\": \"cyrillic\", \"label\": { \"en\": \"Cyrillic\", \"es\": \"Cirílico\" } },\n \"greek\": { \"id\": \"greek\", \"label\": { \"en\": \"Greek\", \"es\": \"Griego\" } },\n \"hebrew\": { \"id\": \"hebrew\", \"label\": { \"en\": \"Hebrew\", \"es\": \"Hebreo\" } },\n \"japanese\": { \"id\": \"japanese\", \"label\": { \"en\": \"Japanese\", \"es\": \"Japonés\" } },\n \"korean\": { \"id\": \"korean\", \"label\": { \"en\": \"Korean\", \"es\": \"Coreano\" } },\n \"nordic\": { \"id\": \"nordic\", \"label\": { \"en\": \"Nordic\", \"es\": \"Nórdico\" } },\n \"other\": { \"id\": \"other\", \"label\": { \"en\": \"Other\", \"es\": \"Otro\" } },\n \"romanian\": { \"id\": \"romanian\", \"label\": { \"en\": \"Romanian\", \"es\": \"Rumano\" } },\n \"southernEuropean\": { \"id\": \"southernEuropean\", \"label\": { \"en\": \"Southern European\", \"es\": \"Europeo meridional\" } },\n \"thai\": { \"id\": \"thai\", \"label\": { \"en\": \"Thai\", \"es\": \"Tailandés\" } },\n \"turkish\": { \"id\": \"turkish\", \"label\": { \"en\": \"Turkish\", \"es\": \"Turco\" } },\n \"unicode16\": { \"id\": \"unicode16\", \"label\": { \"en\": \"Unicode 16\", \"es\": \"Unicode 16\" } },\n \"unicode32\": { \"id\": \"unicode32\", \"label\": { \"en\": \"Unicode 32\", \"es\": \"Unicode 32\" } },\n \"vietnamese\": { \"id\": \"vietnamese\", \"label\": { \"en\": \"Vietnamese\", \"es\": \"Vietnamita\" } },\n \"western\": { \"id\": \"western\", \"label\": { \"en\": \"Western\", \"es\": \"Occidental\" } }\n}\n","{\n \"ascii\": { \"id\": \"ascii\", \"groupId\": null, \"isDetectable\": false, \"isDecodable\": true },\n \"big5\": { \"id\": \"big5\", \"groupId\": \"chineseTraditional\", \"isDetectable\": true, \"isDecodable\": true },\n \"euc-jp\": { \"id\": \"euc-jp\", \"groupId\": \"japanese\", \"isDetectable\": true, \"isDecodable\": true },\n \"euc-kr\": { \"id\": \"euc-kr\", \"groupId\": \"korean\", \"isDetectable\": true, \"isDecodable\": true },\n \"gb18030\": { \"id\": \"gb18030\", \"groupId\": \"chineseSimplified\", \"isDetectable\": true, \"isDecodable\": true },\n \"gbk\": { \"id\": \"gbk\", \"groupId\": \"chineseSimplified\", \"isDetectable\": false, \"isDecodable\": true },\n \"ibm866\": { \"id\": \"ibm866\", \"groupId\": \"cyrillic\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-2022-cn\": { \"id\": \"iso-2022-cn\", \"groupId\": \"chineseSimplified\", \"isDetectable\": true, \"isDecodable\": false },\n \"iso-2022-jp\": { \"id\": \"iso-2022-jp\", \"groupId\": \"japanese\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-2022-kr\": { \"id\": \"iso-2022-kr\", \"groupId\": \"korean\", \"isDetectable\": true, \"isDecodable\": false },\n \"iso-8859-1\": { \"id\": \"iso-8859-1\", \"groupId\": \"western\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-2\": { \"id\": \"iso-8859-2\", \"groupId\": \"centralEuropean\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-3\": { \"id\": \"iso-8859-3\", \"groupId\": \"southernEuropean\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-4\": { \"id\": \"iso-8859-4\", \"groupId\": \"baltic\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-5\": { \"id\": \"iso-8859-5\", \"groupId\": \"cyrillic\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-6\": { \"id\": \"iso-8859-6\", \"groupId\": \"arabic\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-7\": { \"id\": \"iso-8859-7\", \"groupId\": \"greek\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-8\": { \"id\": \"iso-8859-8\", \"groupId\": \"hebrew\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-9\": { \"id\": \"iso-8859-9\", \"groupId\": \"turkish\", \"isDetectable\": true, \"isDecodable\": true },\n \"iso-8859-10\": { \"id\": \"iso-8859-10\", \"groupId\": \"nordic\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-11\": { \"id\": \"iso-8859-11\", \"groupId\": \"thai\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-13\": { \"id\": \"iso-8859-13\", \"groupId\": \"baltic\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-14\": { \"id\": \"iso-8859-14\", \"groupId\": \"celtic\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-15\": { \"id\": \"iso-8859-15\", \"groupId\": \"western\", \"isDetectable\": false, \"isDecodable\": true },\n \"iso-8859-16\": { \"id\": \"iso-8859-16\", \"groupId\": \"romanian\", \"isDetectable\": false, \"isDecodable\": true },\n \"koi8-r\": { \"id\": \"koi8-r\", \"groupId\": \"cyrillic\", \"isDetectable\": true, \"isDecodable\": true },\n \"koi8-u\": { \"id\": \"koi8-u\", \"groupId\": \"cyrillic\", \"isDetectable\": false, \"isDecodable\": true },\n \"latin1\": { \"id\": \"latin1\", \"groupId\": \"western\", \"isDetectable\": false, \"isDecodable\": true },\n \"macintosh\": { \"id\": \"macintosh\", \"groupId\": \"western\", \"isDetectable\": false, \"isDecodable\": true },\n \"shift_jis\": { \"id\": \"shift_jis\", \"groupId\": \"japanese\", \"isDetectable\": true, \"isDecodable\": true },\n \"tis-620\": { \"id\": \"tis-620\", \"groupId\": \"thai\", \"isDetectable\": false, \"isDecodable\": true },\n \"utf-16\": { \"id\": \"utf-16\", \"groupId\": \"unicode16\", \"isDetectable\": false, \"isDecodable\": true },\n \"utf-16be\": { \"id\": \"utf-16be\", \"groupId\": \"unicode16\", \"isDetectable\": true, \"isDecodable\": true },\n \"utf-16le\": { \"id\": \"utf-16le\", \"groupId\": \"unicode16\", \"isDetectable\": true, \"isDecodable\": true },\n \"utf-32be\": { \"id\": \"utf-32be\", \"groupId\": \"unicode32\", \"isDetectable\": true, \"isDecodable\": false },\n \"utf-32le\": { \"id\": \"utf-32le\", \"groupId\": \"unicode32\", \"isDetectable\": true, \"isDecodable\": false },\n \"utf-8\": { \"id\": \"utf-8\", \"groupId\": null, \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1250\": { \"id\": \"windows-1250\", \"groupId\": \"centralEuropean\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1251\": { \"id\": \"windows-1251\", \"groupId\": \"cyrillic\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1252\": { \"id\": \"windows-1252\", \"groupId\": \"western\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1253\": { \"id\": \"windows-1253\", \"groupId\": \"greek\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1254\": { \"id\": \"windows-1254\", \"groupId\": \"turkish\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1255\": { \"id\": \"windows-1255\", \"groupId\": \"hebrew\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1256\": { \"id\": \"windows-1256\", \"groupId\": \"arabic\", \"isDetectable\": true, \"isDecodable\": true },\n \"windows-1257\": { \"id\": \"windows-1257\", \"groupId\": \"baltic\", \"isDetectable\": false, \"isDecodable\": true },\n \"windows-1258\": { \"id\": \"windows-1258\", \"groupId\": \"vietnamese\", \"isDetectable\": false, \"isDecodable\": true },\n \"windows-874\": { \"id\": \"windows-874\", \"groupId\": \"thai\", \"isDetectable\": false, \"isDecodable\": true },\n \"x-mac-cyrillic\": { \"id\": \"x-mac-cyrillic\", \"groupId\": \"cyrillic\", \"isDetectable\": false, \"isDecodable\": true },\n \"x-user-defined\": { \"id\": \"x-user-defined\", \"groupId\": \"other\", \"isDetectable\": false, \"isDecodable\": true }\n}\n","// ── DPUse Framework\nimport { DEFAULT_LOCALE_ID, type LocaleId, type LocaleLabel } from '@/locale/label';\n\n// ── Data\nimport encodingGroupConfigData from './encodingGroupConfigs.json';\nimport encodingTypeConfigData from './encodingTypeConfigs.json';\n\n// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type EncodingGroupId = keyof typeof encodingGroupConfigData;\nexport type EncodingTypeId = keyof typeof encodingTypeConfigData;\n\nexport interface EncodingGroupConfig {\n id: EncodingGroupId;\n label: LocaleLabel;\n}\n\nexport interface EncodingTypeConfig {\n id: EncodingTypeId;\n groupId: EncodingGroupId \| null; // Null for encodings that belong to no group, e.g. 'ascii' and 'utf-8'.\n isDetectable: boolean;\n isDecodable: boolean;\n}\nexport interface EncodingTypeConfigLocalised {\n id: EncodingTypeId;\n groupLabel: string;\n label: string;\n isDetectable: boolean;\n isDecodable: boolean;\n}\n\nexport interface EncodingDetectionConfig {\n id: EncodingTypeId;\n confidenceLevel: number \| undefined;\n}\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport const ENCODING_GROUP_CONFIG_MAP = encodingGroupConfigData as Record<EncodingGroupId, EncodingGroupConfig>;\nexport const ENCODING_TYPE_CONFIG_MAP = encodingTypeConfigData as Record<string, EncodingTypeConfig>; // Keyed by string, not 'EncodingTypeId', because it is looked up with names detected at runtime.\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport function getEncodingTypeConfigs(localeId: LocaleId = DEFAULT_LOCALE_ID): EncodingTypeConfigLocalised[] {\n const encodingTypeConfigs: EncodingTypeConfigLocalised[] = Array.from(Object.values(ENCODING_TYPE_CONFIG_MAP), ({ groupId, id, isDecodable, isDetectable }) => {\n const groupLabel = groupId == null ? '' : resolveGroupLabel(groupId, localeId);\n return { id, groupLabel, label: groupLabel ? `${groupLabel} (${id})` : id, isDetectable, isDecodable };\n });\n return encodingTypeConfigs.toSorted((left, right) => left.groupLabel.localeCompare(right.groupLabel, localeId) \|\| left.label.localeCompare(right.label, localeId));\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nfunction resolveGroupLabel(groupId: EncodingGroupId, localeId: LocaleId): string {\n const labels = ENCODING_GROUP_CONFIG_MAP[groupId].label;\n return labels[localeId] ?? labels[DEFAULT_LOCALE_ID] ?? groupId;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GEsCa,IAA4B,GAC5B,IAA2B;AAIxC,SAAgB,EAAuB,IAAA,MAAuE;CAK1G,OAJ2D,MAAM,KAAK,OAAO,OAAO,CAAwB,IAAI,EAAE,YAAS,OAAI,gBAAa,sBAAmB;EAC3J,IAAM,IAAa,KAAW,OAAO,KAAK,EAAkB,GAAS,CAAQ;EAC7E,OAAO;GAAE;GAAI;GAAY,OAAO,IAAa,GAAG,EAAW,IAAI,EAAG,KAAK;GAAI;GAAc;EAAY;CACzG,CACO,CAAA,CAAoB,UAAU,GAAM,MAAU,EAAK,WAAW,cAAc,EAAM,YAAY,CAAQ,KAAK,EAAK,MAAM,cAAc,EAAM,OAAO,CAAQ,CAAC;AACrK;AAIA,SAAS,EAAkB,GAA0B,GAA4B;CAC7E,IAAM,IAAS,EAA0B,EAAQ,CAAC;CAClD,OAAO,EAAO,MAAa,EAAA,MAA6B;AAC5D"}
1	+ {"version":3,"file":"dpuse-shared-encoding.es.js","names":[],"sources":["../src/encoding/index.ts"],"sourcesContent":["// ── DPUse Framework\nimport { DEFAULT_LOCALE_ID, type LocaleId, type LocaleLabel } from '@/locale/label';\n\n// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type EncodingGroupId = keyof typeof ENCODING_GROUP_CONFIG_DATA;\nexport type EncodingTypeId = keyof typeof ENCODING_TYPE_CONFIG_DATA;\n\nexport interface EncodingGroupConfig {\n id: EncodingGroupId;\n label: LocaleLabel;\n}\n\nexport interface EncodingTypeConfig {\n id: EncodingTypeId;\n groupId: EncodingGroupId \| null; // Null for encodings that belong to no group, e.g. 'ascii' and 'utf-8'.\n isDetectable: boolean;\n isDecodable: boolean;\n}\nexport interface EncodingTypeConfigLocalised {\n id: EncodingTypeId;\n groupLabel: string;\n label: string;\n isDetectable: boolean;\n isDecodable: boolean;\n}\n\nexport interface EncodingDetectionConfig {\n id: EncodingTypeId;\n confidenceLevel: number \| undefined;\n}\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst ENCODING_GROUP_CONFIG_DATA = {\n arabic: { id: 'arabic', label: { en: 'Arabic', es: 'Árabe' } },\n baltic: { id: 'baltic', label: { en: 'Baltic', es: 'Báltico' } },\n celtic: { id: 'celtic', label: { en: 'Celtic', es: 'Celta' } },\n centralEuropean: { id: 'centralEuropean', label: { en: 'Central European', es: 'Centroeuropeo' } },\n chineseSimplified: { id: 'chineseSimplified', label: { en: 'Chinese Simplified', es: 'Chino simplificado' } },\n chineseTraditional: { id: 'chineseTraditional', label: { en: 'Chinese Traditional', es: 'Chino tradicional' } },\n cyrillic: { id: 'cyrillic', label: { en: 'Cyrillic', es: 'Cirílico' } },\n greek: { id: 'greek', label: { en: 'Greek', es: 'Griego' } },\n hebrew: { id: 'hebrew', label: { en: 'Hebrew', es: 'Hebreo' } },\n japanese: { id: 'japanese', label: { en: 'Japanese', es: 'Japonés' } },\n korean: { id: 'korean', label: { en: 'Korean', es: 'Coreano' } },\n nordic: { id: 'nordic', label: { en: 'Nordic', es: 'Nórdico' } },\n other: { id: 'other', label: { en: 'Other', es: 'Otro' } },\n romanian: { id: 'romanian', label: { en: 'Romanian', es: 'Rumano' } },\n southernEuropean: { id: 'southernEuropean', label: { en: 'Southern European', es: 'Europeo meridional' } },\n thai: { id: 'thai', label: { en: 'Thai', es: 'Tailandés' } },\n turkish: { id: 'turkish', label: { en: 'Turkish', es: 'Turco' } },\n unicode16: { id: 'unicode16', label: { en: 'Unicode 16', es: 'Unicode 16' } },\n unicode32: { id: 'unicode32', label: { en: 'Unicode 32', es: 'Unicode 32' } },\n vietnamese: { id: 'vietnamese', label: { en: 'Vietnamese', es: 'Vietnamita' } },\n western: { id: 'western', label: { en: 'Western', es: 'Occidental' } }\n} as const satisfies Record<string, { id: string; label: LocaleLabel }>;\n\nconst ENCODING_TYPE_CONFIG_DATA = {\n ascii: { id: 'ascii', groupId: null, isDetectable: false, isDecodable: true },\n big5: { id: 'big5', groupId: 'chineseTraditional', isDetectable: true, isDecodable: true },\n 'euc-jp': { id: 'euc-jp', groupId: 'japanese', isDetectable: true, isDecodable: true },\n 'euc-kr': { id: 'euc-kr', groupId: 'korean', isDetectable: true, isDecodable: true },\n gb18030: { id: 'gb18030', groupId: 'chineseSimplified', isDetectable: true, isDecodable: true },\n gbk: { id: 'gbk', groupId: 'chineseSimplified', isDetectable: false, isDecodable: true },\n ibm866: { id: 'ibm866', groupId: 'cyrillic', isDetectable: false, isDecodable: true },\n 'iso-2022-cn': { id: 'iso-2022-cn', groupId: 'chineseSimplified', isDetectable: true, isDecodable: false },\n 'iso-2022-jp': { id: 'iso-2022-jp', groupId: 'japanese', isDetectable: true, isDecodable: true },\n 'iso-2022-kr': { id: 'iso-2022-kr', groupId: 'korean', isDetectable: true, isDecodable: false },\n 'iso-8859-1': { id: 'iso-8859-1', groupId: 'western', isDetectable: true, isDecodable: true },\n 'iso-8859-2': { id: 'iso-8859-2', groupId: 'centralEuropean', isDetectable: true, isDecodable: true },\n 'iso-8859-3': { id: 'iso-8859-3', groupId: 'southernEuropean', isDetectable: false, isDecodable: true },\n 'iso-8859-4': { id: 'iso-8859-4', groupId: 'baltic', isDetectable: false, isDecodable: true },\n 'iso-8859-5': { id: 'iso-8859-5', groupId: 'cyrillic', isDetectable: true, isDecodable: true },\n 'iso-8859-6': { id: 'iso-8859-6', groupId: 'arabic', isDetectable: true, isDecodable: true },\n 'iso-8859-7': { id: 'iso-8859-7', groupId: 'greek', isDetectable: true, isDecodable: true },\n 'iso-8859-8': { id: 'iso-8859-8', groupId: 'hebrew', isDetectable: true, isDecodable: true },\n 'iso-8859-9': { id: 'iso-8859-9', groupId: 'turkish', isDetectable: true, isDecodable: true },\n 'iso-8859-10': { id: 'iso-8859-10', groupId: 'nordic', isDetectable: false, isDecodable: true },\n 'iso-8859-11': { id: 'iso-8859-11', groupId: 'thai', isDetectable: false, isDecodable: true },\n 'iso-8859-13': { id: 'iso-8859-13', groupId: 'baltic', isDetectable: false, isDecodable: true },\n 'iso-8859-14': { id: 'iso-8859-14', groupId: 'celtic', isDetectable: false, isDecodable: true },\n 'iso-8859-15': { id: 'iso-8859-15', groupId: 'western', isDetectable: false, isDecodable: true },\n 'iso-8859-16': { id: 'iso-8859-16', groupId: 'romanian', isDetectable: false, isDecodable: true },\n 'koi8-r': { id: 'koi8-r', groupId: 'cyrillic', isDetectable: true, isDecodable: true },\n 'koi8-u': { id: 'koi8-u', groupId: 'cyrillic', isDetectable: false, isDecodable: true },\n latin1: { id: 'latin1', groupId: 'western', isDetectable: false, isDecodable: true },\n macintosh: { id: 'macintosh', groupId: 'western', isDetectable: false, isDecodable: true },\n shift_jis: { id: 'shift_jis', groupId: 'japanese', isDetectable: true, isDecodable: true },\n 'tis-620': { id: 'tis-620', groupId: 'thai', isDetectable: false, isDecodable: true },\n 'utf-16': { id: 'utf-16', groupId: 'unicode16', isDetectable: false, isDecodable: true },\n 'utf-16be': { id: 'utf-16be', groupId: 'unicode16', isDetectable: true, isDecodable: true },\n 'utf-16le': { id: 'utf-16le', groupId: 'unicode16', isDetectable: true, isDecodable: true },\n 'utf-32be': { id: 'utf-32be', groupId: 'unicode32', isDetectable: true, isDecodable: false },\n 'utf-32le': { id: 'utf-32le', groupId: 'unicode32', isDetectable: true, isDecodable: false },\n 'utf-8': { id: 'utf-8', groupId: null, isDetectable: true, isDecodable: true },\n 'windows-1250': { id: 'windows-1250', groupId: 'centralEuropean', isDetectable: true, isDecodable: true },\n 'windows-1251': { id: 'windows-1251', groupId: 'cyrillic', isDetectable: true, isDecodable: true },\n 'windows-1252': { id: 'windows-1252', groupId: 'western', isDetectable: true, isDecodable: true },\n 'windows-1253': { id: 'windows-1253', groupId: 'greek', isDetectable: true, isDecodable: true },\n 'windows-1254': { id: 'windows-1254', groupId: 'turkish', isDetectable: true, isDecodable: true },\n 'windows-1255': { id: 'windows-1255', groupId: 'hebrew', isDetectable: true, isDecodable: true },\n 'windows-1256': { id: 'windows-1256', groupId: 'arabic', isDetectable: true, isDecodable: true },\n 'windows-1257': { id: 'windows-1257', groupId: 'baltic', isDetectable: false, isDecodable: true },\n 'windows-1258': { id: 'windows-1258', groupId: 'vietnamese', isDetectable: false, isDecodable: true },\n 'windows-874': { id: 'windows-874', groupId: 'thai', isDetectable: false, isDecodable: true },\n 'x-mac-cyrillic': { id: 'x-mac-cyrillic', groupId: 'cyrillic', isDetectable: false, isDecodable: true },\n 'x-user-defined': { id: 'x-user-defined', groupId: 'other', isDetectable: false, isDecodable: true }\n} as const satisfies Record<string, { id: string; groupId: keyof typeof ENCODING_GROUP_CONFIG_DATA \| null; isDetectable: boolean; isDecodable: boolean }>;\n\nexport const ENCODING_GROUP_CONFIG_MAP = ENCODING_GROUP_CONFIG_DATA as Record<EncodingGroupId, EncodingGroupConfig>;\nexport const ENCODING_TYPE_CONFIG_MAP = ENCODING_TYPE_CONFIG_DATA as Record<EncodingTypeId, EncodingTypeConfig>;\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Narrows a name from outside the app, such as one reported by encoding detection, to a known encoding id. Check with\n// this once where the name arrives, so everything after it works with 'EncodingTypeId'.\nexport function isEncodingTypeId(value: string): value is EncodingTypeId {\n return Object.hasOwn(ENCODING_TYPE_CONFIG_MAP, value);\n}\n\nexport function getEncodingTypeConfigs(localeId: LocaleId = DEFAULT_LOCALE_ID): EncodingTypeConfigLocalised[] {\n const encodingTypeConfigs: EncodingTypeConfigLocalised[] = Array.from(Object.values(ENCODING_TYPE_CONFIG_MAP), ({ groupId, id, isDecodable, isDetectable }) => {\n const groupLabel = groupId == null ? '' : resolveGroupLabel(groupId, localeId);\n return { id, groupLabel, label: groupLabel ? `${groupLabel} (${id})` : id, isDetectable, isDecodable };\n });\n return encodingTypeConfigs.toSorted((left, right) => left.groupLabel.localeCompare(right.groupLabel, localeId) \|\| left.label.localeCompare(right.label, localeId));\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nfunction resolveGroupLabel(groupId: EncodingGroupId, localeId: LocaleId): string {\n const labels = ENCODING_GROUP_CONFIG_MAP[groupId].label;\n return labels[localeId] ?? labels[DEFAULT_LOCALE_ID] ?? groupId;\n}\n"],"mappings":";;AAkCA,IAAM,IAA6B;CAC/B,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAQ;CAAE;CAC7D,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAU;CAAE;CAC/D,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAQ;CAAE;CAC7D,iBAAiB;EAAE,IAAI;EAAmB,OAAO;GAAE,IAAI;GAAoB,IAAI;EAAgB;CAAE;CACjG,mBAAmB;EAAE,IAAI;EAAqB,OAAO;GAAE,IAAI;GAAsB,IAAI;EAAqB;CAAE;CAC5G,oBAAoB;EAAE,IAAI;EAAsB,OAAO;GAAE,IAAI;GAAuB,IAAI;EAAoB;CAAE;CAC9G,UAAU;EAAE,IAAI;EAAY,OAAO;GAAE,IAAI;GAAY,IAAI;EAAW;CAAE;CACtE,OAAO;EAAE,IAAI;EAAS,OAAO;GAAE,IAAI;GAAS,IAAI;EAAS;CAAE;CAC3D,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAS;CAAE;CAC9D,UAAU;EAAE,IAAI;EAAY,OAAO;GAAE,IAAI;GAAY,IAAI;EAAU;CAAE;CACrE,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAU;CAAE;CAC/D,QAAQ;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAU;CAAE;CAC/D,OAAO;EAAE,IAAI;EAAS,OAAO;GAAE,IAAI;GAAS,IAAI;EAAO;CAAE;CACzD,UAAU;EAAE,IAAI;EAAY,OAAO;GAAE,IAAI;GAAY,IAAI;EAAS;CAAE;CACpE,kBAAkB;EAAE,IAAI;EAAoB,OAAO;GAAE,IAAI;GAAqB,IAAI;EAAqB;CAAE;CACzG,MAAM;EAAE,IAAI;EAAQ,OAAO;GAAE,IAAI;GAAQ,IAAI;EAAY;CAAE;CAC3D,SAAS;EAAE,IAAI;EAAW,OAAO;GAAE,IAAI;GAAW,IAAI;EAAQ;CAAE;CAChE,WAAW;EAAE,IAAI;EAAa,OAAO;GAAE,IAAI;GAAc,IAAI;EAAa;CAAE;CAC5E,WAAW;EAAE,IAAI;EAAa,OAAO;GAAE,IAAI;GAAc,IAAI;EAAa;CAAE;CAC5E,YAAY;EAAE,IAAI;EAAc,OAAO;GAAE,IAAI;GAAc,IAAI;EAAa;CAAE;CAC9E,SAAS;EAAE,IAAI;EAAW,OAAO;GAAE,IAAI;GAAW,IAAI;EAAa;CAAE;AACzE,GAEM,IAA4B;CAC9B,OAAO;EAAE,IAAI;EAAS,SAAS;EAAM,cAAc;EAAO,aAAa;CAAK;CAC5E,MAAM;EAAE,IAAI;EAAQ,SAAS;EAAsB,cAAc;EAAM,aAAa;CAAK;CACzF,UAAU;EAAE,IAAI;EAAU,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CACrF,UAAU;EAAE,IAAI;EAAU,SAAS;EAAU,cAAc;EAAM,aAAa;CAAK;CACnF,SAAS;EAAE,IAAI;EAAW,SAAS;EAAqB,cAAc;EAAM,aAAa;CAAK;CAC9F,KAAK;EAAE,IAAI;EAAO,SAAS;EAAqB,cAAc;EAAO,aAAa;CAAK;CACvF,QAAQ;EAAE,IAAI;EAAU,SAAS;EAAY,cAAc;EAAO,aAAa;CAAK;CACpF,eAAe;EAAE,IAAI;EAAe,SAAS;EAAqB,cAAc;EAAM,aAAa;CAAM;CACzG,eAAe;EAAE,IAAI;EAAe,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CAC/F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAU,cAAc;EAAM,aAAa;CAAM;CAC9F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAW,cAAc;EAAM,aAAa;CAAK;CAC5F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAmB,cAAc;EAAM,aAAa;CAAK;CACpG,cAAc;EAAE,IAAI;EAAc,SAAS;EAAoB,cAAc;EAAO,aAAa;CAAK;CACtG,cAAc;EAAE,IAAI;EAAc,SAAS;EAAU,cAAc;EAAO,aAAa;CAAK;CAC5F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CAC7F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAU,cAAc;EAAM,aAAa;CAAK;CAC3F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAS,cAAc;EAAM,aAAa;CAAK;CAC1F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAU,cAAc;EAAM,aAAa;CAAK;CAC3F,cAAc;EAAE,IAAI;EAAc,SAAS;EAAW,cAAc;EAAM,aAAa;CAAK;CAC5F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAU,cAAc;EAAO,aAAa;CAAK;CAC9F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAQ,cAAc;EAAO,aAAa;CAAK;CAC5F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAU,cAAc;EAAO,aAAa;CAAK;CAC9F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAU,cAAc;EAAO,aAAa;CAAK;CAC9F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAW,cAAc;EAAO,aAAa;CAAK;CAC/F,eAAe;EAAE,IAAI;EAAe,SAAS;EAAY,cAAc;EAAO,aAAa;CAAK;CAChG,UAAU;EAAE,IAAI;EAAU,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CACrF,UAAU;EAAE,IAAI;EAAU,SAAS;EAAY,cAAc;EAAO,aAAa;CAAK;CACtF,QAAQ;EAAE,IAAI;EAAU,SAAS;EAAW,cAAc;EAAO,aAAa;CAAK;CACnF,WAAW;EAAE,IAAI;EAAa,SAAS;EAAW,cAAc;EAAO,aAAa;CAAK;CACzF,WAAW;EAAE,IAAI;EAAa,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CACzF,WAAW;EAAE,IAAI;EAAW,SAAS;EAAQ,cAAc;EAAO,aAAa;CAAK;CACpF,UAAU;EAAE,IAAI;EAAU,SAAS;EAAa,cAAc;EAAO,aAAa;CAAK;CACvF,YAAY;EAAE,IAAI;EAAY,SAAS;EAAa,cAAc;EAAM,aAAa;CAAK;CAC1F,YAAY;EAAE,IAAI;EAAY,SAAS;EAAa,cAAc;EAAM,aAAa;CAAK;CAC1F,YAAY;EAAE,IAAI;EAAY,SAAS;EAAa,cAAc;EAAM,aAAa;CAAM;CAC3F,YAAY;EAAE,IAAI;EAAY,SAAS;EAAa,cAAc;EAAM,aAAa;CAAM;CAC3F,SAAS;EAAE,IAAI;EAAS,SAAS;EAAM,cAAc;EAAM,aAAa;CAAK;CAC7E,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAmB,cAAc;EAAM,aAAa;CAAK;CACxG,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAY,cAAc;EAAM,aAAa;CAAK;CACjG,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAW,cAAc;EAAM,aAAa;CAAK;CAChG,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAS,cAAc;EAAM,aAAa;CAAK;CAC9F,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAW,cAAc;EAAM,aAAa;CAAK;CAChG,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAU,cAAc;EAAM,aAAa;CAAK;CAC/F,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAU,cAAc;EAAM,aAAa;CAAK;CAC/F,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAU,cAAc;EAAO,aAAa;CAAK;CAChG,gBAAgB;EAAE,IAAI;EAAgB,SAAS;EAAc,cAAc;EAAO,aAAa;CAAK;CACpG,eAAe;EAAE,IAAI;EAAe,SAAS;EAAQ,cAAc;EAAO,aAAa;CAAK;CAC5F,kBAAkB;EAAE,IAAI;EAAkB,SAAS;EAAY,cAAc;EAAO,aAAa;CAAK;CACtG,kBAAkB;EAAE,IAAI;EAAkB,SAAS;EAAS,cAAc;EAAO,aAAa;CAAK;AACvG,GAEa,IAA4B,GAC5B,IAA2B;AAMxC,SAAgB,EAAiB,GAAwC;CACrE,OAAO,OAAO,OAAO,GAA0B,CAAK;AACxD;AAEA,SAAgB,EAAuB,IAAA,MAAuE;CAK1G,OAJ2D,MAAM,KAAK,OAAO,OAAO,CAAwB,IAAI,EAAE,YAAS,OAAI,gBAAa,sBAAmB;EAC3J,IAAM,IAAa,KAAW,OAAO,KAAK,EAAkB,GAAS,CAAQ;EAC7E,OAAO;GAAE;GAAI;GAAY,OAAO,IAAa,GAAG,EAAW,IAAI,EAAG,KAAK;GAAI;GAAc;EAAY;CACzG,CACO,CAAA,CAAoB,UAAU,GAAM,MAAU,EAAK,WAAW,cAAc,EAAM,YAAY,CAAQ,KAAK,EAAK,MAAM,cAAc,EAAM,OAAO,CAAQ,CAAC;AACrK;AAIA,SAAS,EAAkB,GAA0B,GAA4B;CAC7E,IAAM,IAAS,EAA0B,EAAQ,CAAC;CAClD,OAAO,EAAO,MAAa,EAAA,MAA6B;AAC5D"}

package/dist/dpuse-shared-errors.es.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dpuse-shared-errors.es.js","names":[],"sources":["../src/errors/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Serializable representation of an error; used for transporting errors across api and worker boundaries\nexport interface SerialisedError {\n data: Record<string, unknown> \| undefined;\n locator: string; // Error locator 'package.module.method'\n message: string; // Human-readable error message\n name: string; // Error class or type name\n stack: string \| undefined; // Stack trace if available\n}\n\n// ── Constants ───────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst RESPONSE_ERROR_BODY_LIMIT = 2048;\n\n// ── Errors ───────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Base class for all DPUse errors; includes a locator for the error; never thrown directly\nexport class DPUseError extends Error {\n readonly data: Record<string, unknown> \| undefined;\n readonly locator: string; // Error locator 'package.module.method'\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, options);\n this.name = 'DPUseError';\n this.data = data;\n this.locator = locator;\n }\n}\n\n// Thrown when an app (studio/assistant) error occurs\nexport class AppError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'AppError';\n }\n}\n\n// Thrown when an API request fails\nexport class APIError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'APIError';\n }\n}\n\n// Thrown when an engine request fails\nexport class EngineError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'EngineError';\n }\n}\n\n// Thrown when an connector operation fails; will always be wrapped in an engine error\nexport class ConnectorError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'ConnectorError';\n }\n}\n\n// Thrown when an HTTP request fails; may include a sanitized portion of the response body for diagnostic purposes\nexport class FetchError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'FetchError';\n }\n}\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fetch error from an HTTP response; includes a text copy of the response body\nexport async function buildFetchError(response: { status: number; statusText: string; text: () => Promise<string> }, message: string, locator: string): Promise<FetchError> {\n const responseStatusStuff = ` - ${response.statusText}`;\n const fetchMessage = `${message} Response status '${String(response.status)}${response.statusText ? responseStatusStuff : ''}' received.`;\n let bodyText: string;\n try {\n bodyText = await response.text();\n } catch (error) {\n const normalised = normalizeToError(error);\n bodyText = `<body unavailable: ${normalised.message}>`;\n }\n return new FetchError(fetchMessage, locator, { body: sanitizeResponseErrorBody(bodyText) });\n}\n\n// Concatenates serialized error messages into a single string\nexport function concatenateSerialisedErrorMessages(serialisedErrors: SerialisedError[]): string {\n return serialisedErrors.map((serialisedError) => serialisedError.message).join(' ');\n}\n\n// Ignore best-effort cleanup errors to keep teardown noise-free\nexport function ignoreErrors(action: () => void): void {\n try {\n action();\n } catch {\n // Intentionally ignore errors\n }\n}\n\n// Normalizes an unknown thrown value into an error\nexport function normalizeToError(value: unknown): Error {\n if (value instanceof Error) return value;\n if (typeof value === 'string') return new Error(value);\n if (typeof value === 'number' \|\| typeof value === 'boolean' \|\| typeof value === 'bigint') return new Error(String(value));\n if (typeof value === 'symbol') return new Error(value.description ?? 'Unknown error');\n if (typeof value === 'object') {\n try {\n return new Error(JSON.stringify(value));\n } catch {\n return new Error('Unknown error');\n }\n }\n return new Error('Unknown error');\n}\n\n// Serializes an error and its cause chain into a array of serialised error objects;\n// errors are ordered from outermost to root cause;\n// cycles in the cause chain are safely ignored;\n// messages are normalized to end with punctuation\nexport function serialiseError(error?: unknown): SerialisedError[] {\n const seenCauses = new Set();\n const serialisedErrors: SerialisedError[] = [];\n let cause: Error \| null = normalizeToError(error);\n while (cause != null && !seenCauses.has(cause)) {\n seenCauses.add(cause);\n const [serialisedError, nextCause] = serialiseSingleError(cause);\n if (!/(?:\\.{3}\|[.!?])$/.test(serialisedError.message)) serialisedError.message += '.';\n serialisedErrors.push(serialisedError);\n cause = nextCause;\n }\n return serialisedErrors;\n}\n\n// Unserialises an array of serialised error objects back into an error with a cause chain;\n// reconstructs the appropriate error class based on serialized properties;\n// chains errors from outermost to root cause using the `cause` option;\n// returns a placeholder error if the input array is empty\nexport function unserialiseError(serialisedErrors: SerialisedError[]): Error {\n // Build the error chain from root cause (end) to outermost (start)\n let rebuiltError: Error \| undefined;\n for (const serialised of serialisedErrors.toReversed()) {\n const error = reconstructError(serialised, rebuiltError);\n if (serialised.stack !== undefined) error.stack = serialised.stack; // Restore stack trace if available\n rebuiltError = error;\n }\n return rebuiltError ?? new Error('No error to unserialise.');\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fallback message for non-error throwables\nfunction buildFallbackMessage(cause: unknown): string {\n let fallbackMessage: string;\n try {\n fallbackMessage = JSON.stringify(cause);\n } catch {\n if (typeof cause === 'symbol') fallbackMessage = cause.description ?? 'Unknown error';\n else if (typeof cause === 'bigint') fallbackMessage = cause.toString();\n else fallbackMessage = 'Unknown error';\n }\n if (fallbackMessage === '') fallbackMessage = 'Unknown error';\n return fallbackMessage;\n}\n\nfunction reconstructError(serialised: SerialisedError, cause: Error \| undefined): Error {\n switch (serialised.name) {\n case 'APIError':\n return new APIError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'AppError':\n return new AppError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'ConnectorError':\n return new ConnectorError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'EngineError':\n return new EngineError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'FetchError':\n return new FetchError(serialised.message, serialised.locator, serialised.data, { cause });\n default: {\n const name = serialised.name;\n return new (class extends Error {\n override name = name;\n })(serialised.message, { cause });\n }\n }\n}\n\n// Sanitizes a response body; limits body size to avoid excessive payloads when logging\nfunction sanitizeResponseErrorBody(body?: string): string \| undefined {\n if (body == null \|\| body === '') return undefined;\n return body.length > RESPONSE_ERROR_BODY_LIMIT ? `${body.slice(0, RESPONSE_ERROR_BODY_LIMIT)}... [truncated]` : body;\n}\n\nfunction serialiseSingleError(cause: Error): [SerialisedError, Error \| null] {\n const nextCause = cause.cause == null ? null : normalizeToError(cause.cause);\n if (cause instanceof DPUseError) {\n return [{ data: cause.data, locator: cause.locator, message: cause.message, name: cause.name, stack: cause.stack }, nextCause];\n }\n const customProperties = Object.fromEntries(Object.entries(cause).filter(([k]) => k !== 'cause'));\n return cause.name\n ? [{ data: customProperties, locator: '', message: cause.message, name: cause.name, stack: cause.stack }, nextCause]\n : [{ data: customProperties, locator: '', message: buildFallbackMessage(cause), name: 'Error', stack: undefined }, null];\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"dpuse-shared-errors.es.js","names":[],"sources":["../src/errors/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Serializable representation of an error; used for transporting errors across api and worker boundaries\nexport interface SerialisedError {\n data: Record<string, unknown> \| undefined;\n locator: string; // Error locator 'package.module.method'\n message: string; // Human-readable error message\n name: string; // Error class or type name\n stack: string \| undefined; // Stack trace if available\n}\n\n// ── Constants ───────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst RESPONSE_ERROR_BODY_LIMIT = 2048;\n\n// ── Errors ───────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Base class for all DPUse errors; includes a locator for the error; never thrown directly\nexport class DPUseError extends Error {\n readonly data: Record<string, unknown> \| undefined;\n readonly locator: string; // Error locator 'package.module.method'\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, options);\n this.name = 'DPUseError';\n this.data = data;\n this.locator = locator;\n }\n}\n\n// Thrown when an app (studio/assistant) error occurs\nexport class AppError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'AppError';\n }\n}\n\n// Thrown when an API request fails\nexport class APIError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'APIError';\n }\n}\n\n// Thrown when an engine request fails\nexport class EngineError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'EngineError';\n }\n}\n\n// Thrown when an connector operation fails; will always be wrapped in an engine error\nexport class ConnectorError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'ConnectorError';\n }\n}\n\n// Thrown when an HTTP request fails; may include a sanitized portion of the response body for diagnostic purposes\nexport class FetchError extends DPUseError {\n constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n super(message, locator, data, options);\n this.name = 'FetchError';\n }\n}\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fetch error from an HTTP response; includes a text copy of the response body\nexport async function buildFetchError(response: { status: number; statusText: string; text: () => Promise<string> }, message: string, locator: string): Promise<FetchError> {\n const responseStatusStuff = ` - ${response.statusText}`;\n const fetchMessage = `${message} Response status '${String(response.status)}${response.statusText ? responseStatusStuff : ''}' received.`;\n let bodyText: string;\n try {\n bodyText = await response.text();\n } catch (error) {\n const normalised = normalizeToError(error);\n bodyText = `<body unavailable: ${normalised.message}>`;\n }\n return new FetchError(fetchMessage, locator, { body: sanitizeResponseErrorBody(bodyText) });\n}\n\n// Concatenates serialized error messages into a single string\nexport function concatenateSerialisedErrorMessages(serialisedErrors: SerialisedError[]): string {\n return serialisedErrors.map((serialisedError) => serialisedError.message).join(' ');\n}\n\n// Ignore best-effort cleanup errors to keep teardown noise-free\nexport function ignoreErrors(action: () => void): void {\n try {\n action();\n } catch {\n // Intentionally ignore errors\n }\n}\n\n// Normalizes an unknown thrown value into an error\nexport function normalizeToError(value: unknown): Error {\n if (value instanceof Error) return value;\n if (typeof value === 'string') return new Error(value);\n if (typeof value === 'number' \|\| typeof value === 'boolean' \|\| typeof value === 'bigint') return new Error(String(value));\n if (typeof value === 'symbol') return new Error(value.description ?? 'Unknown error');\n if (typeof value === 'object') {\n try {\n return new Error(JSON.stringify(value));\n } catch {\n return new Error('Unknown error');\n }\n }\n return new Error('Unknown error');\n}\n\n// Serializes an error and its cause chain into a array of serialised error objects;\n// errors are ordered from outermost to root cause;\n// cycles in the cause chain are safely ignored;\n// messages are normalized to end with punctuation\nexport function serialiseError(error?: unknown): SerialisedError[] {\n const seenCauses = new Set();\n const serialisedErrors: SerialisedError[] = [];\n let cause: Error \| null = normalizeToError(error);\n while (cause != null && !seenCauses.has(cause)) {\n seenCauses.add(cause);\n const [serialisedError, nextCause] = serialiseSingleError(cause);\n if (!/(?:\\.{3}\|[.!?])$/.test(serialisedError.message)) serialisedError.message += '.';\n serialisedErrors.push(serialisedError);\n cause = nextCause;\n }\n return serialisedErrors;\n}\n\n// Unserialises an array of serialised error objects back into an error with a cause chain;\n// reconstructs the appropriate error class based on serialized properties;\n// chains errors from outermost to root cause using the `cause` option;\n// returns a placeholder error if the input array is empty\nexport function unserialiseError(serialisedErrors: SerialisedError[]): Error {\n // Build the error chain from root cause (end) to outermost (start)\n let rebuiltError: Error \| undefined;\n for (const serialised of serialisedErrors.toReversed()) {\n const error = reconstructError(serialised, rebuiltError);\n if (serialised.stack !== undefined) error.stack = serialised.stack; // Restore stack trace if available\n rebuiltError = error;\n }\n return rebuiltError ?? new Error('No error to unserialise.');\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fallback message for non-error throwables\nfunction buildFallbackMessage(cause: unknown): string {\n let fallbackMessage: string;\n try {\n fallbackMessage = JSON.stringify(cause);\n } catch {\n if (typeof cause === 'symbol') fallbackMessage = cause.description ?? 'Unknown error';\n else if (typeof cause === 'bigint') fallbackMessage = cause.toString();\n else fallbackMessage = 'Unknown error';\n }\n if (fallbackMessage === '') fallbackMessage = 'Unknown error';\n return fallbackMessage;\n}\n\nfunction reconstructError(serialised: SerialisedError, cause: Error \| undefined): Error {\n switch (serialised.name) {\n case 'APIError':\n return new APIError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'AppError':\n return new AppError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'ConnectorError':\n return new ConnectorError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'EngineError':\n return new EngineError(serialised.message, serialised.locator, serialised.data, { cause });\n case 'FetchError':\n return new FetchError(serialised.message, serialised.locator, serialised.data, { cause });\n default: {\n const name = serialised.name;\n return new (class extends Error {\n override name = name;\n })(serialised.message, { cause });\n }\n }\n}\n\n// Sanitizes a response body; limits body size to avoid excessive payloads when logging\nfunction sanitizeResponseErrorBody(body?: string): string \| undefined {\n if (body == null \|\| body === '') return undefined;\n return body.length > RESPONSE_ERROR_BODY_LIMIT ? `${body.slice(0, RESPONSE_ERROR_BODY_LIMIT)}... [truncated]` : body;\n}\n\nfunction serialiseSingleError(cause: Error): [SerialisedError, Error \| null] {\n const nextCause = cause.cause == null ? null : normalizeToError(cause.cause);\n if (cause instanceof DPUseError) {\n return [{ data: cause.data, locator: cause.locator, message: cause.message, name: cause.name, stack: cause.stack }, nextCause];\n }\n const customProperties = Object.fromEntries(Object.entries(cause).filter(([k]) => k !== 'cause'));\n return cause.name\n ? [{ data: customProperties, locator: '', message: cause.message, name: cause.name, stack: cause.stack }, nextCause]\n : [{ data: customProperties, locator: '', message: buildFallbackMessage(cause), name: 'Error', stack: undefined }, null];\n}\n"],"mappings":"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"}

package/dist/dpuse-shared-utilities.es.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dpuse-shared-utilities.es.js","names":[],"sources":["../src/utilities/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\ntype DurationLevel = 'days' \| 'hrs' \| 'mins' \| 'secs' \| 'ms';\ntype DurationLevelTuple = [DurationLevel, number, (n: number) => string];\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst DURATION_LEVELS: DurationLevelTuple[] = [\n ['days', 86_400_000, (n: number): string => (n === 1 ? '1 day' : `${formatNumberAsWholeNumber(n)} days`)],\n ['hrs', 3_600_000, (n: number): string => (n === 1 ? '1 hr' : `${formatNumberAsWholeNumber(n)} hrs`)],\n ['mins', 60_000, (n: number): string => (n === 1 ? '1 min' : `${formatNumberAsWholeNumber(n)} mins`)],\n ['secs', 1000, (n: number): string => (n === 1 ? '1 sec' : `${formatNumberAsWholeNumber(n)} secs`)],\n ['ms', 0, (n: number): string => `${formatNumberAsWholeNumber(n)} ms`]\n];\n\nconst NUMBER_FORMATTER_DEFAULT_LOCALE = 'en';\nconst NUMBER_FORMATTER_MAP = new Map<string, Intl.NumberFormat>();\n\n// ── Actions - Data Type Conversion ───────────────────────────────────────────────────────────────────────────────────\n\n// See: https://www.odata.org/documentation/odata-version-2-0/overview/.\nexport function convertODataTypeIdToUsageTypeId(oDataTypeId: string): string {\n switch (oDataTypeId) {\n case 'Edm.Binary':\n return 'unknown'; // Binary...\n case 'Edm.Boolean':\n return 'boolean';\n case 'Edm.Byte':\n return 'wholeNumber';\n case 'Edm.DateTime':\n return 'moment'; // DateTime...\n case 'Edm.DateTimeOffset':\n return 'moment'; // DateTimeOffset...\n case 'Edm.Decimal':\n return 'decimalNumber';\n case 'Edm.Double':\n return 'decimalNumber';\n case 'Edm.Guid':\n return 'string';\n case 'Edm.Int16':\n return 'wholeNumber';\n case 'Edm.Int32':\n return 'wholeNumber';\n case 'Edm.Int64':\n return 'wholeNumber';\n case 'Edm.SByte':\n return 'wholeNumber';\n case 'Edm.Single':\n return 'decimalNumber';\n case 'Edm.String':\n return 'string';\n case 'Edm.Time':\n return 'momentTime'; // Time...\n default:\n return 'unknown';\n }\n}\n\n// ── Actions - File Path Segment Extraction ───────────────────────────────────────────────────────────────────────────\n\n// Extract the path without its final basename extension.\n// Dots in parent directories are ignored, and leading dots in the basename\n// are treated as part of dotfile names rather than as an extension separator.\nexport function extractNameFromPath(itemPath: string): string \| undefined {\n if (itemPath) {\n const lastSeparatorIndex = itemPath.lastIndexOf('/');\n const basenameStartIndex = lastSeparatorIndex + 1;\n const lastExtensionIndex = itemPath.lastIndexOf('.');\n if (lastExtensionIndex <= basenameStartIndex) return itemPath;\n return lastExtensionIndex === -1 ? itemPath : itemPath.slice(0, Math.max(0, lastExtensionIndex));\n }\n return undefined;\n}\n\n// Extract only the final basename extension.\n// Returns undefined when the basename has no extension, including dotfiles such\n// as .gitignore where the only dot is the leading character of the basename.\nexport function extractExtensionFromPath(itemPath: string): string \| undefined {\n if (itemPath) {\n const lastSeparatorIndex = itemPath.lastIndexOf('/');\n const basenameStartIndex = lastSeparatorIndex + 1;\n const lastExtensionIndex = itemPath.lastIndexOf('.');\n if (lastExtensionIndex <= basenameStartIndex) return undefined;\n if (lastExtensionIndex !== -1) return itemPath.slice(Math.max(0, lastExtensionIndex + 1));\n }\n return undefined;\n}\n\n// ── Actions - String Formatting ──────────────────────────────────────────────────────────────────────────────────────\n\nexport function formatNumberAsDecimalNumber(number?: number, decimalPlaces = 2, minimumFractionDigits = decimalPlaces, locale = NUMBER_FORMATTER_DEFAULT_LOCALE): string {\n if (number == null) return '';\n const formatterId = `${locale}decimal${String(decimalPlaces)}.${String(minimumFractionDigits)}`;\n let numberFormatter = NUMBER_FORMATTER_MAP.get(formatterId);\n if (!numberFormatter) {\n numberFormatter = new Intl.NumberFormat(locale, {\n localeMatcher: 'best fit',\n maximumFractionDigits: decimalPlaces,\n minimumFractionDigits,\n minimumIntegerDigits: 1,\n style: 'decimal',\n useGrouping: true\n });\n NUMBER_FORMATTER_MAP.set(formatterId, numberFormatter);\n }\n return numberFormatter.format(number);\n}\n\nexport function formatNumberAsSize(number?: number, decimalPlaces = 1): string {\n if (number == null) return '';\n if (number < 1000) return formatNumberAsWholeNumber(number);\n if (number < 1_000_000) return `${formatNumberAsDecimalNumber(number / 1000, decimalPlaces, 0)}K`;\n if (number < 1_000_000_000) return `${formatNumberAsDecimalNumber(number / 1_000_000, decimalPlaces, 0)}M`;\n return number < 1_000_000_000_000\n ? `${formatNumberAsDecimalNumber(number / 1_000_000_000, decimalPlaces, 0)}B`\n : `${formatNumberAsDecimalNumber(number / 1_000_000_000_000, decimalPlaces, 0)}T`;\n}\n\nexport function formatNumberAsStorageSize(number?: number, decimalPlaces = 1): string {\n if (number == null) return '';\n if (number === 1) return '1 byte';\n if (number < 1024) return `${formatNumberAsWholeNumber(number)} bytes`;\n if (number < 1_048_576) return `${formatNumberAsDecimalNumber(number / 1024, decimalPlaces, 0)} KB`;\n if (number < 1_073_741_824) return `${formatNumberAsDecimalNumber(number / 1_048_576, decimalPlaces, 0)} MB`;\n return number < 1_099_511_627_776\n ? `${formatNumberAsDecimalNumber(number / 1_073_741_824, decimalPlaces, 0)} GB`\n : `${formatNumberAsDecimalNumber(number / 1_099_511_627_776, decimalPlaces, 0)} TB`;\n}\n\nexport function formatNumberAsDuration(number?: number, stopAt: DurationLevel = 'ms'): string {\n if (number == null) return '';\n\n // Start at the largest unit the value actually fills, so a value below the requested level still reads sensibly\n // rather than as a run of zeroes.\n const startIndex = DURATION_LEVELS.findIndex(([, threshold]) => number >= threshold);\n const firstIndex = startIndex === -1 ? DURATION_LEVELS.length - 1 : startIndex;\n const stopIndex = DURATION_LEVELS.findIndex(([level]) => level === stopAt);\n\n const durationLevels = DURATION_LEVELS.slice(firstIndex, Math.max(stopIndex, firstIndex) + 1);\n const parts: string[] = [];\n let remaining = number;\n for (const [, threshold, format] of durationLevels) {\n if (remaining < threshold \|\| (remaining === 0 && parts.length > 0)) continue;\n parts.push(format(threshold > 0 ? Math.floor(remaining / threshold) : remaining));\n remaining %= threshold > 0 ? threshold : 1;\n }\n return parts.join(' ');\n}\n\nexport function formatNumberAsWholeNumber(number?: number, locale = NUMBER_FORMATTER_DEFAULT_LOCALE): string {\n if (number == null) return '';\n const formatterId = `${locale}decimal0.0`;\n let numberFormatter = NUMBER_FORMATTER_MAP.get(formatterId);\n if (!numberFormatter) {\n numberFormatter = new Intl.NumberFormat(locale, {\n localeMatcher: 'best fit',\n maximumFractionDigits: 0,\n minimumFractionDigits: 0,\n minimumIntegerDigits: 1,\n style: 'decimal',\n useGrouping: true\n });\n NUMBER_FORMATTER_MAP.set(formatterId, numberFormatter);\n }\n return numberFormatter.format(number);\n}\n\n// ── Actions - Lookup ─────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport function lookupMimeTypeForExtension(extension?: string): string {\n // Extensions arrive from file names as typed, so 'REPORT.CSV' must resolve the same as 'report.csv'.\n switch (extension?.toLowerCase()) {\n case 'csv':\n return 'text/csv';\n case 'tab':\n case 'tsv':\n return 'text/tab-separated-values';\n case 'xls':\n return 'application/vnd.ms-excel';\n case 'xlsx':\n return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';\n default:\n return 'application/octet-stream';\n }\n}\n\n// TODO: Do we need this?\n// // export const establishVendorAccessToken = async (item: Item, accountId: string, sessionAccessToken: string, vendorRefreshURI: string): Promise<string> => {\n// export const establishVendorAccessToken = async (connectionConfig: ConnectionConfig, settings: ReadSettings, vendorRefreshURI: string): Promise<string> => {\n// let accessToken;\n//\n// // If the current dropbox access token expires within 5 minutes then refresh it and return the new one, otherwise return the current one.\n// if (connectionConfig.authorisation[''].expires_at - Date.now() < 300000) {\n// // TODO: Above is WRONG 'item.authorization!['']'. We need to know what authorisation.\n// const headers: HeadersInit = {\n// 'Account-Id': settings.accountId \|\| '',\n// Authorization: settings.sessionAccessToken \|\| '',\n// 'Connection-Id': connectionConfig.id\n// };\n// const response = await fetch(vendorRefreshURI, { headers });\n// if (!response.ok) {\n// const data = {\n// body: {\n// context: 'establishVendorAccessToken',\n// message: await response.text()\n// },\n// statusCode: response.status,\n// statusText: response.statusText\n// };\n// throw new Error('Unable to establish access token.\|' + JSON.stringify(data));\n// }\n// accessToken = await response.text();\n// } else {\n// accessToken = connectionConfig.authorisation[''].access_token; // TODO: This is WRONG 'item.authorization!['']'. We need to know what authorisation.\n// }\n//\n// return accessToken;\n// };\n"],"mappings":"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"}
1	+ {"version":3,"file":"dpuse-shared-utilities.es.js","names":[],"sources":["../src/utilities/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\ntype DurationLevel = 'days' \| 'hrs' \| 'mins' \| 'secs' \| 'ms';\ntype DurationLevelTuple = [DurationLevel, number, (n: number) => string];\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst DURATION_LEVELS: DurationLevelTuple[] = [\n ['days', 86_400_000, (n: number): string => (n === 1 ? '1 day' : `${formatNumberAsWholeNumber(n)} days`)],\n ['hrs', 3_600_000, (n: number): string => (n === 1 ? '1 hr' : `${formatNumberAsWholeNumber(n)} hrs`)],\n ['mins', 60_000, (n: number): string => (n === 1 ? '1 min' : `${formatNumberAsWholeNumber(n)} mins`)],\n ['secs', 1000, (n: number): string => (n === 1 ? '1 sec' : `${formatNumberAsWholeNumber(n)} secs`)],\n ['ms', 0, (n: number): string => `${formatNumberAsWholeNumber(n)} ms`]\n];\n\nconst NUMBER_FORMATTER_DEFAULT_LOCALE = 'en';\nconst NUMBER_FORMATTER_MAP = new Map<string, Intl.NumberFormat>();\n\n// ── Actions - Data Type Conversion ───────────────────────────────────────────────────────────────────────────────────\n\n// See: https://www.odata.org/documentation/odata-version-2-0/overview/.\nexport function convertODataTypeIdToUsageTypeId(oDataTypeId: string): string {\n switch (oDataTypeId) {\n case 'Edm.Binary':\n return 'unknown'; // Binary...\n case 'Edm.Boolean':\n return 'boolean';\n case 'Edm.Byte':\n return 'wholeNumber';\n case 'Edm.DateTime':\n return 'moment'; // DateTime...\n case 'Edm.DateTimeOffset':\n return 'moment'; // DateTimeOffset...\n case 'Edm.Decimal':\n return 'decimalNumber';\n case 'Edm.Double':\n return 'decimalNumber';\n case 'Edm.Guid':\n return 'string';\n case 'Edm.Int16':\n return 'wholeNumber';\n case 'Edm.Int32':\n return 'wholeNumber';\n case 'Edm.Int64':\n return 'wholeNumber';\n case 'Edm.SByte':\n return 'wholeNumber';\n case 'Edm.Single':\n return 'decimalNumber';\n case 'Edm.String':\n return 'string';\n case 'Edm.Time':\n return 'momentTime'; // Time...\n default:\n return 'unknown';\n }\n}\n\n// ── Actions - File Path Segment Extraction ───────────────────────────────────────────────────────────────────────────\n\n// Extract the path without its final basename extension.\n// Dots in parent directories are ignored, and leading dots in the basename\n// are treated as part of dotfile names rather than as an extension separator.\nexport function extractNameFromPath(itemPath: string): string \| undefined {\n if (itemPath) {\n const lastSeparatorIndex = itemPath.lastIndexOf('/');\n const basenameStartIndex = lastSeparatorIndex + 1;\n const lastExtensionIndex = itemPath.lastIndexOf('.');\n if (lastExtensionIndex <= basenameStartIndex) return itemPath;\n return lastExtensionIndex === -1 ? itemPath : itemPath.slice(0, Math.max(0, lastExtensionIndex));\n }\n return undefined;\n}\n\n// Extract only the final basename extension.\n// Returns undefined when the basename has no extension, including dotfiles such\n// as .gitignore where the only dot is the leading character of the basename.\nexport function extractExtensionFromPath(itemPath: string): string \| undefined {\n if (itemPath) {\n const lastSeparatorIndex = itemPath.lastIndexOf('/');\n const basenameStartIndex = lastSeparatorIndex + 1;\n const lastExtensionIndex = itemPath.lastIndexOf('.');\n if (lastExtensionIndex <= basenameStartIndex) return undefined;\n if (lastExtensionIndex !== -1) return itemPath.slice(Math.max(0, lastExtensionIndex + 1));\n }\n return undefined;\n}\n\n// ── Actions - String Formatting ──────────────────────────────────────────────────────────────────────────────────────\n\nexport function formatNumberAsDecimalNumber(number?: number, decimalPlaces = 2, minimumFractionDigits = decimalPlaces, locale = NUMBER_FORMATTER_DEFAULT_LOCALE): string {\n if (number == null) return '';\n const formatterId = `${locale}decimal${String(decimalPlaces)}.${String(minimumFractionDigits)}`;\n let numberFormatter = NUMBER_FORMATTER_MAP.get(formatterId);\n if (!numberFormatter) {\n numberFormatter = new Intl.NumberFormat(locale, {\n localeMatcher: 'best fit',\n maximumFractionDigits: decimalPlaces,\n minimumFractionDigits,\n minimumIntegerDigits: 1,\n style: 'decimal',\n useGrouping: true\n });\n NUMBER_FORMATTER_MAP.set(formatterId, numberFormatter);\n }\n return numberFormatter.format(number);\n}\n\nexport function formatNumberAsSize(number?: number, decimalPlaces = 1): string {\n if (number == null) return '';\n if (number < 1000) return formatNumberAsWholeNumber(number);\n if (number < 1_000_000) return `${formatNumberAsDecimalNumber(number / 1000, decimalPlaces, 0)}K`;\n if (number < 1_000_000_000) return `${formatNumberAsDecimalNumber(number / 1_000_000, decimalPlaces, 0)}M`;\n return number < 1_000_000_000_000\n ? `${formatNumberAsDecimalNumber(number / 1_000_000_000, decimalPlaces, 0)}B`\n : `${formatNumberAsDecimalNumber(number / 1_000_000_000_000, decimalPlaces, 0)}T`;\n}\n\nexport function formatNumberAsStorageSize(number?: number, decimalPlaces = 1): string {\n if (number == null) return '';\n if (number === 1) return '1 byte';\n if (number < 1024) return `${formatNumberAsWholeNumber(number)} bytes`;\n if (number < 1_048_576) return `${formatNumberAsDecimalNumber(number / 1024, decimalPlaces, 0)} KB`;\n if (number < 1_073_741_824) return `${formatNumberAsDecimalNumber(number / 1_048_576, decimalPlaces, 0)} MB`;\n return number < 1_099_511_627_776\n ? `${formatNumberAsDecimalNumber(number / 1_073_741_824, decimalPlaces, 0)} GB`\n : `${formatNumberAsDecimalNumber(number / 1_099_511_627_776, decimalPlaces, 0)} TB`;\n}\n\nexport function formatNumberAsDuration(number?: number, stopAt: DurationLevel = 'ms'): string {\n if (number == null) return '';\n\n // Start at the largest unit the value actually fills, so a value below the requested level still reads sensibly\n // rather than as a run of zeroes.\n const startIndex = DURATION_LEVELS.findIndex(([, threshold]) => number >= threshold);\n const firstIndex = startIndex === -1 ? DURATION_LEVELS.length - 1 : startIndex;\n const stopIndex = DURATION_LEVELS.findIndex(([level]) => level === stopAt);\n\n const durationLevels = DURATION_LEVELS.slice(firstIndex, Math.max(stopIndex, firstIndex) + 1);\n const parts: string[] = [];\n let remaining = number;\n for (const [, threshold, format] of durationLevels) {\n if (remaining < threshold \|\| (remaining === 0 && parts.length > 0)) continue;\n parts.push(format(threshold > 0 ? Math.floor(remaining / threshold) : remaining));\n remaining %= threshold > 0 ? threshold : 1;\n }\n return parts.join(' ');\n}\n\nexport function formatNumberAsWholeNumber(number?: number, locale = NUMBER_FORMATTER_DEFAULT_LOCALE): string {\n if (number == null) return '';\n const formatterId = `${locale}decimal0.0`;\n let numberFormatter = NUMBER_FORMATTER_MAP.get(formatterId);\n if (!numberFormatter) {\n numberFormatter = new Intl.NumberFormat(locale, {\n localeMatcher: 'best fit',\n maximumFractionDigits: 0,\n minimumFractionDigits: 0,\n minimumIntegerDigits: 1,\n style: 'decimal',\n useGrouping: true\n });\n NUMBER_FORMATTER_MAP.set(formatterId, numberFormatter);\n }\n return numberFormatter.format(number);\n}\n\n// ── Actions - Lookup ─────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport function lookupMimeTypeForExtension(extension?: string): string {\n // Extensions arrive from file names as typed, so 'REPORT.CSV' must resolve the same as 'report.csv'.\n switch (extension?.toLowerCase()) {\n case 'csv':\n return 'text/csv';\n case 'tab':\n case 'tsv':\n return 'text/tab-separated-values';\n case 'xls':\n return 'application/vnd.ms-excel';\n case 'xlsx':\n return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';\n default:\n return 'application/octet-stream';\n }\n}\n\n// TODO: Do we need this?\n// // export const establishVendorAccessToken = async (item: Item, accountId: string, sessionAccessToken: string, vendorRefreshURI: string): Promise<string> => {\n// export const establishVendorAccessToken = async (connectionConfig: ConnectionConfig, settings: ReadSettings, vendorRefreshURI: string): Promise<string> => {\n// let accessToken;\n//\n// // If the current dropbox access token expires within 5 minutes then refresh it and return the new one, otherwise return the current one.\n// if (connectionConfig.authorisation[''].expires_at - Date.now() < 300000) {\n// // TODO: Above is WRONG 'item.authorization!['']'. We need to know what authorisation.\n// const headers: HeadersInit = {\n// 'Account-Id': settings.accountId \|\| '',\n// Authorization: settings.sessionAccessToken \|\| '',\n// 'Connection-Id': connectionConfig.id\n// };\n// const response = await fetch(vendorRefreshURI, { headers });\n// if (!response.ok) {\n// const data = {\n// body: {\n// context: 'establishVendorAccessToken',\n// message: await response.text()\n// },\n// statusCode: response.status,\n// statusText: response.statusText\n// };\n// throw new Error('Unable to establish access token.\|' + JSON.stringify(data));\n// }\n// accessToken = await response.text();\n// } else {\n// accessToken = connectionConfig.authorisation[''].access_token; // TODO: This is WRONG 'item.authorization!['']'. We need to know what authorisation.\n// }\n//\n// return accessToken;\n// };\n"],"mappings":"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"}

package/dist/types/src/component/module/engine/index.d.ts CHANGED Viewed

@@ -1,11 +1,11 @@
 import { ComponentInstanceConfig } from '../..';
-import { LocalisedEncodingTypeConfig } from '../../../encoding';
+import { EncodingTypeConfigLocalised } from '../../../encoding';
 import { LocaleId } from '../../../locale/label';
 import { LocalisedConfig } from '../../../locale';
 import { ModuleConfig } from '..';
 import { ToolConfig } from '../tool';
 export interface EngineRuntime {
-    getEncodingTypeConfigs: (localeId: LocaleId) => LocalisedEncodingTypeConfig[];
+    getEncodingTypeConfigs: (localeId: LocaleId) => EncodingTypeConfigLocalised[];
     invokeWorker(errorEventCallback: (errorEvent: ErrorEvent) => void): EngineWorker;
 }
 export interface EngineWorker {

package/dist/types/src/encoding/index.d.ts CHANGED Viewed

@@ -1,8 +1,6 @@
 import { LocaleId, LocaleLabel } from '../locale/label';
-import { default as encodingGroupConfigData } from './encodingGroupConfigs.json';
-import { default as encodingTypeConfigData } from './encodingTypeConfigs.json';
-export type EncodingGroupId = keyof typeof encodingGroupConfigData;
-export type EncodingTypeId = keyof typeof encodingTypeConfigData;
+export type EncodingGroupId = keyof typeof ENCODING_GROUP_CONFIG_DATA;
+export type EncodingTypeId = keyof typeof ENCODING_TYPE_CONFIG_DATA;
 export interface EncodingGroupConfig {
     id: EncodingGroupId;
     label: LocaleLabel;
@@ -24,6 +22,453 @@ export interface EncodingDetectionConfig {
     id: EncodingTypeId;
     confidenceLevel: number | undefined;
 }
+declare const ENCODING_GROUP_CONFIG_DATA: {
+    readonly arabic: {
+        readonly id: "arabic";
+        readonly label: {
+            readonly en: "Arabic";
+            readonly es: "Árabe";
+        };
+    };
+    readonly baltic: {
+        readonly id: "baltic";
+        readonly label: {
+            readonly en: "Baltic";
+            readonly es: "Báltico";
+        };
+    };
+    readonly celtic: {
+        readonly id: "celtic";
+        readonly label: {
+            readonly en: "Celtic";
+            readonly es: "Celta";
+        };
+    };
+    readonly centralEuropean: {
+        readonly id: "centralEuropean";
+        readonly label: {
+            readonly en: "Central European";
+            readonly es: "Centroeuropeo";
+        };
+    };
+    readonly chineseSimplified: {
+        readonly id: "chineseSimplified";
+        readonly label: {
+            readonly en: "Chinese Simplified";
+            readonly es: "Chino simplificado";
+        };
+    };
+    readonly chineseTraditional: {
+        readonly id: "chineseTraditional";
+        readonly label: {
+            readonly en: "Chinese Traditional";
+            readonly es: "Chino tradicional";
+        };
+    };
+    readonly cyrillic: {
+        readonly id: "cyrillic";
+        readonly label: {
+            readonly en: "Cyrillic";
+            readonly es: "Cirílico";
+        };
+    };
+    readonly greek: {
+        readonly id: "greek";
+        readonly label: {
+            readonly en: "Greek";
+            readonly es: "Griego";
+        };
+    };
+    readonly hebrew: {
+        readonly id: "hebrew";
+        readonly label: {
+            readonly en: "Hebrew";
+            readonly es: "Hebreo";
+        };
+    };
+    readonly japanese: {
+        readonly id: "japanese";
+        readonly label: {
+            readonly en: "Japanese";
+            readonly es: "Japonés";
+        };
+    };
+    readonly korean: {
+        readonly id: "korean";
+        readonly label: {
+            readonly en: "Korean";
+            readonly es: "Coreano";
+        };
+    };
+    readonly nordic: {
+        readonly id: "nordic";
+        readonly label: {
+            readonly en: "Nordic";
+            readonly es: "Nórdico";
+        };
+    };
+    readonly other: {
+        readonly id: "other";
+        readonly label: {
+            readonly en: "Other";
+            readonly es: "Otro";
+        };
+    };
+    readonly romanian: {
+        readonly id: "romanian";
+        readonly label: {
+            readonly en: "Romanian";
+            readonly es: "Rumano";
+        };
+    };
+    readonly southernEuropean: {
+        readonly id: "southernEuropean";
+        readonly label: {
+            readonly en: "Southern European";
+            readonly es: "Europeo meridional";
+        };
+    };
+    readonly thai: {
+        readonly id: "thai";
+        readonly label: {
+            readonly en: "Thai";
+            readonly es: "Tailandés";
+        };
+    };
+    readonly turkish: {
+        readonly id: "turkish";
+        readonly label: {
+            readonly en: "Turkish";
+            readonly es: "Turco";
+        };
+    };
+    readonly unicode16: {
+        readonly id: "unicode16";
+        readonly label: {
+            readonly en: "Unicode 16";
+            readonly es: "Unicode 16";
+        };
+    };
+    readonly unicode32: {
+        readonly id: "unicode32";
+        readonly label: {
+            readonly en: "Unicode 32";
+            readonly es: "Unicode 32";
+        };
+    };
+    readonly vietnamese: {
+        readonly id: "vietnamese";
+        readonly label: {
+            readonly en: "Vietnamese";
+            readonly es: "Vietnamita";
+        };
+    };
+    readonly western: {
+        readonly id: "western";
+        readonly label: {
+            readonly en: "Western";
+            readonly es: "Occidental";
+        };
+    };
+};
+declare const ENCODING_TYPE_CONFIG_DATA: {
+    readonly ascii: {
+        readonly id: "ascii";
+        readonly groupId: null;
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly big5: {
+        readonly id: "big5";
+        readonly groupId: "chineseTraditional";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'euc-jp': {
+        readonly id: "euc-jp";
+        readonly groupId: "japanese";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'euc-kr': {
+        readonly id: "euc-kr";
+        readonly groupId: "korean";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly gb18030: {
+        readonly id: "gb18030";
+        readonly groupId: "chineseSimplified";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly gbk: {
+        readonly id: "gbk";
+        readonly groupId: "chineseSimplified";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly ibm866: {
+        readonly id: "ibm866";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-2022-cn': {
+        readonly id: "iso-2022-cn";
+        readonly groupId: "chineseSimplified";
+        readonly isDetectable: true;
+        readonly isDecodable: false;
+    };
+    readonly 'iso-2022-jp': {
+        readonly id: "iso-2022-jp";
+        readonly groupId: "japanese";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-2022-kr': {
+        readonly id: "iso-2022-kr";
+        readonly groupId: "korean";
+        readonly isDetectable: true;
+        readonly isDecodable: false;
+    };
+    readonly 'iso-8859-1': {
+        readonly id: "iso-8859-1";
+        readonly groupId: "western";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-2': {
+        readonly id: "iso-8859-2";
+        readonly groupId: "centralEuropean";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-3': {
+        readonly id: "iso-8859-3";
+        readonly groupId: "southernEuropean";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-4': {
+        readonly id: "iso-8859-4";
+        readonly groupId: "baltic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-5': {
+        readonly id: "iso-8859-5";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-6': {
+        readonly id: "iso-8859-6";
+        readonly groupId: "arabic";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-7': {
+        readonly id: "iso-8859-7";
+        readonly groupId: "greek";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-8': {
+        readonly id: "iso-8859-8";
+        readonly groupId: "hebrew";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-9': {
+        readonly id: "iso-8859-9";
+        readonly groupId: "turkish";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-10': {
+        readonly id: "iso-8859-10";
+        readonly groupId: "nordic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-11': {
+        readonly id: "iso-8859-11";
+        readonly groupId: "thai";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-13': {
+        readonly id: "iso-8859-13";
+        readonly groupId: "baltic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-14': {
+        readonly id: "iso-8859-14";
+        readonly groupId: "celtic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-15': {
+        readonly id: "iso-8859-15";
+        readonly groupId: "western";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'iso-8859-16': {
+        readonly id: "iso-8859-16";
+        readonly groupId: "romanian";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'koi8-r': {
+        readonly id: "koi8-r";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'koi8-u': {
+        readonly id: "koi8-u";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly latin1: {
+        readonly id: "latin1";
+        readonly groupId: "western";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly macintosh: {
+        readonly id: "macintosh";
+        readonly groupId: "western";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly shift_jis: {
+        readonly id: "shift_jis";
+        readonly groupId: "japanese";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'tis-620': {
+        readonly id: "tis-620";
+        readonly groupId: "thai";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'utf-16': {
+        readonly id: "utf-16";
+        readonly groupId: "unicode16";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'utf-16be': {
+        readonly id: "utf-16be";
+        readonly groupId: "unicode16";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'utf-16le': {
+        readonly id: "utf-16le";
+        readonly groupId: "unicode16";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'utf-32be': {
+        readonly id: "utf-32be";
+        readonly groupId: "unicode32";
+        readonly isDetectable: true;
+        readonly isDecodable: false;
+    };
+    readonly 'utf-32le': {
+        readonly id: "utf-32le";
+        readonly groupId: "unicode32";
+        readonly isDetectable: true;
+        readonly isDecodable: false;
+    };
+    readonly 'utf-8': {
+        readonly id: "utf-8";
+        readonly groupId: null;
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1250': {
+        readonly id: "windows-1250";
+        readonly groupId: "centralEuropean";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1251': {
+        readonly id: "windows-1251";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1252': {
+        readonly id: "windows-1252";
+        readonly groupId: "western";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1253': {
+        readonly id: "windows-1253";
+        readonly groupId: "greek";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1254': {
+        readonly id: "windows-1254";
+        readonly groupId: "turkish";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1255': {
+        readonly id: "windows-1255";
+        readonly groupId: "hebrew";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1256': {
+        readonly id: "windows-1256";
+        readonly groupId: "arabic";
+        readonly isDetectable: true;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1257': {
+        readonly id: "windows-1257";
+        readonly groupId: "baltic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-1258': {
+        readonly id: "windows-1258";
+        readonly groupId: "vietnamese";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'windows-874': {
+        readonly id: "windows-874";
+        readonly groupId: "thai";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'x-mac-cyrillic': {
+        readonly id: "x-mac-cyrillic";
+        readonly groupId: "cyrillic";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+    readonly 'x-user-defined': {
+        readonly id: "x-user-defined";
+        readonly groupId: "other";
+        readonly isDetectable: false;
+        readonly isDecodable: true;
+    };
+};
 export declare const ENCODING_GROUP_CONFIG_MAP: Record<EncodingGroupId, EncodingGroupConfig>;
-export declare const ENCODING_TYPE_CONFIG_MAP: Record<string, EncodingTypeConfig>;
+export declare const ENCODING_TYPE_CONFIG_MAP: Record<EncodingTypeId, EncodingTypeConfig>;
+export declare function isEncodingTypeId(value: string): value is EncodingTypeId;
 export declare function getEncodingTypeConfigs(localeId?: LocaleId): EncodingTypeConfigLocalised[];
+export {};

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "@dpuse/dpuse-shared",
-    "version": "0.3.821",
+    "version": "0.3.823",
     "private": false,
     "description": "Common constants, types and utilities used across all DPUse projects.",
     "license": "MIT",
@@ -151,11 +151,12 @@
         "audit": "node -e \"import('@dpuse/dpuse-development').then(m => m.auditDependencies())\"",
         "build": "node -e \"import('@dpuse/dpuse-development').then(m => m.buildProject())\" && npm run documentBundleSizes",
         "check": "node -e \"import('@dpuse/dpuse-development').then(m => m.checkConfigFiles())\" && node -e \"import('@dpuse/dpuse-development').then(m => m.checkDependencies())\"",
-        "document": "npm run documentOpening && npm run documentDependencies && npm run documentGovernance",
+        "document": "npm run documentOpening && npm run documentUsage && npm run documentDependencies && npm run documentGovernance",
         "documentBundleSizes": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentBundleSizes())\"",
-        "documentDependencies": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentDependencies('MIT'))\"",
+        "documentDependencies": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentDependencies('Apache-2.0;BSD-3-Clause;MIT'))\"",
         "documentGovernance": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentGovernance())\"",
         "documentOpening": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentOpening())\"",
+        "documentUsage": "node -e \"import('@dpuse/dpuse-development').then(m => m.documentUsage())\"",
         "format": "node -e \"import('@dpuse/dpuse-development').then(m => m.formatCode())\"",
         "health": "npm run test:coverage && fallow --coverage coverage/coverage-final.json",
         "lint": "node -e \"import('@dpuse/dpuse-development').then(m => m.lintCode())\"",
@@ -170,7 +171,7 @@
     },
     "devDependencies": {
         "@dpuse/dpuse-development": "^0.3.722",
-        "@dpuse/eslint-config-dpuse": "^1.0.121",
+        "@dpuse/eslint-config-dpuse": "^1.0.122",
         "@types/node": "^26.6.2",
         "@vitest/coverage-v8": "^5.0.1",
         "eslint": "^10.11.0",
@@ -178,7 +179,7 @@
         "prettier": "^3.9.9",
         "sonda": "^0.14.0",
         "typescript": "^6.0.3",
-        "vite": "^8.3.0",
+        "vite": "^8.3.1",
         "vite-plugin-dts": "^5.1.1",
         "vitest": "^5.0.1"
     }