@jjlmoya/utils-diy 1.11.0 → 1.13.0

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

@@ -0,0 +1,147 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { WorkshopFractionConverterUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'workshop-fraction-converter';
+const title = '车间分数转公制转换器';
+const description = '瞬间将分数英寸转换为毫米。为您的车间寻找最接近的标准螺栓、螺钉和套筒。专为沾满油污的手和戴手套的手指设计。';
+
+const faqData = [
+  {
+    question: '为什么我需要将分数转换为毫米？',
+    answer: '大多数现代工具和紧固件使用公制，但许多老式工具和规格仍在使用分数英寸。此转换器弥合了这一差距，帮助您找到精确的公制对应值或最接近的标准紧固件尺寸。',
+  },
+  {
+    question: '1/2 英寸和 12.7 毫米有什么区别？',
+    answer: '1/2 英寸正好等于 12.7 毫米 (0.5 × 25.4 = 12.7)。在标准尺寸下，由于制造商在两个系统中统一了常见的紧固件尺寸，公制和英制工具通常可以互换使用。',
+  },
+  {
+    question: '为什么工具显示“最接近的紧固件”？',
+    answer: '因为精确转换的结果通常介于标准紧固件尺寸之间。该工具会找到与您的测量值最接近的市售螺栓或套筒，以便您可以使用车间中的现有材料。',
+  },
+  {
+    question: '木工精度和金属精度有什么区别？',
+    answer: '在木工中，0.5 毫米的差异通常可以忽略不计。在金属加工和机械加工中，0.1 毫米至关重要。精度模式会提示适合您材料的容差范围。',
+  },
+  {
+    question: '我可以离线使用这个工具吗？',
+    answer: '可以。所有计算都在您的浏览器中进行。初次加载后，该工具可完全离线运行，非常适合在没有 WiFi 的车间使用。',
+  },
+  {
+    question: '为什么工具包含历史记录？',
+    answer: '在拆卸或处理包含多个零件的项目时，历史记录让您可以查阅测量值而无需重新输入，并帮助您在工作时建立零件清单。',
+  },
+];
+
+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<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step, i) => ({
+    '@type': 'HowToStep',
+    position: i + 1,
+    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<WorkshopFractionConverterUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: '常见问题',
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: '为什么车间中的精密分数转换至关重要', level: 2 },
+    { type: 'paragraph', html: '在专业或高要求的 DIY 车间中，“大约”的测量值往往会导致螺栓滑丝、接头松动或组装失败。本工具旨在弥补传统英制测量与公制系统精度之间的差距，确保您的车间项目保持专业级标准。' },
+    { type: 'title', text: '标准转换：1/2" 与 12.7mm 的对比', level: 3 },
+    { type: 'card', icon: 'mdi:ruler-square', title: '公制和英制系统可以互换吗？', html: '<p>许多人认为可以。虽然 1/2" 恰好是 12.7mm，但最接近的标准公制套筒是 13mm。使用错误的工具可能会磨圆螺栓头。我们的转换器会识别<strong>最接近的标准工具匹配</strong>，确保您永远不会损坏硬件。</p>' },
+    { type: 'title', text: '木工与金属加工的公差', level: 3 },
+    { type: 'paragraph', html: '公差要求因行业而异。在<strong>木工</strong>中，1/64" (0.4mm) 的公差通常是可以接受的。在<strong>金属加工和机械加工</strong>中，0.1mm 甚至 0.01mm 都至关重要。我们的工具包含精度模式，帮助您决定哪种标准紧固件最适合您的特定材料。' },
+    { type: 'title', text: '准确测量的 3 个基本技巧', level: 3 },
+    { type: 'paragraph', html: '<strong>1. 使用卡尺：</strong> 进行反向查询时，务必使用数显卡尺以获得最准确的毫米输入。<strong>2. 检查磨损：</strong> 旧套筒和螺栓的边缘可能已经磨损，这使得“最接近匹配”变得更加关键。<strong>3. 核对螺距：</strong> 请记住，即使头部尺寸匹配，螺距（公制与英制）也总是不同的。' },
+  ],
+  ui: {
+    labelFraction: '测量类型',
+    labelWhole: '整数',
+    labelNumerator: '分子',
+    labelDenominator: '分母',
+    labelInches: '英寸',
+    labelMillimeters: '毫米',
+    resultTitle: '转换结果',
+    resultFraction: '分数',
+    resultInches: '英寸',
+    resultMillimeters: '毫米',
+    matchTitle: '最接近的标准规格',
+    matchClosestFastener: '标准螺栓或紧固件尺寸',
+    matchClosestSocket: '标准套筒或扳手尺寸',
+    matchDifference: '与测量值的差异',
+    matchRecommendation: '如果有，请使用此尺寸',
+    reverseSearchTitle: '反向搜索',
+    reverseSearchLabel: '测量尺寸 (毫米)',
+    reverseSearchButton: '寻找分数',
+    reverseSearchHint: '用卡尺测量并输入数值',
+    unitMm: '毫米',
+    unitInch: '英寸',
+    modeForward: '分数 → 公制',
+    modeReverse: '公制 → 分数',
+    precisionLabel: '精度模式',
+    precisionCarpentry: '木工',
+    precisionMetal: '金属加工',
+    buttonConvert: '转换',
+    buttonClear: '清除',
+    buttonCopyResult: '复制结果',
+    buttonSaveToHistory: '保存到历史记录',
+    historyTitle: '历史记录',
+    historyEmpty: '尚无测量记录',
+    historyRemove: '移除',
+    helpText: '选择测量值或输入分数以开始。',
+    toolOverline: '车间工具',
+    labelVisualReference: '视觉参考 (1 英寸 = 96 像素)',
+  },
+};

package/src/tool/workshopFractionConverter/index.ts

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

package/src/tool/workshopFractionConverter/seo.astro

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

package/src/tool/workshopFractionConverter/types-client.ts

@@ -0,0 +1,89 @@
+export interface Fraction {
+  whole: number;
+  numerator: number;
+  denominator: number;
+}
+
+export interface ConversionResult {
+  fraction: Fraction;
+  inches: number;
+  millimeters: number;
+  closestFastener: Match | null;
+  closestSocket: Match | null;
+}
+
+export interface Match {
+  name: string;
+  size_mm: number;
+  size_inch: string;
+  difference_mm: number;
+  difference_pct: number;
+}
+
+export interface ReverseSearchResult {
+  input_mm: number;
+  closest_fraction: Fraction;
+  inches: number;
+  closestFastener: Match | null;
+  closestSocket: Match | null;
+}
+
+export interface HistoryEntry {
+  fraction: string;
+  mm: string;
+  time: number;
+}
+
+export const STANDARD_FASTENERS = [
+  { name: '#0', inch: '1/80', mm: 0.318 },
+  { name: '#1', inch: '1/73', mm: 0.346 },
+  { name: '#2', inch: '3/32', mm: 2.362 },
+  { name: '#3', inch: '7/64', mm: 2.778 },
+  { name: '#4', inch: '7/64', mm: 2.819 },
+  { name: '#5', inch: '1/8', mm: 3.175 },
+  { name: '#6', inch: '9/64', mm: 3.556 },
+  { name: '#8', inch: '5/32', mm: 4.191 },
+  { name: '#10', inch: '3/16', mm: 4.826 },
+  { name: '#12', inch: '7/32', mm: 5.461 },
+  { name: '1/4"', inch: '1/4', mm: 6.35 },
+  { name: '5/16"', inch: '5/16', mm: 7.938 },
+  { name: '3/8"', inch: '3/8', mm: 9.525 },
+  { name: '7/16"', inch: '7/16', mm: 11.113 },
+  { name: '1/2"', inch: '1/2', mm: 12.7 },
+  { name: '9/16"', inch: '9/16', mm: 14.288 },
+  { name: '5/8"', inch: '5/8', mm: 15.875 },
+  { name: '3/4"', inch: '3/4', mm: 19.05 },
+  { name: '7/8"', inch: '7/8', mm: 22.225 },
+  { name: '1"', inch: '1', mm: 25.4 },
+];
+
+export const STANDARD_SOCKETS = [
+  { name: '4mm', mm: 4.0, inch: '5/32' },
+  { name: '4.5mm', mm: 4.5, inch: '3/16' },
+  { name: '5mm', mm: 5.0, inch: '13/64' },
+  { name: '5.5mm', mm: 5.5, inch: '7/32' },
+  { name: '6mm', mm: 6.0, inch: '15/64' },
+  { name: '7mm', mm: 7.0, inch: '9/32' },
+  { name: '8mm', mm: 8.0, inch: '5/16' },
+  { name: '9mm', mm: 9.0, inch: '23/64' },
+  { name: '10mm', mm: 10.0, inch: '3/8' },
+  { name: '11mm', mm: 11.0, inch: '7/16' },
+  { name: '12mm', mm: 12.0, inch: '15/32' },
+  { name: '13mm', mm: 13.0, inch: '1/2' },
+  { name: '14mm', mm: 14.0, inch: '9/16' },
+  { name: '15mm', mm: 15.0, inch: '19/32' },
+  { name: '16mm', mm: 16.0, inch: '5/8' },
+  { name: '17mm', mm: 17.0, inch: '11/16' },
+  { name: '18mm', mm: 18.0, inch: '23/32' },
+  { name: '19mm', mm: 19.0, inch: '3/4' },
+  { name: '20mm', mm: 20.0, inch: '13/16' },
+  { name: '1/4" socket', mm: 6.35, inch: '1/4' },
+  { name: '5/16" socket', mm: 7.938, inch: '5/16' },
+  { name: '3/8" socket', mm: 9.525, inch: '3/8' },
+  { name: '7/16" socket', mm: 11.113, inch: '7/16' },
+  { name: '1/2" socket', mm: 12.7, inch: '1/2' },
+  { name: '9/16" socket', mm: 14.288, inch: '9/16' },
+  { name: '5/8" socket', mm: 15.875, inch: '5/8' },
+  { name: '11/16" socket', mm: 17.463, inch: '11/16' },
+  { name: '3/4" socket', mm: 19.05, inch: '3/4' },
+];

package/src/tool/workshopFractionConverter/ui-updater.ts

@@ -0,0 +1,94 @@
+import type { ConversionResult, Match, ReverseSearchResult } from './types-client';
+import { formatFraction } from './converter';
+
+function getDecimals(precision: string) {
+  return precision === 'metal' ? 3 : 1;
+}
+
+function updateResultDisplay(fractionStr: string, inchesStr: string, mmStr: string) {
+  const fractionEl = document.getElementById('wfc-result-fraction');
+  if (fractionEl) fractionEl.textContent = fractionStr;
+  const inchesEl = document.getElementById('wfc-result-inches');
+  if (inchesEl) inchesEl.textContent = inchesStr;
+  const mmEl = document.getElementById('wfc-result-mm');
+  if (mmEl) mmEl.textContent = mmStr;
+}
+
+export function displayResult(result: ConversionResult, precision = 'carpentry', ui: Record<string, string> = {}) {
+  document.getElementById('wfc-no-result')?.classList.add('wfc-hidden');
+  document.getElementById('wfc-result-content')?.classList.remove('wfc-hidden');
+  const decimals = getDecimals(precision);
+  const fractionStr = formatFraction(result.fraction);
+  const inchesStr = result.inches.toFixed(decimals) + '"';
+  const mmStr = result.millimeters.toFixed(decimals) + ' mm';
+  updateResultDisplay(fractionStr, inchesStr, mmStr);
+  updateVisualScale(result.millimeters);
+  if (result.closestFastener) updateFastenerMatch(result.closestFastener, ui);
+  if (result.closestSocket) updateSocketMatch(result.closestSocket, ui);
+}
+
+export function displayReverseResult(result: ReverseSearchResult, precision = 'carpentry', ui: Record<string, string> = {}) {
+  document.getElementById('wfc-no-result')?.classList.add('wfc-hidden');
+  document.getElementById('wfc-result-content')?.classList.remove('wfc-hidden');
+  const decimals = getDecimals(precision);
+  const fractionStr = formatFraction(result.closest_fraction);
+  const inchesStr = result.inches.toFixed(decimals) + '"';
+  const mmStr = result.input_mm.toFixed(decimals) + ' mm';
+  updateResultDisplay(fractionStr, inchesStr, mmStr);
+  updateVisualScale(result.input_mm);
+  if (result.closestFastener) updateFastenerMatch(result.closestFastener, ui);
+  if (result.closestSocket) updateSocketMatch(result.closestSocket, ui);
+}
+
+function updateVisualScale(mm: number) {
+  const inchPx = 96;
+  const inches = mm / 25.4;
+  const width = inches * inchPx;
+  const indicator = document.getElementById('wfc-scale-indicator');
+  if (indicator) {
+    indicator.style.width = Math.min(width, 240) + 'px';
+  }
+  const scaleText = document.getElementById('wfc-scale-text');
+  if (scaleText) {
+    scaleText.textContent = mm.toFixed(2) + ' mm (' + inches.toFixed(2) + '")';
+  }
+}
+
+function updateFastenerMatch(match: Match, ui: Record<string, string>) {
+  const pct = Math.abs(match.difference_pct).toFixed(1);
+  const badge = document.getElementById('wfc-fastener-badge');
+  const badgeClass = getBadgeClass(pct);
+  if (badge) {
+    badge.className = 'wfc-match-badge ' + badgeClass;
+    badge.textContent = pct + '%';
+  }
+  const nameEl = document.getElementById('wfc-fastener-name');
+  if (nameEl) nameEl.textContent = match.name;
+  const detailsEl = document.getElementById('wfc-fastener-details');
+  if (detailsEl) {
+    detailsEl.innerHTML = `<strong>${match.size_mm.toFixed(2)} mm</strong> (${match.size_inch})<br/>${ui.matchDifference || 'Difference'}: ${match.difference_mm.toFixed(2)} mm`;
+  }
+}
+
+function updateSocketMatch(match: Match, ui: Record<string, string>) {
+  const pct = Math.abs(match.difference_pct).toFixed(1);
+  const badge = document.getElementById('wfc-socket-badge');
+  const badgeClass = getBadgeClass(pct);
+  if (badge) {
+    badge.className = 'wfc-match-badge ' + badgeClass;
+    badge.textContent = pct + '%';
+  }
+  const nameEl = document.getElementById('wfc-socket-name');
+  if (nameEl) nameEl.textContent = match.name;
+  const detailsEl = document.getElementById('wfc-socket-details');
+  if (detailsEl) {
+    detailsEl.innerHTML = `<strong>${match.size_mm.toFixed(2)} mm</strong> (${match.size_inch})<br/>${ui.matchDifference || 'Difference'}: ${match.difference_mm.toFixed(2)} mm`;
+  }
+}
+
+function getBadgeClass(pct: string) {
+  const numPct = parseFloat(pct);
+  if (numPct < 2) return 'tight';
+  if (numPct < 5) return '';
+  return 'loose';
+}

package/src/tool/workshopFractionConverter/ui.ts

@@ -0,0 +1,38 @@
+export interface WorkshopFractionConverterUI extends Record<string, string> {
+  labelFraction: string;
+  labelWhole: string;
+  labelNumerator: string;
+  labelDenominator: string;
+  labelInches: string;
+  labelMillimeters: string;
+  resultTitle: string;
+  resultFraction: string;
+  resultInches: string;
+  resultMillimeters: string;
+  matchTitle: string;
+  matchClosestFastener: string;
+  matchClosestSocket: string;
+  matchDifference: string;
+  matchRecommendation: string;
+  reverseSearchTitle: string;
+  reverseSearchLabel: string;
+  reverseSearchButton: string;
+  reverseSearchHint: string;
+  unitMm: string;
+  unitInch: string;
+  modeForward: string;
+  modeReverse: string;
+  precisionLabel: string;
+  precisionCarpentry: string;
+  precisionMetal: string;
+  buttonConvert: string;
+  buttonClear: string;
+  buttonCopyResult: string;
+  buttonSaveToHistory: string;
+  historyTitle: string;
+  historyEmpty: string;
+  historyRemove: string;
+  helpText: string;
+  toolOverline: string;
+  labelVisualReference: string;
+}