@windcoder/astro-theme-orchid 0.0.0-stage → 0.2.0

package/src/plugins/rehype.ts

@@ -0,0 +1,284 @@
+/**
+ * rehype 插件集（M3a，全部零依赖手写 hast 遍历）
+ *
+ * 挂载顺序（index.ts）：externalLinks → callouts → figure → firstImage → anchor
+ * 代码块渲染自 §4.61 起由 Expressive Code 接管（index.ts 直连 rehype 内核），
+ * 本文件不再包含代码块插件。
+ * 注意：hast 节点类名有两种形态——shiki/EC 产出用 HTML 属性名直接写 properties
+ * （class 为字符串而非 className 数组）；remark-rehype 原始节点则是 className
+ * 数组。读取类名务必走 getClassList 兼容两种形态。
+ */
+type Transformer = (tree: any, file: any) => void;
+
+/** 浅遍历辅助：对 node.children 逐个调用 fn，fn 可通过返回 'skip' 跳过子树 */
+function visit(node: any, fn: (n: any, parent: any | null) => void | "skip") {
+	const children = node.children;
+	if (!Array.isArray(children)) return;
+	for (const child of children) {
+		if (fn(child, node) !== "skip") visit(child, fn);
+	}
+}
+
+const isBlank = (n: any) => n.type === "text" && !n.value.trim();
+
+/**
+ * 读取 hast 节点类名列表（兼容两种形态）：shiki 产出用 HTML 属性名直接写
+ * properties（class 为字符串），remark-rehype 原始节点则是 className 数组。
+ */
+function getClassList(props: any): string[] {
+	const raw = props?.className ?? props?.class;
+	if (Array.isArray(raw)) return raw.map(String);
+	if (typeof raw === "string") return raw.split(/\s+/).filter(Boolean);
+	return [];
+}
+
+/* ---------------------------------------------------------------- 外链 */
+
+/**
+ * 外链新窗口打开：http(s) 绝对链接追加 target="_blank" rel="noopener noreferrer"
+ */
+export function rehypeExternalLinks(): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "element" || node.tagName !== "a") return;
+			const href = String(node.properties?.href ?? "");
+			if (!/^https?:\/\//i.test(href)) return;
+			node.properties.target = "_blank";
+			const rel = String(node.properties.rel ?? "");
+			const parts = new Set(rel.split(/\s+/).filter(Boolean));
+			parts.add("noopener");
+			parts.add("noreferrer");
+			node.properties.rel = [...parts].join(" ");
+		});
+	};
+}
+
+/* -------------------------------------------------------------- callouts */
+
+const CALLOUT_META: Record<
+	string,
+	{ cls: string; title: string; icon: string }
+> = {
+	NOTE: { cls: "info", title: "注", icon: "info" },
+	INFO: { cls: "info", title: "信息", icon: "info" },
+	TIP: { cls: "tip", title: "技巧", icon: "tip" },
+	ABSTRACT: { cls: "tip", title: "摘要", icon: "tip" },
+	SUMMARY: { cls: "tip", title: "摘要", icon: "tip" },
+	TLDR: { cls: "tip", title: "摘要", icon: "tip" },
+	TODO: { cls: "tip", title: "待办", icon: "tip" },
+	IMPORTANT: { cls: "important", title: "重要", icon: "important" },
+	EXAMPLE: { cls: "important", title: "示例", icon: "important" },
+	WARNING: { cls: "warn", title: "注意", icon: "warn" },
+	CAUTION: { cls: "warn", title: "警告", icon: "warn" },
+	ATTENTION: { cls: "warn", title: "注意", icon: "warn" },
+	QUESTION: { cls: "warn", title: "问题", icon: "help" },
+	HELP: { cls: "warn", title: "帮助", icon: "help" },
+	FAQ: { cls: "warn", title: "问答", icon: "help" },
+	DANGER: { cls: "danger", title: "危险", icon: "danger" },
+	ERROR: { cls: "danger", title: "错误", icon: "x" },
+	FAILURE: { cls: "danger", title: "失败", icon: "x" },
+	FAIL: { cls: "danger", title: "失败", icon: "x" },
+	MISSING: { cls: "danger", title: "缺失", icon: "x" },
+	BUG: { cls: "danger", title: "缺陷", icon: "bug" },
+	SUCCESS: { cls: "success", title: "成功", icon: "check" },
+	CHECK: { cls: "success", title: "成功", icon: "check" },
+	DONE: { cls: "success", title: "完成", icon: "check" },
+	QUOTE: { cls: "quote", title: "引用", icon: "quote" },
+	CITE: { cls: "quote", title: "引用", icon: "quote" },
+};
+
+/** 与原型一致的 lucide 风格图标（stroke 1.75） */
+const CALLOUT_ICONS: Record<string, string> = {
+	info: '<circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/>',
+	tip: '<path d="M9 18h6"/><path d="M10 22h4"/><path d="M15.09 14c.18-.98.65-1.74 1.41-2.5A4.65 4.65 0 0 0 18 8 6 6 0 0 0 6 8c0 1 .23 2.23 1.5 3.5A4.61 4.61 0 0 1 8.91 14"/>',
+	important:
+		'<path d="M2.7 10.3a2.41 2.41 0 0 0 0 3.41l7.59 7.59a2.41 2.41 0 0 0 3.41 0l7.59-7.59a2.41 2.41 0 0 0 0-3.41l-7.59-7.59a2.41 2.41 0 0 0-3.41 0z"/><path d="M12 8v4"/><path d="M12 16h.01"/>',
+	warn: '<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3"/><path d="M12 9v4"/><path d="M12 17h.01"/>',
+	danger: '<path d="M13 2 3 14h9l-1 8 10-12h-9l1-8z"/>',
+	check: '<path d="M20 6 9 17l-5-5"/>',
+	help: '<circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><path d="M12 17h.01"/>',
+	x: '<path d="M18 6 6 18"/><path d="m6 6 12 12"/>',
+	bug: '<path d="m8 2 1.88 1.88"/><path d="M14.12 3.88 16 2"/><path d="M9 7.13v-1a3.003 3.003 0 1 1 6 0v1"/><path d="M12 20c-3.3 0-6-2.7-6-6v-3a4 4 0 0 1 4-4h4a4 4 0 0 1 4 4v3c0 3.3-2.7 6-6 6"/><path d="M12 20v-9"/><path d="M6.53 9C4.6 8.8 3 7.1 3 5"/><path d="M6 13H2"/><path d="M3 21c0-2.1 1.7-3.9 3.8-4"/><path d="M20.97 5c0 2.1-1.6 3.8-3.5 4"/><path d="M22 13h-4"/><path d="M17.2 17c2.1.1 3.8 1.9 3.8 4"/>',
+	quote:
+		'<path d="M16 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z"/><path d="M5 3a2 2 0 0 0-2 2v6a2 2 0 0 0 2 2 1 1 0 0 1 1 1v1a2 2 0 0 1-2 2 1 1 0 0 0-1 1v2a1 1 0 0 0 1 1 6 6 0 0 0 6-6V5a2 2 0 0 0-2-2z"/>',
+};
+
+function iconSvg(name: string) {
+	return {
+		type: "element",
+		tagName: "svg",
+		properties: {
+			className: ["co-icon"],
+			viewBox: "0 0 24 24",
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: "1.75",
+			strokeLinecap: "round",
+			strokeLinejoin: "round",
+			ariaHidden: "true",
+		},
+		children: [
+			{ type: "raw", value: CALLOUT_ICONS[name] ?? CALLOUT_ICONS.info },
+		],
+	};
+}
+
+/**
+ * GitHub 警告块语法：> [!TYPE]（26 种别名，GFM alert + Obsidian callout 集合）
+ * 转换为 <div class="callout {cls}"><svg class="co-icon"/><div><b>标题</b>…原内容</div></div>
+ * 中文默认标题；[!TYPE] 同一行剩余文字作为自定义标题；语义相近的别名共用配色。
+ */
+export function rehypeCallouts(): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "element" || node.tagName !== "blockquote") return;
+			// 注意：Astro 7 的 mdast→hast 转换会给 blockquote 塞入首尾 "\n" 空白文本节点，
+			// 不能假设 children[0] 就是 <p>，须按类型查找首个元素子节点
+			const first = (node.children ?? []).find(
+				(c: any) => c.type === "element",
+			);
+			if (!first || first.tagName !== "p") return;
+			const firstText = first.children?.find((c: any) => c.type === "text");
+			if (!firstText) return;
+			const m = String(firstText.value).match(
+				/^\[!(NOTE|INFO|TIP|ABSTRACT|SUMMARY|TLDR|TODO|IMPORTANT|EXAMPLE|WARNING|CAUTION|ATTENTION|QUESTION|HELP|FAQ|DANGER|ERROR|BUG|FAILURE|FAIL|MISSING|SUCCESS|CHECK|DONE|QUOTE|CITE)\][ \t]*\n?/i,
+			);
+			if (!m) return;
+			const meta = CALLOUT_META[m[1].toUpperCase()];
+			// 移除标记文本；[!TYPE] 同一行剩余文字作为自定义标题（GitHub 语法）。
+			// 「无标题」时正则已吃掉换行（m[0] 以 \n 结尾），「有标题」时只吃到空格，
+			// 故以 m[0] 是否以 \n 结尾区分，避免把正文首行误当标题
+			const rest = String(firstText.value).slice(m[0].length);
+			let custom = "";
+			let bodyText = rest;
+			if (!m[0].endsWith("\n")) {
+				const nl = rest.indexOf("\n");
+				if (nl === -1) {
+					custom = rest.trim();
+					bodyText = "";
+				} else {
+					custom = rest.slice(0, nl).trim();
+					bodyText = rest.slice(nl + 1);
+				}
+			}
+			firstText.value = bodyText;
+			const title = custom || meta.title;
+			if (!firstText.value && first.children.length === 1) {
+				node.children = node.children.filter((c: any) => c !== first);
+			}
+			const body = {
+				type: "element",
+				tagName: "div",
+				properties: {},
+				children: [
+					{
+						type: "element",
+						tagName: "b",
+						properties: {},
+						children: [{ type: "text", value: title }],
+					},
+					...node.children,
+				],
+			};
+			node.tagName = "div";
+			node.properties = { className: ["callout", meta.cls] };
+			node.children = [iconSvg(meta.icon), body];
+		});
+	};
+}
+
+/* ---------------------------------------------------------------- figure */
+
+/**
+ * 独立段落中的单图 → <figure>；img 的 title 属性 → <figcaption>。
+ * 灯箱归组交给页面级 data-lightbox-gallery 容器（§4.70）：figure 不再自带
+ * data-lightbox，否则文章容器内嵌套两组容器会被双重绑定点击监听而双开灯箱
+ */
+export function rehypeFigure(): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "element" || node.tagName !== "p") return;
+			const meaningful = (node.children ?? []).filter((c: any) => !isBlank(c));
+			if (
+				meaningful.length !== 1 ||
+				meaningful[0].type !== "element" ||
+				meaningful[0].tagName !== "img"
+			)
+				return;
+			const img = meaningful[0];
+			const title = img.properties?.title;
+			const figure: any = {
+				type: "element",
+				tagName: "figure",
+				properties: {},
+				children: [img],
+			};
+			if (title) {
+				delete img.properties.title;
+				figure.children.push({
+					type: "element",
+					tagName: "figcaption",
+					properties: {},
+					children: [{ type: "text", value: String(title) }],
+				});
+			}
+			// 用 figure 替换 p 内容（p 无其他有意义子节点，直接整体替换）
+			node.tagName = "figure";
+			node.properties = figure.properties;
+			node.children = figure.children;
+		});
+	};
+}
+
+/* -------------------------------------------------------------- 首图提取 */
+
+/**
+ * 提取正文第一张图片地址 → frontmatter.firstImage（列表卡片封面兜底，决策 9）
+ */
+export function rehypeFirstImage(): Transformer {
+	return (tree, file) => {
+		let found = false;
+		visit(tree, (node) => {
+			if (found) return "skip";
+			if (node.type === "element" && node.tagName === "img") {
+				const src = node.properties?.src;
+				if (typeof src === "string" && src) {
+					file.data.astro.frontmatter.firstImage = src;
+					found = true;
+				}
+			}
+			return;
+		});
+	};
+}
+
+/* ------------------------------------------------------------ 标题锚点 */
+
+/**
+ * h2–h4（Astro 已注入 id）末尾追加 <a class="h-anchor">#</a>
+ */
+export function rehypeAnchor(): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "element") return;
+			if (!["h2", "h3", "h4"].includes(node.tagName)) return;
+			const id = node.properties?.id;
+			if (!id) return;
+			node.children.push({
+				type: "element",
+				tagName: "a",
+				properties: {
+					className: ["h-anchor"],
+					href: `#${id}`,
+					ariaLabel: "链接到本节",
+				},
+				children: [{ type: "text", value: "#" }],
+			});
+		});
+	};
+}
+
+/* -------------------------------------------------------------- 代码块 */
+
+/* §4.61 起代码块渲染由 Expressive Code 接管（index.ts 直连 rehype 内核），
+   自研 rehypeCodeBlock（复制/折叠按钮包装）已退役；此处不再有代码块插件 */

package/src/plugins/remark-diagram.ts

@@ -0,0 +1,78 @@
+/**
+ * remark 图表标记插件（M3b-b4，移植自 orchid-blog）
+ *
+ * - remarkMermaid：```mermaid 代码块 → 自定义节点 type='mermaid'，
+ *   data.hName/hProperties 落为 <div class="mermaid-container" data-mermaid-code="…">，
+ *   hChildren 保留源码文本（构建期渲染失败时可降级展示），value 置空避免重复输出
+ * - remarkPlantuml：```plantuml 代码块 → <div class="plantuml-wrapper">，
+ *   双主题 URL（injectTheme → pako deflate → PlantUML base64url）预编码进 data 属性，
+ *   构建期零请求，主题切换由客户端换 src 完成
+ */
+
+import { buildUrl, encodePlantUML, injectTheme } from "./plantuml-encoder.js";
+
+type Transformer = (tree: any, file: any) => void;
+
+/** 深度遍历辅助（与 rehype.ts 内 visit 同风格），fn 返回 'skip' 跳过子树 */
+function visit(node: any, fn: (n: any) => void | "skip") {
+	const children = node.children;
+	if (!Array.isArray(children)) return;
+	for (const child of children) {
+		if (fn(child) !== "skip") visit(child, fn);
+	}
+}
+
+export function remarkMermaid(): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "code") return;
+			if (String(node.lang ?? "").toLowerCase() !== "mermaid") return;
+			const code = String(node.value ?? "");
+			node.type = "mermaid";
+			node.data = { ...node.data };
+			node.data.hName = "div";
+			node.data.hProperties = {
+				className: ["mermaid-container"],
+				"data-mermaid-code": code,
+			};
+			node.data.hChildren = [{ type: "text", value: code }];
+			node.value = undefined;
+		});
+	};
+}
+
+export interface PlantumlOptions {
+	/** PlantUML 渲染服务地址，如 https://www.plantuml.com/plantuml */
+	server: string;
+	/** 浅色主题名（空 = 不注入 !theme，尊重图内已有声明） */
+	lightTheme?: string;
+	/** 深色主题名（空 = 复用浅色 URL） */
+	darkTheme?: string;
+}
+
+export function remarkPlantuml(options: PlantumlOptions): Transformer {
+	return (tree) => {
+		visit(tree, (node) => {
+			if (node.type !== "code") return;
+			if (String(node.lang ?? "").toLowerCase() !== "plantuml") return;
+			const code = String(node.value ?? "");
+			const lightSource = injectTheme(code, options.lightTheme ?? "");
+			const darkSource = injectTheme(code, options.darkTheme ?? "");
+			const lightUrl = buildUrl(options.server, encodePlantUML(lightSource));
+			const darkUrl =
+				darkSource === lightSource
+					? lightUrl
+					: buildUrl(options.server, encodePlantUML(darkSource));
+			node.type = "plantuml";
+			node.data = { ...node.data };
+			node.data.hName = "div";
+			node.data.hProperties = {
+				className: ["plantuml-wrapper"],
+				"data-light-src": lightUrl,
+				"data-dark-src": darkUrl,
+				"data-plantuml-alt": code.slice(0, 200),
+			};
+			node.value = undefined;
+		});
+	};
+}

package/src/plugins/remark-directives.ts

@@ -0,0 +1,100 @@
+/**
+ * remark-directive 指令分发（A2/A3，移植自参考模板 remark-directive-rehype）
+ *
+ * 官方 remark-directive 将 :::container / ::leaf / :text 指令解析为三类
+ * directive 节点，本插件统一改写：
+ * - containerDirective + 26 种 admonition 类型 → blockquote，并在首段注入
+ *   "[!TYPE] " 标记，复用既有 rehypeCallouts 渲染（自定义 label 融入标题）
+ * - 其余指令 → hastscript 转成同名自定义标签（如 ::github{repo=…} →
+ *   <github repo="…">），交由对应 rehype 插件替换（rehypeGithubCard）
+ */
+import { h } from "hastscript";
+
+/** 参考模板的 26 种 admonition 类型（GitHub 6 种 + Obsidian 扩充别名） */
+const ADMONITION_TYPES = new Set([
+	"note",
+	"tip",
+	"important",
+	"warning",
+	"caution",
+	"abstract",
+	"summary",
+	"tldr",
+	"info",
+	"todo",
+	"success",
+	"check",
+	"done",
+	"question",
+	"help",
+	"faq",
+	"attention",
+	"failure",
+	"missing",
+	"fail",
+	"danger",
+	"error",
+	"bug",
+	"example",
+	"quote",
+	"cite",
+]);
+
+export function remarkDirectives(): any {
+	const transform = (node: any) => {
+		if (
+			node.type !== "containerDirective" &&
+			node.type !== "leafDirective" &&
+			node.type !== "textDirective"
+		)
+			return;
+		const name = String(node.name ?? "").toLowerCase();
+
+		if (node.type === "containerDirective" && ADMONITION_TYPES.has(name)) {
+			const type = name.toUpperCase();
+			const firstChild = node.children[0];
+			if (firstChild?.data?.directiveLabel) {
+				// 自定义标题：标记注入 label 首文本，由 rehypeCallouts 提为标题
+				if (
+					firstChild.children.length > 0 &&
+					firstChild.children[0].type === "text"
+				) {
+					firstChild.children[0].value = `[!${type}] ${firstChild.children[0].value}`;
+				} else {
+					firstChild.children.unshift({
+						type: "text",
+						value: `[!${type}] `,
+					});
+				}
+			} else {
+				// 无标题：插入仅含标记的新段落
+				node.children.unshift({
+					type: "paragraph",
+					children: [{ type: "text", value: `[!${type}]` }],
+				});
+			}
+			// 关键：转 blockquote 且清除 hProperties，防止变成自定义标签
+			node.type = "blockquote";
+			node.data = node.data ?? {};
+			node.data.hName = "blockquote";
+			delete node.data.hProperties;
+		} else {
+			// 其他指令：转同名自定义标签（attributes 原样带入），样式缺省不可见，
+			// 由对应 rehype 插件负责替换
+			node.data = node.data ?? {};
+			const hast = h(name, node.attributes ?? {});
+			node.data.hName = hast.tagName;
+			node.data.hProperties = hast.properties;
+		}
+	};
+
+	const walk = (node: any) => {
+		if (!Array.isArray(node.children)) return;
+		for (const child of node.children) {
+			transform(child);
+			walk(child);
+		}
+	};
+
+	return (tree: any) => walk(tree);
+}

package/src/plugins/remark-excerpt.ts

@@ -0,0 +1,29 @@
+/**
+ * remark 插件：自动摘要（写入 frontmatter.excerpt）
+ *
+ * 取正文第一个 paragraph 的纯文本（与 orchid-blog 的 remark-excerpt 行为一致）。
+ * description 字段仍是手动维护的展示摘要；excerpt 仅作列表兜底。
+ */
+export function remarkExcerpt() {
+	return (tree: any, { data }: any) => {
+		let excerpt = "";
+		for (const node of tree.children || []) {
+			if (node.type !== "paragraph") continue;
+			excerpt = mdastToString(node).trim();
+			break;
+		}
+		data.astro.frontmatter.excerpt = excerpt;
+	};
+}
+
+/** 近似 mdast-util-to-string：递归取 text / inlineCode 的 value，忽略 html 与 image */
+function mdastToString(node: any): string {
+	if (!node) return "";
+	if (node.type === "text" || node.type === "inlineCode")
+		return node.value || "";
+	if (node.type === "html" || node.type === "image" || node.type === "code")
+		return "";
+	let out = "";
+	for (const child of node.children || []) out += mdastToString(child);
+	return out;
+}

package/src/plugins/remark-image-grid.ts

@@ -0,0 +1,97 @@
+/**
+ * [grid]…[/grid] 图片网格（A1，移植自参考模板 remark-image-grid）
+ *
+ * 支持两种形态：
+ * 1. 同段：[grid] ![a](…) ![b](…) [/grid]（标签与图片同段）
+ * 2. 跨段：[grid] 独行、图片段落若干、[/grid] 独行；未闭合时原样输出不转换
+ *
+ * 列数 = 网格内图片数（上限 4，无图缺省 2）。输出 div.image-grid[data-cols="N"]，
+ * 布局由主题 CSS 生成——不用参考模板的 tailwind 动态类（md:grid-cols-N 这类
+ * 拼接类名在 node_modules symlink 源码中不可靠扫描，见 §4.10）。
+ */
+
+const countImages = (node: any): number => {
+	let count = node.type === "image" ? 1 : 0;
+	if (Array.isArray(node.children)) {
+		for (const child of node.children) count += countImages(child);
+	}
+	return count;
+};
+
+const gridNode = (children: any[]) => {
+	const cols = Math.min(4, countImages({ children }) || 2);
+	return {
+		type: "paragraph",
+		data: {
+			hName: "div",
+			hProperties: {
+				className: ["image-grid"],
+				"data-cols": String(cols),
+			},
+		},
+		children,
+	};
+};
+
+export function remarkImageGrid(): any {
+	return (tree: any) => {
+		if (tree.type !== "root") return;
+		const newChildren: any[] = [];
+		let inGrid = false;
+		let gridChildren: any[] = [];
+
+		for (const node of tree.children) {
+			if (node.type === "paragraph" && node.children?.length > 0) {
+				const first = node.children[0];
+				const last = node.children[node.children.length - 1];
+				const hasStart =
+					first.type === "text" && first.value.trim().startsWith("[grid]");
+				const hasEnd =
+					last.type === "text" && last.value.trim().endsWith("[/grid]");
+
+				// 形态 1：[grid]…[/grid] 同段
+				if (hasStart && hasEnd && !inGrid) {
+					first.value = first.value.replace(/^\s*\[grid\]\s*/, "");
+					last.value = last.value.replace(/\s*\[\/grid\]\s*$/, "");
+					newChildren.push(
+						gridNode(
+							node.children.filter(
+								(n: any) => n.type !== "text" || n.value.trim() !== "",
+							),
+						),
+					);
+					continue;
+				}
+
+				// 形态 2：跨段开始（[grid] 独行则丢弃该段落）
+				if (!inGrid && hasStart) {
+					inGrid = true;
+					first.value = first.value.replace(/^\s*\[grid\]\s*/, "");
+					if (!(node.children.length === 1 && first.value.trim() === "")) {
+						gridChildren.push(node);
+					}
+					continue;
+				}
+
+				// 形态 2：跨段结束，汇总图片数定列数
+				if (inGrid && hasEnd) {
+					inGrid = false;
+					last.value = last.value.replace(/\s*\[\/grid\]\s*$/, "");
+					if (!(node.children.length === 1 && last.value.trim() === "")) {
+						gridChildren.push(node);
+					}
+					newChildren.push(gridNode(gridChildren));
+					gridChildren = [];
+					continue;
+				}
+			}
+
+			if (inGrid) gridChildren.push(node);
+			else newChildren.push(node);
+		}
+
+		// 未闭合：原样输出已收集内容
+		if (inGrid) newChildren.push(...gridChildren);
+		tree.children = newChildren;
+	};
+}

package/src/plugins/remark-reading-time.ts

@@ -0,0 +1,38 @@
+/**
+ * remark 插件：阅读时长与字数统计（写入 frontmatter.minutes / frontmatter.words）
+ *
+ * 口径（自实现，零依赖，对中文博客更准确）：
+ * - words = CJK 字符数 + 非 CJK 单词数
+ * - minutes = max(1, round(words / 275))，275 wpm 为 reading-time 默认速度
+ * 值在渲染期由 remark 链写入，不经过 content collection schema 校验，
+ * 组件通过 `const { remarkPluginFrontmatter } = await render(post)` 读取。
+ */
+export function remarkReadingTime() {
+	return (tree: any, { data }: any) => {
+		const text = mdastToString(tree);
+		const words = countWords(text);
+		data.astro.frontmatter.words = words;
+		data.astro.frontmatter.minutes = Math.max(1, Math.round(words / 275));
+	};
+}
+
+/** 近似 mdast-util-to-string：递归取 text / inlineCode 的 value，忽略 html 与 image */
+function mdastToString(node: any): string {
+	if (!node) return "";
+	if (node.type === "text" || node.type === "inlineCode")
+		return node.value || "";
+	if (node.type === "html" || node.type === "image" || node.type === "code")
+		return "";
+	let out = "";
+	for (const child of node.children || []) out += mdastToString(child);
+	return out;
+}
+
+const CJK = /[\u4e00-\u9fff\u3040-\u30ff\uac00-\ud7af]/g;
+
+function countWords(text: string): number {
+	const cjk = (text.match(CJK) || []).length;
+	const rest = text.replace(CJK, " ");
+	const latin = rest.split(/\s+/).filter(Boolean).length;
+	return cjk + latin;
+}