@jjlmoya/utils-developer 1.2.0

package/src/tool/utmGenerator/i18n/en.ts

@@ -0,0 +1,117 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'utm-generator';
+const title = 'UTM Parameter Generator for Google Analytics';
+const description = 'Create precise tracking links for your digital marketing campaigns. Optimized for Google Analytics and other analytics tools.';
+
+const faqData = [
+  {
+    question: 'Is using UTM parameters bad for SEO?',
+    answer: 'No, as long as you use canonical tags. Search engines understand that UTM parameters are for analytics and do not create duplicate content.',
+  },
+  {
+    question: 'Should I use UTM parameters for internal links?',
+    answer: 'No, never. UTM tags on internal links break the user session in tools like Google Analytics, distorting your traffic data.',
+  },
+  {
+    question: 'Does Google Analytics distinguish between uppercase and lowercase in UTM?',
+    answer: 'Yes. "google", "Google" and "GOOGLE" will be treated as different sources. Always maintain consistency, preferably using only lowercase.',
+  },
+];
+
+const howToData = [
+  { name: 'Enter the URL', text: 'Input the complete URL of your website, including https://' },
+  { name: 'Define the source', text: 'Specify where the traffic comes from (google, facebook, newsletter, etc.)' },
+  { name: 'Select the medium', text: 'Choose the type of channel (cpc, email, social, organic, etc.)' },
+  { name: 'Name your campaign', text: 'Assign an identifiable name to group your marketing efforts' },
+  { name: 'Copy and use', text: 'Copy the generated URL and use it in your posts, ads or email signatures' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'Website URL (e.g. https://example.com) *',
+  labelSource: 'Campaign source (e.g. google, newsletter) *',
+  labelMedium: 'Campaign medium (e.g. cpc, email)',
+  labelCampaign: 'Campaign name (e.g. summer_offer)',
+  labelTerm: 'Campaign term (e.g. buy_shoes)',
+  labelContent: 'Campaign content (e.g. banner_top)',
+  labelGenerated: 'Generated URL:',
+  btnCopy: 'Copy Link',
+  btnCopied: 'Copied!',
+  errorInvalid: 'Enter a valid URL',
+  errorInvalidUrl: 'Invalid URL',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'References',
+  bibliography: [
+    { name: 'Collect campaign data with custom URLs - Google Analytics Help (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices for Campaign URL Tagging - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'UTM Generator: Tracking Parameters for Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: '<strong>UTM</strong> parameters (Urchin Tracking Module) are text labels added to the end of a URL to track web traffic. Our generator simplifies creating trackable links for your digital marketing campaigns.',
+    },
+    { type: 'title', text: 'The 5 Pillars of a Trackable URL', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Campaign Source:</strong> Identifies the search engine, social network or traffic origin. Example: google, newsletter, facebook.',
+        '<strong>Campaign Medium:</strong> Refers to the marketing channel. Example: cpc, email, social, banner, organic.',
+        '<strong>Campaign Name:</strong> The specific name of your campaign. Example: summer_offer_2025, app_launch_v2.',
+        '<strong>Campaign Term:</strong> For paid searches, the keywords you bid on. Example: buy_sports_shoes.',
+        '<strong>Campaign Content:</strong> For A/B testing. Differentiates similar elements within a campaign. Example: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Best Practices for UTM Tagging', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Case consistency:</strong> Tools differentiate "Google", "GOOGLE" and "google". Always use lowercase to avoid duplicates.',
+        '<strong>Avoid spaces:</strong> Spaces become %20. Use hyphens (-) or underscores (_) instead.',
+        '<strong>Don\'t use on internal links:</strong> UTM tracking is exclusively for external traffic. On internal links, it breaks the session and ruins key metrics.',
+        '<strong>Document your tags:</strong> Keep a record of all combinations you use to prevent inconsistencies.',
+      ],
+    },
+  ],
+};

package/src/tool/utmGenerator/i18n/es.ts

@@ -0,0 +1,117 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'generador-utm';
+const title = 'Generador de Parámetros UTM para Google Analytics';
+const description = 'Crea enlaces de seguimiento precisos para tus campañas de marketing digital. Optimizado para Google Analytics y otras herramientas de analítica.';
+
+const faqData = [
+  {
+    question: '¿Es perjudicial para el SEO usar parámetros UTM?',
+    answer: 'No, siempre que uses etiquetas canónicas. Los buscadores entienden que los parámetros UTM son para analítica y no crean contenido duplicado.',
+  },
+  {
+    question: '¿Debo usar parámetros UTM para enlaces internos?',
+    answer: 'No, nunca. Las etiquetas UTM en enlaces internos rompen la sesión del usuario en herramientas como Google Analytics, distorsionando tus datos de tráfico.',
+  },
+  {
+    question: '¿Google Analytics distingue entre mayúsculas y minúsculas en UTM?',
+    answer: 'Sí. "google", "Google" y "GOOGLE" se tratarán como fuentes diferentes. Mantén siempre la consistencia, preferiblemente usando solo minúsculas.',
+  },
+];
+
+const howToData = [
+  { name: 'Ingresa la URL', text: 'Introduce la URL completa de tu sitio web, incluyendo https://' },
+  { name: 'Define la fuente', text: 'Especifica de dónde viene el tráfico (google, facebook, newsletter, etc.)' },
+  { name: 'Selecciona el medio', text: 'Elige el tipo de canal (cpc, email, social, organic, etc.)' },
+  { name: 'Nombra tu campaña', text: 'Asigna un nombre identificable para agrupar tus esfuerzos de marketing' },
+  { name: 'Copia y utiliza', text: 'Copia la URL generada y úsala en tus publicaciones, anuncios o firmas de correo' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'URL del sitio web (p. ej. https://ejemplo.com) *',
+  labelSource: 'Fuente de la campaña (p. ej. google, newsletter) *',
+  labelMedium: 'Medio de la campaña (p. ej. cpc, email)',
+  labelCampaign: 'Nombre de la campaña (p. ej. oferta_verano)',
+  labelTerm: 'Término de la campaña (p. ej. comprar_zapatos)',
+  labelContent: 'Contenido de la campaña (p. ej. banner_superior)',
+  labelGenerated: 'URL Generada:',
+  btnCopy: 'Copiar Enlace',
+  btnCopied: '¡Copiado!',
+  errorInvalid: 'Introduce una URL válida',
+  errorInvalidUrl: 'URL no válida',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias',
+  bibliography: [
+    { name: 'Collect campaign data with custom URLs - Google Analytics Help (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices for Campaign URL Tagging - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Generador UTM: Parámetros de Seguimiento para Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Los parámetros <strong>UTM</strong> (Urchin Tracking Module) son etiquetas de texto que se añaden al final de una URL para realizar un seguimiento del tráfico web. Nuestro generador simplifica la creación de enlaces rastreables para tus campañas de marketing digital.',
+    },
+    { type: 'title', text: 'Los 5 pilares de una URL rastreable', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Campaign Source (Fuente):</strong> Identifica el buscador, la red social o el origen del tráfico. Ejemplo: google, newsletter, facebook.',
+        '<strong>Campaign Medium (Medio):</strong> Se refiere al canal de marketing. Ejemplo: cpc, email, social, banner, organico.',
+        '<strong>Campaign Name (Nombre):</strong> El nombre específico de tu campaña. Ejemplo: oferta_verano_2025, lanzamiento_app_v2.',
+        '<strong>Campaign Term (Término):</strong> Para búsquedas pagadas, las palabras clave por las que has pujado. Ejemplo: comprar_zapatos_deportivos.',
+        '<strong>Campaign Content (Contenido):</strong> Para A/B testing. Diferencia elementos similares dentro de una campaña. Ejemplo: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Mejores prácticas para el etiquetado UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Consistencia en mayúsculas:</strong> Las herramientas diferencian "Google", "GOOGLE" y "google". Usa siempre minúsculas para evitar duplicidades.',
+        '<strong>Evita los espacios:</strong> Los espacios se convierten en %20. Usa guiones medios (-) o guiones bajos (_) en su lugar.',
+        '<strong>No uses en enlaces internos:</strong> El seguimiento UTM es exclusivamente para tráfico externo. En enlaces internos rompe la sesión y arruina métricas clave.',
+        '<strong>Documenta tus etiquetas:</strong> Mantén un registro de todas las combinaciones que uses para evitar inconsistencias.',
+      ],
+    },
+  ],
+};

package/src/tool/utmGenerator/i18n/fr.ts

@@ -0,0 +1,117 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UtmGeneratorUI } from '../ui';
+
+const slug = 'generateur-utm';
+const title = 'Générateur de Paramètres UTM pour Google Analytics';
+const description = 'Créez des liens de suivi précis pour vos campagnes de marketing numérique. Optimisé pour Google Analytics et autres outils d\'analyse.';
+
+const faqData = [
+  {
+    question: 'L\'utilisation de paramètres UTM est-elle préjudiciable au référencement?',
+    answer: 'Non, à condition d\'utiliser des balises canoniques. Les moteurs de recherche comprennent que les paramètres UTM sont destinés à l\'analyse et ne créent pas de contenu dupliqué.',
+  },
+  {
+    question: 'Dois-je utiliser des paramètres UTM pour les liens internes?',
+    answer: 'Non, jamais. Les balises UTM sur les liens internes rompent la session de l\'utilisateur dans des outils comme Google Analytics, faussant vos données de trafic.',
+  },
+  {
+    question: 'Google Analytics distingue-t-il les majuscules et minuscules dans les UTM?',
+    answer: 'Oui. "google", "Google" et "GOOGLE" seront traités comme des sources différentes. Maintenez toujours la cohérence, de préférence en utilisant uniquement des minuscules.',
+  },
+];
+
+const howToData = [
+  { name: 'Entrez l\'URL', text: 'Saisissez l\'URL complète de votre site Web, y compris https://' },
+  { name: 'Définissez la source', text: 'Spécifiez d\'où provient le trafic (google, facebook, newsletter, etc.)' },
+  { name: 'Sélectionnez le medium', text: 'Choisissez le type de canal (cpc, email, social, organic, etc.)' },
+  { name: 'Nommez votre campagne', text: 'Attribuez un nom identifiable pour regrouper vos efforts marketing' },
+  { name: 'Copiez et utilisez', text: 'Copiez l\'URL générée et utilisez-la dans vos publications, annonces ou signatures d\'e-mail' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+const ui: UtmGeneratorUI = {
+  labelUrl: 'URL du site Web (p. ex. https://exemple.com) *',
+  labelSource: 'Source de la campagne (p. ex. google, newsletter) *',
+  labelMedium: 'Medium de la campagne (p. ex. cpc, email)',
+  labelCampaign: 'Nom de la campagne (p. ex. offre_ete)',
+  labelTerm: 'Terme de la campagne (p. ex. acheter_chaussures)',
+  labelContent: 'Contenu de la campagne (p. ex. banniere_haut)',
+  labelGenerated: 'URL Générée:',
+  btnCopy: 'Copier le Lien',
+  btnCopied: 'Copié!',
+  errorInvalid: 'Entrez une URL valide',
+  errorInvalidUrl: 'URL invalide',
+};
+
+export const content: ToolLocaleContent<UtmGeneratorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Questions Fréquemment Posées',
+  faq: faqData,
+  bibliographyTitle: 'Références',
+  bibliography: [
+    { name: 'Collect campaign data with custom URLs - Google Analytics Help (2024)', url: 'https://support.google.com/analytics/answer/1033863' },
+    { name: 'Best Practices for Campaign URL Tagging - VWO Blog (2023)', url: 'https://vwo.com/blog/utm-tagging-best-practices/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Générateur UTM: Paramètres de Suivi pour Google Analytics', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Les paramètres <strong>UTM</strong> (Urchin Tracking Module) sont des libellés de texte ajoutés à la fin d\'une URL pour suivre le trafic Web. Notre générateur simplifie la création de liens traçables pour vos campagnes de marketing numérique.',
+    },
+    { type: 'title', text: 'Les 5 Piliers d\'une URL Traçable', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Campaign Source (Source):</strong> Identifie le moteur de recherche, le réseau social ou l\'origine du trafic. Exemple: google, newsletter, facebook.',
+        '<strong>Campaign Medium (Medium):</strong> Fait référence au canal marketing. Exemple: cpc, email, social, banner, organic.',
+        '<strong>Campaign Name (Nom):</strong> Le nom spécifique de votre campagne. Exemple: offre_ete_2025, lancement_app_v2.',
+        '<strong>Campaign Term (Terme):</strong> Pour les recherches payantes, les mots-clés sur lesquels vous enchérissez. Exemple: acheter_chaussures_sport.',
+        '<strong>Campaign Content (Contenu):</strong> Pour les tests A/B. Différencie les éléments similaires d\'une campagne. Exemple: header_v1, sidebar_v2.',
+      ],
+    },
+    { type: 'title', text: 'Meilleures Pratiques pour l\'Étiquetage UTM', level: 3 },
+    {
+      type: 'list',
+      items: [
+        '<strong>Cohérence de casse:</strong> Les outils distinguent "Google", "GOOGLE" et "google". Utilisez toujours les minuscules pour éviter les doublons.',
+        '<strong>Évitez les espaces:</strong> Les espaces deviennent %20. Utilisez des tirets (-) ou des traits de soulignement (_) à la place.',
+        '<strong>Ne l\'utilisez pas sur les liens internes:</strong> Le suivi UTM est exclusivement pour le trafic externe. Sur les liens internes, il casse la session et détruit les métriques clés.',
+        '<strong>Documentez vos étiquettes:</strong> Gardez un enregistrement de toutes les combinaisons que vous utilisez pour éviter les incohérences.',
+      ],
+    },
+  ],
+};

package/src/tool/utmGenerator/index.ts

@@ -0,0 +1,33 @@
+import type { DeveloperToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import UtmGeneratorComponent from './component.astro';
+import UtmGeneratorSEO from './seo.astro';
+import UtmGeneratorBibliography from './bibliography.astro';
+import type { UtmGeneratorUI } from './ui';
+
+export type UtmGeneratorLocaleContent = ToolLocaleContent<UtmGeneratorUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const utmGenerator: DeveloperToolEntry<UtmGeneratorUI> = {
+  id: 'utm-generator',
+  icons: {
+    bg: 'mdi:link-variant',
+    fg: 'mdi:tag-multiple',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { UtmGeneratorComponent, UtmGeneratorSEO, UtmGeneratorBibliography };
+
+export const UTM_GENERATOR_TOOL: ToolDefinition = {
+  entry: utmGenerator,
+  Component: UtmGeneratorComponent,
+  SEOComponent: UtmGeneratorSEO,
+  BibliographyComponent: UtmGeneratorBibliography,
+};

package/src/tool/utmGenerator/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { utmGenerator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await utmGenerator.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/utmGenerator/ui.ts

@@ -0,0 +1,13 @@
+export interface UtmGeneratorUI extends Record<string, string> {
+  labelUrl: string;
+  labelSource: string;
+  labelMedium: string;
+  labelCampaign: string;
+  labelTerm: string;
+  labelContent: string;
+  labelGenerated: string;
+  btnCopy: string;
+  btnCopied: string;
+  errorInvalid: string;
+  errorInvalidUrl: string;
+}

package/src/tools.ts

@@ -0,0 +1,27 @@
+import type { ToolDefinition } from './types';
+import { JSON_FORMATTER_TOOL } from './tool/jsonFormatter/index';
+import { SVG_TO_CSS_TOOL } from './tool/svgToCss/index';
+import { ASPECT_RATIO_TOOL } from './tool/aspectRatio/index';
+import { PLACEHOLDER_GENERATOR_TOOL } from './tool/placeholderGenerator/index';
+import { URL_ENCODER_DECODER_TOOL } from './tool/urlEncoderDecoder/index';
+import { DUPLICATE_CSS_REMOVER_TOOL } from './tool/duplicateCssRemover/index';
+import { CSS_TO_INLINE_CONVERTER_TOOL } from './tool/cssToInlineConverter/index';
+import { CSS_SPECIFICITY_CALCULATOR_TOOL } from './tool/cssSpecificityCalculator/index';
+import { CRON_GENERATOR_TOOL } from './tool/cronGenerator/index';
+import { KEYCODE_TOOL } from './tool/keycode/index';
+import { LLM_COST_CALCULATOR_TOOL } from './tool/llmCostCalculator/index';
+import { MUSICAL_TYPOGRAPHY_TOOL } from './tool/musicalTypography/index';
+import { MOBILE_MOCKUP_GENERATOR_TOOL } from './tool/mobileMockupGenerator/index';
+import { HASH_GENERATOR_TOOL } from './tool/hashGenerator/index';
+import { PROMPT_LIBRARY_TOOL } from './tool/promptLibrary/index';
+import { COLOR_CONVERTER_TOOL } from './tool/colorConverter/index';
+import { READABILITY_CALCULATOR_TOOL } from './tool/readabilityCalculator/index';
+import { SVG_SANITIZER_TOOL } from './tool/svgSanitizer/index';
+import { UTM_GENERATOR_TOOL } from './tool/utmGenerator/index';
+import { URL_CLEANER_TOOL } from './tool/urlCleaner/index';
+import { INSPECTOR_CERTIFICADOS_SSL_TOOL } from './tool/inspectorCertificadosSsl/index';
+import { GENERADOR_SECURITY_TXT_TOOL } from './tool/generadorSecurityTxt/index';
+import { CALCULADORA_TIEMPO_DATOS_TOOL } from './tool/calculadoraTiempoDatos/index';
+import { CONVERSOR_EXCEL_CSV_HTML_TOOL } from './tool/conversorExcelCsvHtml/index';
+
+export const ALL_TOOLS: ToolDefinition[] = [JSON_FORMATTER_TOOL, SVG_TO_CSS_TOOL, ASPECT_RATIO_TOOL, PLACEHOLDER_GENERATOR_TOOL, URL_ENCODER_DECODER_TOOL, DUPLICATE_CSS_REMOVER_TOOL, CSS_TO_INLINE_CONVERTER_TOOL, CSS_SPECIFICITY_CALCULATOR_TOOL, CRON_GENERATOR_TOOL, KEYCODE_TOOL, LLM_COST_CALCULATOR_TOOL, MUSICAL_TYPOGRAPHY_TOOL, MOBILE_MOCKUP_GENERATOR_TOOL, HASH_GENERATOR_TOOL, PROMPT_LIBRARY_TOOL, COLOR_CONVERTER_TOOL, READABILITY_CALCULATOR_TOOL, SVG_SANITIZER_TOOL, UTM_GENERATOR_TOOL, URL_CLEANER_TOOL, INSPECTOR_CERTIFICADOS_SSL_TOOL, GENERADOR_SECURITY_TXT_TOOL, CALCULADORA_TIEMPO_DATOS_TOOL, CONVERSOR_EXCEL_CSV_HTML_TOOL];

package/src/types.ts

@@ -0,0 +1,72 @@
+import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { WithContext, Thing } from 'schema-dts';
+
+export type { SEOSection };
+
+export type KnownLocale =
+  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
+  | 'fr' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+
+export interface FAQItem {
+  question: string;
+  answer: string;
+}
+
+export interface BibliographyEntry {
+  name: string;
+  url: string;
+}
+
+export interface HowToStep {
+  name: string;
+  text: string;
+}
+
+export interface ToolLocaleContent<TUI extends Record<string, string> = Record<string, string>> {
+  slug: string;
+  title: string;
+  description: string;
+  ui: TUI;
+  seo: SEOSection[];
+  faqTitle?: string;
+  faq: FAQItem[];
+  bibliographyTitle?: string;
+  bibliography: BibliographyEntry[];
+  howTo: HowToStep[];
+  schemas: WithContext<Thing>[];
+}
+
+export interface CategoryLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  seo: SEOSection[];
+}
+
+export type LocaleLoader<T> = () => Promise<T>;
+
+export type LocaleMap<T> = Partial<Record<KnownLocale, LocaleLoader<T>>>;
+
+export interface DeveloperToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface DeveloperCategoryEntry {
+  icon: string;
+  tools: DeveloperToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: DeveloperToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+