@temelj/mdx 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Flinect
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+<p align="center">
+  <h1 align="center" style="text-decoration:none;">@temelj/mdx</h1>
+  <br/>
+  <p align="center">
+    Utilities for working with MDX.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://twitter.com/tinrab" rel="nofollow"><img src="https://img.shields.io/badge/created%20by-@tinrab-1d9bf0.svg" alt="Created by Tin Rabzelj"></a>
+  <a href="https://jsr.io/@temelj/mdx" rel="nofollow"><img src="https://jsr.io/badges/@temelj/mdx" alt="jsr"></a>
+  <a href="https://opensource.org/licenses/MIT" rel="nofollow"><img src="https://img.shields.io/github/license/flinect/temelj" alt="License"></a>
+</p>
+
+<div align="center">
+  <a href="https://jsr.io/@temelj/mdx">jsr</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://www.npmjs.com/package/@temelj/mdx">npm</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://github.com/flinect/temelj/issues/new">Issues</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://twitter.com/tinrab">@tinrab</a>
+  <br />
+</div>
+
+<br/>
+<br/>
+
+# Installation
+
+```sh
+# npm
+$ npm install @temelj/mdx
+# jsr
+$ deno add jsr:@temelj/mdx # or jsr add @temelj/mdx
+```
+
+# About
+
+This package is part of [Temelj](https://github.com/flinect/temelj) - a big
+standard library for TypeScript.

package/esm/compiler.js

@@ -0,0 +1,71 @@
+import { compile as compileMdxJs, } from "@mdx-js/mdx";
+import remarkFrontmatterPlugin from "remark-frontmatter";
+import remarkGfmPlugin from "remark-gfm";
+import { VFile } from "vfile";
+import { matter } from "vfile-matter";
+export { remarkFrontmatterPlugin, remarkGfmPlugin };
+export class MdxCompiler {
+    constructor(mdxOptions = {}) {
+        Object.defineProperty(this, "mdxOptions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "remarkPlugins", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "rehypePlugins", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.mdxOptions = mdxOptions;
+        this.remarkPlugins = [remarkFrontmatterPlugin, remarkGfmPlugin];
+        this.rehypePlugins = [];
+    }
+    withRemarkPlugin(plugin, options) {
+        if (options === undefined) {
+            this.remarkPlugins.push(plugin);
+        }
+        else {
+            this.remarkPlugins.push([plugin, options]);
+        }
+        return this;
+    }
+    withRehypePlugin(plugin, options) {
+        if (options === undefined) {
+            this.rehypePlugins.push(plugin);
+        }
+        else {
+            this.rehypePlugins.push([plugin, options]);
+        }
+        return this;
+    }
+    async compile(source, { frontmatterOnly = false, mdxOptions } = {}) {
+        const vfile = new VFile({
+            value: source,
+            // Needed so vfile doesn't access fs
+            cwd: "/",
+            path: "/",
+            message: {},
+            messages: {},
+        });
+        matter(vfile, { strip: true });
+        let compiled;
+        if (!frontmatterOnly) {
+            compiled = await compileMdxJs(vfile, {
+                remarkPlugins: this.remarkPlugins,
+                rehypePlugins: this.rehypePlugins,
+                outputFormat: "function-body",
+                ...(this.mdxOptions ?? {}),
+                ...(mdxOptions ?? {}),
+            });
+        }
+        return { compiled, frontmatter: (vfile.data.matter ?? {}) };
+    }
+}

package/esm/mod.js

@@ -0,0 +1,3 @@
+export * from "./plugins/mod.js";
+export * from "./types.js";
+export * from "./compiler.js";

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/plugins/heading-id/plugin.js

@@ -0,0 +1,21 @@
+import GithubSlugger from "github-slugger";
+import { toString as hastToString } from "hast-util-to-string";
+import { visit } from "unist-util-visit";
+/**
+ * A rehype plugin that adds IDs to heading tags.
+ */
+export function headingIdPlugin({ prefix, } = {}) {
+    const slugger = new GithubSlugger();
+    return (tree) => {
+        slugger.reset();
+        visit(tree, "element", visitor);
+        function visitor(node, index, parent) {
+            if (!parent || index === null || !node.tagName.startsWith("h")) {
+                return;
+            }
+            const id = (prefix ?? "") + slugger.slug(hastToString(node));
+            node.properties.id = id;
+        }
+        return tree;
+    };
+}

package/esm/plugins/mod.js

@@ -0,0 +1,4 @@
+export * from "./heading-id/plugin.js";
+export * from "./syntax-highlight/plugin.js";
+export * from "./tree-processor/plugin.js";
+export * from "./remove-imports-exports.js";

package/esm/plugins/remove-imports-exports.js

@@ -0,0 +1,10 @@
+import { remove } from "unist-util-remove";
+/**
+ * A remark plugin which removes all import and export statements.
+ */
+export function removeImportsExportsPlugin() {
+    return (tree) => {
+        remove(tree, "mdxjsEsm");
+        return tree;
+    };
+}

package/esm/plugins/syntax-highlight/code-meta.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { parseNumericRange } from "@temelj/iterator";
+export function extractCodeMeta(node) {
+    const meta = node?.data?.meta ?? node?.properties?.metastring ?? "";
+    return parseMetaString(meta);
+}
+const metaSchema = z.object({
+    highlight: z.string().optional(),
+    showLineNumbers: z.boolean().default(false),
+    commandLine: z.string().optional(),
+    fileName: z.string().optional(),
+});
+function parseMetaString(meta) {
+    let raw;
+    try {
+        raw = JSON.parse(meta.trim());
+    }
+    catch {
+        return {};
+    }
+    const parsed = metaSchema.parse(raw);
+    const options = {};
+    if (parsed.highlight !== undefined) {
+        options.highlight = { lineRange: parseNumericRange(parsed.highlight) };
+    }
+    if (parsed.showLineNumbers !== undefined) {
+        if (typeof parsed.showLineNumbers === "string") {
+            options.showLineNumbers = {
+                lineRange: parseNumericRange(parsed.showLineNumbers),
+            };
+        }
+        else if (parsed.showLineNumbers) {
+            options.showLineNumbers = { lineRange: [] };
+        }
+    }
+    if (parsed.commandLine !== undefined) {
+        if (typeof parsed.commandLine === "string") {
+            options.commandLine = {
+                commandRange: parseNumericRange(parsed.commandLine),
+            };
+        }
+        else if (parsed.commandLine) {
+            options.commandLine = { commandRange: [] };
+        }
+    }
+    if (typeof parsed.fileName === "string") {
+        options.fileName = parsed.fileName.trim();
+    }
+    return options;
+}

package/esm/plugins/syntax-highlight/plugin.js

@@ -0,0 +1,106 @@
+import { toString as hastToString } from "hast-util-to-string";
+import { codeToHast, } from "shiki";
+import { visit } from "unist-util-visit";
+import { transformerNotationHighlight, } from "@shikijs/transformers";
+import { numericRangeContains } from "@temelj/iterator";
+import { extractCodeMeta } from "./code-meta.js";
+export function syntaxHighlightPlugin(options = {}) {
+    return async (tree) => {
+        const promises = [];
+        async function visitor(node, index, parent) {
+            if (!parent || index === null || node.tagName !== "pre") {
+                return;
+            }
+            const codeNode = node.children[0];
+            if (!codeNode ||
+                codeNode.type !== "element" ||
+                codeNode.tagName !== "code" ||
+                !codeNode.properties) {
+                return;
+            }
+            const lang = getNodeLanguage(codeNode);
+            if (typeof lang !== "string") {
+                return;
+            }
+            const meta = extractCodeMeta(codeNode);
+            const sourceCode = hastToString(codeNode).trim();
+            const hastOptions = {
+                tokenizeTimeLimit: 10_000,
+                lang,
+                themes: {
+                    light: "github-light-default",
+                    dark: "github-dark-default",
+                },
+                ...(options.shikiCodeToHastOptions ?? {}),
+            };
+            if (hastOptions.transformers === undefined) {
+                hastOptions.transformers = [];
+            }
+            if (options.highlight) {
+                hastOptions.transformers.push(transformerNotationHighlight(options.highlight.transformer));
+            }
+            hastOptions.transformers.push({
+                code(node) {
+                    if (options.languageClassNamePrefix) {
+                        this.addClassToHast(node, `${options.languageClassNamePrefix}${lang}`);
+                    }
+                    let lineNumber = 1;
+                    for (const line of node.children.filter((node) => node.type === "element")) {
+                        line.properties["data-line"] = lineNumber;
+                        if (options.highlight) {
+                            if (meta.highlight &&
+                                numericRangeContains(meta.highlight.lineRange, lineNumber)) {
+                                this.addClassToHast(line, options.highlight.transformer?.classActiveLine ??
+                                    "highlighted");
+                            }
+                        }
+                        if (options.lineNumbers &&
+                            meta.showLineNumbers &&
+                            (meta.showLineNumbers.lineRange.length === 0 ||
+                                numericRangeContains(meta.showLineNumbers.lineRange, lineNumber))) {
+                            this.addClassToHast(line, options.lineNumbers.className ?? "line-number");
+                        }
+                        if (options.commandLine &&
+                            meta.commandLine &&
+                            numericRangeContains(meta.commandLine.commandRange, lineNumber)) {
+                            this.addClassToHast(line, options.commandLine.className ?? "line-command");
+                        }
+                        lineNumber++;
+                    }
+                    if (meta.showLineNumbers) {
+                        if (typeof node.properties.style !== "string") {
+                            node.properties.style = "";
+                        }
+                        node.properties.style += `--${options.lineNumbers?.widthVariableName ?? "line-number-width"}:${1 + Math.floor(Math.log10(this.lines.length))}ch;`;
+                    }
+                },
+            });
+            const hast = await codeToHast(sourceCode, hastOptions);
+            // Insert highlighted code into parent
+            const hastPre = hast.children[0];
+            parent.children.splice(index, 1, {
+                ...hastPre,
+                properties: {
+                    ...hastPre.properties,
+                    dataFileName: meta.fileName,
+                },
+            });
+        }
+        visit(tree, "element", (node, index, parent) => {
+            promises.push(visitor(node, index, parent));
+        });
+        await Promise.all(promises);
+        return tree;
+    };
+}
+function getNodeLanguage(node) {
+    if (!Array.isArray(node.properties.className)) {
+        return undefined;
+    }
+    const prefix = "language-";
+    const language = node.properties.className.find((name) => typeof name === "string" && name.startsWith(prefix));
+    if (typeof language === "string") {
+        return language.slice(prefix.length);
+    }
+    return language;
+}

package/esm/plugins/tree-processor/plugin.js

@@ -0,0 +1,16 @@
+import { visit } from "unist-util-visit";
+export function treeProcessorPlugin({ process } = { process: () => { } }) {
+    return async (tree) => {
+        const promises = [];
+        function visitElement(node, index, parent) {
+            const p = process(node, index, parent);
+            if (p instanceof Promise ||
+                Object.prototype.toString.call(p) === "[object Promise]") {
+                promises.push(p);
+            }
+        }
+        visit(tree, "element", visitElement);
+        await Promise.allSettled(promises);
+        return tree;
+    };
+}

package/esm/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@temelj/mdx",
+  "version": "0.1.5",
+  "description": "Utilities for working with MDX.",
+  "keywords": [
+    "mdx"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flinect/temelj.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/flinect/temelj/issues"
+  },
+  "module": "./esm/mod.js",
+  "types": "./types/mod.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./types/mod.d.ts",
+        "default": "./esm/mod.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@mdx-js/mdx": "^3.1.0",
+    "@shikijs/transformers": "^1.23.1",
+    "github-slugger": "^2.0.0",
+    "hast": "^1.0.0",
+    "hast-util-to-string": "^3.0.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "shiki": "^1.23.1",
+    "unified": "^11.0.5",
+    "unist-util-remove": "^4.0.0",
+    "unist-util-visit": "^5.0.0",
+    "vfile": "^6.0.3",
+    "vfile-matter": "^5.0.0",
+    "zod": "^3.23.8",
+    "@temelj/iterator": "^0.2.0",
+    "@types/hast": "^3.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/types/compiler.d.ts

@@ -0,0 +1,25 @@
+import { type CompileOptions as MdxJsCompileOptions } from "@mdx-js/mdx";
+import remarkFrontmatterPlugin from "remark-frontmatter";
+import remarkGfmPlugin from "remark-gfm";
+import { VFile } from "vfile";
+import type { PluginFactory } from "./types.js";
+export { remarkFrontmatterPlugin, remarkGfmPlugin };
+export type MdxSource = string | Uint8Array;
+export interface MdxCompileOptions {
+    frontmatterOnly?: boolean | undefined;
+    mdxOptions?: MdxJsCompileOptions;
+}
+export interface MdxArtifact<TFrontmatter = Record<string, unknown>> {
+    compiled?: VFile | undefined;
+    frontmatter: TFrontmatter;
+}
+export declare class MdxCompiler {
+    private readonly mdxOptions;
+    private readonly remarkPlugins;
+    private readonly rehypePlugins;
+    constructor(mdxOptions?: MdxCompileOptions);
+    withRemarkPlugin<TOptions>(plugin: (options?: TOptions) => PluginFactory, options?: TOptions): MdxCompiler;
+    withRehypePlugin<TOptions>(plugin: (options?: TOptions) => PluginFactory, options?: TOptions): MdxCompiler;
+    compile<TFrontmatter = Record<string, unknown>>(source: MdxSource, { frontmatterOnly, mdxOptions }?: MdxCompileOptions): Promise<MdxArtifact<TFrontmatter>>;
+}
+//# sourceMappingURL=compiler.d.ts.map

package/types/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,IAAI,mBAAmB,EAC3C,MAAM,aAAa,CAAC;AACrB,OAAO,uBAAuB,MAAM,oBAAoB,CAAC;AACzD,OAAO,eAAe,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAI9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,WAAW,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAG5C,UAAU,GAAE,iBAAsB;IAO7B,gBAAgB,CAAC,QAAQ,EAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,aAAa,EAC7C,OAAO,CAAC,EAAE,QAAQ,GACjB,WAAW;IASP,gBAAgB,CAAC,QAAQ,EAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,aAAa,EAC7C,OAAO,CAAC,EAAE,QAAQ,GACjB,WAAW;IASD,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,SAAS,EACjB,EAAE,eAAuB,EAAE,UAAU,EAAE,GAAE,iBAAsB,GAC9D,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;CAwBtC"}

package/types/mod.d.ts

@@ -0,0 +1,4 @@
+export * from "./plugins/mod.js";
+export * from "./types.js";
+export * from "./compiler.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/types/plugins/heading-id/plugin.d.ts

@@ -0,0 +1,13 @@
+import type { PluginFactory } from "../../types.js";
+/**
+ * Options for {@linkcode headingIdPlugin}.
+ */
+export interface HeadingIdPluginOptions {
+    /** Prefix for title slugs. */
+    prefix?: string;
+}
+/**
+ * A rehype plugin that adds IDs to heading tags.
+ */
+export declare function headingIdPlugin({ prefix, }?: HeadingIdPluginOptions): PluginFactory;
+//# sourceMappingURL=plugin.d.ts.map

package/types/plugins/heading-id/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/heading-id/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAyB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,GACP,GAAE,sBAA2B,GAAG,aAAa,CAuB7C"}

package/types/plugins/mod.d.ts

@@ -0,0 +1,5 @@
+export * from "./heading-id/plugin.js";
+export * from "./syntax-highlight/plugin.js";
+export * from "./tree-processor/plugin.js";
+export * from "./remove-imports-exports.js";
+//# sourceMappingURL=mod.d.ts.map

package/types/plugins/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/plugins/mod.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/types/plugins/remove-imports-exports.d.ts

@@ -0,0 +1,6 @@
+import type { PluginFactory } from "../types.js";
+/**
+ * A remark plugin which removes all import and export statements.
+ */
+export declare function removeImportsExportsPlugin(): PluginFactory;
+//# sourceMappingURL=remove-imports-exports.d.ts.map

package/types/plugins/remove-imports-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-imports-exports.d.ts","sourceRoot":"","sources":["../../src/plugins/remove-imports-exports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CAK1D"}

package/types/plugins/syntax-highlight/code-meta.d.ts

@@ -0,0 +1,19 @@
+import { type NumericRange } from "@temelj/iterator";
+import type { HastElement } from "../../types.js";
+export interface MdxCodeMeta {
+    highlight?: MdxCodeMetaHighlightLine;
+    showLineNumbers?: MdxCodeMetaLineNumbers;
+    commandLine?: MdxCodeMetaCommandLine;
+    fileName?: string;
+}
+export type MdxCodeMetaHighlightLine = {
+    lineRange: NumericRange;
+};
+export type MdxCodeMetaLineNumbers = {
+    lineRange: NumericRange;
+};
+export type MdxCodeMetaCommandLine = {
+    commandRange: NumericRange;
+};
+export declare function extractCodeMeta(node: HastElement): MdxCodeMeta;
+//# sourceMappingURL=code-meta.d.ts.map

package/types/plugins/syntax-highlight/code-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-meta.d.ts","sourceRoot":"","sources":["../../../src/plugins/syntax-highlight/code-meta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,wBAAwB,CAAC;IACrC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAG9D"}

package/types/plugins/syntax-highlight/plugin.d.ts

@@ -0,0 +1,24 @@
+import { type BundledLanguage, type BundledTheme, type CodeToHastOptions } from "shiki";
+import { type TransformerNotationHighlightOptions } from "@shikijs/transformers";
+import type { PluginFactory } from "../../types.js";
+type ShikiCodeToHastOptions = Partial<CodeToHastOptions<BundledLanguage, BundledTheme>>;
+/**
+ * Options for {@linkcode syntaxHighlightPlugin}.
+ */
+export interface SyntaxHighlightPluginOptions {
+    languageClassNamePrefix?: string;
+    highlight?: {
+        transformer?: TransformerNotationHighlightOptions;
+    };
+    lineNumbers?: {
+        widthVariableName?: string;
+        className?: string;
+    };
+    commandLine?: {
+        className?: string;
+    };
+    shikiCodeToHastOptions?: ShikiCodeToHastOptions;
+}
+export declare function syntaxHighlightPlugin(options?: SyntaxHighlightPluginOptions): PluginFactory;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/types/plugins/syntax-highlight/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/syntax-highlight/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAyB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG3E,KAAK,sBAAsB,GAAG,OAAO,CACnC,iBAAiB,CAAC,eAAe,EAAE,YAAY,CAAC,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,mCAAmC,CAAC;KACnD,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACjD;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,aAAa,CAqJf"}

package/types/plugins/tree-processor/plugin.d.ts

@@ -0,0 +1,12 @@
+import type { HastElement, PluginFactory } from "../../types.js";
+export type MdxTreeProcessor = (node: HastElement, index: number, parent: HastElement) => void | Promise<void>;
+/**
+ * Options for {@linkcode treeProcessorPlugin}.
+ */
+type TreeProcessorPluginOptions = {
+    /** The processor. */
+    process: MdxTreeProcessor;
+};
+export declare function treeProcessorPlugin({ process }?: TreeProcessorPluginOptions): PluginFactory;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/types/plugins/tree-processor/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/tree-processor/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAY,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,KAAK,0BAA0B,GAAG;IAChC,qBAAqB;IACrB,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,EAAE,OAAO,EAAE,GAAE,0BAAkD,GAC9D,aAAa,CAuBf"}

package/types/types.d.ts

@@ -0,0 +1,7 @@
+import type { Element, Node } from "hast";
+import type { CompileResults, Processor } from "unified";
+export type { Element as HastElement, Node as HastNode };
+type MaybePromise<T> = T | Promise<T> | PromiseLike<T>;
+type Plugin<TParameters extends unknown[] = [], TInput extends string | Node | undefined = Node, TOutput = TInput> = (this: Processor, ...parameters: TParameters) => MaybePromise<TInput extends string ? TOutput extends Node | undefined ? undefined | void : never : TOutput extends CompileResults ? TInput extends Node | undefined ? undefined | void : never : Transformer<TInput extends Node ? TInput : Node, TOutput extends Node ? TOutput : Node> | undefined | void>;
+export type PluginFactory<TParameters extends unknown[] = [], TInput extends string | Node | undefined = Node, TOutput = TInput> = (parameters?: TParameters) => MaybePromise<Plugin<TParameters, TInput, TOutput>>;
+//# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,IAAI,IAAI,QAAQ,EAAE,CAAC;AAEzD,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEvD,KAAK,MAAM,CACT,WAAW,SAAS,OAAO,EAAE,GAAG,EAAE,EAClC,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EAC/C,OAAO,GAAG,MAAM,IACd,CACF,IAAI,EAAE,SAAS,EACf,GAAG,UAAU,EAAE,WAAW,KACvB,YAAY,CACf,MAAM,SAAS,MAAM,GAAG,OAAO,SAAS,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,GACvE,KAAK,GACL,OAAO,SAAS,cAAc,GAC5B,MAAM,SAAS,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,GAClD,KAAK,GAEL,WAAW,CACX,MAAM,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI,EACnC,OAAO,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,CACtC,GACC,SAAS,GACT,IAAI,CACX,CAAC;AAEF,MAAM,MAAM,aAAa,CACvB,WAAW,SAAS,OAAO,EAAE,GAAG,EAAE,EAClC,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EAC/C,OAAO,GAAG,MAAM,IACd,CACF,UAAU,CAAC,EAAE,WAAW,KACrB,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}