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

package/lib/test/data/iana/language-tag-extension-registry.json

@@ -0,0 +1,38 @@
+{
+  "fileDate": "2014-04-02",
+  "entries": [
+    {
+      "Identifier": "t",
+      "Description": ["Specifying Transformed Content"],
+      "Comments": [
+        "Subtags for the identification of content that has been",
+        "transformed, including but not limited to:",
+        "transliteration, transcription, and translation."
+      ],
+      "Added": "2011-12-16",
+      "RFC": "[RFC6497]",
+      "Authority": "Unicode Consortium",
+      "Contact_Email": "cldr-contact&unicode.org",
+      "Mailing_List": "cldr-users&unicode.org",
+      "URL": "http://www.unicode.org/Public/cldr/latest/core.zip"
+    },
+    {
+      "Identifier": "u",
+      "Description": ["Unicode Locale"],
+      "Comments": [
+        "Subtags for the identification of language and cultural",
+        "variations. Used to set behavior in locale APIs. Data is located in",
+        "the \"common/bcp47\" directory inside the referenced URL. Unicode",
+        "Technical Standard #35 (LDML) provides additional reference material",
+        "defining the keys and values. For more details please see",
+        "<http://cldr.unicode.org/index/bcp47-extension>."
+      ],
+      "Added": "2010-09-02",
+      "RFC": "[RFC6067]",
+      "Authority": "Unicode Consortium",
+      "Contact_Email": "cldr-contact&unicode.org",
+      "Mailing_List": "cldr-users&unicode.org",
+      "URL": "http://www.unicode.org/Public/cldr/latest/core.zip"
+    }
+  ]
+}

package/lib/test/unit/bcp47/bcp47Tags/validate.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=validate.test.d.ts.map

package/lib/test/unit/bcp47/canonicalTag.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=canonicalTag.test.d.ts.map

package/lib/test/unit/bcp47/common.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=common.test.d.ts.map

package/lib/test/unit/bcp47/commonTestCases.d.ts

@@ -0,0 +1,5 @@
+import * as Bcp47 from '../../../packlets/bcp47';
+import { GenericLanguageTagTest } from './languageTagHelpers';
+export declare const tagTestCases: GenericLanguageTagTest<string, string | RegExp>[];
+export declare const subtagsTestCases: GenericLanguageTagTest<Bcp47.ISubtags, string | RegExp>[];
+//# sourceMappingURL=commonTestCases.d.ts.map

package/lib/test/unit/bcp47/commonTestCases.js

@@ -0,0 +1,478 @@
+"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.subtagsTestCases = exports.tagTestCases = void 0;
+const languageTagHelpers_1 = require("./languageTagHelpers");
+const testCaseInit = [
+    {
+        description: 'valid canonical primary language',
+        from: 'en',
+        expected: [['en', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [['English', languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'valid non-canonical primary language',
+        from: 'EN',
+        expected: [
+            ['EN', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en', languageTagHelpers_1.allCanonicalTestKeys]
+        ]
+    },
+    {
+        description: 'valid but deprecated primary language',
+        from: 'in',
+        expected: [
+            ['in', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['id', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [['Indonesian', languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'valid private primary language',
+        from: 'qpn',
+        expected: [['qpn', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [['Private use', languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'invalid primary language',
+        from: 'ENG-US',
+        expected: [
+            ['ENG-US', ['default', 'wellFormed']],
+            ['eng-US', ['wellFormedCanonical']],
+            [/invalid language/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['ENG as spoken in United States', ['wellFormed']]]
+    },
+    {
+        description: 'valid canonical extlang',
+        from: 'zh-cmn',
+        expected: [
+            ['zh-cmn', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['cmn', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['Chinese / Mandarin Chinese', ['wellFormed']],
+            ['Mandarin Chinese', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid canonical extlang with additional tags',
+        from: 'zh-cmn-CN-x-private',
+        expected: [
+            ['zh-cmn-CN-x-private', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['cmn-CN-x-private', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['Chinese / Mandarin Chinese as spoken in China (-x "private")', ['wellFormed']],
+            ['Mandarin Chinese as spoken in China (-x "private")', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid non-canonical extlang',
+        from: 'ZH-Cmn',
+        expected: [
+            ['ZH-Cmn', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['zh-cmn', languageTagHelpers_1.allCanonicalTestKeys],
+            ['cmn', languageTagHelpers_1.allPreferredKeys]
+        ]
+    },
+    {
+        description: 'invalid extlang',
+        from: 'zh-Han',
+        expected: [
+            ['zh-Han', ['default', 'wellFormed']],
+            ['zh-han', ['wellFormedCanonical']],
+            [/invalid extlang/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['Chinese / Han', ['wellFormed']]]
+    },
+    {
+        description: 'valid extlang with invalid prefix',
+        from: 'en-cmn-us',
+        expected: [
+            ['en-cmn-us', ['default', 'wellFormed', 'valid']],
+            ['en-cmn-US', ['wellFormedCanonical', 'validCanonical', 'preferred']],
+            [/invalid prefix/i, ['strictlyValid', 'strictlyValidCanonical', 'strictlyValidPreferred']]
+        ],
+        expectedDescription: [['English / Mandarin Chinese as spoken in United States', ['wellFormed']]]
+    },
+    {
+        description: 'multiple extlang',
+        from: 'zh-cmn-yue',
+        expected: [
+            ['zh-cmn-yue', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/multiple extlang/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['Chinese / Mandarin Chinese / Yue Chinese', ['wellFormed']]]
+    },
+    {
+        description: 'valid non-canonical, non-suppressed script',
+        from: 'zh-LATN',
+        expected: [
+            ['zh-LATN', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['zh-Latn', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [['Chinese in Latin script', ['wellFormed', 'preferred']]]
+    },
+    {
+        description: 'valid non-canonical, suppressed script',
+        from: 'en-LATN',
+        expected: [
+            ['en-LATN', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en-Latn', languageTagHelpers_1.allNonPreferredCanonicalKeys],
+            ['en', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['English in Latin script', ['wellFormed']],
+            ['English', ['preferred']]
+        ]
+    },
+    {
+        description: 'invalid script',
+        from: 'en-AaaA',
+        expected: [
+            ['en-AaaA', ['default', 'wellFormed']],
+            ['en-Aaaa', ['wellFormedCanonical']],
+            [/invalid script/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['English in AaaA script', ['wellFormed']]]
+    },
+    {
+        description: 'valid non-canonical iso3166-2 region',
+        from: 'en-aq',
+        expected: [
+            ['en-aq', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en-AQ', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [['English as spoken in Antarctica', ['wellFormed', 'preferred']]]
+    },
+    {
+        description: 'valid non-canonical UN M.49 region',
+        from: 'es-419',
+        expected: [['es-419', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [['Spanish as spoken in Latin America and the Caribbean', languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'invalid region',
+        from: 'en-AJ',
+        expected: [
+            ['en-AJ', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/invalid region/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['English as spoken in AJ', ['wellFormed']]]
+    },
+    {
+        description: 'strictly valid non-canonical variant',
+        from: 'ca-Valencia',
+        expected: [
+            ['ca-Valencia', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['ca-valencia', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [['Catalan (Valencian)', ['wellFormed']]]
+    },
+    {
+        description: 'not strictly-valid non-canonical variant',
+        from: 'fr-Valencia',
+        expected: [
+            ['fr-Valencia', ['default', 'wellFormed', 'valid']],
+            ['fr-valencia', ['wellFormedCanonical', 'validCanonical', 'preferred']],
+            [/invalid prefix/i, ['strictlyValid', 'strictlyValidCanonical', 'strictlyValidPreferred']]
+        ],
+        expectedDescription: [['French (Valencian)', ['wellFormed']]]
+    },
+    {
+        description: 'valid but deprecated region',
+        from: 'en-BU',
+        expected: [
+            ['en-BU', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['en-MM', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['English as spoken in Burma', ['wellFormed']],
+            ['English as spoken in Myanmar', ['preferred']]
+        ]
+    },
+    {
+        description: 'any prefix for variant with no registered prefix',
+        from: 'en-alalc97',
+        expected: [['en-alalc97', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [['English (ALA-LC Romanization, 1997 edition)', ['wellFormed']]]
+    },
+    {
+        description: 'strictly valid with two variants',
+        from: 'SL-Rozaj-Lipaw',
+        expected: [
+            ['SL-Rozaj-Lipaw', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['sl-rozaj-lipaw', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [['Slovenian (Resian) (The Lipovaz dialect of Resian)', ['wellFormed']]]
+    },
+    {
+        description: 'strictly valid with multiple variants',
+        from: 'SL-Rozaj-biske-1994',
+        expected: [
+            ['SL-Rozaj-biske-1994', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['sl-rozaj-biske-1994', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [
+            [
+                'Slovenian (Resian) (The San Giorgio dialect of Resian) (Standardized Resian orthography)',
+                ['wellFormed']
+            ]
+        ]
+    },
+    {
+        description: 'not strictly valid with multiple variants',
+        from: 'SL-Rozaj-1996',
+        expected: [
+            ['SL-Rozaj-1996', ['default', 'wellFormed', 'valid']],
+            ['sl-rozaj-1996', ['wellFormedCanonical', 'validCanonical', 'preferred']],
+            [/invalid prefix/i, ['strictlyValid', 'strictlyValidCanonical', 'strictlyValidPreferred']]
+        ],
+        expectedDescription: [['Slovenian (Resian) (German orthography of 1996)', ['wellFormed']]]
+    },
+    {
+        description: 'invalid variant',
+        from: 'ca-ES-xyzzy',
+        expected: [
+            ['ca-ES-xyzzy', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/invalid variant/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['Catalan as spoken in Spain (xyzzy)', ['wellFormed']]]
+    },
+    {
+        description: 'invalid duplicate variant',
+        from: 'ca-valencia-valencia',
+        expected: [
+            ['ca-valencia-valencia', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/duplicate variant/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['Catalan (Valencian) (Valencian)', ['wellFormed']]]
+    },
+    {
+        description: 'valid extensions',
+        from: 'en-us-u-en-US-t-MT',
+        expected: [
+            ['en-us-u-en-US-t-MT', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en-US-u-en-US-t-mt', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [
+            [
+                'English as spoken in United States (Unicode Locale "en-US") (Specifying Transformed Content "MT")',
+                ['wellFormed']
+            ]
+        ]
+    },
+    {
+        description: 'invalid extension',
+        from: 'es-us-a-extend',
+        expected: [
+            ['es-us-a-extend', ['default', 'wellFormed']],
+            ['es-US-a-extend', ['wellFormedCanonical']],
+            [/invalid.*extension/i, languageTagHelpers_1.allValidatingKeys]
+        ],
+        expectedDescription: [['Spanish as spoken in United States (-a "extend")', ['wellFormed']]]
+    },
+    {
+        description: 'duplicate extension',
+        from: 'es-us-u-US-u-GB',
+        expected: [
+            ['es-us-u-US-u-GB', ['default', 'wellFormed']],
+            ['es-US-u-us-u-gb', ['wellFormedCanonical']],
+            [/duplicate.*extension/i, languageTagHelpers_1.allValidatingKeys]
+        ]
+    },
+    {
+        description: 'valid private-use subtag',
+        from: 'en-x-Pig-Latin',
+        expected: [
+            ['en-x-Pig-Latin', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en-x-pig-latin', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [
+            ['English (-x "Pig-Latin")', ['wellFormed']],
+            ['English (-x "pig-latin")', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid extension and private use subtag',
+        from: 'en-US-u-us-x-test',
+        expected: [['en-US-u-us-x-test', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [
+            ['English as spoken in United States (Unicode Locale "us") (-x "test")', ['wellFormed']]
+        ]
+    },
+    {
+        description: 'valid grandfathered tag with no preferredValue',
+        from: 'i-Mingo',
+        expected: [
+            ['i-Mingo', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['i-mingo', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [
+            ['i-Mingo (grandfathered)', ['wellFormed']],
+            ['i-mingo (grandfathered)', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid grandfathered tag with preferredValue',
+        from: 'art-lojban',
+        expected: [
+            ['art-lojban', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['jbo', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['art-lojban (grandfathered)', ['wellFormed']],
+            ['Lojban', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid grandfathered tag with complex preferred value',
+        from: 'en-gb-oed',
+        expected: [
+            ['en-gb-oed', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['en-GB-oed', languageTagHelpers_1.allNonPreferredCanonicalKeys],
+            ['en-GB-oxendict', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['en-gb-oed (grandfathered)', ['wellFormed']],
+            ['English as spoken in United Kingdom (Oxford English Dictionary spelling)', ['preferred']]
+        ]
+    },
+    {
+        description: 'valid redundant tag with no preferredValue',
+        from: 'mn-Mong',
+        expected: [['mn-Mong', languageTagHelpers_1.allTestKeys]],
+        expectedDescription: [['Mongolian in Mongolian script', languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'valid redundant tag with preferred value',
+        from: 'sgn-BR',
+        expected: [
+            ['sgn-BR', [...languageTagHelpers_1.allNonCanonicalTestKeys, ...languageTagHelpers_1.allNonPreferredCanonicalKeys]],
+            ['bzs', languageTagHelpers_1.allPreferredKeys]
+        ],
+        expectedDescription: [
+            ['Sign languages as spoken in Brazil', ['wellFormed']],
+            ['Brazilian Sign Language', ['preferred']]
+        ]
+    },
+    {
+        description: 'invalid private tag',
+        from: 'x-thing-x-other-thing-x-last-thing',
+        expected: [[/malformed private-use/i, languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'completely private tag with multiple tags',
+        from: 'x-some-bunch-of-things',
+        expected: [
+            ['x-some-bunch-of-things', languageTagHelpers_1.allNonCanonicalTestKeys],
+            ['x-some-bunch-OF-things', languageTagHelpers_1.allCanonicalTestKeys]
+        ],
+        expectedDescription: [
+            ['(-x "some-bunch-of-things")', ['wellFormed']],
+            ['(-x "some-bunch-OF-things")', ['preferred']]
+        ]
+    }
+];
+const subtagsTestCaseInit = [
+    {
+        description: 'valid non-canonical tag with suppressed script',
+        from: {
+            primaryLanguage: 'en',
+            script: 'latn',
+            region: 'us',
+            privateUse: ['Non', 'Canon']
+        },
+        expected: [
+            ['en-latn-us-x-Non-Canon', ['default', 'wellFormed', 'valid', 'strictlyValid']],
+            ['en-Latn-US-x-non-canon', ['wellFormedCanonical', 'validCanonical', 'strictlyValidCanonical']],
+            ['en-US-x-non-canon', ['preferred', 'strictlyValidPreferred']]
+        ]
+    },
+    {
+        description: 'missing primary language',
+        from: {
+            extlangs: ['cmn', 'yue']
+        },
+        expected: [[/missing primary language/i, languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        // the grammar allows for up to three extlang tags but the specification reserves
+        // and forbids them, so two tags only fails for validating forms.
+        description: 'multiple extlang tags',
+        from: {
+            primaryLanguage: 'zh',
+            extlangs: ['cmn', 'yue']
+        },
+        expected: [
+            ['zh-cmn-yue', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/multiple extlang/, languageTagHelpers_1.allValidatingKeys]
+        ]
+    },
+    {
+        // the grammar forbids > 3 extlang tags so this fails for all forms
+        description: 'too many extlang tags',
+        from: {
+            primaryLanguage: 'zh',
+            extlangs: ['cmn', 'yue', 'cdo', 'cjy']
+        },
+        expected: [[/too many extlang/, languageTagHelpers_1.allTestKeys]]
+    },
+    {
+        description: 'invalid script tag',
+        from: {
+            primaryLanguage: 'en',
+            script: 'Xyzy'
+        },
+        expected: [
+            ['en-Xyzy', ['default', 'preferred', 'wellFormed', 'wellFormedCanonical']],
+            [/invalid script/i, languageTagHelpers_1.allValidatingKeys]
+        ]
+    },
+    {
+        description: 'duplicate variant tags',
+        from: {
+            primaryLanguage: 'ca',
+            variants: ['valencia', 'Valencia']
+        },
+        expected: [
+            ['ca-valencia-Valencia', ['default', 'wellFormed']],
+            ['ca-valencia-valencia', ['wellFormedCanonical']],
+            [/duplicate variant/, languageTagHelpers_1.allValidatingKeys]
+        ]
+    },
+    {
+        description: 'invalid grandfathered tag',
+        from: { grandfathered: 'i-dothraki' },
+        expected: [
+            ['i-dothraki', ['default', 'wellFormed', 'wellFormedCanonical']],
+            [/invalid grandfathered/i, [...languageTagHelpers_1.allValidatingKeys]]
+        ]
+    }
+];
+// eslint-disable-next-line @rushstack/typedef-var
+exports.tagTestCases = testCaseInit.map(languageTagHelpers_1.GenericLanguageTagTest.mapInitToTestCases);
+// eslint-disable-next-line @rushstack/typedef-var
+exports.subtagsTestCases = subtagsTestCaseInit.map(languageTagHelpers_1.GenericLanguageTagTest.mapInitToTestCases);
+//# sourceMappingURL=commonTestCases.js.map

package/lib/test/unit/bcp47/helpers.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=helpers.test.d.ts.map

package/lib/test/unit/bcp47/languageRegistryData.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=languageRegistryData.test.d.ts.map

package/lib/test/unit/bcp47/languageTag.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=languageTag.test.d.ts.map

package/lib/test/unit/bcp47/languageTagHelpers.d.ts

@@ -0,0 +1,70 @@
+import '@fgv/ts-utils-jest';
+import * as Bcp47 from '../../../packlets/bcp47';
+interface IGenericLanguageTagTestExpected<TEXPECTED = string | RegExp> {
+    default?: TEXPECTED;
+    wellFormed?: TEXPECTED;
+    wellFormedCanonical?: TEXPECTED;
+    valid?: TEXPECTED;
+    validCanonical?: TEXPECTED;
+    preferred?: TEXPECTED;
+    strictlyValid?: TEXPECTED;
+    strictlyValidCanonical?: TEXPECTED;
+    strictlyValidPreferred?: TEXPECTED;
+}
+export type TestKey = keyof IGenericLanguageTagTestExpected;
+export declare const allTestKeys: TestKey[];
+export declare const allNonCanonicalTestKeys: TestKey[];
+export declare const allCanonicalTestKeys: TestKey[];
+export declare const allNonPreferredCanonicalKeys: TestKey[];
+export declare const allPreferredKeys: TestKey[];
+export declare const allValidatingKeys: TestKey[];
+export interface IGenericLanguageTagTestInit<TFROM, TEXPECTED = string | RegExp> {
+    description: string;
+    from: TFROM;
+    expected: [TEXPECTED | undefined, TestKey[]][];
+    expectedDescription?: [string | undefined, TestKey[]][];
+}
+export declare class GenericLanguageTagTest<TFROM, TEXPECTED = string | RegExp> {
+    readonly description: string;
+    readonly from: TFROM;
+    readonly expected: IGenericLanguageTagTestExpected<TEXPECTED>;
+    readonly expectedDescription?: IGenericLanguageTagTestExpected<string>;
+    constructor(init: IGenericLanguageTagTestInit<TFROM, TEXPECTED>);
+    static mapInitToTestCases<TFROM, TEXPECTED = string | RegExp>(init: IGenericLanguageTagTestInit<TFROM, TEXPECTED>): GenericLanguageTagTest<TFROM, TEXPECTED>;
+}
+export interface ITagTestCase<TFROM, TEXPECTED = string | RegExp> {
+    description: string;
+    from: TFROM;
+    expected?: TEXPECTED;
+    expectedDescription?: string;
+    invoke(): void;
+}
+export type TagTestCaseEntry<TFROM, TTESTCASE extends ITagTestCase<TFROM>> = [string, TTESTCASE];
+export declare abstract class TagTestCaseFactoryBase<TFROM, TTESTCASE extends ITagTestCase<TFROM>> {
+    emitOne(gtc: GenericLanguageTagTest<TFROM>, which: TestKey): TagTestCaseEntry<TFROM, TTESTCASE> | undefined;
+    emit(which: TestKey | TestKey[], all: GenericLanguageTagTest<TFROM>[]): TagTestCaseEntry<TFROM, TTESTCASE>[];
+    protected abstract _construct(gtc: GenericLanguageTagTest<TFROM>, which: TestKey): TTESTCASE;
+}
+export declare class GenericTagTestCaseFactory<TFROM, TTESTCASE extends ITagTestCase<TFROM>> extends TagTestCaseFactoryBase<TFROM, TTESTCASE> {
+    protected _construct: (gtc: GenericLanguageTagTest<TFROM>, which: TestKey) => TTESTCASE;
+    constructor(construct: (gtc: GenericLanguageTagTest<TFROM>, which: TestKey) => TTESTCASE);
+}
+export declare abstract class SimpleTagTestCaseBase<TFROM> implements ITagTestCase<TFROM> {
+    readonly description: string;
+    readonly from: TFROM;
+    readonly options: Bcp47.ILanguageTagInitOptions | undefined;
+    readonly expected?: string | RegExp;
+    readonly expectedDescription?: string;
+    constructor(gtc: GenericLanguageTagTest<TFROM>, which: TestKey);
+    get isSuccessTest(): boolean;
+    get isFailureTest(): boolean;
+    get isIgnoredTest(): boolean;
+    protected _getExpectedValue(__which: TestKey, __gtc: GenericLanguageTagTest<TFROM>, expected: string | RegExp | undefined): string | RegExp | undefined;
+    protected _getTestTarget(which: TestKey, __gtc: GenericLanguageTagTest<TFROM>): string;
+    protected _getSuccessTestDescription(testTarget: string, from: TFROM, description: string): string;
+    protected _getFailureTestDescription(testTarget: string, from: TFROM, description: string): string;
+    protected _getIgnoredTestDescription(testTarget: string, from: TFROM, description: string): string;
+    abstract invoke(): void;
+}
+export {};
+//# sourceMappingURL=languageTagHelpers.d.ts.map