@jjlmoya/utils-motor 1.2.0 → 1.3.0

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

@@ -0,0 +1,95 @@
+import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
+import type { SEOSection } from '@jjlmoya/utils-shared';
+import type { TirePressureConverterLocaleContent } from '../entry';
+
+const schemas: WithContext<SoftwareApplication | FAQPage | HowTo>[] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: '胎压单位转换计算器',
+    applicationCategory: 'UtilitiesApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+    description: '精准转换 PSI、bar、kPa 和 kgf/cm² 胎压单位。',
+  },
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: [
+      {
+        '@type': 'Question',
+        name: '我应该使用多少胎压？',
+        acceptedAnswer: { '@type': 'Answer', text: '请参阅驾驶员车门柱标牌或用户手册上的冷态推荐胎压。本转换器仅进行单位换算。' },
+      },
+      {
+        '@type': 'Question',
+        name: '为什么前后轮的推荐胎压可能不同？',
+        acceptedAnswer: { '@type': 'Answer', text: '车辆轴荷分布与前后轴承重不同，因此厂商可能会为前后轮指定不同的冷态胎压。' },
+      },
+    ],
+  },
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: '转换胎压读数',
+    step: [
+      { '@type': 'HowToStep', name: '输入读数', text: '输入胎压表显示的数字。' },
+      { '@type': 'HowToStep', name: '选择源单位', text: '选择 PSI、bar、kPa 或 kgf/cm²。' },
+      { '@type': 'HowToStep', name: '查看转换结果', text: '在结果栏中查看对应的其他单位数值。' },
+    ],
+  },
+];
+
+const seo: SEOSection[] = [
+  { type: 'title', level: 2, text: '在不改变实际物理数值的前提下转换胎压单位' },
+  { type: 'paragraph', html: '当打气泵、胎压表或车辆标牌使用不同的胎压单位时，使用本胎压单位转换器。只需输入一个读数，即可在一屏中同时查看 PSI、bar、kPa 和 kgf/cm² 的等效数值。' },
+  { type: 'title', text: '如何使用胎压转换器', level: 3 },
+  { type: 'list', items: ['输入胎压表上显示的数值。', '选择该数值旁标注的单位。', '选择前轮、后轮或全车车轴以便于记录。', '在转换结果栏中读取所需的对应单位数值。'] },
+  { type: 'tip', title: '转换器不会帮您决定推荐胎压', html: '请在车辆 B 柱贴纸或用户手册中查找推荐的冷态胎压。轮胎侧壁上模印的数字是该轮胎的最高极限承受压力，并非特定车辆的推荐胎压。' },
+  { type: 'title', text: '常见胎压单位一览', level: 3 },
+  { type: 'table', headers: ['单位', '含义', '精确换算关系'], rows: [['PSI', '磅/平方英寸', '1 psi'], ['bar', '巴 (气压单位)', '1 bar = 14.5037738 psi'], ['kPa', '千帕 (国内标准)', '1 kPa = 0.145037738 psi'], ['kgf/cm²', '公斤力/平方厘米', '1 kgf/cm² = 14.2233433 psi']] },
+  { type: 'diagnostic', variant: 'warning', title: '注意测量时的轮胎温度条件', badge: '冷态测量', html: '胎压会随温度变化。为了获得可靠的测量结果，请务必在轮胎处于冷态时进行测量。' },
+];
+
+export const content: TirePressureConverterLocaleContent = {
+  slug: 'tire-pressure-converter-psi-bar-kpa-kgf-cm2',
+  title: '胎压单位转换计算器',
+  description: '轻松转换汽车与摩托车轮胎的 PSI、bar、kPa 和 kgf/cm² 胎压单位，支持前后轴标记。',
+  ui: {
+    flowLabel: '胎压单位转换桥',
+    flowHint: '输入您拥有的读数，选择其单位，即可直接获取其他单位的对应数值。',
+    readingLabel: '胎压表读数',
+    readingHint: '输入您胎压表或标牌上显示的数字。',
+    sourceUnitLabel: '读数单位',
+    axleLabel: '车轴标记',
+    frontAxle: '前轮',
+    rearAxle: '后轮',
+    allAxles: '全车车轴',
+    conversionLabel: '对应等效胎压',
+    psiLabel: 'PSI',
+    barLabel: 'bar',
+    kpaLabel: 'kPa',
+    kgfcm2Label: 'kgf/cm²',
+    readyMessage: '已转换:',
+    emptyMessage: '请输入胎压读数以查看转换结果。',
+    safetyNote: '本工具用于单位换算。特定车辆的冷态推荐胎压请参阅用户手册。',
+    inputPlaceholder: '例如: 2.5',
+  },
+  seo,
+  faqTitle: '胎压单位转换常见问题',
+  faq: [
+    { question: '我应该打多少胎压？', answer: '请查阅驾驶员门框上的标牌或用户手册中的冷态推荐胎压。本工具仅用于单位换算。' },
+    { question: '为什么前轮和后轮的胎压会不一样？', answer: '前后轴的载荷分布不同，因此厂商会指定不同的前轮与后轮冷态胎压。' },
+    { question: '轮胎侧面印的数字是推荐胎压吗？', answer: '不是。轮胎侧壁上的数字是该轮胎的最大极限承压值，而非车辆推荐值。' },
+  ],
+  bibliographyTitle: '参考资料',
+  bibliography: [
+    { name: '米其林轮胎胎压保养指南', url: 'https://www.michelin.com.cn' },
+  ],
+  howTo: [
+    { name: '输入读数', text: '输入胎压表显示的数字。' },
+    { name: '选择源单位', text: '选择 PSI、bar、kPa 或 kgf/cm²。' },
+    { name: '查看转换结果', text: '在结果栏中查看对应的其他单位数值。' },
+  ],
+  schemas,
+};

package/src/tool/tirePressureConverter/index.ts

@@ -0,0 +1,10 @@
+import { tirePressureConverter } from './entry';
+
+export * from './entry';
+
+export const TIRE_PRESSURE_CONVERTER_TOOL = {
+  entry: tirePressureConverter,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/tirePressureConverter/logic.test.ts

@@ -0,0 +1,37 @@
+import { describe, expect, it } from 'vitest';
+import { convertPressure, formatPressure, isPressureUnit, parsePressureInput, pressureNeedleAngle } from './logic';
+
+describe('tire pressure conversion', () => {
+  it('converts PSI to all supported units', () => {
+    const result = convertPressure(32, 'psi');
+    expect(result?.values.bar).toBeCloseTo(2.2063, 3);
+    expect(result?.values.kpa).toBeCloseTo(220.632, 2);
+    expect(result?.values.kgfcm2).toBeCloseTo(2.2498, 3);
+  });
+
+  it('converts from metric units', () => {
+    expect(convertPressure(2.2, 'bar')?.psi).toBeCloseTo(31.9083, 3);
+    expect(convertPressure(220, 'kpa')?.values.psi).toBeCloseTo(31.9083, 3);
+    expect(convertPressure(2.25, 'kgfcm2')?.values.psi).toBeCloseTo(32.0025, 3);
+  });
+
+  it('rejects invalid values and units', () => {
+    expect(convertPressure(-1, 'psi')).toBeNull();
+    expect(convertPressure(Number.NaN, 'psi')).toBeNull();
+    expect(convertPressure(32, 'unknown' as never)).toBeNull();
+    expect(isPressureUnit('bar')).toBe(true);
+    expect(isPressureUnit('pascal')).toBe(false);
+    expect(parsePressureInput('')).toBeNull();
+    expect(parsePressureInput('  ')).toBeNull();
+    expect(parsePressureInput('-2')).toBeNull();
+    expect(parsePressureInput('32')).toBe(32);
+  });
+
+  it('formats values and clamps the scene needle', () => {
+    expect(formatPressure(2.20626, 'bar')).toBe('2.21');
+    expect(formatPressure(220.632, 'kpa')).toBe('220.6');
+    expect(pressureNeedleAngle(0)).toBe(-132);
+    expect(pressureNeedleAngle(30)).toBe(0);
+    expect(pressureNeedleAngle(90)).toBe(132);
+  });
+});

package/src/tool/tirePressureConverter/logic.ts

@@ -0,0 +1,47 @@
+export type PressureUnit = 'psi' | 'bar' | 'kpa' | 'kgfcm2';
+
+export interface PressureConversion {
+  input: number;
+  sourceUnit: PressureUnit;
+  psi: number;
+  values: Record<PressureUnit, number>;
+}
+
+const PSI_PER_UNIT: Record<PressureUnit, number> = {
+  psi: 1,
+  bar: 14.5037738,
+  kpa: 0.145037738,
+  kgfcm2: 14.2233433,
+};
+
+export const PRESSURE_UNITS: PressureUnit[] = ['psi', 'bar', 'kpa', 'kgfcm2'];
+
+export function isPressureUnit(value: string): value is PressureUnit {
+  return PRESSURE_UNITS.includes(value as PressureUnit);
+}
+
+export function convertPressure(input: number, sourceUnit: PressureUnit): PressureConversion | null {
+  if (!Number.isFinite(input) || input < 0 || !isPressureUnit(sourceUnit)) return null;
+  const psi = input * PSI_PER_UNIT[sourceUnit];
+  const values = PRESSURE_UNITS.reduce((result, unit) => {
+    result[unit] = psi / PSI_PER_UNIT[unit];
+    return result;
+  }, {} as Record<PressureUnit, number>);
+  return { input, sourceUnit, psi, values };
+}
+
+export function parsePressureInput(input: string): number | null {
+  if (input.trim() === '') return null;
+  const value = Number(input);
+  return Number.isFinite(value) && value >= 0 ? value : null;
+}
+
+export function formatPressure(value: number, unit: PressureUnit): string {
+  const decimals = unit === 'kpa' ? 1 : 2;
+  return value.toFixed(decimals);
+}
+
+export function pressureNeedleAngle(psi: number): number {
+  const clamped = Math.min(Math.max(psi, 0), 60);
+  return -132 + (clamped / 60) * 264;
+}

package/src/tool/tirePressureConverter/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { tirePressureConverter } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props;
+const loader = tirePressureConverter.i18n[locale] ?? tirePressureConverter.i18n.en;
+const content = await loader?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/tirePressureConverter/storage.ts

@@ -0,0 +1,27 @@
+import type { PressureUnit } from './logic';
+
+export interface SavedPressureState {
+  input: string;
+  sourceUnit: PressureUnit;
+  axle: 'front' | 'rear' | 'all';
+}
+
+const STORAGE_KEY = 'jjlmoya:tire-pressure-converter';
+
+export function loadPressureState(): SavedPressureState | null {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    const state = JSON.parse(raw) as SavedPressureState;
+    if (!state || typeof state.input !== 'string') return null;
+    return state;
+  } catch {
+    return null;
+  }
+}
+
+export function savePressureState(state: SavedPressureState): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+  } catch {}
+}

package/src/tool/tirePressureConverter/tire-pressure-converter-psi-bar-kpa-kgf-cm2.css

@@ -0,0 +1,293 @@
+.tire-pressure-tool {
+  --n-ink: #16241f;
+  --n-muted: #5e7168;
+  --n-paper: #f4f1e8;
+  --n-surface: #fffdf7;
+  --n-line: #c6d2c5;
+  --n-accent: #d36b3d;
+  --n-accent-deep: #873d2b;
+  --n-blue: #2d7f89;
+  --n-dark: #0d1917;
+  --n-white: #fff;
+  --n-result-ink: #f8f6ee;
+  --n-result-muted: #9fb1a7;
+  --n-result-arc: #33433d;
+  --n-result-card: #172823;
+  --n-result-line: #2c4139;
+
+  color: var(--n-ink);
+  background: var(--n-paper);
+  border: 1px solid var(--n-line);
+  border-radius: 24px;
+  overflow: hidden;
+}
+
+.tire-pressure-tool button,
+.tire-pressure-tool input {
+  font: inherit;
+}
+
+.pressure-workbench {
+  display: grid;
+  grid-template-columns: minmax(260px, .9fr) minmax(360px, 1.1fr);
+  min-height: 460px;
+}
+
+.pressure-input-panel {
+  padding: 2rem;
+  border-right: 1px solid var(--n-line);
+}
+
+.pressure-workbench-intro {
+  margin-bottom: 2rem;
+}
+
+.pressure-kicker {
+  margin: 0 0 .5rem;
+  color: var(--n-accent-deep);
+  font-size: .72rem;
+  font-weight: 800;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+}
+
+.pressure-workbench-intro p:last-child,
+.pressure-field-hint,
+.pressure-safety {
+  color: var(--n-muted);
+  line-height: 1.55;
+}
+
+.pressure-field {
+  margin-bottom: 1.5rem;
+}
+
+.pressure-field label,
+.pressure-field legend {
+  display: block;
+  margin-bottom: .65rem;
+  color: var(--n-ink);
+  font-size: .82rem;
+  font-weight: 800;
+}
+
+.pressure-field-hint {
+  margin: .55rem 0 0;
+  font-size: .78rem;
+}
+
+.pressure-input {
+  display: flex;
+  align-items: center;
+  gap: .65rem;
+  padding: .85rem 1rem;
+  background: var(--n-surface);
+  border: 1px solid var(--n-line);
+  border-radius: 14px;
+}
+
+.pressure-input input {
+  width: 100%;
+  min-width: 0;
+  padding: 0;
+  color: var(--n-ink);
+  background: transparent;
+  border: 0;
+  outline: 0;
+  font-size: 1.7rem;
+  font-weight: 800;
+}
+
+.pressure-input span {
+  color: var(--n-muted);
+  font-weight: 800;
+}
+
+.pressure-unit-row,
+.pressure-axle-row {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: .4rem;
+}
+
+.pressure-axle-row {
+  grid-template-columns: repeat(3, 1fr);
+}
+
+.pressure-unit-row button,
+.pressure-axle-row button {
+  min-height: 2.7rem;
+  padding: .4rem .3rem;
+  color: var(--n-muted);
+  background: transparent;
+  border: 1px solid var(--n-line);
+  border-radius: 10px;
+  cursor: pointer;
+  font-size: .76rem;
+  font-weight: 800;
+}
+
+.pressure-unit-row button.is-active,
+.pressure-axle-row button.is-active {
+  color: var(--n-white);
+  background: var(--n-accent-deep);
+  border-color: var(--n-accent-deep);
+}
+
+.pressure-unit-row button:focus-visible,
+.pressure-axle-row button:focus-visible,
+.pressure-input input:focus-visible {
+  outline: 3px solid var(--n-accent);
+  outline-offset: 3px;
+}
+
+.pressure-safety {
+  margin: 1.8rem 0 0;
+  padding-top: 1rem;
+  border-top: 1px solid var(--n-line);
+  font-size: .8rem;
+}
+
+.pressure-result-panel {
+  display: grid;
+  grid-template-rows: 1fr auto auto;
+  padding: 1.5rem 2rem 2rem;
+  background: var(--n-dark);
+  color: var(--n-result-ink);
+}
+
+.pressure-scene {
+  display: grid;
+  place-items: center;
+  min-height: 250px;
+}
+
+.pressure-scene-svg {
+  width: min(100%, 390px);
+  overflow: visible;
+}
+
+.pressure-scene-arc {
+  fill: none;
+  stroke: var(--n-result-arc);
+  stroke-linecap: round;
+  stroke-width: 18;
+}
+
+.pressure-scene-arc-active {
+  stroke: var(--n-accent);
+}
+
+.pressure-scene-hub {
+  fill: var(--n-accent);
+  stroke: var(--n-result-ink);
+  stroke-width: 5;
+}
+
+.pressure-scene-needle {
+  stroke: var(--n-result-ink);
+  stroke-linecap: round;
+  stroke-width: 5;
+}
+
+.pressure-scene-value {
+  fill: var(--n-result-ink);
+  font-size: 28px;
+  font-weight: 800;
+}
+
+.pressure-scene-unit,
+.pressure-scene-mark {
+  fill: var(--n-result-muted);
+  font-size: 12px;
+  font-weight: 800;
+  letter-spacing: .08em;
+}
+
+.pressure-scene-empty {
+  color: var(--n-result-muted);
+  font-size: 1rem;
+}
+
+.pressure-conversion-label {
+  margin: 0 0 .75rem;
+  color: var(--n-result-muted);
+  font-size: .72rem;
+  font-weight: 800;
+  letter-spacing: .14em;
+  text-transform: uppercase;
+}
+
+.pressure-values {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: .5rem;
+}
+
+.pressure-value {
+  padding: .8rem .7rem;
+  background: var(--n-result-card);
+  border: 1px solid var(--n-result-line);
+  border-radius: 12px;
+}
+
+.pressure-value span {
+  display: block;
+  margin-bottom: .3rem;
+  color: var(--n-result-muted);
+  font-size: .7rem;
+  font-weight: 800;
+}
+
+.pressure-value strong {
+  display: block;
+  color: var(--n-result-ink);
+  font-size: 1.1rem;
+  white-space: nowrap;
+}
+
+.pressure-status {
+  margin: 1rem 0 0;
+  color: var(--n-accent);
+  font-size: .8rem;
+}
+
+@media (max-width: 760px) {
+  .pressure-workbench {
+    display: block;
+  }
+
+  .pressure-input-panel {
+    border-right: 0;
+    border-bottom: 1px solid var(--n-line);
+  }
+
+  .pressure-result-panel {
+    padding: 1rem 1rem 1.5rem;
+  }
+}
+
+@media (max-width: 420px) {
+  .pressure-input-panel {
+    padding: 1.25rem;
+  }
+
+  .pressure-unit-row {
+    grid-template-columns: repeat(2, 1fr);
+  }
+
+  .pressure-values {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+.theme-dark .tire-pressure-tool {
+  --n-ink: #edf4ee;
+  --n-muted: #b3c2b8;
+  --n-paper: #111b18;
+  --n-surface: #182620;
+  --n-line: #3d5348;
+  --n-accent: #ef9165;
+  --n-accent-deep: #bd5e3f;
+  --n-dark: #07100e;
+}

package/src/tool/tirePressureConverter/ui.ts

@@ -0,0 +1,20 @@
+export interface TirePressureConverterUI extends Record<string, string> {
+  flowLabel: string;
+  flowHint: string;
+  readingLabel: string;
+  readingHint: string;
+  sourceUnitLabel: string;
+  axleLabel: string;
+  frontAxle: string;
+  rearAxle: string;
+  allAxles: string;
+  conversionLabel: string;
+  psiLabel: string;
+  barLabel: string;
+  kpaLabel: string;
+  kgfcm2Label: string;
+  readyMessage: string;
+  emptyMessage: string;
+  safetyNote: string;
+  inputPlaceholder: string;
+}

package/src/tools.ts

@@ -1,5 +1,7 @@
 export { ALL_ENTRIES } from './entries';
 import { BRAKING_DISTANCE_CALCULATOR_TOOL } from './tool/brakingDistanceCalculator';
+import { CAR_MOTORCYCLE_GEAR_RATIO_CALCULATOR_TOOL } from './tool/carMotorcycleGearRatioCalculator';
 import { REAL_FUEL_CONSUMPTION_CALCULATOR_TOOL } from './tool/realFuelConsumptionCalculator';
+import { TIRE_PRESSURE_CONVERTER_TOOL } from './tool/tirePressureConverter';
 
-export const ALL_TOOLS = [BRAKING_DISTANCE_CALCULATOR_TOOL, REAL_FUEL_CONSUMPTION_CALCULATOR_TOOL];
+export const ALL_TOOLS = [BRAKING_DISTANCE_CALCULATOR_TOOL, REAL_FUEL_CONSUMPTION_CALCULATOR_TOOL, CAR_MOTORCYCLE_GEAR_RATIO_CALCULATOR_TOOL, TIRE_PRESSURE_CONVERTER_TOOL];