npm - @jjlmoya/utils-nautical - Versions diffs - 1.2.0 - Mend

@jjlmoya/utils-nautical 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (74) hide show

package/package.json +75 -0
package/src/category/i18n/en.ts +79 -0
package/src/category/i18n/es.ts +79 -0
package/src/category/i18n/fr.ts +79 -0
package/src/category/index.ts +13 -0
package/src/components/PreviewNavSidebar.astro +116 -0
package/src/components/PreviewToolbar.astro +143 -0
package/src/data.ts +12 -0
package/src/env.d.ts +5 -0
package/src/index.ts +22 -0
package/src/layouts/PreviewLayout.astro +117 -0
package/src/pages/[locale]/[slug].astro +146 -0
package/src/pages/[locale].astro +249 -0
package/src/pages/index.astro +4 -0
package/src/tests/faq_count.test.ts +30 -0
package/src/tests/mocks/astro_mock.js +2 -0
package/src/tests/seo_length.test.ts +29 -0
package/src/tests/tool_validation.test.ts +51 -0
package/src/tool/endurance/bibliography.astro +14 -0
package/src/tool/endurance/component.astro +310 -0
package/src/tool/endurance/i18n/en.ts +243 -0
package/src/tool/endurance/i18n/es.ts +249 -0
package/src/tool/endurance/i18n/fr.ts +217 -0
package/src/tool/endurance/index.ts +56 -0
package/src/tool/endurance/logic.ts +36 -0
package/src/tool/endurance/seo.astro +55 -0
package/src/tool/endurance/style.css +333 -0
package/src/tool/nauticalConverter/bibliography.astro +14 -0
package/src/tool/nauticalConverter/component.astro +481 -0
package/src/tool/nauticalConverter/i18n/en.ts +239 -0
package/src/tool/nauticalConverter/i18n/es.ts +239 -0
package/src/tool/nauticalConverter/i18n/fr.ts +239 -0
package/src/tool/nauticalConverter/index.ts +57 -0
package/src/tool/nauticalConverter/logic.ts +52 -0
package/src/tool/nauticalConverter/seo.astro +52 -0
package/src/tool/nauticalConverter/style.css +205 -0
package/src/tool/sailArea/bibliography.astro +14 -0
package/src/tool/sailArea/component.astro +418 -0
package/src/tool/sailArea/i18n/en.ts +275 -0
package/src/tool/sailArea/i18n/es.ts +275 -0
package/src/tool/sailArea/i18n/fr.ts +275 -0
package/src/tool/sailArea/index.ts +53 -0
package/src/tool/sailArea/logic.ts +55 -0
package/src/tool/sailArea/seo.astro +52 -0
package/src/tool/sailArea/style.css +351 -0
package/src/tool/speedConverter/bibliography.astro +14 -0
package/src/tool/speedConverter/component.astro +125 -0
package/src/tool/speedConverter/i18n/en.ts +271 -0
package/src/tool/speedConverter/i18n/es.ts +271 -0
package/src/tool/speedConverter/i18n/fr.ts +271 -0
package/src/tool/speedConverter/index.ts +46 -0
package/src/tool/speedConverter/logic.ts +48 -0
package/src/tool/speedConverter/seo.astro +43 -0
package/src/tool/speedConverter/style.css +239 -0
package/src/tool/tideCalculator/bibliography.astro +14 -0
package/src/tool/tideCalculator/component.astro +314 -0
package/src/tool/tideCalculator/i18n/en.ts +203 -0
package/src/tool/tideCalculator/i18n/es.ts +225 -0
package/src/tool/tideCalculator/i18n/fr.ts +190 -0
package/src/tool/tideCalculator/index.ts +50 -0
package/src/tool/tideCalculator/logic.ts +73 -0
package/src/tool/tideCalculator/seo.astro +61 -0
package/src/tool/tideCalculator/style.css +310 -0
package/src/tool/underKeel/bibliography.astro +14 -0
package/src/tool/underKeel/component.astro +240 -0
package/src/tool/underKeel/i18n/en.ts +193 -0
package/src/tool/underKeel/i18n/es.ts +206 -0
package/src/tool/underKeel/i18n/fr.ts +193 -0
package/src/tool/underKeel/index.ts +49 -0
package/src/tool/underKeel/logic.ts +83 -0
package/src/tool/underKeel/seo.astro +46 -0
package/src/tool/underKeel/style.css +312 -0
package/src/tools.ts +25 -0
package/src/types.ts +69 -0

package/src/layouts/PreviewLayout.astro ADDED Viewed

@@ -0,0 +1,117 @@
+---
+import "@jjlmoya/utils-shared/theme.css";
+import PreviewToolbar from "../components/PreviewToolbar.astro";
+import type { KnownLocale } from "../types";
+interface Props {
+  title: string;
+  currentLocale?: KnownLocale;
+  localeUrls?: Partial<Record<KnownLocale, string>>;
+  hasSidebar?: boolean;
+}
+const { title, currentLocale = "es", localeUrls = {}, hasSidebar = false } = Astro.props;
+---
+<!doctype html>
+<html lang={currentLocale}>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{title} · preview</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800;900&display=swap"
+      rel="stylesheet"
+    />
+    <script is:inline>
+      (function () {
+        const saved = localStorage.getItem("theme") || "theme-dark";
+        document.documentElement.classList.add(saved);
+      })();
+    </script>
+    <slot name="head" />
+  </head>
+  <body>
+    <PreviewToolbar currentLocale={currentLocale} localeUrls={localeUrls} />
+    <div class:list={["page-wrapper", { "with-sidebar": hasSidebar }]}>
+      {
+        hasSidebar && (
+          <aside class="sidebar-area">
+            <slot name="sidebar" />
+          </aside>
+        )
+      }
+      <main>
+        <slot />
+      </main>
+    </div>
+  </body>
+</html>
+<style is:global>
+  :root {
+    --accent: #ff6b35;
+    --primary-base: #003b73;
+    --cyan: #0074b7;
+  }
+  .theme-dark,
+  .theme-light {
+    --text-main: var(--text-base);
+    --border-color: var(--border-base);
+  }
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+  body {
+    background-color: var(--bg-page);
+    color: var(--text-base);
+    margin: 0;
+    min-height: 100vh;
+    transition:
+      background-color 0.3s ease,
+      color 0.3s ease;
+  }
+  main {
+    padding: 0 2rem;
+  }
+  .page-wrapper {
+    display: flex;
+    flex-direction: column;
+  }
+  .page-wrapper.with-sidebar {
+    display: grid;
+    grid-template-columns: 240px 1fr;
+    min-height: 100vh;
+  }
+  .sidebar-area {
+    position: sticky;
+    top: 0;
+    height: 100vh;
+    overflow-y: auto;
+    border-right: 1px solid var(--border-color);
+    background: var(--bg-page);
+  }
+  @media (max-width: 768px) {
+    .page-wrapper.with-sidebar {
+      grid-template-columns: 1fr;
+    }
+    .sidebar-area {
+      display: none;
+    }
+  }
+</style>

package/src/pages/[locale]/[slug].astro ADDED Viewed

@@ -0,0 +1,146 @@
+---
+import PreviewLayout from "../../layouts/PreviewLayout.astro";
+import PreviewNavSidebar from "../../components/PreviewNavSidebar.astro";
+import { ALL_TOOLS } from "../../index";
+import {
+  UtilityHeader,
+  FAQSection,
+  Bibliography,
+  SEORenderer,
+} from "@jjlmoya/utils-shared";
+import type { KnownLocale, ToolLocaleContent } from "../../types";
+import type { UtilitySEOContent } from "@jjlmoya/utils-shared";
+export async function getStaticPaths() {
+  const paths = [];
+  for (const { entry, Component } of ALL_TOOLS) {
+    const localeEntries = Object.entries(entry.i18n) as [
+      KnownLocale,
+      () => Promise<ToolLocaleContent>,
+    ][];
+    const localeContents = await Promise.all(
+      localeEntries.map(async ([locale, loader]) => ({
+        locale,
+        content: await loader(),
+      })),
+    );
+    const localeUrls = Object.fromEntries(
+      localeContents.map(({ locale, content }) => [
+        locale,
+        `/${locale}/${content.slug}`,
+      ]),
+    ) as Partial<Record<KnownLocale, string>>;
+    for (const { locale, content } of localeContents) {
+      const allToolsNav = await Promise.all(
+        ALL_TOOLS.map(async ({ entry: navEntry }) => ({
+          id: navEntry.id,
+          title: (await navEntry.i18n[locale]!()).title,
+          href: `/${locale}/${(await navEntry.i18n[locale]!()).slug}`,
+          isActive: navEntry.id === entry.id,
+        })),
+      );
+      paths.push({
+        params: { locale, slug: content.slug },
+        props: { Component, locale, content, localeUrls, allToolsNav },
+      });
+    }
+  }
+  return paths;
+}
+type ToolComponent = (props: { ui: Record<string, string> }) => unknown;
+interface NavItem {
+  id: string;
+  title: string;
+  href: string;
+  isActive?: boolean;
+}
+interface Props {
+  Component: ToolComponent;
+  locale: KnownLocale;
+  content: ToolLocaleContent;
+  localeUrls: Partial<Record<KnownLocale, string>>;
+  allToolsNav: NavItem[];
+}
+const { Component, locale, content, localeUrls, allToolsNav } = Astro.props;
+const seoContent: UtilitySEOContent = { locale, sections: content.seo };
+const words = content.title.split(" ");
+const titleHighlight = words[0] || "";
+const titleBase = words.slice(1).join(" ") || "";
+---
+<PreviewLayout
+  title={content.title}
+  currentLocale={locale}
+  localeUrls={localeUrls}
+  hasSidebar={true}
+>
+  <PreviewNavSidebar
+    slot="sidebar"
+    categoryTitle="Tools"
+    tools={allToolsNav}
+  />
+  <Fragment slot="head">
+    {
+      content.schemas.map((schema: unknown) => (
+        <script
+          is:inline
+          type="application/ld+json"
+          set:html={JSON.stringify(schema)}
+        />
+      ))
+    }
+  </Fragment>
+  <div class="tool-page">
+    <UtilityHeader
+      titleHighlight={titleHighlight}
+      titleBase={titleBase}
+      description={content.description}
+    />
+    <section class="section-tool">
+      <Component ui={content.ui} />
+    </section>
+    <section class="section-seo">
+      <SEORenderer content={seoContent} />
+    </section>
+    <section class="section-faq">
+      <FAQSection items={content.faq} title={content.ui.faqTitle} inLanguage={locale} />
+    </section>
+    <section class="section-bibliography">
+      <Bibliography links={content.bibliography} title={content.ui.bibliographyTitle} />
+    </section>
+  </div>
+</PreviewLayout>
+<style>
+  .tool-page {
+    display: flex;
+    flex-direction: column;
+    gap: 2rem;
+  }
+  .section-tool {
+    max-width: 1200px;
+    margin: 0 auto;
+    width: 100%;
+  }
+  .section-seo,
+  .section-faq,
+  .section-bibliography {
+    padding-top: 2rem;
+    border-top: 1px solid var(--border-color);
+  }
+</style>

package/src/pages/[locale].astro ADDED Viewed

@@ -0,0 +1,249 @@
+---
+import PreviewLayout from '../layouts/PreviewLayout.astro';
+import PreviewNavSidebar from '../components/PreviewNavSidebar.astro';
+import { ALL_TOOLS } from '../index';
+import { Icon } from 'astro-icon/components';
+import type { KnownLocale, ToolLocaleContent } from '../types';
+export async function getStaticPaths() {
+  const locales = ['en', 'es', 'fr'] as KnownLocale[];
+  return locales.map(locale => ({ params: { locale } }));
+}
+const { locale: currentLocale } = Astro.params as { locale: KnownLocale };
+const tools = ALL_TOOLS || [];
+const toolsWithContent = tools.length > 0
+  ? await Promise.all(
+      tools.map(async ({ entry, Component }) => {
+        const languages = Object.keys(entry.i18n);
+        const localeEntries = await Promise.all(
+          languages.map(async (l) => {
+            const content = await entry.i18n[l as KnownLocale]!();
+            return [l, content];
+          })
+        );
+        const localeContents = Object.fromEntries(localeEntries) as Record<string, ToolLocaleContent<Record<string, string>>>;
+        const currentLocaleContent = localeContents[currentLocale] || localeContents['en'] || localeContents['es'];
+        const availableLocales: Record<string, string> = {};
+        for (const l of languages) {
+          const lCont = localeContents[l];
+          if (lCont) {
+            availableLocales[l] = `/${l}/${lCont.slug}`;
+          }
+        }
+        return { entry, Component, locale: currentLocaleContent, availableLocales };
+      })
+    )
+  : [];
+---
+<PreviewLayout
+  title="Vela y Náutica"
+  currentLocale={currentLocale}
+  hasSidebar={true}
+>
+  <PreviewNavSidebar
+    slot="sidebar"
+    categoryTitle="Vela y Náutica"
+    tools={toolsWithContent.map(({ entry, locale, availableLocales }) => {
+      const href = availableLocales[currentLocale] || (locale ? `/${currentLocale}/${locale.slug}` : '#');
+      return {
+        id: entry.id,
+        title: locale?.title || entry.id,
+        href: href,
+      };
+    })}
+  />
+  <div class="dashboard">
+    <header class="preview-header">
+      <span class="badge">preview · @jjlmoya/utils-nautical</span>
+      <h1>Vela y Náutica</h1>
+      <p>Herramientas de navegación y vela</p>
+    </header>
+    <div class="tool-list">
+      {toolsWithContent?.map(({ entry, locale, availableLocales }) => (
+        <article class="tool-card">
+          <a href={availableLocales?.[currentLocale] || (locale ? `/${currentLocale}/${locale.slug}` : '#')} class="tool-card-link">
+            <div class="tool-icons">
+               <div class="icon-wrapper bg">
+                  <Icon name={entry.icons.bg} />
+               </div>
+               <div class="icon-wrapper fg">
+                  <Icon name={entry.icons.fg} />
+               </div>
+            </div>
+            <div class="tool-card-content">
+              <h2 class="tool-title">{locale?.title}</h2>
+              <p class="tool-description">{locale?.description}</p>
+            </div>
+            <div class="tool-card-meta">
+              <span class="tool-id">{entry.id}</span>
+            </div>
+          </a>
+          {availableLocales && Object.keys(availableLocales).length > 1 && (
+            <div class="tool-locales">
+              {Object.entries(availableLocales).map(([l, url]) => (
+                <a href={url} class="locale-badge" title={`Ver en ${l.toUpperCase()}`} class:list={{ active: l === currentLocale }}>
+                  {l.toUpperCase()}
+                </a>
+              ))}
+            </div>
+          )}
+        </article>
+      ))}
+    </div>
+  </div>
+</PreviewLayout>
+<style>
+  .dashboard {
+    display: flex;
+    flex-direction: column;
+    gap: 5rem;
+  }
+  .preview-header {
+    text-align: center;
+    padding-bottom: 3rem;
+    border-bottom: 1px solid var(--border-color);
+  }
+  .badge {
+    display: inline-block;
+    padding: 0.25rem 0.75rem;
+    background: var(--accent);
+    border-radius: 99px;
+    font-size: 0.7rem;
+    font-weight: 800;
+    margin-bottom: 1.5rem;
+    color: var(--text-base);
+    letter-spacing: 0.05em;
+  }
+  h1 {
+    font-size: clamp(2rem, 6vw, 3.5rem);
+    font-weight: 900;
+    margin: 0 0 1rem;
+    background: linear-gradient(to bottom, var(--text-base), var(--text-muted));
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    background-clip: text;
+  }
+  .preview-header p {
+    color: var(--text-muted);
+    font-size: 1.1rem;
+    margin: 0;
+  }
+  .tool-list {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+    gap: 2rem;
+  }
+  .tool-card {
+    display: flex;
+    flex-direction: column;
+    gap: 1rem;
+  }
+  .tool-card-link {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    padding: 1.5rem;
+    background: var(--bg-surface);
+    border: 1px solid var(--border-color);
+    border-radius: 0.75rem;
+    text-decoration: none;
+    transition: all 0.2s ease;
+  }
+  .tool-card-link:hover {
+    border-color: var(--accent);
+    background: rgba(244, 63, 94, 0.05);
+    transform: translateY(-2px);
+  }
+  .tool-icons {
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+    margin-bottom: 1.25rem;
+  }
+  .icon-wrapper {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 3rem;
+    height: 3rem;
+    border-radius: 0.5rem;
+    font-size: 1.5rem;
+  }
+  .icon-wrapper.bg {
+    background: var(--accent);
+    color: var(--text-base);
+  }
+  .icon-wrapper.fg {
+    background: var(--bg-page);
+    border: 1px solid var(--border-color);
+    color: var(--accent);
+  }
+  .tool-card-content {
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+  }
+  .tool-title {
+    font-size: 1.25rem;
+    font-weight: 700;
+    margin: 0 0 0.5rem;
+    color: var(--text-base);
+  }
+  .tool-description {
+    font-size: 0.9375rem;
+    color: var(--text-muted);
+    line-height: 1.5;
+    margin: 0;
+  }
+  .tool-card-meta {
+    padding-top: 1rem;
+    border-top: 1px solid var(--border-color);
+    margin-top: 1.5rem;
+  }
+  .tool-id {
+    display: inline-block;
+    font-size: 0.7rem;
+    background: var(--bg-page);
+    border: 1px solid var(--border-color);
+    padding: 0.35rem 0.75rem;
+    border-radius: 0.4rem;
+    color: var(--accent);
+    font-weight: 600;
+  }
+  .tool-locales {
+    display: flex;
+    gap: 0.5rem;
+    flex-wrap: wrap;
+  }
+  .locale-badge {
+    display: inline-block;
+    padding: 0.4rem 0.85rem;
+    background: var(--bg-page);
+    border: 1px solid var(--border-color);
+    border-radius: 0.4rem;
+    color: var(--text-muted);
+    text-decoration: none;
+    font-size: 0.75rem;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    transition: all 0.15s ease;
+  }
+  .locale-badge:hover,
+  .locale-badge.active {
+    color: var(--accent);
+    border-color: var(--accent);
+    background: rgba(244, 63, 94, 0.1);
+  }
+</style>

package/src/pages/index.astro ADDED Viewed

@@ -0,0 +1,4 @@
+---
+---
+<meta http-equiv="refresh" content="0;url=/es" />

package/src/tests/faq_count.test.ts ADDED Viewed

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+describe('FAQ Content Validation', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      const locales = Object.keys(entry.i18n) as string[];
+      locales.forEach((locale) => {
+        it(`${locale}: should have at least 3 FAQ items`, async () => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          if (!loader) return;
+          const content = await loader();
+          expect(Array.isArray(content.faq)).toBe(true);
+          expect(content.faq.length).toBeGreaterThanOrEqual(3);
+        });
+        it(`${locale}: each FAQ item should have question and answer`, async () => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          if (!loader) return;
+          const content = await loader();
+          for (const item of content.faq) {
+            expect(item.question).toBeTruthy();
+            expect(item.answer).toBeTruthy();
+          }
+        });
+      });
+    });
+  });
+});

package/src/tests/mocks/astro_mock.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export default function () { return null; }
2	+

package/src/tests/seo_length.test.ts ADDED Viewed

@@ -0,0 +1,29 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+describe('SEO Content Length Validation', () => {
+  describe('Tool SEO', () => {
+    ALL_TOOLS.forEach(({ entry }) => {
+      describe(`Tool: ${entry.id}`, () => {
+        const locales = Object.keys(entry.i18n) as string[];
+        locales.forEach((locale) => {
+          it(`${locale}: SEO sections should exist and be non-empty`, async () => {
+            const loader = entry.i18n[locale as keyof typeof entry.i18n];
+            if (!loader) return;
+            const content = await loader();
+            expect(Array.isArray(content.seo)).toBe(true);
+            expect(content.seo.length).toBeGreaterThan(0);
+          });
+          it(`${locale}: slug should be defined and non-empty`, async () => {
+            const loader = entry.i18n[locale as keyof typeof entry.i18n];
+            if (!loader) return;
+            const content = await loader();
+            expect(content.slug).toBeTruthy();
+          });
+        });
+      });
+    });
+  });
+});

package/src/tests/tool_validation.test.ts ADDED Viewed

@@ -0,0 +1,51 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+const TOOL_ID_REGEX = /^[a-z0-9]+-?[a-z0-9]*$/;
+describe('Tool Validation Suite', () => {
+  describe('Library Registration', () => {
+    it('should have 6 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(6);
+    });
+  });
+  describe('Tool ID Format', () => {
+    it('all tool IDs should match the required regex', () => {
+      for (const tool of ALL_TOOLS) {
+        expect(tool.entry.id).toMatch(TOOL_ID_REGEX);
+      }
+    });
+    it('all tool IDs should be unique', () => {
+      const ids = ALL_TOOLS.map((t) => t.entry.id);
+      expect(new Set(ids).size).toBe(ids.length);
+    });
+  });
+  describe('Tool Icons', () => {
+    it('all tools should have bg and fg icons', () => {
+      for (const tool of ALL_TOOLS) {
+        expect(tool.entry.icons.bg).toBeTruthy();
+        expect(tool.entry.icons.fg).toBeTruthy();
+      }
+    });
+  });
+  describe('Tool i18n', () => {
+    it('all tools should have es and en locales', () => {
+      for (const tool of ALL_TOOLS) {
+        expect(tool.entry.i18n.es).toBeDefined();
+        expect(tool.entry.i18n.en).toBeDefined();
+      }
+    });
+    it('all tools should have Component, SEOComponent, BibliographyComponent', () => {
+      for (const tool of ALL_TOOLS) {
+        expect(tool.Component).toBeDefined();
+        expect(tool.SEOComponent).toBeDefined();
+        expect(tool.BibliographyComponent).toBeDefined();
+      }
+    });
+  });
+});

package/src/tool/endurance/bibliography.astro ADDED Viewed

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