vitepress-allyouneed 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -2,9 +2,19 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+
+## [Unreleased]
+
+## [0.5.5] - 2026-06-20
+
 ## [Unreleased]
 
+### Added
+- **目录可由 dirIndex 排序**:`index.md`、`README.md` 或同名目录页现在是该文件夹 group 的排序锚点。默认 `sortBy: 'order-then-title'` 下,给目录页写 `order: 1` 即可控制目录位置;嵌套目录、`per-folder` 根侧栏和 `autoNav` 均一致生效,无需给文件夹名添加数字前缀。顶级 `groupOrder` 仍具有最高优先级。
+
 ### Fixed
+- **嵌套 `index.md` 生成错误的无尾斜杠 URL**:`cleanUrls: true` 下目录页现在输出 `/guide/` 而不是 `/guide`;与 VitePress 的 `guide/index.html` 路由及 dead-link validator 保持一致。
+- **`scanWikilinks` 把合法 `[[folder/]]` 误报为死链**:启动预扫不再维护遗漏 `folderLinkOrder` 的简化解析器,改为与渲染阶段共用 `resolveWikilink`;目录 index、相对路径、自引用锚点和冲突策略现在只有一套解析语义。
 - **同名页面跨 locale / 区域解析错误**:`[[Gravitationsphysik]]` 这类 basename-only Wikilink 不再直接使用全局 `onConflict`。解析器现在先按源页面的同目录和最长共同路径前缀收窄候选(例如 `zh/themen/*` 优先于 `zh/selfcheck/*`,二者都优先于其它 locale),仍有歧义时才执行 `shortest` / `first` / `error`。
 - 强化当前源页面定位:relativePath 精确匹配先于后缀兜底,且后缀存在多个 locale 命中时不再取扫描顺序中的第一个。
 

package/dist/index.cjs

@@ -594,7 +594,8 @@ function computeUrl(rel, options) {
   } else if (!options.cleanUrls) {
     segments.push("index.html");
   }
-  return buildUrl("/", segments);
+  const url = buildUrl("/", segments);
+  return isIndex && options.cleanUrls ? url + "/" : url;
 }
 function pushToArrayMap(m, k, v) {
   const arr = m.get(k);
@@ -2401,7 +2402,7 @@ function renderTemplate(v) {
 // src/core/views/generate-data.ts
 var import_node_fs6 = __toESM(require("fs"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
-var PLUGIN_VERSION = true ? "0.5.4" : "0.0.0-dev";
+var PLUGIN_VERSION = true ? "0.5.5" : "0.0.0-dev";
 var WIKILINK_RE = /(!?)\[\[([^\]\n]+)\]\]/g;
 var DEFAULT_BODY_TAG_RE = /(?:^|[\s([{,;。,;])#([\p{L}_][\p{L}\p{N}_/-]*)/gu;
 function buildBodyTagRe(userPattern) {
@@ -3453,8 +3454,27 @@ function shouldLinkGroup(opts, isTopLevel) {
 }
 function sortChildKeys(node, opts, isTopLevel) {
   const keys = [...node.children.keys()];
+  const collateOpts = { numeric: true, sensitivity: "base" };
+  const compareFolderKeys = (a, b) => {
+    const aNode = node.children.get(a);
+    const bNode = node.children.get(b);
+    const aAnchor = pickTitleSourceCandidate(aNode);
+    const bAnchor = pickTitleSourceCandidate(bNode);
+    if (opts.sortBy === "mtime-desc") {
+      const am = aAnchor?.mtime ?? Number.NEGATIVE_INFINITY;
+      const bm = bAnchor?.mtime ?? Number.NEGATIVE_INFINITY;
+      if (am !== bm) return bm - am;
+    } else if (opts.sortBy === "order-then-title") {
+      const ao = aAnchor ? readOrder(aAnchor, opts.orderKey) : Number.POSITIVE_INFINITY;
+      const bo = bAnchor ? readOrder(bAnchor, opts.orderKey) : Number.POSITIVE_INFINITY;
+      if (ao !== bo) return ao - bo;
+    }
+    const at = computeGroupText(aNode.path, aAnchor, opts);
+    const bt = computeGroupText(bNode.path, bAnchor, opts);
+    return at.localeCompare(bt, void 0, collateOpts);
+  };
   if (!isTopLevel || opts.groupOrder.length === 0) {
-    return keys.sort();
+    return keys.sort(compareFolderKeys);
   }
   const orderMap = /* @__PURE__ */ new Map();
   opts.groupOrder.forEach((name, i) => {
@@ -3490,7 +3510,7 @@ function sortChildKeys(node, opts, isTopLevel) {
     const ob = orderMap.has(b) ? orderMap.get(b) : orderMap.get(tb);
     return oa - ob;
   });
-  rest.sort();
+  rest.sort(compareFolderKeys);
   return [...indexed, ...rest];
 }
 function toFlatSidebar(root, opts) {
@@ -3540,7 +3560,12 @@ function toPerFolderSidebar(root, opts, options, index) {
   for (const f of sortedRootFiles) {
     rootItems.push({ text: opts.formatItemTitle(f), link: f.url });
   }
-  const topKeys = [...root.children.keys()].sort();
+  const topKeys = sortChildKeys(
+    root,
+    opts,
+    /* isTopLevel */
+    true
+  );
   for (const key of topKeys) {
     const child = root.children.get(key);
     const childWinner = resolveFolderLink(
@@ -3617,7 +3642,12 @@ function generateNav(index, options, autoOptions = {}) {
   const root = buildTree2(visible);
   const base = options.base.endsWith("/") ? options.base : options.base + "/";
   const out = [{ text: opts.homeNavText, link: "/" }];
-  const topKeys = [...root.children.keys()].sort();
+  const topKeys = sortChildKeys(
+    root,
+    opts,
+    /* isTopLevel */
+    true
+  );
   for (const key of topKeys) {
     const child = root.children.get(key);
     const winner = resolveFolderLink(
@@ -3909,9 +3939,14 @@ function scanWikilinks(index, options) {
           if (isAsset) continue;
         }
       }
-      const isSelfAnchor = !rawTarget && !!headingPart;
-      const found = isSelfAnchor || resolveSimple(rawTarget, index, options, f.relativePath);
-      if (!found) {
+      const resolved = resolveWikilink(
+        rawTargetFull,
+        index,
+        options,
+        isEmbed ? "transclusion" : "page",
+        f.absolutePath
+      );
+      if (resolved.isDead) {
         dead.push({
           source: f.relativePath,
           target: rawTarget,
@@ -3920,7 +3955,7 @@ function scanWikilinks(index, options) {
         continue;
       }
       if (scanAmbig && headingPart) {
-        const targetEntry = isSelfAnchor ? f : resolveSimpleEntry(rawTarget, index, options, f.relativePath);
+        const targetEntry = resolved.target;
         if (!targetEntry) continue;
         const matches2 = findAmbiguousLeadingNumberMatches(targetEntry, headingPart);
         if (matches2.length > 1) {
@@ -3942,27 +3977,6 @@ function scanWikilinks(index, options) {
   }
   return { total, dead, ambiguous };
 }
-function resolveSimpleEntry(raw, index, options, currentSourceRel) {
-  const target = stripMarkdownExt(toPosix(raw));
-  if (!target) return void 0;
-  if (target.includes("/")) {
-    const e = index.byRelativePath.get(target) ?? index.byRelativePath.get(target + ".md") ?? index.byRelativePath.get(target + ".markdown");
-    if (e) return e;
-    if (currentSourceRel) {
-      const curDir = currentSourceRel.split("/").slice(0, -1).join("/");
-      if (curDir) {
-        return index.byRelativePath.get(`${curDir}/${target}`) ?? index.byRelativePath.get(`${curDir}/${target}.md`) ?? index.byRelativePath.get(`${curDir}/${target}.markdown`);
-      }
-    }
-    return void 0;
-  }
-  const aliasKey = options.caseSensitive ? target : target.toLowerCase();
-  const aliased = index.byAlias.get(aliasKey);
-  if (aliased) return aliased;
-  const map = options.caseSensitive ? index.byBasename : index.byBasenameLower;
-  const key = options.caseSensitive ? target : target.toLowerCase();
-  return map.get(key)?.[0];
-}
 function logDeadLinks(report, deadLink) {
   if (deadLink === "silent") return;
   if (report.dead.length > 0) {
@@ -4011,27 +4025,6 @@ function extractExt3(target) {
   if (dot <= 0) return "";
   return cleaned.slice(dot + 1).toLowerCase();
 }
-function resolveSimple(raw, index, options, currentSourceRel) {
-  const target = stripMarkdownExt(toPosix(raw));
-  if (!target) return false;
-  if (target.includes("/")) {
-    if (index.byRelativePath.has(target) || index.byRelativePath.has(target + ".md") || index.byRelativePath.has(target + ".markdown")) {
-      return true;
-    }
-    if (currentSourceRel) {
-      const curDir = currentSourceRel.split("/").slice(0, -1).join("/");
-      if (curDir) {
-        return index.byRelativePath.has(`${curDir}/${target}`) || index.byRelativePath.has(`${curDir}/${target}.md`) || index.byRelativePath.has(`${curDir}/${target}.markdown`);
-      }
-    }
-    return false;
-  }
-  const aliasKey = options.caseSensitive ? target : target.toLowerCase();
-  if (index.byAlias.has(aliasKey)) return true;
-  const map = options.caseSensitive ? index.byBasename : index.byBasenameLower;
-  const key = options.caseSensitive ? target : target.toLowerCase();
-  return (map.get(key)?.length ?? 0) > 0;
-}
 
 // src/vitepress.ts
 var autoFolderIndexWarned = false;