@jjlmoya/utils-hardware 1.26.0 → 1.27.0

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

@@ -0,0 +1,169 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UsbPowerBudgetCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'usb-power-budget-calculator';
+const title = 'USB Power Budget Calculator';
+const description = 'Check whether a USB port, charger, hub, cable, or USB-C PD profile can safely power your devices after headroom and cable voltage drop.';
+
+const faqData = [
+  {
+    question: 'How do I know if a USB port can power my device?',
+    answer: 'Compare the total device wattage with the USB source wattage, then reserve headroom and estimate cable voltage drop. A setup can fail even when nominal watts look high if the cable is long, thin, or carrying high current at 5 volts.',
+  },
+  {
+    question: 'Why does cable length matter for USB power?',
+    answer: 'Current flowing through copper creates voltage drop. Long cables and thin conductors have more resistance, so the device may receive less voltage than the charger provides. This is especially important for Raspberry Pi boards, hard drives, LED strips, docks, and bus-powered hubs.',
+  },
+  {
+    question: 'What headroom should I use?',
+    answer: 'Use at least 20 percent for normal electronics, 30 percent for motors, drives, radios, or boards with burst loads, and more if the adapter quality is unknown or the device must run continuously.',
+  },
+  {
+    question: 'Can this replace USB-C PD negotiation testing?',
+    answer: 'No. The calculator checks the electrical budget. It does not verify whether a charger, cable e-marker, device, or hub actually negotiates a specific Power Delivery profile.',
+  },
+];
+
+const howToData = [
+  { name: 'Choose a source profile', text: 'Select a common USB or USB-C PD profile, or edit voltage and current manually.' },
+  { name: 'Describe the cable', text: 'Enter cable length and conductor gauge. Thin high-number AWG wires cause more voltage drop.' },
+  { name: 'Add the load', text: 'Enter one device load in watts and the number of devices sharing the same source.' },
+  { name: 'Read the status', text: 'Use the status, cable drop, end voltage, utilization, and headroom to decide whether the setup is safe.' },
+];
+
+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: 'USD' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    { type: 'title', text: 'USB power is a budget, not a label', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'A USB charger marked 15 W, 45 W, or 100 W describes what the source can offer under the right conditions. Your device only sees the result after protocol negotiation, current limits, cable resistance, connector quality, hub losses, and load spikes. This calculator focuses on the practical electrical question: after cable drop and reserve margin, is there enough power left for the hardware you want to run?',
+    },
+    {
+      type: 'stats',
+      items: [
+        { label: 'USB 2.0 default current', value: '0.5 A' },
+        { label: 'USB-C default maximum at 5 V', value: '3 A' },
+        { label: 'Recommended reserve', value: '20%+' },
+      ],
+    },
+    { type: 'title', text: 'How to interpret the result', level: 3 },
+    {
+      type: 'table',
+      headers: ['Status', 'Meaning', 'Best next step'],
+      rows: [
+        ['Safe', 'The load fits inside the source rating after the selected reserve, and the estimated device voltage remains healthy.', 'Use the setup, but keep an eye on heat if the adapter is small or enclosed.'],
+        ['Tight', 'The load is close to the reserved limit or the cable drop is becoming meaningful.', 'Shorten the cable, choose thicker conductors, reduce the load, or move to a higher power profile.'],
+        ['Over budget', 'The load exceeds the usable source power or the device-end voltage is likely too low.', 'Use a stronger charger, powered hub, shorter cable, or a device that negotiates a higher USB-C PD voltage.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'When watts are enough but the device still resets',
+      html: '<p>Startup current can be much higher than the average wattage printed on a device label. A 5 V supply loses voltage faster than a 20 V PD profile for the same wattage because it must carry more current. Many low-cost cables use thin power conductors even when the outer jacket looks substantial, and bus-powered hubs share one upstream budget across every downstream device.</p>',
+    },
+    { type: 'title', text: 'Cable voltage drop in plain terms', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Voltage drop is the loss created when current flows through cable resistance. USB power has two conductors in the power path, so the calculator uses round-trip length. A one-meter cable is electrically two meters of copper for the power loop. Lower AWG numbers are thicker and usually better for high current loads.',
+    },
+    {
+      type: 'comparative',
+      items: [
+        { title: 'Short thick cable', description: 'Best for Raspberry Pi boards, SSD enclosures, development kits, and USB-C docks that draw burst current.' },
+        { title: 'Long thin cable', description: 'Acceptable for low power sensors or charging slowly, but risky for drives, LED loads, and compute boards.' },
+        { title: 'Higher voltage PD', description: 'Reduces current for the same wattage, which lowers cable loss, but only if the source, cable, and device negotiate it.' },
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Practical rule',
+      html: 'If the calculator says the setup is tight, treat it as a field warning. USB failures often appear as random disconnects, brownouts, slow charging, noisy audio, or storage errors before they look like a clear power problem.',
+    },
+    {
+      type: 'summary',
+      title: 'What this calculator is best for',
+      items: [
+        'Planning USB hubs, single-board computers, external drives, development boards, lights, fans, and small lab setups.',
+        'Comparing USB 2.0, USB 3.x, USB-C, and USB Power Delivery source profiles.',
+        'Estimating whether a cable is too long or too thin for a load.',
+        'Choosing a sensible reserve before buying a charger or powered hub.',
+      ],
+    },
+  ],
+  ui: {
+    profileLabel: 'USB source profile',
+    metricUnits: 'Metric',
+    imperialUnits: 'US',
+    voltageLabel: 'Source voltage (V)',
+    currentLabel: 'Source current (A)',
+    cableLengthLabel: 'Cable length',
+    wireGaugeLabel: 'Power wire gauge',
+    deviceLoadLabel: 'Load per device (W)',
+    devicesLabel: 'Devices',
+    headroomLabel: 'Reserve headroom (%)',
+    sourcePower: 'Source power',
+    requiredPower: 'Required power',
+    cableDrop: 'Cable drop',
+    deviceVoltage: 'Device voltage',
+    headroom: 'Headroom',
+    utilization: 'Utilization',
+    safeStatus: 'Power budget looks safe',
+    tightStatus: 'Power budget is tight',
+    overStatus: 'Over budget or voltage drop risk',
+    safeAdvice: 'The load fits with the selected reserve. Use a quality cable and check heat during long runs.',
+    tightAdvice: 'You are close to the limit. Reduce cable length, use thicker conductors, lower the load, or select a stronger profile.',
+    overAdvice: 'This setup is likely to brown out or throttle. Use a powered hub, stronger adapter, or a higher voltage USB-C PD profile.',
+    busLane: 'USB source',
+    loadLane: 'Device load',
+    cableLane: 'drop',
+    boardEyebrow: 'Live USB power path',
+    sourceSocket: 'Supply socket',
+    deviceSocket: 'Hardware load',
+    energyFlow: 'energy flow',
+    reservedLabel: 'usable after reserve',
+  },
+};

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

@@ -0,0 +1,169 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UsbPowerBudgetCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'calculadora-presupuesto-energia-usb';
+const title = 'Calculadora de Presupuesto de Energía USB';
+const description = 'Comprueba si un puerto USB, cargador, hub, cable o perfil USB-C PD puede alimentar tus dispositivos de forma segura tras considerar el margen de reserva y la caída de tensión del cable.';
+
+const faqData = [
+  {
+    question: '¿Cómo sé si un puerto USB puede alimentar mi dispositivo?',
+    answer: 'Compara la potencia total del dispositivo con la potencia de la fuente USB, reserva un margen de seguridad y estima la caída de tensión del cable. Una configuración puede fallar incluso cuando los vatios nominales parecen altos si el cable es largo, fino o transporta alta corriente a 5 voltios.',
+  },
+  {
+    question: '¿Por qué importa la longitud del cable para la alimentación USB?',
+    answer: 'La corriente que fluye por el cobre crea una caída de tensión. Los cables largos y los conductores finos tienen más resistencia, por lo que el dispositivo puede recibir menos tensión de la que proporciona el cargador. Esto es especialmente importante para placas Raspberry Pi, discos duros, tiras LED, docks y hubs autoalimentados por bus.',
+  },
+  {
+    question: '¿Qué margen de reserva debo usar?',
+    answer: 'Usa al menos un 20 por ciento para electrónica normal, un 30 por ciento para motores, unidades, radios o placas con cargas de ráfaga, y más si la calidad del adaptador es desconocida o el dispositivo debe funcionar de forma continua.',
+  },
+  {
+    question: '¿Puede esto reemplazar las pruebas de negociación USB-C PD?',
+    answer: 'No. La calculadora verifica el presupuesto eléctrico. No verifica si un cargador, e-marker de cable, dispositivo o hub negocia realmente un perfil de Power Delivery específico.',
+  },
+];
+
+const howToData = [
+  { name: 'Elige un perfil de fuente', text: 'Selecciona un perfil USB o USB-C PD común, o edita la tensión y corriente manualmente.' },
+  { name: 'Describe el cable', text: 'Introduce la longitud del cable y el calibre del conductor. Los cables finos de alto AWG causan más caída de tensión.' },
+  { name: 'Añade la carga', text: 'Introduce una carga de dispositivo en vatios y el número de dispositivos que comparten la misma fuente.' },
+  { name: 'Lee el estado', text: 'Usa el estado, la caída del cable, la tensión final, la utilización y el margen para decidir si la configuración es segura.' },
+];
+
+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: 'USD' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    { type: 'title', text: 'La energía USB es un presupuesto, no una etiqueta', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Un cargador USB marcado como 15 W, 45 W o 100 W describe lo que la fuente puede ofrecer en condiciones ideales. Tu dispositivo solo ve el resultado tras la negociación del protocolo, los límites de corriente, la resistencia del cable, la calidad del conector, las pérdidas del hub y los picos de carga. Esta calculadora se centra en la pregunta eléctrica práctica: tras la caída del cable y el margen de reserva, ¿queda suficiente energía para el hardware que quieres usar?',
+    },
+    {
+      type: 'stats',
+      items: [
+        { label: 'Corriente predeterminada USB 2.0', value: '0,5 A' },
+        { label: 'Máximo predeterminado USB-C a 5 V', value: '3 A' },
+        { label: 'Reserva recomendada', value: '20%+' },
+      ],
+    },
+    { type: 'title', text: 'Cómo interpretar el resultado', level: 3 },
+    {
+      type: 'table',
+      headers: ['Estado', 'Significado', 'Mejor paso siguiente'],
+      rows: [
+        ['Seguro', 'La carga encaja dentro de la capacidad de la fuente tras la reserva seleccionada y la tensión estimada del dispositivo se mantiene saludable.', 'Usa la configuración, pero vigila el calor si el adaptador es pequeño o está encerrado.'],
+        ['Ajustado', 'La carga está cerca del límite reservado o la caída del cable empieza a ser significativa.', 'Acorta el cable, elige conductores más gruesos, reduce la carga o pasa a un perfil de mayor potencia.'],
+        ['Sobrepresupuesto', 'La carga supera la potencia útil de la fuente o la tensión en el dispositivo probablemente sea demasiado baja.', 'Usa un cargador más potente, un hub alimentado, un cable más corto o un dispositivo que negocie una tensión USB-C PD más alta.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Cuando los vatios son suficientes pero el dispositivo aún se reinicia',
+      html: '<p>La corriente de arranque puede ser mucho mayor que la potencia media impresa en la etiqueta del dispositivo. Una fuente de 5 V pierde tensión más rápido que un perfil PD de 20 V para la misma potencia porque debe transportar más corriente. Muchos cables baratos usan conductores de potencia finos incluso cuando la cubierta exterior parece gruesa, y los hubs autoalimentados por bus comparten un presupuesto de subida entre todos los dispositivos conectados.</p>',
+    },
+    { type: 'title', text: 'Caída de tensión del cable en términos simples', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'La caída de tensión es la pérdida creada cuando la corriente fluye a través de la resistencia del cable. La alimentación USB tiene dos conductores en el camino de potencia, por lo que la calculadora usa la longitud de ida y vuelta. Un cable de un metro equivale eléctricamente a dos metros de cobre para el bucle de potencia. Los números AWG más bajos son más gruesos y generalmente mejores para cargas de alta corriente.',
+    },
+    {
+      type: 'comparative',
+      items: [
+        { title: 'Cable corto y grueso', description: 'Ideal para placas Raspberry Pi, carcasas SSD, kits de desarrollo y docks USB-C que consumen corriente de ráfaga.' },
+        { title: 'Cable largo y fino', description: 'Aceptable para sensores de bajo consumo o carga lenta, pero arriesgado para unidades, cargas LED y placas de computación.' },
+        { title: 'PD de mayor tensión', description: 'Reduce la corriente para la misma potencia, lo que disminuye la pérdida del cable, pero solo si la fuente, el cable y el dispositivo lo negocian.' },
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Regla práctica',
+      html: 'Si la calculadora dice que la configuración está ajustada, trátalo como una advertencia de campo. Los fallos USB a menudo aparecen como desconexiones aleatorias, caídas de tensión, carga lenta, audio con ruido o errores de almacenamiento antes de parecer un problema claro de alimentación.',
+    },
+    {
+      type: 'summary',
+      title: 'Para qué sirve mejor esta calculadora',
+      items: [
+        'Planificar hubs USB, ordenadores de placa única, unidades externas, placas de desarrollo, luces, ventiladores y pequeñas configuraciones de laboratorio.',
+        'Comparar perfiles de fuente USB 2.0, USB 3.x, USB-C y USB Power Delivery.',
+        'Estimar si un cable es demasiado largo o demasiado fino para una carga.',
+        'Elegir una reserva sensata antes de comprar un cargador o hub alimentado.',
+      ],
+    },
+  ],
+  ui: {
+    profileLabel: 'Perfil de fuente USB',
+    metricUnits: 'Métrico',
+    imperialUnits: 'EE. UU.',
+    voltageLabel: 'Tensión de fuente (V)',
+    currentLabel: 'Corriente de fuente (A)',
+    cableLengthLabel: 'Longitud del cable',
+    wireGaugeLabel: 'Calibre del cable de potencia',
+    deviceLoadLabel: 'Carga por dispositivo (W)',
+    devicesLabel: 'Dispositivos',
+    headroomLabel: 'Margen de reserva (%)',
+    sourcePower: 'Potencia de fuente',
+    requiredPower: 'Potencia requerida',
+    cableDrop: 'Caída del cable',
+    deviceVoltage: 'Tensión del dispositivo',
+    headroom: 'Margen',
+    utilization: 'Utilización',
+    safeStatus: 'El presupuesto de energía parece seguro',
+    tightStatus: 'El presupuesto de energía está ajustado',
+    overStatus: 'Sobrepresupuesto o riesgo de caída de tensión',
+    safeAdvice: 'La carga encaja con el margen seleccionado. Usa un cable de calidad y comprueba el calor en funcionamientos largos.',
+    tightAdvice: 'Estás cerca del límite. Reduce la longitud del cable, usa conductores más gruesos, baja la carga o selecciona un perfil más potente.',
+    overAdvice: 'Es probable que esta configuración sufra caídas de tensión o limitación. Usa un hub alimentado, un adaptador más potente o un perfil USB-C PD de mayor tensión.',
+    busLane: 'Fuente USB',
+    loadLane: 'Carga del dispositivo',
+    cableLane: 'caída',
+    boardEyebrow: 'Ruta de energía USB en vivo',
+    sourceSocket: 'Conector de fuente',
+    deviceSocket: 'Carga de hardware',
+    energyFlow: 'flujo de energía',
+    reservedLabel: 'utilizable tras reserva',
+  },
+};

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

@@ -0,0 +1,169 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { UsbPowerBudgetCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'calculateur-budget-alimentation-usb';
+const title = 'Calculateur de Budget d\'Alimentation USB';
+const description = 'Vérifiez si un port USB, chargeur, hub, câble ou profil USB-C PD peut alimenter vos appareils en toute sécurité après marge de réserve et chute de tension du câble.';
+
+const faqData = [
+  {
+    question: 'Comment savoir si un port USB peut alimenter mon appareil?',
+    answer: 'Comparez la puissance totale de l\'appareil avec la puissance de la source USB, réservez une marge de sécurité et estimez la chute de tension du câble. Une configuration peut échouer même lorsque les watts nominaux semblent élevés si le câble est long, fin ou transporte un courant élevé à 5 volts.',
+  },
+  {
+    question: 'Pourquoi la longueur du câble est-elle importante pour l\'alimentation USB?',
+    answer: 'Le courant traversant le cuivre crée une chute de tension. Les câbles longs et les conducteurs fins ont plus de résistance, de sorte que l\'appareil peut recevoir moins de tension que ce que fournit le chargeur. Ceci est particulièrement important pour les cartes Raspberry Pi, les disques durs, les bandes LED, les docks et les hubs alimentés par bus.',
+  },
+  {
+    question: 'Quelle marge de réserve dois-je utiliser?',
+    answer: 'Utilisez au moins 20 pour cent pour l\'électronique normale, 30 pour cent pour les moteurs, les lecteurs, les radios ou les cartes avec des charges en rafale, et plus si la qualité de l\'adaptateur est inconnue ou si l\'appareil doit fonctionner en continu.',
+  },
+  {
+    question: 'Cela peut-il remplacer les tests de négociation USB-C PD?',
+    answer: 'Non. Le calculateur vérifie le budget électrique. Il ne vérifie pas si un chargeur, un e-marker de câble, un appareil ou un hub négocie réellement un profil Power Delivery spécifique.',
+  },
+];
+
+const howToData = [
+  { name: 'Choisir un profil source', text: 'Sélectionnez un profil USB ou USB-C PD courant, ou modifiez la tension et le courant manuellement.' },
+  { name: 'Décrire le câble', text: 'Entrez la longueur du câble et le calibre du conducteur. Les fils fins à AWG élevé causent plus de chute de tension.' },
+  { name: 'Ajouter la charge', text: 'Entrez une charge d\'appareil en watts et le nombre d\'appareils partageant la même source.' },
+  { name: 'Lire le statut', text: 'Utilisez le statut, la chute du câble, la tension finale, l\'utilisation et la marge pour décider si la configuration est sûre.' },
+];
+
+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: 'USD' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<UsbPowerBudgetCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    { type: 'title', text: 'L\'alimentation USB est un budget, pas une étiquette', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Un chargeur USB marqué 15 W, 45 W ou 100 W décrit ce que la source peut offrir dans les bonnes conditions. Votre appareil ne voit que le résultat après la négociation du protocole, les limites de courant, la résistance du câble, la qualité du connecteur, les pertes du hub et les pics de charge. Ce calculateur se concentre sur la question électrique pratique: après la chute du câble et la marge de réserve, reste-t-il assez de puissance pour le matériel que vous voulez faire fonctionner?',
+    },
+    {
+      type: 'stats',
+      items: [
+        { label: 'Courant par défaut USB 2.0', value: '0,5 A' },
+        { label: 'Maximum par défaut USB-C à 5 V', value: '3 A' },
+        { label: 'Réserve recommandée', value: '20%+' },
+      ],
+    },
+    { type: 'title', text: 'Comment interpréter le résultat', level: 3 },
+    {
+      type: 'table',
+      headers: ['Statut', 'Signification', 'Meilleure étape suivante'],
+      rows: [
+        ['Sûr', 'La charge tient dans la capacité de la source après la réserve choisie et la tension estimée de l\'appareil reste saine.', 'Utilisez la configuration, mais surveillez la chaleur si l\'adaptateur est petit ou enfermé.'],
+        ['Juste', 'La charge est proche de la limite réservée ou la chute du câble devient significative.', 'Raccourcissez le câble, choisissez des conducteurs plus épais, réduisez la charge ou passez à un profil de puissance supérieur.'],
+        ['Dépassement', 'La charge dépasse la puissance utile de la source ou la tension côté appareil est probablement trop basse.', 'Utilisez un chargeur plus puissant, un hub alimenté, un câble plus court ou un appareil qui négocie une tension USB-C PD plus élevée.'],
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Quand les watts suffisent mais que l\'appareil redémarre quand même',
+      html: '<p>Le courant de démarrage peut être bien supérieur à la puissance moyenne imprimée sur l\'étiquette d\'un appareil. Une alimentation 5 V perd de la tension plus rapidement qu\'un profil PD 20 V pour la même puissance car elle doit transporter plus de courant. De nombreux câbles bon marché utilisent des conducteurs de puissance fins même lorsque la gaine extérieure semble épaisse, et les hubs alimentés par bus partagent un budget amont entre tous les appareils aval.</p>',
+    },
+    { type: 'title', text: 'La chute de tension du câble en termes simples', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'La chute de tension est la perte créée lorsque le courant traverse la résistance du câble. L\'alimentation USB a deux conducteurs dans le chemin de puissance, le calculateur utilise donc la longueur aller-retour. Un câble d\'un mètre représente électriquement deux mètres de cuivre pour la boucle d\'alimentation. Les numéros AWG plus bas sont plus épais et généralement meilleurs pour les charges à courant élevé.',
+    },
+    {
+      type: 'comparative',
+      items: [
+        { title: 'Câble court et épais', description: 'Idéal pour les cartes Raspberry Pi, les boîtiers SSD, les kits de développement et les docks USB-C qui consomment du courant en rafale.' },
+        { title: 'Câble long et fin', description: 'Acceptable pour les capteurs basse consommation ou la charge lente, mais risqué pour les lecteurs, les charges LED et les cartes de calcul.' },
+        { title: 'PD à tension plus élevée', description: 'Réduit le courant pour la même puissance, ce qui diminue la perte du câble, mais seulement si la source, le câble et l\'appareil le négocient.' },
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Règle pratique',
+      html: 'Si le calculateur indique que la configuration est juste, traitez-le comme un avertissement de terrain. Les pannes USB apparaissent souvent comme des déconnexions aléatoires, des baisses de tension, une charge lente, un bruit audio ou des erreurs de stockage avant de ressembler à un problème d\'alimentation clair.',
+    },
+    {
+      type: 'summary',
+      title: 'À quoi ce calculateur est le mieux adapté',
+      items: [
+        'Planifier des hubs USB, des ordinateurs monocarte, des lecteurs externes, des cartes de développement, des lumières, des ventilateurs et de petites configurations de laboratoire.',
+        'Comparer les profils source USB 2.0, USB 3.x, USB-C et USB Power Delivery.',
+        'Estimer si un câble est trop long ou trop fin pour une charge.',
+        'Choisir une réserve raisonnable avant d\'acheter un chargeur ou un hub alimenté.',
+      ],
+    },
+  ],
+  ui: {
+    profileLabel: 'Profil source USB',
+    metricUnits: 'Métrique',
+    imperialUnits: 'US',
+    voltageLabel: 'Tension source (V)',
+    currentLabel: 'Courant source (A)',
+    cableLengthLabel: 'Longueur du câble',
+    wireGaugeLabel: 'Calibre du fil d\'alimentation',
+    deviceLoadLabel: 'Charge par appareil (W)',
+    devicesLabel: 'Appareils',
+    headroomLabel: 'Marge de réserve (%)',
+    sourcePower: 'Puissance source',
+    requiredPower: 'Puissance requise',
+    cableDrop: 'Chute du câble',
+    deviceVoltage: 'Tension appareil',
+    headroom: 'Marge',
+    utilization: 'Utilisation',
+    safeStatus: 'Le budget d\'alimentation semble sûr',
+    tightStatus: 'Le budget d\'alimentation est juste',
+    overStatus: 'Dépassement ou risque de chute de tension',
+    safeAdvice: 'La charge convient avec la marge choisie. Utilisez un câble de qualité et vérifiez la chaleur pendant les longues sessions.',
+    tightAdvice: 'Vous êtes proche de la limite. Réduisez la longueur du câble, utilisez des conducteurs plus épais, diminuez la charge ou choisissez un profil plus puissant.',
+    overAdvice: 'Cette configuration risque de subir des baisses de tension ou de l\'étranglement. Utilisez un hub alimenté, un adaptateur plus puissant ou un profil USB-C PD à tension plus élevée.',
+    busLane: 'Source USB',
+    loadLane: 'Charge appareil',
+    cableLane: 'chute',
+    boardEyebrow: 'Chemin d\'alimentation USB en direct',
+    sourceSocket: 'Prise source',
+    deviceSocket: 'Charge matérielle',
+    energyFlow: 'flux d\'énergie',
+    reservedLabel: 'utilisable après réserve',
+  },
+};