@jjlmoya/utils-nautical 1.2.0

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@jjlmoya/utils-nautical",
+  "version": "1.2.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./data": "./src/data.ts"
+  },
+  "files": [
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro",
+    "lint": "eslint src/ --max-warnings 0 && stylelint \"src/**/*.{css,astro}\"",
+    "check": "astro check",
+    "type-check": "astro check",
+    "test": "vitest run",
+    "preversion": "npm run lint && npm run test",
+    "postversion": "git push && git push --tags",
+    "patch": "npm version patch",
+    "minor": "npm version minor",
+    "major": "npm version major"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,astro}": [
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "@iconify-json/mdi": "^1.2.3",
+    "@jjlmoya/utils-shared": "1.0.2",
+    "astro": "^6.1.2",
+    "astro-icon": "^1.1.0",
+    "chart.js": "^4.5.1"
+  },
+  "peerDependencies": {
+    "html2canvas": ">=1.4.0",
+    "jspdf": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "html2canvas": {
+      "optional": true
+    },
+    "jspdf": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.8",
+    "eslint": "^9.39.4",
+    "eslint-plugin-astro": "^1.6.0",
+    "eslint-plugin-no-comments": "^1.1.10",
+    "html2canvas": "^1.4.1",
+    "husky": "^9.1.7",
+    "jspdf": "^4.2.1",
+    "lint-staged": "^16.4.0",
+    "postcss-html": "^1.8.1",
+    "schema-dts": "^1.1.2",
+    "stylelint": "^17.6.0",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-declaration-strict-value": "^1.11.1",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^4.1.2"
+  }
+}

package/src/category/i18n/en.ts

@@ -0,0 +1,79 @@
+import type { CategoryLocaleContent } from '../index';
+
+const slug = 'sailing-and-nautical';
+const title = 'Sailing & Nautical';
+const description =
+  'Nautical calculation tools for sailors: tides, endurance, sail area, unit converters and speed. Ideal for RYA and Yachtmaster exam study.';
+
+const seo: CategoryLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Why use digital tools in sailing and navigation?',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Modern navigation has undergone a radical transformation with the advent of digital tools. Whether you are on a small recreational craft or at the helm of a cruising yacht, the ability to process position, wind and current data instantly is not just a matter of convenience — it is a fundamental pillar of safety at sea.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Historically, the mariner depended exclusively on the sextant, the marine chronometer and reduction tables to determine position on the vast ocean. Today, although the romanticism of the sextant persists, operational reality demands a speed of response that only digital calculation tools can provide.',
+  },
+  {
+    type: 'title',
+    text: 'Key Aspects for the Modern Navigator',
+    level: 2,
+  },
+  {
+    type: 'title',
+    text: 'Geolocation and High-Precision Digital Cartography',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'Digital cartography has democratised navigation, giving even small boats access to information previously limited to large commercial vessels. A responsible skipper uses digital tools to validate their judgement, not to replace it.',
+  },
+  {
+    type: 'list',
+    items: [
+      'Data entry precision: Minimal typographical errors can take you miles from your destination.',
+      'Cross-device compatibility: Synchronise passage planning on a tablet with bridge instruments.',
+      'Hardware failure backup: Lightweight web apps are insurance if the onboard plotter crashes.',
+      'Passage Planning: Nautical calculators allow accurate estimation of fuel consumption and distances.',
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Marine Meteorology and Route Optimisation',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'Wind and sea state are the true sovereigns of sailing. Correct interpretation of wind scales (such as the Beaufort scale) and their conversion to practical units like knots is the day-to-day reality of any navigator.',
+  },
+  {
+    type: 'tip',
+    title: 'The importance of redundancy and the Plan B',
+    html: 'Never trust all your navigation to a single electronic system. Always keep a backup of your critical waypoints on paper. Web tools are excellent for pre-passage planning, but a good sailor always has an emergency plan that requires no screen.',
+  },
+  {
+    type: 'title',
+    text: 'Nautical Training and the Use of Calculators',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Even in official examinations for nautical qualifications (such as the RYA Dayskipper or Yachtmaster), chart calculations remain mandatory. Digital tools serve as the perfect study companion, allowing candidates to verify their dead reckoning exercises, tidal calculations and compass corrections.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Our collection of utilities aims to be that bridge between the academic rigour of paper charts and the immediacy of modern navigation. We want every skipper, enthusiast or professional to find here the quick and accurate data they need before casting off.',
+  },
+];
+
+export const content: CategoryLocaleContent = {
+  slug,
+  title,
+  description,
+  seo,
+};

package/src/category/i18n/es.ts

@@ -0,0 +1,79 @@
+import type { CategoryLocaleContent } from '../index';
+
+const slug = 'vela-y-nautica';
+const title = 'Vela y Nautica';
+const description =
+  'Herramientas de calculo nautico para navegantes: mareas, autonomia, superficie velica, conversores de unidades y velocidad. Ideales para el estudio del PER y Patron de Yate.';
+
+const seo: CategoryLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: '¿Por que usar herramientas digitales en navegacion y vela?',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'La navegacion moderna ha experimentado una transformacion radical con la llegada de las herramientas digitales. Ya sea que te encuentres en una pequeña embarcacion de recreo o al mando de un velero de crucero, la capacidad de procesar datos de posicion, viento y corriente de forma instantanea no es solo una cuestion de comodidad, sino un pilar fundamental de la seguridad en el mar.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Historicamente, el marino dependia exclusivamente del sextante, el cronometro de marina y las tablas de reduccion para determinar su posicion en el vasto oceano. Hoy, aunque el romanticismo del sextante persiste, la realidad operativa exige una velocidad de respuesta que solo las herramientas de calculo digital pueden proporcionar.',
+  },
+  {
+    type: 'title',
+    text: 'Aspectos Clave para el Navegante Moderno',
+    level: 2,
+  },
+  {
+    type: 'title',
+    text: 'Geolocalización y Cartografia Digital de Alta Precision',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'La cartografia digital ha democratizado la navegacion, permitiendo que incluso barcos pequeños tengan acceso a informacion que antes estaba limitada a buques comerciales de gran calado. Un patron responsable utiliza las herramientas digitales para validar su juicio, no para sustituirlo.',
+  },
+  {
+    type: 'list',
+    items: [
+      'Precision en la entrada de datos: Errores tipograficos minimos pueden alejarte kilometros de tu destino.',
+      'Compatibilidad entre dispositivos: Permite sincronizar la planificacion en tablet con los sistemas del puente de mando.',
+      'Respaldo ante fallos de hardware: Las apps web ligeras son un seguro si el plotter de abordo falla.',
+      'Planificacion de travesias (Passage Planning): Las calculadoras nauticas permiten estimar consumos y distancias con precision matematica.',
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Meteorologia Marina y Optimizacion de la Ruta',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'El viento y el estado del mar son los verdaderos soberanos de la navegacion a vela. La interpretacion correcta de las escalas de viento (como la escala Beaufort) y su conversion a unidades practicas como nudos es el dia a dia de cualquier navegante.',
+  },
+  {
+    type: 'tip',
+    title: 'La importancia de la redundancia y el Plan B',
+    html: 'Nunca confies toda tu navegacion a un solo sistema electronico. Mantén siempre una copia de seguridad de tus coordenadas criticas en papel. Las herramientas web son excelentes para la planificacion previa, pero el buen marinero siempre tiene un plan de emergencia.',
+  },
+  {
+    type: 'title',
+    text: 'Formacion Nautica y el uso de Calculadoras',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Incluso en los examenes oficiales para obtener los titulos nauticos (como el PER en España), el uso de calculos sobre la carta sigue siendo obligatorio. Las herramientas digitales sirven como el compañero de estudio perfecto, permitiendo a los aspirantes verificar sus ejercicios de estima, calculos de marea o correcciones de aguja magnetica.',
+  },
+  {
+    type: 'paragraph',
+    html: 'Nuestra coleccion de utilidades busca ser ese puente entre la rigurosidad academica de las cartas de papel y la inmediatez de la navegacion moderna. Queremos que cada patron, aficionado o profesional, encuentre aqui el dato rapido y preciso que necesita antes de soltar amarras.',
+  },
+];
+
+export const content: CategoryLocaleContent = {
+  slug,
+  title,
+  description,
+  seo,
+};

package/src/category/i18n/fr.ts

@@ -0,0 +1,79 @@
+import type { CategoryLocaleContent } from '../index';
+
+const slug = 'voile-et-nautisme';
+const title = 'Voile et Nautisme';
+const description =
+  "Outils de calcul nautique pour les navigateurs : marees, autonomie, surface velique, convertisseurs d'unites et de vitesse. Ideaux pour la preparation aux examens de plaisance.";
+
+const seo: CategoryLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Pourquoi utiliser des outils numeriques en voile et navigation ?',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: "La navigation moderne a connu une transformation radicale avec l'avenement des outils numeriques. Que vous soyez a bord d'une petite embarcation de plaisance ou aux commandes d'un voilier de croisiere, la capacite de traiter des donnees de position, de vent et de courant instantanement est non seulement une question de commodite, mais un pilier fondamental de la securite en mer.",
+  },
+  {
+    type: 'paragraph',
+    html: "Historiquement, le marin dependait exclusivement du sextant, du chronometre de marine et des tables de reduction pour determiner sa position sur le vaste ocean. Aujourd'hui, bien que le romantisme du sextant persiste, la realite operationnelle exige une rapidite de reponse que seuls les outils de calcul numeriques peuvent fournir.",
+  },
+  {
+    type: 'title',
+    text: 'Aspects cles pour le navigateur moderne',
+    level: 2,
+  },
+  {
+    type: 'title',
+    text: 'Geolocalisation et cartographie numerique de haute precision',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: "La cartographie numerique a democratise la navigation, permettant meme aux petits bateaux d'acceder a des informations autrefois reservees aux grands navires commerciaux. Un skipper responsable utilise les outils numeriques pour valider son jugement, non pour le remplacer.",
+  },
+  {
+    type: 'list',
+    items: [
+      "Precision de saisie des donnees : De petites erreurs typographiques peuvent vous eloigner de kilometres de votre destination.",
+      "Compatibilite entre appareils : Synchronisez la planification sur tablette avec les instruments de bord.",
+      "Sauvegarde en cas de panne materielle : Les applications web legeres sont une assurance si le traceur de bord tombe en panne.",
+      "Planification de traversees : Les calculateurs nautiques permettent d'estimer avec precision les consommations et les distances.",
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Meteorologie marine et optimisation de la route',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: "Le vent et l'etat de la mer sont les veritables souverains de la navigation a voile. L'interpretation correcte des echelles de vent (comme l'echelle Beaufort) et leur conversion en unites pratiques comme les noeuds est le quotidien de tout navigateur.",
+  },
+  {
+    type: 'tip',
+    title: "L'importance de la redondance et du Plan B",
+    html: "Ne confiez jamais toute votre navigation a un seul systeme electronique. Conservez toujours une copie de sauvegarde de vos coordonnees critiques sur papier. Les outils web sont excellents pour la planification prealable, mais le bon marin a toujours un plan d'urgence.",
+  },
+  {
+    type: 'title',
+    text: 'Formation nautique et utilisation des calculateurs',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: "Meme dans les examens officiels pour l'obtention des titres nautiques, les calculs sur carte restent obligatoires. Les outils numeriques servent de compagnon d'etude ideal, permettant aux candidats de verifier leurs exercices d'estime, calculs de maree et corrections de compas.",
+  },
+  {
+    type: 'paragraph',
+    html: "Notre collection d'utilitaires vise a etre ce pont entre la rigueur academique des cartes papier et l'imediatete de la navigation moderne. Nous souhaitons que chaque skipper, amateur ou professionnel, trouve ici la donnee rapide et precise dont il a besoin avant de larguer les amarres.",
+  },
+];
+
+export const content: CategoryLocaleContent = {
+  slug,
+  title,
+  description,
+  seo,
+};

package/src/category/index.ts

@@ -0,0 +1,13 @@
+import type { NauticalCategoryEntry, CategoryLocaleContent } from '../types';
+
+export type { CategoryLocaleContent };
+
+export const nauticalCategory: NauticalCategoryEntry = {
+  icon: 'mdi:sail-boat',
+  tools: [],
+  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),
+  },
+};

package/src/components/PreviewNavSidebar.astro

@@ -0,0 +1,116 @@
+---
+interface NavItem {
+  id: string;
+  title: string;
+  href: string;
+  isActive?: boolean;
+}
+
+interface Props {
+  categoryTitle: string;
+  tools?: NavItem[];
+}
+
+const { categoryTitle, tools = [] } = Astro.props;
+---
+
+<nav class="preview-nav-sidebar">
+  <div class="sidebar-header">
+    <h3>{categoryTitle}</h3>
+  </div>
+
+  <ul class="tools-list">
+    {tools.map((tool) => (
+      <li>
+        <a
+          href={tool.href}
+          class:list={['tool-link', { active: tool.isActive }]}
+        >
+          <span class="tool-title">{tool.title}</span>
+        </a>
+      </li>
+    ))}
+  </ul>
+</nav>
+
+<style>
+  .preview-nav-sidebar {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    background: var(--bg-surface, #0f172a);
+  }
+
+  .sidebar-header {
+    padding: 2rem 1.5rem 1.5rem;
+    border-bottom: 1px solid var(--border-color, #1e293b);
+  }
+
+  .sidebar-header h3 {
+    margin: 0;
+    font-size: 0.75rem;
+    font-weight: 900;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-muted, #94a3b8);
+  }
+
+  .tools-list {
+    list-style: none;
+    margin: 0;
+    padding: 0.5rem 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.25rem;
+  }
+
+  .tools-list li {
+    margin: 0;
+  }
+
+  .tool-link {
+    display: flex;
+    align-items: center;
+    padding: 0.75rem 1.5rem;
+    color: var(--text-muted, #94a3b8);
+    text-decoration: none;
+    font-size: 0.9375rem;
+    font-weight: 500;
+    transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
+    border-left: 3px solid transparent;
+    position: relative;
+  }
+
+  .tool-link:hover {
+    color: var(--text-base, #f1f5f9);
+    background: rgba(255, 255, 255, 0.08);
+    padding-left: 1.75rem;
+  }
+
+  .tool-link.active {
+    color: var(--accent, #f43f5e);
+    background: rgba(244, 63, 94, 0.15);
+    border-left-color: var(--accent, #f43f5e);
+    font-weight: 600;
+  }
+
+  .tool-link.active::before {
+    content: '';
+    position: absolute;
+    left: 0;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 3px;
+    height: 24px;
+    background: var(--accent, #f43f5e);
+    border-radius: 0 2px 2px 0;
+  }
+
+  .tool-title {
+    display: block;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+</style>
+

package/src/components/PreviewToolbar.astro

@@ -0,0 +1,143 @@
+---
+import type { KnownLocale } from '../types';
+
+interface Props {
+  currentLocale: KnownLocale;
+  localeUrls?: Partial<Record<KnownLocale, string>>;
+}
+
+const { currentLocale, localeUrls = {} } = Astro.props;
+
+const otherLocales = Object.entries(localeUrls).filter(([l]) => l !== currentLocale) as [
+  KnownLocale,
+  string,
+][];
+---
+
+<nav class="preview-toolbar">
+  {
+    otherLocales.length > 0 && (
+      <div class="locale-group">
+        <span class="locale-current">{currentLocale.toUpperCase()}</span>
+        {otherLocales.map(([locale, url]) => (
+          <a href={url} class="btn-locale">
+            {locale.toUpperCase()}
+          </a>
+        ))}
+      </div>
+    )
+  }
+
+  <button id="theme-toggle" class="btn-theme" aria-label="Toggle theme" title="Toggle theme">
+    <span class="theme-icon"></span>
+  </button>
+</nav>
+
+<script>
+  function initToolbar() {
+    const btn = document.getElementById('theme-toggle');
+    if (!btn) return;
+
+    const applyTheme = (theme: string) => {
+      document.documentElement.classList.remove('theme-light', 'theme-dark');
+      document.documentElement.classList.add(theme);
+      localStorage.setItem('theme', theme);
+    };
+
+    btn.addEventListener('click', () => {
+      const next = document.documentElement.classList.contains('theme-dark')
+        ? 'theme-light'
+        : 'theme-dark';
+      applyTheme(next);
+    });
+  }
+
+  initToolbar();
+  document.addEventListener('astro:after-swap', initToolbar);
+</script>
+
+<style>
+  .preview-toolbar {
+    position: fixed;
+    top: 1rem;
+    right: 1.5rem;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    z-index: 1000;
+    background: var(--bg-surface);
+    padding: 0.4rem;
+    border-radius: 1rem;
+    border: 1px solid var(--border-color);
+    backdrop-filter: blur(12px);
+  }
+
+  .locale-group {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+    padding-right: 0.5rem;
+    border-right: 1px solid var(--border-color);
+  }
+
+  .locale-current {
+    font-size: 0.7rem;
+    font-weight: 900;
+    color: var(--text-muted);
+    padding: 0.4rem 0.6rem;
+    letter-spacing: 0.08em;
+  }
+
+  .btn-locale {
+    background: transparent;
+    border: 1px solid var(--border-color);
+    color: var(--text-main);
+    cursor: pointer;
+    padding: 0.4rem 0.7rem;
+    border-radius: 0.5rem;
+    font-weight: 700;
+    font-size: 0.7rem;
+    text-decoration: none;
+    letter-spacing: 0.08em;
+    transition: all 0.2s ease;
+  }
+
+  .btn-locale:hover {
+    border-color: var(--accent);
+    color: var(--accent);
+  }
+
+  .btn-theme {
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    padding: 0.5rem;
+    border-radius: 0.6rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: background 0.2s ease;
+  }
+
+  .btn-theme:hover {
+    background: rgba(255, 255, 255, 0.08);
+  }
+
+  .theme-icon {
+    display: block;
+    width: 16px;
+    height: 16px;
+    border-radius: 50%;
+  }
+
+  :global(.theme-light) .theme-icon {
+    background: #f59e0b;
+    box-shadow: 0 0 8px #fbbf24;
+  }
+
+  :global(.theme-dark) .theme-icon {
+    background: #94a3b8;
+    box-shadow: inset -4px -2px 0 #1e293b;
+  }
+</style>
+

package/src/data.ts

@@ -0,0 +1,12 @@
+export { tideCalculator } from './tool/tideCalculator';
+
+export type { TideCalculatorUI, TideCalculatorLocaleContent } from './tool/tideCalculator';
+
+export type {
+  KnownLocale,
+  ToolLocaleContent,
+  CategoryLocaleContent,
+  LocaleMap,
+  NauticalToolEntry,
+  NauticalCategoryEntry,
+} from './types';

package/src/env.d.ts

@@ -0,0 +1,5 @@
+declare module '*.astro' {
+  const Component: (_props: Record<string, unknown>) => unknown;
+  export default Component;
+}
+

package/src/index.ts

@@ -0,0 +1,22 @@
+export * from './tool/tideCalculator';
+export * from './tool/underKeel';
+export * from './tool/nauticalConverter';
+export * from './tool/sailArea';
+export * from './tool/speedConverter';
+export * from './tool/endurance';
+export * from './category';
+
+export type {
+  KnownLocale,
+  FAQItem,
+  BibliographyEntry,
+  HowToStep,
+  ToolLocaleContent,
+  CategoryLocaleContent,
+  LocaleLoader,
+  LocaleMap,
+  NauticalToolEntry,
+  NauticalCategoryEntry,
+} from './types';
+
+export { ALL_TOOLS } from './tools';