swup 2.0.19 → 3.0.0-rc.1

package/dist/types.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.modern.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/types.module.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.module.js.map

package/dist/types.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.module.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/utils.cjs

@@ -0,0 +1,2 @@
+exports.escapeCssIdentifier=function(e){return window.CSS&&window.CSS.escape?CSS.escape(e):e},exports.nextTick=function(e){requestAnimationFrame(function(){requestAnimationFrame(function(){e()})})},exports.query=function(e,r){return void 0===r&&(r=document),r.querySelector(e)},exports.queryAll=function(e,r){return void 0===r&&(r=document),Array.from(r.querySelectorAll(e))},exports.toMs=function(e){return 1e3*Number(e.slice(0,-1).replace(",","."))};
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sources":["../src/utils/index.ts"],"sourcesContent":["export const query = (selector: string, context: Document | Element = document) => {\n\treturn context.querySelector<HTMLElement>(selector);\n};\n\nexport const queryAll = (\n\tselector: string,\n\tcontext: Document | Element = document\n): HTMLElement[] => {\n\treturn Array.from(context.querySelectorAll(selector));\n};\n\nexport const nextTick = (callback: () => void) => {\n\trequestAnimationFrame(() => {\n\t\trequestAnimationFrame(() => {\n\t\t\tcallback();\n\t\t});\n\t});\n};\n\nexport const escapeCssIdentifier = (ident: string) => {\n\t// @ts-ignore this is for support check, so it's correct that TS complains\n\tif (window.CSS && window.CSS.escape) {\n\t\treturn CSS.escape(ident);\n\t} else {\n\t\treturn ident;\n\t}\n};\n\n// Fix for Chrome below v61 formatting CSS floats with comma in some locales\nexport const toMs = (s: string) => {\n\treturn Number(s.slice(0, -1).replace(',', '.')) * 1000;\n};\n"],"names":["ident","window","CSS","escape","callback","requestAnimationFrame","selector","context","document","querySelector","Array","from","querySelectorAll","s","slice","replace"],"mappings":"4BAmBmC,SAACA,GAEnC,OAAIC,OAAOC,KAAOD,OAAOC,IAAIC,WACjBA,OAAOH,IAIpB,mBAfwB,SAACI,GACxBC,sBAAsB,WACrBA,sBAAsB,WACrBD,GACD,EACD,EACD,gBAjBqB,SAACE,EAAkBC,GACvC,YADuCA,IAAAA,IAAAA,EAA8BC,UAC9DD,EAAQE,cAA2BH,EAC3C,mBAEwB,SACvBA,EACAC,GAEA,YAFAA,IAAAA,IAAAA,EAA8BC,UAEvBE,MAAMC,KAAKJ,EAAQK,iBAAiBN,GAC5C,eAoBoB,SAACO,GACpB,OAAkD,WAApCA,EAAEC,MAAM,GAAI,GAAGC,QAAQ,IAAK,KAC3C"}

package/dist/utils.modern.js

@@ -0,0 +1,2 @@
+const e=(e,r=document)=>r.querySelector(e),r=(e,r=document)=>Array.from(r.querySelectorAll(e)),o=e=>{requestAnimationFrame(()=>{requestAnimationFrame(()=>{e()})})},t=e=>window.CSS&&window.CSS.escape?CSS.escape(e):e,c=e=>1e3*Number(e.slice(0,-1).replace(",","."));export{t as escapeCssIdentifier,o as nextTick,e as query,r as queryAll,c as toMs};
+//# sourceMappingURL=utils.modern.js.map

package/dist/utils.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.modern.js","sources":["../src/utils/index.ts"],"sourcesContent":["export const query = (selector: string, context: Document | Element = document) => {\n\treturn context.querySelector<HTMLElement>(selector);\n};\n\nexport const queryAll = (\n\tselector: string,\n\tcontext: Document | Element = document\n): HTMLElement[] => {\n\treturn Array.from(context.querySelectorAll(selector));\n};\n\nexport const nextTick = (callback: () => void) => {\n\trequestAnimationFrame(() => {\n\t\trequestAnimationFrame(() => {\n\t\t\tcallback();\n\t\t});\n\t});\n};\n\nexport const escapeCssIdentifier = (ident: string) => {\n\t// @ts-ignore this is for support check, so it's correct that TS complains\n\tif (window.CSS && window.CSS.escape) {\n\t\treturn CSS.escape(ident);\n\t} else {\n\t\treturn ident;\n\t}\n};\n\n// Fix for Chrome below v61 formatting CSS floats with comma in some locales\nexport const toMs = (s: string) => {\n\treturn Number(s.slice(0, -1).replace(',', '.')) * 1000;\n};\n"],"names":["query","selector","context","document","querySelector","queryAll","Array","from","querySelectorAll","nextTick","callback","requestAnimationFrame","escapeCssIdentifier","ident","window","CSS","escape","toMs","s","Number","slice","replace"],"mappings":"AAAaA,MAAAA,EAAQ,CAACC,EAAkBC,EAA8BC,aACtDC,cAA2BH,GAG9BI,EAAW,CACvBJ,EACAC,EAA8BC,WAEvBG,MAAMC,KAAKL,EAAQM,iBAAiBP,IAG/BQ,EAAYC,IACxBC,sBAAsB,KACrBA,sBAAsB,KACrBD,GACD,EACD,IAGYE,EAAuBC,GAE/BC,OAAOC,KAAOD,OAAOC,IAAIC,OAClBD,IAACC,OAAOH,GAEXA,EAKII,EAAQC,GAC8B,IAA3CC,OAAOD,EAAEE,MAAM,GAAI,GAAGC,QAAQ,IAAK"}

package/dist/utils.module.js

@@ -0,0 +1,2 @@
+var e=function(e,n){return void 0===n&&(n=document),n.querySelector(e)},n=function(e,n){return void 0===n&&(n=document),Array.from(n.querySelectorAll(e))},r=function(e){requestAnimationFrame(function(){requestAnimationFrame(function(){e()})})},t=function(e){return window.CSS&&window.CSS.escape?CSS.escape(e):e},o=function(e){return 1e3*Number(e.slice(0,-1).replace(",","."))};export{t as escapeCssIdentifier,r as nextTick,e as query,n as queryAll,o as toMs};
+//# sourceMappingURL=utils.module.js.map

package/dist/utils.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.module.js","sources":["../src/utils/index.ts"],"sourcesContent":["export const query = (selector: string, context: Document | Element = document) => {\n\treturn context.querySelector<HTMLElement>(selector);\n};\n\nexport const queryAll = (\n\tselector: string,\n\tcontext: Document | Element = document\n): HTMLElement[] => {\n\treturn Array.from(context.querySelectorAll(selector));\n};\n\nexport const nextTick = (callback: () => void) => {\n\trequestAnimationFrame(() => {\n\t\trequestAnimationFrame(() => {\n\t\t\tcallback();\n\t\t});\n\t});\n};\n\nexport const escapeCssIdentifier = (ident: string) => {\n\t// @ts-ignore this is for support check, so it's correct that TS complains\n\tif (window.CSS && window.CSS.escape) {\n\t\treturn CSS.escape(ident);\n\t} else {\n\t\treturn ident;\n\t}\n};\n\n// Fix for Chrome below v61 formatting CSS floats with comma in some locales\nexport const toMs = (s: string) => {\n\treturn Number(s.slice(0, -1).replace(',', '.')) * 1000;\n};\n"],"names":["query","selector","context","document","querySelector","queryAll","Array","from","querySelectorAll","nextTick","callback","requestAnimationFrame","escapeCssIdentifier","ident","window","CSS","escape","toMs","s","slice","replace"],"mappings":"AAAaA,IAAAA,EAAQ,SAACC,EAAkBC,GACvC,YADuCA,IAAAA,IAAAA,EAA8BC,UAC9DD,EAAQE,cAA2BH,EAC3C,EAEaI,EAAW,SACvBJ,EACAC,GAEA,YAFAA,IAAAA,IAAAA,EAA8BC,UAEvBG,MAAMC,KAAKL,EAAQM,iBAAiBP,GAC5C,EAEaQ,EAAW,SAACC,GACxBC,sBAAsB,WACrBA,sBAAsB,WACrBD,GACD,EACD,EACD,EAEaE,EAAsB,SAACC,GAEnC,OAAIC,OAAOC,KAAOD,OAAOC,IAAIC,WACjBA,OAAOH,IAIpB,EAGiBI,EAAG,SAACC,GACpB,OAAkD,WAApCA,EAAEC,MAAM,GAAI,GAAGC,QAAQ,IAAK,KAC3C"}

package/package.json

@@ -1,22 +1,47 @@
 {
   "name": "swup",
-  "version": "2.0.19",
-  "description": "Complete, flexible, extensible and easy to use page transition library for your web.",
-  "main": "lib/index.js",
+  "amdName": "Swup",
+  "version": "3.0.0-rc.1",
+  "description": "Complete, flexible, extensible, and easy-to-use page transition library for your server-side rendered website.",
+  "type": "module",
+  "source": "src/index.ts",
+  "main": "dist/index.cjs",
+  "module": "dist/index.module.js",
+  "unpkg": "dist/index.umd.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.modern.js"
+    },
+    "./*": {
+      "types": "./dist/types/*.d.ts",
+      "require": "./dist/*.cjs",
+      "default": "./dist/*.modern.js"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
   "scripts": {
-    "cy:open": "cypress open",
-    "compile": "babel --presets es2015,stage-0 -d lib/ src/",
-    "build": "webpack-cli",
-    "lint": "prettier src/**/*.{js,mjs} --write",
-    "prepublish": "npm run compile && npm run build",
+    "build": "npm run build:module && npm run build:bundle",
+    "build:module": "microbundle src/*.ts -f modern,esm,cjs",
+    "build:bundle": "microbundle src/index.ts -f umd --external none",
+    "dev": "microbundle src/*.ts -w",
+    "lint": "prettier 'src/**/*.ts' --write",
+    "prepublish": "npm run build",
     "postinstall": "opencollective-postinstall || true",
-    "ci": "npm run build && npm run test:instrument && start-server-and-test test:server http://localhost:8274 test:run:record",
-    "test": "npm run build && npm run test:instrument && start-server-and-test test:server http://localhost:8274 test:run",
-    "test:headed": "npm run build && npm run test:instrument && start-server-and-test test:server http://localhost:8274 cy:open",
+    "ci": "start-server-and-test test:start 8274 cy:run:record",
+    "test": "start-server-and-test test:start 8274 cy:run",
+    "test:dev": "start-server-and-test test:start 8274 cy:open",
     "test:instrument": "nyc instrument --compact=false dist test/site/swup",
     "test:server": "http-server --port 8274 test/site",
-    "test:run": "cypress run",
-    "test:run:record": "cypress run --record"
+    "test:start": "npm run test:instrument && npm run test:server",
+    "cy:run": "cypress run",
+    "cy:run:record": "cypress run --record",
+    "cy:open": "cypress open"
   },
   "author": "Georgy Marchuk",
   "license": "MIT",
@@ -37,20 +62,13 @@
   "devDependencies": {
     "@cypress/code-coverage": "^3.10.0",
     "@swup/prettier-config": "^1.0.0",
-    "@swup/webpack-config": "^1.0.0",
-    "babel-cli": "^6.26.0",
-    "babel-loader": "^7.1.4",
-    "babel-preset-es2015": "^6.24.1",
-    "babel-preset-stage-0": "^6.24.1",
     "cypress": "^10.0.2",
     "http-server": "^14.1.1",
     "istanbul-lib-coverage": "^3.2.0",
+    "microbundle": "^0.15.0",
     "nyc": "^15.1.0",
-    "prettier": "1.17.0",
-    "start-server-and-test": "^1.14.0",
-    "uglifyjs-webpack-plugin": "^1.2.5",
-    "webpack": "^4.8.3",
-    "webpack-cli": "^3.3.2"
+    "prettier": "1.19.0",
+    "start-server-and-test": "^1.14.0"
   },
   "collective": {
     "type": "opencollective",

package/readme.md

@@ -1,44 +1,60 @@
-<h3 align="center"><a href="https://github.com/swup/swup/discussions/424">We're looking for maintainers!</a></h3>
+<br>
 
----
-
-<p align="center"><img width="420" alt="swup" src="https://swup.js.org/assets/images/swup-logo.svg"></p>
 <p align="center">
-Complete, flexible, extensible and easy to use page transition library for your static web.
+  <img width="280" alt="swup" src="https://swup.js.org/assets/images/swup-logo.svg">
 </p>
+
 <p align="center">
-    <a href="https://www.npmjs.com/package/swup"><img src="https://img.shields.io/npm/v/swup.svg" alt="npm version"></a>
-    <img src="https://img.shields.io/bundlephobia/minzip/swup.svg" alt="Gzip Size">
-    <a href="https://github.com/gmrchk/swup/blob/master/LICENSE"><img src="https://img.shields.io/github/license/gmrchk/swup.svg" alt="License"></a>
-    <a href="https://www.npmjs.com/package/swup"><img src="https://img.shields.io/npm/dt/swup.svg" alt="npm downloads"></a>
-    <a href="https://circleci.com/gh/swup/swup"><img src="https://circleci.com/gh/swup/swup.svg?style=svg" alt="CircleCI"></a>
+  <a href="https://www.npmjs.com/package/swup"><img src="https://img.shields.io/npm/v/swup.svg" alt="npm version"></a>
+  <a href="https://bundlephobia.com/package/swup"><img src="https://img.shields.io/bundlephobia/minzip/swup.svg" alt="Bundle size"></a>
+  <a href="https://github.com/gmrchk/swup/blob/master/LICENSE"><img src="https://img.shields.io/github/license/gmrchk/swup.svg" alt="License"></a>
+  <a href="https://www.npmjs.com/package/swup"><img src="https://img.shields.io/npm/dt/swup.svg" alt="npm downloads"></a>
+  <a href="https://circleci.com/gh/swup/swup"><img src="https://circleci.com/gh/swup/swup.svg?style=shield" alt="Build status"></a>
 </p>
 
-[Here](https://medium.com/@gmarcuk/introducing-swup-v2-814e40316dee)'s what's new in v2. Check [changelog](https://swup.js.org/other/changelog) for recent changes, see all [swup repositories](https://github.com/swup/) to discover more, or checkout the [discussions](https://github.com/swup/swup/discussions).
-
-- [Discussions](https://github.com/swup/swup/discussions)
-- [Getting Started](https://swup.js.org/getting-started)
-  - [Example](https://swup.js.org/getting-started/example)
-  - [Demo](https://swup.js.org/getting-started/demo)
-  - [Reloading JavaScript](https://swup.js.org/getting-started/reloading-javascript)
-  - [Video Tutorials](https://swup.js.org/getting-started/videos)
-- [Options](https://swup.js.org/options)
-- [Events](https://swup.js.org/events)
-- Extensions
-    - [Plugins](https://swup.js.org/plugins)
-    - [Themes](https://swup.js.org/themes)
-    - [3rd Party Integrations](https://swup.js.org/third-party-integrations)
-- [JavaScript API](https://swup.js.org/api)
-- [Swup CLI](https://swup.js.org/cli)
-- [CI/CD Integration](https://swup.js.org/ci-cd)
-- Other
-    - [Changelog](https://swup.js.org//other/changelog)
-    - [Contributions](https://swup.js.org/other/contributions)
-    - [Repositories](https://github.com/swup)
-    - [Sites using swup](https://github.com/swup/swup/discussions/333)
-
-If you're having trouble implementing swup, checkout [Common Issues](https://swup.js.org/other/common-issues), [Closed Issues](https://github.com/gmrchk/swup/issues?q=is%3Aissue+is%3Aclosed) or open a [new one](https://github.com/gmrchk/swup/issues/new).
-
-[Become a backer or sponsor on Open Collective](https://opencollective.com/swup) or support swup through [GitHub sponsors](https://github.com/sponsors/gmrchk). 
+<br>
+
+# Swup
+
+Complete, flexible, extensible, and easy-to-use page transition library for your server-side rendered website.
+
+[Features](#features) •
+[Documentation](https://swup.js.org/getting-started) •
+[Plugins](https://swup.js.org/plugins) •
+[Themes](https://swup.js.org/themes) •
+[Discussions](https://github.com/swup/swup/discussions)
+
+## Overview
+
+Swup is a library that helps you add page transitions to server-side rendered websites. It handles
+the complete lifecycle of a page visit by intercepting link clicks, loading the new page in the
+background, replacing the content and transitioning between the old and the new page.
+
+Its goal is to make adding transitions to a site as simple as possible, while providing lots of
+other quality-of-life improvements.
+
+## Features
+
+- ✨ Auto-detects [CSS transitions](https://swup.js.org/getting-started/how-it-works) for perfect timing
+- 🔗 Updates URLs and preserves native browser history behavior
+- 📦 Uses a [cache](https://swup.js.org/api/cache) to speed up subsequent page loads
+- 💡 Offers [events](https://swup.js.org/events) for hooking into the lifecycle
+- 🔌 Has a powerful [plugin system](https://swup.js.org/plugins) and many official and third-party plugins
+- 🎨 Provides ready-to-go [themes](https://swup.js.org/themes) to get started quickly
+
+## Examples
 
 <img src="https://user-images.githubusercontent.com/9338324/49190360-50125480-f372-11e8-89e9-d2fb091a2240.gif" width="100%">
+
+Take a look at [Sites using swup](https://github.com/swup/swup/discussions/333) for more examples.
+
+## Having trouble?
+
+If you're having trouble implementing swup, check out the [Common Issues](https://swup.js.org/other/common-issues) section of the docs, look at [closed issues](https://github.com/gmrchk/swup/issues?q=is%3Aissue+is%3Aclosed) or create a [new discussion](https://github.com/swup/swup/discussions/new).
+
+## Want to Contribute?
+
+<a href="https://github.com/swup/swup/discussions/424">We're looking for maintainers!</a>   👀
+
+Become a sponsor on [Open Collective](https://opencollective.com/swup) or support development through
+[GitHub sponsors](https://github.com/sponsors/gmrchk).

package/src/config/version.ts

@@ -0,0 +1,13 @@
+/**
+ * Import swup's current version from package.json
+ */
+
+// This will only work in webpack 4
+// export { version as default } from '../../package.json';
+
+// This will work in microbundle + webpack 5, but won't treeshake in webpack 4
+// Ignore next line in TypeScript as package.json is outside of rootDir
+// @ts-ignore
+import pckg from '../../package.json';
+
+export default pckg.version;

package/src/helpers/Location.ts

@@ -0,0 +1,44 @@
+/**
+ * A helper for creating a Location from either an element
+ * or a URL object/string
+ *
+ * Note: this could be implemented as a class inheriting from URL
+ * Except: Babel will add tons of boilerplate for ES6 classes + getters
+ * So for now it's implemented as an augmented URL object with custom getter
+ *
+ * class Location extends URL {
+ *   get url() {
+ *	 return this.pathname + this.search;
+ *   }
+ * }
+ *
+ */
+
+export default class Location extends URL {
+	constructor(url: string, base: string = document.baseURI) {
+		super(url.toString(), base);
+	}
+
+	get url() {
+		return this.pathname + this.search;
+	}
+
+	/**
+	 * Instantiate a Location from an element's href attribute
+	 * @param {Element} el
+	 * @return new Location instance
+	 */
+	static fromElement(el: HTMLAnchorElement): Location {
+		const href = el.getAttribute('href') || el.getAttribute('xlink:href');
+		return new Location(href!);
+	}
+
+	/**
+	 * Instantiate a Location from a URL object or string
+	 * @param {URL|string} url
+	 * @return new Location instance
+	 */
+	static fromUrl(url: string): Location {
+		return new Location(url);
+	}
+}

package/src/helpers/classify.ts

@@ -0,0 +1,13 @@
+const classify = (text: string, fallback?: string): string => {
+	const output = String(text)
+		.toLowerCase()
+		// .normalize('NFD') // split an accented letter in the base letter and the acent
+		// .replace(/[\u0300-\u036f]/g, '') // remove all previously split accents
+		.replace(/[\s/_.]+/g, '-') // replace spaces and _./ with '-'
+		.replace(/[^\w-]+/g, '') // remove all non-word chars
+		.replace(/--+/g, '-') // replace repeating '-' with single '-'
+		.replace(/^-+|-+$/, ''); // trim '-' from edges
+	return output || fallback || '';
+};
+
+export default classify;

package/src/helpers/cleanupAnimationClasses.ts

@@ -0,0 +1,10 @@
+const isSwupClass = (className: string): boolean =>
+	/^to-/.test(className) || ['is-changing', 'is-rendering', 'is-popstate'].includes(className);
+
+const cleanupAnimationClasses = (): void => {
+	const htmlClasses = document.documentElement.className.split(' ');
+	const removeClasses = htmlClasses.filter(isSwupClass);
+	document.documentElement.classList.remove(...removeClasses);
+};
+
+export default cleanupAnimationClasses;

package/src/helpers/createHistoryRecord.ts

@@ -0,0 +1,14 @@
+import { default as getCurrentUrl } from './getCurrentUrl.js';
+
+const createHistoryRecord = (url: string, customData: Record<string, unknown> = {}): void => {
+	url = url || getCurrentUrl({ hash: true });
+	const data = {
+		url,
+		random: Math.random(),
+		source: 'swup',
+		...customData
+	};
+	history.pushState(data, '', url);
+};
+
+export default createHistoryRecord;

package/src/helpers/delegateEvent.ts

@@ -0,0 +1,23 @@
+import delegate, { EventType } from 'delegate-it';
+import { ParseSelector } from 'typed-query-selector/parser';
+
+export type Unsubscribe = {
+	destroy: () => void;
+};
+const delegateEvent = <Selector extends string, TEvent extends EventType>(
+	selector: Selector,
+	type: TEvent,
+	callback: delegate.EventHandler<GlobalEventHandlersEventMap[TEvent]>,
+	{ base = document, ...eventOptions } = {}
+): Unsubscribe => {
+	const delegation = delegate<string, ParseSelector<Selector, HTMLElement>, TEvent>(
+		base,
+		selector,
+		type,
+		callback,
+		eventOptions
+	);
+	return { destroy: () => delegation.destroy() };
+};
+
+export default delegateEvent;

package/src/helpers/fetch.ts

@@ -0,0 +1,35 @@
+import { TransitionOptions } from '../modules/loadPage.js';
+import { Options } from '../index.js';
+
+const fetch = (
+	options: TransitionOptions & { headers: Options['requestHeaders'] },
+	callback: (request: XMLHttpRequest) => void
+): XMLHttpRequest => {
+	const defaults = {
+		url: window.location.pathname + window.location.search,
+		method: 'GET',
+		data: null,
+		headers: {}
+	};
+
+	const { url, method, headers, data } = { ...defaults, ...options };
+
+	const request = new XMLHttpRequest();
+
+	request.onreadystatechange = function() {
+		if (request.readyState === 4) {
+			// if (request.status === 500) {} else {}
+			callback(request);
+		}
+	};
+
+	request.open(method, url, true);
+	Object.entries(headers).forEach(([key, header]) => {
+		request.setRequestHeader(key, header);
+	});
+	request.send(data);
+
+	return request;
+};
+
+export default fetch;

package/src/helpers/getCurrentUrl.ts

@@ -0,0 +1,5 @@
+const getCurrentUrl = ({ hash }: { hash?: boolean } = {}): string => {
+	return location.pathname + location.search + (hash ? location.hash : '');
+};
+
+export default getCurrentUrl;

package/src/helpers/getDataFromHtml.ts

@@ -0,0 +1,41 @@
+import { query, queryAll } from '../utils.js';
+
+export type PageHtmlData = {
+	title: string;
+	originalContent: string;
+	blocks: string[];
+	pageClass?: string;
+};
+
+const getDataFromHtml = (html: string, containers: string[]): PageHtmlData => {
+	let fakeDom = document.createElement('html');
+	fakeDom.innerHTML = html;
+	let blocks: string[] = [];
+
+	containers.forEach((selector) => {
+		if (query(selector, fakeDom) == null) {
+			console.warn(`[swup] Container ${selector} not found on page.`);
+			return null;
+		} else {
+			if (queryAll(selector).length !== queryAll(selector, fakeDom).length) {
+				console.warn(`[swup] Mismatched number of containers found on new page.`);
+			}
+			queryAll(selector).forEach((item, index) => {
+				queryAll(selector, fakeDom)[index].setAttribute('data-swup', String(blocks.length));
+				blocks.push(queryAll(selector, fakeDom)[index].outerHTML);
+			});
+		}
+	});
+
+	const title = query('title', fakeDom)?.innerText || '';
+	const pageClass = query('body', fakeDom)?.className;
+
+	// to prevent memory leaks
+	fakeDom.innerHTML = '';
+	// @ts-ignore don't want to type it as possible null, since it's created at the top of the function always
+	fakeDom = null;
+
+	return { title, pageClass, blocks, originalContent: html };
+};
+
+export default getDataFromHtml;

package/src/helpers/index.ts

@@ -0,0 +1,11 @@
+export { default as classify } from './classify.js';
+export { default as createHistoryRecord } from './createHistoryRecord.js';
+export { default as updateHistoryRecord } from './updateHistoryRecord.js';
+export { default as delegateEvent } from './delegateEvent.js';
+export { default as getDataFromHtml } from './getDataFromHtml.js';
+export { default as fetch } from './fetch.js';
+export { default as getCurrentUrl } from './getCurrentUrl.js';
+export { default as Location } from './Location.js';
+export { default as markSwupElements } from './markSwupElements.js';
+export { default as cleanupAnimationClasses } from './cleanupAnimationClasses.js';
+export { default as versionSatisfies } from './versionSatisfies.js';

package/src/helpers/markSwupElements.ts

@@ -0,0 +1,18 @@
+import { query, queryAll } from '../utils.js';
+
+const markSwupElements = (element: Element, containers: string[]): void => {
+	let blocks = 0;
+
+	containers.forEach((selector) => {
+		if (query(selector, element) == null) {
+			console.warn(`[swup] Container ${selector} not found on page.`);
+		} else {
+			queryAll(selector).forEach((item: Element, index: number) => {
+				queryAll(selector, element)[index].setAttribute('data-swup', String(blocks));
+				blocks++;
+			});
+		}
+	});
+};
+
+export default markSwupElements;

package/src/helpers/updateHistoryRecord.ts

@@ -0,0 +1,18 @@
+import { default as getCurrentUrl } from './getCurrentUrl.js';
+
+const updateHistoryRecord = (
+	url: string | null = null,
+	customData: Record<string, unknown> = {}
+): void => {
+	url = url || getCurrentUrl({ hash: true });
+	const data = {
+		...history.state,
+		url,
+		random: Math.random(),
+		source: 'swup',
+		...customData
+	};
+	history.replaceState(data, '', url);
+};
+
+export default updateHistoryRecord;

package/src/helpers/versionSatisfies.ts

@@ -0,0 +1,50 @@
+type Comparator = '>' | '>=' | '<' | '<=';
+
+// Fill versions to exactly 3 decimals
+const normalizeVersion = (version: string): string => {
+	return String(version)
+		.split('.')
+		.concat(['0', '0'])
+		.slice(0, 3)
+		.join('.');
+};
+
+// Numerically compare version strings after normalizing them
+const compareVersion = (a: string, b: string): number => {
+	a = normalizeVersion(a);
+	b = normalizeVersion(b);
+	return a.localeCompare(b, undefined, { numeric: true });
+};
+
+// Apply a comparator (equals, greater-than, etc) by its symbol to a sort comparison
+const applyComparator = (comparisonResult: number, comparator: Comparator) => {
+	const comparators = {
+		'': (r: number) => r === 0,
+		'>': (r: number) => r > 0,
+		'>=': (r: number) => r >= 0,
+		'<': (r: number) => r < 0,
+		'<=': (r: number) => r <= 0
+	};
+	const comparatorFn = comparators[comparator] || comparators[''];
+	return comparatorFn(comparisonResult);
+};
+
+/**
+ * Check if a version satisfies all given version requirements
+ *
+ * versionSatisfies('2.1.0', ['>=2', '<4']) // true
+ * versionSatisfies('2.1.0', ['5']) // false
+ *
+ * @param {string} installed Installed version
+ * @param {Array.<string>} requirements Array of requirements that must be satisfied
+ * @returns boolean
+ */
+export const versionSatisfies = (installed: string, requirements: string[]) => {
+	return requirements.every((required) => {
+		const [, comparator, version] = required.match(/^([\D]+)?(.*)$/) || [];
+		const comparisonResult = compareVersion(installed, version);
+		return applyComparator(comparisonResult, (comparator as Comparator) || '>=');
+	});
+};
+
+export default versionSatisfies;

package/src/helpers.ts

@@ -0,0 +1,4 @@
+// Re-export all helpers to allow custom package export path
+// e.g. import { getPageData } from 'swup/helpers'
+
+export * from './helpers/index.js';