@jjlmoya/utils-travel 1.26.0 → 1.28.0

package/src/tool/jet-lag-recovery-planner/i18n/nl.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('nl');

package/src/tool/jet-lag-recovery-planner/i18n/pl.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('pl');

package/src/tool/jet-lag-recovery-planner/i18n/pt.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('pt');

package/src/tool/jet-lag-recovery-planner/i18n/ru.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('ru');

package/src/tool/jet-lag-recovery-planner/i18n/sv.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('sv');

package/src/tool/jet-lag-recovery-planner/i18n/tr.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('tr');

package/src/tool/jet-lag-recovery-planner/i18n/zh.ts

@@ -0,0 +1,2 @@
+import { createContent } from './content';
+export const content = createContent('zh');

package/src/tool/jet-lag-recovery-planner/index.ts

@@ -0,0 +1,12 @@
+import type { ToolDefinition } from '../../types';
+import { jetLagRecoveryPlanner } from './entry';
+
+export * from './entry';
+export * from './logic';
+
+export const JET_LAG_RECOVERY_PLANNER_TOOL: ToolDefinition = {
+  entry: jetLagRecoveryPlanner,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/jet-lag-recovery-planner/jet-lag-recovery-planner.css

@@ -0,0 +1,505 @@
+.jet-lag-planner {
+  --jl-ink: #17324d;
+  --jl-muted: #587086;
+  --jl-paper: #fffdf7;
+  --jl-line: #d8e1e4;
+  --jl-blue: #197c9c;
+  --jl-blue-soft: #e5f3f4;
+  --jl-sun: #e8a52e;
+  --jl-night: #294e78;
+
+  color: var(--jl-ink);
+}
+
+.theme-dark .jet-lag-planner {
+  --jl-ink: #edf7f6;
+  --jl-muted: #abc0c9;
+  --jl-paper: #172b3d;
+  --jl-line: #355066;
+  --jl-blue: #6ed1d2;
+  --jl-blue-soft: #1d4858;
+  --jl-sun: #f5bd51;
+  --jl-night: #9cc4e8;
+}
+
+.jl-card {
+  background: var(--jl-paper);
+  border: 1px solid var(--jl-line);
+  border-radius: 1.5rem;
+  box-shadow: 0 1rem 2.5rem rgba(18, 46, 69, 0.08);
+}
+
+.theme-dark .jl-card {
+  box-shadow: 0 1rem 2.5rem rgba(0, 0, 0, 0.22);
+}
+
+.jl-workspace {
+  display: grid;
+  grid-template-columns: 1.1fr 0.9fr;
+  grid-template-areas:
+    "hero-copy journey"
+    "form result";
+  gap: 2rem;
+  align-items: center;
+  margin-top: 0;
+  padding: clamp(1.5rem, 4vw, 3rem);
+  overflow: hidden;
+  background:
+    radial-gradient(circle at 85% 25%, rgba(232, 165, 46, 0.16), transparent 30%),
+    radial-gradient(circle at 8% 90%, rgba(25, 124, 156, 0.14), transparent 35%),
+    var(--jl-paper);
+}
+
+.jl-hero-copy {
+  grid-area: hero-copy;
+  position: relative;
+  z-index: 1;
+}
+
+.jl-kicker {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.45rem;
+  color: var(--jl-blue);
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0.11em;
+  text-transform: uppercase;
+}
+
+.jl-kicker svg {
+  width: 1.15rem;
+  height: 1.15rem;
+}
+
+.jl-hero-copy p {
+  max-width: 58ch;
+  margin: 0;
+  color: var(--jl-muted);
+  font-size: 1.05rem;
+  line-height: 1.65;
+}
+
+.jl-journey {
+  grid-area: journey;
+  position: relative;
+  min-height: 13rem;
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
+  gap: 0.75rem;
+  align-items: center;
+  padding: 1rem;
+  border: 1px dashed var(--jl-line);
+  border-radius: 45% 55% 50% 40%;
+  transform: rotate(-2deg);
+}
+
+.jl-journey::before {
+  position: absolute;
+  inset: 0.6rem;
+  border: 2px solid color-mix(in srgb, var(--jl-blue) 35%, transparent);
+  border-radius: 50%;
+  content: "";
+  transform: rotate(8deg);
+}
+
+.jl-journey-node,
+.jl-journey-line {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.jl-journey-node {
+  flex-direction: column;
+  gap: 0.6rem;
+  font-size: 0.76rem;
+  font-weight: 800;
+  text-align: center;
+  text-transform: uppercase;
+}
+
+.jl-journey-node svg {
+  width: 4rem;
+  height: 4rem;
+  padding: 0.8rem;
+  border-radius: 50%;
+}
+
+.jl-night {
+  color: var(--jl-night);
+}
+
+.jl-night svg {
+  background: color-mix(in srgb, var(--jl-night) 16%, transparent);
+}
+
+.jl-day {
+  color: var(--jl-sun);
+}
+
+.jl-day svg {
+  background: color-mix(in srgb, var(--jl-sun) 18%, transparent);
+}
+
+.jl-journey-line {
+  color: var(--jl-blue);
+}
+
+.jl-journey-line svg {
+  width: 2rem;
+  height: 2rem;
+}
+
+.jl-form {
+  grid-area: form;
+  padding-right: 2rem;
+  border-right: 1px solid var(--jl-line);
+}
+
+.jl-form-heading,
+.jl-result-top {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.8rem;
+}
+
+.jl-result {
+  grid-area: result;
+}
+
+.jl-form-heading {
+  margin-bottom: 1.5rem;
+}
+
+.jl-step {
+  display: inline-grid;
+  width: 2rem;
+  height: 2rem;
+  flex: 0 0 auto;
+  place-items: center;
+  border-radius: 0.55rem;
+  background: var(--jl-blue-soft);
+  color: var(--jl-blue);
+  font-size: 0.76rem;
+  font-weight: 900;
+}
+
+.jl-form h3,
+.jl-result h3 {
+  margin: 0;
+  font-size: 1.3rem;
+}
+
+.jl-form-heading p {
+  margin: 0.3rem 0 0;
+  color: var(--jl-muted);
+  font-size: 0.85rem;
+}
+
+.jl-form-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+}
+
+.jl-field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.45rem;
+}
+
+.jl-field span {
+  font-size: 0.82rem;
+  font-weight: 800;
+}
+
+.jl-field small {
+  color: var(--jl-muted);
+  font-size: 0.72rem;
+  line-height: 1.3;
+}
+
+.jl-field input,
+.jl-field select {
+  width: 100%;
+  box-sizing: border-box;
+  min-height: 2.9rem;
+  padding: 0.7rem 0.8rem;
+  border: 1px solid var(--jl-line);
+  border-radius: 0.7rem;
+  background: color-mix(in srgb, var(--jl-paper) 88%, var(--jl-blue-soft));
+  color: var(--jl-ink);
+  font: inherit;
+}
+
+.jl-field input:focus,
+.jl-field select:focus,
+.jl-actions button:focus-visible {
+  outline: 3px solid color-mix(in srgb, var(--jl-blue) 30%, transparent);
+  outline-offset: 2px;
+  border-color: var(--jl-blue);
+}
+
+.jl-days-field {
+  max-width: 9rem;
+}
+
+.jl-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  margin-top: 1.5rem;
+}
+
+.jl-actions button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  min-height: 2.9rem;
+  padding: 0.7rem 1rem;
+  border: 1px solid transparent;
+  border-radius: 0.7rem;
+  font: inherit;
+  font-size: 0.87rem;
+  font-weight: 800;
+  cursor: pointer;
+}
+
+.jl-actions svg {
+  width: 1.15rem;
+  height: 1.15rem;
+}
+
+.jl-primary {
+  background: var(--jl-blue);
+  color: #fff;
+}
+
+.theme-dark .jl-primary {
+  color: #082433;
+}
+
+.jl-secondary {
+  border-color: var(--jl-line);
+  background: transparent;
+  color: var(--jl-ink);
+}
+
+.jl-result-top {
+  justify-content: space-between;
+}
+
+.jl-result-top > div {
+  display: flex;
+  gap: 0.8rem;
+  align-items: flex-start;
+}
+
+.jl-direction {
+  display: inline-flex;
+  align-items: center;
+  min-height: 2rem;
+  padding: 0.35rem 0.65rem;
+  border-radius: 2rem;
+  background: var(--jl-blue-soft);
+  color: var(--jl-blue);
+  font-size: 0.76rem;
+  font-weight: 900;
+  text-align: right;
+}
+
+.jl-direction[data-direction="west"] {
+  background: color-mix(in srgb, var(--jl-sun) 18%, transparent);
+  color: #a36d11;
+}
+
+.theme-dark .jl-direction[data-direction="west"] {
+  color: #ffd27c;
+}
+
+.jl-result-intro {
+  margin: 1rem 0;
+  color: var(--jl-muted);
+  line-height: 1.55;
+}
+
+.jl-metrics {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 0.65rem;
+}
+
+.jl-metrics > div {
+  min-width: 0;
+  padding: 0.8rem;
+  border-radius: 0.8rem;
+  background: var(--jl-blue-soft);
+}
+
+.jl-metrics span,
+.jl-metrics strong {
+  display: block;
+}
+
+.jl-metrics span {
+  color: var(--jl-muted);
+  font-size: 0.68rem;
+  line-height: 1.2;
+}
+
+.jl-metrics strong {
+  margin-top: 0.35rem;
+  font-size: 1.05rem;
+}
+
+.jl-status {
+  margin: 1rem 0;
+  padding: 0.7rem 0.9rem;
+  border-left: 3px solid var(--jl-sun);
+  background: color-mix(in srgb, var(--jl-sun) 12%, transparent);
+  color: var(--jl-ink);
+  font-size: 0.85rem;
+  font-weight: 800;
+}
+
+.jl-status[data-complete="true"] {
+  border-left-color: var(--jl-blue);
+  background: var(--jl-blue-soft);
+}
+
+.jl-days-list {
+  display: grid;
+  gap: 0.7rem;
+  max-height: 27rem;
+  padding-right: 0.25rem;
+  overflow-y: auto;
+}
+
+.jl-day-card {
+  padding: 0.9rem;
+  border: 1px solid var(--jl-line);
+  border-radius: 0.85rem;
+}
+
+.jl-day-title {
+  display: flex;
+  justify-content: space-between;
+  gap: 0.75rem;
+  margin-bottom: 0.7rem;
+  font-size: 0.8rem;
+}
+
+.jl-day-title strong {
+  color: var(--jl-blue);
+}
+
+.jl-schedule {
+  display: grid;
+  grid-template-columns: repeat(5, 1fr);
+  gap: 0.4rem;
+}
+
+.jl-schedule > div {
+  display: flex;
+  flex-direction: column;
+  gap: 0.15rem;
+}
+
+.jl-schedule span {
+  color: var(--jl-blue);
+  font-size: 1.1rem;
+}
+
+.jl-schedule small {
+  color: var(--jl-muted);
+  font-size: 0.62rem;
+  line-height: 1.1;
+}
+
+.jl-schedule b {
+  font-size: 0.83rem;
+}
+
+.jl-light,
+.jl-note,
+.jl-safety {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.45rem;
+  margin: 0.75rem 0 0;
+  color: var(--jl-muted);
+  font-size: 0.78rem;
+  line-height: 1.45;
+}
+
+.jl-light {
+  color: var(--jl-ink);
+  font-weight: 700;
+}
+
+.jl-light-dot {
+  width: 0.65rem;
+  height: 0.65rem;
+  flex: 0 0 auto;
+  margin-top: 0.2rem;
+  border-radius: 50%;
+  background: var(--jl-sun);
+}
+
+.jl-note {
+  margin-top: 1.2rem;
+}
+
+.jl-note svg,
+.jl-safety svg {
+  width: 1rem;
+  height: 1rem;
+  flex: 0 0 auto;
+  color: var(--jl-blue);
+}
+
+.jl-safety {
+  color: var(--jl-ink);
+  font-weight: 700;
+}
+
+@media (max-width: 850px) {
+  .jl-workspace {
+    grid-template-columns: 1fr;
+    grid-template-areas:
+      "hero-copy"
+      "journey"
+      "form"
+      "result";
+  }
+
+  .jl-form {
+    padding-right: 0;
+    padding-bottom: 1.5rem;
+    border-right: 0;
+    border-bottom: 1px solid var(--jl-line);
+  }
+}
+
+@media (max-width: 520px) {
+  .jl-form-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .jl-days-field {
+    max-width: none;
+  }
+
+  .jl-schedule {
+    grid-template-columns: repeat(3, 1fr);
+    row-gap: 0.7rem;
+  }
+
+  .jl-metrics {
+    grid-template-columns: 1fr;
+  }
+}

package/src/tool/jet-lag-recovery-planner/logic.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { calculateJetLagPlan, formatTime } from './logic';
+
+const base = {
+  originOffset: 1,
+  destinationOffset: 9,
+  departure: '2026-09-05T10:00',
+  arrival: '2026-09-05T20:00',
+  sleepTime: '23:00',
+  wakeTime: '07:00',
+  days: 8,
+};
+
+describe('jet lag recovery planner', () => {
+  it('wraps local times and advances an eastward schedule', () => {
+    const plan = calculateJetLagPlan(base);
+    expect(plan.direction).toBe('east');
+    expect(plan.offsetDifference).toBe(8);
+    expect(plan.days[0]?.sleep).toBe('06:00');
+    expect(plan.days.at(-1)?.sleep).toBe('23:00');
+    expect(plan.targetReached).toBe(true);
+  });
+
+  it('delays a westward schedule', () => {
+    const plan = calculateJetLagPlan({ ...base, originOffset: 9, destinationOffset: 1, days: 4 });
+    expect(plan.direction).toBe('west');
+    expect(plan.days[0]?.sleep).toBe('16:00');
+    expect(plan.days.at(-1)?.sleep).toBe('19:00');
+    expect(plan.remainingHours).toBe(4);
+  });
+
+  it('shows no shift for the same offset', () => {
+    const plan = calculateJetLagPlan({ ...base, destinationOffset: 1, days: 5 });
+    expect(plan.direction).toBe('same');
+    expect(plan.days[0]?.sleep).toBe('23:00');
+    expect(plan.days[0]?.light).toBe('none');
+  });
+
+  it('rejects negative travel duration without breaking the plan', () => {
+    const plan = calculateJetLagPlan({ ...base, arrival: '2026-09-04T20:00' });
+    expect(plan.travelHours).toBeNull();
+    expect(plan.days).toHaveLength(8);
+  });
+
+  it('formats wrapped times consistently', () => {
+    expect(formatTime(-60)).toBe('23:00');
+    expect(formatTime(24 * 60 + 15)).toBe('00:15');
+  });
+});

package/src/tool/jet-lag-recovery-planner/logic.ts

@@ -0,0 +1,102 @@
+export type TravelDirection = 'east' | 'west' | 'same';
+
+export interface JetLagInputs {
+  originOffset: number;
+  destinationOffset: number;
+  departure: string;
+  arrival: string;
+  sleepTime: string;
+  wakeTime: string;
+  days: number;
+}
+
+export interface JetLagDay {
+  day: number;
+  sleep: string;
+  wake: string;
+  breakfast: string;
+  lunch: string;
+  dinner: string;
+  light: 'morning' | 'afternoon' | 'none';
+  shiftHours: number;
+}
+
+export interface JetLagPlan {
+  direction: TravelDirection;
+  offsetDifference: number;
+  absoluteDifference: number;
+  travelHours: number | null;
+  dailyShift: number;
+  targetReached: boolean;
+  remainingHours: number;
+  days: JetLagDay[];
+}
+
+const MINUTES_IN_DAY = 24 * 60;
+
+const toMinutes = (time: string): number => {
+  const [hours, minutes] = time.split(':').map(Number);
+  if (!Number.isFinite(hours) || !Number.isFinite(minutes)) return 0;
+  return Math.max(0, Math.min(MINUTES_IN_DAY - 1, hours * 60 + minutes));
+};
+
+const wrapMinutes = (minutes: number): number => ((minutes % MINUTES_IN_DAY) + MINUTES_IN_DAY) % MINUTES_IN_DAY;
+
+export const formatTime = (minutes: number): string => {
+  const wrapped = wrapMinutes(Math.round(minutes));
+  return `${String(Math.floor(wrapped / 60)).padStart(2, '0')}:${String(wrapped % 60).padStart(2, '0')}`;
+};
+
+const hoursBetween = (start: string, end: string): number | null => {
+  const startDate = new Date(start);
+  const endDate = new Date(end);
+  if (Number.isNaN(startDate.getTime()) || Number.isNaN(endDate.getTime())) return null;
+  const difference = (endDate.getTime() - startDate.getTime()) / 3_600_000;
+  return difference >= 0 ? Math.round(difference * 10) / 10 : null;
+};
+
+const resolveDirection = (offsetDifference: number): TravelDirection => {
+  if (offsetDifference === 0) return 'same';
+  return offsetDifference > 0 ? 'east' : 'west';
+};
+
+const buildDay = (inputs: JetLagInputs, context: { offsetDifference: number; direction: TravelDirection; dailyShift: number; day: number }): JetLagDay => {
+  const progress = Math.min(Math.abs(context.offsetDifference), context.dailyShift * (context.day + 1));
+  const adjustment = context.direction === 'east' ? -progress : progress;
+  const sleep = toMinutes(inputs.sleepTime) + context.offsetDifference * 60 + adjustment * 60;
+  const wake = toMinutes(inputs.wakeTime) + context.offsetDifference * 60 + adjustment * 60;
+  let light: JetLagDay['light'] = 'none';
+  if (context.direction === 'east') light = 'morning';
+  if (context.direction === 'west') light = 'afternoon';
+  return {
+    day: context.day + 1,
+    sleep: formatTime(sleep),
+    wake: formatTime(wake),
+    breakfast: formatTime(wake + 60),
+    lunch: formatTime(wake + 5 * 60),
+    dinner: formatTime(wake + 10 * 60),
+    light,
+    shiftHours: Math.round(progress * 10) / 10,
+  };
+};
+
+export const calculateJetLagPlan = (inputs: JetLagInputs): JetLagPlan => {
+  const offsetDifference = inputs.destinationOffset - inputs.originOffset;
+  const absoluteDifference = Math.abs(offsetDifference);
+  const direction = resolveDirection(offsetDifference);
+  const daysCount = Math.max(1, Math.min(14, Math.round(inputs.days)));
+  const dailyShift = absoluteDifference === 0 ? 0 : Math.min(1, absoluteDifference / daysCount);
+  const travelHours = hoursBetween(inputs.departure, inputs.arrival);
+  const plan = Array.from({ length: daysCount }, (_, day) => buildDay(inputs, { offsetDifference, direction, dailyShift, day }));
+  const shifted = plan.at(-1)?.shiftHours ?? 0;
+  return {
+    direction,
+    offsetDifference,
+    absoluteDifference,
+    travelHours,
+    dailyShift: Math.round(dailyShift * 10) / 10,
+    targetReached: shifted >= absoluteDifference,
+    remainingHours: Math.max(0, Math.round((absoluteDifference - shifted) * 10) / 10),
+    days: plan,
+  };
+};

package/src/tool/jet-lag-recovery-planner/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { jetLagRecoveryPlanner } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await jetLagRecoveryPlanner.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}