gtfs-to-html 2.10.17 → 2.11.0

package/dist/app/index.js

@@ -12,7 +12,6 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { openDb as openDb2 } from "gtfs";
 import express from "express";
-import untildify2 from "untildify";
 
 // src/lib/formatters.ts
 import {
@@ -40,16 +39,7 @@ function fromGTFSTime(timeString) {
 function toGTFSTime(time) {
   return time.format("HH:mm:ss");
 }
-function fromGTFSDate(gtfsDate) {
-  return moment(gtfsDate, "YYYYMMDD");
-}
-function toGTFSDate(date) {
-  return moment(date).format("YYYYMMDD");
-}
 function calendarToCalendarCode(c) {
-  if (c.service_id) {
-    return c.service_id;
-  }
   return `${c.monday}${c.tuesday}${c.wednesday}${c.thursday}${c.friday}${c.saturday}${c.sunday}`;
 }
 function calendarCodeToCalendar(code) {
@@ -90,20 +80,20 @@ import {
   find,
   findLast,
   first,
-  flatMap as flatMap2,
-  flattenDeep,
+  flatMap,
   flow,
   groupBy,
   head,
   last,
   maxBy,
+  orderBy,
   partialRight,
   reduce,
   size,
   some,
   sortBy,
   uniq,
-  uniqBy,
+  uniqBy as uniqBy2,
   zip
 } from "lodash-es";
 import {
@@ -141,14 +131,15 @@ import {
   readFile,
   rm
 } from "fs/promises";
+import { homedir } from "os";
 import * as _ from "lodash-es";
+import { uniqBy } from "lodash-es";
 import archiver from "archiver";
 import beautify from "js-beautify";
 import sanitizeHtml from "sanitize-html";
 import { renderFile } from "pug";
 import puppeteer from "puppeteer";
 import sanitize from "sanitize-filename";
-import untildify from "untildify";
 import { marked } from "marked";
 
 // src/lib/template-functions.ts
@@ -266,6 +257,7 @@ function formatTripNameForCSV(trip, timetable) {
 }
 
 // src/lib/file-utils.ts
+var homeDirectory = homedir();
 function getPathToViewsFolder(config2) {
   if (config2.templatePath) {
     return untildify(config2.templatePath);
@@ -285,16 +277,24 @@ function getPathToTemplateFile(templateFileName, config2) {
   const fullTemplateFileName = config2.noHead !== true ? `${templateFileName}_full.pug` : `${templateFileName}.pug`;
   return join(getPathToViewsFolder(config2), fullTemplateFileName);
 }
-function generateFileName(timetable, config2, extension = "html") {
-  let filename = timetable.timetable_id;
+function generateTimetablePageFileName(timetablePage, config2) {
+  if (timetablePage.filename) {
+    return sanitize(timetablePage.filename);
+  }
+  if (config2.groupTimetablesIntoPages === true && uniqBy(timetablePage.timetables, "route_id").length === 1) {
+    const route = timetablePage.timetables[0].routes[0];
+    return sanitize(`${formatRouteNameForFilename(route).toLowerCase()}.html`);
+  }
+  const timetable = timetablePage.timetables[0];
+  let filename = timetable.timetable_id ?? "";
   for (const route of timetable.routes) {
-    filename += isNullOrEmpty(route.route_short_name) ? `_${route.route_long_name.replace(/\s/g, "-")}` : `_${route.route_short_name.replace(/\s/g, "-")}`;
+    filename += `_${formatRouteNameForFilename(route)}`;
   }
   if (!isNullOrEmpty(timetable.direction_id)) {
     filename += `_${timetable.direction_id}`;
   }
-  filename += `_${formatDays(timetable, config2).replace(/\s/g, "")}.${extension}`;
-  return sanitize(filename).toLowerCase();
+  filename += `_${formatDays(timetable, config2).replace(/\s/g, "")}.html`;
+  return sanitize(filename.toLowerCase());
 }
 async function renderTemplate(templateFileName, templateVars, config2) {
   const templatePath = getPathToTemplateFile(templateFileName, config2);
@@ -313,10 +313,12 @@ async function renderTemplate(templateFileName, templateVars, config2) {
   }
   return html;
 }
+function untildify(pathWithTilde) {
+  return homeDirectory ? pathWithTilde.replace(/^~(?=$|\/|\\)/, homeDirectory) : pathWithTilde;
+}
 
 // src/lib/geojson-utils.ts
 import { getShapesAsGeoJSON, getStopsAsGeoJSON } from "gtfs";
-import { flatMap } from "lodash-es";
 import simplify from "@turf/simplify";
 import { featureCollection, round } from "@turf/helpers";
 
@@ -342,7 +344,7 @@ function formatWarning(text) {
 }
 
 // src/lib/geojson-utils.ts
-var mergeGeojson = (...geojsons) => featureCollection(flatMap(geojsons, (geojson) => geojson.features));
+var mergeGeojson = (...geojsons) => featureCollection(geojsons.flatMap((geojson) => geojson.features));
 var truncateGeoJSONDecimals = (geojson, config2) => {
   for (const feature of geojson.features) {
     if (feature.geometry.coordinates) {
@@ -419,7 +421,7 @@ function getAgencyGeoJSON(config2) {
 // package.json
 var package_default = {
   name: "gtfs-to-html",
-  version: "2.10.17",
+  version: "2.11.0",
   private: false,
   description: "Build human readable transit timetables as HTML, PDF or CSV from GTFS",
   keywords: [
@@ -472,24 +474,22 @@ var package_default = {
     "cli-table": "^0.3.11",
     "csv-stringify": "^6.6.0",
     express: "^5.1.0",
-    gtfs: "^4.17.7",
+    gtfs: "^4.18.0",
     "gtfs-realtime-pbf-js-module": "^1.0.0",
     "js-beautify": "^1.15.4",
     "lodash-es": "^4.17.21",
-    marked: "^16.1.2",
+    marked: "^16.3.0",
     moment: "^2.30.1",
     pbf: "^4.0.1",
     "pretty-error": "^4.0.0",
     pug: "^3.0.3",
-    puppeteer: "^24.16.2",
+    puppeteer: "^24.21.0",
     "sanitize-filename": "^1.6.3",
     "sanitize-html": "^2.17.0",
     sqlstring: "^2.3.3",
-    "timer-machine": "^1.1.0",
     toposort: "^2.0.2",
-    untildify: "^5.0.0",
     yargs: "^18.0.0",
-    yoctocolors: "^2.1.1"
+    yoctocolors: "^2.1.2"
   },
   devDependencies: {
     "@types/archiver": "^6.0.3",
@@ -501,10 +501,11 @@ var package_default = {
     "@types/node": "^22",
     "@types/pug": "^2.0.10",
     "@types/sanitize-html": "^2.16.0",
-    "@types/timer-machine": "^1.1.3",
+    "@types/sqlstring": "^2.3.2",
+    "@types/toposort": "^2.0.7",
     "@types/yargs": "^17.0.33",
     husky: "^9.1.7",
-    "lint-staged": "^16.1.5",
+    "lint-staged": "^16.1.6",
     prettier: "^3.6.2",
     tsup: "^8.5.0",
     typescript: "^5.9.2"
@@ -560,7 +561,7 @@ var findCommonStopId = (trips, config2) => {
     return null;
   }
   const commonStoptime = longestTripStoptimes.find((stoptime, idx) => {
-    if (idx === 0 && stoptime.stop_id === last(longestTripStoptimes).stop_id) {
+    if (idx === 0 && stoptime.stop_id === last(longestTripStoptimes)?.stop_id) {
       return false;
     }
     if (isNullOrEmpty(stoptime.arrival_time)) {
@@ -613,11 +614,7 @@ var sortTrips = (trips, config2) => {
         trip.stoptimes[trip.stoptimes.length - 1].departure_time
       );
     }
-    sortedTrips = sortBy(
-      trips,
-      ["firstStoptime", "lastStoptime"],
-      ["asc", "asc"]
-    );
+    sortedTrips = sortBy(trips, ["firstStoptime", "lastStoptime"]);
   } else if (config2.sortingAlgorithm === "end") {
     for (const trip of trips) {
       if (trip.stoptimes.length === 0) {
@@ -628,11 +625,7 @@ var sortTrips = (trips, config2) => {
         trip.stoptimes[trip.stoptimes.length - 1].departure_time
       );
     }
-    sortedTrips = sortBy(
-      trips,
-      ["lastStoptime", "firstStoptime"],
-      ["asc", "asc"]
-    );
+    sortedTrips = sortBy(trips, ["lastStoptime", "firstStoptime"]);
   } else if (config2.sortingAlgorithm === "first") {
     const longestTripStoptimes = getLongestTripStoptimes(trips, config2);
     const firstStopId = first(longestTripStoptimes).stop_id;
@@ -659,8 +652,8 @@ var getCalendarDatesForTimetable = (timetable, config2) => {
     [],
     [["date", "ASC"]]
   );
-  const start = fromGTFSDate(timetable.start_date);
-  const end = fromGTFSDate(timetable.end_date);
+  const start = moment2(timetable.start_date, "YYYYMMDD");
+  const end = moment2(timetable.end_date, "YYYYMMDD");
   const excludedDates = /* @__PURE__ */ new Set();
   const includedDates = /* @__PURE__ */ new Set();
   for (const calendarDate of calendarDates) {
@@ -785,28 +778,70 @@ var getTimetableNotesForTimetable = (timetable, config2) => {
   }));
   return sortBy(formattedNotes, "symbol");
 };
-var convertTimetableToTimetablePage = (timetable, config2) => {
-  if (!timetable.routes) {
-    timetable.routes = getRoutes({
-      route_id: timetable.route_ids
-    });
-  }
-  const filename = generateFileName(timetable, config2, "html");
+var createTimetablePage = ({
+  timetablePageId,
+  timetables,
+  config: config2
+}) => {
+  const updatedTimetables = timetables.map((timetable) => {
+    if (!timetable.routes) {
+      timetable.routes = getRoutes({
+        route_id: timetable.route_ids
+      });
+    }
+    return timetable;
+  });
+  const timetablePage = {
+    timetable_page_id: timetablePageId,
+    timetables: updatedTimetables,
+    routes: updatedTimetables.flatMap((timetable) => timetable.routes)
+  };
+  const filename = generateTimetablePageFileName(timetablePage, config2);
   return {
-    timetable_page_id: timetable.timetable_id,
-    timetable_page_label: timetable.timetable_label,
-    timetables: [timetable],
+    ...timetablePage,
     filename
   };
 };
-var convertRouteToTimetablePage = (route, direction, calendars, calendarDates, config2) => {
-  const timetable = {
+var createTimetable = ({
+  route,
+  directionId,
+  tripHeadsign,
+  calendars,
+  calendarDates
+}) => {
+  const serviceIds = uniq([
+    ...calendars?.map((calendar) => calendar.service_id) ?? [],
+    ...calendarDates?.map((calendarDate) => calendarDate.service_id) ?? []
+  ]);
+  const days2 = {};
+  let startDate = null;
+  let endDate = null;
+  if (calendars && calendars.length > 0) {
+    Object.assign(days2, getDaysFromCalendars(calendars));
+    startDate = parseInt(
+      moment2.min(
+        calendars.map((calendar) => moment2(calendar.start_date, "YYYYMMDD"))
+      ).format("YYYYMMDD"),
+      10
+    );
+    endDate = parseInt(
+      moment2.max(calendars.map((calendar) => moment2(calendar.end_date, "YYYYMMDD"))).format("YYYYMMDD"),
+      10
+    );
+  }
+  const timetableId = formatTimetableId({
+    routeIds: [route.route_id],
+    directionId,
+    days: days2
+  });
+  return {
+    timetable_id: timetableId,
     route_ids: [route.route_id],
-    direction_id: direction ? direction.direction_id : void 0,
-    direction_name: direction ? direction.trip_headsign : void 0,
+    direction_id: directionId === null ? null : directionId,
+    direction_name: tripHeadsign === null ? null : tripHeadsign,
     routes: [route],
     include_exceptions: calendarDates && calendarDates.length > 0 ? 1 : 0,
-    service_id: calendarDates && calendarDates.length > 0 ? calendarDates[0].service_id : null,
+    service_ids: serviceIds,
     service_notes: null,
     timetable_label: null,
     start_time: null,
@@ -814,88 +849,83 @@ var convertRouteToTimetablePage = (route, direction, calendars, calendarDates, c
     orientation: null,
     timetable_sequence: null,
     show_trip_continuation: null,
-    start_date: null,
-    end_date: null
+    start_date: startDate,
+    end_date: endDate,
+    ...days2
   };
-  if (calendars && calendars.length > 0) {
-    Object.assign(timetable, getDaysFromCalendars(calendars));
-    timetable.start_date = toGTFSDate(
-      moment2.min(
-        calendars.map((calendar) => fromGTFSDate(calendar.start_date))
-      )
-    );
-    timetable.end_date = toGTFSDate(
-      moment2.max(calendars.map((calendar) => fromGTFSDate(calendar.end_date)))
-    );
-  }
-  timetable.timetable_id = formatTimetableId(timetable);
-  return convertTimetableToTimetablePage(timetable, config2);
 };
 var convertRoutesToTimetablePages = (config2) => {
-  const db = openDb(config2);
   const routes = getRoutes();
-  let whereClause = "";
-  const whereClauses = [];
-  if (config2.endDate) {
-    whereClauses.push(
-      `start_date <= ${sqlString.escape(toGTFSDate(moment2(config2.endDate)))}`
-    );
-  }
-  if (config2.startDate) {
-    whereClauses.push(
-      `end_date >= ${sqlString.escape(toGTFSDate(moment2(config2.startDate)))}`
-    );
-  }
-  if (whereClauses.length > 0) {
-    whereClause = `WHERE ${whereClauses.join(" AND ")}`;
-  }
-  const calendars = db.prepare(`SELECT * FROM calendar ${whereClause}`).all();
-  const serviceIds = calendars.map((calendar) => calendar.service_id);
-  const calendarDates = db.prepare(
-    `SELECT * FROM calendar_dates WHERE exception_type = 1 AND service_id NOT IN (${serviceIds.map((serviceId) => `'${serviceId}'`).join(", ")})`
-  ).all();
-  const timetablePages = routes.map((route) => {
+  const timetablePages = [];
+  const { calendars, calendarDates } = getCalendarsFromConfig(config2);
+  for (const route of routes) {
     const trips = getTrips(
       {
         route_id: route.route_id
       },
       ["trip_headsign", "direction_id", "trip_id", "service_id"]
     );
-    const directions = uniqBy(trips, (trip) => trip.direction_id);
-    const dayGroups = groupBy(calendars, calendarToCalendarCode);
+    const uniqueTripDirections = orderBy(
+      uniqBy2(trips, (trip) => trip.direction_id),
+      "direction_id"
+    );
+    const sortedCalendars = orderBy(calendars, calendarToCalendarCode, "desc");
+    const calendarGroups = groupBy(sortedCalendars, calendarToCalendarCode);
     const calendarDateGroups = groupBy(calendarDates, "service_id");
-    return directions.map((direction) => [
-      Object.values(dayGroups).map((calendars2) => {
+    const timetables = [];
+    for (const uniqueTripDirection of uniqueTripDirections) {
+      for (const calendars2 of Object.values(calendarGroups)) {
         const tripsForCalendars = trips.filter(
           (trip) => some(calendars2, { service_id: trip.service_id })
         );
         if (tripsForCalendars.length > 0) {
-          return convertRouteToTimetablePage(
-            route,
-            direction,
-            calendars2,
-            null,
-            config2
+          timetables.push(
+            createTimetable({
+              route,
+              directionId: uniqueTripDirection.direction_id,
+              tripHeadsign: uniqueTripDirection.trip_headsign,
+              calendars: calendars2
+            })
           );
         }
-      }),
-      Object.values(calendarDateGroups).map((calendarDates2) => {
+      }
+      for (const calendarDates2 of Object.values(calendarDateGroups)) {
         const tripsForCalendarDates = trips.filter(
           (trip) => some(calendarDates2, { service_id: trip.service_id })
         );
         if (tripsForCalendarDates.length > 0) {
-          return convertRouteToTimetablePage(
-            route,
-            direction,
-            null,
-            calendarDates2,
-            config2
+          timetables.push(
+            createTimetable({
+              route,
+              directionId: uniqueTripDirection.direction_id,
+              tripHeadsign: uniqueTripDirection.trip_headsign,
+              calendarDates: calendarDates2
+            })
           );
         }
-      })
-    ]);
-  });
-  return compact(flattenDeep(timetablePages));
+      }
+    }
+    if (config2.groupTimetablesIntoPages === true) {
+      timetablePages.push(
+        createTimetablePage({
+          timetablePageId: `route_${route.route_short_name ?? route.route_long_name}`,
+          timetables,
+          config: config2
+        })
+      );
+    } else {
+      for (const timetable of timetables) {
+        timetablePages.push(
+          createTimetablePage({
+            timetablePageId: timetable.timetable_id,
+            timetables: [timetable],
+            config: config2
+          })
+        );
+      }
+    }
+  }
+  return timetablePages;
 };
 var generateTripsByFrequencies = (trip, frequencies, config2) => {
   const formattedFrequencies = frequencies.map(
@@ -918,7 +948,7 @@ var generateTripsByFrequencies = (trip, frequencies, config2) => {
   return trips;
 };
 var duplicateStopsForDifferentArrivalDeparture = (stopIds, timetable, config2) => {
-  if (config2.showArrivalOnDifference === null) {
+  if (config2.showArrivalOnDifference === null || config2.showArrivalOnDifference === void 0) {
     return stopIds;
   }
   for (const trip of timetable.orderedTrips) {
@@ -1040,7 +1070,7 @@ var getStopsForTimetable = (timetable, config2) => {
     }
     return stop;
   });
-  if (timetable.showStopCity) {
+  if (config2.showStopCity) {
     const stopAttributes = getStopAttributes({
       stop_id: orderedStopIds
     });
@@ -1055,6 +1085,39 @@ var getStopsForTimetable = (timetable, config2) => {
   }
   return orderedStops;
 };
+var getCalendarsFromConfig = (config2) => {
+  const db = openDb();
+  let whereClause = "";
+  const whereClauses = [];
+  if (config2.endDate) {
+    if (!moment2(config2.endDate).isValid()) {
+      throw new Error(`Invalid endDate=${config2.endDate} in config.json`);
+    }
+    whereClauses.push(
+      `start_date <= ${sqlString.escape(moment2(config2.endDate).format("YYYYMMDD"))}`
+    );
+  }
+  if (config2.startDate) {
+    if (!moment2(config2.startDate).isValid()) {
+      throw new Error(`Invalid startDate=${config2.startDate} in config.json`);
+    }
+    whereClauses.push(
+      `end_date >= ${sqlString.escape(moment2(config2.startDate).format("YYYYMMDD"))}`
+    );
+  }
+  if (whereClauses.length > 0) {
+    whereClause = `WHERE ${whereClauses.join(" AND ")}`;
+  }
+  const calendars = db.prepare(`SELECT * FROM calendar ${whereClause}`).all();
+  const serviceIds = calendars.map((calendar) => calendar.service_id);
+  const calendarDates = db.prepare(
+    `SELECT * FROM calendar_dates WHERE exception_type = 1 AND service_id NOT IN (${serviceIds.map((serviceId) => `'${serviceId}'`).join(", ")})`
+  ).all();
+  return {
+    calendars,
+    calendarDates
+  };
+};
 var getCalendarsFromTimetable = (timetable) => {
   const db = openDb();
   let whereClause = "";
@@ -1204,13 +1267,17 @@ var filterTrips = (timetable) => {
     }
     trip.stoptimes = combinedStoptimes;
   }
-  const timetableStopIds = new Set(timetable.stops.map((stop) => stop.stop_id));
+  const timetableStopIds = new Set(
+    timetable.stops.map((stop) => stop.stop_id)
+  );
   for (const trip of filteredTrips) {
     trip.stoptimes = trip.stoptimes.filter(
       (stoptime) => timetableStopIds.has(stoptime.stop_id)
     );
   }
-  filteredTrips = filteredTrips.filter((trip) => trip.stoptimes.length > 1);
+  filteredTrips = filteredTrips.filter(
+    (trip) => trip.stoptimes.length > 1
+  );
   return filteredTrips;
 };
 var getTripsForTimetable = (timetable, calendars, config2) => {
@@ -1361,6 +1428,15 @@ var formatTimetables = (timetables, config2) => {
 };
 function getTimetablePagesForAgency(config2) {
   const timetables = mergeTimetablesWithSameId(getTimetables());
+  const routes = getRoutes();
+  const formattedTimetables = timetables.map((timetable) => {
+    return {
+      ...timetable,
+      routes: routes.filter(
+        (route) => timetable.route_ids.includes(route.route_id)
+      )
+    };
+  });
   if (timetables.length === 0) {
     return convertRoutesToTimetablePages(config2);
   }
@@ -1370,68 +1446,33 @@ function getTimetablePagesForAgency(config2) {
     [["timetable_page_id", "ASC"]]
   );
   if (timetablePages.length === 0) {
-    return timetables.map(
-      (timetable) => convertTimetableToTimetablePage(timetable, config2)
+    return formattedTimetables.map(
+      (timetable) => createTimetablePage({
+        timetablePageId: timetable.timetable_id,
+        timetables: [timetable],
+        config: config2
+      })
     );
   }
-  const routes = getRoutes();
   return timetablePages.map((timetablePage) => {
-    timetablePage.timetables = sortBy(
-      timetables.filter(
-        (timetable) => timetable.timetable_page_id === timetablePage.timetable_page_id
-      ),
-      "timetable_sequence"
-    );
-    for (const timetable of timetablePage.timetables) {
-      timetable.routes = routes.filter(
-        (route) => timetable.route_ids.includes(route.route_id)
-      );
-    }
-    return timetablePage;
+    return {
+      ...timetablePage,
+      timetables: sortBy(
+        formattedTimetables.filter(
+          (timetable) => timetable.timetable_page_id === timetablePage.timetable_page_id
+        ),
+        "timetable_sequence"
+      )
+    };
   });
 }
-var getTimetablePageById = (timetablePageId, config2) => {
-  const timetablePages = getTimetablePages({
-    timetable_page_id: timetablePageId
-  });
-  const timetables = mergeTimetablesWithSameId(getTimetables());
-  if (timetablePages.length > 1) {
-    throw new Error(
-      `Multiple timetable_pages found for timetable_page_id=${timetablePageId}`
-    );
-  }
-  if (timetablePages.length === 1) {
-    const timetablePage = timetablePages[0];
-    timetablePage.timetables = sortBy(
-      timetables.filter(
-        (timetable) => timetable.timetable_page_id === timetablePageId
-      ),
-      "timetable_sequence"
-    );
-    for (const timetable of timetablePage.timetables) {
-      timetable.routes = getRoutes({
-        route_id: timetable.route_ids
-      });
-    }
-    return timetablePage;
-  }
-  if (timetables.length > 0) {
-    const timetablePageTimetables = timetables.filter(
-      (timetable) => timetable.timetable_id === timetablePageId
-    );
-    if (timetablePageTimetables.length === 0) {
-      throw new Error(
-        `No timetable found for timetable_page_id=${timetablePageId}`
-      );
-    }
-    return convertTimetableToTimetablePage(timetablePageTimetables[0], config2);
-  }
+var getDataForTimetablePageById = (timetablePageId) => {
   let calendarCode;
   let calendars;
   let calendarDates;
   let serviceId;
   let directionId = "";
-  const parts = timetablePageId.split("|");
+  const parts = timetablePageId?.split("|") ?? [];
   if (parts.length > 2) {
     directionId = Number.parseInt(parts.pop(), 10);
     calendarCode = parts.pop();
@@ -1450,13 +1491,13 @@ var getTimetablePageById = (timetablePageId, config2) => {
     },
     ["trip_headsign", "direction_id"]
   );
-  const directions = uniqBy(trips, (trip) => trip.direction_id);
-  if (directions.length === 0) {
+  const uniqueTripDirections = uniqBy2(trips, (trip) => trip.direction_id);
+  if (uniqueTripDirections.length === 0) {
     throw new Error(
       `No trips found for timetable_page_id=${timetablePageId} route_id=${routeId} direction_id=${directionId}`
     );
   }
-  if (/^[01]*$/.test(calendarCode)) {
+  if (/^[01]*$/.test(calendarCode ?? "")) {
     calendars = getCalendars({
       ...calendarCodeToCalendar(calendarCode)
     });
@@ -1467,13 +1508,129 @@ var getTimetablePageById = (timetablePageId, config2) => {
       service_id: serviceId
     });
   }
-  return convertRouteToTimetablePage(
-    routes[0],
-    directions[0],
+  return {
     calendars,
     calendarDates,
-    config2
-  );
+    route: routes[0],
+    directionId: uniqueTripDirections[0].direction_id,
+    tripHeadsign: uniqueTripDirections[0].trip_headsign
+  };
+};
+var getTimetablePageById = (timetablePageId, config2) => {
+  const timetablePages = getTimetablePages({
+    timetable_page_id: timetablePageId
+  });
+  const timetables = mergeTimetablesWithSameId(getTimetables());
+  if (timetablePages.length > 1) {
+    throw new Error(
+      `Multiple timetable_pages found for timetable_page_id=${timetablePageId}`
+    );
+  }
+  if (timetablePages.length === 1) {
+    const timetablePage = timetablePages[0];
+    timetablePage.timetables = sortBy(
+      timetables.filter(
+        (timetable2) => timetable2.timetable_page_id === timetablePageId
+      ),
+      "timetable_sequence"
+    );
+    for (const timetable2 of timetablePage.timetables) {
+      timetable2.routes = getRoutes({
+        route_id: timetable2.route_ids
+      });
+    }
+    return timetablePage;
+  }
+  if (timetables.length > 0) {
+    const timetablePageTimetables = timetables.filter(
+      (timetable2) => timetable2.timetable_id === timetablePageId
+    );
+    if (timetablePageTimetables.length === 0) {
+      throw new Error(
+        `No timetable found for timetable_page_id=${timetablePageId}`
+      );
+    }
+    return createTimetablePage({
+      timetablePageId,
+      timetables: [timetablePageTimetables[0]],
+      config: config2
+    });
+  }
+  if (timetablePageId.startsWith("route_")) {
+    const routes = getRoutes({
+      route_short_name: timetablePageId.split("_")[1]
+    });
+    if (routes.length === 0) {
+      throw new Error(
+        `No route found for timetable_page_id=${timetablePageId}`
+      );
+    }
+    const { calendars: calendars2, calendarDates: calendarDates2 } = getCalendarsFromConfig(config2);
+    const trips = getTrips(
+      {
+        route_id: routes[0].route_id
+      },
+      ["trip_headsign", "direction_id", "trip_id", "service_id"]
+    );
+    const uniqueTripDirections = orderBy(
+      uniqBy2(trips, (trip) => trip.direction_id),
+      "direction_id"
+    );
+    const sortedCalendars = orderBy(calendars2, calendarToCalendarCode, "desc");
+    const calendarGroups = groupBy(sortedCalendars, calendarToCalendarCode);
+    const calendarDateGroups = groupBy(calendarDates2, "service_id");
+    const timetables2 = [];
+    for (const uniqueTripDirection of uniqueTripDirections) {
+      for (const calendars3 of Object.values(calendarGroups)) {
+        const tripsForCalendars = trips.filter(
+          (trip) => some(calendars3, { service_id: trip.service_id })
+        );
+        if (tripsForCalendars.length > 0) {
+          timetables2.push(
+            createTimetable({
+              route: routes[0],
+              directionId: uniqueTripDirection.direction_id,
+              tripHeadsign: uniqueTripDirection.trip_headsign,
+              calendars: calendars3
+            })
+          );
+        }
+      }
+      for (const calendarDates3 of Object.values(calendarDateGroups)) {
+        const tripsForCalendarDates = trips.filter(
+          (trip) => some(calendarDates3, { service_id: trip.service_id })
+        );
+        if (tripsForCalendarDates.length > 0) {
+          timetables2.push(
+            createTimetable({
+              route: routes[0],
+              directionId: uniqueTripDirection.direction_id,
+              tripHeadsign: uniqueTripDirection.trip_headsign,
+              calendarDates: calendarDates3
+            })
+          );
+        }
+      }
+    }
+    return createTimetablePage({
+      timetablePageId,
+      timetables: timetables2,
+      config: config2
+    });
+  }
+  const { calendars, calendarDates, route, directionId, tripHeadsign } = getDataForTimetablePageById(timetablePageId);
+  const timetable = createTimetable({
+    route,
+    directionId,
+    tripHeadsign,
+    calendars,
+    calendarDates
+  });
+  return createTimetablePage({
+    timetablePageId,
+    timetables: [timetable],
+    config: config2
+  });
 };
 function setDefaultConfig(initialConfig) {
   const defaults = {
@@ -1494,6 +1651,7 @@ function setDefaultConfig(initialConfig) {
     defaultOrientation: "vertical",
     interpolatedStopSymbol: "\u2022",
     interpolatedStopText: "Estimated time of arrival",
+    groupTimetablesIntoPages: true,
     gtfsToHtmlVersion: version,
     linkStopUrls: false,
     mapStyleUrl: "https://tiles.openfreemap.org/styles/positron",
@@ -1550,12 +1708,6 @@ function getFormattedTimetablePage(timetablePageId, config2) {
     timetablePageId,
     config2
   );
-  const timetableRoutes = getRoutes(
-    {
-      route_id: timetablePage.route_ids
-    },
-    ["agency_id"]
-  );
   const consolidatedTimetables = formatTimetables(
     timetablePage.timetables,
     config2
@@ -1570,8 +1722,8 @@ function getFormattedTimetablePage(timetablePageId, config2) {
       });
     }
   }
-  const uniqueRoutes = uniqBy(
-    flatMap2(consolidatedTimetables, (timetable) => timetable.routes),
+  const uniqueRoutes = uniqBy2(
+    flatMap(consolidatedTimetables, (timetable) => timetable.routes),
     "route_id"
   );
   const formattedTimetablePage = {
@@ -1582,7 +1734,7 @@ function getFormattedTimetablePage(timetablePageId, config2) {
       consolidatedTimetables.map((timetable) => timetable.dayList)
     ),
     route_ids: uniqueRoutes.map((route) => route.route_id),
-    agency_ids: uniq(compact(timetableRoutes.map((route) => route.agency_id))),
+    agency_ids: uniq(compact(uniqueRoutes.map((route) => route.agency_id))),
     filename: timetablePage.filename ?? `${timetablePage.timetable_page_id}.html`,
     timetable_page_label: timetablePage.timetable_page_label ?? formatListForDisplay(uniqueRoutes.map((route) => formatRouteName(route)))
   };
@@ -1786,12 +1938,14 @@ function formatFrequency(frequency, config2) {
   frequency.headway_min = Math.round(headway.asMinutes());
   return frequency;
 }
-function formatTimetableId(timetable) {
-  let timetableId = `${timetable.route_ids.join("_")}|${calendarToCalendarCode(
-    timetable
-  )}`;
-  if (!isNullOrEmpty(timetable.direction_id)) {
-    timetableId += `|${timetable.direction_id}`;
+function formatTimetableId({
+  routeIds,
+  directionId,
+  days: days2
+}) {
+  let timetableId = `${routeIds.join("_")}|${calendarToCalendarCode(days2)}`;
+  if (!isNullOrEmpty(directionId)) {
+    timetableId += `|${directionId}`;
   }
   return timetableId;
 }
@@ -1935,10 +2089,18 @@ function formatTimetableLabel(timetable) {
   return timetableLabel;
 }
 var formatRouteName = (route) => {
-  if (route.route_long_name === null || route.route_long_name === "") {
-    return `Route ${route.route_short_name}`;
+  if (route.route_long_name) {
+    return `Route ${route.route_long_name}`;
+  }
+  return route.route_short_name ?? "Unknown";
+};
+var formatRouteNameForFilename = (route) => {
+  if (route.route_short_name) {
+    return route.route_short_name.replace(/\s/g, "-");
+  } else if (route.route_long_name) {
+    return route.route_long_name.replace(/\s/g, "-");
   }
-  return route.route_long_name ?? "Unknown";
+  return "Unknown";
 };
 var formatListForDisplay = (list) => {
   return new Intl.ListFormat("en-US", {
@@ -1988,7 +2150,7 @@ app.use((req, res, next) => {
   console.log(`${req.method} ${req.url}`);
   next();
 });
-var staticAssetPath = config.templatePath === void 0 ? getPathToViewsFolder(config) : untildify2(config.templatePath);
+var staticAssetPath = config.templatePath === void 0 ? getPathToViewsFolder(config) : untildify(config.templatePath);
 app.use(express.static(staticAssetPath));
 app.use(
   "/js",
@@ -2018,6 +2180,9 @@ app.get("/", async (req, res, next) => {
       (timetablePage) => timetablePage.timetable_page_id
     );
     for (const timetablePageId of timetablePageIds) {
+      if (!timetablePageId) {
+        continue;
+      }
       const timetablePage = await getFormattedTimetablePage(
         timetablePageId,
         config