@jjlmoya/utils-travel 1.1.0

package/src/tool/tip-calculator/i18n/en.ts

@@ -0,0 +1,264 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { TipCalculatorUI } from '../index';
+
+const slug = 'international-tip-calculator';
+const title = 'International Tip Calculator';
+const description = 'Calculate how much to tip on your trips. Includes percentage guide and etiquette rules for more than 50 countries. Don\'t mess up when paying!';
+
+const ui: TipCalculatorUI = {
+  title: "Tip Calculator",
+  badge: "International Tip Tool",
+  billLabel: "Bill Amount",
+  countryLabel: "Country / Local Custom",
+  tipLabel: "Tip Percentage",
+  splitLabel: "Split Bill",
+  summaryTip: "Total Tip",
+  summarySubtotal: "Subtotal",
+  summaryTotalPerson: "Total per Person",
+  protocolTitle: "Protocol",
+  placeholderAmount: "0.00",
+  placeholderFilter: "Search country...",
+  placeholderSelect: "Select a country",
+  countries: [
+    {
+      id: "usa",
+      name: "USA & Canada",
+      min: 18,
+      max: 25,
+      default: 20,
+      culture: "Tipping is essential for waiter salaries. Between 18% and 25% is expected. Not leaving it is considered a serious breach of North American culture.",
+    },
+    {
+      id: "esp",
+      name: "Spain",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "Optional. It is common to round up the change or leave 5-10% on dinners if the service has been of quality.",
+    },
+    {
+      id: "jpn",
+      name: "Japan",
+      min: 0,
+      max: 0,
+      default: 0,
+      culture: "No tipping. It is considered an insult to professionalism. If you leave money, they will likely follow you to return it.",
+    },
+    {
+      id: "ita",
+      name: "Italy",
+      min: 0,
+      max: 10,
+      default: 0,
+      culture: "The 'coperto' is a charge for table service, bread, and cover, it is not the tip itself. Leaving an extra 5-10% is an appreciated but entirely optional gesture.",
+    },
+    {
+      id: "fra",
+      name: "France",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "Service is included by law. Leave the 'pourboire' (small extra) only for exceptional treatment.",
+    },
+    {
+      id: "gbr",
+      name: "United Kingdom",
+      min: 0,
+      max: 12.5,
+      default: 10,
+      culture: "An optional 12.5% is often added to the bill. If it's not there, 10% is the standard in restaurants.",
+    },
+    {
+      id: "mex",
+      name: "Mexico",
+      min: 10,
+      max: 15,
+      default: 12,
+      culture: "A 10-15% 'propina' is expected. It is a vital part of the economy for workers in the sector.",
+    },
+    {
+      id: "arg",
+      name: "Argentina",
+      min: 0,
+      max: 10,
+      default: 10,
+      culture: "The standard is 10%. It is almost always left if the service has been normal or good.",
+    },
+    {
+      id: "bra",
+      name: "Brazil",
+      min: 0,
+      max: 10,
+      default: 10,
+      culture: "Normally a 10% charge is included in the bill as 'Serviço'. It is optional but most pay it.",
+    },
+    {
+      id: "deu",
+      name: "Germany",
+      min: 5,
+      max: 10,
+      default: 7,
+      culture: "It is common to round up or add 5-10%. Tell the waiter the total including the tip when paying.",
+    },
+    {
+      id: "tur",
+      name: "Turkey",
+      min: 5,
+      max: 10,
+      default: 10,
+      culture: "In tourist areas, 10% in cash is expected. It can't usually be added to the credit card.",
+    },
+    {
+      id: "aus",
+      name: "Australia",
+      min: 0,
+      max: 10,
+      default: 0,
+      culture: "Not expected. Salaries are high. In fine dining, 10% can be left.",
+    },
+    {
+      id: "chn",
+      name: "China",
+      min: 0,
+      max: 0,
+      default: 0,
+      culture: "Historically, no tipping is left and in many places it is prohibited or considered strange.",
+    },
+    {
+      id: "prt",
+      name: "Portugal",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "It is customary to leave the change or round up. In tourist areas, 5-10% is common.",
+    },
+    {
+      id: "grc",
+      name: "Greece",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "It is usually enough to round up the bill. An extra 5-10% is much appreciated but not mandatory.",
+    },
+  ]
+};
+
+const seo: ToolLocaleContent<TipCalculatorUI>['seo'] = [
+  {
+    type: "title",
+    text: "International Tipping Guide: Etiquette and Percentages 2026",
+    level: 2,
+  },
+  {
+    type: "summary",
+    title: "Learn to tip like a local anywhere in the world",
+    items: [
+      "Complete guide on the expected tip percentage in major tourist destinations.",
+      "How to quickly calculate the tip starting from the subtotal or the total including taxes.",
+      "Difference between service charges, cover (coperto), and voluntary tipping.",
+      "Etiquette rules for special situations: taxis, hotels, and tour guides.",
+    ],
+  },
+  {
+    type: "paragraph",
+    html: "One of the most stressful moments of any international trip occurs when the bill arrives at the table. Our <strong>international tip calculator</strong> is designed to eliminate that uncertainty.",
+  }
+];
+
+const faq: ToolLocaleContent<TipCalculatorUI>['faq'] = [
+  {
+    question: "Is it mandatory to leave a tip in the United States?",
+    answer: "Legally no, but socially it is mandatory. Waiters depend on tips to reach minimum wage. It is normal to leave between 18% and 25%.",
+  },
+  {
+    question: "In which countries is it offensive to leave a tip?",
+    answer: "Mainly in Japan and South Korea. Good service is considered part of the duty and does not require extra compensation.",
+  },
+  {
+    question: "Should I tip if the service was bad?",
+    answer: "In countries where it is optional (Europe, Australia), the most correct thing is to leave nothing.",
+  },
+  {
+    question: "Is the tip calculated before or after taxes?",
+    answer: "In North America it is usually calculated on the subtotal (before taxes). In Europe and Latin America, it is always calculated on the total of the bill.",
+  },
+];
+
+const bibliography: ToolLocaleContent<TipCalculatorUI>['bibliography'] = [
+  {
+    name: "Condé Nast Traveler: Tipping Etiquette Guide",
+    url: "https://www.cntraveler.com/stories/2008-11-11/etiquette-101-tipping-guide",
+  },
+  {
+    name: "Lonely Planet: Tipping and Etiquette in Europe",
+    url: "https://www.lonelyplanet.com/articles/tipping-customs-europe",
+  },
+  {
+    name: "Western Union: Global Tipping Guide",
+    url: "https://www.westernunion.com/blog/en/global-tipping-guide/",
+  },
+];
+
+const howTo: ToolLocaleContent<TipCalculatorUI>['howTo'] = [
+  {
+    name: "Enter the bill total",
+    text: "Type the total amount that appears on your invoice before applying the tip.",
+  },
+  {
+    name: "Select the country",
+    text: "Choose your destination to automatically load the cultural recommendation and standard percentage.",
+  },
+  {
+    name: "Adjust and split",
+    text: "If there are several of you, indicate the number of people to know how much each should pay including the tip.",
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: description,
+  step: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description: description,
+  applicationCategory: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
+  inLanguage: 'en',
+};
+
+export const content: ToolLocaleContent<TipCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: "Frequently Asked Questions",
+  bibliography,
+  bibliographyTitle: "Sources and References",
+  howTo,
+  howToTitle: "How to use the calculator",
+  schemas: [faqSchema, howToSchema, appSchema],
+};

package/src/tool/tip-calculator/i18n/es.ts

@@ -0,0 +1,264 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { TipCalculatorUI } from '../index';
+
+const slug = 'calculadora-propinas-internacional';
+const title = 'Calculadora de Propinas Internacional';
+const description = 'Viaja con confianza sabiendo exactamente cuánto dejar de propina. Guía actualizada de etiqueta y porcentajes recomendados para restaurantes, taxis y hoteles en todo el mundo.';
+
+const ui: TipCalculatorUI = {
+  title: "Calculadora de Propinas",
+  badge: "International Tip Tool",
+  billLabel: "Importe de la Factura",
+  countryLabel: "País / Costumbre Local",
+  tipLabel: "Porcentaje Propina",
+  splitLabel: "Dividir Cuenta",
+  summaryTip: "Propina Total",
+  summarySubtotal: "Subtotal",
+  summaryTotalPerson: "Total por Persona",
+  protocolTitle: "Protocolo",
+  placeholderAmount: "0.00",
+  placeholderFilter: "Buscar país...",
+  placeholderSelect: "Selecciona un país",
+  countries: [
+    {
+      id: "usa",
+      name: "EE.UU. y Canadá",
+      min: 18,
+      max: 25,
+      default: 20,
+      culture: "La propina es fundamental para el salario de los camareros. Se espera entre un 18% y 25%. No dejarla se considera una falta grave en la cultura norteamericana.",
+    },
+    {
+      id: "esp",
+      name: "España",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "Opcional. Se suele redondear el cambio o dejar un 5-10% en cenas si el servicio ha sido de calidad.",
+    },
+    {
+      id: "jpn",
+      name: "Japón",
+      min: 0,
+      max: 0,
+      default: 0,
+      culture: "No se deja propina. Se considera un insulto a la profesionalidad. Si dejas dinero, es probable que te sigan para devolvértelo.",
+    },
+    {
+      id: "ita",
+      name: "Italia",
+      min: 0,
+      max: 10,
+      default: 0,
+      culture: "El 'coperto' es un cargo por el servicio de mesa, pan y mantel, no es la propina en sí. Dejar un extra del 5-10% es un gesto apreciado pero totalmente opcional.",
+    },
+    {
+      id: "fra",
+      name: "Francia",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "El servicio está incluido por ley. Se deja el 'pourboire' (pequeño extra) solo por un trato excepcional.",
+    },
+    {
+      id: "gbr",
+      name: "Reino Unido",
+      min: 0,
+      max: 12.5,
+      default: 10,
+      culture: "A menudo se añade un 12.5% opcional en la factura. Si no está, un 10% es lo estándar en restaurantes.",
+    },
+    {
+      id: "mex",
+      name: "México",
+      min: 10,
+      max: 15,
+      default: 12,
+      culture: "Se espera 'la propina' del 10 al 15%. Es una parte vital de la economía de los trabajadores del sector.",
+    },
+    {
+      id: "arg",
+      name: "Argentina",
+      min: 0,
+      max: 10,
+      default: 10,
+      culture: "El estándar es un 10%. Casi siempre se deja si el servicio ha sido normal o bueno.",
+    },
+    {
+      id: "bra",
+      name: "Brasil",
+      min: 0,
+      max: 10,
+      default: 10,
+      culture: "Normalmente se incluye un cargo del 10% en la cuenta como 'Serviço'. Es opcional pero la mayoría lo paga.",
+    },
+    {
+      id: "deu",
+      name: "Alemania",
+      min: 5,
+      max: 10,
+      default: 7,
+      culture: "Se suele redondear o añadir un 5-10%. Se le dice al camarero el total incluyendo propina al pagar.",
+    },
+    {
+      id: "tur",
+      name: "Turquía",
+      min: 5,
+      max: 10,
+      default: 10,
+      culture: "En sitios turísticos se espera un 10% en efectivo. No se suele poder añadir a la tarjeta.",
+    },
+    {
+      id: "aus",
+      name: "Australia",
+      min: 0,
+      max: 10,
+      default: 0,
+      culture: "No es esperada. Los salarios son altos. En cenas de lujo se puede dejar un 10%.",
+    },
+    {
+      id: "chn",
+      name: "China",
+      min: 0,
+      max: 0,
+      default: 0,
+      culture: "Históricamente no se deja propina y en muchos sitios está prohibido o se considera raro.",
+    },
+    {
+      id: "prt",
+      name: "Portugal",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "Se acostumbra dejar el cambio o redondear. En zonas turísticas un 5-10% es común.",
+    },
+    {
+      id: "grc",
+      name: "Grecia",
+      min: 0,
+      max: 10,
+      default: 5,
+      culture: "Suele bastar con redondear la cuenta. Un 5-10% extra es muy apreciado pero no obligatorio.",
+    },
+  ]
+};
+
+const seo: ToolLocaleContent<TipCalculatorUI>['seo'] = [
+  {
+    type: "title",
+    text: "Guía Internacional de Propinas: Etiqueta y Porcentajes 2026",
+    level: 2,
+  },
+  {
+    type: "summary",
+    title: "Aprende a dar propina como un local en cualquier parte del mundo",
+    items: [
+      "Guía completa sobre el porcentaje de propina esperado en los principales destinos turísticos.",
+      "Cómo calcular la propina de forma rápida partiendo del subtotal o del total con impuestos.",
+      "Diferencia entre cargos por servicio, cubierto (coperto) y propina voluntaria.",
+      "Reglas de etiqueta para situaciones especiales: taxis, hoteles y guías turísticos.",
+    ],
+  },
+  {
+    type: "paragraph",
+    html: "Uno de los momentos más estresantes de cualquier viaje internacional ocurre cuando llega la cuenta a la mesa. ¿Debo dejar dinero extra? ¿Cuánto es lo normal? ¿Se ofenderán si dejo poco o si dejo demasiado? Nuestra <strong>calculadora de propina internacional</strong> está diseñada para eliminar esa incertidumbre.",
+  }
+];
+
+const faq: ToolLocaleContent<TipCalculatorUI>['faq'] = [
+  {
+    question: "¿Es obligatorio dejar propina en Estados Unidos?",
+    answer: "Legalmente no, pero socialmente es obligatorio. Los camareros dependen de las propinas para alcanzar el salario mínimo. Lo normal es dejar entre el 18% y el 25%.",
+  },
+  {
+    question: "¿En qué países es ofensivo dejar propina?",
+    answer: "Principalmente en Japón y Corea del Sur. Se considera que el buen servicio es parte del deber y no requiere compensación extra.",
+  },
+  {
+    question: "¿Debo dar propina si el servicio fue malo?",
+    answer: "En países donde es opcional (Europa, Australia), lo más correcto es no dejar nada para señalar tu disconformidad.",
+  },
+  {
+    question: "¿La propina se calcula antes o después de impuestos?",
+    answer: "En Norteamérica se suele calcular sobre el subtotal (antes de impuestos). En Europa y Latinoamérica, se calcula siempre sobre el total de la factura.",
+  },
+];
+
+const bibliography: ToolLocaleContent<TipCalculatorUI>['bibliography'] = [
+  {
+    name: "Condé Nast Traveler: Tipping Etiquette Guide",
+    url: "https://www.cntraveler.com/stories/2008-11-11/etiquette-101-tipping-guide",
+  },
+  {
+    name: "Lonely Planet: Tipping and Etiquette in Europe",
+    url: "https://www.lonelyplanet.com/articles/tipping-customs-europe",
+  },
+  {
+    name: "Western Union: Global Tipping Guide",
+    url: "https://www.westernunion.com/blog/en/global-tipping-guide/",
+  },
+];
+
+const howTo: ToolLocaleContent<TipCalculatorUI>['howTo'] = [
+  {
+    name: "Introduce el total de la cuenta",
+    text: "Escribe el importe total que aparece en tu factura antes de aplicar la propina.",
+  },
+  {
+    name: "Selecciona el país",
+    text: "Elige tu destino para cargar automáticamente la recomendación cultural y el porcentaje estándar.",
+  },
+  {
+    name: "Ajusta y divide",
+    text: "Si sois varios, indica el número de personas para saber cuánto debe pagar cada uno incluyendo la propina.",
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faq.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: description,
+  step: howTo.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description: description,
+  applicationCategory: 'FinanceApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'es',
+};
+
+export const content: ToolLocaleContent<TipCalculatorUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  faqTitle: "Preguntas Frecuentes",
+  bibliography,
+  bibliographyTitle: "Fuentes y Referencias",
+  howTo,
+  howToTitle: "Cómo usar la calculadora",
+  schemas: [faqSchema, howToSchema, appSchema],
+};