@jjlmoya/utils-diy 1.1.0

package/src/tool/stairCalculator/seo.astro

@@ -0,0 +1,211 @@
+---
+---
+
+<article class="sc-seo-article">
+    <h2>Calculadora de Escaleras: Diseño y Ejecución en Obra</h2>
+
+    <p>
+        Diseñar una escalera no es solo una cuestión estética; es un desafío de ingeniería y ergonomía. Nuestra herramienta avanzada permite calcular desde la <strong>geometría básica</strong> hasta la <strong>cubicación de hormigón</strong>, integrando factores críticos de obra como el espesor de la losa y los materiales de acabado.
+    </p>
+
+    <div class="sc-seo-summary">
+        <h3>Capacidades de la Herramienta</h3>
+        <ul>
+            <li>Relación de <strong>Blondel (2CH + H)</strong> optimizada.</li>
+            <li>Cálculo de <strong>volumen de hormigón</strong> real (peldaños + losa).</li>
+            <li>Compensación por <strong>espesor de acabado</strong> (mármol, madera).</li>
+            <li>Guía de <strong>replanteo acumulado</strong> para evitar errores métricos.</li>
+        </ul>
+    </div>
+
+    <h3>Fundamentos Técnicos: La Ley de Blondel</h3>
+
+    <p>
+        La comodidad de una escalera depende de la longitud del paso humano. El estándar internacional establece que la suma de dos contrahuellas y una huella debe estar en el rango de <strong>62 a 64 cm</strong>.
+    </p>
+
+    <div class="sc-seo-tip">
+        <h4>Optimización de Peldaños</h4>
+        <p>
+            Una contrahuella de <strong>18 cm</strong> es el estándar de confort en viviendas. Si tienes dudas sobre cuántos peldaños usar, nuestra calculadora incluye un botón de optimización automática que ajusta el número de niveles para acercarse a esta medida ideal.
+        </p>
+    </div>
+
+    <h3>Control de Estructura y Materiales</h3>
+
+    <p>
+        Para una ejecución profesional, es vital considerar la <strong>losa de hormigón</strong> (el plano inclinado que sostiene los escalones). Ignorar este volumen resultaría en un pedido de hormigón insuficiente.
+    </p>
+
+    <div class="sc-seo-stats">
+        <div class="sc-stat">
+            <span class="sc-stat-label">Losa Estándar</span>
+            <span class="sc-stat-value">15</span>
+            <span class="sc-stat-unit">cm</span>
+        </div>
+        <div class="sc-stat">
+            <span class="sc-stat-label">CH Vivienda</span>
+            <span class="sc-stat-value">17.5</span>
+            <span class="sc-stat-unit">cm</span>
+        </div>
+        <div class="sc-stat">
+            <span class="sc-stat-label">Ángulo Ideal</span>
+            <span class="sc-stat-value">32</span>
+            <span class="sc-stat-unit">º</span>
+        </div>
+    </div>
+
+    <h3>Replanteo y Trazado: El Error Acumulado</h3>
+
+    <p>
+        En la construcción de escaleras, 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 con una altura peligrosa (el famoso 'escalón cojo').
+    </p>
+
+    <table class="sc-seo-table">
+        <thead>
+            <tr>
+                <th>Método</th>
+                <th>Precisión</th>
+                <th>Resultado en Obra</th>
+            </tr>
+        </thead>
+        <tbody>
+            <tr>
+                <td>Medición Individual</td>
+                <td>Baja</td>
+                <td>Riesgo de tropiezos por desigualdad.</td>
+            </tr>
+            <tr>
+                <td><strong>Trazado Acumulado</strong></td>
+                <td><strong>Alta</strong></td>
+                <td><strong>Peldaños idénticos y seguros.</strong></td>
+            </tr>
+        </tbody>
+    </table>
+
+    <h3>Previsión de Acabados Finales</h3>
+
+    <p>
+        ¿Vas a instalar peldaños de granito de 3 cm? Este dato es fundamental. Si no se prevé, el primer peldaño quedará 3 cm más alto y el último 3 cm más bajo respecto al suelo terminado. Nuestra calculadora ajusta estos niveles para que, tras la colocación del material, la escalera sea perfecta de principio a fin.
+    </p>
+
+    <pre class="sc-seo-code"><code>
+# Ejemplo de Cálculo Total
+Desnivel: 300 cm
+Peldaños: 17 (CH = 17.6 cm)
+Espesor Rampa: 15 cm
+# Vol. Hormigón = Vol. Triángulos + Vol. Rampa
+    </code></pre>
+</article>
+
+<style>
+    .sc-seo-article {
+      max-width: 900px;
+      margin: 2rem auto;
+      padding: 0 1.5rem;
+      color: #1e293b;
+      line-height: 1.6;
+    }
+    .sc-seo-article h2 {
+      font-size: 1.875rem;
+      font-weight: 800;
+      margin: 1.5rem 0 1rem;
+      color: #0f172a;
+    }
+    .sc-seo-article h3 {
+      font-size: 1.25rem;
+      font-weight: 700;
+      margin: 1.5rem 0 0.75rem;
+      color: #1e293b;
+    }
+    .sc-seo-article h4 {
+      font-size: 1rem;
+      font-weight: 700;
+      margin: 0.75rem 0 0.5rem;
+    }
+    .sc-seo-article p {
+      margin-bottom: 1rem;
+    }
+    .sc-seo-summary {
+      background: #f0f9ff;
+      border-left: 4px solid #4f46e5;
+      padding: 1.25rem;
+      border-radius: 0.5rem;
+      margin: 1.25rem 0;
+    }
+    .sc-seo-summary ul {
+      margin: 0.75rem 0 0;
+      padding-left: 1.5rem;
+    }
+    .sc-seo-summary li {
+      margin-bottom: 0.5rem;
+    }
+    .sc-seo-tip {
+      background: #fef9c3;
+      border-left: 4px solid #f59e0b;
+      padding: 1.25rem;
+      border-radius: 0.5rem;
+      margin: 1.25rem 0;
+    }
+    .sc-seo-tip p {
+      margin: 0;
+    }
+    .sc-seo-stats {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+      gap: 1rem;
+      margin: 1.25rem 0;
+    }
+    .sc-stat {
+      background: #fff;
+      border: 1px solid #e2e8f0;
+      border-radius: 0.75rem;
+      padding: 1rem;
+      text-align: center;
+    }
+    .sc-stat-label {
+      display: block;
+      font-size: 0.8rem;
+      color: #64748b;
+      margin-bottom: 0.5rem;
+      font-weight: 600;
+    }
+    .sc-stat-value {
+      display: block;
+      font-size: 1.875rem;
+      font-weight: 800;
+      color: #4f46e5;
+    }
+    .sc-stat-unit {
+      display: block;
+      font-size: 0.75rem;
+      color: #64748b;
+      margin-top: 0.25rem;
+    }
+    .sc-seo-table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 1.25rem 0;
+      border: 1px solid #e2e8f0;
+    }
+    .sc-seo-table th {
+      background: #f1f5f9;
+      padding: 0.75rem;
+      text-align: left;
+      font-weight: 700;
+      border-bottom: 2px solid #e2e8f0;
+    }
+    .sc-seo-table td {
+      padding: 0.75rem;
+      border-bottom: 1px solid #e2e8f0;
+    }
+    .sc-seo-code {
+      background: #1e293b;
+      color: #e2e8f0;
+      padding: 1.25rem;
+      border-radius: 0.75rem;
+      overflow-x: auto;
+      margin: 1.25rem 0;
+      font-size: 0.9rem;
+    }
+</style>

package/src/tool/stairCalculator/ui.ts

@@ -0,0 +1,109 @@
+export interface StairCalculatorUI {
+  labelGeometry: string;
+  labelTotalHeight: string;
+  labelAvailableLength: string;
+  labelAvailableLengthHint: string;
+  labelNumSteps: string;
+  labelOptimize: string;
+  labelWork: string;
+  labelSlabThickness: string;
+  labelFinishThickness: string;
+  labelCeilingHeight: string;
+  labelStairWidth: string;
+  labelConcreteStrength: string;
+  optionH150: string;
+  optionH200: string;
+  optionH250: string;
+  labelRiser: string;
+  labelTread: string;
+  labelSlope: string;
+  labelRealAdvance: string;
+  labelLayoutTable: string;
+  colStep: string;
+  colConcreteHeight: string;
+  colFinishedHeight: string;
+  colAdvance: string;
+  adjustedNote: string;
+  labelMaterials: string;
+  labelTotalConcrete: string;
+  labelCement: string;
+  labelSand: string;
+  unitM3: string;
+  unitBags: string;
+  unitLiters: string;
+  btnShare: string;
+  btnPrint: string;
+  statusOptimalComfort: string;
+  statusMarginLimit: string;
+  statusCriticalDesign: string;
+  statusRiserError: string;
+  msgInvalidValues: string;
+  msgInsufficientSpace: string;
+  msgDangerousTread: string;
+  msgBlondelValue: string;
+  msgOptimalStep: string;
+  msgLowCeiling: string;
+  msgCalculating: string;
+  msgEnterMeasurements: string;
+  shareTitle: string;
+  shareMessage: string;
+}
+
+export const stairCalculatorUI: StairCalculatorUI = {
+  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/thermalExpansionCalculator/bibliography.astro

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