add docs

Author: romainmenke

.github/bin/download.mjs

@@ -0,0 +1,35 @@
+import fs from 'fs/promises';
+import path from 'node:path';
+import { spawn } from 'child_process';
+import { tmpdir } from 'node:os';
+
+export async function createTempDir() {
+	const name = await fs.mkdtemp(path.join(tmpdir(), 'normalize.css-'));
+	return [name, async () => fs.rm(name, { recursive: true, force: true })];
+}
+
+export async function curlDownloadAndExtract(url, dir) {
+	await fs.mkdir(dir, { recursive: true });
+
+	const curl = spawn('curl', [url, '-o', path.join(dir, 'archive.tgz')]);
+	await new Promise((resolve, reject) => {
+		curl.on('close', (code) => {
+			if (code === 0) {
+				resolve();
+			} else {
+				reject(new Error(`curl exited with code ${code}`));
+			}
+		});
+	});
+
+	const unzip = spawn('tar', ['-xzf', path.join(dir, 'archive.tgz'), '-C', dir, '--strip-components=1']);
+	await new Promise((resolve, reject) => {
+		unzip.on('close', (code) => {
+			if (code === 0) {
+				resolve();
+			} else {
+				reject(new Error(`tar exited with code ${code}`));
+			}
+		});
+	});
+}

.github/bin/generate-gh-pages.mjs

@@ -0,0 +1,43 @@
+import fs from "fs/promises";
+import path from "path";
+import { createTempDir, curlDownloadAndExtract } from "./download.mjs";
+import { getPackageDataFromNPM } from "./npm-data.mjs";
+import { removeAllReleaseDirs } from "./remove-all-current-release-dirs.mjs";
+
+await fs.copyFile(path.join('.', 'test.html'), path.join('docs', 'test.html'));
+
+await removeAllReleaseDirs();
+
+const npmData = await getPackageDataFromNPM();
+const [tmpDir, cleanup] = await createTempDir();
+
+for (const version in npmData.versions) {
+	const versionData = npmData.versions[version];
+	const tarBallURL = versionData.dist.tarball;
+	const tmpDirForVersion = path.join(tmpDir, version);
+
+	await curlDownloadAndExtract(tarBallURL, tmpDirForVersion);
+
+	await fs.mkdir(path.join('docs', version));
+	await fs.copyFile(path.join(tmpDirForVersion, 'normalize.css'), path.join('docs', version, 'normalize.css'));
+	await fs.copyFile(path.join('docs', 'test.html'), path.join('docs', version, 'test.html'));
+}
+
+for (const distTag in npmData['dist-tags']) {
+	const version = npmData['dist-tags'][distTag];
+	const versionData = npmData.versions[version];
+	if (!versionData) {
+		continue;
+	}
+
+	const tarBallURL = versionData.dist.tarball;
+	const tmpDirForVersion = path.join(tmpDir, distTag);
+
+	await curlDownloadAndExtract(tarBallURL, tmpDirForVersion);
+
+	await fs.mkdir(path.join('docs', distTag));
+	await fs.copyFile(path.join(tmpDirForVersion, 'normalize.css'), path.join('docs', distTag, 'normalize.css'));
+	await fs.copyFile(path.join('docs', 'test.html'), path.join('docs', distTag, 'test.html'));
+}
+
+await cleanup();

.github/bin/npm-data.mjs

@@ -0,0 +1,14 @@
+export async function getPackageDataFromNPM() {
+	const resp = await fetch(`https://registry.npmjs.org/@csstools/normalize.css`);
+	if (resp.status === 404) {
+		throw new Error(`Failed to fetch package metadata for @csstools/normalize.css, status code: ${resp.status} ${resp.statusText}`);
+	}
+
+	if (!resp.ok) {
+		throw new Error(`Failed to fetch package metadata for @csstools/normalize.css, status code: ${resp.status} ${resp.statusText}`);
+	}
+
+	const data = await resp.json();
+
+	return data;
+}

.github/bin/remove-all-current-release-dirs.mjs

@@ -0,0 +1,40 @@
+import path from 'path';
+import fs from 'fs/promises';
+
+export async function removeAllReleaseDirs() {
+	const releaseDirs = await findAllReleaseDirs();
+
+	for (const dir of releaseDirs) {
+		await fs.rm(dir, { recursive: true, force: true });
+	}
+}
+
+async function findAllReleaseDirs() {
+	const dir = path.resolve('.');
+	const dirents = await fs.readdir(dir, { withFileTypes: true });
+	const releaseDirs = dirents.map((dirent) => {
+		const res = path.resolve(dir, dirent.name);
+		if (!res.startsWith(dir)) {
+			return [];
+		}
+
+		if (dirent.isSymbolicLink()) {
+			return [];
+		}
+
+		if (dirent.isDirectory()) {
+			const basename = path.basename(res);
+			if (/^\d+\.\d+\.\d+/.test(basename) && parseInt(basename.split('.')[0], 10) >= 8) {
+				return [res];
+			}
+
+			if (basename === 'latest') {
+				return [res];
+			}
+		}
+
+		return [];
+	});
+
+	return releaseDirs.flat();
+}

.github/workflows/pages.yml

@@ -0,0 +1,30 @@
+name: Pages
+on:
+  workflow_dispatch:
+
+jobs:
+  update-directory:
+    runs-on: ubuntu-latest
+    steps:
+      - name: check out
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: setup node
+        uses: actions/[email protected]
+        with:
+          node-version: latest
+
+      - name: generate
+        run: |
+          node .github/bin/generate-gh-pages.mjs
+
+      - name: save
+        run: |
+          # Git config
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          git add .
+          git commit --allow-empty -m "Generate pages"
+          git push --set-upstream origin main

.gitignore

@@ -1,7 +1,5 @@
 node_modules
 npm-debug.log
 yarn.lock
-.*
 !.editorconfig
 !.gitignore
-!.travis.yml

docs/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.orig
+*.swo
+*.swp
+node_modules