@treeseed/core 0.1.2

package/dist/vendor/starlight/components/SidebarPersister.astro

@@ -0,0 +1,78 @@
+---
+/*
+  This component is designed to wrap the tree of `<SidebarSublist>` components in the sidebar.
+
+  It does the following:
+  - Wraps the tree in an `<sl-sidebar-state-persist>` custom element
+  - Before the tree renders, adds an inline script which loads state and defines
+  the behaviour for the `<sl-sidebar-restore>` custom element.
+  - After the tree renders, adds an inline script which restores the sidebar scroll state.
+
+  Notes:
+  - On smaller viewports, restoring state is skipped as the sidebar is collapsed inside a menu.
+  - The state is parsed from session storage and restored.
+  - This is a progressive enhancement, so any errors are swallowed silently.
+
+  The `aria-hidden` attribute on script tags is used to prevent a Safari/VoiceOver bug where the
+  script is read out loud due to them being inside a container with `display: contents`.
+  @see https://bugs.webkit.org/show_bug.cgi?id=283645
+  @see https://github.com/withastro/starlight/pull/2633
+*/
+
+import { getSidebarHash } from '../utils/navigation';
+
+const hash = getSidebarHash(Astro.locals.starlightRoute.sidebar);
+
+declare global {
+	interface Window {
+		/** Restored scroll position. Briefly stored on the `window` global to pass between inline scripts. */
+		_starlightScrollRestore?: number;
+	}
+}
+---
+
+<sl-sidebar-state-persist data-hash={hash}>
+	<script is:inline aria-hidden="true">
+		(() => {
+			try {
+				if (!matchMedia('(min-width: 50em)').matches) return;
+				/** @type {HTMLElement | null} */
+				const target = document.querySelector('sl-sidebar-state-persist');
+				const state = JSON.parse(sessionStorage.getItem('sl-sidebar-state') || '0');
+				if (!target || !state || target.dataset.hash !== state.hash) return;
+				window._starlightScrollRestore = state.scroll;
+				customElements.define(
+					'sl-sidebar-restore',
+					class SidebarRestore extends HTMLElement {
+						connectedCallback() {
+							try {
+								const idx = parseInt(this.dataset.index || '');
+								const details = this.closest('details');
+								if (details && typeof state.open[idx] === 'boolean') details.open = state.open[idx];
+							} catch {}
+						}
+					}
+				);
+			} catch {}
+		})();
+	</script>
+
+	<slot />
+
+	<script is:inline aria-hidden="true">
+		(() => {
+			const scroller = document.getElementById('starlight__sidebar');
+			if (!window._starlightScrollRestore || !scroller) return;
+			scroller.scrollTop = window._starlightScrollRestore;
+			delete window._starlightScrollRestore;
+		})();
+	</script>
+</sl-sidebar-state-persist>
+
+<style>
+	@layer starlight.core {
+		sl-sidebar-state-persist {
+			display: contents;
+		}
+	}
+</style>

package/dist/vendor/starlight/components/SidebarRestorePoint.astro

@@ -0,0 +1,12 @@
+---
+/** Unique symbol for storing a running index in `locals`. */
+const currentGroupIndexSymbol = Symbol.for('starlight-sidebar-group-index');
+const locals = Astro.locals as App.Locals & { [currentGroupIndexSymbol]: number };
+
+/** The current sidebar group’s index retrieved from `locals` if set, starting at `0`. */
+const index = locals[currentGroupIndexSymbol] || 0;
+// Increment the index for the next instance.
+locals[currentGroupIndexSymbol] = index + 1;
+---
+
+<sl-sidebar-restore data-index={index}></sl-sidebar-restore>

package/dist/vendor/starlight/components/SidebarSublist.astro

@@ -0,0 +1,154 @@
+---
+import { flattenSidebar } from '../utils/navigation';
+import type { SidebarEntry } from '../utils/routing/types';
+import Icon from '../user-components/Icon.astro';
+import Badge from '../user-components/Badge.astro';
+import SidebarRestorePoint from './SidebarRestorePoint.astro';
+
+interface Props {
+	sublist: SidebarEntry[];
+	nested?: boolean;
+}
+
+const { sublist, nested } = Astro.props;
+---
+
+<ul class:list={{ 'top-level': !nested }}>
+	{
+		sublist.map((entry) => (
+			<li>
+				{entry.type === 'link' ? (
+					<a
+						href={entry.href}
+						aria-current={entry.isCurrent ? 'page' : undefined}
+						class:list={[{ large: !nested }, entry.attrs.class]}
+						{...entry.attrs}
+					>
+						<span>{entry.label}</span>
+						{entry.badge && (
+							<Badge
+								variant={entry.badge.variant}
+								class={entry.badge.class}
+								text={entry.badge.text}
+							/>
+						)}
+					</a>
+				) : (
+					<details
+						open={flattenSidebar(entry.entries).some((i) => i.isCurrent) || !entry.collapsed}
+					>
+						<summary>
+							<span class="group-label">
+								<span class="large">{entry.label}</span>
+								{entry.badge && (
+									<Badge
+										variant={entry.badge.variant}
+										class={entry.badge.class}
+										text={entry.badge.text}
+									/>
+								)}
+							</span>
+							<Icon name="right-caret" class="caret" size="1.25rem" />
+						</summary>
+						<SidebarRestorePoint />
+						<Astro.self sublist={entry.entries} nested />
+					</details>
+				)}
+			</li>
+		))
+	}
+</ul>
+
+<style>
+	@layer starlight.core {
+		ul {
+			--sl-sidebar-item-padding-inline: 0.5rem;
+			list-style: none;
+			padding: 0;
+		}
+
+		li {
+			overflow-wrap: anywhere;
+		}
+
+		ul ul li {
+			margin-inline-start: var(--sl-sidebar-item-padding-inline);
+			border-inline-start: 1px solid var(--sl-color-hairline-light);
+			padding-inline-start: var(--sl-sidebar-item-padding-inline);
+		}
+
+		.large {
+			font-size: var(--sl-text-lg);
+			font-weight: 600;
+			color: var(--sl-color-white);
+		}
+
+		.top-level > li + li {
+			margin-top: 0.75rem;
+		}
+
+		summary {
+			display: flex;
+			align-items: center;
+			justify-content: space-between;
+			padding: 0.2em var(--sl-sidebar-item-padding-inline);
+			line-height: 1.4;
+			cursor: pointer;
+			user-select: none;
+		}
+		summary::marker,
+		summary::-webkit-details-marker {
+			display: none;
+		}
+
+		.caret {
+			transition: transform 0.2s ease-in-out;
+			flex-shrink: 0;
+		}
+		:global([dir='rtl']) .caret {
+			transform: rotateZ(180deg);
+		}
+		[open] > summary .caret {
+			transform: rotateZ(90deg);
+		}
+
+		a {
+			display: block;
+			border-radius: 0.25rem;
+			text-decoration: none;
+			color: var(--sl-color-gray-2);
+			padding: 0.3em var(--sl-sidebar-item-padding-inline);
+			line-height: 1.4;
+		}
+
+		a:hover,
+		a:focus {
+			color: var(--sl-color-white);
+		}
+
+		[aria-current='page'],
+		[aria-current='page']:hover,
+		[aria-current='page']:focus {
+			font-weight: 600;
+			color: var(--sl-color-text-invert);
+			background-color: var(--sl-color-text-accent);
+		}
+
+		a > *:not(:last-child),
+		.group-label > *:not(:last-child) {
+			margin-inline-end: 0.25em;
+		}
+
+		@media (min-width: 50rem) {
+			.top-level > li + li {
+				margin-top: 0.5rem;
+			}
+			.large {
+				font-size: var(--sl-text-base);
+			}
+			a {
+				font-size: var(--sl-text-sm);
+			}
+		}
+	}
+</style>

package/dist/vendor/starlight/components/SiteTitle.astro

@@ -0,0 +1,59 @@
+---
+import { logos } from 'virtual:starlight/user-images';
+import config from 'virtual:starlight/user-config';
+const { siteTitle, siteTitleHref } = Astro.locals.starlightRoute;
+---
+
+<a href={siteTitleHref} class="site-title sl-flex">
+	{
+		config.logo && logos.dark && (
+			<>
+				<img
+					class:list={{ 'light:sl-hidden print:hidden': !('src' in config.logo) }}
+					alt={config.logo.alt}
+					src={logos.dark.src}
+					width={logos.dark.width}
+					height={logos.dark.height}
+				/>
+				{/* Show light alternate if a user configure both light and dark logos. */}
+				{!('src' in config.logo) && (
+					<img
+						class="dark:sl-hidden print:block"
+						alt={config.logo.alt}
+						src={logos.light?.src}
+						width={logos.light?.width}
+						height={logos.light?.height}
+					/>
+				)}
+			</>
+		)
+	}
+	<span class:list={{ 'sr-only': config.logo?.replacesTitle }} translate="no">
+		{siteTitle}
+	</span>
+</a>
+
+<style>
+	@layer starlight.core {
+		.site-title {
+			align-items: center;
+			gap: var(--sl-nav-gap);
+			font-size: var(--sl-text-h4);
+			font-weight: 600;
+			color: var(--sl-color-text-accent);
+			text-decoration: none;
+			white-space: nowrap;
+			min-width: 0;
+		}
+		span {
+			overflow: hidden;
+		}
+		img {
+			height: calc(var(--sl-nav-height) - 2 * var(--sl-nav-pad-y));
+			width: auto;
+			max-width: 100%;
+			object-fit: contain;
+			object-position: 0 50%;
+		}
+	}
+</style>

package/dist/vendor/starlight/components/SkipLink.astro

@@ -0,0 +1,26 @@
+---
+import { PAGE_TITLE_ID } from '../constants';
+---
+
+<a href={`#${PAGE_TITLE_ID}`}>{Astro.locals.t('skipLink.label')}</a>
+
+<style>
+	@layer starlight.core {
+		a {
+			clip: rect(0, 0, 0, 0);
+			position: fixed;
+			top: 0.75rem;
+			inset-inline-start: 0.75rem;
+		}
+		a:focus {
+			clip: unset;
+			z-index: var(--sl-z-index-skiplink);
+			display: block;
+			padding: 0.5rem 1rem;
+			text-decoration: none;
+			color: var(--sl-color-text-invert);
+			background-color: var(--sl-color-text-accent);
+			box-shadow: var(--sl-shadow-lg);
+		}
+	}
+</style>

package/dist/vendor/starlight/components/SocialIcons.astro

@@ -0,0 +1,32 @@
+---
+import config from 'virtual:starlight/user-config';
+import Icon from '../user-components/Icon.astro';
+
+const links = config.social || [];
+---
+
+{
+	links.length > 0 && (
+		<>
+			{links.map(({ label, href, icon }) => (
+				<a {href} rel="me" class="sl-flex">
+					<span class="sr-only">{label}</span>
+					<Icon name={icon} />
+				</a>
+			))}
+		</>
+	)
+}
+
+<style>
+	@layer starlight.core {
+		a {
+			color: var(--sl-color-text-accent);
+			padding: 0.5em;
+			margin: -0.5em;
+		}
+		a:hover {
+			opacity: 0.66;
+		}
+	}
+</style>

package/dist/vendor/starlight/components/StarlightPage.astro

@@ -0,0 +1,17 @@
+---
+import { attachRouteDataAndRunMiddleware } from '../utils/routing/middleware';
+import {
+	generateStarlightPageRouteData,
+	type StarlightPageProps as Props,
+} from '../utils/starlight-page';
+import Page from './Page.astro';
+
+export type StarlightPageProps = Props;
+
+await attachRouteDataAndRunMiddleware(
+	Astro,
+	await generateStarlightPageRouteData({ props: Astro.props, context: Astro })
+);
+---
+
+<Page><slot /></Page>

package/dist/vendor/starlight/components/TableOfContents/TableOfContentsList.astro

@@ -0,0 +1,79 @@
+---
+import type { TocItem } from '../../utils/generateToC';
+
+interface Props {
+	toc: TocItem[];
+	depth?: number;
+	isMobile?: boolean;
+}
+
+const { toc, isMobile = false, depth = 0 } = Astro.props;
+---
+
+<ul class:list={{ isMobile }}>
+	{
+		toc.map((heading) => (
+			<li>
+				<a href={'#' + heading.slug}>
+					<span>{heading.text}</span>
+				</a>
+				{heading.children.length > 0 && (
+					<Astro.self toc={heading.children} depth={depth + 1} isMobile={isMobile} />
+				)}
+			</li>
+		))
+	}
+</ul>
+
+<style define:vars={{ depth }}>
+	@layer starlight.core {
+		ul {
+			padding: 0;
+			list-style: none;
+		}
+		a {
+			--pad-inline: 0.5rem;
+			display: block;
+			border-radius: 0.25rem;
+			padding-block: 0.25rem;
+			padding-inline: calc(1rem * var(--depth) + var(--pad-inline)) var(--pad-inline);
+			line-height: 1.25;
+		}
+		a[aria-current='true'] {
+			color: var(--sl-color-text-accent);
+		}
+		.isMobile a {
+			--pad-inline: 1rem;
+			display: flex;
+			justify-content: space-between;
+			gap: var(--pad-inline);
+			border-top: 1px solid var(--sl-color-gray-6);
+			border-radius: 0;
+			padding-block: 0.5rem;
+			color: var(--sl-color-text);
+			font-size: var(--sl-text-sm);
+			text-decoration: none;
+			outline-offset: var(--sl-outline-offset-inside);
+		}
+		.isMobile:first-child > li:first-child > a {
+			border-top: 0;
+		}
+		.isMobile a[aria-current='true'],
+		.isMobile a[aria-current='true']:hover,
+		.isMobile a[aria-current='true']:focus {
+			color: var(--sl-color-white);
+			background-color: unset;
+		}
+		.isMobile a[aria-current='true']::after {
+			content: '';
+			width: 1rem;
+			background-color: var(--sl-color-text-accent);
+			/* Check mark SVG icon */
+			-webkit-mask-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnIHZpZXdCb3g9JzAgMCAxNCAxNCc+PHBhdGggZD0nTTEwLjkxNCA0LjIwNmEuNTgzLjU4MyAwIDAgMC0uODI4IDBMNS43NCA4LjU1NyAzLjkxNCA2LjcyNmEuNTk2LjU5NiAwIDAgMC0uODI4Ljg1N2wyLjI0IDIuMjRhLjU4My41ODMgMCAwIDAgLjgyOCAwbDQuNzYtNC43NmEuNTgzLjU4MyAwIDAgMCAwLS44NTdaJy8+PC9zdmc+Cg==');
+			mask-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnIHZpZXdCb3g9JzAgMCAxNCAxNCc+PHBhdGggZD0nTTEwLjkxNCA0LjIwNmEuNTgzLjU4MyAwIDAgMC0uODI4IDBMNS43NCA4LjU1NyAzLjkxNCA2LjcyNmEuNTk2LjU5NiAwIDAgMC0uODI4Ljg1N2wyLjI0IDIuMjRhLjU4My41ODMgMCAwIDAgLjgyOCAwbDQuNzYtNC43NmEuNTgzLjU4MyAwIDAgMCAwLS44NTdaJy8+PC9zdmc+Cg==');
+			-webkit-mask-repeat: no-repeat;
+			mask-repeat: no-repeat;
+			flex-shrink: 0;
+		}
+	}
+</style>

package/dist/vendor/starlight/components/TableOfContents/starlight-toc.js

@@ -0,0 +1,93 @@
+import { PAGE_TITLE_ID } from "../../constants.js";
+class StarlightTOC extends HTMLElement {
+  _current = this.querySelector('a[aria-current="true"]');
+  minH = parseInt(this.dataset.minH || "2", 10);
+  maxH = parseInt(this.dataset.maxH || "3", 10);
+  /**
+   * CSS selector string that matches only headings that can appear in the table of contents.
+   * Generates a selector like `h1#_top,:where(h2,h3)[id]`.
+   */
+  tocHeadingSelector = `h1#${PAGE_TITLE_ID},:where(${[...Array.from({ length: 1 + this.maxH - this.minH }).map((_, index) => `h${this.minH + index}`)].join()})[id]`;
+  set current(link) {
+    if (link === this._current) return;
+    if (this._current) this._current.removeAttribute("aria-current");
+    link.setAttribute("aria-current", "true");
+    this._current = link;
+  }
+  onIdle = (cb) => (window.requestIdleCallback || ((cb2) => setTimeout(cb2, 1)))(cb);
+  constructor() {
+    super();
+    this.onIdle(() => this.init());
+  }
+  init = () => {
+    const links = [...this.querySelectorAll("a")];
+    const isHeading = (el) => el.matches(this.tocHeadingSelector);
+    const getElementHeading = (el) => {
+      if (!el) return null;
+      const origin = el;
+      while (el) {
+        if (el.matches(".sl-markdown-content, main > *")) {
+          return document.getElementById(PAGE_TITLE_ID);
+        }
+        if (isHeading(el)) return el;
+        const childHeading = el.querySelector(this.tocHeadingSelector);
+        if (childHeading) return childHeading;
+        el = el.previousElementSibling;
+        while (el?.lastElementChild) {
+          el = el.lastElementChild;
+        }
+        const h = getElementHeading(el);
+        if (h) return h;
+      }
+      return getElementHeading(origin.parentElement);
+    };
+    const setCurrent = (entries) => {
+      for (const { isIntersecting, target } of entries) {
+        if (!isIntersecting) continue;
+        const heading = getElementHeading(target);
+        if (!heading) continue;
+        const link = links.find((link2) => link2.hash === "#" + encodeURIComponent(heading.id));
+        if (link) {
+          this.current = link;
+          break;
+        }
+      }
+    };
+    const toObserve = document.querySelectorAll(
+      [
+        `main :where(${this.tocHeadingSelector})`,
+        `main :where(${this.tocHeadingSelector}, .sl-heading-wrapper) ~ *:not(:has(${this.tocHeadingSelector}))`,
+        `main .sl-markdown-content > *:not(:has(${this.tocHeadingSelector}))`,
+        `main > *:not(:has(${this.tocHeadingSelector}))`
+      ].join()
+    );
+    let observer;
+    const observe = () => {
+      if (observer) return;
+      observer = new IntersectionObserver(setCurrent, { rootMargin: this.getRootMargin() });
+      toObserve.forEach((h) => observer.observe(h));
+    };
+    observe();
+    let timeout;
+    window.addEventListener("resize", () => {
+      if (observer) {
+        observer.disconnect();
+        observer = void 0;
+      }
+      clearTimeout(timeout);
+      timeout = setTimeout(() => this.onIdle(observe), 200);
+    });
+  };
+  getRootMargin() {
+    const navBarHeight = document.querySelector("header")?.getBoundingClientRect().height || 0;
+    const mobileTocHeight = this.querySelector("summary")?.getBoundingClientRect().height || 0;
+    const top = navBarHeight + mobileTocHeight + 32;
+    const bottom = top + 53;
+    const height = document.documentElement.clientHeight;
+    return `-${top}px 0% ${bottom - height}px`;
+  }
+}
+customElements.define("starlight-toc", StarlightTOC);
+export {
+  StarlightTOC
+};

package/dist/vendor/starlight/components/TableOfContents.astro

@@ -0,0 +1,18 @@
+---
+import TableOfContentsList from './TableOfContents/TableOfContentsList.astro';
+
+const { toc } = Astro.locals.starlightRoute;
+---
+
+{
+	toc && (
+		<starlight-toc data-min-h={toc.minHeadingLevel} data-max-h={toc.maxHeadingLevel}>
+			<nav aria-labelledby="starlight__on-this-page">
+				<h2 id="starlight__on-this-page">{Astro.locals.t('tableOfContents.onThisPage')}</h2>
+				<TableOfContentsList toc={toc.items} />
+			</nav>
+		</starlight-toc>
+	)
+}
+
+<script src="./TableOfContents/starlight-toc.js"></script>

package/dist/vendor/starlight/components/ThemeProvider.astro

@@ -0,0 +1,38 @@
+---
+import Icon from '../user-components/Icon.astro';
+---
+
+{/* This is intentionally inlined to avoid FOUC. */}
+<script is:inline>
+	window.StarlightThemeProvider = (() => {
+		const storedTheme =
+			typeof localStorage !== 'undefined' && localStorage.getItem('starlight-theme');
+		const theme =
+			storedTheme ||
+			(window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark');
+		document.documentElement.dataset.theme = theme === 'light' ? 'light' : 'dark';
+		return {
+			updatePickers(theme = storedTheme || 'auto') {
+				document.querySelectorAll('starlight-theme-select').forEach((picker) => {
+					const select = picker.querySelector('select');
+					if (select) select.value = theme;
+					/** @type {HTMLTemplateElement | null} */
+					const tmpl = document.querySelector(`#theme-icons`);
+					const newIcon = tmpl && tmpl.content.querySelector('.' + theme);
+					if (newIcon) {
+						const oldIcon = picker.querySelector('svg.label-icon');
+						if (oldIcon) {
+							oldIcon.replaceChildren(...newIcon.cloneNode(true).childNodes);
+						}
+					}
+				});
+			},
+		};
+	})();
+</script>
+
+<template id="theme-icons">
+	<Icon name="sun" class="light" />
+	<Icon name="moon" class="dark" />
+	<Icon name="laptop" class="auto" />
+</template>

package/dist/vendor/starlight/components/ThemeSelect.astro

@@ -0,0 +1,73 @@
+---
+import Select from './Select.astro';
+---
+
+<starlight-theme-select>
+	{/* TODO: Can we give this select a width that works well for each language’s strings? */}
+	<Select
+		icon="laptop"
+		label={Astro.locals.t('themeSelect.accessibleLabel')}
+		options={[
+			{ label: Astro.locals.t('themeSelect.dark'), selected: false, value: 'dark' },
+			{ label: Astro.locals.t('themeSelect.light'), selected: false, value: 'light' },
+			{ label: Astro.locals.t('themeSelect.auto'), selected: true, value: 'auto' },
+		]}
+		width="6.25em"
+	/>
+</starlight-theme-select>
+
+{/* Inlined to avoid FOUC. Uses global scope from `ThemeProvider.astro` */}
+<script is:inline>
+	StarlightThemeProvider.updatePickers();
+</script>
+
+<script>
+	type Theme = 'auto' | 'dark' | 'light';
+
+	/** Key in `localStorage` to store color theme preference at. */
+	const storageKey = 'starlight-theme';
+
+	/** Get a typesafe theme string from any JS value (unknown values are coerced to `'auto'`). */
+	const parseTheme = (theme: unknown): Theme =>
+		theme === 'auto' || theme === 'dark' || theme === 'light' ? theme : 'auto';
+
+	/** Load the user’s preference from `localStorage`. */
+	const loadTheme = (): Theme =>
+		parseTheme(typeof localStorage !== 'undefined' && localStorage.getItem(storageKey));
+
+	/** Store the user’s preference in `localStorage`. */
+	function storeTheme(theme: Theme): void {
+		if (typeof localStorage !== 'undefined') {
+			localStorage.setItem(storageKey, theme === 'light' || theme === 'dark' ? theme : '');
+		}
+	}
+
+	/** Get the preferred system color scheme. */
+	const getPreferredColorScheme = (): Theme =>
+		matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
+
+	/** Update select menu UI, document theme, and local storage state. */
+	function onThemeChange(theme: Theme): void {
+		StarlightThemeProvider.updatePickers(theme);
+		document.documentElement.dataset.theme = theme === 'auto' ? getPreferredColorScheme() : theme;
+		storeTheme(theme);
+	}
+
+	// React to changes in system color scheme.
+	matchMedia(`(prefers-color-scheme: light)`).addEventListener('change', () => {
+		if (loadTheme() === 'auto') onThemeChange('auto');
+	});
+
+	class StarlightThemeSelect extends HTMLElement {
+		constructor() {
+			super();
+			onThemeChange(loadTheme());
+			this.querySelector('select')?.addEventListener('change', (e) => {
+				if (e.currentTarget instanceof HTMLSelectElement) {
+					onThemeChange(parseTheme(e.currentTarget.value));
+				}
+			});
+		}
+	}
+	customElements.define('starlight-theme-select', StarlightThemeSelect);
+</script>