Externalized 3rd-party dependencies

[oleksandr-danylchenko]

Issue

See - #191

⚠ When the text-annotator-react is being bundled, it doesn't exclude the external dependencies from the bundle ⚠

Changes Made

1. Added vite-plugin-externalize-deps plugin that helps to prevent bundling 3rd-party dependencies. Instead, the consumer should provide them for the packages, so the latter can simply import them.
2. Bumped dependencies

Comparison

• @recogito/text-annotator

Before	After

• @recogito/react-text-annotator

Before	After

(Soomo Staged)

[oleksandr-danylchenko]

I believe that this property is redundant here. Unfortunately, the preserveModules: true doesn't preserve the original file structure of the package in the output, but simply splits it into quite a few chunks. To actually preserve it a more complex config is required, for example:

...
rollupOptions: {
	/**
	 * If you want to convert a set of files to another format while maintaining the file structure
	 * and export signatures, the recommended way—instead of using output.preserveModules that
	 * may tree-shake exports as well as emit virtual files created by plugins—is to
	 * turn every file into an entry point.
	 * @see https://rollupjs.org/configuration-options/#input
	 */
	input: Object.fromEntries(
		globSync('src/**/*.{ts,tsx}', {
			ignore: ['src/**/*.d.ts', 'src/**/*.stories.tsx', 'src/storybook/**/*']
		}).map((file) => [
			// 1. The name of the entry point
			// lib/nested/foo.js becomes nested/foo
			relative('src', file.slice(0, file.length - extname(file).length)),
			// 2. The absolute path to the entry file
			// lib/nested/foo.ts becomes /project/lib/nested/foo.ts
			fileURLToPath(new URL(file, import.meta.url))
		])
	),
	...

However, I believe it's an overkill for the package, as it still has only a single entry point. Also having the sourcemaps will help the browser to navigate through the original structure.

[oleksandr-danylchenko]

The globals are needed to bundle the UMD package using predictable names for the external packages. Otherwise, they will be guessed by Vite:

[oleksandr-danylchenko]

I also verified that it doesn't break the existing consumers on our side ✅

[rsimon]

Thanks, I'll give that a try ;-)