mirror of https://github.com/vuejs/vitepress
Evorp
3 days ago
committed by
GitHub
commit
c4466b97df
@ -0,0 +1,77 @@
|
||||
// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
|
||||
|
||||
exports[`node/postcss/isolateStyles > transforms selectors and skips keyframes 1`] = `
|
||||
"
|
||||
/* simple classes */
|
||||
.example:not(:where(.vp-raw, .vp-raw *)) { color: red; }
|
||||
.class-a:not(:where(.vp-raw, .vp-raw *)) { color: coral; }
|
||||
.class-b:not(:where(.vp-raw, .vp-raw *)) { color: deepskyblue; }
|
||||
|
||||
/* escaped colon in class */
|
||||
.baz\\:not\\(.bar\\):not(:where(.vp-raw, .vp-raw *)) { display: block; }
|
||||
.disabled\\:opacity-50:not(:where(.vp-raw, .vp-raw *)):disabled { opacity: .5; }
|
||||
|
||||
/* pseudos (class + element) */
|
||||
.button:not(:where(.vp-raw, .vp-raw *)):hover { color: pink; }
|
||||
.button:not(:where(.vp-raw, .vp-raw *)):focus:hover { color: hotpink; }
|
||||
.item:not(:where(.vp-raw, .vp-raw *))::before { content: '•'; }
|
||||
:not(:where(.vp-raw, .vp-raw *))::first-letter { color: pink; }
|
||||
:not(:where(.vp-raw, .vp-raw *))::before { content: ''; }
|
||||
|
||||
/* universal + :not */
|
||||
*:not(:where(.vp-raw, .vp-raw *)) { background-color: red; }
|
||||
*:not(:where(.vp-raw, .vp-raw *)):not(.b) { text-transform: uppercase; }
|
||||
|
||||
/* combinators */
|
||||
.foo:hover .bar:not(:where(.vp-raw, .vp-raw *)) { background: blue; }
|
||||
ul > li.active:not(:where(.vp-raw, .vp-raw *)) { color: green; }
|
||||
a + b ~ c:not(:where(.vp-raw, .vp-raw *)) { color: orange; }
|
||||
|
||||
/* ids + attribute selectors */
|
||||
#wow:not(:where(.vp-raw, .vp-raw *)) { color: yellow; }
|
||||
[data-world] .d:not(:where(.vp-raw, .vp-raw *)) { padding: 10px 20px; }
|
||||
|
||||
/* :root and chained tags */
|
||||
:not(:where(.vp-raw, .vp-raw *)):root { --bs-blue: #0d6efd; }
|
||||
:root .a:not(:where(.vp-raw, .vp-raw *)) { --bs-green: #bada55; }
|
||||
html:not(:where(.vp-raw, .vp-raw *)) { margin: 0; }
|
||||
body:not(:where(.vp-raw, .vp-raw *)) { padding: 0; }
|
||||
html body div:not(:where(.vp-raw, .vp-raw *)) { color: blue; }
|
||||
|
||||
/* grouping with commas */
|
||||
.a:not(:where(.vp-raw, .vp-raw *)), .b:not(:where(.vp-raw, .vp-raw *)) { color: red; }
|
||||
|
||||
/* multiple repeated groups to ensure stability */
|
||||
.a:not(:where(.vp-raw, .vp-raw *)), .b:not(:where(.vp-raw, .vp-raw *)) { color: coral; }
|
||||
.a:not(:where(.vp-raw, .vp-raw *)) { animation: glow 1s linear infinite alternate; }
|
||||
|
||||
/* nested blocks */
|
||||
.foo:not(:where(.vp-raw, .vp-raw *)) {
|
||||
svg:not(:where(.vp-raw, .vp-raw *)) { display: none; }
|
||||
.bar:not(:where(.vp-raw, .vp-raw *)) { display: inline; }
|
||||
}
|
||||
|
||||
/* standalone pseudos */
|
||||
:not(:where(.vp-raw, .vp-raw *)):first-child { color: pink; }
|
||||
:not(:where(.vp-raw, .vp-raw *)):hover { color: blue; }
|
||||
:not(:where(.vp-raw, .vp-raw *)):active { color: red; }
|
||||
|
||||
/* keyframes (should be ignored) */
|
||||
@keyframes fade {
|
||||
from { opacity: 0; }
|
||||
to { opacity: 1; }
|
||||
}
|
||||
@-webkit-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
@-moz-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
@-o-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
"
|
||||
`;
|
||||
@ -1,44 +1,93 @@
|
||||
import {
|
||||
postcssIsolateStyles,
|
||||
splitSelectorPseudo
|
||||
} from 'node/postcss/isolateStyles'
|
||||
|
||||
// helper to run plugin transform on selector
|
||||
function apply(
|
||||
prefixPlugin: ReturnType<typeof postcssIsolateStyles>,
|
||||
selector: string
|
||||
) {
|
||||
// `prepare` is available on the runtime plugin but missing from the types, thus cast to `any`
|
||||
const { Rule } = (prefixPlugin as any).prepare({
|
||||
root: { source: { input: { file: 'foo/base.css' } } }
|
||||
})
|
||||
const rule = { selectors: [selector] }
|
||||
Rule(rule, { result: {} })
|
||||
return rule.selectors[0]
|
||||
import { postcssIsolateStyles } from 'node/postcss/isolateStyles'
|
||||
import postcss from 'postcss'
|
||||
|
||||
const INPUT_CSS = `
|
||||
/* simple classes */
|
||||
.example { color: red; }
|
||||
.class-a { color: coral; }
|
||||
.class-b { color: deepskyblue; }
|
||||
|
||||
/* escaped colon in class */
|
||||
.baz\\:not\\(.bar\\) { display: block; }
|
||||
.disabled\\:opacity-50:disabled { opacity: .5; }
|
||||
|
||||
/* pseudos (class + element) */
|
||||
.button:hover { color: pink; }
|
||||
.button:focus:hover { color: hotpink; }
|
||||
.item::before { content: '•'; }
|
||||
::first-letter { color: pink; }
|
||||
::before { content: ''; }
|
||||
|
||||
/* universal + :not */
|
||||
* { background-color: red; }
|
||||
*:not(.b) { text-transform: uppercase; }
|
||||
|
||||
/* combinators */
|
||||
.foo:hover .bar { background: blue; }
|
||||
ul > li.active { color: green; }
|
||||
a + b ~ c { color: orange; }
|
||||
|
||||
/* ids + attribute selectors */
|
||||
#wow { color: yellow; }
|
||||
[data-world] .d { padding: 10px 20px; }
|
||||
|
||||
/* :root and chained tags */
|
||||
:root { --bs-blue: #0d6efd; }
|
||||
:root .a { --bs-green: #bada55; }
|
||||
html { margin: 0; }
|
||||
body { padding: 0; }
|
||||
html body div { color: blue; }
|
||||
|
||||
/* grouping with commas */
|
||||
.a, .b { color: red; }
|
||||
|
||||
/* multiple repeated groups to ensure stability */
|
||||
.a, .b { color: coral; }
|
||||
.a { animation: glow 1s linear infinite alternate; }
|
||||
|
||||
/* nested blocks */
|
||||
.foo {
|
||||
svg { display: none; }
|
||||
.bar { display: inline; }
|
||||
}
|
||||
|
||||
describe('node/postcss/isolateStyles', () => {
|
||||
const plugin = postcssIsolateStyles()
|
||||
/* standalone pseudos */
|
||||
:first-child { color: pink; }
|
||||
:hover { color: blue; }
|
||||
:active { color: red; }
|
||||
|
||||
test('splitSelectorPseudo skips escaped colon', () => {
|
||||
const input = '.foo\\:bar'
|
||||
const [selector, pseudo] = splitSelectorPseudo(input)
|
||||
expect(selector).toBe(input)
|
||||
expect(pseudo).toBe('')
|
||||
})
|
||||
/* keyframes (should be ignored) */
|
||||
@keyframes fade {
|
||||
from { opacity: 0; }
|
||||
to { opacity: 1; }
|
||||
}
|
||||
@-webkit-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
@-moz-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
@-o-keyframes glow {
|
||||
from { color: coral; }
|
||||
to { color: red; }
|
||||
}
|
||||
`
|
||||
|
||||
test('splitSelectorPseudo splits on pseudo selectors', () => {
|
||||
const input = '.button:hover'
|
||||
const [selector, pseudo] = splitSelectorPseudo(input)
|
||||
expect(selector).toBe('.button')
|
||||
expect(pseudo).toBe(':hover')
|
||||
describe('node/postcss/isolateStyles', () => {
|
||||
test('transforms selectors and skips keyframes', () => {
|
||||
const out = run(INPUT_CSS)
|
||||
expect(out.css).toMatchSnapshot()
|
||||
})
|
||||
|
||||
it('postcssIsolateStyles inserts :not(...) in the right place', () => {
|
||||
const input = '.disabled\\:opacity-50:disabled'
|
||||
const result = apply(plugin, input)
|
||||
expect(result).toBe(
|
||||
'.disabled\\:opacity-50:not(:where(.vp-raw, .vp-raw *)):disabled'
|
||||
)
|
||||
test('idempotent (running twice produces identical CSS)', () => {
|
||||
const first = run(INPUT_CSS).css
|
||||
const second = run(first).css
|
||||
expect(second).toBe(first)
|
||||
})
|
||||
})
|
||||
|
||||
function run(css: string, from = 'src/styles/vp-doc.css') {
|
||||
return postcss([postcssIsolateStyles()]).process(css, { from })
|
||||
}
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,21 +1,38 @@
|
||||
import postcssPrefixSelector from 'postcss-prefix-selector'
|
||||
import type { Plugin } from 'postcss'
|
||||
import selectorParser from 'postcss-selector-parser'
|
||||
|
||||
export function postcssIsolateStyles(
|
||||
options: Parameters<typeof postcssPrefixSelector>[0] = {}
|
||||
): ReturnType<typeof postcssPrefixSelector> {
|
||||
return postcssPrefixSelector({
|
||||
prefix: ':not(:where(.vp-raw, .vp-raw *))',
|
||||
includeFiles: [/base\.css/],
|
||||
transform(prefix, _selector) {
|
||||
// split selector from its pseudo part if the trailing colon is not escaped
|
||||
const [selector, pseudo] = splitSelectorPseudo(_selector)
|
||||
return selector + prefix + pseudo
|
||||
},
|
||||
...options
|
||||
})
|
||||
type Options = {
|
||||
includeFiles?: RegExp[]
|
||||
ignoreFiles?: RegExp[]
|
||||
prefix?: string
|
||||
}
|
||||
|
||||
export function splitSelectorPseudo(selector: string): [string, string] {
|
||||
const [base, pseudo = ''] = selector.split(/(?<!\\)(:\S*)$/)
|
||||
return [base, pseudo]
|
||||
export function postcssIsolateStyles({
|
||||
includeFiles = [/vp-doc\.css/, /base\.css/],
|
||||
ignoreFiles,
|
||||
prefix = ':not(:where(.vp-raw, .vp-raw *))'
|
||||
}: Options = {}): Plugin {
|
||||
const prefixNodes = selectorParser().astSync(prefix).first.nodes
|
||||
|
||||
return /* prettier-ignore */ {
|
||||
postcssPlugin: 'postcss-isolate-styles',
|
||||
Once(root) {
|
||||
const file = root.source?.input.file
|
||||
if (file && includeFiles?.length && !includeFiles.some((re) => re.test(file))) return
|
||||
if (file && ignoreFiles?.length && ignoreFiles.some((re) => re.test(file))) return
|
||||
|
||||
root.walkRules((rule) => {
|
||||
if (!rule.selector || rule.selector.includes(prefix)) return
|
||||
if (rule.parent?.type === 'atrule' && /\bkeyframes$/i.test(rule.parent.name)) return
|
||||
|
||||
rule.selector = selectorParser((selectors) => {
|
||||
selectors.each((sel) => {
|
||||
if (!sel.nodes.length) return
|
||||
const insertionIndex = sel.nodes.findLastIndex((n) => n.type !== 'pseudo') + 1
|
||||
sel.nodes.splice(insertionIndex, 0, ...prefixNodes.map((n) => n.clone() as any))
|
||||
})
|
||||
}).processSync(rule.selector)
|
||||
})
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Loading…
Reference in new issue