refactor: transmute source and tests with support from symbiote

Author: Xunnamius

src/errors.ts

@@ -1,13 +1,13 @@
 import { types } from 'node:util';
 
-import { $type } from './symbols';
+import { $type } from 'universe:symbols.ts';
 
 import type {
   MaybePluginTesterTestConfig,
   PluginTesterTestConfig,
   PluginTesterTestFixtureConfig,
   Range
-} from './index';
+} from 'universe';
 
 const { isNativeError } = types;
 
@@ -40,32 +40,33 @@ export const ErrorMessage = {
   BadConfigInvalidTestsObjectProperty: (title: string) =>
     `failed to validate configuration: \`tests\` object property "${title}" must have a value of type string, TestObject, or nullish`,
   BadConfigInvalidEndOfLine: (endOfLine: unknown) =>
-    `failed to validate configuration: invalid \`endOfLine\` option "${endOfLine}"`,
+    `failed to validate configuration: invalid \`endOfLine\` option "${String(endOfLine)}"`,
   BadEnvironmentVariableRange: (name: string, rangeStr: string, range?: Range) =>
     `invalid environment variable "${name}": invalid range ${rangeStr}` +
     (range ? `: ${range.start} is greater than ${range.end}` : ''),
   SetupFunctionFailed: (error: unknown) =>
-    `setup function failed: ${isNativeError(error) ? error.message : error}`,
+    `setup function failed: ${String(isNativeError(error) ? error.message : error)}`,
   TeardownFunctionFailed: (functionError: unknown, frameworkError?: unknown) => {
     const frameworkErrorMessage = frameworkError
       ? `\n\nAdditionally, the testing framework reported the following error: ${
-          isNativeError(frameworkError) ? frameworkError.message : frameworkError
+          // eslint-disable-next-line @typescript-eslint/no-base-to-string
+          String(isNativeError(frameworkError) ? frameworkError.message : frameworkError)
         }`
       : '';
-    return `teardown function failed: ${
+    return `teardown function failed: ${String(
       isNativeError(functionError) ? functionError.message : functionError
-    }${frameworkErrorMessage}`;
+    )}${frameworkErrorMessage}`;
   },
   ExpectedBabelToThrow: () => 'expected babel to throw an error, but it did not',
-  // eslint-disable-next-line @typescript-eslint/ban-types
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
   ExpectedErrorToBeInstanceOf: (expectedError: Function | { name?: string }) =>
     `expected error to be an instance of ${expectedError.name || 'the expected error'}`,
   ExpectedThrowsFunctionToReturnTrue: () =>
     'expected `throws`/`error` function to return true',
   ExpectedErrorToIncludeString: (resultString: string, expectedError: string) =>
     `expected "${resultString}" to include "${expectedError}"`,
   ExpectedErrorToMatchRegExp: (resultString: string, expectedError: RegExp) =>
-    `expected "${resultString}" to match ${expectedError}`,
+    `expected "${resultString}" to match ${String(expectedError)}`,
   BabelOutputTypeIsNotString: (rawBabelOutput: unknown) =>
     `unexpected babel output of type "${typeof rawBabelOutput}" (expected 'code' property to be of type "string")`,
   BabelOutputUnexpectedlyEmpty: () =>
@@ -79,11 +80,11 @@ export const ErrorMessage = {
         }
       | Pick<PluginTesterTestFixtureConfig, typeof $type | 'fixtureOutputBasename'>
   ) => {
-    return `actual output does not match ${
+    return `actual output does not match ${String(
       testConfig[$type] === 'fixture-object'
         ? testConfig.fixtureOutputBasename
         : 'expected output'
-    }`;
+    )}`;
   },
   ExpectedOutputNotToChange: () => 'expected output not to change, but it did',
   ValidationFailed: (title: string, message: string) =>
@@ -136,7 +137,7 @@ export const ErrorMessage = {
   InvalidThrowsType: () =>
     '`throws`/`error` must be a function, string, boolean, RegExp, or Error subtype',
   GenericErrorWithPath: (error: unknown, path: string | undefined) => {
-    const message = `${isNativeError(error) ? error.message : error}`;
+    const message = String(isNativeError(error) ? error.message : error);
     // ? Some realms/runtimes don't include the failing path, so we make sure
     return !path || message.includes(path) ? message : `${path}: ${message}`;
   },
@@ -148,5 +149,5 @@ export const ErrorMessage = {
     basename: unknown,
     basenameName: string
   ) =>
-    `unable to derive an absolute path from the provided ${filepathName} and ${basenameName}:\n\n${filepathName}: ${filepath}\n${basenameName}: ${basename}`
+    `unable to derive an absolute path from the provided ${filepathName} and ${basenameName}:\n\n${filepathName}: ${String(filepath)}\n${basenameName}: ${String(basename)}`
 };

src/formatters/prettier.ts

@@ -1,32 +1,14 @@
-import debugFactory from 'debug';
 import path from 'node:path';
 
+import debugFactory from 'debug';
+
 import {
   format as formatWithPrettier,
   resolveConfig as resolvePrettierConfig,
   type Options as PrettierOptions
 } from 'prettier';
 
-import type { ResultFormatter } from '..';
-
-const debug = debugFactory('babel-plugin-tester:formatter');
-
-type MaybePrettierOptions = PrettierOptions | null;
-const configDirectoryCache: Record<string, MaybePrettierOptions> = Object.create(null);
-
-const getCachedConfig = async (filepath: string) => {
-  if (!(filepath in configDirectoryCache)) {
-    configDirectoryCache[filepath] = await resolvePrettierConfig(filepath);
-    debug(
-      `caching prettier configuration resolved from ${filepath}: %O`,
-      configDirectoryCache[filepath]
-    );
-  } else {
-    debug(`using cached prettier configuration resolved from ${filepath}`);
-  }
-
-  return configDirectoryCache[filepath];
-};
+import type { ResultFormatter } from 'universe';
 
 export type { PrettierOptions };
 
@@ -54,6 +36,7 @@ export const prettierFormatter: ResultFormatter<{
 }> = async (
   code,
   {
+    // eslint-disable-next-line no-restricted-syntax
     cwd = process.cwd(),
     filename,
     filepath = filename || path.join(cwd, 'dummy.js'),
@@ -78,3 +61,22 @@ export const prettierFormatter: ResultFormatter<{
 };
 
 export default prettierFormatter;
+
+const debug = debugFactory('babel-plugin-tester:formatter');
+
+type MaybePrettierOptions = PrettierOptions | null;
+const configDirectoryCache: Record<string, MaybePrettierOptions> = Object.create(null);
+
+const getCachedConfig = async (filepath: string) => {
+  if (!(filepath in configDirectoryCache)) {
+    configDirectoryCache[filepath] = await resolvePrettierConfig(filepath);
+    debug(
+      `caching prettier configuration resolved from ${filepath}: %O`,
+      configDirectoryCache[filepath]
+    );
+  } else {
+    debug(`using cached prettier configuration resolved from ${filepath}`);
+  }
+
+  return configDirectoryCache[filepath];
+};

src/index.ts

@@ -1,19 +1,32 @@
 import debugFactory from 'debug';
 
-import { prettierFormatter } from './formatters/prettier';
-import { unstringSnapshotSerializer } from './serializers/unstring-snapshot';
+import { prettierFormatter } from 'universe:formatters/prettier.ts';
 
 import {
   pluginTester,
   runPluginUnderTestHere,
   runPresetUnderTestHere
-} from './plugin-tester';
+} from 'universe:plugin-tester.ts';
 
-import type { PluginTesterOptions } from './types';
+import { unstringSnapshotSerializer } from 'universe:serializers/unstring-snapshot.ts';
+
+import type { PluginTesterOptions } from 'typeverse:global.ts';
+
+// {@symbiote/notExtraneous jest}
+
+export type * from 'typeverse:global.ts';
+
+export {
+  defaultPluginTester as pluginTester,
+  prettierFormatter,
+  runPluginUnderTestHere,
+  runPresetUnderTestHere,
+  unstringSnapshotSerializer
+};
 
 const debug = debugFactory('babel-plugin-tester:index');
 
-if ('expect' in globalThis && typeof expect?.addSnapshotSerializer === 'function') {
+if ('expect' in globalThis && typeof expect.addSnapshotSerializer === 'function') {
   debug(
     'added unstring snapshot serializer globally; all snapshots after this point will be affected'
   );
@@ -30,15 +43,5 @@ if ('expect' in globalThis && typeof expect?.addSnapshotSerializer === 'function
  * preset.
  */
 function defaultPluginTester(options?: PluginTesterOptions) {
-  return pluginTester({ formatResult: prettierFormatter, ...options });
+  pluginTester({ formatResult: prettierFormatter, ...options });
 }
-
-export {
-  defaultPluginTester as pluginTester,
-  prettierFormatter,
-  runPluginUnderTestHere,
-  runPresetUnderTestHere,
-  unstringSnapshotSerializer
-};
-
-export * from './types';