@vuebro/configs 1.1.36 → 1.1.38
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.
- package/README.md +68 -8
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @vuebro/configs
|
|
2
2
|
|
|
3
|
-
A collection of shared configuration files for Vue.js projects with TypeScript, ESLint, Prettier, UnoCSS, and Vite. This package provides a
|
|
3
|
+
A comprehensive collection of shared configuration files for Vue.js projects with TypeScript, ESLint, Prettier, UnoCSS, and Vite. This package provides a complete setup for modern Vue development with Pug support, ensuring consistent code style and best practices across projects.
|
|
4
4
|
|
|
5
5
|
## Features
|
|
6
6
|
|
|
@@ -8,6 +8,7 @@ A collection of shared configuration files for Vue.js projects with TypeScript,
|
|
|
8
8
|
- **Prettier Configuration**: Code formatting with plugins for Pug, JSDoc, Tailwind CSS, and package.json
|
|
9
9
|
- **TypeScript Configuration**: Strict TypeScript setup with Vue-specific configurations
|
|
10
10
|
- **UnoCSS Configuration**: Utility-first CSS framework with Pug extractor and various transformers
|
|
11
|
+
- **UnoCSS Presets**: Collection of presets for attributify, icons, typography, web fonts, and wind
|
|
11
12
|
- **Vite Configuration**: Optimized build tool configuration for Vue projects
|
|
12
13
|
- **Pug Support**: Full integration with Pug templating engine
|
|
13
14
|
|
|
@@ -31,7 +32,7 @@ export default configs;
|
|
|
31
32
|
|
|
32
33
|
### Prettier
|
|
33
34
|
|
|
34
|
-
To use the Prettier configuration, add this to your `prettierrc.config.js` or
|
|
35
|
+
To use the Prettier configuration, add this to your `prettierrc.config.js` or `.prettierrc`:
|
|
35
36
|
|
|
36
37
|
```js
|
|
37
38
|
import config from "@vuebro/configs/prettierrc";
|
|
@@ -39,6 +40,14 @@ import config from "@vuebro/configs/prettierrc";
|
|
|
39
40
|
export default config;
|
|
40
41
|
```
|
|
41
42
|
|
|
43
|
+
Alternatively, you can reference it in your `package.json`:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"prettier": "@vuebro/configs/prettierrc"
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
42
51
|
### TypeScript
|
|
43
52
|
|
|
44
53
|
To use the TypeScript configuration, extend it in your `tsconfig.json`:
|
|
@@ -63,6 +72,21 @@ You can also use the UnoCSS presets with:
|
|
|
63
72
|
|
|
64
73
|
```js
|
|
65
74
|
import presets from "@vuebro/configs/uno/presets";
|
|
75
|
+
|
|
76
|
+
// Example usage with options
|
|
77
|
+
import { defineConfig } from "unocss";
|
|
78
|
+
import presetUno from "@unocss/preset-uno";
|
|
79
|
+
|
|
80
|
+
export default defineConfig({
|
|
81
|
+
presets: [
|
|
82
|
+
...presets({
|
|
83
|
+
// Custom options for presets
|
|
84
|
+
iconsOptions: { cdn: "https://cdn.jsdelivr.net/npm/" },
|
|
85
|
+
wind4Options: { preflights: { reset: true } },
|
|
86
|
+
}),
|
|
87
|
+
presetUno(),
|
|
88
|
+
],
|
|
89
|
+
});
|
|
66
90
|
```
|
|
67
91
|
|
|
68
92
|
### Vite
|
|
@@ -86,6 +110,7 @@ export default config;
|
|
|
86
110
|
- Documentation rules with `eslint-plugin-jsdoc`
|
|
87
111
|
- Style consistency with `eslint-plugin-perfectionist`
|
|
88
112
|
- Integration with Prettier using `eslint-plugin-prettier`
|
|
113
|
+
- Support for JSON and Markdown files
|
|
89
114
|
|
|
90
115
|
### Prettier Config
|
|
91
116
|
|
|
@@ -94,31 +119,66 @@ export default config;
|
|
|
94
119
|
- Enhanced JSDoc formatting with `prettier-plugin-jsdoc`
|
|
95
120
|
- Tailwind CSS class sorting with `prettier-plugin-tailwindcss`
|
|
96
121
|
- package.json formatting with `prettier-plugin-packagejson`
|
|
122
|
+
- TS Doc support enabled
|
|
97
123
|
|
|
98
124
|
### UnoCSS Config
|
|
99
125
|
|
|
100
|
-
- Pug template extractor
|
|
126
|
+
- Pug template extractor for class detection
|
|
101
127
|
- Arbitrary variants extractor
|
|
102
128
|
- Transformer for variant groups
|
|
103
129
|
- Transformer for directives
|
|
104
130
|
- Transformer for class compilation
|
|
105
131
|
|
|
132
|
+
### UnoCSS Presets
|
|
133
|
+
|
|
134
|
+
- **Attributify**: Use utility attributes directly in your templates
|
|
135
|
+
- **Icons**: Access thousands of icons from icon collections
|
|
136
|
+
- **Typography**: Style text content with opinionated defaults
|
|
137
|
+
- **Web Fonts**: Use web fonts from Google Fonts and other providers
|
|
138
|
+
- **Tagify**: Use actual HTML tags as selectors
|
|
139
|
+
- **Wind**: UnoCSS interpretation of Tailwind CSS
|
|
140
|
+
|
|
106
141
|
### Vite Config
|
|
107
142
|
|
|
108
143
|
- Vue plugin integration
|
|
109
144
|
- UnoCSS plugin integration
|
|
110
145
|
- Vue DevTools plugin
|
|
111
|
-
-
|
|
112
|
-
- Dynamic app version injection
|
|
146
|
+
- Path alias configuration (`@` maps to `./src`)
|
|
147
|
+
- Dynamic app version injection with `__APP_VERSION__`
|
|
148
|
+
- Base path set to relative "./" for proper deployment
|
|
149
|
+
|
|
150
|
+
## Development Scripts
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
npm run build # Compiles TypeScript to JavaScript
|
|
154
|
+
npm run lint # Runs ESLint to check code quality
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## Philosophy
|
|
158
|
+
|
|
159
|
+
This package follows modern best practices for Vue.js development:
|
|
160
|
+
|
|
161
|
+
- Strict TypeScript settings for type safety
|
|
162
|
+
- Comprehensive linting to maintain code quality
|
|
163
|
+
- Consistent code formatting with Prettier
|
|
164
|
+
- On-demand utility CSS with UnoCSS
|
|
165
|
+
- Fast build process with Vite
|
|
166
|
+
- Integration with Pug templating engine
|
|
167
|
+
|
|
168
|
+
## Contributing
|
|
169
|
+
|
|
170
|
+
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
|
|
171
|
+
|
|
172
|
+
Please make sure to update tests as appropriate.
|
|
113
173
|
|
|
114
174
|
## License
|
|
115
175
|
|
|
116
|
-
This project is licensed under the AGPL-3.0-or-later License - see the [LICENSE](LICENSE) file for details.
|
|
176
|
+
This project is licensed under the GNU AGPL-3.0-or-later License - see the [LICENSE](LICENSE) file for details.
|
|
117
177
|
|
|
118
178
|
## Author
|
|
119
179
|
|
|
120
180
|
jbruwes
|
|
121
181
|
|
|
122
|
-
##
|
|
182
|
+
## Support
|
|
123
183
|
|
|
124
|
-
|
|
184
|
+
If you encounter any issues or have questions about using these configurations, please open an issue in the GitHub repository.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vuebro/configs",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.38",
|
|
4
4
|
"description": "@vuebro/configs",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"vuebro",
|
|
@@ -67,6 +67,7 @@
|
|
|
67
67
|
"@vue/eslint-config-typescript": "^14.6.0",
|
|
68
68
|
"@vue/language-plugin-pug": "^3.1.1",
|
|
69
69
|
"@vue/tsconfig": "^0.8.1",
|
|
70
|
+
"@vueuse/core": "^14.0.0",
|
|
70
71
|
"consola": "^3.4.2",
|
|
71
72
|
"eslint": "^9.38.0",
|
|
72
73
|
"eslint-config-flat-gitignore": "^2.1.0",
|
|
@@ -92,6 +93,7 @@
|
|
|
92
93
|
"unocss": "^66.5.4",
|
|
93
94
|
"vite": "^7.1.12",
|
|
94
95
|
"vite-plugin-vue-devtools": "^8.0.3",
|
|
96
|
+
"vue": "^3.5.22",
|
|
95
97
|
"vue-eslint-parser-template-tokenizer-pug": "^1.0.0",
|
|
96
98
|
"vue-tsc": "^3.1.1"
|
|
97
99
|
},
|