@jjlmoya/utils-home 1.25.0 → 1.26.0

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

@@ -0,0 +1,226 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WallPaintingCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'duvar-boya-hesaplayici';
+const title = 'Duvar Boyası ve Seyreltme Hesaplayıcısı';
+const description =
+  'Duvarlarınız için tam olarak kaç litre veya galon boyaya ihtiyacınız olduğunu hesaplayın. Katlar, yüzey türü, seyreltme için ayar yapın ve satın almadan önce gerçek maliyeti öğrenin.';
+
+const faqData = [
+  {
+    question: 'Tam boya miktarını nasıl hesaplarım?',
+    answer:
+      'Duvar yüzey alanını kat sayısı ile çarpın ve ardından litreye veya galona göre metrekare veya feetkare başına boya verimine bölün. Önce kapı ve pencereleri toplam alandan çıkarın.',
+  },
+  {
+    question: 'Standart bir oda ne kadar boya ister?',
+    answer:
+      'Tavan yüksekliği 2,5 metre olan 12 metrekarelik bir odanın duvar yüzeyi yaklaşık 30 metrekaredir. İki kat ve litreye başına 12 metrekare verim ile yaklaşık 5 litre boyaya ihtiyacınız olur.',
+  },
+  {
+    question: 'Boyayı uygulamadan önce seyreltmeli miyim?',
+    answer:
+      'Su bazlı plastik boyalar genellikle kullanıma hazırdır veya ilk kat için yüzde 5 ila 10 su gerektirir. Emaye veya yağlı boyalar genellikle kutuda belirtilen özel bir çözücü gerektirir.',
+  },
+  {
+    question: 'Gerçekten kaç kat gerekli?',
+    answer:
+      'Yeni veya yüksek derecede emici yüzeyler astar artı iki son kat boya ister. Benzer renkte zaten boyalı bir duvarı boyamak genellikle sadece bir veya iki kat ister.',
+  },
+  {
+    question: 'Kapı ve pencere alanını çıkarıyor muyum?',
+    answer:
+      'Evet. Her açıklığı ölçün ve duvar toplam alanından çıkarın. Hızlı bir kural olarak kapılar yaklaşık 2 metrekare ve pencereler yaklaşık 1,5 metrekaredir.',
+  },
+  {
+    question: 'Yüzey türü verimi değiştirir mi?',
+    answer:
+      'Evet. Pürüzsüz hazırlanmış duvarlar litreye başına 14 metrekareye kadar verim sağlayabilir. Pürüzlü beton, dokulu sıva veya emici tuğla verimi litreye başına 6 veya 8 metrekareye düşürebilir.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Duvarlarınızı ölçün',
+    text: 'Her duvarın genişliğini ve yüksekliğini ölçün. Her duvarın alanını bulmak için çarpın ve ardından tüm duvarları toplayın.',
+  },
+  {
+    name: 'Açıklıkları çıkarın',
+    text: 'Kapı ve pencereleri ölçün ve toplamdan alanlarını çıkararak boyanacak gerçek yüzeyi bulun.',
+  },
+  {
+    name: 'Boya türünüzü seçin',
+    text: 'Hesaplayıcıda boya türünü seçin. Plastik mat, plastik saten ve emaye farklı verimlere ve seyrelme önerilerine sahiptir.',
+  },
+  {
+    name: 'Katları ve fiyatı ayarlayın',
+    text: 'Uygulamayı planladığınız kat sayısını ve litre veya galon başına fiyatı belirtin. Hesaplayıcı tam miktarı ve toplam maliyeti döndürecektir.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'tr',
+};
+
+export const content: ToolLocaleContent<WallPaintingCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Boya Hesaplayıcı: Tam Olarak İhtiyacınız Olan Kadar Satın Alın',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Önceden hesaplamadan bir odayı boyamak genellikle <strong>yarım dolu tenekelerle</strong> veya acil mağaza ziyaretleriyle sonuçlanır. Neden basit: boya verimi yüzey gözenekliliği, renk değişimi ve kat sayısı ile değişir. Pürüzsüz, önceden boyalı bir duvar litreye başına 14 metrekareye kadar verim sağlayabilir, ancak dokulu sıva duvarı aynı miktarı emebilir ve sadece 6 metrekare kaplayabilir.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: 'Yüksek', label: 'Standart Kaplama', icon: 'mdi:format-paint' },
+        { value: '2 kat', label: 'Önerilen', icon: 'mdi:layers' },
+        { value: '5-10%', label: 'Tipik Seyreltme', icon: 'mdi:cup-water' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'title',
+      text: 'Boya Verimi Nasıl Gerçekten Çalışır',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Üreticiler kutuda teorik verim belirtir. Bu sayı, ideal koşullarda profesyonel bir rulo ile uygulanan mükemmel düz, emici olmayan, beyaz bir yüzeyi varsayar. Gerçek dünyada <strong>gözenekli duvarlar, koyu renkler ve kendi kendine uygulama</strong> bu verimi yüzde 20 ila 40 azaltır. Hesaplayıcımız eksik kalmamanız için gerçekçi profiller seçmenize olanak tanır.',
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Plastik Mat Boya',
+          description: 'İç mekanlar için en yaygın seçim. Yüksek kapatıcılık, kolay rötuşlanabilir ve çoğu kalitede yıkanabilir.',
+          icon: 'mdi:palette',
+          points: ['Standart iç mekan kapatıcılığı', 'Seyreltme: yüzde 5 ila 10 su', 'En iyi: salonlar ve yatak odaları için'],
+        },
+        {
+          title: 'Plastik Saten Boya',
+          description: 'Hafif parlak bitiş ile nem ve lekelere karşı daha büyük direnç. Dikişsiz rötuşlanması daha zor.',
+          icon: 'mdi:brightness-6',
+          points: ['Biraz daha yüksek kapatıcılık', 'Seyreltme: yüzde 5 su', 'En iyi: mutfaklar ve banyolar için'],
+        },
+        {
+          title: 'Emaye Boya',
+          description: 'Marangozluk, radyatörler ve yoğun trafikli alanlar için sert ve dayanıklı bitiş. Çözücü veya özel inceltici gerektirir.',
+          icon: 'mdi:spray',
+          points: ['Sert ve dayanıklı bitiş', 'Seyreltme: yüzde 10 ila 15 çözücü', 'En iyi: kapılar, çerçeveler ve mobilya için'],
+        },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Pratik Yüzey Ölçümü',
+      icon: 'mdi:ruler-square',
+      badge: 'İpucu',
+      html: '<p style="margin:0">Her duvarın genişliğini yüksekliğiyle çarpın. Hızlı bir toplam için tüm genişlikleri ekleyin ve oda yüksekliğiyle çarpın. Ardından her standart kapı için yaklaşık 2 metrekare ve her pencere için 1,5 metrekare çıkarın.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Seyreltme ve Uygulama Kuralları',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Yeni veya onarılmış yüzeylerde ilk katlar boyanın nüfuz etmesi ve yapışması için her zaman hafif seyreltme gerektirir. Son katlar seyreltilmemiş veya üreticinin belirttiği minimum miktarda uygulanmalıdır. <strong>Aşırı seyreltme pigmenti kırar</strong> ve ekstra kat gerektiren saydam lekeler bırakır.',
+    },
+    {
+      type: 'summary',
+      title: 'Neden Satın Almadan Önce Hesaplamalısınız',
+      items: [
+        'Tenede kuruyan ve atık haline gelen fazla boyadan kaçının.',
+        'Farklı zamanlarda satın alınan partiler arasında renk uyuşmazlığını önleyin.',
+        'Doğru bütçeleme: astar ve araçlar dahil gerçek maliyeti bilin.',
+        'Ek malzeme için kesintiye uğratmadan işi tek seferde planlayın.',
+      ],
+    },
+  ],
+  ui: {
+    sectionTitle: 'Yüzey ve Boya',
+    labelMetric: 'Metrik',
+    labelImperial: 'İmparatorluk',
+    labelArea: 'Boyanacak toplam alan',
+    labelAreaFt: 'Boyanacak toplam alan',
+    unitArea: 'm2',
+    unitAreaFt: 'ft2',
+    labelYield: 'Boya verimi',
+    labelYieldFt: 'Boya verimi',
+    unitYield: 'm2/L',
+    unitYieldFt: 'ft2/gal',
+    labelType: 'Boya türü seçin',
+    btnPlasticMatTitle: 'Plastik Mat',
+    btnPlasticMatSub: 'Mat · Su yüzde 5',
+    btnPlasticSatinTitle: 'Plastik Saten',
+    btnPlasticSatinSub: 'Saten · Su yüzde 5',
+    btnEnamelTitle: 'Emaye',
+    btnEnamelSub: 'Emaye · Çözücü yüzde 10',
+    labelCoats: 'Kat sayısı',
+    unitCoats: 'kat',
+    labelPrice: 'Litre başına fiyat',
+    labelPriceFt: 'Galon başına fiyat',
+    unitPrice: '/L',
+    unitPriceGal: '/gal',
+    labelDilution: 'Seyreltme yüzdesi',
+    unitDilution: '%',
+    resultBadge: 'Boya hesaplaması',
+    labelPaint: 'Boya litresi',
+    labelPaintGal: 'Boya galonu',
+    labelCost: 'Toplam maliyet',
+    labelWater: 'Seyreltme sıvısı',
+    labelWaterGal: 'Seyreltme sıvısı',
+    labelTotalVolume: 'Toplam karışım',
+    labelTotalVolumeGal: 'Toplam karışım',
+    labelCurrency: 'Para Birimi',
+    btnCurrUSD: '$',
+    btnCurrEUR: '€',
+    btnCurrGBP: '£',
+    btnCurrJPY: '¥',
+    currencySign: '₺',
+  },
+};

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

@@ -0,0 +1,226 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WallPaintingCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'wall-painting-calculator';
+const title = '墙面油漆与稀释优化计算器';
+const description =
+  '精确计算墙面所需的升数或加仑数油漆。根据涂层、表面类型和稀释率进行调整，在购买前获取真实成本。';
+
+const faqData = [
+  {
+    question: '如何计算所需油漆的精确用量？',
+    answer:
+      '将墙面面积乘以涂层数，然后除以油漆的覆盖率（每升或每加仑的平方米或平方英尺）。请先从总面积中减去门窗面积。',
+  },
+  {
+    question: '标准房间需要多少油漆？',
+    answer:
+      '一个12平方米、天花板高2.5米的房间，墙面面积约为30平方米。两遍涂刷，每升覆盖12平方米，大约需要5升油漆。',
+  },
+  {
+    question: '涂刷前需要稀释油漆吗？',
+    answer:
+      '水性乳胶漆通常可以直接使用，或者第一遍需要加5%到10%的水。搪瓷漆或油性漆通常需要罐上标注的特定溶剂。',
+  },
+  {
+    question: '到底需要刷几遍？',
+    answer:
+      '新的或吸水性强的表面需要底漆加两遍面漆。在已涂漆的墙面上刷相近颜色，通常只需要一到两遍。',
+  },
+  {
+    question: '需要扣除门窗面积吗？',
+    answer:
+      '是的。测量每个开口并从墙面总面积中扣除。快速估算规则：每扇门约2平方米，每扇窗约1.5平方米。',
+  },
+  {
+    question: '表面类型会影响覆盖率吗？',
+    answer:
+      '是的。光滑处理过的墙面每升可覆盖高达14平方米。粗糙的混凝土、纹理灰泥或吸水性砖块可能将覆盖率降低到每升6到8平方米。',
+  },
+];
+
+const howToData = [
+  {
+    name: '测量墙面',
+    text: '测量每面墙的宽度和高度。相乘得到每面墙的面积，然后全部相加。',
+  },
+  {
+    name: '扣除开口',
+    text: '测量门窗并从总面积中扣除它们的面积，得到实际需要涂刷的表面积。',
+  },
+  {
+    name: '选择油漆类型',
+    text: '在计算器中选择油漆类型。哑光乳胶漆、半光乳胶漆和搪瓷漆具有不同的覆盖率和稀释建议。',
+  },
+  {
+    name: '设定遍数和价格',
+    text: '输入计划涂刷的遍数和每升或每加仑的价格。计算器将返回精确的用量和总成本。',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'zh',
+};
+
+export const content: ToolLocaleContent<WallPaintingCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '油漆计算器：只买你需要的量',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '不计算就刷漆通常会导致<strong>半罐剩余的油漆</strong>或紧急去商店补货。原因很简单：油漆的覆盖率随表面孔隙率、颜色变化和涂刷遍数而变化。光滑且已涂过漆的墙面每升可覆盖高达14平方米，而粗糙的纹理墙可能会吸收同样多的油漆却只覆盖6平方米。',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '高', label: '标准覆盖率', icon: 'mdi:format-paint' },
+        { value: '2遍', label: '推荐', icon: 'mdi:layers' },
+        { value: '5-10%', label: '典型稀释率', icon: 'mdi:cup-water' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'title',
+      text: '油漆覆盖率的真实工作原理',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '制造商在罐上标注的是理论覆盖率。这个数字假设在理想条件下，由专业人士使用滚筒在完全光滑、不吸水、白色的表面上施工。在现实世界中，<strong>多孔墙面、深色和DIY施工</strong>会将这个覆盖率降低20%到40%。我们的计算器让你选择符合实际的参数，避免用料不足。',
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: '哑光乳胶漆',
+          description: '最常见的室内选择。遮盖力高，容易修补，大多数品质可擦洗。',
+          icon: 'mdi:palette',
+          points: ['标准室内覆盖率', '稀释：加5%到10%的水', '最适合：客厅和卧室'],
+        },
+        {
+          title: '半光乳胶漆',
+          description: '轻微光泽的饰面，对湿气和污渍的抵抗力更强。无痕修补相对困难。',
+          icon: 'mdi:brightness-6',
+          points: ['略高的覆盖率', '稀释：加5%的水', '最适合：厨房和浴室'],
+        },
+        {
+          title: '搪瓷漆',
+          description: '坚硬耐用的饰面，适用于木制品、暖气片和高流量区域。需要溶剂或专用稀释剂。',
+          icon: 'mdi:spray',
+          points: ['坚硬耐用的饰面', '稀释：加10%到15%的溶剂', '最适合：门、窗框和家具'],
+        },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: '实用的表面积测量',
+      icon: 'mdi:ruler-square',
+      badge: '提示',
+      html: '<p style="margin:0">将每面墙的宽度乘以高度。快速估算时，将所有宽度相加再乘以房间高度。然后每扇标准门扣除约2平方米，每扇窗扣除约1.5平方米。</p>',
+    },
+    {
+      type: 'title',
+      text: '稀释和施工规则',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '新表面或修补过的表面第一遍漆总是需要轻微稀释，以便油漆渗透和附着。面漆应不稀释或使用制造商指示的最低稀释量施工。<strong>过度稀释会破坏颜料</strong>，留下需要额外一遍的透明斑块。',
+    },
+    {
+      type: 'summary',
+      title: '为什么购买前要计算',
+      items: [
+        '避免油漆在罐中干涸变成废弃物。',
+        '防止不同时期购买的批次之间出现色差。',
+        '精确预算：了解包含底漆和工具的实际成本。',
+        '一次性规划好工作，不因补充材料而中断。',
+      ],
+    },
+  ],
+  ui: {
+    sectionTitle: '表面与油漆',
+    labelMetric: '公制',
+    labelImperial: '英制',
+    labelArea: '待涂刷总面积',
+    labelAreaFt: '待涂刷总面积',
+    unitArea: 'm2',
+    unitAreaFt: 'ft2',
+    labelYield: '油漆覆盖率',
+    labelYieldFt: '油漆覆盖率',
+    unitYield: 'm2/L',
+    unitYieldFt: 'ft2/gal',
+    labelType: '选择油漆类型',
+    btnPlasticMatTitle: '哑光乳胶漆',
+    btnPlasticMatSub: '哑光 · 加水5%',
+    btnPlasticSatinTitle: '半光乳胶漆',
+    btnPlasticSatinSub: '半光 · 加水5%',
+    btnEnamelTitle: '搪瓷漆',
+    btnEnamelSub: '搪瓷 · 加溶剂10%',
+    labelCoats: '涂刷遍数',
+    unitCoats: '遍',
+    labelPrice: '每升价格',
+    labelPriceFt: '每加仑价格',
+    unitPrice: '/升',
+    unitPriceGal: '/gal',
+    labelDilution: '稀释百分比',
+    unitDilution: '%',
+    resultBadge: '油漆计算',
+    labelPaint: '油漆升数',
+    labelPaintGal: '油漆加仑数',
+    labelCost: '总成本',
+    labelWater: '稀释液',
+    labelWaterGal: '稀释液',
+    labelTotalVolume: '总混合量',
+    labelTotalVolumeGal: '总混合量',
+    labelCurrency: '货币',
+    btnCurrUSD: '$',
+    btnCurrEUR: '€',
+    btnCurrGBP: '£',
+    btnCurrJPY: '¥',
+    currencySign: '¥',
+  },
+};

package/src/tool/wallPaintingCalculator/index.ts

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

package/src/tool/wallPaintingCalculator/logic.ts

@@ -0,0 +1,27 @@
+export interface WallPaintingInput {
+  area: number;
+  yieldM2PerLitre: number;
+  coats: number;
+  pricePerLitre: number;
+  dilutionPercent: number;
+}
+
+export interface WallPaintingResult {
+  paintLitres: number;
+  waterLitres: number;
+  totalCost: number;
+  totalVolume: number;
+}
+
+export function calculateWallPainting(input: WallPaintingInput): WallPaintingResult {
+  const { area, yieldM2PerLitre, coats, pricePerLitre, dilutionPercent } = input;
+  const paintLitres = yieldM2PerLitre > 0 ? (area * coats) / yieldM2PerLitre : 0;
+  const waterLitres = paintLitres * (dilutionPercent / 100);
+  const totalVolume = paintLitres + waterLitres;
+  const totalCost = paintLitres * pricePerLitre;
+  return { paintLitres, waterLitres, totalCost, totalVolume };
+}
+
+export function fmt2(n: number): string {
+  return n.toFixed(2);
+}

package/src/tool/wallPaintingCalculator/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { wallPaintingCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await wallPaintingCalculator.i18n[locale]?.();
+if (!content) return null;
+---
+
+{content.seo?.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/wallPaintingCalculator/ui.ts

@@ -0,0 +1,42 @@
+export interface WallPaintingCalculatorUI extends Record<string, string> {
+  sectionTitle: string;
+  labelMetric: string;
+  labelImperial: string;
+  labelArea: string;
+  labelAreaFt: string;
+  unitArea: string;
+  unitAreaFt: string;
+  labelYield: string;
+  labelYieldFt: string;
+  unitYield: string;
+  unitYieldFt: string;
+  labelType: string;
+  btnPlasticMatTitle: string;
+  btnPlasticMatSub: string;
+  btnPlasticSatinTitle: string;
+  btnPlasticSatinSub: string;
+  btnEnamelTitle: string;
+  btnEnamelSub: string;
+  labelCoats: string;
+  unitCoats: string;
+  labelPrice: string;
+  labelPriceFt: string;
+  unitPrice: string;
+  unitPriceGal: string;
+  labelDilution: string;
+  unitDilution: string;
+  resultBadge: string;
+  labelPaint: string;
+  labelPaintGal: string;
+  labelCost: string;
+  labelWater: string;
+  labelWaterGal: string;
+  labelTotalVolume: string;
+  labelTotalVolumeGal: string;
+  labelCurrency: string;
+  btnCurrUSD: string;
+  btnCurrEUR: string;
+  btnCurrGBP: string;
+  btnCurrJPY: string;
+  currencySign: string;
+}