feat: Finalize VitePress site structure and styling

node_modules/preact/jsx-runtime/src/index.d.ts

@@ -0,0 +1,62 @@
+// Intentionally not using a relative path to take advantage of
+// the TS version resolution mechanism
+export { Fragment } from 'preact';
+import {
+	ComponentType,
+	ComponentChild,
+	ComponentChildren,
+	VNode,
+	Attributes
+} from 'preact';
+import { JSXInternal } from '../../src/jsx';
+
+export function jsx(
+	type: string,
+	props: JSXInternal.HTMLAttributes &
+		JSXInternal.SVGAttributes &
+		Record<string, any> & { children?: ComponentChild },
+	key?: string
+): VNode<any>;
+export function jsx<P>(
+	type: ComponentType<P>,
+	props: Attributes & P & { children?: ComponentChild },
+	key?: string
+): VNode<any>;
+
+export function jsxs(
+	type: string,
+	props: JSXInternal.HTMLAttributes &
+		JSXInternal.SVGAttributes &
+		Record<string, any> & { children?: ComponentChild[] },
+	key?: string
+): VNode<any>;
+export function jsxs<P>(
+	type: ComponentType<P>,
+	props: Attributes & P & { children?: ComponentChild[] },
+	key?: string
+): VNode<any>;
+
+export function jsxDEV(
+	type: string,
+	props: JSXInternal.HTMLAttributes &
+		JSXInternal.SVGAttributes &
+		Record<string, any> & { children?: ComponentChildren },
+	key?: string
+): VNode<any>;
+export function jsxDEV<P>(
+	type: ComponentType<P>,
+	props: Attributes & P & { children?: ComponentChildren },
+	key?: string
+): VNode<any>;
+
+// These are not expected to be used manually, but by a JSX transform
+export function jsxTemplate(
+	template: string[],
+	...expressions: any[]
+): VNode<any>;
+export function jsxAttr(name: string, value: any): string | null;
+export function jsxEscape<T>(
+	value: T
+): string | null | VNode<any> | Array<string | null | VNode>;
+
+export { JSXInternal as JSX };

node_modules/preact/jsx-runtime/src/index.js

@@ -0,0 +1,206 @@
+import { options, Fragment } from 'preact';
+import { encodeEntities } from './utils';
+import { IS_NON_DIMENSIONAL } from '../../src/constants';
+
+let vnodeId = 0;
+
+const isArray = Array.isArray;
+
+/**
+ * @fileoverview
+ * This file exports various methods that implement Babel's "automatic" JSX runtime API:
+ * - jsx(type, props, key)
+ * - jsxs(type, props, key)
+ * - jsxDEV(type, props, key, __source, __self)
+ *
+ * The implementation of createVNode here is optimized for performance.
+ * Benchmarks: https://esbench.com/bench/5f6b54a0b4632100a7dcd2b3
+ */
+
+/**
+ * JSX.Element factory used by Babel's {runtime:"automatic"} JSX transform
+ * @param {VNode['type']} type
+ * @param {VNode['props']} props
+ * @param {VNode['key']} [key]
+ * @param {unknown} [isStaticChildren]
+ * @param {unknown} [__source]
+ * @param {unknown} [__self]
+ */
+function createVNode(type, props, key, isStaticChildren, __source, __self) {
+	if (!props) props = {};
+	// We'll want to preserve `ref` in props to get rid of the need for
+	// forwardRef components in the future, but that should happen via
+	// a separate PR.
+	let normalizedProps = props,
+		ref,
+		i;
+
+	if ('ref' in normalizedProps) {
+		normalizedProps = {};
+		for (i in props) {
+			if (i == 'ref') {
+				ref = props[i];
+			} else {
+				normalizedProps[i] = props[i];
+			}
+		}
+	}
+
+	/** @type {VNode & { __source: any; __self: any }} */
+	const vnode = {
+		type,
+		props: normalizedProps,
+		key,
+		ref,
+		_children: null,
+		_parent: null,
+		_depth: 0,
+		_dom: null,
+		_component: null,
+		constructor: undefined,
+		_original: --vnodeId,
+		_index: -1,
+		_flags: 0,
+		__source,
+		__self
+	};
+
+	// If a Component VNode, check for and apply defaultProps.
+	// Note: `type` is often a String, and can be `undefined` in development.
+	if (typeof type === 'function' && (ref = type.defaultProps)) {
+		for (i in ref)
+			if (normalizedProps[i] === undefined) {
+				normalizedProps[i] = ref[i];
+			}
+	}
+
+	if (options.vnode) options.vnode(vnode);
+	return vnode;
+}
+
+/**
+ * Create a template vnode. This function is not expected to be
+ * used directly, but rather through a precompile JSX transform
+ * @param {string[]} templates
+ * @param  {Array<string | null | VNode>} exprs
+ * @returns {VNode}
+ */
+function jsxTemplate(templates, ...exprs) {
+	const vnode = createVNode(Fragment, { tpl: templates, exprs });
+	// Bypass render to string top level Fragment optimization
+	vnode.key = vnode._vnode;
+	return vnode;
+}
+
+const JS_TO_CSS = {};
+const CSS_REGEX = /[A-Z]/g;
+
+/**
+ * Unwrap potential signals.
+ * @param {*} value
+ * @returns {*}
+ */
+function normalizeAttrValue(value) {
+	return value !== null &&
+		typeof value === 'object' &&
+		typeof value.valueOf === 'function'
+		? value.valueOf()
+		: value;
+}
+
+/**
+ * Serialize an HTML attribute to a string. This function is not
+ * expected to be used directly, but rather through a precompile
+ * JSX transform
+ * @param {string} name The attribute name
+ * @param {*} value The attribute value
+ * @returns {string}
+ */
+function jsxAttr(name, value) {
+	if (options.attr) {
+		const result = options.attr(name, value);
+		if (typeof result === 'string') return result;
+	}
+
+	value = normalizeAttrValue(value);
+
+	if (name === 'ref' || name === 'key') return '';
+	if (name === 'style' && typeof value === 'object') {
+		let str = '';
+		for (let prop in value) {
+			let val = value[prop];
+			if (val != null && val !== '') {
+				const name =
+					prop[0] == '-'
+						? prop
+						: JS_TO_CSS[prop] ||
+							(JS_TO_CSS[prop] = prop.replace(CSS_REGEX, '-$&').toLowerCase());
+
+				let suffix = ';';
+				if (
+					typeof val === 'number' &&
+					// Exclude custom-attributes
+					!name.startsWith('--') &&
+					!IS_NON_DIMENSIONAL.test(name)
+				) {
+					suffix = 'px;';
+				}
+				str = str + name + ':' + val + suffix;
+			}
+		}
+		return name + '="' + encodeEntities(str) + '"';
+	}
+
+	if (
+		value == null ||
+		value === false ||
+		typeof value === 'function' ||
+		typeof value === 'object'
+	) {
+		return '';
+	} else if (value === true) return name;
+
+	return name + '="' + encodeEntities('' + value) + '"';
+}
+
+/**
+ * Escape a dynamic child passed to `jsxTemplate`. This function
+ * is not expected to be used directly, but rather through a
+ * precompile JSX transform
+ * @param {*} value
+ * @returns {string | null | VNode | Array<string | null | VNode>}
+ */
+function jsxEscape(value) {
+	if (
+		value == null ||
+		typeof value === 'boolean' ||
+		typeof value === 'function'
+	) {
+		return null;
+	}
+
+	if (typeof value === 'object') {
+		// Check for VNode
+		if (value.constructor === undefined) return value;
+
+		if (isArray(value)) {
+			for (let i = 0; i < value.length; i++) {
+				value[i] = jsxEscape(value[i]);
+			}
+			return value;
+		}
+	}
+
+	return encodeEntities('' + value);
+}
+
+export {
+	createVNode as jsx,
+	createVNode as jsxs,
+	createVNode as jsxDEV,
+	Fragment,
+	// precompiled JSX transform
+	jsxTemplate,
+	jsxAttr,
+	jsxEscape
+};

node_modules/preact/jsx-runtime/src/utils.js

@@ -0,0 +1,36 @@
+const ENCODED_ENTITIES = /["&<]/;
+
+/** @param {string} str */
+export function encodeEntities(str) {
+	// Skip all work for strings with no entities needing encoding:
+	if (str.length === 0 || ENCODED_ENTITIES.test(str) === false) return str;
+
+	let last = 0,
+		i = 0,
+		out = '',
+		ch = '';
+
+	// Seek forward in str until the next entity char:
+	for (; i < str.length; i++) {
+		switch (str.charCodeAt(i)) {
+			case 34:
+				ch = '&quot;';
+				break;
+			case 38:
+				ch = '&amp;';
+				break;
+			case 60:
+				ch = '&lt;';
+				break;
+			default:
+				continue;
+		}
+		// Append skipped/buffered characters and the encoded entity:
+		if (i !== last) out += str.slice(last, i);
+		out += ch;
+		// Start the next seek/buffer after the entity's offset:
+		last = i + 1;
+	}
+	if (i !== last) out += str.slice(last, i);
+	return out;
+}