@lando-labs/lando-ds-mcp 4.0.0

package/build/test.js

@@ -0,0 +1,680 @@
+/**
+ * Test Script for @lando-labs/lando-ds-mcp v4.0.0
+ *
+ * Coverage:
+ *   - Meta loader (schema compat, accessors)
+ *   - Each of the 15 tools: Zod schema validation + smoke test on output
+ *   - JSX safety regressions (carried from v2.7.1)
+ *   - Error envelope classification (carried from v2.7.1)
+ *   - Icon library (Lucide catalog)
+ */
+import { getLightMeta, getVerboseMeta, getVerboseComponent, getComponentNames, getDsPackageName, getDsVersion, getSchemaVersion, getHookNames, getHook, } from './utils/meta-loader.js';
+import { listComponents, listComponentsSchema } from './tools/list-components.js';
+import { getComponent, getComponentSchema } from './tools/get-component.js';
+import { getComponentProps, getComponentPropsSchema } from './tools/get-component-props.js';
+import { getComponentReference, getComponentReferenceSchema } from './tools/get-component-reference.js';
+import { composeComponents, composeComponentsSchema } from './tools/compose-components.js';
+import { getDesignTokens, getDesignTokensSchema } from './tools/get-design-tokens.js';
+import { getAnimationExamples, getAnimationExamplesSchema } from './tools/get-animation-examples.js';
+import { listIcons, listIconsSchema } from './tools/list-icons.js';
+import { searchIcons, searchIconsSchema } from './tools/search-icons.js';
+import { getComponentCapabilities, getComponentCapabilitiesSchema } from './tools/get-component-capabilities.js';
+import { getCompositionHints, getCompositionHintsSchema } from './tools/get-composition-hints.js';
+import { getThemePresets, getThemePresetsSchema } from './tools/get-theme-presets.js';
+import { getDsMetadata, getDsMetadataSchema } from './tools/get-ds-metadata.js';
+import { listHooks, listHooksSchema } from './tools/list-hooks.js';
+import { getHook_tool, getHookSchema } from './tools/get-hook.js';
+import { handleError, _resetErrorIdSeq } from './utils/error-envelope.js';
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { lucideIconNames, isLucideIconName, searchLucideIconNames } from './data/lucide-icons.js';
+const colors = { reset: '\x1b[0m', green: '\x1b[32m', red: '\x1b[31m', blue: '\x1b[34m', cyan: '\x1b[36m' };
+const log = (msg, color = 'reset') => console.log(`${colors[color]}${msg}${colors.reset}`);
+let passed = 0;
+let failed = 0;
+async function test(name, fn) {
+    try {
+        await fn();
+        passed++;
+        log(`✓ ${name}`, 'green');
+    }
+    catch (error) {
+        failed++;
+        log(`✗ ${name}`, 'red');
+        console.error(`  ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+// Pick a stable component name for tests that need one. Fall back to first
+// available if Button isn't in the loaded meta for some reason.
+const SAMPLE_COMPONENT = getComponentNames().includes('Button') ? 'Button' : getComponentNames()[0];
+async function run() {
+    log('\n===========================================', 'cyan');
+    log(`v3.0.0 test suite — DS ${getDsPackageName()}@${getDsVersion()} (schema ${getSchemaVersion()})`, 'cyan');
+    log('===========================================\n', 'cyan');
+    // ==========================================================================
+    log('Version sync (from #11)', 'blue');
+    // ==========================================================================
+    // These tests protect against the class of drift that shipped v2.5.0/v2.6.0
+    // together — where package.json, src/index.ts version comment, Server
+    // registration version, and startup banner disagreed.
+    //
+    // Read package.json + src/index.ts source at test time (fresh file reads,
+    // not the compiled build), extract versions from both, assert equal.
+    await test('version-sync — src/index.ts JSDoc comment matches package.json version', async () => {
+        const fs = await import('fs');
+        const url = await import('url');
+        const path = await import('path');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(here, '../package.json'), 'utf-8'));
+        const src = fs.readFileSync(path.resolve(here, '../src/index.ts'), 'utf-8');
+        const m = src.match(/^ \* Version: (\d+\.\d+\.\d+)$/m);
+        if (!m)
+            throw new Error('could not find "Version: X.Y.Z" comment in src/index.ts');
+        if (m[1] !== pkg.version)
+            throw new Error(`src/index.ts JSDoc says v${m[1]}, package.json says v${pkg.version}`);
+    });
+    await test('version-sync — Server({ version }) matches package.json version', async () => {
+        const fs = await import('fs');
+        const url = await import('url');
+        const path = await import('path');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(here, '../package.json'), 'utf-8'));
+        const src = fs.readFileSync(path.resolve(here, '../src/index.ts'), 'utf-8');
+        const m = src.match(/version: ['"](\d+\.\d+\.\d+)['"]/);
+        if (!m)
+            throw new Error('could not find `version: "X.Y.Z"` in src/index.ts (Server registration)');
+        if (m[1] !== pkg.version)
+            throw new Error(`Server({ version }) says v${m[1]}, package.json says v${pkg.version}`);
+    });
+    await test('version-sync — startup banner matches package.json version', async () => {
+        const fs = await import('fs');
+        const url = await import('url');
+        const path = await import('path');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(here, '../package.json'), 'utf-8'));
+        const src = fs.readFileSync(path.resolve(here, '../src/index.ts'), 'utf-8');
+        const m = src.match(/`Version: (\d+\.\d+\.\d+) \(backed by @lando-labs\/lando-ds-meta/);
+        if (!m)
+            throw new Error('could not find "Version: X.Y.Z (backed by @lando-labs/lando-ds-meta" startup banner in src/index.ts');
+        if (m[1] !== pkg.version)
+            throw new Error(`Startup banner says v${m[1]}, package.json says v${pkg.version}`);
+    });
+    await test('version-sync — CHANGELOG top entry matches package.json version', async () => {
+        const fs = await import('fs');
+        const url = await import('url');
+        const path = await import('path');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(fs.readFileSync(path.resolve(here, '../package.json'), 'utf-8'));
+        const changelog = fs.readFileSync(path.resolve(here, '../CHANGELOG.md'), 'utf-8');
+        // Find the first `## [X.Y.Z] - YYYY-MM-DD` heading — that's the current release
+        const m = changelog.match(/^## \[(\d+\.\d+\.\d+)\] - \d{4}-\d{2}-\d{2}$/m);
+        if (!m)
+            throw new Error('could not find "## [X.Y.Z] - YYYY-MM-DD" entry in CHANGELOG.md');
+        if (m[1] !== pkg.version)
+            throw new Error(`CHANGELOG top entry says v${m[1]}, package.json says v${pkg.version}`);
+    });
+    await test('version-sync — README component count matches loaded meta', async () => {
+        const fs = await import('fs');
+        const url = await import('url');
+        const path = await import('path');
+        const here = path.dirname(url.fileURLToPath(import.meta.url));
+        const readme = fs.readFileSync(path.resolve(here, '../README.md'), 'utf-8');
+        const expected = Object.keys(getLightMeta().components).length;
+        // README says "127 React components" in the positioning statement.
+        // Assert the number in that phrase matches the loaded meta.
+        const m = readme.match(/(\d+) React components/);
+        if (!m)
+            throw new Error('README does not mention "N React components" — check positioning statement');
+        if (Number(m[1]) !== expected) {
+            throw new Error(`README says "${m[1]} React components", meta has ${expected}`);
+        }
+    });
+    // ==========================================================================
+    log('Meta loader', 'blue');
+    // ==========================================================================
+    await test('meta.$schemaVersion is in the supported 1.x range', async () => {
+        const v = getLightMeta().$schemaVersion;
+        if (!/^1\.\d+$/.test(v))
+            throw new Error(`unexpected schema version: ${v}`);
+    });
+    await test('meta.package.name is @lando-labs/lando-ds', async () => {
+        if (getDsPackageName() !== '@lando-labs/lando-ds')
+            throw new Error('package name mismatch');
+    });
+    await test('meta has 100+ components', async () => {
+        if (getComponentNames().length < 100)
+            throw new Error(`only ${getComponentNames().length} components`);
+    });
+    await test('verbose meta lazy-loads on first access', async () => {
+        const v = getVerboseMeta();
+        if (!v.components[SAMPLE_COMPONENT]?.description)
+            throw new Error('verbose meta missing description');
+    });
+    await test('getVerboseComponent returns example code for Button (if present)', async () => {
+        const v = getVerboseComponent(SAMPLE_COMPONENT);
+        if (!v)
+            throw new Error('component not in verbose meta');
+        // examples may be [] for some components — that's allowed.
+        if (!Array.isArray(v.examples))
+            throw new Error('examples not an array');
+    });
+    await test('meta.capabilities lists are populated', async () => {
+        const c = getLightMeta().capabilities;
+        if (c.rscSafe.length + c.clientOnly.length === 0)
+            throw new Error('capabilities empty');
+    });
+    // ==========================================================================
+    log('\nlist_components', 'blue');
+    // ==========================================================================
+    await test('list_components — no filters returns all components', async () => {
+        const out = await listComponents({});
+        if (!out.includes(`Total: ${getComponentNames().length}`))
+            throw new Error('missing total count');
+    });
+    await test('list_components — deprecated=false excludes deprecated', async () => {
+        const out = await listComponents({ deprecated: false });
+        if (!out.includes('Total:'))
+            throw new Error('missing total');
+    });
+    await test('list_components schema — rejects unknown kind', async () => {
+        const r = listComponentsSchema.safeParse({ kind: 'hook' });
+        if (r.success)
+            throw new Error('should reject');
+    });
+    // ==========================================================================
+    log('\nget_component', 'blue');
+    // ==========================================================================
+    await test('get_component — PascalCase name works', async () => {
+        const out = await getComponent({ componentName: SAMPLE_COMPONENT });
+        if (!out.includes(`<${SAMPLE_COMPONENT}`))
+            throw new Error('missing JSX element');
+        if (!out.includes(`from '@lando-labs/lando-ds'`))
+            throw new Error('missing import');
+    });
+    await test('get_component — with props renders them', async () => {
+        const out = await getComponent({ componentName: SAMPLE_COMPONENT, props: { variant: 'primary' } });
+        if (!out.includes('variant="primary"'))
+            throw new Error('prop not rendered');
+    });
+    await test('get_component — rejects lowercase name (schema)', async () => {
+        const r = getComponentSchema.safeParse({ componentName: 'button' });
+        if (r.success)
+            throw new Error('should reject lowercase');
+    });
+    await test('get_component — rejects unknown component (schema)', async () => {
+        const r = getComponentSchema.safeParse({ componentName: 'NotAComponent' });
+        if (r.success)
+            throw new Error('should reject unknown');
+    });
+    // ==========================================================================
+    log('\nget_component_props', 'blue');
+    // ==========================================================================
+    await test('get_component_props — returns TS-style interface', async () => {
+        const out = await getComponentProps({ componentName: SAMPLE_COMPONENT });
+        if (!out.includes(`interface ${SAMPLE_COMPONENT}Props`))
+            throw new Error('missing interface');
+    });
+    await test('get_component_props schema — rejects missing componentName', async () => {
+        const r = getComponentPropsSchema.safeParse({});
+        if (r.success)
+            throw new Error('should require componentName');
+    });
+    // ==========================================================================
+    log('\nget_component_reference', 'blue');
+    // ==========================================================================
+    await test('get_component_reference — default include set', async () => {
+        const out = await getComponentReference({ componentName: SAMPLE_COMPONENT });
+        if (!out.includes('## Description') && !out.includes('## Props'))
+            throw new Error('missing default sections');
+    });
+    await test('get_component_reference — include: ["examples"] only', async () => {
+        const out = await getComponentReference({ componentName: SAMPLE_COMPONENT, include: ['examples'] });
+        if (out.includes('## Description') || out.includes('## Props'))
+            throw new Error('include filter not honored');
+        if (!out.includes('## Examples'))
+            throw new Error('missing examples section');
+    });
+    await test('get_component_reference schema — rejects invalid include value', async () => {
+        const r = getComponentReferenceSchema.safeParse({ componentName: SAMPLE_COMPONENT, include: ['bogus'] });
+        if (r.success)
+            throw new Error('should reject bogus include');
+    });
+    // ==========================================================================
+    log('\nHTML-attrs footer — authoritative extends (DS meta 1.2, v3.1.1)', 'blue');
+    // ==========================================================================
+    // Semantics changed in v3.1.1: any component with a non-empty `extends`
+    // chain in meta gets the footer, regardless of own-props count. Old
+    // heuristic (v3.0.1) only footered sparse-props + polymorphic/withRef.
+    await test('get_component_props — authoritative footer for ThemeBuilder shows HTMLAttributes<HTMLDivElement>', async () => {
+        const out = await getComponentProps({ componentName: 'ThemeBuilder' });
+        if (!out.includes('Also accepts everything in')) {
+            throw new Error('expected authoritative extends footer');
+        }
+        if (!out.includes('HTMLAttributes<HTMLDivElement>')) {
+            throw new Error('footer should render the exact extends chain from meta');
+        }
+    });
+    await test('get_component_props — authoritative footer for Button shows HTMLAttributes<HTMLButtonElement>', async () => {
+        // Button has 6+ own props but still extends HTMLAttributes — old
+        // heuristic hid this; authoritative version surfaces it.
+        const out = await getComponentProps({ componentName: 'Button' });
+        if (!out.includes('Also accepts everything in')) {
+            throw new Error('expected authoritative extends footer on Button');
+        }
+        if (!out.includes('HTMLButtonElement')) {
+            throw new Error('footer should mention the correct HTML element for Button');
+        }
+    });
+    await test('get_component_reference — authoritative footer in Props section for ThemeBuilder', async () => {
+        const out = await getComponentReference({ componentName: 'ThemeBuilder', include: ['props'] });
+        if (!out.includes('Also accepts everything in')) {
+            throw new Error('expected authoritative footer in get_component_reference Props section');
+        }
+        if (!out.includes('HTMLDivElement')) {
+            throw new Error('footer missing extends chain content');
+        }
+    });
+    await test('get_component_reference — footer ABSENT when Props section not included', async () => {
+        const out = await getComponentReference({ componentName: 'ThemeBuilder', include: ['description'] });
+        if (out.includes('Also accepts everything in')) {
+            throw new Error('footer should only render when Props section is included');
+        }
+    });
+    // ==========================================================================
+    log('\ncompose_components', 'blue');
+    // ==========================================================================
+    await test('compose_components — merges imports from meta', async () => {
+        const out = await composeComponents({
+            components: [
+                { componentName: SAMPLE_COMPONENT },
+                { componentName: SAMPLE_COMPONENT },
+            ],
+        });
+        if (!out.includes(`from '@lando-labs/lando-ds'`))
+            throw new Error('missing merged import');
+        // Same name twice deduplicates in the import
+        if (out.match(/import \{ [^}]+ \}/)[0].split(',').length > 1)
+            throw new Error('duplicate names not deduped');
+    });
+    await test('compose_components schema — rejects > 25 components', async () => {
+        const many = Array.from({ length: 26 }, () => ({ componentName: SAMPLE_COMPONENT }));
+        const r = composeComponentsSchema.safeParse({ components: many });
+        if (r.success)
+            throw new Error('should reject >25');
+    });
+    await test('compose_components schema — rejects unknown component', async () => {
+        const r = composeComponentsSchema.safeParse({ components: [{ componentName: 'NotReal' }] });
+        if (r.success)
+            throw new Error('should reject unknown');
+    });
+    // ==========================================================================
+    log('\nget_design_tokens', 'blue');
+    // ==========================================================================
+    await test('get_design_tokens — default format is css', async () => {
+        const out = await getDesignTokens({});
+        if (!out.includes('Format: `css`'))
+            throw new Error('default not css');
+    });
+    await test('get_design_tokens — format: "hex" returns hex values', async () => {
+        const out = await getDesignTokens({ format: 'hex' });
+        if (!out.includes('Format: `hex`'))
+            throw new Error('hex format not applied');
+        if (!/#[0-9A-Fa-f]{6}/.test(out))
+            throw new Error('no hex values in output');
+    });
+    await test('get_design_tokens — format: "both" returns var refs + hex', async () => {
+        const out = await getDesignTokens({ format: 'both' });
+        if (!out.includes('var(--'))
+            throw new Error('missing var refs');
+        if (!/#[0-9A-Fa-f]{6}/.test(out))
+            throw new Error('missing hex');
+    });
+    await test('get_design_tokens schema — rejects bogus format', async () => {
+        const r = getDesignTokensSchema.safeParse({ format: 'srgb' });
+        if (r.success)
+            throw new Error('should reject bogus format');
+    });
+    // ==========================================================================
+    log('\nget_animation_examples', 'blue');
+    // ==========================================================================
+    await test('get_animation_examples — no ocean framing in v3.0.0', async () => {
+        const out = await getAnimationExamples({});
+        if (out.includes('Ocean-Themed Animation Examples'))
+            throw new Error('ocean-themed title survived');
+        if (out.includes('like ocean waves'))
+            throw new Error('ocean-waves guidance survived');
+    });
+    await test('get_animation_examples — specific animationType', async () => {
+        const out = await getAnimationExamples({ animationType: 'fade-in' });
+        if (!out.toLowerCase().includes('fade'))
+            throw new Error('animation not returned');
+    });
+    await test('get_animation_examples schema — rejects invalid animationType', async () => {
+        const r = getAnimationExamplesSchema.safeParse({ animationType: 'flip' });
+        if (r.success)
+            throw new Error('should reject flip');
+    });
+    // ==========================================================================
+    log('\nlist_icons', 'blue');
+    // ==========================================================================
+    await test('list_icons — default (all) returns DS-brand + Lucide-curated', async () => {
+        const out = await listIcons({});
+        if (!out.includes('DS Brand Icons') && !out.includes('Lucide Curated')) {
+            throw new Error('missing at least one source section');
+        }
+    });
+    await test('list_icons — source=ds-brand filters to registry', async () => {
+        const out = await listIcons({ source: 'ds-brand' });
+        if (!out.includes('DS Brand Icons'))
+            throw new Error('missing brand section');
+        if (out.includes('Lucide Curated'))
+            throw new Error('lucide-curated leaked in');
+    });
+    await test('list_icons — source=lucide-curated filters to curated', async () => {
+        const out = await listIcons({ source: 'lucide-curated' });
+        if (out.includes('DS Brand Icons'))
+            throw new Error('brand leaked in');
+    });
+    await test('list_icons schema — rejects old "custom" source value', async () => {
+        const r = listIconsSchema.safeParse({ source: 'custom' });
+        if (r.success)
+            throw new Error('should reject old value');
+    });
+    // ==========================================================================
+    log('\nsearch_icons', 'blue');
+    // ==========================================================================
+    await test('search_icons — ocean purpose mapping removed', async () => {
+        const out = await searchIcons({ query: 'ocean' });
+        // The ocean-specific curated hits are gone; results may still turn up
+        // via general fuzzy match on the word, but the top result should NOT
+        // be seeded from a purpose mapping keyed on "ocean theme".
+        if (out.includes('Ocean-Themed') || out.includes('ocean waves')) {
+            throw new Error('ocean framing survived');
+        }
+    });
+    await test('search_icons — finds User icons for "user profile"', async () => {
+        const out = await searchIcons({ query: 'user profile' });
+        if (!/User/.test(out))
+            throw new Error('missing User match');
+    });
+    await test('search_icons schema — requires query', async () => {
+        const r = searchIconsSchema.safeParse({ limit: 5 });
+        if (r.success)
+            throw new Error('should require query');
+    });
+    // ==========================================================================
+    log('\nget_component_capabilities', 'blue');
+    // ==========================================================================
+    await test('get_component_capabilities — no args returns matrix summary', async () => {
+        const out = await getComponentCapabilities({});
+        if (!out.includes('## Summary'))
+            throw new Error('missing summary section');
+    });
+    await test('get_component_capabilities — single component by name', async () => {
+        const out = await getComponentCapabilities({ component: SAMPLE_COMPONENT });
+        if (!out.includes(`Capability: ${SAMPLE_COMPONENT}`))
+            throw new Error('single-component branch not taken');
+    });
+    await test('get_component_capabilities — polymorphic=true filter', async () => {
+        const out = await getComponentCapabilities({ polymorphic: true });
+        if (!out.includes('polymorphic=true'))
+            throw new Error('filter not surfaced in output');
+    });
+    await test('get_component_capabilities schema — accepts all new axes', async () => {
+        const r = getComponentCapabilitiesSchema.safeParse({
+            rscSafe: true, clientOnly: false, polymorphic: true, withRef: true, deprecated: false,
+        });
+        if (!r.success)
+            throw new Error('should accept expanded axes');
+    });
+    // ==========================================================================
+    log('\nget_composition_hints', 'blue');
+    // ==========================================================================
+    await test('get_composition_hints — returns hints or friendly none message', async () => {
+        const out = await getCompositionHints({ componentName: SAMPLE_COMPONENT });
+        if (!out.includes('# Composition Hints:'))
+            throw new Error('missing header');
+    });
+    await test('get_composition_hints schema — requires componentName', async () => {
+        const r = getCompositionHintsSchema.safeParse({});
+        if (r.success)
+            throw new Error('should require componentName');
+    });
+    // ==========================================================================
+    log('\nget_theme_presets', 'blue');
+    // ==========================================================================
+    await test('get_theme_presets — reads from meta.themePresets (schema 1.1+)', async () => {
+        const out = await getThemePresets({});
+        // brand-neutral is the DS's declared default as of v0.43.0
+        if (!out.includes('`brand-neutral`'))
+            throw new Error('missing brand-neutral preset');
+        if (!out.includes('_(default)_'))
+            throw new Error('default preset badge missing');
+        if (!out.includes('**Default preset**: `brand-neutral`'))
+            throw new Error('default preset header missing');
+    });
+    await test('get_theme_presets — surfaces additional presets beyond hard-coded pair', async () => {
+        // v3.0.0 hard-coded only lando + brand-neutral. Meta-backed rendering
+        // must surface every preset the DS ships (forest, midnight, rose, slate, ...).
+        const out = await getThemePresets({});
+        if (!out.includes('`forest`'))
+            throw new Error('missing forest preset — meta-backed rendering not active');
+    });
+    await test('get_theme_presets schema — accepts empty args', async () => {
+        const r = getThemePresetsSchema.safeParse({});
+        if (!r.success)
+            throw new Error('should accept {}');
+    });
+    // ==========================================================================
+    log('\nget_ds_metadata', 'blue');
+    // ==========================================================================
+    await test('get_ds_metadata — surfaces package version and schema', async () => {
+        const out = await getDsMetadata({});
+        if (!out.includes(`v${getDsVersion()}`))
+            throw new Error('missing version');
+        if (!out.includes(`v${getSchemaVersion()}`))
+            throw new Error('missing schema version');
+    });
+    await test('get_ds_metadata — component/capability totals present', async () => {
+        const out = await getDsMetadata({});
+        if (!out.includes('Total components'))
+            throw new Error('missing totals');
+        if (!out.toLowerCase().includes('rsc-safe'))
+            throw new Error('missing capability breakdown');
+    });
+    await test('get_ds_metadata schema — accepts empty args', async () => {
+        const r = getDsMetadataSchema.safeParse({});
+        if (!r.success)
+            throw new Error('should accept {}');
+    });
+    await test('get_ds_metadata — surfaces hook totals when meta has hooks', async () => {
+        // Only assert when the loaded meta actually ships hooks (schema 1.3+).
+        if (getHookNames().length === 0)
+            return;
+        const out = await getDsMetadata({});
+        if (!out.includes('Hook totals'))
+            throw new Error('missing hook totals section');
+        if (!out.includes('list_hooks'))
+            throw new Error('hook tools pointer missing');
+    });
+    // ==========================================================================
+    log('\nHooks (meta schema 1.3, DS#504)', 'blue');
+    // ==========================================================================
+    await test('meta-loader — getHookNames returns 1+ hook names', async () => {
+        // Anchor on the fact that DS v0.56.0+ ships hooks. If this fails after a
+        // content refresh, it means the DS regressed on hook emission.
+        const names = getHookNames();
+        if (names.length === 0) {
+            throw new Error(`no hooks in meta — DS meta schema is v${getSchemaVersion()}, expected hooks starting at 1.3`);
+        }
+    });
+    await test('meta-loader — hook names are sorted', async () => {
+        const names = getHookNames();
+        const sorted = [...names].sort();
+        if (JSON.stringify(names) !== JSON.stringify(sorted))
+            throw new Error('not sorted');
+    });
+    await test('meta-loader — getHook returns undefined for unknown hook', async () => {
+        if (getHook('useNotAHookName') !== undefined)
+            throw new Error('should be undefined');
+    });
+    await test('meta-loader — every emitted hook has required schema 1.3 fields', async () => {
+        for (const name of getHookNames()) {
+            const h = getHook(name);
+            const missing = ['kind', 'category', 'serverSafe', 'useClient', 'subpath', 'description', 'signature', 'returns']
+                .filter((k) => !(k in h));
+            if (missing.length > 0)
+                throw new Error(`${name} missing: ${missing.join(', ')}`);
+        }
+    });
+    await test('list_hooks — no filters returns all hooks', async () => {
+        const out = await listHooks({});
+        const total = getHookNames().length;
+        if (!out.includes(`Total: ${total} of ${total} hooks`))
+            throw new Error('total mismatch');
+    });
+    await test('list_hooks — category filter narrows result', async () => {
+        // Pick a real category from the first hook so the test doesn't hardcode.
+        const anyHook = getHook(getHookNames()[0]);
+        const out = await listHooks({ category: anyHook.category });
+        if (!out.includes(`category="${anyHook.category}"`))
+            throw new Error('filter not surfaced');
+        // Bogus category should return the "no matches" state, not throw.
+        const empty = await listHooks({ category: 'this-category-does-not-exist' });
+        if (!empty.includes('_No hooks match these filters._'))
+            throw new Error('empty-result message missing');
+    });
+    await test('list_hooks — serverSafe=true filter surfaced in output', async () => {
+        const out = await listHooks({ serverSafe: true });
+        if (!out.includes('serverSafe=true'))
+            throw new Error('filter not surfaced');
+    });
+    await test('list_hooks schema — accepts empty args', async () => {
+        const r = listHooksSchema.safeParse({});
+        if (!r.success)
+            throw new Error('should accept {}');
+    });
+    await test('get_hook — smoke on the first available hook', async () => {
+        const first = getHookNames()[0];
+        const out = await getHook_tool({ hookName: first });
+        if (!out.startsWith(`# ${first}`))
+            throw new Error('missing header');
+        if (!out.includes('**Signature**:'))
+            throw new Error('missing signature line');
+        if (!out.includes('**Returns**:'))
+            throw new Error('missing returns line');
+        if (!out.includes('## Import'))
+            throw new Error('missing import section');
+        if (!out.includes(`import { ${first} }`))
+            throw new Error('missing import statement');
+    });
+    await test('get_hook — RSC safety tag reflects hook.serverSafe', async () => {
+        const first = getHookNames()[0];
+        const h = getHook(first);
+        const out = await getHook_tool({ hookName: first });
+        const expected = h.serverSafe ? 'rsc-safe' : 'client-only';
+        if (!out.includes(expected))
+            throw new Error(`expected "${expected}" tag`);
+    });
+    await test('get_hook schema — rejects unknown hookName when enum is populated', async () => {
+        // The Zod enum is derived from meta at module load; if hooks are present,
+        // an obviously wrong name must fail validation.
+        if (getHookNames().length === 0)
+            return;
+        const r = getHookSchema.safeParse({ hookName: 'useDefinitelyNotARealHook' });
+        if (r.success)
+            throw new Error('should reject unknown hook name');
+    });
+    await test('get_hook schema — requires hookName', async () => {
+        const r = getHookSchema.safeParse({});
+        if (r.success)
+            throw new Error('should require hookName');
+    });
+    // ==========================================================================
+    log('\nJSX safety regressions (from v2.7.1 #19)', 'blue');
+    // ==========================================================================
+    await test('get_component rejects JSX-breaking char in string prop', async () => {
+        try {
+            await getComponent({ componentName: SAMPLE_COMPONENT, props: { title: 'x"; alert(1)' } });
+            throw new Error('should have thrown');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!msg.includes('JSX-unsafe character'))
+                throw new Error(`wrong error: ${msg}`);
+        }
+    });
+    await test('get_component rejects invalid prop key', async () => {
+        try {
+            await getComponent({ componentName: SAMPLE_COMPONENT, props: { 'onClick={alert(1)}': 'x' } });
+            throw new Error('should have thrown');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!msg.includes('not a valid JSX attribute identifier'))
+                throw new Error(`wrong error: ${msg}`);
+        }
+    });
+    await test('get_component schema — .max(8_000) on children', async () => {
+        const big = 'x'.repeat(10_001);
+        const r = getComponentSchema.safeParse({ componentName: SAMPLE_COMPONENT, children: big });
+        if (r.success)
+            throw new Error('should reject >8000-char children');
+    });
+    // ==========================================================================
+    log('\nError envelope (from v2.7.1 #15)', 'blue');
+    // ==========================================================================
+    await test('handleError — passes McpError through unchanged', async () => {
+        const original = new McpError(ErrorCode.InvalidParams, 'nope');
+        const out = handleError(original, () => { });
+        if (out !== original)
+            throw new Error('should be identity-equal');
+    });
+    await test('handleError — classifies ZodError as InvalidParams', async () => {
+        const zerr = z.string().safeParse(123);
+        if (zerr.success)
+            throw new Error('test setup failed');
+        const out = handleError(zerr.error, () => { });
+        if (out.code !== ErrorCode.InvalidParams)
+            throw new Error(`code mismatch: ${out.code}`);
+        if (!out.message.includes('Invalid arguments:'))
+            throw new Error('payload missing');
+    });
+    await test('handleError — redacts paths in unknown errors', async () => {
+        _resetErrorIdSeq();
+        const leaky = new Error('ENOENT: /Users/lando/secret/path.json');
+        const out = handleError(leaky, () => { });
+        if (out.message.includes('/Users/'))
+            throw new Error('path leaked');
+        if (!/Internal error \(id=[a-z0-9]+\)$/.test(out.message))
+            throw new Error('opaque envelope missing');
+    });
+    // ==========================================================================
+    log('\nLucide catalog (helpers)', 'blue');
+    // ==========================================================================
+    await test('lucide catalog — thousands of names', async () => {
+        if (lucideIconNames.length < 1000)
+            throw new Error('too few lucide names');
+    });
+    await test('isLucideIconName — case-insensitive match', async () => {
+        if (!isLucideIconName('menu') || !isLucideIconName('Menu'))
+            throw new Error('case sensitivity broken');
+    });
+    await test('searchLucideIconNames — exact match ranks first', async () => {
+        const results = searchLucideIconNames('Calendar', 5);
+        if (results[0] !== 'Calendar')
+            throw new Error(`expected Calendar first, got ${results[0]}`);
+    });
+    // ==========================================================================
+    log('\n===========================================', 'cyan');
+    log(`Passed: ${passed}  Failed: ${failed}`, failed === 0 ? 'green' : 'red');
+    log('===========================================\n', 'cyan');
+    if (failed > 0)
+        process.exit(1);
+}
+run().catch((error) => {
+    log('\nFatal error during test run:', 'red');
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=test.js.map