@ox-content/unplugin 3.0.0 → 3.1.1-beta.0

package/dist/index.d.mts

@@ -46,6 +46,7 @@ interface MdastNode {
   align?: Array<"left" | "center" | "right" | null>;
   identifier?: string;
   label?: string;
+  data?: Record<string, unknown>;
   [key: string]: unknown;
 }
 /**
@@ -325,6 +326,11 @@ interface OxContentOptions {
    * @default false
    */
   smartPunctuation?: boolean;
+  /**
+   * Enable Pandoc-style heading attribute blocks.
+   * @default false
+   */
+  headingAttributes?: boolean;
   /**
    * Enable syntax highlighting for code blocks.
    * @default false
@@ -439,6 +445,7 @@ interface ResolvedOptions {
   superscript: boolean;
   subscript: boolean;
   smartPunctuation: boolean;
+  headingAttributes: boolean;
   highlight: boolean;
   codeAnnotations: ResolvedCodeAnnotationsOptions;
   mermaid: boolean;
@@ -547,6 +554,16 @@ interface OxContentMdastOptions {
    * @default false
    */
   definitionLists?: boolean;
+  /**
+   * Enable Pandoc-style heading attribute blocks.
+   * @default false
+   */
+  headingAttributes?: boolean;
+  /**
+   * Enable Obsidian-style wiki links as link nodes.
+   * @default false
+   */
+  wikiLinks?: boolean;
 }
 //#endregion
 //#region src/mdast.d.ts

package/dist/src.mjs

@@ -175,12 +175,21 @@ function deserializeMdastFromRaw(buffer, source) {
 				children: children ?? [],
 				position
 			};
-			case KIND_HEADING: return {
-				type: "heading",
-				depth: num0,
-				children: children ?? [],
-				position
-			};
+			case KIND_HEADING: {
+				const node = {
+					type: "heading",
+					depth: num0,
+					children: children ?? [],
+					position
+				};
+				if (str0 !== void 0 || str1 !== void 0) {
+					const hProperties = {};
+					if (str0 !== void 0) hProperties.id = str0;
+					if (str1 !== void 0) hProperties.className = str1.split(/\s+/).filter(Boolean);
+					node.data = { hProperties };
+				}
+				return node;
+			}
 			case KIND_THEMATIC_BREAK: return {
 				type: "thematicBreak",
 				position
@@ -546,7 +555,9 @@ const DEFAULT_MDAST_OPTIONS = {
 	subscript: false,
 	smartPunctuation: false,
 	math: false,
-	definitionLists: false
+	definitionLists: false,
+	headingAttributes: false,
+	wikiLinks: false
 };
 function resolveMdastOptions(options) {
 	return {
@@ -561,7 +572,9 @@ function resolveMdastOptions(options) {
 		subscript: options.subscript ?? DEFAULT_MDAST_OPTIONS.subscript,
 		smartPunctuation: options.smartPunctuation ?? DEFAULT_MDAST_OPTIONS.smartPunctuation,
 		math: options.math ?? DEFAULT_MDAST_OPTIONS.math,
-		definitionLists: options.definitionLists ?? DEFAULT_MDAST_OPTIONS.definitionLists
+		definitionLists: options.definitionLists ?? DEFAULT_MDAST_OPTIONS.definitionLists,
+		headingAttributes: options.headingAttributes ?? DEFAULT_MDAST_OPTIONS.headingAttributes,
+		wikiLinks: options.wikiLinks ?? DEFAULT_MDAST_OPTIONS.wikiLinks
 	};
 }
 //#endregion
@@ -604,7 +617,9 @@ function parseMarkdownToMdast(source, options = {}) {
 		subscript: resolvedOptions.subscript,
 		smartPunctuation: resolvedOptions.smartPunctuation,
 		math: resolvedOptions.math,
-		definitionLists: resolvedOptions.definitionLists
+		definitionLists: resolvedOptions.definitionLists,
+		headingAttributes: resolvedOptions.headingAttributes,
+		wikiLinks: resolvedOptions.wikiLinks
 	};
 	return deserializeMdastFromRaw(requireNapiMethod$1(napi.parseTransferRaw, "parseTransferRaw")(source, "mdast", parserOptions), source);
 }
@@ -631,7 +646,7 @@ function extractTocFromMdast(root, maxDepth) {
 		headings.push({
 			depth,
 			text,
-			slug: slugify$1(text),
+			slug: explicitHeadingId(node) ?? slugify$1(text),
 			children: []
 		});
 	});
@@ -693,6 +708,14 @@ function collectMdastText(node) {
 	if (!Array.isArray(node.children)) return "";
 	return node.children.map((child) => collectMdastText(child)).join("");
 }
+function explicitHeadingId(node) {
+	const data = node.data;
+	if (!data || typeof data !== "object" || Array.isArray(data)) return;
+	const hProperties = data.hProperties;
+	if (!hProperties || typeof hProperties !== "object" || Array.isArray(hProperties)) return;
+	const id = hProperties.id;
+	return typeof id === "string" && id.length > 0 ? id : void 0;
+}
 function slugify$1(text) {
 	return text.toLowerCase().replace(/[^\p{L}\p{N}\s-]+/gu, " ").trim().split(/\s+/).filter(Boolean).join("-");
 }
@@ -772,6 +795,7 @@ function createNapiTransformOptions(options, filePath) {
 		superscript: options.superscript,
 		subscript: options.subscript,
 		smartPunctuation: options.smartPunctuation,
+		headingAttributes: options.headingAttributes,
 		frontmatter: options.frontmatter,
 		tocMaxDepth: options.tocMaxDepth,
 		codeAnnotations: codeAnnotations.enabled,
@@ -1019,6 +1043,7 @@ function installUnifiedParser(processor, strategy, options, filePath, nativeTree
 		superscript: options.superscript,
 		subscript: options.subscript,
 		smartPunctuation: options.smartPunctuation,
+		headingAttributes: options.headingAttributes,
 		math: options.math,
 		definitionLists: options.definitionLists
 	});
@@ -1366,6 +1391,7 @@ function resolveOptions(options) {
 		superscript: options.superscript ?? false,
 		subscript: options.subscript ?? false,
 		smartPunctuation: options.smartPunctuation ?? false,
+		headingAttributes: options.headingAttributes ?? false,
 		highlight: options.highlight ?? false,
 		codeAnnotations: resolveCodeAnnotationsOptions(options.codeAnnotations),
 		mermaid: options.mermaid ?? false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/unplugin",
-  "version": "3.0.0",
+  "version": "3.1.1-beta.0",
   "description": "Universal plugin for Ox Content - Markdown processing for webpack, rollup, esbuild, vite, and more",
   "keywords": [
     "esbuild",
@@ -55,7 +55,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@ox-content/napi": "3.0.0",
+    "@ox-content/napi": "3.1.1-beta.0",
     "@rollup/pluginutils": "^5.4.0",
     "markdown-it": "^15.0.0",
     "markdown-it-anchor": "^9.2.1",