@jjlmoya/utils-finance 1.4.0 → 1.7.0

package/src/tool/fireCalculator/i18n/pl.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 = 'kalkulator-reguly-4-procent-fire';
+const title = 'Kalkulator FIRE: Reguła 4% dla Twojej wolności finansowej';
+const description = 'Oblicz swoją magiczną liczbę niezależności finansowej, korzystając z reguły 4%. Zaplanuj wcześniejszą emeryturę i zwizualizuj swoją drogę do wolności ekonomicznej.';
+
+const faqData = [
+  {
+    question: 'Czym jest reguła 4%?',
+    answer: 'Reguła 4% to strategia wypłat oparta na badaniu Trinity Study, która wskazuje, że możesz wypłacać 4% swojego majątku w pierwszym roku emerytury, dostosowując tę kwotę o inflację w kolejnych latach, bez wyczerpania funduszy przez 30 lat.',
+  },
+  {
+    question: 'Co to jest FIRE?',
+    answer: 'FIRE to skrót od Financial Independence, Retire Early (Niezależność Finansowa, Wczesna Emerytura). To ruch dążący do osiągnięcia wolności ekonomicznej poprzez agresywne połączenie oszczędzania i inteligentnego inwestowania.',
+  },
+  {
+    question: 'Jaka jest moja magiczna liczba?',
+    answer: 'Twoja magiczna liczba to całkowity majątek, który musisz zgromadzić, aby móc żyć z wypracowanych zysków bez konieczności pracy. Oblicza się ją, dzieląc roczne wydatki przez bezpieczną stopę wypłat (zwykle 4%).',
+  },
+  {
+    question: 'Jaka jest różnica między Lean, Barista i Fat FIRE?',
+    answer: 'Lean FIRE to życie przy minimalnych wydatkach (70% obecnych wydatków), Barista FIRE to praca na pół etatu, podczas gdy zyski pokrywają resztę (50% wydatków), a Fat FIRE to posiadanie wystawnego stylu życia (150% wydatków).',
+  },
+  {
+    question: 'Czy reguła 4% jest realistyczna?',
+    answer: 'Reguła 4% ma historyczne prawdopodobieństwo sukcesu na poziomie 95% w portfelu 50/50 akcje-obligacje przez 30 lat. Nie uwzględnia jednak ryzyka sekwencji stóp zwrotu i opiera się głównie na danych z rynku amerykańskiego.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Oblicz swoje miesięczne wydatki',
+    text: 'Przeanalizuj, ile naprawdę wydajesz każdego miesiąca, wliczając mieszkanie, jedzenie, usługi i rozrywkę.',
+  },
+  {
+    name: 'Wybierz bezpieczną stopę wypłat',
+    text: 'Reguła 4% jest standardem, ale możesz ją dostosować w zakresie od 2,5% (bardziej konserwatywnie) do 6% (bardziej agresywnie) w zależności od tolerancji na ryzyko.',
+  },
+  {
+    name: 'Wprowadź swój obecny majątek',
+    text: 'Zsumuj wszystkie swoje inwestycje, oszczędności i aktywa generujące dochód pasywny.',
+  },
+  {
+    name: 'Zwizualizuj swoje postępy',
+    text: 'Obserwuj wykres wzrostu i kamienie milowe wolności (Lean, Barista, Fat FIRE), aby zrozumieć, kiedy osiągniesz swój cel.',
+  },
+];
+
+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: 'Bogleheads - Przewodnik po inwestowaniu',
+    url: 'https://bogleheads.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: 'pl',
+};
+
+export const content: ToolLocaleContent<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Często zadawane pytania o FIRE',
+  faq: faqData,
+  bibliographyTitle: 'Źródła i referencje',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Reguła 4%: Święty Graal wczesnej emerytury',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Dowiedz się, jak obliczyć majątek potrzebny na życie z renty na zawsze. <strong>Reguła 4%</strong> wywodzi się z badania Trinity Study, przeprowadzonego w 1998 roku przez trzech profesorów finansów. Przeanalizowali oni dane historyczne od 1926 roku, aby określić, jaki procent można wypłacać rocznie bez wyczerpania portfela w ciągu 30 lat.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Historyczny sukces' },
+        { value: '50/50', label: 'Mix Akcje/Obligacje' },
+        { value: '30', label: 'Lat horyzontu' },
+        { value: '4%', label: 'Bezpieczna wypłata' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Czym jest ruch FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE to akronim od Financial Independence, Retire Early (Niezależność Finansowa, Wczesna Emerytura).',
+        'Dąży do wolności wyboru tego, co robić ze swoim czasem, bez ograniczeń finansowych.',
+        'Opiera się na optymalizacji oszczędności i inteligentnym inwestowaniu.',
+        'Celem jest, aby Twoje aktywa generowały wystarczające przepływy pieniężne na pokrycie wydatków.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Rodzaje wolności finansowej',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Minimalistyczny styl życia. Pokrywa tylko podstawowe koszty przetrwania.',
+          points: ['Ekstremalne oszczędzanie', 'Bardzo niskie wydatki', 'Skromna wolność'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Sytuacja hybrydowa, w której inwestycje pokrywają połowę wydatków.',
+          points: ['Praca dla przyjemności', 'Ubezpieczenie społeczne zapewnione', 'Mniejszy stres'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Emerytura z dużym budżetem, który pozwala na luksusy i podróże.',
+          points: ['Wysoki majątek', 'Zero ograniczeń', 'Dziedzictwo rodzinne'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Jak korzystać z naszego kalkulatora FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Śledzenie wydatków:</strong> Przeanalizuj swoje rzeczywiste wydatki z ostatnich 12 miesięcy.',
+        '<strong>Definicja SWR:</strong> Wybierz bezpieczną stopę wypłat zgodnie ze swoim ryzykiem.',
+        '<strong>Obecny majątek:</strong> Wprowadź wartość swoich obecnych inwestycji.',
+        '<strong>Zdolność oszczędzczania:</strong> Zaprognozuj, ile czasu zostało Ci do celu.',
+        '<strong>Wizualizacja graficzna:</strong> Przeanalizuj wykres wzrostu swojego bogactwa.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Analiza reguły 4%',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Zalety',
+          description: 'Dlaczego reguła 4% działa',
+          points: [
+            'Prostota matematyczna dla szybkiego planowania.',
+            'Oparta na danych historycznych z niemal stulecia.',
+            'Możliwość dostosowania do każdego poziomu wydatków.',
+          ],
+        },
+        {
+          title: 'Ograniczenia',
+          description: 'Czego nie obejmuje reguła 4%',
+          points: [
+            'Nie uwzględnia ryzyka sekwencji stóp zwrotu.',
+            'Oparta głównie na rynku amerykańskim.',
+            'Ignoruje drastyczne zmiany w lokalnych podatkach.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Krytyczny czynnik: Inflacja',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Pamiętaj, że 1000 zł dzisiaj nie kupi tego samego w przyszłości. Kluczowe jest stosowanie realnych stóp zwrotu (po odliczeniu inflacji), aby Twoje prognozy zachowały dzisiejszą siłę nabywczą. Reguła 4% zakłada, że co roku dostosowujesz wypłaty o inflację.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Kalkulator FIRE: Reguła 4%',
+    labelDescription: 'Oblicz swoją magiczną liczbę niezależności finansowej za pomocą reguły 4% i zwizualizuj swoje kamienie milowe do wolności.',
+    labelMonthlyExpenses: 'Miesięczne wydatki',
+    labelSWR: 'Stopa wypłat (SWR)',
+    labelCurrentWorth: 'Obecny majątek',
+    labelMonthlySavings: 'Zdolność oszczędzania miesięcznie',
+    labelAnnualReturn: 'Szacowany zwrot (netto)',
+    labelFreedomMilestones: 'Kamienie milowe wolności',
+    labelLeanFIRE: 'Lean FIRE (70% przetrwania)',
+    labelBaristaFIRE: 'Barista FIRE (50% dochodów)',
+    labelFatFIRE: 'Fat FIRE (150% luksusu)',
+    labelMagicNumber: 'Twoja magiczna liczba do bycia wolnym',
+    labelMagicNumberDesc: 'Kapitał potrzebny na życie z renty',
+    labelTimeRemaining: 'Czas do wolności finansowej',
+    labelTimeRemainingFormat: 'Brakuje Ci {years} lat i {months} miesięcy',
+    labelAlreadyFI: 'Osiągnąłeś już wolność finansową!',
+    labelUnachievable: 'Cel nieosiągalny przy tym oszczędzaniu',
+    labelHiddenCostsChecklist: 'Checklista ukrytych kosztów',
+    labelHealth: 'Ubezpieczenie zdrowotne (+200 zł)',
+    labelTaxes: 'Podatki (+150 zł)',
+    labelHome: 'Utrzymanie domu (+100 zł)',
+    labelTravel: 'Podróże i rozrywka (+300 zł)',
+    labelEmergency: 'Fundusz awaryjny (+100 zł)',
+    labelSubscriptions: 'Subskrypcje (+50 zł)',
+    labelAdded: 'Dodano:',
+    labelSavePlan: 'Zapisz plan',
+    labelSWRTooltip: 'Safe Withdrawal Rate: Procent Twoich oszczędności, który możesz wypłacać co roku bez ryzyka wyczerpania pieniędzy.',
+    labelReturnTooltip: 'Roczny zwrot z rynku (już po odliczeniu inflacji). Historyczny standard to 7%.',
+    currencySymbol: 'zł',
+    currencyCode: 'PLN',
+    currencyLocale: 'pl-PL',
+  },
+};

package/src/tool/fireCalculator/i18n/pt.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-regra-4-por-cento-fire';
+const title = 'Calculadora FIRE: Regra dos 4% para a sua Liberdade Financeira';
+const description = 'Calcule o seu número mágico para a independência financeira usando a regra dos 4%. Planeie a sua reforma antecipada e visualize o seu caminho para a liberdade económica.';
+
+const faqData = [
+  {
+    question: 'O que é a Regra dos 4%?',
+    answer: 'A Regra dos 4% é uma estratégia de levantamento baseada no Estudo Trinity que indica que pode levantar 4% do seu património no primeiro ano de reforma, ajustando pela inflação nos anos seguintes, sem esgotar os seus fundos em 30 anos.',
+  },
+  {
+    question: 'O que é FIRE?',
+    answer: 'FIRE significa Financial Independence, Retire Early (Independência Financeira, Reforma Antecipada). É um movimento que procura alcançar a liberdade económica através de uma combinação agressiva de poupança e investimento inteligente.',
+  },
+  {
+    question: 'Qual é o meu número mágico?',
+    answer: 'O seu número mágico é o património total que precisa de acumular para poder viver dos rendimentos sem trabalhar. É calculado dividindo as suas despesas anuais pela taxa de levantamento segura (geralmente 4%).',
+  },
+  {
+    question: 'Qual a diferença entre Lean, Barista e Fat FIRE?',
+    answer: 'Lean FIRE é viver com despesas mínimas (70% das despesas atuais), Barista FIRE é trabalhar a tempo parcial enquanto os rendimentos cobrem o resto (50% das despesas), e Fat FIRE é ter um estilo de vida folgado (150% das despesas).',
+  },
+  {
+    question: 'A Regra dos 4% é realista?',
+    answer: 'A Regra dos 4% tem uma probabilidade histórica de sucesso de 95% numa carteira 50/50 ações-obrigações durante 30 anos. No entanto, não contempla o risco de sequência de retornos e baseia-se principalmente em dados do mercado norte-americano.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Calcule as suas despesas mensais',
+    text: 'Analise quanto gasta realmente cada mês, incluindo habitação, alimentação, serviços e entretenimento.',
+  },
+  {
+    name: 'Escolha a sua taxa de levantamento segura',
+    text: 'A Regra dos 4% é o padrão, mas pode ajustar entre 2,5% (mais conservador) e 6% (mais agressivo) de acordo com a sua tolerância ao risco.',
+  },
+  {
+    name: 'Introduza o seu património atual',
+    text: 'Some o total dos seus investimentos, poupanças e ativos que geram rendimento passivo.',
+  },
+  {
+    name: 'Visualize o seu progresso',
+    text: 'Observe o gráfico de crescimento e os marcos de liberdade (Lean, Barista, Fat FIRE) para entender quando alcançará a sua 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: 'Bogleheads - Guia de Investimento',
+    url: 'https://bogleheads.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: 'pt',
+};
+
+export const content: ToolLocaleContent<FIRECalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Perguntas Frequentes sobre FIRE',
+  faq: faqData,
+  bibliographyTitle: 'Fontes e Referências',
+  bibliography: bibliographyData,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Regra dos 4%: O Santo Graal da Reforma Antecipada',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Descubra como calcular o património necessário para viver dos rendimentos para sempre. A <strong>Regra dos 4%</strong> surgiu do Estudo Trinity, realizado em 1998 por três professores de finanças. Analisaram dados históricos desde 1926 para determinar que percentagem se podia levantar anualmente sem esgotar a carteira em 30 anos.',
+    },
+    {
+      type: 'stats',
+      columns: 4,
+      items: [
+        { value: '95%', label: 'Sucesso Histórico' },
+        { value: '50/50', label: 'Mix Ações/Obrigações' },
+        { value: '30', label: 'Anos de Horizonte' },
+        { value: '4%', label: 'Levantamento Seguro' },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'O que é o Movimento FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'FIRE é a sigla para Financial Independence, Retire Early (Independência Financeira, Reforma Antecipada).',
+        'Procura a liberdade de escolher o que fazer com o seu tempo sem que o dinheiro seja um condicionante.',
+        'Baseia-se na otimização da poupança e no investimento inteligente.',
+        'O objetivo é que os seus ativos gerem fluxo de caixa suficiente para cobrir as suas despesas.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Tipos de Liberdade Financeira',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 3,
+      items: [
+        {
+          title: 'Lean FIRE',
+          description: 'Estilo de vida minimalista. Cobre apenas as despesas básicas de sobrevivência.',
+          points: ['Poupança extrema', 'Gasto muito baixo', 'Liberdade frugal'],
+        },
+        {
+          title: 'Barista FIRE',
+          description: 'Situação híbrida onde os seus investimentos cobrem a metade das suas despesas.',
+          points: ['Trabalho por prazer', 'Segurança social coberta', 'Menor stresse'],
+        },
+        {
+          title: 'Fat FIRE',
+          description: 'Reforma com um orçamento folgado que permite luxos e viagens.',
+          points: ['Alto património', 'Zero restrições', 'Legado familiar'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Como usar a nossa Calculadora FIRE?',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Controlo de Despesas:</strong> Analise as suas despesas reais dos últimos 12 meses.',
+        '<strong>Definição de SWR:</strong> Escolha a sua taxa de levantamento segura de acordo com o seu risco.',
+        '<strong>Património Atual:</strong> Introduza o valor dos seus investimentos atuais.',
+        '<strong>Capacidade de Poupança:</strong> Projete quanto tempo lhe resta para a meta.',
+        '<strong>Visualização Visual:</strong> Analise o gráfico de crescimento da sua riqueza.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Análise da Regra dos 4%',
+      level: 3,
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          title: 'Vantagens',
+          description: 'Por que funciona a regra dos 4%',
+          points: [
+            'Simplicidade matemática para planeamento rápido.',
+            'Baseada em dados históricos de quase um século.',
+            'Adaptável a qualquer nível de gasto.',
+          ],
+        },
+        {
+          title: 'Limitações',
+          description: 'O que não cobre a regra dos 4%',
+          points: [
+            'Não contempla o risco de sequência de retornos.',
+            'Baseada principalmente no mercado norte-americano.',
+            'Ignora mudanças drásticas na fiscalidade local.',
+          ],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Factor Crítico: A Inflação',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Lembre-se que 1.000€ hoje não comprarão o mesmo no futuro. É vital usar rentabilidades reais (descontada a inflação) para que as suas projeções mantenham o poder de compra atual. A Regra dos 4% assume que ajusta os seus levantamentos anualmente pela inflação.',
+    },
+  ],
+  ui: {
+    labelTitle: 'Calculadora FIRE: Regra dos 4%',
+    labelDescription: 'Calcule o seu número mágico para a independência financeira usando a regra dos 4% e visualize os seus marcos para a liberdade.',
+    labelMonthlyExpenses: 'Despesas Mensais',
+    labelSWR: 'Taxa de Levantamento (SWR)',
+    labelCurrentWorth: 'Património Atual',
+    labelMonthlySavings: 'Capacidade de Poupança Mensal',
+    labelAnnualReturn: 'Rentabilidade Estimada (Neta)',
+    labelFreedomMilestones: 'Marcos de Liberdade',
+    labelLeanFIRE: 'Lean FIRE (70% sobrevivência)',
+    labelBaristaFIRE: 'Barista FIRE (50% rendimento)',
+    labelFatFIRE: 'Fat FIRE (150% luxo)',
+    labelMagicNumber: 'O Seu Número Mágico para ser Livre',
+    labelMagicNumberDesc: 'Capital necessário para viver dos rendimentos',
+    labelTimeRemaining: 'Tempo até à liberdade financeira',
+    labelTimeRemainingFormat: 'Faltam-lhe {years} anos e {months} meses',
+    labelAlreadyFI: 'Já alcançou a liberdade financeira!',
+    labelUnachievable: 'Meta inalcançável com esta poupança',
+    labelHiddenCostsChecklist: 'Checklist de Despesas Ocultas',
+    labelHealth: 'Seguro de Saúde (+200€)',
+    labelTaxes: 'Impostos (+150€)',
+    labelHome: 'Manutenção da Casa (+100€)',
+    labelTravel: 'Viagens e Lazer (+300€)',
+    labelEmergency: 'Fundo de Emergência (+100€)',
+    labelSubscriptions: 'Subscrições (+50€)',
+    labelAdded: 'Adicionado:',
+    labelSavePlan: 'Guardar Plano',
+    labelSWRTooltip: 'Safe Withdrawal Rate: Percentagem das suas poupanças que pode levantar todos os anos sem ficar sem dinheiro.',
+    labelReturnTooltip: 'Rendimento anual do mercado (já descontada a inflação). O padrão histórico é de 7%.',
+    currencySymbol: '€',
+    currencyCode: 'EUR',
+    currencyLocale: 'pt-PT',
+  },
+};