@jjlmoya/utils-finance 1.16.0 → 1.18.0

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

@@ -0,0 +1,152 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: 'Inversión Inicial',
+  labelFinalValue: 'Valor Final / Saldo Actual',
+  labelTimeSelection: 'Duración de la Inversión',
+  labelYears: 'Años',
+  labelMonths: 'Meses',
+  labelDays: 'Días',
+  labelROI: 'Retorno de la Inversión (ROI)',
+  labelCAGR: 'Crecimiento Anualizado (CAGR)',
+  labelNetProfit: 'Beneficio Neto',
+  labelLinearGrowth: 'Crecimiento Lineal (Estimado)',
+  labelExponentialGrowth: 'Crecimiento Compuesto (CAGR)',
+  labelPositiveResult: 'Inversión Rentable',
+  labelNegativeResult: 'Posición en Pérdidas',
+  labelCopyResult: 'Copiar Resultados',
+  labelCopied: '¡Copiado!',
+};
+
+const slug = 'calculadora-rentabilidad-inversion-roi-cagr';
+const title = 'Calculadora de Rentabilidad: ROI y CAGR';
+const description = 'Analiza el rendimiento de tus inversiones con precisión. Calcula el Retorno de la Inversión (ROI) total y la Tasa de Crecimiento Anual Compuesto (CAGR) para entender tus ganancias reales.';
+
+const faq = [
+  {
+    question: '¿Qué es un buen CAGR?',
+    answer: 'Un "buen" CAGR depende del tipo de activo. Históricamente, el S&P 500 ha retornado en torno al 7-10% anual. Inversiones de alto riesgo pueden aspirar al 15-20%+, mientras que las cuentas de ahorro suelen ofrecer mucho menos.',
+  },
+  {
+    question: '¿Por qué mi CAGR es distinto de mi ROI total?',
+    answer: 'El ROI es el retorno total sin importar el tiempo. El CAGR es la tasa anual necesaria para alcanzar ese retorno total. Si tu inversión duró más de un año, el CAGR será normalmente un número menor que el ROI.',
+  },
+  {
+    question: '¿Puede el CAGR ser negativo?',
+    answer: 'Sí. Si el valor final es inferior a tu inversión inicial, el CAGR será negativo, representando la tasa de pérdida anualizada.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Introduce tu capital inicial',
+    text: 'Ingresa la cantidad de dinero que invertiste originalmente.',
+  },
+  {
+    name: 'Introduce el valor final o actual',
+    text: 'Ingresa el valor de mercado actual de tu inversión o el precio al que la vendiste.',
+  },
+  {
+    name: 'Establece la duración',
+    text: 'Especifica cuánto tiempo mantuviste la inversión para calcular el retorno anualizado (CAGR).',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs. CAGR: ¿Qué métrica es mejor?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Al evaluar una inversión, el <strong>ROI (Return on Investment)</strong> te indica el porcentaje total de ganancia o pérdida de principio a fin. Sin embargo, ignora el factor tiempo. El <strong>CAGR (Compound Annual Growth Rate)</strong> es superior para análisis a largo plazo porque "anualiza" tus retornos, permitiéndote comparar una inversión en bolsa a 5 años con una operación en cripto de 1 año en igualdad de condiciones.',
+    },
+    {
+      type: 'title',
+      text: 'Cómo usar la calculadora de rentabilidad',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Para obtener resultados precisos, introduce tu capital inicial y el valor actual (o precio de venta final) de tu activo. Selecciona la duración de la inversión en días, meses o años. Nuestra herramienta calcula automáticamente el beneficio absoluto, el ROI total y la media geométrica de tu crecimiento anual (CAGR).',
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'ROI Total',
+          description: 'Medida de retorno absoluto.',
+          points: [
+            'Ignora la duración',
+            'Cálculo simple',
+            'Ideal para trades rápidos',
+            'Muestra ganancia total',
+          ],
+        },
+        {
+          title: 'CAGR Anualizado',
+          description: 'Medida de rendimiento anual.',
+          highlight: true,
+          points: [
+            'Incluye el factor tiempo',
+            'Estandariza resultados',
+            'Permite comparaciones',
+            'Muestra crecimiento geométrico',
+          ],
+        },
+      ],
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'Investopedia: Definición de ROI',
+      url: 'https://www.investopedia.com/terms/r/returnoninvestment.asp',
+    },
+  ],
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FinancialProduct',
+      name: title,
+      description,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((f) => ({
+        '@type': 'Question',
+        name: f.question,
+        acceptedAnswer: { '@type': 'Answer', text: f.answer },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((h, i) => ({
+        '@type': 'HowToStep',
+        position: i + 1,
+        name: h.name,
+        text: h.text,
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      applicationCategory: 'FinanceApplication',
+      operatingSystem: 'All',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+  ],
+};

package/src/tool/profitability/i18n/fr.ts

@@ -0,0 +1,112 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: 'Investissement Initial',
+  labelFinalValue: 'Valeur Finale / Solde Actuel',
+  labelTimeSelection: 'Durée de l\'Investissement',
+  labelYears: 'Ans',
+  labelMonths: 'Mois',
+  labelDays: 'Jours',
+  labelROI: 'Retour sur Investissement (ROI)',
+  labelCAGR: 'Croissance Annualisée (CAGR)',
+  labelNetProfit: 'Bénéfice Net',
+  labelLinearGrowth: 'Croissance Linéaire (Estimée)',
+  labelExponentialGrowth: 'Croissance Composée (CAGR)',
+  labelPositiveResult: 'Investissement Rentable',
+  labelNegativeResult: 'Position Déficitaire',
+  labelCopyResult: 'Copier les Résultats',
+  labelCopied: 'Copié !',
+};
+
+const slug = 'calculateur-rentabilite-investissement-roi-cagr';
+const title = 'Calculateur de Rentabilité : ROI & CAGR';
+const description = 'Analysez la performance de vos investissements. Calculez le ROI total et le CAGR pour comprendre vos gains réels.';
+
+const faq = [
+  {
+    question: 'Qu\'est-ce qu\'un bon CAGR ?',
+    answer: 'Cela dépend de l\'actif. Le S&P 500 tourne historiquement autour de 7-10% par an.',
+  },
+  {
+    question: 'Pourquoi mon CAGR est-il différent de mon ROI total ?',
+    answer: 'Le ROI est le rendement total sans tenir compte du temps. Le CAGR est le taux annuel nécessaire pour atteindre ce rendement total.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Entrez votre capital initial',
+    text: 'Saisissez le montant investi à l\'origine.',
+  },
+  {
+    name: 'Entrez la valeur finale',
+    text: 'Saisissez la valeur actuelle du marché.',
+  },
+  {
+    name: 'Réglez la durée',
+    text: 'Indiquez la durée de détention de l\'investissement.',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs CAGR : Quelle métrique choisir ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Le <strong>ROI</strong> indique le gain total en pourcentage, mais ignore le temps. Le <strong>CAGR</strong> est supérieur pour l\'analyse à long terme car il "annualise" vos rendements.',
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'Définition du ROI - Investopedia',
+      url: 'https://www.investopedia.com/terms/r/returnoninvestment.asp',
+    },
+  ],
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FinancialProduct',
+      name: title,
+      description,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((f) => ({
+        '@type': 'Question',
+        name: f.question,
+        acceptedAnswer: { '@type': 'Answer', text: f.answer },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((h, i) => ({
+        '@type': 'HowToStep',
+        position: i + 1,
+        name: h.name,
+        text: h.text,
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      applicationCategory: 'FinanceApplication',
+      operatingSystem: 'All',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+  ],
+};

package/src/tool/profitability/i18n/id.ts

@@ -0,0 +1,112 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: 'Investasi Awal',
+  labelFinalValue: 'Nilai Akhir / Saldo Saat Ini',
+  labelTimeSelection: 'Durasi Investasi',
+  labelYears: 'Tahun',
+  labelMonths: 'Bulan',
+  labelDays: 'Hari',
+  labelROI: 'Laba atas Investasi (ROI)',
+  labelCAGR: 'Pertumbuhan Tahunan (CAGR)',
+  labelNetProfit: 'Laba Bersih',
+  labelLinearGrowth: 'Pertumbuhan Linear (Estimasi)',
+  labelExponentialGrowth: 'Pertumbuhan Majemuk (CAGR)',
+  labelPositiveResult: 'Investasi Menguntungkan',
+  labelNegativeResult: 'Posisi Kerugian',
+  labelCopyResult: 'Salin Hasil',
+  labelCopied: 'Disalin!',
+};
+
+const slug = 'kalkulator-profitabilitas-investasi-roi-cagr';
+const title = 'Kalkulator Profitabilitas: ROI & CAGR';
+const description = 'Analisis kinerja investasi Anda. Hitung ROI dan CAGR untuk memahami keuntungan riil Anda.';
+
+const faq = [
+  {
+    question: 'Berapa CAGR yang baik?',
+    answer: 'Secara historis S&P 500 memberikan imbal hasil sekitar 7-10% per tahun.',
+  },
+  {
+    question: 'Mengapa CAGR saya berbeda dari ROI total?',
+    answer: 'ROI adalah total pengembalian tanpa memandang waktu. CAGR adalah tingkat tahunan.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Masukkan modal awal',
+    text: 'Masukkan jumlah uang yang Anda investasikan semula.',
+  },
+  {
+    name: 'Masukkan nilai akhir',
+    text: 'Masukkan nilai pasar saat ini.',
+  },
+  {
+    name: 'Atur durasi waktu',
+    text: 'Tentukan berapa lama Anda memegang investasi tersebut.',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs CAGR: Metrik mana yang lebih baik?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>ROI</strong> menunjukkan total persentase keuntungan, tetapi mengabaikan waktu. <strong>CAGR</strong> lebih baik untuk analisis jangka panjang.',
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'Definisi ROI - Investopedia',
+      url: 'https://www.investopedia.com/terms/r/returnoninvestment.asp',
+    },
+  ],
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FinancialProduct',
+      name: title,
+      description,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((f) => ({
+        '@type': 'Question',
+        name: f.question,
+        acceptedAnswer: { '@type': 'Answer', text: f.answer },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((h, i) => ({
+        '@type': 'HowToStep',
+        position: i + 1,
+        name: h.name,
+        text: h.text,
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      applicationCategory: 'FinanceApplication',
+      operatingSystem: 'All',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+  ],
+};

package/src/tool/profitability/i18n/it.ts

@@ -0,0 +1,112 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: 'Investimento Iniziale',
+  labelFinalValue: 'Valore Finale / Saldo Attuale',
+  labelTimeSelection: 'Durata dell\'Investimento',
+  labelYears: 'Anni',
+  labelMonths: 'Mesi',
+  labelDays: 'Giorni',
+  labelROI: 'Rendimento dell\'Investimento (ROI)',
+  labelCAGR: 'Crescita Annualizzata (CAGR)',
+  labelNetProfit: 'Utile Netto',
+  labelLinearGrowth: 'Crescita Lineare (Stimata)',
+  labelExponentialGrowth: 'Crescita Composta (CAGR)',
+  labelPositiveResult: 'Investimento Redditizio',
+  labelNegativeResult: 'Posizione in Perdita',
+  labelCopyResult: 'Copia Risultati',
+  labelCopied: 'Copiato!',
+};
+
+const slug = 'calcolatore-redditivita-investimento-roi-cagr';
+const title = 'Calcolatore Redditività: ROI & CAGR';
+const description = 'Analizza il rendimento dei tuoi investimenti. Calcola ROI e CAGR per capire i tuoi guadagni reali.';
+
+const faq = [
+  {
+    question: 'Cos\'è un buon CAGR?',
+    answer: 'Storicamente l\'S&P 500 rende circa il 7-10% all\'anno.',
+  },
+  {
+    question: 'Perché il mio CAGR è diverso dal ROI totale?',
+    answer: 'Il ROI è il rendimento totale indipendentemente dal tempo. Il CAGR è il tasso annuale necessario per raggiungere tale rendimento.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Inserisci il capitale iniziale',
+    text: 'Inserisci l\'importo investito originariamente.',
+  },
+  {
+    name: 'Inserisci il valore finale',
+    text: 'Inserisci il valore di mercato attuale.',
+  },
+  {
+    name: 'Imposta la durata',
+    text: 'Specifica per quanto tempo hai mantenuto l\'investimento.',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs CAGR: Quale metrica è migliore?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Il <strong>ROI</strong> indica il guadagno percentuale totale, ma ignora il tempo. Il <strong>CAGR</strong> è migliore per le analisi a lungo termine.',
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'Definizione di ROI - Investopedia',
+      url: 'https://www.investopedia.com/terms/r/returnoninvestment.asp',
+    },
+  ],
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FinancialProduct',
+      name: title,
+      description,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((f) => ({
+        '@type': 'Question',
+        name: f.question,
+        acceptedAnswer: { '@type': 'Answer', text: f.answer },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((h, i) => ({
+        '@type': 'HowToStep',
+        position: i + 1,
+        name: h.name,
+        text: h.text,
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      applicationCategory: 'FinanceApplication',
+      operatingSystem: 'All',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+  ],
+};

package/src/tool/profitability/i18n/ja.ts

@@ -0,0 +1,112 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: '初期投資額',
+  labelFinalValue: '最終価値 / 現在の残高',
+  labelTimeSelection: '投資期間',
+  labelYears: '年',
+  labelMonths: 'ヶ月',
+  labelDays: '日',
+  labelROI: '投資収益率 (ROI)',
+  labelCAGR: '年平均成長率 (CAGR)',
+  labelNetProfit: '純利益',
+  labelLinearGrowth: '線形成長（推定）',
+  labelExponentialGrowth: '複利成長 (CAGR)',
+  labelPositiveResult: '利益の出ている投資',
+  labelNegativeResult: '損失状態',
+  labelCopyResult: '結果をコピー',
+  labelCopied: 'コピーしました！',
+};
+
+const slug = 'profitability-calculator-roi-cagr';
+const title = '投資収益性計算機：ROI & CAGR';
+const description = '投資パフォーマンスを正確に分析します。ROIとCAGRを計算して、真の年換算収益を把握しましょう。';
+
+const faq = [
+  {
+    question: '理想的なCAGRはどのくらいですか？',
+    answer: '歴史的に、S&P 500の年平均リターンは約7〜10%です。',
+  },
+  {
+    question: 'なぜCAGRはトータルROIと違うのですか？',
+    answer: 'ROIは期間に関係のない合計収益率です。CAGRは年換算された成長率です。',
+  },
+];
+
+const howTo = [
+  {
+    name: '初期資本を入力',
+    text: '最初に投資した金額を入力してください。',
+  },
+  {
+    name: '最終価値を入力',
+    text: '現在の市場価値を入力してください。',
+  },
+  {
+    name: '期間を設定',
+    text: '投資を保有していた期間を指定してください。',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs CAGR：どちらの指標が優れていますか？',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>ROI</strong>は全体の収益率を示しますが、期間を考慮しません。<strong>CAGR</strong>は期間を「年換算」するため、長期分析に優れています。',
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'ROIの定義 - Investopedia',
+      url: 'https://www.investopedia.com/terms/r/returnoninvestment.asp',
+    },
+  ],
+  howTo,
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FinancialProduct',
+      name: title,
+      description,
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      mainEntity: faq.map((f) => ({
+        '@type': 'Question',
+        name: f.question,
+        acceptedAnswer: { '@type': 'Answer', text: f.answer },
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      name: title,
+      step: howTo.map((h, i) => ({
+        '@type': 'HowToStep',
+        position: i + 1,
+        name: h.name,
+        text: h.text,
+      })),
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      name: title,
+      applicationCategory: 'FinanceApplication',
+      operatingSystem: 'All',
+      offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    },
+  ],
+};