diff --git a/client/scripts/rtl-baseline.json b/client/scripts/rtl-baseline.json
index f068a4fde..699f4c2c8 100644
--- a/client/scripts/rtl-baseline.json
+++ b/client/scripts/rtl-baseline.json
@@ -34,7 +34,7 @@
"components/Map/locationMarkerMapbox.ts": 2,
"components/Map/nightPauseMarker.ts": 4,
"components/Map/ratingBadge.ts": 1,
- "components/PDF/TripPDF.tsx": 8,
+ "components/PDF/TripPDF.tsx": 7,
"components/PDF/tripMapImage.ts": 1,
"components/Packing/PackingListPanelBagCard.tsx": 1,
"components/Packing/PackingListPanelCategoryGroup.tsx": 3,
diff --git a/client/scripts/size-baseline.json b/client/scripts/size-baseline.json
index 72a08a761..b08cfde73 100644
--- a/client/scripts/size-baseline.json
+++ b/client/scripts/size-baseline.json
@@ -8,7 +8,6 @@
"src/components/Map/MapView.tsx": 1385,
"src/components/Map/MapViewGL.test.tsx": 2919,
"src/components/Map/MapViewGL.tsx": 2218,
- "src/components/PDF/TripPDF.tsx": 1039,
"src/components/Planner/DayDetailPanel.test.tsx": 2333,
"src/components/Planner/DayPlanSidebar.test.tsx": 5349,
"src/components/Planner/DayPlanSidebar.tsx": 2929,
diff --git a/client/scripts/theme-baseline.json b/client/scripts/theme-baseline.json
index a39cef2ae..aab605717 100644
--- a/client/scripts/theme-baseline.json
+++ b/client/scripts/theme-baseline.json
@@ -71,7 +71,7 @@
"components/Map/poiCategories.ts": 7,
"components/Map/ratingBadge.ts": 2,
"components/Map/reservationsMapbox.ts": 1,
- "components/PDF/TripPDF.tsx": 53,
+ "components/PDF/TripPDF.tsx": 51,
"components/Packing/PackingListPanelBagModal.tsx": 2,
"components/Packing/PackingListPanelCategoryGroup.tsx": 5,
"components/Packing/PackingListPanelHeader.tsx": 5,
diff --git a/client/src/components/PDF/TripPDF.tsx b/client/src/components/PDF/TripPDF.tsx
index 10cb3a4ba..3691a3706 100644
--- a/client/src/components/PDF/TripPDF.tsx
+++ b/client/src/components/PDF/TripPDF.tsx
@@ -8,7 +8,8 @@ import type { Trip, Day, Place, Category, AssignmentsMap, DayNote, DistanceUnit,
import { isDayInAccommodationRange, getDayOrder } from '../../utils/dayOrder'
import { hidesOnMiddleDay, getTransportForDay, getMergedItems, getSpanPhase, getDisplayTimeForDay } from '../../utils/dayMerge'
import { safeHexColor } from '../../utils/safeColor'
-import { pdfSwitchOn, rememberPdfSwitch } from '../../utils/pdfSwitch'
+import { pdfSwitchOn } from '../../utils/pdfSwitch'
+import { openPdfPreview, PAGE_BREAK_KEY, TRANSPORT_NOTES_KEY } from './pdfPreview'
import { renderIconMarkup } from '../../utils/iconMarkup'
import { formatMoney, formatMoneySum, formatClockTime, splitReservationDateTime, type MoneyEntry } from '../../utils/formatters'
import { useSettingsStore } from '../../store/settingsStore'
@@ -23,28 +24,6 @@ import { getFlightLegs, getTrainLegs, usesStationRoute } from '../../utils/fligh
import { onlyMyPlan, planAssignments } from './pdfScope'
import { createPdfMarkdown, PDF_MARKDOWN_CSS } from './pdfMarkdown'
-/**
- * Every day starts a new page by default. On a trip of short days that prints
- * one sheet per handful of lines, so the preview offers the flowing layout the
- * in-app view already uses, and remembers which one was picked (#1292).
- */
-const PAGE_BREAK_KEY = 'trek_pdf_page_break_per_day'
-
-/**
- * The notes of a flight, train or rental (#1571): printed by default, like the
- * notes of a place, and a switch in the preview leaves them out for a reader who
- * wants the plan without the fine print.
- */
-const TRANSPORT_NOTES_KEY = 'trek_pdf_transport_notes'
-
-/* The overlay is imperative DOM, so the switch from Settings/ToggleSwitch is
- rebuilt here rather than rendered — as static markup it would carry no
- behaviour. Same geometry and the same tokens, so it reads as the same control. */
-const TOGGLE_TRACK = 'position:relative;width:44px;height:24px;min-width:44px;flex-shrink:0;border-radius:12px;border:none;padding:0;cursor:pointer;transition:background 0.2s;'
-const TOGGLE_KNOB = 'position:absolute;top:2px;width:20px;height:20px;border-radius:50%;background:white;transition:left 0.2s;box-shadow:0 1px 3px rgba(0,0,0,0.2);'
-const trackColour = (on: boolean) => (on ? 'var(--accent, #111827)' : 'var(--border-primary, #d1d5db)')
-const knobOffset = (on: boolean) => (on ? '22px' : '2px')
-
function renderLucideIcon(icon:LucideIcon, props = {}) {
return renderIconMarkup(
createElement(icon, props)
@@ -891,80 +870,10 @@ ${pluginSectionsHtml}
markdown.dispose()
if (signal?.aborted) return
- // Open in modal with srcdoc iframe (no URL loading = no X-Frame-Options issue)
- const overlay = document.createElement('div')
- overlay.id = 'pdf-preview-overlay'
- overlay.style.cssText = 'position:fixed;inset:0;background:rgba(0,0,0,0.7);z-index:9999;display:flex;align-items:center;justify-content:center;padding:8px;'
- overlay.onclick = (e) => { if (e.target === overlay) overlay.remove() }
-
- const card = document.createElement('div')
- card.style.cssText = 'width:100%;max-width:1000px;height:95vh;background:var(--bg-card);border-radius:12px;overflow:hidden;display:flex;flex-direction:column;box-shadow:0 20px 60px rgba(0,0,0,0.3);'
-
- const header = document.createElement('div')
- header.style.cssText = 'display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:10px 16px;border-bottom:1px solid var(--border-primary);flex-shrink:0;'
- header.innerHTML = `
- ${escHtml(trip?.title || tr('pdf.travelPlan'))}
-
- ${hasTransportNotes ? previewSwitch('pdf-transport-notes-toggle', tr('pdf.transportNotes'), showTransportNotes) : ''}
- ${previewSwitch('pdf-daybreak-toggle', tr('pdf.pageBreakPerDay'), breaksPerDay)}
- ${tr('pdf.saveAsPdf')}
-
-
-
- `
-
- const iframe = document.createElement('iframe')
- iframe.style.cssText = 'flex:1;width:100%;border:none;'
- // No script runs inside the document (print is parent-initiated), so withhold
- // allow-scripts to keep the sandbox tight.
- iframe.sandbox = 'allow-same-origin allow-modals'
- iframe.srcdoc = html
-
- card.appendChild(header)
- card.appendChild(iframe)
- overlay.appendChild(card)
- document.body.appendChild(overlay)
-
- const closeBtn = header.querySelector('#pdf-close-btn')
- if (closeBtn) closeBtn.onclick = () => overlay.remove()
- const printBtn = header.querySelector('#pdf-print-btn')
- if (printBtn) printBtn.onclick = () => { iframe.contentWindow?.print() }
-
- // Both choices differ by one class on , so switching is instant in the
- // preview and there is no need to re-fetch photos or rebuild the document.
- wirePreviewSwitch(header, 'pdf-daybreak-toggle', on => {
- rememberPdfSwitch(PAGE_BREAK_KEY, on)
- iframe.contentDocument?.body.classList.toggle('pdf-flow', !on)
- })
- wirePreviewSwitch(header, 'pdf-transport-notes-toggle', on => {
- rememberPdfSwitch(TRANSPORT_NOTES_KEY, on)
- iframe.contentDocument?.body.classList.toggle('pdf-no-transport-notes', !on)
- })
+ openPdfPreview({ html, title: trip?.title || tr('pdf.travelPlan'), tripId: trip?.id, tr, breaksPerDay, showTransportNotes, hasTransportNotes })
}
function bodyClassAttr(breaksPerDay: boolean, showTransportNotes: boolean): string {
const classes = [!breaksPerDay && 'pdf-flow', !showTransportNotes && 'pdf-no-transport-notes'].filter(Boolean)
return classes.length ? ` class="${classes.join(' ')}"` : ''
}
-
-/** A labelled switch for the preview header, as markup; wirePreviewSwitch gives it behaviour. */
-function previewSwitch(id: string, label: string, on: boolean): string {
- return `${escHtml(label)}
-
- `
-}
-
-function wirePreviewSwitch(header: HTMLElement, id: string, onChange: (on: boolean) => void): void {
- const button = header.querySelector(`#${id}`)
- if (!button) return
- button.onclick = () => {
- const on = button.getAttribute('aria-checked') !== 'true'
- button.setAttribute('aria-checked', String(on))
- button.style.background = trackColour(on)
- const knob = button.firstElementChild as HTMLElement | null
- if (knob) knob.style.left = knobOffset(on)
- onChange(on)
- }
-}
diff --git a/client/src/components/PDF/pdfPreview.test.ts b/client/src/components/PDF/pdfPreview.test.ts
new file mode 100644
index 000000000..ef8ed870c
--- /dev/null
+++ b/client/src/components/PDF/pdfPreview.test.ts
@@ -0,0 +1,90 @@
+/**
+ * FE-PDFPREVIEW-001 to FE-PDFPREVIEW-005: the trip PDF's preview and the control
+ * that saves it. An iPhone or iPad ignores print() in the Home Screen app, so
+ * there the preview hands the export to Safari instead of offering a button that
+ * does nothing.
+ */
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { PAGE_BREAK_KEY, openPdfPreview, type PdfPreviewOptions } from './pdfPreview';
+
+const tr = (key: string) => key;
+
+function open(overrides: Partial = {}) {
+ openPdfPreview({
+ html: 'plan',
+ title: 'Lisbon',
+ tripId: 9,
+ tr,
+ breaksPerDay: true,
+ showTransportNotes: true,
+ hasTransportNotes: false,
+ ...overrides,
+ });
+}
+
+function standalone(value: boolean) {
+ Object.defineProperty(navigator, 'standalone', { configurable: true, get: () => value });
+}
+
+afterEach(() => {
+ document.getElementById('pdf-preview-overlay')?.remove();
+ delete (navigator as unknown as Record).standalone;
+ localStorage.clear();
+});
+
+describe('openPdfPreview', () => {
+ it('FE-PDFPREVIEW-001: a browser gets the print button, and it prints the frame', () => {
+ open();
+ expect(document.getElementById('pdf-safari-link')).toBeNull();
+ expect(document.getElementById('pdf-safari-hint')).toBeNull();
+
+ const iframe = document.querySelector('#pdf-preview-overlay iframe');
+ const print = vi.fn();
+ Object.defineProperty(iframe, 'contentWindow', { value: { print }, configurable: true });
+ const button = document.getElementById('pdf-print-btn');
+ expect(button?.textContent).toBe('pdf.saveAsPdf');
+ button?.click();
+ expect(print).toHaveBeenCalledTimes(1);
+ });
+
+ it('FE-PDFPREVIEW-002: the iOS Home Screen app gets a Safari link to the trip export and says why', () => {
+ standalone(true);
+ open();
+ expect(document.getElementById('pdf-print-btn')).toBeNull();
+
+ const link = document.getElementById('pdf-safari-link') as HTMLAnchorElement;
+ expect(link.textContent).toBe('pdf.openInSafari');
+ expect(link.target).toBe('_blank');
+ expect(link.rel).toBe('noopener');
+ const url = new URL(link.href);
+ expect(url.pathname).toBe('/trips/9');
+ expect(url.searchParams.get('export')).toBe('pdf');
+ expect(document.getElementById('pdf-safari-hint')?.textContent).toBe('pdf.safariHint');
+ });
+
+ it('FE-PDFPREVIEW-003: without a trip to hand over, the preview keeps the print button', () => {
+ standalone(true);
+ open({ tripId: undefined });
+ expect(document.getElementById('pdf-print-btn')).not.toBeNull();
+ expect(document.getElementById('pdf-safari-link')).toBeNull();
+ });
+
+ it('FE-PDFPREVIEW-004: the title is escaped and the close button removes the preview', () => {
+ open({ title: 'Lisbon ' });
+ const overlay = document.getElementById('pdf-preview-overlay');
+ expect(overlay?.querySelector('b')).toBeNull();
+ expect(overlay?.textContent).toContain('Lisbon ');
+ document.getElementById('pdf-close-btn')?.click();
+ expect(document.getElementById('pdf-preview-overlay')).toBeNull();
+ });
+
+ it('FE-PDFPREVIEW-005: the page-break switch flips and remembers the choice', () => {
+ open();
+ const toggle = document.getElementById('pdf-daybreak-toggle');
+ expect(toggle?.getAttribute('aria-checked')).toBe('true');
+ toggle?.click();
+ expect(toggle?.getAttribute('aria-checked')).toBe('false');
+ expect(localStorage.getItem(PAGE_BREAK_KEY)).not.toBeNull();
+ });
+});
diff --git a/client/src/components/PDF/pdfPreview.ts b/client/src/components/PDF/pdfPreview.ts
new file mode 100644
index 000000000..4c83b04e9
--- /dev/null
+++ b/client/src/components/PDF/pdfPreview.ts
@@ -0,0 +1,167 @@
+import { escapeHtml } from '@trek/shared';
+
+import { isIosStandalone } from '../../utils/iosDevice';
+import { pdfExportUrl } from '../../utils/pdfSafariHandoff';
+import { rememberPdfSwitch } from '../../utils/pdfSwitch';
+
+/**
+ * Every day starts a new page by default. On a trip of short days that prints
+ * one sheet per handful of lines, so the preview offers the flowing layout the
+ * in-app view already uses, and remembers which one was picked (#1292).
+ */
+export const PAGE_BREAK_KEY = 'trek_pdf_page_break_per_day';
+
+/**
+ * The notes of a flight, train or rental (#1571): printed by default, like the
+ * notes of a place, and a switch in the preview leaves them out for a reader who
+ * wants the plan without the fine print.
+ */
+export const TRANSPORT_NOTES_KEY = 'trek_pdf_transport_notes';
+
+/* The overlay is imperative DOM, so the switch from Settings/ToggleSwitch is
+ rebuilt here rather than rendered — as static markup it would carry no
+ behaviour. Same geometry and the same tokens, so it reads as the same control. */
+const TOGGLE_TRACK =
+ 'position:relative;width:44px;height:24px;min-width:44px;flex-shrink:0;border-radius:12px;border:none;padding:0;cursor:pointer;transition:background 0.2s;';
+const TOGGLE_KNOB =
+ 'position:absolute;top:2px;width:20px;height:20px;border-radius:50%;background:white;transition:left 0.2s;box-shadow:0 1px 3px rgba(0,0,0,0.2);';
+const trackColour = (on: boolean) => (on ? 'var(--accent, #111827)' : 'var(--border-primary, #d1d5db)');
+const knobOffset = (on: boolean) => (on ? '22px' : '2px');
+
+const HEADER_ACTION =
+ 'display:flex;align-items:center;gap:5px;font-size:12px;font-weight:500;color:var(--text-muted);background:none;border:none;cursor:pointer;padding:4px 8px;border-radius:6px;font-family:inherit';
+
+type Translate = (key: string, params?: Record) => string;
+
+export interface PdfPreviewOptions {
+ /** The finished document, shown in a sandboxed srcdoc frame. */
+ html: string;
+ title: string;
+ /** The trip the document prints, for the hand-over to Safari; without it the preview only prints. */
+ tripId?: number;
+ tr: Translate;
+ breaksPerDay: boolean;
+ showTransportNotes: boolean;
+ /** The transport-notes switch only shows when there is a note to hide. */
+ hasTransportNotes: boolean;
+}
+
+/**
+ * The control that saves the document. A browser prints the frame and offers
+ * "Save as PDF" in its dialog. An iPhone or iPad running TREK from the Home
+ * Screen ignores print() altogether, so there the control opens the trip in
+ * Safari with the export dialog up, and a line under the header says why.
+ */
+function saveControl(tripId: number | undefined, tr: Translate): { html: string; hint: string | null } {
+ if (tripId == null || !isIosStandalone()) {
+ return {
+ html: `${escapeHtml(tr('pdf.saveAsPdf'))} `,
+ hint: null,
+ };
+ }
+ return {
+ // target=_blank leaves the installed app for Safari; a link, not script, so the tap itself opens it.
+ html: `${escapeHtml(tr('pdf.openInSafari'))} `,
+ hint: tr('pdf.safariHint'),
+ };
+}
+
+/** Opens the document in a modal over the app, with its layout switches and the control that saves it. */
+export function openPdfPreview({
+ html,
+ title,
+ tripId,
+ tr,
+ breaksPerDay,
+ showTransportNotes,
+ hasTransportNotes,
+}: PdfPreviewOptions): void {
+ // Open in modal with srcdoc iframe (no URL loading = no X-Frame-Options issue)
+ const overlay = document.createElement('div');
+ overlay.id = 'pdf-preview-overlay';
+ overlay.style.cssText =
+ 'position:fixed;inset:0;background:var(--overlay);z-index:var(--z-modal);display:flex;align-items:center;justify-content:center;padding:8px;';
+ overlay.onclick = (e) => {
+ if (e.target === overlay) overlay.remove();
+ };
+
+ const card = document.createElement('div');
+ card.style.cssText =
+ 'width:100%;max-width:1000px;height:95vh;background:var(--bg-card);border-radius:12px;overflow:hidden;display:flex;flex-direction:column;box-shadow:0 20px 60px rgba(0,0,0,0.3);';
+
+ const save = saveControl(tripId, tr);
+ const header = document.createElement('div');
+ header.style.cssText =
+ 'display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:10px 16px;border-bottom:1px solid var(--border-primary);flex-shrink:0;';
+ header.innerHTML = `
+ ${escapeHtml(title)}
+
+ ${hasTransportNotes ? previewSwitch('pdf-transport-notes-toggle', tr('pdf.transportNotes'), showTransportNotes) : ''}
+ ${previewSwitch('pdf-daybreak-toggle', tr('pdf.pageBreakPerDay'), breaksPerDay)}
+ ${save.html}
+
+
+
+ `;
+
+ const iframe = document.createElement('iframe');
+ iframe.style.cssText = 'flex:1;width:100%;border:none;';
+ // No script runs inside the document (print is parent-initiated), so withhold
+ // allow-scripts to keep the sandbox tight.
+ iframe.sandbox = 'allow-same-origin allow-modals';
+ iframe.srcdoc = html;
+
+ card.appendChild(header);
+ if (save.hint) {
+ const hint = document.createElement('p');
+ hint.id = 'pdf-safari-hint';
+ hint.style.cssText =
+ 'margin:0;padding:8px 16px;font-size:12px;line-height:1.4;color:var(--text-muted);background:var(--bg-secondary);border-bottom:1px solid var(--border-primary);flex-shrink:0;';
+ hint.textContent = save.hint;
+ card.appendChild(hint);
+ }
+ card.appendChild(iframe);
+ overlay.appendChild(card);
+ document.body.appendChild(overlay);
+
+ const closeBtn = header.querySelector('#pdf-close-btn');
+ if (closeBtn) closeBtn.onclick = () => overlay.remove();
+ const printBtn = header.querySelector('#pdf-print-btn');
+ if (printBtn)
+ printBtn.onclick = () => {
+ iframe.contentWindow?.print();
+ };
+
+ // Both choices differ by one class on , so switching is instant in the
+ // preview and there is no need to re-fetch photos or rebuild the document.
+ wirePreviewSwitch(header, 'pdf-daybreak-toggle', (on) => {
+ rememberPdfSwitch(PAGE_BREAK_KEY, on);
+ iframe.contentDocument?.body.classList.toggle('pdf-flow', !on);
+ });
+ wirePreviewSwitch(header, 'pdf-transport-notes-toggle', (on) => {
+ rememberPdfSwitch(TRANSPORT_NOTES_KEY, on);
+ iframe.contentDocument?.body.classList.toggle('pdf-no-transport-notes', !on);
+ });
+}
+
+/** A labelled switch for the preview header, as markup; wirePreviewSwitch gives it behaviour. */
+function previewSwitch(id: string, label: string, on: boolean): string {
+ return `${escapeHtml(label)}
+
+ `;
+}
+
+function wirePreviewSwitch(header: HTMLElement, id: string, onChange: (on: boolean) => void): void {
+ const button = header.querySelector(`#${id}`);
+ if (!button) return;
+ button.onclick = () => {
+ const on = button.getAttribute('aria-checked') !== 'true';
+ button.setAttribute('aria-checked', String(on));
+ button.style.background = trackColour(on);
+ const knob = button.firstElementChild as HTMLElement | null;
+ if (knob) knob.style.insetInlineStart = knobOffset(on);
+ onChange(on);
+ };
+}
diff --git a/client/src/components/Planner/DayPlanSidebarToolbar.test.tsx b/client/src/components/Planner/DayPlanSidebarToolbar.test.tsx
index 523b92f5c..b6c779084 100644
--- a/client/src/components/Planner/DayPlanSidebarToolbar.test.tsx
+++ b/client/src/components/Planner/DayPlanSidebarToolbar.test.tsx
@@ -1,4 +1,4 @@
-// FE-PLANNER-DPTOOLBAR-001 to FE-PLANNER-DPTOOLBAR-026
+// FE-PLANNER-DPTOOLBAR-001 to FE-PLANNER-DPTOOLBAR-027
import { render, screen, waitFor, fireEvent } from '../../../tests/helpers/render'
import userEvent from '@testing-library/user-event'
import { downloadTripPDF } from '../PDF/TripPDF'
@@ -84,6 +84,12 @@ describe('DayPlanSidebarToolbar', () => {
expect(screen.queryByText('dayplan.pdf')).not.toBeInTheDocument()
})
+ it('FE-PLANNER-DPTOOLBAR-027: ?export=pdf, as Safari opens it from the iOS Home Screen app, opens the dialog', () => {
+ render({children}
+ );
+ const { result, rerender } = renderHook(
+ () => {
+ useExportDeepLink(openExport);
+ return useLocation();
+ },
+ { wrapper }
+ );
+ return { openExport, result, rerender };
+}
+
+describe('useExportDeepLink', () => {
+ it('FE-EXPORTLINK-001: opens the export and drops the parameter, keeping the others', () => {
+ const { openExport, result, rerender } = setup('/trips/7?tab=plan&export=pdf');
+ expect(openExport).toHaveBeenCalledTimes(1);
+ expect(result.current.pathname).toBe('/trips/7');
+ expect(result.current.search).toBe('?tab=plan');
+
+ rerender();
+ expect(openExport).toHaveBeenCalledTimes(1);
+ });
+
+ it('FE-EXPORTLINK-002: leaves the trip alone without the parameter', () => {
+ const { openExport, result } = setup('/trips/7?tab=plan');
+ expect(openExport).not.toHaveBeenCalled();
+ expect(result.current.search).toBe('?tab=plan');
+ });
+
+ it('FE-EXPORTLINK-003: ignores an export it does not know', () => {
+ const { openExport, result } = setup('/trips/7?export=gpx');
+ expect(openExport).not.toHaveBeenCalled();
+ expect(result.current.search).toBe('?export=gpx');
+ });
+});
diff --git a/client/src/hooks/useExportDeepLink.ts b/client/src/hooks/useExportDeepLink.ts
new file mode 100644
index 000000000..b95b620c2
--- /dev/null
+++ b/client/src/hooks/useExportDeepLink.ts
@@ -0,0 +1,28 @@
+import { useEffect, useEffectEvent } from 'react';
+import { useSearchParams } from 'react-router';
+
+import { EXPORT_PARAM, EXPORT_PDF } from '../utils/pdfSafariHandoff';
+
+/**
+ * Opens the trip's export when the address asks for it (`?export=pdf`), the way
+ * the iOS Home Screen app hands a PDF over to Safari. The parameter is dropped
+ * once read, so a reload or a copied link does not open the dialog again.
+ */
+export function useExportDeepLink(openExport: () => void): void {
+ const [searchParams, setSearchParams] = useSearchParams();
+ const requested = searchParams.get(EXPORT_PARAM) === EXPORT_PDF;
+ // The shells pass a fresh closure on every render; the request is answered once.
+ const open = useEffectEvent(openExport);
+
+ useEffect(() => {
+ if (!requested) return;
+ open();
+ setSearchParams(
+ (p) => {
+ p.delete(EXPORT_PARAM);
+ return p;
+ },
+ { replace: true }
+ );
+ }, [requested, setSearchParams]);
+}
diff --git a/client/src/mobile/screens/trip/sheets/MExportSheet.tsx b/client/src/mobile/screens/trip/sheets/MExportSheet.tsx
index 2889fa9a5..676aede24 100644
--- a/client/src/mobile/screens/trip/sheets/MExportSheet.tsx
+++ b/client/src/mobile/screens/trip/sheets/MExportSheet.tsx
@@ -5,6 +5,7 @@ import { IcsSubscribeModal } from '../../../../components/Planner/IcsSubscribeMo
import { useTripStore } from '../../../../store/tripStore'
import { useTranslation } from '../../../../i18n'
import { useTripExport } from '../../../../components/Planner/useTripExport'
+import { useExportDeepLink } from '../../../../hooks/useExportDeepLink'
import { INNER_CLS, TileHeader } from './MTripSheetUi'
import type { MTripSheetsProps } from '../MTripShell'
import type { LucideIcon } from 'lucide-react'
@@ -20,6 +21,8 @@ export default function MExportSheet({ planner, shell }: MTripSheetsProps) {
const open = shell.sheet?.id === 'export'
const dayNotes = useTripStore(s => s.dayNotes)
const [subscribeOpen, setSubscribeOpen] = useState(false)
+ // The iOS Home Screen app hands the PDF to Safari, which lands here with ?export=pdf.
+ useExportDeepLink(() => shell.openSheet('export'))
// Fed the way the desktop dialog feeds it: the store's assignments, and the export
// applies the day plan's filter itself, so both shells print the same. The PDF stays
// open here; a calendar or GPX file closes the sheet.
diff --git a/client/src/utils/pdfSafariHandoff.test.ts b/client/src/utils/pdfSafariHandoff.test.ts
new file mode 100644
index 000000000..453ce9425
--- /dev/null
+++ b/client/src/utils/pdfSafariHandoff.test.ts
@@ -0,0 +1,15 @@
+/**
+ * FE-PDFSAFARI-001: the link the iOS Home Screen app hands to Safari.
+ */
+import { describe, expect, it } from 'vitest';
+
+import { EXPORT_PARAM, EXPORT_PDF, pdfExportUrl } from './pdfSafariHandoff';
+
+describe('pdfExportUrl', () => {
+ it('FE-PDFSAFARI-001: is the absolute trip address with the export asked for', () => {
+ const url = new URL(pdfExportUrl(42));
+ expect(url.origin).toBe(window.location.origin);
+ expect(url.pathname).toBe('/trips/42');
+ expect(url.searchParams.get(EXPORT_PARAM)).toBe(EXPORT_PDF);
+ });
+});
diff --git a/client/src/utils/pdfSafariHandoff.ts b/client/src/utils/pdfSafariHandoff.ts
new file mode 100644
index 000000000..a4c492ca7
--- /dev/null
+++ b/client/src/utils/pdfSafariHandoff.ts
@@ -0,0 +1,14 @@
+/**
+ * An iPhone or iPad ignores print() in an app added to the Home Screen, in the
+ * page and in an iframe alike, so the trip PDF cannot be saved from there. Safari
+ * can print it. This is the link that hands the export over: it opens the trip in
+ * Safari with the export dialog already up.
+ */
+
+export const EXPORT_PARAM = 'export';
+export const EXPORT_PDF = 'pdf';
+
+/** The trip, opened with its export dialog showing. Absolute, since it leaves the installed app. */
+export function pdfExportUrl(tripId: number): string {
+ return `${window.location.origin}/trips/${tripId}?${EXPORT_PARAM}=${EXPORT_PDF}`;
+}
diff --git a/client/tests/unit/mobile/trip/MExportSheet.test.tsx b/client/tests/unit/mobile/trip/MExportSheet.test.tsx
index 2f0ea4321..0871e364f 100644
--- a/client/tests/unit/mobile/trip/MExportSheet.test.tsx
+++ b/client/tests/unit/mobile/trip/MExportSheet.test.tsx
@@ -9,7 +9,7 @@ import { server } from '../../../helpers/msw/server'
import { resetAllStores, seedStore } from '../../../helpers/store'
import { act, fireEvent, render, screen, waitFor } from '../../../helpers/render'
-// FE-MOB-EXPSH-001 to FE-MOB-EXPSH-015
+// FE-MOB-EXPSH-001 to FE-MOB-EXPSH-016
// This sheet reads its copy from useTranslation(), so the assertions are English.
vi.mock('../../../../src/components/PDF/TripPDF', () => ({ downloadTripPDF: vi.fn() }))
@@ -248,4 +248,10 @@ describe('MExportSheet', () => {
expect(route?.signal?.aborted).toBe(true)
expect(signal?.aborted).toBe(true)
})
+
+ it('FE-MOB-EXPSH-016: ?export=pdf, as Safari opens it from the iOS Home Screen app, opens the sheet', () => {
+ const shell = buildShell({ sheet: null })
+ render(