mcp-react-toolkit 1.0.0

package/tools/generate-tests/build/generators.js

@@ -0,0 +1,161 @@
+import { mockValue } from './analyzer.js';
+export function generateComponentTests(info) {
+    const { name, isVoidElement, hasVariants, hasSizes } = info;
+    const renderProps = isVoidElement ? 'placeholder="test"' : `>Test Content</${name}>`;
+    const getEl = isVoidElement
+        ? 'screen.getByPlaceholderText("test")'
+        : 'screen.getByText("Test Content")';
+    let t = `import { describe, it, expect, vi } from 'vitest'
+import { render, screen, fireEvent } from '@testing-library/react'
+import { ${name} } from './${name}'
+
+describe('${name}', () => {
+  it('renders without crashing', () => {
+    render(<${name} ${renderProps} />)
+    expect(${getEl}).toBeInTheDocument()
+  })
+
+  it('applies custom className', () => {
+    const { container } = render(<${name} className="custom" ${renderProps} />)
+    expect(container.firstChild).toHaveClass('custom')
+  })
+
+  it('forwards ref', () => {
+    const ref = { current: null }
+    render(<${name} ref={ref} ${renderProps} />)
+    expect(ref.current).not.toBeNull()
+  })
+
+  it('spreads extra props via data-testid', () => {
+    render(<${name} data-testid="el" ${renderProps} />)
+    expect(screen.getByTestId('el')).toBeInTheDocument()
+  })
+
+  it('supports aria-label for accessibility', () => {
+    render(<${name} aria-label="label" ${renderProps} />)
+    expect(screen.getByLabelText('label')).toBeInTheDocument()
+  })
+`;
+    if (hasVariants) {
+        for (const v of ['default', 'destructive', 'outline', 'secondary', 'ghost', 'link']) {
+            t += `
+  it('renders variant="${v}"', () => {
+    const { container } = render(<${name} variant="${v}" ${renderProps} />)
+    expect(container.firstChild).toBeInTheDocument()
+  })
+`;
+        }
+    }
+    if (hasSizes) {
+        for (const s of ['default', 'sm', 'lg', 'icon']) {
+            t += `
+  it('renders size="${s}"', () => {
+    const { container } = render(<${name} size="${s}" ${renderProps} />)
+    expect(container.firstChild).toBeInTheDocument()
+  })
+`;
+        }
+    }
+    if (isVoidElement) {
+        t += `
+  it('handles value prop', () => {
+    render(<${name} value="hello" readOnly />)
+    expect(screen.getByDisplayValue('hello')).toBeInTheDocument()
+  })
+
+  it('handles disabled state', () => {
+    render(<${name} disabled placeholder="test" />)
+    expect(screen.getByPlaceholderText('test')).toBeDisabled()
+  })
+
+  it('calls onChange', () => {
+    const onChange = vi.fn()
+    render(<${name} onChange={onChange} placeholder="test" />)
+    fireEvent.change(screen.getByPlaceholderText('test'), { target: { value: 'x' } })
+    expect(onChange).toHaveBeenCalledTimes(1)
+  })
+`;
+    }
+    else {
+        t += `
+  it('calls onClick', () => {
+    const onClick = vi.fn()
+    render(<${name} onClick={onClick}>Click me</${name}>)
+    fireEvent.click(screen.getByText('Click me'))
+    expect(onClick).toHaveBeenCalledTimes(1)
+  })
+
+  it('renders children', () => {
+    render(<${name}><span>Child</span></${name}>)
+    expect(screen.getByText('Child')).toBeInTheDocument()
+  })
+`;
+    }
+    t += `})
+`;
+    return t;
+}
+export function generateFunctionTests(info) {
+    const { name, params, isAsync } = info;
+    const args = params.map(p => mockValue(p)).join(', ');
+    const call = isAsync ? `await ${name}(${args})` : `${name}(${args})`;
+    return `import { describe, it, expect } from 'vitest'
+
+describe('${name}', () => {
+  it('is defined', () => {
+    expect(${name}).toBeDefined()
+  })
+
+  it('returns a value for valid input', ${isAsync ? 'async ' : ''}() => {
+    const result = ${call}
+    expect(result).toBeDefined()
+  })
+})
+`;
+}
+export function generateHookTests(info) {
+    const { name, params } = info;
+    const args = params.map(p => mockValue(p)).join(', ');
+    return `import { describe, it, expect } from 'vitest'
+import { renderHook } from '@testing-library/react'
+
+describe('${name}', () => {
+  it('returns a value', () => {
+    const { result } = renderHook(() => ${name}(${args}))
+    expect(result.current).toBeDefined()
+  })
+
+  it('does not throw on unmount', () => {
+    const { unmount } = renderHook(() => ${name}(${args}))
+    expect(() => unmount()).not.toThrow()
+  })
+})
+`;
+}
+export function generateClassTests(info) {
+    const { name, methods } = info;
+    const methodTests = methods
+        .filter(m => m !== 'constructor')
+        .map(m => `
+  it('${m} is callable', () => {
+    expect(typeof instance.${m}).toBe('function')
+  })
+`)
+        .join('');
+    return `import { describe, it, expect, beforeEach } from 'vitest'
+import { ${name} } from './${name.toLowerCase()}'
+
+describe('${name}', () => {
+  let instance: ${name}
+
+  beforeEach(() => {
+    instance = new ${name}()
+  })
+
+  it('creates an instance', () => {
+    expect(instance).toBeInstanceOf(${name})
+  })
+${methodTests}})
+`;
+}
+//# sourceMappingURL=generators.js.map

package/tools/generate-tests/build/generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.js","sourceRoot":"","sources":["../src/generators.ts"],"names":[],"mappings":"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"}

package/tools/generate-tests/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/tools/generate-tests/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/tools/generate-tests/build/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { McpServerBase } from '@mcp-showcase/shared';
+import * as fs from 'fs';
+import * as path from 'path';
+import { analyzeSource } from './analyzer.js';
+import { generateComponentTests, generateFunctionTests, generateHookTests, generateClassTests } from './generators.js';
+function scanDirectory(dir, exts = ['.ts', '.tsx', '.js', '.jsx']) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    const SKIP = new Set(['node_modules', 'build', 'dist', '.next']);
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (SKIP.has(entry.name))
+                continue;
+            files.push(...scanDirectory(full, exts));
+        }
+        else if (exts.some(e => entry.name.endsWith(e)) &&
+            !entry.name.includes('.test.') &&
+            !entry.name.includes('.spec.') &&
+            !entry.name.includes('.stories.') &&
+            !entry.name.includes('.types.')) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+function testFilePath(sourceFile) {
+    const dir = path.dirname(sourceFile);
+    const ext = path.extname(sourceFile);
+    const base = path.basename(sourceFile, ext);
+    const testExt = ext.includes('x') ? '.test.tsx' : '.test.ts';
+    return path.join(dir, `${base}${testExt}`);
+}
+class GenerateTestsServer extends McpServerBase {
+    constructor() {
+        super({ name: 'generate-tests', version: '1.0.0' });
+    }
+    registerTools() {
+        this.addTool('generate_tests', 'Analyze a TypeScript/React source file and generate a Vitest test file for all exported components, functions, hooks, and classes.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to source file to generate tests for' },
+                outputPath: { type: 'string', description: 'Where to write the test file (defaults to <name>.test.tsx alongside the source)' },
+                overwrite: { type: 'boolean', description: 'Overwrite existing test file (default: false)' },
+            },
+            required: ['path'],
+        }, async (args) => {
+            const { path: srcPath, outputPath, overwrite = false } = (args ?? {});
+            try {
+                const resolved = path.resolve(srcPath);
+                if (!fs.existsSync(resolved))
+                    throw new Error(`File not found: ${resolved}`);
+                const content = fs.readFileSync(resolved, 'utf-8');
+                const analysis = analyzeSource(content);
+                const testSections = [];
+                for (const c of analysis.components) {
+                    testSections.push(`// --- ${c.name} ---\n${generateComponentTests(c)}`);
+                }
+                for (const h of analysis.hooks) {
+                    testSections.push(`// --- ${h.name} ---\n${generateHookTests(h)}`);
+                }
+                for (const f of analysis.functions) {
+                    testSections.push(`// --- ${f.name} ---\n${generateFunctionTests(f)}`);
+                }
+                for (const cl of analysis.classes) {
+                    testSections.push(`// --- ${cl.name} ---\n${generateClassTests(cl)}`);
+                }
+                if (testSections.length === 0) {
+                    return this.success({ message: 'No exportable symbols found to generate tests for', analysis });
+                }
+                const testContent = testSections.join('\n\n');
+                const dest = outputPath ? path.resolve(outputPath) : testFilePath(resolved);
+                if (fs.existsSync(dest) && !overwrite) {
+                    return this.success({
+                        message: `Test file already exists: ${dest}. Pass overwrite: true to replace it.`,
+                        testContent,
+                        dest,
+                    });
+                }
+                fs.writeFileSync(dest, testContent, 'utf-8');
+                return this.success({
+                    message: `Generated ${testSections.length} test suite(s)`,
+                    dest,
+                    analysis: {
+                        components: analysis.components.map(c => c.name),
+                        hooks: analysis.hooks.map(h => h.name),
+                        functions: analysis.functions.map(f => f.name),
+                        classes: analysis.classes.map(c => c.name),
+                    },
+                });
+            }
+            catch (error) {
+                return this.error(error);
+            }
+        });
+        this.addTool('generate_tests_for_directory', 'Scan a directory and generate test files for all source files that do not already have tests.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Directory to scan' },
+                overwrite: { type: 'boolean', description: 'Overwrite existing test files (default: false)' },
+            },
+            required: ['path'],
+        }, async (args) => {
+            const { path: dirPath, overwrite = false } = (args ?? {});
+            try {
+                const resolved = path.resolve(dirPath);
+                const files = scanDirectory(resolved);
+                const generated = [];
+                const skipped = [];
+                for (const file of files) {
+                    const content = fs.readFileSync(file, 'utf-8');
+                    const analysis = analyzeSource(content);
+                    const hasSymbols = analysis.components.length + analysis.hooks.length + analysis.functions.length + analysis.classes.length > 0;
+                    if (!hasSymbols)
+                        continue;
+                    const dest = testFilePath(file);
+                    if (fs.existsSync(dest) && !overwrite) {
+                        skipped.push(path.relative(resolved, file));
+                        continue;
+                    }
+                    const sections = [];
+                    for (const c of analysis.components)
+                        sections.push(generateComponentTests(c));
+                    for (const h of analysis.hooks)
+                        sections.push(generateHookTests(h));
+                    for (const f of analysis.functions)
+                        sections.push(generateFunctionTests(f));
+                    for (const cl of analysis.classes)
+                        sections.push(generateClassTests(cl));
+                    fs.writeFileSync(dest, sections.join('\n\n'), 'utf-8');
+                    generated.push(path.relative(resolved, dest));
+                }
+                return this.success({
+                    summary: `Generated ${generated.length} test files, skipped ${skipped.length} (already exist)`,
+                    generated,
+                    skipped,
+                });
+            }
+            catch (error) {
+                return this.error(error);
+            }
+        });
+    }
+}
+new GenerateTestsServer().run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/tools/generate-tests/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/tools/generate-tests/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@mcp-showcase/generate-tests",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@mcp-showcase/shared": "*",
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}

package/tools/json-viewer/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/tools/json-viewer/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/tools/json-viewer/build/index.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+import { McpServerBase } from '@mcp-showcase/shared';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { countKeys, getMaxDepth, escapeHtml, generateId } from './utils.js';
+// ============================================================================
+// HELPERS
+// ============================================================================
+const RESPONSES_DIR = path.join(os.homedir(), '.mcp-responses');
+function ensureDir() {
+    if (!fs.existsSync(RESPONSES_DIR)) {
+        fs.mkdirSync(RESPONSES_DIR, { recursive: true });
+    }
+}
+// ============================================================================
+// HTML TEMPLATE
+// ============================================================================
+function generateHtml(label, parsed, timestamp) {
+    const compactJson = JSON.stringify(parsed).replace(/<\/script>/gi, '<\\/script>');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>JSON Viewer — ${escapeHtml(label)}</title>
+<style>
+  :root {
+    --bg: #1e1e2e; --surface: #282840; --surface2: #313150; --border: #44447a;
+    --text: #cdd6f4; --text-dim: #8888b0; --key: #89b4fa; --string: #a6e3a1;
+    --number: #fab387; --boolean: #cba6f7; --null: #f38ba8; --bracket: #8888b0;
+    --search-bg: #f9e2af33;
+  }
+  [data-theme="light"] {
+    --bg: #eff1f5; --surface: #e6e9ef; --surface2: #dce0e8; --border: #bcc0cc;
+    --text: #4c4f69; --text-dim: #8c8fa1; --key: #1e66f5; --string: #40a02b;
+    --number: #fe640b; --boolean: #8839ef; --null: #d20f39; --bracket: #8c8fa1;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: 'JetBrains Mono', 'Fira Code', monospace; background: var(--bg); color: var(--text); min-height: 100vh; }
+  .header { position: sticky; top: 0; z-index: 100; background: var(--surface); border-bottom: 1px solid var(--border); padding: 12px 20px; display: flex; align-items: center; gap: 12px; flex-wrap: wrap; }
+  .header h1 { font-size: 14px; font-weight: 600; color: var(--key); }
+  .header .meta { font-size: 11px; color: var(--text-dim); }
+  .search-box { flex: 1; min-width: 200px; }
+  .search-box input { width: 100%; padding: 6px 10px; background: var(--surface2); border: 1px solid var(--border); border-radius: 6px; color: var(--text); font-family: inherit; font-size: 12px; outline: none; }
+  .search-box input:focus { border-color: var(--key); }
+  .btn { padding: 4px 10px; background: var(--surface2); border: 1px solid var(--border); border-radius: 6px; color: var(--text); font-family: inherit; font-size: 11px; cursor: pointer; }
+  .btn:hover { background: var(--border); }
+  .container { padding: 20px; }
+  .json-tree { font-size: 13px; line-height: 1.6; }
+  .json-line { display: flex; align-items: flex-start; }
+  .line-number { color: var(--text-dim); min-width: 40px; text-align: right; padding-right: 12px; user-select: none; font-size: 11px; }
+  .json-content { flex: 1; white-space: pre; }
+  .json-key { color: var(--key); }
+  .json-string { color: var(--string); }
+  .json-number { color: var(--number); }
+  .json-boolean { color: var(--boolean); }
+  .json-null { color: var(--null); }
+  .json-bracket { color: var(--bracket); }
+  .json-colon, .json-comma { color: var(--text-dim); }
+  .collapsible { cursor: pointer; user-select: none; }
+  .collapsible::before { content: '▼'; display: inline-block; margin-right: 4px; font-size: 8px; transition: transform 0.15s; color: var(--text-dim); }
+  .collapsed::before { transform: rotate(-90deg); }
+  .collapsed + .json-summary + .json-children { display: none; }
+  .json-children { padding-left: 20px; }
+  .json-summary { color: var(--text-dim); font-style: italic; font-size: 11px; }
+  .highlight { background: var(--search-bg); border-radius: 2px; }
+  .hidden { display: none !important; }
+  .copy-toast { position: fixed; bottom: 20px; right: 20px; background: var(--string); color: var(--bg); padding: 8px 16px; border-radius: 6px; font-size: 12px; opacity: 0; transition: opacity 0.3s; z-index: 1000; }
+  .copy-toast.show { opacity: 1; }
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>${escapeHtml(label)}</h1>
+  <span class="meta">${timestamp}</span>
+  <div class="search-box"><input type="text" id="search" placeholder="Search keys or values..." /></div>
+  <button class="btn" onclick="toggleTheme()">Theme</button>
+  <button class="btn" onclick="copyAll()">Copy All</button>
+  <button class="btn" onclick="expandAll()">Expand All</button>
+  <button class="btn" onclick="collapseAll()">Collapse All</button>
+</div>
+<div class="container"><div id="treeView" class="json-tree"></div></div>
+<div class="copy-toast" id="copyToast">Copied!</div>
+<script>
+const RAW_JSON = ${compactJson};
+let lineNum = 0;
+
+function escapeHtml(s) {
+  return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}
+function toggleTheme() {
+  const b = document.body;
+  b.getAttribute('data-theme') === 'light' ? b.removeAttribute('data-theme') : b.setAttribute('data-theme', 'light');
+}
+function showCopyToast() {
+  const t = document.getElementById('copyToast');
+  t.classList.add('show');
+  setTimeout(() => t.classList.remove('show'), 1500);
+}
+function copyAll() { navigator.clipboard.writeText(JSON.stringify(RAW_JSON, null, 2)); showCopyToast(); }
+function expandAll() { document.querySelectorAll('.collapsed').forEach(el => el.classList.remove('collapsed')); }
+function collapseAll() { document.querySelectorAll('.collapsible').forEach(el => el.classList.add('collapsed')); }
+
+function renderValue(val, path, depth) {
+  if (val === null) return '<span class="json-null">null</span>';
+  if (typeof val === 'boolean') return '<span class="json-boolean">' + val + '</span>';
+  if (typeof val === 'number') return '<span class="json-number">' + val + '</span>';
+  if (typeof val === 'string') {
+    const escaped = escapeHtml(val);
+    const display = val.length > 200 ? escaped.slice(0, 200) + '...' : escaped;
+    return '<span class="json-string">"' + display + '"</span>';
+  }
+  if (Array.isArray(val)) {
+    if (val.length === 0) return '<span class="json-bracket">[]</span>';
+    const items = val.map((item, i) => {
+      const ln = ++lineNum;
+      return '<div class="json-line"><span class="line-number">' + ln + '</span><span class="json-content">' +
+        renderValue(item, path + '[' + i + ']', depth + 1) + (i < val.length - 1 ? '<span class="json-comma">,</span>' : '') + '</span></div>';
+    }).join('');
+    return '<span class="collapsible" onclick="this.classList.toggle(\'collapsed\')"><span class="json-bracket">[</span></span>' +
+      '<span class="json-summary"> ' + val.length + ' items</span>' +
+      '<div class="json-children">' + items + '</div><span class="json-bracket">]</span>';
+  }
+  if (typeof val === 'object') {
+    const keys = Object.keys(val);
+    if (keys.length === 0) return '<span class="json-bracket">{}</span>';
+    const items = keys.map((key, i) => {
+      const ln = ++lineNum;
+      return '<div class="json-line"><span class="line-number">' + ln + '</span><span class="json-content">' +
+        '<span class="json-key" data-key="' + escapeHtml(key) + '">"' + escapeHtml(key) + '"</span>' +
+        '<span class="json-colon">: </span>' +
+        renderValue(val[key], path + '.' + key, depth + 1) + (i < keys.length - 1 ? '<span class="json-comma">,</span>' : '') + '</span></div>';
+    }).join('');
+    return '<span class="collapsible" onclick="this.classList.toggle(\'collapsed\')"><span class="json-bracket">{</span></span>' +
+      '<span class="json-summary"> ' + keys.length + ' keys</span>' +
+      '<div class="json-children">' + items + '</div><span class="json-bracket">}</span>';
+  }
+  return '<span class="json-null">' + escapeHtml(String(val)) + '</span>';
+}
+
+let searchTimeout;
+document.getElementById('search').addEventListener('input', function() {
+  clearTimeout(searchTimeout);
+  searchTimeout = setTimeout(() => {
+    document.querySelectorAll('.highlight').forEach(el => el.classList.remove('highlight'));
+    const q = this.value.toLowerCase();
+    if (!q) return;
+    document.querySelectorAll('.json-key,.json-string').forEach(el => {
+      if (el.textContent.toLowerCase().includes(q)) el.classList.add('highlight');
+    });
+  }, 150);
+});
+
+const tree = document.getElementById('treeView');
+lineNum = 1;
+tree.innerHTML = '<div class="json-line"><span class="line-number">1</span><span class="json-content">' + renderValue(RAW_JSON, 'root', 0) + '</span></div>';
+</script>
+</body>
+</html>`;
+}
+// ============================================================================
+// SERVER
+// ============================================================================
+class JsonViewerServer extends McpServerBase {
+    constructor() {
+        super({ name: 'json-viewer', version: '1.0.0' });
+    }
+    registerTools() {
+        this.addTool('view_json', 'Save JSON data and generate an interactive HTML viewer. Opens in browser for easy visualization of complex JSON responses.', {
+            type: 'object',
+            properties: {
+                data: { type: 'string', description: 'JSON string to visualize' },
+                label: { type: 'string', description: 'Label for this response (used in filename and title)' },
+                open: { type: 'boolean', description: 'Automatically open in browser (default: true)', default: true },
+            },
+            required: ['data'],
+        }, this.handleViewJson.bind(this));
+        this.addTool('list_responses', 'List all saved JSON responses with timestamps and metadata.', {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max number of responses to return (default: 20)', default: 20 },
+            },
+        }, this.handleListResponses.bind(this));
+        this.addTool('view_response', 'Re-open a previously saved JSON response by its ID.', {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Response ID (from list_responses)' },
+            },
+            required: ['id'],
+        }, this.handleViewResponse.bind(this));
+    }
+    async handleViewJson(args) {
+        const { data, label = 'response', open = true } = args;
+        try {
+            ensureDir();
+            let parsed;
+            let jsonStr;
+            try {
+                parsed = typeof data === 'string' ? JSON.parse(data) : data;
+                jsonStr = JSON.stringify(parsed, null, 2);
+            }
+            catch {
+                throw new Error('Invalid JSON data provided');
+            }
+            const id = generateId(label);
+            const timestamp = new Date().toISOString();
+            const jsonPath = path.join(RESPONSES_DIR, `${id}.json`);
+            const htmlPath = path.join(RESPONSES_DIR, `${id}.html`);
+            fs.writeFileSync(jsonPath, jsonStr, 'utf-8');
+            const html = generateHtml(label, parsed, timestamp);
+            fs.writeFileSync(htmlPath, html, 'utf-8');
+            const meta = {
+                id, label, timestamp, jsonPath, htmlPath,
+                sizeBytes: Buffer.byteLength(jsonStr, 'utf-8'),
+                keyCount: countKeys(parsed),
+                maxDepth: getMaxDepth(parsed),
+            };
+            fs.writeFileSync(path.join(RESPONSES_DIR, `${id}.meta.json`), JSON.stringify(meta, null, 2), 'utf-8');
+            if (open) {
+                const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+                const { execSync } = await import('child_process');
+                try {
+                    execSync(`${cmd} "${htmlPath}"`, { stdio: 'ignore' });
+                }
+                catch { /* silent */ }
+            }
+            return this.success({
+                id, jsonPath, htmlPath,
+                message: `JSON saved and viewer generated. Open: ${htmlPath}`,
+                stats: { sizeBytes: meta.sizeBytes, keyCount: meta.keyCount, maxDepth: meta.maxDepth },
+            });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+    async handleListResponses(args) {
+        const { limit = 20 } = (args || {});
+        try {
+            ensureDir();
+            const files = fs.readdirSync(RESPONSES_DIR)
+                .filter(f => f.endsWith('.meta.json'))
+                .sort().reverse().slice(0, limit);
+            const responses = [];
+            for (const file of files) {
+                try {
+                    responses.push(JSON.parse(fs.readFileSync(path.join(RESPONSES_DIR, file), 'utf-8')));
+                }
+                catch { /* skip corrupted */ }
+            }
+            return this.success({ total: responses.length, responses });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+    async handleViewResponse(args) {
+        const { id } = args;
+        try {
+            ensureDir();
+            const metaPath = path.join(RESPONSES_DIR, `${id}.meta.json`);
+            if (!fs.existsSync(metaPath))
+                throw new Error(`Response not found: ${id}`);
+            const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            if (!fs.existsSync(meta.htmlPath))
+                throw new Error(`HTML viewer not found for: ${id}`);
+            const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+            const { execSync } = await import('child_process');
+            try {
+                execSync(`${cmd} "${meta.htmlPath}"`, { stdio: 'ignore' });
+            }
+            catch { /* silent */ }
+            return this.success({ id: meta.id, label: meta.label, htmlPath: meta.htmlPath, message: `Opened viewer for: ${meta.label}` });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+}
+new JsonViewerServer().run().catch(console.error);
+//# sourceMappingURL=index.js.map