vitepress-allyouneed 0.1.0 → 0.2.0-beta.0

package/dist/index.cjs

@@ -113,6 +113,7 @@ function resolveOptions(user = {}, ctx = {}) {
   const scanUser = user.scan ?? {};
   const assetsUser = user.assets ?? {};
   const modulesUser = user.modules ?? {};
+  const viewsUser = user.views ?? {};
   const wikilinksHtmlAttrs = wikilinksUser.htmlAttributes ?? {};
   const embedsHtmlAttrs = embedsUser.htmlAttributes ?? {};
   return {
@@ -151,9 +152,33 @@ function resolveOptions(user = {}, ctx = {}) {
       transclusionMaxDepth: embedsUser.transclusionMaxDepth ?? 8,
       htmlAttributes: embedsHtmlAttrs
     },
+    views: {
+      enabled: {
+        graph: viewsUser.enabled?.graph ?? true,
+        stats: viewsUser.enabled?.stats ?? true,
+        tags: viewsUser.enabled?.tags ?? true
+      },
+      urlPrefix: viewsUser.urlPrefix ?? "_perspectives_",
+      names: {
+        graph: viewsUser.names?.graph ?? "graph",
+        stats: viewsUser.names?.stats ?? "stats",
+        tags: viewsUser.names?.tags ?? "tags"
+      },
+      sidebar: viewsUser.sidebar ?? "auto",
+      sidebarText: {
+        group: viewsUser.sidebarText?.group ?? "Perspectives",
+        graph: viewsUser.sidebarText?.graph ?? "Graph",
+        stats: viewsUser.sidebarText?.stats ?? "Stats",
+        tags: viewsUser.sidebarText?.tags ?? "Tags"
+      },
+      graphMaxNodes: viewsUser.graphMaxNodes ?? 500,
+      dataFileName: viewsUser.dataFileName ?? "vault-data.json",
+      parseInlineTags: viewsUser.parseInlineTags ?? true
+    },
     modules: {
       wikilinks: modulesUser.wikilinks ?? true,
-      embeds: modulesUser.embeds ?? true
+      embeds: modulesUser.embeds ?? true,
+      views: modulesUser.views ?? true
     },
     slugify
   };
@@ -1005,11 +1030,10 @@ function renderTransclusionHtml(md, rawTarget, aliasParts, env) {
     inner = md.render(fragment, childEnv);
     cache.set(cacheKey, { html: inner });
   }
-  const sourceUrl = headingPart ? `${target.url}#${escapeHtml(options.slugify(headingPart))}` : target.url;
+  const sourceUrl = headingPart ? `${target.url}#${options.slugify(headingPart)}` : target.url;
   const aliasData = aliasParts.length ? ` data-caption="${escapeHtml(aliasParts.join("|"))}"` : "";
-  return `<div class="transclusion" data-source="${escapeHtml(
-    target.relativePath
-  )}" data-source-url="${escapeHtml(sourceUrl)}"${aliasData}>${inner}</div>`;
+  const sourceLink = `<a class="transclusion-source-link" href="${escapeHtml(sourceUrl)}" aria-label="Go to source: ${escapeHtml(target.relativePath)}" title="${escapeHtml(target.relativePath)}">\u2197</a>`;
+  return `<div class="transclusion" data-source="${escapeHtml(target.relativePath)}" data-source-url="${escapeHtml(sourceUrl)}"${aliasData}>` + sourceLink + inner + `</div>`;
 }
 function handleTransclusion(state, rawTarget, aliasParts, env) {
   if (env.options.deadLink !== "silent") {
@@ -1227,8 +1251,8 @@ function isResolved(o) {
 var markdown_it_default = allYouNeedMarkdownIt;
 
 // src/vite.ts
-var import_node_fs5 = __toESM(require("fs"), 1);
-var import_node_path6 = __toESM(require("path"), 1);
+var import_node_fs7 = __toESM(require("fs"), 1);
+var import_node_path8 = __toESM(require("path"), 1);
 
 // src/core/asset-pipeline/dev-middleware.ts
 var import_node_fs4 = __toESM(require("fs"), 1);
@@ -1298,6 +1322,235 @@ function guessMime(ext) {
   return MIME[ext.toLowerCase()] ?? "application/octet-stream";
 }
 
+// src/core/views/generate-md.ts
+var import_node_fs5 = __toESM(require("fs"), 1);
+var import_node_path6 = __toESM(require("path"), 1);
+var VIEW_SENTINEL = "<!-- generated by vitepress-allyouneed (do not edit; will be regenerated) -->";
+function generateViewMarkdown(options, index) {
+  const report = { written: [], skipped: [] };
+  if (!options.modules.views) return report;
+  const srcDir = import_node_path6.default.resolve(options.srcDir);
+  const prefix = options.views.urlPrefix;
+  const viewDir = prefix ? import_node_path6.default.join(srcDir, prefix) : srcDir;
+  if (prefix) {
+    try {
+      import_node_fs5.default.mkdirSync(viewDir, { recursive: true });
+    } catch {
+    }
+  }
+  const views = buildViewList(options);
+  for (const v of views) {
+    const target = import_node_path6.default.join(viewDir, v.fileName);
+    if (import_node_fs5.default.existsSync(target)) {
+      let existing;
+      try {
+        existing = import_node_fs5.default.readFileSync(target, "utf8");
+      } catch {
+        report.skipped.push({ path: target, reason: "\u6587\u4EF6\u4E0D\u53EF\u8BFB,\u8DF3\u8FC7" });
+        continue;
+      }
+      if (!existing.includes(VIEW_SENTINEL)) {
+        report.skipped.push({
+          path: target,
+          reason: `\u7528\u6237\u5DF2\u6709\u540C\u540D\u6587\u4EF6,\u4E0D\u8986\u76D6\u3002\u8981\u542F\u7528\u6B64\u89C6\u56FE\u8BF7:(a) \u5220\u9664\u8BE5\u6587\u4EF6 / (b) views.names.${v.kind} \u6539\u540D / (c) views.enabled.${v.kind}: false \u5173\u6389`
+        });
+        continue;
+      }
+    }
+    try {
+      import_node_fs5.default.writeFileSync(target, renderTemplate(v), "utf8");
+      report.written.push(target);
+      void index;
+    } catch (err) {
+      report.skipped.push({
+        path: target,
+        reason: `\u5199\u5165\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  return report;
+}
+function buildViewList(options) {
+  const { enabled, names, sidebarText, graphMaxNodes } = options.views;
+  const list = [];
+  if (enabled.graph) {
+    list.push({
+      kind: "graph",
+      fileName: `${names.graph}.md`,
+      title: sidebarText.graph,
+      // 把配置里的 graphMaxNodes 直接注入到组件 prop
+      component: `<VaultGraph :max-nodes="${graphMaxNodes}" />`
+    });
+  }
+  if (enabled.stats) {
+    list.push({
+      kind: "stats",
+      fileName: `${names.stats}.md`,
+      title: sidebarText.stats,
+      component: "<VaultStats />"
+    });
+  }
+  if (enabled.tags) {
+    list.push({
+      kind: "tags",
+      fileName: `${names.tags}.md`,
+      title: sidebarText.tags,
+      component: "<Tags />"
+    });
+  }
+  return list;
+}
+function renderTemplate(v) {
+  return [
+    "---",
+    `title: ${v.title}`,
+    "layout: doc",
+    "aside: false",
+    "outline: false",
+    "---",
+    "",
+    VIEW_SENTINEL,
+    "",
+    `# ${v.title}`,
+    "",
+    v.component,
+    ""
+  ].join("\n");
+}
+
+// src/core/views/generate-data.ts
+var import_node_fs6 = __toESM(require("fs"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
+var PLUGIN_VERSION = "0.2.0-beta.0";
+var WIKILINK_RE = /(!?)\[\[([^\]\n|#]+)(?:#[^\]\n|]*)?(?:\|[^\]\n]*)?\]\]/g;
+var BODY_TAG_RE = /(?:^|[\s([{,;。,;])#([\p{L}_][\p{L}\p{N}_/-]*)/gu;
+function buildVaultData(index, options) {
+  const nodes = [];
+  for (const f of index.files.values()) {
+    nodes.push({
+      id: f.relativePath,
+      title: pickTitle(f),
+      url: f.url,
+      tags: [...f.tags],
+      mtime: f.mtime
+    });
+  }
+  const edgeMap = /* @__PURE__ */ new Map();
+  for (const f of index.files.values()) {
+    const matches = f.content.matchAll(WIKILINK_RE);
+    for (const m of matches) {
+      const isEmbed = m[1] === "!";
+      const rawTarget = m[2].trim();
+      const target = resolveTargetSimple(rawTarget, index, options);
+      if (!target) continue;
+      if (target.relativePath === f.relativePath) continue;
+      const key = `${f.relativePath}\0${target.relativePath}`;
+      const existing = edgeMap.get(key);
+      if (existing && existing.type === "transclusion" && !isEmbed) continue;
+      edgeMap.set(key, {
+        source: f.relativePath,
+        target: target.relativePath,
+        type: isEmbed ? "transclusion" : "wikilink"
+      });
+    }
+  }
+  const edges = [...edgeMap.values()];
+  const tagsMap = /* @__PURE__ */ new Map();
+  for (const f of index.files.values()) {
+    const allTags = new Set(f.tags);
+    if (options.views.parseInlineTags) {
+      for (const tm of f.content.matchAll(BODY_TAG_RE)) {
+        allTags.add(tm[1]);
+      }
+    }
+    for (const tag of allTags) {
+      const arr = tagsMap.get(tag) ?? [];
+      arr.push(f);
+      tagsMap.set(tag, arr);
+    }
+  }
+  const allTagsByFile = /* @__PURE__ */ new Map();
+  for (const f of index.files.values()) {
+    const set = new Set(f.tags);
+    if (options.views.parseInlineTags) {
+      for (const tm of f.content.matchAll(BODY_TAG_RE)) set.add(tm[1]);
+    }
+    allTagsByFile.set(f.relativePath, [...set]);
+  }
+  const tags = {};
+  for (const [tag, files] of tagsMap) {
+    const sorted = [...files].sort((a, b) => b.mtime - a.mtime);
+    tags[tag] = {
+      count: files.length,
+      files: sorted.map((f) => ({
+        id: f.relativePath,
+        url: f.url,
+        title: pickTitle(f),
+        mtime: f.mtime,
+        path: f.relativePath,
+        otherTags: (allTagsByFile.get(f.relativePath) ?? []).filter(
+          (t) => t !== tag
+        )
+      }))
+    };
+  }
+  const mostRecent = [...index.files.values()].sort((a, b) => b.mtime - a.mtime).slice(0, 10).map((f) => ({
+    id: f.relativePath,
+    url: f.url,
+    title: pickTitle(f),
+    mtime: f.mtime
+  }));
+  return {
+    nodes,
+    edges,
+    tags,
+    stats: {
+      totalFiles: index.files.size,
+      totalAssets: index.assets.size,
+      totalWikilinks: edges.length,
+      totalTags: Object.keys(tags).length,
+      totalWarnings: index.warnings.length,
+      mostRecent
+    },
+    meta: { generatedAt: Date.now(), pluginVersion: PLUGIN_VERSION }
+  };
+}
+function writeVaultData(index, options) {
+  const data = buildVaultData(index, options);
+  const json = JSON.stringify(data);
+  const publicDir = import_node_path7.default.join(import_node_path7.default.resolve(options.srcDir), "public");
+  import_node_fs6.default.mkdirSync(publicDir, { recursive: true });
+  const out = import_node_path7.default.join(publicDir, options.views.dataFileName);
+  import_node_fs6.default.writeFileSync(out, json, "utf8");
+  return { path: out, bytes: json.length };
+}
+function pickTitle(f) {
+  const fm = f.frontmatter;
+  if (fm && typeof fm.title === "string" && fm.title.trim()) {
+    return fm.title.trim();
+  }
+  return f.basename;
+}
+function resolveTargetSimple(rawTarget, index, options) {
+  const target = stripMarkdownExt(toPosix(rawTarget));
+  if (!target) return void 0;
+  if (target.includes("/")) {
+    return index.byRelativePath.get(target) ?? index.byRelativePath.get(target + ".md") ?? index.byRelativePath.get(target + ".markdown");
+  }
+  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 candidates = map.get(
+    options.caseSensitive ? target : target.toLowerCase()
+  );
+  if (!candidates || candidates.length === 0) return void 0;
+  if (candidates.length === 1) return candidates[0];
+  return [...candidates].sort(
+    (a, b) => a.relativePath.split("/").length - b.relativePath.split("/").length
+  )[0];
+}
+
 // src/vite.ts
 function stripQueryAndHash(id) {
   return id.split("?")[0].split("#")[0];
@@ -1315,7 +1568,7 @@ function viteAllYouNeed(userOptions = {}) {
     config(_userViteConfig, _envCtx) {
       const srcDirOpt = userOptions.srcDir;
       if (!srcDirOpt) return void 0;
-      const abs = toPosix(import_node_path6.default.resolve(srcDirOpt));
+      const abs = toPosix(import_node_path8.default.resolve(srcDirOpt));
       return {
         server: {
           fs: {
@@ -1333,6 +1586,30 @@ function viteAllYouNeed(userOptions = {}) {
       });
       try {
         index = scanVault(resolved);
+        if (resolved.modules.views) {
+          const mdReport = generateViewMarkdown(resolved, index);
+          for (const written of mdReport.written) {
+            cfg.logger.info(`[vitepress-allyouneed] \u751F\u6210\u89C6\u56FE ${written}`);
+          }
+          for (const skipped of mdReport.skipped) {
+            cfg.logger.warn(
+              `[vitepress-allyouneed] \u8DF3\u8FC7 ${skipped.path}: ${skipped.reason}`
+            );
+          }
+          if (mdReport.written.length > 0) {
+            index = scanVault(resolved);
+          }
+          try {
+            const dataReport = writeVaultData(index, resolved);
+            cfg.logger.info(
+              `[vitepress-allyouneed] \u5199 ${dataReport.path} (${dataReport.bytes}B)`
+            );
+          } catch (err) {
+            cfg.logger.warn(
+              `[vitepress-allyouneed] vault-data.json \u5199\u5165\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`
+            );
+          }
+        }
         if (index.warnings.length > 0) {
           const top = index.warnings.slice(0, 10);
           for (const w of top) {
@@ -1361,15 +1638,21 @@ function viteAllYouNeed(userOptions = {}) {
     handleHotUpdate(ctx) {
       if (!index) return;
       try {
-        const stat = import_node_fs5.default.statSync(ctx.file);
+        const stat = import_node_fs7.default.statSync(ctx.file);
         if (stat.isFile()) {
           updateFile(index, ctx.file, resolved);
-        } else if (!import_node_fs5.default.existsSync(ctx.file)) {
+        } else if (!import_node_fs7.default.existsSync(ctx.file)) {
           removeFile(index, ctx.file, resolved);
         }
       } catch {
         removeFile(index, ctx.file, resolved);
       }
+      if (resolved.modules.views) {
+        try {
+          writeVaultData(index, resolved);
+        } catch {
+        }
+      }
     },
     /**
      * 拦截占位符 URL,**返回真实绝对文件路径**(POSIX 风格)。
@@ -1410,6 +1693,97 @@ function viteAllYouNeed(userOptions = {}) {
   return plugin;
 }
 
+// src/modules/tags/rule.ts
+var TAG_RE = /^#([\p{L}_][\p{L}\p{N}_/-]*)/u;
+function isValidPrecedingChar(c) {
+  if (c === void 0) return true;
+  if (/\s/.test(c)) return true;
+  if ("([{,;\u3002,;".includes(c)) return true;
+  return false;
+}
+function makeTagRule() {
+  return function tagRule(state, silent) {
+    const start = state.pos;
+    const src = state.src;
+    if (src.charCodeAt(start) !== 35) return false;
+    const prev = start === 0 ? void 0 : src[start - 1];
+    if (!isValidPrecedingChar(prev)) return false;
+    const slice = src.slice(start);
+    const m = TAG_RE.exec(slice);
+    if (!m) return false;
+    const tag = m[1];
+    if (silent) return true;
+    const env = state.env;
+    if (!env.referencedTags) env.referencedTags = /* @__PURE__ */ new Set();
+    env.referencedTags.add(tag);
+    const tagsViewName = env.options?.views?.names?.tags ?? "tags";
+    const urlPrefix = env.options?.views?.urlPrefix ?? "_perspectives_";
+    const base = env.options?.base ?? "/";
+    const prefixSeg = urlPrefix ? `${urlPrefix}/` : "";
+    const href = `${base}${prefixSeg}${tagsViewName}#${encodeURIComponent(tag)}`;
+    const html = `<a class="ayn-tag" data-tag="${escapeHtml(tag)}" href="${escapeHtml(href)}">#${escapeHtml(tag)}</a>`;
+    const token = state.push("html_inline", "", 0);
+    token.content = html;
+    state.pos = start + m[0].length;
+    return true;
+  };
+}
+function registerTagsInline(md) {
+  md.inline.ruler.before("link", "allyouneed_tags", makeTagRule());
+}
+
+// src/core/views/sidebar-inject.ts
+function injectViewsSidebar(sidebar, options) {
+  if (options.views.sidebar === false) return sidebar;
+  if (!options.modules.views) return sidebar;
+  const group = buildViewsGroup(options);
+  if (!group) return sidebar;
+  if (Array.isArray(sidebar)) {
+    if (!sidebar.some((it) => it.text === group.text)) sidebar.push(group);
+    return sidebar;
+  }
+  if (sidebar && typeof sidebar === "object") {
+    for (const path of Object.keys(sidebar)) {
+      const arr = sidebar[path];
+      if (Array.isArray(arr) && !arr.some((it) => it.text === group.text)) {
+        arr.push(group);
+      }
+    }
+    return sidebar;
+  }
+  return [group];
+}
+function buildViewsGroup(options) {
+  const { enabled, names, sidebarText, urlPrefix } = options.views;
+  const base = options.base.endsWith("/") ? options.base.slice(0, -1) : options.base;
+  const prefixSeg = urlPrefix ? `/${urlPrefix}` : "";
+  const items = [];
+  if (enabled.graph) {
+    items.push({
+      text: sidebarText.graph,
+      link: `${base}${prefixSeg}/${names.graph}`
+    });
+  }
+  if (enabled.stats) {
+    items.push({
+      text: sidebarText.stats,
+      link: `${base}${prefixSeg}/${names.stats}`
+    });
+  }
+  if (enabled.tags) {
+    items.push({
+      text: sidebarText.tags,
+      link: `${base}${prefixSeg}/${names.tags}`
+    });
+  }
+  if (items.length === 0) return null;
+  return {
+    text: sidebarText.group,
+    collapsed: true,
+    items
+  };
+}
+
 // src/vitepress.ts
 function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
   const vpExclude = Array.isArray(config.srcExclude) ? config.srcExclude : [];
@@ -1435,8 +1809,16 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
   };
   const existingMarkdown = config.markdown ?? {};
   const existingConfig = existingMarkdown.config;
+  const resolvedForWrapper = resolveOptions(mergedOptions, {
+    srcDir: mergedOptions.srcDir ?? config.srcDir,
+    base: mergedOptions.base ?? config.base,
+    cleanUrls: mergedOptions.cleanUrls ?? config.cleanUrls
+  });
   const newMarkdownConfig = (md) => {
     markdown_it_default(md, mergedOptions);
+    if (resolvedForWrapper.modules.views && resolvedForWrapper.views.parseInlineTags) {
+      registerTagsInline(md);
+    }
     md.core.ruler.before(
       "normalize",
       "allyouneed_env_inject",
@@ -1446,9 +1828,17 @@ function defineConfigWithAllYouNeed(config, pluginOptions = {}) {
       existingConfig(md);
     }
   };
+  const themeConfig = config.themeConfig ?? {};
+  if (resolvedForWrapper.modules.views) {
+    themeConfig.sidebar = injectViewsSidebar(
+      themeConfig.sidebar,
+      resolvedForWrapper
+    );
+  }
   return {
     ...config,
     vite: newVite,
+    themeConfig,
     markdown: {
       ...existingMarkdown,
       config: newMarkdownConfig