@jjlmoya/utils-hardware 1.1.0

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

@@ -0,0 +1,146 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ToneGeneratorUI } from '../ui';
+
+const slug = 'generador-tonos';
+const title = 'Generador de Tonos y Frecuencias Online';
+const description =
+  'Genera ondas sinusoidales, cuadradas, triangulares y de sierra. Prueba tus altavoces, auriculares o subwoofer con frecuencias de 20Hz a 20kHz.';
+
+const faqData = [
+  {
+    question: '¿Para qué sirve generar frecuencias específicas?',
+    answer:
+      'Sirve para probar la respuesta de frecuencia de altavoces y auriculares, detectar vibraciones extrañas en muebles (resonancia), encontrar agujeros en tu audición o incluso para calmar el tinnitus mediante terapia de muesca.',
+  },
+  {
+    question: '¿Qué es una onda sinusoidal frente a una onda cuadrada?',
+    answer:
+      'La onda sinusoidal es un tono puro sin armónicos (suave). La onda cuadrada es rica en armónicos impares y tiene un sonido mucho más agresivo o digital. La triangular es un punto intermedio, útil para síntesis de audio.',
+  },
+  {
+    question: '¿Puedo dañar mis altavoces con esta herramienta?',
+    answer:
+      'Sí, si usas volúmenes muy altos en frecuencias extremas (especialmente graves por debajo de 30Hz o agudos por encima de 15kHz). Empieza siempre con el volumen del sistema bajo y súbelo gradualmente.',
+  },
+  {
+    question: '¿Cuál es el rango de audición humano?',
+    answer:
+      'Teóricamente de 20Hz a 20,000Hz (20kHz). Sin embargo, con la edad es normal perder la capacidad de oír por encima de los 15kHz. Este test puede ayudarte a verificar tu límite superior personal.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Seleccionar el tipo de onda',
+    text: 'Elige entre Sinusoidal (pura), Cuadrada, Triangular o Diente de Sierra según el tipo de prueba que quieras realizar.',
+  },
+  {
+    name: 'Ajustar la frecuencia',
+    text: 'Mueve el control deslizante para navegar por el espectro audible. Usa los atajos de 60Hz, 440Hz o 1kHz para acceder rápidamente a frecuencias de referencia.',
+  },
+  {
+    name: 'Controlar el volumen',
+    text: 'Asegúrate de que el volumen de tus altavoces sea bajo antes de pulsar Play. Puedes ajustar la ganancia directamente desde la herramienta.',
+  },
+  {
+    name: 'Analizar la respuesta',
+    text: 'Escucha posibles distorsiones o momentos en los que el sonido desaparece. Esto te indicará los límites físicos de tu hardware de audio.',
+  },
+];
+
+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, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    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: 'es',
+};
+
+export const content: ToolLocaleContent<ToneGeneratorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias',
+  bibliography: [
+    {
+      name: 'MDN Web Docs — Web Audio API',
+      url: 'https://developer.mozilla.org/es/docs/Web/API/Web_Audio_API',
+    },
+    {
+      name: 'ISO 226:2023 — Curvas de igual sonoridad',
+      url: 'https://www.iso.org/standard/83117.html',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Todo sobre Frecuencias y Ondas de Sonido', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'El sonido es física pura en movimiento. Esta herramienta te permite manipular ondas sonoras en tiempo real, desde los graves más profundos que puedes sentir en el pecho hasta los agudos ultrasónicos que solo perciben los animales.',
+    },
+    { type: 'title', text: 'Rango Auditivo Humano y Presbiacusia', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'El oído humano sano percibe entre <strong>20Hz y 20kHz</strong>. Con la edad, el límite superior cae: la mayoría de adultos mayores de 50 años no superan los 12kHz. El tono de 17.4kHz, conocido como "el tono mosquito", es un test clásico que solo suelen superar los adolescentes.',
+    },
+    { type: 'title', text: 'Tipos de Ondas y sus Usos', level: 3 },
+    {
+      type: 'paragraph',
+      html: '<strong>Sinusoidal:</strong> tono puro sin armónicos, usado en tests auditivos médicos y calibración de instrumentos. <strong>Cuadrada:</strong> rica en armónicos impares, suena como consolas retro de 8-bits. <strong>Diente de sierra:</strong> contiene todos los armónicos, base de los sintetizadores de música electrónica. <strong>Triangular:</strong> punto medio entre sinusoidal y cuadrada, más suave que la cuadrada pero con más contenido armónico que la senoidal.',
+    },
+    { type: 'title', text: 'Test de Altavoces y Limpieza por Vibración', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Una onda de baja frecuencia (generalmente <strong>165Hz</strong>) a volumen máximo con forma cuadrada o de sierra fuerza al diafragma del altavoz a vibrar violentamente, expulsando mecánicamente las gotas de agua atrapadas en la rejilla. No reproduzcas frecuencias extremadamente agudas a máximo volumen durante mucho tiempo: aunque no las oigas, la energía puede dañar los tweeters de tu equipo.',
+    },
+  ],
+  ui: {
+    badge: 'Generador de Audio',
+    title: 'Generador de Tonos',
+    description: 'Crea frecuencias puras para test de audio.',
+    freqLabel: 'Frecuencia',
+    preset60: '60Hz',
+    preset440: '440Hz',
+    preset1k: '1kHz',
+    rangeMin: '20Hz (Subgrave)',
+    rangeMax: '20kHz (Ultrasonido)',
+    waveLabel: 'Forma de Onda',
+    waveSine: 'Sinusoidal',
+    waveSquare: 'Cuadrada',
+    waveSawtooth: 'Diente de Sierra',
+    waveTriangle: 'Triangular',
+    volLabel: 'Volumen',
+    btnPlay: 'REPRODUCIR TONO',
+    btnStop: 'DETENER',
+  },
+};

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

@@ -0,0 +1,146 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ToneGeneratorUI } from '../ui';
+
+const slug = 'generateur-de-frequences';
+const title = 'Générateur de Tons et Fréquences en Ligne';
+const description =
+  'Générez des ondes sinusoïdales, carrées, triangulaires et en dents de scie. Testez vos haut-parleurs, écouteurs ou caisson de basses avec des fréquences de 20Hz à 20kHz.';
+
+const faqData = [
+  {
+    question: 'À quoi sert un générateur de fréquences ?',
+    answer:
+      "Il sert à tester la réponse en fréquence des haut-parleurs et des écouteurs, à détecter des résonances indésirables dans les meubles, à trouver des lacunes dans votre audition ou même à aider à calmer les acouphènes par thérapie par encoche.",
+  },
+  {
+    question: "Qu'est-ce qu'une onde sinusoïdale par rapport à une onde carrée ?",
+    answer:
+      "L'onde sinusoïdale est un ton pur sans harmoniques (douce et ronde). L'onde carrée est riche en harmoniques impaires et sonne beaucoup plus agressive ou digitale. L'onde triangulaire se situe entre les deux, utile pour la synthèse audio.",
+  },
+  {
+    question: 'Puis-je endommager mes haut-parleurs avec cet outil ?',
+    answer:
+      "Oui, si vous utilisez des volumes très élevés à des fréquences extrêmes (surtout les graves en dessous de 30Hz ou les aigus au-dessus de 15kHz). Commencez toujours avec un volume système bas et augmentez progressivement.",
+  },
+  {
+    question: "Quelle est la plage d'audition humaine ?",
+    answer:
+      "Théoriquement de 20Hz à 20 000Hz (20kHz). Cependant, avec l'âge, il est normal de perdre la capacité d'entendre au-dessus de 15kHz. Ce test peut vous aider à vérifier votre limite personnelle.",
+  },
+];
+
+const howToData = [
+  {
+    name: "Sélectionner le type d'onde",
+    text: 'Choisissez entre Sinusoïdale (pure), Carrée, Triangulaire ou Dent de scie selon le type de test que vous souhaitez effectuer.',
+  },
+  {
+    name: 'Ajuster la fréquence',
+    text: 'Déplacez le curseur pour naviguer dans le spectre audible. Utilisez les raccourcis 60Hz, 440Hz ou 1kHz pour accéder rapidement aux fréquences de référence.',
+  },
+  {
+    name: 'Contrôler le volume',
+    text: "Assurez-vous que le volume de vos haut-parleurs est bas avant d'appuyer sur Lecture. Vous pouvez ajuster le gain directement depuis l'outil.",
+  },
+  {
+    name: 'Analyser la réponse',
+    text: "Écoutez d'éventuelles distorsions ou moments où le son disparaît. Cela vous indiquera les limites physiques de votre matériel audio.",
+  },
+];
+
+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, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    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<ToneGeneratorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Références',
+  bibliography: [
+    {
+      name: 'MDN Web Docs — Web Audio API',
+      url: 'https://developer.mozilla.org/fr/docs/Web/API/Web_Audio_API',
+    },
+    {
+      name: 'ISO 226:2023 — Courbes isophoniques',
+      url: 'https://www.iso.org/standard/83117.html',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Tout sur les Fréquences et les Ondes Sonores', level: 2 },
+    {
+      type: 'paragraph',
+      html: "Le son est de la physique pure en mouvement. Cet outil vous permet de manipuler des ondes sonores en temps réel, des graves les plus profonds que vous pouvez ressentir dans votre poitrine aux aigus ultrasoniques que seuls les animaux perçoivent.",
+    },
+    { type: 'title', text: 'Plage Auditive Humaine et Presbyacousie', level: 3 },
+    {
+      type: 'paragraph',
+      html: "Une oreille humaine saine perçoit entre <strong>20Hz et 20kHz</strong>. Avec l'âge, la limite supérieure baisse : la plupart des adultes de plus de 50 ans ne peuvent pas entendre au-dessus de 12kHz. Le ton à 17,4kHz, connu comme le « ton moustique », est un test classique que seuls les adolescents peuvent généralement franchir.",
+    },
+    { type: 'title', text: 'Types d\'ondes et leurs utilisations', level: 3 },
+    {
+      type: 'paragraph',
+      html: "<strong>Sinusoïdale :</strong> ton pur sans harmoniques, utilisé dans les tests auditifs médicaux et la calibration d'instruments. <strong>Carrée :</strong> riche en harmoniques impaires, sonne comme les consoles rétro 8-bits. <strong>Dent de scie :</strong> contient toutes les harmoniques, base des synthétiseurs de musique électronique. <strong>Triangulaire :</strong> point médian entre sinusoïdale et carrée — plus douce que la carrée mais avec plus de contenu harmonique que la sinusoïdale.",
+    },
+    { type: 'title', text: 'Test de haut-parleurs et nettoyage par vibration', level: 3 },
+    {
+      type: 'paragraph',
+      html: "Une onde de basse fréquence (généralement <strong>165Hz</strong>) à volume maximum avec une forme carrée ou en dents de scie force le diaphragme du haut-parleur à vibrer violemment, expulsant mécaniquement les gouttes d'eau piégées dans la grille. Ne reproduisez pas des fréquences extrêmement aiguës à volume maximum pendant longtemps : même si vous ne les entendez pas, l'énergie peut endommager les tweeters de votre équipement.",
+    },
+  ],
+  ui: {
+    badge: 'Générateur Audio',
+    title: 'Générateur de Fréquences',
+    description: 'Créez des fréquences pures pour les tests audio.',
+    freqLabel: 'Fréquence',
+    preset60: '60Hz',
+    preset440: '440Hz',
+    preset1k: '1kHz',
+    rangeMin: '20Hz (Sub-grave)',
+    rangeMax: '20kHz (Ultrason)',
+    waveLabel: "Forme d'onde",
+    waveSine: 'Sinusoïdale',
+    waveSquare: 'Carrée',
+    waveSawtooth: 'Dent de scie',
+    waveTriangle: 'Triangulaire',
+    volLabel: 'Volume',
+    btnPlay: 'LIRE LE TON',
+    btnStop: 'ARRÊTER',
+  },
+};

package/src/tool/toneGenerator/index.ts

@@ -0,0 +1,34 @@
+import type { HardwareToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+
+import ToneGeneratorComponent from './component.astro';
+import ToneGeneratorSEO from './seo.astro';
+import ToneGeneratorBibliography from './bibliography.astro';
+
+import type { ToneGeneratorUI } from './ui';
+export type ToneGeneratorLocaleContent = ToolLocaleContent<ToneGeneratorUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const toneGenerator: HardwareToolEntry<ToneGeneratorUI> = {
+  id: 'generador-tonos',
+  icons: {
+    bg: 'mdi:sine-wave',
+    fg: 'mdi:waveform',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { ToneGeneratorComponent, ToneGeneratorSEO, ToneGeneratorBibliography };
+
+export const TONE_GENERATOR_TOOL: ToolDefinition = {
+  entry: toneGenerator,
+  Component: ToneGeneratorComponent,
+  SEOComponent: ToneGeneratorSEO,
+  BibliographyComponent: ToneGeneratorBibliography,
+};

package/src/tool/toneGenerator/seo.astro

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

package/src/tool/toneGenerator/ui.ts

@@ -0,0 +1,19 @@
+export interface ToneGeneratorUI extends Record<string, string> {
+  badge: string;
+  title: string;
+  description: string;
+  freqLabel: string;
+  preset60: string;
+  preset440: string;
+  preset1k: string;
+  rangeMin: string;
+  rangeMax: string;
+  waveLabel: string;
+  waveSine: string;
+  waveSquare: string;
+  waveSawtooth: string;
+  waveTriangle: string;
+  volLabel: string;
+  btnPlay: string;
+  btnStop: string;
+}

package/src/tools.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from './types';
+import { PIXELES_PANTALLA_TOOL } from './tool/deadPixelTest/index';
+import { TEST_TECLADO_TOOL } from './tool/keyboardTest/index';
+import { TEST_MANDO_TOOL } from './tool/gamepadTest/index';
+import { PROBADOR_VIBRACION_MANDO_TOOL } from './tool/gamepadVibrationTester/index';
+import { TEST_RATON_TOOL } from './tool/mousePollingTest/index';
+import { ESTIMADOR_SALUD_BATERIA_TOOL } from './tool/batteryHealthEstimator/index';
+import { TONE_GENERATOR_TOOL } from './tool/toneGenerator/index';
+
+export const ALL_TOOLS: ToolDefinition[] = [PIXELES_PANTALLA_TOOL, TEST_TECLADO_TOOL, TEST_MANDO_TOOL, PROBADOR_VIBRACION_MANDO_TOOL, TEST_RATON_TOOL, ESTIMADOR_SALUD_BATERIA_TOOL, TONE_GENERATOR_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 HardwareToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface HardwareCategoryEntry {
+  icon: string;
+  tools: HardwareToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: HardwareToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+