@jesscss/style-resolver 2.0.0-alpha.7 → 2.0.0-alpha.9
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 +42 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# @jesscss/style-resolver
|
|
2
|
+
|
|
3
|
+
**Stylesheet import resolution across CSS, Less, SCSS, and Jess — include paths,
|
|
4
|
+
load paths, and extension/index resolution.**
|
|
5
|
+
|
|
6
|
+
`@jesscss/style-resolver` is a building block for
|
|
7
|
+
[Jess](https://github.com/jesscss/jess). Given a stylesheet's source and an import statement, it
|
|
8
|
+
figures out which file that import actually points to, applying each language's
|
|
9
|
+
lookup rules (Less and SCSS candidate expansion, partials, index files, search
|
|
10
|
+
paths).
|
|
11
|
+
|
|
12
|
+
It handles the mechanics of finding imports — extracting import statements from
|
|
13
|
+
source, expanding a bare import path into the ordered list of candidate files a
|
|
14
|
+
given language would try, and resolving that against a filesystem-like interface.
|
|
15
|
+
|
|
16
|
+
## Where it fits
|
|
17
|
+
|
|
18
|
+
Import resolution is a shared concern the compiler and tooling both need. It is
|
|
19
|
+
also one of the building blocks toward the broader module/scoping story on the
|
|
20
|
+
Jess roadmap (whose headline is the post-`.jess` minimal browser build) — but this
|
|
21
|
+
package is just the resolver, not that feature.
|
|
22
|
+
|
|
23
|
+
## Who uses it
|
|
24
|
+
|
|
25
|
+
This is an internal package. Most people should install
|
|
26
|
+
[`jess`](https://www.npmjs.com/package/jess) and use the `jess` CLI.
|
|
27
|
+
The JavaScript/TypeScript API is **not yet stabilized** and is intentionally
|
|
28
|
+
undocumented for now.
|
|
29
|
+
|
|
30
|
+
## Status
|
|
31
|
+
|
|
32
|
+
Alpha. Published to npm under both the `latest` and `alpha` dist-tags. Please
|
|
33
|
+
[report bugs](https://github.com/jesscss/jess/issues).
|
|
34
|
+
|
|
35
|
+
## Links
|
|
36
|
+
|
|
37
|
+
- Repository: <https://github.com/jesscss/jess>
|
|
38
|
+
- Documentation: <https://jesscss.github.io/> (currently pre-alpha content)
|
|
39
|
+
|
|
40
|
+
## License
|
|
41
|
+
|
|
42
|
+
[MIT](https://github.com/jesscss/jess/blob/dev/LICENSE)
|