purgetss 3.0.3 → 3.1.1
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/.editorconfig +1 -1
- package/README.md +27 -12
- package/assets/fonts/tabler-icons.ttf +0 -0
- package/assets/images/blend-modes.png +0 -0
- package/assets/images/icon-fonts-tabler.png +0 -0
- package/assets/images/shadow.png +0 -0
- package/bin/purgetss +9 -8
- package/dist/boxicons.tss +1 -0
- package/dist/framework7icons.tss +1 -1
- package/dist/lineicons.tss +1 -0
- package/dist/tablericons.js +95 -1
- package/dist/tablericons.tss +95 -1
- package/dist/tailwind.tss +3263 -410
- package/docs/configuring-guide.md +18 -5
- package/docs/glossary.md +3 -4
- package/docs/new-glossary.md +8313 -0
- package/docs/whats-new/v2.5.0.md +13 -13
- package/docs/whats-new/v3.0.0.md +33 -0
- package/docs/whats-new/v3.0.3.md +4 -4
- package/docs/whats-new/v3.0.4.md +244 -0
- package/docs/whats-new/v3.0.5.md +136 -0
- package/docs/whats-new/v3.1.0.md +614 -0
- package/docs/whats-new/v3.1.1.md +262 -0
- package/index.js +402 -270
- package/lib/build-tailwind.js +79 -16
- package/lib/helpers.js +2131 -767
- package/lib/templates/custom-template.tss +1 -1
- package/lib/templates/tablericons/template.js +1 -1
- package/lib/templates/tailwind/custom-template.tss +1 -1
- package/lib/templates/tailwind/template.tss +1 -1
- package/lib/test-function.js +9 -0
- package/package.json +5 -4
- package/purgetss.config.js +950 -0
- package/assets/images/icon-fonts.png +0 -0
package/.editorconfig
CHANGED
package/README.md
CHANGED
|
@@ -19,20 +19,21 @@
|
|
|
19
19
|
------
|
|
20
20
|
|
|
21
21
|
## Some key features of PurgeTSS
|
|
22
|
-
- Provides more than
|
|
22
|
+
- Provides more than 8400 [Tailwind-like utility classes](https://tailwindcss.com/) ready to use in your projects.
|
|
23
23
|
- Creates a clean `app.tss` file with only the classes used in your project by parsing all your XML files.
|
|
24
24
|
- You can customize any of the default classes through a simple configuration file, or you can create new *just-in-time* classes with arbitrary values within the `Views`.
|
|
25
|
-
- You can easily use Font Awesome, Material Design, Lineicons, Boxicons and Framework7-Icons fonts in `Buttons` and `Labels`.
|
|
25
|
+
- You can easily use Font Awesome, Material Design, Lineicons, Boxicons, Tabler Icons and Framework7-Icons fonts in `Buttons` and `Labels`.
|
|
26
26
|
- Includes an Animation module to apply a 2D Matrix animation or transformation to any element or to an `Array` of elements.
|
|
27
27
|
- Includes a simple two-dimensional Grid System to align and distribute elements in your views.
|
|
28
28
|
|
|
29
29
|
## List of available classes
|
|
30
30
|
- [tailwind.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/tailwind.tss)
|
|
31
|
-
- [lineicons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/lineicons.tss)
|
|
32
31
|
- [boxicons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/boxicons.tss)
|
|
33
32
|
- [fontawesome.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/fontawesome.tss)
|
|
34
33
|
- [framework7icons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/framework7icons.tss)
|
|
34
|
+
- [lineicons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/lineicons.tss)
|
|
35
35
|
- [materialdesignicons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/materialdesignicons.tss)
|
|
36
|
+
- [tablericons.tss](https://github.com/macCesar/purgeTSS/blob/master/dist/tablericons.tss)
|
|
36
37
|
- [Your own custom styles](https://github.com/macCesar/purgeTSS/blob/master/docs/configuring-guide.md)
|
|
37
38
|
|
|
38
39
|
# IMPORTANT NOTICE!!!
|
|
@@ -205,6 +206,7 @@ You can customize the following properties:
|
|
|
205
206
|
- Opacity
|
|
206
207
|
- Padding
|
|
207
208
|
- Placeholder Colors
|
|
209
|
+
- Shadow Colors
|
|
208
210
|
- Text Colors
|
|
209
211
|
- Tint Color
|
|
210
212
|
- Width scale
|
|
@@ -268,10 +270,10 @@ Use **`purgetss module`** command to install the `purgetss.ui.js` module in your
|
|
|
268
270
|
If you want to create a new Alloy Project with `purgetss` ready to go, use the `create` command.
|
|
269
271
|
|
|
270
272
|
```bash
|
|
271
|
-
> purgetss create 'Name of the Project' [--vendor="fontawesome, materialdesign, lineicons, boxicons, framework7"]
|
|
273
|
+
> purgetss create 'Name of the Project' [--vendor="fontawesome, materialdesign, lineicons, boxicons, framework7, tablericons"]
|
|
272
274
|
|
|
273
275
|
# alias:
|
|
274
|
-
> purgetss c 'Name of the Project' [-v=fa,md,li,bx,f7]
|
|
276
|
+
> purgetss c 'Name of the Project' [-v=fa,md,li,bx,f7,ti]
|
|
275
277
|
```
|
|
276
278
|
|
|
277
279
|
You need to have `app.idprefix` and `app.idprefix` already configured in `ti config`.
|
|
@@ -298,7 +300,7 @@ When you run `purgetss create 'Name of the Project'` it will execute the followi
|
|
|
298
300
|
- **`alloy new`** To convert it to an Alloy Project.
|
|
299
301
|
- **`purgetss w`** To autorun `purgetss` every time you compile your project.
|
|
300
302
|
- **`purgetss b`** To build a new `./purgetss/tailwind.tss` and `./purgetss/config.js` files.
|
|
301
|
-
- **`[-v=fa,md,li,bx,f7]`** Set the `--vendor` argument to copy the selected fonts into your project. Including the CommonJS module into `./app/lib/` folder.
|
|
303
|
+
- **`[-v=fa,md,li,bx,f7,ti]`** Set the `--vendor` argument to copy the selected fonts into your project. Including the CommonJS module into `./app/lib/` folder.
|
|
302
304
|
- **`code .`**, **`subl .`** or **`open .`** It will use either one of these commands to open `VS Code`, `Sublime Text` or the project’s folder in that order.
|
|
303
305
|
|
|
304
306
|
## fonts
|
|
@@ -309,7 +311,7 @@ When you run `purgetss create 'Name of the Project'` it will execute the followi
|
|
|
309
311
|
> purgetss f
|
|
310
312
|
```
|
|
311
313
|
|
|
312
|
-
Use this command to copy the free versions of [Font Awesome](https://github.com/FortAwesome/Font-Awesome/tree/master/js-packages/%40fortawesome/fontawesome-free/webfonts), [
|
|
314
|
+
Use this command to copy the free versions of [Boxicons](https://boxicons.com), [Font Awesome](https://github.com/FortAwesome/Font-Awesome/tree/master/js-packages/%40fortawesome/fontawesome-free/webfonts), [Framework7 Icons](https://framework7.io/icons/), [LineIcons](https://lineicons.com/icons/?type=free), [Material Design Icons](https://github.com/google/material-design-icons) and [Tabler Icons](https://tabler-icons.io) Fonts into your `app/assets/fonts` folder. With their names fixed to work in iOS or Android.
|
|
313
315
|
|
|
314
316
|
> boxicons.ttf
|
|
315
317
|
>
|
|
@@ -323,6 +325,8 @@ Use this command to copy the free versions of [Font Awesome](https://github.com/
|
|
|
323
325
|
>
|
|
324
326
|
> LineIcons.ttf
|
|
325
327
|
>
|
|
328
|
+
> tablericons.ttf
|
|
329
|
+
>
|
|
326
330
|
> MaterialIcons-Regular.ttf
|
|
327
331
|
>
|
|
328
332
|
> MaterialIconsOutlined-Regular.otf
|
|
@@ -373,6 +377,11 @@ After copying the desired fonts, you can use them in Buttons and Labels, just se
|
|
|
373
377
|
<Label class="mt-2 text-gray-700" text="Framework7-Icons" />
|
|
374
378
|
<Label class="text-xl text-blue-500 f7 f7-house" />
|
|
375
379
|
<Button class="w-10 h-10 my-1 text-xl text-white bg-blue-500 rounded f7 f7-house" />
|
|
380
|
+
|
|
381
|
+
<!-- Tabler-Icons -->
|
|
382
|
+
<Label class="mt-2 text-gray-700" text="Tabler-Icons" />
|
|
383
|
+
<Label class="text-xl text-blue-500 ti ti-home" />
|
|
384
|
+
<Button class="w-10 h-10 my-1 text-xl text-white bg-blue-500 rounded ti ti-home" />
|
|
376
385
|
</View>
|
|
377
386
|
</Window>
|
|
378
387
|
</Alloy>
|
|
@@ -418,19 +427,23 @@ After copying the desired fonts, you can use them in Buttons and Labels, just se
|
|
|
418
427
|
// Framework7 styles
|
|
419
428
|
'.f7': { font: { fontFamily: 'Framework7-Icons' } }
|
|
420
429
|
'.f7-house': { text: 'house', title: 'house' }
|
|
430
|
+
|
|
431
|
+
// Tabler Icons styles
|
|
432
|
+
'.ti': { font: { fontFamily: 'tabler-icons' } }
|
|
433
|
+
'.ti-home': { text: '\ueac1', title: '\ueac1' }
|
|
421
434
|
```
|
|
422
435
|
|
|
423
436
|
## Result
|
|
424
|
-
<img src="https://raw.githubusercontent.com/macCesar/purgeTSS/master/assets/images/icon-fonts.png" width="375" alt="iOS Screen - Icon Fonts">
|
|
437
|
+
<img src="https://raw.githubusercontent.com/macCesar/purgeTSS/master/assets/images/icon-fonts-tabler.png" width="375" alt="iOS Screen - Icon Fonts">
|
|
425
438
|
|
|
426
439
|
### Copying specific font vendors
|
|
427
440
|
Use any of the following arguments to copy specific vendors:
|
|
428
441
|
|
|
429
442
|
```bash
|
|
430
|
-
> purgetss fonts --vendor="fontawesome, materialdesign, lineicons, boxicons, framework7"
|
|
443
|
+
> purgetss fonts --vendor="fontawesome, materialdesign, lineicons, boxicons, framework7, tablericons"
|
|
431
444
|
|
|
432
445
|
# alias:
|
|
433
|
-
> purgetss f -v=fa,md,li,bx,f7
|
|
446
|
+
> purgetss f -v=fa,md,li,bx,f7,ti
|
|
434
447
|
```
|
|
435
448
|
|
|
436
449
|
Available aliases:
|
|
@@ -439,17 +452,18 @@ Available aliases:
|
|
|
439
452
|
- fa, font, fontawesome = Font Awesome Icons
|
|
440
453
|
- md, material, materialdesign = Material Design Icons
|
|
441
454
|
- f7, framework, framework7 = Framework7 Icons
|
|
455
|
+
- ti, tablericons, tabler = Tabler Icons
|
|
442
456
|
|
|
443
457
|
### Copying corresponding CommonJS Modules
|
|
444
458
|
You can use the `--modules` flag to copy the corresponding CommonJS modules into `./app/lib/` folder.
|
|
445
459
|
|
|
446
460
|
```bash
|
|
447
461
|
> purgetss fonts --modules
|
|
448
|
-
> purgetss fonts --modules --vendor="fontawesome, materialdesign, lineicons, boxicons, framework7"
|
|
462
|
+
> purgetss fonts --modules --vendor="fontawesome, materialdesign, lineicons, boxicons, framework7, tablericons"
|
|
449
463
|
|
|
450
464
|
# alias:
|
|
451
465
|
> purgetss f -m
|
|
452
|
-
> purgetss f -m -v=fa,md,li,bx,f7
|
|
466
|
+
> purgetss f -m -v=fa,md,li,bx,f7,ti
|
|
453
467
|
```
|
|
454
468
|
|
|
455
469
|
Each library contains a CommonJS module exposing the UniCode strings for Font Awesome icons, Material Design Icons, Line Icons Boxicons and Framework7-Icons fonts.
|
|
@@ -459,6 +473,7 @@ All prefixes are stripped out from their class names and are camelCased, for exa
|
|
|
459
473
|
- **Line Icons**: `lni-flag` becomes `flag`
|
|
460
474
|
- **Font Awesome**: `fa-flag` becomes `flag`
|
|
461
475
|
- **Material Design Icons**: `md-flag` becomes `flag`
|
|
476
|
+
- **Tabler Icons** `ti-flag` becomes `flag` or `ti-cloud-download` becomes `cloudDownload`.
|
|
462
477
|
- **Framework7 Icons** `f7-alarm_fill` becomes `alarmFill` or `f7-clock_fill` becomes `clockFill`.
|
|
463
478
|
- **boxicons** have three sets of icons in the same font file: Regular, Solid and Logos, so we need to keep their prefixes:
|
|
464
479
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/bin/purgetss
CHANGED
|
@@ -24,7 +24,7 @@ program
|
|
|
24
24
|
program
|
|
25
25
|
.command('init')
|
|
26
26
|
.alias('i')
|
|
27
|
-
.description('Create a `config.js` file for your project')
|
|
27
|
+
.description('Create a `config.js` file for your project.')
|
|
28
28
|
.help('Creates a minimal `./purgetss/config.js` file at the root of your project.')
|
|
29
29
|
.action((args, options, logger) => {
|
|
30
30
|
purgetss.init();
|
|
@@ -35,7 +35,8 @@ program
|
|
|
35
35
|
.alias('c')
|
|
36
36
|
.description('Creates a new Alloy Project with `purgetss` already configured.')
|
|
37
37
|
.help('Creates a new Alloy Project with `purgetss` already configured.')
|
|
38
|
-
.option('-
|
|
38
|
+
.option('-t, --tailwind', 'To install Tailwind CSS in your project to work with `Tailwind CSS Intellisense`.')
|
|
39
|
+
.option('-v, --vendor <arguments>', 'Use any of the following arguments to copy specific vendors:\n fa = Font Awesome Icons\n md = Material Design Icons\n li = LineIcons\n bx = Boxicons\n f7 = Framework7 Icons\n ti = Tabler Icons')
|
|
39
40
|
.argument('<name>', 'The name of the project')
|
|
40
41
|
.action((args, options, logger) => {
|
|
41
42
|
purgetss.create(args, options);
|
|
@@ -44,7 +45,7 @@ program
|
|
|
44
45
|
program
|
|
45
46
|
.command('build')
|
|
46
47
|
.alias('b')
|
|
47
|
-
.description('Build a custom `tailwind.tss` file')
|
|
48
|
+
.description('Build a custom `tailwind.tss` file.')
|
|
48
49
|
.help('It will generate a new custom `tailwind.tss` file based on the attributes defined in `./purgetss/config.js`.')
|
|
49
50
|
.action((args, options, logger) => {
|
|
50
51
|
purgetss.buildCustom();
|
|
@@ -53,7 +54,7 @@ program
|
|
|
53
54
|
program
|
|
54
55
|
.command('watch')
|
|
55
56
|
.alias('w')
|
|
56
|
-
.description('Autorun `purgetss` every time you compile your project')
|
|
57
|
+
.description('Autorun `purgetss` every time you compile your project.')
|
|
57
58
|
.help('Use this command if you want `purgetss` to autorun every time you compile your project. This is very useful in combination with `LiveView` because it will purge all your files every time you make a change, for example when adding or deleting styles in your Views.')
|
|
58
59
|
.option('-o, --off', 'To turn off watch mode.')
|
|
59
60
|
.action((args, options, logger) => {
|
|
@@ -63,9 +64,9 @@ program
|
|
|
63
64
|
program
|
|
64
65
|
.command('fonts')
|
|
65
66
|
.alias('f')
|
|
66
|
-
.description('Copy Font Awesome icons, Material Design Icons, LineIcons, Boxicons and Framework7-Icons Font files into your project')
|
|
67
|
-
.help('Command to copy the Free versions of:\n\n • Font Awesome Icons ( Brands, Regular, Solid )\n • Material Design Icons\n • LineIcons\n • Boxicons\n • Framework7 Icons\n\nInto your projects’s app/assets/fonts/ folder.\n\nWith their names fixed to work with your app whether it is for iOS or for Android.')
|
|
68
|
-
.option('-v, --vendor <arguments>', 'Use any of the following arguments to copy specific vendors:\n fa = Font Awesome Icons\n md = Material Design Icons\n li = LineIcons\n bx = Boxicons\n f7 = Framework7 Icons')
|
|
67
|
+
.description('Copy Font Awesome icons, Material Design Icons, LineIcons, Boxicons and Framework7-Icons Font files into your project.')
|
|
68
|
+
.help('Command to copy the Free versions of:\n\n • Font Awesome Icons ( Brands, Regular, Solid )\n • Material Design Icons\n • LineIcons\n • Boxicons\n • Framework7 Icons\n • Tabler Icons\n\nInto your projects’s app/assets/fonts/ folder.\n\nWith their names fixed to work with your app whether it is for iOS or for Android.')
|
|
69
|
+
.option('-v, --vendor <arguments>', 'Use any of the following arguments to copy specific vendors:\n fa = Font Awesome Icons\n md = Material Design Icons\n li = LineIcons\n bx = Boxicons\n f7 = Framework7 Icons\n ti = Tabler Icons')
|
|
69
70
|
.option('-m, --modules', 'Use the `--modules` option to also copy the corresponding CommonJS module into `./app/lib/` folder.')
|
|
70
71
|
.action((args, options, logger) => {
|
|
71
72
|
purgetss.copyFonts(options);
|
|
@@ -83,7 +84,7 @@ program
|
|
|
83
84
|
program
|
|
84
85
|
.command('update')
|
|
85
86
|
.alias('u')
|
|
86
|
-
.description('Update PurgeTSS to the latest version')
|
|
87
|
+
.description('Update PurgeTSS to the latest version.')
|
|
87
88
|
.help('Run auto-update regularly!\n\nWe constantly update PurgeTSS to add new features, to include the latest versions of Tailwind and for bug fixes.')
|
|
88
89
|
.action((args, options, logger) => {
|
|
89
90
|
logger.info(`${purgetss.colores.purgeLabel} Updating PurgeTSS to the latest version...`);
|
package/dist/boxicons.tss
CHANGED
package/dist/framework7icons.tss
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
// Font Families
|
|
5
5
|
'.f7': { font: { fontFamily: 'Framework7-Icons' } }
|
|
6
|
-
'.
|
|
6
|
+
'.f7i': { font: { fontFamily: 'Framework7-Icons' } }
|
|
7
7
|
'.framework7': { font: { fontFamily: 'Framework7-Icons' } }
|
|
8
8
|
|
|
9
9
|
// Font Sizes
|