@jjlmoya/utils-home 1.17.0 → 1.24.0

package/src/tool/acTonnageCalculator/client.ts

@@ -0,0 +1,171 @@
+import { calculateAcTonnage } from './logic';
+import { updateTheme, updateMiniRoom, spawnRipple } from './client-animations';
+
+const MAX_BTU = 60000;
+const CIRC = 2 * Math.PI * 85;
+const COLORS = ['#22c55e', '#84cc16', '#f59e0b', '#f97316', '#ef4444'];
+const M2_TO_FT2 = 10.7639;
+const M_TO_FT = 3.28084;
+const LS_KEY_UNIT = 'utils-home-unit-system';
+const LS_KEY_POWER = 'ac-tonnage-power-unit';
+const LS_KEY_STATE = 'ac-tonnage-state';
+
+let unitSystem: 'metric' | 'imperial' = 'metric';
+let powerUnit: 'btu' | 'frigorias' | 'tons' = 'btu';
+const SYS = () => unitSystem;
+
+function el(id: string) { return document.getElementById(id); }
+
+function setTxt(id: string, val: string) { const e = el(id); if (e) e.textContent = val; }
+
+function setAttr(id: string, attr: string, val: string) { const e = el(id); if (e) e.setAttribute(attr, val); }
+
+function getNum(id: string): number { const e = el(id) as HTMLInputElement | null; return e ? parseFloat(e.value) || 0 : 0; }
+
+function getStr(id: string): string { return (el(id) as HTMLSelectElement | null)?.value ?? ''; }
+
+function colorFor(btu: number): string { return COLORS[Math.min(4, Math.floor(Math.min(1, btu / MAX_BTU) * 5))]; }
+
+function unitLabel() { return SYS() === 'imperial' ? 'ft' : 'm'; }
+
+function areaLabel() { return SYS() === 'imperial' ? 'ft²' : 'm²'; }
+
+function toMetric(v: number, f: number) { return SYS() === 'imperial' ? v / f : v; }
+
+function updateLabels() {
+  setTxt('ac-area-num', `${getNum('ac-area')} ${areaLabel()}`);
+  setTxt('ac-height-num', `${getNum('ac-height')} ${unitLabel()}`);
+}
+
+function readInputs() {
+  return { area: toMetric(getNum('ac-area'), M2_TO_FT2), height: toMetric(getNum('ac-height'), M_TO_FT), people: getNum('ac-people'), heat: getNum('ac-heat'), sun: getStr('ac-sun'), room: getStr('ac-room') };
+}
+
+function saveState() {
+  const inp = readInputs();
+  localStorage.setItem(LS_KEY_STATE, JSON.stringify({ area: inp.area, height: inp.height, people: inp.people, heat: inp.heat, sun: inp.sun, room: inp.room, unit: unitSystem, power: powerUnit }));
+}
+
+function loadState() {
+  try { return JSON.parse(localStorage.getItem(LS_KEY_STATE) || 'null'); } catch { return null; }
+}
+
+function getLabels(): Record<string, string> {
+  const e = el('ac-labels');
+  try { return JSON.parse(e?.dataset?.labels ?? '{}'); } catch { return {}; }
+}
+
+function updateRingDisplay(res: ReturnType<typeof calculateAcTonnage>, labels: Record<string, string>) {
+  if (powerUnit === 'frigorias') { setTxt('ac-ring-btu', res.frigorias.toLocaleString()); setTxt('ac-ring-unit', labels.labelUnitFrigorias ?? 'Frigorías'); }
+  else if (powerUnit === 'tons') { setTxt('ac-ring-btu', String(res.tons)); setTxt('ac-ring-unit', labels.labelUnitTons ?? 'Tons'); }
+  else { setTxt('ac-ring-btu', res.btu.toLocaleString()); setTxt('ac-ring-unit', labels.labelUnitBtu ?? 'BTU/h'); }
+}
+
+function renderBreakdown(res: ReturnType<typeof calculateAcTonnage>) {
+  const bd = el('ac-breakdown');
+  if (!bd) return;
+  const labels = getLabels();
+  bd.innerHTML = res.breakdown.map((b) => {
+    const labelKey = `bd${b.key.charAt(0).toUpperCase()}${b.key.slice(1)}`;
+    const pct = res.btu > 0 ? Math.min(100, (b.value / res.btu) * 100) : 0;
+    return `<div class="ac-bd-row"><span class="ac-bd-label">${labels[labelKey] ?? b.key}</span><div class="ac-bd-bar-wrap"><div class="ac-bd-bar" style="width:${pct}%"></div></div><span class="ac-bd-val">${b.value.toLocaleString()}</span></div>`;
+  }).join('');
+}
+
+function renderResult(res: ReturnType<typeof calculateAcTonnage>, people: number, heat: number) {
+  const color = colorFor(res.btu);
+  const offset = CIRC - (CIRC * Math.min(res.btu, MAX_BTU)) / MAX_BTU;
+  updateLabels();
+  setTxt('ac-people-num', String(people));
+  setTxt('ac-heat-num', String(heat));
+  setTxt('ac-frig', res.frigorias.toLocaleString());
+  setTxt('ac-tons', String(res.tons));
+  setAttr('ac-ring-fill', 'stroke-dashoffset', String(offset));
+  setAttr('ac-ring-fill', 'stroke', color);
+  updateRingDisplay(res, getLabels());
+  renderBreakdown(res);
+  updateTheme(res.btu);
+  updateMiniRoom(res.btu);
+  spawnRipple();
+  const card = el('ac-card');
+  if (card) { card.classList.remove('ac-peak'); void card.offsetWidth; card.classList.add('ac-peak'); }
+}
+
+function update() {
+  const inp = readInputs();
+  if (inp.area <= 0 || inp.height <= 0) return;
+  renderResult(calculateAcTonnage({ area: inp.area, ceilingHeight: inp.height, people: inp.people, heatSources: inp.heat, sunExposure: inp.sun as 'light' | 'medium' | 'heavy', roomType: inp.room as 'bedroom' | 'living' | 'kitchen' | 'office' | 'server' }), inp.people, inp.heat);
+  saveState();
+}
+
+function setSlider(id: string, cfg: { min: number; max: number; step: number; val: number }) {
+  const e = el(id) as HTMLInputElement | null;
+  if (!e) return;
+  e.min = String(cfg.min); e.max = String(cfg.max); e.step = String(cfg.step);
+  e.value = String(Math.max(cfg.min, Math.min(cfg.max, cfg.val)));
+}
+
+function setSelect(id: string, val: string) { const e = el(id) as HTMLSelectElement | null; if (e) e.value = val; }
+
+function toggleBtns(sel: string, attr: string, val: string) {
+  document.querySelectorAll(sel).forEach((b) => b.classList.toggle('active', (b as HTMLElement).dataset[attr] === val));
+}
+
+function applyUnitSystem(sys: 'metric' | 'imperial') {
+  unitSystem = sys;
+  localStorage.setItem(LS_KEY_UNIT, sys);
+  toggleBtns('.ac-unit-toggle button', 'unit', sys);
+  const area = getNum('ac-area'), height = getNum('ac-height');
+  if (sys === 'imperial') { setSlider('ac-area', { min: 50, max: 1300, step: 10, val: Math.round(area * M2_TO_FT2) }); setSlider('ac-height', { min: 6, max: 20, step: 0.5, val: Math.round(height * M_TO_FT * 2) / 2 }); }
+  else { setSlider('ac-area', { min: 5, max: 120, step: 1, val: Math.round(area / M2_TO_FT2) }); setSlider('ac-height', { min: 2, max: 6, step: 0.1, val: Math.round((height / M_TO_FT) * 10) / 10 }); }
+  update();
+}
+
+function applyPowerUnit(unit: 'btu' | 'frigorias' | 'tons') {
+  powerUnit = unit;
+  localStorage.setItem(LS_KEY_POWER, unit);
+  toggleBtns('.ac-power-toggle button', 'power', unit);
+}
+
+function restoreSavedState() {
+  const saved = loadState();
+  if (!saved) return;
+  unitSystem = saved.unit ?? 'metric';
+  localStorage.setItem(LS_KEY_UNIT, unitSystem);
+  powerUnit = saved.power ?? 'btu';
+  localStorage.setItem(LS_KEY_POWER, powerUnit);
+  if (unitSystem === 'imperial') { setSlider('ac-area', { min: 50, max: 1300, step: 10, val: Math.round(saved.area * M2_TO_FT2) }); setSlider('ac-height', { min: 6, max: 20, step: 0.5, val: Math.round(saved.height * M_TO_FT * 2) / 2 }); }
+  else { setSlider('ac-area', { min: 5, max: 120, step: 1, val: saved.area }); setSlider('ac-height', { min: 2, max: 6, step: 0.1, val: saved.height }); }
+  setSlider('ac-people', { min: 0, max: 20, step: 1, val: saved.people });
+  setSlider('ac-heat', { min: 0, max: 20, step: 1, val: saved.heat });
+  setSelect('ac-sun', saved.sun);
+  setSelect('ac-room', saved.room);
+  toggleBtns('.ac-unit-toggle button', 'unit', unitSystem);
+  toggleBtns('.ac-power-toggle button', 'power', powerUnit);
+}
+
+function attachStep(btn: HTMLElement) {
+  const target = btn.dataset.target;
+  const delta = parseFloat(btn.dataset.delta ?? '0');
+  if (!target) return;
+  const slider = el(target) as HTMLInputElement | null;
+  if (!slider) return;
+  btn.addEventListener('click', () => {
+    const min = parseFloat(slider.min), max = parseFloat(slider.max), step = parseFloat(slider.step) || 1;
+    slider.value = String(Math.max(min, Math.min(max, Math.round((parseFloat(slider.value) + delta) / step) * step)));
+    slider.dispatchEvent(new Event('input'));
+  });
+}
+
+function init() {
+  restoreSavedState();
+  document.querySelectorAll('.ac-unit-toggle button').forEach((btn) => btn.addEventListener('click', () => { const s = (btn as HTMLElement).dataset.unit as 'metric' | 'imperial'; if (s) applyUnitSystem(s); }));
+  document.querySelectorAll('.ac-power-toggle button').forEach((btn) => btn.addEventListener('click', () => { const u = (btn as HTMLElement).dataset.power as 'btu' | 'frigorias' | 'tons'; if (u) { applyPowerUnit(u); update(); } }));
+  ['ac-area', 'ac-height', 'ac-people', 'ac-heat'].forEach((id) => { const e = el(id); if (e) e.addEventListener('input', update); });
+  ['ac-sun', 'ac-room'].forEach((id) => { const e = el(id); if (e) e.addEventListener('change', update); });
+  document.querySelectorAll('.ac-step').forEach((btn) => attachStep(btn as HTMLElement));
+  update();
+}
+
+document.addEventListener('astro:page-load', init);
+init();

package/src/tool/acTonnageCalculator/component.astro

@@ -0,0 +1,186 @@
+---
+import type { AcTonnageCalculatorUI } from './ui';
+import { calculateAcTonnage } from './logic';
+
+interface Props {
+  ui?: Record<string, unknown>;
+}
+
+const { ui = {} } = Astro.props;
+const aUI = ui as AcTonnageCalculatorUI;
+
+const defaults = {
+  area: 30,
+  height: 2.7,
+  people: 2,
+  heat: 1,
+  sun: 'medium',
+  room: 'living',
+};
+
+const initial = calculateAcTonnage({
+  area: defaults.area,
+  ceilingHeight: defaults.height,
+  people: defaults.people,
+  heatSources: defaults.heat,
+  sunExposure: defaults.sun as 'light' | 'medium' | 'heavy',
+  roomType: defaults.room as 'bedroom' | 'living' | 'kitchen' | 'office' | 'server',
+});
+
+const maxBtu = 60000;
+const ringOffset = 2 * Math.PI * 90 - (2 * Math.PI * 90 * Math.min(initial.btu, maxBtu)) / maxBtu;
+let initialColor = '#ef4444';
+if (initial.btu < 18000) initialColor = '#22c55e';
+else if (initial.btu < 36000) initialColor = '#f59e0b';
+
+function roomLabel(btu: number): string {
+  if (btu < 18000) return aUI.labelRoomCozy;
+  if (btu < 36000) return aUI.labelRoomWarm;
+  return aUI.labelRoomHot;
+}
+
+function breakdownLabel(key: string): string {
+  if (key === 'baseCooling') return aUI.bdBaseCooling;
+  if (key === 'ceilingHeight') return aUI.bdCeilingHeight;
+  if (key === 'people') return aUI.bdPeople;
+  if (key === 'heatSources') return aUI.bdHeatSources;
+  return aUI.bdSunRoom;
+}
+---
+
+<div class="ac-wrapper">
+  <div class="ac-card" id="ac-card">
+    <div class="ac-left">
+      <div class="ac-unit-toggle" id="ac-unit-toggle">
+        <button class="active" data-unit="metric">{aUI.labelMetric}</button>
+        <button data-unit="imperial">{aUI.labelImperial}</button>
+      </div>
+      <div class="ac-field">
+        <div class="ac-field-top">
+          <span class="ac-label">{aUI.labelRoomSize}</span>
+          <span class="ac-val" id="ac-area-num">{defaults.area}</span>
+        </div>
+        <input class="ac-slider" type="range" id="ac-area" min="5" max="120" step="1" value={defaults.area} />
+        <div class="ac-steps">
+          <button class="ac-step" data-target="ac-area" data-delta="-5">−</button>
+          <button class="ac-step" data-target="ac-area" data-delta="5">+</button>
+        </div>
+      </div>
+      <div class="ac-field">
+        <div class="ac-field-top">
+          <span class="ac-label">{aUI.labelCeilingHeight}</span>
+          <span class="ac-val" id="ac-height-num">{defaults.height}</span>
+        </div>
+        <input class="ac-slider" type="range" id="ac-height" min="2" max="6" step="0.1" value={defaults.height} />
+      </div>
+      <div class="ac-field">
+        <div class="ac-field-top">
+          <span class="ac-label">{aUI.labelPeople}</span>
+          <span class="ac-val" id="ac-people-num">{defaults.people}</span>
+        </div>
+        <input class="ac-slider" type="range" id="ac-people" min="0" max="20" step="1" value={defaults.people} />
+      </div>
+      <div class="ac-field">
+        <div class="ac-field-top">
+          <span class="ac-label">{aUI.labelHeatSources}</span>
+          <span class="ac-val" id="ac-heat-num">{defaults.heat}</span>
+        </div>
+        <input class="ac-slider" type="range" id="ac-heat" min="0" max="20" step="1" value={defaults.heat} />
+      </div>
+      <div class="ac-row">
+        <div class="ac-select-wrap">
+          <span class="ac-label">{aUI.labelSunExposure}</span>
+          <select class="ac-select" id="ac-sun">
+            <option value="light">{aUI.sunLight}</option>
+            <option value="medium" selected>{aUI.sunMedium}</option>
+            <option value="heavy">{aUI.sunHeavy}</option>
+          </select>
+        </div>
+        <div class="ac-select-wrap">
+          <span class="ac-label">{aUI.labelRoomType}</span>
+          <select class="ac-select" id="ac-room">
+            <option value="bedroom">{aUI.roomBedroom}</option>
+            <option value="living" selected>{aUI.roomLiving}</option>
+            <option value="kitchen">{aUI.roomKitchen}</option>
+            <option value="office">{aUI.roomOffice}</option>
+            <option value="server">{aUI.roomServer}</option>
+          </select>
+        </div>
+      </div>
+    </div>
+
+    <div class="ac-right">
+      <div class="ac-unit-toggle ac-power-toggle" id="ac-power-toggle">
+        <button class="active" data-power="btu">{aUI.labelUnitBtu}</button>
+        <button data-power="frigorias">{aUI.labelUnitFrigorias}</button>
+        <button data-power="tons">{aUI.labelUnitTons}</button>
+      </div>
+      <div class="ac-ring-wrap">
+        <div class="ac-ring-glow" id="ac-ring-glow" />
+        <svg viewBox="0 0 200 200" width="160" height="160">
+          <circle class="ac-ring-bg" cx="100" cy="100" r="90" />
+          <circle id="ac-ring-fill" class="ac-ring-fill" cx="100" cy="100" r="90"
+            stroke-dasharray={2 * Math.PI * 90}
+            stroke-dashoffset={ringOffset}
+            stroke={initialColor} />
+        </svg>
+        <div class="ac-ring-inner">
+          <div class="ac-ring-label">{aUI.labelRequired}</div>
+          <div class="ac-ring-btu" id="ac-ring-btu">{initial.btu.toLocaleString()}</div>
+          <div class="ac-ring-unit" id="ac-ring-unit">{aUI.labelBtus}</div>
+        </div>
+      </div>
+
+      <div class="ac-mini-room" id="ac-mini-room">
+        <svg viewBox="0 0 180 120" width="180" height="120">
+          <rect class="ac-room-wall" x="15" y="15" width="150" height="90" rx="6" />
+          <rect class="ac-room-window" x="65" y="10" width="50" height="8" rx="4" />
+          <circle class="ac-room-person" cx="50" cy="80" r="8" />
+          <circle class="ac-room-person" cx="80" cy="80" r="8" />
+          <rect class="ac-room-pc" x="110" y="72" width="18" height="10" rx="2" />
+          <rect class="ac-room-sun" x="140" y="25" width="16" height="16" rx="8" />
+          <circle cx="145" cy="22" r="14" fill="url(#heat-glow)" opacity="0.3">
+            <animate attributeName="r" values="14;18;14" dur="3s" repeatCount="indefinite" />
+          </circle>
+          <rect x="55" y="98" width="70" height="18" rx="9" fill="var(--ac-surface)" stroke="var(--ac-border)" stroke-width="1" />
+          <text x="90" y="110" text-anchor="middle" fill="var(--ac-text)" font-size="10" font-weight="800" font-family="system-ui, -apple-system, sans-serif">{roomLabel(initial.btu)}</text>
+          <defs>
+            <radialGradient id="heat-glow" cx="0.5" cy="0.5" r="0.5">
+              <stop offset="0%" stop-color="rgba(239,68,68,0.2)" />
+              <stop offset="100%" stop-color="rgba(239,68,68,0)" />
+            </radialGradient>
+          </defs>
+        </svg>
+      </div>
+
+      <div class="ac-stats">
+        <div class="ac-stat">
+          <span class="ac-stat-label">{aUI.labelFrigorias}</span>
+          <span class="ac-stat-val" id="ac-frig">{initial.frigorias.toLocaleString()}</span>
+        </div>
+        <div class="ac-stat">
+          <span class="ac-stat-label">{aUI.labelTons}</span>
+          <span class="ac-stat-val" id="ac-tons">{initial.tons}</span>
+        </div>
+      </div>
+
+      <div class="ac-breakdown" id="ac-breakdown">
+        {initial.breakdown.map((b) => (
+          <div class="ac-bd-row">
+            <span class="ac-bd-label">{breakdownLabel(b.key)}</span>
+            <div class="ac-bd-bar-wrap">
+              <div class="ac-bd-bar" style={`width:${Math.min(100, (b.value / (initial.btu || 1)) * 100)}%`} />
+            </div>
+            <span class="ac-bd-val">{b.value.toLocaleString()}</span>
+          </div>
+        ))}
+      </div>
+    </div>
+  </div>
+</div>
+
+<div style="display:none" data-labels={JSON.stringify({ bdBaseCooling: aUI.bdBaseCooling, bdCeilingHeight: aUI.bdCeilingHeight, bdPeople: aUI.bdPeople, bdHeatSources: aUI.bdHeatSources, bdSunRoom: aUI.bdSunRoom, labelBtus: aUI.labelBtus, labelFrigorias: aUI.labelFrigorias, labelTons: aUI.labelTons, labelRequired: aUI.labelRequired, labelRoomCozy: aUI.labelRoomCozy, labelRoomWarm: aUI.labelRoomWarm, labelRoomHot: aUI.labelRoomHot, labelUnitBtu: aUI.labelUnitBtu, labelUnitFrigorias: aUI.labelUnitFrigorias, labelUnitTons: aUI.labelUnitTons })} id="ac-labels" />
+
+<script>
+  import('./client.ts');
+</script>

package/src/tool/acTonnageCalculator/entry.ts

@@ -0,0 +1,29 @@
+import type { HomeToolEntry, ToolLocaleContent } from '../../types';
+import type { AcTonnageCalculatorUI } from './ui';
+
+export type AcTonnageCalculatorLocaleContent = ToolLocaleContent<AcTonnageCalculatorUI>;
+
+export const acTonnageCalculator: HomeToolEntry<AcTonnageCalculatorUI> = {
+  id: 'ac-tonnage-calculator',
+  icons: {
+    bg: 'mdi:air-conditioner',
+    fg: 'mdi:thermometer',
+  },
+  i18n: {
+    de: async () => (await import('./i18n/de')).content,
+    en: async () => (await import('./i18n/en')).content,
+    es: async () => (await import('./i18n/es')).content,
+    fr: async () => (await import('./i18n/fr')).content,
+    id: async () => (await import('./i18n/id')).content,
+    it: async () => (await import('./i18n/it')).content,
+    ja: async () => (await import('./i18n/ja')).content,
+    ko: async () => (await import('./i18n/ko')).content,
+    nl: async () => (await import('./i18n/nl')).content,
+    pl: async () => (await import('./i18n/pl')).content,
+    pt: async () => (await import('./i18n/pt')).content,
+    ru: async () => (await import('./i18n/ru')).content,
+    sv: async () => (await import('./i18n/sv')).content,
+    tr: async () => (await import('./i18n/tr')).content,
+    zh: async () => (await import('./i18n/zh')).content,
+  },
+};

package/src/tool/acTonnageCalculator/i18n/de.ts

@@ -0,0 +1,63 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { AcTonnageCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'klimaanlage-tonnage-rechner';
+const title = 'Klimaanlagentonnage und Kühlleistungsrechner';
+const description =
+  'Berechne die exakte Klimaanlagengröße für deinen Raum in BTU, Frigorien und Tonnen. Gib Raumgröße, Deckenhöhe, Personen, Wärmequellen und Sonneneinstrahlung ein, um eine präzise Kühlempfehlung zu erhalten.';
+
+const faqData = [
+  { question: 'Wie viele BTU brauche ich pro Quadratmeter?', answer: 'Der Standardwert liegt bei 600 BTU pro Quadratmeter für eine Standarddeckenhöhe von 2,5 Metern in gemäßigtem Klima. Dieser Wert steigt mit Deckenhöhe, Sonneneinstrahlung, Personenanzahl und wärmeerzeugenden Geräten.' },
+  { question: 'Was ist eine Frigoríe und wie vergleicht sie sich mit BTU?', answer: 'Eine Frigoríe ist eine ältere Kühlleistungseinheit, die in Spanien und Lateinamerika üblich ist. Eine Frigoríe entspricht etwa 3,968 BTU pro Stunde. Moderne Klimaanlagen geben oft beide Einheiten an, aber BTU ist der globale Standard.' },
+  { question: 'Wie rechne ich BTU in Kühltonnen um?', answer: 'Eine Kühltonne entspricht 12.000 BTU pro Stunde. Teile deinen BTU-Gesamtbedarf durch 12.000, um die Tonnage zu erhalten. Beispiel: 24.000 BTU entsprechen 2 Tonnen.' },
+  { question: 'Beeinflusst die Deckenhöhe die Klimaanlagengröße?', answer: 'Ja. Pro Meter über 2,7 Metern erhöht sich der Kühlbedarf um etwa 8%. Hohe Decken enthalten deutlich mehr Luftvolumen, das gekühlt werden muss.' },
+];
+
+const howToData = [
+  { name: 'Raum ausmessen', text: 'Miss Länge und Breite in Metern und multipliziere sie, um die Fläche in Quadratmetern zu erhalten.' },
+  { name: 'Personen und Geräte zählen', text: 'Zähle die Personen, die den Raum regelmäßig nutzen, und Wärmequellen wie Computer, Fernseher und Öfen.' },
+  { name: 'Sonneneinstrahlung wählen', text: 'Wähle leicht, mittel oder stark je nach direkter Sonneneinstrahlung während der heißesten Tageszeit.' },
+  { name: 'Empfehlung ablesen', text: 'Der Rechner zeigt BTU, Frigorien und Tonnen an, damit du in jedem Markt das passende Gerät kaufen kannst.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org', '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org', '@type': 'HowTo', name: title, description,
+  step: howToData.map((step) => ({ '@type': 'HowToStep', name: step.name, text: step.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: title, description,
+  applicationCategory: 'UtilityApplication', operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' }, inLanguage: 'de',
+};
+
+export const content: ToolLocaleContent<AcTonnageCalculatorUI> = {
+  slug, title, description, faq: faqData, bibliography, howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Welche Klimaanlagengröße brauche ich?', level: 2 },
+    { type: 'paragraph', html: 'Die richtige Klimaanlagengröße hängt von der Raumfläche, Deckenhöhe, Personenanzahl, Sonneneinstrahlung und Wärmequellen ab. Verwende diesen Rechner, um die genauen BTU-, Frigorien- und Tonnage-Werte für deinen Raum zu erhalten.' },
+    { type: 'table', headers: ['Raumgröße', 'Empfohlene BTU', 'Tonnage', 'Typische Nutzung'], rows: [['10 m² (kleines Schlafzimmer)', '6.000 - 7.000 BTU', '0,5 - 0,75 Tonnen', 'Gästezimmer, Homeoffice'], ['15 m² (Schlafzimmer)', '9.000 - 10.000 BTU', '0,75 - 1 Tonne', 'Hauptschlafzimmer'], ['20 m² (Wohnzimmer)', '12.000 - 14.000 BTU', '1 - 1,25 Tonnen', 'Kleines Wohnzimmer'], ['30 m² (offener Grundriss)', '18.000 - 21.000 BTU', '1,5 - 1,75 Tonnen', 'Studio oder offene Küche'], ['40 m² (großes Wohnzimmer)', '24.000 - 28.000 BTU', '2 - 2,5 Tonnen', 'Großes Wohnzimmer + Essbereich']] },
+    { type: 'title', text: 'Warum die falsche Größe dich Geld kostet', level: 2 },
+    { type: 'paragraph', html: 'Eine zu kleine Klimaanlage läuft ununterbrochen, erreicht nie die gewünschte Temperatur und verschleißt den Kompressor vorzeitig. Eine zu große Anlage bläst kurze Kaltluftstöße, schaltet sich vor der Entfeuchtung ab und hinterlässt ein kaltes, feuchtes Raumklima. Beide Fehler kosten Geld.' },
+    { type: 'stats', items: [{ value: '600', label: 'BTU pro m² Basis', icon: 'mdi:thermometer' }, { value: '12000', label: 'BTU pro Tonne', icon: 'mdi:snowflake' }, { value: '3.968', label: 'BTU pro Frigoríe', icon: 'mdi:calculator' }], columns: 3 },
+  ],
+  ui: {
+    labelRoomSize: 'Raumfläche', labelRoomSizeFt: 'Raumfläche', labelCeilingHeight: 'Deckenhöhe', labelCeilingHeightFt: 'Deckenhöhe',
+    labelPeople: 'Personen', labelHeatSources: 'Wärmequellen', labelSunExposure: 'Sonneneinstrahlung', labelRoomType: 'Raumtyp',
+    labelCalculate: 'Berechnen', labelResult: 'Ergebnis', labelBtus: 'BTU/h', labelFrigorias: 'Frigorien', labelTons: 'Tonnen',
+    labelRequired: 'Erforderlich', labelRecommended: 'Empfohlen', labelUnitBtu: 'BTU/h', labelUnitFrigorias: 'Frigorien', labelUnitTons: 'Tonnen',
+    labelMetric: 'Metrisch', labelImperial: 'Imperial', labelRoomCozy: 'Gemütlich', labelRoomWarm: 'Warm', labelRoomHot: 'Heiß',
+    bdBaseCooling: 'Grundkühlung', bdCeilingHeight: 'Deckenhöhe', bdPeople: 'Personen', bdHeatSources: 'Wärmequellen', bdSunRoom: 'Sonne & Raumtyp',
+    sunLight: 'Leicht', sunMedium: 'Mittel', sunHeavy: 'Stark',
+    roomBedroom: 'Schlafzimmer', roomLiving: 'Wohnzimmer', roomKitchen: 'Küche', roomOffice: 'Büro', roomServer: 'Serverraum',
+    errorRequired: 'Bitte fülle alle Felder aus',
+  },
+};

package/src/tool/acTonnageCalculator/i18n/en.ts

@@ -0,0 +1,136 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { AcTonnageCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'ac-tonnage-calculator';
+const title = 'AC Tonnage and Cooling Capacity Calculator';
+const description =
+  'Calculate the exact air conditioner size your room needs in BTUs, frigorias, and tons. Input room size, ceiling height, occupants, heat sources, and sun exposure to get a precise cooling recommendation.';
+
+const faqData = [
+  {
+    question: 'How many BTUs do I need per square metre?',
+    answer:
+      'The standard baseline is 600 BTU per square metre for a standard 2.5 metre ceiling in a temperate climate. This increases with ceiling height, sun exposure, number of occupants, and heat generating appliances.',
+  },
+  {
+    question: 'What is a frigoría and how does it compare to a BTU?',
+    answer:
+      'A frigoría is an older unit of cooling power common in Spain and Latin America. One frigoría equals approximately 3.968 BTU per hour. Modern AC units often list both units, but BTU is the global standard.',
+  },
+  {
+    question: 'How do I convert BTU to tons of cooling?',
+    answer:
+      'One ton of refrigeration equals 12,000 BTU per hour. Divide your total BTU requirement by 12,000 to get the tonnage. For example, 24,000 BTU equals 2 tons.',
+  },
+  {
+    question: 'Does ceiling height affect AC sizing?',
+    answer:
+      'Yes. For every metre above 2.7 metres, increase your cooling requirement by roughly 8 percent. High ceilings contain significantly more air volume that must be cooled.',
+  },
+];
+
+const howToData = [
+  { name: 'Measure your room', text: 'Measure the length and width in metres and multiply to get the area in square metres.' },
+  { name: 'Count occupants and devices', text: 'Add the number of people who regularly use the room and count heat sources like computers, TVs, and ovens.' },
+  { name: 'Select sun exposure', text: 'Choose light, medium, or heavy based on how much direct sun the room receives during the hottest part of the day.' },
+  { name: 'Read the recommendation', text: 'The calculator outputs BTUs, frigorias, and tons so you can shop for the right unit in any market.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<AcTonnageCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'What Size Air Conditioner Do I Need?', level: 2 },
+    { type: 'paragraph', html: 'The right air conditioner size depends on your room area, ceiling height, how many people use the space, sun exposure, and heat sources like computers or kitchen appliances. Use this calculator to get the exact BTU, frigoría, and tonnage your room needs. Below is a quick reference for common room sizes with standard 2.5 m ceilings and light sun exposure.' },
+    { type: 'table', headers: ['Room size', 'Recommended BTU', 'Tonnage', 'Typical use'], rows: [['10 m² (small bedroom)', '6,000 - 7,000 BTU', '0.5 - 0.75 tons', 'Guest room, home office'], ['15 m² (bedroom)', '9,000 - 10,000 BTU', '0.75 - 1 ton', 'Master bedroom'], ['20 m² (living room)', '12,000 - 14,000 BTU', '1 - 1.25 tons', 'Small living room'], ['30 m² (open plan)', '18,000 - 21,000 BTU', '1.5 - 1.75 tons', 'Studio or open kitchen'], ['40 m² (large living)', '24,000 - 28,000 BTU', '2 - 2.5 tons', 'Large living + dining']] },
+    { type: 'title', text: 'Why Getting the Size Wrong Costs You Money', level: 2 },
+    { type: 'paragraph', html: 'An undersized air conditioner runs non-stop, never reaches the set temperature, and burns out its compressor years early. Your electricity bill spikes and you still feel uncomfortable. An oversized unit blasts cold air in short bursts, shuts off before dehumidifying, and leaves the room cold and damp. Both mistakes waste money. Getting the tonnage right is the single most important decision when buying an AC.' },
+    { type: 'stats', items: [{ value: '600', label: 'BTU per m² base', icon: 'mdi:thermometer' }, { value: '12000', label: 'BTU per ton', icon: 'mdi:snowflake' }, { value: '3.968', label: 'BTU per frigoría', icon: 'mdi:calculator' }], columns: 3 },
+    { type: 'title', text: 'How the Calculator Works', level: 3 },
+    { type: 'paragraph', html: 'This tool starts with a baseline of 600 BTU per square metre for a room with 2.5 metre ceilings. It then adds load for every extra metre of ceiling height, each person in the room, every heat-generating device, the amount of direct sun, and the room type. The result is your total cooling requirement in BTU per hour, plus the equivalent in frigorías and tons so you can shop anywhere in the world.' },
+    { type: 'title', text: 'Real Factors That Increase Your Cooling Load', level: 3 },
+    { type: 'paragraph', html: 'A 20 square metre bedroom and a 20 square metre kitchen need completely different AC units. Ovens, gaming PCs, large south-facing windows, and high ceilings add heat that a simple area chart ignores. Here is exactly how each factor changes your calculation.' },
+    { type: 'table', headers: ['Factor', 'Extra load', 'Practical fix'], rows: [['Ceiling height over 2.7 m', '+8% per extra metre', 'Buy a slightly larger unit or add a ceiling fan to circulate air.'], ['Direct afternoon sun', '+15% to +35%', 'Use reflective film or blackout blinds; size up the AC.'], ['Each extra person', '+500 BTU per person', 'Count the people who are normally in the room, not party guests.'], ['Kitchen with oven or stove', '+25% room multiplier', 'If possible, install a dedicated kitchen unit or size up by one step.'], ['Gaming PC or server', '+400 BTU per device', 'Position the AC vent to blow across the heat source.']] },
+    { type: 'title', text: 'BTU, Frigorías, and Tons: A Quick Guide', level: 3 },
+    { type: 'paragraph', html: '<strong>BTU (British Thermal Unit)</strong> is the global standard. One BTU is the energy needed to cool one pound of water by one degree Fahrenheit. <strong>Frigorías</strong> are still common in Spain and Latin America; one frigoría equals about 3.968 BTU per hour. <strong>Tons</strong> are used in North America; one ton of refrigeration equals 12,000 BTU per hour. This calculator shows all three so you can compare units from any manufacturer or retailer.' },
+    { type: 'tip', title: 'Buy at 80 Percent Capacity for Best Results', html: '<p>Choose an AC rated for about 80 percent of your calculated peak load, not 100 percent. A unit running at 80 percent capacity cycles less, removes humidity better, uses less electricity, and lasts several years longer than one constantly maxed out.</p>' },
+    { type: 'summary', title: 'Checklist: Buy the Right AC Unit', items: ['Measure the room length and width and multiply to get the area in square metres.', 'Check ceiling height; add roughly 8% cooling power for every metre above 2.7 m.', 'Count regular occupants and add 500 BTU per person beyond the first two.', 'Count heat sources like PCs, TVs, and ovens and add 400 BTU per device.', 'Check sun exposure; south-facing rooms with big windows need 15% to 35% more.', 'Use this calculator to get your total BTU, frigorías, and tons.', 'Buy a unit rated at about 80% of your calculated load.'] },
+  ],
+  ui: {
+    labelRoomSize: 'Room Area',
+    labelCeilingHeight: 'Ceiling Height',
+    labelPeople: 'People',
+    labelHeatSources: 'Heat Sources',
+    labelSunExposure: 'Sun Exposure',
+    labelRoomType: 'Room Type',
+    labelCalculate: 'Calculate',
+    labelResult: 'Result',
+    labelBtus: 'BTU/h',
+    labelFrigorias: 'Frigorías',
+    labelTons: 'Tons',
+    labelRequired: 'Required',
+    labelRecommended: 'Recommended',
+    labelUnitBtu: 'BTU/h',
+    labelUnitFrigorias: 'Frigorías',
+    labelUnitTons: 'Tons',
+    labelMetric: 'Metric',
+    labelImperial: 'Imperial',
+    labelRoomCozy: 'Cozy',
+    labelRoomWarm: 'Warm',
+    labelRoomHot: 'Hot',
+    bdBaseCooling: 'Base cooling',
+    bdCeilingHeight: 'Ceiling height',
+    bdPeople: 'People',
+    bdHeatSources: 'Heat sources',
+    bdSunRoom: 'Sun & room type',
+    sunLight: 'Light',
+    sunMedium: 'Medium',
+    sunHeavy: 'Heavy',
+    roomBedroom: 'Bedroom',
+    roomLiving: 'Living Room',
+    roomKitchen: 'Kitchen',
+    roomOffice: 'Office',
+    roomServer: 'Server Room',
+    errorRequired: 'Please fill in all fields',
+  },
+};