@urbicon-ui/mcp-server 6.25.0 → 6.26.0

package/src/prompts/design-prompts.test.ts

@@ -1,79 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { loadVerb } from '../data/verb-loader.js';
-import { buildVerbPrompt, variantCount } from './design-prompts.js';
-
-/** The full §8 verb table — every recipe must be present in the bundle. */
-const VERB_NAMES = [
-  'onboard',
-  'adopt',
-  'compose',
-  'redesign',
-  'polish',
-  'critique',
-  'fix',
-  'retheme',
-  'audit',
-  'migrate'
-];
-
-describe('variantCount', () => {
-  it('defaults to 3 for missing or non-numeric input', () => {
-    expect(variantCount(undefined)).toBe(3);
-    expect(variantCount('abc')).toBe(3);
-  });
-  it('clamps to the 2–5 range', () => {
-    expect(variantCount('1')).toBe(2);
-    expect(variantCount('9')).toBe(5);
-    expect(variantCount('4')).toBe(4);
-  });
-});
-
-describe('buildVerbPrompt', () => {
-  const body = '1. **Context.** Read the manifest.\n2. **Validate.** Run the linter.';
-
-  it('frames the verb and includes the recipe body', () => {
-    const p = buildVerbPrompt('compose', body, {});
-    expect(p).toContain('**compose** design recipe');
-    expect(p).toContain('Read the manifest');
-  });
-
-  it('embeds the brief as a blockquote when provided', () => {
-    expect(buildVerbPrompt('compose', body, { brief: 'a billing page' })).toContain(
-      '> **a billing page**'
-    );
-  });
-
-  it('inlines provided code in a svelte fence', () => {
-    const p = buildVerbPrompt('redesign', body, { code: '<div>old</div>' });
-    expect(p).toContain('```svelte\n<div>old</div>\n```');
-  });
-
-  it('appends a clamped variant instruction when variants are requested', () => {
-    expect(buildVerbPrompt('compose', body, { variants: '9' })).toContain('explore exactly 5');
-    expect(buildVerbPrompt('compose', body, { variants: '1' })).toContain('explore exactly 2');
-  });
-
-  it('degrades to a rebuild hint when the body is empty', () => {
-    expect(buildVerbPrompt('compose', '', {})).toContain('rebuild the design-content bundle');
-  });
-});
-
-describe('loadVerb (against the bundled recipes)', () => {
-  it('loads every verb in the §8 table, non-empty', async () => {
-    for (const name of VERB_NAMES) {
-      const body = await loadVerb(name);
-      expect(body.length, name).toBeGreaterThan(0);
-    }
-  });
-
-  it('a recipe opens by reading the manifest and references the real tool surface', async () => {
-    const compose = await loadVerb('compose');
-    expect(compose).toContain('manifest');
-    expect(compose).toContain('validate_design');
-    expect(compose).toContain('get_design_principles(as="rubric")');
-  });
-
-  it('returns the empty string for an unknown verb (read tolerant)', async () => {
-    expect(await loadVerb('does-not-exist')).toBe('');
-  });
-});

package/src/server.test.ts

@@ -1,78 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { createServer } from './server.js';
-
-/**
- * Smoke tests for the MCP server assembly. The SDK's `McpServer` keeps its
- * tool/resource maps on private fields (`_registeredTools`, `_registeredResources`,
- * `_registeredResourceTemplates`). We deliberately reach into those here because
- * the point of this test is to guard the wiring in `server.ts` — if a tool
- * registration goes missing or is renamed, this file should tell us about it.
- */
-interface McpServerInternals {
-  _registeredTools: Record<string, unknown>;
-  _registeredResources: Record<string, unknown>;
-  _registeredResourceTemplates: Record<string, unknown>;
-  _registeredPrompts: Record<string, unknown>;
-}
-
-const EXPECTED_TOOLS = [
-  'find_components',
-  'get_component',
-  'get_recipe',
-  'suggest_implementation',
-  'get_implementation_checklist',
-  'get_css_reference',
-  'find_icons',
-  'get_design_principles',
-  'get_pattern',
-  'validate_design'
-] as const;
-
-describe('createServer', () => {
-  it('boots without throwing', () => {
-    expect(() => createServer()).not.toThrow();
-  });
-
-  it('returns an object', () => {
-    const server = createServer();
-    expect(server).toBeTypeOf('object');
-    expect(server).not.toBeNull();
-  });
-
-  it('registers exactly the expected set of tools', () => {
-    const server = createServer() as unknown as McpServerInternals;
-    const toolNames = Object.keys(server._registeredTools);
-
-    for (const expected of EXPECTED_TOOLS) {
-      expect(toolNames, `missing tool: ${expected}`).toContain(expected);
-    }
-    expect(toolNames).toHaveLength(EXPECTED_TOOLS.length);
-  });
-
-  it('registers at least one catalog resource', () => {
-    const server = createServer() as unknown as McpServerInternals;
-    const resourceCount =
-      Object.keys(server._registeredResources).length +
-      Object.keys(server._registeredResourceTemplates).length;
-    expect(resourceCount).toBeGreaterThan(0);
-  });
-
-  it('registers the full design-verb table as prompts', () => {
-    const server = createServer() as unknown as McpServerInternals;
-    const promptNames = Object.keys(server._registeredPrompts);
-    for (const verb of [
-      'onboard',
-      'adopt',
-      'compose',
-      'redesign',
-      'polish',
-      'critique',
-      'fix',
-      'retheme',
-      'audit',
-      'migrate'
-    ]) {
-      expect(promptNames, verb).toContain(verb);
-    }
-  });
-});

package/src/utils/format-catalog.test.ts

@@ -1,144 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import type { ComponentCatalogEntry, RecipeEntry } from '../data/catalog-loader.js';
-import { filterInternalComponents, formatCompactCatalog } from './format-catalog.js';
-
-function makeEntry(
-  overrides: Partial<ComponentCatalogEntry> & Pick<ComponentCatalogEntry, 'name' | 'slug'>
-): ComponentCatalogEntry {
-  return {
-    package: '@urbicon-ui/blocks',
-    group: 'primitives',
-    description: 'desc',
-    tags: [],
-    import: `import { ${overrides.name} } from '@urbicon-ui/blocks';`,
-    llmTxtPath: '',
-    variants: [],
-    keyProps: [],
-    keyPropTypes: {},
-    slots: [],
-    hasExamples: false,
-    relatedComponents: [],
-    ...overrides
-  };
-}
-
-describe('filterInternalComponents', () => {
-  it('removes docs-site-internal components from the list', () => {
-    const entries = [
-      makeEntry({ name: 'Button', slug: 'button' }),
-      makeEntry({ name: 'ApiReference', slug: 'api-reference' }),
-      makeEntry({ name: 'PlaygroundConfigurator', slug: 'playground-configurator' }),
-      makeEntry({ name: 'Input', slug: 'input' })
-    ];
-    const result = filterInternalComponents(entries);
-    expect(result.map((e) => e.name)).toEqual(['Button', 'Input']);
-  });
-
-  it('returns an empty list when all entries are internal', () => {
-    const entries = [
-      makeEntry({ name: 'DocsLayout', slug: 'docs-layout' }),
-      makeEntry({ name: 'InfoCard', slug: 'info-card' })
-    ];
-    expect(filterInternalComponents(entries)).toEqual([]);
-  });
-});
-
-describe('formatCompactCatalog', () => {
-  const button = makeEntry({
-    name: 'Button',
-    slug: 'button',
-    description: 'Click to do things',
-    tags: ['action'],
-    variants: [{ name: 'intent', values: ['primary', 'danger'] }]
-  });
-  const input = makeEntry({
-    name: 'Input',
-    slug: 'input',
-    description: 'Text field',
-    tags: ['form'],
-    relatedComponents: ['Textarea']
-  });
-  const alert = makeEntry({
-    name: 'Alert',
-    slug: 'alert',
-    description: 'Inline message',
-    tags: ['feedback']
-  });
-  const orphan = makeEntry({
-    name: 'Mystery',
-    slug: 'mystery',
-    description: 'No primary tag here',
-    tags: ['unknown']
-  });
-
-  it('outputs a markdown document with the component count', () => {
-    const md = formatCompactCatalog([button, input]);
-    expect(md).toContain('# Urbicon UI Components');
-    expect(md).toContain('> 2 components available.');
-    expect(md).toContain('get_component');
-  });
-
-  it('groups components by their primary tag in the canonical order', () => {
-    const md = formatCompactCatalog([alert, button, input]);
-    const actionIdx = md.indexOf('## Actions');
-    const formsIdx = md.indexOf('## Forms');
-    const feedbackIdx = md.indexOf('## Feedback & Status');
-    expect(actionIdx).toBeGreaterThan(-1);
-    expect(formsIdx).toBeGreaterThan(actionIdx);
-    expect(feedbackIdx).toBeGreaterThan(formsIdx);
-  });
-
-  it('puts components with unrecognised primary tags in the Other bucket', () => {
-    const md = formatCompactCatalog([orphan]);
-    expect(md).toContain('## Other');
-    expect(md).toContain('Mystery');
-  });
-
-  it('renders variant details when a non-boolean variant is present', () => {
-    const md = formatCompactCatalog([button]);
-    expect(md).toContain('intent: primary/danger');
-  });
-
-  it('omits boolean-only variants from the rendered line', () => {
-    const withBool = makeEntry({
-      name: 'Toggle',
-      slug: 'toggle',
-      description: 'On/off',
-      tags: ['form'],
-      variants: [{ name: 'checked', values: ['true', 'false'] }]
-    });
-    const md = formatCompactCatalog([withBool]);
-    expect(md).not.toContain('checked: true/false');
-  });
-
-  it('renders a Related hint when related components exist', () => {
-    const md = formatCompactCatalog([input]);
-    expect(md).toContain('Related: Textarea');
-  });
-
-  it('filters by the tags option', () => {
-    const md = formatCompactCatalog([button, input, alert], { tags: ['form'] });
-    // Matching the bold-component-bullet prefix avoids false positives from
-    // the Quick-Setup section (which itself references `Button` in code).
-    expect(md).toContain('- **Input**');
-    expect(md).not.toContain('- **Button**');
-    expect(md).not.toContain('- **Alert**');
-  });
-
-  it('appends a Recipes section when recipes are supplied', () => {
-    const recipes: RecipeEntry[] = [
-      {
-        id: 'login-form',
-        title: 'Login',
-        description: 'Login screen',
-        components: ['Input', 'Button'],
-        code: '',
-        features: []
-      }
-    ];
-    const md = formatCompactCatalog([button, input], { recipes });
-    expect(md).toContain('## Recipes');
-    expect(md).toContain('**login-form**');
-    expect(md).toContain('Input, Button');
-  });
-});

package/tsconfig.json

@@ -1,27 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "composite": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "isolatedModules": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "verbatimModuleSyntax": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "types": ["node"],
-    "tsBuildInfoFile": "./dist/tsconfig.tsbuildinfo"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/vitest.config.ts

@@ -1,15 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    // zod@4's ESM layout needs to be inlined so vitest's vite-ssr runner
-    // resolves the named export correctly; otherwise `z.string` comes back
-    // as undefined inside the tool modules.
-    server: {
-      deps: {
-        inline: ['zod']
-      }
-    },
-    include: ['src/**/*.test.ts']
-  }
-});