@charcoal-ui/tailwind-diff 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2022 pixiv Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,17 @@
+# `@charcoal-ui/tailwind-diff-cli`
+
+Tailwind.css の config 変更やバージョンアップに伴うクラスの変更（新しいクラスの追加、削除など）を検知します。
+
+## インストール
+
+npm
+
+```
+npm i --save-dev @charcoal-ui/tailwind-diff-cli
+```
+
+yarn
+
+```
+yarn add -D @charcoal-ui/tailwind-diff-cli
+```

package/bin/tailwind-diff.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index')

package/dist/commands/check.d.ts

@@ -0,0 +1,8 @@
+export interface CheckConfig {
+    format: 'default' | 'json';
+    beforeConfig?: string;
+    afterConfig?: string;
+    packages?: readonly string[];
+}
+export declare function check({ format, beforeConfig, afterConfig, packages, }: CheckConfig): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,GAAG,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B;AAED,wBAAsB,KAAK,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,WAAW,EACX,QAAa,GACd,EAAE,WAAW,iBAyFb"}

package/dist/commands/check.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.check = void 0;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const postcss_1 = __importDefault(require("postcss"));
+const defer_1 = require("../defer");
+const packageManager_1 = require("../packageManager");
+const style_1 = require("../style");
+const withPackages_1 = require("../withPackages");
+function processDone(child) {
+    return new Promise((resolve, reject) => {
+        child
+            .once('error', (err) => {
+            reject(err);
+        })
+            .once('exit', (code, signal) => {
+            if (code == null) {
+                return;
+            }
+            if (code === 0) {
+                resolve();
+            }
+            else if (signal != null) {
+                reject(new Error(`Subprocess failed with code: ${code}, signal: ${signal}`));
+            }
+            else {
+                reject(new Error(`Subprocess failed with code: ${code}`));
+            }
+        });
+    });
+}
+async function check({ format, beforeConfig, afterConfig, packages = [], }) {
+    const packageManager = (0, packageManager_1.detectPackageManager)(process.cwd());
+    const selfPath = path_1.default.resolve(__dirname, '../index.js');
+    const deferer = (0, defer_1.createDefer)();
+    const { defer, dispose } = deferer;
+    process.on('SIGINT', dispose);
+    try {
+        const tmpdir = fs_1.default.mkdtempSync(path_1.default.resolve(os_1.default.tmpdir(), 'tailwind-diff-css'));
+        defer(() => {
+            const files = fs_1.default.readdirSync(tmpdir);
+            for (const file of files) {
+                fs_1.default.unlinkSync(path_1.default.resolve(tmpdir, file));
+            }
+            fs_1.default.rmdirSync(tmpdir);
+        });
+        const beforeCSSPath = path_1.default.resolve(tmpdir, 'before.css');
+        defer(() => {
+            if (fs_1.default.existsSync(beforeCSSPath)) {
+                fs_1.default.unlinkSync(beforeCSSPath);
+            }
+        });
+        await processDone(child_process_1.default.fork(selfPath, [
+            'dump',
+            '--output',
+            beforeCSSPath,
+            ...(beforeConfig != null ? ['--config', beforeConfig] : []),
+        ]));
+        const afterCSSPath = path_1.default.resolve(tmpdir, 'after.css');
+        defer(() => {
+            if (fs_1.default.existsSync(afterCSSPath)) {
+                fs_1.default.unlinkSync(afterCSSPath);
+            }
+        });
+        await (0, withPackages_1.withPackages)(packageManager, packages, async () => {
+            await processDone(child_process_1.default.fork(selfPath, [
+                'dump',
+                '--output',
+                afterCSSPath,
+                ...(afterConfig != null ? ['--config', afterConfig] : []),
+            ]));
+        });
+        const beforeStyles = (0, style_1.collectClassNamesAndStyles)(postcss_1.default
+            .parse(fs_1.default.readFileSync(beforeCSSPath, { encoding: 'utf8' }))
+            .toResult());
+        const afterStyles = (0, style_1.collectClassNamesAndStyles)(postcss_1.default
+            .parse(fs_1.default.readFileSync(afterCSSPath, { encoding: 'utf8' }))
+            .toResult());
+        const diffs = (0, style_1.diffsBetweenStyles)(beforeStyles, afterStyles);
+        if (format === 'json') {
+            const json = diffs.map((item) => ({
+                ...item,
+                css: item.css.map((rule) => rule.toString()),
+            }));
+            process.stdout.write(JSON.stringify(json));
+        }
+        else {
+            let added = 0;
+            let removed = 0;
+            for (const item of diffs) {
+                if (item.status === 'added') {
+                    added++;
+                }
+                else {
+                    removed++;
+                }
+            }
+            console.log(`${added} classes added, ${removed} classes removed.`);
+        }
+    }
+    finally {
+        dispose();
+        process.off('SIGINT', dispose);
+    }
+}
+exports.check = check;

package/dist/commands/dump.d.ts

@@ -0,0 +1,6 @@
+export interface DumpConfig {
+    output?: string;
+    config?: string;
+}
+export declare function dump({ output, config }: DumpConfig): Promise<void>;
+//# sourceMappingURL=dump.d.ts.map

package/dist/commands/dump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../src/commands/dump.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,iBA2BxD"}

package/dist/commands/dump.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dump = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const stream_1 = __importDefault(require("stream"));
+const import_from_1 = __importDefault(require("import-from"));
+const sourceCSS = `
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+`;
+async function dump({ output, config }) {
+    const targetDir = process.cwd();
+    const postcss = (0, import_from_1.default)(targetDir, 'postcss');
+    const tailwindcss = (0, import_from_1.default)(targetDir, 'tailwindcss');
+    const tailwindConfig = import_from_1.default.silent(targetDir, config != null ? config : 'tailwind.config.js');
+    const result = await postcss([tailwindcss(tailwindConfig)]).process(sourceCSS, {
+        from: undefined,
+        to: undefined,
+        map: false,
+    });
+    const sink = output != null
+        ? fs_1.default.createWriteStream(path_1.default.resolve(targetDir, output))
+        : process.stdout;
+    stream_1.default.Readable.from(result.css).pipe(sink);
+}
+exports.dump = dump;

package/dist/defer.d.ts

@@ -0,0 +1,5 @@
+export declare function createDefer(): {
+    readonly defer: (deferFn: () => void) => void;
+    readonly dispose: () => void;
+};
+//# sourceMappingURL=defer.d.ts.map

package/dist/defer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.d.ts","sourceRoot":"","sources":["../src/defer.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW;8BAGD,MAAM,IAAI;;EAuBnC"}

package/dist/defer.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefer = void 0;
+function createDefer() {
+    const defers = [];
+    const defer = (deferFn) => {
+        defers.push(deferFn);
+    };
+    const dispose = () => {
+        // eslint-disable-next-line no-constant-condition, @typescript-eslint/no-unnecessary-condition
+        while (true) {
+            const deferFn = defers.pop();
+            if (deferFn == null) {
+                return;
+            }
+            try {
+                deferFn();
+            }
+            catch (err) {
+                console.error('Uncaught defer error:', err);
+            }
+        }
+    };
+    return {
+        defer,
+        dispose,
+    };
+}
+exports.createDefer = createDefer;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const check_1 = require("./commands/check");
+const dump_1 = require("./commands/dump");
+void yargs_1.default
+    .scriptName('tailwind-diff')
+    .command('check', 'checks diffs due to package updates', () => yargs_1.default
+    .option('config', {
+    type: 'string',
+    description: 'tailwind config file',
+})
+    .alias('c', 'config')
+    .option('before-config', {
+    type: 'string',
+    description: 'tailwind config used in first build',
+})
+    .option('after-config', {
+    type: 'string',
+    description: 'tailwind config used in second build',
+})
+    .option('packages', {
+    type: 'array',
+    description: 'packages to be update',
+})
+    .option('json', {
+    type: 'boolean',
+    description: 'print result as JSON format',
+}), ({ config, 'after-config': afterConfig, 'before-config': beforeConfig, packages, json = false, }) => {
+    void (0, check_1.check)({
+        format: json ? 'json' : 'default',
+        beforeConfig: beforeConfig != null ? beforeConfig : config,
+        afterConfig: afterConfig != null ? afterConfig : config,
+        packages: packages != null ? packages.map((v) => `${v}`) : undefined,
+    });
+})
+    .command('dump', 'dump Tailwind CSS with config', () => yargs_1.default
+    .option('output', { type: 'string', description: 'output file' })
+    .alias('o', 'output')
+    .option('config', {
+    type: 'string',
+    description: 'tailwind config file',
+})
+    .alias('c', 'config'), ({ output, config }) => {
+    void (0, dump_1.dump)({
+        output,
+        config,
+    });
+})
+    .demandCommand()
+    .help()
+    .parse();

package/dist/packageManager.d.ts

@@ -0,0 +1,9 @@
+declare type PackageManagerType = 'npm' | 'yarn' | 'pnpm';
+export interface PackageManagerInfo {
+    type: PackageManagerType;
+    packageJSONPath: string;
+    lockfilePath: string | undefined;
+}
+export declare function detectPackageManager(base: string): PackageManagerInfo;
+export {};
+//# sourceMappingURL=packageManager.d.ts.map

package/dist/packageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.d.ts","sourceRoot":"","sources":["../src/packageManager.ts"],"names":[],"mappings":"AAIA,aAAK,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAEjD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,kBAAkB,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA+CrE"}

package/dist/packageManager.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = void 0;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+function detectPackageManager(base) {
+    const upperbounds = [os_1.default.homedir(), path_1.default.resolve('/')];
+    let dir = fs_1.default.statSync(base).isDirectory() ? base : path_1.default.dirname(base);
+    while (!fs_1.default.existsSync(path_1.default.join(dir, 'package.json'))) {
+        const parent = path_1.default.dirname(dir);
+        if (upperbounds.includes(parent)) {
+            throw new Error('No node project found.');
+        }
+        dir = parent;
+    }
+    const packageJSONPath = path_1.default.join(dir, 'package.json');
+    let type = 'npm';
+    let lockfilePath;
+    do {
+        let lockfile;
+        lockfile = path_1.default.join(dir, 'package-lock.json');
+        if (fs_1.default.existsSync(lockfile)) {
+            lockfilePath = lockfile;
+            type = 'npm';
+            break;
+        }
+        lockfile = path_1.default.join(dir, 'yarn.lock');
+        if (fs_1.default.existsSync(lockfile)) {
+            lockfilePath = lockfile;
+            type = 'yarn';
+            break;
+        }
+        lockfile = path_1.default.join(dir, 'pnpm-lock.yaml');
+        if (fs_1.default.existsSync(lockfile)) {
+            lockfilePath = lockfile;
+            type = 'pnpm';
+            break;
+        }
+        dir = path_1.default.dirname(dir);
+    } while (!upperbounds.includes(dir));
+    return {
+        type,
+        packageJSONPath,
+        lockfilePath,
+    };
+}
+exports.detectPackageManager = detectPackageManager;

package/dist/style.d.ts

@@ -0,0 +1,11 @@
+import type { Result, Rule } from 'postcss';
+declare type ClassToStyles = Map<string, Rule[]>;
+export declare function collectClassNamesAndStyles(result: Result): ClassToStyles;
+export interface TailwindDiffItem {
+    className: string;
+    css: Rule[];
+    status: 'added' | 'removed';
+}
+export declare function diffsBetweenStyles(before: ClassToStyles, after: ClassToStyles): TailwindDiffItem[];
+export {};
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAG3C,aAAK,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AAIxC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAiBxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,IAAI,EAAE,CAAA;IACX,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B;AA6BD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,aAAa,sBA0BrB"}

package/dist/style.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffsBetweenStyles = exports.collectClassNamesAndStyles = void 0;
+const postcss_selector_parser_1 = __importDefault(require("postcss-selector-parser"));
+const selectorParser = (0, postcss_selector_parser_1.default)();
+function collectClassNamesAndStyles(result) {
+    const classToStyles = new Map();
+    result.root.walkRules((rule) => {
+        selectorParser.astSync(rule.selector).walkClasses((node) => {
+            const className = node.value.trim();
+            const styles = classToStyles.get(className);
+            if (styles != null) {
+                styles.push(rule);
+            }
+            else {
+                classToStyles.set(className, [rule]);
+            }
+        });
+    });
+    return classToStyles;
+}
+exports.collectClassNamesAndStyles = collectClassNamesAndStyles;
+// :の後ろが同じものが並んでほしいのでそれを前にしてソートする
+const tailwindClassNameSortMapper = (className) => {
+    if (className.includes(':')) {
+        const items = className.split(':');
+        let result = '';
+        result += items.pop();
+        result += `:${items.join(':')}`;
+        return result;
+    }
+    else {
+        return className;
+    }
+};
+const tailwindDiffItemSortMapper = (item) => tailwindClassNameSortMapper(item.className);
+const mappedSorter = (mapper) => (lhs, rhs) => {
+    const mappedLhs = mapper(lhs);
+    const mappedRhs = mapper(rhs);
+    if (mappedLhs < mappedRhs) {
+        return -1;
+    }
+    if (mappedLhs > mappedRhs) {
+        return 1;
+    }
+    return 0;
+};
+function diffsBetweenStyles(before, after) {
+    const diffs = [];
+    for (const afterClassName of after.keys()) {
+        if (!before.has(afterClassName)) {
+            diffs.push({
+                className: afterClassName,
+                status: 'added',
+                css: after.get(afterClassName),
+            });
+        }
+    }
+    for (const beforeClassName of before.keys()) {
+        if (!after.has(beforeClassName)) {
+            diffs.push({
+                className: beforeClassName,
+                status: 'removed',
+                css: before.get(beforeClassName),
+            });
+        }
+    }
+    diffs.sort(mappedSorter(tailwindDiffItemSortMapper));
+    return diffs;
+}
+exports.diffsBetweenStyles = diffsBetweenStyles;

package/dist/withPackages.d.ts

@@ -0,0 +1,9 @@
+import { PackageManagerInfo } from './packageManager';
+/**
+ * 指定したバージョンのパッケージが存在する状態で処理を行う
+ *
+ * @param packageDescripters 欲しいパッケージの一覧
+ * @param callback 実行したい処理
+ */
+export declare function withPackages<T>(packageManagerInfo: PackageManagerInfo, packageDescripters: readonly string[], callback: () => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=withPackages.d.ts.map

package/dist/withPackages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withPackages.d.ts","sourceRoot":"","sources":["../src/withPackages.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,kBAAkB,EAAE,kBAAkB,EACtC,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAuEZ"}

package/dist/withPackages.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withPackages = void 0;
+const child_process_1 = __importDefault(require("child_process"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const defer_1 = require("./defer");
+/**
+ * 指定したバージョンのパッケージが存在する状態で処理を行う
+ *
+ * @param packageDescripters 欲しいパッケージの一覧
+ * @param callback 実行したい処理
+ */
+async function withPackages(packageManagerInfo, packageDescripters, callback) {
+    if (packageDescripters.length === 0) {
+        return callback();
+    }
+    const deferer = (0, defer_1.createDefer)();
+    const { defer, dispose } = deferer;
+    process.on('SIGINT', dispose);
+    try {
+        const tmpdir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'tailwind-diff-packages-'));
+        defer(() => {
+            const files = fs_1.default.readdirSync(tmpdir);
+            for (const file of files) {
+                fs_1.default.unlinkSync(path_1.default.resolve(tmpdir, file));
+            }
+            fs_1.default.rmdirSync(tmpdir);
+        });
+        const backupPackageJSONPath = path_1.default.join(tmpdir, 'package.json');
+        fs_1.default.copyFileSync(packageManagerInfo.packageJSONPath, backupPackageJSONPath);
+        const packageLock = packageManagerInfo.lockfilePath != null
+            ? {
+                path: packageManagerInfo.lockfilePath,
+                backup: path_1.default.join(tmpdir, path_1.default.basename(packageManagerInfo.lockfilePath)),
+            }
+            : undefined;
+        if (packageLock != null) {
+            fs_1.default.copyFileSync(packageLock.path, packageLock.backup);
+        }
+        let cmd, recoverCmd;
+        switch (packageManagerInfo.type) {
+            case 'npm':
+                cmd = `npm install ${packageDescripters.join(' ')}`;
+                recoverCmd = 'npm install';
+                break;
+            case 'yarn':
+                cmd = `yarn add ${packageDescripters.join(' ')}`;
+                recoverCmd = 'yarn install';
+                break;
+            case 'pnpm':
+                cmd = `pnpm add ${packageDescripters.join(' ')}`;
+                recoverCmd = 'pnpm install';
+                break;
+        }
+        // execに失敗してもファイルは回復してほしい
+        defer(() => {
+            fs_1.default.unlinkSync(packageManagerInfo.packageJSONPath);
+            fs_1.default.copyFileSync(backupPackageJSONPath, packageManagerInfo.packageJSONPath);
+            if (packageLock != null) {
+                fs_1.default.unlinkSync(packageLock.path);
+                fs_1.default.copyFileSync(packageLock.backup, packageLock.path);
+            }
+            child_process_1.default.execSync(recoverCmd);
+        });
+        child_process_1.default.execSync(cmd);
+        return callback();
+    }
+    finally {
+        dispose();
+        process.off('SIGINT', dispose);
+    }
+}
+exports.withPackages = withPackages;

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@charcoal-ui/tailwind-diff",
+  "version": "1.0.0-alpha.1",
+  "bin": "bin/tailwind-diff.js",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "import-from": "^4.0.0",
+    "postcss": "^8.4.5",
+    "postcss-selector-parser": "^6.0.9",
+    "yargs": "^17.3.1"
+  },
+  "devDependencies": {
+    "@types/tailwindcss": "^2.2.4",
+    "@types/yargs": "^17.0.8",
+    "typescript": "^4.5.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "1d09e09a796f92782be600672efb5c80a6a7b51b"
+}

package/src/commands/check.ts

@@ -0,0 +1,136 @@
+import child_process from 'child_process'
+import type { ChildProcess } from 'child_process'
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import postcss from 'postcss'
+import { createDefer } from '../defer'
+import { detectPackageManager } from '../packageManager'
+import { collectClassNamesAndStyles, diffsBetweenStyles } from '../style'
+import { withPackages } from '../withPackages'
+
+function processDone(child: ChildProcess) {
+  return new Promise<void>((resolve, reject) => {
+    child
+      .once('error', (err) => {
+        reject(err)
+      })
+      .once('exit', (code, signal) => {
+        if (code == null) {
+          return
+        }
+        if (code === 0) {
+          resolve()
+        } else if (signal != null) {
+          reject(
+            new Error(`Subprocess failed with code: ${code}, signal: ${signal}`)
+          )
+        } else {
+          reject(new Error(`Subprocess failed with code: ${code}`))
+        }
+      })
+  })
+}
+
+export interface CheckConfig {
+  format: 'default' | 'json'
+  beforeConfig?: string
+  afterConfig?: string
+  packages?: readonly string[]
+}
+
+export async function check({
+  format,
+  beforeConfig,
+  afterConfig,
+  packages = [],
+}: CheckConfig) {
+  const packageManager = detectPackageManager(process.cwd())
+
+  const selfPath = path.resolve(__dirname, '../index.js')
+
+  const deferer = createDefer()
+  const { defer, dispose } = deferer
+  process.on('SIGINT', dispose)
+  try {
+    const tmpdir = fs.mkdtempSync(
+      path.resolve(os.tmpdir(), 'tailwind-diff-css')
+    )
+    defer(() => {
+      const files = fs.readdirSync(tmpdir)
+      for (const file of files) {
+        fs.unlinkSync(path.resolve(tmpdir, file))
+      }
+      fs.rmdirSync(tmpdir)
+    })
+
+    const beforeCSSPath = path.resolve(tmpdir, 'before.css')
+    defer(() => {
+      if (fs.existsSync(beforeCSSPath)) {
+        fs.unlinkSync(beforeCSSPath)
+      }
+    })
+
+    await processDone(
+      child_process.fork(selfPath, [
+        'dump',
+        '--output',
+        beforeCSSPath,
+        ...(beforeConfig != null ? ['--config', beforeConfig] : []),
+      ])
+    )
+
+    const afterCSSPath = path.resolve(tmpdir, 'after.css')
+    defer(() => {
+      if (fs.existsSync(afterCSSPath)) {
+        fs.unlinkSync(afterCSSPath)
+      }
+    })
+
+    await withPackages(packageManager, packages, async () => {
+      await processDone(
+        child_process.fork(selfPath, [
+          'dump',
+          '--output',
+          afterCSSPath,
+          ...(afterConfig != null ? ['--config', afterConfig] : []),
+        ])
+      )
+    })
+
+    const beforeStyles = collectClassNamesAndStyles(
+      postcss
+        .parse(fs.readFileSync(beforeCSSPath, { encoding: 'utf8' }))
+        .toResult()
+    )
+    const afterStyles = collectClassNamesAndStyles(
+      postcss
+        .parse(fs.readFileSync(afterCSSPath, { encoding: 'utf8' }))
+        .toResult()
+    )
+
+    const diffs = diffsBetweenStyles(beforeStyles, afterStyles)
+
+    if (format === 'json') {
+      const json = diffs.map((item) => ({
+        ...item,
+        css: item.css.map((rule) => rule.toString()),
+      }))
+      process.stdout.write(JSON.stringify(json))
+    } else {
+      let added = 0
+      let removed = 0
+      for (const item of diffs) {
+        if (item.status === 'added') {
+          added++
+        } else {
+          removed++
+        }
+      }
+      console.log(`${added} classes added, ${removed} classes removed.`)
+    }
+  } finally {
+    dispose()
+    process.off('SIGINT', dispose)
+  }
+}

package/src/commands/dump.ts

@@ -0,0 +1,45 @@
+import fs from 'fs'
+import path from 'path'
+import stream from 'stream'
+import importFrom from 'import-from'
+import type { TailwindConfig } from 'tailwindcss/tailwind-config'
+
+const sourceCSS = `
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+`
+
+export interface DumpConfig {
+  output?: string
+  config?: string
+}
+
+export async function dump({ output, config }: DumpConfig) {
+  const targetDir = process.cwd()
+  const postcss = importFrom(
+    targetDir,
+    'postcss'
+  ) as typeof import('postcss').default
+  const tailwindcss = importFrom(
+    targetDir,
+    'tailwindcss'
+  ) as typeof import('tailwindcss')
+  const tailwindConfig = importFrom.silent(
+    targetDir,
+    config != null ? config : 'tailwind.config.js'
+  ) as TailwindConfig
+  const result = await postcss([tailwindcss(tailwindConfig)]).process(
+    sourceCSS,
+    {
+      from: undefined,
+      to: undefined,
+      map: false,
+    }
+  )
+  const sink =
+    output != null
+      ? fs.createWriteStream(path.resolve(targetDir, output))
+      : process.stdout
+  stream.Readable.from(result.css).pipe(sink)
+}

package/src/defer.ts

@@ -0,0 +1,27 @@
+export function createDefer() {
+  const defers: (() => void)[] = []
+
+  const defer = (deferFn: () => void) => {
+    defers.push(deferFn)
+  }
+
+  const dispose = () => {
+    // eslint-disable-next-line no-constant-condition, @typescript-eslint/no-unnecessary-condition
+    while (true) {
+      const deferFn = defers.pop()
+      if (deferFn == null) {
+        return
+      }
+      try {
+        deferFn()
+      } catch (err: unknown) {
+        console.error('Uncaught defer error:', err)
+      }
+    }
+  }
+
+  return {
+    defer,
+    dispose,
+  } as const
+}

package/src/index.ts

@@ -0,0 +1,69 @@
+import yargs from 'yargs'
+import { check } from './commands/check'
+import { dump } from './commands/dump'
+
+void yargs
+  .scriptName('tailwind-diff')
+  .command(
+    'check',
+    'checks diffs due to package updates',
+    () =>
+      yargs
+        .option('config', {
+          type: 'string',
+          description: 'tailwind config file',
+        })
+        .alias('c', 'config')
+        .option('before-config', {
+          type: 'string',
+          description: 'tailwind config used in first build',
+        })
+        .option('after-config', {
+          type: 'string',
+          description: 'tailwind config used in second build',
+        })
+        .option('packages', {
+          type: 'array',
+          description: 'packages to be update',
+        })
+        .option('json', {
+          type: 'boolean',
+          description: 'print result as JSON format',
+        }),
+    ({
+      config,
+      'after-config': afterConfig,
+      'before-config': beforeConfig,
+      packages,
+      json = false,
+    }) => {
+      void check({
+        format: json ? 'json' : 'default',
+        beforeConfig: beforeConfig != null ? beforeConfig : config,
+        afterConfig: afterConfig != null ? afterConfig : config,
+        packages: packages != null ? packages.map((v) => `${v}`) : undefined,
+      })
+    }
+  )
+  .command(
+    'dump',
+    'dump Tailwind CSS with config',
+    () =>
+      yargs
+        .option('output', { type: 'string', description: 'output file' })
+        .alias('o', 'output')
+        .option('config', {
+          type: 'string',
+          description: 'tailwind config file',
+        })
+        .alias('c', 'config'),
+    ({ output, config }) => {
+      void dump({
+        output,
+        config,
+      })
+    }
+  )
+  .demandCommand()
+  .help()
+  .parse()

package/src/packageManager.ts

@@ -0,0 +1,60 @@
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+
+type PackageManagerType = 'npm' | 'yarn' | 'pnpm'
+
+export interface PackageManagerInfo {
+  type: PackageManagerType
+  packageJSONPath: string
+  lockfilePath: string | undefined
+}
+
+export function detectPackageManager(base: string): PackageManagerInfo {
+  const upperbounds = [os.homedir(), path.resolve('/')]
+  let dir = fs.statSync(base).isDirectory() ? base : path.dirname(base)
+
+  while (!fs.existsSync(path.join(dir, 'package.json'))) {
+    const parent = path.dirname(dir)
+    if (upperbounds.includes(parent)) {
+      throw new Error('No node project found.')
+    }
+    dir = parent
+  }
+  const packageJSONPath = path.join(dir, 'package.json')
+
+  let type: PackageManagerType = 'npm'
+  let lockfilePath: string | undefined
+  do {
+    let lockfile: string
+
+    lockfile = path.join(dir, 'package-lock.json')
+    if (fs.existsSync(lockfile)) {
+      lockfilePath = lockfile
+      type = 'npm'
+      break
+    }
+
+    lockfile = path.join(dir, 'yarn.lock')
+    if (fs.existsSync(lockfile)) {
+      lockfilePath = lockfile
+      type = 'yarn'
+      break
+    }
+
+    lockfile = path.join(dir, 'pnpm-lock.yaml')
+    if (fs.existsSync(lockfile)) {
+      lockfilePath = lockfile
+      type = 'pnpm'
+      break
+    }
+
+    dir = path.dirname(dir)
+  } while (!upperbounds.includes(dir))
+
+  return {
+    type,
+    packageJSONPath,
+    lockfilePath,
+  }
+}

package/src/style.ts

@@ -0,0 +1,88 @@
+import type { Result, Rule } from 'postcss'
+import postcssSelectorParser from 'postcss-selector-parser'
+
+type ClassToStyles = Map<string, Rule[]>
+
+const selectorParser = postcssSelectorParser()
+
+export function collectClassNamesAndStyles(result: Result): ClassToStyles {
+  const classToStyles = new Map<string, Rule[]>()
+
+  result.root.walkRules((rule) => {
+    selectorParser.astSync(rule.selector).walkClasses((node) => {
+      const className = node.value.trim()
+
+      const styles = classToStyles.get(className)
+      if (styles != null) {
+        styles.push(rule)
+      } else {
+        classToStyles.set(className, [rule])
+      }
+    })
+  })
+
+  return classToStyles
+}
+
+export interface TailwindDiffItem {
+  className: string
+  css: Rule[]
+  status: 'added' | 'removed'
+}
+
+// :の後ろが同じものが並んでほしいのでそれを前にしてソートする
+const tailwindClassNameSortMapper = (className: string) => {
+  if (className.includes(':')) {
+    const items = className.split(':')
+    let result = ''
+    result += items.pop()
+    result += `:${items.join(':')}`
+    return result
+  } else {
+    return className
+  }
+}
+const tailwindDiffItemSortMapper = (item: TailwindDiffItem) =>
+  tailwindClassNameSortMapper(item.className)
+const mappedSorter =
+  <A, B>(mapper: (value: A) => B) =>
+  (lhs: A, rhs: A) => {
+    const mappedLhs = mapper(lhs)
+    const mappedRhs = mapper(rhs)
+    if (mappedLhs < mappedRhs) {
+      return -1
+    }
+    if (mappedLhs > mappedRhs) {
+      return 1
+    }
+    return 0
+  }
+export function diffsBetweenStyles(
+  before: ClassToStyles,
+  after: ClassToStyles
+) {
+  const diffs: TailwindDiffItem[] = []
+
+  for (const afterClassName of after.keys()) {
+    if (!before.has(afterClassName)) {
+      diffs.push({
+        className: afterClassName,
+        status: 'added',
+        css: after.get(afterClassName)!,
+      })
+    }
+  }
+  for (const beforeClassName of before.keys()) {
+    if (!after.has(beforeClassName)) {
+      diffs.push({
+        className: beforeClassName,
+        status: 'removed',
+        css: before.get(beforeClassName)!,
+      })
+    }
+  }
+
+  diffs.sort(mappedSorter(tailwindDiffItemSortMapper))
+
+  return diffs
+}

package/src/withPackages.ts

@@ -0,0 +1,89 @@
+import child_process from 'child_process'
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import { createDefer } from './defer'
+import { PackageManagerInfo } from './packageManager'
+
+/**
+ * 指定したバージョンのパッケージが存在する状態で処理を行う
+ *
+ * @param packageDescripters 欲しいパッケージの一覧
+ * @param callback 実行したい処理
+ */
+export async function withPackages<T>(
+  packageManagerInfo: PackageManagerInfo,
+  packageDescripters: readonly string[],
+  callback: () => T | Promise<T>
+): Promise<T> {
+  if (packageDescripters.length === 0) {
+    return callback()
+  }
+
+  const deferer = createDefer()
+  const { defer, dispose } = deferer
+  process.on('SIGINT', dispose)
+
+  try {
+    const tmpdir = fs.mkdtempSync(
+      path.join(os.tmpdir(), 'tailwind-diff-packages-')
+    )
+    defer(() => {
+      const files = fs.readdirSync(tmpdir)
+      for (const file of files) {
+        fs.unlinkSync(path.resolve(tmpdir, file))
+      }
+      fs.rmdirSync(tmpdir)
+    })
+
+    const backupPackageJSONPath = path.join(tmpdir, 'package.json')
+    fs.copyFileSync(packageManagerInfo.packageJSONPath, backupPackageJSONPath)
+
+    const packageLock =
+      packageManagerInfo.lockfilePath != null
+        ? {
+            path: packageManagerInfo.lockfilePath,
+            backup: path.join(
+              tmpdir,
+              path.basename(packageManagerInfo.lockfilePath)
+            ),
+          }
+        : undefined
+    if (packageLock != null) {
+      fs.copyFileSync(packageLock.path, packageLock.backup)
+    }
+
+    let cmd: string, recoverCmd: string
+    switch (packageManagerInfo.type) {
+      case 'npm':
+        cmd = `npm install ${packageDescripters.join(' ')}`
+        recoverCmd = 'npm install'
+        break
+      case 'yarn':
+        cmd = `yarn add ${packageDescripters.join(' ')}`
+        recoverCmd = 'yarn install'
+        break
+      case 'pnpm':
+        cmd = `pnpm add ${packageDescripters.join(' ')}`
+        recoverCmd = 'pnpm install'
+        break
+    }
+
+    // execに失敗してもファイルは回復してほしい
+    defer(() => {
+      fs.unlinkSync(packageManagerInfo.packageJSONPath)
+      fs.copyFileSync(backupPackageJSONPath, packageManagerInfo.packageJSONPath)
+      if (packageLock != null) {
+        fs.unlinkSync(packageLock.path)
+        fs.copyFileSync(packageLock.backup, packageLock.path)
+      }
+      child_process.execSync(recoverCmd)
+    })
+    child_process.execSync(cmd)
+
+    return callback()
+  } finally {
+    dispose()
+    process.off('SIGINT', dispose)
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "outDir": "./dist"
+  },
+  "include": ["./src"]
+}