@jjlmoya/utils-diy 1.1.0

package/src/tool/stairCalculator/engine.ts

@@ -0,0 +1,128 @@
+export interface StairCalculation {
+  riser: number;
+  tread: number;
+  angle: number;
+  realLength: number;
+  blondel: number;
+  blondelStatus: 'success' | 'warning' | 'error';
+  blondelTitleKey: string;
+  blondelMessageKey: string;
+  blondelMessageVal: number;
+  tableRows: TableRow[];
+  volume: number;
+  cement: number;
+  sand: number;
+  spacingWarningKey: string;
+}
+
+export interface TableRow {
+  step: number;
+  concreteHeight: number;
+  finishedHeight: number;
+  horizontalDistance: number;
+}
+
+/* eslint-disable max-lines-per-function, complexity, max-params */
+export function calculateStairs(
+  totalHeight: number,
+  availableLength: number,
+  numSteps: number,
+  slabThickness: number,
+  finishThickness: number,
+  ceilingHeight: number,
+  stairWidth: number,
+  cementFactor: number
+): StairCalculation {
+  if (totalHeight <= 0 || numSteps <= 0) {
+    return {
+      riser: 0,
+      tread: 0,
+      angle: 0,
+      realLength: 0,
+      blondel: 0,
+      blondelStatus: 'error',
+      blondelTitleKey: 'statusRiserError',
+      blondelMessageKey: 'msgInvalidValues',
+      blondelMessageVal: 0,
+      tableRows: [],
+      volume: 0,
+      cement: 0,
+      sand: 0,
+      spacingWarningKey: ''
+    };
+  }
+
+  const riser = totalHeight / numSteps;
+  const targetTread = 63 - (2 * riser);
+  const tread = availableLength > 0 ? (availableLength / (numSteps - 1)) : Math.max(24, targetTread);
+
+  const blondel = (2 * riser) + tread;
+  const realLength = tread * (numSteps - 1);
+
+  const angleRad = Math.atan(totalHeight / (realLength || 1));
+  const angle = angleRad * (180 / Math.PI);
+  const hypo = Math.sqrt(totalHeight ** 2 + realLength ** 2);
+
+  let spacingWarningKey = '';
+  let blondelStatus: 'success' | 'warning' | 'error' = 'warning';
+  let blondelTitleKey = 'statusMarginLimit';
+  let blondelMessageKey = 'msgBlondelValue';
+  let blondelMessageVal = blondel;
+
+  if (availableLength > 0 && tread < 24) {
+    spacingWarningKey = 'msgInsufficientSpace';
+    blondelStatus = 'error';
+    blondelTitleKey = 'statusRiserError';
+    blondelMessageKey = 'msgDangerousTread';
+    blondelMessageVal = tread;
+  } else if (blondel >= 62 && blondel <= 64.5) {
+    blondelStatus = 'success';
+    blondelTitleKey = 'statusOptimalComfort';
+    blondelMessageKey = 'msgOptimalStep';
+    blondelMessageVal = blondel;
+  } else {
+    const level = (riser > 19 || tread < 25) ? 'error' : 'warning';
+    blondelStatus = level as 'error' | 'warning';
+    blondelTitleKey = level === 'error' ? 'statusCriticalDesign' : 'statusMarginLimit';
+  }
+
+  if (ceilingHeight > 0) {
+    const minHead = ceilingHeight - totalHeight;
+    if (minHead < 200) spacingWarningKey = 'msgLowCeiling';
+  }
+
+  const tableRows: TableRow[] = [];
+  for (let i = 1; i <= numSteps; i++) {
+    const finishedHeight = i * riser;
+    let concreteHeight = finishedHeight;
+    if (i === 1) concreteHeight = riser - finishThickness;
+
+    const horizontalDistance = (i - 1) * tread;
+    tableRows.push({ step: i, concreteHeight, finishedHeight, horizontalDistance });
+  }
+
+  const volSteps = (tread * riser / 2) * stairWidth * numSteps / 1000000;
+  const volSlab = (hypo * slabThickness * stairWidth) / 1000000;
+  const totalVol = volSteps + volSlab;
+
+  const cement = Math.ceil(totalVol * cementFactor / 25);
+  const sand = Math.round(totalVol * 0.5 * 1000);
+
+  return {
+    riser,
+    tread,
+    angle: isFinite(angle) ? angle : 90,
+    realLength,
+    blondel,
+    blondelStatus,
+    blondelTitleKey,
+    blondelMessageKey,
+    blondelMessageVal,
+    tableRows,
+    volume: totalVol,
+    cement,
+    sand,
+    spacingWarningKey
+  };
+}
+/* eslint-enable max-lines-per-function, complexity, max-params */

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

@@ -0,0 +1,149 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { StairCalculatorUI } from '../ui';
+
+const slug = 'stair-calculator';
+const title = 'Stair Calculator: Design and Execution';
+const description = 'Calculate exact stair measurements: tread, riser, slope and materials. Apply Blondel\'s law and avoid construction errors.';
+
+const faqData = [
+  {
+    question: 'What is Blondel\'s law?',
+    answer: 'It is a formula that establishes that for a staircase to be comfortable, the sum of two risers and one tread should be between 62 and 64 cm (2R + T = 63). This law is based on average human step length and ensures that climbing or descending is safe and comfortable.',
+  },
+  {
+    question: 'What is the maximum height of a step?',
+    answer: 'In residential buildings, 18-19 cm is recommended. For public spaces, the maximum is typically 17.5 cm according to standards. Higher risers are tiring and potentially dangerous, especially for children and elderly people.',
+  },
+  {
+    question: 'How do I calculate if space is limited?',
+    answer: 'If horizontal space is limited, you must increase the number of steps (reducing riser height) or accept a steeper slope, though less comfortable. The calculator helps you find the optimal balance.',
+  },
+  {
+    question: 'What does concrete volume calculation include?',
+    answer: 'The total concrete volume is calculated considering the steps plus the inclined slab (the sloped plane supporting the steps). Ignoring this volume would result in insufficient concrete orders.',
+  },
+  {
+    question: 'Why is cumulative layout important?',
+    answer: 'Measuring each step separately generates cumulative errors. Cumulative layout ensures all steps have exactly the same height, avoiding hazards and improving usage comfort.',
+  },
+];
+
+const howToData = [
+  { name: 'Measure the height difference', text: 'Measure the total height difference (H) from finished floor to finished floor above. This is the fundamental value for the entire calculation.' },
+  { name: 'Enter available length', text: 'Optional: If you have space constraints, enter available horizontal length. Use 0 for free calculation without limits.' },
+  { name: 'Adjust number of steps', text: 'The calculator proposes an initial number, but you can adjust it. Watch the Blondel indicator: it should be green (62-64 cm) for maximum comfort.' },
+  { name: 'Define construction parameters', text: 'Specify slab thickness, finishes, concrete strength and stair width. These values affect final material calculations.' },
+];
+
+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<StairCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'References and Standards',
+  bibliography: [
+    { name: 'Building Code - Stair Design Standards', url: 'https://www.ibc.org/' },
+    { name: 'Blondel\'s Law - Wikipedia', url: 'https://en.wikipedia.org/wiki/Staircase' },
+    { name: 'ISO 12122-1: Building stairs - Performance requirements', url: 'https://www.iso.org/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Staircase Design Geometry: Blondel\'s Law', level: 2 },
+    { type: 'paragraph', html: 'The comfort of a staircase depends on human step length. When you climb or descend stairs, your body expects a predictable rhythm. Blondel\'s law establishes that 2 risers + 1 tread = 62-64 cm is the standard ensuring maximum comfort and safety.' },
+    { type: 'title', text: 'Structural Control and Materials', level: 3 },
+    { type: 'paragraph', html: 'For professional execution, it is vital to account for the concrete slab (the inclined plane supporting the steps). Ignoring this volume would result in insufficient concrete orders and defective construction. The calculator automatically integrates this calculation.' },
+    { type: 'title', text: 'Layout and Marking: Cumulative Error', level: 3 },
+    { type: 'paragraph', html: 'In construction, the greatest enemy is millimetre-level error. If you measure each step separately, the sum of small errors can leave the last step 5 cm higher or lower than the first. Cumulative layout prevents this problem.' },
+    { type: 'title', text: 'Final Finish Provisions', level: 3 },
+    { type: 'paragraph', html: 'A critical detail: are you installing 3 cm granite steps? This data is fundamental. If not properly accounted for, the first step will be 3 cm higher and the last 3 cm lower, creating a real safety hazard.' },
+  ],
+  ui: {
+    labelGeometry: 'Geometry and Opening',
+    labelTotalHeight: 'Total Height Difference (H)',
+    labelAvailableLength: 'Available Length (L)',
+    labelAvailableLengthHint: 'Use 0 for free calculation.',
+    labelNumSteps: 'Number of Steps',
+    labelOptimize: 'Optimize (18cm)',
+    labelWork: 'Construction Details',
+    labelSlabThickness: 'Slab (e)',
+    labelFinishThickness: 'Finish',
+    labelCeilingHeight: 'Ceiling Height (Optional)',
+    labelStairWidth: 'Stair Width',
+    labelConcreteStrength: 'Concrete Strength',
+    optionH150: 'H-150 (Lean)',
+    optionH200: 'H-200 (Residential)',
+    optionH250: 'H-250 (Structural)',
+    labelRiser: 'Riser',
+    labelTread: 'Tread',
+    labelSlope: 'Slope',
+    labelRealAdvance: 'Actual Run',
+    labelLayoutTable: 'Layout and Execution',
+    colStep: 'Step',
+    colConcreteHeight: 'Concrete Height',
+    colFinishedHeight: 'Finished Height',
+    colAdvance: 'Run',
+    adjustedNote: 'Adjusted',
+    labelMaterials: 'Material Estimate',
+    labelTotalConcrete: 'Total Concrete:',
+    labelCement: 'Cement (bags/25kg):',
+    labelSand: 'Sand Required:',
+    unitM3: 'm³',
+    unitBags: 'bags',
+    unitLiters: 'L',
+    btnShare: 'Share',
+    btnPrint: 'Print PDF',
+    statusOptimalComfort: 'Optimal Comfort',
+    statusMarginLimit: 'Margin Limit',
+    statusCriticalDesign: 'Critical Design',
+    statusRiserError: 'Tread Error',
+
+    msgInvalidValues: 'Invalid values',
+    msgInsufficientSpace: 'INSUFFICIENT SPACE',
+    msgDangerousTread: 'The {val}cm tread is dangerous.',
+    msgBlondelValue: 'Blondel: {val}cm.',
+    msgOptimalStep: 'Comfortable step: {val}cm.',
+    msgLowCeiling: 'LOW HEADROOM (<2m)',
+    msgCalculating: 'Calculating...',
+    msgEnterMeasurements: 'Enter measurements',
+
+    shareTitle: 'Construction Summary',
+    shareMessage: 'Stairs: H={h}cm, N={n}, CH={ch}cm, Vol={vol}m3',
+  },
+};

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

@@ -0,0 +1,149 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { StairCalculatorUI } from '../ui';
+
+const slug = 'calculadora-escaleras';
+const title = 'Calculadora de Escaleras: Diseño y Ejecución';
+const description = 'Calcula las medidas exactas de tu escalera: huella, contrahuella, ángulo y materiales. Respeta la Ley de Blondel y evita errores de obra.';
+
+const faqData = [
+  {
+    question: '¿Qué es la Ley de Blondel?',
+    answer: 'Es una fórmula que establece que para que una escalera sea cómoda, la suma de dos contrahuellas y una huella debe estar entre 62 y 64 cm (2CH + H = 63). Esta ley se basa en la longitud media del paso humano y garantiza que subir o bajar la escalera sea seguro y cómodo.',
+  },
+  {
+    question: '¿Cuál es la altura máxima de un peldaño?',
+    answer: 'En viviendas se recomienda no superar los 18-19 cm. Para espacios públicos, el máximo suele ser 17.5 cm según normativa. Contrahuellas mayores cansan más y pueden ser peligrosas, especialmente para niños y personas mayores.',
+  },
+  {
+    question: '¿Cómo calculo si tengo poco espacio?',
+    answer: 'Si el avance horizontal es limitado, deberás aumentar el número de peldaños (reduciendo la contrahuella) o aceptar una pendiente mayor, aunque sea menos cómoda. La calculadora te ayuda a encontrar el equilibrio óptimo.',
+  },
+  {
+    question: '¿Qué incluye la cubicación de hormigón?',
+    answer: 'Se calcula el volumen total de hormigón considerando los peldaños más la losa inclinada (el plano inclinado que soporta los escalones). Ignorar este volumen resultaría en un pedido de hormigón insuficiente.',
+  },
+  {
+    question: '¿Por qué es importante el replanteo acumulado?',
+    answer: 'Medir cada escalón por separado genera errores acumulados. El replanteo acumulado garantiza que todos los peldaños tengan exactamente la misma altura, evitando riesgos y mejorando la comodidad de uso.',
+  },
+];
+
+const howToData = [
+  { name: 'Medir el desnivel', text: 'Mide el desnivel total (H) desde el suelo terminado inferior al suelo terminado superior. Este es el dato fundamental para toda la calculadora.' },
+  { name: 'Introduce la longitud disponible', text: 'Opcional: Si tienes restricciones de espacio, introduce la longitud horizontal disponible. Usa 0 para cálculo libre sin limitaciones.' },
+  { name: 'Ajusta el número de peldaños', text: 'La calculadora propone un número inicial, pero puedes ajustarlo. Observa el indicador de Blondel: debe estar en verde (62-64 cm) para máxima comodidad.' },
+  { name: 'Define parámetros de obra', text: 'Especifica el espesor de la losa, acabados finales, resistencia del hormigón y ancho de la escalera. Estos datos afectan a la cubicación final.' },
+];
+
+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<StairCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Preguntas Frecuentes',
+  faq: faqData,
+  bibliographyTitle: 'Referencias y Normativa',
+  bibliography: [
+    { name: 'CTE DB SUA Seguridad de Utilización y Accesibilidad', url: 'https://www.codigotecnico.org/' },
+    { name: 'Ley de Blondel - Wikipedia', url: 'https://es.wikipedia.org/wiki/Escalera#Geometr%C3%ADa_de_la_escalera' },
+    { name: 'Instrucción para la Recepción de Cementos (RC-16)', url: 'https://www.fomento.gob.es/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Diseño Geométrico de Escaleras: La Ley de Blondel', level: 2 },
+    { type: 'paragraph', html: 'El confort de una escalera depende de la longitud del paso humano. Cuando subes o bajas escaleras, tu cuerpo espera un ritmo predecible. La Ley de Blondel establece que 2 contrahuellas + 1 huella = 62-64 cm es el estándar que garantiza máxima comodidad y seguridad.' },
+    { type: 'title', text: 'Control de Estructura y Materiales', level: 3 },
+    { type: 'paragraph', html: 'Para una ejecución profesional, es vital considerar la losa de hormigón (el plano inclinado que sostiene los escalones). Ignorar este volumen resultaría en un pedido de hormigón insuficiente y ejecución defectuosa. La calculadora integra automáticamente este cálculo.' },
+    { type: 'title', text: 'Replanteo y Trazado: El Error Acumulado', level: 3 },
+    { type: 'paragraph', html: 'En construcción, el mayor enemigo es el error milimétrico. Si mides cada escalón por separado, la suma de pequeños errores puede dejar el último peldaño 5 cm más alto o más bajo que el primero. El replanteo acumulado evita este problema.' },
+    { type: 'title', text: 'Previsión de Acabados Finales', level: 3 },
+    { type: 'paragraph', html: 'Un detalle crítico: ¿vas a instalar peldaños de granito de 3 cm? Este dato es fundamental. Si no se prevé correctamente, el primer peldaño quedará 3 cm más alto y el último 3 cm más bajo, creando un riesgo de seguridad real.' },
+  ],
+  ui: {
+    labelGeometry: 'Geometría y Hueco',
+    labelTotalHeight: 'Desnivel Total (H)',
+    labelAvailableLength: 'Longitud Disponible (L)',
+    labelAvailableLengthHint: 'Usa 0 para cálculo libre.',
+    labelNumSteps: 'Nº Peldaños',
+    labelOptimize: 'Optimizar (18cm)',
+    labelWork: 'Obra e Instalación',
+    labelSlabThickness: 'Losa (e)',
+    labelFinishThickness: 'Acabado',
+    labelCeilingHeight: 'Altura Techo (Opción)',
+    labelStairWidth: 'Ancho Escalera',
+    labelConcreteStrength: 'Resistencia Hormigón',
+    optionH150: 'H-150 (Limpieza)',
+    optionH200: 'H-200 (Vivienda)',
+    optionH250: 'H-250 (Estructural)',
+    labelRiser: 'Contrahuella',
+    labelTread: 'Huella',
+    labelSlope: 'Pendiente',
+    labelRealAdvance: 'Avance Real',
+    labelLayoutTable: 'Replanteo y Ejecución',
+    colStep: 'Peldaño',
+    colConcreteHeight: 'H. Hormigón',
+    colFinishedHeight: 'H. Terminada',
+    colAdvance: 'Avance',
+    adjustedNote: 'Ajustado',
+    labelMaterials: 'Cubicación y Pedido',
+    labelTotalConcrete: 'Hormigón Total:',
+    labelCement: 'Cemento (sacos/25kg):',
+    labelSand: 'Arena necesaria:',
+    unitM3: 'm³',
+    unitBags: 'sacos',
+    unitLiters: 'L',
+    btnShare: 'Compartir',
+    btnPrint: 'Imprimir PDF',
+    statusOptimalComfort: 'Confort Óptimo',
+    statusMarginLimit: 'Margen Límite',
+    statusCriticalDesign: 'Diseño Crítico',
+    statusRiserError: 'Error de Huella',
+
+    msgInvalidValues: 'Valores inválidos',
+    msgInsufficientSpace: 'ESPACIO INSUFICIENTE',
+    msgDangerousTread: 'La huella de {val}cm es peligrosa.',
+    msgBlondelValue: 'Blondel: {val}cm.',
+    msgOptimalStep: 'Paso cómodo: {val}cm.',
+    msgLowCeiling: 'CABECEO BAJO (<2m)',
+    msgCalculating: 'Calculando...',
+    msgEnterMeasurements: 'Ingresa medidas',
+
+    shareTitle: 'Resumen Obra',
+    shareMessage: 'Escalera: H={h}cm, N={n}, CH={ch}cm, Vol={vol}m3',
+  },
+};

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

@@ -0,0 +1,149 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { StairCalculatorUI } from '../ui';
+
+const slug = 'calculatrice-escaliers';
+const title = 'Calculatrice d\'Escaliers: Conception et Exécution';
+const description = 'Calculez les mesures exactes de votre escalier: giron, hauteur de marche, pente et matériaux. Appliquez la loi de Blondel et évitez les erreurs de construction.';
+
+const faqData = [
+  {
+    question: 'Qu\'est-ce que la Loi de Blondel?',
+    answer: 'C\'est une formule qui établit que pour qu\'un escalier soit confortable, la somme de deux hauteurs de marche et d\'un giron doit être entre 62 et 64 cm (2H + G = 63). Cette loi est basée sur la longueur moyenne du pas humain et garantit que la montée ou la descente est sûre et confortable.',
+  },
+  {
+    question: 'Quelle est la hauteur maximale d\'une marche?',
+    answer: 'Pour les bâtiments résidentiels, 18-19 cm est recommandé. Pour les espaces publics, le maximum est généralement 17,5 cm selon les normes. Les hauteurs de marche plus importantes sont fatigantes et potentiellement dangereuses, notamment pour les enfants et les personnes âgées.',
+  },
+  {
+    question: 'Comment calculer si l\'espace est limité?',
+    answer: 'Si l\'espace horizontal est limité, vous devez augmenter le nombre de marches (réduire la hauteur) ou accepter une pente plus raide, bien que moins confortable. La calculatrice vous aide à trouver l\'équilibre optimal.',
+  },
+  {
+    question: 'Qu\'inclut le calcul du volume de béton?',
+    answer: 'Le volume total de béton est calculé en considérant les marches plus la dalle inclinée (le plan incliné qui soutient les marches). Ignorer ce volume entraînerait une commande de béton insuffisante.',
+  },
+  {
+    question: 'Pourquoi la mise en plan cumulée est-elle importante?',
+    answer: 'Mesurer chaque marche séparément génère des erreurs cumulées. La mise en plan cumulée garantit que toutes les marches ont exactement la même hauteur, évitant les risques et améliorant le confort d\'utilisation.',
+  },
+];
+
+const howToData = [
+  { name: 'Mesurer la dénivellation', text: 'Mesurez la dénivellation totale (H) du sol fini inférieur au sol fini supérieur. C\'est la valeur fondamentale pour tout le calcul.' },
+  { name: 'Entrez la longueur disponible', text: 'Optionnel: Si vous avez des contraintes d\'espace, entrez la longueur horizontale disponible. Utilisez 0 pour un calcul libre sans limites.' },
+  { name: 'Ajustez le nombre de marches', text: 'La calculatrice propose un nombre initial, mais vous pouvez l\'ajuster. Observez l\'indicateur de Blondel: il doit être au vert (62-64 cm) pour un confort maximal.' },
+  { name: 'Définissez les paramètres de construction', text: 'Spécifiez l\'épaisseur de la dalle, les finitions, la résistance du béton et la largeur de l\'escalier. Ces valeurs affectent les calculs finaux des matériaux.' },
+];
+
+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<StairCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Références et Normes',
+  bibliography: [
+    { name: 'Règles de construction des escaliers intérieurs - DTU', url: 'https://www.afnor.org/' },
+    { name: 'Loi de Blondel - Wikipédia', url: 'https://fr.wikipedia.org/wiki/Escalier' },
+    { name: 'ISO 12122-1: Escaliers de bâtiment - Prescriptions de sécurité', url: 'https://www.iso.org/' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Géométrie de Conception d\'Escaliers: Loi de Blondel', level: 2 },
+    { type: 'paragraph', html: 'Le confort d\'un escalier dépend de la longueur du pas humain. Quand vous montez ou descendez des escaliers, votre corps s\'attend à un rythme prévisible. La loi de Blondel établit que 2 hauteurs + 1 giron = 62-64 cm est la norme garantissant un confort et une sécurité maximaux.' },
+    { type: 'title', text: 'Contrôle Structurel et Matériaux', level: 3 },
+    { type: 'paragraph', html: 'Pour une exécution professionnelle, il est vital de tenir compte de la dalle de béton (le plan incliné supportant les marches). Ignorer ce volume entraînerait une commande de béton insuffisante et une construction défectueuse. La calculatrice intègre automatiquement ce calcul.' },
+    { type: 'title', text: 'Mise en Plan et Traçage: Erreur Cumulée', level: 3 },
+    { type: 'paragraph', html: 'En construction, le plus grand ennemi est l\'erreur au niveau millimétrique. Si vous mesurez chaque marche séparément, la somme des petites erreurs peut laisser la dernière marche 5 cm plus haute ou plus basse que la première. La mise en plan cumulée évite ce problème.' },
+    { type: 'title', text: 'Prévision des Finitions Finales', level: 3 },
+    { type: 'paragraph', html: 'Un détail critique: allez-vous installer des marches en granit de 3 cm? Cette donnée est fondamentale. Si elle n\'est pas correctement prévue, la première marche sera 3 cm plus haute et la dernière 3 cm plus basse, créant un vrai risque de sécurité.' },
+  ],
+  ui: {
+    labelGeometry: 'Géométrie et Ouverture',
+    labelTotalHeight: 'Dénivellation Totale (H)',
+    labelAvailableLength: 'Longueur Disponible (L)',
+    labelAvailableLengthHint: 'Utilisez 0 pour calcul libre.',
+    labelNumSteps: 'Nombre de Marches',
+    labelOptimize: 'Optimiser (18cm)',
+    labelWork: 'Détails de Construction',
+    labelSlabThickness: 'Dalle (e)',
+    labelFinishThickness: 'Finition',
+    labelCeilingHeight: 'Hauteur Plafond (Optionnel)',
+    labelStairWidth: 'Largeur Escalier',
+    labelConcreteStrength: 'Résistance Béton',
+    optionH150: 'H-150 (Béton Maigre)',
+    optionH200: 'H-200 (Résidentiel)',
+    optionH250: 'H-250 (Structurel)',
+    labelRiser: 'Hauteur de Marche',
+    labelTread: 'Giron',
+    labelSlope: 'Pente',
+    labelRealAdvance: 'Avance Réelle',
+    labelLayoutTable: 'Mise en Plan et Exécution',
+    colStep: 'Marche',
+    colConcreteHeight: 'Hauteur Béton',
+    colFinishedHeight: 'Hauteur Finie',
+    colAdvance: 'Avance',
+    adjustedNote: 'Ajusté',
+    labelMaterials: 'Estimation des Matériaux',
+    labelTotalConcrete: 'Béton Total:',
+    labelCement: 'Ciment (sacs/25kg):',
+    labelSand: 'Sable Nécessaire:',
+    unitM3: 'm³',
+    unitBags: 'sacs',
+    unitLiters: 'L',
+    btnShare: 'Partager',
+    btnPrint: 'Imprimer PDF',
+    statusOptimalComfort: 'Confort Optimal',
+    statusMarginLimit: 'Limite Marge',
+    statusCriticalDesign: 'Conception Critique',
+    statusRiserError: 'Erreur de Giron',
+
+    msgInvalidValues: 'Valeurs invalides',
+    msgInsufficientSpace: 'ESPACE INSUFFISANT',
+    msgDangerousTread: 'Le giron de {val}cm est dangereux.',
+    msgBlondelValue: 'Blondel: {val}cm.',
+    msgOptimalStep: 'Pas confortable: {val}cm.',
+    msgLowCeiling: 'ECHAPPÉE BASSE (<2m)',
+    msgCalculating: 'Calcul en cours...',
+    msgEnterMeasurements: 'Saisissez les mesures',
+
+    shareTitle: 'Résumé de l\'ouvrage',
+    shareMessage: 'Escalier: H={h}cm, N={n}, CH={ch}cm, Vol={vol}m3',
+  },
+};

package/src/tool/stairCalculator/index.ts

@@ -0,0 +1,31 @@
+import StairCalculatorComponent from './component.astro';
+import StairCalculatorSEO from './seo.astro';
+import StairCalculatorBibliography from './bibliography.astro';
+import type { DiyToolEntry, ToolDefinition } from '../../types';
+import type { StairCalculatorUI } from './ui';
+import { stairCalculatorUI } from './ui';
+
+export {
+  StairCalculatorComponent,
+  StairCalculatorSEO,
+  StairCalculatorBibliography,
+};
+
+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 stairCalculator: DiyToolEntry<StairCalculatorUI> = {
+  id: 'stair-calculator',
+  icons: { bg: 'mdi:stairs', fg: 'mdi:ruler-square' },
+  i18n: { es, en, fr },
+};
+
+export const STAIR_CALCULATOR_TOOL: ToolDefinition = {
+  entry: stairCalculator,
+  Component: StairCalculatorComponent,
+  SEOComponent: StairCalculatorSEO,
+  BibliographyComponent: StairCalculatorBibliography,
+};
+
+export { stairCalculatorUI };