@jjlmoya/utils-chrono 1.17.0 → 1.19.0

package/src/tool/lume-color-simulator/i18n/ru.ts

@@ -4,7 +4,7 @@ import { bibliography } from '../bibliography';
 
 export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
   slug: 'simulyator-tsveta-lyuminofora',
-  title: 'Симулятор цвета люминофора — визуализатор свечения часов',
+  title: 'Симулятор цвета люминофора: визуализатор свечения часов',
   description: 'Визуализируйте разные цвета люминофора в реальном времени. Сравнивайте C1, C3, BGW9, LumiNova и другие типы при разной яркости освещения.',
   ui: {
     title: 'Симулятор цвета люминофора',
@@ -37,8 +37,8 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
     tipContent: 'Яркость люминофора зависит от качества пигмента и того, сколько света он поглотил. BGW9 светится голубовато-белым и является самым ярким, тогда как винтажный люминофор даёт тёплое, приглушённое свечение.',
   },
   seo: [
-    { type: 'title', text: 'Симулятор свечения циферблата — визуализатор люминофора в реальном времени', level: 2 },
-    { type: 'paragraph', html: 'Люминофор — один из самых личных аспектов в коллекционировании часов. Вам ближе классическое зелёное свечение <strong>C1 Super-LumiNova</strong> или ледяной голубой <strong>BGW9</strong>? Этот симулятор покажет, как каждый тип люминофора выглядит при разной яркости — от полного дневного света до кромешной тьмы — с точными значениями <strong>HEX и RGB</strong> для каждого оттенка.' },
+    { type: 'title', text: 'Симулятор свечения циферблата - визуализатор люминофора в реальном времени', level: 2 },
+    { type: 'paragraph', html: 'Люминофор - один из самых личных аспектов в коллекционировании часов. Вам ближе классическое зелёное свечение <strong>C1 Super-LumiNova</strong> или ледяной голубой <strong>BGW9</strong>? Этот симулятор покажет, как каждый тип люминофора выглядит при разной яркости - от полного дневного света до кромешной тьмы - с точными значениями <strong>HEX и RGB</strong> для каждого оттенка.' },
     { type: 'title', text: 'Сравнение типов Super-LumiNova', level: 3 },
     {
       type: 'table', headers: ['Тип', 'Цвет днём', 'Цвет свечения', 'Яркость', 'Для каких часов'], rows: [
@@ -52,7 +52,7 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
         ['Зелёный', 'Ярко-зелёный', 'Зелёный', 'Высокая', 'Часы в военном стиле'],
       ]
     },
-    { type: 'title', text: 'C1 vs C3 vs BGW9 — что выбрать?', level: 3 },
+    { type: 'title', text: 'C1 vs C3 vs BGW9 - что выбрать?', level: 3 },
     {
       type: 'comparative', columns: 2, items: [
         { title: 'C1 Классический зелёный', icon: 'mdi:lightbulb-on', description: 'Оригинальная формула Super-LumiNova. Светится зелёным со средней яркостью. Надёжный, классический выбор, подходящий к любому стилю часов.', points: ['Средняя яркость, видимость 4-6 ч', 'Зелёное свечение, тёплый оттенок', 'Самая доступная формула', 'Часто встречается в начальном сегменте'], highlight: false },
@@ -65,34 +65,34 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
         { title: 'Винтаж в стиле радия', icon: 'mdi:fire', description: 'Тёплый бежево-кремовый оттенок, имитирующий люминофор 1960-х годов. Намеренно более тусклый ради аутентичности. Свечение тёплое, тонкое и красиво стареет.', points: ['Низкая яркость, видимость 2-4 ч', 'Тёплый кремовый до тусклого янтарного', 'Состаренный вид без радиоактивности', 'Популярен в репликах ретро-моделей'], highlight: false },
       ]
     },
-    { type: 'diagnostic', variant: 'info', title: 'Яркость — не главное', icon: 'mdi:palette', html: 'Самый яркий люминофор (C3) не всегда лучший выбор. <strong>BGW9</strong> жертвует небольшую разницу в яркости ради более нейтрального, современного вида, который многим коллекционерам нравится больше. <strong>Винтажный люминофор</strong> ставит историческую достоверность выше производительности. Выбирайте исходя из того, что для вас важнее: <strong>максимальное свечение, современная эстетика или историческая аутентичность.</strong>' },
+    { type: 'diagnostic', variant: 'info', title: 'Яркость: не главное', icon: 'mdi:palette', html: 'Самый яркий люминофор (C3) не всегда лучший выбор. <strong>BGW9</strong> жертвует небольшую разницу в яркости ради более нейтрального, современного вида, который многим коллекционерам нравится больше. <strong>Винтажный люминофор</strong> ставит историческую достоверность выше производительности. Выбирайте исходя из того, что для вас важнее: <strong>максимальное свечение, современная эстетика или историческая аутентичность.</strong>' },
     { type: 'title', text: 'Как работает люминофор: наука свечения', level: 3 },
     {
       type: 'glossary', items: [
         { term: 'Super-LumiNova', definition: 'Фотолюминесцентный пигмент на основе алюмината стронция. Поглощает ультрафиолетовый и видимый свет и переизлучает его в виде свечения. Не радиоактивен и безопасен. Первоначально разработан компанией Nemoto & Co. в 1993 году.' },
         { term: 'Время зарядки', definition: 'Длительность светового воздействия, необходимая для насыщения люминофора. Полная зарядка занимает 10-30 минут под прямыми солнечными лучами или УФ-лампой. Чем дольше зарядка, тем ярче и дольше свечение.' },
-        { term: 'Длительность свечения', definition: 'Как долго люминофор остаётся видимым после зарядки. Качественный Super-LumiNova светится 6-12 часов. Самый яркий период — первые 30 минут после зарядки.' },
+        { term: 'Длительность свечения', definition: 'Как долго люминофор остаётся видимым после зарядки. Качественный Super-LumiNova светится 6-12 часов. Самый яркий период - первые 30 минут после зарядки.' },
         { term: 'Класс пигмента', definition: 'Качество кристаллов алюмината стронция. Пигменты высшего класса (C3, BGW9) используют более крупные однородные кристаллы для более яркого и долгого свечения. Пигменты низшего класса (LumiNova) используют более мелкие кристаллы и светят тусклее.' },
       ]
     },
     {
       type: 'summary', title: 'Краткий гайд по выбору люминофора', items: [
         'Для максимальной читаемости в темноте: выбирайте C3 (самый яркий зелёный) или BGW9 (самый яркий голубовато-белый).',
-        'Для современного люксового вида: BGW9 — текущий фаворит среди премиальных брендов.',
+        'Для современного люксового вида: BGW9 - текущий фаворит среди премиальных брендов.',
         'Для винтажных и ретро-моделей: используйте Vintage или Orange для исторической достоверности.',
-        'C1 — универсал: хорошая яркость, классический зелёный, доступная цена.',
-        'Цвет люминофора днём и цвет свечения сильно отличаются — используйте симулятор, чтобы сравнить оба режима.',
+        'C1 - универсал: хорошая яркость, классический зелёный, доступная цена.',
+        'Цвет люминофора днём и цвет свечения сильно отличаются - используйте симулятор, чтобы сравнить оба режима.',
       ]
     },
   ],
   faq: [
     {
       question: 'Какой люминофор самый яркий?',
-      answer: 'C3 Super-LumiNova — самая яркая зелёная формула. BGW9 — самая яркая голубовато-белая. Обе значительно ярче C1 или стандартного LumiNova.',
+      answer: 'C3 Super-LumiNova - самая яркая зелёная формула. BGW9 - самая яркая голубовато-белая. Обе значительно ярче C1 или стандартного LumiNova.',
     },
     {
       question: 'Что такое люминофор BGW9?',
-      answer: 'BGW9 — это разновидность Super-LumiNova, которая светится голубовато-белым вместо зелёного. Немного уступает C3 по яркости, но многие ценят его за чистый, современный вид.',
+      answer: 'BGW9 - это разновидность Super-LumiNova, которая светится голубовато-белым вместо зелёного. Немного уступает C3 по яркости, но многие ценят его за чистый, современный вид.',
     },
     {
       question: 'Светится ли винтажный люминофор?',
@@ -100,7 +100,7 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
     },
     {
       question: 'Как долго держится люминофор?',
-      answer: 'После полной зарядки под ярким светом качественный Super-LumiNova остаётся видимым 6-12 часов. Самый яркий период — первые 30 минут.',
+      answer: 'После полной зарядки под ярким светом качественный Super-LumiNova остаётся видимым 6-12 часов. Самый яркий период - первые 30 минут.',
     },
   ],
   bibliography,
@@ -126,12 +126,12 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
         {
           '@type': 'Question',
           'name': 'Какой люминофор самый яркий?',
-          'acceptedAnswer': { '@type': 'Answer', 'text': 'C3 Super-LumiNova — самый яркий зелёный. BGW9 — самый яркий голубовато-белый.' },
+          'acceptedAnswer': { '@type': 'Answer', 'text': 'C3 Super-LumiNova - самый яркий зелёный. BGW9 - самый яркий голубовато-белый.' },
         },
         {
           '@type': 'Question',
           'name': 'Что такое люминофор BGW9?',
-          'acceptedAnswer': { '@type': 'Answer', 'text': 'BGW9 — это разновидность Super-LumiNova, которая светится голубовато-белым вместо зелёного.' },
+          'acceptedAnswer': { '@type': 'Answer', 'text': 'BGW9 - это разновидность Super-LumiNova, которая светится голубовато-белым вместо зелёного.' },
         },
         {
           '@type': 'Question',

package/src/tool/lume-color-simulator/i18n/zh.ts

@@ -4,7 +4,7 @@ import { bibliography } from '../bibliography';
 
 export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
   slug: 'lume-color-simulator',
-  title: '夜光颜色模拟器 — 手表夜光效果在线预览',
+  title: '夜光颜色模拟器: 手表夜光效果在线预览',
   description: '实时预览不同夜光颜色的效果。对比 C1、C3、BGW9、LumiNova 等多种夜光在不同环境亮度下的表现。',
   ui: {
     title: '夜光颜色模拟器',
@@ -37,7 +37,7 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
     tipContent: '夜光亮度取决于颜料品质和吸收光量的多少。BGW9 发出蓝白色光，亮度最高；而复古夜光呈暖色，亮度较暗。',
   },
   seo: [
-    { type: 'title', text: '手表夜光颜色模拟器 — 实时发光效果预览', level: 2 },
+    { type: 'title', text: '手表夜光颜色模拟器 - 实时发光效果预览', level: 2 },
     { type: 'paragraph', html: '夜光是手表收藏中最个性化的选择之一。你偏爱 <strong>C1 Super-LumiNova</strong> 的经典绿色光芒，还是 <strong>BGW9</strong> 的冰蓝色调？本模拟器展示每种夜光类型在从日光到全黑不同亮度等级下的表现，并提供每种颜色的精确 <strong>HEX 和 RGB 值</strong>。' },
     { type: 'title', text: 'Super-LumiNova 类型对比', level: 3 },
     {
@@ -52,7 +52,7 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
         ['Green', '亮绿色', '绿色', '高', '军表风格手表'],
       ]
     },
-    { type: 'title', text: 'C1 vs C3 vs BGW9 — 该如何选择？', level: 3 },
+    { type: 'title', text: 'C1 vs C3 vs BGW9 - 该如何选择？', level: 3 },
     {
       type: 'comparative', columns: 2, items: [
         { title: 'C1 经典绿色', icon: 'mdi:lightbulb-on', description: 'Super-LumiNova 最早期的配方。发出中等亮度的绿色荧光。安全经典，适合任何手表风格。', points: ['中等亮度，可见 4-6 小时', '绿色发光，暖色调', '最经济的配方', '常见于入门级手表'], highlight: false },
@@ -81,7 +81,7 @@ export const content: ToolLocaleContent<LumeColorSimulatorUI> = {
         '追求现代豪华质感：BGW9 是目前高端手表品牌中的热门之选。',
         '追求复古/复刻风格：使用 Vintage 或 Orange 以获得时代准确的温暖色调。',
         'C1 是万金油：亮度不错、经典绿色、价格实惠。',
-        '夜光在日光下的颜色与发光颜色差异很大——使用模拟器同时对比两者。',
+        '夜光在日光下的颜色与发光颜色差异很大-使用模拟器同时对比两者。',
       ]
     },
   ],

package/src/tool/mainspring-finder/bibliography.astro

@@ -0,0 +1,16 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { mainspringFinder } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props as Props;
+const loader = mainspringFinder.i18n[locale] || mainspringFinder.i18n.en;
+const content = await loader?.();
+if (!content) return null;
+---
+
+{content && <SharedBibliography links={content.bibliography} />}

package/src/tool/mainspring-finder/bibliography.ts

@@ -0,0 +1,16 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: 'Mainspring Dimensions & Specifications - Ranfft',
+    url: 'https://ranfft.org/caliber/5755-FHF-76-2',
+  },
+  {
+    name: 'Watch Mainspring Guide',
+    url: 'https://www.vintagewatchstraps.com/mainsprings.php',
+  },
+  {
+    name: 'Mainspring Sizing Chart - Cousins UK',
+    url: 'https://www.cousinsuk.com/category/filter/mainsprings-by-size-search-watch-pocket',
+  },
+];

package/src/tool/mainspring-finder/client.ts

@@ -0,0 +1,89 @@
+import { calculateMainspring, fmt } from './helpers';
+
+const el = document.querySelector('.msf') as HTMLElement;
+const UI = JSON.parse(el.dataset.ui || '{}');
+
+const barrelIn = document.getElementById('msf-barrel') as HTMLInputElement;
+const arborIn = document.getElementById('msf-arbor') as HTMLInputElement;
+const heightIn = document.getElementById('msf-height') as HTMLInputElement;
+const turnsIn = document.getElementById('msf-turns') as HTMLInputElement;
+const unitBtns = document.querySelectorAll('.msf-u-btn') as NodeListOf<HTMLElement>;
+const result = document.getElementById('msf-result') as HTMLElement;
+const thickV = document.getElementById('msf-thick') as HTMLElement;
+const heightV = document.getElementById('msf-h') as HTMLElement;
+const lenV = document.getElementById('msf-len') as HTMLElement;
+const strengthB = document.getElementById('msf-strength') as HTMLElement;
+const commV = document.getElementById('msf-comm') as HTMLElement;
+
+const sLabels = [UI.strengthWeak || 'Light', UI.strengthMedium || 'Medium', UI.strengthStrong || 'Strong'];
+const sColors = ['#10b981', '#f59e0b', '#ef4444'];
+const KEY = 'jjlmoya_chrono_msf';
+let cur: 'mm' | 'in' = 'mm';
+
+interface S { b: string; a: string; h: string; t: string; u: string }
+
+function parseNum(v: string): number {
+  return parseFloat(v.replace(',', '.')) || 0;
+}
+
+function save() {
+  try { localStorage.setItem(KEY, JSON.stringify({ b: barrelIn.value, a: arborIn.value, h: heightIn.value, t: turnsIn.value, u: cur } as S)); } catch {}
+}
+
+function load() {
+  try {
+    const r = localStorage.getItem(KEY);
+    if (!r) return;
+    const s: S = JSON.parse(r);
+    const pairs: [string | undefined, HTMLInputElement][] = [[s.b, barrelIn], [s.a, arborIn], [s.h, heightIn], [s.t, turnsIn]];
+    for (const [v, el] of pairs) { if (v) el.value = v; }
+    if (s.u === 'in' || s.u === 'mm') cur = s.u;
+  } catch {}
+}
+
+function convertVal(v: number, from: 'mm' | 'in', to: 'mm' | 'in'): number {
+  if (from === to) return v;
+  return to === 'in' ? v / 25.4 : v * 25.4;
+}
+
+function setUnit(u: 'mm' | 'in') {
+  if (u === cur) return;
+  const b = parseNum(barrelIn.value);
+  const a = parseNum(arborIn.value);
+  const h = parseNum(heightIn.value);
+  barrelIn.value = convertVal(b, cur, u).toFixed(u === 'in' ? 2 : 1);
+  arborIn.value = convertVal(a, cur, u).toFixed(u === 'in' ? 3 : 1);
+  heightIn.value = convertVal(h, cur, u).toFixed(u === 'in' ? 3 : 2);
+  barrelIn.step = ''; arborIn.step = ''; heightIn.step = '';
+  cur = u;
+  unitBtns.forEach(b => b.classList.toggle('msf-u-on', b.dataset.unit === u));
+  calc();
+}
+
+function calc() {
+  const barrelId = parseNum(barrelIn.value);
+  const arborD = parseNum(arborIn.value);
+  const height = parseNum(heightIn.value);
+  const turns = parseInt(turnsIn.value, 10) || 6;
+  const r = calculateMainspring({ barrelId, barrelH: height, arborD, turns, unit: cur });
+  if (!r) { result.style.display = 'none'; return; }
+
+  const ul = cur;
+  thickV.textContent = `${fmt(r.thickness, cur, cur === 'in' ? 4 : 3)} ${ul}`;
+  heightV.textContent = `${fmt(r.height, cur, 2)} ${ul}`;
+  lenV.textContent = `${fmt(r.length, cur, 1)} ${ul}`;
+  strengthB.textContent = sLabels[r.strengthIndex];
+  strengthB.style.background = sColors[r.strengthIndex];
+  commV.textContent = `${fmt(r.height, cur, 2)} x ${fmt(r.thickness, cur, cur === 'in' ? 4 : 3)} x ${fmt(r.length, cur, 1)} ${ul}`;
+  result.style.display = 'flex';
+  save();
+}
+
+unitBtns.forEach(b => b.addEventListener('click', () => setUnit(b.dataset.unit as 'mm' | 'in')));
+barrelIn.addEventListener('input', calc);
+arborIn.addEventListener('input', calc);
+heightIn.addEventListener('input', calc);
+turnsIn.addEventListener('input', calc);
+load();
+setUnit(cur);
+calc();

package/src/tool/mainspring-finder/component.astro

@@ -0,0 +1,72 @@
+---
+interface Props { ui: Record<string, string> }
+const { ui } = Astro.props;
+---
+
+<div class="msf" data-ui={JSON.stringify(ui)}>
+  <div class="msf-top">
+    <div class="msf-u">
+      <button class="msf-u-btn msf-u-on" data-unit="mm" type="button">{ui.mm || "mm"}</button>
+      <button class="msf-u-btn" data-unit="in" type="button">{ui.inch || "in"}</button>
+    </div>
+  </div>
+
+  <div class="msf-grid">
+    <label class="msf-f">
+      <span class="msf-f-l">{ui.barrelLabel || "Barrel ID"}</span>
+      <input class="msf-f-i" id="msf-barrel" type="text" inputmode="decimal" value="14.0" />
+    </label>
+    <label class="msf-f">
+      <span class="msf-f-l">{ui.arborLabel || "Arbor OD"}</span>
+      <input class="msf-f-i" id="msf-arbor" type="text" inputmode="decimal" value="3.5" />
+    </label>
+    <label class="msf-f">
+      <span class="msf-f-l">{ui.heightLabel || "Height"}</span>
+      <input class="msf-f-i" id="msf-height" type="text" inputmode="decimal" value="1.50" />
+    </label>
+    <label class="msf-f">
+      <span class="msf-f-l">{ui.turnsLabel || "Turns"}</span>
+      <input class="msf-f-i" id="msf-turns" type="text" inputmode="numeric" value="6" />
+    </label>
+  </div>
+
+  <div class="msf-r" id="msf-result">
+    <div class="msf-r-grid">
+      <div class="msf-r-c">
+        <span class="msf-r-c-l">{ui.resultThickness || "Thickness"}</span>
+        <span class="msf-r-c-v" id="msf-thick">--</span>
+      </div>
+      <div class="msf-r-c">
+        <span class="msf-r-c-l">{ui.resultHeight || "Height"}</span>
+        <span class="msf-r-c-v" id="msf-h">--</span>
+      </div>
+      <div class="msf-r-c">
+        <span class="msf-r-c-l">{ui.resultLength || "Length"}</span>
+        <span class="msf-r-c-v" id="msf-len">--</span>
+      </div>
+    </div>
+    <div class="msf-r-bot">
+      <div class="msf-r-bot-i">
+        <span class="msf-r-bot-l">{ui.resultStrength || "Strength"}</span>
+        <span class="msf-badge" id="msf-strength">--</span>
+      </div>
+      <div class="msf-r-bot-i">
+        <span class="msf-r-bot-l">{ui.commercial || "Size"}</span>
+        <span class="msf-r-bot-v" id="msf-comm">--</span>
+      </div>
+    </div>
+  </div>
+
+  <div class="msf-steps">
+    <div class="msf-step"><span class="msf-step-n">1</span><span>{ui.step1 || "Measure barrel ID, arbor OD, and height."}</span></div>
+    <div class="msf-step"><span class="msf-step-n">2</span><span>{ui.step2 || "Set winding turns (5-8 manual, 6-10 auto)."}</span></div>
+    <div class="msf-step"><span class="msf-step-n">3</span><span>{ui.step3 || "Toggle mm/in for your unit."}</span></div>
+  </div>
+
+  <div class="msf-tip">
+    <svg viewBox="0 0 24 24" width="14" height="14" style="flex-shrink:0;margin-top:0.05rem"><path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z" fill="currentColor"/></svg>
+    <span>{ui.tipContent || "Always verify against manufacturer specs before ordering."}</span>
+  </div>
+</div>
+
+<script src="./client.ts"></script>

package/src/tool/mainspring-finder/entry.ts

@@ -0,0 +1,50 @@
+import type { ChronoToolEntry, ToolLocaleContent } from '../../types';
+
+export type MainspringFinderUI = {
+  title: string;
+  barrelLabel: string;
+  arborLabel: string;
+  heightLabel: string;
+  turnsLabel: string;
+  calculate: string;
+  resultThickness: string;
+  resultHeight: string;
+  resultLength: string;
+  resultStrength: string;
+  strengthWeak: string;
+  strengthMedium: string;
+  strengthStrong: string;
+  commercial: string;
+  unitLabel: string;
+  mm: string;
+  inch: string;
+  step1: string;
+  step2: string;
+  step3: string;
+  tipTitle: string;
+  tipContent: string;
+};
+
+export type MainspringFinderLocaleContent = ToolLocaleContent<MainspringFinderUI>;
+
+export const mainspringFinder: ChronoToolEntry<MainspringFinderUI> = {
+  id: 'mainspring-finder',
+  icons: { bg: 'mdi:ruler', fg: 'mdi:cog-clockwise' },
+  i18n: {
+    en: () => import('./i18n/en').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};

package/src/tool/mainspring-finder/helpers.ts

@@ -0,0 +1,52 @@
+export interface MainspringInput {
+  barrelId: number;
+  barrelH: number;
+  arborD: number;
+  turns: number;
+  unit: 'mm' | 'in';
+}
+
+export interface MainspringResult {
+  thickness: number;
+  height: number;
+  length: number;
+  strengthIndex: number;
+}
+
+export function toMm(val: number, unit: 'mm' | 'in'): number {
+  return unit === 'in' ? val * 25.4 : val;
+}
+
+export function fmt(val: number, unit: 'mm' | 'in', dec: number): string {
+  const v = unit === 'in' ? val / 25.4 : val;
+  return v.toFixed(dec);
+}
+
+function getStrengthIndex(thickness: number): number {
+  if (thickness <= 0.10) return 0;
+  if (thickness <= 0.18) return 1;
+  return 2;
+}
+
+export function calculateMainspring(input: MainspringInput): MainspringResult | null {
+  let { barrelId, barrelH, arborD } = input;
+  const { turns, unit } = input;
+  barrelId = toMm(barrelId, unit);
+  barrelH = toMm(barrelH, unit);
+  arborD = toMm(arborD, unit);
+
+  if (barrelId <= 0 || arborD <= 0 || barrelH <= 0 || arborD >= barrelId) return null;
+
+  const clearance = 0.1;
+  const height = barrelH - clearance;
+
+  const thickness = (barrelId - arborD) / (4 * Math.PI * turns);
+  const length = (Math.PI * turns * (barrelId + arborD)) / 2;
+
+  return {
+    thickness: Math.round(thickness * 1000) / 1000,
+    height: Math.round(height * 100) / 100,
+    length: Math.round(length * 10) / 10,
+    strengthIndex: getStrengthIndex(thickness),
+  };
+}