@colorffy/ui 1.0.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +52 -42
  3. package/package.json +2 -2
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Giancarlos Garza
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,20 +1,24 @@
1
1
  # @colorffy/ui
2
2
 
3
- A modern Vue 3 component library built with TypeScript. Features a comprehensive collection of **unstyled, headless UI components** with full TypeScript support. Designed to work seamlessly with **ColorffyCSS** (optional) or your own custom styles.
3
+ [![npm version](https://img.shields.io/npm/v/@colorffy/ui?color=blue&label=npm&logo=npm&style=flat-square)](https://www.npmjs.com/package/@colorffy/ui)
4
+ [![install size](https://packagephobia.com/badge?p=@colorffy/ui)](https://packagephobia.com/result?p=@colorffy/ui)
5
+ [![license](https://img.shields.io/npm/l/@colorffy/ui?style=flat-square)](https://github.com/giancarlosgza/colorffy-ui/blob/main/packages/ColorffyCSS/LICENSE)
4
6
 
5
- ## Features
7
+ A modern Nuxt / Vue 3 component library built with TypeScript. Features a comprehensive collection of **unstyled, headless UI components** with full TypeScript support. Designed to work seamlessly with **Colorffy CSS** (optional) or your own custom styles.
6
8
 
7
- **70+ Vue 3 Components** - Accordion, Alerts, Buttons, Cards, Dialogs, Forms, Navigation, and more
8
- 🎨 **Style-Agnostic** - Use with ColorffyCSS or bring your own styles
9
- 📘 **Full TypeScript Support** - Complete type definitions for all components
10
- 🔌 **Flexible Installation** - Use globally or import individually
11
- 🚀 **Tree-shakeable** - Import only what you need
12
- ⚡ **Nuxt 3 Compatible** - Works seamlessly with Nuxt applications
13
- 🎯 **Headless Architecture** - Full control over styling and behavior
9
+ ## Features
14
10
 
15
- ## Installation
11
+ - ✨ **70+ Vue 3 Components** - Accordion, Alerts, Buttons, Cards, Dialogs, Forms, Navigation, and more
12
+ - 🎨 **Style-Agnostic** - Use with Colorffy CSS or bring your own styles
13
+ - 📘 **Full TypeScript Support** - Complete type definitions for all components
14
+ - 🔌 **Flexible Installation** - Use globally or import individually
15
+ - 🚀 **Tree-shakeable** - Import only what you need
16
+ - ⚡ **Nuxt 3 Compatible** - Works seamlessly with Nuxt applications
17
+ - 🎯 **Headless Architecture** - Full control over styling and behavior
16
18
 
17
- ### Install ColorffyUI
19
+ ## 📦 Installation
20
+
21
+ ### Install Colorffy UI
18
22
 
19
23
  ```bash
20
24
  # npm
@@ -29,13 +33,13 @@ pnpm add @colorffy/ui
29
33
 
30
34
  ### Install Peer Dependencies
31
35
 
32
- ColorffyUI requires the following peer dependencies:
36
+ Colorffy UI requires the following peer dependencies:
33
37
 
34
38
  ```bash
35
39
  npm install @vueuse/components floating-vue vue
36
40
  ```
37
41
 
38
- ### Install ColorffyCSS (Optional, Recommended)
42
+ ### Install Colorffy CSS (Optional, Recommended)
39
43
 
40
44
  For pre-built, beautiful styling that works out of the box:
41
45
 
@@ -43,11 +47,11 @@ For pre-built, beautiful styling that works out of the box:
43
47
  npm install @colorffy/css
44
48
  ```
45
49
 
46
- > **Note:** ColorffyUI components are **unstyled by default**. You can use ColorffyCSS for instant styling, or provide your own custom styles.
50
+ > **Note:** Colorffy UI components are **unstyled by default**. You can use Colorffy CSS for instant styling, or provide your own custom styles.
47
51
 
48
- ## Styling Options
52
+ ## 🎨 Styling Options
49
53
 
50
- ### Option 1: Use ColorffyCSS (Recommended)
54
+ ### Option 1: Use Colorffy CSS (Recommended)
51
55
 
52
56
  Import the compiled CSS in your `main.ts`:
53
57
 
@@ -62,13 +66,13 @@ app.use(ColorffyUI)
62
66
  app.mount('#app')
63
67
  ```
64
68
 
65
- ### Option 2: Customize ColorffyCSS with SCSS
69
+ ### Option 2: Customize Colorffy CSS with SCSS
66
70
 
67
71
  For full customization, use SCSS to override variables:
68
72
 
69
73
  ```scss
70
74
  // src/assets/variables.scss
71
- // Override ColorffyCSS variables
75
+ // Override Colorffy CSS variables
72
76
  @forward '@colorffy/css/scss/abstracts/variables' with (
73
77
  $primary: #4f46e5,
74
78
  $secondary: #ec4899,
@@ -103,7 +107,7 @@ app.mount('#app')
103
107
 
104
108
  ### Option 3: Custom Styles
105
109
 
106
- Use ColorffyUI components without any styling framework. Components use semantic class names like `.btn`, `.card`, `.alert`, etc. that you can style however you want:
110
+ Use Colorffy UI components without any styling framework. Components use semantic class names like `.btn`, `.card`, `.alert`, etc. that you can style however you want:
107
111
 
108
112
  ```css
109
113
  /* your-custom-styles.css */
@@ -120,9 +124,9 @@ Use ColorffyUI components without any styling framework. Components use semantic
120
124
  }
121
125
  ```
122
126
 
123
- For more details on ColorffyCSS customization, see the [ColorffyCSS README](https://www.npmjs.com/package/@colorffy/css).
127
+ For more details on Colorffy CSS customization, see the [Colorffy CSS README](https://www.npmjs.com/package/@colorffy/css).
124
128
 
125
- ## Usage
129
+ ## 🚀 Usage
126
130
 
127
131
  ### Option 1: Global Registration (Recommended for most cases)
128
132
 
@@ -198,7 +202,7 @@ app.component('UiAlert', UiAlert)
198
202
  app.mount('#app')
199
203
  ```
200
204
 
201
- ## Nuxt 3 Usage
205
+ ## 🚀 Nuxt 3 Usage
202
206
 
203
207
  ### Install Dependencies
204
208
 
@@ -206,9 +210,9 @@ app.mount('#app')
206
210
  npm install @colorffy/ui @colorffy/css
207
211
  ```
208
212
 
209
- ### Setup with ColorffyCSS
213
+ ### Setup with Colorffy CSS
210
214
 
211
- Add ColorffyCSS to your `nuxt.config.ts`:
215
+ Add Colorffy CSS to your `nuxt.config.ts`:
212
216
 
213
217
  ```typescript
214
218
  export default defineNuxtConfig({
@@ -311,7 +315,7 @@ export default defineNuxtConfig({
311
315
  })
312
316
  ```
313
317
 
314
- ## Component Categories
318
+ ## 💻 Component Categories
315
319
 
316
320
  ### Layout Components
317
321
  - `UiHeaderContent` - Page header with title and subtitle
@@ -394,7 +398,7 @@ export default defineNuxtConfig({
394
398
  - `UiShapeLoading` - Shape loading animation
395
399
  - `UiTableSkeleton` - Table skeleton loader
396
400
 
397
- ## Composables
401
+ ## 💻 Composables
398
402
 
399
403
  The library also exports useful composables:
400
404
 
@@ -412,7 +416,7 @@ const dateUtils = useDateUtils()
412
416
  const textUtils = useTextUtils()
413
417
  ```
414
418
 
415
- ## Component Examples
419
+ ## 💻 Component Examples
416
420
 
417
421
  ### Button
418
422
 
@@ -529,7 +533,7 @@ const textUtils = useTextUtils()
529
533
  </template>
530
534
  ```
531
535
 
532
- ## TypeScript Support
536
+ ## 🏗️ TypeScript Support
533
537
 
534
538
  All components come with full TypeScript support. Import types as needed:
535
539
 
@@ -546,18 +550,18 @@ const variant: ButtonVariant = 'filled'
546
550
  const color: ButtonColor = 'primary'
547
551
  ```
548
552
 
549
- ## Styling
553
+ ## 🎨 Styling
550
554
 
551
- ### With ColorffyCSS (Recommended)
555
+ ### With Colorffy CSS (Recommended)
552
556
 
553
- ColorffyUI is designed to work seamlessly with ColorffyCSS, which provides:
557
+ Colorffy UI is designed to work seamlessly with Colorffy CSS, which provides:
554
558
  - Modern, responsive design system
555
559
  - Consistent color palette with tonal variants
556
560
  - Pre-built component styles
557
561
  - Utility classes for rapid development
558
562
  - Customizable themes with SCSS variables
559
563
 
560
- Install ColorffyCSS and import it in your app:
564
+ Install Colorffy CSS and import it in your app:
561
565
 
562
566
  ```bash
563
567
  npm install @colorffy/css
@@ -603,32 +607,38 @@ Override CSS custom properties for runtime theming:
603
607
  }
604
608
  ```
605
609
 
606
- For complete styling documentation, see the [ColorffyCSS README](https://www.npmjs.com/package/@colorffy/css).
610
+ For complete styling documentation, see the [Colorffy CSS README](https://www.npmjs.com/package/@colorffy/css).
607
611
 
608
- ## Browser Support
612
+ ## 🔍 Browser Support
609
613
 
610
614
  - Chrome (latest)
611
615
  - Firefox (latest)
612
616
  - Safari (latest)
613
617
  - Edge (latest)
614
618
 
615
- ## Contributing
619
+ ## 🤝 Contributing
620
+
621
+ Contributions, issues, and feature requests are welcome!
616
622
 
617
- Contributions are welcome! Please feel free to submit issues or pull requests.
623
+ Feel free to check the [issues page](https://github.com/giancarlosgza/colorffy-workspace/issues).
618
624
 
619
- ## License
625
+ ## 📄 License
620
626
 
621
- ISC
627
+ MIT © [Giancarlos Garza](https://github.com/giancarlosgza)
622
628
 
623
629
  ## Author
624
630
 
625
631
  Giancarlos Garza
626
632
 
627
- ## Links
633
+ ## ⭐ Show your support
628
634
 
629
- - [npm Package](https://www.npmjs.com/package/@colorffy/ui)
630
- - [ColorffyCSS](https://www.npmjs.com/package/@colorffy/css)
635
+ - [Colorffy UI](https://www.npmjs.com/package/@colorffy/ui)
636
+ - [Colorffy CSS](https://www.npmjs.com/package/@colorffy/css)
637
+
638
+ Give a ⭐️ if this project helped you!
631
639
 
632
640
  ---
633
641
 
634
- Made with ❤️ using Vue 3 and TypeScript
642
+ Made with ❤️ by [Giancarlos Garza](https://github.com/giancarlosgza) using Vue 3 and TypeScript.
643
+
644
+ Powered by [Colorffy](https://colorffy.com) 🎨
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@colorffy/ui",
3
- "version": "1.0.2",
3
+ "version": "1.0.3",
4
4
  "description": "A modern Vue 3 component library built with TypeScript and Colorffy CSS",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -66,5 +66,5 @@
66
66
  "typescript"
67
67
  ],
68
68
  "author": "Giancarlos Garza",
69
- "license": "ISC"
69
+ "license": "MIT"
70
70
  }