rebuild

Author: romainmenke

packages/css-color-parser/docs/css-color-parser.syntaxflag.md

@@ -59,6 +59,22 @@ ColorMix
 Is a mixed color, e.g. `color-mix(in oklch, red, blue)`
 
 
+</td></tr>
+<tr><td>
+
+ColorMixVariadic
+
+
+</td><td>
+
+`"color-mix-variadic"`
+
+
+</td><td>
+
+Is a variadic mixed color, e.g. `color-mix(in oklch, red)` `color-mix(in oklch, red, blue, green)`
+
+
 </td></tr>
 <tr><td>
 

packages/postcss-tape/dist/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * A test suite for PostCSS plugins.
+ *
+ * @example
+ * ```sh
+ * node --test
+ * ```
+ *
+ * ```js
+ * // test/_tape.mjs
+ * import { postcssTape } from '@csstools/postcss-tape';
+ * import plugin from '<your plugin package name>';
+ *
+ * postcssTape(plugin)({
+ * 	basic: {
+ * 		message: "supports basic usage",
+ * 	},
+ * 	'basic:color': {
+ * 		message: "supports { color: '<a color>' }",
+ * 		options: {
+ * 			color: 'purple'
+ * 		}
+ * 	},
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import type { Declaration } from 'postcss';
+import type { Plugin } from 'postcss';
+import type { PluginCreator } from 'postcss';
+
+/**
+ * A dummy PostCSS plugin that clones any at rule with params `to-clone` to a new at rule with params `cloned`.
+ */
+export declare const atRuleClonerPlugin: {
+    postcssPlugin: string;
+    prepare(): Plugin;
+};
+
+/**
+ * A dummy PostCSS plugin that clones any declaration with the property `to-clone` to a new declaration with the property `cloned`.
+ */
+export declare const declarationClonerPlugin: {
+    postcssPlugin: string;
+    Declaration(decl: Declaration): void;
+};
+
+/**
+ * General options for `@csstools/postcss-tape`.
+ * These affect the entire test run, not individual test cases.
+ *
+ * @example
+ * ```js
+ * import { postcssTape } from '@csstools/postcss-tape';
+ * import plugin from 'your-postcss-plugin';
+ *
+ * postcssTape(plugin, {
+ *   skipPackageNameCheck: true,
+ * })(...);
+ * ```
+ */
+export declare type Options = {
+    /**
+     * PostCSS plugins should start their name with `postcss-`.
+     * If this is something you do not want to do, you can set this to `true` to skip this check.
+     */
+    skipPackageNameCheck?: boolean;
+};
+
+/**
+ * Create a test suite for a PostCSS plugin.
+ */
+export declare function postcssTape(pluginCreator: PluginCreator<unknown>, runOptions?: Options): (options: Record<string, TestCaseOptions>) => Promise<void>;
+
+/**
+ * A dummy PostCSS plugin that clones any rule with the selector `to-clone` to a new rule with the selector `cloned`.
+ */
+export declare const ruleClonerPlugin: {
+    postcssPlugin: string;
+    prepare(): Plugin;
+};
+
+/**
+ * Options for a test case.
+ */
+export declare interface TestCaseOptions {
+    /** Debug message */
+    message?: string;
+    /** Plugin options. Only used if `plugins` is not specified. */
+    options?: unknown;
+    /** Plugins to use. When specified the original plugin is not used. */
+    plugins?: Array<Plugin>;
+    /** The expected number of warnings. */
+    warnings?: number;
+    /** Expected exception */
+    exception?: RegExp;
+    /** Override the file name of the "source" file. */
+    source?: string;
+    /** Override the file name of the "expect" file. */
+    expect?: string;
+    /** Override the file name of the "result" file. */
+    result?: string;
+    /** Do something before the test is run. */
+    before?: () => void | Promise<void>;
+    /** Do something after the test is run. */
+    after?: () => void | Promise<void>;
+}
+
+export { }

packages/postcss-tape/dist/index.mjs

@@ -0,0 +1,3 @@
+/* node:coverage disable */
+import e from"node:assert/strict";import s from"node:fs/promises";import t from"node:fs";import o from"node:path";import n from"postcss";import r from"postcss-8.4";import i from"node:test";import a from"node:url";const noopPlugin=()=>({postcssPlugin:"noop-plugin",Once(){}});async function fileContentsOrEmptyString(e){try{return await s.readFile(e,"utf8")}catch{return""}}function reduceInformationInCssSyntaxError(e){process.env.DEBUG||(delete e.source,e.input&&delete e.input.source,delete e.postcssNode)}function postcssTape(a,c){return async p=>{c=c??{},await i("`postcss` flag is set on exported plugin creator",(()=>{e.equal(a.postcss,!0)})),await i("exported plugin creator is a function",(()=>{e.equal(typeof a,"function")})),await i("`postcssPlugin` is set on a plugin instance",(()=>{const s=a();e.ok(s.postcssPlugin),e.equal(typeof s.postcssPlugin,"string")})),await i("package.json",(async t=>{const o=await s.readFile("./package.json","utf-8"),n=JSON.parse(o);await t.test('includes "postcss-plugin" keyword',(()=>{e.ok(Array.isArray(n.keywords)&&n.keywords?.includes("postcss-plugin"),new PackageDescriptionError('Missing "postcss-plugin" keyword in package.json',"keywords"))})),await t.test('name starts with "postcss-"',{skip:c?.skipPackageNameCheck},(()=>{let s="string"==typeof n.name?n.name:"";if(s.startsWith("@")){const e=s.split("/");s=e.slice(1).join("/")}e.ok(s.startsWith("postcss-"),new PackageDescriptionError(`package name "${s}" does not start with "postcss-"`,"name"))})),await t.test("`postcss` is a peer dependency and not a direct dependency",{skip:"postcssTapeSelfTest"in a},(()=>{e.ok(Object.keys(Object(n.peerDependencies)).includes("postcss"),new PackageDescriptionError('"postcss" must be listed in "peerDependencies"',"peerDependencies")),e.ok(!Object.keys(Object(n.dependencies)).includes("postcss"),new PackageDescriptionError('"postcss" must not be listed in "dependencies"',"dependencies"))}))}));const l=a().postcssPlugin;await i(l,(async i=>{for(const c in p)await i.test(c,(async i=>{const l=p[c];l.before&&await l.before();const u=o.join(".","test",...c.split(":")[0].split(o.posix.sep)),d=o.join(".","test",...c.replace(/:/g,".").split(o.posix.sep)),m="css";let g=`${u}.${m}`,w=`${d}.expect.${m}`,f=`${d}.result.${m}`;l.source&&(g=o.join(".","test",l.source)),l.expect&&(w=o.join(".","test",l.expect)),l.result&&(f=o.join(".","test",l.result));const k=l.plugins??[a(l.options)],h=await fileContentsOrEmptyString(g),y=await fileContentsOrEmptyString(w);let E;try{E=await n(k).process(h,{from:g,to:f,map:{inline:!1,annotation:!1}})}catch(e){if(!(e instanceof Error))throw e;if(reduceInformationInCssSyntaxError(e),l.exception&&l.exception.test(e.message))return;throw e}e.ok(!l.exception,new OutcomeError(`expected an exception matching "${l.exception}"`,g));const x=E.css.toString();{const e=[s.writeFile(f,x,"utf8")];process.env.REWRITE_EXPECTS&&e.push(s.writeFile(w,x,"utf8")),await Promise.all(e)}y||e.ok(t.existsSync(w),new OutcomeError(`Missing expect file: "${w}"`,g)),await i.test("has expected output",(()=>{e.deepEqual(x,y),e.deepEqual(E.warnings().length,l.warnings??0,`Unexpected number warnings:\n${E.warnings().toString()}`)})),await i.test("sourcemaps",(()=>{e.ok(!E.map.toJSON().sources.includes("<no source>"),'Sourcemap is broken. This is most likely a newly created PostCSS AST Node without a value for "source". See: https://github.com/postcss/postcss/blob/main/docs/guidelines/plugin.md#24-set-nodesource-for-new-nodes')})),l.after&&await l.after(),await i.test("output is parsable with PostCSS",(async()=>{const s=await fileContentsOrEmptyString(f),t=await n([noopPlugin()]).process(s,{from:f,to:f,map:{inline:!1,annotation:!1}});e.deepEqual(t.warnings(),[],"Unexpected warnings on second pass")})),await i.test("The oldest and current PostCSS version produce the same result",{skip:n([noopPlugin()]).version===r([noopPlugin()]).version},(async()=>{const s=await r(k).process(h,{from:g,to:f,map:{inline:!1,annotation:!1}});e.deepEqual(s.css.toString(),x)}))}))}))}}noopPlugin.postcss=!0;const c={postcssPlugin:"declaration-cloner",Declaration(e){"to-clone"===e.prop&&e.cloneBefore({prop:"cloned"})}},p={postcssPlugin:"rule-cloner",prepare(){const e=new WeakSet;return{postcssPlugin:"rule-cloner",RuleExit(s){e.has(s)||"to-clone"===s.selector&&(e.add(s),s.cloneBefore({selector:"cloned"}))}}}},l={postcssPlugin:"at-rule-cloner",prepare(){const e=new WeakSet;return{postcssPlugin:"at-rule-cloner",AtRuleExit(s){if(!e.has(s))return"to-clone"===s.params?(e.add(s),void s.cloneBefore({params:"cloned"})):"to-clone"===s.name?(e.add(s),void s.cloneBefore({name:"cloned"})):void 0}}}};class PackageDescriptionError extends Error{constructor(e,s){super(e),this.name="PackageDescriptionError",this.stack=`${this.name}: ${this.message}\n    at "${s}" (${a.pathToFileURL(o.resolve("package.json")).href}:1:1)`}}class OutcomeError extends Error{constructor(e,s){super(e),this.name="OutcomeError",this.stack=`${this.name}: ${this.message}\n    at ${a.pathToFileURL(o.resolve(s)).href}:1:1`}}export{l as atRuleClonerPlugin,c as declarationClonerPlugin,postcssTape,p as ruleClonerPlugin};
+/* node:coverage enable */