@jjlmoya/utils-shared 1.0.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-shared",
-    "version": "1.0.2",
+    "version": "1.2.0",
     "description": "Shared SEO primitives and UI components for jjlmoya ecosystem",
     "author": "jjlmoya",
     "license": "MIT",
@@ -32,7 +32,12 @@
         "lint": "eslint src --ext .ts,.astro",
         "lint:css": "stylelint \"src/**/*.{astro,css}\"",
         "lint:all": "npm run check && npm run lint && npm run lint:css",
-        "prepublishOnly": "npm run lint:all"
+        "prepublishOnly": "npm run lint:all",
+        "preversion": "npm run lint:all",
+        "postversion": "git push && git push --tags",
+        "patch": "npm version patch",
+        "minor": "npm version minor",
+        "major": "npm version major"
     },
     "peerDependencies": {
         "@iconify-json/mdi": "^1.0.0",

package/src/i18n.translations.ts

@@ -0,0 +1,30 @@
+import type { Language } from "./i18n";
+
+export type TranslationKeys = {
+	bibliographicReferences: string;
+	faq: string;
+	pros: string;
+	cons: string;
+	diagWarning: string;
+	diagError: string;
+	diagInfo: string;
+	diagSuccess: string;
+};
+
+export const translations: Record<Language, TranslationKeys> = {
+	es: { bibliographicReferences: "Referencias Bibliográficas", faq: "Preguntas Frecuentes", pros: "Ventajas", cons: "Desventajas", diagWarning: "Advertencia", diagError: "Problema crítico", diagInfo: "A tener en cuenta", diagSuccess: "Buena práctica" },
+	en: { bibliographicReferences: "Bibliographic References", faq: "Frequently Asked Questions", pros: "Advantages", cons: "Disadvantages", diagWarning: "Warning", diagError: "Critical issue", diagInfo: "Worth noting", diagSuccess: "Best practice" },
+	fr: { bibliographicReferences: "Références Bibliographiques", faq: "Questions Fréquemment Posées", pros: "Avantages", cons: "Inconvénients", diagWarning: "Avertissement", diagError: "Problème critique", diagInfo: "À noter", diagSuccess: "Bonne pratique" },
+	nl: { bibliographicReferences: "Bibliografische Referenties", faq: "Veelgestelde Vragen", pros: "Voordelen", cons: "Nadelen", diagWarning: "Waarschuwing", diagError: "Kritiek probleem", diagInfo: "Let op", diagSuccess: "Best practice" },
+	de: { bibliographicReferences: "Bibliographische Referenzen", faq: "Häufig Gestellte Fragen", pros: "Vorteile", cons: "Nachteile", diagWarning: "Warnung", diagError: "Kritisches Problem", diagInfo: "Zu beachten", diagSuccess: "Bewährte Methode" },
+	it: { bibliographicReferences: "Riferimenti Bibliografici", faq: "Domande Frequenti", pros: "Vantaggi", cons: "Svantaggi", diagWarning: "Avviso", diagError: "Problema critico", diagInfo: "Da tenere a mente", diagSuccess: "Buona pratica" },
+	pt: { bibliographicReferences: "Referências Bibliográficas", faq: "Perguntas Frequentes", pros: "Vantagens", cons: "Desvantagens", diagWarning: "Aviso", diagError: "Problema crítico", diagInfo: "A ter em conta", diagSuccess: "Boa prática" },
+	ja: { bibliographicReferences: "参考文献", faq: "よくある質問", pros: "メリット", cons: "デメリット", diagWarning: "警告", diagError: "重大な問題", diagInfo: "注意事項", diagSuccess: "ベストプラクティス" },
+	zh: { bibliographicReferences: "参考文献", faq: "常见问题", pros: "优点", cons: "缺点", diagWarning: "警告", diagError: "严重问题", diagInfo: "注意事项", diagSuccess: "最佳实践" },
+	ko: { bibliographicReferences: "참고 문헌", faq: "자주 묻는 질문", pros: "장점", cons: "단점", diagWarning: "경고", diagError: "심각한 문제", diagInfo: "참고 사항", diagSuccess: "모범 사례" },
+	ru: { bibliographicReferences: "Библиографические ссылки", faq: "Часто задаваемые вопросы", pros: "Преимущества", cons: "Недостатки", diagWarning: "Предупреждение", diagError: "Критическая проблема", diagInfo: "Важно учесть", diagSuccess: "Хорошая практика" },
+	pl: { bibliographicReferences: "Referencje Bibliograficzne", faq: "Najczęściej Zadawane Pytania", pros: "Zalety", cons: "Wady", diagWarning: "Ostrzeżenie", diagError: "Krytyczny problem", diagInfo: "Warto wiedzieć", diagSuccess: "Dobra praktyka" },
+	tr: { bibliographicReferences: "Bibliyografik Referanslar", faq: "Sıkça Sorulan Sorular", pros: "Avantajlar", cons: "Dezavantajlar", diagWarning: "Uyarı", diagError: "Kritik sorun", diagInfo: "Dikkat edilmesi gereken", diagSuccess: "En iyi uygulama" },
+	sv: { bibliographicReferences: "Bibliografiska Referenser", faq: "Vanliga Frågor", pros: "Fördelar", cons: "Nackdelar", diagWarning: "Varning", diagError: "Kritiskt problem", diagInfo: "Värt att notera", diagSuccess: "Bästa praxis" },
+	hi: { bibliographicReferences: "ग्रंथ सूची संदर्भ", faq: "अक्सर पूछे जाने वाले प्रश्न", pros: "फायदे", cons: "नुकसान", diagWarning: "चेतावनी", diagError: "गंभीर समस्या", diagInfo: "ध्यान देने योग्य", diagSuccess: "सर्वोत्तम अभ्यास" },
+};

package/src/i18n.ts

@@ -0,0 +1,41 @@
+import { translations } from "./i18n.translations";
+
+export { translations };
+export type { TranslationKeys } from "./i18n.translations";
+
+export const languages = {
+	es: "Español",
+	en: "English",
+	fr: "Français",
+	nl: "Nederlands",
+	de: "Deutsch",
+	it: "Italiano",
+	pt: "Português",
+	ja: "日本語",
+	zh: "中文",
+	ko: "한국어",
+	ru: "Русский",
+	pl: "Polski",
+	tr: "Türkçe",
+	sv: "Svenska",
+	hi: "हिन्दी",
+} as const;
+
+export type Language = keyof typeof languages;
+
+export const defaultLanguage: Language = "es";
+
+export const getLanguageFromUrl = (url: URL | string): Language => {
+	const pathname = typeof url === "string" ? url : url.pathname;
+	const firstSegment = pathname.split("/").filter(Boolean)[0];
+
+	if (firstSegment && firstSegment in languages) {
+		return firstSegment as Language;
+	}
+
+	return defaultLanguage;
+};
+
+export const getTranslation = (language: Language, key: keyof (typeof translations)[Language]): string => {
+	return translations[language]?.[key] || translations[defaultLanguage][key];
+};

package/src/index.ts

@@ -22,3 +22,4 @@ export { default as UtilityHeader } from './ui/UtilityHeader.astro';
 export { default as UtilityStructuredData } from './ui/UtilityStructuredData.astro';
 
 export * from './types/index';
+export * from './i18n';

package/src/seo/SEODiagnostic.astro

@@ -1,5 +1,6 @@
 ---
 import { Icon } from "astro-icon/components";
+import { getLanguageFromUrl, getTranslation } from "../i18n";
 
 interface Props {
     title: string;
@@ -10,14 +11,16 @@ interface Props {
 
 const { title, icon, type = "info", badge } = Astro.props;
 
+const language = getLanguageFromUrl(Astro.url);
+
 const typeConfig = {
-    warning: { color: "var(--color-warning)", badgeText: badge ?? "Advertencia" },
-    error:   { color: "var(--color-error)", badgeText: badge ?? "Problema crítico" },
-    info:    { color: "var(--color-info)", badgeText: badge ?? "A tener en cuenta" },
-    success: { color: "var(--color-success)", badgeText: badge ?? "Buena práctica" },
-} as const;
+    warning: { color: "var(--color-warning)", badgeText: badge ?? getTranslation(language, "diagWarning") },
+    error:   { color: "var(--color-error)",   badgeText: badge ?? getTranslation(language, "diagError") },
+    info:    { color: "var(--color-info)",     badgeText: badge ?? getTranslation(language, "diagInfo") },
+    success: { color: "var(--color-success)",  badgeText: badge ?? getTranslation(language, "diagSuccess") },
+};
 
-const cfg = typeConfig[type as keyof typeof typeConfig];
+const cfg = typeConfig[type];
 ---
 
 <div class={`seo-diagnostic is-${type}`}>

package/src/seo/SEOProsCons.astro

@@ -1,5 +1,6 @@
 ---
 import { Icon } from "astro-icon/components";
+import { getLanguageFromUrl, getTranslation } from "../i18n";
 
 interface ProsConsItem {
     pro: string;
@@ -9,11 +10,13 @@ interface ProsConsItem {
 interface Props {
     title?: string | undefined;
     items: ProsConsItem[];
-    proTitle?: string | undefined;
-    conTitle?: string | undefined;
 }
 
-const { title, items, proTitle = "Ventajas", conTitle = "Desventajas" } = Astro.props;
+const { title, items } = Astro.props;
+
+const language = getLanguageFromUrl(Astro.url);
+const proTitle = getTranslation(language, "pros");
+const conTitle = getTranslation(language, "cons");
 ---
 
 <div class="seo-proscons-box">

package/src/seo/SEORenderer.astro

@@ -71,7 +71,7 @@ const { content } = Astro.props;
             );
         }
         if (section.type === "proscons") {
-            return <SEOProsCons title={section.title} items={section.items} proTitle={section.proTitle} conTitle={section.conTitle} />;
+            return <SEOProsCons title={section.title} items={section.items} />;
         }
         if (section.type === "summary") {
             return <SEOSummary title={section.title} items={section.items} />;

package/src/types/index.ts

@@ -34,7 +34,7 @@ export type SEOSection =
     | { type: "table"; headers: string[]; rows: string[][] }
     | { type: "tip"; title?: string; html: string }
     | { type: "card"; icon?: string; title?: string; html: string }
-    | { type: "stats"; items: { value: string; label: string; icon?: string }[]; columns?: 2 | 3 | 4 }
+    | { type: "stats"; items: { value: string; label: string; icon?: string; trend?: { value: string; positive: boolean } }[]; columns?: 2 | 3 | 4 }
     | { type: "glossary"; items: { term: string; definition: string }[] }
     | { type: "code"; code: string; ariaLabel?: string }
     | {
@@ -50,7 +50,7 @@ export type SEOSection =
           columns?: 2 | 3;
       }
     | { type: "diagnostic"; variant: "warning" | "error" | "info" | "success"; title: string; icon?: string; badge?: string; html: string }
-    | { type: "proscons"; title?: string; items: { pro: string; con: string }[]; proTitle?: string; conTitle?: string }
+    | { type: "proscons"; title?: string; items: { pro: string; con: string }[] }
     | { type: "summary"; title: string; items: string[] }
     | { type: "grid"; columns?: 1 | 2 | 3 | 4 }
     | { type: "message"; title?: string; ariaLabel?: string; html: string };

package/src/ui/Bibliography.astro

@@ -1,5 +1,6 @@
 ---
 import { Icon } from "astro-icon/components";
+import { getLanguageFromUrl, getTranslation } from "../i18n";
 
 interface Link {
     name: string;
@@ -8,10 +9,12 @@ interface Link {
 
 interface Props {
     links: Link[];
-    title?: string;
 }
 
-const { links = [], title = "Referencias Bibliográficas" } = Astro.props;
+const { links = [] } = Astro.props;
+
+const language = getLanguageFromUrl(Astro.url);
+const title = getTranslation(language, "bibliographicReferences");
 ---
 
 <div class="bibliography">

package/src/ui/FAQSection.astro

@@ -1,5 +1,6 @@
 ---
 import { Icon } from "astro-icon/components";
+import { getLanguageFromUrl, getTranslation } from "../i18n";
 
 interface FAQItem {
     question: string;
@@ -8,11 +9,13 @@ interface FAQItem {
 
 interface Props {
     items: FAQItem[];
-    title?: string;
-    inLanguage?: string;
 }
 
-const { items = [], title = "", inLanguage = "es-ES" } = Astro.props;
+const { items = [] } = Astro.props;
+
+const language = getLanguageFromUrl(Astro.url);
+const title = getTranslation(language, "faq");
+const inLanguage = language === "es" ? "es-ES" : `${language}-${language.toUpperCase()}`;
 
 const faqSchema = {
     "@context": "https://schema.org",