test: add comprehensive test suite with Jest

Introduce Jest testing framework with complete test coverage for all Vue components and utilities.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: HusamElbashir

.eslintrc.js

@@ -2,6 +2,7 @@ module.exports = {
   root: true,
   env: {
     node: true,
+    jest: true,
   },
   extends: [
     "plugin:vue/vue3-essential",
@@ -31,4 +32,16 @@ module.exports = {
       },
     ],
   },
+  overrides: [
+    {
+      files: ["**/__tests__/**/*", "**/*.spec.*", "**/*.test.*"],
+      env: {
+        jest: true,
+      },
+      rules: {
+        "@typescript-eslint/no-non-null-assertion": "off",
+        "@typescript-eslint/no-unused-vars": "off",
+      },
+    },
+  ],
 };

.gitignore

@@ -24,3 +24,23 @@ yarn-error.log*
 dist
 docs/.vitepress/dist
 docs/.vitepress/cache
+
+# Test coverage files
+coverage
+.nyc_output
+*.lcov
+.coverage
+
+# Jest cache
+.jest-cache
+
+# Test artifacts
+test-results
+test-report.xml
+junit.xml
+
+# Temporary test files
+*.tmp
+*.temp
+.tmp
+.temp

jest.config.js

@@ -0,0 +1,49 @@
+module.exports = {
+  preset: "ts-jest",
+  testEnvironment: "jsdom",
+  moduleFileExtensions: ["js", "ts", "vue", "json"],
+  transform: {
+    "^.+\\.vue$": "@vue/vue3-jest",
+    "^.+\\.tsx?$": [
+      "ts-jest",
+      {
+        tsconfig: {
+          jsx: "preserve",
+          esModuleInterop: true,
+          allowJs: true,
+          lib: ["es2020", "dom"],
+        },
+      },
+    ],
+  },
+  setupFilesAfterEnv: ["<rootDir>/tests/setup.ts"],
+  testMatch: ["<rootDir>/src/**/__tests__/**/*.{js,ts}", "<rootDir>/src/**/*.{spec,test}.{js,ts}"],
+  collectCoverageFrom: [
+    "src/**/*.{ts,vue}",
+    "!src/**/*.d.ts",
+    "!src/index.ts",
+    "!src/*/index.ts",
+    "!src/**/__tests__/**",
+    "!src/shims-*.ts",
+    "!src/themes/**",
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 80,
+      functions: 80,
+      lines: 80,
+      statements: 80,
+    },
+  },
+  coverageReporters: ["text", "json", "html", "lcov"],
+  // Handle CSS imports and path aliases
+  moduleNameMapper: {
+    "\\.(css|less|scss|sass)$": "<rootDir>/tests/mocks/styleMock.js",
+    "^@/(.*)$": "<rootDir>/src/$1",
+  },
+  // Ignore certain files
+  transformIgnorePatterns: ["node_modules/(?!@googlemaps/)"],
+  testEnvironmentOptions: {
+    customExportConditions: ["node", "node-addons"],
+  },
+};

package.json

@@ -48,28 +48,38 @@
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:serve": "vitepress serve docs",
-    "release": "standard-version"
+    "release": "standard-version",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
   },
   "dependencies": {
     "@googlemaps/js-api-loader": "^1.16.2",
     "@googlemaps/markerclusterer": "^2.4.0",
     "fast-deep-equal": "^3.1.3"
   },
   "devDependencies": {
-    "pnpm": "^8.7.6",
+    "@googlemaps/jest-mocks": "^2.22.6",
     "@types/google.maps": "^3.58.1",
+    "@types/jest": "^30.0.0",
     "@typescript-eslint/eslint-plugin": "^4.33.0",
     "@typescript-eslint/parser": "^4.33.0",
     "@vitejs/plugin-vue": "^4.3.1",
     "@vue/eslint-config-prettier": "^6.0.0",
     "@vue/eslint-config-typescript": "^7.0.0",
+    "@vue/test-utils": "^2.4.6",
+    "@vue/vue3-jest": "^29.2.6",
     "eslint": "^7.32.0",
     "eslint-config-prettier": "^8.10.0",
     "eslint-plugin-prettier": "^3.4.1",
     "eslint-plugin-vue": "^7.20.0",
+    "jest": "^30.0.4",
+    "jest-environment-jsdom": "^30.0.4",
+    "pnpm": "^8.7.6",
     "prettier": "^2.8.8",
     "rimraf": "^5.0.1",
     "standard-version": "^9.5.0",
+    "ts-jest": "^29.4.0",
     "typescript": "^5.1.6",
     "vite": "^4.5.3",
     "vite-plugin-css-injected-by-js": "^3.2.1",