vitepress-allyouneed 0.4.0 → 0.4.3

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.4.1] - 2026-05-21
+
+修 0.4.0 几个回归 + 小幅 UX 优化。
+
+### Fixed
+- **数字排序坑**:`1. Masse / 10. Energie / 11. Impuls / 2. Dichte / 3. ...` —— title 比较改成 `localeCompare(b, undefined, { numeric: true })`(natural sort)。现在 `1, 2, 3, ..., 10, 11` 按数值排,而不是字典序的 `1, 10, 11, 2, 3`。影响 `sidebarAuto.sortBy` 的 `'title'` 与 `'order-then-title'`(后者在 order 缺失时 fallback 到 title)。
+- **`autoFolderIndex` 警告刷屏**:dev 模式 `server.restart()` 会反复触发,加 module-level once-flag 只报一次;同时把 message 写得更可操作("delete this field from your .vitepress/config.ts")。
+
+### Added
+- **`markdown-it-mathjax3` 友好提示**:用户在 vitepress config 写 `markdown: { math: true }` 但没装 `markdown-it-mathjax3` 时,wrapper 自动报一条带安装命令的提示。包加为 optional peer dependency,装与不装都不阻塞。
+- **VaultGraph 视觉/性能**:节点默认无边框(更 Obsidian-like,hover/active 才描边)。大图(>200 节点)启用 `alphaDecay` 加速 + 每 N 帧才更新一次 DOM,显著降卡。500 节点可用,1000+ 建议拆 vault。
+
+### Docs
+- README 加 "当前版本 0.4.1" + 0.3.x → 0.4.x 升级速览。
+- DOCS.md 内 `v0.3.10` 提法统一改成 `v0.4.0`(autoFolderIndex 删除事件实际发布在 0.4.0)。
+
 ## [0.4.0] - 2026-05-21
 
 **0.x.0 = breaking-ish minor bump**(按 0.x SemVer 约定大改 → 二位号 bump)。

package/README.md

@@ -4,6 +4,19 @@
 
 Forked from [`actuallysomecat/markdown-it-wikilinks-plus`](https://github.com/actuallysomecat/markdown-it-wikilinks-plus) (MIT) 并针对 VitePress 大幅重写。
 
+## 当前版本:0.4.1(2026-05-21)
+
+**0.4.x 重要变更(从 0.3.x 升级看这里)**
+
+- **`sidebarAuto.autoFolderIndex` 已删除**。文件夹链接由 `sidebarAuto.folderLinkOrder`(默认 `['same-name', 'index', 'readme', 'first-file']`)在 sidebar/nav/wikilink 解析时直接处理,不再生成 `index.md` 文件。配置里还留着这个字段会在控制台 warn 一次,删掉就行。
+- **`folderLinkOrder`** 新增 — 自定义文件夹链接来源顺序;`[]` 表示文件夹不可点。
+- **数字排序修正(0.4.1)**:`1, 2, 10, 11` 真按数字大小排,不再字典序成 `1, 10, 11, 2`。
+- **`markdown.math: true`** 自动检测 — 没装 `markdown-it-mathjax3` 时给清晰提示,一行 `npm i -D markdown-it-mathjax3` 即可。
+- **dev HMR**:`.md` add/remove 或 `_sidebar.md` 改动自动 server restart,sidebar 立即刷新。
+- **leading-number 锚点**:`#13` 现在能匹 `## 13) Optik`、`13: ...`、`13, ...`、`13 — ...`。不匹 `13.5 Sub`(避免吃版本号)。
+
+完整 changelog 见 [`CHANGELOG.md`](./CHANGELOG.md);配置参考见 [`DOCS.md`](./DOCS.md)。
+
 ## 这个包做什么
 
 - 让 VitePress 直接把你的 **Obsidian vault 当作 srcDir 用**,你照常写笔记,剩下交给插件:

package/dist/index.cjs

@@ -3520,8 +3520,9 @@ function stripBase(url, base) {
   return "/" + url.slice(b.length);
 }
 function compareEntries(a, b, opts) {
+  const collateOpts = { numeric: true, sensitivity: "base" };
   if (opts.sortBy === "title") {
-    return opts.formatItemTitle(a).localeCompare(opts.formatItemTitle(b));
+    return opts.formatItemTitle(a).localeCompare(opts.formatItemTitle(b), void 0, collateOpts);
   }
   if (opts.sortBy === "mtime-desc") {
     return b.mtime - a.mtime;
@@ -3529,7 +3530,7 @@ function compareEntries(a, b, opts) {
   const oa = readOrder(a, opts.orderKey);
   const ob = readOrder(b, opts.orderKey);
   if (oa !== ob) return oa - ob;
-  return opts.formatItemTitle(a).localeCompare(opts.formatItemTitle(b));
+  return opts.formatItemTitle(a).localeCompare(opts.formatItemTitle(b), void 0, collateOpts);
 }
 function readOrder(entry, key) {
   const v = entry.frontmatter[key];
@@ -3864,6 +3865,23 @@ function resolveSimple(raw, index, options, currentSourceRel) {
 }
 
 // src/vitepress.ts
+var autoFolderIndexWarned = false;
+var mathHintShown = false;
+async function maybeHintMathPackage(config) {
+  if (mathHintShown) return;
+  const md = config.markdown;
+  const wantsMath = md?.math === true || md?.math !== null && !Array.isArray(md?.math) && typeof md?.math === "object";
+  if (!wantsMath) return;
+  mathHintShown = true;
+  const modName = "markdown-it-mathjax3";
+  try {
+    await import(modName);
+  } catch {
+    console.warn(
+      "[vitepress-allyouneed] `markdown.math: true` set but `markdown-it-mathjax3` is missing.\n  Install it once:  npm i -D markdown-it-mathjax3\n  (then no further setup \u2014 VitePress + this plugin will pick it up automatically.)"
+    );
+  }
+}
 function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
   const vpExclude = Array.isArray(config.srcExclude) ? config.srcExclude : [];
   const mergedOptions = {
@@ -3879,6 +3897,7 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
       ]
     }
   };
+  void maybeHintMathPackage(config);
   const vitePlugin = viteAllYouNeed(mergedOptions);
   const existingVite = typeof config.vite === "object" && config.vite !== null ? config.vite : {};
   const existingPlugins = Array.isArray(existingVite.plugins) ? existingVite.plugins : [];
@@ -3915,9 +3934,10 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
     const shouldFill = sidebarMode === "force" || !userProvided;
     if (shouldFill) {
       try {
-        if (sidebarAuto.autoFolderIndex !== void 0) {
+        if (sidebarAuto.autoFolderIndex !== void 0 && !autoFolderIndexWarned) {
+          autoFolderIndexWarned = true;
           console.warn(
-            "vitepress-allyouneed: `sidebarAuto.autoFolderIndex` was removed in v0.3.10. Folder URLs are now resolved via `folderLinkOrder` (default: same-name \u2192 index \u2192 README \u2192 first-file). Previously generated index.md files (with our sentinel) are safe to delete manually."
+            "[vitepress-allyouneed] `sidebarAuto.autoFolderIndex` was removed in v0.4.0. No-op now \u2014 please delete this field from your .vitepress/config.ts. Folder URLs are resolved via `folderLinkOrder` (default: same-name \u2192 index \u2192 README \u2192 first-file). Old index.md files with our sentinel can be deleted by hand."
           );
         }
         const materializeMode = sidebarAuto.materialize ?? "off";