volleyballsimtypes 0.0.374 → 0.0.375

package/dist/cjs/src/service/utils/faker-generators.d.ts

@@ -17,6 +17,14 @@ interface FakerLike {
         boolean: () => boolean;
     };
 }
+/**
+ * Romanize a name to the Latin alphabet so it is readable regardless of the source script.
+ * Already-Latin names (including accented ones like "José" or "Müller") are returned unchanged;
+ * non-Latin scripts (Japanese, Arabic, Cyrillic, Greek, Thai, Korean, ...) are transliterated and
+ * re-cased word-by-word. Note: CJK kanji transliterate to Chinese-style readings (readable but not
+ * the exact native reading).
+ */
+export declare function romanize(s: string): string;
 export declare function generateGenericTeamNames(locales: string[], amount: number): string[];
 export declare function generatePlayerName(locales: string[], amount: number): Array<{
     first: string;

package/dist/cjs/src/service/utils/faker-generators.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFakerInstance = getFakerInstance;
+exports.romanize = romanize;
 exports.generateGenericTeamNames = generateGenericTeamNames;
 exports.generatePlayerName = generatePlayerName;
 const faker_1 = require("@faker-js/faker");
+const transliteration_1 = require("transliteration");
 function isFakerKey(k) {
     return k in faker_1.allFakers;
 }
@@ -27,6 +29,24 @@ function clean(s) {
 function capitalize(s) {
     return s.charAt(0).toUpperCase() + s.slice(1);
 }
+// Latin letters (incl. accents), digits, spaces, and common name punctuation.
+const LATIN_NAME = /^[\p{Script=Latin}0-9\s'.-]+$/u;
+/**
+ * Romanize a name to the Latin alphabet so it is readable regardless of the source script.
+ * Already-Latin names (including accented ones like "José" or "Müller") are returned unchanged;
+ * non-Latin scripts (Japanese, Arabic, Cyrillic, Greek, Thai, Korean, ...) are transliterated and
+ * re-cased word-by-word. Note: CJK kanji transliterate to Chinese-style readings (readable but not
+ * the exact native reading).
+ */
+function romanize(s) {
+    if (s.length === 0 || LATIN_NAME.test(s))
+        return s;
+    return (0, transliteration_1.transliterate)(s)
+        .split(/\s+/)
+        .filter(part => part.length > 0)
+        .map(part => capitalize(part.toLowerCase()))
+        .join(' ');
+}
 function nonEmpty(s) {
     return s != null && s.length > 0 ? s : undefined;
 }
@@ -37,12 +57,12 @@ function generateTeamName(faker) {
             nonEmpty(faker.location.county?.()) ??
             faker.word.noun();
         const mascot = capitalize(faker.word.noun());
-        return clean(`${city} ${mascot}`);
+        return clean(romanize(`${city} ${mascot}`));
     }
     else {
         const adjective = capitalize(faker.word.adjective());
         const noun = capitalize(faker.word.noun());
-        return clean(`${adjective} ${noun}`);
+        return clean(romanize(`${adjective} ${noun}`));
     }
 }
 const MAX_LAST_NAME_LENGTH = 16;
@@ -72,10 +92,10 @@ function generatePlayerName(locales, amount) {
         return [];
     const faker = getFakerInstance(locales);
     return Array.from({ length: amount }, () => {
-        const first = clean(faker.person.firstName());
-        let last = clean(faker.person.lastName());
+        const first = clean(romanize(faker.person.firstName()));
+        let last = clean(romanize(faker.person.lastName()));
         while (last.length > MAX_LAST_NAME_LENGTH) {
-            last = clean(faker.person.lastName());
+            last = clean(romanize(faker.person.lastName()));
         }
         return { first, last };
     });

package/dist/esm/src/service/utils/faker-generators.d.ts

@@ -17,6 +17,14 @@ interface FakerLike {
         boolean: () => boolean;
     };
 }
+/**
+ * Romanize a name to the Latin alphabet so it is readable regardless of the source script.
+ * Already-Latin names (including accented ones like "José" or "Müller") are returned unchanged;
+ * non-Latin scripts (Japanese, Arabic, Cyrillic, Greek, Thai, Korean, ...) are transliterated and
+ * re-cased word-by-word. Note: CJK kanji transliterate to Chinese-style readings (readable but not
+ * the exact native reading).
+ */
+export declare function romanize(s: string): string;
 export declare function generateGenericTeamNames(locales: string[], amount: number): string[];
 export declare function generatePlayerName(locales: string[], amount: number): Array<{
     first: string;

package/dist/esm/src/service/utils/faker-generators.js

@@ -1,4 +1,5 @@
 import { allFakers, faker as FakerModule } from '@faker-js/faker';
+import { transliterate } from 'transliteration';
 function isFakerKey(k) {
     return k in allFakers;
 }
@@ -22,6 +23,24 @@ function clean(s) {
 function capitalize(s) {
     return s.charAt(0).toUpperCase() + s.slice(1);
 }
+// Latin letters (incl. accents), digits, spaces, and common name punctuation.
+const LATIN_NAME = /^[\p{Script=Latin}0-9\s'.-]+$/u;
+/**
+ * Romanize a name to the Latin alphabet so it is readable regardless of the source script.
+ * Already-Latin names (including accented ones like "José" or "Müller") are returned unchanged;
+ * non-Latin scripts (Japanese, Arabic, Cyrillic, Greek, Thai, Korean, ...) are transliterated and
+ * re-cased word-by-word. Note: CJK kanji transliterate to Chinese-style readings (readable but not
+ * the exact native reading).
+ */
+export function romanize(s) {
+    if (s.length === 0 || LATIN_NAME.test(s))
+        return s;
+    return transliterate(s)
+        .split(/\s+/)
+        .filter(part => part.length > 0)
+        .map(part => capitalize(part.toLowerCase()))
+        .join(' ');
+}
 function nonEmpty(s) {
     return s != null && s.length > 0 ? s : undefined;
 }
@@ -32,12 +51,12 @@ function generateTeamName(faker) {
             nonEmpty(faker.location.county?.()) ??
             faker.word.noun();
         const mascot = capitalize(faker.word.noun());
-        return clean(`${city} ${mascot}`);
+        return clean(romanize(`${city} ${mascot}`));
     }
     else {
         const adjective = capitalize(faker.word.adjective());
         const noun = capitalize(faker.word.noun());
-        return clean(`${adjective} ${noun}`);
+        return clean(romanize(`${adjective} ${noun}`));
     }
 }
 const MAX_LAST_NAME_LENGTH = 16;
@@ -67,10 +86,10 @@ export function generatePlayerName(locales, amount) {
         return [];
     const faker = getFakerInstance(locales);
     return Array.from({ length: amount }, () => {
-        const first = clean(faker.person.firstName());
-        let last = clean(faker.person.lastName());
+        const first = clean(romanize(faker.person.firstName()));
+        let last = clean(romanize(faker.person.lastName()));
         while (last.length > MAX_LAST_NAME_LENGTH) {
-            last = clean(faker.person.lastName());
+            last = clean(romanize(faker.person.lastName()));
         }
         return { first, last };
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.374",
+  "version": "0.0.375",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -94,6 +94,7 @@
     "lz-string": "^1.5.0",
     "msgpackr": "^1.11.9",
     "pino": "^9.9.0",
+    "transliteration": "^2.3.5",
     "uuid": "^9.0.0",
     "zod": "^4.3.6"
   },