jest.config.js

module.exports = {
	transform: {
		'^.+\\.vue$': '@vue/vue3-jest',
		'^.+\\.[cm]?js$': 'babel-jest',
		'^.+\\.ts$': 'ts-jest',
		'.+\\.(css|styl|less|sass|scss|png|jpg|ttf|woff|woff2)$':
			'jest-transform-stub',
	},
	moduleFileExtensions: ['js', 'json', 'vue', 'ts'],
	testEnvironment: 'jest-environment-jsdom',
	setupFiles: ['<rootDir>/tests/jest.setup.js'],
	// Several @nextcloud/* and @conduction/* packages ship pure ESM,
	// which Jest cannot parse out of the box. Run them through
	// babel-jest so the test suite can import store modules that
	// transitively pull NC vue components.
	transformIgnorePatterns: [
		'/node_modules/(?!(@nextcloud|@conduction|tributejs|escape-html|webdav|p-cancelable|p-limit|p-queue|p-timeout|node-fetch|fetch-blob|formdata-polyfill|data-uri-to-buffer|filesize|nanoid|pinia|toastify-js|vue-material-design-icons|axios|zod|cancelable-promise)/)',
	],
	moduleNameMapper: {
		'^@/(.*)$': '<rootDir>/src/$1',
		// ⚠️ Jest's default resolver reads `main` and does NOT honour an
		// `exports` map or a bare `module` field. The Vue-3-era @nextcloud
		// packages ship one or the other and no `main`, so `jest.mock(...)` and
		// plain imports both fail with "Cannot find module" — 16 suites' worth.
		// This is the same trap as webpack's exports-map/directory-alias problem,
		// one layer up: point at the resolved FILE.
		//   @nextcloud/vue      — exports map only, no main/module
		//   @nextcloud/dialogs  — exports map only, no main/module
		//   @nextcloud/axios    — `module` only, no `main`
		'^@nextcloud/vue$': '<rootDir>/node_modules/@nextcloud/vue/dist/index.mjs',
		'^@nextcloud/dialogs$':
			'<rootDir>/node_modules/@nextcloud/dialogs/dist/index.mjs',
		'^@nextcloud/axios$':
			'<rootDir>/node_modules/@nextcloud/axios/dist/index.js',
		// @nextcloud/browser-storage ships pure ESM with `"type": "module"`.
		// Babel-jest can't transparently transform it from a CJS dependency
		// chain, so stub it for the unit-test environment.
		'^@nextcloud/browser-storage$':
			'<rootDir>/tests/__mocks__/nextcloud-browser-storage.js',
		// Stub the entire @conduction/nextcloud-vue package — its real
		// require chain pulls in @nextcloud/vue (~MB of CSS+CJS+ESM)
		// that jest cannot transform. The store unit tests only need
		// the factory exports (createObjectStore, *Plugin).
		'^@conduction/nextcloud-vue$':
			'<rootDir>/tests/__mocks__/conduction-nextcloud-vue.js',
		// Stub CSS / asset imports inside node_modules. Default
		// `transformIgnorePatterns` excludes node_modules from the
		// `jest-transform-stub` rule, so a require('....css') from
		// @nextcloud/vue otherwise crashes the parser.
		'\\.(css|less|sass|scss|png|jpg|ttf|woff|woff2)$': 'jest-transform-stub',
	},
	// The OR repo lives inside a Nextcloud docker-dev workspace where
	// `custom_apps/` is a sibling-app mount and `.claude/worktrees/` holds
	// agent worktree copies. Jest must not descend into either — both
	// host their own `src/` trees that would otherwise be picked up here.
	testPathIgnorePatterns: [
		'/node_modules/',
		'/vendor/',
		'<rootDir>/custom_apps/',
		'<rootDir>/\\.claude/worktrees/',
		// Scratch/tooling directories. A directory hidden from git (via
		// .gitignore or .git/info/exclude) is still perfectly visible to jest,
		// webpack and eslint — extracting a package tarball here for inspection
		// made jest try to transform the library's own `src/**/*.vue` and
		// produced 140 bogus "Cannot use import statement outside a module"
		// errors across 79 suites.
		'<rootDir>/\\.migration/',
		'<rootDir>/\\.playwright-mcp/',
		// Playwright suite — has its own runner via `npx playwright test`.
		'<rootDir>/tests/e2e/',
		// The demo-environment Playwright suite. It sits OUTSIDE tests/e2e/ on
		// purpose: playwright.config.ts sets testDir: './tests/e2e', so a spec
		// placed there is collected by CI, which has no booted demo to point
		// at. Moving it out solves that and creates this: jest's ignore list
		// named tests/e2e/ specifically, so the new directory was collected
		// here instead and jest tried to run a Playwright spec. Two collectors
		// with opposite exclusions — a file has to be named in both.
		'<rootDir>/tests/demo-e2e/',
	],
	modulePathIgnorePatterns: [
		'<rootDir>/custom_apps/',
		'<rootDir>/\\.claude/worktrees/',
		'<rootDir>/\\.migration/',
	],
	coveragePathIgnorePatterns: ['index.js', 'index.ts'],
	coverageDirectory: '<rootDir>/coverage-frontend/',
}