@jjlmoya/utils-finance 1.1.0

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

@@ -0,0 +1,301 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { InflationUI } from '../ui';
+
+const slug = 'inflation-calculator-spain';
+const title = 'Inflation Calculator Spain: Historical Money Value';
+const description =
+  'Discover what your pesetas are worth today or how much cost of living has increased since 1980. Updated Spanish CPI historical data through 2026.';
+
+const faqData = [
+  {
+    question: 'What is CPI and how is it calculated?',
+    answer:
+      'The Consumer Price Index (CPI) measures the evolution of prices for a basket of goods and services representative of Spanish consumption. It is calculated by comparing the cost of this basket across different time periods.',
+  },
+  {
+    question: 'How much has money lost value since 1980?',
+    answer:
+      '1,000 pesetas from 1980 are equivalent to approximately 60€ in today\'s purchasing power. Money has lost over 90% of its value in these 40+ years due to accumulated inflation.',
+  },
+  {
+    question: 'Why do my savings lose value if I don\'t move them?',
+    answer:
+      'If inflation is 3% annually and your account earns 0% interest, you lose 3% of purchasing power each year. To maintain real value, your savings must generate at least the inflation rate.',
+  },
+  {
+    question: 'What was Spain\'s highest inflation period?',
+    answer:
+      'The 1980s saw the most inflation, with double-digit rates (up to 15%). Prices changed drastically month-to-month. Since the euro (2002), inflation has been more controlled, except during 2021-2023.',
+  },
+  {
+    question: 'How does inflation affect my savings?',
+    answer:
+      'Inflation acts as a "silent tax". If inflation is 5% and your money is under your mattress, at year\'s end you can buy 5% fewer products. It\'s critical to invest to counteract this effect.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Select the starting year',
+    text: 'Choose from which date you want to calculate money\'s value (available from 1980 to 2026).',
+  },
+  {
+    name: 'Enter the amount',
+    text: 'Type the amount in pesetas (for old dates) or euros you want to compare.',
+  },
+  {
+    name: 'Choose the final year',
+    text: 'Define when you want to see the purchasing power evolution.',
+  },
+  {
+    name: 'Analyze the real result',
+    text: 'View the purchasing power equivalence and accumulated inflation percentage for that period.',
+  },
+];
+
+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: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<InflationUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Sources & References',
+  bibliography: [
+    {
+      name: 'INE: Spanish Consumer Price Index',
+      url: 'https://www.ine.es/',
+    },
+    {
+      name: 'Bank of Spain: Inflation Analysis',
+      url: 'https://www.bde.es/',
+    },
+    {
+      name: 'ECB: Historical Eurozone Inflation Data',
+      url: 'https://www.ecb.europa.eu/',
+    },
+    {
+      name: 'OECD: Purchasing Power Parity Analysis',
+      url: 'https://www.oecd.org/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Historical Inflation Calculator: Understand the Real Value of Your Money',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Inflation is the "silent tax" that devours your savings year after year. Do you know how much your money has lost in value since 1980? How much does that coffee really cost today that you paid 300 pesetas for 20 years ago?',
+    },
+    {
+      type: 'title',
+      text: 'Inflation: The Silent Tax on Your Wealth',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Inflation</strong> is the sustained and general increase in prices. Although it seems like a technical phenomenon, its impact on the real economy is direct: it reduces the amount of goods you can buy with the same money, eroding a lifetime of savings if protective measures are not taken.',
+    },
+    {
+      type: 'stats',
+      columns: 3,
+      items: [
+        {
+          value: '15.6%',
+          label: 'Historical Record 1980',
+          icon: 'mdi:trending-up',
+        },
+        {
+          value: '8.4%',
+          label: 'Price Peak 2022',
+          icon: 'mdi:alert',
+        },
+        {
+          value: '2.0%',
+          label: 'Stability Target',
+          icon: 'mdi:target',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Essential Financial Terms',
+      level: 3,
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'CPI',
+          definition: 'An indicator that summarizes the variation in prices of a basic consumption basket.',
+        },
+        {
+          term: 'Purchasing Power',
+          definition: 'The real buying capacity of money at a given time.',
+        },
+        {
+          term: 'Deflation',
+          definition: 'General decline in prices that can paralyze investment.',
+        },
+        {
+          term: 'Stagflation',
+          definition: 'Scenario of high inflation combined with economic stagnation.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Economic Milestones and Comparison',
+      level: 2,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: '1980s Crisis',
+          description: 'Period marked by double-digit inflation and major labor instability.',
+          points: [
+            'Extremely high interest rates',
+            'Rapid loss of peseta value',
+            'Wages devoured by rising prices',
+          ],
+        },
+        {
+          title: 'Pandemic Inflation: 2021 to 2023',
+          description: 'Sharp price increase due to energy costs and supply chain issues.',
+          highlight: true,
+          points: [
+            'Direct impact on cost of living',
+            'ECB rate hikes to slow consumption',
+            'Slow recovery of purchasing power',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'table',
+      headers: ['Item or Indicator', 'Value in 1980 (Estimated)', 'Value in 2026 (Projected)', 'Variation'],
+      rows: [
+        ['Loaf of Bread', '0.15€ (25 pts)', '1.40€', '833%'],
+        ['Coffee at Café', '0.30€ (50 pts)', '1.65€', '450%'],
+        ['Movie Ticket', '1.20€ (200 pts)', '9.80€', '716%'],
+        ['Monthly Minimum Wage', '154€ (25,615 pts)', '1,140€', '640%'],
+      ],
+    },
+    {
+      type: 'card',
+      icon: 'mdi:piggy-bank',
+      title: 'The Danger of Cash',
+      html: 'Keeping money under the mattress or in non-yielding savings accounts is a guaranteed loss of capital. Average inflation of 3% cuts the value of your savings in half in less than 25 years.',
+    },
+    {
+      type: 'title',
+      text: 'Tips to Protect Your Savings',
+      level: 2,
+    },
+    {
+      type: 'proscons',
+      title: 'Investment Strategies',
+      items: [
+        {
+          pro: 'Real Assets: Real estate usually appreciates with inflation.',
+          con: 'Low liquidity and high entry costs.',
+        },
+        {
+          pro: 'Stock Market & Funds: Returns that usually exceed CPI over the long term.',
+          con: 'Volatility and short-term market risk.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Healthy Financial Habits',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Periodically review your expenses to detect hidden increases.',
+        'Diversify savings across different types of assets.',
+        'Consider inflation-linked government bonds.',
+        'Use calculation tools to contextualize offers and salaries.',
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Warning: Negative Compound Interest',
+      html: 'Inflation acts as reverse compound interest. Each year, the percentage loss applies to an already diminished value, accelerating wealth loss if you don\'t intervene.',
+    },
+    {
+      type: 'summary',
+      title: 'Key Takeaways',
+      items: [
+        'CPI is just an average; your personal inflation depends on your habits.',
+        'Investing is not optional if you want to preserve the real value of your work.',
+        'Inflation calculators are vital to understanding long-term contracts.',
+      ],
+    },
+    {
+      type: 'message',
+      title: 'Take Control of Your Economy',
+      html: 'Our calculator uses official INE data to give you the most accurate view of Spain\'s past and present economic landscape.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Inflation Calculator Spain',
+    labelInitialAmount: 'Initial Money',
+    labelInitialYear: 'In the year',
+    labelFinalAmount: 'Equivalent Today',
+    labelFinalYear: 'Year 2026',
+    labelInflationRate: 'Accumulated Inflation',
+    labelCalculatedOn: 'Calculation made using official INE data through 2025 and estimated projections for the end of 2026.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'es-ES',
+    labelYearSelect: 'In the year',
+    labelIn: 'In',
+    labelEquivalentToday: 'is equivalent today to',
+    labelInflationAccumulated: 'Accumulated Inflation',
+    labelYear: 'Year',
+  },
+};

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

@@ -0,0 +1,301 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { InflationUI } from '../ui';
+
+const slug = 'inflacion';
+const title = 'Calculadora de Inflación en España: Valor del Dinero Histórico';
+const description =
+  'Descubre cuánto valdrían tus pesetas hoy o cuánto ha subido el coste de vida desde 1980. Datos IPC históricos de España actualizados a 2026.';
+
+const faqData = [
+  {
+    question: '¿Qué es el IPC y cómo se calcula?',
+    answer:
+      'El Índice de Precios de Consumo (IPC) mide la evolución de los precios de una cesta de bienes y servicios representativa del consumo español. Se calcula comparando el coste de esta cesta en diferentes períodos de tiempo.',
+  },
+  {
+    question: '¿Cuánto ha perdido valor el dinero desde 1980?',
+    answer:
+      '1.000 pesetas de 1980 equivalen aproximadamente a 60€ de hoy en poder adquisitivo. El dinero ha perdido más del 90% de su valor en estos 40+ años debido a la inflación acumulada.',
+  },
+  {
+    question: '¿Por qué mis ahorros pierden valor si no los muevo?',
+    answer:
+      'Si la inflación es del 3% anual y tu cuenta da 0% de interés, pierdes un 3% de poder adquisitivo cada año. Para mantener el valor real, tus ahorros deben generar al menos la tasa de inflación.',
+  },
+  {
+    question: '¿Cuál fue el período de mayor inflación en España?',
+    answer:
+      'Los años 80 fueron los más inflacionarios, con tasas de doble dígito (hasta 15%). Los precios cambiaban drásticamente mes a mes. Desde el euro (2002), la inflación ha sido más controlada, excepto en 2021-2023.',
+  },
+  {
+    question: '¿Cómo afecta la inflación a mis ahorros?',
+    answer:
+      'La inflación actúa como un \'impuesto silencioso\'. Si la inflación es del 5% y tu dinero está en el colchón, al final del año podrás comprar un 5% menos de productos. Es fundamental invertir para contrarrestar este efecto.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Seleccionar el año de origen',
+    text: 'Elige desde qué fecha quieres calcular el valor del dinero (disponible desde 1980 hasta 2026).',
+  },
+  {
+    name: 'Introducir la cantidad',
+    text: 'Escribe el importe en pesetas (para fechas antiguas) o en euros que quieres comparar.',
+  },
+  {
+    name: 'Elegir el año final',
+    text: 'Define hasta qué momento quieres ver la evolución del poder adquisitivo.',
+  },
+  {
+    name: 'Analizar el resultado real',
+    text: 'Observa la equivalencia de poder adquisitivo y el porcentaje de inflación acumulada en dicho periodo.',
+  },
+];
+
+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: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<InflationUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes sobre Inflación',
+  faq: faqData,
+  bibliographyTitle: 'Fuentes y Referencias Oficiales',
+  bibliography: [
+    {
+      name: 'INE: Índice de Precios de Consumo',
+      url: 'https://www.ine.es/dyngs/INEsite/es/catalom.htm?cid=1254736116996',
+    },
+    {
+      name: 'Banco de España: Análisis de la Inflación',
+      url: 'https://www.bde.es/',
+    },
+    {
+      name: 'BCE: Política Monetaria y Precios',
+      url: 'https://www.ecb.europa.eu/',
+    },
+    {
+      name: 'OCU: Guía para entender el IPC',
+      url: 'https://www.ocu.org/dinero/ahorros/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Calculadora de Inflación Histórica: Entiende el Valor Real de tu Dinero',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La inflación es el "impuesto silencioso" que devora tus ahorros año tras año. ¿Sabes cuánto ha perdido valor tu dinero desde 1980? ¿Cuánto cuesta realmente ese café que pagabas a 300 pesetas hace 20 años?',
+    },
+    {
+      type: 'title',
+      text: 'La Inflación: El Impuesto Silencioso sobre tu Patrimonio',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'La <strong>inflación</strong> es el incremento sostenido y generalizado de los precios. Aunque parezca un fenómeno técnico, su impacto en la economía real es directo: reduce la cantidad de bienes que puedes comprar con el mismo dinero, erosionando el ahorro de toda una vida si no se toman medidas protectoras.',
+    },
+    {
+      type: 'stats',
+      columns: 3,
+      items: [
+        {
+          value: '15.6%',
+          label: 'Récord Histórico 1980',
+          icon: 'mdi:trending-up',
+        },
+        {
+          value: '8.4%',
+          label: 'Pico de Precios 2022',
+          icon: 'mdi:alert',
+        },
+        {
+          value: '2.0%',
+          label: 'Objetivo de Estabilidad',
+          icon: 'mdi:target',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Términos Financieros Esenciales',
+      level: 3,
+    },
+    {
+      type: 'glossary',
+      items: [
+        {
+          term: 'IPC',
+          definition: 'Indicador que resume la variación de precios de una cesta básica de consumo.',
+        },
+        {
+          term: 'Poder Adquisitivo',
+          definition: 'Capacidad de compra real de una moneda en un momento determinado.',
+        },
+        {
+          term: 'Deflación',
+          definition: 'Descenso generalizado de los precios que puede paralizar la inversión.',
+        },
+        {
+          term: 'Estanflación',
+          definition: 'Escenario de alta inflación combinado con estancamiento económico.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Hitos Económicos y Comparativa',
+      level: 2,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Crisis de los años 80',
+          description: 'Periodo marcado por inflaciones de doble dígito y gran inestabilidad laboral.',
+          points: [
+            'Tipos de interés extremadamente altos',
+            'Pérdida rápida de valor de la peseta',
+            'Sueldos devorados por los precios',
+          ],
+        },
+        {
+          title: 'Inflación de la Pandemia: 2021 a 2023',
+          description: 'Subida brusca por costes energéticos y problemas en la cadena de suministro.',
+          highlight: true,
+          points: [
+            'Impacto directo en cesta de la compra',
+            'Subida de tipos del BCE para frenar el consumo',
+            'Recuperación lenta del poder de compra',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'table',
+      headers: ['Producto o Indicador', 'Valor en 1980 (Estimado)', 'Valor en 2026 (Proyectado)', 'Variación'],
+      rows: [
+        ['Barra de Pan', '0.15€ (25 pts)', '1.40€', '833%'],
+        ['Café en Establecimiento', '0.30€ (50 pts)', '1.65€', '450%'],
+        ['Entrada de Cine', '1.20€ (200 pts)', '9.80€', '716%'],
+        ['Salario Mínimo Mensual', '154€ (25.615 pts)', '1.140€', '640%'],
+      ],
+    },
+    {
+      type: 'card',
+      icon: 'mdi:piggy-bank',
+      title: 'El Peligro del Efectivo',
+      html: 'Guardar dinero bajo el colchón o en cuentas corriente sin rentabilidad es una pérdida de capital garantizada. Una inflación media del 3% reduce a la mitad el valor de tus ahorros en menos de 25 años.',
+    },
+    {
+      type: 'title',
+      text: 'Consejos para Proteger tus Ahorros',
+      level: 2,
+    },
+    {
+      type: 'proscons',
+      title: 'Estrategias de Inversión',
+      items: [
+        {
+          pro: 'Activos Reales: Los inmuebles suelen revalorizarse con la inflación.',
+          con: 'Baja liquidez y altos costes de entrada.',
+        },
+        {
+          pro: 'Bolsa y Fondos: Rentabilidades que suelen superar al IPC a largo plazo.',
+          con: 'Volatilidad y riesgo de mercado a corto plazo.',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Hábitos Financieros Saludables',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Revisar periódicamente tus gastos para detectar subidas ocultas.',
+        'Diversificar ahorros en diferentes tipos de activos.',
+        'Considerar bonos del estado vinculados a la inflación.',
+        'Utilizar herramientas de cálculo para contextualizar ofertas y salarios.',
+      ],
+    },
+    {
+      type: 'diagnostic',
+      variant: 'warning',
+      title: 'Advertencia sobre el Interés Compuesto Negativo',
+      html: 'La inflación actúa como un interés compuesto inverso. Cada año, el porcentaje de pérdida se aplica sobre un valor ya disminuido, acelerando la pérdida de riqueza si no se interviene.',
+    },
+    {
+      type: 'summary',
+      title: 'Conclusiones Clave',
+      items: [
+        'El IPC es solo un promedio; tu inflación personal depende de tus hábitos.',
+        'Invertir no es opcional si se quiere preservar el valor real del trabajo.',
+        'Las calculadoras de inflación son vitales para entender contratos de largo plazo.',
+      ],
+    },
+    {
+      type: 'message',
+      title: 'Toma el Control de tu Economía',
+      html: 'Nuestra calculadora utiliza datos oficiales del INE para ofrecerte la visión más precisa del pasado y presente económico de España.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Calculadora de Inflación España',
+    labelInitialAmount: 'Dinero Inicial',
+    labelInitialYear: 'En el año',
+    labelFinalAmount: 'Equivalencia Hoy',
+    labelFinalYear: 'Año 2026',
+    labelInflationRate: 'Inflación Acumulada',
+    labelCalculatedOn: 'Cálculo realizado utilizando datos oficiales del INE hasta 2025 y proyecciones estimadas para el cierre de 2026.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'es-ES',
+    labelYearSelect: 'En el año',
+    labelIn: 'En',
+    labelEquivalentToday: 'equivale hoy a',
+    labelInflationAccumulated: 'Inflación Acumulada',
+    labelYear: 'Año',
+  },
+};