@jjlmoya/utils-travel 1.1.0 → 1.2.0

package/src/category/i18n/zh.ts

@@ -0,0 +1,181 @@
+import type { CategoryLocaleContent } from '../../types';
+
+export const content: CategoryLocaleContent = {
+  slug: 'lv-xing',
+  title: '旅行者和冒险者的工具与计算器',
+  description: '使用免费在线工具规划您的下一次旅行。航空行李计算器、国际小费指南、行李清单以及每日挑战生成器。',
+  seo: [
+    {
+      type: 'title',
+      text: '旅行物流与当地探索：智慧规划',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '2026 年的旅行是探索与技术管理的融合。在本节中，我们为希望减轻规划压力的数字游民、常旅客和城市冒险者提供了一套<strong>免费在线工具</strong>。旅行物流不应成为冒险的障碍，而应是使之成为可能的地图。',
+    },
+    {
+      type: 'paragraph',
+      html: '从遵守航空公司规定到国际文化礼仪以及当地环境的游戏化，我们的工具帮助您成为一个更有意识、更高效、更有好奇心的旅行者。',
+    },
+    {
+      type: 'title',
+      text: '航空物流：行李计算器与尺寸',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '避免在值机柜台出现意外和额外费用至关重要。我们的<strong>行李计算器</strong>集成了 20 多家领先航空公司（包括瑞安航空、易捷航空或伏林航空等廉价航空公司）允许的尺寸和重量。立即验证您的随身行李是否符合下一次航班的具体要求。',
+    },
+    {
+      type: 'title',
+      text: '国际礼仪：小费指南与计算器',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '支付小费不只是一次交易；它是一种在不同国家间迥异的文化规范。我们的<strong>国际小费计算器</strong>提供针对 50 多个国家的建议百分比和小费礼仪，帮助您在从日本到美国的旅途中成为尊重当地习俗的旅行者。',
+    },
+    {
+      type: 'title',
+      text: '高效组织：行李清单生成器',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '您是否曾到达目的地后才意识到忘记了最重要的东西？根据您的停留时间、目的地的气候和旅行原因，我们的<strong>交互式清单</strong>会生成个性化的行李清单，让您不再听天由命。',
+    },
+    {
+      type: 'title',
+      text: '环境探索：微型冒险生成器',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '冒险不仅在世界的另一端；它通常就在转角处。我们的<strong>微型冒险</strong>生成器使用随机算法来建议每日挑战，迫使您以创造性和不同的方式与当地环境互动。打破常规，重新发现您自己的城市。',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>飞行节省：</strong>通过技术规划，避免因超重行李或超大行李箱产生额外费用。',
+        '<strong>文化意识：</strong>通过了解当地礼仪规范，自信地穿梭于国际环境。',
+        '<strong>安全出行：</strong>确保您携带所有必要证件和药物的清单。',
+        '<strong>探索游戏化：</strong>将您的日常通勤转化为小型发现探险。',
+      ],
+    },
+    {
+      type: 'tip',
+      title: '专家旅行建议',
+      html: '<p><strong>证件保管：</strong>始终在云端保存一份加密的证件（护照、保险）电子副本，并在行李中放置一份隐藏的纸质副本。我们的清单工具会提醒您在出门前完成这一关键步骤。</p>',
+    },
+    {
+      type: 'title',
+      text: '财务规划：预算编制与开支控制',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '没有预算的旅行是被旅行控制而非控制旅行。出发前，建立按类别细分的现实预算：住宿（40%）、餐饮（25%）、活动（20%）、当地交通（10%）、紧急预备金（5%）。这种结构可以防止令人不快的意外。',
+    },
+    {
+      type: 'title',
+      text: '国际旅行中的健康与医疗证件',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '健康随您而行。在前往任何国际目的地之前，检查建议接种的疫苗。随身携带数字化病历、英文药物处方以及在必要时涵盖医疗转运的旅游保险。',
+    },
+    {
+      type: 'title',
+      text: '真实体验：负责任旅游与剥削',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '负责任的旅行意味着事先研究、尊重当地边界，并直接向当地社区而非中间商提供经济支持。这会拓宽您的体验并创造真正的积极影响。',
+    },
+    {
+      type: 'title',
+      text: '住宿物流与智能预订',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>住宿比较器</strong>实时聚合多个平台的价格，允许您评估不仅是价格，还有经过验证的评价和战略位置。',
+    },
+    {
+      type: 'title',
+      text: '货币兑换与历史汇率分析',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>汇率追踪器</strong>向您展示历史汇率，以便您规划最佳的换钱时间。',
+    },
+    {
+      type: 'title',
+      text: '时差管理与科学时间适应',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>时差规划器</strong>根据您的目的地建议何时进行日光照射。简单的策略（如在旅行前 2-3 天调整睡眠）可以显著减轻时差反应。',
+    },
+    {
+      type: 'title',
+      text: '路由优化：应用于旅游的旅行商算法',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>旅游路线优化器</strong>应用旅行商问题 (TSP) 算法来寻找最有效的访问顺序。它不仅考虑距离，还考虑停留时间、营业时间和可用的公共交通。',
+    },
+    {
+      type: 'title',
+      text: '旅行规定：签证、疫苗和所需证件',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>旅行要求审计器</strong>检查您的国籍、目的地和旅行日期，准确告知您需要哪些证件。',
+    },
+    {
+      type: 'title',
+      text: '当地交通：地铁图与全球交通系统',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '我们的<strong>公共交通导航器</strong>集成了全球 100 多个城市的地铁、公交和有轨电车系统。',
+    },
+    {
+      type: 'title',
+      text: '旅游保险与医疗紧急覆盖',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '<strong>旅游保险比较器</strong>允许您评估医疗转运、牙科护理和行李报销的覆盖范围。',
+    },
+    {
+      type: 'title',
+      text: '2026 年感性旅游的未来',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '在 2026 年，<strong>慢旅行</strong>和再生旅游是基础。这些工具赋予您管理作为旅行者自主权的能力，减少物流噪音。',
+    },
+    {
+      type: 'stats',
+      columns: 2,
+      items: [
+        { label: '行李', value: '20+ 航空公司', icon: 'mdi:airplane' },
+        { label: '清单', value: '智能自适应', icon: 'mdi:clipboard-check' },
+        { label: '小费', value: '50+ 国家', icon: 'mdi:cash-multiple' },
+        { label: '冒险', value: '每日生物学', icon: 'mdi:compass' },
+      ],
+    },
+  ],
+};

package/src/category/index.ts

@@ -4,9 +4,21 @@ export const travelCategory: TravelCategoryEntry = {
   icon: 'mdi:map-marker-path',
   tools: [],
   i18n: {
-    es: () => import('./i18n/es').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
     fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
   },
 };
 

package/src/tests/i18n_coverage.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const EXPECTED_LOCALES = [
+  'de', 'en', 'es', 'fr', 'id', 'it', 'ja', 'ko', 'nl', 'pl', 'pt', 'ru', 'sv', 'tr', 'zh'
+];
+
+describe('I18n Coverage Validation', () => {
+  it('all tools should be registered', () => {
+    expect(ALL_TOOLS.length).toBeGreaterThan(0);
+  });
+
+  ALL_TOOLS.forEach(({ entry }: { entry: any }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should have all 15 required locales', () => {
+        const registeredLocales = Object.keys(entry.i18n);
+        EXPECTED_LOCALES.forEach((locale) => {
+          expect(
+            registeredLocales,
+            `Tool "${entry.id}" is missing locale "${locale}"`,
+          ).toContain(locale);
+        });
+      });
+
+      it('all locale loaders should be functions', () => {
+        EXPECTED_LOCALES.forEach((locale) => {
+          const loader = entry.i18n[locale as keyof typeof entry.i18n];
+          expect(
+            typeof loader,
+            `Tool "${entry.id}" locale "${locale}" loader is not a function`,
+          ).toBe('function');
+        });
+      });
+    });
+  });
+});

package/src/tests/locale_completeness.test.ts

@@ -1,20 +1,41 @@
 import { describe, it, expect } from 'vitest';
 import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
 
 describe('Locale Completeness Validation', () => {
   ALL_TOOLS.forEach((tool) => {
     describe(`Tool: ${tool.entry.id}`, () => {
       Object.keys(tool.entry.i18n).forEach((locale) => {
         describe(`Locale: ${locale}`, () => {
-          it('placeholder', () => {
-            expect(true).toBe(true);
+          it('faqTitle should be defined when faq items exist', async () => {
+            const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+            const content = (await loader?.()) as ToolLocaleContent;
+
+            if (content.faq.length > 0) {
+              expect(
+                content.faqTitle,
+                `Tool "${tool.entry.id}" locale "${locale}" has ${content.faq.length} FAQ items but is missing faqTitle`,
+              ).toBeTruthy();
+            }
+          });
+
+          it('bibliographyTitle should be defined when bibliography items exist', async () => {
+            const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+            const content = (await loader?.()) as ToolLocaleContent;
+
+            if (content.bibliography.length > 0) {
+              expect(
+                content.bibliographyTitle,
+                `Tool "${tool.entry.id}" locale "${locale}" has ${content.bibliography.length} bibliography items but is missing bibliographyTitle`,
+              ).toBeTruthy();
+            }
           });
         });
       });
     });
   });
 
-  it('tools are registered', () => {
+  it('all 4 tools registered', () => {
     expect(ALL_TOOLS.length).toBe(4);
   });
 });

package/src/tests/no_h1_in_components.test.ts

@@ -1,8 +1,48 @@
 import { describe, it, expect } from 'vitest';
+import { readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+const EXCLUDED_DIRS = ['node_modules', 'pages', 'layouts'];
+
+function findAstroFiles(dir: string): string[] {
+  const files: string[] = [];
+  const entries = readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory() && !EXCLUDED_DIRS.includes(entry.name)) {
+      files.push(...findAstroFiles(fullPath));
+    } else if (entry.isFile() && entry.name.endsWith('.astro')) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+function hasH1(content: string): boolean {
+  return /<h1[\s>]/i.test(content);
+}
+
+const srcDir = join(process.cwd(), 'src');
+const astroFiles = findAstroFiles(srcDir);
 
 describe('No H1 in Components', () => {
-  it('placeholder', () => {
-    expect(true).toBe(true);
+  if (astroFiles.length === 0) {
+    it('no astro components found', () => {
+      expect(true).toBe(true);
+    });
+  }
+
+  astroFiles.forEach((file) => {
+    const relativePath = file.replace(process.cwd(), '');
+    it(`${relativePath} should not contain <h1>`, () => {
+      const content = readFileSync(file, 'utf-8');
+      expect(
+        hasH1(content),
+        `File "${relativePath}" contains a <h1> element. Use <h2> or lower inside components — h1 belongs to the page layout.`,
+      ).toBe(false);
+    });
   });
 });
 

package/src/tests/schemas_fulfillment.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+describe('Schemas Fulfillment Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      Object.keys(tool.entry.i18n).forEach((locale) => {
+        it(`Locale: ${locale} should have faqSchema, appSchema and howToSchema`, async () => {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          if (!loader) return;
+          const content = (await loader()) as ToolLocaleContent;
+
+          const schemaTypes = content.schemas.map((s: any) => s['@type']);
+
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing FAQPage schema`).toContain('FAQPage');
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing SoftwareApplication schema`).toContain('SoftwareApplication');
+          expect(schemaTypes, `Tool "${tool.entry.id}" locale "${locale}" is missing HowTo schema`).toContain('HowTo');
+        });
+      });
+    });
+  });
+});

package/src/tests/slug_uniqueness.test.ts

@@ -0,0 +1,81 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+import type { ToolLocaleContent } from '../types';
+
+const sharingLocales = ['ja', 'ko', 'zh'];
+
+interface ValidateParams {
+  toolId: string;
+  locale: string;
+  content: ToolLocaleContent;
+  enSlug: string;
+  slugs: Map<string, string>;
+}
+
+const validateLocaleSlug = ({
+  toolId,
+  locale,
+  content,
+  enSlug,
+  slugs,
+}: ValidateParams) => {
+  expect(
+    content.slug,
+    `Tool "${toolId}" locale "${locale}" has an invalid slug ("${content.slug}"). Slugs must be transliterated (only a-z, 0-9, and -).`,
+  ).toMatch(/^[a-z0-9-]+$/);
+
+  if (locale === 'en') {
+    return;
+  }
+
+  if (sharingLocales.includes(locale)) {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" must use the same slug as "en" ("${enSlug}").`,
+    ).toBe(enSlug);
+  } else {
+    expect(
+      content.slug,
+      `Tool "${toolId}" locale "${locale}" has the same slug as "en" ("${enSlug}"). Cada slug tiene que estar en su propia idioma`,
+    ).not.toBe(enSlug);
+
+    if (slugs.has(content.slug)) {
+      const previousLocale = slugs.get(content.slug);
+      expect(
+        false,
+        `Tool "${toolId}" locales "${locale}" and "${previousLocale}" share the same slug ("${content.slug}"). Cada slug tiene que estar en su propia idioma`,
+      ).toBe(true);
+    }
+    slugs.set(content.slug, locale);
+  }
+};
+
+describe('Slug Localization and Uniqueness Validation', () => {
+  ALL_TOOLS.forEach((tool) => {
+    describe(`Tool: ${tool.entry.id}`, () => {
+      it('every locale should have a unique, translated slug', async () => {
+        const slugs = new Map<string, string>();
+        const locales = Object.keys(tool.entry.i18n);
+
+        let enSlug = '';
+        if (locales.includes('en')) {
+          const enLoader = tool.entry.i18n['en' as keyof typeof tool.entry.i18n];
+          const enContent = (await enLoader?.()) as ToolLocaleContent;
+          enSlug = enContent.slug;
+        }
+
+        for (const locale of locales) {
+          const loader = tool.entry.i18n[locale as keyof typeof tool.entry.i18n];
+          const content = (await loader?.()) as ToolLocaleContent;
+          validateLocaleSlug({
+            toolId: tool.entry.id,
+            locale,
+            content,
+            enSlug,
+            slugs,
+          });
+        }
+      });
+    });
+  });
+});

package/src/tests/title_quality.test.ts

@@ -0,0 +1,55 @@
+import { describe, it } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+
+function getFiles(dir: string, ext: string[]): string[] {
+  const results: string[] = [];
+  if (!fs.existsSync(dir)) return results;
+  const list = fs.readdirSync(dir);
+  for (const file of list) {
+    const fullPath = path.join(dir, file);
+    const stat = fs.statSync(fullPath);
+    if (stat && stat.isDirectory()) {
+      results.push(...getFiles(fullPath, ext));
+    } else if (ext.some((e) => file.endsWith(e))) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+const SRC_DIR = path.join(process.cwd(), 'src');
+
+describe('Project Titles - Separator Validation', () => {
+  const files = [
+    ...getFiles(path.join(SRC_DIR, 'tool'), ['.ts']),
+    ...getFiles(path.join(SRC_DIR, 'category'), ['.ts']),
+  ].filter(f => f.includes('i18n'));
+
+  it.each(files)('Verify that titles in %s do not contain | or -', (filePath) => {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const relativePath = path.relative(process.cwd(), filePath);
+
+    const titlePatterns = [
+      /const\s+title\s*=\s*['"]([^'"]+)['"]/g,
+      /title\s*:\s*['"]([^'"]+)['"]/g,
+    ];
+
+    const findings: string[] = [];
+
+    for (const pattern of titlePatterns) {
+      let match;
+      while ((match = pattern.exec(content)) !== null) {
+        const title = match[1];
+        if (title.includes('|') || title.includes('-')) {
+          findings.push(title);
+        }
+      }
+    }
+
+    if (findings.length > 0) {
+      const list = findings.map((f) => `  - "${f}"`).join('\n');
+      throw new Error(`Forbidden separators (| or -) found in titles in ${relativePath}:\n${list}`);
+    }
+  });
+});