@public-ui/visual-tests 1.7.0-rc.8 → 1.7.0-rc.9

package/README.md

@@ -1,168 +1,47 @@
-# KoliBri - CLI-Tools
+# KoliBri - Visual Tests
 
 ## Motivation
 
-The `KoliBri` CLI-Tools are a collection of tools to support the development with `KoliBri` components.
+The `KoliBri` Visual Tests provide a way to add visual regression testing to **theme** modules.  
+It takes screenshots of every component defined in the [React Sample App](https://github.com/public-ui/kolibri/tree/develop/packages/samples/react) with the theme applied and compares them to their references.
 
 ## Installation
 
-You can install the `KoliBri` CLI-Tools with `npm`, `pnpm` or `yarn`.
+You can install the `KoliBri` Visual Tests with `npm`, `pnpm` or `yarn`:
 
 ```bash
-npm i -g @public-ui/kolibri-cli
-pnpm i -g @public-ui/kolibri-cli
-yarn add -g @public-ui/kolibri-cli
+npm i -D @public-ui/visual-tests
+pnpm i -D @public-ui/visual-tests
+yarn add -D @public-ui/visual-tests
 ```
 
 ## Usage
 
-The `KoliBri` CLI is intended to be executed in your project root directory. Use the `kolibri` command to start the CLI.
+Add the following npm scripts to the theme's `package.json`:
 
-```bash
-kolibri --help
-```
-
-```bash
-,--. ,--.         ,--. ,--. ,-----.           ,--.
-|  .'   /  ,---.  |  | `--' |  |) /_  ,--.--. `--'
-|  .   '  | .-. | |  | ,--. |  .-.  \ |  .--' ,--.
-|  |\   \ | '-' | |  | |  | |  '--' / |  |    |  |
-`--' `--´  `---´  `--' `--' `------´  `--'    `--'
-🚹 The accessible HTML-Standard | 👉 https://public-ui.github.io
-
-Usage: kolibri [options] [command]
-
-CLI for executing some helpful commands for KoliBri projects.
-
-Options:
-  -V, --version               output the version number
-  -h, --help                  display help for command
-
-Commands:
-  migrate [options] <string>  This command migrates KoliBri code to the current version.
-  help [command]              display help for command
-```
-
-### Migrate
-
-With the `migrate` command you can migrate your project to the latest version of `KoliBri`.
-
-Actually the following migrations are available:
-
-- Component renaming ✓
-- Component removal ⏰
-- Property renaming ✓
-- Property removal ✓
-- Property type change ⏰
-- Logic refactoring ⏰
-- Expert-Slot refactoring ⏰
-- `.vscode/settings.json` add IntelliSense for HTML ⏰
-- `.gitignore` exclude `.kolibri.migrate.json` ⏰
-- `.tsconfig` add `@public-ui/components` to `types` array ⏰
-
-#### How does it work?
-
-1. The migration command will check your project for clear `git history` and the `installed version` of `KoliBri`. Now it loads all available migration tasks.
-2. Tasks in the correct version range will be executed one by one. Otherwise they will be skipped.
-3. After that the `package.json` will be updated with the new version of `KoliBri` and execute the `npm install` command.
-4. If there are any pending tasks, the migration command will be executed again. Otherwise the migration is finished.
-5. Now you can check the result and commit the changes.
-
-> **Note:** You can reset the migration with `git reset --hard HEAD~1` or by discarding the affected files.
-
-#### Help
-
-```bash
-kolibri migrate --help
-```
-
-#### Execute
-
-```bash
-kolibri migrate <path>
+```json
+{
+	"scripts": {
+		"test": "THEME_MODULE=src/index THEME_EXPORT=THEME_NAME kolibri-visual-test",
+		"test-update": "THEME_MODULE=src/index THEME_EXPORT=THEME_NAME kolibri-visual-test --update-snapshots"
+	}
+}
 ```
 
-#### Options
+- `THEME_MODULE` defines the relative path to the TypeScript module containing the the theme definitions. Without file extension.
+- `THEME_EXPERT` defines the name of the export within the the module. (e.g., `export const THEME_NAME = {/**/};`) Defaults to `default`.
 
-| Option                         | Description                               |         Type         | Default  |
-| ------------------------------ | ----------------------------------------- | :------------------: | :------: |
-| `--ignore-uncommitted-changes` | Allows execution with uncommitted changes |       boolean        |  false   |
-| `--remove-mode`                | Prefix property name or delete property   | `delete` \| `prefix` | `prefix` |
+Run the tests with `npm test`. The first time, this will create a new folder `snapshots` which is supposed to be committed to the repository.
+In the following runs, new screenshots will be compared to this reference.
 
-#### Configuration
+To update the reference screenshots call `npm run test-update`.
 
-You can configure the migration with the `.kolibri.config.json` file in your project root folder. This file will be created automatically after the first migration.
-
-**Troubleshooting:** If you have problems with migration, you can exclude some tasks with the configuration by setting the `false` flag (see `kol-select`).
+It's also recommended to automatically run the tests before packing/publishing the module:
 
 ```json
 {
-	"migrate": {
-		"tasks": {
-			"kol-abbr-rename-property-_title-to-_label": true,
-			"kol-accordion-rename-property-_heading-to-_label": true,
-			"kol-badge-rename-property-_icon-only-to-_hide-label": true,
-			"kol-badge-remove-property-_hide-label": true,
-			"kol-badge-remove-property-_icon-only": true,
-			"kol-breadcrumb-rename-property-_aria-label-to-_label": true,
-			"kol-button-link-remove-property-_aria-current": true,
-			"kol-button-link-remove-property-_aria-label": true,
-			"kol-button-link-rename-property-_icon-only-to-_hide-label": true,
-			"kol-button-remove-property-_aria-current": true,
-			"kol-button-remove-property-_aria-label": true,
-			"kol-button-rename-property-_icon-only-to-_hide-label": true,
-			"kol-card-rename-property-_heading-to-_label": true,
-			"kol-card-rename-property-_headline-to-_label": true,
-			"kol-details-rename-property-_summary-to-_label": true,
-			"kol-icon-remove-property-_part": true,
-			"kol-icon-rename-property-_aria-label-to-_label": true,
-			"kol-checkbox-rename-property-_type-to-_variant": true,
-			"kol-color-rename-property-_list-to-_suggestions": true,
-			"kol-date-rename-property-_list-to-_suggestions": true,
-			"kol-input-email-rename-property-_list-to-_suggestions": true,
-			"kol-input-number-rename-property-_list-to-_suggestions": true,
-			"kol-input-radio-rename-property-_list-to-_options": true,
-			"kol-input-range-rename-property-_list-to-_suggestions": true,
-			"kol-input-text-rename-property-_list-to-_suggestions": true,
-			"kol-link-group-rename-property-_aria-label-to-_label": true,
-			"kol-link-group-remove-property-_ordered": true,
-			"kol-nav-rename-property-_aria-label-to-_label": true,
-			"kol-nav-rename-property-_compact-to-_hide-label": true,
-			"kol-nav-remove-property-_has-compact-button": true,
-			"kol-pagination-rename-property-_count-to-_total": true,
-			"kol-progress-rename-property-_type-to-_variant": true,
-			"kol-quote-rename-property-_caption-to-_label": true,
-			"kol-select-rename-property-_height-to-_rows": false,
-			"kol-select-rename-property-_list-to-_options": false,
-			"kol-skip-nav-rename-property-_aria-label-to-_label": true,
-			"kol-span-rename-property-_icon-only-to-_hide-label": true,
-			"kol-split-button-remove-property-_aria-label": true,
-			"kol-table-rename-property-_caption-to-_label": true,
-			"kol-tabs-rename-property-_aria-label-to-_label": true,
-			"kol-tabs-rename-property-_tab-align-to-_align": true,
-			"kol-toast-rename-property-_heading-to-_label": true,
-			"kol-version-rename-property-_version-to-_label": true
-		}
+	"scripts": {
+		"prepack": "npm test"
 	}
 }
 ```
-
-## Troubleshooting
-
-If the migration failed, you can reset the migration with `git reset --hard HEAD~1`.
-
-Use the configuration (`.kolibri.config.json`) to exclude some tasks.
-
-If there are multiple obsolete properties that have been migrated to just one new property, the new property may appear multiple times in the tag. You can then decide which variant to use and remove all other variants accordingly.
-
-Maybe it can help to prepare your code in the tricky places for migration.
-
-Please give us feedback, if you have problems with the migration: [GitHub Issues](https://github.com/public-ui/kolibri/issues/new?assignees=&labels=useful+hint&projects=&template=7_feedback.md&title=%F0%9F%92%A1+CLI%3A+)
-
-## Dry run
-
-You have always the possibility of a dry run. Because before the migration will be executed, you need a clean git history of you project.
-
-After the migration you can check the result with `git status` and `git diff`.
-
-Is anything wrong, you can reset the migration with `git reset --hard HEAD~1` or by discarding the affected files.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@public-ui/visual-tests",
-	"version": "1.7.0-rc.8",
+	"version": "1.7.0-rc.9",
 	"license": "EUPL-1.2",
 	"homepage": "https://public-ui.github.io",
 	"repository": "https://github.com/public-ui/kolibri",
@@ -26,7 +26,7 @@
 	},
 	"dependencies": {
 		"@playwright/test": "1.37.1",
-		"@public-ui/sample-react": "1.7.0-rc.8",
+		"@public-ui/sample-react": "1.7.0-rc.9",
 		"http-server": "14.1.1",
 		"portfinder": "1.0.32"
 	},

package/playwright.config.js

@@ -0,0 +1,59 @@
+import { defineConfig, devices } from '@playwright/test';
+import * as path from 'path';
+import * as process from 'process';
+
+const PORT = Number(process.env.KOLIBRI_VISUAL_TEST_PORT);
+const URL = `http://127.0.0.1:${PORT}`;
+
+console.log('Serving React Sample app:', URL);
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+	testDir: './tests',
+	snapshotDir: path.join(process.env.KOLIBRI_CWD, 'snapshots'),
+	// snapshotPathTemplate: '',
+	outputDir: path.join(process.env.KOLIBRI_CWD, 'test-results'),
+	/* Run tests in files in parallel */
+	fullyParallel: true,
+	/* Fail the build on CI if you accidentally left test.only in the source code. */
+	forbidOnly: !!process.env.CI,
+	/* Retry on CI only */
+	retries: 0, // process.env.CI ? 2 : 0,
+	/* Opt out of parallel tests on CI. */
+	workers: process.env.CI ? 1 : undefined,
+	/* Reporter to use. See https://playwright.dev/docs/test-reporters */
+	reporter: 'line',
+	/* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+	use: {
+		/* Base URL to use in actions like `await page.goto('/')`. */
+		baseURL: URL,
+
+		/* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+		trace: 'on-first-retry',
+	},
+
+	/* Configure projects for major browsers */
+	projects: [
+		// {
+		// 	name: 'chrome',
+		// 	use: { ...devices['Desktop Chrome'] },
+		// },
+		// {
+		// 	name: 'edge',
+		// 	use: { ...devices['Desktop Edge'] },
+		// },
+		{
+			name: 'firefox',
+			use: { ...devices['Desktop Firefox'] },
+		},
+	],
+
+	/* Run your local dev server before starting the tests */
+	webServer: {
+		command: `http-server ${process.env.KOLIBRI_VISUAL_TESTS_BUILD_PATH} -p ${PORT}`,
+		url: URL,
+		reuseExistingServer: false,
+	},
+});

package/src/index.js

@@ -0,0 +1,53 @@
+import child_process from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'url';
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import portfinder from 'portfinder';
+import * as process from 'process';
+
+process.env.KOLIBRI_CWD = process.cwd();
+const tempDir = process.env.RUNNER_TEMP || process.env.TMPDIR; // TODO: Check on Windows
+
+if (!process.env.THEME_MODULE) {
+	throw new Error('Environment variable THEME_MODULE not specified.');
+}
+if (!tempDir) {
+	throw new Error('Neither environment variable RUNNER_TEMP or TMPDIR specified.');
+}
+
+process.env.THEME_MODULE = path.join(process.cwd(), process.env.THEME_MODULE); // Use current working directory (i.e. the theme folder) to complete module path
+const visualsTestModulePath = fileURLToPath(new URL('..', import.meta.url));
+const binaryPath = fileURLToPath(new URL('../node_modules/.bin', import.meta.url));
+const buildPath = path.join(tempDir, `kolibri-visual-testing-build-${crypto.randomUUID()}`);
+process.env.KOLIBRI_VISUAL_TESTS_BUILD_PATH = buildPath;
+
+console.log('Building React Sample App …');
+child_process.execFileSync(path.join(binaryPath, 'kolibri-sample-react-test-build'), [buildPath], {
+	encoding: 'utf-8',
+});
+
+console.log(`React Sample App build finished. Directory:`, buildPath);
+
+void (async () => {
+	process.env.KOLIBRI_VISUAL_TEST_PORT = String(await portfinder.getPortPromise());
+
+	const playwright = child_process.spawn(path.join(binaryPath, 'playwright'), ['test', ...process.argv.slice(2)], {
+		cwd: visualsTestModulePath,
+	});
+
+	playwright.stdout.on('data', (data) => {
+		console.log('Playwright: ' + data.toString());
+	});
+
+	playwright.stderr.on('data', (data) => {
+		console.log('Playwright stderr: ' + data.toString());
+	});
+
+	playwright.on('exit', (code) => {
+		console.log(`Playwright test finished with exit code ${code}.`);
+		console.log('Cleaning up build folder …');
+		fs.rmSync(buildPath, { recursive: true, force: true });
+		process.exit(code ?? 1);
+	});
+})();

package/tests/sample-app.routes.js

@@ -0,0 +1,80 @@
+export const ROUTES = [
+	'/handout/basic',
+	'/abbr/basic',
+	'/accordion/basic',
+	'/accordion/header',
+	'/accordion/headlines',
+	'/accordion/list',
+	'/alert/basic',
+	'/alert/card-msg',
+	'/alert/html',
+	'/avatar/basic',
+	'/badge/basic',
+	'/badge/button',
+	'/breadcrumb/basic',
+	'/button/basic',
+	'/button/hide-label',
+	'/button/icons',
+	'/button/width',
+	'/button-link/basic',
+	'/button-link/icons',
+	'/button-link/image',
+	'/button-link/target',
+	'/button-group/basic',
+	'/card/basic',
+	'/card/confirm',
+	'/card/flex',
+	'/card/selection',
+	'/details/basic',
+	'/heading/badge',
+	'/heading/basic',
+	'/heading/paragraph',
+	'/icon/basic',
+	'/indented-text/basic',
+	'/input-checkbox/basic',
+	'/input-color/basic',
+	'/input-date/basic',
+	'/input-email/basic',
+	'/input-file/basic',
+	'/input-number/basic',
+	'/input-password/basic',
+	'/input-password/show-password',
+	'/input-radio/basic',
+	'/input-radio/horizontal',
+	'/input-radio/select',
+	'/input-range/basic',
+	'/input-text/basic',
+	'/input-text/hidden-label',
+	'/input-text/blur',
+	'/input-text/focus',
+	'/link/basic',
+	'/link/icons',
+	'/link/image',
+	'/link/target',
+	'/link-button/basic',
+	'/nav/basic',
+	'/nav/active',
+	'/nav/aria-current',
+	'/nav/horizontal',
+	'/pagination/basic',
+	'/popover/basic',
+	'/progress/basic',
+	'/select/basic',
+	'/skip-nav/basic',
+	'/spin/basic',
+	'/spin/cycle',
+	'/spin/custom',
+	'/split-button/basic',
+	'/table/badge-size',
+	'/table/render-cell',
+	'/table/sort-data',
+	'/textarea/basic',
+	'/textarea/adjust-height',
+	'/textarea/disabled',
+	'/textarea/placeholder',
+	'/textarea/readonly',
+	'/textarea/resize',
+	'/textarea/rows',
+	'/version/basic',
+	'/version/context',
+];

package/tests/theme-snapshots.spec.js

@@ -0,0 +1,47 @@
+import { test, expect } from '@playwright/test';
+import { ROUTES } from './sample-app.routes.js';
+
+// https://github.com/microsoft/playwright/issues/7575#issuecomment-1288164474
+export const configureSnapshotPath =
+	() =>
+	({}, testInfo) => {
+		const originalSnapshotPath = testInfo.snapshotPath;
+		testInfo.snapshotPath = (snapshotName) => {
+			const result = originalSnapshotPath
+				.apply(testInfo, [snapshotName])
+
+				// Remove browser name from snapshot name
+				// .replace('-chromium', '')
+				// .replace('-firefox', '')
+
+				// Remove os name from snapshot name
+				.replace('-darwin', '')
+				.replace('-linux', '')
+				.replace('-windows', '')
+
+				// Remove test counter from snapshot name
+				.replace('-1-', '-');
+			return result;
+		};
+	};
+
+test.beforeEach(configureSnapshotPath());
+
+/**
+ * @todo stabilize and re-enable test
+ */
+const blocklist = [];
+
+ROUTES.filter((route) => !blocklist.includes(route)).forEach((route) => {
+	test(`snapshot for ${route}`, async ({ page }) => {
+		await page.goto(`/#${route}?hideMenus`, { waitUntil: 'networkidle' });
+		await page.setViewportSize({
+			width: 1920,
+			height: 1280,
+		});
+		await expect(page).toHaveScreenshot({
+			// fullPage: true,
+			maxDiffPixelRatio: 0.03,
+		});
+	});
+});

package/src/index.ts

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-
-import { Command } from 'commander';
-import gradient from 'gradient-string';
-
-import migrate from './migrate';
-import { getVersionOfPublicUiKoliBriCli } from './migrate/shares/reuse';
-
-const versionOfPublicUiKoliBriCli = getVersionOfPublicUiKoliBriCli();
-
-const banner = gradient.atlas.multiline(
-	`
-,--. ,--.         ,--. ,--. ,-----.           ,--.
-|  .'   /  ,---.  |  | \`--' |  |) /_  ,--.--. \`--'
-|  .   '  | .-. | |  | ,--. |  .-.  \\ |  .--' ,--.
-|  |\\   \\ | '-' | |  | |  | |  '--' / |  |    |  |
-\`--' \`--´  \`---´  \`--' \`--' \`------´  \`--'    \`--'
-🚹 The accessible HTML-Standard | 👉 https://public-ui.github.io | ${versionOfPublicUiKoliBriCli}
-`,
-	{
-		interpolation: 'hsv',
-	},
-);
-console.log(banner);
-
-const program = new Command();
-
-program.name('kolibri').description('CLI for executing some helpful commands for KoliBri projects.').version(versionOfPublicUiKoliBriCli);
-
-// Add commands
-migrate(program);
-
-program.parse();

package/src/migrate/index.ts

@@ -1,127 +0,0 @@
-import { exec } from 'child_process';
-import { Command, Option } from 'commander';
-import fs from 'fs';
-import path from 'path';
-
-import { Configuration } from '../types';
-import { TaskRunner } from './runner/task-runner';
-import { testTasks } from './runner/tasks/test';
-import { v1Tasks } from './runner/tasks/v1';
-import {
-	getContentOfProjectPkgJson,
-	getPackageManagerInstallCommand,
-	getVersionOfPublicUiComponents,
-	getVersionOfPublicUiKoliBriCli,
-	logAndCreateError,
-	MODIFIED_FILES,
-	setRemoveMode,
-} from './shares/reuse';
-import { REMOVE_MODE, RemoveMode } from './types';
-
-type MigrateOption = {
-	ignoreUncommittedChanges: boolean;
-	removeMode: RemoveMode;
-	testTasks: boolean;
-};
-
-/**
- * This function is used to register the migrate command.
- * @param {Command} program The program object to register the command
- */
-export default function (program: Command): void {
-	program
-		.command('migrate')
-		.description('This command migrates KoliBri code to the current version.')
-		.argument('[string]', 'Source code folder to migrate', 'src')
-		.addOption(new Option('--ignore-uncommitted-changes', 'Allows execution with uncommitted changes').default(false))
-		.addOption(new Option('--remove-mode <mode>', 'Prefix property name or delete property').choices(REMOVE_MODE).default('prefix'))
-		.addOption(new Option('--test-tasks', 'Run additional test tasks').default(false).hideHelp())
-		.action((baseDir: string, options: MigrateOption) => {
-			exec('git status --porcelain', (err, stdout) => {
-				if (err) {
-					console.error(`exec error: ${err.message}`);
-					return;
-				}
-
-				if (!options.ignoreUncommittedChanges && stdout) {
-					throw logAndCreateError('There are uncommitted changes');
-				}
-
-				setRemoveMode(options.removeMode);
-
-				const versionOfPublicUiComponents = getVersionOfPublicUiComponents();
-				const versionOfPublicUiKoliBriCli = getVersionOfPublicUiKoliBriCli();
-
-				console.log(`
-Current version of @public-ui/components: ${versionOfPublicUiComponents}
-Source folder to migrate: ${baseDir}
-`);
-
-				const configFile = path.resolve(process.cwd(), '.kolibri.config.json');
-				let config: Configuration = {};
-				if (fs.existsSync(configFile)) {
-					try {
-						config = JSON.parse(fs.readFileSync(configFile, 'utf8')) as Configuration;
-					} catch (e) {
-						// ignore
-					}
-				}
-
-				const runner = new TaskRunner(baseDir, versionOfPublicUiKoliBriCli, versionOfPublicUiComponents, config);
-				runner.registerTasks(v1Tasks);
-
-				if (options.testTasks) {
-					runner.registerTasks(testTasks);
-				}
-
-				let version = versionOfPublicUiComponents;
-
-				/**
-				 * Runs the task runner in a loop until all tasks are completed.
-				 */
-				function runLoop() {
-					runner.run();
-					if (version !== runner.getPendingMinVersion()) {
-						version = runner.getPendingMinVersion();
-						let packageJson = getContentOfProjectPkgJson();
-						packageJson = packageJson.replace(/"(@public-ui\/[^"]+)":\s*".*"/g, `"$1": "${version}"`);
-						fs.writeFileSync(path.resolve(process.cwd(), 'package.json'), packageJson);
-						runner.setProjectVersion(version);
-
-						console.log(`- Update @public-ui/* to version ${version}`);
-						exec(getPackageManagerInstallCommand(), (err) => {
-							if (err) {
-								console.error(`exec error: ${err.message}`);
-								return;
-							}
-							runLoop();
-						});
-					} else {
-						console.log(`
-Status of all executed Tasks:`);
-
-						const status = runner.getStatus(true);
-						fs.writeFileSync(configFile, JSON.stringify(status.config, null, 2));
-
-						console.log(`
-Modified files: ${MODIFIED_FILES.size}`);
-						MODIFIED_FILES.forEach((file) => {
-							console.log(`- ${file}`);
-						});
-
-						console.log(`
-After the code migration has gone through, the code formatting may no longer be as desired. Therefore, please reformat your code afterwards if necessary.
-
-Afterwards, it may be that functions or themes in newer major versions have changed or are no longer included. This should be checked finally and corrected manually if necessary.
-
-Is anything wrong, you can reset the migration with "git reset --hard HEAD~1" or by discarding the affected files. For more information read the troubleshooting section in the README.`);
-					}
-				}
-
-				const status = runner.getStatus();
-				console.log(`
-Execute ${status.total} registered tasks...`);
-				runLoop();
-			});
-		});
-}

package/src/migrate/runner/abstract-task.ts

@@ -1,64 +0,0 @@
-import semver from 'semver';
-
-import { FILE_EXTENSIONS, FileExtension } from '../../types';
-import { logAndCreateError } from '../shares/reuse';
-import { TaskStatus } from './types';
-
-export type TaskOptions = {
-	dependentTasks?: AbstractTask[];
-	description?: string;
-};
-
-export abstract class AbstractTask {
-	private status: TaskStatus = 'pending';
-
-	protected static readonly instances: Map<string, AbstractTask> = new Map();
-
-	protected readonly description?: string;
-
-	protected constructor(
-		protected readonly identifier: string,
-		protected readonly title: string,
-		protected readonly extensions: FileExtension[],
-		protected readonly versionRange: string,
-		protected readonly dependentTasks: AbstractTask[] = [],
-		options: TaskOptions = {},
-	) {
-		this.description = options.description;
-		this.extensions = this.extensions.filter((ext) => FILE_EXTENSIONS.includes(ext));
-
-		if (!semver.validRange(this.versionRange)) {
-			throw logAndCreateError(`[${this.identifier}] Invalid semver range version: ${this.versionRange}`);
-		}
-	}
-
-	public getDependentTasks(): AbstractTask[] {
-		return this.dependentTasks;
-	}
-
-	public getDescription(): string | undefined {
-		return this.description;
-	}
-
-	public getIdentifier(): string {
-		return this.identifier;
-	}
-
-	public setStatus(status: TaskStatus): void {
-		this.status = status;
-	}
-
-	public getStatus(): TaskStatus {
-		return this.status;
-	}
-
-	public getTitle(): string {
-		return this.title;
-	}
-
-	public getVersionRange(): string {
-		return this.versionRange;
-	}
-
-	public abstract run(baseDir: string): void;
-}