@jjlmoya/utils-tools 1.1.0

package/src/tool/rule-of-three/i18n/es.ts

@@ -0,0 +1,171 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { RuleOfThreeUI } from '../ui';
+
+const faqData = [
+  {
+    question: '¿Qué es la regla de tres simple directa?',
+    answer: "Es un método matemático para resolver problemas de proporcionalidad entre tres valores conocidos y uno desconocido. Se llama 'directa' porque cuando una magnitud aumenta, la otra también lo hace en la misma proporción.",
+  },
+  {
+    question: '¿Cuándo debo usar la regla de tres inversa?',
+    answer: 'Se utiliza cuando las magnitudes son inversamente proporcionales (si una aumenta, la otra disminuye). Por ejemplo: si 2 pintores tardan 5 horas, 4 pintores tardarán menos tiempo. Nuestra calculadora actual se centra en la proporcionalidad directa.',
+  },
+  {
+    question: '¿Es precisa para cálculos profesionales?',
+    answer: 'Sí. Nuestra calculadora utiliza precisión de punto flotante de alta fidelidad, ideal para ajustes de dosificación, escalas de diseño gráfico, presupuestos comerciales y conversiones de recetas de cocina.',
+  },
+  {
+    question: '¿Cómo se calcula manualmente?',
+    answer: 'La fórmula es: (Valor B * Valor C) / Valor A = X. Es decir, multiplicas los valores en diagonal y divides el resultado por el valor que queda solo.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Identificar la relación base',
+    text: 'Introduce los dos valores conocidos que forman la proporción inicial (ej. 100km equivalen a 8 litros).',
+  },
+  {
+    name: 'Introducir el tercer dato',
+    text: 'Escribe el nuevo valor del que quieres conocer su equivalente (ej. si voy a recorrer 250km...).',
+  },
+  {
+    name: 'Obtener el resultado',
+    text: 'El sistema calculará automáticamente el valor desconocido (X) en tiempo real sin necesidad de pulsar botones.',
+  },
+  {
+    name: 'Copiar o resetear',
+    text: 'Puedes copiar el resultado directamente al portapapeles o limpiar los campos para realizar un nuevo cálculo.',
+  },
+];
+
+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: 'Cómo usar la calculadora de regla de tres',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Calculadora de Regla de Tres Simple',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: 'Resuelve proporciones matemáticas al instante. La herramienta definitiva para calcular cantidades, recetas, descuentos y conversiones.',
+};
+
+const ui: RuleOfThreeUI = {
+  labelA: 'Si tengo...',
+  labelB: 'Equivale a...',
+  labelC: 'Y ahora tengo...',
+  labelX: 'Resultado (X)',
+  hintA: 'Cantidad inicial',
+  hintB: 'Valor conocido',
+  hintC: 'Nueva cantidad',
+  hintX: 'Valor calculado',
+  separatorIsTo: 'Es a',
+  separatorWillBe: 'Será a',
+  copyTitle: 'Copiar resultado',
+};
+
+export const content: ToolLocaleContent<RuleOfThreeUI> = {
+  slug: 'regla-de-tres',
+  title: 'Calculadora de Regla de Tres Simple',
+  description: 'Resuelve proporciones matemáticas al instante. La herramienta definitiva para calcular cantidades, recetas, descuentos y conversiones.',
+  ui,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Referencias',
+  bibliography: [
+    { name: 'Proporción (matemáticas) — Wikipedia', url: 'https://es.wikipedia.org/wiki/Proporci%C3%B3n_(matem%C3%A1ticas)' },
+    { name: 'Regla de tres — Khan Academy', url: 'https://es.khanacademy.org/math/pre-algebra/pre-algebra-ratios-rates/pre-algebra-ratios-intro/a/ratio-review' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '¿Para qué sirve la regla de tres?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La regla de tres simple directa es el "navaja suiza" de las matemáticas. Sirve para resolver problemas donde tres datos son conocidos y buscamos el cuarto. Si conoces la relación entre <strong>A y B</strong>, y tienes un nuevo valor <strong>C</strong>, la calculadora obtiene <strong>X</strong> al instante.',
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          icon: 'mdi:chef-hat',
+          title: 'Cocina y Recetas',
+          description: 'Si la receta pide 500g de harina para 4 personas, ¿cuánta necesito para 7?',
+          points: ['(500 × 7) ÷ 4 = 875g'],
+        },
+        {
+          icon: 'mdi:shopping',
+          title: 'Compras y Precios',
+          description: 'Si el pack de 3 latas cuesta 2.50€, ¿cuánto me costarían 10 latas?',
+          points: ['(2.50 × 10) ÷ 3 = 8.33€'],
+        },
+        {
+          icon: 'mdi:car',
+          title: 'Viajes y Distancia',
+          description: 'Si tardo 45 min en hacer 60km, ¿cuánto tardaré en hacer 140km?',
+          points: ['(45 × 140) ÷ 60 = 105 min'],
+        },
+        {
+          icon: 'mdi:monitor-screenshot',
+          title: 'Diseño y Pantallas',
+          description: 'Si la imagen mide 1920px de ancho y quiero reducirla a 800px manteniendo la proporción...',
+          points: ['(AltoOriginal × 800) ÷ 1920 = AltoNuevo'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: '¿Cómo funciona la fórmula?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La fórmula es siempre la misma: <strong>multiplica los cruzados y divide por el que sobra</strong>.',
+    },
+    {
+      type: 'code',
+      code: '(B × C) ÷ A = X',
+      ariaLabel: 'Fórmula de la regla de tres simple directa',
+    },
+    {
+      type: 'paragraph',
+      html: 'En la calculadora: multiplicamos el valor <strong>B</strong> por el valor <strong>C</strong> y dividimos entre <strong>A</strong>. El resultado es <strong>X</strong>.',
+    },
+    {
+      type: 'title',
+      text: 'Usos profesionales y cotidianos',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Más allá de las matemáticas escolares, la regla de tres está en todas partes: en farmacia para calcular dosificaciones por peso corporal, en fotografía para calcular tiempos de exposición, en finanzas para calcular variaciones porcentuales, o en imprenta para escalar medidas de formato.',
+    },
+    {
+      type: 'tip',
+      title: 'Truco de precisión',
+      html: 'El resultado se muestra con hasta 4 decimales significativos. Si trabajas con dinero o medidas exactas, recuerda redondear según el contexto: los euros a 2 decimales, los píxeles a enteros.',
+    },
+  ],
+};

package/src/tool/rule-of-three/i18n/fr.ts

@@ -0,0 +1,171 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { RuleOfThreeUI } from '../ui';
+
+const faqData = [
+  {
+    question: "Qu'est-ce que la règle de trois simple directe ?",
+    answer: "C'est une méthode mathématique pour résoudre des problèmes de proportionnalité entre trois valeurs connues et une inconnue. On l'appelle 'directe' parce que lorsqu'une grandeur augmente, l'autre augmente dans la même proportion.",
+  },
+  {
+    question: 'Quand dois-je utiliser la règle de trois inverse ?',
+    answer: "On l'utilise quand les grandeurs sont inversement proportionnelles (si l'une augmente, l'autre diminue). Par exemple : si 2 peintres mettent 5 heures, 4 peintres mettront moins de temps. Notre calculatrice actuelle se concentre sur la proportionnalité directe.",
+  },
+  {
+    question: 'Est-elle précise pour les calculs professionnels ?',
+    answer: "Oui. Notre calculatrice utilise une précision en virgule flottante haute fidélité, idéale pour les ajustements de dosage, les échelles de conception graphique, les budgets commerciaux et les conversions de recettes de cuisine.",
+  },
+  {
+    question: 'Comment se calcule-t-elle manuellement ?',
+    answer: 'La formule est : (Valeur B * Valeur C) / Valeur A = X. Autrement dit, vous multipliez les valeurs en diagonale et divisez le résultat par la valeur restante.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Identifier la relation de base',
+    text: "Saisissez les deux valeurs connues qui forment la proportion initiale (ex. 100km équivalent à 8 litres).",
+  },
+  {
+    name: 'Saisir la troisième valeur',
+    text: "Écrivez la nouvelle valeur dont vous souhaitez connaître l'équivalent (ex. si je vais parcourir 250km...).",
+  },
+  {
+    name: 'Obtenir le résultat',
+    text: "Le système calculera automatiquement la valeur inconnue (X) en temps réel sans avoir besoin d'appuyer sur des boutons.",
+  },
+  {
+    name: 'Copier ou réinitialiser',
+    text: "Vous pouvez copier le résultat directement dans le presse-papiers ou vider les champs pour effectuer un nouveau calcul.",
+  },
+];
+
+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: 'Comment utiliser la calculatrice de règle de trois',
+  step: howToData.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: 'Calculatrice de règle de trois simple',
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  description: "Résolvez des proportions mathématiques instantanément. L'outil définitif pour calculer des quantités, des recettes, des remises et des conversions.",
+};
+
+const ui: RuleOfThreeUI = {
+  labelA: "Si j'ai...",
+  labelB: 'Cela équivaut à...',
+  labelC: "Et maintenant j'ai...",
+  labelX: 'Résultat (X)',
+  hintA: 'Quantité initiale',
+  hintB: 'Valeur connue',
+  hintC: 'Nouvelle quantité',
+  hintX: 'Valeur calculée',
+  separatorIsTo: 'Est à',
+  separatorWillBe: 'Sera à',
+  copyTitle: 'Copier le résultat',
+};
+
+export const content: ToolLocaleContent<RuleOfThreeUI> = {
+  slug: 'regle-de-trois',
+  title: 'Calculatrice de règle de trois simple',
+  description: "Résolvez des proportions mathématiques instantanément. L'outil définitif pour calculer des quantités, des recettes, des remises et des conversions.",
+  ui,
+  faqTitle: 'Questions fréquentes',
+  faq: faqData,
+  howTo: howToData,
+  bibliographyTitle: 'Références',
+  bibliography: [
+    { name: 'Proportionnalité (mathématiques) — Wikipédia', url: 'https://fr.wikipedia.org/wiki/Proportionnalit%C3%A9' },
+    { name: 'Ratios et proportions — Khan Academy', url: 'https://fr.khanacademy.org/math/pre-algebra/pre-algebra-ratios-rates' },
+  ],
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'À quoi sert la règle de trois ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "La règle de trois simple directe est le « couteau suisse » des mathématiques. Elle permet de résoudre des problèmes où trois données sont connues et on cherche la quatrième. Si vous connaissez la relation entre <strong>A et B</strong>, et que vous avez une nouvelle valeur <strong>C</strong>, la calculatrice trouve <strong>X</strong> instantanément.",
+    },
+    {
+      type: 'comparative',
+      columns: 2,
+      items: [
+        {
+          icon: 'mdi:chef-hat',
+          title: 'Cuisine et recettes',
+          description: 'Si la recette demande 500g de farine pour 4 personnes, combien en faut-il pour 7 ?',
+          points: ['(500 × 7) ÷ 4 = 875g'],
+        },
+        {
+          icon: 'mdi:shopping',
+          title: 'Achats et prix',
+          description: 'Si un pack de 3 boîtes coûte 2,50€, combien me coûteraient 10 boîtes ?',
+          points: ['(2,50 × 10) ÷ 3 = 8,33€'],
+        },
+        {
+          icon: 'mdi:car',
+          title: 'Voyages et distances',
+          description: "Si je mets 45 min pour faire 60km, combien de temps me faudra-t-il pour faire 140km ?",
+          points: ['(45 × 140) ÷ 60 = 105 min'],
+        },
+        {
+          icon: 'mdi:monitor-screenshot',
+          title: 'Design et écrans',
+          description: "Si l'image mesure 1920px de large et je veux la réduire à 800px en conservant les proportions...",
+          points: ['(HauteurOriginale × 800) ÷ 1920 = NouvelleHauteur'],
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Comment fonctionne la formule ?',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'La formule est toujours la même : <strong>multiplier les valeurs en diagonale et diviser par celle qui reste</strong>.',
+    },
+    {
+      type: 'code',
+      code: '(B × C) ÷ A = X',
+      ariaLabel: 'Formule de la règle de trois simple directe',
+    },
+    {
+      type: 'paragraph',
+      html: 'Dans la calculatrice : on multiplie la valeur <strong>B</strong> par la valeur <strong>C</strong> et on divise par <strong>A</strong>. Le résultat est <strong>X</strong>.',
+    },
+    {
+      type: 'title',
+      text: 'Utilisations professionnelles et quotidiennes',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Au-delà des mathématiques scolaires, la règle de trois est partout : en pharmacie pour calculer les dosages selon le poids corporel, en photographie pour calculer les temps d'exposition, en finance pour calculer les variations en pourcentage, ou en imprimerie pour mettre à l'échelle les dimensions.",
+    },
+    {
+      type: 'tip',
+      title: 'Astuce de précision',
+      html: "Le résultat est affiché avec jusqu'à 4 décimales significatives. Si vous travaillez avec de l'argent ou des mesures exactes, pensez à arrondir selon le contexte : l'euro à 2 décimales, les pixels en entiers.",
+    },
+  ],
+};

package/src/tool/rule-of-three/index.ts

@@ -0,0 +1,22 @@
+import type { ToolDefinition, ToolsToolEntry } from '../../types';
+import type { RuleOfThreeUI } from './ui';
+import RuleOfThreeComponent from './component.astro';
+import RuleOfThreeSEO from './seo.astro';
+import RuleOfThreeBibliography from './bibliography.astro';
+
+export const ruleOfThree: ToolsToolEntry<RuleOfThreeUI> = {
+  id: 'rule-of-three',
+  icons: { bg: 'mdi:calculator-variant', fg: 'mdi:equal' },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+  },
+};
+
+export const RULE_OF_THREE_TOOL: ToolDefinition = {
+  entry: ruleOfThree,
+  Component: RuleOfThreeComponent,
+  SEOComponent: RuleOfThreeSEO,
+  BibliographyComponent: RuleOfThreeBibliography,
+};

package/src/tool/rule-of-three/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { ruleOfThree } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await ruleOfThree.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/rule-of-three/ui.ts

@@ -0,0 +1,13 @@
+export interface RuleOfThreeUI extends Record<string, string> {
+  labelA: string;
+  labelB: string;
+  labelC: string;
+  labelX: string;
+  hintA: string;
+  hintB: string;
+  hintC: string;
+  hintX: string;
+  separatorIsTo: string;
+  separatorWillBe: string;
+  copyTitle: string;
+}

package/src/tool/seo-content-optimizer/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { seoContentOptimizer } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await seoContentOptimizer.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}