@cobapen/markdown 0.4.1 → 0.4.2

package/lib/code/fence-custom.d.ts

@@ -0,0 +1,8 @@
+import { Options } from "markdown-it/index.mjs";
+import Renderer from "markdown-it/lib/renderer.mjs";
+import Token from "markdown-it/lib/token.mjs";
+interface Env {
+    showCodeTitleByDefault?: boolean;
+}
+export declare function fence_custom(tokens: Token[], idx: number, options: Options, env: Env, slf: Renderer): string;
+export {};

package/lib/code/fence-custom.js

@@ -0,0 +1,41 @@
+import { escapeHtml, unescapeAll } from "markdown-it/lib/common/utils.mjs";
+import { InfoString } from "./info-string.js";
+export function fence_custom(tokens, idx, options, env, slf) {
+    const token = tokens[idx];
+    const info_str = token.info ? unescapeAll(token.info).trim() : "";
+    const info = new InfoString(info_str);
+    const langName = info.lang;
+    const langAttrs = info.attrs.join(" ");
+    let highlighted;
+    if (options.highlight) {
+        highlighted = options.highlight(token.content, langName, langAttrs) || escapeHtml(token.content);
+    }
+    else {
+        highlighted = escapeHtml(token.content);
+    }
+    if (highlighted.indexOf("<pre") === 0) {
+        return highlighted + "\n";
+    }
+    if (info.hasLang) {
+        const i = token.attrIndex("class");
+        const tmpAttrs = token.attrs ? token.attrs.slice() : [];
+        if (i < 0) {
+            tmpAttrs.push(["class", options.langPrefix + langName]);
+        }
+        else {
+            tmpAttrs[i] = tmpAttrs[i].slice();
+            tmpAttrs[i][1] += " " + options.langPrefix + langName;
+        }
+        const tmpToken = {
+            attrs: tmpAttrs
+        };
+        if (info.title.length > 0) {
+            const style = (env.showCodeTitleByDefault === true)
+                ? ""
+                : " style=\"visibility:hidden;\"";
+            return `<pre><code${slf.renderAttrs(tmpToken)}>${highlighted}</code><span class="title"${style}>${info.title}</span></pre>\n`;
+        }
+        return `<pre><code${slf.renderAttrs(tmpToken)}>${highlighted}</code></pre>\n`;
+    }
+    return `<pre><code${slf.renderAttrs(token)}>${highlighted}</code></pre>\n`;
+}

package/lib/code/highlight.d.ts

@@ -0,0 +1,2 @@
+export declare function highlightWithLineNumber(code: string, lang: string, linestart?: number): string;
+export declare function highlighterForMarkdownIt(str: string, lang: string, attrs: string): string;

package/lib/code/highlight.js

@@ -0,0 +1,45 @@
+import hljs from "highlight.js";
+import { InfoString } from "./info-string.js";
+function _debuglog(..._args) {
+}
+function numDigits(n) {
+    return Math.floor(n).toString().length;
+}
+function niceDec(n) {
+    return n.toFixed(3);
+}
+export function highlightWithLineNumber(code, lang, linestart) {
+    try {
+        if (lang && hljs.getLanguage(lang)) {
+            let htmlLines = hljs.highlight(code, { language: lang }).value;
+            if (linestart !== undefined) {
+                const lines = htmlLines.split("\n");
+                const elWidth = numDigits(linestart + lines.length) * 0.8;
+                const elStyle = "display:inline-block;" +
+                    "user-select:none;" +
+                    `width: ${niceDec(elWidth)}em;`;
+                lines.forEach((line, i, lines) => {
+                    lines[i] =
+                        "<div class=\"line\">" +
+                            `<span class="line-no" style="${elStyle}">${linestart + i}</span>${line}` +
+                            "</div>";
+                });
+                _debuglog(lines);
+                htmlLines = lines.join("");
+            }
+            return htmlLines;
+        }
+        else {
+            return "";
+        }
+    }
+    catch (_) {
+        return "";
+    }
+}
+export function highlighterForMarkdownIt(str, lang, attrs) {
+    _debuglog(lang ? lang : "(lang is empty or undefined)");
+    const info = new InfoString(lang + " " + attrs);
+    _debuglog(info);
+    return highlightWithLineNumber(str, info.lang, info.linestart);
+}

package/lib/code/info-string.d.ts

@@ -0,0 +1,19 @@
+export declare class InfoString {
+    private readonly _lang;
+    private readonly _attrs;
+    private readonly _title;
+    private readonly _linestart;
+    constructor(info: string);
+    get lang(): string;
+    get attrs(): string[];
+    get title(): string;
+    get linestart(): number | undefined;
+    get hasLang(): boolean;
+    static parseInfoString(info: string): string[];
+    static parseMetaNotation(text: string): {
+        filename: string;
+        line: number;
+    } | undefined;
+    static getTitle(attr: string[]): string;
+    static getLineStart(attr: string[]): number | undefined;
+}

package/lib/code/info-string.js

@@ -0,0 +1,100 @@
+export class InfoString {
+    _lang;
+    _attrs;
+    _title;
+    _linestart;
+    constructor(info) {
+        if (info.length > 0) {
+            const arr = InfoString.parseInfoString(info);
+            this._lang = arr[0];
+            this._attrs = arr.slice(1);
+            this._title = InfoString.getTitle(this._attrs);
+            this._linestart = InfoString.getLineStart(this._attrs);
+        }
+        else {
+            this._lang = "";
+            this._attrs = [];
+            this._title = "";
+            this._linestart = undefined;
+        }
+    }
+    get lang() {
+        return this._lang;
+    }
+    get attrs() {
+        return this._attrs;
+    }
+    get title() {
+        return this._title;
+    }
+    get linestart() {
+        return this._linestart;
+    }
+    get hasLang() {
+        return this._lang.length > 0;
+    }
+    static parseInfoString(info) {
+        const dq = "[^\"\\\\]*(?:\\\\.|[^\"\\\\]*)*";
+        const sq = "[^\'\\\\]*(?:\\\\.|[^\'\\\\]*)*";
+        const ptn = `([^\\s]+=)?(?:"(${dq})"|'(${sq})'|([^\\s]+))`;
+        const regex = new RegExp(ptn, "g");
+        const result = [];
+        let match;
+        while ((match = regex.exec(info)) !== null) {
+            let text = (match[1] || "") + (match[2] || match[3] || match[4] || "");
+            text = unescape(text).trim();
+            result.push(text);
+        }
+        return result;
+    }
+    static parseMetaNotation(text) {
+        const match = text.match(/^\{\s*([^:]+):(\d+)\s*\}$/);
+        if (match) {
+            return {
+                filename: match[1],
+                line: parseInt(match[2], 10),
+            };
+        }
+        return undefined;
+    }
+    static getTitle(attr) {
+        const titleAttr = attr.find(x => x.startsWith("title=")) ?? "";
+        if (titleAttr.length > 0) {
+            const match = titleAttr.match(/^title=(.*)$/);
+            if (match) {
+                let value = match[1].trim();
+                if (value.startsWith("\"") && value.endsWith("\"")) {
+                    value = value.slice(1, -1);
+                    value = unescape(value).trim();
+                }
+                return value;
+            }
+            else {
+                throw new Error("Must not fail. Check impl.");
+            }
+        }
+        if (attr.length > 0) {
+            const meta = InfoString.parseMetaNotation(attr[0]);
+            if (meta && meta.filename.length > 0) {
+                return meta.filename;
+            }
+        }
+        return "";
+    }
+    static getLineStart(attr) {
+        const lineAttr = attr.find(x => x.startsWith("linestart=")) ?? "";
+        if (lineAttr.length > 0) {
+            return parseInt(lineAttr.split("=")[1].trim());
+        }
+        if (attr.length > 0) {
+            const meta = InfoString.parseMetaNotation(attr[0]);
+            if (meta && meta.line > 0) {
+                return meta.line;
+            }
+        }
+        return undefined;
+    }
+}
+function unescape(text) {
+    return text.replaceAll(/\\\"/g, "\"").replaceAll(/\\\'/g, "'");
+}

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+import markdownIt, { Options as MarkdownOptions } from "markdown-it";
+import { Options as MathOptions } from "./math/mathjax.js";
+export interface Config {
+    showCodeTitleByDefault: boolean;
+    markdown: Partial<MarkdownOptions>;
+    math: Partial<MathOptions>;
+}
+export type Options = Partial<Config>;
+export declare class CMarkdown {
+    private readonly _config;
+    private readonly _mj;
+    private readonly _md;
+    constructor(option?: Options);
+    setup(md: markdownIt): void;
+    render(text: string): string;
+    mathcss(): string;
+}

package/lib/index.js

@@ -0,0 +1,61 @@
+import markdownIt from "markdown-it";
+import advTable from "markdown-it-adv-table";
+import anchor from "markdown-it-anchor";
+import cjkbreaks from "markdown-it-cjk-breaks";
+import deflist from "markdown-it-deflist";
+import footnote from "markdown-it-footnote";
+import toc from "markdown-it-table-of-contents";
+import { fence_custom } from "./code/fence-custom.js";
+import { highlighterForMarkdownIt } from "./code/highlight.js";
+import { replacelink } from "./link/replacelink.js";
+import { MathjaxEngine } from "./math/mathjax.js";
+import { mdmath } from "./math/mdmath.js";
+const defaultOptions = {
+    showCodeTitleByDefault: false,
+    markdown: {
+        html: true,
+        linkify: true,
+        highlight: highlighterForMarkdownIt,
+    },
+    math: {
+        tex: {
+            macros: {
+                bm: ["\\boldsymbol{#1}", 1],
+            },
+        },
+    }
+};
+export class CMarkdown {
+    _config;
+    _mj;
+    _md;
+    constructor(option) {
+        const config = { ...defaultOptions, ...option };
+        const mj = new MathjaxEngine(config.math);
+        const md = markdownIt(config.markdown);
+        this._config = config;
+        this._mj = mj;
+        this._md = md;
+        this.setup(md);
+    }
+    setup(md) {
+        md.renderer.rules.fence = fence_custom;
+        md.use(anchor)
+            .use(cjkbreaks)
+            .use(footnote)
+            .use(deflist)
+            .use(replacelink)
+            .use(advTable)
+            .use(mdmath(this._mj))
+            .use(toc, {
+            includeLevel: [2, 3],
+        });
+    }
+    render(text) {
+        const env = { ...this._config };
+        return this._md.render(text, env);
+    }
+    mathcss() {
+        return this._mj.stylesheet();
+    }
+}

package/lib/link/replacelink.d.ts

@@ -0,0 +1,8 @@
+import type { PluginWithOptions } from "markdown-it";
+import type Token from "markdown-it/lib/token.mjs";
+type ReplaceHandler = (link: string, env: any, token: Token) => string;
+interface Options {
+    replace: ReplaceHandler;
+}
+export declare const replacelink: PluginWithOptions<Options>;
+export default replacelink;

package/lib/link/replacelink.js

@@ -0,0 +1,39 @@
+function defaultHandler(link, _env, _token) {
+    if (!link.startsWith("http") && link.endsWith(".md")) {
+        return link.replace(/\.md$/, ".html");
+    }
+    else {
+        return link;
+    }
+}
+function replaceAttr(token, attrName, handler, env) {
+    token.attrs?.forEach(attr => {
+        if (attr[0] === attrName) {
+            attr[1] = handler(attr[1], env, token);
+        }
+    });
+}
+function getHandler(option) {
+    const replaceFn = option?.replace || defaultHandler;
+    function handler(state) {
+        state.tokens.forEach(token => {
+            if (token.type === "inline" && token.children !== null) {
+                token.children.forEach(childToken => {
+                    if (childToken.type == "link_open") {
+                        replaceAttr(childToken, "href", replaceFn, state.env);
+                    }
+                    else if (childToken.type == "image") {
+                        replaceAttr(childToken, "src", replaceFn, state.env);
+                    }
+                });
+            }
+        });
+    }
+    ;
+    return handler;
+}
+export const replacelink = (md, option) => {
+    const handler = getHandler(option);
+    md.core.ruler.after("linkify", "replace_link", handler);
+};
+export default replacelink;

package/lib/math/mathjax.d.ts

@@ -0,0 +1,67 @@
+import { type LiteDocument } from "mathjax-full/js/adaptors/lite/Document.js";
+import { LiteElement } from "mathjax-full/js/adaptors/lite/Element.js";
+import { type LiteText } from "mathjax-full/js/adaptors/lite/Text.js";
+import { type LiteAdaptor } from "mathjax-full/js/adaptors/liteAdaptor.js";
+import { type MathDocument } from "mathjax-full/js/core/MathDocument.js";
+import { TeX } from "mathjax-full/js/input/tex.js";
+import { CHTML } from "mathjax-full/js/output/chtml.js";
+type N = LiteElement;
+type T = LiteText;
+type D = LiteDocument;
+interface AnyObject {
+    [x: string]: any;
+}
+interface TexConfig {
+    packages: string | [string] | AnyObject;
+    inlineMath: [[string, string]];
+    displayMath: [[string, string]];
+    processEscapes: boolean;
+    processEnvironments: boolean;
+    processRefs: boolean;
+    digits: RegExp;
+    tags: string;
+    tagSide: string;
+    tagIndent: string;
+    useLabelIds: boolean;
+    multlineWidth: string;
+    maxMacros: number;
+    maxBuffer: number;
+    baseURL: string;
+    formatError: (jax: object, err: Error) => void;
+    macros: AnyObject;
+}
+interface CHTMLConfig {
+    scale: number;
+    minScale: number;
+    matchFontHeight: boolean;
+    mtextInheritFont: boolean;
+    merrorInheritFont: boolean;
+    mtextFont: string;
+    merrorFont: string;
+    mathmlspacing: boolean;
+    skipAttributes: AnyObject;
+    exFactor: number;
+    displayAlign: string;
+    displayIndent: number | string;
+    fontURL: string;
+    adaptiveCSS: boolean;
+}
+export interface Options {
+    inline: boolean;
+    em: number;
+    ex: number;
+    width: number;
+    tex?: Partial<TexConfig>;
+    chtml?: Partial<CHTMLConfig>;
+}
+export declare class MathjaxEngine {
+    option: Options;
+    adaptor: LiteAdaptor;
+    tex: TeX<N, T, D>;
+    chtml: CHTML<N, T, D>;
+    html: MathDocument<N, T, D>;
+    constructor(option?: Partial<Options>);
+    convert(tex: string, override?: Partial<Options>): string;
+    stylesheet(): string;
+}
+export {};

package/lib/math/mathjax.js

@@ -0,0 +1,79 @@
+import { merge } from "lodash-es";
+import { LiteElement } from "mathjax-full/js/adaptors/lite/Element.js";
+import { liteAdaptor } from "mathjax-full/js/adaptors/liteAdaptor.js";
+import { RegisterHTMLHandler } from "mathjax-full/js/handlers/html.js";
+import { AllPackages } from "mathjax-full/js/input/tex/AllPackages.js";
+import { TeX } from "mathjax-full/js/input/tex.js";
+import { mathjax } from "mathjax-full/js/mathjax.js";
+import { CHTML } from "mathjax-full/js/output/chtml.js";
+const MATHJAX_DEFAULT_FONT_URL = "https://cdn.jsdelivr.net/npm/mathjax-full@3/es5/output/chtml/fonts/woff-v2";
+const defaultOption = {
+    inline: false,
+    em: 16,
+    ex: 8,
+    width: 80 * 16,
+    tex: {
+        packages: AllPackages,
+    },
+    chtml: {
+        scale: 1.21,
+        fontURL: MATHJAX_DEFAULT_FONT_URL,
+        adaptiveCSS: true,
+        exFactor: 5,
+    },
+};
+export class MathjaxEngine {
+    option;
+    adaptor;
+    tex;
+    chtml;
+    html;
+    constructor(option) {
+        this.option = merge({}, defaultOption, option);
+        if (typeof this.option.tex?.packages === "string") {
+            this.option.tex.packages = this.option.tex.packages.split(/\s*,\s*/);
+        }
+        this.adaptor = liteAdaptor();
+        RegisterHTMLHandler(this.adaptor);
+        const tex = new TeX(this.option.tex);
+        const chtml = new CHTML(this.option.chtml);
+        const html = mathjax.document("", {
+            InputJax: tex,
+            OutputJax: chtml,
+        });
+        html.addRenderAction("typeset", 155, renderDoc, renderMath);
+        this.tex = tex;
+        this.chtml = chtml;
+        this.html = html;
+        function renderDoc(_doc) { }
+        function renderMath(math, doc) {
+            const adaptor = doc.adaptor;
+            const text = adaptor.node("mjx-copytext", { "aria-hidden": true }, [
+                adaptor.text(math.math),
+            ]);
+            adaptor.setStyle(text, "position", "absolute");
+            adaptor.setStyle(text, "display", "none");
+            adaptor.setStyle(text, "width", "0");
+            adaptor.setStyle(math.typesetRoot, "position", "relative");
+            adaptor.append(math.typesetRoot, text);
+        }
+    }
+    convert(tex, override) {
+        const node = this.html.convert(tex, {
+            display: !(override?.inline ?? this.option.inline),
+            em: override?.em ?? this.option.em,
+            ex: override?.ex ?? this.option.ex,
+            containerWidth: override?.width ?? this.option.width,
+            scale: 1.0,
+        });
+        if (node instanceof LiteElement) {
+            return this.adaptor.outerHTML(node);
+        }
+        else {
+            return "ERROR";
+        }
+    }
+    stylesheet() {
+        return this.adaptor.textContent(this.chtml.styleSheet(this.html));
+    }
+}

package/lib/math/mdmath.d.ts

@@ -0,0 +1,3 @@
+import type { PluginSimple } from "markdown-it";
+import { MathjaxEngine } from "./mathjax.js";
+export declare function mdmath(math: MathjaxEngine): PluginSimple;

package/lib/math/mdmath.js

@@ -0,0 +1,48 @@
+import katex from "katex";
+import { math_block, math_inline } from "./mdparser.js";
+function getRenderers(mathjax) {
+    function renderInlineMath(tex) {
+        return katex.renderToString(tex, {
+            throwOnError: false,
+            strict: (code, _msg, _token) => {
+                switch (code) {
+                    case "unicodeTextInMathMode":
+                        return "ignore";
+                    default:
+                        return "warn";
+                }
+            },
+        });
+    }
+    function renderBlockMath(tex) {
+        try {
+            const math = mathjax.convert(tex);
+            return "<p>" + math + "</p>";
+        }
+        catch (err) {
+            console.error(err);
+            return tex;
+        }
+    }
+    function inlineRenderer(tokens, index) {
+        return renderInlineMath(tokens[index].content);
+    }
+    function blockRenderer(tokens, index) {
+        return renderBlockMath(tokens[index].content + "\n");
+    }
+    return {
+        inlineRenderer,
+        blockRenderer,
+    };
+}
+export function mdmath(math) {
+    const renderer = getRenderers(math);
+    return (md) => {
+        md.inline.ruler.after("escape", "math_inline", math_inline);
+        md.block.ruler.after("blockquote", "math_block", math_block, {
+            alt: ["paragraph", "reference", "blockquote", "list"],
+        });
+        md.renderer.rules.math_inline = renderer.inlineRenderer;
+        md.renderer.rules.math_block = renderer.blockRenderer;
+    };
+}

package/lib/math/mdparser.d.ts

@@ -0,0 +1,4 @@
+import StateBlock from "markdown-it/lib/rules_block/state_block.mjs";
+import StateInline from "markdown-it/lib/rules_inline/state_inline.mjs";
+export declare function math_inline(state: StateInline, silent: boolean): boolean;
+export declare function math_block(state: StateBlock, start: number, end: number, silent: boolean): boolean;

package/lib/math/mdparser.js

@@ -0,0 +1,124 @@
+function isValidDelim(state, pos) {
+    const max = state.posMax;
+    let can_open = true;
+    let can_close = true;
+    const prevChar = pos > 0 ? state.src.charCodeAt(pos - 1) : -1;
+    const nextChar = pos + 1 <= max ? state.src.charCodeAt(pos + 1) : -1;
+    if (prevChar === 0x20 ||
+        prevChar === 0x09 ||
+        (nextChar >= 0x30 && nextChar <= 0x39)) {
+        can_close = false;
+    }
+    if (nextChar === 0x20 || nextChar === 0x09) {
+        can_open = false;
+    }
+    return {
+        can_open: can_open,
+        can_close: can_close,
+    };
+}
+export function math_inline(state, silent) {
+    let match, token, res, pos;
+    if (state.src[state.pos] !== "$") {
+        return false;
+    }
+    res = isValidDelim(state, state.pos);
+    if (!res.can_open) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos += 1;
+        return true;
+    }
+    const start = state.pos + 1;
+    match = start;
+    while ((match = state.src.indexOf("$", match)) !== -1) {
+        pos = match - 1;
+        while (state.src[pos] === "\\") {
+            pos -= 1;
+        }
+        if ((match - pos) % 2 == 1) {
+            break;
+        }
+        match += 1;
+    }
+    if (match === -1) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos = start;
+        return true;
+    }
+    if (match - start === 0) {
+        if (!silent) {
+            state.pending += "$$";
+        }
+        state.pos = start + 1;
+        return true;
+    }
+    res = isValidDelim(state, match);
+    if (!res.can_close) {
+        if (!silent) {
+            state.pending += "$";
+        }
+        state.pos = start;
+        return true;
+    }
+    if (!silent) {
+        token = state.push("math_inline", "math", 0);
+        token.markup = "$";
+        token.content = state.src.slice(start, match);
+    }
+    state.pos = match + 1;
+    return true;
+}
+export function math_block(state, start, end, silent) {
+    let firstLine;
+    let lastLine;
+    let next;
+    let lastPos;
+    let found = false;
+    let pos = state.bMarks[start] + state.tShift[start];
+    let max = state.eMarks[start];
+    if (pos + 2 > max) {
+        return false;
+    }
+    if (state.src.slice(pos, pos + 2) !== "$$") {
+        return false;
+    }
+    pos += 2;
+    firstLine = state.src.slice(pos, max);
+    if (silent) {
+        return true;
+    }
+    if (firstLine.trim().slice(-2) === "$$") {
+        firstLine = firstLine.trim().slice(0, -2);
+        found = true;
+    }
+    for (next = start; !found;) {
+        next++;
+        if (next >= end) {
+            break;
+        }
+        pos = state.bMarks[next] + state.tShift[next];
+        max = state.eMarks[next];
+        if (pos < max && state.tShift[next] < state.blkIndent) {
+            break;
+        }
+        if (state.src.slice(pos, max).trim().slice(-2) === "$$") {
+            lastPos = state.src.slice(0, max).lastIndexOf("$$");
+            lastLine = state.src.slice(pos, lastPos);
+            found = true;
+        }
+    }
+    state.line = next + 1;
+    const token = state.push("math_block", "math", 0);
+    token.block = true;
+    token.content =
+        (firstLine && firstLine.trim() ? firstLine + "\n" : "") +
+            state.getLines(start + 1, next, state.tShift[start], true) +
+            (lastLine && lastLine.trim() ? lastLine : "");
+    token.map = [start, state.line];
+    token.markup = "$$";
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobapen/markdown",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "A markdown converter for cobapen website",
   "keywords": [
     "markdown"
@@ -8,8 +8,8 @@
   "license": "MIT",
   "author": "yamavol",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "homepage": "https://github.com/cobapen/markdown#readme",
   "bugs": {
     "url": "https://github.com/cobapen/markdown/issues"
@@ -19,8 +19,8 @@
     "url": "git+https://github.com/cobapen/markdown.git"
   },
   "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts"
+    "lib/**/*.js",
+    "lib/**/*.d.ts"
   ],
   "engines": {
     "node": ">=20.11.0 <21 || >=21.2.0"