@jjlmoya/utils-diy 1.26.0 → 1.28.0

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ExcavationCalculatorUI } from '../ui';
+import { excavationVolumeCalculatorBibliography } from '../bibliography';
+
+const slug = 'calculadora-volume-escavacao-empolamento-solo';
+const title = 'Calculadora de Volume de Escavação e Empolamento do Solo';
+const description = 'Calcule o volume no banco (em estado natural) de uma escavação e estime o volume solto após escavar com uma faixa para areia, terra vegetal, argila e cascalho.';
+
+const faq = [
+  {
+    question: 'Qual é a diferença entre volume no banco (in situ) e volume solto?',
+    answer: 'O volume no banco é o volume do solo em estado natural antes de ser escavado. O volume solto é o espaço estimado que a terra ocupará após a escavação considerando o empolamento.',
+  },
+  {
+    question: 'Como se calcula o volume de uma escavação?',
+    answer: 'Multiplique o comprimento pela largura e pela profundidade. Por exemplo, uma vala de 4m por 3m com 0,5m de profundidade tem um volume no banco de 6 metros cúbicos.',
+  },
+  {
+    question: 'Por que a argila exige uma faixa de empolamento maior?',
+    answer: 'O comportamento da argila varia muito conforme a humidade e a densidade. A calculadora aplica uma faixa mais ampla para refletir essa variação volumétrica.',
+  },
+  {
+    question: 'Esta calculadora substitui um estudo geotécnico?',
+    answer: 'Não. O resultado é uma estimativa para planeamento de transporte e caçambas. Para fundações ou muros de suporte, consulte um engenheiro geotécnico.',
+  },
+];
+
+const howTo = [
+  { name: 'Inserir as dimensões da escavação', text: 'Insira o comprimento, a largura e a profundidade da escavação.' },
+  { name: 'Selecionar o tipo de solo', text: 'Escolha areia, terra vegetal, argila ou cascalho para aplicar a taxa de empolamento correspondente.' },
+  { name: 'Planear a logística de transporte', text: 'Utilize o volume no banco para a escavação e a faixa de volume solto para dimensionar camiões e caçambas.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step, index) => ({ '@type': 'HowToStep', position: index + 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: 'pt',
+};
+
+export const content: ToolLocaleContent<ExcavationCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Perguntas Frequentes',
+  faq,
+  bibliographyTitle: 'Fontes e notas técnicas',
+  bibliography: excavationVolumeCalculatorBibliography,
+  howTo,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Dois volumes para duas necessidades de obra', level: 2 },
+    { type: 'paragraph', html: 'O <strong>volume no banco</strong> (em estado in situ) representa a geometria exata da escavação em solo não alterado: comprimento multiplicado pela largura e pela profundidade. O <strong>volume solto</strong> representa o espaço real que o material escavado ocupará nos camiões, caçambas ou acopios temporários. Manter estes dois valores estritamente separados evita erros no planeamento de transporte e remoção de terras.' },
+    { type: 'title', text: 'Usar a faixa solta para o planeamento de transporte', level: 3 },
+    { type: 'paragraph', html: 'Selecione o perfil do solo mais representativo na calculadora e compare os limites inferior e superior do volume solto com a capacidade útil dos camiões e caçambas disponíveis. A faixa de valores é exibida intencionalmente porque o método de escavação, a humidade e a densidade do terreno alteram significativamente o resultado.' },
+    { type: 'tip', title: 'O fator de empolamento não substitui o ensaio geotécnico', html: 'A humidade, o nível freático e o grau de compactação alteram o empolamento real do solo. Para obras de fundação, muros de suporte e gestão de terras contaminadas exige-se estudo de solos oficial.' },
+    { type: 'title', text: 'Verificar hipóteses antes da contratação', level: 3 },
+    { type: 'paragraph', html: 'Em solos heterogéneos ou incertos, faça a simulação com dois perfis plausíveis e dimensione a logística pelo valor mais conservador até dispor de medições no local.' },
+  ],
+  ui: {
+    unitSystemLabel: 'Sistema de medição',
+    unitMetric: 'Métrico',
+    unitImperial: 'Imperial',
+    onboarding: 'Insira as dimensões da escavação, selecione o solo e use os dois volumes para planear a obra e o transporte.',
+    dimensionLabel: 'Dimensões da escavação',
+    lengthLabel: 'Comprimento',
+    widthLabel: 'Largura',
+    depthLabel: 'Profundidade',
+    soilLabel: 'Perfil do solo',
+    soilSand: 'Areia',
+    soilTopsoil: 'Terra vegetal',
+    soilClay: 'Argila',
+    soilGravel: 'Cascalho / Brita',
+    soilSandBand: 'Empolamento de 10 a 15%',
+    soilTopsoilBand: 'Empolamento de 15 a 25%',
+    soilClayBand: 'Empolamento de 25 a 40%',
+    soilGravelBand: 'Empolamento de 15 a 25%',
+    bankVolumeLabel: 'Volume no banco',
+    bankVolumeHelp: 'Solo in situ em estado natural',
+    looseVolumeLabel: 'Volume solto',
+    looseVolumeHelp: 'Faixa estimada após escavação',
+    expansionLabel: 'Empolamento aplicado',
+    expansionHelp: 'Faixa utilizada para o solo',
+    sceneTitle: 'Da escavação ao bota-fora',
+    sceneBank: 'no banco',
+    sceneLoose: 'material solto',
+    sceneGround: 'cota do terreno',
+    sceneCut: 'vala escavada',
+    interpretationTitle: 'Como interpretar os números.',
+    interpretationText: 'O primeiro valor indica o volume da vala. A faixa solta indica o volume extra que a terra ocupará no transporte.',
+    warning: 'Estimativa para planeamento logístico. Humidade e método de escavação alteram o volume solto real.',
+    unitLengthMetric: 'm',
+    unitLengthImperial: 'ft',
+    unitVolumeMetric: 'm³',
+    unitVolumeImperial: 'ft³',
+    soilStatusLow: 'empolamento baixo',
+    soilStatusMedium: 'empolamento moderado',
+    soilStatusHigh: 'empolamento elevado',
+    soilStatusLabel: 'Faixa de planeamento',
+  },
+};

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ExcavationCalculatorUI } from '../ui';
+import { excavationVolumeCalculatorBibliography } from '../bibliography';
+
+const slug = 'kalkulyator-obema-kotlovana-koeffitsienta-razryhleniya';
+const title = 'Калькулятор Объема Котлована и Коэффициента Разрыхления Грунта';
+const description = 'Рассчитайте объем грунта в плотном теле (в котловане) и оцените объем разрыхленного грунта с учетом коэффициента разрыхления для песка, растительного грунта, глины и гравия.';
+
+const faq = [
+  {
+    question: 'В чем разница между объемом в плотном теле и объемом в разрыхленном состоянии?',
+    answer: 'Объем в плотном теле - это геометрический объем котлована до выемки. Объем в разрыхленном состоянии - это объем, который вынятый грунт займет при транспортировке и складировании с учетом коэффициента разрыхления.',
+  },
+  {
+    question: 'Как рассчитывается объем выемки грунта?',
+    answer: 'Умножьте длину котлована на ширину и глубину. Например, выемка 4 м на 3 м и глубиной 0,5 м дает объем в плотном теле 6 кубических метров.',
+  },
+  {
+    question: 'Почему для глины используется более широкий диапазон разрыхления?',
+    answer: 'Свойства глины сильно зависят от влажности, плотности и состава. Инструмент использует более широкий диапазон, так как разрыхление глины варьируется сильнее.',
+  },
+  {
+    question: 'Может ли этот калькулятор заменить инженерно-геологические изыскания?',
+    answer: 'Нет. Расчет является ориентировочным для планирования вывоза грунта и заказа самосвалов. Для фундаментов требуется геологическое заключение.',
+  },
+];
+
+const howTo = [
+  { name: 'Введите размеры выемки', text: 'Укажите длину, ширину и глубину котлована.' },
+  { name: 'Выберите тип грунта', text: 'Выберите песок, растительный грунт, глину или гравий для применения коэффициента разрыхления.' },
+  { name: 'Спланируйте вывоз грунта', text: 'Используйте объем в плотном теле для выемки, а разрыхленный объем - для расчета самосвалов и контейнеров.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step, index) => ({ '@type': 'HowToStep', position: index + 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: 'ru',
+};
+
+export const content: ToolLocaleContent<ExcavationCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Часто Задаваемые Вопросы',
+  faq,
+  bibliographyTitle: 'Источники и технические примечания',
+  bibliography: excavationVolumeCalculatorBibliography,
+  howTo,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Два объема для решения двух задач на стройплощадке', level: 2 },
+    { type: 'paragraph', html: '<strong>Объем в плотном теле</strong> (также называемый естественным объемом) - это геометрия ненарушенного массива грунта: длина, умноженная на ширину и глубину выемки. <strong>Объем в разрыхленном состоянии</strong> - это объем, который грунт реально займет в кузове самосвала, контейнере или временном отвале после выемки. Четкое разделение этих двух показателей предотвращает ошибки при планировании вывоза грунта и заказе строительной техники.' },
+    { type: 'title', text: 'Использование разрыхленного объема для логистики', level: 3 },
+    { type: 'paragraph', html: 'Выберите наиболее соответствующий тип грунта в калькуляторе и сравните нижнюю и верхнюю границы разрыхленного объема с полезной вместимостью самосвалов, контейнеров и площадью складирования. Диапазон значений отображается преднамеренно, так как влажность, способ выемки и плотность грунта существенно влияют на конечный результат.' },
+    { type: 'tip', title: 'Коэффициент разрыхления не заменяет изыскания', html: 'Влажность грунта, уровень грунтовых вод и степень естественного уплотнения влияют на реальный объем. Для фундаментов, подпорных стен и транспортировки зараженного грунта необходимы официальные инженерно-геологические изыскания.' },
+    { type: 'title', text: 'Проверка до заказа техники', level: 3 },
+    { type: 'paragraph', html: 'При неоднородном или неопределенном грунте выполните расчет для двух возможных типов и ориентируйтесь на больший объем вывоза до получения точных полевых замеров.' },
+  ],
+  ui: {
+    unitSystemLabel: 'Система измерения',
+    unitMetric: 'Метрическая',
+    unitImperial: 'Имперская',
+    onboarding: 'Введите размеры котлована, выберите тип грунта и используйте оба объема для планирования работ и вывоза.',
+    dimensionLabel: 'Размеры котлована',
+    lengthLabel: 'Длина',
+    widthLabel: 'Ширина',
+    depthLabel: 'Глубина',
+    soilLabel: 'Тип грунта',
+    soilSand: 'Песок',
+    soilTopsoil: 'Растительный грунт',
+    soilClay: 'Глина / Суглинок',
+    soilGravel: 'Гравий',
+    soilSandBand: 'Разрыхление от 10 до 15%',
+    soilTopsoilBand: 'Разрыхление от 15 до 25%',
+    soilClayBand: 'Разрыхление от 25 до 40%',
+    soilGravelBand: 'Разрыхление от 15 до 25%',
+    bankVolumeLabel: 'Объем в плотном теле',
+    bankVolumeHelp: 'Ненарушенный грунт в котловане',
+    looseVolumeLabel: 'Объем в разрыхленном состоянии',
+    looseVolumeHelp: 'Оценка объема после выемки',
+    expansionLabel: 'Примененное разрыхление',
+    expansionHelp: 'Диапазон для выбранного грунта',
+    sceneTitle: 'От котлована до отвала',
+    sceneBank: 'в плотном теле',
+    sceneLoose: 'разрыхленный грунт',
+    sceneGround: 'уровень земли',
+    sceneCut: 'вырытый котлован',
+    interpretationTitle: 'Как использовать результаты.',
+    interpretationText: 'Первое число показывает объем котлована. Диапазон показывает объем разрыхленного грунта для вывоза.',
+    warning: 'Ориентировочный расчет для логистики. Влажность и метод выемки меняют реальный разрыхленный объем.',
+    unitLengthMetric: 'м',
+    unitLengthImperial: 'фут',
+    unitVolumeMetric: 'м³',
+    unitVolumeImperial: 'фут³',
+    soilStatusLow: 'низкое разрыхление',
+    soilStatusMedium: 'умеренное разрыхление',
+    soilStatusHigh: 'высокое разрыхление',
+    soilStatusLabel: 'Диапазон расчета',
+  },
+};

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ExcavationCalculatorUI } from '../ui';
+import { excavationVolumeCalculatorBibliography } from '../bibliography';
+
+const slug = 'schaktvolymberaknare-volymokning-jord';
+const title = 'Schaktvolymberäknare och Volymökning Jord';
+const description = 'Beräkna schaktvolym i fast mått (i marken) och uppskatta lösvolym efter grävning med svällningsintervall för sand, matjord, lera och grus.';
+
+const faq = [
+  {
+    question: 'Vad är skillnaden mellan fast mått (fast volym) och lösvolym?',
+    answer: 'Fast mått är jordens volym i opåverkat tillstånd i marken. Lösvolym är den volym jorden intar efter grävning då den sväller och blir luftig.',
+  },
+  {
+    question: 'Hur beräknas schaktvolymen?',
+    answer: 'Multiplicera längd, bredd och djup. En schakt som är 4 meter lång, 3 meter bred och 0,5 meter djup har en fast volym på 6 kubikmeter.',
+  },
+  {
+    question: 'Varför har lera ett bredare svällningsintervall?',
+    answer: 'Lerans egenskaper beror starkt på fukthalt och densitet. Verktyget använder ett bredare intervall eftersom lerans volymökning varierar mer.',
+  },
+  {
+    question: 'Ersätter denna beräknare en geoteknisk undersökning?',
+    answer: 'Nej. Resultatet är en uppskattning för transport och containerplanering. Anlita en geotekniker vid grundläggning eller schaktning nära byggnader.',
+  },
+];
+
+const howTo = [
+  { name: 'Ange schaktmått', text: 'Fyll i längd, bredd och djup för schaktningen.' },
+  { name: 'Välj jordart', text: 'Välj sand, matjord, lera eller grus för att applicera svällningsfaktorn.' },
+  { name: 'Planera borttransport', text: 'Använd fast mått för grävningen och lösvolym för att beräkna antal containers eller lastbilar.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step, index) => ({ '@type': 'HowToStep', position: index + 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: 'sv',
+};
+
+export const content: ToolLocaleContent<ExcavationCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Vanliga Frågor',
+  faq,
+  bibliographyTitle: 'Källor och tekniska anteckningar',
+  bibliography: excavationVolumeCalculatorBibliography,
+  howTo,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Två volymer för två behov på byggarbetsplatsen', level: 2 },
+    { type: 'paragraph', html: '<strong>Fast mått</strong> (även kallat bank volume) beskriver gropens exakta geometriska volym i orörd mark: längd gånger bredd gånger djup. <strong>Lösvolym</strong> beskriver den verkliga volym som den uppgrävda jorden tar upp på lastbilsflaket, i avfallscontainern eller på det tillfälliga upplaget efter svällning. Att hålla dessa två volymmått strikt åtskilda förhindrar felaktiga transport- och logistikberäkningar.' },
+    { type: 'title', text: 'Använd lösvolymsintervallet för logistikplanering', level: 3 },
+    { type: 'paragraph', html: 'Välj den jordart som bäst motsvarar markförhållandena i beräknaren och jämför det nedre och övre lösvolymsvärdet med flakkapacitet, containerstorlek och tillgänglig upplagsyta. Intervallet visas avsiktligt eftersom grävmetod, fukthalt och markens packningsgrad påverkar det slutliga resultatet avsevärt.' },
+    { type: 'tip', title: 'Schaktsvallning ersätter inte markundersökning', html: 'Fukthalt, grundvattennivå och packningsgrad påverkar den faktiska volymökningen. Vid grundläggning, stödmurar och hantering av förorenade massor krävs alltid en formell geoteknisk markundersökning.' },
+    { type: 'title', text: 'Kontrollera antaganden före beställning', level: 3 },
+    { type: 'paragraph', html: 'Vid osäkerhet om den exakta jordarten på platsen är det säkrast att göra en provberäkning med två sannolika profiler och planera för den högre transportvolymen tills exakta mätningar har utförts.' },
+  ],
+  ui: {
+    unitSystemLabel: 'Måttsystem',
+    unitMetric: 'Metrisk',
+    unitImperial: 'Imperial',
+    onboarding: 'Fyll i schaktens mått, välj jordart och använd båda volymvärdena för planering och borttransport.',
+    dimensionLabel: 'Schaktens mått',
+    lengthLabel: 'Längd',
+    widthLabel: 'Bredd',
+    depthLabel: 'Djup',
+    soilLabel: 'Jordart',
+    soilSand: 'Sand',
+    soilTopsoil: 'Matjord',
+    soilClay: 'Lera',
+    soilGravel: 'Grus',
+    soilSandBand: '10 till 15% svällning',
+    soilTopsoilBand: '15 till 25% svällning',
+    soilClayBand: '25 till 40% svällning',
+    soilGravelBand: '15 till 25% svällning',
+    bankVolumeLabel: 'Fast mått',
+    bankVolumeHelp: 'Orörd jord i marken',
+    looseVolumeLabel: 'Lösvolym',
+    looseVolumeHelp: 'Uppskattat intervall efter grävning',
+    expansionLabel: 'Tillämpad svällning',
+    expansionHelp: 'Intervall för vald jordart',
+    sceneTitle: 'Från schakt till upplag',
+    sceneBank: 'i marken',
+    sceneLoose: 'lösa massor',
+    sceneGround: 'marknivå',
+    sceneCut: 'utgrävd schakt',
+    interpretationTitle: 'Hur du använder resultaten.',
+    interpretationText: 'Det första talet visar gropens volym. Intervallet visar den extra volym som massorna tar upp vid borttransport.',
+    warning: 'Endast för logistikplanering. Fukt och grävmetod påverkar den faktiska lösvolymen.',
+    unitLengthMetric: 'm',
+    unitLengthImperial: 'ft',
+    unitVolumeMetric: 'm³',
+    unitVolumeImperial: 'ft³',
+    soilStatusLow: 'låg svällning',
+    soilStatusMedium: 'måttlig svällning',
+    soilStatusHigh: 'hög svällning',
+    soilStatusLabel: 'Planeringsintervall',
+  },
+};

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ExcavationCalculatorUI } from '../ui';
+import { excavationVolumeCalculatorBibliography } from '../bibliography';
+
+const slug = 'kazi-hacmi-toprak-kabarma-hesaplama';
+const title = 'Kazı Hacmi Hesaplama ve Toprak Kabarma Miktarı';
+const description = 'Kazı öncesi doğal zemin hacmini hesaplayın ve kum, bahçe toprağı, kil ve çakıl için kabarma oranı ile gevşek toprak hacmini tahmin edin.';
+
+const faq = [
+  {
+    question: 'Doğal zemin hacmi (sıkışık hacim) ile gevşek hacim arasındaki fark nedir?',
+    answer: 'Doğal zemin hacmi, kazı yapılmadan önce toprağın yerindeki hacmidir. Gevşek hacim ise kazı sonrasında toprağın kabarmasıyla kaplayacağı tahmini hacimdir.',
+  },
+  {
+    question: 'Kazı hacmi nasıl hesaplanır?',
+    answer: 'Uzunluk, genişlik ve derinlik değerlerini birbiriyle çarpın. Örneğin 4 m uzunluğunda, 3 m genişliğinde ve 0.5 m derinliğinde bir kazının kabarma öncesi doğal hacmi 6 metreküptür.',
+  },
+  {
+    question: 'Kil neden daha geniş bir kabarma oranına sahiptir?',
+    answer: 'Kilin yapısı nem oranına ve yoğunluğa oldukça duyarlıdır. Bu nedenle hesaplayıcı killi topraklar için daha geniş bir tahmin aralığı sunar.',
+  },
+  {
+    question: 'Bu hesaplayıcı jeoteknik zemin etüdünün yerine geçer mi?',
+    answer: 'Hayır. Bu araç hafriyat nakliyesi ve konteyner planlaması için ön tahminde bulunur. Temel ve istinat duvarı projelerinde jeoteknik rapor zorunludur.',
+  },
+];
+
+const howTo = [
+  { name: 'Kazı ölçülerini girin', text: 'Kazılacak alanın uzunluk, genişlik ve derinliğini girin.' },
+  { name: 'Toprak tipini seçin', text: 'Kum, bahçe toprağı, kil veya çakıl seçeneklerinden uygun olanı belirleyin.' },
+  { name: 'Nakliye planlamasını yapın', text: 'Zemin hacmini kazı alanı için, gevşek hacmi ise hafriyat kamyonu sayısını belirlemek için kullanın.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step, index) => ({ '@type': 'HowToStep', position: index + 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: 'tr',
+};
+
+export const content: ToolLocaleContent<ExcavationCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Sıkça Sorulan Sorular',
+  faq,
+  bibliographyTitle: 'Kaynaklar ve teknik notlar',
+  bibliography: excavationVolumeCalculatorBibliography,
+  howTo,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'Şantiyedeki İki Farklı Hacim İhtiyacı', level: 2 },
+    { type: 'paragraph', html: '<strong>Doğal zemin hacmi</strong> (sıkışık zemin hacmi olarak da bilinir), kazılacak çukurun bozulmamış haldeki geometrik ölçüsüdür: uzunluk × genişlik × derinlik. <strong>Gevşek hacim</strong> ise kazılan toprağın kabarması sonucu hafriyat kamyonlarında, konteynerlerde veya geçici döküm sahalarında kaplayacağı gerçek hacimdir. Bu iki farklı hacim değerini ayrı tutmak, lojistik ve nakliye hesaplamalarının yanlış zemin durumuna göre yapılmasını engeller.' },
+    { type: 'title', text: 'Nakliye ve Hafriyat Planlamasında Kullanım', level: 3 },
+    { type: 'paragraph', html: 'Hesaplayıcıda şantiyenize en uygun toprak türünü seçin ve tahmin edilen gevşek hacim alt ve üst sınırlarını mevcut hafriyat kamyonu kasası kapasiteleri, konteyner boyutları ve geçici depolama alanı ile karşılaştırın. Aralık şeklinde gösterilmesinin sebebi, kazı yöntemi, toprağın nem oranı ve sıkışma derecesinin sonucu önemli ölçüde değiştirmesidir.' },
+    { type: 'tip', title: 'Kabarma oranı zemin etüdü yerine geçmez', html: 'Nem oranı, yeraltı su seviyesi ve doğal sıkışma miktarı gerçek kabarmayı değiştirir. Yapı temelleri, istinat duvarları ve kontamine toprak nakliyesi projelerinde resmi jeoteknik zemin etüt raporu alınması zorunludur.' },
+    { type: 'title', text: 'Kamyon Siparişinden Önce Değerlendirin', level: 3 },
+    { type: 'paragraph', html: 'Zemin türünden emin değilseniz daha yüksek kabarma oranına sahip iki olası zemin profili ile deneme hesabı yapın ve saha içi kesin ölçümler yapılana kadar en yüksek nakliye ihtiyacını esas alarak planlama yapın.' },
+  ],
+  ui: {
+    unitSystemLabel: 'Ölçü sistemi',
+    unitMetric: 'Metrik',
+    unitImperial: 'İngiliz (Imperial)',
+    onboarding: 'Kazı ölçülerini girin, toprak türünü seçin ve hafriyat ile nakliye planlaması için iki hacim değerini kullanın.',
+    dimensionLabel: 'Kazı ölçüleri',
+    lengthLabel: 'Uzunluk',
+    widthLabel: 'Genişlik',
+    depthLabel: 'Derinlik',
+    soilLabel: 'Toprak türü',
+    soilSand: 'Kum',
+    soilTopsoil: 'Bahçe toprağı / Bitkisel toprak',
+    soilClay: 'Kil / Kil karışımı',
+    soilGravel: 'Çakıl',
+    soilSandBand: '%10 - %15 kabarma',
+    soilTopsoilBand: '%15 - %25 kabarma',
+    soilClayBand: '%25 - %40 kabarma',
+    soilGravelBand: '%15 - %25 kabarma',
+    bankVolumeLabel: 'Doğal zemin hacmi',
+    bankVolumeHelp: 'Kazı öncesi yerindeki toprak',
+    looseVolumeLabel: 'Gevşek toprak hacmi',
+    looseVolumeHelp: 'Kazı sonrası tahmini hacim aralığı',
+    expansionLabel: 'Uygulanan kabarma oranı',
+    expansionHelp: 'Seçilen toprak için kullanılan aralık',
+    sceneTitle: 'Kazı alanından döküm sahasına',
+    sceneBank: 'doğal zeminde',
+    sceneLoose: 'gevşek toprak',
+    sceneGround: 'zemin seviyesi',
+    sceneCut: 'açılan kazı çukuru',
+    interpretationTitle: 'Sonuçlar nasıl kullanılır?',
+    interpretationText: 'İlk sayı açılacak çukurun hacmidir. Aralıklı sayı ise kazılan toprağın nakliyede kaplayacağı hacimdir.',
+    warning: 'Nakliye planlaması için tahmini değerdir. Nem ve kazı yöntemi gerçek hacmi etkileyebilir.',
+    unitLengthMetric: 'm',
+    unitLengthImperial: 'ft',
+    unitVolumeMetric: 'm³',
+    unitVolumeImperial: 'ft³',
+    soilStatusLow: 'düşük kabarma',
+    soilStatusMedium: 'orta kabarma',
+    soilStatusHigh: 'yüksek kabarma',
+    soilStatusLabel: 'Planlama aralığı',
+  },
+};

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

@@ -0,0 +1,120 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { ExcavationCalculatorUI } from '../ui';
+import { excavationVolumeCalculatorBibliography } from '../bibliography';
+
+const slug = 'excavation-volume-soil-swell-calculator';
+const title = '土方开挖量计算器与土方松散膨胀率估算';
+const description = '计算开挖前的天然密实土方量（天然体方），并根据砂土、表土、粘土和碎石的松散膨胀系数，估算开挖后的松方体积范围。';
+
+const faq = [
+  {
+    question: '天然体方（Bank Volume）与松方（Loose Volume）有什么区别？',
+    answer: '天然体方是指开挖前未受扰动状态下的土壤体积，由开挖长度、宽度和深度直接相乘计算。松方是指开挖后土壤受到扰动、孔隙率增加后的预计堆积体积。',
+  },
+  {
+    question: '如何计算土方开挖量？',
+    answer: '将开挖长度乘以宽度和深度。例如，长4米、宽3米、深0.5米的基坑开挖，在未考虑土壤松散膨胀时的天然体方为6立方米。',
+  },
+  {
+    question: '为什么粘土需要设置更宽的松散膨胀率范围？',
+    answer: '粘土的物理特性受含水量、密实度和矿物成分影响极大。因此本工具为粘土设置了更宽的规划区间，以适应其多变的体积膨胀响应。',
+  },
+  {
+    question: '本计算器可以替代岩土工程勘察报告吗？',
+    answer: '不能。本计算器结果仅作为土方运输、渣土车安排和临时堆场规划的参考估算。涉及到建筑物基础、挡土墙或污染土方处置时，必须进行专业的岩土工程勘察。',
+  },
+];
+
+const howTo = [
+  { name: '输入开挖尺寸', text: '输入基坑或沟槽的长度、宽度和深度。可根据需要切换公制或英制单位。' },
+  { name: '选择最接近的土壤类型', text: '选择砂土、表土、粘土或碎石，以应用对应的松散膨胀系数区间。' },
+  { name: '规划土方运输与堆放', text: '使用天然体方评估开挖工作量，使用松方体积区间安排渣土车车次、清运容器或临时堆场面积。' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: howTo.map((step, index) => ({ '@type': 'HowToStep', position: index + 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: 'zh',
+};
+
+export const content: ToolLocaleContent<ExcavationCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: '常见问题解答',
+  faq,
+  bibliographyTitle: '参考来源与技术说明',
+  bibliography: excavationVolumeCalculatorBibliography,
+  howTo,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: '两个体积指标解决施工现场的两大核心问题', level: 2 },
+    { type: 'paragraph', html: '<strong>天然体方</strong>代表未扰动地基的开挖几何体积：长度乘以宽度再乘以深度。<strong>松方体积</strong>则代表挖掘出来的土方在装车或堆放时所占据的空间。区分这两个概念可以防止按错误状态估算渣土车车次或堆场面积。' },
+    { type: 'title', text: '利用松方区间合理规划物流与运输', level: 3 },
+    { type: 'paragraph', html: '选择最符合现场的土壤类型，并将估算的松方区间上下限与渣土车载重、容器容量及临时堆场面积进行对比。显示区间范围是因为开挖方式和土壤含水量都会改变实际松散率。' },
+    { type: 'tip', title: '经验膨胀系数不能替代土工试验', html: '粘土矿物、地下水和含水量可能会导致实际膨胀率超出经验范围。基础工程、挡土结构和受污染土方必须经过正式的岩土工程检测。' },
+    { type: 'title', text: '在安排运力前核对估算假设', level: 3 },
+    { type: 'paragraph', html: '如果土质不够明确，建议使用两种可能的土壤类型分别计算，并在现场实测前按较大估算值准备运输能力，以确保施工安全。' },
+  ],
+  ui: {
+    unitSystemLabel: '计量单位体系',
+    unitMetric: '公制',
+    unitImperial: '英制',
+    onboarding: '请输入开挖尺寸并选择土壤类型，利用天然体方和松方体积结果规划施工与清运。',
+    dimensionLabel: '开挖几何尺寸',
+    lengthLabel: '长度',
+    widthLabel: '宽度',
+    depthLabel: '深度',
+    soilLabel: '土壤类型',
+    soilSand: '砂土',
+    soilTopsoil: '表土 / 耕作土',
+    soilClay: '粘土 / 粘性土',
+    soilGravel: '碎石 / 砾石',
+    soilSandBand: '膨胀率 10% 至 15%',
+    soilTopsoilBand: '膨胀率 15% 至 25%',
+    soilClayBand: '膨胀率 25% 至 40%',
+    soilGravelBand: '膨胀率 15% 至 25%',
+    bankVolumeLabel: '天然体方 (天然密实)',
+    bankVolumeHelp: '开挖前地基未扰动土方量',
+    looseVolumeLabel: '松方体积 (开挖后)',
+    looseVolumeHelp: '开挖后堆积或运输预计体积',
+    expansionLabel: '应用土壤膨胀率',
+    expansionHelp: '针对所选土壤类型的系数范围',
+    sceneTitle: '从地基开挖到堆场运输',
+    sceneBank: '天然地基',
+    sceneLoose: '松散土方',
+    sceneGround: '地面标高',
+    sceneCut: '开挖基坑断面',
+    interpretationTitle: '如何解读计算结果',
+    interpretationText: '第一个数值代表挖出基坑的尺寸。范围数值代表挖出的松散土方所占用的空间。',
+    warning: '本结果仅用于施工物流规划估算。含水量、密实度和挖掘方式均会改变实际松散体积，不能替代岩土工程勘察报告。',
+    unitLengthMetric: 'm',
+    unitLengthImperial: 'ft',
+    unitVolumeMetric: 'm³',
+    unitVolumeImperial: 'ft³',
+    soilStatusLow: '低膨胀率区间',
+    soilStatusMedium: '中度膨胀率区间',
+    soilStatusHigh: '高膨胀率区间',
+    soilStatusLabel: '规划参考区间',
+  },
+};

package/src/tool/excavationVolumeCalculator/index.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../../types';
+import { excavationVolumeCalculator } from './entry';
+
+export * from './entry';
+
+export const EXCAVATION_VOLUME_CALCULATOR_TOOL: ToolDefinition = {
+  entry: excavationVolumeCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/excavationVolumeCalculator/logic.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { calculateExcavation, convertDimension, convertVolume, getSoilBand } from './logic';
+
+describe('calculateExcavation', () => {
+  it('calculates bank and loose volume for a sand excavation', () => {
+    const result = calculateExcavation({ unitSystem: 'metric', length: 4, width: 3, depth: 0.5, soil: 'sand' });
+    expect(result.bankVolume).toBe(6);
+    expect(result.looseLow).toBeCloseTo(6.6);
+    expect(result.looseHigh).toBeCloseTo(6.9);
+  });
+
+  it('clamps negative dimensions and returns the clay band', () => {
+    const result = calculateExcavation({ unitSystem: 'metric', length: -2, width: 3, depth: 1, soil: 'clay' });
+    expect(result.bankVolume).toBe(0);
+    expect(result.soilBand).toEqual({ low: 0.25, high: 0.4 });
+  });
+
+  it('exposes the documented band for each soil profile', () => {
+    expect(getSoilBand('topsoil')).toEqual({ low: 0.15, high: 0.25 });
+    expect(getSoilBand('gravel')).toEqual({ low: 0.15, high: 0.25 });
+  });
+});
+
+describe('unit conversion', () => {
+  it('round-trips dimensions and converts cubic metres to cubic feet', () => {
+    expect(convertDimension(convertDimension(2, 'metric', 'imperial'), 'imperial', 'metric')).toBeCloseTo(2);
+    expect(convertVolume(1, 'imperial')).toBeCloseTo(35.3147, 3);
+  });
+});