@readme/markdown 14.14.1 → 15.0.0

package/dist/main.node.js

@@ -275,7 +275,7 @@ function visit(tree, test, visitor, reverse) {
 
 /***/ }),
 
-/***/ 9762:
+/***/ 7644:
 /***/ ((__unused_webpack_module, exports) => {
 
 "use strict";
@@ -349,7 +349,7 @@ exports["default"] = canonical;
 
 /***/ }),
 
-/***/ 7900:
+/***/ 4350:
 /***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
 "use strict";
@@ -358,15 +358,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-const canonical_1 = __importDefault(__webpack_require__(9762));
-const modes_1 = __webpack_require__(1412);
-const uppercase_1 = __importDefault(__webpack_require__(8892));
+const canonical_1 = __importDefault(__webpack_require__(7644));
+const modes_1 = __webpack_require__(1130);
+const uppercase_1 = __importDefault(__webpack_require__(3622));
 exports["default"] = { uppercase: uppercase_1.default, canonical: canonical_1.default, modes: modes_1.modes, getMode: modes_1.getMode };
 
 
 /***/ }),
 
-/***/ 1412:
+/***/ 1130:
 /***/ ((__unused_webpack_module, exports) => {
 
 "use strict";
@@ -425,6 +425,7 @@ exports.modes = {
     node: 'javascript',
     macruby: 'ruby',
     markdown: 'gfm',
+    md: 'gfm',
     ml: ['mllike', 'text/x-ocaml'],
     mssql: ['sql', 'text/x-mssql'],
     mysql: ['sql', 'text/x-mysql'],
@@ -479,7 +480,7 @@ function getMode(lang) {
 
 /***/ }),
 
-/***/ 8892:
+/***/ 3622:
 /***/ ((__unused_webpack_module, exports) => {
 
 "use strict";
@@ -19303,7 +19304,7 @@ __webpack_require__.d(__webpack_exports__, {
   stripComments: () => (/* reexport */ lib_stripComments),
   tags: () => (/* reexport */ lib_tags),
   tailwindCompiler: () => (/* reexport */ tailwindCompiler),
-  utils: () => (/* binding */ utils)
+  utils: () => (/* binding */ index_utils)
 });
 
 // NAMESPACE OBJECT: ./components/index.ts
@@ -19625,16 +19626,16 @@ const Code = (props) => {
 };
 /* harmony default export */ const components_Code = (Code);
 
-// EXTERNAL MODULE: ./node_modules/@readme/syntax-highlighter/dist-utils/index.js
-var dist_utils = __webpack_require__(7900);
-var dist_utils_default = /*#__PURE__*/__webpack_require__.n(dist_utils);
+// EXTERNAL MODULE: ./node_modules/@readme/syntax-highlighter/dist-utils/utils/index.js
+var utils = __webpack_require__(4350);
+var utils_default = /*#__PURE__*/__webpack_require__.n(utils);
 ;// ./components/CodeTabs/index.tsx
 
 
 
 
 let mermaid;
-const { uppercase } = (dist_utils_default());
+const { uppercase } = (utils_default());
 // Module-level queue that batches mermaid nodes across all CodeTabs instances into a
 // single mermaid.run() call. This is necessary because mermaid generates SVG element IDs
 // using Date.now(), which collides when multiple diagrams render in the same millisecond.
@@ -94657,11 +94658,6 @@ const looseHtmlEntityConstruct = {
     name: 'looseHtmlEntity',
     tokenize: tokenizeLooseHtmlEntity,
 };
-function resolveEntity(name) {
-    const input = `&${name};`;
-    const decoded = decode_decodeHTMLStrict(input);
-    return decoded !== input ? decoded : undefined;
-}
 function tokenizeLooseHtmlEntity(effects, ok, nok) {
     let length = 0;
     const start = (code) => {
@@ -94728,28 +94724,9 @@ function tokenizeLooseHtmlEntity(effects, ok, nok) {
 }
 function exitLooseHtmlEntity(token) {
     const raw = this.sliceSerialize(token);
-    const entityChars = raw.slice(1);
-    if (entityChars.startsWith('#')) {
-        const decoded = resolveEntity(entityChars);
-        if (decoded) {
-            this.enter({ type: 'text', value: decoded }, token);
-            this.exit(token);
-            return;
-        }
-    }
-    else {
-        for (let len = entityChars.length; len >= 2; len -= 1) {
-            const candidate = entityChars.slice(0, len);
-            const decoded = resolveEntity(candidate);
-            if (decoded) {
-                const remainder = entityChars.slice(len);
-                this.enter({ type: 'text', value: decoded + remainder }, token);
-                this.exit(token);
-                return;
-            }
-        }
-    }
-    this.enter({ type: 'text', value: raw }, token);
+    // `decodeHTML` follows the HTML spec's legacy rules, where only a small
+    // whitelist of names may omit the semicolon, so `&partner_key` stays intact.
+    this.enter({ type: 'text', value: esm_decode_decodeHTML(raw) }, token);
     this.exit(token);
 }
 function looseHtmlEntity() {
@@ -94769,10 +94746,11 @@ function looseHtmlEntityFromMarkdown() {
 /**
  * Micromark extension for HTML entities without semicolons.
  *
- * Handles named entities (e.g. `&nbsp`, `&amp`, `&copy`), decimal numeric
- * references (e.g. `&#160`, `&#169`), and hex numeric references (e.g. `&#xa0`,
- * `&#xA0`). Entities that already include the semicolon are left for the
- * standard parser to handle.
+ * Handles the named entities the HTML spec lets authors write without a
+ * semicolon (e.g. `&nbsp`, `&amp`, `&copy`), decimal numeric references (e.g.
+ * `&#160`, `&#169`), and hex numeric references (e.g. `&#xa0`, `&#xA0`).
+ * Entities that already include the semicolon are left for the standard parser
+ * to handle.
  */
 
 
@@ -126552,9 +126530,9 @@ const resolveDeferredAttributeExpressionProps = () => (tree, file) => {
                 properties[name] = name === 'style' && style_object_to_css_isPlainObject(result) ? styleObjectToCssText(result) : result;
             }
             catch {
-                // Evaluation failed — fall back to the raw expression source so the attribute
-                // renders as readable text rather than disappearing.
-                properties[name] = source;
+                // Evaluation failed — keep the literal `{...}`, matching how `evaluateExpressions` falls
+                // back in body text. Variable references like `{user.name}` stay resolvable at render time.
+                properties[name] = `{${source}}`;
             }
         });
         delete node.data.deferredExpressions;
@@ -126641,10 +126619,44 @@ const restoreBooleanProperties = () => tree => {
 };
 
 
+;// ./processor/transform/mdxish/tables/gfm-cell-normalization.ts
+/** `<br />` is the only line break a GFM pipe cell can carry, since cells are single-line. */
+const createLineBreak = () => ({
+    type: 'mdxJsxTextElement',
+    name: 'br',
+    attributes: [],
+    children: [],
+});
+const createText = (value) => ({ type: 'text', value });
+const isText = (node) => node.type === 'text';
+const hasChildren = (node) => 'children' in node;
+const splitOnLineBreaks = (value) => value.split('\n').reduce((nodes, segment, index) => {
+    if (index > 0)
+        nodes.push(createLineBreak());
+    if (segment)
+        nodes.push(createText(segment));
+    return nodes;
+}, []);
+const normalizeNodes = (nodes) => nodes.flatMap(node => {
+    if (node.type === 'break')
+        return createLineBreak();
+    if (isText(node))
+        return splitOnLineBreaks(node.value);
+    if (hasChildren(node))
+        return { ...node, children: normalizeNodes(node.children) };
+    return node;
+});
+/**
+ * Returns a copy of the cell's children with line breaks — `break` nodes and newlines inside
+ * text — rewritten to the `<br />` a single-line GFM pipe cell can carry.
+ */
+const normalizeCellChildrenForGfm = (cell) => normalizeNodes(cell.children);
+
 ;// ./processor/transform/mdxish/tables/mdxish-tables-to-jsx.ts
 
 
 
+
 const SELF_CLOSING_JSX_REGEX = /^\s*<[A-Z][^>]*\/>\s*$/;
 const mdxish_tables_to_jsx_alignToStyle = (align) => {
     if (!align || align === 'left')
@@ -126660,6 +126672,38 @@ const mdxish_tables_to_jsx_alignToStyle = (align) => {
 };
 const mdxish_tables_to_jsx_isTableCell = (node) => ['tableHead', 'tableCell'].includes(node.type);
 const mdxish_tables_to_jsx_isLiteral = (node) => 'value' in node;
+/**
+ * Block-level content that a single-line GFM cell cannot hold. `phrasing()` returns true
+ * for inline types (text, emphasis, strong, link…), which are safe to keep.
+ */
+const isFlowChild = (child) => {
+    if (child.type === 'paragraph' || child.type === 'plain' || child.type === 'escape')
+        return false;
+    if (child.type === NodeTypes.variable)
+        return false;
+    if (phrasing(child))
+        return false;
+    if (child.type === 'html')
+        return SELF_CLOSING_JSX_REGEX.test(child.value);
+    return true;
+};
+/** A newline in a normalized cell (e.g. inside `inlineCode`) has no inline equivalent. */
+const containsLiteralNewline = (nodes) => nodes.some(node => (mdxish_tables_to_jsx_isLiteral(node) && node.value.includes('\n')) || (hasChildren(node) && containsLiteralNewline(node.children)));
+/** True when normalized cell content survives a single-line GFM pipe cell without losing structure. */
+const canCellBeGfm = (children) => {
+    // Multiple paragraphs are distinct blocks; a single-line cell cannot keep them apart.
+    if (children.filter(child => child.type === 'paragraph').length > 1)
+        return false;
+    if (children.some(isFlowChild))
+        return false;
+    return !containsLiteralNewline(children);
+};
+/** On the promote path a `break` would serialize as a dangling `\`, so collapse it to a newline. */
+const flattenBreaksToNewlines = (cell) => {
+    visit(cell, 'break', (_, index, parent) => {
+        parent.children.splice(index, 1, { type: 'text', value: '\n' });
+    });
+};
 /**
  * Mdxish-specific version of `tablesToJsx`. Differs from the shared MDX version:
  *
@@ -126670,52 +126714,25 @@ const mdxish_tables_to_jsx_isLiteral = (node) => 'value' in node;
  */
 const mdxishTablesToJsx = () => tree => {
     visit(tree, (node) => ['table', 'tableau'].includes(node.type), (table, index, parent) => {
-        let hasFlowContent = false;
+        const gfmCells = [];
+        let requiresJsxTable = false;
         visit(table, mdxish_tables_to_jsx_isTableCell, (cell) => {
-            if (hasFlowContent || cell.children.length === 0)
-                return;
-            visit(cell, 'break', (_, breakIndex, breakParent) => {
-                breakParent.children.splice(breakIndex, 1, { type: 'text', value: '\n' });
-            });
-            // A cell with more than one paragraph child cannot be serialized as GFM
-            // (pipe tables are single-line per cell), so force JSX <Table> output to
-            // preserve paragraph separation.
-            const paragraphCount = cell.children.filter(child => child.type === 'paragraph').length;
-            if (paragraphCount > 1) {
-                hasFlowContent = true;
-                return;
-            }
-            // Check if any child is "flow" content (block-level) that requires JSX <Table>
-            // serialization instead of GFM. `phrasing()` from mdast-util-phrasing returns
-            // true for inline node types (text, emphasis, strong, link, etc.) which are
-            // safe to keep in GFM cells.
-            const hasFlowChild = cell.children.some(child => {
-                if (child.type === 'paragraph' || child.type === 'plain' || child.type === 'escape')
-                    return false;
-                if (child.type === NodeTypes.variable)
-                    return false;
-                if (phrasing(child))
-                    return false;
-                if (child.type === 'html') {
-                    return SELF_CLOSING_JSX_REGEX.test(child.value);
-                }
-                return true;
-            });
-            if (hasFlowChild) {
-                hasFlowContent = true;
-            }
-            if (!hasFlowContent) {
-                visit(cell, mdxish_tables_to_jsx_isLiteral, (node) => {
-                    if (node.value.match(/\n/)) {
-                        hasFlowContent = true;
-                    }
-                });
+            const normalized = normalizeCellChildrenForGfm(cell);
+            if (!canCellBeGfm(normalized)) {
+                requiresJsxTable = true;
+                return EXIT;
             }
+            gfmCells.push([cell, normalized]);
+            return undefined;
         });
-        if (!hasFlowContent) {
+        if (!requiresJsxTable) {
+            gfmCells.forEach(([cell, children]) => {
+                cell.children = children;
+            });
             table.type = 'table';
             return;
         }
+        visit(table, mdxish_tables_to_jsx_isTableCell, flattenBreaksToNewlines);
         const styles = table.align.map(mdxish_tables_to_jsx_alignToStyle);
         const head = {
             attributes: [],
@@ -127421,6 +127438,24 @@ const Contexts = ({ children, terms = [], variables = { user: {}, defaults: [] }
 };
 /* harmony default export */ const contexts = (Contexts);
 
+;// ./utils/user.ts
+const User = (variables) => {
+    const { user = {}, defaults = [] } = variables || {};
+    return new Proxy(user, {
+        get(target, attribute) {
+            if (typeof attribute === 'symbol') {
+                return '';
+            }
+            if (attribute in target) {
+                return target[attribute];
+            }
+            const def = defaults.find((d) => d.name === attribute);
+            return def ? def.default : attribute.toUpperCase();
+        },
+    });
+};
+/* harmony default export */ const user = (User);
+
 ;// ./lib/utils/makeUseMdxComponents.ts
 
 
@@ -127451,6 +127486,35 @@ const makeUseMDXComponents = (more = {}) => {
 };
 /* harmony default export */ const makeUseMdxComponents = (makeUseMDXComponents);
 
+;// ./lib/utils/mdxish/mdxish-variables.ts
+
+// The `$` guard skips template-literal interpolation: `${user.name}` embeds `{user.name}`, and
+// substituting it would leave a mangled `` `Hi $Name` `` behind. Those belong to an expression,
+// which either evaluated already or is meant to stay literal.
+const MDX_VARIABLE_REGEX = new RegExp(`(?<!\\$)${variable_dist.MDX_VARIABLE_REGEXP}`, 'gu');
+// Bracket notation names the same variable as dot notation, so normalize it before substituting.
+// Escaped and `$`-prefixed forms are left alone so a reference that stays literal keeps its source.
+// A closing escape needs no lookahead: requiring a literal `]}` already rules out `]\}`.
+const BRACKET_NOTATION_REGEX = /(?<![$\\])\{user\[['"](\w+)['"]\]\}/gu;
+/**
+ * Resolve `{user.*}` in a JSX attribute value against the same `user` binding the rmdx engine gets,
+ * so both engines agree. Body text differs on empty values: `Variable` falls back to the default.
+ *
+ * Legacy `<<...>>` is valid inside a quoted attribute but deliberately left literal — attributes are
+ * an MDX surface, and `{user.*}` is the syntax authors use there.
+ */
+function resolveAttributeVariables(value, user) {
+    if (!value.includes('{user'))
+        return value;
+    return value
+        .replace(BRACKET_NOTATION_REGEX, '{user.$1}')
+        .replace(MDX_VARIABLE_REGEX, (source, escapePrefix, name, escapeSuffix) => {
+        if (escapePrefix || escapeSuffix)
+            return source;
+        return user[name];
+    });
+}
+
 ;// ./lib/utils/mdxish/mdxish-render-utils.tsx
 
 
@@ -127459,6 +127523,8 @@ const makeUseMDXComponents = (more = {}) => {
 
 
 
+
+
 /** Flatten CustomComponents into a component map for rehype-react */
 function exportComponentsForRehype(components) {
     const exported = Object.entries(components).reduce((memo, [tag, mod]) => {
@@ -127486,6 +127552,28 @@ function exportComponentsForRehype(components) {
     result.variable = (variable_dist_default());
     return result;
 }
+/**
+ * Code rides on a `value` prop, and `variablesCodeResolver` owns it at parse time where it
+ * deliberately leaves mermaid alone; resolving it again here would override that.
+ */
+const CODE_TAG_NAMES = new Set(['code']);
+/** Raw markup injected with `dangerouslySetInnerHTML` by HTMLBlock and Embed — never interpolate. */
+const RAW_HTML_PROP_NAMES = new Set(['html']);
+/**
+ * Resolve `{user.*}` in string-valued props. Body text is handled by the `Variable` component, but
+ * attributes are plain strings, so they are substituted here — at render time, so that a
+ * server-parsed (user-agnostic) tree resolves against the current reader's variables.
+ */
+function resolveVariablesInProps(props, user, tagName) {
+    const isCodeTag = Boolean(tagName && CODE_TAG_NAMES.has(tagName));
+    const resolvedEntries = Object.entries(props).map(([key, value]) => {
+        const isDocumentContent = RAW_HTML_PROP_NAMES.has(key) || (isCodeTag && key === 'value');
+        if (typeof value !== 'string' || isDocumentContent)
+            return [key, value];
+        return [key, resolveAttributeVariables(value, user)];
+    });
+    return Object.fromEntries(resolvedEntries);
+}
 /**
  * Custom React.createElement wrapper that recovers real JS prop values for
  * custom components. rehype-react v6 uses hast-to-hyperscript, which stringifies
@@ -127497,7 +127585,7 @@ function exportComponentsForRehype(components) {
  * Only arrays win over `rest`, overwriting other shapes would undo correct
  * React conversions like `style="color:red"` → `{ color: 'red' }`.
  */
-function createElementPreservingHastProps(type, props, ...children) {
+const makeCreateElementPreservingHastProps = (user) => function createElementPreservingHastProps(type, props, ...children) {
     if (props?.node?.properties) {
         const { node, ...rest } = props;
         const mergedProps = { ...rest };
@@ -127507,15 +127595,16 @@ function createElementPreservingHastProps(type, props, ...children) {
         });
         // Strip undefined so positional args don't shadow node.properties.children
         const definedChildren = children.filter(c => c !== undefined);
-        return external_react_default().createElement(type, mergedProps, ...definedChildren);
+        const withVariables = resolveVariablesInProps(mergedProps, user, node.tagName);
+        return external_react_default().createElement(type, withVariables, ...definedChildren);
     }
-    return external_react_default().createElement(type, props, ...children);
-}
+    return external_react_default().createElement(type, props && resolveVariablesInProps(props, user), ...children);
+};
 /** Create a rehype-react processor */
-function createRehypeReactProcessor(components) {
+function createRehypeReactProcessor(components, variables) {
     // @ts-expect-error - rehype-react types are incompatible with React.Fragment return type
     return unified().use((rehype_react_default()), {
-        createElement: createElementPreservingHastProps,
+        createElement: makeCreateElementPreservingHastProps(user(variables)),
         Fragment: (external_react_default()).Fragment,
         components,
         passNode: true,
@@ -127530,7 +127619,7 @@ function createTocComponent(tocHast) {
         components: { p: (external_react_default()).Fragment },
     });
     const tocReactElement = tocProcessor.stringify(tocHast);
-    const TocComponent = () => tocReactElement ? (external_react_default().createElement(components_TableOfContents, null, tocReactElement)) : null;
+    const TocComponent = () => tocReactElement ? external_react_default().createElement(components_TableOfContents, null, tocReactElement) : null;
     TocComponent.displayName = 'Toc';
     return TocComponent;
 }
@@ -127579,7 +127668,7 @@ const renderMdxish = (tree, opts = {}) => {
     Object.entries(localScope).forEach(([name, value]) => {
         componentsForRehype[name] = value;
     });
-    const processor = createRehypeReactProcessor(componentsForRehype);
+    const processor = createRehypeReactProcessor(componentsForRehype, variables);
     const content = processor.stringify(tree);
     const tocHast = headings.length > 0 ? tocToHast(headings, variables) : null;
     return buildRMDXModule(content, headings, tocHast, { ...contextOpts, variables });
@@ -127635,24 +127724,6 @@ function runSync(code, options) {
 // EXTERNAL MODULE: ./node_modules/react/jsx-runtime.js
 var jsx_runtime = __webpack_require__(4848);
 var jsx_runtime_namespaceObject = /*#__PURE__*/__webpack_require__.t(jsx_runtime, 2);
-;// ./utils/user.ts
-const User = (variables) => {
-    const { user = {}, defaults = [] } = variables || {};
-    return new Proxy(user, {
-        get(target, attribute) {
-            if (typeof attribute === 'symbol') {
-                return '';
-            }
-            if (attribute in target) {
-                return target[attribute];
-            }
-            const def = defaults.find((d) => d.name === attribute);
-            return def ? def.default : attribute.toUpperCase();
-        },
-    });
-};
-/* harmony default export */ const user = (User);
-
 ;// ./lib/run.tsx
 
 
@@ -127897,7 +127968,7 @@ async function stripComments(doc, { mdx, mdxish } = {}) {
 
 
 
-const utils = {
+const index_utils = {
     get options() {
         return { ...options };
     },