@jjlmoya/utils-pets 1.18.0 → 1.20.0

package/src/tool/petToxicity/logic.ts

@@ -0,0 +1,192 @@
+export type PetSpecies = 'dog' | 'cat';
+export type FoodId =
+  | 'chocolate'
+  | 'xylitol'
+  | 'grapes-raisins'
+  | 'onion-garlic'
+  | 'alcohol'
+  | 'macadamia-nuts'
+  | 'yeast-dough';
+export type RiskLevel = 'critical' | 'high' | 'caution' | 'unknown';
+
+export interface SpeciesAdvice {
+  level: RiskLevel;
+  summary: string;
+  why: string;
+  signs: string[];
+  action: string;
+}
+
+export interface FoodProfile {
+  id: FoodId;
+  name: string;
+  detail: string;
+  advice: Partial<Record<PetSpecies, SpeciesAdvice>>;
+}
+
+export interface FoodOption {
+  id: FoodId;
+  name: string;
+  detail: string;
+}
+
+export interface FoodEvaluation extends SpeciesAdvice {
+  food: FoodProfile;
+  species: PetSpecies;
+}
+
+export const FOOD_CATALOG: readonly FoodProfile[] = [
+  {
+    id: 'chocolate',
+    name: 'Chocolate and caffeine',
+    detail: 'Chocolate, coffee, tea, energy drinks',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Methylxanthines can affect the heart and nervous system.',
+        why: 'Cocoa products contain theobromine and caffeine. Dark chocolate, baking chocolate, cocoa powder, and concentrated drinks are more concerning than milk chocolate, but the product, amount, and body weight all matter.',
+        signs: ['Vomiting or diarrhea', 'Restlessness or rapid heartbeat', 'Tremors or seizures'],
+        action: 'Call a veterinarian or animal poison service promptly. Keep the package and note the type, amount, and time eaten.',
+      },
+      cat: {
+        level: 'high',
+        summary: 'Caffeine and cocoa compounds can disturb the heart and nervous system.',
+        why: 'Cats can be affected by methylxanthines in chocolate and caffeinated drinks. A cat may eat less than a dog, but a small amount is not a reason to guess at safety.',
+        signs: ['Vomiting or diarrhea', 'Agitation or fast breathing', 'Tremors or seizures'],
+        action: 'Call your veterinarian or an animal poison service promptly with the product label and estimated amount.',
+      },
+    },
+  },
+  {
+    id: 'xylitol',
+    name: 'Xylitol',
+    detail: 'Sugar-free gum, sweets, baked goods, some nut butters',
+    advice: {
+      dog: {
+        level: 'critical',
+        summary: 'Xylitol can cause a rapid, dangerous fall in blood sugar in dogs.',
+        why: 'Xylitol is used in some sugar-free foods and personal-care products. In dogs it can trigger a potent insulin release, and serious effects may appear quickly or be delayed.',
+        signs: ['Vomiting or marked sleepiness', 'Weakness, staggering, or collapse', 'Shaking, seizures, or bleeding problems'],
+        action: 'Treat this as an emergency. Call a veterinarian, emergency clinic, or animal poison service immediately and take the product packaging.',
+      },
+      cat: {
+        level: 'caution',
+        summary: 'Xylitol is not considered as dangerous to cats as it is to dogs, but a product exposure still needs context.',
+        why: 'Available FDA guidance describes a much clearer danger for dogs. Do not turn that difference into a safety guarantee because the product may contain other hazards and the amount may be unknown.',
+        signs: ['Vomiting or unusual tiredness', 'Weakness or poor coordination', 'Any sudden change after eating a product'],
+        action: 'Call your veterinarian with the ingredient list and product amount instead of waiting for signs.',
+      },
+    },
+  },
+  {
+    id: 'grapes-raisins',
+    name: 'Grapes and raisins',
+    detail: 'Fresh grapes, raisins, sultanas, baked goods',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Exposure can damage the kidneys, and the risky amount is not reliably predictable at home.',
+        why: 'Veterinary poison-control guidance links grapes and raisins with kidney injury in dogs. Individual sensitivity varies, so a seemingly small amount should not be dismissed.',
+        signs: ['Vomiting or diarrhea', 'Lethargy or loss of appetite', 'Changes in drinking or urination'],
+        action: 'Call a veterinarian or animal poison service promptly, even if your dog looks normal. Note the food, amount, and time.',
+      },
+      cat: {
+        level: 'caution',
+        summary: 'Do not offer grapes or raisins to cats, and ask a veterinarian about any known exposure.',
+        why: 'The clearest documented kidney-risk pattern is in dogs, while cat-specific evidence is less established. Uncertainty is not the same as proof of safety.',
+        signs: ['Vomiting or diarrhea', 'Unusual tiredness or loss of appetite', 'Changes in drinking or urination'],
+        action: 'Call your veterinarian with the food, amount, and time rather than waiting for a symptom-based answer.',
+      },
+    },
+  },
+  {
+    id: 'onion-garlic',
+    name: 'Onion, garlic and chives',
+    detail: 'Raw, cooked, dried, powdered, sauces and soup mixes',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Allium plants can damage red blood cells and cause anemia.',
+        why: 'Onion, garlic, chives, and leeks can be harmful in raw, cooked, dehydrated, or concentrated forms. Powdered ingredients and soup mixes can hide a meaningful exposure.',
+        signs: ['Vomiting or diarrhea', 'Weakness, pale gums, or fast breathing', 'Dark urine, collapse, or marked tiredness'],
+        action: 'Call a veterinarian for exposure guidance. Do not wait for anemia signs, which may appear days after ingestion.',
+      },
+      cat: {
+        level: 'critical',
+        summary: 'Cats are especially susceptible to red blood cell damage from allium plants.',
+        why: 'Veterinary toxicology references identify cats as the most susceptible common companion species. Concentrated flakes, powders, and soup mixes deserve particular caution.',
+        signs: ['Weakness or pale gums', 'Fast breathing or dark urine', 'Collapse or severe tiredness'],
+        action: 'Call a veterinarian promptly for any known exposure, even when the cat seems well. Delayed signs are possible.',
+      },
+    },
+  },
+  {
+    id: 'alcohol',
+    name: 'Alcohol',
+    detail: 'Drinks, extracts, desserts and fermented mixtures',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Alcohol can depress the nervous system and affect breathing and blood chemistry.',
+        why: 'Pets are much smaller than people and may ingest concentrated drinks, extracts, or alcohol-containing foods without an adult realizing how much they received.',
+        signs: ['Vomiting or diarrhea', 'Poor coordination or unusual sleepiness', 'Slow breathing, tremors, or collapse'],
+        action: 'Call a veterinarian or emergency clinic promptly and keep the container available for identification.',
+      },
+      cat: {
+        level: 'high',
+        summary: 'Alcohol can depress the nervous system and affect breathing in cats.',
+        why: 'Alcohol-containing drinks, extracts, and desserts are not suitable pet treats. The concentration and amount matter, and a cat can deteriorate quickly.',
+        signs: ['Vomiting or diarrhea', 'Poor coordination or unusual sleepiness', 'Slow breathing, tremors, or collapse'],
+        action: 'Call a veterinarian or emergency clinic promptly with the product and estimated amount.',
+      },
+    },
+  },
+  {
+    id: 'macadamia-nuts',
+    name: 'Macadamia nuts',
+    detail: 'Whole nuts, cookies, nut mixes and spreads',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Macadamia nuts can cause weakness, incoordination, vomiting, and tremors in dogs.',
+        why: 'The toxic mechanism is not fully understood, but dogs can become ill after eating macadamia nuts. Fat-rich recipes may add a separate digestive risk.',
+        signs: ['Weakness or difficulty walking', 'Vomiting or depression', 'Tremors or overheating'],
+        action: 'Call your veterinarian for exposure guidance and keep the product packaging.',
+      },
+    },
+  },
+  {
+    id: 'yeast-dough',
+    name: 'Raw yeast dough',
+    detail: 'Bread dough, pizza dough and rising dough',
+    advice: {
+      dog: {
+        level: 'high',
+        summary: 'Rising dough can expand in the stomach and produce alcohol.',
+        why: 'Raw yeast dough can continue fermenting after ingestion. Expansion and alcohol production can create a dangerous combination that needs veterinary advice.',
+        signs: ['A swollen or painful abdomen', 'Unsteady behavior or unusual sleepiness', 'Repeated retching or collapse'],
+        action: 'Call a veterinarian or emergency clinic promptly. Do not wait to see whether the dough finishes rising.',
+      },
+      cat: {
+        level: 'high',
+        summary: 'Raw yeast dough can expand and ferment inside a cat.',
+        why: 'Rising dough can create abdominal distension and alcohol exposure. The risk depends on the dough and amount, so a professional should assess it.',
+        signs: ['A swollen or painful abdomen', 'Unsteady behavior or unusual sleepiness', 'Repeated retching or collapse'],
+        action: 'Call a veterinarian or emergency clinic promptly and keep the recipe or packaging available.',
+      },
+    },
+  },
+];
+
+export function getFoodOptions(species: PetSpecies): FoodOption[] {
+  return FOOD_CATALOG
+    .filter((food) => Boolean(food.advice[species]))
+    .map(({ id, name, detail }) => ({ id, name, detail }));
+}
+
+export function getFoodEvaluation(species: PetSpecies, foodId: string): FoodEvaluation | null {
+  const food = FOOD_CATALOG.find((candidate) => candidate.id === foodId);
+  const advice = food?.advice[species];
+  if (!food || !advice) return null;
+  return { ...advice, food, species };
+}

package/src/tool/petToxicity/pet-food-toxicity-checker.css

@@ -0,0 +1,450 @@
+:root {
+  --n-paper: #f8f4ea;
+  --n-surface: #fffdf7;
+  --n-ink: #22241f;
+  --n-muted: #686c61;
+  --n-line: #d8d4c8;
+  --n-accent: #cb3d2f;
+  --n-accent-dark: #8e201b;
+  --n-yellow: #e5aa31;
+  --n-green: #3b7561;
+  --n-shadow: #b8b1a1;
+}
+
+.theme-dark {
+  --n-paper: #20231f;
+  --n-surface: #2a2e28;
+  --n-ink: #f2eee3;
+  --n-muted: #b9b8aa;
+  --n-line: #52584e;
+  --n-accent: #f07c68;
+  --n-accent-dark: #ffad93;
+  --n-yellow: #edc35b;
+  --n-green: #84c8a7;
+  --n-shadow: #11130f;
+}
+
+.pet-toxicity {
+  --n-card: var(--n-surface);
+  --n-card-strong: var(--n-paper);
+  --n-danger-surface: #f7dfd6;
+  --n-caution-surface: #f5edcf;
+  --n-safe-surface: #dbece1;
+
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  box-sizing: border-box;
+  border-radius: 1.25rem;
+  box-shadow: 0.4rem 0.4rem 0 var(--n-shadow);
+  color: var(--n-ink);
+  max-width: 70rem;
+  min-width: 0;
+  overflow: visible;
+  padding: clamp(1rem, 3vw, 2rem);
+}
+
+.theme-dark .pet-toxicity {
+  --n-danger-surface: #512d2a;
+  --n-caution-surface: #4d4021;
+  --n-safe-surface: #244035;
+}
+
+.pet-toxicity-journey {
+  align-items: center;
+  border-bottom: 1px solid var(--n-line);
+  display: flex;
+  gap: 0.75rem;
+  margin-bottom: 1.25rem;
+  padding-bottom: 1.25rem;
+}
+
+.pet-toxicity-journey p {
+  margin: 0;
+  max-width: 52rem;
+}
+
+.pet-toxicity-journey-mark {
+  align-items: center;
+  background: var(--n-accent);
+  border: 2px solid var(--n-ink);
+  border-radius: 50%;
+  color: var(--n-surface);
+  display: inline-flex;
+  flex: 0 0 2rem;
+  font-size: 1.25rem;
+  font-weight: 800;
+  height: 2rem;
+  justify-content: center;
+  width: 2rem;
+}
+
+.pet-toxicity-workbench {
+  align-items: stretch;
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: minmax(15rem, 0.7fr) minmax(20rem, 1.3fr);
+}
+
+.pet-toxicity-controls {
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 1rem;
+  display: grid;
+  gap: 1rem;
+  padding: 1rem;
+}
+
+.pet-toxicity-control {
+  display: grid;
+  gap: 0.45rem;
+}
+
+.pet-toxicity-label,
+.pet-toxicity-eyebrow {
+  color: var(--n-muted);
+  display: block;
+  font-size: 0.72rem;
+  font-weight: 800;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.pet-toxicity-select {
+  position: relative;
+}
+
+.pet-toxicity-select-trigger {
+  align-items: center;
+  background: var(--n-card-strong);
+  border: 1px solid var(--n-line);
+  border-radius: 0.7rem;
+  color: var(--n-ink);
+  cursor: pointer;
+  display: flex;
+  font: inherit;
+  font-weight: 700;
+  justify-content: space-between;
+  min-height: 3.2rem;
+  padding: 0.7rem 0.8rem;
+  text-align: left;
+  width: 100%;
+}
+
+.pet-toxicity-select-trigger:focus-visible,
+.pet-toxicity-menu-option:focus-visible {
+  outline: 3px solid var(--n-yellow);
+  outline-offset: 2px;
+}
+
+.pet-toxicity-chevron {
+  border-bottom: 2px solid currentcolor;
+  border-right: 2px solid currentcolor;
+  height: 0.55rem;
+  transform: rotate(45deg) translateY(-0.15rem);
+  width: 0.55rem;
+}
+
+.pet-toxicity-menu {
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 0.7rem;
+  box-shadow: 0.25rem 0.25rem 0 var(--n-shadow);
+  display: grid;
+  gap: 0.25rem;
+  left: 0;
+  max-height: 18rem;
+  overflow-y: auto;
+  padding: 0.35rem;
+  position: absolute;
+  right: 0;
+  top: calc(100% + 0.4rem);
+  z-index: 3;
+}
+
+.pet-toxicity-menu[hidden] {
+  display: none;
+}
+
+.pet-toxicity-menu-option {
+  background: transparent;
+  border: 0;
+  border-radius: 0.5rem;
+  color: var(--n-ink);
+  cursor: pointer;
+  display: grid;
+  gap: 0.2rem;
+  padding: 0.65rem;
+  text-align: left;
+}
+
+.pet-toxicity-menu-option:hover,
+.pet-toxicity-menu-option[data-selected="true"] {
+  background: var(--n-danger-surface);
+}
+
+.pet-toxicity-menu-option small,
+.pet-toxicity-hint {
+  color: var(--n-muted);
+  font-size: 0.78rem;
+}
+
+.pet-toxicity-hint {
+  line-height: 1.4;
+}
+
+.pet-toxicity-visual {
+  min-width: 0;
+}
+
+.pet-toxicity-scene-card {
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 1rem;
+  display: grid;
+  grid-template-rows: auto auto;
+  overflow: hidden;
+}
+
+.pet-toxicity-scene-copy {
+  display: grid;
+  gap: 0.3rem;
+  min-width: 0;
+  padding: 1rem 1rem 0.75rem;
+}
+
+.pet-toxicity-scene-copy strong {
+  font-size: clamp(1.3rem, 3vw, 2rem);
+  overflow-wrap: anywhere;
+}
+
+.pet-toxicity-scene-copy span:last-child {
+  color: var(--n-muted);
+  font-size: 0.85rem;
+}
+
+.pet-toxicity-scene {
+  display: block;
+  height: clamp(12rem, 23vw, 16rem);
+  width: 100%;
+}
+
+.pet-toxicity-scene-paper {
+  fill: var(--n-card-strong);
+  stroke: var(--n-line);
+  stroke-width: 1;
+}
+
+.pet-toxicity-scene-line {
+  fill: none;
+  stroke: var(--n-accent);
+  stroke-linecap: round;
+  stroke-width: 3;
+}
+
+.pet-toxicity-scene-line-thin {
+  opacity: 0.55;
+  stroke: var(--n-green);
+  stroke-width: 2;
+}
+
+.pet-toxicity-marker {
+  fill: var(--n-accent);
+  stroke: var(--n-card);
+  stroke-width: 3;
+}
+
+.pet-toxicity-marker-critical { fill: var(--n-accent-dark); }
+.pet-toxicity-marker-caution { fill: var(--n-yellow); }
+.pet-toxicity-marker-empty { fill: var(--n-line); }
+
+.pet-toxicity-scene-seal {
+  fill: var(--n-accent);
+  stroke: var(--n-ink);
+  stroke-width: 2;
+}
+
+.pet-toxicity-scene-seal-mark {
+  fill: none;
+  stroke: var(--n-surface);
+  stroke-linecap: round;
+  stroke-width: 2;
+}
+
+.pet-toxicity-scene-seal-dot {
+  fill: var(--n-surface);
+}
+
+.pet-toxicity-result {
+  margin-top: 1rem;
+}
+
+.pet-toxicity-result-card,
+.pet-toxicity-result-empty,
+.pet-toxicity-emergency,
+.pet-toxicity-sources {
+  background: var(--n-card);
+  border: 1px solid var(--n-line);
+  border-radius: 1rem;
+  padding: clamp(1rem, 2.5vw, 1.5rem);
+}
+
+.pet-toxicity-result-card-critical,
+.pet-toxicity-result-card-high {
+  border-top: 0.35rem solid var(--n-accent);
+}
+.pet-toxicity-result-card-caution { border-top: 0.35rem solid var(--n-yellow); }
+
+.pet-toxicity-result-head {
+  align-items: center;
+  display: flex;
+  gap: 0.75rem;
+  justify-content: space-between;
+}
+
+.pet-toxicity-risk-status {
+  align-items: end;
+  display: grid;
+  gap: 0.35rem;
+  justify-items: end;
+}
+
+.pet-toxicity-risk {
+  border-radius: 2rem;
+  font-size: 0.75rem;
+  font-weight: 800;
+  padding: 0.35rem 0.6rem;
+  text-transform: uppercase;
+}
+
+.pet-toxicity-risk-critical,
+.pet-toxicity-risk-high {
+  background: var(--n-danger-surface);
+  color: var(--n-accent-dark);
+}
+.pet-toxicity-risk-caution {
+  background: var(--n-caution-surface);
+  color: var(--n-ink);
+}
+
+.pet-toxicity-risk-meter {
+  display: flex;
+  gap: 0.2rem;
+}
+
+.pet-toxicity-risk-meter span {
+  background: var(--n-line);
+  border-radius: 99px;
+  height: 0.28rem;
+  width: 1.25rem;
+}
+
+.pet-toxicity-risk-meter span.is-active {
+  background: var(--n-accent);
+}
+
+.pet-toxicity-result-card-caution .pet-toxicity-risk-meter span.is-active {
+  background: var(--n-yellow);
+}
+
+.pet-toxicity-result-card h3 {
+  font-size: clamp(1.4rem, 3vw, 2rem);
+  margin: 0.7rem 0 0.3rem;
+}
+
+.pet-toxicity-summary {
+  font-size: 1.05rem;
+  margin: 0;
+}
+
+.pet-toxicity-result-grid {
+  border-top: 1px solid var(--n-line);
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  margin-top: 1.25rem;
+  padding-top: 1.25rem;
+}
+
+.pet-toxicity-result-grid p { margin: 0.45rem 0 0; }
+
+.pet-toxicity-sign-list {
+  display: grid;
+  gap: 0.45rem;
+  list-style: none;
+  margin: 0.45rem 0 0;
+  padding: 0;
+}
+
+.pet-toxicity-sign-list li {
+  align-items: center;
+  background: var(--n-card-strong);
+  border: 1px solid var(--n-line);
+  border-radius: 0.65rem;
+  display: flex;
+  gap: 0.55rem;
+  min-height: 2.35rem;
+  padding: 0.4rem 0.55rem;
+}
+
+.pet-toxicity-sign-icon {
+  align-items: center;
+  background: var(--n-danger-surface);
+  border-radius: 50%;
+  color: var(--n-accent-dark);
+  display: inline-flex;
+  flex: 0 0 1.55rem;
+  height: 1.55rem;
+  justify-content: center;
+  width: 1.55rem;
+}
+
+.pet-toxicity-sign-icon svg {
+  fill: none;
+  height: 1rem;
+  stroke: currentcolor;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+  stroke-width: 1.5;
+  width: 1rem;
+}
+
+.pet-toxicity-sign-icon circle {
+  fill: currentcolor;
+  stroke: none;
+}
+.pet-toxicity-action { grid-column: 1 / -1; }
+
+.pet-toxicity-callout,
+.pet-toxicity-emergency {
+  display: grid;
+  gap: 0.35rem;
+  margin-top: 1rem;
+}
+
+.pet-toxicity-callout {
+  background: var(--n-danger-surface);
+  border-radius: 0.7rem;
+  padding: 0.8rem;
+}
+.pet-toxicity-emergency {
+  background: var(--n-danger-surface);
+  border-color: var(--n-accent);
+}
+.pet-toxicity-emergency strong { color: var(--n-accent-dark); }
+
+.pet-toxicity-sources { margin-top: 1rem; }
+.pet-toxicity-sources p { margin: 0.45rem 0 0; }
+
+@media (max-width: 48rem) {
+  .pet-toxicity {
+    max-width: calc(100vw - 3rem);
+    width: calc(100vw - 3rem);
+  }
+
+  .pet-toxicity-workbench,
+  .pet-toxicity-result-grid { grid-template-columns: 1fr; }
+  .pet-toxicity-action { grid-column: auto; }
+
+  .pet-toxicity-result-head { align-items: start; }
+  .pet-toxicity-risk-status { flex: 0 0 auto; }
+}

package/src/tool/petToxicity/seo.astro

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

package/src/tool/petToxicity/storage.ts

@@ -0,0 +1,37 @@
+import type { FoodId, PetSpecies } from './logic';
+
+interface SavedState {
+  species: PetSpecies;
+  foodId: FoodId;
+}
+
+const STORAGE_KEY = 'jjlmoya-pet-toxicity-state';
+
+function isSpecies(value: unknown): value is PetSpecies {
+  return value === 'dog' || value === 'cat';
+}
+
+function isSavedState(value: unknown): value is SavedState {
+  if (!value || typeof value !== 'object') return false;
+  const record = value as Record<string, unknown>;
+  return isSpecies(record.species) && typeof record.foodId === 'string';
+}
+
+export function loadSavedState(): SavedState | null {
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed: unknown = JSON.parse(raw);
+    return isSavedState(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+export function saveState(state: SavedState): void {
+  try {
+    window.localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+  } catch {
+    return;
+  }
+}