@jjlmoya/utils-cooking 1.27.0 → 1.28.0

package/package.json

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

package/src/category/index.ts

@@ -11,6 +11,7 @@ import { ingredientRescaler } from '../tool/ingredient-rescaler/entry';
 import { sourdoughCalculator } from '../tool/sourdough-calculator/entry';
 import { rouxGuide } from '../tool/roux-guide/entry';
 import { cookwareGuide } from '../tool/cookware-guide/entry';
+import { lactoFermentationSalt } from '../tool/lacto-fermentation-salt-calculator/entry';
 
 export const cookingCategory: CookingCategoryEntry = {
   icon: 'mdi:chef-hat',
@@ -27,6 +28,7 @@ export const cookingCategory: CookingCategoryEntry = {
     sourdoughCalculator,
     rouxGuide,
     cookwareGuide,
+    lactoFermentationSalt,
   ],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),

package/src/entries.ts

@@ -11,6 +11,7 @@ export { pizza } from './tool/pizza/entry';
 export { rouxGuide } from './tool/roux-guide/entry';
 export { sourdoughCalculator } from './tool/sourdough-calculator/entry';
 export { yeastConverter } from './tool/yeast-converter/entry';
+export { lactoFermentationSalt } from './tool/lacto-fermentation-salt-calculator/entry';
 export { cookingCategory } from './category';
 import { americanKitchenConverter } from './tool/american-kitchen-converter/entry';
 import { bananaCare } from './tool/banana-ripeness/entry';
@@ -25,4 +26,5 @@ import { pizza } from './tool/pizza/entry';
 import { rouxGuide } from './tool/roux-guide/entry';
 import { sourdoughCalculator } from './tool/sourdough-calculator/entry';
 import { yeastConverter } from './tool/yeast-converter/entry';
-export const ALL_ENTRIES = [americanKitchenConverter, bananaCare, brine, cookwareGuide, eggTimer, ingredientRescaler, kitchenTimer, meringuePeak, moldScaler, pizza, rouxGuide, sourdoughCalculator, yeastConverter];
+import { lactoFermentationSalt } from './tool/lacto-fermentation-salt-calculator/entry';
+export const ALL_ENTRIES = [americanKitchenConverter, bananaCare, brine, cookwareGuide, eggTimer, ingredientRescaler, kitchenTimer, meringuePeak, moldScaler, pizza, rouxGuide, sourdoughCalculator, yeastConverter, lactoFermentationSalt];

package/src/index.ts

@@ -14,6 +14,7 @@ export { SOURDOUGH_CALCULATOR_TOOL } from './tool/sourdough-calculator';
 export { ROUX_GUIDE_TOOL } from './tool/roux-guide';
 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 type {
   KnownLocale,

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

@@ -32,8 +32,8 @@ describe("i18n titles for FAQ", () => {
     }
   });
 
-  it("should have 13 tools with complete i18n setup", async () => {
-    expect(ALL_TOOLS.length).toBe(13);
+  it("should have 14 tools with complete i18n setup", async () => {
+    expect(ALL_TOOLS.length).toBe(14);
   });
 
   it("tool IDs should be correctly registered", () => {
@@ -50,5 +50,6 @@ describe("i18n titles for FAQ", () => {
     expect(toolIds).toContain("sourdough-calculator");
     expect(toolIds).toContain("roux-guide");
     expect(toolIds).toContain("cookware-guide");
+    expect(toolIds).toContain("lacto-fermentation-salt-calculator");
   });
 });

package/src/tests/lacto-fermentation-salt-calculator.test.ts

@@ -0,0 +1,64 @@
+import { describe, it, expect } from 'vitest';
+import { FermentationLogic } from '../tool/lacto-fermentation-salt-calculator/logic';
+
+describe('Lacto-Fermentation Salt Calculator Logic', () => {
+  it('calculates correct dry salting values', () => {
+    const res = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 0,
+      salinity: 2.5,
+      mode: 'dry',
+    });
+    expect(res.saltGrams).toBe(25);
+    expect(res.status).toBe('optimal');
+  });
+
+  it('calculates correct wet brining values', () => {
+    const res = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 500,
+      salinity: 2.0,
+      mode: 'wet',
+    });
+    expect(res.saltGrams).toBe(30);
+    expect(res.status).toBe('optimal');
+  });
+
+  it('correctly classifies status based on salinity thresholds', () => {
+    const dangerRes = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 0,
+      salinity: 1.5,
+      mode: 'dry',
+    });
+    expect(dangerRes.status).toBe('danger');
+
+    const optimalRes = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 0,
+      salinity: 3.0,
+      mode: 'dry',
+    });
+    expect(optimalRes.status).toBe('optimal');
+
+    const inhibitedRes = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 0,
+      salinity: 4.0,
+      mode: 'dry',
+    });
+    expect(inhibitedRes.status).toBe('inhibited');
+  });
+
+  it('calculates volumetric conversions accurately', () => {
+    const res = FermentationLogic.calculate({
+      vegWeight: 1000,
+      waterWeight: 0,
+      salinity: 2.0,
+      mode: 'dry',
+    });
+    expect(res.saltGrams).toBe(20);
+    expect(res.fineTeaspoons).toBe(3.5);
+    expect(res.kosherTeaspoons).toBe(4.7);
+  });
+});

package/src/tests/locale_completeness.test.ts

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

package/src/tests/tool_validation.test.ts

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

package/src/tool/lacto-fermentation-salt-calculator/bibliography.astro

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

package/src/tool/lacto-fermentation-salt-calculator/bibliography.ts

@@ -0,0 +1,10 @@
+export const bibliography = [
+  {
+    name: 'Microbiology and Technology of Fermented Foods',
+    url: 'https://onlinelibrary.wiley.com/doi/book/10.1002/9780470277515',
+  },
+  {
+    name: 'Lactic Acid Bacteria: Microbiological and Functional Aspects',
+    url: 'https://www.taylorfrancis.com/books/edit/10.1201/9780429057465/lactic-acid-bacteria-gabriel-vinderola-arthur-ouwehand-seppo-salminen-atte-von-wright',
+  },
+];

package/src/tool/lacto-fermentation-salt-calculator/component.astro

@@ -0,0 +1,163 @@
+---
+import WizardMode from './components/WizardMode.astro';
+import DigitalScale from './components/DigitalScale.astro';
+import PetriDish from './components/PetriDish.astro';
+
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="fermentation-container">
+  <div class="fermentation-card">
+    <div class="fermentation-glow-1"></div>
+    <div class="fermentation-glow-2"></div>
+
+    <div class="fermentation-grid">
+      <div class="fermentation-controls-section">
+        <WizardMode ui={ui} />
+        <DigitalScale ui={ui} />
+      </div>
+
+      <div class="fermentation-visuals-section">
+        <PetriDish 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 dryBtn = document.getElementById('toggle-dry-btn');
+  const wetBtn = document.getElementById('toggle-wet-btn');
+  const vegInput = document.getElementById('veg-weight-input');
+  const waterInput = document.getElementById('water-weight-input');
+  const waterGroup = document.getElementById('water-weight-group');
+  const salinitySlider = document.getElementById('salinity-slider');
+  
+  const salinityDisplay = document.getElementById('salinity-val-display');
+  const scaleDisplay = document.getElementById('scale-main-value');
+  const scaleUnitDisplay = document.getElementById('scale-unit-label');
+  const fineDisplay = document.getElementById('fine-teaspoons-val');
+  const kosherDisplay = document.getElementById('kosher-teaspoons-val');
+
+  const petriBac = document.getElementById('petri-bacteria');
+  const petriMold = document.getElementById('petri-mold');
+  const petriCrys = document.getElementById('petri-crystals');
+
+  const statusBadge = document.getElementById('status-badge');
+  const statusBadgeText = document.getElementById('status-badge-text');
+  const statusDescText = document.getElementById('status-description-text');
+
+  let activeMode = 'dry';
+  let activeUnit = 'metric';
+
+  function updatePetriAndStatus(salinity) {
+    if (salinity < 2.0) {
+      petriMold.style.opacity = '1';
+      petriBac.style.opacity = '0';
+      petriCrys.style.opacity = '0';
+      
+      statusBadge.className = 'status-badge danger';
+      statusBadgeText.textContent = ui.statusDanger;
+      statusDescText.textContent = ui.statusDangerDesc;
+    } else if (salinity > 3.5) {
+      petriMold.style.opacity = '0';
+      petriBac.style.opacity = '0';
+      petriCrys.style.opacity = '1';
+
+      statusBadge.className = 'status-badge inhibited';
+      statusBadgeText.textContent = ui.statusInhibited;
+      statusDescText.textContent = ui.statusInhibitedDesc;
+    } else {
+      petriMold.style.opacity = '0';
+      petriBac.style.opacity = '1';
+      petriCrys.style.opacity = '0';
+
+      statusBadge.className = 'status-badge optimal';
+      statusBadgeText.textContent = ui.statusOptimal;
+      statusDescText.textContent = ui.statusOptimalDesc;
+    }
+  }
+
+  function updateView() {
+    const vegWeight = Math.max(0, parseFloat(vegInput.value) || 0);
+    const waterWeight = Math.max(0, parseFloat(waterInput.value) || 0);
+    const salinity = Math.max(0, parseFloat(salinitySlider.value) || 0);
+
+    salinityDisplay.textContent = `${salinity.toFixed(1)}%`;
+
+    const totalWeight = activeMode === 'dry' ? vegWeight : (vegWeight + waterWeight);
+    const saltResult = Math.max(0, (totalWeight * salinity) / 100);
+    
+    scaleDisplay.textContent = saltResult.toFixed(2);
+    scaleUnitDisplay.textContent = activeUnit === 'metric' ? 'g' : 'oz';
+
+    const saltGrams = activeUnit === 'imperial' ? saltResult * 28.3495 : saltResult;
+
+    fineDisplay.textContent = Math.max(0, saltGrams / 5.7).toFixed(1);
+    kosherDisplay.textContent = Math.max(0, saltGrams / 4.3).toFixed(1);
+
+    updatePetriAndStatus(salinity);
+  }
+
+  function convertInputsTo(targetUnit) {
+    const currentVeg = parseFloat(vegInput.value) || 0;
+    const currentWater = parseFloat(waterInput.value) || 0;
+
+    const labels = document.querySelectorAll('.weight-unit-label');
+
+    if (targetUnit === 'imperial') {
+      vegInput.value = (currentVeg * 0.035274).toFixed(1);
+      waterInput.value = (currentWater * 0.035274).toFixed(1);
+      labels.forEach(label => label.textContent = 'oz');
+    } else {
+      vegInput.value = Math.round(currentVeg / 0.035274).toString();
+      waterInput.value = Math.round(currentWater / 0.035274).toString();
+      labels.forEach(label => label.textContent = 'g');
+    }
+  }
+
+  metricBtn.addEventListener('click', () => {
+    if (activeUnit === 'metric') return;
+    activeUnit = 'metric';
+    metricBtn.classList.add('active');
+    imperialBtn.classList.remove('active');
+    convertInputsTo('metric');
+    updateView();
+  });
+
+  imperialBtn.addEventListener('click', () => {
+    if (activeUnit === 'imperial') return;
+    activeUnit = 'imperial';
+    imperialBtn.classList.add('active');
+    metricBtn.classList.remove('active');
+    convertInputsTo('imperial');
+    updateView();
+  });
+
+  dryBtn.addEventListener('click', () => {
+    activeMode = 'dry';
+    dryBtn.classList.add('active');
+    wetBtn.classList.remove('active');
+    waterGroup.classList.add('hidden');
+    updateView();
+  });
+
+  wetBtn.addEventListener('click', () => {
+    activeMode = 'wet';
+    wetBtn.classList.add('active');
+    dryBtn.classList.remove('active');
+    waterGroup.classList.remove('hidden');
+    updateView();
+  });
+
+  vegInput.addEventListener('input', updateView);
+  waterInput.addEventListener('input', updateView);
+  salinitySlider.addEventListener('input', updateView);
+
+  updateView();
+</script>

package/src/tool/lacto-fermentation-salt-calculator/components/DigitalScale.astro

@@ -0,0 +1,43 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="digital-scale-container">
+  <div class="scale-header">
+    <span class="scale-title">{ui.scaleTitle}</span>
+  </div>
+
+  <div class="scale-plate">
+    <div class="scale-display">
+      <div class="scale-digits">
+        <span id="scale-main-value">25.00</span>
+        <span id="scale-unit-label" class="scale-unit">g</span>
+      </div>
+      <div class="scale-label">{ui.saltGramsLabel}</div>
+    </div>
+  </div>
+
+  <div class="scale-conversions">
+    <div class="conversion-item">
+      <span class="conversion-label">{ui.fineLabel}</span>
+      <div class="conversion-val">
+        <span id="fine-teaspoons-val">4.4</span>
+        <span class="conversion-unit">tsp</span>
+      </div>
+    </div>
+
+    <div class="conversion-item">
+      <span class="conversion-label">{ui.kosherLabel}</span>
+      <div class="conversion-val">
+        <span id="kosher-teaspoons-val">5.8</span>
+        <span class="conversion-unit">tsp</span>
+      </div>
+    </div>
+  </div>
+
+  <p class="scale-disclaimer">{ui.disclaimer}</p>
+</div>

package/src/tool/lacto-fermentation-salt-calculator/components/PetriDish.astro

@@ -0,0 +1,55 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="petri-dish-section">
+  <div class="petri-header">
+    <span class="petri-title">{ui.petriTitle}</span>
+  </div>
+
+  <div class="petri-container">
+    <div class="petri-dish">
+      <div class="petri-agar">
+        <svg viewBox="0 0 200 200" class="petri-svg" xmlns="http://www.w3.org/2000/svg">
+          <g id="petri-bacteria" class="bacteria-layer">
+            <ellipse cx="60" cy="80" rx="6" ry="14" transform="rotate(25 60 80)" class="bac-cell"></ellipse>
+            <ellipse cx="140" cy="70" rx="5" ry="12" transform="rotate(-35 140 70)" class="bac-cell"></ellipse>
+            <ellipse cx="100" cy="130" rx="7" ry="15" transform="rotate(45 100 130)" class="bac-cell"></ellipse>
+            <circle cx="80" cy="50" r="5" class="bac-coccus"></circle>
+            <circle cx="120" cy="110" r="4.5" class="bac-coccus"></circle>
+            <circle cx="70" cy="150" r="6" class="bac-coccus"></circle>
+          </g>
+
+          <g id="petri-mold" class="mold-layer">
+            <path d="M 40,100 C 50,80 70,80 80,100 C 90,80 110,80 120,100 C 110,120 90,120 80,100 C 70,120 50,120 40,100 Z" class="mold-fungus" fill="none" stroke-width="3"></path>
+            <path d="M 110,60 C 120,45 135,45 140,60 C 145,45 160,45 160,60" class="mold-fungus" fill="none" stroke-width="2.5"></path>
+            <path d="M 70,140 C 80,125 95,125 100,140 C 105,125 120,125 120,140" class="mold-fungus" fill="none" stroke-width="2.5"></path>
+            <circle cx="80" cy="100" r="3" class="mold-spore"></circle>
+            <circle cx="140" cy="60" r="2" class="mold-spore"></circle>
+            <circle cx="100" cy="140" r="2.5" class="mold-spore"></circle>
+          </g>
+
+          <g id="petri-crystals" class="crystals-layer">
+            <rect x="50" y="50" width="12" height="12" transform="rotate(15 56 56)" class="crystal-cube"></rect>
+            <rect x="130" y="120" width="16" height="16" transform="rotate(45 138 128)" class="crystal-cube"></rect>
+            <rect x="60" y="120" width="10" height="10" transform="rotate(5 65 125)" class="crystal-cube"></rect>
+            <rect x="140" y="45" width="14" height="14" transform="rotate(30 147 52)" class="crystal-cube"></rect>
+          </g>
+        </svg>
+      </div>
+    </div>
+  </div>
+
+  <div class="status-box">
+    <div id="status-badge" class="status-badge optimal">
+      <span id="status-badge-text">{ui.statusOptimal}</span>
+    </div>
+    <p id="status-description-text" class="status-desc-text">
+      {ui.statusOptimalDesc}
+    </p>
+  </div>
+</div>

package/src/tool/lacto-fermentation-salt-calculator/components/WizardMode.astro

@@ -0,0 +1,83 @@
+---
+interface Props {
+  ui: Record<string, string>;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="fermentation-wizard">
+  <div class="wizard-control-group">
+    <label class="wizard-label">{ui.unitLabel}</label>
+    <div class="unit-toggle-container">
+      <button type="button" id="toggle-metric-btn" class="mode-btn active" data-unit="metric">
+        {ui.metricUnit}
+      </button>
+      <button type="button" id="toggle-imperial-btn" class="mode-btn" data-unit="imperial">
+        {ui.imperialUnit}
+      </button>
+    </div>
+  </div>
+
+  <div class="wizard-control-group">
+    <label class="wizard-label">
+      {ui.modeLabel}
+    </label>
+    <div class="mode-toggle-container">
+      <button type="button" id="toggle-dry-btn" class="mode-btn active" data-mode="dry">
+        {ui.dryMode}
+      </button>
+      <button type="button" id="toggle-wet-btn" class="mode-btn" data-mode="wet">
+        {ui.wetMode}
+      </button>
+    </div>
+  </div>
+
+  <div class="wizard-control-group">
+    <label for="veg-weight-input" class="wizard-label">
+      {ui.vegWeightLabel} (<span class="weight-unit-label">g</span>)
+    </label>
+    <input
+      type="number"
+      id="veg-weight-input"
+      min="0"
+      max="100000"
+      step="any"
+      value="1000"
+      class="wizard-number-input"
+      inputmode="decimal"
+    />
+  </div>
+
+  <div id="water-weight-group" class="wizard-control-group hidden">
+    <label for="water-weight-input" class="wizard-label">
+      {ui.waterWeightLabel} (<span class="weight-unit-label">g</span>)
+    </label>
+    <input
+      type="number"
+      id="water-weight-input"
+      min="0"
+      max="100000"
+      step="any"
+      value="500"
+      class="wizard-number-input"
+      inputmode="decimal"
+    />
+  </div>
+
+  <div class="wizard-control-group">
+    <div class="slider-header">
+      <label for="salinity-slider" class="wizard-label">{ui.salinityLabel}</label>
+      <span id="salinity-val-display" class="slider-val">2.5%</span>
+    </div>
+    <input
+      type="range"
+      id="salinity-slider"
+      min="1.0"
+      max="6.0"
+      step="0.1"
+      value="2.5"
+      class="wizard-slider"
+    />
+  </div>
+</div>

package/src/tool/lacto-fermentation-salt-calculator/entry.ts

@@ -0,0 +1,26 @@
+import type { CookingToolEntry } from '../../types';
+
+export const lactoFermentationSalt: CookingToolEntry = {
+  id: 'lacto-fermentation-salt-calculator',
+  icons: {
+    bg: 'mdi:leaf',
+    fg: 'mdi:flask-outline',
+  },
+  i18n: {
+    en: () => import('./i18n/en').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};