lyric-romanizer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Weng
+
+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.

package/README.md

@@ -0,0 +1,70 @@
+# lyric-romanizer
+
+Script detection and local romanization engine for lyrics. Supports Japanese, Chinese, Korean, Cyrillic, Indic scripts (Devanagari, Gujarati, Gurmukhi, Telugu, Kannada, Odia), Tamil, Thai, and Latin.
+
+Extracted from [Spotify Karaoke](https://github.com/haroldalan/spotify-karaoke).
+
+## Install
+
+```bash
+npm install lyric-romanizer
+```
+
+## API
+
+```ts
+import {
+  createRomanizer,
+  detectScript,
+  isLatinScript,
+  requiresExternalRomanization,
+} from 'lyric-romanizer';
+
+// Subpath import for detector only
+import { detectScript } from 'lyric-romanizer/detector';
+```
+
+### `detectScript(lines: readonly string[]): ScriptType`
+
+Detects the dominant script in the given lines. Returns one of: `japanese`, `chinese`, `korean`, `cyrillic`, `devanagari`, `gujarati`, `gurmukhi`, `telugu`, `kannada`, `odia`, `tamil`, `malayalam`, `bengali`, `arabic`, `hebrew`, `thai`, `latin`, `other`.
+
+### `isLatinScript(lines: readonly string[]): boolean`
+
+Fast check for whether the text is Latin-only (no non-Latin characters).
+
+### `requiresExternalRomanization(script: ScriptType): boolean`
+
+Returns `true` for scripts that cannot be romanized locally (`malayalam`, `bengali`, `arabic`, `hebrew`, `other`).
+
+### `createRomanizer(options?: { japaneseDictPath?: string }): Romanizer`
+
+Creates a romanizer instance. The optional `japaneseDictPath` overrides the default [Kuromoji](https://github.com/takuyaa/kuromoji.js) dictionary CDN path.
+
+### `Romanizer.romanizeLine(line: string, options?: { script?: ScriptType }): Promise<string>`
+
+Romanizes a single line. If `script` is omitted, it is auto-detected.
+
+### `Romanizer.romanizeLines(lines: readonly string[], options?: { script?: ScriptType }): Promise<{ script: ScriptType, lines: string[] }>`
+
+Romanizes multiple lines at once.
+
+## Supported Local Scripts
+
+| Script | Library |
+|--------|---------|
+| Japanese | [@sglkc/kuroshiro](https://github.com/sglkc/kuroshiro-ts) + [kuromoji](https://github.com/takuyaa/kuromoji.js) |
+| Chinese | [pinyin-pro](https://github.com/zh-lx/pinyin-pro) |
+| Korean | [@romanize/korean](https://github.com/kntng/romanize) |
+| Cyrillic (Russian/Ukrainian) | [cyrillic-to-translit-js](https://github.com/greybax/CyrillicToTranslitJS) |
+| Devanagari, Gujarati, Gurmukhi, Telugu, Kannada, Odia | [@indic-transliteration/sanscript](https://github.com/indic-transliteration/sanscript.js) |
+| Tamil | [tamil-romanizer](https://github.com/haroldalan/tamil-romanizer) |
+| Thai | [@dehoist/romanize-thai](https://github.com/Dehoist/Open-Source) |
+| Latin | no-op (returned as-is) |
+
+## External Romanization Scripts
+
+`malayalam`, `bengali`, `arabic`, `hebrew`, and `other` are marked as external. Use `requiresExternalRomanization(script)` to branch to an API-based romanizer. Calling `romanizeLine`/`romanizeLines` for these throws `UnsupportedRomanizationError`.
+
+## License
+
+MIT

package/dist/detector.d.ts

@@ -0,0 +1,5 @@
+import type { ScriptType } from './types.js';
+export declare const NON_LATIN_SCRIPT_RE: RegExp;
+export declare function isLatinScript(lines: readonly string[]): boolean;
+export declare function detectScript(lines: readonly string[]): ScriptType;
+//# sourceMappingURL=detector.d.ts.map

package/dist/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwB7C,eAAO,MAAM,mBAAmB,QAC8E,CAAC;AAE/G,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAG/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAcjE"}

package/dist/detector.js

@@ -0,0 +1,41 @@
+const LETTER_RE = /\p{L}/u;
+const SCRIPT_SCORES = [
+    ['chinese', /[\u4E00-\u9FFF]/g],
+    ['korean', /[\uAC00-\uD7AF]/g],
+    ['cyrillic', /[\u0400-\u04FF]/g],
+    ['devanagari', /[\u0900-\u097F]/g],
+    ['gujarati', /[\u0A80-\u0AFF]/g],
+    ['gurmukhi', /[\u0A00-\u0A7F]/g],
+    ['telugu', /[\u0C00-\u0C7F]/g],
+    ['kannada', /[\u0C80-\u0CFF]/g],
+    ['odia', /[\u0B00-\u0B7F]/g],
+    ['tamil', /[\u0B80-\u0BFF]/g],
+    ['malayalam', /[\u0D00-\u0D7F]/g],
+    ['bengali', /[\u0980-\u09FF]/g],
+    ['arabic', /[\u0600-\u06FF]/g],
+    ['hebrew', /[\u0590-\u05FF]/g],
+    ['thai', /[\u0E00-\u0E7F]/g],
+];
+// Keep this range aligned with extension content script behavior for the
+// "latin fast path" check used during mode switching.
+export const NON_LATIN_SCRIPT_RE = /[\u3040-\u30FF\u4E00-\u9FFF\uAC00-\uD7AF\u0400-\u04FF\u0900-\u0D7F\u0600-\u06FF\u0590-\u05FF\u0E00-\u0E7F]/;
+export function isLatinScript(lines) {
+    const text = lines.join('');
+    return !NON_LATIN_SCRIPT_RE.test(text) && LETTER_RE.test(text);
+}
+export function detectScript(lines) {
+    const text = lines.join('');
+    // Japanese: any kana is definitive and must be checked before CJK scoring.
+    if (/[\u3040-\u30FF]/.test(text))
+        return 'japanese';
+    let best = ['other', 0];
+    for (const [script, pattern] of SCRIPT_SCORES) {
+        const score = (text.match(pattern) ?? []).length;
+        if (score > best[1])
+            best = [script, score];
+    }
+    if (best[1] > 0)
+        return best[0];
+    return LETTER_RE.test(text) ? 'latin' : 'other';
+}
+//# sourceMappingURL=detector.js.map

package/dist/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../src/detector.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,QAAQ,CAAC;AAE3B,MAAM,aAAa,GAAyC;IAC1D,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAC/B,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAChC,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAClC,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAChC,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAChC,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAC/B,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAC5B,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAC7B,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACjC,CAAC,SAAS,EAAE,kBAAkB,CAAC;IAC/B,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,MAAM,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEF,yEAAyE;AACzE,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAC9B,4GAA4G,CAAC;AAE/G,MAAM,UAAU,aAAa,CAAC,KAAwB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE5B,2EAA2E;IAC3E,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAEpD,IAAI,IAAI,GAAkC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACvD,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACjD,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;YAAE,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { detectScript, isLatinScript, NON_LATIN_SCRIPT_RE } from './detector.js';
+export { createRomanizer, requiresExternalRomanization } from './romanizer.js';
+export { UnsupportedRomanizationError, type RomanizeOptions, type RomanizeResult, type Romanizer, type RomanizerOptions, type ScriptType, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,4BAA4B,EAC5B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { detectScript, isLatinScript, NON_LATIN_SCRIPT_RE } from './detector.js';
+export { createRomanizer, requiresExternalRomanization } from './romanizer.js';
+export { UnsupportedRomanizationError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EACL,4BAA4B,GAM7B,MAAM,YAAY,CAAC"}

package/dist/romanizer.d.ts

@@ -0,0 +1,4 @@
+import type { Romanizer, RomanizerOptions, ScriptType } from './types.js';
+export declare function requiresExternalRomanization(script: ScriptType): boolean;
+export declare function createRomanizer(options?: RomanizerOptions): Romanizer;
+//# sourceMappingURL=romanizer.d.ts.map

package/dist/romanizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"romanizer.d.ts","sourceRoot":"","sources":["../src/romanizer.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGV,SAAS,EACT,gBAAgB,EAChB,UAAU,EACX,MAAM,YAAY,CAAC;AAwBpB,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAExE;AAsFD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAErE"}

package/dist/romanizer.js

@@ -0,0 +1,112 @@
+import Kuroshiro from '@sglkc/kuroshiro';
+import KuromojiAnalyzer from '@sglkc/kuroshiro-analyzer-kuromoji';
+import { pinyin } from 'pinyin-pro';
+import CyrillicToTranslit from 'cyrillic-to-translit-js';
+import Sanscript from '@indic-transliteration/sanscript';
+import { romanize as romanizeKorean } from '@romanize/korean';
+import romanizeThai from '@dehoist/romanize-thai';
+import { romanize as romanizeTamil } from 'tamil-romanizer';
+import { detectScript } from './detector.js';
+import { UnsupportedRomanizationError } from './types.js';
+const DEFAULT_JAPANESE_DICT_PATH = 'https://cdn.jsdelivr.net/npm/kuromoji/dict';
+const EXTERNAL_ROMANIZATION_SCRIPTS = new Set([
+    'malayalam',
+    'bengali',
+    'arabic',
+    'hebrew',
+    'other',
+]);
+const cyrillicTranslitRu = CyrillicToTranslit({ preset: 'ru' });
+const cyrillicTranslitUk = CyrillicToTranslit({ preset: 'uk' });
+const SANSCRIPT_SCHEME = {
+    devanagari: 'devanagari',
+    gujarati: 'gujarati',
+    gurmukhi: 'gurmukhi',
+    telugu: 'telugu',
+    kannada: 'kannada',
+    odia: 'oriya',
+};
+export function requiresExternalRomanization(script) {
+    return EXTERNAL_ROMANIZATION_SCRIPTS.has(script);
+}
+class DefaultRomanizer {
+    japaneseDictPath;
+    kuroshiroReady = null;
+    constructor(options) {
+        this.japaneseDictPath = options?.japaneseDictPath ?? DEFAULT_JAPANESE_DICT_PATH;
+    }
+    async romanizeLine(line, options) {
+        if (!line.trim() || !/\p{L}/u.test(line))
+            return line;
+        const script = options?.script ?? detectScript([line]);
+        if (script === 'latin')
+            return line;
+        if (requiresExternalRomanization(script)) {
+            throw new UnsupportedRomanizationError(script);
+        }
+        switch (script) {
+            case 'japanese': {
+                const k = await this.getKuroshiro();
+                return k.convert(line, { to: 'romaji', mode: 'spaced' });
+            }
+            case 'chinese':
+                return pinyin(line, { toneType: 'symbol', type: 'string' });
+            case 'korean':
+                return romanizeKorean(line);
+            case 'cyrillic':
+                return /[іїєґ]/i.test(line)
+                    ? cyrillicTranslitUk.transform(line)
+                    : cyrillicTranslitRu.transform(line);
+            case 'devanagari':
+            case 'gujarati':
+            case 'gurmukhi':
+            case 'telugu':
+            case 'kannada':
+            case 'odia': {
+                const scheme = SANSCRIPT_SCHEME[script];
+                if (!scheme)
+                    throw new Error(`Missing Sanscript scheme mapping for '${script}'.`);
+                if (!Sanscript.schemes?.[scheme]) {
+                    throw new Error(`Sanscript does not support scheme '${scheme}' for '${script}'.`);
+                }
+                return Sanscript.t(line, scheme, 'iast');
+            }
+            case 'tamil':
+                return romanizeTamil(line);
+            case 'thai':
+                return romanizeThai(line);
+            default:
+                throw new UnsupportedRomanizationError(script);
+        }
+    }
+    async romanizeLines(lines, options) {
+        const script = options?.script ?? detectScript(lines);
+        if (requiresExternalRomanization(script)) {
+            throw new UnsupportedRomanizationError(script);
+        }
+        if (script === 'latin') {
+            return { script, lines: [...lines] };
+        }
+        const romanized = await Promise.all(lines.map((line) => this.romanizeLine(line, { script })));
+        return { script, lines: romanized };
+    }
+    async getKuroshiro() {
+        if (!this.kuroshiroReady) {
+            this.kuroshiroReady = (async () => {
+                const instance = new Kuroshiro();
+                await instance.init(new KuromojiAnalyzer({
+                    dictPath: this.japaneseDictPath,
+                }));
+                return instance;
+            })().catch((error) => {
+                this.kuroshiroReady = null;
+                throw error;
+            });
+        }
+        return this.kuroshiroReady;
+    }
+}
+export function createRomanizer(options) {
+    return new DefaultRomanizer(options);
+}
+//# sourceMappingURL=romanizer.js.map

package/dist/romanizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"romanizer.js","sourceRoot":"","sources":["../src/romanizer.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+export type ScriptType = 'japanese' | 'chinese' | 'korean' | 'cyrillic' | 'devanagari' | 'gujarati' | 'gurmukhi' | 'telugu' | 'kannada' | 'odia' | 'tamil' | 'malayalam' | 'bengali' | 'arabic' | 'hebrew' | 'thai' | 'latin' | 'other';
+export type RomanizerOptions = {
+    japaneseDictPath?: string;
+};
+export type RomanizeOptions = {
+    script?: ScriptType;
+};
+export type RomanizeResult = {
+    script: ScriptType;
+    lines: string[];
+};
+export interface Romanizer {
+    romanizeLine(line: string, options?: RomanizeOptions): Promise<string>;
+    romanizeLines(lines: readonly string[], options?: RomanizeOptions): Promise<RomanizeResult>;
+}
+export declare class UnsupportedRomanizationError extends Error {
+    readonly script: ScriptType;
+    constructor(script: ScriptType);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,SAAS,GACT,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,UAAU,GACV,UAAU,GACV,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7F;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,MAAM,EAAE,UAAU,CAAC;gBAEvB,MAAM,EAAE,UAAU;CAK/B"}

package/dist/types.js

@@ -0,0 +1,9 @@
+export class UnsupportedRomanizationError extends Error {
+    script;
+    constructor(script) {
+        super(`Script '${script}' requires external romanization.`);
+        this.name = 'UnsupportedRomanizationError';
+        this.script = script;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsCA,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrC,MAAM,CAAa;IAEnC,YAAY,MAAkB;QAC5B,KAAK,CAAC,WAAW,MAAM,mCAAmC,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "lyric-romanizer",
+  "version": "0.1.0",
+  "description": "Script detection and local romanization engine for lyrics — supports Japanese, Chinese, Korean, Cyrillic, Indic scripts, Tamil, Thai, and more",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./detector": {
+      "types": "./dist/detector.d.ts",
+      "import": "./dist/detector.js",
+      "default": "./dist/detector.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@dehoist/romanize-thai": "^1.0.0",
+    "@indic-transliteration/sanscript": "^1.3.3",
+    "@romanize/korean": "^0.1.3",
+    "@sglkc/kuroshiro": "^1.0.1",
+    "@sglkc/kuroshiro-analyzer-kuromoji": "^1.0.1",
+    "cyrillic-to-translit-js": "^3.2.1",
+    "pinyin-pro": "^3.28.0",
+    "tamil-romanizer": "^1.0.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "romanization",
+    "romanize",
+    "lyrics",
+    "pinyin",
+    "kuroshiro",
+    "korean",
+    "cyrillic",
+    "tamil",
+    "thai",
+    "devanagari",
+    "transliteration",
+    "script-detection"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thedavidweng/lyric-romanizer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thedavidweng/lyric-romanizer/issues"
+  },
+  "homepage": "https://github.com/thedavidweng/lyric-romanizer#readme"
+}