@jjlmoya/utils-nautical 1.18.0 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-nautical",
-    "version": "1.18.0",
+    "version": "1.19.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",
@@ -28,7 +28,7 @@
         "check": "astro check",
         "type-check": "astro check",
         "test": "vitest run",
-        "preversion": "npm run lint && npm run test",
+        "preversion": "npm run lint && npm run test && npm run build",
         "postversion": "git push && git push --tags",
         "patch": "npm version patch",
         "minor": "npm version minor",

package/src/category/index.ts

@@ -5,12 +5,13 @@ import { nauticalConverter } from '../tool/nauticalConverter/entry';
 import { sailArea } from '../tool/sailArea/entry';
 import { speedConverter } from '../tool/speedConverter/entry';
 import { endurance } from '../tool/endurance/entry';
+import { anchorScope } from '../tool/anchorScope/entry';
 
 export type { CategoryLocaleContent };
 
 export const nauticalCategory: NauticalCategoryEntry = {
   icon: 'mdi:sail-boat',
-  tools: [tideCalculator, underKeel, nauticalConverter, sailArea, speedConverter, endurance],
+  tools: [tideCalculator, underKeel, nauticalConverter, sailArea, speedConverter, endurance, anchorScope],
   i18n: {
     en: () => import('./i18n/en').then((m) => m.content),
     es: () => import('./i18n/es').then((m) => m.content),

package/src/entries.ts

@@ -10,6 +10,9 @@ export { tideCalculator } from './tool/tideCalculator/entry';
 export type { TideCalculatorUI, TideCalculatorLocaleContent } from './tool/tideCalculator/entry';
 export { underKeel } from './tool/underKeel/entry';
 export type { UnderKeelUI, UnderKeelLocaleContent } from './tool/underKeel/entry';
+export { anchorScope } from './tool/anchorScope/entry';
+export type { AnchorScopeLocaleContent } from './tool/anchorScope/entry';
+export type { AnchorScopeUI } from './tool/anchorScope/ui';
 export { nauticalCategory } from './category';
 import { endurance } from './tool/endurance/entry';
 import { nauticalConverter } from './tool/nauticalConverter/entry';
@@ -17,4 +20,5 @@ import { sailArea } from './tool/sailArea/entry';
 import { speedConverter } from './tool/speedConverter/entry';
 import { tideCalculator } from './tool/tideCalculator/entry';
 import { underKeel } from './tool/underKeel/entry';
-export const ALL_ENTRIES = [endurance, nauticalConverter, sailArea, speedConverter, tideCalculator, underKeel];
+import { anchorScope } from './tool/anchorScope/entry';
+export const ALL_ENTRIES = [endurance, nauticalConverter, sailArea, speedConverter, tideCalculator, underKeel, anchorScope];

package/src/index.ts

@@ -1,10 +1,4 @@
-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 { nauticalCategory } from './category';
 export const NauticalCategorySEO = () => import('./category/seo.astro').then((m) => m.default);
 
 export type {
@@ -18,6 +12,14 @@ export type {
   LocaleMap,
   NauticalToolEntry,
   NauticalCategoryEntry,
+  ToolDefinition,
 } from './types';
 
 export { ALL_ENTRIES, ALL_TOOLS } from './tools';
+export { tideCalculator, TIDE_CALCULATOR_TOOL } from './tool/tideCalculator';
+export { underKeel, UNDER_KEEL_TOOL } from './tool/underKeel';
+export { nauticalConverter, NAUTICAL_CONVERTER_TOOL } from './tool/nauticalConverter';
+export { sailArea, SAIL_AREA_TOOL } from './tool/sailArea';
+export { speedConverter, SPEED_CONVERTER_TOOL } from './tool/speedConverter';
+export { endurance, ENDURANCE_TOOL } from './tool/endurance';
+export { anchorScope, ANCHOR_SCOPE_TOOL } from './tool/anchorScope';

package/src/tests/diacritics_density.test.ts

@@ -96,7 +96,7 @@ describe('Diacritics density validation', () => {
           if (!loader) return;
 
           const content = await loader();
-          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const text = normalizeText(translatableContent((content as unknown) as Record<string, unknown>));
           const rule = DIACRITIC_RULES[typedLocale];
           const letters = letterCount(text);
           const matches = diacriticCount(text, typedLocale);

package/src/tests/inverted_punctuation.test.ts

@@ -60,7 +60,7 @@ describe('Inverted punctuation validation', () => {
 
           const rule = INVERTED_PUNCTUATION_LOCALES[typedLocale];
           const content = await loader();
-          const strings = translatableStrings(content as Record<string, unknown>);
+          const strings = translatableStrings((content as unknown) as Record<string, unknown>);
           const missingQuestions = strings.flatMap((text) =>
             findMissingInvertedMarks(text, rule.questionStart, rule.questionEnd)
           );

package/src/tests/locale_completeness.test.ts

@@ -5,8 +5,8 @@ import { ALL_TOOLS } from '../tools';
 describe('Locale Completeness Validation', () => {
 
 
-  it('all 10 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(6);
+  it('all 7 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(7);
   });
 });
 

package/src/tests/script_density.test.ts

@@ -73,7 +73,7 @@ describe('Native script density validation', () => {
 
           const content = await loader();
           const rule = SCRIPT_RULES[typedLocale];
-          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const text = normalizeText(translatableContent((content as unknown) as Record<string, unknown>));
           const letters = letterCount(text);
           const matches = scriptCount(text, typedLocale);
           const ratio = scriptRatio(text, typedLocale);

package/src/tests/title_quality.test.ts

@@ -40,7 +40,7 @@ describe('Project Titles - Separator Validation', () => {
     for (const pattern of titlePatterns) {
       let match;
       while ((match = pattern.exec(content)) !== null) {
-        const title = match[1];
+        const title = match[1] ?? '';
         if (title.includes('|') || title.includes('-')) {
           findings.push(title);
         }

package/src/tests/tool_validation.test.ts

@@ -5,8 +5,8 @@ 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);
+    it('should have 7 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(7);
     });
   });
 

package/src/tool/anchorScope/anchorScope.css

@@ -0,0 +1,507 @@
+.asc-calculator {
+  --n-bg: #fff;
+  --n-bg-muted: #f8fafc;
+  --n-text: #0f172a;
+  --n-text-muted: #475569;
+  --n-text-dim: #64748b;
+  --n-border: #e2e8f0;
+  --n-shadow: rgba(0, 0, 0, 0.08);
+  --n-primary: #0284c7;
+  --n-primary-on: #fff;
+  --n-sidebar-bg: linear-gradient(160deg, #0284c7 0%, #0369a1 100%);
+  --n-sidebar-text: #fff;
+  --n-sidebar-muted: rgba(255, 255, 255, 0.9);
+  --n-sidebar-input-bg: rgba(255, 255, 255, 0.16);
+  --n-sidebar-input-border: rgba(255, 255, 255, 0.3);
+  --n-chip-active-bg: #fff;
+  --n-chip-active-text: #0369a1;
+  --n-chip-inactive-bg: rgba(255, 255, 255, 0.15);
+  --n-chip-inactive-text: #fff;
+  --n-chip-inactive-border: rgba(255, 255, 255, 0.25);
+  --n-dropdown-bg: #0f172a;
+  --n-dropdown-border: #334155;
+  --n-dropdown-text: #f8fafc;
+  --n-dropdown-hover-bg: #0284c7;
+  --n-dropdown-active-bg: #0369a1;
+  --n-card-bg: #f8fafc;
+  --n-card-border: #e2e8f0;
+  --n-highlight-bg: #f0f9ff;
+  --n-highlight-border: #0284c7;
+  --n-highlight-text: #0284c7;
+  --n-stage-bg: #0f172a;
+  --n-status-optimal-bg: rgba(34, 197, 94, 0.18);
+  --n-status-optimal-border: rgba(34, 197, 94, 0.35);
+  --n-status-optimal-text: #16a34a;
+  --n-status-caution-bg: rgba(234, 179, 8, 0.18);
+  --n-status-caution-border: rgba(234, 179, 8, 0.35);
+  --n-status-caution-text: #d97706;
+  --n-status-danger-bg: rgba(239, 68, 68, 0.18);
+  --n-status-danger-border: rgba(239, 68, 68, 0.35);
+  --n-status-danger-text: #dc2626;
+
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  max-width: 1080px;
+  margin: 0 auto;
+  box-sizing: border-box;
+}
+
+.theme-dark .asc-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.4);
+  --n-primary: #38bdf8;
+  --n-primary-on: #fff;
+  --n-sidebar-bg: linear-gradient(160deg, #0c4a6e 0%, #082f49 100%);
+  --n-sidebar-text: #f8fafc;
+  --n-sidebar-muted: #cbd5e1;
+  --n-sidebar-input-bg: rgba(15, 23, 42, 0.65);
+  --n-sidebar-input-border: rgba(255, 255, 255, 0.18);
+  --n-chip-active-bg: #fff;
+  --n-chip-active-text: #082f49;
+  --n-chip-inactive-bg: rgba(15, 23, 42, 0.5);
+  --n-chip-inactive-text: #f8fafc;
+  --n-chip-inactive-border: rgba(255, 255, 255, 0.2);
+  --n-dropdown-bg: #1e293b;
+  --n-dropdown-border: #475569;
+  --n-dropdown-text: #f8fafc;
+  --n-dropdown-hover-bg: #0284c7;
+  --n-dropdown-active-bg: #0369a1;
+  --n-card-bg: #1e293b;
+  --n-card-border: #334155;
+  --n-highlight-bg: rgba(2, 132, 199, 0.16);
+  --n-highlight-border: #38bdf8;
+  --n-highlight-text: #38bdf8;
+  --n-stage-bg: #0b1329;
+  --n-status-optimal-text: #4ade80;
+  --n-status-caution-text: #facc15;
+  --n-status-danger-text: #f87171;
+}
+
+.asc-main-card {
+  background: var(--n-bg);
+  border: 1px solid var(--n-border);
+  border-radius: 1.75rem;
+  display: grid;
+  grid-template-columns: 350px 1fr;
+  overflow: hidden;
+  box-shadow: 0 20px 40px var(--n-shadow);
+}
+
+@media (max-width: 900px) {
+  .asc-main-card {
+    grid-template-columns: 1fr;
+  }
+}
+
+.asc-sidebar {
+  background: var(--n-sidebar-bg);
+  color: var(--n-sidebar-text);
+  padding: 1.5rem;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.asc-sidebar-top {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.asc-sidebar-title {
+  font-size: 0.95rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--n-sidebar-text);
+}
+
+.asc-unit-toggle {
+  display: inline-flex;
+  background: rgba(0, 0, 0, 0.25);
+  border-radius: 0.5rem;
+  padding: 0.2rem;
+  gap: 0.2rem;
+}
+
+.asc-unit-btn {
+  background: transparent;
+  border: none;
+  color: var(--n-sidebar-muted);
+  padding: 0.25rem 0.65rem;
+  border-radius: 0.35rem;
+  font-size: 0.75rem;
+  font-weight: 800;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.asc-unit-btn.asc-unit-active {
+  background: var(--n-chip-active-bg);
+  color: var(--n-chip-active-text);
+}
+
+.asc-presets-bar {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 0.35rem;
+}
+
+.asc-preset-chip {
+  background: var(--n-chip-inactive-bg);
+  border: 1px solid var(--n-chip-inactive-border);
+  color: var(--n-chip-inactive-text);
+  padding: 0.4rem 0.35rem;
+  border-radius: 0.45rem;
+  font-size: 0.72rem;
+  font-weight: 800;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  text-align: center;
+}
+
+.asc-preset-chip:hover {
+  background: rgba(255, 255, 255, 0.25);
+}
+
+.asc-preset-chip.asc-preset-active {
+  background: var(--n-chip-active-bg);
+  color: var(--n-chip-active-text);
+  border-color: var(--n-chip-active-bg);
+}
+
+.asc-inputs-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.8rem;
+}
+
+.asc-input-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.65rem;
+}
+
+.asc-input-block {
+  display: flex;
+  flex-direction: column;
+  gap: 0.3rem;
+}
+
+.asc-input-block label {
+  font-size: 0.75rem;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--n-sidebar-muted);
+}
+
+.asc-unit-field {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+
+.asc-unit-field input {
+  padding-right: 2rem;
+}
+
+.asc-field-unit {
+  position: absolute;
+  right: 0.65rem;
+  font-size: 0.75rem;
+  font-weight: 800;
+  color: var(--n-sidebar-muted);
+  pointer-events: none;
+}
+
+.sc-num-input {
+  background: var(--n-sidebar-input-bg);
+  border: 1px solid var(--n-sidebar-input-border);
+  color: var(--n-sidebar-text);
+  padding: 0.55rem 0.75rem;
+  border-radius: 0.5rem;
+  font-size: 0.9rem;
+  font-weight: 700;
+  width: 100%;
+  box-sizing: border-box;
+  outline: none;
+  transition: border-color 0.2s;
+}
+
+.sc-num-input:focus {
+  border-color: var(--n-primary-on);
+}
+
+.asc-custom-select {
+  position: relative;
+  width: 100%;
+}
+
+.asc-select-trigger {
+  background: var(--n-sidebar-input-bg);
+  border: 1px solid var(--n-sidebar-input-border);
+  color: var(--n-sidebar-text);
+  padding: 0.55rem 0.75rem;
+  border-radius: 0.5rem;
+  font-size: 0.85rem;
+  font-weight: 700;
+  width: 100%;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  cursor: pointer;
+  outline: none;
+  transition: all 0.2s ease;
+  box-sizing: border-box;
+}
+
+.asc-select-trigger:hover,
+.asc-custom-select.asc-select-open .asc-select-trigger {
+  border-color: var(--n-primary-on);
+}
+
+.asc-select-label {
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.asc-select-chevron {
+  width: 1rem;
+  height: 1rem;
+  color: var(--n-sidebar-muted);
+  transition: transform 0.2s ease;
+  flex-shrink: 0;
+}
+
+.asc-custom-select.asc-select-open .asc-select-chevron {
+  transform: rotate(180deg);
+}
+
+.asc-select-dropdown {
+  position: absolute;
+  top: calc(100% + 0.35rem);
+  left: 0;
+  right: 0;
+  background: var(--n-dropdown-bg);
+  border: 1px solid var(--n-dropdown-border);
+  border-radius: 0.5rem;
+  box-shadow: 0 10px 25px rgba(0, 0, 0, 0.4);
+  z-index: 50;
+  display: none;
+  flex-direction: column;
+  overflow: hidden;
+  max-height: 220px;
+  overflow-y: auto;
+}
+
+.asc-custom-select.asc-select-open .asc-select-dropdown {
+  display: flex;
+}
+
+.asc-option {
+  padding: 0.55rem 0.75rem;
+  font-size: 0.82rem;
+  font-weight: 700;
+  color: var(--n-dropdown-text);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.asc-option:hover {
+  background: var(--n-dropdown-hover-bg);
+  color: var(--n-primary-on);
+}
+
+.asc-option.asc-option-active {
+  background: var(--n-dropdown-active-bg);
+  color: var(--n-primary-on);
+}
+
+.asc-reset-btn {
+  background: rgba(255, 255, 255, 0.1);
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  color: var(--n-sidebar-text);
+  padding: 0.5rem 0.8rem;
+  border-radius: 0.5rem;
+  font-size: 0.8rem;
+  font-weight: 700;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  margin-top: 0.25rem;
+}
+
+.asc-reset-btn:hover {
+  background: rgba(239, 68, 68, 0.25);
+  border-color: rgba(239, 68, 68, 0.4);
+}
+
+.asc-content {
+  background: var(--n-bg);
+  padding: 1.5rem;
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.asc-metrics-grid {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 0.65rem;
+}
+
+@media (max-width: 600px) {
+  .asc-metrics-grid {
+    grid-template-columns: 1fr 1fr;
+  }
+}
+
+.asc-metric-card {
+  background: var(--n-card-bg);
+  border: 1px solid var(--n-card-border);
+  border-radius: 0.75rem;
+  padding: 0.75rem 0.85rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.2rem;
+}
+
+.asc-metric-highlight {
+  background: var(--n-highlight-bg);
+  border-color: var(--n-highlight-border);
+}
+
+.asc-metric-lbl {
+  font-size: 0.72rem;
+  font-weight: 800;
+  color: var(--n-text-dim);
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+
+.asc-metric-val {
+  font-size: 1.35rem;
+  font-weight: 800;
+  color: var(--n-text);
+}
+
+.asc-metric-highlight .asc-metric-val {
+  color: var(--n-highlight-text);
+}
+
+.asc-status-banner {
+  background: var(--n-card-bg);
+  border: 1px solid var(--n-card-border);
+  border-radius: 0.75rem;
+  padding: 0.75rem 1rem;
+  display: flex;
+  align-items: center;
+  gap: 0.85rem;
+}
+
+.asc-status-tag {
+  font-size: 0.72rem;
+  font-weight: 800;
+  padding: 0.25rem 0.55rem;
+  border-radius: 0.35rem;
+  letter-spacing: 0.05em;
+  flex-shrink: 0;
+}
+
+.sc-status-optimal {
+  background: var(--n-status-optimal-bg);
+  color: var(--n-status-optimal-text);
+  border: 1px solid var(--n-status-optimal-border);
+}
+
+.sc-status-caution {
+  background: var(--n-status-caution-bg);
+  color: var(--n-status-caution-text);
+  border: 1px solid var(--n-status-caution-border);
+}
+
+.sc-status-danger {
+  background: var(--n-status-danger-bg);
+  color: var(--n-status-danger-text);
+  border: 1px solid var(--n-status-danger-border);
+}
+
+.asc-status-info {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+}
+
+.asc-status-headline {
+  font-weight: 800;
+  font-size: 0.88rem;
+  color: var(--n-text);
+}
+
+.asc-status-subline {
+  font-size: 0.78rem;
+  color: var(--n-text-muted);
+  line-height: 1.35;
+}
+
+.asc-visual-stage {
+  background: var(--n-stage-bg);
+  border: 1px solid var(--n-border);
+  border-radius: 0.75rem;
+  padding: 0.5rem;
+  overflow: hidden;
+}
+
+.asc-diagram-svg {
+  width: 100%;
+  height: 230px;
+  display: block;
+}
+
+.asc-advice-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.65rem;
+}
+
+@media (max-width: 600px) {
+  .asc-advice-row {
+    grid-template-columns: 1fr;
+  }
+}
+
+.asc-advice-card {
+  background: var(--n-card-bg);
+  border: 1px solid var(--n-card-border);
+  border-radius: 0.65rem;
+  padding: 0.75rem 0.85rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+
+.asc-advice-tag {
+  font-size: 0.68rem;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--n-highlight-text);
+}
+
+.asc-advice-text {
+  margin: 0;
+  font-size: 0.78rem;
+  color: var(--n-text-muted);
+  line-height: 1.35;
+}

package/src/tool/anchorScope/bibliography.astro

@@ -0,0 +1,6 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { bibliographyEntries } from './bibliography';
+---
+
+<SharedBibliography links={bibliographyEntries} />

package/src/tool/anchorScope/bibliography.ts

@@ -0,0 +1,14 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliographyEntries: BibliographyEntry[] = [
+  {
+    name: 'Anchoring Techniques & Best Practices: Types, Scope, and Holding',
+    url: 'https://takemyboattest.com/blog/uncategorized/anchoring-techniques-best-practices-types-scope-and-holding/',
+  },
+  {
+    name: 'Anchoring Physics: The Real Chain Reaction, Explained',
+    url: 'https://galvanicworks.com/anchoring-physics-the-real-chain-reaction-explained/',
+  }
+];
+
+export const bibliography = bibliographyEntries;