gtfs-garage-web 0.0.1 → 0.0.2

package/dist/dataset.js

@@ -1,4 +1,4 @@
-import { m as h, p as L } from "./mount-Bpr3Nw4_.js";
+import { m as h, p as L } from "./mount-CHJb5mxA.js";
 function P(e, s) {
   const { description: a, canPrepare: n, asked: c, phrase: f } = s;
   switch (e.state) {

package/dist/dom.d.ts

@@ -3,9 +3,8 @@
  * Element lookup scoped to one viewer.
  *
  * Every lookup goes through a root rather than `document`, so two viewers can
- * exist on one page without reaching into each other's markup. That is what a
- * host embedding this needs: the UI used to resolve 37 fixed ids against the
- * whole document, which silently assumed it was the only thing on the page.
+ * exist on one page without reaching into each other's markup, and a viewer
+ * embedded in a host cannot match the host's own elements.
  */
 export interface Dom {
     el<T extends HTMLElement = HTMLElement>(name: string): T;

package/dist/map.js

@@ -187,9 +187,9 @@ class w {
       center: [0, 20],
       zoom: 1,
       attributionControl: { compact: !0 },
-      // `buildStyle` composes the style from the basemap and this viewer's own
-      // layers and is covered by layers.test.ts; it is typed as a plain record
-      // rather than against MapLibre, which until now was an untyped global.
+      // `buildStyle` composes the basemap with this viewer's own layers and is
+      // covered by layers.test.ts; it is typed as a plain record, not against
+      // MapLibre.
       style: a
     }), this.map.addControl(new this.maplibregl.NavigationControl(), "top-right"), this.map.addControl(new this.maplibregl.ScaleControl()), this.map.on("click", "stops", (o) => {
       const s = o.features[0].properties;

package/dist/{mount-Bpr3Nw4_.js → mount-CHJb5mxA.js}

@@ -465,9 +465,8 @@ class ge {
   /**
    * Poll the server for the load's phase until it is told to stop.
    *
-   * Only answerable at all because the load runs in a worker thread; while it
-   * sat on the event loop no other request could be served, which is why a big
-   * feed looked like a hung page.
+   * Only answerable because the load runs in a worker thread: on the event
+   * loop it would block every other request, including this poll.
    */
   pollProgress(e) {
     let t = !1;
@@ -789,10 +788,9 @@ function Ue(n, e) {
     case "FLOAT":
     case "CURRENCY_AMOUNT":
       return _e(n, E(e), e);
-    // TIME has a pattern and so is checked above, but is deliberately not
-    // reformatted: GTFS times legitimately exceed 24:00:00 for trips running
-    // past midnight, and a formatter that "corrected" 25:30:00 would be worse
-    // than none.
+    // TIME is checked by its pattern above but never reformatted: GTFS times
+    // legitimately exceed 24:00:00 for trips running past midnight, so
+    // 25:30:00 is correct as written.
     default:
       return y(n);
   }

package/dist/mount.js

@@ -1,4 +1,4 @@
-import { R as s, b as a, a as e, m } from "./mount-Bpr3Nw4_.js";
+import { R as s, b as a, a as e, m } from "./mount-CHJb5mxA.js";
 export {
   s as RestSource,
   a as browserHistory,

package/dist/parquet.js

@@ -128,10 +128,8 @@ class O {
   /**
    * The table list an exported dataset carries, if it carries one.
    *
-   * `gtfs-garage --export` writes a manifest beside the Parquet so a reader
-   * need not guess. Without it the only fallback is trying all 32 tables GTFS
-   * defines, which for a seven-table feed measured at 123 requests before the
-   * first row appeared.
+   * `gtfs-garage --export` writes it beside the Parquet. Absent, the only
+   * fallback is probing every table GTFS defines.
    */
   async fromManifest() {
     const i = performance.now();

package/dist/react.js

@@ -1,7 +1,7 @@
 import { jsx as f } from "react/jsx-runtime";
 import { useRef as c, useEffect as i } from "react";
 import { mountDataset as m } from "./dataset.js";
-import { m as d } from "./mount-Bpr3Nw4_.js";
+import { m as d } from "./mount-CHJb5mxA.js";
 function p({ className: l, style: u, ...e }) {
   const o = c(null), n = c(e);
   return n.current = e, i(() => {

package/dist/sources/parquet.d.ts

@@ -61,10 +61,8 @@ export declare class ParquetSource implements ViewerSource {
     /**
      * The table list an exported dataset carries, if it carries one.
      *
-     * `gtfs-garage --export` writes a manifest beside the Parquet so a reader
-     * need not guess. Without it the only fallback is trying all 32 tables GTFS
-     * defines, which for a seven-table feed measured at 123 requests before the
-     * first row appeared.
+     * `gtfs-garage --export` writes it beside the Parquet. Absent, the only
+     * fallback is probing every table GTFS defines.
      */
     private fromManifest;
     /**

package/dist/sources/types.d.ts

@@ -132,9 +132,9 @@ export interface LoadMetrics {
     }[];
     /**
      * The fields below describe a server load, and are absent for a source that
-     * did not perform one. A browser reading Parquet never downloaded, unzipped
-     * or converted anything, and a zero here would claim the work took no time
-     * rather than that it never happened - which is what `phases` exists for.
+     * did not perform one. A browser reading Parquet never downloads, unzips or
+     * converts, and a zero would say that work took no time instead of that it
+     * did not happen. Such a source reports `phases` above.
      */
     kind?: "path" | "upload" | "folder" | "download";
     /** Downloading or receiving the upload; null for a local path. */

package/dist/ui/feed-loader.d.ts

@@ -26,9 +26,8 @@ export declare class FeedLoader {
     /**
      * Poll the server for the load's phase until it is told to stop.
      *
-     * Only answerable at all because the load runs in a worker thread; while it
-     * sat on the event loop no other request could be served, which is why a big
-     * feed looked like a hung page.
+     * Only answerable because the load runs in a worker thread: on the event
+     * loop it would block every other request, including this poll.
      */
     private pollProgress;
     private load;

package/dist/ui/feed-metrics.d.ts

@@ -24,17 +24,16 @@ export interface FileRow {
     stored: string;
     /**
      * What this file cost: converting it, or counting it when the feed was left
-     * as CSV. One number rather than two, because the two the report used to show
-     * were measured against different storage - the header read happens on the
-     * CSV before conversion and the row count on the Parquet after it - so
-     * reading them side by side told you nothing.
+     * as CSV. One number, not both: the header read happens on the CSV before
+     * conversion and the row count on the Parquet after it, so they are measured
+     * against different storage and do not compare.
      */
     costMs: string;
     rows: string;
     columns: number;
 }
 /**
- * Largest file first: the point of the report is to name the file that
+ * Largest file first, so the report names the file that
  * dominated the load, and on a real feed that is almost always stop_times.txt.
  */
 export declare function fileRows(metrics: LoadMetrics): FileRow[];

package/dist/ui/history.d.ts

@@ -41,8 +41,8 @@ export declare function browserHistory(): HistoryPort;
 /**
  * A back stack the viewer keeps to itself, for an embedded one.
  *
- * Nothing here touches the URL or `window`, which is the point: the host stays
- * in charge of its own address bar, and can still mirror the view there by
- * listening for view changes if it wants to.
+ * Nothing here touches the URL or `window`, so the host keeps control of its
+ * own address bar, and can still mirror the view there by listening for view
+ * changes.
  */
 export declare function memoryHistory(initial?: View | null): HistoryPort;

package/dist/ui/values.d.ts

@@ -14,9 +14,8 @@
  *    to rendering rather than to loading.
  *
  * 2. **A feed is untrusted input.** Only `http:`, `https:` and `mailto:` ever
- *    become a link; anything else is text. Before this module, no feed value
- *    was ever used as an `href`, so links are a new attack surface and
- *    `javascript:` in a URL field must not survive it.
+ *    become a link; anything else is text. A feed value reaching an `href` is
+ *    an attack surface, so `javascript:` in a URL field must not survive it.
  */
 import type { ColumnInfo } from "../sources/types";
 export interface Rendered {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtfs-garage-web",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Browse a GTFS feed: a mountable viewer with a table, filters and a map.",
   "license": "Apache-2.0",
   "type": "module",