+ );
+}
+```
+
+## **⚠️ Important Notes & Best Practices**
+
+### **Styling Guidelines**
+
+1. **No Tailwind Classes in Components**: Use component props instead
+
+ ```tsx
+ // ❌ Don't do this
+
+
+ // ✅ Do this instead
+
+ ```
+
+2. **Layout Utilities Are Allowed**: Use Tailwind for spacing and layout
+
+ ```tsx
+ // ✅ This is fine
+
+
+
+
+ ```
+
+3. **Use Semantic Colors**: Use intent-based props rather than specific colors
+ ```tsx
+ // ✅ Semantic approach
+ Active
+
+ ```
+
+### **TypeScript Support**
+
+The package provides full TypeScript support. Import types as needed:
+
+```tsx
+import type {
+ ComponentProps,
+ ToastVariant,
+ ToastOptions,
+ ErrorBoundaryProps,
+} from "@etherisc/ui-kit";
+```
+
+### **Dark Mode Support**
+
+Dark mode is automatically handled by the ThemeProvider. Components will adapt based on the current theme:
+
+```tsx
+// Theme switching
+import { useTheme } from "@etherisc/ui-kit";
+
+function ThemeToggle() {
+ const { theme, setTheme } = useTheme();
+
+ return (
+
+ );
+}
+```
+
+## **🔍 Troubleshooting Common Issues**
+
+### **Issue: Styles Not Loading**
+
+- Ensure you've imported `@etherisc/ui-kit/dist/style.css`
+- Check that your Tailwind config includes the ui-kit in `content` paths
+- Verify DaisyUI is properly configured in your Tailwind config
+
+### **Issue: Components Look Unstyled**
+
+- Make sure the CSS variables are properly mapped in your Tailwind config
+- Check that the `data-theme` attribute is set on the HTML element
+- Ensure the ThemeProvider is wrapping your app
+
+### **Issue: TypeScript Errors**
+
+- Install the required peer dependencies (`react`, `react-dom`)
+- Update your TypeScript config to include the ui-kit types
+- Check for version compatibility with React 18+
+
+### **Issue: Dark Mode Not Working**
+
+- Verify `darkMode: ['class']` is set in your Tailwind config
+- Ensure the ThemeProvider has the correct theme configuration
+- Check that the `dark` class is being applied to the HTML element
+
+## **📚 Additional Resources**
+
+- **[Component Documentation](../packages/ui-kit/README.md)** - Complete component API reference
+- **[Storybook](https://ui-kit-storybook-url)** - Interactive component explorer
+- **[Development Guide](./development.md)** - Contributing and development setup
+- **[Design System Principles](../packages/ui-kit/src/docs/)** - Design tokens and guidelines
+
+---
+
+This comprehensive setup should get your consuming application fully integrated with the Radix UI + shadcn + DaisyUI design system. The key is understanding how the three libraries work together through the CSS variable mapping layer.
diff --git a/packages/showcase/CHANGELOG.md b/packages/showcase/CHANGELOG.md
index abdb2cd..030f6a0 100644
--- a/packages/showcase/CHANGELOG.md
+++ b/packages/showcase/CHANGELOG.md
@@ -1,5 +1,12 @@
# @org/showcase
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies
+ - @etherisc/ui-kit@0.2.0
+
## 0.1.2
### Patch Changes
diff --git a/packages/showcase/package.json b/packages/showcase/package.json
index 5cb7f7e..92d04c7 100644
--- a/packages/showcase/package.json
+++ b/packages/showcase/package.json
@@ -1,6 +1,6 @@
{
"name": "@org/showcase",
- "version": "0.1.2",
+ "version": "0.1.3",
"private": true,
"type": "module",
"scripts": {
diff --git a/packages/ui-kit/CHANGELOG.md b/packages/ui-kit/CHANGELOG.md
index 8ad62d6..efacef1 100644
--- a/packages/ui-kit/CHANGELOG.md
+++ b/packages/ui-kit/CHANGELOG.md
@@ -1,5 +1,15 @@
# @etherisc/ui-kit
+## 0.2.0
+
+### Patch Changes
+
+- fix: ensure Select component is properly exported with TypeScript declarations
+
+ The Select component was implemented but not being exported due to a build configuration issue where TypeScript declarations weren't being generated properly. This fix updates the build script to ensure all component declarations are generated and exported correctly.
+
+ Fixes #39
+
## 0.1.0
### Minor Changes
diff --git a/packages/ui-kit/package.json b/packages/ui-kit/package.json
index ccaee9f..797b113 100644
--- a/packages/ui-kit/package.json
+++ b/packages/ui-kit/package.json
@@ -1,6 +1,6 @@
{
"name": "@etherisc/ui-kit",
- "version": "0.2.0-beta",
+ "version": "0.2.0",
"type": "module",
"license": "Apache-2.0",
"main": "./dist/ui-kit.umd.cjs",
@@ -23,7 +23,7 @@
},
"scripts": {
"dev": "vite",
- "build": "tsc && vite build",
+ "build": "tsc --declaration --emitDeclarationOnly --outDir dist && vite build",
"lint": "eslint .",
"preview": "vite preview",
"test": "vitest run",
diff --git a/packages/ui-kit/tsconfig.json b/packages/ui-kit/tsconfig.json
index 20f1f0f..c3ad1c3 100644
--- a/packages/ui-kit/tsconfig.json
+++ b/packages/ui-kit/tsconfig.json
@@ -9,6 +9,7 @@
"resolveJsonModule": true,
"isolatedModules": true,
"noEmit": false,
+ "emitDeclarationOnly": false,
"declaration": true,
"declarationMap": true,
"outDir": "dist",