@jjlmoya/utils-diy 1.26.0 → 1.27.0

package/package.json

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

package/src/category/index.ts

@@ -13,10 +13,11 @@ import { drillCalculator } from '../tool/drillCalculator/entry';
 import { stairCalculator } from '../tool/stairCalculator/entry';
 import { drillSharpener } from '../tool/drillSharpener/entry';
 import { workshopFractionConverter } from '../tool/workshopFractionConverter/entry';
+import { excavationVolumeCalculator } from '../tool/excavationVolumeCalculator/entry';
 
 export const diyCategory: DiyCategoryEntry = {
   icon: 'mdi:hand',
-  tools: [clayCalculator, epoxyCalculator, balusterCalculator, mortarCalculator, passepartoutCalculator, concreteCalculator, cutOptimizer, voltageDropCalculator, furnitureFit, thermalExpansionCalculator, drillCalculator, stairCalculator, drillSharpener, workshopFractionConverter],
+  tools: [clayCalculator, epoxyCalculator, balusterCalculator, mortarCalculator, passepartoutCalculator, concreteCalculator, cutOptimizer, voltageDropCalculator, furnitureFit, thermalExpansionCalculator, drillCalculator, stairCalculator, drillSharpener, workshopFractionConverter, excavationVolumeCalculator],
   i18n: {
     de: () => import('./i18n/de').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),

package/src/entries.ts

@@ -19,6 +19,8 @@ export { pythagoreanRightAngleCalculator } from './tool/pythagoreanRightAngleCal
 export { twoStrokeMixtureCalculator } from './tool/twoStrokeMixtureCalculator/entry';
 export { drywallCalculatorEntry } from './tool/drywallCalculator/entry';
 export type { DrywallCalculatorLocaleContent } from './tool/drywallCalculator/entry';
+export { excavationVolumeCalculator } from './tool/excavationVolumeCalculator/entry';
+export type { ExcavationVolumeCalculatorLocaleContent } from './tool/excavationVolumeCalculator/entry';
 export { diyCategory } from './category';
 import { balusterCalculator } from './tool/balusterCalculator/entry';
 import { clayCalculator } from './tool/clayCalculator/entry';
@@ -27,6 +29,7 @@ import { cutOptimizer } from './tool/cutOptimizer/entry';
 import { drillCalculator } from './tool/drillCalculator/entry';
 import { drillSharpener } from './tool/drillSharpener/entry';
 import { drywallCalculatorEntry } from './tool/drywallCalculator/entry';
+import { excavationVolumeCalculator } from './tool/excavationVolumeCalculator/entry';
 import { epoxyCalculator } from './tool/epoxyCalculator/entry';
 import { furnitureFit } from './tool/furnitureFit/entry';
 import { mortarCalculator } from './tool/mortarCalculator/entry';
@@ -37,4 +40,4 @@ import { voltageDropCalculator } from './tool/voltageDropCalculator/entry';
 import { workshopFractionConverter } from './tool/workshopFractionConverter/entry';
 import { pythagoreanRightAngleCalculator } from './tool/pythagoreanRightAngleCalculator/entry';
 import { twoStrokeMixtureCalculator } from './tool/twoStrokeMixtureCalculator/entry';
-export const ALL_ENTRIES = [balusterCalculator, clayCalculator, concreteCalculator, cutOptimizer, drillCalculator, drillSharpener, drywallCalculatorEntry, epoxyCalculator, furnitureFit, mortarCalculator, passepartoutCalculator, stairCalculator, thermalExpansionCalculator, voltageDropCalculator, workshopFractionConverter, pythagoreanRightAngleCalculator, twoStrokeMixtureCalculator];
+export const ALL_ENTRIES = [balusterCalculator, clayCalculator, concreteCalculator, cutOptimizer, drillCalculator, drillSharpener, drywallCalculatorEntry, epoxyCalculator, furnitureFit, mortarCalculator, passepartoutCalculator, stairCalculator, thermalExpansionCalculator, voltageDropCalculator, workshopFractionConverter, pythagoreanRightAngleCalculator, twoStrokeMixtureCalculator, excavationVolumeCalculator];

package/src/tests/locale_completeness.test.ts

@@ -33,8 +33,7 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 17 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(17);
+  it('all 18 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(18);
   });
 });
-

package/src/tests/seo_translation_completeness.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const ASIAN_LOCALES = ['ja', 'ko', 'zh'];
+
+function getSimpleSectionLength(section: any): number {
+  if (section.type === 'title') return section.text ? section.text.length : 0;
+  if (section.type === 'paragraph') return section.html ? section.html.replace(/<[^>]*>/g, '').length : 0;
+  if (section.type === 'list') return section.items ? section.items.join('').length : 0;
+  return 0;
+}
+
+function getComplexSectionLength(section: any): number {
+  if (section.type === 'diagnostic' || section.type === 'tip') {
+    return (section.title ? section.title.length : 0) + (section.html ? section.html.replace(/<[^>]*>/g, '').length : 0);
+  }
+  if (section.type === 'table') {
+    return ((section.headers || []).join('').length) + ((section.rows || []).flat().join('').length);
+  }
+  return 0;
+}
+
+function getSectionLength(section: any): number {
+  return getSimpleSectionLength(section) || getComplexSectionLength(section);
+}
+
+function calculateSeoTextLength(seoSections: any[]): number {
+  return seoSections.reduce((acc, section) => acc + getSectionLength(section), 0);
+}
+
+function checkLocaleSeoLength(toolId: string, locale: string, localeLen: number, enLen: number): void {
+  const isAsian = ASIAN_LOCALES.includes(locale);
+  const minLength = Math.floor(enLen * (isAsian ? 0.25 : 0.70));
+  const msgType = isAsian ? 'suspiciously short' : 'truncated/lazy';
+
+  expect(
+    localeLen,
+    `[LAZY SEO TRANSLATION] Tool "${toolId}" locale "${locale}" SEO text is ${msgType} (${localeLen} chars vs EN ${enLen} chars, expected min ${minLength})`,
+  ).toBeGreaterThanOrEqual(minLength);
+}
+
+async function auditSingleLocale(toolId: string, locale: string, loader: any, enSeoLength: number): Promise<void> {
+  if (locale === 'en' || !loader) return;
+  const content = await loader();
+  if (!content.seo || !Array.isArray(content.seo)) return;
+
+  checkLocaleSeoLength(toolId, locale, calculateSeoTextLength(content.seo), enSeoLength);
+}
+
+describe('SEO Translation Completeness & Laziness Audit', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should not have lazy or truncated SEO content compared to English reference', async () => {
+        const enLoader = entry.i18n['en' as keyof typeof entry.i18n];
+        if (!enLoader) return;
+
+        const enContent = await enLoader();
+        if (!enContent.seo || !Array.isArray(enContent.seo)) return;
+
+        const enSeoLength = calculateSeoTextLength(enContent.seo);
+
+        for (const [locale, loader] of Object.entries(entry.i18n)) {
+          await auditSingleLocale(entry.id, locale, loader, enSeoLength);
+        }
+      });
+    });
+  });
+});
+

package/src/tests/tool_validation.test.ts

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

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

@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Planen Sie stets <strong>10% Verschnittreserve</strong> für Profile und Platten ein. Für die Fugenverspachtelung werden ca. 0,8 kg Spachtelmasse pro Quadratmeter Plattenfläche zusammen mit Fugendeckstreifen benötigt.',
+      html: 'Planen Sie stets <strong>10% Verschnittreserve</strong> für Profile und Platten ein, um Ausgleiche bei Türausschnitten, Fensterleibungen und Deckenanschlüssen abzudecken. Für die fachgerechte Fugenverspachtelung der Verspachtelungsstufen Q1 bis Q4 werden ca. 0,8 kg Fugenspachtelmasse pro Quadratmeter Plattenfläche zusammen mit passenden Glasfaser- oder Papier-Fugendeckstreifen zur Vermeidung von Spannungsrissen benötigt.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/id.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Pemasangan dinding partisi ringan papan gypsum memerlukan perhitungan matang pada rangka hollow baja galvanis (stud dan runner) serta pembagian sambungan papan. Penataan rangka yang tepat mencegah lendutan dan retak pada sambungan.',
+      html: 'Pemasangan dinding partisi ringan papan gypsum memerlukan perhitungan teknis yang matang pada rangka hollow baja galvanis (stud vertikal CW dan runner horizontal UW) serta pembagian layout susunan lembaran papan. Sesuai dengan standar teknis konstruksi, penataan rangka yang presisi mencegah lendutan struktur dinding, kerusakan lendut, dan retak pada bagian sambungan antar papan.',
     },
     {
       type: 'title',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Selalu tambahkan margin <strong>10% faktor sisa</strong> untuk mengantisipasi potongan sekitar jendela dan pintu. Pengolahan sambungan membutuhkan sekitar 0.8 kg kompon per meter persegi permukaan papan.',
+      html: 'Selalu tambahkan margin <strong>10% faktor sisa pemotongan</strong> untuk mengantisipasi potongan sekitar celah jendela, bukaan pintu, dan sudut plafon. Untuk penyelesaian sambungan permukaan (tingkat finishing Q1 hingga Q4), dibutuhkan sekitar 0.8 kg kompon perekat papan gypsum per meter persegi permukaan papan beserta pita kasa penguat sambungan.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/it.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'La costruzione di sistemi a secco in cartongesso richiede il calcolo accurato dell\'orditura metallica in acciaio zincato (montanti C e guide U) e la sfalsatura dei giunti secondo le norme EN 520 per evitare fessurazioni.',
+      html: 'La costruzione di sistemi a secco con lastre di cartongesso richiede il calcolo accurato dell\'orditura metallica in acciaio zincato (montanti verticali C e guide orizzontali U) e la corretta sfalsatura dei giunti secondo le normative EN 520 per garantire la stabilita ed evitare fessurazioni nel tempo.',
     },
     {
       type: 'title',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Considera sempre un <strong>10% di margine per gli sfridi</strong> di taglio. La stuccatura dei giunti richiede circa 0.8 kg di stucco in polvere o pronto all\'uso per metro quadrato di superficie.',
+      html: 'Considera sempre un <strong>10% di margine per gli sfridi</strong> di taglio per compensare gli adattamenti attorno a porte, finestre e spigoli di soffitto. La stuccatura professionale dei giunti (per i livelli di finitura da Q1 a Q4) richiede circa 0.8 kg di stucco specifico per cartongesso per metro quadrato di superficie, unitamente al nastro coprigiunto in fibra di vetro o carta rinforzata.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/ja.ts

@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '開口部や端部の切りしろとして<strong>10%のロス分</strong>を見込みます。目地処理には1平米あたり約0.8kgの目地パテとジョイントテープを使用します。',
+      html: 'ドア開口部や窓枠周り、天井取り合い部分での切り落としロスに対応するため、常に<strong>10%のロス率</strong>を余分に見込んで材料を手配します。継ぎ目処理（Q1〜Q4の下地仕上げ処理）にはボード施工面積1 square meterあたり約0.8kgの目地パテと、ひび割れ防止用のグラスファイバー製またはペーパー製ジョイントテープが必要となります。',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/ko.ts

@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '문틀 및 창호 개구부 절단 자재 손실을 고려하여 <strong>10% 자재 할증률</strong>을 반영합니다. 줄눈 퍼티는 m2당 약 0.8kg이 소요됩니다.',
+      html: '문틀 및 창호 개구부, 천장 접합부의 절단 자재 손실에 대비하여 항상 <strong>10%의 자재 할증률</strong>을 추가로 계산하여 자재를 발주합니다. 석고보드 면적 1m2당 약 0.8kg의 이음매 전용 퍼티 마감재와 균열 방지용 유리섬유 테이프 또는 종이 망사 테이프가 소요됩니다.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/nl.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Het bouwen van lichte scheidingswanden met gipsplaten vereist het nauwkeurig berekenen van het stalen frame (C-staanders en U-liggers) en het verspringend aanbrengen van de plaatvoegen volgens de norm EN 520.',
+      html: 'Het bouwen van lichte scheidingswanden met gipsplaten vereist het nauwkeurig berekenen van het gegalvaniseerde stalen frame (C-staanders en U-liggers) en het verspringend aanbrengen van de plaatvoegen volgens de Europese norm EN 520 om wanddoorbuiging en scheurvorming op de naden te voorkomen.',
     },
     {
       type: 'title',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Reken altijd <strong>10% snijverlies</strong> voor profielen en platen. Het afvoegen kost ca. 0,8 kg voegpasta per vierkante meter wandopslag.',
+      html: 'Reken altijd een <strong>10% marge voor snijverlies</strong> voor profielen en platen om zaagafval bij deursparingen, raamuitsparingen en plafondaansluitingen op te vangen. Voor het professioneel afvoegen van de platen (voegafwerkingsniveau Q1 tot Q4) is circa 0,8 kg voegpasta per vierkante meter plaatoppervlak nodig, samen met papieren of glasvezel voegband om scheurvorming te voorkomen.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/pl.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Budowa lekkich scian dzialowych w systemie suchej zabudowy wymaga dokladnego przeliczenia stelasza z profili stalowych (CW i UW) oraz mijankowego ukladu spoin zgodnie z norma PN-EN 520.',
+      html: 'Budowa lekkich scian dzialowych w systemie suchej zabudowy z plyt gipsowo-kartonowych wymaga dokladnego przeliczenia stelasza z ocynkowanych profili stalowych (pionowych CW i poziomych UW) oraz mijankowego ukladu spoin zgodnie z normą PN-EN 520 w celu zapobiegania ugieciom i peknieciom.',
     },
     {
       type: 'title',
@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '<strong>Rozstaw 60 cm</strong> to standard pasujacy do plyt o szerokosci 120 cm. <strong>Rozstaw 40 cm</strong> jest wymagany pod glazure i przy wysokosciach scian powyzej 3,0 m.',
+      html: 'Osiowy rozstaw profili pionowych decyduje o sztywnosci i nośnosci calej sciany. <strong>Standardowy rozstaw 60 cm</strong> idealnie pasuje do plyt gipsowych o szerokosci 120 cm. Z kolei <strong>zagęszczony rozstaw 40 cm</strong> jest bezwzglednie wymagany pod ciezki montaz glazury i plytek ceramicznych, przy wysokosciach scian przekraczajacych 3,0 metry oraz w pomieszczeniach o podwyzszonych wymaganiach akustycznych.',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Dolicz <strong>10% zapasu na straty</strong> na dociecia przy drzwiach i oknach. Szpachlowanie spoin zuzywa ok. 0.8 kg masy na metr kwadratowy oplytowania.',
+      html: 'Zawsze doliczaj <strong>10% zapasu na straty</strong> na dociecia przy glifach drzwiowych, otworach okiennych oraz skosach sufitych. Do profesjonalnego szpachlowania spoin w standardzie od Q1 do Q4 zuzywa sie okolo 0.8 kg masy szpachlowej do plyt gipsowo-kartonowych na metr kwadratowy powierzchni wraz z tasmą zbrojacą z wlokna szklanego lub papierową.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/pt.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'A construção de vedações verticais leves em drywall exige o dimensionamento correto dos perfis metálicos em aço galvanizado (montantes C e guias U) e o amarramento das juntas segundo a norma EN 520.',
+      html: 'A construção de vedações verticais leves em drywall exige o dimensionamento preciso e criterioso dos perfis metálicos em aço galvanizado (montantes verticais C e guias horizontais U) e o amarramento de juntas segundo as diretrizes da norma EN 520 para evitar flexões estruturais e deformações.',
     },
     {
       type: 'title',
@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'O <strong>espaçamento padrão de 60 cm</strong> atende placas de 120 cm de largura. O <strong>espaçamento de 40 cm</strong> é obrigatório sob revestimentos cerâmicos e alturas superiores a 3,00 metros.',
+      html: 'O espaçamento dos montantes metálicos determina diretamente a rigidez e a capacidade de carga da parede. O <strong>espaçamento padrão de 60 cm</strong> é o mais utilizado para fixação de placas gesso acartonado com 120 cm de largura. Por outro lado, o <strong>espaçamento de 40 cm</strong> torna-se estritamente obrigatório em superfícies que receberão revestimentos cerâmicos ou porcelanatos, em paredes com pé-direito superior a 3,00 metros, bem como em divisórias com exigências acústicas elevadas.',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Considere <strong>10% de margem de perda</strong> para cortes em esquadrias. O tratamento de juntas consome cerca de 0,8 kg de massa por metro quadrado de superfície.',
+      html: 'Considere sempre uma <strong>margem de perda de 10%</strong> para recortes e ajustes em esquadrias de portas, janelas e cantos de forro. O tratamento profissional de juntas (para níveis de acabamento Q1 a Q4) consome cerca de 0,8 kg de massa para drywall por metro quadrado de superfície, juntamente com fita de fita de papel reforçada ou fibra de vidro para evitar trincas.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/ru.ts

@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '<strong>Стандартный шаг 60 см</strong> соответствует ширине листов 120 см. <strong>Шаг 40 см</strong> обязателен при облицовке тяжелой плиткой и высотах стен более 3.0 метров.',
+      html: 'Осевой шаг стоечных профилей напрямую определяет жесткость и несущую способность конструкции. <strong>Стандартный шаг 60 см</strong> идеально подходит под ширину листов 120 см. При этом <strong>усиленный шаг 40 см</strong> является строго обязательным под облицовку тяжелой керамической плиткой, при высоте перегородок более 3.0 метров, а также в помещениях с повышенными требованиями к звукоизоляции.',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Всегда учитывайте <strong>10% запас на обрезку</strong> вокруг проемов. Заделка швов требует около 0.8 кг шпаклевочной смеси на квадратный метр.',
+      html: 'Всегда учитывайте <strong>10% запас на обрезку</strong> профилей и листов для компенсации подрезки вокруг дверных откосов, оконных проемов и примыканий к потолку. Профессиональная заделка стыков (для качественной подготовки поверхностей от Q1 до Q4) требует около 0.8 кг специализированной шпаклевки для гипсокартона на квадратный метр площади вместе со стеклохолстом или армирующей бумажной лентой.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/sv.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Att bygga latta innervaggar med gipsskivor kraver exakt dimensionering av galvaniserade stålprofiler (reglar och skenor) samt forskjutning av skivskarvar enligt EN 520.',
+      html: 'Att bygga lätta innerväggar med gipsskivor kräver exakt teknisk dimensionering av galvaniserade stålprofiler (vertikala C-reglar och horisontella U-skenor) samt förskjutning av skivskarvar enligt EN 520 för att undvika väggnedböjning och sprickor.',
     },
     {
       type: 'title',
@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '<strong>Standardavstand cc 60 cm</strong> anpassas till skivbredd 120 cm. <strong>Cc 40 cm</strong> ar obligatoriskt under kakel och vid hojder over 3,0 m.',
+      html: 'Regelavståndet bestämmer väggens stabilitet och bärförmåga. <strong>Standardavstånd cc 60 cm</strong> anpassas till skivbredd 120 cm. <strong>Cc 40 cm</strong> är obligatoriskt vid tung kakelsättning eller porslinsklinker, vid vägghöjder över 3,0 meter samt i utrymmen med förhöjda ljudisoleringskrav.',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Lagg alltid till <strong>10% spillmarginal</strong> for kapningar vid dorrar och fonster. Skarvspackling fordtar ca 0.8 kg spackel per kvadratmeter.',
+      html: 'Räkna alltid med en generös <strong>spillmarginal på 10%</strong> för kapningar vid dörröppningar, fönstersmygar och takanslutningar. För professionell skarvspackling av gipsskivorna (från ytfinishsteg Q1 till Q4) krävs cirka 0,8 kg gipsbaserat skarvspackel per kvadratmeter skivyta samt pappers- eller glasfiberremsa för att undvika alla former av sprickbildning.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/tr.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Hafif bölme duvarların yapımında galvanizli çelik profillerin (C dikme ve U ray) doğru boyutlandırılması ve ek yerlerinin şaşırtmalı yerleştirilmesi TS EN 520 standartlarına göre çatlamaları önler.',
+      html: 'Hafif bölme duvarların yapımında galvanizli çelik profillerin (dikey C dikme ve yatay U ray) doğru mühendislik hesaplarıyla boyutlandırılması ve ek yerlerinin şaşırtmalı yerleştirilmesi TS EN 520 standartlarına göre duvar sehimini ve çatlamaları önler.',
     },
     {
       type: 'title',
@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '<strong>60 cm eksen aralığı</strong> 120 cm genişliğindeki plakalar için standarttır. Seramik kaplama altında ve 3.0 metreden yüksek duvarlarda <strong>40 cm eksen aralığı</strong> zorunludur.',
+      html: 'Dikme aks aralığı duvarın taşıyıcı rijitliğini belirler. <strong>60 cm eksen aralığı</strong> 120 cm genişliğindeki alçı plakalar için standarttır. Ağır seramik kaplama altında, 3.0 metreden yüksek duvarlarda ve yüksek ses yalıtımı gereken hacimlerde <strong>40 cm eksen aralığı</strong> sıkılaştırması zorunludur.',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: 'Kapı ve pencere boşluklarındaki kesimler için her zaman <strong>%10 fire payı</strong> ekleyin. Derz dolgusu için metrekare başına yaklaşık 0.8 kg alçı bazlı derz macunu gereklidir.',
+      html: 'Kapı ve pencere boşluklarındaki kesim kayıpları ile tavan birleşim detayları için her zaman <strong>%10 fire payı</strong> ekleyerek malzeme siparişi verin. Derzlerin profesyonel dolgusu ve yüzey hazırlığı için (Q1 ile Q4 yüzey kalitesi standartlarında) metrekare başına yaklaşık 0.8 kg alçı bazlı derz macunu ve çatlamayı önleyen derz bandı kullanılır.',
     },
   ],
   ui: {

package/src/tool/drywallCalculator/i18n/zh.ts

@@ -87,7 +87,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '轻钢龙骨隔墙施工中，镀锌钢板C型竖向龙骨与U型沿顶沿地龙骨的合理布置及板缝错缝排列是防止挠度变形与接缝开裂的关键。',
+      html: '在轻钢龙骨石膏板隔墙系统施工中，根据国家建筑标准规范，镀锌钢板C型竖向龙骨与U型沿顶沿地龙骨的精准尺寸计算、受力分析以及板缝交错排列是防止墙体结构挠度变形、失稳及接缝处表面开裂的核心技术保障。',
     },
     {
       type: 'title',
@@ -96,7 +96,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '<strong>60cm间距</strong>是120cm宽石膏板的标准配置。贴饰面砖或墙高大于3.0米时必须采用<strong>40cm间距</strong>。',
+      html: '龙骨的中心间距直接决定了整体隔墙的刚度与抗冲击承载能力。<strong>60cm轴线间距</strong>是适配120cm标准宽度石膏板的最常用方案；而在粘贴重型瓷砖石材面层、墙体净高超过3.0米或对隔音性能有较高要求的空间中，则必须采取<strong>40cm间距</strong>密铺加固。',
     },
     {
       type: 'card',
@@ -111,7 +111,7 @@ export const content: ToolLocaleContent<DrywallCalculatorUI> = {
     },
     {
       type: 'paragraph',
-      html: '门窗洞口裁切需预留<strong>10%损耗率</strong>。接缝处理每平方米约消耗0.8kg嵌缝腻子。',
+      html: '考虑到门窗洞口裁切、墙体边角修剪以及天花板接缝等处的材料损耗，在采购石膏板和龙骨时请务必预留<strong>10%损耗率</strong>。在进行接缝嵌缝抹灰与表面修飾处理（Q1级至Q4级接缝处理标准）时，每平方米石膏板抹灰面积约需消耗0.8kg石膏板专用嵌缝腻子，并配合玻璃纤维网格布或防裂纸带进行防裂加固。',
     },
   ],
   ui: {

package/src/tool/excavationVolumeCalculator/bibliography.astro

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

package/src/tool/excavationVolumeCalculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const excavationVolumeCalculatorBibliography: BibliographyEntry[] = [
+  {
+    name: 'FHWA Geotechnical Aspects of Pavements Reference Manual Chapter 5',
+    url: 'https://www.fhwa.dot.gov/engineering/geotech/pubs/05037/05a.cfm',
+  },
+  {
+    name: 'FHWA Technical Manual for Design and Construction of Road Tunnels Civil Elements',
+    url: 'https://www.fhwa.dot.gov/bridge/tunnel/pubs/nhi09010/tunnel_manual.pdf',
+  },
+];

package/src/tool/excavationVolumeCalculator/component.astro

@@ -0,0 +1,80 @@
+---
+import './excavation-volume-calculator.css';
+import type { ExcavationCalculatorUI } from './ui';
+
+interface Props {
+  ui?: Record<string, unknown>;
+}
+
+const { ui } = Astro.props;
+const t = (ui ?? {}) as ExcavationCalculatorUI;
+---
+
+<div class="ev-root" data-ev-root data-ev-ui={JSON.stringify(t)}>
+  <div class="ev-board">
+    <div class="ev-intro">
+      <div class="ev-intro-mark" aria-hidden="true">∿</div>
+      <p>{t.onboarding}</p>
+    </div>
+
+    <section class="ev-scene-panel" aria-labelledby="ev-scene-title">
+      <div class="ev-result-heading"><span class="ev-kicker" id="ev-scene-title">{t.sceneTitle}</span><span class="ev-status" data-ev-status>{t.soilStatusLabel}: {t.soilStatusMedium}</span></div>
+      <div class="ev-scene" data-ev-scene></div>
+      <div class="ev-metrics">
+        <div class="ev-metric ev-metric-main"><span class="ev-metric-label">{t.bankVolumeLabel}</span><strong class="ev-metric-value"><span data-ev-bank>9.98</span> <span class="ev-unit-suffix" data-ev-volume-unit>m³</span></strong><span class="ev-metric-help">{t.bankVolumeHelp}</span></div>
+        <div class="ev-metric"><span class="ev-metric-label">{t.looseVolumeLabel}</span><strong class="ev-metric-value"><span data-ev-loose-low>11.48</span> to <span data-ev-loose-high>12.47</span> <span class="ev-unit-suffix" data-ev-volume-unit>m³</span></strong><span class="ev-metric-help">{t.looseVolumeHelp}</span></div>
+      </div>
+      <div class="ev-expansion"><span>{t.expansionLabel}</span><strong data-ev-expansion>15 to 25%</strong></div>
+    </section>
+
+    <div class="ev-workbench">
+      <section class="ev-control-panel" aria-labelledby="ev-dimensions-title">
+        <div class="ev-control-heading">
+          <span class="ev-kicker" id="ev-dimensions-title">{t.dimensionLabel}</span>
+          <div class="ev-segmented" role="group" aria-label={t.unitSystemLabel}>
+            <button type="button" class="ev-active" data-ev-unit="metric">{t.unitMetric}</button>
+            <button type="button" data-ev-unit="imperial">{t.unitImperial}</button>
+          </div>
+        </div>
+
+        <fieldset class="ev-fieldset">
+          <legend>{t.dimensionLabel}</legend>
+          <div class="ev-dimensions">
+            <div class="ev-field">
+              <label for="ev-length">{t.lengthLabel}</label>
+              <div class="ev-input"><input id="ev-length" data-ev-dimension="length" type="number" min="0" step="0.01" value="4.8" inputmode="decimal" /><span class="ev-unit" data-ev-unit-label>m</span></div>
+            </div>
+            <div class="ev-field">
+              <label for="ev-width">{t.widthLabel}</label>
+              <div class="ev-input"><input id="ev-width" data-ev-dimension="width" type="number" min="0" step="0.01" value="3.2" inputmode="decimal" /><span class="ev-unit" data-ev-unit-label>m</span></div>
+            </div>
+            <div class="ev-field">
+              <label for="ev-depth">{t.depthLabel}</label>
+              <div class="ev-input"><input id="ev-depth" data-ev-dimension="depth" type="number" min="0" step="0.01" value="0.65" inputmode="decimal" /><span class="ev-unit" data-ev-unit-label>m</span></div>
+            </div>
+          </div>
+        </fieldset>
+
+        <fieldset class="ev-fieldset ev-soil-fieldset">
+          <legend>{t.soilLabel}</legend>
+          <div class="ev-soil-grid">
+            <button type="button" class="ev-soil-button" data-ev-soil="sand"><span class="ev-soil-name">{t.soilSand}</span><span class="ev-soil-band">{t.soilSandBand}</span></button>
+            <button type="button" class="ev-soil-button ev-active" data-ev-soil="topsoil"><span class="ev-soil-name">{t.soilTopsoil}</span><span class="ev-soil-band">{t.soilTopsoilBand}</span></button>
+            <button type="button" class="ev-soil-button" data-ev-soil="clay"><span class="ev-soil-name">{t.soilClay}</span><span class="ev-soil-band">{t.soilClayBand}</span></button>
+            <button type="button" class="ev-soil-button" data-ev-soil="gravel"><span class="ev-soil-name">{t.soilGravel}</span><span class="ev-soil-band">{t.soilGravelBand}</span></button>
+          </div>
+        </fieldset>
+      </section>
+    </div>
+    <div class="ev-notes"><p class="ev-interpretation"><strong>{t.interpretationTitle}</strong> {t.interpretationText}</p><p class="ev-warning">{t.warning}</p></div>
+  </div>
+</div>
+
+<script>
+  import { mountExcavationCalculator } from './controller';
+  import type { ExcavationCalculatorUI } from './ui';
+
+  const root = document.querySelector('[data-ev-root]');
+  const ui = JSON.parse(root?.getAttribute('data-ev-ui') || '{}') as ExcavationCalculatorUI;
+  if (root) mountExcavationCalculator(root, ui);
+</script>

package/src/tool/excavationVolumeCalculator/controller.ts

@@ -0,0 +1,69 @@
+import { calculateExcavation, convertDimension } from './logic';
+import { renderResults } from './dom-views';
+import { readExcavationState, writeExcavationState } from './storage';
+import type { ExcavationCalculatorUI, ExcavationInput, ExcavationUnitSystem, SoilProfile } from './ui';
+
+const initialState: ExcavationInput = { unitSystem: 'metric', length: 4.8, width: 3.2, depth: 0.65, soil: 'topsoil' };
+
+export function mountExcavationCalculator(root: Element, ui: ExcavationCalculatorUI): void {
+  const state = readExcavationState(initialState);
+  setControls(root, state);
+  bindUnitButtons(root, state, ui);
+  bindDimensionInputs(root, state, ui);
+  bindSoilButtons(root, state, ui);
+  render(root, state, ui);
+}
+
+function bindUnitButtons(root: Element, state: ExcavationInput, ui: ExcavationCalculatorUI): void {
+  root.querySelectorAll('[data-ev-unit]').forEach((button) => button.addEventListener('click', () => {
+    const next = (button as HTMLElement).dataset.evUnit as ExcavationUnitSystem;
+    if (next === state.unitSystem) return;
+    ['length', 'width', 'depth'].forEach((key) => {
+      const value = state[key as keyof ExcavationInput] as number;
+      state[key as 'length' | 'width' | 'depth'] = convertDimension(value, state.unitSystem, next);
+    });
+    state.unitSystem = next;
+    setControls(root, state);
+    render(root, state, ui);
+  }));
+}
+
+function bindDimensionInputs(root: Element, state: ExcavationInput, ui: ExcavationCalculatorUI): void {
+  root.querySelectorAll<HTMLInputElement>('[data-ev-dimension]').forEach((input) => input.addEventListener('input', () => {
+    const key = input.dataset.evDimension as 'length' | 'width' | 'depth';
+    state[key] = Number(input.value) || 0;
+    render(root, state, ui);
+  }));
+}
+
+function bindSoilButtons(root: Element, state: ExcavationInput, ui: ExcavationCalculatorUI): void {
+  root.querySelectorAll('[data-ev-soil]').forEach((button) => button.addEventListener('click', () => {
+    state.soil = (button as HTMLElement).dataset.evSoil as SoilProfile;
+    setControls(root, state);
+    render(root, state, ui);
+  }));
+}
+
+
+function setControls(root: Element, state: ExcavationInput): void {
+  root.querySelectorAll('[data-ev-unit]').forEach((button) => button.classList.toggle('ev-active', (button as HTMLElement).dataset.evUnit === state.unitSystem));
+  root.querySelectorAll<HTMLInputElement>('[data-ev-dimension]').forEach((input) => {
+    const key = input.dataset.evDimension as 'length' | 'width' | 'depth';
+    input.value = String(roundInput(state[key]));
+  });
+  root.querySelectorAll('[data-ev-soil]').forEach((button) => button.classList.toggle('ev-active', (button as HTMLElement).dataset.evSoil === state.soil));
+  root.querySelectorAll('[data-ev-unit-label]').forEach((element) => { element.textContent = state.unitSystem === 'metric' ? 'm' : 'ft'; });
+  root.querySelectorAll('[data-ev-volume-unit]').forEach((element) => { element.textContent = state.unitSystem === 'metric' ? 'm³' : 'ft³'; });
+}
+
+function render(root: Element, state: ExcavationInput, ui: ExcavationCalculatorUI): void {
+  const output = calculateExcavation(state);
+  const system = state.unitSystem;
+  renderResults(root, output, state.soil, ui);
+  writeExcavationState(state);
+  root.dataset.evSystem = system;
+}
+
+function roundInput(value: number): number {
+  return Math.round(value * 100) / 100;
+}