seek-oss · samchungy · Jun 14, 2026 · Jun 14, 2026 · Jun 14, 2026 · Jun 14, 2026
@@ -0,0 +1,25 @@
+---
+'skuba': minor
+---
+
+api, lint, migrate, test: Use Vitest globals by default
+
+skuba's dependency hoisting setup is incompatible with TypeScript's import suggestion system, so new test files won't receive Intellisense suggestions for `vitest` imports until it is imported manually in the test file.
+
+To address this limitation we now use Vitest's globals by default
+
+This patch will automatically remove Vitest imports from all test files.
+
+If your `vitest.config.ts` files are using the `Vitest.mergePreset` function, you should not need to update anything.
+
+However, if you have custom `vitest.config.ts` files, or are using `projects` without the `extends: true` option, you may need to update your config to use Vitest's globals.
+
+```diff
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
++   globals: true,
+  },
+});
+```
@@ -7,12 +7,12 @@ deps: typescript ~6.0.0
 
 This major release contains breaking changes. See the [TypeScript 6.0.0](https://devblogs.microsoft.com/typescript/announcing-typescript-6-0/) announcement for more information.
 
-If your tsconfig currently extends `skuba/config/tsconfig.json`, you may not need to update anything. However, if you have a custom configuration, you may need to manually add `node` to the `types` array.
+If your tsconfig currently extends `skuba/config/tsconfig.json`, you may not need to update anything. However, if you have a custom configuration or run into lint errors related to missing Vitest globals, you may need to manually add `node` and `vitest/globals` to the `types` array in your tsconfig:
 
 ```diff
 {
   "compilerOptions": {
-+   "types": ["node"]
++   "types": ["node", "vitest/globals"]
   }
 }
 ```
@@ -8,7 +8,7 @@
     "noUnusedLocals": false,
     "noUnusedParameters": false,
     "resolveJsonModule": true,
-    "types": ["node"]
+    "types": ["node", "vitest/globals"]
   },
   "extends": "tsconfig-seek"
 }
@@ -1,5 +1,3 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
 import * as execModule from '../../../../src/utils/exec.js';
 import { log } from '../../../../src/utils/logging.js';
 

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { md } from './md.js';
 
 describe('terminal', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { normaliseTemplate } from './index.js';
 
 describe('normaliseTemplate', () => {

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { commit } from './commit.js';
 

@@ -2,7 +2,6 @@ import path from 'path';
 
 import git from 'isomorphic-git';
 import memfs, { fs, vol } from 'memfs';
-import { beforeEach, expect, it, vi } from 'vitest';
 
 import newGit from '../../../../integration/git/new.json' with { type: 'json' };
 

@@ -1,6 +1,5 @@
 import git from 'isomorphic-git';
 import memfs, { vol } from 'memfs';
-import { beforeEach, expect, it, vi } from 'vitest';
 
 import { currentBranch } from './currentBranch.js';
 

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { currentBranch } from './currentBranch.js';
 

@@ -1,5 +1,4 @@
 import memfs, { vol } from 'memfs';
-import { beforeEach, expect, it, vi } from 'vitest';
 
 import { findRoot } from './findRoot.js';
 

@@ -1,6 +1,5 @@
 import git from 'isomorphic-git';
 import memfs, { fs, vol } from 'memfs';
-import { beforeEach, expect, it, vi } from 'vitest';
 
 import newGit from '../../../../integration/git/new.json' with { type: 'json' };
 

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { getHeadCommitId, getHeadCommitMessage } from './log.js';
 

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { fastForwardBranch } from './pull.js';
 

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { push } from './push.js';
 

@@ -1,6 +1,5 @@
 import git from 'isomorphic-git';
 import memfs, { vol } from 'memfs';
-import { beforeEach, expect, it, vi } from 'vitest';
 
 import { getOwnerAndRepo } from './remote.js';
 

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, describe, expect, it, vi } from 'vitest';
 
 import { getOwnerAndRepo } from './remote.js';
 

@@ -1,6 +1,5 @@
 import git from 'isomorphic-git';
 import memfs, { fs, vol } from 'memfs';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import newGit from '../../../../integration/git/new.json' with { type: 'json' };
 

@@ -1,6 +1,5 @@
 import type { Endpoints } from '@octokit/types';
 import git, { type ReadCommitResult } from 'isomorphic-git';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { createCheckRun } from './checkRun.js';
 import { createRestClient } from './octokit.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import {
   apiTokenFromEnvironment,
   buildNameFromEnvironment,

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { putIssueComment } from './issueComment.js';
 import { createRestClient } from './octokit.js';

@@ -1,5 +1,4 @@
 import git from 'isomorphic-git';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { createRestClient } from './octokit.js';
 import { getPullRequestNumber } from './pullRequest.js';

@@ -1,16 +1,6 @@
 import type { FileChanges } from '@octokit/graphql-schema';
 import fs from 'fs-extra';
 import git, { type ReadCommitResult } from 'isomorphic-git';
-import {
-  afterAll,
-  afterEach,
-  beforeAll,
-  beforeEach,
-  describe,
-  expect,
-  it,
-  vi,
-} from 'vitest';
 
 import { apiTokenFromEnvironment } from './environment.js';
 import { graphql } from './octokit.js';

@@ -2,6 +2,7 @@ import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
   test: {
+    globals: true,
     coverage: {
       thresholds: {
         branches: 84,

@@ -2,7 +2,6 @@ import os from 'node:os';
 import path from 'node:path';
 
 import fs from 'fs-extra';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
 import { detectSameFileSpyUsage } from './index.js';
 

@@ -2,6 +2,7 @@ import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
   test: {
+    globals: true,
     exclude: ['**/node_modules'],
   },
 });
@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import {
   notNullish,
   nullish,

@@ -1,5 +1,3 @@
-import { beforeEach, describe, expect, it } from 'vitest';
-
 import { create } from './create.js';
 
 describe('create', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import * as parsers from './parsers.js';
 
 describe('nonNegativeInteger', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, test } from 'vitest';
-
 import * as presets from './presets.js';
 
 describe('presets', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import * as skubaDive from './index.js';
 
 describe('skuba-dive', () => {

@@ -73,7 +73,6 @@ Create a standalone mock cookies implementation for Koa-style code.
 
 ```typescript
 import { createMockCookies } from '@skuba-lib/vitest-koa-mocks';
-import { expect, it } from 'vitest';
 
 it('tracks request and response cookies', () => {
   const cookies = createMockCookies({ session: 'abc' });

@@ -1,5 +1,4 @@
 import type { Context } from 'koa';
-import { describe, expect, it, vi } from 'vitest';
 
 import { createMockContext } from './createMockContext.js';
 

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { createMockCookies } from './createMockCookies.js';
 
 describe('create-mock-cookies', () => {

@@ -2,6 +2,7 @@ import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
   test: {
+    globals: true,
     include: ['src/**/*.test.ts'],
     coverage: {
       include: ['src'],

@@ -3,6 +3,7 @@ import { type ViteUserConfig, defaultExclude } from 'vitest/config';
 import { mergeRaw } from '../../cli/configure/processing/record.js';
 
 export const defaults = {
+  globals: true,
   coverage: {
     include: ['**/*.ts', '**/*.tsx'],
     exclude: [

@@ -1,8 +1,6 @@
 /* eslint-disable no-console */
 import path from 'path';
 
-import { afterAll, beforeAll, describe, expect, it, test } from 'vitest';
-
 import { log } from '../../utils/logging.js';
 
 import { inferParser, runPrettier } from './prettier.js';

@@ -1,7 +1,5 @@
 import path from 'path';
 
-import { describe, expect, it } from 'vitest';
-
 import { parseTscArgs } from './args.js';
 
 describe('parseTscArgs', () => {

@@ -1,5 +1,4 @@
 import memfs, { vol } from 'memfs';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
 
 import { copyAssets } from './assets.js';
 

@@ -1,7 +1,5 @@
 import path from 'path';
 
-import { afterAll, beforeEach, describe, expect, it, vi } from 'vitest';
-
 import { getCustomConditions } from './tsc.js';
 
 describe('getCustomConditions', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, test } from 'vitest';
-
 import { diffDependencies } from './package.js';
 
 describe('diffDependencies', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it, vi } from 'vitest';
-
 import * as dir from '../../../utils/dir.js';
 import { getSkubaVersion } from '../../../utils/version.js';
 import { defaultOpts } from '../testing/module.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { seekDatadogCustomMetrics } from './seekDatadogCustomMetrics.js';
 
 describe('seekDatadogCustomMetrics', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { seekKoala } from './seekKoala.js';
 
 describe('seekKoala', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { skuba } from './skuba.js';
 
 describe('skuba', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { skubaDeps } from './skubaDeps.js';
 
 describe('skubaDeps', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { skubaDive } from './skubaDive.js';
 
 describe('skubaDive', () => {

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { eslintModule } from './eslint.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { ignoreModule } from './ignore.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { nodemonModule } from './nodemon.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { parsePackage } from '../processing/package.js';
 import {
   assertDefined,

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { prettierModule } from './prettier.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import {
   defaultOpts,
   defaultPackageOpts,

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { serverlessModule } from './serverless.js';

@@ -1,5 +1,3 @@
-import { describe, expect, it } from 'vitest';
-
 import { defaultOpts, executeModule } from '../testing/module.js';
 
 import { tslintModule } from './tslint.js';