sonda 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.9.0
+
+### Minor Changes
+
+- 87d59f9: Add `include` and `exclude` options
+
 ## 0.8.2
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # Sonda
 
-Sonda is a universal visualizer and analyzer for JavaScript and CSS bundles. It generates an interactive HTML report that is more accurate and detailed than some alternatives. The accuracy is achieved by analyzing source maps and showing the size of each module after tree-shaking and minification.
+Sonda is a universal bundle analyzer and visualizer. It generates an interactive HTML report that is more accurate and detailed than some alternatives. The accuracy is achieved by analyzing source maps and showing the size of each module after tree-shaking and minification.
 
 Sonda works with the following tools:
 

package/dist/index.d.ts

@@ -11,6 +11,8 @@ declare class Config implements Required<IntegrationOptions> {
   constructor(options: Partial<IntegrationOptions> | Config, defaults: IntegrationOptions);
   clone(): Config;
   get enabled(): boolean;
+  get include(): AssetFilter;
+  get exclude(): AssetFilter;
   get format(): Format;
   get filename(): string;
   get outputDir(): string;
@@ -33,15 +35,40 @@ interface UserOptions {
   */
   enabled?: boolean;
   /**
-  * Specifies the output format of the report.
+  * Specifies a list of RegExp patterns used to match output assets to include in the report.
+  * By default, all assets are included.
+  *
+  * Patterns are matched against the relative asset paths as displayed in the report. For example,
+  * to include only JavaScript files, use `[ /\.js$/ ]`.
+  *
+  * @default null
+  */
+  include?: AssetFilter;
+  /**
+  * Specifies a list of RegExp patterns used to match output assets to exclude from the report.
+  * By default, no assets are excluded, except for those with `.map` and `.d.ts` extensions, which
+  * are always excluded regardless of this setting.
+  *
+  * This option takes precedence over `include`.
+  *
+  * Patterns are matched against the relative asset paths as shown in the report. For example, to exclude all CSS files, use `[ /\.css$/ ]`.
+  *
+  * @default null
+  */
+  exclude?: AssetFilter;
+  /**
+  * Specifies the output format of the report. Supported formats include:
+  *
+  * - `'html'` - An HTML file with a treemap visualization.
+  * - `'json'` - A JSON file.
   *
   * @default 'html'
   */
   format?: Format;
   /**
   * Specifies the filename of the generated report. If this value is an absolute path,
-  * it will override the `outputDir` option.
-  * 
+  * it overrides the `outputDir` option.
+  *
   * The default value includes placeholders like `[index]` and `[env]`, which are replaced
   * during report generation.
   *
@@ -58,7 +85,10 @@ interface UserOptions {
   */
   filename?: string;
   /**
-  * Specifies the name of the directory where the report will be saved.
+  * Specifies the directory where the report will be saved. This can be a relative or absolute path. By default,
+  * the report is saved in a `.sonda` directory relative to the current working directory.
+  *
+  * The directory is created if it does not exist.
   *
   * @default '.sonda'
   */
@@ -72,47 +102,47 @@ interface UserOptions {
   */
   open?: boolean;
   /**
-  * Specifies whether to read the source maps of imported modules.
+  * Specifies whether to read source maps of imported modules.
   *
-  * By default, external dependencies bundled into a single file appear as a single
-  * asset in the report. When this option is enabled, the report includes the source
-  * files of imported modules, if source maps are available.
+  * By default, external dependencies bundled into a single file appear as a single asset. When this option
+  * is enabled, the report includes the source files of imported modules, if their source maps are available.
   *
-  * Enabling this option may increase the time needed to generate the report and reduce
-  * the accuracy of estimated GZIP and Brotli sizes for individual files.
+  * Enabling this option may increase report generation time and reduce the accuracy of estimated GZIP
+  * and Brotli sizes.
   *
   * @default false
   */
   deep?: boolean;
   /**
-  * Specifies whether to include source maps of the assets in the report to visualize
-  * which parts of the code contribute to the final asset size.
+  * Specifies whether to include source maps of generated assets in the report to visualize which parts of
+  * the code contribute to the final asset size.
   *
-  * ⚠️ This option significantly increases the size of the report and embeds the
-  * **source code** of the assets. If you are working with proprietary code, ensure
-  * you share the report responsibly. ⚠️
+  * ⚠️
+  * This option significantly increases the report size and embeds the **source code** of the assets.
+  * If you are working with proprietary code, ensure you share the report responsibly.
+  * ⚠️
   *
   * @default false
   */
   sources?: boolean;
   /**
-  * Specifies whether to calculate the sizes of assets after compression with GZIP.
+  * Specifies whether to calculate asset sizes after compression with GZIP.
   *
-  * The report includes estimated compressed sizes for each file within an asset.
-  * However, these estimates are approximate and should be used as a general reference.
+  * The report also includes estimated compressed sizes for each file within an asset. These estimates are
+  * approximate and intended for general reference.
   *
-  * Enabling this option may increase the time required to generate the report.
+  * Enabling this option may increase report generation time.
   *
   * @default false
   */
   gzip?: boolean;
   /**
-  * Specifies whether to calculate the sizes of assets after compression with Brotli.
+  * Specifies whether to calculate asset sizes after compression with Brotli.
   *
-  * The report includes estimated compressed sizes for each file within an asset.
-  * However, these estimates are approximate and should be used as a general reference.
+  * The report also includes estimated compressed sizes for each file within an asset. These estimates are
+  * approximate and intended for general reference.
   *
-  * Enabling this option may increase the time required to generate the report.
+  * Enabling this option may increase report generation time.
   *
   * @default false
   */
@@ -138,6 +168,10 @@ interface IntegrationOptions extends UserOptions {
   */
   sourcesPathNormalizer?: SourcesPathNormalizer;
 }
+/**
+* Filter for including or excluding assets based on their paths.
+*/
+type AssetFilter = Array<RegExp> | null;
 type Format = "html" | "json";
 type Integration = "angular" | "astro" | "esbuild" | "next" | "nuxt" | "rolldown" | "rollup" | "rspack" | "sveltekit" | "vite" | "webpack" | "unknown";
 //#endregion

package/dist/index.js

@@ -17,6 +17,8 @@ var Config = class Config {
 		}
 		this.#options = Object.assign({
 			enabled: true,
+			include: null,
+			exclude: null,
 			format: "html",
 			filename: "sonda_[index]",
 			outputDir: ".sonda",
@@ -35,6 +37,12 @@ var Config = class Config {
 	get enabled() {
 		return this.#options.enabled;
 	}
+	get include() {
+		return this.#options.include;
+	}
+	get exclude() {
+		return this.#options.exclude;
+	}
 	get format() {
 		return this.#options.format;
 	}
@@ -164,7 +172,7 @@ function hasIgnoredExtension(name) {
 
 //#endregion
 //#region package.json
-var version = "0.8.2";
+var version = "0.9.0";
 
 //#endregion
 //#region src/report/formatters/Formatter.ts
@@ -203,7 +211,7 @@ var Formatter = class {
 	async replaceIndex(path) {
 		if (!path.includes("[index]")) return path;
 		const { dir, base } = parse(path);
-		const regex = new RegExp("^" + base.replace("[index]", "(\\d+)") + "$");
+		const regex = /* @__PURE__ */ new RegExp("^" + base.replace("[index]", "(\\d+)") + "$");
 		const versions = (await getAllFiles(dir)).map((path$1) => basename(path$1).match(regex)).filter((match) => match !== null).map((match) => parseInt(match[1], 10));
 		const maxVersion = Math.max(...versions, -1);
 		const version$1 = String(maxVersion + 1);
@@ -607,6 +615,9 @@ var Report = class {
 	}
 	addAsset(name, entrypoints) {
 		if (hasIgnoredExtension(name)) return;
+		const normalizedName = normalizePath(name);
+		if (this.config.exclude?.some((pattern) => pattern.test(normalizedName))) return;
+		if (this.config.include && !this.config.include.some((pattern) => pattern.test(normalizedName))) return;
 		this.assets[name] = entrypoints;
 	}
 	async generate() {
@@ -784,7 +795,7 @@ var SondaWebpackPlugin = class {
 		* - (?:${ namespace })? - Non-capturing group that matches the optional namespace
 		* - ([^?]*) - Matches the path, which is everything up to the first "?" (if present)
 		*/
-		const sourceMapFilenameRegex = new RegExp(`(?:webpack://)?(?:${namespace})?([^?]*)`);
+		const sourceMapFilenameRegex = /* @__PURE__ */ new RegExp(`(?:webpack://)?(?:${namespace})?([^?]*)`);
 		compiler.hooks.afterEmit.tapPromise("SondaWebpackPlugin", async (compilation) => {
 			for (const mod of compilation.modules) {
 				const name = mod.nameForCondition();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sonda",
-  "version": "0.8.2",
-  "description": "Universal visualizer and analyzer for JavaScript and CSS bundles. Works with most popular bundlers and frameworks.",
+  "version": "0.9.0",
+  "description": "Universal bundle analyzer and visualizer that works with most popular bundlers and frameworks.",
   "keywords": [
     "bundle",
     "visualizer",