npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

astro-rollup

v0.0.3

Published

AstroJS utility to resolve ES6 import/export for client side JavaScript

Downloads

157

Readme

astro-rollup

This [Astro integration][astro-integration] resolves imports/exports ES6 and above for your JavaScript code inside distribution folder.

Note

astro-rollup will not process your requests, only your statically generated build and pre-rendered routes.

Installation

There are two ways to add integrations to your project. Let's try the most convenient option first!

astro add command

Astro includes a CLI tool for adding first party integrations: astro add. This command will:

  1. (Optionally) Install all necessary dependencies and peer dependencies
  2. (Also optionally) Update your astro.config.* file to apply this integration

To install astro-rollup, run the following from your project directory and follow the prompts:

# Using NPM
npx astro add astro-rollup
# Using Yarn
yarn astro add astro-rollup
# Using PNPM
pnpx astro add astro-rollup

Install dependencies manually

First, install the astro-rollup integration like so:

npm install -D -E astro-rollup

Then, apply this integration to your astro.config.* file using the integrations property:

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [rollup()],
	// ...
});

Getting started

The utility will now automatically process all your JavaScript files in the dist folder.

If your path is different than dist be sure to update it accordingly:

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	outDir: "./build",
	integrations: [
		rollup({
			path: "./build",
		}),
	],
	// ...
});

You can add multiple paths to compress by specifying an array as the path variable.

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			path: ["./build", "./dist"],
		}),
	],
	// ...
});

You can also provide a map of paths for different input output directories.

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			path: new Map([["./input", "./output"]]),
		}),
	],
	// ...
});

Or an array of the two.

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			path: [
				// compress dist
				"./dist",
				// compress dist one more time into a different directory
				new Map([["./dist", "./dist-compressed"]]),
			],
		}),
	],
	// ...
});

You can provide a filter to exclude files in your build. A filter can be an array of regexes or a single match. You can use functions, as well to match on file names.

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			exclude: [
				"my-awesome.png",
				(file: string) =>
					file === "./dist/img/favicon/safari-pinned-tab.svg",
			],
		}),
	],
	// ...
});

This ultility does support terser, but disabled by default. You can enable it using:

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			useTerser: true,
			terserOptions: {
				// pass options to terser
			}
		}),
	],
	// ...
});

Set logger to 0 if you do not want to see debug messages. Default is 2.

astro.config.mjs

// ...
import rollup from "astro-rollup";
// ...

export default defineConfig({
	integrations: [
		rollup({
			logger: 0,
		}),
	],
	// ...
});

Changelog

See CHANGELOG.md for a history of changes to this integration.

Lightrix logo