npm - @jjlmoya/utils-astronomy - Versions diffs - 1.1.0 - Mend

@jjlmoya/utils-astronomy 1.1.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 (57) hide show

package/package.json +60 -0
package/src/category/i18n/en.ts +57 -0
package/src/category/i18n/es.ts +57 -0
package/src/category/i18n/fr.ts +58 -0
package/src/category/index.ts +16 -0
package/src/category/seo.astro +15 -0
package/src/components/PreviewNavSidebar.astro +116 -0
package/src/components/PreviewToolbar.astro +143 -0
package/src/data.ts +19 -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 +251 -0
package/src/pages/index.astro +4 -0
package/src/tests/faq_count.test.ts +24 -0
package/src/tests/mocks/astro_mock.js +2 -0
package/src/tests/seo_length.test.ts +57 -0
package/src/tests/tool_validation.test.ts +145 -0
package/src/tool/bortleVisualizer/bibliography.astro +14 -0
package/src/tool/bortleVisualizer/component.astro +491 -0
package/src/tool/bortleVisualizer/i18n/en.ts +153 -0
package/src/tool/bortleVisualizer/i18n/es.ts +161 -0
package/src/tool/bortleVisualizer/i18n/fr.ts +153 -0
package/src/tool/bortleVisualizer/index.ts +41 -0
package/src/tool/bortleVisualizer/logic.ts +118 -0
package/src/tool/bortleVisualizer/seo.astro +61 -0
package/src/tool/bortleVisualizer/style.css +5 -0
package/src/tool/deepSpaceScope/bibliography.astro +14 -0
package/src/tool/deepSpaceScope/component.astro +849 -0
package/src/tool/deepSpaceScope/i18n/en.ts +157 -0
package/src/tool/deepSpaceScope/i18n/es.ts +157 -0
package/src/tool/deepSpaceScope/i18n/fr.ts +157 -0
package/src/tool/deepSpaceScope/index.ts +48 -0
package/src/tool/deepSpaceScope/logic.ts +41 -0
package/src/tool/deepSpaceScope/seo.astro +61 -0
package/src/tool/deepSpaceScope/style.css +5 -0
package/src/tool/starExposureCalculator/bibliography.astro +14 -0
package/src/tool/starExposureCalculator/component.astro +562 -0
package/src/tool/starExposureCalculator/i18n/en.ts +163 -0
package/src/tool/starExposureCalculator/i18n/es.ts +163 -0
package/src/tool/starExposureCalculator/i18n/fr.ts +158 -0
package/src/tool/starExposureCalculator/index.ts +53 -0
package/src/tool/starExposureCalculator/logic.ts +49 -0
package/src/tool/starExposureCalculator/seo.astro +61 -0
package/src/tool/starExposureCalculator/style.css +5 -0
package/src/tool/telescopeResolution/bibliography.astro +14 -0
package/src/tool/telescopeResolution/component.astro +556 -0
package/src/tool/telescopeResolution/i18n/en.ts +168 -0
package/src/tool/telescopeResolution/i18n/es.ts +163 -0
package/src/tool/telescopeResolution/i18n/fr.ts +168 -0
package/src/tool/telescopeResolution/index.ts +52 -0
package/src/tool/telescopeResolution/logic.ts +39 -0
package/src/tool/telescopeResolution/seo.astro +61 -0
package/src/tool/telescopeResolution/style.css +5 -0
package/src/tools.ts +19 -0
package/src/types.ts +71 -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: #f43f5e;
+    --primary-base: #9f1239;
+    --cyan: #06b6d4;
+  }
+  .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) => (
+        <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.faqTitle} inLanguage={locale} />
+    </section>
+    <section class="section-bibliography">
+      <Bibliography links={content.bibliography} title={content.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,251 @@
+---
+import PreviewLayout from '../layouts/PreviewLayout.astro';
+import PreviewNavSidebar from '../components/PreviewNavSidebar.astro';
+import { astronomyCategory, 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 categoryContent = await astronomyCategory.i18n[currentLocale]!();
+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={categoryContent.title}
+  currentLocale={currentLocale}
+  hasSidebar={true}
+>
+  <PreviewNavSidebar
+    slot="sidebar"
+    categoryTitle={categoryContent.title}
+    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-astronomy</span>
+      <h1>{categoryContent.title}</h1>
+      <p>{categoryContent.description}</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,24 @@
+import { describe, it, expect } from 'vitest';
+import * as DATA from '../data';
+const TOOLS = [DATA.bortleVisualizer, DATA.deepSpaceScope, DATA.starExposureCalculator, DATA.telescopeResolution];
+describe('FAQ Content Validation', () => {
+  TOOLS.forEach((entry) => {
+    describe(`Tool: ${entry.id}`, () => {
+      Object.keys(entry.i18n).forEach((locale) => {
+        it(`${locale}: should have at least 3 FAQ items`, async () => {
+          const loader = (entry.i18n as any)[locale];
+          const content = await loader();
+          if (!content.faq) {
+            throw new Error(`Tool ${entry.id} (${locale}) is missing the 'faq' property entirely.`);
+          }
+          expect(content.faq.length, `Tool ${entry.id} (${locale}) has only ${content.faq.length} FAQs, minimum 3 required.`).toBeGreaterThanOrEqual(3);
+        });
+      });
+    });
+  });
+});

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,57 @@
+import { describe, it, expect } from 'vitest';
+import * as DATA from '../data';
+const ENTRIES = [
+  { id: 'bortleVisualizer', i18n: DATA.bortleVisualizer.i18n },
+  { id: 'deepSpaceScope', i18n: DATA.deepSpaceScope.i18n },
+  { id: 'starExposureCalculator', i18n: DATA.starExposureCalculator.i18n },
+  { id: 'telescopeResolution', i18n: DATA.telescopeResolution.i18n },
+  { id: 'astronomyCategory', i18n: DATA.astronomyCategory.i18n },
+];
+describe('SEO Content Length Validation', () => {
+  ENTRIES.forEach((entry) => {
+    describe(`Tool: ${entry.id}`, () => {
+      Object.keys(entry.i18n).forEach((locale) => {
+        it(`${locale}: SEO section should contain between 400 and 900 words`, async () => {
+          const loader = (entry.i18n as any)[locale];
+          const content = await loader();
+          if (!content.seo) return;
+          let combinedText = '';
+          content.seo.forEach((section: any) => {
+            if (section.text) combinedText += section.text + ' ';
+            if (section.html) combinedText += section.html + ' ';
+            if (section.title) combinedText += section.title + ' ';
+            if (section.items) {
+              section.items.forEach((item: any) => {
+                if (typeof item === 'string') combinedText += item + ' ';
+                else {
+                  if (item.label) combinedText += item.label + ' ';
+                  if (item.value) combinedText += item.value + ' ';
+                  if (item.term) combinedText += item.term + ' ';
+                  if (item.definition) combinedText += item.definition + ' ';
+                  if (item.pro) combinedText += item.pro + ' ';
+                  if (item.con) combinedText += item.con + ' ';
+                }
+              });
+            }
+            if (section.headers) combinedText += section.headers.join(' ') + ' ';
+            if (section.rows) {
+              section.rows.forEach((row: string[]) => {
+                combinedText += row.join(' ') + ' ';
+              });
+            }
+          });
+          const cleanText = combinedText.replace(/<[^>]*>?/gm, ' ').trim();
+          const words = cleanText.split(/\s+/).filter((w: string) => w.length > 0);
+          expect(words.length, `Tool ${entry.id} (${locale}) has ${words.length} words. Target: 400-900.`).toBeGreaterThanOrEqual(400);
+          expect(words.length, `Tool ${entry.id} (${locale}) has ${words.length} words. Target: 400-900.`).toBeLessThanOrEqual(900);
+        });
+      });
+    });
+  });
+});