@jjlmoya/utils-tools 1.1.0

package/src/tool/whatsapp-link/i18n/es.ts

@@ -0,0 +1,128 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { WhatsappLinkUI } from '../ui';
+
+const faqData = [
+  {
+    question: '¿Cómo genero un link de WhatsApp?',
+    answer: 'Para crear tu enlace escribe tu número móvil incluyendo el indicativo de país. Por ejemplo, para España pon primero el 34, para México el 52, seguido de tu número normal. Puedes añadir un mensaje opcional y la herramienta generará el enlace final (wa.me) que podrás copiar.',
+  },
+  {
+    question: '¿Puedo añadir un mensaje predefinido largo?',
+    answer: 'Sí. Puedes adjuntar un texto que aparecerá automáticamente en la caja de mensaje del usuario al presionar el enlace. Se usa la codificación de URLs del navegador para soportar espacios, tildes y emoticonos sin corromper la URL.',
+  },
+  {
+    question: '¿Cómo uso el código QR generado?',
+    answer: 'Al generar un link válido, aparecerá el botón "Mostrar QR". El código QR generado contiene la URL. Puedes hacer clic derecho y guardar la imagen para usarla en tarjetas de visita, carteles o redes sociales.',
+  },
+  {
+    question: '¿A dónde van mis datos?',
+    answer: 'El generador realiza toda la recolección, limpieza y codificación puramente del lado cliente, en tu navegador. Tu número de teléfono y mensaje predefinido no se envían a ningún servidor ni se almacenan en ninguna base de datos.',
+  },
+];
+
+const howToData = [
+  { name: 'Seleccionar el prefijo', text: 'Elige el indicativo de tu país en el selector y escribe tu número de teléfono sin el prefijo.' },
+  { name: 'Añadir mensaje opcional', text: 'Escribe un texto predefinido que aparecerá cuando alguien abra el enlace y pulse Enviar.' },
+  { name: 'Generar el enlace', text: 'Pulsa el botón verde para obtener tu URL directa de wa.me lista para compartir.' },
+  { name: 'Compartir o imprimir QR', text: 'Copia el enlace, prueba el chat o descarga el código QR para tarjetas e impresión.' },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Cómo crear un enlace directo de WhatsApp',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Generador de Enlaces de WhatsApp',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Crea enlaces directos a tu chat de WhatsApp con mensaje predefinido y código QR. Herramienta gratuita y 100% privada.',
+};
+
+const ui: WhatsappLinkUI = {
+  phoneLabel: 'Teléfono de WhatsApp',
+  phonePlaceholder: '600 00 00 00',
+  messageLabel: 'Mensaje inicial (opcional)',
+  messagePlaceholder: '¡Hola! Me gustaría más información sobre el servicio...',
+  generateBtn: 'Generar Enlace',
+  resultLabel: 'Link Directo Generado',
+  copyTitle: 'Copiar al portapapeles',
+  copyDone: '¡Copiado!',
+  testBtn: 'Probar Chat',
+  qrShow: 'Mostrar QR',
+  qrHide: 'Ocultar QR',
+  errorPhone: 'Por favor, introduce un número válido.',
+  defaultPrefix: '34',
+};
+
+export const content: ToolLocaleContent<WhatsappLinkUI> = {
+  slug: 'generador-enlaces-whatsapp',
+  title: 'Generador de Enlace WhatsApp con QR',
+  description: 'Crea enlaces directos a tu chat de WhatsApp con mensaje predefinido y código QR. Herramienta gratuita, sin registro y 100% privada.',
+  ui,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Referencias',
+  bibliography: [
+    { name: 'Cómo usar la función clic para chatear — Centro de ayuda de WhatsApp', url: 'https://faq.whatsapp.com/591339899867293' },
+    { name: 'API Click to chat: parámetros y formatos — WhatsApp', url: 'https://faq.whatsapp.com/425559092497645' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Genera enlaces cortos y directos para WhatsApp' },
+    {
+      type: 'paragraph',
+      html: '¿Necesitas que clientes o seguidores te contacten por WhatsApp sin tener que guardar tu número? Nuestro <strong>creador de enlaces wa.me</strong> soluciona este problema generando un link que abre un chat directo al instante, sin pasos previos.',
+    },
+    { type: 'title', level: 3, text: '¿Para qué sirve el acortador wa.me de WhatsApp?' },
+    {
+      type: 'paragraph',
+      html: 'WhatsApp dispone de una API llamada "Clic para chatear". Mediante una URL especial, cualquier usuario puede abrir un chat nuevo contigo sin necesidad de añadirte como contacto previamente, tanto desde móvil como desde WhatsApp Web.',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Más conversiones:</strong> Un botón de "Contactar por WhatsApp" en tu tienda reduce la fricción y aumenta las ventas.',
+        '<strong>Mensaje predefinido:</strong> El usuario solo pulsa "Enviar". Ejemplo: "¡Hola! Vengo desde Instagram y quiero pedir la oferta."',
+        '<strong>Código QR automático:</strong> Descarga el QR para tarjetas de visita, carteles o publicaciones en redes.',
+      ],
+    },
+    { type: 'title', level: 3, text: '¿Cómo funciona la generación del enlace?' },
+    {
+      type: 'paragraph',
+      html: 'La herramienta concatena el prefijo internacional y el número limpio, y lo adhiere a la API oficial de WhatsApp junto al parámetro de texto convertido mediante <em>url-encoding</em>.',
+    },
+    {
+      type: 'code',
+      ariaLabel: 'Formato de URL de WhatsApp',
+      code: 'https://wa.me/34XXXXXXXXX\nhttps://wa.me/34XXXXXXXXX?text=%C2%A1Hola!%20Me%20gustar%C3%ADa...',
+    },
+    { type: 'title', level: 3, text: 'Privacidad garantizada y procesamiento local' },
+    {
+      type: 'paragraph',
+      html: 'Toda la construcción del enlace ocurre en tu navegador mediante JavaScript. Ningún servidor registra, guarda ni lee los números de teléfono ni los mensajes que introduces. Tu privacidad está completamente protegida.',
+    },
+    {
+      type: 'tip',
+      title: 'Importancia del prefijo internacional',
+      html: 'Para que WhatsApp dirija el mensaje correctamente, es obligatorio incluir el código de país. Para España es el <strong>34</strong>, seguido del número de 9 cifras, sin espacios ni el símbolo +. El resultado final sería, por ejemplo, <code>346XXXXXXXX</code>.',
+    },
+  ],
+};

package/src/tool/whatsapp-link/i18n/fr.ts

@@ -0,0 +1,128 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { WhatsappLinkUI } from '../ui';
+
+const faqData = [
+  {
+    question: 'Comment générer un lien WhatsApp ?',
+    answer: "Pour créer votre lien, saisissez votre numéro de mobile en incluant l'indicatif de pays. Par exemple, pour l'Espagne mettez d'abord le 34, pour la France le 33, suivi de votre numéro local. Vous pouvez ajouter un message optionnel et l'outil générera le lien wa.me final prêt à copier.",
+  },
+  {
+    question: 'Puis-je ajouter un long message prédéfini ?',
+    answer: "Oui. Vous pouvez joindre un texte qui apparaîtra automatiquement dans la zone de message de l'utilisateur lorsqu'il clique sur le lien. L'outil utilise l'encodage URL pour prendre en charge les espaces, les accents et les emojis sans corrompre l'URL.",
+  },
+  {
+    question: 'Comment utiliser le QR code généré ?',
+    answer: 'Une fois un lien valide généré, le bouton "Afficher QR" apparaît. Le code QR contient votre URL. Faites un clic droit et sélectionnez "Enregistrer l\'image" pour télécharger un fichier haute résolution pour cartes de visite, affiches ou réseaux sociaux.',
+  },
+  {
+    question: 'Où vont mes données ?',
+    answer: "Le générateur traite tout côté client, directement dans votre navigateur. Votre numéro de téléphone et votre message prédéfini ne sont jamais envoyés à un serveur ni stockés dans une base de données.",
+  },
+];
+
+const howToData = [
+  { name: "Sélectionner l'indicatif", text: "Choisissez l'indicatif de votre pays dans le menu déroulant et saisissez votre numéro sans le préfixe." },
+  { name: 'Ajouter un message optionnel', text: "Rédigez un texte prédéfini qui apparaîtra quand quelqu'un ouvrira le lien et appuiera sur Envoyer." },
+  { name: 'Générer le lien', text: "Appuyez sur le bouton vert pour obtenir votre URL directe wa.me prête à partager." },
+  { name: 'Partager ou imprimer le QR', text: "Copiez le lien, testez le chat ou téléchargez le code QR pour les cartes et l'impression." },
+];
+
+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<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: 'Comment créer un lien WhatsApp direct',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Générateur de Liens WhatsApp',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: "Créez des liens directs vers votre chat WhatsApp avec message prédéfini et code QR. Outil gratuit, sans inscription, 100% privé.",
+};
+
+const ui: WhatsappLinkUI = {
+  phoneLabel: 'Numéro WhatsApp',
+  phonePlaceholder: '06 00 00 00 00',
+  messageLabel: 'Message initial (optionnel)',
+  messagePlaceholder: "Bonjour ! Je souhaiterais plus d'informations sur votre service...",
+  generateBtn: 'Générer le lien',
+  resultLabel: 'Lien direct généré',
+  copyTitle: 'Copier dans le presse-papiers',
+  copyDone: 'Copié !',
+  testBtn: 'Tester le chat',
+  qrShow: 'Afficher QR',
+  qrHide: 'Masquer QR',
+  errorPhone: 'Veuillez saisir un numéro valide.',
+  defaultPrefix: '33',
+};
+
+export const content: ToolLocaleContent<WhatsappLinkUI> = {
+  slug: 'generateur-lien-whatsapp',
+  title: 'Générateur de Lien WhatsApp avec QR',
+  description: "Créez des liens directs vers votre chat WhatsApp avec message prédéfini et code QR. Outil gratuit, sans inscription, 100% privé.",
+  ui,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Références',
+  bibliography: [
+    { name: "Comment utiliser la fonction clic pour chatter — Aide WhatsApp", url: 'https://faq.whatsapp.com/591339899867293' },
+    { name: "API Click to chat : paramètres et formats — WhatsApp", url: 'https://faq.whatsapp.com/425559092497645' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', level: 2, text: 'Générez des liens courts et directs pour WhatsApp' },
+    {
+      type: 'paragraph',
+      html: 'Vous avez besoin que des clients ou abonnés vous contactent sur WhatsApp sans avoir à enregistrer votre numéro ? Notre <strong>créateur de liens wa.me</strong> résout ce problème en générant un lien qui ouvre un chat direct instantanément, sans étapes préalables.',
+    },
+    { type: 'title', level: 3, text: "À quoi sert le raccourcisseur wa.me de WhatsApp ?" },
+    {
+      type: 'paragraph',
+      html: 'WhatsApp propose une API appelée "Clic pour chatter". Grâce à une URL spéciale, tout utilisateur peut ouvrir une nouvelle conversation avec vous sans avoir besoin de vous ajouter comme contact au préalable, depuis mobile comme depuis WhatsApp Web.',
+    },
+    {
+      type: 'list',
+      items: [
+        "<strong>Plus de conversions :</strong> Un bouton « Contacter via WhatsApp » sur votre boutique réduit la friction et augmente les ventes.",
+        "<strong>Message prédéfini :</strong> L'utilisateur appuie juste sur « Envoyer ». Exemple : « Bonjour ! Je viens d'Instagram et veux profiter de l'offre. »",
+        "<strong>Code QR automatique :</strong> Téléchargez le QR pour cartes de visite, affiches ou publications sur les réseaux.",
+      ],
+    },
+    { type: 'title', level: 3, text: 'Comment fonctionne la génération du lien ?' },
+    {
+      type: 'paragraph',
+      html: "L'outil concatène le préfixe international et le numéro nettoyé, puis l'ajoute à l'API officielle de WhatsApp avec le paramètre de message converti via <em>url-encoding</em>.",
+    },
+    {
+      type: 'code',
+      ariaLabel: 'Format URL WhatsApp',
+      code: 'https://wa.me/33XXXXXXXXX\nhttps://wa.me/33XXXXXXXXX?text=Bonjour%20%21%20Je%20souhaite...',
+    },
+    { type: 'title', level: 3, text: 'Confidentialité garantie et traitement local' },
+    {
+      type: 'paragraph',
+      html: 'Toute la construction du lien se fait dans votre navigateur via JavaScript. Aucun serveur n\'enregistre, ne sauvegarde ni ne lit les numéros de téléphone ou les messages que vous saisissez. Votre confidentialité est totalement protégée.',
+    },
+    {
+      type: 'tip',
+      title: 'Importance du préfixe international',
+      html: 'Pour que WhatsApp achemine correctement le message, l\'indicatif de pays est obligatoire. Pour la France c\'est le <strong>33</strong>, suivi du numéro à 9 chiffres (sans le 0 initial), sans espace ni symbole +. Le résultat final serait par exemple <code>336XXXXXXXX</code>.',
+    },
+  ],
+};

package/src/tool/whatsapp-link/index.ts

@@ -0,0 +1,22 @@
+import type { ToolDefinition, ToolsToolEntry } from '../../types';
+import type { WhatsappLinkUI } from './ui';
+import WhatsappLinkComponent from './component.astro';
+import WhatsappLinkSEO from './seo.astro';
+import WhatsappLinkBibliography from './bibliography.astro';
+
+export const whatsappLink: ToolsToolEntry<WhatsappLinkUI> = {
+  id: 'whatsapp-link',
+  icons: { bg: 'mdi:whatsapp', fg: 'mdi:link-variant' },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+  },
+};
+
+export const WHATSAPP_LINK_TOOL: ToolDefinition = {
+  entry: whatsappLink,
+  Component: WhatsappLinkComponent,
+  SEOComponent: WhatsappLinkSEO,
+  BibliographyComponent: WhatsappLinkBibliography,
+};

package/src/tool/whatsapp-link/seo.astro

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

package/src/tool/whatsapp-link/ui.ts

@@ -0,0 +1,15 @@
+export interface WhatsappLinkUI extends Record<string, string> {
+  phoneLabel: string;
+  phonePlaceholder: string;
+  messageLabel: string;
+  messagePlaceholder: string;
+  generateBtn: string;
+  resultLabel: string;
+  copyTitle: string;
+  copyDone: string;
+  testBtn: string;
+  qrShow: string;
+  qrHide: string;
+  errorPhone: string;
+  defaultPrefix: string;
+}

package/src/tools.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from './types';
+import { ROUTES_TOOL } from './tool/routes/index';
+import { RULE_OF_THREE_TOOL } from './tool/rule-of-three/index';
+import { PASSWORD_GENERATOR_TOOL } from './tool/password-generator/index';
+import { MORSE_BEACON_TOOL } from './tool/morse-beacon/index';
+import { SPEED_READER_TOOL } from './tool/speed-reader/index';
+import { WHATSAPP_LINK_TOOL } from './tool/whatsapp-link/index';
+import { TEXT_PIXEL_CALCULATOR_TOOL } from './tool/text-pixel-calculator/index';
+import { DATE_DIFF_CALCULATOR_TOOL } from './tool/date-diff-calculator/index';
+import { EMAIL_LIST_CLEANER_TOOL } from './tool/email-list-cleaner/index';
+import { ENV_BADGE_SPAIN_TOOL } from './tool/env-badge-spain/index';
+import { DRIVE_DIRECT_LINK_TOOL } from './tool/drive-direct-link/index';
+import { SEO_CONTENT_OPTIMIZER_TOOL } from './tool/seo-content-optimizer/index';
+
+export const ALL_TOOLS: ToolDefinition[] = [ROUTES_TOOL, RULE_OF_THREE_TOOL, PASSWORD_GENERATOR_TOOL, MORSE_BEACON_TOOL, SPEED_READER_TOOL, WHATSAPP_LINK_TOOL, TEXT_PIXEL_CALCULATOR_TOOL, DATE_DIFF_CALCULATOR_TOOL, EMAIL_LIST_CLEANER_TOOL, ENV_BADGE_SPAIN_TOOL, DRIVE_DIRECT_LINK_TOOL, SEO_CONTENT_OPTIMIZER_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 ToolsToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface ToolsCategoryEntry {
+  icon: string;
+  tools: ToolsToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: ToolsToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+