@wsxjs/wsx-press 0.0.25 → 0.0.27

package/dist/node.js

@@ -119,10 +119,10 @@ async function Pe(a) {
       publicPath: l
     });
     o.options.addReader(new Ae()), o.options.addReader(new Ie());
-    const p = await o.convert();
-    if (!p)
+    const h = await o.convert();
+    if (!h)
       throw new Error("Failed to convert TypeScript project");
-    await o.generateDocs(p, t);
+    await o.generateDocs(h, t);
   } catch (o) {
     throw new Error(
       `Failed to generate API documentation: ${o instanceof Error ? o.message : String(o)}`
@@ -144,7 +144,7 @@ function J() {
   };
 }
 let A = J();
-function pe(a) {
+function he(a) {
   A = a;
 }
 const ue = /[&<>"']/, ve = new RegExp(ue.source, "g"), fe = /[<>"']|&(?!(#\d{1,7}|#[Xx][a-fA-F0-9]{1,6}|\w+);)/, Oe = new RegExp(fe.source, "g"), Le = {
@@ -190,8 +190,8 @@ function oe(a) {
 const E = { exec: () => null };
 function le(a, n) {
   const e = a.replace(/\|/g, (r, s, l) => {
-    let o = !1, p = s;
-    for (; --p >= 0 && l[p] === "\\"; )
+    let o = !1, h = s;
+    for (; --h >= 0 && l[h] === "\\"; )
       o = !o;
     return o ? "|" : " |";
   }), t = e.split(/ \|/);
@@ -364,39 +364,39 @@ class N {
       };
       t = i ? `\\d{1,9}\\${t.slice(-1)}` : `\\${t}`, this.options.pedantic && (t = i ? t : "[*+-]");
       const s = new RegExp(`^( {0,3}${t})((?:[	 ][^\\n]*)?(?:\\n|$))`);
-      let l = "", o = "", p = !1;
+      let l = "", o = "", h = !1;
       for (; n; ) {
         let c = !1;
         if (!(e = s.exec(n)) || this.rules.block.hr.test(n))
           break;
         l = e[0], n = n.substring(l.length);
         let u = e[2].split(`
-`, 1)[0].replace(/^\t+/, (M) => " ".repeat(3 * M.length)), h = n.split(`
+`, 1)[0].replace(/^\t+/, (M) => " ".repeat(3 * M.length)), p = n.split(`
 `, 1)[0], f = 0;
         this.options.pedantic ? (f = 2, o = u.trimStart()) : (f = e[2].search(/[^ ]/), f = f > 4 ? 1 : f, o = u.slice(f), f += e[1].length);
         let w = !1;
-        if (!u && /^ *$/.test(h) && (l += h + `
-`, n = n.substring(h.length + 1), c = !0), !c) {
+        if (!u && /^ *$/.test(p) && (l += p + `
+`, n = n.substring(p.length + 1), c = !0), !c) {
           const M = new RegExp(`^ {0,${Math.min(3, f - 1)}}(?:[*+-]|\\d{1,9}[.)])((?:[ 	][^\\n]*)?(?:\\n|$))`), Y = new RegExp(`^ {0,${Math.min(3, f - 1)}}((?:- *){3,}|(?:_ *){3,}|(?:\\* *){3,})(?:\\n+|$)`), ee = new RegExp(`^ {0,${Math.min(3, f - 1)}}(?:\`\`\`|~~~)`), te = new RegExp(`^ {0,${Math.min(3, f - 1)}}#`);
           for (; n; ) {
             const F = n.split(`
 `, 1)[0];
-            if (h = F, this.options.pedantic && (h = h.replace(/^ {1,4}(?=( {4})*[^ ])/g, "  ")), ee.test(h) || te.test(h) || M.test(h) || Y.test(n))
+            if (p = F, this.options.pedantic && (p = p.replace(/^ {1,4}(?=( {4})*[^ ])/g, "  ")), ee.test(p) || te.test(p) || M.test(p) || Y.test(n))
               break;
-            if (h.search(/[^ ]/) >= f || !h.trim())
+            if (p.search(/[^ ]/) >= f || !p.trim())
               o += `
-` + h.slice(f);
+` + p.slice(f);
             else {
               if (w || u.search(/[^ ]/) >= 4 || ee.test(u) || te.test(u) || Y.test(u))
                 break;
               o += `
-` + h;
+` + p;
             }
-            !w && !h.trim() && (w = !0), l += F + `
-`, n = n.substring(F.length + 1), u = h.slice(f);
+            !w && !p.trim() && (w = !0), l += F + `
+`, n = n.substring(F.length + 1), u = p.slice(f);
           }
         }
-        r.loose || (p ? r.loose = !0 : /\n *\n *$/.test(l) && (p = !0));
+        r.loose || (h ? r.loose = !0 : /\n *\n *$/.test(l) && (h = !0));
         let y = null, R;
         this.options.gfm && (y = /^\[[ xX]\] /.exec(o), y && (R = y[0] !== "[ ] ", o = o.replace(/^\[[ xX]\] +/, ""))), r.items.push({
           type: "list_item",
@@ -411,8 +411,8 @@ class N {
       r.items[r.items.length - 1].raw = l.trimEnd(), r.items[r.items.length - 1].text = o.trimEnd(), r.raw = r.raw.trimEnd();
       for (let c = 0; c < r.items.length; c++)
         if (this.lexer.state.top = !1, r.items[c].tokens = this.lexer.blockTokens(r.items[c].text, []), !r.loose) {
-          const u = r.items[c].tokens.filter((f) => f.type === "space"), h = u.length > 0 && u.some((f) => /\n.*\n/.test(f.raw));
-          r.loose = h;
+          const u = r.items[c].tokens.filter((f) => f.type === "space"), p = u.length > 0 && u.some((f) => /\n.*\n/.test(f.raw));
+          r.loose = p;
         }
       if (r.loose)
         for (let c = 0; c < r.items.length; c++)
@@ -577,22 +577,22 @@ class N {
       return;
     if (!(i[1] || i[2] || "") || !t || this.rules.inline.punctuation.exec(t)) {
       const s = [...i[0]].length - 1;
-      let l, o, p = s, c = 0;
+      let l, o, h = s, c = 0;
       const u = i[0][0] === "*" ? this.rules.inline.emStrongRDelimAst : this.rules.inline.emStrongRDelimUnd;
       for (u.lastIndex = 0, e = e.slice(-1 * n.length + s); (i = u.exec(e)) != null; ) {
         if (l = i[1] || i[2] || i[3] || i[4] || i[5] || i[6], !l)
           continue;
         if (o = [...l].length, i[3] || i[4]) {
-          p += o;
+          h += o;
           continue;
         } else if ((i[5] || i[6]) && s % 3 && !((s + o) % 3)) {
           c += o;
           continue;
         }
-        if (p -= o, p > 0)
+        if (h -= o, h > 0)
           continue;
-        o = Math.min(o, o + p + c);
-        const h = [...i[0]][0].length, f = n.slice(0, s + i.index + h + o);
+        o = Math.min(o, o + h + c);
+        const p = [...i[0]][0].length, f = n.slice(0, s + i.index + p + o);
         if (Math.min(s, o) % 2) {
           const y = f.slice(1, -1);
           return {
@@ -730,7 +730,7 @@ const Me = /^(?: *(?:\n|$))+/, Fe = /^( {4}[^\n]+(?:\n(?: *(?:\n|$))*)?)+/, Qe =
   lheading: /^(.+?)\n {0,3}(=+|-+) *(?:\n+|$)/,
   paragraph: d(W).replace("hr", j).replace("heading", ` *#{1,6} *[^
 ]`).replace("lheading", de).replace("|table", "").replace("blockquote", " {0,3}>").replace("|fences", "").replace("|list", "").replace("|html", "").replace("|tag", "").getRegex()
-}, xe = /^\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/, Ye = /^(`+)([^`]|[^`][\s\S]*?[^`])\1(?!`)/, me = /^( {2,}|\\)\n(?!\s*$)/, et = /^(`+|[^`])(?:(?= {2,}\n)|[\s\S]*?(?:(?=[\\<!\[`*_]|\b_|$)|[^ ](?= {2,}\n)))/, P = "\\p{P}\\p{S}", tt = d(/^((?![*_])[\spunctuation])/, "u").replace(/punctuation/g, P).getRegex(), nt = /\[[^[\]]*?\]\([^\(\)]*?\)|`[^`]*?`|<[^<>]*?>/g, st = d(/^(?:\*+(?:((?!\*)[punct])|[^\s*]))|^_+(?:((?!_)[punct])|([^\s_]))/, "u").replace(/punct/g, P).getRegex(), it = d("^[^_*]*?__[^_*]*?\\*[^_*]*?(?=__)|[^*]+(?=[^*])|(?!\\*)[punct](\\*+)(?=[\\s]|$)|[^punct\\s](\\*+)(?!\\*)(?=[punct\\s]|$)|(?!\\*)[punct\\s](\\*+)(?=[^punct\\s])|[\\s](\\*+)(?!\\*)(?=[punct])|(?!\\*)[punct](\\*+)(?!\\*)(?=[punct])|[^punct\\s](\\*+)(?=[^punct\\s])", "gu").replace(/punct/g, P).getRegex(), rt = d("^[^_*]*?\\*\\*[^_*]*?_[^_*]*?(?=\\*\\*)|[^_]+(?=[^_])|(?!_)[punct](_+)(?=[\\s]|$)|[^punct\\s](_+)(?!_)(?=[punct\\s]|$)|(?!_)[punct\\s](_+)(?=[^punct\\s])|[\\s](_+)(?!_)(?=[punct])|(?!_)[punct](_+)(?!_)(?=[punct])", "gu").replace(/punct/g, P).getRegex(), ot = d(/\\([punct])/, "gu").replace(/punct/g, P).getRegex(), lt = d(/^<(scheme:[^\s\x00-\x1f<>]*|email)>/).replace("scheme", /[a-zA-Z][a-zA-Z0-9+.-]{1,31}/).replace("email", /[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/).getRegex(), at = d(U).replace("(?:-->|$)", "-->").getRegex(), ct = d("^comment|^</[a-zA-Z][\\w:-]*\\s*>|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^<![a-zA-Z]+\\s[\\s\\S]*?>|^<!\\[CDATA\\[[\\s\\S]*?\\]\\]>").replace("comment", at).replace("attribute", /\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/).getRegex(), Z = /(?:\[(?:\\.|[^\[\]\\])*\]|\\.|`[^`]*`|[^\[\]\\`])*?/, ht = d(/^!?\[(label)\]\(\s*(href)(?:\s+(title))?\s*\)/).replace("label", Z).replace("href", /<(?:\\.|[^\n<>\\])+>|[^\s\x00-\x1f]*/).replace("title", /"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/).getRegex(), we = d(/^!?\[(label)\]\[(ref)\]/).replace("label", Z).replace("ref", G).getRegex(), be = d(/^!?\[(ref)\](?:\[\])?/).replace("ref", G).getRegex(), pt = d("reflink|nolink(?!\\()", "g").replace("reflink", we).replace("nolink", be).getRegex(), V = {
+}, xe = /^\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/, Ye = /^(`+)([^`]|[^`][\s\S]*?[^`])\1(?!`)/, me = /^( {2,}|\\)\n(?!\s*$)/, et = /^(`+|[^`])(?:(?= {2,}\n)|[\s\S]*?(?:(?=[\\<!\[`*_]|\b_|$)|[^ ](?= {2,}\n)))/, P = "\\p{P}\\p{S}", tt = d(/^((?![*_])[\spunctuation])/, "u").replace(/punctuation/g, P).getRegex(), nt = /\[[^[\]]*?\]\([^\(\)]*?\)|`[^`]*?`|<[^<>]*?>/g, st = d(/^(?:\*+(?:((?!\*)[punct])|[^\s*]))|^_+(?:((?!_)[punct])|([^\s_]))/, "u").replace(/punct/g, P).getRegex(), it = d("^[^_*]*?__[^_*]*?\\*[^_*]*?(?=__)|[^*]+(?=[^*])|(?!\\*)[punct](\\*+)(?=[\\s]|$)|[^punct\\s](\\*+)(?!\\*)(?=[punct\\s]|$)|(?!\\*)[punct\\s](\\*+)(?=[^punct\\s])|[\\s](\\*+)(?!\\*)(?=[punct])|(?!\\*)[punct](\\*+)(?!\\*)(?=[punct])|[^punct\\s](\\*+)(?=[^punct\\s])", "gu").replace(/punct/g, P).getRegex(), rt = d("^[^_*]*?\\*\\*[^_*]*?_[^_*]*?(?=\\*\\*)|[^_]+(?=[^_])|(?!_)[punct](_+)(?=[\\s]|$)|[^punct\\s](_+)(?!_)(?=[punct\\s]|$)|(?!_)[punct\\s](_+)(?=[^punct\\s])|[\\s](_+)(?!_)(?=[punct])|(?!_)[punct](_+)(?!_)(?=[punct])", "gu").replace(/punct/g, P).getRegex(), ot = d(/\\([punct])/, "gu").replace(/punct/g, P).getRegex(), lt = d(/^<(scheme:[^\s\x00-\x1f<>]*|email)>/).replace("scheme", /[a-zA-Z][a-zA-Z0-9+.-]{1,31}/).replace("email", /[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+(@)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+(?![-_])/).getRegex(), at = d(U).replace("(?:-->|$)", "-->").getRegex(), ct = d("^comment|^</[a-zA-Z][\\w:-]*\\s*>|^<[a-zA-Z][\\w-]*(?:attribute)*?\\s*/?>|^<\\?[\\s\\S]*?\\?>|^<![a-zA-Z]+\\s[\\s\\S]*?>|^<!\\[CDATA\\[[\\s\\S]*?\\]\\]>").replace("comment", at).replace("attribute", /\s+[a-zA-Z:_][\w.:-]*(?:\s*=\s*"[^"]*"|\s*=\s*'[^']*'|\s*=\s*[^\s"'=<>`]+)?/).getRegex(), Z = /(?:\[(?:\\.|[^\[\]\\])*\]|\\.|`[^`]*`|[^\[\]\\`])*?/, pt = d(/^!?\[(label)\]\(\s*(href)(?:\s+(title))?\s*\)/).replace("label", Z).replace("href", /<(?:\\.|[^\n<>\\])+>|[^\s\x00-\x1f]*/).replace("title", /"(?:\\"?|[^"\\])*"|'(?:\\'?|[^'\\])*'|\((?:\\\)?|[^)\\])*\)/).getRegex(), we = d(/^!?\[(label)\]\[(ref)\]/).replace("label", Z).replace("ref", G).getRegex(), be = d(/^!?\[(ref)\](?:\[\])?/).replace("ref", G).getRegex(), ht = d("reflink|nolink(?!\\()", "g").replace("reflink", we).replace("nolink", be).getRegex(), V = {
   _backpedal: E,
   // only used for GFM url
   anyPunctuation: ot,
@@ -743,11 +743,11 @@ const Me = /^(?: *(?:\n|$))+/, Fe = /^( {4}[^\n]+(?:\n(?: *(?:\n|$))*)?)+/, Qe =
   emStrongRDelimAst: it,
   emStrongRDelimUnd: rt,
   escape: xe,
-  link: ht,
+  link: pt,
   nolink: be,
   punctuation: tt,
   reflink: we,
-  reflinkSearch: pt,
+  reflinkSearch: ht,
   tag: ct,
   text: et,
   url: E
@@ -828,7 +828,7 @@ class T {
     return this.inlineQueue = [], this.tokens;
   }
   blockTokens(n, e = []) {
-    this.options.pedantic ? n = n.replace(/\t/g, "    ").replace(/^ +$/gm, "") : n = n.replace(/^( *)(\t+)/gm, (l, o, p) => o + "    ".repeat(p.length));
+    this.options.pedantic ? n = n.replace(/\t/g, "    ").replace(/^ +$/gm, "") : n = n.replace(/^( *)(\t+)/gm, (l, o, h) => o + "    ".repeat(h.length));
     let t, i, r, s;
     for (; n; )
       if (!(this.options.extensions && this.options.extensions.block && this.options.extensions.block.some((l) => (t = l.call({ lexer: this }, n, e)) ? (n = n.substring(t.raw.length), e.push(t), !0) : !1))) {
@@ -887,9 +887,9 @@ class T {
         if (r = n, this.options.extensions && this.options.extensions.startBlock) {
           let l = 1 / 0;
           const o = n.slice(1);
-          let p;
+          let h;
           this.options.extensions.startBlock.forEach((c) => {
-            p = c.call({ lexer: this }, o), typeof p == "number" && p >= 0 && (l = Math.min(l, p));
+            h = c.call({ lexer: this }, o), typeof h == "number" && h >= 0 && (l = Math.min(l, h));
           }), l < 1 / 0 && l >= 0 && (r = n.substring(0, l + 1));
         }
         if (this.state.top && (t = this.tokenizer.paragraph(r))) {
@@ -922,7 +922,7 @@ class T {
    * Lexing/Compiling
    */
   inlineTokens(n, e = []) {
-    let t, i, r, s = n, l, o, p;
+    let t, i, r, s = n, l, o, h;
     if (this.tokens.links) {
       const c = Object.keys(this.tokens.links);
       if (c.length > 0)
@@ -934,7 +934,7 @@ class T {
     for (; (l = this.tokenizer.rules.inline.anyPunctuation.exec(s)) != null; )
       s = s.slice(0, l.index) + "++" + s.slice(this.tokenizer.rules.inline.anyPunctuation.lastIndex);
     for (; n; )
-      if (o || (p = ""), o = !1, !(this.options.extensions && this.options.extensions.inline && this.options.extensions.inline.some((c) => (t = c.call({ lexer: this }, n, e)) ? (n = n.substring(t.raw.length), e.push(t), !0) : !1))) {
+      if (o || (h = ""), o = !1, !(this.options.extensions && this.options.extensions.inline && this.options.extensions.inline.some((c) => (t = c.call({ lexer: this }, n, e)) ? (n = n.substring(t.raw.length), e.push(t), !0) : !1))) {
         if (t = this.tokenizer.escape(n)) {
           n = n.substring(t.raw.length), e.push(t);
           continue;
@@ -951,7 +951,7 @@ class T {
           n = n.substring(t.raw.length), i = e[e.length - 1], i && t.type === "text" && i.type === "text" ? (i.raw += t.raw, i.text += t.text) : e.push(t);
           continue;
         }
-        if (t = this.tokenizer.emStrong(n, s, p)) {
+        if (t = this.tokenizer.emStrong(n, s, h)) {
           n = n.substring(t.raw.length), e.push(t);
           continue;
         }
@@ -978,13 +978,13 @@ class T {
         if (r = n, this.options.extensions && this.options.extensions.startInline) {
           let c = 1 / 0;
           const u = n.slice(1);
-          let h;
+          let p;
           this.options.extensions.startInline.forEach((f) => {
-            h = f.call({ lexer: this }, u), typeof h == "number" && h >= 0 && (c = Math.min(c, h));
+            p = f.call({ lexer: this }, u), typeof p == "number" && p >= 0 && (c = Math.min(c, p));
           }), c < 1 / 0 && c >= 0 && (r = n.substring(0, c + 1));
         }
         if (t = this.tokenizer.inlineText(r)) {
-          n = n.substring(t.raw.length), t.raw.slice(-1) !== "_" && (p = t.raw.slice(-1)), o = !0, i = e[e.length - 1], i && i.type === "text" ? (i.raw += t.raw, i.text += t.text) : e.push(t);
+          n = n.substring(t.raw.length), t.raw.slice(-1) !== "_" && (h = t.raw.slice(-1)), o = !0, i = e[e.length - 1], i && i.type === "text" ? (i.raw += t.raw, i.text += t.text) : e.push(t);
           continue;
         }
         if (n) {
@@ -1186,15 +1186,15 @@ class z {
           for (let c = 0; c < s.header.length; c++)
             o += this.renderer.tablecell(this.parseInline(s.header[c].tokens), { header: !0, align: s.align[c] });
           l += this.renderer.tablerow(o);
-          let p = "";
+          let h = "";
           for (let c = 0; c < s.rows.length; c++) {
             const u = s.rows[c];
             o = "";
-            for (let h = 0; h < u.length; h++)
-              o += this.renderer.tablecell(this.parseInline(u[h].tokens), { header: !1, align: s.align[h] });
-            p += this.renderer.tablerow(o);
+            for (let p = 0; p < u.length; p++)
+              o += this.renderer.tablecell(this.parseInline(u[p].tokens), { header: !1, align: s.align[p] });
+            h += this.renderer.tablerow(o);
           }
-          t += this.renderer.table(l, p);
+          t += this.renderer.table(l, h);
           continue;
         }
         case "blockquote": {
@@ -1203,19 +1203,19 @@ class z {
           continue;
         }
         case "list": {
-          const s = r, l = s.ordered, o = s.start, p = s.loose;
+          const s = r, l = s.ordered, o = s.start, h = s.loose;
           let c = "";
           for (let u = 0; u < s.items.length; u++) {
-            const h = s.items[u], f = h.checked, w = h.task;
+            const p = s.items[u], f = p.checked, w = p.task;
             let y = "";
-            if (h.task) {
+            if (p.task) {
               const R = this.renderer.checkbox(!!f);
-              p ? h.tokens.length > 0 && h.tokens[0].type === "paragraph" ? (h.tokens[0].text = R + " " + h.tokens[0].text, h.tokens[0].tokens && h.tokens[0].tokens.length > 0 && h.tokens[0].tokens[0].type === "text" && (h.tokens[0].tokens[0].text = R + " " + h.tokens[0].tokens[0].text)) : h.tokens.unshift({
+              h ? p.tokens.length > 0 && p.tokens[0].type === "paragraph" ? (p.tokens[0].text = R + " " + p.tokens[0].text, p.tokens[0].tokens && p.tokens[0].tokens.length > 0 && p.tokens[0].tokens[0].type === "text" && (p.tokens[0].tokens[0].text = R + " " + p.tokens[0].tokens[0].text)) : p.tokens.unshift({
                 type: "text",
                 text: R + " "
               }) : y += R + " ";
             }
-            y += this.parse(h.tokens, p), c += this.renderer.listitem(y, w, !!f);
+            y += this.parse(p.tokens, h), c += this.renderer.listitem(y, w, !!f);
           }
           t += this.renderer.list(c, l, o);
           continue;
@@ -1382,8 +1382,8 @@ class gt {
           for (const o of l.header)
             t = t.concat(this.walkTokens(o.tokens, e));
           for (const o of l.rows)
-            for (const p of o)
-              t = t.concat(this.walkTokens(p.tokens, e));
+            for (const h of o)
+              t = t.concat(this.walkTokens(h.tokens, e));
           break;
         }
         case "list": {
@@ -1394,8 +1394,8 @@ class gt {
         default: {
           const l = s;
           (r = (i = this.defaults.extensions) == null ? void 0 : i.childTokens) != null && r[l.type] ? this.defaults.extensions.childTokens[l.type].forEach((o) => {
-            const p = l[o].flat(1 / 0);
-            t = t.concat(this.walkTokens(p, e));
+            const h = l[o].flat(1 / 0);
+            t = t.concat(this.walkTokens(h, e));
           }) : l.tokens && (t = t.concat(this.walkTokens(l.tokens, e)));
         }
       }
@@ -1429,10 +1429,10 @@ class gt {
             throw new Error(`renderer '${s}' does not exist`);
           if (s === "options")
             continue;
-          const l = s, o = t.renderer[l], p = r[l];
+          const l = s, o = t.renderer[l], h = r[l];
           r[l] = (...c) => {
             let u = o.apply(r, c);
-            return u === !1 && (u = p.apply(r, c)), u || "";
+            return u === !1 && (u = h.apply(r, c)), u || "";
           };
         }
         i.renderer = r;
@@ -1444,10 +1444,10 @@ class gt {
             throw new Error(`tokenizer '${s}' does not exist`);
           if (["options", "rules", "lexer"].includes(s))
             continue;
-          const l = s, o = t.tokenizer[l], p = r[l];
+          const l = s, o = t.tokenizer[l], h = r[l];
           r[l] = (...c) => {
             let u = o.apply(r, c);
-            return u === !1 && (u = p.apply(r, c)), u;
+            return u === !1 && (u = h.apply(r, c)), u;
           };
         }
         i.tokenizer = r;
@@ -1459,15 +1459,15 @@ class gt {
             throw new Error(`hook '${s}' does not exist`);
           if (s === "options")
             continue;
-          const l = s, o = t.hooks[l], p = r[l];
+          const l = s, o = t.hooks[l], h = r[l];
           C.passThroughHooks.has(s) ? r[l] = (c) => {
             if (this.defaults.async)
-              return Promise.resolve(o.call(r, c)).then((h) => p.call(r, h));
+              return Promise.resolve(o.call(r, c)).then((p) => h.call(r, p));
             const u = o.call(r, c);
-            return p.call(r, u);
+            return h.call(r, u);
           } : r[l] = (...c) => {
             let u = o.apply(r, c);
-            return u === !1 && (u = p.apply(r, c)), u;
+            return u === !1 && (u = h.apply(r, c)), u;
           };
         }
         i.hooks = r;
@@ -1507,8 +1507,8 @@ _ = new WeakSet(), H = function(n, e) {
       s.hooks && (t = s.hooks.preprocess(t));
       let o = n(t, s);
       s.hooks && (o = s.hooks.processAllTokens(o)), s.walkTokens && this.walkTokens(o, s.walkTokens);
-      let p = e(o, s);
-      return s.hooks && (p = s.hooks.postprocess(p)), p;
+      let h = e(o, s);
+      return s.hooks && (h = s.hooks.postprocess(h)), h;
     } catch (o) {
       return l(o);
     }
@@ -1530,12 +1530,12 @@ function g(a, n) {
   return S.parse(a, n);
 }
 g.options = g.setOptions = function(a) {
-  return S.setOptions(a), g.defaults = S.defaults, pe(g.defaults), g;
+  return S.setOptions(a), g.defaults = S.defaults, he(g.defaults), g;
 };
 g.getDefaults = J;
 g.defaults = A;
 g.use = function(...a) {
-  return S.use(...a), g.defaults = S.defaults, pe(g.defaults), g;
+  return S.use(...a), g.defaults = S.defaults, he(g.defaults), g;
 };
 g.walkTokens = function(a, n) {
   return S.walkTokens(a, n);
@@ -1563,10 +1563,10 @@ function dt(a) {
     const e = g.lexer(n), t = [], i = [];
     for (const r of e)
       if (r.type === "heading") {
-        const s = r, l = s.depth, o = $e(s.tokens), p = kt(o), c = {
+        const s = r, l = s.depth, o = $e(s.tokens), h = kt(o), c = {
           level: l,
-          text: o,
-          id: p,
+          text: o.trim(),
+          id: h,
           children: []
         };
         for (; i.length > 0 && i[i.length - 1].level >= l; )
@@ -1591,9 +1591,9 @@ function $e(a) {
   }).join("");
 }
 function kt(a) {
-  return a.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").trim();
+  return a.toLowerCase().replace(/\s+/g, "-").replace(/[^\p{L}\p{N}-]/gu, "").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
 }
-async function he(a, n) {
+async function pe(a, n) {
   const e = {};
   for (const [t, i] of Object.entries(a)) {
     const r = x.join(n, `${t}.md`);
@@ -1632,10 +1632,10 @@ function Tt(a) {
         await m.writeJSON(l, s, { spaces: 2 }), $.info(
           `✅ Generated docs-meta.json with ${Object.keys(s).length} documents`
         );
-        const o = await ie(s, r), p = x.join(i, "search-index.json");
-        await m.writeJSON(p, o, { spaces: 2 }), $.info("✅ Generated search-index.json"), $.info("Generating TOC collection...");
+        const o = await ie(s, r), h = x.join(i, "search-index.json");
+        await m.writeJSON(h, o, { spaces: 2 }), $.info("✅ Generated search-index.json"), $.info("Generating TOC collection...");
         try {
-          const c = await he(s, r), u = x.join(i, "docs-toc.json");
+          const c = await pe(s, r), u = x.join(i, "docs-toc.json");
           await m.writeJSON(u, c, { spaces: 2 }), $.info(
             `✅ Generated docs-toc.json with ${Object.keys(c).length} documents`
           );
@@ -1658,18 +1658,18 @@ function Tt(a) {
      * 在开发模式下通过 /.wsx-press 路径提供元数据和搜索索引
      */
     configureServer(s) {
-      s.middlewares.use("/.wsx-press", async (l, o, p) => {
+      s.middlewares.use("/.wsx-press", async (l, o, h) => {
         try {
-          const h = new URL(l.url || "/", `http://${l.headers.host}`).pathname.replace(/^\/\.wsx-press\/?/, "").replace(/^\//, "");
-          if (h === "docs-meta.json" || h === "search-index.json" || h === "docs-toc.json") {
-            const f = x.join(i, h);
+          const p = new URL(l.url || "/", `http://${l.headers.host}`).pathname.replace(/^\/\.wsx-press\/?/, "").replace(/^\//, "");
+          if (p === "docs-meta.json" || p === "search-index.json" || p === "docs-toc.json") {
+            const f = x.join(i, p);
             if (await m.pathExists(f)) {
               const w = await m.readFile(f, "utf-8");
               o.setHeader("Content-Type", "application/json"), o.end(w);
               return;
             }
           }
-          if (h === "docs-meta.json") {
+          if (p === "docs-meta.json") {
             const f = await O(r);
             await m.ensureDir(i), await m.writeJSON(
               x.join(i, "docs-meta.json"),
@@ -1680,7 +1680,7 @@ function Tt(a) {
             ), o.setHeader("Content-Type", "application/json"), o.end(JSON.stringify(f, null, 2));
             return;
           }
-          if (h === "search-index.json") {
+          if (p === "search-index.json") {
             const f = await O(r), w = await ie(f, r);
             await m.ensureDir(i), await m.writeJSON(
               x.join(i, "search-index.json"),
@@ -1689,8 +1689,8 @@ function Tt(a) {
             ), o.setHeader("Content-Type", "application/json"), o.end(JSON.stringify(w, null, 2));
             return;
           }
-          if (h === "docs-toc.json") {
-            const f = await O(r), w = await he(
+          if (p === "docs-toc.json") {
+            const f = await O(r), w = await pe(
               f,
               r
             );
@@ -1701,7 +1701,7 @@ function Tt(a) {
             ), o.setHeader("Content-Type", "application/json"), o.end(JSON.stringify(w, null, 2));
             return;
           }
-          p();
+          h();
         } catch (c) {
           $.error("Middleware error:", c), o.statusCode = 500, o.end(JSON.stringify({ error: String(c) }));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wsxjs/wsx-press",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "A VitePress-like documentation system built with WSXJS",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,10 +28,10 @@
   "dependencies": {
     "fuse.js": "^7.0.0",
     "marked": "^12.0.0",
-    "@wsxjs/wsx-core": "0.0.25",
-    "@wsxjs/wsx-logger": "0.0.25",
-    "@wsxjs/wsx-marked-components": "0.0.25",
-    "@wsxjs/wsx-router": "0.0.25"
+    "@wsxjs/wsx-logger": "0.0.27",
+    "@wsxjs/wsx-core": "0.0.27",
+    "@wsxjs/wsx-marked-components": "0.0.27",
+    "@wsxjs/wsx-router": "0.0.27"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
@@ -48,8 +48,8 @@
     "typescript": "^5.0.0",
     "vite": "^5.4.19",
     "vitest": "^2.0.0",
-    "@wsxjs/wsx-vite-plugin": "0.0.25",
-    "@wsxjs/eslint-plugin-wsx": "0.0.25"
+    "@wsxjs/wsx-vite-plugin": "0.0.27",
+    "@wsxjs/eslint-plugin-wsx": "0.0.27"
   },
   "peerDependencies": {
     "typedoc": "^0.26.0",

package/src/client/components/DocPage.wsx

@@ -187,6 +187,9 @@ export default class DocPage extends LightComponent {
                 this.loadDocument();
             });
         });
+
+        // Listen for hash changes
+        window.addEventListener("hashchange", this.onHashChange);
     }
 
     protected onDisconnected() {
@@ -203,10 +206,19 @@ export default class DocPage extends LightComponent {
             this.visibilityChangeHandler = null;
         }
 
+        window.removeEventListener("hashchange", this.onHashChange);
+
         // 取消正在进行的加载请求
         this.cancelLoading();
     }
 
+    /**
+     * Handle hash change event
+     */
+    private onHashChange = () => {
+        this.scrollToHash();
+    };
+
     /**
      * 取消正在进行的加载请求
      */
@@ -448,6 +460,51 @@ export default class DocPage extends LightComponent {
         }
     }
 
+    /**
+     * Scroll to the element matching the current hash
+     * 使用重试机制处理异步渲染的内容
+     */
+    private scrollToHash(retryCount: number = 0) {
+        const maxRetries = 5;
+        const retryDelay = 100; // ms
+
+        const hash = window.location.hash;
+        if (!hash) return;
+
+        // Remove the '#' character
+        const id = decodeURIComponent(hash.slice(1));
+        if (!id) return;
+
+        // Try to find the element
+        const element = document.getElementById(id);
+        if (element) {
+            // Scroll into view
+            element.scrollIntoView({ behavior: "smooth", block: "start" });
+            logger.debug(`Scrolled to anchor: ${id}`);
+        } else if (retryCount < maxRetries) {
+            // Element not found yet, retry after a short delay
+            // This handles the case where markdown content is still being rendered
+            setTimeout(() => {
+                this.scrollToHash(retryCount + 1);
+            }, retryDelay);
+        } else {
+            logger.warn(`Anchor element not found after ${maxRetries} retries: ${id}`);
+        }
+    }
+
+    protected updated() {
+        // Called after every render
+        if (this.loadingState === "success") {
+            // Attempt to scroll to hash if present
+            // specific check to avoid scrolling on every update if not needed,
+            // or we can rely on the fact that if user scrolled away, we shouldn't force it back?
+            // Actually, typically we only do this on initial load or hash change.
+            // But since content is loaded async, we need to do it once content is Ready.
+            // Let's use a small delay to ensure DOM is ready.
+            requestAnimationFrame(() => this.scrollToHash());
+        }
+    }
+
     render() {
         if (this.loadingState === "loading") {
             return (

package/src/client/components/DocTOC.css

@@ -3,11 +3,7 @@ wsx-doc-toc {
     flex-direction: column;
     width: 240px;
     min-width: 240px;
-    height: 100%;
-    overflow-y: auto;
-    position: sticky;
-    top: 70px; /* Navigation height */
-    max-height: calc(100vh - 70px);
+    /* TOC scrolls with content instead of staying fixed at top */
 }
 
 .doc-toc {