@pie-element/shared-math-rendering-mathjax 0.1.1-next.4 → 0.1.1-next.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +2 -0
- package/dist/index.js +127 -55
- package/dist/unsupported-page.d.ts +28 -0
- package/package.json +2 -1
package/dist/index.d.ts
CHANGED
|
@@ -17,4 +17,6 @@
|
|
|
17
17
|
*/
|
|
18
18
|
export { createMathjaxRenderer, getMathjaxCssUrls } from './adapter.js';
|
|
19
19
|
export type { MathRenderer, MathRenderingAPI, MathjaxOptions } from './types.js';
|
|
20
|
+
export { MATHJAX_CONFLICT_EVENT, UNSUPPORTED_PAGE_DOCS_URL } from './unsupported-page.js';
|
|
21
|
+
export type { MathjaxConflictCondition, MathjaxConflictDetail } from './unsupported-page.js';
|
|
20
22
|
export { renderMath, wrapMath, unWrapMath, mmlToLatex } from './render-math.js';
|
package/dist/index.js
CHANGED
|
@@ -1,127 +1,199 @@
|
|
|
1
|
+
//#region src/unsupported-page.ts
|
|
2
|
+
var e = "https://github.com/pie-framework/pie-players/blob/develop/docs/item-player/loading-strategies.md#one-mathjax-version-per-page", t = "pie-mathjax-version-conflict", n = Symbol.for("@pie-element/shared-math-rendering-mathjax/unsupported-page");
|
|
3
|
+
function r(r, i) {
|
|
4
|
+
if (typeof window > "u") return;
|
|
5
|
+
let a = globalThis;
|
|
6
|
+
a[n] ??= {
|
|
7
|
+
logged: !1,
|
|
8
|
+
conditions: []
|
|
9
|
+
};
|
|
10
|
+
let o = a[n];
|
|
11
|
+
if (o.conditions.includes(r)) return;
|
|
12
|
+
o.conditions.push(r);
|
|
13
|
+
let s = `[math-rendering] Unsupported page (${r}): ${i}. PIE supports one MathJax major version per page; with MathJax 3 and 4 on one page, math rendering is best effort and may break. See ${e}`;
|
|
14
|
+
o.logged || (o.logged = !0, console.error(s)), window.dispatchEvent(new CustomEvent(t, { detail: {
|
|
15
|
+
condition: r,
|
|
16
|
+
message: s,
|
|
17
|
+
docsUrl: e
|
|
18
|
+
} }));
|
|
19
|
+
}
|
|
20
|
+
function i() {
|
|
21
|
+
let e = window.MathJax?.version;
|
|
22
|
+
return typeof e == "string" && e.startsWith("3.") ? e : void 0;
|
|
23
|
+
}
|
|
24
|
+
//#endregion
|
|
1
25
|
//#region src/adapter.ts
|
|
2
|
-
var
|
|
26
|
+
var a = "https://cdn.jsdelivr.net/npm/mathjax@4.1.3/tex-mml-chtml.js", o = {
|
|
3
27
|
parallelogram: "\\lower.2em{\\Huge\\unicode{x25B1}}",
|
|
4
28
|
overarc: "\\overparen",
|
|
5
29
|
napprox: "\\not\\approx",
|
|
6
30
|
longdiv: "\\enclose{longdiv}",
|
|
7
31
|
abs: ["\\left|#1\\right|", 1]
|
|
8
|
-
},
|
|
32
|
+
}, s = "[math-rendering] using $ is not advisable, please use $$..$$ or \\(...\\)", c = /\\\(|\\\[|\$\$|\\\$|\\begin\{|\\(?:eq)?ref\{/, l = /\\\(|\\\[|\$|\\begin\{|\\(?:eq)?ref\{/, u = /\\embed\{newLine\}\[\]/g, d = [
|
|
9
33
|
["$$", "$$"],
|
|
10
34
|
["$", "$"],
|
|
11
35
|
["\\[", "\\]"],
|
|
12
36
|
["\\(", "\\)"]
|
|
13
|
-
],
|
|
14
|
-
function
|
|
37
|
+
], f = Symbol.for("@pie-element/shared-math-rendering-mathjax/loading"), p = "PIE-MJX-CHTML-styles", m = "MJX-CHTML-styles", h = [m, "MJX-SVG-styles"], g = 201;
|
|
38
|
+
function _(e) {
|
|
39
|
+
let t = [...e.matches("mjx-container") ? [e] : [], ...e.querySelectorAll("mjx-container")];
|
|
40
|
+
for (let e of t) for (let t of [e, ...e.querySelectorAll("[data-latex],[data-latex-item]")]) t.removeAttribute("data-latex"), t.removeAttribute("data-latex-item");
|
|
41
|
+
}
|
|
42
|
+
function v() {
|
|
15
43
|
return window.MathJax;
|
|
16
44
|
}
|
|
17
|
-
function
|
|
45
|
+
function y(e) {
|
|
18
46
|
let t = e.includes("\\displaystyle") ? e.replace("\\displaystyle", "").trim() : e;
|
|
19
|
-
for (let [e, n] of
|
|
47
|
+
for (let [e, n] of d) if (t.startsWith(e) && t.endsWith(n)) return t.substring(e.length, t.length - n.length);
|
|
20
48
|
return t;
|
|
21
49
|
}
|
|
22
|
-
function
|
|
50
|
+
function b(e) {
|
|
23
51
|
for (let t of e.querySelectorAll("[data-latex]")) {
|
|
24
52
|
if (t.dataset.mathHandled || t.closest("mjx-container")) continue;
|
|
25
53
|
let e = t.textContent;
|
|
26
|
-
e && (t.textContent = `\\(${
|
|
54
|
+
e && (t.textContent = `\\(${y(e)}\\)`.replace(u, "\\newline "), t.dataset.mathHandled = "true");
|
|
27
55
|
}
|
|
28
56
|
}
|
|
29
|
-
function
|
|
57
|
+
function x(e, t) {
|
|
30
58
|
for (let t of e.querySelectorAll("math")) if (!t.closest("mjx-assistive-mml")) return !0;
|
|
31
|
-
return (t ?
|
|
59
|
+
return (t ? l : c).test(e.textContent ?? "");
|
|
32
60
|
}
|
|
33
|
-
function
|
|
34
|
-
return new Promise((
|
|
35
|
-
let { useSingleDollar:
|
|
61
|
+
function S(e) {
|
|
62
|
+
return new Promise((t, n) => {
|
|
63
|
+
let { useSingleDollar: r = !1, accessibility: i = !0, loadFonts: c = !0, srcUrl: l } = e, u = {
|
|
36
64
|
loader: {
|
|
37
|
-
load:
|
|
38
|
-
failed: (e) =>
|
|
65
|
+
load: i ? ["a11y/assistive-mml"] : [],
|
|
66
|
+
failed: (e) => n(e)
|
|
39
67
|
},
|
|
40
68
|
startup: {
|
|
41
69
|
typeset: !1,
|
|
42
70
|
ready: () => {
|
|
43
|
-
let e =
|
|
44
|
-
e?.defaultReady?.(), Promise.resolve(
|
|
71
|
+
let e = v(), r = e?.startup, i = !!e?.version?.startsWith("4.");
|
|
72
|
+
i && C(e), r?.defaultReady?.(), i && w(r?.document), Promise.resolve(r?.promise).then(() => t(), n);
|
|
45
73
|
}
|
|
46
74
|
},
|
|
47
|
-
tex: { macros: { ...
|
|
75
|
+
tex: { macros: { ...o } },
|
|
48
76
|
options: {
|
|
49
|
-
enableMenu:
|
|
77
|
+
enableMenu: i,
|
|
50
78
|
menuOptions: { settings: {
|
|
51
|
-
assistiveMml:
|
|
79
|
+
assistiveMml: i,
|
|
52
80
|
enrich: !1,
|
|
53
81
|
inTabOrder: !1
|
|
54
82
|
} }
|
|
55
83
|
}
|
|
56
84
|
};
|
|
57
|
-
|
|
85
|
+
r && u.tex && (console.warn(s), u.tex.inlineMath = [["$", "$"], ["\\(", "\\)"]], u.tex.processEscapes = !0), c || (u.chtml = { fontURL: "" }), window.MathJax = u;
|
|
58
86
|
let d = document.createElement("script");
|
|
59
|
-
d.src = l ||
|
|
87
|
+
d.src = l || a, d.async = !0, d.onerror = () => n(/* @__PURE__ */ Error("Failed to load MathJax")), document.head.appendChild(d);
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
function C(e) {
|
|
91
|
+
let t = e?._?.output?.chtml_ts?.CHTML;
|
|
92
|
+
t && (t.STYLESHEETID = p);
|
|
93
|
+
}
|
|
94
|
+
function w(e) {
|
|
95
|
+
if (!e) return;
|
|
96
|
+
let t = /* @__PURE__ */ new WeakSet(), n = (e) => {
|
|
97
|
+
let n = e.typesetRoot;
|
|
98
|
+
!n || t.has(n) || (_(n), t.add(n));
|
|
99
|
+
};
|
|
100
|
+
e.addRenderAction?.("pie-strip-latex", g, (e) => {
|
|
101
|
+
for (let t of e.math ?? []) n(t);
|
|
102
|
+
return !1;
|
|
103
|
+
}, (e) => {
|
|
104
|
+
let t = e.typesetRoot;
|
|
105
|
+
return t && _(t), !1;
|
|
106
|
+
});
|
|
107
|
+
let r = e.outputJax?.chtmlStyles;
|
|
108
|
+
r?.id === m && (r.id = p), D();
|
|
109
|
+
}
|
|
110
|
+
function T(e) {
|
|
111
|
+
return e instanceof HTMLStyleElement && h.includes(e.id);
|
|
112
|
+
}
|
|
113
|
+
function E(e) {
|
|
114
|
+
r("foreign-output-stylesheet", `another MathJax added <style id="${e.id}"> to <head>`);
|
|
115
|
+
}
|
|
116
|
+
function D() {
|
|
117
|
+
let e = document.head, t = [...e.children].find(T);
|
|
118
|
+
if (t) {
|
|
119
|
+
E(t);
|
|
120
|
+
return;
|
|
121
|
+
}
|
|
122
|
+
let n = new MutationObserver((e) => {
|
|
123
|
+
for (let t of e) {
|
|
124
|
+
let e = [...t.addedNodes].find(T);
|
|
125
|
+
if (e) {
|
|
126
|
+
E(e), n.disconnect();
|
|
127
|
+
return;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
60
130
|
});
|
|
131
|
+
n.observe(e, { childList: !0 });
|
|
61
132
|
}
|
|
62
|
-
function
|
|
133
|
+
function O(e) {
|
|
63
134
|
return new Promise((t, n) => {
|
|
64
135
|
let r = e.startup ?? {};
|
|
65
136
|
e.startup = r;
|
|
66
137
|
let i = r.ready;
|
|
67
138
|
r.ready = () => {
|
|
68
|
-
let e =
|
|
139
|
+
let e = v()?.startup;
|
|
69
140
|
i ? i.call(r) : e?.defaultReady?.(), Promise.resolve(e?.promise).then(() => t(), n);
|
|
70
141
|
};
|
|
71
142
|
});
|
|
72
143
|
}
|
|
73
|
-
function
|
|
74
|
-
let t =
|
|
75
|
-
return t ? t.version ? t.startup?.promise ? Promise.resolve(t.startup.promise).then(() => void 0) : Promise.resolve() :
|
|
144
|
+
function k(e) {
|
|
145
|
+
let t = v();
|
|
146
|
+
return t ? t.version ? t.startup?.promise ? Promise.resolve(t.startup.promise).then(() => void 0) : Promise.resolve() : O(t) : S(e);
|
|
76
147
|
}
|
|
77
|
-
function
|
|
78
|
-
return
|
|
79
|
-
typeof
|
|
148
|
+
function A(e) {
|
|
149
|
+
return k(e).then(() => {
|
|
150
|
+
typeof v()?.typesetPromise != "function" && console.warn("[mathjax-renderer] MathJax on this page has no typesetPromise; math stays untypeset.");
|
|
80
151
|
});
|
|
81
152
|
}
|
|
82
|
-
function
|
|
83
|
-
let t = globalThis, n = t[
|
|
84
|
-
return n || (n =
|
|
153
|
+
function j(e) {
|
|
154
|
+
let t = globalThis, n = t[f];
|
|
155
|
+
return n || (n = A(e), t[f] = n), n;
|
|
85
156
|
}
|
|
86
|
-
function
|
|
157
|
+
function M(e = {}) {
|
|
87
158
|
let t = e.useSingleDollar ?? !1;
|
|
88
159
|
return async (n) => {
|
|
89
160
|
if (typeof window > "u") return;
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
161
|
+
let a = i();
|
|
162
|
+
a && r("mathjax-3-global", `window.MathJax is MathJax ${a}`), b(n);
|
|
163
|
+
let o = j(e);
|
|
164
|
+
if (!x(n, t)) {
|
|
165
|
+
o.catch(() => {});
|
|
94
166
|
return;
|
|
95
167
|
}
|
|
96
|
-
await
|
|
97
|
-
let
|
|
98
|
-
await
|
|
168
|
+
await o;
|
|
169
|
+
let s = v();
|
|
170
|
+
await s?.startup?.promise, typeof s?.typesetPromise == "function" && (await s.typesetPromise([n]), _(n));
|
|
99
171
|
};
|
|
100
172
|
}
|
|
101
|
-
function
|
|
173
|
+
function N() {
|
|
102
174
|
return [];
|
|
103
175
|
}
|
|
104
176
|
//#endregion
|
|
105
177
|
//#region src/render-math.ts
|
|
106
|
-
var
|
|
107
|
-
function
|
|
108
|
-
return !!window[
|
|
178
|
+
var P = "@pie-lib/math-rendering", F = "@pie-lib/math-rendering@2", I = null;
|
|
179
|
+
function L() {
|
|
180
|
+
return !!window[F]?.opts?.useSingleDollar;
|
|
109
181
|
}
|
|
110
|
-
function
|
|
111
|
-
return
|
|
182
|
+
function R() {
|
|
183
|
+
return I ||= M({ useSingleDollar: L() }), I;
|
|
112
184
|
}
|
|
113
|
-
function
|
|
185
|
+
function z() {
|
|
114
186
|
if (typeof window > "u") return null;
|
|
115
|
-
let e = window[
|
|
187
|
+
let e = window[P];
|
|
116
188
|
return typeof e?.renderMath == "function" ? e : null;
|
|
117
189
|
}
|
|
118
|
-
var
|
|
190
|
+
var B = async (e) => {
|
|
119
191
|
if (typeof window > "u") return;
|
|
120
192
|
let t = typeof e == "string", n;
|
|
121
193
|
t ? (n = document.createElement("div"), n.innerHTML = e) : n = e || document.body;
|
|
122
|
-
let r =
|
|
123
|
-
return r ? await r.renderMath?.(n) : await
|
|
124
|
-
},
|
|
194
|
+
let r = z();
|
|
195
|
+
return r ? await r.renderMath?.(n) : await R()(n), t ? n.innerHTML : void 0;
|
|
196
|
+
}, V = (e) => z()?.wrapMath?.(e) ?? e, H = (e) => {
|
|
125
197
|
let t = e.trim();
|
|
126
198
|
return t.startsWith("\\[") && t.endsWith("\\]") ? {
|
|
127
199
|
unwrapped: t.slice(2, -2).trim(),
|
|
@@ -148,6 +220,6 @@ var w = async (e) => {
|
|
|
148
220
|
close: "$"
|
|
149
221
|
}
|
|
150
222
|
} : { unwrapped: t };
|
|
151
|
-
},
|
|
223
|
+
}, U = (e) => z()?.mmlToLatex?.(e) ?? e;
|
|
152
224
|
//#endregion
|
|
153
|
-
export {
|
|
225
|
+
export { t as MATHJAX_CONFLICT_EVENT, e as UNSUPPORTED_PAGE_DOCS_URL, M as createMathjaxRenderer, N as getMathjaxCssUrls, U as mmlToLatex, B as renderMath, H as unWrapMath, V as wrapMath };
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reporting for pages that run MathJax 3 beside this adapter's MathJax 4. PIE supports one
|
|
3
|
+
* MathJax major version per page; on a mixed page rendering is best effort, and the developer
|
|
4
|
+
* learns why from the console and from {@link MATHJAX_CONFLICT_EVENT}.
|
|
5
|
+
*/
|
|
6
|
+
export declare const UNSUPPORTED_PAGE_DOCS_URL = "https://github.com/pie-framework/pie-players/blob/develop/docs/item-player/loading-strategies.md#one-mathjax-version-per-page";
|
|
7
|
+
/**
|
|
8
|
+
* Dispatched on `window` once per condition per page, with a {@link MathjaxConflictDetail}.
|
|
9
|
+
* Hosts and players forward it to their instrumentation.
|
|
10
|
+
*/
|
|
11
|
+
export declare const MATHJAX_CONFLICT_EVENT = "pie-mathjax-version-conflict";
|
|
12
|
+
export type MathjaxConflictCondition =
|
|
13
|
+
/** `window.MathJax` is a MathJax 3 build. */
|
|
14
|
+
'mathjax-3-global'
|
|
15
|
+
/** Another MathJax output stylesheet was added to `<head>` beside this adapter's. */
|
|
16
|
+
| 'foreign-output-stylesheet';
|
|
17
|
+
export interface MathjaxConflictDetail {
|
|
18
|
+
condition: MathjaxConflictCondition;
|
|
19
|
+
message: string;
|
|
20
|
+
docsUrl: string;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Logs one `console.error` per page, for the first condition seen, and dispatches
|
|
24
|
+
* {@link MATHJAX_CONFLICT_EVENT} once for each condition.
|
|
25
|
+
*/
|
|
26
|
+
export declare function reportUnsupportedPage(condition: MathjaxConflictCondition, detail: string): void;
|
|
27
|
+
/** The version of `window.MathJax` when it is a MathJax 3 build. */
|
|
28
|
+
export declare function mathjax3Version(): string | undefined;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pie-element/shared-math-rendering-mathjax",
|
|
3
|
-
"version": "0.1.1-next.
|
|
3
|
+
"version": "0.1.1-next.6",
|
|
4
4
|
"description": "MathJax adapter for PIE math rendering",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"build": "rm -rf dist tsconfig.tsbuildinfo && vite build && tsc --emitDeclarationOnly",
|
|
19
19
|
"dev": "vite build --watch",
|
|
20
20
|
"test": "vitest",
|
|
21
|
+
"test:e2e": "playwright test",
|
|
21
22
|
"clean": "rm -rf dist"
|
|
22
23
|
},
|
|
23
24
|
"dependencies": {},
|