@lando-labs/lando-ds-mcp 4.0.0

package/build/tools/platform-transform.js

@@ -0,0 +1,117 @@
+/**
+ * Platform-aware transformations for code-gen tools.
+ *
+ * Sprint 29, Lane G (#244): given a chunk of generated JSX + an import
+ * statement, produce the RN-flavored variant when `platform === 'react-native'`.
+ *
+ * Transformations applied for RN:
+ *   - Import path: `@lando-labs/design-system` → `@lando-labs/design-system-native`
+ *   - Event handlers:
+ *       onClick      → onPress
+ *       onChange     → onChangeText  (only when the target is an Input/Textarea)
+ *   - JSX tags:
+ *       <div>...</div>   → <View>...</View>
+ *       <span>...</span> → <Text>...</Text>
+ *   - Inline `style={{...}}` is left in place but annotated with a one-line
+ *     comment hint that `StyleSheet.create` is preferred.
+ *
+ * The helpers here are intentionally regex-based: the inputs are short
+ * generated snippets where a parser would be overkill. The transformations
+ * are conservative — anything ambiguous is left alone (and warned about).
+ */
+/** Web import-path the metadata files emit. */
+const WEB_IMPORT_PATH = '@lando-labs/design-system';
+/** RN import-path the design system ships under. */
+const RN_IMPORT_PATH = '@lando-labs/design-system-native';
+/**
+ * Swap the web package name for the RN package name inside any import
+ * statement that targets the web DS. Other imports (`react`, `next/link`,
+ * `lucide-react`, etc.) pass through unchanged.
+ *
+ * Safe to call on input that may not contain an import statement — it's a
+ * no-op in that case.
+ */
+export function rewriteImportPath(snippet, platform) {
+    if (platform !== 'react-native')
+        return snippet;
+    // Match the package name only inside `from '...'` clauses so we don't
+    // accidentally swap occurrences in strings/comments.
+    return snippet.replace(new RegExp(`from\\s+(['"])${escapeForRegex(WEB_IMPORT_PATH)}\\1`, 'g'), `from $1${RN_IMPORT_PATH}$1`);
+}
+/**
+ * Rewrite a JSX snippet for RN.
+ *
+ * Returns both the transformed code and any warnings the caller may want
+ * to surface (e.g. the inline-style hint, ambiguous onChange usage on
+ * non-text elements, etc.).
+ */
+export function rewriteJsxForRn(jsx, options = {}) {
+    const warnings = [];
+    // Inline imports inside example bodies (e.g. the canned `Button as Next.js
+    // Link` example embeds its own `import { Button } from ...` line) must
+    // also flip to the RN package. We always force RN here because callers
+    // gate on platform before invoking this helper.
+    let out = rewriteImportPath(jsx, 'react-native');
+    // 1. JSX intrinsics. Keep these conservative — only swap exact tag names
+    //    so we don't touch `<DivSomething>` etc.
+    out = out.replace(/<div(\s|>|\/>)/g, '<View$1');
+    out = out.replace(/<\/div>/g, '</View>');
+    out = out.replace(/<span(\s|>|\/>)/g, '<Text$1');
+    out = out.replace(/<\/span>/g, '</Text>');
+    // 2. onClick → onPress. Match `onClick=` (with `{` or `"` payload boundary
+    //    to avoid touching strings like "onClickHandler" defined in props).
+    out = out.replace(/\bonClick=/g, 'onPress=');
+    // 3. onChange → onChangeText, only for text inputs. RN's onChange has a
+    //    different signature for non-text controls (Switch, Select equivalent
+    //    on RN), so we only rewrite for input/textarea targets — for anything
+    //    else we leave onChange alone and emit a warning.
+    if (options.componentName === 'input' || options.componentName === 'textarea') {
+        out = out.replace(/\bonChange=/g, 'onChangeText=');
+    }
+    else if (/\bonChange=/.test(out)) {
+        warnings.push('onChange detected on a non-text component — RN consumers may need to remap this handler (e.g. onValueChange for Switch).');
+    }
+    // 4. Inline-style hint. If the snippet contains `style={{`, flag a hint
+    //    about StyleSheet.create. We don't modify the snippet — both forms are
+    //    valid in RN, the hint is informational.
+    if (/style=\{\{/.test(out)) {
+        warnings.push('Inline style={{ ... }} works on RN, but StyleSheet.create is preferred for performance + memoization.');
+    }
+    return { code: out, warnings };
+}
+/**
+ * Convenience wrapper: apply both import + JSX rewrites to a full snippet
+ * (import statement + JSX), keeping the existing two-section format
+ * (`<import>\n\n<jsx>`) produced by `get_component` / `get_usage_example`.
+ *
+ * Splits on the first blank line; if none is found, the entire input is
+ * treated as JSX (no import to rewrite).
+ */
+export function rewriteSnippetForPlatform(snippet, platform, options = {}) {
+    if (platform !== 'react-native') {
+        return { code: snippet, warnings: [] };
+    }
+    const blankLine = snippet.indexOf('\n\n');
+    if (blankLine === -1) {
+        return rewriteJsxForRn(snippet, options);
+    }
+    const head = snippet.slice(0, blankLine);
+    const body = snippet.slice(blankLine + 2);
+    const rewrittenHead = rewriteImportPath(head, platform);
+    const { code: rewrittenBody, warnings } = rewriteJsxForRn(body, options);
+    return { code: `${rewrittenHead}\n\n${rewrittenBody}`, warnings };
+}
+/**
+ * Format a list of warnings as a leading comment block. Returns an empty
+ * string if there are no warnings.
+ */
+export function formatWarningsHeader(warnings) {
+    if (warnings.length === 0)
+        return '';
+    const lines = warnings.map((w) => `// [RN] ${w}`).join('\n');
+    return `${lines}\n\n`;
+}
+function escapeForRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=platform-transform.js.map

package/build/tools/platform-transform.js.map

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

package/build/tools/platform.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Shared platform parameter definition for MCP tool schemas.
+ *
+ * Every tool accepts an optional `platform` field that controls import paths,
+ * output format, and component availability filtering. Defaulting to `'web'`
+ * keeps every existing AI consumer (that doesn't pass `platform`) on the
+ * exact same behavior we shipped before Sprint 29.
+ *
+ * Lanes G + H consume this parameter in their respective tools to render
+ * RN-flavored output (`@lando-labs/design-system-native` imports, RN
+ * StyleSheet snippets, etc.). The platform field is plumbed through every
+ * tool's Zod schema so future lanes only need to read `params.platform` —
+ * no schema migration required.
+ */
+import { z } from 'zod';
+/**
+ * Target platforms the MCP server can produce output for.
+ *
+ * - `web`         — `@lando-labs/design-system` (CSS variables, JSX with web imports)
+ * - `react-native` — `@lando-labs/design-system-native` (RN primitives, StyleSheet)
+ */
+export declare const platformValues: readonly ["web", "react-native"];
+export type Platform = (typeof platformValues)[number];
+/**
+ * Zod schema fragment for the `platform` parameter.
+ *
+ * Spread or merge this into every tool's input schema so the parameter is
+ * uniform across the entire server. The field is `.optional()` (no
+ * `.default()` on the Zod side) so `z.infer<typeof schema>` yields
+ * `platform?: 'web' | 'react-native'` — i.e. the parameter is truly optional
+ * for callers and existing test fixtures don't need to be updated.
+ *
+ * Handler-side defaulting: use `resolvePlatform(params.platform)` (below) to
+ * collapse `undefined` to `'web'`. Doing it this way preserves backwards
+ * compatibility for every existing AI consumer that doesn't pass the
+ * parameter, while keeping the public surface advertised in the JSON Schema
+ * (see `platformJsonSchema`) honest about the default.
+ *
+ * Usage:
+ *
+ *   const mySchema = z.object({
+ *     foo: z.string(),
+ *     ...platformSchemaShape,
+ *   })
+ *
+ *   function myHandler(params: z.infer<typeof mySchema>) {
+ *     const platform = resolvePlatform(params.platform) // 'web' if unset
+ *     // ...
+ *   }
+ */
+export declare const platformSchemaShape: {
+    readonly platform: z.ZodOptional<z.ZodEnum<["web", "react-native"]>>;
+};
+/**
+ * Resolve an incoming `platform` field to a concrete `Platform`.
+ *
+ * Always falls back to `'web'` when undefined, mirroring the JSON Schema
+ * default we advertise to consumers.
+ */
+export declare function resolvePlatform(platform: Platform | undefined): Platform;
+/**
+ * JSON Schema fragment for the `platform` parameter, suitable for embedding
+ * directly into the `inputSchema.properties` object that the MCP server
+ * advertises via `ListToolsRequestSchema`.
+ *
+ * Kept in sync with `platformSchemaShape` above — both must describe the
+ * same shape, since one is parsed (Zod) and the other is advertised (JSON
+ * Schema).
+ */
+export declare const platformJsonSchema: {
+    readonly type: "string";
+    readonly enum: string[];
+    readonly default: "web";
+    readonly description: "Target platform. Controls import paths, output format, and component availability filtering.";
+};
+//# sourceMappingURL=platform.d.ts.map

package/build/tools/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/tools/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,kCAAmC,CAAA;AAE9D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,mBAAmB;;CAOtB,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAExE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;mBAEM,MAAM,EAAE;;;CAInC,CAAA"}

package/build/tools/platform.js

@@ -0,0 +1,80 @@
+/**
+ * Shared platform parameter definition for MCP tool schemas.
+ *
+ * Every tool accepts an optional `platform` field that controls import paths,
+ * output format, and component availability filtering. Defaulting to `'web'`
+ * keeps every existing AI consumer (that doesn't pass `platform`) on the
+ * exact same behavior we shipped before Sprint 29.
+ *
+ * Lanes G + H consume this parameter in their respective tools to render
+ * RN-flavored output (`@lando-labs/design-system-native` imports, RN
+ * StyleSheet snippets, etc.). The platform field is plumbed through every
+ * tool's Zod schema so future lanes only need to read `params.platform` —
+ * no schema migration required.
+ */
+import { z } from 'zod';
+/**
+ * Target platforms the MCP server can produce output for.
+ *
+ * - `web`         — `@lando-labs/design-system` (CSS variables, JSX with web imports)
+ * - `react-native` — `@lando-labs/design-system-native` (RN primitives, StyleSheet)
+ */
+export const platformValues = ['web', 'react-native'];
+/**
+ * Zod schema fragment for the `platform` parameter.
+ *
+ * Spread or merge this into every tool's input schema so the parameter is
+ * uniform across the entire server. The field is `.optional()` (no
+ * `.default()` on the Zod side) so `z.infer<typeof schema>` yields
+ * `platform?: 'web' | 'react-native'` — i.e. the parameter is truly optional
+ * for callers and existing test fixtures don't need to be updated.
+ *
+ * Handler-side defaulting: use `resolvePlatform(params.platform)` (below) to
+ * collapse `undefined` to `'web'`. Doing it this way preserves backwards
+ * compatibility for every existing AI consumer that doesn't pass the
+ * parameter, while keeping the public surface advertised in the JSON Schema
+ * (see `platformJsonSchema`) honest about the default.
+ *
+ * Usage:
+ *
+ *   const mySchema = z.object({
+ *     foo: z.string(),
+ *     ...platformSchemaShape,
+ *   })
+ *
+ *   function myHandler(params: z.infer<typeof mySchema>) {
+ *     const platform = resolvePlatform(params.platform) // 'web' if unset
+ *     // ...
+ *   }
+ */
+export const platformSchemaShape = {
+    platform: z
+        .enum(platformValues)
+        .optional()
+        .describe("Target platform. Controls import paths, output format, and component availability filtering. Defaults to 'web' for backwards compatibility."),
+};
+/**
+ * Resolve an incoming `platform` field to a concrete `Platform`.
+ *
+ * Always falls back to `'web'` when undefined, mirroring the JSON Schema
+ * default we advertise to consumers.
+ */
+export function resolvePlatform(platform) {
+    return platform ?? 'web';
+}
+/**
+ * JSON Schema fragment for the `platform` parameter, suitable for embedding
+ * directly into the `inputSchema.properties` object that the MCP server
+ * advertises via `ListToolsRequestSchema`.
+ *
+ * Kept in sync with `platformSchemaShape` above — both must describe the
+ * same shape, since one is parsed (Zod) and the other is advertised (JSON
+ * Schema).
+ */
+export const platformJsonSchema = {
+    type: 'string',
+    enum: platformValues,
+    default: 'web',
+    description: "Target platform. Controls import paths, output format, and component availability filtering.",
+};
+//# sourceMappingURL=platform.js.map

package/build/tools/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/tools/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,cAAc,CAAU,CAAA;AAI9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,cAAc,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CACP,6IAA6I,CAC9I;CACK,CAAA;AAEV;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAA8B;IAC5D,OAAO,QAAQ,IAAI,KAAK,CAAA;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,cAAqC;IAC3C,OAAO,EAAE,KAAK;IACd,WAAW,EACT,8FAA8F;CACxF,CAAA"}

package/build/tools/search-icons.d.ts

@@ -0,0 +1,28 @@
+/**
+ * search_icons Tool — meta-backed sources, brand-neutral.
+ *
+ * Semantic search across DS-brand + Lucide-curated icons. Same source
+ * filter as list_icons ('ds-brand' | 'lucide-curated' | 'all'). Also
+ * spills over into the full Lucide library for additional matches that
+ * aren't in either curated set.
+ */
+import { z } from 'zod';
+export declare const searchIconsSchema: z.ZodObject<{
+    query: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<["ds-brand", "lucide-curated", "all"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    category?: string | undefined;
+    source?: "all" | "ds-brand" | "lucide-curated" | undefined;
+    limit?: number | undefined;
+}, {
+    query: string;
+    category?: string | undefined;
+    source?: "all" | "ds-brand" | "lucide-curated" | undefined;
+    limit?: number | undefined;
+}>;
+export type SearchIconsParams = z.infer<typeof searchIconsSchema>;
+export declare function searchIcons(params: SearchIconsParams): Promise<string>;
+//# sourceMappingURL=search-icons.d.ts.map

package/build/tools/search-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-icons.d.ts","sourceRoot":"","sources":["../../src/tools/search-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAiB5B,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AA6MjE,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB5E"}

package/build/tools/search-icons.js

@@ -0,0 +1,257 @@
+/**
+ * search_icons Tool — meta-backed sources, brand-neutral.
+ *
+ * Semantic search across DS-brand + Lucide-curated icons. Same source
+ * filter as list_icons ('ds-brand' | 'lucide-curated' | 'all'). Also
+ * spills over into the full Lucide library for additional matches that
+ * aren't in either curated set.
+ */
+import { z } from 'zod';
+import { allIconMetadata, } from '../data/icon-metadata.js';
+import { resolveLibraryInfo } from '../utils/icon-library.js';
+import { searchLucideIconNames } from '../data/lucide-icons.js';
+import { getLightMeta } from '../utils/meta-loader.js';
+export const searchIconsSchema = z.object({
+    query: z
+        .string()
+        .max(8_000)
+        .describe('What you want to accomplish (e.g. "show user profile", "indicate success", "navigate home").'),
+    category: z.string().max(100).optional().describe('Optional: filter to this category.'),
+    source: z
+        .enum(['ds-brand', 'lucide-curated', 'all'])
+        .optional()
+        .describe("Icon source (default 'all')."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum curated matches to return (default: 10, max: 200).'),
+});
+// ---------------------------------------------------------------------------
+// Purpose → icon-name mappings (brand-neutral)
+// ---------------------------------------------------------------------------
+const purposeMappings = {
+    'user profile': ['User', 'user', 'UserCircle'],
+    'account settings': ['User', 'Settings', 'settings'],
+    'user menu': ['UserCircle', 'User', 'user'],
+    'navigate home': ['Home', 'house'],
+    'go back': ['ArrowLeft', 'arrow-left', 'ChevronLeft', 'chevron-left'],
+    'go forward': ['ArrowRight', 'arrow-right', 'ChevronRight', 'chevron-right'],
+    'scroll up': ['ChevronUp', 'chevron-up', 'ArrowUp'],
+    'scroll down': ['ChevronDown', 'chevron-down', 'ArrowDown'],
+    navigate: ['ArrowRight', 'ChevronRight', 'arrow-right', 'chevron-right'],
+    'indicate success': ['CheckCircle', 'check', 'success', 'Check'],
+    'show error': ['XCircle', 'error', 'AlertCircle', 'X'],
+    'show warning': ['AlertTriangle', 'warning', 'AlertCircle'],
+    'show info': ['Info', 'info', 'AlertCircle'],
+    'loading state': ['Loader2', 'RefreshCw'],
+    loading: ['Loader2', 'RefreshCw'],
+    'edit content': ['Edit', 'edit', 'Pencil'],
+    'delete item': ['Trash2', 'trash', 'X'],
+    'download file': ['Download', 'download'],
+    'upload file': ['Upload', 'upload'],
+    'copy text': ['Copy', 'copy'],
+    search: ['Search', 'search'],
+    save: ['Save', 'save', 'Download'],
+    'close dialog': ['X', 'close', 'XCircle'],
+    'dismiss modal': ['X', 'close'],
+    'cancel action': ['X', 'close'],
+    'send message': ['Send', 'send', 'MessageSquare'],
+    chat: ['message', 'MessageSquare', 'MessageCircle'],
+    'user list': ['users', 'Users'],
+    email: ['Mail', 'send', 'Send'],
+    notification: ['Bell', 'AlertCircle'],
+    'file upload': ['Upload', 'upload', 'file'],
+    folder: ['folder', 'Folder'],
+    'image upload': ['image', 'Image', 'Upload'],
+    document: ['File', 'file', 'FileText'],
+    'open settings': ['Settings', 'settings', 'Sliders'],
+    configure: ['Settings', 'settings', 'Sliders'],
+    'open menu': ['Menu', 'menu', 'MoreVertical'],
+    'more options': ['MoreVertical', 'MoreHorizontal'],
+    'show date': ['calendar', 'Calendar'],
+    'show time': ['clock', 'Clock'],
+    'light mode': ['sun', 'Sun'],
+    'dark mode': ['moon', 'Moon'],
+    show: ['Eye', 'eye'],
+    hide: ['EyeOff', 'eye'],
+    visible: ['Eye', 'eye'],
+    secure: ['Lock', 'lock'],
+    lock: ['Lock', 'lock'],
+    unlock: ['Unlock', 'unlock'],
+    favorite: ['Star', 'star', 'Heart', 'heart'],
+    like: ['Heart', 'heart'],
+    bookmark: ['Bookmark', 'bookmark'],
+    refresh: ['RefreshCw', 'refresh'],
+    reload: ['RefreshCw', 'refresh'],
+    sync: ['RefreshCw', 'sync'],
+    expand: ['Maximize2', 'maximize', 'plus'],
+    collapse: ['Minimize2', 'minimize', 'minus'],
+    fullscreen: ['Maximize2', 'maximize'],
+    filter: ['Filter', 'filter', 'Sliders'],
+    sort: ['Filter', 'filter'],
+    'zoom in': ['ZoomIn', 'plus'],
+    'zoom out': ['ZoomOut', 'minus'],
+    'grid view': ['Grid', 'grid'],
+    'list view': ['List', 'list'],
+    play: ['Play', 'play'],
+    pause: ['Pause', 'pause'],
+    volume: ['Volume2', 'volume'],
+    ai: ['Sparkles', 'sparkles', 'Zap'],
+    magic: ['Sparkles', 'sparkles'],
+    fast: ['Zap', 'zap'],
+    power: ['Zap', 'zap'],
+};
+function dsBrandIcons() {
+    const registry = getLightMeta().icons.registry;
+    return Object.values(registry).map((entry) => ({
+        name: entry.name,
+        source: 'ds-brand',
+        category: entry.category,
+        description: `${entry.name} (DS brand icon)`,
+        tags: [entry.name, entry.category, entry.lucideName],
+        lucideName: entry.lucideName,
+    }));
+}
+function lucideCuratedIcons() {
+    return allIconMetadata
+        .filter((i) => i.source === 'lucide')
+        .map((i) => ({
+        name: i.name,
+        source: 'lucide-curated',
+        category: i.category,
+        description: i.description,
+        tags: i.tags,
+        lucideName: i.name,
+        commonUsage: i.commonUsage,
+        aliases: i.aliases,
+    }));
+}
+function collectIcons(source) {
+    if (source === 'ds-brand')
+        return dsBrandIcons();
+    if (source === 'lucide-curated')
+        return lucideCuratedIcons();
+    const brand = dsBrandIcons();
+    const brandNames = new Set(brand.map((i) => i.name));
+    const curated = lucideCuratedIcons().filter((i) => !brandNames.has(i.name));
+    return [...brand, ...curated];
+}
+// ---------------------------------------------------------------------------
+// Ranking
+// ---------------------------------------------------------------------------
+function findByPurpose(pool, query, category) {
+    const q = query.toLowerCase();
+    const matches = new Set();
+    for (const [key, names] of Object.entries(purposeMappings)) {
+        if (q.includes(key) || key.includes(q)) {
+            for (const name of names) {
+                const hit = pool.find((i) => i.name === name || i.lucideName === name);
+                if (hit)
+                    matches.add(hit);
+            }
+        }
+    }
+    for (const icon of pool) {
+        if (icon.name.toLowerCase().includes(q) ||
+            icon.tags.some((t) => q.includes(t.toLowerCase()) || t.toLowerCase().includes(q)) ||
+            icon.description.toLowerCase().includes(q) ||
+            icon.commonUsage?.toLowerCase().includes(q) ||
+            icon.aliases?.some((a) => q.includes(a.toLowerCase()))) {
+            matches.add(icon);
+        }
+    }
+    let results = [...matches];
+    if (category)
+        results = results.filter((i) => i.category === category);
+    return results;
+}
+function score(icon, q, category) {
+    let s = 0;
+    const name = icon.name.toLowerCase();
+    if (name === q)
+        s += 100;
+    if (name.includes(q))
+        s += 50;
+    if (icon.tags.some((t) => t.toLowerCase() === q))
+        s += 80;
+    if (icon.tags.some((t) => t.toLowerCase().includes(q)))
+        s += 40;
+    if (icon.description.toLowerCase().includes(q))
+        s += 30;
+    if (icon.commonUsage?.toLowerCase().includes(q))
+        s += 60;
+    if (icon.aliases?.some((a) => a.toLowerCase() === q))
+        s += 70;
+    if (icon.aliases?.some((a) => a.toLowerCase().includes(q)))
+        s += 35;
+    if (category && icon.category === category)
+        s += 30;
+    // DS-brand icons get a small preference — they're the DS-canonical set.
+    if (icon.source === 'ds-brand')
+        s += 5;
+    return s;
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function searchIcons(params) {
+    const { query, category, limit } = params;
+    const source = params.source ?? 'all';
+    const safeLimit = limit ?? 10;
+    const pool = collectIcons(source);
+    const raw = findByPurpose(pool, query, category);
+    const q = query.toLowerCase();
+    const ranked = raw
+        .map((icon) => ({ icon, s: score(icon, q, category) }))
+        .sort((a, b) => b.s - a.s)
+        .map((entry) => entry.icon);
+    const results = ranked.slice(0, safeLimit);
+    const curatedNames = new Set(results.map((r) => r.name));
+    const lucideExtras = searchLucideIconNames(query)
+        .filter((name) => !curatedNames.has(name))
+        .slice(0, safeLimit);
+    const libraryInfo = resolveLibraryInfo();
+    return format(results, lucideExtras, query, category, source, libraryInfo);
+}
+function format(results, lucideExtras, query, category, source, libraryInfo) {
+    let out = '# Icon Search Results\n\n';
+    out += `**Query**: "${query}"\n`;
+    if (category)
+        out += `**Category**: ${category}\n`;
+    if (source !== 'all')
+        out += `**Source**: ${source}\n`;
+    out += `**Library**: \`${libraryInfo.libraryName}\`\n\n`;
+    if (results.length === 0 && lucideExtras.length === 0) {
+        out += 'No icons found. Try different keywords, or browse the full Lucide library: ';
+        out += `${libraryInfo.browseUrl}\n`;
+        return out;
+    }
+    if (results.length > 0) {
+        out += `## Recommended (${results.length})\n\n`;
+        results.forEach((icon, idx) => {
+            const rank = idx + 1;
+            out += `### ${rank}. **${icon.name}** _(${icon.source})_\n\n`;
+            out += `- Description: ${icon.description}\n`;
+            out += `- Category: ${icon.category}\n`;
+            if (icon.commonUsage)
+                out += `- Common usage: ${icon.commonUsage}\n`;
+            const lucideName = icon.lucideName ?? icon.name;
+            out += `\n\`\`\`tsx\nimport { ${lucideName} } from '${libraryInfo.libraryName}'\n\n`;
+            out += `<Icon size="md"><${lucideName} /></Icon>\n\`\`\`\n\n`;
+        });
+    }
+    if (lucideExtras.length > 0) {
+        out += `## Additional Lucide Matches (${lucideExtras.length})\n\n`;
+        out += `Names from the full Lucide library (not curated but supported via \`${libraryInfo.libraryName}\`):\n\n`;
+        lucideExtras.forEach((name) => {
+            out += `- **${name}** — \`import { ${name} } from '${libraryInfo.libraryName}'\`\n`;
+        });
+        out += '\n';
+    }
+    out += `---\n\nBrowse the full Lucide library (~${libraryInfo.totalIcons.toLocaleString()} icons): ${libraryInfo.browseUrl}\n`;
+    return out;
+}
+//# sourceMappingURL=search-icons.js.map

package/build/tools/search-icons.js.map

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

package/build/utils/error-envelope.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Error envelope (#15).
+ *
+ * Three-class classifier so the client gets useful errors for the things it
+ * can fix (validation, MCP-defined codes) and an opaque correlation ID for
+ * anything else. error.message is NEVER passed to the client because it may
+ * contain stack frames, ts-morph paths, or other filesystem disclosures.
+ * A levelled logger replaces console.error in Sprint 3 (#12).
+ */
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+/** Reset the sequence — test-only. */
+export declare function _resetErrorIdSeq(): void;
+export declare function handleError(error: unknown, logger?: (message: string, error: unknown) => void): McpError;
+//# sourceMappingURL=error-envelope.d.ts.map

package/build/utils/error-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-envelope.d.ts","sourceRoot":"","sources":["../../src/utils/error-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAa,MAAM,oCAAoC,CAAA;AAIxE,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAOD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAwC,GACpF,QAAQ,CAeV"}

package/build/utils/error-envelope.js

@@ -0,0 +1,35 @@
+/**
+ * Error envelope (#15).
+ *
+ * Three-class classifier so the client gets useful errors for the things it
+ * can fix (validation, MCP-defined codes) and an opaque correlation ID for
+ * anything else. error.message is NEVER passed to the client because it may
+ * contain stack frames, ts-morph paths, or other filesystem disclosures.
+ * A levelled logger replaces console.error in Sprint 3 (#12).
+ */
+import { z } from 'zod';
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+let errorIdSeq = 0;
+/** Reset the sequence — test-only. */
+export function _resetErrorIdSeq() {
+    errorIdSeq = 0;
+}
+function nextErrorId() {
+    errorIdSeq = (errorIdSeq + 1) >>> 0;
+    return errorIdSeq.toString(36).padStart(4, '0');
+}
+export function handleError(error, logger = (msg, e) => console.error(msg, e)) {
+    if (error instanceof McpError) {
+        return error;
+    }
+    if (error instanceof z.ZodError) {
+        const summary = error.errors
+            .map((e) => `${e.path.join('.') || '(root)'}: ${e.message}`)
+            .join('; ');
+        return new McpError(ErrorCode.InvalidParams, `Invalid arguments: ${summary}`);
+    }
+    const id = nextErrorId();
+    logger(`[mcp][error id=${id}]`, error);
+    return new McpError(ErrorCode.InternalError, `Internal error (id=${id})`);
+}
+//# sourceMappingURL=error-envelope.js.map