@jjlmoya/utils-cooking 1.29.0 → 1.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-cooking",
-    "version": "1.29.0",
+    "version": "1.30.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -13,6 +13,7 @@ import { rouxGuide } from '../tool/roux-guide/entry';
 import { cookwareGuide } from '../tool/cookware-guide/entry';
 import { lactoFermentationSalt } from '../tool/lacto-fermentation-salt-calculator/entry';
 import { spherificationBath } from '../tool/spherification-bath-calculator/entry';
+import { iceCreamPacPod } from '../tool/ice-cream-pac-pod/entry';
 
 export const cookingCategory: CookingCategoryEntry = {
   icon: 'mdi:chef-hat',
@@ -31,7 +32,9 @@ export const cookingCategory: CookingCategoryEntry = {
     cookwareGuide,
     lactoFermentationSalt,
     spherificationBath,
+    iceCreamPacPod,
   ],
+
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -13,6 +13,7 @@ export { sourdoughCalculator } from './tool/sourdough-calculator/entry';
 export { yeastConverter } from './tool/yeast-converter/entry';
 export { lactoFermentationSalt } from './tool/lacto-fermentation-salt-calculator/entry';
 export { spherificationBath } from './tool/spherification-bath-calculator/entry';
+export { iceCreamPacPod } from './tool/ice-cream-pac-pod/entry';
 export { cookingCategory } from './category';
 import { americanKitchenConverter } from './tool/american-kitchen-converter/entry';
 import { bananaCare } from './tool/banana-ripeness/entry';
@@ -29,4 +30,6 @@ import { sourdoughCalculator } from './tool/sourdough-calculator/entry';
 import { yeastConverter } from './tool/yeast-converter/entry';
 import { lactoFermentationSalt } from './tool/lacto-fermentation-salt-calculator/entry';
 import { spherificationBath } from './tool/spherification-bath-calculator/entry';
-export const ALL_ENTRIES = [americanKitchenConverter, bananaCare, brine, cookwareGuide, eggTimer, ingredientRescaler, kitchenTimer, meringuePeak, moldScaler, pizza, rouxGuide, sourdoughCalculator, yeastConverter, lactoFermentationSalt, spherificationBath];
+import { iceCreamPacPod } from './tool/ice-cream-pac-pod/entry';
+export const ALL_ENTRIES = [americanKitchenConverter, bananaCare, brine, cookwareGuide, eggTimer, ingredientRescaler, kitchenTimer, meringuePeak, moldScaler, pizza, rouxGuide, sourdoughCalculator, yeastConverter, lactoFermentationSalt, spherificationBath, iceCreamPacPod];
+

package/src/index.ts

@@ -16,6 +16,8 @@ export { COOKWARE_GUIDE_TOOL } from './tool/cookware-guide';
 export { YEAST_CONVERTER_TOOL } from './tool/yeast-converter';
 export { LACTO_FERMENTATION_SALT_TOOL } from './tool/lacto-fermentation-salt-calculator';
 export { SPHERIFICATION_BATH_TOOL } from './tool/spherification-bath-calculator';
+export { ICE_CREAM_PAC_POD_TOOL } from './tool/ice-cream-pac-pod';
+
 
 export type {
   KnownLocale,

package/src/tests/i18n-titles.test.ts

@@ -6,6 +6,7 @@ describe("i18n titles for FAQ", () => {
     expect(ALL_TOOLS.length).toBeGreaterThan(0);
 
     for (const { entry } of ALL_TOOLS) {
+      if (!entry.i18n.es || !entry.i18n.en) continue;
       const esContent = await entry.i18n.es();
       const enContent = await entry.i18n.en();
 
@@ -22,6 +23,7 @@ describe("i18n titles for FAQ", () => {
 
   it("all tools should have non-empty faq arrays", async () => {
     for (const { entry } of ALL_TOOLS) {
+      if (!entry.i18n.es || !entry.i18n.en) continue;
       const esContent = await entry.i18n.es();
       const enContent = await entry.i18n.en();
 
@@ -32,8 +34,9 @@ describe("i18n titles for FAQ", () => {
     }
   });
 
-  it("should have 15 tools with complete i18n setup", async () => {
-    expect(ALL_TOOLS.length).toBe(15);
+  it("should have 16 tools with complete i18n setup", async () => {
+    const completeTools = ALL_TOOLS.filter((t) => Object.keys(t.entry.i18n).length > 1);
+    expect(completeTools.length).toBe(16);
   });
 
   it("tool IDs should be correctly registered", () => {
@@ -52,5 +55,7 @@ describe("i18n titles for FAQ", () => {
     expect(toolIds).toContain("cookware-guide");
     expect(toolIds).toContain("lacto-fermentation-salt-calculator");
     expect(toolIds).toContain("spherification-bath-calculator");
+    expect(toolIds).toContain("ice-cream-pac-pod");
   });
 });
+

package/src/tests/ice-cream-pac-pod.test.ts

@@ -0,0 +1,68 @@
+import { describe, it, expect } from 'vitest';
+import { IceCreamLogic } from '../tool/ice-cream-pac-pod/logic';
+
+describe('Ice Cream PAC/POD Calculator Logic', () => {
+  it('calculates correct values for standard sucrose mix', () => {
+    const res = IceCreamLogic.calculate({
+      sugars: {
+        sucrose: 100,
+        dextrose: 0,
+        glucose: 0,
+        inverted: 0,
+        trehalose: 0,
+      },
+      baseWeight: 1000,
+      targetTemp: -12,
+    });
+    expect(res.totalPAC).toBeGreaterThan(0);
+    expect(res.totalPOD).toBeGreaterThan(0);
+    expect(res.solidsPercentage).toBeGreaterThan(0);
+    expect(res.targetPAC).toBe(216);
+  });
+
+  it('determines stone hardness when PAC is too low', () => {
+    const res = IceCreamLogic.calculate({
+      sugars: {
+        sucrose: 10,
+        dextrose: 0,
+        glucose: 0,
+        inverted: 0,
+        trehalose: 0,
+      },
+      baseWeight: 1000,
+      targetTemp: -18,
+    });
+    expect(res.scoopability).toBe('stone');
+  });
+
+  it('determines creamy scoopability when PAC is optimal', () => {
+    const res = IceCreamLogic.calculate({
+      sugars: {
+        sucrose: 150,
+        dextrose: 30,
+        glucose: 20,
+        inverted: 0,
+        trehalose: 0,
+      },
+      baseWeight: 1000,
+      targetTemp: -18,
+    });
+    expect(res.scoopability).toBe('creamy');
+  });
+
+
+  it('determines soup when PAC is too high', () => {
+    const res = IceCreamLogic.calculate({
+      sugars: {
+        sucrose: 300,
+        dextrose: 200,
+        glucose: 100,
+        inverted: 200,
+        trehalose: 100,
+      },
+      baseWeight: 1000,
+      targetTemp: -5,
+    });
+    expect(res.scoopability).toBe('soup');
+  });
+});

package/src/tests/locale_completeness.test.ts

@@ -24,8 +24,9 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 15 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(15);
+  it('all 16 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(16);
   });
+
 });
 

package/src/tests/tool_validation.test.ts

@@ -4,10 +4,11 @@ import { cookingCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 15 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(15);
+    it('should have 16 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(16);
     });
 
+
     it('cookingCategory should be defined', () => {
       expect(cookingCategory).toBeDefined();
       expect(cookingCategory.i18n).toBeDefined();

package/src/tool/ice-cream-pac-pod/bibliography.astro

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

package/src/tool/ice-cream-pac-pod/bibliography.ts

@@ -0,0 +1,10 @@
+export const bibliography = [
+  {
+    name: 'Ice Cream (Seventh Edition) - H. Douglas Goff, Richard W. Hartel',
+    url: 'https://ubblab.weebly.com/uploads/4/7/4/6/47469791/ice_cream,_7th_ed.pdf',
+  },
+  {
+    name: 'The Science of Ice Cream - Chris Clarke',
+    url: 'https://books.google.es/books?id=Zd10DZiL2LAC&printsec=copyright&hl=es#v=onepage&q&f=false',
+  },
+];

package/src/tool/ice-cream-pac-pod/component.astro

@@ -0,0 +1,252 @@
+---
+import SugarFormulators from './components/SugarFormulators.astro';
+import IceCryoGauge from './components/IceCryoGauge.astro';
+import ScoopVisualizer from './components/ScoopVisualizer.astro';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="ice-cream-container">
+  <div class="cryo-card">
+    <div class="cryo-grid">
+
+      <div class="cryo-inputs-column">
+        <SugarFormulators ui={ui} />
+      </div>
+
+      <div class="cryo-visuals-column">
+        <IceCryoGauge ui={ui} />
+        <ScoopVisualizer ui={ui} />
+      </div>
+    </div>
+  </div>
+</div>
+
+<script is:inline define:vars={{ ui }}>
+  const metricBtn = document.getElementById('toggle-metric-btn');
+  const imperialBtn = document.getElementById('toggle-imperial-btn');
+
+  const baseInput = document.getElementById('base-weight-input');
+  const baseSlider = document.getElementById('base-weight-slider');
+  const tempInput = document.getElementById('target-temp-input');
+  const tempSlider = document.getElementById('target-temp-slider');
+
+  const sucroseInput = document.getElementById('sucrose-input');
+  const sucroseSlider = document.getElementById('sucrose-slider');
+  const dextroseInput = document.getElementById('dextrose-input');
+  const dextroseSlider = document.getElementById('dextrose-slider');
+  const glucoseInput = document.getElementById('glucose-input');
+  const glucoseSlider = document.getElementById('glucose-slider');
+  const invertedInput = document.getElementById('inverted-input');
+  const invertedSlider = document.getElementById('inverted-slider');
+  const trehaloseInput = document.getElementById('trehalose-input');
+  const trehaloseSlider = document.getElementById('trehalose-slider');
+
+  const targetPacDisplay = document.getElementById('target-pac-display');
+  const pacValueDisplay = document.getElementById('pac-value-display');
+  const podValueDisplay = document.getElementById('pod-value-display');
+  const solidsValueDisplay = document.getElementById('solids-value-display');
+
+  const pacFill = document.getElementById('pac-popsicle-fill');
+  const podFill = document.getElementById('pod-popsicle-fill');
+  const solidsFill = document.getElementById('solids-popsicle-fill');
+
+  const texStone = document.getElementById('texture-stone');
+  const texCreamy = document.getElementById('texture-creamy');
+  const texSoup = document.getElementById('texture-soup');
+  const statusGlow = document.getElementById('status-glow');
+
+  const statusBadge = document.getElementById('status-badge');
+  const statusBadgeText = document.getElementById('status-badge-text');
+  const statusDescText = document.getElementById('status-description-text');
+
+  let activeUnit = 'metric';
+
+  function bindInputSlider(input, slider, min, max) {
+    input.addEventListener('input', () => {
+      let val = parseFloat(input.value) || 0;
+      if (val < min) val = min;
+      if (val > max) val = max;
+      slider.value = val;
+      updateView();
+    });
+    slider.addEventListener('input', () => {
+      input.value = slider.value;
+      updateView();
+    });
+  }
+
+  bindInputSlider(baseInput, baseSlider, 100, 5000);
+  bindInputSlider(tempInput, tempSlider, -25, -5);
+  bindInputSlider(sucroseInput, sucroseSlider, 0, 500);
+  bindInputSlider(dextroseInput, dextroseSlider, 0, 300);
+  bindInputSlider(glucoseInput, glucoseSlider, 0, 300);
+  bindInputSlider(invertedInput, invertedSlider, 0, 300);
+  bindInputSlider(trehaloseInput, trehaloseSlider, 0, 300);
+
+  function toGrams(val) {
+    return activeUnit === 'imperial' ? val / 0.035274 : val;
+  }
+
+  function toCelsius(val) {
+    return activeUnit === 'imperial' ? (val - 32) * 5 / 9 : val;
+  }
+
+  function setStateUI(state) {
+    const isStone = state === 'stone';
+    const isSoup = state === 'soup';
+    const isCreamy = state === 'creamy';
+
+    texStone.classList.toggle('hidden', !isStone);
+    texCreamy.classList.toggle('hidden', !isCreamy);
+    texSoup.classList.toggle('hidden', !isSoup);
+
+    if (isStone) {
+      statusGlow.className = 'bowl-status-glow glow-stone';
+      statusBadge.className = 'status-badge danger';
+      statusBadgeText.textContent = ui.stoneState;
+      statusDescText.textContent = ui.stoneDesc;
+    } else if (isSoup) {
+      statusGlow.className = 'bowl-status-glow glow-soup';
+      statusBadge.className = 'status-badge inhibited';
+      statusBadgeText.textContent = ui.soupState;
+      statusDescText.textContent = ui.soupDesc;
+    } else {
+      statusGlow.className = 'bowl-status-glow glow-creamy';
+      statusBadge.className = 'status-badge optimal';
+      statusBadgeText.textContent = ui.creamyState;
+      statusDescText.textContent = ui.creamyDesc;
+    }
+  }
+
+  function setGauges(totalPAC, totalPOD, solidsPercentage) {
+    pacFill.style.height = Math.min(100, (totalPAC / 400) * 100) + '%';
+    podFill.style.height = Math.min(100, (totalPOD / 40) * 100) + '%';
+    solidsFill.style.height = Math.min(100, solidsPercentage) + '%';
+  }
+
+  function updateUI(state, values) {
+    targetPacDisplay.textContent = values.targetPAC.toString();
+    pacValueDisplay.textContent = values.totalPAC.toFixed(0);
+    podValueDisplay.textContent = values.totalPOD.toFixed(0);
+    solidsValueDisplay.textContent = values.solidsPercentage.toFixed(0) + '%';
+    setGauges(values.totalPAC, values.totalPOD, values.solidsPercentage);
+    setStateUI(state);
+  }
+
+  function computeState(totalPAC, targetPAC) {
+    const tolerance = 40;
+    if (totalPAC < targetPAC - tolerance) return 'stone';
+    if (totalPAC > targetPAC + tolerance) return 'soup';
+    return 'creamy';
+  }
+
+  function readValues() {
+    return {
+      base: parseFloat(baseInput.value) || 0,
+      temp: parseFloat(tempInput.value) || 0,
+      sucrose: parseFloat(sucroseInput.value) || 0,
+      dextrose: parseFloat(dextroseInput.value) || 0,
+      glucose: parseFloat(glucoseInput.value) || 0,
+      inverted: parseFloat(invertedInput.value) || 0,
+      trehalose: parseFloat(trehaloseInput.value) || 0,
+    };
+  }
+
+  function computeMetrics(v) {
+    const bg = toGrams(v.base);
+    const sg = toGrams(v.sucrose);
+    const dg = toGrams(v.dextrose);
+    const gg = toGrams(v.glucose);
+    const ig = toGrams(v.inverted);
+    const tg = toGrams(v.trehalose);
+
+    const waterWeight = bg * 0.7 + ig * 0.3;
+    const otherSolids = bg * 0.3;
+    const totalSolids = otherSolids + sg + dg + gg * 0.95 + ig * 0.7 + tg * 0.9;
+    const totalMixWeight = bg + sg + dg + gg + ig + tg;
+    const pacContribution = sg * 1.0 + dg * 1.9 + gg * 0.9 + ig * 1.9 + tg * 1.0;
+    const podContribution = sg * 1.0 + dg * 0.7 + gg * 0.4 + ig * 1.3 + tg * 0.45;
+
+    const totalPAC = waterWeight > 0 ? parseFloat(((pacContribution / waterWeight) * 1000).toFixed(1)) : 0;
+    const totalPOD = totalMixWeight > 0 ? parseFloat(((podContribution / totalMixWeight) * 100).toFixed(1)) : 0;
+    const solidsPct = totalMixWeight > 0 ? parseFloat(((totalSolids / totalMixWeight) * 100).toFixed(1)) : 0;
+    const targetPAC = Math.round(18 * Math.abs(toCelsius(v.temp)));
+
+    return { totalPAC, totalPOD, solidsPercentage: solidsPct, targetPAC };
+  }
+
+  function updateView() {
+    const v = readValues();
+    const metrics = computeMetrics(v);
+    const state = computeState(metrics.totalPAC, metrics.targetPAC);
+    updateUI(state, metrics);
+  }
+
+  function convertInputs(targetUnit, inputs, sliders) {
+    inputs.forEach((input, index) => {
+      const val = parseFloat(input.value) || 0;
+      if (targetUnit === 'imperial') {
+        input.value = (val * 0.035274).toFixed(2);
+        sliders[index].max = (parseFloat(sliders[index].max) * 0.035274).toFixed(2);
+      } else {
+        input.value = Math.round(val / 0.035274).toString();
+        sliders[index].max = Math.round(parseFloat(sliders[index].max) / 0.035274).toString();
+      }
+      sliders[index].value = input.value;
+    });
+  }
+
+  function convertTemp(targetUnit) {
+    const tempVal = parseFloat(tempInput.value) || 0;
+    if (targetUnit === 'imperial') {
+      tempInput.value = Math.round((tempVal * 9 / 5) + 32).toString();
+      tempSlider.min = '-13';
+      tempSlider.max = '23';
+    } else {
+      tempInput.value = Math.round((tempVal - 32) * 5 / 9).toString();
+      tempSlider.min = '-25';
+      tempSlider.max = '-5';
+    }
+    tempSlider.value = tempInput.value;
+  }
+
+  function convertUnitsTo(targetUnit) {
+    const labels = document.querySelectorAll('.weight-unit-label');
+    const tempLabels = document.querySelectorAll('.temp-unit-label');
+
+    const inputs = [baseInput, sucroseInput, dextroseInput, glucoseInput, invertedInput, trehaloseInput];
+    const sliders = [baseSlider, sucroseSlider, dextroseSlider, glucoseSlider, invertedSlider, trehaloseSlider];
+
+    convertInputs(targetUnit, inputs, sliders);
+    convertTemp(targetUnit);
+
+    labels.forEach(l => l.textContent = targetUnit === 'imperial' ? ui.ozLabel : ui.gLabel);
+    tempLabels.forEach(t => t.textContent = targetUnit === 'imperial' ? ui.fLabel : ui.cLabel);
+  }
+
+  metricBtn.addEventListener('click', () => {
+    if (activeUnit === 'metric') return;
+    activeUnit = 'metric';
+    metricBtn.classList.add('active');
+    imperialBtn.classList.remove('active');
+    convertUnitsTo('metric');
+    updateView();
+  });
+
+  imperialBtn.addEventListener('click', () => {
+    if (activeUnit === 'imperial') return;
+    activeUnit = 'imperial';
+    imperialBtn.classList.add('active');
+    metricBtn.classList.remove('active');
+    convertUnitsTo('imperial');
+    updateView();
+  });
+
+  updateView();
+</script>
+

package/src/tool/ice-cream-pac-pod/components/IceCryoGauge.astro

@@ -0,0 +1,54 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="popsicle-indicators-grid">
+  <div class="popsicle-bar pac-bar">
+    <div class="popsicle-label-top">{ui.pacLabel}</div>
+    <div class="popsicle-body-wrapper">
+      <div class="popsicle-outline">
+        <div id="pac-popsicle-fill" class="popsicle-fill pac-fill-color"></div>
+        <div class="popsicle-number-overlay">
+          <span id="pac-value-display">0</span>
+        </div>
+      </div>
+      <div class="popsicle-stick"></div>
+    </div>
+    <div class="popsicle-target-display">
+      <span>Target:</span>
+      <span id="target-pac-display">0</span>
+    </div>
+  </div>
+
+  <div class="popsicle-bar pod-bar">
+    <div class="popsicle-label-top">{ui.podLabel}</div>
+    <div class="popsicle-body-wrapper">
+      <div class="popsicle-outline">
+        <div id="pod-popsicle-fill" class="popsicle-fill pod-fill-color"></div>
+        <div class="popsicle-number-overlay">
+          <span id="pod-value-display">0</span>
+        </div>
+      </div>
+      <div class="popsicle-stick"></div>
+    </div>
+    <div class="popsicle-target-display">&nbsp;</div>
+  </div>
+
+  <div class="popsicle-bar solids-bar">
+    <div class="popsicle-label-top">{ui.solidsLabel}</div>
+    <div class="popsicle-body-wrapper">
+      <div class="popsicle-outline">
+        <div id="solids-popsicle-fill" class="popsicle-fill solids-fill-color"></div>
+        <div class="popsicle-number-overlay">
+          <span id="solids-value-display">0%</span>
+        </div>
+      </div>
+      <div class="popsicle-stick"></div>
+    </div>
+    <div class="popsicle-target-display">&nbsp;</div>
+  </div>
+</div>

package/src/tool/ice-cream-pac-pod/components/ScoopVisualizer.astro

@@ -0,0 +1,54 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="scoop-visualizer-container">
+  <h3 class="visualizer-header">{ui.scoopabilityLabel}</h3>
+
+  <div class="sundae-bowl-display">
+    <div class="bowl-inner">
+      <div id="texture-stone" class="texture-state hidden">
+        <svg viewBox="0 0 100 100" class="scoop-svg">
+          <path d="M25,80 L75,80 L80,95 L20,95 Z" class="bowl-base"></path>
+          <path d="M15,80 L85,80 L75,50 L25,50 Z" class="bowl-glass"></path>
+          <polygon points="35,65 65,65 70,30 30,30" class="sundae-ice-block"></polygon>
+          <line x1="45" y1="40" x2="45" y2="55" class="sundae-crack"></line>
+          <line x1="55" y1="35" x2="55" y2="50" class="sundae-crack"></line>
+        </svg>
+      </div>
+
+      <div id="texture-creamy" class="texture-state">
+        <svg viewBox="0 0 100 100" class="scoop-svg">
+          <path d="M25,80 L75,80 L80,95 L20,95 Z" class="bowl-base"></path>
+          <path d="M15,80 L85,80 L75,50 L25,50 Z" class="bowl-glass"></path>
+          <path d="M30,60 Q20,30 50,20 Q80,30 70,60 Z" class="sundae-swirl-body"></path>
+          <path d="M38,48 Q50,32 62,48 C55,42 45,42 38,48 Z" class="sundae-swirl-shade"></path>
+          <circle cx="50" cy="15" r="5" class="sundae-cherry"></circle>
+          <path d="M50,10 Q55,2 62,5" class="sundae-cherry-stem"></path>
+        </svg>
+      </div>
+
+      <div id="texture-soup" class="texture-state hidden">
+        <svg viewBox="0 0 100 100" class="scoop-svg">
+          <path d="M25,80 L75,80 L80,95 L20,95 Z" class="bowl-base"></path>
+          <path d="M15,80 L85,80 L75,50 L25,50 Z" class="bowl-glass"></path>
+          <path d="M18,75 Q50,65 82,75 L73,53 Q50,45 27,53 Z" class="sundae-melted-puddle"></path>
+          <path d="M26,80 Q23,90 20,85" class="sundae-drip-stream"></path>
+          <path d="M74,80 Q77,92 78,88" class="sundae-drip-stream"></path>
+        </svg>
+      </div>
+    </div>
+    <div class="bowl-status-glow" id="status-glow"></div>
+  </div>
+
+  <div class="scoop-status-card">
+    <div id="status-badge" class="status-badge optimal">
+      <span id="status-badge-text">{ui.creamyState}</span>
+    </div>
+    <p id="status-description-text" class="status-desc">{ui.creamyDesc}</p>
+  </div>
+</div>