@liqvid/katex 0.0.5 → 1.0.0-alpha.0

package/dist/esm/RenderGroup.js

@@ -0,0 +1,75 @@
+import { recursiveMap, usePromise } from "@liqvid/utils/react";
+import { usePlayer } from "liqvid";
+import React, { cloneElement, forwardRef, isValidElement, useEffect, useImperativeHandle, useRef, } from "react";
+import { KTX } from "./fancy";
+import { Handle as KTXHandle, KTX as KTXPlain } from "./plain";
+/**
+ * Wait for several things to be rendered
+ */
+export const RenderGroup = forwardRef(function RenderGroup(props, ref) {
+    const [ready, resolve] = usePromise();
+    // handle
+    useImperativeHandle(ref, () => ({ ready }));
+    const elements = useRef([]);
+    const promises = useRef([]);
+    // reparsing
+    const player = usePlayer();
+    useEffect(() => {
+        // promises
+        Promise.all(promises.current).then(() => {
+            // reparse
+            if (props.reparse) {
+                player.reparseTree(leastCommonAncestor(elements.current));
+            }
+            // ready()
+            resolve();
+        });
+    }, []);
+    return recursiveMap(props.children, (node) => {
+        if (shouldInspect(node)) {
+            const originalRef = node.ref;
+            return cloneElement(node, {
+                ref: (ref) => {
+                    if (!ref)
+                        return;
+                    elements.current.push(ref.domElement);
+                    promises.current.push(ref.ready);
+                    // pass along original ref
+                    if (typeof originalRef === "function") {
+                        originalRef(ref);
+                    }
+                    else if (originalRef && typeof originalRef === "object") {
+                        originalRef.current = ref;
+                    }
+                },
+            });
+        }
+        return node;
+    });
+});
+/**
+ * Determine whether the node is a <KTX> element
+ * @param node Element to check
+ */
+function shouldInspect(node) {
+    return (isValidElement(node) &&
+        typeof node.type === "object" &&
+        (node.type === KTX || node.type === KTXPlain));
+}
+/**
+ * Find least common ancestor of an array of elements
+ * @param elements Elements
+ * @returns Deepest node containing all passed elements
+ */
+function leastCommonAncestor(elements) {
+    if (elements.length === 0) {
+        throw new Error("Must pass at least one element");
+    }
+    let ancestor = elements[0];
+    let failing = elements.slice(1);
+    while (failing.length > 0) {
+        ancestor = ancestor.parentElement;
+        failing = failing.filter((node) => !ancestor.contains(node));
+    }
+    return ancestor;
+}

package/dist/esm/component.js

@@ -0,0 +1,85 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { combineRefs } from "@liqvid/utils";
+import katex from "katex";
+import { useEffect, useRef, useState } from "react";
+import { useKaTeXContext } from "./context";
+/** Component for KaTeX code */
+export const KTX = function KTX({ children, ref: propRef, 
+// katex options
+colorIsTextColor, displayMode, errorColor, fleqn, globalGroup, leqno, macros, maxExpand, maxSize, minRuleThickness, output, strict, throwOnError, trust, ...props }) {
+    const ref = useRef(null);
+    const defaults = useKaTeXContext();
+    const isFirstRender = useFirstRender();
+    useEffect(() => {
+        if (!ref.current)
+            return;
+        // needed for initial client render
+        isFirstRender;
+        katex.render(children, ref.current, {
+            colorIsTextColor: colorIsTextColor ?? defaults.colorIsTextColor,
+            displayMode: displayMode,
+            errorColor: errorColor ?? defaults.errorColor,
+            fleqn: fleqn ?? defaults.fleqn,
+            globalGroup: globalGroup ?? defaults.globalGroup,
+            leqno: leqno ?? defaults.leqno,
+            macros: macros ?? defaults.macros,
+            maxExpand: maxExpand ?? defaults.maxExpand,
+            maxSize: maxSize ?? defaults.maxSize,
+            minRuleThickness: minRuleThickness ?? defaults.minRuleThickness,
+            output: output ?? defaults.output,
+            strict: strict ?? defaults.strict,
+            throwOnError: throwOnError ?? defaults.throwOnError,
+            trust: trust ?? defaults.trust,
+        });
+    }, [
+        children,
+        defaults,
+        isFirstRender,
+        // katex options
+        colorIsTextColor,
+        displayMode,
+        errorColor,
+        fleqn,
+        globalGroup,
+        leqno,
+        macros,
+        maxExpand,
+        maxSize,
+        minRuleThickness,
+        output,
+        strict,
+        throwOnError,
+        trust,
+    ]);
+    // ensure that it is server-rendered
+    if (isFirstRender) {
+        const tex = katex.renderToString(children, {
+            colorIsTextColor: colorIsTextColor ?? defaults.colorIsTextColor,
+            displayMode: displayMode,
+            errorColor: errorColor ?? defaults.errorColor,
+            fleqn: fleqn ?? defaults.fleqn,
+            globalGroup: globalGroup ?? defaults.globalGroup,
+            leqno: leqno ?? defaults.leqno,
+            macros: macros ?? defaults.macros,
+            maxExpand: maxExpand ?? defaults.maxExpand,
+            maxSize: maxSize ?? defaults.maxSize,
+            minRuleThickness: minRuleThickness ?? defaults.minRuleThickness,
+            output: output ?? defaults.output,
+            strict: strict ?? defaults.strict,
+            throwOnError: throwOnError ?? defaults.throwOnError,
+            trust: trust ?? defaults.trust,
+        });
+        return (_jsx("span", { dangerouslySetInnerHTML: {
+                __html: tex,
+            }, ref: combineRefs(ref, propRef), ...props }));
+    }
+    return _jsx("span", { ref: combineRefs(ref, propRef), ...props });
+};
+function useFirstRender() {
+    const [isFirstRender, setFirstRender] = useState(true);
+    useEffect(() => {
+        setFirstRender(false);
+    }, []);
+    return isFirstRender;
+}

package/dist/esm/context.js

@@ -0,0 +1,47 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { parseMacros } from "./macros";
+const KaTeXContext = createContext({});
+export function useKaTeXContext() {
+    return useContext(KaTeXContext);
+}
+export function KaTeXProvider({ children, colorIsTextColor, displayMode, errorColor, fleqn, globalGroup, leqno, macros, maxExpand, maxSize, minRuleThickness, output, strict = "ignore", throwOnError = false, trust = true, }) {
+    const context = useMemo(() => {
+        if (typeof macros === "string") {
+            macros = parseMacros(macros);
+        }
+        return {
+            colorIsTextColor,
+            displayMode,
+            errorColor,
+            fleqn,
+            globalGroup,
+            leqno,
+            macros,
+            maxExpand,
+            maxSize,
+            minRuleThickness,
+            output,
+            strict,
+            throwOnError,
+            trust,
+        };
+    }, [
+        colorIsTextColor,
+        displayMode,
+        errorColor,
+        fleqn,
+        globalGroup,
+        leqno,
+        macros,
+        maxExpand,
+        maxSize,
+        minRuleThickness,
+        output,
+        strict,
+        throwOnError,
+        trust,
+    ]);
+    return (_jsx(KaTeXContext.Provider, { value: context, children: children }));
+}

package/dist/esm/fancy.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { combineRefs } from "@liqvid/utils/react";
+import { usePlayer } from "liqvid";
+import { forwardRef, useEffect, useRef } from "react";
+import { Handle, KTX as KTXPlain } from "./plain";
+/** Component for KaTeX code */
+export const KTX = forwardRef(function KTX(props, ref) {
+    const { obstruct = "canplay canplaythrough", reparse = false, ...attrs } = props;
+    const plain = useRef();
+    const combined = combineRefs(plain, ref);
+    const player = usePlayer();
+    useEffect(() => {
+        // obstruction
+        if (obstruct.match(/\bcanplay\b/)) {
+            player.obstruct("canplay", plain.current.ready);
+        }
+        if (obstruct.match("canplaythrough")) {
+            player.obstruct("canplaythrough", plain.current.ready);
+        }
+        // reparsing
+        if (reparse) {
+            plain.current.ready.then(() => player.reparseTree(plain.current.domElement));
+        }
+    }, []);
+    return _jsx(KTXPlain, { ref: combined, ...attrs });
+});

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { KTX } from "./component";
+export { KaTeXProvider } from "./context";
+export { parseMacros } from "./macros";

package/dist/esm/loading.js

@@ -0,0 +1,64 @@
+// option of loading KaTeX asynchronously
+const KaTeXLoad = new Promise((resolve) => {
+    const script = document.querySelector('script[src*="katex.js"], script[src*="katex.min.js"]');
+    if (!script)
+        return;
+    if (window.hasOwnProperty("katex")) {
+        resolve(katex);
+    }
+    else {
+        script.addEventListener("load", () => resolve(katex));
+    }
+});
+// load macros from <head>
+const KaTeXMacros = new Promise((resolve) => {
+    const macros = {};
+    const scripts = Array.from(document.querySelectorAll("head > script[type='math/tex']"));
+    return Promise.all(scripts.map((script) => fetch(script.src)
+        .then((res) => {
+        if (res.ok)
+            return res.text();
+        throw new Error(`${res.status} ${res.statusText}: ${script.src}`);
+    })
+        .then((tex) => {
+        Object.assign(macros, parseMacros(tex));
+    }))).then(() => resolve(macros));
+});
+/**
+ * Ready Promise
+ */
+export const KaTeXReady = Promise.all([KaTeXLoad, KaTeXMacros]);
+/**
+ * Parse \newcommand macros in a file.
+ * Also supports \ktxnewcommand (for use in conjunction with MathJax).
+ * @param file TeX file to parse
+ */
+function parseMacros(file) {
+    const macros = {};
+    const rgx = /\\(?:ktx)?newcommand\{(.+?)\}(?:\[\d+\])?\{/g;
+    let match;
+    while ((match = rgx.exec(file))) {
+        let body = "";
+        const macro = match[1];
+        let braceCount = 1;
+        for (let i = match.index + match[0].length; braceCount > 0 && i < file.length; ++i) {
+            const char = file[i];
+            if (char === "{") {
+                braceCount++;
+            }
+            else if (char === "}") {
+                braceCount--;
+                if (braceCount === 0)
+                    break;
+            }
+            else if (char === "\\") {
+                body += file.slice(i, i + 2);
+                ++i;
+                continue;
+            }
+            body += char;
+        }
+        macros[macro] = body;
+    }
+    return macros;
+}

package/dist/esm/macros.js

@@ -0,0 +1,35 @@
+/**
+ * Parse \newcommand macros in a file.
+ * Also supports \ktxnewcommand (for use in conjunction with MathJax).
+ * @param file TeX file to parse
+ */
+export function parseMacros(file) {
+    const macros = {};
+    const rgx = /\\(?:ktx)?newcommand\{(.+?)\}(?:\[\d+\])?\{/g;
+    let match;
+    // biome-ignore lint/suspicious/noAssignInExpressions: this is fine
+    while ((match = rgx.exec(file))) {
+        let body = "";
+        const macro = match[1];
+        let braceCount = 1;
+        for (let i = match.index + match[0].length; braceCount > 0 && i < file.length; ++i) {
+            const char = file[i];
+            if (char === "{") {
+                braceCount++;
+            }
+            else if (char === "}") {
+                braceCount--;
+                if (braceCount === 0)
+                    break;
+            }
+            else if (char === "\\") {
+                body += file.slice(i, i + 2);
+                ++i;
+                continue;
+            }
+            body += char;
+        }
+        macros[macro] = body;
+    }
+    return macros;
+}

package/dist/esm/plain.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePromise } from "@liqvid/utils/react";
+import { forwardRef, useEffect, useImperativeHandle, useRef } from "react";
+import { KaTeXReady } from "./loading";
+/** Component for KaTeX code */
+export const KTX = forwardRef(function KTX(props, ref) {
+    const spanRef = useRef();
+    const { children, display = false, ...attrs } = props;
+    const [ready, resolve] = usePromise();
+    // handle
+    useImperativeHandle(ref, () => ({
+        domElement: spanRef.current,
+        ready,
+    }));
+    useEffect(() => {
+        KaTeXReady.then(([katex, macros]) => {
+            katex.render(children.toString(), spanRef.current, {
+                displayMode: !!display,
+                macros,
+                strict: "ignore",
+                throwOnError: false,
+                trust: true,
+            });
+            /* move katex into placeholder element */
+            const child = spanRef.current.firstElementChild;
+            // copy classes
+            for (let i = 0, len = child.classList.length; i < len; ++i) {
+                spanRef.current.classList.add(child.classList.item(i));
+            }
+            // move children
+            while (child.childNodes.length > 0) {
+                spanRef.current.appendChild(child.firstChild);
+            }
+            // delete child
+            child.remove();
+            // resolve promise
+            resolve();
+        });
+    }, [children]);
+    // Google Chrome fails without this
+    if (display) {
+        if (!attrs.style)
+            attrs.style = {};
+        attrs.style.display = "block";
+    }
+    return _jsx("span", { ...attrs, ref: spanRef });
+});

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"fileNames":["../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2016.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2021.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.dom.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.core.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2016.array.include.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2016.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.date.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.object.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.string.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.promise.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2018.regexp.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.array.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.object.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.string.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.symbol.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2019.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.bigint.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.date.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.promise.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.string.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2020.number.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2021.promise.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2021.string.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2021.weakref.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2021.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.array.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.error.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.intl.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.object.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.string.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.regexp.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.d.ts","../../../node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/lib/lib.decorators.legacy.d.ts","../../../node_modules/.pnpm/@types+react@19.2.14/node_modules/@types/react/global.d.ts","../../../node_modules/.pnpm/csstype@3.2.3/node_modules/csstype/index.d.ts","../../../node_modules/.pnpm/@types+react@19.2.14/node_modules/@types/react/index.d.ts","../../../node_modules/.pnpm/@types+react@19.2.14/node_modules/@types/react/jsx-runtime.d.ts","../../duration/dist/types/index.d.mts","../../../node_modules/.pnpm/bezier-easing@2.1.0/node_modules/bezier-easing/src/index.d.ts","../../utils/dist/types/replay-data.d.ts","../../utils/dist/types/animation.d.ts","../../utils/dist/types/collections.d.ts","../../utils/dist/types/interaction.d.ts","../../utils/dist/types/math.d.ts","../../utils/dist/types/misc.d.ts","../../utils/dist/types/react.d.ts","../../utils/dist/types/svg.d.ts","../../utils/dist/types/time.d.ts","../../utils/dist/types/types.d.ts","../../utils/dist/types/index.d.ts","../../../node_modules/.pnpm/katex@0.16.28/node_modules/katex/types/katex.d.ts","../src/macros.ts","../src/context.tsx","../src/component.tsx","../src/index.ts","../../../node_modules/.pnpm/@types+katex@0.16.8/node_modules/@types/katex/index.d.ts"],"fileIdsList":[[60,61],[62],[62,63,76,77,79],[62,63,78],[63,78,79,80],[63],[64,65,66],[66,67,68,69,70,71,72,73,74,75],[69],[64]],"fileInfos":[{"version":"c430d44666289dae81f30fa7b2edebf186ecc91a2d4c71266ea6ae76388792e1","affectsGlobalScope":true,"impliedFormat":1},{"version":"45b7ab580deca34ae9729e97c13cfd999df04416a79116c3bfb483804f85ded4","impliedFormat":1},{"version":"3facaf05f0c5fc569c5649dd359892c98a85557e3e0c847964caeb67076f4d75","impliedFormat":1},{"version":"e44bb8bbac7f10ecc786703fe0a6a4b952189f908707980ba8f3c8975a760962","impliedFormat":1},{"version":"5e1c4c362065a6b95ff952c0eab010f04dcd2c3494e813b493ecfd4fcb9fc0d8","impliedFormat":1},{"version":"68d73b4a11549f9c0b7d352d10e91e5dca8faa3322bfb77b661839c42b1ddec7","impliedFormat":1},{"version":"5efce4fc3c29ea84e8928f97adec086e3dc876365e0982cc8479a07954a3efd4","impliedFormat":1},{"version":"feecb1be483ed332fad555aff858affd90a48ab19ba7272ee084704eb7167569","impliedFormat":1},{"version":"ee7bad0c15b58988daa84371e0b89d313b762ab83cb5b31b8a2d1162e8eb41c2","impliedFormat":1},{"version":"080941d9f9ff9307f7e27a83bcd888b7c8270716c39af943532438932ec1d0b9","affectsGlobalScope":true,"impliedFormat":1},{"version":"2e80ee7a49e8ac312cc11b77f1475804bee36b3b2bc896bead8b6e1266befb43","affectsGlobalScope":true,"impliedFormat":1},{"version":"c57796738e7f83dbc4b8e65132f11a377649c00dd3eee333f672b8f0a6bea671","affectsGlobalScope":true,"impliedFormat":1},{"version":"dc2df20b1bcdc8c2d34af4926e2c3ab15ffe1160a63e58b7e09833f616efff44","affectsGlobalScope":true,"impliedFormat":1},{"version":"515d0b7b9bea2e31ea4ec968e9edd2c39d3eebf4a2d5cbd04e88639819ae3b71","affectsGlobalScope":true,"impliedFormat":1},{"version":"0559b1f683ac7505ae451f9a96ce4c3c92bdc71411651ca6ddb0e88baaaad6a3","affectsGlobalScope":true,"impliedFormat":1},{"version":"0dc1e7ceda9b8b9b455c3a2d67b0412feab00bd2f66656cd8850e8831b08b537","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce691fb9e5c64efb9547083e4a34091bcbe5bdb41027e310ebba8f7d96a98671","affectsGlobalScope":true,"impliedFormat":1},{"version":"8d697a2a929a5fcb38b7a65594020fcef05ec1630804a33748829c5ff53640d0","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ff2a353abf8a80ee399af572debb8faab2d33ad38c4b4474cff7f26e7653b8d","affectsGlobalScope":true,"impliedFormat":1},{"version":"fb0f136d372979348d59b3f5020b4cdb81b5504192b1cacff5d1fbba29378aa1","affectsGlobalScope":true,"impliedFormat":1},{"version":"d15bea3d62cbbdb9797079416b8ac375ae99162a7fba5de2c6c505446486ac0a","affectsGlobalScope":true,"impliedFormat":1},{"version":"68d18b664c9d32a7336a70235958b8997ebc1c3b8505f4f1ae2b7e7753b87618","affectsGlobalScope":true,"impliedFormat":1},{"version":"eb3d66c8327153d8fa7dd03f9c58d351107fe824c79e9b56b462935176cdf12a","affectsGlobalScope":true,"impliedFormat":1},{"version":"38f0219c9e23c915ef9790ab1d680440d95419ad264816fa15009a8851e79119","affectsGlobalScope":true,"impliedFormat":1},{"version":"69ab18c3b76cd9b1be3d188eaf8bba06112ebbe2f47f6c322b5105a6fbc45a2e","affectsGlobalScope":true,"impliedFormat":1},{"version":"a680117f487a4d2f30ea46f1b4b7f58bef1480456e18ba53ee85c2746eeca012","affectsGlobalScope":true,"impliedFormat":1},{"version":"2f11ff796926e0832f9ae148008138ad583bd181899ab7dd768a2666700b1893","affectsGlobalScope":true,"impliedFormat":1},{"version":"4de680d5bb41c17f7f68e0419412ca23c98d5749dcaaea1896172f06435891fc","affectsGlobalScope":true,"impliedFormat":1},{"version":"954296b30da6d508a104a3a0b5d96b76495c709785c1d11610908e63481ee667","affectsGlobalScope":true,"impliedFormat":1},{"version":"ac9538681b19688c8eae65811b329d3744af679e0bdfa5d842d0e32524c73e1c","affectsGlobalScope":true,"impliedFormat":1},{"version":"0a969edff4bd52585473d24995c5ef223f6652d6ef46193309b3921d65dd4376","affectsGlobalScope":true,"impliedFormat":1},{"version":"9e9fbd7030c440b33d021da145d3232984c8bb7916f277e8ffd3dc2e3eae2bdb","affectsGlobalScope":true,"impliedFormat":1},{"version":"811ec78f7fefcabbda4bfa93b3eb67d9ae166ef95f9bff989d964061cbf81a0c","affectsGlobalScope":true,"impliedFormat":1},{"version":"717937616a17072082152a2ef351cb51f98802fb4b2fdabd32399843875974ca","affectsGlobalScope":true,"impliedFormat":1},{"version":"d7e7d9b7b50e5f22c915b525acc5a49a7a6584cf8f62d0569e557c5cfc4b2ac2","affectsGlobalScope":true,"impliedFormat":1},{"version":"71c37f4c9543f31dfced6c7840e068c5a5aacb7b89111a4364b1d5276b852557","affectsGlobalScope":true,"impliedFormat":1},{"version":"576711e016cf4f1804676043e6a0a5414252560eb57de9faceee34d79798c850","affectsGlobalScope":true,"impliedFormat":1},{"version":"89c1b1281ba7b8a96efc676b11b264de7a8374c5ea1e6617f11880a13fc56dc6","affectsGlobalScope":true,"impliedFormat":1},{"version":"74f7fa2d027d5b33eb0471c8e82a6c87216223181ec31247c357a3e8e2fddc5b","affectsGlobalScope":true,"impliedFormat":1},{"version":"d6d7ae4d1f1f3772e2a3cde568ed08991a8ae34a080ff1151af28b7f798e22ca","affectsGlobalScope":true,"impliedFormat":1},{"version":"063600664504610fe3e99b717a1223f8b1900087fab0b4cad1496a114744f8df","affectsGlobalScope":true,"impliedFormat":1},{"version":"934019d7e3c81950f9a8426d093458b65d5aff2c7c1511233c0fd5b941e608ab","affectsGlobalScope":true,"impliedFormat":1},{"version":"52ada8e0b6e0482b728070b7639ee42e83a9b1c22d205992756fe020fd9f4a47","affectsGlobalScope":true,"impliedFormat":1},{"version":"3bdefe1bfd4d6dee0e26f928f93ccc128f1b64d5d501ff4a8cf3c6371200e5e6","affectsGlobalScope":true,"impliedFormat":1},{"version":"59fb2c069260b4ba00b5643b907ef5d5341b167e7d1dbf58dfd895658bda2867","affectsGlobalScope":true,"impliedFormat":1},{"version":"639e512c0dfc3fad96a84caad71b8834d66329a1f28dc95e3946c9b58176c73a","affectsGlobalScope":true,"impliedFormat":1},{"version":"368af93f74c9c932edd84c58883e736c9e3d53cec1fe24c0b0ff451f529ceab1","affectsGlobalScope":true,"impliedFormat":1},{"version":"af3dd424cf267428f30ccfc376f47a2c0114546b55c44d8c0f1d57d841e28d74","affectsGlobalScope":true,"impliedFormat":1},{"version":"995c005ab91a498455ea8dfb63aa9f83fa2ea793c3d8aa344be4a1678d06d399","affectsGlobalScope":true,"impliedFormat":1},{"version":"959d36cddf5e7d572a65045b876f2956c973a586da58e5d26cde519184fd9b8a","affectsGlobalScope":true,"impliedFormat":1},{"version":"965f36eae237dd74e6cca203a43e9ca801ce38824ead814728a2807b1910117d","affectsGlobalScope":true,"impliedFormat":1},{"version":"3925a6c820dcb1a06506c90b1577db1fdbf7705d65b62b99dce4be75c637e26b","affectsGlobalScope":true,"impliedFormat":1},{"version":"0a3d63ef2b853447ec4f749d3f368ce642264246e02911fcb1590d8c161b8005","affectsGlobalScope":true,"impliedFormat":1},{"version":"8cdf8847677ac7d20486e54dd3fcf09eda95812ac8ace44b4418da1bbbab6eb8","affectsGlobalScope":true,"impliedFormat":1},{"version":"8444af78980e3b20b49324f4a16ba35024fef3ee069a0eb67616ea6ca821c47a","affectsGlobalScope":true,"impliedFormat":1},{"version":"3287d9d085fbd618c3971944b65b4be57859f5415f495b33a6adc994edd2f004","affectsGlobalScope":true,"impliedFormat":1},{"version":"b4b67b1a91182421f5df999988c690f14d813b9850b40acd06ed44691f6727ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"8e7f8264d0fb4c5339605a15daadb037bf238c10b654bb3eee14208f860a32ea","affectsGlobalScope":true,"impliedFormat":1},{"version":"782dec38049b92d4e85c1585fbea5474a219c6984a35b004963b00beb1aab538","affectsGlobalScope":true,"impliedFormat":1},{"version":"7e29f41b158de217f94cb9676bf9cbd0cd9b5a46e1985141ed36e075c52bf6ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"ac51dd7d31333793807a6abaa5ae168512b6131bd41d9c5b98477fc3b7800f9f","impliedFormat":1},{"version":"dc0a7f107690ee5cd8afc8dbf05c4df78085471ce16bdd9881642ec738bc81fe","impliedFormat":1},{"version":"42c169fb8c2d42f4f668c624a9a11e719d5d07dacbebb63cbcf7ef365b0a75b3","impliedFormat":1},{"version":"6f2dfeeb74d340004f68f576add21aac0668ae1da4c4e9ba3193541f3e865867","impliedFormat":99},{"version":"5e221d7876afbd3b808798515c5dd53d49e8aa4fe4c6095bc6760b30acff4b37","impliedFormat":1},"3ec9f283a3eb75a2fb4a89467a97ae6d13d3cd7589dadb5e1e5b59a875e6f6c9","fc7857b603145340e3bdd87e48603b1dbee90bcdee7d4d08006b40c613cdcd4e","06f5a3f26c2c2dddab05df1375db0a6353efa4bcd818d53e0bbde7b94024d732",{"version":"8005021af1514f4193c860c4b7eeb2f01f660c443c2f7180f2c93aed44af3b16","affectsGlobalScope":true},"2b0dafed8302e979ebbee421ac05e790ee5621457a264cb1b8e76ef3afd72f3b","7f8b57b8dd275f27fc63e58f9f0d608054060cd7f2d57a3bc53653c39f6326e3","a5910106a85d7077f899ee12fb89fed65a3b8aaa444a314a0e1480a29f4e67b8","69eaf11c5a8479bc92d32da085bfb9cba8ca6884366b4941369a4d24a27992c6","eca06e9eb6ebd0a81decc4d04aa1d0df7a2e6cb4588c3059269321c9e0fecc09","239f3c704fc87252b5dd00f70e35bc57af83a33e20a3ad71d14c3d2d99c3b4a4","3db60448ebc41502a9869dd39a4a6a3682ca9b5fcb8297399676fea8c88b7678",{"version":"5bb37c8ed3d343ae525902e64be52edbc1ce0a5ad86ca2201118c0d8168078e5","impliedFormat":1},{"version":"04daa14a7096f21f0bd4cce3d03b334d936e9171887bf54726d27cb8a40617c1","signature":"07fbf982cc4f8de23b1a36da934e268ddfcc29b536d87bb6e66ddee1d65d728e"},{"version":"fcdab0036032c5ec6b9d0dd5bf45d5227171dd3949fbf04cecbe4dd01cc144d2","signature":"4116da3cb2ef452323b10b8759b5585d3b4aee337440742743106a0a11f660f3"},{"version":"55d9af754a8f252f8a58f61f62c27b8fbd81770e2039cbc51d61e960bd0459d9","signature":"665cad1d49d7d95b1cc6627d1adb840433b4ff5f58b629b5f905fc3e36d38008"},"5348fc7edceeb42a436a769d8a8434fd0af1f87a88a4141662009b126a05ef7b",{"version":"8cbbb12bfb321de8bd58ba74329f683d82e4e0abb56d998c7f1eef2e764a74c8","impliedFormat":1}],"root":[[78,81]],"options":{"alwaysStrict":true,"composite":true,"declaration":true,"declarationDir":"./types","esModuleInterop":true,"jsx":4,"module":99,"noImplicitAny":true,"noImplicitOverride":true,"noUncheckedIndexedAccess":false,"outDir":"./esm","removeComments":false,"rewriteRelativeImportExtensions":true,"rootDir":"../src","skipLibCheck":true,"strict":true,"target":9,"verbatimModuleSyntax":true},"referencedMap":[[62,1],[63,2],[80,3],[79,4],[81,5],[78,6],[67,7],[76,8],[72,9],[74,10]],"latestChangedDtsFile":"./types/index.d.ts","version":"5.9.3"}

package/dist/types/RenderGroup.d.ts

@@ -0,0 +1,19 @@
+import React from "react";
+/** RenderGroup element API */
+interface Handle {
+    /** Promise that resolves once all KTX descendants have finished typesetting */
+    ready: Promise<void>;
+}
+interface Props {
+    children?: React.ReactNode;
+    /**
+     * Whether to reparse descendants for `during()` and `from()`
+     * @default false
+     */
+    reparse?: boolean;
+}
+/**
+ * Wait for several things to be rendered
+ */
+export declare const RenderGroup: React.ForwardRefExoticComponent<Props & React.RefAttributes<Handle>>;
+export {};

package/dist/types/component.d.ts

@@ -0,0 +1,4 @@
+/** Component for KaTeX code */
+export declare const KTX: ({ children, ref: propRef, colorIsTextColor, displayMode, errorColor, fleqn, globalGroup, leqno, macros, maxExpand, maxSize, minRuleThickness, output, strict, throwOnError, trust, ...props }: katex.KatexOptions & React.JSX.IntrinsicElements["span"] & {
+    children: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/types/context.d.ts

@@ -0,0 +1,5 @@
+export declare function useKaTeXContext(): import("katex").KatexOptions;
+export declare function KaTeXProvider({ children, colorIsTextColor, displayMode, errorColor, fleqn, globalGroup, leqno, macros, maxExpand, maxSize, minRuleThickness, output, strict, throwOnError, trust, }: {
+    children?: React.ReactNode;
+    macros?: string | Record<string, string>;
+} & katex.KatexOptions): import("react/jsx-runtime").JSX.Element;

package/dist/types/fancy.d.ts

@@ -0,0 +1,16 @@
+import { Handle, KTX as KTXPlain } from "./plain";
+interface Props extends React.ComponentProps<typeof KTXPlain> {
+    /**
+     * Player events to obstruct
+     * @default "canplay canplaythrough"
+     */
+    obstruct?: string;
+    /**
+     * Whether to reparse descendants for `during()` and `from()`
+     * @default false
+     */
+    reparse?: boolean;
+}
+/** Component for KaTeX code */
+export declare const KTX: import("react").ForwardRefExoticComponent<Omit<Props, "ref"> & import("react").RefAttributes<Handle>>;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { KTX } from "./component";
+export { KaTeXProvider } from "./context";
+export { parseMacros } from "./macros";

package/dist/types/loading.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Ready Promise
+ */
+export declare const KaTeXReady: Promise<any>;

package/dist/types/macros.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse \newcommand macros in a file.
+ * Also supports \ktxnewcommand (for use in conjunction with MathJax).
+ * @param file TeX file to parse
+ */
+export declare function parseMacros(file: string): Record<string, string>;

package/dist/{plain.d.ts → types/plain.d.ts}

@@ -1,10 +1,7 @@
-/// <reference types="react" />
-import * as react from 'react';
-
 /**
  * KTX element API
  */
-interface Handle {
+export interface Handle {
     /** The underlying <span> element */
     domElement: HTMLSpanElement;
     /** Promise that resolves once typesetting is finished */
@@ -18,6 +15,5 @@ interface Props extends React.HTMLAttributes<HTMLSpanElement> {
     display?: boolean;
 }
 /** Component for KaTeX code */
-declare const KTX: react.ForwardRefExoticComponent<Props & react.RefAttributes<Handle>>;
-
-export { Handle, KTX };
+export declare const KTX: import("react").ForwardRefExoticComponent<Props & import("react").RefAttributes<Handle>>;
+export {};

package/package.json

@@ -1,24 +1,20 @@
 {
   "name": "@liqvid/katex",
-  "version": "0.0.5",
+  "version": "1.0.0-alpha.0",
   "description": "KaTeX integration for Liqvid",
   "files": [
     "dist/*"
   ],
   "exports": {
     ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    },
-    "./plain": {
-      "import": "./dist/plain.mjs",
-      "require": "./dist/plain.cjs"
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
     }
   },
   "typesVersions": {
     "*": {
       "*": [
-        "./dist/*.d.ts"
+        "./dist/types/*.d.ts"
       ]
     }
   },
@@ -36,28 +32,34 @@
   },
   "homepage": "https://github.com/liqvidjs/liqvid/tree/main/packages/katex",
   "license": "MIT",
+  "dependencies": {
+    "@liqvid/utils": "^2.0.0-alpha.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.8",
+    "@types/react": "^19",
+    "typescript": "^5.9",
+    "@liqvid/player": "^1.0.0-alpha.1"
+  },
   "peerDependencies": {
-    "@types/katex": "^0.11.1",
-    "@types/react": ">=17.0.0",
-    "liqvid": "^2.1.4",
-    "react": ">=17.0.0"
+    "katex": ">=0.16",
+    "@types/react": ">=18",
+    "@liqvid/player": "^1.0.0-alpha.0",
+    "react": ">=18"
   },
   "peerDependenciesMeta": {
-    "liqvid": {
+    "@liqvid/player": {
       "optional": true
     }
   },
-  "devDependencies": {
-    "liqvid": "^2.1.4"
-  },
-  "dependencies": {
-    "@liqvid/utils": "^1.3.0"
-  },
+  "sideEffects": false,
+  "type": "module",
   "scripts": {
     "build": "pnpm build:clean && pnpm build:js && pnpm build:postclean",
     "build:clean": "rm -rf dist",
-    "build:js": "tsc && node ../../build.mjs && rollup -c",
-    "build:postclean": "rm -rf dist/esm dist/types dist/tsconfig.tsbuildinfo",
-    "lint": "eslint --ext ts,tsx --fix src"
+    "build:js": "tsc",
+    "build:postclean": "rm dist/tsconfig.tsbuildinfo",
+    "lint": "biome check --fix",
+    "watch": "tsc --watch"
   }
 }