@jjlmoya/utils-chrono 1.9.0 → 1.11.0

package/src/tool/gear-train-explorer/gears.ts

@@ -0,0 +1,148 @@
+import { getCtx, c } from './state';
+
+function gearOutline(r: number, teeth: number) {
+  const ctx = getCtx();
+  const toothH = r * 0.18;
+  const baseR = r - toothH * 0.3;
+  const aStep = Math.PI * 2 / teeth;
+  const gap = aStep * 0.05;
+  ctx.beginPath();
+  for (let i = 0; i < teeth; i++) {
+    const aStart = i * aStep - Math.PI / 2;
+    const aMid = (i + 0.5) * aStep - Math.PI / 2;
+    const aEnd = (i + 1) * aStep - Math.PI / 2;
+    ctx.lineTo(Math.cos(aStart + gap) * baseR, Math.sin(aStart + gap) * baseR);
+    ctx.lineTo(Math.cos(aMid) * (baseR + toothH), Math.sin(aMid) * (baseR + toothH));
+    ctx.lineTo(Math.cos(aEnd - gap) * baseR, Math.sin(aEnd - gap) * baseR);
+  }
+  ctx.closePath();
+}
+
+function gearFill(r: number, color: string, highlight: boolean) {
+  const ctx = getCtx();
+  const toothH = r * 0.18;
+  const grad = ctx.createRadialGradient(-r * 0.2, -r * 0.2, 0, 0, 0, r + toothH);
+  if (highlight) {
+    grad.addColorStop(0, c('#fff8dc', '#fff3b0'));
+    grad.addColorStop(0.15, color);
+    grad.addColorStop(0.7, c('#8b6914', '#b8860b'));
+    grad.addColorStop(1, c('#5a4510', '#8b6914'));
+  } else {
+    grad.addColorStop(0, color);
+    grad.addColorStop(0.5, c('#b8860b', '#cd9b1d'));
+    grad.addColorStop(0.8, c('#8b6914', '#b8860b'));
+    grad.addColorStop(1, c('#5a4510', '#8b6914'));
+  }
+  ctx.fillStyle = grad;
+  ctx.fill();
+  ctx.shadowColor = highlight ? c('rgba(212,175,55,0.6)', 'rgba(180,140,30,0.4)') : 'transparent';
+  ctx.shadowBlur = highlight ? 20 : 0;
+  ctx.strokeStyle = highlight ? '#ffd700' : c('rgba(212,175,55,0.3)', 'rgba(180,140,30,0.4)');
+  ctx.lineWidth = 1;
+  ctx.stroke();
+  ctx.shadowColor = 'transparent';
+  ctx.shadowBlur = 0;
+}
+
+function gearInnerHole(r: number) {
+  const ctx = getCtx();
+  const innerR = r * 0.2;
+  ctx.beginPath();
+  ctx.arc(0, 0, innerR, 0, Math.PI * 2);
+  const ig = ctx.createRadialGradient(0, 0, 0, 0, 0, innerR);
+  ig.addColorStop(0, c('#2a2a42', '#f0ebe0'));
+  ig.addColorStop(0.6, c('#1a1a2e', '#e8e0d0'));
+  ig.addColorStop(1, c('#5a4510', '#8b6914'));
+  ctx.fillStyle = ig;
+  ctx.fill();
+  ctx.beginPath();
+  ctx.arc(0, 0, innerR * 0.5, 0, Math.PI * 2);
+  ctx.strokeStyle = c('rgba(212,175,55,0.2)', 'rgba(139,105,20,0.3)');
+  ctx.lineWidth = 1;
+  ctx.stroke();
+}
+
+function drawGearBody(opts: { r: number; teeth: number; color: string; highlight: boolean }) {
+  gearOutline(opts.r, opts.teeth);
+  gearFill(opts.r, opts.color, opts.highlight);
+  gearInnerHole(opts.r);
+}
+
+export function drawGear(opts: { x: number; y: number; r: number; teeth: number; angle: number; color: string; highlight: boolean }) {
+  const ctx = getCtx();
+  ctx.save();
+  ctx.translate(opts.x, opts.y);
+  ctx.rotate(opts.angle);
+  drawGearBody({ r: opts.r, teeth: opts.teeth, color: opts.color, highlight: opts.highlight });
+  ctx.restore();
+}
+
+export function drawPallet(x: number, y: number, phase: number) {
+  const ctx = getCtx();
+  ctx.save();
+  ctx.translate(x, y);
+  const a = Math.sin(phase) * 0.4;
+  ctx.strokeStyle = c('#a0b0c0', '#607080');
+  ctx.lineWidth = 3;
+  ctx.lineCap = 'round';
+  const ax = Math.cos(a) * 18;
+  const ay = Math.sin(a) * 18;
+  const fx1 = Math.cos(a + 0.5) * 12;
+  const fy1 = Math.sin(a + 0.5) * 12;
+  const fx2 = Math.cos(a - 0.5) * 12;
+  const fy2 = Math.sin(a - 0.5) * 12;
+  ctx.beginPath(); ctx.moveTo(-ax, -ay); ctx.lineTo(0, 0); ctx.stroke();
+  ctx.beginPath(); ctx.moveTo(0, 0); ctx.lineTo(fx1, fy1); ctx.stroke();
+  ctx.beginPath(); ctx.moveTo(0, 0); ctx.lineTo(fx2, fy2); ctx.stroke();
+  ctx.fillStyle = c('#a0b0c0', '#607080');
+  ctx.beginPath(); ctx.arc(0, 0, 4, 0, Math.PI * 2); ctx.fill();
+  ctx.beginPath(); ctx.arc(-ax, -ay, 3, 0, Math.PI * 2); ctx.fillStyle = c('#c0d0e0', '#8090a0'); ctx.fill();
+  ctx.beginPath(); ctx.arc(fx1, fy1, 2.5, 0, Math.PI * 2); ctx.fill();
+  ctx.beginPath(); ctx.arc(fx2, fy2, 2.5, 0, Math.PI * 2); ctx.fill();
+  ctx.restore();
+}
+
+export function drawBalance(x: number, y: number, r: number, phase: number) {
+  const ctx = getCtx();
+  ctx.save();
+  ctx.translate(x, y);
+  ctx.rotate(Math.sin(phase) * 0.6);
+  ctx.strokeStyle = c('#c0d0e0', '#8090a0');
+  ctx.lineWidth = 2;
+  ctx.beginPath(); ctx.arc(0, 0, r, 0, Math.PI * 2); ctx.stroke();
+  ctx.beginPath(); ctx.arc(0, 0, r * 0.85, 0, Math.PI * 2); ctx.strokeStyle = c('rgba(192,208,224,0.3)', 'rgba(100,110,130,0.3)'); ctx.lineWidth = 1; ctx.stroke();
+  const grad = ctx.createRadialGradient(0, 0, 0, 0, 0, r);
+  grad.addColorStop(0, c('#e8f0f8', '#d0d8e0'));
+  grad.addColorStop(0.3, c('#d0dce8', '#b0b8c0'));
+  grad.addColorStop(1, c('#304050', '#809090'));
+  ctx.fillStyle = grad;
+  ctx.beginPath(); ctx.arc(0, 0, r * 0.75, 0, Math.PI * 2); ctx.fill();
+  ctx.strokeStyle = c('#c0d0e0', '#8090a0'); ctx.lineWidth = 2.5;
+  ctx.beginPath(); ctx.moveTo(-r * 0.7, 0); ctx.lineTo(r * 0.7, 0); ctx.stroke();
+  ctx.beginPath(); ctx.moveTo(0, -r * 0.7); ctx.lineTo(0, r * 0.7); ctx.stroke();
+  ctx.fillStyle = '#d4af37';
+  ctx.beginPath(); ctx.arc(0, 0, 5, 0, Math.PI * 2); ctx.fill();
+  ctx.strokeStyle = c('rgba(212,175,55,0.5)', 'rgba(180,140,30,0.5)');
+  ctx.lineWidth = 1;
+  ctx.beginPath(); ctx.arc(0, 0, r + 4, 0, Math.PI * 2); ctx.stroke();
+  ctx.restore();
+}
+
+export function drawConnection(opts: { x1: number; y1: number; x2: number; y2: number; active: boolean }) {
+  const ctx = getCtx();
+  ctx.beginPath();
+  ctx.moveTo(opts.x1, opts.y1);
+  ctx.lineTo(opts.x2, opts.y2);
+  if (opts.active) {
+    ctx.strokeStyle = c('rgba(212,175,55,0.35)', 'rgba(180,140,30,0.5)');
+    ctx.lineWidth = 3;
+    ctx.shadowColor = c('rgba(212,175,55,0.2)', 'rgba(180,140,30,0.3)');
+    ctx.shadowBlur = 8;
+  } else {
+    ctx.strokeStyle = c('rgba(60,60,90,0.5)', 'rgba(100,90,70,0.3)');
+    ctx.lineWidth = 2;
+  }
+  ctx.stroke();
+  ctx.shadowColor = 'transparent';
+  ctx.shadowBlur = 0;
+}

package/src/tool/gear-train-explorer/helpers.ts

@@ -0,0 +1,49 @@
+import type { WithContext, Thing } from 'schema-dts';
+import type { FAQItem, HowToStep } from '../../types';
+
+function buildFAQ(faq: FAQItem[]): WithContext<Thing> {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    'mainEntity': faq.map((f) => ({
+      '@type': 'Question',
+      'name': f.question,
+      'acceptedAnswer': {
+        '@type': 'Answer',
+        'text': f.answer,
+      },
+    })),
+  } as unknown as WithContext<Thing>;
+}
+
+function buildApp(title: string): WithContext<Thing> {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    'name': title,
+    'operatingSystem': 'All',
+    'applicationCategory': 'UtilitiesApplication',
+    'browserRequirements': 'Requires HTML5. Requires JavaScript.',
+  } as unknown as WithContext<Thing>;
+}
+
+function buildHowTo(title: string, howTo: HowToStep[]): WithContext<Thing> {
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    'name': title,
+    'step': howTo.map((h) => ({
+      '@type': 'HowToStep',
+      'name': h.name,
+      'text': h.text,
+    })),
+  } as unknown as WithContext<Thing>;
+}
+
+export function buildSchemas(
+  title: string,
+  faq: FAQItem[],
+  howTo: HowToStep[]
+): WithContext<Thing>[] {
+  return [buildFAQ(faq), buildApp(title), buildHowTo(title, howTo)];
+}

package/src/tool/gear-train-explorer/i18n/de.ts

@@ -0,0 +1,99 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { GearTrainExplorerUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Was ist ein Räderwerk in einer Uhr?',
+    answer: 'Ein Räderwerk ist eine Reihe von ineinandergreifenden Zahnrädern, die die Kraft von der Federhauswalze zur Hemmung übertragen. Jedes Zahnradpaar sorgt für ein bestimmtes Untersetzungsverhältnis und verlangsamt die schnelle Freisetzung der Federenergie in kontrollierte, getaktete Impulse.',
+  },
+  {
+    question: 'Warum haben verschiedene Uhrwerke unterschiedliche Übersetzungen?',
+    answer: 'Die Übersetzungsverhältnisse werden durch die Anzahl der Zähne an jedem Rad und Trieb bestimmt. Uhrwerke mit unterschiedlichen Schlagzahlen (z. B. 28.800 VPH vs. 36.000 VPH) haben unterschiedliche Hemmungsradgeschwindigkeiten und Zahnradkonfigurationen, um eine genaue Zeitmessung bei gleichzeitiger Anpassung an die Unruhfrequenz zu gewährleisten.',
+  },
+  {
+    question: 'Was ist der Unterschied zwischen einem Rad und einem Trieb?',
+    answer: 'In der Uhrmacherei ist ein "Rad" das größere Zahnrad mit vielen Zähnen, das die nächste Komponente antreibt. Ein "Trieb" ist das kleinere Zahnrad (normalerweise 6-12 Zähne), das angetrieben wird. Zusammen bilden Rad und Trieb ein Zahnradpaar, das Drehzahl und Drehmoment verändert.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Wählen Sie ein Uhrwerk',
+    text: 'Wählen Sie zwischen Standard-Uhrwerken (28.800 VPH), Hochfrequenz-Uhrwerken (36.000 VPH El Primero) oder Vintage-Uhrwerken (18.000 VPH). Jedes hat einzigartige Übersetzungen und Schlagzahlen.',
+  },
+  {
+    name: 'Beobachten Sie das Räderwerk',
+    text: 'Sehen Sie den animierten Zahnrädern dabei zu, wie sie sich mit proportionalen Geschwindigkeiten drehen. Die Federhauswalze dreht sich langsam, während das Hemmungsrad schnell rotiert. Fahren Sie mit der Maus über ein Zahnrad oder eine Datenkarte, um detaillierte Informationen zu erhalten.',
+  },
+  {
+    name: 'Passen Sie die Geschwindigkeit an',
+    text: 'Nutzen Sie die Geschwindigkeitsregler, um die Animation zu verlangsamen, zu beschleunigen oder anzuhalten. So können Sie visualisieren, wie jedes Zahnrad zur Kraftübertragungskette beiträgt.',
+  },
+];
+
+const title = 'Räderwerk Erkunder: Interaktives Uhrmacherei Diagramm';
+
+export const content: ToolLocaleContent<GearTrainExplorerUI> = {
+  slug: 'getriebeerkunder',
+  title,
+  description: 'Erkunden Sie das mechanische Herz einer Uhr mit einer animierten Räderwerk-Visualisierung. Sehen Sie Federhauswalze, Minutenrad, Kleinbodenrad, Sekundenrad, Hemmungsrad, Anker und Unruh in Bewegung.',
+  ui: {
+    title: 'Räderwerk Erkunder',
+    barrelLabel: 'Federhaus',
+    centerWheelLabel: 'Minutenrad',
+    thirdWheelLabel: 'Kleinbodenrad',
+    fourthWheelLabel: 'Sekundenrad',
+    escapeWheelLabel: 'Hemmungsrad',
+    palletForkLabel: 'Anker',
+    balanceWheelLabel: 'Unruh',
+    rpmLabel: 'U/min',
+    teethLabel: 'Zähne',
+    gearRatioLabel: 'Verhältnis',
+    powerFlowLabel: 'Kraftfluss',
+    movementLabel: 'Uhrwerk',
+    speedLabel: 'Geschwindigkeit',
+    speedNormal: '1x',
+    speedSlow: '0.5x',
+    speedPaused: 'Pausiert',
+    mov2824: 'ETA 2824-2',
+    movElPrimero: 'El Primero',
+    movVintage: 'Vintage 18k',
+    step1: 'Wählen Sie ein Uhrwerk aus, um seine spezifischen Übersetzungen und Schlagzahlen zu sehen.',
+    step2: 'Fahren Sie über ein Zahnrad oder eine Datenkarte, um seine Position im Kraftfluss zu markieren.',
+    step3: 'Passen Sie die Animationsgeschwindigkeit an, um zu studieren, wie jedes Rad Kraft durch das Getriebe überträgt.',
+    tipTitle: 'Tipp',
+    tipContent: 'Das Räderwerk reduziert die schnelle Energieabgabe der Feder in eine kontrollierte Schwingung. Eine typische Federhauswalze dreht sich alle 7-8 Stunden einmal, während das Hemmungsrad mit 32 U/min rotiert (bei 28.800 VPH) — eine Untersetzung von über 15.000:1.',
+  },
+  seo: [
+    { type: 'title', text: 'Interaktiver Räderwerk-Erkunder', level: 2 },
+    { type: 'paragraph', html: 'Das <strong>Räderwerk</strong> ist das mechanische Rückgrat jeder mechanischen Uhr. Dieses interaktive Tool visualisiert, wie die Kraft von der Federhauswalze über das Minutenrad, Kleinbodenrad, Sekundenrad und Hemmungsrad zum Anker und zur Unruh fließt. Sehen Sie jedes Zahnrad mit seiner proportionalen Geschwindigkeit rotieren und verstehen Sie, wie Übersetzungen die Zeitmessung bestimmen.' },
+    { type: 'title', text: 'Wie ein Uhrwerk-Räderwerk funktioniert', level: 3 },
+    { type: 'paragraph', html: 'Ein Uhrwerk-Räderwerk besteht aus einer Reihe von <strong>Rädern</strong> (große Zahnräder) und <strong>Trieben</strong> (kleine Zahnräder), die Kraft übertragen und gleichzeitig die Drehzahl reduzieren. Das <strong>Federhaus</strong> beherbergt die Hauptfeder und dreht sich langsam. Es treibt das <strong>Minutenrad</strong> an, das sich einmal pro Stunde dreht (für den Minutenzeiger). Das <strong>Kleinbodenrad</strong> und <strong>Sekundenrad</strong> erhöhen die Drehzahl weiter. Schließlich gibt das <strong>Hemmungsrad</strong> die Kraft in kontrollierten Impulsen an den <strong>Anker</strong> ab, der abwechselnd das Hemmungsrad arretiert und freigibt und Impulse an die <strong>Unruh</strong> sendet. Die Unruh schwingt mit einer präzisen Frequenz — typischerweise 4 Hz (28.800 Schwingungen pro Stunde) — und reguliert so den Gang der Uhr.' },
+    { type: 'title', text: 'Übersetzungen und Kraftübertragung', level: 3 },
+    {
+      type: 'table', headers: ['Komponente', 'Typische Zähne', 'U/min (28.800 VPH)', 'Verhältnis zuvor'], rows: [
+        ['Federhaus', '72', '0,002 (1 U / 8 h)', '-'],
+        ['Minutenrad', '60', '0,0167 (1 U / h)', '~7,2:1'],
+        ['Kleinbodenrad', '50', '0,125 (1 U / 8 min)', '~5:1'],
+        ['Sekundenrad', '60', '1 (1 U / min)', '6:1'],
+        ['Hemmungsrad', '15', '32', '~1,875:1'],
+      ]
+    },
+    { type: 'title', text: 'Uhrwerksvergleiche', level: 3 },
+    {
+      type: 'table', headers: ['Uhrwerk', 'Schlagzahl', 'Unruhfrequenz', 'Hemmungsrad-U/min', 'Typische Genauigkeit'], rows: [
+        ['Vintage (18.000 VPH)', '18.000 bph', '2,5 Hz', '20 U/min', '±15-30 s/d'],
+        ['Standard (28.800 VPH)', '28.800 bph', '4 Hz', '32 U/min', '±5-15 s/d'],
+        ['Hochfrequenz (36.000 VPH)', '36.000 bph', '5 Hz', '40 U/min', '±3-8 s/d'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Interaktives Lernwerkzeug', icon: 'mdi:cog-clockwise', badge: 'UHRMACHEREI', html: 'Dieses Tool verwendet ungefähre Übersetzungsverhältnisse, die für typische Schweizer Ankerhemmungen repräsentativ sind. Tatsächliche Verhältnisse variieren je nach Kaliber. Nutzen Sie die Uhrwerksvoreinstellungen, um zu vergleichen, wie sich unterschiedliche Schlagzahlen auf die Räderwerkdynamik auswirken.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};
+

package/src/tool/gear-train-explorer/i18n/en.ts

@@ -0,0 +1,98 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { GearTrainExplorerUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'What is a watch gear train?',
+    answer: 'A gear train is a series of interlocking gears that transmit power from the mainspring barrel to the escapement. Each gear pair provides a specific reduction ratio, slowing down the rapid release of mainspring energy into controlled, timed impulses.',
+  },
+  {
+    question: 'Why do different movements have different gear ratios?',
+    answer: 'Gear ratios are determined by the number of teeth on each wheel and pinion. Movements with different beat rates (e.g., 28,800 vph vs 36,000 vph) have different escape wheel speeds and gear configurations to maintain accurate timekeeping while accommodating the balance wheel frequency.',
+  },
+  {
+    question: 'What is the difference between a wheel and a pinion?',
+    answer: 'In horology, a "wheel" is the larger gear with many teeth that drives the next component. A "pinion" is the smaller gear (usually 6-12 teeth) that is driven. Together, a wheel and pinion form a gear pair that changes rotational speed and torque.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Select a movement',
+    text: 'Choose between standard (28,800 vph), high-frequency (36,000 vph El Primero), or vintage (18,000 vph) movements. Each has unique gear ratios and beat rates.',
+  },
+  {
+    name: 'Observe the gear train',
+    text: 'Watch the animated gears spin at proportional speeds. The barrel turns slowly while the escape wheel spins rapidly. Hover over any gear or data card for detailed information.',
+  },
+  {
+    name: 'Adjust the speed',
+    text: 'Use the speed controls to slow down, speed up, or pause the animation. This helps visualize how each gear contributes to the power transmission chain.',
+  },
+];
+
+const title = 'Watch Gear Train Explorer: Interactive Horology Diagram';
+
+export const content: ToolLocaleContent<GearTrainExplorerUI> = {
+  slug: 'gear-train-explorer',
+  title,
+  description: 'Explore the mechanical heart of a watch with an animated gear train visualization. See the mainspring barrel, center wheel, third wheel, fourth wheel, escape wheel, pallet fork, and balance wheel in motion.',
+  ui: {
+    title: 'Watch Gear Train Explorer',
+    barrelLabel: 'Barrel',
+    centerWheelLabel: 'Center Wheel',
+    thirdWheelLabel: 'Third Wheel',
+    fourthWheelLabel: 'Fourth Wheel',
+    escapeWheelLabel: 'Escape Wheel',
+    palletForkLabel: 'Pallet Fork',
+    balanceWheelLabel: 'Balance Wheel',
+    rpmLabel: 'RPM',
+    teethLabel: 'teeth',
+    gearRatioLabel: 'Ratio',
+    powerFlowLabel: 'Power Flow',
+    movementLabel: 'Movement',
+    speedLabel: 'Speed',
+    speedNormal: '1x',
+    speedSlow: '0.5x',
+    speedPaused: 'Paused',
+    mov2824: 'ETA 2824-2',
+    movElPrimero: 'El Primero',
+    movVintage: 'Vintage 18k',
+    step1: 'Select a movement caliber to see its unique gear ratios and beat rate.',
+    step2: 'Hover over any gear or data card to highlight its position in the power flow.',
+    step3: 'Adjust the animation speed to study how each gear transmits power through the train.',
+    tipTitle: 'Tip',
+    tipContent: 'The gear train reduces the mainspring\'s rapid energy release into a controlled oscillation. A typical barrel rotates once every 7-8 hours, while the escape wheel spins at 32 RPM (at 28,800 vph) — a reduction of over 15,000:1.',
+  },
+  seo: [
+    { type: 'title', text: 'Interactive Watch Gear Train Explorer', level: 2 },
+    { type: 'paragraph', html: 'The <strong>gear train</strong> is the mechanical backbone of every mechanical watch. This interactive tool visualizes how power flows from the mainspring barrel through the center wheel, third wheel, fourth wheel, and escape wheel to the pallet fork and balance wheel. See each gear rotate at its proportional speed and understand how gear ratios determine timekeeping.' },
+    { type: 'title', text: 'How a Watch Gear Train Works', level: 3 },
+    { type: 'paragraph', html: 'A watch gear train consists of a series of <strong>wheels</strong> (large gears) and <strong>pinions</strong> (small gears) that transmit power while reducing speed. The <strong>barrel</strong> houses the mainspring and rotates slowly, driving the <strong>center wheel</strong> which turns once per hour (for the minute hand). The <strong>third wheel</strong> and <strong>fourth wheel</strong> (seconds wheel) further step up the rotation speed. Finally, the <strong>escape wheel</strong> releases power in controlled ticks to the <strong>pallet fork</strong>, which alternately locks and unlocks the escape wheel, sending impulses to the <strong>balance wheel</strong>. The balance wheel oscillates at a precise frequency — typically 4 Hz (28,800 vibrations per hour) — regulating the watch\'s rate.' },
+    { type: 'title', text: 'Gear Ratios and Power Transmission', level: 3 },
+    {
+      type: 'table', headers: ['Component', 'Typical Teeth', 'RPM (28,800 vph)', 'Ratio from Previous'], rows: [
+        ['Barrel', '72', '0.002 (1 rev / 8 h)', '-'],
+        ['Center Wheel', '60', '0.0167 (1 rev / h)', '~7.2:1'],
+        ['Third Wheel', '50', '0.125 (1 rev / 8 min)', '~5:1'],
+        ['Fourth Wheel', '60', '1 (1 rev / min)', '6:1'],
+        ['Escape Wheel', '15', '32', '~1.875:1'],
+      ]
+    },
+    { type: 'title', text: 'Movement Comparisons', level: 3 },
+    {
+      type: 'table', headers: ['Movement', 'Beat Rate', 'Balance Frequency', 'Escape Wheel RPM', 'Typical Accuracy'], rows: [
+        ['Vintage (18,000 vph)', '18,000 bph', '2.5 Hz', '20 RPM', '±15-30 s/d'],
+        ['Standard (28,800 vph)', '28,800 bph', '4 Hz', '32 RPM', '±5-15 s/d'],
+        ['High-Frequency (36,000 vph)', '36,000 bph', '5 Hz', '40 RPM', '±3-8 s/d'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Interactive Learning Tool', icon: 'mdi:cog-clockwise', badge: 'HOROLOGY', html: 'This tool uses approximate gear ratios representative of common Swiss lever escapement movements. Actual ratios vary by caliber. Use the movement presets to compare how different beat rates affect the gear train dynamics.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/gear-train-explorer/i18n/es.ts

@@ -0,0 +1,99 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { GearTrainExplorerUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: '¿Qué es un tren de engranajes en un reloj?',
+    answer: 'Un tren de engranajes es una serie de ruedas dentadas interconectadas que transmiten la energía desde el barril del muelle real hasta el escape. Cada par de engranajes proporciona una relación de reducción específica, ralentizando la liberación rápida de la energía del muelle en impulsos controlados y cronometrados.',
+  },
+  {
+    question: '¿Por qué los diferentes movimientos tienen diferentes relaciones de engranaje?',
+    answer: 'Las relaciones de engranaje están determinadas por el número de dientes en cada rueda y piñón. Los movimientos con diferentes frecuencias de oscilación (p. ej., 28.800 VPH vs 36.000 VPH) tienen diferentes velocidades de la rueda de escape y configuraciones de engranajes para mantener una precisión horaria precisa mientras se adaptan a la frecuencia del volante.',
+  },
+  {
+    question: '¿Cuál es la diferencia entre una rueda y un piñón?',
+    answer: 'En relojería, una "rueda" es el engranaje más grande con muchos dientes que impulsa el siguiente componente. Un "piñón" es el engranaje más pequeño (generalmente de 6-12 dientes) que es impulsado. Juntos, una rueda y un piñón forman un par de engranajes que cambia la velocidad de rotación y el par motor.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Seleccione un movimiento',
+    text: 'Elija entre movimientos estándar (28.800 VPH), de alta frecuencia (36.000 VPH El Primero) o vintage (18.000 VPH). Cada uno tiene relaciones de engranaje y frecuencias de oscilación únicas.',
+  },
+  {
+    name: 'Observe el tren de engranajes',
+    text: 'Vea cómo los engranajes animados giran a velocidades proporcionales. El barril gira lentamente mientras que la rueda de escape gira rápidamente. Pase el ratón sobre cualquier engranaje o tarjeta de datos para obtener información detallada.',
+  },
+  {
+    name: 'Ajuste la velocidad',
+    text: 'Use los controles de velocidad para ralentizar, acelerar o pausar la animación. Esto ayuda a visualizar cómo cada engranaje contribuye a la cadena de transmisión de potencia.',
+  },
+];
+
+const title = 'Explorador de Tren de Engranajes: Diagrama Interactivo de Relojería';
+
+export const content: ToolLocaleContent<GearTrainExplorerUI> = {
+  slug: 'exploradortrenengranajes',
+  title,
+  description: 'Explore el corazón mecánico de un reloj con una visualización animada del tren de engranajes. Vea el barril del muelle real, la rueda central, la tercera rueda, la cuarta rueda, la rueda de escape, la horquilla del áncora y el volante en movimiento.',
+  ui: {
+    title: 'Explorador de Tren de Engranajes',
+    barrelLabel: 'Barril',
+    centerWheelLabel: 'Rueda Central',
+    thirdWheelLabel: 'Tercera Rueda',
+    fourthWheelLabel: 'Cuarta Rueda',
+    escapeWheelLabel: 'Rueda de Escape',
+    palletForkLabel: 'Horquilla',
+    balanceWheelLabel: 'Volante',
+    rpmLabel: 'RPM',
+    teethLabel: 'dientes',
+    gearRatioLabel: 'Relación',
+    powerFlowLabel: 'Flujo de Potencia',
+    movementLabel: 'Movimiento',
+    speedLabel: 'Velocidad',
+    speedNormal: '1x',
+    speedSlow: '0.5x',
+    speedPaused: 'Pausado',
+    mov2824: 'ETA 2824-2',
+    movElPrimero: 'El Primero',
+    movVintage: 'Vintage 18k',
+    step1: 'Seleccione un calibre de movimiento para ver sus relaciones de engranaje y frecuencia únicas.',
+    step2: 'Pase el ratón sobre cualquier engranaje o tarjeta de datos para resaltar su posición en el flujo de potencia.',
+    step3: 'Ajuste la velocidad de la animación para estudiar cómo cada engranaje transmite la potencia a través del tren.',
+    tipTitle: 'Consejo',
+    tipContent: 'El tren de engranajes reduce la rápida liberación de energía del muelle real en una oscilación controlada. Un barril típico rota una vez cada 7-8 horas, mientras que la rueda de escape gira a 32 RPM (a 28.800 VPH) — una reducción de más de 15.000:1.',
+  },
+  seo: [
+    { type: 'title', text: 'Explorador Interactivo de Tren de Engranajes', level: 2 },
+    { type: 'paragraph', html: 'El <strong>tren de engranajes</strong> es la columna vertebral mecánica de todo reloj mecánico. Esta herramienta interactiva visualiza cómo fluye la potencia desde el barril del muelle real a través de la rueda central, la tercera rueda, la cuarta rueda y la rueda de escape hasta la horquilla y el volante. Vea cada engranaje rotar a su velocidad proporcional y entienda cómo las relaciones de engranaje determinan la medición del tiempo.' },
+    { type: 'title', text: 'Cómo funciona un tren de engranajes', level: 3 },
+    { type: 'paragraph', html: 'Un tren de engranajes de un reloj consiste en una serie de <strong>ruedas</strong> (engranajes grandes) y <strong>piñones</strong> (engranajes pequeños) que transmiten potencia mientras reducen la velocidad. El <strong>barril</strong> alberga el muelle real y gira lentamente, impulsando la <strong>rueda central</strong> que gira una vez por hora (para la manecilla de los minutos). La <strong>tercera rueda</strong> y la <strong>cuarta rueda</strong> (rueda de segundos) aumentan aún más la velocidad de rotación. Finalmente, la <strong>rueda de escape</strong> libera la potencia en impulsos controlados hacia la <strong>horquilla del áncora</strong>, que alternativamente bloquea y desbloquea la rueda de escape, enviando impulsos al <strong>volante</strong>. El volante oscila a una frecuencia precisa — típicamente 4 Hz (28.800 vibraciones por hora) — regulando la marcha del reloj.' },
+    { type: 'title', text: 'Relaciones de Engranaje y Transmisión de Potencia', level: 3 },
+    {
+      type: 'table', headers: ['Componente', 'Dientes típicos', 'RPM (28.800 VPH)', 'Relación anterior'], rows: [
+        ['Barril', '72', '0,002 (1 rev / 8 h)', '-'],
+        ['Rueda Central', '60', '0,0167 (1 rev / h)', '~7,2:1'],
+        ['Tercera Rueda', '50', '0,125 (1 rev / 8 min)', '~5:1'],
+        ['Cuarta Rueda', '60', '1 (1 rev / min)', '6:1'],
+        ['Rueda de Escape', '15', '32', '~1,875:1'],
+      ]
+    },
+    { type: 'title', text: 'Comparación de Movimientos', level: 3 },
+    {
+      type: 'table', headers: ['Movimiento', 'Frecuencia', 'Volante', 'Rueda Escape RPM', 'Precisión típica'], rows: [
+        ['Vintage (18.000 VPH)', '18.000 bph', '2,5 Hz', '20 RPM', '±15-30 s/d'],
+        ['Estándar (28.800 VPH)', '28.800 bph', '4 Hz', '32 RPM', '±5-15 s/d'],
+        ['Alta Frecuencia (36.000 VPH)', '36.000 bph', '5 Hz', '40 RPM', '±3-8 s/d'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Herramienta de Aprendizaje Interactiva', icon: 'mdi:cog-clockwise', badge: 'RELOJERÍA', html: 'Esta herramienta utiliza relaciones de engranaje aproximadas representativas de movimientos comunes de escape de áncora suizo. Las relaciones reales varían según el calibre. Use los ajustes preestablecidos de movimiento para comparar cómo las diferentes frecuencias afectan la dinámica del tren de engranajes.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};
+

package/src/tool/gear-train-explorer/i18n/fr.ts

@@ -0,0 +1,99 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { GearTrainExplorerUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Qu\'est-ce qu\'un train d\'engrenages de montre?',
+    answer: 'Un train d\'engrenages est une série de roues dentées interconnectées qui transmettent l\'énergie du barillet au mécanisme d\'échappement. Chaque paire d\'engrenages fournit un rapport de réduction spécifique, ralentissant la libération rapide de l\'énergie du ressort en impulsions contrôlées et rythmées.',
+  },
+  {
+    question: 'Pourquoi différents mouvements ont-ils des rapports d\'engrenage différents?',
+    answer: 'Les rapports d\'engrenage sont déterminés par le nombre de dents sur chaque roue et pignon. Les mouvements avec des fréquences de balancier différentes (p. ex., 28 800 VPH vs 36 000 VPH) ont des vitesses de roue d\'échappement et des configurations d\'engrenage différentes pour maintenir une précision horaire tout en s\'adaptant à la fréquence du balancier.',
+  },
+  {
+    question: 'Quelle est la différence entre une roue et un pignon?',
+    answer: 'En horlogerie, une "roue" est le grand engrenage avec de nombreuses dents qui entraîne le composant suivant. Un "pignon" est le petit engrenage (généralement 6-12 dents) qui est entraîné. Ensemble, une roue et un pignon forment une paire d\'engrenages qui modifie la vitesse de rotation et le couple.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Sélectionnez un mouvement',
+    text: 'Choisissez entre un mouvement standard (28 800 VPH), haute fréquence (36 000 VPH El Primero) ou vintage (18 000 VPH). Chacun a des rapports d\'engrenage et des fréquences uniques.',
+  },
+  {
+    name: 'Observez le train d\'engrenages',
+    text: 'Regardez les engrenages animés tourner à des vitesses proportionnelles. Le barillet tourne lentement tandis que la roue d\'échappement tourne rapidement. Survolez un engrenage ou une carte de données pour obtenir des informations détaillées.',
+  },
+  {
+    name: 'Ajustez la vitesse',
+    text: 'Utilisez les contrôles de vitesse pour ralentir, accélérer ou mettre en pause l\'animation. Cela permet de visualiser comment chaque engrenage contribue à la chaîne de transmission de puissance.',
+  },
+];
+
+const title = 'Explorateur de Train d\'Engrenages: Diagramme Horloger Interactif';
+
+export const content: ToolLocaleContent<GearTrainExplorerUI> = {
+  slug: 'explorateurtrengrenages',
+  title,
+  description: 'Explorez le cœur mécanique d\'une montre avec une visualisation animée du train d\'engrenages. Voyez le barillet, la roue des minutes, la roue des heures, la roue des secondes, la roue d\'échappement, l\'ancre et le balancier en mouvement.',
+  ui: {
+    title: 'Explorateur de Train d\'Engrenages',
+    barrelLabel: 'Barillet',
+    centerWheelLabel: 'Roue Centrale',
+    thirdWheelLabel: 'Troisième Roue',
+    fourthWheelLabel: 'Quatrième Roue',
+    escapeWheelLabel: 'Roue d\'Échappement',
+    palletForkLabel: 'Ancre',
+    balanceWheelLabel: 'Balancier',
+    rpmLabel: 'tr/min',
+    teethLabel: 'dents',
+    gearRatioLabel: 'Rapport',
+    powerFlowLabel: 'Flux de Puissance',
+    movementLabel: 'Mouvement',
+    speedLabel: 'Vitesse',
+    speedNormal: '1x',
+    speedSlow: '0.5x',
+    speedPaused: 'Pause',
+    mov2824: 'ETA 2824-2',
+    movElPrimero: 'El Primero',
+    movVintage: 'Vintage 18k',
+    step1: 'Sélectionnez un calibre de mouvement pour voir ses rapports d\'engrenage et sa fréquence uniques.',
+    step2: 'Survolez un engrenage ou une carte de données pour mettre en évidence sa position dans le flux de puissance.',
+    step3: 'Ajustez la vitesse d\'animation pour étudier comment chaque roue transmet la puissance à travers le train.',
+    tipTitle: 'Astuce',
+    tipContent: 'Le train d\'engrenages réduit la libération rapide d\'énergie du ressort en une oscillation contrôlée. Un barillet typique tourne une fois toutes les 7-8 heures, tandis que la roue d\'échappement tourne à 32 tr/min (à 28 800 VPH) — une réduction de plus de 15 000:1.',
+  },
+  seo: [
+    { type: 'title', text: 'Explorateur Interactif de Train d\'Engrenages', level: 2 },
+    { type: 'paragraph', html: 'Le <strong>train d\'engrenages</strong> est l\'épine dorsale mécanique de toute montre mécanique. Cet outil interactif visualise comment la puissance circule du barillet à travers la roue centrale, la troisième roue, la quatrième roue et la roue d\'échappement jusqu\'à l\'ancre et le balancier. Voyez chaque roue tourner à sa vitesse proportionnelle et comprenez comment les rapports d\'engrenage déterminent la mesure du temps.' },
+    { type: 'title', text: 'Comment fonctionne un train d\'engrenages', level: 3 },
+    { type: 'paragraph', html: 'Un train d\'engrenages de montre se compose d\'une série de <strong>roues</strong> (grands engrenages) et de <strong>pignons</strong> (petits engrenages) qui transmettent la puissance tout en réduisant la vitesse. Le <strong>barillet</strong> contient le ressort moteur et tourne lentement, entraînant la <strong>roue centrale</strong> qui tourne une fois par heure (pour l\'aiguille des minutes). La <strong>troisième roue</strong> et la <strong>quatrième roue</strong> (roue des secondes) augmentent encore la vitesse de rotation. Enfin, la <strong>roue d\'échappement</strong> libère la puissance en impulsions contrôlées vers l\'<strong>ancre</strong>, qui verrouille et déverrouille alternativement la roue d\'échappement, envoyant des impulsions au <strong>balancier</strong>. Le balancier oscille à une fréquence précise — généralement 4 Hz (28 800 vibrations par heure) — régulant la marche de la montre.' },
+    { type: 'title', text: 'Rapports d\'Engrenage et Transmission de Puissance', level: 3 },
+    {
+      type: 'table', headers: ['Composant', 'Dents typiques', 'tr/min (28 800 VPH)', 'Rapport précédent'], rows: [
+        ['Barillet', '72', '0,002 (1 tr / 8 h)', '-'],
+        ['Roue Centrale', '60', '0,0167 (1 tr / h)', '~7,2:1'],
+        ['Troisième Roue', '50', '0,125 (1 tr / 8 min)', '~5:1'],
+        ['Quatrième Roue', '60', '1 (1 tr / min)', '6:1'],
+        ['Roue d\'Échappement', '15', '32', '~1,875:1'],
+      ]
+    },
+    { type: 'title', text: 'Comparaison des Mouvements', level: 3 },
+    {
+      type: 'table', headers: ['Mouvement', 'Fréquence', 'Balancier', 'Roue Échappement tr/min', 'Précision typique'], rows: [
+        ['Vintage (18 000 VPH)', '18 000 bph', '2,5 Hz', '20 tr/min', '±15-30 s/j'],
+        ['Standard (28 800 VPH)', '28 800 bph', '4 Hz', '32 tr/min', '±5-15 s/j'],
+        ['Haute Fréquence (36 000 VPH)', '36 000 bph', '5 Hz', '40 tr/min', '±3-8 s/j'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Outil d\'Apprentissage Interactif', icon: 'mdi:cog-clockwise', badge: 'HORLOGERIE', html: 'Cet outil utilise des rapports d\'engrenage approximatifs représentatifs des mouvements à échappement suisse courants. Les rapports réels varient selon le calibre. Utilisez les préréglages de mouvement pour comparer comment différentes fréquences affectent la dynamique du train d\'engrenages.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};
+