@corva/ui 3.54.0-20 → 3.54.0-21

package/mcp-server/server.mjs

@@ -227,7 +227,7 @@ const validateDsn = (dsn) => {
 
 const MCP_SERVER_VERSION = '1.1.0';
 
-var version = "3.54.0-20";
+var version = "3.54.0-21";
 
 const CORVA_UI_VERSION = version;
 
@@ -94326,7 +94326,9 @@ const findSimilarComponents = (name, allComponents) => {
 const componentDocsToolName = 'get_component_docs';
 const componentDocsToolTitle = 'Get Component Docs';
 const componentDocsToolDescription = `Get detailed documentation for a specific @corva/ui component.
-Returns props, examples, description, and links.`;
+Returns props, examples, description, and links.
+
+Usage: get_component_docs({ name: "Button" })`;
 const componentDocsToolSchema = {
     name: z.string().describe("Component name (e.g., 'Button', 'Tooltip', 'DatePicker')"),
     category: z
@@ -94384,7 +94386,9 @@ const handleGetComponentDocs = (args) => {
 
 **Category:** ${component.category}
 **Import:** \`import { ${component.name} } from '${component.importPath}';\`
-${component.isExperimental ? '**Experimental** - Recently added component, fully functional and safe to use.\n' : ''}${component.isDeprecated ? '❌ **Deprecated**\n' : ''}
+${component.isExperimental
+        ? '**Experimental** - Recently added component, fully functional and safe to use.\n'
+        : ''}${component.isDeprecated ? '❌ **Deprecated**\n' : ''}
 
 ${component.description}
 
@@ -94404,7 +94408,9 @@ ${examplesSection}
 const hookDocsToolName = 'get_hook_docs';
 const hookDocsToolTitle = 'Get Hook Docs';
 const hookDocsToolDescription = `Get documentation for a @corva/ui hook.
-Returns parameters, return type, and usage examples.`;
+Returns parameters, return type, and usage examples.
+
+Usage: get_hook_docs({ name: "useSubscriptions" })`;
 const hookDocsToolSchema = {
     name: z.string().describe("Hook name (e.g., 'useSubscriptions', 'useOutsideClick')"),
 };
@@ -94440,7 +94446,9 @@ Returns color palette (dark/light), CSS variables, SCSS variables,
 SCSS functions/mixins, spacing, typography, transitions, z-index tokens, and usage examples.
 
 Available sections: palette, css-variables, scss-variables, scss-functions,
-scss-mixins, spacing, typography, transition, z-index, usage, all.`;
+scss-mixins, spacing, typography, transition, z-index, usage, all.
+
+Usage: get_theme_docs({ section: "palette" })`;
 const SECTIONS = [
     'palette',
     'css-variables',
@@ -94479,54 +94487,41 @@ const buildPaletteSection = (includeLight = false) => {
     }
     return text;
 };
-const buildCssVariablesSection = () => h2('CSS Variables') +
-    'All CSS custom properties available via theme data attributes ' +
-    '(`[data-corva-theme-dark]` / `[data-corva-theme-light]`).\n\n' +
-    formatCssVariables(theme.cssVariables);
-const buildScssVariablesSection = () => h2('SCSS Variables') +
-    'SCSS variables that map to CSS custom properties. ' +
-    "Import via `@import '@corva/ui/styles/common'`.\n\n" +
-    formatScssVariables(theme.scssVariables);
-const buildScssFunctionsSection = () => h2('SCSS Functions') +
-    'Available after importing `@corva/ui/styles/common`.\n\n' +
-    formatScssFunctions(theme.scssFunctions);
-const buildScssMixinsSection = () => h2('SCSS Mixins') +
-    'Available after importing `@corva/ui/styles/common`.\n\n' +
-    formatScssMixins(theme.scssMixins);
+const buildCssVariablesSection = () => `${h2('CSS Variables')}All CSS custom properties available via theme data attributes ` +
+    `(\`[data-corva-theme-dark]\` / \`[data-corva-theme-light]\`).\n\n${formatCssVariables(theme.cssVariables)}`;
+const buildScssVariablesSection = () => `${h2('SCSS Variables')}SCSS variables that map to CSS custom properties. ` +
+    `Import via \`@import '@corva/ui/styles/common'\`.\n\n${formatScssVariables(theme.scssVariables)}`;
+const buildScssFunctionsSection = () => `${h2('SCSS Functions')}Available after importing \`@corva/ui/styles/common\`.\n\n${formatScssFunctions(theme.scssFunctions)}`;
+const buildScssMixinsSection = () => `${h2('SCSS Mixins')}Available after importing \`@corva/ui/styles/common\`.\n\n${formatScssMixins(theme.scssMixins)}`;
 const buildSpacingSection = () => h2('Spacing') + formatSpacing(theme.spacing);
 const buildTypographySection = () => h2('Typography') + formatTypography(theme.typography);
 const buildZIndexSection = () => h2('Z-Index') + formatZIndex(theme.zIndex);
 const buildTransitionSection = () => h2('Transitions') + formatTransition(theme.transition);
 const buildUsageSection = () => {
     const sections = [
-        h2('Usage Guide') + '### 1. JSS (Material-UI makeStyles)\n' +
-            codeBlock("import { theme } from '@corva/ui/config';\n\n" +
-                "const primaryColor = theme.palette.primary.main; // '#03BCD4'\n" +
-                'const bgColor = theme.palette.background.b4;', 'tsx'),
-        '### 2. CSS Variables\n' +
-            codeBlock('.my-element {\n' +
-                '  color: var(--palette-primary-main);\n' +
-                '  background: var(--palette-background-b-4);\n' +
-                '}', 'css'),
-        '### 3. SCSS Variables\n' +
-            codeBlock("@import '@corva/ui/styles/common';\n\n" +
-                '.my-element {\n' +
-                '  color: $palette_primary_main;\n' +
-                '  background: $palette_b4;\n' +
-                '}', 'scss'),
-        '### 4. SCSS Functions\n' +
-            codeBlock('// Alpha transparency\n' +
-                'background: colorAlpha($palette_primary_main, 0.5);\n\n' +
-                '// Spacing (base unit: 8px)\n' +
-                'padding: spacing(2);       // 16px\n' +
-                'margin: spacing(1, 2);     // 8px 16px\n\n' +
-                '// Transitions\n' +
-                'transition: transition(opacity, transform);', 'scss'),
-        '### 5. SCSS Mixins\n' +
-            codeBlock('.scrollable-container {\n' +
-                '  --corvaui-background: var(--palette-background-b-4);\n' +
-                '  @include verticalFadePseudoElements(2);\n' +
-                '}', 'scss'),
+        `${h2('Usage Guide')}### 1. JSS (Material-UI makeStyles)\n${codeBlock("import { theme } from '@corva/ui/config';\n\n" +
+            "const primaryColor = theme.palette.primary.main; // '#03BCD4'\n" +
+            'const bgColor = theme.palette.background.b4;', 'tsx')}`,
+        `### 2. CSS Variables\n${codeBlock('.my-element {\n' +
+            '  color: var(--palette-primary-main);\n' +
+            '  background: var(--palette-background-b-4);\n' +
+            '}', 'css')}`,
+        `### 3. SCSS Variables\n${codeBlock("@import '@corva/ui/styles/common';\n\n" +
+            '.my-element {\n' +
+            '  color: $palette_primary_main;\n' +
+            '  background: $palette_b4;\n' +
+            '}', 'scss')}`,
+        `### 4. SCSS Functions\n${codeBlock('// Alpha transparency\n' +
+            'background: colorAlpha($palette_primary_main, 0.5);\n\n' +
+            '// Spacing (base unit: 8px)\n' +
+            'padding: spacing(2);       // 16px\n' +
+            'margin: spacing(1, 2);     // 8px 16px\n\n' +
+            '// Transitions\n' +
+            'transition: transition(opacity, transform);', 'scss')}`,
+        `### 5. SCSS Mixins\n${codeBlock('.scrollable-container {\n' +
+            '  --corvaui-background: var(--palette-background-b-4);\n' +
+            '  @include verticalFadePseudoElements(2);\n' +
+            '}', 'scss')}`,
     ];
     return sections.join('\n\n');
 };
@@ -94542,9 +94537,7 @@ const buildAllSection = () => {
     const availableSections = SECTIONS.filter(s => s !== 'all' && s !== 'variables')
         .map(s => `\`${s}\``)
         .join(', ');
-    const tokenSummary = h2('Token Summary') +
-        counts.map(c => `- ${c}`).join('\n') +
-        `\n\nUse \`get_theme_docs\` with a specific section for full details: ${availableSections}`;
+    const tokenSummary = `${h2('Token Summary') + counts.map(c => `- ${c}`).join('\n')}\n\nUse \`get_theme_docs\` with a specific section for full details: ${availableSections}`;
     return join(h1('@corva/ui Theme'), buildPaletteSection(false), tokenSummary, buildSpacingSection(), buildTypographySection(), buildTransitionSection(), buildZIndexSection(), buildUsageSection());
 };
 const handleGetThemeDocs = (args) => {
@@ -94594,7 +94587,9 @@ const handleGetThemeDocs = (args) => {
 const listToolName = 'list_corva_ui';
 const listToolTitle = 'List @corva/ui';
 const listToolDescription = `List all available items in @corva/ui by category.
-Useful to see what's available before searching.`;
+Useful to see what's available before searching.
+
+Usage: list_corva_ui({ type: "components-v2" })`;
 const listToolSchema = {
     type: z
         .enum([
@@ -94720,15 +94715,15 @@ const handleList = (args) => {
 const constantsDocsToolName = 'get_constants_docs';
 const constantsDocsToolTitle = 'Get Constants Docs';
 const constantsDocsToolDescription = `Get documentation for @corva/ui constants.
-Returns constant values, namespaces, and usage info.`;
+Returns constant values, namespaces, and usage info.
+
+Usage: get_constants_docs({ name: "ASSET_TYPES" })`;
 const constantsDocsToolSchema = {
-    namespace: z
-        .string()
-        .describe("Namespace (e.g., 'drillstring', 'alerts') or constant name (e.g., 'ASSET_TYPES')"),
+    name: z.string().describe("Namespace or constant name (e.g., 'drillstring', 'ASSET_TYPES')"),
 };
 const handleGetConstantsDocs = (args) => {
-    const { namespace } = args;
-    const namespaceLower = namespace.toLowerCase();
+    const { name } = args;
+    const namespaceLower = name.toLowerCase();
     // Find matching constants by namespace or name
     const matches = constants.filter(c => c.namespace?.toLowerCase() === namespaceLower ||
         c.name.toLowerCase() === namespaceLower ||
@@ -94747,7 +94742,7 @@ const handleGetConstantsDocs = (args) => {
                 'Metrics config may live in utility modules. Try search_corva_ui with type "util" and query "metrics".';
         }
         return {
-            response: createToolResponse(`No constants found for "${namespace}". ${suggestion}`),
+            response: createToolResponse(`No constants found for "${name}". ${suggestion}`),
             found: false,
             matchCount: 0,
         };
@@ -94780,8 +94775,8 @@ ${c.value !== '[namespace]' ? `**Value:** \`${JSON.stringify(c.value, null, 2)}\
         .map(c => `- **${c.name}**: ${c.description}\n  Import: \`${c.importPath}\``)
         .join('\n\n');
     const title = exactNamespaceMatches.length > 0
-        ? `Constants in "${namespace}" namespace`
-        : `Constants matching "${namespace}"`;
+        ? `Constants in "${name}" namespace`
+        : `Constants matching "${name}"`;
     return {
         response: createToolResponse(`# ${title}\n\n${displayMatches.length} constant(s) found:\n\n${formatted}`),
         found: true,
@@ -94792,7 +94787,9 @@ ${c.value !== '[namespace]' ? `**Value:** \`${JSON.stringify(c.value, null, 2)}\
 const clientDocsToolName = 'get_client_docs';
 const clientDocsToolTitle = 'Get Client Docs';
 const clientDocsToolDescription = `Get documentation for @corva/ui API clients.
-Returns methods, parameters, and API endpoints from Swagger documentation.`;
+Returns methods, parameters, and API endpoints from Swagger documentation.
+
+Usage: get_client_docs({ name: "corvaAPI" })`;
 const clientDocsToolSchema = {
     name: z.string().describe("Client name (e.g., 'corvaAPI', 'socketClient', 'corvaDataAPI')"),
     tag: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corva/ui",
-  "version": "3.54.0-20",
+  "version": "3.54.0-21",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Shared components/utils for Corva ui projects",
   "keywords": [