@jjlmoya/utils-finance 1.16.0 → 1.18.0

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

@@ -0,0 +1,112 @@
+import type { ProfitabilityUI } from '../ui';
+import type { ToolLocaleContent } from '../../../types';
+
+export const ui: ProfitabilityUI = {
+  labelInitialInvestment: 'Başlangıç Yatırımı',
+  labelFinalValue: 'Final Değeri / Mevcut Bakiye',
+  labelTimeSelection: 'Yatırım Süresi',
+  labelYears: 'Yıl',
+  labelMonths: 'Ay',
+  labelDays: 'Gün',
+  labelROI: 'Yatırım Getirisi (ROI)',
+  labelCAGR: 'Yıllık Büyüme Oranı (CAGR)',
+  labelNetProfit: 'Net Kar',
+  labelLinearGrowth: 'Doğrusal Büyüme (Tahmini)',
+  labelExponentialGrowth: 'Bileşik Büyüme (CAGR)',
+  labelPositiveResult: 'Karlı Yatırım',
+  labelNegativeResult: 'Zarar Pozisyonu',
+  labelCopyResult: 'Sonuçları Kopyala',
+  labelCopied: 'Kopyalandı!',
+};
+
+const slug = 'yatirim-karlilik-hesaplama-roi-cagr';
+const title = 'Karlılık Hesaplayıcı: ROI & CAGR';
+const description = 'Yatırım performansınızı analiz edin. Gerçek kazançlarınızı anlamak için ROI ve CAGR hesaplayın.';
+
+const faq = [
+  {
+    question: 'İyi bir CAGR nedir?',
+    answer: 'Tarihsel olarak S&P 500 yıllık yaklaşık %7-10 getiri sağlar.',
+  },
+  {
+    question: 'CAGR neden toplam ROI\'den farklıdır?',
+    answer: 'ROI zamandan bağımsız toplam getiridir. CAGR ise yıllık orandır.',
+  },
+];
+
+const howTo = [
+  {
+    name: 'Başlangıç sermayesini girin',
+    text: 'Orijinal yatırım miktarını girin.',
+  },
+  {
+    name: 'Final değerini girin',
+    text: 'Mevcut piyasa değerini girin.',
+  },
+  {
+    name: 'Süreyi belirleyin',
+    text: 'Yatırımı ne kadar süre tuttuğunuzu belirtin.',
+  },
+];
+
+export const content: ToolLocaleContent<ProfitabilityUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: [
+    {
+      type: 'title',
+      text: 'ROI vs CAGR: Hangi metrik daha iyi?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>ROI</strong> toplam getiri yüzdesini gösterir ancak zamanı dikkate almaz. <strong>CAGR</strong> uzun vadeli analiz için daha iyidir.',
+    },
+  ],
+  faq,
+  bibliography: [
+    {
+      name: 'ROI Tanımı - 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/zh.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: '从历史来看，标普 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 与 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' },
+    },
+  ],
+};

package/src/tool/profitability/index.ts

@@ -0,0 +1,10 @@
+import { profitability } from './entry';
+import type { ToolDefinition } from '../../types';
+
+export * from './entry';
+export const PROFITABILITY_TOOL: ToolDefinition = {
+  entry: profitability,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/profitability/logic.ts

@@ -0,0 +1,43 @@
+export interface ProfitabilityInput {
+  initialInvestment: number;
+  finalValue: number;
+  timeValue: number;
+  timeUnit: 'days' | 'months' | 'years';
+}
+
+export interface ProfitabilityResult {
+  roi: number;
+  cagr: number;
+  netProfit: number;
+  isPositive: boolean;
+  years: number;
+}
+
+export class ProfitabilityCalculator {
+  static calculate(input: ProfitabilityInput): ProfitabilityResult {
+    const { initialInvestment, finalValue, timeValue, timeUnit } = input;
+    
+    let years = 0;
+    if (timeUnit === 'days') years = timeValue / 365;
+    else if (timeUnit === 'months') years = timeValue / 12;
+    else years = timeValue;
+
+    const netProfit = finalValue - initialInvestment;
+    const isPositive = netProfit >= 0;
+    
+    const roi = initialInvestment !== 0 ? (netProfit / initialInvestment) * 100 : 0;
+    
+    let cagr = 0;
+    if (initialInvestment > 0 && finalValue > 0 && years > 0) {
+      cagr = (Math.pow(finalValue / initialInvestment, 1 / years) - 1) * 100;
+    }
+
+    return {
+      roi: Number(roi.toFixed(2)),
+      cagr: Number(cagr.toFixed(2)),
+      netProfit: Number(netProfit.toFixed(2)),
+      isPositive,
+      years
+    };
+  }
+}

package/src/tool/profitability/profitability-calculator.css

@@ -0,0 +1,263 @@
+.prof-root {
+  --prof-brand: #10b981;
+  --prof-brand-light: #34d399;
+  --prof-brand-dark: #059669;
+  --prof-danger: #ef4444;
+  --prof-bg: var(--surface-1);
+  --prof-card-bg: var(--surface-2);
+  --prof-input-bg: var(--surface-3);
+  --prof-text: var(--text-1);
+  --prof-text-muted: var(--text-2);
+  --prof-border: var(--border-color);
+  
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+  width: 100%;
+  max-width: 1000px;
+  margin: 0 auto;
+}
+
+.theme-dark .prof-root {
+  --prof-input-bg: #064e3b;
+  --prof-card-bg: #022c22;
+  --prof-border: #065f46;
+}
+
+.prof-card {
+  background: var(--prof-card-bg);
+  border: 2px solid var(--prof-border);
+  border-radius: 2.5rem;
+  padding: 3.5rem;
+  box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.2);
+  transition: all 0.5s cubic-bezier(0.4, 0, 0.2, 1);
+  position: relative;
+}
+
+.prof-card.positive {
+  border-color: var(--prof-brand);
+  box-shadow: 0 25px 50px -12px rgba(16, 185, 129, 0.2);
+}
+
+.prof-card.negative {
+  border-color: var(--prof-danger);
+  box-shadow: 0 25px 50px -12px rgba(239, 68, 68, 0.2);
+}
+
+.prof-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 5rem;
+  align-items: center;
+}
+
+@media (max-width: 900px) {
+  .prof-grid {
+    grid-template-columns: 1fr;
+    gap: 3rem;
+  }
+}
+
+.prof-input-group {
+  margin-bottom: 2rem;
+}
+
+.prof-label-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 0.75rem;
+}
+
+.prof-currency-select {
+  background: none;
+  border: none;
+  color: var(--prof-brand);
+  font-weight: 900;
+  font-size: 1.1rem;
+  cursor: pointer;
+  padding-right: 1.5rem;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke='%2310b981' stroke-width='4' %3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='M19 9l-7 7-7-7'%3E%3C/path%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right center;
+  background-size: 1rem;
+}
+
+.prof-currency-select:focus {
+  outline: none;
+}
+
+:global(.theme-dark) .prof-currency-select {
+  color: #34d399;
+}
+
+.prof-label {
+  display: block;
+  font-size: 0.95rem;
+  font-weight: 800;
+  color: var(--prof-text-muted);
+  margin-bottom: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.prof-input-field {
+  width: 100%;
+  background: var(--prof-input-bg);
+  border: 2px solid var(--prof-border);
+  border-radius: 1.25rem;
+  padding: 1.25rem 1.5rem;
+  font-size: 1.75rem;
+  font-weight: 900;
+  color: var(--prof-text);
+  transition: all 0.3s;
+  box-shadow: inset 0 2px 4px rgba(0,0,0,0.1);
+}
+
+.prof-input-field:hover {
+  border-color: var(--prof-brand-light);
+}
+
+.prof-input-field:focus {
+  border-color: var(--prof-brand);
+  background: var(--prof-card-bg);
+  outline: none;
+  box-shadow: 0 0 0 6px rgba(16, 185, 129, 0.2);
+}
+
+.prof-time-row {
+  display: flex;
+  gap: 1rem;
+}
+
+.prof-unit-select {
+  appearance: none;
+  background-color: var(--prof-input-bg);
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke='%2310b981' stroke-width='3' %3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='M19 9l-7 7-7-7'%3E%3C/path%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 1rem center;
+  background-size: 1.25rem;
+  border: 2px solid var(--prof-border);
+  border-radius: 1.25rem;
+  color: var(--prof-text);
+  cursor: pointer;
+  font-weight: 800;
+  padding: 0 3.5rem 0 1.5rem;
+  transition: all 0.2s;
+}
+
+.prof-unit-select:hover {
+  border-color: var(--prof-brand);
+}
+
+.prof-unit-select option {
+  background-color: var(--prof-card-bg);
+  color: var(--prof-text);
+  padding: 1rem;
+}
+
+:global(.theme-dark) .prof-unit-select {
+  background-color: #064e3b;
+  color: #ecfdf5;
+  border-color: #065f46;
+}
+
+:global(.theme-dark) .prof-unit-select option {
+  background-color: #064e3b;
+  color: #ecfdf5;
+}
+
+.prof-results {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.prof-status-badge {
+  display: inline-flex;
+  padding: 0.75rem 1.5rem;
+  border-radius: 2rem;
+  font-weight: 900;
+  font-size: 1rem;
+  text-transform: uppercase;
+  margin-bottom: 1.5rem;
+}
+
+.prof-status-badge.positive {
+  background: var(--prof-brand);
+  color: white;
+}
+
+.prof-status-badge.negative {
+  background: var(--prof-danger);
+  color: white;
+}
+
+.prof-main-metric {
+  margin-bottom: 2rem;
+}
+
+.prof-metric-val {
+  font-size: 5.5rem;
+  font-weight: 900;
+  line-height: 1;
+  letter-spacing: -0.06em;
+  margin: 0.5rem 0;
+  filter: drop-shadow(0 4px 8px rgba(0,0,0,0.1));
+}
+
+.positive .prof-metric-val { color: var(--prof-brand); }
+.negative .prof-metric-val { color: var(--prof-danger); }
+
+.prof-submetrics {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1.5rem;
+}
+
+.prof-submetric-card {
+  background: var(--prof-input-bg);
+  padding: 1.75rem;
+  border-radius: 1.5rem;
+  border: 1px solid var(--prof-border);
+  text-align: center;
+}
+
+.prof-submetric-val {
+  display: block;
+  font-size: 2rem;
+  font-weight: 900;
+  color: var(--prof-text);
+  margin-top: 0.5rem;
+}
+
+.prof-copy-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.75rem;
+  width: 100%;
+  padding: 1.5rem;
+  background: var(--prof-text);
+  color: var(--prof-card-bg);
+  border: none;
+  border-radius: 1.5rem;
+  font-weight: 900;
+  font-size: 1.25rem;
+  cursor: pointer;
+  transition: all 0.3s;
+  margin-top: 1rem;
+  box-shadow: 0 10px 20px rgba(0,0,0,0.2);
+}
+
+.prof-copy-btn:hover {
+  transform: translateY(-3px);
+  box-shadow: 0 15px 30px rgba(0,0,0,0.3);
+}
+
+.prof-chart-wrap {
+  margin-top: 4rem;
+  padding-top: 3.5rem;
+  border-top: 2px solid var(--prof-border);
+  height: 400px;
+}

package/src/tool/profitability/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { profitability } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await profitability.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/profitability/ui.ts

@@ -0,0 +1,20 @@
+export interface ProfitabilityUI extends Record<string, string> {
+  labelTitle: string;
+  labelInitialInvestment: string;
+  labelFinalValue: string;
+  labelTimePeriod: string;
+  labelYears: string;
+  labelMonths: string;
+  labelDays: string;
+  labelROI: string;
+  labelCAGR: string;
+  labelNetProfit: string;
+  labelPositiveResult: string;
+  labelNegativeResult: string;
+  labelCopyResult: string;
+  labelCopied: string;
+  labelGrowthChart: string;
+  labelLinearGrowth: string;
+  labelExponentialGrowth: string;
+  labelTimeSelection: string;
+}

package/src/tools.ts

@@ -1,6 +1,8 @@
 export { ALL_ENTRIES } from './entries';
 import type { ToolDefinition } from './types';
 import { COMPOUND_INTEREST_TOOL } from './tool/compoundInterest';
+import { FINANCIAL_FREEDOM_TOOL } from './tool/financialFreedom';
+import { PROFITABILITY_TOOL } from './tool/profitability';
 import { MORTGAGE_TOOL } from './tool/mortgage';
 import { INFLATION_TOOL } from './tool/inflation';
 import { PERCENTAGE_CALCULATOR_TOOL } from './tool/percentageCalculator';
@@ -13,6 +15,6 @@ import { LEGAL_INTEREST_RATE_TOOL } from './tool/legalInterestRate';
 import { FIRE_CALCULATOR_TOOL } from './tool/fireCalculator';
 import { DEBT_SNOWBALL_TOOL } from './tool/debtSnowball';
 
-export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, MORTGAGE_TOOL, INFLATION_TOOL, PERCENTAGE_CALCULATOR_TOOL, LATE_INTEREST_TOOL, IBAN_BIC_SWIFT_TOOL, RENT_INCREASE_TOOL, LOTTERY_OPTIMIZER_TOOL, COURT_FEE_CALCULATOR_TOOL, LEGAL_INTEREST_RATE_TOOL, FIRE_CALCULATOR_TOOL, DEBT_SNOWBALL_TOOL];
+export const ALL_TOOLS: ToolDefinition[] = [COMPOUND_INTEREST_TOOL, FINANCIAL_FREEDOM_TOOL, PROFITABILITY_TOOL, MORTGAGE_TOOL, INFLATION_TOOL, PERCENTAGE_CALCULATOR_TOOL, LATE_INTEREST_TOOL, IBAN_BIC_SWIFT_TOOL, RENT_INCREASE_TOOL, LOTTERY_OPTIMIZER_TOOL, COURT_FEE_CALCULATOR_TOOL, LEGAL_INTEREST_RATE_TOOL, FIRE_CALCULATOR_TOOL, DEBT_SNOWBALL_TOOL];