@spaced-out/ui-design-system 0.5.34 → 0.5.36

package/.github/workflows/publish-mcp.yml

@@ -3,23 +3,20 @@
 
 name: Publish MCP Server to NPM
 
-# WORKFLOW DISABLED - Triggers commented out to prevent automatic runs
-# Uncomment below to re-enable the workflow triggers
 on:
   # Run after the main NPM publish workflow completes successfully
-  # workflow_run:
-  #   workflows: ['Release Genesis to NPM']
-  #   types:
-  #     - completed
-  #   branches: [master]
-  workflow_dispatch: # Manual trigger only (but workflow will exit early due to condition below)
+  workflow_run:
+    workflows: ['Release Genesis to NPM']
+    types:
+      - completed
+    branches: [master]
+  workflow_dispatch:
 
 jobs:
   publish-mcp:
     runs-on: ubuntu-latest
-    # WORKFLOW DISABLED - Set to false to prevent execution
     # Only run if triggered manually or if the workflow_run succeeded
-    if: false && ${{ github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success' }}
+    if: ${{ github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success' }}
     steps:
       - name: Check Permissions
         id: check-permissions
@@ -54,6 +51,10 @@ jobs:
         working-directory: ./mcp
         run: yarn install
 
+      - name: Build type definitions
+        run: yarn build:types
+        # Only generates .d.ts files in lib/ - much faster than full build
+
       - name: Auto-bump patch version
         if: github.event_name == 'workflow_run'
         working-directory: ./mcp

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.5.36](https://github.com/spaced-out/ui-design-system/compare/v0.5.35...v0.5.36) (2025-12-15)
+
+
+### Bug Fixes
+
+* casing for tertiary-gradient button type ([#451](https://github.com/spaced-out/ui-design-system/issues/451)) ([67a3bbe](https://github.com/spaced-out/ui-design-system/commit/67a3bbe0bcaa7e3e25afbae30f84f6302dedb94e))
+
+### [0.5.35](https://github.com/spaced-out/ui-design-system/compare/v0.5.34...v0.5.35) (2025-12-15)
+
+
+### Features
+
+* introducing tertiary gradient type button ([#449](https://github.com/spaced-out/ui-design-system/issues/449)) ([9c8d740](https://github.com/spaced-out/ui-design-system/commit/9c8d740c2c932f74935699013ea45d0d2a2fed29))
+
+
+### Bug Fixes
+
+* **mcp:** expose .d.ts type definitions instead of source code ([#450](https://github.com/spaced-out/ui-design-system/issues/450)) ([4583947](https://github.com/spaced-out/ui-design-system/commit/45839475dec006acf9e99ca07b6c32cd7260f069))
+* static label support for simple button dropdown ([#401](https://github.com/spaced-out/ui-design-system/issues/401)) ([f37c03f](https://github.com/spaced-out/ui-design-system/commit/f37c03f80af9f1a4b4cf04b7ff998b9c3a433639))
+
 ### [0.5.34](https://github.com/spaced-out/ui-design-system/compare/v0.5.34-beta.2...v0.5.34) (2025-12-12)
 
 

package/lib/components/Button/Button.d.ts

@@ -22,6 +22,7 @@ export declare const BUTTON_TYPES: Readonly<{
     ghost: "ghost";
     danger: "danger";
     gradient: "gradient";
+    tertiaryGradient: "tertiaryGradient";
 }>;
 export declare const BUTTON_ACTION_TYPE: Readonly<{
     button: "button";

package/lib/components/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,4BAA4B,CAAC;AAMrD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAOlD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;EAOvB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAC;AAEH,eAAO,MAAM,WAAW;;;EAGtB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,WAAW,CAAC;AAElD,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC3C,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,MAAM,CACT;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,eAAe,EACb,YAAY,GACZ,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,MAAM,GACN,SAAS,GACT,MAAM,CACT;IACD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAoBD,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,iBAAiB,CACjD,mBAAmB,EACnB,iBAAiB,CAoClB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAqKvE,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,4BAA4B,CAAC;AAMrD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAOlD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;EAQvB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAC;AAEH,eAAO,MAAM,WAAW;;;EAGtB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,WAAW,CAAC;AAElD,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAC3C,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,MAAM,CACT;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,eAAe,EACb,YAAY,GACZ,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,MAAM,GACN,SAAS,GACT,MAAM,CACT;IACD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAsBD,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,iBAAiB,CACjD,mBAAmB,EACnB,iBAAiB,CAoClB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAsKvE,CAAC"}

package/lib/components/Button/Button.js

@@ -29,7 +29,8 @@ const BUTTON_TYPES = exports.BUTTON_TYPES = Object.freeze({
   tertiary: 'tertiary',
   ghost: 'ghost',
   danger: 'danger',
-  gradient: 'gradient'
+  gradient: 'gradient',
+  tertiaryGradient: 'tertiaryGradient'
 });
 const BUTTON_ACTION_TYPE = exports.BUTTON_ACTION_TYPE = Object.freeze({
   button: 'button',
@@ -46,7 +47,8 @@ const ButtonTypeToIconColorMap = {
   tertiary: 'primary',
   ghost: 'primary',
   danger: 'inversePrimary',
-  gradient: 'inversePrimary'
+  gradient: 'inversePrimary',
+  tertiaryGradient: 'clickable'
 };
 const ButtonTypeToLoaderColorMap = {
   primary: 'colorTextInversePrimary',
@@ -54,7 +56,8 @@ const ButtonTypeToLoaderColorMap = {
   tertiary: 'colorTextPrimary',
   ghost: 'colorTextPrimary',
   danger: 'colorTextInversePrimary',
-  gradient: 'colorTextInversePrimary'
+  gradient: 'colorTextInversePrimary',
+  tertiaryGradient: 'colorTextClickable'
 };
 const UnstyledButton = exports.UnstyledButton = /*#__PURE__*/React.forwardRef((_ref, ref) => {
   let {
@@ -123,6 +126,7 @@ const Button = exports.Button = /*#__PURE__*/React.forwardRef((_ref2, ref) => {
       [_ButtonModule.default.ghost]: type === 'ghost',
       [_ButtonModule.default.danger]: type === 'danger',
       [_ButtonModule.default.gradient]: type === 'gradient',
+      [_ButtonModule.default.tertiaryGradient]: type === 'tertiaryGradient',
       [_ButtonModule.default.disabled]: disabled,
       [_ButtonModule.default.small]: size === 'small',
       [_ButtonModule.default.medium]: size === 'medium',

package/lib/components/Button/Button.module.css

@@ -21,6 +21,8 @@
 
   colorFocusPrimary,
   colorFocusDanger,
+  colorFocusSecondary,
+  colorFocusInformation,
 
   colorFillDisabled,
 
@@ -32,6 +34,8 @@
   colorBorderSecondary,
 
   colorFillPrimary,
+  colorFillSecondary,
+  colorInformationLightest,
   colorInformation
 
 ) from '../../styles/variables/_color.css';
@@ -154,7 +158,7 @@ button {
   background-color: colorButtonFillPrimaryPressed;
 }
 
-/* Currently Gradient Buttons don't support hover / active states */
+/* Currently Buttons with type `gradient` don't support hover / active states */
 .gradient {
   color: colorTextInversePrimary;
   background-image: linear-gradient(
@@ -164,6 +168,29 @@ button {
   );
 }
 
+.tertiaryGradient {
+  color: colorTextClickable;
+  border: borderWidthPrimary solid transparent;
+  background: linear-gradient(
+        to right,
+        colorFillSecondary,
+        colorInformationLightest
+      )
+      padding-box,
+    linear-gradient(to right, colorFocusSecondary, colorInformation) border-box;
+}
+
+.tertiaryGradient:hover,
+.tertiaryGradient:active {
+  background: linear-gradient(
+        to right,
+        colorButtonFillSecondaryHovered,
+        colorFocusInformation
+      )
+      padding-box,
+    linear-gradient(to right, colorFocusSecondary, colorInformation) border-box;
+}
+
 .secondary {
   color: colorTextClickable;
   background-color: colorButtonFillSecondaryEnabled;

package/lib/components/ButtonDropdown/SimpleButtonDropdown.d.ts

@@ -14,7 +14,7 @@ type ClassNames = Readonly<{
 export interface SimpleButtonDropdownRef {
     selectedKeys?: Array<string>;
 }
-export interface SimpleButtonDropdownProps extends Omit<ButtonProps, 'elevation' | 'classNames' | 'anchorPosition' | 'tooltip' | 'options' | 'optionsVariant' | 'allowSearch' | 'selectedKeys' | 'menuVirtualization' | 'header' | 'footer' | 'menuClassNames' | 'showLabelTooltip' | 'allowWrap' | 'onOptionSelect' | 'onMenuOpen' | 'onMenuClose' | 'resolveLabel' | 'resolveSecondaryLabel' | 'clickAwayRef'> {
+export interface SimpleButtonDropdownProps extends Omit<ButtonProps, 'elevation' | 'classNames' | 'anchorPosition' | 'tooltip' | 'options' | 'optionsVariant' | 'allowSearch' | 'selectedKeys' | 'menuVirtualization' | 'header' | 'footer' | 'menuClassNames' | 'showLabelTooltip' | 'allowWrap' | 'onOptionSelect' | 'onMenuOpen' | 'onMenuClose' | 'staticLabels' | 'resolveLabel' | 'resolveSecondaryLabel' | 'clickAwayRef'> {
     elevation?: ElevationType;
     classNames?: ClassNames;
     anchorPosition?: AnchorType;
@@ -32,6 +32,11 @@ export interface SimpleButtonDropdownProps extends Omit<ButtonProps, 'elevation'
     onOptionSelect?: (option: MenuOption, arg2?: React.SyntheticEvent<HTMLElement> | null | undefined) => unknown;
     onMenuOpen?: () => unknown;
     onMenuClose?: () => unknown;
+    staticLabels?: {
+        RESULT?: string;
+        RESULTS?: string;
+        SEARCH_PLACEHOLDER?: string;
+    };
     resolveLabel?: (option: MenuOption) => string | React.ReactNode;
     resolveSecondaryLabel?: (option: MenuOption) => string | React.ReactNode;
     clickAwayRef?: React.RefObject<ClickAwayRefType | null>;

package/lib/components/ButtonDropdown/SimpleButtonDropdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleButtonDropdown.d.ts","sourceRoot":"","sources":["../../../src/components/ButtonDropdown/SimpleButtonDropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAM3D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,8CAA8C,CAAC;AAE7E,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAG5E,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,yBACf,SAAQ,IAAI,CACV,WAAW,EACT,WAAW,GACX,YAAY,GACZ,gBAAgB,GAChB,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,QAAQ,GACR,QAAQ,GACR,gBAAgB,GAChB,kBAAkB,GAClB,WAAW,GACX,gBAAgB,GAChB,YAAY,GACZ,aAAa,GACb,cAAc,GACd,uBAAuB,GACvB,cAAc,CACjB;IACD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5B,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KACxD,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IAChE,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;IACzE,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgHD,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,iBAAiB,CACvD,yBAAyB,EACzB,uBAAuB,CAGxB,CAAC"}
+{"version":3,"file":"SimpleButtonDropdown.d.ts","sourceRoot":"","sources":["../../../src/components/ButtonDropdown/SimpleButtonDropdown.tsx"],"names":[],"mappings":"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"}

package/lib/components/ButtonDropdown/SimpleButtonDropdown.js

@@ -33,6 +33,7 @@ const SimpleButtonDropdownBase = (props, ref) => {
     allowWrap = false,
     clickAwayRef,
     elevation = 'modal',
+    staticLabels,
     testId,
     ...buttonProps
   } = props;
@@ -87,7 +88,8 @@ const SimpleButtonDropdownBase = (props, ref) => {
       footer,
       classNames: menuClassNames,
       showLabelTooltip,
-      allowWrap
+      allowWrap,
+      staticLabels
     },
     children: optionsVariant === 'checkbox' ? btnText : children
   });

package/mcp/README.md

@@ -1,526 +1,60 @@
-# Genesis UI Design System MCP Server
+# Genesis MCP Server
 
-A Model Context Protocol (MCP) server that provides AI assistants (Claude, Cursor, etc.) with access to the Genesis UI Design System.
+MCP server for AI assistants to access the Genesis UI Design System.
 
-## ✨ Features
+## Quick Setup
 
-- 📦 **Component Discovery**: List and search all available components
-- 🎨 **Design Tokens**: Access colors, spacing, typography, shadows, and more
-- 📚 **Documentation**: Browse component stories and TypeScript definitions
-- 🔍 **Dependency Analysis**: Understand component dependencies
-- 🚀 **Onboarding Templates**: Get starter templates for new components
-- 🪝 **Hooks Information**: Query available React hooks
+### Cursor / Claude Desktop
 
-## 🎯 No Local Dependencies Required!
-
-Unlike traditional MCP servers that require a local copy of the design system, this server **bundles all data at build time**. Users only need to run `npx` - no cloning, no environment variables!
-
-## 📦 Installation for Users
-
-### With Cursor
-
-⚠️ **macOS Users**: Cursor may not find `npx` in its PATH. Use the full path instead.
-
-1. Find your `npx` path in terminal:
-
-```bash
-which npx
-```
-
-2. Add to your Cursor MCP settings with the **full path**:
-
-```json
-{
-  "mcpServers": {
-    "genesis-design-system": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
-    }
-  }
-}
-```
-
-**Common npx locations:**
-
-- Apple Silicon Mac (Homebrew): `/opt/homebrew/bin/npx`
-- Intel Mac (Homebrew): `/usr/local/bin/npx`
-- nvm users: `/Users/YOUR_USERNAME/.nvm/versions/node/vX.X.X/bin/npx`
-
-**Windows/Linux users** can typically use `"command": "npx"` directly.
-
-### With Claude Desktop
-
-⚠️ **macOS Users**: Claude Desktop may not find `npx` in its PATH. Use the full path instead.
-
-Add to your Claude config file:
-
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
-**Linux**: `~/.config/Claude/claude_desktop_config.json`
-
-1. Find your `npx` path in terminal:
+1. Find your `npx` path:
 
 ```bash
 which npx
 ```
 
-2. Use the **full path** in your config:
+2. Add to MCP settings:
 
 ```json
 {
   "mcpServers": {
     "genesis-design-system": {
       "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
+      "args": ["-y", "@spaced-out/genesis-mcp@latest"]
     }
   }
 }
 ```
 
-**Common npx locations:**
-
-- Apple Silicon Mac (Homebrew): `/opt/homebrew/bin/npx`
-- Intel Mac (Homebrew): `/usr/local/bin/npx`
-- nvm users: `/Users/YOUR_USERNAME/.nvm/versions/node/vX.X.X/bin/npx`
-
-**Windows/Linux users** can typically use `"command": "npx"` directly.
+> Replace `/opt/homebrew/bin/npx` with your actual path from step 1.
 
-Then restart Cursor or Claude Desktop.
+3. Restart the app.
 
-## 🔧 Development
+## Available Tools
 
-### Building the Data
+| Tool                             | Description                   |
+| -------------------------------- | ----------------------------- |
+| `list_components`                | List all components           |
+| `get_component`                  | Get component details & types |
+| `search_components`              | Search by name                |
+| `list_hooks`                     | List all hooks                |
+| `get_hook`                       | Get hook details              |
+| `get_design_tokens`              | Get design tokens             |
+| `get_component_template`         | New component template        |
+| `get_css_module_guidelines`      | CSS Module patterns           |
+| `analyze_component_dependencies` | Dependency analysis           |
 
-This server extracts design system metadata at build time. To build:
+## Development
 
 ```bash
-# Install dependencies
 yarn install
-
-# Build the data bundle
-yarn build
-```
-
-This creates `data/design-system.json` with all component, hook, and token information.
-
-### Testing Locally
-
-```bash
-# After building, test the server
-node index.js
+yarn build        # Generate design-system.json
+node index.js     # Test locally
 ```
 
-Or test with MCP Inspector:
-
-```bash
-npx @modelcontextprotocol/inspector node index.js
-```
-
-### Publishing
-
-```bash
-# The prepublishOnly script runs yarn build automatically
-yarn publish
-```
-
-## 📊 How It Works
-
-### Build Time (CI/CD)
-
-1. `build-mcp-data.js` scans the design system:
-
-   - Reads all components from `src/components/`
-   - Reads all hooks from `src/hooks/`
-   - Reads all design tokens from `design-tokens/`
-
-2. Extracts file contents and metadata
-
-3. Bundles everything into `data/design-system.json`
-
-4. Package is published to npm with bundled data
-
-### Runtime (User's Machine)
-
-1. User runs `npx @spaced-out/genesis-mcp-server`
-
-2. Server loads pre-bundled `data/design-system.json`
-
-3. Serves data via MCP protocol (stdio)
-
-4. AI assistant queries the server for design system info
-
-**Result:** No local design system needed! ✨
-
-## 🏗️ Architecture
-
-```
-ui-design-system/
-├── src/
-│   ├── components/          # Source components
-│   └── hooks/               # Source hooks
-├── design-tokens/           # Source tokens
-└── mcp/                     # 👈 MCP Server
-    ├── index.js             # MCP server (reads from data/)
-    ├── build-mcp-data.js    # Build script (extracts from ../)
-    ├── data/
-    │   └── design-system.json  # Bundled data (git-ignored)
-    ├── package.json
-    └── README.md
-```
-
-## 📝 Available Tools
-
-The MCP server provides these tools to AI assistants:
-
-- `list_components` - List all available components
-- `get_component` - Get detailed component information **including exported types** (e.g., IconType, IconSize from Icon component)
-- `search_components` - Search components by name
-- `list_hooks` - List all available hooks
-- `get_hook` - Get detailed hook information
-- `get_design_tokens` - Get all or filtered design tokens
-- `get_component_template` - Get template for new components
-- `get_design_token_import_guidelines` - Get guidelines for importing design tokens in CSS Module files with correct paths and examples
-- `get_css_module_guidelines` - **NEW!** Get comprehensive CSS Module styling guidelines including class naming conventions (BEM patterns), token usage, icon color patterns, and common mistakes to avoid
-- `analyze_component_dependencies` - Analyze component dependencies
-
-## 🔄 CI/CD Integration
-
-### Automatic Publishing
-
-The MCP server is automatically published to npm via GitHub Actions (`.github/workflows/publish-mcp.yml`).
-
-**Triggers:**
-
-- Push to `master` branch when files change in:
-  - `src/**` (component/hook changes)
-  - `design-tokens/**` (token changes)
-  - `mcp/**` (MCP server changes)
-- Manual workflow dispatch
-
-**Process:**
-
-1. **Auto-version bump**: If `src/` or `design-tokens/` changed, automatically bumps patch version
-2. **Build**: Generates fresh MCP data bundle with latest design system changes
-3. **Commit**: Pushes version bump back to master (with `[skip ci]` to avoid loops)
-4. **Publish**: Publishes new version to npm
-
-**What this means for you:**
-
-✅ Update a component → Merge to master → New MCP version automatically published!
-
-No need to manually bump versions when changing design system files. The workflow handles it for you.
-
-### Version Management
-
-**Automatic (recommended):**
-
-- Changes to `src/` or `design-tokens/` → patch version bumped automatically
-- E.g., `1.0.5` → `1.0.6`
-
-**Manual (for major/minor releases):**
-
-```bash
-cd mcp
-yarn version --minor  # or --major
-git push --follow-tags
-```
-
-**Manual MCP-only changes:**
-
-- If you only change files in `mcp/`, manually bump the version to publish
-
-## 📈 Data Size
-
-The bundled JSON includes:
-
-- Full TypeScript component implementations
-- Storybook stories
-- CSS modules
-- Design tokens
-- Hook implementations
-
-Typical size: 5-15 MB (cached by npm, so only downloaded once)
-
-## 🔐 Private Packages
-
-If publishing to a private npm registry:
-
-```json
-{
-  "publishConfig": {
-    "registry": "https://your-private-registry.com"
-  }
-}
-```
-
-Users configure their registry:
-
-```bash
-npm config set @spaced-out:registry https://your-private-registry.com
-# or with yarn
-yarn config set registry https://your-private-registry.com
-```
-
-## 🐛 Troubleshooting
-
-### "spawn npx ENOENT" Error (macOS/Windows)
-
-**Symptoms:**
-
-- Cursor or Claude Desktop logs show `spawn npx ENOENT` error
-- MCP server fails to start with connection errors
-- Error message: `Server transport closed unexpectedly`
-
-**Cause:**
-GUI applications on macOS and Windows don't inherit your terminal's PATH environment variables, so they cannot find the `npx` command.
-
-**Solution:**
-
-1. Find your `npx` path in terminal:
-
-**macOS/Linux:**
-
-```bash
-which npx
-```
-
-**Windows (PowerShell):**
-
-```powershell
-where.exe npx
-```
-
-2. Use the **full path** in your MCP configuration instead of just `"command": "npx"`:
-
-**Example (macOS):**
-
-```json
-{
-  "mcpServers": {
-    "genesis-design-system": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
-    }
-  }
-}
-```
-
-**Example (Windows):**
-
-```json
-{
-  "mcpServers": {
-    "genesis-design-system": {
-      "command": "C:\\Program Files\\nodejs\\npx.cmd",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
-    }
-  }
-}
-```
-
-**Common npx locations:**
-
-**macOS:**
-
-- Homebrew (Apple Silicon): `/opt/homebrew/bin/npx`
-- Homebrew (Intel): `/usr/local/bin/npx`
-- nvm: `/Users/YOUR_USERNAME/.nvm/versions/node/vX.X.X/bin/npx`
-
-**Windows:**
-
-- Default Node.js: `C:\Program Files\nodejs\npx.cmd`
-- nvm-windows: `C:\Users\YOUR_USERNAME\AppData\Roaming\nvm\vX.X.X\npx.cmd`
-
-**Linux:**
-
-- Most distributions: `/usr/bin/npx` or `/usr/local/bin/npx`
-
-3. Restart your AI assistant (Cursor or Claude Desktop)
-
-**Verify the fix:**
-After restarting, check the application logs. You should see successful initialization:
-
-```
-✅ Loaded Genesis design system data
-   Version: X.X.X
-   Components: XX
-   Hooks: XX
-```
-
-Instead of `ENOENT` errors.
-
-### MCP Inspector (Advanced Debugging)
-
-If you're still having issues, use the MCP Inspector to debug:
-
-```bash
-npx @modelcontextprotocol/inspector
-```
-
-Navigate to `http://127.0.0.1:6274` and configure:
-
-- **Transport type:** Stdio
-- **Command:** Your full npx path (e.g., `/opt/homebrew/bin/npx`)
-- **Arguments:** `-y @spaced-out/genesis-mcp-server@latest`
-
-Click **Connect** to test the connection. If it fails, check the terminal logs for detailed error messages.
-
-### Test the Server Directly
-
-Test if the server runs correctly in your terminal:
-
-```bash
-npx -y @spaced-out/genesis-mcp-server@latest
-```
-
-You should see:
-
-```
-✅ Loaded Genesis design system data
-   Version: X.X.X
-   Components: XX
-   Hooks: XX
-   Built: YYYY-MM-DD
-```
-
-If this fails, there may be an issue with the published package.
-
-### Package Not Found
-
-**Error:** `npm ERR! 404 '@spaced-out/genesis-mcp-server@latest' is not in this registry`
-
-**Solution:**
-
-- Verify the package is published: `npm view @spaced-out/genesis-mcp-server`
-- If using a private registry, ensure you're authenticated
-- Check your npm registry configuration: `npm config get registry`
-
-### Node.js Version
-
-**Error:** `The engine "node" is incompatible with this module`
-
-**Solution:**
-This server requires Node.js >= 18.0.0. Update your Node.js installation:
-
-```bash
-node --version  # Check current version
-```
-
-Use [nvm](https://github.com/nvm-sh/nvm) or download from [nodejs.org](https://nodejs.org/).
-
-## 🤝 Contributing
-
-When updating the design system:
-
-1. Changes to components/hooks/tokens are automatically detected
-2. CI/CD runs `npm run build` to regenerate data
-3. New version is published to npm
-4. Users get updates on next `npx` run (or immediately with `@latest`)
-
-## 🎨 Integration with Figma MCP
-
-The Genesis MCP server works seamlessly alongside the Figma MCP server, enabling a powerful design-to-code workflow. By using both servers together, you can bridge design and implementation.
-
-### Why Use Both?
-
-**Figma MCP** provides:
-
-- Design screenshots and visual context
-- Component properties and variants from Figma
-- Design tokens and variables from Figma files
-- Layout measurements and spacing
-
-**Genesis MCP** provides:
-
-- Actual React component implementations
-- Design system tokens and guidelines
-- TypeScript types and APIs
-- CSS Module styling patterns
-
-Together, they create a complete workflow: **Design in Figma → Implement with Genesis**
-
-### Configuration Examples
-
-You can run multiple MCP servers simultaneously:
-
-**VS Code/Cursor:**
-
-```json
-{
-  "mcpServers": {
-    "genesis-design-system": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
-    },
-    "figma-desktop": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@modelcontextprotocol/server-figma"]
-    }
-  }
-}
-```
-
-**Claude Desktop:**
-
-```json
-{
-  "mcpServers": {
-    "genesis-design-system": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
-    },
-    "figma-desktop": {
-      "command": "/opt/homebrew/bin/npx",
-      "args": ["-y", "@modelcontextprotocol/server-figma"]
-    }
-  }
-}
-```
-
-### Workflow Examples
-
-**Design-to-Code:**
-
-```
-"Show me the current Figma selection"
-"Find the matching Genesis component for this design"
-"Implement this Figma button using Genesis Button component"
-```
-
-**Token Mapping:**
-
-```
-"Compare Figma colors with Genesis color tokens"
-"What Genesis spacing token matches this 16px gap?"
-"Map this Figma shadow to Genesis elevation tokens"
-```
-
-**Validation:**
-
-```
-"Does Genesis have a component matching this Figma design?"
-"Are these Figma colors available in Genesis palette?"
-"What Genesis components would I need for this Figma screen?"
-```
-
-### Requirements
-
-- **Figma MCP**: Figma Desktop app running with design files open
-- **Genesis MCP**: Node.js >= 18.0.0
-
-See [Figma MCP documentation](https://modelcontextprotocol.io/docs/tools/figma) for Figma setup details.
-
-## 📚 Additional Resources
-
-- [MCP Documentation](https://modelcontextprotocol.io)
-- [Figma MCP Documentation](https://modelcontextprotocol.io/docs/tools/figma)
-- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
-- [Genesis Storybook MCP Guide](https://your-storybook-url.com/?path=/docs/model-context-protocol--docs)
-
-## 📄 License
+## Troubleshooting
 
-UNLICENSED - Internal use only
+**"spawn npx ENOENT"**: Use full path to `npx` (see setup above).
 
----
+**Package not found**: Run `npm view @spaced-out/genesis-mcp` to verify.
 
-**Built with ❤️ by the Central UI team**
+**Node version**: Requires Node.js >= 18.0.0

package/mcp/build-mcp-data.js

@@ -70,72 +70,69 @@ function getAllFilesRecursively(dirPath, filesList = [], baseDir = dirPath) {
 
 /**
  * Extract all components with their files (including sub-components)
+ * For main component files and sub-components, we use .d.ts files from lib/
+ * to avoid exposing source code in the public npm package
  */
 function buildComponentsData() {
   console.log('📦 Extracting components...');
-  const componentsPath = join(DESIGN_SYSTEM_PATH, 'src/components');
+  const srcComponentsPath = join(DESIGN_SYSTEM_PATH, 'src/components');
+  const libComponentsPath = join(DESIGN_SYSTEM_PATH, 'lib/components');
   const components = {};
   
-  if (!existsSync(componentsPath)) {
+  if (!existsSync(srcComponentsPath)) {
     console.warn('⚠️  Components path not found');
     return components;
   }
 
-  const componentDirs = getDirectories(componentsPath).filter(name => name !== 'index.ts');
+  const componentDirs = getDirectories(srcComponentsPath).filter(name => name !== 'index.ts');
   
   for (const componentName of componentDirs) {
-    const componentDir = join(componentsPath, componentName);
+    const srcComponentDir = join(srcComponentsPath, componentName);
+    const libComponentDir = join(libComponentsPath, componentName);
     
-    // Get all files in the component directory
-    const allFiles = getAllFilesRecursively(componentDir);
+    // Get all files in the component directory (from src for reference)
+    const allFiles = getAllFilesRecursively(srcComponentDir);
     
-    // Extract main component files
-    const mainTsx = join(componentDir, `${componentName}.tsx`);
-    const mainTs = join(componentDir, `${componentName}.ts`);
-    const mainContent = safeReadFile(mainTsx) || safeReadFile(mainTs);
+    // Extract main component .d.ts file from lib/ (type definitions only)
+    const mainDts = join(libComponentDir, `${componentName}.d.ts`);
+    const mainContent = safeReadFile(mainDts);
     
-    // Extract story files
-    const storyTsx = join(componentDir, `${componentName}.stories.tsx`);
-    const storyTs = join(componentDir, `${componentName}.stories.ts`);
+    // Extract story files (keep from src - useful for usage examples)
+    const storyTsx = join(srcComponentDir, `${componentName}.stories.tsx`);
+    const storyTs = join(srcComponentDir, `${componentName}.stories.ts`);
     const storyContent = safeReadFile(storyTsx) || safeReadFile(storyTs);
     
-    // Extract CSS file
-    const cssFile = join(componentDir, `${componentName}.module.css`);
+    // Extract CSS file (keep from src - needed for styling reference)
+    const cssFile = join(srcComponentDir, `${componentName}.module.css`);
     const cssContent = safeReadFile(cssFile);
     
-    // Extract index file
-    const indexFile = join(componentDir, 'index.ts');
-    const indexContent = safeReadFile(indexFile);
+    // Extract index .d.ts file from lib/
+    const indexDts = join(libComponentDir, 'index.d.ts');
+    const indexContent = safeReadFile(indexDts);
     
-    // Extract all additional TypeScript/TSX files (sub-components)
+    // Extract all additional sub-component .d.ts files from lib/
     const additionalFiles = {};
-    for (const file of allFiles) {
+    const libAllFiles = existsSync(libComponentDir) ? getAllFilesRecursively(libComponentDir) : [];
+    
+    for (const file of libAllFiles) {
       // Skip main files we already extracted
       if (
-        file === `${componentName}.tsx` ||
-        file === `${componentName}.ts` ||
-        file === `${componentName}.stories.tsx` ||
-        file === `${componentName}.stories.ts` ||
-        file === `${componentName}.module.css` ||
-        file === 'index.ts' ||
-        file.endsWith('.module.css') ||
-        file.endsWith('.stories.tsx') ||
-        file.endsWith('.stories.ts') ||
-        file.endsWith('.stories.module.css')
+        file === `${componentName}.d.ts` ||
+        file === 'index.d.ts' ||
+        !file.endsWith('.d.ts') ||
+        file.endsWith('.d.ts.map')
       ) {
         continue;
       }
       
-      // Only include .tsx and .ts files (sub-components)
-      if (file.endsWith('.tsx') || file.endsWith('.ts')) {
-        const fullPath = join(componentDir, file);
-        const content = safeReadFile(fullPath);
-        if (content) {
-          additionalFiles[file] = {
-            path: file,
-            content: content
-          };
-        }
+      // Include .d.ts files for sub-components
+      const fullPath = join(libComponentDir, file);
+      const content = safeReadFile(fullPath);
+      if (content) {
+        additionalFiles[file] = {
+          path: file,
+          content: content
+        };
       }
     }
     
@@ -143,10 +140,10 @@ function buildComponentsData() {
       name: componentName,
       path: `src/components/${componentName}`,
       files: {
-        main: mainContent ? { path: `${componentName}.tsx`, content: mainContent } : null,
+        main: mainContent ? { path: `${componentName}.d.ts`, content: mainContent } : null,
         story: storyContent ? { path: `${componentName}.stories.tsx`, content: storyContent } : null,
         css: cssContent ? { path: `${componentName}.module.css`, content: cssContent } : null,
-        index: indexContent ? { path: 'index.ts', content: indexContent } : null,
+        index: indexContent ? { path: 'index.d.ts', content: indexContent } : null,
         additional: additionalFiles,
       },
       allFiles,
@@ -159,48 +156,50 @@ function buildComponentsData() {
 
 /**
  * Extract all hooks
+ * For main hook files, we use .d.ts files from lib/
+ * to avoid exposing source code in the public npm package
  */
 function buildHooksData() {
   console.log('🪝 Extracting hooks...');
-  const hooksPath = join(DESIGN_SYSTEM_PATH, 'src/hooks');
+  const srcHooksPath = join(DESIGN_SYSTEM_PATH, 'src/hooks');
+  const libHooksPath = join(DESIGN_SYSTEM_PATH, 'lib/hooks');
   const hooks = {};
   
-  if (!existsSync(hooksPath)) {
+  if (!existsSync(srcHooksPath)) {
     console.warn('⚠️  Hooks path not found');
     return hooks;
   }
 
-  const hookDirs = getDirectories(hooksPath).filter(name => name !== 'index.ts');
+  const hookDirs = getDirectories(srcHooksPath).filter(name => name !== 'index.ts');
   
   for (const hookName of hookDirs) {
-    const hookDir = join(hooksPath, hookName);
-    
-    // Read main hook file
-    const mainTs = join(hookDir, `${hookName}.ts`);
-    const mainTsx = join(hookDir, `${hookName}.tsx`);
+    const srcHookDir = join(srcHooksPath, hookName);
+    const libHookDir = join(libHooksPath, hookName);
     
-    // Read story file
-    const storyTsx = join(hookDir, `${hookName}.stories.tsx`);
-    const storyTs = join(hookDir, `${hookName}.stories.ts`);
+    // Read main hook .d.ts file from lib/ (type definitions only)
+    const mainDts = join(libHookDir, `${hookName}.d.ts`);
+    const mainContent = safeReadFile(mainDts);
     
-    // Read index file
-    const indexFile = join(hookDir, 'index.ts');
-    
-    const mainContent = safeReadFile(mainTs) || safeReadFile(mainTsx);
+    // Read story file (keep from src - useful for usage examples)
+    const storyTsx = join(srcHookDir, `${hookName}.stories.tsx`);
+    const storyTs = join(srcHookDir, `${hookName}.stories.ts`);
     const storyContent = safeReadFile(storyTsx) || safeReadFile(storyTs);
-    const indexContent = safeReadFile(indexFile);
     
-    const allFiles = existsSync(hookDir) 
-      ? readdirSync(hookDir).filter(f => !f.startsWith('.'))
+    // Read index .d.ts file from lib/
+    const indexDts = join(libHookDir, 'index.d.ts');
+    const indexContent = safeReadFile(indexDts);
+    
+    const allFiles = existsSync(srcHookDir) 
+      ? readdirSync(srcHookDir).filter(f => !f.startsWith('.'))
       : [];
     
     hooks[hookName] = {
       name: hookName,
       path: `src/hooks/${hookName}`,
       files: {
-        main: mainContent ? { path: `${hookName}.ts`, content: mainContent } : null,
+        main: mainContent ? { path: `${hookName}.d.ts`, content: mainContent } : null,
         story: storyContent ? { path: `${hookName}.stories.tsx`, content: storyContent } : null,
-        index: indexContent ? { path: 'index.ts', content: indexContent } : null,
+        index: indexContent ? { path: 'index.d.ts', content: indexContent } : null,
       },
       allFiles,
     };
@@ -254,30 +253,37 @@ function buildTokensData() {
 
 /**
  * Extract all utils
+ * For util files, we use .d.ts files from lib/
+ * to avoid exposing source code in the public npm package
  */
 function buildUtilsData() {
   console.log('🔧 Extracting utils...');
-  const utilsPath = join(DESIGN_SYSTEM_PATH, 'src/utils');
+  const srcUtilsPath = join(DESIGN_SYSTEM_PATH, 'src/utils');
+  const libUtilsPath = join(DESIGN_SYSTEM_PATH, 'lib/utils');
   const utils = {};
   
-  if (!existsSync(utilsPath)) {
+  if (!existsSync(srcUtilsPath)) {
     console.warn('⚠️  Utils path not found');
     return utils;
   }
 
-  const utilDirs = getDirectories(utilsPath);
+  const utilDirs = getDirectories(srcUtilsPath);
   
   for (const utilName of utilDirs) {
-    const utilDir = join(utilsPath, utilName);
+    const srcUtilDir = join(srcUtilsPath, utilName);
+    const libUtilDir = join(libUtilsPath, utilName);
     
-    // Get all files in the util directory
-    const allFiles = getAllFilesRecursively(utilDir);
+    // Get all files in the util directory (from src for reference)
+    const allFiles = getAllFilesRecursively(srcUtilDir);
     
-    // Read all TypeScript files
+    // Read all .d.ts files from lib/
     const files = {};
-    for (const file of allFiles) {
-      if ((file.endsWith('.ts') || file.endsWith('.tsx')) && !file.endsWith('.d.ts')) {
-        const fullPath = join(utilDir, file);
+    const libAllFiles = existsSync(libUtilDir) ? getAllFilesRecursively(libUtilDir) : [];
+    
+    for (const file of libAllFiles) {
+      // Only include .d.ts files (skip .js and .d.ts.map)
+      if (file.endsWith('.d.ts') && !file.endsWith('.d.ts.map')) {
+        const fullPath = join(libUtilDir, file);
         const content = safeReadFile(fullPath);
         if (content) {
           files[file] = {

package/mcp/index.js

@@ -11,7 +11,7 @@
  *   "mcpServers": {
  *     "genesis-design-system": {
  *       "command": "npx",
- *       "args": ["-y", "@spaced-out/genesis-mcp-server@latest"]
+ *       "args": ["-y", "@spaced-out/genesis-mcp@latest"]
  *     }
  *   }
  * }

package/mcp/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "@spaced-out/genesis-mcp-server",
-  "version": "1.0.15",
+  "name": "@spaced-out/genesis-mcp",
+  "version": "1.0.1",
   "description": "MCP server for Genesis UI Design System - provides AI assistants with access to components, hooks, and design tokens",
   "type": "module",
   "main": "index.js",

package/mcp/test-server.js

@@ -55,7 +55,7 @@ try {
   console.log('\n📝 Next steps:');
   console.log('   1. Update package.json version if needed');
   console.log('   2. Publish: npm publish');
-  console.log('   3. Users can run: npx @spaced-out/genesis-mcp-server@latest');
+  console.log('   3. Users can run: npx @spaced-out/genesis-mcp@latest');
   console.log('\n🎉 MCP server is ready to use!\n');
   
 } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaced-out/ui-design-system",
-  "version": "0.5.34",
+  "version": "0.5.36",
   "description": "Sense UI components library",
   "author": {
     "name": "Spaced Out"