@jesscss/plugin-less 2.0.0-alpha.7 → 2.0.0-alpha.8
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 +48 -2
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,3 +1,49 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @jesscss/plugin-less
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**The Less language engine for Jess — the Less parser wired in with Less v5
|
|
4
|
+
rendering defaults.**
|
|
5
|
+
|
|
6
|
+
This is the one shipping surface today. [Jess](https://github.com/jesscss/jess)
|
|
7
|
+
*is* Less.js v5, and `plugin-less` is where that lives: it layers the Less
|
|
8
|
+
grammar (`@jesscss/less-parser`) onto the Jess compiler, registers the Less
|
|
9
|
+
built-in functions (`@jesscss/fns`), and sets the v5 output defaults. The `jess`
|
|
10
|
+
and `lessc` CLIs load it by default, so if you render `.less` you are already
|
|
11
|
+
using it — you don't need to install this package separately for normal CLI use.
|
|
12
|
+
|
|
13
|
+
## What it does
|
|
14
|
+
|
|
15
|
+
- Parses `.less` into the Jess AST and hands it to the engine for a single
|
|
16
|
+
evaluate-and-emit pass.
|
|
17
|
+
- Registers the Less/Sass style-function library so `lighten()`, `percentage()`,
|
|
18
|
+
string and list helpers, etc. are available during evaluation.
|
|
19
|
+
- Owns the **Less v5 output defaults** — the single source of truth the `lessc`
|
|
20
|
+
CLI imports so CLI and engine defaults can never drift.
|
|
21
|
+
|
|
22
|
+
## Less v5 output defaults
|
|
23
|
+
|
|
24
|
+
The defaults this plugin applies:
|
|
25
|
+
|
|
26
|
+
- `collapseNesting: false` — **nesting is preserved by default.** Less 4.x
|
|
27
|
+
flattened selectors; in v5 that flattening is an explicit opt-in
|
|
28
|
+
(`--collapse-nesting` on the CLI).
|
|
29
|
+
- `mathMode: 'parens-division'`, `unitMode: 'preserve'`, `equalityMode: 'less'`,
|
|
30
|
+
`leakyScope: true`, `bubbleRootAtRules: true`.
|
|
31
|
+
|
|
32
|
+
These keep the Less 4.x command surface (flags, stdin/stdout, exit codes) while
|
|
33
|
+
producing Less **v5** output semantics.
|
|
34
|
+
|
|
35
|
+
## Status
|
|
36
|
+
|
|
37
|
+
**Alpha.** This is the **"Now" / Less.js tier** — the earned, shipping-today
|
|
38
|
+
surface. It is real and renders real Less, but it is early software with known
|
|
39
|
+
rendering gaps and expected failures; don't ship it to production yet, and please
|
|
40
|
+
[report bugs](https://github.com/jesscss/jess/issues).
|
|
41
|
+
|
|
42
|
+
The programmatic plugin/compiler API is **not yet stabilized** — the `jess` /
|
|
43
|
+
`lessc` CLIs are the public surface for the alpha. Watch the
|
|
44
|
+
[docs site](https://jesscss.github.io/) for the API once it settles.
|
|
45
|
+
|
|
46
|
+
- Project overview & positioning: <https://github.com/jesscss/jess#readme>
|
|
47
|
+
- Docs: <https://jesscss.github.io/> (currently pre-alpha content)
|
|
48
|
+
- Issues: <https://github.com/jesscss/jess/issues>
|
|
49
|
+
- License: MIT
|
package/package.json
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
7
7
|
"description": "A Less stylesheet engine for Jess",
|
|
8
|
-
"version": "2.0.0-alpha.
|
|
8
|
+
"version": "2.0.0-alpha.8",
|
|
9
9
|
"main": "lib/index.cjs",
|
|
10
10
|
"types": "lib/index.d.ts",
|
|
11
11
|
"exports": {
|
|
@@ -20,11 +20,11 @@
|
|
|
20
20
|
"lib"
|
|
21
21
|
],
|
|
22
22
|
"dependencies": {
|
|
23
|
-
"@jesscss/core": "2.0.0-alpha.
|
|
24
|
-
"@jesscss/fns": "2.0.0-alpha.
|
|
25
|
-
"@jesscss/
|
|
26
|
-
"@jesscss/
|
|
27
|
-
"styles-config": "2.0.0-alpha.
|
|
23
|
+
"@jesscss/core": "2.0.0-alpha.8",
|
|
24
|
+
"@jesscss/fns": "2.0.0-alpha.8",
|
|
25
|
+
"@jesscss/style-resolver": "2.0.0-alpha.8",
|
|
26
|
+
"@jesscss/less-parser": "2.0.0-alpha.8",
|
|
27
|
+
"styles-config": "2.0.0-alpha.8"
|
|
28
28
|
},
|
|
29
29
|
"devDependencies": {},
|
|
30
30
|
"author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
|