@jjlmoya/utils-hardware 1.18.0 → 1.19.0

package/src/tool/mouseDoubleClickTest/i18n/de.ts

@@ -0,0 +1,274 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { MouseDoubleClickTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'maus-doppelklick-test';
+const title = 'Maus Doppelklick Test';
+const description =
+  'Testen Sie jede Maustaste und erkennen Sie unerwünschte Doppelklicks, verschlissene Schalter und Kontaktprellen mit zeitgenauer Aufzeichnung pro Taste in Ihrem Browser.';
+
+const faqData = [
+  {
+    question: 'Was ist ein Maus-Doppelklick-Problem?',
+    answer:
+      'Ein Doppelklick-Problem tritt auf, wenn ein physischer Tastendruck als zwei Klicks gemeldet wird. Es kann die linke Taste, die rechte Taste, den Radklick oder die Seitentasten betreffen und wird meist durch Schalterverschleiß, Kontaktprellen, Firmware-Entprellungseinstellungen oder drahtlose Signalinstabilität verursacht.',
+  },
+  {
+    question: 'Welcher Abstand gilt als verdächtig?',
+    answer:
+      'Sehr kurze Abstände zwischen Klicks sind verdächtig, da menschliche Doppelklicks normalerweise mehr Zeit benötigen. Dieses Tool startet mit einem Schwellenwert von 80 ms, den Sie je nach Maus und Teststil anpassen können.',
+  },
+  {
+    question: 'Kann ein Browser beweisen, dass der Schalter defekt ist?',
+    answer:
+      'Ein Browser kann den elektrischen Schalter nicht direkt prüfen, aber er kann die Klickereignisse aufzeichnen, die Ihr Betriebssystem empfängt. Wiederholte verdächtige Abstände während eines Einzelklick-Tests sind starke Hinweise auf Prellen oder unerwünschtes Doppelklicken.',
+  },
+  {
+    question: 'Wie sollte ich richtig testen?',
+    answer:
+      'Klicken Sie langsam und bewusst und zielen Sie auf einzelne Tastendrücke ab. Wenn der Verdächtig-Zähler auch dann steigt, wenn Sie nicht absichtlich doppelklicken, wiederholen Sie den Test an einem anderen USB-Anschluss, einem anderen Browser und wenn möglich an einem anderen Computer.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Erkennungsschwelle einstellen',
+    text: 'Beginnen Sie mit 80 ms. Senken Sie den Wert für eine strenge Prellungserkennung oder erhöhen Sie ihn, wenn Ihr Gerät etwas breitere versehentliche Abstände erzeugt.',
+  },
+  {
+    name: 'Wie ein normaler Einzelklick klicken',
+    text: 'Drücken Sie jede Maustaste einzeln über der Mausgrafik. Klicken Sie beim ersten Durchlauf nicht absichtlich doppelt.',
+  },
+  {
+    name: 'Verdächtig-Zähler beobachten',
+    text: 'Wenn während des Einfachklickens verdächtige Ereignisse auftreten, prüfen Sie, welche visuelle Taste hervorgehoben wurde, und vergleichen Sie dies mit den kompakten Ereignischips.',
+  },
+  {
+    name: 'Mit einem anderen Gerät vergleichen',
+    text: 'Eine gesunde Maus sollte bei gleichem Schwellenwert eine hohe Punktzahl behalten. Der Vergleich von Geräten hilft, Hardwarefehler von Softwareeinstellungen zu unterscheiden.',
+  },
+];
+
+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: 'de',
+};
+
+export const content: ToolLocaleContent<MouseDoubleClickTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    {
+      type: 'title',
+      text: 'Maus Doppelklick Test: Tastenprellen online diagnostizieren',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Eine Maus, die bei einmaligem Drücken doppelt klickt, ist nicht nur ärgerlich. Sie kann versehentlich Ordner öffnen, Drag-and-Drop-Aktionen abbrechen, in Spielen zwei Schüsse abfeuern, Browser-Tabs schließen oder Kontextmenüs erscheinen und verschwinden lassen, bevor Sie sie nutzen können. Dieser Online-Maus-Doppelklick-Test konzentriert sich auf das nützliche Diagnosesignal: <strong>den zeitlichen Abstand zwischen den von Ihrem Betriebssystem gemeldeten Tastenereignissen</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Anders als ein einfacher Klick-Zähler verfolgt dieses Tool jede Taste unabhängig: linker Klick, rechter Klick, Radklick, Browser-Zurück und Browser-Vorwärts. Das ist wichtig, denn eine Maus kann eine defekte rechte Taste haben, während die linke noch funktioniert, oder eine abgenutzte Seitentaste, die erst nach Monaten des Gamings oder der Nutzung von Produktivitäts-Shortcuts Fehlauslösungen zeigt.',
+    },
+    {
+      type: 'title',
+      text: 'Was dieser Maustasten-Test misst',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Wenn Sie eine Maustaste drücken, empfängt der Browser ein Pointer-Ereignis mit dem Tastencode. Das Tool speichert den letzten Zeitstempel für dieselbe physische Taste und vergleicht ihn mit dem nächsten Druck derselben Taste. Ist der Abstand kürzer als Ihr gewählter Schwellenwert, wird das Ereignis als verdächtig markiert, da ein normaler beabsichtigter zweiter Klick in der Regel länger dauert.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Linke Taste: nützlich zur Erkennung versehentlicher Doppelklicks beim Öffnen von Dateien, Markieren von Text oder Verschieben von Fenstern',
+        'Rechte Taste: nützlich, wenn Kontextmenüs flackern, doppelt erscheinen oder sofort schließen',
+        'Radklick: nützlich bei Mäusen, bei denen der Mittelklick mehrere Tabs öffnet oder nach intensiver Nutzung ausfällt',
+        'Zurück- und Vorwärtstasten: nützlich für Gaming-Mäuse und Produktivitätsmäuse mit Seitenschaltern',
+        'Zeitmessung pro Taste: vermeidet, einen Linksklick mit einem Rechtsklick zu vermischen und als falschen Doppelklick zu werten',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Warum Mäuse anfangen doppelt zu klicken',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Die meisten Mäuse verwenden kleine mechanische Schalter unter jeder Taste. Wenn die Schaltkontakte schließen, kann das Metall für einen sehr kurzen Zeitraum elektrisch prellen, bevor es sich setzt. Die Maus-Firmware filtert dieses Rauschen normalerweise mit einer Entprell-Logik. Wenn der Schalter verschleißt, kann das Prellen länger, lauter oder inkonsistenter werden, sodass der Computer zwei Tastendrücke empfängt, obwohl Ihr Finger nur einen physischen Druck ausgeführt hat.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Doppelklicken wird nicht immer durch dasselbe verursacht. Es kann mechanischer Schalterverschleiß, zu aggressiv eingestellte Firmware-Entprellung, Staub oder Oxidation im Schalter, drahtlose Paketinstabilität, Makro-Software, ein beschädigtes Kabel oder eine Betriebssystemeinstellung sein, die versehentliche Doppelklicks auffälliger macht.',
+    },
+    {
+      type: 'table',
+      headers: ['Symptom', 'Wahrscheinliche Ursache', 'Was zu testen ist'],
+      rows: [
+        ['Ein Klick öffnet Dateien, als wäre doppelt geklickt worden', 'Linkes Schalterprellen oder Verwechslung der Doppelklick-Geschwindigkeit im Betriebssystem', 'Linke Taste mit langsamen Einzeldrücken bei 80 ms testen'],
+        ['Rechtsklick-Menü flackert oder schließt sich', 'Rechtes Schalterprellen oder Software, die Kontextmenüs abfängt', 'Rechte Taste testen und Maus-Dienstprogramme vorübergehend deaktivieren'],
+        ['Mittelklick öffnet zwei Tabs', 'Radschalter-Verschleiß', 'Radklick mit bewussten Einzeldrücken testen'],
+        ['Zurück-Taste springt zwei Seiten zurück', 'Seitenschalter-Prellen oder Browser-Shortcut-Wiederholung', 'Zurück und Vorwärts separat testen'],
+        ['Tritt nur drahtlos auf', 'Drahtlose Interferenz, niedriger Akku oder Empfängerplatzierung', 'Kabelgebunden erneut testen oder Empfänger näher platzieren'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Den richtigen Entprell-Schwellenwert wählen',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Der Schwellenwert ist der maximale Abstand, den dieses Tool noch als verdächtig betrachtet. Der Standardwert <strong>80 ms</strong> ist ein praktischer Mittelweg: streng genug, um viele unerwünschte doppelte Ereignisse zu erkennen, aber nicht so aggressiv, dass jeder normale absichtliche Doppelklick zu einem Hardwarefehler wird.',
+    },
+    {
+      type: 'table',
+      headers: ['Schwellenwert', 'Am besten geeignet für', 'Wie zu interpretieren'],
+      rows: [
+        ['30-50 ms', 'Strenge elektrische Prellungsprüfungen', 'Gut zur Bestätigung sehr schneller doppelter Ereignisse von einem verschlissenen Schalter'],
+        ['60-90 ms', 'Allgemeine Maus-Doppelklick-Diagnose', 'Bester Standardbereich für die meisten Gaming- und Büromäuse'],
+        ['100-140 ms', 'Intermittierende verschlissene Schalter', 'Nützlich, wenn die Maus gelegentlich breitere versehentliche Abstände erzeugt'],
+        ['150-180 ms', 'Stresstest und schwache Schalter', 'Vorsichtig verwenden, da schnelle absichtliche Doppelklicks in diesen Bereich fallen können'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'So führen Sie einen zuverlässigen Test durch',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Klicken Sie beim ersten Durchlauf nicht absichtlich doppelt. Drücken Sie jede Maustaste langsam und bewusst, eine Taste nach der anderen, während sich der Cursor über der Mausgrafik befindet. Ein gesunder Schalter sollte stabile Einzelereignisse erzeugen. Wenn der Verdächtig-Zähler bei langsamen Einzeldrücken steigt, wiederholen Sie denselben Tastentest mehrmals, um das Muster zu bestätigen.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Testen Sie die linke Taste mit 20 bis 30 langsamen Drücken, dann die rechte, dann das Rad, dann die Seitentasten',
+        'Ziehen Sie die Maus nicht während des Prell-Tests, da Bewegung das Zeitergebnis beeinträchtigen kann',
+        'Wenn eine Taste verdächtige Ereignisse zeigt, wiederholen Sie denselben Test nach dem Wechsel des USB-Anschlusses oder Browsers',
+        'Testen Sie drahtlose Mäuse mit einer frischen Batterie und dem Empfänger nahe an der Maus',
+        'Wenn nur eine Taste wiederholt ausfällt, liegt der Fehler wahrscheinlich an diesem spezifischen Schalter und nicht am gesamten Gerät',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Ergebnisse interpretieren',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Ergebnis', 'Bedeutung', 'Empfohlener nächster Schritt'],
+      rows: [
+        ['0 verdächtige Ereignisse nach vielen Drücken', 'Die getesteten Tasten erscheinen unter dem gewählten Schwellenwert gesund', 'Behalten Sie den Standardschwellenwert bei oder testen Sie später erneut, wenn Symptome zurückkehren'],
+        ['1 isoliertes verdächtiges Ereignis', 'Könnte ein echtes Prellen oder ein versehentlich schneller Druck sein', 'Dieselbe Taste langsam wiederholen, bevor Sie Schlüsse ziehen'],
+        ['Wiederholte verdächtige Ereignisse bei einer Taste', 'Starkes Anzeichen für Schalterprellen oder verschlissene Kontakte', 'An einem anderen Computer testen und das Ergebnis dokumentieren'],
+        ['Verdächtige Ereignisse bei jeder Taste', 'Könnte Software, Treiber, Makro-Dienstprogramm oder Browser-Umgebung sein', 'Maus-Software deaktivieren und erneut testen'],
+        ['Nur der drahtlose Modus schlägt fehl', 'Wahrscheinlich Akku, Empfängerplatzierung oder Interferenz', 'Kabelgebundenen Modus versuchen oder Empfänger näher platzieren'],
+      ],
+    },
+    {
+      type: 'paragraph',
+      html: 'Der Gesundheitswert ist eine schnelle Zusammenfassung, kein endgültiges Urteil. Der wichtigste Beweis ist <strong>welche Taste</strong> verdächtige Ereignisse erzeugt hat und ob sich das Muster wiederholt, wenn Sie genau diese Taste langsam drücken. Ein einzelnes schlechtes Ereignis während eines hastigen Tests ist weniger aussagekräftig als fünf verdächtige Rechtsklick-Ereignisse während bewusster Einzeldrücke.',
+    },
+    {
+      type: 'title',
+      text: 'Bevor Sie die Maus ersetzen',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Prüfen Sie, ob Ihre Maus-Software eine Einstellung für die Entprellzeit hat, und testen Sie nach der Änderung erneut',
+        'Deaktivieren Sie Makros, Rapid-Fire-Profile oder Tasten-Neubelegungen während der Diagnose',
+        'Versuchen Sie einen anderen USB-Anschluss, insbesondere wenn Sie einen Hub oder Frontpanel-Anschluss verwenden',
+        'Testen Sie drahtlose Mäuse mit dem Dongle an einem Verlängerungskabel nahe am Mauspad',
+        'Vergleichen Sie mit einer anderen Maus am selben Computer, um Hardwarefehler von Softwareverhalten zu unterscheiden',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Reparatur, Garantie und Beweise',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Wenn der Fehler mechanisch ist, behebt eine Reinigung des Außengehäuses das Problem selten dauerhaft, da das Problem im Inneren der Schaltkontakte liegt. Einige Benutzer tauschen den Mikroschalter aus, aber das erfordert Löten und lohnt sich nicht für jede Maus. Wenn die Maus unter Garantie steht, sind wiederholte verdächtige Abstände bei derselben Taste nützliche Beweise, um das Problem dem Support zu erklären.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Für Garantieansprüche zeichnen Sie eine kurze Bildschirmaufnahme auf, während Sie die defekte Taste langsam drücken. Stellen Sie sicher, dass die Ereignischips die Tastenbezeichnung und die verdächtige Zeit zeigen. Das ist klarer als "meine Maus klickt manchmal doppelt", da es die tatsächliche Taste und die ungefähre Zeit des unerwünschten doppelten Ereignisses demonstriert.',
+    },
+    {
+      type: 'title',
+      text: 'Einschränkungen eines browserbasierten Maus-Tests',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Dieser Test misst die Ereignisse, die den Browser erreichen. Er kann die elektrische Wellenform im Schalter nicht direkt prüfen und er kann nicht jeden Treiber, jedes Betriebssystem oder jedes Hersteller-Dienstprogramm umgehen. Das ist trotzdem nützlich: Wenn der Browser doppelte Ereignisse empfängt, können Ihre normalen Anwendungen sie ebenfalls empfangen. Für eine technische Validierung auf Ingenieursniveau liefern Hardware-Tools wie Oszilloskope oder Schaltertester tiefere Erkenntnisse, sind aber für die meisten Benutzerdiagnosen nicht erforderlich.',
+    },
+  ],
+  ui: {
+    badge: 'Schalter-Prell-Labor',
+    clickTarget: 'Tastenmatrix',
+    clickTargetHint: 'Links, rechts, Rad, zurück und vorwärts drücken',
+    totalClicks: 'Gesamt',
+    suspiciousClicks: 'Verdächtig',
+    fastestGap: 'Schnellster Abstand',
+    healthScore: 'Gesundheitswert',
+    thresholdLabel: 'Erkennungsschwelle',
+    thresholdUnit: 'ms',
+    cleanEvent: 'sauber',
+    suspiciousEvent: 'verdächtig',
+    reset: 'Zurücksetzen',
+    statusIdle: 'Drücken Sie jede Maustaste, um sie unabhängig zu testen',
+    statusClean: 'Kein verdächtiges Tastenprellen erkannt',
+    statusWarning: 'Verdächtiges Prellen an einer Maustaste erkannt',
+    lastGap: 'Letztes Ereignis',
+    logTitle: 'Letzte Tastenereignisse',
+    emptyLog: 'Drücken Sie eine beliebige Maustaste über dem Mauskörper.',
+    leftButton: 'Links',
+    middleButton: 'Rad',
+    rightButton: 'Rechts',
+    backButton: 'Zurück',
+    forwardButton: 'Vorwärts',
+    otherButton: 'Andere',
+  },
+};

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

@@ -0,0 +1,274 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { MouseDoubleClickTestUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'mouse-double-click-test';
+const title = 'Mouse Double Click Test';
+const description =
+  'Test every mouse button and detect unwanted double-clicks, worn switches, and contact bounce with per-button timing in your browser.';
+
+const faqData = [
+  {
+    question: 'What is a mouse double-click problem?',
+    answer:
+      'A double-click problem happens when one physical press is reported as two clicks. It can affect the left button, right button, wheel click, or side buttons, and is usually caused by switch wear, contact bounce, firmware debounce settings, or wireless signal instability.',
+  },
+  {
+    question: 'What gap counts as suspicious?',
+    answer:
+      'Very short gaps between clicks are suspicious because human double-clicks usually take more time. This tool starts at an 80 ms threshold, but you can adjust it depending on the mouse and your testing style.',
+  },
+  {
+    question: 'Can a browser prove the switch is broken?',
+    answer:
+      'A browser cannot inspect the electrical switch directly, but it can record the click events your operating system receives. Repeated suspicious gaps during single-click testing are strong evidence of bounce or unwanted double-clicking.',
+  },
+  {
+    question: 'How should I test correctly?',
+    answer:
+      'Click slowly and deliberately, aiming for single presses. If the suspicious counter rises even when you are not intentionally double-clicking, repeat the test on another USB port, another browser, and another computer if possible.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Set the detection threshold',
+    text: 'Start with 80 ms. Lower it for strict switch-bounce detection or raise it if your device produces slightly wider accidental gaps.',
+  },
+  {
+    name: 'Click like a normal single-click',
+    text: 'Press each mouse button one click at a time over the mouse visual. Do not intentionally double-click during the first pass.',
+  },
+  {
+    name: 'Watch the suspicious counter',
+    text: 'If suspicious events appear while you are making single clicks, check which visual button was highlighted and compare it with the compact event chips.',
+  },
+  {
+    name: 'Compare with another device',
+    text: 'A healthy mouse should keep a high score under the same threshold. Comparing devices helps separate hardware faults from software settings.',
+  },
+];
+
+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<MouseDoubleClickTestUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
+  seo: [
+    {
+      type: 'title',
+      text: 'Mouse Double Click Test: Diagnose Button Bounce Online',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'A mouse that double-clicks when you press once is not just annoying. It can open folders by accident, cancel drag-and-drop actions, fire two shots in a game, close browser tabs, or make right-click menus appear and disappear before you can use them. This online mouse double click test focuses on the useful diagnostic signal: <strong>the time gap between button events reported by your operating system</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Unlike a basic click counter, this tool tracks every button independently: left click, right click, wheel click, browser back, and browser forward. That matters because a mouse can have a failing right button while the left button is still healthy, or a worn side button that only misfires after months of gaming or productivity shortcuts.',
+    },
+    {
+      type: 'title',
+      text: 'What This Mouse Button Test Measures',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'When you press a mouse button, the browser receives a pointer event containing the button code. The tool stores the last timestamp for that same physical button and compares it with the next press of the same button. If the gap is shorter than your selected threshold, the event is marked as suspicious because a normal intentional second click usually takes longer.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Left button: useful for detecting accidental double-clicks when opening files, selecting text, or dragging windows',
+        'Right button: useful when context menus flicker, open twice, or close immediately',
+        'Wheel button: useful for mice where middle-click opens multiple tabs or fails after heavy browsing',
+        'Back and Forward buttons: useful for gaming mice and productivity mice with side switches',
+        'Per-button timing: avoids mixing a left click with a right click and calling it a false double-click',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Why Mice Start Double-Clicking',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Most mice use small mechanical switches under each button. When the switch contacts close, the metal can bounce electrically for a very short period before settling. The mouse firmware normally filters that noise with debounce logic. As the switch wears out, the bounce can become longer, noisier, or inconsistent, so the computer receives two button presses even though your finger made one physical press.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Double-clicking is not always caused by the same thing. It may be mechanical switch wear, firmware debounce set too aggressively, dust or oxidation inside the switch, wireless packet instability, macro software, a damaged cable, or an operating system setting that makes accidental double-clicks easier to notice.',
+    },
+    {
+      type: 'table',
+      headers: ['Symptom', 'Likely Cause', 'What to Test'],
+      rows: [
+        ['One click opens files as if double-clicked', 'Left switch bounce or OS double-click speed confusion', 'Test Left with slow single presses at 80 ms'],
+        ['Right-click menu flashes or closes', 'Right switch bounce or software intercepting context menus', 'Test Right and disable mouse utilities temporarily'],
+        ['Middle-click opens two tabs', 'Wheel switch wear', 'Test Wheel with deliberate single presses'],
+        ['Back button jumps two pages', 'Side switch bounce or browser shortcut repeat', 'Test Back and Forward separately'],
+        ['Only happens wirelessly', 'Wireless interference, low battery, or receiver placement', 'Retest wired or move receiver closer'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Choosing the Right Debounce Threshold',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'The threshold is the maximum gap that this tool still considers suspicious. The default value, <strong>80 ms</strong>, is a practical middle ground: strict enough to catch many unwanted duplicate events, but not so aggressive that every normal deliberate double-click becomes a hardware failure.',
+    },
+    {
+      type: 'table',
+      headers: ['Threshold', 'Best For', 'How to Interpret It'],
+      rows: [
+        ['30-50 ms', 'Strict electrical bounce checks', 'Good for confirming very fast duplicate events from a worn switch'],
+        ['60-90 ms', 'General mouse double-click diagnosis', 'Best default range for most gaming and office mice'],
+        ['100-140 ms', 'Intermittent worn switches', 'Useful when the mouse sometimes creates wider accidental gaps'],
+        ['150-180 ms', 'Stress testing and weak switches', 'Use carefully, because fast intentional double-clicks can fall into this range'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'How to Run a Reliable Test',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'For the first pass, do not intentionally double-click. Press each mouse button slowly and deliberately, one button at a time, while the cursor is over the mouse visual. A healthy switch should produce stable single events. If the suspicious counter increases during slow single presses, repeat the same button test several times to confirm the pattern.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Test Left for 20 to 30 slow presses, then Right, then Wheel, then side buttons',
+        'Do not drag the mouse while testing button bounce, because movement can distract from the timing result',
+        'If a button shows suspicious events, repeat the same test after changing USB port or browser',
+        'For wireless mice, test with a fresh battery and the receiver close to the mouse',
+        'If only one button fails repeatedly, the fault is probably that specific switch rather than the whole device',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Interpreting the Results',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['Result', 'Meaning', 'Recommended Next Step'],
+      rows: [
+        ['0 suspicious events after many presses', 'The tested buttons look healthy under the selected threshold', 'Keep the default threshold or test again later if symptoms return'],
+        ['1 isolated suspicious event', 'Could be a real bounce or an accidental fast press', 'Repeat the same button slowly before drawing conclusions'],
+        ['Repeated suspicious events on one button', 'Strong sign of switch bounce or worn contacts', 'Test on another computer and document the result'],
+        ['Suspicious events on every button', 'Could be software, driver, macro utility, or browser environment', 'Disable mouse software and retest'],
+        ['Only wireless mode fails', 'Likely battery, receiver placement, or interference', 'Try wired mode or move the receiver closer'],
+      ],
+    },
+    {
+      type: 'paragraph',
+      html: 'The health score is a quick summary, not a final verdict. The most important evidence is <strong>which button</strong> produced suspicious events and whether the pattern repeats when you press that same button slowly. A single bad event during a rushed test is less meaningful than five suspicious right-click events during deliberate single presses.',
+    },
+    {
+      type: 'title',
+      text: 'Before You Replace the Mouse',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Check whether your mouse software has a debounce-time setting and test again after changing it',
+        'Disable macros, rapid-fire profiles, or button remapping utilities during diagnosis',
+        'Try a different USB port, especially if you use a hub or front-panel connector',
+        'For wireless mice, test with the dongle on an extension cable near the mouse pad',
+        'Compare with another mouse on the same computer to separate hardware failure from software behavior',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Repair, Warranty, and Evidence',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'If the fault is mechanical, cleaning the outside shell rarely fixes it permanently because the problem is inside the switch contacts. Some users replace the microswitch, but that requires soldering and is not worth it for every mouse. If the mouse is under warranty, repeated suspicious gaps on the same button are useful evidence when explaining the issue to support.',
+    },
+    {
+      type: 'paragraph',
+      html: 'For warranty claims, record a short screen capture while you press the failing button slowly. Make sure the event chips show the button label and the suspicious timing. This is clearer than saying "my mouse double-clicks sometimes" because it demonstrates the actual button and the approximate timing of the unwanted duplicate event.',
+    },
+    {
+      type: 'title',
+      text: 'Limitations of a Browser-Based Mouse Test',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'This test measures the events that reach the browser. It cannot directly inspect the electrical waveform inside the switch, and it cannot bypass every driver, operating system, or vendor utility. That is still useful: if the browser receives duplicate events, your normal applications can receive them too. For engineering-level validation, hardware tools such as oscilloscopes or switch testers provide deeper evidence, but they are not necessary for most user diagnostics.',
+    },
+  ],
+  ui: {
+    badge: 'Switch Bounce Lab',
+    clickTarget: 'Button Matrix',
+    clickTargetHint: 'Press left, right, wheel, back, and forward',
+    totalClicks: 'Total',
+    suspiciousClicks: 'Suspicious',
+    fastestGap: 'Fastest gap',
+    healthScore: 'Health score',
+    thresholdLabel: 'Detection threshold',
+    thresholdUnit: 'ms',
+    cleanEvent: 'clean',
+    suspiciousEvent: 'suspect',
+    reset: 'Reset',
+    statusIdle: 'Press each mouse button to test it independently',
+    statusClean: 'No suspicious button bounce detected',
+    statusWarning: 'Suspicious bounce detected on a mouse button',
+    lastGap: 'Last event',
+    logTitle: 'Recent button events',
+    emptyLog: 'Press any mouse button over the mouse body.',
+    leftButton: 'Left',
+    middleButton: 'Wheel',
+    rightButton: 'Right',
+    backButton: 'Back',
+    forwardButton: 'Forward',
+    otherButton: 'Other',
+  },
+};