mn-docs-mcp 0.6.2 → 1.1.0

package/src/components/Search.astro

@@ -1,330 +0,0 @@
----
-/**
- * 覆盖 Starlight 默认 Search 组件：
- * 默认实现只在 DOMContentLoaded 时初始化 Pagefind UI。
- * 但 Cloudflare Rocket Loader 可能把 module script 延迟到 DOMContentLoaded 之后才执行，
- * 导致监听器永远不触发，从而出现“搜索弹窗空白”。
- *
- * 这里改为：
- * - 若页面已非 loading：立即初始化
- * - 否则等待 DOMContentLoaded
- * 并用全局标记避免重复初始化。
- */
-import project from 'virtual:starlight/project-context';
- 
-const pagefindTranslations = {
-	placeholder: Astro.locals.t('search.label'),
-	...Object.fromEntries(
-		Object.entries(Astro.locals.t.all())
-			.filter(([key]) => key.startsWith('pagefind.'))
-			.map(([key, value]) => [key.replace('pagefind.', ''), value])
-	),
-};
- 
-const dataAttributes: DOMStringMap = { 'data-translations': JSON.stringify(pagefindTranslations) };
-if (project.trailingSlash === 'never') dataAttributes['data-strip-trailing-slash'] = '';
----
-
-<site-search class={Astro.props.class} {...dataAttributes}>
-	<button
-		data-open-modal
-		disabled
-		aria-label={Astro.locals.t('search.label')}
-		aria-keyshortcuts="Control+K"
-	>
-		<svg aria-hidden="true" width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
-			<path
-				d="M21.71 20.29 18 16.61A9 9 0 1 0 16.61 18l3.68 3.68a.999.999 0 0 0 1.42 0 1 1 0 0 0 0-1.39ZM11 18a7 7 0 1 1 0-14 7 7 0 0 1 0 14Z"
-			/>
-		</svg>
-		<span class="sl-hidden md:sl-block" aria-hidden="true">{Astro.locals.t('search.label')}</span>
-		<kbd class="sl-hidden md:sl-flex" style="display: none;">
-			<kbd>{Astro.locals.t('search.ctrlKey')}</kbd><kbd>K</kbd>
-		</kbd>
-	</button>
-
-	<dialog style="padding:0" aria-label={Astro.locals.t('search.label')}>
-		<div class="dialog-frame sl-flex">
-			{
-				/* TODO: Make the layout of this button flexible to accommodate different word lengths. Currently hard-coded for English: “Cancel” */
-			}
-			<button data-close-modal class="sl-flex md:sl-hidden">
-				{Astro.locals.t('search.cancelLabel')}
-			</button>
-			{
-				import.meta.env.DEV ? (
-					<div style="margin: auto; text-align: center; white-space: pre-line;" dir="ltr">
-						<p>{Astro.locals.t('search.devWarning')}</p>
-					</div>
-				) : (
-					<div class="search-container">
-						<div id="starlight__search" />
-					</div>
-				)
-			}
-		</div>
-	</dialog>
-</site-search>
-
-{
-	/**
-	 * This is intentionally inlined to avoid briefly showing an invalid shortcut.
-	 * Purposely using the deprecated `navigator.platform` property to detect Apple devices, as the
-	 * user agent is spoofed by some browsers when opening the devtools.
-	 */
-}
-<script is:inline>
-	(() => {
-		const openBtn = document.querySelector('button[data-open-modal]');
-		const shortcut = openBtn?.querySelector('kbd');
-		if (!openBtn || !(shortcut instanceof HTMLElement)) return;
-		const platformKey = shortcut.querySelector('kbd');
-		if (platformKey && /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {
-			platformKey.textContent = '⌘';
-			openBtn.setAttribute('aria-keyshortcuts', 'Meta+K');
-		}
-		shortcut.style.display = '';
-	})();
-</script>
-
-<script>
-	import { pagefindUserConfig } from 'virtual:starlight/pagefind-config';
-
-	const PAGEFIND_INIT_FLAG = '__starlight_pagefind_ui_initialized__';
-
-	class SiteSearch extends HTMLElement {
-		constructor() {
-			super();
-			const openBtn = this.querySelector<HTMLButtonElement>('button[data-open-modal]')!;
-			const closeBtn = this.querySelector<HTMLButtonElement>('button[data-close-modal]')!;
-			const dialog = this.querySelector('dialog')!;
-			const dialogFrame = this.querySelector('.dialog-frame')!;
-
-			/** Close the modal if a user clicks on a link or outside of the modal. */
-			const onClick = (event: MouseEvent) => {
-				const isLink = 'href' in (event.target || {});
-				if (
-					isLink ||
-					(document.body.contains(event.target as Node) &&
-						!dialogFrame.contains(event.target as Node))
-				) {
-					closeModal();
-				}
-			};
-
-			const openModal = (event?: MouseEvent) => {
-				dialog.showModal();
-				document.body.toggleAttribute('data-search-modal-open', true);
-				this.querySelector('input')?.focus();
-				event?.stopPropagation();
-				window.addEventListener('click', onClick);
-			};
-
-			const closeModal = () => dialog.close();
-
-			openBtn.addEventListener('click', openModal);
-			openBtn.disabled = false;
-			closeBtn.addEventListener('click', closeModal);
-
-			dialog.addEventListener('close', () => {
-				document.body.toggleAttribute('data-search-modal-open', false);
-				window.removeEventListener('click', onClick);
-			});
-
-			// Listen for `ctrl + k` and `cmd + k` keyboard shortcuts.
-			window.addEventListener('keydown', (e) => {
-				if ((e.metaKey === true || e.ctrlKey === true) && e.key === 'k') {
-					dialog.open ? closeModal() : openModal();
-					e.preventDefault();
-				}
-			});
-
-			let translations = {};
-			try {
-				translations = JSON.parse(this.dataset.translations || '{}');
-			} catch {}
-
-			const shouldStrip = this.dataset.stripTrailingSlash !== undefined;
-			const stripTrailingSlash = (path: string) => path.replace(/(.)\/(#.*)?$/, '$1$2');
-			const formatURL = shouldStrip ? stripTrailingSlash : (path: string) => path;
-
-			const initPagefind = async () => {
-				if (import.meta.env.DEV) return;
-				// 防止 Header / MobileMenu 等场景重复挂载
-				if ((window as any)[PAGEFIND_INIT_FLAG]) return;
-				(window as any)[PAGEFIND_INIT_FLAG] = true;
-
-				const onIdle = window.requestIdleCallback || ((cb) => setTimeout(cb, 1));
-				onIdle(async () => {
-					// @ts-expect-error — Missing types for @pagefind/default-ui package.
-					const { PagefindUI } = await import('@pagefind/default-ui');
-					new PagefindUI({
-						...pagefindUserConfig,
-						element: '#starlight__search',
-						baseUrl: import.meta.env.BASE_URL,
-						bundlePath: import.meta.env.BASE_URL.replace(/\/$/, '') + '/pagefind/',
-						showImages: false,
-						translations,
-						showSubResults: true,
-						processResult: (result: { url: string; sub_results: Array<{ url: string }> }) => {
-							result.url = formatURL(result.url);
-							result.sub_results = result.sub_results.map((sub_result) => {
-								sub_result.url = formatURL(sub_result.url);
-								return sub_result;
-							});
-						},
-					});
-				});
-			};
-
-			// Rocket Loader 可能让 script 在 DOMContentLoaded 之后才执行：因此不能只监听事件
-			if (document.readyState === 'loading') {
-				window.addEventListener('DOMContentLoaded', initPagefind, { once: true });
-			} else {
-				void initPagefind();
-			}
-		}
-	}
-	customElements.define('site-search', SiteSearch);
-</script>
-
-<style>
-	@layer starlight.core {
-		site-search {
-			display: contents;
-		}
-		button[data-open-modal] {
-			display: flex;
-			align-items: center;
-			gap: 0.5rem;
-			border: 0;
-			background-color: transparent;
-			color: var(--sl-color-gray-1);
-			cursor: pointer;
-			height: 2.5rem;
-			font-size: var(--sl-text-xl);
-		}
-
-		@media (min-width: 50rem) {
-			button[data-open-modal] {
-				border: 1px solid var(--sl-color-gray-5);
-				border-radius: 0.5rem;
-				padding-inline-start: 0.75rem;
-				padding-inline-end: 0.5rem;
-				background-color: var(--sl-color-black);
-				color: var(--sl-color-gray-2);
-				font-size: var(--sl-text-sm);
-				width: 100%;
-				max-width: 22rem;
-			}
-			button[data-open-modal]:hover {
-				border-color: var(--sl-color-gray-2);
-				color: var(--sl-color-white);
-			}
-
-			button[data-open-modal] > :last-child {
-				margin-inline-start: auto;
-			}
-		}
-
-		button > kbd {
-			border-radius: 0.25rem;
-			font-size: var(--sl-text-2xs);
-			gap: 0.25em;
-			padding-inline: 0.375rem;
-			background-color: var(--sl-color-gray-6);
-		}
-
-		kbd {
-			font-family: var(--__sl-font);
-		}
-
-		dialog {
-			margin: 0;
-			background-color: var(--sl-color-gray-6);
-			border: 1px solid var(--sl-color-gray-5);
-			width: 100%;
-			max-width: 100%;
-			height: 100%;
-			max-height: 100%;
-			box-shadow: var(--sl-shadow-lg);
-		}
-		dialog[open] {
-			display: flex;
-		}
-
-		dialog::backdrop {
-			background-color: var(--sl-color-backdrop-overlay);
-			-webkit-backdrop-filter: blur(0.25rem);
-			backdrop-filter: blur(0.25rem);
-		}
-
-		.dialog-frame {
-			position: relative;
-			overflow: auto;
-			flex-direction: column;
-			flex-grow: 1;
-			gap: 1rem;
-			padding: 1rem;
-		}
-
-		button[data-close-modal] {
-			position: absolute;
-			z-index: 1;
-			align-items: center;
-			align-self: flex-end;
-			height: calc(64px * var(--pagefind-ui-scale));
-			padding: 0.25rem;
-			border: 0;
-			background: transparent;
-			cursor: pointer;
-			color: var(--sl-color-text-accent);
-		}
-
-		#starlight__search {
-			--pagefind-ui-primary: var(--sl-color-text);
-			--pagefind-ui-text: var(--sl-color-gray-2);
-			--pagefind-ui-font: var(--__sl-font);
-			--pagefind-ui-background: var(--sl-color-black);
-			--pagefind-ui-border: var(--sl-color-gray-5);
-			--pagefind-ui-border-width: 1px;
-			--pagefind-ui-tag: var(--sl-color-gray-5);
-			--sl-search-cancel-space: 5rem;
-		}
-
-		:root[data-theme='light'] #starlight__search {
-			--pagefind-ui-tag: var(--sl-color-gray-6);
-		}
-
-		@media (min-width: 50rem) {
-			#starlight__search {
-				--sl-search-cancel-space: 0px;
-			}
-
-			dialog {
-				margin: 4rem auto auto;
-				border-radius: 0.5rem;
-				width: 90%;
-				max-width: 40rem;
-				height: max-content;
-				min-height: 15rem;
-				max-height: calc(100% - 8rem);
-			}
-
-			.dialog-frame {
-				padding: 1.5rem;
-			}
-		}
-	}
-</style>
-
-<style is:global>
-	@import url('@pagefind/default-ui/css/ui.css') layer(starlight.core);
-
-	@layer starlight.core {
-		[data-search-modal-open] {
-			overflow: hidden;
-		}
-	}
-</style>
-

package/src/content.config.ts

@@ -1,7 +0,0 @@
-import { defineCollection } from 'astro:content';
-import { docsLoader } from '@astrojs/starlight/loaders';
-import { docsSchema } from '@astrojs/starlight/schema';
-
-export const collections = {
-	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
-};

package/src/styles/starlight-overrides.css

@@ -1,23 +0,0 @@
-@layer starlight.overrides {
-	/* Disable horizontal scrolling for tables and prefer wrapping instead. */
-	.sl-markdown-content table:not(:where(.not-content *)) {
-		display: table;
-		overflow: visible;
-		width: 100%;
-		table-layout: fixed;
-	}
-
-	.sl-markdown-content :is(th, td):not(:where(.not-content *)) {
-		white-space: normal;
-		overflow-wrap: anywhere;
-		word-break: break-word;
-	}
-
-	/* Inline code inside table cells should also wrap instead of forcing overflow. */
-	.sl-markdown-content :is(th, td) code:not(:where(.not-content *)) {
-		white-space: normal;
-		overflow-wrap: anywhere;
-		word-break: break-word;
-	}
-}
-