@jjlmoya/utils-audiovisual 1.8.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-audiovisual",
-    "version": "1.8.0",
+    "version": "1.10.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/i18n/id.ts

@@ -1,7 +1,7 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'audiovisual-fotografi',
+  slug: 'audiovisual-dan-fotografi',
   title: 'Alat Audiovisual dan Fotografi',
   description: 'Alat dan kalkulator profesional untuk pembuat film, fotografer, dan pembuat konten audiovisual digital.',
   seo: [

package/src/category/i18n/pt.ts

@@ -1,7 +1,7 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'audiovisual-fotografia',
+  slug: 'audiovisual-e-fotografia',
   title: 'Ferramentas Audiovisuais e Fotografia',
   description: 'Ferramentas profissionais e calculadoras para cineastas, fotógrafos e criadores de conteúdo audiovisual digital.',
   seo: [

package/src/category/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { CategoryLocaleContent } from '../../types';
 
 export const content: CategoryLocaleContent = {
-  slug: 'audiovisual-photography',
+  slug: 'audiovizualnye-i-foto-instrumenty',
   title: 'Аудиовизуальные и фото инструменты',
   description: 'Профессиональные инструменты и калькуляторы для кинематографистов, фотографов и создателей цифрового аудиовизуального контента.',
   seo: [

package/src/category/index.ts

@@ -43,3 +43,4 @@ export const audiovisualCategory: AudiovisualCategoryEntry = {
   },
 };
 
+export const toolsCategory = audiovisualCategory;

package/src/tests/category_validation.test.ts

@@ -0,0 +1,73 @@
+import { describe, it, expect } from 'vitest';
+import { audiovisualCategory } from '../data';
+import type { CategoryLocaleContent } from '../types';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
+];
+
+const sharingLocales = ['ja', 'ko', 'zh'];
+
+describe('Category Validation', () => {
+  it('should have all 15 required locales', () => {
+    const registeredLocales = Object.keys(audiovisualCategory.i18n);
+    EXPECTED_LOCALES.forEach((locale) => {
+      expect(
+        registeredLocales,
+        `Category is missing locale "${locale}"`,
+      ).toContain(locale);
+    });
+  });
+
+  describe('Category Slug Validation', () => {
+    it('every locale should have a unique, translated slug and follow format rules', async () => {
+      const slugs = new Map<string, string>();
+      const locales = Object.keys(audiovisualCategory.i18n);
+
+      let enSlug = '';
+      if (locales.includes('en')) {
+        const enLoader = audiovisualCategory.i18n['en' as keyof typeof audiovisualCategory.i18n];
+        const enContent = (await enLoader?.()) as CategoryLocaleContent;
+        enSlug = enContent.slug;
+      }
+
+      for (const locale of locales) {
+        const loader = audiovisualCategory.i18n[locale as keyof typeof audiovisualCategory.i18n];
+        const content = (await loader?.()) as CategoryLocaleContent;
+
+        expect(
+          content.slug,
+          `Category locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+        ).toMatch(/^[a-z0-9-]+$/);
+
+        expect(
+          content.slug,
+          `Category locale "${locale}" slug ("${content.slug}") cannot end with a 2-letter language code (e.g., -ja, -ru, -ko).`,
+        ).not.toMatch(/-[a-z]{2}$/);
+
+        if (locale !== 'en') {
+          if (sharingLocales.includes(locale)) {
+            expect(
+              content.slug,
+              `Category locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+            ).toBe(enSlug);
+          } else {
+            expect(
+              content.slug,
+              `Category locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propio idioma`,
+            ).not.toBe(enSlug);
+
+            if (slugs.has(content.slug)) {
+              const previousLocale = slugs.get(content.slug);
+              expect(
+                false,
+                `Category 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);
+          }
+        }
+      }
+    });
+  });
+});

package/src/tests/slug_language_code_format.test.ts

@@ -0,0 +1,24 @@
+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;
+
+          const endsWithLanguageCode = /-[a-z]{2}$/.test(content.slug) && !content.slug.endsWith('-tv') && !content.slug.endsWith('-hd');
+          expect(
+            endsWithLanguageCode,
+            `Tool "${tool.entry.id}" locale "${locale}" slug ("${content.slug}") cannot end with a 2-letter language code (e.g., -ja, -ru, -ko).`,
+          ).toBe(false);
+        }
+      });
+    });
+  });
+});

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/chromaticLens/i18n/ru.ts

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ChromaticLensUI, ChromaticLensLocaleContent } from '../index';
 
-const slug = 'chromatic-lens-color-palette-extraction-online';
+const slug = 'hromatic-linza-cvetovaya-palitra-online';
 const title = 'Chromatic Lens: онлайн извлечение цветовой палитры';
 const description = 'Извлекайте профессиональные цветовые палитры из любого изображения бесплатно. Определяйте доминирующие цвета на ваших фотографиях с помощью математических алгоритмов.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { CollageMakerUI, CollageMakerLocaleContent } from '../index';
 
-const slug = 'criar-collage-fotos-online-grátis-composições-profissionais';
+const slug = 'criar-collage-fotos-online-gratis-composicoes-profissionais';
 const title = 'Criador de Collage Online: Desenhe composições profissionais';
 const description = 'Crie colagens de fotos gratuitamente em segundos. Escolha entre vários layouts, ajuste as bordas e descarregue em alta qualidade sem marcas de água.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ImageCompressorUI, ImageCompressorLocaleContent } from '../index';
 
-const slug = 'online-bildkomprimierer-dateigroeße-ohne-qualitaetsverlust-reduzieren';
+const slug = 'online-bildkomprimierer-dateigroesse-ohne-qualitaetsverlust-reduzieren';
 const title = 'Online Bildkomprimierer: Gewicht reduzieren ohne Qualitätsverlust';
 const description = 'Optimieren und komprimieren Sie Ihre JPG-, PNG- und WebP-Fotos kostenlos. Reduzieren Sie die Dateigröße, um die Ladegeschwindigkeit Ihrer Website lokal zu verbessern.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { PrivacyBlurUI, PrivacyBlurLocaleContent } from '../index';
 
-const slug = 'online-privacy-editor-pixelate-blur-faces-photos';
+const slug = 'online-privacyeditor-pixelate-blur-faces-fotos';
 const title = 'Online Privacy Editor: Gezichten in foto\'s verpixelen en verbergen';
 const description = 'Bescherm je identiteit door gevoelige delen van je foto\'s te censureren. Verpixel gezichten, vervaag documenten of dek privé-informatie 100% lokaal af.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { PrivacyBlurUI, PrivacyBlurLocaleContent } from '../index';
 
-const slug = 'online-privacy-editor-pixelate-blur-faces-photos';
+const slug = 'edytor-prywatnosci-online-pikseluj-rozmyj-twarze-zdjecia';
 const title = 'Edytor Prywatności Online: Pikselowanie i ukrywanie twarzy na zdjęciach';
 const description = 'Chroń swoją tożsamość, cenzurując wrażliwe obszary swoich zdjęć. Pikseluj twarze, rozmywaj dokumenty lub zakrywaj prywatne informacje w 100% lokalnie.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SubtitleSyncUI, SubtitleSyncLocaleContent } from '../index';
 
-const slug = 'srt-subtitle-synchronize-online-adjust-timing-free';
+const slug = 'synchronize-srt-subtitles-online-adjust-timing-free';
 const title = 'SRT字幕オンライン同期：無料でタイミング調整';
 const description = 'SRT字幕を早めたり遅らせたりするためのオンラインツール。時間のズレを簡単に修正し、同期されたファイルをすぐにダウンロードできます。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SubtitleSyncUI, SubtitleSyncLocaleContent } from '../index';
 
-const slug = 'srt-subtitle-synchronize-online-韓国語-adjust-timing-free';
+const slug = 'synchronize-srt-subtitles-online-adjust-timing-free';
 const title = 'SRT 자막 온라인 동기화: 간편한 타이밍 조정';
 const description = 'SRT 자막의 시간을 앞당기거나 늦출 수 있는 온라인 도구입니다. 자막 싱크 오차를 쉽게 수정하고 즉시 다운로드하세요.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { SubtitleSyncUI, SubtitleSyncLocaleContent } from '../index';
 
-const slug = 'online-srt-subtitle-synchronize-adjust-timing-free';
+const slug = 'synchronize-srt-subtitles-online-adjust-timing-free';
 const title = '在线同步 SRT 字幕：免费调整时间轴';
 const description = '在线调整 SRT 字幕提前或延迟的工具。轻松纠正时间偏差并立即下载同步后的文件。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TimelapseUI, TimelapseLocaleContent } from '../index';
 
-const slug = 'timelapse-hyperlapse-calculator-intervals-japan';
+const slug = 'timelapse-hyperlapse-calculator-perfect-intervals';
 const title = 'タイムラプス・ハイパーラプス計算機：最適なインターバル設定';
 const description = '写真撮影の間隔、動画の長さ、必要なストレージ容量を正確に計算。タイムラプス撮影に欠かせないフォトグラファー用ツール。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TimelapseUI, TimelapseLocaleContent } from '../index';
 
-const slug = 'timelapse-hyperlapse-calculator-perfect-intervals-korea';
+const slug = 'timelapse-hyperlapse-calculator-perfect-intervals';
 const title = '타임랩스 및 하이퍼랩스 계산기: 완벽한 촬영 간격 설정';
 const description = '사진 촬영 간격, 총 소요 시간, 데이터 저장 용량을 정확하게 계산하세요. 사진작가를 위한 타임랩스 필수 도구입니다.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TimelapseUI, TimelapseLocaleContent } from '../index';
 
-const slug = 'timelapse-hyperlapse-calculator-intervals-china';
+const slug = 'timelapse-hyperlapse-calculator-perfect-intervals';
 const title = '延时摄影与大范围延时摄影计算器：寻找完美拍摄间隔';
 const description = '精确计算照片拍摄间隔、总时长以及拍摄所需的存储空间。摄影师必备的延时摄影工具。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TvDistanceUI, TvDistanceLocaleContent } from '../index';
 
-const slug = 'tv-viewing-distance-calculator-japan-thx-4k';
+const slug = 'tv-viewing-distance-calculator-thx-4k-optimal-screen';
 const title = 'テレビ視聴距離計算機：THX/4K最適画面設定';
 const description = 'テレビのサイズと解像度に基づいて、理想的な視聴距離を計算。THXやSMPTE規格に準拠したホームシアター構築の最適化ツール。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TvDistanceUI, TvDistanceLocaleContent } from '../index';
 
-const slug = 'tv-viewing-distance-calculator-korea-thx-4k';
+const slug = 'tv-viewing-distance-calculator-thx-4k-optimal-screen';
 const title = 'TV 시청 거리 계산기: THX 및 4K 최적 화면 설정';
 const description = 'TV 크기와 해상도에 따른 이상적인 시청 거리를 계산하세요. THX 및 SMPTE 표준을 기반으로 홈 시네마 환경을 최적화합니다.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { TvDistanceUI, TvDistanceLocaleContent } from '../index';
 
-const slug = 'tv-viewing-distance-calculator-china-thx-4k-optimal-screen';
+const slug = 'tv-viewing-distance-calculator-thx-4k-optimal-screen';
 const title = '电视观看距离计算器：THX 与 4K 最佳屏幕设置';
 const description = '根据电视尺寸和分辨率计算理想的观看距离。利用 THX 和 SMPTE 标准优化您的家庭影院体验。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { VideoFrameExtractorUI, VideoFrameExtractorLocaleContent } from '../index';
 
-const slug = 'online-video-frame-extractor-japan-hd';
+const slug = 'online-video-frame-extractor-capture-hd-stills';
 const title = 'ビデオフレーム抽出：HD静止画キャプチャ';
 const description = 'ビデオから特定の瞬間をフレーム単位で正確に抽出。HD品質の画像をブラウザ上で安全かつ無料でキャプチャできます。';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { VideoFrameExtractorUI, VideoFrameExtractorLocaleContent } from '../index';
 
-const slug = 'online-video-frame-extractor-korea-hd';
+const slug = 'online-video-frame-extractor-capture-hd-stills';
 const title = '비디오 프레임 추출기: HD 스틸 이미지 캡처';
 const description = '비디오에서 개별 이미지를 프레임 단위의 정밀도로 추출하세요. 완벽한 순간을 HD 화질로 로컬에서 무료로 안전하게 캡처합니다.';
 

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

@@ -1,7 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { VideoFrameExtractorUI, VideoFrameExtractorLocaleContent } from '../index';
 
-const slug = 'online-video-frame-extractor-china-hd-stills';
+const slug = 'online-video-frame-extractor-capture-hd-stills';
 const title = '视频帧提取器：高清静态图像捕获';
 const description = '以单帧精度从视频中提取个人图像。在本地免费捕捉高清的完美瞬间。';