@jjlmoya/utils-nautical 1.2.0

package/src/tool/underKeel/logic.ts

@@ -0,0 +1,83 @@
+export interface TideParams {
+  highTime: number;
+  highHeight: number;
+  lowTime: number;
+  lowHeight: number;
+}
+
+export interface UnderKeelParams {
+  draft: number;
+  chartDepth: number;
+  safetyMargin: number;
+  tide: TideParams;
+}
+
+export type PassType = 'always' | 'never' | 'partial';
+
+export interface PassWindow {
+  type: PassType;
+  start: number;
+  end: number;
+  neededDepth: number;
+  tideRequired: number;
+}
+
+interface CycleData {
+  flooding: boolean;
+  sT: number;
+  dur: number;
+  sH: number;
+  amp: number;
+  mult: number;
+  tH: number;
+}
+
+function getCycleData(tide: TideParams): CycleData {
+  const { highTime: tH, highHeight: hH, lowTime: tL, lowHeight: hL } = tide;
+  const flooding = tH > tL;
+  return {
+    flooding,
+    sT: flooding ? tL : tH,
+    dur: Math.abs(tH - tL),
+    sH: flooding ? hL : hH,
+    amp: Math.abs(hH - hL),
+    mult: flooding ? 1 : -1,
+    tH,
+  };
+}
+
+function findPassOffset(target: number, dur: number): number {
+  const doz = [1 / 12, 2 / 12, 3 / 12, 3 / 12, 2 / 12, 1 / 12];
+  const step = dur / 6;
+  let cum = 0;
+  for (let i = 0; i < 6; i++) {
+    const d = doz[i] ?? 0;
+    if (cum + d >= target) return (i + (target - cum) / d) * step;
+    cum += d;
+  }
+  return dur;
+}
+
+function calculatePartialWindow(tide: TideParams, tideRequired: number, neededDepth: number): PassWindow {
+  const { flooding, sT, dur, sH, amp, mult, tH } = getCycleData(tide);
+  const targetInt = (tideRequired - sH) / (mult * amp);
+  const tOff = findPassOffset(targetInt, dur);
+  const pT = sT + tOff;
+  if (flooding) return { type: 'partial', start: pT, end: tH + (tH - pT), neededDepth, tideRequired };
+  return { type: 'partial', start: tH - (pT - tH), end: pT, neededDepth, tideRequired };
+}
+
+export function calculatePassWindow(params: UnderKeelParams): PassWindow {
+  const { draft, chartDepth, safetyMargin, tide } = params;
+  const neededDepth = draft + safetyMargin;
+  const tideRequired = Math.max(0, neededDepth - chartDepth);
+  const maxTide = Math.max(tide.highHeight, tide.lowHeight);
+  const minTide = Math.min(tide.highHeight, tide.lowHeight);
+
+  if (tideRequired > maxTide) return { type: 'never', start: 0, end: 0, neededDepth, tideRequired };
+  if (tideRequired <= minTide) {
+    const { sT, dur } = getCycleData(tide);
+    return { type: 'always', start: sT, end: sT + dur, neededDepth, tideRequired };
+  }
+  return calculatePartialWindow(tide, tideRequired, neededDepth);
+}

package/src/tool/underKeel/seo.astro

@@ -0,0 +1,46 @@
+---
+import {
+  SEOTitle,
+  SEOTable,
+  SEOTip,
+  SEOGlossary,
+  SEOArticle,
+} from '@jjlmoya/utils-shared';
+import { underKeel } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await underKeel.i18n[locale]?.();
+if (!content) return null;
+
+const { seo } = content;
+---
+
+<SEOArticle>
+  {seo.map((section: any) => {
+    switch (section.type) {
+      case 'title':
+        return <SEOTitle title={section.text} level={section.level || 2} />;
+      case 'paragraph':
+        return <p set:html={section.html} />;
+      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 'glossary':
+        return <SEOGlossary items={section.items} />;
+      default:
+        return null;
+    }
+  })}
+</SEOArticle>

package/src/tool/underKeel/style.css

@@ -0,0 +1,312 @@
+.under-keel-calculator {
+  --n-bg: #fff;
+  --n-bg-muted: #f1f5f9;
+  --n-text: #0f172a;
+  --n-text-muted: #475569;
+  --n-text-dim: #64748b;
+  --n-border: #e2e8f0;
+  --n-shadow: rgba(0, 0, 0, 0.05);
+  --n-primary: #3b82f6;
+  --n-primary-on: #fff;
+  --n-accent: #6366f1;
+  --n-cyan: #0891b2;
+  --n-success: #10b981;
+  --n-warning: #f59e0b;
+  --n-error: #f43f5e;
+
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  max-width: 1000px;
+  margin: 0 auto;
+}
+
+.theme-dark .under-keel-calculator {
+  --n-bg: #0f172a;
+  --n-bg-muted: #1e293b;
+  --n-text: #f8fafc;
+  --n-text-muted: #94a3b8;
+  --n-text-dim: #64748b;
+  --n-border: #334155;
+  --n-shadow: rgba(0, 0, 0, 0.3);
+  --n-primary: #60a5fa;
+  --n-primary-on: #fff;
+  --n-accent: #818cf8;
+  --n-cyan: #22d3ee;
+  --n-success: #34d399;
+  --n-warning: #fbbf24;
+  --n-error: #fb7185;
+}
+
+.ukc-main-card {
+  background: var(--n-bg);
+  border: 1px solid var(--n-border);
+  border-radius: 2rem;
+  display: grid;
+  grid-template-columns: 320px 1fr;
+  overflow: hidden;
+  box-shadow: 0 20px 40px var(--n-shadow);
+}
+
+@media (max-width: 850px) {
+  .ukc-main-card {
+    grid-template-columns: 1fr;
+  }
+}
+
+.ukc-calc-sidebar {
+  background: var(--n-primary);
+  color: var(--n-primary-on);
+  padding: 2rem;
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.ukc-sidebar-header h3 {
+  font-size: 1.1rem;
+  margin: 0;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  opacity: 0.9;
+}
+
+.ukc-input-set {
+  display: flex;
+  flex-direction: column;
+  gap: 1.2rem;
+}
+
+.ukc-input-block {
+  display: flex;
+  flex-direction: column;
+  gap: 0.4rem;
+}
+
+.ukc-input-block label {
+  font-size: 0.8rem;
+  font-weight: 600;
+  opacity: 0.7;
+}
+
+.ukc-unit-input {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+
+.ukc-unit-input input {
+  width: 100%;
+  background: rgba(255, 255, 255, 0.1);
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  border-radius: 0.8rem;
+  padding: 0.7rem 2.5rem 0.7rem 1rem;
+  color: var(--n-primary-on);
+  font-size: 1rem;
+  outline: none;
+}
+
+.ukc-unit-input span {
+  position: absolute;
+  right: 12px;
+  font-size: 0.85rem;
+  font-weight: 700;
+  opacity: 0.4;
+}
+
+.ukc-hr-divider {
+  height: 1px;
+  background: rgba(255, 255, 255, 0.1);
+  margin: 0.5rem 0;
+}
+
+.ukc-row {
+  display: flex;
+  gap: 0.5rem;
+}
+
+.under-keel-calculator input[type='time'],
+.under-keel-calculator input[type='number'] {
+  background: rgba(255, 255, 255, 0.1);
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  border-radius: 0.8rem;
+  padding: 0.7rem;
+  color: var(--n-primary-on);
+  font-size: 1rem;
+  outline: none;
+}
+
+.ukc-mini-num {
+  width: 80px;
+}
+
+.ukc-calc-content {
+  padding: 2.5rem;
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+  background: var(--n-bg-muted);
+}
+
+.ukc-top-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+}
+
+.ukc-result-display {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.ukc-result-display .label {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--n-text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.ukc-time-range {
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  font-size: 3.5rem;
+  font-weight: 800;
+  color: var(--n-text);
+  line-height: 1;
+}
+
+.ukc-arrow-sep {
+  color: var(--n-cyan);
+  opacity: 0.4;
+}
+
+.ukc-status-indicator {
+  padding: 0.4rem 1.2rem;
+  border-radius: 2rem;
+  font-size: 0.9rem;
+  font-weight: 700;
+  width: fit-content;
+  background: var(--n-bg-muted);
+  color: var(--n-text-dim);
+}
+
+.ukc-status-indicator.success {
+  background: color-mix(in srgb, var(--n-success), transparent 80%);
+  color: var(--n-success);
+}
+
+.ukc-status-indicator.warning {
+  background: color-mix(in srgb, var(--n-warning), transparent 80%);
+  color: var(--n-warning);
+}
+
+.ukc-status-indicator.danger {
+  background: color-mix(in srgb, var(--n-error), transparent 80%);
+  color: var(--n-error);
+}
+
+.ukc-data-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.8rem;
+}
+
+.ukc-stat-pill {
+  background: var(--n-bg);
+  padding: 0.5rem 1rem;
+  border-radius: 0.8rem;
+  border: 1px solid var(--n-border);
+  display: flex;
+  justify-content: space-between;
+  gap: 2rem;
+  font-size: 0.9rem;
+}
+
+.ukc-stat-pill span {
+  color: var(--n-text-muted);
+  font-weight: 500;
+}
+
+.ukc-stat-pill strong {
+  color: var(--n-text);
+  font-weight: 700;
+}
+
+.ukc-visual-container {
+  background: var(--n-bg);
+  border: 1px solid var(--n-border);
+  border-radius: 1.5rem;
+  padding: 2rem;
+  height: 300px;
+  display: flex;
+  justify-content: center;
+  position: relative;
+}
+
+.ukc-ocean-frame {
+  width: 200px;
+  height: 100%;
+  background: var(--n-bg-muted);
+  border: 4px solid var(--n-border);
+  border-radius: 1rem;
+  position: relative;
+  overflow: hidden;
+}
+
+.ukc-water-volume {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  background: linear-gradient(to top, var(--n-primary), var(--n-cyan));
+  opacity: 0.6;
+  transition: height 0.6s ease;
+}
+
+.ukc-surface-line {
+  position: absolute;
+  top: 0;
+  width: 100%;
+  height: 3px;
+  background: var(--n-cyan);
+}
+
+.ukc-ship-silhouette {
+  position: absolute;
+  left: 20px;
+  right: 20px;
+  height: 30px;
+  color: var(--n-text);
+  z-index: 10;
+  transition: bottom 0.6s ease;
+}
+
+.ukc-sand-bottom {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  height: 40px;
+  background: color-mix(in srgb, var(--n-warning), transparent 40%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 0.7rem;
+  font-weight: 800;
+  color: var(--n-text);
+  letter-spacing: 0.2em;
+  z-index: 5;
+}
+
+@media (max-width: 640px) {
+  .ukc-time-range {
+    font-size: 2.2rem;
+  }
+
+  .ukc-top-row {
+    flex-direction: column;
+    gap: 2rem;
+  }
+}

package/src/tools.ts

@@ -0,0 +1,25 @@
+import { TIDE_CALCULATOR_TOOL } from './tool/tideCalculator';
+import { UNDER_KEEL_TOOL } from './tool/underKeel';
+import { NAUTICAL_CONVERTER_TOOL } from './tool/nauticalConverter';
+import { SAIL_AREA_TOOL } from './tool/sailArea';
+import { SPEED_CONVERTER_TOOL } from './tool/speedConverter';
+import { ENDURANCE_TOOL } from './tool/endurance';
+import type { ToolDefinition } from './types';
+
+export const ALL_TOOLS: ToolDefinition[] = [
+  TIDE_CALCULATOR_TOOL,
+  UNDER_KEEL_TOOL,
+  NAUTICAL_CONVERTER_TOOL,
+  SAIL_AREA_TOOL,
+  SPEED_CONVERTER_TOOL,
+  ENDURANCE_TOOL,
+];
+
+export {
+  TIDE_CALCULATOR_TOOL,
+  UNDER_KEEL_TOOL,
+  NAUTICAL_CONVERTER_TOOL,
+  SAIL_AREA_TOOL,
+  SPEED_CONVERTER_TOOL,
+  ENDURANCE_TOOL,
+};

package/src/types.ts

@@ -0,0 +1,69 @@
+import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { WithContext, Thing } from 'schema-dts';
+
+export type { SEOSection };
+
+export type KnownLocale =
+  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
+  | 'fr' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+
+export interface FAQItem {
+  question: string;
+  answer: string;
+}
+
+export interface BibliographyEntry {
+  name: string;
+  url: string;
+}
+
+export interface HowToStep {
+  name: string;
+  text: string;
+}
+
+export interface ToolLocaleContent<TUI extends Record<string, string> = Record<string, string>> {
+  slug: string;
+  title: string;
+  description: string;
+  ui: TUI;
+  seo: SEOSection[];
+  faq: FAQItem[];
+  bibliography: BibliographyEntry[];
+  howTo: HowToStep[];
+  schemas: WithContext<Thing>[];
+}
+
+export interface CategoryLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  seo: SEOSection[];
+}
+
+export type LocaleLoader<T> = () => Promise<T>;
+
+export type LocaleMap<T> = Partial<Record<KnownLocale, LocaleLoader<T>>>;
+
+export interface NauticalToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface NauticalCategoryEntry {
+  icon: string;
+  tools: NauticalToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: NauticalToolEntry<Record<string, string>>;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}