@jjlmoya/utils-chrono 1.2.0

package/src/tool/wrist-presence-calculator/i18n/zh.ts

@@ -0,0 +1,155 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { WristPresenceCalculatorUI } from '../entry';
+import { bibliography } from '../bibliography';
+
+export const content: ToolLocaleContent<WristPresenceCalculatorUI> = {
+  slug: 'wrist-presence-calculator',
+  title: '手表腕上存在感与尺寸计算器',
+  description: '计算表壳与手腕比例、平腕宽度覆盖率，根据美学指南确定最适合您手腕的理想手表尺寸。',
+  ui: {
+    title: '手腕尺寸设置',
+    wristCircumferenceLabel: '手腕周长',
+    caseDiameterLabel: '表壳直径',
+    lugToLugLabel: '表耳间距',
+    wristWidthLabel: '平腕宽度',
+    autoEstimateWidthLabel: '自动估算平腕宽度（30%）',
+    unitCm: '厘米',
+    unitInches: '英寸',
+    unitMm: '毫米',
+    fitAnalysisTitle: '佩戴贴合度评估',
+    caseWristRatioLabel: '表壳与手腕比例',
+    wristCoverageLabel: '手腕覆盖率',
+    verdictLabel: '结论',
+    verdictOversized: '过大',
+    verdictBold: '大胆 / 现代',
+    verdictGolden: '黄金 / 经典',
+    verdictVintage: '复古 / 偏小',
+    coverageSafe: '安全贴合',
+    coverageBold: '大胆贴合',
+    coverageOverhang: '表耳悬空警告',
+    sweetSpotTitle: '佩戴风格',
+    sweetSpotDesc: '最佳比例区间代表了最平衡的视觉效果。',
+    minClassicLabel: '复古 / 经典',
+    sweetSpotLabel: '美学最佳区间',
+    maxBoldLabel: '现代 / 大胆',
+    maxLugToLugLabel: '最大推荐表耳间距',
+    idealSizesTitle: '理想尺寸指南',
+    visualizerTitle: '实时佩戴模拟',
+    wristWidthHelp: '根据手腕形状估算。',
+    estimatedLabel: '估算值',
+    customLabel: '手腕',
+  },
+  seo: [
+    { type: 'title', text: '如何选择完美的手表尺寸：比例贴合指南', level: 2 },
+    { type: 'paragraph', html: '选择合适的手表尺寸是数学、几何与个人风格的结合。在钟表学中，时计在手臂上的呈现方式被称为<strong>腕上存在感</strong>。一块手表应当看起来平衡——既不会因难看的悬空而支配手腕，也不会像一个小点般消失。要实现这种平衡，手表藏家会分析三个主要指标：表壳直径、表耳间距和手腕形状。' },
+    { type: 'title', text: '理解表壳与手腕的比例', level: 3 },
+    { type: 'paragraph', html: '衡量手表比例的传统方法是表壳与手腕之比。将手腕周长转换为毫米后除以表壳直径，即可得到这个比例。比例在<strong>4.5 到 5.0</strong>之间是经典的最佳区间。比例从<strong>4.0 到 4.5</strong>营造出大胆、运动的现代感。比例高于5.0呈现复古正装表的美感，而低于4.0则被认为过大。' },
+    { type: 'title', text: '为什么表耳间距和平腕宽度决定了真正的贴合度', level: 3 },
+    { type: 'paragraph', html: '虽然表壳直径备受关注，但<strong>表耳间距</strong>（从上方表耳尖端到下方表耳尖端的垂直长度）才是贴合度的真正考验。手表尺寸的黄金法则是表耳间距不应超过手腕的平腕宽度。如果表耳延伸到手腕边缘之外，就会产生表耳悬空。这会导致手表滑动、表带与皮肤之间出现缝隙，以及视觉上的不协调。' },
+    { type: 'title', text: '扁平手腕 vs 圆形手腕：针对具体手型的尺寸选择', level: 3 },
+    { type: 'paragraph', html: '手腕周长只能说明部分问题。相同周长的手腕可能有不同的横截面形状：扁平或圆形。扁平手腕的上表面更宽，可以安全佩戴表耳间距更长的手表。圆形手腕更接近圆柱形，上表面较窄，需要更短的表耳间距以避免悬空。' },
+  ],
+  faq: [
+    {
+      question: '理想的表壳与手腕比例是多少？',
+      answer: '理想的表壳与手腕比例在4.0到5.0之间。用周长除以表壳直径，4.5是传统钟表学的最佳比例。4.0到4.5呈现现代、大胆的腕上存在感，高于5.0适合复古正装表，低于4.0则显得过大。',
+    },
+    {
+      question: '为什么表耳间距比表壳直径更重要？',
+      answer: '表壳直径只测量表盘的宽度，而表耳间距决定了手表在手腕上的总长度。如果表耳间距超过手腕的平腕宽度，表耳就会悬空，导致表带垂直下垂。这会让手表看起来不稳定且比例失调。',
+    },
+    {
+      question: '扁平手腕和圆形手腕对手表尺寸和贴合有什么影响？',
+      answer: '两个周长相同的手腕（例如17厘米）佩戴手表的效果可能截然不同。扁平手腕的上表面更宽，可以容纳更长表耳间距的手表而不产生悬空。圆形手腕的上表面较窄，需要更短的表耳间距才能稳定贴合。',
+    },
+    {
+      question: '厚度和表圈宽度如何改变手表的视觉大小？',
+      answer: '表圈极薄的手表（如正装表）表盘面积更大，看起来比实际直径更大。带有厚旋转表圈的潜水表表盘较小，显得更紧凑。同样，厚度超过13毫米的手表看起来更厚重，视觉重量也更大。',
+    },
+  ],
+  bibliography,
+  howTo: [
+    {
+      name: '测量手腕',
+      text: '用软尺环绕手腕骨骼一周，以厘米或英寸为单位测量周长。',
+    },
+    {
+      name: '输入手表尺寸',
+      text: '输入您要评估的手表的表壳直径和表耳间距。',
+    },
+    {
+      name: '分析贴合度与模拟',
+      text: '查看表壳与手腕比例、表耳悬空警告，并观察实时模拟图。',
+    },
+  ],
+  schemas: [
+    {
+      '@context': 'https://schema.org',
+      '@type': 'FAQPage',
+      'mainEntity': [
+        {
+          '@type': 'Question',
+          'name': '理想的表壳与手腕比例是多少？',
+          'acceptedAnswer': {
+            '@type': 'Answer',
+            'text': '理想的表壳与手腕比例在4.0到5.0之间。用周长除以表壳直径，4.5是传统钟表学的最佳比例。4.0到4.5呈现现代、大胆的腕上存在感，高于5.0适合复古正装表，低于4.0则显得过大。'
+          }
+        },
+        {
+          '@type': 'Question',
+          'name': '为什么表耳间距比表壳直径更重要？',
+          'acceptedAnswer': {
+            '@type': 'Answer',
+            'text': '表壳直径只测量表盘的宽度，而表耳间距决定了手表在手腕上的总长度。如果表耳间距超过手腕的平腕宽度，表耳就会悬空，导致表带垂直下垂。这会让手表看起来不稳定且比例失调。'
+          }
+        },
+        {
+          '@type': 'Question',
+          'name': '扁平手腕和圆形手腕对手表尺寸和贴合有什么影响？',
+          'acceptedAnswer': {
+            '@type': 'Answer',
+            'text': '两个周长相同的手腕（例如17厘米）佩戴手表的效果可能截然不同。扁平手腕的上表面更宽，可以容纳更长表耳间距的手表而不产生悬空。圆形手腕的上表面较窄，需要更短的表耳间距才能稳定贴合。'
+          }
+        },
+        {
+          '@type': 'Question',
+          'name': '厚度和表圈宽度如何改变手表的视觉大小？',
+          'acceptedAnswer': {
+            '@type': 'Answer',
+            'text': '表圈极薄的手表（如正装表）表盘面积更大，看起来比实际直径更大。带有厚旋转表圈的潜水表表盘较小，显得更紧凑。同样，厚度超过13毫米的手表看起来更厚重，视觉重量也更大。'
+          }
+        }
+      ]
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'SoftwareApplication',
+      'name': '手表腕上存在感与尺寸计算器',
+      'operatingSystem': 'All',
+      'applicationCategory': 'UtilitiesApplication',
+      'browserRequirements': 'Requires HTML5. Requires JavaScript.'
+    },
+    {
+      '@context': 'https://schema.org',
+      '@type': 'HowTo',
+      'name': '如何确定完美的腕表尺寸',
+      'step': [
+        {
+          '@type': 'HowToStep',
+          'name': '测量手腕',
+          'text': '用软尺环绕手腕骨骼一周，以厘米或英寸为单位测量周长。'
+        },
+        {
+          '@type': 'HowToStep',
+          'name': '输入手表尺寸',
+          'text': '输入您要评估的手表的表壳直径和表耳间距。'
+        },
+        {
+          '@type': 'HowToStep',
+          'name': '分析贴合度与模拟',
+          'text': '查看表壳与手腕比例、表耳悬空警告，并观察实时模拟图。'
+        }
+      ]
+    }
+  ]
+};

package/src/tool/wrist-presence-calculator/index.ts

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

package/src/tool/wrist-presence-calculator/seo.astro

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

package/src/tool/wrist-presence-calculator/utils.ts

@@ -0,0 +1,30 @@
+export function calculateCaseToWristRatio(circumference: number, caseDiameter: number): number {
+  if (!caseDiameter) return 0;
+  return circumference / caseDiameter;
+}
+
+export function estimateWristWidth(circumference: number): number {
+  return circumference * 0.3;
+}
+
+export function getIdealCaseRange(circumference: number) {
+  return {
+    min: circumference / 5.0,
+    sweetSpot: circumference / 4.5,
+    max: circumference / 4.0,
+    maxLugToLug: estimateWristWidth(circumference)
+  };
+}
+
+export function getRatioClass(ratio: number): string {
+  if (ratio < 4.0) return 'verdict-oversized';
+  if (ratio >= 4.0 && ratio < 4.5) return 'verdict-bold';
+  if (ratio >= 4.5 && ratio <= 5.0) return 'verdict-golden';
+  return 'verdict-vintage';
+}
+
+export function getCoverageClass(coverage: number): string {
+  if (coverage < 80) return 'coverage-safe';
+  if (coverage >= 80 && coverage <= 100) return 'coverage-bold';
+  return 'coverage-overhang';
+}

package/src/tool/wrist-presence-calculator/wrist-presence-calculator.css

@@ -0,0 +1,372 @@
+.tool-main-card {
+  background: var(--bg-surface);
+  border: 1px solid var(--border-color);
+  border-radius: 1rem;
+  padding: 2rem;
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+  box-shadow: var(--shadow-base);
+
+  --color-white: #fff;
+  --visualizer-wrist-fill: rgba(255, 255, 255, 0.05);
+  --visualizer-wrist-stroke: rgba(255, 255, 255, 0.15);
+  --visualizer-outer-circle: rgba(255, 255, 255, 0.03);
+  --visualizer-outer-stroke: rgba(255, 255, 255, 0.08);
+  --visualizer-watch-face: rgba(25, 25, 35, 0.95);
+  --visualizer-watch-inner: rgba(255, 255, 255, 0.08);
+  --visualizer-watch-hands: rgba(255, 255, 255, 0.35);
+  --visualizer-dim-line: rgba(255, 255, 255, 0.2);
+  --visualizer-dim-text: rgba(255, 255, 255, 0.6);
+  --color-fit-golden: #10b981;
+  --color-fit-golden-bg: rgba(16, 185, 129, 0.1);
+  --color-fit-golden-border: rgba(16, 185, 129, 0.25);
+  --color-fit-bold: #3b82f6;
+  --color-fit-bold-bg: rgba(59, 130, 246, 0.1);
+  --color-fit-bold-border: rgba(59, 130, 246, 0.25);
+  --color-fit-oversized: #ef4444;
+  --color-fit-oversized-bg: rgba(239, 68, 68, 0.1);
+  --color-fit-oversized-border: rgba(239, 68, 68, 0.25);
+  --color-fit-vintage: #f59e0b;
+  --color-fit-vintage-bg: rgba(245, 158, 11, 0.1);
+  --color-fit-vintage-border: rgba(245, 158, 11, 0.25);
+}
+
+.theme-light .tool-main-card {
+  --visualizer-wrist-fill: rgba(0, 0, 0, 0.04);
+  --visualizer-wrist-stroke: rgba(0, 0, 0, 0.12);
+  --visualizer-outer-circle: rgba(0, 0, 0, 0.02);
+  --visualizer-outer-stroke: rgba(0, 0, 0, 0.06);
+  --visualizer-watch-face: rgba(255, 255, 255, 0.95);
+  --visualizer-watch-inner: rgba(0, 0, 0, 0.04);
+  --visualizer-watch-hands: rgba(0, 0, 0, 0.6);
+  --visualizer-dim-line: rgba(0, 0, 0, 0.25);
+  --visualizer-dim-text: rgba(0, 0, 0, 0.75);
+  --color-fit-golden: #047857;
+  --color-fit-golden-bg: rgba(16, 185, 129, 0.08);
+  --color-fit-golden-border: rgba(16, 185, 129, 0.2);
+  --color-fit-bold: #1d4ed8;
+  --color-fit-bold-bg: rgba(59, 130, 246, 0.08);
+  --color-fit-bold-border: rgba(59, 130, 246, 0.2);
+  --color-fit-oversized: #b91c1c;
+  --color-fit-oversized-bg: rgba(239, 68, 68, 0.08);
+  --color-fit-oversized-border: rgba(239, 68, 68, 0.2);
+  --color-fit-vintage: #b45309;
+  --color-fit-vintage-bg: rgba(245, 158, 11, 0.08);
+  --color-fit-vintage-border: rgba(245, 158, 11, 0.2);
+}
+
+.wrist-calculator-layout {
+  display: grid;
+  grid-template-columns: 1.1fr 0.9fr;
+  gap: 2.5rem;
+}
+
+@media (max-width: 992px) {
+  .wrist-calculator-layout {
+    grid-template-columns: 1fr;
+    gap: 2rem;
+  }
+}
+
+.calc-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.inputs-section,
+.visualizer-section,
+.results-section,
+.recommendations-section {
+  display: flex;
+  flex-direction: column;
+  background: transparent;
+  border: none;
+  border-radius: 0;
+  padding: 0;
+  margin-bottom: 0;
+}
+
+.results-wrapper {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.section-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-bottom: 1px solid var(--border-color);
+  padding-bottom: 0.5rem;
+  margin-bottom: 1.25rem;
+}
+
+.section-header h3 {
+  font-size: 1.05rem;
+  font-weight: 700;
+  margin: 0;
+  color: var(--text-base);
+}
+
+.input-group {
+  margin-bottom: 1.25rem;
+}
+
+.input-group:last-child {
+  margin-bottom: 0;
+}
+
+.input-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 0.5rem;
+}
+
+.input-label {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--text-muted);
+}
+
+.value-display {
+  font-size: 0.9rem;
+  font-weight: 700;
+  color: var(--accent);
+  background: rgba(244, 63, 94, 0.08);
+  padding: 0.15rem 0.45rem;
+  border-radius: 0.3rem;
+}
+
+.slider-control {
+  width: 100%;
+  height: 6px;
+  border-radius: 3px;
+  background: var(--border-color);
+  outline: none;
+  -webkit-appearance: none;
+  appearance: none;
+}
+
+.slider-control::-webkit-slider-thumb {
+  -webkit-appearance: none;
+  appearance: none;
+  width: 16px;
+  height: 16px;
+  border-radius: 50%;
+  background: var(--accent);
+  cursor: pointer;
+  transition: transform 0.1s ease;
+}
+
+.slider-control::-webkit-slider-thumb:hover {
+  transform: scale(1.2);
+}
+
+.toggle-container {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.checkbox-control {
+  width: 15px;
+  height: 15px;
+  accent-color: var(--accent);
+  cursor: pointer;
+}
+
+.toggle-label {
+  font-size: 0.8rem;
+  color: var(--text-muted);
+  cursor: pointer;
+  user-select: none;
+}
+
+.unit-selector {
+  display: flex;
+  background: var(--bg-muted);
+  border: 1px solid var(--border-color);
+  border-radius: 0.4rem;
+  padding: 0.1rem;
+}
+
+.unit-btn {
+  background: transparent;
+  border: none;
+  color: var(--text-muted);
+  font-size: 0.7rem;
+  font-weight: 700;
+  padding: 0.2rem 0.5rem;
+  border-radius: 0.25rem;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.unit-btn.active {
+  background: var(--accent);
+  color: var(--color-white);
+}
+
+.canvas-wrapper {
+  position: relative;
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  background: var(--bg-muted);
+  border-radius: 0.5rem;
+  overflow: hidden;
+  border: 1px solid var(--border-color);
+}
+
+.fit-canvas {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
+.metrics-summary-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+}
+
+@media (max-width: 576px) {
+  .metrics-summary-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+.metric-box {
+  background: var(--bg-muted);
+  border: 1px solid var(--border-color);
+  border-radius: 0.5rem;
+  padding: 1rem;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  text-align: center;
+}
+
+.metric-val {
+  font-size: 1.5rem;
+  font-weight: 800;
+  color: var(--text-base);
+  margin-bottom: 0.2rem;
+  letter-spacing: -0.010em;
+}
+
+.metric-lbl {
+  font-size: 0.75rem;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  margin-bottom: 0.5rem;
+}
+
+.verdict-badge {
+  font-size: 0.75rem;
+  font-weight: 700;
+  padding: 0.25rem 0.65rem;
+  border-radius: 99px;
+  display: inline-block;
+}
+
+.verdict-golden {
+  color: var(--color-fit-golden);
+  background: var(--color-fit-golden-bg);
+  border: 1px solid var(--color-fit-golden-border);
+}
+
+.verdict-bold {
+  color: var(--color-fit-bold);
+  background: var(--color-fit-bold-bg);
+  border: 1px solid var(--color-fit-bold-border);
+}
+
+.verdict-oversized {
+  color: var(--color-fit-oversized);
+  background: var(--color-fit-oversized-bg);
+  border: 1px solid var(--color-fit-oversized-border);
+}
+
+.verdict-vintage {
+  color: var(--color-fit-vintage);
+  background: var(--color-fit-vintage-bg);
+  border: 1px solid var(--color-fit-vintage-border);
+}
+
+.coverage-safe {
+  color: var(--color-fit-golden);
+  background: var(--color-fit-golden-bg);
+  border: 1px solid var(--color-fit-golden-border);
+}
+
+.coverage-bold {
+  color: var(--color-fit-vintage);
+  background: var(--color-fit-vintage-bg);
+  border: 1px solid var(--color-fit-vintage-border);
+}
+
+.coverage-overhang {
+  color: var(--color-fit-oversized);
+  background: var(--color-fit-oversized-bg);
+  border: 1px solid var(--color-fit-oversized-border);
+}
+
+.verdict-box {
+  margin-top: 1rem;
+  padding: 0.85rem;
+  border-radius: 0.5rem;
+  background: var(--bg-muted);
+  border: 1px solid var(--border-color);
+  font-size: 0.85rem;
+  line-height: 1.4;
+  color: var(--text-muted);
+}
+
+.verdict-box strong {
+  color: var(--text-base);
+}
+
+.recommendations-table-wrapper {
+  overflow-x: auto;
+}
+
+.recommendations-table {
+  width: 100%;
+  border-collapse: collapse;
+  text-align: left;
+}
+
+.recommendations-table th {
+  font-size: 0.75rem;
+  font-weight: 700;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  padding: 0.5rem 0.75rem;
+  background: var(--bg-muted);
+  border-bottom: 1px solid var(--border-color);
+}
+
+.recommendations-table td {
+  font-size: 0.85rem;
+  padding: 0.75rem;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.recommendations-table tr:last-child td {
+  border-bottom: none;
+}
+
+.rec-value {
+  font-weight: 700;
+  color: var(--accent);
+}
+
+.rec-target {
+  font-weight: 600;
+  color: var(--text-base);
+}

package/src/tools.ts

@@ -0,0 +1,26 @@
+export { ALL_ENTRIES } from './entries';
+import type { ToolDefinition } from './types';
+import { WATCH_ACCURACY_TRACKER_TOOL } from './tool/watch-accuracy-tracker';
+import { WRIST_PRESENCE_CALCULATOR_TOOL } from './tool/wrist-presence-calculator';
+import { DEMAGNETIZING_TIMER_TOOL } from './tool/demagnetizing-timer';
+import { WATCH_SAVINGS_PLANNER_TOOL } from './tool/watch-savings-planner';
+import { CROWN_REFERENCE_GUIDE_TOOL } from './tool/crown-reference-guide';
+import { POWER_RESERVE_ESTIMATOR_TOOL } from './tool/power-reserve-estimator';
+import { BEAT_RATE_CONVERTER_TOOL } from './tool/beat-rate-converter';
+import { WATER_RESISTANCE_CONVERTER_TOOL } from './tool/water-resistance-converter';
+import { STRAP_TAPER_CALCULATOR_TOOL } from './tool/strap-taper-calculator';
+
+export const ALL_TOOLS: ToolDefinition[] = [
+  WATCH_ACCURACY_TRACKER_TOOL,
+  WRIST_PRESENCE_CALCULATOR_TOOL,
+  DEMAGNETIZING_TIMER_TOOL,
+  WATCH_SAVINGS_PLANNER_TOOL,
+  CROWN_REFERENCE_GUIDE_TOOL,
+  POWER_RESERVE_ESTIMATOR_TOOL,
+  BEAT_RATE_CONVERTER_TOOL,
+  WATER_RESISTANCE_CONVERTER_TOOL,
+  STRAP_TAPER_CALCULATOR_TOOL,
+];
+
+
+

package/src/types.ts

@@ -0,0 +1,70 @@
+import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { WithContext, Thing } from 'schema-dts';
+
+export type { SEOSection };
+
+export type KnownLocale =
+  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
+  | 'fr' | 'id' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+
+export interface FAQItem {
+  question: string;
+  answer: string;
+}
+
+export interface BibliographyEntry {
+  name: string;
+  url: string;
+}
+
+export interface HowToStep {
+  name: string;
+  text: string;
+}
+
+export interface ToolLocaleContent<TUI extends Record<string, string> = Record<string, string>> {
+  slug: string;
+  title: string;
+  description: string;
+  ui: TUI;
+  seo: SEOSection[];
+  faq: FAQItem[];
+  bibliography: BibliographyEntry[];
+  howTo: HowToStep[];
+  schemas: WithContext<Thing>[];
+}
+
+export interface CategoryLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  seo: SEOSection[];
+}
+
+export type LocaleLoader<T> = () => Promise<T>;
+
+export type LocaleMap<T> = Partial<Record<KnownLocale, LocaleLoader<T>>>;
+
+export interface ChronoToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface ChronoCategoryEntry {
+  icon: string;
+  tools: ChronoToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: ChronoToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+