@jjlmoya/utils-sports 1.1.0

package/src/tool/gymTracker/exercises.ts

@@ -0,0 +1,28 @@
+export interface Exercise {
+  id: string;
+  nameKey: string;
+  categoryKey: 'push' | 'pull' | 'glute';
+}
+
+export const defaultExercises: Exercise[] = [
+  { id: 'bench-press', nameKey: 'benchPress', categoryKey: 'push' },
+  { id: 'overhead-press', nameKey: 'overheadPress', categoryKey: 'push' },
+  { id: 'push-press', nameKey: 'pushPress', categoryKey: 'push' },
+  { id: 'incline-db-press', nameKey: 'inclineDbPress', categoryKey: 'push' },
+  { id: 'dips-triceps', nameKey: 'dipsTriceps', categoryKey: 'push' },
+  { id: 'triceps-extensions', nameKey: 'tricepsExtensions', categoryKey: 'push' },
+
+  { id: 'pull-up', nameKey: 'pullUp', categoryKey: 'pull' },
+  { id: 'barbell-row', nameKey: 'barbellRow', categoryKey: 'pull' },
+  { id: 'lat-pulldown', nameKey: 'latPulldown', categoryKey: 'pull' },
+  { id: 'db-row', nameKey: 'dbRow', categoryKey: 'pull' },
+  { id: 'face-pulls', nameKey: 'facePulls', categoryKey: 'pull' },
+  { id: 'biceps-curl', nameKey: 'bicepsCurl', categoryKey: 'pull' },
+
+  { id: 'hip-thrust', nameKey: 'hipThrust', categoryKey: 'glute' },
+  { id: 'rdl', nameKey: 'rdl', categoryKey: 'glute' },
+  { id: 'lunges', nameKey: 'lunges', categoryKey: 'glute' },
+  { id: 'glute-kick', nameKey: 'gluteKick', categoryKey: 'glute' },
+  { id: 'hip-abduction', nameKey: 'hipAbduction', categoryKey: 'glute' },
+  { id: 'step-up', nameKey: 'stepUp', categoryKey: 'glute' },
+];

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

@@ -0,0 +1,225 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { GymTrackerUI } from '../ui';
+
+const slug = 'gym-workout-tracker';
+const title = 'Gym Workout Tracker: Progress Charts and Strength Log';
+const description =
+  'Log your lifts, select exercises, and visualize your progress with strength charts. Optimize your progressive overload in the gym.';
+
+const faqData = [
+  {
+    question: 'What is the purpose of workout tracking?',
+    answer:
+      'It serves to apply progressive overload scientifically. By knowing exactly how much you lifted in the previous session, you can try to beat that mark, guaranteeing muscle growth and long-term strength gains.',
+  },
+  {
+    question: 'What data should I record?',
+    answer:
+      'The most important thing is the maximum weight (top set) you achieved with good form for a set number of repetitions. Our tool focuses on recording the weight per session to generate your progress chart.',
+  },
+  {
+    question: 'How are the charts interpreted?',
+    answer:
+      'An upward line indicates you are progressing. A flat line (plateau) suggests you need to adjust your volume, intensity, or recovery. A persistent downward line may be a sign of overtraining.',
+  },
+  {
+    question: 'Where is my data stored?',
+    answer:
+      'Data is stored locally in your browser (Local Storage). This means your privacy is total and you do not need to create an account, but if you clear browser data, the history will be lost.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Select the exercise',
+    text: 'Choose from fundamental lifts like Squat, Bench Press, or Deadlift in the dropdown menu.',
+  },
+  {
+    name: 'Enter the weight',
+    text: 'After your heaviest set, enter the kilograms/pounds lifted in the corresponding field.',
+  },
+  {
+    name: 'Press Add',
+    text: 'Save your mark. The system will automatically update your history and progress chart.',
+  },
+  {
+    name: 'Analyze your evolution',
+    text: 'Consult the chart periodically to identify plateaus and motivate yourself by seeing your real growth in strength.',
+  },
+];
+
+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: 'HealthApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<GymTrackerUI & Record<string, string>> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Scientific References',
+  bibliography: [
+    {
+      name: 'Journal of Strength and Conditioning Research - Progressive Overload Study',
+      url: 'https://journals.lww.com/nsca-jscr/Fulltext/2010/10000/The_Mechanisms_of_Muscle_Hypertrophy_and_Their.40.aspx',
+    },
+    {
+      name: 'National Academy of Sports Medicine - Progressive Overload Explained',
+      url: 'https://blog.nasm.org/progressive-overload-explained',
+    },
+    {
+      name: 'Science of Strength - Data Tracking in Resistance Training',
+      url: 'https://pubmed.ncbi.nlm.nih.gov/30558493/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Gym Workout Tracking: The Key to Real Progress',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'In the world of fitness and bodybuilding, there is a fundamental principle that separates those who get amazing results from those who plateau quickly: <strong>progressive overload</strong>. However, it is impossible to apply this principle effectively if you do not keep a detailed record of your lifts. In this guide, we will explore why tracking your workout is vital, how to use our <strong>gym workout tracker</strong> to maximize your gains, and the scientific foundations that support this practice.',
+    },
+    {
+      type: 'title',
+      text: 'What is Progressive Overload?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Progressive overload is the gradual increase of stress applied to the body during physical exercise. For a muscle to grow or strengthen, it must be subjected to a stimulus greater than what it is accustomed to. If you go to the gym and always lift the same weight, with the same repetitions and the same rest time, your body will have no biological reason to adapt and grow.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Weight increase: Lifting more weight than the previous session.',
+        'Repetition increase: Doing more reps with the same weight.',
+        'Volume increase: Performing more total sets per muscle group.',
+        'Rest reduction: Doing the same work in less time.',
+        'Form improvement: Performing the exercise with superior control and greater range of motion.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Why Manual Logging Superior to Memory',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Many athletes make the mistake of trusting their memory to remember how much they lifted last week. However, in a typical workout that includes between 5 and 10 different exercises, it is very easy to forget if you did 180 lbs or 185 lbs on the press, or if you managed 10 reps or 12. This lack of precision leads to mediocrity.',
+    },
+    {
+      type: 'tip',
+      title: 'The Power of Visualizing Progress',
+      html: 'Seeing an upward line on a chart gives you the boost needed to try that extra rep that marks the difference between stagnation and consistent muscle growth.',
+    },
+    {
+      type: 'title',
+      text: 'Fundamental Exercises for Tracking',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'While all exercises are valuable, certain compound lifts offer the best view of your overall strength and physical development. These are the ones you should prioritize in your tracking: <strong>Bench Press</strong> for horizontal push, <strong>Overhead Press</strong> for vertical push, <strong>Pull-ups</strong> for traction, and <strong>Hip Thrust</strong> for glutes.',
+    },
+    {
+      type: 'title',
+      text: 'How to Analyze Your Progress Charts',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Once you have recorded several workouts, you will start to see patterns: a <strong>constant upward line</strong> indicates the right path, a <strong>plateau</strong> suggests you need to adjust your volume or rest, and a <strong>downward trend</strong> can be a sign of accumulated fatigue.',
+    },
+    {
+      type: 'title',
+      text: 'The Psychology of Success in the Gym',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Training is as much a mental challenge as a physical one. By using a visual tool that shows you that today you are 1% stronger than fifteen days ago, you are feeding your dopamine reward system. This creates a positive feedback loop that turns training into a sustainable habit.',
+    },
+  ],
+  ui: {
+    exerciseLabel: 'Exercise',
+    pushCategory: 'Push',
+    pullCategory: 'Pull',
+    gluteCategory: 'Glute',
+    customExerciseCategory: 'Custom',
+    addCustomExerciseTitle: 'Add custom exercise',
+    newExerciseLabel: 'New exercise',
+    exercisePlaceholder: 'Exercise name...',
+    addBtn: 'Add',
+    registerWeightLabel: 'Log Weight',
+    weightPlaceholder: '00.0',
+    startBtn: 'Start',
+    resetBtn: 'Reset',
+    okBtn: 'OK',
+    noData: 'No data',
+    recordLabel: 'Record',
+    lastLabel: 'Last',
+    historyTitle: 'Logs',
+    exportBtn: 'Export',
+    confirmDeleteTitle: 'Clear history?',
+    confirmDeleteText: 'This action cannot be undone. All logs for the selected exercise will be deleted.',
+    deleteBtn: 'Delete',
+    cancelBtn: 'Cancel',
+    units: 'lbs',
+
+    benchPress: 'Bench Press',
+    overheadPress: 'Overhead Press',
+    pushPress: 'Push Press',
+    inclineDbPress: 'Incline DB Press',
+    dipsTriceps: 'Triceps Dips',
+    tricepsExtensions: 'Cable Triceps Extensions',
+    pullUp: 'Pull-ups',
+    barbellRow: 'Barbell Row',
+    latPulldown: 'Lat Pulldown',
+    dbRow: 'Dumbbell Row',
+    facePulls: 'Face Pulls',
+    bicepsCurl: 'Barbell Biceps Curl',
+    hipThrust: 'Hip Thrust',
+    rdl: 'Romanian Deadlift',
+    lunges: 'Lunges',
+    gluteKick: 'Cable Glute Kickback',
+    hipAbduction: 'Machine Hip Abduction',
+    stepUp: 'Step Up',
+  },
+};

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

@@ -0,0 +1,225 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { GymTrackerUI } from '../ui';
+
+const slug = 'seguimiento-entrenamiento-gym';
+const title = 'Seguimiento de Entrenamiento Gym: Gráficas de Progreso y Fuerza';
+const description =
+  'Registra tus levantamientos, selecciona el ejercicio y visualiza tu avance con gráficas de fuerza. Optimiza tu sobrecarga progresiva en el gimnasio.';
+
+const faqData = [
+  {
+    question: '¿Para qué sirve el seguimiento de entrenamiento?',
+    answer:
+      'Sirve para aplicar la sobrecarga progresiva de manera científica. Al saber exactamente cuánto levantaste la sesión anterior, puedes intentar superar esa marca, lo que garantiza el crecimiento muscular y la ganancia de fuerza a largo plazo.',
+  },
+  {
+    question: '¿Qué datos debo registrar?',
+    answer:
+      'Lo más importante es el peso máximo (top set) que has logrado mover con buena técnica para un número determinado de repeticiones. Nuestra herramienta se enfoca en registrar el peso por sesión para generar tu gráfica de progreso.',
+  },
+  {
+    question: '¿Cómo se interpretan las gráficas?',
+    answer:
+      'Una línea ascendente indica que estás progresando. Una línea plana (meseta) sugiere que necesitas ajustar tu volumen, intensidad o recuperación. Una línea descendente persistente puede ser señal de sobreentrenamiento.',
+  },
+  {
+    question: '¿Dónde se guardan mis datos?',
+    answer:
+      'Los datos se guardan de forma local en tu navegador (Local Storage). Esto significa que tu privacidad es total y no necesitas crear una cuenta, pero si borras los datos del navegador, el historial se perderá.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Selecciona el ejercicio',
+    text: 'Elige entre los levantamientos fundamentales como Sentadilla, Press de Banca o Peso Muerto en el menú desplegable.',
+  },
+  {
+    name: 'Introduce el peso',
+    text: 'Después de tu serie más pesada, introduce los kilogramos levantados en el campo correspondiente.',
+  },
+  {
+    name: 'Pulsa Añadir',
+    text: 'Guarda tu marca. El sistema actualizará automáticamente tu historial y la gráfica de progreso.',
+  },
+  {
+    name: 'Analiza tu evolución',
+    text: 'Consulta la gráfica periódicamente para identificar mesetas y motivarte al ver tu crecimiento real en fuerza.',
+  },
+];
+
+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: 'HealthApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<GymTrackerUI & Record<string, string>> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias Científicas',
+  bibliography: [
+    {
+      name: 'Journal of Strength and Conditioning Research - Progressive Overload Study',
+      url: 'https://journals.lww.com/nsca-jscr/Fulltext/2010/10000/The_Mechanisms_of_Muscle_Hypertrophy_and_Their.40.aspx',
+    },
+    {
+      name: 'National Academy of Sports Medicine - Progressive Overload Explained',
+      url: 'https://blog.nasm.org/progressive-overload-explained',
+    },
+    {
+      name: 'Science of Strength - Data Tracking in Resistance Training',
+      url: 'https://pubmed.ncbi.nlm.nih.gov/30558493/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Seguimiento de Entrenamiento en el Gimnasio: La Clave para el Progreso Real',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'En el mundo del fitness y el culturismo, existe un principio fundamental que separa a quienes obtienen resultados asombrosos de quienes se estancan rápidamente: la <strong>sobrecarga progresiva</strong>. Sin embargo, es imposible aplicar este principio de manera efectiva si no llevas un registro detallado de tus levantamientos. En esta guía, exploraremos por qué el seguimiento de tu entrenamiento es vital, cómo utilizar nuestra herramienta de <strong>seguimiento de entrenamiento gym</strong> para maximizar tus ganancias y los fundamentos científicos que respaldan esta práctica.',
+    },
+    {
+      type: 'title',
+      text: '¿Qué es la Sobrecarga Progresiva?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'La sobrecarga progresiva es el aumento gradual del estrés aplicado al cuerpo durante el ejercicio físico. Para que un músculo crezca o se fortalezca, debe ser sometido a un estímulo mayor al que está acostumbrado. Si vas al gimnasio y levantas siempre el mismo peso, con las mismas repeticiones y el mismo tiempo de descanso, tu cuerpo no tendrá ninguna razón biológica para adaptarse y crecer.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Aumento del peso: Levantar más kilos que la sesión anterior.',
+        'Aumento de repeticiones: Hacer más repeticiones con el mismo peso.',
+        'Aumento del volumen: Realizar más series totales por grupo muscular.',
+        'Reducción del descanso: Hacer el mismo trabajo en menos tiempo.',
+        'Mejora de la técnica: Realizar el ejercicio con control superior y mayor rango de movimiento.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Por qué el Registro Manual es Superior a la Memoria',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Muchos deportistas cometen el error de confiar en su memoria para recordar cuánto levantaron la semana pasada. Sin embargo, en un entrenamiento típico que incluye entre 5 y 10 ejercicios diferentes, es muy fácil olvidar si hiciste 80 kg o 82.5 kg en la prensa, o si lograste 10 repeticiones o 12. Esta falta de precisión conduce a la mediocridad.',
+    },
+    {
+      type: 'tip',
+      title: 'El Poder de Visualizar el Progreso',
+      html: 'Ver una línea ascendente en un gráfico te da el impulso necesario para intentar esa repetición extra que marca la diferencia entre estancamiento y crecimiento muscular consistente.',
+    },
+    {
+      type: 'title',
+      text: 'Los Ejercicios Fundamentales para el Seguimiento',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Si bien todos los ejercicios son valiosos, hay ciertos levantamientos compuestos que ofrecen la mejor visión de tu fuerza general y desarrollo físico. Estos son los que deberías priorizar en tu seguimiento: <strong>Press de Banca</strong> para empuje horizontal, <strong>Press Militar</strong> para empuje vertical, <strong>Dominadas</strong> para tracción y <strong>Hip Thrust</strong> para glúteos.',
+    },
+    {
+      type: 'title',
+      text: 'Cómo Analizar tus Gráficas de Progreso',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Una vez que hayas registrado varios entrenamientos, empezarás a ver patrones: una <strong>línea ascendente constante</strong> indica el camino correcto, una <strong>meseta</strong> sugiere que necesitas ajustar tu volumen o descanso, y una <strong>tendencia a la baja</strong> puede ser señal de fatiga acumulada.',
+    },
+    {
+      type: 'title',
+      text: 'La Psicología del Éxito en el Gimnasio',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Entrenar es tanto un reto mental como físico. Al usar una herramienta visual que te muestra que hoy eres un 1% más fuerte que hace quince días, estás alimentando tu sistema de recompensa de dopamina. Esto crea un bucle de retroalimentación positiva que convierte el entrenamiento en un hábito sostenible.',
+    },
+  ],
+  ui: {
+    exerciseLabel: 'Ejercicio',
+    pushCategory: 'Empuje',
+    pullCategory: 'Tracción',
+    gluteCategory: 'Glúteo',
+    customExerciseCategory: 'Personalizados',
+    addCustomExerciseTitle: 'Agregar ejercicio personalizado',
+    newExerciseLabel: 'Nuevo ejercicio',
+    exercisePlaceholder: 'Nombre del ejercicio...',
+    addBtn: 'Añadir',
+    registerWeightLabel: 'Registrar Peso (KG)',
+    weightPlaceholder: '00.0',
+    startBtn: 'Empezar',
+    resetBtn: 'Reiniciar',
+    okBtn: 'OK',
+    noData: 'Sin datos',
+    recordLabel: 'Récord',
+    lastLabel: 'Último',
+    historyTitle: 'Logs',
+    exportBtn: 'Exportar',
+    confirmDeleteTitle: '¿Borrar historial?',
+    confirmDeleteText: 'Esta acción no se puede deshacer. Se eliminarán todos los registros del ejercicio seleccionado.',
+    deleteBtn: 'Borrar',
+    cancelBtn: 'Cancelar',
+    units: 'kg',
+    
+    benchPress: 'Press de Banca',
+    overheadPress: 'Press Militar',
+    pushPress: 'Push Press',
+    inclineDbPress: 'Press Inclinado con Mancuernas',
+    dipsTriceps: 'Fondos de Tríceps',
+    tricepsExtensions: 'Extensiones de Tríceps en Polea',
+    pullUp: 'Dominadas',
+    barbellRow: 'Remo con Barra',
+    latPulldown: 'Jalón al Pecho',
+    dbRow: 'Remo con Mancuerna',
+    facePulls: 'Face Pulls',
+    bicepsCurl: 'Curl de Bíceps con Barra',
+    hipThrust: 'Hip Thrust',
+    rdl: 'Peso Muerto Rumano',
+    lunges: 'Zancadas',
+    gluteKick: 'Patada de Glúteo en Polea',
+    hipAbduction: 'Abducción de Cadera en Máquina',
+    stepUp: 'Step Up',
+  },
+};