mn-docs-mcp 1.0.0 → 1.1.0

package/src/client/jsb-api-footer.ts

@@ -1,242 +0,0 @@
-type JsbApi = {
-	protocol: string;
-	properties: string[];
-	instance_methods: string[];
-	class_methods: string[];
-	export_aliases: Record<string, string>;
-};
-
-const headerUrlLoaders = import.meta.glob('../definitions/**/*.h', {
-	query: '?url',
-	import: 'default',
-});
-
-type PageConfig = {
-	protocol: string;
-	only?: Array<'properties' | 'class' | 'instance' | 'aliases'>;
-};
-
-const GLOBAL_PAGE_PROTOCOL_MAP: Record<string, PageConfig> = {
-	'reference/global/application': { protocol: 'JSBApplication' },
-	'reference/global/database': { protocol: 'JSBMbModelTool' },
-	'reference/global/note': { protocol: 'JSBMbBookNote', only: ['class'] },
-	'reference/global/self': { protocol: 'JSBJSExtension' },
-};
-
-function getPageTitle(): string | null {
-	const h1 = document.querySelector('main h1');
-	const t = (h1 && h1.textContent ? h1.textContent : '').trim();
-	return t || null;
-}
-
-function protocolFromTitle(title: string): string {
-	return `JSB${title.replace(/\s+/g, '')}`;
-}
-
-function selectorGuessFromDecl(decl: string): string {
-	const stripped = decl.split('//', 1)[0].trim().replace(/;$/, '').trim();
-	const noPrefix = stripped.replace(/^[-+]\s*\([^)]*\)\s*/, '').trim();
-	if (!noPrefix.includes(':')) return noPrefix.split(/\s|\(/, 1)[0].trim();
-	const parts = noPrefix.split(':');
-	const labels = parts.slice(0, -1).map((p) => {
-		const tokens = p.match(/[A-Za-z_][A-Za-z0-9_]*/g);
-		return tokens && tokens.length ? tokens[tokens.length - 1] : '';
-	});
-	return `${labels.join(':')}:`;
-}
-
-function jsNameFromObjcDecl(decl: string): string {
-	const stripped = decl.split('//', 1)[0].trim().replace(/;$/, '').trim();
-	const noPrefix = stripped.replace(/^[-+]\s*\([^)]*\)\s*/, '').trim();
-	if (!noPrefix.includes(':')) return noPrefix.split(/\s|\(/, 1)[0].trim();
-	const parts = noPrefix.split(':');
-	const labels = parts.slice(0, -1).map((p) => {
-		const tokens = p.match(/[A-Za-z_][A-Za-z0-9_]*/g);
-		return tokens && tokens.length ? tokens[tokens.length - 1] : '';
-	});
-	if (!labels.length) return '';
-	let js = labels[0];
-	for (const lab of labels.slice(1)) {
-		if (!lab) continue;
-		js += lab[0].toUpperCase() + lab.slice(1);
-	}
-	return js;
-}
-
-function parseProtocolFromHeader(headerText: string, protocolName: string): JsbApi {
-	const lines = headerText.split(/\r?\n/);
-	let inProtocol = false;
-	const properties: string[] = [];
-	const instanceMethods: string[] = [];
-	const classMethods: string[] = [];
-	const exportAliases: Record<string, string> = {};
-	let pendingExportAs: string | null = null;
-
-	for (const raw of lines) {
-		const line = raw.trim();
-		if (!line || line.startsWith('#') || line.startsWith('//')) continue;
-		const start = line.match(/^@protocol\s+(\w+)\b/);
-		if (start) {
-			inProtocol = start[1] === protocolName;
-			pendingExportAs = null;
-			continue;
-		}
-		if (!inProtocol) continue;
-		if (line === '@end') break;
-
-		if (line.startsWith('JSExportAs(')) {
-			const m = line.match(/^JSExportAs\(\s*([A-Za-z_][A-Za-z0-9_]*)\s*,/);
-			if (m) pendingExportAs = m[1];
-			continue;
-		}
-		if (line.startsWith('@property')) {
-			const m = line.match(/([A-Za-z_][A-Za-z0-9_]*)\s*;\s*(?:(?:\/\/).*)?$/);
-			if (m) properties.push(m[1]);
-			continue;
-		}
-		if (line.startsWith('- (') || line.startsWith('+ (')) {
-			const jsName = pendingExportAs || jsNameFromObjcDecl(line);
-			const selector = selectorGuessFromDecl(line);
-			if (pendingExportAs) exportAliases[jsName] = selector;
-			pendingExportAs = null;
-			if (line.startsWith('+ (')) classMethods.push(jsName);
-			else instanceMethods.push(jsName);
-			continue;
-		}
-	}
-
-	const uniq = (arr: string[]) => Array.from(new Set(arr.filter(Boolean))).sort();
-	const sortedAliases = Object.fromEntries(
-		Object.entries(exportAliases).sort(([a], [b]) => a.localeCompare(b))
-	) as Record<string, string>;
-
-	return {
-		protocol: protocolName,
-		properties: uniq(properties),
-		instance_methods: uniq(instanceMethods),
-		class_methods: uniq(classMethods),
-		export_aliases: sortedAliases,
-	};
-}
-
-function el<K extends keyof HTMLElementTagNameMap>(
-	name: K,
-	attrs: Record<string, string> = {},
-	children: Node[] = []
-): HTMLElementTagNameMap[K] {
-	const node = document.createElement(name);
-	for (const [k, v] of Object.entries(attrs)) {
-		if (k === 'text') node.textContent = v;
-		else node.setAttribute(k, v);
-	}
-	for (const c of children) node.appendChild(c);
-	return node;
-}
-
-function code(text: string): HTMLElement {
-	return el('code', { text });
-}
-
-function renderApi(container: HTMLElement, api: JsbApi, only?: PageConfig['only']) {
-	const allowed = new Set(only ?? ['properties', 'class', 'instance', 'aliases']);
-	container.textContent = '';
-	if (allowed.has('properties') && api.properties.length) {
-		container.appendChild(el('h3', { text: '属性' }));
-		const ul = el('ul');
-		for (const p of api.properties) ul.appendChild(el('li', {}, [code(p)]));
-		container.appendChild(ul);
-	}
-	if (allowed.has('class') && api.class_methods.length) {
-		container.appendChild(el('h3', { text: '类方法' }));
-		const ul = el('ul');
-		for (const m of api.class_methods) ul.appendChild(el('li', {}, [code(`${m}()`)]));
-		container.appendChild(ul);
-	}
-	if (allowed.has('instance') && api.instance_methods.length) {
-		container.appendChild(el('h3', { text: '实例方法' }));
-		const ul = el('ul');
-		for (const m of api.instance_methods) ul.appendChild(el('li', {}, [code(`${m}()`)]));
-		container.appendChild(ul);
-	}
-	const aliasKeys = Object.keys(api.export_aliases || {});
-	if (allowed.has('aliases') && aliasKeys.length) {
-		container.appendChild(el('h3', { text: 'JSExportAs 别名' }));
-		const table = el('table');
-		const thead = el('thead');
-		const trh = el('tr');
-		trh.appendChild(el('th', { text: 'JS 名' }));
-		trh.appendChild(el('th', { text: 'ObjC selector（推断）' }));
-		thead.appendChild(trh);
-		table.appendChild(thead);
-		const tbody = el('tbody');
-		for (const jsName of aliasKeys) {
-			const tr = el('tr');
-			tr.appendChild(el('td', {}, [code(jsName)]));
-			tr.appendChild(el('td', {}, [code(api.export_aliases[jsName])])); 
-			tbody.appendChild(tr);
-		}
-		table.appendChild(tbody);
-		container.appendChild(table);
-	}
-}
-
-async function loadHeaderText(protocol: string): Promise<{ source: string; text: string } | null> {
-	const entries = Object.keys(headerUrlLoaders);
-	const targetKey = entries.find((k) => k.endsWith(`/${protocol}.h`));
-	if (!targetKey) return null;
-	const url = (await (headerUrlLoaders as any)[targetKey]()) as string;
-	const resp = await fetch(url);
-	if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
-	return { source: targetKey.replace('../definitions/', ''), text: await resp.text() };
-}
-
-function getSlug(): string {
-	return location.pathname.replace(/^\/+/, '').replace(/\/+$/, '');
-}
-
-export function initJsbApiFooter() {
-	const root = document.querySelector<HTMLElement>('[data-jsb-api]');
-	if (!root) return;
-
-	if (!location.pathname.startsWith('/reference/')) {
-		root.style.display = 'none';
-		return;
-	}
-
-	const statusEl = root.querySelector<HTMLElement>('[data-jsb-api-status]')!;
-	const protocolEl = root.querySelector<HTMLElement>('[data-jsb-api-protocol]')!;
-	const sourceEl = root.querySelector<HTMLElement>('[data-jsb-api-source]')!;
-	const bodyEl = root.querySelector<HTMLElement>('[data-jsb-api-body]')!;
-
-	const slug = getSlug();
-	const cfg = GLOBAL_PAGE_PROTOCOL_MAP[slug];
-
-	let protocol: string | null = cfg?.protocol ?? null;
-	if (!protocol) {
-		const title = getPageTitle();
-		if (!title) {
-			root.style.display = 'none';
-			return;
-		}
-		protocol = protocolFromTitle(title);
-	}
-
-	protocolEl.textContent = protocol;
-
-	(async () => {
-		try {
-			const loaded = await loadHeaderText(protocol);
-			if (!loaded) {
-				root.style.display = 'none';
-				return;
-			}
-			const api = parseProtocolFromHeader(loaded.text, protocol);
-			sourceEl.textContent = loaded.source;
-			renderApi(bodyEl, api, cfg?.only);
-			statusEl.textContent = '';
-		} catch (e: any) {
-			// Keep user-facing UI clean: hide the block on errors.
-			root.style.display = 'none';
-		}
-	})().catch(() => {});
-}

package/src/components/Footer.astro

@@ -1,57 +0,0 @@
----
-import DefaultFooter from '@astrojs/starlight/components/Footer.astro';
----
-
-<section class="jsb-api sl-markdown-content" data-jsb-api>
-	<details class="jsb-api__details">
-		<summary class="jsb-api__summary">头文件 API 清单</summary>
-		<p class="jsb-api__meta">
-			<span data-jsb-api-status>正在加载…</span>
-		</p>
-		<p class="jsb-api__meta">
-			协议：<code data-jsb-api-protocol>—</code>，来源：<code data-jsb-api-source>—</code>
-		</p>
-		<div data-jsb-api-body></div>
-	</details>
-</section>
-
-<DefaultFooter />
-
-<script>
-	import { initJsbApiFooter } from '../client/jsb-api-footer';
-
-	initJsbApiFooter();
-</script>
-
-<style>
-	@layer starlight.components {
-		.jsb-api {
-			margin-top: 2rem;
-		}
-		.jsb-api__details {
-			border: 1px solid var(--sl-color-gray-6);
-			border-radius: 0.75rem;
-			padding: 0.75rem 1rem;
-			background: color-mix(in srgb, var(--sl-color-gray-7), transparent 70%);
-		}
-		.jsb-api__summary {
-			cursor: pointer;
-			font-weight: 600;
-		}
-		.jsb-api__meta {
-			margin-top: 0.75rem;
-			color: var(--sl-color-gray-3);
-			font-size: var(--sl-text-sm);
-		}
-		.jsb-api__meta code {
-			word-break: break-all;
-		}
-		.jsb-api :global(ul) {
-			margin-top: 0.5rem;
-		}
-		.jsb-api :global(table) {
-			margin-top: 0.75rem;
-			width: 100%;
-		}
-	}
-</style>

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;
-	}
-}
-