diff --git a/package-lock.json b/package-lock.json index 9f2851ff51..780b767147 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10458,7 +10458,8 @@ "dependencies": { "@csstools/css-parser-algorithms": "^4.0.2", "@csstools/css-tokenizer": "^4.0.2", - "@csstools/postcss-private-rule": "^1.0.3" + "@csstools/custom-function-parser": "^1.0.0", + "@csstools/utilities-for-private-properties": "^0.0.0" }, "devDependencies": { "@csstools/postcss-tape": "*", diff --git a/packages/utilities-for-private-properties/CHANGELOG.md b/packages/utilities-for-private-properties/CHANGELOG.md index 5598130a40..f766e5c9fb 100644 --- a/packages/utilities-for-private-properties/CHANGELOG.md +++ b/packages/utilities-for-private-properties/CHANGELOG.md @@ -3,3 +3,5 @@ ### Unreleased (major) - Initial version +- Add an explicit scope for substituted nodes +- Add a `preserve` option that keeps `@private` rules diff --git a/packages/utilities-for-private-properties/README.md b/packages/utilities-for-private-properties/README.md index 5f2a8a4a03..b3786641ff 100644 --- a/packages/utilities-for-private-properties/README.md +++ b/packages/utilities-for-private-properties/README.md @@ -27,6 +27,17 @@ const registrations = transpiler.transpile(root.nodes); root.append(...registrations); ``` +Nodes that are substituted into a style rule but are not its children, for example the contents of +an `@contents` block, can be transpiled in the scope of that style rule: + +```ts +transpiler.transpile(nodes, { scope: styleRule }); +``` + +With `preserve: true` the `@private` rules are kept and references inside `@apply` and `@contents` +blocks are left alone. Transpiled declarations are still hoisted, so the original notation keeps +working where `@private` is supported. + `@property` rules are only hoisted out of `@layer`, `@media` and `@supports` group rules. Registrations inside `@container`, `@scope` or `@starting-style` are left untouched, because those conditions cannot be preserved at the top level. [cli-url]: https://github.com/csstools/postcss-plugins/actions/workflows/test.yml?query=workflow/test diff --git a/packages/utilities-for-private-properties/dist/index.d.ts b/packages/utilities-for-private-properties/dist/index.d.ts index 1b04b82b0d..f2e22ca86c 100644 --- a/packages/utilities-for-private-properties/dist/index.d.ts +++ b/packages/utilities-for-private-properties/dist/index.d.ts @@ -1,5 +1,6 @@ import type { AtRule } from 'postcss'; import type { ChildNode } from 'postcss'; +import type { Rule } from 'postcss'; /** * Create a transpiler for private custom properties. @@ -10,6 +11,17 @@ import type { ChildNode } from 'postcss'; */ export declare function createPrivatePropertyTranspiler(options?: PrivatePropertyTranspilerOptions): PrivatePropertyTranspiler; +export declare type PrivatePropertyTranspileOptions = { + /** + * Style rule that owns the private property names of `nodes`. + * + * Use this when `nodes` are substituted into a style rule but are not its + * direct children, for example a `@contents` block that is authored at an + * `@apply` site and placed inside a mixin body. + */ + scope?: Rule; +}; + export declare type PrivatePropertyTranspiler = { /** * Transpile private rules and private property references in `nodes`. @@ -17,7 +29,7 @@ export declare type PrivatePropertyTranspiler = { * Mutates `nodes` in place and returns the `@property` rules that must be * appended to the root of the tree. */ - transpile: (nodes: Array) => Array; + transpile: (nodes: Array, options?: PrivatePropertyTranspileOptions) => Array; }; export declare type PrivatePropertyTranspilerOptions = { @@ -33,6 +45,14 @@ export declare type PrivatePropertyTranspilerOptions = { * private properties. */ allowUntranspiledMixins?: boolean; + /** + * Keep `@private` rules and leave references inside `@apply` and `@contents` + * blocks alone. + * + * Transpiled declarations are still hoisted, so the original notation keeps + * working where `@private` is supported. + */ + preserve?: boolean; }; export { } diff --git a/packages/utilities-for-private-properties/dist/index.mjs b/packages/utilities-for-private-properties/dist/index.mjs index 05bb553c18..c7a02d274d 100644 --- a/packages/utilities-for-private-properties/dist/index.mjs +++ b/packages/utilities-for-private-properties/dist/index.mjs @@ -1 +1 @@ -import{tokenize as e,isTokenIdent as t,mutateIdent as r,isTokenColon as n,isTokenDelim as s}from"@csstools/css-tokenizer";import{parseListOfComponentValues as i,walk as a,isTokenNode as o,stringify as l,isFunctionNode as p,isWhiteSpaceOrCommentNode as u,isSimpleBlockNode as c}from"@csstools/css-parser-algorithms";import{generateUniqueDashedIdent as f,hashFileBasenameAndDir as m}from"@csstools/generate-idents";import{collectPropertyRegistrations as y,registeredCustomPropertyNames as h,rewriteCustomPropertyNames as v,wrapInConditionalGroupRules as d}from"@csstools/utilities-for-property-registrations";const P=/\b(var|if|style|inherit)\(/i,R=/^apply$/i,N=/^container$/i,g=/^contents$/i,S=/^function$/i,$=/^inherit$/i,k=/^keyframes$/i,w=/^layer$/i,x=/^media$/i,C=/^mixin$/i,D=/^(container|layer|media|scope|starting-style|supports)$/i,A=/^private$/i,M=/^(transition|transition-property)$/i,F=/^property$/i,W=/^style$/i,U=/^supports$/i,G=/^var$/i;class Transpiler{privatePropertyNames=new WeakMap;skippedStyleRules=new WeakSet;counter=0;namespace;allowUntranspiledMixins;propertyRegistrations=[];constructor(e){this.namespace=e?.namespace||"p",this.allowUntranspiledMixins=!0===e?.allowUntranspiledMixins}transpile(e){this.collectSkippedStyleRules(e);for(const t of e)"atrule"===t.type&&A.test(t.name)&&this.transpilePrivateRule(t),isContainer(t)&&t.walkAtRules(A,e=>this.transpilePrivateRule(e));for(const t of e)"decl"!==t.type?isContainer(t)&&t.walkDecls(e=>this.transpileDeclaration(e)):this.transpileDeclaration(t);for(const t of e)"atrule"!==t.type?isContainer(t)&&t.walkAtRules(e=>this.transpileContainerRule(e)):this.transpileContainerRule(t);const t=this.propertyRegistrations;return this.propertyRegistrations=[],t}transpilePrivateRule(e){const t=findStyleRule(e);if(!t||this.isSkipped(e))return;const r=this.privatePropertyNamesForRule(t);this.hoistPrivatePropertyRegistrations(e,r),this.cleanPrivateRule(e,r),e.nodes?.length?(e.before(e.nodes.map(e=>e.clone())),this.removePrivateRule(e,t)):this.removePrivateRule(e,t)}collectSkippedStyleRules(e){const t=[];for(const r of e)"rule"===r.type&&t.push(r),isContainer(r)&&r.walkRules(e=>{t.push(e)});for(const e of t){if(isInsideMixinOrFunction(e)){this.skipStyleRule(e);continue}if(!this.allowUntranspiledMixins&&hasUntranspiledMixin(e)){this.skipStyleRule(e);continue}let t=!1;e.walkAtRules(A,r=>{if(t)return;if(findStyleRule(r)!==e)return;const n=y(r,{isConditionalGroupRule:()=>!1,shouldDescendInto:canContainPrivateContents});for(const{propertyRule:e}of n)if(h(e).length&®istrationWrappers(e).hasAnonymousLayer)return void(t=!0)}),t&&this.skipStyleRule(e)}}skipStyleRule(e){this.skippedStyleRules.add(e);for(const t of styleRuleAncestors(e))this.skippedStyleRules.add(t)}isSkipped(e){for(const t of styleRuleAncestors(e))if(this.skippedStyleRules.has(t))return!0;return!1}hoistPrivatePropertyRegistrations(e,t){const r=y(e,{isConditionalGroupRule:()=>!1,shouldDescendInto:canContainPrivateContents});for(const{propertyRule:e}of r){const r=e.clone(),n=v(r,e=>`${t.prefix}${e}`);if(!n)continue;const{wrappers:s}=registrationWrappers(e);e.remove();for(const e of n)t.names.add(e);this.propertyRegistrations.push(...d([r],s))}}privatePropertyNamesForRule(e){const t=this.privatePropertyNames.get(e);if(t)return t;const r={prefix:f(this.namespace,m(e.source?.input.from),this.counter.toString(36)),names:new Set};return this.counter++,this.privatePropertyNames.set(e,r),r}prefixForPropertyName(e,t){if(this.isSkipped(e))return!1;for(const r of styleRuleAncestors(e)){const e=this.privatePropertyNames.get(r);if(e?.names.has(t))return e.prefix}return!1}hasPrivatePropertyNames(e){if(this.isSkipped(e))return!1;for(const t of styleRuleAncestors(e))if(this.privatePropertyNames.get(t)?.names.size)return!0;return!1}cleanPrivateRule(e,t){this.cleanPrivateRuleNodes(e,t),removeEmptyNestedGroupRules(e)}cleanPrivateRuleNodes(e,t){const r=e.nodes||[];for(let e=r.length-1;e>=0;e--){const n=r[e];if("decl"===n.type){const e=unescapedPropertyName(n.prop);if(null===e){n.remove();continue}t.names.add(e),n.prop=`${t.prefix}${n.prop}`;continue}"atrule"===n.type&&F.test(n.name)||("atrule"===n.type&&D.test(n.name)&&n.nodes?this.cleanPrivateRuleNodes(n,t):n.remove())}}removePrivateRule(e,t){let r=e.parent;for(e.remove();r&&r!==t;){const e=r.parent;if("atrule"===r.type){const e=r;!D.test(e.name)||w.test(e.name)||e.nodes?.length||e.remove()}r=e}}transpileDeclaration(e){this.transpileDeclarationPropertyName(e),M.test(e.prop)&&this.transpilePropertyListValue(e),this.transpileDeclarationValue(e)}transpilePropertyListValue(n){if(!n.value.includes("--"))return;if(!this.hasPrivatePropertyNames(n))return;const s=i(e({css:n.value}));let p=!1;a(s,e=>{if(!o(e.node)||!t(e.node.value))return;const s=e.node.value[4].value;if(!s.startsWith("--"))return;const i=this.prefixForPropertyName(n,s);i&&(r(e.node.value,`${i}${s}`),p=!0)}),p&&(n.value=l([s]))}transpileDeclarationPropertyName(e){if(!e.variable)return;const t=unescapedPropertyName(e.prop);if(null===t)return;const r=this.prefixForPropertyName(e,t);r&&(e.prop=`${r}${e.prop}`)}transpileDeclarationValue(t){if(!P.test(t.value))return;if(!this.hasPrivatePropertyNames(t))return;const r=i(e({css:t.value}));this.rewritePrivateReferences(r,t)&&(t.value=l([r]))}transpileContainerRule(t){if(!N.test(t.name))return;if(!t.params.includes("--"))return;if(!this.hasPrivatePropertyNames(t))return;const r=i(e({css:t.params}));this.rewritePrivateReferences(r,t)&&(t.params=l([r]))}rewritePrivateReferences(e,t){let r=!1;return a(e,e=>{if(!p(e.node))return;const n=e.node.getName();W.test(n)?r=this.rewriteStyleQuery(e.node.value,t)||r:(G.test(n)||$.test(n))&&(r=this.rewritePrivatePropertyName(e.node,t)||r)}),r}rewriteStyleQuery(e,r){let i=!1,a=-1,l=-1;const p=[];for(let t=0;t"===e||"="===e}function canContainPrivateContents(e){return!!e.nodes&&D.test(e.name)}function hasUntranspiledMixin(e){let t=!1;return e.walkAtRules(e=>{(R.test(e.name)||g.test(e.name))&&(t=!0)}),t}function isInsideMixinOrFunction(e){let t=e.parent;for(;t;){if("atrule"===t.type&&(C.test(t.name)||S.test(t.name)))return!0;t=t.parent}return!1}function registrationWrappers(e){const t=[];let r=!1,n=e.parent;for(;n;){if("atrule"===n.type){const e=n;w.test(e.name)?e.params.trim()?t.unshift(e):r=!0:(x.test(e.name)||U.test(e.name))&&t.unshift(e)}n=n.parent}return{wrappers:t,hasAnonymousLayer:r}}function removeEmptyNestedGroupRules(e){const t=e.nodes||[];for(let e=t.length-1;e>=0;e--){const r=t[e];"atrule"===r.type&&D.test(r.name)&&(removeEmptyNestedGroupRules(r),w.test(r.name)||r.nodes?.length||r.remove())}}function unescapedPropertyName(r){const n=e({css:r})[0];if(!n||!t(n))return null;const s=n[4].value;return"--"!==s&&s.startsWith("--")?s:null}function isContainer(e){return"rule"===e.type||"atrule"===e.type}function findStyleRule(e,t=!1){if(!e.parent)return!1;if("rule"===e.parent.type){const t=e.parent;return("atrule"!==t.parent?.type||!k.test(t.parent.name))&&t}if("atrule"===e.parent.type){const r=e.parent;if(D.test(r.name)||t&&(R.test(r.name)||g.test(r.name)))return findStyleRule(r,t)}return!1}function styleRuleAncestors(e){const t=[];let r=e;for(;;){const e=findStyleRule(r,!0);if(!e)break;t.push(e),r=e}return t}function createPrivatePropertyTranspiler(e){const t=new Transpiler(e);return{transpile:e=>t.transpile(e)}}export{createPrivatePropertyTranspiler}; +import{tokenize as e,isTokenIdent as t,mutateIdent as r,isTokenColon as s,isTokenDelim as n}from"@csstools/css-tokenizer";import{parseListOfComponentValues as i,walk as o,isTokenNode as a,stringify as l,isFunctionNode as p,isWhiteSpaceOrCommentNode as u,isSimpleBlockNode as c}from"@csstools/css-parser-algorithms";import{generateUniqueDashedIdent as f,hashFileBasenameAndDir as h}from"@csstools/generate-idents";import{collectPropertyRegistrations as m,registeredCustomPropertyNames as y,rewriteCustomPropertyNames as v,wrapInConditionalGroupRules as d}from"@csstools/utilities-for-property-registrations";const R=/\b(var|if|style|inherit)\(/i,P=/^apply$/i,N=/^container$/i,w=/^contents$/i,S=/^function$/i,k=/^inherit$/i,g=/^keyframes$/i,$=/^layer$/i,C=/^media$/i,x=/^mixin$/i,D=/^(container|layer|media|scope|starting-style|supports)$/i,F=/^private$/i,A=/^(transition|transition-property)$/i,M=/^property$/i,W=/^style$/i,b=/^supports$/i,G=/^var$/i;class Transpiler{privatePropertyNames=new WeakMap;processedPrivateRules=new WeakSet;skippedStyleRules=new WeakSet;counter=0;namespace;allowUntranspiledMixins;preserve;propertyRegistrations=[];scope;scopeRules=new Set;constructor(e){this.namespace=e?.namespace||"p",this.allowUntranspiledMixins=!0===e?.allowUntranspiledMixins,this.preserve=!0===e?.preserve}transpile(e,t){const r=this.scope,s=this.scopeRules;this.scope=t?.scope,this.scopeRules=collectRules(e);try{this.collectSkippedStyleRules(e);const t=[];for(const r of e)"atrule"===r.type&&F.test(r.name)&&t.push(...this.transpilePrivateRule(r)),isContainer(r)&&r.walkAtRules(F,e=>{t.push(...this.transpilePrivateRule(e))});for(const t of e)"decl"!==t.type?isContainer(t)&&t.walkDecls(e=>this.transpileDeclaration(e)):this.transpileDeclaration(t);for(const e of t)this.transpileDeclaration(e);for(const t of e)"atrule"!==t.type?isContainer(t)&&t.walkAtRules(e=>this.transpileContainerRule(e)):this.transpileContainerRule(t);const r=this.propertyRegistrations;return this.propertyRegistrations=[],r}finally{this.scope=r,this.scopeRules=s}}transpilePrivateRule(e){const t=this.ownerFor(e);if(!t||this.isSkipped(e)||this.processedPrivateRules.has(e))return[];this.processedPrivateRules.add(e);const r=this.privatePropertyNamesForRule(t);if(this.hoistPrivatePropertyRegistrations(e,r),this.preserve){const t=e.clone();this.cleanPrivateRule(t,r),t.walkAtRules(M,e=>{e.remove()}),removeEmptyNestedGroupRules(t);const s=(t.nodes||[]).map(e=>e.clone());return s.length&&e.before(s),s.filter(e=>"decl"===e.type)}if(this.cleanPrivateRule(e,r),!e.nodes?.length)return this.removePrivateRule(e,t),[];const s=e.nodes.map(e=>e.clone());return e.before(s),this.removePrivateRule(e,t),s.filter(e=>"decl"===e.type)}collectSkippedStyleRules(e){const t=[];for(const r of e)"rule"===r.type&&t.push(r),isContainer(r)&&r.walkRules(e=>{t.push(e)});for(const e of t){if(isInsideMixinOrFunction(e)){this.skipStyleRule(e);continue}if(!this.allowUntranspiledMixins&&hasUntranspiledMixin(e)){this.skipStyleRule(e);continue}let t=!1;e.walkAtRules(F,r=>{if(t)return;if(findStyleRule(r)!==e)return;const s=m(r,{isConditionalGroupRule:()=>!1,shouldDescendInto:canContainPrivateContents});for(const{propertyRule:e}of s)if(y(e).length&®istrationWrappers(e).hasAnonymousLayer)return void(t=!0)}),t&&this.skipStyleRule(e)}}skipStyleRule(e){this.skippedStyleRules.add(e);for(const t of styleRuleAncestors(e))this.skippedStyleRules.add(t)}ownerFor(e){const t=findStyleRule(e);return this.scope?t&&this.scopeRules.has(t)?t:this.scope:t}styleRuleChain(e){const t=[];let r=e,s=!1;for(;;){const e=findStyleRule(r,!this.preserve);if(!e)break;!this.scope||s||this.scopeRules.has(e)?(t.push(e),r=e):(s=!0,t.push(this.scope),r=this.scope)}return t}isSkipped(e){for(const t of this.styleRuleChain(e))if(this.skippedStyleRules.has(t))return!0;return!1}hoistPrivatePropertyRegistrations(e,t){const r=m(e,{isConditionalGroupRule:()=>!1,shouldDescendInto:canContainPrivateContents});for(const{propertyRule:e}of r){const r=e.clone(),s=v(r,e=>`${t.prefix}${e}`);if(!s)continue;const{wrappers:n}=registrationWrappers(e);this.preserve||e.remove();for(const e of s)t.names.add(e);this.propertyRegistrations.push(...d([r],n))}}privatePropertyNamesForRule(e){const t=this.privatePropertyNames.get(e);if(t)return t;const r={prefix:f(this.namespace,h(e.source?.input.from),this.counter.toString(36)),names:new Set};return this.counter++,this.privatePropertyNames.set(e,r),r}prefixForPropertyName(e,t){if(this.isSkipped(e))return!1;for(const r of this.styleRuleChain(e)){const e=this.privatePropertyNames.get(r);if(e?.names.has(t))return e.prefix}return!1}hasPrivatePropertyNames(e){if(this.isSkipped(e))return!1;for(const t of this.styleRuleChain(e))if(this.privatePropertyNames.get(t)?.names.size)return!0;return!1}cleanPrivateRule(e,t){this.cleanPrivateRuleNodes(e,t),removeEmptyNestedGroupRules(e)}cleanPrivateRuleNodes(e,t){const r=e.nodes||[];for(let e=r.length-1;e>=0;e--){const s=r[e];if("decl"===s.type){const e=unescapedPropertyName(s.prop);if(null===e){s.remove();continue}t.names.add(e),s.prop=`${t.prefix}${s.prop}`;continue}"atrule"===s.type&&M.test(s.name)||("atrule"===s.type&&D.test(s.name)&&s.nodes?this.cleanPrivateRuleNodes(s,t):s.remove())}}removePrivateRule(e,t){let r=e.parent;for(e.remove();r&&r!==t;){const e=r.parent;if("atrule"===r.type){const e=r;!D.test(e.name)||$.test(e.name)||e.nodes?.length||e.remove()}r=e}}transpileDeclaration(e){this.transpileDeclarationPropertyName(e),A.test(e.prop)&&this.transpilePropertyListValue(e),this.transpileDeclarationValue(e)}transpilePropertyListValue(s){if(!s.value.includes("--"))return;if(!this.hasPrivatePropertyNames(s))return;const n=i(e({css:s.value}));let p=!1;o(n,e=>{if(!a(e.node)||!t(e.node.value))return;const n=e.node.value[4].value;if(!n.startsWith("--"))return;const i=this.prefixForPropertyName(s,n);i&&(r(e.node.value,`${i}${n}`),p=!0)}),p&&(s.value=l([n]))}transpileDeclarationPropertyName(e){if(!e.variable)return;const t=unescapedPropertyName(e.prop);if(null===t)return;const r=this.prefixForPropertyName(e,t);r&&(e.prop=`${r}${e.prop}`)}transpileDeclarationValue(t){if(!R.test(t.value))return;if(!this.hasPrivatePropertyNames(t))return;const r=i(e({css:t.value}));this.rewritePrivateReferences(r,t)&&(t.value=l([r]))}transpileContainerRule(t){if(!N.test(t.name))return;if(!t.params.includes("--"))return;if(!this.hasPrivatePropertyNames(t))return;const r=i(e({css:t.params}));this.rewritePrivateReferences(r,t)&&(t.params=l([r]))}rewritePrivateReferences(e,t){let r=!1;return o(e,e=>{if(!p(e.node))return;const s=e.node.getName();W.test(s)?r=this.rewriteStyleQuery(e.node.value,t)||r:(G.test(s)||k.test(s))&&(r=this.rewritePrivatePropertyName(e.node,t)||r)}),r}rewriteStyleQuery(e,r){let i=!1,o=-1,l=-1;const p=[];for(let t=0;t"===e||"="===e}function canContainPrivateContents(e){return!!e.nodes&&D.test(e.name)}function hasUntranspiledMixin(e){let t=!1;return e.walkAtRules(e=>{(P.test(e.name)||w.test(e.name))&&(t=!0)}),t}function isInsideMixinOrFunction(e){let t=e.parent;for(;t;){if("atrule"===t.type&&(x.test(t.name)||S.test(t.name)))return!0;t=t.parent}return!1}function registrationWrappers(e){const t=[];let r=!1,s=e.parent;for(;s;){if("atrule"===s.type){const e=s;$.test(e.name)?e.params.trim()?t.unshift(e):r=!0:(C.test(e.name)||b.test(e.name))&&t.unshift(e)}s=s.parent}return{wrappers:t,hasAnonymousLayer:r}}function removeEmptyNestedGroupRules(e){const t=e.nodes||[];for(let e=t.length-1;e>=0;e--){const r=t[e];"atrule"===r.type&&D.test(r.name)&&(removeEmptyNestedGroupRules(r),$.test(r.name)||r.nodes?.length||r.remove())}}function unescapedPropertyName(r){const s=e({css:r})[0];if(!s||!t(s))return null;const n=s[4].value;return"--"!==n&&n.startsWith("--")?n:null}function isContainer(e){return"rule"===e.type||"atrule"===e.type}function collectRules(e){const t=new Set;for(const r of e)"rule"===r.type&&t.add(r),isContainer(r)&&r.walkRules(e=>{t.add(e)});return t}function findStyleRule(e,t=!1){if(!e.parent)return!1;if("rule"===e.parent.type){const t=e.parent;return("atrule"!==t.parent?.type||!g.test(t.parent.name))&&t}if("atrule"===e.parent.type){const r=e.parent;if(D.test(r.name)||t&&(P.test(r.name)||w.test(r.name)))return findStyleRule(r,t)}return!1}function styleRuleAncestors(e){const t=[];let r=e;for(;;){const e=findStyleRule(r,!0);if(!e)break;t.push(e),r=e}return t}function createPrivatePropertyTranspiler(e){const t=new Transpiler(e);return{transpile:(e,r)=>t.transpile(e,r)}}export{createPrivatePropertyTranspiler}; diff --git a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.api.json b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.api.json index 6188f27401..d94eb5515b 100644 --- a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.api.json +++ b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.api.json @@ -234,6 +234,41 @@ ], "name": "createPrivatePropertyTranspiler" }, + { + "kind": "TypeAlias", + "canonicalReference": "@csstools/utilities-for-private-properties!PrivatePropertyTranspileOptions:type", + "docComment": "", + "excerptTokens": [ + { + "kind": "Content", + "text": "export type PrivatePropertyTranspileOptions = " + }, + { + "kind": "Content", + "text": "{\n scope?: " + }, + { + "kind": "Reference", + "text": "Rule", + "canonicalReference": "postcss!Rule_:class" + }, + { + "kind": "Content", + "text": ";\n}" + }, + { + "kind": "Content", + "text": ";" + } + ], + "fileUrlPath": "dist/_types/transpiler.d.ts", + "releaseTag": "Public", + "name": "PrivatePropertyTranspileOptions", + "typeTokenRange": { + "startIndex": 1, + "endIndex": 4 + } + }, { "kind": "TypeAlias", "canonicalReference": "@csstools/utilities-for-private-properties!PrivatePropertyTranspiler:type", @@ -263,7 +298,16 @@ }, { "kind": "Content", - "text": ">) => " + "text": ">, options?: " + }, + { + "kind": "Reference", + "text": "PrivatePropertyTranspileOptions", + "canonicalReference": "@csstools/utilities-for-private-properties!PrivatePropertyTranspileOptions:type" + }, + { + "kind": "Content", + "text": ") => " }, { "kind": "Reference", @@ -293,7 +337,7 @@ "name": "PrivatePropertyTranspiler", "typeTokenRange": { "startIndex": 1, - "endIndex": 10 + "endIndex": 12 } }, { @@ -307,7 +351,7 @@ }, { "kind": "Content", - "text": "{\n namespace?: string;\n allowUntranspiledMixins?: boolean;\n}" + "text": "{\n namespace?: string;\n allowUntranspiledMixins?: boolean;\n preserve?: boolean;\n}" }, { "kind": "Content", diff --git a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.md b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.md index 39ae9963d2..5a58b552b8 100644 --- a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.md +++ b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.md @@ -47,6 +47,15 @@ Description +[PrivatePropertyTranspileOptions](./utilities-for-private-properties.privatepropertytranspileoptions.md) + + + + + + + + [PrivatePropertyTranspiler](./utilities-for-private-properties.privatepropertytranspiler.md) diff --git a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileoptions.md b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileoptions.md new file mode 100644 index 0000000000..8dd8d32ebb --- /dev/null +++ b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileoptions.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [@csstools/utilities-for-private-properties](./utilities-for-private-properties.md) > [PrivatePropertyTranspileOptions](./utilities-for-private-properties.privatepropertytranspileoptions.md) + +## PrivatePropertyTranspileOptions type + +**Signature:** + +```typescript +export type PrivatePropertyTranspileOptions = { + scope?: Rule; +}; +``` diff --git a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspiler.md b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspiler.md index 4ecbdf9a7b..a0334b9598 100644 --- a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspiler.md +++ b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspiler.md @@ -8,6 +8,8 @@ ```typescript export type PrivatePropertyTranspiler = { - transpile: (nodes: Array) => Array; + transpile: (nodes: Array, options?: PrivatePropertyTranspileOptions) => Array; }; ``` +**References:** [PrivatePropertyTranspileOptions](./utilities-for-private-properties.privatepropertytranspileoptions.md) + diff --git a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileroptions.md b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileroptions.md index 339ff5d0e0..18d5c81308 100644 --- a/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileroptions.md +++ b/packages/utilities-for-private-properties/docs/utilities-for-private-properties.privatepropertytranspileroptions.md @@ -10,5 +10,6 @@ export type PrivatePropertyTranspilerOptions = { namespace?: string; allowUntranspiledMixins?: boolean; + preserve?: boolean; }; ``` diff --git a/packages/utilities-for-private-properties/src/index.ts b/packages/utilities-for-private-properties/src/index.ts index 28714aaa88..4499092414 100644 --- a/packages/utilities-for-private-properties/src/index.ts +++ b/packages/utilities-for-private-properties/src/index.ts @@ -1,8 +1,8 @@ import type { AtRule, ChildNode } from 'postcss'; -import type { PrivatePropertyTranspilerOptions } from './transpiler'; +import type { PrivatePropertyTranspileOptions, PrivatePropertyTranspilerOptions } from './transpiler'; import { Transpiler } from './transpiler'; -export type { PrivatePropertyTranspilerOptions } from './transpiler'; +export type { PrivatePropertyTranspileOptions, PrivatePropertyTranspilerOptions } from './transpiler'; export type PrivatePropertyTranspiler = { /** @@ -11,7 +11,7 @@ export type PrivatePropertyTranspiler = { * Mutates `nodes` in place and returns the `@property` rules that must be * appended to the root of the tree. */ - transpile: (nodes: Array) => Array, + transpile: (nodes: Array, options?: PrivatePropertyTranspileOptions) => Array, }; /** @@ -25,8 +25,8 @@ export function createPrivatePropertyTranspiler(options?: PrivatePropertyTranspi const transpiler = new Transpiler(options); return { - transpile(nodes: Array): Array { - return transpiler.transpile(nodes); + transpile(nodes: Array, transpileOptions?: PrivatePropertyTranspileOptions): Array { + return transpiler.transpile(nodes, transpileOptions); }, }; } diff --git a/packages/utilities-for-private-properties/src/transpiler.ts b/packages/utilities-for-private-properties/src/transpiler.ts index 0ef655abd9..9d8c67ae29 100644 --- a/packages/utilities-for-private-properties/src/transpiler.ts +++ b/packages/utilities-for-private-properties/src/transpiler.ts @@ -37,6 +37,25 @@ export type PrivatePropertyTranspilerOptions = { * private properties. */ allowUntranspiledMixins?: boolean, + /** + * Keep `@private` rules and leave references inside `@apply` and `@contents` + * blocks alone. + * + * Transpiled declarations are still hoisted, so the original notation keeps + * working where `@private` is supported. + */ + preserve?: boolean, +}; + +export type PrivatePropertyTranspileOptions = { + /** + * Style rule that owns the private property names of `nodes`. + * + * Use this when `nodes` are substituted into a style rule but are not its + * direct children, for example a `@contents` block that is authored at an + * `@apply` site and placed inside a mixin body. + */ + scope?: Rule, }; type RulePrivatePropertyNames = { @@ -47,6 +66,8 @@ type RulePrivatePropertyNames = { export class Transpiler { private privatePropertyNames: WeakMap = new WeakMap(); + private processedPrivateRules: WeakSet = new WeakSet(); + private skippedStyleRules: WeakSet = new WeakSet(); private counter = 0; @@ -55,72 +76,122 @@ export class Transpiler { private allowUntranspiledMixins: boolean; + private preserve: boolean; + private propertyRegistrations: Array = []; + private scope: Rule | undefined; + + private scopeRules: Set = new Set(); + constructor(options?: PrivatePropertyTranspilerOptions) { this.namespace = options?.namespace || 'p'; this.allowUntranspiledMixins = options?.allowUntranspiledMixins === true; + this.preserve = options?.preserve === true; } - transpile(nodes: Array): Array { - this.collectSkippedStyleRules(nodes); + transpile(nodes: Array, options?: PrivatePropertyTranspileOptions): Array { + const previousScope = this.scope; + const previousScopeRules = this.scopeRules; - for (const node of nodes) { - if (node.type === 'atrule' && IS_PRIVATE_RULE_REGEX.test(node.name)) { - this.transpilePrivateRule(node); - } + this.scope = options?.scope; + this.scopeRules = collectRules(nodes); - if (isContainer(node)) { - node.walkAtRules(IS_PRIVATE_RULE_REGEX, (atRule) => this.transpilePrivateRule(atRule)); - } - } + try { + this.collectSkippedStyleRules(nodes); - for (const node of nodes) { - if (node.type === 'decl') { - this.transpileDeclaration(node); - continue; + // Hoisted declarations can be inserted next to `nodes`, outside the + // subtree that is walked below. Keep them so their values are still + // rewritten against the correct scope. + const hoisted: Array = []; + + for (const node of nodes) { + if (node.type === 'atrule' && IS_PRIVATE_RULE_REGEX.test(node.name)) { + hoisted.push(...this.transpilePrivateRule(node)); + } + + if (isContainer(node)) { + node.walkAtRules(IS_PRIVATE_RULE_REGEX, (atRule) => { + hoisted.push(...this.transpilePrivateRule(atRule)); + }); + } } - if (isContainer(node)) { - node.walkDecls((decl) => this.transpileDeclaration(decl)); + for (const node of nodes) { + if (node.type === 'decl') { + this.transpileDeclaration(node); + continue; + } + + if (isContainer(node)) { + node.walkDecls((decl) => this.transpileDeclaration(decl)); + } } - } - for (const node of nodes) { - if (node.type === 'atrule') { - this.transpileContainerRule(node); - continue; + for (const declaration of hoisted) { + this.transpileDeclaration(declaration); } - if (isContainer(node)) { - node.walkAtRules((atRule) => this.transpileContainerRule(atRule)); + for (const node of nodes) { + if (node.type === 'atrule') { + this.transpileContainerRule(node); + continue; + } + + if (isContainer(node)) { + node.walkAtRules((atRule) => this.transpileContainerRule(atRule)); + } } - } - const registrations = this.propertyRegistrations; - this.propertyRegistrations = []; - return registrations; + const registrations = this.propertyRegistrations; + this.propertyRegistrations = []; + return registrations; + } finally { + this.scope = previousScope; + this.scopeRules = previousScopeRules; + } } - private transpilePrivateRule(atRule: AtRule): void { - const styleRule = findStyleRule(atRule); - if (!styleRule || this.isSkipped(atRule)) { - return; + private transpilePrivateRule(atRule: AtRule): Array { + const styleRule = this.ownerFor(atRule); + if (!styleRule || this.isSkipped(atRule) || this.processedPrivateRules.has(atRule)) { + return []; } + this.processedPrivateRules.add(atRule); + const rulePrivatePropertyNames = this.privatePropertyNamesForRule(styleRule); this.hoistPrivatePropertyRegistrations(atRule, rulePrivatePropertyNames); + if (this.preserve) { + const clone = atRule.clone(); + this.cleanPrivateRule(clone, rulePrivatePropertyNames); + clone.walkAtRules(IS_PROPERTY_RULE_REGEX, (propertyRule) => { + propertyRule.remove(); + }); + removeEmptyNestedGroupRules(clone); + + const hoisted = (clone.nodes || []).map((node) => node.clone()); + if (hoisted.length) { + atRule.before(hoisted); + } + + return hoisted.filter((node): node is Declaration => node.type === 'decl'); + } + this.cleanPrivateRule(atRule, rulePrivatePropertyNames); if (!atRule.nodes?.length) { this.removePrivateRule(atRule, styleRule); - return; + return []; } - atRule.before(atRule.nodes.map((node) => node.clone())); + const hoisted = atRule.nodes.map((node) => node.clone()); + atRule.before(hoisted); this.removePrivateRule(atRule, styleRule); + + return hoisted.filter((node): node is Declaration => node.type === 'decl'); } /** @@ -196,8 +267,51 @@ export class Transpiler { } } + private ownerFor(node: Node): false | Rule { + const owner = findStyleRule(node); + + if (!this.scope) { + return owner; + } + + if (!owner || !this.scopeRules.has(owner)) { + return this.scope; + } + + return owner; + } + + /** + * The style rule chain for a node, using the explicit scope when the node is + * outside the subtree that was passed to `transpile`. + */ + private styleRuleChain(node: Node): Array { + const rules: Array = []; + let focus: Node = node; + let usedScope = false; + + while (true) { + const styleRule = findStyleRule(focus, !this.preserve); + if (!styleRule) { + break; + } + + if (this.scope && !usedScope && !this.scopeRules.has(styleRule)) { + usedScope = true; + rules.push(this.scope); + focus = this.scope; + continue; + } + + rules.push(styleRule); + focus = styleRule; + } + + return rules; + } + private isSkipped(node: Node): boolean { - for (const styleRule of styleRuleAncestors(node)) { + for (const styleRule of this.styleRuleChain(node)) { if (this.skippedStyleRules.has(styleRule)) { return true; } @@ -221,7 +335,9 @@ export class Transpiler { const { wrappers } = registrationWrappers(propertyRule); - propertyRule.remove(); + if (!this.preserve) { + propertyRule.remove(); + } for (const name of originalNames) { rulePrivatePropertyNames.names.add(name); @@ -253,7 +369,7 @@ export class Transpiler { return false; } - for (const styleRule of styleRuleAncestors(node)) { + for (const styleRule of this.styleRuleChain(node)) { const rulePrivatePropertyNames = this.privatePropertyNames.get(styleRule); if (rulePrivatePropertyNames?.names.has(propertyName)) { return rulePrivatePropertyNames.prefix; @@ -268,7 +384,7 @@ export class Transpiler { return false; } - for (const styleRule of styleRuleAncestors(node)) { + for (const styleRule of this.styleRuleChain(node)) { if (this.privatePropertyNames.get(styleRule)?.names.size) { return true; } @@ -679,6 +795,25 @@ function isContainer(node: ChildNode): node is Rule | AtRule { return node.type === 'rule' || node.type === 'atrule'; } +/** Every style rule in `nodes`, including the nodes themselves. */ +function collectRules(nodes: Array): Set { + const rules: Set = new Set(); + + for (const node of nodes) { + if (node.type === 'rule') { + rules.add(node); + } + + if (isContainer(node)) { + node.walkRules((rule) => { + rules.add(rule); + }); + } + } + + return rules; +} + function findStyleRule(node: Node, transparentMixins = false): false | Rule { if (!node.parent) { return false; diff --git a/packages/utilities-for-private-properties/test/test.mjs b/packages/utilities-for-private-properties/test/test.mjs index 5c859217c3..cb6d7cd559 100644 --- a/packages/utilities-for-private-properties/test/test.mjs +++ b/packages/utilities-for-private-properties/test/test.mjs @@ -460,6 +460,79 @@ test('property registrations', async (t) => { assert.ok(first[0].params.startsWith(prefix('0', 'm'))); assert.ok(second[0].params.startsWith(prefix('1', 'm'))); }); + + await t.test('uses an explicit scope for references in a subtree', () => { + const root = postcss.parse('.a { @private { --x: 1px; } & .tmp { color: var(--x); } }', { from }); + const transpiler = createPrivatePropertyTranspiler({}); + + transpiler.transpile([root.first]); + transpiler.transpile(root.first.last.nodes, { scope: root.first }); + + assert.equal(root.toString(), `.a { ${prefix()}--x: 1px; & .tmp { color: var(${prefix()}--x); } }`); + }); + + await t.test('uses an explicit scope for private rules in a subtree', () => { + const root = postcss.parse('.a { @private { --x: 1px; } & .tmp { @private { --y: 2px; } color: var(--x) var(--y); } }', { from }); + const transpiler = createPrivatePropertyTranspiler({}); + + transpiler.transpile(root.first.last.nodes, { scope: root.first }); + transpiler.transpile([root.first]); + + assert.equal(root.toString(), `.a { ${prefix()}--x: 1px; & .tmp { ${prefix()}--y: 2px; color: var(${prefix()}--x) var(${prefix()}--y); } }`); + }); + + await t.test('rewrites values of declarations hoisted out of a flat node list', () => { + const root = postcss.parse('.a { @private { --y: 1px; } & .tmp { } }', { from }); + const transpiler = createPrivatePropertyTranspiler({}); + + transpiler.transpile([root.first]); + root.first.last.append(postcss.parse('@private { --x: var(--y); }').first); + transpiler.transpile(root.first.last.nodes, { scope: root.first }); + + assert.equal(root.toString(), `.a { ${prefix()}--y: 1px; & .tmp { ${prefix()}--x: var(${prefix()}--y) } }`); + }); + + await t.test('keeps a nested rule scope inside the subtree', () => { + const outer = prefix('0'); + const inner = prefix('1'); + + const root = postcss.parse('.a { @private { --x: 1px; } & .tmp { & .inner { @private { --y: 2px; } color: var(--y); } } }', { from }); + const transpiler = createPrivatePropertyTranspiler({}); + + transpiler.transpile([root.first]); + transpiler.transpile(root.first.last.nodes, { scope: root.first }); + + assert.equal(root.toString(), `.a { ${outer}--x: 1px; & .tmp { & .inner { ${inner}--y: 2px; color: var(${inner}--y); } } }`); + }); +}); + +test('preserve', async (t) => { + await t.test('keeps private rules and hoists declarations', () => { + const p = prefix(); + + assert.equal( + transpile('.a { @private { --x: 1px; } width: var(--x); }', { preserve: true }), + `.a { ${p}--x: 1px; @private { --x: 1px; } width: var(${p}--x); }`, + ); + }); + + await t.test('keeps registrations inside private rules', () => { + const p = prefix(); + + assert.equal( + transpile('.a { @private { @property --x : 1px; } width: var(--x); }', { preserve: true }), + `.a { @private { @property --x : 1px; } width: var(${p}--x); } @property ${p}--x : 1px`, + ); + }); + + await t.test('leaves references inside @apply and @contents alone', () => { + const p = prefix(); + + assert.equal( + transpile('.a { @private { --x: 1px; } @apply --m { color: var(--x); } @contents { color: var(--x); } }', { preserve: true, allowUntranspiledMixins: true }), + `.a { ${p}--x: 1px; @private { --x: 1px; } @apply --m { color: var(--x); } @contents { color: var(--x); } }`, + ); + }); }); test('the same private name can be registered in several layers', async (t) => { diff --git a/plugins/postcss-mixins/CHANGELOG.md b/plugins/postcss-mixins/CHANGELOG.md index 9a8ca9c770..ddcd516e9b 100644 --- a/plugins/postcss-mixins/CHANGELOG.md +++ b/plugins/postcss-mixins/CHANGELOG.md @@ -1,5 +1,17 @@ # Changes to PostCSS Mixins +### Unreleased (minor) + +- Support `@property` rules in `@private` rules, including multi-name preludes and the shorthand form, and hoist registrations out of `@container`, `@scope` and `@starting-style` while keeping `@media` and `@supports` conditions +- Rename private property names in `transition` and `transition-property` +- Resolve references in nested mixins, `@contents` fallback blocks and contents blocks inside mixin bodies +- Support trailing commas, whitespace, empty arguments, `--x:` defaults, `type(*)` and `inherit` in parameter lists, and reject `{}` blocks mixed with other tokens +- Ignore invalid `` values and `--` parameter names, and leave mixins untouched when a name has several definitions or one that can not be transpiled +- Drop `@layer` rules from mixin bodies +- Use `@csstools/utilities-for-private-properties` and `@csstools/custom-function-parser` for shared implementation and a separate namespace for generated names +- Transpile private properties in the applying rule and in passed `@contents` blocks +- Keep mixin definitions that are still referenced by an `@apply` rule in the output, and leave every `@apply` of a mixin that can not be transpiled unchanged + ### 1.1.0 _October 1, 2026_ diff --git a/plugins/postcss-mixins/README.md b/plugins/postcss-mixins/README.md index a30a2a233e..2b35940938 100644 --- a/plugins/postcss-mixins/README.md +++ b/plugins/postcss-mixins/README.md @@ -14,8 +14,14 @@ This plugin is only a partial implementation to avoid conflicts with the final s Unsupported: - typed mixin arguments - layered `@mixin` declarations +- conditional `@mixin` declarations - mixin overrides +A mixin with an unsupported definition is left unchanged: the definition and every `@apply` of that name stay as they are. +Rules that apply such a mixin are left unchanged as well, so native support keeps working for them. + +Private properties in the applying rule and in `@contents` blocks are transpiled together with the mixin. + ```css @mixin --foo() { color: green; @@ -53,9 +59,9 @@ Unsupported: } .bar { - --_csstools-p-1gice1e-0--arg-0: 200; - --_csstools-p-1gice1e-1--baz: var(--_csstools-p-1gice1e-0--arg-0); - color: rgb(var(--_csstools-p-1gice1e-1--baz) 127 0); + --_csstools-m-1gice1e-0--arg-0: 200; + --_csstools-m-1gice1e-1--baz: var(--_csstools-m-1gice1e-0--arg-0); + color: rgb(var(--_csstools-m-1gice1e-1--baz) 127 0); } .c { @@ -151,9 +157,9 @@ postcssMixins({ preserve: true }) } .bar { - --_csstools-p-1gice1e-0--arg-0: 200; - --_csstools-p-1gice1e-1--baz: var(--_csstools-p-1gice1e-0--arg-0); - color: rgb(var(--_csstools-p-1gice1e-1--baz) 127 0); + --_csstools-m-1gice1e-0--arg-0: 200; + --_csstools-m-1gice1e-1--baz: var(--_csstools-m-1gice1e-0--arg-0); + color: rgb(var(--_csstools-m-1gice1e-1--baz) 127 0); @apply --bar(200); } diff --git a/plugins/postcss-mixins/dist/index.mjs b/plugins/postcss-mixins/dist/index.mjs index 8ba221d7a3..8f42bb28a4 100644 --- a/plugins/postcss-mixins/dist/index.mjs +++ b/plugins/postcss-mixins/dist/index.mjs @@ -1 +1 @@ -import{Rule as e,AtRule as t,Declaration as s}from"postcss";import{Transpiler as n}from"@csstools/postcss-private-rule";import{parseComponentValue as r,isTokenNode as a,isFunctionNode as o,parseCommaSeparatedListOfComponentValues as i,stringify as l,isSimpleBlockNode as u,isWhiteSpaceOrCommentNode as c}from"@csstools/css-parser-algorithms";import{tokenize as p,isTokenIdent as f,isTokenOpenCurly as d,isTokenColon as m}from"@csstools/css-tokenizer";const h=/^apply$/i,g=/!\s*important/i;function processableApplyRule(e){if(!e.params||!e.params.includes("--"))return!1;if(!isInStyleRule(e))return!1;const t=r(p({css:e.params}));let s,n=[];if(a(t)&&f(t.value))s=t.value[4].value;else{if(!o(t))return!1;{s=t.getName();const e=parseArguments(t.value);if(!e)return!1;n=e}}return!!s.startsWith("--")&&{name:s,arguments:n}}function parseArguments(e){const t=i(e.flatMap(e=>e.tokens()));if(1===t.length&&""===l([t[0]]).trim())return[];const s=[];for(const e of t){const t=(1===e.length&&u(e[0])&&d(e[0].startToken)?l([e[0].value]):l([e])).trim();if(""===t)return!1;if(g.test(t))return!1;s.push(t)}return s}const x=/^scope$/i;function isInStyleRule(e){const t=e.parent;return!(!t||"root"===t.type)&&("rule"===t.type||(!("atrule"!==t.type||!x.test(t.name))||isInStyleRule(t)))}const v=/^result$/i,y=/!\s*important/i;function processableMixinRule(e){if("mixin"!==e.name.toLowerCase())return!1;if(!e.params||!e.params.includes("--"))return!1;if(void 0===e.nodes)return!1;if(e.parent!==e.root())return!1;let t=!1;if(e.walk(e=>{"atrule"===e.type&&v.test(e.name)&&(t=!0)}),t)return!1;const s=r(p({css:e.params}));let n,i=[];if(a(s)&&f(s.value))n=s.value[4].value;else{if(!o(s))return!1;{n=s.getName();const e=parseParameters(s.value);if(!e)return!1;i=e}}return!!n.startsWith("--")&&{name:n,parameters:i}}function parseParameters(e){const t=i(e.flatMap(e=>e.tokens()));if(1===t.length&&""===l([t[0]]).trim())return[];const s=[],n=new Set;for(const e of t){let t=0;for(;t{hasMixinAncestor(e)||s.push(e)});for(const e of s)e.parent&&this.expand(e,t)}finish(){for(const e of this.desugaredNestingRules)e.replaceWith(...e.nodes||[]);this.desugaredNestingRules.clear()}expand(e,t){const s=processableApplyRule(e);if(!s)return;const n=this.mixins.get(s.name);if(!n)return;if(this.expanding.has(s.name))return;if(s.arguments.length>n.parameters.length)return;this.expanding.add(s.name);const r=this.buildBody(e,s.arguments,n);this.spendBudget(countNodes(r)),e.before(r),t||e.remove(),needsWrapper(n)&&this.transpile(r),this.replaceContents(r,void 0!==e.nodes,e.nodes||[]),this.expandNested(r),this.expanding.delete(s.name)}buildBody(s,n,r){const a=(r.atRule.nodes||[]).map(e=>e.clone());if(!needsWrapper(r))return a;const o=new e({selector:"&",source:s.source});let i,l;o.raws.semicolon=!0,this.desugaredNestingRules.add(o),r.parameters.length>0&&n.length>0&&(i=new e({selector:"&",source:s.source}),i.raws.semicolon=!0,this.desugaredNestingRules.add(i),l=new t({name:"private",source:s.source}),i.append(l),i.append(o)),r.parameters.length>0&&o.append(this.buildParameterPrivateRule(s,n,r.parameters,l));for(const e of a)o.append(e);return o.cleanRaws(),l?.nodes?.length?(i?.cleanRaws(),[i]):[o]}buildParameterPrivateRule(e,n,r,a){const o=new t({name:"private",source:e.source});for(let t=0;te.clone())),e.remove()}}spendBudget(e){if(this.generatedNodes+=e,this.generatedNodes>1e5)throw new Error("Maximum mixin expansion size exceeded, reduce the complexity of your mixins")}}function needsWrapper(e){return e.parameters.length>0||hasPrivateRules(e.atRule)}function countNodes(e){let t=0;for(const s of e)t++,"rule"!==s.type&&"atrule"!==s.type||(t+=countNodes(s.nodes||[]));return t}function hasPrivateRules(e){let t=!1;return e.walkAtRules(w,()=>{t=!0}),t}function findOwningRule(e){let t=e.parent;for(;t;){if("rule"===t.type)return t;if("atrule"!==t.type||!M.test(t.name))return!1;t=t.parent}return!1}function collectMatches(e,t,s){"atrule"===e.type&&t.test(e.name)&&s.push(e),"rule"!==e.type&&"atrule"!==e.type||e.walkAtRules(t,e=>{s.push(e)})}function collectDeclarationsAndAtRules(e,t,s){"decl"===e.type?t.push(e):"atrule"===e.type&&s.push(e),"rule"!==e.type&&"atrule"!==e.type||e.walk(e=>{"decl"===e.type?t.push(e):"atrule"===e.type&&s.push(e)})}function hasMixinAncestor(e){let t=e.parent;for(;t;){if("atrule"===t.type&&"mixin"===t.name.toLowerCase())return!0;t=t.parent}return!1}const creator=e=>{const t=Object.assign({preserve:!1},e);return{postcssPlugin:"postcss-mixins",prepare(){const e=new MixinExpander;return{postcssPlugin:"mixins",Once(s){const n=[];if(s.each(e=>{"atrule"===e.type&&n.push(e)}),e.registerMixins(n),!t.preserve)for(const t of e.registeredMixins())t.atRule.remove();e.expandAll(s,!0===t.preserve),e.finish()}}}}};creator.postcss=!0;export{creator as default,creator as"module.exports"}; +import{parseComponentValue as e,isTokenNode as t,isFunctionNode as n,stringify as s}from"@csstools/css-parser-algorithms";import{tokenize as r,isTokenIdent as o}from"@csstools/css-tokenizer";import{parseDashedFunctionArguments as i,parseFunctionParameters as a}from"@csstools/custom-function-parser";import{createPrivatePropertyTranspiler as l}from"@csstools/utilities-for-private-properties";const u=/^apply$/i,p=/^(container|layer|media|scope|starting-style|supports)$/i,c=/^keyframes$/i;function processableApplyRule(a){if(!a.params)return!1;if(!applySiteRule(a))return!1;const l=e(r({css:a.params}));let u,p=[];if(t(l)&&o(l.value))u=l.value[4].value;else{if(!n(l))return!1;{u=l.getName();const e=i(l.value);if(!e)return!1;p=e.map(e=>s([e]).trim())}}return!!u.startsWith("--")&&{name:u,arguments:p}}function applySiteRule(e){let t=e.parent;for(;t;){if("rule"===t.type)return isKeyframesRule(t)?null:t;if("atrule"!==t.type||!p.test(t.name))return null;t=t.parent}return null}function isKeyframesRule(e){let t=e?.parent;for(;t;){if("atrule"===t.type&&c.test(t.name))return!0;t=t.parent}return!1}function dashedNameFromParams(s){if(!s)return null;const i=e(r({css:s}));let a;if(t(i)&&o(i.value))a=i.value[4].value;else{if(!n(i))return null;a=i.getName()}return a.startsWith("--")?a:null}function mixinRuleName(e){return"mixin"!==e.name.toLowerCase()?null:dashedNameFromParams(e.params)}function processableMixinRule(t){const s=mixinRuleName(t);if(!s)return!1;if(void 0===t.nodes)return!1;if(t.parent!==t.root())return!1;const o=e(r({css:t.params}));let i=[];if(n(o)){const e=a(o.value);if(!e||e.some(e=>{const t=e.getParameterType();return!!t&&"*"!==t}))return!1;i=e.map(e=>({name:e.getName(),defaultValue:e.getDefaultValue()??void 0}))}return{name:s,parameters:i}}function collectMixinDefinitions(e){const t=new Map;for(const n of e){const e=mixinRuleName(n);if(!e)continue;const s=t.get(e)??[];s.push(n),t.set(e,s)}const n=new Map,s=new Set,r=new Map;for(const[e,o]of t){if(1!==o.length){s.add(e);continue}const t=processableMixinRule(o[0]);if(!t){s.add(e);continue}n.set(e,Object.assign({},t,{atRule:o[0]}));const i=new Set;collectApplyNames(o[0],new Set,i),r.set(e,i)}const o=new Map,isTranspilable=e=>{const t=o.get(e);if(void 0!==t)return t;if(!n.has(e))return!s.has(e);o.set(e,!1);let i=!0;for(const t of r.get(e)??[])if(!isTranspilable(t)){i=!1;break}return o.set(e,i),i};for(const e of[...n.keys()])isTranspilable(e)||(n.delete(e),s.add(e));return{mixins:n,unsupported:s}}function removeUnusedMixins(e,t){const n=new Set;for(const e of t.mixins.values())n.add(e.atRule);const s=new Set;collectApplyNames(e,n,s);const r=new Set,o=[...s];for(;o.length;){const e=o.pop();if(r.has(e))continue;r.add(e);const n=t.mixins.get(e);if(!n)continue;const i=new Set;collectApplyNames(n.atRule,new Set,i);for(const e of i)s.has(e)||(s.add(e),o.push(e))}for(const[e,n]of t.mixins)s.has(e)||n.atRule.remove()}function collectApplyNames(e,t,n){e.walkAtRules(u,e=>{if(isInsideAny(e,t))return;const s=dashedNameFromParams(e.params);s&&n.add(s)})}function isInsideAny(e,t){let n=e;for(;n;){if(t.has(n))return!0;n=n.parent}return!1}const f=/^contents$/i,d=/^layer$/i;class MixinExpander{definitions;preserve;expansionTranspiler;authorTranspiler;registrations=[];argumentCounter=0;desugaredNestingRules=new Set;expansionRules=new Set;applyingRules=new Set;generatedNodes=0;constructor(e,t){this.definitions=e,this.preserve=t,this.expansionTranspiler=l({namespace:"m",allowUntranspiledMixins:!0}),this.authorTranspiler=l({namespace:"p",allowUntranspiledMixins:!0,preserve:t})}expandAll(e,t){this.generatedNodes=0;const n=[];e.walkAtRules(u,e=>{hasMixinAncestor(e)||n.push(e)});const s=new Map;for(const e of n){if(!processableApplyRule(e))continue;const t=applySiteRule(e);if(!t)continue;const n=s.get(t)??[];n.push(e),s.set(t,n)}const r=new Set;for(const[e,t]of s)for(const n of t){const t=processableApplyRule(n);if(t&&this.definitions.unsupported.has(t.name)){blockRuleAndAncestors(e,r);break}}for(const[e,n]of s)if(!isBlocked(e,r)){for(const e of n)this.expand(e,this.preserve,t);collectRuleAndAncestors(e,this.applyingRules)}}finish(e){for(const e of this.desugaredNestingRules)e.replaceWith(...e.nodes||[]);this.desugaredNestingRules.clear();for(const e of this.applyingRules)isOutermost(e,this.applyingRules)&&this.registrations.push(...this.authorTranspiler.transpile([e]));this.applyingRules.clear(),this.expansionRules.clear(),e.append(...this.registrations),this.registrations=[]}expand(e,t,n){const s=processableApplyRule(e);if(!s)return;const r=this.definitions.mixins.get(s.name);if(!r)return;if(s.arguments.length>r.parameters.length)return;const o=applySiteRule(e),i=void 0!==e.nodes,a=this.buildBody(e,s.arguments,r,n);this.spendBudget(countNodes(a)),e.before(a),t||e.remove(),this.registerExpansionRules(a),this.transpileExpansion(a),this.replaceContents(a,i,e.nodes||[],o),this.expandNested(a,n)}buildBody(e,t,n,s){const r=cloneMixinBodyNodes(n.atRule);if(!needsWrapper(n))return r;const o=s.rule({selector:"&",source:e.source});let i,a;o.raws.semicolon=!0,this.desugaredNestingRules.add(o);const l=n.parameters.some((e,n)=>n>=t.length&&isInheritKeyword(e.defaultValue));n.parameters.length>0&&(t.length>0||l)&&(i=s.rule({selector:"&",source:e.source}),i.raws.semicolon=!0,this.desugaredNestingRules.add(i),a=s.atRule({name:"private",source:e.source}),i.append(a),i.append(o)),n.parameters.length>0&&o.append(this.buildParameterPrivateRule(e,t,n.parameters,s,a));for(const e of r)o.append(e);return o.cleanRaws(),a?.nodes?.length?(i?.cleanRaws(),[i]):[o]}buildParameterPrivateRule(e,t,n,s,r){const o=s.atRule({name:"private",source:e.source});for(let i=0;ie.clone());e.before(o),e.remove(),this.registerExpansionRules(o),t&&s?this.transpileContents(o,s):this.transpileExpansion(o)}}registerExpansionRules(e){for(const t of e)"rule"===t.type&&this.expansionRules.add(t),"rule"!==t.type&&"atrule"!==t.type||t.walkRules(e=>{this.expansionRules.add(e)})}spendBudget(e){if(this.generatedNodes+=e,this.generatedNodes>1e5)throw new Error("Maximum mixin expansion size exceeded, reduce the complexity of your mixins")}}function needsWrapper(e){return e.parameters.length>0||hasPrivateRules(e.atRule)}function isInheritKeyword(e){return void 0!==e&&"inherit"===e.trim().toLowerCase()}function cloneMixinBodyNodes(e){const t=[];for(const n of e.nodes||[]){if("atrule"===n.type&&d.test(n.name))continue;const e=n.clone();"rule"!==e.type&&"atrule"!==e.type||e.walkAtRules(d,e=>{e.remove()}),t.push(e)}return t}function countNodes(e){let t=0;for(const n of e)t++,"rule"!==n.type&&"atrule"!==n.type||(t+=countNodes(n.nodes||[]));return t}function hasPrivateRules(e){let t=!1;return e.walkAtRules(/^private$/i,()=>{t=!0}),t}function collectMatches(e,t,n){"atrule"===e.type&&t.test(e.name)&&n.push(e),"rule"!==e.type&&"atrule"!==e.type||e.walkAtRules(t,e=>{n.push(e)})}function blockRuleAndAncestors(e,t){let n=e;for(;n;)t.add(n),n=parentStyleRule(n)}function isBlocked(e,t){let n=e;for(;n;){if(t.has(n))return!0;n=parentStyleRule(n)}return!1}function collectRuleAndAncestors(e,t){let n=e;for(;n;)t.add(n),n=parentStyleRule(n)}function isOutermost(e,t){let n=parentStyleRule(e);for(;n;){if(t.has(n))return!1;n=parentStyleRule(n)}return!0}function parentStyleRule(e){let t=e.parent;for(;t;){if("rule"===t.type)return t;if("atrule"!==t.type||!p.test(t.name))return null;t=t.parent}return null}function hasMixinAncestor(e){let t=e.parent;for(;t;){if("atrule"===t.type&&"mixin"===t.name.toLowerCase())return!0;t=t.parent}return!1}const creator=e=>{const t=Object.assign({preserve:!1},e);return{postcssPlugin:"postcss-mixins",Once(e,n){const s=[];e.walkAtRules(e=>{s.push(e)});const r=collectMixinDefinitions(s),o=new MixinExpander(r,!0===t.preserve);o.expandAll(e,n),o.finish(e),t.preserve||removeUnusedMixins(e,r)}}};creator.postcss=!0;export{creator as default,creator as"module.exports"}; diff --git a/plugins/postcss-mixins/docs/README.md b/plugins/postcss-mixins/docs/README.md index e29a67ed77..b297f57c86 100644 --- a/plugins/postcss-mixins/docs/README.md +++ b/plugins/postcss-mixins/docs/README.md @@ -25,8 +25,14 @@ This plugin is only a partial implementation to avoid conflicts with the final s Unsupported: - typed mixin arguments - layered `@mixin` declarations +- conditional `@mixin` declarations - mixin overrides +A mixin with an unsupported definition is left unchanged: the definition and every `@apply` of that name stay as they are. +Rules that apply such a mixin are left unchanged as well, so native support keeps working for them. + +Private properties in the applying rule and in `@contents` blocks are transpiled together with the mixin. + ```css diff --git a/plugins/postcss-mixins/package.json b/plugins/postcss-mixins/package.json index cea31fb7f6..becb186b10 100644 --- a/plugins/postcss-mixins/package.json +++ b/plugins/postcss-mixins/package.json @@ -43,7 +43,8 @@ "dependencies": { "@csstools/css-parser-algorithms": "^4.0.2", "@csstools/css-tokenizer": "^4.0.2", - "@csstools/postcss-private-rule": "^1.0.3" + "@csstools/custom-function-parser": "^1.0.0", + "@csstools/utilities-for-private-properties": "^0.0.0" }, "peerDependencies": { "postcss": "^8.4" diff --git a/plugins/postcss-mixins/src/index.ts b/plugins/postcss-mixins/src/index.ts index 33f3f2b9bd..9202ac1547 100644 --- a/plugins/postcss-mixins/src/index.ts +++ b/plugins/postcss-mixins/src/index.ts @@ -1,4 +1,5 @@ -import type { AtRule, Plugin, PluginCreator } from 'postcss'; +import type { AtRule, PluginCreator } from 'postcss'; +import { collectMixinDefinitions, removeUnusedMixins } from './mixin-definitions'; import { MixinExpander } from './mixin-expander'; /** postcss-mixins plugin options */ @@ -19,31 +20,21 @@ const creator: PluginCreator = (opts?: pluginOptions) => { return { postcssPlugin: 'postcss-mixins', - prepare(): Plugin { - const expander = new MixinExpander(); - - return { - postcssPlugin: 'mixins', - Once(root): void { - const rootAtRules: Array = []; - root.each((child) => { - if (child.type === 'atrule') { - rootAtRules.push(child); - } - }); - - expander.registerMixins(rootAtRules); - - if (!options.preserve) { - for (const mixin of expander.registeredMixins()) { - mixin.atRule.remove(); - } - } - - expander.expandAll(root, options.preserve === true); - expander.finish(); - }, - }; + Once(root, helpers): void { + const atRules: Array = []; + root.walkAtRules((atRule) => { + atRules.push(atRule); + }); + + const definitions = collectMixinDefinitions(atRules); + const expander = new MixinExpander(definitions, options.preserve === true); + + expander.expandAll(root, helpers); + expander.finish(root); + + if (!options.preserve) { + removeUnusedMixins(root, definitions); + } }, }; }; diff --git a/plugins/postcss-mixins/src/mixin-definitions.ts b/plugins/postcss-mixins/src/mixin-definitions.ts new file mode 100644 index 0000000000..adcf2c0a80 --- /dev/null +++ b/plugins/postcss-mixins/src/mixin-definitions.ts @@ -0,0 +1,186 @@ +import type { AtRule, Container, Document, Node, Root } from 'postcss'; +import { IS_APPLY_REGEX } from './processable-apply'; +import type { MixinParameter } from './processable-mixin'; +import { dashedNameFromParams, mixinRuleName, processableMixinRule } from './processable-mixin'; + +export type Mixin = { + name: string, + parameters: Array, + atRule: AtRule, +}; + +export type MixinDefinitions = { + /** Names that can be transpiled. */ + mixins: Map, + /** Names with at least one definition that can not be transpiled. */ + unsupported: Set, +}; + +/** + * Group `@mixin` rules by name. + * + * A name is only transpilable when it has exactly one definition, that + * definition can be transpiled, and everything it applies can be transpiled as + * well. Otherwise every definition and every `@apply` of that name is left + * untouched. + */ +export function collectMixinDefinitions(atRules: Array): MixinDefinitions { + const byName: Map> = new Map(); + + for (const atRule of atRules) { + const name = mixinRuleName(atRule); + if (!name) { + continue; + } + + const definitions = byName.get(name) ?? []; + definitions.push(atRule); + byName.set(name, definitions); + } + + const mixins: Map = new Map(); + const unsupported: Set = new Set(); + const references: Map> = new Map(); + + for (const [name, definitions] of byName) { + if (definitions.length !== 1) { + unsupported.add(name); + continue; + } + + const parsed = processableMixinRule(definitions[0]); + if (!parsed) { + unsupported.add(name); + continue; + } + + mixins.set(name, Object.assign({}, parsed, { atRule: definitions[0] })); + + const names: Set = new Set(); + collectApplyNames(definitions[0], new Set(), names); + references.set(name, names); + } + + // A mixin that applies a mixin which can not be transpiled can not be + // transpiled either. A cycle makes every mixin on the cycle unsupported. + const state: Map = new Map(); + + const isTranspilable = (name: string): boolean => { + const known = state.get(name); + if (known !== undefined) { + return known; + } + + if (!mixins.has(name)) { + return !unsupported.has(name); + } + + // Assume a cycle until proven otherwise. + state.set(name, false); + + let transpilable = true; + for (const reference of references.get(name) ?? []) { + if (!isTranspilable(reference)) { + transpilable = false; + break; + } + } + + state.set(name, transpilable); + return transpilable; + }; + + for (const name of [...mixins.keys()]) { + if (isTranspilable(name)) { + continue; + } + + mixins.delete(name); + unsupported.add(name); + } + + return { mixins, unsupported }; +} + +/** + * Remove definitions of mixins that are not referenced by any `@apply` rule + * that remains in the output. + * + * A definition is only removed when every call site is expanded by this plugin. + * Call sites that are left as-is, for example inside a preserved `@mixin`, keep + * their definitions alive. + */ +export function removeUnusedMixins(root: Root, definitions: MixinDefinitions): void { + const supportedNodes: Set = new Set(); + for (const mixin of definitions.mixins.values()) { + supportedNodes.add(mixin.atRule); + } + + const required: Set = new Set(); + collectApplyNames(root, supportedNodes, required); + + // Definitions that are kept can reference other definitions. + const processed: Set = new Set(); + const queue: Array = [...required]; + + while (queue.length) { + const name = queue.pop() as string; + if (processed.has(name)) { + continue; + } + + processed.add(name); + + const mixin = definitions.mixins.get(name); + if (!mixin) { + continue; + } + + const references: Set = new Set(); + collectApplyNames(mixin.atRule, new Set(), references); + + for (const reference of references) { + if (required.has(reference)) { + continue; + } + + required.add(reference); + queue.push(reference); + } + } + + for (const [name, mixin] of definitions.mixins) { + if (required.has(name)) { + continue; + } + + mixin.atRule.remove(); + } +} + +function collectApplyNames(container: Container | Document, skipNodes: Set, out: Set): void { + container.walkAtRules(IS_APPLY_REGEX, (atRule) => { + if (isInsideAny(atRule, skipNodes)) { + return; + } + + const name = dashedNameFromParams(atRule.params); + if (name) { + out.add(name); + } + }); +} + +function isInsideAny(node: Node, nodes: Set): boolean { + let parent: Node | undefined = node; + + while (parent) { + if (nodes.has(parent)) { + return true; + } + + parent = parent.parent; + } + + return false; +} diff --git a/plugins/postcss-mixins/src/mixin-expander.ts b/plugins/postcss-mixins/src/mixin-expander.ts index c0567885b9..3765ceac78 100644 --- a/plugins/postcss-mixins/src/mixin-expander.ts +++ b/plugins/postcss-mixins/src/mixin-expander.ts @@ -1,19 +1,12 @@ -import { AtRule, Declaration, Rule } from 'postcss'; -import type { ChildNode, Node, Root } from 'postcss'; -import { Transpiler } from '@csstools/postcss-private-rule'; -import { IS_APPLY_REGEX, processableApplyRule } from './processable-apply'; +import type { AtRule, ChildNode, Helpers, Root, Rule } from 'postcss'; +import type { PrivatePropertyTranspiler } from '@csstools/utilities-for-private-properties'; +import { createPrivatePropertyTranspiler } from '@csstools/utilities-for-private-properties'; +import type { Mixin, MixinDefinitions } from './mixin-definitions'; +import { IS_APPLY_REGEX, IS_NESTING_GROUP_RULE_REGEX, applySiteRule, processableApplyRule } from './processable-apply'; import type { MixinParameter } from './processable-mixin'; -import { processableMixinRule } from './processable-mixin'; - -type Mixin = { - name: string, - parameters: Array, - atRule: AtRule, -}; const IS_CONTENTS_REGEX = /^contents$/i; -const IS_PRIVATE_REGEX = /^private$/i; -const IS_NESTING_GROUP_RULE_REGEX = /^(container|layer|media|scope|starting-style|supports)$/i; +const IS_LAYER_REGEX = /^layer$/i; // Mixins can reference each other and duplicate subtrees, which can grow // exponentially. Bound the total number of nodes generated while expanding @@ -22,45 +15,32 @@ const MAX_GENERATED_NODES = 100_000; /** * Deepens mixin expansion behind a small interface: - * register the mixins once, expand the top level `@apply` rules, then finish. + * expand the `@apply` rules of one stylesheet, then finish. * - * Everything else — argument capture, wrapper construction, private scoping, - * `@contents` substitution, nested recursion and the cycle guard — is internal. + * Everything else — argument capture, wrapper construction, private scoping and + * `@contents` substitution — is internal. */ export class MixinExpander { - private mixins: Map = new Map(); - private knownMixins: Set = new Set(); - private transpiler: Transpiler = new Transpiler(); + private definitions: MixinDefinitions; + private preserve: boolean; + private expansionTranspiler: PrivatePropertyTranspiler; + private authorTranspiler: PrivatePropertyTranspiler; + private registrations: Array = []; private argumentCounter = 0; private desugaredNestingRules: Set = new Set(); - private expanding: Set = new Set(); + private expansionRules: Set = new Set(); + private applyingRules: Set = new Set(); private generatedNodes = 0; - /** The mixin at rules that were registered, so a caller can remove or preserve them. */ - registeredMixins(): Array { - return Array.from(this.mixins.values()); + constructor(definitions: MixinDefinitions, preserve: boolean) { + this.definitions = definitions; + this.preserve = preserve; + this.expansionTranspiler = createPrivatePropertyTranspiler({ namespace: 'm', allowUntranspiledMixins: true }); + this.authorTranspiler = createPrivatePropertyTranspiler({ namespace: 'p', allowUntranspiledMixins: true, preserve }); } - registerMixins(rootAtRules: Array): void { - for (const atRule of rootAtRules) { - const parsed = processableMixinRule(atRule); - if (!parsed) { - continue; - } - - // TODO: support mixin overrides - if (this.knownMixins.has(parsed.name)) { - this.mixins.delete(parsed.name); - continue; - } - - this.mixins.set(parsed.name, Object.assign({}, parsed, { atRule })); - this.knownMixins.add(parsed.name); - } - } - - /** Expands all top level `@apply` rules in `root`, except those authored inside a `@mixin`. */ - expandAll(root: Root, preserve: boolean): void { + /** Expands all `@apply` rules in `root`, except those authored inside a `@mixin`. */ + expandAll(root: Root, helpers: Helpers): void { this.generatedNodes = 0; const applies: Array = []; @@ -72,49 +52,97 @@ export class MixinExpander { applies.push(atRule); }); + const appliesByRule: Map> = new Map(); for (const atRule of applies) { - if (!atRule.parent) { + const apply = processableApplyRule(atRule); + if (!apply) { + continue; + } + + const rule = applySiteRule(atRule); + if (!rule) { continue; } - this.expand(atRule, preserve); + const ruleApplies = appliesByRule.get(rule) ?? []; + ruleApplies.push(atRule); + appliesByRule.set(rule, ruleApplies); + } + + // A rule with an `@apply` for a mixin that can not be transpiled must stay + // untouched, together with every rule it is nested in. Expanding the other + // rules that still apply to the same elements would either drop styles or + // mix native and transpiled output. + const blocked: Set = new Set(); + for (const [rule, ruleApplies] of appliesByRule) { + for (const atRule of ruleApplies) { + const apply = processableApplyRule(atRule); + if (!apply || !this.definitions.unsupported.has(apply.name)) { + continue; + } + + blockRuleAndAncestors(rule, blocked); + break; + } + } + + for (const [rule, ruleApplies] of appliesByRule) { + if (isBlocked(rule, blocked)) { + continue; + } + + for (const atRule of ruleApplies) { + this.expand(atRule, this.preserve, helpers); + } + + collectRuleAndAncestors(rule, this.applyingRules); } } - /** Removes the temporary `& {}` nesting rules created while desugaring. */ - finish(): void { + /** Removes temporary wrappers, transpiles private properties and appends registrations to the root. */ + finish(root: Root): void { for (const wrapper of this.desugaredNestingRules) { wrapper.replaceWith(...wrapper.nodes || []); } this.desugaredNestingRules.clear(); + + for (const rule of this.applyingRules) { + if (!isOutermost(rule, this.applyingRules)) { + continue; + } + + this.registrations.push(...this.authorTranspiler.transpile([rule])); + } + + this.applyingRules.clear(); + this.expansionRules.clear(); + + root.append(...this.registrations); + this.registrations = []; } - private expand(atRule: AtRule, preserve: boolean): void { + private expand(atRule: AtRule, preserve: boolean, helpers: Helpers): void { const apply = processableApplyRule(atRule); if (!apply) { return; } - const mixin = this.mixins.get(apply.name); + const mixin = this.definitions.mixins.get(apply.name); if (!mixin) { return; } - // Guard against mixins that (indirectly) apply themselves. - if (this.expanding.has(apply.name)) { - return; - } - // Passing more arguments than the mixin accepts is invalid. + // The application does nothing, so the `@apply` rule is left in place. if (apply.arguments.length > mixin.parameters.length) { return; } - this.expanding.add(apply.name); - - const inserted = this.buildBody(atRule, apply.arguments, mixin); + const siteRule = applySiteRule(atRule); + const hasContents = atRule.nodes !== undefined; + const inserted = this.buildBody(atRule, apply.arguments, mixin, helpers); this.spendBudget(countNodes(inserted)); // Insert as a batch: PostCSS resolves the index of `atRule` with @@ -125,22 +153,18 @@ export class MixinExpander { atRule.remove(); } - if (needsWrapper(mixin)) { - this.transpile(inserted); - } + this.registerExpansionRules(inserted); + this.transpileExpansion(inserted); // `@contents` is substituted after insertion so the replaced at-rule has a parent. - // It is substituted after transpilation so passed-in contents are not scoped to the mixin. - this.replaceContents(inserted, atRule.nodes !== undefined, atRule.nodes || []); - - this.expandNested(inserted); + this.replaceContents(inserted, hasContents, atRule.nodes || [], siteRule); - this.expanding.delete(apply.name); + this.expandNested(inserted, helpers); } /** Captures arguments, scopes parameters and `@private` rules, and returns the nodes to insert. */ - private buildBody(atRule: AtRule, args: Array, mixin: Mixin): Array { - const cloned: Array = (mixin.atRule.nodes || []).map((node) => node.clone()); + private buildBody(atRule: AtRule, args: Array, mixin: Mixin, helpers: Helpers): Array { + const cloned = cloneMixinBodyNodes(mixin.atRule); if (!needsWrapper(mixin)) { return cloned; @@ -150,25 +174,29 @@ export class MixinExpander { // Each supplied argument is bound to a fresh custom property so it can not be // shadowed by parameters of nested mixins that reuse the same names. // See: https://github.com/w3c/csswg-drafts/issues/14372 - const bodyWrapper = new Rule({ selector: '&', source: atRule.source }); + const bodyWrapper = helpers.rule({ selector: '&', source: atRule.source }); bodyWrapper.raws.semicolon = true; this.desugaredNestingRules.add(bodyWrapper); let outerWrapper: Rule | undefined; let argumentPrivateRule: AtRule | undefined; - if (mixin.parameters.length > 0 && args.length > 0) { - outerWrapper = new Rule({ selector: '&', source: atRule.source }); + const hasInheritedDefault = mixin.parameters.some((parameter, i) => { + return i >= args.length && isInheritKeyword(parameter.defaultValue); + }); + + if (mixin.parameters.length > 0 && (args.length > 0 || hasInheritedDefault)) { + outerWrapper = helpers.rule({ selector: '&', source: atRule.source }); outerWrapper.raws.semicolon = true; this.desugaredNestingRules.add(outerWrapper); - argumentPrivateRule = new AtRule({ name: 'private', source: atRule.source }); + argumentPrivateRule = helpers.atRule({ name: 'private', source: atRule.source }); outerWrapper.append(argumentPrivateRule); outerWrapper.append(bodyWrapper); } if (mixin.parameters.length > 0) { - bodyWrapper.append(this.buildParameterPrivateRule(atRule, args, mixin.parameters, argumentPrivateRule)); + bodyWrapper.append(this.buildParameterPrivateRule(atRule, args, mixin.parameters, helpers, argumentPrivateRule)); } for (const node of cloned) { @@ -187,8 +215,8 @@ export class MixinExpander { } /** Binds each parameter to its captured argument value, or to its default in the mixin's frame. */ - private buildParameterPrivateRule(atRule: AtRule, args: Array, parameters: Array, argumentPrivateRule?: AtRule): AtRule { - const parameterPrivateRule = new AtRule({ name: 'private', source: atRule.source }); + private buildParameterPrivateRule(atRule: AtRule, args: Array, parameters: Array, helpers: Helpers, argumentPrivateRule?: AtRule): AtRule { + const parameterPrivateRule = helpers.atRule({ name: 'private', source: atRule.source }); for (let i = 0; i < parameters.length; i++) { const parameter = parameters[i]; @@ -198,20 +226,32 @@ export class MixinExpander { if (i < args.length) { const argumentName = `--arg-${(this.argumentCounter++).toString(36)}`; - argumentPrivateRule?.append(new Declaration({ + argumentPrivateRule?.append(helpers.decl({ prop: argumentName, - value: args[i], + value: isInheritKeyword(args[i]) ? `var(${parameter.name})` : args[i], source: atRule.source, })); // The parameter resolves to the captured argument value. + value = `var(${argumentName})`; + } else if (argumentPrivateRule && isInheritKeyword(parameter.defaultValue)) { + const argumentName = `--arg-${(this.argumentCounter++).toString(36)}`; + + // `inherit` on a parameter default resolves to the same-named + // custom property in the calling context. + argumentPrivateRule.append(helpers.decl({ + prop: argumentName, + value: `var(${parameter.name})`, + source: atRule.source, + })); + value = `var(${argumentName})`; } else { // Missing arguments resolve to their default in the mixin's own frame. - value = parameter.defaultValue || 'initial'; + value = parameter.defaultValue ?? 'initial'; } - parameterPrivateRule.append(new Declaration({ + parameterPrivateRule.append(helpers.decl({ prop: parameter.name, value, source: atRule.source, @@ -222,38 +262,17 @@ export class MixinExpander { } /** Only `@private` rules that originate from mixins are transpiled here. */ - private transpile(inserted: Array): void { - const privateRules: Array = []; - for (const node of inserted) { - collectMatches(node, IS_PRIVATE_REGEX, privateRules); - } - - for (const privateRule of privateRules) { - const owner = findOwningRule(privateRule); - if (!owner) { - continue; - } - - this.transpiler.registerAndRemovePrivateRules(privateRule, owner); - } - - const declarations: Array = []; - const atRules: Array = []; - for (const node of inserted) { - collectDeclarationsAndAtRules(node, declarations, atRules); - } - - for (const declaration of declarations) { - this.transpiler.transpileDeclaration(declaration); - } + private transpileExpansion(inserted: Array): void { + this.registrations.push(...this.expansionTranspiler.transpile(inserted)); + } - for (const nestedAtRule of atRules) { - this.transpiler.transpileAtRule(nestedAtRule); - } + private transpileContents(contents: Array, siteRule: Rule): void { + const transpiler = this.expansionRules.has(siteRule) ? this.expansionTranspiler : this.authorTranspiler; + this.registrations.push(...transpiler.transpile(contents, { scope: siteRule })); } /** Mixins applied within this mixin are resolved in the context of the arguments above. */ - private expandNested(inserted: Array): void { + private expandNested(inserted: Array, helpers: Helpers): void { const nestedApplies: Array = []; for (const node of inserted) { collectMatches(node, IS_APPLY_REGEX, nestedApplies); @@ -264,12 +283,12 @@ export class MixinExpander { continue; } - this.expand(nestedAtRule, false); + this.expand(nestedAtRule, false, helpers); } } /** Substitutes `@contents` and charges the budget for the duplicated nodes. */ - private replaceContents(nodes: Array, hasContents: boolean, contents: Array): void { + private replaceContents(nodes: Array, hasContents: boolean, contents: Array, siteRule: Rule | null): void { const contentsRules: Array = []; for (const node of nodes) { collectMatches(node, IS_CONTENTS_REGEX, contentsRules); @@ -280,8 +299,36 @@ export class MixinExpander { this.spendBudget(countNodes(replacement)); - contentsRule.before(replacement.map((child) => child.clone())); + const substituted = replacement.map((child) => child.clone()); + + contentsRule.before(substituted); contentsRule.remove(); + + this.registerExpansionRules(substituted); + + if (hasContents && siteRule) { + // Passed-in contents are scoped to the apply site. + this.transpileContents(substituted, siteRule); + continue; + } + + // A fallback block is authored in the mixin body. Declarations in it are + // part of the mixin scope and may define private properties. + this.transpileExpansion(substituted); + } + } + + private registerExpansionRules(nodes: Array): void { + for (const node of nodes) { + if (node.type === 'rule') { + this.expansionRules.add(node); + } + + if (node.type === 'rule' || node.type === 'atrule') { + node.walkRules((rule) => { + this.expansionRules.add(rule); + }); + } } } @@ -298,6 +345,33 @@ function needsWrapper(mixin: Mixin): boolean { return mixin.parameters.length > 0 || hasPrivateRules(mixin.atRule); } +function isInheritKeyword(value: string | undefined): boolean { + return value !== undefined && value.trim().toLowerCase() === 'inherit'; +} + +/** `@layer` is invalid in a mixin body and its contents are dropped when applied. */ +function cloneMixinBodyNodes(atRule: AtRule): Array { + const out: Array = []; + + for (const node of atRule.nodes || []) { + if (node.type === 'atrule' && IS_LAYER_REGEX.test(node.name)) { + continue; + } + + const clone = node.clone(); + + if (clone.type === 'rule' || clone.type === 'atrule') { + clone.walkAtRules(IS_LAYER_REGEX, (layer) => { + layer.remove(); + }); + } + + out.push(clone); + } + + return out; +} + function countNodes(nodes: Array): number { let count = 0; @@ -314,31 +388,13 @@ function countNodes(nodes: Array): number { function hasPrivateRules(atRule: AtRule): boolean { let result = false; - atRule.walkAtRules(IS_PRIVATE_REGEX, () => { + atRule.walkAtRules(/^private$/i, () => { result = true; }); return result; } -function findOwningRule(node: ChildNode): Rule | false { - let parent: Node | undefined = node.parent; - while (parent) { - if (parent.type === 'rule') { - return parent as Rule; - } - - if (parent.type === 'atrule' && IS_NESTING_GROUP_RULE_REGEX.test((parent as AtRule).name)) { - parent = parent.parent; - continue; - } - - return false; - } - - return false; -} - function collectMatches(node: ChildNode, name: RegExp, out: Array): void { if (node.type === 'atrule' && name.test(node.name)) { out.push(node); @@ -351,22 +407,68 @@ function collectMatches(node: ChildNode, name: RegExp, out: Array): void } } -function collectDeclarationsAndAtRules(node: ChildNode, declarations: Array, atRules: Array): void { - if (node.type === 'decl') { - declarations.push(node); - } else if (node.type === 'atrule') { - atRules.push(node); +function blockRuleAndAncestors(rule: Rule, blocked: Set): void { + let current: Rule | null = rule; + + while (current) { + blocked.add(current); + current = parentStyleRule(current); } +} - if (node.type === 'rule' || node.type === 'atrule') { - node.walk((child) => { - if (child.type === 'decl') { - declarations.push(child); - } else if (child.type === 'atrule') { - atRules.push(child); - } - }); +function isBlocked(rule: Rule, blocked: Set): boolean { + let current: Rule | null = rule; + + while (current) { + if (blocked.has(current)) { + return true; + } + + current = parentStyleRule(current); + } + + return false; +} + +function collectRuleAndAncestors(rule: Rule, out: Set): void { + let current: Rule | null = rule; + + while (current) { + out.add(current); + current = parentStyleRule(current); + } +} + +function isOutermost(rule: Rule, rules: Set): boolean { + let parent = parentStyleRule(rule); + + while (parent) { + if (rules.has(parent)) { + return false; + } + + parent = parentStyleRule(parent); + } + + return true; +} + +function parentStyleRule(rule: Rule): Rule | null { + let parent = rule.parent; + + while (parent) { + if (parent.type === 'rule') { + return parent; + } + + if (parent.type !== 'atrule' || !IS_NESTING_GROUP_RULE_REGEX.test(parent.name)) { + return null; + } + + parent = parent.parent; } + + return null; } function hasMixinAncestor(atRule: AtRule): boolean { diff --git a/plugins/postcss-mixins/src/processable-apply.ts b/plugins/postcss-mixins/src/processable-apply.ts index 46bb0027b7..a361856d68 100644 --- a/plugins/postcss-mixins/src/processable-apply.ts +++ b/plugins/postcss-mixins/src/processable-apply.ts @@ -1,7 +1,7 @@ -import type { ComponentValue } from '@csstools/css-parser-algorithms'; -import { isFunctionNode, isSimpleBlockNode, isTokenNode, parseCommaSeparatedListOfComponentValues, parseComponentValue, stringify } from '@csstools/css-parser-algorithms'; -import { isTokenIdent, isTokenOpenCurly, tokenize } from '@csstools/css-tokenizer'; -import type { AtRule } from 'postcss'; +import { isFunctionNode, isTokenNode, parseComponentValue, stringify } from '@csstools/css-parser-algorithms'; +import { isTokenIdent, tokenize } from '@csstools/css-tokenizer'; +import type { AtRule, Rule } from 'postcss'; +import { parseDashedFunctionArguments } from '@csstools/custom-function-parser'; export const IS_APPLY_REGEX = /^apply$/i; @@ -10,14 +10,16 @@ export type ProcessableApply = { arguments: Array, }; -const IS_IMPORTANT_REGEX = /!\s*important/i; +export const IS_NESTING_GROUP_RULE_REGEX = /^(container|layer|media|scope|starting-style|supports)$/i; +const IS_KEYFRAMES_REGEX = /^keyframes$/i; export function processableApplyRule(atRule: AtRule): false | ProcessableApply { - if (!atRule.params || !atRule.params.includes('--')) { + if (!atRule.params) { return false; } - if (!isInStyleRule(atRule)) { + const styleRule = applySiteRule(atRule); + if (!styleRule) { return false; } @@ -33,12 +35,12 @@ export function processableApplyRule(atRule: AtRule): false | ProcessableApply { } else if (isFunctionNode(prelude)) { name = prelude.getName(); - const parsedArguments = parseArguments(prelude.value); + const parsedArguments = parseDashedFunctionArguments(prelude.value); if (!parsedArguments) { return false; } - args = parsedArguments; + args = parsedArguments.map((argument) => stringify([argument]).trim()); } else { return false; } @@ -53,52 +55,37 @@ export function processableApplyRule(atRule: AtRule): false | ProcessableApply { }; } -function parseArguments(componentValues: Array): false | Array { - const rawArguments = parseCommaSeparatedListOfComponentValues(componentValues.flatMap((componentValue) => componentValue.tokens())); +/** + * The style rule an `@apply` rule is in, or `null` when the `@apply` is not in a + * style rule or nested group rule. + */ +export function applySiteRule(atRule: AtRule): Rule | null { + let parent = atRule.parent; - // `--foo()` has no arguments. - if (rawArguments.length === 1 && stringify([rawArguments[0]]).trim() === '') { - return []; - } - - const args: Array = []; - - for (const rawArgument of rawArguments) { - // A comma-containing value can be passed as a single argument by wrapping it in `{}`. - const argument = (rawArgument.length === 1 && isSimpleBlockNode(rawArgument[0]) && isTokenOpenCurly(rawArgument[0].startToken) - ? stringify([rawArgument[0].value]) - : stringify([rawArgument]) - ).trim(); - - if (argument === '') { - return false; + while (parent) { + if (parent.type === 'rule') { + return isKeyframesRule(parent) ? null : parent; } - if (IS_IMPORTANT_REGEX.test(argument)) { - return false; + if (parent.type !== 'atrule' || !IS_NESTING_GROUP_RULE_REGEX.test(parent.name)) { + return null; } - args.push(argument); + parent = parent.parent; } - return args; + return null; } -const IS_SCOPE_REGEX = /^scope$/i; - -function isInStyleRule(atRule: AtRule): boolean { - const parent = atRule.parent; - if (!parent || parent.type === 'root') { - return false; - } - - if (parent.type === 'rule') { - return true; - } +function isKeyframesRule(rule: AtRule['parent']): boolean { + let parent = rule?.parent; + while (parent) { + if (parent.type === 'atrule' && IS_KEYFRAMES_REGEX.test(parent.name)) { + return true; + } - if (parent.type === 'atrule' && IS_SCOPE_REGEX.test(parent.name)) { - return true; + parent = parent.parent; } - return isInStyleRule(parent); + return false; } diff --git a/plugins/postcss-mixins/src/processable-mixin.ts b/plugins/postcss-mixins/src/processable-mixin.ts index 3d0f8271ef..5f0ead0602 100644 --- a/plugins/postcss-mixins/src/processable-mixin.ts +++ b/plugins/postcss-mixins/src/processable-mixin.ts @@ -1,7 +1,7 @@ -import type { ComponentValue } from '@csstools/css-parser-algorithms'; -import { isFunctionNode, isTokenNode, isWhiteSpaceOrCommentNode, parseCommaSeparatedListOfComponentValues, parseComponentValue, stringify } from '@csstools/css-parser-algorithms'; -import { isTokenColon, isTokenIdent, tokenize } from '@csstools/css-tokenizer'; +import { isFunctionNode, isTokenNode, parseComponentValue } from '@csstools/css-parser-algorithms'; +import { isTokenIdent, tokenize } from '@csstools/css-tokenizer'; import type { AtRule } from 'postcss'; +import { parseFunctionParameters } from '@csstools/custom-function-parser'; export type MixinParameter = { name: string, @@ -13,15 +13,46 @@ export type ProcessableMixin = { parameters: Array, }; -const IS_UNSUPPORTED_CHILD_RULE = /^result$/i; -const IS_IMPORTANT_REGEX = /!\s*important/i; +/** + * The dashed name in a `@mixin` or `@apply` prelude, even when the rule is not + * transpilable. + */ +export function dashedNameFromParams(params: string): string | null { + if (!params) { + return null; + } -export function processableMixinRule(atRule: AtRule): false | ProcessableMixin { + const prelude = parseComponentValue(tokenize({ + css: params, + })); + + let name: string; + if (isTokenNode(prelude) && isTokenIdent(prelude.value)) { + // `@mixin --foo;` is equivalent to `@mixin --foo();` + name = prelude.value[4].value; + } else if (isFunctionNode(prelude)) { + name = prelude.getName(); + } else { + return null; + } + + return name.startsWith('--') ? name : null; +} + +/** + * The name of a `@mixin` rule, even when the rule is not transpilable. + */ +export function mixinRuleName(atRule: AtRule): string | null { if (atRule.name.toLowerCase() !== 'mixin') { - return false; + return null; } - if (!atRule.params || !atRule.params.includes('--')) { + return dashedNameFromParams(atRule.params); +} + +export function processableMixinRule(atRule: AtRule): false | ProcessableMixin { + const name = mixinRuleName(atRule); + if (!name) { return false; } @@ -34,43 +65,25 @@ export function processableMixinRule(atRule: AtRule): false | ProcessableMixin { return false; } - // `@result` was dropped from the specification, mixins with `@result` are ignored. - let hasUnsupportedChildRule = false; - atRule.walk((node) => { - if (node.type === 'atrule' && IS_UNSUPPORTED_CHILD_RULE.test(node.name)) { - hasUnsupportedChildRule = true; - } - }); - - if (hasUnsupportedChildRule) { - return false; - } - const prelude = parseComponentValue(tokenize({ css: atRule.params, })); - let name: string; let parameters: Array = []; - if (isTokenNode(prelude) && isTokenIdent(prelude.value)) { - // `@mixin --foo;` is equivalent to `@mixin --foo();` - name = prelude.value[4].value; - } else if (isFunctionNode(prelude)) { - name = prelude.getName(); - - const parsedParameters = parseParameters(prelude.value); - if (!parsedParameters) { + if (isFunctionNode(prelude)) { + const parsedParameters = parseFunctionParameters(prelude.value); + if (!parsedParameters || parsedParameters.some((parameter) => { + const type = parameter.getParameterType(); + return !!type && type !== '*'; + })) { return false; } - parameters = parsedParameters; - } else { - return false; - } - - if (!name.startsWith('--')) { - return false; + parameters = parsedParameters.map((parameter) => ({ + name: parameter.getName(), + defaultValue: parameter.getDefaultValue() ?? undefined, + })); } return { @@ -78,68 +91,3 @@ export function processableMixinRule(atRule: AtRule): false | ProcessableMixin { parameters, }; } - -function parseParameters(componentValues: Array): false | Array { - const rawParameters = parseCommaSeparatedListOfComponentValues(componentValues.flatMap((componentValue) => componentValue.tokens())); - - // `--foo()` has no parameters. - if (rawParameters.length === 1 && stringify([rawParameters[0]]).trim() === '') { - return []; - } - - const parameters: Array = []; - const names = new Set(); - - for (const rawParameter of rawParameters) { - let start = 0; - while (start < rawParameter.length && isWhiteSpaceOrCommentNode(rawParameter[start])) { - start++; - } - - const nameNode = rawParameter[start]; - if (!nameNode || !isTokenNode(nameNode) || !isTokenIdent(nameNode.value) || !nameNode.value[4].value.startsWith('--')) { - return false; - } - - const name = nameNode.value[4].value; - if (names.has(name)) { - return false; - } - - names.add(name); - - let defaultValue: string | undefined; - let hasType = false; - - for (let i = start + 1; i < rawParameter.length; i++) { - const componentValue = rawParameter[i]; - - if (isWhiteSpaceOrCommentNode(componentValue)) { - continue; - } - - if (isTokenNode(componentValue) && isTokenColon(componentValue.value)) { - defaultValue = stringify([rawParameter.slice(i + 1)]).trim() || undefined; - break; - } - - hasType = true; - } - - // TODO: support typed arguments - if (hasType) { - return false; - } - - if (defaultValue && IS_IMPORTANT_REGEX.test(defaultValue)) { - return false; - } - - parameters.push({ - name, - defaultValue, - }); - } - - return parameters; -} diff --git a/plugins/postcss-mixins/test/_tape.mjs b/plugins/postcss-mixins/test/_tape.mjs index 63bcfd9bd6..22de84d026 100644 --- a/plugins/postcss-mixins/test/_tape.mjs +++ b/plugins/postcss-mixins/test/_tape.mjs @@ -65,6 +65,24 @@ postcssTape(plugin)({ preserve: true, }, }, + property: { + message: 'supports @property rules in @private rules', + }, + 'property:preserve-true': { + message: 'supports @property rules in @private rules with { preserve: true }', + options: { + preserve: true, + }, + }, + layer: { + message: 'drops @layer rules from mixin bodies', + }, + 'layer:preserve-true': { + message: 'drops @layer rules from mixin bodies with { preserve: true }', + options: { + preserve: true, + }, + }, invalid: { message: 'ignores invalid mixin invocations', }, diff --git a/plugins/postcss-mixins/test/arguments.css b/plugins/postcss-mixins/test/arguments.css index 8a03e21298..46d9b3c64f 100644 --- a/plugins/postcss-mixins/test/arguments.css +++ b/plugins/postcss-mixins/test/arguments.css @@ -46,3 +46,115 @@ .g { @apply --no-parameter-list; } + +@mixin --trailing-comma(--color,) { + border-color: var(--color); +} + +.h { + @apply --trailing-comma(green); +} + +@mixin --empty-arguments(--color, --background: teal) { + outline-color: var(--color); + background-color: var(--background); +} + +.i { + @apply --empty-arguments(, green); +} + +.j { + @apply --empty-arguments(green, ); +} + +.k { + @apply --empty-arguments(green, ,); +} + +.l { + @apply --empty-arguments(green, blue,); +} + +.m { + @apply --empty-arguments( green , blue ); +} + +@mixin --empty-default(--color:) { + outline-color: var(--color); +} + +.n { + @apply --empty-default; +} + +@mixin --one(--color) { + color: var(--color); +} + +.trailing-comma-single-argument { + @apply --one(red,); +} + +.invalid-important-argument { + @apply --one(red !important); +} + +.invalid-bang-argument { + @apply --one(!); +} + +.invalid-semicolon-argument { + @apply --one(red;); +} + +@mixin --inherit-default(--color: inherit) { + color: var(--color, red); +} + +.inherit-default { + --color: green; + @apply --inherit-default; +} + +@mixin --inherit-default-with-argument(--color: inherit) { + color: var(--color, red); +} + +.inherit-default-with-argument { + --color: green; + @apply --inherit-default-with-argument(blue); +} + +@mixin --inherit-argument(--color) { + color: var(--color, red); +} + +.inherit-argument { + --color: green; + @apply --inherit-argument(inherit); +} + +@mixin --universal-type(--color type(*)) { + color: var(--color); +} + +.universal-type { + @apply --universal-type(green); +} + +@mixin --invalid-default(--color: red !important) { + color: var(--color); +} + +.invalid-default { + @apply --invalid-default; +} + +@mixin --invalid-empty-parameter(--) { + color: red; +} + +.invalid-empty-parameter { + @apply --invalid-empty-parameter; +} diff --git a/plugins/postcss-mixins/test/arguments.expect.css b/plugins/postcss-mixins/test/arguments.expect.css index 510291deb9..73a7d8225c 100644 --- a/plugins/postcss-mixins/test/arguments.expect.css +++ b/plugins/postcss-mixins/test/arguments.expect.css @@ -1,41 +1,161 @@ .a { - --_csstools-p-165tpc7-0--arg-0: green; - --_csstools-p-165tpc7-1--color: var(--_csstools-p-165tpc7-0--arg-0); - color: var(--_csstools-p-165tpc7-1--color); + --_csstools-m-165tpc7-0--arg-0: green; + --_csstools-m-165tpc7-1--color: var(--_csstools-m-165tpc7-0--arg-0); + color: var(--_csstools-m-165tpc7-1--color); } .b { - --_csstools-p-165tpc7-2--color: blue; - --_csstools-p-165tpc7-2--background: red; - color: var(--_csstools-p-165tpc7-2--color); - background-color: var(--_csstools-p-165tpc7-2--background); + --_csstools-m-165tpc7-2--color: blue; + --_csstools-m-165tpc7-2--background: red; + color: var(--_csstools-m-165tpc7-2--color); + background-color: var(--_csstools-m-165tpc7-2--background); } .c { - --_csstools-p-165tpc7-3--arg-1: red; - --_csstools-p-165tpc7-4--color: var(--_csstools-p-165tpc7-3--arg-1); - --_csstools-p-165tpc7-4--background: red; - color: var(--_csstools-p-165tpc7-4--color); - background-color: var(--_csstools-p-165tpc7-4--background); + --_csstools-m-165tpc7-3--arg-1: red; + --_csstools-m-165tpc7-4--color: var(--_csstools-m-165tpc7-3--arg-1); + --_csstools-m-165tpc7-4--background: red; + color: var(--_csstools-m-165tpc7-4--color); + background-color: var(--_csstools-m-165tpc7-4--background); } .d { - --_csstools-p-165tpc7-5--color: initial; - outline-color: var(--_csstools-p-165tpc7-5--color, navy); + --_csstools-m-165tpc7-5--color: initial; + outline-color: var(--_csstools-m-165tpc7-5--color, navy); } .e { - --_csstools-p-165tpc7-6--arg-2: green; - --_csstools-p-165tpc7-7--color: var(--_csstools-p-165tpc7-6--arg-2); - outline-color: var(--_csstools-p-165tpc7-7--color, navy); + --_csstools-m-165tpc7-6--arg-2: green; + --_csstools-m-165tpc7-7--color: var(--_csstools-m-165tpc7-6--arg-2); + outline-color: var(--_csstools-m-165tpc7-7--color, navy); } .f { - --_csstools-p-165tpc7-8--arg-3: color, background; - --_csstools-p-165tpc7-9--list: var(--_csstools-p-165tpc7-8--arg-3); - transition-property: var(--_csstools-p-165tpc7-9--list); + --_csstools-m-165tpc7-8--arg-3: color, background; + --_csstools-m-165tpc7-9--list: var(--_csstools-m-165tpc7-8--arg-3); + transition-property: var(--_csstools-m-165tpc7-9--list); } .g { border: 1px solid green; } + +.h { + --_csstools-m-165tpc7-a--arg-4: green; + --_csstools-m-165tpc7-b--color: var(--_csstools-m-165tpc7-a--arg-4); + border-color: var(--_csstools-m-165tpc7-b--color); +} + +.i { + --_csstools-m-165tpc7-c--arg-5: ; + --_csstools-m-165tpc7-c--arg-6: green; + --_csstools-m-165tpc7-d--color: var(--_csstools-m-165tpc7-c--arg-5); + --_csstools-m-165tpc7-d--background: var(--_csstools-m-165tpc7-c--arg-6); + outline-color: var(--_csstools-m-165tpc7-d--color); + background-color: var(--_csstools-m-165tpc7-d--background); +} + +.j { + --_csstools-m-165tpc7-e--arg-7: green; + --_csstools-m-165tpc7-f--color: var(--_csstools-m-165tpc7-e--arg-7); + --_csstools-m-165tpc7-f--background: teal; + outline-color: var(--_csstools-m-165tpc7-f--color); + background-color: var(--_csstools-m-165tpc7-f--background); +} + +.k { + --_csstools-m-165tpc7-g--arg-8: green; + --_csstools-m-165tpc7-g--arg-9: ; + --_csstools-m-165tpc7-h--color: var(--_csstools-m-165tpc7-g--arg-8); + --_csstools-m-165tpc7-h--background: var(--_csstools-m-165tpc7-g--arg-9); + outline-color: var(--_csstools-m-165tpc7-h--color); + background-color: var(--_csstools-m-165tpc7-h--background); +} + +.l { + --_csstools-m-165tpc7-i--arg-a: green; + --_csstools-m-165tpc7-i--arg-b: blue; + --_csstools-m-165tpc7-j--color: var(--_csstools-m-165tpc7-i--arg-a); + --_csstools-m-165tpc7-j--background: var(--_csstools-m-165tpc7-i--arg-b); + outline-color: var(--_csstools-m-165tpc7-j--color); + background-color: var(--_csstools-m-165tpc7-j--background); +} + +.m { + --_csstools-m-165tpc7-k--arg-c: green; + --_csstools-m-165tpc7-k--arg-d: blue; + --_csstools-m-165tpc7-l--color: var(--_csstools-m-165tpc7-k--arg-c); + --_csstools-m-165tpc7-l--background: var(--_csstools-m-165tpc7-k--arg-d); + outline-color: var(--_csstools-m-165tpc7-l--color); + background-color: var(--_csstools-m-165tpc7-l--background); +} + +.n { + --_csstools-m-165tpc7-m--color: ; + outline-color: var(--_csstools-m-165tpc7-m--color); +} + +@mixin --one(--color) { + color: var(--color); +} + +.trailing-comma-single-argument { + --_csstools-m-165tpc7-n--arg-e: red; + --_csstools-m-165tpc7-o--color: var(--_csstools-m-165tpc7-n--arg-e); + color: var(--_csstools-m-165tpc7-o--color); +} + +.invalid-important-argument { + @apply --one(red !important); +} + +.invalid-bang-argument { + @apply --one(!); +} + +.invalid-semicolon-argument { + @apply --one(red;); +} + +.inherit-default { + --color: green; + --_csstools-m-165tpc7-p--arg-f: var(--color); + --_csstools-m-165tpc7-q--color: var(--_csstools-m-165tpc7-p--arg-f); + color: var(--_csstools-m-165tpc7-q--color, red); +} + +.inherit-default-with-argument { + --color: green; + --_csstools-m-165tpc7-r--arg-g: blue; + --_csstools-m-165tpc7-s--color: var(--_csstools-m-165tpc7-r--arg-g); + color: var(--_csstools-m-165tpc7-s--color, red); +} + +.inherit-argument { + --color: green; + --_csstools-m-165tpc7-t--arg-h: var(--color); + --_csstools-m-165tpc7-u--color: var(--_csstools-m-165tpc7-t--arg-h); + color: var(--_csstools-m-165tpc7-u--color, red); +} + +.universal-type { + --_csstools-m-165tpc7-v--arg-i: green; + --_csstools-m-165tpc7-w--color: var(--_csstools-m-165tpc7-v--arg-i); + color: var(--_csstools-m-165tpc7-w--color); +} + +@mixin --invalid-default(--color: red !important) { + color: var(--color); +} + +.invalid-default { + @apply --invalid-default; +} + +@mixin --invalid-empty-parameter(--) { + color: red; +} + +.invalid-empty-parameter { + @apply --invalid-empty-parameter; +} diff --git a/plugins/postcss-mixins/test/arguments.preserve-true.expect.css b/plugins/postcss-mixins/test/arguments.preserve-true.expect.css index 012391cd87..517db1e77f 100644 --- a/plugins/postcss-mixins/test/arguments.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/arguments.preserve-true.expect.css @@ -3,9 +3,9 @@ } .a { - --_csstools-p-165tpc7-0--arg-0: green; - --_csstools-p-165tpc7-1--color: var(--_csstools-p-165tpc7-0--arg-0); - color: var(--_csstools-p-165tpc7-1--color); + --_csstools-m-165tpc7-0--arg-0: green; + --_csstools-m-165tpc7-1--color: var(--_csstools-m-165tpc7-0--arg-0); + color: var(--_csstools-m-165tpc7-1--color); @apply --basic(green); } @@ -15,19 +15,19 @@ } .b { - --_csstools-p-165tpc7-2--color: blue; - --_csstools-p-165tpc7-2--background: red; - color: var(--_csstools-p-165tpc7-2--color); - background-color: var(--_csstools-p-165tpc7-2--background); + --_csstools-m-165tpc7-2--color: blue; + --_csstools-m-165tpc7-2--background: red; + color: var(--_csstools-m-165tpc7-2--color); + background-color: var(--_csstools-m-165tpc7-2--background); @apply --defaults; } .c { - --_csstools-p-165tpc7-3--arg-1: red; - --_csstools-p-165tpc7-4--color: var(--_csstools-p-165tpc7-3--arg-1); - --_csstools-p-165tpc7-4--background: red; - color: var(--_csstools-p-165tpc7-4--color); - background-color: var(--_csstools-p-165tpc7-4--background); + --_csstools-m-165tpc7-3--arg-1: red; + --_csstools-m-165tpc7-4--color: var(--_csstools-m-165tpc7-3--arg-1); + --_csstools-m-165tpc7-4--background: red; + color: var(--_csstools-m-165tpc7-4--color); + background-color: var(--_csstools-m-165tpc7-4--background); @apply --defaults(red); } @@ -36,15 +36,15 @@ } .d { - --_csstools-p-165tpc7-5--color: initial; - outline-color: var(--_csstools-p-165tpc7-5--color, navy); + --_csstools-m-165tpc7-5--color: initial; + outline-color: var(--_csstools-m-165tpc7-5--color, navy); @apply --fallback; } .e { - --_csstools-p-165tpc7-6--arg-2: green; - --_csstools-p-165tpc7-7--color: var(--_csstools-p-165tpc7-6--arg-2); - outline-color: var(--_csstools-p-165tpc7-7--color, navy); + --_csstools-m-165tpc7-6--arg-2: green; + --_csstools-m-165tpc7-7--color: var(--_csstools-m-165tpc7-6--arg-2); + outline-color: var(--_csstools-m-165tpc7-7--color, navy); @apply --fallback(green); } @@ -53,9 +53,9 @@ } .f { - --_csstools-p-165tpc7-8--arg-3: color, background; - --_csstools-p-165tpc7-9--list: var(--_csstools-p-165tpc7-8--arg-3); - transition-property: var(--_csstools-p-165tpc7-9--list); + --_csstools-m-165tpc7-8--arg-3: color, background; + --_csstools-m-165tpc7-9--list: var(--_csstools-m-165tpc7-8--arg-3); + transition-property: var(--_csstools-m-165tpc7-9--list); @apply --braces({color, background}); } @@ -67,3 +67,164 @@ border: 1px solid green; @apply --no-parameter-list; } + +@mixin --trailing-comma(--color,) { + border-color: var(--color); +} + +.h { + --_csstools-m-165tpc7-a--arg-4: green; + --_csstools-m-165tpc7-b--color: var(--_csstools-m-165tpc7-a--arg-4); + border-color: var(--_csstools-m-165tpc7-b--color); + @apply --trailing-comma(green); +} + +@mixin --empty-arguments(--color, --background: teal) { + outline-color: var(--color); + background-color: var(--background); +} + +.i { + --_csstools-m-165tpc7-c--arg-5: ; + --_csstools-m-165tpc7-c--arg-6: green; + --_csstools-m-165tpc7-d--color: var(--_csstools-m-165tpc7-c--arg-5); + --_csstools-m-165tpc7-d--background: var(--_csstools-m-165tpc7-c--arg-6); + outline-color: var(--_csstools-m-165tpc7-d--color); + background-color: var(--_csstools-m-165tpc7-d--background); + @apply --empty-arguments(, green); +} + +.j { + --_csstools-m-165tpc7-e--arg-7: green; + --_csstools-m-165tpc7-f--color: var(--_csstools-m-165tpc7-e--arg-7); + --_csstools-m-165tpc7-f--background: teal; + outline-color: var(--_csstools-m-165tpc7-f--color); + background-color: var(--_csstools-m-165tpc7-f--background); + @apply --empty-arguments(green, ); +} + +.k { + --_csstools-m-165tpc7-g--arg-8: green; + --_csstools-m-165tpc7-g--arg-9: ; + --_csstools-m-165tpc7-h--color: var(--_csstools-m-165tpc7-g--arg-8); + --_csstools-m-165tpc7-h--background: var(--_csstools-m-165tpc7-g--arg-9); + outline-color: var(--_csstools-m-165tpc7-h--color); + background-color: var(--_csstools-m-165tpc7-h--background); + @apply --empty-arguments(green, ,); +} + +.l { + --_csstools-m-165tpc7-i--arg-a: green; + --_csstools-m-165tpc7-i--arg-b: blue; + --_csstools-m-165tpc7-j--color: var(--_csstools-m-165tpc7-i--arg-a); + --_csstools-m-165tpc7-j--background: var(--_csstools-m-165tpc7-i--arg-b); + outline-color: var(--_csstools-m-165tpc7-j--color); + background-color: var(--_csstools-m-165tpc7-j--background); + @apply --empty-arguments(green, blue,); +} + +.m { + --_csstools-m-165tpc7-k--arg-c: green; + --_csstools-m-165tpc7-k--arg-d: blue; + --_csstools-m-165tpc7-l--color: var(--_csstools-m-165tpc7-k--arg-c); + --_csstools-m-165tpc7-l--background: var(--_csstools-m-165tpc7-k--arg-d); + outline-color: var(--_csstools-m-165tpc7-l--color); + background-color: var(--_csstools-m-165tpc7-l--background); + @apply --empty-arguments( green , blue ); +} + +@mixin --empty-default(--color:) { + outline-color: var(--color); +} + +.n { + --_csstools-m-165tpc7-m--color: ; + outline-color: var(--_csstools-m-165tpc7-m--color); + @apply --empty-default; +} + +@mixin --one(--color) { + color: var(--color); +} + +.trailing-comma-single-argument { + --_csstools-m-165tpc7-n--arg-e: red; + --_csstools-m-165tpc7-o--color: var(--_csstools-m-165tpc7-n--arg-e); + color: var(--_csstools-m-165tpc7-o--color); + @apply --one(red,); +} + +.invalid-important-argument { + @apply --one(red !important); +} + +.invalid-bang-argument { + @apply --one(!); +} + +.invalid-semicolon-argument { + @apply --one(red;); +} + +@mixin --inherit-default(--color: inherit) { + color: var(--color, red); +} + +.inherit-default { + --color: green; + --_csstools-m-165tpc7-p--arg-f: var(--color); + --_csstools-m-165tpc7-q--color: var(--_csstools-m-165tpc7-p--arg-f); + color: var(--_csstools-m-165tpc7-q--color, red); + @apply --inherit-default; +} + +@mixin --inherit-default-with-argument(--color: inherit) { + color: var(--color, red); +} + +.inherit-default-with-argument { + --color: green; + --_csstools-m-165tpc7-r--arg-g: blue; + --_csstools-m-165tpc7-s--color: var(--_csstools-m-165tpc7-r--arg-g); + color: var(--_csstools-m-165tpc7-s--color, red); + @apply --inherit-default-with-argument(blue); +} + +@mixin --inherit-argument(--color) { + color: var(--color, red); +} + +.inherit-argument { + --color: green; + --_csstools-m-165tpc7-t--arg-h: var(--color); + --_csstools-m-165tpc7-u--color: var(--_csstools-m-165tpc7-t--arg-h); + color: var(--_csstools-m-165tpc7-u--color, red); + @apply --inherit-argument(inherit); +} + +@mixin --universal-type(--color type(*)) { + color: var(--color); +} + +.universal-type { + --_csstools-m-165tpc7-v--arg-i: green; + --_csstools-m-165tpc7-w--color: var(--_csstools-m-165tpc7-v--arg-i); + color: var(--_csstools-m-165tpc7-w--color); + @apply --universal-type(green); +} + +@mixin --invalid-default(--color: red !important) { + color: var(--color); +} + +.invalid-default { + @apply --invalid-default; +} + +@mixin --invalid-empty-parameter(--) { + color: red; +} + +.invalid-empty-parameter { + @apply --invalid-empty-parameter; +} diff --git a/plugins/postcss-mixins/test/basic.css b/plugins/postcss-mixins/test/basic.css index 3217680dce..d3a453d6d3 100644 --- a/plugins/postcss-mixins/test/basic.css +++ b/plugins/postcss-mixins/test/basic.css @@ -29,3 +29,11 @@ order: 1; } + +@mixin --\65 scaped() { + color: green; +} + +.escaped-name { + @apply --\65 scaped; +} diff --git a/plugins/postcss-mixins/test/basic.expect.css b/plugins/postcss-mixins/test/basic.expect.css index 73878cce64..00593c13e7 100644 --- a/plugins/postcss-mixins/test/basic.expect.css +++ b/plugins/postcss-mixins/test/basic.expect.css @@ -1,9 +1,13 @@ +@mixin --foo() { + color: green; +} + .foo { color: green; } @scope (.foo) { - color: green; + @apply --foo(); } .bar { @@ -24,3 +28,7 @@ order: 1; } + +.escaped-name { + color: green; +} diff --git a/plugins/postcss-mixins/test/basic.preserve-true.expect.css b/plugins/postcss-mixins/test/basic.preserve-true.expect.css index 3900c04f84..7fa8edc528 100644 --- a/plugins/postcss-mixins/test/basic.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/basic.preserve-true.expect.css @@ -8,7 +8,6 @@ } @scope (.foo) { - color: green; @apply --foo(); } @@ -41,3 +40,12 @@ order: 1; } + +@mixin --\65 scaped() { + color: green; +} + +.escaped-name { + color: green; + @apply --\65 scaped; +} diff --git a/plugins/postcss-mixins/test/contents.css b/plugins/postcss-mixins/test/contents.css index d6ab4193db..5b69afea60 100644 --- a/plugins/postcss-mixins/test/contents.css +++ b/plugins/postcss-mixins/test/contents.css @@ -69,3 +69,113 @@ background-color: var(--color); } } + +@mixin --fallback-argument(--color) { + @contents { + color: var(--color); + } +} + +.fallback-argument { + --color: blue; + @apply --fallback-argument(red); +} + +@mixin --contents-inner() { + @contents; +} + +@mixin --contents-outer(--color) { + @apply --contents-inner { + color: var(--color); + } +} + +.contents-outer { + --color: blue; + @apply --contents-outer(red); +} + +@mixin --fallback-private() { + @contents { + @private { + --x: red; + } + color: var(--x); + } +} + +.fallback-private { + @apply --fallback-private; +} + +@mixin --discarded-fallback() { + @contents { + @private { + --x: red; + } + } + color: var(--x); +} + +.discarded-fallback { + --x: green; + @apply --discarded-fallback { + color: blue; + } +} + +@mixin --contents-scope() { + @private { + --size: 20px; + } + @contents; +} + +.contents-scope { + @apply --contents-scope { + width: var(--size, 33px); + } +} + +@mixin --fallback-nested-rule(--color) { + @contents { + & .nested-fallback { + color: var(--color); + } + } +} + +.fallback-nested-rule { + @apply --fallback-nested-rule(red); +} + +@mixin --contents-inner-private() { + @contents; +} + +@mixin --contents-outer-private(--color) { + @apply --contents-inner-private { + @private { + --local: var(--color); + } + color: var(--local); + } +} + +.contents-outer-private { + @apply --contents-outer-private(red); +} + +@mixin --contents-apply-private() { + @contents; +} + +.contents-apply-private { + @private { + --size: 1px; + } + @apply --contents-apply-private { + width: var(--size); + } +} diff --git a/plugins/postcss-mixins/test/contents.expect.css b/plugins/postcss-mixins/test/contents.expect.css index 5e42d2ef51..662f473c08 100644 --- a/plugins/postcss-mixins/test/contents.expect.css +++ b/plugins/postcss-mixins/test/contents.expect.css @@ -34,8 +34,58 @@ } .i { - --_csstools-p-1i0jh25-0--arg-0: green; - --_csstools-p-1i0jh25-1--color: var(--_csstools-p-1i0jh25-0--arg-0); - color: var(--_csstools-p-1i0jh25-1--color); + --_csstools-m-1i0jh25-0--arg-0: green; + --_csstools-m-1i0jh25-1--color: var(--_csstools-m-1i0jh25-0--arg-0); + color: var(--_csstools-m-1i0jh25-1--color); background-color: var(--color) } + +.fallback-argument { + --color: blue; + --_csstools-m-1i0jh25-2--arg-1: red; + --_csstools-m-1i0jh25-3--color: var(--_csstools-m-1i0jh25-2--arg-1); + color: var(--_csstools-m-1i0jh25-3--color); +} + +.contents-outer { + --color: blue; + --_csstools-m-1i0jh25-4--arg-2: red; + --_csstools-m-1i0jh25-5--color: var(--_csstools-m-1i0jh25-4--arg-2); + color: var(--_csstools-m-1i0jh25-5--color); +} + +.fallback-private { + --_csstools-m-1i0jh25-6--x: red; + color: var(--_csstools-m-1i0jh25-6--x); +} + +.discarded-fallback { + --x: green; + color: blue; + color: var(--x) +} + +.contents-scope { + --_csstools-m-1i0jh25-7--size: 20px; + width: var(--size, 33px) +} + +.fallback-nested-rule { + --_csstools-m-1i0jh25-8--arg-3: red; + --_csstools-m-1i0jh25-9--color: var(--_csstools-m-1i0jh25-8--arg-3); + & .nested-fallback { + color: var(--_csstools-m-1i0jh25-9--color); + } +} + +.contents-outer-private { + --_csstools-m-1i0jh25-a--arg-4: red; + --_csstools-m-1i0jh25-b--color: var(--_csstools-m-1i0jh25-a--arg-4); + --_csstools-m-1i0jh25-b--local: var(--_csstools-m-1i0jh25-b--color); + color: var(--_csstools-m-1i0jh25-b--local); +} + +.contents-apply-private { + --_csstools-p-1i0jh25-0--size: 1px; + width: var(--_csstools-p-1i0jh25-0--size) +} diff --git a/plugins/postcss-mixins/test/contents.preserve-true.expect.css b/plugins/postcss-mixins/test/contents.preserve-true.expect.css index d9dc5645c6..decc91b85b 100644 --- a/plugins/postcss-mixins/test/contents.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/contents.preserve-true.expect.css @@ -76,11 +76,144 @@ } .i { - --_csstools-p-1i0jh25-0--arg-0: green; - --_csstools-p-1i0jh25-1--color: var(--_csstools-p-1i0jh25-0--arg-0); - color: var(--_csstools-p-1i0jh25-1--color); + --_csstools-m-1i0jh25-0--arg-0: green; + --_csstools-m-1i0jh25-1--color: var(--_csstools-m-1i0jh25-0--arg-0); + color: var(--_csstools-m-1i0jh25-1--color); background-color: var(--color); @apply --args-and-contents(green) { background-color: var(--color); } } + +@mixin --fallback-argument(--color) { + @contents { + color: var(--color); + } +} + +.fallback-argument { + --color: blue; + --_csstools-m-1i0jh25-2--arg-1: red; + --_csstools-m-1i0jh25-3--color: var(--_csstools-m-1i0jh25-2--arg-1); + color: var(--_csstools-m-1i0jh25-3--color); + @apply --fallback-argument(red); +} + +@mixin --contents-inner() { + @contents; +} + +@mixin --contents-outer(--color) { + @apply --contents-inner { + color: var(--color); + } +} + +.contents-outer { + --color: blue; + --_csstools-m-1i0jh25-4--arg-2: red; + --_csstools-m-1i0jh25-5--color: var(--_csstools-m-1i0jh25-4--arg-2); + color: var(--_csstools-m-1i0jh25-5--color); + @apply --contents-outer(red); +} + +@mixin --fallback-private() { + @contents { + @private { + --x: red; + } + color: var(--x); + } +} + +.fallback-private { + --_csstools-m-1i0jh25-6--x: red; + color: var(--_csstools-m-1i0jh25-6--x); + @apply --fallback-private; +} + +@mixin --discarded-fallback() { + @contents { + @private { + --x: red; + } + } + color: var(--x); +} + +.discarded-fallback { + --x: green; + color: blue; + color: var(--x); + @apply --discarded-fallback { + color: blue; + } +} + +@mixin --contents-scope() { + @private { + --size: 20px; + } + @contents; +} + +.contents-scope { + --_csstools-m-1i0jh25-7--size: 20px; + width: var(--size, 33px); + @apply --contents-scope { + width: var(--size, 33px); + } +} + +@mixin --fallback-nested-rule(--color) { + @contents { + & .nested-fallback { + color: var(--color); + } + } +} + +.fallback-nested-rule { + --_csstools-m-1i0jh25-8--arg-3: red; + --_csstools-m-1i0jh25-9--color: var(--_csstools-m-1i0jh25-8--arg-3); + & .nested-fallback { + color: var(--_csstools-m-1i0jh25-9--color); + } + @apply --fallback-nested-rule(red); +} + +@mixin --contents-inner-private() { + @contents; +} + +@mixin --contents-outer-private(--color) { + @apply --contents-inner-private { + @private { + --local: var(--color); + } + color: var(--local); + } +} + +.contents-outer-private { + --_csstools-m-1i0jh25-a--arg-4: red; + --_csstools-m-1i0jh25-b--color: var(--_csstools-m-1i0jh25-a--arg-4); + --_csstools-m-1i0jh25-b--local: var(--_csstools-m-1i0jh25-b--color); + color: var(--_csstools-m-1i0jh25-b--local); + @apply --contents-outer-private(red); +} + +@mixin --contents-apply-private() { + @contents; +} + +.contents-apply-private { + --_csstools-p-1i0jh25-0--size: 1px; + @private { + --size: 1px; + } + width: var(--_csstools-p-1i0jh25-0--size); + @apply --contents-apply-private { + width: var(--size); + } +} diff --git a/plugins/postcss-mixins/test/examples/example.expect.css b/plugins/postcss-mixins/test/examples/example.expect.css index be1ce98b68..fdc06e4f2e 100644 --- a/plugins/postcss-mixins/test/examples/example.expect.css +++ b/plugins/postcss-mixins/test/examples/example.expect.css @@ -3,9 +3,9 @@ } .bar { - --_csstools-p-1gice1e-0--arg-0: 200; - --_csstools-p-1gice1e-1--baz: var(--_csstools-p-1gice1e-0--arg-0); - color: rgb(var(--_csstools-p-1gice1e-1--baz) 127 0); + --_csstools-m-1gice1e-0--arg-0: 200; + --_csstools-m-1gice1e-1--baz: var(--_csstools-m-1gice1e-0--arg-0); + color: rgb(var(--_csstools-m-1gice1e-1--baz) 127 0); } .c { diff --git a/plugins/postcss-mixins/test/examples/example.preserve-true.expect.css b/plugins/postcss-mixins/test/examples/example.preserve-true.expect.css index 79a9e59080..39d9fab458 100644 --- a/plugins/postcss-mixins/test/examples/example.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/examples/example.preserve-true.expect.css @@ -12,9 +12,9 @@ } .bar { - --_csstools-p-1gice1e-0--arg-0: 200; - --_csstools-p-1gice1e-1--baz: var(--_csstools-p-1gice1e-0--arg-0); - color: rgb(var(--_csstools-p-1gice1e-1--baz) 127 0); + --_csstools-m-1gice1e-0--arg-0: 200; + --_csstools-m-1gice1e-1--baz: var(--_csstools-m-1gice1e-0--arg-0); + color: rgb(var(--_csstools-m-1gice1e-1--baz) 127 0); @apply --bar(200); } diff --git a/plugins/postcss-mixins/test/ignore.css b/plugins/postcss-mixins/test/ignore.css index 5f98dd28f4..edb917ef83 100644 --- a/plugins/postcss-mixins/test/ignore.css +++ b/plugins/postcss-mixins/test/ignore.css @@ -10,16 +10,6 @@ @apply --ignore-a; } -@mixin --ignore-b { - @result { - color: green; - } -} - -.ignore-b { - @apply --ignore-b; -} - @media screen { @mixin --ignore-c { color: red; @@ -62,10 +52,16 @@ @apply --ignore-i; } -@mixin --ignore-j(--color,) { - color: var(--color); +@mixin --ignore-k() { + color: red; +} + +@media screen { + @mixin --ignore-l() { + @apply --ignore-k; + } } -.ignore-j { - @apply --ignore-j(red); +.ignore-l { + @apply --ignore-l; } diff --git a/plugins/postcss-mixins/test/invalid.css b/plugins/postcss-mixins/test/invalid.css index fd1327cf63..93122c65a3 100644 --- a/plugins/postcss-mixins/test/invalid.css +++ b/plugins/postcss-mixins/test/invalid.css @@ -10,10 +10,6 @@ @apply --one(red !important); } -.trailing-empty-argument { - @apply --one(red,); -} - .leading-empty-argument { @apply --one(,red); } diff --git a/plugins/postcss-mixins/test/invalid.expect.css b/plugins/postcss-mixins/test/invalid.expect.css index d5d99732c0..93122c65a3 100644 --- a/plugins/postcss-mixins/test/invalid.expect.css +++ b/plugins/postcss-mixins/test/invalid.expect.css @@ -1,3 +1,7 @@ +@mixin --one(--color) { + color: var(--color); +} + .too-many-arguments { @apply --one(green, blue); } @@ -6,10 +10,6 @@ @apply --one(red !important); } -.trailing-empty-argument { - @apply --one(red,); -} - .leading-empty-argument { @apply --one(,red); } @@ -18,6 +18,10 @@ @apply --one(red,,blue); } +@mixin --defined() { + color: green; +} + @apply --defined; @media screen { diff --git a/plugins/postcss-mixins/test/invalid.preserve-true.expect.css b/plugins/postcss-mixins/test/invalid.preserve-true.expect.css index fd1327cf63..93122c65a3 100644 --- a/plugins/postcss-mixins/test/invalid.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/invalid.preserve-true.expect.css @@ -10,10 +10,6 @@ @apply --one(red !important); } -.trailing-empty-argument { - @apply --one(red,); -} - .leading-empty-argument { @apply --one(,red); } diff --git a/plugins/postcss-mixins/test/layer.css b/plugins/postcss-mixins/test/layer.css new file mode 100644 index 0000000000..d208905c28 --- /dev/null +++ b/plugins/postcss-mixins/test/layer.css @@ -0,0 +1,35 @@ +@mixin --with-layer() { + @layer one { + color: red; + } + + @layer two { + @layer three { + color: orange; + } + } + + @media (min-width: 1px) { + @layer four { + color: yellow; + } + + color: green; + } + + color: blue; +} + +.layer { + @apply --with-layer; +} + +@mixin --only-layer() { + @layer one { + color: red; + } +} + +.only-layer { + @apply --only-layer; +} diff --git a/plugins/postcss-mixins/test/layer.expect.css b/plugins/postcss-mixins/test/layer.expect.css new file mode 100644 index 0000000000..d2d1a4da75 --- /dev/null +++ b/plugins/postcss-mixins/test/layer.expect.css @@ -0,0 +1,12 @@ +.layer { + + @media (min-width: 1px) { + + color: green; + } + + color: blue; +} + +.only-layer { +} diff --git a/plugins/postcss-mixins/test/layer.preserve-true.expect.css b/plugins/postcss-mixins/test/layer.preserve-true.expect.css new file mode 100644 index 0000000000..fe6f1b78f6 --- /dev/null +++ b/plugins/postcss-mixins/test/layer.preserve-true.expect.css @@ -0,0 +1,42 @@ +@mixin --with-layer() { + @layer one { + color: red; + } + + @layer two { + @layer three { + color: orange; + } + } + + @media (min-width: 1px) { + @layer four { + color: yellow; + } + + color: green; + } + + color: blue; +} + +.layer { + + @media (min-width: 1px) { + + color: green; + } + + color: blue; + @apply --with-layer; +} + +@mixin --only-layer() { + @layer one { + color: red; + } +} + +.only-layer { + @apply --only-layer; +} diff --git a/plugins/postcss-mixins/test/nested-mixins.css b/plugins/postcss-mixins/test/nested-mixins.css index e407432238..da543b0a15 100644 --- a/plugins/postcss-mixins/test/nested-mixins.css +++ b/plugins/postcss-mixins/test/nested-mixins.css @@ -47,3 +47,32 @@ .d { @apply --cycle-a; } + +@mixin --nested-argument-inner() { + color: var(--color); +} + +@mixin --nested-argument-outer(--color) { + @apply --nested-argument-inner; +} + +.nested-argument { + --color: blue; + @apply --nested-argument-outer(red); +} + +@mixin --nested-private-inner() { + color: var(--x); +} + +@mixin --nested-private-outer() { + @private { + --x: red; + } + @apply --nested-private-inner; +} + +.nested-private { + --color: blue; + @apply --nested-private-outer; +} diff --git a/plugins/postcss-mixins/test/nested-mixins.expect.css b/plugins/postcss-mixins/test/nested-mixins.expect.css index 6c662c96eb..8ef69e7049 100644 --- a/plugins/postcss-mixins/test/nested-mixins.expect.css +++ b/plugins/postcss-mixins/test/nested-mixins.expect.css @@ -4,22 +4,43 @@ } .b { - --_csstools-p-1rmdrz7-0--arg-0: red; - --_csstools-p-1rmdrz7-1--outer-color: var(--_csstools-p-1rmdrz7-0--arg-0); - --_csstools-p-1rmdrz7-2--arg-1: var(--_csstools-p-1rmdrz7-1--outer-color); - --_csstools-p-1rmdrz7-3--inner-color: var(--_csstools-p-1rmdrz7-2--arg-1); - border-color: var(--_csstools-p-1rmdrz7-3--inner-color); + --_csstools-m-1rmdrz7-0--arg-0: red; + --_csstools-m-1rmdrz7-1--outer-color: var(--_csstools-m-1rmdrz7-0--arg-0); + --_csstools-m-1rmdrz7-2--arg-1: var(--_csstools-m-1rmdrz7-1--outer-color); + --_csstools-m-1rmdrz7-3--inner-color: var(--_csstools-m-1rmdrz7-2--arg-1); + border-color: var(--_csstools-m-1rmdrz7-3--inner-color); } .c { - --_csstools-p-1rmdrz7-4--arg-2: red; - --_csstools-p-1rmdrz7-5--color: var(--_csstools-p-1rmdrz7-4--arg-2); - --_csstools-p-1rmdrz7-6--arg-3: blue; - --_csstools-p-1rmdrz7-7--color: var(--_csstools-p-1rmdrz7-6--arg-3); - border-color: var(--_csstools-p-1rmdrz7-7--color); - color: var(--_csstools-p-1rmdrz7-5--color); + --_csstools-m-1rmdrz7-4--arg-2: red; + --_csstools-m-1rmdrz7-5--color: var(--_csstools-m-1rmdrz7-4--arg-2); + --_csstools-m-1rmdrz7-6--arg-3: blue; + --_csstools-m-1rmdrz7-7--color: var(--_csstools-m-1rmdrz7-6--arg-3); + border-color: var(--_csstools-m-1rmdrz7-7--color); + color: var(--_csstools-m-1rmdrz7-5--color); +} + +@mixin --cycle-a() { + @apply --cycle-b; +} + +@mixin --cycle-b() { + @apply --cycle-a; } .d { @apply --cycle-a; } + +.nested-argument { + --color: blue; + --_csstools-m-1rmdrz7-8--arg-4: red; + --_csstools-m-1rmdrz7-9--color: var(--_csstools-m-1rmdrz7-8--arg-4); + color: var(--_csstools-m-1rmdrz7-9--color); +} + +.nested-private { + --color: blue; + --_csstools-m-1rmdrz7-a--x: red; + color: var(--_csstools-m-1rmdrz7-a--x); +} diff --git a/plugins/postcss-mixins/test/nested-mixins.preserve-true.expect.css b/plugins/postcss-mixins/test/nested-mixins.preserve-true.expect.css index f417dceb0c..ee8a45c070 100644 --- a/plugins/postcss-mixins/test/nested-mixins.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/nested-mixins.preserve-true.expect.css @@ -22,11 +22,11 @@ } .b { - --_csstools-p-1rmdrz7-0--arg-0: red; - --_csstools-p-1rmdrz7-1--outer-color: var(--_csstools-p-1rmdrz7-0--arg-0); - --_csstools-p-1rmdrz7-2--arg-1: var(--_csstools-p-1rmdrz7-1--outer-color); - --_csstools-p-1rmdrz7-3--inner-color: var(--_csstools-p-1rmdrz7-2--arg-1); - border-color: var(--_csstools-p-1rmdrz7-3--inner-color); + --_csstools-m-1rmdrz7-0--arg-0: red; + --_csstools-m-1rmdrz7-1--outer-color: var(--_csstools-m-1rmdrz7-0--arg-0); + --_csstools-m-1rmdrz7-2--arg-1: var(--_csstools-m-1rmdrz7-1--outer-color); + --_csstools-m-1rmdrz7-3--inner-color: var(--_csstools-m-1rmdrz7-2--arg-1); + border-color: var(--_csstools-m-1rmdrz7-3--inner-color); @apply --outer-args(red); } @@ -40,12 +40,12 @@ } .c { - --_csstools-p-1rmdrz7-4--arg-2: red; - --_csstools-p-1rmdrz7-5--color: var(--_csstools-p-1rmdrz7-4--arg-2); - --_csstools-p-1rmdrz7-6--arg-3: blue; - --_csstools-p-1rmdrz7-7--color: var(--_csstools-p-1rmdrz7-6--arg-3); - border-color: var(--_csstools-p-1rmdrz7-7--color); - color: var(--_csstools-p-1rmdrz7-5--color); + --_csstools-m-1rmdrz7-4--arg-2: red; + --_csstools-m-1rmdrz7-5--color: var(--_csstools-m-1rmdrz7-4--arg-2); + --_csstools-m-1rmdrz7-6--arg-3: blue; + --_csstools-m-1rmdrz7-7--color: var(--_csstools-m-1rmdrz7-6--arg-3); + border-color: var(--_csstools-m-1rmdrz7-7--color); + color: var(--_csstools-m-1rmdrz7-5--color); @apply --shadow-outer(red); } @@ -59,5 +59,38 @@ .d { @apply --cycle-a; - @apply --cycle-a; +} + +@mixin --nested-argument-inner() { + color: var(--color); +} + +@mixin --nested-argument-outer(--color) { + @apply --nested-argument-inner; +} + +.nested-argument { + --color: blue; + --_csstools-m-1rmdrz7-8--arg-4: red; + --_csstools-m-1rmdrz7-9--color: var(--_csstools-m-1rmdrz7-8--arg-4); + color: var(--_csstools-m-1rmdrz7-9--color); + @apply --nested-argument-outer(red); +} + +@mixin --nested-private-inner() { + color: var(--x); +} + +@mixin --nested-private-outer() { + @private { + --x: red; + } + @apply --nested-private-inner; +} + +.nested-private { + --color: blue; + --_csstools-m-1rmdrz7-a--x: red; + color: var(--_csstools-m-1rmdrz7-a--x); + @apply --nested-private-outer; } diff --git a/plugins/postcss-mixins/test/nesting.expect.css b/plugins/postcss-mixins/test/nesting.expect.css index 99242775e4..6a2626b8db 100644 --- a/plugins/postcss-mixins/test/nesting.expect.css +++ b/plugins/postcss-mixins/test/nesting.expect.css @@ -13,10 +13,10 @@ } .b { - --_csstools-p-1sa7v3t-0--arg-0: red; - --_csstools-p-1sa7v3t-1--color: var(--_csstools-p-1sa7v3t-0--arg-0); + --_csstools-m-1sa7v3t-0--arg-0: red; + --_csstools-m-1sa7v3t-1--color: var(--_csstools-m-1sa7v3t-0--arg-0); & { - color: var(--_csstools-p-1sa7v3t-1--color); + color: var(--_csstools-m-1sa7v3t-1--color); } } diff --git a/plugins/postcss-mixins/test/nesting.preserve-true.expect.css b/plugins/postcss-mixins/test/nesting.preserve-true.expect.css index 5b0c5566ba..c4ce7e9ab4 100644 --- a/plugins/postcss-mixins/test/nesting.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/nesting.preserve-true.expect.css @@ -28,10 +28,10 @@ } .b { - --_csstools-p-1sa7v3t-0--arg-0: red; - --_csstools-p-1sa7v3t-1--color: var(--_csstools-p-1sa7v3t-0--arg-0); + --_csstools-m-1sa7v3t-0--arg-0: red; + --_csstools-m-1sa7v3t-1--color: var(--_csstools-m-1sa7v3t-0--arg-0); & { - color: var(--_csstools-p-1sa7v3t-1--color); + color: var(--_csstools-m-1sa7v3t-1--color); } @apply --author-nesting-with-args(red); } diff --git a/plugins/postcss-mixins/test/private.css b/plugins/postcss-mixins/test/private.css index e3d299342c..c2d9505b16 100644 --- a/plugins/postcss-mixins/test/private.css +++ b/plugins/postcss-mixins/test/private.css @@ -21,3 +21,40 @@ .b { @apply --args-and-private(red); } + +@mixin --inner-private() { + @private { + --x: 1px; + } + + width: var(--x); +} + +@mixin --outer-private() { + @private { + --y: 2px; + } + + @apply --inner-private; + height: var(--y); +} + +.nested-private { + @apply --outer-private; +} + +@function --function-local() { + --value: var(--applying-private-color); + result: var(--value); +} + +@mixin --applying-private() { + color: var(--applying-private-color); +} + +.applying-private { + @private { + --applying-private-color: green; + } + @apply --applying-private; +} diff --git a/plugins/postcss-mixins/test/private.expect.css b/plugins/postcss-mixins/test/private.expect.css index 0f1abefbc9..5a1c95ca12 100644 --- a/plugins/postcss-mixins/test/private.expect.css +++ b/plugins/postcss-mixins/test/private.expect.css @@ -1,11 +1,28 @@ .a { - --_csstools-p-pjvzd8-0--shadow: 2px 2px black; - box-shadow: var(--_csstools-p-pjvzd8-0--shadow); + --_csstools-m-pjvzd8-0--shadow: 2px 2px black; + box-shadow: var(--_csstools-m-pjvzd8-0--shadow); } .b { - --_csstools-p-pjvzd8-1--arg-0: red; - --_csstools-p-pjvzd8-2--color: var(--_csstools-p-pjvzd8-1--arg-0); - --_csstools-p-pjvzd8-2--local: var(--_csstools-p-pjvzd8-2--color); - color: var(--_csstools-p-pjvzd8-2--local); + --_csstools-m-pjvzd8-1--arg-0: red; + --_csstools-m-pjvzd8-2--color: var(--_csstools-m-pjvzd8-1--arg-0); + --_csstools-m-pjvzd8-2--local: var(--_csstools-m-pjvzd8-2--color); + color: var(--_csstools-m-pjvzd8-2--local); +} + +.nested-private { + --_csstools-m-pjvzd8-3--y: 2px; + --_csstools-m-pjvzd8-4--x: 1px; + width: var(--_csstools-m-pjvzd8-4--x); + height: var(--_csstools-m-pjvzd8-3--y); +} + +@function --function-local() { + --value: var(--applying-private-color); + result: var(--value); +} + +.applying-private { + --_csstools-p-pjvzd8-0--applying-private-color: green; + color: var(--_csstools-p-pjvzd8-0--applying-private-color); } diff --git a/plugins/postcss-mixins/test/private.preserve-true.expect.css b/plugins/postcss-mixins/test/private.preserve-true.expect.css index fc8467667a..cc5d6d3588 100644 --- a/plugins/postcss-mixins/test/private.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/private.preserve-true.expect.css @@ -7,8 +7,8 @@ } .a { - --_csstools-p-pjvzd8-0--shadow: 2px 2px black; - box-shadow: var(--_csstools-p-pjvzd8-0--shadow); + --_csstools-m-pjvzd8-0--shadow: 2px 2px black; + box-shadow: var(--_csstools-m-pjvzd8-0--shadow); @apply --with-private; } @@ -21,9 +21,52 @@ } .b { - --_csstools-p-pjvzd8-1--arg-0: red; - --_csstools-p-pjvzd8-2--color: var(--_csstools-p-pjvzd8-1--arg-0); - --_csstools-p-pjvzd8-2--local: var(--_csstools-p-pjvzd8-2--color); - color: var(--_csstools-p-pjvzd8-2--local); + --_csstools-m-pjvzd8-1--arg-0: red; + --_csstools-m-pjvzd8-2--color: var(--_csstools-m-pjvzd8-1--arg-0); + --_csstools-m-pjvzd8-2--local: var(--_csstools-m-pjvzd8-2--color); + color: var(--_csstools-m-pjvzd8-2--local); @apply --args-and-private(red); } + +@mixin --inner-private() { + @private { + --x: 1px; + } + + width: var(--x); +} + +@mixin --outer-private() { + @private { + --y: 2px; + } + + @apply --inner-private; + height: var(--y); +} + +.nested-private { + --_csstools-m-pjvzd8-3--y: 2px; + --_csstools-m-pjvzd8-4--x: 1px; + width: var(--_csstools-m-pjvzd8-4--x); + height: var(--_csstools-m-pjvzd8-3--y); + @apply --outer-private; +} + +@function --function-local() { + --value: var(--applying-private-color); + result: var(--value); +} + +@mixin --applying-private() { + color: var(--applying-private-color); +} + +.applying-private { + --_csstools-p-pjvzd8-0--applying-private-color: green; + @private { + --applying-private-color: green; + } + color: var(--_csstools-p-pjvzd8-0--applying-private-color); + @apply --applying-private; +} diff --git a/plugins/postcss-mixins/test/property.css b/plugins/postcss-mixins/test/property.css new file mode 100644 index 0000000000..782b14610d --- /dev/null +++ b/plugins/postcss-mixins/test/property.css @@ -0,0 +1,122 @@ +@mixin --registered-private() { + @private { + @property --size { + syntax: ""; + inherits: false; + initial-value: 10px; + } + + @property --size-a, --size-b { + syntax: ""; + inherits: false; + initial-value: 11px; + } + + @property --size-c : 12px; + + @property --size-d type(#): red, blue; + + @property --size-e : red; + + --size: 20px; + --size-a: 30px; + --size-b: 40px; + --size-c: 40px; + --size-d: red, blue; + --size-e: blue; + } + + @private { + @property --initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; + } + + @property --initial-untyped: 6px; + } + + width: var(--size); + min-width: var(--initial-size); + height: var(--size-a); + min-height: var(--size-b); + max-height: var(--size-c); + max-width: var(--size-d); + inline-size: var(--size-e); + border-width: var(--initial-untyped); +} + +.registered-private-a { + @apply --registered-private; +} + +.registered-private-b { + @apply --registered-private; +} + +@mixin --escaped-private() { + @private { + @property --\66 oo : 20px; + --\66 oo: 30px; + } + + width: var(--\66 oo); +} + +.escaped-private { + @apply --escaped-private; +} + +@mixin --container-registered() { + @container (width > 10px) { + @private { + @property --container-size : 10px; + --container-size: 20px; + } + } + + width: var(--container-size); +} + +.container-registered { + @apply --container-registered; +} + +@mixin --starting-style-registered() { + @starting-style { + @private { + @property --starting-size { + syntax: ""; + inherits: false; + initial-value: 10px; + } + } + } + + width: var(--starting-size); +} + +.starting-style-registered { + @apply --starting-style-registered; +} + +@mixin --media-registered() { + @private { + @property --media-size : 1em; + --media-size: 2em; + } + + width: var(--media-size); +} + +@media (min-width: 1px) { + .media-registered { + @apply --media-registered; + } +} + +@layer outer { + .layer-registered { + @apply --media-registered; + } +} diff --git a/plugins/postcss-mixins/test/property.expect.css b/plugins/postcss-mixins/test/property.expect.css new file mode 100644 index 0000000000..2b3105fe59 --- /dev/null +++ b/plugins/postcss-mixins/test/property.expect.css @@ -0,0 +1,131 @@ +.registered-private-a { + --_csstools-m-7q9ama-0--size: 20px; + --_csstools-m-7q9ama-0--size-a: 30px; + --_csstools-m-7q9ama-0--size-b: 40px; + --_csstools-m-7q9ama-0--size-c: 40px; + --_csstools-m-7q9ama-0--size-d: red, blue; + --_csstools-m-7q9ama-0--size-e: blue; + width: var(--_csstools-m-7q9ama-0--size); + min-width: var(--_csstools-m-7q9ama-0--initial-size); + height: var(--_csstools-m-7q9ama-0--size-a); + min-height: var(--_csstools-m-7q9ama-0--size-b); + max-height: var(--_csstools-m-7q9ama-0--size-c); + max-width: var(--_csstools-m-7q9ama-0--size-d); + inline-size: var(--_csstools-m-7q9ama-0--size-e); + border-width: var(--_csstools-m-7q9ama-0--initial-untyped); +} + +.registered-private-b { + --_csstools-m-7q9ama-1--size: 20px; + --_csstools-m-7q9ama-1--size-a: 30px; + --_csstools-m-7q9ama-1--size-b: 40px; + --_csstools-m-7q9ama-1--size-c: 40px; + --_csstools-m-7q9ama-1--size-d: red, blue; + --_csstools-m-7q9ama-1--size-e: blue; + width: var(--_csstools-m-7q9ama-1--size); + min-width: var(--_csstools-m-7q9ama-1--initial-size); + height: var(--_csstools-m-7q9ama-1--size-a); + min-height: var(--_csstools-m-7q9ama-1--size-b); + max-height: var(--_csstools-m-7q9ama-1--size-c); + max-width: var(--_csstools-m-7q9ama-1--size-d); + inline-size: var(--_csstools-m-7q9ama-1--size-e); + border-width: var(--_csstools-m-7q9ama-1--initial-untyped); +} + +.escaped-private { + --_csstools-m-7q9ama-2--\66 oo: 30px; + width: var(--_csstools-m-7q9ama-2--foo); +} + +.container-registered { + @container (width > 10px) { + --_csstools-m-7q9ama-3--container-size: 20px + } + width: var(--_csstools-m-7q9ama-3--container-size); +} + +.starting-style-registered { + width: var(--_csstools-m-7q9ama-4--starting-size); +} + +@media (min-width: 1px) { + .media-registered { + --_csstools-m-7q9ama-5--media-size: 2em; + width: var(--_csstools-m-7q9ama-5--media-size); + } +} + +@layer outer { + .layer-registered { + --_csstools-m-7q9ama-6--media-size: 2em; + width: var(--_csstools-m-7q9ama-6--media-size); + } +} + +@property --_csstools-m-7q9ama-0--size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@property --_csstools-m-7q9ama-0--size-a, --_csstools-m-7q9ama-0--size-b { + syntax: ""; + inherits: false; + initial-value: 11px; +} + +@property --_csstools-m-7q9ama-0--size-c : 12px; + +@property --_csstools-m-7q9ama-0--size-d type(#): red, blue; + +@property --_csstools-m-7q9ama-0--size-e : red; + +@property --_csstools-m-7q9ama-0--initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; +} + +@property --_csstools-m-7q9ama-0--initial-untyped: 6px; + +@property --_csstools-m-7q9ama-1--size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@property --_csstools-m-7q9ama-1--size-a, --_csstools-m-7q9ama-1--size-b { + syntax: ""; + inherits: false; + initial-value: 11px; +} + +@property --_csstools-m-7q9ama-1--size-c : 12px; + +@property --_csstools-m-7q9ama-1--size-d type(#): red, blue; + +@property --_csstools-m-7q9ama-1--size-e : red; + +@property --_csstools-m-7q9ama-1--initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; +} + +@property --_csstools-m-7q9ama-1--initial-untyped: 6px; + +@property --_csstools-m-7q9ama-2--foo : 20px; + +@property --_csstools-m-7q9ama-3--container-size : 10px; + +@property --_csstools-m-7q9ama-4--starting-size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@media (min-width: 1px) {@property --_csstools-m-7q9ama-5--media-size : 1em +} + +@layer outer {@property --_csstools-m-7q9ama-6--media-size : 1em +} diff --git a/plugins/postcss-mixins/test/property.preserve-true.expect.css b/plugins/postcss-mixins/test/property.preserve-true.expect.css new file mode 100644 index 0000000000..1764328497 --- /dev/null +++ b/plugins/postcss-mixins/test/property.preserve-true.expect.css @@ -0,0 +1,229 @@ +@mixin --registered-private() { + @private { + @property --size { + syntax: ""; + inherits: false; + initial-value: 10px; + } + + @property --size-a, --size-b { + syntax: ""; + inherits: false; + initial-value: 11px; + } + + @property --size-c : 12px; + + @property --size-d type(#): red, blue; + + @property --size-e : red; + + --size: 20px; + --size-a: 30px; + --size-b: 40px; + --size-c: 40px; + --size-d: red, blue; + --size-e: blue; + } + + @private { + @property --initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; + } + + @property --initial-untyped: 6px; + } + + width: var(--size); + min-width: var(--initial-size); + height: var(--size-a); + min-height: var(--size-b); + max-height: var(--size-c); + max-width: var(--size-d); + inline-size: var(--size-e); + border-width: var(--initial-untyped); +} + +.registered-private-a { + --_csstools-m-7q9ama-0--size: 20px; + --_csstools-m-7q9ama-0--size-a: 30px; + --_csstools-m-7q9ama-0--size-b: 40px; + --_csstools-m-7q9ama-0--size-c: 40px; + --_csstools-m-7q9ama-0--size-d: red, blue; + --_csstools-m-7q9ama-0--size-e: blue; + width: var(--_csstools-m-7q9ama-0--size); + min-width: var(--_csstools-m-7q9ama-0--initial-size); + height: var(--_csstools-m-7q9ama-0--size-a); + min-height: var(--_csstools-m-7q9ama-0--size-b); + max-height: var(--_csstools-m-7q9ama-0--size-c); + max-width: var(--_csstools-m-7q9ama-0--size-d); + inline-size: var(--_csstools-m-7q9ama-0--size-e); + border-width: var(--_csstools-m-7q9ama-0--initial-untyped); + @apply --registered-private; +} + +.registered-private-b { + --_csstools-m-7q9ama-1--size: 20px; + --_csstools-m-7q9ama-1--size-a: 30px; + --_csstools-m-7q9ama-1--size-b: 40px; + --_csstools-m-7q9ama-1--size-c: 40px; + --_csstools-m-7q9ama-1--size-d: red, blue; + --_csstools-m-7q9ama-1--size-e: blue; + width: var(--_csstools-m-7q9ama-1--size); + min-width: var(--_csstools-m-7q9ama-1--initial-size); + height: var(--_csstools-m-7q9ama-1--size-a); + min-height: var(--_csstools-m-7q9ama-1--size-b); + max-height: var(--_csstools-m-7q9ama-1--size-c); + max-width: var(--_csstools-m-7q9ama-1--size-d); + inline-size: var(--_csstools-m-7q9ama-1--size-e); + border-width: var(--_csstools-m-7q9ama-1--initial-untyped); + @apply --registered-private; +} + +@mixin --escaped-private() { + @private { + @property --\66 oo : 20px; + --\66 oo: 30px; + } + + width: var(--\66 oo); +} + +.escaped-private { + --_csstools-m-7q9ama-2--\66 oo: 30px; + width: var(--_csstools-m-7q9ama-2--foo); + @apply --escaped-private; +} + +@mixin --container-registered() { + @container (width > 10px) { + @private { + @property --container-size : 10px; + --container-size: 20px; + } + } + + width: var(--container-size); +} + +.container-registered { + @container (width > 10px) { + --_csstools-m-7q9ama-3--container-size: 20px + } + width: var(--_csstools-m-7q9ama-3--container-size); + @apply --container-registered; +} + +@mixin --starting-style-registered() { + @starting-style { + @private { + @property --starting-size { + syntax: ""; + inherits: false; + initial-value: 10px; + } + } + } + + width: var(--starting-size); +} + +.starting-style-registered { + width: var(--_csstools-m-7q9ama-4--starting-size); + @apply --starting-style-registered; +} + +@mixin --media-registered() { + @private { + @property --media-size : 1em; + --media-size: 2em; + } + + width: var(--media-size); +} + +@media (min-width: 1px) { + .media-registered { + --_csstools-m-7q9ama-5--media-size: 2em; + width: var(--_csstools-m-7q9ama-5--media-size); + @apply --media-registered; + } +} + +@layer outer { + .layer-registered { + --_csstools-m-7q9ama-6--media-size: 2em; + width: var(--_csstools-m-7q9ama-6--media-size); + @apply --media-registered; + } +} + +@property --_csstools-m-7q9ama-0--size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@property --_csstools-m-7q9ama-0--size-a, --_csstools-m-7q9ama-0--size-b { + syntax: ""; + inherits: false; + initial-value: 11px; +} + +@property --_csstools-m-7q9ama-0--size-c : 12px; + +@property --_csstools-m-7q9ama-0--size-d type(#): red, blue; + +@property --_csstools-m-7q9ama-0--size-e : red; + +@property --_csstools-m-7q9ama-0--initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; +} + +@property --_csstools-m-7q9ama-0--initial-untyped: 6px; + +@property --_csstools-m-7q9ama-1--size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@property --_csstools-m-7q9ama-1--size-a, --_csstools-m-7q9ama-1--size-b { + syntax: ""; + inherits: false; + initial-value: 11px; +} + +@property --_csstools-m-7q9ama-1--size-c : 12px; + +@property --_csstools-m-7q9ama-1--size-d type(#): red, blue; + +@property --_csstools-m-7q9ama-1--size-e : red; + +@property --_csstools-m-7q9ama-1--initial-size { + syntax: ""; + inherits: false; + initial-value: 5px; +} + +@property --_csstools-m-7q9ama-1--initial-untyped: 6px; + +@property --_csstools-m-7q9ama-2--foo : 20px; + +@property --_csstools-m-7q9ama-3--container-size : 10px; + +@property --_csstools-m-7q9ama-4--starting-size { + syntax: ""; + inherits: false; + initial-value: 10px; +} + +@media (min-width: 1px) {@property --_csstools-m-7q9ama-5--media-size : 1em +} + +@layer outer {@property --_csstools-m-7q9ama-6--media-size : 1em +} diff --git a/plugins/postcss-mixins/test/spaces.css b/plugins/postcss-mixins/test/spaces.css index b5a811b8cf..4aebcdefb2 100644 --- a/plugins/postcss-mixins/test/spaces.css +++ b/plugins/postcss-mixins/test/spaces.css @@ -3,6 +3,18 @@ background-color: var(--background); } +@mixin --multiline-parameters( + --color, + --background, +) { + color: var(--color); + background-color: var(--background); +} + +.multiline-parameters { + @apply --multiline-parameters(green, blue); +} + .space-after-open { @apply --spaces( green, blue); } diff --git a/plugins/postcss-mixins/test/spaces.expect.css b/plugins/postcss-mixins/test/spaces.expect.css index f636189cf7..5a4e8898af 100644 --- a/plugins/postcss-mixins/test/spaces.expect.css +++ b/plugins/postcss-mixins/test/spaces.expect.css @@ -1,106 +1,115 @@ +.multiline-parameters { + --_csstools-m-1kp0udk-0--arg-0: green; + --_csstools-m-1kp0udk-0--arg-1: blue; + --_csstools-m-1kp0udk-1--color: var(--_csstools-m-1kp0udk-0--arg-0); + --_csstools-m-1kp0udk-1--background: var(--_csstools-m-1kp0udk-0--arg-1); + color: var(--_csstools-m-1kp0udk-1--color); + background-color: var(--_csstools-m-1kp0udk-1--background); +} + .space-after-open { - --_csstools-p-1kp0udk-0--arg-0: green; - --_csstools-p-1kp0udk-0--arg-1: blue; - --_csstools-p-1kp0udk-1--color: var(--_csstools-p-1kp0udk-0--arg-0); - --_csstools-p-1kp0udk-1--background: var(--_csstools-p-1kp0udk-0--arg-1); - color: var(--_csstools-p-1kp0udk-1--color); - background-color: var(--_csstools-p-1kp0udk-1--background); + --_csstools-m-1kp0udk-2--arg-2: green; + --_csstools-m-1kp0udk-2--arg-3: blue; + --_csstools-m-1kp0udk-3--color: var(--_csstools-m-1kp0udk-2--arg-2); + --_csstools-m-1kp0udk-3--background: var(--_csstools-m-1kp0udk-2--arg-3); + color: var(--_csstools-m-1kp0udk-3--color); + background-color: var(--_csstools-m-1kp0udk-3--background); } .space-before-close { - --_csstools-p-1kp0udk-2--arg-2: green; - --_csstools-p-1kp0udk-2--arg-3: blue; - --_csstools-p-1kp0udk-3--color: var(--_csstools-p-1kp0udk-2--arg-2); - --_csstools-p-1kp0udk-3--background: var(--_csstools-p-1kp0udk-2--arg-3); - color: var(--_csstools-p-1kp0udk-3--color); - background-color: var(--_csstools-p-1kp0udk-3--background); + --_csstools-m-1kp0udk-4--arg-4: green; + --_csstools-m-1kp0udk-4--arg-5: blue; + --_csstools-m-1kp0udk-5--color: var(--_csstools-m-1kp0udk-4--arg-4); + --_csstools-m-1kp0udk-5--background: var(--_csstools-m-1kp0udk-4--arg-5); + color: var(--_csstools-m-1kp0udk-5--color); + background-color: var(--_csstools-m-1kp0udk-5--background); } .space-around-both { - --_csstools-p-1kp0udk-4--arg-4: green; - --_csstools-p-1kp0udk-4--arg-5: blue; - --_csstools-p-1kp0udk-5--color: var(--_csstools-p-1kp0udk-4--arg-4); - --_csstools-p-1kp0udk-5--background: var(--_csstools-p-1kp0udk-4--arg-5); - color: var(--_csstools-p-1kp0udk-5--color); - background-color: var(--_csstools-p-1kp0udk-5--background); + --_csstools-m-1kp0udk-6--arg-6: green; + --_csstools-m-1kp0udk-6--arg-7: blue; + --_csstools-m-1kp0udk-7--color: var(--_csstools-m-1kp0udk-6--arg-6); + --_csstools-m-1kp0udk-7--background: var(--_csstools-m-1kp0udk-6--arg-7); + color: var(--_csstools-m-1kp0udk-7--color); + background-color: var(--_csstools-m-1kp0udk-7--background); } .tabs-and-newlines { - --_csstools-p-1kp0udk-6--arg-6: green; - --_csstools-p-1kp0udk-6--arg-7: blue; - --_csstools-p-1kp0udk-7--color: var(--_csstools-p-1kp0udk-6--arg-6); - --_csstools-p-1kp0udk-7--background: var(--_csstools-p-1kp0udk-6--arg-7); - color: var(--_csstools-p-1kp0udk-7--color); - background-color: var(--_csstools-p-1kp0udk-7--background); + --_csstools-m-1kp0udk-8--arg-8: green; + --_csstools-m-1kp0udk-8--arg-9: blue; + --_csstools-m-1kp0udk-9--color: var(--_csstools-m-1kp0udk-8--arg-8); + --_csstools-m-1kp0udk-9--background: var(--_csstools-m-1kp0udk-8--arg-9); + color: var(--_csstools-m-1kp0udk-9--color); + background-color: var(--_csstools-m-1kp0udk-9--background); } .space-around-comma { - --_csstools-p-1kp0udk-8--arg-8: green; - --_csstools-p-1kp0udk-8--arg-9: blue; - --_csstools-p-1kp0udk-9--color: var(--_csstools-p-1kp0udk-8--arg-8); - --_csstools-p-1kp0udk-9--background: var(--_csstools-p-1kp0udk-8--arg-9); - color: var(--_csstools-p-1kp0udk-9--color); - background-color: var(--_csstools-p-1kp0udk-9--background); + --_csstools-m-1kp0udk-a--arg-a: green; + --_csstools-m-1kp0udk-a--arg-b: blue; + --_csstools-m-1kp0udk-b--color: var(--_csstools-m-1kp0udk-a--arg-a); + --_csstools-m-1kp0udk-b--background: var(--_csstools-m-1kp0udk-a--arg-b); + color: var(--_csstools-m-1kp0udk-b--color); + background-color: var(--_csstools-m-1kp0udk-b--background); } .comment-before-comma { - --_csstools-p-1kp0udk-a--arg-a: green; - --_csstools-p-1kp0udk-a--arg-b: blue; - --_csstools-p-1kp0udk-b--color: var(--_csstools-p-1kp0udk-a--arg-a); - --_csstools-p-1kp0udk-b--background: var(--_csstools-p-1kp0udk-a--arg-b); - color: var(--_csstools-p-1kp0udk-b--color); - background-color: var(--_csstools-p-1kp0udk-b--background); + --_csstools-m-1kp0udk-c--arg-c: green; + --_csstools-m-1kp0udk-c--arg-d: blue; + --_csstools-m-1kp0udk-d--color: var(--_csstools-m-1kp0udk-c--arg-c); + --_csstools-m-1kp0udk-d--background: var(--_csstools-m-1kp0udk-c--arg-d); + color: var(--_csstools-m-1kp0udk-d--color); + background-color: var(--_csstools-m-1kp0udk-d--background); } .comment-around-arguments { - --_csstools-p-1kp0udk-c--arg-c: green; - --_csstools-p-1kp0udk-c--arg-d: blue; - --_csstools-p-1kp0udk-d--color: var(--_csstools-p-1kp0udk-c--arg-c); - --_csstools-p-1kp0udk-d--background: var(--_csstools-p-1kp0udk-c--arg-d); - color: var(--_csstools-p-1kp0udk-d--color); - background-color: var(--_csstools-p-1kp0udk-d--background); + --_csstools-m-1kp0udk-e--arg-e: green; + --_csstools-m-1kp0udk-e--arg-f: blue; + --_csstools-m-1kp0udk-f--color: var(--_csstools-m-1kp0udk-e--arg-e); + --_csstools-m-1kp0udk-f--background: var(--_csstools-m-1kp0udk-e--arg-f); + color: var(--_csstools-m-1kp0udk-f--color); + background-color: var(--_csstools-m-1kp0udk-f--background); } .comment-only-default { - --_csstools-p-1kp0udk-e--color: green; - color: var(--_csstools-p-1kp0udk-e--color); + --_csstools-m-1kp0udk-g--color: green; + color: var(--_csstools-m-1kp0udk-g--color); } .space-around-default { - --_csstools-p-1kp0udk-f--color: green; - --_csstools-p-1kp0udk-f--background: blue; - color: var(--_csstools-p-1kp0udk-f--color); - background-color: var(--_csstools-p-1kp0udk-f--background); + --_csstools-m-1kp0udk-h--color: green; + --_csstools-m-1kp0udk-h--background: blue; + color: var(--_csstools-m-1kp0udk-h--color); + background-color: var(--_csstools-m-1kp0udk-h--background); } .space-around-argument-defaults { - --_csstools-p-1kp0udk-g--arg-e: red; - --_csstools-p-1kp0udk-g--arg-f: blue; - --_csstools-p-1kp0udk-h--color: var(--_csstools-p-1kp0udk-g--arg-e); - --_csstools-p-1kp0udk-h--background: var(--_csstools-p-1kp0udk-g--arg-f); - color: var(--_csstools-p-1kp0udk-h--color); - background-color: var(--_csstools-p-1kp0udk-h--background); + --_csstools-m-1kp0udk-i--arg-g: red; + --_csstools-m-1kp0udk-i--arg-h: blue; + --_csstools-m-1kp0udk-j--color: var(--_csstools-m-1kp0udk-i--arg-g); + --_csstools-m-1kp0udk-j--background: var(--_csstools-m-1kp0udk-i--arg-h); + color: var(--_csstools-m-1kp0udk-j--color); + background-color: var(--_csstools-m-1kp0udk-j--background); } .comment-before-parameter-name { - --_csstools-p-1kp0udk-i--arg-g: green; - --_csstools-p-1kp0udk-i--arg-h: blue; - --_csstools-p-1kp0udk-j--color: var(--_csstools-p-1kp0udk-i--arg-g); - --_csstools-p-1kp0udk-j--background: var(--_csstools-p-1kp0udk-i--arg-h); - color: var(--_csstools-p-1kp0udk-j--color); - background-color: var(--_csstools-p-1kp0udk-j--background); + --_csstools-m-1kp0udk-k--arg-i: green; + --_csstools-m-1kp0udk-k--arg-j: blue; + --_csstools-m-1kp0udk-l--color: var(--_csstools-m-1kp0udk-k--arg-i); + --_csstools-m-1kp0udk-l--background: var(--_csstools-m-1kp0udk-k--arg-j); + color: var(--_csstools-m-1kp0udk-l--color); + background-color: var(--_csstools-m-1kp0udk-l--background); } .space-before-parameter-name { - --_csstools-p-1kp0udk-k--arg-i: green; - --_csstools-p-1kp0udk-k--arg-j: blue; - --_csstools-p-1kp0udk-l--color: var(--_csstools-p-1kp0udk-k--arg-i); - --_csstools-p-1kp0udk-l--background: var(--_csstools-p-1kp0udk-k--arg-j); - color: var(--_csstools-p-1kp0udk-l--color); - background-color: var(--_csstools-p-1kp0udk-l--background); + --_csstools-m-1kp0udk-m--arg-k: green; + --_csstools-m-1kp0udk-m--arg-l: blue; + --_csstools-m-1kp0udk-n--color: var(--_csstools-m-1kp0udk-m--arg-k); + --_csstools-m-1kp0udk-n--background: var(--_csstools-m-1kp0udk-m--arg-l); + color: var(--_csstools-m-1kp0udk-n--color); + background-color: var(--_csstools-m-1kp0udk-n--background); } .comment-before-default-name { - --_csstools-p-1kp0udk-m--color: green; - color: var(--_csstools-p-1kp0udk-m--color); + --_csstools-m-1kp0udk-o--color: green; + color: var(--_csstools-m-1kp0udk-o--color); } diff --git a/plugins/postcss-mixins/test/spaces.preserve-true.expect.css b/plugins/postcss-mixins/test/spaces.preserve-true.expect.css index b250a19872..6c7d3525f3 100644 --- a/plugins/postcss-mixins/test/spaces.preserve-true.expect.css +++ b/plugins/postcss-mixins/test/spaces.preserve-true.expect.css @@ -3,43 +3,61 @@ background-color: var(--background); } +@mixin --multiline-parameters( + --color, + --background, +) { + color: var(--color); + background-color: var(--background); +} + +.multiline-parameters { + --_csstools-m-1kp0udk-0--arg-0: green; + --_csstools-m-1kp0udk-0--arg-1: blue; + --_csstools-m-1kp0udk-1--color: var(--_csstools-m-1kp0udk-0--arg-0); + --_csstools-m-1kp0udk-1--background: var(--_csstools-m-1kp0udk-0--arg-1); + color: var(--_csstools-m-1kp0udk-1--color); + background-color: var(--_csstools-m-1kp0udk-1--background); + @apply --multiline-parameters(green, blue); +} + .space-after-open { - --_csstools-p-1kp0udk-0--arg-0: green; - --_csstools-p-1kp0udk-0--arg-1: blue; - --_csstools-p-1kp0udk-1--color: var(--_csstools-p-1kp0udk-0--arg-0); - --_csstools-p-1kp0udk-1--background: var(--_csstools-p-1kp0udk-0--arg-1); - color: var(--_csstools-p-1kp0udk-1--color); - background-color: var(--_csstools-p-1kp0udk-1--background); + --_csstools-m-1kp0udk-2--arg-2: green; + --_csstools-m-1kp0udk-2--arg-3: blue; + --_csstools-m-1kp0udk-3--color: var(--_csstools-m-1kp0udk-2--arg-2); + --_csstools-m-1kp0udk-3--background: var(--_csstools-m-1kp0udk-2--arg-3); + color: var(--_csstools-m-1kp0udk-3--color); + background-color: var(--_csstools-m-1kp0udk-3--background); @apply --spaces( green, blue); } .space-before-close { - --_csstools-p-1kp0udk-2--arg-2: green; - --_csstools-p-1kp0udk-2--arg-3: blue; - --_csstools-p-1kp0udk-3--color: var(--_csstools-p-1kp0udk-2--arg-2); - --_csstools-p-1kp0udk-3--background: var(--_csstools-p-1kp0udk-2--arg-3); - color: var(--_csstools-p-1kp0udk-3--color); - background-color: var(--_csstools-p-1kp0udk-3--background); + --_csstools-m-1kp0udk-4--arg-4: green; + --_csstools-m-1kp0udk-4--arg-5: blue; + --_csstools-m-1kp0udk-5--color: var(--_csstools-m-1kp0udk-4--arg-4); + --_csstools-m-1kp0udk-5--background: var(--_csstools-m-1kp0udk-4--arg-5); + color: var(--_csstools-m-1kp0udk-5--color); + background-color: var(--_csstools-m-1kp0udk-5--background); @apply --spaces(green, blue ); } .space-around-both { - --_csstools-p-1kp0udk-4--arg-4: green; - --_csstools-p-1kp0udk-4--arg-5: blue; - --_csstools-p-1kp0udk-5--color: var(--_csstools-p-1kp0udk-4--arg-4); - --_csstools-p-1kp0udk-5--background: var(--_csstools-p-1kp0udk-4--arg-5); - color: var(--_csstools-p-1kp0udk-5--color); - background-color: var(--_csstools-p-1kp0udk-5--background); + --_csstools-m-1kp0udk-6--arg-6: green; + --_csstools-m-1kp0udk-6--arg-7: blue; + --_csstools-m-1kp0udk-7--color: var(--_csstools-m-1kp0udk-6--arg-6); + --_csstools-m-1kp0udk-7--background: var(--_csstools-m-1kp0udk-6--arg-7); + color: var(--_csstools-m-1kp0udk-7--color); + background-color: var(--_csstools-m-1kp0udk-7--background); @apply --spaces( green, blue ); } .tabs-and-newlines { - --_csstools-p-1kp0udk-6--arg-6: green; - --_csstools-p-1kp0udk-6--arg-7: blue; - --_csstools-p-1kp0udk-7--color: var(--_csstools-p-1kp0udk-6--arg-6); - --_csstools-p-1kp0udk-7--background: var(--_csstools-p-1kp0udk-6--arg-7); - color: var(--_csstools-p-1kp0udk-7--color); - background-color: var(--_csstools-p-1kp0udk-7--background); + --_csstools-m-1kp0udk-8--arg-8: green; + --_csstools-m-1kp0udk-8--arg-9: blue; + --_csstools-m-1kp0udk-9--color: var(--_csstools-m-1kp0udk-8--arg-8); + --_csstools-m-1kp0udk-9--background: var(--_csstools-m-1kp0udk-8--arg-9); + color: var(--_csstools-m-1kp0udk-9--color); + background-color: var(--_csstools-m-1kp0udk-9--background); @apply --spaces( green, blue @@ -47,12 +65,12 @@ } .space-around-comma { - --_csstools-p-1kp0udk-8--arg-8: green; - --_csstools-p-1kp0udk-8--arg-9: blue; - --_csstools-p-1kp0udk-9--color: var(--_csstools-p-1kp0udk-8--arg-8); - --_csstools-p-1kp0udk-9--background: var(--_csstools-p-1kp0udk-8--arg-9); - color: var(--_csstools-p-1kp0udk-9--color); - background-color: var(--_csstools-p-1kp0udk-9--background); + --_csstools-m-1kp0udk-a--arg-a: green; + --_csstools-m-1kp0udk-a--arg-b: blue; + --_csstools-m-1kp0udk-b--color: var(--_csstools-m-1kp0udk-a--arg-a); + --_csstools-m-1kp0udk-b--background: var(--_csstools-m-1kp0udk-a--arg-b); + color: var(--_csstools-m-1kp0udk-b--color); + background-color: var(--_csstools-m-1kp0udk-b--background); @apply --spaces(green , blue); } @@ -62,12 +80,12 @@ } .comment-before-comma { - --_csstools-p-1kp0udk-a--arg-a: green; - --_csstools-p-1kp0udk-a--arg-b: blue; - --_csstools-p-1kp0udk-b--color: var(--_csstools-p-1kp0udk-a--arg-a); - --_csstools-p-1kp0udk-b--background: var(--_csstools-p-1kp0udk-a--arg-b); - color: var(--_csstools-p-1kp0udk-b--color); - background-color: var(--_csstools-p-1kp0udk-b--background); + --_csstools-m-1kp0udk-c--arg-c: green; + --_csstools-m-1kp0udk-c--arg-d: blue; + --_csstools-m-1kp0udk-d--color: var(--_csstools-m-1kp0udk-c--arg-c); + --_csstools-m-1kp0udk-d--background: var(--_csstools-m-1kp0udk-c--arg-d); + color: var(--_csstools-m-1kp0udk-d--color); + background-color: var(--_csstools-m-1kp0udk-d--background); @apply --comment-in-parameters(green /* one */, blue /* two */); } @@ -77,12 +95,12 @@ } .comment-around-arguments { - --_csstools-p-1kp0udk-c--arg-c: green; - --_csstools-p-1kp0udk-c--arg-d: blue; - --_csstools-p-1kp0udk-d--color: var(--_csstools-p-1kp0udk-c--arg-c); - --_csstools-p-1kp0udk-d--background: var(--_csstools-p-1kp0udk-c--arg-d); - color: var(--_csstools-p-1kp0udk-d--color); - background-color: var(--_csstools-p-1kp0udk-d--background); + --_csstools-m-1kp0udk-e--arg-e: green; + --_csstools-m-1kp0udk-e--arg-f: blue; + --_csstools-m-1kp0udk-f--color: var(--_csstools-m-1kp0udk-e--arg-e); + --_csstools-m-1kp0udk-f--background: var(--_csstools-m-1kp0udk-e--arg-f); + color: var(--_csstools-m-1kp0udk-f--color); + background-color: var(--_csstools-m-1kp0udk-f--background); @apply --comment-parameters-and-arguments( /* before */ green /* mid */, blue /* after */ ); } @@ -91,8 +109,8 @@ } .comment-only-default { - --_csstools-p-1kp0udk-e--color: green; - color: var(--_csstools-p-1kp0udk-e--color); + --_csstools-m-1kp0udk-g--color: green; + color: var(--_csstools-m-1kp0udk-g--color); @apply --comment-only-default; } @@ -102,20 +120,20 @@ } .space-around-default { - --_csstools-p-1kp0udk-f--color: green; - --_csstools-p-1kp0udk-f--background: blue; - color: var(--_csstools-p-1kp0udk-f--color); - background-color: var(--_csstools-p-1kp0udk-f--background); + --_csstools-m-1kp0udk-h--color: green; + --_csstools-m-1kp0udk-h--background: blue; + color: var(--_csstools-m-1kp0udk-h--color); + background-color: var(--_csstools-m-1kp0udk-h--background); @apply --space-around-default; } .space-around-argument-defaults { - --_csstools-p-1kp0udk-g--arg-e: red; - --_csstools-p-1kp0udk-g--arg-f: blue; - --_csstools-p-1kp0udk-h--color: var(--_csstools-p-1kp0udk-g--arg-e); - --_csstools-p-1kp0udk-h--background: var(--_csstools-p-1kp0udk-g--arg-f); - color: var(--_csstools-p-1kp0udk-h--color); - background-color: var(--_csstools-p-1kp0udk-h--background); + --_csstools-m-1kp0udk-i--arg-g: red; + --_csstools-m-1kp0udk-i--arg-h: blue; + --_csstools-m-1kp0udk-j--color: var(--_csstools-m-1kp0udk-i--arg-g); + --_csstools-m-1kp0udk-j--background: var(--_csstools-m-1kp0udk-i--arg-h); + color: var(--_csstools-m-1kp0udk-j--color); + background-color: var(--_csstools-m-1kp0udk-j--background); @apply --space-around-default( red , blue ); } @@ -125,12 +143,12 @@ } .comment-before-parameter-name { - --_csstools-p-1kp0udk-i--arg-g: green; - --_csstools-p-1kp0udk-i--arg-h: blue; - --_csstools-p-1kp0udk-j--color: var(--_csstools-p-1kp0udk-i--arg-g); - --_csstools-p-1kp0udk-j--background: var(--_csstools-p-1kp0udk-i--arg-h); - color: var(--_csstools-p-1kp0udk-j--color); - background-color: var(--_csstools-p-1kp0udk-j--background); + --_csstools-m-1kp0udk-k--arg-i: green; + --_csstools-m-1kp0udk-k--arg-j: blue; + --_csstools-m-1kp0udk-l--color: var(--_csstools-m-1kp0udk-k--arg-i); + --_csstools-m-1kp0udk-l--background: var(--_csstools-m-1kp0udk-k--arg-j); + color: var(--_csstools-m-1kp0udk-l--color); + background-color: var(--_csstools-m-1kp0udk-l--background); @apply --comment-before-parameter-name(green, blue); } @@ -140,12 +158,12 @@ } .space-before-parameter-name { - --_csstools-p-1kp0udk-k--arg-i: green; - --_csstools-p-1kp0udk-k--arg-j: blue; - --_csstools-p-1kp0udk-l--color: var(--_csstools-p-1kp0udk-k--arg-i); - --_csstools-p-1kp0udk-l--background: var(--_csstools-p-1kp0udk-k--arg-j); - color: var(--_csstools-p-1kp0udk-l--color); - background-color: var(--_csstools-p-1kp0udk-l--background); + --_csstools-m-1kp0udk-m--arg-k: green; + --_csstools-m-1kp0udk-m--arg-l: blue; + --_csstools-m-1kp0udk-n--color: var(--_csstools-m-1kp0udk-m--arg-k); + --_csstools-m-1kp0udk-n--background: var(--_csstools-m-1kp0udk-m--arg-l); + color: var(--_csstools-m-1kp0udk-n--color); + background-color: var(--_csstools-m-1kp0udk-n--background); @apply --space-before-parameter-name(green, blue); } @@ -154,7 +172,7 @@ } .comment-before-default-name { - --_csstools-p-1kp0udk-m--color: green; - color: var(--_csstools-p-1kp0udk-m--color); + --_csstools-m-1kp0udk-o--color: green; + color: var(--_csstools-m-1kp0udk-o--color); @apply --comment-before-default-name; } diff --git a/plugins/postcss-mixins/test/wpt/mixin-arguments.html b/plugins/postcss-mixins/test/wpt/mixin-arguments.html index 5958c47c92..57e29eff7f 100644 --- a/plugins/postcss-mixins/test/wpt/mixin-arguments.html +++ b/plugins/postcss-mixins/test/wpt/mixin-arguments.html @@ -27,8 +27,6 @@ } // Only the transformed form is asserted. - // Chrome Canary only implements mixins with a `@result` block, - // but `@result` was dropped from the specification. const testCases = [ { title: 'Basic mixin parameter passing', diff --git a/plugins/postcss-mixins/test/wpt/mixin-basic.html b/plugins/postcss-mixins/test/wpt/mixin-basic.html index a7911402d0..bb313da39b 100644 --- a/plugins/postcss-mixins/test/wpt/mixin-basic.html +++ b/plugins/postcss-mixins/test/wpt/mixin-basic.html @@ -27,8 +27,6 @@ } // Only the transformed form is asserted. - // Chrome Canary only implements mixins with a `@result` block, - // but `@result` was dropped from the specification. const testCases = [ { title: 'Basic mixin', diff --git a/plugins/postcss-mixins/test/wpt/mixin-contents.html b/plugins/postcss-mixins/test/wpt/mixin-contents.html index 4715d375cf..b28c0a13bb 100644 --- a/plugins/postcss-mixins/test/wpt/mixin-contents.html +++ b/plugins/postcss-mixins/test/wpt/mixin-contents.html @@ -28,8 +28,6 @@ } // Only the transformed form is asserted. - // Chrome Canary only implements mixins with a `@result` block, - // but `@result` was dropped from the specification. const testCases = [ { title: 'Simple @contents with no fallback', diff --git a/plugins/postcss-mixins/test/wpt/mixin-nested.html b/plugins/postcss-mixins/test/wpt/mixin-nested.html index 6e26b34466..f171dfb776 100644 --- a/plugins/postcss-mixins/test/wpt/mixin-nested.html +++ b/plugins/postcss-mixins/test/wpt/mixin-nested.html @@ -26,8 +26,6 @@ } // Only the transformed form is asserted. - // Chrome Canary only implements mixins with a `@result` block, - // but `@result` was dropped from the specification. const testCases = [ { title: 'Mixin depends on another mixin', diff --git a/plugins/postcss-mixins/test/wpt/mixin-private.html b/plugins/postcss-mixins/test/wpt/mixin-private.html index c65e276d58..2ab29c29f0 100644 --- a/plugins/postcss-mixins/test/wpt/mixin-private.html +++ b/plugins/postcss-mixins/test/wpt/mixin-private.html @@ -11,6 +11,16 @@ + + + + + + + + + +