@j0hanz/superfetch 2.4.0 → 2.4.1

package/dist/markdown-cleanup.js

@@ -149,6 +149,21 @@ function normalizeListsAndSpacing(text) {
     // Collapse excessive blank lines
     return text.replace(/\n{3,}/g, '\n\n');
 }
+function fixConcatenatedProperties(text) {
+    const quotedValuePattern = /([a-z_][a-z0-9_]{0,30}\??:\s+)([\u0022\u201C][^\u0022\u201C\u201D]*[\u0022\u201D])([a-z_][a-z0-9_]{0,30}\??:)/g;
+    let result = text;
+    let iterations = 0;
+    const maxIterations = 3;
+    while (iterations < maxIterations) {
+        const before = result;
+        result = result.replace(quotedValuePattern, '$1$2\n\n$3');
+        if (result === before) {
+            break;
+        }
+        iterations++;
+    }
+    return result;
+}
 const CLEANUP_STEPS = [
     fixOrphanHeadings,
     removeEmptyHeadings,
@@ -157,6 +172,7 @@ const CLEANUP_STEPS = [
     removeTocBlocks,
     tidyLinksAndEscapes,
     normalizeListsAndSpacing,
+    fixConcatenatedProperties,
 ];
 // ─────────────────────────────────────────────────────────────────────────────
 // Public API

package/dist/mcp.js

@@ -22,7 +22,13 @@ function createServerInfo() {
     return {
         name: config.server.name,
         version: config.server.version,
-        ...(localIcon ? { icons: [{ src: localIcon, sizes: ['any'] }] } : {}),
+        ...(localIcon
+            ? {
+                icons: [
+                    { src: localIcon, mimeType: 'image/svg+xml', sizes: ['any'] },
+                ],
+            }
+            : {}),
     };
 }
 function createServerCapabilities() {
@@ -63,7 +69,7 @@ export function createMcpServer() {
         instructions,
     });
     setMcpServer(server);
-    registerTools(server);
+    registerTools(server, getLocalIconData());
     registerCachedContentResource(server);
     registerInstructionsResource(server, instructions);
     return server;

package/dist/tools.d.ts

@@ -125,5 +125,5 @@ type MarkdownPipelineResult = MarkdownTransformResult & {
 export declare function parseCachedMarkdownResult(cached: string): MarkdownPipelineResult | undefined;
 export declare function fetchUrlToolHandler(input: FetchUrlInput, extra?: ToolHandlerExtra): Promise<ToolResponseBase>;
 export declare function withRequestContextIfMissing<TParams, TResult, TExtra = unknown>(handler: (params: TParams, extra?: TExtra) => Promise<TResult>): (params: TParams, extra?: TExtra) => Promise<TResult>;
-export declare function registerTools(server: McpServer): void;
+export declare function registerTools(server: McpServer, serverIcon?: string): void;
 export {};

package/dist/tools.js

@@ -482,12 +482,23 @@ function resolveRequestIdFromExtra(extra) {
         return String(requestId);
     return undefined;
 }
-export function registerTools(server) {
+export function registerTools(server, serverIcon) {
     server.registerTool(TOOL_DEFINITION.name, {
         title: TOOL_DEFINITION.title,
         description: TOOL_DEFINITION.description,
         inputSchema: TOOL_DEFINITION.inputSchema,
         outputSchema: TOOL_DEFINITION.outputSchema,
         annotations: TOOL_DEFINITION.annotations,
+        ...(serverIcon
+            ? {
+                icons: [
+                    {
+                        src: serverIcon,
+                        mimeType: 'image/svg+xml',
+                        sizes: ['any'],
+                    },
+                ],
+            }
+            : {}),
     }, withRequestContextIfMissing(TOOL_DEFINITION.handler));
 }

package/dist/transform.js

@@ -519,6 +519,36 @@ function createCustomTranslators() {
                 .join('\n');
             return { content: items ? `\n${items}\n\n` : '' };
         },
+        div: (ctx) => {
+            if (!isObject(ctx) || !isObject(ctx.node)) {
+                return {};
+            }
+            const node = ctx.node;
+            const className = typeof node.attribs?.class === 'string' ? node.attribs.class : '';
+            if (!className.includes('type')) {
+                return {};
+            }
+            return {
+                postprocess: ({ content }) => {
+                    const lines = content.split('\n');
+                    const separated = [];
+                    for (let i = 0; i < lines.length; i++) {
+                        const line = lines[i] ?? '';
+                        const nextLine = i < lines.length - 1 ? (lines[i + 1] ?? '') : '';
+                        separated.push(line);
+                        if (line.trim() &&
+                            nextLine.trim() &&
+                            line.includes(':') &&
+                            nextLine.includes(':') &&
+                            !line.startsWith(' ') &&
+                            !nextLine.startsWith(' ')) {
+                            separated.push('');
+                        }
+                    }
+                    return separated.join('\n');
+                },
+            };
+        },
         kbd: () => ({
             postprocess: ({ content }) => `\`${content}\``,
         }),
@@ -531,7 +561,8 @@ function createCustomTranslators() {
         sup: () => ({
             postprocess: ({ content }) => `^${content}^`,
         }),
-        // Fix #6: Handle <pre> without <code> - wrap in fenced code block
+        // Note: section translator removed in favor of HTML preprocessing
+        // See preprocessPropertySections() for the fix to TypeDoc section spacing
         pre: (ctx) => buildPreTranslator(ctx),
     };
 }
@@ -548,13 +579,18 @@ function getMarkdownConverter() {
     markdownInstance ??= createMarkdownInstance();
     return markdownInstance;
 }
+function preprocessPropertySections(html) {
+    const result = html.replace(/<\/section>\s*(<section[^>]*class="[^"]*tsd-panel[^"]*tsd-member[^"]*"[^>]*>)/g, '</section><p>&nbsp;</p>$1');
+    return result;
+}
 function translateHtmlToMarkdown(html, url, signal, document, skipNoiseRemoval) {
     throwIfAborted(signal, url, 'markdown:begin');
     const cleanedHtml = skipNoiseRemoval
         ? html
         : runTransformStage(url, 'markdown:noise', () => removeNoiseFromHtml(html, document, url));
     throwIfAborted(signal, url, 'markdown:cleaned');
-    const content = runTransformStage(url, 'markdown:translate', () => getMarkdownConverter().translate(cleanedHtml).trim());
+    const preprocessedHtml = runTransformStage(url, 'markdown:preprocess', () => preprocessPropertySections(cleanedHtml));
+    const content = runTransformStage(url, 'markdown:translate', () => getMarkdownConverter().translate(preprocessedHtml).trim());
     throwIfAborted(signal, url, 'markdown:translated');
     return cleanupMarkdownArtifacts(content);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/superfetch",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "mcpName": "io.github.j0hanz/superfetch",
   "description": "Intelligent web content fetcher MCP server that converts HTML to clean, AI-readable Markdown",
   "type": "module",