itamatrix 0.1.0

package/dist/model/types.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+/**
+ * Zod schemas for the subset of the `/v1/search` response that P1 consumes.
+ *
+ * Derived from `fixtures/result_full.json`. The live schema is far larger; we
+ * parse leniently (`.passthrough()` on objects, optional facets) so unrelated
+ * schema drift in fields we ignore never fails a search.
+ */
+export const PlaceSchema = z
+    .object({
+    code: z.string(),
+    name: z.string().optional(),
+})
+    .passthrough();
+export const CarrierSchema = z
+    .object({
+    code: z.string(),
+    shortName: z.string().optional(),
+})
+    .passthrough();
+export const SliceSchema = z
+    .object({
+    origin: PlaceSchema,
+    destination: PlaceSchema,
+    departure: z.string(),
+    arrival: z.string(),
+    flights: z.array(z.string()).default([]),
+    cabins: z.array(z.string()).default([]),
+    duration: z.number().optional(),
+    ext: z
+        .object({
+        warnings: z
+            .object({ types: z.array(z.string()).default([]) })
+            .passthrough()
+            .optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+export const ItinerarySchema = z
+    .object({
+    slices: z.array(SliceSchema),
+    carriers: z.array(CarrierSchema).default([]),
+    distance: z
+        .object({ units: z.string(), value: z.number() })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+export const SolutionSchema = z
+    .object({
+    id: z.string(),
+    displayTotal: z.string(),
+    passengerCount: z.number().optional(),
+    itinerary: ItinerarySchema,
+    ext: z
+        .object({
+        price: z.string().optional(),
+        pricePerMile: z.string().optional(),
+        totalPrice: z.string().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+export const SolutionListSchema = z
+    .object({
+    solutions: z.array(SolutionSchema).default([]),
+    minPrice: z.string().optional(),
+    solutionCount: z.number().optional(),
+    pages: z
+        .object({ count: z.number(), current: z.number() })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+export const SearchResponseSchema = z
+    .object({
+    solutionList: SolutionListSchema,
+    solutionCount: z.number().optional(),
+})
+    .passthrough();
+/** The raw `/v1/search` body wraps the payload under `response`. */
+export function parseSearchResponse(raw) {
+    return SearchResponseSchema.parse(unwrapResponse(raw));
+}
+export function parseCalendarResponse(raw) {
+    const root = unwrapResponse(raw);
+    if (!root || typeof root !== "object") {
+        throw new Error("Calendar response was not a JSON object");
+    }
+    return root;
+}
+function unwrapResponse(raw) {
+    return raw && typeof raw === "object" && "response" in raw
+        ? raw.response
+        : raw;
+}
+//# sourceMappingURL=types.js.map

package/dist/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":"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"}

package/dist/model/types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/model/types.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from "vitest";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { parseSearchResponse } from "./types.js";
+import { normalize } from "../render/normalize.js";
+const fixture = JSON.parse(readFileSync(fileURLToPath(new URL("../../fixtures/result_full.json", import.meta.url)), "utf8"));
+describe("parseSearchResponse", () => {
+    it("parses the live fixture without throwing", () => {
+        const resp = parseSearchResponse(fixture);
+        expect(resp.solutionList.solutions.length).toBe(25);
+        expect(resp.solutionList.solutionCount).toBe(32);
+    });
+    it("parses a payload wrapped under `response`", () => {
+        const resp = parseSearchResponse({ response: fixture });
+        expect(resp.solutionList.solutions.length).toBe(25);
+    });
+});
+describe("normalize", () => {
+    it("flattens solutions into an agent-friendly shape", () => {
+        const result = normalize(parseSearchResponse(fixture));
+        expect(result.count).toBe(32);
+        expect(result.shown).toBe(25);
+        expect(result.minPrice).toBe("USD440.00");
+        const first = result.solutions[0];
+        expect(first.total).toBe("USD439.81");
+        expect(first.slices).toHaveLength(2);
+        expect(first.slices[0].origin).toBe("BOS");
+        expect(first.slices[0].destination).toBe("LAX");
+        expect(first.slices[0].flights).toEqual(["UA360"]);
+        expect(first.slices[0].stops).toBe(0);
+        expect(first.slices[0].carrier).toBe("UA");
+        expect(first.slices[1].warnings).toContain("OVERNIGHT");
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/model/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/model/types.test.ts"],"names":[],"mappings":"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"}

package/dist/render/calendar.d.ts

@@ -0,0 +1,21 @@
+import type { CalendarResponse } from "../model/types.js";
+/** One day of the price calendar: lowest fare found for that departure date. */
+export interface CalendarEntry {
+    date: string;
+    price: string;
+    priceValue: number;
+}
+export interface FlatCalendar {
+    entries: CalendarEntry[];
+    minPrice?: string;
+    minDate?: string;
+}
+/**
+ * The calendar response shape is unconfirmed (no fixture — DESIGN P3), so rather
+ * than bind to a specific schema we deep-scan the payload for objects that pair
+ * a date with a price and keep the lowest price per date. When a real fixture is
+ * captured this can be tightened to a zod schema.
+ */
+export declare function normalizeCalendar(resp: CalendarResponse, limit?: number): FlatCalendar;
+export declare function renderCalendarJson(cal: FlatCalendar): string;
+export declare function renderCalendarTable(cal: FlatCalendar): string;

package/dist/render/calendar.js

@@ -0,0 +1,89 @@
+import Table from "cli-table3";
+import chalk from "chalk";
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}/;
+const PRICE_RE = /(\d[\d,]*\.?\d*)/;
+/**
+ * The calendar response shape is unconfirmed (no fixture — DESIGN P3), so rather
+ * than bind to a specific schema we deep-scan the payload for objects that pair
+ * a date with a price and keep the lowest price per date. When a real fixture is
+ * captured this can be tightened to a zod schema.
+ */
+export function normalizeCalendar(resp, limit) {
+    const byDate = new Map();
+    for (const { date, price } of scanForFares(resp)) {
+        const value = parsePrice(price);
+        if (value == null)
+            continue;
+        const prev = byDate.get(date);
+        if (!prev || value < prev.priceValue) {
+            byDate.set(date, { date, price, priceValue: value });
+        }
+    }
+    const entries = capCheapest([...byDate.values()], limit).sort((a, b) => a.date.localeCompare(b.date));
+    const cheapest = entries.reduce((min, e) => (!min || e.priceValue < min.priceValue ? e : min), undefined);
+    return { entries, minPrice: cheapest?.price, minDate: cheapest?.date };
+}
+/** Keep the `limit` cheapest dates (the point of a price calendar); all when unset. */
+function capCheapest(entries, limit) {
+    if (limit == null || entries.length <= limit)
+        return entries;
+    return [...entries].sort((a, b) => a.priceValue - b.priceValue).slice(0, limit);
+}
+/** Yields {date, price} pairs found anywhere in the response tree. */
+function* scanForFares(node) {
+    if (Array.isArray(node)) {
+        for (const item of node)
+            yield* scanForFares(item);
+        return;
+    }
+    if (!node || typeof node !== "object")
+        return;
+    const obj = node;
+    const date = pickValue(obj, /date|departure/i, isIsoDate);
+    const price = pickValue(obj, /price|total|fare|amount/i, isPriceLike);
+    if (date && price)
+        yield { date: date.slice(0, 10), price };
+    for (const value of Object.values(obj))
+        yield* scanForFares(value);
+}
+function pickValue(obj, keyRe, valueOk) {
+    for (const [k, v] of Object.entries(obj)) {
+        if (typeof v === "string" && keyRe.test(k) && valueOk(v))
+            return v;
+    }
+    return undefined;
+}
+function isIsoDate(v) {
+    return ISO_DATE_RE.test(v);
+}
+function isPriceLike(v) {
+    return PRICE_RE.test(v);
+}
+function parsePrice(price) {
+    const m = price.match(PRICE_RE);
+    if (!m)
+        return null;
+    const value = Number(m[1].replace(/,/g, ""));
+    return Number.isFinite(value) ? value : null;
+}
+export function renderCalendarJson(cal) {
+    return JSON.stringify(cal, null, 2);
+}
+export function renderCalendarTable(cal) {
+    if (cal.entries.length === 0) {
+        return chalk.yellow("No fares found for the given date range.");
+    }
+    const table = new Table({
+        head: [chalk.bold("Date"), chalk.bold("Lowest fare")],
+        style: { head: [], border: [] },
+    });
+    for (const e of cal.entries) {
+        const cheapest = e.date === cal.minDate;
+        const price = cheapest ? chalk.green.bold(e.price) : chalk.green(e.price);
+        table.push([cheapest ? chalk.bold(e.date) : e.date, price]);
+    }
+    const header = chalk.dim(`${cal.entries.length} dates` +
+        (cal.minPrice ? ` · cheapest ${cal.minPrice} on ${cal.minDate}` : ""));
+    return `${header}\n${table.toString()}`;
+}
+//# sourceMappingURL=calendar.js.map

package/dist/render/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/render/calendar.ts"],"names":[],"mappings":"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"}

package/dist/render/calendar.render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/render/calendar.render.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect } from "vitest";
+import { normalizeCalendar, renderCalendarTable } from "./calendar.js";
+describe("normalizeCalendar", () => {
+    it("deep-scans for date→price pairs regardless of nesting", () => {
+        const resp = {
+            calendarSliceList: {
+                days: [
+                    { departureDate: "2026-08-01", price: "USD439.81" },
+                    { departureDate: "2026-08-02", price: "USD512.00" },
+                ],
+            },
+        };
+        const cal = normalizeCalendar(resp);
+        expect(cal.entries).toHaveLength(2);
+        expect(cal.minPrice).toBe("USD439.81");
+        expect(cal.minDate).toBe("2026-08-01");
+    });
+    it("keeps the lowest price when a date appears more than once", () => {
+        const resp = {
+            a: { date: "2026-08-01", total: "USD600" },
+            b: { date: "2026-08-01", total: "USD420.50" },
+        };
+        const cal = normalizeCalendar(resp);
+        expect(cal.entries).toHaveLength(1);
+        expect(cal.entries[0].price).toBe("USD420.50");
+    });
+    it("sorts entries by date and trims timestamps to YYYY-MM-DD", () => {
+        const resp = {
+            x: { departureDate: "2026-08-03T00:00-04:00", fare: "USD300" },
+            y: { departureDate: "2026-08-01T00:00-04:00", fare: "USD200" },
+        };
+        const cal = normalizeCalendar(resp);
+        expect(cal.entries.map((e) => e.date)).toEqual(["2026-08-01", "2026-08-03"]);
+    });
+    it("yields no entries for a payload with no date/price pairs", () => {
+        expect(normalizeCalendar({ foo: { bar: 1 } }).entries).toHaveLength(0);
+    });
+    it("caps to the cheapest N dates when a limit is given, still date-sorted", () => {
+        const resp = {
+            days: [
+                { departureDate: "2026-08-01", price: "USD500" },
+                { departureDate: "2026-08-02", price: "USD200" },
+                { departureDate: "2026-08-03", price: "USD300" },
+            ],
+        };
+        const cal = normalizeCalendar(resp, 2);
+        expect(cal.entries.map((e) => e.date)).toEqual(["2026-08-02", "2026-08-03"]);
+        expect(cal.minPrice).toBe("USD200");
+    });
+});
+describe("renderCalendarTable", () => {
+    it("renders a friendly message when there are no fares", () => {
+        expect(renderCalendarTable({ entries: [] })).toMatch(/No fares found/);
+    });
+    it("includes each date and the cheapest summary", () => {
+        const out = renderCalendarTable(normalizeCalendar({
+            days: [
+                { date: "2026-08-01", price: "USD439.81" },
+                { date: "2026-08-02", price: "USD512.00" },
+            ],
+        }));
+        expect(out).toMatch(/2026-08-01/);
+        expect(out).toMatch(/cheapest USD439.81/);
+    });
+});
+//# sourceMappingURL=calendar.render.test.js.map

package/dist/render/calendar.render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.render.test.js","sourceRoot":"","sources":["../../src/render/calendar.render.test.ts"],"names":[],"mappings":"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"}

package/dist/render/json.d.ts

@@ -0,0 +1,2 @@
+import type { FlatResult } from "./normalize.js";
+export declare function renderJson(result: FlatResult): string;

package/dist/render/json.js

@@ -0,0 +1,4 @@
+export function renderJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/render/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/render/json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/render/normalize.d.ts

@@ -0,0 +1,32 @@
+import type { SearchResponse } from "../model/types.js";
+/** Flat, agent-friendly view of a single itinerary. */
+export interface FlatSlice {
+    origin: string;
+    destination: string;
+    departure: string;
+    arrival: string;
+    flights: string[];
+    carrier?: string;
+    stops: number;
+    durationMinutes?: number;
+    warnings: string[];
+}
+export interface FlatSolution {
+    id: string;
+    total: string;
+    pricePerMile?: string;
+    carriers: string[];
+    slices: FlatSlice[];
+}
+export interface FlatResult {
+    count: number;
+    shown: number;
+    minPrice?: string;
+    solutions: FlatSolution[];
+}
+/**
+ * `limit` caps how many solutions are returned. Matrix paginates server-side
+ * (default 25); we can't reliably drive its page-size control, so we slice the
+ * returned page here to honor `--limit` consistently across commands.
+ */
+export declare function normalize(resp: SearchResponse, limit?: number): FlatResult;

package/dist/render/normalize.js

@@ -0,0 +1,44 @@
+/**
+ * IATA carrier codes are two characters and may contain a digit (e.g. JetBlue
+ * `B6`), so take the leading two-char code rather than stripping all digits.
+ */
+function parseCarrier(flight) {
+    return flight?.match(/^[A-Z0-9]{2}/)?.[0];
+}
+function flattenSolution(sol) {
+    const slices = sol.itinerary.slices.map((s) => ({
+        origin: s.origin.code,
+        destination: s.destination.code,
+        departure: s.departure,
+        arrival: s.arrival,
+        flights: s.flights,
+        carrier: parseCarrier(s.flights[0]),
+        stops: Math.max(0, s.flights.length - 1),
+        durationMinutes: s.duration,
+        warnings: s.ext?.warnings?.types ?? [],
+    }));
+    return {
+        id: sol.id,
+        total: sol.displayTotal,
+        pricePerMile: sol.ext?.pricePerMile,
+        carriers: sol.itinerary.carriers.map((c) => c.code),
+        slices,
+    };
+}
+/**
+ * `limit` caps how many solutions are returned. Matrix paginates server-side
+ * (default 25); we can't reliably drive its page-size control, so we slice the
+ * returned page here to honor `--limit` consistently across commands.
+ */
+export function normalize(resp, limit) {
+    const list = resp.solutionList;
+    const all = list.solutions.map(flattenSolution);
+    const solutions = limit != null ? all.slice(0, limit) : all;
+    return {
+        count: list.solutionCount ?? resp.solutionCount ?? all.length,
+        shown: solutions.length,
+        minPrice: list.minPrice,
+        solutions,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/render/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/render/normalize.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAe;IACnC,OAAO,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,eAAe,CAAC,GAAa;IACpC,MAAM,MAAM,GAAgB,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI;QACrB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI;QAC/B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,eAAe,EAAE,CAAC,CAAC,QAAQ;QAC3B,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE;KACvC,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,YAAY;QACvB,YAAY,EAAE,GAAG,CAAC,GAAG,EAAE,YAAY;QACnC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAoB,EAAE,KAAc;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5D,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM;QAC7D,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/render/render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/render/render.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from "vitest";
+import { parseSearchResponse } from "../model/types.js";
+import { normalize } from "./normalize.js";
+import { renderJson } from "./json.js";
+import { renderTable } from "./table.js";
+const stripAnsi = (s) => 
+// eslint-disable-next-line no-control-regex
+s.replace(/\[[0-9;]*m/g, "");
+/** Minimal hand-built `/v1/search`-shaped payload exercising normalize edges. */
+const payload = {
+    solutionList: {
+        minPrice: "USD200.00",
+        solutionCount: 3,
+        pages: { count: 1, current: 1 },
+        solutions: [
+            {
+                id: "A1",
+                displayTotal: "USD200.00",
+                ext: { pricePerMile: "USD0.05" },
+                itinerary: {
+                    carriers: [{ code: "DL" }],
+                    slices: [
+                        {
+                            origin: { code: "JFK" },
+                            destination: { code: "SFO" },
+                            departure: "2026-08-10T08:00-04:00",
+                            arrival: "2026-08-10T14:30-07:00",
+                            flights: ["DL100", "DL200"], // 1 stop
+                            cabins: ["COACH"],
+                            duration: 390,
+                            ext: { warnings: { types: ["OVERNIGHT"] } },
+                        },
+                    ],
+                },
+            },
+            {
+                id: "A2",
+                displayTotal: "USD250.00",
+                itinerary: {
+                    carriers: [],
+                    slices: [
+                        {
+                            origin: { code: "JFK" },
+                            destination: { code: "SFO" },
+                            departure: "2026-08-10T09:00-04:00",
+                            arrival: "2026-08-10T12:30-07:00",
+                            flights: [], // no flights → no carrier, 0 stops
+                            cabins: [],
+                        },
+                    ],
+                },
+            },
+        ],
+    },
+};
+describe("normalize edges", () => {
+    const result = normalize(parseSearchResponse(payload));
+    it("counts stops from segment count", () => {
+        expect(result.solutions[0].slices[0].stops).toBe(1);
+    });
+    it("derives carrier from the first flight number", () => {
+        expect(result.solutions[0].slices[0].carrier).toBe("DL");
+    });
+    it("keeps the two-char code for alphanumeric carriers (e.g. B6287 → B6)", () => {
+        const payload = parseSearchResponse({
+            solutionList: {
+                solutions: [
+                    {
+                        id: "x",
+                        displayTotal: "USD100",
+                        itinerary: {
+                            carriers: [{ code: "B6" }],
+                            slices: [
+                                {
+                                    origin: { code: "BOS" },
+                                    destination: { code: "JFK" },
+                                    departure: "2026-08-10T08:00",
+                                    arrival: "2026-08-10T09:30",
+                                    flights: ["B6287"],
+                                },
+                            ],
+                        },
+                    },
+                ],
+                solutionCount: 1,
+            },
+        });
+        expect(normalize(payload).solutions[0].slices[0].carrier).toBe("B6");
+    });
+    it("handles a slice with no flights", () => {
+        const s = result.solutions[1].slices[0];
+        expect(s.stops).toBe(0);
+        expect(s.carrier).toBeUndefined();
+    });
+    it("surfaces count and minPrice", () => {
+        expect(result.count).toBe(3);
+        expect(result.shown).toBe(2);
+        expect(result.minPrice).toBe("USD200.00");
+    });
+    it("caps shown solutions at limit while keeping the full count", () => {
+        const capped = normalize(parseSearchResponse(payload), 1);
+        expect(capped.solutions).toHaveLength(1);
+        expect(capped.shown).toBe(1);
+        expect(capped.count).toBe(3);
+    });
+});
+describe("renderJson", () => {
+    it("round-trips through JSON.parse", () => {
+        const result = normalize(parseSearchResponse(payload));
+        const parsed = JSON.parse(renderJson(result));
+        expect(parsed.solutions).toHaveLength(2);
+        expect(parsed.solutions[0].total).toBe("USD200.00");
+    });
+});
+describe("renderTable", () => {
+    it("renders prices, routes and warnings", () => {
+        const out = stripAnsi(renderTable(normalize(parseSearchResponse(payload))));
+        expect(out).toContain("USD200.00");
+        expect(out).toContain("JFK→SFO");
+        expect(out).toContain("1 stop");
+        expect(out).toContain("OVERNIGHT");
+        expect(out).toContain("2 of 3 results");
+    });
+    it("reports an empty result set", () => {
+        const empty = normalize(parseSearchResponse({ solutionList: { solutions: [] } }));
+        expect(stripAnsi(renderTable(empty))).toMatch(/No flights found/);
+    });
+});
+//# sourceMappingURL=render.test.js.map

package/dist/render/render.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../../src/render/render.test.ts"],"names":[],"mappings":"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"}

package/dist/render/table.d.ts

@@ -0,0 +1,2 @@
+import type { FlatResult } from "./normalize.js";
+export declare function renderTable(result: FlatResult): string;

package/dist/render/table.js

@@ -0,0 +1,49 @@
+import Table from "cli-table3";
+import chalk from "chalk";
+function fmtTime(iso) {
+    // "2026-08-10T06:21-04:00" -> "08-10 06:21"
+    const m = iso.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}:\d{2})/);
+    if (!m)
+        return iso;
+    return `${m[2]}-${m[3]} ${m[4]}`;
+}
+function fmtDuration(min) {
+    if (min == null)
+        return "";
+    const h = Math.floor(min / 60);
+    const m = min % 60;
+    return `${h}h${String(m).padStart(2, "0")}`;
+}
+function summarizeSlice(sol) {
+    return sol.slices
+        .map((s) => {
+        const route = `${s.origin}→${s.destination}`;
+        const stops = s.stops === 0 ? "nonstop" : `${s.stops} stop`;
+        const dur = fmtDuration(s.durationMinutes);
+        const times = `${fmtTime(s.departure)}→${fmtTime(s.arrival)}`;
+        const warn = s.warnings.length ? ` ${chalk.yellow(s.warnings.join(","))}` : "";
+        return `${route} ${times} ${chalk.dim(`${stops} ${dur}`)} ${s.flights.join(" ")}${warn}`;
+    })
+        .join("\n");
+}
+export function renderTable(result) {
+    if (result.solutions.length === 0) {
+        return chalk.yellow("No flights found.");
+    }
+    const table = new Table({
+        head: [chalk.bold("Price"), chalk.bold("Carrier"), chalk.bold("Itinerary")],
+        wordWrap: true,
+        style: { head: [], border: [] },
+    });
+    for (const sol of result.solutions) {
+        table.push([
+            chalk.green(sol.total),
+            sol.carriers.join(",") || "—",
+            summarizeSlice(sol),
+        ]);
+    }
+    const header = chalk.dim(`${result.shown} of ${result.count} results` +
+        (result.minPrice ? ` · from ${result.minPrice}` : ""));
+    return `${header}\n${table.toString()}`;
+}
+//# sourceMappingURL=table.js.map

package/dist/render/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/render/table.ts"],"names":[],"mappings":"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"}