@jjlmoya/utils-nautical 1.2.0

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

@@ -0,0 +1,225 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TideCalculatorUI, TideCalculatorLocaleContent } from '../index';
+
+const slug = 'calculadora-altura-marea';
+const title = 'Calculadora de Altura de Marea';
+const description =
+  'Estima el nivel del agua en cualquier instante del ciclo mareal utilizando el metodo nautico de la Regla de los Dozavos. Ideal para planificacion costera y estudio del PER.';
+
+const ui: TideCalculatorUI = {
+  parametersLabel: 'Parametros',
+  highTideLabel: 'Pleamar',
+  lowTideLabel: 'Bajamar',
+  targetTimeLabel: 'Hora de consulta',
+  estimatedHeightLabel: 'Altura Estimada',
+  metersLabel: 'metros',
+  amplitudeLabel: 'Amplitud',
+  durationLabel: 'Duracion',
+  tableBreakdownLabel: 'Desglose por Dozavos',
+  tableHourLabel: 'Hora',
+  tableStateLabel: 'Estado',
+  tableStartLabel: 'Inicio',
+  tableEndLabel: 'Final',
+  statusUpLabel: 'Subiendo',
+  statusDownLabel: 'Bajando',
+  statusOutOfRange: 'Fuera de rango',
+  faqTitle: 'Preguntas Frecuentes',
+  bibliographyTitle: 'Referencias Bibliograficas',
+};
+
+const faq: TideCalculatorLocaleContent['faq'] = [
+  {
+    question: '¿Que es la Regla de los Dozavos y para que sirve?',
+    answer:
+      'La Regla de los Dozavos es un metodo matematico simplificado utilizado en nautica para estimar la altura de la marea en cualquier momento entre la pleamar y la bajamar. Se basa en que el flujo del agua sigue una curva sinusoidal aproximada, dividiendo la amplitud total en 12 partes repartidas en 6 horas (1/12, 2/12, 3/12, 3/12, 2/12, 1/12).',
+  },
+  {
+    question: '¿Es fiable este metodo para la navegacion real?',
+    answer:
+      'Es un metodo de estimacion teorica muy util para planificacion rapida y fines educativos. Sin embargo, no tiene en cuenta factores meteorologicos como la presion atmosferica o el viento, que pueden alterar el nivel del mar varios decimetros. Para navegacion real, consulta siempre las tablas oficiales de Puertos del Estado.',
+  },
+  {
+    question: '¿Que datos necesito para calcular la altura de la marea?',
+    answer:
+      'Necesitas conocer la hora y la altura (en metros) de la pleamar y la bajamar mas cercanas al momento que quieres consultar. Estos datos se encuentran en los anuarios de mareas o aplicaciones meteorologicas marinas.',
+  },
+  {
+    question: '¿Por que la marea no sube siempre a la misma velocidad?',
+    answer:
+      'Debido a la inercia de las grandes masas de agua y la configuracion de las cuencas oceanicas. La marea comienza a subir lentamente tras la bajamar, alcanza su velocidad maxima en las horas centrales (las horas del 3/12) y vuelve a frenarse al aproximarse a la pleamar.',
+  },
+  {
+    question: '¿Como afecta la presion atmosferica a la marea?',
+    answer:
+      'La presion alta (anticiclon) empuja el agua hacia abajo, reduciendo la altura real. La presion baja (borrasca) permite que el agua suba mas. Por norma general, una variacion de 1 hPa respecto a la media supone un cambio de aproximadamente 1 cm en el nivel del mar.',
+  },
+  {
+    question: '¿Que es la amplitud de marea?',
+    answer:
+      'Es la diferencia vertical de altura entre una pleamar y la bajamar inmediatamente anterior o posterior. Esta medida varia segun la fase lunar (mareas vivas y muertas) y la ubicacion geografica.',
+  },
+];
+
+const howTo: TideCalculatorLocaleContent['howTo'] = [
+  {
+    name: 'Identifica la pleamar y bajamar',
+    text: 'Consulta tu anuario de mareas para obtener las horas y alturas del ciclo de marea que te interesa.',
+  },
+  {
+    name: 'Introduce los datos en la calculadora',
+    text: 'Ingresa la hora y altura de la pleamar y la bajamar. La herramienta determinara la duracion y amplitud automaticamente.',
+  },
+  {
+    name: 'Establece la hora de consulta',
+    text: 'Ajusta la hora para la que deseas conocer el nivel del agua. Veras el punto exacto resaltado en la grafica.',
+  },
+  {
+    name: 'Analiza la tabla de dozavos',
+    text: 'Revisa el desglose hora por hora para entender como fluctuara el nivel del agua durante todo el periodo.',
+  },
+];
+
+const bibliography: TideCalculatorLocaleContent['bibliography'] = [
+  {
+    name: 'Puertos del Estado - Prediccion de Mareas',
+    url: 'https://portus.puertos.es/#/',
+  },
+  {
+    name: 'Instituto Hidrografico de la Marina',
+    url: 'https://armada.defensa.gob.es/ihm/',
+  },
+];
+
+const seo: TideCalculatorLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Dominando la Marea: La Regla de los Dozavos en la Navegacion',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'La navegacion costera y la entrada en puertos con calado restringido requieren un conocimiento preciso de la altura del agua en cada momento. Aunque hoy en dia disponemos de aplicaciones digitales y GPS que proporcionan datos en tiempo real, la <strong>Regla de los Dozavos</strong> sigue siendo una herramienta fundamental en la formacion de cualquier patron de embarcacion de recreo (PER) o capitan de yate. Esta regla es un metodo de estimacion matematica que permite calcular, de forma aproximada y sin necesidad de calculadoras complejas, la altura de la marea en cualquier punto de un ciclo mareal.',
+  },
+  {
+    type: 'title',
+    text: '¿Que es exactamente la Regla de los Dozavos?',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'La Regla de los Dozavos se basa en la observacion de que el flujo de la marea no es constante. El agua no sube ni baja a la misma velocidad durante las seis horas (aproximadamente) que dura el periodo entre una pleamar y una bajamar. En su lugar, el movimiento sigue una curva sinusoidal. Durante la primera hora, la marea se mueve lentamente; acelera en las horas centrales y vuelve a frenar a medida que se acerca al siguiente extremo.',
+  },
+  {
+    type: 'table',
+    headers: ['Hora del Ciclo', 'Proporcion', 'Estado del Flujo'],
+    rows: [
+      ['<strong>1ª Hora</strong>', '1/12 de la amplitud', 'Inicio lento (Repunte)'],
+      ['<strong>2ª Hora</strong>', '2/12 de la amplitud', 'Aceleracion del flujo'],
+      ['<strong>3ª Hora</strong>', '3/12 de la amplitud', 'Flujo maximo (Corriente fuerte)'],
+      ['<strong>4ª Hora</strong>', '3/12 de la amplitud', 'Mantenimiento del flujo'],
+      ['<strong>5ª Hora</strong>', '2/12 de la amplitud', 'Desaceleracion notable'],
+      ['<strong>6ª Hora</strong>', '1/12 de la amplitud', 'Frenado final (Hacia el estrepunte)'],
+    ],
+  },
+  {
+    type: 'title',
+    text: '¿Como utilizar esta calculadora de altura de marea?',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'Nuestra herramienta automatiza este proceso para ofrecerte una visualizacion clara y rapida. Solo necesitas los datos que encontraras en cualquier anuario de mareas u oficialia de puerto: la <strong>hora y altura de la pleamar</strong>, la <strong>hora y altura de la bajamar</strong>, y la <strong>hora de consulta</strong> para la que deseas conocer la profundidad disponible.',
+  },
+  {
+    type: 'title',
+    text: 'Limitaciones tecnicas: Factores que afectan a la marea real',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'Es crucial entender que ningun metodo matematico, incluida la Regla de los Dozavos, es infalible. Existen diversos factores meteorologicos que pueden alterar significativamente la altura real del agua.',
+  },
+  {
+    type: 'glossary',
+    items: [
+      { term: 'Presion Atmosferica', definition: 'Una borrasca eleva el nivel del mar; un anticiclon lo reduce. Por norma general, ~1 cm de variacion por cada hPa de diferencia respecto a la media.' },
+      { term: 'Viento costero', definition: 'Vientos sostenidos hacia la costa (onshore) pueden apilar agua y elevar la marea por encima de lo previsto en las tablas.' },
+      { term: 'Orografia local', definition: 'La forma de la costa, la profundidad del fondo y la presencia de estuarios o rías pueden retrasar o acelerar significativamente el flujo mareal.' },
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Nota de Seguridad',
+    html: 'Esta herramienta utiliza un metodo de estimacion matematica. No tiene en cuenta factores meteorologicos ni la orografia local. Para navegacion real, consulte siempre las tablas oficiales de Puertos del Estado.',
+  },
+  {
+    type: 'title',
+    text: 'Conceptos clave para navegantes noveles',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      {
+        term: 'Amplitud de marea',
+        definition: 'Diferencia vertical entre la pleamar y la bajamar. En el Cantabrico puede ser de varios metros; en el Mediterraneo es casi insignificante.',
+      },
+      {
+        term: 'Duracion de la marea',
+        definition: 'Intervalo de tiempo entre una marea alta y la siguiente marea baja. Normalmente ronda las 6 horas y 12 minutos (ciclo semidiurno).',
+      },
+      {
+        term: 'Cero de la carta (Datum)',
+        definition: 'Nivel de referencia a partir del cual se miden todas las profundidades en las cartas nauticas. Las sondas reales casi nunca son menores a las indicadas.',
+      },
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Uso educativo y practico',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'Esta calculadora ha sido diseñada como un recurso de apoyo para estudiantes de nautica y navegantes que buscan una forma rapida de visualizar el ciclo mareal. Al mostrar la grafica de la curva estimada, permite comprender visualmente en que fase se encuentra el puerto y con que rapidez esta cambiando la profundidad, algo esencial para decidir si es seguro fondear en una cala o si es mejor esperar a que suba la marea para entrar a puerto o cruzar un bajo.',
+  },
+];
+
+const schemas: TideCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faq.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: `Como usar: ${title}`,
+    step: howTo.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+  } as WithContext<HowTo>,
+];
+
+export const content: TideCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

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

@@ -0,0 +1,190 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TideCalculatorUI, TideCalculatorLocaleContent } from '../index';
+
+const slug = 'calculateur-hauteur-maree';
+const title = 'Calculateur de Hauteur de Maree';
+const description =
+  "Estimez le niveau de l'eau a n'importe quel moment du cycle de maree en utilisant la methode nautique de la Regle des Douzaines. Ideal pour la planification cotiere et l'etude du permis bateau.";
+
+const ui: TideCalculatorUI = {
+  parametersLabel: 'Parametres',
+  highTideLabel: 'Pleine mer',
+  lowTideLabel: 'Basse mer',
+  targetTimeLabel: 'Heure de consultation',
+  estimatedHeightLabel: 'Hauteur estimee',
+  metersLabel: 'metres',
+  amplitudeLabel: 'Amplitude',
+  durationLabel: 'Duree',
+  tableBreakdownLabel: 'Tableau des douzaines',
+  tableHourLabel: 'Heure',
+  tableStateLabel: 'Etat',
+  tableStartLabel: 'Debut',
+  tableEndLabel: 'Fin',
+  statusUpLabel: 'Montante',
+  statusDownLabel: 'Descendante',
+  statusOutOfRange: 'Hors plage',
+  faqTitle: 'Questions Frequentes',
+  bibliographyTitle: 'Bibliographie',
+};
+
+const faq: TideCalculatorLocaleContent['faq'] = [
+  {
+    question: "Qu'est-ce que la Regle des Douzaines et a quoi sert-elle?",
+    answer:
+      "La Regle des Douzaines est une methode mathematique simplifiee utilisee en navigation pour estimer la hauteur de la maree a tout moment entre la pleine mer et la basse mer. Elle repose sur l'observation que le flux de maree suit une courbe sinusoidale approximative, divisant l'amplitude totale en 12 parties reparties sur 6 heures (1/12, 2/12, 3/12, 3/12, 2/12, 1/12).",
+  },
+  {
+    question: 'Cette methode est-elle fiable pour la navigation reelle?',
+    answer:
+      "C'est une methode d'estimation theorique tres utile pour la planification rapide et les besoins pedagogiques. Cependant, elle ne tient pas compte des facteurs meteorologiques comme la pression atmospherique ou le vent, qui peuvent modifier le niveau de la mer de plusieurs decimetres. Pour la navigation reelle, consultez toujours les tables officielles des marees.",
+  },
+  {
+    question: 'Quelles donnees faut-il pour calculer la hauteur de la maree?',
+    answer:
+      "Vous avez besoin de l'heure et de la hauteur (en metres) de la pleine mer et de la basse mer les plus proches du moment que vous souhaitez consulter. Ces donnees se trouvent dans les annuaires des marees ou les applications meteorologiques marines.",
+  },
+  {
+    question: "Pourquoi la maree ne monte-t-elle pas toujours a la meme vitesse?",
+    answer:
+      "En raison de l'inertie des grandes masses d'eau et de la configuration des bassins oceaniques. La maree commence a monter lentement apres la basse mer, atteint sa vitesse maximale dans les heures centrales (les heures du 3/12) et ralentit a nouveau en s'approchant de la pleine mer.",
+  },
+  {
+    question: 'Comment la pression atmospherique affecte-t-elle la maree?',
+    answer:
+      "La haute pression (anticyclone) pousse l'eau vers le bas, reduisant la hauteur reelle. La basse pression (depression) permet a l'eau de monter davantage. En regle generale, une variation de 1 hPa par rapport a la moyenne correspond a un changement d'environ 1 cm du niveau de la mer.",
+  },
+  {
+    question: "Qu'est-ce que le marnage?",
+    answer:
+      "C'est la difference verticale de hauteur entre une pleine mer et la basse mer immediatement precedente ou suivante. Cette mesure varie selon la phase lunaire (marees de vives-eaux et de mortes-eaux) et la situation geographique.",
+  },
+];
+
+const howTo: TideCalculatorLocaleContent['howTo'] = [
+  {
+    name: 'Identifier la pleine mer et la basse mer',
+    text: "Consultez votre annuaire des marees pour obtenir les heures et hauteurs du cycle de maree qui vous interesse.",
+  },
+  {
+    name: 'Saisir les donnees dans le calculateur',
+    text: "Entrez l'heure et la hauteur de la pleine mer et de la basse mer. L'outil determinera automatiquement la duree et l'amplitude.",
+  },
+  {
+    name: "Definir l'heure de consultation",
+    text: "Ajustez l'heure pour laquelle vous souhaitez connaitre le niveau de l'eau. Vous verrez le point exact mis en evidence sur le graphique.",
+  },
+  {
+    name: 'Analyser le tableau des douzaines',
+    text: "Examinez la ventilation heure par heure pour comprendre comment le niveau de l'eau va fluctuer pendant toute la periode.",
+  },
+];
+
+const bibliography: TideCalculatorLocaleContent['bibliography'] = [
+  {
+    name: 'Puertos del Estado - Prediction des marees',
+    url: 'https://portus.puertos.es/#/',
+  },
+  {
+    name: 'Instituto Hidrografico de la Marina',
+    url: 'https://armada.defensa.gob.es/ihm/',
+  },
+];
+
+const seo: TideCalculatorLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Maitriser la maree : La Regle des Douzaines en navigation',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: "La navigation cotiere et l'entree dans des ports a tirant d'eau restreint necessitent une connaissance precise de la hauteur de l'eau a tout moment. Bien qu'aujourd'hui des applications numeriques et des GPS fournissent des donnees en temps reel, la <strong>Regle des Douzaines</strong> reste un outil fondamental dans la formation de tout skipper ou capitaine de yacht. Cette regle est une methode d'estimation mathematique qui permet de calculer, de facon approximative et sans calculatrices complexes, la hauteur de la maree a n'importe quel point d'un cycle mareal.",
+  },
+  {
+    type: 'title',
+    text: "Qu'est-ce que la Regle des Douzaines?",
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: "La Regle des Douzaines repose sur l'observation que le flux de maree n'est pas constant. L'eau ne monte ni ne descend a la meme vitesse pendant les six heures (environ) qui separent une pleine mer d'une basse mer. Le mouvement suit plutot une courbe sinusoidale. Pendant la premiere heure, la maree se deplace lentement; elle accelere dans les heures centrales et ralentit a nouveau en s'approchant de l'extremum suivant.",
+  },
+  {
+    type: 'table',
+    headers: ['Heure du cycle', 'Proportion', 'Etat du flux'],
+    rows: [
+      ['<strong>1re heure</strong>', '1/12 du marnage', 'Depart lent (Etale)'],
+      ['<strong>2e heure</strong>', '2/12 du marnage', 'Acceleration du flux'],
+      ['<strong>3e heure</strong>', '3/12 du marnage', 'Flux maximum (Courant fort)'],
+      ['<strong>4e heure</strong>', '3/12 du marnage', 'Flux soutenu'],
+      ['<strong>5e heure</strong>', '2/12 du marnage', 'Deceleration notable'],
+      ['<strong>6e heure</strong>', '1/12 du marnage', 'Freinage final (Vers l\'etale)'],
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Note de securite',
+    html: "Cet outil utilise une methode d'estimation mathematique. Il ne tient pas compte des facteurs meteorologiques ni de la topographie locale. Pour la navigation reelle, consultez toujours les tables officielles des marees.",
+  },
+  {
+    type: 'title',
+    text: 'Concepts cles pour les nouveaux navigateurs',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      {
+        term: 'Marnage',
+        definition: "Difference verticale entre la pleine mer et la basse mer. Dans le golfe de Gascogne il peut atteindre plusieurs metres; en Mediterranee il est presque negligeable.",
+      },
+      {
+        term: 'Duree de la maree',
+        definition: "Intervalle de temps entre la pleine mer et la prochaine basse mer. Environ 6 heures et 12 minutes (cycle semi-diurne).",
+      },
+      {
+        term: 'Zero hydrographique',
+        definition: "Niveau de reference a partir duquel toutes les profondeurs sur les cartes nautiques sont mesurees. Les profondeurs reelles sont presque toujours superieures.",
+      },
+    ],
+  },
+];
+
+const schemas: TideCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faq.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: `Comment utiliser : ${title}`,
+    step: howTo.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+  } as WithContext<HowTo>,
+];
+
+export const content: TideCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/tideCalculator/index.ts

@@ -0,0 +1,50 @@
+import type { NauticalToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import TideCalculatorCalculator from './component.astro';
+import TideCalculatorSEO from './seo.astro';
+import TideCalculatorBibliography from './bibliography.astro';
+
+export interface TideCalculatorUI {
+  [key: string]: string;
+  parametersLabel: string;
+  highTideLabel: string;
+  lowTideLabel: string;
+  targetTimeLabel: string;
+  estimatedHeightLabel: string;
+  metersLabel: string;
+  amplitudeLabel: string;
+  durationLabel: string;
+  tableBreakdownLabel: string;
+  tableHourLabel: string;
+  tableStateLabel: string;
+  tableStartLabel: string;
+  tableEndLabel: string;
+  statusUpLabel: string;
+  statusDownLabel: string;
+  statusOutOfRange: string;
+  faqTitle: string;
+  bibliographyTitle: string;
+}
+
+export type TideCalculatorLocaleContent = ToolLocaleContent<TideCalculatorUI>;
+
+export const tideCalculator: NauticalToolEntry<TideCalculatorUI> = {
+  id: 'tide-calculator',
+  icons: {
+    bg: 'mdi:waves',
+    fg: 'mdi:sailing',
+  },
+  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 { TideCalculatorCalculator, TideCalculatorSEO, TideCalculatorBibliography };
+
+export const TIDE_CALCULATOR_TOOL: ToolDefinition = {
+  entry: tideCalculator,
+  Component: TideCalculatorCalculator,
+  SEOComponent: TideCalculatorSEO,
+  BibliographyComponent: TideCalculatorBibliography,
+};

package/src/tool/tideCalculator/logic.ts

@@ -0,0 +1,73 @@
+export const DOZ = [1 / 12, 2 / 12, 3 / 12, 3 / 12, 2 / 12, 1 / 12] as const;
+
+export function timeToMins(s: string): number {
+  const [h, m] = s.split(':').map(Number);
+  return h * 60 + m;
+}
+
+export function minsToTime(m: number): string {
+  let mins = Math.round(m) % 1440;
+  if (mins < 0) mins += 1440;
+  return `${String(Math.floor(mins / 60)).padStart(2, '0')}:${String(mins % 60).padStart(2, '0')}`;
+}
+
+export interface CyclePoint {
+  t: number;
+  h: number;
+  p: string;
+}
+
+export interface CycleParams {
+  sT: number;
+  dur: number;
+  amp: number;
+  sH: number;
+  mult: number;
+}
+
+export function generateCycle({ sT, dur, amp, sH, mult }: CycleParams): CyclePoint[] {
+  const step = dur / 6;
+  let curH = sH;
+  const pts: CyclePoint[] = [{ t: sT, h: sH, p: '0%' }];
+  let cum = 0;
+  for (let i = 0; i < 6; i++) {
+    cum += DOZ[i];
+    curH = sH + cum * amp * mult;
+    pts.push({ t: sT + step * (i + 1), h: curH, p: `${Math.round(cum * 100)}%` });
+  }
+  return pts;
+}
+
+export interface InterpolationResult {
+  height: number | null;
+  status: 'up' | 'down' | 'out';
+}
+
+export interface InterpolationParams {
+  tT: number;
+  sT: number;
+  dur: number;
+  amp: number;
+  sH: number;
+  mult: number;
+}
+
+export function interpolateHeight({
+  tT,
+  sT,
+  dur,
+  amp,
+  sH,
+  mult,
+}: InterpolationParams): InterpolationResult {
+  const rel = tT - sT;
+  if (rel < 0 || rel > dur) return { height: null, status: 'out' };
+  const step = dur / 6;
+  const idx = Math.floor(rel / step);
+  let cum = 0;
+  for (let i = 0; i < idx; i++) cum += DOZ[i];
+  const rem = (rel % step) / step;
+  const curD = idx < 6 ? DOZ[idx] : 0;
+  const h = sH + (cum + curD * rem) * amp * mult;
+  return { height: h, status: mult > 0 ? 'up' : 'down' };
+}

package/src/tool/tideCalculator/seo.astro

@@ -0,0 +1,61 @@
+---
+import {
+  SEOTitle,
+  SEOTable,
+  SEOTip,
+  SEOCard,
+  SEOStats,
+  SEOGlossary,
+  SEOProsCons,
+  SEOSummary,
+  SEODiagnostic,
+  SEOArticle,
+} from '@jjlmoya/utils-shared';
+import { tideCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await tideCalculator.i18n[locale]?.();
+if (!content) return null;
+
+const { seo } = content;
+---
+
+<SEOArticle>
+  {seo.map((section: any) => {
+    switch (section.type) {
+      case 'summary':
+        return <SEOSummary title={section.title} items={section.items} />;
+      case 'title':
+        return <SEOTitle title={section.text} level={section.level || 2} />;
+      case 'paragraph':
+        return <p set:html={section.html} />;
+      case 'stats':
+        return <SEOStats stats={section.items} columns={section.columns} />;
+      case 'card':
+        return <SEOCard title={section.title} icon={section.icon}><Fragment set:html={section.html} /></SEOCard>;
+      case 'tip':
+        return <SEOTip title={section.title}><Fragment set:html={section.html} /></SEOTip>;
+      case 'table':
+        return (
+          <SEOTable headers={section.headers}>
+            {section.rows.map((row: string[]) => (
+              <tr>{row.map((cell: string) => <td set:html={cell} />)}</tr>
+            ))}
+          </SEOTable>
+        );
+      case 'proscons':
+        return <SEOProsCons title={section.title} items={section.items} />;
+      case 'diagnostic':
+        return <SEODiagnostic title={section.title} icon={section.icon} type={section.variant} badge={section.badge}><Fragment set:html={section.html} /></SEODiagnostic>;
+      case 'glossary':
+        return <SEOGlossary items={section.items} />;
+      default:
+        return null;
+    }
+  })}
+</SEOArticle>