@zubyjs/purgecss 1.0.57

package/README.md

@@ -0,0 +1,59 @@
+# @zubyjs/purgecss
+
+The plugin for Zuby.js that will analyze your application
+using [PurgeCSS](https://purgecss.com) and remove unused CSS to keep your application as small as possible.
+
+## Installation
+
+First, install the `@zubyjs/purgecss` package using your favorite package manager.
+If you aren't sure, you can use npm:
+
+```sh
+npm install @zubyjs/purgecss
+```
+
+Then add the `@zubyjs/purgecss` plugin to your `zuby.config.mjs` file under the `plugins` option:
+
+```diff lang="js" title="zuby.config.mjs"
+  import { defineConfig } from 'zuby';
+  import preact from '@zubyjs/preact';
++ import purgecss from '@zubyjs/purgecss';
+
+  export default defineConfig({
+    outDir: '.zuby',
+    jsx: preact(),
++   plugins: [
++       purgecss()
++   ]
+    ^^^^^^^^
+  });
+```
+
+And that's it! You are ready to use all the power of PurgeCSS in your application.
+
+NOTE: Always make sure that all zuby packages are in sync in your `package.json` file:
+
+```diff lang="json"
+  {
+    "name": "my-zuby-app",
+    "version": "1.0.0",
+    "dependencies": {
+      "zuby": "latest",
+      "@zubyjs/purgecss": "latest"
+    }
+  }
+```
+
+## Contributing
+
+This package is part of Zuby.js workspace and maintained by the team behind the [Zuby package](https://www.npmjs.com/package/zuby).
+Please refer to it for more details how to contribute.
+
+## Acknowledgements
+
+This plugin is port of [astro-purgecss](https://github.com/codiume/orbit/tree/main/packages/astro-purgecss) package
+for Zuby.js Plugin API.
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,12 @@
+import { UserDefinedOptions } from 'purgecss';
+import { ZubyPlugin } from 'zuby/index.js';
+export interface PurgeCssPluginOptions extends Partial<UserDefinedOptions> {
+}
+/**
+ * Zuby.js plugin that integrates Tailwind CSS
+ * with your application.
+ * @param options
+ * @returns ZubyPlugin
+ */
+declare const _default: (options?: PurgeCssPluginOptions) => ZubyPlugin;
+export default _default;

package/index.js

@@ -0,0 +1,38 @@
+// This is port of the:
+// https://github.com/codiume/orbit/tree/main/packages/astro-purgecss
+// for the Zuby.js Plugin API
+import { PurgeCSS } from 'purgecss';
+import { writeFile } from 'fs/promises';
+import { normalizePath } from 'zuby/utils/pathUtils.js';
+/**
+ * Zuby.js plugin that integrates Tailwind CSS
+ * with your application.
+ * @param options
+ * @returns ZubyPlugin
+ */
+export default (options = {}) => ({
+    name: 'zuby-purgecss-plugin',
+    description: 'purging unused CSS...',
+    buildStep: true,
+    hooks: {
+        'zuby:build:done': async ({ config, logger }) => {
+            const { outDir } = config;
+            const purgeCss = new PurgeCSS();
+            logger.info(`Analyzing '${outDir}' dir for unused CSS...`);
+            const purged = await purgeCss.purge({
+                css: [normalizePath(`${outDir}/**/*.css`)],
+                defaultExtractor: content => content.match(/[\w-/:]+(?<!:)/g) || [],
+                ...options,
+                content: [
+                    normalizePath(`${outDir}/**/*.html`),
+                    normalizePath(`${outDir}/**/*.js`),
+                    ...(options.content || []),
+                ],
+            });
+            purged.forEach(({ file }) => logger.info(`Purged: ${file}`));
+            await Promise.all(purged
+                .filter(({ file }) => file?.endsWith('.css'))
+                .map(async ({ css, file }) => await writeFile(file, css)));
+        },
+    },
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@zubyjs/purgecss",
+  "version": "1.0.57",
+  "description": "Zuby.js purgecss plugin",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "release": "cd ./dist && npm publish --access public && cd ..",
+    "bump-version": "npm version patch",
+    "build": "rm -rf dist/ stage/ && mkdir dist && tsc && cp -rf package.json README.md stage/purgecss/src/* dist/ && rm -rf stage/",
+    "push-build": "npm run build && cd dist && yalc push --force && cd ..",
+    "test": "exit 0"
+  },
+  "publishConfig": {
+    "directory": "dist",
+    "linkDirectory": true
+  },
+  "peerDependencies": {
+    "zuby": "^1.0.0"
+  },
+  "dependencies": {
+    "purgecss": "^5.0.0"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/futrou/zuby.js/-/issues",
+    "email": "zuby@futrou.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/futrou/zuby.js.git"
+  },
+  "homepage": "https://zubyjs.com",
+  "keywords": [
+    "zuby-plugin",
+    "zuby",
+    "tailwind",
+    "css"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}