@fgv/ts-bcp47 5.1.0-2 → 5.1.0-21

package/dist/packlets/unsd/csv/index.js

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

package/dist/packlets/unsd/csv/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/unsd/csv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Converters from './converters';\nimport * as Model from './model';\n\nexport { Converters, Model };\n"]}

package/dist/packlets/unsd/csv/model.js

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

package/dist/packlets/unsd/csv/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/packlets/unsd/csv/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Iana from '../../iana';\n\n/**\n * @internal\n */\nexport interface IM49CsvRow {\n  globalCode: Iana.Model.UnM49RegionCode;\n  globalName: string;\n  regionCode?: Iana.Model.UnM49RegionCode;\n  regionName?: string;\n  subRegionCode?: Iana.Model.UnM49RegionCode;\n  subRegionName?: string;\n  intermediateRegionCode?: Iana.Model.UnM49RegionCode;\n  intermediateRegionName?: string;\n  countryOrArea: string;\n  m49Code: Iana.Model.UnM49RegionCode;\n  isoAlpha2RegionCode?: Iana.Model.IsoAlpha2RegionCode;\n  isoAlpha3RegionCode?: Iana.Model.IsoAlpha3RegionCode;\n  leastDevelopedCountry: boolean;\n  landLockedDevelopingCountry: boolean;\n  smallIslandDevelopingState: boolean;\n}\n"]}

package/dist/packlets/unsd/defaultRegistries.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { RegionCodes } from './regionCodes';
+/**
+ * @public
+ */
+export class DefaultRegistries {
+    static get regionCodes() {
+        if (!this._regionCodes) {
+            this._regionCodes = RegionCodes.loadDefault().orThrow();
+        }
+        return this._regionCodes;
+    }
+}
+/**
+ * @internal
+ */
+DefaultRegistries._regionCodes = undefined;
+//# sourceMappingURL=defaultRegistries.js.map

package/dist/packlets/unsd/defaultRegistries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRegistries.js","sourceRoot":"","sources":["../../../src/packlets/unsd/defaultRegistries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAMrB,MAAM,KAAK,WAAW;QAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;;AAVD;;GAEG;AACc,8BAAY,GAAiB,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { RegionCodes } from './regionCodes';\n\n/**\n * @public\n */\nexport class DefaultRegistries {\n  /**\n   * @internal\n   */\n  protected static _regionCodes?: RegionCodes = undefined;\n\n  public static get regionCodes(): RegionCodes {\n    if (!this._regionCodes) {\n      this._regionCodes = RegionCodes.loadDefault().orThrow();\n    }\n    return this._regionCodes;\n  }\n}\n"]}

package/dist/packlets/unsd/index.js

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

package/dist/packlets/unsd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/unsd/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Csv from './csv';\n\nexport * from './common';\nexport { DefaultRegistries } from './defaultRegistries';\nexport { RegionCodes } from './regionCodes';\nexport { Csv };\n"]}

package/dist/packlets/unsd/regionCodes.js

@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { allSucceed, succeed } from '@fgv/ts-utils';
+import { loadM49csvFileSync, m49CsvFile } from './csv/converters';
+// eslint-disable-next-line @rushstack/packlets/mechanics
+import defaultRegions from '../../data/unsd/m49.json';
+import { Areas } from './areas';
+import { Regions } from './regions';
+/**
+ * @public
+ */
+export class RegionCodes {
+    /**
+     * @internal
+     */
+    constructor() {
+        this.regions = new Regions();
+        this.areas = new Areas();
+    }
+    static create(rows) {
+        const codes = new RegionCodes();
+        return codes._importRows(rows).onSuccess(() => {
+            return succeed(codes);
+        });
+    }
+    static createFromJson(from) {
+        return m49CsvFile.convert(from).onSuccess(RegionCodes.create);
+    }
+    static loadDefault() {
+        return this.createFromJson(defaultRegions);
+    }
+    static loadCsv(path) {
+        return loadM49csvFileSync(path).onSuccess((rows) => {
+            return this.create(rows);
+        });
+    }
+    tryGetRegionOrArea(code) {
+        var _a;
+        /* c8 ignore next - numeric area not allowed in bcp-47 so right side of ?? shouldn't be hit. */
+        return (_a = this.regions.tryGetRegion(code)) !== null && _a !== void 0 ? _a : this.areas.tryGetArea(code);
+    }
+    getIsContained(container, contained) {
+        let next = contained;
+        while (next) {
+            if (next === container) {
+                return true;
+            }
+            next = next.tier !== 'global' ? next.parent : undefined;
+        }
+        return false;
+    }
+    /**
+     * Imports a single parsed row of UN M.49 region code data
+     * @param row - The parsed row to be imported.
+     * @returns `Success` with `true` if the row was successfully
+     * imported, or `Failure` with details if an error occurs.
+     * @internal
+     */
+    _importRow(row) {
+        return this.regions
+            .getOrAddRegionChildRegion('region', this.regions.global, row.regionCode, row.regionName)
+            .onSuccess((region) => {
+            return this.regions.getOrAddRegionChildRegion('subRegion', region, row.subRegionCode, row.subRegionName);
+        })
+            .onSuccess((region) => {
+            return this.regions.getOrAddRegionChildRegion('intermediateRegion', region, row.intermediateRegionCode, row.intermediateRegionName);
+        })
+            .onSuccess((region) => {
+            return this.areas.addArea({
+                name: row.countryOrArea,
+                code: row.m49Code,
+                tier: 'area',
+                parent: region,
+                isoAlpha2: row.isoAlpha2RegionCode,
+                isoAlpha3: row.isoAlpha3RegionCode,
+                leastDevelopedCountry: row.leastDevelopedCountry,
+                landlockedDevelopingCountry: row.landLockedDevelopingCountry,
+                smallIslandDevelopingState: row.smallIslandDevelopingState
+            });
+        })
+            .onSuccess(() => {
+            return succeed(true);
+        });
+    }
+    /**
+     * Imports multiple parsed rows from UN M.49 region code data
+     * @param rows - The parsed rows to be imported.
+     * @returns `Success` with `true` if the rows were successfully
+     * imported, or `Failure` with details if an error occurs.
+     * @internal
+     */
+    _importRows(rows) {
+        return allSucceed(rows.map((row) => this._importRow(row)), true);
+    }
+}
+//# sourceMappingURL=regionCodes.js.map

package/dist/packlets/unsd/regionCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionCodes.js","sourceRoot":"","sources":["../../../src/packlets/unsd/regionCodes.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Iana from '../iana';\nimport * as Model from './csv/model';\n\nimport { Result, allSucceed, succeed } from '@fgv/ts-utils';\nimport { ICountryOrArea, Region } from './common';\nimport { loadM49csvFileSync, m49CsvFile } from './csv/converters';\n\n// eslint-disable-next-line @rushstack/packlets/mechanics\nimport defaultRegions from '../../data/unsd/m49.json';\nimport { Areas } from './areas';\nimport { Regions } from './regions';\n\n/**\n * @public\n */\nexport class RegionCodes {\n  public readonly regions: Regions;\n  public readonly areas: Areas;\n\n  /**\n   * @internal\n   */\n  protected constructor() {\n    this.regions = new Regions();\n    this.areas = new Areas();\n  }\n\n  public static create(rows: Model.IM49CsvRow[]): Result<RegionCodes> {\n    const codes = new RegionCodes();\n    return codes._importRows(rows).onSuccess(() => {\n      return succeed(codes);\n    });\n  }\n\n  public static createFromJson(from: unknown): Result<RegionCodes> {\n    return m49CsvFile.convert(from).onSuccess(RegionCodes.create);\n  }\n\n  public static loadDefault(): Result<RegionCodes> {\n    return this.createFromJson(defaultRegions);\n  }\n\n  public static loadCsv(path: string): Result<RegionCodes> {\n    return loadM49csvFileSync(path).onSuccess((rows) => {\n      return this.create(rows);\n    });\n  }\n\n  public tryGetRegionOrArea(code: Iana.Model.UnM49RegionCode): Region | ICountryOrArea | undefined {\n    /* c8 ignore next - numeric area not allowed in bcp-47 so right side of ?? shouldn't be hit. */\n    return this.regions.tryGetRegion(code) ?? this.areas.tryGetArea(code);\n  }\n\n  public getIsContained(container: Region, contained: ICountryOrArea | Region): boolean {\n    let next: Region | ICountryOrArea | undefined = contained;\n    while (next) {\n      if (next === container) {\n        return true;\n      }\n      next = next.tier !== 'global' ? next.parent : undefined;\n    }\n    return false;\n  }\n\n  /**\n   * Imports a single parsed row of UN M.49 region code data\n   * @param row - The parsed row to be imported.\n   * @returns `Success` with `true` if the row was successfully\n   * imported, or `Failure` with details if an error occurs.\n   * @internal\n   */\n  protected _importRow(row: Model.IM49CsvRow): Result<true> {\n    return this.regions\n      .getOrAddRegionChildRegion('region', this.regions.global, row.regionCode, row.regionName)\n      .onSuccess((region) => {\n        return this.regions.getOrAddRegionChildRegion(\n          'subRegion',\n          region,\n          row.subRegionCode,\n          row.subRegionName\n        );\n      })\n      .onSuccess((region) => {\n        return this.regions.getOrAddRegionChildRegion(\n          'intermediateRegion',\n          region,\n          row.intermediateRegionCode,\n          row.intermediateRegionName\n        );\n      })\n      .onSuccess((region) => {\n        return this.areas.addArea({\n          name: row.countryOrArea,\n          code: row.m49Code,\n          tier: 'area',\n          parent: region,\n          isoAlpha2: row.isoAlpha2RegionCode,\n          isoAlpha3: row.isoAlpha3RegionCode,\n          leastDevelopedCountry: row.leastDevelopedCountry,\n          landlockedDevelopingCountry: row.landLockedDevelopingCountry,\n          smallIslandDevelopingState: row.smallIslandDevelopingState\n        });\n      })\n      .onSuccess(() => {\n        return succeed(true);\n      });\n  }\n\n  /**\n   * Imports multiple parsed rows from UN M.49 region code data\n   * @param rows - The parsed rows to be imported.\n   * @returns `Success` with `true` if the rows were successfully\n   * imported, or `Failure` with details if an error occurs.\n   * @internal\n   */\n  protected _importRows(rows: Model.IM49CsvRow[]): Result<true> {\n    return allSucceed(\n      rows.map((row) => this._importRow(row)),\n      true\n    );\n  }\n}\n"]}

package/dist/packlets/unsd/regions.js

@@ -0,0 +1,71 @@
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { fail, succeed } from '@fgv/ts-utils';
+export const GlobalRegionName = 'World';
+export const GlobalRegionCode = '001';
+/**
+ * @public
+ */
+export class Regions {
+    constructor() {
+        this.global = { name: GlobalRegionName, code: GlobalRegionCode, tier: 'global', regions: [], areas: [] };
+        this._regions = new Map();
+    }
+    tryGetRegion(from) {
+        return this._regions.get(from);
+    }
+    getRegion(from) {
+        const got = this._regions.get(from);
+        return got ? succeed(got) : fail(`${from}: region not found`);
+    }
+    getOrAddRegionChildRegion(tier, parent, code, name) {
+        if (!code && !name) {
+            return succeed(parent);
+        }
+        else if (!code || !name) {
+            return fail(`${code}(${name}): code and name must both be present`);
+        }
+        const existing = this._regions.get(code);
+        if (existing) {
+            if (existing.name !== name) {
+                return fail(`${code}: cannot add ${name} - already exists as ${existing.name}`);
+            }
+            if (existing.tier !== tier) {
+                return fail(`${code}: cannot add ${name} as tier ${tier} - already exists as tier ${existing.tier}`);
+            }
+            if (existing.parent !== parent) {
+                const haveParent = `${existing.parent.code}/${existing.parent.name}`;
+                const wantParent = `${parent.code}/${parent.name}`;
+                return fail(`${code}: cannot add ${name} with parent ${wantParent} - already exists with parent ${haveParent}`);
+            }
+            return succeed(existing);
+        }
+        const added = { name, code, tier, parent, regions: [], areas: [] };
+        this._regions.set(code, added);
+        parent.regions.push(added);
+        return succeed(added);
+    }
+    getAll() {
+        return Array.from(this._regions.values());
+    }
+}
+//# sourceMappingURL=regions.js.map

package/dist/packlets/unsd/regions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.js","sourceRoot":"","sources":["../../../src/packlets/unsd/regions.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, fail, succeed } from '@fgv/ts-utils';\nimport * as Iana from '../iana';\nimport { IGlobalRegion, IntermediateRegionTier, Region } from './common';\n\nexport const GlobalRegionName: string = 'World';\nexport const GlobalRegionCode: Iana.Model.UnM49RegionCode = '001' as Iana.Model.UnM49RegionCode;\n\n/**\n * @public\n */\nexport class Regions {\n  public readonly global: IGlobalRegion;\n  /**\n   * @internal\n   */\n  protected readonly _regions: Map<Iana.Model.UnM49RegionCode, Region>;\n\n  public constructor() {\n    this.global = { name: GlobalRegionName, code: GlobalRegionCode, tier: 'global', regions: [], areas: [] };\n    this._regions = new Map();\n  }\n\n  public tryGetRegion(from: Iana.Model.UnM49RegionCode): Region | undefined {\n    return this._regions.get(from);\n  }\n\n  public getRegion(from: Iana.Model.UnM49RegionCode): Result<Region> {\n    const got = this._regions.get(from);\n    return got ? succeed(got) : fail(`${from}: region not found`);\n  }\n\n  public getOrAddRegionChildRegion(\n    tier: IntermediateRegionTier,\n    parent: Region,\n    code: Iana.Model.UnM49RegionCode | undefined,\n    name: string | undefined\n  ): Result<Region> {\n    if (!code && !name) {\n      return succeed(parent);\n    } else if (!code || !name) {\n      return fail(`${code}(${name}): code and name must both be present`);\n    }\n\n    const existing = this._regions.get(code);\n    if (existing) {\n      if (existing.name !== name) {\n        return fail(`${code}: cannot add ${name} - already exists as ${existing.name}`);\n      }\n      if (existing.tier !== tier) {\n        return fail(`${code}: cannot add ${name} as tier ${tier} - already exists as tier ${existing.tier}`);\n      }\n      if (existing.parent !== parent) {\n        const haveParent = `${existing.parent.code}/${existing.parent.name}`;\n        const wantParent = `${parent.code}/${parent.name}`;\n        return fail(\n          `${code}: cannot add ${name} with parent ${wantParent} - already exists with parent ${haveParent}`\n        );\n      }\n      return succeed(existing);\n    }\n\n    const added = { name, code, tier, parent, regions: [], areas: [] };\n    this._regions.set(code, added);\n    parent.regions.push(added);\n    return succeed(added);\n  }\n\n  public getAll(): Region[] {\n    return Array.from(this._regions.values());\n  }\n}\n"]}

package/dist/packlets/utils/index.js

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

package/dist/packlets/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './jsonHelpers';\nexport * from './validationHelpers';\n"]}

package/dist/packlets/utils/jsonHelpers.js

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

package/dist/packlets/utils/jsonHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonHelpers.js","sourceRoot":"","sources":["../../../src/packlets/utils/jsonHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,UAAU,YAAY,CAAI,IAAO;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;AAC/C,CAAC","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport function sanitizeJson<T>(from: T): T {\n  return JSON.parse(JSON.stringify(from)) as T;\n}\n"]}

package/dist/packlets/utils/public.js

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

package/dist/packlets/utils/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/packlets/utils/public.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBAAuB;AAEvB,OAAO,EAEL,iBAAiB,EAElB,MAAM,qBAAqB,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n// istanbul ignore file\n\nexport {\n  Normalizer,\n  ValidationHelpers,\n  IValidationHelpersConstructorParams as ValidationHelpersConstructorParams\n} from './validationHelpers';\n"]}

package/dist/packlets/utils/validationHelpers.js

@@ -0,0 +1,116 @@
+/*
+ * Copyright (c) 2021 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { Converters, fail, succeed } from '@fgv/ts-utils';
+/**
+  A collection of validation and normalization helpers for constrained string
+  types.
+ * @public
+ */
+export class ValidationHelpers {
+    /**
+     * Constructs new {@link Utils.ValidationHelpers | validation helpers}
+     * from supplied initializers.
+     * @param init - The {@link Utils.ValidationHelpersConstructorParams | constructor params}
+     * used to initialize this {@link Utils.ValidationHelpers | validation helpers}.
+     */
+    constructor(init) {
+        this.description = init.description;
+        this.isWellFormed = init.isWellFormed;
+        this.isCanonical = init.isCanonical;
+        this._toCanonical = init.toCanonical;
+        this.converter = Converters.isA(this.description, this.isWellFormed);
+    }
+    /**
+     * Converts a supplied `unknown` to the canonical form of the tag
+     * validated by these helpers.
+     * @param from - The `unknown` to be converted.
+     * @param context - Optional context used in the conversion.
+     * @returns `Success` with the corresponding canonical value,
+     * or `Failure` with details if an error occurs.
+     */
+    toCanonical(from, context) {
+        if (this.isWellFormed(from, context)) {
+            if (this._toCanonical) {
+                return this._toCanonical(from, context);
+            }
+            /* c8 ignore next 3 - functional code tested but coverage intermittently missed */
+            if (this.isCanonical(from, context)) {
+                return succeed(from);
+            }
+            /* c8 ignore next 2 */
+            return fail(`cannot convert "${from}" to canonical ${this.description}`);
+        }
+        return fail(`invalid ${this.description} ("${JSON.stringify(from)}")`);
+    }
+    /**
+     * Determines if a supplied `unknown` is a well-formed representation
+     * of the tag validated by these helpers.
+     * @param from - The `unknown` to be validated.
+     * @param context - Optional context used in the validation.
+     * @returns `Success` with the validated value, or `Failure` with details
+     * if an error occurs.
+     */
+    verifyIsWellFormed(from, context) {
+        if (this.isWellFormed(from, context)) {
+            return succeed(from);
+        }
+        return fail(`malformed ${this.description}`);
+    }
+    /**
+     * Determines if a supplied `unknown` is a well-formed, canonical representation
+     * of the tag validated by these helpers.
+     * @param from - The `unknown` to be validated.
+     * @param context - Optional context used in the validation.
+     * @returns `Success` with the validated canonical value, or `Failure` with
+     * details if an error occurs.
+     */
+    verifyIsCanonical(from, context) {
+        if (this.isCanonical(from, context)) {
+            return succeed(from);
+        }
+        /* c8 ignore next 3 - should never occur and very hard to test */
+        if (!this.isWellFormed(from, context)) {
+            return fail(`malformed ${this.description}`);
+        }
+        return fail(`non-canonical ${this.description}`);
+    }
+}
+/**
+ * @internal
+ */
+export class RegExpValidationHelpers extends ValidationHelpers {
+    constructor(params) {
+        super({
+            description: params.description,
+            toCanonical: params.toCanonical,
+            isWellFormed: (from) => {
+                return typeof from === 'string' && this.wellFormed.test(from);
+            },
+            isCanonical: (from) => {
+                return typeof from === 'string' && this.canonical.test(from);
+            }
+        });
+        this.wellFormed = params.wellFormed;
+        this.canonical = params.canonical;
+    }
+}
+//# sourceMappingURL=validationHelpers.js.map

package/dist/packlets/utils/validationHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationHelpers.js","sourceRoot":"","sources":["../../../src/packlets/utils/validationHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converter, Converters, Result, Validation, fail, succeed } from '@fgv/ts-utils';\n\n/**\n * A function which accepts a value of the expected type and reformats it to match\n * the canonical presentation form.\n * @public\n */\nexport type Normalizer<T extends string, TC = unknown> = (val: T, context?: TC) => Result<T>;\n\n/**\n * Initializer for {@link Utils.ValidationHelpers | validation helpers}.\n * @public\n */\nexport interface IValidationHelpersConstructorParams<T extends string, TC = unknown> {\n  description: string;\n  isWellFormed: Validation.TypeGuardWithContext<T, TC>;\n  isCanonical: Validation.TypeGuardWithContext<T, TC>;\n  toCanonical?: Normalizer<T, TC>;\n}\n\n/**\n  A collection of validation and normalization helpers for constrained string\n  types.\n * @public\n */\nexport class ValidationHelpers<T extends string, TC = unknown> {\n  /**\n   * Describes the group of tags validated by these helpers.\n   */\n  public readonly description: string;\n\n  /**\n   * A `Converter` which converts `unknown` to the tag type\n   * validated by these helpers, if possible.\n   */\n  public readonly converter: Converter<T, TC>;\n\n  /**\n   * Determines is a supplied tag is well-formed according to the\n   * lexical rules defined for the tag validated by these helpers.\n   */\n  public readonly isWellFormed: Validation.TypeGuardWithContext<T, TC>;\n\n  /**\n   * Determines is a supplied tag is well-formed and uses canonical\n   * formatting, according to the lexical rules defined for the tag\n   * validated by these helpers.\n   */\n  public readonly isCanonical: Validation.TypeGuardWithContext<T, TC>;\n\n  /**\n   * @internal\n   */\n  protected readonly _toCanonical?: Normalizer<T, TC>;\n\n  /**\n   * Constructs new {@link Utils.ValidationHelpers | validation helpers}\n   * from supplied initializers.\n   * @param init - The {@link Utils.ValidationHelpersConstructorParams | constructor params}\n   * used to initialize this {@link Utils.ValidationHelpers | validation helpers}.\n   */\n  public constructor(init: IValidationHelpersConstructorParams<T, TC>) {\n    this.description = init.description;\n    this.isWellFormed = init.isWellFormed;\n    this.isCanonical = init.isCanonical;\n    this._toCanonical = init.toCanonical;\n    this.converter = Converters.isA(this.description, this.isWellFormed);\n  }\n\n  /**\n   * Converts a supplied `unknown` to the canonical form of the tag\n   * validated by these helpers.\n   * @param from - The `unknown` to be converted.\n   * @param context - Optional context used in the conversion.\n   * @returns `Success` with the corresponding canonical value,\n   * or `Failure` with details if an error occurs.\n   */\n  public toCanonical(from: unknown, context?: TC): Result<T> {\n    if (this.isWellFormed(from, context)) {\n      if (this._toCanonical) {\n        return this._toCanonical(from as T, context);\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      if (this.isCanonical(from, context)) {\n        return succeed(from);\n      }\n      /* c8 ignore next 2 */\n      return fail(`cannot convert \"${from}\" to canonical ${this.description}`);\n    }\n    return fail(`invalid ${this.description} (\"${JSON.stringify(from)}\")`);\n  }\n\n  /**\n   * Determines if a supplied `unknown` is a well-formed representation\n   * of the tag validated by these helpers.\n   * @param from - The `unknown` to be validated.\n   * @param context - Optional context used in the validation.\n   * @returns `Success` with the validated value, or `Failure` with details\n   * if an error occurs.\n   */\n  public verifyIsWellFormed(from: unknown, context?: TC): Result<T> {\n    if (this.isWellFormed(from, context)) {\n      return succeed(from);\n    }\n    return fail(`malformed ${this.description}`);\n  }\n\n  /**\n   * Determines if a supplied `unknown` is a well-formed, canonical representation\n   * of the tag validated by these helpers.\n   * @param from - The `unknown` to be validated.\n   * @param context - Optional context used in the validation.\n   * @returns `Success` with the validated canonical value, or `Failure` with\n   * details if an error occurs.\n   */\n  public verifyIsCanonical(from: unknown, context?: TC): Result<T> {\n    if (this.isCanonical(from, context)) {\n      return succeed(from);\n    }\n    /* c8 ignore next 3 - should never occur and very hard to test */\n    if (!this.isWellFormed(from, context)) {\n      return fail(`malformed ${this.description}`);\n    }\n    return fail(`non-canonical ${this.description}`);\n  }\n}\n\n/**\n * @internal\n */\nexport interface IRegExpValidationHelperConstructorParams<T extends string, TC = unknown> {\n  description: string;\n  wellFormed: RegExp;\n  canonical: RegExp;\n  toCanonical?: Normalizer<T, TC>;\n}\n\n/**\n * @internal\n */\nexport class RegExpValidationHelpers<T extends string, TC = unknown> extends ValidationHelpers<T, TC> {\n  public readonly wellFormed: RegExp;\n  public readonly canonical: RegExp;\n\n  public constructor(params: IRegExpValidationHelperConstructorParams<T, TC>) {\n    super({\n      description: params.description,\n      toCanonical: params.toCanonical,\n      isWellFormed: (from: unknown): from is T => {\n        return typeof from === 'string' && this.wellFormed.test(from);\n      },\n      isCanonical: (from: unknown): from is T => {\n        return typeof from === 'string' && this.canonical.test(from);\n      }\n    });\n    this.wellFormed = params.wellFormed;\n    this.canonical = params.canonical;\n  }\n}\n"]}

package/dist/ts-bcp47.d.ts

@@ -158,19 +158,19 @@ declare namespace Csv {
 }
 
 /**
- * Helper function which creates a converter that returns a validated {@Link Iana.Model.IDatedRegistry | DatedRegistry}
+ * Helper function which creates a converter that returns a validated {@link Iana.Model.IDatedRegistry | DatedRegistry}
  * containing entries of supplied template type `T`.
  * @param entryConverter - A `Converter<T>` to validate each entry
- * @returns A new validating `Converter` which yields {@Link Iana.Model.IDatedRegistry | DatedRegistry<T>}
+ * @returns A new validating `Converter` which yields {@link Iana.Model.IDatedRegistry | DatedRegistry<T>}
  * @public
  */
 declare function datedRegistry<T, TC = unknown>(entryConverter: Converter<T, TC>): Converter<IDatedRegistry<T>, unknown>;
 
 /**
- * Helper function which creates a converter that returns a validated {@Link Iana.Model.IDatedRegistry | DatedRegistry}
+ * Helper function which creates a converter that returns a validated {@link Iana.Model.IDatedRegistry | DatedRegistry}
  * containing entries of supplied template type `T`.
  * @param entryConverter - A `Converter<T>` to validate each entry
- * @returns A new validating `Converter` which yields {@Link Iana.Model.IDatedRegistry | DatedRegistry<T>}
+ * @returns A new validating `Converter` which yields {@link Iana.Model.IDatedRegistry | DatedRegistry<T>}
  * @internal
  */
 declare function datedRegistryFromJarRecords<T, TC = unknown>(entryConverter: Converter<T, TC>): Converter<IDatedRegistry<T>, TC>;
@@ -1461,7 +1461,7 @@ declare class LanguageTag {
      * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied
      * {@link Bcp47.Subtags | subtags} using optional configuration,
      * if supplied.
-     * @param tag - The {@link Bcp47.Subtags | subtags} from which the
+     * @param subtags - The {@link Bcp47.Subtags | subtags} from which the
      * {@link Bcp47.LanguageTag | language tag} is te be constructed.
      * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}
      * to guide the validation and normalization of this tag.