@jjlmoya/utils-finance 1.1.0

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

@@ -0,0 +1,261 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { FIRECalculatorUI } from '../ui';
+
+const slug = 'four-percent-rule-fire-calculator-spain';
+const title = 'FIRE Calculator Spain: 4% Rule';
+const description = 'Calculate your financial independence number in Spain using the 4% rule. Plan your early retirement and visualize your path to financial freedom.';
+
+const faqData = [
+  {
+    question: 'What is the 4% Rule?',
+    answer: 'The 4% Rule is a retirement strategy based on the Trinity Study indicating you can withdraw 4% of your portfolio the first year, adjusted for inflation thereafter, without depleting funds over 30 years.',
+  },
+  {
+    question: 'What is FIRE?',
+    answer: 'FIRE stands for Financial Independence, Retire Early. It\'s a movement seeking financial freedom through aggressive saving and intelligent investing to retire before traditional retirement age.',
+  },
+  {
+    question: 'What is my magic number?',
+    answer: 'Your magic number is the total wealth needed to live off investment returns without working. It\'s calculated by dividing your annual expenses by the safe withdrawal rate (typically 4%).',
+  },
+  {
+    question: 'What\'s the difference between Lean, Barista, and Fat FIRE?',
+    answer: 'Lean FIRE means living with minimal expenses (70% of current spending), Barista FIRE is working part-time with investments covering the rest (50%), and Fat FIRE is comfortable living (150% of expenses).',
+  },
+  {
+    question: 'Is the 4% Rule realistic?',
+    answer: 'The 4% Rule has a 95% historical success rate in a 50/50 stock-bond portfolio over 30 years. However, it doesn\'t account for sequence-of-returns risk and is primarily based on US market data.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Calculate your monthly expenses',
+    text: 'Analyze what you really spend each month including housing, food, services, and entertainment.',
+  },
+  {
+    name: 'Choose your safe withdrawal rate',
+    text: 'The 4% Rule is standard, but adjust between 2.5% (conservative) and 6% (aggressive) based on your risk tolerance.',
+  },
+  {
+    name: 'Enter your current net worth',
+    text: 'Sum your investments, savings, and income-generating assets.',
+  },
+  {
+    name: 'Visualize your progress',
+    text: 'See the wealth growth chart and freedom milestones (Lean, Barista, Fat FIRE) to understand when you\'ll reach your goal.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'Trinity Study: Portfolio Survivability',
+    url: 'https://en.wikipedia.org/wiki/Trinity_study',
+  },
+  {
+    name: 'Early Retirement Forum Discussion',
+    url: 'https://www.bogleheads.org/forum/',
+  },
+  {
+    name: 'Shiller CAPE Index',
+    url: 'https://www.multpl.com/shiller-pe',
+  },
+  {
+    name: 'Bank of Spain - Financial Guidance',
+    url: 'https://www.bde.es/bde/en/',
+  },
+];
+
+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<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Sources and References',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '4% Rule: The Holy Grail of Early Retirement',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Discover how to calculate the wealth needed to live off investment returns forever. The <strong>4% Rule</strong> emerged from the Trinity Study, conducted in 1998 by three finance professors. They analyzed market data since 1926 to determine what percentage could be withdrawn annually without depleting the portfolio in 30 years.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Historical Success' },
+        { value: '50/50', label: 'Stock/Bond Mix' },
+        { value: '30', label: 'Year Horizon' },
+        { value: '4%', label: 'Safe Withdrawal' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'What is the FIRE Movement?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE stands for Financial Independence, Retire Early.',
+        'Seeks the freedom to choose how to spend your time without financial constraints.',
+        'Based on optimizing savings and intelligent investment strategies.',
+        'Aims for your assets to generate sufficient cash flow to cover living expenses.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Types of Financial Freedom',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Minimalist lifestyle covering only basic survival expenses.',
+          points: ['Extreme saving', 'Very low spending', 'Frugal freedom'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Hybrid situation where investments cover half your expenses.',
+          points: ['Work by choice', 'Social coverage secured', 'Less stress'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Comfortable retirement with budget for luxuries and travel.',
+          points: ['High net worth', 'No restrictions', 'Family legacy'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'How to Use Our FIRE Calculator',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Expense Tracking:</strong> Analyze your actual monthly spending.',
+        '<strong>Safe Withdrawal Rate:</strong> Choose your retirement withdrawal percentage.',
+        '<strong>Current Net Worth:</strong> Enter your investment and asset values.',
+        '<strong>Savings Capacity:</strong> Calculate how long until you reach your goal.',
+        '<strong>Visual Analysis:</strong> See your wealth growth trajectory and milestones.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Analyzing the 4% Rule',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Advantages',
+          description: 'Why the 4% rule works',
+          points: [
+            'Simple mathematics for quick planning.',
+            'Based on nearly a century of historical data.',
+            'Adaptable to any spending level.',
+          ],
+        },
+        {
+          title: 'Limitations',
+          description: 'What the 4% rule doesn\'t cover',
+          points: [
+            'Doesn\'t account for sequence-of-returns risk.',
+            'Primarily based on US market data.',
+            'Ignores major tax law changes.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Critical Factor: Inflation',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Remember that €1,000 today won\'t buy the same amount in the future. It\'s vital to use real returns (adjusted for inflation) so your projections maintain current purchasing power. The 4% Rule assumes you adjust withdrawals annually for inflation.',
+    },
+  ],
+  ui: {
+    labelTitle: 'FIRE Calculator: 4% Rule',
+    labelDescription: 'Calculate your magic number for financial independence and visualize your path to financial freedom.',
+    labelMonthlyExpenses: 'Monthly Expenses',
+    labelSWR: 'Safe Withdrawal Rate (SWR)',
+    labelCurrentWorth: 'Current Net Worth',
+    labelMonthlySavings: 'Monthly Savings Capacity',
+    labelAnnualReturn: 'Estimated Annual Return (Net)',
+    labelFreedomMilestones: 'Freedom Milestones',
+    labelLeanFIRE: 'Lean FIRE (70% survival)',
+    labelBaristaFIRE: 'Barista FIRE (50% income)',
+    labelFatFIRE: 'Fat FIRE (150% luxury)',
+    labelMagicNumber: 'Your Magic Number for Freedom',
+    labelMagicNumberDesc: 'Capital needed to live off returns',
+    labelTimeRemaining: 'Time to financial freedom',
+    labelTimeRemainingFormat: 'You have {years} years and {months} months left',
+    labelAlreadyFI: 'You\'ve already achieved financial freedom!',
+    labelUnachievable: 'Goal unachievable with this savings rate',
+    labelHiddenCostsChecklist: 'Hidden Costs Checklist',
+    labelHealth: 'Health Insurance (+€200)',
+    labelTaxes: 'Taxes (+€150)',
+    labelHome: 'Home Maintenance (+€100)',
+    labelTravel: 'Travel and Leisure (+€300)',
+    labelEmergency: 'Emergency Fund (+€100)',
+    labelSubscriptions: 'Subscriptions (+€50)',
+    labelAdded: 'Added:',
+    labelSavePlan: 'Save Plan',
+    labelSWRTooltip: 'Safe Withdrawal Rate: The percentage of your savings you can withdraw each year without running out of money.',
+    labelReturnTooltip: 'Annual market return (adjusted for inflation). The historical standard is 7%.',
+    currencySymbol: '$',
+    currencyCode: 'USD',
+    currencyLocale: 'en-US',
+  },
+};

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

@@ -0,0 +1,261 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { FIRECalculatorUI } from '../ui';
+
+const slug = 'calculadora-regla-4-por-ciento-fire';
+const title = 'Calculadora FIRE: Regla del 4% para tu Libertad Financiera';
+const description = 'Calcula tu número mágico de independencia financiera usando la regla del 4%. Planifica tu jubilación anticipada y visualiza tu camino hacia la libertad económica.';
+
+const faqData = [
+  {
+    question: '¿Qué es la Regla del 4%?',
+    answer: 'La Regla del 4% es una estrategia de retiro basada en el Estudio Trinity que indica que puedes retirar el 4% de tu patrimonio el primer año de jubilación, ajustando por inflación en años posteriores, sin agotar tus fondos en 30 años.',
+  },
+  {
+    question: '¿Qué es FIRE?',
+    answer: 'FIRE significa Financial Independence, Retire Early (Independencia Financiera, Retiro Temprano). Es un movimiento que busca alcanzar la libertad económica mediante una combinación agresiva de ahorro e inversión inteligente.',
+  },
+  {
+    question: '¿Cuál es mi número mágico?',
+    answer: 'Tu número mágico es el patrimonio total que necesitas acumular para poder vivir de los rendimientos sin trabajar. Se calcula dividiendo tus gastos anuales entre la tasa de retiro segura (usualmente 4%).',
+  },
+  {
+    question: '¿Qué diferencia hay entre Lean, Barista y Fat FIRE?',
+    answer: 'Lean FIRE es vivir con gastos mínimos (70% de gastos actuales), Barista FIRE es trabajar a tiempo parcial mientras los rendimientos cubren el resto (50% de gastos), y Fat FIRE es tener un estilo de vida holgado (150% de gastos).',
+  },
+  {
+    question: '¿Es realista la Regla del 4%?',
+    answer: 'La Regla del 4% tiene un 95% de probabilidad histórica de éxito en un portafolio 50/50 acciones-bonos durante 30 años. Sin embargo, no contempla el riesgo de secuencia de retornos y se basa principalmente en datos del mercado estadounidense.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Calcula tus gastos mensuales',
+    text: 'Analiza cuánto gastas realmente cada mes incluyendo vivienda, alimentos, servicios y entretenimiento.',
+  },
+  {
+    name: 'Elige tu tasa de retiro segura',
+    text: 'La Regla del 4% es estándar, pero puedes ajustar entre 2.5% (más conservador) y 6% (más agresivo) según tu tolerancia al riesgo.',
+  },
+  {
+    name: 'Introduce tu patrimonio actual',
+    text: 'Suma el total de tus inversiones, ahorros y activos que generan ingresos pasivos.',
+  },
+  {
+    name: 'Visualiza tu progreso',
+    text: 'Observa el gráfico de crecimiento y los hitos de libertad (Lean, Barista, Fat FIRE) para entender cuándo alcanzarás tu meta.',
+  },
+];
+
+const bibliographyData = [
+  {
+    name: 'The Trinity Study: Portfolio Survivability',
+    url: 'https://en.wikipedia.org/wiki/Trinity_study',
+  },
+  {
+    name: 'Early Retirement Forum - 4% Rule Discussion',
+    url: 'https://www.bogleheads.org/forum/',
+  },
+  {
+    name: 'Shiller CAPE Index - Market Valuations',
+    url: 'https://www.multpl.com/shiller-pe',
+  },
+  {
+    name: 'Spanish Financial Regulator - CNMV',
+    url: 'https://www.cnmv.es/',
+  },
+];
+
+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<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes sobre FIRE',
+  faq: faqData,
+  bibliographyTitle: 'Fuentes y Referencias',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Regla del 4%: El Santo Grial de la Jubilación Anticipada',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Descubre cómo calcular tu patrimonio necesario para vivir de las rentas para siempre. La <strong>Regla del 4%</strong> surgió del Estudio Trinity, realizado en 1998 por tres profesores de finanzas. Analizaron datos históricos desde 1926 para determinar qué porcentaje se podía retirar anualmente sin agotar la cartera en 30 años.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Éxito Histórico' },
+        { value: '50/50', label: 'Mix Acciones/Bonos' },
+        { value: '30', label: 'Años de Horizon' },
+        { value: '4%', label: 'Retiro Seguro' },
+      ],
+    },
+    {
+      type: 'title',
+      text: '¿Qué es el Movimiento FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE es el acrónimo de Financial Independence, Retire Early (Independencia Financiera, Retiro Temprano).',
+        'Busca la libertad de elegir qué hacer con tu tiempo sin que el dinero sea un condicionante.',
+        'Se basa en la optimización del ahorro y la inversión inteligente.',
+        'El objetivo es que tus activos generen suficiente flujo de caja para cubrir tus gastos.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Tipos de Libertad Financiera',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Estilo de vida minimalista. Cubre solo los gastos básicos de supervivencia.',
+          points: ['Ahorro extremo', 'Gasto muy bajo', 'Libertad frugal'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Situación híbrida donde tus inversiones cubren la mitad de tus gastos.',
+          points: ['Trabajo por placer', 'Seguro social cubierto', 'Menor estrés'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Jubilación con un presupuesto holgado que permite lujos y viajes.',
+          points: ['Alto patrimonio', 'Cero restricciones', 'Legado familiar'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: '¿Cómo usar nuestra Calculadora FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Trackeo de Gastos:</strong> Analiza tus gastos reales de los últimos 12 meses.',
+        '<strong>Definición de SWR:</strong> Elige tu tasa de retirada segura según tu riesgo.',
+        '<strong>Patrimonio Actual:</strong> Introduce el valor de tus inversiones actuales.',
+        '<strong>Capacidad de Ahorro:</strong> Proyecta cuánto tiempo te queda para la meta.',
+        '<strong>Visualización Visual:</strong> Analiza el gráfico de crecimiento de tu riqueza.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Análisis de la Regla del 4%',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Ventajas',
+          description: 'Por qué funciona la regla del 4%',
+          points: [
+            'Simplicidad matemática para planificación rápida.',
+            'Basada en datos históricos de casi un siglo.',
+            'Adaptable a cualquier nivel de gasto.',
+          ],
+        },
+        {
+          title: 'Limitaciones',
+          description: 'Qué no cubre la regla del 4%',
+          points: [
+            'No contempla el riesgo de secuencia de retornos.',
+            'Basada principalmente en el mercado estadounidense.',
+            'Ignora cambios drásticos en fiscalidad local.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Factor Crítico: La Inflación',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Recuerda que 1.000€ hoy no comprarán lo mismo en el futuro. Es vital usar rentabilidades reales (descontada la inflación) para que tus proyecciones mantengan el poder adquisitivo actual. La Regla del 4% asume que ajustas tus retiros anualmente por inflación.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Calculadora FIRE: Regla del 4%',
+    labelDescription: 'Calcula tu número mágico para la independencia financiera usando la regla del 4% y visualiza tus hitos hacia la libertad económica.',
+    labelMonthlyExpenses: 'Gastos Mensuales',
+    labelSWR: 'Tasa de Retirada (SWR)',
+    labelCurrentWorth: 'Patrimonio Actual',
+    labelMonthlySavings: 'Capacidad de Ahorro Mensual',
+    labelAnnualReturn: 'Rentabilidad Estimada (Neto)',
+    labelFreedomMilestones: 'Hitos de Libertad',
+    labelLeanFIRE: 'Lean FIRE (70% supervivencia)',
+    labelBaristaFIRE: 'Barista FIRE (50% ingresos)',
+    labelFatFIRE: 'Fat FIRE (150% lujo)',
+    labelMagicNumber: 'Tu Número Mágico para ser Libre',
+    labelMagicNumberDesc: 'Capital necesario para vivir de las rentas',
+    labelTimeRemaining: 'Tiempo hasta la libertad financiera',
+    labelTimeRemainingFormat: 'Te faltan {years} años y {months} meses',
+    labelAlreadyFI: '¡Ya has alcanzado la libertad financiera!',
+    labelUnachievable: 'Meta inalcanzable con este ahorro',
+    labelHiddenCostsChecklist: 'Checklist de Gastos Ocultos',
+    labelHealth: 'Seguros Salud (+200€)',
+    labelTaxes: 'Impuestos (+150€)',
+    labelHome: 'Mantenimiento Hogar (+100€)',
+    labelTravel: 'Viajes y Ocio (+300€)',
+    labelEmergency: 'Fondo Emergencias (+100€)',
+    labelSubscriptions: 'Suscripciones (+50€)',
+    labelAdded: 'Añadido:',
+    labelSavePlan: 'Guardar Plan',
+    labelSWRTooltip: 'Safe Withdrawal Rate: Porcentaje de tus ahorros que puedes retirar cada año sin quedarte sin dinero.',
+    labelReturnTooltip: 'Rendimiento anual del mercado (ya descontada la inflación). El estándar histórico es el 7%.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'es-ES',
+  },
+};