@jjlmoya/utils-home 1.1.0

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

@@ -0,0 +1,233 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { QRGeneratorUI } from '../ui';
+
+const slug = 'generateur-qr';
+const title = 'Générateur de Codes QR Hors Ligne';
+const description =
+  'Générez des codes QR pour WiFi, URLs et Contacts de façon 100% sécurisée dans votre navigateur. Vos données ne quittent jamais votre appareil.';
+
+const faqData = [
+  {
+    question: 'Ces codes QR expirent-ils ?',
+    answer:
+      'Non. Les codes générés ici sont statiques. L\'information est encodée directement dans l\'image et ne dépend d\'aucun lien externe ni redirection. Ils fonctionneront toujours.',
+  },
+  {
+    question: 'Conservez-vous mes données ?',
+    answer:
+      'Absolument pas. Tout le processus se déroule dans votre navigateur (côté client). Aucune donnée n\'est envoyée à nos serveurs. C\'est 100% privé et sécurisé.',
+  },
+  {
+    question: 'Fonctionne-t-il sur iPhone et Android ?',
+    answer:
+      'Oui. La plupart des appareils photo modernes d\'iOS et Android lisent les codes QR nativement et suggèrent l\'action correspondante (connexion WiFi, ouverture de lien, etc.).',
+  },
+  {
+    question: 'Puis-je l\'utiliser sans internet ?',
+    answer:
+      'Oui. Une fois la page chargée, vous pouvez couper le WiFi ou les données et le générateur continuera à fonctionner parfaitement car il ne dépend pas de serveurs externes.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Choisir le type de QR',
+    text: 'Sélectionnez si vous voulez un code pour un réseau WiFi, un lien URL ou un contact (vCard).',
+  },
+  {
+    name: 'Saisir les données',
+    text: 'Remplissez les champs nécessaires, comme le nom du réseau et le mot de passe, ou l\'adresse web.',
+  },
+  {
+    name: 'Générer et vérifier',
+    text: 'Le code est généré instantanément. Vous pouvez essayer de le scanner directement depuis l\'écran.',
+  },
+  {
+    name: 'Télécharger',
+    text: 'Enregistrez le code QR en image (.webp) pour l\'imprimer ou le partager numériquement.',
+  },
+];
+
+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: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.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',
+};
+
+export const content: ToolLocaleContent<QRGeneratorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Bibliographie',
+  bibliography: [
+    {
+      name: 'node-qrcode: bibliothèque de génération de codes QR',
+      url: 'https://github.com/soldair/node-qrcode',
+    },
+    {
+      name: 'RFC 6350: Spécification du format vCard',
+      url: 'https://www.rfc-editor.org/rfc/rfc6350',
+    },
+    {
+      name: 'ZXing: Barcode Contents — WiFi, vCard et URL',
+      url: 'https://github.com/zxing/zxing/wiki/Barcode-Contents',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Pourquoi Hors Ligne ? La Confidentialité Avant Tout',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La plupart des générateurs QR en ligne envoient vos données à un serveur. C\'est un risque, surtout pour les <strong>mots de passe WiFi</strong> ou les <strong>données personnelles</strong>. Cet outil utilise JavaScript pour générer le code QR directement sur votre appareil. Vous pouvez même couper internet et il continuera à fonctionner.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '100%', label: 'Privé', icon: 'mdi:shield-lock' },
+        { value: 'Offline', label: 'Sans Serveur', icon: 'mdi:wifi-off' },
+        { value: 'WebP', label: 'Téléchargement Direct', icon: 'mdi:download' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'diagnostic',
+      variant: 'success',
+      title: 'Code Source Ouvert et Transparent',
+      icon: 'mdi:github',
+      badge: 'Open Source',
+      html: '<p>Vous ne nous faites pas confiance ? Le code de cet outil est 100% open source. Vous pouvez vérifier son fonctionnement ou le télécharger pour l\'exécuter sur votre propre ordinateur sans internet.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Cas d\'Utilisation',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'QR WiFi',
+          description: 'Partagez votre réseau WiFi avec des invités sans avoir à dicter le mot de passe. Ils scannent et se connectent automatiquement.',
+          icon: 'mdi:wifi',
+          points: ['Pris en charge nativement par iOS et Android', 'Compatible WPA2, WEP et réseaux ouverts'],
+        },
+        {
+          title: 'QR URL',
+          description: 'Transformez n\'importe quel lien web en code scannable. Idéal pour l\'impression sur des supports physiques.',
+          icon: 'mdi:link',
+          points: ['Toute URL valide', 'Pas de date d\'expiration'],
+        },
+        {
+          title: 'QR vCard',
+          description: 'Carte de visite numérique. En scannant, le téléphone suggère "Ajouter un contact" avec tous les champs pré-remplis.',
+          icon: 'mdi:card-account-details',
+          points: ['Nom, téléphone, email et entreprise', 'Format standard vCard 3.0'],
+        },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'title',
+      text: 'Guide d\'Utilisation',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Pour la maison (WiFi) :</strong> Fatigué de chercher le papier avec le mot de passe WiFi à chaque fois que des amis viennent ? Générez un QR avec le SSID et le mot de passe. Imprimez-le et collez-le dans un endroit visible. Vos invités n\'ont qu\'à ouvrir l\'appareil photo, pointer et voilà, ils se connectent sans rien taper.',
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Pour les Professionnels (vCard) :</strong> Lors d\'événements de networking, les cartes de visite papier appartiennent au passé. Générez un QR avec vos coordonnées. Gardez-le sur votre téléphone ou imprimez-le au dos de votre badge. En le scannant, votre nouveau contact peut enregistrer votre nom, téléphone, email et entreprise directement dans son carnet d\'adresses.',
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'Code QR',
+          definition: 'Code-barres 2D pouvant stocker jusqu\'à 4 296 caractères alphanumériques. Les appareils photo modernes le lisent en moins d\'une seconde.',
+        },
+        {
+          term: 'vCard',
+          definition: 'Format standard pour les cartes de contact numériques (RFC 6350). Compatible avec iOS, Android, Outlook et la plupart des gestionnaires de contacts.',
+        },
+        {
+          term: 'SSID',
+          definition: 'Service Set Identifier. Le nom visible d\'un réseau WiFi qui apparaît lors de la recherche de réseaux disponibles sur votre appareil.',
+        },
+        {
+          term: 'WPA2',
+          definition: 'Wi-Fi Protected Access 2. Le protocole de sécurité WiFi le plus répandu. Utilise le chiffrement AES pour protéger les communications.',
+        },
+      ],
+    },
+    {
+      type: 'summary',
+      title: 'Clés pour Bien Utiliser cet Outil',
+      items: [
+        'Toutes les données sont traitées dans votre navigateur, jamais sur un serveur externe.',
+        'Le QR WiFi nécessite le SSID et le mot de passe exacts (sensible à la casse).',
+        'Les codes QR générés sont statiques : si vous changez votre mot de passe WiFi, générez-en un nouveau.',
+        'Téléchargez en WebP pour une qualité maximale lors de l\'impression ou du partage.',
+        'Essayez de scanner le QR depuis l\'écran avant de l\'imprimer.',
+      ],
+    },
+  ],
+  ui: {
+    tabWifi: 'WiFi',
+    tabUrl: 'URL',
+    tabContact: 'Contact',
+    labelSsid: 'Nom du Réseau (SSID)',
+    labelPassword: 'Mot de Passe',
+    labelEncryption: 'Sécurité',
+    labelHidden: 'Réseau Caché',
+    labelUrl: 'Adresse Web (URL)',
+    labelName: 'Prénom',
+    labelSurname: 'Nom de Famille',
+    labelPhone: 'Téléphone',
+    labelEmail: 'Email',
+    labelOrg: 'Organisation / Entreprise',
+    encWpa: 'WPA/WPA2',
+    encWep: 'WEP',
+    encNone: 'Aucune',
+    downloadBtn: 'Télécharger PNG',
+    privacyMsg: 'Généré 100% dans votre navigateur. Vos données ne voyagent jamais sur Internet.',
+    placeholderSsid: 'MaBox_5G',
+    placeholderUrl: 'https://exemple.com',
+    placeholderPassword: '••••••••',
+  },
+};

package/src/tool/qrGenerator/index.ts

@@ -0,0 +1,34 @@
+import type { HomeToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import QRGeneratorComponent from './component.astro';
+import QRGeneratorSEO from './seo.astro';
+import QRGeneratorBibliography from './bibliography.astro';
+
+import type { QRGeneratorUI } from './ui';
+
+export type QRGeneratorLocaleContent = ToolLocaleContent<QRGeneratorUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const qrGenerator: HomeToolEntry<QRGeneratorUI> = {
+  id: 'qr-generator',
+  icons: {
+    bg: 'mdi:qrcode',
+    fg: 'mdi:wifi',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { QRGeneratorComponent, QRGeneratorSEO, QRGeneratorBibliography };
+
+export const QR_GENERATOR_TOOL: ToolDefinition = {
+  entry: qrGenerator,
+  Component: QRGeneratorComponent,
+  SEOComponent: QRGeneratorSEO,
+  BibliographyComponent: QRGeneratorBibliography,
+};

package/src/tool/qrGenerator/logic.ts

@@ -0,0 +1,27 @@
+export function wifi(
+  ssid: string,
+  password: string,
+  encryption: string,
+  hidden: boolean
+): string {
+  if (!ssid) return '';
+  const esc = (s: string) => s.replace(/([\\;,:])/g, '\\$1');
+  return `WIFI:S:${esc(ssid)};T:${encryption};P:${esc(password)};H:${hidden};;`;
+}
+
+export function url(value: string): string {
+  return value;
+}
+
+export interface VCardData {
+  name: string;
+  surname: string;
+  phone: string;
+  email: string;
+  org: string;
+}
+
+export function vcard(data: VCardData): string {
+  if (!Object.values(data).some((v) => v)) return '';
+  return `BEGIN:VCARD\nVERSION:3.0\nN:${data.surname};${data.name}\nFN:${data.name} ${data.surname}\nORG:${data.org}\nTEL:${data.phone}\nEMAIL:${data.email}\nEND:VCARD`;
+}

package/src/tool/qrGenerator/seo.astro

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

package/src/tool/qrGenerator/ui.ts

@@ -0,0 +1,23 @@
+export interface QRGeneratorUI extends Record<string, string> {
+  tabWifi: string;
+  tabUrl: string;
+  tabContact: string;
+  labelSsid: string;
+  labelPassword: string;
+  labelEncryption: string;
+  labelHidden: string;
+  labelUrl: string;
+  labelName: string;
+  labelSurname: string;
+  labelPhone: string;
+  labelEmail: string;
+  labelOrg: string;
+  encWpa: string;
+  encWep: string;
+  encNone: string;
+  downloadBtn: string;
+  privacyMsg: string;
+  placeholderSsid: string;
+  placeholderUrl: string;
+  placeholderPassword: string;
+}

package/src/tool/solarCalculator/bibliography.astro

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