sonda 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,82 @@
 # Changelog
 
+## 0.8.0
+
+This is the biggest release of Sonda to date, featuring a complete rewrite of both the backend and frontend. The goals of this rewrite were to:
+
+- Make it easier to inspect large projects with multiple outputs  
+- Display much more information about assets, inputs, external dependencies, and import relationships  
+- Significantly reduce the size of the HTML report files  
+- Prepare the codebase for future improvements and features
+
+### Highlights
+
+- **New HTML report design** – The report has been redesigned to improve navigation and clarity, especially for large projects with multiple outputs. See the [demo page](https://sonda.dev/demo) for an example.
+- **New JSON report format** – The JSON format has been overhauled to better differentiate resource types and expose relationships between them. For details, refer to the [JSON report](https://sonda.dev/features/json-report.html) documentation.
+- **ESM-only** – Sonda is now ESM-only and requires Node.js 20.19 or 22.12+. This change helps reduce the distribution size.
+- **New output directory** – Reports are now saved to the `.sonda` directory and are prefixed with a unique number to avoid overwriting existing reports.
+
+### Migration
+
+If you're upgrading from version 0.7, you'll need to update your import paths and configuration.
+
+#### Import Paths
+
+Each integration now has its own import path. It's recommended to use the path specific to your framework or bundler, as these may include optimizations that improve performance and accuracy.
+
+For example, if you're using Vite or Rolldown, use their dedicated import paths instead of the generic Rollup integration path.
+
+Available import paths:
+
+- `sonda/angular`
+- `sonda/astro`
+- `sonda/esbuild`
+- `sonda/next`
+- `sonda/nuxt`
+- `sonda/rolldown`
+- `sonda/rollup`
+- `sonda/rspack`
+- `sonda/sveltekit`
+- `sonda/vite`
+- `sonda/webpack`
+
+#### Configuration
+
+- The `filename` option has been removed and replaced with `outputDir`, which defaults to `.sonda`. All reports are saved to this directory, and filenames are prefixed with a unique number to prevent overwriting.
+- The `detailed` option has been renamed to `deep`.
+
+#### JSON Report
+
+The JSON report format has been completely redesigned. For complete details, refer to the updated [JSON report](https://sonda.dev/features/json-report.html) documentation.
+
+---
+
+### Major Changes
+
+- 0c0113f: BREAKING CHANGE: Drop support for Node 18 and require at least Node 20.19 or 22.12
+- 0c0113f: BREAKING CHANGE: Distribute only the ESM builds
+- 0c0113f: BREAKING CHANGE: Rename the `detailed` configuration option to `deep`.
+- 0c0113f: BREAKING CHANGE: Reports are now saved to the `.sonda` folder by default. The `filename` configuration option has been replaced with the `outputDir` option. Each new report will end with incremented numbers to avoid overwriting previous reports. For example:
+
+  - `.sonda/sonda_1.html`
+  - `.sonda/sonda_2.html`
+  - `.sonda/sonda_3.html`
+
+- 0c0113f: BREAKING CHANGE: Change format of the JSON report
+- 0c0113f: BREAKING CHANGE: Redesign the HTML report
+
+### Minor Changes
+
+- 0c0113f: Add new `sonda/rolldown`, `sonda/rspack` and `sonda/vite` entrypoints
+- 0c0113f: GZIP data in HTML report to reduce its size
+
+### Patch Changes
+
+- 0c0113f: Run Vite integration only in production build
+- 0c0113f: Fix detection of input files in Next.js integration
+- 0c0113f: Update all dependencies
+- 0c0113f: Don't change paths in sourcemaps generated by webpack and add handling webpack specific path formats
+
 ## 0.7.1
 
 ### Patch Changes
@@ -34,6 +111,8 @@ Sonda now has integrations for the following frameworks:
 
 You can now control whether the Sonda plugin is enabled or not using the `enabled` option.
 
+---
+
 ### Minor Changes
 
 - 215b289: Create an individual export path for each integration

package/README.md

@@ -25,7 +25,3 @@ For installation and usage instructions, visit [https://sonda.dev](https://sonda
 ## Demo
 
 You can try Sonda at [https://sonda.dev/demo](https://sonda.dev/demo).
-
-## Screenshot
-
-![HTML report generated by Sonda with open modal containing file details and tree map diagram in the background](https://raw.githubusercontent.com/filipsobol/sonda/refs/heads/main/docs/public/details.jpg)

package/bin/sonda-angular.js

@@ -8,9 +8,9 @@ const { values } = parseArgs( {
     config: { type: 'string' },
     projects: { type: 'string', multiple: true },
     format: { type: 'string' },
-    filename: { type: 'string' },
+    outputDir: { type: 'string' },
     'no-open': { type: 'boolean' },
-    detailed: { type: 'boolean' },
+    deep: { type: 'boolean' },
     sources: { type: 'boolean' },
     gzip: { type: 'boolean' },
     brotli: { type: 'boolean' }

package/dist/entrypoints/angular.d.ts

@@ -1,7 +1,14 @@
-import type { UserOptions } from '../types';
+import { UserOptions } from "sonda";
+
+//#region src/entrypoints/angular.d.ts
 interface AngularUserOptions extends UserOptions {
-    config: string;
-    projects: string[];
+  config: string;
+  projects: string[];
 }
-export default function SondaAngular(options?: Partial<AngularUserOptions>): void;
-export {};
+declare function SondaAngular({
+  config,
+  projects,
+  ...userOptions
+}: AngularUserOptions): Promise<void>;
+//#endregion
+export { SondaAngular as default };

package/dist/entrypoints/{angular.mjs → angular.js}

@@ -1,27 +1,26 @@
-import "../src.mjs";
-import { processEsbuildMetaFile } from "../esbuild.mjs";
 import { basename, relative, resolve } from "path";
 import { readFileSync, readdirSync } from "fs";
+import { Config, processEsbuildMetafile } from "sonda";
 
 //#region src/entrypoints/angular.ts
-function SondaAngular(options = {}) {
-	const cwd = process.cwd();
-	const { config = "angular.json", projects = [],...opts } = options;
-	opts.format ??= "html";
-	opts.filename ??= `sonda-report-[project].${opts.format}`;
-	if (!opts.filename.includes("[project]")) throw new Error("SondaAngular: The \"filename\" option must include the \"[project]\" token.");
+async function SondaAngular({ config = "angular.json", projects = [],...userOptions }) {
+	const options = new Config(userOptions, {
+		integration: "angular",
+		filename: "sonda_[project]"
+	});
 	const angularConfig = loadJson(config);
 	const projectsToGenerate = projects.length ? projects : Object.keys(angularConfig.projects);
 	for (const project of projectsToGenerate) {
 		const { outputPath } = angularConfig.projects[project].architect.build.options;
 		const paths = typeof outputPath === "object" ? outputPath : { base: outputPath };
-		paths.base = resolve(cwd, paths.base);
+		paths.base = resolve(process.cwd(), paths.base);
 		paths.browser = resolve(paths.base, paths.browser || "browser");
 		paths.server = resolve(paths.base, paths.server || "server");
-		const metafile = updateMetafile(loadJson(resolve(paths.base, "stats.json")), paths);
-		const sondaOptions = Object.assign({}, opts);
+		const metafile = updateMetafile(loadJson(resolve(paths.base, "stats.json")), paths.base);
+		const sondaOptions = options.clone();
 		sondaOptions.filename = sondaOptions.filename.replace("[project]", project);
-		processEsbuildMetaFile(metafile, sondaOptions);
+		sondaOptions.sourcesPathNormalizer = (path) => resolve(process.cwd(), path);
+		await processEsbuildMetafile(metafile, sondaOptions);
 	}
 }
 function loadJson(path) {
@@ -33,15 +32,15 @@ function loadJson(path) {
 * file system it's "dist/project/browser/en/main-xxx.js". This function updates the output paths
 * to include the relative path from the current working directory.
 */
-function updateMetafile(metafile, paths) {
+function updateMetafile(metafile, basePath) {
 	const cwd = process.cwd();
 	const outputs = Object.assign({}, metafile.outputs);
 	metafile.outputs = {};
-	for (const path of readdirSync(paths.base, {
+	for (const path of readdirSync(basePath, {
 		encoding: "utf8",
 		recursive: true
 	})) {
-		const absolutePath = resolve(paths.base, path);
+		const absolutePath = resolve(basePath, path);
 		const filename = basename(absolutePath);
 		const originalOutput = outputs[filename];
 		if (originalOutput) metafile.outputs[relative(cwd, absolutePath)] = originalOutput;
@@ -50,5 +49,4 @@ function updateMetafile(metafile, paths) {
 }
 
 //#endregion
-export { SondaAngular as default };
-//# sourceMappingURL=angular.mjs.map
+export { SondaAngular as default };

package/dist/entrypoints/astro.d.ts

@@ -1,3 +1,7 @@
-import type { AstroIntegration } from 'astro';
-import type { FrameworkUserOptions } from '../types';
-export default function SondaAstroPlugin(options?: Partial<FrameworkUserOptions>): AstroIntegration;
+import { UserOptions } from "sonda";
+import { AstroIntegration } from "astro";
+
+//#region src/entrypoints/astro.d.ts
+declare function SondaAstroPlugin(userOptions?: UserOptions): AstroIntegration;
+//#endregion
+export { SondaAstroPlugin as default };

package/dist/entrypoints/astro.js

@@ -0,0 +1,26 @@
+import { Config, SondaVitePlugin } from "sonda";
+
+//#region src/entrypoints/astro.ts
+function SondaAstroPlugin(userOptions = {}) {
+	const options = new Config(userOptions, {
+		integration: "astro",
+		filename: "sonda_[env]"
+	});
+	if (!options.enabled) return {
+		name: "sonda-astro",
+		hooks: {}
+	};
+	return {
+		name: "sonda-astro",
+		hooks: { "astro:build:setup"({ vite, target }) {
+			if (target === "server" && !options.server) return;
+			const sondaOptions = options.clone();
+			sondaOptions.filename = sondaOptions.filename.replace("[env]", target);
+			vite.plugins ??= [];
+			vite.plugins.push(SondaVitePlugin(sondaOptions));
+		} }
+	};
+}
+
+//#endregion
+export { SondaAstroPlugin as default };

package/dist/entrypoints/esbuild.d.ts

@@ -1,4 +1,2 @@
-import type { Metafile, Plugin } from 'esbuild';
-import type { UserOptions } from '../types.js';
-export default function SondaEsbuildPlugin(options?: Partial<UserOptions>): Plugin;
-export declare function processEsbuildMetaFile(metafile: Metafile, options: Partial<UserOptions>): void;
+import { SondaEsbuildPlugin } from "sonda";
+export { SondaEsbuildPlugin as default };

package/dist/entrypoints/esbuild.js

@@ -0,0 +1,7 @@
+import { SondaEsbuildPlugin } from "sonda";
+
+//#region src/entrypoints/esbuild.ts
+var esbuild_default = SondaEsbuildPlugin;
+
+//#endregion
+export { esbuild_default as default };

package/dist/entrypoints/next.d.ts

@@ -1,3 +1,7 @@
-import type { NextConfig } from 'next';
-import type { FrameworkUserOptions } from '../types.js';
-export default function SondaNextPlugin(options?: Partial<FrameworkUserOptions>): (nextConfig?: NextConfig) => NextConfig;
+import { UserOptions } from "sonda";
+import { NextConfig } from "next";
+
+//#region src/entrypoints/next.d.ts
+declare function SondaNextPlugin(userOptions?: UserOptions): (nextConfig?: NextConfig) => NextConfig;
+//#endregion
+export { SondaNextPlugin as default };

package/dist/entrypoints/next.js

@@ -0,0 +1,23 @@
+import { Config, SondaWebpackPlugin } from "sonda";
+
+//#region src/entrypoints/next.ts
+function SondaNextPlugin(userOptions = {}) {
+	return function Sonda(nextConfig = {}) {
+		const options = new Config(userOptions, {
+			integration: "next",
+			filename: "sonda_[env]"
+		});
+		if (!options.enabled) return nextConfig;
+		return Object.assign({}, nextConfig, { webpack(config, { nextRuntime, isServer }) {
+			const env = nextRuntime || "client";
+			if (env === "edge" || isServer && !options.server) return config;
+			const sondaOptions = options.clone();
+			sondaOptions.filename = sondaOptions.filename.replace("[env]", env);
+			config.plugins.push(new SondaWebpackPlugin(sondaOptions));
+			return config;
+		} });
+	};
+}
+
+//#endregion
+export { SondaNextPlugin as default };

package/dist/entrypoints/nuxt.d.ts

@@ -1,3 +1,7 @@
-import type { NuxtModule } from '@nuxt/schema';
-import type { FrameworkUserOptions } from '../types';
-export default function SondaNuxtPlugin(options?: Partial<FrameworkUserOptions>): NuxtModule;
+import { UserOptions } from "sonda";
+import { NuxtModule } from "@nuxt/schema";
+
+//#region src/entrypoints/nuxt.d.ts
+declare function SondaNuxtPlugin(userOptions?: UserOptions): NuxtModule;
+//#endregion
+export { SondaNuxtPlugin as default };

package/dist/entrypoints/nuxt.js

@@ -0,0 +1,23 @@
+import { Config, SondaVitePlugin } from "sonda";
+
+//#region src/entrypoints/nuxt.ts
+function SondaNuxtPlugin(userOptions = {}) {
+	return function SondaNuxtPlugin$1(_, nuxt) {
+		const options = new Config(userOptions, {
+			integration: "nuxt",
+			filename: "sonda_[env]"
+		});
+		if (!options.enabled) return;
+		nuxt.hook("vite:extendConfig", (config, { isClient, isServer }) => {
+			const env = isClient ? "client" : "nitro";
+			if (isServer && !options.server) return;
+			const sondaOptions = options.clone();
+			sondaOptions.filename = sondaOptions.filename.replace("[env]", env);
+			config.plugins ??= [];
+			config.plugins.push(SondaVitePlugin(sondaOptions));
+		});
+	};
+}
+
+//#endregion
+export { SondaNuxtPlugin as default };

package/dist/entrypoints/rolldown.d.ts

@@ -0,0 +1,7 @@
+import { UserOptions } from "sonda";
+import { Plugin } from "rolldown";
+
+//#region src/entrypoints/rolldown.d.ts
+declare function RolldownPlugin(userOptions?: UserOptions): Plugin;
+//#endregion
+export { RolldownPlugin as default };

package/dist/entrypoints/rolldown.js

@@ -0,0 +1,14 @@
+import { Config, SondaRollupPlugin } from "sonda";
+
+//#region src/entrypoints/rolldown.ts
+function RolldownPlugin(userOptions = {}) {
+	const options = new Config(userOptions, { integration: "rolldown" });
+	if (!options.enabled) return { name: "sonda-rolldown" };
+	return {
+		...SondaRollupPlugin(options),
+		name: "sonda-rolldown"
+	};
+}
+
+//#endregion
+export { RolldownPlugin as default };

package/dist/entrypoints/rollup.d.ts

@@ -1,3 +1,2 @@
-import { type UserOptions } from '../index.js';
-import type { Plugin } from 'rollup';
-export default function SondaRollupPlugin(options?: Partial<UserOptions>): Plugin;
+import { SondaRollupPlugin } from "sonda";
+export { SondaRollupPlugin as default };

package/dist/entrypoints/rollup.js

@@ -0,0 +1,7 @@
+import { SondaRollupPlugin } from "sonda";
+
+//#region src/entrypoints/rollup.ts
+var rollup_default = SondaRollupPlugin;
+
+//#endregion
+export { rollup_default as default };

package/dist/entrypoints/rspack.d.ts

@@ -0,0 +1,8 @@
+import { SondaWebpackPlugin, UserOptions } from "sonda";
+
+//#region src/entrypoints/rspack.d.ts
+declare class SondaRspackPlugin extends SondaWebpackPlugin {
+  constructor(userOptions?: UserOptions);
+}
+//#endregion
+export { SondaRspackPlugin as default };

package/dist/entrypoints/rspack.js

@@ -0,0 +1,12 @@
+import { Config, SondaWebpackPlugin } from "sonda";
+
+//#region src/entrypoints/rspack.ts
+var SondaRspackPlugin = class extends SondaWebpackPlugin {
+	constructor(userOptions = {}) {
+		super(userOptions);
+		this.options = new Config(userOptions, { integration: "rspack" });
+	}
+};
+
+//#endregion
+export { SondaRspackPlugin as default };

package/dist/entrypoints/sveltekit.d.ts

@@ -1,3 +1,7 @@
-import type { PluginOption } from 'vite';
-import type { FrameworkUserOptions } from '../types';
-export default function SondaSvelteKitPlugin(options?: Partial<FrameworkUserOptions>): PluginOption;
+import { UserOptions } from "sonda";
+import { PluginOption } from "vite";
+
+//#region src/entrypoints/sveltekit.d.ts
+declare function SondaSvelteKitPlugin(userOptions?: UserOptions): PluginOption;
+//#endregion
+export { SondaSvelteKitPlugin as default };

package/dist/entrypoints/sveltekit.js

@@ -0,0 +1,23 @@
+import { Config, SondaVitePlugin } from "sonda";
+
+//#region src/entrypoints/sveltekit.ts
+function SondaSvelteKitPlugin(userOptions = {}) {
+	const options = new Config(userOptions, {
+		integration: "sveltekit",
+		filename: "sonda_[env]"
+	});
+	if (!options.enabled) return { name: "sonda-sveltekit" };
+	return {
+		...SondaVitePlugin(options),
+		name: "sonda-sveltekit",
+		configResolved(config) {
+			const env = config.build.ssr ? "server" : "client";
+			const generateForServer = userOptions.server ?? false;
+			if (env === "server" && !generateForServer) userOptions.enabled = false;
+			options.filename = options.filename.replace("[env]", env);
+		}
+	};
+}
+
+//#endregion
+export { SondaSvelteKitPlugin as default };

package/dist/entrypoints/vite.d.ts

@@ -0,0 +1,2 @@
+import { SondaVitePlugin } from "sonda";
+export { SondaVitePlugin as default };

package/dist/entrypoints/vite.js

@@ -0,0 +1,7 @@
+import { SondaVitePlugin } from "sonda";
+
+//#region src/entrypoints/vite.ts
+var vite_default = SondaVitePlugin;
+
+//#endregion
+export { vite_default as default };

package/dist/entrypoints/webpack.d.ts

@@ -1,7 +1,2 @@
-import { type UserOptions } from '../index.js';
-import type { Compiler } from 'webpack';
-export default class SondaWebpackPlugin {
-    options: Partial<UserOptions>;
-    constructor(options?: Partial<UserOptions>);
-    apply(compiler: Compiler): void;
-}
+import { SondaWebpackPlugin } from "sonda";
+export { SondaWebpackPlugin as default };

package/dist/entrypoints/webpack.js

@@ -0,0 +1,7 @@
+import { SondaWebpackPlugin } from "sonda";
+
+//#region src/entrypoints/webpack.ts
+var webpack_default = SondaWebpackPlugin;
+
+//#endregion
+export { webpack_default as default };