@terra-symposium/docs 0.2.1 → 0.4.0

package/dist/lib/lib/markdown-model.js

@@ -25,7 +25,7 @@ function restoreInlineMathPlaceholders(value) {
         return code === undefined ? placeholder : `$${code}$`;
     });
 }
-function withGeneratedInlineMathTokens(tokens) {
+function withGenInlineMathTokens(tokens) {
     const result = [];
     for (const token of tokens ?? []) {
         if (!['text', 'escape'].includes(token.type)) {
@@ -131,10 +131,10 @@ function withInlineMathTokens(tokens, inlineMath) {
 function inline(tokens, markDefs, inlineMath = true, inheritedMarks = []) {
     if (!tokens)
         return [];
-    let activeMarks = [...inheritedMarks];
+    let aMarks = [...inheritedMarks];
     const result = [];
-    const addMark = (items, mark) => items.map((item) => (item._type === 'span' ? { ...item, marks: [...item.marks, mark] } : item));
-    for (const token of withInlineMathTokens(inlineMath ? withGeneratedInlineMathTokens(tokens) : tokens, inlineMath)) {
+    const addMark = (items, mark) => items.map((i) => (i._type === 'span' ? { ...i, marks: [...i.marks, mark] } : i));
+    for (const token of withInlineMathTokens(inlineMath ? withGenInlineMathTokens(tokens) : tokens, inlineMath)) {
         if (token.type === 'docsMath') {
             result.push({ _type: 'math', _key: key(), code: token.text ?? '', inline: true });
             continue;
@@ -152,39 +152,39 @@ function inline(tokens, markDefs, inlineMath = true, inheritedMarks = []) {
                                 ? 'strong'
                                 : 'strike-through';
                 if (tag[1])
-                    activeMarks = activeMarks.filter((item) => item !== mark);
+                    aMarks = aMarks.filter((i) => i !== mark);
                 else
-                    activeMarks = [...activeMarks, mark];
+                    aMarks = [...aMarks, mark];
                 continue;
             }
             if (/^<br\s*\/?>$/i.test(token.raw)) {
-                result.push(span('\n', activeMarks));
+                result.push(span('\n', aMarks));
                 continue;
             }
-            result.push(span(token.raw, activeMarks));
+            result.push(span(token.raw, aMarks));
             continue;
         }
         if (token.type === 'strong') {
-            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, activeMarks), 'strong'));
+            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, aMarks), 'strong'));
             continue;
         }
         if (token.type === 'em') {
-            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, activeMarks), 'em'));
+            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, aMarks), 'em'));
             continue;
         }
         if (token.type === 'del') {
-            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, activeMarks), 'strike-through'));
+            result.push(...addMark(inline(token.tokens, markDefs, inlineMath, aMarks), 'strike-through'));
             continue;
         }
         if (token.type === 'link') {
             const href = typeof token.href === 'string' ? token.href : '';
             if (!href || !/^(?:https?:\/\/|mailto:|tel:|\/|\.\.?\/|#)/i.test(href)) {
-                result.push(span(token.raw, activeMarks));
+                result.push(span(token.raw, aMarks));
                 continue;
             }
             const mark = key();
             markDefs.push({ _type: 'link', _key: mark, href });
-            const linked = addMark(inline(token.tokens, markDefs, inlineMath, activeMarks), mark);
+            const linked = addMark(inline(token.tokens, markDefs, inlineMath, aMarks), mark);
             const joined = [];
             for (const item of linked) {
                 const previous = joined.at(-1);
@@ -200,8 +200,8 @@ function inline(tokens, markDefs, inlineMath = true, inheritedMarks = []) {
         }
         if (token.type === 'text' || token.type === 'escape') {
             const tokenText = token.text ?? token.raw;
-            if (activeMarks.includes('code')) {
-                result.push(span(decodeHtml(tokenText), activeMarks));
+            if (aMarks.includes('code')) {
+                result.push(span(decodeHtml(tokenText), aMarks));
                 continue;
             }
             const pieces = tokenText.split(/(\$[^$\n]+\$)/g).filter(Boolean);
@@ -212,19 +212,19 @@ function inline(tokens, markDefs, inlineMath = true, inheritedMarks = []) {
                     code: piece.slice(1, -1),
                     inline: true,
                 }
-                : span(piece, activeMarks)));
+                : span(piece, aMarks)));
             continue;
         }
         if (token.type === 'codespan') {
-            result.push(span(token.text ?? token.raw, [...activeMarks, 'code']));
+            result.push(span(token.text ?? token.raw, [...aMarks, 'code']));
             continue;
         }
         if (token.type === 'br') {
-            result.push(span('\n', activeMarks));
+            result.push(span('\n', aMarks));
             continue;
         }
         // Images in the middle of prose have no Portable Text inline equivalent. Keep their source.
-        result.push(span(token.raw, activeMarks));
+        result.push(span(token.raw, aMarks));
     }
     return result;
 }
@@ -390,7 +390,7 @@ function structuredBlockRanges(source) {
         .map((match) => ({ start: match.index ?? 0, end: (match.index ?? 0) + match[0].length }))
         .sort((a, b) => a.start - b.start);
 }
-function readBracedExpression(source, start) {
+function readBracedExpr(source, start) {
     if (source[start] !== '{')
         return undefined;
     let depth = 1;
@@ -422,7 +422,7 @@ function readBracedExpression(source, start) {
 }
 function readJsxTagEnd(source, start) {
     let quote;
-    let expressionDepth = 0;
+    let exprDepth = 0;
     for (let index = start + 1; index < source.length; index += 1) {
         const char = source[index];
         if (quote) {
@@ -439,10 +439,10 @@ function readJsxTagEnd(source, start) {
             continue;
         }
         if (char === '{')
-            expressionDepth += 1;
-        else if (char === '}' && expressionDepth > 0)
-            expressionDepth -= 1;
-        else if (char === '>' && expressionDepth === 0)
+            exprDepth += 1;
+        else if (char === '}' && exprDepth > 0)
+            exprDepth -= 1;
+        else if (char === '>' && exprDepth === 0)
             return index + 1;
     }
     return undefined;
@@ -477,8 +477,8 @@ function parseJsxLiteral(source) {
         return undefined;
     }
 }
-function parseJsxAttributes(source) {
-    const attributes = {};
+function parseJsxAttrs(source) {
+    const attrs = {};
     let index = 0;
     while (index < source.length) {
         while (/\s/.test(source[index] ?? ''))
@@ -492,7 +492,7 @@ function parseJsxAttributes(source) {
         while (/\s/.test(source[index] ?? ''))
             index += 1;
         if (source[index] !== '=') {
-            attributes[name] = true;
+            attrs[name] = true;
             continue;
         }
         index += 1;
@@ -513,15 +513,15 @@ function parseJsxAttributes(source) {
                 }
                 index += 1;
             }
-            attributes[name] = parseJsxLiteral(source.slice(start, index));
+            attrs[name] = parseJsxLiteral(source.slice(start, index));
             continue;
         }
         if (source[index] === '{') {
-            const expression = readBracedExpression(source, index);
-            if (!expression)
+            const expr = readBracedExpr(source, index);
+            if (!expr)
                 break;
-            attributes[name] = parseJsxLiteral(expression.value);
-            index = expression.end;
+            attrs[name] = parseJsxLiteral(expr.value);
+            index = expr.end;
             continue;
         }
         const bare = source.slice(index).match(/^[^\s/>]+/)?.[0];
@@ -529,10 +529,10 @@ function parseJsxAttributes(source) {
             index += 1;
             continue;
         }
-        attributes[name] = parseJsxLiteral(bare);
+        attrs[name] = parseJsxLiteral(bare);
         index += bare.length;
     }
-    return attributes;
+    return attrs;
 }
 function readJsxOpeningTag(source, start) {
     if (source[start] !== '<')
@@ -548,18 +548,18 @@ function readJsxOpeningTag(source, start) {
     const selfClosing = /\/\s*$/.test(shell);
     return {
         name,
-        attributes: parseJsxAttributes(shell.replace(/\/\s*$/, '')),
+        attributes: parseJsxAttrs(shell.replace(/\/\s*$/, '')),
         end,
         selfClosing,
     };
 }
-function codeBodyExpression(source, start) {
+function codeBodyExpr(source, start) {
     const first = source.slice(start).match(/^\s*\{/);
     if (!first)
         return undefined;
-    const expressionStart = start + first[0].length - 1;
-    const body = source.slice(expressionStart + 1).match(/^\s*`/);
-    return body ? readBracedExpression(source, expressionStart) : undefined;
+    const exprStart = start + first[0].length - 1;
+    const body = source.slice(exprStart + 1).match(/^\s*`/);
+    return body ? readBracedExpr(source, exprStart) : undefined;
 }
 function jsxComponentEnd(source, opening) {
     return jsxComponentRange(source, opening)?.end ?? source.length;
@@ -567,20 +567,20 @@ function jsxComponentEnd(source, opening) {
 function jsxComponentRange(source, opening) {
     if (opening.selfClosing)
         return { bodyEnd: opening.end, end: opening.end };
-    const expression = opening.name === 'Code' ? codeBodyExpression(source, opening.end) : undefined;
+    const expr = opening.name === 'Code' ? codeBodyExpr(source, opening.end) : undefined;
     const closePattern = new RegExp(`<\\/${opening.name}\\s*>`, 'g');
-    closePattern.lastIndex = expression?.end ?? opening.end;
+    closePattern.lastIndex = expr?.end ?? opening.end;
     const close = closePattern.exec(source);
     if (opening.name === 'Code') {
         // Older exported leaves can omit an end tag before the next Code block. Treat that next
         // opening tag as the boundary instead of swallowing every following code sample.
-        const nextOpening = source.indexOf('<Code', expression?.end ?? opening.end);
-        if (nextOpening !== -1 && (!close || nextOpening < close.index))
-            return { bodyEnd: nextOpening, end: nextOpening };
+        const nOpening = source.indexOf('<Code', expr?.end ?? opening.end);
+        if (nOpening !== -1 && (!close || nOpening < close.index))
+            return { bodyEnd: nOpening, end: nOpening };
     }
     return close ? { bodyEnd: close.index, end: close.index + close[0].length } : undefined;
 }
-function parseArrayAttribute(value) {
+function parseArrayAttr(value) {
     if (Array.isArray(value))
         return value;
     if (typeof value !== 'string')
@@ -593,51 +593,51 @@ function parseArrayAttribute(value) {
         return undefined;
     }
 }
-function componentBlock(name, attributes, body) {
-    const expression = codeBodyExpression(body, 0);
-    const bodyValue = expression ? parseJsxLiteral(expression.value) : decodeHtml(body.trim());
+function componentBlock(name, attrs, body) {
+    const expr = codeBodyExpr(body, 0);
+    const bodyValue = expr ? parseJsxLiteral(expr.value) : decodeHtml(body.trim());
     if (name === 'Nodes') {
-        const nodes = parseArrayAttribute(attributes.nodes);
-        const edges = parseArrayAttribute(attributes.edges);
-        if (('nodes' in attributes && !nodes) || ('edges' in attributes && !edges))
+        const nodes = parseArrayAttr(attrs.nodes);
+        const edges = parseArrayAttr(attrs.edges);
+        if (('nodes' in attrs && !nodes) || ('edges' in attrs && !edges))
             return undefined;
         return {
             _type: 'nodes',
             _key: key(),
-            ...attributes,
+            ...attrs,
             nodes: Array.isArray(nodes) ? nodes : [],
             edges: Array.isArray(edges) ? edges : [],
         };
     }
     if (name === 'Code') {
-        const language = typeof attributes.language === 'string' ? attributes.language : '';
-        const source = typeof attributes.source === 'string' ? attributes.source : undefined;
-        const codeAttribute = typeof attributes.code === 'string' ? attributes.code : undefined;
+        const lang = typeof attrs.language === 'string' ? attrs.language : '';
+        const source = typeof attrs.source === 'string' ? attrs.source : undefined;
+        const codeAttr = typeof attrs.code === 'string' ? attrs.code : undefined;
         const value = typeof bodyValue === 'string'
             ? bodyValue.replace(/^\r?\n/, '').replace(/\r?\n$/, '')
-            : (codeAttribute ?? '');
+            : (codeAttr ?? '');
         return {
             _type: 'code',
             _key: key(),
-            language,
+            language: lang,
             ...(source ? { source } : {}),
-            value: value || codeAttribute || '',
+            value: value || codeAttr || '',
         };
     }
     if (name === 'Embed')
         return {
             _type: 'embed',
             _key: key(),
-            ...attributes,
-            src: typeof attributes.src === 'string' ? attributes.src : '',
-            title: typeof attributes.title === 'string' ? attributes.title : '',
+            ...attrs,
+            src: typeof attrs.src === 'string' ? attrs.src : '',
+            title: typeof attrs.title === 'string' ? attrs.title : '',
         };
     if (name === 'TsDocs')
         return {
             _type: 'tsDocs',
             _key: key(),
-            ...attributes,
-            scope: typeof attributes.scope === 'string' ? attributes.scope : '',
+            ...attrs,
+            scope: typeof attrs.scope === 'string' ? attrs.scope : '',
         };
     return undefined;
 }
@@ -814,8 +814,8 @@ function decodeHtmlRepeated(value) {
     }
     return current;
 }
-function htmlAttribute(attributes, name) {
-    const match = attributes.match(new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i'));
+function htmlAttr(attrs, name) {
+    const match = attrs.match(new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i'));
     const value = match?.[1] ?? match?.[2] ?? match?.[3];
     return value === undefined ? undefined : decodeHtml(value);
 }
@@ -887,7 +887,7 @@ function htmlToMarkdown(source, inlineMath) {
         }
         const closing = /^<\//.test(raw);
         const selfClosing = /\/\s*>$/.test(raw);
-        const attributes = match[2] ?? '';
+        const attrs = match[2] ?? '';
         output += escapeHtmlTableText(source.slice(copiedUntil, index), inlineMath);
         copiedUntil = tagPattern.lastIndex;
         if (closing) {
@@ -903,9 +903,9 @@ function htmlToMarkdown(source, inlineMath) {
             continue;
         }
         if (name === 'img') {
-            const alt = htmlAttribute(attributes, 'alt') ?? 'image';
-            const src = htmlAttribute(attributes, 'src') ?? '';
-            const title = htmlAttribute(attributes, 'title');
+            const alt = htmlAttr(attrs, 'alt') ?? 'image';
+            const src = htmlAttr(attrs, 'src') ?? '';
+            const title = htmlAttr(attrs, 'title');
             const escapedTitle = title?.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
             output += src
                 ? `![${escapeMarkdownText(alt)}](${markdownDestination(src)}${escapedTitle ? ` "${escapedTitle}"` : ''})`
@@ -929,7 +929,7 @@ function htmlToMarkdown(source, inlineMath) {
         let open = '';
         let close = '';
         if (name === 'a') {
-            const href = htmlAttribute(attributes, 'href');
+            const href = htmlAttr(attrs, 'href');
             if (href)
                 [open, close] = ['[', `](${markdownDestination(href)})`];
         }
@@ -1018,14 +1018,14 @@ function tableBlock(rows, markdown, options, header = 'Table') {
         })),
     };
 }
-function markdownImagesAsBlocks(source, options, blocks) {
+function markdownImgsAsBlocks(source, options, blocks) {
     if (!enabled(options, 'docImage'))
         return source;
-    const images = [];
+    const imgs = [];
     const visit = (tokens, insideLink = false) => {
         for (const token of tokens ?? []) {
             if (token.type === 'image' && !insideLink)
-                images.push(token);
+                imgs.push(token);
             else if (token.tokens)
                 visit(token.tokens, insideLink || token.type === 'link');
         }
@@ -1033,17 +1033,17 @@ function markdownImagesAsBlocks(source, options, blocks) {
     visit(marked.lexer(source, { gfm: true }));
     let result = source;
     let cursor = 0;
-    for (const image of images) {
-        const raw = image.raw;
+    for (const img of imgs) {
+        const raw = img.raw;
         const index = result.indexOf(raw, cursor);
-        if (index < 0 || typeof image.href !== 'string')
+        if (index < 0 || typeof img.href !== 'string')
             continue;
         const block = {
             _type: 'docImage',
             _key: key(),
-            alt: image.text ?? '',
-            url: image.href,
-            ...(image.title ? { title: image.title } : {}),
+            alt: img.text ?? '',
+            url: img.href,
+            ...(img.title ? { title: img.title } : {}),
             markdown: raw,
         };
         const placeholder = richPlaceholder(blocks, block);
@@ -1065,7 +1065,7 @@ function htmlTableBlock(source, options, blocks) {
                 const original = blocks[Number(indexText)];
                 return original ? richPlaceholder(cellBlocks, original) : placeholder;
             });
-            const cellMarkdown = markdownImagesAsBlocks(cellMarkdownWithBlocks, options, cellBlocks);
+            const cellMarkdown = markdownImgsAsBlocks(cellMarkdownWithBlocks, options, cellBlocks);
             return {
                 _type: 'cell',
                 _key: key(),
@@ -1143,11 +1143,11 @@ function parseGroupedItems(source, options, blocks) {
     for (let index = 0; index < markers.length; index += 1) {
         const marker = markers[index];
         const bodyStart = (marker.index ?? 0) + marker[0].length;
-        const nextStart = markers[index + 1]?.index ?? source.length;
+        const nStart = markers[index + 1]?.index ?? source.length;
         const closing = /^:::terra-item-end[ \t]*\r?$/gm;
         closing.lastIndex = bodyStart;
         const end = closing.exec(source);
-        if (!end || end.index >= nextStart || source.slice(end.index + end[0].length, nextStart).trim())
+        if (!end || end.index >= nStart || source.slice(end.index + end[0].length, nStart).trim())
             return undefined;
         let title;
         try {
@@ -1225,9 +1225,9 @@ function parseMarkdown(markdown, options, blocks) {
         try {
             const data = parseYaml(payload);
             if (data && data._type === type) {
-                const normalized = type === 'table' ? parseMarkdownTableCells(data, options, blocks) : data;
+                const norm = type === 'table' ? parseMarkdownTableCells(data, options, blocks) : data;
                 return enabled(options, type)
-                    ? richPlaceholder(blocks, normalized)
+                    ? richPlaceholder(blocks, norm)
                     : rawPlaceholder(blocks, source);
             }
         }
@@ -1304,16 +1304,16 @@ function parseMarkdown(markdown, options, blocks) {
             continue;
         }
         if (token.type === 'paragraph') {
-            const image = token.tokens?.length === 1 && token.tokens[0]?.type === 'image'
+            const img = token.tokens?.length === 1 && token.tokens[0]?.type === 'image'
                 ? token.tokens[0]
                 : undefined;
-            if (image && enabled(options, 'docImage')) {
+            if (img && enabled(options, 'docImage')) {
                 result.push({
                     _type: 'docImage',
                     _key: key(),
-                    alt: image.text ?? '',
-                    url: image.href ?? '',
-                    ...(image.title ? { title: image.title } : {}),
+                    alt: img.text ?? '',
+                    url: img.href ?? '',
+                    ...(img.title ? { title: img.title } : {}),
                     markdown: token.raw,
                 });
                 continue;
@@ -1600,15 +1600,15 @@ function escapeTableAutolinks(markdown) {
         .replace(/\b((?:https?|ftp)):\/\//gi, '$1&#58;//')
         .replace(/\b(www)\./gi, '$1&#46;')
         .replace(/\b([A-Z0-9._%+-]+)@([A-Z0-9.-]+\.[A-Z]{2,})\b/gi, '$1&#64;$2');
-    return escaped.replace(/DOCSTABLEPROTECTED(\d+)TOKEN/g, (_match, index) => protectedParts[Number(index)] ?? _match);
+    return escaped.replace(/DOCSTABLEPROTECTED(\d+)TOKEN/g, (_match, i) => protectedParts[Number(i)] ?? _match);
 }
 function tableToMarkdown(block) {
     const rows = Array.isArray(block.rows) ? block.rows : [];
     const fallback = richBlockDirective(block);
     if (!rows.length)
         return fallback;
-    const columnCounts = rows.map((row) => (Array.isArray(row.cells) ? row.cells.length : 0));
-    const rectangular = columnCounts.every((count) => count === columnCounts[0]);
+    const colCounts = rows.map((row) => (Array.isArray(row.cells) ? row.cells.length : 0));
+    const rectangular = colCounts.every((count) => count === colCounts[0]);
     const simpleRows = rectangular &&
         rows.every((row) => {
             if (row._type !== 'row' || !onlyOwnFields(row, ['_type', '_key', 'cells']))
@@ -1768,15 +1768,15 @@ function emptyPortableTextParagraph(value) {
 }
 function semanticMarkdownValue(value) {
     if (Array.isArray(value))
-        return value.filter((item) => !emptyPortableTextParagraph(item)).map(semanticMarkdownValue);
+        return value.filter((i) => !emptyPortableTextParagraph(i)).map(semanticMarkdownValue);
     if (!value || typeof value !== 'object')
         return value;
     const block = value;
     const type = block._type;
     if (type === 'block' || type === 'terraBlock') {
         const definitions = new Map((Array.isArray(block.markDefs) ? block.markDefs : [])
-            .filter((item) => Boolean(item) && typeof item === 'object')
-            .map((item) => [String(item._key ?? ''), semanticMarkdownValue(item)]));
+            .filter((i) => Boolean(i) && typeof i === 'object')
+            .map((i) => [String(i._key ?? ''), semanticMarkdownValue(i)]));
         const children = [];
         for (const child of Array.isArray(block.children) ? block.children : []) {
             if (!child || typeof child !== 'object') {
@@ -1822,8 +1822,8 @@ function semanticMarkdownValue(value) {
             'children',
         ].includes(name))
             .sort(([left], [right]) => left.localeCompare(right))
-            .map(([name, item]) => [name, semanticMarkdownValue(item)]));
-        const markDefs = [...definitions.values()].map((item) => JSON.stringify(item)).sort();
+            .map(([name, i]) => [name, semanticMarkdownValue(i)]));
+        const markDefs = [...definitions.values()].map((i) => JSON.stringify(i)).sort();
         return {
             ...extra,
             _type: 'textBlock',
@@ -1837,9 +1837,8 @@ function semanticMarkdownValue(value) {
     // Empty, metadata-free Portable Text paragraphs have no visible Markdown
     // representation. Ignore them in all nested block arrays (including callouts
     // and table cells), while retaining the original records in the source archive.
-    const semanticBlock = block;
-    const nestedContent = Array.isArray(semanticBlock.content) ? semanticBlock.content : undefined;
-    const extra = Object.fromEntries(Object.entries(semanticBlock)
+    const nestedContent = Array.isArray(block.content) ? block.content : undefined;
+    const extra = Object.fromEntries(Object.entries(block)
         .filter(([name]) => !['_key', '_rev', '_createdAt', '_updatedAt', '_system'].includes(name))
         .filter(([name]) => !(name === '_type' && type === 'item'))
         .filter(([name]) => !(name === 'markdown' && nestedContent))
@@ -1851,7 +1850,7 @@ function semanticMarkdownValue(value) {
         .filter(([name]) => !(name === 'markdown' && ['math', 'docImage', 'table'].includes(String(type))))
         .filter(([name]) => !(name === 'markdown' && type === 'code' && ('value' in block || 'source' in block)))
         .sort(([left], [right]) => left.localeCompare(right))
-        .map(([name, item]) => [name, semanticMarkdownValue(item)]));
+        .map(([name, i]) => [name, semanticMarkdownValue(i)]));
     return extra;
 }
 function markdownPreservesValue(value, markdown) {
@@ -1879,11 +1878,11 @@ function colonFence(contents, minimum = 4) {
     const largest = contents.flatMap((content) => [...content.matchAll(/^(:+)(?:[ \t].*)?$/gm)].map((match) => match[1].length));
     return ':'.repeat(Math.max(minimum, 1 + Math.max(0, ...largest)));
 }
-function codeFence(code, language) {
+function codeFence(code, lang) {
     const tick = String.fromCharCode(96);
     const runs = code.match(new RegExp(tick + '+', 'g')) ?? [];
     const fence = tick.repeat(Math.max(3, 1 + Math.max(0, ...runs.map((run) => run.length))));
-    const suffix = language ? language : '';
+    const suffix = lang ? lang : '';
     return fence + suffix + '\n' + code.replace(/\n+$/, '') + '\n' + fence;
 }
 /** Serialize readable Markdown where it is faithful and typed source where it is not. */
@@ -1932,8 +1931,8 @@ export function docsValueToMarkdown(value) {
             continue;
         }
         if (item._type === 'code' && !extra) {
-            const language = String(item.language ?? '');
-            if (language && !/^[A-Za-z0-9_+.-]+$/.test(language)) {
+            const lang = String(item.language ?? '');
+            if (lang && !/^[A-Za-z0-9_+.-]+$/.test(lang)) {
                 result.push(richBlockDirective(item));
             }
             else if (typeof item.markdown === 'string' &&
@@ -1943,7 +1942,7 @@ export function docsValueToMarkdown(value) {
                 result.push(markdownPreservesValue(item, item.markdown) ? item.markdown : richBlockDirective(item));
             }
             else {
-                const markdown = codeFence(String(item.value ?? item.source ?? ''), language);
+                const markdown = codeFence(String(item.value ?? item.source ?? ''), lang);
                 result.push(markdownPreservesValue(item, markdown) ? markdown : richBlockDirective(item));
             }
             continue;