@tnotesjs/core 0.7.0 → 0.8.0

package/dist/vitepress/config/index.js

@@ -17,8 +17,8 @@ import {
 } from "../../chunk-GWG75A5M.js";
 
 // vitepress/config/index.ts
-import fs3 from "fs";
-import path5 from "path";
+import fs2 from "fs";
+import path4 from "path";
 import { defineConfig } from "vitepress";
 
 // vitepress/config/dependencyOptimization.ts
@@ -63,11 +63,9 @@ function getHeadConfig(config, githubPageUrl) {
 }
 
 // vitepress/configs/markdown.config.ts
-import fs from "fs";
 import markdownItContainer from "markdown-it-container";
 import mila from "markdown-it-link-attributes";
 import markdownItTaskLists from "markdown-it-task-lists";
-import path from "path";
 
 // vitepress/components/MindmapPreview/markdown.ts
 function cleanHeadingText(value) {
@@ -90,19 +88,6 @@ function parseMindmapFence(openLine) {
   }
   return options;
 }
-function parseMindmapReference(line) {
-  const match = line.trim().match(/^<<<\s+(.+?)\s*$/);
-  if (!match) return null;
-  let rest = match[1].trim();
-  let title;
-  const titleMatch = rest.match(/\s+\[([^\]]+)\]\s*$/);
-  if (titleMatch) {
-    title = cleanHeadingText(titleMatch[1]) || void 0;
-    rest = rest.slice(0, titleMatch.index).trim();
-  }
-  const path6 = rest.replace(/^(?:"([\s\S]*)"|'([\s\S]*)')$/, "$1$2").trim();
-  return path6 ? { path: path6, title } : null;
-}
 function normalizeMindmapMarkdown(source, options = {}) {
   const lines = source.replace(/\r\n?/g, "\n").split("\n");
   let existingTitle = "";
@@ -125,6 +110,79 @@ ${body.join("\n")}
 `;
 }
 
+// node_modules/.pnpm/@tnotesjs+ui@0.1.1_vue@3.5.31_typescript@5.9.3_/node_modules/@tnotesjs/ui/src/components/Footprints/parse.ts
+function parseFootprintsDatetime(meta) {
+  const m = meta.trim().match(
+    /^(\d{4})-(\d{1,2})-(\d{1,2})(?:\s+(\d{1,2}):(\d{1,2})(?::(\d{1,2}))?)?$/
+  );
+  if (!m) return [];
+  const parts = [Number(m[1]), Number(m[2]), Number(m[3])];
+  if (m[4] !== void 0) {
+    parts.push(Number(m[4]), Number(m[5]));
+    if (m[6] !== void 0) parts.push(Number(m[6]));
+  }
+  return parts;
+}
+function parseFootprintsSource(source) {
+  const normalized = source.replace(/\r\n?/g, "\n");
+  const lines = normalized.split("\n");
+  const open = lines[0]?.match(/^ {0,3}:{3,}\s*footprints(?:\s+(.*))?$/i);
+  const times = parseFootprintsDatetime((open?.[1] ?? "").trim());
+  let end = lines.length - 1;
+  while (end > 0 && !/^ {0,3}:{3,}\s*$/.test(lines[end])) end -= 1;
+  const bodyLines = lines.slice(1, end);
+  const paragraphs = [];
+  const images = [];
+  let otherInfo = "";
+  let buf = [];
+  let inOther = false;
+  const flush = () => {
+    const text = buf.join("\n").trim();
+    buf = [];
+    if (!text) return;
+    if (inOther) {
+      otherInfo = otherInfo ? `${otherInfo}
+${text}` : text;
+      return;
+    }
+    const imgOnly = text.match(/^!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)$/);
+    if (imgOnly) {
+      images.push(imgOnly[2]);
+      return;
+    }
+    const parts = text.split("\n");
+    let allImg = true;
+    const blockImgs = [];
+    for (const line of parts) {
+      const m = line.trim().match(/^!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)$/);
+      if (m) blockImgs.push(m[2]);
+      else if (line.trim()) {
+        allImg = false;
+        break;
+      }
+    }
+    if (allImg && blockImgs.length) {
+      images.push(...blockImgs);
+      return;
+    }
+    paragraphs.push(text);
+  };
+  for (const line of bodyLines) {
+    if (line.trim() === "---") {
+      flush();
+      inOther = true;
+      continue;
+    }
+    if (line.trim() === "") {
+      flush();
+      continue;
+    }
+    buf.push(line);
+  }
+  flush();
+  return { times, paragraphs, images, otherInfo };
+}
+
 // vitepress/configs/markdown.config.ts
 function esc(s = "") {
   return s.replace(
@@ -142,11 +200,14 @@ var simpleMermaidMarkdown = (md) => {
   const fence = md.renderer.rules.fence ? md.renderer.rules.fence.bind(md.renderer.rules) : () => "";
   md.renderer.rules.fence = (tokens, index, options, env, slf) => {
     const token = tokens[index];
-    if (token.info.trim() === "mermaid") {
+    const parts = token.info.trim().split(/\s+/).filter(Boolean);
+    if (parts[0] === "mermaid") {
       try {
+        const centered = parts.slice(1).some((part) => part.toLowerCase() === "center");
         const key = `mermaid-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
         const content = token.content;
-        return `<Mermaid id="${key}" graph="${encodeURIComponent(content)}" />`;
+        const centerAttr = centered ? ' :center="true"' : "";
+        return `<Mermaid id="${key}" graph="${encodeURIComponent(content)}"${centerAttr} />`;
       } catch (err) {
         return `<pre>${err}</pre>`;
       }
@@ -164,28 +225,14 @@ function configureMindmapFence(md) {
     const info = token.info.trim();
     const fenceOptions = parseMindmapFence(info);
     if (!fenceOptions) return fence(tokens, index, options, env, slf);
-    let content = token.content;
-    const firstNonEmptyLine = content.split("\n").find((line) => line.trim()) ?? "";
-    const reference = parseMindmapReference(firstNonEmptyLine);
-    if (reference) {
-      const possibleRel = env?.relativePath || env?.path || env?.filePath || env?.file || "";
-      const refFullPath = path.isAbsolute(reference.path) ? reference.path : path.resolve(process.cwd(), possibleRel ? path.dirname(possibleRel) : "", reference.path);
-      try {
-        content = fs.readFileSync(refFullPath, "utf8");
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        content = `- Failed to load referenced file: ${reference.path}
-  - Error: ${message}`;
-      }
-    }
-    content = normalizeMindmapMarkdown(content, {
-      title: fenceOptions.title || reference?.title
+    const content = normalizeMindmapMarkdown(token.content, {
+      title: fenceOptions.title
     });
     const props = [
       `content="${encodeURIComponent(content.trim())}"`,
       fenceOptions.initialExpandLevel === void 0 ? "" : `:initialExpandLevel="${fenceOptions.initialExpandLevel}"`
     ].filter(Boolean).join(" ");
-    return `<MindmapPreview ${props}></MindmapPreview>
+    return `<Mindmap ${props}></Mindmap>
 `;
   };
 }
@@ -247,6 +294,114 @@ function configureSwiperContainer(md) {
     }
   });
 }
+function escapeHtmlText(s) {
+  return s.replace(
+    /[&<>"']/g,
+    (ch) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[ch]
+  );
+}
+function extractFootprintsPayloadFromTokens(tokens, idx) {
+  const meta = String(tokens[idx].info || "").trim().replace(/^footprints\s*/i, "");
+  const times = parseFootprintsDatetime(meta);
+  const paragraphs = [];
+  const images = [];
+  let otherInfo = "";
+  let inOther = false;
+  for (let i = idx + 1; i < tokens.length; i++) {
+    const t = tokens[i];
+    if (t.type === "container_footprints_close") break;
+    if (t.type !== "inline") continue;
+    const childImgs = [];
+    if (Array.isArray(t.children)) {
+      for (const c of t.children) {
+        if (c.type === "image") {
+          const src = c.attrGet?.("src") || c.attrs?.find((a) => a[0] === "src")?.[1];
+          if (src) childImgs.push(src);
+        }
+      }
+    }
+    const content = String(t.content || "").trim();
+    if (content === "---") {
+      inOther = true;
+      continue;
+    }
+    if (childImgs.length) {
+      const withoutImgs = content.replace(/!\[[^\]]*\]\([^)]+\)/g, "").trim();
+      if (!withoutImgs) {
+        images.push(...childImgs);
+        continue;
+      }
+    }
+    const imgOnly = content.match(/^!\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)$/);
+    if (imgOnly) {
+      images.push(imgOnly[2]);
+      continue;
+    }
+    if (!content) continue;
+    if (inOther) otherInfo = otherInfo ? `${otherInfo}
+${content}` : content;
+    else paragraphs.push(content);
+  }
+  return { times, paragraphs, images, otherInfo };
+}
+function configureFootprintsContainer(md) {
+  md.use(markdownItContainer, "footprints", {
+    validate: (params) => /^footprints(\s|$)/i.test(params.trim()),
+    render: (tokens, idx, _opts, env) => {
+      if (tokens[idx].nesting !== 1) return "";
+      let payload = extractFootprintsPayloadFromTokens(tokens, idx);
+      const startLine = tokens[idx].map?.[0] ?? 0;
+      let endLine = startLine;
+      for (let i = idx + 1; i < tokens.length; i++) {
+        if (tokens[i].type === "container_footprints_close") {
+          endLine = tokens[i].map?.[0] ?? endLine;
+          break;
+        }
+      }
+      const raw = String(env?.src ?? env?.source ?? "");
+      if (raw && endLine > startLine) {
+        const slice = raw.split(/\r?\n/).slice(startLine, endLine + 1).join("\n");
+        const fromSource = parseFootprintsSource(
+          slice.includes(":::") ? slice : `::: ${tokens[idx].info}
+${slice}
+:::`
+        );
+        if (!payload.paragraphs.length && fromSource.paragraphs.length) {
+          payload = { ...payload, paragraphs: fromSource.paragraphs };
+        }
+        if (!payload.images.length && fromSource.images.length) {
+          payload = { ...payload, images: fromSource.images };
+        }
+        if (!payload.otherInfo && fromSource.otherInfo) {
+          payload = { ...payload, otherInfo: fromSource.otherInfo };
+        }
+        if (!payload.times.length && fromSource.times.length) {
+          payload = { ...payload, times: fromSource.times };
+        }
+      }
+      for (let i = idx + 1; i < tokens.length; i++) {
+        if (tokens[i].type === "container_footprints_close") break;
+        tokens[i].hidden = true;
+        tokens[i].content = "";
+        if (Array.isArray(tokens[i].children)) {
+          for (const child of tokens[i].children) {
+            child.hidden = true;
+            child.content = "";
+          }
+          tokens[i].children = [];
+        }
+      }
+      const enc = (value) => encodeURIComponent(JSON.stringify(value)).replace(/'/g, "%27");
+      const bindExpr = (value) => "JSON.parse(decodeURIComponent('" + enc(value) + "'))";
+      const imageSlot = payload.images.map((src, i) => {
+        return '<img src="' + escapeHtmlText(src) + '" @click="openModal(' + String(i) + ')" />';
+      }).join("\n");
+      const openTag = '<Footprints :times="' + bindExpr(payload.times) + '" :paragraphs="' + bindExpr(payload.paragraphs) + '" :other-info="' + bindExpr(payload.otherInfo) + '">';
+      if (!payload.images.length) return openTag + "</Footprints>\n";
+      return openTag + '\n<template #image-list="{ openModal }">\n' + imageSlot + "\n</template>\n</Footprints>\n";
+    }
+  });
+}
 function getMarkdownConfig() {
   const markdown = {
     lineNumbers: true,
@@ -266,6 +421,7 @@ function getMarkdownConfig() {
         }
       });
       configureSwiperContainer(md);
+      configureFootprintsContainer(md);
     },
     anchor: {
       slugify: generateAnchor
@@ -753,19 +909,19 @@ function getNoteByConfigIdPlugin() {
 }
 
 // vitepress/plugins/localSearchReindexPlugin.ts
-import path4 from "path";
+import path3 from "path";
 
 // vitepress/plugins/localSearchIndexBuilder.ts
 import MiniSearch from "minisearch";
-import fs2 from "fs/promises";
-import path3 from "path";
+import fs from "fs/promises";
+import path2 from "path";
 import {
   createMarkdownRenderer,
   resolvePages
 } from "vitepress";
 
 // vitepress/plugins/localSearchReindexLogic.ts
-import path2 from "path";
+import path from "path";
 function slash(value) {
   return value.replace(/\\/g, "/");
 }
@@ -781,13 +937,13 @@ function isNoteReadmePath(filePath, ignoreDirNames = []) {
 function getDocIdFromFile(input) {
   const pathApi = /^[a-zA-Z]:[\\/]/.test(
     input.absoluteOrRelativeFile || input.srcDir
-  ) ? path2.win32 : path2;
+  ) ? path.win32 : path;
   const absoluteFile = pathApi.isAbsolute(input.absoluteOrRelativeFile) ? input.absoluteOrRelativeFile : pathApi.join(input.srcDir, input.absoluteOrRelativeFile);
   let relFile = slash(pathApi.relative(input.srcDir, absoluteFile));
   if (input.rewrites?.[relFile]) {
     relFile = input.rewrites[relFile];
   }
-  let id = slash(path2.posix.join(input.base, relFile));
+  let id = slash(path.posix.join(input.base, relFile));
   id = id.replace(/(^|\/)index\.md$/, "$1");
   id = id.replace(/\.md$/, input.cleanUrls ? "" : ".html");
   return id;
@@ -852,9 +1008,9 @@ async function createLocalSearchMarkdownRenderer(siteConfig) {
   );
 }
 async function renderPageHtml(siteConfig, md, absoluteFile) {
-  if (!await fs2.stat(absoluteFile).catch(() => null)) return "";
+  if (!await fs.stat(absoluteFile).catch(() => null)) return "";
   const srcDir = siteConfig.srcDir;
-  const relativePath = slash2(path3.relative(srcDir, absoluteFile));
+  const relativePath = slash2(path2.relative(srcDir, absoluteFile));
   const env = {
     path: absoluteFile,
     relativePath,
@@ -862,7 +1018,7 @@ async function renderPageHtml(siteConfig, md, absoluteFile) {
     frontmatter: {}
   };
   const options = siteConfig.site.themeConfig?.search?.options ?? {};
-  const mdRaw = await fs2.readFile(absoluteFile, "utf-8");
+  const mdRaw = await fs.readFile(absoluteFile, "utf-8");
   if (options._render) {
     return await options._render(mdRaw, env, md);
   }
@@ -870,7 +1026,7 @@ async function renderPageHtml(siteConfig, md, absoluteFile) {
   return env.frontmatter?.search === false ? "" : html;
 }
 async function indexPage(siteConfig, md, page, index) {
-  const absoluteFile = path3.join(siteConfig.srcDir, page);
+  const absoluteFile = path2.join(siteConfig.srcDir, page);
   const fileId = getDocIdFromFile({
     srcDir: siteConfig.srcDir,
     base: siteConfig.site.base,
@@ -1160,7 +1316,7 @@ function localSearchReindexPlugin() {
         const onWatcherEvent = (absoluteFile, event) => {
           if (!isNoteReadmePath(absoluteFile, ignoreDirNames)) return;
           scheduleNoteSearchReindex(
-            `watcher:${event}:${path4.basename(absoluteFile)}`
+            `watcher:${event}:${path3.basename(absoluteFile)}`
           );
         };
         server.watcher.on("add", (file) => onWatcherEvent(file, "add"));
@@ -1314,14 +1470,14 @@ function isNoteInSubtree(snapshot, lineIndex, noteIndex) {
 }
 function folderPathAtLine(snapshot, lineIndex) {
   const result = [];
-  const walk = (nodes, path6) => {
+  const walk = (nodes, path5) => {
     for (const node of nodes) {
       if (node.kind === "folder") {
         if (node.tocLineIndex === lineIndex) {
-          result.push(...[...path6, node.title]);
+          result.push(...[...path5, node.title]);
           return true;
         }
-        if (walk(node.children, [...path6, node.title])) return true;
+        if (walk(node.children, [...path5, node.title])) return true;
       }
     }
     return false;
@@ -1712,9 +1868,9 @@ function defineNotesConfig(overrides = {}) {
     },
     transformPageData(pageData, ctx) {
       if (/^notes\/\d{4}/.test(pageData.relativePath)) {
-        const fullPath = path5.resolve(rootPath, pageData.relativePath);
+        const fullPath = path4.resolve(rootPath, pageData.relativePath);
         try {
-          const raw = fs3.readFileSync(fullPath, "utf-8");
+          const raw = fs2.readFileSync(fullPath, "utf-8");
           pageData.frontmatter.rawContent = Buffer.from(raw, "utf-8").toString(
             "base64"
           );

package/markdown/components.ts

@@ -0,0 +1,86 @@
+export type TNotesComponentKind =
+  | 'block-component'
+  | 'inline-component'
+  | 'container'
+  | 'fenced-language'
+
+export interface TNotesComponentDescriptor {
+  name: string
+  aliases?: string[]
+  kind: TNotesComponentKind
+  editable: 'visual' | 'source-only' | 'placeholder'
+}
+
+/**
+ * Runtime-neutral registry shared by Desk and other TNotes clients. It does not
+ * import Vue or VitePress and is therefore safe in Node/Electron workers.
+ */
+export const TNOTES_COMPONENTS: readonly TNotesComponentDescriptor[] = [
+  {
+    name: 'BilibiliVideo',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'WordList',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Footprints',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'NotesTable',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Tooltip',
+    kind: 'inline-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Mindmap',
+    aliases: ['MindmapPreview'],
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Mermaid',
+    kind: 'block-component',
+    editable: 'visual',
+  },
+  {
+    name: 'Discussions',
+    kind: 'block-component',
+    editable: 'placeholder',
+  },
+  {
+    name: 'SidebarCard',
+    kind: 'block-component',
+    editable: 'placeholder',
+  },
+  { name: 'swiper', kind: 'container', editable: 'visual' },
+  { name: 'code-group', kind: 'container', editable: 'visual' },
+  { name: 'footprints', kind: 'container', editable: 'visual' },
+  { name: 'details', kind: 'container', editable: 'visual' },
+  { name: 'info', kind: 'container', editable: 'visual' },
+  { name: 'tip', kind: 'container', editable: 'visual' },
+  { name: 'warning', kind: 'container', editable: 'visual' },
+  { name: 'danger', kind: 'container', editable: 'visual' },
+  { name: 'mermaid', kind: 'fenced-language', editable: 'visual' },
+  { name: 'mindmap', kind: 'fenced-language', editable: 'visual' },
+] as const
+
+export function findTNotesComponent(
+  name: string,
+): TNotesComponentDescriptor | undefined {
+  const normalized = name.toLowerCase()
+  return TNOTES_COMPONENTS.find(
+    (component) =>
+      component.name.toLowerCase() === normalized ||
+      component.aliases?.some((alias) => alias.toLowerCase() === normalized),
+  )
+}

package/markdown/index.ts

@@ -0,0 +1,17 @@
+export {
+  NOTE_TOC_END_TAG,
+  NOTE_TOC_START_TAG,
+  formatTNotesNote,
+} from './noteFormatter'
+export type {
+  FormatTNotesNoteInput,
+  FormatTNotesNoteResult,
+} from './noteFormatter'
+export {
+  TNOTES_COMPONENTS,
+  findTNotesComponent,
+} from './components'
+export type {
+  TNotesComponentDescriptor,
+  TNotesComponentKind,
+} from './components'

package/markdown/noteFormatter.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+  findTNotesComponent,
+  formatTNotesNote,
+  TNOTES_COMPONENTS,
+} from './index'
+
+describe('TNotes Markdown contract', () => {
+  it('exposes runtime-neutral component descriptors', () => {
+    expect(findTNotesComponent('NotesTable')?.name).toBe('NotesTable')
+    expect(findTNotesComponent('WordList')?.name).toBe('WordList')
+    expect(findTNotesComponent('BilibiliVideo')?.name).toBe('BilibiliVideo')
+    expect(findTNotesComponent('N')).toBeUndefined()
+    expect(findTNotesComponent('SWIPER')?.kind).toBe('container')
+    expect(findTNotesComponent('Mermaid')?.editable).toBe('visual')
+    expect(TNOTES_COMPONENTS.some((item) => item.name === 'markmap')).toBe(false)
+    expect(TNOTES_COMPONENTS.some((item) => item.name === 'mindmap')).toBe(true)
+  })
+
+  it('restores missing generated markers without interpreting fenced headings', async () => {
+    const result = await formatTNotesNote({
+      content: '## Heading\n\n~~~md\n### source\n~~~\n',
+      noteIndex: '0042',
+      title: 'Answer',
+      repoOwner: 'tnotesjs',
+      repoName: 'TNotes.fixture',
+      noteConfig: {
+        id: 'answer',
+        bilibili: [],
+        tnotes: [],
+        yuque: [],
+        done: false,
+        enableDiscussions: false,
+      },
+      prettier: false,
+    })
+
+    expect(result.content).toContain('<!-- region:toc -->')
+    expect(result.content).toContain('<!-- endregion:toc -->')
+    expect(result.generatedToc).toEqual(['- [1. Heading](#1-heading)'])
+    expect(result.content).toContain('~~~md\n### source\n~~~')
+  })
+})