postcss-preset-env: add postcss-content-alt-text (#1426)

Author: romainmenke

cli/csstools-cli/CHANGELOG.md

@@ -1,7 +1,8 @@
 # Changes to CSSTools CLI
 
-### Unreleased (patch)
+### Unreleased (minor)
 
+- Added `@csstools/postcss-content-alt-text` [Check the plugin README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-content-alt-text#readme) for usage details.
 - Updated [`@csstools/postcss-color-function`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function) to [`3.0.19`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function/CHANGELOG.md#3019) (patch)
 - Updated [`@csstools/postcss-color-mix-function`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function) to [`2.0.19`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function/CHANGELOG.md#2019) (patch)
 - Updated [`@csstools/postcss-gradients-interpolation-method`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-gradients-interpolation-method) to [`4.0.20`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-gradients-interpolation-method/CHANGELOG.md#4020) (patch)

cli/csstools-cli/dist/cli.cjs

@@ -41,6 +41,7 @@
 		"@csstools/postcss-cascade-layers": "^4.0.6",
 		"@csstools/postcss-color-function": "^3.0.19",
 		"@csstools/postcss-color-mix-function": "^2.0.19",
+		"@csstools/postcss-content-alt-text": "^1.0.0",
 		"@csstools/postcss-exponential-functions": "^1.0.9",
 		"@csstools/postcss-font-format-keywords": "^3.0.2",
 		"@csstools/postcss-gradients-interpolation-method": "^4.0.20",

cli/csstools-cli/package.json

@@ -8,6 +8,7 @@ import postcssColorFunctionalNotation from './plugins/postcss-color-functional-n
 import postcssColorHexAlpha from './plugins/postcss-color-hex-alpha';
 import postcssColorMixFunction from './plugins/postcss-color-mix-function';
 import postcssColorRebeccaPurple from './plugins/postcss-color-rebeccapurple';
+import postcssContentAltText from './plugins/postcss-content-alt-text';
 import postcssCustomMedia from './plugins/postcss-custom-media';
 import postcssCustomProperties from './plugins/postcss-custom-properties';
 import postcssCustomSelectors from './plugins/postcss-custom-selectors';
@@ -81,6 +82,9 @@ async function main(): Promise<void> {
 		case 'postcss-color-rebeccapurple':
 			await postcssColorRebeccaPurple();
 			return;
+		case 'postcss-content-alt-text':
+			await postcssContentAltText();
+			return;
 		case 'postcss-custom-media':
 			await postcssCustomMedia();
 			return;
@@ -218,6 +222,7 @@ async function main(): Promise<void> {
 				'  postcss-color-hex-alpha',
 				'  postcss-color-mix-function',
 				'  postcss-color-rebeccapurple',
+				'  postcss-content-alt-text',
 				'  postcss-custom-media',
 				'  postcss-custom-properties',
 				'  postcss-custom-selectors',

cli/csstools-cli/src/cli.ts

@@ -0,0 +1,20 @@
+import plugin from '@csstools/postcss-content-alt-text';
+import { cli, helpTextLogger } from '@csstools/base-cli';
+
+export default async function postcssContentAltText(): Promise<void> {
+	await cli(
+		plugin,
+		['preserve', 'stripAltText', 'enableProgressiveCustomProperties'],
+		helpTextLogger(
+			'@csstools/cli postcss-content-alt-text',
+			'PostCSS Content Alt Text',
+			'Generate fallback values for content with alt text.',
+			{
+				preserve: true,
+				stripAltText: false,
+				enableProgressiveCustomProperties: true,
+			},
+		),
+		false,
+	);
+}

cli/csstools-cli/src/plugins/postcss-content-alt-text.ts

@@ -1,7 +1,9 @@
 # Changes to PostCSS Preset Env
 
-### Unreleased (patch)
+### Unreleased (minor)
 
+- Added `@csstools/postcss-content-alt-text` [Check the plugin README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-content-alt-text#readme) for usage details.
+- Updated [`cssdb`](https://github.com/csstools/cssdb) to [`8.1.0`](https://github.com/csstools/cssdb/blob/main/CHANGELOG.md#810-jul-7-2024) (minor)
 - Updated [`@csstools/postcss-progressive-custom-properties`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties) to [`3.3.0`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties/CHANGELOG.md#330) (minor)
 - Updated [`@csstools/postcss-color-function`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function) to [`3.0.19`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function/CHANGELOG.md#3019) (patch)
 - Updated [`@csstools/postcss-color-mix-function`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function) to [`2.0.19`](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function/CHANGELOG.md#2019) (patch)

package-lock.json

@@ -14,6 +14,7 @@ The `ID` listed is the key for PostCSS Preset Env configuration in your project.
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/color-function.svg" height="18">](https://cssdb.org/#color-function) | `color-function` | `color()` Function | [example](https://preset-env.cssdb.org/features/#color-function) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-function#readme) |
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/color-functional-notation.svg" height="18">](https://cssdb.org/#color-functional-notation) | `color-functional-notation` | Color Functional Notation | [example](https://preset-env.cssdb.org/features/#color-functional-notation) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-functional-notation#readme) |
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/color-mix.svg" height="18">](https://cssdb.org/#color-mix) | `color-mix` | `color-mix()` Function | [example](https://preset-env.cssdb.org/features/#color-mix) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-color-mix-function#readme) |
+| [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/content-alt-text.svg" height="18">](https://cssdb.org/#content-alt-text) | `content-alt-text` | Alt text for `content` | [example](https://preset-env.cssdb.org/features/#content-alt-text) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-content-alt-text#readme) |
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/custom-media-queries.svg" height="18">](https://cssdb.org/#custom-media-queries) | `custom-media-queries` | Custom Media Queries | [example](https://preset-env.cssdb.org/features/#custom-media-queries) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-custom-media#readme) |
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/custom-properties.svg" height="18">](https://cssdb.org/#custom-properties) | `custom-properties` | Custom Properties | [example](https://preset-env.cssdb.org/features/#custom-properties) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-custom-properties#readme) |
 | [<img alt="Baseline Status" src="https://cssdb.org/images/badges-baseline/custom-selectors.svg" height="18">](https://cssdb.org/#custom-selectors) | `custom-selectors` | Custom Selectors | [example](https://preset-env.cssdb.org/features/#custom-selectors) | [docs](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-custom-selectors#readme) |