swup 4.3.4 → 4.4.1

package/src/modules/Cache.ts

@@ -1,6 +1,6 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { Location } from '../helpers.js';
-import { PageData } from './fetchPage.js';
+import { type PageData } from './fetchPage.js';
 
 export interface CacheData extends PageData {}
 

package/src/modules/Classes.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { queryAll } from '../utils.js';
 
 export class Classes {

package/src/modules/Hooks.ts

@@ -1,9 +1,9 @@
-import { DelegateEvent } from 'delegate-it';
+import type { DelegateEvent } from 'delegate-it';
 
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { isPromise, runAsPromise } from '../utils.js';
-import { Visit } from './Visit.js';
-import { FetchOptions, PageData } from './fetchPage.js';
+import type { Visit } from './Visit.js';
+import type { FetchOptions, PageData } from './fetchPage.js';
 
 export interface HookDefinitions {
 	'animation:out:start': undefined;
@@ -21,6 +21,7 @@ export interface HookDefinitions {
 	'disable': undefined;
 	'fetch:request': { url: string; options: FetchOptions };
 	'fetch:error': { url: string; status: number; response: Response };
+	'fetch:timeout': { url: string };
 	'history:popstate': { event: PopStateEvent };
 	'link:click': { el: HTMLAnchorElement; event: DelegateEvent<MouseEvent> };
 	'link:self': undefined;
@@ -31,6 +32,7 @@ export interface HookDefinitions {
 	'scroll:top': { options: ScrollIntoViewOptions };
 	'scroll:anchor': { hash: string; options: ScrollIntoViewOptions };
 	'visit:start': undefined;
+	'visit:transition': undefined;
 	'visit:end': undefined;
 }
 
@@ -40,6 +42,7 @@ export interface HookReturnValues {
 	'page:load': Promise<PageData>;
 	'scroll:top': boolean;
 	'scroll:anchor': boolean;
+	'visit:transition': Promise<boolean>;
 }
 
 export type HookArguments<T extends HookName> = HookDefinitions[T];
@@ -131,6 +134,7 @@ export class Hooks {
 		'disable',
 		'fetch:request',
 		'fetch:error',
+		'fetch:timeout',
 		'history:popstate',
 		'link:click',
 		'link:self',
@@ -141,6 +145,7 @@ export class Hooks {
 		'scroll:top',
 		'scroll:anchor',
 		'visit:start',
+		'visit:transition',
 		'visit:end'
 	];
 

package/src/modules/Visit.ts

@@ -1,5 +1,6 @@
-import Swup, { Options } from '../Swup.js';
-import { HistoryAction, HistoryDirection } from './navigate.js';
+import type Swup from '../Swup.js';
+import type { Options } from '../Swup.js';
+import type { HistoryAction, HistoryDirection } from './navigate.js';
 
 /** An object holding details about the current visit. */
 export interface Visit {

package/src/modules/animatePageIn.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { nextTick } from '../utils.js';
 
 /**

package/src/modules/animatePageOut.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { classify } from '../helpers.js';
 
 /**

package/src/modules/awaitAnimations.ts

@@ -1,5 +1,6 @@
 import { queryAll, toMs } from '../utils.js';
-import Swup, { Options } from '../Swup.js';
+import type Swup from '../Swup.js';
+import type { Options } from '../Swup.js';
 
 const TRANSITION = 'transition';
 const ANIMATION = 'animation';

package/src/modules/fetchPage.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { Location } from '../helpers.js';
 
 /** A page object as used by swup and its cache. */
@@ -15,16 +15,25 @@ export interface FetchOptions extends Omit<RequestInit, 'cache'> {
 	method?: 'GET' | 'POST';
 	/** The body of the request: raw string, form data object or URL params. */
 	body?: string | FormData | URLSearchParams;
+	/** The request timeout in milliseconds. */
+	timeout?: number;
 }
 
 export class FetchError extends Error {
 	url: string;
-	status: number;
-	constructor(message: string, details: { url: string; status: number }) {
+	status?: number;
+	aborted: boolean;
+	timedOut: boolean;
+	constructor(
+		message: string,
+		details: { url: string; status?: number; aborted?: boolean; timedOut?: boolean }
+	) {
 		super(message);
 		this.name = 'FetchError';
 		this.url = details.url;
 		this.status = details.status;
+		this.aborted = details.aborted || false;
+		this.timedOut = details.timedOut || false;
 	}
 }
 
@@ -39,14 +48,44 @@ export async function fetchPage(
 	url = Location.fromUrl(url).url;
 
 	const headers = { ...this.options.requestHeaders, ...options.headers };
-	options = { ...options, headers };
+	const timeout = options.timeout ?? this.options.timeout;
+	const controller = new AbortController();
+	const { signal } = controller;
+	options = { ...options, headers, signal };
+
+	let timedOut = false;
+	let timeoutId: ReturnType<typeof setTimeout> | null = null;
+	if (timeout && timeout > 0) {
+		timeoutId = setTimeout(() => {
+			timedOut = true;
+			controller.abort('timeout');
+		}, timeout);
+	}
 
 	// Allow hooking before this and returning a custom response-like object (e.g. custom fetch implementation)
-	const response: Response = await this.hooks.call(
-		'fetch:request',
-		{ url, options },
-		(visit, { url, options }) => fetch(url, options)
-	);
+	let response: Response;
+	try {
+		response = await this.hooks.call(
+			'fetch:request',
+			{ url, options },
+			(visit, { url, options }) => fetch(url, options)
+		);
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+		}
+	} catch (error) {
+		if (timedOut) {
+			this.hooks.call('fetch:timeout', { url });
+			throw new FetchError(`Request timed out: ${url}`, { url, timedOut });
+		}
+		if ((error as Error)?.name === 'AbortError' || signal.aborted) {
+			throw new FetchError(`Request aborted: ${url}`, {
+				url: url,
+				aborted: true
+			});
+		}
+		throw error;
+	}
 
 	const { status, url: responseUrl } = response;
 	const html = await response.text();

package/src/modules/navigate.ts

@@ -1,7 +1,7 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 import { createHistoryRecord, updateHistoryRecord, getCurrentUrl, Location } from '../helpers.js';
-import { FetchOptions, PageData } from './fetchPage.js';
-import { VisitInitOptions } from './Visit.js';
+import { FetchError, type FetchOptions, type PageData } from './fetchPage.js';
+import type { VisitInitOptions } from './Visit.js';
 
 export type HistoryAction = 'push' | 'replace';
 export type HistoryDirection = 'forwards' | 'backwards';
@@ -62,6 +62,7 @@ export async function performNavigation(
 	this: Swup,
 	options: NavigationOptions & FetchOptions = {}
 ): Promise<void> {
+	this.navigating = true;
 	// Save this localy to a) allow ignoring the visit if a new one was started in the meantime
 	// and b) avoid unintended modifications to any newer visits
 	const visit = this.visit;
@@ -137,20 +138,27 @@ export async function performNavigation(
 			visit.to.html = html;
 		}
 
-		// Wait for page to load and leave animation to finish
-		const animationPromise = this.animatePageOut();
-		const [page] = await Promise.all([pagePromise, animationPromise]);
+		// perform the actual transition: animate and replace content
+		await this.hooks.call('visit:transition', undefined, async (visit) => {
+			// Start leave animation
+			const animationPromise = this.animatePageOut();
 
-		// Abort if another visit was started in the meantime
-		if (visit.id !== this.visit.id) {
-			return;
-		}
+			// Wait for page to load and leave animation to finish
+			const [page] = await Promise.all([pagePromise, animationPromise]);
+
+			// Abort if another visit was started in the meantime
+			if (visit.id !== this.visit.id) {
+				return false;
+			}
 
-		// Render page: replace content and scroll to top/fragment
-		await this.renderPage(page);
+			// Render page: replace content and scroll to top/fragment
+			await this.renderPage(page);
 
-		// Wait for enter animation
-		await this.animatePageIn();
+			// Wait for enter animation
+			await this.animatePageIn();
+
+			return true;
+		});
 
 		// Finalize visit
 		await this.hooks.call('visit:end', undefined, () => this.classes.clear());
@@ -159,9 +167,10 @@ export async function performNavigation(
 		// if (visit.to && this.isSameResolvedUrl(visit.to.url, requestedUrl)) {
 		// 	this.visit = this.createVisit({ to: undefined });
 		// }
-	} catch (error: unknown) {
-		// Return early if error is undefined (probably aborted preload request)
-		if (!error) {
+		this.navigating = false;
+	} catch (error) {
+		// Return early if error is undefined or signals an aborted request
+		if (!error || (error as FetchError)?.aborted) {
 			return;
 		}
 

package/src/modules/plugins.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 
 export type Plugin = {
 	/** Identify as a swup plugin */

package/src/modules/renderPage.ts

@@ -1,6 +1,6 @@
 import { updateHistoryRecord, getCurrentUrl, classify } from '../helpers.js';
-import Swup from '../Swup.js';
-import { PageData } from './fetchPage.js';
+import type Swup from '../Swup.js';
+import type { PageData } from './fetchPage.js';
 
 /**
  * Render the next page: replace the content and update scroll position.

package/src/modules/replaceContent.ts

@@ -1,6 +1,7 @@
-import Swup, { Options } from '../Swup.js';
+import type Swup from '../Swup.js';
+import type { Options } from '../Swup.js';
 import { query, queryAll } from '../utils.js';
-import { PageData } from './fetchPage.js';
+import type { PageData } from './fetchPage.js';
 
 /**
  * Perform the replacement of content after loading a page.

package/src/modules/resolveUrl.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 
 /**
  * Utility function to validate and run the global option 'resolveUrl'

package/src/modules/scrollToContent.ts

@@ -1,4 +1,4 @@
-import Swup from '../Swup.js';
+import type Swup from '../Swup.js';
 
 /**
  * Update the scroll position after page render.

package/dist/types/__test__/index.test.d.ts

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

package/dist/types/helpers/__test__/matchPath.test.d.ts

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

package/dist/types/modules/__test__/cache.test.d.ts

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

package/dist/types/modules/__test__/delegateEvent.test.d.ts

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

package/dist/types/modules/__test__/hooks.test.d.ts

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

package/dist/types/modules/__test__/plugins.test.d.ts

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

package/dist/types/modules/__test__/replaceContent.test.d.ts

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

package/dist/types/modules/__test__/visit.test.d.ts

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

package/src/__test__/index.test.ts

@@ -1,83 +0,0 @@
-import { DelegateEvent } from 'delegate-it';
-import { describe, expect, it, vi } from 'vitest';
-
-import pckg from '../../package.json';
-import Swup, { Options, Plugin } from '../index.js';
-import * as SwupTS from '../Swup.js';
-
-const baseUrl = window.location.origin;
-
-describe('Exports', () => {
-	it('should export Swup and Options/Plugin types', () => {
-		class SwupPlugin implements Plugin {
-			name = 'SwupPlugin';
-			isSwupPlugin = true as const;
-			mount = () => {};
-			unmount = () => {};
-		}
-
-		const options: Partial<Options> = {
-			animateHistoryBrowsing: false,
-			animationSelector: '[class*="transition-"]',
-			cache: true,
-			containers: ['#swup'],
-			ignoreVisit: (url, { el } = {}) => !!el?.closest('[data-no-swup]'),
-			linkSelector: 'a[href]',
-			plugins: [new SwupPlugin()],
-			resolveUrl: (url) => url,
-			requestHeaders: {
-				'X-Requested-With': 'swup',
-				'Accept': 'text/html, application/xhtml+xml'
-			},
-			skipPopStateHandling: (event) => event.state?.source !== 'swup'
-		};
-
-		const swup = new Swup(options);
-		expect(swup).toBeInstanceOf(Swup);
-	});
-
-	it('should define a version', () => {
-		const swup = new Swup();
-		expect(swup.version).not.toBeUndefined();
-		expect(swup.version).toEqual(pckg.version);
-	});
-
-	it('UMD compatibility: Swup.ts should only have a default export', () => {
-		expect(Object.keys(SwupTS)).toEqual(['default']);
-	});
-});
-
-describe('ignoreVisit', () => {
-	it('should be called with relative URL', () => {
-		const ignoreVisit = vi.fn(() => true);
-		const swup = new Swup({ ignoreVisit });
-		swup.shouldIgnoreVisit(`${baseUrl}/path/?query#hash`);
-
-		expect(ignoreVisit.mock.calls).toHaveLength(1);
-		expect((ignoreVisit.mock.lastCall as any)[0]).toEqual('/path/?query#hash');
-	});
-
-	it('should have access to element and event params', () => {
-		const el = document.createElement('a');
-		el.href = `${baseUrl}/path/?query#hash`;
-		const event = new MouseEvent('click') as DelegateEvent<MouseEvent>;
-		event.delegateTarget = el;
-
-		const ignoreVisit = vi.fn(() => true);
-		const swup = new Swup({ ignoreVisit });
-		swup.navigate(el.href, {}, { el, event });
-
-		expect(ignoreVisit.mock.calls).toHaveLength(1);
-		expect((ignoreVisit.mock.lastCall as any)[1]).toEqual(
-			expect.objectContaining({ el, event })
-		);
-	});
-
-	it('should be called from visit method', () => {
-		const ignoreVisit = vi.fn(() => true);
-		const swup = new Swup({ ignoreVisit });
-		swup.navigate('/path/');
-
-		expect(ignoreVisit.mock.calls).toHaveLength(1);
-	});
-});

package/src/helpers/__test__/matchPath.test.ts

@@ -1,54 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { matchPath } from '../../index.js';
-import { pathToRegexp } from 'path-to-regexp';
-
-describe('matchPath', () => {
-	it('should return false if not matching', () => {
-		const urlMatch = matchPath('/users/:user');
-		const match = urlMatch('/posts/');
-		expect(match).toBe(false);
-	});
-
-	it('should return an object if matching', () => {
-		const urlMatch = matchPath('/users/:user');
-		const match = urlMatch('/users/bob');
-		expect(match).toEqual({
-			path: '/users/bob',
-			index: 0,
-			params: { user: 'bob' }
-		});
-	});
-
-	it('should work with primitive strings', () => {
-		const urlMatch = matchPath<{ user: string }>('/users/:user');
-		const match = urlMatch('/users/bob');
-		const params = !match ? false : match.params;
-		expect(params).toEqual({ user: 'bob' });
-	});
-
-	it('should work with an array of paths', () => {
-		const urlMatch = matchPath<{ user: string }>(['/users/', '/users/:user']);
-
-		const { params: withParams } = urlMatch('/users/bob') || {};
-		expect(withParams).toEqual({ user: 'bob' });
-
-		const { params: withoutParams } = urlMatch('/users/') || {};
-		expect(withoutParams).toEqual({});
-	});
-
-	/**
-	 * When passing a regex to `match`, the params in the response are sorted by appearance.
-	 * Only helpful for falsy/truthy detection
-	 */
-	it('should work with regex', () => {
-		const re = pathToRegexp('/users/:user');
-		const urlMatch = matchPath(re);
-		const { params } = urlMatch('/users/bob') || {};
-		expect(params).toEqual({ '0': 'bob' });
-	});
-
-	it('should throw with malformed paths', () => {
-		// prettier-ignore
-		expect(() => matchPath('/\?user=:user')).toThrowError('[swup] Error parsing path');
-	});
-});

package/src/modules/__test__/cache.test.ts

@@ -1,159 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import Swup from '../../Swup.js';
-import { Cache, CacheData } from '../Cache.js';
-import { Visit } from '../Visit.js';
-
-interface CacheTtlData {
-	ttl: number;
-	created: number;
-}
-
-interface CacheIndexData {
-	index: number;
-}
-
-interface AugmentedCacheData extends CacheData, CacheTtlData, CacheIndexData {}
-
-const swup = new Swup();
-const visit = swup.visit;
-const cache = new Cache(swup);
-
-const page1 = { url: '/page-1', html: '1' };
-const page2 = { url: '/page-2', html: '2' };
-const page3 = { url: '/page-3', html: '3' };
-
-describe('Cache', () => {
-	beforeEach(() => {
-		cache.clear();
-	});
-
-	it('should be empty', () => {
-		expect(cache.size).toBe(0);
-	});
-
-	it('should append pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.size).toBe(1);
-	});
-
-	it('should have pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.has(page1.url)).toBe(true);
-	});
-
-	it('should get pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.get(page1.url)).toEqual(page1);
-	});
-
-	it('should delete pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.has(page1.url)).toBe(true);
-		cache.delete(page1.url);
-		expect(cache.has(page1.url)).toBe(false);
-	});
-
-	it('should clear', () => {
-		cache.set(page1.url, page1);
-		expect(cache.size).toBe(1);
-		cache.clear();
-		expect(cache.size).toBe(0);
-	});
-
-	it('should overwrite identical pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.size).toBe(1);
-		cache.set(page1.url, page1);
-		expect(cache.size).toBe(1);
-	});
-
-	it('should not overwrite different pages', () => {
-		cache.set(page1.url, page1);
-		expect(cache.size).toBe(1);
-		cache.set(page2.url, page2);
-		expect(cache.size).toBe(2);
-	});
-
-	it('should trigger a hook on set', () => {
-		const handler = vi.fn();
-
-		swup.hooks.on('cache:set', handler);
-
-		cache.set(page1.url, page1);
-
-		expect(handler).toBeCalledTimes(1);
-		expect(handler).toBeCalledWith(visit, { page: page1 }, undefined);
-	});
-
-	it('should allow augmenting cache entries on save', () => {
-		const now = Date.now();
-
-		swup.hooks.on('cache:set', (_, { page }) => {
-			const ttl: CacheTtlData = { ttl: 1000, created: now };
-			cache.update(page.url, ttl);
-		});
-
-		cache.set('/page', { url: '/page', html: '' });
-
-		const page = cache.get('/page');
-
-		expect(page).toEqual({ url: '/page', html: '', ttl: 1000, created: now });
-	});
-
-	it('should allow manual pruning', () => {
-		swup.hooks.on('cache:set', (_, { page }) => {
-			cache.update(page.url, { index: cache.size });
-		});
-
-		cache.set(page1.url, page1);
-		cache.set(page2.url, page2);
-		cache.set(page3.url, page3);
-
-		cache.prune((url, page) => (page as AugmentedCacheData).index > 2);
-
-		expect(cache.size).toBe(2);
-		expect(cache.has(page1.url)).toBe(true);
-		expect(cache.has(page2.url)).toBe(true);
-		expect(cache.has(page3.url)).toBe(false);
-	});
-
-	it('should return a copy from cache.get()', () => {
-		cache.set(page1.url, page1);
-		const page = cache.get(page1.url);
-		page!.html = 'new';
-		expect(cache.get(page1.url)?.html).toEqual(page1.html);
-	});
-
-	it('should return a new Map with shallow copies from cache.all', () => {
-		cache.set(page1.url, page1);
-		cache.set(page2.url, page2);
-
-		const all = cache.all;
-		all.get(page1.url)!.html = 'new';
-
-		expect(cache.get(page1.url)?.html).toEqual(page1.html);
-	});
-});
-
-describe('Types', () => {
-	it('error when necessary', async () => {
-		const swup = new Swup();
-		const cache = new Cache(swup);
-
-		// @ts-expect-no-error
-		swup.hooks.on('history:popstate', (visit: Visit, { event: PopStateEvent }) => {});
-		// @ts-expect-no-error
-		await swup.hooks.call('history:popstate', { event: new PopStateEvent('') });
-
-		try {
-			// @ts-expect-error
-			cache.set();
-			// @ts-expect-error
-			cache.set(url);
-			// @ts-expect-error
-			cache.set(url, {});
-			// @ts-expect-error
-			cache.set({ url: '/test' });
-		} catch (error) {}
-	});
-});

package/src/modules/__test__/delegateEvent.test.ts

@@ -1,36 +0,0 @@
-import { DelegateEvent } from 'delegate-it';
-import { describe, it } from 'vitest';
-
-import { delegateEvent } from '../../helpers/delegateEvent.js';
-
-describe('delegateEvent', () => {
-	it('should return correct types', () => {
-		delegateEvent('form', 'submit', (event) => {});
-
-		// @ts-expect-no-error
-		delegateEvent('form', 'submit', (event: SubmitEvent) => {});
-		// @ts-expect-error
-		delegateEvent('form', 'submit', (event: MouseEvent) => {});
-
-		// @ts-expect-no-error
-		delegateEvent('form', 'submit', (event: DelegateEvent<SubmitEvent>) => {});
-		// @ts-expect-error
-		delegateEvent('form', 'submit', (event: DelegateEvent<MouseEvent>) => {});
-
-		// @ts-expect-no-error
-		delegateEvent('form', 'submit', (event: DelegateEvent<SubmitEvent, HTMLFormElement>) => {});
-		delegateEvent(
-			'form',
-			'submit',
-			// @ts-expect-error
-			(event: DelegateEvent<MouseEvent, HTMLAnchorElement>) => {}
-		);
-
-		delegateEvent('form', 'submit', (event) => {
-			// @ts-expect-no-error
-			const el: HTMLFormElement = event.delegateTarget;
-		});
-		// @ts-expect-error
-		delegateEvent('form', 'submit', (event: MouseEvent) => {});
-	});
-});