@jjlmoya/utils-diy 1.3.0 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-diy",
-    "version": "1.3.0",
+    "version": "1.4.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",
@@ -37,6 +37,7 @@
     },
     "dependencies": {
         "@iconify-json/mdi": "^1.2.3",
+        "@jjlmoya/prompagate": "^1.1.0",
         "@jjlmoya/utils-shared": "1.2.0",
         "astro": "^6.1.2",
         "astro-icon": "^1.1.0"

package/src/category/i18n/de.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Werkzeuge und Rechner für Heimwerker und Bauprojekte',
+  description: 'Planen Sie Ihre Heimwerkerprojekte mit kostenlosen Online-Tools. Rechner für Tonschrumpfung, Harzmischungen, Beton, Schnittoptimierer und Treppenlayout.',
+  seo: [
+    { type: 'title', text: 'Heimtechnik und DIY Projekte: Vom Entwurf zur Realität', level: 2 },
+    { type: 'paragraph', html: 'Die <strong>Do-It-Yourself (DIY)</strong>-Bewegung ist kein bloßes Hobby mehr, sondern eine Form der technischen und kreativen Souveränität. In diesem Bereich bieten wir eine Reihe von <strong>kostenlosen Online-Tools</strong> an, die für Maker, Handwerker und Bauinteressierte entwickelt wurden, die professionelle Ergebnisse anstreben.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optimierung', value: 'Material 95%+', icon: 'mdi:saw-blade' }, { label: 'Sicherheit', value: 'Normgerecht', icon: 'mdi:ruler-square' }, { label: 'Materialien', value: 'Wiederverwertung', icon: 'mdi:tools' }, { label: 'Präzision', value: 'Millimetergenau', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/id.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Alat dan Kalkulator untuk Proyek DIY dan Konstruksi',
+  description: 'Rencanakan proyek DIY Anda dengan alat online gratis. Kalkulator penyusutan tanah liat, campuran resin, beton, pengoptimal pemotongan, dan tata letak tangga.',
+  seo: [
+    { type: 'title', text: 'Teknik Rumahan dan Proyek DIY: Dari Desain ke Realitas', level: 2 },
+    { type: 'paragraph', html: 'Gerakan <strong>Do It Yourself (DIY)</strong> bukan lagi sekadar hobi, melainkan bentuk kedaulatan teknis dan kreatif. Di bagian ini, kami menyediakan serangkaian <strong>alat online gratis</strong> yang dirancang untuk maker, pengrajin, dan penggemar konstruksi yang mencari hasil profesional.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optimasi', value: 'Material 95%+', icon: 'mdi:saw-blade' }, { label: 'Keamanan', value: 'Sesuai Standar', icon: 'mdi:ruler-square' }, { label: 'Material', value: 'Pemulihan', icon: 'mdi:tools' }, { label: 'Presisi', value: 'Milimetrik', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/it.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Strumenti e Calcolatori per Progetti DIY e Costruzione',
+  description: 'Pianifica i tuoi progetti fai da te con strumenti online gratuiti. Calcolatori per il ritiro dell\'argilla, miscele di resina, cemento, ottimizzatori di taglio e layout scale.',
+  seo: [
+    { type: 'title', text: 'Ingegneria Domestica e Progetti DIY: Dal Design alla Realtà', level: 2 },
+    { type: 'paragraph', html: 'Il movimento <strong>Do It Yourself (DIY)</strong> non è più un semplice hobby ma una forma di sovranità tecnica e creativa. In questa sezione, forniamo una suite di <strong>strumenti online gratuiti</strong> progettati per maker, artigiani e appassionati di costruzioni che cercano risultati professionali.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Ottimizzazione', value: 'Materiale 95%+', icon: 'mdi:saw-blade' }, { label: 'Sicurezza', value: 'Normativa', icon: 'mdi:ruler-square' }, { label: 'Materiali', value: 'Recupero', icon: 'mdi:tools' }, { label: 'Precisione', value: 'Millimetrica', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/ja.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'DIY・建設プロジェクト向けツールと計算機',
+  description: '無料のオンラインツールでDIYプロジェクトを計画しましょう。粘土の収縮、レジン混合、コンクリート、カット最適化、階段の設計などの計算機。',
+  seo: [
+    { type: 'title', text: 'ホームエンジニアリングとDIYプロジェクト：設計から実現まで', level: 2 },
+    { type: 'paragraph', html: '<strong>DIY (Do It Yourself)</strong> ムーブメントは、単なる趣味ではなく、技術的および創造的な自立の形へと進化しました。このセクションでは、プロフェッショナルな結果を求めるメーカー、職人、建設愛好家向けに設計された一連の<strong>無料オンラインツール</strong>を提供しています。' },
+    { type: 'stats', columns: 2, items: [{ label: '最適化', value: '材料利用率 95%+', icon: 'mdi:saw-blade' }, { label: '安全性', value: '規格準拠', icon: 'mdi:ruler-square' }, { label: '材料', value: '再利用', icon: 'mdi:tools' }, { label: '精度', value: 'ミリ単位', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/ko.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'DIY 및 건설 프로젝트를 위한 도구와 계산기',
+  description: '무료 온라인 도구로 DIY 프로젝트를 계획하세요. 점토 수축, 레진 혼합, 콘크리트, 절단 최적화 및 계단 레이아웃 계산기.',
+  seo: [
+    { type: 'title', text: '홈 엔지니어링 및 DIY 프로젝트: 설계에서 현실까지', level: 2 },
+    { type: 'paragraph', html: '<strong>DIY (Do It Yourself)</strong> 운동은 더 이상 단순한 취미가 아니라 기술적, 창의적 자립의 형태가 되었습니다. 이 섹션에서는 전문적인 결과를 원하는 메이커, 장인 및 건설 애호가들을 위해 설계된 일련의 <strong>무료 온라인 도구</strong>를 제공합니다.' },
+    { type: 'stats', columns: 2, items: [{ label: '최적화', value: '자재 95%+', icon: 'mdi:saw-blade' }, { label: '안전', value: '규격 준수', icon: 'mdi:ruler-square' }, { label: '자재', value: '재활용', icon: 'mdi:tools' }, { label: '정밀도', value: '밀리미터 단위', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/nl.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Tools en Calculators voor DIY en Bouwprojecten',
+  description: 'Plan je DIY projecten met gratis online tools. Calculators voor kleikrimp, harsmengsels, beton, zaagoptimalisatie en trappenlay-out.',
+  seo: [
+    { type: 'title', text: 'Thuisengineering en DIY projecten: Van Ontwerp tot Realiteit', level: 2 },
+    { type: 'paragraph', html: 'De <strong>Do It Yourself (DIY)</strong> beweging is niet langer een simpele hobby, maar een vorm van technische en creatieve soevereiniteit. In deze sectie bieden we een reeks <strong>gratis online tools</strong> aan, ontworpen voor makers, ambachtslieden en bouwliefhebbers die op zoek zijn naar professionele resultaten.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optimalisatie', value: 'Materiaal 95%+', icon: 'mdi:saw-blade' }, { label: 'Veiligheid', value: 'Volgens Normen', icon: 'mdi:ruler-square' }, { label: 'Materialen', value: 'Hergebruik', icon: 'mdi:tools' }, { label: 'Precisie', value: 'Millimeternauwkeurig', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/pl.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Narzędzia i Kalkulatory dla Projektów DIY i Budowlanych',
+  description: 'Zaplanuj swoje projekty DIY dzięki darmowym narzędziom online. Kalkulatory skurczu gliny, mieszanek żywicy, betonu, optymalizatory cięcia i tyczenia schodów.',
+  seo: [
+    { type: 'title', text: 'Inżynieria domowa i projekty DIY: Od projektu do rzeczywistości', level: 2 },
+    { type: 'paragraph', html: 'Ruch <strong>Do It Yourself (DIY)</strong> przestał być zwykłym hobby, stając się formą technicznej i kreatywnej suwerenności. W tej sekcji udostępniamy zestaw <strong>darmowych narzędzi online</strong> zaprojektowanych dla twórców, rzemieślników i entuzjastów budownictwa szukających profesjonalnych efektów.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optymalizacja', value: 'Materiał 95%+', icon: 'mdi:saw-blade' }, { label: 'Bezpieczeństwo', value: 'Zgodne z Normatywami', icon: 'mdi:ruler-square' }, { label: 'Materiały', value: 'Odzysk', icon: 'mdi:tools' }, { label: 'Precyzja', value: 'Milimetrowa', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/pt.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Ferramentas e Calculadoras para Projetos DIY e Construção',
+  description: 'Planeie os seus projetos de bricolage com ferramentas online gratuitas. Calculadoras de contração de argila, misturas de resina, betão, otimizadores de corte e traçado de escadas.',
+  seo: [
+    { type: 'title', text: 'Engenharia Doméstica e Projetos DIY: Do Design à Realidade', level: 2 },
+    { type: 'paragraph', html: 'O movimento <strong>Do It Yourself (DIY)</strong> deixou de ser um simples passatempo para se tornar uma forma de soberania técnica e criativa. Nesta secção, fornecemos uma suite de <strong>ferramentas online gratuitas</strong> concebidas para makers, artesãos e entusiastas da construção que procuram resultados profissionais.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Otimização', value: 'Material 95%+', icon: 'mdi:saw-blade' }, { label: 'Segurança', value: 'Normativa', icon: 'mdi:ruler-square' }, { label: 'Materiais', value: 'Recuperação', icon: 'mdi:tools' }, { label: 'Precisão', value: 'Milimétrica', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/ru.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Инструменты и калькуляторы для DIY и строительных проектов',
+  description: 'Планируйте свои DIY-проекты с помощью бесплатных онлайн-инструментов. Калькуляторы усадки глины, смесей смол, бетона, оптимизаторы резки и планировка лестниц.',
+  seo: [
+    { type: 'title', text: 'Домашняя инженерия и DIY-проекты: от идеи к реальности', level: 2 },
+    { type: 'paragraph', html: 'Движение <strong>Do It Yourself (DIY)</strong> перестало быть просто хобби, превратившись в форму технического и творческого суверенитета. В этом разделе мы предоставляем набор <strong>бесплатных онлайн-инструментов</strong>, разработанных для мейкеров, мастеров и любителей строительства, стремящихся к профессиональным результатам.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Оптимизация', value: 'Материал 95%+', icon: 'mdi:saw-blade' }, { label: 'Безопасность', value: 'Нормативы', icon: 'mdi:ruler-square' }, { label: 'Материалы', value: 'Восстановление', icon: 'mdi:tools' }, { label: 'Точность', value: 'Миллиметровая', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/sv.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Verktyg och kalkylatorer för DIY och byggprojekt',
+  description: 'Planera dina DIY projekt med kostnadsfria onlineverktyg. Kalkylatorer för lerkrympning, hartsmixer, betong, skäroptimerare och trapplayout.',
+  seo: [
+    { type: 'title', text: 'Hemteknik och DIY projekt: Från design till verklighet', level: 2 },
+    { type: 'paragraph', html: '<strong>Do It Yourself (DIY)</strong>-rörelsen är inte längre bara en hobby utan en form av teknisk och kreativ självständighet. I den här sektionen tillhandahåller vi en uppsättning <strong>kostnadsfria onlineverktyg</strong> designade för makare, hantverkare och byggentusiaster som söker professionella resultat.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optimering', value: 'Material 95%+', icon: 'mdi:saw-blade' }, { label: 'Säkerhet', value: 'Enligt Standard', icon: 'mdi:ruler-square' }, { label: 'Material', value: 'Återvinning', icon: 'mdi:tools' }, { label: 'Precision', value: 'Millimeterprecision', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/tr.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: 'Kendin Yap (DIY) ve İnşaat Projeleri için Araçlar ve Hesaplayıcılar',
+  description: 'Ücretsiz çevrimiçi araçlarla DIY projelerinizi planlayın. Kil çekmesi, reçine karışımları, beton, kesim optimizasyonu ve merdiven düzeni hesaplayıcıları.',
+  seo: [
+    { type: 'title', text: 'Ev Mühendisliği ve DIY Projeleri: Tasarımdan Gerçeğe', level: 2 },
+    { type: 'paragraph', html: '<strong>Do It Yourself (DIY)</strong> hareketi artık basit bir hobiden öte, teknik ve yaratıcı bir egemenlik biçimi haline geldi. Bu bölümde, profesyonel sonuçlar arayan yapımcılar, zanaatkarlar ve inşaat meraklıları için tasarlanmış bir dizi <strong>ücretsiz çevrimiçi araç</strong> sunuyoruz.' },
+    { type: 'stats', columns: 2, items: [{ label: 'Optimizasyon', value: 'Malzeme %95+', icon: 'mdi:saw-blade' }, { label: 'Güvenlik', value: 'Standartlara Uygun', icon: 'mdi:ruler-square' }, { label: 'Malzeme', value: 'Geri Kazanım', icon: 'mdi:tools' }, { label: 'Hassasiyet', value: 'Milimetrik', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/i18n/zh.ts

@@ -0,0 +1,12 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'diy',
+  title: '针对 DIY 和建筑项目的工具与计算器',
+  description: '使用免费在线工具规划您的 DIY 项目。包含粘土收缩、树脂混合、混凝土、切割优化和楼梯布局等计算器。',
+  seo: [
+    { type: 'title', text: '居家工程与 DIY 项目：从设计到现实', level: 2 },
+    { type: 'paragraph', html: '<strong>DIY (Do It Yourself)</strong> 运动已不再仅仅是一种简单的爱好，而是一种技术和创造力的自主形式。在本节中，我们为寻求专业效果的高手、工匠和建筑爱好者提供了一系列<strong>免费在线工具</strong>。' },
+    { type: 'stats', columns: 2, items: [{ label: '优化', value: '材料利用 95%+', icon: 'mdi:saw-blade' }, { label: '安全', value: '符合标准', icon: 'mdi:ruler-square' }, { label: '材料', value: '回收利用', icon: 'mdi:tools' }, { label: '精度', value: '毫米级', icon: 'mdi:calculator' }] },
+  ],
+};

package/src/category/index.ts

@@ -17,9 +17,21 @@ export const diyCategory: DiyCategoryEntry = {
   icon: 'mdi:hand',
   tools: [clayCalculator, epoxyCalculator, balusterCalculator, mortarCalculator, passepartoutCalculator, concreteCalculator, cutOptimizer, voltageDropCalculator, furnitureFit, thermalExpansionCalculator, drillCalculator, stairCalculator, drillSharpener],
   i18n: {
-    es: () => import('./i18n/es').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
     en: () => import('./i18n/en').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),
   },
 };
 

package/src/tests/faq_count.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect } from 'vitest';
 import type * as DATA from '../data';
 
-const TOOLS: typeof DATA.diyCategory[] = [];
+const TOOLS: typeof DATA.audiovisualCategory[] = [];
 
 describe('FAQ Content Validation', () => {
   TOOLS.forEach((entry) => {

package/src/tests/i18n_coverage.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
+];
+
+describe('I18n Coverage Validation', () => {
+  it('all tools should be registered', () => {
+    expect(ALL_TOOLS.length).toBeGreaterThan(0);
+  });
+
+  ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should have all 15 required locales', () => {
+        const registeredLocales = Object.keys(entry.i18n);
+        EXPECTED_LOCALES.forEach((locale) => {
+          expect(
+            registeredLocales,
+            `Tool "${entry.id}" is missing locale "${locale}"`,
+          ).toContain(locale);
+        });
+      });
+
+      it('all locale loaders should be functions', () => {
+        EXPECTED_LOCALES.forEach((locale) => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          expect(
+            typeof loader,
+            `Tool "${entry.id}" locale "${locale}" loader is not a function`,
+          ).toBe('function');
+        });
+      });
+    });
+  });
+});

package/src/tests/locale_completeness.test.ts

@@ -35,8 +35,8 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('at least one tool is registered', () => {
-    expect(ALL_TOOLS.length).toBeGreaterThan(0);
+  it('all 13 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(13);
   });
 });
 

package/src/tests/seo_length.test.ts

@@ -1,8 +1,11 @@
 import { describe, it, expect } from 'vitest';
 import * as DATA from '../data';
 
+import { ALL_TOOLS } from '../tools';
+
 const ENTRIES = [
   { id: 'diyCategory', i18n: DATA.diyCategory.i18n },
+  ...ALL_TOOLS.map(tool => ({ id: tool.entry.id, i18n: tool.entry.i18n }))
 ];
 
 describe('SEO Content Length Validation', () => {

package/src/tests/slug_uniqueness.test.ts

@@ -0,0 +1,58 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Slug Localization and Uniqueness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('every locale should have a unique, translated slug', async () => {
+        const slugs = new Map<string, string>();
+        const locales = Object.keys(tool.entry.i18n);
+
+        let enSlug = '';
+        if (locales.includes('en')) {
+          const enLoader = tool.entry.i18n['en' as keyof typeof tool.entry.i18n];
+          const enContent = (await enLoader?.()) as ToolLocaleContent;
+          enSlug = enContent.slug;
+        }
+
+        const sharingLocales = ['ja', 'ko', 'zh'];
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+
+          expect(
+            content.slug,
+            `Tool "${tool.entry.id}" locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+          ).toMatch(/^[a-z0-9-]+$/);
+
+          if (locale === 'en') {
+            continue;
+          }
+
+          if (sharingLocales.includes(locale)) {
+            expect(
+              content.slug,
+              `Tool "${tool.entry.id}" locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+            ).toBe(enSlug);
+          } else {
+            expect(
+              content.slug,
+              `Tool "${tool.entry.id}" locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propia idioma`,
+            ).not.toBe(enSlug);
+
+            const previousLocale = slugs.get(content.slug);
+            if (previousLocale) {
+              expect(
+                false,
+                `Tool "${tool.entry.id}" locales "${locale}" and "${previousLocale}" share the same slug ("${content.slug}"). Cada slug tiene que estar en su propia idioma`,
+              ).toBe(true);
+            }
+            slugs.set(content.slug, locale);
+          }
+        }
+      });
+    });
+  });
+});

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

@@ -0,0 +1,264 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { BalusterCalculatorUI } from '../ui';
+
+const slug = 'baluster-rechner';
+const title = 'Baluster Rechner: Exakter Abstand für Geländer';
+const description =
+  'Berechnen Sie den exakten Abstand zwischen Stäben oder Balustern für Geländer unter Einhaltung der 10-cm-Regel. Automatische Pläne.';
+
+const faqData = [
+  {
+    question: 'Was ist der gesetzliche Maximalabstand zwischen Balustern?',
+    answer:
+      'In den meisten internationalen Bauvorschriften darf der lichte Abstand zwischen den Elementen eines Geländers den Durchgang einer Kugel mit 10 cm Durchmesser nicht zulassen, um Unfälle mit Kindern zu vermeiden.',
+  },
+  {
+    question: 'Wie wird der Abstand gemessen: zwischen den Mitten oder den Lücken?',
+    answer:
+      "Unser Rechner liefert beides. Der 'lichte Abstand' ist die tatsächliche Lücke zwischen den Stäben (entscheidend für die Sicherheit), während der 'Mittenabstand' (on-center) angibt, wo jeder Baluster gebohrt oder befestigt werden muss.",
+  },
+  {
+    question: 'Was passiert, wenn die Verteilung nicht exakt aufgeht?',
+    answer:
+      'Der Rechner passt die Anzahl der Stäbe automatisch so an, dass die erste und die letzte Lücke identisch sind, was visuelle Symmetrie und die strikte Einhaltung der maximal zulässigen Lücke garantiert.',
+  },
+  {
+    question: 'Ist es besser, Baluster zu schweißen oder zu schrauben?',
+    answer:
+      'Das hängt vom Material ab. Bei Stahl bietet Schweißen maximale strukturelle Steifigkeit. Bei Holz oder Aluminium werden mechanische Verankerungen oder durchgehende Schrauben verwendet. Wichtig ist, dass das Geländer einer horizontalen Kraft von mindestens 0,8 kN/m standhält.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Gesamtlänge messen',
+    text: 'Messen Sie den exakten Abstand zwischen dem ersten und dem letzten Pfosten, an dem das Geländer installiert wird.',
+  },
+  {
+    name: 'Balusterbreite definieren',
+    text: 'Messen Sie die Breite eines einzelnen Stabes (z. B. 2x2 cm bei Quadratrohr oder den Durchmesser bei Rundstäben).',
+  },
+  {
+    name: 'Maximale Lücke festlegen',
+    text: 'Geben Sie den gewünschten maximalen Abstand an (empfohlen sind 10 cm zur Einhaltung der Vorschriften).',
+  },
+  {
+    name: 'Installationsmarkierungen erhalten',
+    text: 'Überprüfen Sie die Liste der exakten Positionen für die Bohrungen, um eine symmetrische und sichere Verteilung zu gewährleisten.',
+  },
+];
+
+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<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    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<BalusterCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Häufig gestellte Fragen',
+  faq: faqData,
+  bibliographyTitle: 'Technische Referenzen',
+  bibliography: [
+    {
+      name: 'DIN 18065 - Treppenmaße und Geländer (Deutschland)',
+      url: 'https://www.beuth.de/de/norm/din-18065/324683526',
+    },
+    {
+      name: 'IRC - International Residential Code (USA)',
+      url: 'https://codes.iccsafe.org/content/IRC2021',
+    },
+    {
+      name: 'IBC - International Building Code',
+      url: 'https://codes.iccsafe.org/content/IBC2021',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Ultimativer Leitfaden: So berechnen Sie den Balusterabstand für Geländer',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Die Gestaltung eines sicheren und ästhetisch perfekten Geländers ist eine Kunst, die mathematische Präzision mit Bauvorschriften kombiniert. Ob für eine Terrasse, einen Balkon oder eine Innentreppe, die korrekte Berechnung der Baluster (oder Stäbe) ist der kritischste Schritt des Projekts. Ein Rechenfehler ruiniert nicht nur die visuelle Symmetrie, sondern kann Ihre Struktur illegal und unsicher machen.',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:alert-circle-outline',
+      title: 'Warum ist diese Berechnung so wichtig?',
+      html: '<p>Es geht nicht nur darum, eine Lücke zu füllen. Es geht um die Einhaltung der <strong>4-Zoll-Kugel-Regel (10 cm)</strong>, einer internationalen Sicherheitsnorm zur Vermeidung von Unfällen mit Kindern.</p>',
+    },
+    {
+      type: 'title',
+      text: '1. Sicherheitsvorschriften: Die 10-cm-Regel',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Bevor Sie das erste Stück Holz oder Metall schneiden, müssen Sie das „Warum“ hinter der Mathematik verstehen. Die Bauvorschriften in vielen Ländern, wie auch der IRC (International Residential Code) in den USA, legen eine klare Norm fest: <em>„Der lichte Abstand zwischen vertikalen Elementen darf den Durchgang einer Kugel mit 10 cm (4 Zoll) Durchmesser nicht zulassen.“</em>',
+    },
+    {
+      type: 'paragraph',
+      html: 'Dieses Maß ist nicht willkürlich. Es ist der durchschnittliche Kopfdurchmesser eines Kleinkindes (normalerweise unter einem Jahr). Wenn ein Kind mit dem Körper hindurchkommt, aber der Kopf stecken bleibt, ist das Erstickungsrisiko extrem hoch. Wenn es mit dem Kopf hindurchkommt, kann es in die Tiefe stürzen. Daher ist das Ziel unseres <strong>Baluster-Rechners</strong> nicht nur die Ästhetik, sondern das Retten von Leben.',
+    },
+    {
+      type: 'title',
+      text: '2. Das mathematische Problem: Der Zaunpfostenfehler',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'In der Programmierung und im Bauwesen gibt es ein klassisches Problem namens <em>„Fencepost Error“</em> (Zaunpfostenfehler). Wenn Sie einen 10 Meter langen Zaun mit Pfosten alle 1 Meter bauen wollen, wie viele Pfosten benötigen Sie? Die intuitive Antwort ist 10, aber die richtige ist 11.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Bei Balustern ist es ähnlich, aber komplexer, da die Breite des Balusters selbst Platz beansprucht. Die Formel, die unser Tool verwendet, löst dieses Gleichungssystem für Sie:',
+    },
+    {
+      type: 'grid',
+      columns: [
+        {
+          type: 'card',
+          icon: 'mdi:calculator',
+          title: 'Schritt A: Lücken berechnen',
+          html: '<p class="bc-formula">n = (L - g_max) / (w + g_max)</p><p>Zuerst bestimmen wir, wie viele Baluster theoretisch passen würden, wenn wir den maximal zulässigen Raum nutzen würden. Wir runden diese Zahl auf, um sicherzustellen, dass die resultierenden Lücken <em>kleiner</em> als das Maximum sind.</p>',
+        },
+        {
+          type: 'card',
+          icon: 'mdi:function-variant',
+          title: 'Schritt B: Exakten Abstand neuberechnen',
+          html: '<p class="bc-formula">g = (L - n × w) / (n + 1)</p><p>Sobald wir die exakte Anzahl der Baluster (n) kennen, berechnen wir, wie viel Platz „übrig bleibt“, wenn wir die Breite des gesamten Materials abziehen, und verteilen diesen gleichmäßig auf die Lücken (n+1).</p>',
+        },
+      ],
+    },
+    {
+      type: 'title',
+      text: '3. Schritt-für-Schritt-Anleitung für die perfekte Installation',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Die Zahlen zu haben, ist nur die halbe Miete. Hier erklären wir, wie Sie diese Zahlen vom Papier (oder Bildschirm) in die Realität Ihres Bauprojekts übertragen.',
+    },
+    {
+      type: 'title',
+      text: 'Schritt 1: Präzisionsmessung',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Messen Sie den <strong>inneren</strong> Abstand zwischen Pfosten und Pfosten. Messen Sie nicht von der Mitte des Pfostens. Sie müssen das exakte lichte Maß kennen, das Sie füllen werden (L). Wenn Ihr Geländer mehrere Abschnitte hat, messen Sie jeden einzeln; Konstruktionen sind selten perfekt rechtwinklig, und ein Fehler von 0,5 cm kann die Symmetrie ruinieren.',
+    },
+    {
+      type: 'title',
+      text: 'Schritt 2: Die Mitte finden',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Der Anfängerfehler Nummer eins ist, mit dem Setzen der Baluster von einem Ende zum anderen zu beginnen. Dies führt fast immer zu einer seltsam großen oder kleinen letzten Lücke, was die visuelle Harmonie stört.<ul><li>Markieren Sie die <strong>exakte Mitte</strong> des Geländers (L / 2).</li><li>Entscheiden Sie, ob Sie in der Mitte einen <em>Baluster</em> oder eine <em>Lücke</em> haben möchten.</li><li>Wenn Sie einen Baluster in der Mitte möchten: Markieren Sie die Hälfte der Balusterbreite auf jeder Seite Ihrer Mittelmarkierung.</li><li>Wenn Sie eine Lücke in der Mitte möchten: Markieren Sie die Hälfte des Lückenabstands (g / 2) auf jeder Seite.</li></ul>',
+    },
+    {
+      type: 'title',
+      text: 'Schritt 3: Einen Abstandshalter (Spacer) anfertigen',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Verwenden Sie nicht für jeden Baluster das Maßband. Der kumulative menschliche Fehler wird dazu führen, dass der letzte Baluster um mehrere Zentimeter abweicht. Professionell ist es, einen Holzblock (oder zwei) mit dem exakten Maß der Lücke (g) zuzuschneiden, das Ihnen unser Rechner ausgegeben hat.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Verwenden Sie diesen Block als physische Schablone. Setzen Sie einen Baluster, legen Sie den Block an, setzen Sie den nächsten Baluster fest gegen den Block und fixieren Sie ihn. Dies garantiert millimetergenaue Konsistenz.',
+    },
+    {
+      type: 'title',
+      text: '4. Benötigte Materialien und Werkzeuge',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:tools',
+      title: 'Ausrüstung für ein professionelles Finish',
+      html: '<ul><li>Hochpräzises Maßband</li><li>Zimmermannsbleistift</li><li>Wasserwaage (für die Vertikalität)</li><li>Kappsäge (für saubere Schnitte)</li><li>Bohrer und Holzschrauben</li><li>Abstandshalter (maßgefertigt)</li></ul>',
+    },
+    {
+      type: 'title',
+      text: '5. Zusätzliche technische Fragen',
+      level: 3,
+    },
+    {
+      type: 'card',
+      icon: 'mdi:help-circle-outline',
+      title: 'Was passiert, wenn die letzte Lücke nicht passt?',
+      html: '<p>Wenn Sie unseren Rechner verwendet haben, sollte dies nicht passieren. In der realen Welt verbiegt sich jedoch Holz, und Pfosten sind nicht immer gerade. Wenn Ihnen am Ende 1-2 mm fehlen oder zu viel sind, ist das unmerklich. Wenn Ihnen 1 cm fehlt, überprüfen Sie Ihre Abstandshalter; wahrscheinlich haben Sie sich bei jedem Schritt Millimeter „eingefressen“.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:shield-check-outline',
+      title: 'Kann ich die Baluster weiter auseinander setzen, wenn ich keine Kinder habe?',
+      html: '<p>Rechtlich gesehen: Nein. Die Bauvorschriften gelten für das Haus, nicht für die aktuellen Bewohner. Wenn Sie das Haus eines Tages verkaufen, wird ein Geländer außerhalb der Norm bei der Inspektion ein Problem sein. Zudem können Besucher (Nichten, Enkel) in Gefahr sein.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:wrench-outline',
+      title: 'Holz, Metall oder Glas?',
+      html: '<p>Dieser Rechner funktioniert für <strong>jedes sich wiederholende vertikale Element</strong>. Wenn Sie horizontale Stahlseile verwenden, sind die Vorschriften anders (normalerweise dürfen sie nicht zum Klettern einladen, „Leitereffekt“). Bei Glas wird es als durchgehende Platte betrachtet, und es gilt kein Abstand, sondern die Schlagfestigkeit.</p>',
+    },
+    {
+      type: 'card',
+      icon: 'mdi:format-quote-close',
+      title: 'Mies van der Rohe',
+      html: '<p><em>„Architektur ist der Wille der Epoche, in den Raum übersetzt.“</em></p><p>Wir hoffen, dass dieses Tool Ihnen hilft, sicherere und schönere Räume zu bauen. Denken Sie immer daran, die örtlichen Bauvorschriften Ihrer Gemeinde zu konsultieren, da es spezifische Variationen bei der Mindesthöhe (normalerweise 90–110 cm) oder den Belastungen geben kann.</p>',
+    },
+  ],
+  ui: {
+    sectionTitle: 'Abmessungen',
+    sectionDesc: 'Geben Sie die Maße Ihres Geländers ein',
+    labelRailLength: 'Gesamtlänge (L)',
+    labelBalusterWidth: 'Balusterbreite (w)',
+    labelMaxGap: 'Maximaler Abstand (g)',
+    blueprintTitle: 'Montageplan',
+    blueprintRef: 'REF: BAL-001 // SKALA: AUTO',
+    labelRequired: 'Benötigte Baluster',
+    labelExactGap: 'Exakte Lücke',
+    labelOnCenter: 'Mitte zu Mitte',
+    labelTotalSpaces: 'Gesamtanzahl Lücken',
+    labelCoveredLength: 'Abgedeckte Länge',
+    labelDisclaimer: '* Die gezeigten Dimensionen sind Näherungswerte zur Visualisierung.',
+  },
+};