astro-purgecss 1.0.0

package/README.md

@@ -0,0 +1,83 @@
+# 🚀 Astro Purgecss
+
+[![version][version-badge]][npm]
+[![downloads][downloads-badge]][npm]
+[![github actions][github-actions-badge]][github-actions]
+[![typescript][typescript-badge]][typescript]
+[![makepr][makepr-badge]][makepr]
+
+[Purgecss][purgecss] helps you remove unused CSS rules from your final astro bundle.
+
+## 📦 Installation
+
+### Quick Install
+
+the `astro add` command-line tool automates the installation for you. Run one of the following commands in a new terminal window. (If you aren’t sure which package manager you’re using, run the first command.) Then, follow the prompts, and type “y” in the terminal (meaning “yes”) for each one.
+
+```bash
+# Using NPM
+npx astro add astro-purgecss
+# Using Yarn
+yarn astro add astro-purgecss
+# Using PNPM
+pnpm astro add astro-purgecss
+```
+
+### Manual Install
+
+First, install the `astro-purgecss` package using your package manager. (If you aren’t sure which package manager you’re using, run the first command.)
+
+```bash
+# Using NPM
+npm install astro-purgecss
+# Using Yarn
+yarn add astro-purgecss
+# Using PNPM
+pnpm install astro-purgecss
+```
+
+Then, apply this integration to your `astro.config.mjs` file using the integrations property:
+
+```js
+import purgecss from 'astro-purgecss';
+
+export default {
+  // ...
+  integrations: [purgecss()]
+};
+```
+
+> **Note**
+>
+> To make sure this integration works properly, it's recommended to put `purgecss()`
+> as the last element in the `integrations` array.
+
+## 🥑 Usage
+
+When you install this integration, things will be auto-wired for you. and all your generated css files should be purged from unused classes automagically.
+
+## What does this integration do, exactly?
+
+This integration hooks into your astro build cycle, more precisely `astro:build:done`, it reads all your generated `HTML` and `CSS` files, and analyzes them using [Purgecss][purgecss] to remove any unsued CSS rules.
+
+## Change log
+
+Please see the [changelog](CHANGELOG.md) for more information on what has changed recently.
+
+## Acknowledgements
+
+- [Purgecss][purgecss]
+
+[npm]: https://npmjs.com/package/astro-purgecss
+[purgecss]: https://purgecss.com
+
+<!-- Readme Badges -->
+
+[version-badge]: https://img.shields.io/npm/v/astro-purgecss.svg
+[downloads-badge]: https://img.shields.io/npm/dt/astro-purgecss
+[github-actions]: https://github.com/codiume/orbit/actions
+[github-actions-badge]: https://github.com/codiume/orbit/actions/workflows/node.js.yml/badge.svg
+[typescript]: https://www.typescriptlang.org/dt/search?search=astro-purgecss
+[typescript-badge]: https://img.shields.io/npm/types/astro-purgecss
+[makepr]: https://makeapullrequest.com
+[makepr-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square?style=flat

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { AstroIntegration } from 'astro';
+export default function (): AstroIntegration;

package/dist/index.mjs

@@ -0,0 +1,23 @@
+import { PurgeCSS } from "purgecss";
+import { writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+function src_default() {
+  return {
+    name: "astro-purgecss",
+    hooks: {
+      "astro:build:done": async ({ dir }) => {
+        const outDir = fileURLToPath(dir);
+        const purged = await new PurgeCSS().purge({
+          content: [`${outDir}/**/*.html`],
+          css: [`${outDir}/**/*.css`]
+        });
+        await Promise.all(
+          purged.filter(({ file }) => file.endsWith(".css")).map(async ({ css, file }) => await writeFile(file, css))
+        );
+      }
+    }
+  };
+}
+export {
+  src_default as default
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "astro-purgecss",
+  "description": "Remove unused CSS rules from your final Astro bundle",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "astro-build --src src/**/*.ts",
+    "postbuild": "npm run typecheck:emit",
+    "typecheck": "tsc --noEmit",
+    "typecheck:emit": "tsc --declaration --emitDeclarationOnly --outDir dist"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "author": "codiume",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codiume/orbit.git",
+    "directory": "packages/astro-purgecss"
+  },
+  "keywords": [
+    "astro",
+    "astro-component",
+    "astro-integration",
+    "css",
+    "optimization"
+  ],
+  "bugs": "https://github.com/codiume/orbit/issues",
+  "homepage": "https://github.com/codiume/orbit",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.mjs",
+  "exports": {
+    ".": "./dist/index.mjs"
+  },
+  "peerDependencies": {
+    "astro": "^1.0.0"
+  },
+  "devDependencies": {
+    "purgecss": "^4.1.3"
+  }
+}