@autobusal/routes-order 1.21.1 → 1.22.0

package/CHANGELOG.md

@@ -6,6 +6,25 @@ All notable changes to this package are documented here. This project follows
 > Note: 1.8.0 was published without a changelog entry. The gap is left as-is
 > rather than reconstructed after the fact.
 
+## 1.22.0
+
+Structured data on route-pair pages: `BusTrip` with its operators and
+fares-from, and a `FAQPage` answering the five things people actually search
+for — how long, how much, how many a day, when the first and last leave, and
+who runs it.
+
+One rule governs all of it: **never state anything the page does not show.**
+Every value is the same one rendered in the facts block or the timetable a few
+hundred pixels below. A rich result built on a claim a visitor cannot find is
+the mismatch that gets a site's snippets pulled, and it is also just a lie told
+to a machine.
+
+The rating hangs off the **provider**, not the trip. An operator's rating is
+earned across everything they run; attaching it to one city pair would claim
+travellers rated this journey when they rated the company. Operators below the
+review display threshold carry no rating in the markup, exactly as they carry
+none on the page.
+
 ## 1.21.1
 
 No horizontal scroll on a tablet's date strip. The 900px floor belongs to the

package/Facts/types.ts

@@ -6,6 +6,9 @@ export interface FactsData {
   // formatted by the API with the brand's own currency - the PUBLIC settings
   // payload carries no currency, so a frontend has nothing to format with
   price_from_display: string | null
+  // ISO 4217, for schema.org's Offer - the display string has the symbol
+  // baked in and guessing a code back out of it would be confidently wrong
+  currency: string | null
   // both ends of the range, in minutes
   duration_min: number | null
   duration_max: number | null

package/Sections/Schema.tsx

@@ -0,0 +1,148 @@
+import { TFunction } from 'i18next';
+import { JsonLd } from '@autobusal/common';
+import { FactsData } from '../Facts/types';
+
+interface Props {
+  facts: FactsData
+  t: TFunction<'common'>
+}
+
+/**
+ * Structured data for a route-pair page.
+ *
+ * Edited: Ferjolt Ozuni - Date: 2026-08-03
+ *
+ * Roadmap Tier 3.5, and the cheapest item in the tier because the page
+ * already computes everything it needs.
+ *
+ * ONE RULE GOVERNS ALL OF IT: never state something here that the page does
+ * not show. A rich result built on a claim a visitor cannot find is the
+ * mismatch that gets a site's snippets pulled, and it is also just a lie
+ * told to a machine. Every value below is the same value rendered in the
+ * facts block or the timetable a few hundred pixels down - the duration
+ * range, the fares-from, the departure count, the operators.
+ *
+ * The rating hangs off the PROVIDER, not the trip. An operator's rating is
+ * earned across everything they run; attaching it to one city pair would be
+ * claiming travellers rated this journey when they rated the company. When
+ * an operator has no published rating - below the display threshold - it is
+ * simply absent, exactly as it is on the page.
+ */
+const Schema = ({ facts, t }: Props): (JSX.Element | null) => {
+  const schedule = facts.schedule ?? [];
+
+  // Deduplicated operators, each keeping whatever rating it actually has.
+  const providers = schedule.reduce<{ name: string, rating: { average: number, count: number } | null }[]>((all, row) => {
+    if (!row.operator || all.some(item => item.name === row.operator)) {
+      return all;
+    }
+
+    return [ ...all, { name: row.operator, rating: row.rating } ];
+  }, []);
+
+  const organisation = (name: string, rating: { average: number, count: number } | null) => ({
+    '@type': 'Organization',
+    name,
+    ...(rating ? {
+      aggregateRating: {
+        '@type': 'AggregateRating',
+        ratingValue: rating.average,
+        reviewCount: rating.count,
+        bestRating: 5,
+        worstRating: 1
+      }
+    } : {})
+  });
+
+  const trip = {
+    '@context': 'https://schema.org',
+    '@type': 'BusTrip',
+    name: t('routes_order.facts.title', { from: facts.from, to: facts.to }),
+
+    departureBusStop: { '@type': 'BusStop', name: facts.from },
+    arrivalBusStop: { '@type': 'BusStop', name: facts.to },
+
+    ...(providers.length > 0 ? {
+      provider: providers.map(item => organisation(item.name, item.rating))
+    } : {}),
+
+    // Only with a real ISO 4217 code. `price_from_display` is a formatted
+    // string with the symbol baked in, and guessing a code from it would
+    // produce structured data that is confidently wrong.
+    ...(facts.price_from !== null && facts.currency ? {
+      offers: {
+        '@type': 'Offer',
+        price: facts.price_from,
+        priceCurrency: facts.currency,
+        availability: 'https://schema.org/InStock'
+      }
+    } : {})
+  };
+
+  const questions: { q: string, a: string }[] = [];
+
+  const duration = (minutes: number): string => (
+    minutes % 60 === 0
+      ? t('routes_order.facts.duration_hours', { hours: minutes / 60 })
+      : t('routes_order.facts.duration_value', { hours: Math.floor(minutes / 60), minutes: minutes % 60 })
+  );
+
+  if (facts.duration_min !== null && facts.duration_max !== null) {
+    questions.push({
+      q: t('routes_order.schema.duration_q', { from: facts.from, to: facts.to }),
+      a: facts.duration_min === facts.duration_max
+        ? t('routes_order.schema.duration_a', { from: facts.from, to: facts.to, duration: duration(facts.duration_min) })
+        : t('routes_order.schema.duration_a_range', { from: facts.from, to: facts.to, min: duration(facts.duration_min), max: duration(facts.duration_max) })
+    });
+  }
+
+  if (facts.price_from_display) {
+    questions.push({
+      q: t('routes_order.schema.price_q', { from: facts.from, to: facts.to }),
+      a: t('routes_order.schema.price_a', { from: facts.from, to: facts.to, price: facts.price_from_display })
+    });
+  }
+
+  if (facts.departures > 0) {
+    questions.push({
+      q: t('routes_order.schema.departures_q', { from: facts.from, to: facts.to }),
+      a: t('routes_order.schema.departures_a', { count: facts.departures, from: facts.from, to: facts.to })
+    });
+  }
+
+  if (facts.departure_first && facts.departure_last) {
+    questions.push({
+      q: t('routes_order.schema.times_q', { from: facts.from, to: facts.to }),
+      a: t('routes_order.schema.times_a', { first: facts.departure_first, last: facts.departure_last })
+    });
+  }
+
+  if (facts.operators.length > 0) {
+    questions.push({
+      q: t('routes_order.schema.operators_q', { from: facts.from, to: facts.to }),
+      a: t('routes_order.facts.operators', { operators: facts.operators.join(', ') })
+    });
+  }
+
+  // Google requires a FAQPage to carry at least one question, and a page
+  // claiming to be an FAQ with nothing on it is worse than not claiming it.
+  const faq = questions.length > 0 ? {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: questions.map(item => ({
+      '@type': 'Question',
+      name: item.q,
+      acceptedAnswer: { '@type': 'Answer', text: item.a }
+    }))
+  } : null;
+
+  return (
+    <>
+      <JsonLd data={ trip } />
+
+      { faq && <JsonLd data={ faq } /> }
+    </>
+  );
+};
+
+export default Schema;

package/Sections/Sections.tsx

@@ -2,6 +2,7 @@ import { TFunction } from 'i18next';
 import Facts from '../Facts/Facts';
 import Schedule from '../Schedule/Schedule';
 import Links from '../Links/Links';
+import Schema from './Schema';
 import { useGetFacts } from '../Facts/services';
 import { Nav, Anchor, Anchored } from './styles';
 
@@ -64,6 +65,11 @@ const Sections = ({ from, to, t }: Props): (JSX.Element | null) => {
         ) }
       </Nav>
 
+      { /* Edited: Ferjolt Ozuni - Date: 2026-08-03
+           Roadmap Tier 3.5. Emits nothing the sections below do not also
+           show - same facts, same numbers, same operators. */ }
+      <Schema facts={ facts } t={ t } />
+
       <Anchored>
         <Facts id={ FACTS } facts={ facts } t={ t } />
       </Anchored>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/routes-order",
-  "version": "1.21.1",
+  "version": "1.22.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts"