mn-docs-mcp 0.6.2 → 1.1.0

package/src/lib/source.ts

@@ -0,0 +1,7 @@
+import { docs } from '@/.source/server';
+import { loader } from 'fumadocs-core/source';
+
+export const source = loader({
+	baseUrl: '',
+	source: docs.toFumadocsSource(),
+});

package/tsconfig.json

@@ -1,5 +1,44 @@
 {
-  "extends": "astro/tsconfigs/strict",
-  "include": [".astro/types.d.ts", "**/*"],
-  "exclude": ["dist"]
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "es2022"
+    ],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".source/**/*",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "out",
+    "dist"
+  ]
 }

package/astro.config.mjs

@@ -1,126 +0,0 @@
-// @ts-check
-import { defineConfig } from 'astro/config';
-import starlight from '@astrojs/starlight';
-
-// https://astro.build/config
-export default defineConfig({
-	site: 'https://mn-docs.museday.top',
-	integrations: [
-		starlight({
-			title: 'MarginNote 插件开发文档',
-			customCss: ['/src/styles/starlight-overrides.css'],
-			components: {
-				Search: './src/components/Search.astro',
-				Footer: './src/components/Footer.astro',
-			},
-			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/Temsys-Shen/marginnote-addon-docs' }],
-			sidebar: [
-				{
-					label: '入门',
-					items: [
-						{ label: '快速开始', slug: 'guides/getting-started' },
-					],
-				},
-				{
-					label: '教程与 Cookbook',
-					items: [
-						{ label: '生命周期与窗口', slug: 'guides/lifecycle-and-window' },
-						{ label: '笔记与数据库', slug: 'guides/notes-and-database' },
-						{ label: '脑图与选区', slug: 'guides/mindmap-and-selection' },
-						{ label: '工具栏与命令', slug: 'guides/toolbar-and-commands' },
-						{ label: '快捷键', slug: 'guides/shortcut-keys' },
-						{ label: '原生 UI', slug: 'guides/native-ui' },
-						{ label: '存储与文件', slug: 'guides/storage-and-files' },
-						{ label: '网络请求', slug: 'guides/network-requests' },
-						{
-							label: 'Cookbook 配方',
-							items: [
-								{ label: '批量修改笔记标题', slug: 'guides/cookbook/batch-rename-notes' },
-								{ label: '调用远程 API', slug: 'guides/cookbook/network-api-call' },
-								{ label: '导出当前笔记本', slug: 'guides/cookbook/export-notebook' },
-								{ label: '在脑图中高亮指定笔记', slug: 'guides/cookbook/focus-note-in-mindmap' },
-								{ label: '将选区追加为评论', slug: 'guides/cookbook/append-selection-as-comment' },
-								{ label: '插件设置页', slug: 'guides/cookbook/addon-settings' },
-								{ label: '在插件中嵌入 WebView 面板', slug: 'guides/cookbook/embed-webview-panel' },
-								{ label: 'WebView 内 JS 与插件 JS 双向通信', slug: 'guides/cookbook/webview-bidirectional-js' },
-							],
-						},
-					],
-				},
-				{
-					label: 'API 参考',
-					items: [
-						{
-							label: '全局与入口',
-							items: [
-								{ label: '全局入口对象', slug: 'reference/global/global-variables' },
-								{ label: 'JSB', slug: 'reference/global/jsb' },
-								{ label: 'Application', slug: 'reference/global/application' },
-								{ label: 'SearchManager', slug: 'reference/global/search-manager' },
-								{ label: 'Database', slug: 'reference/global/database' },
-								{ label: 'Note', slug: 'reference/global/note' },
-								{ label: 'PopupMenu', slug: 'reference/global/popup-menu' },
-								{ label: 'PopupMenuItem', slug: 'reference/global/popup-menu-item' },
-								{ label: 'self', slug: 'reference/global/self' },
-							],
-						},
-						{
-							label: 'MarginNote 核心',
-							items: [
-								{ label: 'JSExtension', slug: 'reference/marginnote/jsextension' },
-								{ label: 'StudyController', slug: 'reference/marginnote/study-controller' },
-								{ label: 'NotebookController', slug: 'reference/marginnote/notebook-controller' },
-								{ label: 'ReaderController', slug: 'reference/marginnote/reader-controller' },
-								{ label: 'DocumentController', slug: 'reference/marginnote/document-controller' },
-								{ label: 'MindMapView', slug: 'reference/marginnote/mindmap-view' },
-								{ label: 'OutlineView', slug: 'reference/marginnote/outline-view' },
-								{ label: 'MindMapNode', slug: 'reference/marginnote/mindmap-node' },
-								{ label: 'MbBookNote', slug: 'reference/marginnote/mb-book-note' },
-								{ label: 'NoteComment', slug: 'reference/marginnote/note-comment' },
-								{ label: 'MbTopic', slug: 'reference/marginnote/mb-topic' },
-								{ label: 'MbBook', slug: 'reference/marginnote/mb-book' },
-								{ label: 'MbModelTool', slug: 'reference/marginnote/mb-model-tool' },
-							],
-						},
-						{
-							label: 'Foundation',
-							autogenerate: { directory: 'reference/foundation' },
-						},
-						{
-							label: 'UIKit',
-							autogenerate: { directory: 'reference/uikit' },
-						},
-						{
-							label: 'QuartzCore',
-							autogenerate: { directory: 'reference/quartzcore' },
-						},
-						{
-							label: 'Utility',
-							autogenerate: { directory: 'reference/utility' },
-						},
-						{
-							label: '运行时边界',
-							items: [
-								{ label: 'JavaScript 原生环境', slug: 'reference/js-runtime' },
-								{ label: '隐藏的边界（The Black Box）', slug: 'reference/black-box' },
-							],
-						},
-						{
-							label: '附录',
-							items: [
-								{ label: '内建command清单', slug: 'reference/global/builtin-commands' },
-							],
-						},
-					],
-				},
-				{
-					label: '关于',
-					items: [
-						{ label: '贡献指南', slug: 'guides/contributing' },
-					],
-				},
-			],
-
-		}),
-	],
-});

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>