@jjlmoya/utils-hardware 1.15.0 → 1.16.0

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

@@ -0,0 +1,196 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { RefreshRateDetectorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'monitor-refresh-rate-detector';
+const title = '显示器刷新率在线测试仪';
+const description = '使用 requestAnimationFrame 毫秒级精准检测显示器的刷新率。测试帧稳定性，并与行业标准进行对比。';
+
+const faqData = [
+  {
+    question: '什么是刷新率 (Hz)？',
+    answer: '刷新率是指显示器每秒更新图像的次数。60Hz 的显示器每秒更新 60 次，而 144Hz 则更新 144 次。刷新率越高，画面动态效果越流畅。',
+  },
+  {
+    question: '这个检测器有多准？',
+    answer: '本工具利用与显示器刷新周期同步的 requestAnimationFrame API。准确度取决于系统负载。稳定模式通过延长测量时间来提供更高的精度。',
+  },
+  {
+    question: '稳定模式和快速模式有什么区别？',
+    answer: '快速模式测量时间较短（约 3 秒），可快速反馈。稳定模式时间较长（约 10 秒），旨在滤除系统噪点，提供更可靠的结果。',
+  },
+  {
+    question: '为什么检测到的 Hz 与显示器规格不符？',
+    answer: '可能的原因包括：电缆连接松动、驱动程序过时或操作系统缩放设置干扰。请尝试重新插拔显示电缆或更新显卡驱动程序。',
+  },
+  {
+    question: '现代显示器支持哪些刷新率？',
+    answer: '常见的标准包括 60Hz（基础）、75Hz、120Hz、144Hz（游戏级）、240Hz（竞技级）和 360Hz（专业电竞）。',
+  },
+];
+
+const howToData = [
+  {
+    name: '加载工具',
+    text: '只需打开此页面，检测器便会立即开始测量。',
+  },
+  {
+    name: '等待稳定',
+    text: '选择稳定或快速模式。请勿移动窗口，等待测量完成。',
+  },
+  {
+    name: '检查仪表盘',
+    text: '显示器的刷新率将显示在平滑的仪表盘上，并附带基准统计数据（最小/最大/平均）。',
+  },
+  {
+    name: '对比标准',
+    text: '工具会显示您的显示器符合哪项标准（60, 75, 120, 144, 240, 360Hz）。',
+  },
+  {
+    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<HowTo> = {
+  '@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: 'USD' },
+  inLanguage: 'zh',
+};
+
+export const content: ToolLocaleContent<RefreshRateDetectorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '显示器刷新率测试仪：在线检测屏幕 Hz 频率',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '毫秒级精准检测显示器的刷新率（60Hz, 144Hz, 240Hz 等）。测试帧稳定性，验证显示器是否在额定规格下正常运行。',
+    },
+    {
+      type: 'title',
+      text: '为什么显示器刷新率很重要',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '刷新率决定了屏幕上动作的流畅程度。游戏玩家能从 144Hz+ 的显示器中获益，而普通用户通常觉得 60Hz 已足够。此工具可帮助确认您的显示器是否真正达到了宣传的刷新率。',
+    },
+    {
+      type: 'title',
+      text: '如何检测您的刷新率',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '加载此检测器——测量立即开始',
+        '选择快速（3秒）或稳定（10秒）测量模式',
+        '从仪表盘读取显示器的 Hz 数值',
+        '对照行业标准（60, 75, 120, 144, 240, 360Hz）',
+      ],
+    },
+    {
+      type: 'title',
+      text: '常见的刷新率标准',
+      level: 3,
+    },
+    {
+      type: 'table',
+      headers: ['标准', '应用场景', '典型用户'],
+      rows: [
+        ['60Hz', '普通办公', '办公、网页浏览'],
+        ['75Hz', '轻度游戏', '休闲玩家'],
+        ['120Hz', '多媒体', '主机游戏、流媒体'],
+        ['144Hz', '竞技游戏', 'FPS、快节奏游戏'],
+        ['240Hz+', '专业电竞', '职业选手、主播'],
+      ],
+    },
+    {
+      type: 'title',
+      text: '故障排除：显示刷新率低于预期',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '检查 HDMI/DisplayPort 线缆连接——接触不良会降低带宽',
+        '更新显卡驱动程序（NVIDIA, AMD, Intel）',
+        '检查系统的显示设置，确保已启用高刷新率',
+        '尝试更换显示器上的线缆或接口',
+        '重启电脑并重新测试',
+      ],
+    },
+    {
+      type: 'title',
+      text: '检测背后的技术',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '本工具使用浏览器的 requestAnimationFrame API，它直接与显示器的刷新周期同步。通过测量动画帧之间的时间，我们能以高精度计算出准确的刷新率，无需特殊硬件支持。',
+    },
+  ],
+  ui: {
+    badge: '显示测试',
+    title: '刷新率检测仪',
+    description: '立即检测您的显示器刷新率',
+    modeStable: '稳定（10秒，更精准）',
+    modeFast: '快速（3秒，更迅速）',
+    measurementStatus: '正在测量...',
+    currentHz: '当前',
+    averageHz: '平均',
+    maxHz: '最大',
+    minHz: '最小',
+    standardDetected: '检测到标准',
+    frameSkippingTest: '跳帧测试',
+    startMeasurement: '开始测量',
+    resetMeasurement: '重置',
+    copyResult: '复制结果',
+    copiedFeedback: '已复制到剪贴板！',
+    optimalConfiguration: '[OK] 最佳配置',
+    suboptimalConfiguration: '[警告] 低于最佳水平',
+    unstableRefreshRate: '[警告] 刷新率不稳定',
+    measurementNotStarted: '准备就绪',
+    switchMonitorHint: '将窗口拖动到另一个显示器以进行测试',
+    incompatibleBrowserMsg: '您的浏览器不支持 requestAnimationFrame',
+  },
+};

package/src/tool/refreshRateDetector/index.ts

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

package/src/tool/refreshRateDetector/monitor-refresh-rate-detector.css

@@ -0,0 +1,342 @@
+/* Variables for light mode */
+:root {
+  --rrd-bg: #fff;
+  --rrd-text: #000;
+  --rrd-text-muted: #555;
+  --rrd-border: #d0d0d0;
+  --rrd-metric-bg: #f8f8f8;
+  --rrd-button-bg: #f0f0f0;
+  --rrd-button-border: #aaa;
+  --rrd-button-text: #222;
+  --rrd-monitor-bezel: #222;
+  --rrd-monitor-screen: #050505;
+  --rrd-hz-text: #fff;
+}
+
+/* Variables for dark mode */
+.theme-dark {
+  --rrd-bg: #1a1a1a;
+  --rrd-text: #f0f0f0;
+  --rrd-text-muted: #999;
+  --rrd-border: #333;
+  --rrd-metric-bg: #2a2a2a;
+  --rrd-button-bg: #2a2a2a;
+  --rrd-button-border: #444;
+  --rrd-button-text: #e0e0e0;
+  --rrd-monitor-bezel: #f5f5f5;
+  --rrd-monitor-screen: #0a0a0a;
+  --rrd-hz-text: #fff;
+}
+
+.rrd-wrapper {
+  width: 100%;
+  max-width: 100%;
+  background: transparent;
+  color: var(--rrd-text);
+}
+
+.rrd-container {
+  width: 100%;
+  max-width: 100%;
+  display: flex;
+  justify-content: center;
+}
+
+.rrd-card {
+  width: 100%;
+  max-width: 800px;
+  background: var(--rrd-bg);
+  border: 1px solid var(--rrd-border);
+  border-radius: 12px;
+  padding: 2rem;
+}
+
+.rrd-layout {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 2rem;
+  align-items: stretch;
+}
+
+/* LEFT COLUMN: METRICS */
+.rrd-left {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.rrd-metrics {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1.5rem;
+}
+
+.rrd-metric-item {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  padding: 1rem;
+  background: var(--rrd-metric-bg);
+  border: 1px solid var(--rrd-border);
+  border-radius: 8px;
+}
+
+.rrd-metric-label {
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--rrd-text-muted);
+}
+
+.rrd-metric-value {
+  font-size: 1.5rem;
+  font-weight: 700;
+  color: var(--rrd-text);
+}
+
+.rrd-metric-unit {
+  font-size: 0.75rem;
+  color: var(--rrd-text-muted);
+}
+
+.rrd-mode-selector {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.75rem;
+}
+
+.rrd-mode-btn {
+  padding: 0.75rem 1rem;
+  background: var(--rrd-button-bg);
+  border: 2px solid var(--rrd-button-border);
+  border-radius: 6px;
+  color: var(--rrd-button-text);
+  font-size: 0.875rem;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 200ms ease;
+}
+
+.rrd-mode-btn:hover {
+  background: var(--rrd-border);
+}
+
+.rrd-mode-btn.selected {
+  background: var(--rrd-text);
+  color: var(--rrd-bg);
+  border-color: var(--rrd-text);
+}
+
+/* RIGHT COLUMN: MONITOR */
+.rrd-right {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 300px;
+}
+
+.rrd-monitor {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 1rem;
+}
+
+.rrd-monitor-bezel {
+  width: 280px;
+  aspect-ratio: 16 / 10;
+  background: var(--rrd-monitor-bezel);
+  border: 8px solid var(--rrd-monitor-bezel);
+  border-radius: 12px;
+  padding: 12px;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.2);
+}
+
+.rrd-monitor-screen {
+  width: 100%;
+  height: 100%;
+  background: var(--rrd-monitor-screen);
+  border-radius: 4px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+}
+
+.rrd-monitor-content {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  overflow: hidden;
+}
+
+.rrd-monitor-content::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background: repeating-linear-gradient(
+    0deg,
+    rgba(255, 255, 255, 0.15) 0,
+    rgba(255, 255, 255, 0.15) 1px,
+    transparent 1px,
+    transparent 2px
+  );
+  pointer-events: none;
+  animation: rrd-scanlines 8ms linear infinite;
+  z-index: 1;
+}
+
+.rrd-hz-display {
+  font-size: 4rem;
+  font-weight: 900;
+  color: var(--rrd-hz-text);
+  line-height: 1;
+  text-shadow:
+    0 0 10px rgba(255, 255, 255, 0.8),
+    0 0 20px rgba(255, 255, 255, 0.6),
+    0 0 40px rgba(255, 255, 255, 0.4);
+  position: relative;
+  z-index: 2;
+  animation: rrd-glitch 2s ease-in-out infinite;
+  letter-spacing: 0.1em;
+}
+
+.rrd-monitor-stand {
+  width: 100px;
+  height: 12px;
+  background: var(--rrd-monitor-bezel);
+  border-radius: 6px;
+  position: relative;
+}
+
+.rrd-monitor-stand::after {
+  content: '';
+  position: absolute;
+  bottom: -8px;
+  left: 50%;
+  transform: translateX(-50%);
+  width: 60px;
+  height: 8px;
+  background: var(--rrd-monitor-bezel);
+  border-radius: 4px;
+}
+
+@keyframes rrd-scanlines {
+  0% {
+    transform: translateY(0);
+  }
+  100% {
+    transform: translateY(20px);
+  }
+}
+
+@keyframes rrd-glitch {
+  0%, 100% {
+    opacity: 1;
+    transform: translate(0, 0) skewX(0deg);
+    text-shadow:
+      0 0 10px rgba(255, 255, 255, 0.8),
+      0 0 20px rgba(255, 255, 255, 0.6),
+      0 0 40px rgba(255, 255, 255, 0.4);
+    filter: contrast(1);
+  }
+  10% {
+    opacity: 0.8;
+    transform: translate(-3px, 2px) skewX(-5deg);
+    text-shadow:
+      -3px 0 15px rgba(255, 255, 255, 0.9),
+      3px 0 15px rgba(255, 255, 255, 0.5);
+    filter: contrast(1.2);
+  }
+  20% {
+    opacity: 1;
+    transform: translate(3px, -2px) skewX(5deg);
+    text-shadow:
+      3px 0 15px rgba(255, 255, 255, 0.9),
+      -3px 0 15px rgba(255, 255, 255, 0.5);
+    filter: contrast(1.3);
+  }
+  30% {
+    opacity: 0.85;
+    transform: translate(-2px, 1px) skewX(-3deg);
+    text-shadow:
+      0 0 20px rgba(255, 255, 255, 0.7),
+      0 0 40px rgba(255, 255, 255, 0.5);
+    filter: contrast(1.1);
+  }
+  40% {
+    opacity: 1;
+    transform: translate(2px, -1px) skewX(3deg);
+    text-shadow:
+      0 0 30px rgba(255, 255, 255, 0.8),
+      0 0 50px rgba(255, 255, 255, 0.6);
+    filter: contrast(1.4);
+  }
+  50% {
+    opacity: 0.9;
+    transform: translate(-1px, 0) skewX(-2deg);
+    text-shadow:
+      -2px 0 10px rgba(255, 255, 255, 0.8),
+      2px 0 10px rgba(255, 255, 255, 0.6);
+    filter: contrast(1.2);
+  }
+  60% {
+    opacity: 1;
+    transform: translate(1px, 2px) skewX(2deg);
+    text-shadow:
+      0 0 25px rgba(255, 255, 255, 0.9),
+      0 0 45px rgba(255, 255, 255, 0.7);
+    filter: contrast(1.3);
+  }
+  70% {
+    opacity: 0.8;
+    transform: translate(-2px, -2px) skewX(-4deg);
+    text-shadow:
+      -3px 0 20px rgba(255, 255, 255, 0.85),
+      3px 0 20px rgba(255, 255, 255, 0.5);
+    filter: contrast(1.25);
+  }
+  80% {
+    opacity: 1;
+    transform: translate(2px, 1px) skewX(4deg);
+    text-shadow:
+      3px 0 20px rgba(255, 255, 255, 0.85),
+      -3px 0 20px rgba(255, 255, 255, 0.5);
+    filter: contrast(1.35);
+  }
+  90% {
+    opacity: 0.9;
+    transform: translate(-1px, -1px) skewX(-2deg);
+    text-shadow:
+      0 0 15px rgba(255, 255, 255, 0.8),
+      0 0 30px rgba(255, 255, 255, 0.6);
+    filter: contrast(1.15);
+  }
+}
+
+/* Responsive */
+@media (max-width: 768px) {
+  .rrd-layout {
+    grid-template-columns: 1fr;
+    gap: 1.5rem;
+  }
+
+  .rrd-metrics {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .rrd-monitor-bezel {
+    width: 240px;
+  }
+
+  .rrd-hz-display {
+    font-size: 3rem;
+  }
+}

package/src/tool/refreshRateDetector/seo.astro

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

package/src/tool/refreshRateDetector/ui.ts

@@ -0,0 +1,24 @@
+export interface RefreshRateDetectorUI extends Record<string, string> {
+  badge: string;
+  title: string;
+  description: string;
+  modeStable: string;
+  modeFast: string;
+  measurementStatus: string;
+  currentHz: string;
+  averageHz: string;
+  maxHz: string;
+  minHz: string;
+  standardDetected: string;
+  frameSkippingTest: string;
+  startMeasurement: string;
+  resetMeasurement: string;
+  copyResult: string;
+  copiedFeedback: string;
+  optimalConfiguration: string;
+  suboptimalConfiguration: string;
+  unstableRefreshRate: string;
+  measurementNotStarted: string;
+  switchMonitorHint: string;
+  incompatibleBrowserMsg: string;
+}

package/src/tool/toneGenerator/bibliography.ts

@@ -0,0 +1,13 @@
+import type { BibliographyEntry } from '../../../types';
+
+export const bibliography: BibliographyEntry[] = [
+
+    {
+      name: 'MDN Web Docs — Web Audio API',
+      url: 'https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API',
+    },
+    {
+      name: 'ISO 226:2023 — Equal-loudness contours',
+      url: 'https://www.iso.org/standard/83117.html',
+    },
+];

package/src/tool/toneGenerator/i18n/de.ts

@@ -1,6 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { ToneGeneratorUI } from '../ui';
+import { bibliography } from '../bibliography';
 
 const slug = 'ton-frequenz-generator-online';
 const title = 'Online Ton und Frequenzgenerator';
@@ -87,21 +88,10 @@ export const content: ToolLocaleContent<ToneGeneratorUI> = {
   slug,
   title,
   description,
-  faqTitle: 'Häufig gestellte Fragen',
   faq: faqData,
-  bibliographyTitle: 'Referenzen',
-  bibliography: [
-    {
-      name: 'MDN Web Docs — Web Audio API',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API',
-    },
-    {
-      name: 'ISO 226:2023 — Equal-loudness contours',
-      url: 'https://www.iso.org/standard/83117.html',
-    },
-  ],
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
   seo: [
     { type: 'title', text: 'Alles über Frequenzen und Schallwellen', level: 2 },
     {

package/src/tool/toneGenerator/i18n/en.ts

@@ -1,6 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { ToneGeneratorUI } from '../ui';
+import { bibliography } from '../bibliography';
 
 const slug = 'tone-frequency-generator';
 const title = 'Online Tone and Frequency Generator';
@@ -87,21 +88,10 @@ export const content: ToolLocaleContent<ToneGeneratorUI> = {
   slug,
   title,
   description,
-  faqTitle: 'Frequently Asked Questions',
   faq: faqData,
-  bibliographyTitle: 'References',
-  bibliography: [
-    {
-      name: 'MDN Web Docs — Web Audio API',
-      url: 'https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API',
-    },
-    {
-      name: 'ISO 226:2023 — Equal-loudness contours',
-      url: 'https://www.iso.org/standard/83117.html',
-    },
-  ],
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
   seo: [
     { type: 'title', text: 'Everything About Frequencies and Sound Waves', level: 2 },
     {

package/src/tool/toneGenerator/i18n/es.ts

@@ -1,6 +1,7 @@
 import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
 import type { ToolLocaleContent } from '../../../types';
 import type { ToneGeneratorUI } from '../ui';
+import { bibliography } from '../bibliography';
 
 const slug = 'generador-tonos';
 const title = 'Generador de Tonos y Frecuencias Online';
@@ -87,21 +88,10 @@ export const content: ToolLocaleContent<ToneGeneratorUI> = {
   slug,
   title,
   description,
-  faqTitle: 'Preguntas Frecuentes',
   faq: faqData,
-  bibliographyTitle: 'Referencias',
-  bibliography: [
-    {
-      name: 'MDN Web Docs — Web Audio API',
-      url: 'https://developer.mozilla.org/es/docs/Web/API/Web_Audio_API',
-    },
-    {
-      name: 'ISO 226:2023 — Curvas de igual sonoridad',
-      url: 'https://www.iso.org/standard/83117.html',
-    },
-  ],
   howTo: howToData,
   schemas: [faqSchema, howToSchema, appSchema],
+  bibliography,
   seo: [
     { type: 'title', text: 'Todo sobre Frecuencias y Ondas de Sonido', level: 2 },
     {