{"record":{"id":"f3f72c5933f47485","repo":"Humanizr/Humanizer","slug":"linked-vigesimal-number-profiles-require-descendin","errorCode":null,"errorMessage":"Linked-vigesimal number profiles require descending scales.","messagePattern":"Linked-vigesimal number profiles require descending scales\\.","errorType":"exception","errorClass":"InvalidOperationException","httpStatus":null,"severity":"error","filePath":"src/Humanizer/Localisation/NumberToWords/LinkedVigesimalNumberToWordsConverter.cs","lineNumber":197,"sourceCode":"        {\n            throw new InvalidOperationException(\"Linked-vigesimal number profiles require at least a zero word.\");\n        }\n\n        return value;\n    }\n\n    static LinkedVigesimalScale[] ValidateScales(LinkedVigesimalScale[] value)\n    {\n        for (var i = 0; i < value.Length; i++)\n        {\n            if (value[i].Value <= 0)\n            {\n                throw new InvalidOperationException(\"Linked-vigesimal number profiles require positive scale values.\");\n            }\n\n            if (i > 0 && value[i - 1].Value <= value[i].Value)\n            {\n                throw new InvalidOperationException(\"Linked-vigesimal number profiles require descending scales.\");\n            }\n        }\n\n        return value;\n    }\n}\n\n/// <summary>\n/// One descending scale row for linked-vigesimal renderers and parsers.\n/// </summary>\n/// <param name=\"Value\">The numeric scale value.</param>\n/// <param name=\"One\">The exact singular scale phrase.</param>\n/// <param name=\"OneWithRemainder\">The singular scale phrase when followed by a lower-order remainder.</param>\n/// <param name=\"Name\">The scale noun used with generated counts.</param>\n/// <param name=\"NameWithRemainder\">The scale noun used with generated counts when followed by a lower-order remainder.</param>\n/// <param name=\"CountJoiner\">The joiner between scale noun and generated count.</param>\n/// <param name=\"CountOverrides\">Exact scale-count phrases keyed by count.</param>\n/// <param name=\"CountOverridesWithRemainder\">Exact scale-count phrases keyed by count when followed by a lower-order remainder.</param>","sourceCodeStart":179,"sourceCodeEnd":215,"githubUrl":"https://github.com/Humanizr/Humanizer/blob/ffc2b77c0f30d2fb176875841424379319d0ae9b/src/Humanizer/Localisation/NumberToWords/LinkedVigesimalNumberToWordsConverter.cs#L179-L215","documentation":"Profile constructor validation: scale rows must be in strictly descending Value order. Non-descending adjacent values (value[i-1].Value <= value[i].Value) are rejected at instantiation.","triggerScenarios":"First converter use for a linked-vigesimal culture whose scales are not strictly descending.","commonSituations":"Locale YAML listing scales in the wrong order, or duplicate scale values.","solutions":["Report the locale bug — scales are not strictly descending.","Use a locale with correctly ordered scales.","If authoring, order scale rows by descending Value with no duplicates."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"// Construction-time validation; no public pre-check. Isolate converter resolution per culture.","typeGuard":null,"tryCatchPattern":"string words;\ntry\n{\n    words = value.ToWords(culture);\n}\ncatch (InvalidOperationException ex) when (ex.Message.Contains(\"descending scales\"))\n{\n    words = value.ToWords(CultureInfo.InvariantCulture);\n}","preventionTips":["Smoke-test converter resolution per locale at startup.","Report unordered/duplicate scales upstream.","Pin consistent Humanizer versions."],"tags":["number-to-words","profile-data","localization","construction-validation"],"backgroundTag":null,"analyzedSha":"ffc2b77c0f30d2fb176875841424379319d0ae9b","analyzedAt":"2026-08-13T21:42:34.584Z","schemaVersion":2},"datasetVersion":"2026-08-14T00:17:13.853Z"}