@jjlmoya/utils-finance 1.1.0

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

@@ -0,0 +1,233 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PercentageCalculatorUI } from '../ui';
+
+const slug = 'percentage-calculator';
+const title = 'Percentage Calculator: 4 in 1 for Discounts, Tax and Markups';
+const description =
+  'Calculate percentages online for free. 4 tools in 1 to find X% of Y, percentage difference, add or subtract VAT, discounts and tip calculations automatically.';
+
+const faqData = [
+  {
+    question: 'How does the calculator work?',
+    answer:
+      'Simply type the values in the fields of the use case that matches your problem and our calculator processes the formula without needing to press a calculate button.',
+  },
+  {
+    question: 'Is it valid for calculating VAT or taxes?',
+    answer:
+      'Yes, Case 4 (Add or subtract percentage) is designed precisely for cases like applying a 21% VAT to a base price or calculating negative income tax.',
+  },
+  {
+    question: 'Does it handle decimals and negative numbers?',
+    answer:
+      'Of course. You can enter decimal numbers (using a period) and it will also work with negative values if you need to analyze accounting balances in losses.',
+  },
+  {
+    question: 'Can I copy the results?',
+    answer:
+      'Yes, each case has a button in the result box that instantly copies the number to your device\'s clipboard so you can paste it in another app or document.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Identify your math problem',
+    text: 'Read the titles of the 4 cases and choose the one that matches what you want to know (Ex. What is 20% of 50? → Case 1).',
+  },
+  {
+    name: 'Enter the numbers',
+    text: 'Fill in the X and Y fields. Do not worry about the order, the text of each case guides you visually.',
+  },
+  {
+    name: 'Copy the instant result',
+    text: 'The number will appear in real time below as you type. Click the copy icon if you want to take it elsewhere.',
+  },
+];
+
+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: 'USD' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<PercentageCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Sources & References',
+  bibliography: [
+    {
+      name: 'Percentage Calculation: Wikipedia',
+      url: 'https://en.wikipedia.org/wiki/Percentage',
+    },
+    {
+      name: 'Basic Math Concepts: Khan Academy',
+      url: 'https://www.khanacademy.org/math/pre-algebra',
+    },
+    {
+      name: 'IRS: Tax Guide and Calculation Methods',
+      url: 'https://www.irs.gov/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '4-in-1 Percentage Calculator: Master Quick Calculations',
+      level: 2,
+    },
+    {
+      type: 'title',
+      text: 'Why You Need a Multi-Purpose Percentage Calculator',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Calculating percentages is one of the most common mathematical operations in our daily lives. From figuring out discounts during a sale, to calculating the right tip at a restaurant, determining profit margins in business, or understanding loan interest. Despite being everyday operations, it\'s not always easy to do them mentally or remember the exact formula.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Our 4-in-1 percentage calculator bundles the most common scenarios you\'ll face. No more searching Google for "how to calculate 20 percent" or "percentage formula." You have all four essential operations in one place, interactive and with instant results.',
+    },
+    {
+      type: 'title',
+      text: 'Exploring the 4 Most Common Use Cases',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'To make your life easier, we\'ve separated the tool into four clear visual blocks that solve real-world problems you encounter daily:',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:percent',
+      title: '1. What is X% of Y?',
+      html: '<p><strong>The classic case.</strong> Perfect for calculating discounts or tips. If you want to know what 15% of $120 is, this is your tool. The underlying formula simply divides the percentage by 100 and multiplies it by the total value.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:division',
+      title: '2. What Percentage is X of Y?',
+      html: '<p><strong>Ideal for proportions.</strong> If you scored 45 points on a 60-point exam, what\'s your percentage score? This function divides the part by the total and multiplies by 100, giving you the exact relative weight.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:chart-line-variant',
+      title: '3. Percentage Increase or Decrease',
+      html: '<p><strong>Perfect for finance and analytics.</strong> How much has your rent increased since last year? If you paid $800 before and $840 now, this function tells you it\'s a 5% increase. It measures growth or decline between two numbers.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:calculator',
+      title: '4. Add or Subtract Percentage from a Value',
+      html: '<p><strong>Super useful for sales tax.</strong> If you have a base price (e.g., $100) and need to add 8.5% sales tax, this calculator gives you the $108.50 final total instantly without intermediate steps. Similarly, it works for applying discounts directly (e.g., subtract 20%).</p>',
+    },
+    {
+      type: 'title',
+      text: 'Common Myths About Percentage Calculations',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'We often get stuck when we see large percentages or decimals, but there are some math "tricks" that can make your life easier. The most famous is <strong>percentage reversibility</strong>.',
+    },
+    {
+      type: 'tip',
+      title: 'The Reversibility Trick',
+      html: '<p>Did you know that X% of Y equals Y% of X exactly? For example, if you\'re asked to calculate 18% of 50 in your head, it sounds complicated. But flip it around—50% of 18 is easy: it\'s 9! This works for absolutely any numbers and is an amazing lifesaver in daily calculations.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Why We Fail at Calculating Growth',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'One of the most common mistakes happens in Case 3: percentage increase or decrease. Imagine a stock costs $100, drops 50%, and then rises 50% the next day. Your intuition says it\'s back to $100, but it\'s not.',
+    },
+    {
+      type: 'paragraph',
+      html: 'If it drops 50% from $100, the new value is $50. If it then rises 50% from that $50, the gain is half of $50 (which is $25). So the final price is $75. This classic example shows why percentage increases and decreases aren\'t symmetrical, and why dynamic calculators like this prevent serious financial mistakes.',
+    },
+    {
+      type: 'title',
+      text: 'Professional and Academic Use',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Our interface is distraction-free and designed to <strong>work fast</strong>. Pin it as a browser tab, quickly tab between fields, and use the copy button next to results to transfer exact figures to Excel or Google Sheets without typo risk.',
+    },
+    {
+      type: 'list',
+      items: [
+        'E-commerce and retail stores: Quick calculation of retail prices by applying profit margins and sales tax.',
+        'Human resources: Determining wage gaps, tax withholdings, and salary increases tied to inflation.',
+        'Higher education: Teachers grading curves or STEM students analyzing experimental deviation.',
+        'Digital marketing: Measuring CTR (Click Through Rate), ROAS (Return on Ad Spend), or eCommerce conversion rates.',
+      ],
+    },
+  ],
+  ui: {
+    labelTitle: 'Percentage Calculator',
+    labelCase1Title: 'Case 1',
+    labelCase1Question: 'What is X% of Y?',
+    labelCase1Placeholder1: 'X',
+    labelCase1Placeholder2: 'Y',
+    labelCase1Formula: 'Formula: (X / 100) × Y',
+    labelCase2Title: 'Case 2',
+    labelCase2Question: 'What percentage is X of Y?',
+    labelCase2Placeholder1: 'X',
+    labelCase2Placeholder2: 'Y',
+    labelCase2Formula: 'Formula: (X / Y) × 100',
+    labelCase3Title: 'Case 3',
+    labelCase3Question: 'Percentage difference between two values',
+    labelCase3Placeholder1: 'Value 1',
+    labelCase3Placeholder2: 'Value 2',
+    labelCase3Formula: 'Formula: ((Value 2 - Value 1) / |Value 1|) × 100',
+    labelCase4Title: 'Case 4',
+    labelCase4Question: 'Add or subtract a percentage to a value',
+    labelCase4Placeholder1: 'Value',
+    labelCase4Placeholder2: '%',
+    labelCase4Formula: 'Formula: Value ± (Value × (% / 100))',
+    labelCase4AddLabel: 'Add (Value + %)',
+    labelCase4SubtractLabel: 'Subtract (Value - %)',
+    labelResult: 'Result',
+    labelDifference: 'Difference',
+    labelCopyTooltip: 'Copy result',
+    labelFormula: 'Formula',
+    percentSymbol: '%',
+  },
+};

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

@@ -0,0 +1,233 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PercentageCalculatorUI } from '../ui';
+
+const slug = 'calculadora-porcentajes';
+const title = 'Calculadora de Porcentajes 4 en 1: Descuentos, Subidas y Rebajas';
+const description =
+  'Calcula fácilmente porcentajes online gratis. 4 herramientas en 1 para sacar el X% de Y, diferencia porcentual, sumar o restar IVA, rebajas y propinas automáticas.';
+
+const faqData = [
+  {
+    question: '¿Cómo funciona la calculadora?',
+    answer:
+      'Simplemente escribe los valores en los cuadros del caso de uso correspondiente a tu problema y nuestra calculadora procesa la fórmula sin necesidad de apretar ningún botón de calcular.',
+  },
+  {
+    question: '¿Es válida para calcular el IVA o impuestos?',
+    answer:
+      'Sí, el bloque 4 (\'Sumar o restar porcentaje\') está diseñado precisamente para casos como aplicar un IVA del 21% a un precio base o calcular un IRPF negativo.',
+  },
+  {
+    question: '¿Maneja números decimales y negativos?',
+    answer:
+      'Por supuesto. Puedes introducir números decimales (utilizando punto) y también funcionará con valores negativos si necesitas analizar balances contables en pérdidas.',
+  },
+  {
+    question: '¿Puedo copiar los resultados?',
+    answer:
+      'Sí, cada bloque cuenta con un botón en el recuadro del resultado que copia instantáneamente la cifra al portapapeles de tu dispositivo para poder pegarla en otra app o documento.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Identifica tu problema matemático',
+    text: 'Lee los títulos de los 4 bloques y elige el que coincida con lo que quieres saber (Ej. ¿Cuánto es el 20% de 50? -> Bloque 1).',
+  },
+  {
+    name: 'Introduce las cifras',
+    text: 'Rellena los campos \'X\' e \'Y\'. No te preocupes por el orden, la frase de cada bloque te guía visualmente.',
+  },
+  {
+    name: 'Copia el resultado instantáneo',
+    text: 'La cifra aparecerá en tiempo real abajo a medida que escribes. Pulsa el icono de copiar si deseas llevártelo a otra parte.',
+  },
+];
+
+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<PercentageCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Fuentes y Referencias',
+  bibliography: [
+    {
+      name: 'Cálculo de Porcentajes - Wikipedia',
+      url: 'https://es.wikipedia.org/wiki/Porcentaje',
+    },
+    {
+      name: 'Conceptos Matemáticos Básicos - Khan Academy',
+      url: 'https://es.khanacademy.org/math/pre-algebra/pre-algebra-ratios-rates/pre-algebra-percents/v/describing-the-meaning-of-percent',
+    },
+    {
+      name: 'Guía de la AEAT para tipos impositivos en España (IVA)',
+      url: 'https://sede.agenciatributaria.gob.es/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Calculadora de Porcentajes 4 en 1: Domina los Cálculos Rápidos',
+      level: 2,
+    },
+    {
+      type: 'title',
+      text: '¿Para qué sirve una calculadora de porcentajes múltiple?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Calcular porcentajes es una de las operaciones matemáticas más comunes en nuestro día a día. Desde calcular el descuento en unas rebajas, conocer la propina adecuada en un restaurante, hasta determinar el margen de beneficio en un negocio o el interés de un préstamo. A pesar de ser operaciones cotidianas, no siempre es fácil realizarlas mentalmente o recordar la fórmula exacta.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Nuestra calculadora de porcentajes 4 en 1 agrupa los escenarios más demandados. Ya no necesitas buscar en Google "cómo sacar el 20 por ciento" o "fórmula para cálculo de porcentaje". Tienes las cuatro operaciones esenciales en un solo lugar, de forma interactiva y con resultados instantáneos.',
+    },
+    {
+      type: 'title',
+      text: 'Revisando los 4 casos de uso más habituales',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Para facilitarte la vida, hemos separado la herramienta en cuatro bloques visuales claros que resuelven los problemas reales a los que nos enfrentamos a diario:',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:percent',
+      title: '1. ¿Cuánto es el X% de Y?',
+      html: '<p><strong>El caso clásico.</strong> Útil para calcular descuentos o propinas. Si quieres saber cuánto es el 15% de 120€, esta es tu herramienta. La fórmula subyacente simplemente divide el porcentaje entre 100 y lo multiplica por el valor total.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:division',
+      title: '2. ¿Qué porcentaje es X de Y?',
+      html: '<p><strong>Ideal para proporciones.</strong> Si has sacado 45 puntos en un examen de 60, ¿qué nota tienes sobre 100? Esta función divide la parte entre el total y lo multiplica por cien, dándote el peso relativo exacto.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:chart-line-variant',
+      title: '3. Aumento o Disminución Porcentual',
+      html: '<p><strong>Perfecto para finanzas y analítica.</strong> ¿Cuánto ha subido el alquiler desde el año pasado? Si antes pagabas 800€ y ahora 840€, esta función te dirá que has sufrido un aumento del 5%. Mide el crecimiento o decrecimiento entre dos cifras.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:calculator',
+      title: '4. Sumar o Restar porcentaje a un valor',
+      html: '<p><strong>Súper útil para el IVA.</strong> Si tienes un precio base (ej. 100€) y necesitas añadirle el 21% de IVA, esta calculadora te dará directamente los 121€ finales sin tener que hacer operaciones intermedias. De igual forma, sirve para aplicar un descuento directo (ej. restar un 20%).</p>',
+    },
+    {
+      type: 'title',
+      text: 'Mitos comunes sobre el cálculo de porcentajes',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'A menudo nos bloqueamos al ver porcentajes grandes o decimales, pero hay algunos "trucos" matemáticos que pueden hacerte la vida más fácil. El más famoso es la <strong>reversibilidad de los porcentajes</strong>.',
+    },
+    {
+      type: 'tip',
+      title: 'El truco de la reversibilidad',
+      html: '<p>¿Sabías que el X% de Y es exactamente igual al Y% de X? Por ejemplo, si te piden calcular el 18% de 50 mentalmente, puede sonar complicado. Pero si lo inviertes, el 50% de 18 es muy fácil: ¡es 9! Esto aplica para absolutamente cualquier número y es un salvavidas asombroso en el día a día.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Por qué fallamos al calcular crecimientos',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Uno de los errores más comunes ocurre en el caso 3: el aumento o disminución porcentual. Imaginemos que una acción en bolsa cuesta 100€, baja un 50% y al día siguiente sube un 50%. La intuición nos dice que vuelve a valer 100€, pero es incorrecto.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Si baja un 50% desde 100€, su nuevo valor es 50€. Si desde esos 50€ sube un 50%, el incremento es la mitad de 50 (25€). Por tanto, el precio final sería 75€. Este es un ejemplo clásico de por qué las subidas y bajadas porcentuales no son asimétricas y por qué calculadoras dinámicas como esta previenen errores financieros graves.',
+    },
+    {
+      type: 'title',
+      text: 'Uso profesional y académico',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Nuestra interfaz está libre de distracciones y diseñada para <strong>trabajar rápido</strong>. Puedes tenerla en una pestaña fijada del navegador, tabular ágilmente entre los distintos campos y, gracias al botón de copiar junto al resultado, trasladar el dato exacto a tu Excel o Google Sheets sin riesgo de errores de tipografía.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Comercio web y tiendas físicas: Cálculo rápido de PVP aplicando márgenes comerciales y sumando el IVA.',
+        'Gestión de recursos humanos: Determinación de la brecha salarial, retenciones de IRPF y subidas de sueldo referenciadas al IPC.',
+        'Educación universitaria: Profesores que nivelan calificaciones o estudiantes de ramas científicas analizando la desviación de sus experimentos.',
+        'Marketing digital: Medición del CTR (Click Through Rate), ROAS (Retorno del Gasto Publicitario) o Conversion Rate en eCommerce.',
+      ],
+    },
+  ],
+  ui: {
+    labelTitle: 'Calculadora de Porcentajes',
+    labelCase1Title: 'Caso 1',
+    labelCase1Question: 'Cuánto es el X% de Y?',
+    labelCase1Placeholder1: 'X',
+    labelCase1Placeholder2: 'Y',
+    labelCase1Formula: 'Fórmula: (X / 100) × Y',
+    labelCase2Title: 'Caso 2',
+    labelCase2Question: 'Qué porcentaje es X de Y?',
+    labelCase2Placeholder1: 'X',
+    labelCase2Placeholder2: 'Y',
+    labelCase2Formula: 'Fórmula: (X / Y) × 100',
+    labelCase3Title: 'Caso 3',
+    labelCase3Question: 'Diferencia porcentual entre dos valores',
+    labelCase3Placeholder1: 'Valor 1',
+    labelCase3Placeholder2: 'Valor 2',
+    labelCase3Formula: 'Fórmula: ((Valor 2 - Valor 1) / |Valor 1|) × 100',
+    labelCase4Title: 'Caso 4',
+    labelCase4Question: 'Sumar o restar porcentaje a un valor',
+    labelCase4Placeholder1: 'Valor',
+    labelCase4Placeholder2: '%',
+    labelCase4Formula: 'Fórmula: Valor ± (Valor × (% / 100))',
+    labelCase4AddLabel: 'Suma (Valor + %)',
+    labelCase4SubtractLabel: 'Resta (Valor - %)',
+    labelResult: 'Resultado',
+    labelDifference: 'Diferencia',
+    labelCopyTooltip: 'Copiar resultado',
+    labelFormula: 'Fórmula',
+    percentSymbol: '%',
+  },
+};