@jjlmoya/utils-motor 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-motor",
-    "version": "1.2.0",
+    "version": "1.3.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -1,10 +1,12 @@
 import type { MotorCategoryEntry, MotorToolEntry } from '../types';
 import { brakingDistanceCalculator } from '../tool/brakingDistanceCalculator/entry';
+import { carMotorcycleGearRatioCalculator } from '../tool/carMotorcycleGearRatioCalculator/entry';
 import { realFuelConsumptionCalculator } from '../tool/realFuelConsumptionCalculator/entry';
+import { tirePressureConverter } from '../tool/tirePressureConverter/entry';
 
 export const motorCategory: MotorCategoryEntry = {
   icon: 'mdi:car-cog',
-  tools: [brakingDistanceCalculator, realFuelConsumptionCalculator] as unknown as MotorToolEntry<Record<string, string>>[],
+  tools: [brakingDistanceCalculator, realFuelConsumptionCalculator, carMotorcycleGearRatioCalculator, tirePressureConverter] as unknown as MotorToolEntry<Record<string, string>>[],
   i18n: {
     es: () => import('./i18n/es').then((module) => module.content),
     en: () => import('./i18n/en').then((module) => module.content),

package/src/entries.ts

@@ -1,10 +1,16 @@
 export { brakingDistanceCalculator } from './tool/brakingDistanceCalculator/entry';
 export type { BrakingDistanceCalculatorLocaleContent } from './tool/brakingDistanceCalculator/entry';
+export { carMotorcycleGearRatioCalculator } from './tool/carMotorcycleGearRatioCalculator/entry';
+export type { CarMotorcycleGearRatioCalculatorLocaleContent } from './tool/carMotorcycleGearRatioCalculator/entry';
 export { realFuelConsumptionCalculator } from './tool/realFuelConsumptionCalculator/entry';
 export type { RealFuelConsumptionCalculatorLocaleContent } from './tool/realFuelConsumptionCalculator/entry';
+export { tirePressureConverter } from './tool/tirePressureConverter/entry';
+export type { TirePressureConverterLocaleContent } from './tool/tirePressureConverter/entry';
 export { motorCategory } from './category';
 
 import { brakingDistanceCalculator } from './tool/brakingDistanceCalculator/entry';
+import { carMotorcycleGearRatioCalculator } from './tool/carMotorcycleGearRatioCalculator/entry';
 import { realFuelConsumptionCalculator } from './tool/realFuelConsumptionCalculator/entry';
+import { tirePressureConverter } from './tool/tirePressureConverter/entry';
 
-export const ALL_ENTRIES = [brakingDistanceCalculator, realFuelConsumptionCalculator];
+export const ALL_ENTRIES = [brakingDistanceCalculator, realFuelConsumptionCalculator, carMotorcycleGearRatioCalculator, tirePressureConverter];

package/src/index.ts

@@ -26,3 +26,13 @@ export type {
   FuelLogUI,
   RealFuelConsumptionCalculatorLocaleContent,
 } from './tool/realFuelConsumptionCalculator';
+export { CAR_MOTORCYCLE_GEAR_RATIO_CALCULATOR_TOOL, carMotorcycleGearRatioCalculator } from './tool/carMotorcycleGearRatioCalculator';
+export type {
+  CarMotorcycleGearRatioCalculatorUI,
+  CarMotorcycleGearRatioCalculatorLocaleContent,
+} from './tool/carMotorcycleGearRatioCalculator';
+export { TIRE_PRESSURE_CONVERTER_TOOL, tirePressureConverter } from './tool/tirePressureConverter';
+export type {
+  TirePressureConverterUI,
+  TirePressureConverterLocaleContent,
+} from './tool/tirePressureConverter';

package/src/tests/locale_completeness.test.ts

@@ -4,7 +4,7 @@ import type { ToolLocaleContent } from '../types';
 
 describe('Locale Completeness and Slug Validation', () => {
   it('all tools registered in ALL_TOOLS', () => {
-    expect(ALL_TOOLS.length).toBe(2);
+    expect(ALL_TOOLS.length).toBe(4);
   });
 
   ALL_TOOLS.forEach((tool) => {

package/src/tests/seo_translation_completeness.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const ASIAN_LOCALES = ['ja', 'ko', 'zh'];
+
+function getSimpleSectionLength(section: any): number {
+  if (section.type === 'title') return section.text ? section.text.length : 0;
+  if (section.type === 'paragraph') return section.html ? section.html.replace(/<[^>]*>/g, '').length : 0;
+  if (section.type === 'list') return section.items ? section.items.join('').length : 0;
+  return 0;
+}
+
+function getComplexSectionLength(section: any): number {
+  if (section.type === 'diagnostic' || section.type === 'tip') {
+    return (section.title ? section.title.length : 0) + (section.html ? section.html.replace(/<[^>]*>/g, '').length : 0);
+  }
+  if (section.type === 'table') {
+    return ((section.headers || []).join('').length) + ((section.rows || []).flat().join('').length);
+  }
+  return 0;
+}
+
+function getSectionLength(section: any): number {
+  return getSimpleSectionLength(section) || getComplexSectionLength(section);
+}
+
+function calculateSeoTextLength(seoSections: any[]): number {
+  return seoSections.reduce((acc, section) => acc + getSectionLength(section), 0);
+}
+
+function checkLocaleSeoLength(toolId: string, locale: string, localeLen: number, enLen: number): void {
+  const isAsian = ASIAN_LOCALES.includes(locale);
+  const minLength = Math.floor(enLen * (isAsian ? 0.25 : 0.70));
+  const msgType = isAsian ? 'suspiciously short' : 'truncated/lazy';
+
+  expect(
+    localeLen,
+    `[LAZY SEO TRANSLATION] Tool "${toolId}" locale "${locale}" SEO text is ${msgType} (${localeLen} chars vs EN ${enLen} chars, expected min ${minLength})`,
+  ).toBeGreaterThanOrEqual(minLength);
+}
+
+async function auditSingleLocale(toolId: string, locale: string, loader: any, enSeoLength: number): Promise<void> {
+  if (locale === 'en' || !loader) return;
+  const content = await loader();
+  if (!content.seo || !Array.isArray(content.seo)) return;
+
+  checkLocaleSeoLength(toolId, locale, calculateSeoTextLength(content.seo), enSeoLength);
+}
+
+describe('SEO Translation Completeness & Laziness Audit', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should not have lazy or truncated SEO content compared to English reference', async () => {
+        const enLoader = entry.i18n['en' as keyof typeof entry.i18n];
+        if (!enLoader) return;
+
+        const enContent = await enLoader();
+        if (!enContent.seo || !Array.isArray(enContent.seo)) return;
+
+        const enSeoLength = calculateSeoTextLength(enContent.seo);
+
+        for (const [locale, loader] of Object.entries(entry.i18n)) {
+          await auditSingleLocale(entry.id, locale, loader, enSeoLength);
+        }
+      });
+    });
+  });
+});
+

package/src/tests/tool_validation.test.ts

@@ -5,7 +5,7 @@ import { motorCategory } from '../data';
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
     it('should have tools registered in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(2);
+      expect(ALL_TOOLS.length).toBe(4);
     });
 
     it('motorCategory should be defined', () => {

package/src/tool/carMotorcycleGearRatioCalculator/bibliography.astro

@@ -0,0 +1,6 @@
+---
+import { Bibliography as SharedBibliography } from '@jjlmoya/utils-shared';
+import { bibliographyEntries } from './bibliography';
+---
+
+<SharedBibliography links={bibliographyEntries} />

package/src/tool/carMotorcycleGearRatioCalculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliographyEntries: BibliographyEntry[] = [
+  {
+    name: 'Brooklyn College drivetrain equations for vehicle speed and wheel RPM',
+    url: 'https://www.sci.brooklyn.cuny.edu/~goetz/agents/courses/corc3303/papers/b1-reyenga-2009.pdf',
+  },
+  {
+    name: 'Firgelli Engineering vehicle speed and final drive ratio formula',
+    url: 'https://www.firgelliauto.com/blogs/engineering-calculators/gear-ratio-speed-calculator-final-drive',
+  },
+];