@jjlmoya/utils-diy 1.1.0

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

@@ -0,0 +1,178 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PassepartoutCalculatorUI } from '../ui';
+
+const slug = 'passepartout-calculator';
+const title = 'Passepartout Calculator: Mat Board Margins with Optical Center Correction';
+const description =
+  'Calculate exact mat board margins for professional picture framing with bottom weighting optical correction. Gallery-quality proportions for photos and artwork.';
+
+const faqData = [
+  {
+    question: 'What is bottom weighting in picture framing?',
+    answer:
+      "Bottom weighting is a professional framing technique where the bottom margin is made slightly wider than the top. This corrects an optical illusion: when a piece is framed with perfectly equal margins, the artwork appears to 'sink' visually. The extra bottom margin lifts the piece optically so it appears perfectly centered.",
+  },
+  {
+    question: 'What mat board material should I use for conservation framing?',
+    answer:
+      'Always use acid-free or pH-neutral mat board (alpha-cellulose or cotton rag). Cheap wood-pulp boards contain lignin which releases acids over time, causing yellowing and foxing that permanently damages artwork. Look for "Museum Quality" or "Conservation Grade" labels.',
+  },
+  {
+    question: 'How do I choose the mat board color?',
+    answer:
+      'Off-white or soft cream are the safe professional standards — they do not compete with the artwork. A dark mat can emphasize highlights in photography. Colored mats should be used carefully and only to complement specific tones in the piece, never to overpower it.',
+  },
+  {
+    question: 'What is the ideal mat margin width?',
+    answer:
+      "The professional standard is between 5 and 8 cm (2-3 inches). A margin that is too narrow makes the artwork feel 'suffocated'. A wider margin gives even small pieces a heroic, gallery-like presence.",
+  },
+];
+
+const howToData = [
+  {
+    name: 'Measure the artwork',
+    text: 'Measure the exact width and height of the paper or canvas you are framing. Subtract a few millimetres if you want the mat to overlap the image slightly.',
+  },
+  {
+    name: 'Measure the frame interior',
+    text: 'Take the internal dimensions of the frame or rebate where the mat board will sit.',
+  },
+  {
+    name: 'Enable optical correction',
+    text: 'Check the bottom weighting option in the calculator if you want the bottom margin to be automatically wider for a professional finish.',
+  },
+  {
+    name: 'Cut the mat board',
+    text: 'Use the resulting measurements to cut the window and exterior of the mat, ideally with a 45-degree bevel cutter for a clean chamfered edge.',
+  },
+];
+
+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<HowToThing> = {
+  '@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: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<PassepartoutCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Technical References',
+  bibliography: [
+    {
+      name: 'ISO 9706: Permanence of Paper for Documents',
+      url: 'https://www.iso.org/standard/22495.html',
+    },
+    {
+      name: 'PPFA: Professional Picture Framers Association',
+      url: 'https://ppfa.com/',
+    },
+    {
+      name: 'Fine Art Trade Guild: Framing Standards',
+      url: 'https://www.fineart.co.uk/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'The Science of Perfect Picture Framing',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'A <strong>passepartout</strong> (or mat board) is not merely decorative cardboard — it is the breathing space that allows your artwork to exist independently from its frame. This calculator gives you the exact dimensions to cut your mat, ensuring the artwork is optically centred or balanced within the frame to professional gallery standards.',
+    },
+    {
+      type: 'title',
+      text: 'Why Bottom Weighting Works',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:eye-outline',
+      title: 'The optical center illusion',
+      html: '<p>The human eye perceives the geometric vertical center of a rectangle as being slightly lower than it actually is. Artwork framed with perfectly equal top and bottom margins appears to be "falling" or sinking.</p><p><strong>Bottom weighting</strong> corrects this by making the bottom margin 5-15% wider than the top. The artwork is lifted optically and appears perfectly centered — a technique used in every professional gallery worldwide.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Conservation Mat Board: Why Materials Matter',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:palette-swatch-outline',
+      title: 'Conservation board versus standard mat board',
+      html: '<p>Standard wood-pulp mat boards contain lignin, which breaks down over time releasing acetic acid. This causes the characteristic brown foxing and yellowing that permanently destroys artwork. <strong>Conservation-grade mat board</strong> (alpha-cellulose or cotton rag) is pH-neutral and buffers against external acids, protecting artwork for decades.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Professional Measuring Tips',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Measure the rebate, not the face:</strong> If you already have the frame, measure the inner rebate from the back, not the front glass opening. The mat must fit the rebate precisely.',
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>The safety overlap:</strong> The mat window should be slightly smaller than the artwork (approximately 5mm per side) so the image cannot slip through the opening.',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:ruler',
+      title: 'The golden rule of matting',
+      html: '<p>Never use less than 5cm (2 inches) of margin if you want the artwork to breathe. Generous margins signal quality and elevate even modest pieces to gallery status. A wide white mat transforms a small watercolour into a museum exhibit.</p>',
+    },
+  ],
+  ui: {
+    sectionTitle: 'Dimensions',
+    sectionDesc: 'Enter measurements in centimetres.',
+    frameSizeTitle: 'Frame Size',
+    artSizeTitle: 'Artwork Size',
+    labelWidth: 'Width (cm)',
+    labelHeight: 'Height (cm)',
+    labelBottomWeighting: 'Bottom Weighting',
+    descBottomWeighting: 'Adds extra bottom margin for visual balance',
+    labelOffset: 'Offset (%)',
+    errorMsg: 'Artwork dimensions must be smaller than the frame.',
+    labelTop: 'Top',
+    labelBottom: 'Bottom',
+    labelLeft: 'Left',
+    labelRight: 'Right',
+    artPlaceholder: 'Your Artwork',
+  },
+};

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

@@ -0,0 +1,178 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PassepartoutCalculatorUI } from '../ui';
+
+const slug = 'calculadora-passepartout';
+const title = 'Calculadora Passepartout: Márgenes con Corrección Óptica para Enmarcado';
+const description =
+  'Herramienta para calcular márgenes de passepartout con corrección óptica (bottom weighting). Enmarca tus fotografías y arte con proporciones de galería.';
+
+const faqData = [
+  {
+    question: '¿Qué es la corrección de centro óptico (Bottom Weighting)?',
+    answer:
+      "Es un principio de diseño gráfico y enmarcado donde el margen inferior se hace ligeramente más ancho que los demás. Esto corrige la ilusión óptica que hace que el centro geométrico parezca estar 'caído' cuando se mira una obra colgada.",
+  },
+  {
+    question: '¿De qué material debe ser el passepartout?',
+    answer:
+      'Para conservación artística, debe ser cartón libre de ácido o de pH neutro (alfa-celulosa o algodón). Los cartones baratos amarillean con el tiempo y pueden dañar la obra debido a la lignina.',
+  },
+  {
+    question: '¿Cómo elijo el color del margen?',
+    answer:
+      'El blanco roto o crema suave son los estándares que no distraen de la obra. Un margen oscuro puede resaltar los blancos de una fotografía, mientras que un margen de color debe usarse con cuidado para no competir con los tonos de la pieza.',
+  },
+  {
+    question: '¿Cuál es el ancho de margen ideal?',
+    answer:
+      'Un estándar profesional es entre 5 y 8 cm. Si el margen es demasiado estrecho, la obra parece "asfixiada". Si es muy ancho, puede dar un aire heroico y minimalista a obras pequeñas.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Medir la obra de arte',
+    text: 'Mide el ancho y alto exacto del papel o lienzo que vas a enmarcar. Descuenta unos milímetros si quieres que el passepartout monte un poco sobre la imagen.',
+  },
+  {
+    name: 'Medir el interior del marco',
+    text: 'Toma las dimensiones internas del marco o rebaje donde encajará el cartón del passepartout.',
+  },
+  {
+    name: 'Activar corrección óptica',
+    text: 'Marca la opción en nuestra calculadora si quieres que el margen inferior sea automáticamente mayor para un acabado profesional.',
+  },
+  {
+    name: 'Cortar el cartón',
+    text: 'Usa las medidas resultantes para cortar el hueco (ventana) y el exterior del cartón, preferiblemente con un cúter de 45 grados para un bisel limpio.',
+  },
+];
+
+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<HowToThing> = {
+  '@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: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<PassepartoutCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias Técnicas',
+  bibliography: [
+    {
+      name: 'ISO 9706: Papel permanente para documentos',
+      url: 'https://www.iso.org/standard/22495.html',
+    },
+    {
+      name: 'PPFA: Professional Picture Framers Association',
+      url: 'https://ppfa.com/',
+    },
+    {
+      name: 'Fine Art Trade Guild: Framing Standards',
+      url: 'https://www.fineart.co.uk/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'La Ciencia del Enmarcado Perfecto',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Un <strong>Passepartout</strong> (o marialuisa) no es solo un cartón decorativo; es el pulmón que permite respirar a tu obra de arte. Esta calculadora te ayuda a determinar las dimensiones exactas para cortar tu cartón, asegurando que la obra quede perfectamente centrada o equilibrada ópticamente dentro del marco.',
+    },
+    {
+      type: 'title',
+      text: '¿Por qué el "Peso Inferior" o Bottom Weighting?',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:eye-outline',
+      title: 'La ilusión óptica del centro geométrico',
+      html: '<p>El ojo humano tiende a percibir el centro vertical geométrico como si estuviera ligeramente más bajo de lo que realmente está. Si enmarcas una obra exactamente en el centro, parecerá que se está "cayendo".</p><p>El <strong>Bottom Weighting</strong> (peso inferior) corrige esta ilusión óptica dejando un margen inferior ligeramente mayor, elevando la obra visualmente para que parezca perfectamente centrada.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Materiales de Conservación para Passepartout',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:palette-swatch-outline',
+      title: 'El cartón sin ácido para conservación',
+      html: '<p>Al elegir tu cartón, busca siempre términos como <strong>"Acid-Free"</strong> (libre de ácido) o <strong>"Museum Quality"</strong>. Los cartones baratos de pulpa de madera pueden amarillear con el tiempo y liberar ácidos que quemarán tu obra de arte (foxing), arruinándola irreversiblemente.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Consejos de Medición Profesional',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>Mide la Ventana, no el Exterior:</strong> Si ya tienes el marco, mide el hueco interior (el "rebajo") por la parte trasera, no por el frente del cristal.',
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>La Solapa de Seguridad:</strong> La ventana del passepartout debe ser un poco más pequeña que la obra (aprox. 5mm por lado) para que la imagen no se "cuele" por el agujero.',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:ruler',
+      title: 'Regla de Oro del enmarcado',
+      html: '<p>Nunca dejes menos de 5cm de margen si quieres que la obra respire. Los márgenes generosos denotan elegancia y valor. Un margen ancho convierte una pequeña acuarela en una pieza de museo.</p>',
+    },
+  ],
+  ui: {
+    sectionTitle: 'Dimensiones',
+    sectionDesc: 'Introduce las medidas en centímetros.',
+    frameSizeTitle: 'Tamaño del Marco',
+    artSizeTitle: 'Tamaño de la Obra',
+    labelWidth: 'Ancho (cm)',
+    labelHeight: 'Alto (cm)',
+    labelBottomWeighting: 'Bottom Weighting',
+    descBottomWeighting: 'Aplica más margen inferior para equilibrio visual',
+    labelOffset: 'Desplazamiento (%)',
+    errorMsg: 'El tamaño de la obra debe ser menor que el marco.',
+    labelTop: 'Superior',
+    labelBottom: 'Inferior',
+    labelLeft: 'Izq',
+    labelRight: 'Der',
+    artPlaceholder: 'Tu Obra',
+  },
+};

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

@@ -0,0 +1,178 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { PassepartoutCalculatorUI } from '../ui';
+
+const slug = 'calculateur-passe-partout';
+const title = 'Calculateur Passepartout: Marges avec Correction Optique pour Encadrement';
+const description =
+  "Calculez les marges exactes de passe-partout avec correction optique (pondération basse). Proportions galerie pour l'encadrement professionnel de photos et oeuvres d'art.";
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que la pondération basse (Bottom Weighting) en encadrement?',
+    answer:
+      "La pondération basse est une technique professionnelle d'encadrement où la marge inférieure est légèrement plus large que la marge supérieure. Elle corrige une illusion d'optique: lorsqu'une oeuvre est encadrée avec des marges parfaitement égales, elle semble visuellement 'tomber'. La marge inférieure plus large compense cet effet et donne l'impression d'un centrage parfait.",
+  },
+  {
+    question: 'Quel carton choisir pour un passe-partout de conservation?',
+    answer:
+      "Utilisez toujours un carton sans acide ou à pH neutre (alpha-cellulose ou chiffon de coton). Les cartons bon marché à base de pâte de bois contiennent de la lignine qui libère des acides avec le temps, provoquant le jaunissement et les piqûres (foxing) qui endommagent irrémédiablement l'oeuvre. Cherchez les mentions \"Acid-Free\" ou \"Museum Quality\".",
+  },
+  {
+    question: 'Comment choisir la couleur du passe-partout?',
+    answer:
+      "Le blanc cassé ou le crème doux sont les standards professionnels qui ne concurrencent pas l'oeuvre. Un passe-partout sombre peut mettre en valeur les blancs d'une photographie. Un passe-partout coloré doit être utilisé avec parcimonie pour complémenter les tons de la pièce sans les dominer.",
+  },
+  {
+    question: 'Quelle est la largeur de marge idéale?',
+    answer:
+      "Le standard professionnel est entre 5 et 8 cm. Une marge trop étroite donne une impression d'étouffement. Une marge plus large donne même aux petits formats une présence monumentale et élégante.",
+  },
+];
+
+const howToData = [
+  {
+    name: "Mesurer l'oeuvre",
+    text: "Mesurez la largeur et la hauteur exactes du papier ou de la toile à encadrer. Soustrayez quelques millimètres si vous souhaitez que le passe-partout chevauche légèrement l'image.",
+  },
+  {
+    name: 'Mesurer le feuillure du cadre',
+    text: "Prenez les dimensions internes de la feuillure du cadre où le carton du passe-partout viendra s'insérer.",
+  },
+  {
+    name: 'Activer la correction optique',
+    text: "Cochez l'option dans notre calculateur si vous souhaitez que la marge inférieure soit automatiquement plus large pour un rendu professionnel.",
+  },
+  {
+    name: 'Couper le carton',
+    text: "Utilisez les mesures obtenues pour découper la fenêtre et l'extérieur du carton, idéalement avec un cutter biseau 45 degrés pour un chanfrein net.",
+  },
+];
+
+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<HowToThing> = {
+  '@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: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<PassepartoutCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Références Techniques',
+  bibliography: [
+    {
+      name: 'ISO 9706: Permanence du papier pour documents',
+      url: 'https://www.iso.org/standard/22495.html',
+    },
+    {
+      name: 'PPFA: Professional Picture Framers Association',
+      url: 'https://ppfa.com/',
+    },
+    {
+      name: 'Fine Art Trade Guild: Normes d\'encadrement',
+      url: 'https://www.fineart.co.uk/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: "La Science de l'Encadrement Parfait",
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: "Un <strong>passe-partout</strong> (ou marie-louise) n'est pas qu'un carton décoratif: c'est l'espace respiratoire qui permet à votre oeuvre d'exister indépendamment de son cadre. Ce calculateur vous donne les dimensions exactes pour découper votre carton, garantissant que l'oeuvre soit centrée optiquement selon les standards des galeries professionnelles.",
+    },
+    {
+      type: 'title',
+      text: 'Pourquoi la Pondération Basse fonctionne',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:eye-outline',
+      title: "L'illusion du centre optique",
+      html: "<p>L'oeil humain perçoit le centre géométrique vertical d'un rectangle comme étant légèrement plus bas qu'il ne l'est réellement. Une oeuvre encadrée avec des marges exactement égales semble 'tomber' ou s'enfoncer visuellement.</p><p>La <strong>pondération basse</strong> corrige cela en rendant la marge inférieure 5 à 15% plus large que la supérieure. L'oeuvre est rehaussée optiquement et semble parfaitement centrée, une technique utilisée dans toutes les galeries professionnelles.</p>",
+    },
+    {
+      type: 'title',
+      text: 'Le Carton de Conservation: Pourquoi les Matériaux Comptent',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:palette-swatch-outline',
+      title: 'Carton sans acide contre carton standard',
+      html: "<p>Les cartons à base de pâte de bois contiennent de la lignine qui se dégrade en libérant de l'acide acétique. Cela provoque le jaunissement et les piqûres (foxing) caractéristiques qui détruisent définitivement les oeuvres. Le <strong>carton de conservation</strong> (alpha-cellulose ou chiffon de coton) est à pH neutre et protège l'oeuvre pendant des décennies.</p>",
+    },
+    {
+      type: 'title',
+      text: 'Conseils de Mesure Professionnels',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: "<strong>Mesurez la feuillure, pas la face:</strong> Si vous avez déjà le cadre, mesurez la feuillure intérieure par l'arrière, pas l'ouverture du verre par l'avant. Le carton doit s'insérer précisément dans la feuillure.",
+    },
+    {
+      type: 'paragraph',
+      html: "<strong>Le chevauchement de sécurité:</strong> La fenêtre du passe-partout doit être légèrement plus petite que l'oeuvre (environ 5mm par côté) pour que l'image ne puisse pas glisser par l'ouverture.",
+    },
+    {
+      type: 'card',
+      icon: 'mdi:ruler',
+      title: "La règle d'or de l'encadrement",
+      html: "<p>Ne jamais laisser moins de 5cm de marge si vous voulez que l'oeuvre respire. Des marges généreuses signalent la qualité et élèvent même les petits formats au rang d'oeuvres de musée.</p>",
+    },
+  ],
+  ui: {
+    sectionTitle: 'Dimensions',
+    sectionDesc: 'Entrez les mesures en centimètres.',
+    frameSizeTitle: 'Taille du Cadre',
+    artSizeTitle: "Taille de l'Oeuvre",
+    labelWidth: 'Largeur (cm)',
+    labelHeight: 'Hauteur (cm)',
+    labelBottomWeighting: 'Pondération Basse',
+    descBottomWeighting: 'Marge inférieure plus large pour équilibre visuel',
+    labelOffset: 'Décalage (%)',
+    errorMsg: "Les dimensions de l'oeuvre doivent être inférieures à celles du cadre.",
+    labelTop: 'Haut',
+    labelBottom: 'Bas',
+    labelLeft: 'G.',
+    labelRight: 'D.',
+    artPlaceholder: 'Votre Oeuvre',
+  },
+};

package/src/tool/passepartoutCalculator/index.ts

@@ -0,0 +1,28 @@
+import PassepartoutCalculatorComponent from './component.astro';
+import PassepartoutCalculatorSEO from './seo.astro';
+import PassepartoutCalculatorBibliography from './bibliography.astro';
+import type { DiyToolEntry, ToolDefinition } from '../../types';
+import type { PassepartoutCalculatorUI } from './ui';
+
+export {
+  PassepartoutCalculatorComponent,
+  PassepartoutCalculatorSEO,
+  PassepartoutCalculatorBibliography,
+};
+
+const es = async () => (await import('./i18n/es')).content;
+const en = async () => (await import('./i18n/en')).content;
+const fr = async () => (await import('./i18n/fr')).content;
+
+export const passepartoutCalculator: DiyToolEntry<PassepartoutCalculatorUI> = {
+  id: 'passepartout-calculator',
+  icons: { bg: 'mdi:image-frame', fg: 'mdi:ruler' },
+  i18n: { es, en, fr },
+};
+
+export const PASSEPARTOUT_CALCULATOR_TOOL: ToolDefinition = {
+  entry: passepartoutCalculator,
+  Component: PassepartoutCalculatorComponent,
+  SEOComponent: PassepartoutCalculatorSEO,
+  BibliographyComponent: PassepartoutCalculatorBibliography,
+};

package/src/tool/passepartoutCalculator/seo.astro

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

package/src/tool/passepartoutCalculator/ui.ts

@@ -0,0 +1,17 @@
+export interface PassepartoutCalculatorUI extends Record<string, string> {
+  sectionTitle: string;
+  sectionDesc: string;
+  frameSizeTitle: string;
+  artSizeTitle: string;
+  labelWidth: string;
+  labelHeight: string;
+  labelBottomWeighting: string;
+  descBottomWeighting: string;
+  labelOffset: string;
+  errorMsg: string;
+  labelTop: string;
+  labelBottom: string;
+  labelLeft: string;
+  labelRight: string;
+  artPlaceholder: string;
+}

package/src/tool/stairCalculator/bibliography.astro

@@ -0,0 +1,52 @@
+---
+---
+
+<div class="sc-bibliography">
+  <h3>Referencias y Normativa</h3>
+  <ul>
+    <li>
+      <a href="https://www.codigotecnico.org/" target="_blank" rel="noopener noreferrer">
+        Normativa de Seguridad en Escaleras (CTE España)
+      </a>
+    </li>
+    <li>
+      <a href="https://es.wikipedia.org/wiki/Escalera" target="_blank" rel="noopener noreferrer">
+        Ergonomía de la Escalera - Wikipedia
+      </a>
+    </li>
+    <li>
+      <a href="https://www.idae.es/" target="_blank" rel="noopener noreferrer">
+        Instituto para la Diversificación y Ahorro de la Energía (IDAE)
+      </a>
+    </li>
+  </ul>
+</div>
+
+<style>
+  .sc-bibliography {
+    max-width: 900px;
+    margin: 2rem auto;
+    padding: 1.5rem;
+  }
+  .sc-bibliography h3 {
+    font-size: 1.25rem;
+    font-weight: 700;
+    margin-bottom: 1rem;
+    color: #1e293b;
+  }
+  .sc-bibliography ul {
+    list-style: none;
+    padding: 0;
+  }
+  .sc-bibliography li {
+    margin-bottom: 0.75rem;
+  }
+  .sc-bibliography a {
+    color: #4f46e5;
+    text-decoration: none;
+    font-weight: 600;
+  }
+  .sc-bibliography a:hover {
+    text-decoration: underline;
+  }
+</style>