@jjlmoya/utils-alcohol 1.15.0 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-alcohol",
-    "version": "1.15.0",
+    "version": "1.17.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/tests/slug_language_code_format.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Slug Language Code Format Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('slug should not end with 2-letter language codes like -ja, -ru, -ko', async () => {
+        const locales = Object.keys(tool.entry.i18n);
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+
+          expect(
+            content.slug,
+            `Tool "${tool.entry.id}" locale "${locale}" slug ("${content.slug}") cannot end with a 2-letter language code (e.g., -ja, -ru, -ko).`,
+          ).not.toMatch(/-[a-z]{2}$/);
+        }
+      });
+    });
+  });
+});

package/src/tests/slug_uniqueness.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+const sharingLocales = ['ja', 'ko', 'zh'];
+
+interface ValidateParams {
+  toolId: string;
+  locale: string;
+  content: ToolLocaleContent;
+  enSlug: string;
+  slugs: Map<string, string>;
+}
+
+const validateLocaleSlug = ({
+  toolId,
+  locale,
+  content,
+  enSlug,
+  slugs,
+}: ValidateParams) => {
+  expect(
+    content.slug,
+    `Tool "${toolId}" locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+  ).toMatch(/^[a-z0-9-]+$/);
+
+  if (locale === 'en') {
+    return;
+  }
+
+  if (sharingLocales.includes(locale)) {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+    ).toBe(enSlug);
+  } else {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propia idioma`,
+    ).not.toBe(enSlug);
+
+    if (slugs.has(content.slug)) {
+      const previousLocale = slugs.get(content.slug);
+      expect(
+        false,
+        `Tool "${toolId}" locales "${locale}" and "${previousLocale}" share the same slug ("${content.slug}"). Cada slug tiene que estar en su propia idioma`,
+      ).toBe(true);
+    }
+    slugs.set(content.slug, locale);
+  }
+};
+
+describe('Slug Localization and Uniqueness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('every locale should have a unique, translated slug', async () => {
+        const slugs = new Map<string, string>();
+        const locales = Object.keys(tool.entry.i18n);
+
+        let enSlug = '';
+        if (locales.includes('en')) {
+          const enLoader = tool.entry.i18n['en' as keyof typeof tool.entry.i18n];
+          const enContent = (await enLoader?.()) as ToolLocaleContent;
+          enSlug = enContent.slug;
+        }
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+          validateLocaleSlug({
+            toolId: tool.entry.id,
+            locale,
+            content,
+            enSlug,
+            slugs,
+          });
+        }
+      });
+    });
+  });
+});

package/src/tool/alcoholClearance/i18n/it.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
-const slug = 'alcohol-clearance-calculator';
+const slug = 'calcolatore-smaltimento-alcol';
 const title = 'Calcolatore Sbornia e BAC: Predittore di Recupero';
 const description = 'Calcola il tuo contenuto di alcol nel sangue (BAC) e il tempo per raggiungere 0.0 utilizzando la formula di Widmark. Pianifica la tua idratazione pre-sonno e saprai quando sarai completamente recuperato.';
 

package/src/tool/alcoholClearance/i18n/nl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
-const slug = 'alcohol-clearance-calculator';
+const slug = 'rekenmachine-alcoholafbraak';
 const title = 'Kater en BVO calculator: Herstelindicator';
 const description = 'Bereken uw Bloed Voorzuringsoort (BVO) en de tijd om 0,0 te bereiken met behulp van de formule van Widmark. Plan uw hydratatie vóór het slapen en weet wanneer u volledig hersteld bent.';
 

package/src/tool/alcoholClearance/i18n/tr.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { AlcoholClearanceUI, AlcoholClearanceLocaleContent } from '../index';
 
-const slug = 'alcohol-clearance-calculator';
+const slug = 'alkol-temizleme-hesaplayicisi';
 const title = 'Baş Dönmesi ve BAC Hesaplayıcısı: İyileşme Tahmincisi';
 const description = 'Widmark formülünü kullanarak Kan Alkol İçeriğini (BAC) hesapla ve 0.0 a ulaşmak için gereken zamanı öğren. Uyku öncesi rehidrasyon planla ve tam iyileşmenin ne zaman olacağını bil.';
 

package/src/tool/beerCooler/i18n/de.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'bier-kuhler';
 const title = 'Bierkühler mit Newtonsches Abkühlungsgesetz';
 const description = 'Berechne mit echter Thermodynamik — Newtonsches Abkühlungsgesetz — genau wie lange dein Bier braucht, um die perfekte Serviertemperatur im Kühlschrank oder Gefrierschrank zu erreichen.';
 

package/src/tool/beerCooler/i18n/id.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'pendingin-bir';
 const title = 'Kalkulator Pendingin Bir dengan Hukum Newton';
 const description = 'Hitung dengan termodinamika nyata — Hukum Pendinginan Newton — berapa lama tepat bir Anda memerlukan untuk mencapai suhu penyajian yang sempurna di lemari es atau freezer.';
 

package/src/tool/beerCooler/i18n/it.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'raffreddatore-birra';
 const title = 'Calcolatore di Raffreddamento della Birra con la Legge di Newton';
 const description = 'Calcola con vera termodinamica — Legge di Raffreddamento di Newton — esattamente quanto tempo hai bisogno affinché la tua birra raggiunga la temperatura di servizio perfetta in frigorifero o congelatore.';
 

package/src/tool/beerCooler/i18n/nl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'bier-koeler';
 const title = 'Bierkoelingscalculator met de Wet van Newton';
 const description = 'Bereken met echte thermodynamica — Wet van Newton voor afkoeling — precies hoe lang je bier nodig heeft om de perfecte serveertemperatuur in de koelkast of vriezer te bereiken.';
 

package/src/tool/beerCooler/i18n/pl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'chlodnica-piwa';
 const title = 'Kalkulator Chłodzenia Piwa z Prawem Chłodzenia Newtona';
 const description = 'Oblicz z prawdziwą termodynamiką — Prawo Chłodzenia Newtona — dokładnie, ile czasu twoje piwo potrzebuje, aby osiągnąć doskonałą temperaturę podawania w lodówce lub zamrażalniku.';
 

package/src/tool/beerCooler/i18n/pt.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'resfriador-cerveja';
 const title = 'Calculadora de Resfriamento de Cerveja com a Lei de Newton';
 const description = 'Calcule com termodinâmica real — Lei do Resfriamento de Newton — exatamente quanto tempo sua cerveja leva para atingir a temperatura de serviço perfeita na geladeira ou freezer.';
 

package/src/tool/beerCooler/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'ohlazhdenie-piva';
 const title = 'Калькулятор охлаждения пива с законом Ньютона';
 const description = 'Считайте с настоящей термодинамикой — Закон охлаждения Ньютона — ровно столько, сколько времени вашему пиву потребуется, чтобы достичь идеальной температуры подачи в холодильнике или морозилке.';
 

package/src/tool/beerCooler/i18n/sv.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'ol-kylare';
 const title = 'Ölkylningsräknare med Newtons kylningslag';
 const description = 'Beräkna med verklig termodynamik — Newtons kylningslag — exakt hur lång tid din öl behöver för att nå den perfekta serveringstemperaturen i kylskåp eller frys.';
 

package/src/tool/beerCooler/i18n/tr.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { BeerCoolerUI, BeerCoolerLocaleContent } from '../index';
 
-const slug = 'beer-cooler';
+const slug = 'bira-sogutucusu';
 const title = 'Newton\'un Soğuma Yasası ile Bira Soğutma Hesaplayıcısı';
 const description = 'Gerçek termodinamik ile hesaplayın — Newton\'un Soğuma Yasası — bira\'nızın buzdolabında veya dondurucuda mükemmel servis sıcaklığına ulaşması için gereken zamanı tam olarak bilin.';
 

package/src/tool/carbonationCalculator/i18n/de.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
-const slug = 'beer-carbonation-calculator';
+const slug = 'bier-karbonatisierungs-rechner';
 const title = 'Bier Karbonisierungs und Primersüße Rechner';
 const description = 'Berechne die exakte Grammmenge von Dextrose, Haushaltszucker oder Malzextrakt (DME) zum Abfüllen deines Haushaltbieres. Gib dein Volumen, Gärungstemperatur und Stil ein und perfektioniere deine Grundierung.';
 

package/src/tool/carbonationCalculator/i18n/id.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
-const slug = 'beer-carbonation-calculator';
+const slug = 'kalkulator-karbonak-bir';
 const title = 'Kalkulator Karbonasi & Primer Bir';
 const description = 'Hitung gram pasti Dextrose, Gula Meja atau DME (Ekstrak Malt Kering) untuk membotolkan homebrew Anda. Masukkan volume, suhu fermentasi, dan gaya untuk primer sempurna.';
 

package/src/tool/carbonationCalculator/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CarbonationUI, CarbonationLocaleContent } from '../index';
 
-const slug = 'beer-carbonation-calculator';
+const slug = 'kalkulyator-karbonizacii-piva';
 const title = 'Калькулятор Карбонизации и Праймирования Пива';
 const description = 'Рассчитайте точное количество граммов Декстрозы, Сахара или ССВ (Сухого Солодового Экстракта) для разлива домашнего пива. Введите объём, температуру брожения и стиль для идеального праймирования.';
 

package/src/tool/cocktailBalancer/i18n/de.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'cocktail-ausgleicher';
 const title = 'Cocktail Balancer: Das Sauer Gesetz';
 const description = 'Berechnen Sie die perfekte Balance zwischen süß und sauer für Ihre Cocktails. Meistern Sie das goldene Verhältnis der Mixologie.';
 

package/src/tool/cocktailBalancer/i18n/id.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'koktail-seimbang';
 const title = 'Cocktail Balancer: Hukum Asam';
 const description = 'Hitung keseimbangan sempurna antara manis dan asam untuk koktail Anda. Kuasai rasio emas mixologi.';
 

package/src/tool/cocktailBalancer/i18n/it.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'cocktail-equilibrato';
 const title = 'Cocktail Balancer: La Legge dell\'Acido';
 const description = 'Calcola il perfetto equilibrio tra dolce e acido per i tuoi cocktail. Padroneggia il rapporto aureo della mixologia.';
 

package/src/tool/cocktailBalancer/i18n/nl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'cocktail-evenwicht';
 const title = 'Cocktail Balancer: De Zuurwet';
 const description = 'Bereken het perfecte evenwicht tussen zoet en zuur voor je cocktails. Beheers de gulden snede van mixologie.';
 

package/src/tool/cocktailBalancer/i18n/pl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'koktajl-zbilansowany';
 const title = 'Cocktail Balancer: Prawo Kwaśności';
 const description = 'Oblicz doskonałą równowagę między słodkością a kwaśnością dla swoich koktajli. Opanuj złoty stosunek miksologii.';
 

package/src/tool/cocktailBalancer/i18n/pt.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'coquetel-equilibrado';
 const title = 'Cocktail Balancer: A Lei do Ácido';
 const description = 'Calcule o equilíbrio perfeito entre doce e ácido para seus coquetéis. Domine a proporção áurea da mixologia.';
 

package/src/tool/cocktailBalancer/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'koktejl-balansirovka';
 const title = 'Балансир Коктейлей: Закон Кислоты';
 const description = 'Вычислите идеальный баланс между сладким и кислым для ваших коктейлей. Овладейте золотым сечением миксологии.';
 

package/src/tool/cocktailBalancer/i18n/sv.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'cocktail-balanserare';
 const title = 'Cocktail Balancer: Surlagenen';
 const description = 'Beräkna den perfekta balansen mellan sött och surt för dina cocktails. Bemästra det gyllene snittet inom mixologi.';
 

package/src/tool/cocktailBalancer/i18n/tr.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { CocktailBalancerUI, CocktailBalancerLocaleContent } from '../index';
 
-const slug = 'cocktail-balancer';
+const slug = 'kokteyl-dengeleyici';
 const title = 'Cocktail Balancer: Asitlik Kanunu';
 const description = 'Koktailleriniz için tatlı ve asit arasındaki mükemmel dengeyi hesaplayın. Miksoloji\'nin altın oranını keşfedin.';
 

package/src/tool/partyKeg/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'pati-biru-hyouka-keisanki';
+const slug = 'party-stock-calculator';
 const title = 'パーティービール計算機：結婚式と誕生日のための1人あたりの量';
 const description = 'ゲスト数、期間、気温に基づいて必要なビールと氷の量を計算する無料ツール。結婚式、誕生日、屋外イベントに最適です。';
 

package/src/tool/partyKeg/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'dangshin-ui-pati-maekju-gyesan-gi';
+const slug = 'party-stock-calculator';
 const title = '파티 맥주 계산기: 결혼식 및 생일을위한 1인당 수량';
 const description = '손님, 기간 및 온도에 따라 필요한 맥주와 얼음의 양을 계산하는 무료 도구입니다. 결혼식, 생일 및 야외 행사에 완벽합니다.';
 

package/src/tool/partyKeg/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'kalkulyator-piva-льда-vecherinki';
+const slug = 'kalkulyator-zapasa-pivy';
 const title = 'Калькулятор Пива для Вечеринки: Количество На Человека для Свадеб и Дней Рождения';
 const description = 'Бесплатный инструмент для расчёта количества пива и льда в зависимости от числа гостей, продолжительности и температуры. Идеален для свадеб, дней рождения и уличных мероприятий.';
 

package/src/tool/partyKeg/i18n/tr.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'party-stock-calculator';
+const slug = 'parti-birrasi-hesaplayicisi';
 const title = 'Parti Bira Hesaplayıcısı: Düğünler ve Doğum Günleri için Kişi Başına Miktar';
 const description = 'Konuk sayısı, süre ve sıcaklığa dayalı olarak ne kadar bira ve buz gerektiğini hesaplamak için ücretsiz araç. Düğünler, doğum günleri ve açık hava etkinlikleri için mükemmel.';
 

package/src/tool/partyKeg/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import type { PartyKegUI, PartyKegLocaleContent } from '../index';
 
-const slug = 'paidui-pijiu-bing-jisuanqi';
+const slug = 'party-stock-calculator';
 const title = '派对啤酒计算器：婚礼和生日派对的人均用量';
 const description = '根据嘉宾数量、活动时长和温度计算所需啤酒和冰块数量的免费工具。非常适合婚礼、生日派对和户外活动。';