@lando-labs/lando-ds-mcp 4.0.0

package/build/tools/get-animation-examples.js

@@ -0,0 +1,484 @@
+/**
+ * get_animation_examples Tool (RN branch stripped in v4.0.0).
+ *
+ * Canonical DS animation patterns (CSS keyframes + usage). Brand-neutral;
+ * animations are technique-based (wave-dots, ripple, fade, slide, pulse,
+ * shimmer, bounce, spin), not tied to any specific brand.
+ */
+import { z } from 'zod';
+export const getAnimationExamplesSchema = z.object({
+    animationType: z.enum([
+        'wave-dots',
+        'ripple',
+        'fade-in',
+        'fade-out',
+        'slide-up',
+        'slide-down',
+        'slide-left',
+        'slide-right',
+        'pulse',
+        'shimmer',
+        'bounce',
+        'spin',
+        'all'
+    ]).optional().describe('Type of animation to get. Omit or use "all" to see all available animations.'),
+});
+const animations = {
+    'wave-dots': {
+        name: 'Wave Dots',
+        description: 'Three bouncing dots animation, perfect for loading indicators.',
+        cssKeyframes: `@keyframes waveDots {
+  0%, 60%, 100% {
+    transform: translateY(0);
+  }
+  30% {
+    transform: translateY(-10px);
+  }
+}`,
+        usage: `Apply to three dot elements with staggered animation-delay:
+.dot:nth-child(1) { animation-delay: 0s; }
+.dot:nth-child(2) { animation-delay: 0.15s; }
+.dot:nth-child(3) { animation-delay: 0.3s; }`,
+        timing: {
+            duration: '1.4s (var(--duration-slow))',
+            easing: 'ease-in-out'
+        },
+        example: `.waveDots {
+  display: flex;
+  gap: var(--spacing-4);
+  align-items: center;
+}
+
+.dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--color-primary);
+  animation: waveDots 1.4s ease-in-out infinite;
+}
+
+.dot:nth-child(1) { animation-delay: 0s; }
+.dot:nth-child(2) { animation-delay: 0.15s; }
+.dot:nth-child(3) { animation-delay: 0.3s; }`,
+        useCases: [
+            'Loading states in chat interfaces',
+            'Processing indicators',
+            'Thinking states for AI responses',
+            'Generic loading indicators'
+        ]
+    },
+    'ripple': {
+        name: 'Ripple Effect',
+        description: 'Button click ripple effect expanding from click point.',
+        cssKeyframes: `@keyframes ripple {
+  0% {
+    transform: scale(0);
+    opacity: 0.6;
+  }
+  100% {
+    transform: scale(4);
+    opacity: 0;
+  }
+}`,
+        usage: `Create ripple element on click and position at click coordinates:
+const ripple = document.createElement('span');
+ripple.style.left = \`\${x}px\`;
+ripple.style.top = \`\${y}px\`;
+ripple.classList.add('ripple');`,
+        timing: {
+            duration: '600ms',
+            easing: 'ease-out'
+        },
+        example: `.button {
+  position: relative;
+  overflow: hidden;
+}
+
+.ripple {
+  position: absolute;
+  border-radius: 50%;
+  width: 20px;
+  height: 20px;
+  background: rgba(255, 255, 255, 0.6);
+  transform: translate(-50%, -50%);
+  pointer-events: none;
+  animation: ripple 600ms ease-out;
+}`,
+        useCases: [
+            'Button click feedback',
+            'Interactive element feedback',
+            'Touch feedback on mobile',
+            'Card click interactions'
+        ]
+    },
+    'fade-in': {
+        name: 'Fade In',
+        description: 'Smooth fade in animation for entering elements.',
+        cssKeyframes: `@keyframes fadeIn {
+  from { opacity: 0; }
+  to   { opacity: 1; }
+}`,
+        usage: `Apply to elements that need to fade in on mount or appearance.`,
+        timing: {
+            duration: '200ms (var(--duration-normal))',
+            easing: 'ease-out'
+        },
+        example: `.fadeIn {
+  animation: fadeIn 200ms ease-out;
+}
+
+@keyframes fadeInUp {
+  from { opacity: 0; transform: translateY(8px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+
+.fadeInUp {
+  animation: fadeInUp var(--duration-normal) ease-out;
+}`,
+        useCases: [
+            'Modal entrances',
+            'Toast notifications',
+            'Dropdown menus',
+            'Tooltip appearances',
+            'Content reveals'
+        ]
+    },
+    'fade-out': {
+        name: 'Fade Out',
+        description: 'Smooth fade out animation for exiting elements.',
+        cssKeyframes: `@keyframes fadeOut {
+  from { opacity: 1; }
+  to   { opacity: 0; }
+}`,
+        usage: `Apply to elements before removal from DOM.`,
+        timing: {
+            duration: '150ms (var(--duration-fast))',
+            easing: 'ease-in'
+        },
+        example: `.fadeOut {
+  animation: fadeOut 150ms ease-in;
+}
+
+@keyframes fadeOutDown {
+  from { opacity: 1; transform: translateY(0); }
+  to   { opacity: 0; transform: translateY(8px); }
+}
+
+.fadeOutDown {
+  animation: fadeOutDown var(--duration-fast) ease-in;
+}`,
+        useCases: [
+            'Modal exits',
+            'Toast dismissals',
+            'Dropdown closures',
+            'Element removal',
+            'Hiding content'
+        ]
+    },
+    'slide-up': {
+        name: 'Slide Up',
+        description: 'Slide up from bottom animation, perfect for modals and sheets.',
+        cssKeyframes: `@keyframes slideUp {
+  from { transform: translateY(100%); opacity: 0; }
+  to   { transform: translateY(0);    opacity: 1; }
+}`,
+        usage: `Apply to elements that slide up from bottom of screen.`,
+        timing: {
+            duration: '300ms (var(--duration-slow))',
+            easing: 'ease-out'
+        },
+        example: `.slideUp {
+  animation: slideUp 300ms ease-out;
+}
+
+.bottomSheet {
+  position: fixed;
+  bottom: 0; left: 0; right: 0;
+  transform: translateY(100%);
+  transition: transform 300ms ease-out;
+}
+
+.bottomSheet.open { transform: translateY(0); }`,
+        useCases: [
+            'Bottom sheets on mobile',
+            'Modal entrances from bottom',
+            'Mobile menu slides',
+            'Action sheets',
+            'Bottom notifications'
+        ]
+    },
+    'slide-down': {
+        name: 'Slide Down',
+        description: 'Slide down from top animation, perfect for dropdowns and alerts.',
+        cssKeyframes: `@keyframes slideDown {
+  from { transform: translateY(-100%); opacity: 0; }
+  to   { transform: translateY(0);     opacity: 1; }
+}`,
+        usage: `Apply to elements that slide down from top.`,
+        timing: {
+            duration: '200ms (var(--duration-normal))',
+            easing: 'ease-out'
+        },
+        example: `.slideDown {
+  animation: slideDown 200ms ease-out;
+}
+
+.dropdown {
+  transform-origin: top;
+  animation: slideDown var(--duration-normal) ease-out;
+}`,
+        useCases: [
+            'Dropdown menus',
+            'Top navigation slides',
+            'Alert banners from top',
+            'Header expansions',
+            'Accordion content reveals'
+        ]
+    },
+    'slide-left': {
+        name: 'Slide Left',
+        description: 'Slide in from right animation.',
+        cssKeyframes: `@keyframes slideLeft {
+  from { transform: translateX(100%); opacity: 0; }
+  to   { transform: translateX(0);    opacity: 1; }
+}`,
+        usage: `Apply to elements that slide in from the right.`,
+        timing: {
+            duration: '300ms (var(--duration-slow))',
+            easing: 'ease-out'
+        },
+        example: `.slideLeft {
+  animation: slideLeft 300ms ease-out;
+}
+
+.sidebar {
+  transform: translateX(100%);
+  transition: transform 300ms ease-out;
+}
+
+.sidebar.open { transform: translateX(0); }`,
+        useCases: [
+            'Side drawers from right',
+            'Mobile navigation panels',
+            'Detail panels',
+            'Notification panels',
+            'Settings panels'
+        ]
+    },
+    'slide-right': {
+        name: 'Slide Right',
+        description: 'Slide in from left animation.',
+        cssKeyframes: `@keyframes slideRight {
+  from { transform: translateX(-100%); opacity: 0; }
+  to   { transform: translateX(0);     opacity: 1; }
+}`,
+        usage: `Apply to elements that slide in from the left.`,
+        timing: {
+            duration: '300ms (var(--duration-slow))',
+            easing: 'ease-out'
+        },
+        example: `.slideRight {
+  animation: slideRight 300ms ease-out;
+}
+
+.sidebar {
+  transform: translateX(-100%);
+  transition: transform 300ms ease-out;
+}
+
+.sidebar.open { transform: translateX(0); }`,
+        useCases: [
+            'Side navigation from left',
+            'Filter panels',
+            'Menu drawers',
+            'Sidebar navigation',
+            'Secondary content panels'
+        ]
+    },
+    'pulse': {
+        name: 'Pulse',
+        description: 'Subtle pulsing animation for attention or status indicators.',
+        cssKeyframes: `@keyframes pulse {
+  0%, 100% { opacity: 1;   transform: scale(1);    }
+  50%      { opacity: 0.6; transform: scale(0.95); }
+}`,
+        usage: `Apply to elements that need subtle attention, like status badges or new message indicators.`,
+        timing: {
+            duration: '2s',
+            easing: 'ease-in-out'
+        },
+        example: `.pulse {
+  animation: pulse 2s ease-in-out infinite;
+}
+
+.notificationDot {
+  width: 8px; height: 8px;
+  border-radius: 50%;
+  background: var(--color-danger);
+  animation: pulse 2s ease-in-out infinite;
+}`,
+        useCases: [
+            'Online status indicators',
+            'Notification badges',
+            'Recording indicators',
+            'Active state indicators',
+            'New content indicators'
+        ]
+    },
+    'shimmer': {
+        name: 'Shimmer',
+        description: 'Shimmer loading effect, perfect for skeleton screens.',
+        cssKeyframes: `@keyframes shimmer {
+  0%   { background-position: -1000px 0; }
+  100% { background-position:  1000px 0; }
+}`,
+        usage: `Apply to skeleton loading placeholders with gradient background.`,
+        timing: {
+            duration: '2s',
+            easing: 'linear'
+        },
+        example: `.skeleton {
+  background: var(--color-surface-muted);
+  border-radius: var(--radius-md);
+  position: relative;
+  overflow: hidden;
+}
+
+.skeleton::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: linear-gradient(
+    90deg,
+    transparent,
+    rgba(255, 255, 255, 0.6),
+    transparent
+  );
+  animation: shimmer 2s linear infinite;
+}`,
+        useCases: [
+            'Skeleton screens',
+            'Loading placeholders',
+            'Image loading states',
+            'Content loading indicators',
+            'Card loading states'
+        ]
+    },
+    'bounce': {
+        name: 'Bounce',
+        description: 'Gentle bounce animation for playful interactions.',
+        cssKeyframes: `@keyframes bounce {
+  0%, 100% { transform: translateY(0);   }
+  25%      { transform: translateY(-8px); }
+  50%      { transform: translateY(0);   }
+  75%      { transform: translateY(-4px); }
+}`,
+        usage: `Apply to elements that need a playful bounce on interaction.`,
+        timing: {
+            duration: '600ms',
+            easing: 'ease-out'
+        },
+        example: `.bounce {
+  animation: bounce 600ms ease-out;
+}`,
+        useCases: [
+            'Success feedback',
+            'Button interactions',
+            'Icon animations',
+            'Playful microinteractions',
+            'Achievement notifications'
+        ]
+    },
+    'spin': {
+        name: 'Spin',
+        description: 'Continuous rotation animation for loading spinners.',
+        cssKeyframes: `@keyframes spin {
+  from { transform: rotate(0deg);   }
+  to   { transform: rotate(360deg); }
+}`,
+        usage: `Apply to circular loading indicators.`,
+        timing: {
+            duration: '1s',
+            easing: 'linear'
+        },
+        example: `.spinner {
+  width: 24px;
+  height: 24px;
+  border: 2px solid var(--color-surface-muted);
+  border-top-color: var(--color-primary);
+  border-radius: 50%;
+  animation: spin 1s linear infinite;
+}`,
+        useCases: [
+            'Loading spinners',
+            'Refresh icons',
+            'Processing indicators',
+            'Sync indicators',
+            'Generic loading states'
+        ]
+    }
+};
+export async function getAnimationExamples(params = {}) {
+    const { animationType = 'all' } = params;
+    let result = `# Design System Animation Examples\n\n`;
+    result += `Canonical animation patterns for smooth, natural motion. Example snippets reference semantic color tokens (\`--color-primary\`, \`--color-danger\`, etc.); with a specific theme preset applied, they resolve to the preset's palette.\n\n`;
+    result += `## Design Token Reference\n\n`;
+    result += `Use these CSS variables for consistent timing:\n\n`;
+    result += '```css\n';
+    result += `--duration-fast: 150ms      /* Quick interactions */\n`;
+    result += `--duration-normal: 200ms    /* Standard animations */\n`;
+    result += `--duration-slow: 300ms      /* Deliberate animations */\n`;
+    result += '```\n\n';
+    const animationsToShow = animationType === 'all'
+        ? Object.entries(animations)
+        : animationType && animations[animationType]
+            ? [[animationType, animations[animationType]]]
+            : [];
+    if (animationType !== 'all' && !animations[animationType]) {
+        return `Error: Animation type "${animationType}" not found.\n\nAvailable animations: ${Object.keys(animations).join(', ')}`;
+    }
+    for (const [, animation] of animationsToShow) {
+        result += `---\n\n`;
+        result += `## ${animation.name}\n\n`;
+        result += `${animation.description}\n\n`;
+        result += `### Keyframes\n\n`;
+        result += `\`\`\`css\n${animation.cssKeyframes}\n\`\`\`\n\n`;
+        result += `### Timing\n\n`;
+        result += `- **Duration**: ${animation.timing.duration}\n`;
+        result += `- **Easing**: ${animation.timing.easing}\n\n`;
+        result += `### Usage\n\n`;
+        result += `${animation.usage}\n\n`;
+        result += `### Complete Example\n\n`;
+        result += `\`\`\`css\n${animation.example}\n\`\`\`\n\n`;
+        result += `### Use Cases\n\n`;
+        animation.useCases.forEach((useCase) => {
+            result += `- ${useCase}\n`;
+        });
+        result += `\n`;
+    }
+    result += `---\n\n`;
+    result += `## Animation Best Practices\n\n`;
+    result += `1. **Use Design Tokens**: Always use \`var(--duration-*)\` for consistent timing\n`;
+    result += `2. **Performance**: Use \`transform\` and \`opacity\` for better performance (GPU-accelerated)\n`;
+    result += `3. **Accessibility**: Respect \`prefers-reduced-motion\` media query\n`;
+    result += `4. **Purposeful**: Every animation should serve a purpose (feedback, attention, state change)\n\n`;
+    result += `### Reduced Motion\n\n`;
+    result += `Always include reduced motion support:\n\n`;
+    result += '```css\n';
+    result += `@media (prefers-reduced-motion: reduce) {\n`;
+    result += `  *,\n`;
+    result += `  *::before,\n`;
+    result += `  *::after {\n`;
+    result += `    animation-duration: 0.01ms !important;\n`;
+    result += `    animation-iteration-count: 1 !important;\n`;
+    result += `    transition-duration: 0.01ms !important;\n`;
+    result += `  }\n`;
+    result += `}\n`;
+    result += '```\n\n';
+    if (animationType === 'all') {
+        result += `---\n\n`;
+        result += `**Tip**: Call this tool with a specific \`animationType\` to see details for just one animation.\n`;
+    }
+    return result;
+}
+//# sourceMappingURL=get-animation-examples.js.map

package/build/tools/get-animation-examples.js.map

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

package/build/tools/get-component-capabilities.d.ts

@@ -0,0 +1,43 @@
+/**
+ * get_component_capabilities Tool — meta-backed (v3.0.0; RN axes stripped in v4.0.0).
+ *
+ * Exposes DS capability axes for AI consumers so they can filter or
+ * validate before generating code:
+ *
+ *   - rscSafe        — no `'use client'` directive; safe in RSC trees
+ *   - clientOnly     — inverse of rscSafe
+ *   - polymorphic    — accepts `as` / `asChild` prop
+ *   - withRef        — wraps with React.forwardRef
+ *   - deprecated     — deprecation marker with replacement hint
+ *
+ * Query modes:
+ *   1. Full matrix — no args
+ *   2. Single component — `{ component: 'Button' }`
+ *   3. Filtered — `{ rscSafe, polymorphic, withRef, deprecated }`
+ */
+import { z } from 'zod';
+export declare const getComponentCapabilitiesSchema: z.ZodObject<{
+    component: z.ZodOptional<z.ZodString>;
+    rscSafe: z.ZodOptional<z.ZodBoolean>;
+    clientOnly: z.ZodOptional<z.ZodBoolean>;
+    polymorphic: z.ZodOptional<z.ZodBoolean>;
+    withRef: z.ZodOptional<z.ZodBoolean>;
+    deprecated: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    deprecated?: boolean | undefined;
+    polymorphic?: boolean | undefined;
+    component?: string | undefined;
+    rscSafe?: boolean | undefined;
+    clientOnly?: boolean | undefined;
+    withRef?: boolean | undefined;
+}, {
+    deprecated?: boolean | undefined;
+    polymorphic?: boolean | undefined;
+    component?: string | undefined;
+    rscSafe?: boolean | undefined;
+    clientOnly?: boolean | undefined;
+    withRef?: boolean | undefined;
+}>;
+export type GetComponentCapabilitiesParams = z.infer<typeof getComponentCapabilitiesSchema>;
+export declare function getComponentCapabilities(params: GetComponentCapabilitiesParams): Promise<string>;
+//# sourceMappingURL=get-component-capabilities.d.ts.map

package/build/tools/get-component-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-capabilities.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;EAOzC,CAAA;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAiB3F,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,MAAM,CAAC,CAgEjB"}

package/build/tools/get-component-capabilities.js

@@ -0,0 +1,108 @@
+/**
+ * get_component_capabilities Tool — meta-backed (v3.0.0; RN axes stripped in v4.0.0).
+ *
+ * Exposes DS capability axes for AI consumers so they can filter or
+ * validate before generating code:
+ *
+ *   - rscSafe        — no `'use client'` directive; safe in RSC trees
+ *   - clientOnly     — inverse of rscSafe
+ *   - polymorphic    — accepts `as` / `asChild` prop
+ *   - withRef        — wraps with React.forwardRef
+ *   - deprecated     — deprecation marker with replacement hint
+ *
+ * Query modes:
+ *   1. Full matrix — no args
+ *   2. Single component — `{ component: 'Button' }`
+ *   3. Filtered — `{ rscSafe, polymorphic, withRef, deprecated }`
+ */
+import { z } from 'zod';
+import { getLightMeta, getComponent, } from '../utils/meta-loader.js';
+export const getComponentCapabilitiesSchema = z.object({
+    component: z.string().max(200).optional().describe('Optional: PascalCase component name (e.g. "Button", "DatePicker") to query a single entry.'),
+    rscSafe: z.boolean().optional().describe('Filter to server-safe components (no "use client" directive).'),
+    clientOnly: z.boolean().optional().describe('Filter to client-only components (have "use client" directive).'),
+    polymorphic: z.boolean().optional().describe('Filter to components that accept `as` / `asChild` prop.'),
+    withRef: z.boolean().optional().describe('Filter to components that expose a forwarded ref.'),
+    deprecated: z.boolean().optional().describe('If true, include ONLY deprecated components. If false, exclude them.'),
+});
+function formatEntry(name, cmp) {
+    let out = `### ${name}\n\n`;
+    out += `- **kind**: \`${cmp.kind}\`\n`;
+    out += `- **category**: ${cmp.category}\n`;
+    out += `- **rsc-safe**: ${cmp.serverSafe ? 'yes' : 'no'}\n`;
+    out += `- **client-only**: ${cmp.useClient ? 'yes' : 'no'}\n`;
+    out += `- **polymorphic**: ${cmp.polymorphic ? 'yes' : 'no'}\n`;
+    out += `- **ref**: ${cmp.ref ? `forwards to \`${cmp.ref}\`` : 'none'}\n`;
+    out += `- **subpath**: \`${cmp.subpath}\`\n`;
+    if (cmp.deprecated) {
+        out += `- **deprecated**: since v${cmp.deprecated.since}; use \`${cmp.deprecated.replacedBy}\`; removal at v${cmp.deprecated.removeAt}\n`;
+    }
+    return out;
+}
+export async function getComponentCapabilities(params) {
+    const meta = getLightMeta();
+    // ---- Single-component mode ---------------------------------------------
+    if (params.component) {
+        const cmp = getComponent(params.component);
+        if (!cmp) {
+            const known = Object.keys(meta.components).sort().slice(0, 20).join(', ');
+            return `Error: \`${params.component}\` is not registered in DS meta.\n\nSample known components: ${known}, …`;
+        }
+        return `# Capability: ${params.component}\n\n${formatEntry(params.component, cmp)}`;
+    }
+    // ---- Matrix / filtered mode --------------------------------------------
+    const { rscSafe, clientOnly, polymorphic, withRef, deprecated } = params;
+    const withRefSet = new Set(meta.capabilities.withRef);
+    const entries = Object.entries(meta.components).filter(([name, cmp]) => {
+        if (rscSafe !== undefined && cmp.serverSafe !== rscSafe)
+            return false;
+        if (clientOnly !== undefined && cmp.useClient !== clientOnly)
+            return false;
+        if (polymorphic !== undefined && cmp.polymorphic !== polymorphic)
+            return false;
+        if (withRef !== undefined) {
+            if (withRefSet.has(name) !== withRef)
+                return false;
+        }
+        if (deprecated === true && cmp.deprecated === null)
+            return false;
+        if (deprecated === false && cmp.deprecated !== null)
+            return false;
+        return true;
+    });
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    const filters = [];
+    if (rscSafe !== undefined)
+        filters.push(`rscSafe=${rscSafe}`);
+    if (clientOnly !== undefined)
+        filters.push(`clientOnly=${clientOnly}`);
+    if (polymorphic !== undefined)
+        filters.push(`polymorphic=${polymorphic}`);
+    if (withRef !== undefined)
+        filters.push(`withRef=${withRef}`);
+    if (deprecated !== undefined)
+        filters.push(`deprecated=${deprecated}`);
+    let out = '# Component Capabilities\n\n';
+    out += `Showing ${entries.length} of ${Object.keys(meta.components).length} components`;
+    if (filters.length > 0)
+        out += ` (filtered: ${filters.join(', ')})`;
+    out += `\nDS: ${meta.package.name}@${meta.package.version}\n\n`;
+    // Summary counts for the unfiltered matrix
+    if (filters.length === 0) {
+        out += '## Summary\n\n';
+        out += `- rsc-safe: ${meta.capabilities.rscSafe.length}\n`;
+        out += `- client-only: ${meta.capabilities.clientOnly.length}\n`;
+        out += `- polymorphic: ${meta.capabilities.polymorphic.length}\n`;
+        out += `- with-ref: ${meta.capabilities.withRef.length}\n\n`;
+    }
+    if (entries.length === 0) {
+        out += '_No components match these filters._\n';
+        return out;
+    }
+    for (const [name, cmp] of entries) {
+        out += formatEntry(name, cmp);
+        out += '\n';
+    }
+    return out;
+}
+//# sourceMappingURL=get-component-capabilities.js.map

package/build/tools/get-component-capabilities.js.map

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

package/build/tools/get-component-props.d.ts

@@ -0,0 +1,23 @@
+/**
+ * get_component_props Tool — meta-backed (v3.0.0).
+ *
+ * Returns a TypeScript interface for the requested component's props,
+ * derived from `meta.components[X].props`. Names in meta are PascalCase
+ * (Button, DatePicker) — this tool accepts them as-is.
+ *
+ * Post-#40: props already come from meta in structured form (type,
+ * required, default, description). This tool renders that as a TS
+ * interface for AI consumers who want a familiar shape. A future
+ * `format: 'jsonSchema'` param can expose the raw structured form.
+ */
+import { z } from 'zod';
+export declare const getComponentPropsSchema: z.ZodObject<{
+    componentName: z.ZodEnum<[string, ...string[]]>;
+}, "strip", z.ZodTypeAny, {
+    componentName: string;
+}, {
+    componentName: string;
+}>;
+export type GetComponentPropsParams = z.infer<typeof getComponentPropsSchema>;
+export declare function getComponentProps(params: GetComponentPropsParams): Promise<string>;
+//# sourceMappingURL=get-component-props.d.ts.map