@jjlmoya/utils-chrono 1.18.0 → 1.20.0

package/src/tool/altitude-watch-accuracy-estimator/i18n/zh.ts

@@ -0,0 +1,101 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { AltitudeWatchAccuracyEstimatorUI } from '../entry';
+import { bibliography } from '../bibliography';
+import { buildSchemas } from '../helpers';
+
+const faq = [
+  {
+    question: '为什么机械表在高海拔地区走得更快？',
+    answer: '机械表在高海拔地区走得更快的主要原因是空气密度降低。较稀薄的空气对摆轮产生的空气阻力更小，使其能够以稍大的振幅摆动。这种增加的振幅会导致手表走快 - 通常每升高1,000米，每天快2-6秒，具体取决于机芯设计。',
+  },
+  {
+    question: '海拔高度也会影响石英表吗？',
+    answer: '石英表由于没有摆动的机械摆轮，受海拔影响极小。然而，极端海拔变化可能因温度变化影响电池性能。与机械表相比，这种影响可以忽略不计。',
+  },
+  {
+    question: '海拔变化会损坏我的手表吗？',
+    answer: '单纯的海拔变化很少损坏机械表。但是，快速减压（如在飞机上）可能会导致某些手表的防水出现问题。旅行中的正常海拔变化完全在任何手表的设计公差范围内。',
+  },
+];
+
+const howTo = [
+  {
+    name: '选择海拔高度',
+    text: '上下拖动海拔滑块，模拟从海平面到8,000米的不同海拔高度。观察摆轮摆动和大气数据如何实时变化。',
+  },
+  {
+    name: '读取偏差',
+    text: '速率偏差显示区显示选定海拔高度下每天估计的快慢秒数。下方的偏差图表显示所有海拔高度的趋势。',
+  },
+  {
+    name: '考虑影响因素',
+    text: '观察空气密度如何随海拔升高而降低，同时速率偏差如何增加。温度和压力数据为环境变化提供了背景信息。',
+  },
+];
+
+const title = '海拔精度估算器：海拔高度对机械表的影响';
+
+export const content: ToolLocaleContent<AltitudeWatchAccuracyEstimatorUI> = {
+  slug: 'altitude-watch-accuracy-estimator',
+  title,
+  description: '探索海拔高度如何影响机械表的精度。从海平面到山顶调节海拔高度，实时查看摆轮摆动、速率偏差、空气密度、压力和温度的变化。',
+  ui: {
+    title: '海拔精度估算器',
+    altitudeLabel: '海拔',
+    altitudeUnit: '米',
+    seaLevel: '海平面',
+    deviationLabel: '速率偏差',
+    deviationUnit: '秒/天',
+    pressureLabel: '气压',
+    pressureUnit: 'hPa',
+    densityLabel: '空气密度',
+    densityUnit: 'kg/m³',
+    temperatureLabel: '温度',
+    temperatureUnit: '°C',
+    oscillationLabel: '摆轮',
+    oscillationsPerSec: '次/秒',
+    rateLabel: '速率',
+    atmDataTitle: '大气条件',
+    howItWorks: '工作原理',
+    howItWorksDesc: '高海拔地区较低的空气密度减少了摆轮的阻力，增加了摆动幅度，导致手表走快。此工具基于标准大气模型估算速率偏差。',
+    negligible: '可忽略',
+    minor: '轻微',
+    noticeable: '明显',
+    significant: '显著',
+    severe: '严重',
+    step1: '拖动滑块模拟从海平面到8,000米的海拔高度。',
+    step2: '观察摆轮动画和偏差指示器的实时响应。',
+    step3: '查看大气数据以了解环境因素的影响。',
+    tipTitle: '提示',
+    tipContent: '效果因机芯而异：高振频机芯（36,000次/小时）通常比 vintage 低振频机芯（18,000次/小时）受影响更小。',
+    deviationChart: '偏差 vs 海拔',
+    altitudeM: '海拔（米）',
+    secondsPerDay: '秒/天',
+    particleLabel: '空气分子',
+    airDensity: '空气密度',
+  },
+  seo: [
+    { type: 'title', text: '机械表交互式海拔精度估算工具', level: 2 },
+    { type: 'paragraph', html: '<strong>海拔精度估算器</strong>是一个交互式工具，可可视化海拔变化如何影响机械表的精度。通过模拟从海平面到8,000米的海拔高度，您可以查看由空气密度、压力和温度变化引起的估计速率偏差。' },
+    { type: 'title', text: '海拔如何影响手表精度', level: 3 },
+    { type: 'paragraph', html: '在较高海拔高度，<strong>空气密度降低</strong>，从而减少摆轮的空气阻力。这使得摆轮能够以更大的振幅摆动，导致手表略微走快。效果通常为每升高1,000米<strong>每天快2-6秒</strong>。' },
+    { type: 'title', text: '不同海拔高度的速率偏差', level: 3 },
+    {
+      type: 'table', headers: ['海拔', '空气密度', '气压', '温度', '估计偏差'], rows: [
+        ['海平面（0米）', '1.225 kg/m³', '1013 hPa', '15°C', '基准'],
+        ['1,000米', '1.112 kg/m³', '898 hPa', '8.5°C', '+0.4 秒/天'],
+        ['2,000米', '1.007 kg/m³', '795 hPa', '2°C', '+0.9 秒/天'],
+        ['3,000米', '0.909 kg/m³', '701 hPa', '-4.5°C', '+1.5 秒/天'],
+        ['4,000米', '0.819 kg/m³', '616 hPa', '-11°C', '+2.1 秒/天'],
+        ['5,000米', '0.736 kg/m³', '540 hPa', '-17.5°C', '+2.8 秒/天'],
+      ]
+    },
+    { type: 'title', text: '环境因素', level: 3 },
+    { type: 'paragraph', html: '除了空气密度，高海拔地区的其他环境因素也会影响手表性能：<strong>温度</strong>影响润滑油粘度和发条弹性，<strong>压力变化</strong>可能影响表壳密封。然而，空气密度对摆轮阻力的影响是与海拔相关的速率变化的主导因素。' },
+    { type: 'diagnostic', variant: 'info', title: '交互式模拟工具', icon: 'mdi:axis-arrow', badge: '钟表学', html: '此工具基于国际标准大气（ISA）模型和经验观测提供估计值。实际结果因机芯型号、状况和制造公差而异。' },
+  ],
+  faq,
+  bibliography,
+  howTo,
+  schemas: buildSchemas(title, faq, howTo),
+};

package/src/tool/altitude-watch-accuracy-estimator/index.ts

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

package/src/tool/altitude-watch-accuracy-estimator/logic.ts

@@ -0,0 +1,61 @@
+export interface AtmosphericData {
+  altitude: number;
+  pressure: number;
+  density: number;
+  temperature: number;
+  deviation: number;
+  deviationDesc: string;
+}
+
+const SEA_LEVEL_PRESSURE = 1013.25;
+const SEA_LEVEL_TEMP_K = 288.15;
+const SEA_LEVEL_TEMP_C = 15;
+const LAPSE_RATE = 0.0065;
+const DEVIATION_FACTOR = 4.2;
+
+export function getTemperature(altitude: number): number {
+  return SEA_LEVEL_TEMP_C - LAPSE_RATE * altitude;
+}
+
+export function getPressure(altitude: number): number {
+  const tRatio = 1 - LAPSE_RATE * altitude / SEA_LEVEL_TEMP_K;
+  if (tRatio <= 0) return 0;
+  return SEA_LEVEL_PRESSURE * Math.pow(tRatio, 5.255);
+}
+
+export function getAirDensity(altitude: number): number {
+  const T = getTemperature(altitude) + 273.15;
+  const P = getPressure(altitude) * 100;
+  return P / (287.058 * T);
+}
+
+export function getRateDeviation(altitude: number): number {
+  const rho0 = getAirDensity(0);
+  const rhoH = getAirDensity(altitude);
+  return DEVIATION_FACTOR * (rho0 / rhoH - 1);
+}
+
+export function getDeviationDescription(deviation: number): string {
+  if (deviation < 0.5) return 'negligible';
+  if (deviation < 2) return 'minor';
+  if (deviation < 5) return 'noticeable';
+  if (deviation < 10) return 'significant';
+  return 'severe';
+}
+
+export function getAtmosphericData(altitude: number): AtmosphericData {
+  const deviation = getRateDeviation(altitude);
+  return {
+    altitude,
+    pressure: Math.round(getPressure(altitude) * 10) / 10,
+    density: Math.round(getAirDensity(altitude) * 1000) / 1000,
+    temperature: Math.round(getTemperature(altitude) * 10) / 10,
+    deviation: Math.round(deviation * 10) / 10,
+    deviationDesc: getDeviationDescription(deviation),
+  };
+}
+
+export const DEVIATION_CHART_POINTS = Array.from({ length: 81 }, (_, i) => {
+  const alt = i * 100;
+  return { altitude: alt, deviation: Math.round(getRateDeviation(alt) * 10) / 10 };
+});

package/src/tool/altitude-watch-accuracy-estimator/seo.astro

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

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),
+  };
+}