test: replace jasmine browser runner with vitest + jsdom (#869)

* test: replace jasmine browser runner with vitest + jsdom

PR-1 of the modernization plan: makes the test suite headless and CI-ready
without touching src/jquery.autocomplete.js.

- Add vitest, jsdom, jquery@3.7.1, jquery-mockjax@2.6.0 dev deps (jQuery +
  mockjax versions match what spec/runner.html loaded from CDN).
- test/setup.js attaches a single jQuery instance to globalThis/window,
  registers mockjax against it, then loads the UMD plugin so it binds to the
  same instance. Silences mockjax's per-request console logging.
- vitest.config.js pins pool: "threads" — the default "forks" pool on Windows
  times out the worker handshake when the setup file does heavy synchronous
  work (jQuery + mockjax + UMD plugin load).
- Port all 26 Jasmine specs to test/autocomplete.test.js (31 it() cases):
  beforeEach(done) -> await new Promise(...), spyOn -> vi.spyOn.
- Add npm test / test:watch scripts; broaden lint and format globs to test/.
- Rename eslint.config.js -> eslint.config.mjs to silence Node's ESM-reparse
  warning without adding "type": "module" to package.json (which would break
  CommonJS consumers of the dist UMD bundle).
- Remove spec/ (vendored Jasmine 1.3.1 + 2.0.1, runner.html, original spec).

grunt + grunt-contrib-uglify still in devDependencies; PR-2 replaces them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: add claude.md with project, test, and commit conventions

Documents project shape (single-file UMD plugin), commands, test setup
(vitest + jsdom + mockjax), release/version flow, non-obvious architecture
(UMD wrapper, dual plugin name, defaults merge, response normalization,
caching guards), source style (intentionally ES5 inside the IIFE), and the
Conventional Commits requirement.

Author: tkirda

CLAUDE.md

@@ -0,0 +1,54 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project shape
+
+This is a single-file jQuery plugin (Ajax Autocomplete). The entire implementation lives in `src/jquery.autocomplete.js` (~1k lines). Everything else — `dist/`, `typings/`, `spec/`, `scripts/`, `index.htm` — is produced from, tests, types, or demos that one source file. Edits almost always belong in `src/jquery.autocomplete.js`; never edit `dist/*` directly (the build overwrites it).
+
+## Commands
+
+- `npm test` — Vitest run (headless, jsdom). Single-shot, exits nonzero on failure.
+- `npm run test:watch` — Vitest watch mode for local TDD.
+- `npm run lint` — ESLint (flat config in `eslint.config.mjs`) over `src/` and `test/`.
+- `npm run format` — Prettier rewrite of `src/` and `test/` (100-col, 4-space, ES5 trailing commas — config in `package.json`).
+- `npm run build` — `grunt build`: copies `src/jquery.autocomplete.js` to `dist/jquery.autocomplete.js` while substituting the `%version%` placeholder with `package.json` `version`, uglifies to `dist/jquery.autocomplete.min.js`, and syncs `devbridge-autocomplete.jquery.json` version. Run this before release/commit when source changes. *(Slated for replacement with a smaller Node script in the next modernization PR.)*
+
+## Tests
+
+Vitest + jsdom, headless. Specs live in `test/autocomplete.test.js`. `test/setup.js` attaches a single jQuery instance to the jsdom `window` and `globalThis`, registers `jquery-mockjax` against it, silences mockjax's per-request console logging, then loads `src/jquery.autocomplete.js`. The plugin's UMD wrapper picks up `globalThis.jQuery` and registers `$.Autocomplete` plus `$.fn.autocomplete`/`$.fn.devbridgeAutocomplete` against that same instance.
+
+The Vitest pool is pinned to `threads` in `vitest.config.js` — the default `forks` pool times out the worker handshake on Windows when the setup file does heavy synchronous work (jQuery + mockjax + UMD plugin load). Don't switch pools without re-verifying.
+
+To run a single test, use `npx vitest run -t "test name substring"` or temporarily change `describe`/`it` to `describe.only`/`it.only`.
+
+The demo page `index.htm` is the manual test surface (Ajax lookup, local lookup with grouping, custom container, dynamic width). It loads jQuery + mockjax from CDN; just open in a browser.
+
+## Release/version flow
+
+1. Bump `version` in `package.json`.
+2. `npm run build` — this propagates the new version into `dist/jquery.autocomplete.js` (via `%version%` placeholder) and `devbridge-autocomplete.jquery.json`. The placeholder only exists in `src/`; do not hand-edit version strings in `dist/`.
+
+## Architecture notes that aren't obvious from a single file
+
+- **UMD wrapper** at the top of `src/jquery.autocomplete.js` registers under AMD, CommonJS, or browser global — keep all three branches working when touching the wrapper.
+- **Dual plugin name**: registers `$.fn.devbridgeAutocomplete` unconditionally, and aliases `$.fn.autocomplete` only if it is not already taken (jQuery UI defines one). Tests and the README rely on this fallback behavior — don't remove the guard.
+- **Defaults live on `Autocomplete.defaults`** and are merged per-instance via `$.extend(true, {}, defaults, options)`. New options must be added to the defaults object so deep-merge picks them up, and mirrored in `typings/jquery.autocomplete.d.ts` and the option tables in `readme.md`.
+- **Response normalization**: server responses pass through `transformResult` (default JSON.parse for `dataType: 'text'`). Local `lookup` may be an array or a `function(query, done)` callback; both paths converge on the same `{ value, data }` suggestion shape used everywhere downstream (`formatResult`, `onSelect`, grouping).
+- **Caching + bad-query guard**: `cachedResponse` keys by query string, and `preventBadQueries` records prefixes that returned no results so future queries with the same prefix short-circuit. `clearCache` / `clear` reset these — when adding new request paths, decide whether they should populate or honor these caches.
+
+## Conventions
+
+- Source style is the existing one: ES5 inside the IIFE (no `let`/`const`/arrow funcs in `src/jquery.autocomplete.js`), `"use strict"`, `var that = this` pattern. ESLint config targets `ecmaVersion: 2022` but the file is intentionally written to run in old browsers — match the existing style rather than modernizing.
+- Prettier owns formatting; run `npm run format` before committing source changes.
+
+## Commit messages
+
+Use [Conventional Commits](https://www.conventionalcommits.org/): `<type>(<optional scope>): <description>`.
+
+- Types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`.
+- Description is imperative, lowercase, no trailing period (e.g. `fix: handle null suggestion data`).
+- Breaking changes: append `!` after the type/scope (`feat!: ...`) and/or add a `BREAKING CHANGE:` footer.
+- Scope, when useful, names the area touched: `build`, `test`, `deps`, `autocomplete`.
+
+Examples: `test: port specs to vitest + jsdom`, `build: replace grunt with node script`, `chore(deps): bump prettier to 3.6.2`, `feat!: drop ie11 support`.

eslint.config.js eslint.config.mjseslint.config.js renamed to eslint.config.mjs

@@ -3,6 +3,7 @@ import js from '@eslint/js';
 export default [
     js.configs.recommended,
     {
+        files: ['src/**/*.js'],
         languageOptions: {
             ecmaVersion: 2022,
             sourceType: 'script',
@@ -18,9 +19,20 @@ export default [
                 clearTimeout: 'readonly',
             },
         },
-        files: ['src/**/*.js'],
-        rules: {
-            // Add any custom rules here if needed
+    },
+    {
+        files: ['test/**/*.js', 'vitest.config.js'],
+        languageOptions: {
+            ecmaVersion: 2022,
+            sourceType: 'module',
+            globals: {
+                globalThis: 'readonly',
+                window: 'readonly',
+                document: 'readonly',
+                console: 'readonly',
+                setTimeout: 'readonly',
+                clearTimeout: 'readonly',
+            },
         },
     },
 ];