@fgv/ts-bcp47 0.9.6 → 2.0.2-alpha.0

package/lib/packlets/bcp47/validation/isValid.js

@@ -0,0 +1,119 @@
+"use strict";
+/*
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsValidValidator = void 0;
+const Iana = __importStar(require("../../iana"));
+const Bcp47Subtags = __importStar(require("../bcp47Subtags"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const baseValidator_1 = require("./baseValidator");
+/**
+ * @internal
+ */
+class IsValidValidator extends baseValidator_1.TagValidatorBase {
+    constructor() {
+        super(...arguments);
+        this.validity = 'valid';
+    }
+    _checkLanguage(subtags) {
+        return subtags.primaryLanguage
+            ? this.iana.subtags.languages.verifyIsValid(subtags.primaryLanguage)
+            : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkExtlangs(subtags) {
+        if (subtags.extlangs) {
+            return (0, ts_utils_1.allSucceed)(subtags.extlangs.map((e) => this.iana.subtags.extlangs.verifyIsValid(e)), subtags.extlangs);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkScript(subtags) {
+        return subtags.script ? this.iana.subtags.scripts.verifyIsValid(subtags.script) : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkRegion(subtags) {
+        return subtags.region ? this.iana.subtags.regions.verifyIsValid(subtags.region) : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkVariants(subtags) {
+        if (subtags.variants) {
+            return (0, ts_utils_1.allSucceed)(subtags.variants.map((v) => this.iana.subtags.variants.verifyIsValid(v)), subtags.variants).onSuccess((v) => {
+                return (0, ts_utils_1.mapResults)(v.map((vc) => this.iana.subtags.variants.toCanonical(vc))).onSuccess((canonical) => {
+                    return this._verifyUnique('variant subtag', canonical, (v) => v);
+                });
+            });
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkExtensionSingleton(singleton) {
+        return this.iana.extensions.extensions.verifyIsValid(singleton);
+    }
+    _checkExtensionSubtagValue(value) {
+        return Bcp47Subtags.Validate.extensionSubtag.verifyIsWellFormed(value);
+    }
+    _checkExtensions(subtags) {
+        return super._checkExtensions(subtags).onSuccess((extensions) => {
+            return this._verifyUnique('extensions', extensions, (e) => e.singleton.toLowerCase());
+        });
+    }
+    _checkPrivateUseTags(subtags) {
+        if (subtags.privateUse) {
+            return (0, ts_utils_1.allSucceed)(subtags.privateUse.map((pu) => Iana.LanguageSubtags.Validate.extendedLanguageRange.verifyIsWellFormed(pu)), subtags.privateUse);
+        }
+        return (0, ts_utils_1.succeed)(subtags.privateUse);
+    }
+    _checkGrandfatheredTags(subtags) {
+        return subtags.grandfathered
+            ? this.iana.subtags.grandfathered.verifyIsValid(subtags.grandfathered)
+            : (0, ts_utils_1.succeed)(undefined);
+    }
+    _postValidate(subtags) {
+        return this._basicPostValidation(subtags).onSuccess((validated) => {
+            if (validated.extlangs && validated.extlangs.length > 1) {
+                return (0, ts_utils_1.fail)(`${validated.extlangs.join('-')}: multiple extlang subtags is invalid`);
+            }
+            return (0, ts_utils_1.succeed)(validated);
+        });
+    }
+}
+exports.IsValidValidator = IsValidValidator;
+//# sourceMappingURL=isValid.js.map

package/lib/packlets/bcp47/validation/isValid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValid.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/validation/isValid.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 Bcp47Subtags from '../bcp47Subtags';\n\nimport { Result, allSucceed, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport { ExtensionSingleton, ExtensionSubtag } from '../bcp47Subtags/model';\nimport { IExtensionSubtagValue, ISubtags } from '../common';\nimport { TagValidatorBase } from './baseValidator';\nimport { TagValidity } from './common';\n\n/**\n * @internal\n */\nexport class IsValidValidator extends TagValidatorBase {\n  public validity: TagValidity = 'valid';\n\n  protected _checkLanguage(subtags: ISubtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined> {\n    return subtags.primaryLanguage\n      ? this.iana.subtags.languages.verifyIsValid(subtags.primaryLanguage)\n      : succeed(undefined);\n  }\n\n  protected _checkExtlangs(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined> {\n    if (subtags.extlangs) {\n      return allSucceed(\n        subtags.extlangs.map((e) => this.iana.subtags.extlangs.verifyIsValid(e)),\n        subtags.extlangs\n      );\n    }\n    return succeed(undefined);\n  }\n\n  protected _checkScript(subtags: ISubtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined> {\n    return subtags.script ? this.iana.subtags.scripts.verifyIsValid(subtags.script) : succeed(undefined);\n  }\n\n  protected _checkRegion(subtags: ISubtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined> {\n    return subtags.region ? this.iana.subtags.regions.verifyIsValid(subtags.region) : succeed(undefined);\n  }\n\n  protected _checkVariants(subtags: ISubtags): Result<Iana.LanguageSubtags.VariantSubtag[] | undefined> {\n    if (subtags.variants) {\n      return allSucceed(\n        subtags.variants.map((v) => this.iana.subtags.variants.verifyIsValid(v)),\n        subtags.variants\n      ).onSuccess((v) => {\n        return mapResults(v.map((vc) => this.iana.subtags.variants.toCanonical(vc))).onSuccess(\n          (canonical) => {\n            return this._verifyUnique('variant subtag', canonical, (v) => v);\n          }\n        );\n      });\n    }\n    return succeed(undefined);\n  }\n\n  protected _checkExtensionSingleton(singleton: ExtensionSingleton): Result<ExtensionSingleton> {\n    return this.iana.extensions.extensions.verifyIsValid(singleton);\n  }\n\n  protected _checkExtensionSubtagValue(value: ExtensionSubtag): Result<ExtensionSubtag> {\n    return Bcp47Subtags.Validate.extensionSubtag.verifyIsWellFormed(value);\n  }\n\n  protected _checkExtensions(subtags: ISubtags): Result<IExtensionSubtagValue[] | undefined> {\n    return super._checkExtensions(subtags).onSuccess((extensions) => {\n      return this._verifyUnique('extensions', extensions, (e) => e.singleton.toLowerCase());\n    });\n  }\n\n  protected _checkPrivateUseTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined> {\n    if (subtags.privateUse) {\n      return allSucceed(\n        subtags.privateUse.map((pu) =>\n          Iana.LanguageSubtags.Validate.extendedLanguageRange.verifyIsWellFormed(pu)\n        ),\n        subtags.privateUse\n      );\n    }\n    return succeed(subtags.privateUse);\n  }\n\n  protected _checkGrandfatheredTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined> {\n    return subtags.grandfathered\n      ? this.iana.subtags.grandfathered.verifyIsValid(subtags.grandfathered)\n      : succeed(undefined);\n  }\n\n  protected _postValidate(subtags: ISubtags): Result<ISubtags> {\n    return this._basicPostValidation(subtags).onSuccess((validated) => {\n      if (validated.extlangs && validated.extlangs.length > 1) {\n        return fail(`${validated.extlangs.join('-')}: multiple extlang subtags is invalid`);\n      }\n      return succeed(validated);\n    });\n  }\n}\n"]}

package/lib/packlets/bcp47/validation/isWellFormed.d.ts

@@ -0,0 +1,22 @@
+import * as Iana from '../../iana';
+import { Result } from '@fgv/ts-utils';
+import { ExtensionSingleton, ExtensionSubtag } from '../bcp47Subtags/model';
+import { ISubtags } from '../common';
+import { TagValidatorBase } from './baseValidator';
+import { TagValidity } from './common';
+/**
+ * @internal
+ */
+export declare class IsWellFormedValidator extends TagValidatorBase {
+    validity: TagValidity;
+    protected _checkLanguage(subtags: ISubtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined>;
+    protected _checkExtlangs(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined>;
+    protected _checkScript(subtags: ISubtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined>;
+    protected _checkRegion(subtags: ISubtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined>;
+    protected _checkVariants(subtags: ISubtags): Result<Iana.LanguageSubtags.VariantSubtag[] | undefined>;
+    protected _checkExtensionSingleton(singleton: ExtensionSingleton): Result<ExtensionSingleton>;
+    protected _checkExtensionSubtagValue(value: ExtensionSubtag): Result<ExtensionSubtag>;
+    protected _checkPrivateUseTags(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined>;
+    protected _checkGrandfatheredTags(subtags: ISubtags): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined>;
+}
+//# sourceMappingURL=isWellFormed.d.ts.map

package/lib/packlets/bcp47/validation/isWellFormed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isWellFormed.d.ts","sourceRoot":"","sources":["../../../../src/packlets/bcp47/validation/isWellFormed.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,MAAM,EAAuB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IAClD,QAAQ,EAAE,WAAW,CAAiB;IAE7C,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,GAAG,SAAS,CAAC;IAMpG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAUrG,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhG,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAUrG,SAAS,CAAC,wBAAwB,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IAI7F,SAAS,CAAC,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAIrF,SAAS,CAAC,oBAAoB,CAC5B,OAAO,EAAE,QAAQ,GAChB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAYnE,SAAS,CAAC,uBAAuB,CAC/B,OAAO,EAAE,QAAQ,GAChB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,GAAG,SAAS,CAAC;CAK7D"}

package/lib/packlets/bcp47/validation/isWellFormed.js

@@ -0,0 +1,102 @@
+"use strict";
+/*
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsWellFormedValidator = void 0;
+const Iana = __importStar(require("../../iana"));
+const Bcp47Subtags = __importStar(require("../bcp47Subtags"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const baseValidator_1 = require("./baseValidator");
+/**
+ * @internal
+ */
+class IsWellFormedValidator extends baseValidator_1.TagValidatorBase {
+    constructor() {
+        super(...arguments);
+        this.validity = 'well-formed';
+    }
+    _checkLanguage(subtags) {
+        return subtags.primaryLanguage
+            ? this.iana.subtags.languages.verifyIsWellFormed(subtags.primaryLanguage)
+            : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkExtlangs(subtags) {
+        if (subtags.extlangs) {
+            return (0, ts_utils_1.allSucceed)(subtags.extlangs.map((e) => this.iana.subtags.extlangs.verifyIsWellFormed(e)), subtags.extlangs);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkScript(subtags) {
+        return subtags.script ? this.iana.subtags.scripts.verifyIsWellFormed(subtags.script) : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkRegion(subtags) {
+        return subtags.region ? this.iana.subtags.regions.verifyIsWellFormed(subtags.region) : (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkVariants(subtags) {
+        if (subtags.variants) {
+            return (0, ts_utils_1.allSucceed)(subtags.variants.map((v) => this.iana.subtags.variants.verifyIsWellFormed(v)), subtags.variants);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _checkExtensionSingleton(singleton) {
+        return this.iana.extensions.extensions.verifyIsWellFormed(singleton);
+    }
+    _checkExtensionSubtagValue(value) {
+        return Bcp47Subtags.Validate.extensionSubtag.verifyIsWellFormed(value);
+    }
+    _checkPrivateUseTags(subtags) {
+        if (subtags.privateUse) {
+            return (0, ts_utils_1.allSucceed)(subtags.privateUse.map((pu) => Iana.LanguageSubtags.Validate.extendedLanguageRange.verifyIsWellFormed(pu)), subtags.privateUse);
+        }
+        return (0, ts_utils_1.succeed)(subtags.privateUse);
+    }
+    _checkGrandfatheredTags(subtags) {
+        return subtags.grandfathered
+            ? this.iana.subtags.grandfathered.verifyIsWellFormed(subtags.grandfathered)
+            : (0, ts_utils_1.succeed)(undefined);
+    }
+}
+exports.IsWellFormedValidator = IsWellFormedValidator;
+//# sourceMappingURL=isWellFormed.js.map

package/lib/packlets/bcp47/validation/isWellFormed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isWellFormed.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/validation/isWellFormed.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 Bcp47Subtags from '../bcp47Subtags';\n\nimport { Result, allSucceed, succeed } from '@fgv/ts-utils';\nimport { ExtensionSingleton, ExtensionSubtag } from '../bcp47Subtags/model';\n\nimport { ISubtags } from '../common';\nimport { TagValidatorBase } from './baseValidator';\nimport { TagValidity } from './common';\n\n/**\n * @internal\n */\nexport class IsWellFormedValidator extends TagValidatorBase {\n  public validity: TagValidity = 'well-formed';\n\n  protected _checkLanguage(subtags: ISubtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined> {\n    return subtags.primaryLanguage\n      ? this.iana.subtags.languages.verifyIsWellFormed(subtags.primaryLanguage)\n      : succeed(undefined);\n  }\n\n  protected _checkExtlangs(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined> {\n    if (subtags.extlangs) {\n      return allSucceed(\n        subtags.extlangs.map((e) => this.iana.subtags.extlangs.verifyIsWellFormed(e)),\n        subtags.extlangs\n      );\n    }\n    return succeed(undefined);\n  }\n\n  protected _checkScript(subtags: ISubtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined> {\n    return subtags.script ? this.iana.subtags.scripts.verifyIsWellFormed(subtags.script) : succeed(undefined);\n  }\n\n  protected _checkRegion(subtags: ISubtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined> {\n    return subtags.region ? this.iana.subtags.regions.verifyIsWellFormed(subtags.region) : succeed(undefined);\n  }\n\n  protected _checkVariants(subtags: ISubtags): Result<Iana.LanguageSubtags.VariantSubtag[] | undefined> {\n    if (subtags.variants) {\n      return allSucceed(\n        subtags.variants.map((v) => this.iana.subtags.variants.verifyIsWellFormed(v)),\n        subtags.variants\n      );\n    }\n    return succeed(undefined);\n  }\n\n  protected _checkExtensionSingleton(singleton: ExtensionSingleton): Result<ExtensionSingleton> {\n    return this.iana.extensions.extensions.verifyIsWellFormed(singleton);\n  }\n\n  protected _checkExtensionSubtagValue(value: ExtensionSubtag): Result<ExtensionSubtag> {\n    return Bcp47Subtags.Validate.extensionSubtag.verifyIsWellFormed(value);\n  }\n\n  protected _checkPrivateUseTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined> {\n    if (subtags.privateUse) {\n      return allSucceed(\n        subtags.privateUse.map((pu) =>\n          Iana.LanguageSubtags.Validate.extendedLanguageRange.verifyIsWellFormed(pu)\n        ),\n        subtags.privateUse\n      );\n    }\n    return succeed(subtags.privateUse);\n  }\n\n  protected _checkGrandfatheredTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined> {\n    return subtags.grandfathered\n      ? this.iana.subtags.grandfathered.verifyIsWellFormed(subtags.grandfathered)\n      : succeed(undefined);\n  }\n}\n"]}

package/{bcp47 → lib/packlets/bcp47}/validation/validateTag.d.ts

@@ -1,7 +1,7 @@
 import { Result } from '@fgv/ts-utils';
 import { TagValidity } from './common';
-import { Subtags } from '../common';
-import { TagValidator } from './baseValidator';
+import { ISubtags } from '../common';
+import { ITagValidator } from './baseValidator';
 /**
  * Validation helpers for BCP-47 language tags.
  * @public
@@ -22,7 +22,7 @@ export declare class ValidateTag {
      * @example `en-US` is in canonical form, `en-us` is not.
      * @example `eng-US` is in canonical form, `eng-us` is not.
      */
-    static isCanonical(subtags: Subtags): boolean;
+    static isCanonical(subtags: ISubtags): boolean;
     /**
      * Determines if supplied {@link Bcp47.Subtags | subtags } are
      * in preferred form. Preferred form is valid as specified by
@@ -37,7 +37,7 @@ export declare class ValidateTag {
      * @example `en-US` is in preferred form, `en-Latn-US` is not.
      * @example `cmn` is in preferred form, `zh-cmn-Hans` is not.
      */
-    static isInPreferredForm(subtags: Subtags): boolean;
+    static isInPreferredForm(subtags: ISubtags): boolean;
     /**
      * Determines if supplied {@link Bcp47.Subtags | subtags } are
      * strictly valid.  A strictly valid tag is both
@@ -49,7 +49,7 @@ export declare class ValidateTag {
      * a strictly valid language tag, false otherwise.
      * @example `ca-valencia` is strictly valid, `es-valencia` is not.
      */
-    static isStrictlyValid(subtags: Subtags): boolean;
+    static isStrictlyValid(subtags: ISubtags): boolean;
     /**
      * Determines if supplied {@link Bcp47.Subtags | subtags } are
      * valid as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
@@ -60,7 +60,7 @@ export declare class ValidateTag {
      * a valid language tag, false otherwise.
      * @example `en-US` is valid, `eng-US` is not.
      */
-    static isValid(subtags: Subtags): boolean;
+    static isValid(subtags: ISubtags): boolean;
     /**
      * Determines if supplied {@link Bcp47.Subtags | subtags } are
      * well-formed as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
@@ -71,7 +71,7 @@ export declare class ValidateTag {
      * @example `en-US` is valid, `english-US` is not.
      * @public
      */
-    static isWellFormed(subtags: Subtags): boolean;
+    static isWellFormed(subtags: ISubtags): boolean;
     /**
      * Chooses an appropriate default tag validator given desired and optional current
      * {@link Bcp47.TagValidity | validation level}.
@@ -81,7 +81,7 @@ export declare class ValidateTag {
      * additional validation is necessary.
      * @internal
      */
-    static chooseValidator(wantValidity: TagValidity, haveValidity?: TagValidity): TagValidator | undefined;
+    static chooseValidator(wantValidity: TagValidity, haveValidity?: TagValidity): ITagValidator | undefined;
     /**
      * Validates supplied {@link Bcp47.Subtags | subtags } to a requested
      * {@link Bcp47.TagValidity | validity level}, if necessary.
@@ -92,6 +92,6 @@ export declare class ValidateTag {
      * `Failure` with details if an error occurs.
      * @public
      */
-    static validateSubtags(subtags: Subtags, wantValidity: TagValidity, haveValidity?: TagValidity): Result<boolean>;
+    static validateSubtags(subtags: ISubtags, wantValidity: TagValidity, haveValidity?: TagValidity): Result<boolean>;
 }
 //# sourceMappingURL=validateTag.d.ts.map

package/lib/packlets/bcp47/validation/validateTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTag.d.ts","sourceRoot":"","sources":["../../../../src/packlets/bcp47/validation/validateTag.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAW,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAmB,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOhD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAgB;IAC5C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAgB;IAClD,OAAO,CAAC,MAAM,CAAC,WAAW,CAA6D;IAEvF;;;;;;;;;;;OAWG;WACW,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAOrD;;;;;;;;;;;;;OAaG;WACW,iBAAiB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAO3D;;;;;;;;;;OAUG;WACW,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIzD;;;;;;;;;OASG;WACW,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIjD;;;;;;;;;OASG;WACW,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAItD;;;;;;;;OAQG;WACW,eAAe,CAC3B,YAAY,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,WAAW,GACzB,aAAa,GAAG,SAAS;IAkB5B;;;;;;;;;OASG;WACW,eAAe,CAC3B,OAAO,EAAE,QAAQ,EACjB,YAAY,EAAE,WAAW,EACzB,YAAY,CAAC,EAAE,WAAW,GACzB,MAAM,CAAC,OAAO,CAAC;CAKnB"}

package/lib/packlets/bcp47/validation/validateTag.js

@@ -0,0 +1,159 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidateTag = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("./common");
+const isCanonical_1 = require("./isCanonical");
+const isInPreferredForm_1 = require("./isInPreferredForm");
+const isStrictlyValid_1 = require("./isStrictlyValid");
+const isValid_1 = require("./isValid");
+const isWellFormed_1 = require("./isWellFormed");
+/**
+ * Validation helpers for BCP-47 language tags.
+ * @public
+ */
+class ValidateTag {
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are in canonical form,
+     * meaning that they are at least well-formed as specified by
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646}, and
+     * all subtags are also
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | capitalized as recommended}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a language tag in canonical, false otherwise.
+     * @example `en-US` is in canonical form, `en-us` is not.
+     * @example `eng-US` is in canonical form, `eng-us` is not.
+     */
+    static isCanonical(subtags) {
+        if (!this._isCanonical) {
+            this._isCanonical = new isCanonical_1.IsCanonicalValidator();
+        }
+        return this._isCanonical.validateSubtags(subtags).isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * in preferred form. Preferred form is valid as specified by
+     * {@link  https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646} and
+     * also meets additional preferences specified in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry} -
+     * extraneous (suppressed) script tags, deprecated language, extlang, script or region tags or
+     * deprecated grandfathered or redundant tags (with a defined preferred-value) are not allowed.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a valid language tag in preferred form, false otherwise.
+     * @example `en-US` is in preferred form, `en-Latn-US` is not.
+     * @example `cmn` is in preferred form, `zh-cmn-Hans` is not.
+     */
+    static isInPreferredForm(subtags) {
+        if (!this._isInPreferredForm) {
+            this._isInPreferredForm = new isInPreferredForm_1.IsInPreferredFromValidator();
+        }
+        return this._isInPreferredForm.validateSubtags(subtags).isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * strictly valid.  A strictly valid tag is both
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | valid as defined in the RFC}
+     * and meets any other requirements such as
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-3.1.8 | prefix validity}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a strictly valid language tag, false otherwise.
+     * @example `ca-valencia` is strictly valid, `es-valencia` is not.
+     */
+    static isStrictlyValid(subtags) {
+        return this.validateSubtags(subtags, 'strictly-valid').isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * valid as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
+     * meaning that all subtags, or the tag itself for grandfathered tags, are defined in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | IANA language subtag registry}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a valid language tag, false otherwise.
+     * @example `en-US` is valid, `eng-US` is not.
+     */
+    static isValid(subtags) {
+        return this.validateSubtags(subtags, 'valid').isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * well-formed as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
+     * meaning that all subtags meet the grammar defined in the specification.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a well-formed language tag, false otherwise.
+     * @example `en-US` is valid, `english-US` is not.
+     * @public
+     */
+    static isWellFormed(subtags) {
+        return this.validateSubtags(subtags, 'well-formed').isSuccess();
+    }
+    /**
+     * Chooses an appropriate default tag validator given desired and optional current
+     * {@link Bcp47.TagValidity | validation level}.
+     * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.
+     * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.
+     * @returns An appropriate {@link Bcp47.TagValidator | tag validator} or `undefined` if no
+     * additional validation is necessary.
+     * @internal
+     */
+    static chooseValidator(wantValidity, haveValidity) {
+        if (haveValidity && (0, common_1.compareValidity)(haveValidity, wantValidity) >= 0) {
+            return undefined;
+        }
+        if (!this._validators) {
+            this._validators = {
+                /* eslint-disable @typescript-eslint/naming-convention */
+                unknown: new isWellFormed_1.IsWellFormedValidator(),
+                'well-formed': new isWellFormed_1.IsWellFormedValidator(),
+                valid: new isValid_1.IsValidValidator(),
+                'strictly-valid': new isStrictlyValid_1.IsStrictlyValidValidator()
+                /* eslint-enable @typescript-eslint/naming-convention */
+            };
+        }
+        return this._validators[wantValidity];
+    }
+    /**
+     * Validates supplied {@link Bcp47.Subtags | subtags } to a requested
+     * {@link Bcp47.TagValidity | validity level}, if necessary.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to be validated.
+     * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.
+     * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.
+     * @returns `Success` with the validated {@link Bcp47.Subtags | subtags }, or
+     * `Failure` with details if an error occurs.
+     * @public
+     */
+    static validateSubtags(subtags, wantValidity, haveValidity) {
+        var _a;
+        const validator = this.chooseValidator(wantValidity, haveValidity);
+        // istanbul ignore next - a pain to test
+        return (_a = validator === null || validator === void 0 ? void 0 : validator.validateSubtags(subtags)) !== null && _a !== void 0 ? _a : (0, ts_utils_1.succeed)(true);
+    }
+}
+exports.ValidateTag = ValidateTag;
+ValidateTag._validators = undefined;
+//# sourceMappingURL=validateTag.js.map

package/lib/packlets/bcp47/validation/validateTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTag.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/validation/validateTag.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAgD;AAChD,qCAAwD;AAIxD,+CAAqD;AACrD,2DAAiE;AACjE,uDAA6D;AAC7D,uCAA6C;AAC7C,iDAAuD;AAEvD;;;GAGG;AACH,MAAa,WAAW;IAKtB;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,WAAW,CAAC,OAAiB;QACzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACtB,IAAI,CAAC,YAAY,GAAG,IAAI,kCAAoB,EAAE,CAAC;SAChD;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,iBAAiB,CAAC,OAAiB;QAC/C,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC5B,IAAI,CAAC,kBAAkB,GAAG,IAAI,8CAA0B,EAAE,CAAC;SAC5D;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IACtE,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,eAAe,CAAC,OAAiB;QAC7C,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,SAAS,EAAE,CAAC;IACrE,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,OAAO,CAAC,OAAiB;QACrC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,YAAY,CAAC,OAAiB;QAC1C,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC;IAClE,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,eAAe,CAC3B,YAAyB,EACzB,YAA0B;QAE1B,IAAI,YAAY,IAAI,IAAA,wBAAe,EAAC,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE;YACpE,OAAO,SAAS,CAAC;SAClB;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACrB,IAAI,CAAC,WAAW,GAAG;gBACjB,yDAAyD;gBACzD,OAAO,EAAE,IAAI,oCAAqB,EAAE;gBACpC,aAAa,EAAE,IAAI,oCAAqB,EAAE;gBAC1C,KAAK,EAAE,IAAI,0BAAgB,EAAE;gBAC7B,gBAAgB,EAAE,IAAI,0CAAwB,EAAE;gBAChD,wDAAwD;aACzD,CAAC;SACH;QACD,OAAO,IAAI,CAAC,WAAY,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,eAAe,CAC3B,OAAiB,EACjB,YAAyB,EACzB,YAA0B;;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACnE,wCAAwC;QACxC,OAAO,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,eAAe,CAAC,OAAO,CAAC,mCAAI,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;;AAxIH,kCAyIC;AAtIgB,uBAAW,GAAmD,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 { Result, succeed } from '@fgv/ts-utils';\nimport { TagValidity, compareValidity } from './common';\n\nimport { ISubtags } from '../common';\nimport { ITagValidator } from './baseValidator';\nimport { IsCanonicalValidator } from './isCanonical';\nimport { IsInPreferredFromValidator } from './isInPreferredForm';\nimport { IsStrictlyValidValidator } from './isStrictlyValid';\nimport { IsValidValidator } from './isValid';\nimport { IsWellFormedValidator } from './isWellFormed';\n\n/**\n * Validation helpers for BCP-47 language tags.\n * @public\n */\nexport class ValidateTag {\n  private static _isCanonical?: ITagValidator;\n  private static _isInPreferredForm?: ITagValidator;\n  private static _validators: Record<TagValidity, ITagValidator> | undefined = undefined;\n\n  /**\n   * Determines if supplied {@link Bcp47.Subtags | subtags } are in canonical form,\n   * meaning that they are at least well-formed as specified by\n   * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646}, and\n   * all subtags are also\n   * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | capitalized as recommended}.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to test.\n   * @returns `true` if the {@link Bcp47.Subtags | subtags } represent\n   * a language tag in canonical, false otherwise.\n   * @example `en-US` is in canonical form, `en-us` is not.\n   * @example `eng-US` is in canonical form, `eng-us` is not.\n   */\n  public static isCanonical(subtags: ISubtags): boolean {\n    if (!this._isCanonical) {\n      this._isCanonical = new IsCanonicalValidator();\n    }\n    return this._isCanonical.validateSubtags(subtags).isSuccess();\n  }\n\n  /**\n   * Determines if supplied {@link Bcp47.Subtags | subtags } are\n   * in preferred form. Preferred form is valid as specified by\n   * {@link  https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646} and\n   * also meets additional preferences specified in the\n   * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry} -\n   * extraneous (suppressed) script tags, deprecated language, extlang, script or region tags or\n   * deprecated grandfathered or redundant tags (with a defined preferred-value) are not allowed.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to test.\n   * @returns `true` if the {@link Bcp47.Subtags | subtags } represent\n   * a valid language tag in preferred form, false otherwise.\n   * @example `en-US` is in preferred form, `en-Latn-US` is not.\n   * @example `cmn` is in preferred form, `zh-cmn-Hans` is not.\n   */\n  public static isInPreferredForm(subtags: ISubtags): boolean {\n    if (!this._isInPreferredForm) {\n      this._isInPreferredForm = new IsInPreferredFromValidator();\n    }\n    return this._isInPreferredForm.validateSubtags(subtags).isSuccess();\n  }\n\n  /**\n   * Determines if supplied {@link Bcp47.Subtags | subtags } are\n   * strictly valid.  A strictly valid tag is both\n   * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | valid as defined in the RFC}\n   * and meets any other requirements such as\n   * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-3.1.8 | prefix validity}.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to test.\n   * @returns `true` if the {@link Bcp47.Subtags | subtags } represent\n   * a strictly valid language tag, false otherwise.\n   * @example `ca-valencia` is strictly valid, `es-valencia` is not.\n   */\n  public static isStrictlyValid(subtags: ISubtags): boolean {\n    return this.validateSubtags(subtags, 'strictly-valid').isSuccess();\n  }\n\n  /**\n   * Determines if supplied {@link Bcp47.Subtags | subtags } are\n   * valid as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},\n   * meaning that all subtags, or the tag itself for grandfathered tags, are defined in the\n   * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | IANA language subtag registry}.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to test.\n   * @returns `true` if the {@link Bcp47.Subtags | subtags } represent\n   * a valid language tag, false otherwise.\n   * @example `en-US` is valid, `eng-US` is not.\n   */\n  public static isValid(subtags: ISubtags): boolean {\n    return this.validateSubtags(subtags, 'valid').isSuccess();\n  }\n\n  /**\n   * Determines if supplied {@link Bcp47.Subtags | subtags } are\n   * well-formed as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},\n   * meaning that all subtags meet the grammar defined in the specification.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to test.\n   * @returns `true` if the {@link Bcp47.Subtags | subtags } represent\n   * a well-formed language tag, false otherwise.\n   * @example `en-US` is valid, `english-US` is not.\n   * @public\n   */\n  public static isWellFormed(subtags: ISubtags): boolean {\n    return this.validateSubtags(subtags, 'well-formed').isSuccess();\n  }\n\n  /**\n   * Chooses an appropriate default tag validator given desired and optional current\n   * {@link Bcp47.TagValidity | validation level}.\n   * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.\n   * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.\n   * @returns An appropriate {@link Bcp47.TagValidator | tag validator} or `undefined` if no\n   * additional validation is necessary.\n   * @internal\n   */\n  public static chooseValidator(\n    wantValidity: TagValidity,\n    haveValidity?: TagValidity\n  ): ITagValidator | undefined {\n    if (haveValidity && compareValidity(haveValidity, wantValidity) >= 0) {\n      return undefined;\n    }\n\n    if (!this._validators) {\n      this._validators = {\n        /* eslint-disable @typescript-eslint/naming-convention */\n        unknown: new IsWellFormedValidator(),\n        'well-formed': new IsWellFormedValidator(),\n        valid: new IsValidValidator(),\n        'strictly-valid': new IsStrictlyValidValidator()\n        /* eslint-enable @typescript-eslint/naming-convention */\n      };\n    }\n    return this._validators![wantValidity];\n  }\n\n  /**\n   * Validates supplied {@link Bcp47.Subtags | subtags } to a requested\n   * {@link Bcp47.TagValidity | validity level}, if necessary.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } to be validated.\n   * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.\n   * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.\n   * @returns `Success` with the validated {@link Bcp47.Subtags | subtags }, or\n   * `Failure` with details if an error occurs.\n   * @public\n   */\n  public static validateSubtags(\n    subtags: ISubtags,\n    wantValidity: TagValidity,\n    haveValidity?: TagValidity\n  ): Result<boolean> {\n    const validator = this.chooseValidator(wantValidity, haveValidity);\n    // istanbul ignore next - a pain to test\n    return validator?.validateSubtags(subtags) ?? succeed(true);\n  }\n}\n"]}

package/{iana → lib/packlets/iana}/common/converters.d.ts

@@ -1,5 +1,5 @@
 import { Converter } from '@fgv/ts-utils';
-import { DatedRegistry } from './model';
+import { IDatedRegistry } from './model';
 /**
  * Validating converter from string {@link Iana.Model.YearMonthDaySpec}.
  * @public
@@ -27,5 +27,5 @@ export declare const unM49RegionCode: Converter<import("./model").UnM49RegionCod
  * @returns A new validating `Converter` which yields {@Link Iana.Model.DatedRegistry | DatedRegistry<T>}
  * @public
  */
-export declare function datedRegistry<T, TC = unknown>(entryConverter: Converter<T, TC>): Converter<DatedRegistry<T>, TC>;
+export declare function datedRegistry<T, TC = unknown>(entryConverter: Converter<T, TC>): Converter<IDatedRegistry<T>, TC>;
 //# sourceMappingURL=converters.d.ts.map

package/lib/packlets/iana/common/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../../src/packlets/iana/common/converters.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,wDAAuC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2DAAyC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2DAAyC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,eAAe,uDAAqC,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAC3C,cAAc,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAC/B,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAKlC"}