@ox-content/unplugin 2.90.0 → 3.0.0-alpha.10

package/dist/index.d.mts

@@ -277,11 +277,24 @@ interface OxContentOptions {
    * @default true
    */
   gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expressions.
+   *
+   * When omitted, MDX is enabled for `.mdx` files only. Explicit `true` or
+   * `false` overrides extension-based detection.
+   * @default inferred from the source extension
+   */
+  mdx?: boolean;
   /**
    * Enable footnotes.
    * @default true
    */
   footnotes?: boolean;
+  /**
+   * Render footnotes as a semantic ordered section with numeric markers.
+   * @default false
+   */
+  semanticFootnotes?: boolean;
   /**
    * Enable tables.
    * @default true
@@ -302,11 +315,6 @@ interface OxContentOptions {
    * @default false
    */
   highlight?: boolean;
-  /**
-   * Syntax highlighting theme.
-   * @default 'github-dark'
-   */
-  highlightTheme?: string;
   /**
    * Opt-in line annotations for fenced code blocks.
    *
@@ -327,6 +335,13 @@ interface OxContentOptions {
    * @default false
    */
   mermaid?: boolean;
+  /**
+   * Enable `$…$` inline and `$$…$$` block math.
+   * @default false
+   */
+  math?: boolean | {
+    enabled?: boolean;
+  };
   /**
    * Parse YAML frontmatter.
    * @default true
@@ -392,14 +407,17 @@ interface ResolvedDocsConfig {
 interface ResolvedOptions {
   srcDir: string;
   gfm: boolean;
+  mdx?: boolean;
   footnotes: boolean;
+  /** Present after `resolveOptions`. Omitted in hand-built fixtures means off. */
+  semanticFootnotes?: boolean;
   tables: boolean;
   taskLists: boolean;
   strikethrough: boolean;
   highlight: boolean;
-  highlightTheme: string;
   codeAnnotations: ResolvedCodeAnnotationsOptions;
   mermaid: boolean;
+  math: boolean;
   frontmatter: boolean;
   toc: boolean;
   tocMaxDepth: number;
@@ -448,6 +466,11 @@ interface OxContentMdastOptions {
    * @default true
    */
   gfm?: boolean;
+  /**
+   * Enable MDX JSX, ESM, and expression nodes.
+   * @default false
+   */
+  mdx?: boolean;
   /**
    * Enable footnotes.
    * @default true

package/dist/src.mjs

@@ -86,6 +86,11 @@ const KIND_DELETE = 19;
 const KIND_FOOTNOTE_REFERENCE = 20;
 const KIND_DEFINITION = 21;
 const KIND_FOOTNOTE_DEFINITION = 22;
+const KIND_MDX_JSX_FLOW = 23;
+const KIND_MDX_JSX_TEXT = 24;
+const KIND_MDX_ESM = 25;
+const KIND_MDX_FLOW_EXPRESSION = 26;
+const KIND_MDX_TEXT_EXPRESSION = 27;
 const FLAG_ORDERED = 1;
 const FLAG_SPREAD = 2;
 const FLAG_CHECKED_PRESENT = 4;
@@ -309,6 +314,35 @@ function deserializeMdastFromRaw(buffer, source) {
 				if (str1 !== void 0) node.label = str1;
 				return node;
 			}
+			case KIND_MDX_JSX_FLOW: return {
+				type: "mdxJsxFlowElement",
+				name: str0 ?? null,
+				attributes: parseMdxAttributes(str1),
+				children: children ?? [],
+				position
+			};
+			case KIND_MDX_JSX_TEXT: return {
+				type: "mdxJsxTextElement",
+				name: str0 ?? null,
+				attributes: parseMdxAttributes(str1),
+				children: children ?? [],
+				position
+			};
+			case KIND_MDX_ESM: return {
+				type: "mdxjsEsm",
+				value: str0 ?? "",
+				position
+			};
+			case KIND_MDX_FLOW_EXPRESSION: return {
+				type: "mdxFlowExpression",
+				value: str0 ?? "",
+				position
+			};
+			case KIND_MDX_TEXT_EXPRESSION: return {
+				type: "mdxTextExpression",
+				value: str0 ?? "",
+				position
+			};
 			default: throw new Error(`[ox-content] Unsupported mdast raw node kind: ${kind}`);
 		}
 	};
@@ -316,6 +350,17 @@ function deserializeMdastFromRaw(buffer, source) {
 	if (root.type !== "root" || !Array.isArray(root.children)) throw new Error("[ox-content] Native parser returned an invalid mdast root.");
 	return root;
 }
+function parseMdxAttributes(value) {
+	if (value === void 0) return [];
+	let attributes;
+	try {
+		attributes = JSON.parse(value);
+	} catch {
+		throw new Error("[ox-content] mdast raw transfer contains invalid MDX attributes.");
+	}
+	if (!Array.isArray(attributes)) throw new Error("[ox-content] mdast raw transfer contains invalid MDX attributes.");
+	return attributes;
+}
 function readSourceOrigin(buffer, view) {
 	const section = parseTransferEnvelope(buffer)?.sections.get(MDAST_SECTION_SOURCE_ORIGIN$1);
 	if (!section) return;
@@ -451,6 +496,7 @@ const require$1 = createRequire(import.meta.url);
 let cachedNapiBindings$1;
 const DEFAULT_MDAST_OPTIONS = {
 	gfm: true,
+	mdx: false,
 	footnotes: true,
 	taskLists: true,
 	tables: true,
@@ -483,6 +529,7 @@ function parseMarkdownToMdast(source, options = {}) {
 	const resolvedOptions = resolveMdastOptions(options);
 	const parserOptions = {
 		gfm: resolvedOptions.gfm,
+		mdx: resolvedOptions.mdx,
 		footnotes: resolvedOptions.footnotes,
 		taskLists: resolvedOptions.taskLists,
 		tables: resolvedOptions.tables,
@@ -550,6 +597,7 @@ function requireNapiMethod$1(method, name) {
 function resolveMdastOptions(options) {
 	return {
 		gfm: options.gfm ?? DEFAULT_MDAST_OPTIONS.gfm,
+		mdx: options.mdx ?? DEFAULT_MDAST_OPTIONS.mdx,
 		footnotes: options.footnotes ?? DEFAULT_MDAST_OPTIONS.footnotes,
 		taskLists: options.taskLists ?? DEFAULT_MDAST_OPTIONS.taskLists,
 		tables: options.tables ?? DEFAULT_MDAST_OPTIONS.tables,
@@ -590,6 +638,21 @@ function slugify$1(text) {
 	return text.toLowerCase().replace(/[^\p{L}\p{N}\s-]+/gu, " ").trim().split(/\s+/).filter(Boolean).join("-");
 }
 //#endregion
+//#region src/source-path.ts
+function sourcePathname(id) {
+	return id.split("?")[0].split("#")[0];
+}
+function isConfiguredSourceFile(id, extensions) {
+	const pathname = sourcePathname(id).toLowerCase();
+	return extensions.some((extension) => pathname.endsWith(extension.toLowerCase()));
+}
+function isMdxSourceFile(id) {
+	return sourcePathname(id).toLowerCase().endsWith(".mdx");
+}
+function resolveMdxForSourceFile(id, configured) {
+	return configured ?? isMdxSourceFile(id);
+}
+//#endregion
 //#region src/transform.ts
 /**
 * Markdown transformation logic for @ox-content/unplugin.
@@ -612,7 +675,7 @@ const PREPARED_SOURCE_SECTION_SOURCE_ORIGIN = 3;
 * Note: This requires the @ox-content/napi package to be built.
 */
 async function transformMarkdown(source, filePath, options) {
-	const transformed = hasMarkdownItPlugins(options) ? await transformWithMarkdownIt(source, filePath, options) : hasUnifiedPlugins(options) ? await transformWithUnified(source, filePath, options) : transformWithNativePipeline(loadNapiBindings(), source, options);
+	const transformed = hasMarkdownItPlugins(options) ? await transformWithMarkdownIt(source, filePath, options) : hasUnifiedPlugins(options) ? await transformWithUnified(source, filePath, options) : transformWithNativePipeline(loadNapiBindings(), source, filePath, options);
 	let nextHtml = transformed.html;
 	for (const plugin of options.plugin.oxContent) nextHtml = await plugin(nextHtml);
 	return {
@@ -633,14 +696,16 @@ function loadNapiBindings() {
 		throw new Error("[ox-content] Failed to load @ox-content/napi. Please ensure the NAPI module is built. Run: mise run build:napi");
 	}
 }
-function createNapiTransformOptions(options) {
+function createNapiTransformOptions(options, filePath) {
 	const codeAnnotations = options.codeAnnotations ?? {
 		enabled: false,
 		metaKey: "annotate"
 	};
 	return {
 		gfm: options.gfm,
+		mdx: resolveMdxForSourceFile(filePath, options.mdx),
 		footnotes: options.footnotes,
+		semanticFootnotes: options.semanticFootnotes,
 		taskLists: options.taskLists,
 		tables: options.tables,
 		strikethrough: options.strikethrough,
@@ -648,7 +713,8 @@ function createNapiTransformOptions(options) {
 		frontmatter: options.frontmatter,
 		tocMaxDepth: options.tocMaxDepth,
 		codeAnnotations: codeAnnotations.enabled,
-		codeAnnotationMetaKey: codeAnnotations.metaKey
+		codeAnnotationMetaKey: codeAnnotations.metaKey,
+		math: options.math
 	};
 }
 function parseFrontmatterJson(json) {
@@ -672,8 +738,8 @@ function hasMarkdownItPlugins(options) {
 function hasMdastOrRemarkPlugins(options) {
 	return options.plugin.mdast.length > 0 || options.plugin.remark.length > 0;
 }
-function transformWithNativePipeline(napi, source, options) {
-	const result = napi.transform(source, createNapiTransformOptions(options));
+function transformWithNativePipeline(napi, source, filePath, options) {
+	const result = napi.transform(source, createNapiTransformOptions(options, filePath));
 	if (result.errors.length > 0) console.warn("[ox-content] Transform warnings:", result.errors);
 	const flatToc = result.toc.map((item) => ({
 		...item,
@@ -685,8 +751,8 @@ function transformWithNativePipeline(napi, source, options) {
 		toc: options.toc ? buildTocTree(flatToc) : []
 	};
 }
-function transformWithNativeMdastPipeline(napi, source, options) {
-	return deserializeNativeMdastTransform(requireNapiMethod(napi.transformMdastRaw, "transformMdastRaw")(source, createNapiTransformOptions(options)));
+function transformWithNativeMdastPipeline(napi, source, filePath, options) {
+	return deserializeNativeMdastTransform(requireNapiMethod(napi.transformMdastRaw, "transformMdastRaw")(source, createNapiTransformOptions(options, filePath)));
 }
 function deserializeNativeMdastTransform(buffer) {
 	const envelope = parseTransferEnvelope(buffer);
@@ -781,7 +847,7 @@ async function transformWithUnified(fullSource, filePath, options) {
 	const { plugins: remarkPlugins, options: remarkRehypeOptions } = extractUnifiedPluginWithOptions(options.plugin.remark, remarkRehype);
 	const { plugins: rehypePlugins, options: rehypeStringifyOptions } = extractUnifiedPluginWithOptions(options.plugin.rehype, rehypeStringify);
 	const parserStrategy = detectUnifiedParserStrategy(fullSource, filePath, options, remarkPlugins);
-	const nativePayload = parserStrategy === "native" ? transformWithNativeMdastPipeline(loadNapiBindings(), fullSource, options) : null;
+	const nativePayload = parserStrategy === "native" ? transformWithNativeMdastPipeline(loadNapiBindings(), fullSource, filePath, options) : null;
 	const preparedInput = parserStrategy === "native" ? null : prepareSourceWithRust(loadNapiBindings(), fullSource, options);
 	const markdownContent = nativePayload?.content ?? preparedInput?.content ?? fullSource;
 	const frontmatter = nativePayload?.frontmatter ?? preparedInput?.frontmatter ?? {};
@@ -790,7 +856,7 @@ async function transformWithUnified(fullSource, filePath, options) {
 	const processor = unified();
 	applyUnifiedPlugins(processor, options.plugin.mdast.map((plugin) => isOxContentMdastPlugin(plugin) ? toUnifiedMdastPlugin(plugin, mdastContext) : plugin));
 	applyUnifiedPlugins(processor, remarkPlugins);
-	installUnifiedParser(processor, parserStrategy, options, nativePayload?.tree);
+	installUnifiedParser(processor, parserStrategy, options, filePath, nativePayload?.tree);
 	let toc = [];
 	processor.use(() => {
 		return (tree) => {
@@ -867,7 +933,7 @@ function applyMarkdownItPlugins(markdownIt, plugins) {
 function isOxContentMdastPlugin(plugin) {
 	return Boolean(plugin) && typeof plugin === "object" && "transform" in plugin;
 }
-function installUnifiedParser(processor, strategy, options, nativeTree) {
+function installUnifiedParser(processor, strategy, options, filePath, nativeTree) {
 	if (strategy === "custom") return;
 	if (strategy === "remark") {
 		processor.use(remarkParse);
@@ -881,6 +947,7 @@ function installUnifiedParser(processor, strategy, options, nativeTree) {
 	}
 	processor.use(oxContentMdast, {
 		gfm: options.gfm,
+		mdx: resolveMdxForSourceFile(filePath, options.mdx),
 		footnotes: options.footnotes,
 		taskLists: options.taskLists,
 		tables: options.tables,
@@ -1222,14 +1289,16 @@ function resolveOptions(options) {
 	return {
 		srcDir: options.srcDir ?? "docs",
 		gfm: options.gfm ?? true,
+		mdx: options.mdx,
 		footnotes: options.footnotes ?? true,
+		semanticFootnotes: options.semanticFootnotes ?? false,
 		tables: options.tables ?? true,
 		taskLists: options.taskLists ?? true,
 		strikethrough: options.strikethrough ?? true,
 		highlight: options.highlight ?? false,
-		highlightTheme: options.highlightTheme ?? "github-dark",
 		codeAnnotations: resolveCodeAnnotationsOptions(options.codeAnnotations),
 		mermaid: options.mermaid ?? false,
+		math: options.math === true || typeof options.math === "object" && options.math.enabled !== false,
 		frontmatter: options.frontmatter ?? true,
 		toc: options.toc ?? true,
 		tocMaxDepth: options.tocMaxDepth ?? 3,
@@ -1264,7 +1333,7 @@ function resolveCodeAnnotationsOptions(options) {
 * Check if the file should be processed.
 */
 function isMarkdownFile(id, options) {
-	return options.extensions.some((ext) => id.endsWith(ext));
+	return isConfiguredSourceFile(id, options.extensions);
 }
 /**
 * The unplugin factory function.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/unplugin",
-  "version": "2.90.0",
+  "version": "3.0.0-alpha.10",
   "description": "Universal plugin for Ox Content - Markdown processing for webpack, rollup, esbuild, vite, and more",
   "keywords": [
     "esbuild",
@@ -65,11 +65,11 @@
     "remark-rehype": "^11.1.1",
     "unified": "^11.0.5",
     "unplugin": "^3.3.0",
-    "@ox-content/napi": "2.90.0"
+    "@ox-content/napi": "3.0.0-alpha.10"
   },
   "devDependencies": {
-    "@types/markdown-it": "^14.1.2",
-    "@types/node": "^26.1.2",
+    "@types/markdown-it": "^14.2.0",
+    "@types/node": "^26.2.0",
     "@typescript/native-preview": "^7.0.0-dev.20260707.2",
     "esbuild": "^0.28.1",
     "rehype-autolink-headings": "^7.1.0",
@@ -84,10 +84,10 @@
     "remark-math": "^6.0.0",
     "remark-smartypants": "^3.0.3",
     "remark-toc": "^9.0.0",
-    "rollup": "^4.62.4",
+    "rollup": "^4.62.5",
     "typescript": "^7.0.2",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.2.8",
-    "vite-plus": "0.2.8",
+    "vite-plus": "0.2.9",
     "webpack": "^5.109.2"
   },
   "scripts": {