shevchenko 3.2.1 → 3.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/dist/cjs/anthroponym-declension/anthroponym-inflector.js +1 -1
  2. package/dist/cjs/anthroponym-declension/bootstrap.js +1 -1
  3. package/dist/cjs/anthroponym-declension/family-name-classifier/artifacts/model.bundle.json.js +1 -1
  4. package/dist/cjs/anthroponym-declension/family-name-classifier/cache/incorrect-predictions.json.js +1 -1
  5. package/dist/cjs/anthroponym-declension/family-name-classifier/family-name-class-transformer.js +1 -1
  6. package/dist/cjs/anthroponym-declension/family-name-classifier/family-name-classifer.js +1 -1
  7. package/dist/cjs/anthroponym-declension/family-name-classifier/model-bundle-loader.js +1 -1
  8. package/dist/cjs/anthroponym-declension/family-name-classifier/model-config.js +1 -1
  9. package/dist/cjs/anthroponym-declension/family-name-classifier/word-transformer.js +1 -1
  10. package/dist/cjs/anthroponym-declension/family-name-inflector.js +1 -1
  11. package/dist/cjs/anthroponym-declension/given-name-inflector.js +1 -1
  12. package/dist/cjs/anthroponym-declension/name-inflector.js +1 -1
  13. package/dist/cjs/anthroponym-declension/patronymic-name-inflector.js +1 -1
  14. package/dist/cjs/extension.js +1 -1
  15. package/dist/cjs/gender-detection/artifacts/given-name-rules.json.js +1 -1
  16. package/dist/cjs/gender-detection/artifacts/patronymic-name-rules.json.js +1 -1
  17. package/dist/cjs/gender-detection/detect-gender.js +1 -1
  18. package/dist/cjs/gender-detection/grammatical-gender-detector.js +1 -1
  19. package/dist/cjs/index.js +1 -1
  20. package/dist/cjs/input-validation.js +33 -5
  21. package/dist/cjs/language/alphabet.js +1 -1
  22. package/dist/cjs/language/grammatical-case.js +1 -1
  23. package/dist/cjs/language/grammatical-gender.js +1 -1
  24. package/dist/cjs/language/letter-case.js +1 -1
  25. package/dist/cjs/language/linguistics.js +1 -1
  26. package/dist/cjs/language/word-class.js +1 -1
  27. package/dist/cjs/shevchenko.js +6 -6
  28. package/dist/cjs/word-declension/append-command-runner.js +1 -1
  29. package/dist/cjs/word-declension/bootstrap.js +1 -1
  30. package/dist/cjs/word-declension/command-runner-factory.js +1 -1
  31. package/dist/cjs/word-declension/declension-rule-inflector.js +1 -1
  32. package/dist/cjs/word-declension/declension-types.js +1 -1
  33. package/dist/cjs/word-declension/replace-command-runner.js +1 -1
  34. package/dist/cjs/word-declension/rules/artifacts/declension-rules.json.js +5 -3
  35. package/dist/cjs/word-declension/word-inflector.js +4 -9
  36. package/dist/es/anthroponym-declension/anthroponym-inflector.js +1 -1
  37. package/dist/es/anthroponym-declension/bootstrap.js +1 -1
  38. package/dist/es/anthroponym-declension/family-name-classifier/artifacts/model.bundle.json.js +1 -1
  39. package/dist/es/anthroponym-declension/family-name-classifier/cache/incorrect-predictions.json.js +1 -1
  40. package/dist/es/anthroponym-declension/family-name-classifier/family-name-class-transformer.js +1 -1
  41. package/dist/es/anthroponym-declension/family-name-classifier/family-name-classifer.js +1 -1
  42. package/dist/es/anthroponym-declension/family-name-classifier/model-bundle-loader.js +1 -1
  43. package/dist/es/anthroponym-declension/family-name-classifier/model-config.js +1 -1
  44. package/dist/es/anthroponym-declension/family-name-classifier/word-transformer.js +1 -1
  45. package/dist/es/anthroponym-declension/family-name-inflector.js +1 -1
  46. package/dist/es/anthroponym-declension/given-name-inflector.js +1 -1
  47. package/dist/es/anthroponym-declension/name-inflector.js +1 -1
  48. package/dist/es/anthroponym-declension/patronymic-name-inflector.js +1 -1
  49. package/dist/es/extension.js +1 -1
  50. package/dist/es/gender-detection/artifacts/given-name-rules.json.js +1 -1
  51. package/dist/es/gender-detection/artifacts/patronymic-name-rules.json.js +1 -1
  52. package/dist/es/gender-detection/detect-gender.js +1 -1
  53. package/dist/es/gender-detection/grammatical-gender-detector.js +1 -1
  54. package/dist/es/index.js +1 -1
  55. package/dist/es/input-validation.d.ts +18 -6
  56. package/dist/es/input-validation.js +33 -5
  57. package/dist/es/language/alphabet.js +1 -1
  58. package/dist/es/language/grammatical-case.js +1 -1
  59. package/dist/es/language/grammatical-gender.js +1 -1
  60. package/dist/es/language/letter-case.js +1 -1
  61. package/dist/es/language/linguistics.js +1 -1
  62. package/dist/es/language/word-class.js +1 -1
  63. package/dist/es/shevchenko.js +6 -6
  64. package/dist/es/word-declension/append-command-runner.js +1 -1
  65. package/dist/es/word-declension/bootstrap.js +1 -1
  66. package/dist/es/word-declension/command-runner-factory.js +1 -1
  67. package/dist/es/word-declension/declension-rule-inflector.js +1 -1
  68. package/dist/es/word-declension/declension-types.js +1 -1
  69. package/dist/es/word-declension/replace-command-runner.js +1 -1
  70. package/dist/es/word-declension/rules/artifacts/declension-rules.json.js +5 -3
  71. package/dist/es/word-declension/word-inflector.js +4 -9
  72. package/dist/umd/shevchenko.min.js +4 -4
  73. package/package.json +2 -1
  74. package/dist/es/word-declension/word-inflector.test.d.ts +0 -1
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
package/dist/es/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -2,14 +2,26 @@ import { DeclensionInput, GenderDetectionInput } from './contracts';
2
2
  export declare class InputValidationError extends TypeError {
3
3
  }
4
4
  /**
5
- * Validates if a given value is a valid input for declension.
5
+ * Validates and normalizes declension input.
6
6
  *
7
- * @throws {InputValidationError}
7
+ * Validates that the input is a valid declension input object and normalizes all string fields
8
+ * to NFC (Canonical Decomposition followed by Canonical Composition) form to ensure Unicode
9
+ * characters are in a consistent form for reliable pattern matching with Cyrillic characters.
10
+ *
11
+ * @param input - The input to validate and normalize
12
+ * @returns A new validated and normalized input object
13
+ * @throws {InputValidationError} If validation fails
8
14
  */
9
- export declare function validateDeclensionInput(input: unknown): asserts input is DeclensionInput;
15
+ export declare function validateDeclensionInput<T extends DeclensionInput>(input: T): T;
10
16
  /**
11
- * Validates if a given value is a valid input for gender detection.
17
+ * Validates and normalizes gender detection input.
18
+ *
19
+ * Validates that the input is a valid gender detection input object and normalizes all string
20
+ * fields to NFC (Canonical Decomposition followed by Canonical Composition) form to ensure
21
+ * Unicode characters are in a consistent form for reliable pattern matching with Cyrillic characters.
12
22
  *
13
- * @throws {InputValidationError}
23
+ * @param input - The input to validate and normalize
24
+ * @returns A new validated and normalized input object
25
+ * @throws {InputValidationError} If validation fails
14
26
  */
15
- export declare function validateGenderDetectionInput(input: unknown): asserts input is GenderDetectionInput;
27
+ export declare function validateGenderDetectionInput<T extends GenderDetectionInput>(input: T): T;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -17,9 +17,15 @@ class InputValidationError extends TypeError {
17
17
  }
18
18
  const fieldNames = ['givenName', 'patronymicName', 'familyName'];
19
19
  /**
20
- * Validates if a given value is a valid input for declension.
20
+ * Validates and normalizes declension input.
21
21
  *
22
- * @throws {InputValidationError}
22
+ * Validates that the input is a valid declension input object and normalizes all string fields
23
+ * to NFC (Canonical Decomposition followed by Canonical Composition) form to ensure Unicode
24
+ * characters are in a consistent form for reliable pattern matching with Cyrillic characters.
25
+ *
26
+ * @param input - The input to validate and normalize
27
+ * @returns A new validated and normalized input object
28
+ * @throws {InputValidationError} If validation fails
23
29
  */
24
30
  function validateDeclensionInput(input) {
25
31
  if (!isObject(input)) {
@@ -40,11 +46,25 @@ function validateDeclensionInput(input) {
40
46
  throw new InputValidationError(`The "${fieldName}" parameter must be a string.`);
41
47
  }
42
48
  }
49
+ const validInput = Object.assign({}, input);
50
+ for (const fieldName of mergedFieldNames) {
51
+ const fieldValue = validInput[fieldName];
52
+ if (typeof fieldValue === 'string') {
53
+ validInput[fieldName] = fieldValue.normalize('NFC');
54
+ }
55
+ }
56
+ return validInput;
43
57
  }
44
58
  /**
45
- * Validates if a given value is a valid input for gender detection.
59
+ * Validates and normalizes gender detection input.
46
60
  *
47
- * @throws {InputValidationError}
61
+ * Validates that the input is a valid gender detection input object and normalizes all string
62
+ * fields to NFC (Canonical Decomposition followed by Canonical Composition) form to ensure
63
+ * Unicode characters are in a consistent form for reliable pattern matching with Cyrillic characters.
64
+ *
65
+ * @param input - The input to validate and normalize
66
+ * @returns A new validated and normalized input object
67
+ * @throws {InputValidationError} If validation fails
48
68
  */
49
69
  function validateGenderDetectionInput(input) {
50
70
  if (!isObject(input)) {
@@ -59,6 +79,14 @@ function validateGenderDetectionInput(input) {
59
79
  throw new InputValidationError(`The "${fieldName}" parameter must be a string.`);
60
80
  }
61
81
  }
82
+ const validInput = Object.assign({}, input);
83
+ for (const fieldName of fieldNames) {
84
+ const fieldValue = validInput[fieldName];
85
+ if (typeof fieldValue === 'string') {
86
+ validInput[fieldName] = fieldValue.normalize('NFC');
87
+ }
88
+ }
89
+ return validInput;
62
90
  }
63
91
  function isObject(value) {
64
92
  return typeof value === 'object' && value != null;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -25,9 +25,9 @@ import './word-declension/declension-types.js';
25
25
  * @throws {InputValidationError} Input validation error.
26
26
  */
27
27
  async function inGrammaticalCase(grammaticalCase, input) {
28
- validateDeclensionInput(input);
29
- const output = await anthroponymInflector.inflect(input, input.gender, grammaticalCase);
30
- const afterOutput = await afterInflect(grammaticalCase, input);
28
+ const validInput = validateDeclensionInput(input);
29
+ const output = await anthroponymInflector.inflect(validInput, validInput.gender, grammaticalCase);
30
+ const afterOutput = await afterInflect(grammaticalCase, validInput);
31
31
  return Object.assign(Object.assign({}, output), afterOutput);
32
32
  }
33
33
  /**
@@ -164,8 +164,8 @@ async function inVocative(input) {
164
164
  * @throws {InputValidationError} Input validation error.
165
165
  */
166
166
  async function detectGender(input) {
167
- validateGenderDetectionInput(input);
168
- return detectGender$1(input);
167
+ const validInput = validateGenderDetectionInput(input);
168
+ return detectGender$1(validInput);
169
169
  }
170
170
 
171
171
  export { GrammaticalCase, detectGender, inAblative, inAccusative, inDative, inGenitive, inLocative, inNominative, inVocative };
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -4531,11 +4531,13 @@ var declensionRules = [
4531
4531
  }
4532
4532
  },
4533
4533
  {
4534
- description: "друга відміна / чоловічий рід / м'яка група / на -окар, -екар, -етар, -зар, -ухар",
4534
+ description: "друга відміна / чоловічий рід / м'яка група / на -окар, -екар, лікар, -етар, слюсар, -зар, -ухар",
4535
4535
  examples: [
4536
4536
  "токар",
4537
4537
  "пекар",
4538
+ "лікар",
4538
4539
  "решетар",
4540
+ "слюсар",
4539
4541
  "кожухар",
4540
4542
  "кобзар"
4541
4543
  ],
@@ -4547,7 +4549,7 @@ var declensionRules = [
4547
4549
  applicationType: [
4548
4550
  ],
4549
4551
  pattern: {
4550
- find: "(окар|екар|етар|([бвгґджзйклмнпрстфхцчшщ]|дз|дж)зар|ухар)(?<!гузар)$",
4552
+ find: "(окар|екар|лікар|етар|слюсар|([бвгґджзйклмнпрстфхцчшщ]|дз|дж)зар|ухар)(?<!гузар)$",
4551
4553
  modify: "(.{1})$"
4552
4554
  },
4553
4555
  grammaticalCases: {
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * @file JavaScript library for declension of Ukrainian anthroponyms
3
3
  * @module shevchenko
4
- * @version 3.2.1
4
+ * @version 3.2.3
5
5
  * @author Oleksandr Tolochko <shevchenko-js@tooleks.com>
6
6
  * @license MIT
7
7
  * @copyright 2017-2026 Oleksandr Tolochko <shevchenko-js@tooleks.com>
@@ -14,16 +14,11 @@ class WordInflector {
14
14
  this.declensionRules = [...declensionRules].sort((firstRule, lastRule) => lastRule.priority - firstRule.priority);
15
15
  }
16
16
  async inflect(word, params) {
17
- // Normalize to NFC (Canonical Decomposition followed by Canonical Composition) to ensure
18
- // Unicode characters are in a consistent form. This is critical for reliable pattern matching
19
- // with Cyrillic characters, as some characters (e.g., 'і', 'ї') can be represented in multiple
20
- // Unicode forms (composed vs. decomposed), which would cause regex patterns to fail.
21
- const normalizedWord = word.normalize('NFC');
22
- const [matchingRule] = await this.findMatchingRules(normalizedWord, params);
17
+ const [matchingRule] = await this.findMatchingRules(word, params);
23
18
  if (matchingRule == null) {
24
- return normalizedWord;
19
+ return word;
25
20
  }
26
- return new DeclensionRuleInflector(matchingRule).inflect(normalizedWord, params.grammaticalCase);
21
+ return new DeclensionRuleInflector(matchingRule).inflect(word, params.grammaticalCase);
27
22
  }
28
23
  /**
29
24
  * Finds matching declension rules for the given word.