@jjlmoya/utils-creative 1.8.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-creative",
-    "version": "1.8.0",
+    "version": "1.10.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/bead-pattern-generator/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { BeadPatternGeneratorLocaleContent } from '../index';
 
-const slug = 'bead-pattern-generator-ja';
+const slug = 'bead-pattern-generator';
 const title = 'パターンジェネレーター';
 const description = 'あなたの写真から、デリカビーズ（Miyuki）やアイロンビーズ（Hama）のピクセルアートや図案を作成します。減色アルゴリズム、トンネルビジョンモード、ZIPエクスポート機能を搭載。';
 

package/src/tool/bead-pattern-generator/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { BeadPatternGeneratorLocaleContent } from '../index';
 
-const slug = 'bead-pattern-generator-ko';
+const slug = 'bead-pattern-generator';
 const title = '도안 생성기';
 const description = '사진을 사용하여 미유키 또는 하마 비즈를 위한 픽셀 아트 및 도안을 만들어보세요. 색상 양자화 알고리즘, 터널 시야 모드, ZIP 내보내기 기능을 지원합니다.';
 

package/src/tool/bead-pattern-generator/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { BeadPatternGeneratorLocaleContent } from '../index';
 
-const slug = 'bead-pattern-generator-ru';
+const slug = 'generator-skhem';
 const title = 'Генератор схем';
 const description = 'Создавайте пиксель-арт и схемы для бисероплетения (Miyuki) или термомозаики (Hama) из ваших фотографий. Алгоритм квантования цветов, режим туннельного зрения и экспорт в ZIP.';
 

package/src/tool/bead-pattern-generator/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { BeadPatternGeneratorLocaleContent } from '../index';
 
-const slug = 'bead-pattern-generator-zh';
+const slug = 'bead-pattern-generator';
 const title = '串珠图案生成器';
 const description = '根据您的照片生成适用于 Miyuki（米珠）或 Hama（拼拼豆豆）的像素艺术和串珠方案。包含颜色量化算法、隧道视野模式及 ZIP 导出功能。';
 

package/src/tool/dice-roller/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { DiceRollerLocaleContent } from '../index';
 
-const slug = 'dice-roller-ja';
+const slug = 'dice-roller';
 const title = 'ダイスローラー';
 const description = 'RPGやボードゲームに最適なダイスシミュレーター。d4, d6, d8, d10, d12, d20, d100に対応し、修正値の適用や履歴の確認も可能です。';
 

package/src/tool/dice-roller/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { DiceRollerLocaleContent } from '../index';
 
-const slug = 'dice-roller-ko';
+const slug = 'dice-roller';
 const title = '주사위 굴리기';
 const description = 'RPG 및 보드게임을 위한 완벽한 주사위 시뮬레이터입니다. 수정치 및 기록 기능과 함께 d4, d6, d8, d10, d12, d20, d100을 굴려보세요.';
 

package/src/tool/dice-roller/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { DiceRollerLocaleContent } from '../index';
 
-const slug = 'dice-roller-ru';
+const slug = 'simulator-kostey';
 const title = 'Симулятор костей';
 const description = 'Полный симулятор костей для ваших RPG и настольных игр. Бросайте d4, d6, d8, d10, d12, d20 и d100 с модификаторами и историей.';
 

package/src/tool/dice-roller/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { DiceRollerLocaleContent } from '../index';
 
-const slug = 'dice-roller-zh';
+const slug = 'dice-roller';
 const title = '在线掷骰子';
 const description = '一个为您的 RPG 和桌面游戏而设计的全功能骰子模拟器。支持掷 d4、d6、d8、d10、d12、d20 和 d100，并带有修正值和历史记录功能。';
 

package/src/tool/excuse-generator/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ExcuseGeneratorLocaleContent } from '../index';
 
-const slug = 'excuse-generator-ja';
+const slug = 'excuse-generator';
 const title = '言い訳ジェネレーター';
 const description = '付き合いを華麗にスルーするためのセマンティック・ギャンブルマシン。シュールで反論の余地のない言い訳を瞬時に生成します。';
 

package/src/tool/excuse-generator/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ExcuseGeneratorLocaleContent } from '../index';
 
-const slug = 'excuse-generator-ko';
+const slug = 'excuse-generator';
 const title = '핑계 생성기';
 const description = '의무감에서 멋지게 벗어나기 위한 시맨틱 도박기입니다. 초현실적이고 반박할 수 없는 핑계를 즉시 생성하세요.';
 

package/src/tool/excuse-generator/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ExcuseGeneratorLocaleContent } from '../index';
 
-const slug = 'генератор-отговорок';
+const slug = 'generator-otgovorki';
 const title = 'Генератор отговорок';
 const description = 'Семантическая машина для стильного избавления от обязательств. Мгновенно создавайте сюрреалистичные и неопровержимые отговорки.';
 

package/src/tool/excuse-generator/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ExcuseGeneratorLocaleContent } from '../index';
 
-const slug = 'excuse-generator-zh';
+const slug = 'excuse-generator';
 const title = '借口生成器';
 const description = '语义化的随机机器，让您有格调地摆脱承诺。瞬间生成超现实且无可辩驳的借口。';
 

package/src/tool/fortune-cookie/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { FortuneCookieLocaleContent } from '../index';
 
-const slug = 'fortune-cookie-ja';
+const slug = 'fortune-cookie';
 const title = 'フォーチュンクッキー';
 const description = '一日の運勢を確認し、ラッキーナンバーを見つけましょう。一日に一回、クリックで運勢を占うことができます。';
 

package/src/tool/fortune-cookie/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { FortuneCookieLocaleContent } from '../index';
 
-const slug = 'online-fortune-cookie-ko';
+const slug = 'fortune-cookie';
 const title = '포춘 쿠키';
 const description = '오늘의 운세를 확인하고 행운의 숫자를 발견하세요. 하루에 하나의 운세를 클릭 한 번으로 확인해보세요.';
 

package/src/tool/fortune-cookie/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { FortuneCookieLocaleContent } from '../index';
 
-const slug = 'печенье-с-предсказанием-онлайн';
+const slug = 'pechenie-s-predskazaniem-online';
 const title = 'Печенье с предсказанием';
 const description = 'Узнайте свою судьбу на сегодня и получите счастливые числа. Одно предсказание в день, доступное по клику.';
 

package/src/tool/fortune-cookie/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { FortuneCookieLocaleContent } from '../index';
 
-const slug = 'fortune-cookie-zh';
+const slug = 'fortune-cookie';
 const title = '幸运饼干';
 const description = '查看您的每日运势并发现您的幸运数字。每天一个在线幸运饼干，一键开启您的预言。';
 

package/src/tool/synesthesia-painter/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SynesthesiaPainterLocaleContent } from '../index';
 
-const slug = 'synesthesia-painter-ja';
+const slug = 'synesthesia-painter';
 const title = '共感覚ペインター';
 const description = '書記素-色共感覚に基づき、文字の色を可視化します。各文字が固有の色を持ち、テキストを色彩豊かなアートへと変換します。';
 

package/src/tool/synesthesia-painter/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SynesthesiaPainterLocaleContent } from '../index';
 
-const slug = 'synesthesia-painter-ko';
+const slug = 'synesthesia-painter';
 const title = '공감각 페인터';
 const description = '음소-색 공감각에 따라 단어의 색상을 시각화합니다. 각 글자는 고유한 색상을 가지며, 텍스트를 색채 예술로 변환합니다.';
 

package/src/tool/synesthesia-painter/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SynesthesiaPainterLocaleContent } from '../index';
 
-const slug = 'художник-синестезии';
+const slug = 'khudozhnik-sinestezii';
 const title = 'Художник синестезии';
 const description = 'Визуализируйте цвет слов в соответствии с графемно-цветовой синестезией. Каждая буква имеет свой цвет, превращая текст в хроматическое искусство.';
 

package/src/tool/synesthesia-painter/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SynesthesiaPainterLocaleContent } from '../index';
 
-const slug = 'synesthesia-painter-zh';
+const slug = 'synesthesia-painter';
 const title = '联觉绘画家';
 const description = '根据“书记素-色彩联觉”可视化文字颜色。每个字母都有其专属色彩，将文本转化为色度艺术。';
 

package/src/tool/zalgo-generator/i18n/de.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-de';
+const slug = 'zalgo-textgenerator';
 const title = 'Zalgo Generator';
 const description = 'Korrumpieren Sie Ihre Nachrichten mit kaskadierenden, überlaufenden Unicode-Zeichen. Passen Sie Intensität und Richtung des Glitch-Effekts an.';
 

package/src/tool/zalgo-generator/i18n/ja.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-ja';
+const slug = 'zalgo-generator';
 const title = 'Zalgoテキスト生成器';
 const description = 'カスケード状に溢れ出すUnicode文字でメッセージを破壊します。グリッチ効果の強さと方向を調整できます。';
 

package/src/tool/zalgo-generator/i18n/ko.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-ko';
+const slug = 'zalgo-generator';
 const title = '잘고 텍스트 생성기';
 const description = '폭포수처럼 쏟아지는 유니코드 문자로 메시지를 오염시키세요. 글리치 효과의 강도와 방향을 조정할 수 있습니다.';
 

package/src/tool/zalgo-generator/i18n/nl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-nl';
+const slug = 'zalgo-tekstgenerator';
 const title = 'Zalgo generator';
 const description = 'Corrumpeer je berichten met cascade-achtige overlopende Unicode-karakters. Pas de intensiteit en richting van het glitch-effect aan.';
 

package/src/tool/zalgo-generator/i18n/pl.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'generator-zalgo';
+const slug = 'generatory-zalgo';
 const title = 'Generator Zalgo';
 const description = 'Skorumpuj swoje wiadomości kaskadowymi, przelewającymi się znakami Unicode. Dostosuj intensywność i kierunek efektu glitch.';
 

package/src/tool/zalgo-generator/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'генератор-залго';
+const slug = 'generator-zalgo';
 const title = 'Генератор Залго';
 const description = 'Искажайте свои сообщения с помощью каскадных переливающихся символов Юникода. Настройте интенсивность и направление эффекта глюка.';
 

package/src/tool/zalgo-generator/i18n/sv.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-sv';
+const slug = 'zalgo-generering';
 const title = 'Zalgo generator';
 const description = 'Korrumpera dina meddelanden med kaskadliknande överflödiga Unicode-tecken. Justera intensitet och riktning för glitch-effekten.';
 

package/src/tool/zalgo-generator/i18n/zh.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ZalgoGeneratorLocaleContent } from '../index';
 
-const slug = 'zalgo-generator-zh';
+const slug = 'zalgo-generator';
 const title = 'Zalgo 文本生成器';
 const description = '使用级联溢出的 Unicode 字符破坏您的信息。调整故障效果的强度和方向。';