@jjlmoya/utils-diy 1.1.0

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

@@ -0,0 +1,155 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { VoltageDropCalculatorUI } from '../ui';
+
+const slug = 'voltage-drop-calculator';
+const title = 'Voltage Drop Calculator: Wire Cross Section from Volts, Watts and Distance';
+const description =
+  'Free voltage drop calculator for 12V, 24V and 230V systems. Find the right cable cross section by entering current, wire length and conductor material. Essential for camper vans, solar and home wiring.';
+
+const faqData = [
+  {
+    question: 'What is voltage drop and why does it matter?',
+    answer:
+      'Voltage drop is the loss of voltage that occurs as electricity travels through a cable. A wire that is too thin or too long loses voltage along the way. Practical consequences include dim lights, motors that fail to start, and cables that overheat dangerously.',
+  },
+  {
+    question: 'What cable size do I need for 12V at 10 metres?',
+    answer:
+      'It depends on the current. For 12V and 10A over 10m, you need at minimum 2.5mm². For 20A, you need 6mm². At low voltage (12V or 24V), voltage drop is far more critical than at 230V because the same wattage demands much higher current.',
+  },
+  {
+    question: 'Can I use 1.5mm² cable throughout my camper van?',
+    answer:
+      'No. 1.5mm² is suitable for light circuits up to about 10A. Sockets and fridges need 2.5mm². High-draw appliances like inverters or cookers need 6mm² or more. Undersized cable is a fire risk.',
+  },
+  {
+    question: 'What is the maximum allowable voltage drop?',
+    answer:
+      'For domestic 230V installations: maximum 3% for lighting circuits, 5% for other circuits. For 12V or 24V systems (solar, camper van, marine): aim for no more than 3% total. Beyond these limits, efficiency falls and overheating risk rises.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Select the system voltage',
+    text: 'Choose 12V, 24V (solar or camper) or 230V (mains) depending on your installation.',
+  },
+  {
+    name: 'Enter the load',
+    text: 'Type the Watts (W) or Amperes (A) that the appliance at the end of the cable will draw.',
+  },
+  {
+    name: 'Set the cable length',
+    text: 'Enter the one-way distance in metres from the power source to the load.',
+  },
+  {
+    name: 'Choose the conductor material',
+    text: 'Select copper (standard) or aluminium to get the correct resistivity in the calculation.',
+  },
+];
+
+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((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: 'en',
+};
+
+export const content: ToolLocaleContent<VoltageDropCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Technical References',
+  bibliography: [
+    { name: 'IEC 60364: Low voltage electrical installations', url: 'https://www.iec.ch/homepage' },
+    { name: 'Voltage drop: Wikipedia', url: 'https://en.wikipedia.org/wiki/Voltage_drop' },
+    { name: 'Electrical resistivity and conductivity: Wikipedia', url: 'https://en.wikipedia.org/wiki/Electrical_resistivity_and_conductivity' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Complete Guide to Voltage Drop in DC and AC Systems', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Whether you are wiring a camper van, designing an off-grid solar system or running cable for garden lighting, there is one invisible enemy that can ruin your project before it starts: <strong>voltage drop</strong>. It is not just a technical nuance — it is the difference between a fridge that cools and one that shuts off, or between a safe installation and a fire hazard.',
+    },
+    { type: 'title', text: 'The Ohm\'s Law Formula Behind the Calculator', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:function-variant',
+      title: 'How Voltage Drop Is Calculated',
+      html: '<p>The formula is <strong>ΔV = (2 × L × I × ρ) / S</strong>. L is the one-way cable length in metres, I is the current in amperes, ρ is resistivity (0.0178 Ω·mm²/m for copper, 0.028 for aluminium), and S is the cable cross-section in mm². The factor of 2 accounts for the current flowing out and back through the cable.</p>',
+    },
+    { type: 'title', text: 'Why 12V Systems Need Thicker Cable Than 230V', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:alert-circle-outline',
+      title: 'The Low Voltage Paradox',
+      html: '<p>To deliver 1000W at 230V you only need 4.3A and a 1.5mm² cable will do the job. To deliver the same 1000W at 12V you need 83.3A, requiring 25mm² cable. The lower the voltage, <strong>the thicker the cable must be</strong> to carry the same power without dangerous losses. This surprises most camper van builders who assume 12V is safe to wire casually.</p>',
+    },
+    { type: 'title', text: 'Real Consequences of Excessive Voltage Drop', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:thermometer-alert',
+      title: 'Heat, Failures and Fire Risk',
+      html: '<p>A cable carrying too much current for its cross-section converts electrical energy into heat. Practical consequences: 12V fridges that shut off because they detect low voltage even with a full battery, LED strips that fade and yellow at the far end, motors that cannot reach rated torque, and in extreme cases, PVC insulation melting and causing fire.</p>',
+    },
+    { type: 'title', text: 'Cable Size Reference for 12V Systems', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Quick reference for 12V DC wiring: <strong>1.5mm²</strong> light circuits up to 10A, <strong>2.5mm²</strong> fridges and USB sockets up to 20A, <strong>6mm²</strong> solar panels up to 40A, <strong>16mm²</strong> secondary battery connections up to 80A, <strong>25mm²</strong> main camper van circuits up to 120A. Always verify with the calculator using your exact wire length and current.',
+    },
+  ],
+  ui: {
+    heroDropLabel: 'Total Voltage Drop',
+    heroVoltsUnit: 'Volts',
+    heroPctLoss: '% loss',
+    heroEffLabel: 'Efficiency',
+    statusExcellent: 'Excellent',
+    statusAcceptable: 'Acceptable',
+    statusCritical: 'Critical',
+    fieldVoltage: 'Voltage',
+    fieldMaterial: 'Material',
+    materialCopper: 'Copper',
+    materialAlum: 'Alum.',
+    fieldLoad: 'Load',
+    modeW: 'W',
+    modeA: 'A',
+    unitWatts: 'Watts',
+    unitAmps: 'Amps',
+    fieldLength: 'Cable Length (One Way)',
+    unitMeters: 'metres',
+    fieldSection: 'Cable Cross Section',
+    sectionInfo: 'Recommended',
+  },
+};

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

@@ -0,0 +1,155 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { VoltageDropCalculatorUI } from '../ui';
+
+const slug = 'calculadora-caida-tension';
+const title = 'Calculadora de Caída de Tensión y Sección de Cable';
+const description =
+  'Herramienta técnica para evitar cables quemados. Calcula la sección necesaria para instalaciones de 12V, 24V y 230V según distancia y potencia. Rápido, preciso y sin registros.';
+
+const faqData = [
+  {
+    question: '¿Qué es la caída de tensión y por qué importa?',
+    answer:
+      'Es la pérdida de voltaje que ocurre cuando la electricidad viaja por un cable. Si el cable es muy fino o muy largo, pierdes voltaje. Resultado: luces tenues, motores que no arrancan, o cables que se calientan peligrosamente.',
+  },
+  {
+    question: '¿Qué sección de cable necesito para 12V a 10 metros?',
+    answer:
+      'Depende de la potencia. Para 12V y 10A a 10m, necesitas mínimo 2.5mm². Para 20A, necesitas 6mm². A bajo voltaje (12V/24V), la caída es mucho más crítica que a 230V.',
+  },
+  {
+    question: '¿Puedo usar cable de 1.5mm² para toda mi instalación?',
+    answer:
+      'No. 1.5mm² es para circuitos de iluminación (máx 10A). Para enchufes necesitas 2.5mm². Para cocina o lavadora necesitas 4mm² o 6mm². Usar cable fino es peligroso y puede causar incendios.',
+  },
+  {
+    question: '¿Cuál es la caída de tensión máxima permitida?',
+    answer:
+      'En instalaciones domésticas (230V): máximo 3% para iluminación, 5% para otros usos. En 12V/24V (autocaravanas, solar): no más del 3% total. Más caída significa pérdida de eficiencia y riesgo de sobrecalentamiento.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Definir el voltaje del sistema',
+    text: 'Selecciona si tu instalación es de 12V, 24V (solar/camper) o 230V (doméstica).',
+  },
+  {
+    name: 'Introducir la intensidad de corriente',
+    text: 'Escribe los Amperios (A) o Vatios (W) que consumirá el aparato al final del cable.',
+  },
+  {
+    name: 'Medir la distancia del cable',
+    text: 'Introduce la longitud de ida del cable en metros desde la fuente de energía hasta el receptor.',
+  },
+  {
+    name: 'Elegir el material del conductor',
+    text: 'Selecciona cobre (estándar) o aluminio para obtener el cálculo exacto de resistividad.',
+  },
+];
+
+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((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<VoltageDropCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias Técnicas',
+  bibliography: [
+    { name: 'IEC 60364: Instalaciones eléctricas de baja tensión', url: 'https://www.iec.ch/homepage' },
+    { name: 'Ley de Ohm y Resistividad: Wikipedia', url: 'https://es.wikipedia.org/wiki/Resistividad' },
+    { name: 'REBT: Reglamento Electrotécnico de Baja Tensión', url: 'https://www.boe.es/eli/es/rd/2002/08/02/842' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Guía Completa de Caída de Tensión', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Si estás camperizando una furgoneta, diseñando una instalación solar o tirando cables para iluminar tu jardín, hay un enemigo invisible que puede arruinar tu proyecto: la <strong>caída de tensión</strong>. No es solo una cuestión técnica; es la diferencia entre una nevera que enfría y una que se apaga, o entre una instalación segura y un riesgo de incendio.',
+    },
+    { type: 'title', text: 'La Fórmula de la Caída de Tensión', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:function-variant',
+      title: 'Cálculo Exacto con la Ley de Ohm',
+      html: '<p>La fórmula es <strong>ΔV = (2 × L × I × ρ) / S</strong>, donde L es la longitud de ida en metros, I la corriente en amperios, ρ la resistividad del material (0,0178 Ω·mm²/m para cobre, 0,028 para aluminio) y S la sección del cable en mm². El factor 2 se debe a que la corriente recorre el cable de ida y de vuelta.</p>',
+    },
+    { type: 'title', text: 'La Paradoja del Bajo Voltaje', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:alert-circle-outline',
+      title: 'Por qué el 12V necesita cables más gruesos que el 230V',
+      html: '<p>Para transportar la misma potencia (1000W), a 230V necesitas solo 4,3A y un cable de 1,5mm². A 12V necesitas 83,3A y un cable de 25mm². Cuanto más bajo es el voltaje, <strong>más grueso debe ser el cable</strong> para transportar la misma energía sin pérdidas peligrosas.</p>',
+    },
+    { type: 'title', text: 'Consecuencias de una Caída Excesiva', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:thermometer-alert',
+      title: 'Calor, Averías e Incendios',
+      html: '<p>Un cable con excesiva caída de tensión convierte la energía eléctrica en calor. Las consecuencias prácticas son: neveras 12V que se apagan creyendo que la batería está baja, tiras LED que se degradan en color hacia el final, motores que no alcanzan su par nominal y, en casos extremos, fusión del PVC y riesgo de incendio.</p>',
+    },
+    { type: 'title', text: 'Tabla de Secciones y Usos Habituales', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Referencia rápida para instalaciones 12V: <strong>1,5mm²</strong> iluminación ligera (hasta 10A), <strong>2,5mm²</strong> neveras y tomas USB (hasta 20A), <strong>6mm²</strong> placas solares (hasta 40A), <strong>16mm²</strong> conexión de baterías auxiliares (hasta 80A), <strong>25mm²</strong> circuitos principales de camper (hasta 120A). Estos valores son orientativos; usa siempre la calculadora con tu longitud y corriente exactas.',
+    },
+  ],
+  ui: {
+    heroDropLabel: 'Caída de Tensión Total',
+    heroVoltsUnit: 'Voltios',
+    heroPctLoss: '% pérdida',
+    heroEffLabel: 'Eficiencia',
+    statusExcellent: 'Excelente',
+    statusAcceptable: 'Aceptable',
+    statusCritical: 'Crítico',
+    fieldVoltage: 'Voltaje',
+    fieldMaterial: 'Material',
+    materialCopper: 'Cobre',
+    materialAlum: 'Alum.',
+    fieldLoad: 'Carga',
+    modeW: 'W',
+    modeA: 'A',
+    unitWatts: 'Vatios',
+    unitAmps: 'Amperios',
+    fieldLength: 'Longitud del Cable (Ida)',
+    unitMeters: 'metros',
+    fieldSection: 'Sección del Cable',
+    sectionInfo: 'Recomendado',
+  },
+};

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

@@ -0,0 +1,148 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { VoltageDropCalculatorUI } from '../ui';
+
+const slug = 'calculateur-chute-tension';
+const title = 'Calculateur de Chute de Tension et Section de Câble';
+const description =
+  'Calculez la chute de tension et la section de câble nécessaire pour vos installations 12V, 24V et 230V. Entrez la puissance, la distance et le matériau du conducteur pour obtenir un résultat précis.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que la chute de tension?',
+    answer:
+      'La chute de tension est la perte de voltage qui se produit lorsque le courant électrique parcourt un câble. Un câble trop fin ou trop long entraîne une perte de tension. Résultat pratique: lumières ternes, moteurs qui ne démarrent pas, câbles qui surchauffent.',
+  },
+  {
+    question: 'Quelle section de câble pour du 12V sur 10 mètres?',
+    answer:
+      'Cela dépend de la puissance. Pour 12V et 10A sur 10m, il faut au minimum 2,5mm². Pour 20A, il faut 6mm². En basse tension (12V/24V), la chute de tension est beaucoup plus critique qu\'en 230V.',
+  },
+  {
+    question: 'Quelle est la chute de tension maximale autorisée?',
+    answer:
+      'Pour les installations domestiques (230V): maximum 3% pour l\'éclairage, 5% pour les autres usages. Pour les systèmes 12V/24V (camping-car, solaire): ne pas dépasser 3% au total. Au-delà, l\'efficacité chute et le risque de surchauffe augmente.',
+  },
+  {
+    question: 'Pourquoi le 12V nécessite des câbles plus épais que le 230V?',
+    answer:
+      'Pour transporter la même puissance (1000W), le 230V nécessite seulement 4,3A et un câble de 1,5mm². Le 12V nécessite 83,3A et un câble de 25mm². Plus la tension est basse, plus le câble doit être épais pour éviter les pertes.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Choisir la tension du système',
+    text: 'Sélectionnez 12V, 24V (solaire/camping-car) ou 230V (réseau) selon votre installation.',
+  },
+  {
+    name: 'Saisir la charge',
+    text: 'Entrez les Watts (W) ou Ampères (A) que consommera l\'appareil en bout de câble.',
+  },
+  {
+    name: 'Mesurer la longueur du câble',
+    text: 'Entrez la distance aller en mètres depuis la source d\'énergie jusqu\'au récepteur.',
+  },
+  {
+    name: 'Choisir le matériau du conducteur',
+    text: 'Sélectionnez cuivre (standard) ou aluminium pour obtenir le calcul de résistivité exact.',
+  },
+];
+
+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((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<VoltageDropCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Références Techniques',
+  bibliography: [
+    { name: 'IEC 60364: Installations électriques basse tension', url: 'https://www.iec.ch/homepage' },
+    { name: 'Chute de tension: Wikipedia', url: 'https://fr.wikipedia.org/wiki/Chute_de_tension' },
+    { name: 'Résistivité électrique: Wikipedia', url: 'https://fr.wikipedia.org/wiki/R%C3%A9sistivit%C3%A9' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Guide Complet sur la Chute de Tension', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Que vous aménagez un van, installez des panneaux solaires ou câblez votre jardin, il existe un ennemi invisible qui peut compromettre votre projet: la <strong>chute de tension</strong>. Ce n\'est pas seulement une question technique; c\'est la différence entre un réfrigérateur qui refroidit et un qui s\'éteint, entre une installation sûre et un risque d\'incendie.',
+    },
+    { type: 'title', text: 'La Formule de Calcul de la Chute de Tension', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:function-variant',
+      title: 'Calcul Exact par la Loi d\'Ohm',
+      html: '<p>La formule est <strong>ΔV = (2 × L × I × ρ) / S</strong>. L est la longueur aller en mètres, I le courant en ampères, ρ la résistivité du matériau (0,0178 Ω·mm²/m pour le cuivre, 0,028 pour l\'aluminium) et S la section du câble en mm². Le facteur 2 correspond au trajet aller-retour du courant.',
+    },
+    { type: 'title', text: 'Le Paradoxe de la Basse Tension', level: 3 },
+    {
+      type: 'card',
+      icon: 'mdi:alert-circle-outline',
+      title: 'Pourquoi le 12V exige des câbles plus épais que le 230V',
+      html: '<p>Pour transporter 1000W à 230V, il suffit de 4,3A et un câble de 1,5mm². Pour les mêmes 1000W à 12V, il faut 83,3A et un câble de 25mm². <strong>Plus la tension est basse, plus le câble doit être épais</strong> pour transporter la même énergie sans pertes dangereuses. C\'est le paradoxe qui surprend la plupart des constructeurs de van.</p>',
+    },
+    { type: 'title', text: 'Sections de Référence pour Installations 12V', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Référence rapide pour le câblage 12V DC: <strong>1,5mm²</strong> éclairage léger jusqu\'à 10A, <strong>2,5mm²</strong> réfrigérateurs et prises USB jusqu\'à 20A, <strong>6mm²</strong> panneaux solaires jusqu\'à 40A, <strong>16mm²</strong> batteries auxiliaires jusqu\'à 80A, <strong>25mm²</strong> circuits principaux de van jusqu\'à 120A. Utilisez toujours le calculateur avec votre longueur et courant exacts.',
+    },
+  ],
+  ui: {
+    heroDropLabel: 'Chute de Tension Totale',
+    heroVoltsUnit: 'Volts',
+    heroPctLoss: '% de perte',
+    heroEffLabel: 'Efficacité',
+    statusExcellent: 'Excellent',
+    statusAcceptable: 'Acceptable',
+    statusCritical: 'Critique',
+    fieldVoltage: 'Tension',
+    fieldMaterial: 'Matériau',
+    materialCopper: 'Cuivre',
+    materialAlum: 'Alum.',
+    fieldLoad: 'Charge',
+    modeW: 'W',
+    modeA: 'A',
+    unitWatts: 'Watts',
+    unitAmps: 'Ampères',
+    fieldLength: 'Longueur du Câble (Aller)',
+    unitMeters: 'mètres',
+    fieldSection: 'Section du Câble',
+    sectionInfo: 'Recommandé',
+  },
+};

package/src/tool/voltageDropCalculator/index.ts

@@ -0,0 +1,28 @@
+import VoltageDropCalculatorComponent from './component.astro';
+import VoltageDropCalculatorSEO from './seo.astro';
+import VoltageDropCalculatorBibliography from './bibliography.astro';
+import type { DiyToolEntry, ToolDefinition } from '../../types';
+import type { VoltageDropCalculatorUI } from './ui';
+
+export {
+  VoltageDropCalculatorComponent,
+  VoltageDropCalculatorSEO,
+  VoltageDropCalculatorBibliography,
+};
+
+const es = async () => (await import('./i18n/es')).content;
+const en = async () => (await import('./i18n/en')).content;
+const fr = async () => (await import('./i18n/fr')).content;
+
+export const voltageDropCalculator: DiyToolEntry<VoltageDropCalculatorUI> = {
+  id: 'voltage-drop-calculator',
+  icons: { bg: 'mdi:flash', fg: 'mdi:cable-data' },
+  i18n: { es, en, fr },
+};
+
+export const VOLTAGE_DROP_CALCULATOR_TOOL: ToolDefinition = {
+  entry: voltageDropCalculator,
+  Component: VoltageDropCalculatorComponent,
+  SEOComponent: VoltageDropCalculatorSEO,
+  BibliographyComponent: VoltageDropCalculatorBibliography,
+};

package/src/tool/voltageDropCalculator/seo.astro

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

package/src/tool/voltageDropCalculator/ui.ts

@@ -0,0 +1,22 @@
+export interface VoltageDropCalculatorUI extends Record<string, string> {
+  heroDropLabel: string;
+  heroVoltsUnit: string;
+  heroPctLoss: string;
+  heroEffLabel: string;
+  statusExcellent: string;
+  statusAcceptable: string;
+  statusCritical: string;
+  fieldVoltage: string;
+  fieldMaterial: string;
+  materialCopper: string;
+  materialAlum: string;
+  fieldLoad: string;
+  modeW: string;
+  modeA: string;
+  unitWatts: string;
+  unitAmps: string;
+  fieldLength: string;
+  unitMeters: string;
+  fieldSection: string;
+  sectionInfo: string;
+}

package/src/tools.ts

@@ -0,0 +1,16 @@
+import type { ToolDefinition } from './types';
+import { CLAY_CALCULATOR_TOOL } from './tool/clayCalculator/index';
+import { EPOXY_CALCULATOR_TOOL } from './tool/epoxyCalculator/index';
+import { BALUSTER_CALCULATOR_TOOL } from './tool/balusterCalculator/index';
+import { MORTAR_CALCULATOR_TOOL } from './tool/mortarCalculator/index';
+import { PASSEPARTOUT_CALCULATOR_TOOL } from './tool/passepartoutCalculator/index';
+import { CONCRETE_CALCULATOR_TOOL } from './tool/concreteCalculator/index';
+import { CUT_OPTIMIZER_TOOL } from './tool/cutOptimizer/index';
+import { VOLTAGE_DROP_CALCULATOR_TOOL } from './tool/voltageDropCalculator/index';
+import { FURNITURE_FIT_TOOL } from './tool/furnitureFit/index';
+import { THERMAL_EXPANSION_CALCULATOR_TOOL } from './tool/thermalExpansionCalculator/index';
+import { DRILL_CALCULATOR_TOOL } from './tool/drillCalculator/index';
+import { STAIR_CALCULATOR_TOOL } from './tool/stairCalculator/index';
+import { DRILL_SHARPENER_TOOL } from './tool/drillSharpener/index';
+
+export const ALL_TOOLS: ToolDefinition[] = [CLAY_CALCULATOR_TOOL, EPOXY_CALCULATOR_TOOL, BALUSTER_CALCULATOR_TOOL, MORTAR_CALCULATOR_TOOL, PASSEPARTOUT_CALCULATOR_TOOL, CONCRETE_CALCULATOR_TOOL, CUT_OPTIMIZER_TOOL, VOLTAGE_DROP_CALCULATOR_TOOL, FURNITURE_FIT_TOOL, THERMAL_EXPANSION_CALCULATOR_TOOL, DRILL_CALCULATOR_TOOL, STAIR_CALCULATOR_TOOL, DRILL_SHARPENER_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 DiyToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface DiyCategoryEntry {
+  icon: string;
+  tools: DiyToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: DiyToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+