@terrazzo/plugin-css 0.0.5 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2021 Drew Powers
3
+ Copyright (c) 2024 Drew Powers
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
18
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,5 +1,37 @@
1
1
  # ⛋ @terrazzo/plugin-css
2
2
 
3
- CSS codegen plugin for @terrazzo/cli. Generate CSS using DTCG tokens.
3
+ Generate CSS from DTCG tokens.
4
4
 
5
- [View Documentation](https://terrazzo.app/docs/integrations/css)
5
+ ## Setup
6
+
7
+ Requires [Node.js 18 or later](https://nodejs.org). With that installed, run:
8
+
9
+ ```sh
10
+ npm i -D @terrazzo/cli @terrazzo/plugin-css
11
+ ```
12
+
13
+ Add a `terrazzo.config.js` to the root of your project with:
14
+
15
+ ```ts
16
+ import { defineConfig } from "@terrazzo/cli";
17
+ import css from "@terrazzo/plugin-css";
18
+
19
+ export default defineConfig({
20
+ outDir: "./tokens/",
21
+ plugins: [
22
+ css({
23
+ fileName: "tokens.css",
24
+ }),
25
+ ],
26
+ });
27
+ ```
28
+
29
+ Lastly, run:
30
+
31
+ ```sh
32
+ npx tz build
33
+ ```
34
+
35
+ And you’ll see a `./tokens/tokens.css` file generated in your project.
36
+
37
+ [Full Documentation](https://terrazzo.app/docs/integrations/css)
package/dist/build.js CHANGED
@@ -61,9 +61,6 @@ export default function buildFormat({ getTransforms, exclude, modeSelectors }) {
61
61
  const selectorRec2020Rule = { selectors, nestedQuery: REC2020_MQ, declarations: {} };
62
62
  rules.push(selectorRule, selectorP3Rule, selectorRec2020Rule);
63
63
  for (const token of selectorTokens) {
64
- if (token.token.aliasOf) {
65
- continue;
66
- }
67
64
  const localID = token.localID ?? token.token.id;
68
65
  // single-value token
69
66
  if (token.type === 'SINGLE_VALUE') {
package/dist/build.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -22,10 +22,10 @@
22
22
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23
23
  * SOFTWARE.
24
24
  */
25
+ import { validateCustomTransform } from '@terrazzo/token-tools';
25
26
  import { makeCSSVar, transformCSSValue } from '@terrazzo/token-tools/css';
26
- import { FILE_PREFIX, FORMAT_ID } from './lib.js';
27
27
  import buildFormat from './build.js';
28
- import { validateCustomTransform } from '@terrazzo/token-tools';
28
+ import { FILE_PREFIX, FORMAT_ID } from './lib.js';
29
29
  export * from './build.js';
30
30
  export * from './lib.js';
31
31
  export default function cssPlugin({ filename = './index.css', exclude, variableName, modeSelectors, transform: customTransform, } = {}) {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAyB,MAAM,UAAU,CAAC;AACzE,OAAO,WAAW,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAEzB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,QAAQ,GAAG,aAAa,EACxB,OAAO,EACP,YAAY,EACZ,aAAa,EACb,SAAS,EAAE,eAAe,MACN,EAAE;IACtB,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,OAAO,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC;IAEnE,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE;YACrD,mDAAmD;YACnD,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC9B,IAAI,eAAe,EAAE,CAAC;wBACpB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;wBAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;4BAC1C,uBAAuB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;4BACvD,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC9D,SAAS;wBACX,CAAC;oBACH,CAAC;oBAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;oBAC5E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;wBACnC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE;YACvC,MAAM,MAAM,GAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,EACtD,IAAI,CACL,CAAC;YACF,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,WAAW,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAyB,MAAM,UAAU,CAAC;AAEzE,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAEzB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,QAAQ,GAAG,aAAa,EACxB,OAAO,EACP,YAAY,EACZ,aAAa,EACb,SAAS,EAAE,eAAe,MACN,EAAE;IACtB,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,OAAO,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC;IAEnE,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE;YACrD,mDAAmD;YACnD,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC9B,IAAI,eAAe,EAAE,CAAC;wBACpB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;wBAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;4BAC1C,uBAAuB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;4BACvD,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC9D,SAAS;wBACX,CAAC;oBACH,CAAC;oBAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;oBAC5E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;wBACnC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE;YACvC,MAAM,MAAM,GAAa,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,EACtD,IAAI,CACL,CAAC;YACF,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,38 +1,36 @@
1
1
  {
2
2
  "name": "@terrazzo/plugin-css",
3
+ "version": "0.0.6",
3
4
  "description": "Generate CSS from your design tokens schema (requires @terrazzo/cli)",
4
- "version": "0.0.5",
5
+ "type": "module",
5
6
  "author": {
6
7
  "name": "Drew Powers",
7
8
  "email": "drew@pow.rs"
8
9
  },
9
10
  "keywords": [
10
11
  "design tokens",
11
- "design tokens community group",
12
- "design tokens format module",
13
12
  "design system",
14
13
  "dtcg",
15
- "w3c design tokens",
14
+ "w3c",
16
15
  "css"
17
16
  ],
18
- "license": "MIT",
19
- "type": "module",
20
17
  "main": "./dist/index.js",
18
+ "homepage": "https://terrazzoapp.com/docs/cli/integrations/css",
19
+ "repository": {
20
+ "type": "git",
21
+ "url": "https://github.com/terrazzoapp/terrazzo.git",
22
+ "directory": "./packages/plugin-css/"
23
+ },
24
+ "license": "MIT",
21
25
  "peerDependencies": {
22
26
  "@terrazzo/cli": "*"
23
27
  },
24
28
  "dependencies": {
25
- "@types/culori": "^2.1.0",
26
- "@types/mime": "^3.0.4",
27
- "culori": "^3.3.0",
28
- "mime": "^3.0.0",
29
- "svgo": "^3.3.2",
30
- "@terrazzo/parser": "^0.0.7",
31
- "@terrazzo/token-tools": "^0.0.3"
29
+ "@terrazzo/parser": "^0.0.10",
30
+ "@terrazzo/token-tools": "^0.0.4"
32
31
  },
33
32
  "devDependencies": {
34
- "yaml": "^2.4.3",
35
- "@terrazzo/cli": "^0.0.7"
33
+ "@terrazzo/cli": "^0.0.10"
36
34
  },
37
35
  "scripts": {
38
36
  "build": "pnpm run build:clean && pnpm run build:ts && pnpm run build:license",
package/src/build.ts DELETED
@@ -1,108 +0,0 @@
1
- import type { BuildHookOptions } from '@terrazzo/parser';
2
- import { isTokenMatch } from '@terrazzo/token-tools';
3
- import { generateShorthand } from '@terrazzo/token-tools/css';
4
- import { type CSSPluginOptions, type CSSRule, printRules, FORMAT_ID } from './lib.js';
5
-
6
- const P3_MQ = '@media (color-gamut: p3)';
7
- const REC2020_MQ = '@media (color-gamut: rec2020)';
8
-
9
- export interface BuildFormatOptions {
10
- exclude: CSSPluginOptions['exclude'];
11
- getTransforms: BuildHookOptions['getTransforms'];
12
- modeSelectors: CSSPluginOptions['modeSelectors'];
13
- }
14
-
15
- export default function buildFormat({ getTransforms, exclude, modeSelectors }: BuildFormatOptions): string {
16
- const rules: CSSRule[] = [];
17
-
18
- // :root
19
- const rootTokens = getTransforms({ format: FORMAT_ID, mode: '.' });
20
- if (rootTokens.length) {
21
- const rootRule: CSSRule = { selectors: [':root'], declarations: {} };
22
- // note: "nestedQuery" was designed specifically for higher-gamut colors to
23
- // apply color-gamut media queries to existing selectors (i.e. keep the same
24
- // targets, and apply another nested layer of media query filtering based on
25
- // hardware). Because of how CSS works they need to get built out into their
26
- // own selectors that have different structures depending on whether
27
- // `selectors` has a media query or not.
28
- const p3Rule: CSSRule = { selectors: [':root'], nestedQuery: P3_MQ, declarations: {} };
29
- const rec2020Rule: CSSRule = { selectors: [':root'], nestedQuery: REC2020_MQ, declarations: {} };
30
- rules.push(rootRule, p3Rule, rec2020Rule);
31
-
32
- for (const token of rootTokens) {
33
- if (isTokenMatch(token.token.id, exclude ?? [])) {
34
- continue;
35
- }
36
- const localID = token.localID ?? token.token.id;
37
- // single-value token
38
- if (token.type === 'SINGLE_VALUE') {
39
- rootRule.declarations[localID] = token.value;
40
- }
41
- // multi-value token (wide gamut color)
42
- else if (token.value.srgb && token.value.p3 && token.value.rec2020) {
43
- rootRule.declarations[localID] = token.value.srgb!;
44
- if (token.value.p3 !== token.value.srgb) {
45
- p3Rule.declarations[localID] = token.value.p3!;
46
- rec2020Rule.declarations[localID] = token.value.rec2020!;
47
- }
48
- }
49
- // multi-value token
50
- else if (token.type === 'MULTI_VALUE') {
51
- const shorthand = generateShorthand({ $type: token.token.$type, localID });
52
- if (shorthand) {
53
- rootRule.declarations[token.localID ?? token.token.id] = shorthand;
54
- }
55
- for (const [name, value] of Object.entries(token.value)) {
56
- rootRule.declarations[name === '.' ? localID : [localID, name].join('-')] = value;
57
- }
58
- }
59
- }
60
- }
61
-
62
- // modeSelectors (note: without these, modes won’t get written to CSS)
63
- for (const { selectors, tokens, mode } of modeSelectors ?? []) {
64
- if (!selectors.length) {
65
- continue;
66
- }
67
- const selectorTokens = getTransforms({ format: 'css', id: tokens, mode });
68
- if (!selectorTokens.length) {
69
- continue;
70
- }
71
-
72
- const selectorRule: CSSRule = { selectors, declarations: {} };
73
- const selectorP3Rule: CSSRule = { selectors, nestedQuery: P3_MQ, declarations: {} };
74
- const selectorRec2020Rule: CSSRule = { selectors, nestedQuery: REC2020_MQ, declarations: {} };
75
- rules.push(selectorRule, selectorP3Rule, selectorRec2020Rule);
76
-
77
- for (const token of selectorTokens) {
78
- if (token.token.aliasOf) {
79
- continue;
80
- }
81
- const localID = token.localID ?? token.token.id;
82
- // single-value token
83
- if (token.type === 'SINGLE_VALUE') {
84
- selectorRule.declarations[localID] = token.value;
85
- }
86
- // multi-value token (wide gamut color)
87
- else if (token.value.srgb && token.value.p3 && token.value.rec2020) {
88
- selectorRule.declarations[localID] = token.value.srgb!;
89
- if (token.value.p3 !== token.value.srgb) {
90
- selectorP3Rule.declarations[localID] = token.value.p3!;
91
- selectorRec2020Rule.declarations[localID] = token.value.rec2020!;
92
- }
93
- }
94
- // multi-value token
95
- else {
96
- const shorthand = generateShorthand({ $type: token.token.$type, localID });
97
- if (shorthand) {
98
- selectorRule.declarations[localID] = shorthand;
99
- }
100
- for (const [name, subvalue] of Object.entries(token.value)) {
101
- selectorRule.declarations[`${localID}-${name}`] = subvalue;
102
- }
103
- }
104
- }
105
- }
106
-
107
- return printRules(rules);
108
- }
package/src/index.ts DELETED
@@ -1,58 +0,0 @@
1
- import type { Plugin } from '@terrazzo/parser';
2
- import { makeCSSVar, transformCSSValue } from '@terrazzo/token-tools/css';
3
- import { FILE_PREFIX, FORMAT_ID, type CSSPluginOptions } from './lib.js';
4
- import buildFormat from './build.js';
5
- import { validateCustomTransform } from '@terrazzo/token-tools';
6
-
7
- export * from './build.js';
8
- export * from './lib.js';
9
-
10
- export default function cssPlugin({
11
- filename = './index.css',
12
- exclude,
13
- variableName,
14
- modeSelectors,
15
- transform: customTransform,
16
- }: CSSPluginOptions = {}): Plugin {
17
- const transformName = (id: string) => variableName?.(id) || makeCSSVar(id);
18
- const transformAlias = (id: string) => `var(${transformName(id)})`;
19
-
20
- return {
21
- name: '@terrazzo/plugin-css',
22
- async transform({ tokens, getTransforms, setTransform }) {
23
- // skip work if another .css plugin has already run
24
- const cssTokens = getTransforms({ format: FORMAT_ID, id: '*', mode: '*' });
25
- if (cssTokens.length) {
26
- return;
27
- }
28
-
29
- for (const id in tokens) {
30
- const token = tokens[id]!;
31
- const localID = transformName(id);
32
- for (const mode in token.mode) {
33
- if (customTransform) {
34
- const value = customTransform(token, mode);
35
- if (value !== undefined && value !== null) {
36
- validateCustomTransform(value, { $type: token.$type });
37
- setTransform(id, { format: FORMAT_ID, localID, value, mode });
38
- continue;
39
- }
40
- }
41
-
42
- const transformedValue = transformCSSValue(token, { mode, transformAlias });
43
- if (transformedValue !== undefined) {
44
- setTransform(id, { format: FORMAT_ID, localID, value: transformedValue, mode });
45
- }
46
- }
47
- }
48
- },
49
- async build({ getTransforms, outputFile }) {
50
- const output: string[] = [FILE_PREFIX, ''];
51
- output.push(
52
- buildFormat({ exclude, getTransforms, modeSelectors }),
53
- '\n', // EOF newline
54
- );
55
- outputFile(filename, output.join('\n'));
56
- },
57
- };
58
- }
package/src/lib.ts DELETED
@@ -1,110 +0,0 @@
1
- import type { TokenNormalized, TokenTransformed } from '@terrazzo/parser';
2
-
3
- export const FORMAT_ID = 'css';
4
-
5
- export const FILE_PREFIX = `/* -------------------------------------------
6
- * Autogenerated by ⛋ Terrazzo. DO NOT EDIT!
7
- * ------------------------------------------- */`;
8
-
9
- export interface CSSPluginOptions {
10
- /** Where to output CSS */
11
- filename?: string;
12
- /** Glob patterns to exclude tokens from output */
13
- exclude?: string[];
14
- /** Define mode selectors as media queries or CSS classes */
15
- modeSelectors?: ModeSelector[];
16
- /** Control the final CSS variable name */
17
- variableName?: (name: string) => string;
18
- /** Override certain token values */
19
- transform?: (token: TokenNormalized, mode: string) => TokenTransformed['value'];
20
- }
21
-
22
- export interface ModeSelector {
23
- /** The name of the mode to match */
24
- mode: string;
25
- /** (optional) Provide token IDs to match. Globs are allowed (e.g: `["color.*", "shadow.dark"]`) */
26
- tokens?: string[];
27
- /** Provide CSS selectors to generate. (e.g.: `["@media (prefers-color-scheme: dark)", "[data-color-theme='dark']"]` ) */
28
- selectors: string[];
29
- }
30
-
31
- // note: this is NOT an adequate replacement for a CSS AST; this just performs
32
- // basic deduplication and allows some limited parsing/reformatting before
33
- // flattening to a CSS string.
34
- export interface CSSRule {
35
- selectors: string[];
36
- nestedQuery?: string;
37
- declarations: Record<string, string>;
38
- }
39
-
40
- /** Convert CSSRules into a formatted, indented CSS string */
41
- export function printRules(rules: CSSRule[]): string {
42
- const output: string[] = [];
43
- for (const rule of rules) {
44
- if (!rule.selectors.length || !Object.keys(rule.declarations).length) {
45
- continue;
46
- }
47
-
48
- const mqSelectors: string[] = [];
49
- const joinableSelectors: string[] = [];
50
- for (const s of rule.selectors) {
51
- (s.startsWith('@') ? mqSelectors : joinableSelectors).push(s);
52
- }
53
- // @media-query selectors get pushed individually
54
- for (const s of mqSelectors) {
55
- output.push(_printRule({ ...rule, selectors: [s] }));
56
- }
57
- // all other selectors get joined as one
58
- if (joinableSelectors.length) {
59
- output.push(_printRule({ ...rule, selectors: joinableSelectors }));
60
- }
61
- }
62
- return output.join('\n\n');
63
- }
64
-
65
- function _printRule(rule: CSSRule): string {
66
- const output: string[] = [];
67
- const isMediaQuery = rule.selectors.some((s) => s.startsWith('@'));
68
- let indent = '';
69
-
70
- // if both levels are media queries, preserve order
71
- if (rule.nestedQuery && isMediaQuery) {
72
- output.push(`${indent}${rule.selectors.join(`,\n${indent}`)} {`);
73
- indent += ' ';
74
- output.push(`${indent}${rule.nestedQuery} {`);
75
- }
76
- // otherwise if nested query exists but parens aren’t media queries, reverse order (media queries on top)
77
- else if (rule.nestedQuery && !isMediaQuery) {
78
- output.push(`${indent}${rule.nestedQuery} {`);
79
- indent += ' ';
80
- output.push(`${indent}${rule.selectors.join(`,\n${indent}`)} {`);
81
- }
82
- // if no media queries, just print selectors
83
- else {
84
- output.push(`${indent}${rule.selectors.join(`,\n${indent}`)} {`);
85
- }
86
- indent += ' ';
87
-
88
- // note: this is ONLY dependent on whether the top level is a media query (ignores nestedQuery)
89
- if (isMediaQuery) {
90
- output.push(`${indent}:root {`);
91
- indent += ' ';
92
- }
93
-
94
- for (const [k, v] of Object.entries(rule.declarations)) {
95
- output.push(`${indent}${k}: ${v};`);
96
- }
97
-
98
- // base closing brackets on indent level
99
- while (indent !== '') {
100
- indent = indent.substring(0, indent.length - 2);
101
- output.push(`${indent}}`);
102
- }
103
-
104
- return output.join('\n');
105
- }
106
-
107
- export interface GetRuleOptions {
108
- /** Combine a selector with parent selectors (e.g. if adding a @media-query within another selector list) */
109
- parentSelectors?: string[];
110
- }