@readme/markdown 11.14.0 → 11.15.0

package/dist/lib/index.d.ts

@@ -17,4 +17,3 @@ export { default as run } from './run';
 export { default as tags } from './tags';
 export { default as mdxishTags } from './mdxishTags';
 export { default as stripComments } from './stripComments';
-export { default as isPlainText } from './utils/isPlainText';

package/dist/main.js

@@ -70620,10 +70620,13 @@ const tagAttributePattern = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)(?:\s*=\s*("[^"]*"|'[^'
 const MAX_LOOKAHEAD = 30;
 /**
  * Tags that have dedicated transformers and should NOT be handled by this plugin.
- * These components have special parsing requirements that the generic component
- * block transformer cannot handle correctly.
+ * These components either have special parsing requirements that the generic component
+ * block transformer cannot handle correctly, or are inline components that we don't
+ * want to convert to mdxJsxFlowElement which is a block level element.
+ *
+ * Glossary and Anchor are inline components.
  */
-const EXCLUDED_TAGS = new Set(['HTMLBlock', 'Table']);
+const EXCLUDED_TAGS = new Set(['HTMLBlock', 'Table', 'Glossary', 'Anchor']);
 const inlineMdProcessor = unified().use(remarkParse);
 const isClosingTag = (value, tag) => value.trim() === `</${tag}>`;
 /**
@@ -94413,6 +94416,92 @@ const normalizeEmphasisAST = () => (tree) => {
 };
 /* harmony default export */ const normalize_malformed_md_syntax = (normalizeEmphasisAST);
 
+;// ./processor/transform/mdxish/normalize-table-separator.ts
+/**
+ * Preprocessor to normalize malformed GFM table separator syntax.
+ *
+ * Fixes the common mistake where the alignment colon is placed after the pipe
+ * instead of before the dashes:
+ *
+ * Invalid: `|: ---` or `|:---` (colon after pipe)
+ * Valid:   `| :---` (colon before dashes)
+ *
+ * Also handles right alignment:
+ * Invalid: `| ---:| ` with space before pipe
+ * Valid:   `| ---:|` (no space before closing pipe)
+ *
+ * This runs before remark-parse to ensure the table is recognized as a valid GFM table.
+ */
+/**
+ * Pattern to match a table separator row.
+ * A separator row consists of cells that contain only dashes, colons (for alignment), and spaces.
+ *
+ * Valid GFM separator formats:
+ * - `---` or `----` (no alignment, defaults to left)
+ * - `:---` (left aligned)
+ * - `---:` (right aligned)
+ * - `:---:` (center aligned)
+ *
+ * Invalid formats this fixes:
+ * - `|: ---` → `| :---` (colon wrongly placed after pipe)
+ * - `|:---` → `| :---` (colon directly after pipe, missing space)
+ * - `|::---` or `| ::---` → `| :---` (double colon typo)
+ */
+// Match a line that looks like a table separator row
+// This regex captures the whole line if it contains only pipe-separated cells with dashes/colons
+const TABLE_SEPARATOR_LINE_REGEX = /^(\|[:\s-]+)+\|?\s*$/;
+// Match malformed left-alignment: `|: ` or `|:` followed by dashes
+// Captures: group 1 = pipe, group 2 = spaces after colon, group 3 = dashes
+const MALFORMED_LEFT_ALIGN_REGEX = /\|:(\s*)(-+)/g;
+// Match malformed double colon: `|::---` or `| ::---` → `| :---`
+const MALFORMED_DOUBLE_COLON_REGEX = /\|\s*::(\s*)(-+)/g;
+// Match malformed patterns with spaces before closing colons: `| --- : |` → `| ---: |`
+const MALFORMED_RIGHT_ALIGN_SPACE_REGEX = /(-+)\s+:(\s*\|)/g;
+// Match malformed center alignment with spaces: `| : --- : |` → `| :---: |`
+const MALFORMED_CENTER_ALIGN_REGEX = /\|:(\s+)(-+)(\s+):/g;
+/**
+ * Normalizes a single table separator line.
+ */
+function normalizeTableSeparatorLine(line) {
+    // Check if this line looks like a table separator
+    if (!TABLE_SEPARATOR_LINE_REGEX.test(line)) {
+        return line;
+    }
+    let normalized = line;
+    // Fix `|::---` → `| :---` (double colon typo)
+    // Must run before single colon fix to avoid partial replacement
+    normalized = normalized.replace(MALFORMED_DOUBLE_COLON_REGEX, '| :$2');
+    // Fix `|: ---` or `|:---` → `| :---`
+    // The colon should be adjacent to the dashes, not the pipe
+    normalized = normalized.replace(MALFORMED_LEFT_ALIGN_REGEX, '| :$2');
+    // Fix `| --- : |` → `| ---: |`
+    // Remove space before right-alignment colon
+    normalized = normalized.replace(MALFORMED_RIGHT_ALIGN_SPACE_REGEX, '$1:$2');
+    // Fix `| : --- : |` → `| :---: |`
+    // Remove spaces around center-aligned dashes
+    normalized = normalized.replace(MALFORMED_CENTER_ALIGN_REGEX, '| :$2:');
+    return normalized;
+}
+/**
+ * Preprocesses markdown content to normalize malformed table separator syntax.
+ *
+ * @param content - The raw markdown content
+ * @returns The content with normalized table separators
+ */
+function normalizeTableSeparator(content) {
+    const lines = content.split('\n');
+    const normalizedLines = lines.map((line, index) => {
+        const prevLine = index > 0 ? lines[index - 1] : '';
+        const isPrevLineTableRow = prevLine.trim().startsWith('|');
+        if (isPrevLineTableRow) {
+            return normalizeTableSeparatorLine(line);
+        }
+        return line;
+    });
+    return normalizedLines.join('\n');
+}
+/* harmony default export */ const normalize_table_separator = ((/* unused pure expression or super */ null && (normalizeTableSeparator)));
+
 ;// ./processor/transform/mdxish/restore-snake-case-component-name.ts
 
 
@@ -94676,6 +94765,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [callouts, code_tabs, gemoji_, transform_embeds];
@@ -94688,9 +94778,11 @@ function mdxishAstProcessor(mdContent, opts = {}) {
     // Preprocessing pipeline: Transform content to be parser-ready
     // Step 1: Extract legacy magic blocks
     const { replaced: contentAfterMagicBlocks, blocks } = extractMagicBlocks(mdContent);
-    // Step 2: Evaluate JSX expressions in attributes
-    const contentAfterJSXEvaluation = preprocessJSXExpressions(contentAfterMagicBlocks, jsxContext);
-    // Step 3: Replace snake_case component names with parser-safe placeholders
+    // Step 2: Normalize malformed table separator syntax (e.g., `|: ---` → `| :---`)
+    const contentAfterTableNormalization = normalizeTableSeparator(contentAfterMagicBlocks);
+    // Step 3: Evaluate JSX expressions in attributes
+    const contentAfterJSXEvaluation = preprocessJSXExpressions(contentAfterTableNormalization, jsxContext);
+    // Step 4: Replace snake_case component names with parser-safe placeholders
     // (e.g., <Snake_case /> → <MDXishSnakeCase0 /> which will be restored after parsing)
     const { content: parserReadyContent, mapping: snakeCaseMapping } = processSnakeCaseComponent(contentAfterJSXEvaluation);
     // Create string map for tailwind transformer
@@ -95312,7 +95404,6 @@ async function stripComments(doc, { mdx } = {}) {
 
 
 
-
 ;// ./index.tsx
 
 

package/dist/main.node.js

@@ -90824,10 +90824,13 @@ const tagAttributePattern = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)(?:\s*=\s*("[^"]*"|'[^'
 const MAX_LOOKAHEAD = 30;
 /**
  * Tags that have dedicated transformers and should NOT be handled by this plugin.
- * These components have special parsing requirements that the generic component
- * block transformer cannot handle correctly.
+ * These components either have special parsing requirements that the generic component
+ * block transformer cannot handle correctly, or are inline components that we don't
+ * want to convert to mdxJsxFlowElement which is a block level element.
+ *
+ * Glossary and Anchor are inline components.
  */
-const EXCLUDED_TAGS = new Set(['HTMLBlock', 'Table']);
+const EXCLUDED_TAGS = new Set(['HTMLBlock', 'Table', 'Glossary', 'Anchor']);
 const inlineMdProcessor = unified().use(remarkParse);
 const isClosingTag = (value, tag) => value.trim() === `</${tag}>`;
 /**
@@ -114617,6 +114620,92 @@ const normalizeEmphasisAST = () => (tree) => {
 };
 /* harmony default export */ const normalize_malformed_md_syntax = (normalizeEmphasisAST);
 
+;// ./processor/transform/mdxish/normalize-table-separator.ts
+/**
+ * Preprocessor to normalize malformed GFM table separator syntax.
+ *
+ * Fixes the common mistake where the alignment colon is placed after the pipe
+ * instead of before the dashes:
+ *
+ * Invalid: `|: ---` or `|:---` (colon after pipe)
+ * Valid:   `| :---` (colon before dashes)
+ *
+ * Also handles right alignment:
+ * Invalid: `| ---:| ` with space before pipe
+ * Valid:   `| ---:|` (no space before closing pipe)
+ *
+ * This runs before remark-parse to ensure the table is recognized as a valid GFM table.
+ */
+/**
+ * Pattern to match a table separator row.
+ * A separator row consists of cells that contain only dashes, colons (for alignment), and spaces.
+ *
+ * Valid GFM separator formats:
+ * - `---` or `----` (no alignment, defaults to left)
+ * - `:---` (left aligned)
+ * - `---:` (right aligned)
+ * - `:---:` (center aligned)
+ *
+ * Invalid formats this fixes:
+ * - `|: ---` → `| :---` (colon wrongly placed after pipe)
+ * - `|:---` → `| :---` (colon directly after pipe, missing space)
+ * - `|::---` or `| ::---` → `| :---` (double colon typo)
+ */
+// Match a line that looks like a table separator row
+// This regex captures the whole line if it contains only pipe-separated cells with dashes/colons
+const TABLE_SEPARATOR_LINE_REGEX = /^(\|[:\s-]+)+\|?\s*$/;
+// Match malformed left-alignment: `|: ` or `|:` followed by dashes
+// Captures: group 1 = pipe, group 2 = spaces after colon, group 3 = dashes
+const MALFORMED_LEFT_ALIGN_REGEX = /\|:(\s*)(-+)/g;
+// Match malformed double colon: `|::---` or `| ::---` → `| :---`
+const MALFORMED_DOUBLE_COLON_REGEX = /\|\s*::(\s*)(-+)/g;
+// Match malformed patterns with spaces before closing colons: `| --- : |` → `| ---: |`
+const MALFORMED_RIGHT_ALIGN_SPACE_REGEX = /(-+)\s+:(\s*\|)/g;
+// Match malformed center alignment with spaces: `| : --- : |` → `| :---: |`
+const MALFORMED_CENTER_ALIGN_REGEX = /\|:(\s+)(-+)(\s+):/g;
+/**
+ * Normalizes a single table separator line.
+ */
+function normalizeTableSeparatorLine(line) {
+    // Check if this line looks like a table separator
+    if (!TABLE_SEPARATOR_LINE_REGEX.test(line)) {
+        return line;
+    }
+    let normalized = line;
+    // Fix `|::---` → `| :---` (double colon typo)
+    // Must run before single colon fix to avoid partial replacement
+    normalized = normalized.replace(MALFORMED_DOUBLE_COLON_REGEX, '| :$2');
+    // Fix `|: ---` or `|:---` → `| :---`
+    // The colon should be adjacent to the dashes, not the pipe
+    normalized = normalized.replace(MALFORMED_LEFT_ALIGN_REGEX, '| :$2');
+    // Fix `| --- : |` → `| ---: |`
+    // Remove space before right-alignment colon
+    normalized = normalized.replace(MALFORMED_RIGHT_ALIGN_SPACE_REGEX, '$1:$2');
+    // Fix `| : --- : |` → `| :---: |`
+    // Remove spaces around center-aligned dashes
+    normalized = normalized.replace(MALFORMED_CENTER_ALIGN_REGEX, '| :$2:');
+    return normalized;
+}
+/**
+ * Preprocesses markdown content to normalize malformed table separator syntax.
+ *
+ * @param content - The raw markdown content
+ * @returns The content with normalized table separators
+ */
+function normalizeTableSeparator(content) {
+    const lines = content.split('\n');
+    const normalizedLines = lines.map((line, index) => {
+        const prevLine = index > 0 ? lines[index - 1] : '';
+        const isPrevLineTableRow = prevLine.trim().startsWith('|');
+        if (isPrevLineTableRow) {
+            return normalizeTableSeparatorLine(line);
+        }
+        return line;
+    });
+    return normalizedLines.join('\n');
+}
+/* harmony default export */ const normalize_table_separator = ((/* unused pure expression or super */ null && (normalizeTableSeparator)));
+
 ;// ./processor/transform/mdxish/restore-snake-case-component-name.ts
 
 
@@ -114880,6 +114969,7 @@ function loadComponents() {
 
 
 
+
 
 
 const defaultTransformers = [callouts, code_tabs, gemoji_, transform_embeds];
@@ -114892,9 +114982,11 @@ function mdxishAstProcessor(mdContent, opts = {}) {
     // Preprocessing pipeline: Transform content to be parser-ready
     // Step 1: Extract legacy magic blocks
     const { replaced: contentAfterMagicBlocks, blocks } = extractMagicBlocks(mdContent);
-    // Step 2: Evaluate JSX expressions in attributes
-    const contentAfterJSXEvaluation = preprocessJSXExpressions(contentAfterMagicBlocks, jsxContext);
-    // Step 3: Replace snake_case component names with parser-safe placeholders
+    // Step 2: Normalize malformed table separator syntax (e.g., `|: ---` → `| :---`)
+    const contentAfterTableNormalization = normalizeTableSeparator(contentAfterMagicBlocks);
+    // Step 3: Evaluate JSX expressions in attributes
+    const contentAfterJSXEvaluation = preprocessJSXExpressions(contentAfterTableNormalization, jsxContext);
+    // Step 4: Replace snake_case component names with parser-safe placeholders
     // (e.g., <Snake_case /> → <MDXishSnakeCase0 /> which will be restored after parsing)
     const { content: parserReadyContent, mapping: snakeCaseMapping } = processSnakeCaseComponent(contentAfterJSXEvaluation);
     // Create string map for tailwind transformer
@@ -115516,7 +115608,6 @@ async function stripComments(doc, { mdx } = {}) {
 
 
 
-
 ;// ./index.tsx