- Generate the bundled dist/driver.js.d.ts during `vite build` via
vite-plugin-dts (bundleTypes), dropping the separate
dts-bundle-generator step and its config
- Explicitly re-export the public types (Config, Popover, Side, etc.)
from the entry so the bundled .d.ts keeps the same export surface;
api-extractor only exports what the entry exports
Verified: the generated .d.ts has an identical export surface and
semantically identical type bodies to the previous output (12 types).
- `pnpm release` runs np, which prompts for patch/minor/major, then
bumps, tags, pushes and publishes
- Runs the non-watch `test:run` script before publishing
- prepublishOnly builds dist so publishes are never stale
- .npmrc sets an empty tag-version-prefix to keep tags like 1.4.0 (no "v")
Replaces the placeholder test with focused, maintainable suites that
encode the documented API behaviour as a regression net for the
upcoming API migration:
- lifecycle: activate/highlight/destroy, active element, modal popovers
- navigation: drive, moveNext/movePrevious/moveTo, first/last, getters
- popover: buttons, progress text, custom class, onPopoverRender
- interactions: next/prev/close clicks and onNextClick/onPrevClick overrides
- keyboard: escape + arrow keys, allowClose/allowKeyboardControl
- hooks: onHighlightStarted/onHighlighted/onDeselected/onDestroyed
- config: getConfig/setConfig/setSteps/getState/refresh
Shared setup lives in tests/utils.ts. Also add test:run and
test:coverage scripts.
Library:
- Update all dev dependencies to latest (vite 4->8, vitest 0.34->4,
typescript 5.2->6, @types/node 26, dts-bundle-generator 9, prettier 3.8)
- Replace deprecated @vitest/coverage-c8 with @vitest/coverage-v8
- Drop unused ts-node; add jsdom and a jsdom test environment
- ESM vite config, modern tsconfig (ES2020, Bundler resolution),
Rollup 4 asset-name handling so the CSS still emits as driver.css
Playground:
- Replace the 1,165-line index.html with playground/, a self-contained
Astro app that imports the library from source with HMR
- Each scenario is its own file under playground/src/examples grouped into
Highlight / Popover & Buttons / Tour / API, listed in a sidebar and run
on its own page; shared demo markup lives in Stage.astro
- All 41 original scenarios ported and type-checked against the library types
- Wire `pnpm dev` to the playground; document local development in the readme
Kamran Ahmed