@jjlmoya/utils-drones 1.20.0 → 1.22.0

package/src/tool/drone-battery-c-rating-calculator/i18n/tr.ts

@@ -0,0 +1,192 @@
+import type { DroneBatteryCRatingCalculatorLocaleContent } from '../entry';
+import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
+import type { SEOSection } from '../../../types';
+import { BIBLIOGRAPHY_ITEMS } from '../bibliography';
+
+const slug = 'dron-lipo-pil-c-degeri-hesaplayici';
+const title = 'Dron LiPo Pil C Değeri ve Sürekli Deşarj Hesaplayıcı';
+const description = 'İç direnç ve motor akım tüketimine dayanarak dron LiPo pillerinin gerçekçi sürekli deşarj akımını, C değerini, voltaj düşüşünü ve uçuş güvenliğini hesaplayın.';
+
+const ui = {
+  title: 'Dron LiPo Pil C Değeri Hesaplayıcı',
+  subtitle: 'Multirotorlar için gerçekçi sürekli deşarjı, anlık pik gereksinimlerini ve voltaj düşüşünü analiz edin',
+  lipoSpecsHeader: 'Pil Özellikleri',
+  capacityLabel: 'Kapasite (mAh)',
+  claimedCRatingLabel: 'Beyan Edilen C Değeri',
+  cellCountLabel: 'Hücre Sayısı (Seri S)',
+  chemistryLabel: 'Pil Kimyası',
+  internalResistanceLabel: 'Hücre Başına İç Direnç (mΩ)',
+  quadSpecsHeader: 'Dron Akım Tüketimi',
+  motorCountLabel: 'Motor Sayısı',
+  peakMotorCurrentLabel: 'Motor Başına Pik Akım (Amper)',
+  auxCurrentLabel: 'Yardımcı Donanım Tüketimi (VTX, FC, Kamera) (Amper)',
+  presetSelectLabel: 'Hızlı Ayarlar',
+  customPreset: 'Özel',
+  whoopPreset: '1S TinyWhoop',
+  freestyle5Preset: '6S 5 İnç Serbest Uçuş',
+  cinewhoopPreset: '4S 3 İnci CineWhoop',
+  longRange7Preset: '6S 7 İnç Uzun Menzil',
+  racing5Preset: '6S 5 İnç Yarış',
+  resultsHeader: 'Güç ve Performans Analizi',
+  claimedMaxCurrentLabel: 'Beyan Edilen Maksimum Akım',
+  realisticCRatingLabel: 'Gerçekçi Sürekli C Değeri',
+  realisticMaxCurrentLabel: 'Gerçekçi Sürekli Akım',
+  totalPeakDrawLabel: 'Toplam Pik Akım Tüketimi',
+  voltageSagLabel: 'Tahmini Voltaj Düşüşü',
+  sagNominalVoltageLabel: 'Yük Altındaki Nominal Voltaj',
+  flightTimeFullThrottleLabel: 'Tam Gaz Uçuş Süresi',
+  flightTimeHoverLabel: 'Tahmini Askıda Kalma Süresi',
+  safetyStatusLabel: 'Güvenlik Teşhisi',
+  statusOptimalTitle: 'Güvenli ve Optimal Pil Uyumu',
+  statusOptimalDesc: 'Pil, aşırı ısınma veya şiddetli voltaj düşüşü olmadan pik akımı kolayca sağlar. Uzun hücre ömrü garantilidir.',
+  statusWarningTitle: 'Orta Düzey Termal ve Voltaj Stresi',
+  statusWarningDesc: 'Pik akım tüketimi pilin gerçekçi sınırına yakındır. Ani gaz vermelerde hafif voltaj düşüşü beklenir.',
+  statusDangerTitle: 'Yüksek Aşırı Akım ve Voltaj Düşüşü Riski',
+  statusDangerDesc: 'Pik tüketim pilin gerçek kapasitesini aşıyor. Yüksek ısınma, şiddetli voltaj düşüşü ve erken yıpranma riski.',
+  lipoVisualizerTitle: 'Canlı LiPo Durum Görselleştirici',
+  cellVoltageLabel: 'Hücre Başına Voltaj',
+  batteryHealthLabel: 'Pil Stres Durumu',
+  burstRatingRequiredLabel: 'Gerekli Anlık Peak C Değeri',
+  currentRatioLabel: 'Güç Yük Oranı',
+};
+
+const faqItems = [
+  {
+    question: 'Dron LiPo pillerinde C değeri nedir?',
+    answer: 'C değeri, pil kapasitesine oranla maksimum sürekli deşarj hızını temsil eder. Örneğin 1500mAh 100C bir pil teorik olarak 150 Amper akım sağlayabilir.',
+  },
+  {
+    question: 'Beyan edilen C değeri neden gerçekte daha düşüktür?',
+    answer: 'Üreticiler genellikle pazarlama amaçlı anlık zirve değerlerini yansıtır. Gerçek sürekli deşarj doğrudan iç dirence bağlıdır.',
+  },
+  {
+    question: 'İç direnç voltaj düşüşünü ve ısınmayı nasıl etkiler?',
+    answer: 'Yüksek iç direnç hücre içinde istenmeyen bir direnç gibi çalışır. Yüksek akım çekildiğinde voltaj aniden düşer ve enerji ısıya dönüşür.',
+  },
+  {
+    question: 'Freestyle uçuşta voltaj düşüşünü nasıl önlerim?',
+    answer: 'Düşük iç dirençli piller kullanın, pik tüketime karşı en az yüzde 15 güvenlik marjı bırakın ve hücre başına 3.5V altına inmeyin.',
+  },
+];
+
+const howToSteps = [
+  {
+    name: 'Ayarı seçin veya verileri girin',
+    text: 'mAh kapasitesini, beyan edilen C değerini, hücre sayısını ve ortalama iç direnci girin.',
+  },
+  {
+    name: 'Motor tüketimini yapılandırın',
+    text: 'Motor sayısını, tam gazdaki motor başına pik akımı ve yardımcı donanım tüketimini girin.',
+  },
+  {
+    name: 'Güvenlik teşhisini inceleyin',
+    text: 'Güvenli uçuş için gerçekçi sürekli akım ile dronun pik tüketimini karşılaştırın.',
+  },
+];
+
+const seoSections: SEOSection[] = [
+  {
+    type: 'title',
+    text: 'Dron LiPo C Değeri ve Gerçek Güç Çıkışını Anlamak',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'FPV dronlar için doğru LiPo pili seçmek kapasite, C değeri ve motor akım tüketimi arasındaki ilişkiyi anlamayı gerektirir. Üreticiler 100C veya üzeri değerler belirtse de gerçek sürekli deşarj iç direnç ve ısı dağılımı ile sınırlıdır. Bu hesaplayıcı gerçekçi güvenlik marjları sunar.',
+  },
+  {
+    type: 'title',
+    text: 'RC Pil Kimyaları Karşılaştırma Tablosu',
+    level: 2,
+  },
+  {
+    type: 'table',
+    headers: ['Kimya', 'Nominal V', 'Maks V', 'Enerji Yoğunluğu', 'Pik Deşarj', 'Önerilen Kullanım'],
+    rows: [
+      ['LiPo (Standart)', '3.7V', '4.20V', 'Yüksek', '100C - 150C', '5 İnç FPV Yarış ve Serbest Uçuş'],
+      ['LiHV (Yüksek Voltaj)', '3.8V', '4.35V', 'Çok Yüksek', '80C - 120C', 'TinyWhoop ve Mikro Dronlar'],
+      ['Li-Ion (18650/21700)', '3.6V', '4.20V', 'Maksimum', '15C - 35C', '7 İnç Uzun Menzil Dronlar'],
+      ['LiFePO4', '3.3V', '3.65V', 'Orta', '30C - 50C', 'Saha Şarj İstasyonları'],
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Voltaj Düşüşü ve İç Direncin Performansa Etkisi',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Voltaj düşüşü (voltage sag), ani gaz vermelerde voltajın aniden düşmesidir. Akım yüksek iç dirençten geçerken enerji itme gücü yerine ısıya dönüşür. Yıpranmış bir pil OSD ekranında erken düşük voltaj uyarısına yol açar.',
+  },
+  {
+    type: 'list',
+    items: [
+      'Düşük İç Direnç (Hücre başı 1-4 mΩ): Harika tepki, minimum voltaj düşüşü ve serin çalışma.',
+      'Orta İç Direnç (Hücre başı 5-10 mΩ): Serbest uçuş için standart performans.',
+      'Yüksek İç Direnç (Hücre başı >12 mΩ): Belirgin güç kaybı, şiddetli düşüş ve hızlı ısınma.',
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Serbest Uçuş Yarış ve Uzun Menzil Pil Optimizasyonu',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Farklı uçuş tarzları farklı güç profilleri gerektirir. 5 inç serbest uçuş dronları 120 Amper üzeri ani akım sıçramaları oluştururken 7 inç uzun menzil dronları sabit verimlilik arar. Doğru pil eşleşmesi havadaki ani kapanmaları önler.',
+  },
+  {
+    type: 'tip',
+    title: 'LiPo Bakım İpucu',
+    html: 'Kullanılmadığında LiPo pillerinizi her zaman hücre başına 3.80V ile 3.85V depolama voltajında saklayın. Pilleri 48 saatten fazla tam dolu bırakmak iç direnci kalıcı olarak artırır.',
+  },
+];
+
+const schemas: DroneBatteryCRatingCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faqItems.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: title,
+    description,
+    step: howToSteps.map((s, index) => ({
+      '@type': 'HowToStep',
+      position: index + 1,
+      name: s.name,
+      text: s.text,
+    })),
+  } as WithContext<HowTo>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'All',
+    offers: {
+      '@type': 'Offer',
+      price: '0',
+      priceCurrency: 'TRY',
+    },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: DroneBatteryCRatingCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: seoSections,
+  faq: faqItems,
+  howTo: howToSteps,
+  bibliography: BIBLIOGRAPHY_ITEMS,
+  schemas,
+};

package/src/tool/drone-battery-c-rating-calculator/i18n/zh.ts

@@ -0,0 +1,192 @@
+import type { DroneBatteryCRatingCalculatorLocaleContent } from '../entry';
+import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
+import type { SEOSection } from '../../../types';
+import { BIBLIOGRAPHY_ITEMS } from '../bibliography';
+
+const slug = 'drone-battery-c-rating-calculator';
+const title = '无人机 LiPo 电池 C 数与持续放电电流计算器';
+const description = '基于单体电池内阻和电机功耗，计算穿越机与无人机 LiPo 电池的真实持续放电电流、C 倍率、电压压降（Voltage Sag）及飞行安全诊断。';
+
+const ui = {
+  title: '无人机 LiPo 电池 C 数计算器',
+  subtitle: '分析多轴无人机的真实持续放电、峰值负载需求及电压压降',
+  lipoSpecsHeader: '电池参数规格',
+  capacityLabel: '容量 (mAh)',
+  claimedCRatingLabel: '标称 C 数 (C-Rating)',
+  cellCountLabel: '电池串联 S 数 (Series)',
+  chemistryLabel: '电池化学类型',
+  internalResistanceLabel: '单体电池内阻 (mΩ)',
+  quadSpecsHeader: '无人机动力功耗',
+  motorCountLabel: '电机数量',
+  peakMotorCurrentLabel: '单电机峰值电流 (A)',
+  auxCurrentLabel: '辅助设备电流 (图传/飞控/相机) (A)',
+  presetSelectLabel: '快速预设',
+  customPreset: '自定义',
+  whoopPreset: '1S TinyWhoop 微型机',
+  freestyle5Preset: '6S 5英寸 花飞机',
+  cinewhoopPreset: '4S 3英寸 涵道机',
+  longRange7Preset: '6S 7英寸 远航机',
+  racing5Preset: '6S 5英寸 竞速机',
+  resultsHeader: '动力与性能分析',
+  claimedMaxCurrentLabel: '标称最大电流',
+  realisticCRatingLabel: '真实持续 C 数',
+  realisticMaxCurrentLabel: '真实持续放电电流',
+  totalPeakDrawLabel: '总峰值抽流',
+  voltageSagLabel: '预估电压压降',
+  sagNominalVoltageLabel: '负载下标称电压',
+  flightTimeFullThrottleLabel: '全油门续航时间',
+  flightTimeHoverLabel: '预估悬停续航时间',
+  safetyStatusLabel: '安全性诊断',
+  statusOptimalTitle: '安全且最佳的电池匹配',
+  statusOptimalDesc: '电池可以轻松提供峰值电流，不会产生过大发热或严重压降。能够显著延长电池循环寿命。',
+  statusWarningTitle: '中度发热与电压应力',
+  statusWarningDesc: '峰值抽流接近电池的真实放电极限。在大油门猛推时会出现轻微的电压压降。',
+  statusDangerTitle: '过流与严重压降风险高',
+  statusDangerDesc: '无人机峰值抽流超过电池真实放电能力。存在过热、严重压降和电池加速老化的风险。',
+  lipoVisualizerTitle: '实时 LiPo 电池状态可视化',
+  cellVoltageLabel: '单体电压',
+  batteryHealthLabel: '电池负载应力',
+  burstRatingRequiredLabel: '所需峰值 C 数',
+  currentRatioLabel: '动力负载比例',
+};
+
+const faqItems = [
+  {
+    question: '穿越机 LiPo 电池的 C 数代表什么？',
+    answer: 'C 数表示相对于电池容量的最大持续放电速率。例如 1500mAh 标称 100C 的电池，理论上可提供最高 150A 电流。',
+  },
+  {
+    question: '为什么标称 C 数通常高于实际放电能力？',
+    answer: '厂商通常标注的是短时间爆发极限或理想实验室条件下的虚高数值。真实持续放电直接取决于单体电池的内阻。',
+  },
+  {
+    question: '内阻如何影响电压压降和电池发热？',
+    answer: '内阻相当于电池内部的寄生电阻。当大电流通过时，内阻会导致电压骤降，并将电能转化为热能发热。',
+  },
+  {
+    question: '花飞飞行中如何避免电压压降 (Voltage Sag)？',
+    answer: '使用低内阻的高品质电池，保持比峰值抽流高出至少 15% 的安全余量，且静置电压不要低于单体 3.5V。',
+  },
+];
+
+const howToSteps = [
+  {
+    name: '选择预设或输入电池参数',
+    text: '输入容量 (mAh)、标称 C 数、串联 S 数以及单体平均内阻。',
+  },
+  {
+    name: '配置无人机电机与电子设备功耗',
+    text: '设置电机数量、全油门下单电机峰值电流及图传等辅助设备电流。',
+  },
+  {
+    name: '查看安全诊断与真实电流',
+    text: '对比计算出的真实持续电流与无人机峰值抽流，确保飞行安全。',
+  },
+];
+
+const seoSections: SEOSection[] = [
+  {
+    type: 'title',
+    text: '理解穿越机 LiPo 电池 C 数与真实动力输出',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: '为 FPV 穿越机选择合适的 LiPo 电池需要建立电池容量、C 数与电机电流消耗之间的对应关系。虽然厂家常宣传 100C 甚至更高，但真实的持续放电受限于内阻与散热能力。本计算器可算出真实的持续电流保障安全。',
+  },
+  {
+    type: 'title',
+    text: '航模 RC 电池化学类型对比表',
+    level: 2,
+  },
+  {
+    type: 'table',
+    headers: ['化学类型', '标称电压', '最高电压', '能量密度', '峰值放电', '推荐应用场景'],
+    rows: [
+      ['LiPo (标准聚合物)', '3.7V', '4.20V', '高', '100C - 150C', '5英寸 FPV 竞速与花飞穿越机'],
+      ['LiHV (高压聚合物)', '3.8V', '4.35V', '很高', '80C - 120C', 'TinyWhoop 与微型空圈机'],
+      ['Li-Ion (18650/21700)', '3.6V', '4.20V', '极高', '15C - 35C', '7英寸 长航时远航穿越机'],
+      ['LiFePO4 (磷酸铁锂)', '3.3V', '3.65V', '中等', '30C - 50C', '外场充电站与电源箱'],
+    ],
+  },
+  {
+    type: 'title',
+    text: '电压压降与内阻对 FPV 穿越机性能的影响',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: '电压压降 (Voltage Sag) 是指在急加油门时电池电压的瞬间骤降。内阻偏高的老旧电池在大电流下会把电能大量转化为热能，导致 FPV 眼镜 OSD 界面提前弹出低压报警。',
+  },
+  {
+    type: 'list',
+    items: [
+      '超低内阻 (单体 1-4 mΩ): 动力爆发极佳，压降极小，工作温度低。',
+      '中等内阻 (单体 5-10 mΩ): 标准花飞飞行性能，油门全开时有轻微压降。',
+      '高内阻 (单体 >12 mΩ): 动力明显衰减，严重压降，电池发热剧烈。',
+    ],
+  },
+  {
+    type: 'title',
+    text: '花飞、竞速与远航无人机的电池匹配优化',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: '不同的飞行风格对供电系统有截然不同的要求。5英寸花飞机在做动作时会产生超过 120A 的短时电流爆发，而 7英寸远航机则更看重平稳高效的持续巡航。合理的电池匹配能有效防止空中意外断电掉机。',
+  },
+  {
+    type: 'tip',
+    title: 'LiPo 电池保存维保建议',
+    html: '闲置电池时请务必保持在单体 3.80V 至 3.85V 的保存电压 (Storage Mode)。满电放置超过 48 小时会导致电池内阻永久性升高并损伤容量。',
+  },
+];
+
+const schemas: DroneBatteryCRatingCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faqItems.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: title,
+    description,
+    step: howToSteps.map((s, index) => ({
+      '@type': 'HowToStep',
+      position: index + 1,
+      name: s.name,
+      text: s.text,
+    })),
+  } as WithContext<HowTo>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'All',
+    offers: {
+      '@type': 'Offer',
+      price: '0',
+      priceCurrency: 'CNY',
+    },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: DroneBatteryCRatingCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo: seoSections,
+  faq: faqItems,
+  howTo: howToSteps,
+  bibliography: BIBLIOGRAPHY_ITEMS,
+  schemas,
+};

package/src/tool/drone-battery-c-rating-calculator/index.ts

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

package/src/tool/drone-battery-c-rating-calculator/logic.test.ts

@@ -0,0 +1,84 @@
+import { describe, it, expect } from 'vitest';
+import {
+  getNominalCellVoltage,
+  getFullyChargedCellVoltage,
+  calculateClaimedCurrent,
+  calculateRealisticCRating,
+  calculateTotalPeakDraw,
+  calculateVoltageSag,
+  calculateFlightTimeSeconds,
+  evaluateSafetyStatus,
+  calculateBatteryMetrics,
+  type BatteryInputs,
+} from './logic';
+
+describe('Drone Battery C-Rating Logic', () => {
+  it('should return correct nominal cell voltages', () => {
+    expect(getNominalCellVoltage('lipo')).toBe(3.7);
+    expect(getNominalCellVoltage('lihv')).toBe(3.8);
+    expect(getNominalCellVoltage('liion')).toBe(3.6);
+    expect(getNominalCellVoltage('life')).toBe(3.3);
+  });
+
+  it('should return correct fully charged cell voltages', () => {
+    expect(getFullyChargedCellVoltage('lipo')).toBe(4.2);
+    expect(getFullyChargedCellVoltage('lihv')).toBe(4.35);
+    expect(getFullyChargedCellVoltage('liion')).toBe(4.2);
+    expect(getFullyChargedCellVoltage('life')).toBe(3.65);
+  });
+
+  it('should calculate claimed continuous current', () => {
+    expect(calculateClaimedCurrent(1300, 75)).toBe(97.5);
+    expect(calculateClaimedCurrent(0, 75)).toBe(0);
+    expect(calculateClaimedCurrent(1500, -10)).toBe(0);
+  });
+
+  it('should calculate realistic C-rating based on internal resistance', () => {
+    expect(calculateRealisticCRating(4, 100, 1300)).toBe(52);
+    expect(calculateRealisticCRating(15, 80, 300)).toBe(80);
+    expect(calculateRealisticCRating(0, 80, 1300)).toBe(80);
+    expect(calculateRealisticCRating(25, 100, 1300)).toBe(21);
+  });
+
+  it('should calculate total peak current draw', () => {
+    expect(calculateTotalPeakDraw(4, 30, 1.5)).toBe(121.5);
+    expect(calculateTotalPeakDraw(0, 30, 1.5)).toBe(1.5);
+  });
+
+  it('should calculate voltage sag', () => {
+    expect(calculateVoltageSag(100, 5, 4)).toBe(2);
+    expect(calculateVoltageSag(0, 5, 4)).toBe(0);
+  });
+
+  it('should calculate flight time in seconds', () => {
+    expect(calculateFlightTimeSeconds(1000, 60)).toBeCloseTo(48);
+    expect(calculateFlightTimeSeconds(1000, 0)).toBe(0);
+  });
+
+  it('should evaluate safety status correctly', () => {
+    expect(evaluateSafetyStatus(100, 90)).toBe('optimal');
+    expect(evaluateSafetyStatus(100, 150)).toBe('warning');
+    expect(evaluateSafetyStatus(100, 250)).toBe('danger');
+    expect(evaluateSafetyStatus(100, 0)).toBe('optimal');
+  });
+
+  it('should calculate complete battery metrics', () => {
+    const inputs: BatteryInputs = {
+      capacitymAh: 1300,
+      claimedCRating: 100,
+      cellCount: 4,
+      chemistry: 'lipo',
+      internalResistanceMOm: 5,
+      motorCount: 4,
+      peakMotorCurrentA: 25,
+      auxCurrentA: 1.5,
+    };
+
+    const res = calculateBatteryMetrics(inputs);
+    expect(res.claimedMaxCurrentA).toBe(130);
+    expect(res.totalPeakDrawA).toBe(101.5);
+    expect(res.voltageSagV).toBeCloseTo(2.03);
+    expect(res.sagNominalVoltageV).toBeGreaterThan(0);
+    expect(res.flightTimeFullThrottleSec).toBeGreaterThan(0);
+  });
+});

package/src/tool/drone-battery-c-rating-calculator/logic.ts

@@ -0,0 +1,112 @@
+export type BatteryChemistry = 'lipo' | 'lihv' | 'liion' | 'life';
+export type SafetyStatus = 'optimal' | 'warning' | 'danger';
+
+export interface BatteryInputs {
+  capacitymAh: number;
+  claimedCRating: number;
+  cellCount: number;
+  chemistry: BatteryChemistry;
+  internalResistanceMOm: number;
+  motorCount: number;
+  peakMotorCurrentA: number;
+  auxCurrentA: number;
+}
+
+export interface BatteryCalculationResults {
+  claimedMaxCurrentA: number;
+  realisticCRating: number;
+  realisticMaxCurrentA: number;
+  totalPeakDrawA: number;
+  voltageSagV: number;
+  sagNominalVoltageV: number;
+  sagFullVoltageV: number;
+  flightTimeFullThrottleSec: number;
+  flightTimeHoverSec: number;
+  burstRatingRequired: number;
+  safetyStatus: SafetyStatus;
+}
+
+export function getNominalCellVoltage(chemistry: BatteryChemistry): number {
+  if (chemistry === 'lihv') return 3.8;
+  if (chemistry === 'liion') return 3.6;
+  if (chemistry === 'life') return 3.3;
+  return 3.7;
+}
+
+export function getFullyChargedCellVoltage(chemistry: BatteryChemistry): number {
+  if (chemistry === 'lihv') return 4.35;
+  if (chemistry === 'liion') return 4.2;
+  if (chemistry === 'life') return 3.65;
+  return 4.2;
+}
+
+export function calculateClaimedCurrent(capacitymAh: number, claimedCRating: number): number {
+  if (capacitymAh <= 0 || claimedCRating <= 0) return 0;
+  return (capacitymAh / 1000) * claimedCRating;
+}
+
+export function calculateRealisticCRating(internalResistanceMOm: number, claimedC: number, capacitymAh: number): number {
+  if (internalResistanceMOm <= 0 || capacitymAh <= 0) return claimedC;
+  const capacityAh = capacitymAh / 1000;
+  const maxThermalAmps = Math.sqrt(18 / (internalResistanceMOm / 1000));
+  const maxThermalC = Math.round(maxThermalAmps / capacityAh);
+  return Math.min(claimedC, Math.max(10, maxThermalC));
+}
+
+export function calculateTotalPeakDraw(motorCount: number, peakMotorCurrentA: number, auxCurrentA: number): number {
+  const motors = Math.max(0, motorCount);
+  const perMotor = Math.max(0, peakMotorCurrentA);
+  const aux = Math.max(0, auxCurrentA);
+  return motors * perMotor + aux;
+}
+
+export function calculateVoltageSag(totalPeakDrawA: number, internalResistanceMOm: number, cellCount: number): number {
+  if (totalPeakDrawA <= 0 || internalResistanceMOm <= 0 || cellCount <= 0) return 0;
+  const packResistanceOm = (internalResistanceMOm / 1000) * cellCount;
+  return totalPeakDrawA * packResistanceOm;
+}
+
+export function calculateFlightTimeSeconds(capacitymAh: number, currentA: number): number {
+  if (capacitymAh <= 0 || currentA <= 0) return 0;
+  return (capacitymAh / 1000 / currentA) * 3600 * 0.8;
+}
+
+export function evaluateSafetyStatus(realisticMaxCurrentA: number, totalPeakDrawA: number): SafetyStatus {
+  if (totalPeakDrawA <= 0) return 'optimal';
+  const burstCapacityA = realisticMaxCurrentA * 1.8;
+  if (totalPeakDrawA <= realisticMaxCurrentA * 1.1) return 'optimal';
+  if (totalPeakDrawA <= burstCapacityA) return 'warning';
+  return 'danger';
+}
+
+function calculateVoltagesAndRuntimes(inputs: BatteryInputs, totalPeakDrawA: number, voltageSagV: number) {
+  const nominalTotalV = getNominalCellVoltage(inputs.chemistry) * inputs.cellCount;
+  const fullTotalV = getFullyChargedCellVoltage(inputs.chemistry) * inputs.cellCount;
+  const sagNominalVoltageV = Math.max(0, nominalTotalV - voltageSagV);
+  const sagFullVoltageV = Math.max(0, fullTotalV - voltageSagV);
+  const flightTimeFullThrottleSec = calculateFlightTimeSeconds(inputs.capacitymAh, totalPeakDrawA);
+  const flightTimeHoverSec = calculateFlightTimeSeconds(inputs.capacitymAh, Math.max(1, totalPeakDrawA * 0.25));
+  return { sagNominalVoltageV, sagFullVoltageV, flightTimeFullThrottleSec, flightTimeHoverSec };
+}
+
+export function calculateBatteryMetrics(inputs: BatteryInputs): BatteryCalculationResults {
+  const claimedMaxCurrentA = calculateClaimedCurrent(inputs.capacitymAh, inputs.claimedCRating);
+  const realisticCRating = calculateRealisticCRating(inputs.internalResistanceMOm, inputs.claimedCRating, inputs.capacitymAh);
+  const realisticMaxCurrentA = (inputs.capacitymAh / 1000) * realisticCRating;
+  const totalPeakDrawA = calculateTotalPeakDraw(inputs.motorCount, inputs.peakMotorCurrentA, inputs.auxCurrentA);
+  const voltageSagV = calculateVoltageSag(totalPeakDrawA, inputs.internalResistanceMOm, inputs.cellCount);
+  const sub = calculateVoltagesAndRuntimes(inputs, totalPeakDrawA, voltageSagV);
+  const burstRatingRequired = inputs.capacitymAh > 0 ? (totalPeakDrawA / (inputs.capacitymAh / 1000)) : 0;
+  const safetyStatus = evaluateSafetyStatus(realisticMaxCurrentA, totalPeakDrawA);
+
+  return {
+    claimedMaxCurrentA,
+    realisticCRating,
+    realisticMaxCurrentA,
+    totalPeakDrawA,
+    voltageSagV,
+    ...sub,
+    burstRatingRequired,
+    safetyStatus,
+  };
+}

package/src/tool/drone-battery-c-rating-calculator/seo.astro

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

package/src/tool/drone-battery-c-rating-calculator/storage.ts

@@ -0,0 +1,19 @@
+import type { BatteryInputs } from './logic';
+
+const STORAGE_KEY = 'jjl_drone_lipo_c_rating_inputs';
+
+export function loadSavedInputs(): Partial<BatteryInputs> {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (!raw) return {};
+    return JSON.parse(raw) as Partial<BatteryInputs>;
+  } catch {
+    return {};
+  }
+}
+
+export function saveInputs(inputs: BatteryInputs): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(inputs));
+  } catch {}
+}

package/src/tool/drone-battery-c-rating-calculator/ui.ts

@@ -0,0 +1,43 @@
+export interface DroneBatteryCRatingCalculatorUI {
+  [key: string]: string;
+  title: string;
+  subtitle: string;
+  lipoSpecsHeader: string;
+  capacityLabel: string;
+  claimedCRatingLabel: string;
+  cellCountLabel: string;
+  chemistryLabel: string;
+  internalResistanceLabel: string;
+  quadSpecsHeader: string;
+  motorCountLabel: string;
+  peakMotorCurrentLabel: string;
+  auxCurrentLabel: string;
+  presetSelectLabel: string;
+  customPreset: string;
+  whoopPreset: string;
+  freestyle5Preset: string;
+  cinewhoopPreset: string;
+  longRange7Preset: string;
+  racing5Preset: string;
+  resultsHeader: string;
+  claimedMaxCurrentLabel: string;
+  realisticCRatingLabel: string;
+  realisticMaxCurrentLabel: string;
+  totalPeakDrawLabel: string;
+  voltageSagLabel: string;
+  sagNominalVoltageLabel: string;
+  flightTimeFullThrottleLabel: string;
+  flightTimeHoverLabel: string;
+  safetyStatusLabel: string;
+  statusOptimalTitle: string;
+  statusOptimalDesc: string;
+  statusWarningTitle: string;
+  statusWarningDesc: string;
+  statusDangerTitle: string;
+  statusDangerDesc: string;
+  lipoVisualizerTitle: string;
+  cellVoltageLabel: string;
+  batteryHealthLabel: string;
+  burstRatingRequiredLabel: string;
+  currentRatioLabel: string;
+}