vitepress-allyouneed 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/);版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.3.3] - 2026-05-20
+
+### Added
+- **`sidebarAuto.foldersFirst`** — 控制同一层级内"普通文件 vs 子目录 group"的相对位置。
+  - `false`(默认)`files → virtualGroups → folders`(老行为,兼容)
+  - `true`           `folders → virtualGroups → files`(Finder / Obsidian 风格)
+  - 仅影响相对位置;段内排序仍由 `sortBy` / `orderKey` / `groupOrder` 决定。
+
+## [0.3.2] - 2026-05-20
+
+### Fixed
+- **根目录无 `index.md` 时 404**:`autoFolderIndex: 'top-level' / 'all'` 模式之前只为 srcDir **下**的目录生成 index,根本身被漏。现在 `dirsToProcess` 把 srcDir 根也加进去,根索引页用 `srcDir` basename 当 H1(fallback `Home`)。
+
 ## [0.3.1] - 2026-05-20
 
 ### Fixed

package/dist/index.cjs

@@ -2663,7 +2663,8 @@ function resolveSidebarAutoOptions(user = {}) {
     maxDepth: user.maxDepth,
     groupLink: user.groupLink ?? "all",
     includePrefix: user.includePrefix,
-    excludePrefixes: user.excludePrefixes ?? []
+    excludePrefixes: user.excludePrefixes ?? [],
+    foldersFirst: user.foldersFirst ?? false
   };
 }
 function defaultItemTitle(entry, strip) {
@@ -2787,7 +2788,6 @@ function renderNode(node, opts, depth, isRoot, index, options) {
     const override = parseSidebarOverride(node.sidebarOverride, index, options);
     if (override) return override;
   }
-  const out = [];
   const virtualGroups = /* @__PURE__ */ new Map();
   const normalFiles = [];
   for (const f of node.files) {
@@ -2801,18 +2801,21 @@ function renderNode(node, opts, depth, isRoot, index, options) {
     }
   }
   normalFiles.sort((a, b) => compareEntries(a, b, opts));
-  for (const f of normalFiles) {
-    out.push({ text: opts.formatItemTitle(f), link: f.url });
-  }
+  const fileItems = normalFiles.map((f) => ({
+    text: opts.formatItemTitle(f),
+    link: f.url
+  }));
   const virtualKeys = [...virtualGroups.keys()].sort();
+  const virtualItems = [];
   for (const name of virtualKeys) {
     const items = virtualGroups.get(name).sort((a, b) => compareEntries(a, b, opts));
-    out.push({
+    virtualItems.push({
       text: name,
       collapsed: opts.collapsed,
       items: items.map((f) => ({ text: opts.formatItemTitle(f), link: f.url }))
     });
   }
+  const folderItems = [];
   const childKeys = sortChildKeys(node, opts, isRoot);
   for (const key of childKeys) {
     const child = node.children.get(key);
@@ -2826,9 +2829,12 @@ function renderNode(node, opts, depth, isRoot, index, options) {
     if (child.dirIndex && !child.dirIndexEmpty && shouldLinkGroup(opts, isRoot)) {
       group.link = child.dirIndex.url;
     }
-    out.push(group);
+    folderItems.push(group);
   }
-  return out;
+  if (opts.foldersFirst) {
+    return [...folderItems, ...virtualItems, ...fileItems];
+  }
+  return [...fileItems, ...virtualItems, ...folderItems];
 }
 function findFirstPageUrl(node, opts) {
   if (node.dirIndex && !node.dirIndexEmpty) return node.dirIndex.url;
@@ -3103,10 +3109,9 @@ function generateFolderIndexes(options, folderOpts = {}) {
   const strip = folderOpts.stripNumericPrefix ?? true;
   const exclude = folderOpts.exclude ?? [];
   const template = folderOpts.template ?? defaultTemplate;
-  const dirsToProcess = collectDirs(srcDir, srcDir, viewsPrefix, exclude, mode);
+  const dirsToProcess = [srcDir, ...collectDirs(srcDir, srcDir, viewsPrefix, exclude, mode)];
   for (const dirAbs of dirsToProcess) {
     const dirRel = import_node_path9.default.relative(srcDir, dirAbs).split(import_node_path9.default.sep).join("/");
-    if (dirRel === "") continue;
     const entries = safeReaddir(dirAbs);
     if (entries.length === 0) continue;
     const dirName = import_node_path9.default.basename(dirAbs).toLowerCase();
@@ -3169,11 +3174,11 @@ function generateFolderIndexes(options, folderOpts = {}) {
     }
     files.sort((a, b) => a.title.localeCompare(b.title));
     subDirs.sort((a, b) => a.title.localeCompare(b.title));
-    const lastSeg = dirRel.split("/").pop() ?? "";
+    const lastSeg = dirRel === "" ? import_node_path9.default.basename(srcDir) : dirRel.split("/").pop() ?? "";
     const ctx = {
       dirAbsPath: dirAbs,
       dirRelPath: dirRel,
-      title: humanize2(lastSeg, strip),
+      title: humanize2(lastSeg, strip) || "Home",
       files,
       subDirs
     };