@jjlmoya/utils-travel 1.1.0

package/src/tool/luggage-calculator/i18n/fr.ts

@@ -0,0 +1,549 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { LuggageCalculatorUI, LuggageCalculatorLocaleContent } from '../index';
+
+const slug = 'calculateur-bagages-cabine';
+const title = 'Calculateur de Bagages Cabine : Mesures par Compagnie 2026';
+const description = 'Consultez les dimensions et le poids autorisés pour votre bagage cabine et votre accessoire personnel sur toutes les compagnies aériennes. Évitez les surtaxes à l\'aéroport.';
+
+const ui: LuggageCalculatorUI = {
+  title: "Mesures par Compagnie",
+  searchLabel: 'Recherchez votre compagnie',
+  searchPlaceholder: 'Recherchez votre compagnie...',
+  personalItemTitle: 'Petit Sac',
+  cabinBagTitle: 'Valise Cabine',
+  weightLabel: 'Poids Max',
+  noResults: 'Nous n\'avons pas trouvé cette compagnie. Essayez la recherche globale.',
+  modalNoteTitle: 'Note importante :',
+  modalNoteText: 'Certaines compagnies low-cost n\'autorisent la valise cabine que sous le siège si le service "Priorité" n\'a pas été souscrit.',
+  personalItemDetail: 'Sac sous le siège',
+  cabinBagDetail: 'Bagage à main',
+  airlines: [
+    {
+      name: "Ryanair",
+      personal: "40 x 20 x 25 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Vueling",
+      personal: "40 x 20 x 30 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Iberia / Air Nostrum",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 40 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "EasyJet",
+      personal: "45 x 36 x 20 cm",
+      personalWeight: "15 kg",
+      cabin: "56 x 45 x 25 cm",
+      cabinWeight: "15 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Air Europa",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Air France",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "12 kg (total)",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "12 kg (total)",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Lufthansa",
+      personal: "40 x 30 x 10 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "British Airways",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "23 kg",
+      cabin: "56 x 45 x 25 cm",
+      cabinWeight: "23 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "KLM",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "12 kg (total)",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "12 kg (total)",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Swiss",
+      personal: "40 x 30 x 10 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Norwegian",
+      personal: "30 x 20 x 38 cm",
+      personalWeight: "10 kg (total)",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "10 kg (total)",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "TAP Air Portugal",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "2 kg",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Volotea",
+      personal: "40 x 30 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "10 kg (total)",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Emirates",
+      personal: "En cabine",
+      personalWeight: "-",
+      cabin: "55 x 38 x 20 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Qatar Airways",
+      personal: "En cabine",
+      personalWeight: "-",
+      cabin: "50 x 37 x 25 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Turkish Airlines",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "4 kg",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "American Airlines",
+      personal: "45 x 35 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "Sans limite",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Delta Air Lines",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "56 x 35 x 23 cm",
+      cabinWeight: "Sans limite",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "United Airlines",
+      personal: "43 x 25 x 22 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 35 x 22 cm",
+      cabinWeight: "Sans limite",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Southwest Airlines",
+      personal: "47 x 34 x 21 cm",
+      personalWeight: "Sans limite",
+      cabin: "61 x 40 x 25 cm",
+      cabinWeight: "Sans limite",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "JetBlue",
+      personal: "43 x 33 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 35 x 23 cm",
+      cabinWeight: "Sans limite",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Air Canada",
+      personal: "43 x 33 x 16 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Avianca",
+      personal: "45 x 35 x 25 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "LATAM",
+      personal: "45 x 35 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Aerolineas Argentinas",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Japan Airlines (JAL)",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Singapore Airlines",
+      personal: "Sous le siège",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Qantas",
+      personal: "Sous le siège",
+      personalWeight: "Sans limite",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Finnair",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "ITA Airways",
+      personal: "45 x 36 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Air New Zealand",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Cathay Pacific",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Eva Air",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Thai Airways",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "56 x 45 x 25 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "ANA (All Nippon Airways)",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "55 x 40 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Korean Air",
+      personal: "40 x 30 x 15 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Aeroméxico",
+      personal: "45 x 35 x 20 cm",
+      personalWeight: "Sans limite",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Copa Airlines",
+      personal: "43 x 25 x 22 cm",
+      personalWeight: "Sans limite",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "10 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Air India",
+      personal: "Dimensions personnelles",
+      personalWeight: "-",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "8 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Ethiopian Airlines",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "55 x 40 x 23 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Kenya Airways",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "55 x 35 x 25 cm",
+      cabinWeight: "12 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Jetstar",
+      personal: "Sous le siège",
+      personalWeight: "7 kg (total)",
+      cabin: "56 x 36 x 23 cm",
+      cabinWeight: "7 kg (total)",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "Lion Air",
+      personal: "Dimensions réduites",
+      personalWeight: "-",
+      cabin: "40 x 30 x 20 cm",
+      cabinWeight: "7 kg",
+      icon: "mdi:airplane",
+    },
+    {
+      name: "China Southern Airlines",
+      personal: "Sous le siège",
+      personalWeight: "-",
+      cabin: "55 x 40 x 20 cm",
+      cabinWeight: "5 kg",
+      icon: "mdi:airplane",
+    },
+  ],
+
+};
+
+const faq: LuggageCalculatorLocaleContent['faq'] = [
+  {
+    question: "Que se passe-t-il si ma valise dépasse les mesures de 1 ou 2 cm ?",
+    answer: "Cela dépend de la compagnie et du personnel de porte. Les compagnies low-cost utilisent souvent un gabarit métallique ; si la valise n'y entre pas librement, vous devrez payer un supplément en porte, généralement entre 45€ et 65€.",
+  },
+  {
+    question: "Puis-je emporter un sac à dos et une valise cabine gratuitement ?",
+    answer: "Sur des compagnies comme Air France ou Lufthansa, oui. Sur des compagnies comme Ryanair ou Vueling (tarif de base), vous ne pouvez emporter qu'un petit sac sous le siège.",
+  },
+];
+
+const howTo: LuggageCalculatorLocaleContent['howTo'] = [
+  {
+    name: "Recherchez votre compagnie",
+    text: "Utilisez notre moteur de recherche pour voir les limites spécifiques de votre transporteur.",
+  },
+];
+
+const bibliography: LuggageCalculatorLocaleContent['bibliography'] = [
+  {
+    name: "AENA: Pasajeros y Equipajes",
+    url: "https://www.aena.es/es/pasajeros/pasajeros.html",
+  },
+  {
+    name: "Droits des Passagers Aériens - UE",
+    url: "https://europa.eu/youreurope/citizens/travel/passenger-rights/air/index_es.htm",
+  },
+  {
+    name: "IATA: Passenger Baggage Rules",
+    url: "https://www.iata.org/en/programs/ops-infra/baggage/passenger-baggage-rules/",
+  },
+];
+
+const seo: LuggageCalculatorLocaleContent['seo'] = [
+    {
+        type: "title",
+        text: "Guide Complet des Dimensions des Bagages Cabine 2026",
+        level: 2,
+    },
+    {
+        type: "summary",
+        title: "Tout ce qu'il faut savoir avant de s'envoler",
+        items: [
+            "Guide actualisé des dimensions pour l'accessoire personnel et la valise cabine.",
+            "Comparaison des poids autorisés par compagnie (de 7kg à 23kg).",
+            "Différence entre article personnel, bagage à main et bagage enregistré.",
+            "Conseils pour éviter les suppléments à la porte d'embarquement.",
+        ],
+    },
+    {
+        type: "paragraph",
+        html: "Voyager aujourd'hui est devenu un véritable puzzle logistique. Ce qui était autrefois un standard universel (le sac de 10 kg) est devenu une jungle de mesures qui varient de quelques centimètres d'une compagnie à l'autre. Notre <strong>calculateur de bagages</strong> est né pour répondre à la question la plus répétée dans les aéroports : \"Vais-je payer un supplément pour ce sac ?\".",
+    },
+    {
+        type: "title",
+        text: "Article Personnel vs. Bagage Cabine",
+        level: 3,
+    },
+    {
+        type: "paragraph",
+        html: "Comprendre la hiérarchie moderne des bagages est vital. Depuis que le modèle *Low Cost* s'est imposé, la plupart des compagnies ont fragmenté ce que vous pouvez emporter dans l'avion. L'<strong>article personnel</strong> (petit sac à dos, sac à main ou sac d'ordinateur) est généralement le seul qui soit gratuit sur les tarifs de base, tandis que le <strong>bagage cabine</strong> (le trolley traditionnel) nécessite souvent un supplément.",
+    },
+    {
+        type: "comparative",
+        items: [
+            {
+                title: "Compagnies Low Cost",
+                description: "Règles strictes, n'autorisant généralement qu'un petit sac sous le siège gratuitement.",
+                icon: "mdi:tag-outline",
+                points: [
+                    "Ryanair/Vueling : Bagage cabine payant",
+                    "Dimensions surveillées avec gabarit",
+                    "Poids maximum entre 8kg et 10kg",
+                    "Suppléments élevés si vous dépassez la taille",
+                ],
+            },
+            {
+                title: "Compagnies Traditionnelles",
+                description: "Politiques plus flexibles, incluant généralement un bagage cabine dans presque tous les tarifs.",
+                icon: "mdi:airplane-takeoff",
+                highlight: true,
+                points: [
+                    "Air France/Lufthansa : Bagage cabine inclus",
+                    "Limites de poids plus élevées (jusqu'à 23kg chez BA)",
+                    "Combinaison article personnel + bagage",
+                    "Service d'enregistrement gratuit en porte si le vol est complet",
+                ],
+            },
+        ],
+    },
+    {
+        type: "title",
+        text: "Dimensions par Compagnie : Tableau Récapitulatif",
+        level: 3,
+    },
+    {
+        type: "table",
+        headers: ["Compagnie", "Petit Sac (Sous le siège)", "Bagage Cabine (Main)"],
+        rows: [
+            ["<strong>Ryanair</strong>", "40 x 20 x 25 cm", "55 x 40 x 20 cm (Payant)"],
+            ["<strong>Vueling</strong>", "40 x 20 x 30 cm", "55 x 40 x 20 cm (Payant)"],
+            ["<strong>Iberia</strong>", "40 x 30 x 15 cm", "56 x 40 x 25 cm (Gratuit)"],
+            ["<strong>Air France</strong>", "40 x 30 x 15 cm", "55 x 35 x 25 cm (Gratuit)"],
+            ["<strong>EasyJet</strong>", "45 x 36 x 20 cm", "56 x 45 x 25 cm (Priorité)"],
+            ["<strong>Lufthansa</strong>", "40 x 30 x 10 cm", "55 x 40 x 23 cm (Gratuit)"],
+            ["<strong>American Airlines</strong>", "45 x 35 x 20 cm", "56 x 36 x 23 cm (Gratuit)"],
+            ["<strong>Emirates</strong>", "40 x 30 x 15 cm", "55 x 38 x 20 cm (Gratuit)"],
+            ["<strong>Qatar Airways</strong>", "Sous le siège", "50 x 37 x 25 cm (Gratuit)"],
+        ],
+    },
+    {
+        type: "tip",
+        title: "L'Astuce du Poids",
+        html: "<p>De nombreuses compagnies comme Emirates ou Qatar sont très strictes sur le poids (7kg) mais plus détendues sur les mesures. D'autres comme British Airways autorisent jusqu'à 23kg tant que vous pouvez soulever le bagage vous-même. Pesez-le toujours chez vous !</p>",
+    },
+    {
+        type: "title",
+        text: "Conclusion : Voyagez sans Stress",
+        level: 3,
+    },
+    {
+        type: "paragraph",
+        html: "Vérifier les mesures de vos bagages avant de partir pour l'aéroport vous fera économiser non seulement de l'argent (les frais de porte dépassent souvent 50€), mais aussi le stress de commencer vos vacances par une dispute au comptoir.",
+    },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.map((item: any) => ({
+    '@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: howTo.map((step: any) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilitiesApplication',
+  operatingSystem: 'Web',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: LuggageCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: "Questions Fréquentes",
+  bibliography,
+  bibliographyTitle: "Sources et Références",
+  howTo,
+  howToTitle: "Comment utiliser le calculateur",
+  schemas: [faqSchema, howToSchema, appSchema],
+};

package/src/tool/luggage-calculator/index.ts

@@ -0,0 +1,53 @@
+import type { TravelToolEntry, ToolDefinition, ToolLocaleContent } from '../../types';
+import LuggageCalculator from './component.astro';
+import LuggageCalculatorSEO from './seo.astro';
+import LuggageCalculatorBibliography from './bibliography.astro';
+
+export interface Airline {
+  name: string;
+  personal: string;
+  personalWeight: string;
+  cabin: string;
+  cabinWeight: string;
+  icon: string;
+}
+
+export interface LuggageCalculatorUI {
+  [key: string]: unknown;
+  title: string;
+  searchLabel: string;
+  searchPlaceholder: string;
+  personalItemTitle: string;
+  cabinBagTitle: string;
+  weightLabel: string;
+  noResults: string;
+  modalNoteTitle: string;
+  modalNoteText: string;
+  personalItemDetail: string;
+  cabinBagDetail: string;
+  airlines: Airline[];
+}
+
+export type LuggageCalculatorLocaleContent = ToolLocaleContent<LuggageCalculatorUI>;
+
+export const luggageCalculator: TravelToolEntry<LuggageCalculatorUI> = {
+  id: 'luggage-calculator',
+  icons: {
+    bg: 'mdi:bag-suitcase',
+    fg: 'mdi:airplane',
+  },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+  },
+};
+
+export { LuggageCalculator, LuggageCalculatorSEO, LuggageCalculatorBibliography };
+
+export const LUGGAGE_CALCULATOR_TOOL: ToolDefinition = {
+  entry: luggageCalculator,
+  Component: LuggageCalculator,
+  SEOComponent: LuggageCalculatorSEO,
+  BibliographyComponent: LuggageCalculatorBibliography,
+};

package/src/tool/luggage-calculator/seo.astro

@@ -0,0 +1,14 @@
+---
+import { SEORenderer } from "@jjlmoya/utils-shared";
+import { luggageCalculator } from "./index";
+import type { KnownLocale } from "../../types";
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = "es" } = Astro.props;
+const content = await luggageCalculator.i18n[locale]?.();
+---
+
+{content && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/mini-adventures/bibliography.astro

@@ -0,0 +1,14 @@
+---
+import { Bibliography as SharedBibliography } from "@jjlmoya/utils-shared";
+import { miniAdventures } from "./index";
+import type { KnownLocale } from "../../types";
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = "es" } = Astro.props;
+const content = await miniAdventures.i18n[locale]?.();
+---
+
+{content && <SharedBibliography links={content.bibliography} />}