@readme/markdown 13.2.0 → 13.4.0

package/dist/main.node.js

@@ -25091,12 +25091,12 @@ const parseOptions = (userOpts = {}) => {
   return opts;
 };
 
-;// ./node_modules/rehype-slug/node_modules/github-slugger/regex.js
+;// ./node_modules/github-slugger/regex.js
 // This module is generated by `script/`.
 /* eslint-disable no-control-regex, no-misleading-character-class, no-useless-escape */
 const regex = /[\0-\x1F!-,\.\/:-@\[-\^`\{-\xA9\xAB-\xB4\xB6-\xB9\xBB-\xBF\xD7\xF7\u02C2-\u02C5\u02D2-\u02DF\u02E5-\u02EB\u02ED\u02EF-\u02FF\u0375\u0378\u0379\u037E\u0380-\u0385\u0387\u038B\u038D\u03A2\u03F6\u0482\u0530\u0557\u0558\u055A-\u055F\u0589-\u0590\u05BE\u05C0\u05C3\u05C6\u05C8-\u05CF\u05EB-\u05EE\u05F3-\u060F\u061B-\u061F\u066A-\u066D\u06D4\u06DD\u06DE\u06E9\u06FD\u06FE\u0700-\u070F\u074B\u074C\u07B2-\u07BF\u07F6-\u07F9\u07FB\u07FC\u07FE\u07FF\u082E-\u083F\u085C-\u085F\u086B-\u089F\u08B5\u08C8-\u08D2\u08E2\u0964\u0965\u0970\u0984\u098D\u098E\u0991\u0992\u09A9\u09B1\u09B3-\u09B5\u09BA\u09BB\u09C5\u09C6\u09C9\u09CA\u09CF-\u09D6\u09D8-\u09DB\u09DE\u09E4\u09E5\u09F2-\u09FB\u09FD\u09FF\u0A00\u0A04\u0A0B-\u0A0E\u0A11\u0A12\u0A29\u0A31\u0A34\u0A37\u0A3A\u0A3B\u0A3D\u0A43-\u0A46\u0A49\u0A4A\u0A4E-\u0A50\u0A52-\u0A58\u0A5D\u0A5F-\u0A65\u0A76-\u0A80\u0A84\u0A8E\u0A92\u0AA9\u0AB1\u0AB4\u0ABA\u0ABB\u0AC6\u0ACA\u0ACE\u0ACF\u0AD1-\u0ADF\u0AE4\u0AE5\u0AF0-\u0AF8\u0B00\u0B04\u0B0D\u0B0E\u0B11\u0B12\u0B29\u0B31\u0B34\u0B3A\u0B3B\u0B45\u0B46\u0B49\u0B4A\u0B4E-\u0B54\u0B58-\u0B5B\u0B5E\u0B64\u0B65\u0B70\u0B72-\u0B81\u0B84\u0B8B-\u0B8D\u0B91\u0B96-\u0B98\u0B9B\u0B9D\u0BA0-\u0BA2\u0BA5-\u0BA7\u0BAB-\u0BAD\u0BBA-\u0BBD\u0BC3-\u0BC5\u0BC9\u0BCE\u0BCF\u0BD1-\u0BD6\u0BD8-\u0BE5\u0BF0-\u0BFF\u0C0D\u0C11\u0C29\u0C3A-\u0C3C\u0C45\u0C49\u0C4E-\u0C54\u0C57\u0C5B-\u0C5F\u0C64\u0C65\u0C70-\u0C7F\u0C84\u0C8D\u0C91\u0CA9\u0CB4\u0CBA\u0CBB\u0CC5\u0CC9\u0CCE-\u0CD4\u0CD7-\u0CDD\u0CDF\u0CE4\u0CE5\u0CF0\u0CF3-\u0CFF\u0D0D\u0D11\u0D45\u0D49\u0D4F-\u0D53\u0D58-\u0D5E\u0D64\u0D65\u0D70-\u0D79\u0D80\u0D84\u0D97-\u0D99\u0DB2\u0DBC\u0DBE\u0DBF\u0DC7-\u0DC9\u0DCB-\u0DCE\u0DD5\u0DD7\u0DE0-\u0DE5\u0DF0\u0DF1\u0DF4-\u0E00\u0E3B-\u0E3F\u0E4F\u0E5A-\u0E80\u0E83\u0E85\u0E8B\u0EA4\u0EA6\u0EBE\u0EBF\u0EC5\u0EC7\u0ECE\u0ECF\u0EDA\u0EDB\u0EE0-\u0EFF\u0F01-\u0F17\u0F1A-\u0F1F\u0F2A-\u0F34\u0F36\u0F38\u0F3A-\u0F3D\u0F48\u0F6D-\u0F70\u0F85\u0F98\u0FBD-\u0FC5\u0FC7-\u0FFF\u104A-\u104F\u109E\u109F\u10C6\u10C8-\u10CC\u10CE\u10CF\u10FB\u1249\u124E\u124F\u1257\u1259\u125E\u125F\u1289\u128E\u128F\u12B1\u12B6\u12B7\u12BF\u12C1\u12C6\u12C7\u12D7\u1311\u1316\u1317\u135B\u135C\u1360-\u137F\u1390-\u139F\u13F6\u13F7\u13FE-\u1400\u166D\u166E\u1680\u169B-\u169F\u16EB-\u16ED\u16F9-\u16FF\u170D\u1715-\u171F\u1735-\u173F\u1754-\u175F\u176D\u1771\u1774-\u177F\u17D4-\u17D6\u17D8-\u17DB\u17DE\u17DF\u17EA-\u180A\u180E\u180F\u181A-\u181F\u1879-\u187F\u18AB-\u18AF\u18F6-\u18FF\u191F\u192C-\u192F\u193C-\u1945\u196E\u196F\u1975-\u197F\u19AC-\u19AF\u19CA-\u19CF\u19DA-\u19FF\u1A1C-\u1A1F\u1A5F\u1A7D\u1A7E\u1A8A-\u1A8F\u1A9A-\u1AA6\u1AA8-\u1AAF\u1AC1-\u1AFF\u1B4C-\u1B4F\u1B5A-\u1B6A\u1B74-\u1B7F\u1BF4-\u1BFF\u1C38-\u1C3F\u1C4A-\u1C4C\u1C7E\u1C7F\u1C89-\u1C8F\u1CBB\u1CBC\u1CC0-\u1CCF\u1CD3\u1CFB-\u1CFF\u1DFA\u1F16\u1F17\u1F1E\u1F1F\u1F46\u1F47\u1F4E\u1F4F\u1F58\u1F5A\u1F5C\u1F5E\u1F7E\u1F7F\u1FB5\u1FBD\u1FBF-\u1FC1\u1FC5\u1FCD-\u1FCF\u1FD4\u1FD5\u1FDC-\u1FDF\u1FED-\u1FF1\u1FF5\u1FFD-\u203E\u2041-\u2053\u2055-\u2070\u2072-\u207E\u2080-\u208F\u209D-\u20CF\u20F1-\u2101\u2103-\u2106\u2108\u2109\u2114\u2116-\u2118\u211E-\u2123\u2125\u2127\u2129\u212E\u213A\u213B\u2140-\u2144\u214A-\u214D\u214F-\u215F\u2189-\u24B5\u24EA-\u2BFF\u2C2F\u2C5F\u2CE5-\u2CEA\u2CF4-\u2CFF\u2D26\u2D28-\u2D2C\u2D2E\u2D2F\u2D68-\u2D6E\u2D70-\u2D7E\u2D97-\u2D9F\u2DA7\u2DAF\u2DB7\u2DBF\u2DC7\u2DCF\u2DD7\u2DDF\u2E00-\u2E2E\u2E30-\u3004\u3008-\u3020\u3030\u3036\u3037\u303D-\u3040\u3097\u3098\u309B\u309C\u30A0\u30FB\u3100-\u3104\u3130\u318F-\u319F\u31C0-\u31EF\u3200-\u33FF\u4DC0-\u4DFF\u9FFD-\u9FFF\uA48D-\uA4CF\uA4FE\uA4FF\uA60D-\uA60F\uA62C-\uA63F\uA673\uA67E\uA6F2-\uA716\uA720\uA721\uA789\uA78A\uA7C0\uA7C1\uA7CB-\uA7F4\uA828-\uA82B\uA82D-\uA83F\uA874-\uA87F\uA8C6-\uA8CF\uA8DA-\uA8DF\uA8F8-\uA8FA\uA8FC\uA92E\uA92F\uA954-\uA95F\uA97D-\uA97F\uA9C1-\uA9CE\uA9DA-\uA9DF\uA9FF\uAA37-\uAA3F\uAA4E\uAA4F\uAA5A-\uAA5F\uAA77-\uAA79\uAAC3-\uAADA\uAADE\uAADF\uAAF0\uAAF1\uAAF7-\uAB00\uAB07\uAB08\uAB0F\uAB10\uAB17-\uAB1F\uAB27\uAB2F\uAB5B\uAB6A-\uAB6F\uABEB\uABEE\uABEF\uABFA-\uABFF\uD7A4-\uD7AF\uD7C7-\uD7CA\uD7FC-\uD7FF\uE000-\uF8FF\uFA6E\uFA6F\uFADA-\uFAFF\uFB07-\uFB12\uFB18-\uFB1C\uFB29\uFB37\uFB3D\uFB3F\uFB42\uFB45\uFBB2-\uFBD2\uFD3E-\uFD4F\uFD90\uFD91\uFDC8-\uFDEF\uFDFC-\uFDFF\uFE10-\uFE1F\uFE30-\uFE32\uFE35-\uFE4C\uFE50-\uFE6F\uFE75\uFEFD-\uFF0F\uFF1A-\uFF20\uFF3B-\uFF3E\uFF40\uFF5B-\uFF65\uFFBF-\uFFC1\uFFC8\uFFC9\uFFD0\uFFD1\uFFD8\uFFD9\uFFDD-\uFFFF]|\uD800[\uDC0C\uDC27\uDC3B\uDC3E\uDC4E\uDC4F\uDC5E-\uDC7F\uDCFB-\uDD3F\uDD75-\uDDFC\uDDFE-\uDE7F\uDE9D-\uDE9F\uDED1-\uDEDF\uDEE1-\uDEFF\uDF20-\uDF2C\uDF4B-\uDF4F\uDF7B-\uDF7F\uDF9E\uDF9F\uDFC4-\uDFC7\uDFD0\uDFD6-\uDFFF]|\uD801[\uDC9E\uDC9F\uDCAA-\uDCAF\uDCD4-\uDCD7\uDCFC-\uDCFF\uDD28-\uDD2F\uDD64-\uDDFF\uDF37-\uDF3F\uDF56-\uDF5F\uDF68-\uDFFF]|\uD802[\uDC06\uDC07\uDC09\uDC36\uDC39-\uDC3B\uDC3D\uDC3E\uDC56-\uDC5F\uDC77-\uDC7F\uDC9F-\uDCDF\uDCF3\uDCF6-\uDCFF\uDD16-\uDD1F\uDD3A-\uDD7F\uDDB8-\uDDBD\uDDC0-\uDDFF\uDE04\uDE07-\uDE0B\uDE14\uDE18\uDE36\uDE37\uDE3B-\uDE3E\uDE40-\uDE5F\uDE7D-\uDE7F\uDE9D-\uDEBF\uDEC8\uDEE7-\uDEFF\uDF36-\uDF3F\uDF56-\uDF5F\uDF73-\uDF7F\uDF92-\uDFFF]|\uD803[\uDC49-\uDC7F\uDCB3-\uDCBF\uDCF3-\uDCFF\uDD28-\uDD2F\uDD3A-\uDE7F\uDEAA\uDEAD-\uDEAF\uDEB2-\uDEFF\uDF1D-\uDF26\uDF28-\uDF2F\uDF51-\uDFAF\uDFC5-\uDFDF\uDFF7-\uDFFF]|\uD804[\uDC47-\uDC65\uDC70-\uDC7E\uDCBB-\uDCCF\uDCE9-\uDCEF\uDCFA-\uDCFF\uDD35\uDD40-\uDD43\uDD48-\uDD4F\uDD74\uDD75\uDD77-\uDD7F\uDDC5-\uDDC8\uDDCD\uDDDB\uDDDD-\uDDFF\uDE12\uDE38-\uDE3D\uDE3F-\uDE7F\uDE87\uDE89\uDE8E\uDE9E\uDEA9-\uDEAF\uDEEB-\uDEEF\uDEFA-\uDEFF\uDF04\uDF0D\uDF0E\uDF11\uDF12\uDF29\uDF31\uDF34\uDF3A\uDF45\uDF46\uDF49\uDF4A\uDF4E\uDF4F\uDF51-\uDF56\uDF58-\uDF5C\uDF64\uDF65\uDF6D-\uDF6F\uDF75-\uDFFF]|\uD805[\uDC4B-\uDC4F\uDC5A-\uDC5D\uDC62-\uDC7F\uDCC6\uDCC8-\uDCCF\uDCDA-\uDD7F\uDDB6\uDDB7\uDDC1-\uDDD7\uDDDE-\uDDFF\uDE41-\uDE43\uDE45-\uDE4F\uDE5A-\uDE7F\uDEB9-\uDEBF\uDECA-\uDEFF\uDF1B\uDF1C\uDF2C-\uDF2F\uDF3A-\uDFFF]|\uD806[\uDC3B-\uDC9F\uDCEA-\uDCFE\uDD07\uDD08\uDD0A\uDD0B\uDD14\uDD17\uDD36\uDD39\uDD3A\uDD44-\uDD4F\uDD5A-\uDD9F\uDDA8\uDDA9\uDDD8\uDDD9\uDDE2\uDDE5-\uDDFF\uDE3F-\uDE46\uDE48-\uDE4F\uDE9A-\uDE9C\uDE9E-\uDEBF\uDEF9-\uDFFF]|\uD807[\uDC09\uDC37\uDC41-\uDC4F\uDC5A-\uDC71\uDC90\uDC91\uDCA8\uDCB7-\uDCFF\uDD07\uDD0A\uDD37-\uDD39\uDD3B\uDD3E\uDD48-\uDD4F\uDD5A-\uDD5F\uDD66\uDD69\uDD8F\uDD92\uDD99-\uDD9F\uDDAA-\uDEDF\uDEF7-\uDFAF\uDFB1-\uDFFF]|\uD808[\uDF9A-\uDFFF]|\uD809[\uDC6F-\uDC7F\uDD44-\uDFFF]|[\uD80A\uD80B\uD80E-\uD810\uD812-\uD819\uD824-\uD82B\uD82D\uD82E\uD830-\uD833\uD837\uD839\uD83D\uD83F\uD87B-\uD87D\uD87F\uD885-\uDB3F\uDB41-\uDBFF][\uDC00-\uDFFF]|\uD80D[\uDC2F-\uDFFF]|\uD811[\uDE47-\uDFFF]|\uD81A[\uDE39-\uDE3F\uDE5F\uDE6A-\uDECF\uDEEE\uDEEF\uDEF5-\uDEFF\uDF37-\uDF3F\uDF44-\uDF4F\uDF5A-\uDF62\uDF78-\uDF7C\uDF90-\uDFFF]|\uD81B[\uDC00-\uDE3F\uDE80-\uDEFF\uDF4B-\uDF4E\uDF88-\uDF8E\uDFA0-\uDFDF\uDFE2\uDFE5-\uDFEF\uDFF2-\uDFFF]|\uD821[\uDFF8-\uDFFF]|\uD823[\uDCD6-\uDCFF\uDD09-\uDFFF]|\uD82C[\uDD1F-\uDD4F\uDD53-\uDD63\uDD68-\uDD6F\uDEFC-\uDFFF]|\uD82F[\uDC6B-\uDC6F\uDC7D-\uDC7F\uDC89-\uDC8F\uDC9A-\uDC9C\uDC9F-\uDFFF]|\uD834[\uDC00-\uDD64\uDD6A-\uDD6C\uDD73-\uDD7A\uDD83\uDD84\uDD8C-\uDDA9\uDDAE-\uDE41\uDE45-\uDFFF]|\uD835[\uDC55\uDC9D\uDCA0\uDCA1\uDCA3\uDCA4\uDCA7\uDCA8\uDCAD\uDCBA\uDCBC\uDCC4\uDD06\uDD0B\uDD0C\uDD15\uDD1D\uDD3A\uDD3F\uDD45\uDD47-\uDD49\uDD51\uDEA6\uDEA7\uDEC1\uDEDB\uDEFB\uDF15\uDF35\uDF4F\uDF6F\uDF89\uDFA9\uDFC3\uDFCC\uDFCD]|\uD836[\uDC00-\uDDFF\uDE37-\uDE3A\uDE6D-\uDE74\uDE76-\uDE83\uDE85-\uDE9A\uDEA0\uDEB0-\uDFFF]|\uD838[\uDC07\uDC19\uDC1A\uDC22\uDC25\uDC2B-\uDCFF\uDD2D-\uDD2F\uDD3E\uDD3F\uDD4A-\uDD4D\uDD4F-\uDEBF\uDEFA-\uDFFF]|\uD83A[\uDCC5-\uDCCF\uDCD7-\uDCFF\uDD4C-\uDD4F\uDD5A-\uDFFF]|\uD83B[\uDC00-\uDDFF\uDE04\uDE20\uDE23\uDE25\uDE26\uDE28\uDE33\uDE38\uDE3A\uDE3C-\uDE41\uDE43-\uDE46\uDE48\uDE4A\uDE4C\uDE50\uDE53\uDE55\uDE56\uDE58\uDE5A\uDE5C\uDE5E\uDE60\uDE63\uDE65\uDE66\uDE6B\uDE73\uDE78\uDE7D\uDE7F\uDE8A\uDE9C-\uDEA0\uDEA4\uDEAA\uDEBC-\uDFFF]|\uD83C[\uDC00-\uDD2F\uDD4A-\uDD4F\uDD6A-\uDD6F\uDD8A-\uDFFF]|\uD83E[\uDC00-\uDFEF\uDFFA-\uDFFF]|\uD869[\uDEDE-\uDEFF]|\uD86D[\uDF35-\uDF3F]|\uD86E[\uDC1E\uDC1F]|\uD873[\uDEA2-\uDEAF]|\uD87A[\uDFE1-\uDFFF]|\uD87E[\uDE1E-\uDFFF]|\uD884[\uDF4B-\uDFFF]|\uDB40[\uDC00-\uDCFF\uDDF0-\uDFFF]/g
 
-;// ./node_modules/rehype-slug/node_modules/github-slugger/index.js
+;// ./node_modules/github-slugger/index.js
 
 
 const own = Object.hasOwnProperty
@@ -73132,6 +73132,12 @@ const stripCommentsTransformer = () => {
 
 
 const STRIP_TAGS = ['script', 'style'];
+/** Valid JS identifier: starts with $, _, or a letter; followed by $, _, letters, digits, etc. */
+const JS_IDENTIFIER_RE = /^[$_\p{L}][$_\p{L}\p{Mn}\p{Mc}\p{Nd}\p{Pc}\u200C\u200D]*$/u;
+/** Format a variable key as MDX syntax, using bracket notation for non-identifier keys (e.g. hyphens). */
+function toMdxVariableSyntax(key) {
+    return JS_IDENTIFIER_RE.test(key) ? `{user.${key}}` : `{user["${key}"]}`;
+}
 /**
  * Extract variable key from MDX expression AST (e.g., {user.name} → 'name')
  * Uses ESTree AST inspection, matching the approach in processor/transform/variables.ts
@@ -73190,6 +73196,9 @@ function plain_one(node, opts) {
             case 'variable':
             case 'Variable': {
                 const key = node.properties.name.toString();
+                if (opts.preserveVariableSyntax) {
+                    return node.properties.isLegacy ? `<<${key}>>` : toMdxVariableSyntax(key);
+                }
                 const val = 'variables' in opts && opts.variables[key];
                 return val || key;
             }
@@ -73213,6 +73222,8 @@ function plain_one(node, opts) {
     if (node.type === 'mdxTextExpression') {
         const key = extractMdxVariableKey(node);
         if (key) {
+            if (opts.preserveVariableSyntax)
+                return toMdxVariableSyntax(key);
             return ('variables' in opts && opts.variables[key]) || key;
         }
     }
@@ -91037,9 +91048,320 @@ const mdxToHast = () => tree => {
 };
 /* harmony default export */ const mdx_to_hast = (mdxToHast);
 
+;// ./lib/mdast-util/legacy-variable/index.ts
+
+const contextMap = new WeakMap();
+function findlegacyVariableToken() {
+    // tokenStack is micromark's current open token ancestry; find the nearest legacyVariable token.
+    const events = this.tokenStack;
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const token = events[i][0];
+        if (token.type === 'legacyVariable')
+            return token;
+    }
+    return undefined;
+}
+function enterlegacyVariable(token) {
+    contextMap.set(token, { value: '' });
+}
+function exitlegacyVariableValue(token) {
+    const variableToken = findlegacyVariableToken.call(this);
+    if (!variableToken)
+        return;
+    const ctx = contextMap.get(variableToken);
+    // Build up the variable characters
+    if (ctx)
+        ctx.value += this.sliceSerialize(token);
+}
+function exitlegacyVariable(token) {
+    const ctx = contextMap.get(token);
+    const serialized = this.sliceSerialize(token);
+    const variableName = serialized.startsWith('<<') && serialized.endsWith('>>')
+        ? serialized.slice(2, -2)
+        : ctx?.value ?? '';
+    const nodePosition = {
+        start: {
+            offset: token.start.offset,
+            line: token.start.line,
+            column: token.start.column,
+        },
+        end: {
+            offset: token.end.offset,
+            line: token.end.line,
+            column: token.end.column,
+        },
+    };
+    if (variableName.startsWith('glossary:')) {
+        const term = variableName.slice('glossary:'.length).trim();
+        this.enter({
+            type: NodeTypes.glossary,
+            data: {
+                hName: 'Glossary',
+                hProperties: { term },
+            },
+            children: [{ type: 'text', value: term }],
+            position: nodePosition,
+        }, token);
+        this.exit(token);
+        contextMap.delete(token);
+        return;
+    }
+    this.enter({
+        type: NodeTypes.variable,
+        data: {
+            hName: 'Variable',
+            hProperties: { name: variableName.trim(), isLegacy: true },
+        },
+        value: `<<${variableName}>>`,
+    }, token);
+    this.exit(token);
+    contextMap.delete(token);
+}
+function legacyVariableFromMarkdown() {
+    return {
+        enter: {
+            legacyVariable: enterlegacyVariable,
+        },
+        exit: {
+            legacyVariableValue: exitlegacyVariableValue,
+            legacyVariable: exitlegacyVariable,
+        },
+    };
+}
+
+;// ./node_modules/micromark-util-symbol/lib/codes.js
+/**
+ * Character codes.
+ *
+ * This module is compiled away!
+ *
+ * micromark works based on character codes.
+ * This module contains constants for the ASCII block and the replacement
+ * character.
+ * A couple of them are handled in a special way, such as the line endings
+ * (CR, LF, and CR+LF, commonly known as end-of-line: EOLs), the tab (horizontal
+ * tab) and its expansion based on what column it’s at (virtual space),
+ * and the end-of-file (eof) character.
+ * As values are preprocessed before handling them, the actual characters LF,
+ * CR, HT, and NUL (which is present as the replacement character), are
+ * guaranteed to not exist.
+ *
+ * Unicode basic latin block.
+ */
+const codes = /** @type {const} */ ({
+  carriageReturn: -5,
+  lineFeed: -4,
+  carriageReturnLineFeed: -3,
+  horizontalTab: -2,
+  virtualSpace: -1,
+  eof: null,
+  nul: 0,
+  soh: 1,
+  stx: 2,
+  etx: 3,
+  eot: 4,
+  enq: 5,
+  ack: 6,
+  bel: 7,
+  bs: 8,
+  ht: 9, // `\t`
+  lf: 10, // `\n`
+  vt: 11, // `\v`
+  ff: 12, // `\f`
+  cr: 13, // `\r`
+  so: 14,
+  si: 15,
+  dle: 16,
+  dc1: 17,
+  dc2: 18,
+  dc3: 19,
+  dc4: 20,
+  nak: 21,
+  syn: 22,
+  etb: 23,
+  can: 24,
+  em: 25,
+  sub: 26,
+  esc: 27,
+  fs: 28,
+  gs: 29,
+  rs: 30,
+  us: 31,
+  space: 32,
+  exclamationMark: 33, // `!`
+  quotationMark: 34, // `"`
+  numberSign: 35, // `#`
+  dollarSign: 36, // `$`
+  percentSign: 37, // `%`
+  ampersand: 38, // `&`
+  apostrophe: 39, // `'`
+  leftParenthesis: 40, // `(`
+  rightParenthesis: 41, // `)`
+  asterisk: 42, // `*`
+  plusSign: 43, // `+`
+  comma: 44, // `,`
+  dash: 45, // `-`
+  dot: 46, // `.`
+  slash: 47, // `/`
+  digit0: 48, // `0`
+  digit1: 49, // `1`
+  digit2: 50, // `2`
+  digit3: 51, // `3`
+  digit4: 52, // `4`
+  digit5: 53, // `5`
+  digit6: 54, // `6`
+  digit7: 55, // `7`
+  digit8: 56, // `8`
+  digit9: 57, // `9`
+  colon: 58, // `:`
+  semicolon: 59, // `;`
+  lessThan: 60, // `<`
+  equalsTo: 61, // `=`
+  greaterThan: 62, // `>`
+  questionMark: 63, // `?`
+  atSign: 64, // `@`
+  uppercaseA: 65, // `A`
+  uppercaseB: 66, // `B`
+  uppercaseC: 67, // `C`
+  uppercaseD: 68, // `D`
+  uppercaseE: 69, // `E`
+  uppercaseF: 70, // `F`
+  uppercaseG: 71, // `G`
+  uppercaseH: 72, // `H`
+  uppercaseI: 73, // `I`
+  uppercaseJ: 74, // `J`
+  uppercaseK: 75, // `K`
+  uppercaseL: 76, // `L`
+  uppercaseM: 77, // `M`
+  uppercaseN: 78, // `N`
+  uppercaseO: 79, // `O`
+  uppercaseP: 80, // `P`
+  uppercaseQ: 81, // `Q`
+  uppercaseR: 82, // `R`
+  uppercaseS: 83, // `S`
+  uppercaseT: 84, // `T`
+  uppercaseU: 85, // `U`
+  uppercaseV: 86, // `V`
+  uppercaseW: 87, // `W`
+  uppercaseX: 88, // `X`
+  uppercaseY: 89, // `Y`
+  uppercaseZ: 90, // `Z`
+  leftSquareBracket: 91, // `[`
+  backslash: 92, // `\`
+  rightSquareBracket: 93, // `]`
+  caret: 94, // `^`
+  underscore: 95, // `_`
+  graveAccent: 96, // `` ` ``
+  lowercaseA: 97, // `a`
+  lowercaseB: 98, // `b`
+  lowercaseC: 99, // `c`
+  lowercaseD: 100, // `d`
+  lowercaseE: 101, // `e`
+  lowercaseF: 102, // `f`
+  lowercaseG: 103, // `g`
+  lowercaseH: 104, // `h`
+  lowercaseI: 105, // `i`
+  lowercaseJ: 106, // `j`
+  lowercaseK: 107, // `k`
+  lowercaseL: 108, // `l`
+  lowercaseM: 109, // `m`
+  lowercaseN: 110, // `n`
+  lowercaseO: 111, // `o`
+  lowercaseP: 112, // `p`
+  lowercaseQ: 113, // `q`
+  lowercaseR: 114, // `r`
+  lowercaseS: 115, // `s`
+  lowercaseT: 116, // `t`
+  lowercaseU: 117, // `u`
+  lowercaseV: 118, // `v`
+  lowercaseW: 119, // `w`
+  lowercaseX: 120, // `x`
+  lowercaseY: 121, // `y`
+  lowercaseZ: 122, // `z`
+  leftCurlyBrace: 123, // `{`
+  verticalBar: 124, // `|`
+  rightCurlyBrace: 125, // `}`
+  tilde: 126, // `~`
+  del: 127,
+  // Unicode Specials block.
+  byteOrderMarker: 65_279,
+  // Unicode Specials block.
+  replacementCharacter: 65_533 // `�`
+})
+
+;// ./lib/micromark/legacy-variable/syntax.ts
+
+
+function isAllowedValueChar(code) {
+    return (code !== null &&
+        code !== codes.lessThan &&
+        code !== codes.greaterThan &&
+        !markdownLineEnding(code));
+}
+const legacyVariableConstruct = {
+    name: 'legacyVariable',
+    tokenize,
+};
+function tokenize(effects, ok, nok) {
+    let hasValue = false;
+    const start = (code) => {
+        if (code !== codes.lessThan)
+            return nok(code);
+        effects.enter('legacyVariable');
+        effects.enter('legacyVariableMarkerStart');
+        effects.consume(code); // <
+        return open2;
+    };
+    const open2 = (code) => {
+        if (code !== codes.lessThan)
+            return nok(code);
+        effects.consume(code); // <<
+        effects.exit('legacyVariableMarkerStart');
+        effects.enter('legacyVariableValue');
+        return value;
+    };
+    const value = (code) => {
+        if (code === codes.greaterThan) {
+            if (!hasValue)
+                return nok(code);
+            effects.exit('legacyVariableValue');
+            effects.enter('legacyVariableMarkerEnd');
+            effects.consume(code); // >
+            return close2;
+        }
+        if (!isAllowedValueChar(code))
+            return nok(code);
+        hasValue = true;
+        effects.consume(code);
+        return value;
+    };
+    const close2 = (code) => {
+        if (code !== codes.greaterThan)
+            return nok(code);
+        effects.consume(code); // >>
+        effects.exit('legacyVariableMarkerEnd');
+        effects.exit('legacyVariable');
+        return ok;
+    };
+    return start;
+}
+function legacyVariable() {
+    return {
+        text: { [codes.lessThan]: legacyVariableConstruct },
+    };
+}
+
+;// ./lib/micromark/legacy-variable/index.ts
+/**
+ * Micromark extension for <<variable>> / <<glossary:term>> inline syntax.
+ */
+
+
 ;// ./processor/transform/mdxish/mdxish-component-blocks.ts
 
 
+
+
 const pascalCaseTagPattern = /^<([A-Z][A-Za-z0-9_]*)([^>]*?)(\/?)>([\s\S]*)?$/;
 const tagAttributePattern = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)(?:\s*=\s*("[^"]*"|'[^']*'|[^\s"'>]+))?/g;
 /**
@@ -91056,7 +91378,10 @@ const MAX_LOOKAHEAD = 30;
  * Glossary and Anchor are inline components.
  */
 const EXCLUDED_TAGS = new Set(['HTMLBlock', 'Table', 'Glossary', 'Anchor']);
-const inlineMdProcessor = unified().use(remarkParse);
+const inlineMdProcessor = unified()
+    .data('micromarkExtensions', [legacyVariable()])
+    .data('fromMarkdownExtensions', [legacyVariableFromMarkdown()])
+    .use(remarkParse);
 const isClosingTag = (value, tag) => value.trim() === `</${tag}>`;
 /**
  * Parse markdown content into mdast children nodes.
@@ -92163,6 +92488,7 @@ const variables = ({ asMdx } = { asMdx: true }) => tree => {
         const name = expression.expression.property.type === 'Identifier'
             ? expression.expression.property.name
             : expression.expression.property.value;
+        const position = 'position' in node ? node.position : undefined;
         const variable = asMdx
             ? {
                 type: 'mdxJsxTextElement',
@@ -92175,7 +92501,7 @@ const variables = ({ asMdx } = { asMdx: true }) => tree => {
                     },
                 ],
                 children: [],
-                position: node.position,
+                position,
             }
             : {
                 type: NodeTypes.variable,
@@ -92186,7 +92512,7 @@ const variables = ({ asMdx } = { asMdx: true }) => tree => {
                     },
                 },
                 value: `{${node.value}}`,
-                position: node.position,
+                position,
             };
         parent.children.splice(index, 1, variable);
     });
@@ -114182,15 +114508,13 @@ function preprocessJSXExpressions(content, context = {}) {
     let processed = protectHTMLBlockContent(content);
     // Step 1: Protect code blocks and inline code
     const { protectedCode, protectedContent } = protectCodeBlocks(processed);
-    // Step 2: Remove JSX comments
-    processed = removeJSXComments(protectedContent);
-    // Step 3: Evaluate attribute expressions (JSX attribute syntax: href={baseUrl})
+    // Step 2: Evaluate attribute expressions (JSX attribute syntax: href={baseUrl})
     // For inline expressions, we use a library to parse the expression & evaluate it later
     // For attribute expressions, it was difficult to use a library to parse them, so do it manually
-    processed = evaluateAttributeExpressions(processed, context, protectedCode);
-    // Step 4: Escape unbalanced braces to prevent MDX expression parsing errors
+    processed = evaluateAttributeExpressions(protectedContent, context, protectedCode);
+    // Step 3: Escape unbalanced braces to prevent MDX expression parsing errors
     processed = escapeUnbalancedBraces(processed);
-    // Step 5: Restore protected code blocks
+    // Step 4: Restore protected code blocks
     processed = restoreCodeBlocks(processed, protectedCode);
     return processed;
 }
@@ -114230,7 +114554,7 @@ const evaluateExpressions = ({ context = {} } = {}) => tree => {
             parent.children.splice(index, 1, {
                 type: 'text',
                 value: textValue,
-                position: node.position,
+                position: expressionNode.position,
             });
         }
         catch (_error) {
@@ -114241,7 +114565,7 @@ const evaluateExpressions = ({ context = {} } = {}) => tree => {
             parent.children.splice(index, 1, {
                 type: 'text',
                 value: `{${processed}}`,
-                position: node.position,
+                position: expressionNode.position,
             });
         }
     });
@@ -114249,6 +114573,43 @@ const evaluateExpressions = ({ context = {} } = {}) => tree => {
 };
 /* harmony default export */ const evaluate_expressions = (evaluateExpressions);
 
+;// ./processor/transform/mdxish/heading-slugs.ts
+
+
+function isHeading(node) {
+    return /^h[1-6]$/.test(node.tagName);
+}
+function textContent(node) {
+    if (node.type === 'text')
+        return node.value;
+    // Process variable nodes by using their variable name for the id generation
+    if (node.type === 'element' && node.tagName === 'variable' && node.properties?.name) {
+        if (node.properties.isLegacy) {
+            return node.properties.name;
+        }
+        return `user.${node.properties.name}`;
+    }
+    if ('children' in node)
+        return node.children.map(textContent).join('');
+    return '';
+}
+/**
+ * Rehype plugin that constructs ids for headings
+ * Id's are used to construct slug anchor links & Table of Contents during rendering
+ * Use the text / nodes that make up the heading to generate the id
+ */
+const generateSlugForHeadings = () => (tree) => {
+    const slugger = new BananaSlug();
+    visit(tree, 'element', (node) => {
+        if (isHeading(node) && !node.properties.id) {
+            const text = node.children.map(textContent).join('');
+            node.properties.id = slugger.slug(text);
+        }
+    });
+    return tree;
+};
+/* harmony default export */ const heading_slugs = (generateSlugForHeadings);
+
 ;// ./node_modules/rehype-parse/lib/index.js
 /**
  * @import {Root} from 'hast'
@@ -114730,6 +115091,8 @@ const EMPTY_CODE_PLACEHOLDER = {
 
 
 
+
+
 /**
  * Wraps a node in a "pinned" container if sidebar: true is set.
  */
@@ -114768,9 +115131,17 @@ const preprocessBody = (text) => {
     return ensureLeadingBreaks(text);
 };
 /** Markdown parser */
-const contentParser = unified().use(remarkParse).use(remarkBreaks).use(remarkGfm).use(normalize_malformed_md_syntax);
+const contentParser = unified()
+    .data('micromarkExtensions', [legacyVariable()])
+    .data('fromMarkdownExtensions', [legacyVariableFromMarkdown()])
+    .use(remarkParse)
+    .use(remarkBreaks)
+    .use(remarkGfm)
+    .use(normalize_malformed_md_syntax);
 /** Markdown to HTML processor (mdast → hast → HTML string) */
 const markdownToHtml = unified()
+    .data('micromarkExtensions', [legacyVariable()])
+    .data('fromMarkdownExtensions', [legacyVariableFromMarkdown()])
     .use(remarkParse)
     .use(remarkGfm)
     .use(normalize_malformed_md_syntax)
@@ -114883,7 +115254,13 @@ const parseTableCell = (text) => {
 };
 const parseBlock = (text) => {
     if (!text.trim())
-        return [{ type: 'paragraph', children: [{ type: 'text', value: '' }] }];
+        return textToBlock('');
+    const tree = contentParser.runSync(contentParser.parse(text));
+    return tree.children;
+};
+const parseInline = (text) => {
+    if (!text.trim())
+        return textToInline(text);
     const tree = contentParser.runSync(contentParser.parse(text));
     return tree.children;
 };
@@ -114944,7 +115321,7 @@ function transformMagicBlock(blockType, data, rawValue, options = {}) {
             const depth = headerJson.level || (compatibilityMode ? 1 : 2);
             return [
                 wrapPinnedBlocks({
-                    children: 'title' in headerJson ? textToInline(headerJson.title || '') : [],
+                    children: 'title' in headerJson ? parseInline(headerJson.title || '') : [],
                     depth,
                     type: 'heading',
                 }, data),
@@ -116104,6 +116481,72 @@ function terminateHtmlFlowBlocks(content) {
     return restoreCodeBlocks(result.join('\n'), protectedCode);
 }
 
+// EXTERNAL MODULE: ./node_modules/@readme/variable/dist/index.js
+var variable_dist = __webpack_require__(4355);
+var variable_dist_default = /*#__PURE__*/__webpack_require__.n(variable_dist);
+;// ./processor/transform/mdxish/variables-code.ts
+
+
+// Single combined regex so that resolved values from one pattern are never re-scanned by the other.
+const COMBINED_VARIABLE_REGEX = new RegExp(`${variable_dist.VARIABLE_REGEXP}|${variable_dist.MDX_VARIABLE_REGEXP}`, 'giu');
+// Flatten variables into a single object for easy lookup
+function variables_code_flattenVariables(variables) {
+    if (!variables)
+        return {};
+    return {
+        ...Object.fromEntries((variables.defaults || []).map(d => [d.name, d.default])),
+        ...variables.user,
+    };
+}
+function resolveCodeVariables(value, resolvedVariables) {
+    return value.replace(COMBINED_VARIABLE_REGEX, (match, legacyName, mdxEscapePrefix, mdxVarName, mdxEscapeSuffix) => {
+        // Legacy variable: <<...>>
+        if (legacyName !== undefined) {
+            if (match.startsWith('\\<<') || match.endsWith('\\>>'))
+                return match;
+            const name = legacyName.trim();
+            if (name.startsWith('glossary:'))
+                return name.toUpperCase();
+            return name in resolvedVariables ? resolvedVariables[name] : name.toUpperCase();
+        }
+        // MDX variable: {user.*}
+        if (mdxEscapePrefix || mdxEscapeSuffix)
+            return match;
+        if (mdxVarName in resolvedVariables)
+            return resolvedVariables[mdxVarName];
+        const fullPath = match.slice(1, -1);
+        return fullPath.toUpperCase();
+    });
+}
+/**
+ * A remark mdast plugin that resolves legacy variables <<...>> and MDX variables {user.*} inside code and inline code nodes
+ * to their values. Uses regexes from the readme variable to search for variables in the code string.
+ *
+ * This is needed because variables in code blocks and inline cannot be tokenized, and also we need to maintain the code string
+ * in the code nodes. This enables engine side variable resolution in codes which improves UX
+ */
+const variablesCodeResolver = ({ variables } = {}) => tree => {
+    const resolvedVariables = variables_code_flattenVariables(variables);
+    visit(tree, 'inlineCode', (node) => {
+        if (!node.value)
+            return;
+        node.value = resolveCodeVariables(node.value, resolvedVariables);
+    });
+    visit(tree, 'code', (node) => {
+        if (!node.value)
+            return;
+        const nextValue = resolveCodeVariables(node.value, resolvedVariables);
+        node.value = nextValue;
+        // Keep code-tabs/readme-components hProperties in sync with node.value
+        // because renderers read `value` from hProperties.
+        if (node.data?.hProperties && typeof node.data.hProperties === 'object') {
+            node.data.hProperties.value = nextValue;
+        }
+    });
+    return tree;
+};
+/* harmony default export */ const variables_code = (variablesCodeResolver);
+
 ;// ./processor/transform/mdxish/variables-text.ts
 
 
@@ -116117,13 +116560,38 @@ function terminateHtmlFlowBlocks(content) {
  * Captures the field name in group 1 (dot notation) or group 2 (bracket notation)
  */
 const USER_VAR_REGEX = /\{user\.(\w+)\}|\{user\[['"](\w+)['"]\]\}/g;
+function makeVariableNode(varName, rawValue) {
+    return {
+        type: NodeTypes.variable,
+        data: {
+            hName: 'Variable',
+            hProperties: { name: varName },
+        },
+        value: rawValue,
+    };
+}
 /**
- * A remark plugin that parses {user.<field>} patterns from text nodes
- * without requiring remarkMdx. Creates Variable nodes for runtime resolution.
+ * A remark plugin that parses {user.<field>} patterns from text nodes and
+ * mdxTextExpression nodes, creating Variable nodes for runtime resolution.
+ *
+ * Handles both:
+ * - `text` nodes: when safeMode is true or after expression evaluation
+ * - `mdxTextExpression` nodes: when mdxExpression has parsed {user.*} before evaluation
  *
  * Supports any user field: name, email, email_verified, exp, iat, etc.
  */
 const variablesTextTransformer = () => tree => {
+    // Handle mdxTextExpression nodes (e.g. {user.name} parsed by mdxExpression)
+    visit(tree, 'mdxTextExpression', (node, index, parent) => {
+        if (index === undefined || !parent)
+            return;
+        const wrapped = `{${(node.value ?? '').trim()}}`; // Wrap the expression value in {} to match the USER_VAR_REGEX pattern
+        const matches = [...wrapped.matchAll(USER_VAR_REGEX)];
+        if (matches.length !== 1)
+            return;
+        const varName = matches[0][1] || matches[0][2];
+        parent.children.splice(index, 1, makeVariableNode(varName, wrapped));
+    });
     visit(tree, 'text', (node, index, parent) => {
         if (index === undefined || !parent)
             return;
@@ -116148,15 +116616,7 @@ const variablesTextTransformer = () => tree => {
             }
             // Extract variable name from either capture group (dot or bracket notation)
             const varName = match[1] || match[2];
-            // Create Variable node
-            parts.push({
-                type: NodeTypes.variable,
-                data: {
-                    hName: 'Variable',
-                    hProperties: { name: varName },
-                },
-                value: match[0],
-            });
+            parts.push(makeVariableNode(varName, match[0]));
             lastIndex = matchIndex + match[0].length;
         });
         // Add remaining text after last match
@@ -116173,7 +116633,7 @@ const variablesTextTransformer = () => tree => {
 /* harmony default export */ const variables_text = (variablesTextTransformer);
 
 ;// ./lib/mdast-util/magic-block/index.ts
-const contextMap = new WeakMap();
+const magic_block_contextMap = new WeakMap();
 /**
  * Find the magicBlock token in the token ancestry.
  */
@@ -116193,7 +116653,7 @@ function findMagicBlockToken() {
  */
 function enterMagicBlock(token) {
     // Initialize context for this magic block
-    contextMap.set(token, { blockType: '', dataChunks: [] });
+    magic_block_contextMap.set(token, { blockType: '', dataChunks: [] });
     this.enter({
         type: 'magicBlock',
         blockType: '',
@@ -116208,7 +116668,7 @@ function exitMagicBlockType(token) {
     const blockToken = findMagicBlockToken.call(this);
     if (!blockToken)
         return;
-    const context = contextMap.get(blockToken);
+    const context = magic_block_contextMap.get(blockToken);
     if (context) {
         context.blockType = this.sliceSerialize(token);
     }
@@ -116220,7 +116680,7 @@ function exitMagicBlockData(token) {
     const blockToken = findMagicBlockToken.call(this);
     if (!blockToken)
         return;
-    const context = contextMap.get(blockToken);
+    const context = magic_block_contextMap.get(blockToken);
     if (context) {
         context.dataChunks.push(this.sliceSerialize(token));
     }
@@ -116232,7 +116692,7 @@ function exitMagicBlockLineEnding(token) {
     const blockToken = findMagicBlockToken.call(this);
     if (!blockToken)
         return;
-    const context = contextMap.get(blockToken);
+    const context = magic_block_contextMap.get(blockToken);
     if (context) {
         context.dataChunks.push(this.sliceSerialize(token));
     }
@@ -116250,7 +116710,7 @@ function exitMagicBlockMarkerEnd(token) {
     // If this marker doesn't end with ']', it's a failed check and content belongs to data
     // The successful end marker would be "[/block]"
     if (!markerContent.endsWith(']') || markerContent !== '[/block]') {
-        const context = contextMap.get(blockToken);
+        const context = magic_block_contextMap.get(blockToken);
         if (context) {
             context.dataChunks.push(markerContent);
         }
@@ -116260,7 +116720,7 @@ function exitMagicBlockMarkerEnd(token) {
  * Exit handler: Finalize the magicBlock node with parsed JSON data.
  */
 function exitMagicBlock(token) {
-    const context = contextMap.get(token);
+    const context = magic_block_contextMap.get(token);
     const node = this.stack[this.stack.length - 1];
     if (context) {
         const rawJson = context.dataChunks.join('');
@@ -116275,7 +116735,7 @@ function exitMagicBlock(token) {
             node.data = {};
         }
         // Clean up context
-        contextMap.delete(token);
+        magic_block_contextMap.delete(token);
     }
     this.exit(token);
 }
@@ -116328,166 +116788,6 @@ function magicBlockToMarkdown() {
     };
 }
 
-;// ./node_modules/micromark-util-symbol/lib/codes.js
-/**
- * Character codes.
- *
- * This module is compiled away!
- *
- * micromark works based on character codes.
- * This module contains constants for the ASCII block and the replacement
- * character.
- * A couple of them are handled in a special way, such as the line endings
- * (CR, LF, and CR+LF, commonly known as end-of-line: EOLs), the tab (horizontal
- * tab) and its expansion based on what column it’s at (virtual space),
- * and the end-of-file (eof) character.
- * As values are preprocessed before handling them, the actual characters LF,
- * CR, HT, and NUL (which is present as the replacement character), are
- * guaranteed to not exist.
- *
- * Unicode basic latin block.
- */
-const codes = /** @type {const} */ ({
-  carriageReturn: -5,
-  lineFeed: -4,
-  carriageReturnLineFeed: -3,
-  horizontalTab: -2,
-  virtualSpace: -1,
-  eof: null,
-  nul: 0,
-  soh: 1,
-  stx: 2,
-  etx: 3,
-  eot: 4,
-  enq: 5,
-  ack: 6,
-  bel: 7,
-  bs: 8,
-  ht: 9, // `\t`
-  lf: 10, // `\n`
-  vt: 11, // `\v`
-  ff: 12, // `\f`
-  cr: 13, // `\r`
-  so: 14,
-  si: 15,
-  dle: 16,
-  dc1: 17,
-  dc2: 18,
-  dc3: 19,
-  dc4: 20,
-  nak: 21,
-  syn: 22,
-  etb: 23,
-  can: 24,
-  em: 25,
-  sub: 26,
-  esc: 27,
-  fs: 28,
-  gs: 29,
-  rs: 30,
-  us: 31,
-  space: 32,
-  exclamationMark: 33, // `!`
-  quotationMark: 34, // `"`
-  numberSign: 35, // `#`
-  dollarSign: 36, // `$`
-  percentSign: 37, // `%`
-  ampersand: 38, // `&`
-  apostrophe: 39, // `'`
-  leftParenthesis: 40, // `(`
-  rightParenthesis: 41, // `)`
-  asterisk: 42, // `*`
-  plusSign: 43, // `+`
-  comma: 44, // `,`
-  dash: 45, // `-`
-  dot: 46, // `.`
-  slash: 47, // `/`
-  digit0: 48, // `0`
-  digit1: 49, // `1`
-  digit2: 50, // `2`
-  digit3: 51, // `3`
-  digit4: 52, // `4`
-  digit5: 53, // `5`
-  digit6: 54, // `6`
-  digit7: 55, // `7`
-  digit8: 56, // `8`
-  digit9: 57, // `9`
-  colon: 58, // `:`
-  semicolon: 59, // `;`
-  lessThan: 60, // `<`
-  equalsTo: 61, // `=`
-  greaterThan: 62, // `>`
-  questionMark: 63, // `?`
-  atSign: 64, // `@`
-  uppercaseA: 65, // `A`
-  uppercaseB: 66, // `B`
-  uppercaseC: 67, // `C`
-  uppercaseD: 68, // `D`
-  uppercaseE: 69, // `E`
-  uppercaseF: 70, // `F`
-  uppercaseG: 71, // `G`
-  uppercaseH: 72, // `H`
-  uppercaseI: 73, // `I`
-  uppercaseJ: 74, // `J`
-  uppercaseK: 75, // `K`
-  uppercaseL: 76, // `L`
-  uppercaseM: 77, // `M`
-  uppercaseN: 78, // `N`
-  uppercaseO: 79, // `O`
-  uppercaseP: 80, // `P`
-  uppercaseQ: 81, // `Q`
-  uppercaseR: 82, // `R`
-  uppercaseS: 83, // `S`
-  uppercaseT: 84, // `T`
-  uppercaseU: 85, // `U`
-  uppercaseV: 86, // `V`
-  uppercaseW: 87, // `W`
-  uppercaseX: 88, // `X`
-  uppercaseY: 89, // `Y`
-  uppercaseZ: 90, // `Z`
-  leftSquareBracket: 91, // `[`
-  backslash: 92, // `\`
-  rightSquareBracket: 93, // `]`
-  caret: 94, // `^`
-  underscore: 95, // `_`
-  graveAccent: 96, // `` ` ``
-  lowercaseA: 97, // `a`
-  lowercaseB: 98, // `b`
-  lowercaseC: 99, // `c`
-  lowercaseD: 100, // `d`
-  lowercaseE: 101, // `e`
-  lowercaseF: 102, // `f`
-  lowercaseG: 103, // `g`
-  lowercaseH: 104, // `h`
-  lowercaseI: 105, // `i`
-  lowercaseJ: 106, // `j`
-  lowercaseK: 107, // `k`
-  lowercaseL: 108, // `l`
-  lowercaseM: 109, // `m`
-  lowercaseN: 110, // `n`
-  lowercaseO: 111, // `o`
-  lowercaseP: 112, // `p`
-  lowercaseQ: 113, // `q`
-  lowercaseR: 114, // `r`
-  lowercaseS: 115, // `s`
-  lowercaseT: 116, // `t`
-  lowercaseU: 117, // `u`
-  lowercaseV: 118, // `v`
-  lowercaseW: 119, // `w`
-  lowercaseX: 120, // `x`
-  lowercaseY: 121, // `y`
-  lowercaseZ: 122, // `z`
-  leftCurlyBrace: 123, // `{`
-  verticalBar: 124, // `|`
-  rightCurlyBrace: 125, // `}`
-  tilde: 126, // `~`
-  del: 127,
-  // Unicode Specials block.
-  byteOrderMarker: 65_279,
-  // Unicode Specials block.
-  replacementCharacter: 65_533 // `�`
-})
-
 ;// ./lib/micromark/magic-block/syntax.ts
 
 
@@ -117406,6 +117706,10 @@ function loadComponents() {
 
 
 
+
+
+
+
 
 
 
@@ -117454,8 +117758,10 @@ function mdxishAstProcessor(mdContent, opts = {}) {
         text: mdxExprExt.text,
     };
     const processor = unified()
-        .data('micromarkExtensions', safeMode ? [magicBlock()] : [magicBlock(), mdxExprTextOnly])
-        .data('fromMarkdownExtensions', safeMode ? [magicBlockFromMarkdown()] : [magicBlockFromMarkdown(), mdxExpressionFromMarkdown()])
+        .data('micromarkExtensions', safeMode ? [magicBlock(), legacyVariable()] : [magicBlock(), mdxExprTextOnly, legacyVariable()])
+        .data('fromMarkdownExtensions', safeMode
+        ? [magicBlockFromMarkdown(), legacyVariableFromMarkdown()]
+        : [magicBlockFromMarkdown(), mdxExpressionFromMarkdown(), legacyVariableFromMarkdown()])
         .use(remarkParse)
         .use(remarkFrontmatter)
         .use(normalize_malformed_md_syntax)
@@ -117467,8 +117773,7 @@ function mdxishAstProcessor(mdContent, opts = {}) {
         .use(mdxish_tables)
         .use(mdxish_html_blocks)
         .use(newEditorTypes ? mdxish_jsx_to_mdast : undefined) // Convert JSX elements to MDAST types
-        .use(safeMode ? undefined : evaluate_expressions, { context: jsxContext }) // Evaluate MDX expressions using jsxContext
-        .use(variables_text) // Parse {user.*} patterns from text
+        .use(variables_text) // Parse {user.*} patterns from text nodes
         .use(useTailwind ? transform_tailwind : undefined, { components: tempComponentsMap })
         .use(remarkGfm);
     return {
@@ -117502,20 +117807,26 @@ function mdxishMdastToMd(mdast) {
  * @see {@link https://github.com/readmeio/rmdx/blob/main/docs/mdxish-flow.md}
  */
 function mdxish(mdContent, opts = {}) {
-    const { components: userComponents = {} } = opts;
+    const { components: userComponents = {}, jsxContext = {}, safeMode = false, variables } = opts;
     const components = {
         ...loadComponents(),
         ...userComponents,
     };
-    const { processor, parserReadyContent } = mdxishAstProcessor(mdContent, opts);
+    // Remove JSX comments before processing (protect code blocks first)
+    const { protectedCode, protectedContent } = protectCodeBlocks(mdContent);
+    const withoutComments = removeJSXComments(protectedContent);
+    const contentWithoutComments = restoreCodeBlocks(withoutComments, protectedCode);
+    const { processor, parserReadyContent } = mdxishAstProcessor(contentWithoutComments, opts);
     processor
+        .use(safeMode ? undefined : evaluate_expressions, { context: jsxContext }) // Evaluate MDX expressions using jsxContext
         .use(remarkBreaks)
+        .use(variables_code, { variables }) // Resolve <<...>> and {user.*} inside code and inline code nodes
         .use(remarkRehype, { allowDangerousHtml: true, handlers: mdxComponentHandlers })
         .use(preserveBooleanProperties) // RehypeRaw converts boolean properties to empty strings
         .use(rehypeRaw, { passThrough: ['html-block'] })
         .use(restoreBooleanProperties)
         .use(mdxish_mermaid) // Add mermaid-render className to pre wrappers
-        .use(rehypeSlug)
+        .use(heading_slugs)
         .use(rehypeMdxishComponents, {
         components,
         processMarkdown: (markdown) => mdxish(markdown, opts),
@@ -117655,9 +117966,6 @@ const migrate = (doc, opts) => {
 };
 /* harmony default export */ const lib_migrate = (migrate);
 
-// EXTERNAL MODULE: ./node_modules/@readme/variable/dist/index.js
-var variable_dist = __webpack_require__(4355);
-var variable_dist_default = /*#__PURE__*/__webpack_require__.n(variable_dist);
 // EXTERNAL MODULE: ./node_modules/rehype-react/index.js
 var rehype_react = __webpack_require__(26);
 var rehype_react_default = /*#__PURE__*/__webpack_require__.n(rehype_react);
@@ -118069,6 +118377,7 @@ function restoreMagicBlocks(replaced, blocks) {
 
 
 
+
 /**
  * Removes Markdown and MDX comments.
  */
@@ -118089,6 +118398,7 @@ async function stripComments(doc, { mdx, mdxish } = {}) {
         .use(normalize_malformed_md_syntax)
         .use(mdx ? remarkMdx : undefined)
         .use(stripCommentsTransformer)
+        .use(remarkGfm)
         .use(remarkStringify, mdx
         ? {}
         : {