Skip to content

css cascade layers polyfill #244

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 43 commits into from
May 12, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
c0db55d
initial commit
oluoluoxenfree Feb 11, 2022
f46bc47
tidying up
oluoluoxenfree Feb 11, 2022
233b186
cascade layers tests
romainmenke Feb 23, 2022
0d4e001
add test index
romainmenke Feb 23, 2022
fcc7761
Merge pull request #1 from csstools/cascade-layers-tests--resourceful…
oluoluoxenfree Feb 23, 2022
98671bd
barebones start
oluoluoxenfree Feb 25, 2022
194881f
replace anon layers
oluoluoxenfree Mar 8, 2022
1dddaa5
First walkthrough, initializing data model
sanajaved7 Mar 14, 2022
aeacdca
Merge pull request #3 from oddbird/data-model
Mar 14, 2022
c355643
Handling nested layers (#4)
Mar 22, 2022
6589bdf
cascade layers : linting and a few fixes
romainmenke Mar 22, 2022
abefae9
more fixes
romainmenke Mar 22, 2022
e1e6d5e
adding unlayered styles to data model
oluoluoxenfree Mar 22, 2022
31f73a8
add suggested code
oluoluoxenfree Mar 24, 2022
f924f0b
Merge remote-tracking branch 'upstream/main' into cascade-layers
oluoluoxenfree Mar 25, 2022
43f066f
Merge remote-tracking branch 'oddbird/cascade-layers' into cascade-la…
romainmenke Mar 27, 2022
cee8ce4
more tweaks
romainmenke Mar 27, 2022
28a1f90
Merge pull request #5 from csstools/cascade-layers-a-few-tweaks--intu…
oluoluoxenfree Mar 28, 2022
b2c3f60
formatting
jgerigmeyer Mar 31, 2022
19e733c
review
jgerigmeyer Mar 31, 2022
5e23a16
Merge branch 'cascade-layers' into transform-unlayered-styles
oluoluoxenfree Apr 5, 2022
4717b98
fix test
oluoluoxenfree Apr 5, 2022
c129d95
add additional test for unlayered styles
oluoluoxenfree Apr 5, 2022
4543413
change rule
oluoluoxenfree Apr 5, 2022
3e444a8
changing color of rule to see if it's interfering
oluoluoxenfree Apr 6, 2022
d4815ed
test changes
oluoluoxenfree Apr 6, 2022
5c1611e
cascade layers : fix tests
romainmenke Apr 6, 2022
7ed012e
Merge pull request #7 from csstools/cascade-layers--fix-tests--dilige…
oluoluoxenfree Apr 6, 2022
7750237
Merge pull request #6 from oddbird/transform-unlayered-styles
oluoluoxenfree Apr 6, 2022
27c309d
first attempt
oluoluoxenfree Apr 20, 2022
a8568ad
implement specificity adjustments and rule re-ordering
romainmenke Apr 22, 2022
af210fa
cleanup
romainmenke Apr 23, 2022
0f35db2
cleanup
romainmenke Apr 23, 2022
7ae107c
cleanup
romainmenke Apr 23, 2022
c282abe
cleanup
romainmenke Apr 24, 2022
e068bfa
cleanup
romainmenke Apr 26, 2022
96a01ae
Apply suggestions from code review
romainmenke Apr 28, 2022
c3cc5c8
lint
romainmenke Apr 28, 2022
a970660
Merge pull request #9 from csstools/transform-layered-styles
oluoluoxenfree May 2, 2022
6bdefb8
cascade layers : important (#10)
romainmenke May 9, 2022
bac0abd
Conditional layer ordering warning name change (#11)
May 9, 2022
3acf84b
Updating docs and warning for @import (#12)
May 11, 2022
71d037b
Merge branch 'main' into cascade-layers
sanajaved7 May 12, 2022
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
319 changes: 203 additions & 116 deletions package-lock.json

Large diffs are not rendered by default.

7 changes: 7 additions & 0 deletions plugins/postcss-cascade-layers/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
node_modules
dist
package-lock.json
yarn.lock
*.log*
*.result.css
*.result.css.map
1 change: 1 addition & 0 deletions plugins/postcss-cascade-layers/.nvmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
v16.13.1
47 changes: 47 additions & 0 deletions plugins/postcss-cascade-layers/.tape.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
import postcssTape from '../../packages/postcss-tape/dist/index.mjs';
import plugin from '@csstools/postcss-cascade-layers';

postcssTape(plugin)({
basic: {
message: "supports basic usage",
},
'basic:color': {
message: "supports { color: '<a color>' }",
options: {
color: 'purple'
}
},
atrules: {
message: "supports @keyframes usage",
},
nested: {
message: "supports nested layer usage",
},
'nested-complex': {
message: "supports nested layer usage",
},
important: {
message: "supports important usage",
},
'anon-layer': {
message: "supports anonymous layer usage",
},
'examples/example': {
message: "minimal example",
},
'unlayered-styles': {
message: 'supports unlayered styles alongside layers',
},
'invalid-rules': {
message: 'correctly handles invalid rules',
},
'warnings': {
message: 'correctly handles warnings',
options: {
onRevertLayerKeyword: 'warn',
onConditionalRulesChangingLayerOrder: 'warn',
onImportLayerRule: 'warn'
},
warnings: 3,
}
});
1 change: 1 addition & 0 deletions plugins/postcss-cascade-layers/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Changes to PostCSS Base Plugin
176 changes: 176 additions & 0 deletions plugins/postcss-cascade-layers/INSTALL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,176 @@
# Installing PostCSS Cascade Layers

[PostCSS Cascade Layers] runs in all Node environments, with special instructions for:

| [Node](#node) | [PostCSS CLI](#postcss-cli) | [Webpack](#webpack) | [Create React App](#create-react-app) | [Gulp](#gulp) | [Grunt](#grunt) |
| --- | --- | --- | --- | --- | --- |

## Node

Add [PostCSS Cascade Layers] to your project:

```bash
npm install postcss @csstools/postcss-cascade-layers --save-dev
```

Use it as a [PostCSS] plugin:

```js
const postcss = require('postcss');
const postcssCascadeLayers = require('@csstools/postcss-cascade-layers');

postcss([
postcssCascadeLayers(/* pluginOptions */)
]).process(YOUR_CSS /*, processOptions */);
```

## PostCSS CLI

Add [PostCSS CLI] to your project:

```bash
npm install postcss-cli @csstools/postcss-cascade-layers --save-dev
```

Use [PostCSS Cascade Layers] in your `postcss.config.js` configuration file:

```js
const postcssCascadeLayers = require('@csstools/postcss-cascade-layers');

module.exports = {
plugins: [
postcssCascadeLayers(/* pluginOptions */)
]
}
```

## Webpack

_Webpack version 5_

Add [PostCSS Loader] to your project:

```bash
npm install postcss-loader @csstools/postcss-cascade-layers --save-dev
```

Use [PostCSS Cascade Layers] in your Webpack configuration:

```js
module.exports = {
module: {
rules: [
{
test: /\.css$/i,
use: [
"style-loader",
{
loader: "css-loader",
options: { importLoaders: 1 },
},
{
loader: "postcss-loader",
options: {
postcssOptions: {
plugins: [
[
"@csstools/postcss-cascade-layers",
{
// Options
},
],
],
},
},
},
],
},
],
},
};
```

## Create React App

Add [React App Rewired] and [React App Rewire PostCSS] to your project:

```bash
npm install react-app-rewired react-app-rewire-postcss @csstools/postcss-cascade-layers --save-dev
```

Use [React App Rewire PostCSS] and [PostCSS Cascade Layers] in your
`config-overrides.js` file:

```js
const reactAppRewirePostcss = require('react-app-rewire-postcss');
const postcssCascadeLayers = require('@csstools/postcss-cascade-layers');

module.exports = config => reactAppRewirePostcss(config, {
plugins: () => [
postcssCascadeLayers(/* pluginOptions */)
]
});
```

## Gulp

Add [Gulp PostCSS] to your project:

```bash
npm install gulp-postcss @csstools/postcss-cascade-layers --save-dev
```

Use [PostCSS Cascade Layers] in your Gulpfile:

```js
const postcss = require('gulp-postcss');
const postcssCascadeLayers = require('@csstools/postcss-cascade-layers');

gulp.task('css', function () {
var plugins = [
postcssCascadeLayers(/* pluginOptions */)
];

return gulp.src('./src/*.css')
.pipe(postcss(plugins))
.pipe(gulp.dest('.'));
});
```

## Grunt

Add [Grunt PostCSS] to your project:

```bash
npm install grunt-postcss @csstools/postcss-cascade-layers --save-dev
```

Use [PostCSS Cascade Layers] in your Gruntfile:

```js
const postcssCascadeLayers = require('@csstools/postcss-cascade-layers');

grunt.loadNpmTasks('grunt-postcss');

grunt.initConfig({
postcss: {
options: {
processors: [
postcssCascadeLayers(/* pluginOptions */)
]
},
dist: {
src: '*.css'
}
}
});
```

[Gulp PostCSS]: https://github.com/postcss/gulp-postcss
[Grunt PostCSS]: https://github.com/nDmitry/grunt-postcss
[PostCSS]: https://github.com/postcss/postcss
[PostCSS CLI]: https://github.com/postcss/postcss-cli
[PostCSS Loader]: https://github.com/postcss/postcss-loader
[PostCSS Cascade Layers]: https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-cascade-layers
[React App Rewire PostCSS]: https://github.com/csstools/react-app-rewire-postcss
[React App Rewired]: https://github.com/timarney/react-app-rewired
108 changes: 108 additions & 0 deletions plugins/postcss-cascade-layers/LICENSE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
# CC0 1.0 Universal

## Statement of Purpose

The laws of most jurisdictions throughout the world automatically confer
exclusive Copyright and Related Rights (defined below) upon the creator and
subsequent owner(s) (each and all, an “owner”) of an original work of
authorship and/or a database (each, a “Work”).

Certain owners wish to permanently relinquish those rights to a Work for the
purpose of contributing to a commons of creative, cultural and scientific works
(“Commons”) that the public can reliably and without fear of later claims of
infringement build upon, modify, incorporate in other works, reuse and
redistribute as freely as possible in any form whatsoever and for any purposes,
including without limitation commercial purposes. These owners may contribute
to the Commons to promote the ideal of a free culture and the further
production of creative, cultural and scientific works, or to gain reputation or
greater distribution for their Work in part through the use and efforts of
others.

For these and/or other purposes and motivations, and without any expectation of
additional consideration or compensation, the person associating CC0 with a
Work (the “Affirmer”), to the extent that he or she is an owner of Copyright
and Related Rights in the Work, voluntarily elects to apply CC0 to the Work and
publicly distribute the Work under its terms, with knowledge of his or her
Copyright and Related Rights in the Work and the meaning and intended legal
effect of CC0 on those rights.

1. Copyright and Related Rights. A Work made available under CC0 may be
protected by copyright and related or neighboring rights (“Copyright and
Related Rights”). Copyright and Related Rights include, but are not limited
to, the following:
1. the right to reproduce, adapt, distribute, perform, display, communicate,
and translate a Work;
2. moral rights retained by the original author(s) and/or performer(s);
3. publicity and privacy rights pertaining to a person’s image or likeness
depicted in a Work;
4. rights protecting against unfair competition in regards to a Work,
subject to the limitations in paragraph 4(i), below;
5. rights protecting the extraction, dissemination, use and reuse of data in
a Work;
6. database rights (such as those arising under Directive 96/9/EC of the
European Parliament and of the Council of 11 March 1996 on the legal
protection of databases, and under any national implementation thereof,
including any amended or successor version of such directive); and
7. other similar, equivalent or corresponding rights throughout the world
based on applicable law or treaty, and any national implementations
thereof.

2. Waiver. To the greatest extent permitted by, but not in contravention of,
applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
unconditionally waives, abandons, and surrenders all of Affirmer’s Copyright
and Related Rights and associated claims and causes of action, whether now
known or unknown (including existing as well as future claims and causes of
action), in the Work (i) in all territories worldwide, (ii) for the maximum
duration provided by applicable law or treaty (including future time
extensions), (iii) in any current or future medium and for any number of
copies, and (iv) for any purpose whatsoever, including without limitation
commercial, advertising or promotional purposes (the “Waiver”). Affirmer
makes the Waiver for the benefit of each member of the public at large and
to the detriment of Affirmer’s heirs and successors, fully intending that
such Waiver shall not be subject to revocation, rescission, cancellation,
termination, or any other legal or equitable action to disrupt the quiet
enjoyment of the Work by the public as contemplated by Affirmer’s express
Statement of Purpose.

3. Public License Fallback. Should any part of the Waiver for any reason be
judged legally invalid or ineffective under applicable law, then the Waiver
shall be preserved to the maximum extent permitted taking into account
Affirmer’s express Statement of Purpose. In addition, to the extent the
Waiver is so judged Affirmer hereby grants to each affected person a
royalty-free, non transferable, non sublicensable, non exclusive,
irrevocable and unconditional license to exercise Affirmer’s Copyright and
Related Rights in the Work (i) in all territories worldwide, (ii) for the
maximum duration provided by applicable law or treaty (including future time
extensions), (iii) in any current or future medium and for any number of
copies, and (iv) for any purpose whatsoever, including without limitation
commercial, advertising or promotional purposes (the “License”). The License
shall be deemed effective as of the date CC0 was applied by Affirmer to the
Work. Should any part of the License for any reason be judged legally
invalid or ineffective under applicable law, such partial invalidity or
ineffectiveness shall not invalidate the remainder of the License, and in
such case Affirmer hereby affirms that he or she will not (i) exercise any
of his or her remaining Copyright and Related Rights in the Work or (ii)
assert any associated claims and causes of action with respect to the Work,
in either case contrary to Affirmer’s express Statement of Purpose.

4. Limitations and Disclaimers.
1. No trademark or patent rights held by Affirmer are waived, abandoned,
surrendered, licensed or otherwise affected by this document.
2. Affirmer offers the Work as-is and makes no representations or warranties
of any kind concerning the Work, express, implied, statutory or
otherwise, including without limitation warranties of title,
merchantability, fitness for a particular purpose, non infringement, or
the absence of latent or other defects, accuracy, or the present or
absence of errors, whether or not discoverable, all to the greatest
extent permissible under applicable law.
3. Affirmer disclaims responsibility for clearing rights of other persons
that may apply to the Work or any use thereof, including without
limitation any person’s Copyright and Related Rights in the Work.
Further, Affirmer disclaims responsibility for obtaining any necessary
consents, permissions or other rights required for any use of the Work.
4. Affirmer understands and acknowledges that Creative Commons is not a
party to this document and has no duty or obligation with respect to this
CC0 or use of the Work.

For more information, please see
http://creativecommons.org/publicdomain/zero/1.0/.
Loading