@jjlmoya/utils-chrono 1.11.0 → 1.17.0

package/src/tool/perpetual-calendar/entry.ts

@@ -0,0 +1,48 @@
+import type { ChronoToolEntry, ToolLocaleContent } from '../../types';
+
+export type PerpetualCalendarUI = {
+  title: string;
+  dateLabel: string;
+  dayLabel: string;
+  monthLabel: string;
+  yearLabel: string;
+  leapYearLabel: string;
+  moonPhaseLabel: string;
+  weekdayLabel: string;
+  advanceDay: string;
+  advanceMonth: string;
+  advanceYear: string;
+  autoPlay: string;
+  resetBtn: string;
+  dayNames: string;
+  monthNames: string;
+  tipTitle: string;
+  tipContent: string;
+  step1: string;
+  step2: string;
+  step3: string;
+};
+
+export type PerpetualCalendarLocaleContent = ToolLocaleContent<PerpetualCalendarUI>;
+
+export const perpetualCalendar: ChronoToolEntry<PerpetualCalendarUI> = {
+  id: 'perpetual-calendar',
+  icons: { bg: 'mdi:calendar-text', fg: 'mdi:calendar-month' },
+  i18n: {
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};

package/src/tool/perpetual-calendar/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/perpetual-calendar/i18n/de.ts

@@ -0,0 +1,85 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Was ist ein ewiger Kalender in einer Uhr?',
+    answer: 'Ein ewiger Kalender ist eine mechanische Uhrenkomplikation, die automatisch das korrekte Datum, den Wochentag, den Monat und die Mondphase anzeigt und dabei unterschiedliche Monatslängen und Schaltjahre berücksichtigt. Er ist bis zum Jahr 2100 programmiert (dem nächsten Jahrhundertjahr, das nicht durch 400 teilbar ist).',
+  },
+  {
+    question: 'Wie erkennt ein ewiger Kalender Schaltjahre?',
+    answer: 'Das mechanische Programm verwendet ein 48-Monats-Getriebe (4 Jahre) mit einer speziell geformten Kurvenscheibe, die den Schalttag am 29. Februar berücksichtigt. Der Mechanismus weiß, dass durch 100 teilbare Jahre keine Schaltjahre sind, es sei denn, sie sind auch durch 400 teilbar. Die meisten ewigen Kalender sind bis 2100 genau und benötigen dann eine Eintageskorrektur.',
+  },
+  {
+    question: 'Was ist der Unterschied zwischen einem ewigen und einem Jahreskalender?',
+    answer: 'Ein Jahreskalender benötigt eine manuelle Korrektur pro Jahr (Ende Februar), während ein ewiger Kalender Schaltjahre automatisch behandelt und jahrzehntelang korrekt läuft. Ewige Kalender sind mechanisch deutlich komplexer.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Datum vorwärts bewegen',
+    text: 'Verwenden Sie die Tasten D (Tag), M (Monat) und Y (Jahr), um den Kalender vorwärzubewegen. Beobachten Sie, wie sich der Datumszeiger bewegt und sich das Monatsfenster ändert.',
+  },
+  {
+    name: 'Schaltjahresübergänge beobachten',
+    text: 'Bewegen Sie sich durch den Februar eines Schaltjahres (z.B. 2024), um den Sprung vom 29. auf den 1. März zu sehen. Versuchen Sie es mit einem Nicht-Schaltjahr, um den Sprung vom 28. auf den 1. März zu beobachten.',
+  },
+  {
+    name: 'Automatischen Ablauf nutzen',
+    text: 'Drücken Sie auf Play, um den Kalender automatisch vorlaufen zu lassen. So sehen Sie den gesamten Zyklus der Monatslängen und den Fortschritt der Mondphase.',
+  },
+];
+
+const title = 'Ewiger Kalender Simulator: Interaktive Uhrenkomplikation';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'ewigerkalender',
+  title,
+  description: 'Entdecken Sie das mechanische Genie einer ewigen Kalender-Uhrenkomplikation. Visualisieren Sie Datum, Wochentag, Monat, Schaltjahrzyklus und Mondphase mit einem animierten Zifferblatt.',
+  ui: {
+    title: 'Ewiger Kalender Simulator',
+    dateLabel: 'Datum',
+    dayLabel: 'Tag',
+    monthLabel: 'Monat',
+    yearLabel: 'Jahr',
+    leapYearLabel: 'Schaltjahr',
+    moonPhaseLabel: 'Mondphase',
+    weekdayLabel: 'Wochentag',
+    advanceDay: 'Tag vor',
+    advanceMonth: 'Monat vor',
+    advanceYear: 'Jahr vor',
+    autoPlay: 'Auto',
+    resetBtn: 'Heute',
+    dayNames: 'Sonntag,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag',
+    monthNames: 'Januar,Februar,März,April,Mai,Juni,Juli,August,September,Oktober,November,Dezember',
+    tipTitle: 'Tipp',
+    tipContent: 'Die meisten ewigen Kalenderuhren verwenden ein 48-Monats-Programmräderwerk mit Kerben unterschiedlicher Länge. Der Februar hat die kürzeste Kerbe (28 Tage in Normaljahren, 29 in Schaltjahren), während 30- und 31-Tage-Monate progressiv längere Kerben haben.',
+    step1: 'Bewegen Sie sich Tag für Tag durch den Februar, um zu sehen, wie der Mechanismus Monatsübergänge bewältigt.',
+    step2: 'Verfolgen Sie den Fortschritt der Mondphasenanziege durch ihren 29,5-Tage-Zyklus.',
+    step3: 'Vergleichen Sie die Februar-Übergänge von Schaltjahren und Normaljahren, um den 4-Jahres-Zyklus zu verstehen.',
+  },
+  seo: [
+    { type: 'title', text: 'Ewiger Kalender Simulator: Interaktive Uhrenkomplikation', level: 2 },
+    { type: 'paragraph', html: 'Der <strong>ewige Kalender</strong> ist eine der prestigeträchtigsten Komplikationen der Haute Horlogerie. Dieser interaktive Simulator visualisiert, wie ein mechanischer ewiger Kalender Datum, Wochentag, Monat, Schaltjahr und Mondphase verfolgt — jahrzehntelang ohne manuelle Korrektur. Erkunden Sie das 48-Monats-Getriebeprogramm, sehen Sie wie Februar-Übergänge funktionieren und verstehen Sie die in diesen Meisterwerken der Mikromechanik integrierte gregorianische Kalenderlogik.' },
+    { type: 'title', text: 'Wie ein ewiger Kalender funktioniert', level: 3 },
+    { type: 'paragraph', html: 'Ein mechanischer ewiger Kalender verwendet ein <strong>Programmräderwerk</strong> mit Kerben unterschiedlicher Tiefe, die die verschiedenen Monatslängen repräsentieren. Ein Abtasthebel fällt in jede Kerbe; eine tiefere Kerbe signalisiert einen kurzen Monat (28-29 Tage) und löst den Mechanismus aus, nach der korrekten Anzahl von Tagen auf den 1. des nächsten Monats vorzuspringen. Ein <strong>48-Monats-Getriebe</strong> bewältigt den 4-Jahres-Schaltjahrzyklus mit einer zusätzlichen Kerbe für den 29. Februar. Das Programm weiß, dass Jahrhundertjahre (z.B. 2100) das Schaltjahr auslassen, es sei denn, sie sind durch 400 teilbar.' },
+    { type: 'title', text: 'Vergleich: Ewiger vs. Jahreskalender', level: 3 },
+    {
+      type: 'table', headers: ['Merkmal', 'Jahreskalender', 'Ewiger Kalender'], rows: [
+        ['Erfordert Korrektur', 'Einmal pro Jahr (1. März)', 'Einmal pro Jahrhundert (2100)'],
+        ['Schaltjahrhandhabung', 'Manuell', 'Automatisch (4-Jahres-Nocken)'],
+        ['Monatserkennung', '30 vs 31 Tage', 'Vollständig 28/29/30/31'],
+        ['Komplexität', 'Mäßig (~50 Teile)', 'Sehr hoch (~200+ Teile)'],
+        ['Preisspanne', '3.000-15.000 €', '20.000-500.000+ €'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Interaktiver Kalender Simulator', icon: 'mdi:calendar-month', badge: 'UHRMACHEREI', html: 'Dieses Tool simuliert den Kalendermechanismus einer ewigen Kalenderuhr. Das animierte Zifferblatt zeigt den Datumszeiger, das Monatsfenster, den Wochentag-Subdial, die Mondphase und den Schaltjahresindikator. Nutzen Sie die Steuerung, um durch Tage, Monate oder Jahre zu blättern und die mechanische Logik in Aktion zu beobachten.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/perpetual-calendar/i18n/en.ts

@@ -0,0 +1,102 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'What is a perpetual calendar watch?',
+    answer: 'A perpetual calendar is a mechanical watch complication that displays the correct date, day, month, and moon phase automatically, accounting for months of different lengths and leap years. It is programmed to be accurate until the year 2100 (the next century year not divisible by 400).',
+  },
+  {
+    question: 'How does a perpetual calendar know leap years?',
+    answer: 'The mechanical program uses a 48-month gear (4 years) with a specially designed cam that accounts for the February 29th leap day. The mechanism knows that years divisible by 100 are not leap years unless also divisible by 400. Most perpetual calendars are accurate until 2100, which will require a one-day correction.',
+  },
+  {
+    question: 'What is the difference between a perpetual and an annual calendar?',
+    answer: 'An annual calendar requires one manual correction per year (at the end of February), while a perpetual calendar automatically handles leap years and continues correctly for decades or centuries. Perpetual calendars are significantly more complex mechanically.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Advance the date',
+    text: 'Use the D (day), M (month), and Y (year) buttons to advance the calendar forward. Watch the date hand sweep and the month window change.',
+  },
+  {
+    name: 'Observe leap year transitions',
+    text: 'Advance through February of a leap year (e.g., 2024) to see the date jump from 29 to March 1. Try a non-leap year to see it skip from 28 to March 1.',
+  },
+  {
+    name: 'Use auto-play',
+    text: 'Press play to watch the calendar automatically advance. This reveals the full cycle of month lengths and the moon phase progression.',
+  },
+];
+
+const title = 'Perpetual Calendar Simulator: Interactive Watch Complication';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'perpetual-calendar',
+  title,
+  description: 'Explore the mechanical genius of a perpetual calendar watch complication. Visualize date, day, month, leap year cycle, and moon phase with an animated dial.',
+  ui: {
+    title: 'Perpetual Calendar Simulator',
+    dateLabel: 'Date',
+    dayLabel: 'Day',
+    monthLabel: 'Month',
+    yearLabel: 'Year',
+    leapYearLabel: 'Leap Year',
+    moonPhaseLabel: 'Moon Phase',
+    weekdayLabel: 'Weekday',
+    advanceDay: 'Advance Day',
+    advanceMonth: 'Advance Month',
+    advanceYear: 'Advance Year',
+    autoPlay: 'Auto Play',
+    resetBtn: 'Today',
+    dayNames: 'Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday',
+    monthNames: 'January,February,March,April,May,June,July,August,September,October,November,December',
+    tipTitle: 'Tip',
+    tipContent: 'Most perpetual calendar watches use a 48-month program wheel with notches of varying lengths. February has the shortest notch (28 days in common years, 29 in leap years), while 30-day and 31-day months have progressively longer notches.',
+    step1: 'Advance day by day past February to see how the mechanism handles month-end transitions.',
+    step2: 'Watch the moon phase indicator progress through its 29.5-day cycle.',
+    step3: 'Compare leap year vs. common year February transitions to understand the 4-year cycle.',
+  },
+  seo: [
+    { type: 'title', text: 'Perpetual Calendar Simulator: Interactive Watch Complication', level: 2 },
+    { type: 'paragraph', html: 'The <strong>perpetual calendar</strong> is one of the most prestigious complications in haute horlogerie. This interactive simulator visualizes how a mechanical perpetual calendar tracks date, day, month, leap year, and moon phase — all without manual correction for decades. Explore the 48-month gear program, see how February transitions work, and understand the gregorian calendar logic built into these masterpieces of micro-mechanics.' },
+    { type: 'title', text: 'How a Perpetual Calendar Works', level: 3 },
+    { type: 'paragraph', html: 'A mechanical perpetual calendar uses a <strong>program wheel</strong> with notches of different depths representing months of different lengths. A sensing lever drops into each notch; a deeper notch signals a short month (28-29 days), triggering the mechanism to advance to the 1st of the next month after the correct number of days. A <strong>48-month gear</strong> handles the 4-year leap year cycle, with an extra notch for February 29th. The program knows that century years (e.g., 2100) skip leap year unless divisible by 400.' },
+    { type: 'title', text: 'Calendar Logic Reference', level: 3 },
+    {
+      type: 'table', headers: ['Month', 'Days', 'Notch Depth', 'Leap Year Action'], rows: [
+        ['January', '31', 'Deep', 'Normal'],
+        ['February', '28 / 29', 'Shallowest', 'Extra day every 4 years'],
+        ['March', '31', 'Deep', 'Normal'],
+        ['April', '30', 'Medium', 'Normal'],
+        ['May', '31', 'Deep', 'Normal'],
+        ['June', '30', 'Medium', 'Normal'],
+        ['July', '31', 'Deep', 'Normal'],
+        ['August', '31', 'Deep', 'Normal'],
+        ['September', '30', 'Medium', 'Normal'],
+        ['October', '31', 'Deep', 'Normal'],
+        ['November', '30', 'Medium', 'Normal'],
+        ['December', '31', 'Deep', 'Normal'],
+      ]
+    },
+    { type: 'title', text: 'Perpetual vs Annual Calendar', level: 3 },
+    {
+      type: 'table', headers: ['Feature', 'Annual Calendar', 'Perpetual Calendar'], rows: [
+        ['Requires adjustment', 'Once per year (Mar 1)', 'Once per century (2100)'],
+        ['Leap year handling', 'Manual', 'Automatic (4-year cam)'],
+        ['Month recognition', '30 vs 31 days', 'Full 28/29/30/31'],
+        ['Complexity', 'Moderate (~50 parts)', 'Very high (~200+ parts)'],
+        ['Price range', '$3,000 - $15,000', '$20,000 - $500,000+'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Interactive Calendar Simulator', icon: 'mdi:calendar-month', badge: 'HOROLOGY', html: 'This tool simulates the calendar mechanism of a perpetual calendar watch. The animated dial shows the date hand, month window, day subdial, moon phase, and leap year indicator. Use the controls to advance through days, months, or years and observe the mechanical logic in action.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/perpetual-calendar/i18n/es.ts

@@ -0,0 +1,85 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: '¿Qué es un calendario perpetuo en un reloj?',
+    answer: 'Un calendario perpetuo es una complicación de reloj mecánica que muestra automáticamente la fecha, el día, el mes y la fase lunar correctos, teniendo en cuenta los meses de diferente duración y los años bisiestos. Está programado para ser preciso hasta el año 2100 (el próximo año secular no divisible por 400).',
+  },
+  {
+    question: '¿Cómo sabe un calendario perpetuo los años bisiestos?',
+    answer: 'El programa mecánico utiliza un engranaje de 48 meses (4 años) con una leva diseñada especialmente que contabiliza el día bisiesto del 29 de febrero. El mecanismo sabe que los años divisibles por 100 no son bisiestos a menos que también sean divisibles por 400. La mayoría de los calendarios perpetuos son precisos hasta 2100, cuando requerirán una corrección de un día.',
+  },
+  {
+    question: '¿Cuál es la diferencia entre un calendario perpetuo y un calendario anual?',
+    answer: 'Un calendario anual requiere una corrección manual al año (al final de febrero), mientras que un calendario perpetuo maneja automáticamente los años bisiestos y funciona correctamente durante décadas. Los calendarios perpetuos son significativamente más complejos mecánicamente.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Avance la fecha',
+    text: 'Use los botones D (día), M (mes) y Y (año) para avanzar el calendario. Observe cómo se mueve la aguja de fecha y cambia la ventana del mes.',
+  },
+  {
+    name: 'Observe las transiciones de año bisiesto',
+    text: 'Avance a través de febrero de un año bisiesto (ej. 2024) para ver el salto del 29 al 1 de marzo. Pruebe con un año no bisiesto para ver el salto del 28 al 1 de marzo.',
+  },
+  {
+    name: 'Use la reproducción automática',
+    text: 'Presione play para que el calendario avance automáticamente. Esto revela el ciclo completo de duraciones de meses y la progresión de la fase lunar.',
+  },
+];
+
+const title = 'Simulador de Calendario Perpetuo: Complicación de Reloj Interactiva';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'calendario-perpetuo',
+  title,
+  description: 'Explore el genio mecánico de una complicación de calendario perpetuo. Visualice fecha, día, mes, ciclo de año bisiesto y fase lunar con una esfera animada.',
+  ui: {
+    title: 'Simulador de Calendario Perpetuo',
+    dateLabel: 'Fecha',
+    dayLabel: 'Día',
+    monthLabel: 'Mes',
+    yearLabel: 'Año',
+    leapYearLabel: 'Bisiesto',
+    moonPhaseLabel: 'Fase Lunar',
+    weekdayLabel: 'Día Semana',
+    advanceDay: 'Avanzar Día',
+    advanceMonth: 'Avanzar Mes',
+    advanceYear: 'Avanzar Año',
+    autoPlay: 'Auto',
+    resetBtn: 'Hoy',
+    dayNames: 'Domingo,Lunes,Martes,Miércoles,Jueves,Viernes,Sábado',
+    monthNames: 'Enero,Febrero,Marzo,Abril,Mayo,Junio,Julio,Agosto,Septiembre,Octubre,Noviembre,Diciembre',
+    tipTitle: 'Consejo',
+    tipContent: 'La mayoría de los relojes de calendario perpetuo usan una rueda de programa de 48 meses con muescas de longitud variable. Febrero tiene la muesca más corta (28 días en años comunes, 29 en bisiestos), mientras que los meses de 30 y 31 días tienen muescas progresivamente más largas.',
+    step1: 'Avance día a día pasado febrero para ver cómo el mecanismo maneja las transiciones de fin de mes.',
+    step2: 'Observe el indicador de fase lunar progresar a través de su ciclo de 29.5 días.',
+    step3: 'Compare las transiciones de febrero en años bisiestos vs. comunes para entender el ciclo de 4 años.',
+  },
+  seo: [
+    { type: 'title', text: 'Simulador de Calendario Perpetuo: Complicación Interactiva', level: 2 },
+    { type: 'paragraph', html: 'El <strong>calendario perpetuo</strong> es una de las complicaciones más prestigiosas de la alta relojería. Este simulador interactivo visualiza cómo un calendario perpetuo mecánico rastrea fecha, día, mes, año bisiesto y fase lunar — todo sin corrección manual durante décadas. Explore el programa de engranaje de 48 meses, vea cómo funcionan las transiciones de febrero y entienda la lógica del calendario gregoriano incorporada en estas obras maestras de la micromecánica.' },
+    { type: 'title', text: 'Cómo funciona un calendario perpetuo', level: 3 },
+    { type: 'paragraph', html: 'Un calendario perpetuo mecánico utiliza una <strong>rueda de programa</strong> con muescas de diferentes profundidades que representan los meses de distintas duraciones. Un brazo sensor cae en cada muesca; una muesca más profunda señala un mes corto (28-29 días), activando el mecanismo para avanzar al 1 del mes siguiente después del número correcto de días. Un <strong>engranaje de 48 meses</strong> maneja el ciclo de 4 años bisiestos, con una muesca extra para el 29 de febrero. El programa sabe que los años centenarios (ej. 2100) omiten el año bisiesto a menos que sean divisibles por 400.' },
+    { type: 'title', text: 'Comparación: Calendario Perpetuo vs Anual', level: 3 },
+    {
+      type: 'table', headers: ['Característica', 'Calendario Anual', 'Calendario Perpetuo'], rows: [
+        ['Requiere ajuste', 'Una vez al año (1 Mar)', 'Una vez por siglo (2100)'],
+        ['Manejo de bisiestos', 'Manual', 'Automático (leva 4 años)'],
+        ['Reconocimiento de mes', '30 vs 31 días', 'Completo 28/29/30/31'],
+        ['Complejidad', 'Moderada (~50 piezas)', 'Muy alta (~200+ piezas)'],
+        ['Rango de precio', '3.000-15.000 €', '20.000-500.000+ €'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Simulador de Calendario Interactivo', icon: 'mdi:calendar-month', badge: 'RELOJERÍA', html: 'Esta herramienta simula el mecanismo de calendario de un reloj de calendario perpetuo. La esfera animada muestra la aguja de fecha, la ventana de mes, el subdial de día, la fase lunar y el indicador de año bisiesto. Use los controles para avanzar por días, meses o años y observe la lógica mecánica en acción.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/perpetual-calendar/i18n/fr.ts

@@ -0,0 +1,85 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Qu\'est-ce qu\'un calendrier perpétuel dans une montre?',
+    answer: 'Un calendrier perpétuel est une complication horlogère mécanique qui affiche automatiquement la date, le jour, le mois et la phase de lune corrects, en tenant compte des mois de différentes longueurs et des années bissextiles. Il est programmé pour être précis jusqu\'en 2100 (la prochaine année séculaire non divisible par 400).',
+  },
+  {
+    question: 'Comment un calendrier perpétuel connaît-il les années bissextiles?',
+    answer: 'Le programme mécanique utilise un engrenage de 48 mois (4 ans) avec une came spécialement conçue qui tient compte du 29 février. Le mécanisme sait que les années divisibles par 100 ne sont pas bissextiles sauf si elles sont également divisibles par 400. La plupart des calendriers perpétuels sont précis jusqu\'en 2100, date à laquelle une correction d\'un jour sera nécessaire.',
+  },
+  {
+    question: 'Quelle est la différence entre un calendrier perpétuel et un calendrier annuel?',
+    answer: 'Un calendrier annuel nécessite une correction manuelle par an (fin février), tandis qu\'un calendrier perpétuel gère automatiquement les années bissextiles et continue correctement pendant des décennies. Les calendriers perpétuels sont mécaniquement bien plus complexes.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Avancez la date',
+    text: 'Utilisez les boutons J (jour), M (mois) et A (année) pour faire avancer le calendrier. Regardez l\'aiguille de date se déplacer et la fenêtre du mois changer.',
+  },
+  {
+    name: 'Observez les transitions d\'année bissextile',
+    text: 'Avancez à travers février d\'une année bissextile (ex. 2024) pour voir le saut du 29 au 1er mars. Essayez une année non bissextile pour voir le saut du 28 au 1er mars.',
+  },
+  {
+    name: 'Utilisez la lecture automatique',
+    text: 'Appuyez sur lecture pour faire avancer le calendrier automatiquement. Cela révèle le cycle complet des longueurs de mois et la progression de la phase lunaire.',
+  },
+];
+
+const title = 'Simulateur de Calendrier Perpétuel: Complication Horlogère Interactive';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'calendrier-perpetuel',
+  title,
+  description: 'Explorez le génie mécanique d\'une complication de calendrier perpétuel. Visualisez la date, le jour, le mois, le cycle des années bissextiles et la phase lunaire avec un cadran animé.',
+  ui: {
+    title: 'Simulateur de Calendrier Perpétuel',
+    dateLabel: 'Date',
+    dayLabel: 'Jour',
+    monthLabel: 'Mois',
+    yearLabel: 'Année',
+    leapYearLabel: 'Bissextile',
+    moonPhaseLabel: 'Phase Lune',
+    weekdayLabel: 'Semaine',
+    advanceDay: 'Avancer Jour',
+    advanceMonth: 'Avancer Mois',
+    advanceYear: 'Avancer Année',
+    autoPlay: 'Auto',
+    resetBtn: 'Aujourd\'hui',
+    dayNames: 'Dimanche,Lundi,Mardi,Mercredi,Jeudi,Vendredi,Samedi',
+    monthNames: 'Janvier,Février,Mars,Avril,Mai,Juin,Juillet,Août,Septembre,Octobre,Novembre,Décembre',
+    tipTitle: 'Astuce',
+    tipContent: 'La plupart des montres à calendrier perpétuel utilisent une roue de programme de 48 mois avec des encoches de longueur variable. Février a l\'encoche la plus courte (28 jours en années communes, 29 en bissextiles), tandis que les mois de 30 et 31 jours ont des encoches progressivement plus longues.',
+    step1: 'Avancez jour après jour passé février pour voir comment le mécanisme gère les transitions de fin de mois.',
+    step2: 'Regardez l\'indicateur de phase lunaire progresser à travers son cycle de 29,5 jours.',
+    step3: 'Comparez les transitions de février entre années bissextiles et communes pour comprendre le cycle de 4 ans.',
+  },
+  seo: [
+    { type: 'title', text: 'Simulateur de Calendrier Perpétuel: Complication Interactif', level: 2 },
+    { type: 'paragraph', html: 'Le <strong>calendrier perpétuel</strong> est l\'une des complications les plus prestigieuses de la haute horlogerie. Ce simulateur interactif visualise comment un calendrier perpétuel mécanique suit la date, le jour, le mois, l\'année bissextile et la phase lunaire — sans correction manuelle pendant des décennies. Explorez le programme d\'engrenage de 48 mois, voyez comment fonctionnent les transitions de février et comprenez la logique du calendrier grégorien intégrée dans ces chefs-d\'œuvre de micromécanique.' },
+    { type: 'title', text: 'Comment fonctionne un calendrier perpétuel', level: 3 },
+    { type: 'paragraph', html: 'Un calendrier perpétuel mécanique utilise une <strong>roue de programme</strong> avec des encoches de différentes profondeurs représentant les mois de différentes longueurs. Un levier de détection tombe dans chaque encoche; une encoche plus profonde signale un mois court (28-29 jours), déclenchant le mécanisme pour avancer au 1er du mois suivant après le nombre correct de jours. Un <strong>engrenage de 48 mois</strong> gère le cycle de 4 ans des années bissextiles, avec une encoche supplémentaire pour le 29 février. Le programme sait que les années séculaires (ex. 2100) sautent l\'année bissextile sauf si elles sont divisibles par 400.' },
+    { type: 'title', text: 'Comparaison: Calendrier Perpétuel vs Annuel', level: 3 },
+    {
+      type: 'table', headers: ['Caractéristique', 'Calendrier Annuel', 'Calendrier Perpétuel'], rows: [
+        ['Nécessite ajustement', 'Une fois par an (1 Mars)', 'Une fois par siècle (2100)'],
+        ['Gestion des bissextiles', 'Manuelle', 'Automatique (came 4 ans)'],
+        ['Reconnaissance des mois', '30 vs 31 jours', 'Complet 28/29/30/31'],
+        ['Complexité', 'Modérée (~50 pièces)', 'Très élevée (~200+ pièces)'],
+        ['Fourchette de prix', '3 000-15 000 €', '20 000-500 000+ €'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Simulateur de Calendrier Interactif', icon: 'mdi:calendar-month', badge: 'HORLOGERIE', html: 'Cet outil simule le mécanisme calendaire d\'une montre à calendrier perpétuel. Le cadran animé montre l\'aiguille de date, la fenêtre de mois, le sous-cadran du jour, la phase lunaire et l\'indicateur d\'année bissextile. Utilisez les commandes pour avancer par jours, mois ou années et observez la logique mécanique en action.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/perpetual-calendar/i18n/id.ts

@@ -0,0 +1,85 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Apa itu kalender abadi pada jam tangan?',
+    answer: 'Kalender abadi adalah komplikasi jam tangan mekanis yang secara otomatis menampilkan tanggal, hari, bulan, dan fase bulan yang benar, dengan memperhitungkan bulan dengan panjang berbeda dan tahun kabisat. Ia diprogram untuk akurat hingga tahun 2100 (tahun abad berikutnya yang tidak habis dibagi 400).',
+  },
+  {
+    question: 'Bagaimana kalender abadi mengetahui tahun kabisat?',
+    answer: 'Program mekanis menggunakan roda gigi 48 bulan (4 tahun) dengan kam yang dirancang khusus yang memperhitungkan 29 Februari. Mekanismenya tahu bahwa tahun yang habis dibagi 100 bukanlah tahun kabisat kecuali juga habis dibagi 400. Kebanyakan kalender abadi akurat hingga 2100, saat koreksi satu hari akan diperlukan.',
+  },
+  {
+    question: 'Apa perbedaan antara kalender abadi dan kalender tahunan?',
+    answer: 'Kalender tahunan memerlukan koreksi manual setahun sekali (akhir Februari), sedangkan kalender abadi secara otomatis menangani tahun kabisat dan terus berjalan benar selama puluhan tahun. Kalender abadi secara mekanis jauh lebih kompleks.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Majuukan tanggal',
+    text: 'Gunakan tombol T (tanggal), B (bulan), dan T (tahun) untuk memajukan kalender. Amati jarum tanggal bergerak dan jendela bulan berubah.',
+  },
+  {
+    name: 'Amati transisi tahun kabisat',
+    text: 'Maju melalui Februari tahun kabisat (mis. 2024) untuk melihat lompatan dari 29 ke 1 Maret. Coba tahun non-kabisat untuk melihat lompatan dari 28 ke 1 Maret.',
+  },
+  {
+    name: 'Gunakan putar otomatis',
+    text: 'Tekan play untuk memajukan kalender secara otomatis. Ini mengungkapkan siklus lengkap panjang bulan dan progresi fase bulan.',
+  },
+];
+
+const title = 'Simulator Kalender Abadi: Komplikasi Jam Tangan Interaktif';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'kalender-abadi',
+  title,
+  description: 'Jelajahi kejeniusan mekanis komplikasi kalender abadi. Visualisasikan tanggal, hari, bulan, siklus tahun kabisat, dan fase bulan dengan dial animasi.',
+  ui: {
+    title: 'Simulator Kalender Abadi',
+    dateLabel: 'Tanggal',
+    dayLabel: 'Hari',
+    monthLabel: 'Bulan',
+    yearLabel: 'Tahun',
+    leapYearLabel: 'Kabisat',
+    moonPhaseLabel: 'Fase Bulan',
+    weekdayLabel: 'Hari',
+    advanceDay: 'Maju Hari',
+    advanceMonth: 'Maju Bulan',
+    advanceYear: 'Maju Tahun',
+    autoPlay: 'Otomatis',
+    resetBtn: 'Hari Ini',
+    dayNames: 'Minggu,Senin,Selasa,Rabu,Kamis,Jumat,Sabtu',
+    monthNames: 'Januari,Februari,Maret,April,Mei,Juni,Juli,Agustus,September,Oktober,November,Desember',
+    tipTitle: 'Tip',
+    tipContent: 'Kebanyakan jam tangan kalender abadi menggunakan roda program 48 bulan dengan lekukan panjang variabel. Februari memiliki lekukan terpendek (28 hari di tahun biasa, 29 di tahun kabisat), sementara bulan 30 dan 31 hari memiliki lekukan yang semakin panjang.',
+    step1: 'Maju hari demi hari melewati Februari untuk melihat bagaimana mekanisme menangani transisi akhir bulan.',
+    step2: 'Amati indikator fase bulan berkembang melalui siklus 29,5 harinya.',
+    step3: 'Bandingkan transisi Februari antara tahun kabisat dan biasa untuk memahami siklus 4 tahun.',
+  },
+  seo: [
+    { type: 'title', text: 'Simulator Kalender Abadi: Komplikasi Interaktif', level: 2 },
+    { type: 'paragraph', html: '<strong>Kalender abadi</strong> adalah salah satu komplikasi paling prestisius dalam haute horlogerie. Simulator interaktif ini memvisualisasikan bagaimana kalender abadi mekanis melacak tanggal, hari, bulan, tahun kabisat, dan fase bulan — tanpa koreksi manual selama puluhan tahun. Jelajahi program roda gigi 48 bulan, lihat bagaimana transisi Februari bekerja, dan pahami logika kalender Gregorian yang tertanam dalam mahakarya mikromekanik ini.' },
+    { type: 'title', text: 'Cara kerja kalender abadi', level: 3 },
+    { type: 'paragraph', html: 'Kalender abadi mekanis menggunakan <strong>roda program</strong> dengan lekukan kedalaman berbeda yang mewakili bulan dengan panjang berbeda. Lengan sensor jatuh ke setiap lekukan; lekukan yang lebih dalam menandakan bulan pendek (28-29 hari), memicu mekanisme untuk melompat ke tanggal 1 bulan berikutnya setelah jumlah hari yang benar. <strong>Roda gigi 48 bulan</strong> menangani siklus 4 tahun kabisat, dengan lekukan tambahan untuk 29 Februari. Program tahu bahwa tahun abad (mis. 2100) melewatkan tahun kabisat kecuali habis dibagi 400.' },
+    { type: 'title', text: 'Perbandingan: Kalender Abadi vs Tahunan', level: 3 },
+    {
+      type: 'table', headers: ['Fitur', 'Kalender Tahunan', 'Kalender Abadi'], rows: [
+        ['Perlu penyesuaian', 'Setahun sekali (1 Mar)', 'Seabad sekali (2100)'],
+        ['Penanganan kabisat', 'Manual', 'Otomatis (kam 4 tahun)'],
+        ['Pengenalan bulan', '30 vs 31 hari', 'Penuh 28/29/30/31'],
+        ['Kompleksitas', 'Sedang (~50 bagian)', 'Sangat tinggi (~200+ bagian)'],
+        ['Kisaran harga', '€3.000-15.000', '€20.000-500.000+'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Simulator Kalender Interaktif', icon: 'mdi:calendar-month', badge: 'HOROLOGI', html: 'Alat ini mensimulasikan mekanisme kalender dari jam tangan kalender abadi. Dial animasi menunjukkan jarum tanggal, jendela bulan, subdial hari, fase bulan, dan indikator tahun kabisat. Gunakan kontrol untuk maju melalui hari, bulan, atau tahun dan amati logika mekanis dalam aksi.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/perpetual-calendar/i18n/it.ts

@@ -0,0 +1,85 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { PerpetualCalendarUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: 'Che cos\'è un calendario perpetuo in un orologio?',
+    answer: 'Un calendario perpetuo è una complicazione orologiera meccanica che mostra automaticamente la data, il giorno, il mese e la fase lunare corretti, tenendo conto dei mesi di diversa lunghezza e degli anni bisestili. È programmato per essere preciso fino all\'anno 2100 (il prossimo anno secolare non divisibile per 400).',
+  },
+  {
+    question: 'Come fa un calendario perpetuo a conoscere gli anni bisestili?',
+    answer: 'Il programma meccanico utilizza un ingranaggio di 48 mesi (4 anni) con una camma appositamente progettata che tiene conto del 29 febbraio. Il meccanismo sa che gli anni divisibili per 100 non sono bisestili a meno che non siano anche divisibili per 400. La maggior parte dei calendari perpetui sono precisi fino al 2100, quando richiederanno una correzione di un giorno.',
+  },
+  {
+    question: 'Qual è la differenza tra un calendario perpetuo e un calendario annuale?',
+    answer: 'Un calendario annuale richiede una correzione manuale all\'anno (alla fine di febbraio), mentre un calendario perpetuo gestisce automaticamente gli anni bisestili e continua correttamente per decenni. I calendari perpetui sono meccanicamente molto più complessi.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Avanzare la data',
+    text: 'Usa i pulsanti G (giorno), M (mese) e A (anno) per avanzare il calendario. Osserva la lancetta della data muoversi e la finestra del mese cambiare.',
+  },
+  {
+    name: 'Osservare le transizioni bisestili',
+    text: 'Avanza attraverso febbraio di un anno bisestile (es. 2024) per vedere il salto dal 29 al 1 marzo. Prova con un anno non bisestile per vedere il salto dal 28 al 1 marzo.',
+  },
+  {
+    name: 'Usare la riproduzione automatica',
+    text: 'Premi play per far avanzare automaticamente il calendario. Questo rivela l\'intero ciclo delle lunghezze dei mesi e la progressione della fase lunare.',
+  },
+];
+
+const title = 'Simulatore di Calendario Perpetuo: Complicazione Orologiera Interattiva';
+
+export const content: ToolLocaleContent<PerpetualCalendarUI> = {
+  slug: 'calendario-perpetuo-italiano',
+  title,
+  description: 'Esplora il genio meccanico di una complicazione calendario perpetuo. Visualizza data, giorno, mese, ciclo degli anni bisestili e fase lunare con un quadrante animato.',
+  ui: {
+    title: 'Simulatore di Calendario Perpetuo',
+    dateLabel: 'Data',
+    dayLabel: 'Giorno',
+    monthLabel: 'Mese',
+    yearLabel: 'Anno',
+    leapYearLabel: 'Bisestile',
+    moonPhaseLabel: 'Fase Lunare',
+    weekdayLabel: 'Settimana',
+    advanceDay: 'Avanti Giorno',
+    advanceMonth: 'Avanti Mese',
+    advanceYear: 'Avanti Anno',
+    autoPlay: 'Auto',
+    resetBtn: 'Oggi',
+    dayNames: 'Domenica,Lunedì,Martedì,Mercoledì,Giovedì,Venerdì,Sabato',
+    monthNames: 'Gennaio,Febbraio,Marzo,Aprile,Maggio,Giugno,Luglio,Agosto,Settembre,Ottobre,Novembre,Dicembre',
+    tipTitle: 'Consiglio',
+    tipContent: 'La maggior parte degli orologi con calendario perpetuo utilizza una ruota programma di 48 mesi con tacche di lunghezza variabile. Febbraio ha la tacca più corta (28 giorni negli anni comuni, 29 nei bisestili), mentre i mesi di 30 e 31 giorni hanno tacche progressivamente più lunghe.',
+    step1: 'Avanza giorno per giorno oltre febbraio per vedere come il meccanismo gestisce le transizioni di fine mese.',
+    step2: 'Osserva l\'indicatore di fase lunare progredire attraverso il suo ciclo di 29,5 giorni.',
+    step3: 'Confronta le transizioni di febbraio tra anni bisestili e comuni per comprendere il ciclo di 4 anni.',
+  },
+  seo: [
+    { type: 'title', text: 'Simulatore di Calendario Perpetuo: Complicazione Interattiva', level: 2 },
+    { type: 'paragraph', html: 'Il <strong>calendario perpetuo</strong> è una delle complicazioni più prestigiose dell\'alta orologeria. Questo simulatore interattivo visualizza come un calendario perpetuo meccanico tiene traccia di data, giorno, mese, anno bisestile e fase lunare — senza correzione manuale per decenni. Esplora il programma ad ingranaggio di 48 mesi, vedi come funzionano le transizioni di febbraio e comprendi la logica del calendario gregoriano incorporata in questi capolavori di micromeccanica.' },
+    { type: 'title', text: 'Come funziona un calendario perpetuo', level: 3 },
+    { type: 'paragraph', html: 'Un calendario perpetuo meccanico utilizza una <strong>ruota programma</strong> con tacche di diverse profondità che rappresentano i mesi di diversa lunghezza. Un leva sensore cade in ogni tacca; una tacca più profonda segnala un mese corto (28-29 giorni), attivando il meccanismo per avanzare al 1 del mese successivo dopo il numero corretto di giorni. Un <strong>ingranaggio di 48 mesi</strong> gestisce il ciclo di 4 anni bisestili, con una tacca extra per il 29 febbraio. Il programma sa che gli anni secolari (es. 2100) saltano l\'anno bisestile a meno che non siano divisibili per 400.' },
+    { type: 'title', text: 'Confronto: Calendario Perpetuo vs Annuale', level: 3 },
+    {
+      type: 'table', headers: ['Caratteristica', 'Calendario Annuale', 'Calendario Perpetuo'], rows: [
+        ['Richiede regolazione', 'Una volta all\'anno (1 Mar)', 'Una volta per secolo (2100)'],
+        ['Gestione bisestili', 'Manuale', 'Automatica (camma 4 anni)'],
+        ['Riconoscimento mesi', '30 vs 31 giorni', 'Completo 28/29/30/31'],
+        ['Complessità', 'Moderata (~50 pezzi)', 'Molto alta (~200+ pezzi)'],
+        ['Fascia di prezzo', '3.000-15.000 €', '20.000-500.000+ €'],
+      ]
+    },
+    { type: 'diagnostic', variant: 'info', title: 'Simulatore di Calendario Interattivo', icon: 'mdi:calendar-month', badge: 'OROLOGERIA', html: 'Questo strumento simula il meccanismo calendario di un orologio a calendario perpetuo. Il quadrante animato mostra la lancetta della data, la finestra del mese, il subdial del giorno, la fase lunare e l\'indicatore dell\'anno bisestile. Usa i controlli per avanzare attraverso giorni, mesi o anni e osserva la logica meccanica in azione.' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};