@jjlmoya/utils-pets 1.16.0 → 1.18.0

package/src/tool/petGestation/logic.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest';
+import {
+  calculateGestation,
+  formatDateInput,
+  getDateOffset,
+  GESTATION_PROFILES,
+} from './logic';
+
+const today = new Date(2026, 7, 24);
+
+describe('pet gestation logic', () => {
+  it('keeps documented species profiles', () => {
+    expect(GESTATION_PROFILES.dog).toEqual({ minDays: 58, typicalDays: 63, maxDays: 72 });
+    expect(GESTATION_PROFILES.cat.typicalDays).toBe(65);
+    expect(GESTATION_PROFILES.rabbit.typicalDays).toBe(31);
+    expect(GESTATION_PROFILES.ferret.typicalDays).toBe(42);
+  });
+
+  it('calculates a dog window and progress before the due date', () => {
+    const result = calculateGestation({ species: 'dog', matingDate: '2026-07-01', today });
+    expect(result.windowStart).toBe('2026-08-28');
+    expect(result.dueDate).toBe('2026-09-02');
+    expect(result.windowEnd).toBe('2026-09-11');
+    expect(result.elapsedDays).toBe(54);
+    expect(result.remainingDays).toBe(9);
+    expect(result.state).toBe('waiting');
+    expect(result.progress).toBeCloseTo(54 / 63);
+  });
+
+  it('reports future, due window, and late states', () => {
+    expect(calculateGestation({ species: 'cat', matingDate: '2026-09-01', today }).state).toBe('future');
+    expect(calculateGestation({ species: 'cat', matingDate: '2026-06-20', today }).state).toBe('window');
+    expect(calculateGestation({ species: 'rabbit', matingDate: '2026-06-01', today }).state).toBe('late');
+  });
+
+  it('normalizes local dates for presets', () => {
+    expect(formatDateInput(today)).toBe('2026-08-24');
+    expect(getDateOffset(-7, today)).toBe('2026-08-17');
+  });
+
+  it('rejects impossible calendar dates', () => {
+    expect(() => calculateGestation({ species: 'dog', matingDate: '2026-02-30', today })).toThrow('Invalid date');
+  });
+});

package/src/tool/petGestation/logic.ts

@@ -0,0 +1,103 @@
+export type GestationSpecies = 'dog' | 'cat' | 'rabbit' | 'ferret';
+
+export interface GestationProfile {
+  minDays: number;
+  typicalDays: number;
+  maxDays: number;
+}
+
+export interface GestationInput {
+  species: GestationSpecies;
+  matingDate: string;
+  today?: Date;
+}
+
+export interface GestationResult {
+  species: GestationSpecies;
+  matingDate: string;
+  windowStart: string;
+  dueDate: string;
+  windowEnd: string;
+  elapsedDays: number;
+  remainingDays: number;
+  progress: number;
+  state: 'future' | 'waiting' | 'window' | 'late';
+}
+
+export const GESTATION_PROFILES: Record<GestationSpecies, GestationProfile> = {
+  dog: { minDays: 58, typicalDays: 63, maxDays: 72 },
+  cat: { minDays: 64, typicalDays: 65, maxDays: 66 },
+  rabbit: { minDays: 31, typicalDays: 31, maxDays: 31 },
+  ferret: { minDays: 42, typicalDays: 42, maxDays: 42 },
+};
+
+function parseDateParts(value: string): [number, number, number] {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!match) throw new Error('Invalid date');
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  return [year, month, day];
+}
+
+function parseDate(value: string): Date {
+  const [year, month, day] = parseDateParts(value);
+  const date = new Date(Date.UTC(year, month - 1, day));
+  const valid = Number.isFinite(year) && Number.isFinite(month) && Number.isFinite(day)
+    && date.getUTCFullYear() === year
+    && date.getUTCMonth() === month - 1
+    && date.getUTCDate() === day;
+  if (!valid) throw new Error('Invalid date');
+  return date;
+}
+
+function toISODate(date: Date): string {
+  return date.toISOString().slice(0, 10);
+}
+
+function addDays(date: Date, days: number): Date {
+  const result = new Date(date.getTime());
+  result.setUTCDate(result.getUTCDate() + days);
+  return result;
+}
+
+function startOfUTCDate(date: Date): Date {
+  return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+}
+
+function differenceInDays(later: Date, earlier: Date): number {
+  return Math.round((later.getTime() - earlier.getTime()) / 86400000);
+}
+
+function getState(elapsedDays: number, profile: GestationProfile): GestationResult['state'] {
+  if (elapsedDays < 0) return 'future';
+  if (elapsedDays < profile.minDays) return 'waiting';
+  if (elapsedDays <= profile.maxDays) return 'window';
+  return 'late';
+}
+
+export function calculateGestation({ species, matingDate, today = new Date() }: GestationInput): GestationResult {
+  const start = parseDate(matingDate);
+  const profile = GESTATION_PROFILES[species];
+  const todayDate = startOfUTCDate(today);
+  const elapsedDays = differenceInDays(todayDate, start);
+  return {
+    species,
+    matingDate,
+    windowStart: toISODate(addDays(start, profile.minDays)),
+    dueDate: toISODate(addDays(start, profile.typicalDays)),
+    windowEnd: toISODate(addDays(start, profile.maxDays)),
+    elapsedDays,
+    remainingDays: profile.typicalDays - elapsedDays,
+    progress: Math.max(0, Math.min(1, elapsedDays / profile.typicalDays)),
+    state: getState(elapsedDays, profile),
+  };
+}
+
+export function formatDateInput(date: Date): string {
+  return toISODate(startOfUTCDate(date));
+}
+
+export function getDateOffset(offset: number, today = new Date()): string {
+  return formatDateInput(addDays(startOfUTCDate(today), offset));
+}

package/src/tool/petGestation/pet-gestation-calculator.css

@@ -0,0 +1,401 @@
+:root {
+  --n-ink: #1d2a27;
+  --n-muted: #61726c;
+  --n-paper: #f3efe6;
+  --n-card: #fffdf8;
+  --n-line: #d5ddd4;
+  --n-moss: #3d755f;
+  --n-moss-deep: #245243;
+  --n-sun: #db9c3f;
+  --n-sky: #a9cbc0;
+  --n-alert: #ae5848;
+}
+
+.theme-dark {
+  --n-ink: #eff6f0;
+  --n-muted: #b7c9bf;
+  --n-paper: #17211e;
+  --n-card: #22302b;
+  --n-line: #3a4a42;
+  --n-moss: #8bc4a8;
+  --n-moss-deep: #c7ead4;
+  --n-sun: #f0c36b;
+  --n-sky: #4b7165;
+  --n-alert: #ef907d;
+}
+
+.pet-gestation-tool {
+  --n-shadow: 0 1.5rem 4rem rgba(30, 58, 47, 0.12);
+
+  color: var(--n-ink);
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: 2rem;
+  padding: clamp(1rem, 3vw, 2rem);
+  box-shadow: var(--n-shadow);
+}
+
+.gestation-tool-intro {
+  display: grid;
+  grid-template-columns: minmax(0, 1.2fr) minmax(12rem, 0.8fr);
+  gap: 1rem;
+  align-items: end;
+  margin-bottom: 1.5rem;
+}
+
+.gestation-journey,
+.gestation-instant-hint,
+.gestation-source-note,
+.gestation-note,
+.gestation-date-block > span,
+.gestation-status-detail {
+  color: var(--n-muted);
+}
+
+.gestation-journey,
+.gestation-instant-hint {
+  margin: 0;
+}
+
+.gestation-journey {
+  max-width: 42rem;
+  font-size: 1.05rem;
+}
+
+.gestation-instant-hint {
+  padding: 0.75rem 1rem;
+  border-left: 3px solid var(--n-sun);
+  font-size: 0.88rem;
+}
+
+.gestation-form {
+  display: grid;
+  gap: 1.25rem;
+}
+
+.gestation-species-fieldset {
+  border: 0;
+  padding: 0;
+  margin: 0;
+}
+
+.gestation-species-fieldset legend,
+.gestation-date-block label {
+  display: block;
+  font-weight: 800;
+  margin-bottom: 0.65rem;
+}
+
+.gestation-species-grid {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 0.65rem;
+}
+
+.gestation-species-grid button,
+.gestation-presets button {
+  font: inherit;
+  color: var(--n-ink);
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  cursor: pointer;
+}
+
+.gestation-species-grid button {
+  display: grid;
+  justify-items: start;
+  gap: 0.2rem;
+  min-height: 7rem;
+  padding: 0.85rem 0.9rem;
+  border-radius: 1.2rem;
+  text-align: left;
+  transition: transform 160ms ease, border-color 160ms ease, background 160ms ease;
+}
+
+.gestation-species-grid button:hover,
+.gestation-species-grid button:focus-visible {
+  border-color: var(--n-moss);
+  transform: translateY(-2px);
+}
+
+.gestation-species-grid button svg {
+  margin-bottom: 0.25rem;
+  color: var(--n-moss);
+  font-size: 1.6rem;
+}
+
+.gestation-species-grid button span {
+  font-weight: 800;
+}
+
+.gestation-species-grid button small {
+  color: var(--n-muted);
+  font-size: 0.76rem;
+}
+
+.gestation-species-grid button.is-active {
+  border-color: var(--n-moss);
+  background: var(--n-sky);
+  box-shadow: inset 0 0 0 2px var(--n-moss);
+  transform: translateY(-2px);
+}
+
+.gestation-date-block {
+  display: grid;
+  gap: 0.45rem;
+}
+
+.gestation-date-block input {
+  min-height: 3.4rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--n-line);
+  border-radius: 1rem;
+  color: var(--n-ink);
+  background: var(--n-card);
+  font: inherit;
+  font-size: 1.05rem;
+}
+
+.gestation-date-block input:focus-visible {
+  border-color: var(--n-moss);
+  outline: 3px solid color-mix(in srgb, var(--n-moss) 25%, transparent);
+}
+
+.gestation-presets {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-top: 0.25rem;
+}
+
+.gestation-presets button {
+  padding: 0.45rem 0.75rem;
+  border-radius: 999px;
+  font-size: 0.9rem;
+}
+
+.gestation-presets button:hover,
+.gestation-presets button:focus-visible {
+  border-color: var(--n-moss);
+  color: var(--n-moss-deep);
+}
+
+.gestation-error {
+  min-height: 1.25rem;
+  margin: 0;
+  color: var(--n-alert);
+}
+
+.gestation-result {
+  position: relative;
+  display: grid;
+  grid-template-columns: minmax(15rem, 0.9fr) minmax(0, 1.1fr);
+  gap: clamp(1rem, 4vw, 3rem);
+  align-items: center;
+  margin-top: 1.5rem;
+  padding: clamp(1.2rem, 3vw, 2rem);
+  overflow: hidden;
+  border: 1px solid var(--n-line);
+  border-radius: 1.5rem;
+  background: var(--n-card);
+}
+
+.gestation-result-ribbon {
+  position: absolute;
+  top: 0;
+  right: 0;
+  padding: 0.45rem 0.75rem;
+  border-bottom-left-radius: 0.75rem;
+  color: var(--n-moss-deep);
+  background: var(--n-sky);
+  font-size: 0.72rem;
+  font-weight: 800;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.gestation-scene {
+  min-height: 14rem;
+  display: grid;
+  place-items: center;
+}
+
+.gestation-scene-placeholder {
+  color: var(--n-muted);
+  text-align: center;
+}
+
+.gestation-nest-scene {
+  display: block;
+  width: min(100%, 22rem);
+  overflow: visible;
+}
+
+.scene-reed {
+  fill: none;
+  stroke: var(--n-moss);
+  stroke-linecap: round;
+  stroke-width: 4;
+}
+
+.scene-window {
+  fill: color-mix(in srgb, var(--n-sun) 20%, transparent);
+  stroke: var(--n-sun);
+  stroke-width: 1.5;
+}
+
+.scene-marker-ring {
+  fill: none;
+  stroke: var(--n-sun);
+  stroke-dasharray: 2 3;
+  stroke-width: 2;
+}
+
+.scene-marker {
+  fill: var(--n-sun);
+  stroke: var(--n-card);
+  stroke-width: 3;
+}
+
+.scene-nest {
+  fill: var(--n-moss-deep);
+}
+
+.scene-nest-line {
+  fill: none;
+  stroke: var(--n-sun);
+  stroke-linecap: round;
+  stroke-width: 2;
+}
+
+.scene-egg {
+  fill: var(--n-paper);
+  stroke: var(--n-sun);
+  stroke-width: 2;
+}
+
+.scene-label,
+.scene-day,
+.scene-caption {
+  text-anchor: middle;
+  fill: var(--n-ink);
+}
+
+.scene-label,
+.scene-caption {
+  font-size: 0.58rem;
+}
+
+.scene-label {
+  fill: var(--n-muted);
+  letter-spacing: 0.08em;
+}
+
+.scene-label-accent {
+  fill: var(--n-moss-deep);
+}
+
+.scene-label-right {
+  text-anchor: start;
+}
+
+.scene-day {
+  font-size: 1.7rem;
+  font-weight: 800;
+}
+
+.scene-caption {
+  fill: var(--n-muted);
+}
+
+.gestation-eyebrow {
+  margin: 0;
+  color: var(--n-moss-deep);
+  font-size: 0.78rem;
+  font-weight: 800;
+  letter-spacing: 0.11em;
+  text-transform: uppercase;
+}
+
+.gestation-status {
+  margin: 0.45rem 0 0.15rem;
+  font-size: clamp(1.35rem, 4vw, 2.1rem);
+  font-weight: 800;
+}
+
+.gestation-status[data-tone="late"] {
+  color: var(--n-alert);
+}
+
+.gestation-status[data-tone="ready"] {
+  color: var(--n-moss-deep);
+}
+
+.gestation-status-detail {
+  margin: 0 0 1.25rem;
+}
+
+.gestation-facts {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 0.8rem;
+}
+
+.gestation-facts div {
+  display: grid;
+  gap: 0.25rem;
+  padding-top: 0.65rem;
+  border-top: 1px solid var(--n-line);
+}
+
+.gestation-facts span {
+  color: var(--n-muted);
+  font-size: 0.78rem;
+}
+
+.gestation-facts strong {
+  font-size: 0.98rem;
+}
+
+.gestation-note {
+  display: grid;
+  gap: 0.25rem;
+  margin-top: 1.25rem;
+  padding: 1rem 1.15rem;
+  border-left: 4px solid var(--n-sun);
+  background: color-mix(in srgb, var(--n-sun) 12%, var(--n-card));
+}
+
+.gestation-note strong {
+  color: var(--n-ink);
+}
+
+.gestation-source-note {
+  margin: 1rem 0 0;
+  font-size: 0.83rem;
+}
+
+@media (max-width: 760px) {
+  .gestation-tool-intro,
+  .gestation-result {
+    grid-template-columns: 1fr;
+  }
+
+  .gestation-instant-hint {
+    max-width: 32rem;
+  }
+}
+
+@media (max-width: 520px) {
+  .gestation-species-grid {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .gestation-result {
+    padding-top: 2.5rem;
+  }
+
+  .gestation-scene {
+    min-height: 12rem;
+  }
+}

package/src/tool/petGestation/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { petGestation } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const content = await petGestation.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/petGestation/storage.ts

@@ -0,0 +1,25 @@
+import type { GestationSpecies } from './logic';
+
+const STORAGE_KEY = 'jjlmoya-pet-gestation';
+
+export interface GestationStorageState {
+  species: GestationSpecies;
+  matingDate: string;
+}
+
+export function loadGestationState(): Partial<GestationStorageState> {
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY);
+    if (!raw) return {};
+    const value = JSON.parse(raw) as Partial<GestationStorageState>;
+    return value;
+  } catch {
+    return {};
+  }
+}
+
+export function saveGestationState(state: GestationStorageState): void {
+  try {
+    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+  } catch {}
+}

package/src/tool/petGestation/ui.ts

@@ -0,0 +1,42 @@
+export interface PetGestationUI {
+  [key: string]: string;
+  journeyHint: string;
+  instantHint: string;
+  speciesLegend: string;
+  speciesDog: string;
+  speciesCat: string;
+  speciesRabbit: string;
+  speciesFerret: string;
+  speciesDogMeta: string;
+  speciesCatMeta: string;
+  speciesRabbitMeta: string;
+  speciesFerretMeta: string;
+  matingDateLabel: string;
+  matingDateHint: string;
+  presetToday: string;
+  presetWeekAgo: string;
+  presetFortnightAgo: string;
+  calculateButton: string;
+  resultEyebrow: string;
+  dueDateLabel: string;
+  windowLabel: string;
+  remainingLabel: string;
+  elapsedLabel: string;
+  daysLabel: string;
+  dayLabel: string;
+  statusFuture: string;
+  statusWaiting: string;
+  statusWindow: string;
+  statusLate: string;
+  resultEmpty: string;
+  sampleLabel: string;
+  sceneMating: string;
+  sceneToday: string;
+  sceneDue: string;
+  noteTitle: string;
+  noteText: string;
+  sourceTitle: string;
+  sourceText: string;
+  invalidDate: string;
+  futureDate: string;
+}

package/src/tool/petRation/component.astro

@@ -120,7 +120,7 @@ const { ui } = Astro.props;
 <script>
   import { getFormState, setRadioValue, setMaxWeightRange, getStoredConfig, applyPresetLogic, updateDisplay } from "./handlers";
 
-  function setupRationListeners(calculate: () => void, weightRange: HTMLInputElement, ratioRange: HTMLInputElement) {
+  function setupRationListeners(calculate: () => void, _weightRange: HTMLInputElement, ratioRange: HTMLInputElement) {
     document.getElementById("calcWrapper")?.addEventListener("input", calculate);
     document.getElementById("calcWrapper")?.addEventListener("change", calculate);
 

package/src/tool/petRation/handlers.ts

@@ -124,7 +124,7 @@ function updateStateAndUrl(state: RationState): void {
   url.searchParams.set("s", state.species);
   url.searchParams.set("st", state.stage);
   url.searchParams.set("a", state.activity);
-  url.searchParams.set("r", document.getElementById("dietRatioRange")?.value || "0");
+  url.searchParams.set("r", (document.getElementById("dietRatioRange") as HTMLInputElement)?.value || "0");
   window.history.replaceState({}, "", url.toString());
 }
 

package/src/tool/petRation/index.ts

@@ -1,3 +1,4 @@
+import type { ToolDefinition } from '../../types';
 import { petRation } from './entry';
 export * from './entry';
 export const PET_RATION_TOOL: ToolDefinition = {

package/src/tools.ts

@@ -1,15 +1,17 @@
 export { ALL_ENTRIES } from './entries';
 import { PET_AGE_TOOL } from './tool/petAge';
 import { PET_RATION_TOOL } from './tool/petRation';
+import { PET_GESTATION_TOOL } from './tool/petGestation';
 import type { ToolDefinition } from './types';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   PET_AGE_TOOL,
   PET_RATION_TOOL,
+  PET_GESTATION_TOOL,
 ];
 
 export {
   PET_AGE_TOOL,
   PET_RATION_TOOL,
+  PET_GESTATION_TOOL,
 };
-

package/src/types.ts

@@ -5,7 +5,7 @@ export type { SEOSection };
 
 export type KnownLocale =
   | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
-  | 'fr' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'fr' | 'id' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
   | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
 
 export interface FAQItem {